peaks-loop 4.0.53 → 4.1.0

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

@@ -12,18 +12,18 @@ import { resolve } from 'node:path';
 import { runRedLinesAudit } from '../../services/audit/red-lines-service.js';
 import { runStaticAudit } from '../../services/audit/static-service.js';
 import { auditGoal, IncompleteAuditError } from '../../services/audit/audit-goal-service.js';
-import { createAnthropicRunner, LlmBindingError, LlmRequestError, resolveAnthropicConfig, } from '../../services/llm/anthropic-runner.js';
+import { createAnthropicRunner, LlmBindingError, LlmRequestError, resolveAnthropicConfig } from '../../services/llm/anthropic-runner.js';
 import { createStubRunner } from '../../services/llm/stub-runner.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 import { writeAuditDecision } from '../../services/audit/decision-writer.js';
 import { computeProseRatio } from '../../services/audit/prose-ratio-calculator.js';
-import { writeMachineOutput, writeNarrative, writePrompt, } from '../../services/audit/artifact-writer.js';
+import { writeMachineOutput, writeNarrative, writePrompt } from '../../services/audit/artifact-writer.js';
 const SUPPORTED_ARTIFACT_KINDS = [
     'decision',
     'prompt',
     'machine-output',
-    'narrative',
+    'narrative'
 ];
 function isSupportedArtifactKind(value) {
     return SUPPORTED_ARTIFACT_KINDS.includes(value);
@@ -42,7 +42,11 @@ function isSupportedLlmProvider(value) {
 function validateProjectRoot(projectArg) {
     const projectRoot = resolve(projectArg);
     if (!existsSync(projectRoot)) {
-        return { ok: false, code: 'PROJECT_NOT_FOUND', message: `project path does not exist: ${projectArg}` };
+        return {
+            ok: false,
+            code: 'PROJECT_NOT_FOUND',
+            message: `project path does not exist: ${projectArg}`
+        };
     }
     let stat;
     try {
@@ -52,7 +56,11 @@ function validateProjectRoot(projectArg) {
         return { ok: false, code: 'INVALID_PROJECT', message: getErrorMessage(error) };
     }
     if (!stat.isDirectory()) {
-        return { ok: false, code: 'INVALID_PROJECT', message: `project path is not a directory: ${projectArg}` };
+        return {
+            ok: false,
+            code: 'INVALID_PROJECT',
+            message: `project path is not a directory: ${projectArg}`
+        };
     }
     return { ok: true, projectRoot };
 }
@@ -63,10 +71,17 @@ export function registerAuditCommands(program, io) {
     addJsonOption(audit
         .command('red-lines')
         .description('Scan skills/, .claude/rules/, and openspec/changes/ for MANDATORY / BLOCKING / MUST NOT / RED LINE markers; classify each as cli-backed / partial / prose-only')
-        .requiredOption('--project <path>', 'target project root')).action(async (options) => {
+        .requiredOption('--project <path>', 'target project root')).action((options) => {
         const validation = validateProjectRoot(options.project);
         if (!validation.ok) {
-            printResult(io, fail('audit.red-lines', validation.code, validation.message, { totalRedLines: 0, cliBacked: 0, partial: 0, proseOnly: 0, audit: [], enforcerFindings: [] }, ['Verify the project path exists and is a directory']), options.json);
+            printResult(io, fail('audit.red-lines', validation.code, validation.message, {
+                totalRedLines: 0,
+                cliBacked: 0,
+                partial: 0,
+                proseOnly: 0,
+                audit: [],
+                enforcerFindings: []
+            }, ['Verify the project path exists and is a directory']), options.json);
             process.exitCode = 1;
             return;
         }
@@ -83,7 +98,14 @@ export function registerAuditCommands(program, io) {
             printResult(io, envelope, options.json);
         }
         catch (error) {
-            printResult(io, fail('audit.red-lines', 'SCANNER_FAILED', getErrorMessage(error), { totalRedLines: 0, cliBacked: 0, partial: 0, proseOnly: 0, audit: [], enforcerFindings: [] }, ['Inspect scanner logs and re-run with the same --project path']), options.json);
+            printResult(io, fail('audit.red-lines', 'SCANNER_FAILED', getErrorMessage(error), {
+                totalRedLines: 0,
+                cliBacked: 0,
+                partial: 0,
+                proseOnly: 0,
+                audit: [],
+                enforcerFindings: []
+            }, ['Inspect scanner logs and re-run with the same --project path']), options.json);
             process.exitCode = 1;
         }
     });
@@ -105,7 +127,7 @@ export function registerAuditCommands(program, io) {
         .description('Run the static audit (peaks-loop lint only; the ECC AgentShield subprocess was removed in 4.0.0-beta.11). Per spec §5.3.')
         .requiredOption('--project <path>', 'target project root')
         .option('--record', 'persist the audit snapshot to .peaks/memory/audit-decisions/ as a project-memory decision')
-        .option('--rid <rid>', 'disambiguator for the decision record slug (used with --record; pairs multiple audits on the same day)')).action(async (options) => {
+        .option('--rid <rid>', 'disambiguator for the decision record slug (used with --record; pairs multiple audits on the same day)')).action((options) => {
         const validation = validateProjectRoot(options.project);
         if (!validation.ok) {
             printResult(io, fail('audit.static', validation.code, validation.message, emptyStaticAuditData(), ['Verify the project path exists and is a directory']), options.json);
@@ -173,7 +195,7 @@ export function registerAuditCommands(program, io) {
         .command('prose-ratio')
         .description('Compute the prose-only ratio (informational entries excluded). Exits 1 if ratio > target (default 5%).')
         .requiredOption('--project <path>', 'target project root')
-        .option('--target <n>', 'maximum prose-only ratio (0-1, default 0.05)', '0.05')).action(async (options) => {
+        .option('--target <n>', 'maximum prose-only ratio (0-1, default 0.05)', '0.05')).action((options) => {
         const validation = validateProjectRoot(options.project);
         if (!validation.ok) {
             printResult(io, fail('audit.prose-ratio', validation.code, validation.message, emptyProseRatioResult(), ['Verify the project path exists and is a directory']), options.json);
@@ -236,7 +258,9 @@ export function registerAuditCommands(program, io) {
             return;
         }
         const isStub = provider === 'stub';
-        const providerBinding = isStub ? 'stub' : 'anthropic-messages-api';
+        const providerBinding = isStub
+            ? 'stub'
+            : 'anthropic-messages-api';
         try {
             let model;
             let llmRunner;
@@ -255,11 +279,15 @@ export function registerAuditCommands(program, io) {
                 need: options.need,
                 projectRoot: validation.projectRoot,
                 result,
-                ...(model === undefined ? {} : { model }),
+                ...(model === undefined ? {} : { model })
             };
             const envelope = ok('audit.goal', data, [], isStub
-                ? [`Stub provider: the 6 dimensions below are placeholders, not findings. Re-run with \`--llm-provider ${DEFAULT_LLM_PROVIDER}\` for a real audit.`]
-                : [`Audit produced by ${providerBinding}${model === undefined ? '' : ` (model: ${model})`}.`]);
+                ? [
+                    `Stub provider: the 6 dimensions below are placeholders, not findings. Re-run with \`--llm-provider ${DEFAULT_LLM_PROVIDER}\` for a real audit.`
+                ]
+                : [
+                    `Audit produced by ${providerBinding}${model === undefined ? '' : ` (model: ${model})`}.`
+                ]);
             printResult(io, envelope, options.json);
         }
         catch (error) {
@@ -300,7 +328,7 @@ export function registerAuditCommands(program, io) {
                 filePath: '',
                 memoryDir: '',
                 indexPath: '',
-                indexSynced: false,
+                indexSynced: false
             }, ['Verify the project path exists and is a directory']), options.json);
             process.exitCode = 1;
             return;
@@ -314,10 +342,10 @@ export function registerAuditCommands(program, io) {
                 filePath: '',
                 memoryDir: '',
                 indexPath: '',
-                indexSynced: false,
+                indexSynced: false
             }, [
                 `Re-run with --kind <one of ${SUPPORTED_ARTIFACT_KINDS.join(' | ')}>`,
-                'See .peaks/memory/audit-artifact-convention.md for the 4 artifact types.',
+                'See .peaks/memory/audit-artifact-convention.md for the 4 artifact types.'
             ]), options.json);
             process.exitCode = 1;
             return;
@@ -332,7 +360,7 @@ export function registerAuditCommands(program, io) {
                 filePath: '',
                 memoryDir: '',
                 indexPath: '',
-                indexSynced: false,
+                indexSynced: false
             }, ['Verify the --input path is correct (relative paths resolve against cwd)']), options.json);
             process.exitCode = 1;
             return;
@@ -343,7 +371,7 @@ export function registerAuditCommands(program, io) {
         const writeOpts = {
             projectRoot: validation.projectRoot,
             dryRun: options.dryRun === true,
-            ...(options.rid ? { rid: options.rid } : {}),
+            ...(options.rid ? { rid: options.rid } : {})
         };
         let record;
         try {
@@ -374,8 +402,10 @@ export function registerAuditCommands(program, io) {
                         filePath: '',
                         memoryDir: '',
                         indexPath: '',
-                        indexSynced: false,
-                    }, ["Re-run with 'peaks audit static --record --project <root>' for RedLineAudit snapshots."]), options.json);
+                        indexSynced: false
+                    }, [
+                        "Re-run with 'peaks audit static --record --project <root>' for RedLineAudit snapshots."
+                    ]), options.json);
                     process.exitCode = 1;
                     return;
                 }
@@ -394,7 +424,7 @@ export function registerAuditCommands(program, io) {
                 filePath: '',
                 memoryDir: '',
                 indexPath: '',
-                indexSynced: false,
+                indexSynced: false
             }, ['Inspect the error message; for --kind machine-output ensure --input is valid JSON']), options.json);
             process.exitCode = 1;
             return;
@@ -403,19 +433,26 @@ export function registerAuditCommands(program, io) {
             `Artifact written via ${record.kind} writer.`,
             record.indexSynced
                 ? 'Memory index regenerated; entry will appear in `peaks project memories` on next read.'
-                : 'Memory index NOT regenerated; run `peaks project memories --project <root>` to refresh.',
+                : 'Memory index NOT regenerated; run `peaks project memories --project <root>` to refresh.'
         ]), options.json);
     });
 }
 function emptyStaticAuditData() {
     return {
-        audit: { totalRedLines: 0, cliBacked: 0, partial: 0, proseOnly: 0, audit: [], enforcerFindings: [] },
+        audit: {
+            totalRedLines: 0,
+            cliBacked: 0,
+            partial: 0,
+            proseOnly: 0,
+            audit: [],
+            enforcerFindings: []
+        },
         agentShield: {
             spawned: false,
             installed: false,
             reason: 'flag-disabled',
-            findings: [],
-        },
+            findings: []
+        }
     };
 }
 function auditGoalFailureData(need, projectRoot, providerBinding = 'unresolved', missingEnv) {
@@ -424,12 +461,14 @@ function auditGoalFailureData(need, projectRoot, providerBinding = 'unresolved',
         providerBinding,
         need,
         projectRoot,
-        ...(missingEnv === undefined ? {} : { missingEnv }),
+        ...(missingEnv === undefined ? {} : { missingEnv })
     };
 }
 /** The slice-owned error codes are carried verbatim so callers can gate on them. */
 function auditGoalErrorCode(error) {
-    if (error instanceof IncompleteAuditError || error instanceof LlmBindingError || error instanceof LlmRequestError) {
+    if (error instanceof IncompleteAuditError ||
+        error instanceof LlmBindingError ||
+        error instanceof LlmRequestError) {
         return error.code;
     }
     return 'AUDIT_GOAL_FAILED';
@@ -439,12 +478,16 @@ function auditGoalNextActions(code) {
         case 'LLM_CREDENTIAL_MISSING':
             return [
                 'Export ANTHROPIC_AUTH_TOKEN (or ANTHROPIC_API_KEY) in the environment that launches peaks, then re-run.',
-                'For an offline scaffold instead of an audit, re-run with `--llm-provider stub` — it performs NO audit.',
+                'For an offline scaffold instead of an audit, re-run with `--llm-provider stub` — it performs NO audit.'
             ];
         case 'LLM_MODEL_MISSING':
-            return ['Export ANTHROPIC_MODEL (or CLAUDE_CODE_SUBAGENT_MODEL) in the environment that launches peaks, then re-run.'];
+            return [
+                'Export ANTHROPIC_MODEL (or CLAUDE_CODE_SUBAGENT_MODEL) in the environment that launches peaks, then re-run.'
+            ];
         case 'INCOMPLETE_AUDIT':
-            return ['The LLM reply omitted a required dimension; re-run so autonomous work never proceeds on a partial audit.'];
+            return [
+                'The LLM reply omitted a required dimension; re-run so autonomous work never proceeds on a partial audit.'
+            ];
         default:
             return ['Inspect the failure above, then re-run with the same --need.'];
     }
@@ -459,6 +502,6 @@ function emptyProseRatioResult() {
         informational: 0,
         ratio: 0,
         target: 0.05,
-        exceeds: false,
+        exceeds: false
     };
 }

package/dist/cli/commands/autonomous-swarm-commands.d.ts

@@ -1,4 +1,4 @@
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export type AutonomousPlanOptions = {
     mode: string;

package/dist/cli/commands/autonomous-swarm-commands.js

@@ -2,7 +2,7 @@ import { fail, ok } from 'peaks-loop-shared/result';
 import { getWorkspaceConfigForPath } from '../../services/config/config-service.js';
 import { getLocalArtifactPath } from '../../services/artifacts/workspace-service.js';
 import { findProjectRoot } from '../../services/config/config-safety.js';
-import { planAutonomousRdSwarm, buildAutonomousGoalPackage, buildResumeInstructions, } from '../../services/autonomous-swarm/autonomous-swarm-service.js';
+import { planAutonomousRdSwarm, buildAutonomousGoalPackage, buildResumeInstructions } from '../../services/autonomous-swarm/autonomous-swarm-service.js';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { mapServiceError } from './_cli-error-envelope.js';
 const SUPPORTED_AUTONOMOUS_MODES = ['code', 'team'];
@@ -13,7 +13,7 @@ function projectContext() {
     const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
     const workspace = getWorkspaceConfigForPath(projectRoot);
     return {
-        workspaceRoot: workspace ? getLocalArtifactPath(workspace) : projectRoot,
+        workspaceRoot: workspace ? getLocalArtifactPath(workspace) : projectRoot
     };
 }
 function autonomousWorkspaceRoot() {
@@ -49,7 +49,7 @@ export function runAutonomousSwarmPlan(io, options) {
             mode: options.mode,
             maxWorkers,
             dryRun: true,
-            workspaceRoot,
+            workspaceRoot
         });
         const plan = planAutonomousRdSwarm({
             changeId: options.changeId,
@@ -58,7 +58,7 @@ export function runAutonomousSwarmPlan(io, options) {
             maxWorkers,
             dryRun: true,
             workspaceRoot,
-            requiresTechApproval: false,
+            requiresTechApproval: false
         });
         const resumeInstructions = buildResumeInstructions(plan);
         printResult(io, ok('workflow.autonomous', {
@@ -73,7 +73,7 @@ export function runAutonomousSwarmPlan(io, options) {
             nextActions: plan.nextActions,
             resumeInstructions,
             autonomyMode: plan.autonomyMode,
-            available: plan.available,
+            available: plan.available
         }), options.json);
     }
     catch (error) {
@@ -83,15 +83,21 @@ export function runAutonomousSwarmPlan(io, options) {
         // generic INTERNAL_ERROR fallback).
         if (error instanceof Error && /changeId|change-id/.test(error.message)) {
             if (error.message.includes('empty')) {
-                printResult(io, fail('workflow.autonomous', 'change-id-empty', error.message, {}, ['Provide a change-id matching [A-Za-z0-9][A-Za-z0-9._-]*']), options.json);
+                printResult(io, fail('workflow.autonomous', 'change-id-empty', error.message, {}, [
+                    'Provide a change-id matching [A-Za-z0-9][A-Za-z0-9._-]*'
+                ]), options.json);
             }
             else {
-                printResult(io, fail('workflow.autonomous', 'change-id-format', error.message, {}, ['Provide a change-id matching [A-Za-z0-9][A-Za-z0-9._-]*']), options.json);
+                printResult(io, fail('workflow.autonomous', 'change-id-format', error.message, {}, [
+                    'Provide a change-id matching [A-Za-z0-9][A-Za-z0-9._-]*'
+                ]), options.json);
             }
             process.exitCode = 1;
             return;
         }
-        printResult(io, fail('workflow.autonomous', mapping.code, getErrorMessage(error), {}, [...mapping.nextActions]), options.json);
+        printResult(io, fail('workflow.autonomous', mapping.code, getErrorMessage(error), {}, [
+            ...mapping.nextActions
+        ]), options.json);
         process.exitCode = 1;
     }
 }

package/dist/cli/commands/baseline-commands.js

@@ -8,7 +8,15 @@ import { GUARD_CONTRACTS, getGuardContract, isJourneyId } from '../../services/c
 import { exitCodeForGuardSummary, runAllGuards } from '../../services/capability-guard-runner/runner.js';
 import { RUNTIME_SESSIONLESS_SCOPE } from '../../services/workspace/runtime-layout.js';
 function fail(io, code, message, data = {}) {
-    io.stdout(JSON.stringify({ ok: false, command: `baseline`, code, message, data, warnings: [], nextActions: [] }));
+    io.stdout(JSON.stringify({
+        ok: false,
+        command: `baseline`,
+        code,
+        message,
+        data,
+        warnings: [],
+        nextActions: []
+    }));
     process.exitCode = 1;
 }
 function ok(io, command, data, nextActions = []) {
@@ -32,7 +40,9 @@ function guardContext(projectRoot) {
     return { projectRoot, sessionId: 'cli', contract: {}, baselineInvariant: 'auto' };
 }
 export function registerBaselineCommands(program, io) {
-    const baseline = program.command('baseline').description('Manage the capability baseline (frozen product semantics for 15 P0 journeys).');
+    const baseline = program
+        .command('baseline')
+        .description('Manage the capability baseline (frozen product semantics for 15 P0 journeys).');
     baseline
         .command('freeze')
         .description('Freeze the capability baseline from a JSON file (SquabbyZ-signed).')
@@ -67,7 +77,11 @@ export function registerBaselineCommands(program, io) {
             fail(io, r.error.code, r.error.message);
             return;
         }
-        const rows = r.file.rows.map((row) => ({ journeyId: row.journeyId, intent: row.intent, invariantCount: row.invariants.length }));
+        const rows = r.file.rows.map((row) => ({
+            journeyId: row.journeyId,
+            intent: row.intent,
+            invariantCount: row.invariants.length
+        }));
         ok(io, 'baseline.list', { version: r.file.version, signedAt: r.file.signedAt, rows });
     });
     baseline
@@ -136,7 +150,11 @@ export function registerBaselineCommands(program, io) {
             fail(io, r.error.code, r.error.message);
             return;
         }
-        ok(io, 'baseline.diff', { version: r.file.version, signedAt: r.file.signedAt, rowsCount: r.file.rows.length });
+        ok(io, 'baseline.diff', {
+            version: r.file.version,
+            signedAt: r.file.signedAt,
+            rowsCount: r.file.rows.length
+        });
     });
     baseline
         .command('audit')
@@ -191,7 +209,7 @@ export function registerBaselineCommands(program, io) {
     });
     baseline
         .command('freeze-update')
-        .description('Update one or more baseline rows. The LLM authors the JSON; --confirm records the user\'s approval.')
+        .description("Update one or more baseline rows. The LLM authors the JSON; --confirm records the user's approval.")
         .option('--from <path>', 'Path to the new baseline JSON input')
         .option('--confirm', "Record the user's approval (collected via AskUserQuestion) for this ratchet change")
         .option('--project <path>', 'Project root', '.')
@@ -228,7 +246,7 @@ export function registerBaselineCommands(program, io) {
     });
     baseline
         .command('rollback')
-        .description('Roll the baseline back to a historical version. --confirm records the user\'s approval.')
+        .description("Roll the baseline back to a historical version. --confirm records the user's approval.")
         .option('--to <version>', 'Historical version to roll back to')
         .option('--confirm', "Record the user's approval (collected via AskUserQuestion) for this rollback")
         .option('--project <path>', 'Project root', '.')
@@ -265,11 +283,15 @@ export function registerBaselineCommands(program, io) {
             fail(io, after.error.code, after.error.message);
             return;
         }
-        ok(io, 'baseline.rollback', { fromVersion: r.file.version, toVersion: after.file.version, historyPath: source });
+        ok(io, 'baseline.rollback', {
+            fromVersion: r.file.version,
+            toVersion: after.file.version,
+            historyPath: source
+        });
     });
     baseline
         .command('reset')
-        .description('Wipe the current baseline and require a re-freeze. --confirm records the user\'s approval.')
+        .description("Wipe the current baseline and require a re-freeze. --confirm records the user's approval.")
         .option('--confirm', "Record the user's approval (collected via AskUserQuestion) for the wipe")
         .option('--project <path>', 'Project root', '.')
         .option('--json', 'Emit JSON envelope')
@@ -289,6 +311,9 @@ export function registerBaselineCommands(program, io) {
         const wipedVersion = r.ok ? r.file.version : null;
         rmSync(join(CURRENT_DIR(projectRoot), 'capability-baseline.json'), { force: true });
         rmSync(join(CURRENT_DIR(projectRoot), 'capability-baseline.lock'), { force: true });
-        ok(io, 'baseline.reset', { wipedVersion, nextAction: 're-freeze with `baseline freeze --from <path>`' });
+        ok(io, 'baseline.reset', {
+            wipedVersion,
+            nextAction: 're-freeze with `baseline freeze --from <path>`'
+        });
     });
 }

package/dist/cli/commands/bee-commands.d.ts

@@ -21,6 +21,6 @@
  * The `peaks skill sediment export / import` alias lives in
  * `src/cli/commands/skill-sediment.ts` for one release cycle.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerBeeCommands(program: Command, io: ProgramIO): void;

package/dist/cli/commands/bee-commands.js

@@ -27,28 +27,25 @@ import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { openStateDb } from '../../services/skillhub/sqlite-store.js';
-import { writeBundle, BundleNotShareableError, BundleAssetNotFoundError, } from '../../services/share/bundle-writer.js';
-import { readBundle, BundleMajorVersionMismatchError, BundleSchemaVersionsMismatchError, BundleImportToStableForbiddenError, BundleMalformedError, } from '../../services/share/bundle-reader.js';
+import { writeBundle, BundleNotShareableError, BundleAssetNotFoundError } from '../../services/share/bundle-writer.js';
+import { readBundle, BundleMajorVersionMismatchError, BundleSchemaVersionsMismatchError, BundleImportToStableForbiddenError, BundleMalformedError } from '../../services/share/bundle-reader.js';
 export function registerBeeCommands(program, io) {
     // Reuse the existing `bee` parent if one is registered; the
     // add-a-new-subcommand-check-for-existing-top-level-first rule.
     const existing = program.commands.find((c) => c.name() === 'bee');
-    const bee = existing ?? program
-        .command('bee')
-        .description('M7: peaks bee export / import (spec §7A.2 / §10 RL-9)');
+    const bee = existing ??
+        program.command('bee').description('M7: peaks bee export / import (spec §7A.2 / §10 RL-9)');
     // ---------- peaks bee export ----------
     addJsonOption(bee
         .command('export')
-        .description("M7: export a bee_release as a peaks.bundle/1 tarball (spec §7A.2). Refuses to export when shareable=false.")
+        .description('M7: export a bee_release as a peaks.bundle/1 tarball (spec §7A.2). Refuses to export when shareable=false.')
         .requiredOption('--bee <id>', 'bee_release numeric id (use `peaks asset status --bee <name>` to find the id)')
         .requiredOption('--out <path>', 'output .tar.gz path')
         .option('--project <path>', 'target project root (defaults to cwd)')).action((options) => {
         const asJson = options.json === true;
         const beeId = Number(options.bee);
         if (!Number.isInteger(beeId) || beeId <= 0) {
-            printResult(io, fail('bee.export', 'INVALID_BEE_ID', `--bee must be a positive integer (got '${options.bee}')`, { bee: options.bee }, [
-                'Re-run with --bee <numeric-id>.',
-            ]), asJson);
+            printResult(io, fail('bee.export', 'INVALID_BEE_ID', `--bee must be a positive integer (got '${options.bee}')`, { bee: options.bee }, ['Re-run with --bee <numeric-id>.']), asJson);
             process.exitCode = 1;
             return;
         }
@@ -64,15 +61,15 @@ export function registerBeeCommands(program, io) {
                     blobsDir: join(projectRoot, '.peaks', 'blobs'),
                     kind: 'bee',
                     id: beeId,
-                    outPath: options.out,
+                    outPath: options.out
                 });
                 printResult(io, ok('bee.export', {
                     outPath: result.outPath,
                     kind: result.kind,
                     assetId: result.assetId,
-                    importedAs: 'candidate',
+                    importedAs: 'candidate'
                 }, [], [
-                    `Receiver must run \`peaks bee import --in ${result.outPath}\` to land this bundle, then run an independent evolution_evaluation before any promote.`,
+                    `Receiver must run \`peaks bee import --in ${result.outPath}\` to land this bundle, then run an independent evolution_evaluation before any promote.`
                 ]), asJson);
             }
             finally {
@@ -82,14 +79,14 @@ export function registerBeeCommands(program, io) {
         catch (error) {
             if (error instanceof BundleNotShareableError) {
                 printResult(io, fail('bee.export', error.code, error.message, { bee: options.bee }, [
-                    'Set shareable=true on the bee_release row, or stop sharing.',
+                    'Set shareable=true on the bee_release row, or stop sharing.'
                 ]), asJson);
                 process.exitCode = 1;
                 return;
             }
             if (error instanceof BundleAssetNotFoundError) {
                 printResult(io, fail('bee.export', error.code, error.message, { bee: options.bee }, [
-                    'Verify the bee id with `peaks asset status --bee <name>`.',
+                    'Verify the bee id with `peaks asset status --bee <name>`.'
                 ]), asJson);
                 process.exitCode = 1;
                 return;
@@ -117,16 +114,16 @@ export function registerBeeCommands(program, io) {
                     db,
                     blobsDir: join(projectRoot, '.peaks', 'blobs'),
                     inPath: options.in,
-                    ...(options.as !== undefined ? { asName: options.as } : {}),
+                    ...(options.as !== undefined ? { asName: options.as } : {})
                 });
                 printResult(io, ok('bee.import', {
                     assetId: result.assetId,
                     kind: result.kind,
                     importedAs: result.importedAs,
                     warnings: result.warnings,
-                    evidenceBriefCount: result.evidenceBriefCount,
+                    evidenceBriefCount: result.evidenceBriefCount
                 }, result.warnings, [
-                    `Run an independent evaluation against this release before promoting; peaks bee promote refuses without an evolution_evaluation row.`,
+                    `Run an independent evaluation against this release before promoting; peaks bee promote refuses without an evolution_evaluation row.`
                 ]), asJson);
             }
             finally {
@@ -136,28 +133,28 @@ export function registerBeeCommands(program, io) {
         catch (error) {
             if (error instanceof BundleMajorVersionMismatchError) {
                 printResult(io, fail('bee.import', error.code, error.message, { receivedMajor: error.receivedMajor }, [
-                    'Use the matching peaks.bundle/<major> reader; this peaks build only supports major=1.',
+                    'Use the matching peaks.bundle/<major> reader; this peaks build only supports major=1.'
                 ]), asJson);
                 process.exitCode = 1;
                 return;
             }
             if (error instanceof BundleSchemaVersionsMismatchError) {
                 printResult(io, fail('bee.import', error.code, error.message, {}, [
-                    'Source bundle did not declare the canonical schema versions; refuse the bundle.',
+                    'Source bundle did not declare the canonical schema versions; refuse the bundle.'
                 ]), asJson);
                 process.exitCode = 1;
                 return;
             }
             if (error instanceof BundleImportToStableForbiddenError) {
                 printResult(io, fail('bee.import', error.code, error.message, {}, [
-                    'Bundles always land as candidate; promotion to stable requires an evolution_evaluation row (AC-26).',
+                    'Bundles always land as candidate; promotion to stable requires an evolution_evaluation row (AC-26).'
                 ]), asJson);
                 process.exitCode = 1;
                 return;
             }
             if (error instanceof BundleMalformedError) {
                 printResult(io, fail('bee.import', error.code, error.message, { inPath: options.in }, [
-                    'Re-export from the source via `peaks bee export`.',
+                    'Re-export from the source via `peaks bee export`.'
                 ]), asJson);
                 process.exitCode = 1;
                 return;

package/dist/cli/commands/best-practice-scan-command.js

@@ -5,41 +5,12 @@ import { fail, ok } from 'peaks-loop-shared/result';
 import { detectLanguage } from '../../services/best-practice/language-detector.js';
 import { scanBestPractice } from '../../services/best-practice/scan-orchestrator.js';
 import { findForbiddenTokens, formatOutputTable } from '../../services/best-practice/output-formatter.js';
-const CATCH_GATE_PROMPT = [
-    '⚠️ 任何跟你真实业务不一样,改 — LLM 推荐可能错。',
-    '回应 (默认 = 接受): 接受 / 接受方案 A|接受方案 B|接受方案 C / 拒绝 + 原因'
-].join('\n');
-const INTENT_REQUIRED_MESSAGE = 'best-practice-scan requires --intent <text>: the intent is the business goal the scan is ' +
-    'for, not the project path. Deriving it from the project path labelled a scan with a ' +
-    'non-goal, so there is no fallback.';
-const SYNTHETIC_SOURCE_MESSAGE = 'best-practice-scan: SKIPPED — the Context7 / WebSearch lookups in this build are stubs ' +
-    '(synthetic fragments), so no real documentation was consulted and there is nothing to ' +
-    'recommend. No recommendation, no comparison table and no ⚠️ catch gate were produced.';
-function bestPracticeDir(projectRoot) {
-    return join(projectRoot, 'best-practice');
-}
+import { bestPracticeDir, CATCH_GATE_PROMPT, INTENT_REQUIRED_MESSAGE, renderSyntheticRefusal, SYNTHETIC_SOURCE_MESSAGE } from './best-practice-scan-helpers.js';
 function artifactPathFor(projectRoot, slugSource) {
     const dateStr = new Date().toISOString().slice(0, 10);
     const slug = slugSource.replace(/[^a-zA-Z0-9_-]+/g, '-').slice(0, 32) || 'intent';
     return join(bestPracticeDir(projectRoot), `${dateStr}-${slug}.md`);
 }
-/** Refusal body for a synthetic scan. It is written to the artifact path so
- *  the skip survives the fire-and-forget caller (`best-practice-auto-trigger`
- *  spawns with `stdio: 'ignore'`, so stdout never reaches anyone). */
-function renderSyntheticRefusal(opts) {
-    return [
-        `# Best-Practice Scan — ${opts.intent}`,
-        '',
-        '> SKIPPED — synthetic (stub) lookup. No real documentation lookup was performed.',
-        '',
-        SYNTHETIC_SOURCE_MESSAGE,
-        '',
-        `- language: ${opts.language}`,
-        `- transport that answered: ${opts.source} (stub)`,
-        '- Step 2.5: recorded as skipped, reason "synthetic-lookup". Re-run this step once the real',
-        '  lookup lands; a gate cannot be satisfied from a fabricated scan.'
-    ].join('\n');
-}
 async function readUserInput() {
     const override = process.env.PEAKS_BEST_PRACTICE_STDIN;
     if (override !== undefined)
@@ -100,9 +71,7 @@ export function registerBestPracticeScanCommand(program, io) {
         try {
             const intent = (opts.intent ?? '').trim();
             if (intent.length === 0) {
-                printResult(io, fail('best-practice.scan', 'BEST_PRACTICE_SCAN_INTENT_REQUIRED', INTENT_REQUIRED_MESSAGE, { project: opts.project }, [
-                    'Rerun with --intent "<business goal>" — the goal from the PRD artifact'
-                ]), opts.json === true);
+                printResult(io, fail('best-practice.scan', 'BEST_PRACTICE_SCAN_INTENT_REQUIRED', INTENT_REQUIRED_MESSAGE, { project: opts.project }, ['Rerun with --intent "<business goal>" — the goal from the PRD artifact']), opts.json === true);
                 process.exitCode = 1;
                 return;
             }
@@ -129,7 +98,10 @@ export function registerBestPracticeScanCommand(program, io) {
                     synthetic: true,
                     step25: 'skipped-synthetic-lookup',
                     artifactPath: refusedPath
-                }, ['Re-run once real Context7 / WebSearch wiring lands', `Skip record written to ${refusedPath}`]), opts.json === true);
+                }, [
+                    'Re-run once real Context7 / WebSearch wiring lands',
+                    `Skip record written to ${refusedPath}`
+                ]), opts.json === true);
                 process.exitCode = 1;
                 return;
             }