diff --git a/CLAUDE.md b/CLAUDE.md index eec817a..709fb0e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -6,7 +6,7 @@ Ce fichier est une **carte** du projet, chargée à chaque session : il dit ce q Agent de diagnostic proactif pour **AIMsight**, un système de surveillance optique de déplacements : une caméra suit des cibles (prismes, réflecteurs) sur un ouvrage, et le mouvement de la caméra est compensé grâce à des cibles de référence. L'agent analyse les séries temporelles avec des **méthodes analytiques (pas de LLM)**, complétées à l'étude par une couche d'agents LLM côté serveur (D-027), détecte les anomalies et explique chacune d'elles (preuves calculées + ce qui reste non établi) **avant** que le client ne pose la question. Cible d'exécution idéale : **le système embarqué de la station**. Langage : **Python**. -## État et prochaine étape (au 2026-10-14) +## État et prochaine étape (au 2026-10-16) L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.md`. @@ -14,13 +14,13 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m - **Energy, comparaison seulement** : les deux moyennes glissantes sur 7 jours. Point ouvert : l'accoutumance après ~30 jours de déficit (fiche `moving_average_7_days_drop`). - **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 (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, puis NORDEND, WILDSTRUBEL et CLARIDEN, chacune devenue un cas de la base ; CLARIDEN est l'incident de Barcelone de la doc AIMsight, où l'expert voit un mouvement réel de l'ouvrage, la doc une instabilité des références (`docs/displacement/domaine/incident-de-barcelone.md`) ; deux rapports d'analyse AIMsight (murs GN-1.472 et GN-5.054), causes des déplacements apparents selon l'expert, sans leurs données ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan. -- **Agent de diagnostic (D-046)** : pilote de l'enquête à la demande (D-042) dans Claude Code : sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/_/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : quatre cas, C-001 à C-004 (l'index `agents/diagnostic/cas/INDEX.md` en est le registre), chaque cas avec ses données, la station au numéro du cas et les capteurs codés (D-049, D-050, skill `anonymiser-cas`), une fiche courte sur ce seul cas, lisible d'abord par un humain (D-051) ; 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. +- **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 (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, puis NORDEND, WILDSTRUBEL, CLARIDEN et NIEDERHORN, chacune devenue un cas de la base ; CLARIDEN est l'incident de Barcelone de la doc AIMsight, où l'expert voit un mouvement réel de l'ouvrage, la doc une instabilité des références (`docs/displacement/domaine/incident-de-barcelone.md`) ; 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), gardé en l'état (D-052)** : pilote de l'enquête à la demande (D-042) dans Claude Code : sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/_/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : cinq cas, C-001 à C-005 (l'index `agents/diagnostic/cas/INDEX.md` en est le registre), chaque cas avec ses données, la station au numéro du cas et les capteurs codés (D-049, D-050, skill `anonymiser-cas`), une fiche courte sur ce seul cas, lisible d'abord par un humain (D-051) ; un cas n'y entre que sur demande explicite de l'utilisateur (skill `/nouveau-cas`). L'enquête par API (D-042) reste un document. - **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`. - **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`. - **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`. - **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, matplotlib, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST. -- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande. +- **Prochaine étape** : **déplacements (D-052)** : l'utilisateur (l'expert) apporte un nouveau cas réel avec les pages de la plateforme qu'il a consultées ; on en tire, pas à pas, des vues lisibles pour le client et l'expert, puis l'agent dans une maquette ; `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) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande. ## Analyses (domaine Energy) @@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . ### Fichiers - `README.md` (40 l) : point d'entrée pour un humain. -- `docs/decisions.md` (574 l, D-001 à D-051) : 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` (584 l, D-001 à D-052) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée. - `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question. - `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport. - `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit. @@ -135,7 +135,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - `VERMONT/` : **jeu de travail = VERMONT seule** (D-009), le plus long historique : 7 CSV, un par métrique système (~5 000 l chacun). Les analyses Energy tournent uniquement sur ce jeu (défaut des scripts). - `WEISSHORN/` : tous les champs de la caméra (export du 2026-10-13, du 09/08 au 13/10, mesures dès le 19/08) ; jeu de travail de `storage` (seul, D-034) et `cellular` (D-030) ; sur secteur, avec NORDEND, il sert à `DAILY_POWER_SOURCE` (D-043). Contient des identifiants (`SIM_CCID`, `ip`) : ne pas les recopier ; le dépôt doit rester privé (D-014). - `NORDEND/` : tous les champs d'une version plus ancienne du collecteur (export du 2026-10-13, 109 jours, sans `link`) ; deuxième jeu de travail de `cellular`, station à la liaison faible (D-032). Mêmes identifiants à ne pas recopier (`SIM_CCID`, `ip_*`). - - `PS_DES_COUDRES/displacement/` : déplacements optiques de PS des Coudres (Suisse), du 08/10 au 14/10 : export « advanced » (15 min, UTC), source des analyses, et export horaire ; `images/` : 24 images horaires de la caméra (13/10 12:00 → 14/10 11:00 UTC), vérité de référence (D-045). Jeu de travail de `displacement`. Même rangement pour `NORDEND/`, `WILDSTRUBEL/` et `CLARIDEN/` (export et images à 10 min), données des cas C-002 à C-004. + - `PS_DES_COUDRES/displacement/` : déplacements optiques de PS des Coudres (Suisse), du 08/10 au 14/10 : export « advanced » (15 min, UTC), source des analyses, et export horaire ; `images/` : 24 images horaires de la caméra (13/10 12:00 → 14/10 11:00 UTC), vérité de référence (D-045). Jeu de travail de `displacement`. Même rangement pour `NORDEND/`, `WILDSTRUBEL/` et `CLARIDEN/` (export et images à 10 min) et `NIEDERHORN/` (horaires), données des cas C-002 à C-005. - Les notes brutes de l'expert (`metadata.md`, `d.md`) et `archive/` ont été retirées le 2026-10-13 (D-033) : leur résumé est dans `docs/energy/domaine/cas-annotes-par-l-expert.md`. - `src/` : un sous-dossier par domaine, plus le code commun (D-026). - `common/` : `stations.py` (chargement des CSV, métriques texte en listes, trous de mesure ; bibliothèque standard) et `page.py` (poste de dev : bascule `.venv`, ouverture dans le navigateur, `AUTOSCALE_Y_JS`). diff --git a/docs/decisions.md b/docs/decisions.md index 14ddd53..e0991cc 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -572,3 +572,13 @@ Règles du journal : - **Pourquoi** : revue de C-001 par l'utilisateur : un humain doit comprendre le cas d'emblée ; les exclusions décrivaient d'autres cas, avec des hypothèses non validées par l'expert ; l'attendu et les tests parlent de l'agent, pas de l'événement ; la citation répétait le reste de la fiche. - **Options écartées** : critères sans commande (l'agent vérifierait à sa façon, la comparaison perd sa précision) ; exclusions gardées en critères positifs (sortent de ce cas) ; tests dans un `tests.md` du cas (sans intérêt pour l'utilisateur) ; section Inconnus pour un seul point. - **Conséquence** : sans exclusion, la réfutation obligatoire de l'agent (étape 7 de `instructions.md`) reste le seul garde-fou contre un vrai mouvement de l'ouvrage, avec la règle d'asymétrie ; à revoir si un test de correspondance conclut « aucune conséquence » à tort. C-001 : les sauts de `corr_x` aux bascules des références, cause du mauvais classement à l'aveugle, sont jugés négligeables et figurent dans le Diagnostic. + +## D-052 — 2026-10-16 — Agent de diagnostic gardé en l'état ; suite : les vues des déplacements, à partir d'un cas réel et des pages de la plateforme +- **Statut** : active. +- **Décision** : + - l'agent de diagnostic (D-046 à D-051) suffit pour commencer : instructions, outils et base de cas (C-001 à C-005) restent en l'état ; la base grandit à l'usage, sur demande de l'utilisateur (`/nouveau-cas`) ; + - suite : rendre les données de déplacement lisibles par un humain, client comme expert, et intégrer l'agent dans une maquette ; le but est de montrer à l'utilisateur ce que l'agent utilise pour diagnostiquer ; + - méthode : partir d'un nouveau cas réel, que l'utilisateur apporte avec les pages de la plateforme qu'il a consultées, et avancer pas à pas ; aucune vue n'est conçue avant ce contexte. +- **Pourquoi** : demande de l'utilisateur, qui est l'expert. Dès qu'une anomalie apparaît, les pages actuelles de la plateforme ne servent ni le client ni l'expert : il faut passer de page en page, et le diagnostic est difficile. L'agent aide, mais l'humain n'a pas accès à ses preuves. La roadmap AIMsight (§4) prévoit les mêmes preuves déterministes pour les tableaux de bord et pour l'explication par un LLM. +- **Options écartées** : approfondir d'abord l'agent (plus de cas, plus d'outils), écarté par l'utilisateur pour rester efficace ; concevoir tout de suite trois vues tirées des cas connus (capteurs × temps en écart à leur niveau habituel, image annotée par capteur, capteur et témoin avec brut, corrigé, erreur et vignettes), reporté : sans les pages actuelles ni un cas vécu, on risque de refaire l'existant ou de viser à côté. Ces trois vues restent des pistes. +- **Conséquence** : les maquettes (D-022, D-039) gagneront un volet déplacements, pour le client comme pour l'expert ; le cadrage des déplacements (D-044) reste au second plan.