Fix review findings in the diagnostic agent tools and instructions

Inclusive --fin at the displayed minute, UTC for naive time_utc, neutral examples,
5-significant-digit values, 'vide' vs '-' cells, no empty or gap-bridging plots,
timestamped report names, and an up-to-date CLAUDE.md next step.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-14 15:35:44 +02:00
1 parent fcc01d2d68
commit 4b937da95b
6 files changed
+31 -23

No files matched your search

+3 -3
View File
@@ -15,12 +15,12 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025).
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
- **Séries optiques (D-044)** : détecter les événements externes (occlusion, pluie, turbulence) dans les déplacements et produire une courbe corrigée, la brute gardée ; cadrage (`docs/displacement/cadrage.md`) ; données reçues pour une station (D-045) : PS des Coudres, export 15 min en UTC sur 5,5 jours, sans événement annoté (buée probable le matin), et 24 images horaires de la caméra ; 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 dans `agents/diagnostic/rapports/` ; déplacements et images seulement. 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 dans `agents/diagnostic/rapports/` ; déplacements et images seulement ; testé à l'aveugle sur PS des Coudres, deux rapports à valider. 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, 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 : test à l'aveugle sur PS des Coudres (§7 de sa spec), puis validation du rapport par l'utilisateur.
- **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 les deux rapports de PS des Coudres (points à valider au §7 de sa spec : classification, effet sur les cibles, cycle de `corr_y`).
## Analyses (domaine Energy)
+4 -4
View File
@@ -36,7 +36,7 @@ Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdi
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T]` | Un PNG des séries ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
| `ls <dossier>/images/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image de la caméra à cette heure (UTC). Les colonnes `x` et `y` (pixels) situent chaque capteur sur l'image |
Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne sert qu'à lancer ces outils, `ls`, `grep`, `pdftotext` et `date`, une commande simple par appel (pas de boucle `for`) : les permissions sont accordées commande par commande. N'écris aucun autre script.
Instants : `2026-01-01T00:00Z` (une heure sans fuseau est lue en UTC ; `--fin` inclut la minute indiquée). Bash ne sert qu'à lancer ces outils, `ls`, `grep`, `pdftotext` et `date`, une commande par appel, sans boucle `for` (un tube vers `grep` est permis) : les permissions sont accordées commande par commande. N'écris aucun autre script.
## 4. Déroulé
@@ -68,7 +68,7 @@ Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne s
## 6. Le rapport
Écris-le dans `agents/diagnostic/rapports/<AAAA-MM-JJ>_<STATION>.md` (date du jour en UTC : `date -u +%F` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJ>_<STATION>_<sujet>.md`. Si le fichier existe, ajoute `_2`, `_3`…
Écris-le dans `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>.md` (instant présent en UTC : `date -u +%Y-%m-%dT%H%MZ` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJTHHMMZ>_<STATION>_<sujet>.md`. Ne liste pas `rapports/` : l'heure dans le nom suffit à éviter un doublon.
```markdown
# Diagnostic <STATION> : <scan | sujet de la question>
@@ -88,7 +88,7 @@ Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne s
## Événements
### E1 : <titre court> (<début> → <fin> UTC)
- **Classification** : une de : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation*, problème système, rien d'anormal, indéterminé
- **Classification** : la principale (une seconde si elle s'applique aussi), parmi : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation*, problème système, rien d'anormal, indéterminé
- **Cause probable** : buée ou eau | occlusion | turbulence | éclairage | inconnue (seulement pour une cause externe à l'ouvrage)
- **Couche** : la couche de la chaîne de dépendance (section 4 du contexte support)
- **Niveau de preuve** : …
@@ -97,7 +97,7 @@ Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne s
- **Réfutation** : hypothèse principale ; fait cherché pour la contredire ; résultat (`<commande>`)
- **Alternatives** : autres explications, et pourquoi elles ne sont pas écartées
- **Inconnus** : …
- **Prochaine vérification** : la plus discriminante
- **Prochaine vérification** : la plus discriminante : une donnée à obtenir ou une observation à faire par un humain ; pas de nouveau réglage chiffré (seuil) sans source
## Constats permanents
- <ce qui dure toute la période, ex. un capteur toujours rejeté>
+5 -4
View File
@@ -52,7 +52,7 @@ def charger(dossier):
with open(chemin, newline="") as f:
for r in csv.DictReader(f):
m = {c: _nombre(r[c]) for c in NUM}
m["t"] = datetime.fromisoformat(r["time_utc"]).astimezone(timezone.utc)
m["t"] = instant(r["time_utc"])
m["pattern_type"] = r["pattern_type"]
par.setdefault(r["sensor_name"], {})[m["t"]] = m
return {s: [d[t] for t in sorted(d)] for s, d in par.items()}
@@ -69,8 +69,9 @@ def rejetee(m):
def filtrer(mesures, debut, fin):
"""Mesures entre debut et fin inclus ; None = pas de borne."""
return [m for m in mesures if (debut is None or m["t"] >= debut) and (fin is None or m["t"] <= fin)]
"""Mesures entre debut et fin inclus, à la minute près (comme iso() les affiche) ; None = pas de borne."""
return [m for m in mesures if (debut is None or m["t"] >= debut)
and (fin is None or m["t"].replace(second=0, microsecond=0) <= fin)]
def heure_image(chemin):
@@ -80,7 +81,7 @@ def heure_image(chemin):
def instant(texte):
"""'2026-10-13T23:00Z' ou '2026-10-13 23:00' -> datetime UTC ; une heure sans fuseau est lue en UTC."""
"""'2026-01-01T00:00Z' ou '2026-01-01 00:00' -> datetime UTC ; une heure sans fuseau est lue en UTC."""
t = datetime.fromisoformat(texte)
return t.astimezone(timezone.utc) if t.tzinfo else t.replace(tzinfo=timezone.utc)
+8 -3
View File
@@ -1,7 +1,7 @@
"""Graphique PNG des séries d'un export « advanced », pour que l'agent de diagnostic les regarde.
Usage : .venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/
[--capteurs REF_G,REF_D] [--colonnes error_value,corr_x,corr_y] [--debut ...] [--fin ...]
[--capteurs CAPTEUR_A,CAPTEUR_B] [--colonnes error_value,corr_x,corr_y] [--debut ...] [--fin ...]
Un panneau par colonne, une courbe par capteur, heures UTC. Imprime le chemin du PNG (out/diagnostic/).
"""
import argparse
@@ -45,14 +45,19 @@ def main():
series = {s: filtrer(par[s], o.debut, o.fin) for s in noms}
if not any(series.values()):
sys.exit("Aucune mesure dans la fenêtre demandée.")
vides = [c for c in colonnes if all(m[c] is None for s in noms for m in series[s])]
if len(vides) == len(colonnes):
sys.exit(f"Rien à tracer : {', '.join(colonnes)} vide(s) pour ces capteurs dans la fenêtre.")
if vides:
print(f"Panneaux vides (aucune valeur pour ces capteurs) : {', '.join(vides)}")
fig, axes = plt.subplots(len(colonnes), 1, sharex=True, figsize=(14, 3.2 * len(colonnes)), squeeze=False)
tab20 = plt.get_cmap("tab20").colors
couleurs = tab20[::2] + tab20[1::2] # teintes foncées d'abord : deux capteurs voisins ne partagent pas une teinte
for ax, col in zip(axes[:, 0], colonnes):
for i, s in enumerate(noms):
ms = [m for m in series[s] if m[col] is not None]
ax.plot([m["t"] for m in ms], [m[col] for m in ms], ".-", ms=2, lw=0.7,
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)
ax.set_ylabel(col)
ax.grid(alpha=0.3)
+9 -7
View File
@@ -1,11 +1,12 @@
"""Résumé chiffré compact des séries d'un export « advanced », pour l'agent de diagnostic.
Usage : python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ [--colonne error_value]
[--stat median|min|max] [--pas 1h] [--capteurs REF_G,REF_D] [--debut 2026-10-13T00:00Z] [--fin ...]
[--stat median|min|max] [--pas 1h] [--capteurs CAPTEUR_A,CAPTEUR_B] [--debut 2026-01-01T00:00Z] [--fin ...]
1. Niveau habituel de chaque capteur sur toute la période : médiane, MAD (écart absolu médian), min, max.
2. Tableau : une ligne par pas de temps (début du pas, UTC), une colonne par capteur, la statistique
choisie sur les mesures du pas. « rej » : toutes les mesures du pas sont rejetées ; « - » : aucune mesure.
choisie sur les mesures du pas. « rej » : toutes les mesures du pas sont rejetées ; « vide » : des mesures,
mais la colonne est vide (ex. reproj_err d'une cible) ; « - » : aucune mesure.
Rend des valeurs, pas de verdict.
"""
import argparse
@@ -62,7 +63,7 @@ def main():
sys.exit("Aucune mesure dans la fenêtre demandée.")
print(f"Colonne : {o.colonne}. Niveau habituel sur toute la période (mesures non vides) :")
print(f"{'capteur':10} {'n':>5} {'médiane':>9} {'MAD':>8} {'min':>9} {'max':>9}")
print(f"{'capteur':10} {'n':>5} {'médiane':>10} {'MAD':>10} {'min':>10} {'max':>10}")
for s in noms:
v = valeurs(par[s], o.colonne)
if not v:
@@ -70,19 +71,20 @@ def main():
continue
med = statistics.median(v)
mad = statistics.median(abs(x - med) for x in v)
print(f"{s:10} {len(v):5} {med:9.4f} {mad:8.4f} {min(v):9.4f} {max(v):9.4f}")
print(f"{s:10} {len(v):5} {med:10.5g} {mad:10.5g} {min(v):10.5g} {max(v):10.5g}")
print(f"\n{o.stat} de {o.colonne} par pas de {o.pas} (début du pas, UTC) :")
print(f"{'début':17} " + " ".join(f"{s:>8}" for s in noms))
print("rej : mesures du pas toutes rejetées ; vide : colonne vide ; - : aucune mesure")
print(f"{'début':17} " + " ".join(f"{s:>9}" for s in noms))
for k in sorted(cases):
cellules = []
for s in noms:
ms = cases[k].get(s, [])
v = valeurs(ms, o.colonne)
if v:
cellules.append(f"{STATS[o.stat](v):8.3f}")
cellules.append(f"{STATS[o.stat](v):9.5g}")
else:
cellules.append(f"{'rej' if ms and all(map(rejetee, ms)) else '-':>8}")
cellules.append(f"{'-' if not ms else 'rej' if all(map(rejetee, ms)) else 'vide':>9}")
print(f"{iso(k):17} " + " ".join(cellules))
+2 -2
View File
@@ -92,7 +92,7 @@ et suis-le à la lettre.
## 5. Le rapport
`agents/diagnostic/rapports/<AAAA-MM-JJ>_<STATION>[_<sujet>].md` :
`agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>[_<sujet>].md` (l'heure évite les doublons sans lister les rapports précédents, qui pourraient trahir une conclusion) :
1. **En-tête** : station, données fournies (dossier, période), question ou « scan », date, modèle.
2. **Sources lues** : docs et fichiers ouverts.
@@ -113,7 +113,7 @@ Scripts en ligne de commande. Ils renvoient des valeurs, jamais des verdicts. Bi
| Script | Sortie |
|---|---|
| `inventaire.py <dossier>` | Fichiers par type (« advanced », horaire, images), période, cadence, capteurs (cible ou référence, seuil d'erreur), trous de mesure, points rejetés par capteur, heures couvertes par les images |
| `resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs] [--debut] [--fin]` | Pour une colonne : le niveau habituel de chaque capteur sur la période (médiane, MAD, min, max), puis un tableau, une ligne par pas de temps et une colonne par capteur, avec la statistique choisie ; « rej » quand toutes les mesures du pas sont rejetées |
| `resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs] [--debut] [--fin]` | Pour une colonne : le niveau habituel de chaque capteur sur la période (médiane, MAD, min, max), puis un tableau, une ligne par pas de temps et une colonne par capteur, avec la statistique choisie ; « rej » quand toutes les mesures du pas sont rejetées, « vide » quand la colonne est vide, « - » sans mesure |
| `graphique.py <dossier> [--capteurs] [--colonnes] [--debut] [--fin]` | Un PNG des séries dans `out/diagnostic/`, que l'agent regarde (matplotlib, `.venv`) |
- Un module de lecture de l'export « advanced », partagé par les trois scripts.