peaks-loop 4.0.53 → 4.1.0

package/dist/cli/commands/loop-eval-commands.js

@@ -28,7 +28,8 @@ export function registerWorkflowEvalCommands(program, io) {
     // add-a-new-subcommand-check-for-existing-top-level-first rule).
     const existingWorkflow = program.commands.find((c) => c.name() === 'workflow');
     const existingLoop = program.commands.find((c) => c.name() === 'loop');
-    const workflow = existingWorkflow ?? program.command('workflow').description('Workflow primitive (run / plan / lint)');
+    const workflow = existingWorkflow ??
+        program.command('workflow').description('Workflow primitive (run / plan / lint)');
     const loop = existingLoop ?? program.command('loop').description('Loop primitive (eval)');
     // peaks workflow run <id>
     addJsonOption(workflow
@@ -56,7 +57,9 @@ export function registerWorkflowEvalCommands(program, io) {
                 workflow: { id: resolved.spec.id, label: resolved.spec.label, source: resolved.source },
                 runPlan,
                 lintWarnings: resolved.lint.warnings
-            }, [], [`Run \`peaks workflow plan ${id} --session ${options.session} --json\` to preview the graph.`]), options.json);
+            }, [], [
+                `Run \`peaks workflow plan ${id} --session ${options.session} --json\` to preview the graph.`
+            ]), options.json);
         }
         catch (error) {
             printResult(io, fail('workflow.run', 'WORKFLOW_RUN_FAILED', getErrorMessage(error), { sessionId: options.session }, ['Verify the workflow id and session binding.']), options.json);
@@ -70,7 +73,10 @@ export function registerWorkflowEvalCommands(program, io) {
     // Reuse the existing `graph` parent if `registerWorkflowLifecycleCommand`
     // already created one (it owns `peaks workflow graph show|list`).
     const existingGraph = workflow.commands.find((c) => c.name() === 'graph');
-    const graphParent = existingGraph ?? workflow.command('graph').description('workflow graph read commands (slice A.3 dry-run + slice 4.0.8 lifecycle)');
+    const graphParent = existingGraph ??
+        workflow
+            .command('graph')
+            .description('workflow graph read commands (slice A.3 dry-run + slice 4.0.8 lifecycle)');
     addJsonOption(graphParent
         .description('Slice A.3 dry-run: render the workflow graph (phases + parallel groups + evaluators + budget). No phase is executed.')
         .argument('<id>', 'workflow id')
@@ -94,7 +100,9 @@ export function registerWorkflowEvalCommands(program, io) {
                 sessionId: options.session,
                 graph,
                 lintWarnings: resolved.lint.warnings
-            }, [], [`Run \`peaks workflow run ${id} --session ${options.session} --json\` to materialize the run-plan order.`]), options.json);
+            }, [], [
+                `Run \`peaks workflow run ${id} --session ${options.session} --json\` to materialize the run-plan order.`
+            ]), options.json);
         }
         catch (error) {
             printResult(io, fail('workflow.graph', 'WORKFLOW_GRAPH_FAILED', getErrorMessage(error), { sessionId: options.session }, ['Verify the workflow id and session binding.']), options.json);
@@ -185,7 +193,13 @@ export function registerWorkflowEvalCommands(program, io) {
                     process.exitCode = 1;
                     return;
                 }
-                const score = envelope.degraded ? 0.25 : (envelope.gateAction === 'pass' ? 1.0 : envelope.gateAction === 'warn' ? 0.5 : 0.0);
+                const score = envelope.degraded
+                    ? 0.25
+                    : envelope.gateAction === 'pass'
+                        ? 1.0
+                        : envelope.gateAction === 'warn'
+                            ? 0.5
+                            : 0.0;
                 const dir = join(projectRoot, '.peaks', '_runtime', options.session, 'loop', rid, 'cycles');
                 const n = nextEvalCaptureIndex(projectRoot, options.session, rid);
                 const path = join(dir, `cycle-${n}.json`);
@@ -196,13 +210,15 @@ export function registerWorkflowEvalCommands(program, io) {
                         rid,
                         sid: options.session,
                         persistedAt: new Date().toISOString(),
-                        scores: [{
+                        scores: [
+                            {
                                 evaluator: envelope.kind,
                                 score,
                                 gateAction: envelope.gateAction,
                                 degraded: envelope.degraded,
                                 observedAt: new Date().toISOString()
-                            }]
+                            }
+                        ]
                     }), 'utf8');
                     capture = { score, persistedAt: path };
                 }
@@ -221,9 +237,15 @@ export function registerWorkflowEvalCommands(program, io) {
                 degraded: envelope.degraded,
                 ...(capture !== null ? { score: capture.score, capture } : {})
             }, [], envelope.degraded
-                ? ['Evaluator ran in degraded mode (peaks CLI unavailable). Verify the verdict by running `peaks verdict aggregate --from-rid ' + rid + '`.',
-                    'Re-run on a fully-installed peaks-loop environment for a real verdict.']
-                : [`Verifier verdict-aggregate can consume this envelope via \`peaks verdict aggregate --from-rid ${rid}\`.`]), options.json);
+                ? [
+                    'Evaluator ran in degraded mode (peaks CLI unavailable). Verify the verdict by running `peaks verdict aggregate --from-rid ' +
+                        rid +
+                        '`.',
+                    'Re-run on a fully-installed peaks-loop environment for a real verdict.'
+                ]
+                : [
+                    `Verifier verdict-aggregate can consume this envelope via \`peaks verdict aggregate --from-rid ${rid}\`.`
+                ]), options.json);
             process.exitCode = exitCode;
         }
         catch (error) {
@@ -243,10 +265,15 @@ export function registerWorkflowEvalCommands(program, io) {
         .option('--threshold <threshold>', `maximum allowed score regression on the 0..1 scale (default: ${DEFAULT_MONOTONIC_THRESHOLD} = 5%)`)
         .option('--no-persist', 'skip persisting the current cycle score rows to disk')).action((rid, options) => {
         try {
-            const { projectRoot, sid } = resolveMonotonicContext({ ...(options.project !== undefined ? { project: options.project } : {}), session: options.session, rid });
+            const { projectRoot, sid } = resolveMonotonicContext({
+                ...(options.project !== undefined ? { project: options.project } : {}),
+                session: options.session,
+                rid
+            });
             const persist = options.persist !== false;
             const thresholdNum = options.threshold !== undefined ? Number(options.threshold) : DEFAULT_MONOTONIC_THRESHOLD;
-            if (options.threshold !== undefined && (!Number.isFinite(thresholdNum) || thresholdNum < 0 || thresholdNum > 1)) {
+            if (options.threshold !== undefined &&
+                (!Number.isFinite(thresholdNum) || thresholdNum < 0 || thresholdNum > 1)) {
                 printResult(io, fail('loop.check-monotonic', 'INVALID_THRESHOLD', `threshold must be a finite number in [0,1] (got "${options.threshold}")`, { rid }, [`Pass --threshold ${DEFAULT_MONOTONIC_THRESHOLD} (default) or any number in [0,1].`]), options.json);
                 process.exitCode = 1;
                 return;
@@ -274,10 +301,19 @@ export function registerWorkflowEvalCommands(program, io) {
                 regressions: result.report.regressions,
                 reason: result.report.reason
             }, [], result.report.monotonicityViolation
-                ? ['Investigate which evaluator regressed most and the previous cycle threshold.', `Inspect ${result.persistedAt ?? 'the persisted cycle row at .peaks/_runtime/<sid>/loop/<rid>/cycle-N.json'}.`]
-                : (result.report.status === 'skip'
-                    ? ['Cycle is the first run or incomparable; monotonicity guard is a no-op.', 'A future cycle will surface a violation if any evaluator regresses.']
-                    : ['All evaluators held or improved.', `Verifier verdict-aggregate can consume this envelope via \`peaks verdict aggregate --from-rid ${rid}\`.`])), options.json);
+                ? [
+                    'Investigate which evaluator regressed most and the previous cycle threshold.',
+                    `Inspect ${result.persistedAt ?? 'the persisted cycle row at .peaks/_runtime/<sid>/loop/<rid>/cycle-N.json'}.`
+                ]
+                : result.report.status === 'skip'
+                    ? [
+                        'Cycle is the first run or incomparable; monotonicity guard is a no-op.',
+                        'A future cycle will surface a violation if any evaluator regresses.'
+                    ]
+                    : [
+                        'All evaluators held or improved.',
+                        `Verifier verdict-aggregate can consume this envelope via \`peaks verdict aggregate --from-rid ${rid}\`.`
+                    ]), options.json);
             process.exitCode = exitCode;
         }
         catch (error) {
@@ -289,7 +325,8 @@ export function registerWorkflowEvalCommands(program, io) {
     // project-level `.peaks/_runtime/<sid>/loop/<rid>/spec.yaml`. When
     // `--bootstrap` is set, a default spec is written; otherwise the
     // existing spec is read (or `{kind:'missing'}` is returned).
-    const spec = loop.command('spec')
+    const spec = loop
+        .command('spec')
         .description('Slice E.2: read or bootstrap the spec for a rid. Defaults to read; pass --bootstrap to write a default spec.');
     addJsonOption(spec
         .command('show')
@@ -322,7 +359,9 @@ export function registerWorkflowEvalCommands(program, io) {
                 process.exitCode = 1;
         }
         catch (error) {
-            printResult(io, fail('loop.spec.show', 'LOOP_SPEC_SHOW_FAILED', getErrorMessage(error), { rid }, ['Verify the rid and session binding.']), options.json);
+            printResult(io, fail('loop.spec.show', 'LOOP_SPEC_SHOW_FAILED', getErrorMessage(error), { rid }, [
+                'Verify the rid and session binding.'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -348,9 +387,16 @@ export function registerWorkflowEvalCommands(program, io) {
                 return;
             }
             const strategyRaw = options.strategy;
-            const strategy = (strategyRaw === 'max-cycles' || strategyRaw === MONOTONIC_TERMINATION || strategyRaw === 'manual') ? strategyRaw : MONOTONIC_TERMINATION;
+            const strategy = strategyRaw === 'max-cycles' ||
+                strategyRaw === MONOTONIC_TERMINATION ||
+                strategyRaw === 'manual'
+                ? strategyRaw
+                : MONOTONIC_TERMINATION;
             const termination = strategy === 'max-cycles'
-                ? { strategy, maxCycles: Math.max(1, Math.floor(Number(options.maxCycles) || DEFAULT_MAX_CYCLES)) }
+                ? {
+                    strategy,
+                    maxCycles: Math.max(1, Math.floor(Number(options.maxCycles) || DEFAULT_MAX_CYCLES))
+                }
                 : { strategy };
             const evaluators = [
                 { kind: 'karpathy', gate: 'Gate B3', scope: 'src/' },
@@ -407,13 +453,19 @@ export function registerWorkflowEvalCommands(program, io) {
             printResult(io, ok('loop.spec.lint', {
                 file,
                 spec: result.spec,
-                lint: { ok: result.report.ok, errors: result.report.errors, warnings: result.report.warnings }
+                lint: {
+                    ok: result.report.ok,
+                    errors: result.report.errors,
+                    warnings: result.report.warnings
+                }
             }, [], []), options.json);
             if (!result.report.ok)
                 process.exitCode = 1;
         }
         catch (error) {
-            printResult(io, fail('loop.spec.lint', 'LOOP_SPEC_LINT_FAILED', getErrorMessage(error), { file }, ['Verify the file path and rid flag.']), options.json);
+            printResult(io, fail('loop.spec.lint', 'LOOP_SPEC_LINT_FAILED', getErrorMessage(error), { file }, [
+                'Verify the file path and rid flag.'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -431,14 +483,21 @@ export function registerWorkflowEvalCommands(program, io) {
         .option('--threshold <t>', 'monotonic threshold (0..1); default 0.05')
         .option('--no-persist', 'skip writing cycle-N.json + summary to disk')).action((rid, options) => {
         try {
-            const { projectRoot, sid, rid: r2 } = resolveRunContext({ ...(options.project !== undefined ? { project: options.project } : {}), session: options.session, rid });
+            const { projectRoot, sid, rid: r2 } = resolveRunContext({
+                ...(options.project !== undefined ? { project: options.project } : {}),
+                session: options.session,
+                rid
+            });
             const threshold = options.threshold !== undefined ? Number(options.threshold) : undefined;
-            if (threshold !== undefined && (!Number.isFinite(threshold) || threshold < 0 || threshold > 1)) {
+            if (threshold !== undefined &&
+                (!Number.isFinite(threshold) || threshold < 0 || threshold > 1)) {
                 printResult(io, fail('loop.run', 'INVALID_THRESHOLD', `threshold must be finite in [0,1] (got "${options.threshold}")`, { rid: r2 }, [`Pass --threshold 0.05 (default) or any number in [0,1].`]), options.json);
                 process.exitCode = 1;
                 return;
             }
-            const maxCycles = options.maxCycles !== undefined ? Math.max(1, Math.floor(Number(options.maxCycles) || DEFAULT_MAX_CYCLES)) : undefined;
+            const maxCycles = options.maxCycles !== undefined
+                ? Math.max(1, Math.floor(Number(options.maxCycles) || DEFAULT_MAX_CYCLES))
+                : undefined;
             const strategyOverride = options.strategy;
             const result = runLoop({
                 projectRoot,
@@ -469,7 +528,9 @@ export function registerWorkflowEvalCommands(program, io) {
                     finalReportCode,
                     summary: result.summary
                 }, [], result.code === 'RUN_OK'
-                    ? [`Loop completed ${result.summary.totalCycles} cycle(s) with ${result.summary.regressionCount} regression(s).`]
+                    ? [
+                        `Loop completed ${result.summary.totalCycles} cycle(s) with ${result.summary.regressionCount} regression(s).`
+                    ]
                     : [`Run driver exited with ${result.code}: ${result.message}`])
                 : fail('loop.run', result.code, result.message, {
                     rid: r2,
@@ -486,7 +547,9 @@ export function registerWorkflowEvalCommands(program, io) {
             process.exitCode = exitCode;
         }
         catch (error) {
-            printResult(io, fail('loop.run', 'RUN_FAILED', getErrorMessage(error), { rid }, ['Verify the rid and session binding.']), options.json);
+            printResult(io, fail('loop.run', 'RUN_FAILED', getErrorMessage(error), { rid }, [
+                'Verify the rid and session binding.'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -542,10 +605,16 @@ function nextActionsForCode(code, rid, sid, summary) {
         case 'SPEC_INVALID':
             return [`Re-run \`peaks loop spec lint <path>\` to see the schema errors.`];
         case 'UNKNOWN_TERMINATION_STRATEGY':
-            return [`Edit the spec.yaml and set termination.strategy to one of: ${MONOTONIC_TERMINATION}, max-cycles, manual.`];
+            return [
+                `Edit the spec.yaml and set termination.strategy to one of: ${MONOTONIC_TERMINATION}, max-cycles, manual.`
+            ];
         case 'MONOTONICITY_VIOLATION':
             return [
-                'Inspect the regression rows in the cycles output and the previous cycle row at .peaks/_runtime/' + sid + '/loop/' + rid + '/cycles/.',
+                'Inspect the regression rows in the cycles output and the previous cycle row at .peaks/_runtime/' +
+                    sid +
+                    '/loop/' +
+                    rid +
+                    '/cycles/.',
                 'Fix the regression in the next iteration and re-run.'
             ];
         case 'LOCKED':
@@ -553,7 +622,9 @@ function nextActionsForCode(code, rid, sid, summary) {
         case 'RUN_OK_REGRESSION':
             return ['A regression was observed; the run captured it for operator review.'];
         case 'RUN_OK':
-            return [`Loop completed ${summary.totalCycles} cycle(s); ${summary.regressionCount} regression(s).`];
+            return [
+                `Loop completed ${summary.totalCycles} cycle(s); ${summary.regressionCount} regression(s).`
+            ];
         default:
             return ['Inspect the run-driver output above.'];
     }

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

@@ -31,7 +31,7 @@ export function buildMemoryReindexSummary(report) {
         orphanIndex: boundedNames(report.orphanIndex.map((o) => o.name)),
         orphanDisk: boundedNames(report.orphanDisk.map((p) => p.split(/[\\/]/).pop() ?? p)),
         memoryMd: report.memoryMd,
-        writtenFiles: boundedNames(report.writtenFiles.map((p) => p.split(/[\\/]/).pop() ?? p)),
+        writtenFiles: boundedNames(report.writtenFiles.map((p) => p.split(/[\\/]/).pop() ?? p))
     };
     return fitSummaryToBytes(view);
 }
@@ -48,7 +48,7 @@ export function buildMemoryListSummary(data) {
         updatedAt: data.snapshot.updatedAt,
         total: data.entries.length,
         kindFilter: data.kindFilter ?? null,
-        entries: boundedNames(data.entries.map(label)),
+        entries: boundedNames(data.entries.map(label))
     };
     if (data.pickedOutputPath !== null) {
         view.picked = boundedNames(data.pickedEntries.map(label));
@@ -121,7 +121,7 @@ export async function runMemoryList(io, options) {
                 kindFilter,
                 pickedEntries,
                 pickedOutputPath,
-                fzfVersion,
+                fzfVersion
             })
             : {
                 indexPath: snapshot.indexPath,
@@ -130,7 +130,9 @@ export async function runMemoryList(io, options) {
                 total: entries.length,
                 kindFilter: kindFilter ?? null,
                 entries,
-                ...(options.pick === true ? { picked: pickedEntries, pickedOutputPath, fzfVersion } : {})
+                ...(options.pick === true
+                    ? { picked: pickedEntries, pickedOutputPath, fzfVersion }
+                    : {})
             };
         printResult(io, ok('memory.list', data, warnings, nextActions), options.json);
     }
@@ -161,13 +163,13 @@ export async function runMemorySearch(io, options) {
             query: options.query,
             projectRoot,
             ...(options.limit !== undefined ? { limit: options.limit } : {}),
-            ...(kindFilter !== undefined ? { kind: kindFilter } : {}),
+            ...(kindFilter !== undefined ? { kind: kindFilter } : {})
         });
         printResult(io, ok('memory.search', {
             query: options.query,
             total: matches.length,
             matches,
-            warnings: [],
+            warnings: []
         }, []), options.json);
     }
     catch (error) {
@@ -213,15 +215,15 @@ export async function runMemoryReindex(io, options) {
         // Slice B: `--summary` keeps the scalar drift counts + names-of-first-N;
         // the full report (with every unclassified/orphan path) stays available
         // by omitting the flag. Default shape is unchanged.
-        const data = options.summary === true
-            ? buildMemoryReindexSummary(report)
-            : report;
+        const data = options.summary === true ? buildMemoryReindexSummary(report) : report;
         printResult(io, ok('memory.reindex', data, [], nextActions), options.json);
     }
     catch (error) {
         const message = getErrorMessage(error);
         const code = error.code ?? 'MEMORY_REINDEX_FAILED';
-        printResult(io, fail('memory.reindex', code, message, { projectRoot }, ['Check that the project has a readable .peaks/memory directory']), options.json);
+        printResult(io, fail('memory.reindex', code, message, { projectRoot }, [
+            'Check that the project has a readable .peaks/memory directory'
+        ]), options.json);
         process.exitCode = 1;
     }
 }
@@ -233,7 +235,9 @@ export async function runMemoryReindex(io, options) {
 export async function runMemoryRotate(io, options) {
     const projectRoot = resolveMemoryProjectRoot(options.project);
     if (options.dryRun === true && options.apply === true) {
-        printResult(io, fail('memory.rotate', 'INVALID_MEMORY_ROTATE_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview the rotation plan, or pass --apply to archive tier-C candidates']), options.json);
+        printResult(io, fail('memory.rotate', 'INVALID_MEMORY_ROTATE_FLAGS', 'Use either --dry-run or --apply, not both', {}, [
+            'Run without --apply to preview the rotation plan, or pass --apply to archive tier-C candidates'
+        ]), options.json);
         process.exitCode = 1;
         return;
     }
@@ -260,7 +264,9 @@ export async function runMemoryRotate(io, options) {
     catch (error) {
         const message = getErrorMessage(error);
         const code = error.code ?? 'MEMORY_ROTATE_FAILED';
-        printResult(io, fail('memory.rotate', code, message, { projectRoot }, ['Check that the project has a readable .peaks/memory directory']), options.json);
+        printResult(io, fail('memory.rotate', code, message, { projectRoot }, [
+            'Check that the project has a readable .peaks/memory directory'
+        ]), options.json);
         process.exitCode = 1;
     }
 }
@@ -296,7 +302,9 @@ export async function runMemoryIngest(io, options) {
     catch (error) {
         const message = getErrorMessage(error);
         const code = error.code ?? 'MEMORY_INGEST_FAILED';
-        printResult(io, fail('memory.ingest', code, message, { projectRoot }, ['Check the --source-dir path and that .peaks/memory is writable']), options.json);
+        printResult(io, fail('memory.ingest', code, message, { projectRoot }, [
+            'Check the --source-dir path and that .peaks/memory is writable'
+        ]), options.json);
         process.exitCode = 1;
     }
 }

package/dist/cli/commands/migrate-1-4-1-command.js

@@ -17,7 +17,7 @@ export function registerMigrate1_4_1Command(workspace, io) {
         'Default: dry-run. Pass --apply to actually `rename` the files and remove emptied legacy dirs. ' +
         'Reads each file once, computes sha256, compares to canonical. Identical-content duplicates are removed from legacy. Content-mismatch files are reported and NOT deleted (manual review).')
         .requiredOption('--project <path>', 'target project root')
-        .option('--apply', 'actually rename the files and remove empty legacy dirs (destructive); without it, dry-run only', false)).action(async (options) => {
+        .option('--apply', 'actually rename the files and remove empty legacy dirs (destructive); without it, dry-run only', false)).action((options) => {
         try {
             const projectRoot = resolveCanonicalProjectRoot(options.project);
             const apply = options.apply === true;

package/dist/cli/commands/migrate-v2-10-to-v2-11-command.js

@@ -22,14 +22,14 @@ import { ok, fail } from 'peaks-loop-shared/result';
 export function registerMigrateV2ToV11Command(workspace, io) {
     addJsonOption(workspace
         .command('migrate-v2-10-to-v2-11')
-        .description('v2.11.0 Group E (Tier 8): prepend a YAML deprecation banner to every pre-v2.11.0 session\'s ' +
+        .description("v2.11.0 Group E (Tier 8): prepend a YAML deprecation banner to every pre-v2.11.0 session's " +
         '`rd/tech-doc.md` file. Marks them `deprecated: historical` and points to the new peaks-prd ' +
         'handoff as the source of truth. Text-only — no file moves. Default: dry-run; pass `--apply` ' +
         'to actually write. Idempotent: re-running on an already-migrated tree is a no-op. Different ' +
         'migration family from the legacy 0.5 to 1.4.1 runtime-layout helper — this command does NOT ' +
         'move files, only prepends the banner.')
         .requiredOption('--project <path>', 'target project root')
-        .option('--apply', 'actually prepend the deprecation banner to each `rd/tech-doc.md` (idempotent); without it, dry-run only', false)).action(async (options) => {
+        .option('--apply', 'actually prepend the deprecation banner to each `rd/tech-doc.md` (idempotent); without it, dry-run only', false)).action((options) => {
         try {
             const projectRoot = resolveCanonicalProjectRoot(options.project);
             const apply = options.apply === true;

package/dist/cli/commands/mut-commands-helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `peaks mut` — pure helper module extracted from `mut-commands.ts`
+ * (file-size cap campaign). Mechanical move only: the stub-report
+ * factories and the summary emitter keep their original behavior.
+ */
+import { type AssertionsReport, type MutationReport } from 'peaks-loop-mut';
+/**
+ * Pure helper: a stub AssertionsReport used when only Stryker ran.
+ * The mutants-only path does NOT touch the AST scanner; we still need
+ * a structurally-valid `assertions` block so the Zod schema accepts
+ * the assembled report.
+ */
+export declare function emptyAssertions(): AssertionsReport;
+/**
+ * Pure helper: a stub MutationReport used when only the assertion
+ * scan ran. Mirrors the asserts-only path's invariants (killRate = 0,
+ * mutantsTotal = 0, tool = 'stryker' for forward compatibility).
+ */
+export declare function emptyMutation(): MutationReport;
+/**
+ * Emit a one-line JSON envelope describing the run's outcome. Used by
+ * both `--json` and the human-readable branches so the `passed` /
+ * `sha256` shape stays consistent regardless of TTY mode.
+ */
+export declare function emitSummary(json: boolean, payload: {
+    ok: true;
+    sha256: string;
+    passed: boolean;
+    path: string;
+}): void;

package/dist/cli/commands/mut-commands-helpers.js

@@ -0,0 +1,43 @@
+/**
+ * Pure helper: a stub AssertionsReport used when only Stryker ran.
+ * The mutants-only path does NOT touch the AST scanner; we still need
+ * a structurally-valid `assertions` block so the Zod schema accepts
+ * the assembled report.
+ */
+export function emptyAssertions() {
+    return {
+        totalAssertions: 0,
+        weakAssertions: 0,
+        weakRate: 0,
+        weakPatterns: []
+    };
+}
+/**
+ * Pure helper: a stub MutationReport used when only the assertion
+ * scan ran. Mirrors the asserts-only path's invariants (killRate = 0,
+ * mutantsTotal = 0, tool = 'stryker' for forward compatibility).
+ */
+export function emptyMutation() {
+    return {
+        tool: 'stryker',
+        mutantsTotal: 0,
+        mutantsKilled: 0,
+        mutantsSurvived: 0,
+        mutantsTimeout: 0,
+        killRate: 0,
+        byFile: []
+    };
+}
+/**
+ * Emit a one-line JSON envelope describing the run's outcome. Used by
+ * both `--json` and the human-readable branches so the `passed` /
+ * `sha256` shape stays consistent regardless of TTY mode.
+ */
+export function emitSummary(json, payload) {
+    if (json) {
+        process.stdout.write(JSON.stringify(payload) + '\n');
+    }
+    else {
+        process.stdout.write(`mut-report.json: ${payload.path}\nsha256: ${payload.sha256}\npassed: ${payload.passed}\n`);
+    }
+}

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

@@ -15,50 +15,8 @@
  */
 import { readFile } from 'node:fs/promises';
 import { Command } from 'commander';
-import { scanAssertions, runMutation, buildMutReport, createProductionStrykerInvoker, MutReportSchema, } from 'peaks-loop-mut';
-/**
- * Pure helper: a stub AssertionsReport used when only Stryker ran.
- * The mutants-only path does NOT touch the AST scanner; we still need
- * a structurally-valid `assertions` block so the Zod schema accepts
- * the assembled report.
- */
-function emptyAssertions() {
-    return {
-        totalAssertions: 0,
-        weakAssertions: 0,
-        weakRate: 0,
-        weakPatterns: [],
-    };
-}
-/**
- * Pure helper: a stub MutationReport used when only the assertion
- * scan ran. Mirrors the asserts-only path's invariants (killRate = 0,
- * mutantsTotal = 0, tool = 'stryker' for forward compatibility).
- */
-function emptyMutation() {
-    return {
-        tool: 'stryker',
-        mutantsTotal: 0,
-        mutantsKilled: 0,
-        mutantsSurvived: 0,
-        mutantsTimeout: 0,
-        killRate: 0,
-        byFile: [],
-    };
-}
-/**
- * Emit a one-line JSON envelope describing the run's outcome. Used by
- * both `--json` and the human-readable branches so the `passed` /
- * `sha256` shape stays consistent regardless of TTY mode.
- */
-function emitSummary(json, payload) {
-    if (json) {
-        process.stdout.write(JSON.stringify(payload) + '\n');
-    }
-    else {
-        process.stdout.write(`mut-report.json: ${payload.path}\nsha256: ${payload.sha256}\npassed: ${payload.passed}\n`);
-    }
-}
+import { scanAssertions, runMutation, buildMutReport, createProductionStrykerInvoker, MutReportSchema } from 'peaks-loop-mut';
+import { emitSummary, emptyAssertions, emptyMutation } from './mut-commands-helpers.js';
 /**
  * Construct the `peaks mut` family as a standalone Commander command.
  * Returns the parent `mut` Command so callers can attach it under any
@@ -80,23 +38,23 @@ export function createMutCommands(opts) {
         const { mutation } = await runMutation({
             project: a.project,
             testFiles: a.testFiles,
-            invokeStryker: opts.invokeStryker,
+            invokeStryker: opts.invokeStryker
         });
         const assertions = await scanAssertions({
             project: a.project,
-            testFiles: a.testFiles,
+            testFiles: a.testFiles
         });
         const report = await buildMutReport({
             inputSig: a.inputSig,
             out: a.out,
             mutation,
-            assertions,
+            assertions
         });
         emitSummary(a.json, {
             ok: true,
             sha256: report.sha256,
             passed: report.thresholds.passed,
-            path: a.out,
+            path: a.out
         });
         if (!report.thresholds.passed) {
             // H6: CLI裁决 — threshold breach is a non-zero exit so callers
@@ -118,19 +76,19 @@ export function createMutCommands(opts) {
         const { mutation } = await runMutation({
             project: a.project,
             testFiles: a.testFiles,
-            invokeStryker: opts.invokeStryker,
+            invokeStryker: opts.invokeStryker
         });
         const report = await buildMutReport({
             inputSig: a.inputSig,
             out: a.out,
             mutation,
-            assertions: emptyAssertions(),
+            assertions: emptyAssertions()
         });
         emitSummary(a.json, {
             ok: true,
             sha256: report.sha256,
             passed: report.thresholds.passed,
-            path: a.out,
+            path: a.out
         });
         if (!report.thresholds.passed) {
             process.exitCode = 1;
@@ -148,19 +106,19 @@ export function createMutCommands(opts) {
         .action(async (a) => {
         const assertions = await scanAssertions({
             project: a.project,
-            testFiles: a.testFiles,
+            testFiles: a.testFiles
         });
         const report = await buildMutReport({
             inputSig: a.inputSig,
             out: a.out,
             mutation: emptyMutation(),
-            assertions,
+            assertions
         });
         emitSummary(a.json, {
             ok: true,
             sha256: report.sha256,
             passed: report.thresholds.passed,
-            path: a.out,
+            path: a.out
         });
         if (!report.thresholds.passed) {
             process.exitCode = 1;
@@ -193,17 +151,17 @@ export function createMutCommands(opts) {
         const summary = {
             mutation: {
                 tool: r.mutation.tool,
-                killRate: r.mutation.killRate,
+                killRate: r.mutation.killRate
             },
             assertions: {
                 total: r.assertions.totalAssertions,
                 weak: r.assertions.weakAssertions,
-                weakRate: r.assertions.weakRate,
+                weakRate: r.assertions.weakRate
             },
             thresholds: { passed: r.thresholds.passed },
             followups: r.followups.length,
             sha256: r.sha256,
-            sessionId: a.sessionId,
+            sessionId: a.sessionId
         };
         if (a.json) {
             process.stdout.write(JSON.stringify(summary) + '\n');
@@ -214,7 +172,7 @@ export function createMutCommands(opts) {
                 `assertions: total=${r.assertions.totalAssertions} weak=${r.assertions.weakAssertions} rate=${(r.assertions.weakRate * 100).toFixed(1)}%`,
                 `thresholds: passed=${r.thresholds.passed}`,
                 `followups: ${r.followups.length}`,
-                `sha256: ${r.sha256}`,
+                `sha256: ${r.sha256}`
             ].join('\n') + '\n');
         }
         if (!r.thresholds.passed) {