peaks-loop 3.1.2 → 4.0.0-beta.10

package/dist/src/cli/commands/sub-agent-commands.d.ts

@@ -1,22 +0,0 @@
-/**
- * `peaks sub-agent` CLI command group — slice 2026-06-07-sub-agent-context-governance.
- *
- * Thin entry point that wires the four sub-command registrars
- * (`dispatch`, `heartbeat`, `share`, `shared-read`, `await`) to the
- * parent `sub-agent` command. The actual implementations live in
- * sibling files (slice 2026-06-23-audit-p0-split refactor):
- *
- *   - `dispatch-commands.ts`  — `dispatch` single-dispatch action
- *   - `dispatch-from-dag.ts`  — `dispatch --from-dag` codepath (slice 9 perf)
- *   - `heartbeat-commands.ts` — `heartbeat` action (G6)
- *   - `share-commands.ts`     — `share` + `shared-read` + `await` actions (G8.4 / 2.7.0)
- *   - `sub-agent-shared.ts`   — shared types, constants, helpers
- *
- * Skill-first / CLI-auxiliary red line (PB-4 / AC-19/20):
- *   These commands are primitives that the peaks-solo / peaks-rd /
- *   peaks-qa SKILL.md compose. Users do NOT invoke them directly.
- */
-import type { Command } from 'commander';
-import type { ProgramIO } from '../cli-helpers.js';
-export { validateRole } from './sub-agent-shared.js';
-export declare function registerSubAgentCommands(program: Command, io: ProgramIO): void;

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

@@ -1,19 +0,0 @@
-import { registerDispatchCommand } from './dispatch-commands.js';
-import { registerHeartbeatCommand } from './heartbeat-commands.js';
-import { registerShareCommand, registerSharedReadCommand, registerAwaitCommand } from './share-commands.js';
-// Re-export `validateRole` for backward compat — the integration test
-// suite and any external callers still import it from this entry file.
-// The canonical implementation now lives in `sub-agent-shared.ts`.
-export { validateRole } from './sub-agent-shared.js';
-export function registerSubAgentCommands(program, io) {
-    const subAgent = program
-        .command('sub-agent')
-        .description('Sub-agent dispatch primitive (skill-first / CLI-auxiliary). ' +
-        'These commands are the primitives that peaks-solo / peaks-rd / ' +
-        'peaks-qa SKILL.md compose. Users do not invoke this directly.');
-    registerDispatchCommand(subAgent, io);
-    registerHeartbeatCommand(subAgent, io);
-    registerShareCommand(subAgent, io);
-    registerSharedReadCommand(subAgent, io);
-    registerAwaitCommand(subAgent, io);
-}

package/dist/src/cli/commands/sub-agent-shared.d.ts

@@ -1,99 +0,0 @@
-/**
- * Shared types, constants, and helpers for the `peaks sub-agent` command group.
- *
- * Slice 2026-06-23-audit-p0-split — pulled out of `sub-agent-commands.ts` (968
- * lines) to honor the 800-line file cap (Karpathy #2 Simplicity First).
- *
- * Public exports:
- *   - `validateRole(role)` — exported because `sub-agent-commands.test.ts`
- *     and the integration suite rely on it as the source of truth for
- *     role-string validation.
- *
- * Everything else is internal to the `peaks sub-agent` group.
- */
-import type { SubAgentBatchResult } from '../../services/dispatch/sub-agent-dispatcher.js';
-import type { HeadroomMode } from '../../services/context/headroom-client.js';
-import type { HeartbeatStatus } from '../../services/dispatch/dispatch-record-writer.js';
-export declare const RECOMMENDED_ROLES = "rd | qa | ui | txt | qa-business | qa-perf | qa-security | qa-business-<*> | general-purpose";
-export declare const HEARTBEAT_STATUSES: readonly HeartbeatStatus[];
-export declare const HEADROOM_MODES: readonly HeadroomMode[];
-export declare const PROMPT_LIMIT_BYTES: number;
-export type DispatchOptions = {
-    prompt?: string;
-    promptLength?: string;
-    requestId?: string;
-    sessionId?: string;
-    project?: string;
-    batchId?: string;
-    writeArtifact?: string;
-    useHeadroom?: boolean;
-    headroomMode?: string;
-    force?: boolean;
-    fromDag?: string;
-    json?: boolean;
-};
-export type HeartbeatOptions = {
-    record?: string;
-    status?: string;
-    progress?: string;
-    note?: string;
-    project?: string;
-    json?: boolean;
-};
-export type ShareOptions = {
-    batch?: string;
-    key?: string;
-    value?: string;
-    from?: string;
-    requestId?: string;
-    sessionId?: string;
-    project?: string;
-    json?: boolean;
-};
-export type SharedReadOptions = {
-    batch?: string;
-    since?: string;
-    key?: string;
-    requestId?: string;
-    sessionId?: string;
-    project?: string;
-    json?: boolean;
-};
-export type AwaitOptions = {
-    batch?: string;
-    timeout?: string;
-    project?: string;
-    sessionId?: string;
-    json?: boolean;
-};
-/**
- * Lazy-loaded module types — only resolved inside `runDispatchFromDag`
- * to keep the warm-path dispatch CLI cold-start fast (slice 9).
- */
-export type SliceDagModule = typeof import('../../services/dispatch/slice-dag.js');
-export type DagOrchestratorModule = typeof import('../../services/solo/dag-orchestrator.js');
-export type ContractStoreModule = typeof import('../../services/dispatch/contract-store.js');
-/**
- * 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 declare function validateRole(role: string): string | 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 declare function summarizeBatchResults(results: readonly SubAgentBatchResult[]): {
-    readonly total: number;
-    readonly done: number;
-    readonly failed: number;
-    readonly cancelled: number;
-    readonly timeout: number;
-};

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-solo / 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-solo 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-solo 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-solo 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-solo 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 solo gate-classify --step <step-id>` — classify a single
- *     Solo gate (business / tech / mode-selection / commit-boundary /
- *     commit-floor)
- *   - `peaks solo user-touchpoints`                — list all gates the
- *     user must review (vs AI auto-decides in full-auto)
- *   - `peaks solo 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;

package/dist/src/cli/commands/user-touchpoint-commands.js

@@ -1,78 +0,0 @@
-/**
- * v2.15.0 follow-up — G4: user touchpoint CLI.
- *
- *   - `peaks solo gate-classify --step <step-id>` — classify a single
- *     Solo gate (business / tech / mode-selection / commit-boundary /
- *     commit-floor)
- *   - `peaks solo user-touchpoints`                — list all gates the
- *     user must review (vs AI auto-decides in full-auto)
- *   - `peaks solo commit-boundary-actions`         — list the 5
- *     hard-floor commit actions (push / tag / publish / global
- *     install)
- *
- * Surfaces the 12 Gaps positioning memory rule:
- *   "user 在循环里 = 业务/产品审阅者,不参与技术决策"
- */
-import { aiAutoDecidesGates, classifyGate, COMMIT_BOUNDARY_ACTIONS_LIST, userMustReviewGates } from '../../services/solo/user-touchpoint-classifier.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, printResult } from '../cli-helpers.js';
-export function registerUserTouchpointCommands(program, io) {
-    // G4 commands are registered as TOP-LEVEL commands (not sub-commands
-    // of `peaks solo`) because `peaks solo` is a SKILL (consumed by the
-    // LLM in SKILL.md), not a CLI command. Top-level names: gate-classify /
-    // user-touchpoints / commit-boundary-actions.
-    //
-    // We do NOT create a new `peaks solo` CLI command here because that
-    // would conflict with the peaks-solo skill presence tracking (see
-    // `src/services/skills/skill-presence-service.ts`).
-    addJsonOption(program
-        .command('gate-classify')
-        .description('v2.15.0 follow-up G4: classify a single Solo gate by its decision kind: ' +
-        'business / tech / mode-selection / commit-boundary / commit-floor. ' +
-        'Returns null when the step is unknown.')
-        .requiredOption('--step <step-id>', 'step id (e.g. step-1-mode-select, phase-2-prd-confirm)')).action((opts) => {
-        const c = classifyGate(opts.step);
-        if (c === null) {
-            printResult(io, fail('solo.gate-classify', 'UNKNOWN_STEP', `unknown step "${opts.step}"`, {}, [
-                'Run `peaks solo user-touchpoints` to list all known steps.'
-            ]), opts.json ?? false);
-            process.exitCode = 1;
-            return;
-        }
-        printResult(io, ok('solo.gate-classify', { classification: c }, [], [
-            c.userShouldReview === 'always'
-                ? 'User must review this gate in all modes.'
-                : c.userShouldReview === 'business-only'
-                    ? 'User reviews this gate only when it surfaces a business decision.'
-                    : 'AI auto-decides this gate in full-auto. User does not need to review.'
-        ]), opts.json ?? false);
-    });
-    addJsonOption(program
-        .command('user-touchpoints')
-        .description('List all Solo gates the user must review. The 12 Gaps positioning ' +
-        'memory: user 在循环里 = 业务/产品审阅者,不参与技术决策。 ' +
-        'These are the only gates where the user is asked to decide.')).action((opts) => {
-        const must = userMustReviewGates();
-        const auto = aiAutoDecidesGates();
-        printResult(io, ok('solo.user-touchpoints', {
-            userMustReview: must,
-            aiAutoDecides: auto,
-            counts: {
-                userMustReview: must.length,
-                aiAutoDecides: auto.length
-            }
-        }, [], [
-            `User reviews ${must.length} gate(s); AI auto-decides ${auto.length} in full-auto.`,
-            'Goal: 减少 user 被打扰次数 from 14 → 6-8 (the must-review count).'
-        ]), opts.json ?? false);
-    });
-    addJsonOption(program
-        .command('commit-boundary-actions')
-        .description('List the 5 commit-boundary hard-floor actions. These are the ' +
-        'actions that PAUSE even in full-auto (v2.15.0 slice 002 AC-4 rule: ' +
-        '"full-auto 只做到 commit"). The user is always asked to confirm.')).action((opts) => {
-        printResult(io, ok('solo.commit-boundary-actions', { actions: COMMIT_BOUNDARY_ACTIONS_LIST }, [], [
-            'Even in full-auto, the user must explicitly confirm these actions.'
-        ]), opts.json ?? false);
-    });
-}

package/dist/src/cli/commands/verdict-aggregate-command.d.ts

@@ -1,14 +0,0 @@
-/**
- * v2.13.2 AC-2 — `peaks verdict aggregate` CLI surface.
- *
- * Reads the 5 envelope sources under `.peaks/_runtime/<sid>/` for a
- * given rid, runs `aggregateVerdict()`, and prints the verdict +
- * reasons JSON envelope. Used by peaks-solo / peaks-final-review to
- * cross-check the slice-level verdict without booting the full
- * 5-skill fanout.
- *
- * File budget: ≤ 150 lines (Karpathy §2).
- */
-import { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerVerdictAggregateCommands(program: Command, io: ProgramIO): void;

package/dist/src/cli/commands/verdict-aggregate-command.js

@@ -1,106 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { aggregateVerdict } from '../../services/verdict/verdict-aggregator.js';
-import { parseKarpathyEnvelope, parseMutEnvelope, parseQaEnvelope, parseSecurityEnvelope, parsePerfEnvelope, envelopesToAggregatorInput } from '../../services/verdict/envelopes.js';
-import { addJsonOption, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
-const SECURITY_REL = 'audit/security.md';
-const PERF_REL = 'audit/perf.md';
-const KARPATHY_REL = 'rd/karpathy-review.md';
-const MUT_REL = 'mut/mut-report.json';
-const QA_REL = 'qa/test-reports';
-export function registerVerdictAggregateCommands(program, io) {
-    const verdict = program.command('verdict').description('Aggregate the 5 envelope sources feeding peaks-solo verdict logic');
-    addJsonOption(verdict
-        .command('aggregate')
-        .description('Aggregate 5 envelope sources (security / perf / karpathy / mut / qa) and print the verdict + reasons JSON envelope. Used by peaks-solo and peaks-final-review.')
-        .requiredOption('--from-rid <rid>', 'request id, e.g. 2026-06-27-...')
-        .option('--sid <sid>', 'session id, e.g. 2026-06-27-session-...; default: project default')
-        .option('--project <path>', 'project root (default: cwd)')).action(async (options) => {
-        const projectRoot = options.project ?? process.cwd();
-        const sid = options.sid ?? 'default';
-        const rid = options.fromRid;
-        if (rid === undefined || rid.length === 0) {
-            printResult(io, fail('verdict.aggregate', 'RID_REQUIRED', '--from-rid is required', {}, ['Re-run with --from-rid <rid>']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const sources = {
-                // v2.13.3 AC-1: use the canonical markdown-aware parser from
-                // envelopes.ts. The old inline `parseSecurityFromMarkdown`
-                // only understood shape A (`- [SEV] dim @ file:line — hint`),
-                // so real dogfood fixtures using shape B (`- HIGH: hint in file:line`)
-                // returned `verdict: warn, violations: []` — the aggregator
-                // then produced `reasons: []` and `verdict: 'pass'` even when
-                // the audit had flagged HIGH violations.
-                security: readAudit(projectRoot, sid, SECURITY_REL, parseSecurityEnvelope),
-                perf: readAudit(projectRoot, sid, PERF_REL, parsePerfEnvelope),
-                karpathy: readAudit(projectRoot, sid, KARPATHY_REL, (m) => parseKarpathyEnvelope(m)),
-                mut: await readMut(projectRoot, sid),
-                qa: readQa(projectRoot, sid, rid)
-            };
-            const input = envelopesToAggregatorInput([
-                sources.security !== null ? { kind: 'security', envelope: sources.security } : null,
-                sources.perf !== null ? { kind: 'perf', envelope: sources.perf } : null,
-                sources.karpathy !== null ? { kind: 'karpathy', envelope: sources.karpathy } : null,
-                sources.mut !== null ? { kind: 'mut', envelope: sources.mut } : null,
-                sources.qa !== null ? { kind: 'qa', envelope: sources.qa } : null
-            ]);
-            const result = aggregateVerdict(input);
-            const sourceFlags = {
-                security: sources.security !== null ? 'present' : 'missing',
-                perf: sources.perf !== null ? 'present' : 'missing',
-                karpathy: sources.karpathy !== null ? 'present' : 'missing',
-                mut: sources.mut !== null ? 'present' : 'missing',
-                qa: sources.qa !== null ? 'present' : 'missing'
-            };
-            printResult(io, ok('verdict.aggregate', { verdict: result.verdict, reasons: result.reasons, sources: sourceFlags }, [], []), options.json);
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            printResult(io, fail('verdict.aggregate', 'AGGREGATE_FAILED', message, {}, ['Verify the rid/sid/project are correct']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}
-function readAudit(projectRoot, sid, rel, parse) {
-    const path = join(projectRoot, '.peaks', '_runtime', sid, rel);
-    if (!existsSync(path))
-        return null;
-    const md = readFileSync(path, 'utf8');
-    return parse(md);
-}
-async function readMut(projectRoot, sid) {
-    const path = join(projectRoot, '.peaks', '_runtime', sid, MUT_REL);
-    if (!existsSync(path))
-        return null;
-    const raw = readFileSync(path, 'utf8');
-    let json;
-    try {
-        json = JSON.parse(raw);
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        return null;
-    }
-    return parseMutJson(json);
-}
-function readQa(projectRoot, sid, rid) {
-    const dir = join(projectRoot, '.peaks', '_runtime', sid, QA_REL);
-    const candidates = [`${rid}.md`, `001-${rid}.md`];
-    for (const name of candidates) {
-        const path = join(dir, name);
-        if (existsSync(path)) {
-            const md = readFileSync(path, 'utf8');
-            return parseQaEnvelope(md);
-        }
-    }
-    return null;
-}
-function parseMutJson(json) {
-    return parseMutEnvelope(json);
-}
-// v2.13.3 AC-1: removed inline `parseSecurityFromMarkdown` /
-// `parsePerfFromMarkdown` (only handled shape A). The canonical
-// `parseSecurityEnvelope` / `parsePerfEnvelope` in envelopes.ts now
-// own the markdown parse + JSON back-compat fallback.