Code station and sensor names in the diagnostic case base (D-049)

Add the anonymiser-cas skill: a growing registry gives stable codes
(S01, R1, C1), a stdlib script rewrites a case and renames its files,
and graphique.py / vignettes.py take --alias to plot with codes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-14 17:45:40 +02:00
1 parent 3478d77f1d
commit a684349501
15 files changed
+203 -30

No files matched your search

+26
View File
@@ -0,0 +1,26 @@
---
name: anonymiser-cas
description: À utiliser quand une fiche ou une figure de la base de cas de l'agent de diagnostic (agents/diagnostic/cas/) porte un nom réel de station, de référence ou de cible — à l'étape 5 de /nouveau-cas, avant de montrer la fiche, ou sur un cas déjà entré.
argument-hint: "data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/"
---
# Anonymiser un cas
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). Tous les noms deviennent donc des codes stables : `S01` pour une station, `R1` pour une référence, `C1` pour une cible, numérotés par station. Le registre `registre.csv`, à côté de ce fichier, garde les correspondances d'un cas à l'autre.
1. **Codes** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ --alias` imprime `NOM=CODE,...`. Un nom inconnu reçoit le code suivant et entre dans le registre.
2. **Figures** : le script ne peut pas réécrire le texte d'un PNG. Fais chaque figure du cas avec sa commande (`graphique.py`, `vignettes.py`), `--sortie <dossier du cas>` et `--alias "<sortie de l'étape 1>"`. Dans la fiche, cite le fichier qu'elle imprime, déjà codé. Supprime les PNG aux noms réels.
3. **Textes et noms de fichiers** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/` :
- réécrit les `.md` du cas et `cas/INDEX.md` ;
- renomme les fichiers et le dossier (`C-xxx_S01_<date>`) ;
- 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.
## Règles
- 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 les codes (`data/S01/`, `--capteurs R3,R2`). Pour les rejouer, prends les noms dans le registre.
- Un chemin vers `rapports/`, qui garde les vrais noms, devient codé. Son préfixe horodaté suffit pour le retrouver : `ls agents/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`.
+112
View File
@@ -0,0 +1,112 @@
"""Anonymise un cas de la base de l'agent de diagnostic : la station et ses capteurs deviennent des codes stables.
Usage :
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/
réécrit les .md du cas et cas/INDEX.md, renomme fichiers et dossier ; échoue s'il reste un nom réel
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ --alias
imprime NOM=CODE,... pour l'option --alias de graphique.py et vignettes.py
python3 .claude/skills/anonymiser-cas/anonymiser.py --test
Codes : S01, S02... pour les stations ; R1, R2... pour les références et C1, C2... pour les cibles, par station.
Le registre (registre.csv, à côté) ne fait que grandir : un nom garde son code d'un cas à l'autre.
"""
import csv
import os
import re
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")
sys.path.insert(0, os.path.join(RACINE, "agents", "diagnostic", "outils"))
from donnees import charger, est_reference # noqa: E402
def codes(dossier):
"""{nom: code} de la station et de ses capteurs ; un nom inconnu reçoit le code suivant, ajouté au registre."""
station = os.path.basename(os.path.normpath(dossier))
par = charger(dossier)
if not par:
sys.exit(f"Aucun export « advanced » dans {dossier}.")
lignes = list(csv.DictReader(open(REGISTRE, newline=""))) if os.path.exists(REGISTRE) else []
connus = {(l["station"], l["nom"]): l["code"] for l in lignes}
nouveaux = []
if (station, station) not in connus:
n = max((int(c[1:]) for (s, nom), c in connus.items() if s == nom), default=0)
nouveaux.append((station, station, f"S{n + 1:02d}"))
for prefixe, reference in (("R", True), ("C", False)):
n = max((int(c[1:]) for (s, nom), c in connus.items() if s == station != nom and c[0] == prefixe), default=0)
for nom in sorted(x for x in par if est_reference(par[x]) == reference and (station, x) not in connus):
n += 1
nouveaux.append((station, nom, f"{prefixe}{n}"))
if nouveaux:
with open(REGISTRE, "a", newline="") as f:
w = csv.writer(f)
if not lignes:
w.writerow(("station", "nom", "code"))
w.writerows(nouveaux)
connus.update({(s, nom): c for s, nom, c in nouveaux})
return station, {nom: c for (s, nom), c in connus.items() if s == station}
def motif(table, station, casse=False):
"""Les noms, du plus long au plus court, bornés par un caractère non alphanumérique (« _ » compris : un nom
collé dans un nom de fichier est trouvé, mais BJ_C ne l'est pas dans PBJ_C). La station accepte espace ou « _ »
et toute casse (PS_DES_COUDRES, « PS des Coudres »)."""
parties = []
for nom in sorted(table, key=len, reverse=True):
p = re.escape(nom)
parties.append(f"(?i:{p.replace('_', '[ _]')})" if nom == station else p)
return re.compile(("(?i)" if casse else "") + r"(?<![A-Za-z0-9])(" + "|".join(parties) + r")(?![A-Za-z0-9])")
def remplacer(texte, table, station):
return motif(table, station).sub(lambda m: table.get(m.group(1), table[station]), texte)
def anonymiser(dossier, cas):
station, table = codes(dossier)
textes = [os.path.join(r, f) for r, _, fs in os.walk(cas) for f in fs if f.endswith(".md")] + [INDEX]
for p in textes:
avant = open(p).read()
apres = remplacer(avant, table, station)
if apres != avant:
open(p, "w").write(apres)
for r, dossiers, fichiers in os.walk(cas, topdown=False):
for f in fichiers + dossiers:
if remplacer(f, table, station) != f:
os.rename(os.path.join(r, f), os.path.join(r, remplacer(f, table, station)))
parent, nom = os.path.split(os.path.normpath(cas))
cas = os.path.join(parent, remplacer(nom, table, station))
os.rename(os.path.join(parent, nom), cas)
reste = motif(table, station, casse=True)
textes = [os.path.join(r, f) for r, _, fs in os.walk(cas) for f in fs if f.endswith(".md")] + [INDEX]
residus = [f"{p} : {m.group(1)}" for p in textes for m in reste.finditer(open(p).read())]
residus += [os.path.join(r, f) for r, ds, fs in os.walk(cas) for f in fs + ds if reste.search(f)]
if residus:
sys.exit("Noms réels restants (casse différente ?) :\n " + "\n ".join(residus))
print(cas)
print(", ".join(f"{n} → {c}" for n, c in sorted(table.items(), key=lambda x: x[1])))
def _test():
t = {"PS_DES_COUDRES": "S01", "BJ_C": "C1", "PBJ_C": "C7", "REF_G": "R3"}
f = lambda s: remplacer(s, t, "PS_DES_COUDRES") # noqa: E731
assert f("PBJ_C et BJ_C") == "C7 et C1"
assert f("PS_DES_COUDRES_error_value_REF_G-BJ_C.png") == "S01_error_value_R3-C1.png"
assert f("PS des Coudres, REF_GX, data/PS_DES_COUDRES/") == "S01, REF_GX, data/S01/"
print("ok")
if __name__ == "__main__":
a = sys.argv[1:]
if a == ["--test"]:
_test()
elif len(a) == 2 and a[1] == "--alias":
_, table = codes(a[0])
print(",".join(f"{n}={c}" for n, c in sorted(table.items())))
elif len(a) == 2:
anonymiser(*a)
else:
sys.exit(__doc__)
@@ -0,0 +1,17 @@
station,nom,code
PS_DES_COUDRES,PS_DES_COUDRES,S01
PS_DES_COUDRES,REF_CT,R1
PS_DES_COUDRES,REF_D,R2
PS_DES_COUDRES,REF_G,R3
PS_DES_COUDRES,BJ_C,C1
PS_DES_COUDRES,BJ_D,C2
PS_DES_COUDRES,BJ_G,C3
PS_DES_COUDRES,BL_C,C4
PS_DES_COUDRES,BL_D,C5
PS_DES_COUDRES,BL_G,C6
PS_DES_COUDRES,PBJ_C,C7
PS_DES_COUDRES,PBL_C,C8
PS_DES_COUDRES,PBL_D,C9
PS_DES_COUDRES,PM_C,C10
PS_DES_COUDRES,PM_D,C11
PS_DES_COUDRES,PM_G,C12
1 station nom code
2 PS_DES_COUDRES PS_DES_COUDRES S01
3 PS_DES_COUDRES REF_CT R1
4 PS_DES_COUDRES REF_D R2
5 PS_DES_COUDRES REF_G R3
6 PS_DES_COUDRES BJ_C C1
7 PS_DES_COUDRES BJ_D C2
8 PS_DES_COUDRES BJ_G C3
9 PS_DES_COUDRES BL_C C4
10 PS_DES_COUDRES BL_D C5
11 PS_DES_COUDRES BL_G C6
12 PS_DES_COUDRES PBJ_C C7
13 PS_DES_COUDRES PBL_C C8
14 PS_DES_COUDRES PBL_D C9
15 PS_DES_COUDRES PM_C C10
16 PS_DES_COUDRES PM_D C11
17 PS_DES_COUDRES PM_G C12
+4 -3
View File
@@ -44,18 +44,19 @@ Le sous-agent reçoit la branche et les derniers messages de commit (§7 de la s
- **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_<STATION>_<AAAA-MM-JJ du début>/`, `<STATION>` étant le nom du dossier de `data/`.
- **`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) :
- **Signature** et **Exclusions** : tirées des faits et des commandes du rapport à l'aveugle. Les critères sont observables, relatifs au niveau habituel du capteur (MAD), sans nom de capteur ni seuil absolu ; leurs commandes gardent les vrais noms, pour se rejouer. Chaque exclusion se vérifie avec les outils ;
- **Signature** et **Exclusions** : tirées des faits et des commandes du rapport à l'aveugle. Les critères sont observables, relatifs au niveau habituel du capteur (MAD), sans nom de capteur ni seuil absolu ; leurs commandes s'écrivent avec les vrais noms, pour se rejouer ; l'anonymisation les code ensuite. Chaque exclusion se vérifie avec les outils ;
- **Diagnostic de l'expert** : avec ses mots ; la cause est aussi rapportée à la liste fermée du rapport (buée ou eau, occlusion, turbulence, éclairage, inconnue) ;
- **Attendu de l'agent** : ce qu'il doit dire sur ces données sans ce cas dans l'index (le passage à l'aveugle), puis avec ;
- **Preuves** : copie les PNG du rapport à côté de `cas.md` et regarde chacun ;
- **Preuves** : refais les figures du rapport avec leurs commandes, dans le dossier du cas et avec `--alias` (skill `anonymiser-cas`, étape 2), puis regarde chacune ;
- **Test à l'aveugle** : le chemin du rapport et le tableau de 4.3.
- **Ligne d'index** : `| [C-xxx](C-xxx_<STATION>_<date>/cas.md) | <Station> · <fenêtre UTC> | <signature courte, observable> | <classification> | <cause de l'expert> | <conséquence, action> |`. 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` : station et capteurs deviennent des codes (`S01`, `R1`, `C1`), le dossier devient `C-xxx_<code>_<date>` (D-049).
- **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/` et le rapport, avec le message `Add case C-xxx to the diagnostic case base` ; l'arbre est alors propre.
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.
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. Consigne le résultat dans « Test à l'aveugle » de la fiche, même s'il réussit du premier coup, puis commite par chemin la fiche et le second rapport (`Record the C-xxx match test`).
+4 -4
View File
@@ -15,12 +15,12 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
- **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 pour une station (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 ; 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)** : pilote de l'enquête à la demande (D-042) dans Claude Code : 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, vide : un cas n'y entre que sur demande explicite de l'utilisateur (skill `/nouveau-cas`). L'enquête par API (D-042) reste un document.
- **Agent de diagnostic (D-046)** : pilote de l'enquête à la demande (D-042) dans Claude Code : 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 : un cas, C-001 (PS des Coudres, brume sur deux références la nuit du 13 au 14/10, système sain), noms codés (D-049, skill `anonymiser-cas`) ; un cas n'y entre que sur demande explicite de l'utilisateur (skill `/nouveau-cas`). L'enquête par API (D-042) reste un document.
- **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.
- **Prochaine étape** : `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 : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) et voit avec le spécialiste si les pics de `REF_G` et `REF_D` biaisent la compensation (marche de `corr_x` de BJ_G) ; premiers cas de la base, quand l'utilisateur les apporte et le demande.
- **Prochaine étape** : `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 : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) et voit avec le spécialiste si les pics de `REF_G` et `REF_D` biaisent la compensation (marche de `corr_x` de BJ_G) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande.
## Analyses (domaine Energy)
@@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
### Fichiers
- `README.md` (40 l) : point d'entrée pour un humain.
- `docs/decisions.md` (542 l, D-001 à D-048) : 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/decisions.md` (552 l, D-001 à D-049) : 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.
@@ -144,7 +144,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- `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/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `settings.json` (lecture de `.env` interdite).
- `.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/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/anonymiser-cas/` (noms des cas en codes, registre des codes, D-049), `settings.json` (lecture de `.env` interdite).
- `.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 le modifier sans demande.
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014).
Binary file not shown.

After

Width:  |  Height:  |  Size: 124 KiB

@@ -1,17 +1,17 @@
# C-001 : deux références voilées la nuit par la brume, mesures saines
PS_DES_COUDRES · data/PS_DES_COUDRES/ · 2026-10-13T23:30Z → 2026-10-14T05:30Z UTC · avis de l'expert du 2026-10-14 · entré le 2026-10-14
S01 · data/S01/ · 2026-10-13T20:00Z → 2026-10-14T08:00Z UTC · avis de l'expert du 2026-10-14 · entré le 2026-10-14
## Symptôme
L'`error_value` de certaines références varie fortement et soudainement, la nuit, alors que les déplacements des cibles ne bougent pas.
## 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 en moins d'une heure : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne error_value --pas 15min --capteurs REF_CT,REF_D,REF_G --debut 2026-10-13T23:30Z --fin 2026-10-14T05:30Z`
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 en moins d'une heure : `python3 agents/diagnostic/outils/resume.py data/S01/ --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 data/PS_DES_COUDRES/ --colonne error_value --stat max --pas 6h --debut 2026-10-13T23:30Z --fin 2026-10-14T05:30Z`
4. Positions brutes des cibles sans marche : aucun pas de 15 min de `relative_x` ou `relative_y` hors de leur dispersion habituelle (ici 4 MAD au plus), y compris quand les références reviennent : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --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, si elles existent : 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 data/PS_DES_COUDRES/ --capteurs REF_G,REF_D,REF_CT,BJ_G --heures 2026-10-14T02:00Z,2026-10-14T04:00Z,2026-10-14T05: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 agents/diagnostic/outils/resume.py data/S01/ --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). À l'aube, toutes les positions bougent ensemble (ici jusqu'à 9 MAD) : c'est le cycle jour/nuit, pas ce cas : `python3 agents/diagnostic/outils/resume.py data/S01/ --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, si elles existent : 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 data/S01/ --capteurs R3,R2,R1,C3 --heures 2026-10-13T22:00Z,2026-10-14T02:00Z,2026-10-14T04:00Z,2026-10-14T06:00Z`
## Exclusions
Ce qui ferait que ce n'est pas ce cas :
@@ -33,17 +33,17 @@ Ce qui ferait que ce n'est pas ce cas :
## Inconnus
- La brume est déduite, pas vue : il n'y a pas de météo, et l'image de 02:00 ne montre pas de brouillard général. De la rosée ou de la buée sur les réflecteurs reste possible.
- Un petit effet reste à confirmer avec le spécialiste. Les centroïdes bruts des références touchées se décalent un peu, de 0,1 à 0,3 px (un pas de 12 MAD au retour de l'une). Aux mêmes instants, `corr_x` de quelques cibles saute puis revient : +0,18 puis −0,33 pour BJ_G, +0,12 puis −0,18 pour PBJ_C, leurs minimums de la période. **Question au spécialiste** : ces sauts de la compensation sont-ils négligeables ? Sinon, la classification devient *camera/reference compensation event*.
- Un petit effet reste à confirmer avec le spécialiste. Les centroïdes bruts des références touchées se décalent un peu, de 0,1 à 0,3 px (un pas de 12 MAD au retour de l'une). Aux mêmes instants, `corr_x` de quelques cibles saute puis revient : +0,18 puis −0,33 pour C3, +0,12 puis −0,18 pour C7, leurs minimums de la période. **Question au spécialiste** : ces sauts de la compensation sont-ils négligeables ? Sinon, la classification devient *camera/reference compensation event*.
## Preuves
![error_value et relative_x des références et de deux cibles témoins, épisode grisé](PS_DES_COUDRES_error_value-relative_x_REF_G-REF_D-REF_CT-BJ_G-BL_D_20261013T2330Z_20261014T0530Z.png)
*REF_G et REF_D montent seules, REF_CT, BJ_G et BL_D restent plates. En bas, seule REF_G se décale un peu, puis revient avec son error_value.*
![error_value et relative_x des références et de deux cibles témoins, épisode grisé](S01_error_value-relative_x_R3-R2-R1-C3-C5_20261013T2000Z_20261014T0800Z.png)
*R3 et R2 montent seules, la nuit, puis reviennent ; R1, C3 et C5 restent plates. En bas, seule R3 se décale un peu pendant l'épisode, puis revient avec son error_value.*
![vignettes de REF_G, REF_D, REF_CT et BJ_G à 02:00, 04:00 et 05:00](PS_DES_COUDRES_vignettes_REF_G-REF_D-REF_CT-BJ_G_140200-140400-140500.png)
*À 02:00, REF_G et REF_D sont réduites à un point. À 04:00, REF_G est revenue et REF_D pas encore ; à 05:00, REF_D revient. REF_CT et BJ_G ne changent pas.*
![vignettes de R3, R2, R1 et C3 à 22:00, 02:00, 04:00 et 06:00](S01_vignettes_R3-R2-R1-C3_132200-140200-140400-140600.png)
*À 22:00, avant l'épisode, les quatre taches ont leur taille habituelle. À 02:00, R3 et R2 sont réduites à un point ; à 04:00, R3 est revenue et R2 pas encore. À 06:00, l'aube éclaire le fond et les tailles ne se comparent plus ; l'`error_value` de R2 est revenue à 05:30. R1 et C3 ne changent pas.*
## Test à l'aveugle
Rapport : `agents/diagnostic/rapports/2026-10-14T1528Z_PS_DES_COUDRES_nuit-13-14/`, question « que s'est-il passé du 2026-10-13 20:00 au 2026-10-14 08:00 (UTC) ? », sur un index vide. La fenêtre du cas a été resserrée ensuite à la demande de l'utilisateur, et les figures refaites sur cette fenêtre.
Rapport : `agents/diagnostic/rapports/2026-10-14T1528Z_S01_nuit-13-14/`, question « que s'est-il passé du 2026-10-13 20:00 au 2026-10-14 08:00 (UTC) ? », sur un index vide. La fenêtre du cas est celle de la question.
| Attendu | Résultat |
|---|---|
@@ -56,7 +56,7 @@ Rapport : `agents/diagnostic/rapports/2026-10-14T1528Z_PS_DES_COUDRES_nuit-13-14
L'attendu 3 n'est pas corrigé dans `instructions.md` : les sauts existent, et c'est leur importance qui fait débat. Ce jugement métier n'est pas confirmé (voir « Inconnus », question au spécialiste).
**Test de correspondance (2026-10-14).** Même question, avec le cas dans l'index. Rapport : `agents/diagnostic/rapports/2026-10-14T1538Z_PS_DES_COUDRES_nuit-13-14/`. Réussi au premier essai :
**Test de correspondance (2026-10-14).** Même question, avec le cas dans l'index. Rapport : `agents/diagnostic/rapports/2026-10-14T1538Z_S01_nuit-13-14/`. Réussi au premier essai :
- correspondance : « C-001, complète », critères 1 à 5 vérifiés, exclusions écartées ;
- diagnostic : *target-local degradation* `strongly supported`, buée ou eau `possible` ;
- conséquence « aucune » (la règle d'asymétrie tient : correspondance complète, mouvement réel réfuté par les positions brutes), action « aucune ».
+2 -2
View File
@@ -1,7 +1,7 @@
# Cas connus
Incidents validés par l'expert, un par ligne. La **Signature** résume ce qu'on observe : type de capteurs, combien, colonne, forme, moment, durée, retour à la normale. Ouvre la fiche d'un cas proche par son lien ; ses critères et ses exclusions se vérifient avec tes outils, sur tes données.
Incidents validés par l'expert, un par ligne. La **Signature** résume ce qu'on observe : type de capteurs, combien, colonne, forme, moment, durée, retour à la normale. Ouvre la fiche d'un cas proche par son lien ; ses critères et ses exclusions se vérifient avec tes outils, sur tes données. Les noms y sont codés (`S01` une station, `R1` une référence, `C1` une cible) : rapporte chaque critère à tes capteurs du même rôle, jamais à un nom.
| Cas | Station · fenêtre (UTC) | Signature | Classification | Cause (expert) | Verdict expert |
|---|---|---|---|---|---|
| [C-001](C-001_PS_DES_COUDRES_2026-10-13/cas.md) | PS des Coudres · 2026-10-13T23:30Z → 2026-10-14T05:30Z | Une partie des références (2 sur 3) : `error_value` à plusieurs dizaines de MAD, la nuit, quelques heures, puis retour ; autre référence et cibles intactes ; positions brutes des cibles sans marche | *target-local degradation* | brume (buée ou eau), inférée | aucune, aucune |
| [C-001](C-001_S01_2026-10-13/cas.md) | S01 · 2026-10-13T20:00Z → 2026-10-14T08:00Z | Une partie des références (2 sur 3) : `error_value` à plusieurs dizaines de MAD, la nuit, quelques heures, puis retour ; autre référence et cibles intactes ; positions brutes des cibles sans marche | *target-local degradation* | brume (buée ou eau), inférée | aucune, aucune |
+6 -3
View File
@@ -2,7 +2,7 @@
Usage : .venv/bin/python agents/diagnostic/outils/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]
[--zone DEBUT/FIN ...] [--sortie DOSSIER] [--alias NOM=CODE,...]
Un panneau par colonne, une courbe par capteur, heures UTC ; chaque --zone est grisée.
Imprime le chemin du PNG (out/diagnostic/, ou --sortie : le dossier du rapport, pour une figure de preuve).
"""
@@ -43,7 +43,9 @@ def main():
a.add_argument("--fin", type=instant)
a.add_argument("--zone", type=zone, action="append", default=[], help="fenêtre à griser, DEBUT/FIN (répétable)")
a.add_argument("--sortie", default=os.path.join(RACINE, "out", "diagnostic"), help="dossier du PNG")
a.add_argument("--alias", help="NOM=CODE,... : codes à la place des noms (skill anonymiser-cas)")
o = a.parse_args()
alias = dict(p.split("=", 1) for p in o.alias.split(",")) if o.alias else {}
par = charger(o.dossier)
if not par:
@@ -70,7 +72,7 @@ def main():
for i, s in enumerate(noms):
ms = series[s] # une valeur vide devient NaN : la courbe s'interrompt au lieu de relier le trou
ax.plot([m["t"] for m in ms], [float("nan") if m[col] is None else m[col] for m in ms], ".-", ms=2, lw=0.7,
color=couleurs[i % len(couleurs)], label=s)
color=couleurs[i % len(couleurs)], label=alias.get(s, s))
for debut, fin in o.zone:
ax.axvspan(debut, fin, color="0.85", zorder=0)
ax.set_ylabel(col)
@@ -78,10 +80,11 @@ def main():
axes[0, 0].legend(loc="upper left", bbox_to_anchor=(1.0, 1.0), fontsize=8)
axes[-1, 0].xaxis.set_major_formatter(mdates.DateFormatter("%d/%m\n%H:%MZ"))
station = os.path.basename(os.path.normpath(o.dossier))
station = alias.get(station, station)
fig.suptitle(f"{station} : {', '.join(colonnes)} (heures UTC)")
os.makedirs(o.sortie, exist_ok=True)
qui = "-".join(noms) if o.capteurs else "tous"
qui = "-".join(alias.get(s, s) for s in noms) if o.capteurs else "tous"
sortie = os.path.join(o.sortie, f"{station}_{'-'.join(colonnes)}_{qui}_"
f"{borne(o.debut, 'debut')}_{borne(o.fin, 'fin')}.png")
fig.savefig(sortie, dpi=100, bbox_inches="tight")
+6 -3
View File
@@ -1,7 +1,7 @@
"""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/
--capteurs REF_G,REF_D --heures 2026-10-13T22:00Z,2026-10-14T02:00Z [--rayon 100] [--sortie DOSSIER]
--capteurs REF_G,REF_D --heures 2026-10-13T22:00Z,2026-10-14T02:00Z [--rayon 100] [--sortie DOSSIER] [--alias NOM=CODE,...]
Une ligne par capteur, une colonne par heure. Chaque vignette est centrée sur la position brute (x, y) du capteur
dans l'export « advanced », lue à la mesure la plus proche de l'image ; les pixels ne sont pas retouchés, l'éclat
se compare donc d'une vignette à l'autre. Imprime les positions utilisées, puis le chemin du PNG.
@@ -27,7 +27,9 @@ def main():
a.add_argument("--heures", required=True, help="heures des images, séparées par des virgules (UTC)")
a.add_argument("--rayon", type=int, default=100, help="demi-côté de la vignette en pixels (défaut 100)")
a.add_argument("--sortie", default=os.path.join(RACINE, "out", "diagnostic"), help="dossier du PNG")
a.add_argument("--alias", help="NOM=CODE,... : codes à la place des noms (skill anonymiser-cas)")
o = a.parse_args()
alias = dict(p.split("=", 1) for p in o.alias.split(",")) if o.alias else {}
par = charger(o.dossier)
images = {heure_image(p): p for p in trouver(o.dossier)["images"]}
@@ -51,14 +53,15 @@ def main():
print(f"{s} {iso(h)} : x={m['x']:.1f} y={m['y']:.1f} (mesure de {iso(m['t'])}), {os.path.basename(images[h])}")
ax = axes[i, j]
ax.imshow(img[max(y - r, 0):y + r, max(x - r, 0):x + r], interpolation="nearest")
ax.set_title(f"{s} {h.strftime('%d/%m %H:%MZ')}", fontsize=9)
ax.set_title(f"{alias.get(s, s)} {h.strftime('%d/%m %H:%MZ')}", fontsize=9)
ax.set_xticks([])
ax.set_yticks([])
station = os.path.basename(os.path.normpath(o.dossier))
station = alias.get(station, station)
fig.suptitle(f"{station} : vignettes de {2 * r} px autour de chaque capteur (heures UTC)", fontsize=10)
os.makedirs(o.sortie, exist_ok=True)
sortie = os.path.join(o.sortie, f"{station}_vignettes_{'-'.join(noms)}_"
sortie = os.path.join(o.sortie, f"{station}_vignettes_{'-'.join(alias.get(s, s) for s in noms)}_"
f"{'-'.join(h.strftime('%d%H%M') for h in heures)}.png")
fig.savefig(sortie, dpi=100, bbox_inches="tight")
print(sortie)
+4 -3
View File
@@ -229,7 +229,7 @@ La plage sélectionnée par « Analyze » est le mode question actuel (§4) rest
```
agents/diagnostic/cas/
INDEX.md la table : seule porte d'entrée de l'agent
C-001_<STATION>_<AAAA-MM-JJ>/ un dossier par incident (numéro, station, date de début)
C-001_<S01>_<AAAA-MM-JJ>/ un dossier par incident (numéro, code de la station, date de début)
cas.md la fiche
*.png ses figures de preuve
```
@@ -239,6 +239,7 @@ agents/diagnostic/cas/
- Le numéro `C-xxx` est la référence stable que cite le rapport.
- Un cas n'entre dans l'index qu'une fois validé par l'expert : pas de colonne de statut. L'agent n'ouvre que les fiches que cite l'index.
- La base démarre vide : `INDEX.md` n'a que son en-tête.
- **Noms codés (D-049)** : dans l'index, les fiches et leurs figures, la station devient `S01`, une référence `R1`, une cible `C1`. Les codes sont stables d'un cas à l'autre et tenus dans le registre du skill `anonymiser-cas`, que l'agent ne lit pas. L'agent rapproche ainsi par la signature, pas par le nom.
### 11.2 L'index
@@ -246,7 +247,7 @@ Une ligne par incident. La colonne **Signature** sert à la recherche : courte,
| Cas | Station · fenêtre (UTC) | Signature | Classification | Cause (expert) | Verdict expert |
|---|---|---|---|---|---|
| *exemple :* C-001 | PS des Coudres · 13/10 01:15 → 14/10 05:00 | 2 références sur 3, `error_value` ×5-8, la nuit, 3-5 h, retour seul ; cibles et 3e référence intactes | *camera/reference compensation event* | inconnue | sain, point d'attention |
| *exemple :* C-001 | S01 · 13/10 01:15 → 14/10 05:00 | 2 références sur 3, `error_value` ×5-8, la nuit, 3-5 h, retour seul ; cibles et 3e référence intactes | *camera/reference compensation event* | inconnue | sain, point d'attention |
### 11.3 La fiche (`cas.md`)
@@ -326,7 +327,7 @@ Procédure tenue par `.claude/skills/nouveau-cas/SKILL.md`, avec `disable-model-
2. **Ranger** les données (D-029, D-045) : export dans `data/<STATION>/displacement/`, images renommées en UTC (`<AAAAMMJJ>T<HHMM>Z_<n>.jpg`) ; contrôle par `inventaire.py`.
3. **Commit neutre** (rien sur l'incident ni sa cause : le sous-agent reçoit les derniers messages de commit et la branche), arbre propre.
4. **Passage à l'aveugle**, la fenêtre de l'incident pour question, comparé à des attendus écrits avant ; un attendu manqué se corrige dans `instructions.md` par une règle générale.
5. **Fiche** (signature tirée du rapport, diagnostic de l'expert, figures copiées) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
5. **Fiche** (signature tirée du rapport, diagnostic de l'expert, figures refaites, noms codés par le skill `anonymiser-cas`, D-049) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
6. **Test de correspondance** : l'agent relancé, le cas dans l'index, doit trouver `C-xxx, complète` (ou partielle) et le diagnostic de l'expert. Il vérifie la mécanique, pas le jugement : l'agent a lu la fiche.
Un cas ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index est le registre.
+10
View File
@@ -540,3 +540,13 @@ Règles du journal :
- **Pourquoi** : demande de l'utilisateur : le diagnostic marche mais manque de déterminisme ; l'agent reçoit tout et peut conclure hors sujet. Usage visé : un bouton « Analyze » sur une plage sélectionnée, dont il faut contrôler la sortie. Ancrer le verdict sur des cas validés suit le §17 du contexte support (*historical cases used like software tests*). Choix de l'utilisateur sur proposition : index lu par l'agent, une fiche par incident, cas reçus avec l'avis de l'expert, hypothèses « non validé » hors cas.
- **Options écartées** : RAG vectorielle (inutile à quelques dizaines de cas ; deux cas se ressemblent par leur signature, pas par leur texte ; service d'embeddings tiers) ; fiches dans les instructions (ancrage avant les données) ; une fiche par type ; toujours le cas le plus proche (ancrage) ; faits seuls hors cas (le support repart de zéro).
- **Conséquence** : un cas est aussi un test de régression (retirer sa ligne de l'index pour le rejouer) ; filtre structuré ou RAG quand l'index ne tiendra plus en une lecture ou que la question arrivera en texte libre.
## D-049 — 2026-10-14 — Base de cas : noms de station et de capteurs codés
- **Statut** : active (skill `anonymiser-cas`, appelé à l'étape 5 de `/nouveau-cas`) ; appliquée à C-001.
- **Décision** :
- dans `agents/diagnostic/cas/` (index, fiches, noms de fichiers, figures), la station devient `S01`, une référence `R1`, une cible `C1` (numérotation par station) ;
- un registre unique, `.claude/skills/anonymiser-cas/registre.csv`, ne fait que grandir : un nom garde son code d'un cas à l'autre ; l'agent ne le lit pas ;
- un script en bibliothèque standard (`anonymiser.py`) attribue les codes, réécrit les textes, renomme les fichiers et s'arrête s'il reste un nom réel ; `graphique.py` et `vignettes.py` prennent une option `--alias` pour tracer avec les codes.
- **Pourquoi** : demande de l'utilisateur : ne pas influencer l'agent par le nom du site, des cibles ou des références ; il doit rapprocher un cas par sa signature, et une anonymisation constante se fait mieux par un skill que par des choix au cas par cas.
- **Options écartées** : codes propres à chaque cas (pas de constance d'un cas à l'autre) ; codes qui gardent un sens (`REF_GAUCHE`) ; rendre les images floues ou les masquer (preuves perdues) ; anonymiser `rapports/` (l'agent ne les lit pas).
- **Conséquence** : les commandes d'une fiche portent des codes et se rejouent avec le registre ; les images montrent encore le site.