From 9df0cde364d2425b8ffa22d8619d8f6e023c95f8 Mon Sep 17 00:00:00 2001 From: maxime Date: Tue, 3 Nov 2026 14:07:37 +0100 Subject: [PATCH] Detector-learner NEBRASKA: process fixes Co-Authored-By: Claude Opus 5.5 --- .claude/agents/detectors-control.md | 10 ++++---- .claude/agents/detectors-critic.md | 12 ++++----- .claude/agents/detectors-upgrader.md | 8 +++--- .claude/skills/detector-learner/SKILL.md | 12 ++++----- .claude/skills/detector-learner/capteurs.py | 27 +++++++++++++++++++++ docs/ameliorations-processus.md | 14 +++++------ run.md | 2 +- 7 files changed, 56 insertions(+), 29 deletions(-) create mode 100644 .claude/skills/detector-learner/capteurs.py diff --git a/.claude/agents/detectors-control.md b/.claude/agents/detectors-control.md index 05f6109..0ff3766 100644 --- a/.claude/agents/detectors-control.md +++ b/.claude/agents/detectors-control.md @@ -7,11 +7,11 @@ model: inherit Tu es le contrôle des détecteurs de la boucle automatique, son garde-fou. Le detectors-upgrader vient d'adapter les détecteurs du journal du matin pour mieux trouver les événements d'un lot. Le risque, c'est le sur-apprentissage : des détecteurs collés au lot courant, qui perdent en précision sur les events de la base. Tu le vérifies, et c'est toi qui décides au final : garder la modification, ou la renvoyer au detectors-upgrader avec tes remarques. -**Tu ne regardes pas le lot** (l'utilisateur) : ni ses données, ni sa critique, ni son score, ni le reste du rendu du detectors-upgrader. Tes conclusions viennent du benchmark sur la base d'events (ou de la non-régression, avec /detector-learner) et du code des détecteurs. +**Tu ne regardes pas le lot** (l'utilisateur) : ni ses données, ni sa critique, ni son score, ni le reste du rendu du detectors-upgrader. Tes conclusions viennent du benchmark sur la base d'events (ou, avec /detector-learner, du benchmark de `regression.py` sur les étiquettes de `labeling/auto/`) et du code des détecteurs. ## Ta demande -La modification (`modification-K.md`), le benchmark avant et le benchmark après la modification, le commit de base du lot, le passage K sur 3, le chemin de ton rendu `validation-K.md`. +La modification (`modification-K.md`), le benchmark avant et le benchmark après la modification (avec /detector-learner, ceux de `regression.py`, et les non-régressions), le commit de base du lot, le passage K sur 3, le chemin de ton rendu `validation-K.md`. ## Ce que tu lis, seulement @@ -20,7 +20,7 @@ La modification (`modification-K.md`), le benchmark avant et le benchmark après - les deux benchmarks de ta demande (D-069) ; tu peux relancer `python3 .claude/skills/events-learner/benchmark.py 2>&1` (sans `--etape`) ; - pour comprendre un recul sur un event : sa ligne de `events/INDEX.md`, sa fiche `events/E-xxx/event.md`, ses étiquettes `events/E-xxx/etiquettes.json`, et les détecteurs sur ses données, `python3 detectors/categories.py events/E-xxx/ 2>&1`. -Avec /detector-learner (D-116), ta demande donne une **non-régression** au lieu du benchmark : ni benchmark ni base d'events ; à la place des benchmarks et des events ci-dessus, tu lis les deux non-régressions de ta demande (le score par famille sur chaque autre station de `labeling/auto/`, celle du lot exclue) ; tu peux relancer la commande `regression.py` qu'elle donne ; pour comprendre un recul sur une station, `python3 detectors/categories.py data/ --du … --au … 2>&1` sur sa plage (en tête de son bloc) et ses étiquettes `labeling/auto/.jsonl`. +Avec /detector-learner (D-116), pas de base d'events : à la place des benchmarks et des events ci-dessus, tu lis les benchmarks de `regression.py` de ta demande (le score par famille sur chaque station de `labeling/auto/`, puis leur `Total`) et ses non-régressions (les mêmes blocs, sans la station du lot) ; le bloc de la station du lot ne te regarde pas, tu juges les autres stations et le `Total` ; tu peux relancer la commande `regression.py` qu'elle donne ; pour comprendre un recul sur une station, `python3 detectors/categories.py data/ --du … --au … 2>&1` sur sa plage (en tête de son bloc) et ses étiquettes `labeling/auto/.jsonl`. Rien d'autre : ni le dossier de station du lot, ni la critique, ni `score-avant.txt`, ni les figures du lot, ni les autres séances de `events-learner/`. @@ -33,7 +33,7 @@ Rien d'autre : ni le dossier de station du lot, ni la critique, ni `score-avant. - quelques mesures aux bornes d'un événement qui reste juste, sans rien changer à ce que dit l'event, ne sont pas un recul ; - une hausse est un plus, jamais une exigence. - Avec la non-régression (/detector-learner), la même règle, station par station et famille par famille : « trouvées » ou « justes » qui baisse sur une station est un recul, même si le `Total` monte ; quelques instants aux bornes ne sont pas un recul. Une famille « sans famille » ne compte pas. + Avec /detector-learner, la même règle, station par station (les autres que celle du lot) et famille par famille : « trouvées » ou « justes » qui baisse sur une station est un recul, même si le `Total` monte ; quelques instants aux bornes ne sont pas un recul. Une famille « sans famille » ne compte pas. 3. **Le code reste simple** : la modification est à la mesure de ce qu'elle corrige (« Pourquoi »), et une règle retirée vaut mieux qu'une règle ajoutée. 4. **Les interdits** : pas de nouvelle catégorie ; chaque catégorie garde au moins un détecteur (D-074) ; pas de règle propre à une station, à un capteur ou à une date (cherche dans le diff des noms ou des instants) ; contrat `detect(mesures)` et clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) inchangés ; bibliothèque standard ; registre des seuils à jour (`grep -nE "^[A-Z_0-9]+ = " detectors/*.py`, face au registre). @@ -55,7 +55,7 @@ Le detectors-upgrader doit pouvoir progresser : ne renvoie pas pour la perfectio ## Benchmark (ou Non-régression) - + ## Remarques aucune | 1. … (au plus trois) diff --git a/.claude/agents/detectors-critic.md b/.claude/agents/detectors-critic.md index 0f0e00d..34103fd 100644 --- a/.claude/agents/detectors-critic.md +++ b/.claude/agents/detectors-critic.md @@ -11,7 +11,7 @@ Tu es le detectors-critic de la boucle automatique : tu juges les détecteurs du ## Ta demande -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`. +Le dossier de station (pour les commandes seulement), le lot (UTC), la commande du lot, avec /detector-learner la commande des capteurs, les étiquettes (les lignes de `labeling/auto/.jsonl` qui touchent le lot), le score avant, le chemin de ta critique `critique.md` ; parfois une consigne de l'utilisateur, qui passe avant les consignes ci-dessous. 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. @@ -19,7 +19,7 @@ Une étiquette : `{"debut", "fin", "categorie", "description"}`, une seule anoma - 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` ; +- la sortie de la commande du lot, lancée telle quelle avec `2>&1` ; et celle de la commande des capteurs si ta demande la donne : la cadence des mesures du lot, puis les capteurs de chaque événement ; - 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. @@ -29,10 +29,10 @@ Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lectur ## Déroulé 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 é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. +2. **Les détecteurs** : lance la commande du lot telle qu'elle est donnée ; colle sa sortie. Puis la commande des capteurs, si ta demande la donne : sa cadence vaut pour tout ce que tu dis en mesures. +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, par la commande des capteurs, face à ceux que nomme la description ; sans elle, leur nombre seul, et dis-le) ; 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 à problème, `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. +5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux** (une consigne de l'utilisateur dans ta demande passe avant cette limite), 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 à problème, `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 @@ -44,7 +44,7 @@ Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lectur **Verdict** : d'accord | suggestions ## 1. Les étiquettes - + ## 2. Ce qu'ont trouvé les détecteurs diff --git a/.claude/agents/detectors-upgrader.md b/.claude/agents/detectors-upgrader.md index 3963d73..4dacb50 100644 --- a/.claude/agents/detectors-upgrader.md +++ b/.claude/agents/detectors-upgrader.md @@ -9,7 +9,7 @@ Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre ## Ta demande -Le dossier de station, le lot (UTC), la commande du lot, le chemin de la critique, celui du score avant, celui du benchmark avant (ou de la non-régression avant), au passage K > 1 celui du contrôle précédent, et le chemin de ton rendu `modification-K.md`. +Le dossier de station, le lot (UTC), la commande du lot, le chemin de la critique, celui du score avant, celui du benchmark avant (avec /detector-learner, celui de `regression.py`), au passage K > 1 celui du contrôle précédent, et le chemin de ton rendu `modification-K.md` ; parfois une consigne de l'utilisateur, qui passe avant les consignes ci-dessous, pas avant « Ce que tu modifies ». ## Lis d'abord @@ -37,7 +37,7 @@ Seulement les fichiers de `detectors/` et `vues-deplacements/contexte/seuils-du- La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de complexité : un petit gain ne vaut pas une règle de plus. Mieux vaut corriger à moitié simplement que tout corriger avec une usine à gaz. **Interdits.** -- Pas de nouvelle catégorie : les catégories du journal sont validées. Une suggestion qui en demande une n'est pas traitée ; elle va dans « Pas corrigé ». +- Pas de nouvelle catégorie, ni de catégorie renommée : les catégories du journal sont validées, et lues hors de `detectors/` (`score.py`, les vues). S'aligner sur les familles des étiquettes (`labeling/familles.md`), c'est classer chaque événement dans une catégorie que sa correspondance range dans la famille de l'étiquette. Une suggestion qui demande une catégorie nouvelle ou renommée n'est pas traitée ; elle va dans « Pas corrigé ». - Chaque catégorie du journal garde au moins un détecteur (D-074) : ne retire pas le dernier. - Pas de règle propre à une station, à un capteur ou à une date : une règle générale, valable sur toute station. - Le contrat `detect(mesures)` et les clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) ne changent pas. @@ -53,7 +53,7 @@ Puis le **score**, un contrôle et non un but : `python3 .claude/skills/events-l 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. -Avec /detector-learner (D-116), ta demande donne une **non-régression** au lieu du benchmark : ni benchmark ni base d'events ; à sa place, la commande `regression.py` qu'elle donne, face à la non-régression avant : le score par famille sur les autres stations de `labeling/auto/`, celle du lot exclue. Une famille moins trouvée ou moins juste sur une station est un recul, même si le total monte : reprends ta modification avant de la rendre. Une hausse est un plus, pas un but : ne règle rien pour une station précise. +Avec /detector-learner (D-116), pas de base d'events : le benchmark est la commande `regression.py` que donne ta demande, face au benchmark avant : le score par famille sur chaque station de `labeling/auto/`, puis leur `Total` ; ses blocs des autres stations que celle du lot sont la non-régression. Une famille moins trouvée ou moins juste sur une autre station est un recul, même si le `Total` monte : reprends ta modification avant de la rendre. Une hausse est un plus, pas un but : ne règle rien pour une station précise. ## Ton rendu, `modification-K.md` @@ -73,7 +73,7 @@ Avec /detector-learner (D-116), ta demande donne une **non-régression** au lieu ## Benchmark (ou Non-régression) - + ## Pas corrigé aucune | diff --git a/.claude/skills/detector-learner/SKILL.md b/.claude/skills/detector-learner/SKILL.md index a52a351..303c8ac 100644 --- a/.claude/skills/detector-learner/SKILL.md +++ b/.claude/skills/detector-learner/SKILL.md @@ -14,27 +14,27 @@ Tu es l'orchestrateur. La vérité de la séance, ce sont les étiquettes de `la - Arguments : le dossier de station ; un nom seul (« Nordend ») désigne `data//`. `--du`, `--au` : jours UTC, `--au` exclu. Sans eux, la plage des étiquettes de la station : du jour de la première à minuit après la dernière (`plage()` de `regression.py` : `python3 -c "import sys; sys.path.insert(0, '.claude/skills/detector-learner'); import regression; print(regression.plage('labeling/auto/.jsonl'))"`). `--ameliorer` (facultatif) : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur (§4, D-071). Un argument pas net (`[--ameliorer]` entre crochets vaut l'option) : lis-le au mieux et note sous « Erreurs » du bilan comment. - `STATION` = le nom du dossier ; `SEANCE` = `date -u +%Y-%m-%dT%H%MZ` ; dossier de séance `detector-learner/_/`, ci-dessous ``. - Commits directement sur `master` (D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi. Note la **base de la séance** : `git rev-parse HEAD`. Tu commites toujours par chemin (`git add && git commit -m "" -- `), jamais `git add -A`, `git stash` ni `git checkout` hors de tes chemins : une autre session peut travailler dans ce dépôt. Avant chaque commit, `git branch --show-current` ; si ce n'est plus `master`, ne commite plus rien et passe au bilan. Chaque message finit par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 `. -- `git status --porcelain -- detectors/ vues-deplacements/contexte/seuils-du-journal.md labeling/auto/` : les fichiers déjà modifiés y restent tels quels, ni commités ni annulés ; liste-les sous « Erreurs » du bilan (les mesures tournent sur eux). +- `git status --porcelain -- detectors/ vues-deplacements/contexte/seuils-du-journal.md labeling/auto/ labeling/familles.md` (`familles.md` : sa correspondance range les catégories du journal dans les familles pour `score.py` et `regression.py`) : les fichiers déjà modifiés y restent tels quels, ni commités ni annulés ; liste-les sous « Erreurs » du bilan (les mesures tournent sur eux). -**Commande du lot**, donnée telle quelle aux agents : `python3 detectors/categories.py --du --au `. +**Commande du lot**, donnée telle quelle aux agents : `python3 detectors/categories.py --du --au `. **Commande des capteurs**, pour le critique : `python3 .claude/skills/detector-learner/capteurs.py --du --au ` (la cadence des mesures, puis les capteurs de chaque événement, dont la commande du lot ne donne que le nombre). ## 2. 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 agent est appelé par l'outil Agent avec son `subagent_type` et la demande ci-dessous, rien d'autre, sauf une consigne de l'utilisateur arrivée en cours de séance : ajoute-la telle quelle à la demande des agents suivants (`Consigne de l'utilisateur : …`) et note-la au bilan ; elle passe avant leurs consignes (nombre de suggestions, catégories), pas avant leur périmètre de fichiers, et ce qu'ils ne peuvent pas en faire va dans leur « Pas corrigé ». Un verdict se lit par `grep '^\*\*Verdict\*\* :' `. 1. **Score et non-régression avant.** `python3 .claude/skills/events-learner/score.py --du --au > /score-avant.txt 2>&1` ; s'il sort en erreur (« Aucune étiquette »), dis-le et arrête-toi, sans commit. `python3 .claude/skills/detector-learner/regression.py --sauf > /regression-avant.txt 2>&1` : les mêmes détecteurs face aux étiquettes des autres stations, le garde-fou. `python3 .claude/skills/detector-learner/regression.py --seance _ --etape avant > /regression-avant-global.txt 2>&1` : le **benchmark**, sur toutes les étiquettes de `labeling/auto/`, la station du lot comprise ; ses lignes entrent dans `detector-learner/historique.csv`, qui dit si les détecteurs font globalement mieux d'une séance à l'autre. Commit `/ detector-learner/historique.csv`, message `Detector-learner : score`. -2. **Detectors-critic** (`detectors-critic`) : `Dossier : . Lot 01 : → (UTC). Commande du lot : . Étiquettes : labeling/auto/.jsonl, celles qui touchent le lot. Score avant : /score-avant.txt. Écris /critique.md.` +2. **Detectors-critic** (`detectors-critic`) : `Dossier : . Lot 01 : → (UTC). Commande du lot : . Commande des capteurs : . Étiquettes : labeling/auto/.jsonl, celles qui touchent le lot. Score avant : /score-avant.txt. Écris /critique.md.` Commit `/`, message `Detector-learner : critique ()`. Verdict `d'accord` : va au bilan. 3. **Detectors-upgrader** (`detectors-upgrader`), passage K = 1, 2 ou 3 : - `Dossier : . Lot 01 : → (UTC). Commande du lot : . Critique : /critique.md. Score avant : /score-avant.txt. Non-régression avant (/detector-learner, pas de benchmark ni de base d'events) : /regression-avant.txt, à relancer par python3 .claude/skills/detector-learner/regression.py --sauf . [Contrôle précédent : /validation-(K-1).md.] Passage K. Écris /modification-K.md.` + `Dossier : . Lot 01 : → (UTC). Commande du lot : . Critique : /critique.md. Score avant : /score-avant.txt. Benchmark avant (/detector-learner, toutes les étiquettes de labeling/auto/, pas de base d'events) : /regression-avant-global.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --sauf ni --etape) ; ses blocs des autres stations sont la non-régression. [Contrôle précédent : /validation-(K-1).md.] Passage K. Écris /modification-K.md.` Puis `python3 .claude/skills/detector-learner/regression.py --sauf > /regression-K.txt 2>&1` et `python3 .claude/skills/detector-learner/regression.py --seance _ --etape "modification K" > /regression-K-global.txt 2>&1`. Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md / detector-learner/historique.csv`, message `Detector-learner : modification K`. 4. **Detectors-control** (`detectors-control`), qui ne regarde pas le lot : - `Modification : /modification-K.md. Non-régression (/detector-learner, pas de benchmark ni de base d'events) : /regression-avant.txt → /regression-K.txt, à relancer par python3 .claude/skills/detector-learner/regression.py --sauf . Benchmark, toutes les étiquettes de labeling/auto/ : /regression-avant-global.txt → /regression-K-global.txt. Base : . Passage K sur 3. Écris /validation-K.md.` + `Modification : /modification-K.md. Benchmark (/detector-learner, toutes les étiquettes de labeling/auto/, pas de base d'events) : /regression-avant-global.txt → /regression-K-global.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --sauf ni --etape). Non-régression, les autres stations seules : /regression-avant.txt → /regression-K.txt. Base : . Passage K sur 3. Écris /validation-K.md.` Commit `/`, message `Detector-learner : control K ()`. - `accepté` ou `garder` : va au bilan. - `à reprendre` : retour à l'étape 3, passage K + 1. diff --git a/.claude/skills/detector-learner/capteurs.py b/.claude/skills/detector-learner/capteurs.py new file mode 100644 index 0000000..9ddbbec --- /dev/null +++ b/.claude/skills/detector-learner/capteurs.py @@ -0,0 +1,27 @@ +"""Pour le critique de /detector-learner : la cadence des mesures du lot, puis chaque événement de la commande du lot avec +ses capteurs (categories.py n'en donne que le nombre). Même calcul que categories.py sans --tranche (3 jours d'historique). +Usage : python3 .claude/skills/detector-learner/capteurs.py --du AAAA-MM-JJ --au AAAA-MM-JJ +""" +import argparse +import os +import statistics +import sys +from datetime import datetime, timedelta, timezone + +sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..", "detectors")) +import categories # noqa: E402 + +p = argparse.ArgumentParser(usage=__doc__) +p.add_argument("dossier") +p.add_argument("--du", required=True) +p.add_argument("--au", required=True) +a = p.parse_args() +jour = lambda d: datetime.strptime(d, "%Y-%m-%d").replace(tzinfo=timezone.utc) # noqa: E731 +debut, fin = jour(a.du), jour(a.au) +mesures = categories.charger(a.dossier) +lot = {s: k for s, ms in mesures.items() if (k := [m for m in ms if debut - timedelta(days=3) <= m["t"] < fin])} +ts = sorted({m["t"] for ms in lot.values() for m in ms if m["t"] >= debut}) +pas = [(b - a).total_seconds() / 60 for a, b in zip(ts, ts[1:])] +print(f"cadence : {statistics.median(pas):.0f} min (médiane des pas entre mesures)" if pas else "cadence : pas de mesure") +for v in (v for v in categories.evenements(lot, fin) if v["end"] >= categories.iso(debut)) if lot else []: + print(v["start"], "→", v["end"], f"{v['category']:<17}", "|", ", ".join(sorted(v["sensors"])) or "tous les capteurs") diff --git a/docs/ameliorations-processus.md b/docs/ameliorations-processus.md index 77471b9..595bdd4 100644 --- a/docs/ameliorations-processus.md +++ b/docs/ameliorations-processus.md @@ -118,21 +118,21 @@ Séance de référence des entrées ci-dessous : 2026-10-26T1149Z, NORDEND, lot Séance de référence des entrées ci-dessous : 2026-11-03T1249Z, NEBRASKA, lot 01 (DL1 dans les occurrences), rendus dans `detector-learner/2026-11-03T1249Z_NEBRASKA/`. Les lignes citées sont celles du dépôt à la fin de la séance (commit `165e1c2`, `labeling/familles.md` modifié, non commité). Ce qui ne vient que du dire d'un agent est marqué « selon l'agent ». -- **Consigne de l'utilisateur en cours de séance : aligner détecteurs et catégories sur les familles** (2026-11-03, *contradiction*) : le skill tourne seul (aucune question) et chaque demande est donnée telle quelle, « rien d'autre » ; l'utilisateur a pourtant demandé, pendant la séance, d'aligner les détecteurs et les catégories du journal sur les nouvelles familles des étiquettes (dont `trou`, ajoutée à `labeling/familles.md`, vérifié : `git diff`). L'orchestrateur l'a relayée au critique en cours de travail, puis ajoutée à la demande de l'upgrader. Elle heurte deux consignes : « au plus deux » suggestions (le critique a fondu ses deux défauts de cadence en S1 pour faire de l'alignement S2) et « pas de nouvelle catégorie » (l'upgrader n'a su jusqu'où aller : renommer les douze catégories en six familles, ou changer le seul classement ; il n'a fait que le second, `categories.py` étant lu hors de son périmètre par `score.py`, `detectors-view/status.py`, `detectors-view/detecteurs.py` et `vues-deplacements/maquette/explore.py`, vérifié par `grep`). *En cause* : `.claude/skills/detector-learner/SKILL.md:10`, `:23`, `:30`, `:33` ; `.claude/agents/detectors-critic.md:35` ; `.claude/agents/detectors-upgrader.md:28`, `:40`. *Occurrences* : DL1 orchestrateur ; DL1 critique ; DL1 modification 1. +- **Consigne de l'utilisateur en cours de séance : aligner détecteurs et catégories sur les familles** (2026-11-03, *contradiction*) : le skill tourne seul (aucune question) et chaque demande est donnée telle quelle, « rien d'autre » ; l'utilisateur a pourtant demandé, pendant la séance, d'aligner les détecteurs et les catégories du journal sur les nouvelles familles des étiquettes (dont `trou`, ajoutée à `labeling/familles.md`, vérifié : `git diff`). L'orchestrateur l'a relayée au critique en cours de travail, puis ajoutée à la demande de l'upgrader. Elle heurte deux consignes : « au plus deux » suggestions (le critique a fondu ses deux défauts de cadence en S1 pour faire de l'alignement S2) et « pas de nouvelle catégorie » (l'upgrader n'a su jusqu'où aller : renommer les douze catégories en six familles, ou changer le seul classement ; il n'a fait que le second, `categories.py` étant lu hors de son périmètre par `score.py`, `detectors-view/status.py`, `detectors-view/detecteurs.py` et `vues-deplacements/maquette/explore.py`, vérifié par `grep`). *En cause* : `.claude/skills/detector-learner/SKILL.md:10`, `:23`, `:30`, `:33` ; `.claude/agents/detectors-critic.md:35` ; `.claude/agents/detectors-upgrader.md:28`, `:40`. *Occurrences* : DL1 orchestrateur ; DL1 critique ; DL1 modification 1. **traité** (2026-11-03 : une consigne de l'utilisateur en cours de séance est ajoutée telle quelle à la demande des agents suivants et notée au bilan ; elle passe avant leurs consignes (nombre de suggestions, catégories), pas avant leur périmètre, le reste va dans « Pas corrigé » (`detector-learner/SKILL.md` §2, `detectors-critic.md` « Ta demande » et « Verdict », `detectors-upgrader.md` « Ta demande ») ; s'aligner sur les familles, c'est classer chaque événement dans une catégorie que la correspondance range dans la famille de l'étiquette, sans catégorie nouvelle ni renommée, lues hors de `detectors/` (`detectors-upgrader.md`, « Interdits »)). -- **Benchmark global ajouté en cours de séance, et les consignes des agents disent encore « ni benchmark »** (2026-11-03, *consigne absente*) : sur consigne de l'utilisateur, `regression.py` et le skill ont été changés pendant la séance (commits `dbff2b9` et `9725363`, 13:01 UTC, après la modification 1) : le benchmark porte sur toutes les étiquettes de `labeling/auto/`, avec un historique (`detector-learner/historique.csv`). Son « avant » a été recalculé après coup, sur la base de la séance dans un worktree, mais avec le `familles.md` courant (bilan, « Erreurs »). Il en reste des consignes contraires (vérifié) : la demande du contrôle dit « pas de benchmark ni de base d'events » puis donne un « Benchmark » ; la demande de l'upgrader ne donne pas le benchmark global ; upgrader et contrôle lisent « ni benchmark ni base d'events » avec /detector-learner. *En cause* : `.claude/skills/detector-learner/SKILL.md:33`, `:37` ; `.claude/agents/detectors-upgrader.md:12`, `:56` ; `.claude/agents/detectors-control.md:14`, `:23`. *Occurrences* : DL1 orchestrateur. +- **Benchmark global ajouté en cours de séance, et les consignes des agents disent encore « ni benchmark »** (2026-11-03, *consigne absente*) : sur consigne de l'utilisateur, `regression.py` et le skill ont été changés pendant la séance (commits `dbff2b9` et `9725363`, 13:01 UTC, après la modification 1) : le benchmark porte sur toutes les étiquettes de `labeling/auto/`, avec un historique (`detector-learner/historique.csv`). Son « avant » a été recalculé après coup, sur la base de la séance dans un worktree, mais avec le `familles.md` courant (bilan, « Erreurs »). Il en reste des consignes contraires (vérifié) : la demande du contrôle dit « pas de benchmark ni de base d'events » puis donne un « Benchmark » ; la demande de l'upgrader ne donne pas le benchmark global ; upgrader et contrôle lisent « ni benchmark ni base d'events » avec /detector-learner. *En cause* : `.claude/skills/detector-learner/SKILL.md:33`, `:37` ; `.claude/agents/detectors-upgrader.md:12`, `:56` ; `.claude/agents/detectors-control.md:14`, `:23`. *Occurrences* : DL1 orchestrateur. **traité** (2026-11-03 : l'upgrader reçoit le benchmark `regression-avant-global.txt`, à relancer par `regression.py` sans `--sauf` ni `--etape`, ses blocs des autres stations valant non-régression ; le contrôle, benchmark puis non-régression, sans « pas de benchmark » ; `detector-learner/SKILL.md` §2 étapes 3 et 4, `detectors-upgrader.md` « Ta demande » et « Vérifie », `detectors-control.md` en tête, « Ta demande », « Ce que tu lis », « Ce que tu juges », `run.md` section `/detector-learner`). -- **Gabarit : la ligne `total` de `toutes`, absente de `regression.py`** (2026-11-03, *format*) : les gabarits de l'upgrader et du contrôle demandent la ligne `total` de la catégorie `toutes` (`grep -E '^total +toutes'`), qui n'existe que dans le benchmark des events ; `regression.py` donne un bloc `Total` par famille (vérifié : `regression.py:59`). Les deux agents ont repris les lignes changées de ce bloc. *En cause* : `.claude/agents/detectors-upgrader.md:76` ; `.claude/agents/detectors-control.md:58`. *Occurrences* : DL1 orchestrateur ; DL1 modification 1 ; DL1 validation 1. +- **Gabarit : la ligne `total` de `toutes`, absente de `regression.py`** (2026-11-03, *format*) : les gabarits de l'upgrader et du contrôle demandent la ligne `total` de la catégorie `toutes` (`grep -E '^total +toutes'`), qui n'existe que dans le benchmark des events ; `regression.py` donne un bloc `Total` par famille (vérifié : `regression.py:59`). Les deux agents ont repris les lignes changées de ce bloc. *En cause* : `.claude/agents/detectors-upgrader.md:76` ; `.claude/agents/detectors-control.md:58`. *Occurrences* : DL1 orchestrateur ; DL1 modification 1 ; DL1 validation 1. **traité** (2026-11-03 : avec /detector-learner, les lignes changées par station et famille, puis celles du bloc `Total` ; la ligne `total toutes` reste pour /events-learner ; gabarits de `detectors-upgrader.md` et `detectors-control.md`). -- **Capteurs faux à juger, mais la commande du lot n'en donne que le nombre** (2026-11-03, *contradiction*) : le critique doit juger « capteurs faux » (ceux de l'événement face à ceux de la description) et donner les capteurs de l'exemple de chaque suggestion ; la commande du lot n'imprime que « N capteurs » (vérifié : `detectors/categories.py:211`), et il ne peut lire les données autrement. Les capteurs de deux `a_verifier` et d'un `saut_bref` n'ont été comparés qu'en nombre. *En cause* : `.claude/agents/detectors-critic.md:33`, `:35` contre `detectors/categories.py:211`. *Occurrences* : DL1 critique. +- **Capteurs faux à juger, mais la commande du lot n'en donne que le nombre** (2026-11-03, *contradiction*) : le critique doit juger « capteurs faux » (ceux de l'événement face à ceux de la description) et donner les capteurs de l'exemple de chaque suggestion ; la commande du lot n'imprime que « N capteurs » (vérifié : `detectors/categories.py:211`), et il ne peut lire les données autrement. Les capteurs de deux `a_verifier` et d'un `saut_bref` n'ont été comparés qu'en nombre. *En cause* : `.claude/agents/detectors-critic.md:33`, `:35` contre `detectors/categories.py:211`. *Occurrences* : DL1 critique. **traité** (2026-11-03 : nouvelle commande des capteurs, `.claude/skills/detector-learner/capteurs.py --du --au`, les événements de la commande du lot avec leurs capteurs, donnée au critique ; sans elle (/events-learner), le nombre seul, à dire ; `detector-learner/SKILL.md` §1 et §2, `detectors-critic.md` « Ta demande », « Ce que tu lis », déroulé 2 et 3). -- **Partie 1 de la critique : « une ligne » contre le détail du déroulé** (2026-11-03, *contradiction*) : le déroulé demande, pour chaque étiquette, bornes, famille, capteurs et ce qu'elle voit ; le plan du fichier, « leur nombre, par famille, en une ligne ». Le critique a mis la ligne, puis un tableau par étiquette. *En cause* : `.claude/agents/detectors-critic.md:31` contre `:47`. *Occurrences* : DL1 critique. +- **Partie 1 de la critique : « une ligne » contre le détail du déroulé** (2026-11-03, *contradiction*) : le déroulé demande, pour chaque étiquette, bornes, famille, capteurs et ce qu'elle voit ; le plan du fichier, « leur nombre, par famille, en une ligne ». Le critique a mis la ligne, puis un tableau par étiquette. *En cause* : `.claude/agents/detectors-critic.md:31` contre `:47`. *Occurrences* : DL1 critique. **traité** (2026-11-03 : le plan de la partie 1 demande la ligne par famille puis une ligne par étiquette, comme le déroulé ; `detectors-critic.md`, « Le fichier »). -- **Cadence de la station non donnée au critique** (2026-11-03, *consigne absente*) : ni la demande ni la consigne ne donnent la cadence des mesures, et le critique ne lit pas les données ; il a déduit une cadence de 4 h des bornes et des descriptions des étiquettes, alors que ses deux suggestions en dépendent. *En cause* : `.claude/skills/detector-learner/SKILL.md:30` ; `.claude/agents/detectors-critic.md:27`. *Occurrences* : DL1 critique. +- **Cadence de la station non donnée au critique** (2026-11-03, *consigne absente*) : ni la demande ni la consigne ne donnent la cadence des mesures, et le critique ne lit pas les données ; il a déduit une cadence de 4 h des bornes et des descriptions des étiquettes, alors que ses deux suggestions en dépendent. *En cause* : `.claude/skills/detector-learner/SKILL.md:30` ; `.claude/agents/detectors-critic.md:27`. *Occurrences* : DL1 critique. **traité** (2026-11-03 : la commande des capteurs imprime d'abord la cadence des mesures du lot (médiane des pas), qui vaut pour tout ce que le critique dit en mesures ; `capteurs.py`, `detectors-critic.md` déroulé 2). - **Score : un saut bref ne prend que trois familles de cause** (2026-11-03, *contradiction*) : `score.py` range un `saut_bref` dans la famille de l'étiquette qui le couvre, parmi `obstruction`, `visibilite` et `deplacement` seulement (vérifié : `score.py:44`, `:127`) ; la correspondance de `familles.md` et le critique disent « la famille de sa cause », sans limite (la frontière « Un saut puis le retour » ne cite, elle, que ces trois-là). Un saut bref sous une étiquette `deplacement_thermique` (le froid) ne compte dans aucune famille ; selon l'agent, cela a pesé sur son essai. *En cause* : `.claude/skills/events-learner/score.py:44`, `:127` contre `labeling/familles.md:30` (`:18`) et `.claude/agents/detectors-critic.md:33`. *Occurrences* : DL1 modification 1. -- **`labeling/familles.md` hors du relevé des fichiers déjà modifiés** (2026-11-03, *consigne absente*) : la mise en place ne relève que `detectors/`, le registre des seuils et `labeling/auto/` ; `score.py` et `regression.py` lisent aussi `labeling/familles.md` (vérifié : `score.py:43`), modifié et non commité pendant la séance. L'orchestrateur l'a noté de lui-même sous « Erreurs ». *En cause* : `.claude/skills/detector-learner/SKILL.md:17`. *Occurrences* : DL1 orchestrateur. +- **`labeling/familles.md` hors du relevé des fichiers déjà modifiés** (2026-11-03, *consigne absente*) : la mise en place ne relève que `detectors/`, le registre des seuils et `labeling/auto/` ; `score.py` et `regression.py` lisent aussi `labeling/familles.md` (vérifié : `score.py:43`), modifié et non commité pendant la séance. L'orchestrateur l'a noté de lui-même sous « Erreurs ». *En cause* : `.claude/skills/detector-learner/SKILL.md:17`. *Occurrences* : DL1 orchestrateur. **traité** (2026-11-03 : `labeling/familles.md` ajouté au relevé des fichiers déjà modifiés ; `detector-learner/SKILL.md` §1). ## Étiquetage des cas (benchmark) diff --git a/run.md b/run.md index 46e0293..523faeb 100644 --- a/run.md +++ b/run.md @@ -107,7 +107,7 @@ Les étiquettes de `labeling/auto/.jsonl` déjà faites et relues, dans u /detector-learner data/ [--du --au ] [--ameliorer] ``` -- Sans dates : la plage des étiquettes de la station. Ni analyste ni base d'events (D-116) : critique, modification et contrôle des détecteurs ; le contrôle juge sur les autres stations étiquetées (`python3 .claude/skills/detector-learner/regression.py --sauf `). +- Sans dates : la plage des étiquettes de la station. Ni analyste ni base d'events (D-116) : critique, modification et contrôle des détecteurs ; le contrôle juge sur le benchmark des étiquettes de `labeling/auto/` (`python3 .claude/skills/detector-learner/regression.py`, historique `detector-learner/historique.csv`), station par station hors celle du lot, et son `Total`. - `--ameliorer` (facultatif) : en fin de séance, l'améliorateur corrige le skill et ses agents d'après les difficultés relevées (D-071). - Commits directement sur `master` ; bilan dans `detector-learner/_/bilan.md` ; `git revert` de ce qu'on ne garde pas.