Labels in two folders: manual/ (by hand, checked with the label-reviewer, the tool's) and auto/ (what the analyst will find alone, empty) (D-102)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-02 10:27:32 +01:00
1 parent 148d197173
commit 3a07d45ffe
15 files changed
+21 -13

No files matched your search

+5 -5
View File
@@ -1,6 +1,6 @@
---
name: label-reviewer
description: Vérificateur des étiquettes de l'expert (labeling/) — 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/<STATION>.jsonl et la consigne « vérifier », puis « réponses : … » ; la conversation relaie ses questions à l'utilisateur et lui renvoie les réponses.
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/<STATION>.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
---
@@ -11,7 +11,7 @@ Tu cherches ces erreurs possibles et tu lui poses la question. Tu ne juges pas s
## Ta demande
Un fichier `labeling/<STATION>.jsonl` (une ligne par étiquette : `debut`, `fin`, `description`, parfois `source`, `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/<STATION>/` ; pour une station `E-xxx`, `events/E-xxx/` (D-100). Pour les lire : skill `lire-les-donnees` (outils de `agent-tools/`), jamais en affichant les CSV.
Un fichier `labeling/manual/<STATION>.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/<STATION>/`. Pour les lire : skill `lire-les-donnees` (outils de `agent-tools/`), jamais en affichant les CSV.
### « vérifier »
@@ -26,7 +26,7 @@ Pour chaque étiquette :
- **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/*.jsonl`.
- **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/<STATION>.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…).
@@ -45,6 +45,6 @@ Modifie le fichier par script : une ligne JSON par étiquette, les autres lignes
## Règles
- Tu n'écris que dans `labeling/<STATION>.jsonl` (sur sa parole) et `labeling/revues/<STATION>.md`.
- Lecture seule sur les données ; aucun identifiant (`SIM_CCID`, `ip`, `ip_*`) dans la revue ; pour une station `E-xxx`, les noms codés de l'event, jamais le registre de `anonymize-event`.
- Tu n'écris que dans `labeling/manual/<STATION>.jsonl` (sur sa parole) et `labeling/revues/<STATION>.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.
+2 -2
View File
@@ -7,11 +7,11 @@ argument-hint: "<phénomène, en quelques mots>"
# Apprendre des étiquettes de l'expert
L'expert, c'est l'utilisateur : il étiquette des plages en texte libre, la cause et comment il l'a sue (`labeling/<STATION>.jsonl`, D-098). Apprendre, ici, c'est documenter (D-099) : l'agent `analyste` mesure dans les données ce que disent les étiquettes d'un même phénomène et pose ses questions à l'expert ; quand il a compris, il écrit ses conclusions ; l'agent `documentaliste` les fait entrer dans la documentation. Tu es l'orchestrateur : tu choisis les étiquettes avec l'utilisateur, relaies les questions et les réponses, lances le documentaliste et commites. **Tu ne juges ni les conclusions ni la documentation toi-même.**
L'expert, c'est l'utilisateur : il étiquette des plages en texte libre, la cause et comment il l'a sue (`labeling/manual/<STATION>.jsonl`, D-098, D-102). Apprendre, ici, c'est documenter (D-099) : l'agent `analyste` mesure dans les données ce que disent les étiquettes d'un même phénomène et pose ses questions à l'expert ; quand il a compris, il écrit ses conclusions ; l'agent `documentaliste` les fait entrer dans la documentation. Tu es l'orchestrateur : tu choisis les étiquettes avec l'utilisateur, relaies les questions et les réponses, lances le documentaliste et commites. **Tu ne juges ni les conclusions ni la documentation toi-même.**
## 1. Les étiquettes du phénomène
Lis `labeling/*.jsonl` (une ligne par étiquette : `debut`, `fin`, `description`) et retiens celles qui parlent du phénomène demandé (« $ARGUMENTS ») ; sans argument, demande-le. Annonce la liste, une ligne chacune (station, début, fin, dix mots de la description), et fais-la confirmer ou corriger par l'utilisateur (AskUserQuestion : « Ces étiquettes ? », Oui / J'en change). Au plus 5 : au-delà, garde les plus variées (stations différentes d'abord) et dis lesquelles restent pour une autre fois.
Lis `labeling/manual/*.jsonl` (une ligne par étiquette : `debut`, `fin`, `description`) et retiens celles qui parlent du phénomène demandé (« $ARGUMENTS ») ; sans argument, demande-le. Annonce la liste, une ligne chacune (station, début, fin, dix mots de la description), et fais-la confirmer ou corriger par l'utilisateur (AskUserQuestion : « Ces étiquettes ? », Oui / J'en change). Au plus 5 : au-delà, garde les plus variées (stations différentes d'abord) et dis lesquelles restent pour une autre fois.
Le dossier de la leçon : `labeling/lecons/<AAAA-MM-JJ>_<phénomène en minuscules, tirets>/`. Écris-y `etiquettes.jsonl`, les lignes retenues telles quelles, avec un champ `station` en plus.
+1 -1
View File
@@ -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 `<STATION>.jsonl`, versionné ; un clic sur une étiquette la lit et la modifie ; les events validés y ont aussi les leurs (D-100) ; `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/<STATION>.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.
- `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 `<séance>_<STATION>/` (`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`.
+7
View File
@@ -1000,3 +1000,10 @@ Règles du journal :
- **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.
- **Conséquence** : une étiquette porte `revue` une fois vérifiée ; `/labels-learner` ne les distingue pas encore.
## D-102 — 2026-11-02 — Les étiquettes en deux dossiers : `manual/` et `auto/`
- **Statut** : active ; complète D-098, D-100 et D-101.
- **Décision** : `labeling/manual/<STATION>.jsonl` reçoit les étiquettes faites à la main (l'outil y lit et y écrit), dont celles des events validés, vérifiées avec le `label-reviewer` ; `labeling/auto/` recevra celles que l'analyste trouvera seul, vide pour l'instant (son format et l'outil qui les montre restent à décider). `/labels-learner` et le `label-reviewer` lisent `manual/`.
- **Pourquoi** : l'utilisateur, 2026-11-02 : les étiquettes faites ensemble se valident avec le reviewer ; celles que l'analyste trouve seul vont à part.
- **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/`.
@@ -1919,3 +1919,4 @@ 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 : un vérificateur de ses étiquettes ; agent `label-reviewer` construit (D-101), `revue` sur les étiquettes vérifiées, retiré par un Save.
- 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/`.
View File
Whitespace-only changes.
+3 -3
View File
@@ -2,7 +2,7 @@
voit, en langage naturel, sans catégorie ; les données se consultent sur le monitoring. En haut, le data loader de la page
Status ; un menu déroulant, un plot à la fois, comme le menu Advanced d'Explore, plus les métriques système numériques de
metrics/ (« System: … », sans les identifiants) ; dessous, une barre de temps aux mêmes abscisses, qui suit le zoom : y glisser sélectionne une plage, puis du texte et Add. Add écrit aussitôt une ligne dans
labeling/<STATION>.jsonl : {"debut": "2026-10-08T01:00Z", "fin": "2026-10-08T02:45Z", "description": "…"}, en UTC, les noms
labeling/manual/<STATION>.jsonl (D-102) : {"debut": "2026-10-08T01:00Z", "fin": "2026-10-08T02:45Z", "description": "…"}, en UTC, les noms
de champs de l'analyste (etiquettes.json). Les zones étiquetées sont grisées sur tous les plots ; sur la barre, une barre
chacune, son texte au survol, celles qui se chevauchent l'une sous l'autre. Un clic sur l'une l'affiche dessous, et Save y
enregistre son nouveau texte, Delete la retire ; ses bornes se corrigent dans ce fichier, puis recharger la page. Au survol
@@ -279,7 +279,7 @@ textarea{{width:100%;box-sizing:border-box;font:inherit;padding:6px}} select,but
def fichier(station):
return ICI / f"{station}.jsonl"
return ICI / "manual" / f"{station}.jsonl"
def lire(station):
@@ -361,7 +361,7 @@ class Serveur(chargeur.Chargeur):
try:
self.repond(lire(station))
except ValueError as e: # une ligne abîmée à la main : le dire, sans toucher au fichier
self.send_error(500, f"labeling/{station}.jsonl unreadable: {e}")
self.send_error(500, f"labeling/manual/{station}.jsonl unreadable: {e}")
def ecrit(self, action):
if self.path != "/labels":
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
+2 -2
View File
@@ -28,7 +28,7 @@ Détails : `extraction/README.md`.
python3 labeling/labeling.py
```
Choisir la station et les dates, puis Analyse. Glisser sur le plot zoome (double clic : tout revoir) ; glisser sur la barre dessous sélectionne une plage ; écrire ce qu'on voit, puis Add, qui écrit aussitôt une ligne dans `labeling/<STATION>.jsonl`. Un clic sur la barre d'une étiquette l'affiche dessous : modifier le texte, puis Save, ou la retirer par Delete. Ses bornes se corrigent dans ce fichier, puis recharger la page. Au survol d'une courbe : le capteur, sa valeur et l'heure. Si le code de l'outil change alors que son serveur tourne (port 8767) : `pkill -f labeling/labeling.py`.
Choisir la station et les dates, puis Analyse. Glisser sur le plot zoome (double clic : tout revoir) ; glisser sur la barre dessous sélectionne une plage ; écrire ce qu'on voit, puis Add, qui écrit aussitôt une ligne dans `labeling/manual/<STATION>.jsonl`. Un clic sur la barre d'une étiquette l'affiche dessous : modifier le texte, puis Save, ou la retirer par Delete. Ses bornes se corrigent dans ce fichier, puis recharger la page. Au survol d'une courbe : le capteur, sa valeur et l'heure. Si le code de l'outil change alors que son serveur tourne (port 8767) : `pkill -f labeling/labeling.py`.
Les events validés ont aussi leurs étiquettes, dans le fichier de leur station, au même format que les autres (D-100).
@@ -36,7 +36,7 @@ Dans le texte, dire la cause et comment on l'a sue (quel plot, quel signe). Éti
# Faire vérifier ses étiquettes (label-reviewer)
Dans une conversation Claude Code : `@label-reviewer labeling/<STATION>.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/<STATION>.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 : `@label-reviewer labeling/manual/<STATION>.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/<STATION>.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).
# Apprendre des étiquettes (labels-learner)