From 722ea0841b3af1d18bed84ea610f9d59578fd5d9 Mon Sep 17 00:00:00 2001 From: maxime Date: Mon, 12 Oct 2026 11:31:32 +0200 Subject: [PATCH] Plan analysis 04 DAILY_BATTERY_TREND implementation Co-Authored-By: Claude Opus 5.5 --- .../plans/2026-10-12-daily-battery-trend.md | 428 ++++++++++++++++++ 1 file changed, 428 insertions(+) create mode 100644 docs/superpowers/plans/2026-10-12-daily-battery-trend.md diff --git a/docs/superpowers/plans/2026-10-12-daily-battery-trend.md b/docs/superpowers/plans/2026-10-12-daily-battery-trend.md new file mode 100644 index 0000000..dcdae73 --- /dev/null +++ b/docs/superpowers/plans/2026-10-12-daily-battery-trend.md @@ -0,0 +1,428 @@ +# Analyse 04 `DAILY_BATTERY_TREND` — plan d'implémentation + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal :** donner, pour chaque jour UTC, la tendance de la batterie face à la veille (`BETTER`, `STABLE`, `WORSE` ou UNKNOWN), et l'afficher en quatrième panneau de la page commune. + +**Architecture :** +- un module de calcul en bibliothèque standard, `src/battery_trend.py`, qui appelle `battery_state.run()` (analyse 03) et compare chaque jour à la veille ; +- un panneau en barres dans `src/energy_plot.py`, ajouté à la liste des analyses de la page ; +- un point d'entrée `src/analyse_04.py` qui lance la page commune, comme `analyse_03.py`. + +**Tech Stack :** Python 3 (bibliothèque standard) pour le calcul ; plotly (`.venv`) pour le graphique. + +**Spec :** `docs/analyses/analyse_04.md` (sections « Principe », « Constantes et sources », « Graphique », « Résultats »). + +## Global Constraints + +- `src/battery_trend.py` : bibliothèque standard uniquement (code embarquable). Plotly seulement dans `src/energy_plot.py`. +- Contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`. Calcul causal : le jour J n'utilise que J et J−1. +- `anomaly = None` pour tous les jours (pas de verdict). La tendance UNKNOWN est portée par `facts["trend"] = None`. +- Constantes : `NIGHT_END_DEADBAND_V = 0.05` ; `STATE_RANK = {"FULL_CHARGE": 3, "PARTIAL_CHARGE": 2, "NO_CHARGE": 1, "BELOW_PLATEAU": 0}`, chacune avec sa source en commentaire. +- Identifiants en anglais, en mots complets (D-017) : `DAILY_BATTERY_TREND`, `BETTER`, `STABLE`, `WORSE`, `state`, `night_end`. Libellés du graphique en français : mieux, stable, pire. +- Couleurs du panneau : paire divergente du skill dataviz, bleu `#2a78d6` (mieux), gris `#8c8c8c` (stable), rouge `#d03b3b` (pire). Le vert prévu dans la spec est refusé par le validateur dataviz (vert `#008300` / rouge : ΔE 5,9 en deutéranopie, sous le plancher de 6). +- **Pas de tests automatisés** (D-008) et **pas de données synthétiques** (refus de l'utilisateur). La vérification se fait en lançant le code sur les données réelles de VERMONT (`data/`), avec des `assert` dans une commande ponctuelle, sans fichier de test. +- Ne pas modifier `src/__main__ (3).py`, `architecture.drawio`, ni `src/battery_state.py`. +- Documents projet en français. Commits en anglais, terminés par `Co-Authored-By: Claude Opus 5.5 `. + +## Review Focus + +1. **Premier jour de l'export** (VERMONT 2026-04-09) : pas de veille, donc `trend = None`, `decided_by = None`, tous les écarts à `None`, et pas de barre. Vérifié dans la tâche 1. +2. **L'état décide contre le signe de la fin de nuit** (VERMONT 2026-08-29, `FULL_CHARGE` → `PARTIAL_CHARGE`, `delta_night_end_v` = +0,041 V) : `WORSE`, `decided_by = "state"`. Vérifié dans la tâche 1. +3. **Écart pile à ±0,05 V** : les fins de nuit sont arrondies au mV par l'analyse 03, et une différence de flottants comme 13,15 − 13,10 donne 0,04999… L'écart est donc arrondi au mV **avant** la comparaison stricte, et 0,05 V donne `STABLE`. VERMONT n'a pas ce cas, et D-008 interdit d'en fabriquer : on vérifie à la relecture l'ordre `round` puis `>`, dans la tâche 1. +4. **Jour manquant entre deux jours** (export troué de plus d'un jour entier) : J−1 n'est pas la veille calendaire, donc `trend = None`. VERMONT n'a pas de jour entier absent de la grille : on vérifie à la relecture le test `date(J) − date(J−1) == 1 jour`, dans la tâche 1. +5. **Zoom sur le panneau des barres** : la zone morte (une seule courbe, `None` entre +0,05 et −0,05) et les barres doivent rester visibles, et l'ordonnée doit se recaler. Le script `AUTOSCALE_Y_JS` lit `t.x` et `t.y`, que les barres ont aussi. Vérifié à l'œil dans la tâche 2. + +--- + +### Task 1 : calcul `src/battery_trend.py` + +**Files :** +- Create : `src/battery_trend.py` + +**Interfaces :** +- Consomme : `battery_state.run(series)`. Ses points ont `t` (datetime UTC, dernière heure du jour) et `facts` = `{state, max_v, min_v, night_end_v, rise_v, hours_full, coverage}`, ou `{state: None, coverage: 0.0}` pour un jour sans mesure. Les séries `{metric: {datetime UTC: float | None}}` viennent de `energy_check.load_stations(paths)`. +- Produit : + - `battery_trend.RULE` : dict avec les clés `id`, `verdict`, `night_end_deadband_v`, `state_rank`, `doc` ; + - `battery_trend.run(series) -> {analysis, rule, points}` : un point par jour UTC, `t` = celui de l'analyse 03, `value` = `facts["delta_night_end_v"]`, `anomaly = None`, `facts` = `{trend, decided_by, state_prev, state, delta_night_end_v, delta_max_v, delta_hours_full}`. + +- [ ] **Step 1 : lancer la commande de vérification (elle échoue tant que le module n'existe pas)** + +Run : +```bash +cd /home/maxime/Support-Agent && python3 - <<'EOF' +import sys; sys.path.insert(0, "src") +from collections import Counter +import energy_check as ec, battery_trend as bt +r = bt.run(ec.load_stations(["data"])["VERMONT"]) +p = {q["t"].date().isoformat(): q for q in r["points"]} +counts = dict(Counter(q["facts"]["trend"] for q in r["points"])) +print(r["analysis"], len(r["points"]), counts) +assert r["analysis"] == "DAILY_BATTERY_TREND" and len(r["points"]) == 184 +assert counts == {None: 1, "STABLE": 137, "WORSE": 26, "BETTER": 20}, counts +assert all(q["anomaly"] is None and q["value"] == q["facts"]["delta_night_end_v"] for q in r["points"]) +# Premier jour : pas de veille. +assert p["2026-04-09"]["facts"] == {"trend": None, "decided_by": None, "state_prev": None, "state": "FULL_CHARGE", + "delta_night_end_v": None, "delta_max_v": None, "delta_hours_full": None} +# L'état décide, même contre le signe de la fin de nuit. +f = p["2026-08-29"]["facts"] +assert (f["trend"], f["decided_by"], f["state_prev"], f["state"], f["delta_night_end_v"]) == \ + ("WORSE", "state", "FULL_CHARGE", "PARTIAL_CHARGE", 0.041), f +assert p["2026-09-02"]["facts"]["trend"] == "BETTER" # PARTIAL_CHARGE -> FULL_CHARGE +# Même état : la fin de nuit décide. +f = p["2026-09-16"]["facts"] +assert (f["trend"], f["decided_by"], f["delta_night_end_v"], f["delta_max_v"], f["delta_hours_full"]) == \ + ("WORSE", "night_end", -0.103, -0.052, 0), f +assert p["2026-09-22"]["facts"]["trend"] == "STABLE" # -0,016 V : dans la zone morte (limite 2 de la fiche) +assert p["2026-10-01"]["facts"]["trend"] == "BETTER" # +0,284 V, jour de coupure (limite 1 de la fiche) +# Jours sains : FULL_CHARGE enchaînés presque tous STABLE. +full = Counter(q["facts"]["trend"] for q in r["points"] if q["facts"]["state_prev"] == q["facts"]["state"] == "FULL_CHARGE") +assert full == {"STABLE": 120, "BETTER": 4, "WORSE": 1}, full +print(" ".join(d[5:] for d, q in sorted(p.items()) if q["facts"]["trend"] == "WORSE" and d >= "2026-08-01")) +print("OK") +EOF +``` +Expected : `ModuleNotFoundError: No module named 'battery_trend'`. + +- [ ] **Step 2 : créer `src/battery_trend.py`** + +```python +"""Analyse 04 DAILY_BATTERY_TREND : tendance de la batterie d'un jour à l'autre (modèle markovien : J face à J−1). + +Documentation : docs/analyses/analyse_04.md +Bibliothèque standard uniquement (cible : système embarqué de la station). +""" +from datetime import timedelta + +import battery_state as bs + +# Constantes (fiche analyse_04, « Constantes et sources »). +NIGHT_END_DEADBAND_V = 0.05 # VERMONT : FULL_CHARGE enchaînés, écart de fin de nuit -0,026 à +0,043 V (5e-95e centiles, 125 paires) +STATE_RANK = {"FULL_CHARGE": 3, "PARTIAL_CHARGE": 2, "NO_CHARGE": 1, "BELOW_PLATEAU": 0} # choix de conception (fiche 04) + +RULE = { + "id": "DAILY_BATTERY_TREND", + "verdict": "aucun : anomaly = None ; la tendance est dans facts.trend", + "night_end_deadband_v": NIGHT_END_DEADBAND_V, + "state_rank": STATE_RANK, + "doc": "docs/analyses/analyse_04.md", +} + + +def delta(prev, cur, key): + """Écart cur − prev d'un fait de DAILY_BATTERY_STATE, None si l'un des deux manque.""" + if prev.get(key) is None or cur.get(key) is None: + return None + return round(cur[key] - prev[key], 3) # arrondi au mV avant la comparaison à la zone morte + + +def run(series): + """Analyse DAILY_BATTERY_TREND, causale : le jour J n'utilise que J et J−1. Un point par jour UTC.""" + points, prev = [], None + for p in bs.run(series)["points"]: + a = prev["facts"] if prev and p["t"].date() - prev["t"].date() == timedelta(days=1) else {} # J−1, sinon rien + b = p["facts"] + facts = {"trend": None, "decided_by": None, "state_prev": a.get("state"), "state": b["state"], + "delta_night_end_v": delta(a, b, "night_end_v"), "delta_max_v": delta(a, b, "max_v"), + "delta_hours_full": delta(a, b, "hours_full")} + if facts["state_prev"] and facts["state"]: + if facts["state_prev"] != facts["state"]: # l'état a changé : il décide + up = STATE_RANK[facts["state"]] > STATE_RANK[facts["state_prev"]] + facts.update(trend="BETTER" if up else "WORSE", decided_by="state") + else: # même état : la fin de nuit décide, avec une zone morte + d = facts["delta_night_end_v"] + trend = "BETTER" if d > NIGHT_END_DEADBAND_V else "WORSE" if d < -NIGHT_END_DEADBAND_V else "STABLE" + facts.update(trend=trend, decided_by="night_end") + points.append({"t": p["t"], "value": facts["delta_night_end_v"], "anomaly": None, "facts": facts}) + prev = p + return {"analysis": RULE["id"], "rule": RULE, "points": points} +``` + +- [ ] **Step 3 : relancer la commande du Step 1** + +Expected : la première ligne est `DAILY_BATTERY_TREND 184 {None: 1, 'STABLE': 137, 'WORSE': 26, 'BETTER': 20}`. L'avant-dernière ligne est `08-03 08-15 08-18 08-29 08-30 09-06 09-08 09-10 09-12 09-16 09-20 09-21 09-25 09-26 09-27 10-02 10-09`, puis vient `OK`. Garder ces valeurs pour la fiche (tâche 3). + +- [ ] **Step 4 : commit** + +```bash +cd /home/maxime/Support-Agent && git add src/battery_trend.py && git commit -q -F - <<'EOF' +Add analysis 04 DAILY_BATTERY_TREND computation + +Day-over-day trend from DAILY_BATTERY_STATE: a state change decides +(FULL > PARTIAL > NO_CHARGE > BELOW_PLATEAU), otherwise the night-end +voltage delta with a 0.05 V dead band. No verdict (anomaly = None). + +Co-Authored-By: Claude Opus 5.5 +EOF +``` + +--- + +### Task 2 : panneau du graphique + +**Files :** +- Modify : `src/energy_plot.py` (docstring ligne 3, imports, nouvelle constante `TREND_STYLE` et fonction `daily_trend_panel` avant `gaps()`, boucle des analyses dans `figure()`, `update_layout` de `figure()`, liste des résultats dans `main()`) + +**Interfaces :** +- Consomme : `battery_trend.run(series)` et `battery_trend.RULE` (tâche 1). Champs utilisés : `value`, `facts.trend`, `facts.decided_by`, `facts.state_prev`, `facts.state`, les trois `facts.delta_*`, et la clé de règle `night_end_deadband_v`. +- Produit : `energy_plot.daily_trend_panel(fig, result, row)`. `figure()` dessine ce panneau pour tout résultat dont `analysis == battery_trend.RULE["id"]`. + +- [ ] **Step 1 : lancer la commande de vérification (elle échoue tant que le panneau n'existe pas)** + +Run : +```bash +cd /home/maxime/Support-Agent && .venv/bin/python src/energy_plot.py data/ && python3 - <<'EOF' +import re +h = open("out/VERMONT_energy.html").read() +print(sorted(set(re.findall(r'"text":"Analyse [^"]*"', h)))) +assert '"text":"Analyse DAILY_BATTERY_TREND"' in h +for n in ("zone morte \\u00b10.05 V", "mieux", "stable", "pire"): # plotly écrit « ± » en ± + assert f'"name":"{n}"' in h, n +assert '"barmode":"overlay"' in h +print("OK") +EOF +``` +Expected : `AssertionError` (le titre `Analyse DAILY_BATTERY_TREND` est absent). + +- [ ] **Step 2 : importer le module de calcul et mettre à jour la docstring** + +Dans `src/energy_plot.py`, sous `import battery_state as bs` : + +```python +import battery_trend as bt +``` + +Ligne 3, remplacer : +`Documentation : docs/analyses/analyse_01.md, docs/analyses/analyse_02.md, docs/analyses/analyse_03.md` +par : +`Documentation : docs/analyses/analyse_01.md à analyse_04.md` + +- [ ] **Step 3 : ajouter le style des tendances et le panneau, juste avant `def gaps(v):`** + +```python +# Tendances de DAILY_BATTERY_TREND : paire divergente bleu/rouge et gris neutre du skill dataviz +# (vert/rouge refusé par son validateur : deutéranopie, ΔE 5,9). Chaque tendance a aussi sa légende et son survol. +TREND_STYLE = {"BETTER": ("mieux", "#2a78d6"), "STABLE": ("stable", "#8c8c8c"), "WORSE": ("pire", "#d03b3b")} + + +def daily_trend_panel(fig, result, row): + """Panneau DAILY_BATTERY_TREND : écart de fin de nuit J − J−1 en barres, couleur = tendance (fiche analyse_04).""" + group = dict(legendgroup=result["analysis"], legendgrouptitle_text=f"Analyse {result['analysis']}") + pts, db = result["points"], result["rule"]["night_end_deadband_v"] + x = [p["t"] for p in pts] + # Zone morte tracée comme une courbe (un point par jour, None entre +db et −db) : visible au zoom (D-013). + fig.add_scatter(x=x + [None] + x, y=[db] * len(x) + [None] + [-db] * len(x), name=f"zone morte ±{db} V", + mode="lines", hoverinfo="skip", line=dict(color="#52514e", dash="dash", width=1), + row=row, col=1, **group) + for trend, (label, color) in TREND_STYLE.items(): + sel = [p for p in pts if p["facts"]["trend"] == trend and p["value"] is not None] + if not sel: + continue + hover = [f"{p['t']:%Y-%m-%d} : {label} (décidé par {p['facts']['decided_by']})
" + f"{p['facts']['state_prev']} → {p['facts']['state']}
" + + "
".join(f"{k}={v}" for k, v in p["facts"].items() if k.startswith("delta")) for p in sel] + fig.add_bar(x=[p["t"] for p in sel], y=[p["value"] for p in sel], name=label, marker_color=color, + width=0.8 * 86_400_000, hovertext=hover, hovertemplate="%{hovertext}", + row=row, col=1, **group) + fig.update_yaxes(title_text="Δ fin de nuit [V]", row=row, col=1) +``` + +Notes pour l'implémenteur : +- `hovertext` et non `text` : sur une barre, plotly écrit `text` dans la barre ; +- `width` est en millisecondes sur un axe de dates : 0,8 jour. + +- [ ] **Step 4 : brancher le panneau dans `figure()`** + +Remplacer : + +```python + if result["analysis"] == bs.RULE["id"]: + daily_state_panel(fig, result, row) + continue +``` + +par : + +```python + if result["analysis"] == bs.RULE["id"]: + daily_state_panel(fig, result, row) + continue + if result["analysis"] == bt.RULE["id"]: + daily_trend_panel(fig, result, row) + continue +``` + +Dans le `fig.update_layout(...)` de `figure()`, remplacer : + +```python + legend=dict(groupclick="toggleitem")) +``` + +par : + +```python + barmode="overlay", legend=dict(groupclick="toggleitem")) +``` + +En mode `group` (le défaut), plotly décalerait et amincirait les barres des trois tendances, comme s'il fallait les placer côte à côte. + +- [ ] **Step 5 : ajouter le résultat dans `main()`** + +Remplacer : + +```python + figure(station, series, [ec.run(series), ec.run_midnight(series), bs.run(series)]).write_html( +``` + +par : + +```python + figure(station, series, [ec.run(series), ec.run_midnight(series), bs.run(series), bt.run(series)]).write_html( +``` + +- [ ] **Step 6 : relancer la commande du Step 1** + +Expected : la liste des titres contient `Analyse DAILY_BATTERY_TREND`, puis `OK`. + +- [ ] **Step 7 : vérification visuelle** + +Run : `cd /home/maxime/Support-Agent && python3 src/analyse_01.py` (la page s'ouvre dans le navigateur). +À vérifier à l'œil : +- le quatrième panneau se trouve sous `DAILY_BATTERY_STATE`, avec des barres d'environ un jour de large, non décalées ; +- la zone morte est en tirets à +0,05 et −0,05 V ; +- au survol d'une barre, on lit la tendance, ce qui l'a décidée, l'état de la veille puis celui du jour, et les trois écarts ; +- en zoomant sur septembre 2026, l'ordonnée se recale, et les barres comme la zone morte restent visibles ; +- les barres rouges se répètent en septembre ; le 29/08 est rouge malgré une barre positive (l'état décide). + +- [ ] **Step 8 : commit** + +```bash +cd /home/maxime/Support-Agent && git add src/energy_plot.py && git commit -q -F - <<'EOF' +Plot DAILY_BATTERY_TREND as the fourth analysis panel + +One bar per day for the night-end voltage delta, coloured by trend +(blue better, grey stable, red worse), with the 0.05 V dead band. + +Co-Authored-By: Claude Opus 5.5 +EOF +``` + +--- + +### Task 3 : point d'entrée et documentation + +**Files :** +- Create : `src/analyse_04.py` +- Modify : `src/analyse_01.py:2` (docstring) +- Modify : `docs/analyses/analyse_04.md` (statut, graphique, résultats, options écartées, historique) +- Modify : `docs/analyses/analyse_01.md:43` (section « Graphique ») +- Modify : `CLAUDE.md` (« État et prochaine étape », tableau « Analyses », « Commandes », « Fichiers », contrat commun dans « Principes ») +- Modify : `.claude/rules/analyses.md:17` (contrat commun) +- Modify : `README.md:33` (analyses en place) + +**Interfaces :** +- Consomme : la page commune produite par `analyse_01.py` (tâche 2) ; les valeurs imprimées au Step 3 de la tâche 1. +- Produit : la commande `python3 src/analyse_04.py`. + +- [ ] **Step 1 : créer `src/analyse_04.py`** + +```python +"""Analyse 04 : DAILY_BATTERY_TREND (tendance de la batterie d'un jour à l'autre, J face à J−1). + +Son graphique est le quatrième panneau d'analyse de la page commune : ce script lance analyse_01.py. +Usage : python3 src/analyse_04.py [CSV ou dossiers...] (défaut : data/, sortie dans out/) +Documentation : docs/analyses/analyse_04.md +""" +import runpy +from pathlib import Path + +runpy.run_path(str(Path(__file__).with_name("analyse_01.py")), run_name="__main__") +``` + +- [ ] **Step 2 : lancer le point d'entrée** + +Run : `cd /home/maxime/Support-Agent && python3 src/analyse_04.py` +Expected : `/home/maxime/Support-Agent/out/VERMONT_energy.html`, et la page s'ouvre dans le navigateur. + +- [ ] **Step 3 : docstring de `src/analyse_01.py`** + +Remplacer la ligne 2 : +`La page montre aussi, dessous, les analyses 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP) et 03 (DAILY_BATTERY_STATE).` +par : +`La page montre aussi, dessous, les analyses 02 (MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP), 03 (DAILY_BATTERY_STATE) et 04 (DAILY_BATTERY_TREND).` + +- [ ] **Step 4 : fiche `docs/analyses/analyse_04.md`** + +- Statut : `` **Statut** : prototype en place (2026-10-12). Pas de verdict : `anomaly = None`, la tendance est dans `facts.trend`. `` +- Section « Graphique », dans le premier point de « Contenu », remplacer `(vert : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre)` par : + `(bleu : mieux ; gris : stable ; rouge : pire ; tendance inconnue : pas de barre). Ce sont la paire divergente et le gris neutre du skill dataviz.` +- Section « Résultats sur VERMONT (jeu de travail) » : remplacer tout le contenu de la section par : + +```markdown +Sur 184 jours (du 2026-04-09 au 2026-10-09) : +- **Répartition** : 137 `STABLE`, 26 `WORSE`, 20 `BETTER`, 1 UNKNOWN (le 2026-04-09, premier jour de l'export, sans veille). +- **Jours sains** : sur 125 paires `FULL_CHARGE` enchaînées, 120 sont `STABLE`, 4 `BETTER` et 1 `WORSE`. +- **`WORSE` isolés en août** (08-03, 08-15, 08-18) : des jours nuageux, chacun suivi d'un `BETTER`. +- **Fin août à septembre** : des `WORSE` répétés (08-29, 08-30, 09-06, 09-08, 09-10, 09-12, 09-16, 09-20, 09-21, puis 09-25 à 09-27, passage sous le plateau). Chacun est suivi d'un `BETTER` le jour d'une pleine charge. C'est cohérent avec l'expert : charges complètes de plus en plus rares, puis déficit vers le 20/09. +- **L'état décide contre la fin de nuit** : le 2026-08-29 (`FULL_CHARGE` → `PARTIAL_CHARGE`) est `WORSE`, alors que la fin de nuit monte de +0,041 V. +- **Sous le plateau** (du 26/09 au 09/10) : des `BETTER` les 01/10, 03/10 et 08/10, faux (limite 1). +``` + + Si les valeurs imprimées au Step 3 de la tâche 1 diffèrent, reporter celles-là. +- Section « Options écartées », ajouter la ligne : + `| Vert pour « mieux » (design validé en brainstorming) | Refusé par le validateur du skill dataviz : vert `#008300` et rouge `#d03b3b` ne se distinguent pas en deutéranopie (ΔE 5,9, sous le plancher de 6). Remplacé par le bleu de la paire divergente. |` +- Historique, ajouter : + `` - **2026-10-12** : implémentée (`src/battery_trend.py`, panneau dans `energy_plot.py`, point d'entrée `analyse_04.py`). Résultats conformes à l'essai de conception, à un UNKNOWN près (le premier jour, sans veille). Couleur de « mieux » : bleu au lieu de vert (skill dataviz). `` + +- [ ] **Step 5 : fiche `docs/analyses/analyse_01.md`, section « Graphique »** + +Après la ligne 43 (« **Puis le panneau de l'analyse 03**… »), ajouter : +`` - **Puis le panneau de l'analyse 04** (`DAILY_BATTERY_TREND`) : tendance de la batterie d'un jour à l'autre (fiche `analyse_04.md`). `` + +- [ ] **Step 6 : `CLAUDE.md`** + +- « État et prochaine étape » : avant la ligne « **Prochaine étape** », ajouter : + `` - **2026-10-12** : analyse 04 `DAILY_BATTERY_TREND` en place (tendance markovienne : chaque jour face à la veille, mieux / stable / pire). `` + Remplacer la ligne « **Prochaine étape** » par : + `` - **Prochaine étape** : phase B de l'analyse 03 (niveaux gradués à partir des séries d'états et des tendances de la 04, voir les pistes des fiches), puis la combinaison des analyses. `` +- Tableau « Analyses », ajouter après la ligne 03 : + `` | 04 | `DAILY_BATTERY_TREND` | Chaque jour, face à la veille : mieux, stable ou pire (changement d'état, sinon écart de fin de nuit) ? | prototype en place | `docs/analyses/analyse_04.md` | `` +- « Commandes » : + - dans la ligne `analyse_01.py`, remplacer `(panneaux des analyses 01, 02 et 03, D-016)` par `(panneaux des analyses 01 à 04, D-016)` ; + - après la ligne `analyse_03.py`, ajouter : `` - `python3 src/analyse_04.py` : point d'entrée de l'analyse 04 ; il lance la même page. `` +- « Fichiers », ligne `src/analyse_NN.py` : remplacer `` `src/battery_state.py` (analyse 03, idem) `` par `` `src/battery_state.py` (analyse 03, idem), `src/battery_trend.py` (analyse 04, idem) ``. +- « Principes », contrat commun : remplacer + `(exception : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`)` + par + `(exception : analyses 03 en phase C et 04, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state` ou `facts.trend`)`. + +- [ ] **Step 7 : `.claude/rules/analyses.md`, ligne 17** + +Remplacer : +`` - `anomaly = None` signifie UNKNOWN (exception : analyse 03 en phase C, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state`) ; `` +par : +`` - `anomaly = None` signifie UNKNOWN (exception : analyses 03 en phase C et 04, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state` ou `facts.trend`) ; `` + +- [ ] **Step 8 : `README.md`, ligne 33** + +Remplacer `Trois analyses sont en place :` par `Quatre analyses sont en place :`, et `` `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour. `` par `` `DAILY_BATTERY_STATE`, l'état de la batterie jour par jour ; `DAILY_BATTERY_TREND`, sa tendance d'un jour à l'autre. `` + +- [ ] **Step 9 : contrôle de cohérence** + +Run : `cd /home/maxime/Support-Agent && grep -n "en conception\|vert : mieux" CLAUDE.md docs/analyses/analyse_04.md; grep -c "analyse_04.py" CLAUDE.md; wc -l CLAUDE.md` +Expected : aucune ligne pour le premier `grep` ; `1` pour le second ; moins de 200 lignes pour `CLAUDE.md`. + +- [ ] **Step 10 : commit** + +```bash +cd /home/maxime/Support-Agent && git add src/analyse_04.py src/analyse_01.py docs/analyses/analyse_04.md docs/analyses/analyse_01.md CLAUDE.md .claude/rules/analyses.md README.md && git commit -q -F - <<'EOF' +Add analysis 04 entry point and documentation + +src/analyse_04.py launches the common page; sheet 04 moves to +"prototype en place" with VERMONT results; CLAUDE.md, the analyses +rule, README and sheet 01 list the fourth panel and extend the +"no verdict" contract exception to analysis 04. + +Co-Authored-By: Claude Opus 5.5 +EOF +```