Plan analysis 04 DAILY_BATTERY_TREND implementation

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-12 11:31:32 +02:00
1 parent f518881121
commit 722ea0841b
1 file changed
+428
@@ -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 <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
```