Record the analyst's labels at every loop batch (D-061, point 44)

Each batch now leaves etiquettes.json next to the critique: the analyst's
own reading, written before the detectors' output, one entry per moment,
checked by critiquer-lot/etiquettes.py against the event map and the
station's sensors. Groundwork for a future learned model.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-25 09:39:34 +01:00
1 parent da34d16d06
commit 02ed7a4a60
10 files changed
+206 -14

No files matched your search

+5 -4
View File
@@ -28,6 +28,7 @@ Tu es l'orchestrateur. Tu découpes la plage en lots, tu appelles les quatre age
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\*\* :' <rendu>`. Chaque commit se fait par chemin, `git add <chemins> && git commit -m "<message>" -- <chemins>`, et son message se termine par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
1. **Analyste** (`analyste`) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Écris <lot>/critique.md.`
`python3 .claude/skills/critiquer-lot/etiquettes.py <dossier> <lot>/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 `<lot>/`, message `Loop <STATION> lot NN: critique (<verdict>)`.
2. Verdict `d'accord` : va à l'étape 5.
3. **Upgrader** (`upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`.
@@ -56,9 +57,9 @@ Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pou
Branche : boucle/<SEANCE>_<STATION>
| Lot | Dates (UTC) | Analyste | Modification | Cas créés |
|---|---|---|---|---|
| 01 | … → … | d'accord / suggestions (n) | aucune / gardée (K passages) / annulée / erreur | C-xxx / aucun |
| Lot | Dates (UTC) | Analyste | Étiquettes | Modification | Cas créés |
|---|---|---|---|---|---|
| 01 | … → … | d'accord / suggestions (n) | n moments / absentes / n défauts | aucune / gardée (K passages) / annulée / erreur | C-xxx / aucun |
## Suggestions non traitées
<« Pas corrigé » des modifications ; suggestions d'un lot sans modification gardée>
@@ -79,4 +80,4 @@ Si `git status --short docs/ameliorations-processus.md` montre un changement : c
## 7. Réponse finale
En 5 lignes au plus : la branche, le chemin du bilan, le nombre de modifications gardées et de cas créés, les erreurs, les difficultés relevées. Reste sur la branche : l'utilisateur la fusionne, en garde une partie ou revient en arrière.
En 6 lignes au plus : la branche, le chemin du bilan, le nombre de modifications gardées et de cas créés, le nombre d'étiquettes (`<séance>/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. Reste sur la branche : l'utilisateur la fusionne, en garde une partie ou revient en arrière.
+22 -4
View File
@@ -24,13 +24,13 @@ Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dan
## Tes outils
Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossier de sortie>` pour tes figures. Bash sert aussi à lancer la commande du lot. N'écris aucun autre script.
Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossier de sortie>` pour tes figures. Bash sert aussi à lancer la commande du lot et le contrôle de tes étiquettes, `python3 .claude/skills/critiquer-lot/etiquettes.py <dossier> <dossier de sortie>/etiquettes.json`. N'écris aucun autre script.
## Déroulé
1. **Ta lecture, sans les détecteurs.** Lis le lot comme le dit `lire-les-donnees`. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ». **Écris cette partie dans ton fichier avant l'étape 2.**
1. **Ta lecture, sans les détecteurs.** Lis le lot comme le dit `lire-les-donnees`. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ». **Écris cette partie dans ton fichier avant l'étape 2**, puis tes **étiquettes** (ci-dessous) : une par ligne du tableau, dans le même ordre ; lance leur contrôle et corrige jusqu'à « bon ».
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 ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi.
3. **Comparaison**, événement par événement et moment par moment : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi. Un événement des détecteurs juste, que tu vérifies dans les données mais qui manque à ta lecture : ajoute-le à tes étiquettes avec `"apres_detecteurs": true`, et relance le contrôle. Ne change jamais les étiquettes de l'étape 1.
4. **Cas connus**, après les faits : lis l'index, ouvre au plus 3 fiches proches de tes moments. Ce que la base connaît déjà, cas marqués « (appris) » compris.
5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre), 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.
6. **Nouveautés** : ce que ni la carte ni l'index ne décrivent ; chacune avec son moment, ses capteurs, ce qui la montre et la figure.
@@ -73,6 +73,24 @@ aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou abse
La ligne Verdict porte un seul mot : `d'accord` ou `suggestions`. Sans suggestion, la partie 5 dit « aucune ». « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060). Les figures sont dans le dossier de sortie, citées par leur nom. Heures en UTC.
## Les étiquettes
`<dossier de sortie>/etiquettes.json` : ta lecture sous une forme qu'un script relit, pour entraîner plus tard un modèle (D-061). Le lot entier est lu : un instant sans moment veut dire que tu n'y as rien vu.
```json
{"station": "NORDEND", "debut": "2026-10-05T00:00Z", "fin": "2026-10-09T00:00Z", "moments": [
{"debut": "2026-10-08T01:00Z", "fin": "2026-10-08T02:45Z", "capteurs": ["PR01", "PR08", "PR02"],
"categorie": "visibilite_reduite", "evenement": "Rain or fog", "preuve": "vue",
"description": "Gouttes floues sur la vitre ; PR01 et PR08 rejetés.", "apres_detecteurs": false}]}
```
- `station` : le nom du dossier de station ; `debut`, `fin` : le lot ; toutes les heures en UTC, au format `AAAA-MM-JJTHH:MMZ`.
- `capteurs` : les noms exacts, tous écrits (pas de « idem », pas de « références ») ; `[]` seulement si tous les capteurs sont touchés.
- `categorie` : la clé de la section 4 de la carte (`visibilite_reduite`…), ou `"aucune"` (rien qui soit une catégorie du journal : début d'export, mouvement de caméra compensé…).
- `evenement` : le « Label du site » de la ligne de la section 1 de la carte qui dit la cause (`"Rain or fog"`, `"Spider web"`), ou `null` si la cause n'est pas établie.
- `preuve` : `"vue"` si les images la montrent, `"deduite"` si elle vient des courbes seules.
- `description` : ta colonne « Ce que je vois », en une ou deux phrases.
## Ta réponse
Après avoir écrit le fichier, réponds en 3 lignes : le verdict, le nombre de suggestions et de nouveautés, le chemin du fichier.
Après avoir écrit le fichier, réponds en 3 lignes : le verdict, le nombre de suggestions, de nouveautés et d'étiquettes, le chemin du fichier.
+123
View File
@@ -0,0 +1,123 @@
"""Étiquettes d'un lot : la lecture de l'analyste, moment par moment, dans un format qu'un script relit (point 44 du plan
du journal du matin, D-061) : la matière d'un futur modèle appris. Ce script contrôle un fichier ; il ne juge rien.
Un JSON par lot, <lot>/etiquettes.json :
{"station": "NORDEND", "debut": "2026-10-05T00:00Z", "fin": "2026-10-09T00:00Z", "moments": [
{"debut": "2026-10-08T02:30Z", "fin": "2026-10-09T00:00Z", "capteurs": ["PR17"], "categorie": "a_verifier",
"evenement": null, "preuve": "deduite", "description": "...", "apres_detecteurs": false}]}
- heures au format de donnees.iso ; capteurs : noms de la station, [] pour tous (contrat des détecteurs) ;
- categorie : une clé de la section 4 de la carte des événements, ou "aucune" ; evenement : le label du site d'une ligne
de sa section 1 (« Rain or fog »), ou null si la cause n'est pas établie ; la carte est la seule source du vocabulaire ;
- preuve : "vue" (sur les images) ou "deduite" (des courbes seules) ;
- apres_detecteurs : true pour un moment ajouté à la comparaison, vu dans les données après la sortie des détecteurs.
Un instant du lot sans moment : l'analyste n'y a rien vu.
Usage : python3 .claude/skills/critiquer-lot/etiquettes.py <dossier de station> <etiquettes.json>
python3 .claude/skills/critiquer-lot/etiquettes.py --test
"""
import json
import os
import re
import sys
from datetime import datetime
RACINE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..")
sys.path.insert(0, os.path.join(RACINE, "agents", "diagnostic", "outils"))
from donnees import charger # noqa: E402
CARTE = os.path.join(RACINE, "docs", "displacement", "domaine", "carte-des-evenements.md")
CHAMPS = {"debut", "fin", "capteurs", "categorie", "evenement", "preuve", "description", "apres_detecteurs"}
def vocabulaire():
"""Carte des événements -> (catégories du journal et "aucune", labels du site des événements)."""
texte = open(CARTE, encoding="utf-8").read()
s1, s4 = texte.split("## 1.")[1].split("## 2.")[0], texte.split("## 4.")[1]
cats = set(re.findall(r"^\| `(\w+)` \|", s4, re.M)) | {"aucune"}
evts = {c[1].strip() for ligne in s1.splitlines() if ligne.startswith("| ")
and len(c := ligne.split("|")[1:-1]) == 7 and not c[0].strip().startswith(("**", "Événement"))}
return cats, evts
def heure(v):
return datetime.strptime(v, "%Y-%m-%dT%H:%MZ") # TypeError, ValueError hors du format de donnees.iso
def defauts(lot, station, capteurs, cats, evts):
"""Étiquettes d'un lot -> défauts, une phrase chacun (aucun : le fichier est bon)."""
try:
debut, fin, moments = heure(lot["debut"]), heure(lot["fin"]), list(lot["moments"])
except (KeyError, TypeError, ValueError) as e:
return [f"en-tête : {type(e).__name__} {e} ; attendus : station, debut, fin (AAAA-MM-JJTHH:MMZ), moments"]
out = [] if lot.get("station") == station else [f"station {lot.get('station')!r}, le dossier est {station!r}"]
for i, m in enumerate(moments, 1):
def ko(msg):
out.append(f"moment {i} : {msg}")
if not isinstance(m, dict) or set(m) != CHAMPS:
ko(f"champs {sorted(m) if isinstance(m, dict) else m!r} ; attendus {sorted(CHAMPS)}")
continue
try:
d, f = heure(m["debut"]), heure(m["fin"])
if d > f:
ko("debut après fin")
elif f < debut or d > fin:
ko("hors du lot")
except (TypeError, ValueError):
ko(f"heures {m['debut']!r} → {m['fin']!r} : format AAAA-MM-JJTHH:MMZ")
if not isinstance(m["capteurs"], list) or (inconnus := [c for c in m["capteurs"] if c not in capteurs]):
ko(f"capteurs {m['capteurs']!r} : une liste de noms de la station, [] pour tous")
if m["categorie"] not in cats:
ko(f"categorie {m['categorie']!r} : une de {sorted(cats)}")
if m["evenement"] is not None and m["evenement"] not in evts:
ko(f"evenement {m['evenement']!r} : null ou un label du site de la section 1 de la carte")
if m["preuve"] not in ("vue", "deduite"):
ko(f"preuve {m['preuve']!r} : \"vue\" ou \"deduite\"")
if not isinstance(m["description"], str) or not m["description"].strip():
ko("description vide")
if not isinstance(m["apres_detecteurs"], bool):
ko("apres_detecteurs : true ou false")
return out
def controler(dossier, chemin):
try:
with open(chemin, encoding="utf-8") as f:
lot = json.load(f)
except (OSError, ValueError) as e:
print(f"{chemin} : illisible ({e})")
return 1
station = os.path.basename(os.path.normpath(dossier))
out = defauts(lot, station, set(charger(dossier)), *vocabulaire())
for d in out:
print(d)
print(f"{chemin} : {len(out)} défaut(s)" if out else f"{chemin} : bon, {len(lot['moments'])} moment(s)")
return 1 if out else 0
def test():
"""Deux moments réels de l'essai de l'analyste (NORDEND, lot 1, 2026-10-24), puis quatre fautes."""
dossier = os.path.join(RACINE, "vues-deplacements", "cas", "2026-10_NORDEND", "NORDEND")
args = ("NORDEND", set(charger(dossier)), *vocabulaire())
bon = {"station": "NORDEND", "debut": "2026-10-05T00:00Z", "fin": "2026-10-09T00:00Z", "moments": [
{"debut": "2026-10-08T01:00Z", "fin": "2026-10-08T02:45Z", "capteurs": ["PR01", "PR08", "PR02"],
"categorie": "visibilite_reduite", "evenement": "Rain or fog", "preuve": "vue",
"description": "Gouttes floues sur la vitre ; PR01 et PR08 rejetés.", "apres_detecteurs": False},
{"debut": "2026-10-08T02:30Z", "fin": "2026-10-09T00:00Z", "capteurs": ["PR17"], "categorie": "a_verifier",
"evenement": None, "preuve": "deduite", "description": "Saut durable de corr_y, sans retour.",
"apres_detecteurs": False}]}
assert defauts(bon, *args) == [], defauts(bon, *args)
faux = json.loads(json.dumps(bon))
faux["moments"][0]["capteurs"] = ["idem"]
faux["moments"][0]["categorie"] = "dilatation / contraction thermique"
faux["moments"][1]["fin"] = "2026-10-08T01:00Z"
del faux["moments"][1]["preuve"]
assert len(defauts(faux, *args)) == 3, defauts(faux, *args) # le champ manquant arrête le moment 2 : 2 + 1
print("test : bon")
if __name__ == "__main__":
if sys.argv[1:] == ["--test"]:
test()
elif len(sys.argv) == 3:
sys.exit(controler(*sys.argv[1:]))
else:
sys.exit(__doc__)