One detector per family, family keys equal to their names (D-119)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-03 14:57:52 +01:00
1 parent 0666d59e7d
commit 98be20a2bc
34 files changed
+551 -516

No files matched your search

+1 -1
View File
@@ -30,7 +30,7 @@ Rien d'autre : ni le dossier de station du lot, ni la critique, ni `score-avant.
- quelques instants aux bornes ne sont pas un recul ; une famille « sans famille » ne compte pas ;
- une hausse est un plus, jamais une exigence.
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).
4. **Les interdits** : un détecteur par famille (D-119) : `visibility.py`, `obstruction.py`, `target_issue.py`, `thermal_displacement.py`, `no_data.py`, `displacement.py`, ni plus ni moins, et `kind` est la famille ; 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).
Tu ne modifies aucun fichier hors de ton rendu.
+4 -4
View File
@@ -18,10 +18,10 @@ Une étiquette : `{"debut", "fin", "categorie", "description"}`, une seule anoma
## Ce que tu lis, seulement
- 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 ;
- `labeling/familles.md` **en entier** : les familles et leurs frontières ; la catégorie d'un événement est sa famille (un détecteur par famille (D-119) : `visibility.py`, `obstruction.py`, `target_issue.py`, `thermal_displacement.py`, `no_data.py`, `displacement.py`) ;
- 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`), pour nommer la règle en cause, et `detectors/categories.py` : les catégories du journal (`CATEGORIES`) et le détecteur de chacune (`LABELS`, `KINDS`).
- le code des détecteurs (`detectors/*.py`), pour nommer la règle en cause, et `detectors/categories.py` : comment les épisodes deviennent des événements (un saut revenu absorbé par sa cause, les sortes).
Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lecture, ni images, ni CSV), ni les autres étiquettes de `labeling/`, ni les séances passées, ni `CLAUDE.md`, `docs/decisions.md` ou les plans. Tu listes tout ce que tu as lu dans « Sources lues ».
@@ -29,9 +29,9 @@ Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lectur
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. 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.
3. **Comparaison**, événement par événement et étiquette par étiquette, la catégorie d'un événement est sa famille (un saut bref resté seul : Displacement, sans cause établie) : 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 sortes (la colonne après la famille : Poor visibility, Heat shimmer…) tombent dans une même famille : 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** (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.
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 (celui de la famille, et la sorte que la commande montre après elle ; pour un événement manquant, le détecteur de la famille de l'étiquette), 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
+3 -4
View File
@@ -32,13 +32,12 @@ Seulement les fichiers de `detectors/` et `vues-deplacements/contexte/seuils-du-
2. changer une constante ;
3. ajuster une règle existante ;
4. ajouter une règle nouvelle et courte ;
5. en dernier recours, un nouveau détecteur : un fichier de `detectors/` avec `detect(mesures)`, comme les autres.
5. en dernier recours, une sorte nouvelle (un `label`) dans le détecteur de la famille.
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, ni de catégorie renommée : les catégories du journal sont 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.
- Un détecteur par famille de `labeling/familles.md` (D-119) : `visibility.py`, `obstruction.py`, `target_issue.py`, `thermal_displacement.py`, `no_data.py`, `displacement.py`, ni plus ni moins ; le `kind` d'un épisode est sa famille, la catégorie de son événement. S'aligner sur les étiquettes, c'est mettre un épisode dans la famille de l'étiquette : une règle du détecteur de cette famille. Une suggestion qui demande une famille nouvelle va dans « Pas corrigé ».
- 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.
- Bibliothèque standard seulement.
@@ -49,7 +48,7 @@ La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de comp
**Sur le lot**, c'est toi seul qui vérifies : le contrôle des détecteurs ne le regarde pas. Lance la commande du lot avec `2>&1`, **avant** de modifier et **après**. Après, aucune ligne `sauté` : un détecteur qui ne se charge plus disparaît sans bruit du journal. Les événements que vise la critique doivent être trouvés, ou mieux bornés, sans casser les autres événements du lot.
Puis le **score**, un contrôle et non un but : `python3 .claude/skills/events-learner/score.py <dossier> --du <début> --au <fin>` (les bornes du lot), face au score avant. Il compare, instant par instant et par famille (`labeling/familles.md` : sa correspondance range chaque catégorie du journal dans une famille), ce que signalent les détecteurs aux étiquettes du lot (D-112) : « trouvées », la part des instants étiquetés que les détecteurs signalent ; « justes », la part des instants signalés qu'une étiquette range dans la famille. La famille en cause doit s'améliorer sur ce lot, sans qu'un événement entier soit perdu ou signalé à tort ailleurs. Un trou n'a pas de mesure, donc pas d'instant au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'étiquette). Ne vise pas 100 %.
Puis le **score**, un contrôle et non un but : `python3 .claude/skills/events-learner/score.py <dossier> --du <début> --au <fin>` (les bornes du lot), face au score avant. Il compare, instant par instant et par famille (`labeling/familles.md` : la catégorie d'un événement est sa famille), ce que signalent les détecteurs aux étiquettes du lot (D-112) : « trouvées », la part des instants étiquetés que les détecteurs signalent ; « justes », la part des instants signalés qu'une étiquette range dans la famille. La famille en cause doit s'améliorer sur ce lot, sans qu'un événement entier soit perdu ou signalé à tort ailleurs. Un trou n'a pas de mesure, donc pas d'instant au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'étiquette). Ne vise pas 100 %.
Puis le **benchmark**, 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`. C'est sur lui que le contrôle des détecteurs jugera ta modification. Son `Total`, toutes les étiquettes de `labeling/auto/`, est ce que tu fais monter ; 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. Ne règle rien pour une station précise. Si le recul vient d'étiquettes qui se contredisent d'une station à l'autre (le même état rangé dans deux familles), ne tranche pas : la non-régression prime ; garde ce qui ne fait reculer aucune station (au besoin, rien), et la contradiction va dans « Pas corrigé », les deux étiquettes (station, moment, famille), pour l'utilisateur.
## Ton rendu, `modification-K.md`
+1 -1
View File
@@ -45,7 +45,7 @@ Une ligne JSON par étiquette, **ajoutée** à la fin de `labeling/auto/<STATION
- `debut`, `fin` : la mesure **juste avant** le premier point touché sur `corr_x` ou `corr_y` (qui bouge ou qui manque), et la mesure **juste après** le dernier ; une anomalie d'une seule mesure va donc du point d'avant au point d'après, jamais `debut` = `fin`. Au quart d'heure près, UTC, format `AAAA-MM-JJTHH:MMZ`.
- **Une étiquette, un seul événement**, jamais un ensemble d'événements : deux événements, même proches ou mêlés, font deux étiquettes. Un même événement qui se répète (un passage, la pluie de chaque nuit, le déplacement thermique de chaque jour) : une étiquette par fois. Un mouvement dans un sens puis le retour font deux événements, deux étiquettes. Un seul événement qui dure plusieurs jours d'un seul tenant (une montée lente) : une étiquette pour toute sa durée.
- `categorie` : obligatoire, une seule par étiquette : la clé de sa famille dans `labeling/familles.md` (`visibilite`, `obstruction`, `deplacement_thermique`, `deplacement`, `cible_a_probleme`, `trou`), en suivant ses frontières ; aucune autre clé.
- `categorie` : obligatoire, une seule par étiquette : la clé de sa famille dans `labeling/familles.md` (`Visibility`, `Obstruction`, `Thermal displacement`, `Displacement`, `Target issue`, `No data` : la clé est le nom), en suivant ses frontières ; aucune autre clé.
- `description` : comme l'expert l'écrirait, en français, **qualitative, sans valeurs chiffrées** : ce qu'on voit (quelles cibles ou références, avec leurs noms exacts, quelles grandeurs, le retour ou non), la cause et **comment tu l'as sue** (vue sur l'image de telle heure, ou déduite des courbes), la conclusion pour le client (rien à faire, données à ne pas croire, mouvement à surveiller). Une cause non établie se dit telle ; ne dis pas plus que ce que tu as vu.
- Le lot entier est lu : un instant sans étiquette veut dire que `corr_x` et `corr_y` n'y montrent rien.