254 KiB
254 KiB
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 plusconsistent 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.pyet une fichedocs/analyses/analyse_NN.md. - Pourquoi : suivre une à une les analyses à venir, qui seront nombreuses.
- Options écartées : un
main.pyunique à 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 (BusVoltageseule) sont mises de côté dansdata/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.mdest chargé à chaque session et reste court.docs/decisions.md(ce journal) porte les décisions de niveau projet.docs/analyses/analyse_NN.mdporte 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.mddevient 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.mdse charge seule quand Claude touchesrc/oudocs/analyses/. - Ce journal prend le format ADR allégé (statut, options écartées).
- Un modèle de fiche
docs/analyses/_modele.mdet un skillnouvelle-analysedonnent 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 enfixedrange; - 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/(dontdata/archive/),architecture.drawioet la copie du collecteursrc/__main__ (3).pysont versionnés et poussés surorigin(gitea de l'entreprise). Seulsout/,.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.mdcontient 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_JSle 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éesrc/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_DROPsur 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 estenergy_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_DROPdevientMOVING_AVERAGE_7_DAYS_DROP, etMA7D_MIDNIGHT_DROPdevientMOVING_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.
- 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
- 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
tsur 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).
- le diagnostic énergétique livré ne retient que les analyses 03 (
- 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×STABLEen 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.pyen é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
BusVoltagehoraire : 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_CHARGEsans veille serait vert) : l'utilisateur préfère le gris, les cas inconnus restant à traiter (D-020).
- une bande d'une case par jour (couleur de la matrice, flèche de tendance) au-dessus de
- 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) etmaquettes/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]écritout/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.
- les maquettes sont rangées en deux blocs :
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.
- les panneaux 03 et 04 étant partagés (D-021), ils sont aussi en anglais sur la page des analyses (
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) :BusVoltagehoraire, 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.
- l'analyse 03 gagne le fait
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]écritout/maquette_support_home.htmlet l'ouvre (bibliothèque standard, SVG en ligne, sans plotly).
- 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 (
- 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/etdocs/energy/(analyses, domaine, guide, matrice). Le code commun est danssrc/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 dansdocs/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.pyjusqu'au 2026-10-13), les analyses livrées (état et tendance, D-020 et D-021), qui écritout/<STATION>_daily.htmlet.json;src/energy/all_analyses.py, les quatre analyses ensemble pour comparer (D-016), qui écritout/<STATION>_energy.html.src/energy/focus_jour.pyreste 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.drawiodevientdocs/energy/matrice-etat-tendance.drawio. Les contenus ne changent pas. - Le modèle de fiche passe dans le skill
nouvelle-analyse(modele-fiche.md).
- Chaque domaine a son sous-dossier dans chaque couche :
- 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é dedocs/, 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.pypar 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.
- une tranche verticale
- 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/sansfinal.py,all_analyses.pynifocus_jour.py, qui demandent plotly.
- les anciens chemins restent dans
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 (saufnotify), base SQL jamais exposée. Un agent est un dossier déclaratif (instructions, pointeurs vers la connaissance dedocs/, 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.
- pas de LLM dans
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.mdnomme 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(contratrun(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 loget 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 dedata/àdata/VERMONT/, défaut de tous les scripts.metadata.md,d.mdetarchive/restent dansdata/. - 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êleraitarchive/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) etcellular(signal 4G : niveau radio, enregistrement, lien). Chacun asrc/<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 versnouvelle-analysepour chaque analyse ; - contrat de notification : chaque domaine livré expose
day_color.run(series), un point par jour avecfacts.color(GREEN/ORANGE/RED/None), et uneHEADLINEen anglais par couleur notifiée ; - le passage des maquettes à une liste de domaines se fait au premier nouveau domaine livré, pas avant.
- deux nouveaux domaines, rangés comme Energy :
- 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 dansnouvelle-analyse(deux échelles mêlées) ; le nomnetwork(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 :
HEADLINEd'Energy quitteramaquettes/support/home.pypoursrc/energy/day_color.pylors 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.Identifierde WEISSHORN sont supprimés, et*:Zone.Identifierest 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 dansfacts.state), écrites l'une après l'autre avant les cas de l'expert :DAILY_LINK_STATE(envois reçus aveclink = up) etDAILY_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.stationscharge les métriques texte comme la liste des échantillons de l'heure ; les pages ne tracent que des séries choisies, jamaisSIM_CCIDniip.
- deux analyses d'état, sans verdict (
- 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 denouveau-domaine) reste à décider.
D-032 — 2026-10-13 — NORDEND, deuxième jeu de travail de Cellular ; link facultatif
- Statut : active. Complète D-030 (jeu de travail par domaine) et D-031 (analyses Cellular).
- Décision :
- le jeu de travail de
cellulardevient 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_STATEaccepte un export sanslink(version plus ancienne du collecteur) : les envois se comptent surlast_sync, et ce qui dépend delinkvautNone;- la grille de
DAILY_SIGNAL_STATEreste telle quelle en attendant l'expert, bien qu'elle classe tous les jours de NORDEND enCELL_EDGE.
- le jeu de travail de
- 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 jamaisDOWNni 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 destorage).
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.mdetarchive/ne restent plus dansdata/) et D-009 (les stations mises de côté ne sont plus dans le dépôt). - Décision :
data/metadata.md,data/d.mdet les 4 CSV dedata/archive/(FLORIDA, JUNGFRAU, MISSISSIPPI, WILDSTRUBEL,BusVoltageseule) sont supprimés. Les documents renvoient désormais à leurs résumés :docs/energy/domaine/cas-annotes-par-l-expert.mdpour 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_CCIDet des adresses IP. Les specs et plans dedocs/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) etDAYS_UNTIL_STORAGE_FULL(espace libre ÷ médiane des consommations journalières sur 7 jours) ; - planchers de
DAILY_STORAGE_STATEarbitraires, 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 quedata_storage_*; - les questions à l'expert (disque plein, purge,
root, seuils, cas) restent en suspens dansdocs/storage/domaine/questions-pour-l-expert.md.
- deux analyses sans verdict (
- 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, fichedays_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 dansdocs/storage/matrice-etat-horizon.drawioet recopiée dansMATRIX, comme pour Energy (D-020). L'état vient deDAILY_STORAGE_STATE(OK,LOW,CRITICAL) ; l'horizon deDAYS_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
CRITICALdont 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
temperatureest 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(devenuedocs/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.
- pas de domaine ni d'analyse de température pour l'instant ; l'exploration de VERMONT, WEISSHORN et NORDEND est rangée dans
- 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 dansdocs/cellular/matrice-lien-signal.drawioet recopiée dansMATRIX, comme pour Energy (D-020) et Storage (D-035). Le lien vient deDAILY_LINK_STATE(UP,MISSING,DOWN) ; le signal deDAILY_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_EDGEcompris). Orange :MISSINGouDOWNavec un signal connu. Red :MISSINGouDOWNavec un signal inconnu, c'est-à-dire une station qui s'est tue 5 h ou plus. Gris : lien inconnu, ouUPavec 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_EDGEen 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, fichedaily_signal_state) ;DOWNen Red dès un échantillon (ledownfugitif 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: imagemcr.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
aptde 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.2par 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.pyetfinal.pytournent sur VERMONT dans le conteneur ; dans le conteneur, les pages ne s'ouvrent pas seules (pas de navigateur), elles restent dansout/. À 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-domainepour 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.pydevientmaquettes/user/summary.py(gabaritsummary_template.html), qui écrit une page System Summary par station dedata/: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.pycharge toutes les stations dedata/et parcourtDOMAINS = {"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 ; HEADLINEde chaque domaine vit danssrc/<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.pyetsrc/cellular/final.py, sur le modèle desrc/energy/final.py(D-021), écriventout/<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.mdetdocs/cellular/guide/diagnostic-cellulaire.md, en deux couches comme celui d'Energy (D-020), plus courts.
- vue client :
- 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-22montre 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_STATEet 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_FULLmontre 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.
- 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
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 desensor_GPU_deg_ca-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.mddevientdocs/temperature/domaine/point-de-depart.md.
- domaine
- 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-domainepour 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 panneauDAILY_GPU_TEMPERATURE_LIMITseul, partagé avec la page de comparaison ;- maquettes :
TemperaturerejointDOMAINScô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), etsubmit_diagnosisau 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 supportedet 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 deBusVoltagesur 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 mainsouMains 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 dansdata/(D-033).
- une nouvelle analyse,
- 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_losten plus) ;focus_jour.pycite la règle secteur quand elle a décidé ; limites dans la fichedocs/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
inlierbinaire. - 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_COUDRESpour « 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_yet les déplacements horaires, pas comme entrée ; - les CSV sont versionnés (1,8 Mo pour 5,5 jours). Formats et colonnes :
labeling/connaissances/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.
- les exports de déplacements d'une station vont dans
- Pourquoi : demande de l'utilisateur (intégrer les données d'une station sur une plage choisie).
load_stationslit les*.csvdu 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.
- les exports directement dans
- 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_GetREF_D(13/10 et 14/10) en sont des candidats,consistent withau 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_yest à confirmer : questions 3, 9 et 10 du cadrage (§7).
- 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
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 dossieragents/diagnostic/(instructions, outils, rapports), diagnostique à la demande un dossier dedata/: scan sans question, enquête avec une question ; un rapport par diagnostic dansagents/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é à.venvet 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.
- un sous-agent Claude Code
- 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, niBash, niWriteà 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-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
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.mdet ses PNG, versionnés ; - outils :
graphique.pygagne--zoneet--sortie; nouveauvignettes.py(matplotlib), centré sur les colonnesxety; - 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_GetREF_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_GetREF_Ddans 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 dansout/(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 fichecas.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 dansdata/; - 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.
- une base de cas validés par l'expert,
- 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 devientS01, une référenceR1, une cibleC1(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.pyetvignettes.pyprennent une option--aliaspour tracer avec les codes.
- dans
- 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) ; anonymiserrapports/(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 dansdata/) et D-049 (code de stationS01, option--alias). - Décision :
- le dossier d'un cas s'appelle
C-xxx/et contient ses données :displacement/etimages/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.pyetvignettes.pyperdent--alias, inutile sur des données déjà codées.
- le dossier d'un cas s'appelle
- Pourquoi : demande de l'utilisateur à la revue de C-001 : un cas doit porter ses données, et
S01n'apportait rien de plus que le numéro du cas ; les commandes endata/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.pysur un dossier de cas compte ses figures comme des images sans heure ; seulsdisplacement/etimages/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.mddu 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 decorr_xaux 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 dansdata/(D-029), comme celles de la base de cas (D-050).
- 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 (
- 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 dansvues-deplacements/maquette/(spec :spec.md).
- première vue du chantier D-052 : une maquette HTML de la page Explore de la plateforme, avec ses deux onglets (
- 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é selonerror_valueface à son seuil, deux bandes sous le glisseur (système entier, cible choisie), et le gros plan d'une ou plusieurs cibles centré surx,yde 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, eterror_valuede l'export « advanced »), une plage (la fenêtre visible) etAnalyze 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.
- onglet
- 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 parcorr, 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
Displacementsde 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
inlierou desigma0(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
Journalde 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 dansdocs/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é) ; boutonImagespour 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 boutonImages. É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
thermiquene 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égoriecycle_thermiquedevientdilatation_thermiqueetcontraction_thermique. Note :labeling/connaissances/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 3par 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 ; l'upgrader et le validateur deviennent
detectors-upgraderetdetectors-control(D-089) ;/boucledevient/events-learner(D-092) ; 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 devues-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 baseagents/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 ; unbilan.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.
- une commande,
- 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 : remplacée par D-097 (
/aiguiserretiré ; le skilllire-les-donneesreste la seule source du mode d'emploi de lecture) ; 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 deagents/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 (pareiloumoins 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).
- un skill de lecture,
- 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 dansdocs/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.
- dans un processus automatique à plusieurs agents, où l'utilisateur n'est pas là pour voir ce qui coince (aujourd'hui
- 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 ouaucune, événement de la carte ounull, 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.
- chaque lot de la boucle laisse les labels de l'analyste,
- 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
validitedans les étiquettes (elle se déduit de la catégorie) ; le script dansdetectors/(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) ontmodel: inheritet aucune ligneeffort: ils prennent le modèle et l'effort de la session qui les appelle (l'orchestrateur de/boucleou/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/boucletournent sur le modèle de la session, Sonnet compris ; un rendu moins bon se lit dans le bilan. La variableCLAUDE_CODE_SUBAGENT_MODELn'a pas d'effet (inheritpasse avant),CLAUDE_CODE_EFFORT_LEVELsi, s'il est posé.
D-064 — 2026-10-26 — /aiguiser : plus de contrôle de lecture sur les cas validés
- Statut : sans objet depuis D-097 (
/aiguiserretiré) ; 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.
/aiguiseramé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_NORDENDgarde ses résultats de contrôle danscontrole/à 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.gitignoreet 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-caset les scripts des domaines lisentdata/<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 dansout/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, pasPS_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 ouvreout/boucle_<séance>.html(python3 .claude/skills/boucle/comparaison.py <dossier> <séance>) :corr_xetcorr_yde 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.pyvivent dansvues-deplacements/detectors/; le code, les consignes des processus et la documentation vivante pointent sur ce chemin. « Journal » reste le nom du journal du matin (ongletJournal,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 dedocs/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
Journalde 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.jsondans son dossier, au format des étiquettes de l'analyste (D-061), noms codés, figé comme le reste du cas..claude/skills/boucle/benchmark.pylance les détecteurs sur chaque cas et les compare à ces étiquettes, mesure par mesure (le calcul descore.py) : purement analytique./bouclele lance au début de chaque lot, après chaque modification et en fin de séance ; chaque passage entre dansvues-deplacements/benchmark/historique.csvavec 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-casfait de même. Dans chaque cas,etiquetage.mddit 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.pysur 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 :
/bouclese lance surmasteret y commite chaque étape, par chemin, comme avant ; ailleurs, l'orchestrateur le dit et s'arrête (pas degit switch, une autre session peut travailler dans le dépôt). Il note la base de la séance (git rev-parse HEAD) dansbilan.md; rien n'est poussé. Les branchesboucle/…des deux premières séances (NORDEND, CLARIDEN) sont fusionnées dansmasteret 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
masteren 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 revertde 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'agentameliorateur(.claude/agents/ameliorateur.md). Il traite les seules entrées dedocs/ameliorations-processus.mdcréées ou complétées pendant la séance (git showdu commit du releveur), corrige au plus simple le skill/boucle,critiquer-lot, les agents de la boucle, la spec etrun.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 fixeset s'annulent pargit 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
--lotavec 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 toujourslot-*/, 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.pyles charge (charger_camera),ensemble.pyles trace en tête du PNG « commun » (valeurs brutes, trait coupé aux instants de mesure sans recalage) et les ajoute à sa table (colonnescam_), avec les instants sans pose ;inventaire.pycompte les poses et date les instants sans recalage. Le skilllire-les-donneeslit 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,ydes capteurs. Sur NORDEND, le 29/07, letiltpasse de −0,08° à −0,02° pendant la montée commune dey(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 --finsuffit 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/aiguiserlitcamera/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.pyni 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é) ; Target issue (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érifierpeut 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 à problème, 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-075 — 2026-10-27 — Base de cas : /revue-cas, l'expert revoit les cas appris par la boucle
- Statut : active ; complète D-057 (le builder ajoute des cas sans l'avis de l'expert).
- Décision : tout cas dont l'en-tête dit
non revalidé par l'expertpasse par/revue-cas [C-xxx ...], lancé par l'utilisateur seul (.claude/skills/revue-cas/). L'agentrevue(.claude/agents/revue.md) présente chaque cas : station et capteurs sous leurs vrais noms (registre), séance et lot d'origine, ce qu'en dit l'analyste, le diagnostic proposé, la page des détecteurs sur la plage de l'événement (.claude/skills/boucle/detecteurs.py), les figures, les points à trancher, le tout dans une page web,out/revue-cas/C-xxx.html(.claude/skills/revue-cas/page.py: la page des détecteurs, avec en tête la présentation et, dessous, la fiche, l'étiquetage, le rendu du builder, la critique du lot et toutes les figures du cas et du lot ; vrais noms, hors de git). L'orchestrateur ne recopie rien dans la conversation, demande « valider, corriger, rejeter, passer », renvoie les corrections au même agent, puis commite par chemin. Validé : l'en-tête devientvalidé par l'expert le <date>,(appris)quitte le Verdict de l'index ; rejeté : le dossier du cas et sa ligne d'index disparaissent, le registre garde ses lignes. - Pourquoi : demande de l'utilisateur : l'expert valide chaque cas, comme
/nouveau-casle prévoit ; la boucle tourne sans lui, la revue vient après, dans une conversation. - Options écartées : la présentation dans la conversation (premier essai sur C-011 : l'utilisateur n'arrive pas à trancher sans les courbes et les images, il veut tout dans la page) ; un Workflow (outil de fond) : il ne peut pas poser de question à l'utilisateur ; l'agent qui pose lui-même la question (un sous-agent ne parle pas à l'utilisateur : l'orchestrateur relaie).
- Conséquence : le builder garde la phrase exacte
non revalidé par l'expert, que/revue-cascherche.
D-076 — 2026-10-27 — Aiguiser : --ameliorer, comme pour la boucle
- Statut : sans objet depuis D-097 (
/aiguiserretiré) ; étend D-071 à/aiguiser(D-059). - Décision :
/aiguiser … --ameliorerappelle, après le commit du releveur, le même agentameliorateur, avecProcessus : /aiguiser. Commit du releveur : <commit>.(l'appel de/bouclenomme aussi son processus). Il corrige au plus simple le skill/aiguiser, les agentslecteur,correcteur,optimiseur,releveur,ameliorateur,vues-deplacements/aiguiser/voir.py, la specaiguiser-la-lecture.mdetrun.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.
D-077 — 2026-10-27 — Aiguiser : la séance commite directement sur master
- Statut : sans objet depuis D-097 (
/aiguiserretiré) ; remplace la branche par séance de D-059. - Décision :
/aiguiserse lance surmasteret y commite chaque étape, par chemin, comme/boucle(D-070) ; ailleurs, l'orchestrateur le dit et s'arrête (pas degit switch). Il note la base de la séance (git rev-parse HEAD) dansbilan.md; rien n'est poussé./bouclele faisait déjà, rien n'y change. - Pourquoi : demande de l'utilisateur : rester sur la branche principale, comme pour la boucle.
- Options écartées : basculer seul sur
masteren début de séance (dérangerait une autre session dans le même dépôt, comme pour D-070). - Conséquence : annuler une modification d'une séance passe par
git revertde ses commits, depuis la base notée dans le bilan.
D-078 — 2026-10-27 — Aiguiser : la plage est le lot, sans découpe
- Statut : sans objet depuis D-097 (
/aiguiserretiré) ; remplace la découpe en lots de 4 jours de D-059, comme D-072 pour/boucle. - Décision : une séance
/aiguisertraite un seul lot,lot-01, de--du00:00Z à--au00:00Z (--auexclu ; sans eux, toute la période) ; plus d'option--lot(ignorée si donnée, notée sous « Erreurs »). - Pourquoi : demande de l'utilisateur : « tout comme pour /boucle, il n'y a pas de lots de 4 jours. Le lot est simplement la plage que je donne. »
- Options écartées : garder la découpe avec 4 jours par défaut (séance trop longue : jusqu'à 11 agents par lot).
- Conséquence : une plage longue donne un seul lot, lu d'un seul tenant ; pour en voir plusieurs, plusieurs séances.
D-079 — 2026-10-28 — Support-agent : /support répond à la question d'un client
- Statut : active.
- Décision : un skill
/support <mail>(.claude/skills/support/SKILL.md), lancé par l'utilisateur dans la conversation principale : il lit le mail du client et sa capture, les données locales dedata/(station incertaine ou données absentes : il demande et s'arrête), répond à la question posée et à elle seule, et écrit un dossier par demande,support/<AAAA-MM-JJ>_<STATION>_<sujet>/:demande.md,analyse.md(faits traçables, puis « Hors question (pour Marc) »),reponse.md(le mail prêt à envoyer, cibles nommées par leursensor_namededata/, heures en UTC) et, si utile, un GIF des images (agents/diagnostic/outils/gif.py, nouvel outil). L'utilisateur peaufine le mail avec l'agent ; quand il dit que c'est bon, le dossier passe « prêt à envoyer » et est commité.support/est versionné : une base de cas de support (usage à rediscuter). Design :docs/superpowers/specs/2026-10-28-support-agent-design.md. - Pourquoi : demande de l'utilisateur : automatiser la réponse aux clients, qui posent une question précise sur leurs données (ex. « y a-t-il eu de l'activité sur les voies cette nuit ? »), souvent depuis leur propre plateforme ; « le rôle de l'agent est de répondre à la question du client et c'est tout » : d'autres systèmes détectent les anomalies. Le peaufinage demande que l'agent reste dans la conversation.
- Options écartées : un sous-agent comme
diagnostic(il ne rend qu'un résultat, sans peaufinage dans la conversation) ; adapter l'agent de diagnostic (son rôle, trouver toutes les anomalies à l'aveugle, contredit « la question seule ») ; signaler au client les anomalies non demandées (elles vont dansanalyse.md) ;support/hors de git. - Conséquence : le skill renvoie au déroulé et aux règles de l'agent de diagnostic (§4 et §5 de
agents/diagnostic/instructions.md) et aux outils delire-les-donnees, sans les recopier ;support/contient des mails et images de clients, contrairement à la base de cas anonymisée.
D-080 — 2026-10-28 — Les événements dans events/, à la racine
- Statut : active ; première étape d'une remise en ordre autour de
/boucle, à poursuivre pas à pas. - Décision : la base de cas (
agents/diagnostic/cas/, D-048) et ce qui la décrit, la carte des événements (docs/displacement/domaine/carte-des-evenements.md) et le graphe des éventualités (docs/displacement/eventualites-et-categories.drawio), passent dans un dossierevents/à la racine :events/INDEX.md,events/C-xxx/,events/carte-des-evenements.md,events/eventualites-et-categories.drawio. Les chemins sont mis à jour dans les skills, les agents, les scripts, les fiches des cas, les contextes et le plan vivant ; l'historique (rapports, séances passées de/boucleet/aiguiser,docs/superpowers/hors plan vivant, ce journal,docs/ameliorations-processus.md) garde les anciens chemins. - Pourquoi : l'utilisateur s'y perdait ; « les cas sont fondamentaux dans le projet » : une connaissance métier qui grandit chaque jour par
/boucleet qu'il valide périodiquement ; elle mérite un dossier à elle, pas un sous-dossier de l'agent de diagnostic. - Options écartées : aucune encore ; les notes de domaine des déplacements (
cas-annotes-par-l-expert.md,incident-de-barcelone.md) restent dansdocs/displacement/domaine/jusqu'à ce que l'utilisateur en décide. - Conséquence : vérifié après le déplacement :
benchmark.pylit les 13 cas, les tests d'anonymiser.pyet d'etiquettes.pypassent, les 69 commandes citées par les fiches tournent sans échec.
D-081 — 2026-10-28 — Les outils de lecture dans agent-tools/, à la racine
- Statut : active ; deuxième étape de la remise en ordre autour de
/boucle, après D-080. - Décision : les outils de lecture (
agents/diagnostic/outils/) passent dansagent-tools/à la racine ; leur mode d'emploi reste le skilllire-les-donnees, et/aiguiserles améliore toujours. Les chemins sont mis à jour dans les skills, les agents, les détecteurs (qui importentdonnees.py), les scripts, les fiches des cas,support/, les contextes etCLAUDE.md;graphique.py,vignettes.pyetgif.pycalculent la racine du dépôt un niveau plus haut. L'historique garde les anciens chemins, comme pour D-080. - Pourquoi : demande de l'utilisateur : ces outils sont un gros morceau du projet, aiguisés par
/aiguiser, utilisés parlire-les-donneeset donc par tous les agents qui lisent les données ; ils ne sont plus propres à l'agent de diagnostic. - Options écartées : aucune.
- Conséquence : vérifié après le déplacement : les tests d'
anonymiser.py, d'etiquettes.pyet descore.pypassent, le benchmark tourne, les 83 commandes citées par les fiches tournent sans échec, les détecteurs,graphique.py,vignettes.pyetgif.pyrendent leurs sorties sur C-001.
D-082 — 2026-10-28 — L'agent de diagnostic dans agent-diagnostic/
- Statut : active ; troisième étape de la remise en ordre, après D-080 et D-081.
- Décision :
agents/diagnostic/(consignesinstructions.md,README.md, rapports) devientagent-diagnostic/à la racine ;agents/disparaît. Le point d'entrée reste.claude/agents/diagnostic.md. Les chemins sont mis à jour dans les skills, les agents, la spec, les contextes, le plan vivant etCLAUDE.md; les rapports et l'historique gardent les anciens. - Pourquoi : l'utilisateur ne voit plus à quoi sert l'agent (la détection passe par les détecteurs et
/boucle, les questions des clients par/support), mais le garde au cas où ; le nom du dossier doit dire tout de suite qu'il s'agit de lui. - Options écartées : retirer l'agent et reprendre ses règles dans
/support(gardé dans le doute). - Conséquence :
/supportet/nouveau-casrenvoient toujours àagent-diagnostic/instructions.md.
D-083 — 2026-10-28 — Le handoff dans docs/aimsight/ ; CLAUDE.md et README.md réécrits
- Statut : active ; quatrième étape de la remise en ordre, après D-080 à D-082. Applique D-012 et D-028.
- Décision :
Handoff.md, le cadrage du product owner (sous-projet G), passe dansdocs/aimsight/AIMsight_handoff_G_site_health.md, avec les autres documents reçus d'AIMsight ; sa section « Écarts constatés », la nôtre, reste en fin de fichier.CLAUDE.mdest réécrit en carte courte : l'état en quelques lignes, une seule table des analyses des domaines système, une section des déplacements, des chemins à jour.README.mdest réécrit pour un humain : ce qui existe, démarrer, où trouver quoi. - Pourquoi : demande de l'utilisateur. « État et prochaine étape » était devenu un historique de près de 40 Ko, contraire à D-028, et des faits avaient vieilli (cinq cas au lieu de treize, onze catégories,
Handoff.mdà la racine,README.mdresté à la livraison de Storage). - Options écartées : le handoff à la racine de
docs/(c'est un document reçu, à lire par section avant de concevoir, comme les deux autres dedocs/aimsight/). - Conséquence :
docs/aimsight/n'est plus tout à fait « non modifié » : le handoff y porte nos écarts, signalés en tête du fichier.
D-084 — 2026-10-28 — Les détecteurs et les séances de /boucle et /aiguiser à la racine
- Statut : active ; cinquième étape de la remise en ordre, après D-080 à D-083. Complète D-067.
- Décision :
vues-deplacements/detectors/devientdetectors/,vues-deplacements/boucle/devientboucle/,vues-deplacements/aiguiser/devientaiguiser/, à la racine. Les chemins sont mis à jour dans le code (imports des détecteurs versagent-tools/,score.py,benchmark.py,explore.py,revue-cas/page.py,aiguiser/voir.py), les skills, les agents, la spec et les consignes de l'agent de diagnostic, les fiches des cas,support/, les contextes, le plan vivant,run.md,pipelines-ia.drawioet les deuxCLAUDE.md. Les lectures à l'aveugle (analyste, lecteur, correcteur, agent de diagnostic), qui excluaient « rien dansvues-deplacements/» et donc les séances, excluent aussiboucle/etaiguiser/.vues-deplacements/benchmark/reste en place. L'historique (séances passées, rapports,docs/superpowers/hors plan vivant, ce journal,docs/ameliorations-processus.md) garde les anciens chemins. - Pourquoi : demande de l'utilisateur :
vues-deplacements/mêlait la maquette et ses notes avec les détecteurs et les rendus des processus automatiques ; ce sont des morceaux du projet à part entière. - Options écartées : aucune.
- Conséquence : vérifié après le déplacement : chaque détecteur et l'archive tournent sur C-001, les tests de
score.py,etiquettes.pyetanonymiser.pypassent, le benchmark et le score sur les étiquettes deboucle/tournent, les pages Explore, détecteurs, fin de séance (NIEDERHORN),voir.pyet/revue-cas(C-012 retrouve son lot dansboucle/) sont produites.
D-085 — 2026-10-28 — Consulter la base de cas : le skill read-event
- Statut : active. Complète D-048 (§11 de
docs/agents/agent-diagnostic.md) ; le moment de l'analyste change par D-088. - Décision : la façon de consulter
events/s'écrit une seule fois, dans le skillread-event: la carte des événements et l'index d'abord, puis la fiche des seuls cas proches (au plus 3 par phénomène), puis leurs données par les commandes de la signature et les outils delire-les-donnees; jamais toutes les fiches d'un coup, ni un CSV affiché, ni le registre des noms. L'en-tête d'INDEX.mdy renvoie ; les consignes de l'agent de diagnostic (donc/support), decritiquer-lotet du builder le citent au lieu de redire la procédure. Le skill dit comment lire, pas quand : chaque consigne garde son moment (après les faits pour le diagnostic et l'analyste, D-058 ; jamais pour le lecteur de/aiguiser). Ceux qui écrivent l'index (/nouveau-cas, le builder, la revue) visent une Signature d'environ 250 caractères, une indication et non une limite, le détail dans la fiche. - Pourquoi : idée de l'utilisateur : un agent ne peut pas lire tous les cas, trop volumineux ; il lit un index sommaire, ouvre la fiche d'un cas qui l'intéresse, puis ses données s'il veut aller plus loin. La procédure existait (D-048) mais redite autrement dans chaque consigne, et l'index n'était plus sommaire : 13 lignes de 654 caractères en moyenne, quand la spec voulait une signature courte ; avec
/bouclequi ajoute des cas, il deviendrait aussi lourd que ce qu'il devait éviter. - Options écartées : la procédure dans le seul en-tête d'
INDEX.md(pas de chargement par sa description en conversation) ; un hook qui bloquerait la lecture d'une fiche sans l'index (mécanique lourde pour une règle de quelques lignes) ; une limite stricte de longueur de la Signature (refus de l'utilisateur : une longueur souhaitée suffit) ; filtre par script ou recherche vectorielle, déjà prévus pour quelques centaines de cas (§11.8 de la spec). - Conséquence : les 13 lignes existantes sont plus longues que la longueur souhaitée ; elles restent telles quelles. La revue n'en a pas besoin pour lire : elle ouvre le cas qu'on lui donne.
D-086 — 2026-10-28 — « Cas » devient « event », C-xxx devient E-xxx
- Statut : active. Renomme ce que nomment D-048, D-057, D-069, D-075, D-080 et D-085, sans les réécrire.
- Décision : un incident de la base
events/s'appelle un event, plus un « cas » : la base d'events,E-xxxau lieu deC-xxx(dossiers, figures, données codées, registre,etiquettes.json, historique du benchmark, colonneevent), une ficheevent.mdau lieu decas.md; les skills prennent des noms anglais, commeread-event:/new-event(ex-/nouveau-cas),/review-event(ex-/revue-cas, page dansout/review-event/),anonymize-event(ex-anonymiser-cas) ; le builder écrit**Events créés** :. Les fichiers vivants suivent (consignes, skills, scripts,CLAUDE.md, spec et plan vivants, documentation) ; l'historique reste tel qu'il a été écrit : les décisions passées,docs/superpowers/sauf le plan et la spec vivants, les séances deboucle/et d'aiguiser/, les rapports de l'agent de diagnostic,support/,docs/ameliorations-processus.md. Le mot garde son sens courant ailleurs (« dans ce cas », cas d'usage, cas de régression, une demande au support, le dossiervues-deplacements/cas/du parcours NORDEND). - Pourquoi : demande de l'utilisateur, par cohérence avec le dossier
events/. - Options écartées : garder
C-xxx(proposé par Claude : rien ne cassait) ; des noms de skills en français ; réécrire l'historique. - Conséquence : dans l'historique,
C-xxxse litE-xxx, même numéro. Les séances d'avant écrivent « Cas créés » etC-xxx: la page de/review-eventaccepte les deux pour retrouver le lot d'origine d'un event appris.
D-087 — 2026-10-29 — La carte des événements, mémoire de l'analyste
- Statut : active. Complète D-074 et D-085 ; point 51 du plan du journal du matin.
- Décision : la carte des événements (
events/carte-des-evenements.md) apprend de chaque event validé ou corrigé par l'expert. À la validation (/new-event,/review-event), ce que l'event enseigne y entre, en termes généraux : l'event dans « Event / source » de son événement, un trait nouveau dans « Ce qu'on voit », ou une ligne de plus ; une ressemblance trompeuse dans une section 5, « Faux amis ». L'utilisateur le voit avec la fiche et le valide avec elle. Un event « (appris) » n'y entre qu'une fois revu ; le builder n'y touche pas. Rien d'autre ne change : fiches, index,read-event, le builder, et l'analyste, qui lit déjà la carte avant ses étiquettes. Rattrapage le 2026-10-29 : E-004, E-006, E-007, E-008, E-010, E-011 ; la carte ne cite plus E-009 (rejeté), ni E-011 comme cible mal configurée. - Pourquoi : l'analyste de
/boucledoit progresser de séance en séance (l'utilisateur, 2026-10-28). Avant ses étiquettes, il ne lit que la carte, restée à E-005 : aucun processus ne la tenait. Les leçons des events validés dormaient dans le Diagnostic des fiches, lues après les étiquettes, et seulement si l'event ressemble au lot. - Options écartées : une compilation à part dans
events/(idée de l'utilisateur, une « learning-map ») : une troisième description des mêmes events après la carte et l'index, à tenir à jour (choix de l'utilisateur, 2026-10-29) ; lire l'index et les fiches validées avant les étiquettes : la lecture grossit avec la base (D-085) ; nourrir la carte des events « (appris) » : l'analyste apprendrait ses propres erreurs ; une mise à jour en lot, plus tard (l'utilisateur : avec la fiche). - Conséquence : « Target stuck » (
degradee) a été fait pour E-011, que l'expert a validé depuis comme configuration voulue (aucune) : écart à trancher, noté dans la carte. La mesure des progrès de l'analyste (question 2 du point 51) : écartée, D-088.
D-088 — 2026-10-29 — L'analyste consulte la base d'events quand il veut
- Statut : active. Modifie D-085 pour l'analyste de
/boucle; l'agent de diagnostic garde son moment (après ses faits, D-048, D-058). - Décision : la base d'events est la base de connaissance de l'analyste ; il la consulte quand il veut, avant sa lecture comme pendant, comme le dit le skill
read-event. Un event connu est une piste à vérifier sur ses données, pas une conclusion. La section « Events connus » de sa critique reste : le builder s'en sert pour séparer les nouveautés de ce que la base connaît. - Pourquoi : l'utilisateur, 2026-10-29 : l'ordre importe peu ; l'analyste doit simplement savoir qu'une base est à sa disposition et qu'il peut la consulter. Avec la carte qui apprend (D-087), c'est ce qui fait progresser son jugement.
- Options écartées : la base à l'étape 4 seulement, après les étiquettes (D-085) : ce qu'apprend la base n'atteignait jamais ses étiquettes ; mesurer ses progrès, par des events témoins étiquetés sans leur fiche ou par les verdicts de l'expert à
/review-event(l'utilisateur, 2026-10-29 : on ne mesure pas). - Conséquence : un risque, déjà nommé pour l'agent de diagnostic : chercher dans les données ce que dit l'event plutôt que ce qu'elles montrent ; d'où la règle de la piste à vérifier, et
read-eventqui fait vérifier chaque critère sur ses propres données. Un lot qui recouvre un event de la base y lit la réponse de l'expert : sans mal pour ses étiquettes.
D-089 — 2026-10-29 — /boucle : detectors-upgrader et detectors-control
- Statut : active. Modifie D-057 (rôles), D-062 et D-069 (usage du score et du benchmark) ; point 52 du plan du journal du matin.
- Décision :
- l'upgrader devient
detectors-upgrader: il rend les détecteurs meilleurs sur le lot, d'après la critique de l'analyste (la vérité, qui met déjà l'accent sur ce qui est significatif) ; il vise les événements significatifs manqués ou mal bornés, pas une sortie identique à celle de l'analyste ; il ne touche qu'aux détecteurs, mais tout lui est possible sur eux (ajouter, retirer, modifier), en commençant par retirer ou simplifier ; chaque catégorie garde au moins un détecteur (D-074) ; il vérifie seul le lot (commande du lot, score) ; - le validateur devient
detectors-control, le garde-fou contre le sur-apprentissage, qui décide au final : il ne regarde pas le lot (ni données, ni critique, ni score ; de la modification, seulement « Ce qui a changé » et « Pourquoi ») ; il juge le diff des détecteurs et le benchmark sur la base d'events : un event moins bien trouvé ou moins bien borné est un recul, même si le total monte ; s'il conteste, ses remarques (au plus trois) retournent audetectors-upgrader, au plus trois passages, puis « garder » ou « annuler » ; - les rendus gardent leurs noms (
modification-K.md,validation-K.md) ; l'historique (séances, décisions passées, plans) reste tel quel.
- l'upgrader devient
- Pourquoi : l'utilisateur, 2026-10-29 : des noms qui disent les responsabilités ; un contrepoids qui empêche de coller les détecteurs au lot courant et de perdre en précision sur les events de la base. Constat (point 52) : le validateur, qui jugeait le lot et la base à la fois et ne renvoyait que pour un défaut net, n'a jamais renvoyé une modification en quatre séances ; à WILDSTRUBEL, il a accepté +1 310 mesures signalées sur E-001 à E-005 sans une juste de plus (« des mesures, pas des événements ») ; sur ces cinq events, la part des mesures signalées qui sont justes est passée de 78 % à 50 % (surtout par D-074, hors de la boucle).
- Options écartées : un critère sur la seule précision mesure par mesure, au lieu des événements (l'utilisateur : l'alignement n'a pas à être parfait) ; un contrôle qui regarde aussi le lot (il en épouserait le point de vue, ce qu'il doit contrebalancer) ; un garde-fou mécanique par seuil sur le benchmark, sans agent (un seuil sans source).
- Conséquence : le contrôle peut renvoyer bien plus souvent qu'avant : des séances plus longues, des modifications plus souvent annulées. À observer à la prochaine séance.
D-090 — 2026-10-29 — /boucle : l'analyste analyse, le detectors-critic critique
- Statut : active. Modifie D-057 (rôles) et D-088 (l'analyste) ; point 53 du plan du journal du matin.
- Décision :
- un agent, une responsabilité (l'utilisateur) : l'analyste produit l'analyse la plus précise du lot, avec tous les outils à sa disposition, les détecteurs compris (une piste à vérifier sur les données, pas une conclusion) : sa lecture, ses étiquettes, les events connus, les nouveautés, dans
analyse.md; plus de verdict ni de suggestions. Son skillcritiquer-lotdevientanalyser-lot(avecetiquettes.py) ; - un nouvel agent,
detectors-critic, juge les détecteurs face à l'analyse, la vérité : la sortie de la commande du lot, le score, le code des détecteurs ; la comparaison événement par événement, le verdict et au plus deux suggestions, danscritique.md, le fichier que lit déjà ledetectors-upgrader; il ne regarde pas les données : il dit quoi et où, le pourquoi d'un défaut revient audetectors-upgrader; - l'orchestrateur appelle l'analyste, puis le
detectors-critic, puis la suite inchangée ; le builder lit les nouveautés dansanalyse.md;/new-eventfait faire à l'analyste sa lecture et ses étiquettes sans les détecteurs ni la base (les étiquettes du benchmark ne leur doivent rien).
- un agent, une responsabilité (l'utilisateur) : l'analyste produit l'analyse la plus précise du lot, avec tous les outils à sa disposition, les détecteurs compris (une piste à vérifier sur les données, pas une conclusion) : sa lecture, ses étiquettes, les events connus, les nouveautés, dans
- Pourquoi : l'utilisateur, 2026-10-29 : ne pas mêler plusieurs responsabilités dans un agent ; l'analyste servait déjà à la seule lecture (
/new-event). - Options écartées : un seul agent dédié au processus des détecteurs, qui lit puis critique (l'option 1 de l'utilisateur) ; renommer l'analyste en
detectors-…(son premier travail est les données, et/new-eventl'appelle sans détecteurs) ; un critic qui regarde les données (il redeviendrait un analyste) ; dire audetectors-upgraderde regarder les données pour trouver le pourquoi (l'utilisateur ne sait pas : l'upgrader reste tel quel, ses rendus diront s'il en a besoin). - Conséquence : un appel d'agent de plus par séance. Pour une fausse alarme dont l'analyse ne dit rien, la critique dit quoi et où, sans le pourquoi ; le
detectors-upgrader, qui ne reçoit pas de consigne pour regarder les données, devra le trouver par le code et la sortie des détecteurs : à observer. Les séances d'avant gardent leurcritique.md, lecture et critique ensemble ; la page de/review-eventmontre les deux fichiers quand ils existent.
D-091 — 2026-10-29 — /boucle : l'event-builder, appelé à chaque lot, décide ce qui est nouveau
- Statut : active. Modifie D-057 (le builder), D-090 (l'analyste) ; point 54 du plan du journal du matin.
- Décision :
- le builder devient
event-builder; l'orchestrateur l'appelle à chaque lot, plus seulement quand un rendu signale une nouveauté ; - il lit toute l'analyse et décide seul, face à la base d'events (
read-event), ce que le lot lui apprend de nouveau : c'est sa responsabilité, à son jugement, sans règle fixée (l'utilisateur : « laissons ce flou ») ; ce que la base connaît se juge sur ses events, qui ont leurs données : un événement que la carte décrit sans event (« hypothétique ») n'est pas connu ; un moment qui contredit un event est noté pour l'utilisateur, sans event ; - un event garde les bornes de l'événement, pas celles du lot (l'utilisateur) : le moment de l'analyse, vérifié sur les données, plus 6 h de part et d'autre ; un état qui couvre le lot, un moment qui le montre ± 6 h ; données, étiquettes, figures et commandes de la signature s'y bornent ;
- la section « Nouveautés » quitte l'analyse (
analyser-lot) et le rendu dudetectors-upgrader; le bilan liste les contradictions avec la base au lieu des « nouveautés déjà connues » ; le rendu garde son nom,builder.md.
- le builder devient
- Pourquoi : l'utilisateur, 2026-10-29 : décider ce qui mérite d'entrer dans la base est la responsabilité du builder, pas de l'analyste (un agent, une responsabilité, D-090). Avec l'ancienne règle (« ce que ni la carte ni l'index ne décrivent »), le premier exemple réel d'un événement hypothétique de la carte n'entrait jamais dans la base.
- Options écartées : garder les nouveautés de l'analyste comme entrée ; la règle « un event par genre d'événement, pas par occurrence » (l'utilisateur : à l'agent de décider).
- Conséquence : un appel d'agent de plus par séance quand rien n'est nouveau ; sans doute plus d'events appris à revoir par
/review-event.
D-092 — 2026-10-29 — /boucle devient /events-learner ; le benchmark de fin sur les mêmes events ; la spec réduite au pourquoi
- Statut : active. Modifie D-057 (le nom), D-069 (le benchmark de fin de séance) ; point 55 du plan du journal du matin.
- Décision :
- le processus s'appelle
events-learner(l'utilisateur) : le skill.claude/skills/boucle/(avecscore.py,benchmark.py,detecteurs.py,comparaison.py) devient.claude/skills/events-learner/, le dossier des séancesboucle/devientevents-learner/(contenu inchangé), la specvues-deplacements/contexte/boucle-automatique.mddevientevents-learner.md, la page de finout/events-learner_<séance>.html, les commitsLearn <STATION> …; « la boucle automatique » reste le mot courant pour le décrire ; l'historique (séances, fiches d'events, décisions passées, plans) garde « /boucle », et la page de/review-eventlit les deux ; - plus de
benchmark-fin.txt: le benchmark de fin des détecteurs est celui de la dernière modification gardée (benchmark-K.txt, oubenchmark-avant.txtsi aucune), sur les mêmes events que celui du début ; les events créés par l'event-builderse mesurent à la séance suivante ; - la spec ne garde que le pourquoi (buts, non-buts, échecs, principes, mesures, essais, pistes) ; le comment est dans le skill et les consignes des agents, écrit une seule fois.
- le processus s'appelle
- Pourquoi : le nom, l'utilisateur, 2026-10-29. Le benchmark : calculé après l'
event-builder, celui de fin portait sur une base plus grande que celui du début, et le total « avant → fin » mêlait deux ensembles d'events. La spec : elle redisait agents et skill ; chaque changement de rôle se recopiait en trois endroits (quatre fois le 2026-10-29). - Options écartées : garder
boucle/pour les séances déjà faites ; retirer le lot uniquelot-01(trois scripts et la lecture des séances passées à changer pour peu) ; lancer le benchmark de fin avant l'event-builder(il redirait celui de la dernière modification). - Conséquence : un lien vers
boucle/…dans l'historique se litevents-learner/….
D-093 — 2026-10-29 — La page des détecteurs dans detectors-view/
- Statut : active. Modifie D-092 (le contenu du skill
events-learner). - Décision : le développement de la page des détecteurs a son dossier,
detectors-view/(l'utilisateur) :detecteurs.pyquitte.claude/skills/events-learner/et emporte ses aides d'affichage, jusque-là danscomparaison.py(barres, survol, ligne « Error rate », couleurs).comparaison.py(page de fin de séance) et.claude/skills/review-event/page.pyimportent la page depuisdetectors-view/;score.pyetbenchmark.pyrestent dans le skill, et la page s'en sert pour classer la plage comme un lot et dater la version des détecteurs. - Pourquoi : travailler sur la page sans toucher au skill de la boucle ; l'import circulaire
detecteurs↔comparaisondisparaît. - Options écartées : déplacer aussi
score.pyetbenchmark.py(outils de la boucle, appelés par ses agents) ; sortir le JavaScript de la page dans des fichiers à part (non demandé). - Conséquence :
python3 detectors-view/detecteurs.py data/<STATION> [--du D --au F]; un lien vers.claude/skills/events-learner/detecteurs.pydans l'historique se litdetectors-view/detecteurs.py.
D-094 — 2026-10-29 — La page Status dans detectors-view/
- Statut : active.
- Décision :
detectors-view/status.py(l'utilisateur) sera une version pseudo finale de la page de l'onglet Explore du site, à côté dedetecteurs.py. Elle part d'une page vide (out/status_<STATION>[_<du>_<au>].html), même usage quedetecteurs.py; son contenu viendra des consignes de l'utilisateur. - Pourquoi :
detecteurs.pyreste l'outil de développement des détecteurs, repris parcomparaison.pyet/review-event; la page Status prépare la page Explore du site sans toucher à ces pages. - Conséquence :
python3 detectors-view/status.py data/<STATION> [--du D --au F].
D-095 — 2026-10-29 — La hiérarchie des status de la page Status
- Statut : active. Complète D-094. Le regroupement thermique (Thermal movements) est suspendu dans
status.pyle 2026-10-29 : il ne vaut que pour deux phases aux mêmes cibles ; le document le garde, en attendant l'utilisateur. - Décision : la page Status (
detectors-view/status.py) n'affiche pas tous les événements des détecteurs tels quels :detectors-view/hierarchie-des-status.md, validé par l'utilisateur, dit lesquels se superposent et lesquels s'occultent. Familles : No visibility occulte Reduced visibility, Target issue occulte Target hidden ; Thermal expansion et Thermal contraction forment un seul status, Thermal movements. Entre familles : No data occulte tout, No visibility occulte Target hidden ; le reste se superpose. Un status occulté est coupé, pas supprimé, et seulement si le plus fort concerne tous ses capteurs (règle 4). - Pourquoi : des status qui se chevauchent disent souvent la même chose ; le plus fort suffit, et la rangée des étiquettes reste lisible.
- Options écartées : choisir le gagnant entre les deux phases thermiques (l'utilisateur les regroupe) ; occulter sans regarder les capteurs (sur NIEDERHORN, une Target issue de toute la plage aurait caché 7 Target hidden sur d'autres capteurs).
- Conséquence :
status.pytranscrit le document (FUSION,OCCULTE) ; il ne change que l'affichage, pas les détecteurs nidetecteurs.py.
D-096 — 2026-10-29 — Pompage des stations suivies, jusqu'à maintenant
- Statut : active. Complète D-065 ; complétée par D-125.
- Décision :
extraction/stations.txtliste les stations suivies (au départ, les 8 dedata/).pomper.pylancé sans station ni dates, à la main dans le dev container, les met toutes à jour jusqu'à maintenant : chaque station repart de son dernier jour de déplacements pompé, qui est remplacé ; une station sans déplacements pompés reçoit les 30 derniers jours. Le jour en cours est pompé tel qu'il est, ses métriques jusqu'à la dernière heure terminée. La commande avec--duet--aureste pour une plage choisie (historique, jour en échec). - Pourquoi : sans cela, il fallait attendre le lendemain pour analyser une nuit ou une matinée, et retaper la commande station par station.
- Options écartées : un pompage planifié (cron dans WSL, container éphémère toutes les 15 min), une règle de jour final à 6 h après sa fin, une écriture atomique : jugés beaucoup trop compliqués par l'utilisateur ; un script à part (le mode sans argument de
pomper.pysuffit). - Conséquence : un jour pompé en cours de journée reste incomplet jusqu'au lancement suivant sans
--du. Un trou plus ancien que le dernier jour pompé n'est pas comblé : commande avec--du; comblé depuis D-125.
D-097 — 2026-10-29 — /aiguiser retiré : l'analyste crée ses outils, un tool-builder les fait entrer dans agent-tools/
- Statut : active. Remplace D-059 (et avec lui D-064, D-076, D-077, D-078) ; modifie D-090 (l'analyste) et D-092 (le déroulé de
/events-learner) ; point 56 du plan du journal du matin. - Décision :
- l'analyste voit ses données :
inventaire.pydit, sur la fenêtre, ce que contient chaque source (colonnes de l'export, de la pose et dequality/, remplies ou vides ; noms des métriques système demetrics/; images et images différentielles ; des noms et des comptes, jamais de valeurs) ;analyser-lotgagne une étape 0, « Tes données », avant la lecture ; - il peut écrire ses propres scripts (
<dossier de sortie>/outils/, bibliothèque standard, matplotlib par.venv), sur les CSV bruts ou pardonnees.py, à son choix ; son analyse gagne une section « 3. Outils » : chaque outil dont il s'est servi, existant ou à lui, à quoi il a servi, ce qu'il a montré, ce qui a manqué ou encombré ; - un agent
tool-builder(l'optimiseur de/aiguiser, renommé et réécrit), appelé à chaque lot de/events-learnerjuste après l'analyste, lit cette section et décide seul d'optimiser ou d'ajouter des outils de lecture (agent-tools/,lire-les-donnees) ; il ne retire rien : un seul lot ne suffit pas pour nettoyer la liste des outils (l'utilisateur) ; il garde les interdits de l'optimiseur (aucun jugement dans ce que rend un outil, rien de propre à une station, aucun import des détecteurs) et les commandes des fiches qui marchent ; il ne touchedonnees.pyque pour une erreur de lecture montrée par l'analyste ; - score et benchmark se calculent après le
tool-builder: les détecteurs lisent pardonnees.py, et toutes les mesures d'une séance portent ainsi sur la même lecture ; - pas de contrôle du
tool-builderpour l'instant : on regarde comment ça tourne (l'utilisateur) ; /aiguiserse retire : son skill, le lecteur, le correcteur etaiguiser/voir.py; ses séances (aiguiser/) et sa spec (vues-deplacements/contexte/aiguiser-la-lecture.md) restent, comme historique ;/new-eventappelle l'analyste sanstool-builder.
- l'analyste voit ses données :
- Pourquoi : l'utilisateur, 2026-10-29 : le lecteur de
/aiguiserextrait des informations sans savoir ce qui est pertinent, et refait le même travail à chaque séance sans être guidé ; celui qui profite des outils, c'est l'analyste, qui apprend par la base d'events. Constat : la vérité de/aiguisercomptait tout écart comme un moment, si bien que « mieux » voulait dire « voir plus » (neuf modifications sur neuf gardées en quatre séances ; outils de 419 à 1 423 lignes, skill de 4,8 à 20,9 Ko) ; et l'inventaire cachait des données : six colonnes de qualité d'image remplies sur LENZSPITZE et NADELHORN, 31 métriques système, qu'aucun outil ni aucune doc ne citait. - Options écartées : revoir
/aiguisercomme/events-learner(unreading-critic, unreading-upgrader, unreading-control; première proposition de Claude) : le lecteur restait sans notion de pertinence ; untool-builderqui retire des outils (l'utilisateur) ; un contrôle dutool-buildersur le diff (l'utilisateur ne sait pas encore comment le faire) ; un nouveau script pour l'inventaire des données (inventaire.pyétendu suffit). - Conséquence : une séance de
/events-learnerappelle six agents ; l'analyste, qui peut écrire des scripts, coûtera sans doute plus. Lire en brut garde une part de ce qu'apportait le correcteur, qui a trouvé la seule erreur de lecture commune (rejets des références, WILDSTRUBEL, 2026-10-27). Un changement dedonnees.pyse voit d'une séance à l'autre dans l'historique du benchmark. Sans retrait ni contrôle, les outils peuvent encore grossir : à observer.
D-098 — 2026-10-30 — L'expert étiquette lui-même : labeling/
- Statut : active, à l'essai ; point 68 du plan du journal du matin ; complétée par D-100 (les events validés y ont leurs étiquettes) ; « sans catégorie » remplacé par D-107 (une catégorie du journal au choix).
- Décision : un outil local et très simple,
labeling/labeling.py, qui ne sert qu'à se repérer dans le temps et à écrire ; les données se consultent sur le monitoring. Le data loader de la page Status, un plot à la fois (menu Advanced d'Explore, plus les métriques système numériques, sans les identifiants), une barre de temps alignée où l'on sélectionne une plage, du texte, et Add écrit aussitôt. Des étiquettes en langage naturel, sans catégorie, danslabeling/<STATION>.jsonl, une ligne chacune (debut,fin,description), versionné ; zones grisées sur tous les plots, chevauchements admis ; un clic sur une étiquette permet de lire et de modifier son texte (Save, demande de l'utilisateur, 2026-10-30) de corriger ses bornes et de la retirer (Delete, 2026-11-02). - Pourquoi : l'utilisateur, 2026-10-30 : que l'analyste prenne connaissance des phénomènes sur des cas étiquetés par l'expert, en plus de ce qu'on lui explique (point 67) ; pas de catégorie pour ne pas borner, on en déduira après coup ; le but est d'avoir les étiquettes, pas une application. Constat de Claude : la seule vérité du projet était l'analyste (
score.py, benchmark). - Options écartées : l'étiquetage dans la page Status, avec les status des détecteurs,
error_value, une température et une catégorie facultative (première proposition de Claude) : l'outil doit rester simple, le monitoring montre le reste ; le format deetiquettes.json: ses champs obligatoires (catégorie, preuve, capteurs) bornent, et un seul objet JSON se réécrit à chaque ajout. - Conséquence :
score.pyne lit pas ces étiquettes (pas de catégorie, et un instant sans étiquette n'y veut pas dire « rien vu »). Comment l'analyste s'en sert reste à décider, une fois assez d'étiquettes écrites (point 69 du plan :/labels-learnerproposé). Une étiquette n'entre dansevents/que par/new-eventou l'event-builder.
D-099 — 2026-11-02 — Apprendre des étiquettes de l'expert : /labels-learner
- Statut : active, à l'essai ; point 69 du plan du journal du matin.
- Décision : un skill lancé par l'utilisateur,
/labels-learner <phénomène>. L'orchestrateur retient avec lui au plus cinq étiquettes delabeling/sur ce phénomène ; l'agentanalyste, sur une consigne à part (.claude/skills/labels-learner/analyste.md, pasanalyser-lot), mesure dans les données ce que dit chacune (la signature : colonnes, capteurs, valeurs, ordre), les compare et pose ses questions à l'expert ; l'orchestrateur les relaie, l'analyste reprend avec les réponses, jusqu'à avoir compris (au plus trois tours), puis écrit ses conclusions. Un nouvel agent, ledocumentaliste, qui tient la documentation métier du projet, les fait entrer à leur place (chaîne de mesure, carte des événements,lire-les-donnees,docs/domaine/), sans doublon, avec leur source ; l'utilisateur relit le diff, puis commit. Rendus danslabeling/lecons/<date>_<phénomène>/(etiquettes.jsonl,lecon.md), versionnés. - Pourquoi : l'utilisateur, 2026-10-30 : les étiquettes ne valent que si l'analyste en apprend, et apprendre, ici, c'est documenter ; 2026-11-02, sur ses 13 premières étiquettes : pas de lecture à l'aveugle, il n'en voit pas l'intérêt ; le texte des étiquettes suffit, pas de fiche de station. Le même jour, l'utilisateur : ce que l'analyste apprend doit être documenté ; il peut poser des questions, et quand il a tout compris, il passe ses conclusions à un agent de documentation, nouveau, dont le rôle est de maintenir la documentation du projet. Constat de Claude sur ces étiquettes : elles disent le mécanisme, et la mesure dans les données le précise (deux références acceptées donnent
reproj_err= 0, une seule le laisse vide, à JUNGFRAU et NORDEND). - Options écartées : des propositions présentées une à une à l'utilisateur, appliquées par l'orchestrateur (première version de Claude, le même jour) : les questions à l'expert tiennent lieu de validation, et la documentation a son agent ; la lecture à l'aveugle avant la confrontation (proposition de Claude, pour mesurer l'écart entre l'analyste seul et l'expert) : refusée par l'utilisateur ; une fiche de contexte par station (ouvrage, références) : le texte des étiquettes le dit ; un nouvel agent : l'analyste sait lire les données ; un document de leçons que l'analyste relirait : les acquis vont dans la chaîne de mesure, la carte et
lire-les-donnees(point 67 : ne pas l'alourdir). - Conséquence : le savoir entre par les réponses de l'expert et se relit au diff avant le commit ; une conclusion vue sur une seule station reste
[H]. Ledocumentalisteest général : d'autres processus pourront lui passer leurs conclusions. La chaîne de mesure n'est pas encore lue par l'analyste de/events-learner(point 67) : ce qu'elle apprend ne l'atteint qu'ensuite. Ni détecteurs ni events ici :/events-learneret/new-event.
D-100 — 2026-11-02 — Les étiquettes, base de connaissance ; les events validés y ont les leurs
- Statut : active ; complète D-098 et D-099.
- Décision : les étiquettes de l'expert (
labeling/) sont la base de connaissance la plus fondamentale du projet : des plages de données, avec le diagnostic et la classification de l'expert. Le travail de l'analyste est de refaire cette classification sur des plages. Les events (events/) sont gardés, et chaque event validé a aussi ses étiquettes, dans le fichier de sa station,labeling/<STATION>.jsonl, avec les vrais noms des capteurs (station et noms tirés du registre deanonymize-event, les dates sont les mêmes), pour que l'outil les montre avec les autres ; tirées de sa fiche (event.md), une étiquette par occurrence du phénomène, le texte disant ce qu'on voit, la cause et comment on l'a sue, la classification, la conséquence ; au même format que les autres (debut,fin,description). Écrites par un agent avec les codes de l'event, puis décodées et ajoutées au fichier de la station par Claude (l'agent ne lit pas le registre). - Pourquoi : l'utilisateur, 2026-11-02 : se concentrer d'abord sur les étiquettes faites à la main, sa base de connaissance ; on ne sait pas si les events serviront, mais ils restent utiles ; avec assez d'étiquettes, on pourra penser à des algorithmes d'apprentissage automatique. Un event validé porte son diagnostic : c'est une étiquette de l'expert.
- Options écartées : garder events et étiquettes séparés (avis de Claude, le même jour : doublon avec la carte des événements, et une fiche n'est pas écrite par l'expert) ; des fichiers à part,
labeling/E-xxx.jsonl, aux noms codés, ouverts sur les données de l'event (première version, le même jour) : l'outil de l'utilisateur ne charge que les fichiers des stations, un seul système ; reprendre les moments d'etiquettes.json(l'analyste sur tout le lot, ceux de E-001 à E-005 pas encore relus, point 48) ; les events « (appris) » (E-012 à E-014) avant/review-event. - Conséquence :
/labels-learneret l'outil les lisent comme les autres. Sans champsource(retiré à la demande de l'utilisateur, le même jour) : rien ne relie une étiquette à son event, ni une station à son code (D-049). E-001 est surPS_DES_COUDRES, absente dedata/: son étiquette attend le pompage. Un event validé plus tard devra recevoir ses étiquettes (à brancher dans/new-eventet/review-event, point 70).
D-101 — 2026-11-02 — Un vérificateur des étiquettes : l'agent label-reviewer
- Statut : remplacée par D-103 pour la forme (un skill, pas un agent) ; le reste tient.
- Décision : un agent,
label-reviewer(.claude/agents/label-reviewer.md), appelé depuis la conversation sur un fichierlabeling/<STATION>.jsonl: pour chaque étiquette sans champrevue, il mesure dans les données ce que dit le texte, contrôle la forme, les bornes, les noms des capteurs, l'heure (UTC, jour ou nuit sur les images), la cause et comment elle a été sue, les autres étiquettes et la documentation (carte des événements, chaîne de mesure), puis écrit sa revue danslabeling/revues/<STATION>.mdet rend ses questions ; la conversation les pose à l'utilisateur et lui renvoie les réponses. Il ne change une étiquette que sur la parole de l'utilisateur ; une étiquette confirmée ou corrigée reçoit"revue": "<date>", qu'un Save de son texte dans l'outil retire. - Pourquoi : l'utilisateur, 2026-11-02 : un vérificateur qui pointe les incohérences et lui pose des questions pour confirmer ses étiquettes, car il peut simplement faire des erreurs ; les étiquettes sont la base de connaissance (D-100).
- Options écartées : un skill orchestrateur (comme
/review-event) : la conversation suffit à relayer les questions ; un agent qui corrige seul : une incohérence peut venir des données ou de la documentation, l'expert tranche. - Conséquence : une étiquette porte
revueune fois vérifiée ;/labels-learnerne les distingue pas encore.
D-102 — 2026-11-02 — Les étiquettes en deux dossiers : manual/ et auto/
- Statut : active ; complète D-098, D-100 et D-101.
- Décision :
labeling/manual/<STATION>.jsonlreçoit les étiquettes faites à la main (l'outil y lit et y écrit), dont celles des events validés, vérifiées avec lelabel-reviewer;labeling/auto/recevra celles que l'analyste trouvera seul, vide pour l'instant (son format et l'outil qui les montre restent à décider)./labels-learneret lelabel-reviewerlisentmanual/. - Pourquoi : l'utilisateur, 2026-11-02 : les étiquettes faites ensemble se valident avec le reviewer ; celles que l'analyste trouve seul vont à part.
- Options écartées : aucune proposée.
- Conséquence : les 43 étiquettes existantes sont déplacées dans
manual/; l'outil ne montre pas encoreauto/.
D-103 — 2026-11-02 — La revue des étiquettes, un skill mené dans la conversation : /review-labels
- Statut : active ; remplace la forme de D-101.
- Décision : l'agent
label-reviewerdevient le skillreview-labels(.claude/skills/review-labels/SKILL.md), que la conversation suit elle-même :/review-labels <STATION>prend les étiquettes sansrevuedans l'ordre chronologique, une à la fois ; pour chacune, les mêmes contrôles que D-101, puis sa présentation à l'utilisateur, ses questions, sa réponse appliquée, et seulement alors la suivante. La revue ne garde pas de fichier à part : l'étiquette revue porterevue. Une étiquette est qualitative, en langage naturel, sans valeurs : l'analyste quantifiera ensuite. - Pourquoi : l'utilisateur, 2026-11-02, après le premier essai sur NIEDERHORN : passer chaque étiquette en revue et la valider ensemble, plutôt que recevoir d'un agent toutes les questions d'une station d'un coup ; les chiffres dans les étiquettes, c'est le travail de l'analyste.
- Options écartées : garder l'agent et relayer ses questions (le premier essai) : un intermédiaire de plus, et toutes les questions à la fois.
- Conséquence :
.claude/agents/label-reviewer.mdetlabeling/revues/sont retirés (l'utilisateur, 2026-11-02 : pas de fichier de revue).
D-104 — 2026-11-02 — La carte des étiquettes : /labels-map
- Statut : active, à l'essai ; point 71 du plan du journal du matin.
- Décision : les étiquettes revues de l'expert (
labeling/manual/) sont rangées par phénomène danslabeling/carte-des-etiquettes.md, que l'analyste lit : une fiche par phénomène (ce qui se passe, ce qu'on voit par grandeur, au fil du temps, la cause et comment l'expert l'a sue, la conclusion, les variantes, les étiquettes), dans les familles de la carte des événements plus G (configuration de la station) ; puis les règles de lecture de l'expert, les faux amis, le contexte des stations, les écarts avec la carte des événements et ce que les étiquettes ne disent pas encore. Chaque fait cite ses étiquettes par une cléSTATION JJ.MM HH:MM. La carte est dérivée : le skilllabels-map(/labels-map, lancé par l'utilisateur) la refait en entier, etcontrole.pyvérifie les clés et la couverture. - Pourquoi : l'utilisateur, 2026-11-02, après la revue des étiquettes : elles sont la base de connaissance bas niveau ; il faut en faire quelque chose d'utilisable par l'analyste, comme la carte des événements, puis s'en servir pour les étiquettes automatiques.
- Options écartées : une carte enrichie au fil de l'eau comme la carte des événements (D-087) : la source est le fichier des étiquettes, une carte refaite en entier ne s'en écarte pas ; corriger l'autre carte depuis celle-ci : ses écarts sont listés, l'utilisateur tranche.
- Conséquence : premier passage le 2026-11-02, 23 étiquettes, 14 phénomènes ; la relecture face aux étiquettes a renforcé le skill (prudence de l'expert gardée, jour et nuit seulement s'il les dit, « non dite » plutôt qu'« inconnue », règles et faux amis tenus à ses phrases). L'analyste ne la lit pas encore (ni
analyser-lotni/labels-learner) : à brancher avec les étiquettes automatiques.
D-105 — 2026-11-02 — Les étiquettes automatiques : l'analyste étiquette un lot seul, au format de l'expert
- Statut : active, à l'essai ; point 71 du plan du journal du matin ; complète D-102 et D-104 ; l'agent qui étiquette : remplacé par D-106.
- Décision : l'agent
analyste, sur une consigne à part (.claude/skills/analyser-lot/etiquettes-auto.md), lit un lot avec les outils delire-les-donnees, la carte des étiquettes en entier, la chaîne de mesure et la carte des événements, sanslabeling/manual/ni les détecteurs, et ajoute ses étiquettes àlabeling/auto/<STATION>.jsonl, au format de l'expert (debut,fin,descriptionqualitative, sans valeurs) ; ses mesures, sa confiance et ce que la documentation lui a donné ou manqué vont danslabeling/auto/<date>_<STATION>/analyse.md. L'outil d'étiquetage les montre par son menu Labels (manualouauto). L'utilisateur juge leur qualité. Premier lot : JUNGFRAU, du 2026-10-20 au 2026-10-26 exclu. - Pourquoi : l'utilisateur, 2026-11-02 : mesurer les performances de l'analyste sur des données avec la documentation mise en place ; il vérifie ensuite la qualité des étiquettes. Le lot est sur une station de la carte (son contexte est légitime : l'expert connaît son site) mais hors de ses étiquettes : la carte cite chaque étiquette et dit ce qui s'y passe, l'analyste y lirait la réponse.
- Options écartées :
analyser-lottel quel (catégories pour/events-learner, pas de carte des étiquettes) ; une plage déjà étiquetée par l'expert (fuite par la carte) ; NADELHORN, absente de la carte (proposée par Claude comme test à froid ; l'utilisateur a choisi JUNGFRAU) ; une forme structurée (catégorie, capteurs) : le même format que l'expert se compare d'égal à égal. - Conséquence : pas de score automatique : les étiquettes de l'expert ne couvrent pas tout, le jugement est le sien. Rien n'est commité avant qu'il ait validé l'essai.
D-106 — 2026-11-02 — Un agent d'étiquetage : l'etiqueteur
- Statut : active, à l'essai ; point 71 du plan du journal du matin ; remplace D-105 pour l'agent, le reste tient.
- Décision : un agent à part,
etiqueteur(.claude/agents/etiqueteur.md), un analyste qui ne produit que des étiquettes : la consigne de l'essai de D-105 (.claude/skills/analyser-lot/etiquettes-auto.md, retirée) devient son corps, sansCLAUDE.md; mêmes lectures permises, même format d'étiquettes, même analyse. Il ne reçoit que le dossier de station et le lot ; les étiquettes vont par défaut danslabeling/auto/<STATION>.jsonl(créé s'il manque), l'analyse dansout/etiqueteur/<STATION>_<début du lot>/, hors de git. Ses scripts dansoutils/sont permis en plus de ce que permetlire-les-donnees(difficulté relevée par l'essai JUNGFRAU). Appel :@etiqueteur data/<STATION> du <début> au <fin>. - Pourquoi : l'utilisateur, 2026-11-02 : un agent d'étiquetage, peut-être mieux qu'une consigne à part de l'analyste. Un rôle par responsabilité (D-088) : l'analyste reste la vérité de
/events-learneret de/labels-learner, sa consigne ne porte plus deux métiers. - Options écartées : garder l'analyste avec une consigne nommée dans la demande (D-105) : chaque appel doit la nommer, et l'agent porte deux rôles.
- Conséquence :
analyser-lotne sert plus aux étiquettes automatiques ; pas d'essai de l'agent lui-même avant que l'utilisateur le lance. - Précisions de l'utilisateur, 2026-11-02 : une étiquette n'est qu'un seul événement, jamais un ensemble ; un événement qui se répète s'étiquette à chaque fois ; le travail est exhaustif mais précis. Elles remplacent « un phénomène thermique de plusieurs jours : une étiquette pour toute la plage » : la vague de chaque jour a son étiquette, un seul événement de plusieurs jours (une montée lente) garde la sienne.
- L'utilisateur, 2026-11-02 : inutile d'enregistrer toutes les données de son travail, ne garder que les étiquettes : son dossier de sortie (figures, sorties des outils, scripts, analyse) passe dans
out/etiqueteur/, hors de git ; les dossiers des deux premiers essais y sont déplacés.
D-107 — 2026-11-02 — Une catégorie dans l'étiquette
- Statut : active, à l'essai ; point 71 du plan du journal du matin ; précise D-098 (texte « sans catégorie ») et D-106 ; les deux thermiques réunies par D-108 ; ses valeurs, les catégories du journal, remplacées par les familles de D-109.
- Décision : une étiquette peut porter un champ
categorie, entre les bornes et le texte :{"debut", "fin", "categorie", "description"}. Ses valeurs : les clés des douze catégories du journal (D-074, section 4 deevents/carte-des-evenements.md,CATEGORIESdedetectors/categories.py), ouaucune(ne touche pas les courbes), comme le champcategoriedes étiquettes de l'analyste (analyser-lot). L'etiqueteuren donne une, obligatoire, à chaque étiquette (deux phénomènes de catégories différentes : deux étiquettes) et dit pourquoi dans son analyse. L'outil d'étiquetage a un menu Category, à l'Add et à l'édition, facultatif (les 24 étiquettes de l'expert n'en ont pas), la catégorie en tête du texte dans la barre et au survol ; un Save qui la change retirerevue, comme pour le texte. - Pourquoi : l'utilisateur, 2026-11-02 : l'étiqueteur doit donner une catégorie à l'événement ; l'outil, un champ pour la mettre, et un champ dans l'étiquette. Les catégories du journal plutôt que les phénomènes de la carte des étiquettes : une liste fixe, celle des détecteurs, déjà celle de l'analyste ; c'est la forme structurée que le point 71 attendait pour comparer aux détecteurs.
- Options écartées : les phénomènes de la carte des étiquettes (refaite par
/labels-map, ses titres changent) ; les familles A à G de la carte des événements (trop larges pour les détecteurs) ; la catégorie obligatoire dans l'outil (les étiquettes déjà écrites n'en ont pas). - Conséquence :
/review-labelset/labels-mapne lisent pas encore la catégorie ; à brancher quand l'utilisateur le demande.
D-108 — 2026-11-02 — Étiquettes : un seul déplacement thermique, les anomalies seulement
- Statut : active, à l'essai ; point 71 du plan du journal du matin ; précise D-106 et D-107 ;
deplacement_thermiquedevient une des familles de D-109. - Décision : dans les étiquettes,
dilatation_thermiqueetcontraction_thermiquedeviennent une seule catégorie,deplacement_thermique(« Thermal displacement ») : le sens ne compte pas ; l'aller puis le retour restent deux événements, deux étiquettes. Le journal et ses détecteurs gardent leurs deux catégories. L'etiqueteurn'étiquette que les anomalies : ce qui se voit sur les courbes corrigées ou les prive de données ; ce que la caméra compense sans rien laisser sur les courbes corrigées va dans son analyse, pas dans une étiquette (il n'a donc plus de raison d'écrireaucune, que l'outil garde pour l'expert). Les 12 étiquettes thermiques de JUNGFRAU du 30.09 au 05.10 passées àdeplacement_thermique. - Pourquoi : l'utilisateur, 2026-11-02, après le deuxième essai de l'étiqueteur (JUNGFRAU, 30.09 → 05.10, « globalement bon ») : le sens d'un déplacement thermique n'est pas important ; un phénomène compensé par la caméra, dont les courbes corrigées ne montrent rien, ne vaut pas une classification.
- Options écartées : changer aussi les catégories du journal (phrases du site, détecteurs, benchmark) : pas demandé ; la comparaison avec les détecteurs réunit les deux thermiques.
- Conséquence : les étiquettes ne prennent plus toutes leurs clés dans le journal ; un script qui les compare aux détecteurs lit
deplacement_thermiquecomme l'une ou l'autre.
D-109 — 2026-11-02 — Les familles des étiquettes
- Statut : active, à l'essai ; point 71 du plan du journal du matin ; remplace les valeurs de
categoriede D-107 et D-108 ;turbulenceréunie àvisibilitepar D-110 ; le trou, étiqueté (familletrou) par D-111 ; Faulty target (Cible défaillante, clécible_degradee) renommée Target issue, clécible_a_probleme(l'utilisateur, 2026-11-03 : nom pas clair), partout : familles, catégorie du journal, étiquettes, events, documentation et historique. - Décision : le champ
categoried'une étiquette prend la clé d'une famille, décrite danslabeling/familles.md(ce qui arrive, la conclusion pour le client, les phénomènes de la carte des étiquettes, les frontières, ce qui ne s'étiquette pas, la correspondance avec le journal) :visibilite(Visibility),obstruction(Obstruction),turbulence(Atmospheric turbulence),deplacement_thermique(Thermal displacement),deplacement(Displacement),cible_a_probleme(Target issue) ; l'outil gardeaucunepour l'expert. L'etiqueteurlit ce fichier en entier, n'utilise que ces six clés ; un trou de mesures ne s'étiquette pas. Les 3 étiquettes automatiques de JUNGFRAU qui n'avaient pas déjà une clé de famille passées à la leur ; le journal et ses détecteurs gardent leurs douze catégories. - Pourquoi : l'utilisateur, 2026-11-02 : cinq familles (Visibility, Obstruction, turbulences atmosphériques, Thermal displacements, Displacements), documentées dans ce que lit l'étiqueteur. Ajustements de Claude, acceptés : une sixième, Target issue (une cible constamment problématique, dont la conclusion est d'intervenir sur elle) ; le saut puis retour dans la famille de sa cause ; pas d'étiquette pour un trou (un script le trouve) ; les frontières Visibility / Obstruction, Thermal / Displacement ; les familles pour les étiquettes seules. Une famille par cause et par conclusion pour le client ; moins de classes, plus d'accord entre l'étiqueteur et l'expert.
- Options écartées : les familles dans la carte des étiquettes (refaite par
/labels-map, un ajout à la main s'y perdrait) ; les familles aussi dans le journal (pas demandé) ; un saut bref comme famille à part. - Conséquence : la carte des étiquettes reste rangée par les familles de la carte des événements ;
familles.mdrelie ses phénomènes aux familles des étiquettes. Comparer aux détecteurs passe par la correspondance defamilles.md.
D-110 — 2026-11-02 — Étiquettes : la turbulence dans Visibility
- Statut : active, à l'essai ; point 71 du plan du journal du matin ; précise D-109.
- Décision : la famille
turbulence(Atmospheric turbulence) est réunie àvisibilite(Visibility) : une gêne diffuse entre la caméra et la scène, l'image faible ou floue, ou qui tremble ; la description dit laquelle est vue. Cinq familles :visibilite,obstruction,deplacement_thermique,deplacement,cible_a_probleme.labeling/familles.md, l'etiqueteuret le menu Category de l'outil suivent ; les 6 étiquettesturbulencede WILDSTRUBEL (01.09 → 06.09) passées àvisibilite. Le journal garde sa catégorieturbulenceet son détecteur ; la correspondance la range dansvisibilite. - Pourquoi : l'utilisateur, 2026-11-02, après l'essai WILDSTRUBEL : turbulence atmosphérique et Visibility, « la même chose ». Avis de Claude, accepté : deux mécanismes, mais pour une étiquette la même conclusion pour le client, et une séparation que les images fixes ne montrent pas (l'étiqueteur a tiré la turbulence du contexte de la station, sans la voir, en doutant de la lumière).
- Options écartées : garder deux familles, la signature de la turbulence (milieu de journée, soleil, surface chaude, bruit rapide sans rejet) dite dans la description à la place.
- Conséquence : aucune.
D-111 — 2026-11-02 — Étiquettes : ce qui apparaît sur corr_x et corr_y, trous compris
- Statut : active, à l'essai ; point 71 du plan du journal du matin ; précise D-108 (les anomalies seulement) et D-109 (le trou ne s'étiquetait pas).
- Décision : pour l'
etiqueteur, une anomalie est ce qui apparaît surcorr_xetcorr_y, et seulement cela : les courbes bougent (pic, saut, dérive, vague, bruit) ou manquent (points ou courbes absents du plot). Les bornes d'une étiquette sont la mesure juste avant le premier point touché sur ces courbes et la mesure juste après le dernier (l'utilisateur, même jour : jamaisdebut=fin, une étiquette d'une seule mesure restant visible dans l'outil ; la largeur minimale à l'écran, essayée puis retirée). La cause se cherche partout (error_value, images, métriques), mais ce qui ne les touche pas ne s'étiquette pas (uneerror_valuequi monte sans effet sur elles, ce que la caméra compense). Un trou est une anomalie comme un pic : l'étiquette dit pourquoi les courbes manquent ; des cibles rejetées, la famille de la cause du rejet ; aucune mesure pour aucun capteur, une sixième famille,trou(No data), la cause si les métriques ou les images la montrent.labeling/familles.md, l'étiqueteur et le menu Category suivent. - Pourquoi : l'utilisateur, 2026-11-02 : la granularité, c'est ce qui apparaît dans
corr_xetcorr_y; on ne veut un diagnostic que lorsque les courbes se déplacent ; un trou demande aussi une explication : si des courbes sont absentes du plot, il faut dire pourquoi. - Options écartées : le trou laissé à un script (D-109) : il trouve le trou, pas sa cause ; un trou toujours en
trou, quelle que soit sa cause : la famille dit la cause, une cible rejetée par la pluie est Visibility. - Conséquence : les étiquettes déjà écrites (JUNGFRAU, WILDSTRUBEL) ont été faites avant : des
visibilitesur la seuleerror_value(PB1_2 à WILDSTRUBEL, la gêne de chaque jour) et des trous non étiquetés ; à refaire si l'utilisateur le demande.
D-112 — 2026-11-02 — /events-learner sur les étiquettes de l'étiqueteur
- Statut : remplacée par D-118 (les agents des détecteurs ne servent plus que
/detector-learner) ; point 72 du plan du journal du matin ; remplaçait, dans la séance, l'analyste (D-088, D-090), letool-builder(D-097) et l'event-builder(D-091) ; le score de D-062 passe aux familles. - Décision : la vérité d'une séance de
/events-learner, ce sont les étiquettes du lot danslabeling/auto/<STATION>.jsonl, écrites avant par l'etiqueteur(D-106) et relues par l'utilisateur ; la séance s'arrête si le lot n'en a aucune, et ne les modifie pas. Elle se réduit aux détecteurs : score et benchmark avant,detectors-critic(les détecteurs face aux étiquettes, la catégorie du journal lue dans sa famille par la correspondance delabeling/familles.md, un saut bref dans la famille de sa cause), puisdetectors-upgraderetdetectors-controlcomme avant, bilan, releveur. Le score (score.py <dossier> --du --au) compte par famille et par instant, sur le seul lot ; la page de fin de séance (comparaison.py … --du --au) range étiquettes et détecteurs sur une ligne par famille. Le benchmark sur la base d'events ne change pas. - Pourquoi : l'utilisateur, 2026-11-02 : le travail de l'analyste est fait en amont, dans
labeling/auto/, avec les étiquettes ; adapter le processus pour les utiliser. Letool-builderet l'event-builderlisaient l'analyse de la séance : sans elle, ils n'ont plus d'entrée (avis de Claude, le plus simple). - Options écartées : convertir les étiquettes au format de l'analyste (
etiquettes.json, capteurs, catégories du journal) : une famille couvre plusieurs catégories, et les capteurs ne sont que dans le texte ; un score par capteur, tiré des noms de la description (fragile) ; un score sur tous les lots étiquetés de la station (le fichier ne dit pas quelles plages l'étiqueteur a lues en entier) ; garder l'ancienne page des séances passées (lot-*/etiquettes.json). - Conséquence :
analyste,tool-builderetevent-builderrestent, sans appel par la séance ; la base d'events ne grandit plus par/events-learner. Les séances passées gardent leurs fichiers, leur page ne se refait plus avec cecomparaison.py. Les 7 étiquettes du premier essai de JUNGFRAU (20 → 25.10) n'ont pas de famille : le score les compte « sans famille ».
D-113 — 2026-11-02 — /support <STATION> : le rapport de situation, à partir des étiquettes
- Statut : active, à essayer ; complète D-079, qui reste le mode « mail ».
- Décision :
/support <STATION> [--du --au](.claude/skills/support/rapport.md) fait le point sur une station pour le client, à partir des étiquettes delabeling/auto/<STATION>.jsonlet delabeling/familles.md, qui font le diagnostic ; les données dedata/ne servent qu'à l'illustrer, une ou deux images par constat (la courbe des cibles touchées, plage grisée, et l'image de la caméra quand la cause s'y voit), chacune regardée avant d'être gardée. Il regroupe les étiquettes d'une même cause en constats, les classe par ce qui compte pour le client (Displacement, Target issue, No data, puis Obstruction et Visibility, enfin Thermal displacement), et écritsupport/<AAAA-MM-JJ>_<STATION>_rapport-situation/rapport.md: En bref, Ce qui s'est passé, À faire, Ce qui n'est pas établi, Chronologie, puis une partie interne (sources pardebutd'étiquette, points à relire). Une section, une diapositive : les rapports seront mis en présentation ensuite./support <mail>ne change pas. - Pourquoi : l'utilisateur, 2026-11-02 : l'agent de support produit un rapport de situation, un diagnostic fondé sur les étiquettes ; elles lui donnent tout ce qu'il faut pour comprendre ce qui ne va pas et répondre au client. Premier usage : trois stations étiquetées par l'
etiqueteur, rapports à mettre en PowerPoint. Puis : des images pour appuyer ce qui est dit, dans le rapport et la présentation, mais un résultat concis, simple, clair et précis. - Options écartées : remplacer le mode mail (validé sur LENZSPITZE) ; un sous-agent à part (le rapport se relit et se corrige dans la conversation, comme le mail) ; relire les données pour refaire ou vérifier le diagnostic (c'est le travail de l'étiqueteur et de la relecture de l'utilisateur) ; plusieurs figures par constat (concision).
- Conséquence : la qualité du rapport est celle des étiquettes ; une étiquette sans famille est rangée par l'agent et signalée « à relire ».
D-114 — 2026-11-03 — /presentation : le rapport de situation en diapositives, par la fabrique Typst AIMsight
- Statut : active, à essayer ; complète D-113.
- Décision :
/presentation <STATION>(.claude/skills/presentation/) met le rapport de situation (support/<dossier>/rapport.md, partie client seulement) en présentation PDF 16:9 à la charte AIMsight, avec la fabrique Typst~/docfactory-presentation(charte 1.1.0 figée, polices, gabarits, contrôle des budgets de texte et des débordements), en français. Structure fixée par l'utilisateur (2026-11-03) : titre et période seulement ; un résumé chronologique qui numérote les événements ; une diapositive par événement, qui se suffit (le cas, son diagnostic, l'image de la cause quand elle se voit) ; une conclusion à puces (ce qui rend les mesures moins fiables), sans aucune instruction au client ; la page de clôture. Pas de page « En bref » ; les faits seulement, jamais une consigne (« à ignorer ») ni une affirmation sur l'ouvrage ; des légendes qui se lisent seules. Le PDF va dans le dossier du rapport,presentation.pdf. Les rapports se font par mois. - Pourquoi : l'utilisateur, 2026-11-03 : utiliser les ressources de présentation d'AIMsight pour les trois rapports de situation (BREITHORN, MICHIGAN, NEBRASKA) ; ce sont des rapports sur tout le mois d'octobre ; un skill pour les prochaines présentations, qui garde les leçons de cette première série.
- Options écartées : un .pptx (skill
document-skills:pptx) : hors charte, la fabrique donne déjà la charte et les contrôles ; copier la charte dans ce dépôt (elle se met à jour dans la fabrique) ; générermain.typpar script depuis le Markdown (trois présentations seulement, le résumé demande un jugement) ; la mise en page « figure à gauche, texte à droite » du gabarit (les puces s'y chevauchent). - Conséquence : il faut Typst (≥ 0.14, dans
~/.local/bin) et la fabrique sur le poste ; le source estsupport/<dossier>/presentation.typ, versionné ici, compilé par.claude/skills/presentation/compiler.shqui le copie avec les images du dossier dans la fabrique (elle n'est pas un dépôt git) ; chaque diapositive porte « PROJET unversioned » tant qu'il n'y a pas de dépôt.
D-115 — 2026-11-03 — L'analyste lit les données comme l'étiqueteur
- Statut : active ; complète D-106 et D-112.
- Décision : l'analyste (
analyser-lot, et ses consignes de/labels-learner) lit les données comme l'etiqueteur, qui est plus récent : mêmes outils (lire-les-donnees, ses scripts, les CSV bruts, la température demetrics/), même documentation (labeling/carte-des-etiquettes.mden entier,labeling/familles.md,labeling/connaissances/chaine-de-mesure.md, en plus de la carte des événements et de la base d'events), sans les étiquettes de l'expert ni celles de l'étiqueteur. Son rendu ne change pas :etiquettes.json, aux catégories du journal et aux bornes « première et dernière mesure touchées », contrôlé paretiquettes.py.analyser-lotne se dit plus « la vérité de la boucle » (D-112). - Pourquoi : l'utilisateur, 2026-11-03 : les deux agents doivent avoir les mêmes outils et lire les données aussi bien l'un que l'autre ; l'analyste ne lisait ni la carte des étiquettes ni la chaîne de mesure, donc il connaissait moins bien les phénomènes de l'expert et leurs faux amis.
- Options écartées : mesurer d'abord l'écart en lançant les deux agents sur un même lot (inutile selon l'utilisateur) ; aligner aussi le rendu sur les familles et les bornes de l'étiqueteur (casserait le benchmark des détecteurs, qui compare mesure par mesure aux catégories du journal) ; retirer à l'analyste la sortie des détecteurs (
/new-eventla lui interdit déjà). - Conséquence :
analyser-lot(introduction, sources, outils, étape 1) et.claude/skills/labels-learner/analyste.md(sources, outils, étape 2) sont réécrits.
D-116 — 2026-11-03 — /detector-learner : les détecteurs sur les seules étiquettes, sans base d'events
- Statut : active, à essayer ; seule boucle des détecteurs depuis D-118.
- Décision : un skill lancé par l'utilisateur,
/detector-learner data/<STATION> [--du --au](.claude/skills/detector-learner/SKILL.md), qui améliore les détecteurs sur les étiquettes delabeling/auto/déjà produites par l'etiqueteur: sans analyste (le diagnostic est fait) ni base d'events. Sans dates, la plage est celle des étiquettes de la station. Même boucle que D-112 (score,detectors-critic,detectors-upgrader,detectors-controlen trois passages au plus, bilan, releveur, commits surmaster), mais le garde-fou du contrôle est une non-régression à la place du benchmark :regression.py --sauf <STATION>, le score par famille sur chaque autre station delabeling/auto/, sur la plage de ses étiquettes ; une famille qui recule sur une station est un recul. Rendus dansdetector-learner/<séance>_<STATION>/. - Pourquoi : l'utilisateur, 2026-11-03 : laisser les events de côté et se concentrer sur les étiquettes ; un nouveau skill qui orchestre les agents des détecteurs, sans analyste puisque les diagnostics existent.
- Options écartées : supprimer le contrôle (rien n'empêcherait l'upgrader de coller au lot) ; de nouveaux agents (les trois agents des détecteurs servent aux deux skills, leurs consignes disent quoi lire selon le garde-fou que nomme la demande).
- Complément (l'utilisateur, 2026-11-03) :
--amelioreraussi, comme D-071 ; l'ameliorateurcouvre les deux processus, son périmètre pour/detector-learner: son skill, les agents de la boucle, sa section derun.md. - Conséquence : la non-régression lit des plages que l'étiqueteur n'a peut-être pas toutes lues en entier (réserve de D-112) : un trou de lecture y compte comme « rien à signaler ». Les 7 étiquettes sans famille de JUNGFRAU y pèsent sur « justes » ; constantes d'avant en après, elles ne faussent pas la comparaison. La page de fin de séance reprend
comparaison.pyde/events-learner, benchmark des events en annexe, pour information.
D-117 — 2026-11-03 — Le mouvement thermique s'étiquette toujours
- Statut : active, à l'essai ; précise D-111 (ce que la caméra compense ne s'étiquetait pas).
- Décision : le mouvement qui suit la température (l'ouvrage, la caméra et son support) s'étiquette toujours, en
deplacement_thermique, même quand la caméra le compense et que les courbes corrigées ne le montrent pas ; seul un saut de la caméra bien compensé reste hors des étiquettes.labeling/familles.mdet l'etiqueteursuivent. Le score de/detector-learnerne range toujours un saut bref que dansobstruction,visibiliteoudeplacement(score.py) : à ne pas corriger. - Pourquoi : l'utilisateur, 2026-11-03, après la séance
/detector-learnerNEBRASKA :familles.mdexcluait « la pose qui suit la chaleur » alors que l'étiqueteur l'étiquetait (316 des 332 instantsdeplacement_thermiqueà NORDEND, « Camera thermal ») ; il faut étiqueter les mouvements thermiques. - Options écartées : retirer ces étiquettes et les épisodes « Camera thermal » des détecteurs (NORDEND et JUNGFRAU auraient reculé).
- Conséquence : les étiquettes thermiques déjà écrites restent ; les détecteurs gardent « Camera thermal ».
D-118 — 2026-11-03 — Les détecteurs alignés sur toutes les étiquettes de labeling/auto/, sans events
- Statut : active ; remplace D-112 ; précise D-116.
- Décision : il ne reste que les détecteurs et les étiquettes de
labeling/auto/. Le but des agents des détecteurs (detectors-critic,detectors-upgrader,detectors-control) : aligner les détecteurs le mieux possible sur l'ensemble de ces étiquettes, toutes stations comprises. LeTotalderegression.pyest ce que l'upgrader fait monter ; une famille qui recule sur une autre station reste un recul. Leurs consignes ne parlent plus de la base d'events, debenchmark.py, d'E-004 ni de/events-learner. - Pourquoi : l'utilisateur, 2026-11-03, pendant la séance
/detector-learnerBREITHORN :detectors/n'est pas aligné sur les étiquettes et les familles, et les agents se calent sur des informations obsolètes (dontcategories.py) ; « il faut retirer tout ce qui concerne les events » ; « l'objectif est d'aligner nos détecteurs le mieux possible sur l'ensemble des étiquettes auto ». - Options écartées : garder dans chaque agent un paragraphe « Avec /events-learner » (proposition de l'améliorateur) : deux vérités dans les mêmes consignes, que l'utilisateur ne veut plus.
- Conséquence :
/events-learnerne peut plus tourner avec ces agents. Restent liés aux events, à décider avec l'utilisateur :score.pyetcomparaison.py, rangés dans.claude/skills/events-learner/(comparaison.pygarde l'annexe du benchmark des events) ;regression.py, qui prend la version des détecteurs dansbenchmark.py; les docstrings dedetectors/qui renvoient àevents/INDEX.md; la baseevents/et les skillsevents-learner,review-event,new-event,read-event.
D-119 — 2026-11-03 — Un détecteur par famille, des clés égales aux noms
- Statut : active ; remplace les catégories du journal de D-074 et la correspondance de
labeling/familles.md(D-109). - Décision : la clé d'une famille est son nom :
Visibility,Obstruction,Thermal displacement,Displacement,Target issue,No data(Nonepour l'expert : courbes intactes). Les étiquettes delabeling/auto/sont passées aux nouvelles clés.detectors/a un détecteur par famille :visibility.py(perte de visibilité et turbulence),obstruction.py(passages et cibles cachées, par les calculs devisibility.pyet detarget_issue.py),target_issue.py(cible dégradée, collée, qui bascule),thermal_displacement.py,no_data.py,displacement.py(sauts et dérive lente). Lekindd'un épisode est sa famille, la catégorie de son événement ; sonlabelen dit la sorte.categories.pygarde ses règles : un saut revenu absorbé par sa cause, sinon Displacement ; même sorte à moins d'une heure, un seul événement ; les phrases du journal. - Pourquoi : l'utilisateur, 2026-11-03 : « dans familles.md je veux que les clés soient identiques aux noms. Et je veux un détecteur par famille » ; pour les catégories du journal, les familles seules, la sorte restant comme label.
- Options écartées : garder les catégories du journal en sous-catégories (une correspondance de plus à tenir) ; un module de calcul commun sans
detect(un fichier de plus) :obstruction.pyrefait les calculs devisibility.pyet detarget_issue.py, sans coût sensible (8 s pour les six stations étiquetées). - Conséquence : sur les six stations étiquetées, les mêmes événements (début, fin, famille) et le même benchmark, ligne pour ligne. Les pages Status, Compare, la page des détecteurs et la maquette Explore lisent les familles ; un passage ne grise plus toute la scène dans l'Explore, seulement la courbe des cibles cachées (comme une cible à problème). Restent sur les anciennes catégories, liés aux events :
score.pyen mode lots,benchmark.py,analyser-lot/etiquettes.py, lesetiquettes.jsondes events et des séances passées ;detectors-view/hierarchie-des-status.md(D-095) les nomme encore.
D-120 — 2026-11-03 — /detector-learner : une station, une mesure, un critique sans limite de suggestions
- Statut : active ; complète D-116 et D-118.
- Décision : une séance porte sur toutes les étiquettes de la station, sans
--duni--auni lot. Une seule mesure, le benchmark (regression.pysur toutes les étiquettes delabeling/auto/) : son bloc de la station est le score de la séance, ses autres blocs la non-régression, avec leTotal;--saufet le score à part sont retirés.score.pyetcomparaison.pypassent de.claude/skills/events-learner/à.claude/skills/detector-learner/, avecversion()(debenchmark.py) ; la page de fin perd l'annexe de la base d'events.historique.csvpasse aux clés de D-119. Ledetectors-criticfait autant de suggestions qu'il en juge utiles, rangées par importance, chacune réaliste : faisable par une règle générale sur les seules mesures dedetect(mesures), sans faire reculer les autres stations, avec son risque ; ledetectors-upgraderles prend une à une et met les autres dans « Pas corrigé ». Au score, un saut revenu resté seul compte en Displacement, comme le ditfamilles.md, et non plus dans la famille de l'étiquette qui le couvre (la pseudo-famillesaut_brefdisparaît). - Pourquoi : l'utilisateur, 2026-11-03, en validant le processus étape par étape : « le critique peut faire autant de suggestions qu'il le souhaite. Il doit cependant être au courant qu'un autre agent va essayer de modifier les détecteurs. Par conséquent les critiques doivent être réalistes et bien réfléchies » ; d'accord pour une seule mesure, l'historique aux nouvelles clés et les scripts dans
detector-learner/. À BREITHORN, les deux suggestions demandaient la température, que les détecteurs ne reçoivent pas : un passage perdu. - Options écartées : garder
--du/--auavec un score de lot à part (une mesure de plus, pour un usage jamais servi) ; repartir d'un historique vide (les anciennes lignes restent comparables, seules les clés changent). - Conséquence :
/events-learnerne tourne plus (D-118) ; sonbenchmark.pylitscore.pyà sa nouvelle place. Le mode lots descore.py(events) reste, à retirer avec le reste des events.
D-121 — 2026-11-03 — /detector-learner : un commit par suggestion, un recul chiffré
- Statut : active ; complète D-116 et D-120.
- Décision : le
detectors-upgradercommite lui-même chaque suggestion gardée (Detector-learner <STATION>: modification K, S<n>), avec le benchmark qui la suit (benchmark-K-S<n>.txt). Ledetectors-controlpeut rendre le verdictretirer, à tout passage, avec la ligne**Retirer** : S<n>, …: l'orchestrateur annule les commits de ces suggestions pargit revert(un conflit : tout annuler). Un recul, sur une famille d'une autre station : ses instants trouvés baissent de plus de 2, ou « trouvées » ou « justes » perd plus d'1 point ; la même règle pour l'upgrader et le contrôle. - Pourquoi : l'utilisateur, 2026-11-03, en validant l'étape du contrôle : appliquer les trois propositions. Le critique fait désormais autant de suggestions qu'il veut (D-120) ; tout annuler au passage 3 pour une seule mauvaise emportait les bonnes. « Quelques instants aux bornes » laissait le contrôle deviner.
- Options écartées : l'orchestrateur découpe la modification par suggestion (deux suggestions sur un même fichier ne se séparent pas après coup) ; le contrôle relance le benchmark à chaque commit (les benchmarks de l'upgrader le disent déjà).
- Conséquence : la règle « sans famille ne compte pas » du contrôle est retirée : toutes les étiquettes ont leur famille.
D-122 — 2026-11-03 — /detector-learner : ce qui revient à l'utilisateur, à part dans le bilan
- Statut : active ; complète D-116 et D-121.
- Décision : le bilan a une section
## À trancher par l'utilisateur, copiée telle quelle des rendus : les « Limites » de la critique (ce que les détecteurs ne peuvent pas voir avec les seules mesures) et les « À trancher par l'utilisateur » des modifications (étiquettes qui se contredisent d'une station à l'autre). Le releveur et l'améliorateur ne servent plus que/detector-learner; l'améliorateur ne touche plus à/events-learner. - Pourquoi : l'utilisateur, 2026-11-03, en validant la fin de séance : appliquer les deux propositions. Ce qui l'attendait se perdait parmi les suggestions non traitées ;
/events-learnerne tourne plus (D-118), la précaution de ne pas le casser freinait l'améliorateur pour rien. - Options écartées : laisser l'orchestrateur trier lui-même ce qui revient à l'utilisateur (il ne juge rien, D-116).
- Conséquence : le critique a une partie « 6. Limites », l'upgrader une partie « À trancher par l'utilisateur ».
D-123 — 2026-11-03 — /detector-learner : bornes exclues, faux positifs comptés, la station de la séance gardée
- Statut : active ; complète D-111, D-116 et D-121.
- Décision : (1) le score (
score.py) ne compte plus les bornes d'une étiquette, la mesure saine d'avant et celle d'après (D-111), sauf pour un trou, qui n'a pas de mesure entre elles ; (2) un recul, sur une famille d'une station, c'est aussi des instants signalés à tort (signalés, moins ceux qu'une étiquette range dans la famille) qui montent de plus de 2 ; (3) le contrôle juge aussi la station de la séance, sur ses seuls instants signalés à tort ; il n'en voit toujours ni les données, ni la critique, ni le reste du rendu. - Pourquoi : l'évaluation de la séance MICHIGAN, validée par l'utilisateur le même jour : la séance BREITHORN avait refusé la règle de cadence de la dérive lente, parce qu'elle faisait reculer MICHIGAN ; la séance MICHIGAN l'a gardée, avec 150 instants Displacement signalés à tort sur MICHIGAN, que personne ne jugeait : le garde-fou dépendait de la station choisie. La règle en points ne voyait pas de faux positifs sur une famille déjà à 0 % de justes (0/1 → 9/159 est une hausse). Les bornes comptées faisaient d'un pic d'une mesure, à une mesure toutes les 4 h, trois instants étiquetés dont deux sains.
- Options écartées : laisser le contrôle juger la station de la séance en entier (il deviendrait un second upgrader, collé à elle) ; un seuil de faux positifs en part plutôt qu'en nombre (même défaut à 0 %).
- Conséquence : les benchmarks de
detector-learner/historique.csvd'avant ce changement ne se comparent plus directement aux suivants (étiquetés en baisse, environ 3 % au total) ; les étiquettes faites avant D-111 (JUNGFRAU, WILDSTRUBEL : de la première à la dernière mesure touchée) perdent leurs deux bornes au score. L'auto-test descore.py, cassé depuis le passage aux familles, ne vérifie plus que les bornes.
D-124 — 2026-11-03 — Les détecteurs reçoivent la température de la station
- Statut : active, à l'essai ; complète D-119 (le contrat
detect(mesures)) et D-117. - Décision : un détecteur qui la déclare (
detect(mesures, temperature)) reçoit la température de la station,[(t, °C)], la médiane à chaque heure des températures de la carte (metrics/,sensor_*_deg_c), lue pardonnees.charger_temperature;categories.evenementspasse à chaque détecteur ce que sa fonction déclare (fin,temperature), et le score, les pages des détecteurs et la page Explore la lui donnent. Aucune règle ne s'en sert encore : c'est aux séances de/detector-learnerde l'utiliser, sous le contrôle. Le critique ne range plus dans ses « Limites » ce que seule la température révèle. - Pourquoi : l'évaluation de la séance MICHIGAN, choix de l'utilisateur le même jour : la frontière entre Thermal displacement et Displacement se fait par la température (
labeling/familles.md), que l'étiqueteur lit et que les détecteurs ne recevaient pas ; 9 étiquettes sur 13 de MICHIGAN tiennent leur famille de la température, et les séances ajoutaient des approximations (cycle de 24 h, glissade de la caméra,ECARTréglé entre deux stations qui se contredisent). La température est une métrique de la station : le calcul reste embarquable. - Options écartées : faire dire à l'étiqueteur d'où vient la famille (signe visible ou température seule) et ne plus scorer les secondes : contourne le plafond sans le lever ; ne rien changer ; une température par composant (le GPU qui calcule fait des pointes ; la médiane suit ce que lit l'étiqueteur, « les températures de tous les composants ») ; écrire tout de suite une règle thermique hors séance (elle échapperait au contrôle).
- Conséquence : benchmark inchangé tant qu'aucun détecteur ne déclare
temperature; une station sans ces métriques (les cas devues-deplacements/cas/) reçoit une liste vide.categories.pyetcapteurs.pyacceptent aussi--du/--auau format ISO deregression.plage().
D-125 — 2026-11-03 — Le pompage sans --du comble les jours manquants
- Statut : active. Complète D-096.
- Décision :
pomper.pylancé sans--dupompe d'abord, pour chaque station, les jours sans fichier de déplacements entre le premier et le dernier jour pompés (fichiers existants laissés tels quels, comme avec--du), puis repart comme avant de son dernier jour pompé, repompé, jusqu'à maintenant. - Pourquoi : LENZSPITZE n'avait aucun fichier les 24 et 25/10 : pompée en deux plages avec
--du(jusqu'au 23, puis à partir du 26), le mode suivi ne revenait jamais en arrière ; l'utilisateur ne s'expliquait pas le trou. Un jour en échec (délai dépassé), qui n'écrit pas de fichier, est ainsi repris au lancement suivant. - Options écartées : repartir du premier trou en remplaçant tout (repompe des jours complets) ; laisser la commande avec
--du(le trou passe inaperçu). - Conséquence : un jour manquant que la base ne rend pas est redemandé à chaque lancement, une requête par jour. Les trous à l'intérieur d'un fichier (panne commune de la plateforme du 15/10 23:00 au 16/10 ~10:00 UTC, stations éteintes) ne sont pas concernés : la base n'a pas ces données.
D-126 — 2026-11-03 — Le dossier de l'étiqueteur dans labeling/auto/etiqueteur/, analyse et scripts versionnés
- Statut : active. Remplace, dans D-106, le dossier de sortie
out/etiqueteur/hors de git. - Décision : le dossier de sortie de l'
etiqueteurestlabeling/auto/etiqueteur/<STATION>_<début du lot>/(déplacé là par l'utilisateur, avec les lots déjà faits). Son analyse (analyse.md) et ses scripts (outils/*.py) sont versionnés ; ses figures et les sorties de ses outils restent hors de git (.gitignore). Les chemins écrits dans les scripts et analyses déplacés sont réécrits. - Pourquoi : l'utilisateur, 2026-11-03 : les scripts que l'étiqueteur écrit pour lire les données lui restaient invisibles (hors de git, non recensés). Les garder à côté des étiquettes les rend lisibles et relançables.
- Options écartées : tout versionner (181 Mo, 376 PNG pour 19 lots, et ça grandit à chaque lot) ; rien versionner (le dossier reste local, comme
out/). - Conséquence :
push.shcommite les analyses et les scripts de chaque lot, quelques dizaines de Ko. Une section « Outils » de l'analyse, qui recenserait les scripts, n'est pas ajoutée sans demande.
D-127 — 2026-11-03 — Les présentations s'adressent au client : elles vendent le système, en corr_y
- Statut : active. Complète D-114 (structure de la présentation).
- Décision : la présentation d'un rapport de situation (
/presentation) est faite pour le client. Elle ne critique pas notre système (pas de « mal compensé », « la redondance est perdue », « moins fiables ») : elle dit le fait et sa cause extérieure. Elle montre les tassements, le déplacement verticalcorr_y, et chiffre sa stabilité ;corr_xseulement pour un phénomène qui ne se voit qu'en horizontal (la parallaxe de BREITHORN, gardée sur demande de l'utilisateur). Pas de diapositive sur un trou de données. La conclusion dit ce qui reste stable et la cause de chaque variation. Le tampon de la charte devient « Sandouville » ; le source et le PDF portent le nom de la station (breithorn.typ,breithorn.pdf). - Pourquoi : l'utilisateur, 2026-11-03 : « Ces présentations sont ciblées à des clients. Il ne faut pas nous incriminer. On ne critique pas notre propre système, on le vend » ; « ce sont les tassements qui intéressent le client ».
- Options écartées : retirer la parallaxe de BREITHORN, visible surtout en
corr_x(essayé, l'utilisateur l'a fait remettre) ; garder les nuits sans mesures ; modifierbrand/pour le tampon (la charte ne se modifie pas : une règle#showdans le source suffit). - Conséquence : le rapport (
rapport.md) garde tout, y compris la partie interne ; la présentation en est une sélection orientée client. Figures encorr_ypar.claude/skills/presentation/figure-y.py.
D-128 — 2026-11-04 — /review-auto-labels : l'analyste relit les étiquettes de l'étiqueteur, l'expert tranche
- Statut : active. Complète D-105, D-106 et D-118 ; point 73 du plan du journal du matin.
- Décision :
/review-auto-labels <STATION> <début> <fin>, sur une plage choisie par l'utilisateur. L'agentanalyste, avec les consignes.claude/skills/review-auto-labels/analyste.md, juge chaque étiquette delabeling/auto/face aux données (bornes, un seul événement, famille, description, oubliées) et écritlabeling/auto/revue/<STATION>_<début>/revue.mdetetiquettes-proposees.jsonl, sans toucher aux étiquettes. L'orchestrateur pose ses questions à l'expert, ajuste les propositions à ses réponses, puis, sur son accord, remplace les étiquettes de la plage. Ses réponses sont dites dans la description (« d'après l'expert ») ; toutes les étiquettes de la plage portentrevue, la date de la revue, comme les étiquettes manuelles revues (D-103), et/labels-maplit aussi ces lignes delabeling/auto/. - Pourquoi : les étiquettes de l'étiqueteur sont la vérité des détecteurs (D-118) : leurs défauts passent dans tout ce qui en apprend. Premier essai, BREITHORN d'octobre : 26 étiquettes, 10 à corriger, 1 oubliée, et une indication de l'expert (pas d'effet thermique) que les données contredisaient ; il a tranché : les écarts de la caméra des nuits froides sont thermiques, la température du boîtier compte, pas celle de l'air.
- Options écartées : une revue par mois fixe (la plage est celle de l'utilisateur) ; un relecteur qui corrige lui-même (l'expert décide) ; écrire la réponse de l'expert dans la carte seule (la carte est dérivée des étiquettes,
/labels-mapl'effacerait) ; un relecteur qui relit toute la plage pour lui-même avant les étiquettes (l'expert, 2026-11-04 : il part des étiquettes et de l'analyse de l'étiqueteur pour les améliorer, il ne refait pas l'étiquetage ; les oubliées se cherchent entre les étiquettes). - Conséquence : du dossier de revue, seuls
revue.mdetetiquettes-proposees.jsonlsont versionnés, les figures non. Les leçons pour l'étiqueteur sont proposées à l'utilisateur, pas appliquées d'office.
D-129 — 2026-11-04 — Les métriques de qualité d'image entrent dans l'étiquetage : outil qualite.py, LENZSPITZE relue
- Statut : active. Complète D-106 (étiqueteur) et D-128 (revue des étiquettes automatiques) ; point 76 du plan du journal du matin.
- Décision : les six métriques de qualité de l'export « advanced » des caméras récentes (
peak,flux,sharpness,fwhm,dominance,snr) sont définies danslabeling/connaissances/metriques-de-qualite.md(source :~/optical_emulator/docs/cuda_phase_correlation.md, §14), chargées pardonnees.charger, lues paragent-tools/qualite.py(rapport à une référence calme par capteur et par heure UTC ;--etiquettes,--hors,--figure), signalées parinventaire.py, tracées pargraphique.py, proposées dans le menu delabeling.py; le skilllire-les-donneeset la consigne de l'etiqueteurdisent de s'en servir quand elles sont remplies. Les 63 étiquettes d'octobre de LENZSPITZE, déjà revues sans elles, sont relues avec elles par l'analyste (labeling/auto/revue/LENZSPITZE_2026-10-01_qualite/) et remplacées par 67 étiquettes. - Pourquoi : l'utilisateur, 2026-11-04 : aucun outil ne lisait ces métriques, les étiquettes ont été faites sans elles. La revue le confirme : le flux prouve une occultation et nomme les cibles cachées (dont deux restées sous leur seuil, leur point faux), sépare la turbulence (netteté, snr, dominance) de la perte de lumière, et trouve 4 événements oubliés, sans rejet.
- Options écartées : une alerte de changement de régime dans l'outil (un seuil dans ce que rend un outil ; le skill dit de comparer chaque côté du changement) ; repartir de l'étiquetage (la revue part des étiquettes, D-128).
- Conséquence : seules LENZSPITZE et NADELHORN ont ces métriques aujourd'hui ; pour les anciennes caméras,
quality/de~/optical_emulatorn'est pas encore lu parqualite.py. L'expert n'a pu trancher aucune des cinq questions (images aux heures pleines seulement) : les choix par défaut de l'analyste sont gardés. Les signatures par famille et le contexte de LENZSPITZE attendent/labels-map.
D-130 — 2026-11-05 — Les étiquettes automatiques relues par station puis croisées, sans validation de l'expert ; toute la connaissance du labeling dans labeling/
- Statut : active. Complète D-128 (la revue par station : l'analyste améliore les étiquettes, il ne refait pas l'étiquetage) et D-129 ; points 73 à 75 du plan du journal du matin.
- Décision :
- Toutes les étiquettes de
labeling/auto/sont relues par station (/review-auto-labels, un analyste par station), puis par une revue croisée (/cross-review-labels, nouveau skill) : un analyste par famille compare les stations entre elles, tranche les règles où les revues par station divergeaient, trouve les étiquettes d'une autre famille ; une passe de finition reprend ce qui reste (labeling/auto/revue-croisee/2026-11-04/, dontreste-a-faire.md). Les trois plages jamais étiquetées (WILDSTRUBEL 07/09 → 01/10, NORDEND 16/08 → 01/10) sont étiquetées puis relues. Les propositions des relecteurs sont appliquées sans validation de l'expert (l'utilisateur, 2026-11-04) ;revuedit la date de la relecture. - Toute la connaissance métier qui sert au labeling est dans
labeling/:regles-d-etiquetage.md(nouveau : comment poser une étiquette, la seule source de ces règles),familles.md(les frontières tranchées),connaissances/(nouveau : chaîne de mesure, colonnes des déplacements, trous, images de la caméra, cycle thermique, métriques de qualité, cas annotés, incident de Barcelone, déplacés dedocs/), la carte des étiquettes (refaite sur les étiquettes revues, les events et les cas). L'etiqueteur et les relecteurs ne lisent plus rien d'autre ; ce qu'un event apprend entre dans la carte,events/reste l'archive des events et de leurs données. labeling/controle.pycontrôle les étiquettes automatiques face aux règles (champs, familles, bornes, doublons, valeurs chiffrées, heures locales), surlabeling/auto/ou sur un fichier proposé ; l'etiqueteur et les relecteurs le lancent avant de rendre.labeling/auto/ne contient que des étiquettes relues : l'etiqueteur écrit dans son dossier (labeling/auto/etiqueteur/<STATION>_<début>/etiquettes.jsonl),/review-auto-labelsles verse après revue ; les relecteurs mettent leurs mesures dans leurrevue.md, jamais dans les étiquettes.
- Toutes les étiquettes de
- Pourquoi : l'utilisateur, 2026-11-04 : relire sur le même lot que l'étiqueteur n'apporte pas forcément ; changer la granularité, comparer les stations entre elles ; à la fin, toutes les étiquettes « auto » validées et justes, toute leur connaissance documentée, et dans
labeling/. Constat : les revues par station retrouvaient les mêmes défauts une à une (bornes posées sur la mesure touchée ou coupées à minuit, textes recopiés d'un jour à l'autre, mouvement thermique compensé non étiqueté, trous communs non dits communs) ; la revue croisée les a tranchés une fois pour toutes (209 étiquettes modifiées, 17 retirées, 28 ajoutées), la finition a réécrit jour par jour les textes thermiques recopiés. - Options écartées : une revue croisée par phénomène, avec un tri préalable de toutes les étiquettes (plus juste sur les familles mal rangées, mais un tri de plus ; chaque analyste de famille cherche ses phénomènes dans les autres familles par l'index) ; refaire l'étiquetage (le travail de l'étiqueteur a de la valeur) ; laisser la connaissance dans
docs/etevents/(l'utilisateur la veut danslabeling/). - Conséquence : 991 étiquettes automatiques sur 11 stations, toutes revues. Les relecteurs avaient mis leurs mesures dans les descriptions : réécrites en mots (D-103), les mesures restent dans les
revue.md. Une autre session a relu LENZSPITZE avec les métriques de qualité pendant ce travail (D-129) ; ses changements sont gardés. Les events sont rattachés à leurs stations ; les données ont montré que PS_DES_COUDRES est JUNGFRAU (les données codées de E-001 sont celles dedata/JUNGFRAU/, valeur pour valeur). Les contradictions entre l'expert et les étiquettes automatiques ont été vérifiées sur les données : là où elles donnaient raison à l'expert, les étiquettes sont corrigées (NORDEND, les références restantes à zéro) ; les autres sont dans la carte (section 6), à trancher par lui. Les causes non établies gardent leur nuance (« sans doute », « probable ») ; seule une conclusion qui rassure sans cause établie est interdite (l'utilisateur, 2026-11-05). Les étiquettes de l'expert restent danslabeling/manual/, telles quelles, PS_DES_COUDRES comprise ; ce qu'elles savent passe dans les étiquettes automatiques là où il y avait conflit, compilé au plus près des données (l'utilisateur, 2026-11-05 : 12 étiquettes, JUNGFRAU, NORDEND, LENZSPITZE, WILDSTRUBEL).
D-131 — 2026-11-05 — Un id stable par étiquette automatique ; un sommaire en tête de la carte
- Statut : active. Complète D-130.
- Décision :
- Chaque étiquette de
labeling/auto/porte un champid, en tête de la ligne (l'utilisateur, 2026-11-05),<STATION>-<n>, donné une fois parlabeling/ids.py(les étiquettes qui n'en ont pas reçoivent le suivant de leur station), gardé quand on la modifie (labeling.py, les revues).labeling.pyen donne un à une étiquette ajoutée dansauto/;/review-auto-labelset/cross-review-labelsle donnent aux étiquettes versées ;labeling/controle.pyl'exige, unique. La revue croisée repère les étiquettes par lui, plus par leur numéro de ligne ; une revue ne s'applique qu'une fois (applique.md). - La carte des étiquettes commence par un sommaire (
.claude/skills/labels-map/sommaire.py) : une ligne par fiche, sa première phrase et sa ligne dans le fichier. L'etiqueteur, l'analyste et les relecteurs lisent le sommaire et les sections 2 à 4 en entier, puis seulement les fiches des phénomènes qu'ils rencontrent.
- Chaque étiquette de
- Pourquoi : proposé par Claude au bilan de D-130, accepté par l'utilisateur (2026-11-05). Les numéros de ligne changeaient à chaque écriture : une autre session a écrit dans LENZSPITZE pendant la revue croisée, et deux numérotations divergeaient. La carte refaite fait 552 lignes (115 Ko), lue en entier à chaque lot.
- Options écartées : un id sur les étiquettes de l'expert (
labeling/manual/, sa cléSTATION JJ.MM HH:MMsuffit à la carte) ; un compteur par station (le suivant du plus grand id suffit tant qu'on ne retire pas la dernière étiquette) ; couper la carte en plusieurs fichiers (le sommaire suffit). - Conséquence : les 991 étiquettes ont leur id, en tête ;
controle.pyexige qu'il y soit ; un id retiré ne se redonne pas dans la même opération. Corrigé au passage :appliquer.pyde la revue croisée faisait perdre son id à une étiquette modifiée, et dataitrevuedu 2026-11-04 ; le benchmark des détecteurs et les pages qui lisentlabeling/auto/ignorent ce champ.
D-132 — 2026-11-05 — /detector-learner par famille, sur toutes les stations, lancé par Claude
- Statut : active. Modifie D-116 (le découpage par station) et D-123 (la station de la séance).
- Décision :
- Une séance de
/detector-learnertravaille une famille delabeling/familles.md(/detector-learner <FAMILLE> [--ameliorer]), sur toutes les stations delabeling/auto/à la fois. Le critique range les stations par erreurs de la famille dans le benchmark (instants manqués plus signalés à tort), examine les quatre premières, plus une station à cadence lâche dont une étiquette de la famille est entièrement manquée ; ses suggestions disent les stations où le défaut revient. L'upgrader vérifie le journal sur les stations de chaque suggestion ; le contrôle juge toutes les stations et toutes les familles du benchmark, la règle du recul inchangée, sans lire la critique. Deux stations qui rangent le même état dans deux familles vont aux « Limites », pour l'utilisateur. - Le skill n'est plus réservé à l'utilisateur : Claude le lance quand l'utilisateur le lui demande (l'utilisateur, 2026-11-05).
- Dossier de séance
detector-learner/<séance>_<Famille>/; la page de fin de séance laisse la place à la page Compare (detectors-view/compare.py).
- Une séance de
- Pourquoi : les trois séances par station du 2026-11-03 ont toutes buté sur des étiquettes contradictoires d'une station à l'autre (MICHIGAN, NEBRASKA et BREITHORN), qu'une séance sur une seule station découvre au contrôle seulement. Un détecteur par famille (D-119), et la revue croisée des étiquettes par famille (D-130) : le même découpage. Proposé par Claude, choisi par l'utilisateur.
- Options écartées : garder une séance par station (11 séances, contradictions vues trop tard) ; mettre de côté des stations que le critique et l'upgrader ne voient pas, pour le contrôle (moins de vérité pour aligner ; le contrôle garde les interdits, dont aucune règle propre à une station).
- Conséquence :
.claude/skills/detector-learner/SKILL.mdet les trois agents des détecteurs réécrits ;comparaison.pyn'est plus appelé par la séance (gardé,run.md). Ordre prévu des séances : Displacement, Obstruction, Thermal displacement, Visibility, Target issue, No data (point 77 du plan vivant).
D-133 — 2026-11-05 — Le support par l'API Claude, dans un sous-projet autonome API/
- Statut : active (prototype).
- Décision :
- Passer de l'exploration à l'opérationnel par l'API Claude (crédits API de l'utilisateur, traces LangSmith), en commençant par le support au client : une page locale
support(API/support/serveur.py, port 8770) où Marc colle le mail d'un client et son contexte ; deux clients de l'API, le support (pilote la séance, parle à Marc, fait la présentation) et l'analyste (le diagnostic : les détecteurs, une illustration par événement ; l'analyse approfondie sur demande de Marc seulement), vivants toute la séance ; une seule sortie, un PDF de diapositives à la charte AIMsight qui répond à la question du mail et à rien d'autre. - Tout vit dans
API/, séparé à 100 % de.claude/: prompts, savoir, outils de lecture, détecteurs, figures et charte Typst y sont copiés (API/PROVENANCE.md: source, commit, adaptation), pour qu'on puisse l'extraire tel quel vers un autre projet ; seule dépendance extérieure, les données (AIMSIGHT_DATA, défautdata/). - Messages API, boucle d'outils écrite à la main, outils définis par nous ;
claude-opus-5-5pour les deux agents.
- Passer de l'exploration à l'opérationnel par l'API Claude (crédits API de l'utilisateur, traces LangSmith), en commençant par le support au client : une page locale
- Pourquoi : le diagnostic existe déjà (détecteurs, analyste) ; il reste à en faire une réponse au client, ce qui prend du temps à Marc, qui bascule vers la relation client. L'étiquetage, lui, a déjà ses agents et sa base de connaissance : pas de client API pour lui à ce stade (l'utilisateur, 2026-11-05).
- Options écartées : l'Agent SDK (c'est Claude Code empaqueté : la frontière avec
.claude/deviendrait floue, et nos outils disent exactement ce que chaque agent peut faire) ; Managed Agents (les données et la fabrique Typst sont sur le poste) ; un rapport de situation complet, du HTML avec GIF, des boutons d'action, la saisie vocale, la connexion aux boîtes mail (plus tard, peut-être). - Premier cas réel (2026-11-05, workflow validé par l'utilisateur) : Crissier (LENZSPITZE), point de situation du 16 au 31.10 pour une visio, v4 pour 2,25 $. Retenu en cours de route : la clarté d'abord (une diapositive se comprend sans lire la figure, événements nommés et regroupés par famille, l'image de la caméra d'abord avec le nom des cibles, courbes de deux ou trois cibles) ; « turbulences atmosphériques », jamais « air chaud » ; le site au nom du client ; un trou dans les données du poste n'est pas un arrêt de la station.
- Conséquence : design
API/docs/2026-11-05-support-api-design.md, planAPI/docs/2026-11-05-support-api-plan.md. Préalable : les détecteurs lisent le mouvement de la caméra et les métriques de la station (point 78 du plan vivant). Les copies vieillissent : on les rafraîchit à la main.
D-134 — 2026-11-05 — Les détecteurs lisent la pose de la caméra et les métriques de la station
- Statut : active. Complète D-124.
- Décision : un détecteur reçoit, en plus des mesures, ce que sa fonction
detectdéclare (categories.CONTEXTE), lu une fois par dossier de station :temperature(D-124) ;camera, la pose de la caméra (camera/: pan, tilt, rotation, scale, sigma0,donnees.charger_camera) ;metriques, toutes les métriques numériques demetrics/par leur nom (donnees.charger_metriques: températures des composants, dont CPU et GPU, énergie, liaison, stockage), sans les métriques texte ni les identifiants (SIM_CCID,ip*). L'erreur de reprojection (reproj_err,sigma0) et les métriques de qualité d'image (peakàsnr) sont déjà dans les mesures de chaque capteur.categories.evenementsprend le dossier de station au lieu de la température ; les agents des détecteurs le savent (le critique peut suggérer une règle sur la pose ou une métrique). - Pourquoi : l'utilisateur (2026-11-05) : les détecteurs doivent regarder les mouvements de la caméra et s'appuyer sur une multitude de données, la température (CPU ou GPU), l'erreur de reprojection et les métriques de qualité. Les dérives de NEBRASKA, MICHIGAN et BREITHORN suivent la pose de la caméra (rapports du support du 2026-11-02) ; les détecteurs n'en voyaient que la courbe. Point 78 du plan vivant ; préalable du support par l'API (D-133).
- Options écartées : un argument par métrique (le dictionnaire suffit) ; les métriques texte (
link,mode), tant qu'aucun détecteur n'en a besoin. - Conséquence : aucun détecteur ne lit encore la pose ni les métriques : le benchmark est inchangé ; la prochaine séance
/detector-learner Displacementpeut s'en servir. Une station sanscamera/nimetrics/(SNCF01, SUSTENHORN : pas de température des composants) reçoit des listes vides. Les qualités d'image ne sont remplies que sur LENZSPITZE ;reproj_erretsigma0sur CLARIDEN, NORDEND et LENZSPITZE.
D-135 — 2026-11-05 — Les détecteurs font au mieux : une autre lecture cohérente que les étiquettes est admise
- Statut : active. Remplace la règle du recul de D-121 et D-123.
- Décision :
- Les étiquettes ont des ambiguïtés, même d'expert (la même dérive commune en Thermal displacement à JUNGFRAU, en Displacement à NEBRASKA) : les détecteurs n'ont pas à être parfaits ni sur-entraînés sur elles. Quand ils lisent un état autrement que l'étiquette, mais de façon cohérente et défendable, ce n'est ni un défaut pour le critique ni un recul pour le contrôle ; c'est dit pour l'utilisateur.
- Un recul, sur une famille d'une station : « trouvées » ou « justes » perd plus de 2 points (au lieu de 2 instants ou 1 point) ; même règle pour l'upgrader et le contrôle, la famille de la séance comprise. Une baisse qui vient d'une autre lecture cohérente (étiquettes contradictoires d'une station à l'autre, creux entre deux étiquettes d'un même phénomène, bornes) n'en est pas un ; le contrôle la met dans ses « Réserves », copiées au bilan.
- Corrigé avec : l'upgrader juge chaque suggestion face au dernier état commité et l'ensemble face au benchmark avant ; le critique range les stations en instants bruts ;
capteurs.pydonne le nombre de cibles et de références ; la plage du benchmark finit au minuit le plus proche de la dernière borne ; un dossier de travail par agent.
- Pourquoi : l'utilisateur (2026-11-05), après la séance Displacement : « si leur lecture est cohérente et une alternative qui va aussi, alors c'est bon ». La règle des 2 instants avait renvoyé une modification qui faisait passer CLARIDEN de 0 à 83 % trouvées pour 20 instants de bordure.
- Options écartées : un seuil relatif aux instants gagnés (plus compliqué, même effet) ; trancher les contradictions des étiquettes avant les séances (les ambiguïtés restent, même d'expert).
- Conséquence :
.claude/agents/detectors-*.md, le skill,regression.pyetcapteurs.py; 11 entrées dedocs/ameliorations-processus.mdtraitées. La plage de CLARIDEN finit au 2026-11-01 (au lieu du 02) : son bloc du benchmark change sans les détecteurs.
D-136 — 2026-11-05 — Les agents de l'API reçoivent les cartes, et lisent le reste à la demande
- Statut : active. Complète D-133.
- Décision : le prompt système d'un agent de
API/ne porte que le strict nécessaire : son prompt et ses cartes (pour l'analyste :familles.md, les règles de preuve, le sommaire et les sections 2 à 4 de la carte des étiquettes), puis un index des autres documents deAPI/knowledge/<agent>/, une ligne chacun avec ses sections. Le reste se lit à la demande par l'outillire_document(nom, section): un document entier, ou une seule section par son titre (une fiche de la carte des étiquettes). Le support garde tout son savoir (présentation, rédaction, modèle Typst), dont il se sert à chaque séance. Réglage :CARTESdansAPI/support/seance.py. - Pourquoi : l'analyste recevait 214 000 caractères (~55 000 jetons) à chaque appel, la carte des étiquettes surtout, pour 1,50 $ par séance ; il n'en lit qu'une petite partie par cas. Avec les cartes, 39 000 caractères ; un essai a trouvé seul la bonne fiche par le sommaire. « Il ne faut donner que le strict nécessaire aux agents » (l'utilisateur, 2026-11-05).
- Options écartées : tout dans le prompt (coût, et un savoir noyé) ; une recherche par mots-clés (le sommaire de la carte suffit à trouver la fiche).
- Conséquence : un document lu reste dans l'historique de l'agent pour la séance, payé une fois ; l'index se refait seul quand
knowledge/change.
D-137 — 2026-11-05 — La page support de l'API devient une web app : React et Python (FastAPI)
- Statut : active. Complète D-133.
- Décision : la page support de
API/est refaite en web app, aux mêmes fonctions : un front React (Vite, JavaScript) dansAPI/web/(app/web/depuis D-138), ses composants pris à la bibliothèque open source Mantine (MIT), un serveur FastAPI (API/support/serveur.py,app/serveur/depuis D-138) qui sert la page construite (API/web/dist) et l'API sous/api; les événements des agents sont poussés à la page (/api/flux, server-sent events) au lieu d'être interrogés chaque seconde. Les agents, leurs outils, les prompts et le savoir restent tels quels. Outil interne, local d'abord ; le dossier des données, celui des séances et le port se règlent par variables (AIMSIGHT_DATA,AIMSIGHT_CASES,AIMSIGHT_PORT) pour un déploiement futur. Pas de PostgreSQL, d'historique des séances, d'authentification ni de plafond de coût pour l'instant ; le pompage des données reste tel quel. - Pourquoi : la page doit pouvoir grandir (historique, boîte mail, voix) et passer un jour sur un serveur (l'utilisateur, 2026-11-05).
- Options écartées : Spring Boot (les agents et tous leurs outils sont en Python, comme l'application de référence d'AIMsight, Flask ; il aurait fallu réécrire la boucle des agents en Java et appeler chaque outil en Python de l'extérieur) ; PostgreSQL dès maintenant (il viendra avec l'historique des séances, « faisons au plus simple », l'utilisateur) ; reprendre un template d'administration (Carolina, UiFort : React 16 et Material-UI 4, trop vieux pour React 19, « on ne veut pas reprendre ses éléments », l'utilisateur) ; recoder les composants à la main (Mantine donne d'office la barre repliable, le tiroir mobile, les transitions et le mode sombre).
- Conséquence :
npm run builddansAPI/web/avant de lancer le serveur ;npm run devpour travailler sur la page (port 5173, l'API demandée au serveur Python).
D-138 — 2026-11-05 — La web app dans son dossier app/, avec les pages Images et Étiquetage
- Statut : active. Complète D-133 et D-137.
- Décision : la web app quitte
API/pour son propre dossierapp/à la racine :app/serveur/(FastAPI) etapp/web/(React, Mantine).API/redevient les agents seuls (agent, séance, outils, prompts, savoir, séances) ; la page Support les pilote. L'app gagne deux pages, refaites en React à l'identique des outils de Marc : Images (view/view.py: glisseur, zoom, noms des capteurs, flèches de déplacement sur une plage) et Étiquetage (labeling/labeling.py: deux plots alignés, barre des étiquettes, ajouter, modifier, supprimer) ; un sélecteur de station et de dates partagé, dans l'adresse (#/images?station=…&du=…&au=…) ; depuis une séance, deux boutons ouvrent ces pages sur la station du cas. Les étiquettes restent danslabeling/{auto,manual}/du dépôt, où l'app écrit (AIMSIGHT_LABELS) : une seule vérité pour les détecteurs et les agents. Conception :app/docs/2026-11-05-pages-images-etiquetage-design.md. - Pourquoi : « que tout soit centralisé dans l'app », le diagnostic manuel compris ; et l'app, devenue plus que le support par l'API, a son propre dossier (l'utilisateur, 2026-11-05).
- Options écartées : intégrer
view.pyetlabeling.pytels quels dans un cadre (deux serveurs de plus, un autre visuel, du code hors de l'app au déploiement) ; copier les étiquettes dans l'app (deux vérités). - Conséquence :
API/ne lit toujours quedata/; l'app litdata/et écrit danslabeling/auto/etlabeling/manual/. Les anciens outils restent (le projet Claude Code s'en sert). Le calcul copié (positions, références, id des étiquettes) est dansapp/serveur/station.py, sa provenance dansapp/README.md.
D-139 — 2026-11-05 — Les courbes de la page Étiquetage en ECharts, plus Plotly
- Statut : active. Complète D-138.
- Décision : la page Étiquetage de la web app dessine ses courbes et la barre des étiquettes avec Apache ECharts (open source, Apache 2.0), aux couleurs de Mantine, en clair comme en sombre. Un seul graphique : les deux plots et la barre partagent le temps ; molette pour zoomer, glisser sur un plot pour se déplacer, réglette en bas, double-clic pour tout voir ; glisser sur la barre sélectionne une plage, un clic ouvre une étiquette. Le texte d'une étiquette s'affiche tronqué dans sa barre ; la couleur dit la famille.
- Pourquoi : l'utilisateur trouvait Plotly peu esthétique (2026-11-05). La page avait aussi deux défauts : glisser sur la barre ne sélectionnait aucune plage, donc on ne pouvait pas ajouter d'étiquette ; et le texte des étiquettes était masqué dès qu'il ne tenait pas dans sa barre.
- Options écartées : Mantine Charts (Recharts), le plus cohérent avec l'app, mais en SVG il rame au-delà de quelques milliers de points (un mois de LENZSPITZE : ~4 300 points par série, jusqu'à 41 séries par plot) et n'a pas de zoom natif ; uPlot, rapide mais presque tout à coder ; garder Plotly en l'habillant. L'échantillonnage LTTB d'ECharts aussi : il relie les points par-dessus les trous de mesure.
- Conséquence :
plotly.js-dist-minquitteapp/web/. Les anciens outils (labeling.py,view.py) gardent Plotly.