- read-event: map and index first, then the card of close events only,
then their data with the reading tools; never all cards at once.
Diagnostic agent, critiquer-lot and builder point to it; the index
header too. Signature length: about 250 characters, a guideline.
- "Cas" becomes "event": events/E-xxx/event.md, skills new-event,
review-event, anonymize-event.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- **Statut** : construit le 2026-10-14 (outils, instructions, point d'entrée) ; révisé le même jour après le premier test (D-047) : rapports courts, preuves en figures, anomalies seules ; tests à l'aveugle : §7 ; base de cas construite le 2026-10-14 (D-048, §11), vide ; révisé le 2026-10-24 (D-058) : plus à l'aveugle, il lit la connaissance du projet et part des événements des détecteurs du journal, pour être le plus précis possible sur un cas que les détecteurs n'expliquent pas. Décisions liées : D-046, D-047, D-048 (`docs/decisions.md`).
- **Statut** : construit le 2026-10-14 (outils, instructions, point d'entrée) ; révisé le même jour après le premier test (D-047) : rapports courts, preuves en figures, anomalies seules ; tests à l'aveugle : §7 ; base d'events construite le 2026-10-14 (D-048, §11), vide ; révisé le 2026-10-24 (D-058) : plus à l'aveugle, il lit la connaissance du projet et part des événements des détecteurs du journal, pour être le plus précis possible sur un cas que les détecteurs n'expliquent pas. Décisions liées : D-046, D-047, D-048 (`docs/decisions.md`).
- **Place** : version pilote, la plus légère, de l'enquête à la demande (D-042) et du cadre d'agents (D-027). Mêmes idées (outils en lecture, réfutation obligatoire, preuves tracées), mais exécutée par Claude Code au lieu du harnais par API : pas de clé API, pas de harnais à écrire.
---
@@ -33,7 +33,7 @@ agent-diagnostic/
instructions.md sa méthode : règles, déroulé, format du rapport
outils/ ses scripts Python ; leur mode d'emploi : .claude/skills/lire-les-donnees/ (D-059)
rapports/ un rapport par diagnostic
cas/ cas validés par l'expert : INDEX.md et une fiche par incident (§11)
cas/ events validés par l'expert : INDEX.md et une fiche par incident (§11)
```
- **Appel** : `@agent-diagnostic data/PS_DES_COUDRES/` suivi, au choix, d'une question ; ou en langage naturel (« lance l'agent diagnostic sur … ») ; ou une session entière dans un terminal : `claude --agent diagnostic`, mais elle charge `CLAUDE.md` (`omitClaudeMd` ne vaut que pour un sous-agent) : elle n'est pas à l'aveugle.
@@ -70,7 +70,7 @@ et suis-le à la lettre.
**Sources** (D-058 : plus à l'aveugle) :
- les données du dossier (CSV, images) ;
- la connaissance du projet sur les déplacements : `docs/domaine/`, `docs/displacement/` (cadrage, carte des événements…), les docs AIMsight par section ;
- toute la base de cas, `events/` (§11), à l'étape 5, après les faits ;
- toute la base d'events, `events/` (§11), à l'étape 5, après les faits ;
- pas ce qui rend déjà un avis sur des données : les rapports de l'agent, `vues-deplacements/` (parcours), les séances de `boucle/` et `aiguiser/`, le code des détecteurs (`detectors/`), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`.
**Déroulé** (d'après le §13 du contexte support) :
@@ -78,8 +78,8 @@ et suis-le à la lettre.
2.**Repérage** : les événements des détecteurs du journal (`detectors/categories.py`, D-058) d'abord, sans les juger ; puis, par capteur, ce qui sort de l'ordinaire de ce capteur (son propre passé, pas un seuil absolu).
3.**Tri** (D-047) : une anomalie est un écart daté au comportement habituel du capteur ; une même signature, même répétée, fait une seule anomalie ; ce qui dure toute la période (réglage, capteur toujours rejeté, cycle régulier) n'en est pas une : une ligne en « Hors anomalie », sans enquête.
4.**Faits**, par anomalie : début, fin, durée ; capteurs touchés (cibles ou références, combien, lesquels) ; amplitude, retour à la normale ; déplacement associé ou non ; vignettes des images avant, pendant et après, avec un capteur témoin.
5.**Cas connus** (§11.4) : après les faits, l'index puis au plus 3 fiches par anomalie ; critères vérifiés avec les outils ; correspondance complète, partielle ou aucune.
6.**Hypothèses** : avec un cas, son diagnostic ; sinon, dans les familles du §12 : événement externe (occlusion, eau ou buée, turbulence, éclairage), mouvement de l'ouvrage, mouvement de la caméra ou compensation, cible dégradée, problème système, marquées « non validé ».
5.**Events connus** (§11.4) : après les faits, l'index puis au plus 3 fiches par anomalie ; critères vérifiés avec les outils ; correspondance complète, partielle ou aucune.
6.**Hypothèses** : avec un event, son diagnostic ; sinon, dans les familles du §12 : événement externe (occlusion, eau ou buée, turbulence, éclairage), mouvement de l'ouvrage, mouvement de la caméra ou compensation, cible dégradée, problème système, marquées « non validé ».
7.**Réfutation obligatoire** de l'hypothèse principale : chercher le fait qui la contredirait, dire ce qu'on a trouvé.
8.**Preuves** : les figures qui montrent chaque anomalie (série, zone grisée, capteur non touché pour comparer ; vignettes), écrites dans le dossier du rapport ; deux ou trois au plus, chacune regardée avant d'être retenue.
9.**Rapport** (§5).
@@ -91,7 +91,7 @@ et suis-le à la lettre.
- rien sur `inlier` ; `sigma0` jamais suffisant seul ; ne pas confondre mode commun et mouvement structurel, ni références cohérentes et références physiquement fixes (D-058 : une mise en garde, plus une conclusion imposée) ; un trou n'est pas forcément une coupure ;
- toute heure en UTC ; chaque preuve cite la commande qui l'a produite ;
- « rien d'anormal » est une conclusion valable ;
- asymétrie : « aucune conséquence pour l'ouvrage » seulement avec une correspondance complète à un cas (§11.4) ;
- asymétrie : « aucune conséquence pour l'ouvrage » seulement avec une correspondance complète à un event (§11.4) ;
- écrire court : corps du rapport en ~40 lignes, chiffres arrondis, pas de valeurs pas à pas ;
- lecture seule : n'écrire que son rapport et ses figures ;
- rapport en français, termes AIMsight en anglais.
@@ -101,17 +101,17 @@ et suis-le à la lettre.
Un dossier par diagnostic, `agent-diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>[_<sujet>]/` (l'heure évite les doublons sans lister les rapports précédents, qui pourraient trahir une conclusion) : `rapport.md` et ses figures PNG, versionnées avec lui. Format (D-047), le corps en ~40 lignes :
1.**En-tête** d'une ligne : données (dossier, période), scan ou question, modèle, date.
2.**Verdict** : 2-3 phrases ; la station fonctionne-t-elle normalement, et ses anomalies par importance, avec leur cas connu.
2.**Verdict** : 2-3 phrases ; la station fonctionne-t-elle normalement, et ses anomalies par importance, avec leur event connu.
3.**Une section par anomalie** :
- le constat en 2-3 phrases ;
- les figures de preuve, chacune avec une légende d'une ligne : la série (anomalie grisée, capteur témoin), les vignettes des images s'il y en a ;
- une ligne **cas connu** : le cas et sa correspondance (complète, partielle, aucune), §11.4 ;
- une ligne **event connu** : l'event et sa correspondance (complète, partielle, aucune), §11.4 ;
- une ligne : **classification** (liste fermée : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation* (§4.3 de la roadmap), problème système, indéterminé), niveau de preuve, **cause probable** (buée ou eau, occlusion, turbulence, éclairage, inconnue), **conséquence pour l'ouvrage** (aucune, mouvement réel, indéterminée), **action** (aucune, à vérifier, intervention) ; sans cas connu, la ligne est marquée « Non validé (support) » ;
- une ligne de réfutation ; une ligne : non établi et vérification à faire ;
- les commandes de chaque fait, repliées (`<details>`).
4.**Hors anomalie** : trois lignes au plus.
5.**Annexe** : sources lues, données disponibles et manquantes, seuil de repérage.
6.**Validation**, laissée vide pour l'utilisateur : accepté tel quel ou corrigé (en quoi), diagnostic final, devient un cas (oui, C-xxx, ou non) ; l'ajout se lance par `/nouveau-cas` (§11.6).
6.**Validation**, laissée vide pour l'utilisateur : accepté tel quel ou corrigé (en quoi), diagnostic final, devient un event (oui, E-xxx, ou non) ; l'ajout se lance par `/new-event` (§11.6).
## 6. Outils (`agent-tools/`)
@@ -160,7 +160,7 @@ Un attendu manqué ou une conclusion au-delà des preuves se corrige dans `instr
- **Corrections des instructions** : une : signaler un contexte reçu sans l'avoir ouvert ; une commande `Bash` simple par appel (une boucle `for` avait été refusée).
- **À valider par l'utilisateur** : la classification *camera/reference compensation event* (plutôt que *target-local degradation*), l'effet sur les cibles, et le cycle journalier de `corr_y` (mouvement thermique ou parallaxe, non tranché).
**Avis du spécialiste (2026-10-14) : le cas de référence.** À PS des Coudres, le système fonctionne correctement ; le seul point d'attention est `REF_G` et `REF_D`, dont l'erreur monte en pics étranges. Le premier passage les avait trouvés (E1, E2 du scan), mais noyés parmi trois événements et cinq constats permanents (14 Ko), et ses graphiques restaient dans `out/`, hors du rapport. D'où trois corrections demandées par l'utilisateur : moins de texte, des preuves (graphiques, images) dans le rapport, les anomalies seules (D-047). Reste à voir avec le spécialiste : l'agent affirme que ces pics biaisent la compensation (marche de `corr_x` de BJ_G à 03:30Z le 14/10, sans mouvement de sa position brute), ce qui se concilie mal avec « le système fonctionne correctement ».
**Avis du spécialiste (2026-10-14) : l'event de référence.** À PS des Coudres, le système fonctionne correctement ; le seul point d'attention est `REF_G` et `REF_D`, dont l'erreur monte en pics étranges. Le premier passage les avait trouvés (E1, E2 du scan), mais noyés parmi trois événements et cinq constats permanents (14 Ko), et ses graphiques restaient dans `out/`, hors du rapport. D'où trois corrections demandées par l'utilisateur : moins de texte, des preuves (graphiques, images) dans le rapport, les anomalies seules (D-047). Reste à voir avec le spécialiste : l'agent affirme que ces pics biaisent la compensation (marche de `corr_x` de BJ_G à 03:30Z le 14/10, sans mouvement de sa position brute), ce qui se concilie mal avec « le système fonctionne correctement ».
**Deuxième passage (format D-047) : scan à l'aveugle.** Attendus, écrits avant le passage :
@@ -207,9 +207,9 @@ Rapport : `agent-diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 appe
- **Graphiques par plotly** : un PNG demande kaleido, qui embarque un navigateur.
- **Pas de graphique** : l'agent verrait mal les formes des séries (cycle jour/nuit, marche).
## 11. Base de cas (D-048)
## 11. Base d'events (D-048)
**Le besoin (utilisateur).** Le diagnostic marche, mais il manque de déterminisme : l'agent reçoit tout, ne sait pas où regarder et peut conclure hors sujet. Usage visé : sur le site, l'utilisateur sélectionne une plage de données et clique sur « Analyze » ; l'agent tourne sur les séries et les images de la plage, puis le notifie. Il faut contrôler ce que l'agent rend. Proposition de l'utilisateur : des cas connus, validés par les experts du métier, chacun documenté et décrit dans une table que l'agent consulte ; son verdict s'appuie sur les cas proches.
**Le besoin (utilisateur).** Le diagnostic marche, mais il manque de déterminisme : l'agent reçoit tout, ne sait pas où regarder et peut conclure hors sujet. Usage visé : sur le site, l'utilisateur sélectionne une plage de données et clique sur « Analyze » ; l'agent tourne sur les séries et les images de la plage, puis le notifie. Il faut contrôler ce que l'agent rend. Proposition de l'utilisateur : des events connus, validés par les experts du métier, chacun documenté et décrit dans une table que l'agent consulte ; son verdict s'appuie sur les events proches.
**Choix de l'utilisateur, sur proposition :**
@@ -217,9 +217,9 @@ Rapport : `agent-diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 appe
|---|---|
| Recherche | **Un index Markdown lu par l'agent** ; ni base vectorielle, ni filtre par script (§11.8) |
| Granularité | **Une fiche par incident** : un upload donne un dossier |
| Cas reçus | **Les données et le diagnostic de l'expert** |
| Sans cas correspondant | **Les faits, puis les hypothèses de l'agent marquées « non validé »**, pour le support seulement |
| Ajout d'un cas | **Seulement sur demande explicite de l'utilisateur** ; jamais de lui-même, même à la réception de données ; skill `/nouveau-cas`, lancé par l'utilisateur seul |
| Events reçus | **Les données et le diagnostic de l'expert** |
| Sans event correspondant | **Les faits, puis les hypothèses de l'agent marquées « non validé »**, pour le support seulement |
| Ajout d'un event | **Seulement sur demande explicite de l'utilisateur** ; jamais de lui-même, même à la réception de données ; skill `/new-event`, lancé par l'utilisateur seul |
La plage sélectionnée par « Analyze » est le mode question actuel (§4) restreint à une fenêtre ; rien ne change à l'entrée de l'agent.
@@ -228,40 +228,40 @@ La plage sélectionnée par « Analyze » est le mode question actuel (§4) rest
```
events/
INDEX.md la table : seule porte d'entrée de l'agent
C-001/ un dossier par incident, à son numéro
cas.md la fiche
E-001/ un dossier par incident, à son numéro
event.md la fiche
*.png ses figures de preuve
displacement/, camera/, images/ ses données, noms codés (D-050)
etiquettes.json son diagnostic à la création, mesure par mesure (D-069)
etiquetage.md d'où viennent ces étiquettes, et la lecture qui les a produites
```
- À côté de `rapports/` : un rapport validé devient un cas, et les signatures s'écrivent dans le langage des outils de l'agent.
- Les données du cas sont copiées dans son dossier, noms codés (D-050) : la fiche et ses commandes se rejouent sans `data/<STATION>/`, qui garde l'original (D-029).
- Le numéro `C-xxx` est la référence stable que cite le rapport.
- **`etiquettes.json`** (D-069) : le diagnostic du cas au format des étiquettes de l'analyste de `/boucle` (D-061), noms codés, figé à la création comme le reste du cas. Le benchmark des détecteurs (`.claude/skills/boucle/benchmark.py`) les compare, mesure par mesure. Un cas appris le reçoit du builder (`anonymiser.py --etiquettes`) ; C-001 à C-005 l'ont reçu d'un passage unique de l'analyste, corrigé par leur fiche (2026-10-26) ; un cas de `/nouveau-cas`, de même. Chaque cas a, à côté, `etiquetage.md` : la lecture de l'analyste et ce que la fiche y a changé, ou, pour un cas appris, le lot d'origine et le tableau des moments.
- Un cas n'entre dans l'index qu'une fois validé par l'expert : pas de colonne de statut. L'agent n'ouvre que les fiches que cite l'index.
- À côté de `rapports/` : un rapport validé devient un event, et les signatures s'écrivent dans le langage des outils de l'agent.
- Les données de l'event sont copiées dans son dossier, noms codés (D-050) : la fiche et ses commandes se rejouent sans `data/<STATION>/`, qui garde l'original (D-029).
- Le numéro `E-xxx` est la référence stable que cite le rapport.
- **`etiquettes.json`** (D-069) : le diagnostic de l'event au format des étiquettes de l'analyste de `/boucle` (D-061), noms codés, figé à la création comme le reste de l'event. Le benchmark des détecteurs (`.claude/skills/boucle/benchmark.py`) les compare, mesure par mesure. Un event appris le reçoit du builder (`anonymiser.py --etiquettes`) ; E-001 à E-005 l'ont reçu d'un passage unique de l'analyste, corrigé par leur fiche (2026-10-26) ; un event de `/new-event`, de même. Chaque event a, à côté, `etiquetage.md` : la lecture de l'analyste et ce que la fiche y a changé, ou, pour un event appris, le lot d'origine et le tableau des moments.
- Un event n'entre dans l'index qu'une fois validé par l'expert : pas de colonne de statut. L'agent n'ouvre que les fiches que cite l'index.
- La base démarre vide : `INDEX.md` n'a que son en-tête.
- **Noms codés (D-049, D-050)** : dans l'index, les fiches, leurs figures et leurs données, la station prend le numéro du cas, une référence devient `R1`, une cible `C1`. Les codes des capteurs sont stables d'un cas à l'autre et tenus dans le registre du skill `anonymiser-cas`, que l'agent ne lit pas. L'agent rapproche ainsi par la signature, pas par le nom.
- **Noms codés (D-049, D-050)** : dans l'index, les fiches, leurs figures et leurs données, la station prend le numéro de l'event, une référence devient `R1`, une cible `C1`. Les codes des capteurs sont stables d'un event à l'autre et tenus dans le registre du skill `anonymize-event`, que l'agent ne lit pas. L'agent rapproche ainsi par la signature, pas par le nom.
### 11.2 L'index
Une ligne par incident. La colonne **Signature** sert à la recherche : courte, observable seulement (type de capteurs, combien, colonne, forme, moment, durée, retour à la normale).
Une ligne par incident. La colonne **Signature** sert à la recherche : courte (environ 250 caractères, une indication et non une limite ; le détail dans la fiche, D-085), observable seulement (type de capteurs, combien, colonne, forme, moment, durée, retour à la normale). Mode d'emploi de la base, pour qui la consulte : skill `read-event`.
| Cas | Événement (UTC) | Signature | Classification | Cause | Verdict |
| *exemple :*C-001 | nuit du 13 au 14.10.2026, 23:45 → 05:15 | 2 références sur 3, `error_value` à plusieurs dizaines de MAD, la nuit, quelques heures, puis retour ; autre référence et cibles intactes | *target-local degradation* | buée ou eau (brume), déduite | système sain, rien à faire |
| *exemple :*E-001 | nuit du 13 au 14.10.2026, 23:45 → 05:15 | 2 références sur 3, `error_value` à plusieurs dizaines de MAD, la nuit, quelques heures, puis retour ; autre référence et cibles intactes | *target-local degradation* | buée ou eau (brume), déduite | système sain, rien à faire |
### 11.3 La fiche (`cas.md`)
### 11.3 La fiche (`event.md`)
Une quarantaine de lignes : le diagnostic de l'expert sur cet événement, produit par l'agent à l'aveugle puis aligné sur l'avis de l'expert (D-051). Les faits viennent du rapport à l'aveugle.
```markdown
# C-xxx
# E-xxx
**Lieu** : <région, pays>\
**Événement** : <date, heures de début et de fin, UTC>\
**Cas créé le** : <date>
**Event créé le** : <date>
## Résumé
<La situation, en 1-2 phrases, sans chiffre.>
@@ -274,7 +274,7 @@ Une quarantaine de lignes : le diagnostic de l'expert sur cet événement, produ
## Signature
Critères observables, relatifs au niveau habituel du capteur, chacun avec sa commande :
1. <critère> (ici <valeurs du cas>) : `<commande sur le dossier du cas>`
1. <critère> (ici <valeurs de l'event>) : `<commande sur le dossier de l'event>`
## Diagnostic
- **Classification** : <liste fermée, §5>
@@ -288,61 +288,61 @@ Critères observables, relatifs au niveau habituel du capteur, chacun avec sa co
*Critères <n>. <légende>*
```
- **Ce cas seulement** : ni les éventualités d'autres cas (pas d'exclusions), ni l'historique des tests, qui reste dans `rapports/` et l'historique git (D-051).
- **Cet event seulement** : ni les éventualités d'autres events (pas d'exclusions), ni l'historique des tests, qui reste dans `rapports/` et l'historique git (D-051).
- **Un humain d'abord** : Résumé, Symptôme et Verdict se lisent sans connaître les outils ; Signature et Diagnostic sont ce que l'agent vérifie et reprend.
- **Signature** : porte la recherche et la comparaison ; l'agent coche chaque critère en lançant sa commande sur ses propres données. Relative (en MAD), jamais en seuil absolu, qui ne se transpose pas d'une station à l'autre.
- **Diagnostic** : un fait du cas qui a trompé l'agent à l'aveugle y figure avec le jugement de l'expert (C-001 : sauts de la compensation jugés négligeables).
- **Diagnostic** : un fait de l'event qui a trompé l'agent à l'aveugle y figure avec le jugement de l'expert (E-001 : sauts de la compensation jugés négligeables).
- **Conséquence pour l'ouvrage et action** : deux listes fermées, ce dont le bouton « Analyze » a besoin.
- **Symptôme** : prépare la future question en texte libre (§11.8).
- **Figures et données dans le dossier du cas** : l'agent ne lit pas `rapports/`, et un cas reste complet sans son rapport ni `data/`.
- **Figures et données dans le dossier de l'event** : l'agent ne lit pas `rapports/`, et un event reste complet sans son rapport ni `data/`.
### 11.4 Usage par l'agent
Une étape de plus dans le déroulé (§4 de `instructions.md`), entre « Faits » et « Hypothèses », jamais avant : l'agent établit ses faits sans connaître les cas, pour ne pas plaquer le plus proche (ancrage).
Une étape de plus dans le déroulé (§4 de `instructions.md`), entre « Faits » et « Hypothèses », jamais avant : l'agent établit ses faits sans connaître les events, pour ne pas plaquer le plus proche (ancrage).
**Cas connus.** L'agent lit `events/INDEX.md` à ce moment seulement. Pour chaque anomalie, il choisit au plus 3 cas d'après la signature, ouvre leurs fiches, vérifie chaque critère avec ses outils sur ses propres données, puis conclut :
**Events connus.** L'agent lit `events/INDEX.md` à ce moment seulement. Pour chaque anomalie, il choisit au plus 3 events d'après la signature, ouvre leurs fiches, vérifie chaque critère avec ses outils sur ses propres données, puis conclut :
| Correspondance | Quand | Ce que l'agent rend |
|---|---|---|
| **Complète** | tous les critères vérifiés | le diagnostic de l'expert (classification, cause, conséquence, action) devient son hypothèse principale ; niveau de preuve tiré de ses faits, pas de la fiche ; réfutation toujours obligatoire : un fait contraire fait tomber le cas |
| **Complète** | tous les critères vérifiés | le diagnostic de l'expert (classification, cause, conséquence, action) devient son hypothèse principale ; niveau de preuve tiré de ses faits, pas de la fiche ; réfutation toujours obligatoire : un fait contraire fait tomber l'event |
| **Partielle** | aucun critère contredit, mais des critères non vérifiables (ex. pas d'image) | même hypothèse principale, niveau de preuve plafonné à `consistent with`, critères manquants en « à vérifier » ; conséquence « aucune » ramenée à « indéterminée », « mouvement réel » gardé |
| **Aucune** | pour chaque cas ouvert, un critère contredit ; ou aucun cas proche ; ou index vide | ses hypothèses libres, marquées « non validé, pour le support » ; la conséquence que ses preuves établissent, « mouvement réel » ou « indéterminée » (« aucune » demande un cas : asymétrie) |
| **Aucune** | pour chaque event ouvert, un critère contredit ; ou aucun event proche ; ou index vide | ses hypothèses libres, marquées « non validé, pour le support » ; la conséquence que ses preuves établissent, « mouvement réel » ou « indéterminée » (« aucune » demande un event : asymétrie) |
**Règle d'asymétrie** (D-042) : « aucune conséquence pour l'ouvrage » seulement si les trois tiennent : correspondance complète avec un cas validé, niveau de preuve au moins `strongly supported`, mouvement réel de l'ouvrage écarté par la réfutation. Deux cas qui correspondent : la complète avant la partielle, et la conséquence la plus prudente si elles diffèrent. Une fausse assurance coûte plus qu'une fausse alerte.
**Règle d'asymétrie** (D-042) : « aucune conséquence pour l'ouvrage » seulement si les trois tiennent : correspondance complète avec un event validé, niveau de preuve au moins `strongly supported`, mouvement réel de l'ouvrage écarté par la réfutation. Deux events qui correspondent : la complète avant la partielle, et la conséquence la plus prudente si elles diffèrent. Une fausse assurance coûte plus qu'une fausse alerte.
Sources (§2 de `instructions.md`) : toute la base, `events/INDEX.md`, les fiches et leurs figures, à cette étape (D-058).
### 11.5 Le rapport
- Le verdict cite les cas : « A1 correspond à C-xxx ».
- Chaque anomalie gagne une ligne : **Cas connu** : C-xxx, complète (critères 1 à 4 vérifiés) | partielle (critère 4 non vérifiable : pas d'image) | aucun cas connu.
- Le verdict cite les events : « A1 correspond à E-xxx ».
- Chaque anomalie gagne une ligne : **Event connu** : E-xxx, complète (critères 1 à 4 vérifiés) | partielle (critère 4 non vérifiable : pas d'image) | aucun event connu.
- La ligne de classification gagne **Conséquence pour l'ouvrage** et **Action**, les listes fermées de la fiche.
- Sans cas correspondant, les hypothèses sont titrées « Non validé (support) ».
- La validation gagne une ligne : « Devient un cas : oui (C-xxx) | non ». Elle note la décision ; l'ajout se lance par `/nouveau-cas` (§11.6).
- Sans event correspondant, les hypothèses sont titrées « Non validé (support) ».
- La validation gagne une ligne : « Devient un event : oui (E-xxx) | non ». Elle note la décision ; l'ajout se lance par `/new-event` (§11.6).
### 11.6 Ajouter un cas : le skill `/nouveau-cas`
### 11.6 Ajouter un event : le skill `/new-event`
Procédure tenue par `.claude/skills/nouveau-cas/SKILL.md`, avec `disable-model-invocation` : seul l'utilisateur la lance. Recevoir des données ou valider un rapport n'ajoute pas de cas.
Procédure tenue par `.claude/skills/new-event/SKILL.md`, avec `disable-model-invocation` : seul l'utilisateur la lance. Recevoir des données ou valider un rapport n'ajoute pas d'events.
1.**Réunir** en un message : fichiers, station, lieu, fenêtre en UTC, diagnostic de l'expert (symptôme, classification, cause, conséquence, action, explication, ce qu'il n'a pas pu établir, date). L'avis de l'expert reste dans la conversation jusqu'à l'étape 5.
2.**Ranger** les données (D-029, D-045) : export dans `data/<STATION>/displacement/`, images renommées en UTC (`<AAAAMMJJ>T<HHMM>Z_<n>.jpg`) ; contrôle par `inventaire.py`.
3.**Commit neutre** (rien sur l'incident ni sa cause : le sous-agent reçoit les derniers messages de commit et la branche), arbre propre.
4.**Passage à l'aveugle**, la fenêtre de l'incident pour question, comparé à des attendus écrits avant ; un attendu manqué se corrige dans `instructions.md` par une règle générale.
5.**Fiche** au modèle du §11.3 (données copiées dans le cas et noms codés par le skill `anonymiser-cas`, D-049, D-050 ; signature tirée du rapport ; diagnostic de l'expert ; figures refaites sur les données du cas) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
6.**Test de correspondance** : l'agent relancé, le cas dans l'index, doit trouver `C-xxx, complète` (ou partielle) et le diagnostic de l'expert. Il vérifie la mécanique, pas le jugement : l'agent a lu la fiche. Le résultat va dans le message de commit, pas dans la fiche.
5.**Fiche** au modèle du §11.3 (données copiées dans le cas et noms codés par le skill `anonymize-event`, D-049, D-050 ; signature tirée du rapport ; diagnostic de l'expert ; figures refaites sur les données de l'event) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
6.**Test de correspondance** : l'agent relancé, l'event dans l'index, doit trouver `E-xxx, complète` (ou partielle) et le diagnostic de l'expert. Il vérifie la mécanique, pas le jugement : l'agent a lu la fiche. Le résultat va dans le message de commit, pas dans la fiche.
Un cas ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index est le registre.
Un event ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index est le registre.
### 11.7 Vérification
- **Mise en place**, index vide : relancer le scan de PS des Coudres. Attendu : le même diagnostic que le deuxième passage (§7), avec « aucun cas connu », conséquence « indéterminée » et des hypothèses « non validé (support) » ; `INDEX.md` lu après les faits, pas avant.
- **Chaque nouveau cas** teste la recherche sans effort de plus : l'agent qui le découvre (étape 2 de §11.6) doit répondre « aucun cas connu » ou citer le bon cas, jamais un faux.
- **Rejouer un cas** : retirer sa ligne de `INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer au Verdict et au Diagnostic de la fiche, restaurer la ligne.
- **Mise en place**, index vide : relancer le scan de PS des Coudres. Attendu : le même diagnostic que le deuxième passage (§7), avec « aucun event connu », conséquence « indéterminée » et des hypothèses « non validé (support) » ; `INDEX.md` lu après les faits, pas avant.
- **Chaque nouvel event** teste la recherche sans effort de plus : l'agent qui le découvre (étape 2 de §11.6) doit répondre « aucun event connu » ou citer le bon event, jamais un faux.
- **Rejouer un event** : retirer sa ligne de `INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer au Verdict et au Diagnostic de la fiche, restaurer la ligne.
**Revue de C-001, le 2026-10-15.** Fiche relue section par section avec l'utilisateur :
- les données de la station sont copiées dans le cas, noms codés, et la station prend le numéro du cas (D-050) ;
**Revue de E-001, le 2026-10-15.** Fiche relue section par section avec l'utilisateur :
- les données de la station sont copiées dans le cas, noms codés, et la station prend le numéro de l'event (D-050) ;
- la fiche devient le diagnostic de l'expert sur ce seul événement, en six sections, sans exclusions, attendu, inconnus ni historique des tests (D-051) ;
- deux faits corrigés en revérifiant sur les données du cas : R2 monte en 2 h 30, pas d'un coup ; `corr_x` de C3 ne revient pas à son niveau d'avant l'épisode avant le jour ;
- deux faits corrigés en revérifiant sur les données de l'event : R2 monte en 2 h 30, pas d'un coup ; `corr_x` de C3 ne revient pas à son niveau d'avant l'épisode avant le jour ;
- les sauts de `corr_x` aux bascules de R3, cause du classement en *camera/reference compensation event* à l'aveugle, sont jugés négligeables.
Le test de correspondance n'a pas été relancé sur la fiche revue, par choix de l'utilisateur : le dernier passage (2026-10-14) portait sur l'ancien format, avec exclusions.
@@ -352,10 +352,10 @@ Le test de correspondance n'a pas été relancé sur la fiche revue, par choix d
| Attendu | Résultat |
|---|---|
| 1. Même diagnostic que le deuxième passage | atteint : une seule anomalie, `REF_G` et `REF_D` les deux nuits (13/10 00:45 → 04:15Z ; 13/10 22:45Z → 14/10 05:15Z, bornes un peu plus larges qu'au deuxième passage) ; 3 figures dans le dossier du rapport, vignettes avec témoins |
| 2. « Cas connu : aucun cas connu (index vide) » | atteint |
| 2. « Event connu : aucun event connu (index vide) » | atteint |
| 4. Sources : `INDEX.md`, ni fiche ni rapport | atteint |
| 5. « Devient un cas » dans la validation | atteint, laissé vide |
| 5. « Devient un event » dans la validation | atteint, laissé vide |
| 6. Corps en ~40 lignes | atteint : 39 lignes |
| Ordre de lecture | atteint : `INDEX.md` au 27e appel, après les faits (inventaire, résumés, graphiques, vignettes et images, appels 4 à 26) et avant les familles d'hypothèses (§12, appels 28 à 32) |
@@ -364,14 +364,14 @@ Le test de correspondance n'a pas été relancé sur la fiche revue, par choix d
### 11.8 Laissé de côté
- **Filtre structuré** (en-tête de fiche et script `cas.py`), puis peut-être **RAG vectorielle** : quand l'index ne tiendra plus en une lecture (quelques centaines de cas), ou quand la question arrivera en texte libre (ticket, client) : le champ Symptôme y prépare.
- **Filtre structuré** (en-tête de fiche et script `event.py`), puis peut-être **RAG vectorielle** : quand l'index ne tiendra plus en une lecture (quelques centaines d'events), ou quand la question arrivera en texte libre (ticket, client) : le champ Symptôme y prépare.
- **Entrée « fenêtre » dédiée** pour le bouton : le mode question la couvre.
### 11.9 Options écartées
- **RAG vectorielle maintenant** : à quelques dizaines de cas, l'index tient en une lecture et l'agent choisit mieux qu'un top-k ; deux cas se ressemblent par leur signature observable, pas par leur texte (deux fiches rédigées de même peuvent décrire « toutes les références bougent » et « une seule bouge ») ; modèle d'embeddings tiers et base à maintenir.
- **RAG vectorielle maintenant** : à quelques dizaines d'events, l'index tient en une lecture et l'agent choisit mieux qu'un top-k ; deux events se ressemblent par leur signature observable, pas par leur texte (deux fiches rédigées de même peuvent décrire « toutes les références bougent » et « une seule bouge ») ; modèle d'embeddings tiers et base à maintenir.
- **Fiches chargées dans les instructions** (D-042) : l'agent les lirait avant les données, ancrage maximal.
- **Une fiche par type, ses incidents dedans** : index plus court, mais l'utilisateur préfère un dossier par upload.
- **Toujours le cas le plus proche** : rien n'est jamais inconnu, ancrage le plus fort.
- **Faits seuls, sans hypothèse hors cas** : contrôle maximal, mais le support repart de zéro.
- **Toujours l'event le plus proche** : rien n'est jamais inconnu, ancrage le plus fort.
- **Faits seuls, sans hypothèse hors event** : contrôle maximal, mais le support repart de zéro.
- **Lien vers les figures du rapport** : l'agent ne lit pas `rapports/`.
@@ -77,12 +77,12 @@ Opus 5.5 refuse qu'on force l'appel d'un outil (`tool_choice` `any` ou `tool`).
**Volontairement absents** (comme dans D-027) : SQL libre, Bash, accès web, bac à sable de code (§8).
### 3.3 La base de cas
### 3.3 La base d'events
- **Un fichier par cas résolu** : la question du client, les preuves, le brouillon de l'agent, le diagnostic final validé par le support, l'écart entre les deux. C'est la forme prévue par le contexte support (§13 étape 8, §17).
- **Au début**, tous les cas tiennent dans le prompt, en cache : pas d'outil de recherche. Un outil `find_cases` viendra quand il y en aura trop.
- **Au début**, tous les events tiennent dans le prompt, en cache : pas d'outil de recherche. Un outil `find_cases` viendra quand il y en aura trop.
- **Premier cas** : Barcelone (§15 de la roadmap, §16.1 du contexte support), rédigé d'après les docs comme cas documentaire, sans données.
- **La base se remplit seule** : une enquête validée par le support devient un cas (§5).
- **La base se remplit seule** : une enquête validée par le support devient un event (§5).
---
@@ -143,7 +143,7 @@ Sinon, le code remplace la conclusion du brouillon par une formule neutre (« é
- **Un dossier par enquête** (emplacement proposé : `agents/enquetes/<date>_<station>/`) : le journal des appels, le diagnostic en JSON, une page HTML de relecture (diagnostic, preuves avec leurs graphiques, brouillon client).
- **Le support relit, corrige le brouillon et l'envoie lui-même**, puis remplit une courte validation : accepté tel quel, ou corrigé (en quoi), et le diagnostic final.
- **Une enquête validée devient un cas** de la base (§3.3), sans autre étape.
- **Une enquête validée devient un event** de la base (§3.3), sans autre étape.
- **Mesures qui décident de la suite** : le taux d'accord entre l'agent et le support (classification, qualificatif, brouillon envoyé tel quel ou réécrit), puis le temps gagné par ticket.
- **Langue, par défaut** : la partie technique en anglais (termes AIMsight), le brouillon dans la langue du client.
@@ -154,7 +154,7 @@ Sinon, le code remplace la conclusion du brouillon par une formule neutre (« é
Deux axes à ne pas confondre : **qui déclenche** (le support, puis le client, puis la détection automatique) et **qui reçoit** (le support, puis le client pour certaines classes). Chaque étape répond à une question, et sa réponse décide si la suivante est nécessaire.
1.**Le harnais sur les données existantes.** Cas d'usage UC3 (« pourquoi pas de données entre X et Y ? ») rejoué sur les coupures connues : les 11 coupures de la liaison de NORDEND, les incidents isolés de WEISSHORN. *Question* : la tuyauterie tient-elle (preuves vérifiées, réfutation, page de relecture), et à quel coût ? N'attend pas les données de déplacement.
2.**Rejeu de cas de déplacement résolus**, dès qu'un export contient un événement expliqué (Barcelone idéalement). On branche `compare_before_after` et `common_mode` sur les CSV. *Question* : l'agent retrouve-t-il le diagnostic de l'expert, sans sur-conclure ?
2.**Rejeu d'events de déplacement résolus**, dès qu'un export contient un événement expliqué (Barcelone idéalement). On branche `compare_before_after` et `common_mode` sur les CSV. *Question* : l'agent retrouve-t-il le diagnostic de l'expert, sans sur-conclure ?
3.**Le support s'en sert sur ses vrais tickets.***Question* : quel taux d'accord, quel temps gagné ?
4.**Le bouton client sur le site** : la demande arrive au support déjà enquêtée. *Question* : les clients s'en servent-ils, et pour quels événements ?
5.**Réponse directe au client** pour les classes sans enjeu pour l'ouvrage, si l'accord mesuré le justifie. Ensuite seulement, la **détection automatique**, sur des critères tirés des tickets réels. C'est là que les deux approches se rejoignent : une surveillance quotidienne (D-027) qui repère un événement peut lancer une enquête.
@@ -187,7 +187,7 @@ Le volume suit celui des tickets : le coût n'est pas limitant face au temps d'u
| Faits inventés | Chaque preuve cite un appel du journal, vérifié par le code (§4) |
| Sur-conclusion sur des données incomplètes | `inventory` en premier ; `unknowns` obligatoire ; `insufficient evidence` admis |
| Graphique mal lu | Résumé chiffré à côté de l'image ; calculs déterministes dans les outils |
| Trop peu de cas pour juger | Rejeu des tickets passés ; chaque enquête validée devient un cas |
| Trop peu de cas pour juger | Rejeu des tickets passés ; chaque enquête validée devient un event |
| Données client chez Anthropic | Accepté (D-027) ; conditions de conservation à valider avec la direction |
### Prérequis
@@ -207,7 +207,7 @@ Le volume suit celui des tickets : le coût n'est pas limitant face au temps d'u
| Réponse directe au client dès le départ | Le risque de fausse assurance serait d'emblée chez le client |
| Détection automatique dès le départ | Il faudrait fixer des critères sur les déplacements avant d'avoir vu un seul ticket |
| L'agent extrait station, instant et points du texte du client | Source d'erreur évitable tant que le support lance l'enquête ; à revoir avec le bouton client, qui fournit ces champs |
| Recherche de cas (RAG) dès le départ | Inutile tant que les cas tiennent dans le prompt |
| Recherche d'events (RAG) dès le départ | Inutile tant que les events tiennent dans le prompt |
- **Pourquoi** : demande de l'utilisateur : `vues-deplacements/` mêlait la maquette et ses notes avec les détecteurs et les rendus des processus automatiques ; ce sont des morceaux du projet à part entière.
- **Options écartées** : aucune.
- **Conséquence** : vérifié après le déplacement : chaque détecteur et l'archive tournent sur C-001, les tests de `score.py`, `etiquettes.py` et `anonymiser.py` passent, le benchmark et le score sur les étiquettes de `boucle/` tournent, les pages Explore, détecteurs, fin de séance (NIEDERHORN), `voir.py` et `/revue-cas` (C-012 retrouve son lot dans `boucle/`) sont produites.
## D-085 — 2026-10-28 — Consulter la base de cas : le skill `read-event`
- **Statut** : active. Complète D-048 (§11 de `docs/agents/agent-diagnostic.md`).
- **Décision** : la façon de consulter `events/` s'écrit une seule fois, dans le skill `read-event` : la carte des événements et l'index d'abord, puis la fiche des seuls cas proches (au plus 3 par phénomène), puis leurs données par les commandes de la signature et les outils de `lire-les-donnees` ; jamais toutes les fiches d'un coup, ni un CSV affiché, ni le registre des noms. L'en-tête d'`INDEX.md` y renvoie ; les consignes de l'agent de diagnostic (donc `/support`), de `critiquer-lot` et du builder le citent au lieu de redire la procédure. Le skill dit comment lire, pas quand : chaque consigne garde son moment (après les faits pour le diagnostic et l'analyste, D-058 ; jamais pour le lecteur de `/aiguiser`). Ceux qui écrivent l'index (`/nouveau-cas`, le builder, la revue) visent une Signature d'environ 250 caractères, une indication et non une limite, le détail dans la fiche.
- **Pourquoi** : idée de l'utilisateur : un agent ne peut pas lire tous les cas, trop volumineux ; il lit un index sommaire, ouvre la fiche d'un cas qui l'intéresse, puis ses données s'il veut aller plus loin. La procédure existait (D-048) mais redite autrement dans chaque consigne, et l'index n'était plus sommaire : 13 lignes de 654 caractères en moyenne, quand la spec voulait une signature courte ; avec `/boucle` qui ajoute des cas, il deviendrait aussi lourd que ce qu'il devait éviter.
- **Options écartées** : la procédure dans le seul en-tête d'`INDEX.md` (pas de chargement par sa description en conversation) ; un hook qui bloquerait la lecture d'une fiche sans l'index (mécanique lourde pour une règle de quelques lignes) ; une limite stricte de longueur de la Signature (refus de l'utilisateur : une longueur souhaitée suffit) ; filtre par script ou recherche vectorielle, déjà prévus pour quelques centaines de cas (§11.8 de la spec).
- **Conséquence** : les 13 lignes existantes sont plus longues que la longueur souhaitée ; elles restent telles quelles. La revue n'en a pas besoin pour lire : elle ouvre le cas qu'on lui donne.
## D-086 — 2026-10-28 — « Cas » devient « event », C-xxx devient E-xxx
- **Statut** : active. Renomme ce que nomment D-048, D-057, D-069, D-075, D-080 et D-085, sans les réécrire.
- **Décision** : un incident de la base `events/` s'appelle un **event**, plus un « cas » : la base d'events, `E-xxx` au lieu de `C-xxx` (dossiers, figures, données codées, registre, `etiquettes.json`, historique du benchmark, colonne `event`), une fiche `event.md` au lieu de `cas.md` ; les skills prennent des noms anglais, comme `read-event` : `/new-event` (ex-`/nouveau-cas`), `/review-event` (ex-`/revue-cas`, page dans `out/review-event/`), `anonymize-event` (ex-`anonymiser-cas`) ; le builder écrit `**Events créés** :`. Les fichiers vivants suivent (consignes, skills, scripts, `CLAUDE.md`, spec et plan vivants, documentation) ; l'historique reste tel qu'il a été écrit : les décisions passées, `docs/superpowers/` sauf le plan et la spec vivants, les séances de `boucle/` et d'`aiguiser/`, les rapports de l'agent de diagnostic, `support/`, `docs/ameliorations-processus.md`. Le mot garde son sens courant ailleurs (« dans ce cas », cas d'usage, cas de régression, une demande au support, le dossier `vues-deplacements/cas/` du parcours NORDEND).
- **Pourquoi** : demande de l'utilisateur, par cohérence avec le dossier `events/`.
- **Options écartées** : garder `C-xxx` (proposé par Claude : rien ne cassait) ; des noms de skills en français ; réécrire l'historique.
- **Conséquence** : dans l'historique, `C-xxx` se lit `E-xxx`, même numéro. Les séances d'avant écrivent « Cas créés » et `C-xxx` : la page de `/review-event` accepte les deux pour retrouver le lot d'origine d'un event appris.
@@ -49,7 +49,7 @@ Elles découlent des règles non négociables de `CLAUDE.md` et des anti-pattern
- **Asymétrie du risque** : effacer un mouvement réel coûte plus cher que laisser du bruit. On ne corrige un point que si la cause externe est au moins `strongly supported` ; sinon on le signale sans le corriger. Une marche qui persiste reste un mouvement réel candidat tant qu'il n'est pas réfuté.
- **Calcul causal**, comme les autres analyses (`.claude/rules/analyses.md`) : le point t n'utilise que les données ≤ t.
- **Pas de décision sur `inlier` binaire** ; poids continus, résidus, `N_eff` (roadmap §5, §7).
- **Aucun seuil sans source**, **pas de données synthétiques** : validation sur des cas réels seulement.
- **Aucun seuil sans source**, **pas de données synthétiques** : validation sur des events réels seulement.
@@ -7,7 +7,7 @@ Deux rapports d'analyse remis au client par l'équipe AIMsight (mai 2026, révis
Murs de soutènement en maçonnerie le long d'une voie ferrée, suivis près de deux ans, avec des prismes et des bandes réfléchissantes adhésives (« ciblettes »). Verdict des deux rapports : **aucun déplacement structurel notable** ; chaque déplacement apparent est attribué à une cause externe, preuves à l'appui (images, `error`, brillance).
Ils font office de vérité de référence pour `displacement`, avec deux limites :
- les exports de ces murs ne sont pas dans `data/` : on ne peut ni vérifier les signatures ni rejouer un cas. Ils n'entrent donc pas dans la base de cas de l'agent de diagnostic (`events/`, D-048) ;
- les exports de ces murs ne sont pas dans `data/` : on ne peut ni vérifier les signatures ni rejouer un event. Ils n'entrent donc pas dans la base d'events de l'agent de diagnostic (`events/`, D-048) ;
- les signatures ci-dessous sont lues sur les figures des rapports (axes illisibles dans GN-5.054) ; aucune heure n'y est donnée.
## Mur GN-1.472 (01/01 au 15/03/2026, détail du 15/02 au 15/03)
@@ -39,7 +39,7 @@ Ils font office de vérité de référence pour `displacement`, avec deux limite
- Obstruction la plus délicate selon l'expert : la végétation (croissance, feuilles au vent), partielle, pour laquelle le seuil d'acceptation par défaut ne suffisait pas.
- Ciblettes jusqu'à 40 m ; certaines, près de prismes bien plus lumineux, mal mesurées ou éliminées.
## Ce que ces cas ajoutent au cadrage
## Ce que ces events ajoutent au cadrage
Familles absentes du tableau §4.1 de `docs/displacement/cadrage.md`, à confronter aux données quand on en aura :
- **interférence entre cibles voisines** : image claire, mais un voisin trop brillant ; *Dominance* (FAQ) mesure ce risque, dans le HDF5 seulement ;
La documentation AIMsight en fait son cas de régression principal : roadmap, ligne 33 et §15 ; contexte support, §7-8 (exemple de dossier, question « Why did D-300-A jump? »), §12.2, §16.1 et l'exemple « Barcelona reference switching ». Ses données sont dans `data/CLARIDEN/` (export « L9 BCN », du 17/09 22:00 au 20/09 21:50 UTC, cadence de 10 min, 29 capteurs dont 5 références ; 432 images à 10 min, une par mesure, heures des zips en UTC) et, codées, dans le cas C-004 (`events/C-004/`).
La documentation AIMsight en fait son cas de régression principal : roadmap, ligne 33 et §15 ; contexte support, §7-8 (exemple de dossier, question « Why did D-300-A jump? »), §12.2, §16.1 et l'exemple « Barcelona reference switching ». Ses données sont dans `data/CLARIDEN/` (export « L9 BCN », du 17/09 22:00 au 20/09 21:50 UTC, cadence de 10 min, 29 capteurs dont 5 références ; 432 images à 10 min, une par mesure, heures des zips en UTC) et, codées, dans le cas E-004 (`events/E-004/`).
## Ce qu'on observe
@@ -13,7 +13,7 @@ D'après le rapport à l'aveugle du 2026-10-15 (`agent-diagnostic/rapports/2026-
## Deux lectures
- **Documentation AIMsight** : mouvement de la station et de la caméra, instabilité des références (`PR_284`, `PR_291`), bascules entre états de compensation, cibles restées mesurables ; *« primarily reference-network / compensation-state instability, not target tracking »*. La suite décrite est côté système : remise à zéro du motif, reconfiguration, exclusion de `PR_284` envisagée, référence ajoutée.
- **Expert** (rapporté par l'utilisateur le 2026-10-15) : l'ouvrage a bougé, et la caméra et les références avec lui ; le dispositif surestime sans doute l'amplitude ; d'autres systèmes de mesure du chantier ont vu une anomalie importante, et le chantier a été interrompu ; l'ouvrage est un pont, dont la voûte s'affaisse (utilisateur, 2026-10-24). C'est le diagnostic de C-004 : *monitored-object motion*, mouvement réel, intervention.
- **Expert** (rapporté par l'utilisateur le 2026-10-15) : l'ouvrage a bougé, et la caméra et les références avec lui ; le dispositif surestime sans doute l'amplitude ; d'autres systèmes de mesure du chantier ont vu une anomalie importante, et le chantier a été interrompu ; l'ouvrage est un pont, dont la voûte s'affaisse (utilisateur, 2026-10-24). C'est le diagnostic de E-004 : *monitored-object motion*, mouvement réel, intervention.
Les deux ne s'excluent pas : une compensation instable fausse l'amplitude d'un mouvement réel. Les mesures seules ne séparent pas l'ouvrage de la caméra quand tout bouge ensemble ; à l'aveugle, l'agent de diagnostic a conclu à une *weak/unstable reference solution*, conséquence indéterminée.
@@ -14,6 +14,6 @@ La plateforme garde deux types d'images par mesure (type de mesure), que le pomp
## Ce qu'on en sait
- NORDEND a des images DIFF, une par heure au pompage (~160 Mo par jour). LENZSPITZE n'en a aucune en base les 26 et 27/10 (pompage du 2026-10-28), seulement des IRON, une par heure : mode d'acquisition sans DIFF, sans doute (non vérifié). Les autres stations : inconnu.
- Le 29/07 à NORDEND (C-002, toile d'araignée selon l'expert), l'image DIFF montre de longues traînées claires sur tout le champ et les cibles en points, là où l'image IRON ne montre que de faibles bandes sombres. Ce qui est tout près de l'objectif y ressort peut-être mieux : à confirmer (point 28 du plan du journal du matin).
- Le 29/07 à NORDEND (E-002, toile d'araignée selon l'expert), l'image DIFF montre de longues traînées claires sur tout le champ et les cibles en points, là où l'image IRON ne montre que de faibles bandes sombres. Ce qui est tout près de l'objectif y ressort peut-être mieux : à confirmer (point 28 du plan du journal du matin).
- Les outils de lecture (`agent-tools/donnees.py`), donc `/aiguiser` et `/boucle`, ne regardent que les images IRON et écartent `images_diff/`.
- Piste, non vérifiée : si `x`, `y` sont mesurés sur l'image DIFF, un centroïde pris sur l'image IRON peut s'en écarter (écart constant par capteur vu sur NORDEND, `colonnes-des-deplacements.md`).
- **La règle d'or : simple.** L'utilisateur, le 2026-10-23 : « c'est ça, la guideline, l'instruction que je dois m'imposer : ça doit être simple ; il ne faut pas chercher à faire des trucs super complexes. » Le plus bête qui marche sur les cas, puis on itère avec lui. Pas d'imagination débordante, pas d'optimal, pas de stylé ; avant d'ajouter une règle ou une constante, se demander si le client en a besoin pour comprendre. À redire à tout sous-agent.
- **La règle d'or : simple.** L'utilisateur, le 2026-10-23 : « c'est ça, la guideline, l'instruction que je dois m'imposer : ça doit être simple ; il ne faut pas chercher à faire des trucs super complexes. » Le plus bête qui marche sur les events, puis on itère avec lui. Pas d'imagination débordante, pas d'optimal, pas de stylé ; avant d'ajouter une règle ou une constante, se demander si le client en a besoin pour comprendre. À redire à tout sous-agent.
- **Catégorique et complet** (retour du 2026-10-23) : chaque événement a **une** catégorie, dite sans « probably », « most likely » ou « may be » ; la phrase dit ce qui s'est passé et quoi en faire.
- **On garde toutes les données.** Invalider = griser ou mettre en retrait, jamais retirer un point de la courbe brute.
- **Un vrai mouvement n'est jamais invalidé.** CLARIDEN (C-004) doit rester visible et marqué « à vérifier » à chaque changement.
- **Un vrai mouvement n'est jamais invalidé.** CLARIDEN (E-004) doit rester visible et marqué « à vérifier » à chaque changement.
- Code de calcul en **bibliothèque standard**, embarquable ; pas de pandas ; pas de nouvelle dépendance.
- **Heures en UTC** partout ; l'export horaire est en heure suisse sans fuseau (`docs/domaine/colonnes-des-deplacements.md`).
- **Documents en français, texte du site en anglais** (D-023).
- **Pas de données synthétiques** (refus explicite de l'utilisateur).
- **Seuils** : chacun est commenté « provisoire, réglé sur C-00x » (règle « aucun seuil sans source » du `CLAUDE.md`, adaptée à l'exploration) et inscrit au registre, `vues-deplacements/contexte/seuils-du-journal.md` (point 17).
- **Seuils** : chacun est commenté « provisoire, réglé sur E-00x » (règle « aucun seuil sans source » du `CLAUDE.md`, adaptée à l'exploration) et inscrit au registre, `vues-deplacements/contexte/seuils-du-journal.md` (point 17).
- **Identifiants** (`SIM_CCID`, `ip`, secrets de l'application) jamais recopiés ; ne jamais lire de `.env`.
- **Lecture seule** : rien n'écrit dans la base de la plateforme ni dans les dépôts `~/monitoring-dashboard-*` ; Claude ne se connecte jamais à la base, l'utilisateur lance l'extraction.
- **Contrat d'un détecteur** (inchangé) : `detectors/<nom>.py` expose `detect(mesures) -> list[dict]`, `mesures = donnees.charger(dossier)` (`agent-tools/donnees.py`) ; épisode `{"start": iso, "end": iso, "kind": "<nom>", "label": str, "text": str, "ignore": bool, "sensors": [str]}` (heures `donnees.iso`, `sensors` vide = tous) ; un `__main__` qui imprime une ligne par épisode.
- **Décisions** : une décision prise en conversation va dans `docs/decisions.md` (sous D-056 ou nouvelle entrée) ; un savoir métier nouveau dans `docs/displacement/domaine/` ; l'état du chantier dans « État et prochaine étape » de `CLAUDE.md` (qui doit rester sous 200 lignes, D-012).
- **Commit** seulement quand l'utilisateur le demande.
- **Cas de la base** : un cas n'y entre que sur demande de l'utilisateur (`/nouveau-cas`) ; noms codés dans `events/`.
- **Events de la base** : un event n'y entre que sur demande de l'utilisateur (`/new-event`) ; noms codés dans `events/`.
## Points d'attention (ce qui casse le plus probablement)
@@ -38,7 +38,7 @@
2. **Deux étiquettes contradictoires au même moment.** Aujourd'hui, à NORDEND le 14/10 à 05:15, deux lignes disent « Sudden jump » et « Poor visibility ». Le classement doit n'en sortir qu'**un** événement. Contrôle : point 10, toutes les lignes.
3. **Une seule cible grise toutes les courbes.** « Target obscured » sur 4 cibles grise presque une journée à NORDEND. Contrôle : point 18, NORDEND du 13/10 09:45 au 14/10 07:00.
4. **Pas d'image pour l'événement.** PS des Coudres n'a que 24 images (13/10 12:00 → 14/10 11:00) ; NIEDERHORN est horaire. Le processus « images » doit dire « No camera image for this period. » au lieu de casser ou d'afficher une image hors période. Contrôle : point 7, PS des Coudres le 13/10 à 01:15.
5. **Un export qui commence pendant un artefact.**`sauts` prend la place habituelle sur le premier jour, `visibilite` et `turbulence` le niveau habituel sur tout l'export (médiane, MAD, quartile bas) : un export court ou pris en plein épisode fausse les étiquettes (C-002 : l'épisode couvre la plus grande partie de l'export). Contrôle : point 30 (tranches de 3 à 5 jours) et point 31 (la boucle les compare). **Constaté au point 30 (2026-10-24)** : une tranche de 3 jours sans historique absorbe le vrai saut de PR17 ; 3 jours d'historique le rendent.
5. **Un export qui commence pendant un artefact.**`sauts` prend la place habituelle sur le premier jour, `visibilite` et `turbulence` le niveau habituel sur tout l'export (médiane, MAD, quartile bas) : un export court ou pris en plein épisode fausse les étiquettes (E-002 : l'épisode couvre la plus grande partie de l'export). Contrôle : point 30 (tranches de 3 à 5 jours) et point 31 (la boucle les compare). **Constaté au point 30 (2026-10-24)** : une tranche de 3 jours sans historique absorbe le vrai saut de PR17 ; 3 jours d'historique le rendent.
| 45 | Le but de la boucle : chaque instant étiqueté, la précision mesurée | Décider, Coder | 31, 44 | score codé le 2026-10-25 (D-062) ; à juger à la première séance |
| 46 | La page de fin de séance : l'analyste face aux détecteurs | Coder | 31, 45 | codé le 2026-10-26 (D-066) ; à regarder après la prochaine séance |
| 47 | Les détecteurs doivent tout détecter ; l'affichage à part | Décider, Coder | 13, 41, 45 | règle posée le 2026-10-26 (D-068) ; détecteurs à changer par la boucle ; couche d'affichage à faire |
| 48 | Un benchmark des détecteurs sur la base de cas | Décider, Coder | 45, 46 | construit le 2026-10-26 (D-069) ; étiquettes de C-001 à C-005 à relire par l'utilisateur |
| 48 | Un benchmark des détecteurs sur la base d'events | Décider, Coder | 45, 46 | construit le 2026-10-26 (D-069) ; étiquettes de E-001 à E-005 à relire par l'utilisateur |
| | **VII. Idées gardées pour plus tard** | | | |
| 33 | Les autres métriques de certains projets | Comprendre | 27 | en attente |
| 34 | Météo et HDF5 pour dire la cause | Comprendre | 27 | en attente |
| 35 | Un cas de la base par catégorie | Lancer | 5 | en attente |
| 35 | Un event de la base par catégorie | Lancer | 5 | en attente |
| 36 | Porter le journal dans la vraie application | Coder | 10 | en attente |
| 49 | Le graphe des éventualités du terrain et deux catégories nouvelles | Décider, Coder | 5 | catégories (D-074) dans la carte, l'analyste et les détecteurs le 2026-10-27 ; à entraîner par `/boucle` |
| 50 | Une ligne Status : la compilation de tous les détecteurs | Décider, Coder | 47, 49 | ligne Status dans `detecteurs.py` le 2026-10-27, refaite le même jour : ce qui se passe, l'événement qui englobe ; ordre des catégories à confirmer |
@@ -139,16 +139,16 @@ Chemins conseillés : le plus simple et le plus parlant d'abord, **11 (visibilit
### Point 2 : Les cinq détecteurs en un coup d'œil
**Pourquoi.** Savoir ce que chaque détecteur regarde, ce qu'il trouve sur les cas et où il se trompe, avant d'en régler un (points 11 à 15).
**Pourquoi.** Savoir ce que chaque détecteur regarde, ce qu'il trouve sur les events et où il se trompe, avant d'en régler un (points 11 à 15).
**Ce qui existe** (méthode et résultats complets dans la docstring de chaque fichier ; résumé des rapports en annexe A).
| Détecteur | Regarde | Sort | Grisé | Bon sur | Se trompe sur |
| `sauts.py` (117 l) | `corr_x`, `corr_y` des cibles : un pas à ≥ 20 bruits du niveau des 4 mesures d'avant | `Sudden jump, back to normal`, `Lasting shift`, `Jump, not back yet` | seulement « back to normal » | C-002, C-003 (le saut d'un pas du 04/09), C-004 non grisé, NORDEND PR17 | trains de NIEDERHORN (1 cible sur 3, et celui de la première mesure) ; une cible seule de CLARIDEN en « Lasting shift » |
| `sauts.py` (117 l) | `corr_x`, `corr_y` des cibles : un pas à ≥ 20 bruits du niveau des 4 mesures d'avant | `Sudden jump, back to normal`, `Lasting shift`, `Jump, not back yet` | seulement « back to normal » | E-002, E-003 (le saut d'un pas du 04/09), E-004 non grisé, NORDEND PR17 | trains de NIEDERHORN (1 cible sur 3, et celui de la première mesure) ; une cible seule de CLARIDEN en « Lasting shift » |
| `thermique.py` (128 l) | profil horaire de `corr` sur les jours, répétabilité | `Daily thermal cycle`, un par jour complet | jamais | PS des Coudres (08:00-18:00) | rien ailleurs : la compensation enlève le cycle (point 13) |
| `turbulence.py` (106 l) | agitation d'une mesure à l'autre **et**`error_value`, face au calme du capteur | `Heat shimmer` | si agitation ≥ 2× | C-003 (04:00-15:00, les trois jours) | rien ailleurs ; marge faible sur le matin de CLARIDEN (point 14) |
| `turbulence.py` (106 l) | agitation d'une mesure à l'autre **et**`error_value`, face au calme du capteur | `Heat shimmer` | si agitation ≥ 2× | E-003 (04:00-15:00, les trois jours) | rien ailleurs ; marge faible sur le matin de CLARIDEN (point 14) |
- Chargement : `explore.py` charge tous les `detectors/*.py` qui ont `detect` (un fichier sans `detect` est ignoré ; un détecteur qui plante est sauté avec un message).
@@ -167,7 +167,7 @@ Chemins conseillés : le plus simple et le plus parlant d'abord, **11 (visibilit
- 12 événements : 9 à ignorer (trou de données, pluie / brume / buée, neige, passage, feuilles / plante, références masquées, cycle thermique, turbulence, éclairage / voisin brillant) et 3 à regarder (tout a bougé et reste décalé, une cible a sauté, dérive lente), chacun avec label anglais, phrase au client, signature, cas ou source, détecteur ;
- un arbre Mermaid de 6 questions (mesures manquantes ? `error_value` au-dessus du seuil ? chaque jour aux mêmes heures ? le décalage reste ? une cible ou beaucoup ? références touchées ? durée ?) ;
- 5 lacunes : la cause d'une mauvaise visibilité (météo ou image), les obstructions lentes et contrastes faibles (HDF5), la dérive lente absente du journal, « références masquées » contre « tout a bougé » (Barcelone), la cause d'une cible qui saute.
- Doutes de l'agent : neige, dérive lente, cible qui saute et voisin brillant n'ont aucun cas dans la base ; les trains peuvent être un effet optique ou un vrai fléchissement du rail (à revoir par l'expert) ; les seuils « beaucoup », « quelques heures », « des jours » sont à fixer.
- Doutes de l'agent : neige, dérive lente, cible qui saute et voisin brillant n'ont aucun event dans la base ; les trains peuvent être un effet optique ou un vrai fléchissement du rail (à revoir par l'expert) ; les seuils « beaucoup », « quelques heures », « des jours » sont à fixer.
- Le diagramme n'a jamais été rendu (pas de `mmdc` ici).
- Écart avec la carte : la carte classe le cycle thermique « à ignorer », le détecteur `thermique` le laisse non grisé (normal). À trancher au point 5.
@@ -175,7 +175,7 @@ Chemins conseillés : le plus simple et le plus parlant d'abord, **11 (visibilit
- [x] Rendre le Mermaid (aperçu Markdown de VS Code, ou mermaid.live en collant le bloc) et corriger la syntaxe s'il ne s'affiche pas. Fait le 2026-10-24 (mermaid 10.9.1 dans Chrome headless) : rendu sans erreur, rien à corriger.
- [x] Compléter la carte (consigne de l'utilisateur, 2026-10-24) : tout ce qui peut arriver, vu ou non, en familles ; fait le 2026-10-24 : 33 événements en six familles (pas de mesure, vue gênée, cible changée, références, caméra et support, ouvrage qui bouge), les nouveaux marqués « hypothétique » ; l'arbre Mermaid ne range encore que les 12 premiers.
- [x] Passer le tableau ligne par ligne avec l'utilisateur : label, phrase, à ignorer ou non ; noter ses corrections dans le fichier. Validé en bloc comme base le 2026-10-24, sans correction.
- [x] Poser la question des trains (effet optique ou rail qui fléchit) et noter la réponse. Posée le 2026-10-24 ; la carte garde les deux possibilités (« Passage », « Fléchissement sous une charge ») ; le classement des trains de C-005 reste à trancher au point 5.
- [x] Poser la question des trains (effet optique ou rail qui fléchit) et noter la réponse. Posée le 2026-10-24 ; la carte garde les deux possibilités (« Passage », « Fléchissement sous une charge ») ; le classement des trains de E-005 reste à trancher au point 5.
- [x] Ajouter en tête du fichier : « Validé par l'utilisateur le <date> » pour les lignes validées.
**Fini quand.** Chaque ligne est validée ou corrigée par l'utilisateur.
@@ -228,7 +228,7 @@ Précision de l'utilisateur, le même soir : le gros saut, c'est généralement
- [x] Les huit catégories : à garder, fusionner, renommer ?
- [x] Le cycle thermique : « normal, gardé » (détecteur) ou « à ignorer » (carte) ?
- [x] `saut_bref` : une catégorie à part, ou toujours « Loss of visibility » quand il y a des rejets autour ?
- [x] Une reprise de saut pendant une perte de visibilité (C-002, le 31/07 à 20:30, 13 cibles, une heure avant la fin des données) : `a_verifier` ou absorbée ?
- [x] Une reprise de saut pendant une perte de visibilité (E-002, le 31/07 à 20:30, 13 cibles, une heure avant la fin des données) : `a_verifier` ou absorbée ?
- [x] Le processus de chaque catégorie : le bouton `Images`, oui ou non.
- [x] La perte de visibilité en deux niveaux, « Reduced visibility » (données moyennes) et « No visibility » (on ne voit rien) : point 38.
@@ -237,7 +237,7 @@ Précision de l'utilisateur, le même soir : le gros saut, c'est généralement
- [x] Écrire le tableau validé dans `events/carte-des-evenements.md`, nouvelle section « 4. Catégories du journal et processus », en reliant chaque catégorie aux lignes de la section 1.
- [x] Ajouter la décision sous D-056 (« Catégories du journal, validées le <date> »).
**Décidé le 2026-10-24** : les huit catégories, les règles et les sept recommandations, telles quelles : catégories gardées, « No data » partout ; cycle thermique pas grisé ; `saut_bref` à part ; reprise de C-002 en `a_verifier` ; bouton `Images` sauf turbulence, cycle thermique et trou ; deux niveaux de visibilité sur le principe (point 38) ; trains de C-005 en `passage`. Écrit dans la carte, section 4, et sous D-056. **Point 38 (2026-10-24)** : `visibilite_perdue` devient `visibilite_reduite` (Reduced visibility, en retrait) et `visibilite_nulle` (No visibility, grisée). **Point 41 (2026-10-24)** : `cycle_thermique` devient `dilatation_thermique` (Thermal expansion) et `contraction_thermique` (Thermal contraction), non grisées.
**Décidé le 2026-10-24** : les huit catégories, les règles et les sept recommandations, telles quelles : catégories gardées, « No data » partout ; cycle thermique pas grisé ; `saut_bref` à part ; reprise de E-002 en `a_verifier` ; bouton `Images` sauf turbulence, cycle thermique et trou ; deux niveaux de visibilité sur le principe (point 38) ; trains de E-005 en `passage`. Écrit dans la carte, section 4, et sous D-056. **Point 38 (2026-10-24)** : `visibilite_perdue` devient `visibilite_reduite` (Reduced visibility, en retrait) et `visibilite_nulle` (No visibility, grisée). **Point 41 (2026-10-24)** : `cycle_thermique` devient `dilatation_thermique` (Thermal expansion) et `contraction_thermique` (Thermal contraction), non grisées.
**Fini quand.** Le tableau est validé et écrit ; c'est l'entrée du point 6.
@@ -273,7 +273,7 @@ Précision de l'utilisateur, le même soir : le gros saut, c'est généralement
- un passage absorbe aussi un saut revenu (c'est une perte de visibilité d'un instant ; le point 10 l'attend à NIEDERHORN le 01/10 à 12:00) : règle précisée dans la carte, section 4 ;
- un détecteur inconnu garde son nom comme catégorie, sans planter.
Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes les courbes et chevauche les pertes de visibilité (NORDEND du 13/10 09:45 au 14/10 07:00 : points 11 et 18) ; à NORDEND de juillet (C-002), « Shift to check » et « Loss of visibility » au même moment le 31/07 à 20:30 (voulu par la règle du point 5) ; l'échelle de CLARIDEN écrasée par une cible à 11 px (point 19).
Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes les courbes et chevauche les pertes de visibilité (NORDEND du 13/10 09:45 au 14/10 07:00 : points 11 et 18) ; à NORDEND de juillet (E-002), « Shift to check » et « Loss of visibility » au même moment le 31/07 à 20:30 (voulu par la règle du point 5) ; l'échelle de CLARIDEN écrasée par une cible à 11 px (point 19).
### Point 7 : Le bouton `Images` : la vidéo de l'épisode
@@ -281,7 +281,7 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
**Ce qui existe.**
- `D.images` : `[{t, src}]`, toutes les images du dossier avec leur heure UTC (déjà dans la page, pour l'onglet View) ; `D.view` : le cadre des capteurs dans l'image (± 150 px) ; l'onglet View sait déjà afficher une image, zoomer sur les cibles, jouer un film (`▶ Play`, 2, 4 ou 8 images par seconde) et dessiner les cercles colorés selon `error_value`.
- `agent-tools/vignettes.py` : grille PNG de vignettes (capteurs × heures), pour l'agent et les fiches de cas ; pas pour la page.
- `agent-tools/vignettes.py` : grille PNG de vignettes (capteurs × heures), pour l'agent et les fiches d'events ; pas pour la page.
- Images disponibles : NORDEND d'octobre au pas de 15 min (985 images) ; NORDEND de juillet, WILDSTRUBEL, CLARIDEN à 10 min ; NIEDERHORN horaire ; PS des Coudres 24 images horaires (13/10 12:00 → 14/10 11:00).
**Décisions prises ici.**
@@ -335,7 +335,7 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
**Pourquoi.** « Il faut donner un diagnostic clair, et puis il faut que le diagnostic il soit complet. » Les phrases actuelles hésitent (« most likely », « probably rain, fog… »).
**Modèle.** La section « Verdict » des fiches de cas (`events/C-00x/cas.md`), écrites avec l'agent de diagnostic : une phrase, la cause et son niveau de preuve, la conséquence pour l'ouvrage, l'action (C-002 : « Une toile d'araignée devant l'objectif, vue sur les images : l'ouvrage n'a pas bougé et il n'y a rien à faire. »).
**Modèle.** La section « Verdict » des fiches d'events (`events/E-00x/event.md`), écrites avec l'agent de diagnostic : une phrase, la cause et son niveau de preuve, la conséquence pour l'ouvrage, l'action (E-002 : « Une toile d'araignée devant l'objectif, vue sur les images : l'ouvrage n'a pas bougé et il n'y a rien à faire. »).
**Règle proposée** (concilie le diagnostic catégorique avec la règle du projet de séparer fait et hypothèse) :
- la **catégorie** est un fait observé (les cibles étaient mal vues, un objet est passé, les mesures manquent) : elle se dit sans conditionnel ;
@@ -365,16 +365,16 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
**Pourquoi.** C'est le contrôle de toute la partie II, et des points d'attention 1 et 2.
**Attendu** (d'après les rapports des détecteurs du 2026-10-23 et la vérité des cas ; à mettre à jour si le point 5 change une règle) :
**Attendu** (d'après les rapports des détecteurs du 2026-10-23 et la vérité des events ; à mettre à jour si le point 5 change une règle) :
| NORDEND octobre (`vues-deplacements/cas/2026-10_NORDEND/NORDEND`) | `visibilite_perdue` 07/10 17:15 → 08/10 12:15 (sauts du 07/10 19:45 et du 08/10 07:15 absorbés) ; `a_verifier` PR17 le 08/10 à 02:30, **à part, non grisé** ; `visibilite_perdue` 09/10 07:45 → 14:00 (saut commun de 08:45 absorbé) et 20:45 → 23:45 (saut de 21:15 absorbé) ; `visibilite_perdue` 14/10 05:15 → 06:30 (saut de 11 cibles absorbé, images de l'aube) ; `trou` 15/10 22:30 → 16/10 01:15 | buée le 08/10, parois ruisselantes le 09/10, 17 rejets à 23:00, taches pâles à l'aube le 14/10 (`parcours.md`) ; PR17 sans explication claire | Tout l'attendu (le saut de PR15 du 08/10 04:45 aussi absorbé). En plus, de `visibilite` : 6 « Target hidden » (CTR01, PR04, PR07, PR09), dont le 13/10 09:45 → 14/10 07:00 qui recouvre la perte de visibilité du 14/10 ; 2 « Passing obstacle » (09/10 18:45, 12/10 14:15) ; une « Loss of visibility » courte (13/10 09:45 → 10:30) → points 11 et 18 |
| C-001 PS des Coudres | `visibilite_perdue` 13/10 23:45 → 14/10 04:45 (2 références) ; aussi 13/10 01:15 → 03:30 (sans image) ; `cycle_thermique` chaque jour complet 08:00 → 18:00 | buée, 2 références sur 3 ; système sain | Conforme |
| C-002 NORDEND juillet | `visibilite_perdue` 28/07 20:45 → 31/07 02:45 (paliers de `sauts` absorbés) ; `a_verifier` le 31/07 à 20:30 (reprise, non absorbée, règle du point 5) | toile d'araignée, vue | Conforme (2 paliers absorbés ; `a_verifier` 31/07 20:30 → 21:30, 13 cibles, non grisé). En plus : « Loss of visibility » 31/07 20:30 → 21:45 (18 capteurs), au même moment, dernière heure de l'export → point 11 |
| C-003 WILDSTRUBEL | `turbulence` les 02, 03 et 04/09, environ 04:00 → 15:00, saut d'un pas du 04/09 06:45 absorbé ; `cible_masquee` PA_9 les matins ; `passage` à 3 instants (2 douteux) | turbulence et plein soleil | Conforme (3 turbulences, saut du 04/09 06:45 absorbé, 3 matins de PA_9, 3 passages) ; sur la frise, la cible masquée est cachée sous la turbulence (point 40) |
| C-004 CLARIDEN | `a_verifier` 19/09 06:10, 18 cibles, **non grisé** ; `a_verifier` une cible le 18/09 15:40 (faux positif connu) ; `passage` 18/09 13:40 et 20/09 06:20 | mouvement réel | Conforme : le 19/09 06:10, « Shift to check », 18 cibles dont 4 restées décalées, **non grisé**. En plus : « Target hidden » PR-284 le 19/09 18:30 → 18:50, qui grise toutes les courbes 20 min, douze heures après le saut → points 11 et 18 ; échelle écrasée par une cible à 11 px (point 19) |
| C-005 NIEDERHORN | `passage` 30/09 22:00, 01/10 12:00 (saut absorbé) et 21:00, 02/10 21:00 ; `visibilite_perdue` 01/10 06:00 → 11:00 et 02/10 03:00 → 11:00 ; `cible_masquee` 02/10 10:00 → 22:00 | 5 trains (celui du 03/10 10:00 manqué), pluie deux nuits, feuilles | Conforme (4 passages, dont le 01/10 12:00 avec son saut absorbé ; 2 pertes de visibilité ; la cible masquée) ; le train du 03/10 10:00 reste manqué ; le 30/09 22:00 n'a pas d'image (elles commencent le 01/10 00:00) |
| E-001 PS des Coudres | `visibilite_perdue` 13/10 23:45 → 14/10 04:45 (2 références) ; aussi 13/10 01:15 → 03:30 (sans image) ; `cycle_thermique` chaque jour complet 08:00 → 18:00 | buée, 2 références sur 3 ; système sain | Conforme |
| E-002 NORDEND juillet | `visibilite_perdue` 28/07 20:45 → 31/07 02:45 (paliers de `sauts` absorbés) ; `a_verifier` le 31/07 à 20:30 (reprise, non absorbée, règle du point 5) | toile d'araignée, vue | Conforme (2 paliers absorbés ; `a_verifier` 31/07 20:30 → 21:30, 13 cibles, non grisé). En plus : « Loss of visibility » 31/07 20:30 → 21:45 (18 capteurs), au même moment, dernière heure de l'export → point 11 |
| E-003 WILDSTRUBEL | `turbulence` les 02, 03 et 04/09, environ 04:00 → 15:00, saut d'un pas du 04/09 06:45 absorbé ; `cible_masquee` PA_9 les matins ; `passage` à 3 instants (2 douteux) | turbulence et plein soleil | Conforme (3 turbulences, saut du 04/09 06:45 absorbé, 3 matins de PA_9, 3 passages) ; sur la frise, la cible masquée est cachée sous la turbulence (point 40) |
| E-004 CLARIDEN | `a_verifier` 19/09 06:10, 18 cibles, **non grisé** ; `a_verifier` une cible le 18/09 15:40 (faux positif connu) ; `passage` 18/09 13:40 et 20/09 06:20 | mouvement réel | Conforme : le 19/09 06:10, « Shift to check », 18 cibles dont 4 restées décalées, **non grisé**. En plus : « Target hidden » PR-284 le 19/09 18:30 → 18:50, qui grise toutes les courbes 20 min, douze heures après le saut → points 11 et 18 ; échelle écrasée par une cible à 11 px (point 19) |
| E-005 NIEDERHORN | `passage` 30/09 22:00, 01/10 12:00 (saut absorbé) et 21:00, 02/10 21:00 ; `visibilite_perdue` 01/10 06:00 → 11:00 et 02/10 03:00 → 11:00 ; `cible_masquee` 02/10 10:00 → 22:00 | 5 trains (celui du 03/10 10:00 manqué), pluie deux nuits, feuilles | Conforme (4 passages, dont le 01/10 12:00 avec son saut absorbé ; 2 pertes de visibilité ; la cible masquée) ; le train du 03/10 10:00 reste manqué ; le 30/09 22:00 n'a pas d'image (elles commencent le 01/10 00:00) |
**Étapes.**
- [x] Lancer `categories.py` sur les six jeux ; comparer au tableau ; noter chaque écart dans une colonne « Obtenu » ajoutée au tableau, dans ce plan.
@@ -387,15 +387,15 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
### Point 38 : Les statuts de visibilité : bonne, moyenne, nulle
**Pourquoi.** L'utilisateur, le 2026-10-23 : « on peut catégoriser : il y a des cas où la visibilité est vraiment affreuse, et des cas où elle n'est pas très bonne. Quand il pleut, la visibilité n'est pas très bonne, c'est moyen, les données sont moyennes ; et il y a des moments où vraiment on ne voit rien. » Et : « c'est là où on revient un peu sur les statuts : on veut faire des statuts des cibles. » Comme les statuts des métriques système (Energy, Storage, Cellular, Temperature : vert, orange, rouge), un statut de visibilité, par cible et pour la station. Placé ici, dans la partie II, parce qu'il change la catégorie « perte de visibilité » du point 5.
**Pourquoi.** L'utilisateur, le 2026-10-23 : « on peut catégoriser : il y a des events où la visibilité est vraiment affreuse, et des events où elle n'est pas très bonne. Quand il pleut, la visibilité n'est pas très bonne, c'est moyen, les données sont moyennes ; et il y a des moments où vraiment on ne voit rien. » Et : « c'est là où on revient un peu sur les statuts : on veut faire des statuts des cibles. » Comme les statuts des métriques système (Energy, Storage, Cellular, Temperature : vert, orange, rouge), un statut de visibilité, par cible et pour la station. Placé ici, dans la partie II, parce qu'il change la catégorie « perte de visibilité » du point 5.
**Proposition à valider.**
| Statut | Couleur | Ce qu'on voit | Phrase au client (à valider au point 9) | Sur les courbes |
|---|---|---|---|---|
| Good visibility | vert | `error_value` loin du seuil | rien, pas d'entrée au journal | rien |
| Reduced visibility | orange | `error_value` qui approche le seuil, quelques rejets ; la pluie de C-005 (nuits du 01 et du 02/10), sans doute la buée de C-001 | « Visibility was reduced (see images): the data in this period are less precise. » | zone en léger retrait (gris très clair ou hachures), données gardées |
| No visibility | rouge | la plupart des capteurs rejetés : NORDEND le 09/10 à 23:00 (17 capteurs), la toile de C-002 | « The camera could not see the targets: ignore the curves in this period. » | zone grisée |
| Reduced visibility | orange | `error_value` qui approche le seuil, quelques rejets ; la pluie de E-005 (nuits du 01 et du 02/10), sans doute la buée de E-001 | « Visibility was reduced (see images): the data in this period are less precise. » | zone en léger retrait (gris très clair ou hachures), données gardées |
| No visibility | rouge | la plupart des capteurs rejetés : NORDEND le 09/10 à 23:00 (17 capteurs), la toile de E-002 | « The camera could not see the targets: ignore the curves in this period. » | zone grisée |
- **Calcul**, dans l'esprit du point 11 : le rapport `error_value / error_threshold` de chaque cible, et sa moyenne pour la station. La page le colore déjà ainsi dans l'onglet View (`errorColor` dans `explore_template.html` : vert loin du seuil, orange à son approche, rouge au-dessus). Deux limites sur la moyenne (et sur la part de cibles rejetées) séparent les trois statuts.
- **Par cible** : le même statut, cible par cible (une bande par cible dans la couche support, point 23).
@@ -414,42 +414,42 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
**Étapes.**
- [x] Faire valider le tableau ; reporter le choix au point 5 (catégories) et au point 9 (phrases).
- [x] Dans la version simple de `visibilite.py`, deux limites sur la moyenne, `REDUIT` et `NUL` (provisoires, réglées à l'œil : pluie de C-005 = Reduced, NORDEND le 09/10 à 23:00 = None ; registre du point 17) ; un épisode par période de même statut, avec son `level`.
- [x] Dans la version simple de `visibilite.py`, deux limites sur la moyenne, `REDUIT` et `NUL` (provisoires, réglées à l'œil : pluie de E-005 = Reduced, NORDEND le 09/10 à 23:00 = None ; registre du point 17) ; un épisode par période de même statut, avec son `level`.
- [x] Écartée le 2026-10-24 (la frise suffit ; à la place, barre orange et léger retrait pour « Reduced », grisé pour « None »). Texte d'origine : la bande de statut (vert, orange, rouge) sous les courbes du Journal, mesure par mesure ; épisodes `reduced` en léger retrait, `none` grisés.
- [x] Vérifier sur les six jeux et montrer : C-005, les deux nuits de pluie en orange ; C-002, la toile en rouge ; NORDEND le 09/10 à 23:00 en rouge ; C-001 (buée) et C-003 (turbulence) : orange ou rien, à juger par l'utilisateur.
- [x] Vérifier sur les six jeux et montrer : E-005, les deux nuits de pluie en orange ; E-002, la toile en rouge ; NORDEND le 09/10 à 23:00 en rouge ; E-001 (buée) et E-003 (turbulence) : orange ou rien, à juger par l'utilisateur.
- [x] Reporter les statuts validés dans `events/carte-des-evenements.md` (section 4 du point 5) et sous D-056.
**Fini quand.** L'utilisateur distingue d'un coup d'œil « données moyennes » et « on ne voit rien » sur les six jeux.
**Décidé et fait le 2026-10-24.** Proposition revue après le point 11 (la v0 reste) : la v0 trouve l'épisode, le seuil de la plateforme dit sa gravité, mesure par mesure ; « none » quand au moins la moitié des cibles habituellement vues sont rejetées (`MOITIE`, provisoire), « reduced » sinon. Validé par l'utilisateur avec quatre recommandations : trois statuts ; « Reduced » gardé en léger retrait, barre orange ; pas de bande de statut pour l'instant (la frise suffit ; peut venir avec le point 40) ; statut du jour client et support plus tard. Codé : `visibilite.py` (champ `level`, un épisode par période de même niveau), `categories.py` (`visibilite_reduite`, `visibilite_nulle` ; phrase « Reduced » ; la durée d'un événement et la fusion ne comptent plus les sauts absorbés, qui étiraient « No visibility » le 09/10 jusqu'à 12:45), gabarit (orange, léger retrait). Résultat : NORDEND le 09/10 08:45 → 10:30 et 21:30 → 23:15, le 14/10 05:15 → 06:00 en « No visibility », le reste de ces épisodes en « Reduced » ; buées (NORDEND, C-001), toile (C-002), pluie (C-005) en « Reduced ». Conséquence à connaître : un saut absorbé dans une visibilité réduite n'est plus grisé, seulement en retrait (la phrase dit qu'il n'est pas un mouvement).
**Décidé et fait le 2026-10-24.** Proposition revue après le point 11 (la v0 reste) : la v0 trouve l'épisode, le seuil de la plateforme dit sa gravité, mesure par mesure ; « none » quand au moins la moitié des cibles habituellement vues sont rejetées (`MOITIE`, provisoire), « reduced » sinon. Validé par l'utilisateur avec quatre recommandations : trois statuts ; « Reduced » gardé en léger retrait, barre orange ; pas de bande de statut pour l'instant (la frise suffit ; peut venir avec le point 40) ; statut du jour client et support plus tard. Codé : `visibilite.py` (champ `level`, un épisode par période de même niveau), `categories.py` (`visibilite_reduite`, `visibilite_nulle` ; phrase « Reduced » ; la durée d'un événement et la fusion ne comptent plus les sauts absorbés, qui étiraient « No visibility » le 09/10 jusqu'à 12:45), gabarit (orange, léger retrait). Résultat : NORDEND le 09/10 08:45 → 10:30 et 21:30 → 23:15, le 14/10 05:15 → 06:00 en « No visibility », le reste de ces épisodes en « Reduced » ; buées (NORDEND, E-001), toile (E-002), pluie (E-005) en « Reduced ». Conséquence à connaître : un saut absorbé dans une visibilité réduite n'est plus grisé, seulement en retrait (la phrase dit qu'il n'est pas un mouvement).
---
## Partie III — Les détecteurs, un par un
Chaque point : on le règle sur les cas, on relance les six jeux, on met à jour la docstring (méthode et résultats) et le registre du point 17. Ne jamais régler un seuil sur un seul jeu sans relancer les cinq autres.
Chaque point : on le règle sur les events, on relance les six jeux, on met à jour la docstring (méthode et résultats) et le registre du point 17. Ne jamais régler un seuil sur un seul jeu sans relancer les cinq autres.
### Point 11 : `visibilite` : la version simple d'abord
**Pourquoi.** Retour de l'utilisateur (2026-10-23) : la ligne Visibility de la v0 est « super bien », et « c'est facile de calculer la visibilité des cibles : soit individuellement, soit faire la moyenne des visibilités. Et on peut détecter facilement quand les taux d'erreur sont élevés ; dans ces cas-là, on indique qu'il y a une mauvaise visibilité ». La guideline est la simplicité. La v0 marche mais a grossi : 11 constantes, médianes et MAD par capteur, trois sorties.
**Pourquoi.** Retour de l'utilisateur (2026-10-23) : la ligne Visibility de la v0 est « super bien », et « c'est facile de calculer la visibilité des cibles : soit individuellement, soit faire la moyenne des visibilités. Et on peut détecter facilement quand les taux d'erreur sont élevés ; dans ces events-là, on indique qu'il y a une mauvaise visibilité ». La guideline est la simplicité. La v0 marche mais a grossi : 11 constantes, médianes et MAD par capteur, trois sorties.
**La version simple, à essayer d'abord.**
- Visibilité d'une cible, à chaque mesure : `error_value / error_threshold` (1 ou plus = mesure rejetée).
- Visibilité de la station : la moyenne de ce rapport sur les capteurs mesurés. C'est exactement la bande du haut de l'onglet View (spec, section « L'onglet View »), déjà calculée en JS pour la page.
- `Loss of visibility` quand la moyenne dépasse un niveau pendant quelques mesures d'affilée ; `Passing obstacle` quand elle le dépasse sur une seule mesure ; `Target hidden` quand une cible dépasse son seuil plusieurs fois alors que la moyenne reste basse. Tout est grisé ; le bouton `Images` du point 7 apporte la preuve.
- Trois constantes au plus (le niveau de la moyenne, le nombre de mesures d'affilée, le nombre de rejets d'une cible), réglées à l'œil sur les cas et inscrites au registre du point 17.
- Risque connu : la buée de C-001 reste **sous le seuil** des références ; c'est pour cela que la v0 compare chaque capteur à son propre niveau. La version simple la manquera peut-être : le mesurer et le dire à l'utilisateur, qui tranche (simple et imparfait d'abord, selon sa règle).
- Trois constantes au plus (le niveau de la moyenne, le nombre de mesures d'affilée, le nombre de rejets d'une cible), réglées à l'œil sur les events et inscrites au registre du point 17.
- Risque connu : la buée de E-001 reste **sous le seuil** des références ; c'est pour cela que la v0 compare chaque capteur à son propre niveau. La version simple la manquera peut-être : le mesurer et le dire à l'utilisateur, qui tranche (simple et imparfait d'abord, selon sa règle).
**Étapes.**
- [x] Mettre la v0 de côté : la copier dans `detectors/archive/visibilite_v0.py` (le chargeur ne lit que `detectors/*.py`, pas les sous-dossiers).
- [x] Réécrire `detectors/visibilite.py` en version simple, même contrat, labels du point 9.
- [x] Lancer les six jeux ; un tableau v0 contre version simple, face à la vérité du point 10 : ce que la simple attrape, ce qu'elle manque (C-001, le train à 2 cibles, les feuilles, les obstructions de WILDSTRUBEL).
- [x] Lancer les six jeux ; un tableau v0 contre version simple, face à la vérité du point 10 : ce que la simple attrape, ce qu'elle manque (E-001, le train à 2 cibles, les feuilles, les obstructions de WILDSTRUBEL).
- [x] Montrer le tableau à l'utilisateur ; garder la simple si elle suffit à ses yeux, sinon ne reprendre de la v0 que ce qui manque. Choix de l'utilisateur le 2026-10-24 : **la v0 reste en service** (`detectors/visibilite.py`), la simple est gardée dans `detectors/archive/visibilite_simple.py`.
- [x] Docstring (méthode et résultats) et registre du point 17 à jour. La docstring de la v0 dit l'essai et son résultat ; le registre ne change pas (constantes de la v0 ; celles de la simple restent dans l'archive).
**La v0, pour mémoire** (de nouveau dans `detectors/visibilite.py` depuis le choix du 2026-10-24) : mesure « haute » = `error_value` > médiane + `K_MAD` (10) MAD **et** > `FACTEUR` (2) × médiane du capteur, sur tout l'export ; `Brief obstruction` si ≥ `BREF_MIN` (3) capteurs hauts à un instant, `SAILLIE` (3) fois plus qu'aux instants voisins ; `Poor visibility` : suites d'au moins `SUITE_MIN` (3) mesures hautes, réunies entre capteurs (≥ 2), réduites aux instants où ≥ `FRAC` (15 %) du pic est haut, coupées par une accalmie de `COUPURE` (2 h) ; `Target obscured` : une cible rejetée et à plus de `K_CIBLE` (5) MAD, au moins `CIBLE_MIN` (3) fois à moins de `CIBLE_ECART` (6 h) ; `ECART` 2,5 pas entre deux mesures d'une suite. Ses défauts connus, à ne corriger que si l'on en garde des morceaux :
- `Target obscured` est la sortie la plus bruitée : à NORDEND d'octobre, CTR01, PR04 et PR09, souvent rejetées, donnent des épisodes jusqu'à un jour ; l'image du 13/10 à 20:00 paraît normale ;
- le train du 03/10 10:00 (C-005, 2 cibles) est manqué (`BREF_MIN` = 3) ;
- le train du 03/10 10:00 (E-005, 2 cibles) est manqué (`BREF_MIN` = 3) ;
- la pluie du 01/10 commence à 06:00 contre 05:00 dans la vérité ;
- WILDSTRUBEL : deux `Brief obstruction` (02/09 12:00, 03/09 08:15) probablement dus à la turbulence (à écarter dans le classement, point 6) ; celui du 04/09 14:00 est plausible (véhicule et image fantôme sur la route) ;
- le texte de `Brief obstruction` cite « train, vehicle or animal » même dans le tunnel de CLARIDEN (réglé par le point 9) ;
@@ -462,11 +462,11 @@ Chaque point : on le règle sur les cas, on relance les six jeux, on met à jour
| Jeu | v0 | Simple (`NIVEAU` 0,2) |
|---|---|---|
| NORDEND octobre | buée du 07/10 17:15 au 08/10 12:15 en une perte de visibilité ; 09/10 jour et nuit ; 14/10 aube ; 6 « Target hidden » | la buée devient un « Target hidden » de 4 cibles, un passage et deux bouts de perte de visibilité ; 09/10 et 14/10 trouvés ; 4 « Target hidden », dont toujours les deux longs |
| C-001 PS des Coudres | les deux nuits de buée (REF_G, REF_D) | **rien** : la buée reste sous le seuil |
| C-002 NORDEND juillet | la toile en une perte de visibilité (28/07 20:45 → 31/07 02:45) | la toile en 3 morceaux, plus 3 « Target hidden » |
| C-003 WILDSTRUBEL | PA_9 les matins, 3 passages | **8 pertes de visibilité et 7 passages** dans la turbulence (20 à 60 % des cibles rejetées de jour) |
| C-004 CLARIDEN | 2 passages (tunnel), PR-284 20 min | **PR_BG grisé le 19/09 de 06:10 à 06:30, au moment du vrai mouvement** ; PR-284 |
| C-005 NIEDERHORN | pluie 06:00 → 11:00 et 03:00 → 11:00, 4 trains, feuilles | pluie 06:00 → 09:00 et 05:00 → 11:00 (plus courte), 2 trains sur 4, feuilles, 3 « Target hidden » en plus |
| E-001 PS des Coudres | les deux nuits de buée (REF_G, REF_D) | **rien** : la buée reste sous le seuil |
| E-002 NORDEND juillet | la toile en une perte de visibilité (28/07 20:45 → 31/07 02:45) | la toile en 3 morceaux, plus 3 « Target hidden » |
| E-003 WILDSTRUBEL | PA_9 les matins, 3 passages | **8 pertes de visibilité et 7 passages** dans la turbulence (20 à 60 % des cibles rejetées de jour) |
| E-004 CLARIDEN | 2 passages (tunnel), PR-284 20 min | **PR_BG grisé le 19/09 de 06:10 à 06:30, au moment du vrai mouvement** ; PR-284 |
| E-005 NIEDERHORN | pluie 06:00 → 11:00 et 03:00 → 11:00, 4 trains, feuilles | pluie 06:00 → 09:00 et 05:00 → 11:00 (plus courte), 2 trains sur 4, feuilles, 3 « Target hidden » en plus |
Bilan : la simple est moins bonne sur cinq jeux et grise le vrai mouvement de CLARIDEN ; ce qui manque, c'est la comparaison de chaque capteur à son propre niveau (la v0), sans laquelle la buée sous le seuil et la turbulence ne se distinguent pas d'une perte de visibilité. Recommandation : remettre la v0 en service, garder la simple dans l'archive. **Choisi par l'utilisateur** ; les défauts de la v0 restent (« Target hidden » trop sensible : points 18 et 11 bis si besoin).
@@ -517,7 +517,7 @@ Bilan : la simple est moins bonne sur cinq jeux et grise le vrai mouvement de CL
- Midis agités sans hausse de l'`error_value` à PS des Coudres et NORDEND d'octobre (50 à 100 % des capteurs un peu plus agités à midi) : turbulence légère à signaler, ou rien ?
- Marge faible avec un vrai mouvement : le matin du mouvement de CLARIDEN (06:00-08:00) agite les corrections et fait monter l'`error_value` ; seule la durée minimale de 3 h l'écarte, à une heure près. Danger : point d'attention 1.
- Une vague lente gonfle un peu l'agitation (la pente s'ajoute aux écarts) ; le détecteur ne retranche pas la tendance locale.
- Bords en retard d'environ 30 min au début et d'1 h à la fin face à la vérité de C-003 (03:30 → 16:00).
- Bords en retard d'environ 30 min au début et d'1 h à la fin face à la vérité de E-003 (03:30 → 16:00).
**À décider par l'utilisateur.**
- [x] Les midis agités : turbulence légère (épisode non grisé) ou rien ? Rien (utilisateur, 2026-10-24).
@@ -546,10 +546,10 @@ Bilan : la simple est moins bonne sur cinq jeux et grise le vrai mouvement de CL
**Pistes, de la plus simple à la plus dure** (une à la fois, sur demande) :
- [x] **Dérive lente** (`Slow drift`, à vérifier) : fait le 2026-10-24, autrement que prévu : pas de fichier `derive.py` (la tendance se calcule sur l'export horaire, hors du contrat `detect(mesures)`), mais les tendances déjà calculées par l'onglet `Displacements` reprises par `explore.build` en événements `derive_lente`, jamais grisés, en trait rouge fin dans la frise ; NORDEND d'octobre : « PR06 drifts slowly and steadily: +0.7 mm in 10 days. Keep watching it. » (6 → 15/10) ; aucune tendance sur les cinq autres jeux. Texte d'origine : réutiliser `find_trend` de `vues-deplacements/maquette/explore.py` (Theil-Sen et tau de Kendall sur les niveaux journaliers de l'export horaire, 5 jours au moins, D-055) dans un détecteur `detectors/derive.py` ; tendance de PR06 à NORDEND d'octobre (+0,7 mm en 10 jours) comme contrôle.
- [x] **Références masquées** (« plus assez de références, tout bouge ») : couvert, sans catégorie à part (utilisateur, 2026-10-24) : la phrase de la perte de visibilité dit « including the reference targets » (point 38) et les sauts communs y sont absorbés. Texte d'origine : un épisode `visibilite` qui touche des `global_ref`**et** un saut commun de nombreuses cibles qui revient (C-002) ; catégorie à part ou phrase de `visibilite_perdue` ; à décider avec l'utilisateur. Règles du projet : ne rien construire sur `inlier` binaire ; `sigma0` seul et le nombre de références ne suffisent jamais.
- [x] **Références masquées** (« plus assez de références, tout bouge ») : couvert, sans catégorie à part (utilisateur, 2026-10-24) : la phrase de la perte de visibilité dit « including the reference targets » (point 38) et les sauts communs y sont absorbés. Texte d'origine : un épisode `visibilite` qui touche des `global_ref`**et** un saut commun de nombreuses cibles qui revient (E-002) ; catégorie à part ou phrase de `visibilite_perdue` ; à décider avec l'utilisateur. Règles du projet : ne rien construire sur `inlier` binaire ; `sigma0` seul et le nombre de références ne suffisent jamais.
- [x] **Tout a bougé** contre **références masquées** : remis, impossible sur les mesures seules (2026-10-24). Texte d'origine : impossible sur les mesures seules (Barcelone, `docs/displacement/domaine/incident-de-barcelone.md`) ; reste `a_verifier`, avec les images.
- [x] **Éclairage, voisin trop brillant** : remis à plus tard, en attente d'un cas de l'utilisateur (2026-10-24). Texte d'origine : créneaux jour / nuit sur une ou quelques cibles (C-003) ; à essayer seulement si l'utilisateur apporte un cas.
- [x] **Neige** : aucun cas ; attendre un hiver et un cas (point 35). Remis à plus tard (2026-10-24).
- [x] **Éclairage, voisin trop brillant** : remis à plus tard, en attente d'un event de l'utilisateur (2026-10-24). Texte d'origine : créneaux jour / nuit sur une ou quelques cibles (E-003) ; à essayer seulement si l'utilisateur apporte un event.
- [x] **Neige** : aucun event ; attendre un hiver et un event (point 35). Remis à plus tard (2026-10-24).
**Fini quand.** Chaque piste est faite ou explicitement remise à plus tard dans l'index.
@@ -572,7 +572,7 @@ Bilan : la simple est moins bonne sur cinq jeux et grise le vrai mouvement de CL
### Point 17 : Le registre des seuils provisoires
**Pourquoi.** Tous les seuils sont réglés sur 5 cas ; quand les données en masse arriveront (partie VI), c'est la liste à revoir.
**Pourquoi.** Tous les seuils sont réglés sur 5 events ; quand les données en masse arriveront (partie VI), c'est la liste à revoir.
**Le registre** a quitté ce plan le 2026-10-24 : il vit dans `vues-deplacements/contexte/seuils-du-journal.md`, vérifié contre le code (toutes les valeurs collaient ; ajoutés : `MERGE` du classement et les constantes de tendance de la dérive lente).
@@ -753,7 +753,7 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
- [x] Claude compare le CSV obtenu à l'export reçu pour la même plage : colonnes, UTC, nombre de lignes (script en bibliothèque standard, `donnees.charger` sur les deux dossiers) ; il lance `categories.py` (ou les détecteurs) sur le nouveau dossier. Fait pour le 29/07 : 2 112 lignes, colonnes et valeurs identiques à l'export reçu ; métriques identiques heure par heure ; images IRON identiques octet pour octet. `categories.py` attend le 30/07 (3 jours d'historique).
- [x] Si l'unité d'acquisition n'est pas unique (règle MER* / ME2S* de `app/base/models.py:268`), le noter. Rien à noter : unité trouvée.
- [x] Noter le résultat dans `donnees-et-boucle.md`, section « Ce qui reste à vérifier », et dans l'index.
- [x] Relancer la même commande (seuls les déplacements du 30/07 manquent) ; lire la cause de l'échec, que le script affiche maintenant. Cause (2026-10-26) : délai de 60 s dépassé (`QueryCanceled`), alors que le 30/07 a autant de mesures que le 29/07 (2 090 lignes contre 2 112 dans l'export reçu) ; option `--delai` ajoutée, relance du 30/07 seul avec `--delai 300` : 93 s, 2 090 lignes, identiques à l'export reçu. `categories.py` sur le dossier pompé : mêmes événements que sur l'export reçu réduit aux mêmes jours ; avec l'export entier (historique dès le 27/07 22:00), la toile de C-002 devient un seul événement `visibilite_reduite` du 28/07 20:45 au 30/07 23:45, coupé en morceaux sans historique : pomper 3 jours de plus avant la période voulue.
- [x] Relancer la même commande (seuls les déplacements du 30/07 manquent) ; lire la cause de l'échec, que le script affiche maintenant. Cause (2026-10-26) : délai de 60 s dépassé (`QueryCanceled`), alors que le 30/07 a autant de mesures que le 29/07 (2 090 lignes contre 2 112 dans l'export reçu) ; option `--delai` ajoutée, relance du 30/07 seul avec `--delai 300` : 93 s, 2 090 lignes, identiques à l'export reçu. `categories.py` sur le dossier pompé : mêmes événements que sur l'export reçu réduit aux mêmes jours ; avec l'export entier (historique dès le 27/07 22:00), la toile de E-002 devient un seul événement `visibilite_reduite` du 28/07 20:45 au 30/07 23:45, coupé en morceaux sans historique : pomper 3 jours de plus avant la période voulue.
**Fini quand.** Un dossier pompé donne les mêmes mesures que l'export reçu, et le temps par jour est connu.
@@ -768,7 +768,7 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
**Ce qui existe.** Type de mesure `OPTICAL_SHIFT-DIFF`, en PNG, seulement sur les stations réglées en mode « Differential » ; lesquelles et à quelle cadence : inconnu. Le script les prend avec `--diff`, rangées dans `images_diff/`. D'après le manuel de la station, ce n'est pas la différence entre deux instants mais l'image des réflecteurs, contraste renforcé, celle que mesure l'algorithme par défaut (`docs/domaine/images-de-la-camera.md`). L'utilisateur les juge peu utiles pour `/boucle` et `/aiguiser` (2026-10-26) : `--diff` reste une option, hors de la commande de `run.md`.
**Étapes.**
- [ ] Au premier pompage avec `--diff`, compter les images différentielles par jour ; si une station en a, en regarder quelques-unes avec l'utilisateur ; NORDEND en a (2026-10-26) : 24 par jour à une par heure, PNG 16 bits 3088×2064, ~7 Mo l'une ; le 29/07, pendant C-002 (toile d'araignée selon l'expert), de longues traînées claires sur tout le champ et les cibles en points, là où l'image brute ne montre que de faibles bandes sombres ; à confirmer par l'utilisateur : montrent-elles ce qui a changé (toile, eau, neige) mieux que l'image brute ?
- [ ] Au premier pompage avec `--diff`, compter les images différentielles par jour ; si une station en a, en regarder quelques-unes avec l'utilisateur ; NORDEND en a (2026-10-26) : 24 par jour à une par heure, PNG 16 bits 3088×2064, ~7 Mo l'une ; le 29/07, pendant E-002 (toile d'araignée selon l'expert), de longues traînées claires sur tout le champ et les cibles en points, là où l'image brute ne montre que de faibles bandes sombres ; à confirmer par l'utilisateur : montrent-elles ce qui a changé (toile, eau, neige) mieux que l'image brute ?
- [ ] Si oui : les ajouter au processus « images » (point 7), après l'image brute.
### Point 29 : Options B (depuis WSL) et C (route du collègue)
@@ -817,11 +817,11 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
3. **Tri sans image** : l'outil du point 30 ; coût : l'ordinateur seul.
4. **Regard de Claude, choisi** : seulement les tranches où le tri voit quelque chose, ou ne voit rien malgré un signal fort (saut ou tendance de l'onglet Displacements), et seulement les courbes et 4 à 8 vignettes par événement ; un **plafond de tranches par séance**, fixé à l'avance.
5. **Critique** : par événement, d'accord, en retard, en trop, ou manquant ; verdict écrit dans un fichier de revue de la tranche, hors de tout dossier de station (règle de `vues-deplacements/CLAUDE.md`).
6. **Proposition** : au plus deux sorties : un réglage chiffré d'un détecteur, avec les événements qui changent, ou un cas candidat (créé seulement si l'utilisateur lance `/nouveau-cas`).
6. **Proposition** : au plus deux sorties : un réglage chiffré d'un détecteur, avec les événements qui changent, ou un event candidat (créé seulement si l'utilisateur lance `/new-event`).
7. **Rejeu** : le détecteur modifié est relancé sur **toutes** les tranches déjà vues ; on ne passe à la suite que s'il ne casse rien.
8. **Arrêt** : au plafond, ou quand deux tranches de suite ne donnent plus rien à corriger.
**Étapes** (remplacées le 2026-10-24 par la conception approuvée, `vues-deplacements/contexte/boucle-automatique.md`, D-057 ; le principe en 8 étapes ci-dessus reste pour l'histoire : plus de plafond, plus de rejeu, les réglages et les cas sans accord préalable).
**Étapes** (remplacées le 2026-10-24 par la conception approuvée, `vues-deplacements/contexte/boucle-automatique.md`, D-057 ; le principe en 8 étapes ci-dessus reste pour l'histoire : plus de plafond, plus de rejeu, les réglages et les events sans accord préalable).
- [x] Construire la boucle : plan `docs/superpowers/plans/2026-10-24-boucle-automatique.md`, tâches 1 à 6 (skills `boucle` et `critiquer-lot`, agents `analyste`, `upgrader`, `validateur`, `builder`, fenêtre d'`anonymiser.py`, D-057).
- [x] Essai (2026-10-24) : l'analyste seul sur le lot 1 de NORDEND d'octobre (05/10 → 09/10) : verdict « suggestions » (deux : une référence rejetée qui fausse la compensation de toutes les cibles, fondue dans un épisode au lieu d'être grisée ; un nombre de capteurs faux dans la phrase de la buée), une nouveauté (halo sur la vitre sous PR17 au saut du 08/10 02:30, cause non établie), la buée du 07/10 au 08/10 retrouvée ; 53 appels d'outils, ~250 000 jetons, 8 min 30 (Opus, effort élevé ; les images pèsent le plus). **Fonctionnement validé par l'utilisateur le 2026-10-24.**
- [ ] Première séance (tâche 7 du plan), **par l'utilisateur seul**, plus tard : sur de nouvelles données, lot par lot (il choisit les lots, traités indépendamment ; « on verra comment on fait »), quand les autres développements seront faits ; Claude ne la lance pas. Ensuite, Claude fait les contrôles de la tâche 7 et résume le bilan.
@@ -837,13 +837,13 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
- **Analyste** : lance les détecteurs sur le lot, puis juge leurs résultats (« LLM as judge ») en regardant lui-même les données et les images, avec un skill de critique ; verdict positif (lot suivant) ou suggestions.
- **Upgrader** : reprend les suggestions et modifie les détecteurs.
- **Validateur** : ne refait pas l'analyse ; vérifie que la modification répond à ce qu'a relevé l'analyste et va dans le bon sens ; **pas trop strict** (aucune modification n'est parfaite) ; aller-retour avec l'upgrader jusqu'à son accord.
- **Builder** : tout ce que l'analyste découvre de nouveau devient un cas structuré comme ceux de la base, pour les agents de diagnostic (automatiser ce qui se fait aujourd'hui à la main avec `/nouveau-cas`).
- **Ce que la boucle doit laisser** (l'utilisateur) : avoir appris : de nouveaux cas tirés des événements des données (le builder construit la base de connaissances), et des détections optimisées (l'upgrader) ; l'analyste et le validateur sont les juges qui y mènent.
- **Builder** : tout ce que l'analyste découvre de nouveau devient un event structuré comme ceux de la base, pour les agents de diagnostic (automatiser ce qui se fait aujourd'hui à la main avec `/new-event`).
- **Ce que la boucle doit laisser** (l'utilisateur) : avoir appris : de nouveaux events tirés des événements des données (le builder construit la base de connaissances), et des détections optimisées (l'upgrader) ; l'analyste et le validateur sont les juges qui y mènent.
- **Précision** (l'utilisateur) : en cas de doute sur les rôles (surtout entre upgrader et validateur), se fier à ses premières consignes, ci-dessus ; d'autres transcriptions suivront.
- **Rôles reformulés par Claude, acceptés par l'utilisateur le 2026-10-24** (« parfait »), avec les ajouts de Claude : les agents ne se parlent pas, chacun écrit son rendu dans le dossier de la séance et l'orchestrateur le transmet ; au plus 3 allers-retours upgrader / validateur, puis on garde la dernière version qui va dans le bon sens ; plusieurs analystes en parallèle plus tard, l'upgrader toujours seul ; les cas du builder marqués « appris par Claude, non validé », lus par les analystes des lots suivants (même base que les autres, voir plus bas) ; modifications des détecteurs sur une branche git à part ; déplacements seulement.
- **Réponses de l'utilisateur le 2026-10-24** : tout se commite, chaque modification, pour s'y retrouver et revenir en arrière ; le builder ajoute les cas sans attendre (« ça ne peut pas vraiment faire de mal »), une revalidation à la main viendra peut-être plus tard, pas maintenant ; l'upgrader modifie les détecteurs seul, « essayer et voir dans quelle direction ça va » ; **pas de rejeu** des lots déjà vus : on explore des données et on améliore peu à peu, sans chercher l'exhaustif ni tout revalider à chaque fois (remplace le rejeu de l'étape 7 et l'ajout de Claude) ; la crainte : **partir dans trop de complexité**.
- **Rôles reformulés par Claude, acceptés par l'utilisateur le 2026-10-24** (« parfait »), avec les ajouts de Claude : les agents ne se parlent pas, chacun écrit son rendu dans le dossier de la séance et l'orchestrateur le transmet ; au plus 3 allers-retours upgrader / validateur, puis on garde la dernière version qui va dans le bon sens ; plusieurs analystes en parallèle plus tard, l'upgrader toujours seul ; les events du builder marqués « appris par Claude, non validé », lus par les analystes des lots suivants (même base que les autres, voir plus bas) ; modifications des détecteurs sur une branche git à part ; déplacements seulement.
- **Réponses de l'utilisateur le 2026-10-24** : tout se commite, chaque modification, pour s'y retrouver et revenir en arrière ; le builder ajoute les events sans attendre (« ça ne peut pas vraiment faire de mal »), une revalidation à la main viendra peut-être plus tard, pas maintenant ; l'upgrader modifie les détecteurs seul, « essayer et voir dans quelle direction ça va » ; **pas de rejeu** des lots déjà vus : on explore des données et on améliore peu à peu, sans chercher l'exhaustif ni tout revalider à chaque fois (remplace le rejeu de l'étape 7 et l'ajout de Claude) ; la crainte : **partir dans trop de complexité**.
- **Conception écrite le 2026-10-24** : `vues-deplacements/contexte/boucle-automatique.md`, **approuvée** par l'utilisateur le 2026-10-24 ; plan de construction : `docs/superpowers/plans/2026-10-24-boucle-automatique.md` (7 tâches) ; rien construit.
- **L'agent de diagnostic n'entre pas en jeu dans la boucle** (l'utilisateur, 2026-10-24) : il n'y a aucun travail, ses consignes ne changent pas ; il sert au diagnostic pour l'utilisateur et sera traité dans une autre conversation. Tous les cas restent au même endroit : le builder complète la base `events/` (C-006…, marqués « appris »).
- **L'agent de diagnostic n'entre pas en jeu dans la boucle** (l'utilisateur, 2026-10-24) : il n'y a aucun travail, ses consignes ne changent pas ; il sert au diagnostic pour l'utilisateur et sera traité dans une autre conversation. Tous les events restent au même endroit : le builder complète la base `events/` (E-006…, marqués « appris »).
### Point 32 : Le test « Claude verrait la même chose »
@@ -860,7 +860,7 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
**Pourquoi** (l'utilisateur, 2026-10-24). L'analyste et l'agent de diagnostic jugent à partir des données ; pour bien juger, il faut bien lire. La lecture n'est pas le diagnostic : s'ils lisaient avec les détecteurs, ils seraient biaisés et tendraient à les valider. Un autre processus automatique, à part de `/boucle`, ne travaille que sur les outils de lecture, lot après lot, pour « aiguiser la vision de Claude ».
**Le principe** (brainstorming du 2026-10-24, accepté par l'utilisateur) : un skill de lecture, `lire-les-donnees`, seule source des outils et de leur mode d'emploi, suivi par l'analyste, l'agent de diagnostic et un **lecteur** ; un **correcteur** lit chaque lot à fond avec ses propres scripts, sans ces outils, et cette lecture lente sert de corrigé ; un **optimiseur** modifie le skill d'après l'écart ; un changement sans gain est annulé ; contrôle sur C-001 à C-005 en fin de séance ; `/aiguiser <dossier>`, lancé par l'utilisateur seul.
**Le principe** (brainstorming du 2026-10-24, accepté par l'utilisateur) : un skill de lecture, `lire-les-donnees`, seule source des outils et de leur mode d'emploi, suivi par l'analyste, l'agent de diagnostic et un **lecteur** ; un **correcteur** lit chaque lot à fond avec ses propres scripts, sans ces outils, et cette lecture lente sert de corrigé ; un **optimiseur** modifie le skill d'après l'écart ; un changement sans gain est annulé ; contrôle sur E-001 à E-005 en fin de séance ; `/aiguiser <dossier>`, lancé par l'utilisateur seul.
@@ -892,9 +892,9 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
- [x] L'utilisateur choisit d'étendre le script avant le premier essai (2026-10-24).
- [x] Métriques système, un fichier par jour, défaut des images corrigé.
- [ ] Liste des types de mesure d'une station : non demandée, au point 33.
- [ ] Mouvements de la caméra (demande de l'utilisateur, 2026-10-26) : `pan`, `tilt`, `scale`, `rotation`, `sigma0` à la minute, médiane et bornes, par la lecture du visualiseur de la plateforme (`get_shifts_aggregate(..., "cam_movements_1min")`, comme `fetch_cam_movements_frame`), un CSV par jour dans `camera/` ; lus par `ensemble.py` et `inventaire.py`, pose lue en premier par le skill `lire-les-donnees` (2026-10-26, D-073). Essayé le 2026-10-26 sur le 30/07 de NORDEND (C-002) : 2 s, 70 lignes, une par mesure (toutes les 15 min, min = max) ; sur les 95 instants des déplacements, 70 ont une pose de la caméra (pan de −0,059 à −0,010, tilt de −0,089 à −0,020), dont 7 seulement un `sigma0`, les mêmes que l'export « advanced » ; les 25 autres, surtout de 15:15 à 22:45, n'ont ni pose ni `sigma0` : pas de recalage de la caméra. La pose existe donc là où l'export n'a pas de `sigma0`. Reste le 29/07.
- [ ] Mouvements de la caméra (demande de l'utilisateur, 2026-10-26) : `pan`, `tilt`, `scale`, `rotation`, `sigma0` à la minute, médiane et bornes, par la lecture du visualiseur de la plateforme (`get_shifts_aggregate(..., "cam_movements_1min")`, comme `fetch_cam_movements_frame`), un CSV par jour dans `camera/` ; lus par `ensemble.py` et `inventaire.py`, pose lue en premier par le skill `lire-les-donnees` (2026-10-26, D-073). Essayé le 2026-10-26 sur le 30/07 de NORDEND (E-002) : 2 s, 70 lignes, une par mesure (toutes les 15 min, min = max) ; sur les 95 instants des déplacements, 70 ont une pose de la caméra (pan de −0,059 à −0,010, tilt de −0,089 à −0,020), dont 7 seulement un `sigma0`, les mêmes que l'export « advanced » ; les 25 autres, surtout de 15:15 à 22:45, n'ont ni pose ni `sigma0` : pas de recalage de la caméra. La pose existe donc là où l'export n'a pas de `sigma0`. Reste le 29/07.
- [x] Premier lancement par l'utilisateur, avec le point 27 (2026-10-26, les métriques identiques à l'export de la page System) ; comparer aussi une métrique pompée à un export reçu de la page System (WEISSHORN ou NORDEND, même plage).
- [x] `data/` hors de git, seule sortie du pompage (l'utilisateur, 2026-10-26, D-065) : `.gitignore`, `run.md`, `extraction/README.md`, `/aiguiser`, `/boucle` et `/nouveau-cas` sur `data/<SERIE>` ; plus de `out/pompage/`.
- [x] `data/` hors de git, seule sortie du pompage (l'utilisateur, 2026-10-26, D-065) : `.gitignore`, `run.md`, `extraction/README.md`, `/aiguiser`, `/boucle` et `/new-event` sur `data/<SERIE>` ; plus de `out/pompage/`.
- [ ] L'utilisateur vide `data/` et repompe les plages des exports reçus, élargies (commandes données le 2026-10-26) ; `out/pompage/NORDEND/` copié dans `data/NORDEND/` à la fin de la séance `/boucle` en cours ; numéro de série de PS des Coudres à trouver (URL de sa page System). Puis Claude vérifie : `inventaire.py`, `categories.py`, les scripts des domaines sur VERMONT, WEISSHORN et NORDEND.
**Fini quand.** Une commande donnée par Claude remplit `data/<STATION>/` sur la période choisie, et sa relance ne télécharge que ce qui manque.
@@ -910,7 +910,7 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
**Proposition de Claude, à discuter.**
1. Tout de suite : l'analyste écrit aussi ses labels dans un `etiquettes.csv` strict (début et fin ISO UTC, capteurs, clé de catégorie de `categories.py`) ; un script compare une version des détecteurs à toutes les étiquettes déjà écrites : le rejeu, écarté parce qu'il coûtait un regard de Claude, devient gratuit.
2. Quand il y aura assez d'étiquettes (quelques dizaines d'événements par catégorie, sur au moins 4 ou 5 stations) : un arbre de décision peu profond, entraîné sur le poste de dev, sur des grandeurs concrètes par cible et par mesure (`error_value` face à son niveau habituel, part des cibles rejetées au même instant, références touchées, saut de `corr` et retour, heure) ; validé en laissant une station de côté, testé sur C-001 à C-005 (labels de l'expert, jamais appris). Lisible (une suite de « si… alors »), embarquable (quelques `if` en bibliothèque standard).
2. Quand il y aura assez d'étiquettes (quelques dizaines d'événements par catégorie, sur au moins 4 ou 5 stations) : un arbre de décision peu profond, entraîné sur le poste de dev, sur des grandeurs concrètes par cible et par mesure (`error_value` face à son niveau habituel, part des cibles rejetées au même instant, références touchées, saut de `corr` et retour, heure) ; validé en laissant une station de côté, testé sur E-001 à E-005 (labels de l'expert, jamais appris). Lisible (une suite de « si… alors »), embarquable (quelques `if` en bibliothèque standard).
3. Son rôle : à côté des détecteurs, pas à leur place : ses désaccords avec eux choisissent les lots que regarde l'analyste (question ouverte de la boucle), ses coupures proposent des seuils à l'upgrader. « Shift to check » reste aux détecteurs : un vrai mouvement est trop rare pour être appris, et il n'est jamais invalidé.
**Réponse de l'utilisateur (2026-10-25).** Bonnes pistes ; pas de modèle tout de suite : d'abord faire tourner la boucle elle-même. Mais préparer le terrain : chaque lot traité doit laisser des labels, réutilisables plus tard (« super important »). Il regardera ensuite ce que Claude a labellisé : comment lui donner cette visibilité, on verra plus tard.
@@ -970,7 +970,7 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
**L'idée** (l'utilisateur, 2026-10-26). À la fin d'une séance de la boucle, une page : la plage en largeur avec les courbes, dessous la classification de l'agent et celle des scripts analytiques, pour voir le diagnostic de l'un et de l'autre sur la même plage. Séance après séance, sur des lots différents, la boucle doit faire coïncider les deux.
**Fait le 2026-10-26 (D-066).** `.claude/skills/boucle/comparaison.py <dossier> <séance>` écrit `out/boucle_<séance>.html`, ouverte en fin de séance (§7 du skill `boucle`) : `corr_x` et `corr_y` de tous les capteurs (gris, références plus foncées, nom au survol), une ligne par catégorie présente, la barre bleue de l'analyste au-dessus de la barre orange des détecteurs (survol : capteurs, preuve, description ou phrase) ; en bas, en gris, la ligne « hors catégorie » : les moments `aucune` de l'analyste, vus mais hors des catégories du journal, sans effet sur les courbes le plus souvent, ou une nouveauté (C-007 et C-008 en viennent) ; retirés un moment à la demande de l'utilisateur (« rien d'anormal »), remis en gris parce qu'ils ne disent pas « tout va bien » ; sous la figure, le score de la séance (`score.py` sur ses étiquettes). Zoom par sélection, pas à la molette (l'utilisateur). Vérifié par capture sur la séance `2026-10-26T1414Z_NORDEND` (01 → 04/09).
**Fait le 2026-10-26 (D-066).** `.claude/skills/boucle/comparaison.py <dossier> <séance>` écrit `out/boucle_<séance>.html`, ouverte en fin de séance (§7 du skill `boucle`) : `corr_x` et `corr_y` de tous les capteurs (gris, références plus foncées, nom au survol), une ligne par catégorie présente, la barre bleue de l'analyste au-dessus de la barre orange des détecteurs (survol : capteurs, preuve, description ou phrase) ; en bas, en gris, la ligne « hors catégorie » : les moments `aucune` de l'analyste, vus mais hors des catégories du journal, sans effet sur les courbes le plus souvent, ou une nouveauté (E-007 et E-008 en viennent) ; retirés un moment à la demande de l'utilisateur (« rien d'anormal »), remis en gris parce qu'ils ne disent pas « tout va bien » ; sous la figure, le score de la séance (`score.py` sur ses étiquettes). Zoom par sélection, pas à la molette (l'utilisateur). Vérifié par capture sur la séance `2026-10-26T1414Z_NORDEND` (01 → 04/09).
**Étapes.**
- [x] La page, branchée en fin de séance (2026-10-26).
@@ -995,33 +995,33 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
---
### Point 48 : Un benchmark des détecteurs sur la base de cas
### Point 48 : Un benchmark des détecteurs sur la base d'events
**L'idée** (l'utilisateur, 2026-10-26, après le relevé du releveur « premier lot sans lot d'avant, cas de réglage hors du score »). Une étape benchmark dans `/boucle` : lancer les détecteurs sur les cas de la base et mesurer leur correspondance avec le diagnostic de l'agent. Chaque cas garde le diagnostic fait à sa création, pour que le benchmark soit purement analytique ; versionné, le score quantifié à chaque passage ; les agents qui améliorent les détecteurs en tiennent compte.
**L'idée** (l'utilisateur, 2026-10-26, après le relevé du releveur « premier lot sans lot d'avant, cas de réglage hors du score »). Une étape benchmark dans `/boucle` : lancer les détecteurs sur les events de la base et mesurer leur correspondance avec le diagnostic de l'agent. Chaque event garde le diagnostic fait à sa création, pour que le benchmark soit purement analytique ; versionné, le score quantifié à chaque passage ; les agents qui améliorent les détecteurs en tiennent compte.
**Proposition de Claude (à valider).**
- **Le diagnostic d'un cas** : `etiquettes.json` dans son dossier, au format des étiquettes de l'analyste (D-061), noms codés (`"station": "C-xxx"`, capteurs `C1`, `R1`…), figé à la création comme le cas. Le benchmark est alors `score.py` lancé sur le dossier du cas avec ce fichier : rien à recoder. Essai du 2026-10-26, dans le scratchpad : les moments du lot 01 dans la fenêtre de C-006, recodés par le registre, donnent 6 moments, contrôle `etiquettes.py` « bon », et `score.py` tourne sans changement (`saut_bref` : 6 mesures trouvées sur 24, 6 justes sur 7).
- **Cas appris** : `anonymiser.py` recopie, avec une option, les moments de l'analyste du lot qui touchent la fenêtre du cas, bornés à la fenêtre et codés ; le builder s'en sert à la création.
- **Cas validés C-001 à C-005** (pas d'étiquettes) : un passage unique de l'analyste, étiquettes seules, puis figées ; l'utilisateur les relit sur une page de comparaison.
- **`benchmark.py`** (à côté de `score.py`) : le score sur chaque cas et au total, par catégorie ; une ligne par passage, cas et catégorie dans `vues-deplacements/benchmark/historique.csv` (date, séance, lot, étape, version des détecteurs `git rev-parse --short HEAD:detectors`, cas, catégorie, étiquetées, signalées, les deux) : la courbe du score dans le temps, version par version.
- **Dans `/boucle`** : au début de la séance (point de départ) ; après chaque modification, lancé par l'upgrader et lu par le validateur (un recul net est un défaut, une hausse un plus, pas un but : sur une dizaine de cas, les détecteurs se régleraient sur eux) ; après le builder, les nouveaux cas y entrent ; en fin de séance, au bilan et sur la page. Il remplace le contrôle « Cas de la base » par `categories.py`, ajouté le même jour.
- **Limite** : la fenêtre d'un cas appris est l'événement ± 6 h, sans les 3 jours d'historique d'un lot ; le benchmark mesure les détecteurs sur ce que le cas contient (piste : plus d'historique pour les mesures, les images restant à la fenêtre).
- **Le diagnostic d'un event** : `etiquettes.json` dans son dossier, au format des étiquettes de l'analyste (D-061), noms codés (`"station": "E-xxx"`, capteurs `C1`, `R1`…), figé à la création comme l'event. Le benchmark est alors `score.py` lancé sur le dossier de l'event avec ce fichier : rien à recoder. Essai du 2026-10-26, dans le scratchpad : les moments du lot 01 dans la fenêtre de E-006, recodés par le registre, donnent 6 moments, contrôle `etiquettes.py` « bon », et `score.py` tourne sans changement (`saut_bref` : 6 mesures trouvées sur 24, 6 justes sur 7).
- **Events appris** : `anonymiser.py` recopie, avec une option, les moments de l'analyste du lot qui touchent la fenêtre de l'event, bornés à la fenêtre et codés ; le builder s'en sert à la création.
- **Events validés E-001 à E-005** (pas d'étiquettes) : un passage unique de l'analyste, étiquettes seules, puis figées ; l'utilisateur les relit sur une page de comparaison.
- **`benchmark.py`** (à côté de `score.py`) : le score sur chaque event et au total, par catégorie ; une ligne par passage, cas et catégorie dans `vues-deplacements/benchmark/historique.csv` (date, séance, lot, étape, version des détecteurs `git rev-parse --short HEAD:detectors`, cas, catégorie, étiquetées, signalées, les deux) : la courbe du score dans le temps, version par version.
- **Dans `/boucle`** : au début de la séance (point de départ) ; après chaque modification, lancé par l'upgrader et lu par le validateur (un recul net est un défaut, une hausse un plus, pas un but : sur une dizaine d'events, les détecteurs se régleraient sur eux) ; après le builder, les nouveaux events y entrent ; en fin de séance, au bilan et sur la page. Il remplace le contrôle « Cas de la base » par `categories.py`, ajouté le même jour.
- **Limite** : la fenêtre d'un event appris est l'événement ± 6 h, sans les 3 jours d'historique d'un lot ; le benchmark mesure les détecteurs sur ce que l'event contient (piste : plus d'historique pour les mesures, les images restant à la fenêtre).
**Questions à l'utilisateur.**
1. Le « diagnostic de l'agent » d'un cas : les étiquettes de l'analyste (mesurables), pas le rapport de l'agent de diagnostic (D-046, du texte) ?
2. C-001 à C-005 : un passage unique de l'analyste, que l'utilisateur relit ?
1. Le « diagnostic de l'agent » d'un event : les étiquettes de l'analyste (mesurables), pas le rapport de l'agent de diagnostic (D-046, du texte) ?
2. E-001 à E-005 : un passage unique de l'analyste, que l'utilisateur relit ?
3. Le benchmark : garde-fou et bonus pour l'upgrader, pas un but à atteindre ?
**Réponses de l'utilisateur (2026-10-26).** Oui aux trois : « les étiquettes sont faites pour ça » ; passage unique de l'analyste sur C-001 à C-005, qu'il relira ; le benchmark en garde-fou et bonus.
**Réponses de l'utilisateur (2026-10-26).** Oui aux trois : « les étiquettes sont faites pour ça » ; passage unique de l'analyste sur E-001 à E-005, qu'il relira ; le benchmark en garde-fou et bonus.
**Fait le 2026-10-26 (D-069).** `anonymiser.py --etiquettes` (et son test) ; étiquettes de C-006 à C-008 recopiées du lot 01 de la séance de NORDEND, codées ; celles de C-001 à C-005 par cinq analystes en parallèle, lecture propre puis correction par la fiche (`events/C-00x/etiquetage.md`) ; `.claude/skills/boucle/benchmark.py` et `vues-deplacements/benchmark/historique.csv` ; branchement dans `/boucle` (orchestrateur aux trois moments, upgrader, validateur, builder, bilan, page de fin de séance), dans `/nouveau-cas` et la spec de l'agent de diagnostic (§11.1) ; le contrôle « Cas de la base » par `categories.py` est remplacé.
**Fait le 2026-10-26 (D-069).** `anonymiser.py --etiquettes` (et son test) ; étiquettes de E-006 à E-008 recopiées du lot 01 de la séance de NORDEND, codées ; celles de E-001 à E-005 par cinq analystes en parallèle, lecture propre puis correction par la fiche (`events/E-00x/etiquetage.md`) ; `.claude/skills/boucle/benchmark.py` et `vues-deplacements/benchmark/historique.csv` ; branchement dans `/boucle` (orchestrateur aux trois moments, upgrader, validateur, builder, bilan, page de fin de séance), dans `/new-event` et la spec de l'agent de diagnostic (§11.1) ; le contrôle « Cas de la base » par `categories.py` est remplacé.
**Étapes.**
- [x] Les réponses de l'utilisateur.
- [x] Étiquettes des cas, `benchmark.py` et son historique, branchement dans `/boucle` (2026-10-26).
- [ ] L'utilisateur relit les étiquettes de C-001 à C-005.
- [x] Étiquettes des events, `benchmark.py` et son historique, branchement dans `/boucle` (2026-10-26).
- [ ] L'utilisateur relit les étiquettes de E-001 à E-005.
**Fini quand.** Chaque modification des détecteurs a un score sur toute la base de cas, gardé dans l'historique avec la version des détecteurs.
**Fini quand.** Chaque modification des détecteurs a un score sur toute la base d'events, gardé dans l'historique avec la version des détecteurs.
---
@@ -1067,20 +1067,20 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
**L'idée** (l'utilisateur, 2026-10-28). L'analyste de `/boucle` doit devenir plus performant au fil des séances ; ce n'est pas le cas aujourd'hui. Plus il est fin, meilleure est sa lecture, donc sa critique.
**Constat (Claude).**
- L'analyste est le plafond de la boucle : ses étiquettes sont la vérité du score (D-062) et ses nouveautés deviennent les cas appris (builder). S'il stagne, les détecteurs convergent vers ses erreurs.
- Le modèle est déjà celui de la session (D-063) ; ce qui peut progresser, c'est ce qu'il sait. Sa **lecture** progresse déjà par `/aiguiser` (outils et `lire-les-donnees`). Son **jugement** (à quoi ressemble un train, une buée, une cible défaillante) ne progresse pas : il ne lit la base de cas qu'à l'étape 4 de `critiquer-lot`, après ses étiquettes, au plus 3 fiches ; ce qu'apprend la base n'atteint jamais ses étiquettes.
- Risque : l'auto-renforcement. Les cas « (appris) » sont ses propres conclusions, non validées ; les lire avant d'étiqueter graverait ses erreurs. Seul ce que l'expert a validé ou corrigé doit lui apprendre.
- L'analyste est le plafond de la boucle : ses étiquettes sont la vérité du score (D-062) et ses nouveautés deviennent les events appris (builder). S'il stagne, les détecteurs convergent vers ses erreurs.
- Le modèle est déjà celui de la session (D-063) ; ce qui peut progresser, c'est ce qu'il sait. Sa **lecture** progresse déjà par `/aiguiser` (outils et `lire-les-donnees`). Son **jugement** (à quoi ressemble un train, une buée, une cible défaillante) ne progresse pas : il ne lit la base d'events qu'à l'étape 4 de `critiquer-lot`, après ses étiquettes, au plus 3 fiches ; ce qu'apprend la base n'atteint jamais ses étiquettes.
- Risque : l'auto-renforcement. Les events « (appris) » sont ses propres conclusions, non validées ; les lire avant d'étiqueter graverait ses erreurs. Seul ce que l'expert a validé ou corrigé doit lui apprendre.
**Proposition de Claude (à valider).**
- **Sa mémoire = la carte des événements**, qu'il lit déjà avant l'étape 1 : quand l'utilisateur valide ou corrige un cas par `/revue-cas`, la signature du cas entre dans la carte, sous l'éventualité qui le fait, avec son lien ; une correction (« ce n'était pas X mais Y ») y devient une mise en garde. Les cas validés C-001 à C-005 y entrent de même. Rien des cas non revus.
- **Sa mémoire = la carte des événements**, qu'il lit déjà avant l'étape 1 : quand l'utilisateur valide ou corrige un event par `/review-event`, la signature de l'event entre dans la carte, sous l'éventualité qui le fait, avec son lien ; une correction (« ce n'était pas X mais Y ») y devient une mise en garde. Les events validés E-001 à E-005 y entrent de même. Rien des events non revus.
- Pas de fiches lues avant les étiquettes (coût, et conclusions possibles sur les données mêmes du lot).
- **Mesurer** : sans mesure, on ne saura pas s'il progresse. Les étiquettes figées des cas validés (D-069), relues par l'utilisateur, servent de corrigé : de temps en temps, l'analyste étiquette un cas validé sans sa fiche, `score.py` le compare. Une lecture coûte environ 250 000 jetons (D-059) : pas à chaque séance, et un ou deux cas témoins restent hors de la carte, sinon la mesure triche.
- **Mesurer** : sans mesure, on ne saura pas s'il progresse. Les étiquettes figées des events validés (D-069), relues par l'utilisateur, servent de corrigé : de temps en temps, l'analyste étiquette un event validé sans sa fiche, `score.py` le compare. Une lecture coûte environ 250 000 jetons (D-059) : pas à chaque séance, et un ou deux events témoins restent hors de la carte, sinon la mesure triche.
**Questions à l'utilisateur.**
1. La carte comme mémoire de l'analyste, nourrie par `/revue-cas` seule ?
2. La mesure de l'analyste sur des cas témoins : la vouloir, et à quel rythme ?
1. La carte comme mémoire de l'analyste, nourrie par `/review-event` seule ?
2. La mesure de l'analyste sur des events témoins : la vouloir, et à quel rythme ?
**Contre-proposition de l'utilisateur (2026-10-28).** Que l'analyste regarde directement les cas qu'il a validés. Avis de Claude : oui, c'est plus simple que la carte, puisqu'il n'y a rien à recopier ni d'étape à ajouter à `/revue-cas`. Les cas validés sont ceux dont le Verdict, dans l'index, ne porte pas « (appris) » (C-001 à C-011 aujourd'hui, environ 40 lignes chacun) : avant l'étape 1, il lit l'index et ces fiches, leurs figures au besoin ; les cas « (appris) » restent à l'étape 4. Limites : la lecture grossit avec la base (passer à l'index seul, puis aux fiches proches, quand ce sera trop) ; un lot qui recouvre un cas validé y lit la réponse de l'expert (sans mal pour les étiquettes, mais ce cas ne mesure plus l'analyste) ; les cas témoins de la mesure restent hors de sa lecture.
**Contre-proposition de l'utilisateur (2026-10-28).** Que l'analyste regarde directement les events qu'il a validés. Avis de Claude : oui, c'est plus simple que la carte, puisqu'il n'y a rien à recopier ni d'étape à ajouter à `/review-event`. Les events validés sont ceux dont le Verdict, dans l'index, ne porte pas « (appris) » (E-001 à E-011 aujourd'hui, environ 40 lignes chacun) : avant l'étape 1, il lit l'index et ces fiches, leurs figures au besoin ; les events « (appris) » restent à l'étape 4. Limites : la lecture grossit avec la base (passer à l'index seul, puis aux fiches proches, quand ce sera trop) ; un lot qui recouvre un event validé y lit la réponse de l'expert (sans mal pour les étiquettes, mais cet event ne mesure plus l'analyste) ; les events témoins de la mesure restent hors de sa lecture.
**Étapes.**
- [ ] Les réponses de l'utilisateur.
@@ -1102,10 +1102,10 @@ La carte, section 3 : la cause d'une perte de visibilité (pluie, brume, buée,
- [ ] Demander à l'utilisateur si une source météo est disponible (station, service) ; si oui, une catégorie peut nommer sa cause sans image.
- [ ] Demander un export HDF5 d'une station pour voir ce qu'il apporte.
### Point 35 : Un cas de la base par catégorie
### Point 35 : Un event de la base par catégorie
Neige, dérive lente, cible qui saute seule et voisin brillant n'ont aucun cas validé.
- [ ] Quand l'utilisateur apporte des données qui en montrent un, et le demande : `/nouveau-cas`.
Neige, dérive lente, cible qui saute seule et voisin brillant n'ont aucun event validé.
- [ ] Quand l'utilisateur apporte des données qui en montrent un, et le demande : `/new-event`.
### Point 36 : Porter le journal dans la vraie application
@@ -1118,13 +1118,13 @@ Comme pour les statuts des métriques système (Energy, Storage, Cellular, Tempe
### Point 49 : Le graphe des éventualités du terrain et deux catégories nouvelles
Demande de l'utilisateur (2026-10-27) : un graphe simple, sans le détail des données, de ce qui peut arriver sur le terrain vers les catégories du journal ; une éventualité peut en donner plusieurs (la neige sur les cibles : visibilité réduite ou nulle, ou cible masquée). Fait dans `events/eventualites-et-categories.drawio`, en tête de la carte des événements, à la place de l'arbre Mermaid. Les étiquettes de l'analyste (boucles et cas C-001 à C-011) en font sortir une catégorie qui manque : les cibles mal vues ou mal suivies durablement (C-008 à C-011, cibles toujours rejetées), qu'il range aujourd'hui hors catégorie ou à vérifier.
Demande de l'utilisateur (2026-10-27) : un graphe simple, sans le détail des données, de ce qui peut arriver sur le terrain vers les catégories du journal ; une éventualité peut en donner plusieurs (la neige sur les cibles : visibilité réduite ou nulle, ou cible masquée). Fait dans `events/eventualites-et-categories.drawio`, en tête de la carte des événements, à la place de l'arbre Mermaid. Les étiquettes de l'analyste (boucles et cas E-001 à E-011) en font sortir une catégorie qui manque : les cibles mal vues ou mal suivies durablement (E-008 à E-011, cibles toujours rejetées), qu'il range aujourd'hui hors catégorie ou à vérifier.
- [x] Le graphe : 23 éventualités en cinq familles, 11 catégories, la vérification d'un `À vérifier` ou d'une dérive lente vers « Cible déplacée ».
- [ ] L'utilisateur relit les liens du graphe dans draw.io.
- [x] Les catégories, définies par l'utilisateur le 2026-10-27 (D-074) : tout ce qui reste inexpliqué dans **À vérifier** (sous-groupes : saut qui dure, gros saut, dérive lente), pour ne pas alarmer le client ; **Cible défaillante** gardée (cible constamment problématique : mal orientée, mal installée, dégradée) ; effet thermique, passage, pas de données, saut bref et turbulences atmosphériques redéfinis ; graphe refait.
- [x] Le véhicule qui fait vibrer l'ouvrage ou la caméra (caméra sur un pont) va dans **Saut bref** (l'utilisateur, 2026-10-27).
- [x] Reporter les définitions dans la carte (section 4, d'où l'analyste tire son vocabulaire), le skill `critiquer-lot` (« aucune » seulement sans effet sur les courbes ; l'inexpliqué en `a_verifier`), `categories.py` et les détecteurs (demande de l'utilisateur, 2026-10-27 : au moins un détecteur par catégorie, pour les entraîner dans `/boucle`). Fait le 2026-10-27, les clés des catégories gardées (les étiquettes déjà écrites restent valides) : `derive.py` (dérive lente, nouveau, sur `corr` de l'export « advanced » ; la maquette ne la prend plus des tendances horaires) ; `degradee` « Target stuck » (cible collée, C-011) ; `sauts` « Target flipping » (cible qui bascule des heures, presque seule : Cible défaillante) et « Large shift » (gros saut, sous « À vérifier ») ; `thermique` « Camera thermal … » (cycle des positions brutes quand `corr` n'en a pas). Benchmark (étiquettes des cas, écrites avant D-074) : `toutes` 51 % trouvées, 49 → 47 % confirmées ; les écarts viennent des nouvelles définitions (bascules de C-009 en cible défaillante, caméra des C-003 et C-008 en effet thermique, que l'analyste avait mises en saut bref ou hors catégorie).
- [ ] L'utilisateur lance `/boucle` sur de nouvelles données pour entraîner les détecteurs sur les nouvelles définitions ; décider s'il faut relire les étiquettes des cas C-001 à C-011 avec D-074.
- [x] Reporter les définitions dans la carte (section 4, d'où l'analyste tire son vocabulaire), le skill `critiquer-lot` (« aucune » seulement sans effet sur les courbes ; l'inexpliqué en `a_verifier`), `categories.py` et les détecteurs (demande de l'utilisateur, 2026-10-27 : au moins un détecteur par catégorie, pour les entraîner dans `/boucle`). Fait le 2026-10-27, les clés des catégories gardées (les étiquettes déjà écrites restent valides) : `derive.py` (dérive lente, nouveau, sur `corr` de l'export « advanced » ; la maquette ne la prend plus des tendances horaires) ; `degradee` « Target stuck » (cible collée, E-011) ; `sauts` « Target flipping » (cible qui bascule des heures, presque seule : Cible défaillante) et « Large shift » (gros saut, sous « À vérifier ») ; `thermique` « Camera thermal … » (cycle des positions brutes quand `corr` n'en a pas). Benchmark (étiquettes des events, écrites avant D-074) : `toutes` 51 % trouvées, 49 → 47 % confirmées ; les écarts viennent des nouvelles définitions (bascules de E-009 en cible défaillante, caméra des E-003 et E-008 en effet thermique, que l'analyste avait mises en saut bref ou hors catégorie).
- [ ] L'utilisateur lance `/boucle` sur de nouvelles données pour entraîner les détecteurs sur les nouvelles définitions ; décider s'il faut relire les étiquettes des events E-001 à E-011 avec D-074.
---
@@ -1144,8 +1144,8 @@ Demande de l'utilisateur (2026-10-27) : un graphe simple, sans le détail des do
Huit agents, un par piste, lancés par l'orchestrateur ; tous ont rendu leur travail. Rien n'a été commité.
1. **Page Journal** : onglet construit (`explore.py`, `explore_template.html`, `spec.md`), plus `trous.py` ; captures de NORDEND d'octobre et de NIEDERHORN ; corrections en route : barres en `overlay`, libellés dans les barres, épisodes sans durée dessinés sur 1 h, « 12:00 – 12:00 » devient « 12:00 ». Défaut signalé, corrigé ensuite par l'orchestrateur : le « Lasting shift » couvrait toute la ligne Jumps.
2. **Visibilité** (`visibilite.py`) : critère relatif au capteur et non au seuil (la buée de C-001 reste sous le seuil) ; résultats au point 11 ; C-003 laissé au détecteur turbulence (`error_value`×1,5 à ×3 seulement), les deux détecteurs se complètent par le taux de rejet.
3. **Sauts** (`sauts.py`) : résultats au point 12 ; ajout d'une troisième étiquette « Jump, not back yet » (moins d'un jour de recul : le cas courant d'un journal du matin) ; aucun seuil ne sépare les trains de NIEDERHORN des cibles saines de PS des Coudres.
2. **Visibilité** (`visibilite.py`) : critère relatif au capteur et non au seuil (la buée de E-001 reste sous le seuil) ; résultats au point 11 ; E-003 laissé au détecteur turbulence (`error_value`×1,5 à ×3 seulement), les deux détecteurs se complètent par le taux de rejet.
3. **Sauts** (`sauts.py`) : résultats au point 12 ; ajout d'une troisième étiquette « Jump, not back yet » (moins d'un jour de recul : l'event courant d'un journal du matin) ; aucun seuil ne sépare les trains de NIEDERHORN des cibles saines de PS des Coudres.
4. **Cycle thermique** (`thermique.py`) : découverte au point 13 : le cycle est dans les positions brutes, la compensation l'enlève, sauf à PS des Coudres.
5. **Turbulence** (`turbulence.py`) : résultats au point 14 ; c'est l'`error_value` qui sépare la turbulence des midis agités ; marge faible sur le matin du mouvement de CLARIDEN.
6. **Cartographe** (`carte-des-evenements.md`) : point 3.
@@ -1162,7 +1162,7 @@ Depuis `/home/maxime/Support-Agent`.
- **Construire et ouvrir** : `python3 vues-deplacements/maquette/explore.py [dossier]` (défaut : le cas NORDEND d'octobre ; s'ouvre sur l'onglet View).
- **Ouvrir sur l'onglet Journal** : `"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe" "file://///wsl.localhost/Ubuntu/home/maxime/Support-Agent/out/vues_deplacements_<STATION>.html#tab=journal"` (en arrière-plan : la commande ne rend la main qu'à la fermeture si Chrome n'était pas ouvert).
- **Capturer** : `"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe" --headless=new --disable-gpu --hide-scrollbars --window-size=1600,1300 --virtual-time-budget=10000 --screenshot="$(wslpath -w <png>)" "file:///$(wslpath -w out/vues_deplacements_<STATION>.html | sed 's#\\#/#g')#tab=journal"` ; PNG dans le dossier temporaire de la session, jamais dans un dossier de station.
- **Jeux** : `vues-deplacements/cas/2026-10_NORDEND/NORDEND` (11 jours, 15 min, 985 images), `data/PS_DES_COUDRES` (C-001), `data/NORDEND` (C-002), `data/WILDSTRUBEL` (C-003), `data/CLARIDEN` (C-004), `data/NIEDERHORN` (C-005). Le cas NORDEND écrit `out/vues_deplacements_2026-10_NORDEND.html`, `data/NORDEND` écrit `out/vues_deplacements_NORDEND.html` (point 37).
- **Jeux** : `vues-deplacements/cas/2026-10_NORDEND/NORDEND` (11 jours, 15 min, 985 images), `data/PS_DES_COUDRES` (E-001), `data/NORDEND` (E-002), `data/WILDSTRUBEL` (E-003), `data/CLARIDEN` (E-004), `data/NIEDERHORN` (E-005). Le cas NORDEND écrit `out/vues_deplacements_2026-10_NORDEND.html`, `data/NORDEND` écrit `out/vues_deplacements_NORDEND.html` (point 37).
- **Pompage** (utilisateur, dans le container) : `extraction/README.md`.
## Journal du plan
@@ -1176,10 +1176,10 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
- 2026-10-24 : **point 1 validé** par l'utilisateur après NORDEND d'octobre (« rien à ajouter ») et PS des Coudres (« tu peux considérer comme validés tous ces jeux de données ») ; défaut vu sur PS des Coudres (3 cibles sur 11 dans les courbes) : point 39, nouveau, partie IV. Point 2 commencé.
- 2026-10-24 : **point 2 validé** par l'utilisateur (sortie des cinq détecteurs sur leur cas, défaut connu et point de la partie III pour chacun). Point 3 commencé.
- 2026-10-24 : point 3 : arbre Mermaid rendu sans erreur ; consigne de l'utilisateur : la carte recense tout ce qui peut arriver, vu ou non, en familles (précision de D-056) ; carte complétée : 33 événements en six familles. Reste : validation de la carte par l'utilisateur, question des trains.
- 2026-10-24 : **point 3 validé** par l'utilisateur : la carte complétée (33 événements, six familles) est validée comme base, à compléter au fil des cas ; les trains de C-005 restent à classer au point 5. Point 4 commencé.
- 2026-10-24 : **point 3 validé** par l'utilisateur : la carte complétée (33 événements, six familles) est validée comme base, à compléter au fil des events ; les trains de E-005 restent à classer au point 5. Point 4 commencé.
- 2026-10-24 : point 4 : brainstorming relu section par section ; précision de l'utilisateur : une anomalie est tout ce qui sort de la norme (courbes pas plates), presque toujours sans gravité, parfois grave (Barcelone, voûte du pont qui s'affaisse) ; reportée dans D-056, `CLAUDE.md`, le brainstorming, la carte et `incident-de-barcelone.md`. Reste : la validation du point 4.
- 2026-10-24 : **point 4 validé** par l'utilisateur. Point 5 commencé.
- 2026-10-24 : **point 5 validé** par l'utilisateur : huit catégories, règles et sept recommandations telles quelles ; écrites dans la carte (section 4, lignes « No data » et cycle thermique retouchées) et sous D-056 ; attendu de C-002 au point 10 mis à jour. Prochain : point 6, le classement.
- 2026-10-24 : **point 5 validé** par l'utilisateur : huit catégories, règles et sept recommandations telles quelles ; écrites dans la carte (section 4, lignes « No data » et cycle thermique retouchées) et sous D-056 ; attendu de E-002 au point 10 mis à jour. Prochain : point 6, le classement.
- 2026-10-24 : point 6 fait : `detectors/categories.py` (catégories, absorption, fusion), page branchée sur les événements (frise par catégorie) ; contrôles NORDEND et CLARIDEN passés ; écarts à l'interface notés au point 6 ; reste la validation de l'utilisateur.
- 2026-10-24 : **point 6 validé** par l'utilisateur. Point 7 commencé.
- 2026-10-24 : point 7 fait : bouton `▶ Images` et timelapse dans la page (marge de 1 à 6 h, 4 images par seconde, bord rouge pendant l'événement) ; contrôles NORDEND (14/10) et PS des Coudres (nuit du 13/10 sans image) passés ; reste le réglage à l'œil et la validation de l'utilisateur.
@@ -1238,8 +1238,8 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
- 2026-10-24 : point 37 fait : `CLAUDE.md` à 199 lignes et à jour, sorties NORDEND séparées, Mermaid déjà rendu au point 3, travail commité ; reste la validation.
- 2026-10-24 : **point 37 validé** par l'utilisateur. Il ne reste que des points en attente : pompage (27 à 29, accès aux données), boucle Claude et test « Claude verrait la même chose » (31, 32, autres conversations), idées pour plus tard (33 à 36).
- 2026-10-24 : point 31 : consignes de l'utilisateur reçues (boucle automatique : analyste, upgrader, validateur, builder) et notées au point 31 ; brainstorming en cours, rien construit.
- 2026-10-24 : point 31 : réponses de l'utilisateur (tout commité, cas ajoutés sans attendre, pas de rejeu, crainte de la complexité) ; conception écrite dans `vues-deplacements/contexte/boucle-automatique.md`, à approuver.
- 2026-10-24 : point 31 : conception approuvée par l'utilisateur (agent de diagnostic hors de la boucle, cas appris dans la base commune) ; plan de construction écrit, `docs/superpowers/plans/2026-10-24-boucle-automatique.md`.
- 2026-10-24 : point 31 : réponses de l'utilisateur (tout commité, events ajoutés sans attendre, pas de rejeu, crainte de la complexité) ; conception écrite dans `vues-deplacements/contexte/boucle-automatique.md`, à approuver.
- 2026-10-24 : point 31 : conception approuvée par l'utilisateur (agent de diagnostic hors de la boucle, events appris dans la base commune) ; plan de construction écrit, `docs/superpowers/plans/2026-10-24-boucle-automatique.md`.
- 2026-10-24 : point 31 : boucle construite (tâches 1 à 6 du plan `2026-10-24-boucle-automatique.md`, D-057) ; reste la première séance sur NORDEND d'octobre, lancée par l'utilisateur.
- 2026-10-24 : point 31 : essai de l'analyste sur le lot 1 de NORDEND ; **fonctionnement de la boucle validé** par l'utilisateur ; il lancera lui-même les séances, lot par lot, sur de nouvelles données ; travail commité.
- 2026-10-24 : point 42 ajouté (aiguiser la lecture : un skill de lecture, un lecteur, un correcteur qui lit à fond sans les outils, un optimiseur) ; conception écrite dans `vues-deplacements/contexte/aiguiser-la-lecture.md`, à approuver.
@@ -1251,22 +1251,22 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
- 2026-10-25 : point 44 : l'utilisateur garde les labels d'abord, pas de modèle tout de suite ; étiquettes écrites par l'analyste à chaque lot (`etiquettes.json`, contrôle `critiquer-lot/etiquettes.py`, D-061) ; reste la première séance et la visibilité de l'utilisateur sur les labels.
- 2026-10-25 : point 45 ajouté (précision de l'utilisateur : la boucle sert la détection sur tout le lot, chaque instant valide ou non avec sa catégorie) ; écarts constatés (validité implicite, précision non mesurée, pas de rejeu) ; proposition d'un score, trois questions à l'utilisateur ; rien codé.
- 2026-10-25 : point 45 : l'utilisateur laisse Claude choisir ; score codé (`.claude/skills/boucle/score.py`, D-062 : trois niveaux, par mesure, par capteur), branché sur l'orchestrateur, l'upgrader et le validateur ; consigne des sauts dans les étiquettes ; à juger à la première séance.
- 2026-10-26 : points 27, 28 et 43 : premier pompage par l'utilisateur (NORDEND, 29 et 30/07) : métriques, déplacements du 29/07 et images identiques aux exports reçus ; déplacements du 30/07 en échec (`DatabaseError`), cause affichée à la relance ; images différentielles : traînées claires pendant C-002, à confirmer ; mode d'emploi simplifié (le container monte `~` : sortie directe dans `data/`, ou `out/pompage/` pour une station déjà reçue).
- 2026-10-26 : points 27, 28 et 43 : premier pompage par l'utilisateur (NORDEND, 29 et 30/07) : métriques, déplacements du 29/07 et images identiques aux exports reçus ; déplacements du 30/07 en échec (`DatabaseError`), cause affichée à la relance ; images différentielles : traînées claires pendant E-002, à confirmer ; mode d'emploi simplifié (le container monte `~` : sortie directe dans `data/`, ou `out/pompage/` pour une station déjà reçue).
- 2026-10-26 : point 27 fait, à valider : le 30/07, en échec par délai dépassé (60 s) alors qu'il n'est pas plus lourd que le 29/07, relancé avec la nouvelle option `--delai 300` (93 s) : identique à l'export reçu ; `categories.py` donne les mêmes événements sur le dossier pompé que sur l'export reçu aux mêmes jours ; pomper 3 jours d'historique en plus.
- 2026-10-26 : point 43 : mouvements de la caméra ajoutés au pompage (demande de l'utilisateur) : `camera/`, un CSV par jour, une ligne par mesure ; essayé sur le 30/07 de NORDEND (70 poses sur 95 instants, `sigma0` sur 7 seulement, comme l'export).
- 2026-10-26 : point 31 : préparer la séance sur NORDEND de septembre (idée de l'utilisateur) : aucun lot à créer, `/boucle` les découpe ; restent l'historique (29 au 31/08), les images, garder `out/pompage/NORDEND/`, choisir les lots sur le tri gratuit du mois.
- 2026-10-26 : point 42 : l'utilisateur fait passer `/aiguiser` avant `/boucle`, sur NORDEND du 01 au 04/09 (données nombreuses) ; constats des outils actuels sur ces jours (graphique illisible à 22 capteurs, inventaire de 880 lignes sur un dossier pompé) ; séance à lancer par l'utilisateur quand les images seront là.
- 2026-10-26 : point 28 : sens des images DIFF et IRON lu dans le manuel de la station (DIFF : les réflecteurs, contraste renforcé, l'image mesurée ; IRON : la scène), noté dans `docs/domaine/images-de-la-camera.md` ; l'utilisateur les juge peu utiles pour `/boucle` et `/aiguiser` : `--diff` sorti de la commande de `run.md`, gardé en option.
- 2026-10-26 : point 43 : `data/` sort de git et devient la seule sortie du pompage (demande de l'utilisateur, D-065) ; `/aiguiser`, `/boucle`, `/nouveau-cas` branchés dessus ; les exports reçus à la main seront retirés et leurs plages repompées, élargies (commandes données à l'utilisateur).
- 2026-10-26 : point 31 : une séance de la boucle lancée à la demande de l'utilisateur (NORDEND, 01 → 04/09, un lot, dossier `out/pompage/NORDEND`) : 23 étiquettes, modification gardée (`saut_bref` de 0 à 7 mesures trouvées sur 24, faux passage retiré), cas C-006 à C-008 appris ; bilan `boucle/2026-10-26T1414Z_NORDEND/bilan.md`, sur la branche `boucle/2026-10-26T1414Z_NORDEND`.
- 2026-10-26 : point 43 : `data/` sort de git et devient la seule sortie du pompage (demande de l'utilisateur, D-065) ; `/aiguiser`, `/boucle`, `/new-event` branchés dessus ; les exports reçus à la main seront retirés et leurs plages repompées, élargies (commandes données à l'utilisateur).
- 2026-10-26 : point 31 : une séance de la boucle lancée à la demande de l'utilisateur (NORDEND, 01 → 04/09, un lot, dossier `out/pompage/NORDEND`) : 23 étiquettes, modification gardée (`saut_bref` de 0 à 7 mesures trouvées sur 24, faux passage retiré), cas E-006 à E-008 appris ; bilan `boucle/2026-10-26T1414Z_NORDEND/bilan.md`, sur la branche `boucle/2026-10-26T1414Z_NORDEND`.
- 2026-10-26 : point 46 ajouté et codé (idée de l'utilisateur : la page de fin de séance, l'analyste face aux détecteurs, D-066).
- 2026-10-26 : dossier des détecteurs renommé `detectors/` (demande de l'utilisateur, D-067).
- 2026-10-26 : point 47 ajouté (l'utilisateur : les détecteurs doivent tout détecter, l'affichage au client est une autre question, D-068) ; règle posée dans les consignes de la boucle ; page de fin de séance : score en tableau lisible.
- 2026-10-26 : point 31 : relevés du releveur sur la séance de NORDEND traités (13 entrées de `docs/ameliorations-processus.md`) : arguments de `/boucle` (nom de station, `--au` exclu), autre session dans le dépôt, nom de branche de la spec, cas de la base relancés par l'upgrader à chaque modification, détecteur imprimé par `categories.py`, en-tête des fiches apprises, `anonymiser.py` (`camera/`, plus de CSV vides), `ensemble.py` (pas calés sur l'horloge, titre) et `plages.py` (fusion du même sens) ; les 59 commandes des fiches passent.
- 2026-10-26 : point 48 ajouté (idée de l'utilisateur : un benchmark des détecteurs sur la base de cas, versionné, pris en compte par l'upgrader) ; proposition de Claude (étiquettes figées dans chaque cas, `score.py` réutilisé, historique CSV), essai sur C-006 ; trois questions à l'utilisateur ; rien construit.
- 2026-10-26 : point 48 : l'utilisateur dit oui aux trois choix ; benchmark construit (D-069) : étiquettes dans chaque cas, `benchmark.py`, historique, branché dans `/boucle` et `/nouveau-cas` ; reste la relecture des étiquettes de C-001 à C-005 par l'utilisateur.
- 2026-10-26 : point 48 ajouté (idée de l'utilisateur : un benchmark des détecteurs sur la base d'events, versionné, pris en compte par l'upgrader) ; proposition de Claude (étiquettes figées dans chaque event, `score.py` réutilisé, historique CSV), essai sur E-006 ; trois questions à l'utilisateur ; rien construit.
- 2026-10-26 : point 48 : l'utilisateur dit oui aux trois choix ; benchmark construit (D-069) : étiquettes dans chaque event, `benchmark.py`, historique, branché dans `/boucle` et `/new-event` ; reste la relecture des étiquettes de E-001 à E-005 par l'utilisateur.
- 2026-10-26 : point 43 : métriques système dans `data/<SERIE>/metrics/` (demande de l'utilisateur) ; `pomper.py` y écrit, `load_stations` y lit aussi ; fichiers de CLARIDEN et NIEDERHORN déplacés.
- 2026-10-26 : point 48 : tout au même endroit (l'utilisateur) : le rendu d'étiquetage de chaque cas devient `etiquetage.md` dans son dossier (C-001 à C-005 déplacés, C-006 à C-008 écrits par `anonymiser.py`, qui l'écrit désormais avec `--etiquettes`) ; `vues-deplacements/benchmark/` ne garde que l'historique.
- 2026-10-26 : point 48 : tout au même endroit (l'utilisateur) : le rendu d'étiquetage de chaque event devient `etiquetage.md` dans son dossier (E-001 à E-005 déplacés, E-006 à E-008 écrits par `anonymiser.py`, qui l'écrit désormais avec `--etiquettes`) ; `vues-deplacements/benchmark/` ne garde que l'historique.
- 2026-10-26 : point 31 : `/boucle` commite directement sur `master` (demande de l'utilisateur, D-070) ; branches des séances NORDEND et CLARIDEN fusionnées dans `master` et supprimées.
- 2026-10-26 : point 31 : `/boucle --ameliorer` (demande de l'utilisateur, D-071) : après le releveur, l'agent `ameliorateur` corrige le skill et ses agents d'après les entrées de la séance ; sans séance d'essai.
- 2026-10-26 : point 43 : la pose de la caméra entre dans la lecture (demande de l'utilisateur, D-073) : `charger_camera` dans `donnees.py`, panneaux et colonnes `cam_` dans `ensemble.py`, instants sans recalage dans `inventaire.py`, pose lue en premier par `lire-les-donnees`.
@@ -1286,7 +1286,7 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
- 2026-10-27 : page des détecteurs, validé par l'utilisateur : Details en deux colonnes, les événements du bloc à gauche, son timelapse à droite, lancé au clic sur le bloc (plus de bouton ▶ Images).
- 2026-10-27 : page des détecteurs, validé par l'utilisateur : dans le timelapse, les capteurs de l'événement entourés à leur position médiane (jaune les cibles, bleu les références) ; positions vérifiées sur WILDSTRUBEL et FLORIDA ; aucune marque sur LENZSPITZE, dont x et y ne sont pas des positions.
- 2026-10-27 : LENZSPITZE laissé de côté (l'utilisateur) : ses données sont différentes, x et y y sont des écarts de moins d'un pixel, pas des positions ; pas de cercles possibles ; le pompage n'est pas modifié.
- 2026-10-27 : page des détecteurs, validé par l'utilisateur (2026-10-28) : bouton ⤓ GIF dans le timelapse, le GIF tel qu'il est montré (Focused ou Global, 1000 px de large au plus, bord rouge pendant, heure en bas) dans les téléchargements du navigateur ; en file:// le navigateur ne lit pas les pixels des images : la page (comme celles de fin de séance et de /revue-cas) s'ouvre par un serveur local, http://127.0.0.1:8765, lancé en tâche de fond au besoin, qui ne sert que out/ et data/ (`open_served`, `src/common/page.py`). Sur LENZSPITZE, ni Focused ni étiquettes : x et y n'y sont pas des positions.
- 2026-10-27 : page des détecteurs, validé par l'utilisateur (2026-10-28) : bouton ⤓ GIF dans le timelapse, le GIF tel qu'il est montré (Focused ou Global, 1000 px de large au plus, bord rouge pendant, heure en bas) dans les téléchargements du navigateur ; en file:// le navigateur ne lit pas les pixels des images : la page (comme celles de fin de séance et de /review-event) s'ouvre par un serveur local, http://127.0.0.1:8765, lancé en tâche de fond au besoin, qui ne sert que out/ et data/ (`open_served`, `src/common/page.py`). Sur LENZSPITZE, ni Focused ni étiquettes : x et y n'y sont pas des positions.
- 2026-10-28 : page des détecteurs, validé par l'utilisateur : le GIF exporté sans bord rouge, date et heure en bas à droite ; timelapse et GIF jusqu'à 150 images (G_MAX, 60 avant) ; l'explorateur d'images montre déjà toutes les images du dossier sur la plage : pour en avoir plus, pomper avec --every 0 (défaut : une par heure).
- 2026-10-28 : page des détecteurs, validé par l'utilisateur : un clic sur la barre d'un événement (détecteurs ou analyste) fait comme un clic sur un bloc du Status : zoom sur sa plage, ses détails et son timelapse sous la figure ; pour un événement des détecteurs, ses seuls capteurs sur les courbes (plus de second clic).
- 2026-10-28 : point 51, idée de l'utilisateur : un analyste de `/boucle` qui progresse de séance en séance ; proposition de Claude (la carte des événements comme mémoire, nourrie par `/revue-cas` seule ; une mesure sur des cas témoins) et deux questions.
- 2026-10-28 : point 51, idée de l'utilisateur : un analyste de `/boucle` qui progresse de séance en séance ; proposition de Claude (la carte des événements comme mémoire, nourrie par `/review-event` seule ; une mesure sur des events témoins) et deux questions.
@@ -19,20 +19,20 @@ Certains clients ont leur propre plateforme qui intègre les données AIMsight :
**Objectifs**
- Répondre à la question posée par le client, et seulement à elle.
- Une réponse juste et prouvée : chaque affirmation du mail repose sur un fait vu dans les données ou les images.
- Un dossier par demande, qui documente le cas de support et sert de brouillon pendant le peaufinage.
- Un dossier par demande, qui documente l'event de support et sert de brouillon pendant le peaufinage.
- Un GIF des images quand il prouve mieux qu'une phrase (ex. un train devant les cibles, de la buée qui se lève).
**Non-objectifs**
- Détecter les anomalies de la station : d'autres systèmes le font (détecteurs du journal, agent de diagnostic, notifications).
- Envoyer le mail : Marc l'envoie lui-même.
- Télécharger des données : le pompage (`extraction/pomper.py`) reste lancé par l'utilisateur seul.
- Ajouter un cas à la base de cas (`agents/diagnostic/cas/`) : cela reste `/nouveau-cas`, lancé par l'utilisateur.
- Ajouter un event à la base d'events (`events/`) : cela reste `/new-event`, lancé par l'utilisateur.
- Modifier les détecteurs, les outils de lecture ou la connaissance du projet.
**Anti-objectifs** : un échec, même si l'agent tourne.
- Le mail parle d'autre chose que de la question : une cible qui dérive, des références instables, un problème d'énergie. Ces constats vont dans la note pour Marc, jamais dans le mail.
- Le mail affirme une cause que les images ne montrent pas, par exemple « un train est passé » alors qu'aucune image ne le montre.
- Le mail laisse fuir de l'interne : codes de cas (C-xxx), noms des détecteurs, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais.
- Le mail laisse fuir de l'interne : codes d'events (E-xxx), noms des détecteurs, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais.
## 3. Le fonctionnement
@@ -50,11 +50,11 @@ Appel : `/support <mail du client>`, la capture d'écran collée dans le même m
- **la question** : reformulée en une phrase (ex. « Les images montrent-elles de l'activité sur les voies pendant les perturbations de la nuit du 26 au 27.10 ? »).
- **les séries concernées** : la correspondance entre les noms de la plateforme du client et les capteurs de l'export, si l'agent peut l'établir. Sinon, il travaille sur tous les capteurs et le note. **Dans le mail, les cibles portent leur nom dans `data/`** (`sensor_name` de l'export, ex. `101B`), décision de l'utilisateur ; le nom de la plateforme du client s'ajoute seulement si la correspondance est établie.
2. **Vérifier les données** : `inventaire.py` sur `data/<STATION>/` pour la plage. Si les déplacements ou les images de la plage manquent, l'agent **le dit à Marc et s'arrête** (il ne pompe rien lui-même). Exemple : LENZSPITZE n'a pas de déplacements les 24 et 25.10.
3. **Créer le dossier** du cas (§4) et y écrire `demande.md`.
3. **Créer le dossier** de l'event (§4) et y écrire `demande.md`.
4. **Enquêter sur la question** avec les outils existants (§5) :
- situer les perturbations : quand, quels capteurs (détecteurs `categories.py` comme premier repérage, puis `graphique.py`, `plages.py`, `ensemble.py`) ;
- regarder les images à ces moments-là, plus une image avant et une après pour comparer (images entières pour la scène, `vignettes.py` pour les cibles) ;
- confronter aux cas de la base, après les faits, comme le fait l'agent de diagnostic (§4, étape 5 de `agents/diagnostic/instructions.md`) ;
- confronter aux events de la base, après les faits, comme le fait l'agent de diagnostic (§4, étape 5 de `agents/diagnostic/instructions.md`) ;
- chercher le fait qui contredirait la réponse envisagée (la réfutation de l'agent de diagnostic, étape 7).
5. **Écrire**`analyse.md`, puis `reponse.md`, et faire le GIF s'il sert la réponse (§6).
6. **Montrer** à Marc, dans la conversation, le mail en entier, le GIF (`SendUserFile` dans l'application de bureau ; ailleurs, son chemin, choix du builder) et, en deux ou trois lignes, ce qu'il a noté hors question.
@@ -70,18 +70,18 @@ Appel : `/support <mail du client>`, la capture d'écran collée dans le même m
- Heures en UTC, dites explicitement. Si la capture du client montre visiblement l'heure locale, le mail donne aussi l'heure locale entre parenthèses.
- Le vocabulaire de preuve du projet (`confirmed`, `consistent with`…) reste dans `analyse.md`. Le mail le traduit en mots simples (« on voit clairement », « c'est compatible avec », « on ne peut pas l'affirmer »).
## 4. Le dossier du cas
## 4. Le dossier de l'event
`support/<AAAA-MM-JJ>_<STATION>_<sujet>/` à la racine du dépôt (date du jour en UTC, sujet en 2 ou 3 mots, ex. `support/2026-10-28_LENZSPITZE_activite-voies/`). Il contient :
| Fichier | Pour qui | Contenu |
|---|---|---|
| `demande.md` | Marc, la documentation | Le mail du client tel quel ; la capture, copiée dans le dossier (`capture.png`) depuis le chemin que Claude Code donne pour une image collée (`[Image: source: …/images/N.png]`) ; sans chemin, une description de la capture (choix du builder) ; la station et comment elle a été établie (déduite ou donnée par Marc) ; la plage et la question reformulées ; le statut (`brouillon` / `prêt à envoyer`) |
| `analyse.md` | Marc, la documentation | Les faits qui fondent la réponse, traçables (commandes, heures en UTC, capteurs), le cas connu s'il y en a un, la réfutation, ce qui reste non établi ; puis **« Hors question (pour Marc) »** : ce que l'agent a vu sans que le client l'ait demandé, quelques lignes au plus |
| `analyse.md` | Marc, la documentation | Les faits qui fondent la réponse, traçables (commandes, heures en UTC, capteurs), l'event connu s'il y en a un, la réfutation, ce qui reste non établi ; puis **« Hors question (pour Marc) »** : ce que l'agent a vu sans que le client l'ait demandé, quelques lignes au plus |
| `reponse.md` | le client | Le mail prêt à copier : objet, corps, pièces jointes |
| `*.gif`, `*.png` | le client ou Marc | Le GIF et les figures qui servent la réponse ou l'analyse |
`support/` est **versionné dans git** (décision de l'utilisateur) : les dossiers forment peu à peu une base de cas de support, utile pour l'historique (son usage sera rediscuté). Il contient donc des mails et des images de clients, contrairement à `data/` (D-065) et à la base de cas anonymisée.
`support/` est **versionné dans git** (décision de l'utilisateur) : les dossiers forment peu à peu une base d'events de support, utile pour l'historique (son usage sera rediscuté). Il contient donc des mails et des images de clients, contrairement à `data/` (D-065) et à la base d'events anonymisée.
## 5. Ce qu'il réutilise
@@ -89,8 +89,8 @@ Tout ce que le projet a déjà construit pour lire les déplacements :
- le skill `lire-les-donnees` (`.claude/skills/lire-les-donnees/SKILL.md`) : ses outils (`agents/diagnostic/outils/`) et sa méthode de lecture ;
- les détecteurs du journal du matin : `python3 vues-deplacements/detectors/categories.py <dossier>` (catégories : visibilité, sauts, thermique, turbulence…), comme premier repérage ;
- la connaissance du projet : `docs/domaine/`, `docs/displacement/` (dont `domaine/carte-des-evenements.md`), la doc AIMsight (`docs/aimsight/`, par section) ;
- la base de cas `agents/diagnostic/cas/` (`INDEX.md`, puis les fiches) ;
- le déroulé et les règles de l'agent de diagnostic (`agents/diagnostic/instructions.md`, §4 et §5) : faits, cas connus après les faits, réfutation, vocabulaire de preuve, asymétrie. Le skill les cite au lieu de les recopier.
- la base d'events `events/` (`INDEX.md`, puis les fiches) ;
- le déroulé et les règles de l'agent de diagnostic (`agents/diagnostic/instructions.md`, §4 et §5) : faits, events connus après les faits, réfutation, vocabulaire de preuve, asymétrie. Le skill les cite au lieu de les recopier.
À la différence de l'agent de diagnostic, il n'est pas « à l'aveugle » : il tourne dans la conversation principale, avec `CLAUDE.md` chargé, et peut lire ce qui l'aide.
@@ -115,11 +115,11 @@ Cadence observée : LENZSPITZE a une image par heure, donc une nuit fait une diz
- Règles non négociables du projet : traçabilité, heures en UTC, ne pas confondre « pas de donnée » et « station arrêtée », pas de chiffre sans source.
- Ne pas recopier d'identifiants (`SIM_CCID`, `ip`) dans le dossier.
- Pas de LLM ajouté au code : seul le skill (Claude Code) raisonne, et les outils restent des scripts.
- Processus léger (phase expérimentale) : pas de tests automatisés (D-008). La vérification se fait sur le cas réel (§8).
- Processus léger (phase expérimentale) : pas de tests automatisés (D-008). La vérification se fait sur l'event réel (§8).
## 8. Vérification
Le cas de l'exemple : `/support` avec le mail et la capture ci-dessus, la station LENZSPITZE donnée par Marc quand l'agent la demande. Attendu : le dossier `support/2026-10-28_LENZSPITZE_…/` complet, un mail qui répond à « y a-t-il eu de l'activité sur les voies ? » pour la nuit du 26 au 27.10 et dit ce que les images horaires ne permettent pas d'établir, un GIF de la nuit, puis au moins une boucle de peaufinage sur un retour de Marc.
L'event de l'exemple : `/support` avec le mail et la capture ci-dessus, la station LENZSPITZE donnée par Marc quand l'agent la demande. Attendu : le dossier `support/2026-10-28_LENZSPITZE_…/` complet, un mail qui répond à « y a-t-il eu de l'activité sur les voies ? » pour la nuit du 26 au 27.10 et dit ce que les images horaires ne permettent pas d'établir, un GIF de la nuit, puis au moins une boucle de peaufinage sur un retour de Marc.
## 9. Laissé au builder
@@ -129,8 +129,8 @@ Le cas de l'exemple : `/support` avec le mail et la capture ci-dessus, la statio
## Annexe : pistes à revoir (pas dans le socle)
- L'usage de la base de cas de support (`support/`) : à rediscuter avec l'utilisateur.
- L'usage de la base d'events de support (`support/`) : à rediscuter avec l'utilisateur.
- Recadrer le GIF sur une zone ou sur des capteurs (comme `vignettes.py`), si l'image entière ne suffit pas.
- Lire directement un mail exporté (`.eml`) plutôt qu'un texte collé.
- Une table des correspondances client → station (noms de plateforme, « Installation 2 »), si les mêmes clients reviennent.
- Proposer à Marc de transformer un cas de support en cas de la base (`/nouveau-cas`), quand l'explication est validée.
- Proposer à Marc de transformer un cas de support en event de la base (`/new-event`), quand l'explication est validée.
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.