From 4b937da95b4ef966781c85be618377963906304d Mon Sep 17 00:00:00 2001 From: maxime Date: Wed, 14 Oct 2026 15:35:44 +0200 Subject: [PATCH] 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 --- CLAUDE.md | 6 +++--- agents/diagnostic/instructions.md | 8 ++++---- agents/diagnostic/outils/donnees.py | 9 +++++---- agents/diagnostic/outils/graphique.py | 11 ++++++++--- agents/diagnostic/outils/resume.py | 16 +++++++++------- docs/agents/agent-diagnostic.md | 4 ++-- 6 files changed, 31 insertions(+), 23 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 08dc708..9458f34 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 ; 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) diff --git a/agents/diagnostic/instructions.md b/agents/diagnostic/instructions.md index 768d3aa..ec8948f 100644 --- a/agents/diagnostic/instructions.md +++ b/agents/diagnostic/instructions.md @@ -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 [--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 /images/`, puis Read sur `TZ_*.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/_.md` (date du jour en UTC : `date -u +%F` ; station : nom du dossier). Avec une question, ajoute un sujet court : `__.md`. Si le fichier existe, ajoute `_2`, `_3`… +Écris-le dans `agents/diagnostic/rapports/_.md` (instant présent en UTC : `date -u +%Y-%m-%dT%H%MZ` ; station : nom du dossier). Avec une question, ajoute un sujet court : `__.md`. Ne liste pas `rapports/` : l'heure dans le nom suffit à éviter un doublon. ```markdown # Diagnostic : @@ -88,7 +88,7 @@ Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne s ## Événements ### E1 : ( → 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 (``) - **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 - diff --git a/agents/diagnostic/outils/donnees.py b/agents/diagnostic/outils/donnees.py index 6fece1a..9106e17 100644 --- a/agents/diagnostic/outils/donnees.py +++ b/agents/diagnostic/outils/donnees.py @@ -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) diff --git a/agents/diagnostic/outils/graphique.py b/agents/diagnostic/outils/graphique.py index 3be48a9..8337d76 100644 --- a/agents/diagnostic/outils/graphique.py +++ b/agents/diagnostic/outils/graphique.py @@ -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) diff --git a/agents/diagnostic/outils/resume.py b/agents/diagnostic/outils/resume.py index c138b81..256a8f6 100644 --- a/agents/diagnostic/outils/resume.py +++ b/agents/diagnostic/outils/resume.py @@ -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)) diff --git a/docs/agents/agent-diagnostic.md b/docs/agents/agent-diagnostic.md index 552cd09..fbd4d41 100644 --- a/docs/agents/agent-diagnostic.md +++ b/docs/agents/agent-diagnostic.md @@ -92,7 +92,7 @@ et suis-le à la lettre. ## 5. Le rapport -`agents/diagnostic/rapports/_[_].md` : +`agents/diagnostic/rapports/_[_].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 ` | 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 [--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 [--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 [--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.