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

+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`