peaks-loop 4.0.0-beta.3 → 4.0.0-beta.31

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

@@ -1,237 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { loadOpenSpecChange, scanOpenSpec } from '../../services/openspec/openspec-scan-service.js';
-import { projectOpenSpecToRdInput } from '../../services/openspec/openspec-bridge-service.js';
-import { renderOpenSpecChange } from '../../services/openspec/openspec-render-service.js';
-import { validateOpenSpecChange } from '../../services/openspec/openspec-validate-service.js';
-import { archiveOpenSpecChange } from '../../services/openspec/openspec-archive-service.js';
-import { executeOpenSpecInit } from '../../services/openspec/openspec-init-service.js';
-import { proposeFromDoctor } from '../../services/openspec/openspec-propose-from-doctor-service.js';
-import { runDoctor } from '../../services/doctor/doctor-service.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-function resolveScanOptions(project) {
-    if (project === undefined) {
-        return {};
-    }
-    return { openspecRoot: `${project.replace(/\\/g, '/').replace(/\/$/, '')}/openspec` };
-}
-async function loadRenderRequest(requestPath) {
-    const raw = await readFile(requestPath, 'utf8');
-    const parsed = JSON.parse(raw);
-    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new Error('Render request file must contain a JSON object');
-    }
-    return parsed;
-}
-export function registerOpenSpecCommands(program, io) {
-    const openspec = program.command('openspec').description('Inspect OpenSpec changes inside the target project');
-    addJsonOption(openspec
-        .command('list')
-        .description('List OpenSpec changes detected under <project>/openspec/changes')
-        .option('--project <path>', 'project root containing an openspec/ directory')).action(async (options) => {
-        try {
-            const report = await scanOpenSpec(resolveScanOptions(options.project));
-            printResult(io, ok('openspec.list', report), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('openspec.list', 'OPENSPEC_LIST_FAILED', getErrorMessage(error), {}, ['Check the project path and openspec/ layout before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(openspec
-        .command('show')
-        .description('Show parsed proposal and tasks progress for a single OpenSpec change')
-        .argument('<changeId>', 'OpenSpec change directory name under openspec/changes')
-        .option('--project <path>', 'project root containing an openspec/ directory')).action(async (changeId, options) => {
-        try {
-            const detail = await loadOpenSpecChange(changeId, resolveScanOptions(options.project));
-            if (detail === null) {
-                printResult(io, fail('openspec.show', 'OPENSPEC_CHANGE_NOT_FOUND', `OpenSpec change ${changeId} was not found`, { changeId }, [`Verify openspec/changes/${changeId}/ exists`]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('openspec.show', detail), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('openspec.show', 'OPENSPEC_SHOW_FAILED', getErrorMessage(error), { changeId }, ['Check the project path and openspec/ layout before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(openspec
-        .command('to-rd')
-        .description('Project an OpenSpec change into an RD/SC input shape (acceptance, what-changes, commit boundaries)')
-        .argument('<changeId>', 'OpenSpec change directory name under openspec/changes')
-        .option('--project <path>', 'project root containing an openspec/ directory')).action(async (changeId, options) => {
-        try {
-            const projection = await projectOpenSpecToRdInput(changeId, resolveScanOptions(options.project));
-            if (projection === null) {
-                printResult(io, fail('openspec.to-rd', 'OPENSPEC_CHANGE_NOT_FOUND', `OpenSpec change ${changeId} was not found`, { changeId }, [`Verify openspec/changes/${changeId}/ exists`]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('openspec.to-rd', projection), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('openspec.to-rd', 'OPENSPEC_TO_RD_FAILED', getErrorMessage(error), { changeId }, ['Check the project path and openspec/ layout before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(openspec
-        .command('render')
-        .description('Render an OpenSpec change pack from a JSON request file (dry-run by default)')
-        .requiredOption('--request <path>', 'path to a JSON file describing the render request')
-        .option('--project <path>', 'project root containing an openspec/ directory')
-        .option('--apply', 'write the rendered files into openspec/changes/<id>/')
-        .option('--overwrite', 'overwrite an existing change directory when --apply is set')).action(async (options) => {
-        try {
-            const request = await loadRenderRequest(options.request);
-            const scan = resolveScanOptions(options.project);
-            const renderOptions = {};
-            if (scan.openspecRoot !== undefined) {
-                renderOptions.openspecRoot = scan.openspecRoot;
-            }
-            if (options.apply === true) {
-                renderOptions.apply = true;
-            }
-            if (options.overwrite === true) {
-                renderOptions.overwrite = true;
-            }
-            const result = await renderOpenSpecChange(request, renderOptions);
-            printResult(io, ok('openspec.render', result), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('openspec.render', 'OPENSPEC_RENDER_FAILED', getErrorMessage(error), { requestPath: options.request }, ['Check the request JSON shape and the openspec root before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(openspec
-        .command('validate')
-        .description('Validate an OpenSpec change against internal lint rules (and optionally the external openspec CLI)')
-        .argument('<changeId>', 'OpenSpec change directory name under openspec/changes')
-        .option('--project <path>', 'project root containing an openspec/ directory')
-        .option('--prefer-external', 'use the external openspec CLI when available, fall back to internal lint')).action(async (changeId, options) => {
-        try {
-            const scan = resolveScanOptions(options.project);
-            const validateOptions = {};
-            if (scan.openspecRoot !== undefined) {
-                validateOptions.openspecRoot = scan.openspecRoot;
-            }
-            if (options.preferExternal === true) {
-                validateOptions.preferExternal = true;
-            }
-            const result = await validateOpenSpecChange(changeId, validateOptions);
-            if (result === null) {
-                printResult(io, fail('openspec.validate', 'OPENSPEC_CHANGE_NOT_FOUND', `OpenSpec change ${changeId} was not found`, { changeId }, [`Verify openspec/changes/${changeId}/ exists`]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            if (!result.valid) {
-                printResult(io, fail('openspec.validate', 'OPENSPEC_VALIDATE_INVALID', `OpenSpec change ${changeId} failed validation`, result, result.issues.map((issue) => `${issue.level}: ${issue.rule}: ${issue.message}`)), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('openspec.validate', result, result.issues.filter((issue) => issue.level === 'warning').map((issue) => `${issue.rule}: ${issue.message}`)), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('openspec.validate', 'OPENSPEC_VALIDATE_FAILED', getErrorMessage(error), { changeId }, ['Check the project path and openspec/ layout before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(openspec
-        .command('archive')
-        .description('Move an OpenSpec change under openspec/changes/<archiveDir>/<id>/ (dry-run by default)')
-        .argument('<changeId>', 'OpenSpec change directory name under openspec/changes')
-        .option('--project <path>', 'project root containing an openspec/ directory')
-        .option('--apply', 'actually move the change directory')
-        .option('--archive-dir <name>', 'archive subdirectory name (default: archive)')).action(async (changeId, options) => {
-        try {
-            const scan = resolveScanOptions(options.project);
-            const archiveOptions = {};
-            if (scan.openspecRoot !== undefined) {
-                archiveOptions.openspecRoot = scan.openspecRoot;
-            }
-            if (options.apply === true) {
-                archiveOptions.apply = true;
-            }
-            if (options.archiveDir !== undefined) {
-                archiveOptions.archiveDirName = options.archiveDir;
-            }
-            const result = await archiveOpenSpecChange(changeId, archiveOptions);
-            if (result === null) {
-                printResult(io, fail('openspec.archive', 'OPENSPEC_CHANGE_NOT_FOUND', `OpenSpec change ${changeId} was not found`, { changeId }, [`Verify openspec/changes/${changeId}/ exists`]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('openspec.archive', result, [], result.applied ? [] : [`Re-run with --apply to move ${result.from} → ${result.to}`]), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('openspec.archive', 'OPENSPEC_ARCHIVE_FAILED', getErrorMessage(error), { changeId }, ['Check the project path and openspec/ layout before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(openspec
-        .command('init')
-        .description('Scaffold the openspec/ directory in the target project (changes/, archive/, README.md, CHANGES.md). Idempotent — refuses to overwrite an existing openspec/')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--apply', 'write files to disk (default: dry-run preview)', false)).action(async (options) => {
-        try {
-            const result = await executeOpenSpecInit({
-                projectRoot: options.project,
-                apply: options.apply === true
-            });
-            const nextActions = [];
-            if (result.alreadyInitialized) {
-                nextActions.push('openspec/ already exists; no files were created or modified.');
-                if (result.existingFiles.length > 0) {
-                    nextActions.push(`Existing files preserved: ${result.existingFiles.join(', ')}`);
-                }
-            }
-            else if (!result.apply) {
-                nextActions.push('Re-run with --apply to write the planned files to disk.');
-            }
-            else {
-                nextActions.push('Run `peaks openspec render --request <path> --apply` to scaffold a first change proposal.');
-            }
-            printResult(io, ok('openspec.init', result, [], nextActions), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('openspec.init', 'OPENSPEC_INIT_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Verify the project path exists and is writable']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(openspec
-        .command('from-doctor')
-        .description('Slice L3.3: generate an OpenSpec change draft (proposal.md) from a peaks doctor finding')
-        .requiredOption('--project <path>', 'target project root')
-        .requiredOption('--check-id <id>', 'the doctor check id to draft from (e.g. L3:l3-memory-health)')).action(async (options) => {
-        try {
-            const report = await runDoctor();
-            const finding = report.checks.find((c) => c.id === options.checkId);
-            if (finding === undefined) {
-                printResult(io, fail('openspec.from-doctor', 'CHECK_NOT_FOUND', `No doctor check with id "${options.checkId}"`, { availableIds: report.checks.map((c) => c.id) }, ['Run peaks doctor --json to list available check ids']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            if (finding.ok) {
-                printResult(io, fail('openspec.from-doctor', 'CHECK_ALREADY_PASSING', `Doctor check "${options.checkId}" is already passing; nothing to draft`, { checkId: options.checkId }, ['Pick a failing check from peaks doctor --json']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            const doctorFinding = {
-                id: finding.id,
-                rule: finding.rule ?? finding.id,
-                detail: finding.message,
-                severity: 'fail',
-            };
-            const result = proposeFromDoctor({ projectRoot: options.project, finding: doctorFinding });
-            printResult(io, ok('openspec.from-doctor', result, [], [
-                `draft proposal written to ${result.proposalPath}`,
-                'Review + edit the draft, then run `peaks openspec validate <id>`',
-            ]), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('openspec.from-doctor', 'OPENSPEC_FROM_DOCTOR_FAILED', getErrorMessage(error), { projectRoot: options.project, checkId: options.checkId }, ['Verify the project path and the check id']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/perf-audit-commands.js

@@ -1,132 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { detectPerfAudit, isPerfAuditEnvelope, runPerfAudit, } from '../../services/audit-independent/perf-audit-service.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
-function resolveEnvelope(envelopePath) {
-    if (envelopePath === undefined || envelopePath === '-') {
-        // Read from stdin
-        return readStdinSync();
-    }
-    try {
-        const raw = readFileSync(envelopePath, 'utf8');
-        return JSON.parse(raw);
-    }
-    catch (error) {
-        throw new Error(`Failed to read envelope from ${envelopePath}: ${getErrorMessage(error)}`);
-    }
-}
-function readStdinSync() {
-    // Node 22: read stdin synchronously via fs.readFileSync(0, 'utf8').
-    // We use the file descriptor 0 convention.
-    try {
-        // Lazy import to avoid pulling readline at module load
-        const { readFileSync: rfs } = require('node:fs');
-        const raw = rfs(0, 'utf8');
-        if (raw.trim().length === 0) {
-            throw new Error('stdin was empty; expected JSON envelope on stdin or --envelope <path>');
-        }
-        return JSON.parse(raw);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message.startsWith('stdin was empty')) {
-            throw error;
-        }
-        throw new Error(`Failed to read envelope from stdin: ${getErrorMessage(error)}`);
-    }
-}
-export function registerPerfAuditCommands(program, io) {
-    const perfAudit = program
-        .command('perf-audit')
-        .description('Independent performance audit skill driver. Reads the immutable peaks-prd handoff (sha256-locked) + the project-level perf-template.md, then writes a structured perf-<rid>.md artifact. Decoupled from peaks-rd 5-way fan-out per slice v2.12.0 (Group A, Tier 3). See skills/bee/peaks-perf-audit/SKILL.md for the full workflow.');
-    addJsonOption(perfAudit
-        .command('detect')
-        .description('Read-only probe: returns the 5-state perf-audit runtime as a JSON envelope (ready / handoff-missing / template-missing / dispatch-failed / envelope-malformed). The peaks-perf-audit skill calls this first to decide whether to invoke `run`. Mirrors `peaks security-audit detect` semantics.')
-        .option('--rid <rid>', 'request id (e.g. 2026-06-27-v2-12-...)')
-        .option('--sid <sid>', 'session id (e.g. 2026-06-27-session-...)')
-        .option('--project <path>', 'project root (default: cwd)')).action((options) => {
-        const projectRoot = options.project ?? process.cwd();
-        const sid = options.sid;
-        if (sid === undefined || sid.length === 0) {
-            printResult(io, fail('perf-audit.detect', 'SID_REQUIRED', 'session id (--sid) is required for perf-audit.detect', { state: 'sid-missing' }, ['Pass --sid <session-id> (e.g. 2026-06-27-session-...)', 'Run `peaks session info --active --json` to find the active sid.']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const detect = detectPerfAudit({
-                projectRoot,
-                sessionId: sid,
-            });
-            const envelope = detect.state === 'ready'
-                ? ok('perf-audit.detect', detect, [...detect.warnings], [...detect.nextActions])
-                : fail('perf-audit.detect', detect.state.toUpperCase().replace(/-/g, '_'), `perf-audit is not ready: ${detect.state}`, detect, [...detect.nextActions]);
-            printResult(io, envelope, options.json);
-            if (detect.state !== 'ready') {
-                process.exitCode = 1;
-            }
-        }
-        catch (error) {
-            printResult(io, fail('perf-audit.detect', 'DETECT_PERF_AUDIT_FAILED', getErrorMessage(error), {
-                state: 'detection-failed',
-                handoffPresent: false,
-                templatePresent: false,
-                warnings: [],
-                nextActions: [],
-            }, ['Re-run with --project <path> pointing at a known-good project root.']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(perfAudit
-        .command('run')
-        .description('Run the full perf-audit pipeline: detect → read handoff + template → write audit artifact to `.peaks/_runtime/<sid>/audit/perf-<rid>.md`. Reads the envelope JSON from --envelope <path> or stdin. The peaks-perf-audit skill emits the envelope; this CLI validates the shape via isPerfAuditEnvelope and writes the artifact. Exits 0 on success, 1 on any failure mode (detection, validation, or write).')
-        .option('--rid <rid>', 'request id (e.g. 2026-06-27-v2-12-...)')
-        .option('--sid <sid>', 'session id (e.g. 2026-06-27-session-...)')
-        .option('--project <path>', 'project root (default: cwd)')
-        .option('--envelope <path>', 'path to envelope JSON file; "-" reads from stdin (default: stdin)')).action((options) => {
-        const projectRoot = options.project ?? process.cwd();
-        const sid = options.sid;
-        const rid = options.rid;
-        if (sid === undefined || sid.length === 0) {
-            printResult(io, fail('perf-audit.run', 'SID_REQUIRED', 'session id (--sid) is required for perf-audit.run', {}, ['Pass --sid <session-id> (e.g. 2026-06-27-session-...)']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        if (rid === undefined || rid.length === 0) {
-            printResult(io, fail('perf-audit.run', 'RID_REQUIRED', 'request id (--rid) is required for perf-audit.run', {}, ['Pass --rid <request-id> (e.g. 2026-06-27-v2-12-...)']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const envelopeValue = resolveEnvelope(options.envelope);
-            if (!isPerfAuditEnvelope(envelopeValue)) {
-                printResult(io, fail('perf-audit.run', 'ENVELOPE_MALFORMED', 'envelope failed isPerfAuditEnvelope validation (expected { verdict, violations, summary })', { receivedType: typeof envelopeValue }, [
-                    'Verify the peaks-perf-audit skill prompt matches the strict-shape contract.',
-                    'Re-emit the envelope; see skills/bee/peaks-perf-audit/references/audit-protocol.md.'
-                ]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            const result = runPerfAudit({
-                projectRoot,
-                sessionId: sid,
-                rid,
-                generatedAt: new Date().toISOString(),
-                envelope: envelopeValue,
-            });
-            if (result.detect.state !== 'ready' || result.artifactPath === null) {
-                printResult(io, fail('perf-audit.run', result.detect.state.toUpperCase().replace(/-/g, '_'), `perf-audit is not ready: ${result.detect.state}`, result, [...result.detect.nextActions]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('perf-audit.run', {
-                detect: result.detect,
-                artifactPath: result.artifactPath,
-                violationsCount: result.violationsCount,
-                verdict: result.verdict,
-            }, [...result.detect.warnings], [...result.detect.nextActions]), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('perf-audit.run', 'RUN_PERF_AUDIT_FAILED', getErrorMessage(error), {}, ['Verify the envelope JSON is well-formed and matches the strict-shape contract.']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}

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

@@ -1,41 +0,0 @@
-import { executePerfBaselineInit, resolveProjectRootFromCwd } from '../../services/perf/perf-baseline-service.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-export function registerPerfCommands(program, io) {
-    const perf = program.command('perf').description('Manage performance baseline scaffolding for the RD stage');
-    addJsonOption(perf
-        .command('baseline')
-        .description('Scaffold .peaks/_runtime/<sid>/rd/perf-baseline.md so the RD can record the slice\'s perf numbers in a stable place that QA Gate A4 can diff against. Default dry-run; pass --apply to write.')
-        .option('--project <path>', 'target project root (defaults to git root or cwd)')
-        .option('--apply', 'write the scaffold into the target project', false)
-        .option('--reason <text>', 'human-readable reason for the baseline (recorded in the response data)')).action(async (options) => {
-        try {
-            const projectRoot = options.project !== undefined
-                ? options.project
-                : resolveProjectRootFromCwd(process.cwd());
-            const result = await executePerfBaselineInit({
-                projectRoot,
-                apply: options.apply === true,
-                ...(options.reason !== undefined ? { reason: options.reason } : {})
-            });
-            const nextActions = [];
-            if (result.sessionId === null) {
-                nextActions.push('No peaks session is bound for this project yet. Run `peaks workspace init` (or any peaks skill) first so a session directory exists.');
-            }
-            else if (result.alreadyInitialized) {
-                nextActions.push(`perf-baseline.md already exists; no files were written. Re-run only after a re-measurement if you intend to overwrite.`);
-            }
-            else if (!result.apply) {
-                nextActions.push('Re-run with --apply to write the scaffold.');
-            }
-            else {
-                nextActions.push('Open the file and fill in the Results table — that is the input QA Gate A4 will diff against.');
-            }
-            printResult(io, ok('perf.baseline', result, [], nextActions), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('perf.baseline', 'PERF_BASELINE_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Verify the project path exists and is writable']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/prd-blocks-commands.js

@@ -1,50 +0,0 @@
-/**
- * v2.15.0 follow-up — G3: prd 4 必填块 CLI (sub-command under existing `peaks prd`).
- *
- *   - `peaks prd check-blocks <request-id>` — validate the prd artifact
- *     contains the 4 mandatory sections (业务场景 / 边界 case /
- *     UI 装配意图 / 上游基线). Complements `peaks request lint`
- *     (which checks placeholders) by checking the design quality
- *     lock-down at the prd stage.
- *
- * NOTE: lives under existing `peaks prd` (registered by
- * `prd-commands.ts`). This file does NOT create a new top-level
- * `peaks prd` — that would collide with the existing prd-commands
- * registration and break `peaks request transition --role prd` due
- * to Commander routing conflicts.
- */
-import { findProjectRoot } from '../../services/config/config-safety.js';
-import { checkPrdBlocks } from '../../services/prd/prd-blocks-checker.js';
-import { ok } from '../../shared/result.js';
-import { addJsonOption, printResult } from '../cli-helpers.js';
-export function registerPrdBlocksCommands(program, io) {
-    // Find existing `prd` top-level command (registered by prd-commands.ts).
-    // Do NOT create a new one — that collides with the existing prd role
-    // command and breaks `peaks request transition --role prd`.
-    const prd = program.commands.find((c) => c.name() === 'prd');
-    if (prd === undefined) {
-        // Fallback: create if missing. Should never trigger in normal startup.
-        program
-            .command('prd')
-            .description('v2.15.0 follow-up G3: PRD design-quality gates.');
-    }
-    const target = prd ?? program.commands.find((c) => c.name() === 'prd');
-    addJsonOption(target
-        .command('check-blocks <request-id>')
-        .description('Validate the prd artifact body contains the 4 mandatory sections: ' +
-        '业务场景 / 边界 case / UI 装配意图 / 上游基线 (latter required only for fork projects). ' +
-        'Complements `peaks request lint`. Exits non-zero when any required block is missing or too short.')
-        .requiredOption('--project <path>', 'project root')).action((requestId, opts) => {
-        const projectRoot = opts.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        const report = checkPrdBlocks(projectRoot, requestId);
-        printResult(io, ok('prd.check-blocks', report, [], report.ok
-            ? []
-            : [
-                'Fix the missing / too-short required blocks above.',
-                'The 12 Gaps positioning memory: prd design quality is the only lever — execution layer does not add quality.'
-            ]), opts.json ?? false);
-        if (!report.ok) {
-            process.exitCode = 1;
-        }
-    });
-}

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

@@ -1,141 +0,0 @@
-/**
- * peaks prd handoff CLI — v2.11.0 (Tier 3 in
- * `v2-11-rd-techdoc-removal-and-runtime-friction`).
- *
- * Wires `services/prd/handoff-service.ts` to the command surface:
- *
- *   peaks prd handoff init   — produce + write a sha256-locked handoff
- *   peaks prd handoff verify — re-read + recompute hash; report
- *   peaks prd handoff show   — print the raw handoff markdown
- *
- * Help text MUST NOT reference the legacy `peaks prd write-handoff`
- * subcommand (AC-1 in the v2.11.0 PRD). The legacy service module at
- * `services/handoff/` is a separate slice-025 layout (different
- * schema) and is intentionally not exposed here.
- */
-import { readFile } from 'node:fs/promises';
-import { initHandoff, readHandoff, showHandoff, verifyHandoff, writeHandoff } from '../../services/prd/handoff-service.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-/** Split a comma-separated string into a trimmed, non-empty list.
- *  Empty / undefined input → empty array. */
-function splitCsv(raw) {
-    if (!raw)
-        return [];
-    return raw
-        .split(',')
-        .map((s) => s.trim())
-        .filter((s) => s.length > 0);
-}
-/** Resolve the `--body` argument: if it starts with `@`, read the
- *  referenced file as UTF-8; otherwise treat as a literal string. */
-async function resolveBody(bodyArg) {
-    if (bodyArg.startsWith('@')) {
-        const filePath = bodyArg.slice(1);
-        return readFile(filePath, 'utf8');
-    }
-    return bodyArg;
-}
-export function registerPrdCommands(program, io) {
-    const prd = program.command('prd').description('peaks-prd role: artifact + handoff primitives');
-    const handoff = prd.command('handoff').description('Write / verify / show the immutable PRD handoff (sha256-locked, schemaVersion: 2)');
-    // peaks prd handoff init
-    addJsonOption(handoff
-        .command('init')
-        .description('Initialize an immutable handoff: sha256(body) → frontmatter → write to .peaks/_runtime/<sid>/prd/handoff.md')
-        .requiredOption('--rid <request-id>', 'request id (e.g. 001-v2-11-cc-group-b)')
-        .requiredOption('--sid <session-id>', 'session id (e.g. 2026-06-26-session-a28d69)')
-        .requiredOption('--body <body>', 'handoff body markdown, or @<file> to read from disk')
-        .option('--goals <ids>', 'comma-separated goal ids (e.g. G1,G2,G3)')
-        .option('--ac <ids>', 'comma-separated acceptance-criteria ids (e.g. AC-1,AC-2)')
-        .option('--preserve <ids>', 'comma-separated preserved-behavior ids (e.g. P1,P12)')
-        .option('--project <path>', 'target project root (defaults to cwd)')
-        .option('--apply', 'actually write the file (default is dry-run preview)')).action(async (options) => {
-        try {
-            const body = await resolveBody(options.body);
-            const projectRoot = options.project ?? process.cwd();
-            const writtenAt = new Date().toISOString();
-            const handoff = initHandoff({
-                requestId: options.rid,
-                sessionId: options.sid,
-                body,
-                writtenAt,
-                goals: splitCsv(options.goals),
-                acceptanceCriteria: splitCsv(options.ac),
-                preservedBehavior: splitCsv(options.preserve),
-            });
-            if (options.apply !== true) {
-                printResult(io, ok('prd.handoff.init', {
-                    dryRun: true,
-                    requestId: handoff.frontmatter.requestId,
-                    sessionId: handoff.frontmatter.sessionId,
-                    schemaVersion: handoff.frontmatter.schemaVersion,
-                    handoffHash: handoff.frontmatter.handoffHash,
-                    handoffPath: handoff.frontmatter.handoffPath,
-                    bodyBytes: Buffer.byteLength(body, 'utf8'),
-                    goals: handoff.frontmatter.goals,
-                    acceptanceCriteria: handoff.frontmatter.acceptanceCriteria,
-                    preservedBehavior: handoff.frontmatter.preservedBehavior
-                }), options.json);
-                return;
-            }
-            const written = await writeHandoff(handoff, projectRoot);
-            printResult(io, ok('prd.handoff.init', {
-                applied: true,
-                path: written.path,
-                hash: written.hash,
-                requestId: handoff.frontmatter.requestId,
-                sessionId: handoff.frontmatter.sessionId
-            }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('prd.handoff.init', 'HANDOFF_INIT_FAILED', getErrorMessage(error), { rid: options.rid, sid: options.sid }, ['Check --body syntax (@<file> or literal) and re-run']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // peaks prd handoff verify
-    addJsonOption(handoff
-        .command('verify')
-        .description('Re-read a handoff file and re-compute the sha256; report ok or reason')
-        .requiredOption('--path <file>', 'absolute path to the handoff file')).action(async (options) => {
-        try {
-            const probe = await verifyHandoff(options.path);
-            if (!probe.ok) {
-                printResult(io, fail('prd.handoff.verify', 'HANDOFF_VERIFY_FAILED', probe.reason ?? 'unknown', probe, ['Re-init the handoff with `peaks prd handoff init --apply` to restore integrity']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('prd.handoff.verify', { ok: true, hash: probe.actualHash, path: options.path }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('prd.handoff.verify', 'HANDOFF_VERIFY_FAILED', getErrorMessage(error), { path: options.path }, ['Check the path and ensure the file is readable']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // peaks prd handoff show
-    addJsonOption(handoff
-        .command('show')
-        .description('Print the raw handoff markdown (frontmatter + body) for human display')
-        .requiredOption('--path <file>', 'absolute path to the handoff file')).action(async (options) => {
-        try {
-            const content = await showHandoff(options.path);
-            const handoff = await readHandoff(options.path);
-            if (options.json === true) {
-                printResult(io, ok('prd.handoff.show', {
-                    path: options.path,
-                    frontmatter: handoff.frontmatter,
-                    bodyBytes: Buffer.byteLength(content, 'utf8'),
-                    body: content
-                }), true);
-                return;
-            }
-            io.stdout(content);
-            if (!content.endsWith('\n'))
-                io.stdout('\n');
-        }
-        catch (error) {
-            printResult(io, fail('prd.handoff.show', 'HANDOFF_SHOW_FAILED', getErrorMessage(error), { path: options.path }, ['Check the path and ensure the file is readable']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}