Events: cases, event map and eventualities graph moved to events/ (D-080)
The case base leaves agents/diagnostic/cas/ for a root folder of its own, with the event map and its graph; paths updated in skills, agents, scripts, case fiches, contexts, the living plan and CLAUDE.md; history keeps old paths. Also: plan point 51, an analyst that improves from session to session. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4bdbab2976
commit
cb98818712
1182 files changed
+211
-174
No files matched your search
@@ -33,7 +33,7 @@ On veut donc un autre processus automatique, à part de `/boucle`, qui ne travai
|
||||
|
||||
- **Les outils de lecture**, `agents/diagnostic/outils/` (419 lignes) : `donnees.py` (lecture commune des exports), `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des capteurs sur les images). Bibliothèque standard, matplotlib par `.venv` pour les figures. Ils rendent des valeurs, jamais des verdicts.
|
||||
- **Leur mode d'emploi est recopié à deux endroits** : le tableau « Tes outils » et l'étape 1 de `.claude/skills/critiquer-lot/SKILL.md` (l'analyste), le §3 et une partie du §4 (étapes 1, 2 et 4) de `agents/diagnostic/instructions.md` (l'agent de diagnostic).
|
||||
- **Les cinq cas validés**, `agents/diagnostic/cas/C-001/` à `C-005/` : données (`displacement/`, `images/`), fiche `cas.md` (signature en critères, avec leurs commandes) et figures, dans le même dossier.
|
||||
- **Les cinq cas validés**, `events/C-001/` à `C-005/` : données (`displacement/`, `images/`), fiche `cas.md` (signature en critères, avec leurs commandes) et figures, dans le même dossier.
|
||||
- **Le modèle de `/boucle`** (D-057, `vues-deplacements/contexte/boucle-automatique.md`, skill `.claude/skills/boucle/SKILL.md`) : un skill orchestrateur dans la conversation principale, des sous-agents qui ne se parlent pas et écrivent chacun un rendu, une ligne `**Verdict** :` lue par `grep`, des commits par chemin, une branche par séance, un `bilan.md`. Un passage de l'analyste coûte environ 250 000 jetons et 8 min 30 (essai du 2026-10-24).
|
||||
|
||||
## 4. Ce qu'on optimise : le skill `lire-les-donnees`
|
||||
|
||||
@@ -7,7 +7,7 @@ Point 31 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brains
|
||||
L'utilisateur veut que Claude apprenne sur des lots entiers de données de stations, sans lui : passer les détecteurs du journal du matin sur un lot, juger leurs résultats comme le ferait un expert, en regardant lui-même les courbes et les images, corriger les détecteurs, et garder sous forme de cas tout ce qui est nouveau. Puis passer au lot suivant.
|
||||
|
||||
À la fin d'une séance, il reste deux choses durables (l'utilisateur) :
|
||||
1. **de la connaissance** : de nouveaux cas, appris sur des événements réels, de la même forme que C-001 à C-005, ajoutés à la même base de cas, `agents/diagnostic/cas/` : tous les cas sont au même endroit (l'utilisateur) ;
|
||||
1. **de la connaissance** : de nouveaux cas, appris sur des événements réels, de la même forme que C-001 à C-005, ajoutés à la même base de cas, `events/` : tous les cas sont au même endroit (l'utilisateur) ;
|
||||
2. **des détections optimisées** : des détecteurs mieux réglés.
|
||||
|
||||
L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les juges qui y mènent.
|
||||
@@ -33,8 +33,8 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
|
||||
|
||||
- Les détecteurs du journal : `vues-deplacements/detectors/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 vues-deplacements/detectors/categories.py <dossier> --du AAAA-MM-JJ --au AAAA-MM-JJ --tranche 4 --historique 3`. Chaque lot est classé avec les 3 jours d'avant : c'est la règle pour la boucle (D-056).
|
||||
- Les outils de lecture des données, `agents/diagnostic/outils/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images) ; leur mode d'emploi est le skill `.claude/skills/lire-les-donnees/`, que suit l'analyste ; ils évoluent par `/aiguiser` (D-059, `aiguiser-la-lecture.md`), pas par la boucle. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé.
|
||||
- La carte des événements, `docs/displacement/domaine/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4).
|
||||
- La base de cas, `agents/diagnostic/cas/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymiser-cas` (données copiées dans le dossier du cas, noms codés, D-049, D-050). Les cas existants ne se modifient jamais ; la boucle en ajoute.
|
||||
- La carte des événements, `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4).
|
||||
- La base de cas, `events/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymiser-cas` (données copiées dans le dossier du cas, noms codés, D-049, D-050). Les cas existants ne se modifient jamais ; la boucle en ajoute.
|
||||
- Le registre des seuils, `vues-deplacements/contexte/seuils-du-journal.md` : une constante changée le met à jour dans le même changement.
|
||||
|
||||
## 4. Une séance
|
||||
@@ -48,7 +48,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
|
||||
2. Verdict « d'accord » : on passe à l'étape 5.
|
||||
3. **Upgrader** : il modifie les détecteurs et écrit `modification-K.md` (K : numéro du passage). Commit.
|
||||
4. **Validateur** : il écrit `validation-K.md`, « accepté » ou « à reprendre ». Commit. « À reprendre » : retour à l'étape 3, l'upgrader lit cette validation. Au plus trois passages de l'upgrader *(choix de Claude)* : à la troisième validation, le validateur n'a plus que deux réponses, « garder » (ça va dans le bon sens) ou « annuler » (l'orchestrateur annule par `git revert` les commits de détecteurs du lot).
|
||||
5. **Builder** : s'il y a des nouveautés dans les rendus du lot, il ajoute les cas à la base, `agents/diagnostic/cas/`, et écrit `builder.md`. Un commit pour les cas du lot (ils partagent la ligne d'index).
|
||||
5. **Builder** : s'il y a des nouveautés dans les rendus du lot, il ajoute les cas à la base, `events/`, et écrit `builder.md`. Un commit pour les cas du lot (ils partagent la ligne d'index).
|
||||
|
||||
Le lot suivant tourne avec les détecteurs tels qu'ils sont devenus. À la fin, l'orchestrateur écrit `bilan.md` (§6) et le commite.
|
||||
|
||||
@@ -71,7 +71,7 @@ La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi
|
||||
1. **Sa propre lecture d'abord, sans la sortie des détecteurs** *(choix de Claude)* : sinon il ne trouverait jamais ce que les détecteurs ratent. Inventaire, courbes du lot avec `graphique.py`, vignettes espacées (une toutes les 2 à 3 h) et plus serrées là où les courbes bougent, images entières pour la scène. Il note chaque moment : début, fin, capteurs, ce qu'il voit, la catégorie de la carte qui conviendrait, ou « aucune catégorie ».
|
||||
2. **Puis** la sortie de `categories.py` pour le lot.
|
||||
3. **Comparaison**, événement par événement : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop large) ; manquant.
|
||||
4. **Puis les cas**, après les faits (sinon il chercherait ce que dit un cas au lieu de ce que montrent les données) : l'index `agents/diagnostic/cas/INDEX.md`, avec les cas appris aux lots et aux séances d'avant.
|
||||
4. **Puis les cas**, après les faits (sinon il chercherait ce que dit un cas au lieu de ce que montrent les données) : l'index `events/INDEX.md`, avec les cas appris aux lots et aux séances d'avant.
|
||||
5. **Verdict** : « d'accord » (rien d'important à corriger), ou des **suggestions, au plus deux**, les plus importantes *(choix de Claude, contre la complexité)* : le défaut, l'exemple (moment, capteurs), le détecteur en cause, ce qu'il faudrait, en mots et non en code.
|
||||
6. **Nouveautés** pour le builder : ce que ni la carte ni l'index ne décrivent, avec le moment, les capteurs et la figure qui le montre.
|
||||
|
||||
@@ -107,7 +107,7 @@ Il sait que l'upgrader est passé : il lit la critique, la modification et le di
|
||||
|
||||
Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Write, Edit. Il lit les nouveautés des rendus du lot ; c'est l'analyste qui en signale le plus, mais l'upgrader et le validateur peuvent en noter aussi (l'utilisateur : « pendant toutes ces phases »).
|
||||
|
||||
- **Une seule base** (l'utilisateur) : `agents/diagnostic/cas/`, à côté de C-001 à C-005 ; numéro suivant de l'index (`C-006`…), comme `/nouveau-cas`.
|
||||
- **Une seule base** (l'utilisateur) : `events/`, à côté de C-001 à C-005 ; numéro suivant de l'index (`C-006`…), comme `/nouveau-cas`.
|
||||
- **Un cas par genre d'événement, pas par occurrence** *(choix de Claude)* : si un cas de la base a déjà la même signature, dans sa ligne d'index ou dans sa fiche, rien ; une nouveauté qui contredit le diagnostic d'un cas est « déjà connue », la contradiction dite pour l'utilisateur.
|
||||
- Sinon, un cas de la même forme que C-001 à C-005 : données de la fenêtre de l'événement, avec une marge, copiées et codées par `anonymiser-cas` (un état de plus d'un jour : un moment qui le montre, ± 6 h, la plage entière dite dans la fiche) ; fiche du §11.3, un fait hors des listes fermées rangé sous la plus proche, précisé (résumé, symptôme, verdict, signature avec ses commandes, diagnostic, preuves avec leurs figures) ; ligne d'index.
|
||||
- **Marqué « appris »** *(choix de Claude)*, pour la revalidation à la main, plus tard : en tête de fiche, « Appris par la boucle le <date>, séance <dossier>, non revalidé par l'expert » ; dans l'index, le Verdict commence par « (appris) ».
|
||||
|
||||
@@ -30,7 +30,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
|
||||
| Taux d'erreur | entre 2 h et 3 h, d'un coup beaucoup de perturbations : un flag « grand taux d'erreur des cibles », moyenne sur les cibles | `detectors/visibilite.py` |
|
||||
| Cycle thermique | chaque jour de grosses vagues : tout chauffe, bouge un peu, puis refroidit à la tombée de la nuit, très prévisible ; vu seul ça paraît bizarre, vu chaque jour c'est normal | `detectors/thermique.py` |
|
||||
| Turbulence atmosphérique | des petites vagues, du bruit, à expliquer au client | `detectors/turbulence.py` |
|
||||
| Cartographie des cas | il n'y a pas 36 000 options : un diagramme (Mermaid) de tous les cas rencontrés, branchés (mauvais temps, train, obstruction…), à partir des catégories déjà dans le projet | `docs/displacement/domaine/carte-des-evenements.md` |
|
||||
| Cartographie des cas | il n'y a pas 36 000 options : un diagramme (Mermaid) de tous les cas rencontrés, branchés (mauvais temps, train, obstruction…), à partir des catégories déjà dans le projet | `events/carte-des-evenements.md` |
|
||||
| Page | une page dans Explore : les courbes, les barres dessous, les zones grisées | onglet `Journal` de `vues-deplacements/maquette/` |
|
||||
| Volet 2 : lissage | le premier volet ne touche pas aux données et les interprète ; un second les lisse ; peur que ce soit trop complexe : un agent dit ce qui existe et ce qui est possible | `vues-deplacements/contexte/lissage.md` |
|
||||
| Données et boucle | récupérer les données pour travailler hors de l'application, puis boucler Claude dessus | `vues-deplacements/contexte/donnees-et-boucle.md` |
|
||||
@@ -64,7 +64,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
|
||||
|
||||
## Retour de l'utilisateur sur la v0 (2026-10-23, le soir)
|
||||
|
||||
- « Pas trop mal », mais il veut **encore plus simple**, et surtout un diagnostic **catégorique et complet**, comme celui des cas étudiés par l'agent de diagnostic (`agents/diagnostic/cas/`) : pas de « most likely a measurement artefact » ni de « probably rain ».
|
||||
- « Pas trop mal », mais il veut **encore plus simple**, et surtout un diagnostic **catégorique et complet**, comme celui des cas étudiés par l'agent de diagnostic (`events/`) : pas de « most likely a measurement artefact » ni de « probably rain ».
|
||||
- Exemple : sur NORDEND, le 14/10 vers 05:15, un immense saut monte puis redescend en quelques heures. Ce comportement se voit tout le temps ; il a plusieurs causes possibles, mais on veut clairement **invalider la zone**. Ici il n'y a pas d'ambiguïté : les cibles étaient perdues (intempéries, plein jour, aube…), et les images le montrent.
|
||||
- **Cas par cas, isoler les scénarios** : un gros saut → trouver sa **catégorie** (celle de la carte des événements, d'où la demande d'un agent cartographe) → **exécuter le processus de la catégorie**. Pour la perte de visibilité, le processus est de **montrer les images** : le client voit le gros saut, lit la catégorie, voit qu'on ne distingue pas les cibles, comprend que ce n'est qu'une perte de visibilité et passe à la suite sans s'alarmer.
|
||||
- Sous les courbes, le label dit **ce qui s'est passé** (la catégorie), pas le nom du détecteur.
|
||||
@@ -84,7 +84,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
|
||||
|
||||
## Carte des événements (point 3 du plan, 2026-10-24)
|
||||
|
||||
- La carte n'a pas à s'appuyer sur des cas vus dans les données (peu de données passées dans le projet) : elle doit **englober toutes les possibilités**, un ouvrier qui abîme une cible, « tout et n'importe quoi », rangées en **familles**. On part de la base et on complète au fur et à mesure : `docs/displacement/domaine/carte-des-evenements.md` (33 événements, six familles).
|
||||
- La carte n'a pas à s'appuyer sur des cas vus dans les données (peu de données passées dans le projet) : elle doit **englober toutes les possibilités**, un ouvrier qui abîme une cible, « tout et n'importe quoi », rangées en **familles**. On part de la base et on complète au fur et à mesure : `events/carte-des-evenements.md` (33 événements, six familles).
|
||||
## Page Journal simplifiée (point 8 du plan, 2026-10-24)
|
||||
|
||||
- Frise d'une seule ligne « What happened » et journal en cartes : validé, mais l'utilisateur n'est « pas entièrement satisfait » ; on pourrait **déplier** au lieu de tout mettre sur une même ligne (point 40 du plan).
|
||||
@@ -129,4 +129,6 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
|
||||
|
||||
## Le graphe des éventualités (point 49 du plan, 2026-10-27)
|
||||
|
||||
Ce qui peut arriver sur le terrain, relié aux catégories du journal, sans le détail des données : `docs/displacement/eventualites-et-categories.drawio`. Catégories définies par l'utilisateur le 2026-10-27 (D-074) : tout ce qui reste inexpliqué va dans À vérifier (sous-groupes : saut qui dure, gros saut, dérive lente), pour ne pas alarmer le client ; Cible défaillante (une cible constamment problématique) est nouvelle ; après vérification, un À vérifier peut devenir Cible déplacée. Pas encore reportées dans le journal.
|
||||
Ce qui peut arriver sur le terrain, relié aux catégories du journal, sans le détail des données : `events/eventualites-et-categories.drawio`. Catégories définies par l'utilisateur le 2026-10-27 (D-074) : tout ce qui reste inexpliqué va dans À vérifier (sous-groupes : saut qui dure, gros saut, dérive lente), pour ne pas alarmer le client ; Cible défaillante (une cible constamment problématique) est nouvelle ; après vérification, un À vérifier peut devenir Cible déplacée. Pas encore reportées dans le journal.
|
||||
|
||||
- Idée de l'utilisateur (2026-10-28) : l'analyste de `/boucle` doit progresser de séance en séance (son jugement, pas seulement sa lecture). Proposition de Claude et questions au point 51 du plan.
|
||||
@@ -1,5 +1,5 @@
|
||||
"""Journal du matin : des épisodes des détecteurs aux événements catégorisés (point 6 du plan ; catégories validées le
|
||||
2026-10-24 : docs/displacement/domaine/carte-des-evenements.md, section 4).
|
||||
2026-10-24 : events/carte-des-evenements.md, section 4).
|
||||
|
||||
Chaque épisode reçoit sa catégorie d'après son détecteur et son label ; catégories du terrain (D-074, 2026-10-27) :
|
||||
Cible défaillante (`cible_degradee` : degradee, et sauts « Target flipping »), la dérive lente (derive) et le gros saut
|
||||
|
||||
@@ -22,7 +22,7 @@ Méthode (seuils provisoires ci-dessous) :
|
||||
29.09 jusqu'à 14:15) ; les références ne comptent pas : R3 y passe son seuil presque toute la journée. Benchmark :
|
||||
le seul épisode perdu est celui, faux, de C-010.
|
||||
|
||||
Résultats (2026-10-23 ; vérité : agents/diagnostic/cas/INDEX.md) :
|
||||
Résultats (2026-10-23 ; vérité : events/INDEX.md) :
|
||||
- PS_DES_COUDRES (C-001, buée 13.10 23:45 → 14.10 05:15, 2 références sur 3) : Poor visibility 13.10 23:45 → 14.10 04:45, REF_G et
|
||||
REF_D ; aussi la nuit d'avant, 13.10 01:15 → 03:30, mêmes références (hors vérité, pas d'image : sans doute la même buée).
|
||||
- NORDEND juillet (C-002, toile 28.07 20:45 → 31.07 03:00, reprise 31.07 20:30) : Poor visibility 28.07 20:45 → 31.07 02:45 (20 capteurs)
|
||||
|
||||
@@ -113,7 +113,7 @@ Ajouté le 2026-10-16 à la demande de l'utilisateur : faire ressortir seules le
|
||||
Le « journal du matin » du client (utilisateur, 2026-10-23) : il ouvre Explore, voit ses courbes sur quelques jours et, dessous, des barres étiquetées qui disent ce qui s'est passé. Un épisode n'est pas un vrai déplacement : c'est un moment où il ne faut pas se fier aux données. On garde toutes les données ; les zones à ignorer sont grisées. Prototype, au plus simple, en attente des retours de l'utilisateur.
|
||||
|
||||
- **Détecteurs** : un fichier par détecteur dans `vues-deplacements/detectors/<nom>.py`, qui expose `detect(mesures)` (`mesures = donnees.charger(dossier)`) et rend des épisodes `{start, end, kind, label, text, ignore, sensors}` (heures `donnees.iso`, UTC ; `kind` = nom du fichier ; `ignore` vrai = zone grisée ; `sensors` vide = tous). `vues-deplacements/detectors/categories.py` (`detecteurs`) charge tous les fichiers qui ont `detect` ; un détecteur qui plante est sauté avec un message, la page se fait quand même.
|
||||
- **Événements** (2026-10-24, point 6 du plan) : `categories.evenements(mesures)` classe les épisodes en événements des huit catégories du journal (`docs/displacement/domaine/carte-des-evenements.md`, section 4) : un saut revenu à la normale pendant une perte de visibilité, un passage ou une turbulence y est absorbé, un saut qui dure jamais ; même catégorie à moins d'une heure, un seul événement. Événement : `{start, end, category, label, text, ignore, sensors, process, episodes}` (`episodes` : les épisodes d'origine, le principal en tête) ; c'est ce que la page reçoit dans `D.journal`.
|
||||
- **Événements** (2026-10-24, point 6 du plan) : `categories.evenements(mesures)` classe les épisodes en événements des huit catégories du journal (`events/carte-des-evenements.md`, section 4) : un saut revenu à la normale pendant une perte de visibilité, un passage ou une turbulence y est absorbé, un saut qui dure jamais ; même catégorie à moins d'une heure, un seul événement. Événement : `{start, end, category, label, text, ignore, sensors, process, episodes}` (`episodes` : les épisodes d'origine, le principal en tête) ; c'est ce que la page reçoit dans `D.journal`.
|
||||
- **`trous.py`** : les moments sans mesure, cadence de l'export rompue (plus de 2 pas manquants, cadence = écart médian), de la dernière mesure à la suivante ; label `No data`, pas grisé. Les autres (`visibilite`, `sauts`, `turbulence`, `thermique`) sont écrits à part.
|
||||
- **Courbes** : `Horizontal (px)` = `corr_x`, `Vertical (px)` = `corr_y` de l'export « advanced », cibles seules (`target` et `ref`, pas les `global_ref`), lignes fines, axe du temps partagé ; vue de départ : les 3 derniers jours (`#from=AAAA-MM-JJ` dans l'adresse la fait partir d'un autre jour, pour les captures) ; zoom à la molette ou au cadre sur toute la plage, double-clic pour tout voir ; ordonnées recalées sur la plage visible (D-013).
|
||||
- **Frise dépliée** (point 40, 2026-10-24) : case `Expand` (décochée par défaut ; `#expand` pour les captures) : « What happened » devient une ligne par catégorie présente dans les données, dans l'ordre de dessin (« Shift to check » en haut, « Slow drift » en bas, en barre pleine) ; plus aucun événement n'en cache un autre. Décochée, la ligne unique du point 8. Les lignes sont celles de toute la période : une catégorie absente de la plage visible garde sa ligne, vide. Combinable avec `Support view`, dont les lignes par détecteur viennent dessous.
|
||||
|
||||
Reference in new issue
Block a user