Events-learner: the analyst writes its own tools, a tool-builder brings them into agent-tools; /aiguiser retired (D-097)

- inventaire.py: what each source contains on the window (filled or empty columns, metric names, images), names and counts only
- analyser-lot: step 0 on the data, own scripts in <lot>/outils/, section 3 "Outils"
- tool-builder (the optimiser, rewritten): after the analyst, optimises or adds reading tools, never removes; no control yet
- /aiguiser skill, reader, corrector and voir.py removed; its sessions and spec stay as history
- docs: D-097, specs, CLAUDE.md, run.md, README, plan point 56; the shared files also carry another session's pending edits (D-096 entry, plan points 57 to 67)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 17:10:17 +01:00
1 parent 52de2becbf
commit 7fb176cf0a
24 files changed
+555 -513

No files matched your search

+14 -22
View File
@@ -1,14 +1,22 @@
# Pomper les données d'une station
# Pomper les données des stations
Dans le terminal du dev container de l'appli (VS Code sur `~/monitoring-dashboard`, « Reopen in Container ») :
Dans le terminal du dev container de l'appli (VS Code sur `~/monitoring-dashboard`, « Reopen in Container »), mettre à jour les stations suivies (`extraction/stations.txt`) jusqu'à maintenant :
```bash
(set -a && . ./.env && set +a && python3 /workspaces/Support-Agent/extraction/pomper.py --images --delai 300); chown -R 1000:1000 /workspaces/Support-Agent/data
```
- Chaque station repart de son dernier jour pompé (repompé, il était peut-être incomplet) ; une station absente de `data/` reçoit les 30 derniers jours. Ajouter une station : une ligne dans `extraction/stations.txt`.
Une plage choisie (historique, jour en échec) :
```bash
(set -a && . ./.env && set +a && python3 /workspaces/Support-Agent/extraction/pomper.py --du <DEBUT> --au <FIN> --images --delai 300 <SERIE>); chown -R 1000:1000 /workspaces/Support-Agent/data
```
- `<SERIE>` : numéro de série du système, celui de l'URL de la page System (`/explore/system/<SERIE>`), par exemple `NORDEND` ; plusieurs stations : `<SERIE1> <SERIE2>`.
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu ; commencer 3 jours avant la période voulue (historique du journal). Le jour en cours n'est jamais pompé.
- Sortie : `data/<SERIE>/` (`metrics/`, `displacement/`, `camera/`, `images/`), hors de git (D-065) ; tous les outils et `/aiguiser`, `/events-learner` y lisent.
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu ; commencer 3 jours avant la période voulue (historique du journal). Le jour en cours est pompé tel qu'il est ; la commande sans dates le remplace ensuite.
- Sortie : `data/<SERIE>/` (`metrics/`, `displacement/`, `camera/`, `images/`), hors de git (D-065) ; tous les outils et `/events-learner` y lisent.
- Options : `--diff` ajoute les images différentielles dans `images_diff/` (PNG 16 bits, ~7 Mo l'une contre ~1 Mo en JPG, ~160 Mo par jour ; ignorées par les outils de lecture) ; `--every 10` une image toutes les 10 min (`0` : toutes) ; sans `--images`, pas d'images.
- Relancer la même commande ne récupère que ce qui manque (jour en échec, plage élargie, option ajoutée).
@@ -45,22 +53,6 @@ Les anciennes caméras n'ont pas les six métriques de qualité (`peak`, `flux`,
Détails : `~/optical_emulator/CLAUDE.md` et `~/optical_emulator/emulateur/README.md`.
# Aiguiser la lecture de Claude
Dans une session Claude Code neuve, **en mode auto** (sinon elle s'arrête à chaque demande d'accord), à la racine de Support-Agent (pas dans le dev container), une fois les déplacements **et les images** pompés :
```
/aiguiser data/<SERIE> --du <DEBUT> --au <FIN> --ameliorer
```
- `--ameliorer` (facultatif) : en fin de séance, l'améliorateur corrige le processus d'après les difficultés relevées ; l'enlever pour une séance sans correction (D-076).
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ` ; `<FIN>` exclu (la plage s'arrête à `<FIN>` 00:00). La plage est le lot, sans découpe : sa longueur se choisit par les dates (4 jours : `--du 2026-09-01 --au 2026-09-05`), D-078.
- Sans `--du` ni `--au` : toute la période du dossier.
- Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063).
- La séance tourne seule, à lancer sur `master`, où elle commite directement (D-077), puis lance les commandes des fiches ; bilan dans `aiguiser/<séance>_<SERIE>/bilan.md`.
Détails : `.claude/skills/aiguiser/SKILL.md`.
# Voir les détecteurs du journal (page des détecteurs)
Les détecteurs seuls sur une station et une plage, sans boucle ni analyste (rien n'est modifié ni commité). Le développement de la page est dans `detectors-view/` ; `/events-learner` (page de fin de séance) et `/review-event` la reprennent.
@@ -79,7 +71,7 @@ Toutes les stations de `data/` d'un coup, chacune sur sa plage (une page ouverte
./detectors-view/run-detectors.sh
```
# Améliorer les détecteurs du journal (events-learner)
# Améliorer les détecteurs, la base d'events et les outils de lecture (events-learner)
Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Agent (pas dans le dev container), une fois les déplacements **et les images** pompés :
@@ -91,7 +83,7 @@ Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Ag
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu (la plage s'arrête à `<FIN>` 00:00). La plage est le lot, sans découpe : sa longueur se choisit par les dates (4 jours : `--du 2026-09-01 --au 2026-09-05`), D-072.
- Sans `--du` ni `--au` : toute la période du dossier, en un lot. Le lot est classé avec ses 3 jours d'avant : les pomper aussi.
- Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063).
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, detectors-critic, puis detectors-upgrader et detectors-control si la critique a des suggestions, event-builder à chaque lot, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/events-learner` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités.
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, tool-builder (les outils de lecture dont l'analyste s'est servi, optimisés ou ajoutés, D-097), detectors-critic, puis detectors-upgrader et detectors-control si la critique a des suggestions, event-builder à chaque lot, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/events-learner` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités.
- Bilan dans `events-learner/<séance>_<SERIE>/bilan.md` ; les étiquettes de l'analyste (`lot-*/etiquettes.json`) sont à garder même si on annule une modification. Ensuite : `git revert` des commits de la séance qu'on ne garde pas (la base de la séance est dans le bilan).
- À la fin, la page `out/events-learner_<séance>_<SERIE>.html` s'ouvre (D-066) : la page des détecteurs (`detectors-view/detecteurs.py`, ci-dessus) sur la plage, images et timelapse compris ; dessous les courbes, catégorie par catégorie, l'analyste (bleu) face aux détecteurs (orange) ; le score de la séance et le benchmark.
- Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`), lancé au début de chaque lot, après chaque modification et en fin de séance ; chaque passage s'ajoute à `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs.