@sylad/cadence 1.39.0 → 1.40.0

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
     {
       "name": "cadence",
       "description": "Session start and close rituals driven by a versioned plan (raf), and deliveries proven by their effect. Needs the cadence CLI (npm i -g @sylad/cadence).",
-      "version": "1.39.0",
+      "version": "1.40.0",
       "source": "./",
       "author": {
         "name": "Sylvain Ladoire"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cadence",
   "description": "A repo-native working method: session start and close rituals driven by a versioned plan (raf), deliveries proven by their effect, and three reviewer agents (UX, code, QA).",
-  "version": "1.39.0",
+  "version": "1.40.0",
   "author": { "name": "Sylvain Ladoire" },
   "homepage": "https://github.com/Sylad/cadence",
   "repository": "https://github.com/Sylad/cadence",

package/README.md

@@ -4,6 +4,7 @@ A small working method that lives in your repository: a versioned plan linked to
 waves of fresh AI sessions driven by a program, and deliveries proved by their effect.
 It is for solo developers and AI-assisted sessions who lose track of *what is left to do* and *what each commit was for*:
 cadence keeps both in plain files next to the code, and [Claude Code](https://claude.com/claude-code) skills turn it into rituals.
+New to the words (lot, wave, hold…)? [docs/concepts.md](docs/concepts.md) explains each notion, with four figures.
 
 ## Start
 
@@ -15,8 +16,7 @@ raf init
 raf add "My first lot" --estimate 1
 ```
 
-Then `raf start L1`, commit with `feat(L1): …`, `raf now` to see where you are, `raf done L1` when it is finished.
-`raf -v` prints the installed version. Every command is in [docs/raf.md](docs/raf.md).
+Then `raf start L1`, commit with `feat(L1): …`, `raf now` to see where you are, `raf done L1` when finished. Every command: [docs/raf.md](docs/raf.md).
 
 ## Lead several projects in 10 minutes
 
@@ -53,7 +53,7 @@ Details: [docs/skills.md](docs/skills.md) and [docs/cadence-hud.md](docs/cadence
 - [docs/deliver.md](docs/deliver.md): wait for the CI, deploy, verify the effect; [docs/remote-gate.md](docs/remote-gate.md): the gate on another machine.
 - [docs/spec.md](docs/spec.md): screen and back-end sheets.
 - [docs/ref.md](docs/ref.md): reference documents (specs, norms, mock-ups) and the coverage of their elements by the lots.
-- [docs/lead.md](docs/lead.md): the lead workflow, and the `livreur` agent that delivers a ready lot for it.
+- [docs/lead.md](docs/lead.md): the lead workflow, the `livreur` agent, and [the memory index warning](docs/session.md#memory-index-size-l442) (L442).
 - [docs/overview.md](docs/overview.md): the longer introduction and the map of every page; [docs/fonctionnement.md](docs/fonctionnement.md): how it works.
 - [docs/stabilite.md](docs/stabilite.md): what is guaranteed from 1.0.0; [docs/qualite.md](docs/qualite.md): the code-quality ratchet.
 - [docs/whats-new.md](docs/whats-new.md) and [CHANGELOG.md](CHANGELOG.md): what changed.

package/dist/cli.js

@@ -24,6 +24,7 @@ import { schedule } from './schedule.js';
 import { AGENTS_DIR, installAgents, installSkills, SKILLS_DIR } from './skills.js';
 import { configSet } from './config-set.js';
 import { movePriority } from './priority.js';
+import { closeMemoryLines, tourMemoryLines } from './memory-index.js';
 import { findProjects, isProject, readDepth, leadTour, TITLE_MAX, truncate, readLeadUx, tourFreeLine, readLeadContextThreshold, findLeadDir, tourLine, tourNoTestLines, tourWorktreeLines } from './lead.js';
 import { configuredCap, expiredHoldLines, slotsLine, orchestrate, realOrchestrateDeps } from './orchestrate/command.js';
 import { addHold, releaseHold } from './orchestrate/registry.js';
@@ -270,7 +271,8 @@ function dispatch(argv, io) {
             for (const r of rows)
                 io.out(tourLine(r));
             // les worktrees de lot que des vagues ont conservés : aucun n'est oublié en silence (L279, R19)
-            for (const l of tourWorktreeLines(rows, io.now().getTime()))
+            // … puis l'index MEMORY.md du dossier, s'il pèse trop (L442) : le lead propose le regroupement, rien n'est écrit
+            for (const l of [...tourWorktreeLines(rows, io.now().getTime()), ...tourMemoryLines(io.env, parent)])
                 io.out(l);
             // un projet sans orchestrate.test : la vague ne lancera pas la suite (L327)
             for (const l of tourNoTestLines(rows))
@@ -779,7 +781,7 @@ function dispatch(argv, io) {
             const sconf = rest[0] === 'start' || rest[0] === 'close' ? readSessionConfig(configPath) : {};
             const facts = rest[0] === 'start' || rest[0] === 'close' ? sconf[rest[0]] : undefined;
             const clean = rest[0] === 'close' && sconf.clean ? { patterns: sconf.clean, days: sconf.cleanDays } : undefined;
-            const sctx = { plan: loadPlan(), root, newsDir, state: stateDir(root), shared: sharedStateDir(root), today, now: io.now(), out: io.out, facts, clean };
+            const sctx = { plan: loadPlan(), root, newsDir, state: stateDir(root), shared: sharedStateDir(root), today, now: io.now(), out: io.out, facts, clean, memory: closeMemoryLines(io.env, io.cwd, configPath) };
             if (rest[0] !== 'start')
                 return session(rest, sctx, values);
             // La reprise rejoue les vérifications d'effet (un essai, borné) : un effet rouge d'hier se lit avec les faits du matin.

package/dist/config-set.js

@@ -7,6 +7,7 @@ import { defaultPlan, readDocsConfig, readHookConfig, readMigrateConfig, readNew
 import { parseDeliverConfig } from './deliver.js';
 import { commitPaths, dirtyPaths, gitRoot, restorePaths } from './git.js';
 import { findProjects, isProject, readDepth, readLeadContextThreshold, readLeadUx } from './lead.js';
+import { readMemoryIndexMax } from './memory-index.js';
 import { readPriority } from './orchestrate/continue.js';
 import { Plan, RafError } from './plan.js';
 const KEY = /^[A-Za-z0-9_-]+(\.[A-Za-z0-9_-]+)*$/;
@@ -25,6 +26,7 @@ export function validateConfig(file, root) {
     readDocsConfig(file);
     readReferencesConfig(file);
     readMigrateConfig(file);
+    readMemoryIndexMax(file);
     readLeadUx(dirname(file));
     readLeadContextThreshold(dirname(file));
     readDepth(dirname(file));

package/dist/memory-index.js

@@ -0,0 +1,113 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse } from 'yaml';
+import { RafError } from './plan.js';
+import { claudeConfigDir, projectLogDir } from './orchestrate/launch.js';
+/** Taille (octets) au-delà de laquelle l'index MEMORY.md est signalé quand `memory.indexMaxBytes` n'est pas posé (L442). */
+const MEMORY_INDEX_MAX_BYTES = 12_000;
+/** L'index de la mémoire de Claude Code du dossier `dir` (celui où la session est lancée, jamais la racine git). */
+function memoryIndexPath(env, dir) {
+    return join(projectLogDir(claudeConfigDir(env), dir), 'memory', 'MEMORY.md');
+}
+// « - », puis au plus « ** », « [ » et « ⚠ », puis un jour « jj-mm » : le nom du fichier lié ne compte pas.
+const DATED = /^- (?:\*\*)?\[?(?:⚠️?\s*)?(?:0[1-9]|[12]\d|3[01])-(?:0[1-9]|1[0-2])(?!\d)/;
+/** Les entrées datées d'un index : leur nombre et leur poids en octets (fin de ligne comprise). */
+function datedEntries(text) {
+    let count = 0;
+    let bytes = 0;
+    const lines = text.replace(/^\uFEFF/, '').split('\n');
+    for (const [i, line] of lines.entries()) {
+        const bare = line.replace(/\r$/, '');
+        if (!DATED.test(bare))
+            continue;
+        count++;
+        // la fin de ligne ne compte que si elle existe : la dernière ligne peut ne pas en avoir
+        bytes += Buffer.byteLength(line) + (i < lines.length - 1 ? 1 : 0);
+    }
+    return { count, bytes };
+}
+/** Mesure l'index : absent ou au plus égal au seuil = `ok` ; une lecture impossible se dit au lieu de lever. Ne modifie rien. */
+function checkMemoryIndex(env, dir, max) {
+    let buf;
+    try {
+        buf = readFileSync(memoryIndexPath(env, dir));
+    }
+    catch (e) {
+        const code = e.code;
+        return code === 'ENOENT' ? { kind: 'ok' } : { kind: 'unreadable', cause: e.message.split('\n')[0] };
+    }
+    if (buf.length <= max)
+        return { kind: 'ok' };
+    return { kind: 'over', size: buf.length, max, ...datedEntries(buf.toString('utf8')) };
+}
+const NO_DATED = "aucune entrée datée à regrouper dans l'index MEMORY.md";
+/** Les lignes de la section « Mémoire » de `session close`, précédée d'une ligne vide (aucune quand l'index est sain). */
+function closeLines(c) {
+    if (c.kind === 'ok')
+        return [];
+    if (c.kind === 'unreadable')
+        return [`\nMémoire : l'index MEMORY.md est illisible (${c.cause}), sa taille n'est pas contrôlée`];
+    return [
+        `\nMémoire : l'index MEMORY.md pèse ${c.size} octets (seuil ${c.max})`,
+        c.count === 0
+            ? `  ${NO_DATED}`
+            : `  ${c.count} entrée(s) datée(s) (${c.bytes} octets) à regrouper sous une ligne vers un index secondaire — le skill propose, l'humain décide`,
+    ];
+}
+function tourLines(c) {
+    if (c.kind === 'ok')
+        return [];
+    if (c.kind === 'unreadable')
+        return [`mémoire · MEMORY.md illisible (${c.cause})`];
+    const tail = c.count === 0 ? 'aucune entrée datée à regrouper' : `${c.count} entrée(s) datée(s) à regrouper (cadence session close détaille)`;
+    return [`mémoire · MEMORY.md ${c.size} octets > seuil ${c.max} · ${tail}`];
+}
+/**
+ * Clé `memory.indexMaxBytes` de cadence.yaml : seuil, en octets, de l'avertissement ; `undefined` quand elle est absente.
+ * Une valeur qui n'est pas un entier ≥ 1 est refusée.
+ */
+export function readMemoryIndexMax(file) {
+    if (!existsSync(file))
+        return undefined;
+    let raw;
+    try {
+        raw = parse(readFileSync(file, 'utf8'));
+    }
+    catch (e) {
+        throw new RafError(`${file} illisible : ${e.message.split('\n')[0]}`);
+    }
+    const m = raw?.memory;
+    if (m == null)
+        return undefined;
+    if (typeof m !== 'object' || Array.isArray(m))
+        throw new RafError(`${file} : memory doit être un objet { indexMaxBytes }`);
+    for (const k of Object.keys(m))
+        if (k !== 'indexMaxBytes')
+            throw new RafError(`${file} : memory.${k} inconnu (attendu : indexMaxBytes)`);
+    const v = m.indexMaxBytes;
+    if (v === undefined)
+        return undefined;
+    if (typeof v !== 'number' || !Number.isInteger(v) || v < 1)
+        throw new RafError(`${file} : memory.indexMaxBytes doit être un entier ≥ 1 (octets), pas ${typeof v === 'object' ? JSON.stringify(v) : String(v)}`);
+    return v;
+}
+/**
+ * Pour `session close` : le contexte de la mesure, relu à l'appel (une clé invalide lève alors avant tout rapport). Le seuil vient
+ * du `cadence.yaml` que la commande lit.
+ */
+export function closeMemoryLines(env, dir, configFile) {
+    return () => closeLines(checkMemoryIndex(env, dir, readMemoryIndexMax(configFile) ?? MEMORY_INDEX_MAX_BYTES));
+}
+/**
+ * Pour `lead tour` : la ligne « mémoire » du dossier parent, avec le seuil de son cadence.yaml. Une clé invalide n'arrête pas le tour : une ligne d'erreur
+ * remplace la ligne « mémoire » ; un cadence.yaml illisible a déjà sa ligne d'erreur en tête de tour et n'en ajoute pas ici.
+ */
+export function tourMemoryLines(env, parent) {
+    try {
+        return tourLines(checkMemoryIndex(env, parent, readMemoryIndexMax(join(parent, 'cadence.yaml')) ?? MEMORY_INDEX_MAX_BYTES));
+    }
+    catch (e) {
+        const message = e.message;
+        return / : memory/.test(message) ? [`cadence.yaml · ✗ erreur : ${message.replace(/^.*cadence\.yaml : /, '')}`] : [];
+    }
+}

package/dist/orchestrate/cycle.js

@@ -1300,18 +1300,21 @@ function summarize(rep, head, repoHeads) {
     const majeurs = Math.max(rep.majeurs, count('majeur'));
     return { conforme: bloquants === 0 && majeurs === 0, bloquants, majeurs, mineurs: Math.max(rep.mineurs, count('mineur')), verdict: rep.verdict.trim(), sousTaches: rep.sousTaches, nonVerifie: rep.nonVerifie, head, ...(repoHeads ? { repoHeads } : {}) };
 }
-function propose(c, text) {
+function propose(c, text, head) {
     if (!c.lot.proposals.includes(text))
         c.lot.proposals.push(text);
+    if (head)
+        (c.lot.proposalHeads ??= {})[text] ??= head;
 }
 const minorLine = (source, k) => `[mineur ${source}] ${k.fichier ? `${k.fichier}${k.ligne ? `:${k.ligne}` : ''} — ` : ''}${k.texte}`;
 const withoutLine = (line) => line.replace(/^(\[mineur \w+\] .*?):\d+ — /, '$1 — ');
-function addProposals(c, rep, source, withMinors = true) {
+function addProposals(c, rep, source, head, withMinors = true) {
     if (withMinors)
         for (const k of rep.constats.filter((k) => k.gravite === 'mineur'))
             propose(c, minorLine(source, k));
-    for (const t of rep.sousTaches)
-        propose(c, `[sous-tâche ${source}] ${t}`);
+    // La première revue qui émet la proposition en garde la date : une revue suivante qui la redit ne la rajeunit pas.
+    for (const t of rep.sousTaches.map((t) => `[sous-tâche ${source}] ${t}`))
+        propose(c, t, head);
 }
 function minorConstats(rep) {
     return rep.constats.filter((k) => k.gravite === 'mineur').map((k) => ({ source: 'code', gravite: k.gravite, fichier: k.fichier, ligne: k.ligne, texte: k.texte }));
@@ -1782,7 +1785,7 @@ async function reviewSpecStep(c, r) {
     const summary = summarize(rep, done.after.head ?? '');
     const passes = (l[r.kind]?.passes ?? 0) + 1;
     // Fiche : les mineurs sont des notes du lot (design § 4). Maquette : inchangé (propositions du tableau final).
-    addProposals(c, rep, r.kind, r.kind !== 'fiche');
+    addProposals(c, rep, r.kind, summary.head, r.kind !== 'fiche');
     // Un lot rendu sur le refus d'écrire ses notes (R26) rejoue cette revue à la reprise : le compte des passes n'est posé qu'une fois les notes écrites.
     if (r.kind === 'fiche' && (await noteMinors(c, rep, `la ${r.label}`)))
         return;
@@ -2515,7 +2518,7 @@ async function reviewStep(c, kind) {
     const summary = summarize(rep, done.after.head ?? '', done.others.length ? Object.fromEntries(done.others.map((o) => [o.repo.rel, o.after.head ?? ''])) : undefined);
     if (kind === 'ux') {
         l.ux = summary;
-        addProposals(c, rep, 'ux');
+        addProposals(c, rep, 'ux', summary.head);
         l.uxVerdict = summary.verdict;
         l.constats = blockingConstats(rep, 'ux');
         save(c);
@@ -2569,7 +2572,7 @@ async function reviewStep(c, kind) {
         l.proposals = left;
         l.minorLines = [];
     }
-    addProposals(c, rep, 'code', !minorPass);
+    addProposals(c, rep, 'code', summary.head, !minorPass);
     if (summary.conforme)
         (l.reviewCounts ??= []).push(0); // une revue conforme compte pour 0 dans la comparaison de la convergence (L205)
     if (minorPass) {

package/dist/orchestrate/deja-traitee.js

@@ -0,0 +1,76 @@
+import { changedFiles, isAncestor, resolveCommit } from '../git.js';
+/** Début d'une proposition de sous-tâche d'une revue (`addProposals`) : les seules marquées, un mineur étant déjà une ligne de fichier précise. */
+const SUBTASK = '[sous-tâche ';
+/** Les fichiers que le texte d'une proposition cite (`src/a.ts`, `src/a.ts:42`, `` `docs/z.md` ``), dans l'ordre, sans doublon ; les adresses web et les nombres (`1.5`) n'en sont pas. */
+export function citedFiles(text) {
+    const out = [];
+    for (const raw of text.split(/[\s`'"“”«»(),;*[\]<>]+/)) {
+        const tok = raw.replace(/(:\d+(-\d+)?)+$/, '').replace(/[.:!?]+$/, '').replace(/^(\.\/)+/, '');
+        if (!tok || tok.includes('://') || !/^[\p{L}\p{N}_@.\-/]+\.[A-Za-z][A-Za-z0-9]+$/u.test(tok) || out.includes(tok))
+            continue;
+        out.push(tok);
+    }
+    return out;
+}
+/**
+ * La lecture de git : parmi `commits` (sha du lot, du plus ancien au plus récent), ceux qui ne sont pas dans l'histoire de la revue
+ * `head`, puis le premier qui modifie `file` (chemin entier ou fin de chemin). Un `head` que le dépôt ne connaît pas, ou une
+ * lecture impossible, ne marque rien : mieux vaut une proposition sans marque qu'une marque fausse.
+ */
+export function touchedByLotCommits(commits) {
+    // Une lecture par lot et par commit pour tout le rendu : le tableau pose la question pour chaque couple (proposition, fichier cité).
+    const lotShas = new Map();
+    const files = new Map();
+    const filesOf = (repo, c) => {
+        const key = `${repo}\0${c}`;
+        if (!files.has(key)) {
+            try {
+                files.set(key, changedFiles(repo, c));
+            }
+            catch {
+                files.set(key, null);
+            }
+        }
+        return files.get(key);
+    };
+    return (l, head, file) => {
+        if (!resolveCommit(l.repo, head))
+            return null;
+        if (!lotShas.has(l))
+            lotShas.set(l, commits(l));
+        for (const c of lotShas.get(l)) {
+            if (isAncestor(l.repo, c, head))
+                continue;
+            const changed = filesOf(l.repo, c);
+            if (!changed)
+                return null;
+            if (changed.some((f) => f === file || f.endsWith(`/${file}`)))
+                return c.slice(0, 7);
+        }
+        return null;
+    };
+}
+/**
+ * La ligne de proposition rendue au lead (L422) : une sous-tâche proposée dont un fichier cité a été modifié par un commit du lot
+ * postérieur à la revue qui l'a émise (`l.proposalHeads`) porte « — peut-être déjà traitée (<sha>) » ; les autres lignes sont inchangées.
+ * 28-10 : L230 ouvert sur des propositions déjà corrigées par la passe de correction, 5 passes perdues.
+ */
+export function proposalLine(l, proposal, touched) {
+    const head = l.proposalHeads?.[proposal];
+    if (!proposal.startsWith(SUBTASK) || !head)
+        return proposal;
+    for (const file of citedFiles(proposal)) {
+        let sha = null;
+        try {
+            sha = touched(l, head, file);
+        }
+        catch {
+            continue;
+        }
+        if (sha)
+            return `${proposal} — peut-être déjà traitée (${sha})`;
+    }
+    return proposal;
+}
+/** La lecture à employer : celle que l'appelant donne (tests), sinon git sur les commits du lot (`lotCommits` de l'appelant, sinon `fromGit` : ceux des étapes). */
+export const touchedReader = (deps, fromGit) => deps.touchedSince ?? touchedByLotCommits(deps.lotCommits ?? fromGit);

package/dist/orchestrate/table.js

@@ -5,6 +5,7 @@ export { estimateLines, launchPrices } from './cout.js';
 import { gitRoot, isAncestor } from '../git.js';
 import { repoWork } from '../repos.js';
 import { quotaReset } from './result.js';
+import { proposalLine, touchedReader } from './deja-traitee.js';
 const k = (n) => `${Math.round(n / 1000)} k`;
 const m = (n) => `${(n / 1_000_000).toFixed(1).replace('.', ',')} M`;
 export const LABEL = {
@@ -83,6 +84,15 @@ function gitCommitsOf(l) {
         return [];
     }
 }
+/**
+ * Les commits que les étapes du lot ont notés (entrées `<sha> <sujet>`, du plus ancien au plus récent), à défaut ceux que git lui attribue :
+ * les sha de la revue (`proposalHeads`) et ceux-là sont du même état de la branche, alors que git, lu depuis le HEAD du dépôt, ne voit pas
+ * les commits d'un lot non intégré et ne retrouve, après l'intégration par rebase, que des commits réécrits.
+ */
+function reviewedCommitsOf(l) {
+    const noted = [...new Set(l.steps.flatMap((s) => s.commits ?? []).filter((c) => !c.startsWith('[')).map((c) => c.split(' ')[0]))];
+    return noted.length ? noted : gitCommitsOf(l);
+}
 const sameCommit = (a, b) => a.length >= 4 && b.length >= 4 && (a.startsWith(b) || b.startsWith(a));
 /**
  * Sha des commits du lot dans son dépôt : ceux que git attribue au lot (une session en échec, au rapport illisible ou coupée
@@ -206,7 +216,7 @@ function signalLines(l) {
     return out;
 }
 /** Le détail d'un lot (L441) : ce que le tableau compact de `--status` n'imprime pas et que `--status --detail <lot>` donne. */
-function detailLines(l) {
+function detailLines(l, touched) {
     const out = [];
     if (l.goal)
         out.push(`${l.project}:${l.lot} — objectif donné : ${l.goal}`);
@@ -228,7 +238,7 @@ function detailLines(l) {
     for (const h of l.hypotheses ?? [])
         out.push(`${l.project}:${l.lot} — hypothèse de la fiche : ${h}`);
     for (const p of l.proposals)
-        out.push(`${l.project}:${l.lot} — proposé : ${p}`);
+        out.push(`${l.project}:${l.lot} — proposé : ${proposalLine(l, p, touched)}`);
     if (l.uxVerdict && l.visible)
         out.push(`${l.project}:${l.lot} — verdict UX pour « raf ux » : ${l.uxVerdict}`);
     return out;
@@ -237,7 +247,7 @@ function detailLines(l) {
  * `--status --detail <lot>` (L441) : les lignes de détail d'un lot de la vague, lues dans l'état de la vague (le fichier de chaque lot).
  * `sel` : `projet:lot` ou le seul `lot` s'il est unique dans la vague. Lot inconnu ou ambigu : lève.
  */
-export function renderDetail(lots, sel) {
+export function renderDetail(lots, sel, deps = {}) {
     const hit = lots.filter((l) => `${l.project}:${l.lot}` === sel);
     const found = hit.length ? hit : sel.includes(':') ? [] : lots.filter((l) => l.lot === sel);
     if (found.length === 0)
@@ -245,9 +255,23 @@ export function renderDetail(lots, sel) {
     if (found.length > 1)
         throw new Error(`lot ambigu : ${sel} (${found.map((l) => `${l.project}:${l.lot}`).join(', ')}) : donner projet:lot`);
     const l = found[0];
-    const lines = detailLines(l);
+    const lines = detailLines(l, touchedReader(deps, reviewedCommitsOf));
     return lines.length ? lines : [`${l.project}:${l.lot} — aucun détail (ni objectif, capture, choix, proposition, ni verdict UX)`];
 }
+/** Les lignes de signal et de détail de chaque lot, ajoutées à `out` ; rend les lots qui ont un détail. Compact : les lignes de détail ne sont pas imprimées, seul leur nombre compte, et la marque L422 n'en change pas le nombre : aucune lecture git. */
+function perLotLines(lots, out, deps) {
+    const touched = deps.compact ? () => null : touchedReader(deps, reviewedCommitsOf);
+    const withDetail = [];
+    for (const l of lots) {
+        out.push(...signalLines(l));
+        const lines = detailLines(l, touched);
+        if (lines.length > 0)
+            withDetail.push(`${l.project}:${l.lot}`);
+        if (!deps.compact)
+            out.push(...lines);
+    }
+    return withDetail;
+}
 /** Le tableau de fin de vague (ou de `--status`), une ligne par lot puis le total et les questions. `compact` (L441, `--status`) : sans le détail des lots, une seule ligne renvoie à `--status --detail`. */
 export function renderTable(wave, lots, deps = {}) {
     const cost = costView(lots, deps.prices);
@@ -270,13 +294,7 @@ export function renderTable(wave, lots, deps = {}) {
     for (const d of deliverable(lots, deps.isAncestor ?? isAncestor, deps.lotCommits ?? gitCommitsOf)) {
         out.push(`${d.ready.project}:${d.ready.lot} — livrable jusqu'à ${d.sha} (dernier commit de ${d.ready.lot}, sous ${d.under.lot} ${d.under.status === 'handed-back' || d.under.status === 'failed' ? 'rendu' : LABEL[d.under.status]}) : git push origin ${d.sha}:main && cadence deliver --sha ${d.sha}`);
     }
-    for (const l of lots) {
-        out.push(...signalLines(l));
-        if (deps.compact)
-            continue;
-        out.push(...detailLines(l));
-    }
-    const withDetail = lots.filter((l) => detailLines(l).length > 0).map((l) => `${l.project}:${l.lot}`);
+    const withDetail = perLotLines(lots, out, deps);
     if (deps.compact && withDetail.length)
         out.push(`détail (objectif, captures, base de tests, choix, propositions, verdict UX) : cadence orchestrate --status --detail <projet:lot> — ${withDetail.join(', ')}`);
     return out;

package/dist/session.js

@@ -146,8 +146,14 @@ export function sessionStart(ctx, opts) {
     writeSessionMark(ctx.state, { kind: 'start', at: (ctx.now ?? new Date()).toISOString() });
     return 0;
 }
+/** La section « Mémoire » (L442), calculée avant tout rapport ; vide sans mesure demandée. */
+function memoryLines(ctx) {
+    return ctx.memory?.() ?? [];
+}
 export function sessionClose(ctx, opts) {
     const { plan, out, today } = ctx;
+    // Mesuré avant tout rapport : une clé memory.indexMaxBytes invalide arrête la clôture sans rien imprimer.
+    const memory = memoryLines(ctx);
     out(`${plan.project} — clôture du ${today}`);
     const window = closeWindow(ctx, opts.since);
     const recent = period(ctx, window.since);
@@ -169,6 +175,8 @@ export function sessionClose(ctx, opts) {
     const lock = lockStatus(ctx.shared);
     section(out, 'Dépôt', [repo.line, ...(lock ? [lock.line] : [])]);
     section(out, 'Faits propres au projet', projectFacts(ctx, window.since));
+    // Comme le nettoyage : un avertissement qui propose, hors des points ouverts ; l'index n'est jamais écrit ici.
+    memory.forEach((l) => out(l));
     // Une proposition, pas une condition : rien n'est supprimé ici, le skill demande l'accord. Le
     // nettoyage ne change jamais le verdict et ne fait jamais tomber la clôture.
     if (ctx.clean?.patterns.length) {

package/docs/concepts-livraison-dark.svg

@@ -0,0 +1,32 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1100 300" width="1100" height="300" role="img" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Helvetica,Arial,sans-serif" font-size="13" fill="#e6edf3">
+<title>Delivery up to a sha</title>
+<desc>Commits stack on main in order; the deliverable sha is the last commit of the highest ready lot with no unfinished lot below it, so a handed-back lot blocks the commits above it.</desc>
+<defs><marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#8b949e"/></marker></defs>
+<rect width="1100" height="300" fill="#0d1117"/>
+<text x="20" y="30" text-anchor="start" font-size="11.5" font-weight="600" fill="#8b949e">main, oldest on the left</text>
+<rect x="40" y="60" width="150" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5"/>
+<text x="115" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">a1 · L1</text>
+<text x="115" y="103" text-anchor="middle" font-size="11.5" fill="#8b949e">ready</text>
+<polyline points="190,90 238,90" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<rect x="240" y="60" width="150" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5"/>
+<text x="315" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">a2 · L1</text>
+<text x="315" y="103" text-anchor="middle" font-size="11.5" fill="#8b949e">ready</text>
+<polyline points="390,90 438,90" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<rect x="440" y="60" width="150" height="60" rx="6" fill="#0c2d6b" stroke="#58a6ff" stroke-width="2"/>
+<text x="515" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">b1 · L2</text>
+<text x="515" y="103" text-anchor="middle" font-size="11.5" fill="#8b949e">ready</text>
+<polyline points="590,90 638,90" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<rect x="640" y="60" width="150" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="6 4"/>
+<text x="715" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">c1 · L3</text>
+<text x="715" y="103" text-anchor="middle" font-size="11.5" fill="#8b949e">handed back</text>
+<polyline points="790,90 838,90" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<rect x="840" y="60" width="150" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="6 4"/>
+<text x="915" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">d1 · L4</text>
+<text x="915" y="103" text-anchor="middle" font-size="11.5" fill="#8b949e">ready</text>
+<rect x="40" y="136" width="550" height="4" fill="#58a6ff"/>
+<text x="315" y="160" text-anchor="middle" font-size="11.5" fill="#e6edf3">delivered together</text>
+<text x="315" y="205" text-anchor="middle" font-size="13" font-weight="600" fill="#e6edf3">« livrable jusqu'à b1 »</text>
+<text x="315" y="227" text-anchor="middle" font-size="11.5" font-family="ui-monospace,SFMono-Regular,Menlo,monospace" fill="#8b949e">git push origin b1:main &amp;&amp; cadence deliver --sha b1</text>
+<text x="840" y="160" text-anchor="middle" font-size="11.5" fill="#8b949e">blocked by L3: not pushed, not delivered</text>
+<text x="550" y="270" text-anchor="middle" font-size="11.5" fill="#8b949e">Pushing HEAD would also put the unreviewed lot on main; the CI builds only the tip of a push.</text>
+</svg>

package/docs/concepts-livraison-light.svg

@@ -0,0 +1,32 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1100 300" width="1100" height="300" role="img" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Helvetica,Arial,sans-serif" font-size="13" fill="#1f2328">
+<title>Delivery up to a sha</title>
+<desc>Commits stack on main in order; the deliverable sha is the last commit of the highest ready lot with no unfinished lot below it, so a handed-back lot blocks the commits above it.</desc>
+<defs><marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#57606a"/></marker></defs>
+<rect width="1100" height="300" fill="#ffffff"/>
+<text x="20" y="30" text-anchor="start" font-size="11.5" font-weight="600" fill="#57606a">main, oldest on the left</text>
+<rect x="40" y="60" width="150" height="60" rx="6" fill="#ffffff" stroke="#57606a" stroke-width="1.5"/>
+<text x="115" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#1f2328">a1 · L1</text>
+<text x="115" y="103" text-anchor="middle" font-size="11.5" fill="#57606a">ready</text>
+<polyline points="190,90 238,90" fill="none" stroke="#57606a" stroke-width="1.5" marker-end="url(#arr)"/>
+<rect x="240" y="60" width="150" height="60" rx="6" fill="#ffffff" stroke="#57606a" stroke-width="1.5"/>
+<text x="315" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#1f2328">a2 · L1</text>
+<text x="315" y="103" text-anchor="middle" font-size="11.5" fill="#57606a">ready</text>
+<polyline points="390,90 438,90" fill="none" stroke="#57606a" stroke-width="1.5" marker-end="url(#arr)"/>
+<rect x="440" y="60" width="150" height="60" rx="6" fill="#ddf4ff" stroke="#0969da" stroke-width="2"/>
+<text x="515" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#1f2328">b1 · L2</text>
+<text x="515" y="103" text-anchor="middle" font-size="11.5" fill="#57606a">ready</text>
+<polyline points="590,90 638,90" fill="none" stroke="#57606a" stroke-width="1.5" marker-end="url(#arr)"/>
+<rect x="640" y="60" width="150" height="60" rx="6" fill="#ffffff" stroke="#57606a" stroke-width="1.5" stroke-dasharray="6 4"/>
+<text x="715" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#1f2328">c1 · L3</text>
+<text x="715" y="103" text-anchor="middle" font-size="11.5" fill="#57606a">handed back</text>
+<polyline points="790,90 838,90" fill="none" stroke="#57606a" stroke-width="1.5" marker-end="url(#arr)"/>
+<rect x="840" y="60" width="150" height="60" rx="6" fill="#ffffff" stroke="#57606a" stroke-width="1.5" stroke-dasharray="6 4"/>
+<text x="915" y="86" text-anchor="middle" font-weight="600" font-size="13.5" fill="#1f2328">d1 · L4</text>
+<text x="915" y="103" text-anchor="middle" font-size="11.5" fill="#57606a">ready</text>
+<rect x="40" y="136" width="550" height="4" fill="#0969da"/>
+<text x="315" y="160" text-anchor="middle" font-size="11.5" fill="#1f2328">delivered together</text>
+<text x="315" y="205" text-anchor="middle" font-size="13" font-weight="600" fill="#1f2328">« livrable jusqu'à b1 »</text>
+<text x="315" y="227" text-anchor="middle" font-size="11.5" font-family="ui-monospace,SFMono-Regular,Menlo,monospace" fill="#57606a">git push origin b1:main &amp;&amp; cadence deliver --sha b1</text>
+<text x="840" y="160" text-anchor="middle" font-size="11.5" fill="#57606a">blocked by L3: not pushed, not delivered</text>
+<text x="550" y="270" text-anchor="middle" font-size="11.5" fill="#57606a">Pushing HEAD would also put the unreviewed lot on main; the CI builds only the tip of a push.</text>
+</svg>

package/docs/concepts-lot-dark.svg

@@ -0,0 +1,52 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1100 300" width="1100" height="300" role="img" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI',Helvetica,Arial,sans-serif" font-size="13" fill="#e6edf3">
+<title>Journey of a lot</title>
+<desc>A lot goes through spec, code, review, correction when the review is not compliant, UX if the lot is visible, then ready; below each step, who does it.</desc>
+<defs><marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#8b949e"/></marker></defs>
+<rect width="1100" height="300" fill="#0d1117"/>
+<text x="20" y="26" text-anchor="start" font-size="11.5" font-weight="600" fill="#8b949e">STEP</text>
+<text x="20" y="168" text-anchor="start" font-size="11.5" font-weight="600" fill="#8b949e">WHO</text>
+<rect x="20" y="40" width="160" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="6 4"/>
+<text x="100" y="66" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">spec</text>
+<text x="100" y="83" text-anchor="middle" font-size="11.5" fill="#8b949e">if screen or spec: true</text>
+<rect x="200" y="40" width="160" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5"/>
+<text x="280" y="66" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">code</text>
+<text x="280" y="83" text-anchor="middle" font-size="11.5" fill="#8b949e">test first</text>
+<rect x="380" y="40" width="160" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5"/>
+<text x="460" y="66" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">review</text>
+<text x="460" y="83" text-anchor="middle" font-size="11.5" fill="#8b949e">code</text>
+<rect x="560" y="40" width="160" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="6 4"/>
+<text x="640" y="66" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">correction</text>
+<text x="640" y="83" text-anchor="middle" font-size="11.5" fill="#8b949e">if not compliant</text>
+<rect x="740" y="40" width="160" height="60" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="6 4"/>
+<text x="820" y="66" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">UX</text>
+<text x="820" y="83" text-anchor="middle" font-size="11.5" fill="#8b949e">if visible</text>
+<rect x="920" y="40" width="160" height="60" rx="6" fill="#0c2d6b" stroke="#58a6ff" stroke-width="2"/>
+<text x="1000" y="66" text-anchor="middle" font-weight="600" font-size="13.5" fill="#e6edf3">ready</text>
+<text x="1000" y="83" text-anchor="middle" font-size="11.5" fill="#8b949e">integrated (worktree mode)</text>
+<polyline points="180,70 198,70" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<polyline points="360,70 378,70" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<polyline points="540,70 558,70" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<polyline points="720,70 738,70" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<polyline points="900,70 918,70" fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arr)"/>
+<polyline points="640,40 640,22 460,22 460,38" fill="none" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="5 3" marker-end="url(#arr)"/>
+<text x="550" y="16" text-anchor="middle" font-size="11.5" fill="#8b949e">back to the review after each correction</text>
+<rect x="20" y="180" width="160" height="56" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1"/>
+<text x="100" y="204" text-anchor="middle" font-size="12.5" font-weight="600" fill="#e6edf3">spec-writer</text>
+<text x="100" y="222" text-anchor="middle" font-size="11.5" fill="#8b949e">then reviewer</text>
+<rect x="200" y="180" width="160" height="56" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1"/>
+<text x="280" y="204" text-anchor="middle" font-size="12.5" font-weight="600" fill="#e6edf3">fresh session</text>
+<text x="280" y="222" text-anchor="middle" font-size="11.5" fill="#8b949e">of the program</text>
+<rect x="380" y="180" width="160" height="56" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1"/>
+<text x="460" y="204" text-anchor="middle" font-size="12.5" font-weight="600" fill="#e6edf3">code-reviewer</text>
+<text x="460" y="222" text-anchor="middle" font-size="11.5" fill="#8b949e">agent</text>
+<rect x="560" y="180" width="160" height="56" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1"/>
+<text x="640" y="204" text-anchor="middle" font-size="12.5" font-weight="600" fill="#e6edf3">fresh session</text>
+<text x="640" y="222" text-anchor="middle" font-size="11.5" fill="#8b949e">2 passes, 3 if it converges</text>
+<rect x="740" y="180" width="160" height="56" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1"/>
+<text x="820" y="204" text-anchor="middle" font-size="12.5" font-weight="600" fill="#e6edf3">ux-reviewer</text>
+<text x="820" y="222" text-anchor="middle" font-size="11.5" fill="#8b949e">then the human</text>
+<rect x="920" y="180" width="160" height="56" rx="6" fill="#0d1117" stroke="#8b949e" stroke-width="1"/>
+<text x="1000" y="204" text-anchor="middle" font-size="12.5" font-weight="600" fill="#e6edf3">the lead</text>
+<text x="1000" y="222" text-anchor="middle" font-size="11.5" fill="#8b949e">re-checks, raf done</text>
+<text x="550" y="270" text-anchor="middle" font-size="11.5" fill="#8b949e">Dashed: a conditional step. The program chains the sessions; the verdicts of the review and of the UX pass are recorded in the plan.</text>
+</svg>