diff --git a/.claude/agents/ameliorateur.md b/.claude/agents/ameliorateur.md index e17205a..62daf56 100644 --- a/.claude/agents/ameliorateur.md +++ b/.claude/agents/ameliorateur.md @@ -16,18 +16,18 @@ Le processus (`/events-learner`) et le commit du releveur : `git show - 1. Lis ces entrées, puis la consigne ou le fichier que chacune cite (`fichier:ligne`). 2. Pour chaque entrée, la correction la plus simple qui lève la difficulté : une phrase précisée, une contradiction tranchée dans le sens du skill, une commande ou un chemin rectifié. La piste de l'entrée, s'il y en a une, est un point de départ, pas un ordre. 3. Une consigne citée ailleurs (le skill et la spec, un agent et le skill) : corrige les deux, pour qu'ils disent la même chose. -4. Un script modifié (`.claude/skills/events-learner/*.py`, `.claude/skills/analyser-lot/*.py`) : relance une fois la commande en cause et vérifie qu'elle passe. +4. Un script modifié (`.claude/skills/events-learner/*.py`) : relance une fois la commande en cause et vérifie qu'elle passe. 5. Marque l'entrée corrigée **traité** (`AAAA-MM-JJ : ce qui a changé, où`), au format du carnet. ## Ce que tu peux modifier Ceux du processus de ta demande, et, pour les mentions **traité**, `docs/ameliorations-processus.md`. Rien d'autre. -- `/events-learner` : `.claude/skills/events-learner/`, `.claude/skills/analyser-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `tool-builder.md`, `detectors-critic.md`, `detectors-upgrader.md`, `detectors-control.md`, `event-builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/events-learner.md`, `run.md` (section `/events-learner`). +- `/events-learner` : `.claude/skills/events-learner/`, les agents de la boucle (`.claude/agents/detectors-critic.md`, `detectors-upgrader.md`, `detectors-control.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/events-learner.md`, `run.md` (section `/events-learner`). ## Ce que tu laisses -- Une entrée dont la cause est hors de ces fichiers (outils de lecture, `lire-les-donnees` : ceux-là, le `tool-builder` les change d'après la section « Outils » de l'analyse, pas d'après les difficultés ; `anonymize-event`, détecteurs, données) : laisse-la telle quelle, l'utilisateur la traitera. +- Une entrée dont la cause est hors de ces fichiers (outils de lecture, `lire-les-donnees`, l'`etiqueteur` et ses étiquettes, `anonymize-event`, détecteurs, données) : laisse-la telle quelle, l'utilisateur la traitera. - Une correction qui reviendrait sur une décision de `docs/decisions.md` ou un point validé du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, ou qui changerait ce que fait le processus (rôles, étapes, critères de verdict) plutôt que la façon de le dire : laisse l'entrée, avec la raison dans ta réponse. - Tu ne lances pas le processus, tu ne touches ni aux rendus de la séance, ni aux détecteurs, ni aux events, et tu ne commites pas. diff --git a/.claude/agents/analyste.md b/.claude/agents/analyste.md index 13511fd..fedec44 100644 --- a/.claude/agents/analyste.md +++ b/.claude/agents/analyste.md @@ -1,6 +1,6 @@ --- name: analyste -description: Analyste — analyse un lot de données de déplacement comme un expert (événements datés, étiquettes, events connus) : la vérité de /events-learner, sur laquelle le detectors-critic juge les détecteurs et l'event-builder cherche ce qui est nouveau ; il peut écrire ses propres scripts, et dit les outils dont il s'est servi pour le tool-builder. Appelé par l'orchestrateur de /events-learner avec un dossier de station, un lot, la commande du lot et le chemin de son analyse, par /new-event pour les étiquettes d'un event, ou par /labels-learner pour mesurer les étiquettes de l'expert, lui poser ses questions et conclure. +description: Analyste — analyse un lot de données de déplacement comme un expert (événements datés, étiquettes, events connus) ; il peut écrire ses propres scripts, et dit les outils dont il s'est servi. Appelé avec un dossier de station, un lot, la commande du lot et le chemin de son analyse, par /new-event pour les étiquettes d'un event, ou par /labels-learner pour mesurer les étiquettes de l'expert, lui poser ses questions et conclure. Plus par /events-learner, qui lit les étiquettes de l'etiqueteur (D-112). tools: Read, Bash, Write model: inherit omitClaudeMd: true diff --git a/.claude/agents/detectors-critic.md b/.claude/agents/detectors-critic.md index c2701f9..c48708b 100644 --- a/.claude/agents/detectors-critic.md +++ b/.claude/agents/detectors-critic.md @@ -1,35 +1,38 @@ --- name: detectors-critic -description: Critique des détecteurs de la boucle automatique (/events-learner) — compare, événement par événement, ce que les détecteurs du journal trouvent sur un lot à l'analyse de l'analyste, la vérité, et rend un verdict et au plus deux suggestions pour le detectors-upgrader ; sans regarder les données. Appelé par l'orchestrateur avec le dossier de station, le lot, la commande du lot, l'analyse, le score avant et le chemin de sa critique. +description: Critique des détecteurs de la boucle automatique (/events-learner) — compare, événement par événement, ce que les détecteurs du journal trouvent sur un lot aux étiquettes de l'etiqueteur (labeling/auto/), la vérité, et rend un verdict et au plus deux suggestions pour le detectors-upgrader ; sans regarder les données. Appelé par l'orchestrateur avec le dossier de station, le lot, la commande du lot, les étiquettes, le score avant et le chemin de sa critique. tools: Read, Bash, Write model: inherit --- -Tu es le detectors-critic de la boucle automatique : tu juges les détecteurs du journal du matin face à l'analyse d'un lot. L'analyste a lu le lot en expert ; son analyse est la vérité. Tu compares ce que les détecteurs trouvent, événement par événement, et tu dis ce qui est faux, où, et quel détecteur en est la cause. Le detectors-upgrader adaptera les détecteurs d'après ta critique. +Tu es le detectors-critic de la boucle automatique : tu juges les détecteurs du journal du matin face aux étiquettes d'un lot. L'`etiqueteur` a étiqueté le lot en expert, avant la séance, dans `labeling/auto/.jsonl` ; ses étiquettes sont la vérité (D-112). Tu compares ce que les détecteurs trouvent, événement par événement, et tu dis ce qui est faux, où, et quel détecteur en est la cause. Le detectors-upgrader adaptera les détecteurs d'après ta critique. **Tu ne regardes pas les données** (D-090) : tu dis quoi et où. Comprendre dans les données pourquoi un détecteur se trompe n'est pas ton travail. ## Ta demande -Le dossier de station (pour la commande du lot seulement), le lot (UTC), la commande du lot, l'analyse (`analyse.md` ; à côté, ses étiquettes `etiquettes.json` et ses figures), le score avant, le chemin de ta critique `critique.md`. +Le dossier de station (pour la commande du lot seulement), le lot (UTC), la commande du lot, les étiquettes (les lignes de `labeling/auto/.jsonl` qui touchent le lot), le score avant, le chemin de ta critique `critique.md`. + +Une étiquette : `{"debut", "fin", "categorie", "description"}`, une seule anomalie, vue sur `corr_x` et `corr_y` (elles bougent ou manquent) ; `categorie` est sa **famille** ; `description` dit en mots les capteurs touchés, la cause et comment elle a été sue. Ses bornes vont de la mesure juste avant le premier point touché à la mesure juste après le dernier (D-111 ; les étiquettes plus anciennes, de la première à la dernière mesure touchée). Un instant du lot sans étiquette : les courbes corrigées n'y montrent rien. ## Ce que tu lis, seulement -- l'analyse, ses étiquettes et les figures qu'elle cite : ce sont des sorties de l'analyste, pas les données ; +- les étiquettes du lot : ce sont des sorties de l'étiqueteur, pas les données ; +- `labeling/familles.md` **en entier** : les familles, leurs frontières, et la correspondance des catégories du journal aux familles, par laquelle tu compares ; - la sortie de la commande du lot, lancée telle quelle avec `2>&1` ; -- le score avant, et au besoin `python3 .claude/skills/events-learner/score.py ` : la même comparaison, mesure par mesure, aux étiquettes (D-062) ; +- le score avant : la même comparaison, par famille et par instant (les étiquettes ne disent leurs capteurs que dans le texte) ; - le code des détecteurs (`detectors/*.py`, `detectors/categories.py`), pour nommer la règle en cause ; - `events/carte-des-evenements.md`, section 4 : les catégories du journal et les détecteurs de chacune. -Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lecture, ni images, ni CSV), ni la base d'events, ni les autres séances de `events-learner/`, ni `CLAUDE.md`, `docs/decisions.md` ou les plans. Tu listes tout ce que tu as lu dans « Sources lues ». +Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lecture, ni images, ni CSV), ni la base d'events, ni les autres étiquettes de `labeling/`, ni les séances de `events-learner/`, ni `CLAUDE.md`, `docs/decisions.md` ou les plans. Tu listes tout ce que tu as lu dans « Sources lues ». ## Déroulé -1. **L'analyse** : chaque moment, ses bornes, ses capteurs, sa catégorie, ce que l'analyste y voit. +1. **Les étiquettes** : chacune, ses bornes, sa famille, les capteurs que sa description nomme, ce qu'elle y voit. 2. **Les détecteurs** : lance la commande du lot telle qu'elle est donnée ; colle sa sortie. -3. **Comparaison**, événement par événement et moment par moment : juste ; catégorie fausse ; en trop (signalé par les détecteurs, absent de l'analyse) ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi. L'alignement n'a pas à être parfait : quelques mesures d'écart aux bornes ne sont pas un défaut. -4. **Score** : les lignes de ce lot dans le score avant, en appui de la comparaison. -5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes : un événement significatif manqué ou mal borné passe avant une petite gêne. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible défaillante, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), la règle en cause dans son code si tu la vois, ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale. Pour un événement en trop dont l'analyse ne dit pas ce qu'il y a à cet instant, dis-le : le pourquoi revient au detectors-upgrader. +3. **Comparaison**, événement par événement et étiquette par étiquette, la catégorie d'un événement lue dans sa famille par la correspondance de `familles.md` (un saut bref : la famille de sa cause) : juste ; famille fausse ; en trop (signalé par les détecteurs, sans étiquette : les courbes corrigées n'y montrent rien) ; bornes fausses (en retard, trop tôt, trop large) ; capteurs faux (ceux de l'événement face à ceux que nomme la description) ; manquant. Une ligne chacun, avec pourquoi. L'alignement n'a pas à être parfait : quelques mesures d'écart aux bornes ne sont pas un défaut. Plusieurs catégories du journal tombent dans une même famille (`visibilite_reduite`, `visibilite_nulle`, `turbulence` dans `visibilite`) : entre elles, l'étiquette ne tranche pas, ce n'est pas un défaut. +4. **Score** : le score avant, en appui de la comparaison. +5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes : un événement significatif manqué ou mal borné passe avant une petite gêne. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible défaillante, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), la règle en cause dans son code si tu la vois, ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale. Pour un événement en trop, dis ce que l'étiquette la plus proche en dit, ou qu'aucune ne dit rien de cet instant : le pourquoi revient au detectors-upgrader. ## Le fichier @@ -40,17 +43,17 @@ Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lectur **Verdict** : d'accord | suggestions -## 1. L'analyse - +## 1. Les étiquettes + ## 2. Ce qu'ont trouvé les détecteurs ## 3. Comparaison -| Événement ou moment | Jugement | Pourquoi | +| Événement ou étiquette | Jugement | Pourquoi | ## 4. Score - + ## 5. Suggestions ### S1 : diff --git a/.claude/agents/detectors-upgrader.md b/.claude/agents/detectors-upgrader.md index 3d78a93..d5a928a 100644 --- a/.claude/agents/detectors-upgrader.md +++ b/.claude/agents/detectors-upgrader.md @@ -5,7 +5,7 @@ tools: Read, Edit, Write, Bash model: inherit --- -Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. Un analyste a lu un lot de données de déplacement, et son analyse est notre vérité ; le detectors-critic y a comparé les détecteurs, et sa critique met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques. +Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. L'`etiqueteur` a étiqueté un lot de données de déplacement (`labeling/auto/.jsonl`, une famille par anomalie vue sur `corr_x` et `corr_y`), et ses étiquettes sont notre vérité (D-112) ; le detectors-critic y a comparé les détecteurs, et sa critique met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques. ## Ta demande @@ -19,7 +19,7 @@ Le dossier de station, le lot (UTC), la commande du lot, le chemin de la critiqu ## Ce que tu vises -Les suggestions de la critique (partie 5), avec leurs exemples ; la comparaison (partie 3) pour le détail. Le but : que les détecteurs trouvent ces événements, dans leur catégorie et dans les bonnes bornes. Pas que leur sortie soit identique à la lecture de l'analyste : l'alignement n'a pas à être parfait, et les petits écarts que la critique ne relève pas ne sont pas ton affaire. +Les suggestions de la critique (partie 5), avec leurs exemples ; la comparaison (partie 3) pour le détail. Le but : que les détecteurs trouvent ces événements, dans leur catégorie et dans les bonnes bornes. Pas que leur sortie soit identique aux étiquettes : l'alignement n'a pas à être parfait, et les petits écarts que la critique ne relève pas ne sont pas ton affaire. **Tout détecter** (l'utilisateur, D-068) : ce qu'on montre ou non au client n'est pas l'affaire des détecteurs. Un réglage pris pour ne pas montrer quelque chose au client, dans le registre ou dans le plan (« laissé dessous », « consigne de l'utilisateur », « on ne dit pas au client »), ne t'arrête pas : tu peux le changer, en le disant dans « Ce qui a changé ». @@ -49,7 +49,7 @@ La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de comp **Sur le lot**, c'est toi seul qui vérifies : le contrôle des détecteurs ne le regarde pas. Lance la commande du lot avec `2>&1`, **avant** de modifier et **après**. Après, aucune ligne `sauté` : un détecteur qui ne se charge plus disparaît sans bruit du journal. Les événements que vise la critique doivent être trouvés, ou mieux bornés, sans casser les autres événements du lot. -Puis le **score**, un contrôle et non un but : `python3 .claude/skills/events-learner/score.py `, face au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. La catégorie en cause doit s'améliorer sur ce lot, sans qu'un événement entier soit perdu ou signalé à tort ailleurs. Un trou n'a pas de mesure, donc pas de case au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'analyste). Ne vise pas 100 %. +Puis le **score**, un contrôle et non un but : `python3 .claude/skills/events-learner/score.py --du --au ` (les bornes du lot), face au score avant. Il compare, instant par instant et par famille (`labeling/familles.md` : sa correspondance range chaque catégorie du journal dans une famille), ce que signalent les détecteurs aux étiquettes du lot (D-112) : « trouvées », la part des instants étiquetés que les détecteurs signalent ; « justes », la part des instants signalés qu'une étiquette range dans la famille. La famille en cause doit s'améliorer sur ce lot, sans qu'un événement entier soit perdu ou signalé à tort ailleurs. Un trou n'a pas de mesure, donc pas d'instant au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'étiquette). Ne vise pas 100 %. Puis le **benchmark**, `python3 .claude/skills/events-learner/benchmark.py 2>&1` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. C'est sur lui que le contrôle des détecteurs jugera ta modification : il compare les détecteurs au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`, D-069), les cas de régression. Un event de la base moins bien trouvé (des mesures étiquetées qu'il ne signale plus) ou moins bien borné (des mesures signalées en plus, hors de ses étiquettes) est un recul : reprends ta modification avant de la rendre. E-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. Une hausse est un plus, **pas un but** : ne règle rien pour un event précis. Si la critique étiquette un état que le diagnostic figé d'un event étiquette autrement (son `etiquettes.json`, son `etiquetage.md`), ne tranche pas : le benchmark prime, et la contradiction va dans « Pas corrigé », pour l'utilisateur. diff --git a/.claude/skills/analyser-lot/SKILL.md b/.claude/skills/analyser-lot/SKILL.md index b46c4fc..d5d7760 100644 --- a/.claude/skills/analyser-lot/SKILL.md +++ b/.claude/skills/analyser-lot/SKILL.md @@ -1,6 +1,6 @@ --- name: analyser-lot -description: Analyser un lot de données de déplacement comme un expert — lire les courbes et les images, trouver et dater chaque événement, l'étiqueter, dire ce que la base d'events en connaît. Suivi par l'analyste de /events-learner (et par /new-event pour les étiquettes d'un event), ou à la main sur un lot. +description: Analyser un lot de données de déplacement comme un expert — lire les courbes et les images, trouver et dater chaque événement, l'étiqueter, dire ce que la base d'events en connaît. Suivi par l'analyste (par /new-event pour les étiquettes d'un event), ou à la main sur un lot ; /events-learner lit désormais les étiquettes de l'etiqueteur (D-112). argument-hint: " [commande du lot]" --- diff --git a/.claude/skills/events-learner/SKILL.md b/.claude/skills/events-learner/SKILL.md index f8fcc65..d51d61e 100644 --- a/.claude/skills/events-learner/SKILL.md +++ b/.claude/skills/events-learner/SKILL.md @@ -1,65 +1,61 @@ --- name: events-learner -description: Séance automatique d'amélioration des détecteurs du journal du matin et de la base d'events, sur un lot d'une station, la plage choisie par l'utilisateur (D-057) — analyste, tool-builder, detectors-critic, detectors-upgrader, detectors-control, event-builder. Lancé par l'utilisateur seulement, avec /events-learner. +description: Séance automatique d'amélioration des détecteurs du journal du matin, sur un lot d'une station déjà étiqueté par l'etiqueteur (labeling/auto/), la plage choisie par l'utilisateur (D-057, D-112) — detectors-critic, detectors-upgrader, detectors-control. Lancé par l'utilisateur seulement, avec /events-learner. disable-model-invocation: true argument-hint: "data/ [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]" --- # events-learner : la boucle automatique -Tu es l'orchestrateur. Tu appelles les six agents dans l'ordre, tu transmets leurs rendus et tu commites ; en fin de séance, le releveur note leurs difficultés. **Tu ne juges rien toi-même** : tu lis seulement les lignes de verdict. **Tu ne poses aucune question à l'utilisateur** : la séance tourne seule jusqu'au bout. Spec : `vues-deplacements/contexte/events-learner.md`. +Tu es l'orchestrateur. La vérité de la séance, ce sont les étiquettes du lot, écrites en amont par l'`etiqueteur` dans `labeling/auto/.jsonl` (D-106, D-112) ; tu appelles les trois agents dans l'ordre, tu transmets leurs rendus et tu commites ; en fin de séance, le releveur note leurs difficultés. **Tu ne juges rien toi-même** : tu lis seulement les lignes de verdict. **Tu ne poses aucune question à l'utilisateur** : la séance tourne seule jusqu'au bout. Spec : `vues-deplacements/contexte/events-learner.md`. ## 1. Mise en place - Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne `data//` (D-065) ; `--du`, `--au` (jours UTC, facultatifs : sans eux, toute la période ; **`--au` est exclu** : la plage s'arrête à `--au` 00:00Z, `--du 2026-09-01 --au 2026-09-05` fait 4 jours) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). **La plage est le lot** (D-072) : une séance traite un seul lot, de la longueur que l'utilisateur a choisie par `--du` / `--au`, sans découpe ; un `--lot` ou `--tranche` donné quand même est ignoré (note-le sous « Erreurs »). Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme `--du` puis `--au` ; une option entre crochets (`[--ameliorer]`, la syntaxe d'usage recopiée) vaut l'option sans crochets ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net. - `python3 agent-tools/inventaire.py ` : dossier absent ou sans export « advanced », dis-le et arrête-toi. - `STATION` = le nom du dossier de station (`NORDEND`) ; `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`. -- La séance se commite directement sur `master` (D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi (pas de `git switch` : une autre session peut travailler dans ce dépôt). Note la **base de la séance** : `git rev-parse HEAD`. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin. Une autre session peut travailler dans le même dépôt pendant la séance (fichiers modifiés, index déjà chargé, même ce skill) : `git commit -- ` ne prend que tes chemins ; n'indexe rien d'autre, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins ; garde les consignes lues au début et note le changement dans tes difficultés. Le commit par chemin ne protège pas un fichier que tu commites toi-même : note donc, au début, les fichiers déjà modifiés sur les chemins que la séance commite ou fait tourner, `git status --porcelain -- detectors/ vues-deplacements/contexte/seuils-du-journal.md agent-diagnostic/ .claude/skills/anonymize-event/registre.csv agent-tools/ .claude/skills/lire-les-donnees/` ; s'il y en a, liste-les au bilan sous « Erreurs » (les mesures tournent sur eux), ne les commite pas et ne les annule pas : aux étapes 2, 4 et 5 (outils, `annuler`), donne tes chemins fichier par fichier, sans eux (`git diff --name-only HEAD -- ` liste ceux de la séance). +- La séance se commite directement sur `master` (D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi (pas de `git switch` : une autre session peut travailler dans ce dépôt). Note la **base de la séance** : `git rev-parse HEAD`. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin. Une autre session peut travailler dans le même dépôt pendant la séance (fichiers modifiés, index déjà chargé, même ce skill) : `git commit -- ` ne prend que tes chemins ; n'indexe rien d'autre, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins ; garde les consignes lues au début et note le changement dans tes difficultés. Le commit par chemin ne protège pas un fichier que tu commites toi-même : note donc, au début, les fichiers déjà modifiés sur les chemins que la séance commite ou fait tourner, `git status --porcelain -- detectors/ vues-deplacements/contexte/seuils-du-journal.md agent-tools/ labeling/auto/` ; s'il y en a, liste-les au bilan sous « Erreurs » (les mesures tournent sur eux), ne les commite pas et ne les annule pas : à l'étape 4 (`annuler`) et au §4, donne tes chemins fichier par fichier, sans eux (`git diff --name-only HEAD -- ` liste ceux de la séance). - Dossier de séance : `events-learner/_/`, ci-dessous ``. -## 2. Le lot +## 2. Le lot et ses étiquettes -Un seul lot, numéroté `01` (`NN` ci-dessous) : de `--du` 00:00Z (sinon le premier jour de la « Période des mesures » de l'inventaire, 00:00Z) à `--au` 00:00Z (sinon la fin de cette période). Une date qui déborde cette période y est ramenée (`--du` au premier jour de la période, `--au` au lendemain de son dernier jour), dans les bornes du lot comme dans sa commande, et dite sous « Erreurs » du bilan : hors de la période, il n'y a rien à lire ni à étiqueter. Dossier du lot : `/lot-01/`, ci-dessous ``. +Un seul lot, numéroté `01` (`NN` ci-dessous) : de `--du` 00:00Z (sinon le premier jour de la « Période des mesures » de l'inventaire, 00:00Z) à `--au` 00:00Z (sinon la fin de cette période). Une date qui déborde cette période y est ramenée (`--du` au premier jour de la période, `--au` au lendemain de son dernier jour), dans les bornes du lot comme dans sa commande, et dite sous « Erreurs » du bilan : hors de la période, il n'y a rien à lire. Dossier du lot : `/lot-01/`, ci-dessous ``. **Commande du lot**, donnée telle quelle aux agents : `python3 detectors/categories.py `, plus `--du` et `--au` s'ils sont donnés. Exemple : `--du 2026-10-05 --au 2026-10-09`. +**Les étiquettes du lot** : les lignes de `labeling/auto/.jsonl` qui touchent la plage, écrites avant la séance par l'`etiqueteur` (`@etiqueteur data/ du au `, lancé par l'utilisateur) : une étiquette par anomalie vue sur `corr_x` et `corr_y`, sa famille (`labeling/familles.md`) et sa description ; un instant sans étiquette veut dire que les courbes corrigées n'y montrent rien (D-111). Contrôle : `python3 .claude/skills/events-learner/score.py --du --au ` (les bornes du lot) ; s'il sort en erreur (« Aucune étiquette »), dis-le et arrête-toi, sans commit : le lot est à étiqueter d'abord. Tu ne modifies jamais ce fichier. + ## 3. Le lot, dans l'ordre Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demande ci-dessous, rien d'autre. Un verdict se lit par `grep '^\*\*Verdict\*\* :' `. Chaque commit se fait par chemin, `git add && git commit -m "" -- `, après `git branch --show-current` : une autre session peut changer de branche pendant la séance ; si ce n'est plus `master`, ne commite plus rien (pas de `git switch`), passe au bilan, écrit sans commit, et note la branche trouvée sous « Erreurs ». Son message se termine par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 `. -1. **Analyste** (`analyste`) : `Dossier : . Lot NN : → (UTC). Commande du lot : . Écris /analyse.md.` - `python3 .claude/skills/analyser-lot/etiquettes.py /etiquettes.json` : sa dernière ligne va au bilan (colonne Étiquettes : « n moments », « absentes » ou « n défauts ») ; tu ne corriges rien et ne relances pas l'analyste pour elles (D-061). - Commit `/`, message `Learn lot NN: analysis`. -2. **Tool-builder** (`tool-builder`), à chaque lot : il lit la section « Outils » de l'analyse et améliore les outils de lecture, sans en retirer (D-097) : `Dossier : . Lot NN : → (UTC). Analyse : /analyse.md. Écris /tool-builder.md.` - Sa ligne `grep '^\*\*Outils modifiés\*\* :' /tool-builder.md` va au bilan (colonne Outils). Commit de `/` et des chemins que `git status --porcelain -- agent-tools/ .claude/skills/lire-les-donnees/` montre, sans les fichiers notés au début (§1), message `Learn lot NN: tools ()`. Score et benchmark se calculent après lui : les détecteurs lisent par `agent-tools/donnees.py`, et toutes les mesures de la séance portent ainsi sur la même lecture. - `python3 .claude/skills/events-learner/score.py > /score-avant.txt 2>&1` : le score des détecteurs du début du lot sur toutes les étiquettes de la station, ce lot compris (D-062). +1. **Score et benchmark avant.** + `python3 .claude/skills/events-learner/score.py --du --au > /score-avant.txt 2>&1` : les détecteurs du début de séance face aux étiquettes du lot, par famille et par instant (D-112). `python3 .claude/skills/events-learner/benchmark.py --seance --etape "lot-NN avant" > /benchmark-avant.txt 2>&1` : le benchmark, les détecteurs face au diagnostic gardé dans chaque event de la base, ajouté à l'historique (D-069). Commit `/ vues-deplacements/benchmark/historique.csv`, message `Learn lot NN: score and benchmark`. -3. **Detectors-critic** (`detectors-critic`), qui juge les détecteurs face à l'analyse, sans regarder les données (D-090) : `Dossier : . Lot NN : → (UTC). Commande du lot : . Analyse : /analyse.md. Score avant : /score-avant.txt. Écris /critique.md.` +2. **Detectors-critic** (`detectors-critic`), qui juge les détecteurs face aux étiquettes, sans regarder les données (D-090) : `Dossier : . Lot NN : → (UTC). Commande du lot : . Étiquettes : labeling/auto/.jsonl, celles qui touchent le lot. Score avant : /score-avant.txt. Écris /critique.md.` Commit `/`, message `Learn lot NN: critique ()`. - Verdict `d'accord` : va à l'étape 6. -4. **Detectors-upgrader** (`detectors-upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`. + Verdict `d'accord` : va au bilan (§5). +3. **Detectors-upgrader** (`detectors-upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`. `Dossier : . Lot NN : → (UTC). Commande du lot : . Critique : /critique.md. Score avant : /score-avant.txt. Benchmark avant : /benchmark-avant.txt. [Contrôle précédent : /validation-(K-1).md.] Passage K. Écris /modification-K.md.` Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md /`, message `Learn lot NN: modification K`. Puis, les détecteurs commités : `python3 .claude/skills/events-learner/benchmark.py --seance --etape "lot-NN modification K" > /benchmark-K.txt 2>&1` (commité avec la validation). -5. **Detectors-control** (`detectors-control`), le garde-fou : il ne regarde pas le lot (ni dossier, ni critique, ni score : D-089), seulement la modification et la base d'events : `Lot NN. Modification : /modification-K.md. Benchmark : /benchmark-avant.txt → /benchmark-K.txt. Base : . Passage K sur 3. Écris /validation-K.md.` +4. **Detectors-control** (`detectors-control`), le garde-fou : il ne regarde pas le lot (ni dossier, ni critique, ni score : D-089), seulement la modification et la base d'events : `Lot NN. Modification : /modification-K.md. Benchmark : /benchmark-avant.txt → /benchmark-K.txt. Base : . Passage K sur 3. Écris /validation-K.md.` Commit `/ vues-deplacements/benchmark/historique.csv`, message `Learn lot NN: control K ()`. - - `accepté` ou `garder` : va à l'étape 6. - - `à reprendre` : retour à l'étape 4, passage K + 1. + - `accepté` ou `garder` : va au bilan (§5). + - `à reprendre` : retour à l'étape 3, passage K + 1. - `annuler` : `git checkout -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, commit de ces deux chemins, message `Learn lot NN: modification annulée`. -6. **Event-builder** (`event-builder`), à chaque lot : il décide seul, face à la base d'events, ce que l'analyse lui apprend de nouveau (D-091) : `Dossier : . Lot NN : → (UTC). Analyse : /analyse.md. Dossier du lot : /. Séance : /. Écris /builder.md.` - Si sa ligne `**Events créés** :` n'est pas `aucun` : commit `events/ .claude/skills/anonymize-event/registre.csv /`, message `Learn lot NN: events E-xxx, …` ; sinon commit `/`, message `Learn lot NN: event-builder (aucun event)`. -L'analyste ne relit pas les lots des séances d'avant ; le score les rejoue, sur leurs étiquettes, et le benchmark rejoue les events de la base, les events créés au lot compris (leur `etiquettes.json`). +Le score ne compte que ce lot ; le benchmark rejoue les events de la base, les cas de régression. ## 4. Imprévus -Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pour le bilan ; si les détecteurs ont changé depuis la base du lot, remets-les comme pour `annuler` ; passe au bilan. Seule exception, le tool-builder : sans rendu ou sans ligne « Outils modifiés », remets les outils tels qu'avant lui, fichier par fichier, sans les fichiers notés au début (`git checkout HEAD -- ` pour ceux que `git diff --name-only HEAD -- agent-tools/ .claude/skills/lire-les-donnees/` liste), commite `/` et continue au score et au benchmark. Ne relance pas un agent plus d'une fois. +Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pour le bilan ; si les détecteurs ont changé depuis la base du lot, remets-les comme pour `annuler` ; passe au bilan. Ne relance pas un agent plus d'une fois. ## 5. Bilan -`python3 .claude/skills/events-learner/score.py > /score-fin.txt 2>&1` : le score des détecteurs de fin de séance sur toutes les étiquettes de la station. -Pas de benchmark de fin de séance : celui des détecteurs de fin est le dernier du lot, sur les mêmes events que celui du début ; les events créés par l'event-builder se mesurent à la séance suivante (D-092). +`python3 .claude/skills/events-learner/score.py --du --au > /score-fin.txt 2>&1` : le score des détecteurs de fin de séance sur les mêmes étiquettes. +Pas de benchmark de fin de séance : celui des détecteurs de fin est le dernier du lot, sur les mêmes events que celui du début (D-092). `/bilan.md` : @@ -68,22 +64,21 @@ Pas de benchmark de fin de séance : celui des détecteurs de fin est le dernier Commits : sur `master`, depuis (`git log --oneline ..HEAD`) -Score : au début du lot `lot-01/score-avant.txt`, en fin de séance `score-fin.txt` (D-062). +Étiquettes : `labeling/auto/.jsonl`, sur le lot (première ligne de `lot-01/score-avant.txt`). + +Score, par famille et par instant (D-112) : au début du lot `lot-01/score-avant.txt`, en fin de séance `score-fin.txt`. Benchmark sur la base d'events (D-069) : au début du lot `lot-01/benchmark-avant.txt`, après chaque modification `lot-01/benchmark-K.txt` ; historique `vues-deplacements/benchmark/historique.csv`. Total, sur les mêmes events : → . -Page : `out/events-learner__.html`, l'analyste face aux détecteurs sur toute la plage (D-066) ; la refaire : `python3 .claude/skills/events-learner/comparaison.py `. +Page : `out/events-learner__.html`, les étiquettes face aux détecteurs, famille par famille (D-066) ; la refaire : `python3 .claude/skills/events-learner/comparaison.py --du --au `. -| Lot | Dates (UTC) | Outils | Critique | Étiquettes | Modification | Events créés | -|---|---|---|---|---|---|---| -| 01 | … → … | aucun / fichiers modifiés (`donnees.py` dit à part) / erreur | d'accord / suggestions (n) | n moments / absentes / n défauts | aucune / gardée (K passages) / annulée / erreur | E-xxx / aucun | +| Lot | Dates (UTC) | Étiquettes | Critique | Modification | +|---|---|---|---|---| +| 01 | … → … | n | d'accord / suggestions (n) | aucune / gardée (K passages) / annulée / erreur | ## Suggestions non traitées <« Pas corrigé » des modifications ; suggestions d'un lot sans modification gardée> -## Contradictions avec la base - - ## Erreurs aucune | ``` @@ -95,10 +90,10 @@ Commit `/bilan.md /score-fin.txt`, message `Learn : b **Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /events-learner (.claude/skills/events-learner/SKILL.md). Séance : / : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | .` (D-060) Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Learn : process difficulties`. -**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /events-learner. Commit du releveur : .`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, `.claude/skills/events-learner/ .claude/skills/analyser-lot/ .claude/agents/analyste.md .claude/agents/tool-builder.md .claude/agents/detectors-critic.md .claude/agents/detectors-upgrader.md .claude/agents/detectors-control.md .claude/agents/event-builder.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/events-learner.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Learn : process fixes`. Garde la suite de ce skill telle que tu l'as lue au début. +**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /events-learner. Commit du releveur : .`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, `.claude/skills/events-learner/ .claude/agents/detectors-critic.md .claude/agents/detectors-upgrader.md .claude/agents/detectors-control.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/events-learner.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Learn : process fixes`. Garde la suite de ce skill telle que tu l'as lue au début. ## 7. Réponse finale -`python3 .claude/skills/events-learner/comparaison.py ` : la page de fin de séance, `out/events-learner__.html`, qui s'ouvre dans le navigateur (D-066). C'est la page de `python3 detectors-view/detecteurs.py --du --au ` sur la plage de la séance (images de la caméra et timelapse d'un événement au clic, pose de la caméra, `corr_x` et `corr_y` de chaque capteur, ligne « Error rate »), chaque ligne de catégorie dédoublée : la lecture de l'analyste (ses étiquettes) au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, et en gris ses moments hors catégorie ; sous la figure, la liste des événements, le score de la séance et le benchmark sur la base d'events. Le but, séance après séance : que les deux coïncident. Un échec du script va dans la réponse, sans relance. +`python3 .claude/skills/events-learner/comparaison.py --du --au ` : la page de fin de séance, `out/events-learner__.html`, qui s'ouvre dans le navigateur (D-066). C'est la page de `python3 detectors-view/detecteurs.py --du --au ` sur la plage de la séance (images de la caméra et timelapse d'un événement au clic, pose de la caméra, `corr_x` et `corr_y` de chaque capteur, ligne « Error rate »), une ligne par famille des étiquettes, dédoublée : les étiquettes du lot au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, rangés dans la famille de leur catégorie ; sous la figure, la liste des événements, le score de la séance et le benchmark sur la base d'events. Le but, séance après séance : que les deux coïncident. Un échec du script va dans la réponse, sans relance. -En 8 lignes au plus : la page, la base de la séance, le chemin du bilan, le benchmark (ligne `total` / `toutes`, `grep -E '^total +toutes'`, du début du lot à la modification gardée), le nombre de modifications gardées et d'events créés, le nombre d'étiquettes (`/lot-*/etiquettes.json`, à garder même si l'utilisateur annule des modifications : elles ne dépendent pas des détecteurs), les erreurs, les difficultés relevées et, avec `--ameliorer`, celles corrigées. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`. +En 7 lignes au plus : la page, la base de la séance, le chemin du bilan, le nombre d'étiquettes du lot, le benchmark (ligne `total` / `toutes`, `grep -E '^total +toutes'`, du début du lot à la modification gardée), le nombre de modifications gardées, les erreurs, les difficultés relevées et, avec `--ameliorer`, celles corrigées. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`. diff --git a/.claude/skills/events-learner/comparaison.py b/.claude/skills/events-learner/comparaison.py index 52abf7c..40e2107 100644 --- a/.claude/skills/events-learner/comparaison.py +++ b/.claude/skills/events-learner/comparaison.py @@ -1,20 +1,16 @@ -"""Page de fin de séance de /events-learner : la lecture de l'analyste face aux détecteurs, sur toute la plage de la séance. +"""Page de fin de séance de /events-learner : les étiquettes de l'étiqueteur face aux détecteurs, sur la plage de la séance. La page de detectors-view/detecteurs.py (images de la caméra, timelapse d'un événement au clic, pose de la caméra, corr_x et corr_y de -chaque capteur en couleur, ligne « Error rate »), chaque ligne de catégorie dédoublée : en haut les moments de l'analyste -(etiquettes.json des lots de la séance), en bas les événements des détecteurs tels qu'ils sont (la plage classée avec ses -3 jours d'historique, comme le score). En dernier, en gris, 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é). Sous la figure, la liste des -événements des détecteurs, le score de la séance (score.py sur ses seules étiquettes) et le benchmark. Faire coïncider -les deux barres de chaque ligne, séance après séance, c'est le but de la boucle. -Usage : python3 .claude/skills/events-learner/comparaison.py - (page : out/events-learner_.html, ouverte dans le navigateur) +chaque capteur en couleur, ligne « Error rate »), une ligne par famille des étiquettes (labeling/familles.md), dédoublée : +en haut les étiquettes de labeling/auto/.jsonl qui touchent la plage, en bas les événements des détecteurs tels +qu'ils sont (la plage classée avec ses 3 jours d'historique, comme le score), rangés par la correspondance de familles.md ; +un saut bref, dont la famille est celle de sa cause, garde sa ligne (D-112). Sous la figure, la liste des événements des +détecteurs, le score de la séance (score.py --du --au) et le benchmark. Faire coïncider les deux barres de chaque ligne, +séance après séance, c'est le but de la boucle. +Usage : python3 .claude/skills/events-learner/comparaison.py --du AAAA-MM-JJ --au AAAA-MM-JJ + (--au exclu ; page : out/events-learner_.html, ouverte dans le navigateur) """ -import contextlib -import glob import html -import io -import json import os import sys @@ -35,60 +31,53 @@ def tableau(total, ordre, titre="Catégorie"): lignes = "".join(f"{NIVEAUX.get(k, k)}{total[k][0]}" f"{total[k][1]}{part(total[k][2], total[k][0])}{part(total[k][2], total[k][1])}" for k in cles) - return (f"" + return (f"
{titre}Vues par l'analysteSignalées par les détecteurs
" "" + lignes + "
{titre}ÉtiquetéesSignalées par les détecteursTrouvéesConfirmées
") -def page(dossier, seance): +def page(dossier, seance, du, au): """La page de detecteurs.py sur la plage de la séance (images, timelapse, pose de la caméra, capteurs en couleur), - plus les moments de l'analyste, le score de la séance et le benchmark.""" - chemins = sorted(glob.glob(os.path.join(seance, "lot-*", "etiquettes.json"))) - if not chemins: - sys.exit(f"{seance} : aucun lot-*/etiquettes.json") - lots = [] - for c in chemins: - with open(c, encoding="utf-8") as f: - lots.append(json.load(f)) - debut, fin = min(x["debut"] for x in lots), max(x["fin"] for x in lots) - agent = [(m["debut"], m["fin"], c := HORS if m["categorie"] == "aucune" else m["categorie"], - survol(f"Analyste : {c}", m["debut"], m["fin"], m["capteurs"], - f"{m['evenement'] or '—'} ({m['preuve']})", m["description"])) - for x in lots for m in x["moments"]] + plus les étiquettes de l'étiqueteur, le score de la séance et le benchmark.""" + debut, fin = score.iso(score.instant(du)), score.iso(score.instant(au)) + total, etiq = score.familles_lot(dossier, debut, fin) + if not etiq: + sys.exit(f"Aucune étiquette de {os.path.basename(os.path.normpath(dossier))} sur {debut} → {fin} dans labeling/auto/.") + agent = [(e["debut"], e["fin"], c := HORS if e.get("categorie") == "aucune" else e.get("categorie", "sans famille"), + survol(f"Étiquette : {c}", e["debut"], e["fin"], ["dans le texte"], e["description"])) for e in etiq] - with contextlib.redirect_stdout(io.StringIO()): # le détail par lot : lot-NN/score-avant.txt et score-fin.txt - total = score.lots(dossier, chemins, True) events, _ = benchmark.mesurer() bench = {c: n[benchmark.TOUTES] for c, n in events.items()} - ordre = [*score.categories.CATEGORIES, HORS] + lignes = score.familles() + ordre = [*dict.fromkeys(lignes.values()), HORS] nom = os.path.basename(os.path.normpath(seance)) entete = f"""

Séance {html.escape(nom)}

-

Dessous les courbes, chaque ligne est une catégorie du journal : la barre du haut est la lecture de l'analyste -(étiquettes des {len(lots)} lot(s) de la séance), celle du bas, les événements des détecteurs dans leur état de fin de -séance. En dernier, en gris, ce que l'analyste a vu hors des catégories du journal : sans effet sur les courbes le plus -souvent, ou une nouveauté ; aucun détecteur ne peut le rejoindre. Survol : capteurs, preuve, description ; un clic sur une -barre, de l'analyste ou des détecteurs, joue son timelapse. Le but de la boucle : que les deux barres de chaque ligne coïncident.

""" +

Dessous les courbes, chaque ligne est une famille des étiquettes (labeling/familles.md) : la barre du haut, +les {len(etiq)} étiquettes de l'étiqueteur qui touchent la plage (labeling/auto/), celle du bas, les événements +des détecteurs dans leur état de fin de séance, rangés dans la famille de leur catégorie (survol : la catégorie du +journal). Un saut bref, de la famille de sa cause, garde sa ligne. Survol : bornes, description ; un clic sur une barre, des +étiquettes ou des détecteurs, joue son timelapse. Le but de la boucle : que les deux barres de chaque ligne coïncident.

""" annexe = f"""

Score de la séance

-

On compte des mesures : une mesure, c'est un capteur à un instant. -Trouvées : de ce que l'analyste range dans la catégorie, la part que les détecteurs signalent aussi ; le reste, ils -l'ont raté. Confirmées : de ce que signalent les détecteurs, la part que l'analyste range aussi dans la catégorie ; -le reste, ce sont des alertes en trop, ou un oubli de l'analyste. Le but : 100 % dans les deux colonnes ; « — » : rien à -compter. Les moments hors catégorie ne comptent pas, ni les trous (pas de mesure). En italique, les catégories regroupées comme sur la page du client : zones grisées, et zones -de prudence (visibilité réduite, turbulence).

-{tableau(total, ordre)} +

On compte des instants : une heure de la plage où un capteur au moins a une mesure ; les étiquettes ne disent leurs +capteurs que dans leur texte. Trouvées : des instants qu'une étiquette range dans la famille, la part que les +détecteurs signalent aussi ; le reste, ils l'ont raté. Confirmées : des instants que signalent les détecteurs, la +part qu'une étiquette range aussi dans la famille ; le reste, ce sont des alertes en trop, ou un oubli de l'étiqueteur. +Un saut bref compte dans la famille de l'étiquette qui le couvre. Le but : 100 % dans les deux colonnes ; « — » : rien à +compter. Les trous ne comptent pas (pas de mesure).

+{tableau(total, ordre, "Famille")}

Benchmark sur la base d'events

Les mêmes détecteurs, face au diagnostic gardé dans chaque event de la base à sa création (ses étiquettes), toutes catégories ensemble. Il garde les détecteurs d'un recul ; il n'est pas un but. Le détail par catégorie : python3 .claude/skills/events-learner/benchmark.py ; dans le temps : {os.path.relpath(benchmark.HISTORIQUE, ROOT)} (version {benchmark.version()}).

{tableau(bench, list(bench), "Event")}""" - return detecteurs.page(dossier, debut, fin, entete=entete, annexe=annexe, analyste=agent, + return detecteurs.page(dossier, debut, fin, entete=entete, annexe=annexe, analyste=agent, lignes=lignes, chemin=os.path.join(ROOT, "out", f"events-learner_{nom}.html")) if __name__ == "__main__": - if len(sys.argv) != 3: + if len(sys.argv) != 7 or sys.argv[3::2] != ["--du", "--au"]: sys.exit(__doc__) - p = page(sys.argv[1], sys.argv[2]) + p = page(sys.argv[1], sys.argv[2], sys.argv[4], sys.argv[6]) print(p) open_served(p) diff --git a/.claude/skills/events-learner/score.py b/.claude/skills/events-learner/score.py index a1074a4..e2ae32e 100644 --- a/.claude/skills/events-learner/score.py +++ b/.claude/skills/events-learner/score.py @@ -10,13 +10,19 @@ Validité d'une case : la pire de ses catégories ; « à ignorer » : les zones section 4) ; « prudence » : visibilité réduite et turbulence ; « fiable » sinon (dilatation, contraction, à vérifier : jamais grisées), et sans catégorie. Un trou n'a pas de mesure, donc pas de case ; un moment « aucune » n'est pas compté. Le score est un fait, pas un verdict : l'analyste peut se tromper aussi. +Avec --du et --au, le score d'un lot de /events-learner (D-112) : les détecteurs face aux étiquettes de l'étiqueteur +(labeling/auto/.jsonl) qui touchent le lot, par famille (labeling/familles.md) et par instant, les étiquettes +ne disant pas leurs capteurs ; les détecteurs passent aux familles par la correspondance de familles.md, un saut bref +prend la famille de l'étiquette qui le couvre. Aucune étiquette sur le lot : sortie en erreur. Usage : python3 .claude/skills/events-learner/score.py [etiquettes.json ...] (défaut : events-learner/*/lot-*/etiquettes.json de la station) + python3 .claude/skills/events-learner/score.py --du AAAA-MM-JJ --au AAAA-MM-JJ python3 .claude/skills/events-learner/score.py --test """ import glob import json import os +import re import sys from datetime import timedelta from pathlib import Path @@ -34,6 +40,8 @@ IGNORER = {"visibilite_nulle", "passage", "cible_masquee", "cible_degradee", "sa # journal) ; un champ de force dans les étiquettes si cet écart compte PRUDENCE = {"visibilite_reduite", "turbulence"} NIVEAUX = ("à ignorer", "prudence") +FAMILLES = os.path.join(RACINE, "labeling", "familles.md") +CAUSES_SAUT = {"obstruction", "visibilite", "deplacement"} # saut_bref : la famille de sa cause (familles.md, frontières) def validite(cats): @@ -67,17 +75,60 @@ def detectes(mesures, debut, fin): return [(v["start"], v["end"], v["sensors"], v["category"]) for v in evenements(mesures, debut, fin)] -def score(etiq, det): - """{case: catégories de l'analyste}, {case: catégories des détecteurs} -> {clé: [étiquetées, signalées, les deux]}.""" +def compter(paires): + """[(clés étiquetées, clés signalées)], une paire par case -> {clé: [étiquetées, signalées, les deux]}.""" n = {} - for c in etiq: - a, d = [x | {v} if (v := validite(x)) else x for x in (etiq[c], det[c])] + for a, d in paires: for k in a | d: x = n.setdefault(k, [0, 0, 0]) x[0], x[1], x[2] = x[0] + (k in a), x[1] + (k in d), x[2] + (k in a and k in d) return n +def score(etiq, det): + """{case: catégories de l'analyste}, {case: catégories des détecteurs} -> {clé: [étiquetées, signalées, les deux]}.""" + return compter([x | {v} if (v := validite(x)) else x for x in (etiq[c], det[c])] for c in etiq) + + +def familles(): + """labeling/familles.md -> {catégorie du journal: famille}, sa correspondance ; saut_bref n'y a pas de famille fixe.""" + corr = {} + for part in open(FAMILLES, encoding="utf-8").read().split("## Correspondance")[1].split(" ; "): + gauche, _, droite = part.partition("→") + if f := re.findall(r"`(\w+)`", droite): + corr |= dict.fromkeys(re.findall(r"`(\w+)`", gauche), f[0]) + return corr + + +def etiquettes_auto(station, debut, fin): + """labeling/auto/.jsonl -> les étiquettes de l'étiqueteur qui touchent [début, fin).""" + chemin = os.path.join(RACINE, "labeling", "auto", f"{station}.jsonl") + if not os.path.exists(chemin): + return [] + with open(chemin, encoding="utf-8") as f: + return [e for e in map(json.loads, filter(str.strip, f)) if e["debut"] < fin and e["fin"] >= debut] + + +def familles_lot(dossier, debut, fin, etiq=None): + """Score d'un lot par famille et par instant (D-112) -> ({famille: [étiquetés, signalés, les deux]}, étiquettes). + Un instant : une heure du lot où un capteur au moins a une mesure ; il reçoit les familles des étiquettes qui le + couvrent, bornes comprises, et celles des événements des détecteurs. etiq : les étiquettes, sinon labeling/auto/.""" + # ponytail: par instant et non par capteur, les étiquettes ne disent leurs capteurs que dans le texte ; un champ + # capteurs dans l'étiquette, si cette finesse manque + mesures, corr = charger(dossier), familles() + if etiq is None: + etiq = etiquettes_auto(os.path.basename(os.path.normpath(dossier)), debut, fin) + evts = evenements(mesures, debut, fin) + paires = [] + for t in sorted({t for _, t in cases(mesures, debut, fin)}): + a = {e.get("categorie", "sans famille") for e in etiq if e["debut"] <= t <= e["fin"]} - {"aucune"} + d = {corr.get(v["category"], v["category"]) for v in evts if v["start"] <= t <= v["end"]} + if "saut_bref" in d: + d = d - {"saut_bref"} | (a & CAUSES_SAUT or {"saut_bref"}) + paires.append((a, d)) + return compter(paires), etiq + + def pct(a, b): return f"{a}/{b} ({round(100 * a / b)} %)" if b else "—" @@ -144,12 +195,27 @@ def test(): assert ajout == [len(cs), 0, 0], ajout assert validite({"visibilite_reduite", "visibilite_nulle"}) == "à ignorer" assert validite({"dilatation_thermique", "a_verifier"}) is None + # par famille (D-112) : chaque catégorie du journal a sa famille, sauf saut_bref ; les événements des détecteurs pris + # pour étiquettes, sauts brefs à part, donnent chaque famille trouvée et juste en entier + corr = familles() + assert set(categories.CATEGORIES) - set(corr) == {"saut_bref"}, corr + etiq = [{"debut": v["start"], "fin": v["end"], "categorie": corr[v["category"]]} + for v in evenements(mesures, debut, fin) if v["category"] != "saut_bref"] + n, _ = familles_lot(os.path.join(RACINE, "vues-deplacements", "cas", "2026-10_NORDEND", "NORDEND"), debut, fin, etiq) + assert n and all(x[0] == x[1] == x[2] for k, x in n.items() if k != "saut_bref"), n print("test : bon") if __name__ == "__main__": if sys.argv[1:] == ["--test"]: test() + elif len(sys.argv) == 6 and sys.argv[2::2] == ["--du", "--au"]: + station, du, au = os.path.basename(os.path.normpath(sys.argv[1])), iso(instant(sys.argv[3])), iso(instant(sys.argv[5])) + n, etiq = familles_lot(sys.argv[1], du, au) + if not etiq: + sys.exit(f"Aucune étiquette de {station} sur {du} → {au} dans labeling/auto/{station}.jsonl : " + "étiqueter le lot d'abord (@etiqueteur).") + afficher(f"{station} : {du} → {au}, {len(etiq)} étiquettes de labeling/auto/{station}.jsonl, par famille et par instant", n) elif len(sys.argv) >= 2: explicites = sys.argv[2:] tous = sorted(glob.glob(os.path.join(RACINE, "events-learner", "*", "lot-*", "etiquettes.json"))) diff --git a/CLAUDE.md b/CLAUDE.md index 7d621e6..8c718ef 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,14 +12,14 @@ Cadrage du product owner : sous-projet G, santé des sites et notifications au c - **Domaines système, livrés en prototype** : Energy (D-020, D-043), Storage (D-034, D-035), Cellular (D-031, D-037), Temperature (D-040) ; chacun avec ses analyses, sa couleur du jour, sa figure du site, son bloc dans la vue client, sa notification support et son guide (D-039, D-041). Seul Energy repose sur des events de l'expert ; les autres ont des seuils provisoires et attendent le spécialiste. - **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025). -- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/events-learner` (D-057), base d'events `events/` revue par `/review-event` (D-075). Rôles de `/events-learner` revus le 2026-10-29, un agent par responsabilité (D-088 à D-092, D-097) : l'analyste analyse, avec ses propres scripts au besoin, le `tool-builder` optimise ou ajoute les outils de lecture d'après ceux qui lui ont servi (`/aiguiser` retiré), le `detectors-critic` juge les détecteurs, le `detectors-upgrader` les adapte, le `detectors-control` garde la base d'events, l'`event-builder` décide ce qui y entre ; la carte des événements apprend de chaque event validé (D-087). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`. +- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/events-learner` (D-057), base d'events `events/` revue par `/review-event` (D-075). `/events-learner` sur les étiquettes (D-112) : l'`etiqueteur` étiquette le lot en amont (`labeling/auto/`), puis le `detectors-critic` juge les détecteurs face à ses étiquettes, par famille, le `detectors-upgrader` les adapte, le `detectors-control` garde la base d'events ; l'analyste, le `tool-builder` et l'`event-builder` (D-088 à D-092, D-097) sont hors de la séance ; la carte des événements apprend de chaque event validé (D-087). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`. - **Support** (D-079) : `/support ` répond à la question d'un client, et à elle seule. Premier cas : LENZSPITZE, nuit du 26 au 27.10. - **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas. - **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale. - **Prochaine étape** : - journal du matin : les points ouverts du plan vivant, sur les consignes de l'utilisateur ; un point validé n'est plus repris ; - les étiquettes de l'expert (`labeling/`, D-098, D-100) : 24, revues avec l'utilisateur par `/review-labels` le 2026-11-02 (D-103), sauf celle de PS_DES_COUDRES, sans données ; rangées par phénomène dans `labeling/carte-des-etiquettes.md` (`/labels-map`, D-104), à revoir par l'utilisateur, puis lue par l'`etiqueteur`, qui étiquette seul un lot (`labeling/auto/`, D-105, D-106) ; puis le premier `/labels-learner` (D-099, point 69 du plan), sur la perte de référence, lancé par l'utilisateur ; - - la première séance de `/events-learner` avec les rôles revus, lancée par l'utilisateur (points 52 à 56 du plan) ; le releveur et l'améliorateur, communs aux processus automatiques, dans une autre conversation ; + - la première séance de `/events-learner` sur les étiquettes de l'étiqueteur, lancée par l'utilisateur sur un lot étiqueté (point 72 du plan, D-112) ; le releveur et l'améliorateur, communs aux processus automatiques, dans une autre conversation ; - les écarts du handoff, dont « consistent with » face aux phrases catégoriques du journal, quand l'utilisateur les arbitre ; - Cellular, Storage, Temperature : les réponses du spécialiste (`docs//domaine/questions-pour-l-expert.md`, pour Temperature la question 1 de `point-de-depart.md`), puis corrections et guides. @@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - `view/` : `view.py`, les images IRON d'une station sous le data loader de la page Status (glisseur, flèches ; molette pour zoomer, glisser pour se déplacer ; case Labels : le nom des cibles et des références). - `events-learner/`, `aiguiser/` : les séances de `/events-learner` et de `/aiguiser`, retiré (D-084, D-097), une par dossier `_/` (`lot-NN/`, `bilan.md`) ; historique, à ne lire que sur demande. - `events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/events-learner` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal, faux amis ; elle apprend de chaque event validé, D-087) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par l'event-builder de `/events-learner`. -- `agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees` ; optimisés ou complétés par le `tool-builder` de `/events-learner` (D-097). +- `agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees` ; optimisés ou complétés par le `tool-builder` (D-097), hors de `/events-learner` depuis D-112. - `agent-diagnostic/` : consignes (`instructions.md`, 146 l) et rapports de l'agent de diagnostic (D-082). Appel : `@agent-diagnostic data// [question]`. - `support/` : un dossier par demande d'un client (D-079), `__/` : `demande.md`, `analyse.md`, `reponse.md` (le mail prêt à envoyer), GIF des images. Contient des mails et images de clients. - `extraction/` : pompage `pomper.py` des données de la plateforme (D-056), en lecture seule, lancé par l'utilisateur dans le dev container de l'application de référence `~/monitoring-dashboard` ; sans argument, il met à jour jusqu'à maintenant les stations de `stations.txt` (D-096) ; mode d'emploi `extraction/README.md`. @@ -121,7 +121,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - Jeux de travail : VERMONT pour Energy (D-009, le plus long historique) ; WEISSHORN pour Storage (D-034) ; WEISSHORN et NORDEND pour Cellular (D-030, D-032) et Temperature (D-040) ; à pomper s'ils manquent. - WEISSHORN et NORDEND contiennent des identifiants (`SIM_CCID`, `ip`, `ip_*`) : ne pas les recopier. - Les données des events restent, codées, dans `events/`. -- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/events-learner` (`analyste`, `tool-builder`, `detectors-critic`, `detectors-upgrader`, `detectors-control`, `event-builder`), `revue` (`/review-event`), `documentaliste` (`/labels-learner`, D-099), `etiqueteur` (étiquettes automatiques, D-106), `releveur` et `ameliorateur` (D-060, D-071) ; `skills/` : `support`, `events-learner`, `analyser-lot`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `labels-learner` (D-099), `review-labels` (D-103), `labels-map` (D-104), `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite). +- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/events-learner` (`detectors-critic`, `detectors-upgrader`, `detectors-control`), `analyste`, `tool-builder` et `event-builder` (hors de la séance depuis D-112), `revue` (`/review-event`), `documentaliste` (`/labels-learner`, D-099), `etiqueteur` (étiquettes automatiques, D-106), `releveur` et `ameliorateur` (D-060, D-071) ; `skills/` : `support`, `events-learner`, `analyser-lot`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `labels-learner` (D-099), `review-labels` (D-103), `labels-map` (D-104), `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite). - `.devcontainer/` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `out/` : pages et JSON générés. - Tout est versionné (D-014), sauf `out/`, `data/`, `.venv/`, `__pycache__/`, `graphify-out/` et `.env`. diff --git a/detectors-view/detecteurs.py b/detectors-view/detecteurs.py index 956d799..6be70b1 100644 --- a/detectors-view/detecteurs.py +++ b/detectors-view/detecteurs.py @@ -1,4 +1,4 @@ -"""Les détecteurs du journal seuls, sur une plage d'un dossier de station : la page de comparaison.py sans l'analyste. +"""Les détecteurs du journal seuls, sur une plage d'un dossier de station : la page de comparaison.py sans les étiquettes. En tête, les images de la caméra sur la plage (glisseur, flèches du clavier ; un clic sur la figure va à l'image la plus proche, une ligne verticale la marque sur la figure). Un clic sur la barre d'un événement des détecteurs, comme sur un bloc @@ -40,7 +40,7 @@ import benchmark # noqa: E402 (la version des détecteurs) import donnees # noqa: E402 AGENT, SCRIPTS = "#2a78d6", "#eb6834" # palette catégorielle de référence, slots 1 et 2 (skill dataviz) -HORS, GRIS = "hors catégorie", "#a3a29c" # moments « aucune » de l'analyste : aucun détecteur ne peut les rejoindre +HORS, GRIS = "hors catégorie", "#a3a29c" # étiquettes « aucune » : aucun détecteur ne peut les rejoindre # du vert au rouge (demande de l'utilisateur, 2026-10-27) : couleurs d'état de la palette de référence (skill dataviz) VERT_ROUGE = ["#0ca30c", "#fab219", "#ec835a", "#d03b3b"] MARGE_PX = 150 # marge autour des capteurs, recadrage du timelapse (comme MARGIN_PX de la maquette Explore) @@ -235,7 +235,7 @@ gd.on('plotly_clickannotation', ev => { // Un clic sur un bloc du Status (l'utilisateur, 2026-10-27), ou sur une barre d'événement (2026-10-28), zoome la plage sur // lui et montre ses détails sous la figure, à gauche, et le timelapse de ses images, marge avant et après comprise, à // droite ; la barre d'un événement des détecteurs ne garde aussi que ses capteurs sur les courbes. -// customdata : [début, fin, nom, détails HTML, capteurs (null : barre de l'analyste)]. +// customdata : [début, fin, nom, détails HTML, capteurs (null : barre d'une étiquette)]. gd.on('plotly_click', ev => { const p = ev.points[0]; if (!p.customdata) return; @@ -440,10 +440,12 @@ def statut(evts, temps, pas, mesures, refs): customdata=[[f"{b[0]:%Y-%m-%d %H:%M:%S}", f"{b[1]:%Y-%m-%d %H:%M:%S}", b[2] or "Aucun événement", b[5], b[6]] for b in blocs]) -def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste=()): +def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste=(), lignes=None): """entete, annexe : HTML ajouté avant et après la figure (page de /review-event) ; chemin : la page, sinon out/detecteurs_… ; - analyste : ses moments [(début, fin, catégorie, survol)], en barres au-dessus de celles des détecteurs, chaque ligne de - catégorie dédoublée (page de fin de séance de /events-learner, comparaison.py).""" + analyste : des étiquettes [(début, fin, ligne, survol)], en barres au-dessus de celles des détecteurs, chaque ligne + dédoublée ; lignes : {catégorie du journal: ligne}, les lignes à la place des catégories, dans l'ordre de leurs valeurs, + une catégorie absente gardant la sienne (page de fin de séance de /events-learner, comparaison.py : les familles des + étiquettes).""" mesures = score.charger(dossier) if not mesures: raise SystemExit(f"Aucun export « advanced » dans {dossier}.") @@ -457,12 +459,13 @@ def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste= refs = references(mesures, a, b) evts = score.evenements(mesures, score.iso(a), score.iso(b)) - spans = [(v["start"], v["end"], v["category"], + spans = [(v["start"], v["end"], (lignes or {}).get(v["category"], v["category"]), survol(v["label"], v["start"], v["end"], v["sensors"], v["text"])) for v in evts] hors = HORS - presentes = {v["category"] for v in evts} | {s[2] for s in analyste} - ordre = [*score.categories.CATEGORIES, *sorted(presentes - set(score.categories.CATEGORIES) - {hors}), *[hors] * (hors in presentes)] - haut = 40 if analyste else 30 # deux barres par ligne avec l'analyste + base = [*dict.fromkeys(lignes.values())] if lignes else list(score.categories.CATEGORIES) + presentes = {s[2] for s in spans} | {s[2] for s in analyste} + ordre = [*base, *sorted(presentes - set(base) - {hors}), *[hors] * (hors in presentes)] + haut = 40 if analyste else 30 # deux barres par ligne avec les étiquettes station = os.path.basename(os.path.normpath(dossier)) nom = f"{station}_{score.iso(a)[:10]}_{score.iso(b)[:10]}" chemin = chemin or os.path.join(ROOT, "out", f"detecteurs_{nom}.html") @@ -473,8 +476,8 @@ def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste= s_, k_ = 3 + c, 4 + c # les lignes du Status et des catégories, sous les courbes hauteurs = [200] * c + [260, 260, 44, haut * len(ordre) + 20, 30] titres = [*["Caméra : pan, tilt, rotation (deg)"] * c, "corr_x (px)", "corr_y (px)", "", - "Classification : analyste (bleu, en haut ; gris : hors catégorie), détecteurs (orange, en bas)" - if analyste else "", ""] # sans l'analyste, pas de titre aux catégories (l'utilisateur, 2026-10-27) + "Classification : étiquettes (bleu, en haut ; gris : hors catégorie), détecteurs (orange, en bas)" + if analyste else "", ""] # sans étiquettes, pas de titre aux catégories (l'utilisateur, 2026-10-27) fig = make_subplots(rows=5 + c, cols=1, shared_xaxes=True) for col, couleur in POSE if poses else (): fig.add_trace(go.Scatter(x=[p["t"] for p in poses], y=[p[col] for p in poses], name=col, mode="lines", @@ -495,11 +498,11 @@ def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste= d.hovertext = [h + "
clic : zoom, ses capteurs seuls, ses détails" + " et son timelapse" * bool(images) + " sous la figure" for h in d.hovertext] fig.add_trace(d, row=k_, col=1) # en mode group, le 1er groupe en bas - for nom_a, couleur, rang, sel in (("Analyste", AGENT, 2, [s for s in analyste if s[2] != hors]), - (f"Analyste, {hors}", GRIS, 3, [s for s in analyste if s[2] == hors])): + for nom_a, couleur, rang, sel in (("Étiquettes", AGENT, 2, [s for s in analyste if s[2] != hors]), + (f"Étiquettes, {hors}", GRIS, 3, [s for s in analyste if s[2] == hors])): if sel: t = barres(nom_a, couleur, sel, pas, rang, "a") - t.customdata = [[plotly_t(s[0]), plotly_t(score.iso(score.instant(s[1]) + pas)), f"Analyste : {s[2]}", f"

{s[3]}

", None] + t.customdata = [[plotly_t(s[0]), plotly_t(score.iso(score.instant(s[1]) + pas)), f"Étiquette : {s[2]}", f"

{s[3]}

", None] for s in sel] t.hovertext = [h + "
clic : zoom, ses détails" + " et son timelapse" * bool(images) + " sous la figure" for h in t.hovertext] diff --git a/docs/decisions.md b/docs/decisions.md index 19a68ef..024bbfb 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -1065,3 +1065,10 @@ Règles du journal : - **Pourquoi** : l'utilisateur, 2026-11-02, après l'essai WILDSTRUBEL : turbulence atmosphérique et Visibility, « la même chose ». Avis de Claude, accepté : deux mécanismes, mais pour une étiquette la même conclusion pour le client, et une séparation que les images fixes ne montrent pas (l'étiqueteur a tiré la turbulence du contexte de la station, sans la voir, en doutant de la lumière). - **Options écartées** : garder deux familles, la signature de la turbulence (milieu de journée, soleil, surface chaude, bruit rapide sans rejet) dite dans la description à la place. - **Conséquence** : aucune. + +## D-112 — 2026-11-02 — `/events-learner` sur les étiquettes de l'étiqueteur +- **Statut** : active, à essayer ; point 72 du plan du journal du matin ; remplace, dans la séance, l'analyste (D-088, D-090), le `tool-builder` (D-097) et l'`event-builder` (D-091) ; le score de D-062 passe aux familles. +- **Décision** : la vérité d'une séance de `/events-learner`, ce sont les étiquettes du lot dans `labeling/auto/.jsonl`, écrites avant par l'`etiqueteur` (D-106) et relues par l'utilisateur ; la séance s'arrête si le lot n'en a aucune, et ne les modifie pas. Elle se réduit aux détecteurs : score et benchmark avant, `detectors-critic` (les détecteurs face aux étiquettes, la catégorie du journal lue dans sa famille par la correspondance de `labeling/familles.md`, un saut bref dans la famille de sa cause), puis `detectors-upgrader` et `detectors-control` comme avant, bilan, releveur. Le score (`score.py --du --au`) compte par famille et par instant, sur le seul lot ; la page de fin de séance (`comparaison.py … --du --au`) range étiquettes et détecteurs sur une ligne par famille. Le benchmark sur la base d'events ne change pas. +- **Pourquoi** : l'utilisateur, 2026-11-02 : le travail de l'analyste est fait en amont, dans `labeling/auto/`, avec les étiquettes ; adapter le processus pour les utiliser. Le `tool-builder` et l'`event-builder` lisaient l'analyse de la séance : sans elle, ils n'ont plus d'entrée (avis de Claude, le plus simple). +- **Options écartées** : convertir les étiquettes au format de l'analyste (`etiquettes.json`, capteurs, catégories du journal) : une famille couvre plusieurs catégories, et les capteurs ne sont que dans le texte ; un score par capteur, tiré des noms de la description (fragile) ; un score sur tous les lots étiquetés de la station (le fichier ne dit pas quelles plages l'étiqueteur a lues en entier) ; garder l'ancienne page des séances passées (`lot-*/etiquettes.json`). +- **Conséquence** : `analyste`, `tool-builder` et `event-builder` restent, sans appel par la séance ; la base d'events ne grandit plus par `/events-learner`. Les séances passées gardent leurs fichiers, leur page ne se refait plus avec ce `comparaison.py`. Les 7 étiquettes du premier essai de JUNGFRAU (20 → 25.10) n'ont pas de famille : le score les compte « sans famille ». diff --git a/docs/superpowers/plans/2026-10-23-journal-du-matin.md b/docs/superpowers/plans/2026-10-23-journal-du-matin.md index 125d4ed..eb346cb 100644 --- a/docs/superpowers/plans/2026-10-23-journal-du-matin.md +++ b/docs/superpowers/plans/2026-10-23-journal-du-matin.md @@ -128,6 +128,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis | 69 | Apprendre des étiquettes de l'expert : `/labels-learner` | Décider, Coder | 67, 68 | `/labels-learner` construit le 2026-11-02 (D-099) ; premier essai, sur la perte de référence, à lancer par l'utilisateur | | 70 | Des étiquettes proposées par l'analyste, vérifiées par l'expert | Décider, Coder | 48, 68, 69 | 2026-11-02 : les étiquettes d'abord, base de connaissance (D-100) ; étiquettes des events validés en cours | | 71 | Un intégrateur : ce que deviennent les étiquettes | Décider, Coder | 69, 70 | 2026-11-02 : la carte des étiquettes, `/labels-map` (D-104), premier passage ; puis les étiquettes automatiques | +| 72 | `/events-learner` sur les étiquettes de l'étiqueteur | Coder, Essayer | 55, 71 | adapté le 2026-11-02 (D-112) ; première séance à lancer par l'utilisateur sur un lot étiqueté | Chemins conseillés : le plus simple et le plus parlant d'abord, **11 (visibilité simple), 38 (ses statuts : bonne, moyenne, nulle) puis 7 (bouton `Images`)**, qui marchent sans le classement ; le cœur du retour, c'est **5 → 6 → 7 → 8 → 9 → 10** ; les points 1 à 4 se lisent avant si l'on veut d'abord tout comprendre ; le point 27 se lance en parallèle (il n'attend rien). @@ -1750,6 +1751,16 @@ Un seul passage de l'analyste par phénomène, au lieu de deux : moins coûteux --- +### Point 72 : `/events-learner` sur les étiquettes de l'étiqueteur + +**Demande de l'utilisateur (2026-11-02).** Le processus qui optimise les détecteurs faisait analyser le lot par l'analyste, puis comparait les détecteurs à son analyse et proposait des améliorations ; ce travail de l'analyste se fait maintenant en amont, dans `labeling/auto/`, avec les étiquettes : adapter le processus pour utiliser les étiquettes produites. + +- [x] La séance lit les étiquettes du lot (`labeling/auto/.jsonl`), s'arrête s'il n'y en a aucune ; l'analyste, le `tool-builder` et l'`event-builder` sortent de la séance (D-112). +- [x] `score.py --du --au` : par famille et par instant, la correspondance de `labeling/familles.md` ; essayé sur WILDSTRUBEL 01 → 06.09 et JUNGFRAU 30.09 → 06.10. +- [x] `detectors-critic` et `detectors-upgrader` sur les étiquettes et le score par famille ; page de fin de séance par famille (capture sur WILDSTRUBEL). +- [ ] Première séance, lancée par l'utilisateur sur un lot étiqueté et relu (WILDSTRUBEL 01 → 06.09, ou JUNGFRAU 30.09 → 06.10). +- [ ] À trancher par l'utilisateur : rebrancher l'`event-builder` ou le `tool-builder` sur l'étiqueteur, ou les retirer. + ## Annexe A — Les rapports des agents du 2026-10-23, résumés Huit agents, un par piste, lancés par l'orchestrateur ; tous ont rendu leur travail. Rien n'a été commité. @@ -1962,3 +1973,4 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste. - 2026-11-02 : point 71, troisième essai de l'étiqueteur, sur une autre station (demande de l'utilisateur) : WILDSTRUBEL 01.09 → 06.09, 30 étiquettes (18 obstruction, 6 turbulence, 6 visibilite) ; l'outil montre les étiquettes d'une seule mesure (debut = fin) sur un pas. - 2026-11-02 : point 71, impression de l'utilisateur : turbulence atmosphérique et Visibility, la même chose ? Avis de Claude : les réunir pour les étiquettes ; à trancher. - 2026-11-02 : point 71, l'utilisateur : réunir ; `turbulence` dans `visibilite`, cinq familles (D-110). +- 2026-11-02 : point 72, nouveau (demande de l'utilisateur) : `/events-learner` lit les étiquettes de l'étiqueteur au lieu de faire analyser le lot ; score et page par famille ; analyste, `tool-builder` et `event-builder` hors de la séance (D-112). Reste la première séance. diff --git a/run.md b/run.md index 477c471..e3e9d75 100644 --- a/run.md +++ b/run.md @@ -99,9 +99,9 @@ Toutes les stations de `data/` d'un coup, chacune sur sa plage (une page ouverte ./detectors-view/run-detectors.sh ``` -# Améliorer les détecteurs, la base d'events et les outils de lecture (events-learner) +# Améliorer les détecteurs (events-learner) -Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Agent (pas dans le dev container), une fois les déplacements **et les images** pompés : +D'abord, étiqueter le lot (D-112) : `@etiqueteur data/ du au `, puis relire ses étiquettes (`labeling/auto/.jsonl`, menu Labels de l'outil d'étiquetage). Puis, dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Agent (pas dans le dev container), une fois les déplacements **et les images** pompés : ``` /events-learner data/ --du --au --ameliorer @@ -111,15 +111,20 @@ Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Ag - ``, `` : jours UTC, `AAAA-MM-JJ`, `` exclu (la plage s'arrête à `` 00:00). La plage est le lot, sans découpe : sa longueur se choisit par les dates (4 jours : `--du 2026-09-01 --au 2026-09-05`), D-072. - Sans `--du` ni `--au` : toute la période du dossier, en un lot. Le lot est classé avec ses 3 jours d'avant : les pomper aussi. - Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063). -- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, tool-builder (les outils de lecture dont l'analyste s'est servi, optimisés ou ajoutés, D-097), detectors-critic, puis detectors-upgrader et detectors-control si la critique a des suggestions, event-builder à chaque lot, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/events-learner` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités. -- Bilan dans `events-learner/_/bilan.md` ; les étiquettes de l'analyste (`lot-*/etiquettes.json`) sont à garder même si on annule une modification. Ensuite : `git revert` des commits de la séance qu'on ne garde pas (la base de la séance est dans le bilan). -- À la fin, la page `out/events-learner__.html` s'ouvre (D-066) : la page des détecteurs (`detectors-view/detecteurs.py`, ci-dessus) sur la plage, images et timelapse compris ; dessous les courbes, catégorie par catégorie, l'analyste (bleu) face aux détecteurs (orange) ; le score de la séance et le benchmark. -- Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`), lancé au début de chaque lot, après chaque modification et en fin de séance ; chaque passage s'ajoute à `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs. +- La séance s'arrête d'emblée si le lot n'a aucune étiquette dans `labeling/auto/.jsonl` ; les étiquettes sont la vérité de la séance, elle ne les modifie pas. +- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : score et benchmark, detectors-critic (les détecteurs face aux étiquettes), puis detectors-upgrader et detectors-control si la critique a des suggestions, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/events-learner` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités. +- Bilan dans `events-learner/_/bilan.md`. Ensuite : `git revert` des commits de la séance qu'on ne garde pas (la base de la séance est dans le bilan). +- À la fin, la page `out/events-learner__.html` s'ouvre (D-066) : la page des détecteurs (`detectors-view/detecteurs.py`, ci-dessus) sur la plage, images et timelapse compris ; dessous les courbes, famille par famille, les étiquettes (bleu) face aux détecteurs (orange) ; le score de la séance (par famille et par instant) et le benchmark. +- Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`), lancé au début du lot et après chaque modification ; chaque passage s'ajoute à `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs. -Refaire la page d'une séance : +Le score d'un lot, et la page d'une séance : ```bash -python3 .claude/skills/events-learner/comparaison.py data/ events-learner/_ +python3 .claude/skills/events-learner/score.py data/ --du --au +``` + +```bash +python3 .claude/skills/events-learner/comparaison.py data/ events-learner/_ --du --au ``` Lancer le benchmark à la main (sans rien écrire dans l'historique) : diff --git a/vues-deplacements/contexte/events-learner.md b/vues-deplacements/contexte/events-learner.md index cb6b686..b007cf7 100644 --- a/vues-deplacements/contexte/events-learner.md +++ b/vues-deplacements/contexte/events-learner.md @@ -1,6 +1,6 @@ # events-learner : conception -Point 31 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brainstorming du 2026-10-24, d'abord sous le nom `/boucle` ; **approuvée par l'utilisateur le 2026-10-24**, rôles revus le 2026-10-29 (points 51 à 55 du plan, D-087 à D-092) ; les outils de lecture y entrent le même jour, avec le `tool-builder`, et `/aiguiser` se retire (point 56, D-097). Ce qui vient de l'utilisateur est dit « l'utilisateur » ; le reste est un choix de Claude, marqué *(choix de Claude)*. +Point 31 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brainstorming du 2026-10-24, d'abord sous le nom `/boucle` ; **approuvée par l'utilisateur le 2026-10-24**, rôles revus le 2026-10-29 (points 51 à 55 du plan, D-087 à D-092) ; les outils de lecture y entrent le même jour, avec le `tool-builder`, et `/aiguiser` se retire (point 56, D-097) ; le 2026-11-02, les étiquettes de l'`etiqueteur`, faites en amont, remplacent l'analyste, et la séance se réduit aux détecteurs (point 72, D-112). Ce qui vient de l'utilisateur est dit « l'utilisateur » ; le reste est un choix de Claude, marqué *(choix de Claude)*. Cette page dit **pourquoi** le processus est ainsi. **Comment** il tourne est écrit une seule fois, ailleurs : le déroulé dans le skill `.claude/skills/events-learner/SKILL.md`, chaque rôle dans sa consigne, `.claude/agents/.md`. Ne pas les recopier ici. @@ -8,10 +8,7 @@ Cette page dit **pourquoi** le processus est ainsi. **Comment** il tourne est é L'utilisateur veut que Claude apprenne sur des lots entiers de données de stations, sans lui : passer les détecteurs du journal du matin sur un lot, juger leurs résultats comme le ferait un expert, en regardant lui-même les courbes et les images, corriger les détecteurs, et garder sous forme d'events tout ce qui est nouveau. -À la fin d'une séance, il reste trois choses durables (l'utilisateur) : -1. **de la connaissance** : de nouveaux events, appris sur des événements réels, de la même forme que ceux de la base, dans la même base, `events/` (l'utilisateur) ; -2. **des détections optimisées** : des détecteurs mieux réglés ; -3. **des outils de lecture meilleurs** (D-097) : ceux dont l'analyste s'est servi, ou qu'il a dû écrire, optimisés ou ajoutés à `agent-tools/`. Seul l'analyste sait ce qui est pertinent dans les données : c'est son travail réel qui guide les outils (l'utilisateur, 2026-10-29), et non un lecteur à part qui en extrait tout sans savoir ce qui compte (`/aiguiser`, retiré). +À la fin d'une séance, il reste **des détections optimisées** : des détecteurs mieux réglés. Jusqu'au 2026-11-02, il en restait aussi de nouveaux events (`event-builder`) et des outils de lecture meilleurs (`tool-builder`, D-097), tirés de l'analyse que la séance faisait faire à l'analyste ; ce travail de lecture se fait désormais en amont, par l'`etiqueteur`, dans `labeling/auto/` (l'utilisateur, 2026-11-02, D-112) : les étiquettes sont la base de connaissance (D-100), et la séance n'a plus d'analyse dont tirer events et outils. ## 2. Buts, non-buts, ce qui serait un échec @@ -21,8 +18,8 @@ L'utilisateur veut que Claude apprenne sur des lots entiers de données de stati - Récupérer les données : la séance prend un dossier de station tel quel, au format de `data//`, qu'il vienne du pompage (`extraction/pomper.py`) ou de fichiers téléchargés à la main. - Les autres domaines (Energy, Storage, Cellular, Temperature) : les déplacements seulement. - **L'agent de diagnostic** (D-046) : il n'a de travail à aucun moment de la séance (l'utilisateur, 2026-10-24) ; elle ne touche pas à ses consignes et ne fait que compléter la base d'events. -- L'exhaustivité : **pas de rejeu** des lots déjà vus, pas de revalidation générale après chaque modification ; on explore et on améliore peu à peu (l'utilisateur). Le score rejoue les lots d'avant sur leurs étiquettes, sans regard de Claude. -- Mesurer les progrès de l'analyste (l'utilisateur, 2026-10-29, D-088). +- L'exhaustivité : **pas de rejeu** des lots déjà vus, pas de revalidation générale après chaque modification ; on explore et on améliore peu à peu (l'utilisateur). +- Étiqueter le lot : l'`etiqueteur` le fait avant la séance, l'utilisateur relit ses étiquettes ; la séance ne les modifie pas (D-112). **Ce qui serait un échec.** - **La complexité** : des détecteurs qui gonflent de règles et de cas particuliers pour un petit gain (la crainte de l'utilisateur) ; de même des outils de lecture qui grossissent sans servir, risque que le `tool-builder`, qui ne retire rien et n'a pas de contrôle (D-097), laisse ouvert : à observer. @@ -32,16 +29,14 @@ L'utilisateur veut que Claude apprenne sur des lots entiers de données de stati ## 3. Les principes +- **La vérité : les étiquettes du lot** (D-112), écrites en amont par l'`etiqueteur` (`labeling/auto/.jsonl`, D-106), une famille par anomalie vue sur `corr_x` et `corr_y` (`labeling/familles.md`, D-109 à D-111). Les détecteurs gardent les douze catégories du journal ; la correspondance de `familles.md` les range dans les familles pour comparer. - **Un agent, une responsabilité** (l'utilisateur, 2026-10-29, D-090) : | Agent | Sa seule responsabilité | Ce qu'il ne voit pas | Décisions | |---|---|---|---| - | `analyste` (skill `analyser-lot`) | l'analyse la plus précise du lot, la vérité ; tous les outils, détecteurs et base d'events compris, et ses propres scripts ; il dit les outils dont il s'est servi | le code des détecteurs, les autres séances | D-088, D-090, D-097 | - | `tool-builder` | optimiser ou ajouter des outils de lecture d'après ceux dont l'analyste s'est servi ; ne rien retirer : un seul lot ne suffit pas (l'utilisateur) | les détecteurs | D-097 | - | `detectors-critic` | juger les détecteurs face à l'analyse : quoi et où | les données | D-090 | + | `detectors-critic` | juger les détecteurs face aux étiquettes : quoi et où | les données | D-090, D-112 | | `detectors-upgrader` | adapter les détecteurs (ajouter, retirer, modifier), le plus simple d'abord | — | D-089 | | `detectors-control` | le garde-fou contre le sur-apprentissage ; il décide | le lot (données, critique, score) | D-089 | - | `event-builder` | décider ce que le lot apprend de nouveau à la base d'events, et en faire des events bornés à l'événement | — | D-091 | Le releveur et l'améliorateur (D-060, D-071) sont communs à tous les processus automatiques, pas propres à celui-ci. - **L'orchestrateur ne juge rien** : il lit les lignes de verdict, transmet les chemins et commite *(choix de Claude)*. C'est un skill, lancé dans la conversation principale, parce qu'un sous-agent ne peut pas lancer d'autres sous-agents. @@ -53,27 +48,28 @@ L'utilisateur veut que Claude apprenne sur des lots entiers de données de stati ## 4. Les mesures -- **Le score** (D-062) : les détecteurs face aux étiquettes de l'analyste, mesure par mesure, sur ce lot et les lots d'avant de la station. Un contrôle pour le `detectors-upgrader`, pas un but (D-089) : l'alignement n'a pas à être parfait. Choix de Claude, laissés par l'utilisateur : un compte par mesure plutôt que par événement, par capteur, trois niveaux de validité. -- **Le benchmark** (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base, ses cas de régression ; c'est sur lui seul que juge le `detectors-control`. Une hausse est un plus, pas un but : sur une dizaine d'events, les détecteurs se régleraient sur eux (l'utilisateur). Le benchmark de fin des détecteurs est celui de la dernière modification gardée, sur les mêmes events que celui du début ; les events créés pendant la séance se mesurent à la suivante (D-092). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot. -- **Les étiquettes** de l'analyste (D-061) ne dépendent pas des modifications des détecteurs : ce sont aussi les labels d'un futur modèle appris (point 44 du plan), à garder même si une modification est annulée. +- **Le score** (D-062, D-112) : les détecteurs face aux étiquettes du lot, par famille et par instant (les étiquettes ne disent leurs capteurs que dans le texte), sur ce lot seulement (le fichier des étiquettes ne dit pas quelles plages l'étiqueteur a lues en entier). Un contrôle pour le `detectors-upgrader`, pas un but (D-089) : l'alignement n'a pas à être parfait. +- **Le benchmark** (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base, ses cas de régression ; c'est sur lui seul que juge le `detectors-control`. Une hausse est un plus, pas un but : sur une dizaine d'events, les détecteurs se régleraient sur eux (l'utilisateur). Le benchmark de fin des détecteurs est celui de la dernière modification gardée, sur les mêmes events que celui du début (D-092). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot. +- **Les étiquettes** ne dépendent pas des modifications des détecteurs : elles restent dans `labeling/auto/`, hors de la séance, aussi les labels d'un futur modèle appris (point 44 du plan). ## 5. Ce que l'utilisateur trouve à la fin -Les commits de la séance ; `bilan.md` (le lot, les outils modifiés, la modification gardée ou non, les events créés, les contradictions avec la base, les erreurs) ; les difficultés du processus dans `docs/ameliorations-processus.md` ; la page `out/events-learner_.html` (D-066), la lecture de l'analyste au-dessus des événements des détecteurs, catégorie par catégorie. Le but, séance après séance : que les deux coïncident. Les events appris attendent sa revue par `/review-event`. +Les commits de la séance ; `bilan.md` (le lot, ses étiquettes, la modification gardée ou non, les erreurs) ; les difficultés du processus dans `docs/ameliorations-processus.md` ; la page `out/events-learner_.html` (D-066), les étiquettes au-dessus des événements des détecteurs, famille par famille. Le but, séance après séance : que les deux coïncident. ## 6. Essai et séances **Essai du 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.** -**Séances** : lancées par l'utilisateur seul ; six du 2026-10-26 au 2026-10-27, dans `events-learner/`, avec les rôles d'avant le 2026-10-29. Les rôles revus (points 51 à 54 du plan) attendent leur première séance. +**Séances** : lancées par l'utilisateur seul ; six du 2026-10-26 au 2026-10-27, dans `events-learner/`, avec les rôles d'avant le 2026-10-29 et l'analyste. La séance sur les étiquettes (D-112) attend la première ; ses lots étiquetés : WILDSTRUBEL 01.09 → 06.09, JUNGFRAU 30.09 → 05.10 et 20.10 → 25.10 (ce dernier sans familles). ## Annexe : pistes à revoir +- L'`event-builder` et le `tool-builder`, hors de la séance depuis D-112 : les rebrancher sur l'étiqueteur (ses étiquettes pour des events, ses scripts de `out/etiqueteur/` pour les outils), si l'utilisateur le veut ; un event appris demande des étiquettes au format de l'analyste (capteurs, catégorie du journal) pour le benchmark. +- Le score sur tous les lots étiquetés de la station, et non le seul lot (D-062) : il faudrait savoir quelles plages l'étiqueteur a lues en entier. +- Un champ capteurs dans l'étiquette, pour un score par capteur comme celui du benchmark. - Un contrôle du `tool-builder` (sur le diff des outils, sans le lot), si les outils grossissent sans servir : l'utilisateur ne sait pas encore comment le faire (D-097). - Un audit indépendant de la lecture commune (`donnees.py`), par des scripts qui ne passent pas par elle, comme le correcteur de `/aiguiser` qui a trouvé l'erreur des rejets des références : de temps en temps, ou quand `donnees.py` change. -- Plusieurs analystes en parallèle : les lots sont indépendants ; le `detectors-upgrader` reste seul, pour que deux agents ne modifient jamais le même détecteur. - Le rejeu sur les lots déjà vus (écarté le 2026-10-24 : trop lourd, pas exhaustif voulu). - Un plafond de lots ou de coût par séance ; plusieurs stations par séance. -- La durée : ~8 min 30 par lot pour l'analyste seul. Leviers : son effort, moins de vignettes (risque de rater un événement court). - Le choix des lots parmi beaucoup de données (l'utilisateur : « on verra comment on fait ») ; le pompage en masse (points 27 à 29 du plan). - Le lot unique numéroté `lot-01` (vestige du découpage en lots, D-072) : le retirer toucherait trois scripts et la lecture des séances passées.