Add the loop's end-of-session page and a detector benchmark on the case base

- End-of-session page for /boucle: the session's curves, the analyst's
  labels against the detectors' events per category, a plain score table
  and the benchmark (comparaison.py, D-066)
- Detectors moved to vues-deplacements/detectors/ (D-067)
- Detectors must detect everything; what the client sees is a separate
  layer (D-068)
- Benchmark: each case keeps its labels from creation (etiquettes.json),
  benchmark.py scores the detectors on every case, history in
  vues-deplacements/benchmark/historique.csv; run by /boucle at each lot,
  after each change and at the end, read by the upgrader and validator;
  labels for C-001..C-005 from one analyst pass corrected by their files,
  C-006..C-008 from lot 01 (D-069)
- Fixes from the releveur's notes: /boucle arguments and other sessions,
  branch name in the spec, detector name in categories.py output, learned
  case header, anonymiser.py (camera/, no empty CSVs, --etiquettes),
  ensemble.py (clock-aligned steps, title), plages.py (same-sign merge),
  labeling request written into /nouveau-cas
- Also carries the other session's uncommitted D-065 edits in the same
  files; data/, .gitignore, pomper.py and stations.py are left out

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-26 16:48:13 +01:00
1 parent 6b3d058a67
commit d5bae7a696
57 files changed
+1727 -157

No files matched your search

+41 -6
View File
@@ -118,7 +118,7 @@ Règles du journal :
- **Conséquence** : le script utilise l'API interne de plotly.js (`_fullLayout`, `d2l`, `r2l`). Il est à revérifier si plotly change de version majeure.
## D-014 — 2026-10-09 — Tout le projet est versionné et poussé sur le dépôt de l'entreprise
- **Statut** : active.
- **Statut** : active, sauf pour `data/`, hors de git depuis D-065.
- **Décision** : `doc/` (documentation AIMsight), `data/` (dont `data/archive/`), `architecture.drawio` et la copie du collecteur `src/__main__ (3).py` sont versionnés et poussés sur `origin` (gitea de l'entreprise). Seuls `out/`, `.venv/` et `__pycache__/` restent ignorés.
- **Pourquoi** : demande explicite de l'utilisateur. Le projet doit être complet et récupérable depuis le dépôt.
- **Conséquence** :
@@ -487,7 +487,7 @@ Règles du journal :
- **Conséquence** : prérequis bloquant : un export de déplacements à la cadence native avec des événements connus (`data/` n'a que des métriques système), idéalement le HDF5. Questions ouvertes : §7 du cadrage.
## D-045 — 2026-10-14 — Données optiques : rangement et premier jeu de travail (PS des Coudres)
- **Statut** : active. Précise D-029 (données par station) et D-044 (données nécessaires, §5 du cadrage).
- **Statut** : active ; noms d'origine et versionnement des exports remplacés par D-065. Précise D-029 (données par station) et D-044 (données nécessaires, §5 du cadrage).
- **Décision** :
- les exports de déplacements d'une station vont dans `data/<STATION>/displacement/`, noms de fichiers d'origine gardés (provenance), dossier de station sans espace (`PS_DES_COUDRES` pour « PS des Coudres ») ;
- premier jeu de travail de `displacement` : PS des Coudres (Suisse), du 08/10 22:00 au 14/10 09:45 UTC, une station seule pour commencer. Choisie par l'utilisateur : un système qui marche bien, avec sans doute de la buée le matin ;
@@ -626,7 +626,7 @@ Règles du journal :
- **Décision** :
- une anomalie de déplacement, pour le client, c'est d'abord **un moment où il ne faut pas se fier aux données** (pluie, buée, neige, toile d'araignée, train, feuilles, soleil, turbulence, cycle thermique, perte de références), rarement un vrai mouvement ;
- un onglet `Journal` de la maquette Explore : les courbes en px (`corr_x`, `corr_y`) sur quelques jours, toutes les données gardées, des barres étiquetées dessous et les zones à ignorer grisées ;
- des détecteurs élémentaires, un fichier chacun dans `vues-deplacements/journal/` (visibilité, sauts, cycle thermique, turbulence, trous), même contrat d'épisode ;
- des détecteurs élémentaires, un fichier chacun dans `vues-deplacements/detectors/` (visibilité, sauts, cycle thermique, turbulence, trous), même contrat d'épisode ;
- on prototype dans Support-Agent, pas dans le dev container de l'application ; on portera ce qui convainc.
- **Pourquoi** : échange de l'utilisateur avec son supérieur : le projet s'est éparpillé dans des analyses complexes ; le client veut savoir chaque matin ce qui s'est passé et ce qu'il peut ignorer. Dans le dev container, Claude ne voit rien et chaque essai demande un relancement. Brainstorming complet : `vues-deplacements/contexte/journal-du-matin.md`.
- **Options écartées pour l'instant** : lisser ou corriger les courbes (second volet, à l'étude : `vues-deplacements/contexte/lissage.md`) ; faire tourner un LLM quand le client ouvre la page (Claude règle les scripts hors ligne).
@@ -644,7 +644,7 @@ Règles du journal :
## D-057 — 2026-10-24 — Déplacements : la boucle automatique d'amélioration des détecteurs et de la base de cas
- **Statut** : active ; construite le 2026-10-24, fonctionnement validé par l'utilisateur le même jour (essai de l'analyste sur un lot de NORDEND) ; l'utilisateur lancera lui-même les séances ; les sous-agents prennent le modèle de la session (D-063).
- **Décision** :
- une commande, `/boucle <dossier de station>` (skill `.claude/skills/boucle/`), découpe la plage en lots de 4 jours (3 jours d'historique, D-056) et, lot après lot, appelle quatre sous-agents sur Opus : l'**analyste** (`critiquer-lot` : sa propre lecture des courbes et des images d'abord, puis la sortie des détecteurs ; verdict « d'accord » ou au plus deux suggestions ; nouveautés), l'**upgrader** (modifie les détecteurs de `vues-deplacements/journal/`, le plus simple d'abord), le **validateur** (vérifie que la modification répond à la critique et va dans le bon sens, **pas trop strict** ; au plus trois passages, puis garder ou annuler), le **builder** (fait des nouveautés des cas de la base `agents/diagnostic/cas/`, un par genre d'événement, marqués « (appris) ») ;
- une commande, `/boucle <dossier de station>` (skill `.claude/skills/boucle/`), découpe la plage en lots de 4 jours (3 jours d'historique, D-056) et, lot après lot, appelle quatre sous-agents sur Opus : l'**analyste** (`critiquer-lot` : sa propre lecture des courbes et des images d'abord, puis la sortie des détecteurs ; verdict « d'accord » ou au plus deux suggestions ; nouveautés), l'**upgrader** (modifie les détecteurs de `vues-deplacements/detectors/`, le plus simple d'abord), le **validateur** (vérifie que la modification répond à la critique et va dans le bon sens, **pas trop strict** ; au plus trois passages, puis garder ou annuler), le **builder** (fait des nouveautés des cas de la base `agents/diagnostic/cas/`, un par genre d'événement, marqués « (appris) ») ;
- les agents ne se parlent pas : chacun écrit son rendu dans le dossier du lot (`vues-deplacements/boucle/<séance>/lot-NN/`), l'orchestrateur le transmet et commite tout, étape par étape, par chemin, sur une branche par séance ; un `bilan.md` à la fin ;
- l'agent de diagnostic n'a aucun rôle dans la boucle : ses consignes ne changent pas ; il sera traité dans une autre conversation.
- **Pourquoi** : l'utilisateur veut qu'après une séance Claude ait appris : de nouveaux cas tirés d'événements réels (la base de connaissances) et des détections optimisées ; tout commité, pour s'y retrouver et revenir en arrière.
@@ -657,7 +657,7 @@ Règles du journal :
- **Décision** :
- l'agent de diagnostic est un outil à part de la boucle (D-057) : on l'appelle, au support ou pour le client, sur un cas précis, souvent celui qui met en échec les détecteurs du journal ou que la base ne connaît pas ; son but est de dire, le plus précisément possible, ce qui s'est réellement passé ; il rend son rapport à l'utilisateur et à personne d'autre ;
- il n'est plus à l'aveugle : il lit la connaissance du projet sur les déplacements (`docs/domaine/`, `docs/displacement/`, la doc AIMsight, toute la base de cas, celle-ci après ses faits) ; il ne lit pas ce qui rend déjà un avis sur des données (ses anciens rapports, `vues-deplacements/`, `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`) ;
- il part des événements des détecteurs (`vues-deplacements/journal/categories.py`), sans les juger : ce rôle reste celui de l'analyste ;
- il part des événements des détecteurs (`vues-deplacements/detectors/categories.py`), sans les juger : ce rôle reste celui de l'analyste ;
- aucun raisonnement nouveau ne lui est écrit : son intelligence (Opus), la base de cas et la documentation suffisent ; deux consignes qui décidaient à sa place sont retirées : « un mouvement commun à toutes les cibles n'est pas un mouvement de l'ouvrage » devient la mise en garde de `CLAUDE.md` (ne pas confondre mode commun et mouvement structurel), et, sans cas correspondant, la conséquence est celle que ses preuves établissent, plus « indéterminée » en premier ; l'asymétrie reste (« aucune » demande un cas) ;
- il n'ajoute jamais de cas à la base.
- **Pourquoi** : demande de l'utilisateur, qui est l'expert : les détecteurs calculent sans finesse, l'agent sait raisonner avec une base de connaissances. Sur CLARIDEN, avant C-004 (rapport `2026-10-15T1346Z_CLARIDEN_19-09-matin`), l'agent avait relevé les faits mais conclu à un mouvement de caméra mal compensé, conséquence indéterminée ; l'expert y voit un mouvement réel : toutes les cibles corrigées vont dans le même sens au même moment, aucune anomalie documentée ne l'explique, et des références réparties ne bougent pas toutes ensemble.
@@ -704,7 +704,7 @@ Règles du journal :
- l'orchestrateur l'écrit au début de chaque lot (`score-avant.txt`) et en fin de séance (`score-fin.txt`) ; l'upgrader et le validateur le relancent après une modification : la catégorie en cause monte sur le lot, sans baisse nette sur les lots d'avant ; le score est un fait, pas un verdict ;
- consigne des étiquettes : bornes à la mesure près ; un saut qui dure, la mesure du saut seule (convention du détecteur de sauts).
- **Pourquoi** : l'analyste et le validateur jugeaient en mots ; les étiquettes n'étaient lues par personne ; une modification au lot 3 n'était jamais vérifiée sur les lots 1 et 2. L'utilisateur laisse Claude choisir le compte et l'essayer à la première séance.
- **Options écartées** (choix de Claude, à revoir) : deux niveaux de validité (la visibilité réduite, données gardées mais moins précises, se perdrait) ; un compte par événement (il ne mesure pas les bornes) ; la validité de toute la station à un instant (les étiquettes sont déjà par capteur) ; un champ `validite` dans les étiquettes (elle se déduit de la catégorie) ; le script dans `journal/` (l'upgrader pourrait le modifier).
- **Options écartées** (choix de Claude, à revoir) : deux niveaux de validité (la visibilité réduite, données gardées mais moins précises, se perdrait) ; un compte par événement (il ne mesure pas les bornes) ; la validité de toute la station à un instant (les étiquettes sont déjà par capteur) ; un champ `validite` dans les étiquettes (elle se déduit de la catégorie) ; le script dans `detectors/` (l'upgrader pourrait le modifier).
- **Conséquence** : le rejeu, écarté par D-057 parce qu'il coûtait un regard de Claude, devient gratuit sur les étiquettes. La turbulence est toujours « prudence » au score, forte ou non (l'étiquette ne dit pas sa force). Les trous n'ont pas de mesure, donc pas de score.
## D-063 — 2026-10-26 — Agents : le modèle et l'effort de la session
@@ -720,3 +720,38 @@ Règles du journal :
- **Pourquoi** : l'utilisateur a validé les diagnostics de ces cas, pas les outils qui les lisent ; les critères des fiches ne sont donc pas un corrigé de lecture des données brutes. `/aiguiser` améliore la lecture, pas le diagnostic. Sur NORDEND (séance du 2026-10-26), le contrôle a donné « manqué » aux cinq cas (C-001 : 4 critères sur 5 retrouvés) sans qu'on sache si les modifications y étaient pour quelque chose.
- **Options écartées** : garder le contrôle en le comparant aux outils d'avant la séance (coûte cinq lectures de plus pour juger des critères que l'utilisateur n'a pas validés).
- **Conséquence** : la validation d'une séance repose sur le corrigé du correcteur, lot par lot, et sur les commandes des fiches. La séance `aiguiser/2026-10-26T1149Z_NORDEND` garde ses résultats de contrôle dans `controle/` à titre d'historique ; le bilan de cette séance les cite encore.
## D-065 — 2026-10-26 — `data/` hors de git, rempli par le pompage
- **Statut** : active ; remplace D-014 pour `data/` et D-045 pour les noms d'origine et le versionnement des exports.
- **Décision** : `data/` entre dans `.gitignore` et sort de l'index ; il ne contient plus que des dossiers pompés (`extraction/pomper.py`, défaut de `--out`, un fichier par jour), au numéro de série du système. Les exports reçus à la main en sont retirés et leurs plages repompées, élargies de 5 jours avant et 5 jours après, images comprises. `/aiguiser`, `/boucle`, `/nouveau-cas` et les scripts des domaines lisent `data/<STATION>/` ; `out/pompage/` n'est plus une sortie.
- **Pourquoi** : demande de l'utilisateur. Un dossier pompé avec ses images pèse des centaines de Mo, des Go sur plusieurs mois : le versionner n'a pas de sens, il se repompe.
- **Options écartées** : garder `data/` versionné et pomper dans `out/pompage/` (deux endroits pour les mêmes données, exports et pompage mêlés) ; garder les exports reçus à côté des fichiers pompés (le même jour lu deux fois).
- **Conséquence** : un clone neuf n'a pas de données : les pomper (`run.md`). Les cas de la base gardent leurs copies codées, versionnées (`agents/diagnostic/cas/`), export horaire en mm compris, que le pompage ne sait pas faire. Les exports d'origine restent dans l'historique git. PS des Coudres change de dossier : le pompage le range sous son numéro de série, pas `PS_DES_COUDRES`.
## D-066 — 2026-10-26 — Boucle : une page de fin de séance, l'analyste face aux détecteurs
- **Statut** : active ; complète D-057 et D-062.
- **Décision** : en fin de séance, `/boucle` écrit et ouvre `out/boucle_<séance>.html` (`python3 .claude/skills/boucle/comparaison.py <dossier> <séance>`) : `corr_x` et `corr_y` de tous les capteurs sur toute la plage de la séance ; dessous, une ligne par catégorie du journal, la lecture de l'analyste (ses étiquettes, D-061) au-dessus des événements des détecteurs dans leur état de fin de séance ; en dernier, en gris, les moments « aucune » de l'analyste (vus, hors des catégories du journal : sans effet sur les courbes le plus souvent, ou une nouveauté) ; sous la figure, le score de la séance (D-062). Zoom par sélection, pas à la molette.
- **Pourquoi** : demande de l'utilisateur : voir à la fin d'une séance le diagnostic de l'agent et celui des scripts sur la même plage ; séance après séance, sur des lots différents, faire coïncider les deux.
- **Options écartées** : les deux classifications en deux blocs l'un sous l'autre (choix de Claude : les deux barres d'une même catégorie sur la même ligne se comparent d'un coup d'œil) ; la page rangée dans le dossier de la séance (générée, elle va dans `out/` et se refait par la commande).
- **Conséquence** : la page montre les détecteurs tels qu'ils sont quand on la refait, pas ceux du début de la séance ; l'écart du début se lit dans `lot-NN/score-avant.txt`.
## D-067 — 2026-10-26 — Les détecteurs du journal dans `vues-deplacements/detectors/`
- **Statut** : active ; renomme le dossier `vues-deplacements/journal/` de D-056.
- **Décision** : les détecteurs du journal du matin et `categories.py` vivent dans `vues-deplacements/detectors/` ; le code, les consignes des processus et la documentation vivante pointent sur ce chemin. « Journal » reste le nom du journal du matin (onglet `Journal`, `seuils-du-journal.md`).
- **Pourquoi** : demande de l'utilisateur : le dossier contient les détecteurs, son nom doit le dire.
- **Options écartées** : aucune.
- **Conséquence** : les rendus des séances passées (`vues-deplacements/boucle/`, `vues-deplacements/aiguiser/`) et les anciens plans de `docs/superpowers/` gardent l'ancien chemin, à titre d'historique.
## D-068 — 2026-10-26 — Les détecteurs doivent tout détecter
- **Statut** : active ; précise D-056 et D-057 ; rouvre, côté détection seulement, les réglages des points 13 et 41 du plan (cycle thermique) et `MISSING` (trous).
- **Décision** : les détecteurs du journal doivent trouver tout ce que l'analyste de la boucle étiquette, dans sa catégorie : un cycle thermique sur quelques cibles, un trou d'un pas, une cible masquée sans assez de rejets… Ce qu'on montre ou non au client est une autre question, réglée plus tard dans une couche à part. Un réglage pris pour l'affichage n'arrête plus l'upgrader ni le validateur.
- **Pourquoi** : demande de l'utilisateur : « les détecteurs doivent tout détecter ; ce qu'on montre au client ou pas n'est pas la question ici ». Sur le lot 01 de NORDEND (01 → 04/09), l'upgrader avait laissé le cycle thermique et les trous d'un ou deux pas, comptés « manqués » par le score (301 mesures sur 370 étiquetées), parce que ces réglages avaient été choisis pour ce que voit le client.
- **Options écartées** : garder ces réglages et lire l'écart comme voulu (le score n'aurait jamais mesuré la détection) ; faire étiqueter l'analyste selon ce qu'on montre au client (les étiquettes servent aussi un futur modèle appris, D-061).
- **Conséquence** : la détection et l'affichage se séparent. Tant que la couche d'affichage n'existe pas, l'onglet `Journal` de la maquette montre tout ce que trouvent les détecteurs, petites vagues thermiques et trous d'un pas compris.
## D-069 — 2026-10-26 — Boucle : un benchmark des détecteurs sur la base de cas
- **Statut** : active ; complète D-048 (structure d'un cas), D-057 et D-062.
- **Décision** : chaque cas de la base garde son diagnostic à la création, `etiquettes.json` dans son dossier, au format des étiquettes de l'analyste (D-061), noms codés, figé comme le reste du cas. `.claude/skills/boucle/benchmark.py` lance les détecteurs sur chaque cas et les compare à ces étiquettes, mesure par mesure (le calcul de `score.py`) : purement analytique. `/boucle` le lance au début de chaque lot, après chaque modification et en fin de séance ; chaque passage entre dans `vues-deplacements/benchmark/historique.csv` avec la version des détecteurs (commit, « + » si non commités). L'upgrader le relance, le validateur le lit : un recul net est un défaut, une hausse un plus, pas un but. Le builder donne ses étiquettes à chaque cas créé (`anonymiser.py --etiquettes`) ; C-001 à C-005 les ont reçues d'un passage unique de l'analyste, corrigé par leur fiche ; `/nouveau-cas` fait de même.
- **Pourquoi** : demande de l'utilisateur, après un relevé du releveur : au premier lot d'une station, le score n'a pas de lot d'avant, et rien ne mesurait un recul sur les cas où les seuils avaient été réglés. Le diagnostic de l'agent pris pour référence, ce sont ses étiquettes : elles sont faites pour être mesurées (l'utilisateur).
- **Options écartées** : comparer les sorties de `categories.py` sur les cas, en texte (ajouté le même jour, sans chiffre ni historique) ; prendre pour référence le rapport de l'agent de diagnostic (D-046, du texte) ; faire du benchmark un but de l'upgrader (sur une dizaine de cas, les détecteurs se régleraient sur eux).
- **Conséquence** : un cas a un fichier de plus ; le score des détecteurs sur la base se suit version par version. Limite : un cas appris ne contient que 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.