Compare commits
6
Commits
55ada2c57b
...
be8897e38e
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
be8897e38e | ||
|
|
cbdf91068b | ||
|
|
0df340231a | ||
|
|
56b93e9b82 | ||
|
|
cb98818712 | ||
|
|
4bdbab2976 |
No files matched your search
Whitespace-only changes.
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: builder
|
||||
description: Builder de la boucle automatique (/boucle) — ajoute à la base de cas (agents/diagnostic/cas/) les événements nouveaux signalés pendant un lot, marqués « appris ». Appelé par l'orchestrateur avec le dossier de station, le lot, le dossier du lot et celui de la séance.
|
||||
description: Builder de la boucle automatique (/boucle) — ajoute à la base de cas (events/) les événements nouveaux signalés pendant un lot, marqués « appris ». Appelé par l'orchestrateur avec le dossier de station, le lot, le dossier du lot et celui de la séance.
|
||||
tools: Read, Bash, Write, Edit
|
||||
model: inherit
|
||||
---
|
||||
@@ -14,11 +14,11 @@ Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.m
|
||||
## Ce que tu fais
|
||||
|
||||
1. Lis la partie `## Nouveautés` de chaque rendu du lot, et ce que la critique en dit (parties 1 et 3, figures).
|
||||
2. Lis `agents/diagnostic/cas/INDEX.md`. **Un cas par genre d'événement, pas par occurrence** : une nouveauté dont un cas a déjà la signature (même rôle des capteurs, même forme, même moment de la journée, même durée à peu près) ne donne rien. La signature d'un cas, c'est sa ligne d'index **ou** sa fiche : ouvre la fiche des cas proches, un phénomène peut n'être que dans la fiche. Une nouveauté qui contredit le diagnostic d'un cas (un même état étiqueté autrement) est « déjà connue (C-00x) », avec la contradiction en une phrase, pour l'utilisateur.
|
||||
2. Lis `events/INDEX.md`. **Un cas par genre d'événement, pas par occurrence** : une nouveauté dont un cas a déjà la signature (même rôle des capteurs, même forme, même moment de la journée, même durée à peu près) ne donne rien. La signature d'un cas, c'est sa ligne d'index **ou** sa fiche : ouvre la fiche des cas proches, un phénomène peut n'être que dans la fiche. Une nouveauté qui contredit le diagnostic d'un cas (un même état étiqueté autrement) est « déjà connue (C-00x) », avec la contradiction en une phrase, pour l'utilisateur.
|
||||
3. Pour chaque nouveauté vraiment nouvelle, un cas :
|
||||
- **numéro** : le plus grand `C-xxx` de l'index, plus un ; dossier `agents/diagnostic/cas/C-xxx/` ;
|
||||
- **données et diagnostic** : `python3 .claude/skills/anonymiser-cas/anonymiser.py <dossier de station> agents/diagnostic/cas/C-xxx/ --du <début − 6 h> --au <fin + 6 h> --etiquettes <dossier du lot>/etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) : seulement la fenêtre de l'événement et sa marge ; un événement de plus d'un jour (un état qui couvre le lot) se copie sur un moment qui le montre (celui que cite la critique) ± 6 h, pas des centaines d'images, et la fiche donne les deux plages, la copiée et celle de l'événement ; les étiquettes de l'analyste dans cette fenêtre, codées, deviennent `etiquettes.json` du cas, son diagnostic à la création, que le benchmark compare aux détecteurs (D-069), et `etiquetage.md` à côté dit d'où elles viennent ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py agents/diagnostic/cas/C-xxx agents/diagnostic/cas/C-xxx/etiquettes.json`, « bon » ;
|
||||
- **fiche** `cas.md` : le modèle du §11.3 de `docs/agents/agent-diagnostic.md` (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) ; prends exemple sur une fiche existante, par exemple `agents/diagnostic/cas/C-001/cas.md` ;
|
||||
- **numéro** : le plus grand `C-xxx` de l'index, plus un ; dossier `events/C-xxx/` ;
|
||||
- **données et diagnostic** : `python3 .claude/skills/anonymiser-cas/anonymiser.py <dossier de station> events/C-xxx/ --du <début − 6 h> --au <fin + 6 h> --etiquettes <dossier du lot>/etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) : seulement la fenêtre de l'événement et sa marge ; un événement de plus d'un jour (un état qui couvre le lot) se copie sur un moment qui le montre (celui que cite la critique) ± 6 h, pas des centaines d'images, et la fiche donne les deux plages, la copiée et celle de l'événement ; les étiquettes de l'analyste dans cette fenêtre, codées, deviennent `etiquettes.json` du cas, son diagnostic à la création, que le benchmark compare aux détecteurs (D-069), et `etiquetage.md` à côté dit d'où elles viennent ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py events/C-xxx events/C-xxx/etiquettes.json`, « bon » ;
|
||||
- **fiche** `cas.md` : le modèle du §11.3 de `docs/agents/agent-diagnostic.md` (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) ; prends exemple sur une fiche existante, par exemple `events/C-001/cas.md` ;
|
||||
- **en tête de fiche**, juste sous le titre : `**Appris par la boucle** le <AAAA-MM-JJ>, séance <SEANCE>, non revalidé par l'expert`, `<SEANCE>` étant l'horodatage seul du dossier de la séance (`2026-10-26T1414Z`), sans la station : `anonymiser-cas` refuse tout nom réel ;
|
||||
- **figures et noms** : le skill `anonymiser-cas` (`.claude/skills/anonymiser-cas/SKILL.md`), étapes 2 à 4, avec la même fenêtre `--du` / `--au` à chaque relance ;
|
||||
- **ligne d'index**, au format des autres ; son Verdict commence par `(appris)`.
|
||||
@@ -26,7 +26,7 @@ Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.m
|
||||
|
||||
## Règles
|
||||
|
||||
- Ne modifie jamais un cas existant, ni `agents/diagnostic/instructions.md`, ni rien hors de tes nouveaux dossiers de cas, de l'index et de ton rendu (le registre `registre.csv` grandit tout seul par `anonymiser.py`).
|
||||
- Ne modifie jamais un cas existant, ni `agent-diagnostic/instructions.md`, ni rien hors de tes nouveaux dossiers de cas, de l'index et de ton rendu (le registre `registre.csv` grandit tout seul par `anonymiser.py`).
|
||||
- Ne passe pas par `/nouveau-cas` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les cas appris s'ajoutent sans attendre : l'utilisateur les revoit ensuite avec `/revue-cas`, qui cherche la phrase exacte `non revalidé par l'expert` de l'en-tête (D-075).
|
||||
- Aucun nom réel de station ou de capteur ne reste dans un cas (l'étape 3 d'`anonymiser-cas` le vérifie) ; aucun identifiant (`SIM_CCID`, `ip`).
|
||||
- Ne commite pas : l'orchestrateur le fait.
|
||||
|
||||
@@ -15,11 +15,11 @@ Tu es le correcteur de `/aiguiser`. Un lecteur lit les données avec un skill de
|
||||
|
||||
## Ce que tu lis
|
||||
|
||||
- `docs/domaine/colonnes-des-deplacements.md` (en premier), `docs/domaine/pieges-des-donnees.md`, `docs/displacement/domaine/carte-des-evenements.md` (ce qui peut arriver, en familles) ;
|
||||
- `docs/domaine/colonnes-des-deplacements.md` (en premier), `docs/domaine/pieges-des-donnees.md`, `events/carte-des-evenements.md` (ce qui peut arriver, en familles) ;
|
||||
- le dossier de station : les exports « advanced » de `displacement/`, par tes scripts, et les images de `images/` avec Read ;
|
||||
- les rendus que ta demande cite, et seulement après avoir écrit ton corrigé pour une lecture lente.
|
||||
|
||||
**Tu n'utilises pas** `agents/diagnostic/outils/`, pas même `donnees.py` : ni lancé, ni importé, ni lu ; une erreur de lecture commune passerait inaperçue. Tu ne lis pas `.claude/skills/lire-les-donnees/SKILL.md`, ni les détecteurs (`vues-deplacements/detectors/`), ni la base de cas, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station et des rendus que ta demande cite. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
**Tu n'utilises pas** `agent-tools/`, pas même `donnees.py` : ni lancé, ni importé, ni lu ; une erreur de lecture commune passerait inaperçue. Tu ne lis pas `.claude/skills/lire-les-donnees/SKILL.md`, ni les détecteurs (`vues-deplacements/detectors/`), ni la base de cas, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station et des rendus que ta demande cite. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
|
||||
## La lecture lente
|
||||
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
name: diagnostic
|
||||
description: Diagnostic des données d'une station AIMsight (déplacements optiques, images). À appeler avec un dossier de data/ et, si on veut, une question. Rend un rapport traçable dans agents/diagnostic/rapports/.
|
||||
description: Diagnostic des données d'une station AIMsight (déplacements optiques, images). À appeler avec un dossier de data/ et, si on veut, une question. Rend un rapport traçable dans agent-diagnostic/rapports/.
|
||||
tools: Read, Bash, Write
|
||||
model: inherit
|
||||
omitClaudeMd: true
|
||||
---
|
||||
|
||||
Tu es l'agent de diagnostic du projet. Commence par lire `agents/diagnostic/instructions.md` et suis-le à la lettre. Ta demande : le dossier de `data/` et l'éventuelle question qui suivent.
|
||||
Tu es l'agent de diagnostic du projet. Commence par lire `agent-diagnostic/instructions.md` et suis-le à la lettre. Ta demande : le dossier de `data/` et l'éventuelle question qui suivent.
|
||||
@@ -18,7 +18,7 @@ Le dossier de station, le lot (début et fin, UTC) ou « toute la période », l
|
||||
- les deux notes de `docs/domaine/` qu'il cite ;
|
||||
- le dossier de station, par les outils du skill, et ses images avec Read.
|
||||
|
||||
**Rien d'autre** : ni les détecteurs (`vues-deplacements/detectors/`) ni leur sortie, ni la base de cas (`agents/diagnostic/cas/`), ni la carte des événements, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station. Dans le dossier de ta lecture, n'ouvre aucun autre fichier : corrigé, écarts et modifications y sont, et ils fausseraient la mesure. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. Tu n'écris aucun script.
|
||||
**Rien d'autre** : ni les détecteurs (`vues-deplacements/detectors/`) ni leur sortie, ni la base de cas (`events/`), ni la carte des événements, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station. Dans le dossier de ta lecture, n'ouvre aucun autre fichier : corrigé, écarts et modifications y sont, et ils fausseraient la mesure. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. Tu n'écris aucun script.
|
||||
|
||||
## Ta lecture
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: optimiseur
|
||||
description: Optimiseur de /aiguiser — modifie les outils de lecture (agents/diagnostic/outils/) et le skill lire-les-donnees d'après l'écart du correcteur, le plus simple d'abord. Appelé par l'orchestrateur avec un dossier, un lot, un écart, le numéro du passage et le chemin de son rendu.
|
||||
description: Optimiseur de /aiguiser — modifie les outils de lecture (agent-tools/) et le skill lire-les-donnees d'après l'écart du correcteur, le plus simple d'abord. Appelé par l'orchestrateur avec un dossier, un lot, un écart, le numéro du passage et le chemin de son rendu.
|
||||
tools: Read, Edit, Write, Bash
|
||||
model: inherit
|
||||
omitClaudeMd: true
|
||||
@@ -16,11 +16,11 @@ Une modification annulée qu'on te passe n'a rien apporté : essaie autre chose.
|
||||
|
||||
## Ce que tu lis
|
||||
|
||||
L'écart (ses défauts d'abord) ; `<lot>/corrige.md` et les scripts du correcteur dans `<lot>/corrige/` ; la partie « Ce qui m'a manqué » des lectures du lot ; `.claude/skills/lire-les-donnees/SKILL.md` et les outils de `agents/diagnostic/outils/` ; le dossier de station, pour essayer. Rien d'autre : ni `CLAUDE.md`, ni les plans, ni les détecteurs.
|
||||
L'écart (ses défauts d'abord) ; `<lot>/corrige.md` et les scripts du correcteur dans `<lot>/corrige/` ; la partie « Ce qui m'a manqué » des lectures du lot ; `.claude/skills/lire-les-donnees/SKILL.md` et les outils de `agent-tools/` ; le dossier de station, pour essayer. Rien d'autre : ni `CLAUDE.md`, ni les plans, ni les détecteurs.
|
||||
|
||||
## Ce que tu touches, seulement
|
||||
|
||||
- les scripts de `agents/diagnostic/outils/`, y compris un nouveau script ;
|
||||
- les scripts de `agent-tools/`, y compris un nouveau script ;
|
||||
- `.claude/skills/lire-les-donnees/SKILL.md`.
|
||||
|
||||
## Comment
|
||||
@@ -40,7 +40,7 @@ L'écart (ses défauts d'abord) ; `<lot>/corrige.md` et les scripts du correcteu
|
||||
2. Relance les commandes des fiches qui emploient cet outil ; aucune ligne `ÉCHEC` (remplace `<outil>` par son nom de fichier, ex. `resume.py`) :
|
||||
|
||||
```bash
|
||||
grep -oh '`[^`]*agents/diagnostic/outils/<outil>[^`]*`' agents/diagnostic/cas/*/cas.md | tr -d '`' | while read -r c; do eval "$c" >/dev/null 2>&1 || echo "ÉCHEC $c"; done
|
||||
grep -oh '`[^`]*agent-tools/<outil>[^`]*`' events/*/cas.md | tr -d '`' | while read -r c; do eval "$c" >/dev/null 2>&1 || echo "ÉCHEC $c"; done
|
||||
```
|
||||
|
||||
## Ton rendu
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: revue
|
||||
description: Revue d'un cas appris par /boucle (agents/diagnostic/cas/C-xxx/), non encore validé par l'expert — le présente à l'utilisateur, puis applique ses corrections ou sa validation. Appelé par l'orchestrateur de /revue-cas, un cas à la fois.
|
||||
description: Revue d'un cas appris par /boucle (events/C-xxx/), non encore validé par l'expert — le présente à l'utilisateur, puis applique ses corrections ou sa validation. Appelé par l'orchestrateur de /revue-cas, un cas à la fois.
|
||||
tools: Read, Bash, Write, Edit
|
||||
model: inherit
|
||||
---
|
||||
@@ -13,17 +13,17 @@ Un cas `C-xxx`, et l'une de ces trois consignes :
|
||||
|
||||
### « présenter »
|
||||
|
||||
1. Lis `agents/diagnostic/cas/C-xxx/cas.md`, sa ligne de `agents/diagnostic/cas/INDEX.md` et `etiquetage.md` à côté.
|
||||
1. Lis `events/C-xxx/cas.md`, sa ligne de `events/INDEX.md` et `etiquetage.md` à côté.
|
||||
2. La station réelle : la ligne `<STATION>,<STATION>,C-xxx` de `.claude/skills/anonymiser-cas/registre.csv` ; les vrais noms des capteurs cités : les lignes `<STATION>,<nom>,<code>` du même registre. Ils sont pour l'utilisateur seulement : jamais dans un fichier du cas.
|
||||
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `vues-deplacements/boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite le cas. Lis ce `builder.md` et, dans la `critique.md` du lot, ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
|
||||
4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/boucle/detecteurs.py data/<STATION> --du <AAAA-MM-JJ> --au <AAAA-MM-JJ> --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data/<STATION>/`, hors de git, sur `agents/diagnostic/cas/C-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ?
|
||||
4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/boucle/detecteurs.py data/<STATION> --du <AAAA-MM-JJ> --au <AAAA-MM-JJ> --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data/<STATION>/`, hors de git, sur `events/C-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ?
|
||||
5. Regarde chaque PNG de la fiche : montre-t-il ce que dit sa légende ?
|
||||
6. Écris la présentation (format ci-dessous) dans `out/revue-cas/C-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/revue-cas/page.py C-xxx --du <AAAA-MM-JJ> --au <AAAA-MM-JJ>` (mêmes dates qu'en 4).
|
||||
7. Rends seulement : le chemin de la page, les dates passées, et la liste « À trancher par l'expert », numérotée.
|
||||
|
||||
### « corriger : <ce que dit l'utilisateur> »
|
||||
|
||||
- Applique ses corrections à la fiche, à la ligne d'index et, si le diagnostic change (catégorie, plage d'un moment), à `etiquettes.json` ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py agents/diagnostic/cas/C-xxx agents/diagnostic/cas/C-xxx/etiquettes.json`, « bon ». Une figure à refaire : skill `anonymiser-cas`, étape 2. Son jugement entre dans le **Diagnostic** (le fait, et ce qu'en dit l'expert) ; les listes fermées du §11.3 de `docs/agents/agent-diagnostic.md` restent fermées.
|
||||
- Applique ses corrections à la fiche, à la ligne d'index et, si le diagnostic change (catégorie, plage d'un moment), à `etiquettes.json` ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py events/C-xxx events/C-xxx/etiquettes.json`, « bon ». Une figure à refaire : skill `anonymiser-cas`, étape 2. Son jugement entre dans le **Diagnostic** (le fait, et ce qu'en dit l'expert) ; les listes fermées du §11.3 de `docs/agents/agent-diagnostic.md` restent fermées.
|
||||
- Une phrase de lui qui n'est pas nette : ne devine pas, rends la question.
|
||||
- Relance l'étape 3 du skill `anonymiser-cas` (la commande d'`anonymiser.py` avec la fenêtre `--du` / `--au` d'`etiquetage.md`) : aucun nom réel ne reste.
|
||||
- Mets à jour `out/revue-cas/C-xxx.md` (ce qui est tranché quitte « À trancher », une section « Corrections de l'expert » dit ce qui a changé) et refais la page de revue (même commande, mêmes dates).
|
||||
@@ -63,7 +63,7 @@ Courte, pour un humain qui connaît le terrain, sans codes seuls : chaque capteu
|
||||
|
||||
## Règles
|
||||
|
||||
- Ne touche qu'au dossier du cas, à sa ligne d'index et à `out/revue-cas/` ; jamais aux autres cas, aux détecteurs, à `agents/diagnostic/instructions.md`. Ne modifie pas le registre à la main.
|
||||
- Ne touche qu'au dossier du cas, à sa ligne d'index et à `out/revue-cas/` ; jamais aux autres cas, aux détecteurs, à `agent-diagnostic/instructions.md`. Ne modifie pas le registre à la main.
|
||||
- Aucun nom réel de station ou de capteur dans un fichier du cas ; le nom réel n'apparaît que dans ta présentation.
|
||||
- Ne valide jamais de toi-même : seulement sur la consigne « valider ».
|
||||
- Ne commite pas : l'orchestrateur le fait.
|
||||
@@ -45,7 +45,7 @@ Lance la commande du lot avec `2>&1`, **avant** de modifier et **après**. Aprè
|
||||
|
||||
Puis le **score** : `python3 .claude/skills/boucle/score.py <dossier>`, face au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. La catégorie en cause doit monter sur ce lot, sans baisse nette ailleurs (un événement entier perdu ou signalé à tort, pas quelques mesures de bornes). Un trou n'a pas de mesure, donc pas de case au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'analyste), et le score et le benchmark ne doivent pas baisser net. Ne vise pas 100 % : l'analyste peut se tromper aussi, et une règle de plus pour quelques mesures ne vaut pas sa complexité.
|
||||
|
||||
Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. Il compare de la même façon les détecteurs au diagnostic gardé dans chaque cas de la base (`agents/diagnostic/cas/C-*/etiquettes.json`, D-069) : ce sont les cas de régression, et au premier lot d'une station le score n'a pas de lot d'avant. Un recul net sur un cas (un événement entier perdu ou signalé à tort) est un recul ; une hausse est un plus, **pas un but** : ne règle rien pour un cas précis. C-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. Si la critique étiquette un état que le diagnostic figé d'un cas étiquette autrement (son `etiquettes.json`, son `etiquetage.md`), ne tranche pas : le benchmark prime (pas de recul net), et la contradiction va dans « Pas corrigé », pour l'utilisateur.
|
||||
Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. Il compare de la même façon les détecteurs au diagnostic gardé dans chaque cas de la base (`events/C-*/etiquettes.json`, D-069) : ce sont les cas de régression, et au premier lot d'une station le score n'a pas de lot d'avant. Un recul net sur un cas (un événement entier perdu ou signalé à tort) est un recul ; une hausse est un plus, **pas un but** : ne règle rien pour un cas précis. C-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. Si la critique étiquette un état que le diagnostic figé d'un cas étiquette autrement (son `etiquettes.json`, son `etiquetage.md`), ne tranche pas : le benchmark prime (pas de recul net), et la contradiction va dans « Pas corrigé », pour l'utilisateur.
|
||||
|
||||
## Ton rendu, `modification-K.md`
|
||||
|
||||
|
||||
Whitespace-only changes.
Whitespace-only changes.
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: aiguiser
|
||||
description: Séance automatique d'amélioration des outils de lecture (agents/diagnostic/outils/) et du skill lire-les-donnees, sur un lot d'une station, la plage choisie par l'utilisateur (D-059, D-078) — lecteur, correcteur, optimiseur, puis commandes des fiches. Lancé par l'utilisateur seulement, avec /aiguiser.
|
||||
description: Séance automatique d'amélioration des outils de lecture (agent-tools/) et du skill lire-les-donnees, sur un lot d'une station, la plage choisie par l'utilisateur (D-059, D-078) — lecteur, correcteur, optimiseur, puis commandes des fiches. Lancé par l'utilisateur seulement, avec /aiguiser.
|
||||
disable-model-invocation: true
|
||||
argument-hint: "data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]"
|
||||
---
|
||||
@@ -12,7 +12,7 @@ Tu es l'orchestrateur. Tu appelles les trois agents dans l'ordre, tu transmets l
|
||||
## 1. Mise en place
|
||||
|
||||
- Arguments : le dossier de station ; `--du`, `--au` (jours UTC, facultatifs : sans eux, toute la période ; **`--au` est exclu** : la plage s'arrête à `--au` 00:00Z, `--du 2026-09-01 --au 2026-09-05` fait 4 jours) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §7, D-076). Une option entre crochets (`[--ameliorer]`, la syntaxe d'usage recopiée) vaut l'option sans crochets ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net. **La plage est le lot** (D-078, comme `/boucle`, D-072) : une séance traite un seul lot, de la longueur que l'utilisateur a choisie par `--du` / `--au`, sans découpe ; un `--lot` ou `--tranche` donné quand même est ignoré (note-le sous « Erreurs »).
|
||||
- `python3 agents/diagnostic/outils/inventaire.py <dossier>` : sans export « advanced », dis-le et arrête-toi.
|
||||
- `python3 agent-tools/inventaire.py <dossier>` : sans export « advanced », dis-le et arrête-toi.
|
||||
- `STATION` = le nom du dossier de station (`NORDEND`) ; `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`.
|
||||
- La séance se commite directement sur `master` (D-077, comme `/boucle`, D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi (pas de `git switch` : une autre session peut travailler dans ce dépôt). Note la **base de la séance** : `git rev-parse HEAD`. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins.
|
||||
- Dossier de séance : `vues-deplacements/aiguiser/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
|
||||
@@ -23,7 +23,7 @@ Un seul lot, numéroté `01` (`NN` ci-dessous) : de `--du` 00:00Z (sinon le prem
|
||||
|
||||
## 3. Le lot, 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\*\* :' <rendu>`, la comparaison par `grep '^\*\*Par rapport' <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>`. Outils : `agents/diagnostic/outils/ .claude/skills/lire-les-donnees/`, ci-dessous `<outils>`.
|
||||
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>`, la comparaison par `grep '^\*\*Par rapport' <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>`. Outils : `agent-tools/ .claude/skills/lire-les-donnees/`, ci-dessous `<outils>`.
|
||||
|
||||
1. **Lecteur** (`lecteur`) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Écris <lot>/lecture-1.md, figures dans <lot>/lecture-1/.`
|
||||
Commit `<lot>/`, message `Sharpen <STATION> lot NN: lecture 1`.
|
||||
@@ -48,7 +48,7 @@ Pas de rejeu des lots des séances d'avant : la séance suivante tourne avec le
|
||||
Les commandes que citent les fiches de la base de cas, toutes ; note les lignes `ÉCHEC` pour le bilan (pas d'agent, pas de commit) :
|
||||
|
||||
```bash
|
||||
grep -oh '`[^`]*agents/diagnostic/outils/[^`]*`' agents/diagnostic/cas/*/cas.md | tr -d '`' | while read -r c; do eval "$c" >/dev/null 2>&1 || echo "ÉCHEC $c"; done
|
||||
grep -oh '`[^`]*agent-tools/[^`]*`' events/*/cas.md | tr -d '`' | while read -r c; do eval "$c" >/dev/null 2>&1 || echo "ÉCHEC $c"; done
|
||||
```
|
||||
|
||||
Rien n'est annulé d'office : le bilan le dit, l'utilisateur décide.
|
||||
|
||||
@@ -1,17 +1,17 @@
|
||||
---
|
||||
name: anonymiser-cas
|
||||
description: À utiliser pour copier les données d'un cas dans son dossier et coder ses noms (agents/diagnostic/cas/C-xxx/) — à l'étape 5 de /nouveau-cas, avant de montrer la fiche, ou quand une fiche ou une figure de la base porte un nom réel de station, de référence ou de cible.
|
||||
argument-hint: "data/<STATION>/ agents/diagnostic/cas/C-xxx/"
|
||||
description: À utiliser pour copier les données d'un cas dans son dossier et coder ses noms (events/C-xxx/) — à l'étape 5 de /nouveau-cas, avant de montrer la fiche, ou quand une fiche ou une figure de la base porte un nom réel de station, de référence ou de cible.
|
||||
argument-hint: "data/<STATION>/ events/C-xxx/"
|
||||
---
|
||||
|
||||
# Copier les données d'un cas et coder ses noms
|
||||
|
||||
L'agent lit la base de cas. Un nom de site ou de capteur l'ancrerait sur le nom plutôt que sur la signature (D-049). La station prend donc le numéro du cas (`C-001`), une référence devient `R1`, une cible `C1`, numérotées par station. Le cas porte ses données, déjà codées (D-050). Le registre `registre.csv`, à côté de ce fichier, garde les codes des capteurs d'un cas à l'autre et la station de chaque cas.
|
||||
|
||||
1. **Données** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/C-xxx/` copie `displacement/`, `camera/` (poses de la caméra, dossier pompé) et `images/` dans le dossier du cas, noms codés dans les CSV et les noms de fichiers, et imprime `NOM → CODE`. Un capteur inconnu reçoit le code suivant et entre dans le registre. Avec `--du T --au T` (`2026-10-07T12:00Z`), seules les mesures et les images de [du, au) sont copiées (un CSV sans mesure dans la fenêtre ne l'est pas) ; avec `--etiquettes <lot>/etiquettes.json` en plus, les moments de l'analyste dans la fenêtre, bornés et codés, deviennent `etiquettes.json` du cas, et `etiquetage.md` dit d'où elles viennent (D-069, le builder de `/boucle`) : pour un cas pris dans un long export (le builder de `/boucle`), la fenêtre de l'événement et sa marge, pas des centaines d'images ; repasse la même fenêtre aux étapes suivantes.
|
||||
2. **Figures** : fais chaque figure du cas avec sa commande (`graphique.py`, `vignettes.py`) sur `agents/diagnostic/cas/C-xxx/`, avec `--sortie agents/diagnostic/cas/C-xxx/` : titres, légendes et noms de fichiers sont codés d'emblée. Dans la fiche, cite le fichier qu'elle imprime.
|
||||
1. **Données** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ events/C-xxx/` copie `displacement/`, `camera/` (poses de la caméra, dossier pompé) et `images/` dans le dossier du cas, noms codés dans les CSV et les noms de fichiers, et imprime `NOM → CODE`. Un capteur inconnu reçoit le code suivant et entre dans le registre. Avec `--du T --au T` (`2026-10-07T12:00Z`), seules les mesures et les images de [du, au) sont copiées (un CSV sans mesure dans la fenêtre ne l'est pas) ; avec `--etiquettes <lot>/etiquettes.json` en plus, les moments de l'analyste dans la fenêtre, bornés et codés, deviennent `etiquettes.json` du cas, et `etiquetage.md` dit d'où elles viennent (D-069, le builder de `/boucle`) : pour un cas pris dans un long export (le builder de `/boucle`), la fenêtre de l'événement et sa marge, pas des centaines d'images ; repasse la même fenêtre aux étapes suivantes.
|
||||
2. **Figures** : fais chaque figure du cas avec sa commande (`graphique.py`, `vignettes.py`) sur `events/C-xxx/`, avec `--sortie events/C-xxx/` : titres, légendes et noms de fichiers sont codés d'emblée. Dans la fiche, cite le fichier qu'elle imprime.
|
||||
3. **Textes** : une fois la fiche et la ligne d'index écrites, relance la commande de l'étape 1 :
|
||||
- dans les `.md` du cas et `cas/INDEX.md`, `data/<STATION>/` devient `agents/diagnostic/cas/C-xxx/` et chaque nom son code ;
|
||||
- dans les `.md` du cas et `events/INDEX.md`, `data/<STATION>/` devient `events/C-xxx/` et chaque nom son code ;
|
||||
- elle s'arrête en listant tout nom réel qui reste (souvent une casse différente) : corrige à la main, puis relance.
|
||||
4. **Regarde chaque PNG** : des codes dans le titre, la légende et les vignettes, aucun nom réel.
|
||||
|
||||
@@ -19,7 +19,7 @@ L'agent lit la base de cas. Un nom de site ou de capteur l'ancrerait sur le nom
|
||||
|
||||
- Le registre ne fait que grandir : ne renumérote rien et ne supprime aucune ligne. Commite-le avec le cas.
|
||||
- Le registre ne va jamais à l'agent : ni dans ses sources, ni dans un prompt, ni dans une fiche.
|
||||
- Les commandes de la fiche portent le dossier et les codes du cas (`agents/diagnostic/cas/C-001/`, `--capteurs R3,R2`) : elles se rejouent telles quelles.
|
||||
- Un chemin vers `rapports/`, qui garde les vrais noms, s'écrit par son préfixe horodaté : `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_*/`.
|
||||
- Les commandes de la fiche portent le dossier et les codes du cas (`events/C-001/`, `--capteurs R3,R2`) : elles se rejouent telles quelles.
|
||||
- Un chemin vers `rapports/`, qui garde les vrais noms, s'écrit par son préfixe horodaté : `agent-diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_*/`.
|
||||
- Les images montrent le site lui-même : ce qu'elles laissent voir ne s'anonymise pas.
|
||||
- Vérifier le script après l'avoir modifié : `python3 .claude/skills/anonymiser-cas/anonymiser.py --test`.
|
||||
@@ -2,7 +2,7 @@
|
||||
des codes stables (D-049, D-050).
|
||||
|
||||
Usage :
|
||||
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/C-xxx/ [--du T] [--au T]
|
||||
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ events/C-xxx/ [--du T] [--au T]
|
||||
[--etiquettes <lot>/etiquettes.json]
|
||||
copie displacement/, camera/ (pompage) et images/ de la station dans le cas, noms codés dans les CSV et les noms de fichiers ;
|
||||
avec --du / --au (2026-10-07T12:00Z), seulement les lignes et les images de [du, au) : un cas n'a pas besoin
|
||||
@@ -10,7 +10,7 @@ Usage :
|
||||
avec --etiquettes, les moments de l'analyste qui touchent [du, au), bornés à la fenêtre et codés, deviennent
|
||||
etiquettes.json du cas : son diagnostic à la création, que le benchmark compare aux détecteurs (point 48) ;
|
||||
etiquetage.md, à côté, dit d'où ils viennent et les montre en tableau ;
|
||||
dans les .md, .csv et .json du cas et cas/INDEX.md, data/<STATION>/ devient le dossier du cas et chaque nom son code ;
|
||||
dans les .md, .csv et .json du cas et events/INDEX.md, data/<STATION>/ devient le dossier du cas et chaque nom son code ;
|
||||
échoue s'il reste un nom réel
|
||||
python3 .claude/skills/anonymiser-cas/anonymiser.py --test
|
||||
Codes : la station devient C-xxx ; R1, R2... pour les références et C1, C2... pour les cibles, par station.
|
||||
@@ -27,10 +27,10 @@ import sys
|
||||
ICI = os.path.dirname(os.path.abspath(__file__))
|
||||
RACINE = os.path.normpath(os.path.join(ICI, "..", "..", ".."))
|
||||
REGISTRE = os.path.join(ICI, "registre.csv")
|
||||
INDEX = os.path.join(RACINE, "agents", "diagnostic", "cas", "INDEX.md")
|
||||
INDEX = os.path.join(RACINE, "events", "INDEX.md")
|
||||
DONNEES = ("displacement", "camera", "images") # ce que lisent les outils, et les poses de la caméra (pompage) ;
|
||||
# le reste de data/<STATION>/ ne suit pas
|
||||
sys.path.insert(0, os.path.join(RACINE, "agents", "diagnostic", "outils"))
|
||||
sys.path.insert(0, os.path.join(RACINE, "agent-tools"))
|
||||
from donnees import charger, est_reference, heure_image, instant, iso, trouver # noqa: E402
|
||||
|
||||
|
||||
@@ -172,7 +172,7 @@ def anonymiser(dossier, cas, du=None, au=None, etiquettes=None):
|
||||
chemin = re.compile(rf"data/{re.escape(station)}/?")
|
||||
for p in textes():
|
||||
avant = lire(p)
|
||||
apres = remplacer(chemin.sub(f"agents/diagnostic/cas/{cas_id}/", avant), table, station)
|
||||
apres = remplacer(chemin.sub(f"events/{cas_id}/", avant), table, station)
|
||||
if apres != avant:
|
||||
ecrire(p, apres)
|
||||
|
||||
|
||||
@@ -12,9 +12,9 @@ Tu es l'orchestrateur. Tu appelles les quatre agents dans l'ordre, tu transmets
|
||||
## 1. Mise en place
|
||||
|
||||
- Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne `data/<NOM EN MAJUSCULES>/` (D-065) ; `--du`, `--au` (jours UTC, facultatifs : sans eux, toute la période ; **`--au` est exclu** : la plage s'arrête à `--au` 00:00Z, `--du 2026-09-01 --au 2026-09-05` fait 4 jours) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). **La plage est le lot** (D-072) : une séance traite un seul lot, de la longueur que l'utilisateur a choisie par `--du` / `--au`, sans découpe ; un `--lot` ou `--tranche` donné quand même est ignoré (note-le sous « Erreurs »). Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme `--du` puis `--au` ; une option entre crochets (`[--ameliorer]`, la syntaxe d'usage recopiée) vaut l'option sans crochets ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net.
|
||||
- `python3 agents/diagnostic/outils/inventaire.py <dossier>` : dossier absent ou sans export « advanced », dis-le et arrête-toi.
|
||||
- `python3 agent-tools/inventaire.py <dossier>` : dossier absent ou sans export « advanced », dis-le et arrête-toi.
|
||||
- `STATION` = le nom du dossier de station (`NORDEND`) ; `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`.
|
||||
- La séance se commite directement sur `master` (D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi (pas de `git switch` : une autre session peut travailler dans ce dépôt). Note la **base de la séance** : `git rev-parse HEAD`. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin. Une autre session peut travailler dans le même dépôt pendant la séance (fichiers modifiés, index déjà chargé, même ce skill) : `git commit -- <chemins>` ne prend que tes chemins ; n'indexe rien d'autre, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins ; garde les consignes lues au début et note le changement dans tes difficultés. Le commit par chemin ne protège pas un fichier que tu commites toi-même : note donc, au début, les fichiers déjà modifiés sur les chemins que la séance commite ou fait tourner, `git status --porcelain -- vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md agents/diagnostic/ .claude/skills/anonymiser-cas/registre.csv` ; s'il y en a, liste-les au bilan sous « Erreurs » (les mesures tournent sur eux), ne les commite pas et ne les annule pas : aux étapes 3 et 4 (`annuler`), donne tes chemins fichier par fichier, sans eux (`git diff --name-only <base du lot> HEAD -- <chemins>` liste ceux de la séance).
|
||||
- La séance se commite directement sur `master` (D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi (pas de `git switch` : une autre session peut travailler dans ce dépôt). Note la **base de la séance** : `git rev-parse HEAD`. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin. Une autre session peut travailler dans le même dépôt pendant la séance (fichiers modifiés, index déjà chargé, même ce skill) : `git commit -- <chemins>` ne prend que tes chemins ; n'indexe rien d'autre, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins ; garde les consignes lues au début et note le changement dans tes difficultés. Le commit par chemin ne protège pas un fichier que tu commites toi-même : note donc, au début, les fichiers déjà modifiés sur les chemins que la séance commite ou fait tourner, `git status --porcelain -- vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md agent-diagnostic/ .claude/skills/anonymiser-cas/registre.csv` ; s'il y en a, liste-les au bilan sous « Erreurs » (les mesures tournent sur eux), ne les commite pas et ne les annule pas : aux étapes 3 et 4 (`annuler`), donne tes chemins fichier par fichier, sans eux (`git diff --name-only <base du lot> HEAD -- <chemins>` liste ceux de la séance).
|
||||
- Dossier de séance : `vues-deplacements/boucle/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
|
||||
|
||||
## 2. Le lot
|
||||
@@ -43,7 +43,7 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand
|
||||
- `à reprendre` : retour à l'étape 3, passage K + 1.
|
||||
- `annuler` : `git checkout <base du lot> -- vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md`, commit de ces deux chemins, message `Loop <STATION> lot NN: modification annulée`.
|
||||
5. **Builder** (`builder`), seulement si l'un des rendus du lot a, sous `## Nouveautés`, autre chose que `aucune` : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Dossier du lot : <lot>/. Séance : <séance>/. Écris <lot>/builder.md.`
|
||||
Si sa ligne `**Cas créés** :` n'est pas `aucun` : commit `agents/diagnostic/cas/ .claude/skills/anonymiser-cas/registre.csv <lot>/`, message `Loop <STATION> lot NN: cas C-xxx, …` ; sinon commit `<lot>/`, message `Loop <STATION> lot NN: builder (aucun cas)`.
|
||||
Si sa ligne `**Cas créés** :` n'est pas `aucun` : commit `events/ .claude/skills/anonymiser-cas/registre.csv <lot>/`, message `Loop <STATION> lot NN: cas C-xxx, …` ; sinon commit `<lot>/`, message `Loop <STATION> lot NN: builder (aucun cas)`.
|
||||
|
||||
L'analyste ne relit pas les lots des séances d'avant ; le score les rejoue, sur leurs étiquettes, et le benchmark rejoue les cas de la base, les cas créés au lot compris (leur `etiquettes.json`).
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
"""Benchmark des détecteurs sur la base de cas (point 48 du plan du journal du matin, D-069).
|
||||
|
||||
Chaque cas d'agents/diagnostic/cas/ qui a son etiquettes.json (le diagnostic de l'analyste, figé à la création du cas) :
|
||||
Chaque cas d'events/ qui a son etiquettes.json (le diagnostic de l'analyste, figé à la création du cas) :
|
||||
les détecteurs tels qu'ils sont, face à ces étiquettes, mesure par mesure et capteur par capteur (score.py, D-062).
|
||||
Un calcul seulement, sans agent. Par cas, puis au total, et par catégorie : « trouvées » (part des mesures étiquetées
|
||||
que les détecteurs signalent) et « justes » (part des mesures signalées que l'analyste a étiquetées) ; « toutes »
|
||||
@@ -39,7 +39,7 @@ def version():
|
||||
def mesurer():
|
||||
"""-> ({cas: {clé: [étiquetées, signalées, les deux]}}, [cas sautés et pourquoi]) ; le total sous « total »."""
|
||||
res, sautes = {}, []
|
||||
for chemin in sorted(glob.glob(os.path.join(RACINE, "agents", "diagnostic", "cas", "C-*", "etiquettes.json"))):
|
||||
for chemin in sorted(glob.glob(os.path.join(RACINE, "events", "C-*", "etiquettes.json"))):
|
||||
cas = os.path.dirname(chemin)
|
||||
sortie = io.StringIO()
|
||||
with contextlib.redirect_stdout(sortie):
|
||||
|
||||
@@ -24,7 +24,7 @@ from pathlib import Path
|
||||
RACINE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..")
|
||||
sys.path.insert(0, os.path.join(RACINE, "vues-deplacements", "detectors"))
|
||||
sys.path.insert(0, os.path.join(RACINE, ".claude", "skills", "critiquer-lot"))
|
||||
import categories # noqa: E402 (il met lui-même agents/diagnostic/outils sur le chemin)
|
||||
import categories # noqa: E402 (il met lui-même agent-tools sur le chemin)
|
||||
from donnees import charger, instant, iso # noqa: E402
|
||||
from etiquettes import defauts, vocabulaire # noqa: E402
|
||||
|
||||
|
||||
@@ -17,8 +17,8 @@ Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du
|
||||
- `.claude/skills/lire-les-donnees/SKILL.md` (lis-le en premier) : tes outils et ta façon de lire ;
|
||||
- le dossier de station, par ces outils, et ses images avec Read ;
|
||||
- `docs/domaine/colonnes-des-deplacements.md` et `docs/domaine/pieges-des-donnees.md`, que ce skill cite ;
|
||||
- `docs/displacement/domaine/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4 : définition de chacune, éventualités du terrain qui la font, détecteurs ; D-074) ;
|
||||
- à l'étape 4 seulement, jamais avant : `agents/diagnostic/cas/INDEX.md`, puis les fiches `cas.md` qu'il cite et leurs figures.
|
||||
- `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4 : définition de chacune, éventualités du terrain qui la font, détecteurs ; D-074) ;
|
||||
- à l'étape 4 seulement, jamais avant : `events/INDEX.md`, puis les fiches `cas.md` qu'il cite et leurs figures.
|
||||
|
||||
Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les critiques et bilans d'autres lots, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ».
|
||||
|
||||
|
||||
@@ -21,10 +21,10 @@ 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"))
|
||||
sys.path.insert(0, os.path.join(RACINE, "agent-tools"))
|
||||
from donnees import charger # noqa: E402
|
||||
|
||||
CARTE = os.path.join(RACINE, "docs", "displacement", "domaine", "carte-des-evenements.md")
|
||||
CARTE = os.path.join(RACINE, "events", "carte-des-evenements.md")
|
||||
CHAMPS = {"debut", "fin", "capteurs", "categorie", "evenement", "preuve", "description", "apres_detecteurs"}
|
||||
|
||||
|
||||
|
||||
@@ -18,13 +18,13 @@ Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdi
|
||||
|
||||
| Commande | Ce qu'elle rend |
|
||||
|---|---|
|
||||
| `python3 agents/diagnostic/outils/inventaire.py <dossier> [--debut T] [--fin T] [--fichiers]` | Fichiers par type (au-delà de 5 par type : le nombre, le premier et le dernier ; `--fichiers` pour la liste complète, à n'utiliser que pour chercher un fichier précis), images (heures couvertes), poses de la caméra (nombre, période, instants de mesure sans recalage), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, mesures rejetées) : ces comptes portent sur **toute la période**. Avec `--debut`/`--fin` (sur un lot : ceux du lot), une section de plus pour la fenêtre : les pas absents datés (pour tous les capteurs, ou lesquels manquent), par capteur, les mesures rejetées datées (suites de pas consécutifs), puis le **nombre de références retenues par la compensation** (`inlier` = 1) à chaque instant et les suites datées où des références ne le sont pas, lesquelles et pourquoi (`r` rejetée, `0` écartée par la compensation, `vide`). Une mesure est rejetée quand son `error_value` dépasse le seuil du capteur, **références comprises** |
|
||||
| `python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--niveau periode\|fenetre] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur (médiane, MAD, min, max) sur toute la période, ou sur la fenêtre `--debut`/`--fin` avec `--niveau fenetre` (pour un lot : un changement de niveau dans le lot ne se compare pas à des semaines d'autres mesures), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` |
|
||||
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries ; chaque `--zone` est grisée ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
|
||||
| `.venv/bin/python agents/diagnostic/outils/ensemble.py <dossier> [--colonnes x,y,sigma0] [--colonne error_value] [--pas 15min] [--k 5] [--min 5] [--residus corr_x,corr_y,error_value] [--hors T1/T2] [--autres] [--rigide BASE [--sans A,B]] [--capteurs A,B] [--debut T] [--fin T] [--sortie D]` | Tous les capteurs ensemble, chacun face à sa médiane et sa MAD sur la fenêtre. Deux PNG : **commun** (médiane entre capteurs de `x`, `y`, `sigma0` : avec la dispersion entre capteurs en bande grise ; sur les panneaux `x`, `y`, en plus, **chaque référence globale à part** (un trait chacune) et la **médiane des cibles seules** (trait noir) ; et, à chaque pas, le nombre de capteurs dont `--colonne` dépasse sa médiane de plus de `--k` MAD ; en tête, si le dossier a `camera/`, la **pose de la caméra**, valeurs brutes, un point par recalage, le trait coupé aux instants de mesure sans recalage) et **multiples** (un petit graphique par capteur, une échelle chacun : un palier d'un seul capteur s'y voit). Imprime aussi la **table de la médiane commune** (une ligne par pas de `--pas` : l'heure et l'écart à la médiane de la fenêtre de `x`, `y`, `sigma0`, puis `x_cibles`, `y_cibles` (médiane des cibles seules), puis la pose brute de la caméra, colonnes `cam_pan`, `cam_tilt`, `cam_rotation`, `cam_scale`, `cam_sigma0`, vides sans recalage) avec le minimum et le maximum de chaque colonne et leur instant, puis ceux de `x`, `y` de chaque référence globale (marqués `(rejetée)` quand la mesure l'est, avec le nombre de mesures rejetées de la référence), puis les instants de mesure sans pose (suites datées), puis les instants où au moins `--min` capteurs dépassent ensemble, avec leurs noms. Trois PNG de plus, **residus-corr_x**, **residus-corr_y**, **residus-error_value** (`--residus`) : un petit graphique par capteur de la colonne moins le niveau propre du capteur (sa médiane sur la fenêtre ; avec `--hors T1/T2`, celle du reste de la fenêtre, hors du moment lu), une échelle chacun, zéro en pointillé : un écart de quelques centièmes sur `corr`, caché dans les bandes parallèles de `graphique.py`, s'y voit ; imprime pour chaque capteur le niveau, le bruit propre (médiane des écarts entre deux mesures) et l'écart min/max par pas avec leur instant, en unités et en bruits. Avec `--autres`, des PNG **residus-…-autres** de plus : chaque capteur moins sa propre médiane **et moins la médiane des autres capteurs au même instant** (ce que tous partagent, le reste de la compensation d'un mouvement commun, s'annule ; ce qui est propre reste), et, par capteur, la pente et la corrélation r de ce résidu sur la médiane commune de `x`, `y`, `sigma0` : un creux qui reste après `--autres` n'est pas un reste partagé par tous ; une pente élevée avec r proche de ±1 sur `y` commun dit qu'il est proportionnel au mouvement commun (gain propre au capteur), sans r ni pente il est indépendant du mouvement. Avec `--rigide BASE`, un PNG **rigide** de plus : à chaque mesure, le mouvement d'ensemble des cibles depuis l'instant `BASE` (translation, rotation, échelle, estimé par médianes : une cible qui saute seule ne le tire pas ; `--sans A,B` en retire des cibles), et, pour chaque capteur, le **résidu** `dx`, `dy` (position brute moins sa position à `BASE` transportée par ce mouvement, en px) ; panneaux : `dx`, `dy` de chaque référence globale face à la médiane et au 10e-90e centile des cibles, `|résidu|` des cibles (médiane, 90e centile), rotation et échelle ajustées, `reproj_err` des références ; imprime la table au pas (`rot_deg`, `echelle`, `tx`, `ty`, `cib_med`, `cib_max`, `dx`, `dy` de chaque référence) et, par capteur, min, max et valeur au dernier instant de `dx`, `dy`. Contrairement à l'écart à la médiane, ce résidu ne dépend pas de la place du capteur dans l'image quand la scène tourne ou change d'échelle. Les graduations du PNG « commun » sont toutes les 1 à 12 h selon la fenêtre. Le pas par défaut est de 15 min, la cadence des mesures : un pas d'une heure aplatit un pic d'un à quatre pas, date à l'heure et efface une agitation de `x`, `y` ; ne l'élargis pas pour lire un lot. `--min 1` liste aussi les instants où un seul capteur sort de son niveau (un pic de capteur seul n'est pas dans la liste par défaut, qui demande 5 capteurs). **Regarde les PNG avec Read** |
|
||||
| `python3 agents/diagnostic/outils/plages.py <dossier> [--colonnes error_value,corr_x,corr_y] [--k 5] [--fusion 1h] [--min-mesures 1] [--hors T1/T2] [--capteurs A,B] [--debut T] [--fin T]` | Par colonne et par capteur, aux mesures (pas natif, jamais moyennées) : niveau (médiane de la fenêtre), bruit propre, **plus grand saut** d'une mesure à la suivante (valeur, en bruits, les deux instants) ; puis les **plages** où le capteur s'écarte de son niveau de plus de `--k` bruits : début, fin, nombre de mesures, extrême (signé, en unités et en bruits) et son instant ; deux plages du même sens à moins de `--fusion` n'en font qu'une, les mesures rejetées ne coupent pas une plage ; colonne `rejetées` : combien des mesures de la plage le sont (et `extrême rejetée`), `(rejetée : …)` après un plus grand saut dont un bout l'est. Sert à dater le début et la fin d'un moment d'un capteur sans relancer dix tableaux. Quand un épisode long fausse la médiane de la fenêtre (le capteur y passe la moitié du lot), `--hors T1/T2` calcule niveau et bruit hors de l'épisode ; une plage qui touche le bord de la fenêtre est datée au bord. `--min-mesures N` n'imprime que les plages d'au moins N mesures (et dit combien sur le total) : sur un lot de plusieurs jours, les plages d'un pas se comptent par centaines et noient les paliers longs ; lis d'abord avec `--min-mesures 6`, puis sans |
|
||||
| `.venv/bin/python agents/diagnostic/outils/jours.py <dossier> [--colonnes corr_x,corr_y,error_value] [--nuit 20-3] [--k 5] [--jours 2] [--pas 15min] [--capteurs A,B] [--debut T] [--fin T] [--sortie D]` | Ce qui revient d'un jour à l'autre, sur les mesures acceptées seulement. 1. **Niveau de chaque nuit** (heures `--nuit` H1-H2 UTC, à cheval sur minuit, datée du jour où elle commence), par capteur et par colonne : médiane, MAD, nombre de mesures, et le bruit propre ; puis, d'une nuit à la suivante, la **marche** (différence des médianes, en unités et en bruits) et **où elle se place** (« entre A et B » : là où la suite des mesures de nuit des deux nuits se coupe le mieux entre les deux niveaux ; B au début de la nuit suivante : la coupure tombe de jour, entre les deux nuits). Une marche de quelques bruits, une dérive d'une nuit à l'autre, et deux colonnes qui marchent au même instant s'y lisent, même quand le capteur a plusieurs niveaux dans le lot. 2. **Jours superposés** : PNG **parheure-<colonne>**, un petit graphique par capteur, en abscisse l'heure du jour, une courbe par jour, chaque mesure moins le niveau de la dernière nuit commencée (nuit grisée, cadre du 1er au 99e centile, le titre dit combien de mesures sortent du cadre) ; table : par créneau de `--pas` de l'heure du jour, les capteurs dont l'écart dépasse `--k` bruits, du même côté, au moins `--jours` jours, avec le nombre de jours et la médiane de ces écarts. Ce qui revient chaque jour à la même heure, sur un capteur ou plusieurs, s'y groupe, même quand cela ne dure qu'une à trois mesures. Le choix de `--nuit` : des heures où le cycle du jour (`error_value`, pose de la caméra) est retombé. **Regarde les PNG avec Read** |
|
||||
| `.venv/bin/python agents/diagnostic/outils/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--contraste [MIN,MAX]] [--fixe] [--sortie D]` | Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur à chaque heure (le centre du cadre est écrit sous chaque vignette : quand `x`, `y` sautent, le cadre se déplace d'autant, et une tache qui entre dans le cadre semble apparaître) ; `--fixe` garde pour chaque capteur le cadre de la première heure et marque d'une croix rouge les `x`, `y` de chaque heure ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre ; imprime pour chaque vignette le fond (médiane), le 99e centile et le pic (niveaux de gris 0 à 255) ; sans image à l'heure demandée, prend la plus proche et imprime l'écart (l'heure réelle est dans le titre). Une tache faible ou déformée est invisible telle quelle : `--contraste MIN,MAX` met toutes les vignettes en gris avec le même étirement (sans valeur : du 1er centile au maximum de la planche, écrasé par un pixel saturé ; choisis alors MIN,MAX d'après le fond et le pic imprimés, ex. `10,40`), `--rayon 30` à `50` grossit ; compare la forme et le pic avant, pendant et après un épisode, à la même heure de la journée. **Regarde-la avec Read** : une image entière lue par Read est réduite, un petit réflecteur y devient illisible |
|
||||
| `python3 agent-tools/inventaire.py <dossier> [--debut T] [--fin T] [--fichiers]` | Fichiers par type (au-delà de 5 par type : le nombre, le premier et le dernier ; `--fichiers` pour la liste complète, à n'utiliser que pour chercher un fichier précis), images (heures couvertes), poses de la caméra (nombre, période, instants de mesure sans recalage), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, mesures rejetées) : ces comptes portent sur **toute la période**. Avec `--debut`/`--fin` (sur un lot : ceux du lot), une section de plus pour la fenêtre : les pas absents datés (pour tous les capteurs, ou lesquels manquent), par capteur, les mesures rejetées datées (suites de pas consécutifs), puis le **nombre de références retenues par la compensation** (`inlier` = 1) à chaque instant et les suites datées où des références ne le sont pas, lesquelles et pourquoi (`r` rejetée, `0` écartée par la compensation, `vide`). Une mesure est rejetée quand son `error_value` dépasse le seuil du capteur, **références comprises** |
|
||||
| `python3 agent-tools/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--niveau periode\|fenetre] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur (médiane, MAD, min, max) sur toute la période, ou sur la fenêtre `--debut`/`--fin` avec `--niveau fenetre` (pour un lot : un changement de niveau dans le lot ne se compare pas à des semaines d'autres mesures), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` |
|
||||
| `.venv/bin/python agent-tools/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries ; chaque `--zone` est grisée ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
|
||||
| `.venv/bin/python agent-tools/ensemble.py <dossier> [--colonnes x,y,sigma0] [--colonne error_value] [--pas 15min] [--k 5] [--min 5] [--residus corr_x,corr_y,error_value] [--hors T1/T2] [--autres] [--rigide BASE [--sans A,B]] [--capteurs A,B] [--debut T] [--fin T] [--sortie D]` | Tous les capteurs ensemble, chacun face à sa médiane et sa MAD sur la fenêtre. Deux PNG : **commun** (médiane entre capteurs de `x`, `y`, `sigma0` : avec la dispersion entre capteurs en bande grise ; sur les panneaux `x`, `y`, en plus, **chaque référence globale à part** (un trait chacune) et la **médiane des cibles seules** (trait noir) ; et, à chaque pas, le nombre de capteurs dont `--colonne` dépasse sa médiane de plus de `--k` MAD ; en tête, si le dossier a `camera/`, la **pose de la caméra**, valeurs brutes, un point par recalage, le trait coupé aux instants de mesure sans recalage) et **multiples** (un petit graphique par capteur, une échelle chacun : un palier d'un seul capteur s'y voit). Imprime aussi la **table de la médiane commune** (une ligne par pas de `--pas` : l'heure et l'écart à la médiane de la fenêtre de `x`, `y`, `sigma0`, puis `x_cibles`, `y_cibles` (médiane des cibles seules), puis la pose brute de la caméra, colonnes `cam_pan`, `cam_tilt`, `cam_rotation`, `cam_scale`, `cam_sigma0`, vides sans recalage) avec le minimum et le maximum de chaque colonne et leur instant, puis ceux de `x`, `y` de chaque référence globale (marqués `(rejetée)` quand la mesure l'est, avec le nombre de mesures rejetées de la référence), puis les instants de mesure sans pose (suites datées), puis les instants où au moins `--min` capteurs dépassent ensemble, avec leurs noms. Trois PNG de plus, **residus-corr_x**, **residus-corr_y**, **residus-error_value** (`--residus`) : un petit graphique par capteur de la colonne moins le niveau propre du capteur (sa médiane sur la fenêtre ; avec `--hors T1/T2`, celle du reste de la fenêtre, hors du moment lu), une échelle chacun, zéro en pointillé : un écart de quelques centièmes sur `corr`, caché dans les bandes parallèles de `graphique.py`, s'y voit ; imprime pour chaque capteur le niveau, le bruit propre (médiane des écarts entre deux mesures) et l'écart min/max par pas avec leur instant, en unités et en bruits. Avec `--autres`, des PNG **residus-…-autres** de plus : chaque capteur moins sa propre médiane **et moins la médiane des autres capteurs au même instant** (ce que tous partagent, le reste de la compensation d'un mouvement commun, s'annule ; ce qui est propre reste), et, par capteur, la pente et la corrélation r de ce résidu sur la médiane commune de `x`, `y`, `sigma0` : un creux qui reste après `--autres` n'est pas un reste partagé par tous ; une pente élevée avec r proche de ±1 sur `y` commun dit qu'il est proportionnel au mouvement commun (gain propre au capteur), sans r ni pente il est indépendant du mouvement. Avec `--rigide BASE`, un PNG **rigide** de plus : à chaque mesure, le mouvement d'ensemble des cibles depuis l'instant `BASE` (translation, rotation, échelle, estimé par médianes : une cible qui saute seule ne le tire pas ; `--sans A,B` en retire des cibles), et, pour chaque capteur, le **résidu** `dx`, `dy` (position brute moins sa position à `BASE` transportée par ce mouvement, en px) ; panneaux : `dx`, `dy` de chaque référence globale face à la médiane et au 10e-90e centile des cibles, `|résidu|` des cibles (médiane, 90e centile), rotation et échelle ajustées, `reproj_err` des références ; imprime la table au pas (`rot_deg`, `echelle`, `tx`, `ty`, `cib_med`, `cib_max`, `dx`, `dy` de chaque référence) et, par capteur, min, max et valeur au dernier instant de `dx`, `dy`. Contrairement à l'écart à la médiane, ce résidu ne dépend pas de la place du capteur dans l'image quand la scène tourne ou change d'échelle. Les graduations du PNG « commun » sont toutes les 1 à 12 h selon la fenêtre. Le pas par défaut est de 15 min, la cadence des mesures : un pas d'une heure aplatit un pic d'un à quatre pas, date à l'heure et efface une agitation de `x`, `y` ; ne l'élargis pas pour lire un lot. `--min 1` liste aussi les instants où un seul capteur sort de son niveau (un pic de capteur seul n'est pas dans la liste par défaut, qui demande 5 capteurs). **Regarde les PNG avec Read** |
|
||||
| `python3 agent-tools/plages.py <dossier> [--colonnes error_value,corr_x,corr_y] [--k 5] [--fusion 1h] [--min-mesures 1] [--hors T1/T2] [--capteurs A,B] [--debut T] [--fin T]` | Par colonne et par capteur, aux mesures (pas natif, jamais moyennées) : niveau (médiane de la fenêtre), bruit propre, **plus grand saut** d'une mesure à la suivante (valeur, en bruits, les deux instants) ; puis les **plages** où le capteur s'écarte de son niveau de plus de `--k` bruits : début, fin, nombre de mesures, extrême (signé, en unités et en bruits) et son instant ; deux plages du même sens à moins de `--fusion` n'en font qu'une, les mesures rejetées ne coupent pas une plage ; colonne `rejetées` : combien des mesures de la plage le sont (et `extrême rejetée`), `(rejetée : …)` après un plus grand saut dont un bout l'est. Sert à dater le début et la fin d'un moment d'un capteur sans relancer dix tableaux. Quand un épisode long fausse la médiane de la fenêtre (le capteur y passe la moitié du lot), `--hors T1/T2` calcule niveau et bruit hors de l'épisode ; une plage qui touche le bord de la fenêtre est datée au bord. `--min-mesures N` n'imprime que les plages d'au moins N mesures (et dit combien sur le total) : sur un lot de plusieurs jours, les plages d'un pas se comptent par centaines et noient les paliers longs ; lis d'abord avec `--min-mesures 6`, puis sans |
|
||||
| `.venv/bin/python agent-tools/jours.py <dossier> [--colonnes corr_x,corr_y,error_value] [--nuit 20-3] [--k 5] [--jours 2] [--pas 15min] [--capteurs A,B] [--debut T] [--fin T] [--sortie D]` | Ce qui revient d'un jour à l'autre, sur les mesures acceptées seulement. 1. **Niveau de chaque nuit** (heures `--nuit` H1-H2 UTC, à cheval sur minuit, datée du jour où elle commence), par capteur et par colonne : médiane, MAD, nombre de mesures, et le bruit propre ; puis, d'une nuit à la suivante, la **marche** (différence des médianes, en unités et en bruits) et **où elle se place** (« entre A et B » : là où la suite des mesures de nuit des deux nuits se coupe le mieux entre les deux niveaux ; B au début de la nuit suivante : la coupure tombe de jour, entre les deux nuits). Une marche de quelques bruits, une dérive d'une nuit à l'autre, et deux colonnes qui marchent au même instant s'y lisent, même quand le capteur a plusieurs niveaux dans le lot. 2. **Jours superposés** : PNG **parheure-<colonne>**, un petit graphique par capteur, en abscisse l'heure du jour, une courbe par jour, chaque mesure moins le niveau de la dernière nuit commencée (nuit grisée, cadre du 1er au 99e centile, le titre dit combien de mesures sortent du cadre) ; table : par créneau de `--pas` de l'heure du jour, les capteurs dont l'écart dépasse `--k` bruits, du même côté, au moins `--jours` jours, avec le nombre de jours et la médiane de ces écarts. Ce qui revient chaque jour à la même heure, sur un capteur ou plusieurs, s'y groupe, même quand cela ne dure qu'une à trois mesures. Le choix de `--nuit` : des heures où le cycle du jour (`error_value`, pose de la caméra) est retombé. **Regarde les PNG avec Read** |
|
||||
| `.venv/bin/python agent-tools/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--contraste [MIN,MAX]] [--fixe] [--sortie D]` | Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur à chaque heure (le centre du cadre est écrit sous chaque vignette : quand `x`, `y` sautent, le cadre se déplace d'autant, et une tache qui entre dans le cadre semble apparaître) ; `--fixe` garde pour chaque capteur le cadre de la première heure et marque d'une croix rouge les `x`, `y` de chaque heure ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre ; imprime pour chaque vignette le fond (médiane), le 99e centile et le pic (niveaux de gris 0 à 255) ; sans image à l'heure demandée, prend la plus proche et imprime l'écart (l'heure réelle est dans le titre). Une tache faible ou déformée est invisible telle quelle : `--contraste MIN,MAX` met toutes les vignettes en gris avec le même étirement (sans valeur : du 1er centile au maximum de la planche, écrasé par un pixel saturé ; choisis alors MIN,MAX d'après le fond et le pic imprimés, ex. `10,40`), `--rayon 30` à `50` grossit ; compare la forme et le pic avant, pendant et après un épisode, à la même heure de la journée. **Regarde-la avec Read** : une image entière lue par Read est réduite, un petit réflecteur y devient illisible |
|
||||
| `ls <dossier>/images/ \| grep <AAAAMMJJ>T<HHMM>Z`, puis Read sur le fichier trouvé (Read ne prend pas de motif) | L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo) |
|
||||
|
||||
`--sortie <dossier>` : là où celui qui t'appelle range tes figures ; il te le donne.
|
||||
|
||||
@@ -7,7 +7,7 @@ argument-hint: "[fichiers ou dossier des données] [station] [fenêtre UTC]"
|
||||
|
||||
# Ajouter un cas à la base de l'agent de diagnostic
|
||||
|
||||
Un cas, c'est un incident (station, fenêtre) et le diagnostic de l'expert, rangés dans `agents/diagnostic/cas/` (spec : §11 de `docs/agents/agent-diagnostic.md`). Avant d'écrire la fiche, l'agent passe à l'aveugle sur l'incident : c'est le test de régression du cas. Lancer ce skill est la demande explicite d'ajout ; des données reçues ou un rapport validé n'ajoutent jamais un cas d'eux-mêmes.
|
||||
Un cas, c'est un incident (station, fenêtre) et le diagnostic de l'expert, rangés dans `events/` (spec : §11 de `docs/agents/agent-diagnostic.md`). Avant d'écrire la fiche, l'agent passe à l'aveugle sur l'incident : c'est le test de régression du cas. Lancer ce skill est la demande explicite d'ajout ; des données reçues ou un rapport validé n'ajoutent jamais un cas d'eux-mêmes.
|
||||
|
||||
## 1. Réunir la demande, en un seul message
|
||||
|
||||
@@ -25,7 +25,7 @@ L'avis de l'expert reste dans la conversation jusqu'à l'étape 5 : rien de lui
|
||||
- Données : pompées dans `data/<STATION>/` (`run.md`, `<STATION>` = numéro de série du système). Si la fenêtre n'y est pas, donne à l'utilisateur la commande du pompage sur la fenêtre, 3 jours de plus avant, avec `--images` (`--every 10` pour une image par mesure à 10 min), et attends.
|
||||
- Export reçu à la main, à défaut : `data/<STATION>/displacement/`, nom d'origine gardé.
|
||||
- Images reçues à la main : `data/<STATION>/images/<AAAAMMJJ>T<HHMM>Z_<nom d'origine sans extension>.jpg`, heure en **UTC**, originaux laissés en place. Les zips de la plateforme datent chaque image en UTC dans son entrée (vérifié sur CLARIDEN : l'image se décale à l'instant où les mesures sautent) ; l'export couvre, lui, des jours locaux (début à 22:00Z la veille en été) : 2 h d'écart entre les deux plages sont normales. Garde toutes les images de la plage, même à 10 min : une par mesure. Une heure locale se convertit, par exemple `date -u -d 'TZ="Europe/Zurich" 2026-11-03 20:00' +%Y%m%dT%H%MZ` (heure d'hiver ou d'été selon la date). Regarde-les : la nuit et le jour tombent aux bonnes heures UTC ; ni personne ni véhicule (dépôt privé, D-014), sinon demande.
|
||||
- Vérifie avec `python3 agents/diagnostic/outils/inventaire.py data/<STATION>/` : l'export est trouvé, il couvre la fenêtre, les images sont datées. Puis `resume.py` sur la fenêtre, avec les capteurs que cite l'expert : l'anomalie s'y voit.
|
||||
- Vérifie avec `python3 agent-tools/inventaire.py data/<STATION>/` : l'export est trouvé, il couvre la fenêtre, les images sont datées. Puis `resume.py` sur la fenêtre, avec les capteurs que cite l'expert : l'anomalie s'y voit.
|
||||
- Si les données contredisent l'expert (capteur absent, rien d'anormal dans la fenêtre), arrête-toi et dis-le.
|
||||
|
||||
## 3. Commit neutre, arbre propre
|
||||
@@ -38,12 +38,12 @@ Le sous-agent reçoit la branche et les derniers messages de commit (§7 de la s
|
||||
|
||||
1. Avant de lancer, écris dans la conversation les attendus tirés de l'avis de l'expert : l'anomalie, les capteurs touchés et des témoins intacts, la classification, aucune conclusion au-delà des preuves. Avec l'index tel qu'il est, l'agent répond « aucun cas connu » ou cite le bon cas, jamais un faux. Sans cas, une conséquence « indéterminée » est normale (asymétrie), ce n'est pas un défaut.
|
||||
2. Lance l'outil Agent, `subagent_type: diagnostic`, avec ce prompt et rien d'autre : `data/<STATION>/ que s'est-il passé du <début> au <fin> (UTC) ?`
|
||||
3. Fais un tableau attendu / résultat. Si un attendu est manqué ou une conclusion va au-delà des preuves, propose à l'utilisateur une correction **générale** de `agents/diagnostic/instructions.md`, sans nom de capteur ni de site. Si elle repose sur un jugement métier non confirmé, ne la code pas : pose la question à l'utilisateur ; sa réponse va dans le Diagnostic de la fiche (le fait, et ce qu'en dit l'expert). Une correction acceptée se commite avec le premier rapport, par chemin, sous un message neutre (`Fix <règle générale> in the diagnostic instructions`), puis reprends 4.2.
|
||||
3. Fais un tableau attendu / résultat. Si un attendu est manqué ou une conclusion va au-delà des preuves, propose à l'utilisateur une correction **générale** de `agent-diagnostic/instructions.md`, sans nom de capteur ni de site. Si elle repose sur un jugement métier non confirmé, ne la code pas : pose la question à l'utilisateur ; sa réponse va dans le Diagnostic de la fiche (le fait, et ce qu'en dit l'expert). Une correction acceptée se commite avec le premier rapport, par chemin, sous un message neutre (`Fix <règle générale> in the diagnostic instructions`), puis reprends 4.2.
|
||||
4. Si seule la cause diverge, parce que les données ne la tranchent pas, ce n'est pas un défaut : ce qui ne se tranche pas va dans la ligne **Cause** du Diagnostic.
|
||||
|
||||
## 5. Écrire la fiche
|
||||
|
||||
- **Numéro** : le plus grand `C-xxx` de `agents/diagnostic/cas/INDEX.md`, plus un (C-001 si l'index est vide). Dossier : `agents/diagnostic/cas/C-xxx/`.
|
||||
- **Numéro** : le plus grand `C-xxx` de `events/INDEX.md`, plus un (C-001 si l'index est vide). Dossier : `events/C-xxx/`.
|
||||
- **Données** : copie-les dans le dossier du cas, noms codés, avec le skill `anonymiser-cas` (étape 1), avant les figures (D-050).
|
||||
- **`cas.md`** suit le modèle du §11.3 de la spec (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) :
|
||||
- seulement ce cas : ni les éventualités d'autres cas (pas d'exclusions), ni l'historique des tests (D-051) ;
|
||||
@@ -54,12 +54,12 @@ Le sous-agent reçoit la branche et les derniers messages de commit (§7 de la s
|
||||
- **Ligne d'index** : `| [C-xxx](C-xxx/cas.md) | <événement, UTC> | <signature courte, observable> | <classification> | <cause, niveau de preuve> | <verdict court> |`. Retire « *Base vide pour l'instant.* ».
|
||||
- **Validation du rapport à l'aveugle** : verdict accepté ou corrigé (en quoi) ; diagnostic final, celui de l'expert ; `Devient un cas : oui (C-xxx)`.
|
||||
- **Anonymise** avec le skill `anonymiser-cas` (étape 3) : la station devient `C-xxx`, les capteurs `R1`, `C1`, et aucun nom réel ne reste (D-049, D-050).
|
||||
- **Étiquettes du cas** (D-069), pour le benchmark des détecteurs : l'outil Agent, `subagent_type: analyste`, avec cette demande (`<lot>` : première mesure du cas → dernière plus un pas, UTC) : `Étiquettes d'un cas de la base (benchmark des détecteurs, D-069), pas un lot de la boucle. Dossier de station : agents/diagnostic/cas/C-xxx/ (noms codés). Lot : <lot>. Dossier de sortie, pour tes figures : out/benchmark/C-xxx/. Fais seulement l'étape 1 de critiquer-lot : ta lecture, sans les détecteurs, puis tes étiquettes (section « Les étiquettes », "station": "C-xxx"), contrôlées par python3 .claude/skills/critiquer-lot/etiquettes.py agents/diagnostic/cas/C-xxx agents/diagnostic/cas/C-xxx/etiquettes.json jusqu'à « bon ». Ensuite seulement, lis la fiche agents/diagnostic/cas/C-xxx/cas.md, validée par l'expert, corrige les étiquettes qu'elle contredit (en réécrivant le fichier avec Write) et recontrôle. Écris agents/diagnostic/cas/C-xxx/etiquettes.json et `agents/diagnostic/cas/C-xxx/etiquetage.md`, dans cet ordre de sections : ta lecture (le tableau des moments de lire-les-donnees, avec la catégorie de chacun), « Ce que la fiche a changé », « Sources lues », « Difficultés » ; pas de verdict. Réponds en 3 lignes.` Le rendu, `etiquetage.md`, reste dans le dossier du cas, à côté de ses étiquettes.
|
||||
- **Étiquettes du cas** (D-069), pour le benchmark des détecteurs : l'outil Agent, `subagent_type: analyste`, avec cette demande (`<lot>` : première mesure du cas → dernière plus un pas, UTC) : `Étiquettes d'un cas de la base (benchmark des détecteurs, D-069), pas un lot de la boucle. Dossier de station : events/C-xxx/ (noms codés). Lot : <lot>. Dossier de sortie, pour tes figures : out/benchmark/C-xxx/. Fais seulement l'étape 1 de critiquer-lot : ta lecture, sans les détecteurs, puis tes étiquettes (section « Les étiquettes », "station": "C-xxx"), contrôlées par python3 .claude/skills/critiquer-lot/etiquettes.py events/C-xxx events/C-xxx/etiquettes.json jusqu'à « bon ». Ensuite seulement, lis la fiche events/C-xxx/cas.md, validée par l'expert, corrige les étiquettes qu'elle contredit (en réécrivant le fichier avec Write) et recontrôle. Écris events/C-xxx/etiquettes.json et `events/C-xxx/etiquetage.md`, dans cet ordre de sections : ta lecture (le tableau des moments de lire-les-donnees, avec la catégorie de chacun), « Ce que la fiche a changé », « Sources lues », « Difficultés » ; pas de verdict. Réponds en 3 lignes.` Le rendu, `etiquetage.md`, reste dans le dossier du cas, à côté de ses étiquettes.
|
||||
- **Montre la fiche et la ligne d'index à l'utilisateur, et attends son accord** : c'est l'expert qui valide un cas, pas Claude.
|
||||
|
||||
## 6. Commit et test de correspondance
|
||||
|
||||
1. Commite par chemin `agents/diagnostic/cas/`, le registre `.claude/skills/anonymiser-cas/registre.csv` et le rapport, avec le message `Add case C-xxx to the diagnostic case base` ; l'arbre est alors propre.
|
||||
1. Commite par chemin `events/`, le registre `.claude/skills/anonymiser-cas/registre.csv` et le rapport, avec le message `Add case C-xxx to the diagnostic case base` ; l'arbre est alors propre.
|
||||
2. Relance l'agent avec le même prompt (4.2), cette fois avec le cas dans l'index. Attendu : `C-xxx, complète` (ou partielle s'il manque une donnée), et le diagnostic de l'expert ; « aucune » conséquence seulement si la règle d'asymétrie le permet. Ce passage vérifie la mécanique de correspondance, pas le jugement : l'agent a lu la fiche.
|
||||
3. Si le cas ne correspond pas, la signature est trop stricte ou trop vague : corrige la fiche et relance. Commite par chemin le second rapport, et la fiche si tu l'as corrigée, avec le résultat dans le message (`Record the C-xxx match test`), même s'il réussit du premier coup : la fiche ne raconte pas ses tests.
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@ Le builder de `/boucle` ajoute des cas sans l'avis de l'expert (D-057). L'expert
|
||||
|
||||
## 1. Les cas à revoir
|
||||
|
||||
`grep -l "non revalidé par l'expert" agents/diagnostic/cas/*/cas.md` ; avec des arguments `C-xxx`, ceux-là seulement (un cas déjà validé : dis-le et passe). Aucun : dis-le et arrête-toi. Annonce la liste, puis prends-les un par un, du plus petit numéro au plus grand.
|
||||
`grep -l "non revalidé par l'expert" events/*/cas.md` ; avec des arguments `C-xxx`, ceux-là seulement (un cas déjà validé : dis-le et passe). Aucun : dis-le et arrête-toi. Annonce la liste, puis prends-les un par un, du plus petit numéro au plus grand.
|
||||
|
||||
## 2. Pour chaque cas
|
||||
|
||||
@@ -23,9 +23,9 @@ Le builder de `/boucle` ajoute des cas sans l'avis de l'expert (D-057). L'expert
|
||||
- **Rejeter** : le cas ne doit pas rester dans la base ;
|
||||
- **Passer** : plus tard, rien ne change.
|
||||
4. Selon sa réponse :
|
||||
- **Corriger** : envoie à l'agent (SendMessage, son identifiant ; à défaut, un nouvel agent `revue` avec le même début de prompt) `C-xxx, corriger : <ses mots, tels quels>`. Relaie son rendu, `git diff --stat agents/diagnostic/cas/` ; la page s'est rouverte, à jour ; puis repose la question 3 ;
|
||||
- **Valider** : envoie `C-xxx, valider`, relaie les deux lignes, puis commite par chemin `agents/diagnostic/cas/C-xxx/` et `agents/diagnostic/cas/INDEX.md`, message `Validate case C-xxx` (ou `Validate case C-xxx with the expert's corrections`) ;
|
||||
- **Rejeter** : demande en une phrase s'il faut une trace (une ligne dans la critique du lot d'origine suffit), puis `git rm -r agents/diagnostic/cas/C-xxx/`, retire sa ligne d'index, commite par chemin, message `Remove learned case C-xxx rejected by the expert`. Le registre garde ses lignes (il ne fait que grandir) ; le numéro n'est pas réutilisé ;
|
||||
- **Corriger** : envoie à l'agent (SendMessage, son identifiant ; à défaut, un nouvel agent `revue` avec le même début de prompt) `C-xxx, corriger : <ses mots, tels quels>`. Relaie son rendu, `git diff --stat events/` ; la page s'est rouverte, à jour ; puis repose la question 3 ;
|
||||
- **Valider** : envoie `C-xxx, valider`, relaie les deux lignes, puis commite par chemin `events/C-xxx/` et `events/INDEX.md`, message `Validate case C-xxx` (ou `Validate case C-xxx with the expert's corrections`) ;
|
||||
- **Rejeter** : demande en une phrase s'il faut une trace (une ligne dans la critique du lot d'origine suffit), puis `git rm -r events/C-xxx/`, retire sa ligne d'index, commite par chemin, message `Remove learned case C-xxx rejected by the expert`. Le registre garde ses lignes (il ne fait que grandir) ; le numéro n'est pas réutilisé ;
|
||||
- **Passer** : rien.
|
||||
5. Cas suivant.
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ sys.path.insert(0, os.path.join(ICI, "..", "boucle"))
|
||||
import detecteurs # noqa: E402
|
||||
from comparaison import ROOT, open_served # noqa: E402
|
||||
|
||||
CAS = os.path.join(ROOT, "agents", "diagnostic", "cas")
|
||||
CAS = os.path.join(ROOT, "events")
|
||||
|
||||
|
||||
def lire(chemin):
|
||||
|
||||
@@ -25,7 +25,7 @@ S'il te manque la station, ou une plage qui reste ambiguë, demande-le à Marc *
|
||||
|
||||
## 2. Vérifier les données
|
||||
|
||||
`python3 agents/diagnostic/outils/inventaire.py data/<STATION>/ --debut T --fin T`. S'il manque les déplacements ou les images de la plage, dis à Marc ce qui manque (dates, type) et arrête-toi : c'est lui qui pompe (`run.md`).
|
||||
`python3 agent-tools/inventaire.py data/<STATION>/ --debut T --fin T`. S'il manque les déplacements ou les images de la plage, dis à Marc ce qui manque (dates, type) et arrête-toi : c'est lui qui pompe (`run.md`).
|
||||
|
||||
## 3. Le dossier du cas
|
||||
|
||||
@@ -51,13 +51,13 @@ La capture : une image collée apparaît dans le message comme `[Image: source:
|
||||
|
||||
## 4. Enquêter sur la question
|
||||
|
||||
Lis `.claude/skills/lire-les-donnees/SKILL.md`, puis suis `agents/diagnostic/instructions.md`, §4 étapes 2, 4, 5 et 7 (repérage avec `categories.py`, faits, cas connus après les faits, réfutation) et §5 (règles), **limités à la plage et à ce qu'il faut pour répondre**. Figures avec `--sortie support/<dossier>/`.
|
||||
Lis `.claude/skills/lire-les-donnees/SKILL.md`, puis suis `agent-diagnostic/instructions.md`, §4 étapes 2, 4, 5 et 7 (repérage avec `categories.py`, faits, cas connus après les faits, réfutation) et §5 (règles), **limités à la plage et à ce qu'il faut pour répondre**. Figures avec `--sortie support/<dossier>/`.
|
||||
|
||||
- Situe ce dont parle le client : quand, quels capteurs, cibles ou références, et ce que font les autres capteurs.
|
||||
- La capture peut comparer la caméra à un autre instrument du client (ex. une station totale, « tachy », en traits continus, la caméra en traitillés). Ne t'appuie sur cet instrument que s'il a des points sur la plage : une ligne continue peut relier deux points de part et d'autre de la nuit (une station totale n'envoie souvent rien la nuit, faute de visibilité). Si tu ne peux pas le voir sur la capture, demande à Marc.
|
||||
- Regarde les **images entières** (Read) aux moments en question, plus une avant et une après ; `vignettes.py` pour les cibles touchées et un témoin.
|
||||
- Dis ce que la cadence des images ne permet pas d'établir : des images horaires peuvent manquer un train qui passe en une minute ; une image sans train ne prouve pas qu'aucun train n'est passé.
|
||||
- Le GIF, s'il prouve mieux qu'une phrase (un passage, de la buée qui se lève) : `.venv/bin/python agents/diagnostic/outils/gif.py data/<STATION>/ --debut T --fin T --sortie support/<dossier>/` (720 px, 64 teintes, heure UTC en bas à droite ; ~3 Mo par nuit d'images horaires). Garde-le sous ~5 Mo (pièce jointe) : resserre la plage ou `--largeur`. Regarde quelques-unes de ses images sources avec Read avant de le joindre.
|
||||
- Le GIF, s'il prouve mieux qu'une phrase (un passage, de la buée qui se lève) : `.venv/bin/python agent-tools/gif.py data/<STATION>/ --debut T --fin T --sortie support/<dossier>/` (720 px, 64 teintes, heure UTC en bas à droite ; ~3 Mo par nuit d'images horaires). Garde-le sous ~5 Mo (pièce jointe) : resserre la plage ou `--largeur`. Regarde quelques-unes de ses images sources avec Read avant de le joindre.
|
||||
|
||||
## 5. Écrire
|
||||
|
||||
|
||||
@@ -1,178 +1,142 @@
|
||||
# CLAUDE.md
|
||||
|
||||
Ce fichier est une **carte** du projet, chargée à chaque session : il dit ce qui existe et où, pas le détail. Il reste court (< 200 lignes, D-012). Le reste se lit à la demande, et seulement la partie utile (voir « Lire sans saturer le contexte »).
|
||||
Carte du projet, chargée à chaque session : ce qui existe et où, pas le détail (D-012, D-028). Elle reste sous 200 lignes ; le reste se lit à la demande, et seulement la partie utile (« Lire sans saturer le contexte »).
|
||||
|
||||
## Projet
|
||||
|
||||
Agent de diagnostic proactif pour **AIMsight**, un système de surveillance optique de déplacements : une caméra suit des cibles (prismes, réflecteurs) sur un ouvrage, et le mouvement de la caméra est compensé grâce à des cibles de référence. L'agent analyse les séries temporelles avec des **méthodes analytiques (pas de LLM)**, complétées à l'étude par une couche d'agents LLM côté serveur (D-027), détecte les anomalies et explique chacune d'elles (preuves calculées + ce qui reste non établi) **avant** que le client ne pose la question. Cible d'exécution idéale : **le système embarqué de la station**. Langage : **Python**.
|
||||
Diagnostic proactif pour **AIMsight**, un système de surveillance optique de déplacements : une caméra suit des cibles (prismes, réflecteurs) sur un ouvrage, et son propre mouvement est compensé grâce à des cibles de référence. Le projet analyse les séries temporelles des stations avec des **méthodes analytiques (pas de LLM)**, détecte les anomalies et explique chacune (preuves calculées, puis ce qui reste non établi) **avant** que le client ne pose la question. Des agents Claude Code s'y ajoutent pour lire les données, améliorer les détecteurs et répondre au support. Langage : **Python** ; cible idéale du calcul : le système embarqué de la station.
|
||||
|
||||
## État et prochaine étape (au 2026-10-24)
|
||||
Cadrage du product owner : sous-projet G, santé des sites et notifications au client (`docs/aimsight/AIMsight_handoff_G_site_health.md`). Sa dernière section liste les écarts de ce dépôt, à arbitrer par l'utilisateur.
|
||||
|
||||
- **Energy, livré (prototype, D-020, D-043)** : `DAILY_BATTERY_STATE` et `DAILY_BATTERY_TREND`, combinées par la matrice état × tendance en une couleur par jour (vert / orange / rouge, gris si inconnu) ; sur secteur (`DAILY_POWER_SOURCE`), la perte du secteur décide à la place de la matrice (rouge dès une heure < 13,4 V), statut `On mains` / `Not on mains` dans la notification du support et dans l'en-tête du bloc Energy de la vue client. Une figure Plotly pour le site (D-021 ; la matrice est codée mais pas tracée), un focus sur un jour et sa veille (D-024), un manuel en brouillon. Comparaison seulement : les deux moyennes glissantes sur 7 jours ; point ouvert : l'accoutumance après ~30 jours de déficit (fiche `moving_average_7_days_drop`).
|
||||
- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025).
|
||||
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
|
||||
- **Séries optiques (D-044)** : détecter les événements externes (occlusion, pluie, turbulence) dans les déplacements et produire une courbe corrigée, la brute gardée ; cadrage (`docs/displacement/cadrage.md`) ; données reçues (D-045) : PS des Coudres, export 15 min en UTC sur 5,5 jours, sans événement annoté (buée probable le matin), et 24 images horaires de la caméra, puis NORDEND, WILDSTRUBEL, CLARIDEN et NIEDERHORN, chacune devenue un cas de la base ; CLARIDEN est l'incident de Barcelone de la doc AIMsight, où l'expert voit un mouvement réel de l'ouvrage, la doc une instabilité des références (`docs/displacement/domaine/incident-de-barcelone.md`) ; deux rapports d'analyse AIMsight (murs GN-1.472 et GN-5.054), causes des déplacements apparents selon l'expert, sans leurs données ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan.
|
||||
- **Agent de diagnostic (D-046, révisé par D-058)** : pilote de l'enquête à la demande (D-042) dans Claude Code, appelé pour un cas précis que les détecteurs n'expliquent pas ; plus à l'aveugle : il lit la connaissance du projet et part des événements des détecteurs du journal, sans les juger, et n'ajoute aucun cas ; sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/<date>_<STATION>/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : cinq cas, C-001 à C-005 (l'index `agents/diagnostic/cas/INDEX.md` en est le registre), chaque cas avec ses données, la station au numéro du cas et les capteurs codés (D-049, D-050, skill `anonymiser-cas`), une fiche courte sur ce seul cas, lisible d'abord par un humain (D-051) ; un cas n'y entre que par `/nouveau-cas`, lancé par l'utilisateur, ou par le builder de la boucle (D-057), puis revu par l'utilisateur avec `/revue-cas` (D-075, agent `revue`). Ses outils et leur mode d'emploi, partagés avec l'analyste de la boucle : skill `lire-les-donnees`, aiguisé par `/aiguiser` (D-059, lancé par l'utilisateur seul ; spec `vues-deplacements/contexte/aiguiser-la-lecture.md`). L'enquête par API (D-042) reste un document.
|
||||
- **Support-agent (D-079)** : skill `/support <mail>`, lancé par l'utilisateur, dans la conversation : répond à la question d'un client sur un système, et à elle seule (le reste en note pour l'utilisateur), à partir des données locales de `data/` (station ou données absentes : il demande) ; un dossier par demande, `support/<date>_<STATION>_<sujet>/` (`demande.md`, `analyse.md`, `reponse.md`, le mail prêt à envoyer, GIF des images par `agents/diagnostic/outils/gif.py`), peaufiné avec l'utilisateur puis commité ; versionné, base de cas de support (usage à rediscuter) ; premier cas : LENZSPITZE, nuit du 26 au 27.10 ; design `docs/superpowers/specs/2026-10-28-support-agent-design.md`.
|
||||
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`.
|
||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
- **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`.
|
||||
- **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, matplotlib, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
||||
- **Journal du matin (D-056), le cap actuel** : retour au simple, côté support : une anomalie de déplacement est tout ce qui rend les courbes non plates : presque toujours sans gravité, un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois grave, un vrai mouvement (Barcelone : la voûte du pont s'affaisse) ; onglet `Journal` de la maquette Explore : courbes nettoyées en mm (px au choix), la brute en gris dans les zones à ignorer, frise « What happened » dépliable par catégorie, journal en cartes aux phrases catégoriques, bouton `▶ Images` ; un détecteur élémentaire par fichier dans `vues-deplacements/detectors/` (`visibilite`, `sauts`, `thermique`, `turbulence`, `trous`, `degradee`, contrat `detect(mesures)`), réglés sur les cas C-001 à C-005, classés en onze catégories par `categories.py` (aussi outil de tri en lot, toujours 3 jours d'historique) ; prototypé dans Support-Agent ; contexte dans `vues-deplacements/contexte/` (brainstorming `journal-du-matin.md`, seuils, lissage, données et boucle), carte des événements `docs/displacement/domaine/carte-des-evenements.md` ; pompage `extraction/pomper.py` (métriques système, déplacements et images, un fichier par jour, relance sans re-télécharger ; lecture seule, lancé une fois par l'utilisateur le 2026-10-26, NORDEND sur 2 jours, identique aux exports reçus ; sortie dans `data/`, hors de git, D-065 ; application de référence : `~/monitoring-dashboard`) ; boucle automatique `/boucle <dossier>` (D-057, construite, fonctionnement validé ; lancée par l'utilisateur seul, lot par lot, sur de nouvelles données) : analyste, upgrader, validateur et builder, lot après lot, tout commité directement sur `master` (D-070), chaque lot laissant les étiquettes de l'analyste, `etiquettes.json`, labels d'un futur modèle appris (D-061), et le score des détecteurs face à toutes les étiquettes, mesure par mesure, qui juge chaque modification (`.claude/skills/boucle/score.py`, D-062), et une page de fin de séance, l'analyste face aux détecteurs sur toute la plage (`comparaison.py`, D-066), et un benchmark des détecteurs sur la base de cas, chacun avec son diagnostic figé, versionné dans un historique (`benchmark.py`, D-069) (spec `vues-deplacements/contexte/boucle-automatique.md`) ; tout le suivi est dans le plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
|
||||
- **Prochaine étape** : **journal du matin (D-056)** : les points du plan encore en attente (pompage, première séance de la boucle par l'utilisateur, test « Claude verrait la même chose », portage), sur les consignes de l'utilisateur, dans d'autres conversations ; un point validé n'est plus repris ; ensuite, **déplacements (D-052 à D-055)** : détection mécanique des anomalies (D-055) : onglet `Displacements` de la maquette Explore, les sauts (brutaux et qui durent, retours compris) et les tendances (dérive lente et régulière), ce que regarde le client ; le survol d'une ligne les montre sur les courbes, échelle fixe (2026-10-19) ; très expérimental, seuils provisoires, sur NORDEND seuls PR17 et PR06 les passent, nettement (`vues-deplacements/contexte/detection-d-anomalies.md`) ; suite : la suite des retours de l'utilisateur, puis les pistes notées (accélération, cible qui se sépare de ses voisines) ; maquette de la page Explore (`vues-deplacements/maquette/`, cas NORDEND, D-054) : onglet View pour les images (glisseur, comparaison à ±24 h, `error_value` sur chaque capteur, gros plan des cibles avec les images d'avant et d'après), onglet Diagnosis pour les données (déplacements en mm et `error_value` des cibles choisies sur une plage, demande à l'agent composée sans être lancée) ; vérifiée par captures, clics à essayer, état dans `vues-deplacements/maquette/spec.md` ; cas NORDEND laissé là le 2026-10-16, PR17 sans explication claire (`vues-deplacements/cas/2026-10_NORDEND/parcours.md`) ; suite, à la demande de l'utilisateur : la sortie de l'agent dans la page, les annotations d'épisodes (à croiser avec l'agent), d'autres cas ; `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : ses outils propres, pour plus de précision (dans une autre conversation), et l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande.
|
||||
## État et prochaine étape (au 2026-10-28)
|
||||
|
||||
## Analyses (domaine Energy)
|
||||
- **Domaines système, livrés en prototype** : Energy (D-020, D-043), Storage (D-034, D-035), Cellular (D-031, D-037), Temperature (D-040) ; chacun avec ses analyses, sa couleur du jour, sa figure du site, son bloc dans la vue client, sa notification support et son guide (D-039, D-041). Seul Energy repose sur des cas de l'expert ; les autres ont des seuils provisoires et attendent le spécialiste.
|
||||
- **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025).
|
||||
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (C-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/boucle` (D-057) et `/aiguiser` (D-059), base de cas `events/` revue par `/revue-cas` (D-075). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
|
||||
- **Support** (D-079) : `/support <mail>` répond à la question d'un client, et à elle seule. Premier cas : LENZSPITZE, nuit du 26 au 27.10.
|
||||
- **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas.
|
||||
- **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale.
|
||||
- **Prochaine étape** :
|
||||
- journal du matin : les points ouverts du plan vivant, sur les consignes de l'utilisateur ; un point validé n'est plus repris ;
|
||||
- les écarts du handoff, dont « consistent with » face aux phrases catégoriques du journal, quand l'utilisateur les arbitre ;
|
||||
- Cellular, Storage, Temperature : les réponses du spécialiste (`docs/<domaine>/domaine/questions-pour-l-expert.md`, pour Temperature la question 1 de `point-de-depart.md`), puis corrections et guides.
|
||||
|
||||
Code dans `src/energy/`, fiche dans `docs/energy/analyses/<règle en minuscules>.md`.
|
||||
## Analyses des domaines système
|
||||
|
||||
| Règle | Question | Statut | Code |
|
||||
|---|---|---|---|
|
||||
| `DAILY_BATTERY_STATE` | Chaque jour : pleine charge, charge partielle (incertain), sous le plateau ou aucune charge ? | livrée (prototype, D-020) | `battery_state.py` |
|
||||
| `DAILY_BATTERY_TREND` | Chaque jour, face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | livrée (prototype, D-020) | `battery_trend.py` |
|
||||
| `MOVING_AVERAGE_7_DAYS_DROP` | La tension moyenne sur 7 jours décroche-t-elle de son propre passé récent (> 0,2 V) ? | comparaison : ~2,7 jours d'avance sur la première coupure de VERMONT, mais bruitée (pire cas sain −0,16 V) | `moving_average.py` |
|
||||
| `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC de chaque jour | comparaison : peu bruitée (−0,04 V), mais 1 h d'avance seulement | `moving_average.py` |
|
||||
| `DAILY_POWER_SOURCE` | Chaque jour : sur secteur (moyenne des 3 jours avant J ≥ 14,0 V) ? Si oui, une heure de J < 13,4 V (perte du secteur) ? | livrée (prototype, D-043) ; vérifiée sur WEISSHORN, NORDEND et MISSISSIPPI (historique git) | `power_source.py` |
|
||||
Code dans `src/<domaine>/`, fiche vivante dans `docs/<domaine>/analyses/<règle en minuscules>.md`.
|
||||
|
||||
- **Couleur du jour** : `src/energy/day_color.py` (`MATRIX`, `focus()` pour J−1 / J), transcription de `docs/energy/matrice-etat-tendance.drawio`.
|
||||
- **Travailler sur une analyse** : `.claude/rules/analyses.md` (contrat `run(series)`, calcul causal, constantes sourcées, graphiques, fiche à jour) se charge seul dès qu'on touche `src/` ou `docs/*/analyses/`.
|
||||
- **Créer une analyse** : skill `nouvelle-analyse`.
|
||||
- **Créer un domaine (une nouvelle notification)** : skill `nouveau-domaine` (D-030).
|
||||
| Domaine | Règle | Question | Statut | Code |
|
||||
|---|---|---|---|---|
|
||||
| energy | `DAILY_BATTERY_STATE` | Chaque jour : pleine charge, charge partielle (incertain), sous le plateau ou aucune charge ? | livrée (D-020) | `battery_state.py` |
|
||||
| energy | `DAILY_BATTERY_TREND` | Face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | livrée (D-020) | `battery_trend.py` |
|
||||
| energy | `DAILY_POWER_SOURCE` | Sur secteur (moyenne des 3 jours avant ≥ 14,0 V) ? Si oui, une heure < 13,4 V (perte du secteur) ? | livrée (D-043) | `power_source.py` |
|
||||
| energy | `MOVING_AVERAGE_7_DAYS_DROP` | La moyenne sur 7 jours décroche-t-elle de son passé récent (> 0,2 V) ? | comparaison : ~2,7 jours d'avance sur VERMONT, bruitée | `moving_average.py` |
|
||||
| energy | `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP` | Même question, sur la seule mesure de 00:00 UTC | comparaison : peu bruitée, 1 h d'avance | `moving_average.py` |
|
||||
| storage | `DAILY_STORAGE_STATE` | Espace libre de `/data` : `OK`, `LOW` ou `CRITICAL` (planchers arbitraires 20 % / 10 %) ? | prototype (D-034) | `storage_state.py` |
|
||||
| storage | `DAYS_UNTIL_STORAGE_FULL` | Dans combien de jours le disque sera-t-il plein, au rythme médian de 7 jours ? | prototype (D-034) | `days_until_full.py` |
|
||||
| cellular | `DAILY_LINK_STATE` | Envois arrivés avec `link = up`, lien `down`, ou envois manquants ? | prototype (D-031) ; deux corrections retenues, non codées | `link_state.py` |
|
||||
| cellular | `DAILY_SIGNAL_STATE` | Médianes du RSRP et du RSRQ sur la grille publiée | prototype (D-031) | `signal_state.py` |
|
||||
| temperature | `DAILY_GPU_TEMPERATURE_LIMIT` | Une moyenne horaire du GPU a-t-elle atteint 97,5 °C dans les 24 dernières heures ? | prototype (D-040) | `gpu_temperature_limit.py` |
|
||||
|
||||
## Analyses (domaine Cellular)
|
||||
|
||||
Code dans `src/cellular/`, fiche dans `docs/cellular/analyses/<règle en minuscules>.md`, page de comparaison `src/cellular/all_analyses.py` (WEISSHORN et NORDEND, D-032).
|
||||
|
||||
| Règle | Question | Statut | Code |
|
||||
|---|---|---|---|
|
||||
| `DAILY_LINK_STATE` | Chaque jour : tous les envois arrivés avec `link = up`, un lien signalé `down`, ou des envois ou messages manquants ? | prototype (D-031) | `link_state.py` |
|
||||
| `DAILY_SIGNAL_STATE` | Chaque jour : médianes du RSRP et du RSRQ sur la grille publiée (excellent, bon, moyen, limite de cellule) | prototype (D-031) | `signal_state.py` |
|
||||
|
||||
- **Couleur du jour** : `src/cellular/day_color.py` (`MATRIX[lien][signal]`, `HEADLINE`), transcription de `docs/cellular/matrice-lien-signal.drawio` (D-037).
|
||||
- **Livré (D-039)** : figure du site `src/cellular/final.py` (panneaux partagés avec la page de comparaison), guide `docs/cellular/guide/diagnostic-cellulaire.md`.
|
||||
|
||||
## Analyses (domaine Storage)
|
||||
|
||||
Code dans `src/storage/`, fiche dans `docs/storage/analyses/<règle en minuscules>.md`, page de comparaison `src/storage/all_analyses.py` (WEISSHORN, D-034).
|
||||
|
||||
| Règle | Question | Statut | Code |
|
||||
|---|---|---|---|
|
||||
| `DAILY_STORAGE_STATE` | Chaque jour : espace libre de `/data` en % de l'utilisable, `OK`, `LOW` ou `CRITICAL` (planchers arbitraires 20 % / 10 %) ? | prototype (D-034) | `storage_state.py` |
|
||||
| `DAYS_UNTIL_STORAGE_FULL` | Chaque jour : dans combien de jours le disque sera-t-il plein, au rythme médian des 7 derniers jours ? | prototype (D-034) | `days_until_full.py` |
|
||||
|
||||
- **Couleur du jour** : `src/storage/day_color.py` (`MATRIX[état][horizon]`, `HEADLINE`), transcription de `docs/storage/matrice-etat-horizon.drawio` (D-035).
|
||||
- **Livré (D-039)** : figure du site `src/storage/final.py` (panneaux partagés avec la page de comparaison), guide `docs/storage/guide/diagnostic-stockage.md`.
|
||||
|
||||
## Analyses (domaine Temperature)
|
||||
|
||||
Code dans `src/temperature/`, fiche dans `docs/temperature/analyses/<règle en minuscules>.md`, page de comparaison `src/temperature/all_analyses.py` (WEISSHORN et NORDEND, D-040).
|
||||
|
||||
| Règle | Question | Statut | Code |
|
||||
|---|---|---|---|
|
||||
| `DAILY_GPU_TEMPERATURE_LIMIT` | Chaque jour : une moyenne horaire du GPU a-t-elle atteint 97,5 °C (limite du constructeur) dans les 24 dernières heures ? | prototype (D-040) | `gpu_temperature_limit.py` |
|
||||
|
||||
- **Couleur du jour** : `src/temperature/day_color.py` (`COLOR`, `HEADLINE`) : Red si la limite est atteinte, Green sinon, sans matrice (D-040).
|
||||
- **Livré (D-041)** : figure du site `src/temperature/final.py` (panneau partagé avec la page de comparaison), guide `docs/temperature/guide/diagnostic-temperature.md`.
|
||||
- **Couleur du jour** : `src/<domaine>/day_color.py`, transcription de la matrice tenue par l'utilisateur, `docs/<domaine>/matrice-*.drawio` : Energy état × tendance (sur secteur, la perte du secteur décide à sa place), Storage état × horizon, Cellular lien × signal ; Temperature sans matrice (Red si la limite est atteinte, sinon Green).
|
||||
- **Par domaine** : calcul embarquable (bibliothèque standard ; Energy sans import de `common/`) ; scripts plotly du poste de dev, `final.py` (figure du site, D-021) et `all_analyses.py` (page de comparaison, D-016).
|
||||
- **Travailler sur une analyse** : `.claude/rules/analyses.md` se charge seule dès qu'on touche `src/` ou `docs/*/analyses/`. Créer une analyse : skill `nouvelle-analyse` ; un domaine, donc une notification : skill `nouveau-domaine` (D-030).
|
||||
|
||||
## Commandes
|
||||
|
||||
```bash
|
||||
python3 src/energy/final.py [données] # livré : out/<STATION>_daily.html + .json (figure du site, D-021)
|
||||
python3 src/energy/all_analyses.py [données] # les 5 analyses comparées (D-016) : out/<STATION>_energy.html
|
||||
python3 src/energy/focus_jour.py JJ.MM[.AAAA] [données] # un jour et sa veille (D-024) : faits + out/<STATION>_focus_<AAAA-MM-JJ>.html + .json
|
||||
python3 src/cellular/final.py [données] # livré : out/<STATION>_cellular_daily.html + .json (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/cellular/all_analyses.py [données] # analyses 4G comparées : out/<STATION>_cellular.html (même défaut)
|
||||
python3 src/storage/final.py [données] # livré : out/<STATION>_storage_daily.html + .json (défaut data/WEISSHORN/)
|
||||
python3 src/storage/all_analyses.py [données] # analyses disque comparées : out/<STATION>_storage.html (même défaut)
|
||||
python3 src/temperature/final.py [données] # livré : out/<STATION>_temperature_daily.html + .json (défaut data/WEISSHORN/ et data/NORDEND/)
|
||||
python3 src/temperature/all_analyses.py [données] # limite du GPU : out/<STATION>_temperature.html (même défaut)
|
||||
python3 maquettes/user/summary.py [début] [fin] # maquette client : out/maquette_user_<STATION>.html, une page par station de data/
|
||||
python3 maquettes/support/home.py [début] [fin] # maquette support : out/maquette_support_home.html
|
||||
python3 vues-deplacements/maquette/explore.py [dossier] # maquette Explore, onglets View, Diagnosis (D-054), Displacements (D-055) et Journal (D-056, un détecteur seul : `python3 vues-deplacements/detectors/<détecteur>.py <dossier>`) : out/vues_deplacements_<STATION>.html (défaut : cas NORDEND, `vues_deplacements_2026-10_NORDEND.html`)
|
||||
python3 src/<domaine>/final.py [données] # livré : figure du site, out/<STATION>_…daily.html + .json
|
||||
python3 src/<domaine>/all_analyses.py [données] # analyses du domaine comparées : out/<STATION>_<domaine>.html
|
||||
python3 src/energy/focus_jour.py JJ.MM[.AAAA] [données] # un jour et sa veille (D-024)
|
||||
python3 maquettes/user/summary.py [début] [fin] # maquette client, une page par station de data/
|
||||
python3 maquettes/support/home.py [début] [fin] # maquette support
|
||||
python3 vues-deplacements/maquette/explore.py [dossier] # page Explore : View, Diagnosis, Displacements, Journal
|
||||
python3 vues-deplacements/detectors/categories.py <dossier> # événements du journal, une ligne chacun
|
||||
python3 .claude/skills/boucle/detecteurs.py data/<STATION> [--du D --au F] # page des détecteurs seuls
|
||||
python3 .claude/skills/boucle/benchmark.py # détecteurs face à la base de cas
|
||||
pdftotext -layout "docs/aimsight/<fichier>.pdf" - # lire un PDF AIMsight
|
||||
python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .venv
|
||||
```
|
||||
|
||||
- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène aux maquettes client : les lancer avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
|
||||
- Chaque script bascule seul sur `.venv` si plotly manque, puis ouvre sa page (navigateur Windows via `explorer.exe` sous WSL).
|
||||
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur le jeu de travail du domaine.
|
||||
- `[données]` : CSV ou dossiers ; défauts : `data/VERMONT/` (Energy), `data/WEISSHORN/` (Storage), `data/WEISSHORN/` et `data/NORDEND/` (Cellular, Temperature). Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; lancer les deux maquettes avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
|
||||
- Chaque script bascule seul sur `.venv` si plotly manque, puis ouvre sa page (navigateur Windows via `explorer.exe` sous WSL ; dans le dev container, la page reste dans `out/`).
|
||||
- Pompage, `/aiguiser`, `/boucle`, `/revue-cas` : `run.md`.
|
||||
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur le jeu de travail du domaine ; pour les détecteurs, le benchmark et la page des détecteurs.
|
||||
|
||||
## Carte du dépôt
|
||||
|
||||
### Lire sans saturer le contexte
|
||||
|
||||
- Fichier long (tailles en lignes ci-dessous) : lire son plan (`grep -n '^#' <fichier>`), puis la seule section utile (Read avec `offset` et `limit`).
|
||||
- `docs/decisions.md` : l'index est `grep -n '^## D-' docs/decisions.md` ; lire ensuite l'entrée citée seulement. Son **Statut** dit si elle est remplacée.
|
||||
- CSV de `data/` : les explorer par script (`common.stations.load_stations`), jamais en les affichant.
|
||||
- Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant `plans/2026-10-23-journal-du-matin.md`), `out/` (sorties générées), `.venv/`.
|
||||
- `docs/decisions.md` (850 l, D-001 à D-083) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
|
||||
- `data/` : explorer par script (`common.stations.load_stations`, outils de `agent-tools/`), jamais en affichant les CSV.
|
||||
- Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant et la spec du support), `out/`, `.venv/`, `graphify-out/`.
|
||||
|
||||
### Fichiers
|
||||
### Racine
|
||||
|
||||
- `Handoff.md` (~150 l) : cadrage du product owner (reçu le 2026-10-25) : sous-projet G, santé des sites et notifications au client (domaines de mesure, étiquette de responsabilité, « consistent with », traductions, sécurité de production). À lire avant de concevoir côté client ou notifications, **par section** ; sa dernière section liste les écarts constatés avec ce dépôt, à arbitrer par l'utilisateur.
|
||||
- `README.md` (40 l) : point d'entrée pour un humain. `run.md` : les commandes génériques, pompage (dans le dev container de l'appli), `/aiguiser` et `/boucle`.
|
||||
- `docs/decisions.md` (790 l, D-001 à D-073) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
||||
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||
- `colonnes-des-deplacements.md` : colonnes des déplacements, d'après la FAQ et dans les exports reçus (« advanced » 15 min, horaire) ; `images-de-la-camera.md` : images IRON (la scène) et DIFF (les réflecteurs, l'image mesurée).
|
||||
- `docs/energy/` : le domaine Energy.
|
||||
- `analyses/<règle>.md` (80-120 l) : fiche vivante de chaque analyse (principe, constantes et sources, résultats, limites, options écartées, pistes, historique). Modèle : `.claude/skills/nouvelle-analyse/modele-fiche.md`.
|
||||
- `domaine/` (< 80 l) : `comment-se-comporte-la-batterie.md` (LiFePO4, plateau et coude, table OCV, redémarrage à 12,6 V, capacité) ; `tensions-selon-l-etat-de-la-batterie.md` (tensions et pentes en charge, pleine charge et décharge) ; `cas-annotes-par-l-expert.md` (diagnostics experts des 5 stations, vérité de référence).
|
||||
- `guide/diagnostic-energetique.md` (180 l, brouillon) : manuel, partie 1 pour le client (§1-4), partie 2 pour le support (§5-9). À tenir à jour avec la matrice et les fiches des deux analyses livrées.
|
||||
- `matrice-etat-tendance.drawio` : matrice état × tendance, tenue par l'utilisateur.
|
||||
- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, Cellular sa matrice lien × signal, `matrice-lien-signal.drawio`, tenues par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/`, ses questions ouvertes dans `domaine/questions-pour-l-expert.md` et son guide (~90 l, client puis support) dans `guide/`, dont la partie 1 est affichée dans la vue client.
|
||||
- `docs/temperature/` : domaine Temperature (D-040), sans matrice ; guide dans `guide/` (D-041). `domaine/point-de-depart.md` : zones thermiques, carte supposée (Jetson Nano) et ses limites, constats sur trois stations, pistes, questions au spécialiste ; fiche dans `analyses/`.
|
||||
- `docs/agents/rapport-exploratoire.md` (290 l) : cadre d'agents LLM (D-027) : choix retenus, architecture, démarrage par étapes (§6) ; annexe A : pistes à revoir étape par étape. Le code d'agent vit à part, dans `agents/`.
|
||||
- `docs/agents/enquete-a-la-demande.md` (233 l) : enquête à la demande sur un événement de mesure (D-042), même cadre ; harnais (§3), déroulé (§4), sortie et règle d'asymétrie (§5), étapes (§6), questions ouvertes (§9).
|
||||
- `docs/agents/agent-diagnostic.md` : spec de l'agent de diagnostic (D-046 à D-048), base de cas au §11 ; code dans `agents/diagnostic/` (`instructions.md`, `outils/`, `rapports/`, un dossier par rapport avec ses figures, `cas/`, la base de cas). Appel : `@agent-diagnostic data/<STATION>/ [question]`, (en terminal, `claude --agent diagnostic` charge `CLAUDE.md` : pas à l'aveugle).
|
||||
- `docs/displacement/cadrage.md` (156 l) : séries optiques (D-044) : événements externes et correction des courbes ; règles de correction (§3), chaîne en trois étapes (§4), données nécessaires (§5), étapes (§6), questions ouvertes (§7). `docs/displacement/domaine/ce-que-regarde-le-client.md` : sauts et tendances, pas les erreurs (D-055) ; `docs/displacement/domaine/cas-annotes-par-l-expert.md` : les deux rapports d'analyse résumés, vérité de référence sans données ; `incident-de-barcelone.md` : le cas de régression de la doc AIMsight, ses données (C-004) et l'avis de l'expert.
|
||||
- `docs/aimsight/` : documentation AIMsight d'origine, non modifiée, en anglais sauf les rapports d'analyse. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure.
|
||||
- `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
|
||||
- `AIMsight_agentic_support_project_context.md` (2 090 l) : extension support : chaîne de dépendance (§4), domaines dont la santé système (§5.1, le cas d'usage actuel), règles épistémiques (§10), familles d'hypothèses (§12), format de sortie (§14-15), cas de régression (§16-17), cas d'usage (§23).
|
||||
- Les deux docs prévoient un LLM/agent pour la synthèse : la couche déterministe reste 100 % analytique ; la couche d'agents côté serveur (D-027) reprend cette idée, en exploration.
|
||||
- `AIMsight FAQ.pdf`, `AIMsight Test Manual.pdf` (en réalité le manuel de la station) : définitions des signaux et des colonnes CSV, alimentation, schedules. `Mur de soutènement GN-1.472.pdf`, `GN-5.054.pdf` : rapports d'analyse remis au client (mai 2026, en français).
|
||||
- `collecteur_system_info.py` : copie de référence du collecteur `system_info` embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω). Source des unités. Ne pas modifier.
|
||||
- `docs/ameliorations-faq.md` : carnet d'idées pour la prochaine révision de la FAQ, une entrée par idée sous la rubrique de la FAQ qu'elle concerne ; la réécriture viendra ensuite. `docs/ameliorations-processus.md` : carnet des difficultés des processus automatiques, tenu par le `releveur` (D-060).
|
||||
- `docs/superpowers/` : specs et plans superpowers (170-850 l chacun). Historique non maintenu, pas une référence. La spec d'une nouvelle analyse s'écrit dans sa fiche ; le plan peut aller dans `docs/superpowers/plans/`.
|
||||
- `data/` : un dossier par station, au numéro de série du système (D-029), rempli par le pompage (`run.md`), **hors de git** (D-065) : `metrics/` (métriques système, un CSV par métrique et par jour), `displacement/` (« advanced », un CSV par jour), `camera/`, `images/`. Les exports reçus à la main y ont été remplacés le 2026-10-26 par leurs plages repompées, élargies ; leurs copies codées restent dans les cas (`agents/diagnostic/cas/`).
|
||||
- `VERMONT/` : **jeu de travail = VERMONT seule** (D-009), le plus long historique (métriques dès le 22/02). Les analyses Energy tournent uniquement sur ce jeu (défaut des scripts).
|
||||
- `WEISSHORN/` : tous les champs de la caméra (mesures dès le 19/08) ; jeu de travail de `storage` (seul, D-034) et `cellular` (D-030) ; sur secteur, avec NORDEND, il sert à `DAILY_POWER_SOURCE` (D-043). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier.
|
||||
- `NORDEND/` : tous les champs d'une version plus ancienne du collecteur (sans `link`) ; deuxième jeu de travail de `cellular`, station à la liaison faible (D-032). Mêmes identifiants à ne pas recopier (`SIM_CCID`, `ip_*`).
|
||||
- PS des Coudres (Suisse, sous son numéro de série, ex-`PS_DES_COUDRES/`) : déplacements du 08/10 au 14/10, images de la caméra, vérité de référence (D-045), jeu de travail de `displacement`. De même `NORDEND/`, `WILDSTRUBEL/`, `CLARIDEN/` (images à 10 min) et `NIEDERHORN/` : données des cas C-002 à C-005.
|
||||
- Les notes brutes de l'expert (`metadata.md`, `d.md`) et `archive/` ont été retirées le 2026-10-13 (D-033) : leur résumé est dans `docs/energy/domaine/cas-annotes-par-l-expert.md`.
|
||||
- `src/` : un sous-dossier par domaine, plus le code commun (D-026).
|
||||
- `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (poste de dev : bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`).
|
||||
- `energy/` : calcul embarquable, en bibliothèque standard et sans import de `common/` : `battery_state.py`, `battery_trend.py`, `power_source.py`, `moving_average.py`, `day_color.py`. Scripts plotly du poste de dev, à laisser hors de la station : `final.py`, `all_analyses.py`, `focus_jour.py`.
|
||||
- `cellular/` : calcul embarquable `link_state.py`, `signal_state.py`, `day_color.py` (D-037) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-031).
|
||||
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034).
|
||||
- `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040).
|
||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039).
|
||||
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/support/` (réponse à un client, D-079), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/revue-cas/` avec l'agent `revue` (l'utilisateur valide, corrige ou rejette les cas appris par la boucle, D-075), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `skills/boucle/` et `skills/critiquer-lot/` avec les agents `analyste`, `upgrader`, `validateur`, `builder` (boucle automatique, D-057), `skills/lire-les-donnees/` (outils de lecture et leur mode d'emploi) et `skills/aiguiser/` avec les agents `lecteur`, `correcteur`, `optimiseur` (D-059), `agents/releveur.md` (difficultés des processus automatiques, D-060), `agents/ameliorateur.md` (les corrige en fin de `/boucle --ameliorer` ou `/aiguiser --ameliorer`, D-071, D-076), `settings.json` (lecture de `.env` interdite). Schémas de ces processus (agents, flux de données) : `docs/agents/pipelines-ia.drawio`, une page par processus.
|
||||
- `vues-deplacements/` : chantier à part des vues des déplacements et de l'agent dans une maquette (D-052) : contexte, cas réels (données, pages de la plateforme, parcours de l'utilisateur), puis le code ; sa carte : `vues-deplacements/CLAUDE.md` ; maquette de la page Explore avec les onglets View et Diagnosis dans `vues-deplacements/maquette/` (D-053, D-054) ; détecteurs du journal du matin dans `vues-deplacements/detectors/` (D-056) ; `extraction/` : pompage des données de la plateforme (D-056), à lancer par l'utilisateur dans le dev container de l'application (qui monte `~` : sortie directe dans `data/`) ; lecture seule ; mode d'emploi dans `extraction/README.md`.
|
||||
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `architecture.drawio` : schéma d'architecture tenu par l'utilisateur, à ne pas modifier sans demande. `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `data/` (D-065), `.venv/` et `__pycache__/` (D-014).
|
||||
- `README.md` : point d'entrée pour un humain. `run.md` (115 l) : les commandes que lance l'utilisateur (pompage, métriques de qualité par `~/optical_emulator`, `/aiguiser`, `/boucle`, `/revue-cas`). `push.sh "<message>"` : pull, commit de tout, push.
|
||||
|
||||
### `docs/`
|
||||
|
||||
- `decisions.md` : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `aimsight/` : documents reçus d'AIMsight, en anglais sauf les rapports d'analyse. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure.
|
||||
- `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **la référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
|
||||
- `AIMsight_agentic_support_project_context.md` (2 090 l) : extension support : chaîne de dépendance (§4), santé système (§5.1), règles épistémiques (§10), familles d'hypothèses (§12), format de sortie (§14-15), cas de régression (§16-17), cas d'usage (§23).
|
||||
- `AIMsight_handoff_G_site_health.md` (150 l) : cadrage du product owner (2026-10-25), tel quel : sous-projet G, domaines de mesure, étiquette de responsabilité, « consistent with », traductions, sécurité de production ; puis nos écarts. À lire avant de concevoir côté client ou notifications.
|
||||
- `AIMsight FAQ.pdf`, `AIMsight Test Manual.pdf` (en réalité le manuel de la station) : signaux, colonnes CSV, alimentation, schedules. `Mur de soutènement GN-1.472.pdf`, `GN-5.054.pdf` : rapports d'analyse remis au client (mai 2026, en français).
|
||||
- `collecteur_system_info.py` : copie de référence du collecteur embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω), source des unités. Ne pas modifier.
|
||||
- Ces documents prévoient un LLM pour la synthèse : la couche déterministe reste 100 % analytique ; la couche d'agents côté serveur (D-027) reprend l'idée, en exploration.
|
||||
- `domaine/` : savoir métier commun, une note courte par question : `ce-que-mesure-la-station.md` (format CSV, métriques, unités ; la consommation est mesurée, pas l'apport), `pieges-des-donnees.md`, `colonnes-des-deplacements.md`, `images-de-la-camera.md` (IRON, la scène ; DIFF, les réflecteurs).
|
||||
- `energy/`, `storage/`, `cellular/`, `temperature/` : un dossier par domaine système : `analyses/` (fiches, 70-120 l ; modèle `.claude/skills/nouvelle-analyse/modele-fiche.md`), `domaine/` (savoir métier, `point-de-depart.md`, `questions-pour-l-expert.md`), `guide/` (~90 l, client puis support ; la partie 1 est affichée dans la vue client), la matrice `.drawio`. Energy : `domaine/cas-annotes-par-l-expert.md` (diagnostics de 5 stations, vérité de référence), guide de 200 l en brouillon.
|
||||
- `displacement/` : `cadrage.md` (158 l, séries optiques, D-044) ; `domaine/` : `ce-que-regarde-le-client.md` (sauts et tendances, D-055), `cas-annotes-par-l-expert.md` (les deux rapports d'analyse, sans données), `incident-de-barcelone.md` (C-004 : mouvement réel selon l'expert, instabilité des références selon la doc), `cycle-thermique.md`.
|
||||
- `agents/` : `rapport-exploratoire.md` (292 l, agents LLM côté serveur, D-027), `enquete-a-la-demande.md` (233 l, D-042), `agent-diagnostic.md` (377 l, spec de l'agent), `pipelines-ia.drawio` (les processus automatiques, une page chacun).
|
||||
- `ameliorations-faq.md` : idées pour la prochaine FAQ. `ameliorations-processus.md` : difficultés des processus automatiques, tenu par le `releveur` (D-060).
|
||||
- `superpowers/` : specs et plans (110-1 300 l), historique non maintenu ; vivants : le plan `plans/2026-10-23-journal-du-matin.md` (1 290 l, index en tête) et `specs/2026-10-28-support-agent-design.md`. La spec d'une nouvelle analyse s'écrit dans sa fiche.
|
||||
|
||||
### Déplacements
|
||||
|
||||
- `vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `detectors/` (un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés par `categories.py`, D-067, D-068), `contexte/` (journal du matin, seuils, lissage, boucle, aiguisage), `cas/` (NORDEND, parcours de l'utilisateur), séances `boucle/` et `aiguiser/`, `benchmark/historique.csv` (D-069).
|
||||
- `events/` : **la base de cas, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre), un dossier `C-xxx/` par cas (`cas.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/boucle` en attendant `/revue-cas` ; `carte-des-evenements.md` (familles, catégories du journal) et `eventualites-et-categories.drawio`. Un cas n'y entre que par `/nouveau-cas`, lancé par l'utilisateur, ou par le builder de `/boucle`.
|
||||
- `agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees`, aiguisé par `/aiguiser`.
|
||||
- `agent-diagnostic/` : consignes (`instructions.md`, 146 l) et rapports de l'agent de diagnostic (D-082). Appel : `@agent-diagnostic data/<STATION>/ [question]`.
|
||||
- `support/` : un dossier par demande d'un client (D-079), `<date>_<STATION>_<sujet>/` : `demande.md`, `analyse.md`, `reponse.md` (le mail prêt à envoyer), GIF des images. Contient des mails et images de clients.
|
||||
- `extraction/` : pompage `pomper.py` des données de la plateforme (D-056), en lecture seule, lancé par l'utilisateur dans le dev container de l'application de référence `~/monitoring-dashboard` ; mode d'emploi `extraction/README.md`.
|
||||
|
||||
### Code, données, configuration
|
||||
|
||||
- `src/` : un sous-dossier par domaine système (D-026), plus `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`).
|
||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande : `user/summary.py` et `support/home.py`, chacun avec son gabarit, parcourent la liste de domaines `DOMAINS` (D-039).
|
||||
- `data/` : un dossier par station, au numéro de série du système (D-029), rempli par le pompage, **hors de git** (D-065) : `metrics/` (un CSV par métrique et par jour), `displacement/` (« advanced », un CSV par jour), `camera/`, `images/`, au besoin `images_diff/` et `quality/`. Les stations présentes : `ls data/`.
|
||||
- Jeux de travail : VERMONT pour Energy (D-009, le plus long historique) ; WEISSHORN pour Storage (D-034) ; WEISSHORN et NORDEND pour Cellular (D-030, D-032) et Temperature (D-040) ; à pomper s'ils manquent.
|
||||
- WEISSHORN et NORDEND contiennent des identifiants (`SIM_CCID`, `ip`, `ip_*`) : ne pas les recopier.
|
||||
- Les données des cas restent, codées, dans `events/`.
|
||||
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `upgrader`, `validateur`, `builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/revue-cas`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `critiquer-lot`, `aiguiser`, `lire-les-donnees`, `nouveau-cas`, `revue-cas`, `anonymiser-cas` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
|
||||
- `.devcontainer/` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `out/` : pages et JSON générés.
|
||||
- Tout est versionné (D-014), sauf `out/`, `data/`, `.venv/`, `__pycache__/`, `graphify-out/` et `.env`.
|
||||
|
||||
## Règles de travail
|
||||
|
||||
- Une décision projet prise en conversation donne une entrée dans `docs/decisions.md`.
|
||||
- Toute modification d'une analyse met à jour sa fiche dans le même changement.
|
||||
- Un savoir métier nouveau va dans `docs/domaine/` (commun) ou `docs/<domaine>/domaine/`.
|
||||
- Un processus automatique à plusieurs agents (aujourd'hui `/boucle`) fait remonter ses difficultés : chaque sous-agent finit son rendu par `## Difficultés`, l'orchestrateur appelle l'agent `releveur` en fin de processus, qui les note dans `docs/ameliorations-processus.md` (D-060). Pas dans une conversation ordinaire.
|
||||
- Un processus automatique à plusieurs agents (`/boucle`, `/aiguiser`) fait remonter ses difficultés : chaque sous-agent finit son rendu par `## Difficultés`, l'orchestrateur appelle le `releveur` en fin de processus, qui les note dans `docs/ameliorations-processus.md` (D-060). Pas dans une conversation ordinaire.
|
||||
- Un changement de cap met à jour « État et prochaine étape » ci-dessus : l'état courant, pas un historique.
|
||||
- Langue : échanges et documents projet en français ; documentation AIMsight en anglais (garder ses termes techniques) ; tout ce qui va au site en anglais, figure état × tendance comprise (D-023).
|
||||
- Langue : échanges et documents projet en français ; documentation AIMsight en anglais (garder ses termes techniques) ; tout ce qui va au site en anglais (D-023).
|
||||
|
||||
## Principes (raisons, statuts et options écartées : `docs/decisions.md`)
|
||||
|
||||
- **Point d'entrée du POC : scan proactif d'un export.** L'agent détecte les événements, les classe et explique chacun. Le mode « question de support » viendra ensuite, sur le même socle.
|
||||
- **Premier cas d'usage : santé énergétique des stations.** Ici, le trou de données *est* l'anomalie. L'interprétation des déplacements viendra ensuite.
|
||||
- **Pas de LLM dans la couche déterministe (agents LLM côté serveur en exploration, D-027), pas de données synthétiques** (ni CSV simulés, ni générateur de scénarios : refus explicite de l'utilisateur). Le code d'analyse est **embarquable** : bibliothèque standard, calcul léger.
|
||||
- **Point d'entrée : scan proactif d'un export** (D-001). L'agent détecte les événements, les classe et explique chacun ; le mode « question de support » s'appuie sur le même socle.
|
||||
- **Santé énergétique d'abord** (D-002) : ici, le trou de données *est* l'anomalie. Les déplacements ont suivi (D-044, D-056).
|
||||
- **Pas de LLM dans la couche déterministe, pas de données synthétiques** (ni CSV simulés, ni générateur de scénarios : refus explicite de l'utilisateur). Le code d'analyse est **embarquable** : bibliothèque standard, calcul léger.
|
||||
- **Anomalie énergétique = régime non soutenable** (l'apport ne couvre pas la consommation), pas une batterie basse. Une station débranchée avec une batterie pleine est déjà en anomalie.
|
||||
- **Analyses combinées** : chaque analyse est une preuve imparfaite, juste « dans la majorité des cas » ; la combinaison fait le diagnostic (pour Energy, la matrice état × tendance, D-020). Une analyse seule conclut au plus `consistent with`. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h).
|
||||
- **Livrables** : pour le site, une figure Plotly par station (état en haut, tendance dessous, D-021) et la couleur du jour ; pour comparer, une page HTML par station, un panneau par analyse puis un graphique par série (D-016). Zoom dans le temps seulement, ordonnée recalée sur la plage visible (D-013).
|
||||
- **Livrables** : pour le site, une figure Plotly par station et la couleur du jour (D-021) ; pour comparer, une page HTML par station, un panneau par analyse puis un graphique par série (D-016). Zoom dans le temps seulement, ordonnée recalée sur la plage visible (D-013).
|
||||
- **Destinataires du diagnostic** : le client final et l'ingénieur support, en couches (D-020).
|
||||
- **Ouvert** : architecture (à définir plus tard, ne pas la figer ici).
|
||||
- **Ouvert** : l'architecture, à ne pas figer ici.
|
||||
|
||||
## L'essentiel du domaine (détail : `docs/domaine/`)
|
||||
|
||||
- **Données** : un CSV par station et par métrique, `<STATION>_<Metric>_<début> to <fin>.csv`, colonnes `,time_utc,metric`, moyennes horaires en UTC. Une valeur vide signifie qu'il n'y a pas de mesure. **Toute heure est en UTC** (données, noms de fichiers, documents, échanges) ; une heure locale ne figure que pour décrire une source qui l'utilise.
|
||||
- **Données** : CSV horaires en UTC, colonnes `,time_utc,metric` ; une valeur vide signifie qu'il n'y a pas de mesure. **Toute heure est en UTC** (données, noms de fichiers, documents, échanges) ; une heure locale ne figure que pour décrire une source qui l'utilise.
|
||||
- **Unités** : `BusVoltage` [V], `BusCurrent` [mA], `Power` [mW], `ShuntVoltage` [mV]. Ces trois dernières sont une seule mesure : la **consommation**. **L'apport (panneau ou secteur) n'est pas mesuré.**
|
||||
- **Batterie LiFePO4 de 12,8 V** :
|
||||
- entre 30 et 90 % de charge, la tension de nuit reste plate ; elle ne chute qu'au coude (~12,8 V, puis ~12,5 V) ;
|
||||
@@ -188,7 +152,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
- Séparer fait observé, fait dérivé, contexte opérateur, hypothèse et inconnu. Pas de pseudo-probabilités ; vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`.
|
||||
- Pas de règle spécifique à un site : les cas résolus deviennent des cas de régression.
|
||||
- Lecture seule : aucune action sur les stations, la configuration ou le retraitement.
|
||||
- Pour les déplacements (cas d'usage suivant) :
|
||||
- Pour les déplacements :
|
||||
- ne rien construire sur `inlier` binaire : RANSAC sera remplacé par un estimateur pondéré. Utiliser poids continus, `N_eff`, résidus, influence ;
|
||||
- `sigma0` seul et le nombre de références ne sont jamais des critères suffisants ;
|
||||
- ne pas confondre qualité image d'une cible et qualité du réseau de références, ni petit résidu et transformation bien contrainte ;
|
||||
@@ -196,5 +160,5 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
|
||||
## Environnement
|
||||
|
||||
- `pandas` n'est pas installé ; la bibliothèque standard suffit pour explorer les CSV (`csv`, `datetime.fromisoformat`). `.venv/` (Python 3.14) ne contient que plotly et matplotlib (graphiques de l'agent de diagnostic), pour le poste de dev. Le code d'analyse reste en bibliothèque standard.
|
||||
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container » ; dans le conteneur, les pages restent dans `out/` sans s'ouvrir seules.
|
||||
- `pandas` n'est pas installé ; la bibliothèque standard suffit (`csv`, `datetime.fromisoformat`). `.venv/` (Python 3.14) ne contient que plotly et matplotlib (graphiques des agents), pour le poste de dev.
|
||||
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container ».
|
||||
@@ -1,38 +1,48 @@
|
||||
# Support-Agent — diagnostic proactif AIMsight
|
||||
|
||||
Agent de diagnostic **100 % analytique (sans LLM)** pour les stations AIMsight. Il analyse les séries temporelles d'une station, détecte les anomalies et les explique à partir de faits calculés, avant que le client ne pose la question. Premier cas d'usage : la **santé énergétique** des stations (batterie, alimentation, interruptions de mesure).
|
||||
Prototype de diagnostic pour les stations AIMsight, un système de surveillance optique de déplacements. Il analyse les données d'une station (santé du système, déplacements des cibles, images de la caméra), détecte les anomalies et les explique à partir de faits calculés, avant que le client ne pose la question. Le calcul est **100 % analytique** ; des agents Claude Code s'en servent pour lire les données, améliorer les détecteurs et répondre au support.
|
||||
|
||||
## Lancer l'analyse
|
||||
Prototype expérimental, sans tests automatisés : on vérifie en lançant les scripts et en regardant les pages.
|
||||
|
||||
## Ce qui existe
|
||||
|
||||
- **Santé du système**, quatre domaines en prototype : Energy (batterie, alimentation), Storage (espace disque), Cellular (liaison 4G), Temperature (GPU). Chacun donne une couleur par jour, une figure pour le site et un guide de lecture. Seul Energy est réglé sur des cas de l'expert ; les autres ont des seuils provisoires.
|
||||
- **Journal du matin des déplacements**, le chantier en cours : des détecteurs simples disent, en catégories, ce qui s'est passé sur les courbes (pluie, buée, passage devant une cible, turbulence… ou vrai mouvement), dans la maquette de la page Explore.
|
||||
- **Base de cas** (`events/`) : des incidents réels validés par l'expert, qui servent à régler et mesurer les détecteurs.
|
||||
- **Agents Claude Code**, lancés par l'utilisateur : `/support` répond au mail d'un client, `/boucle` améliore les détecteurs lot après lot, `/aiguiser` améliore les outils de lecture des données, `/revue-cas` fait valider les cas appris.
|
||||
- **Maquettes du site** : la vue client (une page par station) et l'accueil du support.
|
||||
|
||||
## Démarrer
|
||||
|
||||
```bash
|
||||
python3 src/energy/final.py
|
||||
python3 -m venv .venv && .venv/bin/pip install plotly matplotlib
|
||||
```
|
||||
|
||||
Le script analyse `data/VERMONT/` et ouvre dans le navigateur `out/VERMONT_daily.html`, l'état et la tendance de la batterie jour par jour : ce sont les analyses livrées, destinées au site de monitoring. La figure Plotly est aussi écrite dans `out/VERMONT_daily.json`.
|
||||
Les données ne sont pas dans le dépôt : `data/` se remplit par le pompage de la plateforme (voir `run.md`). Ensuite, par exemple :
|
||||
|
||||
Pour comparer les quatre analyses Energy sur une même page (`out/VERMONT_energy.html`) : `python3 src/energy/all_analyses.py`. Pour comprendre la couleur d'un jour, en ne regardant que ce jour et la veille : `python3 src/energy/focus_jour.py 27.09`. Pages des autres domaines, sur WEISSHORN par défaut : `python3 src/storage/all_analyses.py` (espace disque) et `python3 src/cellular/all_analyses.py` (signal 4G) ; sur WEISSHORN et NORDEND, `python3 src/temperature/all_analyses.py` (limite du GPU).
|
||||
```bash
|
||||
python3 src/energy/final.py data/<STATION>/
|
||||
```
|
||||
|
||||
La page de comparaison se lit ainsi :
|
||||
- **en haut**, l'analyse ;
|
||||
- **dessous**, une courbe par mesure de la station ;
|
||||
- **zoom** : dans le temps, au rectangle ou à la molette ; double-clic pour revenir à la vue complète.
|
||||
```bash
|
||||
python3 vues-deplacements/maquette/explore.py data/<STATION>/
|
||||
```
|
||||
|
||||
Plotly est installé dans `.venv/`, et le script y bascule seul. Pour recréer cet environnement : `python3 -m venv .venv && .venv/bin/pip install plotly`.
|
||||
Chaque script bascule seul sur `.venv` et ouvre sa page dans le navigateur ; les pages sont écrites dans `out/`. Les autres commandes sont dans `CLAUDE.md` (section « Commandes ») et `run.md` (pompage, `/boucle`, `/aiguiser`, `/revue-cas`).
|
||||
|
||||
## Où trouver quoi
|
||||
|
||||
| Besoin | Où |
|
||||
|---|---|
|
||||
| Vue d'ensemble, règles du projet, commandes | `CLAUDE.md` |
|
||||
| Carte complète du dépôt, état, règles, commandes | `CLAUDE.md` |
|
||||
| Commandes lancées par l'utilisateur (pompage, processus automatiques) | `run.md` |
|
||||
| Pourquoi le projet est comme il est (décisions, options écartées) | `docs/decisions.md` |
|
||||
| Lire le diagnostic énergétique (manuel client et support) | `docs/energy/guide/diagnostic-energetique.md` |
|
||||
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/<domaine>/analyses/<règle>.md` |
|
||||
| Savoir métier (mesures, batterie, pièges des données, cas experts) | `docs/domaine/` (commun), `docs/<domaine>/domaine/` (`energy`, `storage`, `cellular`, `temperature`, `displacement`) |
|
||||
| Cadrage du product owner (santé des sites, notifications au client) et écarts à arbitrer | `docs/aimsight/AIMsight_handoff_G_site_health.md` |
|
||||
| Documentation AIMsight d'origine | `docs/aimsight/` |
|
||||
| Données de travail (VERMONT pour Energy, WEISSHORN pour Storage, WEISSHORN et NORDEND pour Cellular et Temperature) | `data/<STATION>/` |
|
||||
| Maquettes du site, côté client (`user/`) et support (`support/`) ; ex. `python3 maquettes/user/summary.py`, `python3 maquettes/support/home.py` | `maquettes/` |
|
||||
| Vues des déplacements : maquette de la page Explore, onglets View (images), Diagnosis (données, demande à l'agent) et Displacements (sauts et tendances détectés) ; `python3 vues-deplacements/maquette/explore.py` ; cas réels et parcours de l'expert | `vues-deplacements/` (carte : `vues-deplacements/CLAUDE.md`) |
|
||||
|
||||
## État
|
||||
|
||||
Prototype expérimental, sans tests automatisés. Quatre analyses Energy sont en place. Deux sont livrées : `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour, et `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. Les deux autres servent à la comparaison : `MOVING_AVERAGE_7_DAYS_DROP` et sa variante sur la seule mesure de 00:00 UTC. Les suivantes sont listées dans les fiches `docs/energy/analyses/` (section « Pistes »). Trois autres domaines sont en prototype, sans cas annotés par l'expert. Storage (espace disque) : `DAILY_STORAGE_STATE`, `DAYS_UNTIL_STORAGE_FULL` et leur couleur du jour, avec des seuils arbitraires pour commencer (D-034, D-035) ; reste la livraison. Cellular (signal 4G) : `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE`, en pause en attendant le spécialiste. Temperature : `DAILY_GPU_TEMPERATURE_LIMIT` et sa couleur du jour, rouge si le GPU a atteint 97,5 °C, la limite du constructeur, dans les 24 dernières heures (D-040) ; restent la figure du site et le guide. Le skill `nouveau-domaine` décrit comment ajouter un domaine (D-030).
|
||||
| Savoir métier | `docs/domaine/` (commun), `docs/<domaine>/domaine/` |
|
||||
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/<domaine>/analyses/<règle>.md` |
|
||||
| Guides de lecture pour le client et le support | `docs/<domaine>/guide/` |
|
||||
| Journal du matin : plan de travail, point par point | `docs/superpowers/plans/2026-10-23-journal-du-matin.md` |
|
||||
| Déplacements : maquette Explore, détecteurs, contexte, séances | `vues-deplacements/` (carte : `vues-deplacements/CLAUDE.md`) |
|
||||
| Base de cas | `events/INDEX.md` |
|
||||
| Réponses aux clients | `support/` |
|
||||
@@ -16,15 +16,15 @@ Un dossier par diagnostic dans `rapports/` : `rapport.md` (verdict, une section
|
||||
## Contenu du dossier
|
||||
|
||||
- `instructions.md` : sa méthode, ses règles et le format du rapport. C'est ici qu'on corrige son comportement.
|
||||
- `outils/` : `inventaire.py`, `resume.py`, `graphique.py`, `vignettes.py` (recadrage des images autour des capteurs), et `donnees.py`, la lecture commune. Ils rendent des valeurs, pas des verdicts. Le graphique et les vignettes demandent matplotlib (`.venv`).
|
||||
- `agent-tools/` (racine du dépôt, D-081) : `inventaire.py`, `resume.py`, `graphique.py`, `vignettes.py` (recadrage des images autour des capteurs), et `donnees.py`, la lecture commune. Ils rendent des valeurs, pas des verdicts. Le graphique et les vignettes demandent matplotlib (`.venv`).
|
||||
- `rapports/` : ses rapports, un dossier chacun.
|
||||
- `cas/` : la base de cas validés par l'expert (D-048) : `INDEX.md`, une ligne par incident, et un dossier par incident (`cas.md`, ses figures et ses données). L'agent la lit après avoir établi ses faits. Spec : §11 de `docs/agents/agent-diagnostic.md`.
|
||||
- `events/` (racine du dépôt) : la base de cas validés par l'expert (D-048) : `INDEX.md`, une ligne par incident, et un dossier par incident (`cas.md`, ses figures et ses données). L'agent la lit après avoir établi ses faits. Spec : §11 de `docs/agents/agent-diagnostic.md`.
|
||||
|
||||
## Ajouter un cas
|
||||
|
||||
Avec le skill `/nouveau-cas` (`.claude/skills/nouveau-cas/SKILL.md`), que seul l'utilisateur lance : de nouvelles données et le diagnostic de l'expert donnent un cas, après un passage de l'agent à l'aveugle et un test de correspondance. Rien d'autre n'ajoute un cas.
|
||||
|
||||
**Rejouer un cas** : retirer sa ligne de `cas/INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer son rapport au Verdict et au Diagnostic de la fiche, restaurer la ligne (`git checkout agents/diagnostic/cas/INDEX.md`).
|
||||
**Rejouer un cas** : retirer sa ligne de `cas/INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer son rapport au Verdict et au Diagnostic de la fiche, restaurer la ligne (`git checkout events/INDEX.md`).
|
||||
|
||||
## Limites
|
||||
|
||||
@@ -19,11 +19,11 @@ Toute la connaissance du projet sur les déplacements, autant qu'il en faut pour
|
||||
- `docs/domaine/` : `colonnes-des-deplacements.md`, formats des exports et sens des colonnes (**lis-le en premier**), `pieges-des-donnees.md`, `ce-que-mesure-la-station.md` ;
|
||||
- `docs/displacement/` : `cadrage.md` et les notes de `domaine/`, dont `carte-des-evenements.md` : ce qui peut arriver, en familles, et le sens des catégories des détecteurs (section 4) ;
|
||||
- la documentation AIMsight de `docs/aimsight/`, par section ; d'abord, dans `AIMsight_agentic_support_project_context.md`, les sections 4 (chaîne de dépendance), 12 (familles d'hypothèses) et 13 (*support query workflow*), et dans `AIMsight_reference_quality_event_explainer_roadmap.md`, la section 4.3 (classifications) ; les PDF par `pdftotext`, par exemple pour `error` : `pdftotext -layout "docs/aimsight/AIMsight FAQ.pdf" - | grep -n -i -B2 -A12 'error value'` ;
|
||||
- la base de cas, `agents/diagnostic/cas/` : `INDEX.md`, les fiches `cas.md` et leurs figures. Ce sont des incidents validés par l'expert. Ouvre-la à l'étape 5 du déroulé (§4), après tes faits : sinon tu chercherais ce que dit un cas au lieu de ce que montrent les données.
|
||||
- la base de cas, `events/` : `INDEX.md`, les fiches `cas.md` et leurs figures. Ce sont des incidents validés par l'expert. Ouvre-la à l'étape 5 du déroulé (§4), après tes faits : sinon tu chercherais ce que dit un cas au lieu de ce que montrent les données.
|
||||
|
||||
Pour un long fichier, trouve la section avec `grep -n '^#' <fichier>`, puis lis-la seule (Read avec `offset` et `limit`).
|
||||
|
||||
**Ne lis pas** ce qui rend déjà un avis sur des données sans être de la connaissance : les rapports de `agents/diagnostic/rapports/`, `vues-deplacements/` (parcours, séances de la boucle, code des détecteurs : tu lances `categories.py`, tu ne le lis pas), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
**Ne lis pas** ce qui rend déjà un avis sur des données sans être de la connaissance : les rapports de `agent-diagnostic/rapports/`, `vues-deplacements/` (parcours, séances de la boucle, code des détecteurs : tu lances `categories.py`, tu ne le lis pas), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
|
||||
|
||||
## 3. Tes outils
|
||||
@@ -58,7 +58,7 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|
||||
- déplacement associé (`corr_x`, `corr_y`) ou non ; mesures rejetées ;
|
||||
- images, s'il y en a : `vignettes.py` sur les capteurs touchés **et un capteur témoin non touché**, à une heure avant, pendant et après l'anomalie (à la même heure de la journée si possible) ; l'image entière pour la scène.
|
||||
5. **Cas connus**, après les faits, jamais avant : sinon tu chercherais ce que dit le cas au lieu de ce que montrent les données.
|
||||
- Lis `agents/diagnostic/cas/INDEX.md`. Pour chaque anomalie, et pour un cycle jour/nuit, choisis au plus 3 cas dont la signature est proche de tes faits et ouvre leurs fiches.
|
||||
- Lis `events/INDEX.md`. Pour chaque anomalie, et pour un cycle jour/nuit, choisis au plus 3 cas dont la signature est proche de tes faits et ouvre leurs fiches.
|
||||
- Vérifie la fiche sur **tes** données, avec tes outils : chaque critère de la signature : vérifié, contredit ou non vérifiable (donnée absente).
|
||||
- Conclus, par anomalie :
|
||||
|
||||
@@ -94,7 +94,7 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|
||||
|
||||
## 6. Le rapport
|
||||
|
||||
Un dossier par rapport : `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>/` (instant présent en UTC : `date -u +%Y-%m-%dT%H%MZ` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJTHHMMZ>_<STATION>_<sujet>/`. Le rapport s'y écrit dans `rapport.md`, à côté de ses figures (`--sortie` vers ce dossier) ; il les cite par leur nom de fichier. Ne liste pas `rapports/` : l'heure dans le nom suffit à éviter un doublon.
|
||||
Un dossier par rapport : `agent-diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>/` (instant présent en UTC : `date -u +%Y-%m-%dT%H%MZ` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJTHHMMZ>_<STATION>_<sujet>/`. Le rapport s'y écrit dans `rapport.md`, à côté de ses figures (`--sortie` vers ce dossier) ; il les cite par leur nom de fichier. Ne liste pas `rapports/` : l'heure dans le nom suffit à éviter un doublon.
|
||||
|
||||
```markdown
|
||||
# <STATION> : <scan | sujet de la question>
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -1,6 +1,6 @@
|
||||
"""Vue d'ensemble de tous les capteurs d'un export « advanced » : ce que font les capteurs ensemble.
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/ensemble.py data/PS_DES_COUDRES/
|
||||
Usage : .venv/bin/python agent-tools/ensemble.py data/PS_DES_COUDRES/
|
||||
[--colonnes x,y,sigma0] [--colonne error_value] [--pas 15min] [--k 5] [--min 5]
|
||||
[--residus corr_x,corr_y,error_value] [--hors T1/T2] [--autres] [--rigide BASE [--sans A,B]] [--capteurs A,B] [--debut ...] [--fin ...] [--sortie DOSSIER]
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
"""GIF des images de la caméra sur une plage, pour joindre à une réponse au client (skill /support).
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/gif.py data/LENZSPITZE/
|
||||
Usage : .venv/bin/python agent-tools/gif.py data/LENZSPITZE/
|
||||
--debut 2026-10-26T18:00Z --fin 2026-10-27T08:00Z [--largeur 720] [--duree 700] [--max 150] [--sortie DOSSIER]
|
||||
Prend les images du dossier dont l'heure (nom du fichier, UTC) est entre --debut et --fin inclus, dans l'ordre, les
|
||||
réduit à --largeur px, écrit la date et l'heure UTC en bas à droite de chacune et les ramène à 64 teintes sans tramage
|
||||
@@ -15,7 +15,7 @@ from PIL import Image, ImageDraw, ImageFont
|
||||
|
||||
from donnees import heure_image, instant, iso, trouver
|
||||
|
||||
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", ".."))
|
||||
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".."))
|
||||
|
||||
|
||||
def main():
|
||||
@@ -1,6 +1,6 @@
|
||||
"""Graphique PNG des séries d'un export « advanced », pour que l'agent de diagnostic les regarde.
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/
|
||||
Usage : .venv/bin/python agent-tools/graphique.py data/PS_DES_COUDRES/
|
||||
[--capteurs CAPTEUR_A,CAPTEUR_B] [--colonnes error_value,corr_x,corr_y] [--debut ...] [--fin ...]
|
||||
[--zone DEBUT/FIN ...] [--sortie DOSSIER]
|
||||
Un panneau par colonne, une courbe par capteur, heures UTC ; chaque --zone est grisée.
|
||||
@@ -18,7 +18,7 @@ import matplotlib.pyplot as plt # noqa: E402
|
||||
|
||||
from donnees import charger, est_reference, filtrer, instant # noqa: E402
|
||||
|
||||
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", ".."))
|
||||
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".."))
|
||||
COLONNES = ("error_value", "corr_x", "corr_y", "relative_x", "relative_y", "x", "y", "sigma0", "reproj_err")
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
"""Inventaire d'un dossier de station : ce qui est disponible, ce qui manque.
|
||||
|
||||
Usage : python3 agents/diagnostic/outils/inventaire.py data/PS_DES_COUDRES/ [--debut T] [--fin T] [--fichiers]
|
||||
Usage : python3 agent-tools/inventaire.py data/PS_DES_COUDRES/ [--debut T] [--fin T] [--fichiers]
|
||||
Les comptes portent sur toute la période. Avec --debut et/ou --fin, une section de plus liste, sur cette fenêtre,
|
||||
les pas absents (datés, avec les capteurs qui n'ont pas de mesure) et, par capteur, les mesures rejetées (datées,
|
||||
en suites de pas consécutifs ; rejetée : error_value au-dessus du seuil, références comprises), puis le nombre de
|
||||
@@ -1,6 +1,6 @@
|
||||
"""Ce qui revient d'un jour à l'autre : niveau de chaque nuit, et jours superposés par heure du jour, pour l'agent de diagnostic.
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/jours.py data/PS_DES_COUDRES/ [--colonnes corr_x,corr_y,error_value]
|
||||
Usage : .venv/bin/python agent-tools/jours.py data/PS_DES_COUDRES/ [--colonnes corr_x,corr_y,error_value]
|
||||
[--nuit 20-3] [--k 5] [--jours 2] [--pas 15min] [--capteurs A,B] [--debut ...] [--fin ...] [--sortie DOSSIER]
|
||||
|
||||
Mesures acceptées seulement : une mesure rejetée (error_value au-dessus du seuil) n'entre nulle part. Une « nuit » :
|
||||
@@ -1,6 +1,6 @@
|
||||
"""Plages datées par capteur et par colonne, au pas natif des mesures, pour l'agent de diagnostic.
|
||||
|
||||
Usage : python3 agents/diagnostic/outils/plages.py data/PS_DES_COUDRES/ [--colonnes error_value,corr_x,corr_y]
|
||||
Usage : python3 agent-tools/plages.py data/PS_DES_COUDRES/ [--colonnes error_value,corr_x,corr_y]
|
||||
[--k 5] [--fusion 1h] [--min-mesures 1] [--hors T1/T2] [--capteurs A,B] [--debut ...] [--fin ...]
|
||||
|
||||
Pour chaque colonne, chaque capteur est comparé à son propre niveau sur la fenêtre --debut/--fin (médiane des
|
||||
@@ -1,6 +1,6 @@
|
||||
"""Résumé chiffré compact des séries d'un export « advanced », pour l'agent de diagnostic.
|
||||
|
||||
Usage : python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ [--colonne error_value]
|
||||
Usage : python3 agent-tools/resume.py data/PS_DES_COUDRES/ [--colonne error_value]
|
||||
[--stat median|min|max] [--pas 1h] [--niveau periode|fenetre] [--capteurs CAPTEUR_A,CAPTEUR_B] [--debut 2026-01-01T00:00Z] [--fin ...]
|
||||
|
||||
1. Niveau habituel de chaque capteur : médiane, MAD (écart absolu médian), min, max, sur toute la période
|
||||
@@ -1,6 +1,6 @@
|
||||
"""Vignettes des images de la caméra autour de capteurs, à pleine résolution, pour l'agent de diagnostic.
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/vignettes.py data/PS_DES_COUDRES/
|
||||
Usage : .venv/bin/python agent-tools/vignettes.py data/PS_DES_COUDRES/
|
||||
--capteurs REF_G,REF_D --heures 2026-10-13T22:00Z,2026-10-14T02:00Z [--rayon 100] [--contraste [MIN,MAX]] [--sortie DOSSIER]
|
||||
Une ligne par capteur, une colonne par heure. Quand il n'y a pas d'image à l'heure demandée, la plus proche est
|
||||
prise : l'écart est imprimé et l'heure réelle de l'image est dans le titre de la vignette. Chaque vignette est centrée sur la position brute (x, y) du capteur
|
||||
@@ -35,7 +35,7 @@ def centile(gris, p):
|
||||
return v[min(int(p / 100 * len(v)), len(v) - 1)]
|
||||
|
||||
|
||||
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", ".."))
|
||||
RACINE = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".."))
|
||||
|
||||
|
||||
def main():
|
||||
@@ -1,52 +0,0 @@
|
||||
<mxfile host="Electron">
|
||||
<diagram id="archi-poc-energie" name="Architecture POC énergie">
|
||||
<mxGraphModel dx="841" dy="596" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1820" pageHeight="820" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
<mxCell id="fam1" parent="1" style="swimlane;fontStyle=1;childLayout=stackLayout;horizontal=1;startSize=30;horizontalStack=0;resizeParent=1;resizeParentMax=0;resizeLast=0;collapsible=1;marginBottom=0;whiteSpace=wrap;html=1;" value="1. Séries énergie (station)" vertex="1">
|
||||
<mxGeometry height="126" width="220" x="40" y="620" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam1-1" parent="fam1" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ time_utc</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam1-2" parent="fam1" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ BusVoltage</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="54" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam1-3" parent="fam1" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ BusCurrent</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="78" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam1-5" parent="fam1" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ Power</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="102" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam2" parent="1" style="swimlane;fontStyle=1;childLayout=stackLayout;horizontal=1;startSize=30;horizontalStack=0;resizeParent=1;resizeParentMax=0;resizeLast=0;collapsible=1;marginBottom=0;whiteSpace=wrap;html=1;" value="2. Discrimination transport / stockage" vertex="1">
|
||||
<mxGeometry height="102" width="220" x="290" y="620" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam2-1" parent="fam2" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ last_sync</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam2-2" parent="fam2" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ DB_not_uploaded</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="54" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam2-15" parent="fam2" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ avail_disk_1k-blk</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="78" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam3" parent="1" style="swimlane;fontStyle=1;childLayout=stackLayout;horizontal=1;startSize=30;horizontalStack=0;resizeParent=1;resizeParentMax=0;resizeLast=0;collapsible=1;marginBottom=0;whiteSpace=wrap;html=1;" value="3. Métadonnées station" vertex="1">
|
||||
<mxGeometry height="54" width="220" x="540" y="620" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam3-1" parent="fam3" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ Type d'alimentation : solaire / secteur</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam4" parent="1" style="swimlane;fontStyle=1;childLayout=stackLayout;horizontal=1;startSize=30;horizontalStack=0;resizeParent=1;resizeParentMax=0;resizeLast=0;collapsible=1;marginBottom=0;whiteSpace=wrap;html=1;" value="4. Thermique (station)" vertex="1">
|
||||
<mxGeometry height="78" width="220" x="790" y="620" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam4-1" parent="fam4" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ sensor_CPU_deg_c</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="fam4-2" parent="fam4" style="text;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;spacingLeft=4;spacingRight=4;overflow=hidden;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;rotatable=0;whiteSpace=wrap;html=1;fontSize=11;" value="<font color="#33FF33">+ sensor_GPU_deg_c</font>" vertex="1">
|
||||
<mxGeometry height="24" width="220" y="54" as="geometry" />
|
||||
</mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
@@ -17,7 +17,7 @@
|
||||
| Mode d'appel | **Les deux** : une question facultative ; sans question, l'agent fait le scan de la période |
|
||||
| Sortie | **Un rapport écrit dans le dépôt** par diagnostic, et un résumé dans la conversation |
|
||||
| Données de la première version | **Les déplacements et les images** ; les métriques système plus tard |
|
||||
| Forme | **Un sous-agent Claude Code** avec son dossier `agents/diagnostic/` |
|
||||
| Forme | **Un sous-agent Claude Code** avec son dossier `agent-diagnostic/` |
|
||||
| Graphiques | **matplotlib**, ajouté à `.venv` et au dev container (poste de dev seulement) |
|
||||
|
||||
**Critère de réussite.** On lui donne `data/PS_DES_COUDRES/`, sans autre explication ; il rend un diagnostic court et traçable, dont la seule anomalie est la montée de l'erreur de `REF_G` et `REF_D` (cas de référence du spécialiste, §7), montrée par des figures.
|
||||
@@ -28,7 +28,7 @@
|
||||
|
||||
```
|
||||
.claude/agents/diagnostic.md point d'entrée pour Claude Code : nom, outils, modèle
|
||||
agents/diagnostic/
|
||||
agent-diagnostic/
|
||||
README.md doc humaine : à quoi il sert, comment l'appeler
|
||||
instructions.md sa méthode : règles, déroulé, format du rapport
|
||||
outils/ ses scripts Python ; leur mode d'emploi : .claude/skills/lire-les-donnees/ (D-059)
|
||||
@@ -38,7 +38,7 @@ agents/diagnostic/
|
||||
|
||||
- **Appel** : `@agent-diagnostic data/PS_DES_COUDRES/` suivi, au choix, d'une question ; ou en langage naturel (« lance l'agent diagnostic sur … ») ; ou une session entière dans un terminal : `claude --agent diagnostic`, mais elle charge `CLAUDE.md` (`omitClaudeMd` ne vaut que pour un sous-agent) : elle n'est pas à l'aveugle.
|
||||
- **Contexte isolé** : le sous-agent démarre sans la conversation qui l'appelle, donc sans ses hypothèses.
|
||||
- **Emplacement** : `agents/` est celui que prévoyait D-027. La méthode et les outils sont portables vers le futur harnais par API.
|
||||
- **Emplacement** : `agent-diagnostic/` (D-082), à la racine, comme le prévoyait D-027 pour `agents/`. La méthode et les outils sont portables vers le futur harnais par API.
|
||||
|
||||
## 3. Point d'entrée
|
||||
|
||||
@@ -49,12 +49,12 @@ agents/diagnostic/
|
||||
name: diagnostic
|
||||
description: Diagnostic des données d'une station AIMsight (déplacements optiques, images).
|
||||
À appeler avec un dossier de data/ et, si on veut, une question. Rend un rapport
|
||||
traçable dans agents/diagnostic/rapports/.
|
||||
traçable dans agent-diagnostic/rapports/.
|
||||
tools: Read, Bash, Write
|
||||
model: inherit
|
||||
omitClaudeMd: true
|
||||
---
|
||||
Tu es l'agent de diagnostic du projet. Commence par lire agents/diagnostic/instructions.md
|
||||
Tu es l'agent de diagnostic du projet. Commence par lire agent-diagnostic/instructions.md
|
||||
et suis-le à la lettre.
|
||||
```
|
||||
|
||||
@@ -70,7 +70,7 @@ et suis-le à la lettre.
|
||||
**Sources** (D-058 : plus à l'aveugle) :
|
||||
- les données du dossier (CSV, images) ;
|
||||
- la connaissance du projet sur les déplacements : `docs/domaine/`, `docs/displacement/` (cadrage, carte des événements…), les docs AIMsight par section ;
|
||||
- toute la base de cas, `agents/diagnostic/cas/` (§11), à l'étape 5, après les faits ;
|
||||
- toute la base de cas, `events/` (§11), à l'étape 5, après les faits ;
|
||||
- pas ce qui rend déjà un avis sur des données : les rapports de l'agent, `vues-deplacements/` (parcours, séances de la boucle, code des détecteurs), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`.
|
||||
|
||||
**Déroulé** (d'après le §13 du contexte support) :
|
||||
@@ -98,7 +98,7 @@ et suis-le à la lettre.
|
||||
|
||||
## 5. Le rapport
|
||||
|
||||
Un dossier par diagnostic, `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>[_<sujet>]/` (l'heure évite les doublons sans lister les rapports précédents, qui pourraient trahir une conclusion) : `rapport.md` et ses figures PNG, versionnées avec lui. Format (D-047), le corps en ~40 lignes :
|
||||
Un dossier par diagnostic, `agent-diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>[_<sujet>]/` (l'heure évite les doublons sans lister les rapports précédents, qui pourraient trahir une conclusion) : `rapport.md` et ses figures PNG, versionnées avec lui. Format (D-047), le corps en ~40 lignes :
|
||||
|
||||
1. **En-tête** d'une ligne : données (dossier, période), scan ou question, modèle, date.
|
||||
2. **Verdict** : 2-3 phrases ; la station fonctionne-t-elle normalement, et ses anomalies par importance, avec leur cas connu.
|
||||
@@ -113,7 +113,7 @@ Un dossier par diagnostic, `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATI
|
||||
5. **Annexe** : sources lues, données disponibles et manquantes, seuil de repérage.
|
||||
6. **Validation**, laissée vide pour l'utilisateur : accepté tel quel ou corrigé (en quoi), diagnostic final, devient un cas (oui, C-xxx, ou non) ; l'ajout se lance par `/nouveau-cas` (§11.6).
|
||||
|
||||
## 6. Outils (`agents/diagnostic/outils/`)
|
||||
## 6. Outils (`agent-tools/`)
|
||||
|
||||
Scripts en ligne de commande. Ils renvoient des valeurs, jamais des verdicts. Bibliothèque standard, sauf le graphique.
|
||||
|
||||
@@ -143,7 +143,7 @@ Scripts en ligne de commande. Ils renvoient des valeurs, jamais des verdicts. Bi
|
||||
|
||||
Un attendu manqué ou une conclusion au-delà des preuves se corrige dans `instructions.md`, puis on relance.
|
||||
|
||||
**Premier passage, le 2026-10-14 (format D-046).** Lancement retenu : l'outil Agent (sous-agent `diagnostic`, prompt réduit au dossier et à la question). Un premier essai en mode non interactif (`claude -p --agent diagnostic`) n'était pas à l'aveugle : en session principale, `omitClaudeMd` n'est pas appliqué et l'agent a reçu `CLAUDE.md` (« buée probable le matin ») ; la règle `Write(agents/diagnostic/rapports/**)` n'a pas non plus reconnu le chemin. Rapports : `2026-10-14_PS_DES_COUDRES.md` (scan) et `…_nuit-13-14-10.md` (question), supprimés au passage à D-047 ; ils restent dans l'historique git (commit `fcc01d2`).
|
||||
**Premier passage, le 2026-10-14 (format D-046).** Lancement retenu : l'outil Agent (sous-agent `diagnostic`, prompt réduit au dossier et à la question). Un premier essai en mode non interactif (`claude -p --agent diagnostic`) n'était pas à l'aveugle : en session principale, `omitClaudeMd` n'est pas appliqué et l'agent a reçu `CLAUDE.md` (« buée probable le matin ») ; la règle `Write(agent-diagnostic/rapports/**)` n'a pas non plus reconnu le chemin. Rapports : `2026-10-14_PS_DES_COUDRES.md` (scan) et `…_nuit-13-14-10.md` (question), supprimés au passage à D-047 ; ils restent dans l'historique git (commit `fcc01d2`).
|
||||
|
||||
| Attendu | Scan | Question |
|
||||
|---|---|---|
|
||||
@@ -170,7 +170,7 @@ Un attendu manqué ou une conclusion au-delà des preuves se corrige dans `instr
|
||||
4. aucune conclusion de mouvement de l'ouvrage ; un niveau de preuve mesuré pour la cause ;
|
||||
5. le corps du rapport en ~40 lignes.
|
||||
|
||||
Rapport : `agents/diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 appels d'outils, 227 s, ~83 k tokens.
|
||||
Rapport : `agent-diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 appels d'outils, 227 s, ~83 k tokens.
|
||||
|
||||
| Attendu | Résultat |
|
||||
|---|---|
|
||||
@@ -188,7 +188,7 @@ Rapport : `agents/diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 app
|
||||
- **D-046** dans `docs/decisions.md` : l'agent pilote, son lien avec D-027, D-042 et D-044, ses limites (§3).
|
||||
- **`CLAUDE.md`** : l'état, la carte du dépôt, la commande d'appel, `matplotlib` dans `.venv`. Rester sous 200 lignes en resserrant des lignes existantes.
|
||||
- **`.devcontainer/devcontainer.json`** : `matplotlib` à côté de `plotly`.
|
||||
- **`agents/diagnostic/README.md`** : court ; renvoie à ce document.
|
||||
- **`agent-diagnostic/README.md`** : court ; renvoie à ce document.
|
||||
|
||||
## 9. Laissé de côté pour l'instant
|
||||
|
||||
@@ -226,7 +226,7 @@ La plage sélectionnée par « Analyze » est le mode question actuel (§4) rest
|
||||
### 11.1 Structure
|
||||
|
||||
```
|
||||
agents/diagnostic/cas/
|
||||
events/
|
||||
INDEX.md la table : seule porte d'entrée de l'agent
|
||||
C-001/ un dossier par incident, à son numéro
|
||||
cas.md la fiche
|
||||
@@ -300,7 +300,7 @@ Critères observables, relatifs au niveau habituel du capteur, chacun avec sa co
|
||||
|
||||
Une étape de plus dans le déroulé (§4 de `instructions.md`), entre « Faits » et « Hypothèses », jamais avant : l'agent établit ses faits sans connaître les cas, pour ne pas plaquer le plus proche (ancrage).
|
||||
|
||||
**Cas connus.** L'agent lit `cas/INDEX.md` à ce moment seulement. Pour chaque anomalie, il choisit au plus 3 cas d'après la signature, ouvre leurs fiches, vérifie chaque critère avec ses outils sur ses propres données, puis conclut :
|
||||
**Cas connus.** L'agent lit `events/INDEX.md` à ce moment seulement. Pour chaque anomalie, il choisit au plus 3 cas d'après la signature, ouvre leurs fiches, vérifie chaque critère avec ses outils sur ses propres données, puis conclut :
|
||||
|
||||
| Correspondance | Quand | Ce que l'agent rend |
|
||||
|---|---|---|
|
||||
@@ -310,7 +310,7 @@ Une étape de plus dans le déroulé (§4 de `instructions.md`), entre « Faits
|
||||
|
||||
**Règle d'asymétrie** (D-042) : « aucune conséquence pour l'ouvrage » seulement si les trois tiennent : correspondance complète avec un cas validé, niveau de preuve au moins `strongly supported`, mouvement réel de l'ouvrage écarté par la réfutation. Deux cas qui correspondent : la complète avant la partielle, et la conséquence la plus prudente si elles diffèrent. Une fausse assurance coûte plus qu'une fausse alerte.
|
||||
|
||||
Sources (§2 de `instructions.md`) : toute la base, `cas/INDEX.md`, les fiches et leurs figures, à cette étape (D-058).
|
||||
Sources (§2 de `instructions.md`) : toute la base, `events/INDEX.md`, les fiches et leurs figures, à cette étape (D-058).
|
||||
|
||||
### 11.5 Le rapport
|
||||
|
||||
@@ -347,7 +347,7 @@ Un cas ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index
|
||||
|
||||
Le test de correspondance n'a pas été relancé sur la fiche revue, par choix de l'utilisateur : le dernier passage (2026-10-14) portait sur l'ancien format, avec exclusions.
|
||||
|
||||
**Mise en place, le 2026-10-14 (index vide).** Scan à l'aveugle de `data/PS_DES_COUDRES/` sur un arbre propre (branche `base-de-cas`, après commit). Rapport : `agents/diagnostic/rapports/2026-10-14T1436Z_PS_DES_COUDRES/` ; 44 appels d'outils, 190 s, ~89 k tokens.
|
||||
**Mise en place, le 2026-10-14 (index vide).** Scan à l'aveugle de `data/PS_DES_COUDRES/` sur un arbre propre (branche `base-de-cas`, après commit). Rapport : `agent-diagnostic/rapports/2026-10-14T1436Z_PS_DES_COUDRES/` ; 44 appels d'outils, 190 s, ~89 k tokens.
|
||||
|
||||
| Attendu | Résultat |
|
||||
|---|---|
|
||||
|
||||
@@ -1 +1 @@
|
||||
<mxfile host="drawio" version="24.7.17"><diagram id="p1" name="1. Vue d'ensemble"><mxGraphModel dx="1400" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1000" math="0" shadow="0"><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="p1_P1" value="<b>/aiguiser &lt;dossier&gt;</b><br>affine les outils de lecture (D-059)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="40" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P2" value="<b>/boucle &lt;dossier&gt;</b><br>règle les détecteurs du journal (D-057)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="400" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P3" value="<b>@agent-diagnostic data/… [question]</b><br>enquête à la demande sur un cas (D-058)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="760" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P4" value="<b>/nouveau-cas</b><br>ajoute un cas validé (D-048)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="1120" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_lg" value="<b>Légende</b>" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#cccccc;verticalAlign=top;align=left;spacingLeft=8;fontSize=11;" vertex="1" parent="1"><mxGeometry x="1130" y="790" width="330" height="165" as="geometry"/></mxCell><mxCell id="p1_t" value="<b>Processus IA du projet : vue d'ensemble</b><br><font style="font-size:12px">Qui lance quoi, et qui modifie quel bien partagé (au 2026-10-24). Tout est lancé à la main par l'utilisateur.</font>" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=18;" vertex="1" parent="1"><mxGeometry x="40" y="20" width="900" height="50" as="geometry"/></mxCell><mxCell id="p1_u" value="<b>Utilisateur (l'expert)</b><br>lance chaque processus, fusionne les branches" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;arcSize=12;" vertex="1" parent="1"><mxGeometry x="600" y="85" width="280" height="50" as="geometry"/></mxCell><mxCell id="p1_lecteur" value="<b>lecteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_correcteur" value="<b>correcteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="205" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_optimiseur" value="<b>optimiseur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P1f" value="Lit : data/ ; au contrôle final, les cas validés.<br>Garde une modification des outils seulement si la relecture est <i>mieux</i>." style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=11;" vertex="1" parent="1"><mxGeometry x="55" y="360" width="290" height="100" as="geometry"/></mxCell><mxCell id="p1_analyste" value="<b>analyste</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_upgrader" value="<b>upgrader</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_validateur" value="<b>validateur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_builder" value="<b>builder</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P2f" value="Lit : data/ par les outils de lecture ; la base de cas, après sa propre lecture." style="text;html=1;align=left;verticalAlign=top;wLine truncated
|
||||
<mxfile host="drawio" version="24.7.17"><diagram id="p1" name="1. Vue d'ensemble"><mxGraphModel dx="1400" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1000" math="0" shadow="0"><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="p1_P1" value="<b>/aiguiser &lt;dossier&gt;</b><br>affine les outils de lecture (D-059)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="40" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P2" value="<b>/boucle &lt;dossier&gt;</b><br>règle les détecteurs du journal (D-057)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="400" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P3" value="<b>@agent-diagnostic data/… [question]</b><br>enquête à la demande sur un cas (D-058)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="760" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P4" value="<b>/nouveau-cas</b><br>ajoute un cas validé (D-048)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="1120" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_lg" value="<b>Légende</b>" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#cccccc;verticalAlign=top;align=left;spacingLeft=8;fontSize=11;" vertex="1" parent="1"><mxGeometry x="1130" y="790" width="330" height="165" as="geometry"/></mxCell><mxCell id="p1_t" value="<b>Processus IA du projet : vue d'ensemble</b><br><font style="font-size:12px">Qui lance quoi, et qui modifie quel bien partagé (au 2026-10-24). Tout est lancé à la main par l'utilisateur.</font>" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=18;" vertex="1" parent="1"><mxGeometry x="40" y="20" width="900" height="50" as="geometry"/></mxCell><mxCell id="p1_u" value="<b>Utilisateur (l'expert)</b><br>lance chaque processus, fusionne les branches" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;arcSize=12;" vertex="1" parent="1"><mxGeometry x="600" y="85" width="280" height="50" as="geometry"/></mxCell><mxCell id="p1_lecteur" value="<b>lecteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_correcteur" value="<b>correcteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="205" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_optimiseur" value="<b>optimiseur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P1f" value="Lit : data/ ; au contrôle final, les cas validés.<br>Garde une modification des outils seulement si la relecture est <i>mieux</i>." style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=11;" vertex="1" parent="1"><mxGeometry x="55" y="360" width="290" height="100" as="geometry"/></mxCell><mxCell id="p1_analyste" value="<b>analyste</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_upgrader" value="<b>upgrader</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_validateur" value="<b>validateur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_builder" value="<b>builder</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P2f" value="Lit : data/ par les outils de lecture ; la base de cas, après sa propre lecture." style="text;html=1;align=left;verticalAlign=top;wLine truncated
|
||||
File renamed without changes.
@@ -827,3 +827,31 @@ Règles du journal :
|
||||
- **Pourquoi** : demande de l'utilisateur : automatiser la réponse aux clients, qui posent une question précise sur leurs données (ex. « y a-t-il eu de l'activité sur les voies cette nuit ? »), souvent depuis leur propre plateforme ; « le rôle de l'agent est de répondre à la question du client et c'est tout » : d'autres systèmes détectent les anomalies. Le peaufinage demande que l'agent reste dans la conversation.
|
||||
- **Options écartées** : un sous-agent comme `diagnostic` (il ne rend qu'un résultat, sans peaufinage dans la conversation) ; adapter l'agent de diagnostic (son rôle, trouver toutes les anomalies à l'aveugle, contredit « la question seule ») ; signaler au client les anomalies non demandées (elles vont dans `analyse.md`) ; `support/` hors de git.
|
||||
- **Conséquence** : le skill renvoie au déroulé et aux règles de l'agent de diagnostic (§4 et §5 de `agents/diagnostic/instructions.md`) et aux outils de `lire-les-donnees`, sans les recopier ; `support/` contient des mails et images de clients, contrairement à la base de cas anonymisée.
|
||||
|
||||
## D-080 — 2026-10-28 — Les événements dans `events/`, à la racine
|
||||
- **Statut** : active ; première étape d'une remise en ordre autour de `/boucle`, à poursuivre pas à pas.
|
||||
- **Décision** : la base de cas (`agents/diagnostic/cas/`, D-048) et ce qui la décrit, la carte des événements (`docs/displacement/domaine/carte-des-evenements.md`) et le graphe des éventualités (`docs/displacement/eventualites-et-categories.drawio`), passent dans un dossier `events/` à la racine : `events/INDEX.md`, `events/C-xxx/`, `events/carte-des-evenements.md`, `events/eventualites-et-categories.drawio`. Les chemins sont mis à jour dans les skills, les agents, les scripts, les fiches des cas, les contextes et le plan vivant ; l'historique (rapports, séances passées de `/boucle` et `/aiguiser`, `docs/superpowers/` hors plan vivant, ce journal, `docs/ameliorations-processus.md`) garde les anciens chemins.
|
||||
- **Pourquoi** : l'utilisateur s'y perdait ; « les cas sont fondamentaux dans le projet » : une connaissance métier qui grandit chaque jour par `/boucle` et qu'il valide périodiquement ; elle mérite un dossier à elle, pas un sous-dossier de l'agent de diagnostic.
|
||||
- **Options écartées** : aucune encore ; les notes de domaine des déplacements (`cas-annotes-par-l-expert.md`, `incident-de-barcelone.md`) restent dans `docs/displacement/domaine/` jusqu'à ce que l'utilisateur en décide.
|
||||
- **Conséquence** : vérifié après le déplacement : `benchmark.py` lit les 13 cas, les tests d'`anonymiser.py` et d'`etiquettes.py` passent, les 69 commandes citées par les fiches tournent sans échec.
|
||||
|
||||
## D-081 — 2026-10-28 — Les outils de lecture dans `agent-tools/`, à la racine
|
||||
- **Statut** : active ; deuxième étape de la remise en ordre autour de `/boucle`, après D-080.
|
||||
- **Décision** : les outils de lecture (`agents/diagnostic/outils/`) passent dans `agent-tools/` à la racine ; leur mode d'emploi reste le skill `lire-les-donnees`, et `/aiguiser` les améliore toujours. Les chemins sont mis à jour dans les skills, les agents, les détecteurs (qui importent `donnees.py`), les scripts, les fiches des cas, `support/`, les contextes et `CLAUDE.md` ; `graphique.py`, `vignettes.py` et `gif.py` calculent la racine du dépôt un niveau plus haut. L'historique garde les anciens chemins, comme pour D-080.
|
||||
- **Pourquoi** : demande de l'utilisateur : ces outils sont un gros morceau du projet, aiguisés par `/aiguiser`, utilisés par `lire-les-donnees` et donc par tous les agents qui lisent les données ; ils ne sont plus propres à l'agent de diagnostic.
|
||||
- **Options écartées** : aucune.
|
||||
- **Conséquence** : vérifié après le déplacement : les tests d'`anonymiser.py`, d'`etiquettes.py` et de `score.py` passent, le benchmark tourne, les 83 commandes citées par les fiches tournent sans échec, les détecteurs, `graphique.py`, `vignettes.py` et `gif.py` rendent leurs sorties sur C-001.
|
||||
|
||||
## D-082 — 2026-10-28 — L'agent de diagnostic dans `agent-diagnostic/`
|
||||
- **Statut** : active ; troisième étape de la remise en ordre, après D-080 et D-081.
|
||||
- **Décision** : `agents/diagnostic/` (consignes `instructions.md`, `README.md`, rapports) devient `agent-diagnostic/` à la racine ; `agents/` disparaît. Le point d'entrée reste `.claude/agents/diagnostic.md`. Les chemins sont mis à jour dans les skills, les agents, la spec, les contextes, le plan vivant et `CLAUDE.md` ; les rapports et l'historique gardent les anciens.
|
||||
- **Pourquoi** : l'utilisateur ne voit plus à quoi sert l'agent (la détection passe par les détecteurs et `/boucle`, les questions des clients par `/support`), mais le garde au cas où ; le nom du dossier doit dire tout de suite qu'il s'agit de lui.
|
||||
- **Options écartées** : retirer l'agent et reprendre ses règles dans `/support` (gardé dans le doute).
|
||||
- **Conséquence** : `/support` et `/nouveau-cas` renvoient toujours à `agent-diagnostic/instructions.md`.
|
||||
|
||||
## D-083 — 2026-10-28 — Le handoff dans `docs/aimsight/` ; `CLAUDE.md` et `README.md` réécrits
|
||||
- **Statut** : active ; quatrième étape de la remise en ordre, après D-080 à D-082. Applique D-012 et D-028.
|
||||
- **Décision** : `Handoff.md`, le cadrage du product owner (sous-projet G), passe dans `docs/aimsight/AIMsight_handoff_G_site_health.md`, avec les autres documents reçus d'AIMsight ; sa section « Écarts constatés », la nôtre, reste en fin de fichier. `CLAUDE.md` est réécrit en carte courte : l'état en quelques lignes, une seule table des analyses des domaines système, une section des déplacements, des chemins à jour. `README.md` est réécrit pour un humain : ce qui existe, démarrer, où trouver quoi.
|
||||
- **Pourquoi** : demande de l'utilisateur. « État et prochaine étape » était devenu un historique de près de 40 Ko, contraire à D-028, et des faits avaient vieilli (cinq cas au lieu de treize, onze catégories, `Handoff.md` à la racine, `README.md` resté à la livraison de Storage).
|
||||
- **Options écartées** : le handoff à la racine de `docs/` (c'est un document reçu, à lire par section avant de concevoir, comme les deux autres de `docs/aimsight/`).
|
||||
- **Conséquence** : `docs/aimsight/` n'est plus tout à fait « non modifié » : le handoff y porte nos écarts, signalés en tête du fichier.
|
||||
@@ -7,7 +7,7 @@ Deux rapports d'analyse remis au client par l'équipe AIMsight (mai 2026, révis
|
||||
Murs de soutènement en maçonnerie le long d'une voie ferrée, suivis près de deux ans, avec des prismes et des bandes réfléchissantes adhésives (« ciblettes »). Verdict des deux rapports : **aucun déplacement structurel notable** ; chaque déplacement apparent est attribué à une cause externe, preuves à l'appui (images, `error`, brillance).
|
||||
|
||||
Ils font office de vérité de référence pour `displacement`, avec deux limites :
|
||||
- les exports de ces murs ne sont pas dans `data/` : on ne peut ni vérifier les signatures ni rejouer un cas. Ils n'entrent donc pas dans la base de cas de l'agent de diagnostic (`agents/diagnostic/cas/`, D-048) ;
|
||||
- les exports de ces murs ne sont pas dans `data/` : on ne peut ni vérifier les signatures ni rejouer un cas. Ils n'entrent donc pas dans la base de cas de l'agent de diagnostic (`events/`, D-048) ;
|
||||
- les signatures ci-dessous sont lues sur les figures des rapports (axes illisibles dans GN-5.054) ; aucune heure n'y est donnée.
|
||||
|
||||
## Mur GN-1.472 (01/01 au 15/03/2026, détail du 15/02 au 15/03)
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
# L'incident de Barcelone (19.09.2026)
|
||||
|
||||
La documentation AIMsight en fait son cas de régression principal : roadmap, ligne 33 et §15 ; contexte support, §7-8 (exemple de dossier, question « Why did D-300-A jump? »), §12.2, §16.1 et l'exemple « Barcelona reference switching ». Ses données sont dans `data/CLARIDEN/` (export « L9 BCN », du 17/09 22:00 au 20/09 21:50 UTC, cadence de 10 min, 29 capteurs dont 5 références ; 432 images à 10 min, une par mesure, heures des zips en UTC) et, codées, dans le cas C-004 (`agents/diagnostic/cas/C-004/`).
|
||||
La documentation AIMsight en fait son cas de régression principal : roadmap, ligne 33 et §15 ; contexte support, §7-8 (exemple de dossier, question « Why did D-300-A jump? »), §12.2, §16.1 et l'exemple « Barcelona reference switching ». Ses données sont dans `data/CLARIDEN/` (export « L9 BCN », du 17/09 22:00 au 20/09 21:50 UTC, cadence de 10 min, 29 capteurs dont 5 références ; 432 images à 10 min, une par mesure, heures des zips en UTC) et, codées, dans le cas C-004 (`events/C-004/`).
|
||||
|
||||
## Ce qu'on observe
|
||||
|
||||
D'après le rapport à l'aveugle du 2026-10-15 (`agents/diagnostic/rapports/2026-10-15T1346Z_CLARIDEN_19-09-matin/`), revérifié sur les données :
|
||||
D'après le rapport à l'aveugle du 2026-10-15 (`agent-diagnostic/rapports/2026-10-15T1346Z_CLARIDEN_19-09-matin/`), revérifié sur les données :
|
||||
- vers 00:00 le 19/09, les références bougent entre elles (`PR-291` et `PR-293` de +0,7 px en `relative_x`, `D-302-C` immobile) ; `sigma0` décuple ; `corr_x` des cibles décroche sans que leur position brute bouge ;
|
||||
- à 06:10, les cibles « -B » bougent seules dans l'image (0,8 à 1,4 px), les références immobiles ; `PR_BG` saute de 17 px, son réflecteur n'est plus visible, son `error_value` reste juste sous le seuil et ses valeurs (~11) sont gardées ;
|
||||
- de 06:40 à 07:30, les 29 capteurs bougent ensemble (+1,8 à +4 px en `y`), puis reviennent en partie ; `corr_y` garde un palier jusqu'à la fin des mesures : +0,5 à +1,2 sur les cibles « -A », croissant avec la distance aux références, et −1,0 sur `D-306-B` ;
|
||||
|
||||
@@ -13,7 +13,7 @@ La plateforme garde deux types d'images par mesure (type de mesure), que le pomp
|
||||
|
||||
## Ce qu'on en sait
|
||||
|
||||
- NORDEND a des images DIFF, une par heure au pompage (~160 Mo par jour) ; les autres stations : inconnu.
|
||||
- NORDEND a des images DIFF, une par heure au pompage (~160 Mo par jour). LENZSPITZE n'en a aucune en base les 26 et 27/10 (pompage du 2026-10-28), seulement des IRON, une par heure : mode d'acquisition sans DIFF, sans doute (non vérifié). Les autres stations : inconnu.
|
||||
- Le 29/07 à NORDEND (C-002, toile d'araignée selon l'expert), l'image DIFF montre de longues traînées claires sur tout le champ et les cibles en points, là où l'image IRON ne montre que de faibles bandes sombres. Ce qui est tout près de l'objectif y ressort peut-être mieux : à confirmer (point 28 du plan du journal du matin).
|
||||
- Les outils de lecture (`agents/diagnostic/outils/donnees.py`), donc `/aiguiser` et `/boucle`, ne regardent que les images IRON et écartent `images_diff/`.
|
||||
- Les outils de lecture (`agent-tools/donnees.py`), donc `/aiguiser` et `/boucle`, ne regardent que les images IRON et écartent `images_diff/`.
|
||||
- Piste, non vérifiée : si `x`, `y` sont mesurés sur l'image DIFF, un centroïde pris sur l'image IRON peut s'en écarter (écart constant par capteur vu sur NORDEND, `colonnes-des-deplacements.md`).
|
||||
@@ -11,7 +11,7 @@
|
||||
**Spec :** pas de spec séparée, ce plan argumente depuis :
|
||||
- `vues-deplacements/contexte/journal-du-matin.md` : le brainstorming du 2026-10-23 et le retour de l'utilisateur sur la v0 ;
|
||||
- `docs/decisions.md`, D-056 et sa précision ;
|
||||
- `docs/displacement/domaine/carte-des-evenements.md` : les 12 événements et l'arbre de décision ;
|
||||
- `events/carte-des-evenements.md` : les 12 événements et l'arbre de décision ;
|
||||
- `vues-deplacements/maquette/spec.md`, section « L'onglet Journal ».
|
||||
|
||||
## Contraintes (valent pour tous les points)
|
||||
@@ -27,10 +27,10 @@
|
||||
- **Seuils** : chacun est commenté « provisoire, réglé sur C-00x » (règle « aucun seuil sans source » du `CLAUDE.md`, adaptée à l'exploration) et inscrit au registre, `vues-deplacements/contexte/seuils-du-journal.md` (point 17).
|
||||
- **Identifiants** (`SIM_CCID`, `ip`, secrets de l'application) jamais recopiés ; ne jamais lire de `.env`.
|
||||
- **Lecture seule** : rien n'écrit dans la base de la plateforme ni dans les dépôts `~/monitoring-dashboard-*` ; Claude ne se connecte jamais à la base, l'utilisateur lance l'extraction.
|
||||
- **Contrat d'un détecteur** (inchangé) : `vues-deplacements/detectors/<nom>.py` expose `detect(mesures) -> list[dict]`, `mesures = donnees.charger(dossier)` (`agents/diagnostic/outils/donnees.py`) ; épisode `{"start": iso, "end": iso, "kind": "<nom>", "label": str, "text": str, "ignore": bool, "sensors": [str]}` (heures `donnees.iso`, `sensors` vide = tous) ; un `__main__` qui imprime une ligne par épisode.
|
||||
- **Contrat d'un détecteur** (inchangé) : `vues-deplacements/detectors/<nom>.py` expose `detect(mesures) -> list[dict]`, `mesures = donnees.charger(dossier)` (`agent-tools/donnees.py`) ; épisode `{"start": iso, "end": iso, "kind": "<nom>", "label": str, "text": str, "ignore": bool, "sensors": [str]}` (heures `donnees.iso`, `sensors` vide = tous) ; un `__main__` qui imprime une ligne par épisode.
|
||||
- **Décisions** : une décision prise en conversation va dans `docs/decisions.md` (sous D-056 ou nouvelle entrée) ; un savoir métier nouveau dans `docs/displacement/domaine/` ; l'état du chantier dans « État et prochaine étape » de `CLAUDE.md` (qui doit rester sous 200 lignes, D-012).
|
||||
- **Commit** seulement quand l'utilisateur le demande.
|
||||
- **Cas de la base** : un cas n'y entre que sur demande de l'utilisateur (`/nouveau-cas`) ; noms codés dans `agents/diagnostic/cas/`.
|
||||
- **Cas de la base** : un cas n'y entre que sur demande de l'utilisateur (`/nouveau-cas`) ; noms codés dans `events/`.
|
||||
|
||||
## Points d'attention (ce qui casse le plus probablement)
|
||||
|
||||
@@ -104,6 +104,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis
|
||||
| 36 | Porter le journal dans la vraie application | Coder | 10 | en attente |
|
||||
| 49 | Le graphe des éventualités du terrain et deux catégories nouvelles | Décider, Coder | 5 | catégories (D-074) dans la carte, l'analyste et les détecteurs le 2026-10-27 ; à entraîner par `/boucle` |
|
||||
| 50 | Une ligne Status : la compilation de tous les détecteurs | Décider, Coder | 47, 49 | ligne Status dans `detecteurs.py` le 2026-10-27, refaite le même jour : ce qui se passe, l'événement qui englobe ; ordre des catégories à confirmer |
|
||||
| 51 | Un analyste qui progresse de séance en séance | Décider | 45, 48 | idée du 2026-10-28 ; proposition de Claude, questions à l'utilisateur |
|
||||
| | **VIII. Suivi du chantier** | | | |
|
||||
| 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | validé le 2026-10-24 |
|
||||
|
||||
@@ -162,7 +163,7 @@ Chemins conseillés : le plus simple et le plus parlant d'abord, **11 (visibilit
|
||||
|
||||
**Pourquoi.** L'utilisateur l'a demandée (« il n'y a pas 36 000 options ») : c'est la liste des catégories du journal catégorique (point 5). L'expert, c'est l'utilisateur : il valide chaque ligne.
|
||||
|
||||
**Ce qui existe.** `docs/displacement/domaine/carte-des-evenements.md` (72 l) :
|
||||
**Ce qui existe.** `events/carte-des-evenements.md` (72 l) :
|
||||
- 12 événements : 9 à ignorer (trou de données, pluie / brume / buée, neige, passage, feuilles / plante, références masquées, cycle thermique, turbulence, éclairage / voisin brillant) et 3 à regarder (tout a bougé et reste décalé, une cible a sauté, dérive lente), chacun avec label anglais, phrase au client, signature, cas ou source, détecteur ;
|
||||
- un arbre Mermaid de 6 questions (mesures manquantes ? `error_value` au-dessus du seuil ? chaque jour aux mêmes heures ? le décalage reste ? une cible ou beaucoup ? références touchées ? durée ?) ;
|
||||
- 5 lacunes : la cause d'une mauvaise visibilité (météo ou image), les obstructions lentes et contrastes faibles (HDF5), la dérive lente absente du journal, « références masquées » contre « tout a bougé » (Barcelone), la cause d'une cible qui saute.
|
||||
@@ -233,7 +234,7 @@ Précision de l'utilisateur, le même soir : le gros saut, c'est généralement
|
||||
|
||||
**Étapes.**
|
||||
- [x] Présenter le tableau et les règles ; noter les réponses.
|
||||
- [x] Écrire le tableau validé dans `docs/displacement/domaine/carte-des-evenements.md`, nouvelle section « 4. Catégories du journal et processus », en reliant chaque catégorie aux lignes de la section 1.
|
||||
- [x] Écrire le tableau validé dans `events/carte-des-evenements.md`, nouvelle section « 4. Catégories du journal et processus », en reliant chaque catégorie aux lignes de la section 1.
|
||||
- [x] Ajouter la décision sous D-056 (« Catégories du journal, validées le <date> »).
|
||||
|
||||
**Décidé le 2026-10-24** : les huit catégories, les règles et les sept recommandations, telles quelles : catégories gardées, « No data » partout ; cycle thermique pas grisé ; `saut_bref` à part ; reprise de C-002 en `a_verifier` ; bouton `Images` sauf turbulence, cycle thermique et trou ; deux niveaux de visibilité sur le principe (point 38) ; trains de C-005 en `passage`. Écrit dans la carte, section 4, et sous D-056. **Point 38 (2026-10-24)** : `visibilite_perdue` devient `visibilite_reduite` (Reduced visibility, en retrait) et `visibilite_nulle` (No visibility, grisée). **Point 41 (2026-10-24)** : `cycle_thermique` devient `dilatation_thermique` (Thermal expansion) et `contraction_thermique` (Thermal contraction), non grisées.
|
||||
@@ -280,7 +281,7 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
|
||||
|
||||
**Ce qui existe.**
|
||||
- `D.images` : `[{t, src}]`, toutes les images du dossier avec leur heure UTC (déjà dans la page, pour l'onglet View) ; `D.view` : le cadre des capteurs dans l'image (± 150 px) ; l'onglet View sait déjà afficher une image, zoomer sur les cibles, jouer un film (`▶ Play`, 2, 4 ou 8 images par seconde) et dessiner les cercles colorés selon `error_value`.
|
||||
- `agents/diagnostic/outils/vignettes.py` : grille PNG de vignettes (capteurs × heures), pour l'agent et les fiches de cas ; pas pour la page.
|
||||
- `agent-tools/vignettes.py` : grille PNG de vignettes (capteurs × heures), pour l'agent et les fiches de cas ; pas pour la page.
|
||||
- Images disponibles : NORDEND d'octobre au pas de 15 min (985 images) ; NORDEND de juillet, WILDSTRUBEL, CLARIDEN à 10 min ; NIEDERHORN horaire ; PS des Coudres 24 images horaires (13/10 12:00 → 14/10 11:00).
|
||||
|
||||
**Décisions prises ici.**
|
||||
@@ -334,7 +335,7 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
|
||||
|
||||
**Pourquoi.** « Il faut donner un diagnostic clair, et puis il faut que le diagnostic il soit complet. » Les phrases actuelles hésitent (« most likely », « probably rain, fog… »).
|
||||
|
||||
**Modèle.** La section « Verdict » des fiches de cas (`agents/diagnostic/cas/C-00x/cas.md`), écrites avec l'agent de diagnostic : une phrase, la cause et son niveau de preuve, la conséquence pour l'ouvrage, l'action (C-002 : « Une toile d'araignée devant l'objectif, vue sur les images : l'ouvrage n'a pas bougé et il n'y a rien à faire. »).
|
||||
**Modèle.** La section « Verdict » des fiches de cas (`events/C-00x/cas.md`), écrites avec l'agent de diagnostic : une phrase, la cause et son niveau de preuve, la conséquence pour l'ouvrage, l'action (C-002 : « Une toile d'araignée devant l'objectif, vue sur les images : l'ouvrage n'a pas bougé et il n'y a rien à faire. »).
|
||||
|
||||
**Règle proposée** (concilie le diagnostic catégorique avec la règle du projet de séparer fait et hypothèse) :
|
||||
- la **catégorie** est un fait observé (les cibles étaient mal vues, un objet est passé, les mesures manquent) : elle se dit sans conditionnel ;
|
||||
@@ -354,7 +355,7 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
|
||||
**Étapes.**
|
||||
- [x] Faire valider ou réécrire les phrases par l'utilisateur.
|
||||
- [x] Les écrire dans `CATEGORIES` (point 6), remplir `text` dans `classer` ; harmoniser les labels avec la carte (aujourd'hui « Heat shimmer » contre « Heat haze », « No data » contre « Data gap ») : un seul nom par catégorie, celui du point 5.
|
||||
- [x] Reporter les phrases validées dans `docs/displacement/domaine/carte-des-evenements.md` (colonne « Phrase au client »).
|
||||
- [x] Reporter les phrases validées dans `events/carte-des-evenements.md` (colonne « Phrase au client »).
|
||||
|
||||
**Fini quand.** Aucune phrase du journal ne contient « probably », « most likely » ou « may ».
|
||||
|
||||
@@ -416,7 +417,7 @@ Restent, comme prévu, pour d'autres points : « Target hidden » grise toutes l
|
||||
- [x] Dans la version simple de `visibilite.py`, deux limites sur la moyenne, `REDUIT` et `NUL` (provisoires, réglées à l'œil : pluie de C-005 = Reduced, NORDEND le 09/10 à 23:00 = None ; registre du point 17) ; un épisode par période de même statut, avec son `level`.
|
||||
- [x] Écartée le 2026-10-24 (la frise suffit ; à la place, barre orange et léger retrait pour « Reduced », grisé pour « None »). Texte d'origine : la bande de statut (vert, orange, rouge) sous les courbes du Journal, mesure par mesure ; épisodes `reduced` en léger retrait, `none` grisés.
|
||||
- [x] Vérifier sur les six jeux et montrer : C-005, les deux nuits de pluie en orange ; C-002, la toile en rouge ; NORDEND le 09/10 à 23:00 en rouge ; C-001 (buée) et C-003 (turbulence) : orange ou rien, à juger par l'utilisateur.
|
||||
- [x] Reporter les statuts validés dans `docs/displacement/domaine/carte-des-evenements.md` (section 4 du point 5) et sous D-056.
|
||||
- [x] Reporter les statuts validés dans `events/carte-des-evenements.md` (section 4 du point 5) et sous D-056.
|
||||
|
||||
**Fini quand.** L'utilisateur distingue d'un coup d'œil « données moyennes » et « on ne voit rien » sur les six jeux.
|
||||
|
||||
@@ -842,7 +843,7 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
|
||||
- **Rôles reformulés par Claude, acceptés par l'utilisateur le 2026-10-24** (« parfait »), avec les ajouts de Claude : les agents ne se parlent pas, chacun écrit son rendu dans le dossier de la séance et l'orchestrateur le transmet ; au plus 3 allers-retours upgrader / validateur, puis on garde la dernière version qui va dans le bon sens ; plusieurs analystes en parallèle plus tard, l'upgrader toujours seul ; les cas du builder marqués « appris par Claude, non validé », lus par les analystes des lots suivants (même base que les autres, voir plus bas) ; modifications des détecteurs sur une branche git à part ; déplacements seulement.
|
||||
- **Réponses de l'utilisateur le 2026-10-24** : tout se commite, chaque modification, pour s'y retrouver et revenir en arrière ; le builder ajoute les cas sans attendre (« ça ne peut pas vraiment faire de mal »), une revalidation à la main viendra peut-être plus tard, pas maintenant ; l'upgrader modifie les détecteurs seul, « essayer et voir dans quelle direction ça va » ; **pas de rejeu** des lots déjà vus : on explore des données et on améliore peu à peu, sans chercher l'exhaustif ni tout revalider à chaque fois (remplace le rejeu de l'étape 7 et l'ajout de Claude) ; la crainte : **partir dans trop de complexité**.
|
||||
- **Conception écrite le 2026-10-24** : `vues-deplacements/contexte/boucle-automatique.md`, **approuvée** par l'utilisateur le 2026-10-24 ; plan de construction : `docs/superpowers/plans/2026-10-24-boucle-automatique.md` (7 tâches) ; rien construit.
|
||||
- **L'agent de diagnostic n'entre pas en jeu dans la boucle** (l'utilisateur, 2026-10-24) : il n'y a aucun travail, ses consignes ne changent pas ; il sert au diagnostic pour l'utilisateur et sera traité dans une autre conversation. Tous les cas restent au même endroit : le builder complète la base `agents/diagnostic/cas/` (C-006…, marqués « appris »).
|
||||
- **L'agent de diagnostic n'entre pas en jeu dans la boucle** (l'utilisateur, 2026-10-24) : il n'y a aucun travail, ses consignes ne changent pas ; il sert au diagnostic pour l'utilisateur et sera traité dans une autre conversation. Tous les cas restent au même endroit : le builder complète la base `events/` (C-006…, marqués « appris »).
|
||||
|
||||
### Point 32 : Le test « Claude verrait la même chose »
|
||||
|
||||
@@ -1013,7 +1014,7 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
|
||||
|
||||
**Réponses de l'utilisateur (2026-10-26).** Oui aux trois : « les étiquettes sont faites pour ça » ; passage unique de l'analyste sur C-001 à C-005, qu'il relira ; le benchmark en garde-fou et bonus.
|
||||
|
||||
**Fait le 2026-10-26 (D-069).** `anonymiser.py --etiquettes` (et son test) ; étiquettes de C-006 à C-008 recopiées du lot 01 de la séance de NORDEND, codées ; celles de C-001 à C-005 par cinq analystes en parallèle, lecture propre puis correction par la fiche (`agents/diagnostic/cas/C-00x/etiquetage.md`) ; `.claude/skills/boucle/benchmark.py` et `vues-deplacements/benchmark/historique.csv` ; branchement dans `/boucle` (orchestrateur aux trois moments, upgrader, validateur, builder, bilan, page de fin de séance), dans `/nouveau-cas` et la spec de l'agent de diagnostic (§11.1) ; le contrôle « Cas de la base » par `categories.py` est remplacé.
|
||||
**Fait le 2026-10-26 (D-069).** `anonymiser.py --etiquettes` (et son test) ; étiquettes de C-006 à C-008 recopiées du lot 01 de la séance de NORDEND, codées ; celles de C-001 à C-005 par cinq analystes en parallèle, lecture propre puis correction par la fiche (`events/C-00x/etiquetage.md`) ; `.claude/skills/boucle/benchmark.py` et `vues-deplacements/benchmark/historique.csv` ; branchement dans `/boucle` (orchestrateur aux trois moments, upgrader, validateur, builder, bilan, page de fin de séance), dans `/nouveau-cas` et la spec de l'agent de diagnostic (§11.1) ; le contrôle « Cas de la base » par `categories.py` est remplacé.
|
||||
|
||||
**Étapes.**
|
||||
- [x] Les réponses de l'utilisateur.
|
||||
@@ -1061,6 +1062,31 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
|
||||
|
||||
**Fini quand.** La page des détecteurs montre, sous les catégories, une ligne Status qui dit à chaque instant ce qui l'emporte et pourquoi.
|
||||
|
||||
### Point 51 : Un analyste qui progresse de séance en séance
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-28). L'analyste de `/boucle` doit devenir plus performant au fil des séances ; ce n'est pas le cas aujourd'hui. Plus il est fin, meilleure est sa lecture, donc sa critique.
|
||||
|
||||
**Constat (Claude).**
|
||||
- L'analyste est le plafond de la boucle : ses étiquettes sont la vérité du score (D-062) et ses nouveautés deviennent les cas appris (builder). S'il stagne, les détecteurs convergent vers ses erreurs.
|
||||
- Le modèle est déjà celui de la session (D-063) ; ce qui peut progresser, c'est ce qu'il sait. Sa **lecture** progresse déjà par `/aiguiser` (outils et `lire-les-donnees`). Son **jugement** (à quoi ressemble un train, une buée, une cible défaillante) ne progresse pas : il ne lit la base de cas qu'à l'étape 4 de `critiquer-lot`, après ses étiquettes, au plus 3 fiches ; ce qu'apprend la base n'atteint jamais ses étiquettes.
|
||||
- Risque : l'auto-renforcement. Les cas « (appris) » sont ses propres conclusions, non validées ; les lire avant d'étiqueter graverait ses erreurs. Seul ce que l'expert a validé ou corrigé doit lui apprendre.
|
||||
|
||||
**Proposition de Claude (à valider).**
|
||||
- **Sa mémoire = la carte des événements**, qu'il lit déjà avant l'étape 1 : quand l'utilisateur valide ou corrige un cas par `/revue-cas`, la signature du cas entre dans la carte, sous l'éventualité qui le fait, avec son lien ; une correction (« ce n'était pas X mais Y ») y devient une mise en garde. Les cas validés C-001 à C-005 y entrent de même. Rien des cas non revus.
|
||||
- Pas de fiches lues avant les étiquettes (coût, et conclusions possibles sur les données mêmes du lot).
|
||||
- **Mesurer** : sans mesure, on ne saura pas s'il progresse. Les étiquettes figées des cas validés (D-069), relues par l'utilisateur, servent de corrigé : de temps en temps, l'analyste étiquette un cas validé sans sa fiche, `score.py` le compare. Une lecture coûte environ 250 000 jetons (D-059) : pas à chaque séance, et un ou deux cas témoins restent hors de la carte, sinon la mesure triche.
|
||||
|
||||
**Questions à l'utilisateur.**
|
||||
1. La carte comme mémoire de l'analyste, nourrie par `/revue-cas` seule ?
|
||||
2. La mesure de l'analyste sur des cas témoins : la vouloir, et à quel rythme ?
|
||||
|
||||
**Contre-proposition de l'utilisateur (2026-10-28).** Que l'analyste regarde directement les cas qu'il a validés. Avis de Claude : oui, c'est plus simple que la carte, puisqu'il n'y a rien à recopier ni d'étape à ajouter à `/revue-cas`. Les cas validés sont ceux dont le Verdict, dans l'index, ne porte pas « (appris) » (C-001 à C-011 aujourd'hui, environ 40 lignes chacun) : avant l'étape 1, il lit l'index et ces fiches, leurs figures au besoin ; les cas « (appris) » restent à l'étape 4. Limites : la lecture grossit avec la base (passer à l'index seul, puis aux fiches proches, quand ce sera trop) ; un lot qui recouvre un cas validé y lit la réponse de l'expert (sans mal pour les étiquettes, mais ce cas ne mesure plus l'analyste) ; les cas témoins de la mesure restent hors de sa lecture.
|
||||
|
||||
**Étapes.**
|
||||
- [ ] Les réponses de l'utilisateur.
|
||||
|
||||
**Fini quand.** D'une séance à l'autre, l'analyste profite de ce que l'utilisateur a validé ou corrigé, et on le mesure.
|
||||
|
||||
---
|
||||
|
||||
## Partie VII — Idées gardées pour plus tard
|
||||
@@ -1092,7 +1118,7 @@ Comme pour les statuts des métriques système (Energy, Storage, Cellular, Tempe
|
||||
|
||||
### Point 49 : Le graphe des éventualités du terrain et deux catégories nouvelles
|
||||
|
||||
Demande de l'utilisateur (2026-10-27) : un graphe simple, sans le détail des données, de ce qui peut arriver sur le terrain vers les catégories du journal ; une éventualité peut en donner plusieurs (la neige sur les cibles : visibilité réduite ou nulle, ou cible masquée). Fait dans `docs/displacement/eventualites-et-categories.drawio`, en tête de la carte des événements, à la place de l'arbre Mermaid. Les étiquettes de l'analyste (boucles et cas C-001 à C-011) en font sortir une catégorie qui manque : les cibles mal vues ou mal suivies durablement (C-008 à C-011, cibles toujours rejetées), qu'il range aujourd'hui hors catégorie ou à vérifier.
|
||||
Demande de l'utilisateur (2026-10-27) : un graphe simple, sans le détail des données, de ce qui peut arriver sur le terrain vers les catégories du journal ; une éventualité peut en donner plusieurs (la neige sur les cibles : visibilité réduite ou nulle, ou cible masquée). Fait dans `events/eventualites-et-categories.drawio`, en tête de la carte des événements, à la place de l'arbre Mermaid. Les étiquettes de l'analyste (boucles et cas C-001 à C-011) en font sortir une catégorie qui manque : les cibles mal vues ou mal suivies durablement (C-008 à C-011, cibles toujours rejetées), qu'il range aujourd'hui hors catégorie ou à vérifier.
|
||||
- [x] Le graphe : 23 éventualités en cinq familles, 11 catégories, la vérification d'un `À vérifier` ou d'une dérive lente vers « Cible déplacée ».
|
||||
- [ ] L'utilisateur relit les liens du graphe dans draw.io.
|
||||
- [x] Les catégories, définies par l'utilisateur le 2026-10-27 (D-074) : tout ce qui reste inexpliqué dans **À vérifier** (sous-groupes : saut qui dure, gros saut, dérive lente), pour ne pas alarmer le client ; **Cible défaillante** gardée (cible constamment problématique : mal orientée, mal installée, dégradée) ; effet thermique, passage, pas de données, saut bref et turbulences atmosphériques redéfinis ; graphe refait.
|
||||
@@ -1106,7 +1132,7 @@ Demande de l'utilisateur (2026-10-27) : un graphe simple, sans le détail des do
|
||||
|
||||
### Point 37 : Ménage : commit, `CLAUDE.md`, Mermaid, sorties
|
||||
|
||||
- [x] **Commit** : rien n'est commité depuis le 2026-10-23. Fichiers de cette conversation : `vues-deplacements/detectors/` (5 détecteurs), `vues-deplacements/maquette/explore.py`, `explore_template.html`, `spec.md`, `vues-deplacements/contexte/journal-du-matin.md`, `lissage.md`, `donnees-et-boucle.md`, `docs/displacement/domaine/carte-des-evenements.md`, `extraction/`, `docs/decisions.md` (D-056), `CLAUDE.md`, `vues-deplacements/CLAUDE.md`, ce plan. Déjà modifiés avant par l'utilisateur : `CLAUDE.md`, `docs/ameliorations-faq.md` ; `graphify-out/` n'est pas de cette conversation. Commit sur demande seulement, en séparant ce qui est de l'utilisateur. Fait le 2026-10-24 : commits `4ac95ae` (points 1 à 10), `86547f0` (11 à 17, 38, 41), puis celui des points 18 à 26, 30, 39, 40 et de ce ménage ; aucun fichier de l'utilisateur dans ces changements.
|
||||
- [x] **Commit** : rien n'est commité depuis le 2026-10-23. Fichiers de cette conversation : `vues-deplacements/detectors/` (5 détecteurs), `vues-deplacements/maquette/explore.py`, `explore_template.html`, `spec.md`, `vues-deplacements/contexte/journal-du-matin.md`, `lissage.md`, `donnees-et-boucle.md`, `events/carte-des-evenements.md`, `extraction/`, `docs/decisions.md` (D-056), `CLAUDE.md`, `vues-deplacements/CLAUDE.md`, ce plan. Déjà modifiés avant par l'utilisateur : `CLAUDE.md`, `docs/ameliorations-faq.md` ; `graphify-out/` n'est pas de cette conversation. Commit sur demande seulement, en séparant ce qui est de l'utilisateur. Fait le 2026-10-24 : commits `4ac95ae` (points 1 à 10), `86547f0` (11 à 17, 38, 41), puis celui des points 18 à 26, 30, 39, 40 et de ce ménage ; aucun fichier de l'utilisateur dans ces changements.
|
||||
- [x] **`CLAUDE.md`** fait 202 lignes (limite 200, D-012) : raccourcir la puce « Prochaine étape » (la plus longue) en renvoyant à ce plan. Fait le 2026-10-24 : 199 lignes (phrase redite des « Règles de travail » retirée, les deux puces Energy réunies) ; puces du journal du matin et « Prochaine étape » mises à l'état du jour (onze catégories, courbes nettoyées, points en attente) ; `vues-deplacements/CLAUDE.md` aussi (onze catégories).
|
||||
- [x] **Mermaid** de la carte : à rendre une fois (point 3). Déjà fait au point 3 (arbre rendu sans erreur, journal du plan).
|
||||
- [x] **Sorties** : `data/NORDEND` et le cas `vues-deplacements/cas/2026-10_NORDEND/NORDEND` écrivent tous deux `out/vues_deplacements_NORDEND.html` ; capturer juste après la construction, ou nommer la sortie par le chemin du dossier. Fait le 2026-10-24 : un dossier de cas écrit la page au nom du cas (`out/vues_deplacements_2026-10_NORDEND.html`), `data/NORDEND` garde `out/vues_deplacements_NORDEND.html` ; `CLAUDE.md`, spec et annexe B à jour.
|
||||
@@ -1244,7 +1270,7 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
|
||||
- 2026-10-26 : point 31 : `/boucle` commite directement sur `master` (demande de l'utilisateur, D-070) ; branches des séances NORDEND et CLARIDEN fusionnées dans `master` et supprimées.
|
||||
- 2026-10-26 : point 31 : `/boucle --ameliorer` (demande de l'utilisateur, D-071) : après le releveur, l'agent `ameliorateur` corrige le skill et ses agents d'après les entrées de la séance ; sans séance d'essai.
|
||||
- 2026-10-26 : point 43 : la pose de la caméra entre dans la lecture (demande de l'utilisateur, D-073) : `charger_camera` dans `donnees.py`, panneaux et colonnes `cam_` dans `ensemble.py`, instants sans recalage dans `inventaire.py`, pose lue en premier par `lire-les-donnees`.
|
||||
- 2026-10-27 : point 49 ajouté (demande de l'utilisateur) : graphe des éventualités du terrain vers les catégories, `docs/displacement/eventualites-et-categories.drawio`, à la place de l'arbre Mermaid de la carte ; deux catégories proposées, Cible défaillante et Cible déplacée.
|
||||
- 2026-10-27 : point 49 ajouté (demande de l'utilisateur) : graphe des éventualités du terrain vers les catégories, `events/eventualites-et-categories.drawio`, à la place de l'arbre Mermaid de la carte ; deux catégories proposées, Cible défaillante et Cible déplacée.
|
||||
- 2026-10-27 : point 49 : catégories définies par l'utilisateur (D-074) : « À vérifier » pour tout ce qui reste inexpliqué, avec la dérive lente et le gros saut en sous-groupes ; Cible défaillante gardée ; graphe refait ; reste à les reporter dans le journal.
|
||||
- 2026-10-27 : point 49 : le véhicule qui fait vibrer l'ouvrage ou la caméra va dans Saut bref (l'utilisateur).
|
||||
- 2026-10-27 : point 49 : un détecteur au moins par catégorie (demande de l'utilisateur) : `derive.py`, cible collée et bascule en Cible défaillante, gros saut, effet thermique de la caméra ; carte (section 4) et `critiquer-lot` mis aux définitions de D-074 pour l'analyste.
|
||||
@@ -1263,3 +1289,4 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
|
||||
- 2026-10-27 : page des détecteurs, validé par l'utilisateur (2026-10-28) : bouton ⤓ GIF dans le timelapse, le GIF tel qu'il est montré (Focused ou Global, 1000 px de large au plus, bord rouge pendant, heure en bas) dans les téléchargements du navigateur ; en file:// le navigateur ne lit pas les pixels des images : la page (comme celles de fin de séance et de /revue-cas) s'ouvre par un serveur local, http://127.0.0.1:8765, lancé en tâche de fond au besoin, qui ne sert que out/ et data/ (`open_served`, `src/common/page.py`). Sur LENZSPITZE, ni Focused ni étiquettes : x et y n'y sont pas des positions.
|
||||
- 2026-10-28 : page des détecteurs, validé par l'utilisateur : le GIF exporté sans bord rouge, date et heure en bas à droite ; timelapse et GIF jusqu'à 150 images (G_MAX, 60 avant) ; l'explorateur d'images montre déjà toutes les images du dossier sur la plage : pour en avoir plus, pomper avec --every 0 (défaut : une par heure).
|
||||
- 2026-10-28 : page des détecteurs, validé par l'utilisateur : un clic sur la barre d'un événement (détecteurs ou analyste) fait comme un clic sur un bloc du Status : zoom sur sa plage, ses détails et son timelapse sous la figure ; pour un événement des détecteurs, ses seuls capteurs sur les courbes (plus de second clic).
|
||||
- 2026-10-28 : point 51, idée de l'utilisateur : un analyste de `/boucle` qui progresse de séance en séance ; proposition de Claude (la carte des événements comme mémoire, nourrie par `/revue-cas` seule ; une mesure sur des cas témoins) et deux questions.
|
||||
File renamed without changes.
File renamed without changes.
@@ -15,11 +15,11 @@ Probablement de la brume ou de la buée (déduite, pas vue) : le système est sa
|
||||
|
||||
## Signature
|
||||
Critères observables, relatifs au niveau habituel du capteur, chacun avec sa commande :
|
||||
1. Une partie des références, pas toutes (ici deux sur trois) : `error_value` monte à plusieurs dizaines de MAD au-dessus de sa médiane (ici 28 et 57 MAD), d'un coup ou progressivement, en quelques heures au plus (ici 30 min pour R3, 2 h 30 pour R2) : `python3 agents/diagnostic/outils/resume.py agents/diagnostic/cas/C-001/ --colonne error_value --pas 15min --capteurs R1,R2,R3 --debut 2026-10-13T20:00Z --fin 2026-10-14T08:00Z`
|
||||
1. Une partie des références, pas toutes (ici deux sur trois) : `error_value` monte à plusieurs dizaines de MAD au-dessus de sa médiane (ici 28 et 57 MAD), d'un coup ou progressivement, en quelques heures au plus (ici 30 min pour R3, 2 h 30 pour R2) : `python3 agent-tools/resume.py events/C-001/ --colonne error_value --pas 15min --capteurs R1,R2,R3 --debut 2026-10-13T20:00Z --fin 2026-10-14T08:00Z`
|
||||
2. La nuit, pendant quelques heures (ici 3 h 45 et 5 h 30), puis retour au niveau habituel avant le jour, sans intervention : même commande.
|
||||
3. Témoins : l'autre référence et toutes les cibles restent proches de leur niveau habituel, bien en dessous des références touchées en MAD (ici 9 MAD au plus) : `python3 agents/diagnostic/outils/resume.py agents/diagnostic/cas/C-001/ --colonne error_value --stat max --pas 6h --debut 2026-10-13T20:00Z --fin 2026-10-14T08:00Z`
|
||||
4. Pendant l'épisode, de la montée des références à leur retour, les positions brutes des cibles n'ont pas de marche : aucun pas de 15 min de `relative_x` ou `relative_y` hors de leur dispersion habituelle (ici 4 MAD au plus) : `python3 agents/diagnostic/outils/resume.py agents/diagnostic/cas/C-001/ --colonne relative_x --pas 15min --debut 2026-10-13T23:30Z --fin 2026-10-14T05:30Z` (même chose pour `relative_y`)
|
||||
5. Sur les images : les taches des références touchées rapetissent puis retrouvent leur taille ; les témoins ne changent pas ; aucun obstacle : `.venv/bin/python agents/diagnostic/outils/vignettes.py agents/diagnostic/cas/C-001/ --capteurs R3,R2,R1,C3 --heures 2026-10-13T22:00Z,2026-10-14T02:00Z,2026-10-14T04:00Z,2026-10-14T06:00Z`
|
||||
3. Témoins : l'autre référence et toutes les cibles restent proches de leur niveau habituel, bien en dessous des références touchées en MAD (ici 9 MAD au plus) : `python3 agent-tools/resume.py events/C-001/ --colonne error_value --stat max --pas 6h --debut 2026-10-13T20:00Z --fin 2026-10-14T08:00Z`
|
||||
4. Pendant l'épisode, de la montée des références à leur retour, les positions brutes des cibles n'ont pas de marche : aucun pas de 15 min de `relative_x` ou `relative_y` hors de leur dispersion habituelle (ici 4 MAD au plus) : `python3 agent-tools/resume.py events/C-001/ --colonne relative_x --pas 15min --debut 2026-10-13T23:30Z --fin 2026-10-14T05:30Z` (même chose pour `relative_y`)
|
||||
5. Sur les images : les taches des références touchées rapetissent puis retrouvent leur taille ; les témoins ne changent pas ; aucun obstacle : `.venv/bin/python agent-tools/vignettes.py events/C-001/ --capteurs R3,R2,R1,C3 --heures 2026-10-13T22:00Z,2026-10-14T02:00Z,2026-10-14T04:00Z,2026-10-14T06:00Z`
|
||||
|
||||
## Diagnostic
|
||||
- **Classification** : *target-local degradation* (ici, deux références et non des cibles)
|
||||
File renamed without changes.
|
500 Internal Server Error
An error occurred: An error occurred Gitea Version: 28.2.0 |