diff --git a/.claude/agents/label-reviewer.md b/.claude/agents/label-reviewer.md deleted file mode 100644 index adf65ec..0000000 --- a/.claude/agents/label-reviewer.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -name: label-reviewer -description: Vérificateur des étiquettes de l'expert (labeling/manual/) — confronte chaque étiquette aux données de sa plage, aux autres étiquettes et à la documentation, pointe les incohérences et pose ses questions à l'expert pour confirmer ou corriger ; ne change une étiquette que sur sa parole. Appelé depuis la conversation avec un fichier labeling/manual/.jsonl et la consigne « vérifier », puis « réponses : … » ; la conversation relaie ses questions à l'utilisateur et lui renvoie les réponses. -tools: Read, Bash, Write, Edit -model: inherit ---- - -Tu es le vérificateur des étiquettes. L'expert, c'est l'utilisateur : il écrit à la main (`labeling/labeling.py`) des plages de données, avec ce qu'il y voit, la cause et comment il l'a sue. Ces étiquettes sont la base de connaissance du projet (D-100) : une erreur y entre dans tout ce qui en apprend. Il peut se tromper sans le voir : une borne décalée, un capteur pour un autre, une heure locale prise pour UTC, un fait que les données ne montrent pas, deux étiquettes qui se contredisent, une cause sans dire comment il l'a sue. - -Tu cherches ces erreurs possibles et tu lui poses la question. Tu ne juges pas son diagnostic à sa place : il a vu ce que tu ne vois pas (le site, les images en entier, son expérience). Une incohérence se dit en question, avec le fait mesuré qui la fonde, jamais en correction. Tu ne lui parles pas directement : la conversation lui pose tes questions et te renvoie ses réponses. - -## Ta demande - -Un fichier `labeling/manual/.jsonl` (une ligne par étiquette : `debut`, `fin`, `description`, parfois `revue`, en UTC), au besoin une étiquette précise (ses bornes), et l'une de ces deux consignes. Les étiquettes à vérifier : celles qui n'ont pas de champ `revue`, sauf demande contraire. Leurs données : `data//`. Pour les lire : skill `lire-les-donnees` (outils de `agent-tools/`), jamais en affichant les CSV. - -### « vérifier » - -Pour chaque étiquette : - -1. Tire du texte ses affirmations vérifiables : une colonne qui monte ou ne bouge pas, tel capteur caché, la nuit, le jour, les références qui bougent peu, une durée, un ordre. -2. Mesure chacune dans les données de la plage, et un peu avant et après pour voir si les bornes encadrent le phénomène ; regarde les images quand le texte parle de ce qu'on voit (`vignettes.py`, `gif.py`). -3. Contrôle : - - **Forme** : `debut` < `fin`, au format `AAAA-MM-JJTHH:MMZ` ; des mesures dans la plage. - - **Bornes** : le phénomène commence-t-il et finit-il là, ou déborde-t-il nettement ? La plage se sélectionne à la souris : quelques pas d'écart ne valent pas une question. - - **Noms** : chaque capteur cité existe dans les données, et il est une référence ou une cible comme le dit le texte. - - **Heure** : tout est en UTC ; le jour ou la nuit que dit le texte, face aux images (la station peut être n'importe où : juge sur les images, pas sur l'heure). - - **Faits** : chaque affirmation, face à ta mesure. - - **Cause et preuve** : la cause est-elle dite, et comment il l'a sue (quel plot, quelle image) ? Sinon, demande-le (`run.md`, « Étiqueter des données »). - - **Entre étiquettes** : deux étiquettes qui se chevauchent et se contredisent ; le même phénomène décrit autrement ailleurs dans `labeling/manual/*.jsonl`. - - **Face à la documentation** : `events/carte-des-evenements.md` et `docs/displacement/domaine/chaine-de-mesure.md`, la section utile seulement (`grep -n '^#'`). Une étiquette qui contredit le savoir en place est une question : l'un des deux est faux, peut-être la documentation. -4. Écris la revue dans `labeling/revues/.md` (créé au besoin, complété ensuite, le plus récent en bas) : une section par étiquette, titrée par ses bornes, avec son verdict (`cohérente` ou `à confirmer`), les faits mesurés (valeur, commande) et ses questions, numérotées pour toute la revue (Q1, Q2…). - -Une question : courte, à laquelle on répond par oui, non ou quelques mots, avec le fait qui la fonde. Les plus graves d'abord (une cause ou un fait contredit avant une borne) ; trois au plus par étiquette ; aucune pour une étiquette cohérente, et pas de doute inventé pour en avoir une. - -Rends seulement : le chemin de la revue, le nombre d'étiquettes vérifiées et cohérentes, puis les questions numérotées, chacune avec les bornes de son étiquette. - -### « réponses : » - -- Il confirme : ajoute à l'étiquette `"revue": ""`. -- Il corrige : applique exactement ce qu'il dit (bornes, texte) ; un texte, c'est le sien : tu peux proposer une phrase, tu n'écris que celle qu'il a validée ; puis `revue`. -- Il ne sait pas : l'étiquette reste sans `revue`, la revue le note. -- Une réponse qui n'est pas nette : ne devine pas, rends la question. - -Modifie le fichier par script : une ligne JSON par étiquette, les autres lignes telles quelles, les champs dans leur ordre (`revue` en dernier), `ensure_ascii=False` ; vérifie ensuite que chaque ligne se relit par `json.loads`. Complète la revue (la réponse sous chaque question, ce qui a changé). Rends : les étiquettes changées, une ligne chacune, et les questions qui restent. - -## Règles - -- Tu n'écris que dans `labeling/manual/.jsonl` (sur sa parole) et `labeling/revues/.md`. -- Lecture seule sur les données ; aucun identifiant (`SIM_CCID`, `ip`, `ip_*`) dans la revue ; jamais le registre de `anonymize-event`. -- Vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed` ; pas de pseudo-probabilités. diff --git a/.claude/skills/review-labels/SKILL.md b/.claude/skills/review-labels/SKILL.md new file mode 100644 index 0000000..58379e4 --- /dev/null +++ b/.claude/skills/review-labels/SKILL.md @@ -0,0 +1,78 @@ +--- +name: review-labels +description: Revue des étiquettes de l'expert (labeling/manual/.jsonl) avec lui, dans la conversation, une étiquette à la fois dans l'ordre chronologique — confronter chacune aux données de sa plage, aux autres étiquettes et à la documentation, lui proposer un texte fluide et qualitatif, appliquer sa réponse, passer à la suivante. Lancé par l'utilisateur, /review-labels . +argument-hint: "" +--- + +# Revue des étiquettes + +L'expert, c'est l'utilisateur : il écrit à la main (`labeling/labeling.py`) des plages de données, avec ce qu'il y voit, la cause et comment il l'a sue. Ces étiquettes sont la base de connaissance du projet (D-100) : une erreur y entre dans tout ce qui en apprend. Il peut se tromper sans le voir : une borne décalée, un capteur pour un autre, une heure locale prise pour UTC, un fait que les données ne montrent pas, deux étiquettes qui se contredisent, une cause sans dire comment il l'a sue. + +Une étiquette est **qualitative, en langage naturel** : ce qu'on voit, la cause, comment on l'a sue, sans valeurs (ni MAD, ni mm, ni seuils chiffrés). Quantifier viendra après, par l'analyste. Tu mesures pour vérifier, mais tes chiffres restent dans la revue. + +Tu fais la revue **avec lui, dans la conversation**, une étiquette à la fois (D-103). Tu ne juges pas son diagnostic à sa place : il a vu ce que tu ne vois pas (le site, les images en entier, son expérience). Une incohérence se dit en question, avec le fait mesuré qui la fonde, jamais en correction. + +## Pendant la revue, il travaille aussi dans l'outil + +L'outil d'étiquetage reste ouvert : en cours de revue, il change des bornes, réécrit un texte ou retire une étiquette (Delete), souvent sans le dire en détail (« j'ai modifié », « j'ai delete 4/8 »). Donc : + +- **relis le fichier avant chaque étape** (avant de présenter, avant d'écrire) ; repère les étiquettes par leurs bornes du moment, jamais par celles d'avant ; +- un Save dans l'outil retire `revue` : une étiquette déjà revue dont il a seulement changé les bornes retrouve `revue`, et tu le dis en une ligne ; s'il en a changé le texte, présente-la de nouveau ; +- une étiquette retirée : ne la propose plus ; le rang des suivantes se compte sur ce qui reste ; +- s'il a réécrit une étiquette et demande de « relire » ou « fluidifier » : pars de **son** texte, garde son contenu, rends-le fluide et complet. + +## 1. Les étiquettes à revoir + +`labeling/manual/.jsonl` : une ligne par étiquette (`debut`, `fin`, `description`, parfois `revue`, en UTC). À revoir : celles sans champ `revue`, sauf demande contraire, **triées par `debut`**. Données : `data//` ; pour les lire, skill `lire-les-donnees` (outils de `agent-tools/`), jamais en affichant les CSV. Où est la station (pour le jour et la nuit) : l'export, ou l'event dont viennent ses étiquettes. + +Dis le nombre d'étiquettes à revoir, puis prends la première. + +## 2. Une étiquette + +1. Tire du texte ses affirmations vérifiables : une colonne qui monte ou ne bouge pas, tel capteur caché, la nuit, le jour, les références qui bougent peu, une durée, un ordre. +2. Mesure chacune dans les données de la plage, et un peu avant et après pour voir si les bornes encadrent le phénomène ; regarde les images quand le texte parle de ce qu'on voit (`vignettes.py`, `gif.py`, l'image entière au besoin). +3. Contrôle : + - **Forme** : `debut` < `fin`, au format `AAAA-MM-JJTHH:MMZ` ; des mesures dans la plage. + - **Bornes** : le phénomène commence-t-il et finit-il là, ou déborde-t-il nettement ? La plage se sélectionne à la souris : quelques pas d'écart ne valent pas une question. + - **Noms** : chaque capteur cité existe dans les données, et il est une référence ou une cible comme le dit le texte. + - **Heure** : tout est en UTC ; le jour ou la nuit que dit le texte, face aux images (la station peut être n'importe où : juge sur les images, pas sur l'heure). + - **Faits** : chaque affirmation, face à ta mesure ; un écart de chiffre qui ne change pas le sens ne vaut pas une question. + - **Cause et preuve** : la cause est-elle dite, et comment il l'a sue (quel plot, quelle image) ? Sinon, demande-le (`run.md`, « Étiqueter des données »). S'il dit voir sur les images ce que tu ne vois pas, sa parole tient : la revue note que tu ne l'as pas vu, sans insister. + - **Entre étiquettes** : deux étiquettes qui se chevauchent et se contredisent ; le même phénomène décrit autrement ailleurs dans `labeling/manual/*.jsonl`. **Un phénomène déjà étiqueté à la station** (un autre passage de train, la même pluie) : dis-le ; un exemple par phénomène lui suffit d'ordinaire, il garde ou retire. + - **Face à la documentation** : `events/carte-des-evenements.md` et `docs/displacement/domaine/chaine-de-mesure.md`, la section utile seulement (`grep -n '^#'`). Une étiquette qui contredit le savoir en place est une question : l'un des deux est faux, peut-être la documentation. +4. Présente-la, court : + - en titre, son rang (« 3/8 ») et ses bornes ; puis son texte, tel quel, en citation ; + - ce que tu as vérifié et qui tient, en une ou deux lignes ; + - ce qui ne colle pas, s'il y en a : le fait mesuré, en mots ; trois points au plus, les plus graves d'abord (une cause ou un fait contredit avant une borne) ; + - **toujours une proposition de texte**, qui règle ces points (voir « Le texte proposé ») ; une question seulement quand la proposition ne peut pas trancher pour lui (comment il a su la cause, sur quelle image il voit tel fait). +5. Attends sa réponse. Ne passe pas à la suivante avant. + +## Le texte proposé + +Le modèle, ce sont les étiquettes revues de NIEDERHORN (`labeling/manual/NIEDERHORN.jsonl`) : + +- en mots, sans valeurs ni unités ni MAD : « monte presque à 1 », « monte nettement, sans pic isolé », « un petit saut le temps d'une mesure », « loin de leur seuil » ; +- dans l'ordre : ce qui se passe et la cause ; ce qu'on voit dans les courbes (cibles, puis références) ; la preuve (« visible sur l'image de HH:MM UTC », ou « déduite » et de quoi) ; le retour à la normale ; la conclusion pour l'ouvrage (« Les voies ne bougent pas : rien à faire. ») ; +- des phrases courtes et liées, pas d'énumération entre points-virgules ; +- un capteur nommé seulement s'il est le sujet (la cible derrière les feuilles), pas pour lister les plus touchées ; +- ni classification (*target-local degradation*…) ni question ouverte (« effet optique ou fléchissement, à revoir ») : elles restent dans l'event ; +- une hypothèse reste une hypothèse (« sans doute ») ; rien qu'il n'ait pas dit ou que tu n'aies pas vérifié. + +## 3. Sa réponse + +- « Oui », « tu peux y aller », « modifie directement » : écris le texte proposé, puis `"revue": ""`. +- Il corrige : applique exactement ce qu'il dit (bornes, texte) ; un texte, c'est le sien : tu n'écris que celui qu'il a validé ; puis `revue`. +- Il ne sait pas, ou veut y revenir : l'étiquette reste sans `revue`. +- Une réponse qui n'est pas nette : ne devine pas, repose la question. + +Modifie le fichier par script, en relisant d'abord le fichier : une ligne JSON par étiquette, les autres lignes telles quelles, les champs dans leur ordre (`revue` en dernier), `ensure_ascii=False` ; vérifie que l'étiquette visée a été trouvée (par ses bornes) et que chaque ligne se relit par `json.loads`. Si elle n'est pas trouvée, il l'a changée dans l'outil : relis, ne force pas. + +La revue ne laisse pas d'autre trace que le fichier des étiquettes et `revue` : dis en une ligne ce qui a changé, et présente l'étiquette suivante. + +À la fin de la station : un bilan dans la réponse (les étiquettes qui restent, revues ; retirées ; restées ouvertes), puis la station suivante. Le commit attend l'accord de l'utilisateur. + +## Règles + +- Tu n'écris que dans `labeling/manual/.jsonl`, sur sa parole. +- Lecture seule sur les données ; aucun identifiant (`SIM_CCID`, `ip`, `ip_*`) dans une étiquette ; jamais le registre de `anonymize-event`. +- Vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed` ; pas de pseudo-probabilités. diff --git a/CLAUDE.md b/CLAUDE.md index 6d89535..df75d45 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -18,7 +18,7 @@ Cadrage du product owner : sous-projet G, santé des sites et notifications au c - **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, 13 au 2026-11-02, plus 30 tirées des events validés, D-100) : le premier `/labels-learner` (D-099, point 69 du plan), sur la perte de référence, lancé par l'utilisateur ; + - les étiquettes de l'expert (`labeling/`, D-098, 13 au 2026-11-02, plus 30 tirées des events validés, D-100) : leur revue avec l'utilisateur, `/review-labels`, une à une (D-103) ; 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 ; - 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. @@ -104,7 +104,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - `vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `contexte/` (journal du matin, seuils, lissage, `events-learner`, aiguisage, retiré), `cas/` (NORDEND, parcours de l'utilisateur), `benchmark/historique.csv` (D-069). - `detectors/` : les détecteurs du journal (D-067, D-068, D-084), un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés en événements par `categories.py` ; `archive/` : versions écartées. - `detectors-view/` : le développement de la page des détecteurs (D-093), `detecteurs.py` : images, courbes, Status, catégories, Error rate ; `run-detectors.sh` : la page sur chaque station de `data/` ; `status.py` : la page Status, version pseudo finale de la page Explore du site : corr_x, corr_y, mouvement de la caméra, événements des détecteurs en plages colorées et en étiquettes cliquables au-dessus (sélection : ses capteurs, ses détails et son timelapse sous la figure, sans zoom) (D-094), occultés selon `hierarchie-des-status.md` (D-095, regroupement thermique suspendu) ; en haut, le data loader `data-loader/chargeur.py` (station, dates, « Analyse » ; son serveur, port 8766) ; la page des détecteurs est reprise par la page de fin de séance de `/events-learner` (`comparaison.py`) et par `/review-event`. -- `labeling/` : l'outil d'étiquetage de l'expert (D-098), `labeling.py` : un plot à la fois (déplacements, métriques système), une barre de temps pour sélectionner une plage, du texte libre sans catégorie ; Add écrit une ligne dans `manual/.jsonl`, versionné ; un clic sur une étiquette la lit, la modifie ou la retire ; `manual/` : les étiquettes faites à la main, vérifiées avec le `label-reviewer`, dont celles des events validés (D-100) ; `auto/` : celles que l'analyste trouvera seul, vide (D-102) ; `revues/` : les revues de l'agent `label-reviewer` (D-101) ; `lecons/` : les leçons de `/labels-learner` (D-099), une par phénomène. +- `labeling/` : l'outil d'étiquetage de l'expert (D-098), `labeling.py` : un plot à la fois (déplacements, métriques système), une barre de temps pour sélectionner une plage, du texte libre sans catégorie ; Add écrit une ligne dans `manual/.jsonl`, versionné ; un clic sur une étiquette la lit, la modifie ou la retire ; `manual/` : les étiquettes faites à la main, revues avec l'utilisateur par `/review-labels`, dont celles des events validés (D-100) ; `auto/` : celles que l'analyste trouvera seul, vide (D-102) ; `lecons/` : les leçons de `/labels-learner` (D-099), une par phénomène. - `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`. @@ -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), `label-reviewer` (D-101), `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), `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` (`analyste`, `tool-builder`, `detectors-critic`, `detectors-upgrader`, `detectors-control`, `event-builder`), `revue` (`/review-event`), `documentaliste` (`/labels-learner`, D-099), `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), `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/docs/decisions.md b/docs/decisions.md index 4fcdd21..3f8ad5b 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -994,7 +994,7 @@ Règles du journal : - **Conséquence** : `/labels-learner` et l'outil les lisent comme les autres. Sans champ `source` (retiré à la demande de l'utilisateur, le même jour) : rien ne relie une étiquette à son event, ni une station à son code (D-049). E-001 est sur `PS_DES_COUDRES`, absente de `data/` : son étiquette attend le pompage. Un event validé plus tard devra recevoir ses étiquettes (à brancher dans `/new-event` et `/review-event`, point 70). ## D-101 — 2026-11-02 — Un vérificateur des étiquettes : l'agent `label-reviewer` -- **Statut** : active, à l'essai ; complète D-098 et D-100. +- **Statut** : remplacée par D-103 pour la forme (un skill, pas un agent) ; le reste tient. - **Décision** : un agent, `label-reviewer` (`.claude/agents/label-reviewer.md`), appelé depuis la conversation sur un fichier `labeling/.jsonl` : pour chaque étiquette sans champ `revue`, il mesure dans les données ce que dit le texte, contrôle la forme, les bornes, les noms des capteurs, l'heure (UTC, jour ou nuit sur les images), la cause et comment elle a été sue, les autres étiquettes et la documentation (carte des événements, chaîne de mesure), puis écrit sa revue dans `labeling/revues/.md` et rend ses questions ; la conversation les pose à l'utilisateur et lui renvoie les réponses. Il ne change une étiquette que sur la parole de l'utilisateur ; une étiquette confirmée ou corrigée reçoit `"revue": ""`, qu'un Save de son texte dans l'outil retire. - **Pourquoi** : l'utilisateur, 2026-11-02 : un vérificateur qui pointe les incohérences et lui pose des questions pour confirmer ses étiquettes, car il peut simplement faire des erreurs ; les étiquettes sont la base de connaissance (D-100). - **Options écartées** : un skill orchestrateur (comme `/review-event`) : la conversation suffit à relayer les questions ; un agent qui corrige seul : une incohérence peut venir des données ou de la documentation, l'expert tranche. @@ -1007,3 +1007,10 @@ Règles du journal : - **Options écartées** : aucune proposée. - **Conséquence** : les 43 étiquettes existantes sont déplacées dans `manual/` ; l'outil ne montre pas encore `auto/`. + +## D-103 — 2026-11-02 — La revue des étiquettes, un skill mené dans la conversation : `/review-labels` +- **Statut** : active ; remplace la forme de D-101. +- **Décision** : l'agent `label-reviewer` devient le skill `review-labels` (`.claude/skills/review-labels/SKILL.md`), que la conversation suit elle-même : `/review-labels ` prend les étiquettes sans `revue` dans l'ordre chronologique, une à la fois ; pour chacune, les mêmes contrôles que D-101, puis sa présentation à l'utilisateur, ses questions, sa réponse appliquée, et seulement alors la suivante. La revue ne garde pas de fichier à part : l'étiquette revue porte `revue`. Une étiquette est qualitative, en langage naturel, sans valeurs : l'analyste quantifiera ensuite. +- **Pourquoi** : l'utilisateur, 2026-11-02, après le premier essai sur NIEDERHORN : passer chaque étiquette en revue et la valider ensemble, plutôt que recevoir d'un agent toutes les questions d'une station d'un coup ; les chiffres dans les étiquettes, c'est le travail de l'analyste. +- **Options écartées** : garder l'agent et relayer ses questions (le premier essai) : un intermédiaire de plus, et toutes les questions à la fois. +- **Conséquence** : `.claude/agents/label-reviewer.md` et `labeling/revues/` sont retirés (l'utilisateur, 2026-11-02 : pas de fichier de revue). 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 e98bf44..9324de7 100644 --- a/docs/superpowers/plans/2026-10-23-journal-du-matin.md +++ b/docs/superpowers/plans/2026-10-23-journal-du-matin.md @@ -1720,7 +1720,7 @@ Un seul passage de l'analyste par phénomène, au lieu de deux : moins coûteux - [x] Les étiquettes de E-001 à E-011 (validés), par un agent : 30, dans les fichiers des stations, le 2026-11-02 ; relecture par l'utilisateur (ou le `label-reviewer`). - [ ] E-012 à E-014 après `/review-event` ; puis brancher l'étiquette dans `/new-event` et `/review-event`, pour chaque event validé plus tard. - [ ] Le but 2 (les détecteurs) et les propositions de l'analyste : plus tard. -- [x] Un vérificateur des étiquettes de l'utilisateur, l'agent `label-reviewer` (D-101) : il pointe les incohérences et pose ses questions ; construit le 2026-11-02, premier essai à faire. +- [x] Un vérificateur des étiquettes de l'utilisateur, l'agent `label-reviewer` (D-101) : il pointe les incohérences et pose ses questions ; construit le 2026-11-02, premier essai sur NIEDERHORN le 2026-11-02 ; devenu le skill `/review-labels`, mené dans la conversation, une étiquette à la fois dans l'ordre chronologique (D-103). ### Point 71 : Un intégrateur : ce que deviennent les étiquettes @@ -1933,4 +1933,5 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste. - 2026-11-02 : point 70, demande de l'utilisateur : les étiquettes des events dans les fichiers des stations, que charge son outil ; 30 étiquettes décodées et ajoutées, `labeling/E-xxx.jsonl` abandonnés. - 2026-11-02 : point 70, l'utilisateur : champ `source` retiré des étiquettes des events, même format que les autres. - 2026-11-02 : point 70, l'utilisateur : `labeling/manual/` (à la main, vérifiées avec le `label-reviewer`) et `labeling/auto/` (ce que l'analyste trouvera seul) (D-102) ; les 43 étiquettes dans `manual/`. +- 2026-11-02 : point 70, l'utilisateur, après le premier essai du `label-reviewer` sur NIEDERHORN : un skill `/review-labels` plutôt qu'un agent, une étiquette à la fois, validée ensemble (D-103). - 2026-11-02 : point 71 ajouté (idée de l'utilisateur : un intégrateur des étiquettes) : avis de Claude, trois usages, la forme structurée comme pièce commune ; à discuter après la revue des étiquettes. diff --git a/labeling/labeling.py b/labeling/labeling.py index 74b0a82..ea62349 100644 --- a/labeling/labeling.py +++ b/labeling/labeling.py @@ -318,7 +318,7 @@ def modifier(corps): if not description or datetime.strptime(debut, FORMAT) >= datetime.strptime(fin, FORMAT): raise ValueError("empty text or range") label = {**avant, "debut": debut, "fin": fin, "description": description} # à leur place : l'ordre des champs ne change pas - label.pop("revue", None) # texte ou bornes changés : à revoir par le label-reviewer (D-101) + label.pop("revue", None) # texte ou bornes changés : à revoir par /review-labels (D-103) return remplace(station, avant, label) diff --git a/labeling/manual/NIEDERHORN.jsonl b/labeling/manual/NIEDERHORN.jsonl index 8c431c4..b6624d4 100644 --- a/labeling/manual/NIEDERHORN.jsonl +++ b/labeling/manual/NIEDERHORN.jsonl @@ -1,8 +1,5 @@ -{"debut": "2026-09-30T22:00Z", "fin": "2026-09-30T23:00Z", "description": "Voies ferrées. Passage d'un train devant les cibles, le temps d'une seule mesure : l'error_value de 19 à 20 capteurs saute de 6 à 200 MAD, puis revient au pas suivant ; aucune référence ne bouge et ces mesures sont presque toutes rejetées. PWD_RMP_B12_018_C09, PWD_RMP_B12_019_C09 et PWD_RMP_B12_020_C09, restées sous leur seuil, gardent un saut de corr_y d'une seule mesure (+0,6 à +1,4, soit 16 à 35 MAD ; relative_y +1 px), puis reviennent ; PWD_RMP_B12_017_C09 moins. Pas d'image à cet instant : le train est déduit. Pour le saut de corr_y gardé dans la courbe, effet optique du train ou vrai fléchissement du rail sous la charge, non établi : des mesures horaires ne séparent pas les deux (avis de l'expert : à revoir). Classification : *target-local degradation*, par occlusion. Les voies ne bougent pas, rien à faire."} -{"debut": "2026-10-01T05:00Z", "fin": "2026-10-01T11:00Z", "description": "Voies ferrées, la nuit, sous la pluie : pendant 6 h, l'error_value de 4 à 14 cibles par heure monte de 6 à 40 MAD au-dessus de sa médiane, sans pic d'un seul pas, puis revient sans palier quand la pluie cesse ; les plus touchées sont PWD_RMP_B15_019_C09, e01, e02, e06 et PWD_RMP_B12_018_C09 ; aucune référence ne monte (PWD_REF11_C09 et PWD_RMP_B17_026_C09 restent plates). Sur les images, le fond est voilé et bruité et les taches rapetissent, mais aucune goutte n'est visible cette nuit-là : la pluie est déduite. Les gouttes devant l'objectif voilent les taches pendant les heures de pluie. Classification : *target-local degradation*, par buée ou eau. Les voies ne bougent pas, rien à faire."} -{"debut": "2026-10-01T12:00Z", "fin": "2026-10-01T13:00Z", "description": "Voies ferrées. Passage d'un train de marchandises devant les cibles, vu sur l'image de 12:00, le temps d'une seule mesure : l'error_value de 19 à 20 capteurs saute de 6 à 200 MAD, puis revient ; aucune référence ne bouge et ces mesures sont presque toutes rejetées. PWD_RMP_B12_018_C09, PWD_RMP_B12_019_C09 et PWD_RMP_B12_020_C09, restées sous leur seuil, gardent un saut de corr_y d'une seule mesure (+0,6 à +1,4, soit 16 à 35 MAD ; relative_y +1 px), puis reviennent ; PWD_RMP_B12_017_C09 moins. Pour ce saut gardé dans la courbe, effet optique du train ou vrai fléchissement du rail sous la charge, non établi : des mesures horaires ne séparent pas les deux (avis de l'expert : à revoir). Classification : *target-local degradation*, par occlusion. Les voies ne bougent pas, rien à faire."} -{"debut": "2026-10-01T21:00Z", "fin": "2026-10-01T22:00Z", "description": "Voies ferrées. Passage d'un train devant les cibles, vu sur les images, le temps d'une seule mesure : l'error_value de 5 ou 6 cibles saute à des dizaines ou des centaines de MAD, puis revient au pas suivant ; aucune référence ne bouge et ces mesures sont presque toutes rejetées. Le train cache les cibles ou change leur fond le temps d'une mesure. Classification : *target-local degradation*, par occlusion. Les voies ne bougent pas, rien à faire."} -{"debut": "2026-10-02T03:00Z", "fin": "2026-10-02T11:00Z", "description": "Voies ferrées, la nuit, sous la pluie : pendant 8 h, l'error_value d'une douzaine de cibles (4 à 14 par heure) monte de 6 à 40 MAD au-dessus de sa médiane, sans pic d'un seul pas, puis revient sans palier quand la pluie cesse ; les plus touchées sont PWD_RMP_B15_019_C09, e01, e02, e06 et PWD_RMP_B12_018_C09 ; aucune référence ne monte (PWD_REF11_C09 et PWD_RMP_B17_026_C09 restent plates). Sur les images, des gouttes devant l'objectif, éclairées par le projecteur (image de 08:00) ; le fond est bruité, les taches rapetissent, e01 disparaît à 08:00. Vu sur les images. Classification : *target-local degradation*, par buée ou eau. Les voies ne bougent pas, rien à faire."} -{"debut": "2026-10-02T10:00Z", "fin": "2026-10-02T22:00Z", "description": "Voies ferrées. PWD_IMP_B07_016_C09, au bord d'une plante du premier plan, voit son error_value sauter à des dizaines de MAD environ une mesure sur deux pendant une douzaine d'heures : 7 pas sur 12 entre 0,39 et 0,96, soit 6 à 25 MAD pour une médiane de 0,21, puis retour. Sa voisine PWD_RMP_B12_017_C09 reste intacte (sa bosse du matin est la pluie). Sur les images, aux heures des pics (11:00, 16:00, 19:00, 22:00), les feuilles agitées par le vent couvrent PWD_IMP_B07_016_C09 ; à 09:00 et 15:00, elles sont à côté. Vu sur les images. Classification : *target-local degradation*, par occlusion (feuilles d'une plante au vent). Les voies ne bougent pas, rien à faire."} -{"debut": "2026-10-02T21:00Z", "fin": "2026-10-02T22:00Z", "description": "Voies ferrées. Passage d'un train devant les cibles, vu sur les images, le temps d'une seule mesure : l'error_value de 5 ou 6 cibles saute à des dizaines ou des centaines de MAD, puis revient au pas suivant ; aucune référence ne bouge et ces mesures sont presque toutes rejetées. Le train cache les cibles ou change leur fond le temps d'une mesure. Au même moment, PWD_IMP_B07_016_C09 est aussi touchée par les feuilles d'une plante (autre phénomène). Classification : *target-local degradation*, par occlusion. Les voies ne bougent pas, rien à faire."} -{"debut": "2026-10-03T10:00Z", "fin": "2026-10-03T11:00Z", "description": "Voies ferrées. Le plus petit des cinq passages de trains de l'export : le temps d'une seule mesure, l'error_value de 2 cibles saute à des dizaines ou des centaines de MAD, puis revient au pas suivant ; aucune référence ne bouge. Même forme que les autres passages, dont trois sont vus sur les images (01.10 à 12:00 et 21:00, 02.10 à 21:00). Classification : *target-local degradation*, par occlusion. Les voies ne bougent pas, rien à faire."} +{"debut": "2026-09-30T21:00Z", "fin": "2026-09-30T23:00Z", "description": "Passage d'un train de voyageurs devant une grande partie des cibles, visible sur l'image de 22:00 UTC. L'error_value de ces cibles monte presque à 1 : elles sont entièrement cachées. Le réseau de références, lui, reste intact. Les cibles cachées semblent bouger le temps d'une mesure ; dans les courbes corrigées, les points au-dessus du seuil sont retirés de l'affichage, mais quelques cibles restées sous le seuil gardent un petit saut. Tout revient à la normale dès la mesure suivante. Les voies ne bougent pas : rien à faire.", "revue": "2026-11-02"} +{"debut": "2026-10-01T04:00Z", "fin": "2026-10-01T11:00Z", "description": "Voies ferrées, la nuit, sous la pluie. Pendant six heures, l'error_value de la plupart des cibles monte nettement, sans pic isolé, puis redescend progressivement quand la pluie cesse. Les références, elles, ne bougent pas, ce qui peut surprendre : elles sont placées plus haut, sur la route au-dessus des voies, et subissent sans doute moins la pluie par effet d'angle. Sur les images, le fond est voilé et bruité, les taches rapetissent, et des gouttes d'eau se voient sur certaines : la pluie est visible. Les gouttes devant l'objectif voilent les taches pendant les heures de pluie. Les voies ne bougent pas : rien à faire.", "revue": "2026-11-02"} +{"debut": "2026-10-01T11:00Z", "fin": "2026-10-01T14:00Z", "description": "Passage d'un train de marchandises devant une grande partie des cibles, visible sur l'image de 12:00 UTC. L'error_value de ces cibles monte presque à 1 : elles sont entièrement cachées et leurs mesures sont rejetées. Le réseau de références, lui, reste intact. Quelques cibles restées sous le seuil gardent un petit saut le temps d'une mesure. Tout revient à la normale dès la mesure suivante. Les voies ne bougent pas : rien à faire.", "revue": "2026-11-02"} +{"debut": "2026-10-02T02:00Z", "fin": "2026-10-02T11:00Z", "description": "Voies ferrées, la nuit, sous la pluie. L'error_value de la plupart des cibles monte nettement, sans pic isolé, puis redescend progressivement quand la pluie cesse. Les références tiennent : deux d'entre elles montent un peu en fin de nuit, loin de leur seuil. Sur les images, des gouttes devant l'objectif sont éclairées par le projecteur (image de 08:00 UTC) ; le fond est bruité, les taches rapetissent et certaines disparaissent. Les voies ne bougent pas : rien à faire.", "revue": "2026-11-02"} +{"debut": "2026-10-02T09:00Z", "fin": "2026-10-02T23:00Z", "description": "Voies ferrées. Une plante du premier plan, agitée par le vent, passe par moments devant PWD_IMP_B07_016_C09 : son error_value saute environ une mesure sur deux pendant une douzaine d'heures, puis revient. Sur les images, aux heures des pics, les feuilles couvrent la cible ; aux autres heures, elles sont à côté. Sa voisine PWD_RMP_B12_017_C09 n'est pas touchée (sa hausse du matin vient de la pluie). Les voies ne bougent pas : rien à faire.", "revue": "2026-11-02"} diff --git a/run.md b/run.md index a71cc69..679fd80 100644 --- a/run.md +++ b/run.md @@ -34,9 +34,9 @@ Les events validés ont aussi leurs étiquettes, dans le fichier de leur station Dans le texte, dire la cause et comment on l'a sue (quel plot, quel signe). Étiqueter aussi les cas trompeurs, qui ressemblent à un problème sans en être un : ils donnent les faux amis (point 69 du plan). Le fichier se commite comme le reste (`push.sh`). -# Faire vérifier ses étiquettes (label-reviewer) +# Revoir ses étiquettes (/review-labels) -Dans une conversation Claude Code : `@label-reviewer labeling/manual/.jsonl vérifier`. Il vérifie les étiquettes sans `revue` face aux données, aux autres étiquettes et à la documentation, écrit sa revue dans `labeling/revues/.md` et pose ses questions ; répondre dans la conversation, Claude les lui renvoie (« réponses : … »). Une étiquette confirmée ou corrigée reçoit `revue` ; modifier son texte dans l'outil le retire (D-101). +Dans une conversation Claude Code : `/review-labels `. Claude prend les étiquettes sans `revue` dans l'ordre chronologique, une à la fois : il la confronte aux données, aux autres étiquettes et à la documentation, la présente avec un texte proposé, et attend la réponse avant la suivante. Une étiquette validée ou corrigée reçoit `revue` ; modifier son texte dans l'outil le retire (D-101, D-103). # Apprendre des étiquettes (labels-learner)