diff --git a/.claude/skills/anonymiser-cas/SKILL.md b/.claude/skills/anonymiser-cas/SKILL.md new file mode 100644 index 0000000..d6357db --- /dev/null +++ b/.claude/skills/anonymiser-cas/SKILL.md @@ -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// agents/diagnostic/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// --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 ` et `--alias ""`. 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// agents/diagnostic/cas//` : + - réécrit les `.md` du cas et `cas/INDEX.md` ; + - renomme les fichiers et le dossier (`C-xxx_S01_`) ; + - 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/_*`. +- 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`. diff --git a/.claude/skills/anonymiser-cas/anonymiser.py b/.claude/skills/anonymiser-cas/anonymiser.py new file mode 100644 index 0000000..0d8a531 --- /dev/null +++ b/.claude/skills/anonymiser-cas/anonymiser.py @@ -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// agents/diagnostic/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// --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"(?_/`, `` é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__/cas.md) | · | | | | |`. 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__` (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`). diff --git a/CLAUDE.md b/CLAUDE.md index ab01220..eea9fce 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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/_/` : 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/_/` : 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). diff --git a/agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/PS_DES_COUDRES_error_value-relative_x_REF_G-REF_D-REF_CT-BJ_G-BL_D_20261013T2330Z_20261014T0530Z.png b/agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/PS_DES_COUDRES_error_value-relative_x_REF_G-REF_D-REF_CT-BJ_G-BL_D_20261013T2330Z_20261014T0530Z.png deleted file mode 100644 index e932f32..0000000 Binary files a/agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/PS_DES_COUDRES_error_value-relative_x_REF_G-REF_D-REF_CT-BJ_G-BL_D_20261013T2330Z_20261014T0530Z.png and /dev/null differ diff --git a/agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/PS_DES_COUDRES_vignettes_REF_G-REF_D-REF_CT-BJ_G_140200-140400-140500.png b/agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/PS_DES_COUDRES_vignettes_REF_G-REF_D-REF_CT-BJ_G_140200-140400-140500.png deleted file mode 100644 index 53aabfe..0000000 Binary files a/agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/PS_DES_COUDRES_vignettes_REF_G-REF_D-REF_CT-BJ_G_140200-140400-140500.png and /dev/null differ diff --git a/agents/diagnostic/cas/C-001_S01_2026-10-13/S01_error_value-relative_x_R3-R2-R1-C3-C5_20261013T2000Z_20261014T0800Z.png b/agents/diagnostic/cas/C-001_S01_2026-10-13/S01_error_value-relative_x_R3-R2-R1-C3-C5_20261013T2000Z_20261014T0800Z.png new file mode 100644 index 0000000..94115d9 Binary files /dev/null and b/agents/diagnostic/cas/C-001_S01_2026-10-13/S01_error_value-relative_x_R3-R2-R1-C3-C5_20261013T2000Z_20261014T0800Z.png differ diff --git a/agents/diagnostic/cas/C-001_S01_2026-10-13/S01_vignettes_R3-R2-R1-C3_132200-140200-140400-140600.png b/agents/diagnostic/cas/C-001_S01_2026-10-13/S01_vignettes_R3-R2-R1-C3_132200-140200-140400-140600.png new file mode 100644 index 0000000..ff36f54 Binary files /dev/null and b/agents/diagnostic/cas/C-001_S01_2026-10-13/S01_vignettes_R3-R2-R1-C3_132200-140200-140400-140600.png differ diff --git a/agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/cas.md b/agents/diagnostic/cas/C-001_S01_2026-10-13/cas.md similarity index 68% rename from agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/cas.md rename to agents/diagnostic/cas/C-001_S01_2026-10-13/cas.md index c9ea4e6..c16777b 100644 --- a/agents/diagnostic/cas/C-001_PS_DES_COUDRES_2026-10-13/cas.md +++ b/agents/diagnostic/cas/C-001_S01_2026-10-13/cas.md @@ -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 ». diff --git a/agents/diagnostic/cas/INDEX.md b/agents/diagnostic/cas/INDEX.md index e18c649..ad4825f 100644 --- a/agents/diagnostic/cas/INDEX.md +++ b/agents/diagnostic/cas/INDEX.md @@ -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 | diff --git a/agents/diagnostic/outils/graphique.py b/agents/diagnostic/outils/graphique.py index 2bcdd32..1676fcd 100644 --- a/agents/diagnostic/outils/graphique.py +++ b/agents/diagnostic/outils/graphique.py @@ -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") diff --git a/agents/diagnostic/outils/vignettes.py b/agents/diagnostic/outils/vignettes.py index 895c515..58e43be 100644 --- a/agents/diagnostic/outils/vignettes.py +++ b/agents/diagnostic/outils/vignettes.py @@ -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) diff --git a/docs/agents/agent-diagnostic.md b/docs/agents/agent-diagnostic.md index a5fe44b..c1c5787 100644 --- a/docs/agents/agent-diagnostic.md +++ b/docs/agents/agent-diagnostic.md @@ -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__/ un dossier par incident (numéro, station, date de début) + C-001__/ 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//displacement/`, images renommées en UTC (`TZ_.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. diff --git a/docs/decisions.md b/docs/decisions.md index 68787c0..27b757d 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -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.