Files
Support-Agent/docs/decisions.md
T
maximeandClaude Opus 5.5 2d89c21df1 Add --ameliorer to /aiguiser, like /boucle (D-076)
The same ameliorateur agent runs after the releveur; its scope now depends
on the process named in its request.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 09:46:11 +01:00

133 KiB
Raw Blame History

Journal des décisions

Décisions de niveau projet, au format ADR allégé (inspiré de MADR). Ce qui est propre à une analyse va dans sa fiche (docs/analyses/analyse_NN.md).

Règles du journal :

  • On ajoute, on ne réécrit pas.
  • Une décision qui change garde son texte : son statut devient « remplacée par D-0XX », et la nouvelle entrée cite l'ancienne.
  • Champs : Statut, Décision, Pourquoi, Options écartées (avec leur raison, pour ne pas les reproposer), Conséquence. Les champs sans objet sont omis.
  • Statuts : active · remplacée par D-0XX · remplacée en partie par D-0XX · abandonnée.

D-001 — 2026-10-09 — Point d'entrée : scan proactif d'un export

  • Statut : active.
  • Décision : l'agent parcourt un export, détecte les événements, les classe et explique chacun.
  • Pourquoi : expliquer l'anomalie avant que le client ne pose la question.
  • Options écartées : commencer par le mode « question de support » (« pourquoi D-300-A a sauté ? ») ; il viendra ensuite, sur le même socle.

D-002 — 2026-10-09 — Premier cas d'usage : santé énergétique des stations

  • Statut : active.
  • Décision : commencer par la tension batterie et les interruptions de mesure, sur des stations solaires et sur secteur.
  • Pourquoi : cas simple et fréquent, avec des diagnostics experts disponibles. Ici, le trou de données est l'anomalie.
  • Options écartées : commencer par l'interprétation des déplacements ; elle viendra ensuite.

D-003 — 2026-10-09 — 100 % analytique, embarquable, données réelles

  • Statut : active, remplacée en partie par D-027 (le refus du LLM ne vaut plus que pour la couche déterministe).
  • Décision : pas de LLM ; pas de données synthétiques ; code d'analyse en bibliothèque standard Python.
  • Pourquoi : la cible est le système embarqué de la station, souvent sur batterie et panneau solaire. Chaque conclusion doit être traçable jusqu'aux faits calculés.
  • Options écartées :
    • le LLM ou l'agent de synthèse prévu par les docs AIMsight ;
    • les CSV simulés et les générateurs de scénarios (refus explicite de l'utilisateur) ;
    • pandas et numpy dans le code d'analyse.

D-004 — 2026-10-09 — Définition : anomalie énergétique = régime non soutenable

  • Statut : active.
  • Décision : une anomalie énergétique est un régime qui menace le fonctionnement : l'apport ne couvre pas la consommation sur un cycle.
  • Pourquoi : une station débranchée du secteur avec une batterie pleine est déjà en situation critique. Le niveau de charge dit quand la station tombera, pas si elle tombera.
  • Options écartées : définir l'anomalie par une batterie basse ou par une zone de charge (plateau, coude). Ce n'est qu'un indicateur d'urgence.
  • Conséquence : l'apport n'est pas mesuré (l'INA219 mesure la consommation). Il se déduit de la réaction de la batterie.

D-005 — 2026-10-09 — Analyses multiples et imparfaites, combinées

  • Statut : active.
  • Décision : chaque analyse est une preuve parmi d'autres. Il suffit qu'elle ait raison dans la majorité des cas. C'est la combinaison d'analyses indépendantes qui fait le diagnostic. Préférer des fenêtres larges (plusieurs jours, multiples de 24 h).
  • Pourquoi : ne pas surinvestir dans la précision d'une seule règle.
  • Options écartées :
    • une seule analyse « parfaite » qui couvrirait tous les cas ;
    • un score continu de 0 à 1, qui serait une pseudo-probabilité, interdite.
  • Conséquence : toutes les analyses suivent le contrat commun run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}. Le calcul est causal. Une analyse seule conclut au plus consistent with.

D-006 — 2026-10-09 — Un script et une fiche par analyse

  • Statut : remplacée par D-026.
  • Décision : l'analyse NN a un point d'entrée src/analyse_NN.py et une fiche docs/analyses/analyse_NN.md.
  • Pourquoi : suivre une à une les analyses à venir, qui seront nombreuses.
  • Options écartées : un main.py unique à la racine (essayé, puis renommé et déplacé).

D-007 — 2026-10-09 — Livrable : graphiques HTML ouverts dans le navigateur

  • Statut : remplacée en partie par D-011 (disposition des graphiques). Le reste est actif.
  • Décision : le livrable d'une analyse est un graphique plotly, ouvert automatiquement dans le navigateur. Disposition initiale : en haut, tous les champs superposés, comme sur la plateforme de monitoring de l'entreprise ; dessous, l'analyse.
  • Pourquoi : c'est le graphique qui sert, pas le texte.
  • Options écartées : le résumé texte dans le terminal comme livrable principal, jugé peu utile. Il reste disponible via energy_check.py.
  • Conséquence : plotly n'est installé que dans .venv/, sur le poste de dev. Le script y bascule seul.

D-008 — 2026-10-09 — Prototype expérimental : pas de tests automatisés

  • Statut : active, jusqu'à la fin de la phase prototype.
  • Décision : les tests unitaires et de régression sont supprimés. On n'en ajoute pas.
  • Pourquoi : ils ajoutent de la complexité pour un code très expérimental.
  • Options écartées : des tests de régression sur données réelles (32 tests, supprimés).
  • Conséquence : on vérifie à la main en lançant le script de l'analyse. Les tests restent récupérables dans l'historique git (commit 53b4f7e).

D-009 — 2026-10-09 — Jeu de travail : VERMONT seule

  • Statut : active.
  • Décision : les analyses ne tournent que sur VERMONT, le seul dataset complet (les 7 métriques système, comme sur la plateforme), placé dans data/. Les autres stations (BusVoltage seule) sont mises de côté dans data/archive/.
  • Pourquoi : disposer de tous les champs vaut mieux qu'avoir plus de stations incomplètes.
  • Options écartées : supprimer les autres stations (irréversible, car non versionnées) ; continuer à analyser les 5 stations.
  • Conséquence : il n'y a plus de station saine pour vérifier qu'une analyse ne donne pas de fausse alerte. Les seuils calés avant cette décision gardent leur source historique.

D-010 — 2026-10-09 — Organisation de la documentation

  • Statut : active, complétée par D-012 ; remplacée en partie par D-026 (chemin des fiches).
  • Décision : trois niveaux.
    • CLAUDE.md est chargé à chaque session et reste court.
    • docs/decisions.md (ce journal) porte les décisions de niveau projet.
    • docs/analyses/analyse_NN.md porte la fiche vivante de chaque analyse.
  • Pourquoi : rien ne doit se perdre entre deux conversations, sans alourdir le contexte chargé en permanence.
  • Options écartées :
    • mettre à jour après coup les specs et plans superpowers ;
    • garder le savoir projet dans la mémoire automatique de Claude, qui est locale et non partagée.
  • Conséquence : docs/superpowers/ est un historique de travail, pas une référence. La spec d'une nouvelle analyse s'écrit directement dans sa fiche.

D-011 — 2026-10-09 — Disposition des graphiques : l'analyse en haut, une série par graphique dessous

  • Statut : active. Remplace la disposition de D-007.
  • Décision : en haut, l'analyse avec ses courbes superposées ; dessous, un graphique séparé par série temporelle, chacun avec sa propre échelle.
  • Pourquoi : superposer tous les champs sur un seul axe écrase l'échelle, parce que les amplitudes vont de ~13 V à ~5000 mW.
  • Options écartées : tous les champs sur un même axe, à la manière de la plateforme de monitoring (D-007), essayée puis abandonnée.

D-012 — 2026-10-09 — Documentation : une carte et des documents chargés à la demande

  • Statut : active. Complète D-010. Remplacée en partie par D-026 (chemins des fiches, du modèle et de la règle .claude).
  • Décision :
    • CLAUDE.md devient une carte de moins de 200 lignes : état et prochaine étape, index des analyses, liens, règles non négociables, essentiel du domaine.
    • Le savoir métier va dans docs/domaine/, une note par question.
    • Une règle .claude/rules/analyses.md se charge seule quand Claude touche src/ ou docs/analyses/.
    • Ce journal prend le format ADR allégé (statut, options écartées).
    • Un modèle de fiche docs/analyses/_modele.md et un skill nouvelle-analyse donnent la même forme à chaque analyse.
  • Pourquoi :
    • la doc officielle de Claude Code recommande moins de 200 lignes par CLAUDE.md, car un fichier plus long coûte du contexte à chaque session et est moins bien suivi ;
    • les règles limitées à certains chemins et les skills ne se chargent qu'à la demande (divulgation progressive) ;
    • les options écartées évitent de reproposer ce qui a déjà été rejeté.
  • Options écartées : un CLAUDE.md exhaustif à la manière de DocLab (1194 lignes, ~93 Ko). Il donne une très bonne vue d'ensemble, mais chaque session paie ce contexte et l'adhérence baisse.

D-013 — 2026-10-09 — Graphiques : zoom dans le temps, ordonnée recalée sur la plage visible

  • Statut : active.
  • Décision : dans tous les graphiques d'analyse :
    • le zoom est horizontal seulement (dans le temps, au rectangle ou à la molette) et commun à tous les graphiques ;
    • après chaque zoom, l'ordonnée de chaque graphique est recalée sur les points visibles. Le script est energy_plot.AUTOSCALE_Y_JS, avec les ordonnées en fixedrange ;
    • la ligne de seuil reste visible ;
    • un double-clic revient à la vue complète.
  • Pourquoi : les graphiques sont peu hauts. Avec l'échelle de l'ensemble des données, les points sortaient du cadre dès qu'on zoomait, et plotly ne recale pas l'ordonnée tout seul.
  • Options écartées : le zoom libre en rectangle sur les deux axes, parce que l'ordonnée fixée à la main serait écrasée par le recalage automatique.
  • Conséquence : le script utilise l'API interne de plotly.js (_fullLayout, d2l, r2l). Il est à revérifier si plotly change de version majeure.

D-014 — 2026-10-09 — Tout le projet est versionné et poussé sur le dépôt de l'entreprise

  • Statut : active, sauf pour data/, hors de git depuis D-065.
  • Décision : doc/ (documentation AIMsight), data/ (dont data/archive/), architecture.drawio et la copie du collecteur src/__main__ (3).py sont versionnés et poussés sur origin (gitea de l'entreprise). Seuls out/, .venv/ et __pycache__/ restent ignorés.
  • Pourquoi : demande explicite de l'utilisateur. Le projet doit être complet et récupérable depuis le dépôt.
  • Conséquence :
    • data/metadata.md contient des identifiants techniques de station (SIM CCID, adresses IP), d'où un dépôt qui doit rester privé ;
    • les stations archivées deviennent récupérables, ce qui lève la raison « irréversible » évoquée dans D-009.

D-015 — 2026-10-12 — Panneau d'analyse : deux courbes sur un seul axe en volts

  • Statut : active. Précise D-011 pour le panneau du haut.
  • Décision : le panneau d'analyse ne montre que la moyenne sur 7 jours et le seuil (référence − 0,2 V), en volts, sur un seul axe, avec le fond rouge des anomalies. L'écart et la référence restent au survol.
  • Pourquoi : les 5 tracés précédents (écart, ligne à −0,2 V, moyenne, référence, seuil, sur deux axes) montraient deux fois le même test. L'utilisateur a demandé à simplifier.
  • Options écartées :
    • l'écart seul face à −0,2 V : le plus compact, mais on ne voit plus le niveau de tension ;
    • moyenne, référence et seuil (3 courbes) : la référence n'est que le seuil décalé de 0,2 V.
  • Conséquence : le seuil est une courbe, donc AUTOSCALE_Y_JS le garde visible sans cas particulier.

D-016 — 2026-10-12 — Page commune : un panneau par analyse, pour les comparer

  • Statut : active. Précise D-011 et D-006. Remplacée en partie par D-026 (un point d'entrée par analyse, ordre des panneaux par numéro).
  • Décision : les analyses énergétiques partagent une page, out/<STATION>_energy.html. Chacune y a son panneau en haut, dans l'ordre de leur numéro (02 sous 01), puis viennent les graphiques des séries temporelles. Chaque analyse garde son point d'entrée src/analyse_NN.py (D-006), qui lance cette page.
  • Pourquoi : demande de l'utilisateur, pour comparer MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP à MOVING_AVERAGE_7_DAYS_DROP sur le même axe de temps. C'est aussi un premier pas vers la combinaison des analyses (D-005).
  • Options écartées : une page par analyse, qui obligerait à comparer deux onglets sans zoom commun.
  • Conséquence : energy_plot.figure() prend une liste de résultats. Le calcul commun des deux analyses est energy_check._ma_drop().

D-017 — 2026-10-12 — Identifiants de règle en mots complets

  • Statut : active.
  • Décision : l'identifiant d'une règle (champ analysis, titre du panneau, conclusions) s'écrit en anglais, en majuscules, avec des mots complets et sans abréviation. Les deux premières analyses sont renommées : MA7D_DROP devient MOVING_AVERAGE_7_DAYS_DROP, et MA7D_MIDNIGHT_DROP devient MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP.
  • Pourquoi : demande de l'utilisateur : avec des abréviations, on ne comprend pas ce que fait la règle. L'identifiant est cité dans chaque conclusion, il doit se lire sans la fiche.
  • Options écartées : les sigles courts (MA7D_DROP), illisibles pour qui ne connaît pas le projet.
  • Conséquence : les documents de travail de docs/superpowers/ gardent les anciens noms (historique non maintenu).

D-018 — 2026-10-12 — Analyses suivantes : état jour par jour, seuils physiques du matériel

  • Statut : active. Nuance D-005 (fenêtres larges) pour les analyses d'état.
  • Décision :
    • les prochaines analyses donnent l'état de la batterie jour par jour, plutôt qu'une moyenne glissante sur plusieurs jours ;
    • elles s'appuient sur des seuils physiques du matériel (fin de charge du chargeur, coude LiFePO4), valables dès le premier jour, pour détecter les problèmes dès l'installation (alimentation absente, apport insuffisant) ;
    • elles se construisent en deux phases : d'abord l'état seul (phase C), puis des niveaux gradués (phase B) ;
    • elles tournent sur les exports CSV horaires, sur le poste de dev. Les données brutes de la station et le collecteur embarqué viendront plus tard.
  • Pourquoi : demande de l'utilisateur. La moyenne glissante introduit trop d'inertie, alors qu'on veut l'état directement et une détection rapide à l'installation. Or une comparaison au propre passé est impossible sans historique.
  • Options écartées :
    • la comparaison au propre passé de la station, aveugle à l'installation ;
    • l'hybride (seuils absolus puis passé), trop complexe pour commencer ;
    • les états du collecteur à 1 Hz, mis de côté : pas de données brutes, et un seuil sur 60 s qui ne voit pas le plateau.
  • Conséquence : le principe « les seuils de tension absolus ne se transposent pas » vise les niveaux propres à une station, comme la position du plateau la nuit. Les seuils du matériel sont admis, à condition de vérifier que le chargeur est le même sur toutes les stations. Première analyse : 03 DAILY_BATTERY_STATE.

D-019 — 2026-10-12 — Points journaliers à midi ; fin de nuit non décalée

  • Statut : active. Précise D-011 (graphique) pour les analyses jour par jour (D-018).
  • Décision :
    • sur le graphique, les points journaliers des analyses 03 et 04 sont placés à midi UTC de leur jour, au milieu de la journée, et non à leur t (23:00) ;
    • le calcul ne change pas : la fin de nuit du jour J reste celle du matin de J, dans l'analyse 03 comme dans la 04.
  • Pourquoi : choix de l'utilisateur. À 23:00, le point et la barre semblaient appartenir au lendemain : le 12/04 a été lu « 13 avril ».
  • Options écartées :
    • décaler la fin de nuit d'un jour, pour qu'elle porte sur la même journée que l'état (la fin de nuit du matin de J porte le bilan de J−1). Essayé dans la 03, puis dans la 04 seule, et écarté par l'utilisateur les deux fois. Sur VERMONT, il ramenait les barres de la 04 contraires à l'état de 16 à 4 sur 28 changements d'état, au prix d'un jour de retard ;
    • garder t sur le jour J en prenant la fin de nuit de J+1 : non causal.
  • Conséquence : l'incohérence entre l'état et la barre reste une limite connue de l'analyse 04 (limite 6 de sa fiche).

D-020 — 2026-10-12 — Diagnostic énergétique livré : couleur du jour (matrice 03 × 04) et manuel

  • Statut : active. Remplace, pour le diagnostic livré, la « phase B » de l'analyse 03 et la combinaison prévue par D-005.
  • Décision :
    • le diagnostic énergétique livré ne retient que les analyses 03 (DAILY_BATTERY_STATE) et 04 (DAILY_BATTERY_TREND) ;
    • elles se combinent par une matrice état × tendance en une couleur par jour et par station : vert (soutenable ce jour-là), orange (incertain, à surveiller), rouge (non soutenable). La matrice est tenue par l'utilisateur dans cas-d-usage-03-04.drawio ;
    • un manuel l'explique, en deux couches : une lecture rapide pour le client final, une annexe technique pour l'ingénieur support (docs/guide/diagnostic-energetique.md).
  • Pourquoi : demande de l'utilisateur. Il faut apprendre au lecteur à lire les signaux envoyés ; la couleur sert d'entrée en matière, les analyses de détail.
  • Options écartées :
    • NO_CHARGE × STABLE en orange : une coupure d'alimentation passerait du rouge (1er jour) à l'orange (jours suivants) alors qu'elle continue, contre D-004 ;
    • un manuel pour un seul public (client ou support).
  • Conséquence :
    • la matrice n'est pas encore codée : le manuel décrit la cible ;
    • les analyses 01 et 02 restent dans le code et sur la page HTML, mais ne font plus partie du diagnostic livré ;
    • les cas inconnus (état ou tendance) ne sont pas encore traités dans la matrice, laissés de côté par l'utilisateur ;
    • le destinataire du diagnostic n'est plus ouvert : le client et le support, en couches.

D-021 — 2026-10-12 — Graphique des analyses 03 et 04 pour le site de monitoring

  • Statut : active. Complète D-020.
  • Décision :
    • le graphique destiné au site de monitoring (Plotly) est une seule figure : le panneau de l'analyse 03 en haut, celui de l'analyse 04 dessous, sur le même axe du temps. Ce sont les panneaux de la page des analyses (D-016), sans changement ;
    • src/energy_plot.py en écrit une page de démo (out/<STATION>_daily.html) et la figure en JSON (out/<STATION>_daily.json), que le site passe à Plotly.newPlot ;
    • la matrice de D-020 est codée dans src/day_color.py (bibliothèque standard, embarquable), mais n'est pas tracée. Quand l'état ou la tendance est inconnu, la couleur l'est aussi (gris).
  • Pourquoi : demande de l'utilisateur, qui veut intégrer le diagnostic au site (page « System Summary ») et trouve les deux panneaux plus clairs qu'une couleur par jour.
  • Options écartées :
    • une bande d'une case par jour (couleur de la matrice, flèche de tendance) au-dessus de BusVoltage horaire : essayée, jugée « pas claire » par l'utilisateur ;
    • superposer les deux panneaux en double axe (03 à gauche en V, 04 à droite en ΔV), dans un 3e panneau : essayé, mauvaise lisibilité selon l'utilisateur. Le zéro de l'axe de droite tombe vers 13,6 V, les tirets de la zone morte s'y lisent comme des seuils de tension, et les grandes barres cachent la fin de nuit. Deux superpositions sur un seul axe en V n'ont pas été essayées : la tendance en marqueurs ▲ ● ▼ sur la courbe de fin de nuit, ou chaque barre tracée de la fin de nuit de J−1 à celle de J ;
    • teinter le fond de la courbe BusVoltage, jour par jour : la teinte se lit moins bien que des cases, et elle gêne la lecture de la courbe ;
    • pour un jour inconnu, reprendre la couleur de la colonne de l'état quand elle est unique (FULL_CHARGE sans veille serait vert) : l'utilisateur préfère le gris, les cas inconnus restant à traiter (D-020).
  • Conséquence :
    • la couleur du jour est calculée mais n'apparaît sur aucun graphique ;
    • le calcul des analyses 03 et 04 (battery_state.py, battery_trend.py) n'importe plus rien des analyses 01 et 02 : il se livre seul ;
    • le format d'intégration côté site (JSON, fragment HTML ou backend Python) reste à choisir avec l'équipe du site.

D-022 — 2026-10-12 — Maquettes de page en HTML ; Figma seulement sur demande

  • Statut : active, remplacée en partie par D-039 (maquettes multi-domaines, une vue client par station).
  • Décision : les maquettes de page (ex. « System Summary » du site de monitoring) sont des pages HTML générées à partir des données réelles, dans maquettes/. Un fichier Figma n'est produit que sur demande (designer, passation à l'équipe du site), à partir d'une maquette stable.
  • Pourquoi : choix de l'utilisateur, sur recommandation. Le HTML s'itère plus vite (rendu et vérification en local), garde les données réelles et vivantes (calcul par src/), permet l'interaction (survol traçable, zoom), utilise la technologie du livrable (HTML Plotly) et se versionne.
  • Options écartées : Figma comme référence. Chaque modification y passe par l'API Plugin, et le graphique n'y est qu'une image vectorielle figée, sans survol ni zoom. Un premier fichier, produit puis non maintenu, reste dans les brouillons Figma de l'utilisateur : https://www.figma.com/design/S16eZ7PoAAutFJWcyqAHSm.
  • Conséquence :
    • les maquettes sont rangées en deux blocs : maquettes/user/ (côté client) et maquettes/support/ (côté support AIMsight). Chaque design a son script, ou directement son HTML s'il n'a pas besoin de données ;
    • python3 maquettes/user/energy.py [début] [fin] écrit out/maquette_user_energy.html (ignoré par git, comme les autres pages générées) et l'ouvre. Il calcule lui-même la figure de D-021 (plotly, bascule seule sur .venv) ;
    • la maquette « Energy » place en haut de la page System Summary une section « Diagnostic », un rectangle repliable par notification (ici Energy, avec Green, Orange ou Red pour le dernier jour de la fenêtre). Déplié : une phrase de très haut niveau, puis une échelle de batterie (niveau de ce matin, la fin de nuit, placé par la table OCV du collecteur dans des zones Off < 10 %, Low < 30 %, OK < 90 %, Full ; pas de % affiché, car sur le plateau la tension en dit peu ; la tension reste au survol), la tendance face à la veille en mots simples (better / same / worse), et deux dérouleurs : l'historique complet (figure de D-021) et « Guide », la partie 1 du manuel (lecture rapide, pour le client) rendue depuis le Markdown à chaque génération (marked.js). La partie 2, pour le support, ira côté support ;
    • les jours Orange et Red, un bouton « Activate energy save mode » propose le remède attendu (veille profonde entre les mesures, docs/domaine/comment-se-comporte-la-batterie.md). C'est une action de la plateforme, déclenchée par le client : le diagnostic reste en lecture seule. Dans la maquette, le bouton n'envoie rien ;
    • le bloc n'utilise pas le graphique de 48 h de D-024 (focus_jour.py) : l'utilisateur préfère des faits chiffrés. Un tableau des faits de J−1 et de J, côte à côte, puis le jour J avec ses variations chiffrées, ont été essayés, puis remplacés par l'échelle et la tendance : une tension ne dit rien à un non-spécialiste, et il n'a pas besoin de savoir que la tendance vient de la fin de nuit ;
    • une première version, avec une bande d'une case par jour au-dessus de BusVoltage (option écartée par D-021), a été remplacée.
    • points ouverts de la maquette « Energy » :
      • le guide est la partie 1 du manuel, en français, alors que la page est en anglais (D-023) : il faudra une version anglaise ;
      • le repère de l'échelle de batterie n'a pas de compensation IR : la nuit, la tension mesurée est ~0,14 V sous la tension à vide, donc le repère est un peu bas. Le collecteur, lui, compense avec le courant (0,34 Ω) ;
      • le bouton « Activate energy save mode » reste à construire par l'équipe du site ;
      • le jour affiché est le dernier jour de la fenêtre ; un jour en cours n'est pas encore signalé comme provisoire côté client.

D-023 — 2026-10-12 — Site de monitoring en anglais, figure des analyses 03 et 04 comprise

  • Statut : active. Complète D-021 et D-022.
  • Décision : tout ce qui est destiné au site de monitoring est en anglais : la maquette System Summary et la figure des analyses 03 et 04 (out/<STATION>_daily.json), avec ses titres, légendes, axes et survols.
  • Pourquoi : demande de l'utilisateur. Le site AIMsight est en anglais.
  • Conséquence :
    • les panneaux 03 et 04 étant partagés (D-021), ils sont aussi en anglais sur la page des analyses (out/<STATION>_energy.html), dont le reste (analyses 01 et 02, séries) reste en français ;
    • le code, ses commentaires, les fiches et le manuel restent en français (convention du projet). Les identifiants (FULL_CHARGE, DAILY_BATTERY_STATE…) ne changent pas.

D-024 — 2026-10-12 — Focus sur un jour : J et la veille seulement

  • Statut : active. Complète D-020 et D-021.
  • Décision :
    • pour comprendre la couleur d'un jour (ex. « Red » le 27/09), on ne montre que le jour J et la veille J−1 : ce sont les seuls jours que lisent les analyses 03 et 04 pour cette couleur ;
    • python3 src/focus_jour.py JJ.MM[.AAAA] affiche un résumé texte traçable (couleur, case de la matrice, état et condition de chaque jour, maximum, fin de nuit et son heure, heures mesurées, tendance et ce qui l'a décidée). Il écrit aussi un graphique de 48 h (out/<STATION>_focus_<AAAA-MM-JJ>.html + .json) : BusVoltage horaire, bandes grises sans mesure, seuils 14,0 et 12,8 V, maximum et fin de nuit de chaque jour, flèche de fin de nuit J−1 → J colorée par tendance ;
    • la sélection des données (day_color.focus(series, jour)) est en bibliothèque standard, livrable à la plateforme ; le graphique est en anglais (D-023).
  • Pourquoi : demande de l'utilisateur. Le client qui voit une couleur veut voir les données qui l'expliquent, sans tout l'historique.
  • Conséquence :
    • l'analyse 03 gagne le fait night_end_h (heure de la fin de nuit), sans changer les autres ;
    • un jour en cours, ou le dernier jour d'un export, est signalé « provisional » : la couleur peut encore changer jusqu'à minuit UTC.

D-025 — 2026-10-12 — Maquette support « Home » : section Status et lien vers la vue client

  • Statut : active, remplacée en partie par D-039 (maquettes multi-domaines, une vue client par station). Complète D-022.
  • Décision :
    • côté support, la maquette reprend la page d'accueil du site (une vignette par station : nom, dernière tension, courbe) et place en haut une section « Status » : une notification par station dont le dernier jour de la fenêtre est Orange ou Red (src/day_color.py), la plus grave d'abord. Green ne notifie rien ;
    • une notification donne la couleur, la station, le domaine (Energy), le jour, la phrase de la vue client, et un lien « Open » vers la vue client de la station (son menu principal, out/maquette_user_energy.html). La vignette de la station mène au même endroit ;
    • python3 maquettes/support/home.py [début] [fin] écrit out/maquette_support_home.html et l'ouvre (bibliothèque standard, SVG en ligne, sans plotly).
  • Pourquoi : demande de l'utilisateur. Le support doit voir l'ensemble des systèmes, et voir une alerte quand le client la voit ; le plus simple est de le notifier et de l'envoyer sur la vue client. Maquette validée telle quelle par l'utilisateur.
  • Conséquence :
    • la section Status remplace, en haut de page, le panneau « Notifications » du site ;
    • seule VERMONT a des données (data/) : les autres vignettes, noms repris du site, restent vides et grisées (pas de données synthétiques) ;
    • la vue client doit être générée avec les mêmes dates (maquettes/user/energy.py) ; le script le rappelle si elle manque.

D-026 — 2026-10-12 — Structure par domaine ; analyses désignées par leur règle

  • Statut : active. Remplace D-006 ; remplace en partie D-010 (chemin des fiches), D-012 (chemins des fiches, du modèle et de la règle .claude) et D-016 (un point d'entrée par analyse).
  • Décision :
    • Chaque domaine a son sous-dossier dans chaque couche : src/energy/ et docs/energy/ (analyses, domaine, guide, matrice). Le code commun est dans src/common/ (stations.py : chargement des CSV ; page.py : bascule .venv, ouverture, AUTOSCALE_Y_JS). maquettes/ reste découpé par public (D-022). Les notes communes restent dans docs/domaine/.
    • Les analyses ne sont plus numérotées : chacune est désignée par sa règle et sa fiche porte son nom (docs/energy/analyses/daily_battery_state.md). Correspondance : 01 = MOVING_AVERAGE_7_DAYS_DROP, 02 = MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP, 03 = DAILY_BATTERY_STATE, 04 = DAILY_BATTERY_TREND. Les entrées du journal antérieures à celle-ci gardent les numéros.
    • Deux scripts d'analyse pour Energy : src/energy/final.py (daily.py jusqu'au 2026-10-13), les analyses livrées (état et tendance, D-020 et D-021), qui écrit out/<STATION>_daily.html et .json ; src/energy/all_analyses.py, les quatre analyses ensemble pour comparer (D-016), qui écrit out/<STATION>_energy.html. src/energy/focus_jour.py reste l'outil de focus (D-024). Le résumé texte d'energy_check.py (out/<STATION>_energy.json) est supprimé.
    • La documentation AIMsight d'origine passe de doc/ à docs/aimsight/, avec la copie du collecteur (collecteur_system_info.py, ex-src/__main__ (3).py). La roadmap perd le suffixe « (2) ». cas-d-usage-03-04.drawio devient docs/energy/matrice-etat-tendance.drawio. Les contenus ne changent pas.
    • Le modèle de fiche passe dans le skill nouvelle-analyse (modele-fiche.md).
  • Pourquoi : demande de l'utilisateur. Encapsuler Energy pour que le domaine suivant (D-002) se range à côté. Ranger les fichiers dispersés (racine, doc/ à côté de docs/, code commun mêlé aux analyses). Energy a convergé vers les analyses livrées : un numéro d'ordre de création n'aide plus, le nom de la règle suffit.
  • Options écartées :
    • une tranche verticale energy/{src,docs,maquettes} à la racine : elle mêle des couches aux destinataires différents (station, humains, équipe du site), et la maquette support couvre tous les domaines ;
    • ne réorganiser que le code : la documentation Energy resterait mêlée au reste ;
    • garder un script analyse_NN.py par analyse (D-006) : trois des quatre ne faisaient que relancer le premier ;
    • une numérotation par domaine : elle ne dit pas plus que le nom de la règle.
  • Conséquence :
    • les anciens chemins restent dans docs/superpowers/ et dans le texte des entrées antérieures du journal (historique non réécrit) ;
    • le code de calcul s'embarque en copiant src/energy/ sans final.py, all_analyses.py ni focus_jour.py, qui demandent plotly.

D-027 — 2026-10-12 — Couche d'agents de diagnostic côté serveur (exploratoire)

  • Statut : active, exploratoire (rapport docs/agents/rapport-exploratoire.md, rien n'est construit). Remplace en partie D-003 : le refus du LLM ne vaut plus que pour la couche déterministe.
  • Décision :
    • à côté de la couche déterministe (inchangée : sans LLM, bibliothèque standard, embarquable), une couche d'agents LLM (Claude, via l'API d'Anthropic) tourne côté serveur. Elle lit les faits des règles et les données, avec deux missions : les anomalies inconnues (qu'aucune règle ne décrit) et les cas limites des règles (UNKNOWN, accoutumance, faux positifs) ;
    • l'agent annote, il ne réécrit pas : il ne modifie jamais le verdict déterministe (couleur du jour). Son avis est une notification séparée, marquée « agent » ;
    • il notifie le client et le support ;
    • harnais maison : script Python, API Messages et Tool Runner du SDK anthropic, outils typés en lecture seule (sauf notify), base SQL jamais exposée. Un agent est un dossier déclaratif (instructions, pointeurs vers la connaissance de docs/, outils). Le découpage des agents reste ouvert ;
    • démarrage simple, par étapes : (1) pilote manuel Energy sur l'historique de VERMONT (CSV), (2) SQL, cron et notifications au support seul, (3) ouverture au client, (4) élargissement. Chaque étape décide si la suivante est nécessaire.
  • Pourquoi : demande de l'utilisateur. Les scripts sont justes « dans la majorité des cas » (D-005) ; l'interprétation d'un agent doit élargir la palette des problèmes captés. Les docs AIMsight prévoyaient cette couche (§18 et §21 du contexte support). L'utilisateur accepte d'envoyer les données à une API externe. Avec moins de 50 stations, le coût reste modéré (~0,30 $ par session, à mesurer). Les données sont accessibles par requêtes SQL.
  • Options écartées :
    • Managed Agents (Anthropic héberge la boucle, la planification et la mémoire) : service en bêta, et la base SQL serait à exposer ou à servir par un worker auto-hébergé. Reste la cible si l'orchestration maison devient pénible, car la définition en dossier est portable ;
    • Claude Agent SDK : un harnais de codage, dont le Bash donne une surface d'action large et peu auditable pour un agent qui notifie des clients ;
    • un modèle open-weights hébergé chez AIMsight : inutile, l'API externe étant acceptée ;
    • un LLM sur la station : trop lourd pour l'embarqué ;
    • un agent qui corrige lui-même la couleur du jour : on perdrait la reproductibilité du verdict ;
    • SQL libre, Bash, accès web, RAG : non auditables ou inutiles à cette taille.
  • Conséquence :
    • pas de LLM dans src/<domaine>/ : le code d'agent vivra à part (emplacement proposé : agents/) ;
    • les règles non négociables (traçabilité, vocabulaire, lecture seule, pas de seuil inventé) s'appliquent aux agents ;
    • les règles détaillées proposées (journal, contrôles de notify, politique de destinataire, affichage) sont des pistes à revoir étape par étape, pas des décisions (annexe A du rapport) ;
    • prérequis de l'étape 1 : un compte et une clé API Anthropic.

D-028 — 2026-10-12 — CLAUDE.md : carte complète du dépôt, état courant, lecture ciblée

  • Statut : active. Précise D-012.
  • Décision :
    • CLAUDE.md nomme chaque dossier et chaque document du dépôt, avec sa taille en lignes, pour que l'agent sache ce qui existe sans l'ouvrir ;
    • il dit comment lire sans saturer le contexte : plan d'un fichier long puis la seule section utile, index de ce journal, CSV par script, dossiers à ne pas lire ;
    • « État et prochaine étape » donne l'état courant, pas un historique daté ;
    • ce qui est déjà dans .claude/rules/analyses.md (contrat run(series), disposition des graphiques) n'y est plus répété.
  • Pourquoi : demande de l'utilisateur. Le CLAUDE.md doit révéler tout le projet sans forcer l'agent à le lire. L'historique daté grossissait à chaque étape alors qu'il est déjà dans git log et ce journal ; la doc AIMsight (~3 300 lignes) était à « lire avant de concevoir » sans dire comment la lire par section.
  • Options écartées : un index des sections de chaque gros document dans CLAUDE.md : grep -n '^#' le donne à la demande, sans coût permanent.

D-029 — 2026-10-13 — Données rangées par station

  • Statut : active. Précise D-009 (emplacement du jeu de travail).
  • Décision : les CSV d'une station vont dans data/<STATION>/ ; VERMONT passe de data/ à data/VERMONT/, défaut de tous les scripts. metadata.md, d.md et archive/ restent dans data/.
  • Pourquoi : demande de l'utilisateur, qui va ajouter de nouvelles données sans vouloir les mêler au jeu de travail.
  • Options écartées : un chargement récursif de data/ : il mêlerait archive/ et les nouvelles données au jeu de travail.
  • Conséquence : une nouvelle station s'analyse en passant son dossier en argument (python3 src/energy/final.py data/<STATION>).

D-030 — 2026-10-13 — Nouveaux domaines Storage et Cellular ; procédure nouveau-domaine ; contrat de notification

  • Statut : active. Complète D-026 (structure par domaine) et D-025 (notifications support) ; précise D-009 (jeu de travail par domaine).
  • Décision :
    • deux nouveaux domaines, rangés comme Energy : storage (espace disque) et cellular (signal 4G : niveau radio, enregistrement, lien). Chacun a src/<domaine>/ et une note de départ, docs/<domaine>/domaine/point-de-depart.md. Les analyses attendent l'exploration des données ;
    • leur jeu de travail est WEISSHORN : tout data/WEISSHORN/, sans restriction de dates (tous les champs de la caméra ; l'export du 2026-10-13 couvre 10 jours, un export plus long le remplacera) : VERMONT (D-009) n'a ni métrique de disque ni métrique de modem ;
    • la procédure pour ajouter un domaine, donc une notification, est le skill nouveau-domaine (sept étapes, de la réception des données à la livraison). Il renvoie vers nouvelle-analyse pour chaque analyse ;
    • contrat de notification : chaque domaine livré expose day_color.run(series), un point par jour avec facts.color (GREEN / ORANGE / RED / None), et une HEADLINE en anglais par couleur notifiée ;
    • le passage des maquettes à une liste de domaines se fait au premier nouveau domaine livré, pas avant.
  • Pourquoi : demande de l'utilisateur, qui veut le même travail qu'Energy pour d'autres points d'attention, et pouvoir ajouter vite de nouvelles notifications. Le collecteur mesure déjà l'espace disque et le signal du modem.
  • Options écartées : la procédure dans un document de docs/ (Claude ne le trouve pas seul) ou dans nouvelle-analyse (deux échelles mêlées) ; le nom network (VPN et envois relèvent de « Communication ») ; le passage multi-domaines dès maintenant (une liste à un seul élément, contrat non vérifié).
  • Conséquence :
    • HEADLINE d'Energy quittera maquettes/support/home.py pour src/energy/day_color.py lors du passage multi-domaines ;
    • le chargeur commun ne lit que des métriques numériques : il faudra l'adapter si l'on retient les métriques texte du modem (link, registration), qui sont des listes d'échantillons par heure ;
    • les copies identiques et les Zone.Identifier de WEISSHORN sont supprimés, et *:Zone.Identifier est ignoré par git.

D-031 — 2026-10-13 — Cellular : deux analyses d'état jour par jour, seuils absolus publiés ; métriques texte chargées

  • Statut : active. Applique D-030 (domaine Cellular) ; reprend D-018 (état jour par jour, sans historique) pour la 4G.
  • Décision :
    • deux analyses d'état, sans verdict (anomaly = None, l'état dans facts.state), écrites l'une après l'autre avant les cas de l'expert : DAILY_LINK_STATE (envois reçus avec link = up) et DAILY_SIGNAL_STATE (médianes du jour du RSRP et du RSRQ) ;
    • pour le signal, des seuils absolus : la grille « RF Quality » attribuée à Quectel par KORE Wireless (RSRP −80 / −90 / −100 dBm, RSRQ −10 / −15 / −20 dB), seule grille publiée trouvée avec une attribution ; ni la doc AIMsight ni la norme n'en donnent ;
    • common.stations charge les métriques texte comme la liste des échantillons de l'heure ; les pages ne tracent que des séries choisies, jamais SIM_CCID ni ip.
  • Pourquoi : choix de l'utilisateur. Les cas de l'expert viendront en cours de route ; l'export de WEISSHORN (10 jours) est trop court pour comparer la station à son passé.
  • Options écartées : la comparaison au propre passé (aveugle à l'installation, historique court) ; attendre l'expert pour choisir la référence ; le minimum du jour (décrochages de nuit) ; RSSI et BER (plafond, redondance).
  • Conséquence : la grille vient d'un autre modem et se présente comme indicative : à faire confirmer par l'expert. Le RSRQ de WEISSHORN est à 0,25 dB du plancher de GOOD. La couleur du jour (étape 6 de nouveau-domaine) reste à décider.
  • Statut : active. Complète D-030 (jeu de travail par domaine) et D-031 (analyses Cellular).
  • Décision :
    • le jeu de travail de cellular devient WEISSHORN et NORDEND (data/NORDEND/, export du 2026-10-13, 109 jours, du 26/06 au 13/10) ; la page de comparaison tourne sur les deux par défaut ;
    • DAILY_LINK_STATE accepte un export sans link (version plus ancienne du collecteur) : les envois se comptent sur last_sync, et ce qui dépend de link vaut None ;
    • la grille de DAILY_SIGNAL_STATE reste telle quelle en attendant l'expert, bien qu'elle classe tous les jours de NORDEND en CELL_EDGE.
  • Pourquoi : demande de l'utilisateur, qui voulait une station à la connexion moins bonne, sur une plage plus large. NORDEND a 11 coupures de la liaison (1 à 23 h), WEISSHORN aucune.
  • Options écartées : une page ou une analyse propre aux exports sans link (deux codes pour une même question) ; déduire l'état du lien des champs du modem (une lecture ratée n'est pas un lien coupé) ; changer la grille sur une seule station.
  • Conséquence : sans link, NORDEND ne montre jamais DOWN ni de message perdu. Le début d'historique (jusqu'au jour du premier envoi reçu) passe en UNKNOWN. Les métriques de stockage de NORDEND n'ont pas les noms de WEISSHORN (note de départ de storage).

D-033 — 2026-10-13 — Notes brutes de l'expert et data/archive/ retirées du dépôt

  • Statut : active. Modifie D-029 (metadata.md, d.md et archive/ ne restent plus dans data/) et D-009 (les stations mises de côté ne sont plus dans le dépôt).
  • Décision : data/metadata.md, data/d.md et les 4 CSV de data/archive/ (FLORIDA, JUNGFRAU, MISSISSIPPI, WILDSTRUBEL, BusVoltage seule) sont supprimés. Les documents renvoient désormais à leurs résumés : docs/energy/domaine/cas-annotes-par-l-expert.md pour les diagnostics, les notes de départ pour les instantanés.
  • Pourquoi : choix de l'utilisateur.
  • Options écartées : les garder (refusé par l'utilisateur).
  • Conséquence : les fichiers restent dans l'historique git, identifiants compris. Le dépôt doit toujours rester privé (D-014) : les CSV de WEISSHORN et NORDEND contiennent aussi SIM_CCID et des adresses IP. Les specs et plans de docs/superpowers/ (historique non maintenu) citent encore ces fichiers.

D-034 — 2026-10-13 — Storage : niveau du jour et jours avant saturation ; seuils arbitraires ; WEISSHORN seul

  • Statut : active. Applique D-030 (domaine Storage) ; déroge à la règle « aucun seuil sans source » pour des seuils provisoires.
  • Décision :
    • deux analyses sans verdict (anomaly = None), codées avant les réponses de l'expert : DAILY_STORAGE_STATE (espace libre en fin de jour, en % de l'espace utilisable : OK, LOW, CRITICAL) et DAYS_UNTIL_STORAGE_FULL (espace libre ÷ médiane des consommations journalières sur 7 jours) ;
    • planchers de DAILY_STORAGE_STATE arbitraires, pour commencer : 20 % et 10 % libres. Ils sont marqués comme tels dans la fiche et dans le code ;
    • le jeu de travail reste WEISSHORN seul : NORDEND n'a pas les mesures de /data (*_disk_1k-blk, plat pendant 104 jours). Les analyses ne lisent que data_storage_* ;
    • les questions à l'expert (disque plein, purge, root, seuils, cas) restent en suspens dans docs/storage/domaine/questions-pour-l-expert.md.
  • Pourquoi : choix de l'utilisateur, qui veut notifier un disque bientôt plein et estimer le temps restant, sans attendre l'expert. Le remplissage de WEISSHORN est assez régulier (28,2 MiB par jour, à l'heure près) pour une première estimation.
  • Options écartées : ajouter NORDEND au jeu de travail (pas de données de /data) ; attendre l'expert avant de coder ; une régression linéaire ou une différence sur 7 jours pour le rythme (sensibles à une purge, fiche days_until_storage_full).
  • Conséquence : la couleur du jour (étape 6 de nouveau-domaine) reste à décider ; LOW et CRITICAL ne sont jamais observés sur WEISSHORN (57 % libre au 13/10, saturation estimée au 06/02/2027).

D-035 — 2026-10-13 — Storage : couleur du jour, matrice état × horizon ; seuils de jours arbitraires

  • Statut : active. Applique le contrat de notification de D-030 au domaine Storage ; complète D-034.
  • Décision :
    • src/storage/day_color.py : la couleur du jour se lit dans une matrice état × horizon, tenue par l'utilisateur dans docs/storage/matrice-etat-horizon.drawio et recopiée dans MATRIX, comme pour Energy (D-020). L'état vient de DAILY_STORAGE_STATE (OK, LOW, CRITICAL) ; l'horizon de DAYS_UNTIL_STORAGE_FULL : WITHIN_14_DAYS, WITHIN_60_DAYS, BEYOND_60_DAYS (60 jours ou plus, ou le disque ne se remplit pas), ou inconnu ;
    • la matrice actuelle revient à prendre la pire des deux analyses. Orange ou Red peut venir d'une seule ; Green demande les deux, sinon le jour est gris (inconnu) ;
    • seuils de jours arbitraires (14 et 60 jours), choix de l'utilisateur pour commencer, comme les planchers de D-034 ;
    • HEADLINE : Red « The station is about to run out of storage space. », Orange « The station's storage space is running low. ».
  • Pourquoi : choix de l'utilisateur, une matrice dessinée comme celle d'Energy. Les deux analyses voient des risques différents : le niveau voit un bloc ponctuel que l'estimation ne prévoit pas (1,3 GiB écrits en deux heures le 31/08 sur WEISSHORN) ; l'estimation voit un disque qui fond, même à un niveau encore confortable.
  • Options écartées : le gris dès qu'une analyse manque, comme Energy (il cacherait un disque CRITICAL dont l'estimation n'est pas encore possible) ; le Green sur le seul niveau (il ignorerait un remplissage rapide pas encore mesuré).
  • Conséquence : sur WEISSHORN, 52 jours Green et 14 gris (début d'historique jusqu'au 22/08, moins de 4 rythmes dans la fenêtre). Au rythme actuel, la station passerait Orange vers le 09/12 et Red vers le 17/01 (CRITICAL). La livraison (étape 7 : figure du site, maquettes, guide, passage des maquettes à une liste de domaines) se fera dans une autre conversation.

D-036 — 2026-10-13 — Pas de domaine Températures pour l'instant

  • Statut : remplacée par D-040 (2026-10-13) : le domaine temperature est créé, sur la limite du GPU donnée par le constructeur. La comparaison au passé reste écartée.
  • Décision :
    • pas de domaine ni d'analyse de température pour l'instant ; l'exploration de VERMONT, WEISSHORN et NORDEND est rangée dans docs/domaine/temperatures-de-la-station.md (devenue docs/temperature/domaine/point-de-depart.md, D-040), avec ses pistes et les questions pour le spécialiste ;
    • la température reste une preuve d'appoint pour Energy (signature d'une coupure, docs/domaine/pieges-des-donnees.md), à combiner avec la tension, pas codée.
  • Pourquoi : choix de l'utilisateur, sur proposition. Aucun épisode de chaleur dans les données (maximum 62,7 °C, NORDEND, le 13/08), aucun seuil du matériel ni de la documentation AIMsight, aucun cas de l'expert : un verdict serait vert tous les jours, ou rouge sur un seuil inventé.
  • Options écartées : un domaine surchauffe comparant la station à son propre passé (il signalerait les jours d'été chauds, pas un défaut) ; l'amplitude du jour comme indice d'ensoleillement pour Energy (corrélation avec la tension maximale du jour de −0,03 à 0,32) ; la température au retour d'un trou comme preuve seule d'une coupure (le trou commun du 19/08 revient aussi ~7 °C sous l'habitude).
  • Conséquence : à reprendre avec les seuils thermiques du matériel, un premier incident annoté, ou les données d'hiver (froid et charge de la batterie LiFePO4).

D-037 — 2026-10-13 — Cellular : couleur du jour, matrice lien × signal

  • Statut : active. Applique le contrat de notification de D-030 au domaine Cellular ; complète D-031 et D-032.
  • Décision :
    • src/cellular/day_color.py : la couleur du jour se lit dans une matrice lien × signal, tenue par l'utilisateur dans docs/cellular/matrice-lien-signal.drawio et recopiée dans MATRIX, comme pour Energy (D-020) et Storage (D-035). Le lien vient de DAILY_LINK_STATE (UP, MISSING, DOWN) ; le signal de DAILY_SIGNAL_STATE (EXCELLENT, GOOD, MID_CELL, CELL_EDGE), ou inconnu (moins de 20 h mesurées sur 24) ;
    • Green : tous les envois sont arrivés, signal connu, quelle que soit sa classe (CELL_EDGE compris). Orange : MISSING ou DOWN avec un signal connu. Red : MISSING ou DOWN avec un signal inconnu, c'est-à-dire une station qui s'est tue 5 h ou plus. Gris : lien inconnu, ou UP avec un signal inconnu (Green demande les deux analyses) ;
    • HEADLINE : Red « The station stopped sending data for a large part of the day. », Orange « The station's 4G connection showed interruptions. ».
  • Pourquoi : choix de l'utilisateur, sur proposition. Le Red reprend MIN_COVERAGE, déjà sourcé, sans nouveau seuil : sur NORDEND, il retient 9 des 11 jours de coupure lourde (23 à 95 envois manquants), et aucun des petits manques (1 à 5 envois).
  • Options écartées : UP × CELL_EDGE en Orange (NORDEND déclencherait une notification 76 jours sur 109 alors que tous ses envois sont arrivés ; la grille ne sépare pas ses bons jours des mauvais, fiche daily_signal_state) ; DOWN en Red dès un échantillon (le down fugitif du 03/09 sur WEISSHORN, les 96 envois arrivés) ; un nombre d'envois manquants comme seuil du Red (pas de source, pas de cas de l'expert).
  • Conséquence : WEISSHORN, 46 jours Green, 7 Orange, 1 Red (20/08, fin de la mise en service), 12 gris ; NORDEND, 76 Green, 20 Orange, 9 Red, 5 gris. Tant que le signal est connu, sa classe ne change pas la couleur. Restent hors de la matrice : le croisement avec Energy, les deux corrections de DAILY_LINK_STATE (le 15/07 de NORDEND repasserait Green) et les seuils du signal, en attente du spécialiste.

D-038 — 2026-10-13 — Dev container : Docker Engine dans WSL, réseau de l'hôte

  • Statut : active. Prépare la communication avec la caméra (API REST, interface web, RTSP, FTP, MQTT ; manuel de la station, « Access Modes » et « Network Settings »).
  • Décision :
    • .devcontainer/devcontainer.json : image mcr.microsoft.com/devcontainers/python:3.14 (la version de .venv), plotly installé à la création, --network=host ;
    • Docker Engine installé dans WSL (script de commodité, dépôt apt de Docker), pas Docker Desktop ;
    • le réseau de WSL reste en mode mirrored (.wslconfig) : WSL, donc le conteneur, voit les interfaces de Windows, dont le lien Ethernet direct vers la caméra (192.168.1.2 par défaut).
  • Pourquoi : choix de l'utilisateur, sur proposition. Le réseau de l'hôte évite de publier un port pour ce que la caméra envoie au poste (FTP, MQTT) ; Docker Engine est le chemin le plus direct vers ce réseau, sans licence.
  • Options écartées : Docker Desktop for Windows (conteneurs dans sa propre distribution WSL, réseau de l'hôte à activer à part, licence payante au-delà d'une certaine taille d'entreprise) ; Docker Desktop for Linux (fait pour un Linux natif, pas pour WSL) ; le réseau bridge (suffit pour joindre la caméra, pas pour en recevoir).
  • Conséquence : vérifié le 2026-10-13 (Docker 29.9.0, Python 3.14.8) : all_analyses.py et final.py tournent sur VERMONT dans le conteneur ; dans le conteneur, les pages ne s'ouvrent pas seules (pas de navigateur), elles restent dans out/. À reprendre quand on connaîtra la version de Python et l'architecture de la station (imiter la station), et la doc de l'API REST (dans l'interface web de la caméra). Le jeton d'API reste hors du dépôt ; les échanges avec la caméra restent en lecture seule.

D-039 — 2026-10-13 — Livraison de Storage et Cellular : maquettes multi-domaines, figures du site, guides

  • Statut : active. Étape 7 de nouveau-domaine pour Storage (D-035) et Cellular (D-037) ; remplace en partie D-022 (script et page de la vue client) et D-025 (VERMONT seule, domaine Energy seul) ; applique le passage multi-domaines prévu par D-030.
  • Décision :
    • vue client : maquettes/user/energy.py devient maquettes/user/summary.py (gabarit summary_template.html), qui écrit une page System Summary par station de data/ : out/maquette_user_<STATION>.html. La section Diagnostic a un bloc par domaine dont la station a les mesures (VERMONT : Energy ; WEISSHORN : Energy, Storage, Cellular ; NORDEND : Energy, Cellular), les autres sont masqués ;
    • chaque bloc garde la forme d'Energy (D-022) : couleur du dernier jour, phrase, deux lignes en mots simples, dérouleurs « Full history » (figure du site du domaine) et « Guide » (partie 1 du guide du domaine). Storage : échelle de l'espace libre (Critical < 10 %, Low < 20 %, OK, planchers de D-034) et date de saturation (« Full around (about N months) ») ; Cellular : envois du jour en mots (« All data received », « N of 96 sends missing », « 4G link reported down ») et échelle du signal en quatre classes, sans dBm, le trait au milieu de la classe du jour ;
    • pas de bouton d'action pour Storage ni Cellular : aucun remède connu (purge, antenne), à revoir avec l'expert ;
    • vue support : maquettes/support/home.py charge toutes les stations de data/ et parcourt DOMAINS = {"Energy", "Storage", "Cellular"} : une notification par station et par domaine Orange ou Red, la plus grave d'abord, avec le lien vers la vue client de la station ;
    • HEADLINE de chaque domaine vit dans src/<domaine>/day_color.py, avec une phrase Green pour la vue client (Green ne notifie toujours rien). Storage Green : « The station has enough storage space. » ; Cellular Green : « The station sent all its data over 4G. » ;
    • figures du site : src/storage/final.py et src/cellular/final.py, sur le modèle de src/energy/final.py (D-021), écrivent out/<STATION>_<domaine>_daily.html + .json. Leurs panneaux, en anglais (D-023), sont partagés avec les pages de comparaison ;
    • guides : docs/storage/guide/diagnostic-stockage.md et docs/cellular/guide/diagnostic-cellulaire.md, en deux couches comme celui d'Energy (D-020), plus courts.
  • Pourquoi : demande de l'utilisateur, qui veut Storage et Cellular dans les maquettes avec le même protocole qu'Energy, et un petit guide par domaine. Choix des blocs validés par l'utilisateur, sur proposition ; la page support réunit déjà toutes les stations, la vue client reste celle d'une station, comme sur le site.
  • Options écartées : une seule vue client, WEISSHORN (VERMONT perdrait son histoire Energy de septembre) ; le bloc Cellular sans le signal (choix de l'utilisateur : les deux analyses, comme Energy) ; le bloc Storage sans échelle.
  • Conséquence :
    • sur la fenêtre par défaut (18/09-28/09), Storage et Cellular sont Green : la seule notification reste VERMONT Energy Red. La fenêtre 2026-08-12 2026-08-22 montre NORDEND Cellular Red et WEISSHORN Cellular Orange ;
    • la livraison de Cellular précède les réponses du spécialiste : les deux corrections de DAILY_LINK_STATE et les seuils du signal restent en attente (D-037) ;
    • le tableau des métriques de la vue client écarte les identifiants (SIM_CCID, ip*) et les métriques texte ;
    • points ouverts : les guides sont en français dans une page en anglais (comme Energy, D-022) ; le panneau DAYS_UNTIL_STORAGE_FULL montre en vue complète le pic de 7 798 jours du 23/08 sur WEISSHORN, qui écrase l'échelle (zoom nécessaire) ; le jour affiché n'est pas encore signalé comme provisoire côté client.

D-040 — 2026-10-13 — Domaine Temperature : limite du GPU donnée par le constructeur, sur 24 h

  • Statut : active. Remplace D-036. Étapes 1 à 6 de nouveau-domaine ; la figure du site et le guide (étape 7) ne sont pas faits.
  • Décision :
    • domaine temperature (src/temperature/, docs/temperature/), une analyse : DAILY_GPU_TEMPERATURE_LIMIT. Chaque jour UTC, une moyenne horaire de sensor_GPU_deg_c a-t-elle atteint 97,5 °C dans les 24 h qui finissent à la dernière heure du jour (la journée entière pour un jour fini, les 24 dernières heures pour le jour en cours) ?
    • seuil : T.gpu = 97,5 °C, température maximale de fonctionnement du Jetson Nano Thermal Design Guide (table 2-1, § 4.3), au-delà de laquelle le module réduit ses performances. Carte supposée : Jetson Nano (zones thermiques du collecteur), à confirmer sur une station ;
    • couleur du jour (src/temperature/day_color.py) : Red si la limite est atteinte, Green sinon, gris sans mesure dans les 24 h. Pas d'orange ni de matrice ;
    • jeux de travail : WEISSHORN et NORDEND, les seuls avec le GPU. VERMONT (ancien collecteur) n'a pas le domaine ;
    • la note d'exploration docs/domaine/temperatures-de-la-station.md devient docs/temperature/domaine/point-de-depart.md.
  • Pourquoi : demande de l'utilisateur, à qui l'on a conseillé de faire tout de même le domaine : très simple, avec un seuil du matériel, pas inventé (ce qui manquait à D-036). La fenêtre de 24 h garde visible un dépassement qu'on aurait manqué en ne regardant qu'au moment où il se produit.
  • Options écartées : comparer la station à son propre passé (D-036) ; un orange dans la marge de ± 3 °C de précision du capteur (simple d'abord, aucun épisode connu) ; le CPU en plus du GPU (T.cpu = 97 °C, le CPU lit jusqu'à 2,5 °C de plus que le GPU : à reprendre après un premier épisode) ; un verdict limité au jour UTC (un dépassement à 23 h disparaîtrait le lendemain).
  • Conséquence : tous les jours mesurés sont Green (maximum 57,2 °C sur NORDEND, 50,9 °C sur WEISSHORN, à plus de 40 °C de la limite). Pas de cas de l'expert : le Red n'a jamais été observé. Les moyennes horaires peuvent cacher un pic bref (fiche, « Limites connues »). Restent la figure du site et le guide.

D-041 — 2026-10-13 — Livraison de Temperature : figure du site, maquettes, guide

  • Statut : active. Étape 7 de nouveau-domaine pour Temperature ; complète D-040, sur le modèle de D-039.
  • Décision :
    • src/temperature/final.py écrit la figure du site (out/<STATION>_temperature_daily.html + .json) : le panneau DAILY_GPU_TEMPERATURE_LIMIT seul, partagé avec la page de comparaison ;
    • maquettes : Temperature rejoint DOMAINS côté support (notification Red) et côté client (bloc sur WEISSHORN et NORDEND ; VERMONT n'a pas le GPU). Le bloc a une seule ligne, en texte : « Hottest (24 h) 43 °C · limit 97.5 °C », la plus haute moyenne horaire des 24 h et la limite du constructeur. Pas de bouton d'action ;
    • guide docs/temperature/guide/diagnostic-temperature.md, en deux couches comme les autres.
  • Pourquoi : demande de l'utilisateur, même méthode que Storage et Cellular. Bloc en texte, choix de l'utilisateur sur proposition : un °C se comprend sans être spécialiste, contrairement à une tension.
  • Options écartées : une échelle de 0 à 110 °C (bornes d'affichage sans source).
  • Conséquence : sur les données reçues, Temperature est Green tous les jours mesurés : aucune notification support. Le panneau place les jours inconnus à 0 °C (marqueur gris), repris tel quel de la page de comparaison.

D-042 — 2026-10-13 — Enquête à la demande : un agent qui explique un événement de mesure (exploratoire)

  • Statut : active, exploratoire (docs/agents/enquete-a-la-demande.md, rien n'est construit). Complète D-027 sans la remplacer : une approche auxiliaire, plus simple, sur le même cadre ; remplacée en partie par D-048 (la base de cas n'est plus chargée dans le prompt).
  • Décision :
    • pour les données de mesure (déplacements, compensation, références), un agent enquête à la demande : une session par question sur un événement, pas une surveillance quotidienne. Il suit le support query workflow des docs AIMsight (inventaire, bas de la chaîne d'abord, faits, hypothèses, réfutation obligatoire de l'hypothèse principale, conclusion) ;
    • enquêteur avec des outils typés, en lecture seule, définis par famille de preuves et non par format (sources encore inconnues) : inventory, get_series, compare_before_after, common_mode, get_system_health (couleurs du jour déjà livrées), get_image (si une source existe), et submit_diagnosis au format structuré des §14-15 du contexte support. Les outils de calcul renvoient des valeurs, pas des verdicts ;
    • destinataire : le support d'abord (il relit, corrige et envoie le brouillon client), puis le client directement pour les classes sans enjeu pour l'ouvrage ;
    • déclenchement : le support à la main, puis un bouton client sur le site, puis une détection automatique sur des critères tirés des tickets ;
    • garde-fous tenus par le code : chaque preuve cite un appel d'outil du journal de session ; règle d'asymétrie : le brouillon ne dit « sans conséquence pour l'ouvrage » que si l'artefact est au moins strongly supported et le mouvement de l'ouvrage réfuté ; budget par enquête ;
    • une enquête validée par le support devient un cas de la base de cas, chargée dans le prompt tant qu'elle y tient ;
    • démarrage : (1) harnais sur UC3 avec les données existantes (coupures de NORDEND et WEISSHORN), (2) rejeu d'un cas de déplacement résolu, (3) vrais tickets du support, (4) bouton client, (5) réponse directe, puis détection automatique.
  • Pourquoi : demande de l'utilisateur. Le client voit les données de mesure sans savoir les interpréter ; lors d'un événement, il ne peut pas dire s'il est grave ou anodin, et sollicite le support. Le but est de lui répondre automatiquement, avec preuves. Choix de l'utilisateur sur proposition : support d'abord (asymétrie du risque : une fausse assurance coûte plus qu'une fausse alerte), déclenchement par le support d'abord, approche à outils typés.
  • Options écartées :
    • dossier de preuves puis un seul appel de rédaction (l'explainer de la roadmap) : l'agent ne peut pas creuser ; il reste le premier message, en version réduite ;
    • bac à sable de code : calculs non relus, risque de seuils inventés, difficile à auditer. Reste un recours ;
    • réponse directe au client et détection automatique dès le départ ;
    • l'agent qui extrait station, instant et points du texte du client, tant que le support lance l'enquête ;
    • recherche de cas (RAG) tant que les cas tiennent dans le prompt.
  • Conséquence : même cadre que D-027 (harnais maison, Tool Runner, dossier déclaratif sous agents/, proposé). Coût estimé ~1 $ par enquête, à mesurer à l'étape 1. Prérequis : une clé API Anthropic ; pour l'étape 2, un export de déplacements avec un événement expliqué. Questions ouvertes (sources, liste des classifications, seuils des outils, critère d'ouverture au client) : §9 du document.

D-043 — 2026-10-13 — Energy : cas particulier de la station sur secteur (DAILY_POWER_SOURCE)

  • Statut : active. Complète D-020 (couleur du jour) et D-021 (figure du site) ; précise D-009 pour cette analyse. Analyse renommée DAILY_POWER_SOURCE (ex-DAILY_MAINS_POWER) le jour même, choix de l'utilisateur.
  • Décision :
    • une nouvelle analyse, DAILY_POWER_SOURCE, déduit chaque jour si la station est sur secteur : moyenne de BusVoltage sur les 3 jours avant J ≥ 14,0 V (demande de l'utilisateur : moyenne glissante sur 3 jours, batterie toujours pleine) ;
    • sur secteur, la perte du secteur décide de la couleur, sans la matrice : rouge dès qu'une heure de J passe sous 13,4 V, vert sinon. Hors secteur (ou statut inconnu), la matrice état × tendance s'applique, inchangée. Le drawio de la matrice a les deux cas ;
    • la notification du support et l'en-tête du bloc Energy de la vue client affichent le statut : On mains, Not on mains ou Mains unknown ; la figure du site a un troisième panneau, sous l'état et la tendance ;
    • vérification sur les stations secteur réelles : WEISSHORN et NORDEND (data/), et FLORIDA et MISSISSIPPI relues depuis l'historique git sans revenir dans data/ (D-033).
  • Pourquoi : demande de l'utilisateur. Sur secteur, la batterie sert d'UPS et reste pleine : la matrice lit le jour de la perte FULL_CHARGE (vert) et ne passe au rouge que 29 à 40 h plus tard (MISSISSIPPI), alors qu'une batterie de 7 Ah tient ~15 h. La règle secteur donne le rouge 1 à 2 h après la perte.
  • Options écartées : perte = une heure sous 14,0 V (WEISSHORN aurait été rouge 31 jours sur 52 sans coupure, ses moyennes horaires descendent à 13,9 V, celles de NORDEND à 13,65 V) ; une fenêtre qui inclut l'heure courante (la coupure ferait perdre le statut en ~12 h) ; un statut collant pendant la coupure (reporté, fiche « Pistes »).
  • Conséquence : day_color.run() fusionne les faits des trois analyses (power, hours_lost en plus) ; focus_jour.py cite la règle secteur quand elle a décidé ; limites dans la fiche docs/energy/analyses/daily_power_source.md, dont 3 jours sans statut après chaque coupure.

D-044 — 2026-10-14 — Séries optiques : détecter les événements externes et corriger les courbes (cadrage)

  • Statut : active, cadrage (docs/displacement/cadrage.md, rien n'est construit) ; l'exploration passe d'abord par l'agent de diagnostic (D-046), la chaîne analytique au second plan.
  • Décision :
    • nouveau chantier, premier du cas d'usage « déplacements » : détecter dans les séries optiques les événements externes à l'ouvrage (occlusion passagère, eau ou neige, turbulence, éclairage), les expliquer, et produire une courbe corrigée ;
    • couche déterministe, analytique et embarquable (D-003), domaine displacement (src/displacement/, docs/displacement/, D-026) ; chaîne en trois étapes : qualifier chaque observation (poids continu), détecter et classer les événements, corriger ;
    • la série brute n'est jamais remplacée : la corrigée est une série dérivée, chaque point modifié porte sa raison ; on ne corrige que si la cause externe est au moins strongly supported ;
    • démarrage par étapes : données, exploration, occlusion passagère, médiane glissante, précipitation, turbulence (HDF5), puis branchement sur l'enquête à la demande (D-042).
  • Pourquoi : demande de l'utilisateur. Les événements externes laissent des pics, du bruit ou des trous que le client peut prendre pour un mouvement. La station filtre déjà par un seuil d'erreur muet (0,7) ; la valeur ajoutée est de dire pourquoi, de graduer et de signaler sans qu'on le demande.
  • Options écartées : remplacer la série brute ; lisser sans détecter ; modèle appris ou LLM dans cette couche ; données synthétiques ; décision sur inlier binaire.
  • Conséquence : prérequis bloquant : un export de déplacements à la cadence native avec des événements connus (data/ n'a que des métriques système), idéalement le HDF5. Questions ouvertes : §7 du cadrage.

D-045 — 2026-10-14 — Données optiques : rangement et premier jeu de travail (PS des Coudres)

  • Statut : active ; noms d'origine et versionnement des exports remplacés par D-065. Précise D-029 (données par station) et D-044 (données nécessaires, §5 du cadrage).
  • Décision :
    • les exports de déplacements d'une station vont dans data/<STATION>/displacement/, noms de fichiers d'origine gardés (provenance), dossier de station sans espace (PS_DES_COUDRES pour « PS des Coudres ») ;
    • premier jeu de travail de displacement : PS des Coudres (Suisse), du 08/10 22:00 au 14/10 09:45 UTC, une station seule pour commencer. Choisie par l'utilisateur : un système qui marche bien, avec sans doute de la buée le matin ;
    • source des analyses : l'export « advanced » (cadence native de 15 min, UTC explicite, une ligne par capteur et par mesure, références comprises). L'export horaire est gardé comme source des facteurs entre corr_x/corr_y et les déplacements horaires, pas comme entrée ;
    • les CSV sont versionnés (1,8 Mo pour 5,5 jours). Formats et colonnes : docs/domaine/colonnes-des-deplacements.md ;
    • images de la caméra, extraites à la main par l'utilisateur : data/PS_DES_COUDRES/images/, une par heure pleine du 13/10 12:00 au 14/10 11:00 UTC (24), nommées <AAAAMMJJ>T<HHMM>Z_<numéro d'origine>.jpg. Heures en UTC : confirmé par l'utilisateur, et cohérent avec le coucher et le lever du soleil (nuit dès 17:00Z, aube à 06:00Z). Versionnées (5,4 Mo ; ni personne ni véhicule visible). Elles servent de vérité de référence, pas d'entrée : la détection doit tourner sur la station à partir des mesures seules.
  • Pourquoi : demande de l'utilisateur (intégrer les données d'une station sur une plage choisie). load_stations lit les *.csv du dossier de la station sans descendre dans les sous-dossiers : les scripts des métriques système ne voient pas les exports optiques.
  • Options écartées :
    • les exports directement dans data/<STATION>/ : tous les scripts des métriques système les liraient, ou les signaleraient comme ignorés ;
    • l'export horaire comme entrée : la moyenne horaire efface un passage, ses horodatages sont en heure locale sans fuseau, il n'a pas les références.
  • Conséquence :
    • aucun événement annoté sur la plage : la buée est un contexte de l'utilisateur, pas une vérité de référence. Deux épisodes nocturnes de l'erreur de REF_G et REF_D (13/10 et 14/10) en sont des candidats, consistent with au plus. Les images couvrent le second (13/10 23:45 → 14/10 04:45 UTC), pas le premier ;
    • le HDF5 et la raison du seuil d'erreur de PM_G (0,3) sont inconnus de l'utilisateur ; l'unité de corr_x/corr_y est à confirmer : questions 3, 9 et 10 du cadrage (§7).

D-046 — 2026-10-14 — Agent de diagnostic : pilote de l'enquête à la demande dans Claude Code

  • Statut : active ; modèle et effort remplacés par D-063 (ceux de la session). Version pilote de D-042 ; déroge à D-027 sur le harnais, pour ce pilote seulement ; met au second plan la chaîne analytique de D-044.
  • Décision :
    • un sous-agent Claude Code diagnostic (.claude/agents/diagnostic.md), avec son dossier agents/diagnostic/ (instructions, outils, rapports), diagnostique à la demande un dossier de data/ : scan sans question, enquête avec une question ; un rapport par diagnostic dans agents/diagnostic/rapports/, avec une section de validation pour l'utilisateur ;
    • première version : déplacements (export « advanced ») et images ; métriques système plus tard ;
    • outils en lecture qui rendent des valeurs, pas des verdicts : inventaire.py, resume.py, graphique.py (matplotlib, ajouté à .venv et au dev container) ;
    • Opus 5.5, effort high ; omitClaudeMd : l'agent ne lit que les sources listées dans ses instructions, pour diagnostiquer sans connaître nos conclusions ;
    • spec : docs/agents/agent-diagnostic.md.
  • Pourquoi : demande de l'utilisateur : profiter de la souplesse d'un agent plutôt que d'écrire des méthodes analytiques complexes, et pouvoir l'appeler à tout moment. Claude Code ne demande ni clé API ni harnais, prérequis bloquants de D-027 et D-042.
  • Options écartées : un skill dans la conversation courante (il hériterait des hypothèses de la conversation) ; un skill seul avec context: fork (caché sous .claude/) ; les graphiques par plotly (kaleido embarque un navigateur) ; pas de graphique (l'agent verrait mal les formes des séries).
  • Conséquence :
    • D-027 avait écarté un harnais de codage pour l'agent serveur, à cause d'un Bash large et peu auditable ; ce refus vaut toujours pour un agent qui notifie des clients. Ici, outil de travail interne : Claude Code ne restreint ni Read, ni Bash, ni Write à des chemins ; les instructions le font, et le rapport liste ses sources ;
    • pas de LLM dans src/ : la couche déterministe ne change pas ;
    • vérification par un test à l'aveugle sur PS des Coudres, attendus écrits avant le premier passage (§7 de la spec).

D-047 — 2026-10-14 — Agent de diagnostic : rapports courts, preuves en figures, anomalies seules

  • Statut : active. Révise le format du rapport de D-046.
  • Décision :
    • le rapport ne garde que les anomalies : un écart daté au comportement habituel du capteur ; une même signature, même répétée, fait une seule anomalie ; ce qui dure toute la période (réglage, capteur toujours rejeté, cycle régulier) tient en une ligne dans « Hors anomalie », sans enquête ;
    • format : un verdict en 2-3 phrases, une section courte par anomalie (constat, figures, une ligne de classification et de preuve, une de réfutation, une d'inconnus), les commandes repliées, sources et inventaire en annexe ; corps en ~40 lignes ;
    • chaque anomalie est montrée : graphique de la série (fenêtre grisée, capteur témoin) et vignettes des images à pleine résolution autour des capteurs ; un dossier par rapport, rapport.md et ses PNG, versionnés ;
    • outils : graphique.py gagne --zone et --sortie ; nouveau vignettes.py (matplotlib), centré sur les colonnes x et y ;
    • les deux premiers rapports sont supprimés (historique git).
  • Pourquoi : demande de l'utilisateur, après le premier passage sur PS des Coudres : trop de matériel. Le spécialiste juge le système sain, avec un seul point d'attention, les pics d'erreur de REF_G et REF_D ; l'agent les avait trouvés, mais noyés parmi trois événements et cinq constats permanents, sans figure dans le rapport. Read réduit une image entière : un petit réflecteur n'y est pas lisible, une vignette à pleine résolution le montre.
  • Options écartées : nommer REF_G et REF_D dans les instructions (le test ne serait plus à l'aveugle) ; un rapport HTML (le Markdown avec images suffit et reste lisible dans le dépôt) ; les figures dans out/ (non versionné, le rapport perdrait ses preuves).
  • Conséquence : l'avis du spécialiste devient le cas de référence de l'agent (§7 de docs/agents/agent-diagnostic.md) ; des PNG entrent dans le dépôt, quelques centaines de Ko par rapport.

D-048 — 2026-10-14 — Agent de diagnostic : une base de cas validés, consultée après les faits

  • Statut : active, construite le 2026-10-14 (spec : §11 de docs/agents/agent-diagnostic.md) ; remplacée en partie par D-050 (les données vont dans le cas) et D-051 (format de la fiche, plus d'exclusions) ; un cas, C-001 ; ajout d'un cas par le skill /nouveau-cas, lancé par l'utilisateur seul. Remplace en partie D-042 (base de cas chargée dans le prompt).
  • Décision :
    • une base de cas validés par l'expert, agents/diagnostic/cas/ : INDEX.md, une ligne par incident (signature observable, classification, cause, verdict), et un dossier par incident avec sa fiche cas.md (symptôme, signature, exclusions, diagnostic de l'expert avec conséquence pour l'ouvrage et action en listes fermées, attendu de l'agent, inconnus, figures, test à l'aveugle) ; les données restent dans data/ ;
    • l'agent lit l'index après avoir établi ses faits, ouvre au plus 3 fiches par anomalie et coche critères et exclusions avec ses outils : correspondance complète, partielle ou aucune ;
    • sans correspondance, il rend les faits et ses hypothèses marquées « non validé », pour le support ;
    • règle d'asymétrie : « aucune conséquence pour l'ouvrage » ne sort que d'une correspondance complète ;
    • un cas n'entre dans la base que sur demande explicite de l'utilisateur, après un passage de l'agent à l'aveugle comparé à l'avis de l'expert ; la base démarre vide.
  • Pourquoi : demande de l'utilisateur : le diagnostic marche mais manque de déterminisme ; l'agent reçoit tout et peut conclure hors sujet. Usage visé : un bouton « Analyze » sur une plage sélectionnée, dont il faut contrôler la sortie. Ancrer le verdict sur des cas validés suit le §17 du contexte support (historical cases used like software tests). Choix de l'utilisateur sur proposition : index lu par l'agent, une fiche par incident, cas reçus avec l'avis de l'expert, hypothèses « non validé » hors cas.
  • Options écartées : RAG vectorielle (inutile à quelques dizaines de cas ; deux cas se ressemblent par leur signature, pas par leur texte ; service d'embeddings tiers) ; fiches dans les instructions (ancrage avant les données) ; une fiche par type ; toujours le cas le plus proche (ancrage) ; faits seuls hors cas (le support repart de zéro).
  • Conséquence : un cas est aussi un test de régression (retirer sa ligne de l'index pour le rejouer) ; filtre structuré ou RAG quand l'index ne tiendra plus en une lecture ou que la question arrivera en texte libre.

D-049 — 2026-10-14 — Base de cas : noms de station et de capteurs codés

  • Statut : active (skill anonymiser-cas, appelé à l'étape 5 de /nouveau-cas) ; appliquée à C-001, dont le test de correspondance réussit avec les codes ; remplacée en partie par D-050 (plus de code de station, plus de --alias).
  • 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.

D-050 — 2026-10-15 — Base de cas : les données dans le cas, la station au numéro du cas

  • Statut : active ; appliquée à C-001 (agents/diagnostic/cas/C-001/). Remplace en partie D-048 (données laissées dans data/) et D-049 (code de station S01, option --alias).
  • Décision :
    • le dossier d'un cas s'appelle C-xxx/ et contient ses données : displacement/ et images/ de la station, copiés entiers, noms des capteurs codés dans les CSV et les noms de fichiers ; data/<STATION>/ garde l'original ;
    • la station n'a plus de code : partout dans la base, elle prend le numéro du cas ; les capteurs gardent leurs codes R1, C1 ; le registre relie chaque cas à sa station (ligne <station>,<station>,C-xxx) ;
    • les commandes et les figures d'une fiche portent le dossier du cas et se rejouent telles quelles ; graphique.py et vignettes.py perdent --alias, inutile sur des données déjà codées.
  • Pourquoi : demande de l'utilisateur à la revue de C-001 : un cas doit porter ses données, et S01 n'apportait rien de plus que le numéro du cas ; les commandes en data/S01/ ne se rejouaient pas.
  • Options écartées : citer data/<STATION>/ par son code et traduire par le registre (une commande qui ne tourne pas telle quelle) ; copier la seule fenêtre du cas (le niveau habituel, en MAD, se calcule sur toute la période de l'export) ; garder les vrais noms dans les données copiées (la fiche codée ne s'y rejoue plus, et l'agent pourrait les lire).
  • Conséquence : un cas pèse ses données (C-001 : ~7 Mo, dont 5,4 Mo d'images, identiques à celles de data/ pour git) ; inventaire.py sur un dossier de cas compte ses figures comme des images sans heure ; seuls displacement/ et images/ sont copiés : les mesures système d'une station et leurs identifiants (SIM_CCID, ip) n'entrent pas dans un cas.

D-051 — 2026-10-15 — Base de cas : une fiche courte, lisible d'abord par un humain, sur ce seul cas

  • Statut : active ; appliquée à C-001, revu avec l'utilisateur le 2026-10-15 (modèle : §11.3 de docs/agents/agent-diagnostic.md) ; test de correspondance non relancé sur la fiche revue, par choix de l'utilisateur (le dernier, du 2026-10-14, portait sur l'ancien format). Remplace en partie D-048 (sections de la fiche, exclusions dans la correspondance).
  • Décision :
    • la fiche est le diagnostic de l'expert sur ce seul événement, produit par l'agent puis aligné sur son avis ; elle ne prévoit pas les autres cas et ne raconte pas ses tests ;
    • en-tête : lieu (région, pays), événement (date, heures UTC), date de création du cas ; puis six sections : Résumé, Symptôme, Verdict (pour un humain, sans chiffre ; la cause garde son niveau de preuve), Signature (critères avec leur commande sur les données du cas), Diagnostic (listes fermées, mécanisme en une phrase, faits qui pourraient tromper l'agent avec le jugement de l'expert), Preuves (chaque légende cite les critères qu'elle montre) ;
    • retirées : Exclusions, Attendu de l'agent, Inconnus (ce qui ne se tranche pas va dans la ligne Cause), Test à l'aveugle (résultats dans rapports/ et les messages de commit), citation de l'expert (seul son mécanisme reste) ;
    • correspondance : complète = tous les critères vérifiés ; partielle = aucun critère contredit, certains non vérifiables ; aucune = un critère contredit ;
    • index : colonnes Événement, Cause (avec niveau de preuve) et Verdict court.
  • 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 ;
    • rangement : tout le chantier vit à part, dans vues-deplacements/ (contexte, cas réels avec leurs données, pages de la plateforme et parcours de l'utilisateur, puis le code), avec sa propre carte, vues-deplacements/CLAUDE.md ; ses données n'entrent pas dans data/ (D-029), comme celles de la base de cas (D-050).
  • Pourquoi : demande de l'utilisateur, qui est l'expert, et qui veut aussi encapsuler ce gros développement à part. 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.

D-053 — 2026-10-16 — Vues des déplacements : maquette de la page Explore avec un onglet Diagnosis, vue d'ensemble d'abord

  • Statut : active, précisée par D-054 (l'image à T, le détail d'un capteur et la grille quittent Diagnosis ; les images passent dans View).
  • Décision :
    • première vue du chantier D-052 : une maquette HTML de la page Explore de la plateforme, avec ses deux onglets (Time Series, Advanced) et un troisième, Diagnosis, un ensemble de visualisations pour le diagnostic côté support (l'expert), peut-être côté client plus tard ;
    • entrée par une vue d'ensemble, d'où l'on déplie les capteurs qui intéressent : l'image de la caméra à un instant T, chaque capteur marqué à sa position, et une grille capteurs × temps colorée par l'écart au niveau des 24 premières heures de la fenêtre, mesuré en variation d'un pas à l'autre (le critère du rapport PR17 de l'agent), reliées ; le détail d'un capteur commence minimal et se remplit pas à pas avec l'utilisateur ;
    • les deux onglets existants sont un décor : les captures de la plateforme, telles quelles ;
    • construction : un script Python et un gabarit HTML (plotly.js), comme maquettes/ ; code et spec dans vues-deplacements/maquette/ (spec : spec.md).
  • Pourquoi : demande de l'utilisateur ; une anomalie se lit en deux questions, où (l'image : dépôt sur la vitre, traînée sur CTR03 et PR18) et quand, local ou commun (la grille : une ligne ou une colonne) ; l'utilisateur ne sait pas encore ce que doit montrer le détail et préfère avancer doucement.
  • Options écartées : entrer par une cible choisie, ou par le rapport de l'agent (« un peu des trois », mais la vue d'ensemble d'abord) ; colorer la grille par l'écart à la médiane de toute la fenêtre (MAD, comme resume.py) : le palier de PR17, plus de la moitié de la fenêtre, déplace la médiane, et la ligne s'allume avant le saut au lieu de pendant ; par l'écart aux 24 h glissantes : seuls les sauts s'allument, pas le palier ; redessiner les deux onglets existants depuis les exports (plus de code pour un décor, et sans le panneau Camera movement, absent des exports) ; figures construites en Python (la liaison image ↔ grille demande de toute façon du JS) ; fichier autonome aux images embarquées (985 images, basse résolution, réflecteurs illisibles).
  • Conséquence : la page ne marche que sur le poste (images référencées dans vues-deplacements/cas/) ; elle sert de cadre aux étapes suivantes : détail d'un capteur, agent dans la page.

D-054 — 2026-10-16 — Maquette Explore : View pour les images, Diagnosis pour les données et la demande à l'agent

  • Statut : active ; précise D-053 (l'image à T, le détail d'un capteur et la grille capteurs × temps quittent Diagnosis).
  • Décision :
    • onglet View : ce que voit la caméra. Les images une à une (glisseur, clavier, film, comparaison à ±24 h), chaque capteur cerclé et coloré selon error_value face à son seuil, deux bandes sous le glisseur (système entier, cible choisie), et le gros plan d'une ou plusieurs cibles centré sur x, y de chaque image, avec les images d'avant et d'après ;
    • onglet Diagnosis : ce que disent les données. Les courbes des cibles choisies (déplacements en mm de l'export horaire, comme la page Time Series, et error_value de l'export « advanced »), une plage (la fenêtre visible) et Analyze by AI, qui compose la demande à l'agent de diagnostic pour ces cibles et cette plage, sans la lancer ;
    • l'instant et les cibles passent d'un onglet à l'autre.
  • Pourquoi : demande de l'utilisateur. Il distingue deux usages des images. Elles servent à juger l'aspect d'une cible (perte de visibilité, obstacle), d'une heure ou d'un jour à l'autre. Elles ne servent pas pour un déplacement fin : le saut de PR17 (−0,26 px) ne se voit pas à l'œil, même en gros plan. Ce qui ne se voit pas se lit dans les données, puis se confie à l'agent.
  • Options écartées :
    • une image dans Diagnosis : elle ferait doublon avec View ;
    • garder la grille capteurs × temps de D-053 : son écart « en pas » restait abstrait pour l'utilisateur, et View montre déjà l'état du système ;
    • un cadre fixe autour d'une position de départ, avec des repères (x, y, position corrigée par corr, amplification ×10) : le déplacement fin ne s'y voyait pas et les repères embrouillaient la lecture ;
    • corr_x / corr_y (px) pour les courbes : moins parlants pour l'utilisateur que les mm de la plateforme ; l'heure suisse de l'export horaire se convertit en UTC ;
    • lancer l'agent depuis la page et montrer sa sortie : la forme de cette sortie reste à décider.
  • Conséquence : la sortie de l'agent dans la page et les annotations d'épisodes par l'expert, à croiser avec l'agent, viendront plus tard ; spec : vues-deplacements/maquette/spec.md.

D-055 — 2026-10-16 — Déplacements : détection mécanique des anomalies, en commençant par les changements de régime

  • Statut : active ; très expérimental, la méthode et l'onglet Displacements (construit le 2026-10-16) évolueront à l'essai.
  • Décision :
    • une facette du diagnostic des déplacements : un traitement des données finales (mm) qui fait ressortir lui-même les courbes intéressantes, pour un diagnostic poussé ou pour écarter le bruit, sans modifier les données ;
    • premier angle : les changements de régime, un déplacement qui ne revient pas à sa place, par opposition aux mouvements périodiques ou saisonniers (météo, température, soleil) ;
    • à montrer dans un onglet Displacements de la page Explore de la maquette (d'abord une page à part dans la barre latérale, déplacée en onglet le jour même, à la demande de l'utilisateur).
  • Pourquoi : demande de l'utilisateur après le cas NORDEND. Sur la page des déplacements, beaucoup de courbes fluctuent sans rien révéler ; le saut de PR17 le 08/10 n'y ressort pas de lui-même. Un premier essai (médiane des 24 h après moins celle des 24 h avant, rapportée à l'amplitude journalière de la cible) fait sortir PR17 seule (4,7 contre ≤ 1,2 pour les autres) et rien sur les jeux sains : vues-deplacements/contexte/detection-d-anomalies.md.
  • Options écartées : corriger les courbes (c'est D-044, un autre chantier) ; partir des inlier ou de sigma0 (règles du projet).
  • Conséquence : un saut commun à plusieurs cibles (CLARIDEN) se montre comme un seul événement de mode commun ; « sans retour » se lit comme « un saut qui dure, avec ce qu'il en reste à la fin » (PR17 revient en partie le 12/10).
  • Précision (2026-10-16, demande de l'utilisateur) : deux analyses, ce que le client regarde dans les déplacements : tous les sauts de la plage (changement brutal qui dure, retours compris) et les tendances (hausse ou baisse lente, faite de petits décalages, signe possible d'une dégradation). Méthode : vues-deplacements/contexte/detection-d-anomalies.md.

D-056 — 2026-10-23 — Déplacements : le journal du matin du client, simple et côté support, prototypé dans Support-Agent

  • Statut : active ; prototype, construit avec une équipe d'agents (un par piste) à partir du 2026-10-23.
  • Décision :
    • une anomalie de déplacement, pour le client, c'est d'abord un moment où il ne faut pas se fier aux données (pluie, buée, neige, toile d'araignée, train, feuilles, soleil, turbulence, cycle thermique, perte de références), rarement un vrai mouvement ;
    • un onglet Journal de la maquette Explore : les courbes en px (corr_x, corr_y) sur quelques jours, toutes les données gardées, des barres étiquetées dessous et les zones à ignorer grisées ;
    • des détecteurs élémentaires, un fichier chacun dans vues-deplacements/detectors/ (visibilité, sauts, cycle thermique, turbulence, trous), même contrat d'épisode ;
    • on prototype dans Support-Agent, pas dans le dev container de l'application ; on portera ce qui convainc.
  • Pourquoi : échange de l'utilisateur avec son supérieur : le projet s'est éparpillé dans des analyses complexes ; le client veut savoir chaque matin ce qui s'est passé et ce qu'il peut ignorer. Dans le dev container, Claude ne voit rien et chaque essai demande un relancement. Brainstorming complet : vues-deplacements/contexte/journal-du-matin.md.
  • Options écartées pour l'instant : lisser ou corriger les courbes (second volet, à l'étude : vues-deplacements/contexte/lissage.md) ; faire tourner un LLM quand le client ouvre la page (Claude règle les scripts hors ligne).
  • Conséquence : les onglets Displacements (D-055) et Diagnosis restent, au second plan ; récupérer les données en masse et boucler Claude dessus est à l'étude (vues-deplacements/contexte/donnees-et-boucle.md).
  • Précision (2026-10-23, retour de l'utilisateur sur la v0) : le journal donne un diagnostic catégorique : chaque événement reçoit une catégorie de la carte des événements (docs/displacement/domaine/carte-des-evenements.md), dite sans « probably », et la catégorie déclenche son processus (perte de visibilité : invalider la zone et montrer les images). Suite planifiée dans docs/superpowers/plans/2026-10-23-journal-du-matin.md.
  • Précision (2026-10-24, point 3 du plan) : la carte des événements recense tout ce qui peut arriver, vu ou non dans les données (un ouvrier qui heurte une cible, un objet posé devant, une vitre sale…) : un événement n'a pas besoin d'un cas pour y entrer, il est marqué « hypothétique ». Les événements sont rangés en six familles calquées sur les familles d'hypothèses d'AIMsight (contexte support §12) : pas de mesure, vue gênée, cible changée, références, caméra et support, ouvrage qui bouge. On part de cette base (33 événements) et on la complète au fil des cas. Option écartée : relancer un agent cartographe, plus coûteux pour le même résultat.
  • Précision (2026-10-24, point 4 du plan) : une anomalie, c'est tout ce qui sort de la norme, tout ce qui fait que les courbes ne sont pas plates alors que rien ne bouge. Dans l'écrasante majorité des cas, elle est sans gravité : un moment où il ne faut pas se fier aux données (familles A à E de la carte des événements). Parfois elle est grave : un vrai mouvement de l'ouvrage (famille F), comme à Barcelone (C-004), où la voûte du pont s'affaisse. Le journal montre les deux, avec leur catégorie.
  • Catégories du journal, validées le 2026-10-24 (point 5 du plan) : huit catégories, visibilite_perdue (Loss of visibility), passage (Passing obstacle), cible_masquee (Target hidden), turbulence (Heat haze), cycle_thermique (Daily thermal cycle, normal, pas grisé), trou (No data, label aussi retenu dans la carte), saut_bref (Brief jump, saut revenu sans rien autour), a_verifier (Shift to check, jamais grisé) ; bouton Images pour toutes sauf turbulence, cycle thermique et trou ; deux niveaux de visibilité sur le principe (point 38) ; un saut revenu pendant une perte de visibilité ou une turbulence est absorbé, un saut durable ou récent jamais (la reprise de C-002 le 31/07 à 20:30 reste à vérifier) ; les trains de C-005 sont un passage (effet optique). Détail : docs/displacement/domaine/carte-des-evenements.md, section 4.
  • Statuts de visibilité, validés le 2026-10-24 (point 38 du plan) : la perte de visibilité a deux niveaux, mesure par mesure dans les épisodes du détecteur visibilite : « No visibility » (au moins la moitié des cibles habituellement vues rejetées : on ne voit rien), grisée, et « Reduced visibility » (données moyennes), gardée en léger retrait, barre orange ; toutes deux avec le bouton Images. Écartés pour l'instant : une bande de statut continue sous les courbes (la frise suffit, peut venir avec le point 40) et un statut de visibilité du jour dans la vue client et chez le support (plus tard, sur demande). Sur les cas, la toile de C-002 sort en « Reduced » (29 % rejetées en médiane).
  • Effet périodique, validé le 2026-10-24 (point 41 du plan) : la vague quotidienne des courbes corrigées est la dilatation de l'ouvrage le jour et sa contraction le soir, normale (l'utilisateur) ; le détecteur thermique ne la retient que si ses deux méthodes la voient, le profil horaire répété et une sinusoïde de 24 h qui explique au moins 30 % de la courbe pour la moitié des cibles (choix de l'utilisateur : garder les deux) ; deux événements par jour, « Thermal expansion » puis « Thermal contraction », séparés par l'heure du plus grand écart au niveau de nuit, non grisés ; la catégorie cycle_thermique devient dilatation_thermique et contraction_thermique. Note : docs/displacement/domaine/cycle-thermique.md.
  • Dérive lente et pistes restantes, le 2026-10-24 (point 16 du plan) : les tendances de l'onglet Displacements (D-055) deviennent des événements « Slow drift » du journal, jamais grisés, en trait rouge fin (« PR06 drifts slowly and steadily: +0.7 mm in 10 days. Keep watching it. ») ; les références masquées sont déjà dites par la phrase de la perte de visibilité (« including the reference targets ») et l'absorption des sauts, sans catégorie à part ; « tout a bougé » contre « références masquées » reste impossible sur les mesures seules (« Shift to check » et images) ; éclairage et neige attendent un cas.
  • Lissage, trois questions tranchées le 2026-10-24 (point 24 du plan) : le client voit les deux courbes ensemble : la nettoyée en couleur, coupée dans les zones à ignorer, la brute en gris fin dans ces zones seulement (comme « Target hidden » aujourd'hui) ; le calcul se fait au moment où le client regarde les courbes, sur tout ce qui est disponible jusque-là (chaque instant jugé avec ce qui suit, les dernières heures provisoires), et rien n'est écrit dans la base de la plateforme, qu'on ne peut pas modifier à ce stade ; le cycle thermique reste tel quel sur les courbes (le journal le nomme), pas de vue « sans le cycle » : l'option D reste en réserve. Détail : vues-deplacements/contexte/lissage.md, section 4.
  • Historique des détecteurs, règle du 2026-10-24 (point 30 du plan) : les détecteurs reçoivent toujours 3 jours de mesures d'avant la plage montrée (s'ils existent), et seuls les événements qui touchent la plage sont montrés ; dans l'outil de tri en lot (categories.py --tranche, --historique 3 par défaut), dans la boucle Claude et dans la vraie application. Pourquoi : les détecteurs prennent leurs niveaux habituels sur la fenêtre qu'on leur donne ; à NORDEND, une tranche de 3 jours sans historique, commencée 2 h 30 avant le vrai saut de PR17 (08/10 à 02:30), le prend pour un saut revenu et l'absorbe dans la buée ; avec 3 jours d'avant, il revient. Option écartée : classer chaque tranche seule.

D-057 — 2026-10-24 — Déplacements : la boucle automatique d'amélioration des détecteurs et de la base de cas

  • Statut : active ; construite le 2026-10-24, fonctionnement validé par l'utilisateur le même jour (essai de l'analyste sur un lot de NORDEND) ; l'utilisateur lancera lui-même les séances ; les sous-agents prennent le modèle de la session (D-063).
  • Décision :
    • une commande, /boucle <dossier de station> (skill .claude/skills/boucle/), découpe la plage en lots de 4 jours (3 jours d'historique, D-056) et, lot après lot, appelle quatre sous-agents sur Opus : l'analyste (critiquer-lot : sa propre lecture des courbes et des images d'abord, puis la sortie des détecteurs ; verdict « d'accord » ou au plus deux suggestions ; nouveautés), l'upgrader (modifie les détecteurs de vues-deplacements/detectors/, le plus simple d'abord), le validateur (vérifie que la modification répond à la critique et va dans le bon sens, pas trop strict ; au plus trois passages, puis garder ou annuler), le builder (fait des nouveautés des cas de la base agents/diagnostic/cas/, un par genre d'événement, marqués « (appris) ») ;
    • les agents ne se parlent pas : chacun écrit son rendu dans le dossier du lot (vues-deplacements/boucle/<séance>/lot-NN/), l'orchestrateur le transmet et commite tout, étape par étape, par chemin, sur une branche par séance ; un bilan.md à la fin ;
    • l'agent de diagnostic n'a aucun rôle dans la boucle : ses consignes ne changent pas ; il sera traité dans une autre conversation.
  • Pourquoi : l'utilisateur veut qu'après une séance Claude ait appris : de nouveaux cas tirés d'événements réels (la base de connaissances) et des détections optimisées ; tout commité, pour s'y retrouver et revenir en arrière.
  • Options écartées : rejouer les lots déjà vus après chaque modification (trop lourd ; on explore et on améliore peu à peu, sans exhaustivité) ; une base de cas à part pour les cas appris (tous les cas au même endroit) ; des agents qui se parlent directement ; un agent pour récupérer les données (un dossier de station suffit : pompage ou CSV à la main).
  • Conséquence : la base de cas s'enrichit aussi par le builder, sans /nouveau-cas, ce qui complète D-048 : un cas « (appris) » n'est pas revalidé par l'utilisateur (revalidation à la main, plus tard) ; la crainte de l'utilisateur, la complexité, est la garde de l'upgrader et du validateur (pas de nouvelle catégorie, pas de règle propre à une station). Spec : vues-deplacements/contexte/boucle-automatique.md ; plan : docs/superpowers/plans/2026-10-24-boucle-automatique.md.
  • Précision (2026-10-24) : on ne traite pas toute la plage d'une station : avec les données en masse, l'utilisateur choisit les lots et les fait traiter indépendamment (/boucle <dossier> --du … --au …) ; la manière de les choisir reste à voir. Claude ne lance pas la boucle d'office.

D-058 — 2026-10-24 — Agent de diagnostic : plus à l'aveugle, au service d'un cas précis

  • Statut : active ; complète D-046 à D-048 et remplace la partie « gardé en l'état » de D-052.
  • Décision :
    • l'agent de diagnostic est un outil à part de la boucle (D-057) : on l'appelle, au support ou pour le client, sur un cas précis, souvent celui qui met en échec les détecteurs du journal ou que la base ne connaît pas ; son but est de dire, le plus précisément possible, ce qui s'est réellement passé ; il rend son rapport à l'utilisateur et à personne d'autre ;
    • il n'est plus à l'aveugle : il lit la connaissance du projet sur les déplacements (docs/domaine/, docs/displacement/, la doc AIMsight, toute la base de cas, celle-ci après ses faits) ; il ne lit pas ce qui rend déjà un avis sur des données (ses anciens rapports, vues-deplacements/, CLAUDE.md, docs/decisions.md, docs/superpowers/) ;
    • il part des événements des détecteurs (vues-deplacements/detectors/categories.py), sans les juger : ce rôle reste celui de l'analyste ;
    • aucun raisonnement nouveau ne lui est écrit : son intelligence (Opus), la base de cas et la documentation suffisent ; deux consignes qui décidaient à sa place sont retirées : « un mouvement commun à toutes les cibles n'est pas un mouvement de l'ouvrage » devient la mise en garde de CLAUDE.md (ne pas confondre mode commun et mouvement structurel), et, sans cas correspondant, la conséquence est celle que ses preuves établissent, plus « indéterminée » en premier ; l'asymétrie reste (« aucune » demande un cas) ;
    • il n'ajoute jamais de cas à la base.
  • Pourquoi : demande de l'utilisateur, qui est l'expert : les détecteurs calculent sans finesse, l'agent sait raisonner avec une base de connaissances. Sur CLARIDEN, avant C-004 (rapport 2026-10-15T1346Z_CLARIDEN_19-09-matin), l'agent avait relevé les faits mais conclu à un mouvement de caméra mal compensé, conséquence indéterminée ; l'expert y voit un mouvement réel : toutes les cibles corrigées vont dans le même sens au même moment, aucune anomalie documentée ne l'explique, et des références réparties ne bougent pas toutes ensemble.
  • Options écartées : un nouvel agent à côté de diagnostic (le même outil, à faire évoluer) ; écrire pour lui le raisonnement de l'expert sur les références (refus de l'utilisateur : c'est à l'agent de comprendre) ; fusionner avec l'analyste (l'analyste critique la méthode et nourrit la base ; l'agent de diagnostic sert un cas).
  • Conséquence : ses outils propres, pour plus de précision, restent à faire (autre conversation) ; vérification proposée, non lancée : CLARIDEN repassé sans C-004 ni incident-de-barcelone.md. Spec : docs/agents/agent-diagnostic.md.

D-059 — 2026-10-24 — Déplacements : aiguiser la lecture de Claude

  • Statut : active ; construite le 2026-10-24 ; l'utilisateur lancera lui-même les séances ; les sous-agents prennent le modèle de la session (D-063) ; le contrôle de lecture sur les cas validés est retiré (D-064).
  • Décision :
    • un skill de lecture, lire-les-donnees (.claude/skills/lire-les-donnees/), devient la seule source du mode d'emploi des outils de agents/diagnostic/outils/ : ce qu'ils rendent, leurs conventions, la façon de lire un lot et ce que la lecture rend (un tableau des moments) ; l'analyste (critiquer-lot) et l'agent de diagnostic y renvoient, leur raisonnement ne change pas ;
    • une commande, /aiguiser <dossier de station> (skill .claude/skills/aiguiser/), améliore ce skill lot après lot, avec trois sous-agents sur Opus : le lecteur lit le lot avec le skill seul ; le correcteur lit le lot à fond avec ses propres scripts, sans les outils de lecture, et cette lecture lente sert de corrigé, puis il mesure l'écart (trouvé, manqué, de travers, en trop ; faute de l'outil, du mode d'emploi ou du lecteur ; au plus deux défauts) ; l'optimiseur modifie les outils et le skill, le plus simple d'abord ; un nouveau lecteur relit, le correcteur compare : un changement sans gain (pareil ou moins bien) est annulé ; au plus trois passages par lot ;
    • en fin de séance, un contrôle sur les cas validés de la base (le lecteur lit les données du cas sans la fiche, le correcteur compare à la fiche) et sur les commandes que citent les fiches ; rien n'est annulé d'office ;
    • aucun cas ajouté ; tout commité par chemin sur une branche par séance, un bilan.md, et le releveur en fin de séance (D-060).
  • Pourquoi : l'utilisateur veut que l'analyste et l'agent de diagnostic lisent mieux les données, car un bon jugement demande une bonne lecture ; la lecture n'est pas le diagnostic : si l'analyste lisait avec les détecteurs, il serait biaisé et tendrait à les valider ; d'où un processus à part, qui « aiguise la vision de Claude » sur des données quelconques, et qu'on reprendra quand de nouveaux champs arriveront.
  • Options écartées : n'entraîner que sur les cinq cas validés (des outils taillés pour eux, et pas de données en masse) ; lire avec les détecteurs (biais) ; un correcteur qui lit avec les outils qu'on améliore (la mesure ne vaudrait plus rien) ; le contrôle sur les cas après chaque modification (trop cher : une lecture coûte environ 250 000 jetons).
  • Conséquence : les outils de lecture ne sont plus « utilisés tels quels » par /boucle : ils évoluent par /aiguiser, sans casser les commandes citées par les fiches de cas ; « ses outils propres » de l'agent de diagnostic (D-058) passent en partie par /aiguiser. Spec : vues-deplacements/contexte/aiguiser-la-lecture.md ; plan : docs/superpowers/plans/2026-10-24-aiguiser-la-lecture.md.

D-060 — 2026-10-24 — Processus automatiques : un releveur des difficultés

  • Statut : active ; complète D-057.
  • Décision :
    • dans un processus automatique à plusieurs agents, où l'utilisateur n'est pas là pour voir ce qui coince (aujourd'hui /boucle), chaque sous-agent finit son rendu par une section ## Difficultés : consigne floue, contradictoire ou absente qui l'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; « aucune » sinon ; seulement le processus, pas les données ni les détecteurs ;
    • en fin de processus, l'orchestrateur appelle une fois l'agent releveur (.claude/agents/releveur.md) avec ces rendus et ses propres difficultés ; le releveur retrouve la consigne ou le fichier en cause (fichier:ligne), regroupe les occurrences d'une même cause et note tout dans docs/ameliorations-processus.md, une rubrique par processus ; il ne corrige rien ;
    • les corrections se font ensuite, à la main, dans une conversation à part qui part de ce carnet : pas d'agent pour elles ;
    • les conversations ordinaires, où l'utilisateur suit l'agent en direct, n'ont pas ce mécanisme.
  • Pourquoi : demande de l'utilisateur : les processus sont perfectionnables (prompts, chemins, formats, contradictions), mais personne ne lit tout ce que font les agents ; le seul moyen de les améliorer est qu'une difficulté soit relevée et centralisée au moment où elle arrive.
  • Options écartées : relire après coup les transcriptions des séances (l'utilisateur veut un agent à l'écoute, à qui l'on transmet ; un agent qui fouille le projet de lui-même reste une piste) ; laisser chaque sous-agent appeler le releveur (un sous-agent ne peut pas lancer d'agent : tout passe par l'orchestrateur) ; un appel à chaque difficulté (plus cher, inutile puisque rien n'est corrigé sur le moment).
  • Conséquence : un processus automatique nouveau reprend le même circuit (section ## Difficultés, appel du releveur en fin de processus). Le nom de l'agent est un choix de Claude.

D-061 — 2026-10-25 — Boucle : des étiquettes à chaque lot, pour un futur modèle appris

  • Statut : active ; complète D-057 ; aucun modèle n'est construit.
  • Décision :
    • chaque lot de la boucle laisse les labels de l'analyste, <lot>/etiquettes.json : sa propre lecture, écrite avant la sortie des détecteurs, une entrée par moment (début, fin, capteurs, catégorie du journal ou aucune, événement de la carte ou null, preuve vue ou déduite, description, ajout après les détecteurs) ; le vocabulaire vient de la carte des événements, seule source ;
    • contrôle mécanique par .claude/skills/critiquer-lot/etiquettes.py : l'analyste corrige jusqu'à « bon » ; l'orchestrateur porte le résultat au bilan, sans relancer l'analyste ;
    • les étiquettes ne dépendent pas des détecteurs : elles se gardent même quand une modification est annulée.
  • Pourquoi : idée de l'utilisateur : un algorithme de machine learning simple pourrait un jour faire le travail des détecteurs ou les compléter ; il faut d'abord des labels, et chaque lot lu par Claude coûte cher (~8 min 30, ~250 000 jetons) : un lot sans labels relisibles est perdu pour l'apprentissage. La table « Ma lecture » de la critique en avait la matière, mais en texte libre (« ~08:30 », « idem »).
  • Options écartées : construire le modèle maintenant (trop peu de données : 6 jeux, ~30 jours de station, et la boucle n'a pas encore tourné) ; un CSV (une liste de capteurs par moment, et un lot calme, sans ligne, perdrait « lu, rien vu ») ; une table Markdown au format strict (moins lisible pour l'utilisateur) ; des labels écrits après la comparaison aux détecteurs (ils en seraient la copie).
  • Conséquence : D-044 écartait un « modèle appris » dans la couche de correction ; rien n'est rouvert tant qu'aucun modèle n'est décidé. Pistes au point 44 du plan du journal du matin : un arbre de décision peu profond, à côté des détecteurs, validé en laissant une station de côté et testé sur les cas validés ; le rejeu gratuit des détecteurs sur toutes les étiquettes ; la visibilité de l'utilisateur sur les labels.

D-062 — 2026-10-25 — Boucle : un score des détecteurs sur toutes les étiquettes

  • Statut : active ; complète D-057 et D-061 ; choix à revoir après la première séance.
  • Décision :
    • le but de la boucle est la précision de la détection sur tout le lot : chaque mesure classée, valide ou non, avec sa catégorie (l'utilisateur) ;
    • .claude/skills/boucle/score.py <dossier> compare, mesure par mesure et capteur par capteur, les événements des détecteurs (le lot classé avec ses 3 jours d'historique) aux étiquettes de tous les lots de la station ; par catégorie et pour deux niveaux de validité, « à ignorer » (zones grisées) et « prudence » (visibilité réduite, turbulence), il rend « trouvées » (part des mesures étiquetées signalées) et « justes » (part des mesures signalées étiquetées) ;
    • l'orchestrateur l'écrit au début de chaque lot (score-avant.txt) et en fin de séance (score-fin.txt) ; l'upgrader et le validateur le relancent après une modification : la catégorie en cause monte sur le lot, sans baisse nette sur les lots d'avant ; le score est un fait, pas un verdict ;
    • consigne des étiquettes : bornes à la mesure près ; un saut qui dure, la mesure du saut seule (convention du détecteur de sauts).
  • Pourquoi : l'analyste et le validateur jugeaient en mots ; les étiquettes n'étaient lues par personne ; une modification au lot 3 n'était jamais vérifiée sur les lots 1 et 2. L'utilisateur laisse Claude choisir le compte et l'essayer à la première séance.
  • Options écartées (choix de Claude, à revoir) : deux niveaux de validité (la visibilité réduite, données gardées mais moins précises, se perdrait) ; un compte par événement (il ne mesure pas les bornes) ; la validité de toute la station à un instant (les étiquettes sont déjà par capteur) ; un champ validite dans les étiquettes (elle se déduit de la catégorie) ; le script dans detectors/ (l'upgrader pourrait le modifier).
  • Conséquence : le rejeu, écarté par D-057 parce qu'il coûtait un regard de Claude, devient gratuit sur les étiquettes. La turbulence est toujours « prudence » au score, forte ou non (l'étiquette ne dit pas sa force). Les trous n'ont pas de mesure, donc pas de score.

D-063 — 2026-10-26 — Agents : le modèle et l'effort de la session

  • Statut : active ; remplace le modèle fixé par D-046 (agent de diagnostic, Opus 5.5, effort high), D-057 (/boucle) et D-059 (/aiguiser) (sous-agents sur Opus).
  • Décision : tous les agents de .claude/agents/ (diagnostic, analyste, upgrader, validateur, builder, lecteur, correcteur, optimiseur, releveur) ont model: inherit et aucune ligne effort : ils prennent le modèle et l'effort de la session qui les appelle (l'orchestrateur de /boucle ou /aiguiser, ou la conversation pour l'agent de diagnostic).
  • Pourquoi : l'utilisateur veut choisir le modèle et l'effort d'un processus entier en choisissant ceux de sa session, par exemple Sonnet 5.5 pour réduire le coût d'une séance ; avec model: opus, une session sur Sonnet ne changeait que l'orchestrateur, qui coûte peu.
  • Options écartées : un modèle par rôle (lecteur et optimiseur sur Sonnet, correcteur sur Opus, proposé par Claude) ; effort: inherit (pas une valeur admise par Claude Code : sans la ligne, l'effort de la session s'applique).
  • Conséquence : le correcteur de /aiguiser, dont le corrigé sert de référence, et l'analyste de /boucle tournent sur le modèle de la session, Sonnet compris ; un rendu moins bon se lit dans le bilan. La variable CLAUDE_CODE_SUBAGENT_MODEL n'a pas d'effet (inherit passe avant), CLAUDE_CODE_EFFORT_LEVEL si, s'il est posé.

D-064 — 2026-10-26 — /aiguiser : plus de contrôle de lecture sur les cas validés

  • Statut : active ; complète D-059 (retire le contrôle des cas validés en fin de séance).
  • Décision : la séance ne fait plus lire les cinq cas validés (C-001 à C-005) par un lecteur ni juger par un correcteur face à la fiche ; la demande « Contrôle » du correcteur et le dossier controle/ disparaissent. Les commandes que citent les fiches sont toujours lancées en fin de séance (un script, sans agent), leurs échecs vont au bilan.
  • Pourquoi : l'utilisateur a validé les diagnostics de ces cas, pas les outils qui les lisent ; les critères des fiches ne sont donc pas un corrigé de lecture des données brutes. /aiguiser améliore la lecture, pas le diagnostic. Sur NORDEND (séance du 2026-10-26), le contrôle a donné « manqué » aux cinq cas (C-001 : 4 critères sur 5 retrouvés) sans qu'on sache si les modifications y étaient pour quelque chose.
  • Options écartées : garder le contrôle en le comparant aux outils d'avant la séance (coûte cinq lectures de plus pour juger des critères que l'utilisateur n'a pas validés).
  • Conséquence : la validation d'une séance repose sur le corrigé du correcteur, lot par lot, et sur les commandes des fiches. La séance aiguiser/2026-10-26T1149Z_NORDEND garde ses résultats de contrôle dans controle/ à titre d'historique ; le bilan de cette séance les cite encore.

D-065 — 2026-10-26 — data/ hors de git, rempli par le pompage

  • Statut : active ; remplace D-014 pour data/ et D-045 pour les noms d'origine et le versionnement des exports.
  • Décision : data/ entre dans .gitignore et sort de l'index ; il ne contient plus que des dossiers pompés (extraction/pomper.py, défaut de --out, un fichier par jour), au numéro de série du système. Les exports reçus à la main en sont retirés et leurs plages repompées, élargies de 5 jours avant et 5 jours après, images comprises. /aiguiser, /boucle, /nouveau-cas et les scripts des domaines lisent data/<STATION>/ ; out/pompage/ n'est plus une sortie.
  • Pourquoi : demande de l'utilisateur. Un dossier pompé avec ses images pèse des centaines de Mo, des Go sur plusieurs mois : le versionner n'a pas de sens, il se repompe.
  • Options écartées : garder data/ versionné et pomper dans out/pompage/ (deux endroits pour les mêmes données, exports et pompage mêlés) ; garder les exports reçus à côté des fichiers pompés (le même jour lu deux fois).
  • Conséquence : un clone neuf n'a pas de données : les pomper (run.md). Les cas de la base gardent leurs copies codées, versionnées (agents/diagnostic/cas/), export horaire en mm compris, que le pompage ne sait pas faire. Les exports d'origine restent dans l'historique git. PS des Coudres change de dossier : le pompage le range sous son numéro de série, pas PS_DES_COUDRES.

D-066 — 2026-10-26 — Boucle : une page de fin de séance, l'analyste face aux détecteurs

  • Statut : active ; complète D-057 et D-062.
  • Décision : en fin de séance, /boucle écrit et ouvre out/boucle_<séance>.html (python3 .claude/skills/boucle/comparaison.py <dossier> <séance>) : corr_x et corr_y de tous les capteurs sur toute la plage de la séance ; dessous, une ligne par catégorie du journal, la lecture de l'analyste (ses étiquettes, D-061) au-dessus des événements des détecteurs dans leur état de fin de séance ; en dernier, en gris, les moments « aucune » de l'analyste (vus, hors des catégories du journal : sans effet sur les courbes le plus souvent, ou une nouveauté) ; sous la figure, le score de la séance (D-062). Zoom par sélection, pas à la molette.
  • Pourquoi : demande de l'utilisateur : voir à la fin d'une séance le diagnostic de l'agent et celui des scripts sur la même plage ; séance après séance, sur des lots différents, faire coïncider les deux.
  • Options écartées : les deux classifications en deux blocs l'un sous l'autre (choix de Claude : les deux barres d'une même catégorie sur la même ligne se comparent d'un coup d'œil) ; la page rangée dans le dossier de la séance (générée, elle va dans out/ et se refait par la commande).
  • Conséquence : la page montre les détecteurs tels qu'ils sont quand on la refait, pas ceux du début de la séance ; l'écart du début se lit dans lot-NN/score-avant.txt.

D-067 — 2026-10-26 — Les détecteurs du journal dans vues-deplacements/detectors/

  • Statut : active ; renomme le dossier vues-deplacements/journal/ de D-056.
  • Décision : les détecteurs du journal du matin et categories.py vivent dans vues-deplacements/detectors/ ; le code, les consignes des processus et la documentation vivante pointent sur ce chemin. « Journal » reste le nom du journal du matin (onglet Journal, seuils-du-journal.md).
  • Pourquoi : demande de l'utilisateur : le dossier contient les détecteurs, son nom doit le dire.
  • Options écartées : aucune.
  • Conséquence : les rendus des séances passées (vues-deplacements/boucle/, vues-deplacements/aiguiser/) et les anciens plans de docs/superpowers/ gardent l'ancien chemin, à titre d'historique.

D-068 — 2026-10-26 — Les détecteurs doivent tout détecter

  • Statut : active ; précise D-056 et D-057 ; rouvre, côté détection seulement, les réglages des points 13 et 41 du plan (cycle thermique) et MISSING (trous).
  • Décision : les détecteurs du journal doivent trouver tout ce que l'analyste de la boucle étiquette, dans sa catégorie : un cycle thermique sur quelques cibles, un trou d'un pas, une cible masquée sans assez de rejets… Ce qu'on montre ou non au client est une autre question, réglée plus tard dans une couche à part. Un réglage pris pour l'affichage n'arrête plus l'upgrader ni le validateur.
  • Pourquoi : demande de l'utilisateur : « les détecteurs doivent tout détecter ; ce qu'on montre au client ou pas n'est pas la question ici ». Sur le lot 01 de NORDEND (01 → 04/09), l'upgrader avait laissé le cycle thermique et les trous d'un ou deux pas, comptés « manqués » par le score (301 mesures sur 370 étiquetées), parce que ces réglages avaient été choisis pour ce que voit le client.
  • Options écartées : garder ces réglages et lire l'écart comme voulu (le score n'aurait jamais mesuré la détection) ; faire étiqueter l'analyste selon ce qu'on montre au client (les étiquettes servent aussi un futur modèle appris, D-061).
  • Conséquence : la détection et l'affichage se séparent. Tant que la couche d'affichage n'existe pas, l'onglet Journal de la maquette montre tout ce que trouvent les détecteurs, petites vagues thermiques et trous d'un pas compris.

D-069 — 2026-10-26 — Boucle : un benchmark des détecteurs sur la base de cas

  • Statut : active ; complète D-048 (structure d'un cas), D-057 et D-062.
  • Décision : chaque cas de la base garde son diagnostic à la création, etiquettes.json dans son dossier, au format des étiquettes de l'analyste (D-061), noms codés, figé comme le reste du cas. .claude/skills/boucle/benchmark.py lance les détecteurs sur chaque cas et les compare à ces étiquettes, mesure par mesure (le calcul de score.py) : purement analytique. /boucle le lance au début de chaque lot, après chaque modification et en fin de séance ; chaque passage entre dans vues-deplacements/benchmark/historique.csv avec la version des détecteurs (commit, « + » si non commités). L'upgrader le relance, le validateur le lit : un recul net est un défaut, une hausse un plus, pas un but. Le builder donne ses étiquettes à chaque cas créé (anonymiser.py --etiquettes) ; C-001 à C-005 les ont reçues d'un passage unique de l'analyste, corrigé par leur fiche ; /nouveau-cas fait de même. Dans chaque cas, etiquetage.md dit d'où viennent ses étiquettes (tout au même endroit, l'utilisateur) ; vues-deplacements/benchmark/ ne garde que l'historique.
  • Pourquoi : demande de l'utilisateur, après un relevé du releveur : au premier lot d'une station, le score n'a pas de lot d'avant, et rien ne mesurait un recul sur les cas où les seuils avaient été réglés. Le diagnostic de l'agent pris pour référence, ce sont ses étiquettes : elles sont faites pour être mesurées (l'utilisateur).
  • Options écartées : comparer les sorties de categories.py sur les cas, en texte (ajouté le même jour, sans chiffre ni historique) ; prendre pour référence le rapport de l'agent de diagnostic (D-046, du texte) ; faire du benchmark un but de l'upgrader (sur une dizaine de cas, les détecteurs se régleraient sur eux).
  • Conséquence : un cas a un fichier de plus ; le score des détecteurs sur la base se suit version par version. Limite : un cas appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot ; le benchmark mesure les détecteurs sur ce que le cas contient.

D-070 — 2026-10-26 — Boucle : la séance commite directement sur master

  • Statut : active ; remplace la branche par séance de D-057.
  • Décision : /boucle se lance sur master et y commite chaque étape, par chemin, comme avant ; ailleurs, l'orchestrateur le dit et s'arrête (pas de git switch, une autre session peut travailler dans le dépôt). Il note la base de la séance (git rev-parse HEAD) dans bilan.md ; rien n'est poussé. Les branches boucle/… des deux premières séances (NORDEND, CLARIDEN) sont fusionnées dans master et supprimées.
  • Pourquoi : demande de l'utilisateur ; une branche par séance laissait des branches à fusionner après chaque séance, alors que les étiquettes et les cas sont gardés de toute façon.
  • Options écartées : basculer seul sur master en début de séance (dérangerait une autre session dans le même dépôt).
  • Conséquence : annuler une modification d'une séance passe par git revert de ses commits, depuis la base notée dans le bilan.

D-071 — 2026-10-26 — Boucle : --ameliorer, un améliorateur après le releveur

  • Statut : active ; complète D-057 et D-060.
  • Décision : avec /boucle … --ameliorer, l'orchestrateur appelle, après le commit du releveur, l'agent ameliorateur (.claude/agents/ameliorateur.md). Il traite les seules entrées de docs/ameliorations-processus.md créées ou complétées pendant la séance (git show du commit du releveur), corrige au plus simple le skill /boucle, critiquer-lot, les agents de la boucle, la spec et run.md, et marque l'entrée traité ; il laisse ce qui sort de ces fichiers et ce qui changerait ce que fait la boucle ou une décision. L'orchestrateur commite par chemin (Loop <STATION>: process fixes). Sans le flag, rien ne change : le releveur note, l'utilisateur corrige.
  • Pourquoi : demande de l'utilisateur : les relevés s'accumulaient et se corrigeaient à la main, dans une autre conversation.
  • Options écartées : laisser le releveur corriger lui-même (D-060 le borne à noter : un agent qui note ne juge pas ses corrections) ; traiter toutes les entrées non traitées du carnet (certaines attendent l'utilisateur).
  • Conséquence : une séance avec le flag peut changer ses propres consignes ; l'orchestrateur garde celles lues au début. Les corrections se lisent dans le commit process fixes et s'annulent par git revert.

D-072 — 2026-10-26 — Boucle : la plage est le lot, sans découpe

  • Statut : active ; remplace les lots de 4 jours de D-057.
  • Décision : /boucle data/<STATION> --du <DEBUT> --au <FIN> [--ameliorer] traite la plage donnée en un seul lot (lot-01/), sans découpe ; l'option --lot (4 jours par défaut) disparaît, la commande du lot n'a plus --tranche. Sans dates, toute la période en un lot.
  • Pourquoi : demande de l'utilisateur : il choisit lui-même la longueur du lot par ses dates (4 jours ou plus long).
  • Options écartées : garder --lot avec un autre défaut (l'utilisateur ne veut plus de découpe implicite).
  • Conséquence : une séance = un lot ; plusieurs lots = plusieurs séances. Les scripts (score.py, comparaison.py) lisent toujours lot-*/, rien à y changer.

D-073 — 2026-10-26 — Lecture : la pose de la caméra se lit avant les capteurs

  • Statut : active ; complète D-059.
  • Décision : les outils de lecture lisent les mouvements de la caméra pompés dans camera/ (pan, tilt, rotation, scale, sigma0, à chaque recalage) : donnees.py les charge (charger_camera), ensemble.py les trace en tête du PNG « commun » (valeurs brutes, trait coupé aux instants de mesure sans recalage) et les ajoute à sa table (colonnes cam_), avec les instants sans pose ; inventaire.py compte les poses et date les instants sans recalage. Le skill lire-les-donnees lit la pose en premier, et chaque moment de la lecture dit ce que fait la caméra.
  • Pourquoi : demande de l'utilisateur : les mouvements de la caméra sont essentiels à la lecture des données ; jusqu'ici les outils ne les lisaient pas, et devinaient le mouvement de la caméra par la médiane des x, y des capteurs. Sur NORDEND, le 29/07, le tilt passe de −0,08° à −0,02° pendant la montée commune de y (vers 06:00), sans recalage de 05:45 à 07:15.
  • Options écartées : un outil à part pour la caméra (la pose doit se lire sur le même axe que les capteurs, à l'étape « large d'abord ») ; la pose dans graphique.py (ensemble.py --capteurs --debut --fin suffit pour zoomer, à ajouter si un lecteur en a besoin) ; une colonne « caméra » dans la table de la lecture (elle changerait le format que lisent l'analyste et le correcteur : la caméra entre dans « Ce que je vois »).
  • Conséquence : les détecteurs du journal (vues-deplacements/detectors/) ne lisent toujours pas la pose ; le correcteur de /aiguiser lit camera/ avec ses propres scripts s'il le veut, rien ne le lui impose.

D-074 — 2026-10-27 — Journal : les catégories du terrain, « À vérifier » pour tout ce qui reste inexpliqué

  • Statut : active ; précise D-056 (catégories du journal) ; pas encore reportée dans la carte (section 4), categories.py ni les détecteurs.
  • Décision : les catégories du journal se définissent par ce qui arrive sur le terrain, reliées dans docs/displacement/eventualites-et-categories.drawio (une éventualité peut donner plusieurs catégories). Définitions de l'utilisateur : À vérifier reçoit tout ce qui n'a pas d'explication, avec deux sous-groupes possibles, la dérive lente et le gros saut (mouvement soudain de l'ouvrage, tout a bougé) ; Cible défaillante (nouvelle) : une cible constamment problématique, mal orientée, mal installée ou dégradée avec le temps ; Effet thermique : le cycle jour / nuit, l'ouvrage qui bouge au soleil ou la caméra qui bouge par dilatation de son support ; Passage : un train, un engin de chantier, un véhicule ou tout autre objet qui passe devant les cibles ; Pas de données : aucune donnée reçue pour la plage ; Saut bref : saut soudain puis retour, explicable par une condition externe, vérifiable sans ambiguïté sur les images ; Turbulences atmosphériques : image brouillée par la chaleur (mirage). Visibilité réduite, Visibilité nulle et Cible masquée restent comme dans la carte. Après vérification, un À vérifier peut devenir Cible déplacée (cible endommagée ou bougée, ou altération de l'ouvrage).
  • Pourquoi : ne pas alarmer le client : ce qui n'est pas expliqué n'est pas un mouvement annoncé, seulement à vérifier ; et la cible défaillante, présente dans les cas C-008 à C-011 et les étiquettes de l'analyste (cibles toujours rejetées, suivi qui hésite ou glisse), n'avait pas de catégorie.
  • Options écartées : l'arbre de décision sur les données (Mermaid, puis draw.io) : trop gros, l'utilisateur veut les éventualités du terrain sans le détail des données ; une catégorie « Dérive lente » à part, alarmante.
  • Conséquence : un véhicule qui fait vibrer l'ouvrage ou la caméra (caméra sur un pont) va en Saut bref (l'utilisateur, 2026-10-27, plutôt que Passage : il ne passe pas devant les cibles, il fait bouger l'ouvrage ou la caméra un instant) ; le vent et les à-coups de la caméra ne sont plus des turbulences mais des sauts brefs. Reste à reporter les définitions dans la carte (section 4), categories.py, le vocabulaire des étiquettes et les détecteurs (point 49 du plan).

D-076 — 2026-10-27 — Aiguiser : --ameliorer, comme pour la boucle

  • Statut : active ; étend D-071 à /aiguiser (D-059).
  • Décision : /aiguiser … --ameliorer appelle, après le commit du releveur, le même agent ameliorateur, avec Processus : /aiguiser. Commit du releveur : <commit>. (l'appel de /boucle nomme aussi son processus). Il corrige au plus simple le skill /aiguiser, les agents lecteur, correcteur, optimiseur, releveur, ameliorateur, vues-deplacements/aiguiser/voir.py, la spec aiguiser-la-lecture.md et run.md ; l'orchestrateur commite par chemin (Sharpen <STATION>: process fixes), sur la branche de la séance.
  • Pourquoi : demande de l'utilisateur.
  • Options écartées : un second améliorateur propre à /aiguiser (même rôle, seul le périmètre change) ; laisser l'améliorateur toucher aux outils de lecture et à lire-les-donnees (c'est le travail de l'optimiseur, jugé par les écarts du correcteur).
  • Conséquence : sans le flag, rien ne change.