council-review 0.1.0

package/dist/report.d.ts

@@ -0,0 +1,116 @@
+import type { MergedFinding } from './merge.js';
+import type { ResolutionOutcome } from './resolve.js';
+import type { ReviewerResult, RunPanelOutcome } from './runner.js';
+import type { ResolvedScope } from './scope.js';
+import type { SnapshotIdentity } from './snapshot.js';
+export interface RunDir {
+    id: string;
+    path: string;
+    reviewsDir: string;
+}
+/** `<projectRoot>/.council/reviews` — the container directory for every run. */
+export declare function reviewsDirPath(projectRoot: string): string;
+/**
+ * Creates a fresh, uniquely named run directory (plus its `reviewers/` subdirectory) under
+ * `<projectRoot>/.council/reviews`. On the vanishingly unlikely event that two runs start in the
+ * same millisecond, a numeric suffix is appended to the id until directory creation succeeds —
+ * the suffixed id is still lexicographically greater than its unsuffixed base (a string that is a
+ * strict prefix of another always sorts before it), so chronological ordering is preserved either
+ * way.
+ */
+export declare function createRunDir(projectRoot: string): RunDir;
+/**
+ * Atomically creates or replaces the `last` symlink to point at `run`. Symlinking to the run's
+ * own id (a relative target, not an absolute path) keeps the pointer valid even if the whole
+ * `.council/reviews` directory is later moved or copied.
+ *
+ * `fs.renameSync` is used rather than removing then recreating `last`, because rename is atomic
+ * on POSIX: there is no window in which `last` is absent or pointing at a half-written target.
+ * The caller must be able to rely on this — it's what makes "the pointer is updated even by a
+ * degraded run" true in the presence of a crash immediately after this call.
+ */
+export declare function updateLastPointer(run: RunDir): void;
+/**
+ * Deterministic, collision-free filename slug for a `provider/model` pair. A pure
+ * lowercase-and-replace scheme is not collision-free on its own — `openrouter/a/b` and
+ * `openrouter/a-b` would both sanitize to the same text — so the slug always carries an 8-hex-char
+ * SHA-256 prefix of the exact, untouched `"provider/model"` string. Two different models collide
+ * on a filename only if they collide on that hash, which is what "collision-free" is grounded in
+ * here rather than in the sanitization itself.
+ */
+export declare function slugifyModel(provider: string, model: string): string;
+/**
+ * Writes the three raw artifacts for one reviewer, regardless of its outcome — including a
+ * reviewer that failed validation on both attempts. `findings` is written as `null` (valid JSON)
+ * when the reviewer never produced a schema-valid block, which is itself informative: the file's
+ * presence, not its content, is what the spec requires for every reviewer.
+ */
+export declare function writeReviewerArtifacts(run: RunDir, r: ReviewerResult): void;
+/** The exact text written to `findings.json` and emitted in machine-readable mode — kept as one
+ * function so the two can never drift apart. */
+export declare function serializeFindings(findings: readonly MergedFinding[]): string;
+export declare function writeFindings(run: RunDir, findings: readonly MergedFinding[]): string;
+/**
+ * Machine-readable output mode (task 15.8): writes ONLY the merged findings document to `stream`
+ * (defaulting to `process.stdout`, overridable for tests). This function touches no other stream
+ * and prints nothing else, which is what keeps stdout parseable in that mode — the caller (the
+ * CLI) is responsible for routing progress and diagnostics to stderr instead of calling
+ * `console.log`/`process.stdout.write` itself while this mode is active.
+ */
+export declare function emitMachineReadableFindings(findings: readonly MergedFinding[], stream?: NodeJS.WritableStream): void;
+export interface ManifestInput {
+    run: RunDir;
+    identity: SnapshotIdentity;
+    scope: ResolvedScope;
+    outcome: RunPanelOutcome;
+    suppressed: number;
+    overrides: {
+        allowCorrelated: boolean;
+        includeContextFiles: boolean;
+        noSuppress: boolean;
+    };
+    hostVersion: string | null;
+}
+/**
+ * Writes the manifest: everything needed to explain and reproduce a run, per the reporting
+ * spec's "Manifest contract" requirement. Deliberately omits `scope.patch` (the diff text) —
+ * that content already exists verbatim as `patch.diff`, and there is no reason for a document
+ * whose scenarios are about reproducibility metadata to carry a second copy of it.
+ *
+ * Nothing here ever reads `process.env`, a credential store, or reviewer stdout beyond the
+ * already-structured `ReviewerResult` fields (`usage`, `cost`, `depth`, `state`, `error`) — see
+ * the "Manifest carries no credentials" test in `test/unit/report.test.ts`.
+ */
+export declare function writeManifest(i: ManifestInput): string;
+/**
+ * Writes the human report. Ordering is fixed by the spec and is exactly the order this function
+ * builds it in: the resolution summary (when resolution diffing was requested — i.e. `resolution
+ * !== null` — whether or not a baseline turned out to be available), then the panel, then
+ * findings in merged (agreement) order, then the footer's suppressed/degraded/cost summary.
+ *
+ * A run with no findings still produces a complete, valid report: the panel section is unaffected
+ * and the findings section states plainly that none were raised, per the "Report for a run with
+ * no findings" scenario.
+ */
+export declare function writeReport(run: RunDir, i: ManifestInput, findings: readonly MergedFinding[], resolution: ResolutionOutcome | null): string;
+/**
+ * Writes the handoff prompt — addressed to a coding agent, not to a person — naming the run
+ * directory and the merged findings file, requiring reproduction before any fix, directing
+ * ambiguity to the raw per-reviewer artifacts, and framing a low-agreement finding as a
+ * hypothesis to test rather than an established defect.
+ */
+export declare function writeHandoff(run: RunDir, findingsPath: string): string;
+/** Every run directory under `<projectRoot>/.council/reviews`, newest first. Lexicographic sort
+ * is chronological sort, per `createRunDir`'s id format. Returns `[]` when no run has ever been
+ * written (the reviews directory does not exist yet), rather than throwing. */
+export declare function listRuns(projectRoot: string): RunDir[];
+/**
+ * Prunes stored runs, retaining the `keep` most recent ones, and never removing the run `last`
+ * resolves to even if it would otherwise fall outside that count (it never does in practice,
+ * since `last` always points at the newest run, but the protection is explicit rather than
+ * incidental). Returns the ids removed; an empty array when there was nothing to prune.
+ */
+export declare function gcRuns(projectRoot: string, keep: number): {
+    removed: string[];
+};
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOtD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAsBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAqBxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBnD;AAcD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpE;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,CAoB3E;AAMD;gDACgD;AAChD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAE5E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAIrF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,MAAM,GAAE,MAAM,CAAC,cAA+B,GAC7C,IAAI,CAEN;AAMD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,mBAAmB,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3F,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAoEtD;AAoFD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,CAAC,EAAE,aAAa,EAChB,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,UAAU,EAAE,iBAAiB,GAAG,IAAI,GACnC,MAAM,CA8DR;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CA4CtE;AAMD;;+EAE+E;AAC/E,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBtD;AAYD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgB/E"}

package/dist/report.js

@@ -0,0 +1,493 @@
+/**
+ * Writes everything a run leaves behind: the run directory itself and the most-recent pointer,
+ * the manifest, the per-reviewer raw artifacts, the merged findings document, the human report,
+ * the handoff prompt, and the machine-readable stdout form of the findings document. Also reads
+ * and prunes past runs (`listRuns`, `gcRuns`), which back the `show` and `gc` CLI commands.
+ *
+ * See `openspec/changes/add-council-review/specs/council-review/reporting/spec.md` for the
+ * requirements this implements, and CONTRACT.md's "PINNED: run-directory layout and the
+ * most-recent pointer" for the exact on-disk shape other sections (`resolve.ts`, `cli.ts`) read
+ * against:
+ *
+ *   .council/reviews/
+ *     <run-id>/
+ *       manifest.json
+ *       patch.diff              written by snapshot.ts's writePatch(), never by this module
+ *       findings.json           JSON array of MergedFinding
+ *       REPORT.md
+ *       HANDOFF.md
+ *       reviewers/<slug>.findings.json | .text.md | .trace.jsonl
+ *     last -> <run-id>          SYMLINK to the most recent run directory
+ *
+ * This module never calls a model, never touches the network, and never calls `process.exit`.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+/** `<projectRoot>/.council/reviews` — the container directory for every run. */
+export function reviewsDirPath(projectRoot) {
+    return path.join(projectRoot, '.council', 'reviews');
+}
+/**
+ * A timestamp id down to the millisecond, in a fixed-width, purely numeric-plus-`T`/`Z` form
+ * (`20260904T153012123Z`). Fixed-width fields with no separators mean lexicographic string order
+ * is exactly chronological order, and every character is filesystem-safe on POSIX (and Windows,
+ * incidentally, since the usual offender — `:` — never appears).
+ */
+function timestampId(now) {
+    const pad = (n, len = 2) => String(n).padStart(len, '0');
+    return (`${now.getUTCFullYear()}${pad(now.getUTCMonth() + 1)}${pad(now.getUTCDate())}T` +
+        `${pad(now.getUTCHours())}${pad(now.getUTCMinutes())}${pad(now.getUTCSeconds())}${pad(now.getUTCMilliseconds(), 3)}Z`);
+}
+function isEexistError(err) {
+    return (typeof err === 'object' && err !== null && err.code === 'EEXIST');
+}
+/**
+ * Creates a fresh, uniquely named run directory (plus its `reviewers/` subdirectory) under
+ * `<projectRoot>/.council/reviews`. On the vanishingly unlikely event that two runs start in the
+ * same millisecond, a numeric suffix is appended to the id until directory creation succeeds —
+ * the suffixed id is still lexicographically greater than its unsuffixed base (a string that is a
+ * strict prefix of another always sorts before it), so chronological ordering is preserved either
+ * way.
+ */
+export function createRunDir(projectRoot) {
+    const reviewsDir = reviewsDirPath(projectRoot);
+    fs.mkdirSync(reviewsDir, { recursive: true });
+    const base = timestampId(new Date());
+    let id = base;
+    let dir = path.join(reviewsDir, id);
+    let suffix = 1;
+    for (;;) {
+        try {
+            fs.mkdirSync(dir);
+            break;
+        }
+        catch (err) {
+            if (!isEexistError(err))
+                throw err;
+            suffix += 1;
+            id = `${base}-${suffix}`;
+            dir = path.join(reviewsDir, id);
+        }
+    }
+    fs.mkdirSync(path.join(dir, 'reviewers'));
+    return { id, path: dir, reviewsDir };
+}
+/**
+ * Atomically creates or replaces the `last` symlink to point at `run`. Symlinking to the run's
+ * own id (a relative target, not an absolute path) keeps the pointer valid even if the whole
+ * `.council/reviews` directory is later moved or copied.
+ *
+ * `fs.renameSync` is used rather than removing then recreating `last`, because rename is atomic
+ * on POSIX: there is no window in which `last` is absent or pointing at a half-written target.
+ * The caller must be able to rely on this — it's what makes "the pointer is updated even by a
+ * degraded run" true in the presence of a crash immediately after this call.
+ */
+export function updateLastPointer(run) {
+    const lastPath = path.join(run.reviewsDir, 'last');
+    const tmpPath = path.join(run.reviewsDir, `.last.tmp-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    fs.symlinkSync(run.id, tmpPath, 'dir');
+    try {
+        fs.renameSync(tmpPath, lastPath);
+    }
+    catch (err) {
+        try {
+            fs.rmSync(tmpPath, { force: true });
+        }
+        catch {
+            // best-effort cleanup of the temp link; the rename error is what matters
+        }
+        throw err;
+    }
+}
+// -------------------------------------------------------------------------------------------
+// Filename slugification (task 15.2)
+// -------------------------------------------------------------------------------------------
+function sanitizeSegment(s) {
+    const cleaned = s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return cleaned.length > 0 ? cleaned : 'x';
+}
+/**
+ * Deterministic, collision-free filename slug for a `provider/model` pair. A pure
+ * lowercase-and-replace scheme is not collision-free on its own — `openrouter/a/b` and
+ * `openrouter/a-b` would both sanitize to the same text — so the slug always carries an 8-hex-char
+ * SHA-256 prefix of the exact, untouched `"provider/model"` string. Two different models collide
+ * on a filename only if they collide on that hash, which is what "collision-free" is grounded in
+ * here rather than in the sanitization itself.
+ */
+export function slugifyModel(provider, model) {
+    const key = `${provider}/${model}`;
+    const hash = createHash('sha256').update(key, 'utf8').digest('hex').slice(0, 8);
+    return `${hash}-${sanitizeSegment(provider)}__${sanitizeSegment(model)}`;
+}
+// -------------------------------------------------------------------------------------------
+// Per-reviewer raw artifacts (task 15.3)
+// -------------------------------------------------------------------------------------------
+/**
+ * Writes the three raw artifacts for one reviewer, regardless of its outcome — including a
+ * reviewer that failed validation on both attempts. `findings` is written as `null` (valid JSON)
+ * when the reviewer never produced a schema-valid block, which is itself informative: the file's
+ * presence, not its content, is what the spec requires for every reviewer.
+ */
+export function writeReviewerArtifacts(run, r) {
+    const slug = slugifyModel(r.reviewer.provider, r.reviewer.model);
+    const dir = path.join(run.path, 'reviewers');
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, `${slug}.findings.json`), `${JSON.stringify(r.findings, null, 2)}\n`, 'utf8');
+    const heading = `${r.reviewer.provider}/${r.reviewer.model}`;
+    const textParts = [`# ${heading} — attempt 1\n\n${r.finalText}`];
+    if (r.repairText !== null) {
+        textParts.push(`\n\n---\n\n# ${heading} — repair attempt\n\n${r.repairText}`);
+    }
+    fs.writeFileSync(path.join(dir, `${slug}.text.md`), `${textParts.join('')}\n`, 'utf8');
+    const trace = r.rawTrace.length > 0 ? `${r.rawTrace.join('\n')}\n` : '';
+    fs.writeFileSync(path.join(dir, `${slug}.trace.jsonl`), trace, 'utf8');
+}
+// -------------------------------------------------------------------------------------------
+// Merged findings document
+// -------------------------------------------------------------------------------------------
+/** The exact text written to `findings.json` and emitted in machine-readable mode — kept as one
+ * function so the two can never drift apart. */
+export function serializeFindings(findings) {
+    return `${JSON.stringify(findings, null, 2)}\n`;
+}
+export function writeFindings(run, findings) {
+    const dest = path.join(run.path, 'findings.json');
+    fs.writeFileSync(dest, serializeFindings(findings), 'utf8');
+    return dest;
+}
+/**
+ * Machine-readable output mode (task 15.8): writes ONLY the merged findings document to `stream`
+ * (defaulting to `process.stdout`, overridable for tests). This function touches no other stream
+ * and prints nothing else, which is what keeps stdout parseable in that mode — the caller (the
+ * CLI) is responsible for routing progress and diagnostics to stderr instead of calling
+ * `console.log`/`process.stdout.write` itself while this mode is active.
+ */
+export function emitMachineReadableFindings(findings, stream = process.stdout) {
+    stream.write(serializeFindings(findings));
+}
+/**
+ * Writes the manifest: everything needed to explain and reproduce a run, per the reporting
+ * spec's "Manifest contract" requirement. Deliberately omits `scope.patch` (the diff text) —
+ * that content already exists verbatim as `patch.diff`, and there is no reason for a document
+ * whose scenarios are about reproducibility metadata to carry a second copy of it.
+ *
+ * Nothing here ever reads `process.env`, a credential store, or reviewer stdout beyond the
+ * already-structured `ReviewerResult` fields (`usage`, `cost`, `depth`, `state`, `error`) — see
+ * the "Manifest carries no credentials" test in `test/unit/report.test.ts`.
+ */
+export function writeManifest(i) {
+    const manifest = {
+        runId: i.run.id,
+        createdAt: new Date().toISOString(),
+        hostVersion: i.hostVersion,
+        reviewed: {
+            commit: i.identity.head,
+            dirty: i.identity.dirty,
+            treeHash: i.identity.treeHash,
+        },
+        scope: {
+            mode: i.scope.mode,
+            selectors: i.scope.selectors,
+            baseBranch: i.scope.baseBranch,
+            mergeBase: i.scope.mergeBase,
+            endRevision: i.scope.endRevision,
+            head: i.scope.head,
+            dirty: i.scope.dirty,
+            empty: i.scope.empty,
+            files: i.scope.files,
+        },
+        panel: i.outcome.results.map((r) => ({
+            provider: r.reviewer.provider,
+            model: r.reviewer.model,
+            vendor: r.reviewer.vendor,
+            thinking: {
+                requested: r.reviewer.thinking.requested,
+                effective: r.reviewer.thinking.effective,
+                applicable: r.reviewer.thinking.applicable,
+                clamped: r.reviewer.thinking.clamped,
+            },
+        })),
+        reviewers: i.outcome.results.map((r) => ({
+            provider: r.reviewer.provider,
+            model: r.reviewer.model,
+            state: r.state,
+            startedAt: r.startedAt,
+            endedAt: r.endedAt,
+            durationMs: r.endedAt - r.startedAt,
+            usage: r.usage,
+            cost: r.cost,
+            depth: {
+                filesOpenedCount: r.depth.filesOpened.length,
+                filesOpened: r.depth.filesOpened,
+                searches: r.depth.searches,
+            },
+            ...(r.error !== undefined ? { error: r.error } : {}),
+        })),
+        counts: {
+            launched: i.outcome.launched,
+            reporting: i.outcome.reporting,
+            suppressed: i.suppressed,
+        },
+        cost: {
+            total: i.outcome.totalCost, // null === unknown, never coerced to 0
+            incomplete: i.outcome.costIncomplete,
+        },
+        degraded: i.outcome.degraded,
+        overrides: {
+            allowCorrelated: i.overrides.allowCorrelated,
+            includeContextFiles: i.overrides.includeContextFiles,
+            noSuppress: i.overrides.noSuppress,
+        },
+    };
+    const dest = path.join(i.run.path, 'manifest.json');
+    fs.writeFileSync(dest, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+    return dest;
+}
+// -------------------------------------------------------------------------------------------
+// REPORT.md (task 15.6)
+// -------------------------------------------------------------------------------------------
+function formatThinking(t) {
+    if (!t.applicable)
+        return 'n/a';
+    if (t.effective === null)
+        return 'none';
+    return t.clamped ? `${t.effective} (clamped from ${t.requested})` : t.effective;
+}
+function formatCost(cost) {
+    return cost === null ? 'unknown' : `$${cost.toFixed(4)}`;
+}
+function formatDepth(d) {
+    const files = d.filesOpened.length;
+    return `${files} file${files === 1 ? '' : 's'} opened, ${d.searches} search${d.searches === 1 ? '' : 'es'}`;
+}
+function renderResolutionSection(resolution) {
+    if (resolution.baselineRunId === null) {
+        return [
+            '## Resolution',
+            '',
+            'No baseline run was available for comparison, so findings below carry no resolution ' +
+                'marking. This is the first run to be diffed, not a run with zero new findings.',
+            '',
+        ];
+    }
+    const { resolved, stillPresent, new: newCount } = resolution.counts;
+    const lines = [
+        '## Resolution',
+        '',
+        `Compared against run \`${resolution.baselineRunId}\`: ${resolved} resolved, ` +
+            `${stillPresent} still present, ${newCount} new.`,
+        '',
+    ];
+    if (resolution.resolved.length > 0) {
+        lines.push('Resolved since the baseline run:', '');
+        for (const f of resolution.resolved) {
+            lines.push(`- \`${f.file}:${f.line}\` — ${f.claim}`);
+        }
+        lines.push('');
+    }
+    return lines;
+}
+function renderFinding(f, resolutionByFingerprint) {
+    const marker = resolutionByFingerprint?.get(f.fingerprint) ?? null;
+    const markerText = marker ? ` [${marker}]` : '';
+    const location = f.endLine !== null ? `${f.file}:${f.line}-${f.endLine}` : `${f.file}:${f.line}`;
+    const lines = [
+        `### ${f.id} — ${f.severity.toUpperCase()} · ${f.category}${markerText}`,
+        '',
+        `**Location:** \`${location}\``,
+        `**Agreement:** ${f.agreement.raisers}/${f.agreement.reporting} reviewers (${f.raisedBy.join(', ')})`,
+        `**Claim:** ${f.claim}`,
+        `**Impact:** ${f.impact}`,
+    ];
+    if (f.unverifiable) {
+        lines.push('', '_This finding references a path absent from the reviewed snapshot; it could not be verified._');
+    }
+    if (f.evidence.length > 0) {
+        lines.push('', '**Evidence:**');
+        for (const e of f.evidence)
+            lines.push(`- ${e}`);
+    }
+    if (f.suggestions.length > 0) {
+        lines.push('', '**Suggestions:**');
+        for (const s of f.suggestions)
+            lines.push(`- ${s}`);
+    }
+    lines.push('');
+    return lines;
+}
+/**
+ * Writes the human report. Ordering is fixed by the spec and is exactly the order this function
+ * builds it in: the resolution summary (when resolution diffing was requested — i.e. `resolution
+ * !== null` — whether or not a baseline turned out to be available), then the panel, then
+ * findings in merged (agreement) order, then the footer's suppressed/degraded/cost summary.
+ *
+ * A run with no findings still produces a complete, valid report: the panel section is unaffected
+ * and the findings section states plainly that none were raised, per the "Report for a run with
+ * no findings" scenario.
+ */
+export function writeReport(run, i, findings, resolution) {
+    const lines = [`# Council Review — ${run.id}`, ''];
+    if (resolution !== null) {
+        lines.push(...renderResolutionSection(resolution));
+    }
+    lines.push('## Panel', '', '| Reviewer | Vendor | Thinking | Cost | Depth |', '|---|---|---|---|---|');
+    for (const r of i.outcome.results) {
+        lines.push(`| ${r.reviewer.provider}/${r.reviewer.model} | ${r.reviewer.vendor} | ` +
+            `${formatThinking(r.reviewer.thinking)} | ${formatCost(r.cost)} | ${formatDepth(r.depth)} |`);
+    }
+    lines.push('');
+    lines.push('## Findings', '');
+    if (findings.length === 0) {
+        lines.push('No findings were raised.', '');
+    }
+    else {
+        const resolutionByFingerprint = resolution !== null
+            ? new Map(resolution.current.map((f) => [f.fingerprint, f.resolution]))
+            : null;
+        for (const f of findings) {
+            lines.push(...renderFinding(f, resolutionByFingerprint));
+        }
+    }
+    lines.push('## Summary', '');
+    lines.push(`- Launched: ${i.outcome.launched}, reporting: ${i.outcome.reporting}`);
+    lines.push(`- Suppressed: ${i.suppressed}`);
+    const degradedReviewers = i.outcome.results.filter((r) => r.state !== 'ok');
+    if (degradedReviewers.length > 0) {
+        const detail = degradedReviewers
+            .map((r) => `${r.reviewer.provider}/${r.reviewer.model} (${r.state}${r.error ? `: ${r.error}` : ''})`)
+            .join('; ');
+        lines.push(`- Degraded (${degradedReviewers.length}): ${detail}`);
+    }
+    else {
+        lines.push('- Degraded: none');
+    }
+    const costSuffix = i.outcome.costIncomplete
+        ? ' (incomplete — one or more reviewers had no cost data)'
+        : '';
+    lines.push(`- Total cost: ${i.outcome.totalCost === null ? 'unknown' : `$${i.outcome.totalCost.toFixed(4)}`}${costSuffix}`);
+    lines.push('');
+    const dest = path.join(run.path, 'REPORT.md');
+    fs.writeFileSync(dest, lines.join('\n'), 'utf8');
+    return dest;
+}
+// -------------------------------------------------------------------------------------------
+// HANDOFF.md (task 15.7)
+// -------------------------------------------------------------------------------------------
+/**
+ * Writes the handoff prompt — addressed to a coding agent, not to a person — naming the run
+ * directory and the merged findings file, requiring reproduction before any fix, directing
+ * ambiguity to the raw per-reviewer artifacts, and framing a low-agreement finding as a
+ * hypothesis to test rather than an established defect.
+ */
+export function writeHandoff(run, findingsPath) {
+    const reviewersDir = path.join(run.path, 'reviewers');
+    const text = [
+        '# Council review handoff',
+        '',
+        'You are a coding agent picking up the output of an automated, multi-model code review panel.',
+        'Treat this document as your instructions for what to do next, not as a report to read.',
+        '',
+        `Run directory: \`${run.path}\``,
+        `Merged findings: \`${findingsPath}\``,
+        '',
+        '## Before you change any code',
+        '',
+        'Every entry in the merged findings file is a claim made by one or more independent reviewer ' +
+            'models reading a frozen snapshot of the changed code, not a confirmed defect. For each ' +
+            'finding you intend to act on: reproduce it first — read the referenced file and line range ' +
+            'yourself and confirm the claimed behavior actually occurs — before you change anything. Do ' +
+            'not edit code to address a finding you have not reproduced.',
+        '',
+        '## When a finding is ambiguous',
+        '',
+        "If a merged finding's claim, location or severity is unclear, do not guess at what the " +
+            `reviewer meant. Consult that reviewer's raw output under \`${reviewersDir}\`: the ` +
+            '`<slug>.text.md` file holds its verbatim response (both attempts, if it needed a repair), ' +
+            'and the `<slug>.trace.jsonl` file holds every tool call and stream event it produced. The ' +
+            'merged claim is a summary; the raw artifact is the source of truth for what a reviewer ' +
+            'actually said.',
+        '',
+        '## Low-agreement findings are hypotheses, not defects',
+        '',
+        "Each finding records how many of the panel's reviewers raised it out of how many reported " +
+            '(its `agreement` field). A finding raised by only one or two reviewers out of a larger ' +
+            'panel is a hypothesis worth testing, not an established defect: treat it exactly as you ' +
+            "would treat a colleague's unconfirmed suspicion — worth investigating, not worth acting on " +
+            'without confirmation. A finding every reporting reviewer agreed on still requires the same ' +
+            'reproduction step above, but a low-agreement one additionally requires you to explain, in ' +
+            'your own investigation, why the disagreeing reviewers did not see it before treating it as ' +
+            'real.',
+        '',
+    ].join('\n');
+    const dest = path.join(run.path, 'HANDOFF.md');
+    fs.writeFileSync(dest, text, 'utf8');
+    return dest;
+}
+// -------------------------------------------------------------------------------------------
+// Reading and pruning past runs (tasks feeding the `show` and `gc` CLI commands)
+// -------------------------------------------------------------------------------------------
+/** Every run directory under `<projectRoot>/.council/reviews`, newest first. Lexicographic sort
+ * is chronological sort, per `createRunDir`'s id format. Returns `[]` when no run has ever been
+ * written (the reviews directory does not exist yet), rather than throwing. */
+export function listRuns(projectRoot) {
+    const reviewsDir = reviewsDirPath(projectRoot);
+    let entries;
+    try {
+        entries = fs.readdirSync(reviewsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const ids = entries
+        .filter((e) => e.name !== 'last' && !e.name.startsWith('.'))
+        .map((e) => e.name)
+        .filter((name) => {
+        try {
+            return fs.statSync(path.join(reviewsDir, name)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort()
+        .reverse();
+    return ids.map((id) => ({ id, path: path.join(reviewsDir, id), reviewsDir }));
+}
+/** Resolves the `last` symlink to the run id it points at, or `null` if it is absent, dangling, or
+ * not a symlink at all. Mirrors `resolve.ts`'s own reading of this pointer. */
+function resolveLastRunId(reviewsDir) {
+    try {
+        return path.basename(fs.realpathSync(path.join(reviewsDir, 'last')));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Prunes stored runs, retaining the `keep` most recent ones, and never removing the run `last`
+ * resolves to even if it would otherwise fall outside that count (it never does in practice,
+ * since `last` always points at the newest run, but the protection is explicit rather than
+ * incidental). Returns the ids removed; an empty array when there was nothing to prune.
+ */
+export function gcRuns(projectRoot, keep) {
+    const reviewsDir = reviewsDirPath(projectRoot);
+    const runs = listRuns(projectRoot); // newest first
+    const protectedId = resolveLastRunId(reviewsDir);
+    const keepCount = Math.max(0, keep);
+    const toKeep = new Set(runs.slice(0, keepCount).map((r) => r.id));
+    if (protectedId !== null)
+        toKeep.add(protectedId);
+    const removed = [];
+    for (const run of runs) {
+        if (toKeep.has(run.id))
+            continue;
+        fs.rmSync(run.path, { recursive: true, force: true });
+        removed.push(run.id);
+    }
+    return { removed };
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"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"}