Files
Support-Agent/docs/superpowers/plans/2026-10-12-daily-battery-trend.md
T
2026-10-12 11:31:32 +02:00

429 lines
24 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 <noreply@anthropic.com>`.
## 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 <noreply@anthropic.com>
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']})<br>"
f"{p['facts']['state_prev']} → {p['facts']['state']}<br>"
+ "<br>".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}<extra></extra>",
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 <noreply@anthropic.com>
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 <noreply@anthropic.com>
EOF
```