peaks-loop 4.0.0-beta.6 → 4.0.0-beta.8

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

@@ -1,155 +0,0 @@
-import { existsSync } from 'node:fs';
-import { addJsonOption, printResult } from '../cli-helpers.js';
-import { fail, ok, getErrorMessage } from '../../shared/result.js';
-import { PolyrepoService } from '../../services/polyrepo/polyrepo-service.js';
-function parseChildren(raw) {
-    if (raw === undefined || raw.length === 0)
-        return undefined;
-    return raw.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
-}
-function resolveRoot(explicit) {
-    if (explicit !== undefined && explicit.length > 0)
-        return explicit;
-    return process.cwd();
-}
-export function registerPolyrepoCommands(program, io) {
-    const polyrepo = program
-        .command('polyrepo')
-        .description('Polyrepo workflow (parent dir + child git repos with their own .peaks/ subsets)');
-    // -----------------------------------------------------------------
-    // 1. peaks polyrepo init [--children <dir1,dir2>] [--root <dir>]
-    // -----------------------------------------------------------------
-    addJsonOption(polyrepo
-        .command('init')
-        .description('Scan the parent dir for child git repos and write .peaks/polyrepo.json')
-        .option('--children <list>', 'comma-separated child directory names (defaults to auto-discovery)')
-        .option('--root <path>', 'parent root (defaults to cwd)')).action((options) => {
-        try {
-            const root = resolveRoot(options.root);
-            const svc = new PolyrepoService();
-            const children = parseChildren(options.children);
-            const result = children === undefined
-                ? svc.init({ root })
-                : svc.init({ root, children });
-            printResult(io, ok('polyrepo.init', {
-                root: result.manifest.root,
-                detectedAt: result.manifest.detectedAt,
-                children: result.manifest.children,
-                manifestPath: `${result.manifest.root}/.peaks/polyrepo.json`,
-                created: result.created
-            }, [], [
-                result.manifest.children.length === 0
-                    ? 'No child git repos detected. Pass --children <dir1,dir2> to override.'
-                    : `Run \`peaks polyrepo dispatch --rid <rid> --to <child-id>\` to mirror an artifact into one or more children.`
-            ]), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('polyrepo.init', 'POLYREPO_INIT_FAILED', getErrorMessage(error), {}, ['Verify --root exists and is a directory']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // -----------------------------------------------------------------
-    // 2. peaks polyrepo status [--root <dir>]
-    // -----------------------------------------------------------------
-    addJsonOption(polyrepo
-        .command('status')
-        .description('Report the persisted polyrepo manifest + children')
-        .option('--root <path>', 'parent root (defaults to cwd)')).action((options) => {
-        try {
-            const root = resolveRoot(options.root);
-            const svc = new PolyrepoService();
-            const result = svc.status(root);
-            if (!result.manifestExists) {
-                printResult(io, ok('polyrepo.status', { ...result, initialized: false }, [], [
-                    'No polyrepo manifest found. Run `peaks polyrepo init [--children <list>]` first.'
-                ]), options.json);
-                return;
-            }
-            printResult(io, ok('polyrepo.status', { ...result, initialized: true }, [], [
-                result.children.length === 0
-                    ? 'Manifest exists but has no children. Re-run `peaks polyrepo init --children <list>`.'
-                    : `Run \`peaks polyrepo dispatch --rid <rid> --to <child-id>\` to mirror an artifact.`
-            ]), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('polyrepo.status', 'POLYREPO_STATUS_FAILED', getErrorMessage(error), {}, []), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // -----------------------------------------------------------------
-    // 3. peaks polyrepo dispatch --rid <rid> [--to <child-id>] --role <prd|rd|qa> --artifact <path>
-    // -----------------------------------------------------------------
-    addJsonOption(polyrepo
-        .command('dispatch')
-        .description('Mirror a PRD/RD/QA artifact from the parent into one or more children')
-        .requiredOption('--rid <rid>', 'request id (used in the on-disk filename)')
-        .option('--to <list>', 'comma-separated child ids (defaults to all children in the manifest)')
-        .requiredOption('--role <role>', 'artifact role: prd | rd | qa')
-        .requiredOption('--artifact <path>', 'source artifact path (relative to --root or absolute)')
-        .option('--sid <sid>', 'session id override (defaults to the canonical binding)')
-        .option('--root <path>', 'parent root (defaults to cwd)')).action((options) => {
-        try {
-            const root = resolveRoot(options.root);
-            const sid = options.sid ?? 'default';
-            const rid = options.rid ?? '';
-            const role = options.role;
-            if (role !== 'prd' && role !== 'rd' && role !== 'qa') {
-                printResult(io, fail('polyrepo.dispatch', 'INVALID_ROLE', `--role must be prd | rd | qa (got "${role}")`, {}, [
-                    'Re-run with --role prd (or rd / qa).'
-                ]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            const artifact = options.artifact ?? '';
-            if (!existsSync(artifact)) {
-                printResult(io, fail('polyrepo.dispatch', 'ARTIFACT_NOT_FOUND', `source artifact does not exist: ${artifact}`, {}, [
-                    'Verify the path or pass an absolute path.'
-                ]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            // Resolve targets from the manifest first so we can default to
-            // "all children" when --to is omitted.
-            const svc = new PolyrepoService();
-            const status = svc.status(root);
-            if (!status.manifestExists) {
-                printResult(io, fail('polyrepo.dispatch', 'NO_MANIFEST', `no polyrepo manifest at ${root}/.peaks/polyrepo.json`, {}, [
-                    'Run `peaks polyrepo init` first.'
-                ]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            let targets;
-            if (options.to !== undefined && options.to.length > 0) {
-                targets = options.to.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
-            }
-            else {
-                targets = status.children.map((c) => c.id);
-            }
-            const result = svc.dispatch(root, {
-                sid, rid, targets, role, artifactPath: artifact
-            });
-            const allOk = result.perChild.every((c) => c.ok);
-            printResult(io, ok('polyrepo.dispatch', {
-                root,
-                sid,
-                rid,
-                role,
-                artifact,
-                dispatch: result.dispatch,
-                perChild: result.perChild,
-                allOk
-            }, result.warnings, [
-                allOk
-                    ? `Mirrored artifact to ${result.perChild.length} child(ren).`
-                    : `One or more child mirrors failed; inspect perChild[].ok.`
-            ]), options.json);
-            if (!allOk)
-                process.exitCode = 1;
-        }
-        catch (error) {
-            printResult(io, fail('polyrepo.dispatch', 'POLYREPO_DISPATCH_FAILED', getErrorMessage(error), {}, []), options.json);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/prd-blocks-commands.d.ts

@@ -1,18 +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 type { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerPrdBlocksCommands(program: Command, io: ProgramIO): void;

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.d.ts

@@ -1,18 +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 { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerPrdCommands(program: Command, io: ProgramIO): void;

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;
-        }
-    });
-}

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

@@ -1,2 +0,0 @@
-import type { Command } from 'commander';
-export declare function registerPreferencesCommands(program: Command): void;

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

@@ -1,197 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
-import { dirname } from 'node:path';
-import { loadPreferences, migratePreferences, preferencesPath, savePreferences, } from '../../services/preferences/preferences-service.js';
-const ALLOWED_KEYS = new Set([
-    'economyMode',
-    'swarmMode',
-    'uaPrompt',
-    'agentShieldPrompt',
-    'classifyConservatism',
-    'classifyRules',
-    'headroom',
-    'swarmSpeculative',
-    'loopAutonomousEnabled',
-]);
-export function registerPreferencesCommands(program) {
-    const prefs = program
-        .command('preferences')
-        .description('Manage project-local preferences (`.peaks/preferences.json`)');
-    prefs
-        .command('get')
-        .description('Get a preference value (from override or default)')
-        .requiredOption('--key <key>', 'preference key')
-        .option('--project <path>', 'project root', process.cwd())
-        .option('--json', 'JSON envelope output')
-        .action((opts) => {
-        try {
-            if (!ALLOWED_KEYS.has(opts.key)) {
-                throw new Error(`PREFERENCES_KEY_UNKNOWN: ${opts.key}`);
-            }
-            const all = loadPreferences(opts.project);
-            const value = all[opts.key];
-            const filePath = preferencesPath(opts.project);
-            // Spec bug fix: use the top-level existsSync import (the spec's
-            // `await import('node:fs')` would not compile inside a non-async action).
-            // Source is 'override' only when the key is explicitly present in
-            // the on-disk file (not merely when the file exists, since reset()
-            // may leave the file with other keys still overridden).
-            let source = 'default';
-            if (existsSync(filePath)) {
-                try {
-                    const raw = JSON.parse(readFileSync(filePath, 'utf8'));
-                    if (Object.prototype.hasOwnProperty.call(raw, opts.key)) {
-                        source = 'override';
-                    }
-                }
-                catch {
-                    // Corrupt file: report the merged value but fall back to 'default'
-                    // source to avoid claiming an override that cannot be parsed.
-                    source = 'default';
-                }
-            }
-            // Stable ordering: source is computed, value reflects merged state.
-            const envelope = {
-                ok: true,
-                data: { key: opts.key, value, source },
-            };
-            process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
-        }
-        catch (err) {
-            process.stderr.write(err.message + '\n');
-            process.exit(1);
-        }
-    });
-    prefs
-        .command('set')
-        .description('Override a preference value (writes to .peaks/preferences.json)')
-        .requiredOption('--key <key>', 'preference key')
-        .requiredOption('--value <value>', 'value (parsed as JSON, or string if not JSON)')
-        .option('--project <path>', 'project root', process.cwd())
-        .option('--json', 'JSON envelope output')
-        .action((opts) => {
-        try {
-            if (!ALLOWED_KEYS.has(opts.key)) {
-                throw new Error(`PREFERENCES_KEY_UNKNOWN: ${opts.key}`);
-            }
-            let parsed = opts.value;
-            try {
-                parsed = JSON.parse(opts.value);
-            }
-            catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-                // Not valid JSON — keep the raw string.
-            }
-            const merged = savePreferences(opts.project, {
-                [opts.key]: parsed,
-            });
-            const envelope = {
-                ok: true,
-                data: {
-                    key: opts.key,
-                    value: merged[opts.key],
-                },
-            };
-            process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
-        }
-        catch (err) {
-            process.stderr.write(err.message + '\n');
-            process.exit(1);
-        }
-    });
-    prefs
-        .command('reset')
-        .description('Remove the override for a key (falls back to default)')
-        .requiredOption('--key <key>', 'preference key')
-        .option('--project <path>', 'project root', process.cwd())
-        .option('--json', 'JSON envelope output')
-        .action((opts) => {
-        try {
-            if (!ALLOWED_KEYS.has(opts.key)) {
-                throw new Error(`PREFERENCES_KEY_UNKNOWN: ${opts.key}`);
-            }
-            const filePath = preferencesPath(opts.project);
-            // Read raw on-disk state (not the merged view) so removing a key
-            // truly removes the override, instead of savePreferences re-inserting
-            // the default value. If no file exists, there is nothing to reset.
-            if (!existsSync(filePath)) {
-                const envelope = {
-                    ok: true,
-                    data: { key: opts.key, removed: false, reason: 'no-override-file' },
-                };
-                process.stdout.write(JSON.stringify(envelope) + '\n');
-                return;
-            }
-            let raw;
-            try {
-                raw = JSON.parse(readFileSync(filePath, 'utf8'));
-            }
-            catch (err) {
-                throw new Error(`PREFERENCES_JSON_INVALID: failed to parse ${filePath}: ${err.message}`);
-            }
-            const hadKey = Object.prototype.hasOwnProperty.call(raw, opts.key);
-            if (hadKey) {
-                delete raw[opts.key];
-                // Slice 2026-06-23-audit-4th #A2: write atomically (tmp+rename)
-                // so a crash mid-write cannot leave a half-written file. Same
-                // pattern as preferences-service.savePreferences (post-fix) and
-                // dispatch-record-writer.writeAtomic. renameSync is imported
-                // statically at the top of this file (see node:fs import).
-                mkdirSync(dirname(filePath), { recursive: true });
-                const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
-                writeFileSync(tmp, JSON.stringify(raw, null, 2) + '\n', 'utf8');
-                renameSync(tmp, filePath);
-            }
-            const envelope = {
-                ok: true,
-                data: { key: opts.key, removed: hadKey },
-            };
-            process.stdout.write(JSON.stringify(envelope) + '\n');
-        }
-        catch (err) {
-            process.stderr.write(err.message + '\n');
-            process.exit(1);
-        }
-    });
-    // Slice 2026-06-23-audit-4th #C1: peaks preferences migrate — apply
-    // the v1 → v2 (and future) schema migration. Default is dry-run
-    // (preview the change list + migrated JSON without writing); pass
-    // --apply to write. Without this CLI, an old preferences.json
-    // makes loadPreferences throw PREFERENCES_SCHEMA_MISMATCH and the
-    // LLM is stuck with no recovery path.
-    prefs
-        .command('migrate')
-        .description('Migrate a legacy preferences.json to the current schema_version (v1 → v2; dry-run by default)')
-        .option('--project <path>', 'project root', process.cwd())
-        .option('--apply', 'write the migrated JSON to .peaks/preferences.json (default: dry-run preview)')
-        .option('--json', 'JSON envelope output')
-        .action((opts) => {
-        try {
-            const result = migratePreferences(opts.project, { write: opts.apply === true });
-            if (result === null) {
-                const envelope = {
-                    ok: true,
-                    data: { migrated: false, reason: 'no-preferences-file' }
-                };
-                process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
-                return;
-            }
-            const envelope = {
-                ok: true,
-                data: {
-                    fromVersion: result.fromVersion,
-                    toVersion: result.toVersion,
-                    changes: result.changes,
-                    written: result.written,
-                    migrated: result.migrated
-                },
-                warnings: result.written ? [] : [
-                    'Dry-run only — re-run with --apply to write the migrated file.'
-                ]
-            };
-            process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
-        }
-        catch (err) {
-            process.stderr.write(err.message + '\n');
-            process.exit(1);
-        }
-    });
-}

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

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerProjectCommands(program: Command, io: ProgramIO): void;