@sylad/cadence 1.38.1 → 1.40.0

package/dist/orchestrate/continue.js

@@ -7,6 +7,8 @@ import { gitRoot } from '../git.js';
 import { findProjects, isProject } from '../lead.js';
 import { RafError } from '../plan.js';
 import { lotBudget, projectEnv } from './command.js';
+import { readyFree } from '../ready-free.js';
+import { lotFinished, lotKey } from './state.js';
 import { specScreen } from './spec.js';
 import { STOP_REQUESTED } from './cycle.js';
 /** `--until 18:00` : l'heure d'aujourd'hui (date de `now`) à partir de laquelle la vague ne tire plus de lot. */
@@ -153,3 +155,34 @@ export function stopReason(f) {
         return 'budget épuisé';
     return null;
 }
+/** Lots rendus ou en échec de suite, en comptant depuis le dernier lot de la vague. */
+export function handedBackStreak(all) {
+    let n = 0;
+    for (const l of [...all].reverse()) {
+        if (l.status === 'handed-back' || l.status === 'failed')
+            n++;
+        else
+            break;
+    }
+    return n;
+}
+/**
+ * L527 : les lots que le créneau libre d'une vague `--continue` peut recevoir, dans l'ordre de priorité : ceux du plan que `candidates` tire (hors lots de la vague) et dont aucune ressource
+ * n'est prise (`readyFree` : lots en cours, vagues vivantes dont celle-ci). Vide quand une borne de `stopReason` joue (arrêt demandé, limite d'usage, question, deux lots rendus de suite, `--until`, budget).
+ * Le budget que les lots qui jouent encore n'ont pas dépensé reste réservé : le lot suivant doit tenir dans le reste (`room`, que `AddFeed.fill` décompte de chaque lot qu'il prend, comme les ressources `uses`).
+ */
+export function fillTargets(f) {
+    const reserved = f.all.filter((l) => !lotFinished(l)).reduce((n, l) => n + Math.max(0, (l.budget ?? 0) - l.steps.reduce((t, s) => t + (s.tokens?.counted ?? 0), 0)), 0);
+    const remaining = f.budget.limit - f.budget.consumed - reserved;
+    const why = stopReason({ now: f.io.now(), until: f.args.untilAt, quotaHit: f.quotaHit, questions: f.all.filter((l) => l.status === 'question').length, streak: handedBackStreak(f.all), interrupted: f.incident, stopRequested: f.store.control().stopAfterCurrent, remaining });
+    if (why)
+        return { targets: [], room: 0 };
+    const dirs = isProject(f.launch) ? [f.launch] : findProjects(f.launch);
+    const libres = readyFree(dirs, f.home);
+    const exclude = new Set(f.all.map((l) => lotKey(l.project, l.lot)));
+    const targets = candidates(f.launch, { priority: f.args.priority ?? readPriority(f.launch), exclude, remaining }).flatMap((c) => {
+        const repo = gitRoot(c.dir);
+        return repo && libres.get(c.dir)?.some((l) => l.id === c.lot.id) ? [{ project: c.project, projectDir: c.dir, repo, lot: c.lot.id, model: 'sonnet', uses: c.lot.uses ?? [] }] : [];
+    });
+    return { targets, room: remaining };
+}

package/dist/orchestrate/cout.js

@@ -0,0 +1,46 @@
+import { join } from 'node:path';
+import { readPerfConfig } from '../config.js';
+import { COUNTED_INPUT_SHARE, euros, stepEuros, sumEuros, waveEuros } from '../cost.js';
+import { RafError } from '../plan.js';
+/**
+ * La grille `perf.prices` du cadence.yaml du dossier de lancement (L529), la même que lit `cadence perf`. Une grille mal formée n'interdit ni une simulation
+ * ni un tableau (perdre le tableau d'une vague payée serait pire que d'en retirer les euros) : `warn` reçoit pourquoi, et la grille est absente.
+ */
+export function launchPrices(launch, warn) {
+    try {
+        return readPerfConfig(join(launch, 'cadence.yaml'));
+    }
+    catch (e) {
+        if (!(e instanceof RafError))
+            throw e;
+        warn(`coût en euros n/d : ${e.message}`);
+        return null;
+    }
+}
+const unknownText = (n) => `n/d pour ${n} lot${n > 1 ? 's' : ''}, modèle sans prix`;
+/**
+ * L'estimation en euros de `--dry-run` : une ligne par lot puis une pour la vague. Le budget du lot (entrée + écriture de cache + sortie, mesuré au p90)
+ * est chiffré au modèle d'écriture du lot, `COUNTED_INPUT_SHARE` en entrée : la lecture de cache et les étapes d'un autre modèle (revue) n'y sont pas.
+ * Vide sans grille.
+ */
+export function estimateLines(lots, launch, warn) {
+    const prices = launchPrices(launch, warn);
+    if (!prices)
+        return [];
+    const per = lots.map((l) => {
+        const e = stepEuros({ model: l.model, counted: l.budget ?? 0 }, prices);
+        return typeof e === 'number' ? e : null;
+    });
+    const out = lots.map((l, i) => `${l.project}:${l.lot} — estimation du lot : ${per[i] === null ? `n/d (${l.model} sans prix dans perf.prices)` : `${euros(per[i])} (budget de ${l.budget ?? 0} tokens au prix ${l.model}, ${Math.round(COUNTED_INPUT_SHARE * 100)} % en entrée)`}`);
+    const sum = waveEuros(per);
+    out.push(`estimation de la vague : ${euros(sum.total)}${sum.unknown ? ` (${unknownText(sum.unknown)})` : ''} — base : le budget de chaque lot, mesuré au p90 comme lui`);
+    return out;
+}
+/** Le coût réel de `renderTable` (L529) : l'en-tête et les cellules de la colonne `€` (une par lot) et la fin de la ligne de la vague ; tout est vide sans grille. */
+export function costView(lots, prices) {
+    if (!prices)
+        return { head: [], cells: lots.map(() => []), total: '' };
+    const per = lots.map((l) => sumEuros(l.steps.map((s) => ({ model: s.model, ...(s.tokens ? { usage: s.tokens } : {}) })), prices));
+    const sum = waveEuros(per);
+    return { head: ['€'], cells: per.map((e) => [e === null ? 'n/d' : euros(e)]), total: ` — ${euros(sum.total)}${sum.unknown ? ` (${unknownText(sum.unknown)})` : ''}` };
+}

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/pool.js

@@ -93,7 +93,7 @@ export async function runPool(ctxs, slots = SLOTS, known = [], onSettled = () =>
     };
     for (;;) {
         admitted.length = 0;
-        for (const c of (await answers?.take(canRun)) ?? []) {
+        for (const c of (await answers?.take(canRun, Math.max(0, slots - running.size - pending.filter((q) => !blocked(q)).length))) ?? []) {
             live.add(c);
             pending.push([c]);
         }

package/dist/orchestrate/table.js

@@ -1,8 +1,11 @@
 import { lotWork } from '../audit.js';
 import { planLoader } from '../config.js';
+import { costView } from './cout.js';
+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 = {
@@ -81,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
@@ -204,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}`);
@@ -226,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;
@@ -235,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)
@@ -243,19 +255,34 @@ 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 rows = lots.map((l) => [`${l.project}:${l.lot}`, stateText(l, wave, deps.now ?? Date.now()), String(l.pass), review(l), ux(l), String(commits(l)), k(counted(l)), `${minutes(l)} min`, String(l.suiteRuns ?? '—')]);
-    const head = ['lot', 'état', 'passes', 'revue', 'UX', 'commits', 'tokens', 'durée', 'suites'];
+    const cost = costView(lots, deps.prices);
+    const rows = lots.map((l, i) => [`${l.project}:${l.lot}`, stateText(l, wave, deps.now ?? Date.now()), String(l.pass), review(l), ux(l), String(commits(l)), k(counted(l)), `${minutes(l)} min`, ...cost.cells[i], String(l.suiteRuns ?? '—')]);
+    const head = ['lot', 'état', 'passes', 'revue', 'UX', 'commits', 'tokens', 'durée', ...cost.head, 'suites'];
     const widths = head.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
     const line = (r) => r.map((c, i) => c.padEnd(widths[i])).join('  ').trimEnd();
     const out = [line(head), ...rows.map(line)];
     const by = (s) => lots.filter((l) => l.status === s).length;
     const tail = [`${by('ready')} prêt(s)`, by('question') ? `${by('question')} question(s)` : '', by('handed-back') + by('failed') ? `${by('handed-back') + by('failed')} rendu(s) au lead` : '', by('suspended') ? `${by('suspended')} suspendu(s)` : ''].filter(Boolean);
-    out.push(`vague ${wave.id} : ${k(wave.consumed)} / ${m(wave.budget)} comptés (lecture de cache ${m(wave.cacheRead)}) — ${tail.join(', ')} — ${wave.status}`);
+    out.push(`vague ${wave.id} : ${k(wave.consumed)} / ${m(wave.budget)} comptés (lecture de cache ${m(wave.cacheRead)})${cost.total} — ${tail.join(', ')} — ${wave.status}`);
     for (const l of lots.filter((x) => x.status === 'question')) {
         out.push(`question : ${l.project}:${l.lot} — « ${l.questions.join(' / ')} » (${resumeAnswerHint(wave.id, l)})`);
     }
@@ -267,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/perf.js

@@ -1,5 +1,6 @@
 import { join, relative, sep } from 'node:path';
 import { planLoader } from './config.js';
+import { euros, stepEuros } from './cost.js';
 import { bugCodeOf, CAUSES, isReview as isReviewKind, sousCausesRanked } from './corrections.js';
 import { addDays, diffDays, isDay, toDay } from './dates.js';
 import { gitCommonDir } from './git.js';
@@ -50,20 +51,6 @@ function planLot(plans, project, lot) {
 /** Rang d'affichage d'une sorte d'étape : l'ordre du cycle, les sortes inconnues après. */
 const KIND_ORDER = ['spec', 'maquette', 'fiche', 'precheck', 'implement', 'probe', 'review', 'review-small', 'ux', 'fix', 'accept'];
 const kindRank = (kind) => (KIND_ORDER.includes(kind) ? KIND_ORDER.indexOf(kind) : KIND_ORDER.length);
-/** Part de `counted` rangée en entrée quand une étape ne porte que ce compteur (journal ancien) : le reste est en sortie (R8 b). */
-const COUNTED_INPUT_SHARE = 0.9;
-/** Coût en euros d'une étape (R8) ; le nom du modèle sans prix quand il en faudrait un. */
-function stepEuros(step, prices) {
-    if (step.model === 'local')
-        return 0;
-    const usage = step.usage ?? (step.counted === undefined ? null : { input: COUNTED_INPUT_SHARE * step.counted, cacheWrite: 0, cacheRead: 0, output: (1 - COUNTED_INPUT_SHARE) * step.counted });
-    if (!usage)
-        return 0;
-    const price = step.model === 'sonnet' || step.model === 'opus' || step.model === 'haiku' ? prices[step.model] : undefined;
-    if (!price)
-        return { missing: step.model === 'sonnet' || step.model === 'opus' || step.model === 'haiku' ? step.model : 'inconnu' };
-    return ((usage.input + usage.cacheWrite) * price.input + usage.output * price.output + usage.cacheRead * price.cacheRead) / 1_000_000;
-}
 const median = (xs) => {
     if (xs.length === 0)
         return null;
@@ -569,7 +556,7 @@ function value(v, kind) {
     if (kind === 'min')
         return `${num(v)} min`;
     if (kind === 'eur')
-        return `${v.toFixed(2).replace('.', ',')} €`;
+        return euros(v);
     return num(v);
 }
 const signed = (c) => `${c >= 0 ? '+' : '−'}${Math.round(100 * Math.abs(c))} %`;

package/dist/release.js

@@ -184,15 +184,30 @@ function whatsNewIssues(text, version) {
         const at = hits.findIndex((h) => h.v === version);
         if (at < 0) {
             issues.push(`${WHATS_NEW} : ${form} ${absent} — l'écrire ${where}`);
-            return;
+            return -1;
         }
         if (at > 0)
             issues.push(`${WHATS_NEW} : ${form} ${misplaced} (après la version ${hits[at - 1].v} ; la plus récente va en premier) — la déplacer ${where}`);
         if (max !== undefined && hits[at].l.length > max)
             issues.push(`${WHATS_NEW} : ${form} trop longue (${hits[at].l.length} caractères, ${max} au plus)`);
+        return hits[at].i;
     };
-    check('ligne de « In two lines »', 'manquante', 'mal placée', /^- \*\*(\d+\.\d+\.\d+)\*\*:/, 0, split, 'en tête de la liste', SHORT_LINE_MAX);
+    const own = check('ligne de « In two lines »', 'manquante', 'mal placée', /^- \*\*(\d+\.\d+\.\d+)\*\*:/, 0, split, 'en tête de la liste', SHORT_LINE_MAX);
     check('paragraphe long', 'manquant', 'mal placé', /^\*\*(\d+\.\d+\.\d+)\*\*:/, split, lines.length, 'juste après l’introduction de « Version by version »');
+    // Le test « deux lignes » du dépôt lit toute la section « In two lines », jusqu'au prochain titre « ## », et toute ligne `- **x.y.z**` (deux-points ou non) :
+    // les autres lignes que celle de la version qui sort comptent (1.22.0, 28-10 : un paragraphe long y était tombé, la publication a échoué).
+    const start = Math.max(0, lines.findIndex((l) => /^##\s+In two lines\s*$/.test(l)));
+    const next = lines.findIndex((l, i) => i > start && l.startsWith('## '));
+    const end = next < 0 ? lines.length : next;
+    lines.slice(start, end).forEach((l, k) => {
+        const i = start + k;
+        const bullet = /^- \*\*(\d+\.\d+\.\d+)\*\*/.exec(l);
+        if (bullet && i !== own && l.length > SHORT_LINE_MAX)
+            issues.push(`${WHATS_NEW} : « In two lines » : la ligne de la version ${bullet[1]} fait ${l.length} caractères, ${SHORT_LINE_MAX} au plus — la raccourcir (le détail va dans « Version by version »)`);
+        const long = /^\*\*(\d+\.\d+\.\d+)\*\*:/.exec(l);
+        if (long)
+            issues.push(`${WHATS_NEW} : « In two lines » : le paragraphe long de la version ${long[1]} n’y a pas sa place (ligne ${i + 1}) — le mettre dans « Version by version »`);
+    });
     return issues;
 }
 /**
@@ -256,7 +271,7 @@ export function release(rest, dryRun, root, today, out) {
                 : '  le commit de version n\'est pas prêt : écrire ces formes (à la main ou par une session), puis suivre les étapes ci-dessous sans relancer la commande (elle changerait encore la version)');
         }
     }
-    out('étapes du lead, dans l\'ordre (la commande n\'en joue aucune) :');
+    out('étapes du lead, dans l\'ordre (la commande n\'en joue aucune ; chacune se lit par son code de sortie : jamais de pipe (`| tail`, `| grep`) derrière une commande dont le code de sortie compte, il lui substitue celui du filtre) :');
     for (const s of steps(p, files, branch))
         out(s);
     return ready ? 0 : 1;

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>