peaks-loop 4.0.0-beta → 4.0.0-beta.11

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/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 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-code 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/worker-commands.d.ts

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

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

@@ -1,52 +0,0 @@
-import { getMiniMaxProviderConfig } from '../../services/config/config-service.js';
-import { runMiniMaxWorker } from '../../services/providers/minimax-worker-service.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, getErrorMessage, printResult, redactSensitiveErrorMessage, summarizeMiniMaxWorkerResult } from '../cli-helpers.js';
-function addMiniMaxWorkerOptions(command) {
-    return addJsonOption(command
-        .description('Run a single MiniMax coding and unit-test execution worker')
-        .requiredOption('--session-id <id>', 'session identifier (the single-axis workspace binding after the change-id root removal)')
-        .requiredOption('--goal <goal>', 'execution goal')
-        .requiredOption('--coding-task <task>', 'coding execution task')
-        .requiredOption('--unit-test-task <task>', 'unit-test execution task')
-        .option('--model <model>', 'model name for the worker', 'MiniMax-M2.7')
-        .option('--confirm', 'confirm that worker inputs may be sent to the external MiniMax provider once and only return a review handoff', false));
-}
-async function runMiniMaxWorkerCommand(io, options) {
-    if (!options.confirm) {
-        printResult(io, fail('worker.minimax', 'CONFIRMATION_REQUIRED', 'This worker only runs with explicit confirmation because inputs may be sent to the external MiniMax provider', {}, ['Rerun with --confirm after removing secrets from worker inputs']), options.json);
-        process.exitCode = 1;
-        return;
-    }
-    const sessionId = options.sessionId.trim();
-    const goal = options.goal.trim();
-    const codingTask = options.codingTask.trim();
-    const unitTestTask = options.unitTestTask.trim();
-    if (!sessionId || !goal || !codingTask || !unitTestTask) {
-        printResult(io, fail('worker.minimax', 'INVALID_WORKER_INPUT', 'Worker inputs must be non-empty', {}, ['Provide non-empty values for --session-id, --goal, --coding-task, and --unit-test-task']), options.json);
-        process.exitCode = 1;
-        return;
-    }
-    try {
-        const result = await runMiniMaxWorker(getMiniMaxProviderConfig(), { sessionId, goal, codingTask, unitTestTask, model: options.model });
-        const safeResult = summarizeMiniMaxWorkerResult(result);
-        if (!result.provider.configured) {
-            printResult(io, fail('worker.minimax', 'MINIMAX_PROVIDER_NOT_CONFIGURED', 'MiniMax provider requires baseUrl and apiKey in user config', safeResult, ['Run peaks config provider minimax set --base-url <url> and either MINIMAX_API_KEY']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        printResult(io, result.provider.ok ? ok('worker.minimax', safeResult) : fail('worker.minimax', 'MINIMAX_WORKER_FAILED', 'MiniMax worker execution failed', safeResult, ['Check the MiniMax base URL, API key, and worker tasks']), options.json);
-        if (!result.provider.ok) {
-            process.exitCode = 1;
-        }
-    }
-    catch (error) {
-        printResult(io, fail('worker.minimax', 'MINIMAX_WORKER_FAILED', redactSensitiveErrorMessage(getErrorMessage(error)), {}, ['Check the MiniMax base URL, API key, and worker tasks']), options.json);
-        process.exitCode = 1;
-    }
-}
-export function registerWorkerCommands(program, io) {
-    const worker = program.command('worker').description('Run controlled execution workers');
-    addMiniMaxWorkerOptions(worker.command('minimax')).action(async (options) => runMiniMaxWorkerCommand(io, options));
-    addMiniMaxWorkerOptions(program.command('minimax-worker')).action(async (options) => runMiniMaxWorkerCommand(io, options));
-}