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/`. - **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) : - **`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) ; - **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 ; - **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. - **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.* ». - **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)`. - **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. - **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 ## 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. 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`). 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). - **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. - **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. - **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/`. - **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`. - **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`. - **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. - **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) ## Analyses (domaine Energy)
@@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
### Fichiers ### Fichiers
- `README.md` (40 l) : point d'entrée pour un humain. - `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. - `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. - `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. - `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). - `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). - `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). - `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. - `.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. - `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). - `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 # 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 ## 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. 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 ## Signature
Critères observables, relatifs au niveau habituel du capteur, chacun avec sa commande : 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. 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` 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. 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`) 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/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` 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 ## Exclusions
Ce qui ferait que ce n'est pas ce cas : 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 ## 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. - 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 ## 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) ![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)
*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.* *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) ![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)
*À 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.* *À 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 ## 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 | | 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). 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 ; - 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` ; - 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 ». - 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 # 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 | | 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/ 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 ...] [--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. 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). 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("--fin", type=instant)
a.add_argument("--zone", type=zone, action="append", default=[], help="fenêtre à griser, DEBUT/FIN (répétable)") 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("--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() o = a.parse_args()
alias = dict(p.split("=", 1) for p in o.alias.split(",")) if o.alias else {}
par = charger(o.dossier) par = charger(o.dossier)
if not par: if not par:
@@ -70,7 +72,7 @@ def main():
for i, s in enumerate(noms): for i, s in enumerate(noms):
ms = series[s] # une valeur vide devient NaN : la courbe s'interrompt au lieu de relier le trou 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, 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: for debut, fin in o.zone:
ax.axvspan(debut, fin, color="0.85", zorder=0) ax.axvspan(debut, fin, color="0.85", zorder=0)
ax.set_ylabel(col) 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[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")) axes[-1, 0].xaxis.set_major_formatter(mdates.DateFormatter("%d/%m\n%H:%MZ"))
station = os.path.basename(os.path.normpath(o.dossier)) station = os.path.basename(os.path.normpath(o.dossier))
station = alias.get(station, station)
fig.suptitle(f"{station} : {', '.join(colonnes)} (heures UTC)") fig.suptitle(f"{station} : {', '.join(colonnes)} (heures UTC)")
os.makedirs(o.sortie, exist_ok=True) 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}_" sortie = os.path.join(o.sortie, f"{station}_{'-'.join(colonnes)}_{qui}_"
f"{borne(o.debut, 'debut')}_{borne(o.fin, 'fin')}.png") f"{borne(o.debut, 'debut')}_{borne(o.fin, 'fin')}.png")
fig.savefig(sortie, dpi=100, bbox_inches="tight") 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. """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 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 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 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. 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("--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("--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("--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() o = a.parse_args()
alias = dict(p.split("=", 1) for p in o.alias.split(",")) if o.alias else {}
par = charger(o.dossier) par = charger(o.dossier)
images = {heure_image(p): p for p in trouver(o.dossier)["images"]} 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])}") 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 = axes[i, j]
ax.imshow(img[max(y - r, 0):y + r, max(x - r, 0):x + r], interpolation="nearest") 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_xticks([])
ax.set_yticks([]) ax.set_yticks([])
station = os.path.basename(os.path.normpath(o.dossier)) 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) fig.suptitle(f"{station} : vignettes de {2 * r} px autour de chaque capteur (heures UTC)", fontsize=10)
os.makedirs(o.sortie, exist_ok=True) 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") f"{'-'.join(h.strftime('%d%H%M') for h in heures)}.png")
fig.savefig(sortie, dpi=100, bbox_inches="tight") fig.savefig(sortie, dpi=100, bbox_inches="tight")
print(sortie) 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/ agents/diagnostic/cas/
INDEX.md la table : seule porte d'entrée de l'agent 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 cas.md la fiche
*.png ses figures de preuve *.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. - 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. - 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. - 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 ### 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 | | 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`) ### 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`. 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. 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. 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. 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. 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. - **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). - **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. - **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.