aiki-cli 0.3.0 → 0.3.2

package/dist/orchestration/decision-dossier.js

@@ -5,12 +5,69 @@ function cell(value) {
 function refs(ids) {
     return ids.length ? ids.map((id) => `\`${id}\``).join(', ') : 'none recorded';
 }
+function clipClaim(text, max = 96) {
+    if (text.length <= max)
+        return text;
+    const clipped = text.slice(0, max - 1);
+    const boundary = clipped.lastIndexOf(' ');
+    return `${clipped.slice(0, boundary > max * 0.65 ? boundary : max - 1).trimEnd()}…`;
+}
+/** ≤60-char noun-ish handle for a claim: drop a leading "Verdict:", keep the first clause, clip at a word. */
+export function claimShortLabel(text, max = 60) {
+    const base = text.replace(/^\s*Verdict:\s*/i, '').split(/(?<=\S)[;—]|(?<=\.)\s/)[0].trim();
+    if (base.length <= max)
+        return base;
+    const clipped = base.slice(0, max);
+    const boundary = clipped.lastIndexOf(' ');
+    return `${clipped.slice(0, boundary > max * 0.6 ? boundary : max).trimEnd()}…`;
+}
+/** id → claim text lookup for stripReaderClaimIds substitution; shared by readerClaimLabel's fallback and the Markdown/HTML renderers. */
+export function claimLookup(report) {
+    return (id) => report.claims.find((claim) => claim.id === id)?.text ?? null;
+}
+/** Human-readable labels for reader-facing evidence links. Raw ids stay in the technical audit/JSON. */
+export function readerClaimLabel(report, id) {
+    const claim = report.claims.find((item) => item.id === id);
+    if (claim)
+        return claimShortLabel(claim.text);
+    return /^G\d+$/.test(id) ? 'Supporting claim' : clipClaim(stripReaderClaimIds(id, claimLookup(report)));
+}
+export function readerClaimRefs(report, ids) {
+    return ids.length ? ids.map((id) => readerClaimLabel(report, id)).join('; ') : 'none recorded';
+}
+/** Remove or substitute internal graph notation in reader prose. With a lookup, ids become quoted short labels
+ *  instead of vanishing (never bare-delete); without one (no lookup available), ids are dropped — the legacy
+ *  behavior, kept only for callers that have no claim table to look up against. `sanitizeLabel` escapes each
+ *  injected label for the caller's output format (markdown passes `cell`; HTML passes nothing — raw). */
+export function stripReaderClaimIds(text, labelFor, sanitizeLabel = (label) => label) {
+    const label = (id) => {
+        const hit = labelFor?.(id);
+        return hit ? `"${sanitizeLabel(claimShortLabel(hit))}"` : 'a related claim';
+    };
+    let out = text
+        // whole parenthetical citation groups — comma OR slash separated — vanish entirely: (G19), (G7/G13), (G1, G2)
+        .replace(/\s*\((?:\s*`?G\d+`?\s*[,/]?\s*)+\)/g, '')
+        // "G21's kill criteria" → `"the spike kill-gate"'s kill criteria` — keep the possessive on the label itself
+        // rather than injecting filler noun text, so it reads correctly for any noun that follows.
+        .replace(/\bG(\d+)'s\b/g, (_, n) => (labelFor ? `${label(`G${n}`)}'s` : ''));
+    out = labelFor
+        ? out.replace(/\bG\d+\b/g, (id) => label(id))
+        : out.replace(/\bG\d+\s+assumes\b/g, 'This assumes').replace(/\bG\d+\b/g, '');
+    return out.replace(/\s{2,}/g, ' ').replace(/\s+([.,;:])/g, '$1').trim();
+}
 function providerName(id) {
     return id in DISPLAY_NAME ? DISPLAY_NAME[id] : id;
 }
+const FLAG_EXPLAIN = {
+    synthesis_suspect: 'the chair output needed a deterministic repair; phrasing may be less reliable than the underlying graph',
+    headless_intent: 'no human confirmed the interpretation; documented defaults were used',
+    weak_seat: 'one scout seat contributed far less evidenced material than the other; treat convergence cautiously',
+    source_fallback_search: 'a supplied page blocked direct reading; the source-investigation seat searched for accessible sources instead',
+    deliverable_gap: 'one or more surviving scouts omitted a requested feature or implementation proposal',
+};
 function degradation(report, flags) {
     const active = flags.filter((flag) => report.flags.includes(flag));
-    return active.length ? [`> ⚠ DEGRADED: ${active.join(', ')}`, ''] : [];
+    return active.flatMap((flag) => [`> ⚠ DEGRADED: ${flag}${FLAG_EXPLAIN[flag] ? ` — ${FLAG_EXPLAIN[flag]}.` : ''}`, '']);
 }
 function pct(value) {
     return `${Math.round(value * 100)}%`;
@@ -28,29 +85,258 @@ function councilRead(report) {
     const resolved = report.disagreements.filter((item) => item.status === 'RESOLVED').length;
     return `${report.disagreements.length} genuine disagreement${report.disagreements.length === 1 ? '' : 's'} reached the chair; ${resolved} ${resolved === 1 ? 'was' : 'were'} resolved.`;
 }
-/** Canonical R7 Markdown. HTML and Copy-Markdown consume the same persisted dossier object. */
-export function renderDecisionDossierMarkdown(report) {
+export function sanitizeReaderText(text, labelFor) {
+    return stripReaderClaimIds(text, labelFor)
+        .replace(/\b(?:G|C|D)\d+\b/g, '')
+        .replace(/\bUNVERIFIABLE\b/gi, 'not independently confirmed')
+        .replace(/\bUNVERIFIED\b/gi, 'not yet confirmed')
+        .replace(/\bPARTIAL\b/gi, 'partly supported')
+        .replace(/\bCONFLICTED\b/gi, 'supported by conflicting evidence')
+        .replace(/\bstructural score\b/gi, 'confidence estimate')
+        .replace(/\bevidence coverage\b/gi, 'source strength')
+        .replace(/\bverification coverage\b/gi, 'source strength')
+        .replace(/\b(?:claim|graph) ids?\b/gi, 'internal references')
+        .replace(/\b(?:provider|model) calls?\b/gi, 'analysis steps')
+        .replace(/\banswer editor\b/gi, 'answer synthesis')
+        .replace(/\breader_brief\b/gi, 'reader summary')
+        .replace(/\s{2,}/g, ' ')
+        .replace(/\s+([.,;:])/g, '$1')
+        .trim();
+}
+export function cleanReaderText(report, text) {
+    return sanitizeReaderText(text, claimLookup(report));
+}
+const MATERIAL_WARNING_ORDER = [
+    'synthesis_suspect', 'low_diversity', 'weak_seat', 'deliverable_gap', 'plan_skipped',
+    'plan_fallback', 'headless_intent', 'verification_skipped', 'research_ungrounded',
+];
+const READER_WARNING = {
+    synthesis_suspect: 'The final synthesis needed repair; treat its wording cautiously.',
+    low_diversity: 'Independent diversity was reduced because one scout seat had to be resampled.',
+    weak_seat: 'One scout contributed much less evidenced material; treat convergence cautiously.',
+    deliverable_gap: 'At least one scout omitted a requested feature or implementation proposal.',
+    plan_skipped: 'The answer-planning step was skipped because its call budget was unavailable.',
+    plan_fallback: 'The answer planner failed validation; this report uses a deterministic fallback.',
+    headless_intent: 'No person confirmed the interpreted request; documented defaults were used.',
+    verification_skipped: 'Independent verification was skipped; important factual claims may remain unchecked.',
+    research_ungrounded: 'Source investigation did not produce a cited public source; treat current claims as ungrounded.',
+};
+export function isDecisionSnapshotRelevant(snapshot) {
+    if (!snapshot)
+        return false;
+    const allUnknown = snapshot.options.every((option) => option.commitmentKind === 'UNKNOWN');
+    const paybackUnavailable = !snapshot.payback || snapshot.payback.status === 'NOT_COMPUTABLE';
+    return !(allUnknown && paybackUnavailable);
+}
+function safeHttpUrl(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        const url = new URL(raw);
+        return url.protocol === 'http:' || url.protocol === 'https:' ? url.toString() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function looksLocalPath(value) {
+    if (!value)
+        return false;
+    return /^file:/i.test(value)
+        || /^(?:\/|\.\.?[\\/]|[A-Za-z]:[\\/])/.test(value)
+        || /^(?:[^:/\\]+[\\/])+[^/\\]+$/.test(value);
+}
+/** One cleaned reader contract consumed by Markdown, HTML, and terminal renderers. */
+export function buildReaderProjection(report) {
+    const brief = report.dossier.readerBrief;
+    const clean = (text) => cleanReaderText(report, text);
+    const sources = [];
+    const sourceIndexByKey = new Map();
+    for (const id of brief.source_ids) {
+        const source = report.dossier.evidence.find((item) => item.id === id);
+        if (!source)
+            continue;
+        const url = safeHttpUrl(source.url) ?? safeHttpUrl(source.source);
+        const title = source.title && !looksLocalPath(source.title) ? clean(source.title) : undefined;
+        const label = title ?? (url ? url
+            : source.sourceKind === 'MODEL_KNOWLEDGE' ? 'Background model knowledge'
+                : source.sourceKind === 'USER' || looksLocalPath(source.source) ? 'User-supplied material' : 'Source material');
+        const key = url ? `url:${url.toLowerCase()}` : title ? `id:${source.id}` : `label:${label.toLowerCase()}`;
+        const citedFor = [...new Set(source.claimIds.flatMap((claimId) => {
+                const claim = report.claims.find((item) => item.id === claimId);
+                return claim ? [claimShortLabel(clean(claim.text))] : [];
+            }))].slice(0, 3);
+        const existingIndex = sourceIndexByKey.get(key);
+        if (existingIndex !== undefined) {
+            sources[existingIndex].citedFor = [...new Set([...sources[existingIndex].citedFor, ...citedFor])].slice(0, 3);
+            continue;
+        }
+        sourceIndexByKey.set(key, sources.length);
+        sources.push({ id: source.id, label, ...(url ? { url } : {}), citedFor });
+    }
+    const cleanBacklog = report.dossier.featureBacklog ? {
+        must: report.dossier.featureBacklog.must.map((item) => ({ ...item, feature: clean(item.feature), user_value: clean(item.user_value), rationale: clean(item.rationale) })),
+        should: report.dossier.featureBacklog.should.map((item) => ({ ...item, feature: clean(item.feature), user_value: clean(item.user_value), rationale: clean(item.rationale) })),
+        later: report.dossier.featureBacklog.later.map((item) => ({ ...item, feature: clean(item.feature), user_value: clean(item.user_value), rationale: clean(item.rationale) })),
+        wont: report.dossier.featureBacklog.wont.map((item) => ({ feature: clean(item.feature), reason: clean(item.reason) })),
+    } : undefined;
+    const cleanPlan = report.dossier.implementationPlan ? {
+        milestones: report.dossier.implementationPlan.milestones.map((item) => ({
+            ...item,
+            timebox: clean(item.timebox),
+            outcome: clean(item.outcome),
+            tasks: item.tasks.map(clean),
+            acceptance_test: clean(item.acceptance_test),
+        })),
+    } : undefined;
+    const snapshot = isDecisionSnapshotRelevant(report.decisionSnapshot) ? {
+        decisiveNumbers: report.decisionSnapshot.decisiveNumbers.map((item) => ({ label: clean(item.label), value: clean(item.value), meaning: clean(item.meaning) })),
+        ...(report.decisionSnapshot.payback ? { payback: {
+                status: report.decisionSnapshot.payback.status,
+                result: clean(report.decisionSnapshot.payback.result),
+                basis: clean(report.decisionSnapshot.payback.basis),
+            } } : {}),
+        options: report.decisionSnapshot.options.map((item) => ({
+            label: clean(item.label), commitment: clean(item.commitment), commitmentKind: item.commitmentKind, tradeoff: clean(item.tradeoff),
+        })),
+        ...(report.decisionSnapshot.tripwire ? { tripwire: {
+                metric: clean(report.decisionSnapshot.tripwire.metric),
+                threshold: clean(report.decisionSnapshot.tripwire.threshold),
+                decisionRule: clean(report.decisionSnapshot.tripwire.decisionRule),
+            } } : {}),
+    } : undefined;
+    return {
+        headline: clean(brief.headline),
+        bottomLine: clean(brief.bottom_line),
+        sections: brief.sections.map((section) => ({ heading: clean(section.heading), summary: clean(section.summary), bullets: section.bullets.map(clean) })),
+        featureBacklog: cleanBacklog,
+        implementationPlan: cleanPlan,
+        caveats: brief.caveats.map(clean),
+        warnings: MATERIAL_WARNING_ORDER.filter((flag) => report.flags.includes(flag)).map((flag) => ({ flag, message: READER_WARNING[flag] })),
+        notices: report.flags.includes('source_fallback_search')
+            ? [{ flag: 'source_fallback_search', message: 'Search attempted: a supplied page could not be read directly, so the source-investigation scout searched for accessible sources.' }]
+            : [],
+        snapshot,
+        sources,
+        nextStep: clean(brief.next_step),
+    };
+}
+function renderReaderBriefMarkdown(report) {
+    const projection = buildReaderProjection(report);
+    const L = [`# ${projection.headline}`, '', projection.bottomLine, ''];
+    for (const warning of projection.warnings)
+        L.push(`> ⚠ ${warning.message}`, '');
+    for (const notice of projection.notices)
+        L.push(`> ℹ ${notice.message}`, '');
+    if (projection.snapshot) {
+        L.push('## Decision numbers', '', '### Decisive numbers', '', '| Metric | Value | What it means |', '|---|---:|---|');
+        for (const item of projection.snapshot.decisiveNumbers)
+            L.push(`| ${cell(item.label)} | ${cell(item.value)} | ${cell(item.meaning)} |`);
+        if (projection.snapshot.payback) {
+            L.push('', `**Payback — ${projection.snapshot.payback.status.replaceAll('_', ' ')}:** ${projection.snapshot.payback.result}`);
+            L.push(`Basis: ${projection.snapshot.payback.basis}`, '');
+        }
+        else
+            L.push('');
+        L.push('### Options at a glance', '', '| Path | Commitment | Basis | Trade-off |', '|---|---:|---|---|');
+        for (const option of projection.snapshot.options) {
+            L.push(`| ${cell(option.label)} | ${cell(option.commitment)} | ${option.commitmentKind.replace('_', ' ')} | ${cell(option.tradeoff)} |`);
+        }
+        if (projection.snapshot.tripwire) {
+            const tripwire = projection.snapshot.tripwire;
+            L.push('', '### Go/no-go tripwire', '', `**${tripwire.metric}: ${tripwire.threshold}** — ${tripwire.decisionRule}`, '');
+        }
+        else
+            L.push('');
+    }
+    for (const section of projection.sections) {
+        L.push(`## ${section.heading}`, '', section.summary, '');
+        for (const bullet of section.bullets)
+            L.push(`- ${bullet}`);
+        if (section.bullets.length)
+            L.push('');
+    }
+    if (projection.featureBacklog) {
+        L.push('## Feature priorities', '', '| Priority | Feature | User value | Why now | Effort |', '|---|---|---|---|---|');
+        for (const [priority, items] of [
+            ['MUST', projection.featureBacklog.must],
+            ['SHOULD', projection.featureBacklog.should],
+            ['LATER', projection.featureBacklog.later],
+        ]) {
+            for (const item of items) {
+                L.push(`| ${priority} | ${cell(item.feature)} | ${cell(item.user_value)} | ${cell(item.rationale)} | ${item.effort} |`);
+            }
+        }
+        if (projection.featureBacklog.wont.length) {
+            L.push('', '**Not in this scope**', '');
+            for (const item of projection.featureBacklog.wont)
+                L.push(`- **${item.feature}:** ${item.reason}`);
+        }
+        L.push('');
+    }
+    if (projection.implementationPlan) {
+        L.push('## Build plan', '', '| # | Timebox | Outcome | Work | Done when |', '|---|---|---|---|---|');
+        for (const milestone of projection.implementationPlan.milestones) {
+            L.push(`| ${milestone.order} | ${cell(milestone.timebox)} | ${cell(milestone.outcome)} | ${cell(milestone.tasks.join('; '))} | ${cell(milestone.acceptance_test)} |`);
+        }
+        L.push('');
+    }
+    if (projection.caveats.length) {
+        L.push('## Top caveats', '');
+        for (const caveat of projection.caveats)
+            L.push(`- ${caveat}`);
+        L.push('');
+    }
+    if (projection.sources.length) {
+        L.push('## Sources', '');
+        for (const source of projection.sources) {
+            const citationScope = source.citedFor.length ? ` — Cited for: ${source.citedFor.join('; ')}` : '';
+            L.push(`${source.url ? `- [${source.label.replace(/[\[\]]/g, '')}](${source.url})` : `- ${source.label}`}${citationScope}`);
+        }
+        L.push('');
+    }
+    L.push('## Next step', '', projection.nextStep, '');
+    const legacy = renderLegacyDecisionDossierMarkdown(report).split('\n').slice(2).join('\n');
+    L.push('## Council audit', '', '<details>', '<summary>Show the council reasoning, evidence ledger, dissent, and run receipt</summary>', '', legacy, '', '</details>', '');
+    return L.join('\n');
+}
+/** Pre-v5 deterministic report, retained as the replay fallback and the collapsed v5 audit body. */
+function renderLegacyDecisionDossierMarkdown(report) {
     const { dossier } = report;
+    const labelFor = claimLookup(report);
     const keyFindings = report.keyFindings?.length ? report.keyFindings : [dossier.recommendation.reason];
     const criticalUnknowns = report.criticalUnknowns?.length ? report.criticalUnknowns : report.openQuestions.slice(0, 3);
     const coverage = report.confidenceBreakdown.verificationCoverage;
+    const allConditions = [...new Set(dossier.recommendation.conditions.map((condition) => stripReaderClaimIds(condition.text, labelFor)))];
+    const conditions = allConditions.slice(0, 4);
+    const verdictClaimId = report.claims.find((claim) => /^Verdict:/i.test(claim.text))?.id;
+    const seenQuestions = new Set();
+    const openQuestions = report.openQuestions.filter((question) => {
+        const key = question.slice(0, 60).toLowerCase();
+        if (seenQuestions.has(key))
+            return false;
+        seenQuestions.add(key);
+        return true;
+    });
     const L = [report.mode === 'quick' ? '# Single-Model Decision Report' : '# Multi-Model Decision Report', ''];
     L.push('## 1. Decision', '', ...degradation(report, ['synthesis_suspect']));
     if (report.decisionSnapshot) {
         L.push('### Decisive numbers', '', '| Metric | Value | What it means | Evidence |', '|---|---:|---|---|');
         for (const item of report.decisionSnapshot.decisiveNumbers) {
-            L.push(`| ${cell(item.label)} | ${cell(item.value)} | ${cell(item.meaning)} | ${refs(item.claimIds)} |`);
+            L.push(`| ${cell(item.label)} | ${cell(item.value)} | ${cell(item.meaning)} | ${cell(readerClaimRefs(report, item.claimIds))} |`);
         }
         if (report.decisionSnapshot.payback) {
             const payback = report.decisionSnapshot.payback;
             L.push('', `**Payback — ${payback.status.replaceAll('_', ' ')}:** ${payback.result}`);
-            L.push(`Basis: ${payback.basis} (${refs(payback.claimIds)})`, '');
+            L.push(`Basis: ${payback.basis}`, '');
         }
         else
             L.push('');
     }
     L.push(`**Recommendation:** ${dossier.recommendation.summary}`, '');
-    L.push(`**Evidence coverage:** ${coverageLabel(coverage)} — ${pct(coverage)} of load-bearing claims independently verified.`);
+    L.push(report.confidenceBreakdown.verificationScope === 'FACTUAL'
+        ? `**Evidence coverage:** ${coverageLabel(coverage)} — ${pct(coverage)} of checkable factual claims independently verified; design judgments are adjudicated by the chair, not verified.`
+        : `**Evidence coverage:** ${coverageLabel(coverage)} — ${pct(coverage)} of load-bearing claims independently verified.`);
     L.push(coverage < 0.5
         ? '> Low coverage means important inputs remain unchecked; it is not a probability that the recommendation is correct.'
         : '> Evidence coverage measures independent checking; it is not a probability that the recommendation is correct.', '');
@@ -63,11 +349,11 @@ export function renderDecisionDossierMarkdown(report) {
     if (report.decisionSnapshot) {
         L.push('### Options at a glance', '', '| Path | Commitment | Basis | Trade-off | Evidence |', '|---|---:|---|---|---|');
         for (const option of report.decisionSnapshot.options) {
-            L.push(`| ${cell(option.label)} | ${cell(option.commitment)} | ${option.commitmentKind.replace('_', ' ')} | ${cell(option.tradeoff)} | ${refs(option.claimIds)} |`);
+            L.push(`| ${cell(option.label)} | ${cell(option.commitment)} | ${option.commitmentKind.replace('_', ' ')} | ${cell(option.tradeoff)} | ${cell(readerClaimRefs(report, option.claimIds))} |`);
         }
         if (report.decisionSnapshot.tripwire) {
             const tripwire = report.decisionSnapshot.tripwire;
-            L.push('', '### Go/no-go tripwire', '', `**${tripwire.metric}: ${tripwire.threshold}** — ${tripwire.decisionRule} (${refs(tripwire.claimIds)})`, '');
+            L.push('', '### Go/no-go tripwire', '', `**${tripwire.metric}: ${tripwire.threshold}** — ${tripwire.decisionRule}`, '');
         }
     }
     L.push('### What could overturn this', '', dossier.counterCase.available ? dossier.counterCase.reasoning : dossier.counterCase.reasoning, '');
@@ -79,27 +365,44 @@ export function renderDecisionDossierMarkdown(report) {
         L.push('- None recorded.');
     L.push('', `**Critical warning:** ${report.verdict.criticalWarning ?? 'None recorded.'}`);
     L.push(`**Council read:** ${councilRead(report)}`);
-    L.push(`Evidence anchors: ${refs(dossier.recommendation.claimIds)}`, '');
+    L.push('');
     if (!dossier.recommendation.claimIds.length)
         L.push('> ⚠ DEGRADED: recommendation has no stored graph anchor.', '');
-    L.push('<details>', '<summary>Decision conditions and technical confidence</summary>', '');
-    L.push(`- Decision state: ${dossier.recommendation.status}`);
-    L.push(`- Structural score: ${report.confidenceBreakdown.score}/100 (${report.confidenceBreakdown.label}); heuristic, not benchmark-calibrated.`);
-    L.push(`- Basis: verification ${pct(coverage)} · independent convergence ${pct(report.confidenceBreakdown.independentConvergence)} · evidence quality ${pct(report.confidenceBreakdown.evidenceQuality)} · stability ${pct(report.confidenceBreakdown.stability)} · critical-risk penalty −${report.confidenceBreakdown.criticalRiskPenalty}`);
-    if (dossier.recommendation.conditions.length) {
-        L.push('', 'Conditions:');
-        for (const condition of dossier.recommendation.conditions) {
-            L.push(`- ${condition.text} (${refs(condition.claimIds)})`);
+    L.push('## 2. Deliverables and action plan', '', ...degradation(report, ['plan_fallback', 'plan_skipped']));
+    if ((dossier.missingRequestedOutputs ?? []).length) {
+        L.push(`> ⚠ DEGRADED: requested output missing: ${dossier.missingRequestedOutputs.join(', ')}`, '');
+    }
+    if (dossier.featureBacklog) {
+        L.push('### Feature priorities', '', '| Priority | Feature | User value | Why now | Effort |', '|---|---|---|---|---|');
+        for (const [priority, items] of [
+            ['MUST', dossier.featureBacklog.must],
+            ['SHOULD', dossier.featureBacklog.should],
+            ['LATER', dossier.featureBacklog.later],
+        ]) {
+            for (const item of items)
+                L.push(`| ${priority} | ${cell(item.feature)} | ${cell(item.user_value)} | ${cell(item.rationale)} | ${item.effort} |`);
+        }
+        if (dossier.featureBacklog.wont.length) {
+            L.push('', '**Not in this scope**', '', '| Feature | Reason |', '|---|---|');
+            for (const item of dossier.featureBacklog.wont)
+                L.push(`| ${cell(item.feature)} | ${cell(item.reason)} |`);
         }
+        L.push('');
     }
-    L.push('', '</details>', '');
-    L.push('## 2. Action plan', '', ...degradation(report, ['plan_fallback', 'plan_skipped']));
+    if (dossier.implementationPlan) {
+        L.push('### Implementation plan', '', '| # | Timebox | Outcome | Work | Acceptance test |', '|---|---|---|---|---|');
+        for (const milestone of dossier.implementationPlan.milestones) {
+            L.push(`| ${milestone.order} | ${cell(milestone.timebox)} | ${cell(milestone.outcome)} | ${cell(milestone.tasks.join('; '))} | ${cell(milestone.acceptance_test)} |`);
+        }
+        L.push('');
+    }
+    L.push('### Validation plan', '');
     if (dossier.experiments.status === 'DEGRADED')
         L.push(`> ⚠ DEGRADED: ${dossier.experiments.note}`, '');
     if (dossier.experiments.actions.length) {
         L.push('| # | Experiment | Why | Validates | Effort | Kill signal |', '|---|---|---|---|---|---|');
         for (const action of dossier.experiments.actions) {
-            L.push(`| ${action.order} | ${cell(action.action)} | ${cell(action.why)} | ${action.validates} | ${action.effort} | ${cell(action.killSignal)} |`);
+            L.push(`| ${action.order} | ${cell(action.action)} | ${cell(action.why)} | ${cell(readerClaimLabel(report, action.validates))} | ${action.effort} | ${cell(action.killSignal)} |`);
         }
         L.push('', dossier.experiments.note);
     }
@@ -107,69 +410,61 @@ export function renderDecisionDossierMarkdown(report) {
         L.push('No executable experiment was produced.');
     L.push('');
     L.push('## 3. Why this decision', '');
-    if (dossier.claimChain.length) {
-        L.push('| Claim ID | Claim | Ruling | Evidence status | Depends on |', '|---|---|---|---|---|');
-        for (const claim of dossier.claimChain) {
-            L.push(`| ${claim.claimId} | ${cell(claim.text)} | ${claim.ruling} | ${claim.evidenceStatus} | ${refs(claim.dependsOn)} |`);
-        }
+    for (const point of keyFindings)
+        L.push(`- ${stripReaderClaimIds(point, labelFor)}`);
+    if (!keyFindings.length)
+        L.push('No chair reasoning was recorded.');
+    if (conditions.length) {
+        L.push('', '### Conditions', '');
+        for (const condition of conditions)
+            L.push(`- ${condition}`);
+        if (allConditions.length > conditions.length)
+            L.push('', `${allConditions.length - conditions.length} additional condition${allConditions.length - conditions.length === 1 ? '' : 's'} remain in the stored audit JSON.`);
     }
-    else
-        L.push('No graph-anchored decision chain was recorded.');
     L.push('');
     L.push('## 4. What could change the decision', '', '### Decision-sensitive facts', '');
-    if (dossier.sensitivity.length) {
-        L.push('| Claim ID | Fact | Sensitivity | If false | What would change it | Linked claims |', '|---|---|---|---|---|---|');
-        for (const item of dossier.sensitivity) {
-            L.push(`| ${item.claimId} | ${cell(item.fact)} | ${item.sensitivity} | ${item.impactIfFalse} | ${cell(item.whatWouldChangeIt)} | ${refs(item.linkedClaimIds)} |`);
+    const decisiveFacts = dossier.sensitivity.filter((item) => item.sensitivity === 'DECISIVE').slice(0, 5);
+    if (decisiveFacts.length) {
+        L.push('| Fact | If false | What settles it |', '|---|---|---|');
+        for (const item of decisiveFacts) {
+            L.push(`| ${cell(claimShortLabel(item.fact))} | ${item.impactIfFalse} | ${cell(item.whatWouldChangeIt)} |`);
         }
     }
     else
         L.push('No verdict-sensitive graph node was recorded.');
     L.push('', '### Strongest counter-case', '');
     if (dossier.counterCase.available) {
-        L.push(dossier.counterCase.reasoning, '', `Evidence anchors: ${refs(dossier.counterCase.claimIds)}`);
+        const counterIds = dossier.counterCase.claimIds.filter((id) => id !== verdictClaimId);
+        L.push(dossier.counterCase.reasoning, '', `Evidence behind this counter-case: ${readerClaimRefs(report, counterIds)}`);
     }
     else
         L.push(`> ⚠ DEGRADED: ${dossier.counterCase.reasoning}`);
     L.push('');
-    L.push('## 5. Evidence and verification', '', ...degradation(report, ['verification_skipped', 'research_ungrounded']));
-    if (dossier.evidence.length) {
-        L.push('| Evidence ID | Source | Date | Freshness | Verification | Linked claims |', '|---|---|---|---|---|---|');
-        for (const evidence of dossier.evidence) {
-            L.push(`| ${evidence.id} | ${cell(evidence.source)} (${evidence.sourceKind}) | ${evidence.date} | ${evidence.freshness} | ${evidence.verificationStatus} | ${refs(evidence.claimIds)} |`);
-        }
-    }
-    else
-        L.push('No evidence cards were stored.');
-    L.push('');
-    L.push('## 6. Risks, gaps, and open questions', '', '### Risks', '');
+    L.push('## 5. Risks and open questions', '', ...degradation(report, ['verification_skipped', 'research_ungrounded']), '### Risks', '');
     if (report.risks.length) {
+        const shownRisks = report.risks.slice(0, 8);
         L.push('| Risk | Severity |', '|---|---|');
-        for (const risk of report.risks)
+        for (const risk of shownRisks)
             L.push(`| ${cell(risk.risk)} | ${risk.severity} |`);
+        if (report.risks.length > shownRisks.length)
+            L.push('', `${report.risks.length - shownRisks.length} lower-severity items — more in the technical audit (full list in the stored JSON).`);
     }
     else
         L.push('No material risk was recorded.');
-    L.push('', '### Coverage', '');
-    if (dossier.coverage.length) {
-        L.push('| Dimension | Status | Claim IDs |', '|---|---|---|');
-        for (const item of dossier.coverage)
-            L.push(`| ${cell(item.label)} | ${item.status} | ${refs(item.claimIds)} |`);
-    }
-    else
-        L.push('No rubric coverage ledger was recorded.');
     L.push('', '### Open questions', '');
-    if (report.openQuestions.length) {
-        for (const question of report.openQuestions)
+    if (openQuestions.length) {
+        for (const question of openQuestions.slice(0, 5))
             L.push(`- ${question}`);
+        if (openQuestions.length > 5)
+            L.push('', `Showing 5 of ${openQuestions.length} — the rest are in the technical audit.`);
     }
     else
         L.push('No verdict-flipping open question was recorded.');
     L.push('');
-    L.push('## 7. Disagreement and dissent', '', ...degradation(report, ['single_model', 'low_diversity']));
+    L.push('## 6. Disagreement and dissent', '', ...degradation(report, ['single_model', 'low_diversity']));
     if (report.disagreements.length) {
         for (const disagreement of report.disagreements) {
-            L.push(`- **${disagreement.id}: ${disagreement.topic}** — ${disagreement.status}; ${disagreement.ruling}.`);
+            L.push(`- **${disagreement.topic}** — ${disagreement.status}; ${disagreement.ruling}.`);
             for (const side of disagreement.sides)
                 L.push(`  - ${side.stance} (${side.providers.map(providerName).join(', ')}): ${side.reasoning.join(' ')}`);
             if (disagreement.reasoning)
@@ -182,7 +477,7 @@ export function renderDecisionDossierMarkdown(report) {
     if (dossier.positionChanges.length) {
         L.push('| Event | Claim | Responder | Change | Evidence | Detail |', '|---|---|---|---|---|---|');
         for (const event of dossier.positionChanges) {
-            L.push(`| ${event.eventId} | ${event.claimId} | ${providerName(event.responder)} | ${event.response} | ${refs(event.evidenceIds)} | ${cell(event.narrowedProposition ?? event.reasoning)} |`);
+            L.push(`| ${event.eventId} | ${cell(readerClaimLabel(report, event.claimId))} | ${providerName(event.responder)} | ${event.response} | ${refs(event.evidenceIds)} | ${cell(event.narrowedProposition ?? event.reasoning)} |`);
         }
     }
     else
@@ -197,30 +492,61 @@ export function renderDecisionDossierMarkdown(report) {
     for (const item of report.minority.uniqueOppositions)
         L.push(`- ${providerName(item.provider)} uniquely opposed: ${item.proposition}`);
     L.push(`- Decision-blocking status: ${report.minority.blocksDecision}`, '');
-    L.push('## 8. What the council added', '');
-    if (dossier.sharedConcerns.length) {
-        L.push('Shared concerns:');
-        for (const item of dossier.sharedConcerns)
-            L.push(`- **${item.claimId}** ${item.text} — ${item.evidenceStatus}; ${item.providerIds.map(providerName).join(', ')}.`);
-    }
-    else
-        L.push('Shared concerns: none recorded.');
-    L.push('');
-    if (dossier.uniqueSupportedInsights.length) {
-        L.push('Unique supported insights:');
-        for (const item of dossier.uniqueSupportedInsights)
-            L.push(`- **${item.claimId}** ${item.text} — ${providerName(item.providerId)}; ${item.verificationStatus}.`);
+    L.push('## 7. What the council added', '', ...degradation(report, ['weak_seat']));
+    if (dossier.seatStats) {
+        const weakSeat = dossier.seatStats.some((seat) => seat.positions < 3 || seat.evidenced / seat.positions < 0.5);
+        for (const seat of dossier.seatStats) {
+            const weak = seat.positions < 3 || seat.evidenced / seat.positions < 0.5;
+            L.push(`- ${providerName(seat.provider)}: ${seat.positions} position${seat.positions === 1 ? '' : 's'}, ${seat.evidenced} with evidence${weak ? ' — weak seat this run.' : '.'}`);
+        }
+        for (const chair of report.models.filter((model) => model.roles.includes('judge') && !dossier.seatStats.some((seat) => seat.provider === model.provider))) {
+            L.push(`- ${chair.name}: chaired the decision and authored no scout claims (clean adjudication).`);
+        }
+        if (dossier.sharedConcerns.length) {
+            L.push('', 'Shared concerns:');
+            for (const item of dossier.sharedConcerns)
+                L.push(`- ${item.text} — ${item.evidenceStatus}; ${item.providerIds.map(providerName).join(', ')}.`);
+        }
+        L.push('', report.disagreements.length
+            ? councilRead(report)
+            : 'No genuine disagreement survived to the chair.');
+        if (weakSeat || coverage < 0.5)
+            L.push('Convergence with weak verification lowers confidence; it does not raise it.');
+        const verifiedContributions = dossier.contributions.filter((item) => item.verifiedUniqueClaimIds.length > 0);
+        if (verifiedContributions.length) {
+            L.push('', '### Verified unique contributions', '', ...degradation(report, ['verification_skipped', 'single_model', 'low_diversity']));
+            L.push('Only unique claims that survived independent verification receive credit.', '');
+            L.push('| Provider | Verified unique contributions | Count |', '|---|---|---|');
+            for (const contribution of verifiedContributions) {
+                L.push(`| ${contribution.name} | ${cell(readerClaimRefs(report, contribution.verifiedUniqueClaimIds))} | ${contribution.verifiedUniqueClaimIds.length} |`);
+            }
+        }
     }
-    else
-        L.push('Unique supported insights: none recorded.');
-    L.push('', '### Verified unique contributions', '', ...degradation(report, ['verification_skipped', 'single_model', 'low_diversity']));
-    L.push('Only unique claims that survived independent verification receive credit.', '');
-    L.push('| Provider | Verified unique claim IDs | Count |', '|---|---|---|');
-    for (const contribution of dossier.contributions) {
-        L.push(`| ${contribution.name} | ${refs(contribution.verifiedUniqueClaimIds)} | ${contribution.verifiedUniqueClaimIds.length} |`);
+    else {
+        if (dossier.sharedConcerns.length) {
+            L.push('Shared concerns:');
+            for (const item of dossier.sharedConcerns)
+                L.push(`- ${item.text} — ${item.evidenceStatus}; ${item.providerIds.map(providerName).join(', ')}.`);
+        }
+        else
+            L.push('Shared concerns: none recorded.');
+        L.push('');
+        if (dossier.uniqueSupportedInsights.length) {
+            L.push('Unique supported insights:');
+            for (const item of dossier.uniqueSupportedInsights)
+                L.push(`- ${item.text} — ${providerName(item.providerId)}; ${item.verificationStatus}.`);
+        }
+        else
+            L.push('Unique supported insights: none recorded.');
+        L.push('', '### Verified unique contributions', '', ...degradation(report, ['verification_skipped', 'single_model', 'low_diversity']));
+        L.push('Only unique claims that survived independent verification receive credit.', '');
+        L.push('| Provider | Verified unique contributions | Count |', '|---|---|---|');
+        for (const contribution of dossier.contributions) {
+            L.push(`| ${contribution.name} | ${cell(readerClaimRefs(report, contribution.verifiedUniqueClaimIds))} | ${contribution.verifiedUniqueClaimIds.length} |`);
+        }
     }
     L.push('');
-    L.push('## 9. Run details', '');
+    L.push('## 8. Run details', '');
     L.push(`- Report ID: \`${report.reportId}\``);
     L.push(`- Generated: ${report.generatedAt}`);
     L.push(`- Original task: ${report.task.original}`);
@@ -236,8 +562,65 @@ export function renderDecisionDossierMarkdown(report) {
     L.push(`- By provider: ${Object.entries(report.receipt.byProvider).map(([provider, count]) => `${providerName(provider)} ${count}`).join(', ') || 'none'}`);
     L.push(`- Recorded model time: ${(report.receipt.modelTimeMs / 1000).toFixed(1)}s`);
     L.push(`- Degradation flags: ${report.flags.join(', ') || 'none'}`, '');
-    L.push('## 10. Technical audit', '');
-    L.push('<details>', '<summary>Original submissions and graph events</summary>', '');
+    // This pass runs over already-built (cell-escaped) table rows, so injected labels must be cell-escaped too.
+    for (let index = 0; index < L.length; index++)
+        L[index] = stripReaderClaimIds(L[index], labelFor, cell);
+    L.push('## 9. Technical audit', '');
+    L.push('<details>', '<summary>Evidence, coverage, claims, and graph events</summary>', '');
+    L.push('### Decision confidence', '');
+    L.push(`- Decision state: ${dossier.recommendation.status}`);
+    L.push(`- Structural score: ${report.confidenceBreakdown.score}/100 (${report.confidenceBreakdown.label}); heuristic, not benchmark-calibrated.`);
+    L.push(`- Basis: verification ${pct(coverage)} · independent convergence ${pct(report.confidenceBreakdown.independentConvergence)} · evidence quality ${pct(report.confidenceBreakdown.evidenceQuality)} · stability ${pct(report.confidenceBreakdown.stability)} · critical-risk penalty −${report.confidenceBreakdown.criticalRiskPenalty}`, '');
+    L.push('### Full claim chain', '');
+    if (dossier.claimChain.length) {
+        L.push('| Claim | Ruling | Evidence status | Depends on |', '|---|---|---|---|');
+        for (const claim of dossier.claimChain) {
+            L.push(`| ${cell(claim.text)} | ${claim.ruling} | ${claim.evidenceStatus} | ${cell(readerClaimRefs(report, claim.dependsOn))} |`);
+        }
+    }
+    else
+        L.push('No graph-anchored decision chain was recorded.');
+    L.push('', '### Full decision-sensitivity ledger', '');
+    if (dossier.sensitivity.length) {
+        L.push('| Fact | Sensitivity | If false | What would change it | Linked claims |', '|---|---|---|---|---|');
+        for (const item of dossier.sensitivity) {
+            L.push(`| ${cell(item.fact)} | ${item.sensitivity} | ${item.impactIfFalse} | ${cell(item.whatWouldChangeIt)} | ${cell(readerClaimRefs(report, item.linkedClaimIds))} |`);
+        }
+    }
+    else
+        L.push('No verdict-sensitive graph node was recorded.');
+    L.push('', '### Evidence and verification', '');
+    if (dossier.evidence.length) {
+        L.push('| Evidence ID | Source | Date | Freshness | Verification | Linked claims |', '|---|---|---|---|---|---|');
+        for (const evidence of dossier.evidence) {
+            L.push(`| ${evidence.id} | ${cell(evidence.source)} (${evidence.sourceKind}) | ${evidence.date} | ${evidence.freshness} | ${evidence.verificationStatus} | ${cell(readerClaimRefs(report, evidence.claimIds))} |`);
+        }
+    }
+    else
+        L.push('No evidence cards were stored.');
+    L.push('', '### Coverage ledger', '');
+    if (dossier.coverage.length) {
+        L.push('| Dimension | Status | Related claims |', '|---|---|---|');
+        for (const item of dossier.coverage)
+            L.push(`| ${cell(item.label)} | ${item.status} | ${cell(readerClaimRefs(report, item.claimIds))} |`);
+    }
+    else
+        L.push('No rubric coverage ledger was recorded.');
+    L.push('', '### Full risk ledger', '');
+    if (report.risks.length) {
+        L.push('| Risk | Severity |', '|---|---|');
+        for (const risk of report.risks)
+            L.push(`| ${cell(risk.risk)} | ${risk.severity} |`);
+    }
+    else
+        L.push('No material risk was recorded.');
+    L.push('', '### Full open-question ledger', '');
+    if (report.openQuestions.length)
+        for (const question of report.openQuestions)
+            L.push(`- ${question}`);
+    else
+        L.push('No verdict-flipping open question was recorded.');
+    L.push('', '### Original submissions and graph events', '');
     for (const submission of dossier.technical.submissions) {
         L.push(`- **${submission.name}:** ${submission.strongestVersion} (${refs(submission.positionIds)})`);
     }
@@ -260,3 +643,7 @@ export function renderDecisionDossierMarkdown(report) {
     L.push('', '</details>', '');
     return L.join('\n');
 }
+/** Canonical Markdown. HTML and Copy-Markdown consume the same persisted reader brief. */
+export function renderDecisionDossierMarkdown(report) {
+    return report.dossier.readerBrief ? renderReaderBriefMarkdown(report) : renderLegacyDecisionDossierMarkdown(report);
+}