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

@@ -31,7 +31,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
## 3. Ce qui existe et que la boucle réutilise
- Les détecteurs du journal : `vues-deplacements/journal/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 vues-deplacements/journal/categories.py <dossier> --du AAAA-MM-JJ --au AAAA-MM-JJ --tranche 4 --historique 3`. Chaque lot est classé avec les 3 jours d'avant : c'est la règle pour la boucle (D-056).
- Les détecteurs du journal : `vues-deplacements/detectors/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 vues-deplacements/detectors/categories.py <dossier> --du AAAA-MM-JJ --au AAAA-MM-JJ --tranche 4 --historique 3`. Chaque lot est classé avec les 3 jours d'avant : c'est la règle pour la boucle (D-056).
- Les outils de lecture des données, `agents/diagnostic/outils/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images) ; leur mode d'emploi est le skill `.claude/skills/lire-les-donnees/`, que suit l'analyste ; ils évoluent par `/aiguiser` (D-059, `aiguiser-la-lecture.md`), pas par la boucle. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé.
- La carte des événements, `docs/displacement/domaine/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4).
- La base de cas, `agents/diagnostic/cas/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymiser-cas` (données copiées dans le dossier du cas, noms codés, D-049, D-050). Les cas existants ne se modifient jamais ; la boucle en ajoute.
@@ -39,9 +39,9 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
## 4. Une séance
**Lancement** : `/boucle <dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]`, par l'utilisateur seul. Sans dates, toute la période du dossier. **L'utilisateur pilote les lots** (2026-10-24) : avec les données en masse, on ne traitera pas tout ; les lots se traitent indépendamment, il choisit lesquels (`--du` / `--au` sur la plage d'un lot pour un seul) ; la manière de les choisir reste à voir. Lots de 4 jours par défaut (l'utilisateur : « 4-5 jours, c'est égal »).
**Lancement** : `/boucle data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]`, par l'utilisateur seul ; un nom de station seul désigne `data/<STATION>/` (D-065) ; `--au` est exclu (la plage s'arrête à `--au` 00:00Z). Sans dates, toute la période du dossier. **L'utilisateur pilote les lots** (2026-10-24) : avec les données en masse, on ne traitera pas tout ; les lots se traitent indépendamment, il choisit lesquels (`--du` / `--au` sur la plage d'un lot pour un seul) ; la manière de les choisir reste à voir. Lots de 4 jours par défaut (l'utilisateur : « 4-5 jours, c'est égal »).
**Mise en place** *(choix de Claude)*. L'orchestrateur crée la branche `boucle/<AAAA-MM-JJ>_<STATION>` depuis la branche courante et le dossier de la séance `vues-deplacements/boucle/<AAAA-MM-JJTHHMMZ>_<STATION>/`, hors de tout dossier de station (règle de `vues-deplacements/CLAUDE.md`). Il découpe la plage en lots, les mêmes que les tranches de `categories.py`.
**Mise en place** *(choix de Claude)*. L'orchestrateur crée la branche `boucle/<AAAA-MM-JJTHHMMZ>_<STATION>` (le nom du dossier de la séance : deux séances le même jour ne se mêlent pas) depuis la branche courante et le dossier de la séance `vues-deplacements/boucle/<AAAA-MM-JJTHHMMZ>_<STATION>/`, hors de tout dossier de station (règle de `vues-deplacements/CLAUDE.md`). Il découpe la plage en lots, les mêmes que les tranches de `categories.py`.
**Pour chaque lot, dans l'ordre** (dossier `lot-NN/` dans celui de la séance) :
1. **Analyste** : il écrit `critique.md`. Commit.
@@ -79,17 +79,20 @@ La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi
**Étiquettes** (D-061, ajoutées le 2026-10-25) : juste après sa lecture, avant la sortie des détecteurs, l'analyste écrit aussi `etiquettes.json`, une entrée par moment de sa lecture (début, fin, capteurs, catégorie du journal, événement de la carte s'il est établi, preuve vue ou déduite), contrôlée par `.claude/skills/critiquer-lot/etiquettes.py` ; le format est dans `critiquer-lot`. Elles ne dépendent pas des détecteurs : ce sont les labels d'un futur modèle appris (point 44 du plan), à garder même si une modification est annulée. Toutes les étiquettes : `vues-deplacements/boucle/*/lot-*/etiquettes.json`.
**Score** (D-062, point 45 du plan, ajouté le 2026-10-25) : le but de la boucle est la précision de la détection sur tout le lot (l'utilisateur). `python3 .claude/skills/boucle/score.py <dossier>` compare, mesure par mesure et capteur par capteur, les événements des détecteurs aux étiquettes de **tous** les lots de la station : par catégorie et pour deux niveaux de validité (« à ignorer » : les zones grisées ; « prudence » : visibilité réduite et turbulence), « trouvées » (part des mesures étiquetées que les détecteurs signalent) et « justes » (part des mesures signalées que l'analyste a étiquetées). 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 ce lot, sans baisse nette sur les lots d'avant. Le score est un fait, pas un verdict : l'analyste peut se tromper aussi. Choix de Claude, laissé par l'utilisateur, à revoir après la première séance : trois niveaux plutôt que deux, un compte par mesure plutôt que par événement, par capteur plutôt que pour toute la station. Le script est hors de `journal/` : l'upgrader ne peut pas le modifier.
**Score** (D-062, point 45 du plan, ajouté le 2026-10-25) : le but de la boucle est la précision de la détection sur tout le lot (l'utilisateur). `python3 .claude/skills/boucle/score.py <dossier>` compare, mesure par mesure et capteur par capteur, les événements des détecteurs aux étiquettes de **tous** les lots de la station : par catégorie et pour deux niveaux de validité (« à ignorer » : les zones grisées ; « prudence » : visibilité réduite et turbulence), « trouvées » (part des mesures étiquetées que les détecteurs signalent) et « justes » (part des mesures signalées que l'analyste a étiquetées). 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 ce lot, sans baisse nette sur les lots d'avant. Le score est un fait, pas un verdict : l'analyste peut se tromper aussi. Choix de Claude, laissé par l'utilisateur, à revoir après la première séance : trois niveaux plutôt que deux, un compte par mesure plutôt que par événement, par capteur plutôt que pour toute la station. Le script est hors de `detectors/` : l'upgrader ne peut pas le modifier.
**Benchmark** (D-069, point 48 du plan, ajouté le 2026-10-26 à la demande de l'utilisateur) : chaque cas de la base garde son diagnostic à la création, `etiquettes.json` au format des étiquettes de l'analyste, noms codés, figé ; `.claude/skills/boucle/benchmark.py` lance les détecteurs sur chaque cas et les compare à ces étiquettes, comme le score (« trouvées », « justes », par catégorie, par cas et au total). Purement analytique, sans agent. L'orchestrateur le lance au début de chaque lot (`benchmark-avant.txt`), après chaque modification (`benchmark-K.txt`) et en fin de séance (`benchmark-fin.txt`), et l'ajoute à l'historique `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs (commit) ; l'upgrader le relance et le validateur le lit : 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, choix de l'utilisateur). Le builder donne ses étiquettes à chaque cas créé (`anonymiser.py --etiquettes`) ; C-001 à C-005 ont reçu les leurs d'un passage unique de l'analyste, corrigé par leur fiche (`vues-deplacements/benchmark/etiquetage/`). Limite : un cas appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot.
### Upgrader : `.claude/agents/upgrader.md`
Il reprend les suggestions de l'analyste (et la dernière validation, s'il y en a une) et modifie les détecteurs. Outils : Read, Edit, Write, Bash.
- Il ne touche qu'à `vues-deplacements/journal/*.py` et au registre des seuils.
- Il ne touche qu'à `vues-deplacements/detectors/*.py` et au registre des seuils.
- **Le plus simple d'abord** *(choix de Claude, contre la complexité)* : changer une constante ; sinon ajuster une règle existante ; sinon une règle nouvelle et courte ; un nouveau détecteur (contrat `detect(mesures)`) en dernier recours.
- **Interdits** : pas de nouvelle catégorie (une suggestion qui en demande une va au bilan) ; pas de règle propre à une station, à un capteur ou à une date ; contrat et clés des épisodes inchangés ; bibliothèque standard seulement.
- **Tout détecter** (l'utilisateur, 2026-10-26, D-068) : les détecteurs doivent trouver tout ce que l'analyste étiquette ; ce qu'on montre au client n'est pas la question ici. Un réglage pris pour l'affichage (points 13 et 41 du plan, `MISSING`) peut être changé par l'upgrader.
- Il met à jour le registre des seuils et la docstring du détecteur dans le même changement.
- Il relance `categories.py` sur le lot, avant et après.
- Il relance `categories.py` sur le lot, avant et après, puis le benchmark sur la base de cas (D-069) : un recul net sur un cas est un recul, la ligne `a_verifier` de C-004 ne baisse pas ; une hausse est un plus, pas un but.
- `modification-K.md` : ce qui a changé et pourquoi, les événements du lot avant et après, ce qu'il n'a pas pu corriger.
### Validateur : `.claude/agents/validateur.md`
@@ -116,9 +119,10 @@ Ajouté le 2026-10-24, commun à tous les processus automatiques. Chaque rendu f
## 6. Ce que l'utilisateur trouve à la fin
- La branche `boucle/<AAAA-MM-JJ>_<STATION>` : un commit par étape, lisible avec `git log` ; il la fusionne, n'en garde qu'une partie, ou revient en arrière.
- La branche `boucle/<AAAA-MM-JJTHHMMZ>_<STATION>` : un commit par étape, lisible avec `git log` ; il la fusionne, n'en garde qu'une partie, ou revient en arrière.
- `bilan.md` : une ligne par lot (verdict de l'analyste ; étiquettes ; modification gardée, annulée ou aucune ; cas créés), et le score de fin de séance (`score-fin.txt`) sur toutes les étiquettes de la station ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les nouveautés déjà connues ; les erreurs.
- `docs/ameliorations-processus.md` : les difficultés du processus relevées pendant la séance.
- La page `out/boucle_<séance>.html` (D-066, ajoutée le 2026-10-26 à la demande de l'utilisateur), ouverte en fin de séance : les courbes de toute la plage ; dessous, une ligne par catégorie, la lecture de l'analyste au-dessus des événements des détecteurs ; le score de la séance. Le but, séance après séance : que les deux coïncident.
## 7. Essai et première séance