Events: read-event skill to consult the base (D-085), cases renamed events E-xxx (D-086)

- read-event: map and index first, then the card of close events only,
  then their data with the reading tools; never all cards at once.
  Diagnostic agent, critiquer-lot and builder point to it; the index
  header too. Signature length: about 250 characters, a guideline.
- "Cas" becomes "event": events/E-xxx/event.md, skills new-event,
  review-event, anonymize-event.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 07:25:29 +01:00
1 parent 4d99585474
commit 446fde3192
1206 files changed
+2172 -2129

No files matched your search

+11 -11
View File
@@ -10,9 +10,9 @@ Cadrage du product owner : sous-projet G, santé des sites et notifications au c
## État et prochaine étape (au 2026-10-28)
- **Domaines système, livrés en prototype** : Energy (D-020, D-043), Storage (D-034, D-035), Cellular (D-031, D-037), Temperature (D-040) ; chacun avec ses analyses, sa couleur du jour, sa figure du site, son bloc dans la vue client, sa notification support et son guide (D-039, D-041). Seul Energy repose sur des cas de l'expert ; les autres ont des seuils provisoires et attendent le spécialiste.
- **Domaines système, livrés en prototype** : Energy (D-020, D-043), Storage (D-034, D-035), Cellular (D-031, D-037), Temperature (D-040) ; chacun avec ses analyses, sa couleur du jour, sa figure du site, son bloc dans la vue client, sa notification support et son guide (D-039, D-041). Seul Energy repose sur des events de l'expert ; les autres ont des seuils provisoires et attendent le spécialiste.
- **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025).
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (C-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/boucle` (D-057) et `/aiguiser` (D-059), base de cas `events/` revue par `/revue-cas` (D-075). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/boucle` (D-057) et `/aiguiser` (D-059), base d'events `events/` revue par `/review-event` (D-075). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
- **Support** (D-079) : `/support <mail>` répond à la question d'un client, et à elle seule. Premier cas : LENZSPITZE, nuit du 26 au 27.10.
- **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas.
- **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale.
@@ -53,14 +53,14 @@ python3 maquettes/support/home.py [début] [fin] # maquette support
python3 vues-deplacements/maquette/explore.py [dossier] # page Explore : View, Diagnosis, Displacements, Journal
python3 detectors/categories.py <dossier> # événements du journal, une ligne chacun
python3 .claude/skills/boucle/detecteurs.py data/<STATION> [--du D --au F] # page des détecteurs seuls
python3 .claude/skills/boucle/benchmark.py # détecteurs face à la base de cas
python3 .claude/skills/boucle/benchmark.py # détecteurs face à la base d'events
pdftotext -layout "docs/aimsight/<fichier>.pdf" - # lire un PDF AIMsight
python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .venv
```
- `[données]` : CSV ou dossiers ; défauts : `data/VERMONT/` (Energy), `data/WEISSHORN/` (Storage), `data/WEISSHORN/` et `data/NORDEND/` (Cellular, Temperature). Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; lancer les deux maquettes avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
- Chaque script bascule seul sur `.venv` si plotly manque, puis ouvre sa page (navigateur Windows via `explorer.exe` sous WSL ; dans le dev container, la page reste dans `out/`).
- Pompage, `/aiguiser`, `/boucle`, `/revue-cas` : `run.md`.
- Pompage, `/aiguiser`, `/boucle`, `/review-event` : `run.md`.
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur le jeu de travail du domaine ; pour les détecteurs, le benchmark et la page des détecteurs.
## Carte du dépôt
@@ -68,13 +68,13 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
### Lire sans saturer le contexte
- Fichier long (tailles en lignes ci-dessous) : lire son plan (`grep -n '^#' <fichier>`), puis la seule section utile (Read avec `offset` et `limit`).
- `docs/decisions.md` (860 l, D-001 à D-084) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
- `docs/decisions.md` (880 l, D-001 à D-086) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
- `data/` : explorer par script (`common.stations.load_stations`, outils de `agent-tools/`), jamais en affichant les CSV.
- Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant et la spec du support), `out/`, `.venv/`, `graphify-out/`.
### Racine
- `README.md` : point d'entrée pour un humain. `run.md` (115 l) : les commandes que lance l'utilisateur (pompage, métriques de qualité par `~/optical_emulator`, `/aiguiser`, `/boucle`, `/revue-cas`). `push.sh "<message>"` : pull, commit de tout, push.
- `README.md` : point d'entrée pour un humain. `run.md` (115 l) : les commandes que lance l'utilisateur (pompage, métriques de qualité par `~/optical_emulator`, `/aiguiser`, `/boucle`, `/review-event`). `push.sh "<message>"` : pull, commit de tout, push.
### `docs/`
@@ -88,7 +88,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- Ces documents prévoient un LLM pour la synthèse : la couche déterministe reste 100 % analytique ; la couche d'agents côté serveur (D-027) reprend l'idée, en exploration.
- `domaine/` : savoir métier commun, une note courte par question : `ce-que-mesure-la-station.md` (format CSV, métriques, unités ; la consommation est mesurée, pas l'apport), `pieges-des-donnees.md`, `colonnes-des-deplacements.md`, `images-de-la-camera.md` (IRON, la scène ; DIFF, les réflecteurs).
- `energy/`, `storage/`, `cellular/`, `temperature/` : un dossier par domaine système : `analyses/` (fiches, 70-120 l ; modèle `.claude/skills/nouvelle-analyse/modele-fiche.md`), `domaine/` (savoir métier, `point-de-depart.md`, `questions-pour-l-expert.md`), `guide/` (~90 l, client puis support ; la partie 1 est affichée dans la vue client), la matrice `.drawio`. Energy : `domaine/cas-annotes-par-l-expert.md` (diagnostics de 5 stations, vérité de référence), guide de 200 l en brouillon.
- `displacement/` : `cadrage.md` (158 l, séries optiques, D-044) ; `domaine/` : `ce-que-regarde-le-client.md` (sauts et tendances, D-055), `cas-annotes-par-l-expert.md` (les deux rapports d'analyse, sans données), `incident-de-barcelone.md` (C-004 : mouvement réel selon l'expert, instabilité des références selon la doc), `cycle-thermique.md`.
- `displacement/` : `cadrage.md` (158 l, séries optiques, D-044) ; `domaine/` : `ce-que-regarde-le-client.md` (sauts et tendances, D-055), `cas-annotes-par-l-expert.md` (les deux rapports d'analyse, sans données), `incident-de-barcelone.md` (E-004 : mouvement réel selon l'expert, instabilité des références selon la doc), `cycle-thermique.md`.
- `agents/` : `rapport-exploratoire.md` (292 l, agents LLM côté serveur, D-027), `enquete-a-la-demande.md` (233 l, D-042), `agent-diagnostic.md` (377 l, spec de l'agent), `pipelines-ia.drawio` (les processus automatiques, une page chacun).
- `ameliorations-faq.md` : idées pour la prochaine FAQ. `ameliorations-processus.md` : difficultés des processus automatiques, tenu par le `releveur` (D-060).
- `superpowers/` : specs et plans (110-1 300 l), historique non maintenu ; vivants : le plan `plans/2026-10-23-journal-du-matin.md` (1 290 l, index en tête) et `specs/2026-10-28-support-agent-design.md`. La spec d'une nouvelle analyse s'écrit dans sa fiche.
@@ -98,7 +98,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- `vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `contexte/` (journal du matin, seuils, lissage, boucle, aiguisage), `cas/` (NORDEND, parcours de l'utilisateur), `benchmark/historique.csv` (D-069).
- `detectors/` : les détecteurs du journal (D-067, D-068, D-084), un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés en événements par `categories.py` ; `archive/` : versions écartées.
- `boucle/`, `aiguiser/` : les séances de `/boucle` et `/aiguiser` (D-084), une par dossier `<séance>_<STATION>/` (`lot-NN/`, `bilan.md`) ; historique, à ne lire que sur demande. `aiguiser/voir.py` : ce que rendent les outils de lecture sur un lot.
- `events/` : **la base de cas, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre), un dossier `C-xxx/` par cas (`cas.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/boucle` en attendant `/revue-cas` ; `carte-des-evenements.md` (familles, catégories du journal) et `eventualites-et-categories.drawio`. Un cas n'y entre que par `/nouveau-cas`, lancé par l'utilisateur, ou par le builder de `/boucle`.
- `events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/boucle` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par le builder de `/boucle`.
- `agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees`, aiguisé par `/aiguiser`.
- `agent-diagnostic/` : consignes (`instructions.md`, 146 l) et rapports de l'agent de diagnostic (D-082). Appel : `@agent-diagnostic data/<STATION>/ [question]`.
- `support/` : un dossier par demande d'un client (D-079), `<date>_<STATION>_<sujet>/` : `demande.md`, `analyse.md`, `reponse.md` (le mail prêt à envoyer), GIF des images. Contient des mails et images de clients.
@@ -111,8 +111,8 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- `data/` : un dossier par station, au numéro de série du système (D-029), rempli par le pompage, **hors de git** (D-065) : `metrics/` (un CSV par métrique et par jour), `displacement/` (« advanced », un CSV par jour), `camera/`, `images/`, au besoin `images_diff/` et `quality/`. Les stations présentes : `ls data/`.
- Jeux de travail : VERMONT pour Energy (D-009, le plus long historique) ; WEISSHORN pour Storage (D-034) ; WEISSHORN et NORDEND pour Cellular (D-030, D-032) et Temperature (D-040) ; à pomper s'ils manquent.
- WEISSHORN et NORDEND contiennent des identifiants (`SIM_CCID`, `ip`, `ip_*`) : ne pas les recopier.
- Les données des cas restent, codées, dans `events/`.
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `upgrader`, `validateur`, `builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/revue-cas`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `critiquer-lot`, `aiguiser`, `lire-les-donnees`, `nouveau-cas`, `revue-cas`, `anonymiser-cas` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
- Les données des events restent, codées, dans `events/`.
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `upgrader`, `validateur`, `builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `critiquer-lot`, `aiguiser`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
- `.devcontainer/` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `out/` : pages et JSON générés.
- Tout est versionné (D-014), sauf `out/`, `data/`, `.venv/`, `__pycache__/`, `graphify-out/` et `.env`.
@@ -152,7 +152,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- **Chaque conclusion est traçable.** Elle cite les faits calculés et la règle qui l'a produite. Aucun chiffre ni seuil sans source.
- Ne pas confondre « pas de donnée visible » et « station arrêtée » : acquisition, transmission, ingestion et affichage sont des couches distinctes.
- Séparer fait observé, fait dérivé, contexte opérateur, hypothèse et inconnu. Pas de pseudo-probabilités ; vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`.
- Pas de règle spécifique à un site : les cas résolus deviennent des cas de régression.
- Pas de règle spécifique à un site : les events résolus deviennent des cas de régression.
- Lecture seule : aucune action sur les stations, la configuration ou le retraitement.
- Pour les déplacements :
- ne rien construire sur `inlier` binaire : RANSAC sera remplacé par un estimateur pondéré. Utiliser poids continus, `N_eff`, résidus, influence ;