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

package/dist/src/cli/commands/sub-agent-shared.js

@@ -1,67 +0,0 @@
-export const RECOMMENDED_ROLES = 'rd | qa | ui | txt | qa-business | qa-perf | qa-security | qa-business-<*> | general-purpose';
-export const HEARTBEAT_STATUSES = [
-    'queued', 'running', 'finalizing', 'done', 'failed', 'stale'
-];
-export const HEADROOM_MODES = ['balanced', 'aggressive', 'conservative'];
-export const PROMPT_LIMIT_BYTES = 256 * 1024;
-/**
- * Validate a role string. Returns `null` when valid, otherwise the
- * rejection reason (mirrors commander.js option-validation shape so
- * the action handler can pass it straight to `fail()`).
- *
- * Rules (per dispatch CLI spec):
- *   - Non-empty
- *   - ≤ 256 chars
- *   - No whitespace, no control characters, no DEL (0x7F)
- */
-export function validateRole(role) {
-    if (typeof role !== 'string' || role.length === 0) {
-        return 'role must be a non-empty string';
-    }
-    if (role.length > 256) {
-        return 'role must be ≤ 256 chars';
-    }
-    for (let i = 0; i < role.length; i += 1) {
-        const code = role.charCodeAt(i);
-        if (code <= 0x20 || code === 0x7F) {
-            return 'role must not contain whitespace or control characters';
-        }
-    }
-    return null;
-}
-/**
- * Roll up a batch result array into the summary the CLI envelope exposes
- * for `peaks sub-agent await`. Counts per status; the orchestrator
- * surface (`SubAgentBatchResult.status`) is a closed set so a single
- * `for` loop with `if/else if` is faster and clearer than a reduce.
- */
-export function summarizeBatchResults(results) {
-    let done = 0;
-    let failed = 0;
-    let cancelled = 0;
-    let timeout = 0;
-    for (const r of results) {
-        if (r.status === 'done')
-            done += 1;
-        else if (r.status === 'failed')
-            failed += 1;
-        else if (r.status === 'cancelled')
-            cancelled += 1;
-        else
-            timeout += 1;
-    }
-    return { total: results.length, done, failed, cancelled, timeout };
-}
-// Note: `isHeadroomMode` and `RegisterSubCommand` used to live here as
-// duplicate exports. Removed in slice 2026-06-23-audit-p0-cleanup:
-//   - `isHeadroomMode` is exported by `src/services/context/headroom-prefs.ts`
-//     and that is the canonical source — dispatch consumer imports from
-//     there directly.
-//   - `RegisterSubCommand` was never used as a type anywhere; the entry
-//     point (`sub-agent-commands.ts`) calls each register function with
-//     `(program, io)` directly.
-//   - `deriveProjectRoot` (audit-p0-reaudit) was removed in slice
-//     2026-06-23-audit-3rd: it trusted the record path's `.peaks` segment,
-//     letting a caller point `--record` at any project's record tree. The
-//     heartbeat command now trusts `--project` (or `process.cwd()`) and
-//     leaves the relative() backstop to the R-2 guard.

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

@@ -1,47 +0,0 @@
-/**
- * `peaks test <pattern...>` — slice 2.5.0 sub-fix B (Prob 2).
- *
- * Wraps the consumer project's test framework (jest / vitest / mocha)
- * with a per-test fingerprint cache. The wrapper:
- *
- *   1. Auto-detects the framework from package.json (devDependencies +
- *      dependencies) via detectTestFramework().
- *   2. Spawns the framework's CLI with --cache enabled (overriding any
- *      --no-cache in the consumer's `test` script). The user can
- *      opt back into no-cache via `peaks test --no-cache` or
- *      `peaks test --passthrough`.
- *   3. Skips tests where (fileMtime, fileSha256) is unchanged AND the
- *      previous run status was 'passed' (per-test fingerprint cache at
- *      `<projectRoot>/.peaks/_runtime/test-cache/<hash>.json`).
- *   4. Exits 0 on all-pass / all-skip; exits 1 on any failure.
- *
- * The CLI is invoked by USER (not just by skill) per slice 2.5.0
- * sub-fix B (G16) — a documented exception to the
- * dev-preference red-line "no new top-level peaks <cmd>".
- *
- * Sub-commands:
- *   peaks test <pattern...>           — run tests matching the pattern
- *   peaks test --all                  — run the full suite
- *   peaks test --changed              — only files changed since HEAD
- *   peaks test --clear-cache          — empty the fingerprint cache
- *   peaks test --no-cache-result      — bypass the fingerprint cache
- *   peaks test --no-cache             — pass --no-cache to the framework
- *   peaks test --passthrough          — do NOT override the consumer's argv
- *   peaks test --framework <name>     — force a specific framework
- */
-import type { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-import { type TestFramework } from '../../services/test-cache/test-cache-service.js';
-/**
- * Build the argv for the underlying test runner. This is the SINGLE
- * source of truth for "peaks test drops --no-cache from the
- * consumer's script" (G7 / NG7). `--cache` is always passed
- * unless the user explicitly opts in to `--no-cache` or `--passthrough`.
- */
-export declare function buildRunnerArgv(framework: TestFramework, patterns: string[], options: {
-    all?: boolean;
-    changed?: boolean;
-    cache?: boolean;
-    passthrough?: boolean;
-}): string[];
-export declare function registerTestCommands(program: Command, _io: ProgramIO): void;

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

@@ -1,204 +0,0 @@
-/**
- * `peaks test <pattern...>` — slice 2.5.0 sub-fix B (Prob 2).
- *
- * Wraps the consumer project's test framework (jest / vitest / mocha)
- * with a per-test fingerprint cache. The wrapper:
- *
- *   1. Auto-detects the framework from package.json (devDependencies +
- *      dependencies) via detectTestFramework().
- *   2. Spawns the framework's CLI with --cache enabled (overriding any
- *      --no-cache in the consumer's `test` script). The user can
- *      opt back into no-cache via `peaks test --no-cache` or
- *      `peaks test --passthrough`.
- *   3. Skips tests where (fileMtime, fileSha256) is unchanged AND the
- *      previous run status was 'passed' (per-test fingerprint cache at
- *      `<projectRoot>/.peaks/_runtime/test-cache/<hash>.json`).
- *   4. Exits 0 on all-pass / all-skip; exits 1 on any failure.
- *
- * The CLI is invoked by USER (not just by skill) per slice 2.5.0
- * sub-fix B (G16) — a documented exception to the
- * dev-preference red-line "no new top-level peaks <cmd>".
- *
- * Sub-commands:
- *   peaks test <pattern...>           — run tests matching the pattern
- *   peaks test --all                  — run the full suite
- *   peaks test --changed              — only files changed since HEAD
- *   peaks test --clear-cache          — empty the fingerprint cache
- *   peaks test --no-cache-result      — bypass the fingerprint cache
- *   peaks test --no-cache             — pass --no-cache to the framework
- *   peaks test --passthrough          — do NOT override the consumer's argv
- *   peaks test --framework <name>     — force a specific framework
- */
-import { spawn } from 'node:child_process';
-import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
-import { getErrorMessage } from '../cli-helpers.js';
-import { clearTestCache, detectTestFramework } from '../../services/test-cache/test-cache-service.js';
-const FRAMEWORKS = ['jest', 'vitest', 'mocha'];
-/**
- * Build the argv for the underlying test runner. This is the SINGLE
- * source of truth for "peaks test drops --no-cache from the
- * consumer's script" (G7 / NG7). `--cache` is always passed
- * unless the user explicitly opts in to `--no-cache` or `--passthrough`.
- */
-export function buildRunnerArgv(framework, patterns, options) {
-    if (options.passthrough) {
-        // Caller has explicitly chosen to honor the consumer's argv;
-        // we still pass the patterns so the runner filters to them.
-        if (framework === 'jest')
-            return [...patterns, '--no-cache'];
-        if (framework === 'vitest')
-            return ['run', ...patterns];
-        return [...patterns];
-    }
-    if (framework === 'jest') {
-        const argv = [...patterns];
-        if (options.all)
-            argv.push('--passWithNoTests');
-        if (options.changed)
-            argv.push('--changedSince=HEAD');
-        // Commander's `.option('--no-cache')` sets `opts.cache` (BASE name) to
-        // `false` when the flag is passed; `opts.cache` is `true` by default.
-        // The default-mode invariant (G7/NG7) is `--cache`; the explicit
-        // override is `--no-cache`. Inverted from the previous wording
-        // because `options = {}` made the read side `!== true` and silently
-        // flipped every default-mode jest/vitest run to `--no-cache`.
-        if (options.cache === false)
-            argv.push('--no-cache');
-        else
-            argv.push('--cache');
-        return argv;
-    }
-    if (framework === 'vitest') {
-        const argv = ['run', ...patterns];
-        if (options.changed)
-            argv.push('--changed');
-        if (options.cache === false)
-            argv.push('--no-cache');
-        else
-            argv.push('--cache');
-        return argv;
-    }
-    // mocha — no built-in --cache flag; we just pass the patterns.
-    return [...patterns];
-}
-function runRunner(framework, argv, projectRoot) {
-    return new Promise((resolveRun, reject) => {
-        const cmd = framework === 'vitest' ? 'vitest' : framework === 'jest' ? 'jest' : 'mocha';
-        const proc = spawn(cmd, argv, {
-            cwd: projectRoot,
-            env: process.env,
-            stdio: ['ignore', 'pipe', 'pipe']
-        });
-        let stdout = '';
-        let stderr = '';
-        proc.stdout.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
-        proc.stderr.on('data', (chunk) => { stderr += chunk.toString('utf8'); });
-        proc.on('error', (err) => reject(err));
-        proc.on('close', (code) => {
-            resolveRun({ code: code ?? 0, stdout, stderr });
-        });
-    });
-}
-export function registerTestCommands(program, _io) {
-    const test = program
-        .command('test')
-        .description('Wrap the consumer project\'s test framework (jest/vitest/mocha) ' +
-        'with a per-test fingerprint cache. Default args: <pattern...> ' +
-        'runs jest|vitest|mocha <pattern> --cache. Exit 0 on all-pass / ' +
-        'all-skip, exit 1 on any failure. (slice 2.5.0 sub-fix B)')
-        .argument('[patterns...]', 'test file pattern(s) to run (passed to the framework verbatim)')
-        .option('--all', 'run the full suite (skip the pattern filter)')
-        .option('--changed', 'only run tests in files changed since HEAD')
-        .option('--clear-cache', 'empty the fingerprint cache at .peaks/_runtime/test-cache/ and exit 0')
-        .option('--no-cache-result', 'bypass the per-test fingerprint cache (always re-run)')
-        .option('--no-cache', 'pass --no-cache to the underlying framework (overrides peaks default)')
-        .option('--passthrough', 'do NOT override the consumer\'s argv; pass patterns through verbatim')
-        .option('--framework <name>', `force a specific framework: ${FRAMEWORKS.join(', ')}`)
-        .option('--project <path>', 'project root (defaults to current directory)', process.cwd())
-        .option('--json', 'emit a JSON envelope { ok, data } to stdout')
-        .action(async (patterns, opts) => {
-        try {
-            const projectRoot = resolveCanonicalProjectRoot(opts.project ?? process.cwd());
-            // --clear-cache short-circuit
-            if (opts.clearCache === true) {
-                const result = clearTestCache(projectRoot);
-                if (opts.json === true) {
-                    process.stdout.write(JSON.stringify({
-                        ok: true,
-                        data: { cleared: true, removed: result.removed, dir: '.peaks/_runtime/test-cache/' }
-                    }) + '\n');
-                }
-                else {
-                    process.stdout.write(`cleared ${result.removed} cache file(s) from .peaks/_runtime/test-cache/\n`);
-                }
-                return;
-            }
-            // Framework detection
-            let framework = null;
-            if (opts.framework) {
-                if (!FRAMEWORKS.includes(opts.framework)) {
-                    const msg = `INVALID_FRAMEWORK: --framework must be one of ${FRAMEWORKS.join(', ')} (got "${opts.framework}")`;
-                    if (opts.json === true) {
-                        process.stdout.write(JSON.stringify({ ok: false, error: msg }) + '\n');
-                    }
-                    else {
-                        process.stderr.write(msg + '\n');
-                    }
-                    process.exitCode = 1;
-                    return;
-                }
-                framework = opts.framework;
-            }
-            else {
-                framework = detectTestFramework(projectRoot);
-            }
-            if (!framework) {
-                const msg = 'NO_TEST_FRAMEWORK: no supported test framework found in package.json (jest, vitest, or mocha). Install one and re-run, or pass --framework <name>.';
-                if (opts.json === true) {
-                    process.stdout.write(JSON.stringify({ ok: false, error: msg }) + '\n');
-                }
-                else {
-                    process.stderr.write(msg + '\n');
-                }
-                process.exitCode = 1;
-                return;
-            }
-            // Pattern argument: --all clears the list, --changed adds --changedSince
-            const effectivePatterns = opts.all ? [] : patterns;
-            const argv = buildRunnerArgv(framework, effectivePatterns, {
-                all: opts.all === true,
-                changed: opts.changed === true,
-                cache: opts.cache === true,
-                passthrough: opts.passthrough === true
-            });
-            // Stream the runner's output to the user.
-            const result = await runRunner(framework, argv, projectRoot);
-            process.stdout.write(result.stdout);
-            process.stderr.write(result.stderr);
-            if (result.code !== 0) {
-                process.exitCode = 1;
-            }
-            if (opts.json === true) {
-                process.stdout.write(JSON.stringify({
-                    ok: result.code === 0,
-                    data: {
-                        framework,
-                        argv,
-                        exitCode: result.code,
-                        fingerprintCache: opts.noCacheResult ? 'bypassed' : 'enabled',
-                        cacheDir: '.peaks/_runtime/test-cache/'
-                    }
-                }) + '\n');
-            }
-        }
-        catch (error) {
-            if (opts.json === true) {
-                process.stdout.write(JSON.stringify({ ok: false, error: getErrorMessage(error) }) + '\n');
-            }
-            else {
-                process.stderr.write(getErrorMessage(error) + '\n');
-            }
-            process.exitCode = 1;
-        }
-    });
-}

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

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

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

@@ -1,148 +0,0 @@
-import { InvalidArgumentError } from 'commander';
-import { scanUnderstandAnything, summarizeKnowledgeGraph } from '../../services/understand/understand-scan-service.js';
-import { buildUnderstandContext } from '../../services/understand/understand-hybrid-service.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-function parsePositiveInteger(value) {
-    if (!/^\d+$/.test(value)) {
-        throw new InvalidArgumentError('must be a positive integer');
-    }
-    const parsed = Number(value);
-    if (!Number.isSafeInteger(parsed) || parsed < 1) {
-        throw new InvalidArgumentError('must be a positive integer');
-    }
-    return parsed;
-}
-const INSTALL_HINT = 'Install Understand Anything in Claude Code: `/plugin marketplace add Lum1104/Understand-Anything` then `/plugin install understand-anything`, then run `/understand` in the target project to generate .understand-anything/knowledge-graph.json.';
-export function registerUnderstandCommands(program, io) {
-    const understand = program.command('understand').description('Inspect Understand Anything artifacts inside a project (read-only)');
-    addJsonOption(understand
-        .command('status')
-        .description('Report whether Understand Anything has produced a knowledge graph in the target project')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--artifact-dir <path>', 'override the default .understand-anything directory')).action(async (options) => {
-        try {
-            const scanOptions = { projectRoot: options.project };
-            if (options.artifactDir !== undefined) {
-                scanOptions.artifactDir = options.artifactDir;
-            }
-            const report = await scanUnderstandAnything(scanOptions);
-            const nextActions = [];
-            if (!report.exists) {
-                nextActions.push(INSTALL_HINT);
-            }
-            else if (!report.graph.exists) {
-                nextActions.push('Run `/understand` inside Claude Code on this project to generate .understand-anything/knowledge-graph.json.');
-            }
-            else if (report.graph.parseError !== undefined) {
-                nextActions.push('Re-run `/understand` to regenerate the knowledge graph; the current file is not valid JSON.');
-            }
-            printResult(io, ok('understand.status', report, [], nextActions), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('understand.status', 'UNDERSTAND_STATUS_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path and .understand-anything directory before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(understand
-        .command('show')
-        .description('Summarize the Understand Anything knowledge graph (counts, layers, tours, sample nodes) for RD/TXT consumption')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--artifact-dir <path>', 'override the default .understand-anything directory')
-        .option('--sample <n>', 'maximum number of sample node ids to return (default 5)', parsePositiveInteger)).action(async (options) => {
-        try {
-            const summaryOptions = { projectRoot: options.project };
-            if (options.artifactDir !== undefined) {
-                summaryOptions.artifactDir = options.artifactDir;
-            }
-            if (options.sample !== undefined) {
-                summaryOptions.sampleSize = options.sample;
-            }
-            const summary = await summarizeKnowledgeGraph(summaryOptions);
-            if (!summary.exists) {
-                printResult(io, fail('understand.show', 'UNDERSTAND_GRAPH_MISSING', `No knowledge graph found at ${summary.path}`, summary, [INSTALL_HINT]), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            if (summary.parseError !== undefined) {
-                printResult(io, fail('understand.show', 'UNDERSTAND_GRAPH_PARSE_ERROR', `Knowledge graph at ${summary.path} is not valid JSON: ${summary.parseError}`, summary, ['Re-run `/understand` to regenerate the knowledge graph']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, ok('understand.show', summary), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('understand.show', 'UNDERSTAND_SHOW_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path and .understand-anything directory before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // L3.1: opt-in UX subcommand. Returns the AskUserQuestion payload that
-    // the LLM-side UX layer (peaks-code / peaks-ide) should surface when
-    // uaPrompt === 'unset' and UA is absent. When uaPrompt is skip-this-session
-    // or skip-forever, returns a no-op envelope (caller does not prompt).
-    addJsonOption(understand
-        .command('opt-in')
-        .description('Returns the UA opt-in prompt payload (Slice L3.1) when uaPrompt is unset; no-op otherwise')
-        .requiredOption('--project <path>', 'target project root')).action(async (options) => {
-        try {
-            const report = await scanUnderstandAnything({ projectRoot: options.project });
-            const uaPrompt = report.uaPrompt ?? 'unset';
-            if (report.exists || uaPrompt !== 'unset') {
-                // No prompt needed: UA is installed OR user already decided.
-                printResult(io, ok('understand.opt-in', { promptNeeded: false, uaPrompt, uaInstalled: report.exists }), options.json);
-                return;
-            }
-            const prompt = {
-                version: 1,
-                tool: 'ua-opt-in',
-                artifactDir: report.artifactDir,
-                reason: 'ua-artifact-missing',
-                options: [
-                    { id: 'install', label: 'Install UA in Claude Code', description: INSTALL_HINT },
-                    { id: 'fallback-this-session', label: 'Use codegraph fallback this session', description: 'Skip UA this run; do not write preferences.json' },
-                    { id: 'fallback-forever', label: 'Use codegraph fallback forever', description: 'Write preferences.json:uaPrompt=skip-forever; suppress future prompts' }
-                ]
-            };
-            printResult(io, ok('understand.opt-in', { promptNeeded: true, uaPrompt, uaInstalled: false, prompt }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('understand.opt-in', 'UNDERSTAND_OPTIN_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    // Slice 2026-07-02-codegraph-ua-hybrid: hybrid context subcommand.
-    // Routes UA-first / codegraph-fallback / hybrid in the service layer;
-    // the CLI is a thin shell that surfaces the envelope and exit code.
-    addJsonOption(understand
-        .command('context')
-        .description('Build a hybrid project-context envelope: UA knowledge graph when present, codegraph affected as fallback, or both in parallel')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--artifact-dir <path>', 'override the default .understand-anything directory')
-        .option('--sample <n>', 'maximum number of sample node ids to include (default 5)', parsePositiveInteger)
-        .option('--files <file...>', 'file globs to feed `codegraph affected` (default: src/index.ts, package.json, README.md)')).action(async (options) => {
-        try {
-            const ctxOptions = { projectRoot: options.project };
-            if (options.artifactDir !== undefined)
-                ctxOptions.artifactDir = options.artifactDir;
-            if (options.sample !== undefined)
-                ctxOptions.sampleSize = options.sample;
-            if (options.files !== undefined)
-                ctxOptions.files = options.files;
-            const result = await buildUnderstandContext(ctxOptions);
-            const exitCode = result.source === 'both-missing' ? 2 : 0;
-            if (exitCode !== 0) {
-                printResult(io, fail('understand.context', 'UNDERSTAND_CONTEXT_NO_EVIDENCE', `No UA graph and codegraph affected produced no usable evidence`, result, [
-                    INSTALL_HINT,
-                    'Run `peaks codegraph index` in this project to populate the codegraph index, then retry'
-                ]), options.json);
-                process.exitCode = exitCode;
-                return;
-            }
-            printResult(io, ok('understand.context', result, [], result.warnings.length > 0 ? result.warnings : undefined), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('understand.context', 'UNDERSTAND_CONTEXT_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Check the project path and codegraph installation before retrying']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}

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

@@ -1,23 +0,0 @@
-/**
- * peaks upgrade * CLI surface — Slice: 1.x → 2.0 umbrella +
- * Slice 3: --detect-1x flag.
- *
- * Per the "one-key completion" + "minimal-user-operation" tenets
- * (2026-06-11), the user's typical upgrade path is
- * `npm i -g peaks-loop@2.0` (the postinstall does the upgrade).
- *
- * The `peaks upgrade --to 2.0` CLI is the manual fallback for
- * when the postinstall is skipped (e.g. CI uses
- * `--ignore-scripts`). The umbrella orchestrates 7 sub-commands:
- * config-migrate / standards-migrate / memory-extract /
- * hooks-install / skill-sync / audit-verify + write-upgrade-record.
- *
- * The `--detect-1x` flag (added in slice 3) is a read-only
- * probe that the peaks-code skill calls to gate the
- * AskUserQuestion that prompts the 1.x → 2.0 upgrade. The
- * probe returns the JSON envelope from the
- * 1x-detector-service; it does NOT modify any files.
- */
-import { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerUpgradeCommands(program: Command, io: ProgramIO): void;

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

@@ -1,119 +0,0 @@
-import { runUpgrade } from '../../services/upgrade/upgrade-service.js';
-import { detect1xProjectState } from '../../services/upgrade/1x-detector-service.js';
-import { initWorkspace } from '../../services/workspace/workspace-service.js';
-import { ensureSessionWithRotation } from '../../services/session/session-manager.js';
-import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
-export function registerUpgradeCommands(program, io) {
-    addJsonOption(program
-        .command('upgrade')
-        .description('Upgrade a peaks-loop 1.x project to 2.0. Umbrella that orquestrates 7 sub-commands: config-migrate / standards-migrate / memory-extract / hooks-install / skill-sync / audit-verify + write-upgrade-record. Per the "one-key completion" tenet, prefer letting `npm i -g peaks-loop@2.0` postinstall run this for you. Use `--detect-1x` for a read-only probe (no file writes) that the peaks-code skill uses to gate the 1.x → 2.0 AskUserQuestion.')
-        .option('--to <version>', 'target version (only "2.0" supported)', '2.0')
-        .option('--project <path>', 'project root to upgrade (default: cwd)')
-        .option('--auto', 'non-interactive: accept soft-fail on any sub-step (used by the postinstall hook)')
-        .option('--detect-1x', 'read-only probe: returns the 1.x state as JSON (no file writes); consumed by peaks-code Step 0.55 to gate the AskUserQuestion')
-        .option('--apply-init', 'slice 4 (slice 2026-06-13-selfheal-claude-settings-template): run initWorkspace so the drift-driven self-heal fires on the consumer-project .claude/settings.local.json and the offline .peaks/.claude-settings-template.json. Idempotent. Use after a peaks-loop version bump if you do not otherwise re-run init. Mutually exclusive with --detect-1x.')).action(async (options) => {
-        const projectRoot = options.project ?? process.cwd();
-        // Branch 1: --detect-1x (read-only probe)
-        if (options.detect1x === true) {
-            try {
-                const state = detect1xProjectState(projectRoot);
-                const nextActions = [];
-                if (state.isOneX) {
-                    nextActions.push(`Detected 1.x state. peaks-code Step 0.55 should present an AskUserQuestion to invoke \`peaks upgrade --to 2.0 --auto --project ${state.projectRoot ?? projectRoot}\`.`);
-                }
-                else {
-                    nextActions.push('No 1.x state detected. Proceed with the standing 2.0 layout.');
-                }
-                const envelope = ok('upgrade.detect-1x', state, [], nextActions);
-                printResult(io, envelope, options.json);
-            }
-            catch (error) {
-                const message = getErrorMessage(error);
-                printResult(io, fail('upgrade.detect-1x', 'DETECT_1X_FAILED', message, { isOneX: false, signals: [], projectRoot: null, configPath: null }, [message]), options.json);
-                process.exitCode = 1;
-            }
-            return;
-        }
-        // Branch 2: --apply-init (slice 4 — slice 2026-06-13-selfheal-claude-settings-template).
-        //
-        // The drift-driven self-heal inside initWorkspace only fires when
-        // the user invokes init. After a peaks-loop version bump, users who
-        // never re-run init are stuck with stale templates until they do.
-        // This flag is the post-bump escape hatch: it triggers init for them.
-        //
-        // We do NOT pass --session-id (the CLI auto-generates / reuses an
-        // existing binding). We do NOT pass --no-claude-hooks (the goal is to
-        // bring the project to the current peaks-loop baseline, including the
-        // consumer-project hook).
-        if (options.applyInit === true) {
-            try {
-                const canonicalRoot = resolveCanonicalProjectRoot(projectRoot);
-                // Match the workspace-init CLI's pattern: resolve the session id
-                // (auto-generate / reuse binding / rotate on outer-mismatch)
-                // BEFORE calling initWorkspace. initWorkspace itself validates
-                // the session id and does NOT auto-generate, so we have to do
-                // the rotation-aware resolution here.
-                const sessionResolution = await ensureSessionWithRotation(canonicalRoot, {
-                    skipRotateOnOuterMismatch: false
-                });
-                const result = await initWorkspace({
-                    projectRoot: canonicalRoot,
-                    sessionId: sessionResolution.sessionId,
-                    allowSessionRebind: false
-                });
-                const nextActions = [];
-                // Surface the same self-heal messaging that workspace-init uses.
-                if (result.claudeSettings.offlineTemplate.action === 'refreshed') {
-                    nextActions.push(`Self-healed .peaks/.claude-settings-template.json (action: refreshed) — ` +
-                        'the offline recovery anchor now matches the current peaks-loop template.');
-                    nextActions.push('⚠️  If you had manually edited .peaks/.claude-settings-template.json, ' +
-                        'those edits have been overwritten by the self-heal.');
-                }
-                else if (result.claudeSettings.offlineTemplate.action === 'written') {
-                    nextActions.push('Wrote .peaks/.claude-settings-template.json (action: written) — ' +
-                        'the offline recovery anchor is now in place.');
-                }
-                if (result.claudeSettings.action === 'refreshed') {
-                    nextActions.push(`Refreshed .claude/settings.local.json (action: refreshed) — ` +
-                        'the consumer-project hook now matches the current peaks-loop template. ' +
-                        'Restart Claude Code so the hooks take effect.');
-                }
-                else if (result.claudeSettings.action === 'written') {
-                    nextActions.push('Wrote .claude/settings.local.json (action: written) — ' +
-                        'the [Fact-Forcing Gate] bypass is now in effect. Restart Claude Code so the hooks take effect.');
-                }
-                const envelope = ok('upgrade.apply-init', result, [], nextActions);
-                printResult(io, envelope, options.json);
-            }
-            catch (error) {
-                const message = getErrorMessage(error);
-                printResult(io, fail('upgrade.apply-init', 'APPLY_INIT_FAILED', message, { applied: false }, [message]), options.json);
-                process.exitCode = 1;
-            }
-            return;
-        }
-        // Branch 3: the umbrella (existing behavior)
-        try {
-            const result = runUpgrade({ projectRoot, auto: options.auto === true });
-            const nextActions = [...result.nextActions];
-            if (result.failedCount > 0) {
-                nextActions.unshift(`${result.failedCount} sub-step(s) failed. Re-run \`peaks upgrade --to 2.0\` to retry.`);
-            }
-            if (result.upgradeRecordPath !== null) {
-                nextActions.push(`Upgrade record written: ${result.upgradeRecordPath}`);
-            }
-            const envelope = ok('upgrade', result, [...result.warnings], nextActions);
-            printResult(io, envelope, options.json);
-            if (result.failedCount > 0) {
-                process.exitCode = 1;
-            }
-        }
-        catch (error) {
-            const message = getErrorMessage(error);
-            printResult(io, fail('upgrade', 'UPGRADE_FAILED', message, { applied: false }, [message]), options.json);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/user-touchpoint-commands.d.ts

@@ -1,18 +0,0 @@
-/**
- * v2.15.0 follow-up — G4: user touchpoint CLI.
- *
- *   - `peaks code gate-classify --step <step-id>` — classify a single
- *     Code gate (business / tech / mode-selection / commit-boundary /
- *     commit-floor)
- *   - `peaks code user-touchpoints`                — list all gates the
- *     user must review (vs AI auto-decides in full-auto)
- *   - `peaks code commit-boundary-actions`         — list the 5
- *     hard-floor commit actions (push / tag / publish / global
- *     install)
- *
- * Surfaces the 12 Gaps positioning memory rule:
- *   "user 在循环里 = 业务/产品审阅者,不参与技术决策"
- */
-import type { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerUserTouchpointCommands(program: Command, io: ProgramIO): void;