diff --git a/.claude/agents/revue.md b/.claude/agents/revue.md index 76611b2..c241a34 100644 --- a/.claude/agents/revue.md +++ b/.claude/agents/revue.md @@ -16,7 +16,7 @@ Un event `E-xxx`, et l'une de ces trois consignes : 1. Lis `events/E-xxx/event.md`, sa ligne de `events/INDEX.md` et `etiquetage.md` à côté. 2. La station réelle : la ligne `,,E-xxx` de `.claude/skills/anonymize-event/registre.csv` ; les vrais noms des capteurs cités : les lignes `,,` du même registre. Ils sont pour l'utilisateur seulement : jamais dans un fichier de l'event. 3. La séance : l'horodatage de l'en-tête de la fiche, dossier `events-learner/_/` ; le lot dont le `builder.md` cite l'event. Lis ce `builder.md` et, dans l'analyse du lot (`analyse.md` ; avant D-090, la partie 1 de `critique.md`), ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule). -4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/events-learner/detecteurs.py data/ --du --au --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data//`, hors de git, sur `events/E-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ? +4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 detectors-view/detecteurs.py data/ --du --au --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data//`, hors de git, sur `events/E-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ? 5. Regarde chaque PNG de la fiche : montre-t-il ce que dit sa légende ? 6. Écris la présentation (format ci-dessous) dans `out/review-event/E-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/review-event/page.py E-xxx --du --au ` (mêmes dates qu'en 4). 7. Rends seulement : le chemin de la page, les dates passées, et la liste « À trancher par l'expert », numérotée. diff --git a/.claude/skills/events-learner/SKILL.md b/.claude/skills/events-learner/SKILL.md index feb4d84..643ebde 100644 --- a/.claude/skills/events-learner/SKILL.md +++ b/.claude/skills/events-learner/SKILL.md @@ -96,6 +96,6 @@ Si `git status --short docs/ameliorations-processus.md` montre un changement : c ## 7. Réponse finale -`python3 .claude/skills/events-learner/comparaison.py ` : la page de fin de séance, `out/events-learner__.html`, qui s'ouvre dans le navigateur (D-066). C'est la page de `python3 .claude/skills/events-learner/detecteurs.py --du --au ` sur la plage de la séance (images de la caméra et timelapse d'un événement au clic, pose de la caméra, `corr_x` et `corr_y` de chaque capteur, ligne « Error rate »), chaque ligne de catégorie dédoublée : la lecture de l'analyste (ses étiquettes) au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, et en gris ses moments hors catégorie ; sous la figure, la liste des événements, le score de la séance et le benchmark sur la base d'events. Le but, séance après séance : que les deux coïncident. Un échec du script va dans la réponse, sans relance. +`python3 .claude/skills/events-learner/comparaison.py ` : la page de fin de séance, `out/events-learner__.html`, qui s'ouvre dans le navigateur (D-066). C'est la page de `python3 detectors-view/detecteurs.py --du --au ` sur la plage de la séance (images de la caméra et timelapse d'un événement au clic, pose de la caméra, `corr_x` et `corr_y` de chaque capteur, ligne « Error rate »), chaque ligne de catégorie dédoublée : la lecture de l'analyste (ses étiquettes) au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, et en gris ses moments hors catégorie ; sous la figure, la liste des événements, le score de la séance et le benchmark sur la base d'events. Le but, séance après séance : que les deux coïncident. Un échec du script va dans la réponse, sans relance. En 8 lignes au plus : la page, la base de la séance, le chemin du bilan, le benchmark (ligne `total` / `toutes`, `grep -E '^total +toutes'`, du début du lot à la modification gardée), le nombre de modifications gardées et d'events créés, le nombre d'étiquettes (`/lot-*/etiquettes.json`, à garder même si l'utilisateur annule des modifications : elles ne dépendent pas des détecteurs), les erreurs, les difficultés relevées et, avec `--ameliorer`, celles corrigées. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`. diff --git a/.claude/skills/events-learner/comparaison.py b/.claude/skills/events-learner/comparaison.py index e2db405..52abf7c 100644 --- a/.claude/skills/events-learner/comparaison.py +++ b/.claude/skills/events-learner/comparaison.py @@ -1,6 +1,6 @@ """Page de fin de séance de /events-learner : la lecture de l'analyste face aux détecteurs, sur toute la plage de la séance. -La page de detecteurs.py (images de la caméra, timelapse d'un événement au clic, pose de la caméra, corr_x et corr_y de +La page de detectors-view/detecteurs.py (images de la caméra, timelapse d'un événement au clic, pose de la caméra, corr_x et corr_y de chaque capteur en couleur, ligne « Error rate »), chaque ligne de catégorie dédoublée : en haut les moments de l'analyste (etiquettes.json des lots de la séance), en bas les événements des détecteurs tels qu'ils sont (la plage classée avec ses 3 jours d'historique, comme le score). En dernier, en gris, les moments « aucune » de l'analyste : vus, mais hors des @@ -16,54 +16,11 @@ import html import io import json import os -import statistics import sys -import textwrap -sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..", "src")) -from common.page import ROOT, open_served # noqa: E402 (bascule seule sur .venv si plotly manque) -import plotly.graph_objects as go # noqa: E402 -from plotly.subplots import make_subplots # noqa: E402 -import score # noqa: E402 (détecteurs, chargement et score ; met detectors/ et les outils sur le chemin) -import benchmark # noqa: E402 (les détecteurs face aux events de la base, D-069) - -AGENT, SCRIPTS = "#2a78d6", "#eb6834" # palette catégorielle de référence, slots 1 et 2 (skill dataviz) -HORS, GRIS = "hors catégorie", "#a3a29c" # moments « aucune » de l'analyste : aucun détecteur ne peut les rejoindre -# du vert au rouge (demande de l'utilisateur, 2026-10-27) : couleurs d'état de la palette de référence (skill dataviz) -VERT_ROUGE = ["#0ca30c", "#fab219", "#ec835a", "#d03b3b"] - - -def taux_erreur(mesures, a, b): - """Ligne « Error rate » : à chaque instant de [a, b), l'error_value moyenne de tous les capteurs, du vert au rouge sur - une échelle fixe de 0 à 1, avec sa barre de couleur. Dans sa propre rangée : une heatmap sur les axes des barres fait - planter plotly.js 4.1.1.""" - par_t = {} - for ms in mesures.values(): - for m in ms: - if a <= m["t"] < b and m["error_value"] is not None: - par_t.setdefault(m["t"], []).append((m["error_value"], m["error_threshold"])) - erreurs = sorted(par_t.items()) - return go.Heatmap( - x=[t for t, _ in erreurs], y=["Error rate"], z=[[statistics.mean(e for e, _ in v) for _, v in erreurs]], - text=[[f"{len(v)} capteurs, {sum(1 for e, th in v if th is not None and e > th)} rejetés" for _, v in erreurs]], - zmin=0, zmax=1, colorscale=[[i / (len(VERT_ROUGE) - 1), c] for i, c in enumerate(VERT_ROUGE)], - colorbar={"title": {"text": "Error rate", "side": "right"}, "thickness": 12, "len": 0.3, "y": 0, "yanchor": "bottom"}, - hovertemplate="%{x|%Y-%m-%d %H:%M} UTC
error_value moyenne : %{z:.3f}
%{text}") - - -def survol(titre, debut, fin, capteurs, *lignes): - return "
".join([f"{titre}", f"{debut} → {fin}", f"capteurs : {', '.join(capteurs) or 'tous'}", - *("
".join(textwrap.wrap(x, 90)) for x in lignes if x)]) - - -def barres(nom, couleur, spans, pas, rang, groupe): - """[(début, fin, catégorie, survol)] -> barres horizontales, de la première mesure à la dernière plus un pas ; même - groupe : même place dans la ligne.""" - debuts = [score.instant(s[0]) for s in spans] - return go.Bar(name=nom, orientation="h", y=[s[2] for s in spans], base=debuts, marker_color=couleur, legendrank=rang, - offsetgroup=groupe, - x=[(score.instant(s[1]) + pas - d).total_seconds() * 1000 for s, d in zip(spans, debuts)], - hovertext=[s[3] for s in spans], hoverinfo="text") +sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..", "detectors-view")) +import detecteurs # noqa: E402 (la page des détecteurs ; met src/, detectors/ et les outils sur le chemin) +from detecteurs import HORS, ROOT, benchmark, open_served, score, survol # noqa: E402 NIVEAUX = {"à ignorer": "Toutes les zones à ignorer", "prudence": "Toutes les zones à lire avec prudence"} @@ -85,7 +42,6 @@ def tableau(total, ordre, titre="Catégorie"): def page(dossier, seance): """La page de detecteurs.py sur la plage de la séance (images, timelapse, pose de la caméra, capteurs en couleur), plus les moments de l'analyste, le score de la séance et le benchmark.""" - import detecteurs # ici : detecteurs importe ce module chemins = sorted(glob.glob(os.path.join(seance, "lot-*", "etiquettes.json"))) if not chemins: sys.exit(f"{seance} : aucun lot-*/etiquettes.json") diff --git a/.claude/skills/review-event/page.py b/.claude/skills/review-event/page.py index 92e6206..774a2fd 100644 --- a/.claude/skills/review-event/page.py +++ b/.claude/skills/review-event/page.py @@ -1,7 +1,7 @@ """La page de revue d'un event appris : tout ce qu'il faut à l'expert pour trancher, sur une seule page (D-075). En tête, la présentation de l'agent revue (out/review-event/E-xxx.md, si elle existe), puis la page des détecteurs sur la -plage (detecteurs.py, sur data//, sinon sur le dossier de l'event) ; dessous, la fiche, l'étiquetage, le rendu de +plage (detectors-view/detecteurs.py, sur data//, sinon sur le dossier de l'event) ; dessous, la fiche, l'étiquetage, le rendu de l'event-builder, l'analyse et la critique du lot d'origine, puis toutes les figures : celles de l'event et celles du lot de la séance. Les vrais noms y figurent (registre) : la page reste dans out/, hors de git. Usage : python3 .claude/skills/review-event/page.py E-xxx --du AAAA-MM-JJ --au AAAA-MM-JJ (--au exclu ; page ouverte) @@ -17,9 +17,9 @@ import re import sys ICI = os.path.dirname(os.path.abspath(__file__)) -sys.path.insert(0, os.path.join(ICI, "..", "events-learner")) +sys.path.insert(0, os.path.join(ICI, "..", "..", "..", "detectors-view")) import detecteurs # noqa: E402 -from comparaison import ROOT, open_served # noqa: E402 +from detecteurs import ROOT, open_served # noqa: E402 EVENTS = os.path.join(ROOT, "events") diff --git a/CLAUDE.md b/CLAUDE.md index 2e93f5e..9af7742 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -53,7 +53,7 @@ python3 maquettes/user/summary.py [début] [fin] # maquette client, une 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 # événements du journal, une ligne chacun -python3 .claude/skills/events-learner/detecteurs.py data/ [--du D --au F] # page des détecteurs seuls +python3 detectors-view/detecteurs.py data/ [--du D --au F] # page des détecteurs seuls python3 .claude/skills/events-learner/benchmark.py # détecteurs face à la base d'events pdftotext -layout "docs/aimsight/.pdf" - # lire un PDF AIMsight python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .venv @@ -69,7 +69,7 @@ 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 '^#' `), puis la seule section utile (Read avec `offset` et `limit`). -- `docs/decisions.md` (933 l, D-001 à D-092) : 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` (940 l, D-001 à D-093) : 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/`. @@ -98,6 +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, `events-learner`, 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. +- `detectors-view/` : le développement de la page des détecteurs (D-093), `detecteurs.py` : images, courbes, Status, catégories, Error rate ; reprise par la page de fin de séance de `/events-learner` (`comparaison.py`) et par `/review-event`. - `events-learner/`, `aiguiser/` : les séances de `/events-learner` et `/aiguiser` (D-084), une par dossier `_/` (`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 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 `/events-learner` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal, faux amis ; elle apprend de chaque event validé, D-087) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par l'event-builder de `/events-learner`. - `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`. diff --git a/.claude/skills/events-learner/detecteurs.py b/detectors-view/detecteurs.py similarity index 90% rename from .claude/skills/events-learner/detecteurs.py rename to detectors-view/detecteurs.py index 690df36..6a253a6 100644 --- a/.claude/skills/events-learner/detecteurs.py +++ b/detectors-view/detecteurs.py @@ -14,7 +14,7 @@ le timelapse de ses images à droite, ses capteurs entourés), une ligne par cat leur état actuel (la plage classée avec ses 3 jours d'historique, comme un lot de /events-learner), et la ligne « Error rate » : à chaque instant, l'error_value moyenne de tous les capteurs (du vert au rouge, échelle fixe de 0 à 1) ; en bas, la liste des événements et leur phrase. Ne modifie rien et n'écrit dans aucun historique. -Usage : python3 .claude/skills/events-learner/detecteurs.py [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] +Usage : python3 detectors-view/detecteurs.py [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] (--au exclu ; sans dates, toute la période du dossier ; page : out/detecteurs___.html, ouverte) """ import argparse @@ -23,15 +23,25 @@ import itertools import json import os import statistics +import sys +import textwrap from collections import Counter from pathlib import Path from urllib.parse import quote -import comparaison # noqa: E402 (met src/, detectors/ et les outils sur le chemin ; barres, survol, couleurs) -from comparaison import ROOT, go, make_subplots, score -from common.page import open_served +ICI = os.path.dirname(os.path.abspath(__file__)) +sys.path[:0] = [os.path.join(ICI, "..", "src"), os.path.join(ICI, "..", ".claude", "skills", "events-learner")] +from common.page import ROOT, open_served # noqa: E402 (bascule seule sur .venv si plotly manque) +import plotly.graph_objects as go # noqa: E402 +from plotly.subplots import make_subplots # noqa: E402 +import score # noqa: E402 (détecteurs et chargement, comme /events-learner ; met detectors/ et les outils sur le chemin) +import benchmark # noqa: E402 (la version des détecteurs) import donnees # noqa: E402 +AGENT, SCRIPTS = "#2a78d6", "#eb6834" # palette catégorielle de référence, slots 1 et 2 (skill dataviz) +HORS, GRIS = "hors catégorie", "#a3a29c" # moments « aucune » de l'analyste : aucun détecteur ne peut les rejoindre +# du vert au rouge (demande de l'utilisateur, 2026-10-27) : couleurs d'état de la palette de référence (skill dataviz) +VERT_ROUGE = ["#0ca30c", "#fab219", "#ec835a", "#d03b3b"] MARGE_PX = 150 # marge autour des capteurs, recadrage du timelapse (comme MARGIN_PX de la maquette Explore) COULEURS = ["#2a78d6", "#eb6834", "#1baf7a", "#8a5cd6", "#d6a12a", "#d63b8a", "#3bb3d6", "#6b6b66"] # un capteur chacun POSE = (("pan", "#1a1a19"), ("tilt", "#8a8a85"), ("rotation", "#b5651d")) # sombres : à part des couleurs des capteurs @@ -227,6 +237,39 @@ def disposition(hauteurs, cachee, ouvert, heures=()): return d +def taux_erreur(mesures, a, b): + """Ligne « Error rate » : à chaque instant de [a, b), l'error_value moyenne de tous les capteurs, du vert au rouge sur + une échelle fixe de 0 à 1, avec sa barre de couleur. Dans sa propre rangée : une heatmap sur les axes des barres fait + planter plotly.js 4.1.1.""" + par_t = {} + for ms in mesures.values(): + for m in ms: + if a <= m["t"] < b and m["error_value"] is not None: + par_t.setdefault(m["t"], []).append((m["error_value"], m["error_threshold"])) + erreurs = sorted(par_t.items()) + return go.Heatmap( + x=[t for t, _ in erreurs], y=["Error rate"], z=[[statistics.mean(e for e, _ in v) for _, v in erreurs]], + text=[[f"{len(v)} capteurs, {sum(1 for e, th in v if th is not None and e > th)} rejetés" for _, v in erreurs]], + zmin=0, zmax=1, colorscale=[[i / (len(VERT_ROUGE) - 1), c] for i, c in enumerate(VERT_ROUGE)], + colorbar={"title": {"text": "Error rate", "side": "right"}, "thickness": 12, "len": 0.3, "y": 0, "yanchor": "bottom"}, + hovertemplate="%{x|%Y-%m-%d %H:%M} UTC
error_value moyenne : %{z:.3f}
%{text}") + + +def survol(titre, debut, fin, capteurs, *lignes): + return "
".join([f"{titre}", f"{debut} → {fin}", f"capteurs : {', '.join(capteurs) or 'tous'}", + *("
".join(textwrap.wrap(x, 90)) for x in lignes if x)]) + + +def barres(nom, couleur, spans, pas, rang, groupe): + """[(début, fin, catégorie, survol)] -> barres horizontales, de la première mesure à la dernière plus un pas ; même + groupe : même place dans la ligne.""" + debuts = [score.instant(s[0]) for s in spans] + return go.Bar(name=nom, orientation="h", y=[s[2] for s in spans], base=debuts, marker_color=couleur, legendrank=rang, + offsetgroup=groupe, + x=[(score.instant(s[1]) + pas - d).total_seconds() * 1000 for s, d in zip(spans, debuts)], + hovertext=[s[3] for s in spans], hoverinfo="text") + + def plotly_t(iso): """« 2026-09-25T12:00Z » -> « 2026-09-25 12:00 » : Plotly ne lit pas le Z (le zoom du clic sur une barre).""" return iso.replace("T", " ").rstrip("Z") @@ -338,8 +381,8 @@ def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste= evts = score.evenements(mesures, score.iso(a), score.iso(b)) spans = [(v["start"], v["end"], v["category"], - comparaison.survol(v["label"], v["start"], v["end"], v["sensors"], v["text"])) for v in evts] - hors = comparaison.HORS + survol(v["label"], v["start"], v["end"], v["sensors"], v["text"])) for v in evts] + hors = HORS presentes = {v["category"] for v in evts} | {s[2] for s in analyste} ordre = [*score.categories.CATEGORIES, *sorted(presentes - set(score.categories.CATEGORIES) - {hors}), *[hors] * (hors in presentes)] haut = 40 if analyste else 30 # deux barres par ligne avec l'analyste @@ -369,17 +412,17 @@ def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste= line={"width": 1.2, "color": COULEURS[i % len(COULEURS)], "dash": "dot" if ref else "solid"}, hovertemplate=f"{s} : %{{y:.3f}} px"), row=row, col=1) if spans: - d = comparaison.barres("Détecteurs", comparaison.SCRIPTS, spans, pas, 1, "d") + d = barres("Détecteurs", SCRIPTS, spans, pas, 1, "d") d.customdata = [[plotly_t(v["start"]), plotly_t(score.iso(score.instant(v["end"]) + pas)), v["label"], tableau([v]) + groupes(mesures, refs, score.instant(v["start"]), score.instant(v["end"]), v["sensors"]), v["sensors"]] for v in evts] d.hovertext = [h + "
clic : zoom, ses capteurs seuls, ses détails" + " et son timelapse" * bool(images) + " sous la figure" for h in d.hovertext] fig.add_trace(d, row=k_, col=1) # en mode group, le 1er groupe en bas - for nom_a, couleur, rang, sel in (("Analyste", comparaison.AGENT, 2, [s for s in analyste if s[2] != hors]), - (f"Analyste, {hors}", comparaison.GRIS, 3, [s for s in analyste if s[2] == hors])): + for nom_a, couleur, rang, sel in (("Analyste", AGENT, 2, [s for s in analyste if s[2] != hors]), + (f"Analyste, {hors}", GRIS, 3, [s for s in analyste if s[2] == hors])): if sel: - t = comparaison.barres(nom_a, couleur, sel, pas, rang, "a") + t = barres(nom_a, couleur, sel, pas, rang, "a") t.customdata = [[plotly_t(s[0]), plotly_t(score.iso(score.instant(s[1]) + pas)), f"Analyste : {s[2]}", f"

{s[3]}

", None] for s in sel] t.hovertext = [h + "
clic : zoom, ses détails" + " et son timelapse" * bool(images) + " sous la figure" @@ -388,7 +431,7 @@ def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste= fig.add_trace(go.Scatter(x=[a] * len(ordre), y=ordre, mode="markers", marker={"opacity": 0}, hoverinfo="skip", showlegend=False), row=k_, col=1) # invisible : toutes les catégories ont leur ligne, même vides fig.add_trace(statut(evts, temps, pas, mesures, refs), row=s_, col=1) - fig.add_trace(comparaison.taux_erreur(mesures, a, b), row=5 + c, col=1) + fig.add_trace(taux_erreur(mesures, a, b), row=5 + c, col=1) fig.update_layout(barmode="group", bargap=0.3, bargroupgap=0.1, hovermode="closest", uniformtext={"minsize": 9, "mode": "hide"}, # le nom d'un bloc trop court pour lui : au survol seul plot_bgcolor="white", margin={"l": 170, "r": 90, "t": 40, "b": 40}, @@ -451,7 +494,7 @@ th{{font-weight:600;color:#3d3d3a}} .details{{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:24px;align-items:start}} {entete}

Détecteurs, {html.escape(station)} : {score.iso(a)} → {score.iso(b)} (UTC)

-

Les détecteurs du journal tels qu'ils sont (version {comparaison.benchmark.version()}), la plage classée avec ses 3 jours d'historique. +

Les détecteurs du journal tels qu'ils sont (version {benchmark.version()}), la plage classée avec ses 3 jours d'historique. Survol d'une barre : capteurs et phrase ; ligne Status, sous les courbes : ce qui se passe (bleu clair : aucun événement ; bleu foncé : un bloc d'événements qui se touchent, nommé par la catégorie qui en couvre le plus, celle qui englobe les autres ; le survol dit tous ses événements ; sans À vérifier ni Dérive lente) ; un clic sur « ▾ Status » replie ou déplie les catégories, un clic sur un bloc zoome la plage sur lui et montre ses détails sous la figure (Details : ses événements à gauche, le timelapse de ses images à droite, ses capteurs entourés, jaune les cibles, bleu les références, si x et y sont des positions dans l'image) ; ligne Error rate : error_value moyenne de tous les capteurs à chaque instant. Zoom par sélection ; la liste complète est sous la figure. diff --git a/docs/decisions.md b/docs/decisions.md index 95997f8..cdaf9c1 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -931,3 +931,10 @@ Règles du journal : - **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 unique `lot-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 lit `events-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.py` quitte `.claude/skills/events-learner/` et emporte ses aides d'affichage, jusque-là dans `comparaison.py` (barres, survol, ligne « Error rate », couleurs). `comparaison.py` (page de fin de séance) et `.claude/skills/review-event/page.py` importent la page depuis `detectors-view/` ; `score.py` et `benchmark.py` restent 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` ↔ `comparaison` disparaît. +- **Options écartées** : déplacer aussi `score.py` et `benchmark.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/ [--du D --au F]` ; un lien vers `.claude/skills/events-learner/detecteurs.py` dans l'historique se lit `detectors-view/detecteurs.py`. diff --git a/run.md b/run.md index 02bb391..fad2e16 100644 --- a/run.md +++ b/run.md @@ -61,6 +61,18 @@ Dans une session Claude Code neuve, **en mode auto** (sinon elle s'arrête à ch Détails : `.claude/skills/aiguiser/SKILL.md`. +# Voir les détecteurs du journal (page des détecteurs) + +Les détecteurs seuls sur une station et une plage, sans boucle ni analyste (rien n'est modifié ni commité). Le développement de la page est dans `detectors-view/` ; `/events-learner` (page de fin de séance) et `/review-event` la reprennent. + +```bash +python3 detectors-view/detecteurs.py data/ --du --au +``` + +- `` exclu ; sans dates, toute la période du dossier. La plage est classée avec ses 3 jours d'avant, comme un lot. +- Page `out/detecteurs___.html`, ouverte seule : `corr_x` et `corr_y` de tous les capteurs, une ligne par catégorie (survol : capteurs et phrase), puis la liste des événements. +- `--sans-ouvrir` : écrit la page sans l'ouvrir. + # Améliorer les détecteurs du journal (events-learner) Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Agent (pas dans le dev container), une fois les déplacements **et les images** pompés : @@ -75,7 +87,7 @@ Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Ag - Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063). - La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, detectors-critic, puis detectors-upgrader et detectors-control si la critique a des suggestions, event-builder à chaque lot, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/events-learner` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités. - Bilan dans `events-learner/_/bilan.md` ; les étiquettes de l'analyste (`lot-*/etiquettes.json`) sont à garder même si on annule une modification. Ensuite : `git revert` des commits de la séance qu'on ne garde pas (la base de la séance est dans le bilan). -- À la fin, la page `out/events-learner__.html` s'ouvre (D-066) : la page de `detecteurs.py` (ci-dessous) sur la plage, images et timelapse compris ; dessous les courbes, catégorie par catégorie, l'analyste (bleu) face aux détecteurs (orange) ; le score de la séance et le benchmark. +- À la fin, la page `out/events-learner__.html` s'ouvre (D-066) : la page des détecteurs (`detectors-view/detecteurs.py`, ci-dessus) sur la plage, images et timelapse compris ; dessous les courbes, catégorie par catégorie, l'analyste (bleu) face aux détecteurs (orange) ; le score de la séance et le benchmark. - Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`), lancé au début de chaque lot, après chaque modification et en fin de séance ; chaque passage s'ajoute à `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs. Refaire la page d'une séance : @@ -84,15 +96,6 @@ Refaire la page d'une séance : python3 .claude/skills/events-learner/comparaison.py data/ events-learner/_ ``` -Voir les détecteurs seuls sur une station et une plage, sans boucle ni analyste (rien n'est modifié ni commité) : - -```bash -python3 .claude/skills/events-learner/detecteurs.py data/ --du --au -``` - -- `` exclu ; sans dates, toute la période du dossier. La plage est classée avec ses 3 jours d'avant, comme un lot. -- Page `out/detecteurs___.html`, ouverte seule : `corr_x` et `corr_y` de tous les capteurs, une ligne par catégorie (survol : capteurs et phrase), puis la liste des événements. - Lancer le benchmark à la main (sans rien écrire dans l'historique) : ```bash