peaks-loop 4.0.0-beta.2 → 4.0.0-beta.20

package/dist/src/cli/commands/migrate-1-4-1-command.js

@@ -1,34 +0,0 @@
-/**
- * `peaks workspace migrate-1-4-1` — R004 subcommand.
- *
- * Cleanup helper for projects upgraded from 1.4.1 → 1.4.2. Moves per-session
- * files from the legacy `.peaks/_runtime/<sid>/<role>/<file>.md` path into the canonical
- * `.peaks/_runtime/<sid>/<role>/<file>.md` path. Default is dry-run; pass
- * `--apply` to actually `rename` the files and remove emptied legacy dirs.
- */
-import { ok, fail } from '../../shared/result.js';
-import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
-import { addJsonOption } from '../cli-helpers.js';
-import { planMigrate1_4_1, applyMigrate1_4_1 } from '../../services/workspace/migrate-1-4-1-service.js';
-export function registerMigrate1_4_1Command(workspace, io) {
-    addJsonOption(workspace
-        .command('migrate-1-4-1')
-        .description('R004: Move per-session files from the legacy `.peaks/_runtime/<sid>/<role>/<file>.md` path into the canonical `.peaks/_runtime/<sid>/<role>/<file>.md` path. ' +
-        'Default: dry-run. Pass --apply to actually `rename` the files and remove emptied legacy dirs. ' +
-        'Reads each file once, computes sha256, compares to canonical. Identical-content duplicates are removed from legacy. Content-mismatch files are reported and NOT deleted (manual review).')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--apply', 'actually rename the files and remove empty legacy dirs (destructive); without it, dry-run only', false)).action(async (options) => {
-        try {
-            const projectRoot = resolveCanonicalProjectRoot(options.project);
-            const apply = options.apply === true;
-            const result = apply ? applyMigrate1_4_1(projectRoot) : planMigrate1_4_1(projectRoot);
-            const envelope = ok('workspace.migrate-1-4-1', result);
-            io.stdout(`${JSON.stringify(envelope, null, 2)}\n`);
-        }
-        catch (err) {
-            const envelope = fail('workspace.migrate-1-4-1', 'MIGRATE_FAILED', err.message, null, ['Run with --apply to attempt the move (default is dry-run only)']);
-            io.stdout(`${JSON.stringify(envelope, null, 2)}\n`);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/migrate-v2-10-to-v2-11-command.js

@@ -1,52 +0,0 @@
-/**
- * v2.11.0 — Group E (Tier 8): `peaks migrate v2-10-to-v2-11` command.
- *
- * Deprecation helper for projects upgraded from 2.10.0 → 2.11.0. The
- * peaks-rd `tech-doc.md` output was removed in 2.11.0 (Group A). This
- * migration prepends a YAML banner to every pre-2.11.0 session's
- * `rd/tech-doc.md` file marking it as `deprecated: historical`. The
- * immutable peaks-prd handoff at `prd/handoff.md` is the new source
- * of truth; old files coexist (text-only — no file moves per
- * Karpathy §3 surgical changes).
- *
- * Default: dry-run. Pass `--apply` to actually write.
- * Idempotent: re-running on an already-migrated tree is a no-op
- * (all files report `reason: 'already-deprecated'`).
- *
- * === Source: .peaks/memory/2026-06-26-v2-11-rm-rd-techdoc-immutable-handoff.md §"Tier 8" ===
- */
-import { addJsonOption } from '../cli-helpers.js';
-import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
-import { planV2ToV11Migration, applyV2ToV11Migration, dryRunV2ToV11Migration } from '../../services/migration/v2-10-to-v2-11-service.js';
-import { ok, fail } from '../../shared/result.js';
-export function registerMigrateV2ToV11Command(workspace, io) {
-    addJsonOption(workspace
-        .command('migrate-v2-10-to-v2-11')
-        .description('v2.11.0 Group E (Tier 8): prepend a YAML deprecation banner to every pre-v2.11.0 session\'s ' +
-        '`rd/tech-doc.md` file. Marks them `deprecated: historical` and points to the new peaks-prd ' +
-        'handoff as the source of truth. Text-only — no file moves. Default: dry-run; pass `--apply` ' +
-        'to actually write. Idempotent: re-running on an already-migrated tree is a no-op. Different ' +
-        'migration family from the legacy 0.5 to 1.4.1 runtime-layout helper — this command does NOT ' +
-        'move files, only prepends the banner.')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--apply', 'actually prepend the deprecation banner to each `rd/tech-doc.md` (idempotent); without it, dry-run only', false)).action(async (options) => {
-        try {
-            const projectRoot = resolveCanonicalProjectRoot(options.project);
-            const apply = options.apply === true;
-            const result = apply
-                ? applyV2ToV11Migration(planV2ToV11Migration(projectRoot))
-                : dryRunV2ToV11Migration(projectRoot);
-            const envelope = ok('workspace.migrate-v2-10-to-v2-11', result);
-            io.stdout(`${JSON.stringify(envelope, null, 2)}\n`);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            const envelope = fail('workspace.migrate-v2-10-to-v2-11', 'MIGRATE_V2_10_TO_V2_11_FAILED', message, null, [
-                'Run with --apply to attempt the deprecation banner write (default is dry-run only)',
-                'Verify the project path exists and contains at least one .peaks/_runtime/<sid>/rd/tech-doc.md'
-            ]);
-            io.stdout(`${JSON.stringify(envelope, null, 2)}\n`);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/mut-commands.d.ts

@@ -1,20 +0,0 @@
-import { Command } from 'commander';
-import { type StrykerInvoker } from '../../services/mut/mut-runner.js';
-import type { ProgramIO } from '../cli-helpers.js';
-export interface MutCommandsOptions {
-    readonly invokeStryker: StrykerInvoker;
-}
-/**
- * Construct the `peaks mut` family as a standalone Commander command.
- * Returns the parent `mut` Command so callers can attach it under any
- * root program (used both by `registerMutCommands` in production and
- * directly by the unit tests).
- */
-export declare function createMutCommands(opts: MutCommandsOptions): Command;
-/**
- * Program-level wiring: attach the `peaks mut` family to the root
- * program with the production Stryker invoker. Tests should use
- * `createMutCommands({ invokeStryker })` instead so the heavy
- * @stryker-mutator/core runtime stays out of the unit-test path.
- */
-export declare function registerMutCommands(program: Command, _io: ProgramIO): void;

package/dist/src/cli/commands/mut-commands.js

@@ -1,239 +0,0 @@
-/**
- * `peaks mut <sub>` — CLI surface for the mutation test-quality skill.
- * Per spec §4.2 验收审计 + §7 阶段二.
- *
- * Hard rules:
- *   - One-axis envelope layout (Plan 1 followup hotfix, commit 81f00ce):
- *     `--session-id` is REQUIRED on every artifact-producing subcommand,
- *     and `--change-id` is NEVER accepted on the parser.
- *   - H6 (CLI裁决, not LLM): `thresholds.passed` is computed by the
- *     ReportBuilder, not by the LLM. The CLI merely surfaces it.
- *   - H8 (audit trail hashable): every artifact carries a 64-hex sha256
- *     that chains back to TACT.sig via the `inputSig` field.
- *   - KISS: keep the public surface narrow — run / mutants / asserts /
- *     report. The CLI is a thin orchestrator over the service layer.
- */
-import { readFile } from 'node:fs/promises';
-import { Command } from 'commander';
-import { scanAssertions } from '../../services/mut/assert-scanner.js';
-import { runMutation } from '../../services/mut/mut-runner.js';
-import { buildMutReport } from '../../services/mut/report-builder.js';
-import { createProductionStrykerInvoker } from '../../services/mut/production-stryker.js';
-import { MutReportSchema } from '../../services/mut/types.js';
-/**
- * Pure helper: a stub AssertionsReport used when only Stryker ran.
- * The mutants-only path does NOT touch the AST scanner; we still need
- * a structurally-valid `assertions` block so the Zod schema accepts
- * the assembled report.
- */
-function emptyAssertions() {
-    return {
-        totalAssertions: 0,
-        weakAssertions: 0,
-        weakRate: 0,
-        weakPatterns: [],
-    };
-}
-/**
- * Pure helper: a stub MutationReport used when only the assertion
- * scan ran. Mirrors the asserts-only path's invariants (killRate = 0,
- * mutantsTotal = 0, tool = 'stryker' for forward compatibility).
- */
-function emptyMutation() {
-    return {
-        tool: 'stryker',
-        mutantsTotal: 0,
-        mutantsKilled: 0,
-        mutantsSurvived: 0,
-        mutantsTimeout: 0,
-        killRate: 0,
-        byFile: [],
-    };
-}
-/**
- * Emit a one-line JSON envelope describing the run's outcome. Used by
- * both `--json` and the human-readable branches so the `passed` /
- * `sha256` shape stays consistent regardless of TTY mode.
- */
-function emitSummary(json, payload) {
-    if (json) {
-        process.stdout.write(JSON.stringify(payload) + '\n');
-    }
-    else {
-        process.stdout.write(`mut-report.json: ${payload.path}\nsha256: ${payload.sha256}\npassed: ${payload.passed}\n`);
-    }
-}
-/**
- * Construct the `peaks mut` family as a standalone Commander command.
- * Returns the parent `mut` Command so callers can attach it under any
- * root program (used both by `registerMutCommands` in production and
- * directly by the unit tests).
- */
-export function createMutCommands(opts) {
-    const mut = new Command('mut').description('peaks-mut: mutation testing + assertion validity scan (spec §4.2 / §7)');
-    mut
-        .command('run')
-        .description('Run the full mut pipeline (Stryker + assertion scan + report). One-axis: --session-id required.')
-        .requiredOption('--project <path>', 'project root')
-        .requiredOption('--test-files <files...>', 'test files to mutate against')
-        .requiredOption('--input-sig <hex>', 'TACT.sig (sha256) for chain')
-        .requiredOption('--session-id <sid>', 'session id; CLI writes artifacts only under .peaks/_runtime/<sid>/mut/ (one-axis layout)')
-        .requiredOption('--out <path>', 'output path for mut-report.json')
-        .option('--json', 'machine-readable output', false)
-        .action(async (a) => {
-        const { mutation } = await runMutation({
-            project: a.project,
-            testFiles: a.testFiles,
-            invokeStryker: opts.invokeStryker,
-        });
-        const assertions = await scanAssertions({
-            project: a.project,
-            testFiles: a.testFiles,
-        });
-        const report = await buildMutReport({
-            inputSig: a.inputSig,
-            out: a.out,
-            mutation,
-            assertions,
-        });
-        emitSummary(a.json, {
-            ok: true,
-            sha256: report.sha256,
-            passed: report.thresholds.passed,
-            path: a.out,
-        });
-        if (!report.thresholds.passed) {
-            // H6: CLI裁决 — threshold breach is a non-zero exit so callers
-            // (peaks-rd, peaks-qa, CI) can block on it without parsing
-            // stdout.
-            process.exitCode = 1;
-        }
-    });
-    mut
-        .command('mutants')
-        .description('Run Stryker only; write a stub-assertions mut-report.json. One-axis: --session-id required.')
-        .requiredOption('--project <path>', 'project root')
-        .requiredOption('--test-files <files...>', 'test files to mutate against')
-        .requiredOption('--input-sig <hex>', 'TACT.sig')
-        .requiredOption('--session-id <sid>', 'session id')
-        .requiredOption('--out <path>', 'output path for mut-report.json')
-        .option('--json', 'machine-readable output', false)
-        .action(async (a) => {
-        const { mutation } = await runMutation({
-            project: a.project,
-            testFiles: a.testFiles,
-            invokeStryker: opts.invokeStryker,
-        });
-        const report = await buildMutReport({
-            inputSig: a.inputSig,
-            out: a.out,
-            mutation,
-            assertions: emptyAssertions(),
-        });
-        emitSummary(a.json, {
-            ok: true,
-            sha256: report.sha256,
-            passed: report.thresholds.passed,
-            path: a.out,
-        });
-        if (!report.thresholds.passed) {
-            process.exitCode = 1;
-        }
-    });
-    mut
-        .command('asserts')
-        .description('Run the assertion scan only; write a mut-report.json with empty mutation block. One-axis: --session-id required.')
-        .requiredOption('--project <path>', 'project root')
-        .requiredOption('--test-files <files...>', 'test files to scan')
-        .requiredOption('--input-sig <hex>', 'TACT.sig')
-        .requiredOption('--session-id <sid>', 'session id')
-        .requiredOption('--out <path>', 'output path for mut-report.json')
-        .option('--json', 'machine-readable output', false)
-        .action(async (a) => {
-        const assertions = await scanAssertions({
-            project: a.project,
-            testFiles: a.testFiles,
-        });
-        const report = await buildMutReport({
-            inputSig: a.inputSig,
-            out: a.out,
-            mutation: emptyMutation(),
-            assertions,
-        });
-        emitSummary(a.json, {
-            ok: true,
-            sha256: report.sha256,
-            passed: report.thresholds.passed,
-            path: a.out,
-        });
-        if (!report.thresholds.passed) {
-            process.exitCode = 1;
-        }
-    });
-    mut
-        .command('report')
-        .description('Re-read a previously-written mut-report.json (no Stryker / scan invocation). One-axis: --session-id required for the audit trail.')
-        .requiredOption('--in <path>', 'input mut-report.json path')
-        .requiredOption('--session-id <sid>', 'session id')
-        .option('--json', 'machine-readable output', false)
-        .action(async (a) => {
-        const raw = await readFile(a.in, 'utf8');
-        let parsedJson;
-        try {
-            parsedJson = JSON.parse(raw);
-        }
-        catch (err) {
-            process.stderr.write(`INVALID_JSON: ${err instanceof Error ? err.message : String(err)}\n`);
-            process.exitCode = 2;
-            return;
-        }
-        const parsed = MutReportSchema.safeParse(parsedJson);
-        if (!parsed.success) {
-            process.stderr.write(`INVALID: ${parsed.error.message}\n`);
-            process.exitCode = 2;
-            return;
-        }
-        const r = parsed.data;
-        const summary = {
-            mutation: {
-                tool: r.mutation.tool,
-                killRate: r.mutation.killRate,
-            },
-            assertions: {
-                total: r.assertions.totalAssertions,
-                weak: r.assertions.weakAssertions,
-                weakRate: r.assertions.weakRate,
-            },
-            thresholds: { passed: r.thresholds.passed },
-            followups: r.followups.length,
-            sha256: r.sha256,
-            sessionId: a.sessionId,
-        };
-        if (a.json) {
-            process.stdout.write(JSON.stringify(summary) + '\n');
-        }
-        else {
-            process.stdout.write([
-                `mutation: tool=${r.mutation.tool} killRate=${(r.mutation.killRate * 100).toFixed(1)}%`,
-                `assertions: total=${r.assertions.totalAssertions} weak=${r.assertions.weakAssertions} rate=${(r.assertions.weakRate * 100).toFixed(1)}%`,
-                `thresholds: passed=${r.thresholds.passed}`,
-                `followups: ${r.followups.length}`,
-                `sha256: ${r.sha256}`,
-            ].join('\n') + '\n');
-        }
-        if (!r.thresholds.passed) {
-            process.exitCode = 1;
-        }
-    });
-    return mut;
-}
-/**
- * Program-level wiring: attach the `peaks mut` family to the root
- * program with the production Stryker invoker. Tests should use
- * `createMutCommands({ invokeStryker })` instead so the heavy
- * @stryker-mutator/core runtime stays out of the unit-test path.
- */
-export function registerMutCommands(program, _io) {
-    const invokeStryker = createProductionStrykerInvoker();
-    program.addCommand(createMutCommands({ invokeStryker }));
-}

package/dist/src/cli/commands/observability-commands.js

@@ -1,201 +0,0 @@
-/**
- * `peaks observability <subcommand>` — Slice B/C of v2.11.1.
- *
- * Slice B ships 4 read-only subcommands (AC-1 to AC-4):
- *   - `peaks observability status`         (AC-1)
- *   - `peaks observability slices`         (AC-2)
- *   - `peaks observability fanout`         (AC-3)
- *   - `peaks observability repair-cycles`  (AC-4)
- *
- * `peaks observability report` (AC-5) lands in Slice D when the
- * markdown report formatter is implemented.
- *
- * Read-only — never writes. Reads the JSONL metrics files emitted
- * by the `peaks request transition` hook (Slice A) plus the future
- * Slice C hook sites (dispatch / checkpoint / mode-gate / context
- * / post-compact). The aggregations tolerate zero events gracefully
- * so each subcommand returns a meaningful empty result on a fresh
- * tree.
- */
-import { findProjectRoot } from '../../services/config/config-safety.js';
-import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
-import { fail, ok } from '../../shared/result.js';
-import { getSessionIdCanonical } from '../../services/session/session-manager.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { aggregateFanout, aggregateRepairCycles, aggregateSlices, aggregateStatus, filterByPeriod, periodStartIso, readAllSessionEvents, readSessionEvents } from '../../services/observability/aggregation.js';
-import { renderObservabilityReport } from '../../services/observability/report-formatter.js';
-function resolveProjectRoot(optionProject) {
-    return optionProject !== undefined
-        ? resolveCanonicalProjectRoot(optionProject)
-        : (findProjectRoot(process.cwd()) ?? process.cwd());
-}
-function resolveSessionId(optionSession, projectRoot) {
-    if (optionSession !== undefined)
-        return optionSession;
-    return getSessionIdCanonical(projectRoot) ?? undefined;
-}
-function runStatus(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    try {
-        const events = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const status = aggregateStatus(events);
-        const warnings = sessionId === undefined && status.totalEvents === 0
-            ? ['No observability events found in any session — emit a slice transition via `peaks request transition` to populate.']
-            : [];
-        printResult(io, ok('observability.status', {
-            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-            status
-        }, warnings), options.json);
-    }
-    catch (error) {
-        printResult(io, fail('observability.status', 'OBSERVABILITY_STATUS_FAILED', getErrorMessage(error), { projectRoot }, ['Run `peaks observability slices` for per-slice detail']), options.json);
-        process.exitCode = 1;
-    }
-}
-function runSlices(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    try {
-        const events = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const slices = aggregateSlices(events);
-        printResult(io, ok('observability.slices', {
-            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-            total: slices.length,
-            slices
-        }, []), options.json);
-    }
-    catch (error) {
-        printResult(io, fail('observability.slices', 'OBSERVABILITY_SLICES_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
-        process.exitCode = 1;
-    }
-}
-function runFanout(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    try {
-        const events = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const fanout = aggregateFanout(events);
-        const warnings = fanout.total === 0
-            ? ['No dispatch events recorded yet — Slice C will wire `peaks sub-agent dispatch`; until then fanout is empty.']
-            : [];
-        printResult(io, ok('observability.fanout', {
-            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-            fanout
-        }, warnings), options.json);
-    }
-    catch (error) {
-        printResult(io, fail('observability.fanout', 'OBSERVABILITY_FANOUT_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
-        process.exitCode = 1;
-    }
-}
-function runRepairCycles(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    try {
-        const events = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const cycles = aggregateRepairCycles(events);
-        printResult(io, ok('observability.repair-cycles', {
-            scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-            cycles
-        }, []), options.json);
-    }
-    catch (error) {
-        printResult(io, fail('observability.repair-cycles', 'OBSERVABILITY_REPAIR_CYCLES_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
-        process.exitCode = 1;
-    }
-}
-const VALID_PERIODS = ['day', 'week', 'month'];
-function runReport(io, options) {
-    const projectRoot = resolveProjectRoot(options.project);
-    const sessionId = resolveSessionId(options.session, projectRoot);
-    const period = options.period !== undefined && VALID_PERIODS.includes(options.period)
-        ? options.period
-        : 'day';
-    try {
-        const allEvents = sessionId !== undefined
-            ? readSessionEvents(projectRoot, sessionId)
-            : readAllSessionEvents(projectRoot);
-        const periodStart = periodStartIso(period);
-        const events = filterByPeriod(allEvents, period);
-        const markdown = renderObservabilityReport({
-            scope: sessionId !== undefined ? 'session' : 'all-sessions',
-            scopeId: sessionId ?? 'all',
-            period,
-            generatedAt: new Date().toISOString(),
-            status: aggregateStatus(events),
-            slices: aggregateSlices(events),
-            fanout: aggregateFanout(events),
-            repairCycles: aggregateRepairCycles(events)
-        });
-        if (options.json === true) {
-            // --json on report: emit a metadata envelope so callers can
-            // machine-parse the markdown body without losing the envelope
-            // contract.
-            printResult(io, ok('observability.report', {
-                scope: sessionId !== undefined ? { sessionId } : { allSessions: true },
-                period,
-                periodStart,
-                totalEventsScanned: allEvents.length,
-                totalEventsInPeriod: events.length,
-                markdown
-            }, []), true);
-            return;
-        }
-        io.stdout(markdown);
-    }
-    catch (error) {
-        printResult(io, fail('observability.report', 'OBSERVABILITY_REPORT_FAILED', getErrorMessage(error), { projectRoot }, []), options.json);
-        process.exitCode = 1;
-    }
-}
-export function registerObservabilityCommands(program, io) {
-    const observability = program
-        .command('observability')
-        .description('Read-only slice topology observability queries (v2.11.1). Reads JSONL metrics from .peaks/_runtime/<sessionId>/metrics/slices.jsonl.');
-    addJsonOption(observability
-        .command('status')
-        .description('Aggregate metrics for the active session (or all sessions with --project + omitted --session). Includes totalEvents / totalSlices / successCount / failCount / repairCyclePeak / fanoutCostTotal.')
-        .option('--project <path>', 'target project root (defaults to git root or cwd)')
-        .option('--session <sessionId>', 'scope to one session (defaults to the canonical session binding)')).action((options) => {
-        runStatus(io, options);
-    });
-    addJsonOption(observability
-        .command('slices')
-        .description('List all slices for the scope. Per slice: rid, transition count, first/last ts, durationMs, finalState, fanoutCount, repairCycleCount, success.')
-        .option('--project <path>', 'target project root (defaults to git root or cwd)')
-        .option('--session <sessionId>', 'scope to one session (defaults to the canonical session binding)')).action((options) => {
-        runSlices(io, options);
-    });
-    addJsonOption(observability
-        .command('fanout')
-        .description('Fanout cost breakdown by sub-agent role (rd / qa / code-reviewer / karpathy-reviewer / peaks-security-audit / peaks-perf-audit; v2.12.0 collapse — `security-reviewer` removed from the role enum). Returns 0 per role until Slice C wires the `peaks sub-agent dispatch` hook.')
-        .option('--project <path>', 'target project root (defaults to git root or cwd)')
-        .option('--session <sessionId>', 'scope to one session (defaults to the canonical session binding)')).action((options) => {
-        runFanout(io, options);
-    });
-    addJsonOption(observability
-        .command('repair-cycles')
-        .description('RD → QA repair-cycle count per slice. Cap = 3 (peaks-code repair-loop contract); capHit flag is set when any slice hits the cap.')
-        .option('--project <path>', 'target project root (defaults to git root or cwd)')
-        .option('--session <sessionId>', 'scope to one session (defaults to the canonical session binding)')).action((options) => {
-        runRepairCycles(io, options);
-    });
-    observability
-        .command('report')
-        .description('Render a markdown summary suitable for paste into PR descriptions or .peaks/PROJECT.md timeline entries. Default period = day; --json emits an envelope wrapping the markdown body. Output sections: header + status summary + slice table + fanout table + repair-cycle table + top-N slowest slices.')
-        .option('--project <path>', 'target project root (defaults to git root or cwd)')
-        .option('--session <sessionId>', 'scope to one session (defaults to the canonical session binding)')
-        .option('--period <period>', 'one of: day | week | month (defaults to day)', 'day')
-        .action((options) => {
-        runReport(io, options);
-    });
-}