peaks-loop 4.0.53 → 4.1.0

package/dist/cli/commands/lease-metrics-commands.js

@@ -17,28 +17,26 @@
  * on `category === 'lease'`; the schema is the same as every other
  * observability event (Part 4.A reused the existing schema v1).
  */
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { join } from 'node:path';
 import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 import { findProjectRoot } from '../../services/config/config-safety.js';
 import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
 import { readObservabilityEvents } from '../../services/observability/observability-service.js';
-const EMPTY_COUNTS = {
-    spawn: 0,
-    renew: 0,
-    release: 0,
-    gc: 0,
-    autoRelease: 0,
-    'autoRelease-failed': 0,
-    'autoRelease-skipped': 0
-};
+// Slice `b1-filesplit-campaign` (wave 3B): the options/kind/rate type layer,
+// the EMPTY_COUNTS seed and the multi-session reader
+// (`readAllSessionLeaseEvents`) moved VERBATIM to
+// `./lease-metrics-commands-support.ts` so this file clears the 300 raw-line
+// cap. `aggregateLeaseEvents` / `recomputeRate` stayed (they carry findings, and
+// a new module must be clean outright). The two public names are re-exported
+// from this path, so `./lease-stats-commands.ts` imports unchanged.
+import { EMPTY_COUNTS, readAllSessionLeaseEvents } from './lease-metrics-commands-support.js';
+export { readAllSessionLeaseEvents };
 /** Compute per-kind counts + chronological tail from a list of events. */
 function aggregateLeaseEvents(leaseEvents) {
     const counts = { ...EMPTY_COUNTS };
     const recent = [];
     for (const ev of leaseEvents) {
-        const detail = (ev.detail ?? {});
+        const detail = ev.detail ?? {};
         const kind = typeof detail['kind'] === 'string' ? detail['kind'] : 'unknown';
         const leaseId = typeof detail['leaseId'] === 'string' ? detail['leaseId'] : '';
         const rid = typeof detail['rid'] === 'string' ? detail['rid'] : null;
@@ -55,7 +53,7 @@ export function recomputeRate(leaseEvents) {
     // Count per-kind in one pass.
     const counts = { ...EMPTY_COUNTS };
     for (const ev of leaseEvents) {
-        const detail = (ev.detail ?? {});
+        const detail = ev.detail ?? {};
         const kind = typeof detail['kind'] === 'string' ? detail['kind'] : 'unknown';
         if (kind in counts) {
             counts[kind] = (counts[kind] ?? 0) + 1;
@@ -70,11 +68,11 @@ export function recomputeRate(leaseEvents) {
     const firstTerminal = new Map();
     const tsOf = (ev) => Date.parse(ev.ts);
     const leaseIdOf = (ev) => {
-        const d = (ev.detail ?? {});
+        const d = ev.detail ?? {};
         return typeof d['leaseId'] === 'string' ? d['leaseId'] : '';
     };
     const kindOf = (ev) => {
-        const d = (ev.detail ?? {});
+        const d = ev.detail ?? {};
         return typeof d['kind'] === 'string' ? d['kind'] : 'unknown';
     };
     for (const ev of leaseEvents) {
@@ -101,10 +99,12 @@ export function recomputeRate(leaseEvents) {
             lifetimes.push(dt);
     }
     lifetimes.sort((a, b) => a - b);
-    const avg = lifetimes.length === 0 ? null : Math.round(lifetimes.reduce((s, v) => s + v, 0) / lifetimes.length);
+    const avg = lifetimes.length === 0
+        ? null
+        : Math.round(lifetimes.reduce((s, v) => s + v, 0) / lifetimes.length);
     const p99 = lifetimes.length === 0
         ? null
-        : lifetimes[Math.min(lifetimes.length - 1, Math.floor(lifetimes.length * 0.99))] ?? null;
+        : (lifetimes[Math.min(lifetimes.length - 1, Math.floor(lifetimes.length * 0.99))] ?? null);
     return {
         totalSpawn,
         totalTerminal: totalRelease,
@@ -115,49 +115,6 @@ export function recomputeRate(leaseEvents) {
         p99LifetimeMs: p99
     };
 }
-/**
- * Part 5: enumerate every session under `.peaks/_runtime/` for a
- * project root and aggregate their lease events. Sessions without
- * a `metrics/slices.jsonl` are skipped silently (a clean project
- * has no lease events to report; that's not an error).
- */
-export function readAllSessionLeaseEvents(projectRoot) {
-    const runtimeDir = join(projectRoot, '.peaks', '_runtime');
-    if (!existsSync(runtimeDir))
-        return { sessions: [], missingSessions: 0 };
-    let entries;
-    try {
-        entries = readdirSync(runtimeDir);
-    }
-    catch {
-        return { sessions: [], missingSessions: 0 };
-    }
-    const sessions = [];
-    let missing = 0;
-    for (const sid of entries) {
-        const sessionDir = join(runtimeDir, sid);
-        try {
-            if (!statSync(sessionDir).isDirectory())
-                continue;
-        }
-        catch {
-            continue;
-        }
-        try {
-            const all = readObservabilityEvents(projectRoot, sid);
-            const leaseEvents = all.filter((e) => e.category === 'lease');
-            if (leaseEvents.length === 0) {
-                missing++;
-                continue;
-            }
-            sessions.push({ sessionId: sid, events: leaseEvents });
-        }
-        catch {
-            missing++;
-        }
-    }
-    return { sessions, missingSessions: missing };
-}
 export function registerLeaseMetricsCommand(parent, io) {
     addJsonOption(parent
         .command('lease-metrics')
@@ -197,7 +154,10 @@ export function registerLeaseMetricsCommand(parent, io) {
                 return;
             }
             // Single-session path (the Part 4.A default).
-            const sessionId = options.session ?? process.env.PEAKS_SESSION_ID ?? getCurrentSessionId(projectRoot) ?? 'unknown-sid';
+            const sessionId = options.session ??
+                process.env.PEAKS_SESSION_ID ??
+                getCurrentSessionId(projectRoot) ??
+                'unknown-sid';
             const allEvents = readObservabilityEvents(projectRoot, sessionId);
             const leaseEvents = allEvents.filter((e) => e.category === 'lease');
             const { counts, tail } = aggregateLeaseEvents(leaseEvents);

package/dist/cli/commands/lease-stats-commands.d.ts

@@ -30,7 +30,7 @@
  * `lease-metrics --all-sessions` is the input, `lease-stats`
  * is the answer.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 import { type RateStats } from './lease-metrics-commands.js';
 type RidCount = {

package/dist/cli/commands/lease-stats-commands.js

@@ -74,7 +74,10 @@ export function computeLeaseStats(args) {
             .map(([role, count]) => ({ role, count }))
             .sort((a, b) => b.count - a.count),
         perIsolation: Array.from(isoTally.entries())
-            .map(([isolation, count]) => ({ isolation: isolation, count }))
+            .map(([isolation, count]) => ({
+            isolation: isolation,
+            count
+        }))
             .sort((a, b) => b.count - a.count)
     };
 }
@@ -88,19 +91,19 @@ export function registerLeaseStatsCommand(parent, io) {
             const { sessions } = readAllSessionLeaseEvents(projectRoot);
             const eventsBySession = sessions.map((s) => ({
                 sessionId: s.sessionId,
-                events: s.events.map((e) => ({ detail: (e.detail ?? {}) }))
+                events: s.events.map((e) => ({ detail: e.detail ?? {} }))
             }));
             const stats = computeLeaseStats({ projectRoot, eventsBySession });
             printResult(io, ok('lease.stats', stats, [], [
                 `${stats.totalLeaseEvents} lease events across ${stats.sessionCount} session(s); ${stats.rate.estimatedActive} estimated active, ${stats.rate.estimatedLeaked} estimated leaked.`,
-                stats.perRid.length > 0 ? `Top rid: ${stats.perRid[0]?.rid} (${stats.perRid[0]?.count} events).` : '',
+                stats.perRid.length > 0
+                    ? `Top rid: ${stats.perRid[0]?.rid} (${stats.perRid[0]?.count} events).`
+                    : '',
                 'Pipe to `jq` or paste into a dashboard for visual rendering.'
             ].filter(Boolean)), options.json);
         }
         catch (err) {
-            printResult(io, fail('lease.stats', 'STATS_READ_FAILED', err instanceof Error ? err.message : String(err), { projectRoot: options.project }, [
-                'Verify the project root is correct.'
-            ]), options.json);
+            printResult(io, fail('lease.stats', 'STATS_READ_FAILED', err instanceof Error ? err.message : String(err), { projectRoot: options.project }, ['Verify the project root is correct.']), options.json);
             process.exitCode = 1;
         }
     });

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

@@ -5,9 +5,15 @@
  * incremental-first / no-touch-stockcode options to the CLI surface.
  *
  *   - `peaks lint baseline` — one-shot full-repo scan; writes
- *     `.peaks/lint/baseline.json` (project-level, gitignored by
- *     default). Each project regenerates its own baseline; the file
- *     is project-aware (D6 binding).
+ *     `.peaks/lint/baseline.json`. Each project regenerates its own
+ *     baseline (the file is project-aware, D6 binding). Whether that
+ *     file is committed is the project's choice, and this repository
+ *     commits it — `git ls-files` matches it here and `git check-ignore`
+ *     reports it is NOT ignored (measured on this checkout). It is
+ *     tracked deliberately, as the reference fixture the `baseline`
+ *     subcommand's own nextAction describes. `file` keys are written
+ *     repo-relative (`repoRelativeKey`), so a committed baseline stays
+ *     valid on a different checkout — an absolute key would not.
  *   - `peaks lint check` — default; diffOnly=true + baselineFile
  *     waiver + redLineMode='baseline-aware'. This is the LLM-facing
  *     Gate B5 entry point.

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

@@ -2,8 +2,10 @@ import { mkdirSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
+import { CLI_VERSION } from 'peaks-loop-shared/version';
+import { repoRelativeKey } from '../../shared/path-utils.js';
 import { detectEslint } from '../../services/lint/detect-eslint.js';
-import { runEslint } from '../../services/lint/eslint-runner.js';
+import { resolveProjectRoot, runEslint } from '../../services/lint/eslint-runner.js';
 function parseTimeoutMs(value) {
     if (value === undefined)
         return undefined;
@@ -13,12 +15,15 @@ function parseTimeoutMs(value) {
     }
     return parsed;
 }
-function writeBaselineJson(cwd, baselineFile, result) {
-    const fullPath = join(cwd, baselineFile);
+function writeBaselineJson(projectRoot, baselineFile, result) {
+    const fullPath = join(projectRoot, baselineFile);
     mkdirSync(dirname(fullPath), { recursive: true });
+    // Write the SAME key the reader matches on. Writing ESLint's absolute
+    // `filePath` here is what re-rooted the file on whichever machine ran
+    // the command, so the next checkout inherited keys it could not match.
     const violations = result.findings.map((f) => ({
         ruleId: f.ruleId,
-        file: f.filePath,
+        file: repoRelativeKey(f.filePath, projectRoot),
         line: f.line,
         severity: f.severity,
         message: f.message
@@ -26,7 +31,7 @@ function writeBaselineJson(cwd, baselineFile, result) {
     const payload = {
         version: 1,
         generatedAt: new Date().toISOString(),
-        toolVersion: 'peaks-loop-4.0.16+',
+        toolVersion: `peaks-loop-${CLI_VERSION}`,
         violations
     };
     writeFileSync(fullPath, JSON.stringify(payload, null, 2), 'utf8');
@@ -116,7 +121,7 @@ export function registerLintCommands(program, io) {
     });
     addJsonOption(lint
         .command('baseline')
-        .description('One-shot full-repo scan; writes .peaks/lint/baseline.json (project-level, gitignored by default).')
+        .description('One-shot full-repo scan; writes .peaks/lint/baseline.json with repo-relative file keys (project-level; this repository commits it as a reference fixture).')
         .option('--scope <path>', 'lint scope (default: project root)')
         .option('--config <path>', 'explicit ESLint config path')
         .option('--timeout-ms <ms>', 'subprocess timeout in milliseconds (default 60000)')
@@ -139,8 +144,10 @@ export function registerLintCommands(program, io) {
         };
         const result = runEslint(runOptions);
         const baselineFile = options.baselineFile ?? '.peaks/lint/baseline.json';
-        const written = writeBaselineJson(cwd, baselineFile, result);
-        const envelope = ok('code.lint.baseline', { state: result.state, findings: result.findings.length, ...written }, [], ['Commit baseline.json (or .gitignore it). Peak-loop ships its own baseline as a reference fixture.']);
+        const written = writeBaselineJson(resolveProjectRoot(cwd), baselineFile, result);
+        const envelope = ok('code.lint.baseline', { state: result.state, findings: result.findings.length, ...written }, [], [
+            'Commit baseline.json (or .gitignore it). Peak-loop ships its own baseline as a reference fixture.'
+        ]);
         printResult(io, envelope, options.json);
     });
 }

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

@@ -12,6 +12,6 @@
  * `src/services/log/log-commands-service.ts`. That service is
  * already covered by `tests/unit/log/log-commands.test.ts`.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerLogCommands(program: Command, io: ProgramIO): void;

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

@@ -23,7 +23,7 @@ export function registerLogCommands(program, io) {
         .description('Inspect the peaks-loop JSONL log directory (default: ~/.peaks/logs/)');
     addJsonOption(log
         .command('tail')
-        .description('Print the last 50 lines of today\'s peaks-loop log (JSONL). Pass --lines N to change the count, --date YYYY-MM-DD to read a different day, --batch <id> to filter by batchId, --json to print a JSON envelope.')
+        .description("Print the last 50 lines of today's peaks-loop log (JSONL). Pass --lines N to change the count, --date YYYY-MM-DD to read a different day, --batch <id> to filter by batchId, --json to print a JSON envelope.")
         .option('--lines <n>', 'number of lines to show (default 50)', (value) => Number(value))
         .option('--date <YYYY-MM-DD>', 'read the log for this UTC date instead of today (PRD AC2: PEAKS_LOG_DATE_OVERRIDE)')
         // Slice 2026-06-23-audit-4th #B2: --batch filter for cross-run
@@ -42,18 +42,20 @@ export function registerLogCommands(program, io) {
                 file: result.file,
                 total: result.total,
                 lines: safeLines,
-                ...(options.batch !== undefined ? { batch: options.batch, batchMatches: result.batchMatches ?? 0 } : {}),
+                ...(options.batch !== undefined
+                    ? { batch: options.batch, batchMatches: result.batchMatches ?? 0 }
+                    : {}),
                 entries: result.entries
             }, []), options.json);
         }
         catch (error) {
-            printResult(io, fail('log.tail', 'LOG_TAIL_FAILED', getErrorMessage(error), {}, ['Check `peaks log ls` to see available log files']), options.json);
+            printResult(io, fail('log.tail', 'LOG_TAIL_FAILED', getErrorMessage(error), {}, [
+                'Check `peaks log ls` to see available log files'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
-    addJsonOption(log
-        .command('ls')
-        .description('List peaks-loop-*.log files in ~/.peaks/logs/ (newest first).')).action((options) => {
+    addJsonOption(log.command('ls').description('List peaks-loop-*.log files in ~/.peaks/logs/ (newest first).')).action((options) => {
         const files = listLogFiles();
         printResult(io, ok('log.ls', {
             logDir: join(homedir(), '.peaks', 'logs'),

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

@@ -22,6 +22,6 @@
  * M7 only ADDs export / import — it does not modify the existing
  * surface.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerLoopCommands(program: Command, io: ProgramIO): void;

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

@@ -28,8 +28,8 @@ 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 registerLoopCommands(program, io) {
     // 14.5 peaks goal compose — registered as a TOP-LEVEL command (not under
     // `peaks loop`) because IDE adapters expose it as `goalCommand`.
@@ -39,7 +39,7 @@ export function registerLoopCommands(program, io) {
         .command('goal')
         .description('14.5: compose an autonomous goal (returns the goal envelope that the LLM-side UX layer feeds to peaks sub-agent dispatch)')
         .requiredOption('--project <path>', 'target project root')
-        .requiredOption('--goal <text>', 'the high-level goal to compose')).action(async (options) => {
+        .requiredOption('--goal <text>', 'the high-level goal to compose')).action((options) => {
         try {
             printResult(io, ok('goal.compose', {
                 project: options.project,
@@ -47,10 +47,10 @@ export function registerLoopCommands(program, io) {
                 status: 'placeholder',
                 nextSteps: [
                     'The composed goal is consumed by peaks sub-agent dispatch.',
-                    'The hermes + openclaw IDE adapters (Slice #0.7) surface this as a goalCommand.',
-                ],
+                    'The hermes + openclaw IDE adapters (Slice #0.7) surface this as a goalCommand.'
+                ]
             }, [], [
-                'goal.compose is a thin facade; the LLM-side UX layer decomposes the goal into sub-agent tasks.',
+                'goal.compose is a thin facade; the LLM-side UX layer decomposes the goal into sub-agent tasks.'
             ]), options.json);
         }
         catch (error) {
@@ -59,9 +59,12 @@ export function registerLoopCommands(program, io) {
         }
     });
     // peaks loop *
-    const loop = program.command('loop').description('Slice #14: L4 Agent Loop sub-features (distill / preflight / detect-pattern / check-consistency)');
+    const loop = program
+        .command('loop')
+        .description('Slice #14: L4 Agent Loop sub-features (distill / preflight / detect-pattern / check-consistency)');
     // 14.1 distill
-    addJsonOption(loop.command('distill')
+    addJsonOption(loop
+        .command('distill')
         .description('14.1: distill patterns from past sessions into .peaks/memory/ (delegates to peaks memory extract)')
         .requiredOption('--project <path>', 'target project root')
         .option('--apply', 'write extracted memories to .peaks/memory/ (default: dry-run preview)', false)).action(async (options) => {
@@ -70,22 +73,24 @@ export function registerLoopCommands(program, io) {
             // Delegate to the existing peaks memory extract CLI via dynamic
             // import (avoids circular); the LLM-side UX layer composes the
             // two commands.
-            const { execFileSync } = await import('node:child_process');
+            const { execFileSync } = (await import('node:child_process'));
             const args = ['memory', 'extract', '--project', options.project];
             if (apply)
                 args.push('--apply');
             const stdout = execFileSync('node', ['bin/peaks.js', ...args], {
                 cwd: options.project,
                 stdio: ['ignore', 'pipe', 'ignore'],
-                windowsHide: true,
+                windowsHide: true
             }).toString('utf-8');
             printResult(io, ok('loop.distill', {
                 project: options.project,
                 apply,
-                delegateStdout: stdout.slice(0, 200),
+                delegateStdout: stdout.slice(0, 200)
             }, [], [
-                apply ? 'peaks memory extract --apply was invoked' : 'peaks memory extract dry-run was invoked',
-                'A future slice will inline the memory extract (not via execFileSync).',
+                apply
+                    ? 'peaks memory extract --apply was invoked'
+                    : 'peaks memory extract dry-run was invoked',
+                'A future slice will inline the memory extract (not via execFileSync).'
             ]), options.json);
         }
         catch (error) {
@@ -94,49 +99,50 @@ export function registerLoopCommands(program, io) {
         }
     });
     // 14.2 preflight
-    addJsonOption(loop.command('preflight')
+    addJsonOption(loop
+        .command('preflight')
         .description('14.2: pre-run sanity checks (placeholder; future slice runs peaks doctor + peaks audit before each loop iter)')
-        .requiredOption('--project <path>', 'target project root')).action(async (options) => {
+        .requiredOption('--project <path>', 'target project root')).action((options) => {
         printResult(io, ok('loop.preflight', {
             project: options.project,
             status: 'placeholder',
             nextSteps: [
                 'For each L4 loop iteration, call peaks doctor + peaks audit to surface regressions.',
-                'A future slice will inline the preflight checks (not just placeholder).',
-            ],
+                'A future slice will inline the preflight checks (not just placeholder).'
+            ]
         }, [], [
-            'loop.preflight is a thin facade; the LLM-side UX layer composes peaks doctor + peaks audit.',
+            'loop.preflight is a thin facade; the LLM-side UX layer composes peaks doctor + peaks audit.'
         ]), options.json);
     });
     // 14.3 detect-pattern
-    addJsonOption(loop.command('detect-pattern')
+    addJsonOption(loop
+        .command('detect-pattern')
         .description('14.3: detect repeating patterns across past sessions (placeholder; future slice uses peaks retrospective search)')
-        .requiredOption('--project <path>', 'target project root')).action(async (options) => {
+        .requiredOption('--project <path>', 'target project root')).action((options) => {
         printResult(io, ok('loop.detect-pattern', {
             project: options.project,
             status: 'placeholder',
             nextSteps: [
                 'Run peaks retrospective search --limit 50 to surface high-frequency patterns.',
-                'A future slice will rank by frequency + LLM confidence.',
-            ],
+                'A future slice will rank by frequency + LLM confidence.'
+            ]
         }, [], [
-            'loop.detect-pattern is a thin facade; the LLM-side UX layer composes peaks retrospective search.',
+            'loop.detect-pattern is a thin facade; the LLM-side UX layer composes peaks retrospective search.'
         ]), options.json);
     });
     // 14.4 check-consistency
-    addJsonOption(loop.command('check-consistency')
+    addJsonOption(loop
+        .command('check-consistency')
         .description('14.4: verify state consistency (placeholder; future slice compares .peaks/_runtime across sessions)')
-        .requiredOption('--project <path>', 'target project root')).action(async (options) => {
+        .requiredOption('--project <path>', 'target project root')).action((options) => {
         printResult(io, ok('loop.check-consistency', {
             project: options.project,
             status: 'placeholder',
             nextSteps: [
                 'Compare .peaks/_runtime/<sid>/session.json across recent sessions for drift.',
-                'A future slice will report drift with severity (warn / fail).',
-            ],
-        }, [], [
-            'loop.check-consistency is a thin facade; the LLM-side UX layer composes the drift scan.',
-        ]), options.json);
+                'A future slice will report drift with severity (warn / fail).'
+            ]
+        }, [], ['loop.check-consistency is a thin facade; the LLM-side UX layer composes the drift scan.']), options.json);
     });
     // ---------- M7: peaks loop export / import (spec §7A.2) ----------
     const LOOP_EXPORT_IMPORT_OPTS = (cmd) => cmd
@@ -144,7 +150,7 @@ export function registerLoopCommands(program, io) {
         .option('--json', 'print machine-readable JSON envelope');
     LOOP_EXPORT_IMPORT_OPTS(loop
         .command('export')
-        .description("M7: export a loop_release as a peaks.bundle/1 tarball (spec §7A.2 / §10 RL-9). Refuses to export when shareable=false.")
+        .description('M7: export a loop_release as a peaks.bundle/1 tarball (spec §7A.2 / §10 RL-9). Refuses to export when shareable=false.')
         .requiredOption('--loop <id>', 'loop_release id (kebab-case)')
         .requiredOption('--out <path>', 'output .tar.gz path')).action((options) => {
         const asJson = options.json === true;
@@ -160,15 +166,15 @@ export function registerLoopCommands(program, io) {
                     blobsDir: join(projectRoot, '.peaks', 'blobs'),
                     kind: 'loop',
                     id: options.loop,
-                    outPath: options.out,
+                    outPath: options.out
                 });
                 printResult(io, ok('loop.export', {
                     outPath: result.outPath,
                     kind: result.kind,
                     assetId: result.assetId,
-                    importedAs: 'candidate',
+                    importedAs: 'candidate'
                 }, [], [
-                    `Receiver must run \`peaks loop import --in ${result.outPath}\` to land this bundle, then run an independent evolution_evaluation before any promote.`,
+                    `Receiver must run \`peaks loop import --in ${result.outPath}\` to land this bundle, then run an independent evolution_evaluation before any promote.`
                 ]), asJson);
             }
             finally {
@@ -177,16 +183,12 @@ export function registerLoopCommands(program, io) {
         }
         catch (error) {
             if (error instanceof BundleNotShareableError) {
-                printResult(io, fail('loop.export', error.code, error.message, { ok: false, loop: options.loop }, [
-                    'Set shareable=true on the loop_release row, or share via desktop_visible=false.',
-                ]), asJson);
+                printResult(io, fail('loop.export', error.code, error.message, { ok: false, loop: options.loop }, ['Set shareable=true on the loop_release row, or share via desktop_visible=false.']), asJson);
                 process.exitCode = 1;
                 return;
             }
             if (error instanceof BundleAssetNotFoundError) {
-                printResult(io, fail('loop.export', error.code, error.message, { ok: false, loop: options.loop }, [
-                    'Verify the loop id with `peaks asset status --loop <id>`.',
-                ]), asJson);
+                printResult(io, fail('loop.export', error.code, error.message, { ok: false, loop: options.loop }, ['Verify the loop id with `peaks asset status --loop <id>`.']), asJson);
                 process.exitCode = 1;
                 return;
             }
@@ -196,7 +198,7 @@ export function registerLoopCommands(program, io) {
     });
     LOOP_EXPORT_IMPORT_OPTS(loop
         .command('import')
-        .description("M7: import a peaks.bundle/1 tarball. Lands as candidate only — promotion requires an evolution_evaluation row (spec §7A.2 / §10 RL-9 / AC-25 / AC-26).")
+        .description('M7: import a peaks.bundle/1 tarball. Lands as candidate only — promotion requires an evolution_evaluation row (spec §7A.2 / §10 RL-9 / AC-25 / AC-26).')
         .requiredOption('--in <path>', 'input .tar.gz path')
         .option('--as <id>', 'optional rename for the loop id when landing')).action((options) => {
         const asJson = options.json === true;
@@ -211,16 +213,16 @@ export function registerLoopCommands(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('loop.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 loop promote refuses without an evolution_evaluation row.`,
+                    `Run an independent evaluation against this release before promoting; peaks loop promote refuses without an evolution_evaluation row.`
                 ]), asJson);
             }
             finally {
@@ -230,29 +232,27 @@ export function registerLoopCommands(program, io) {
         catch (error) {
             if (error instanceof BundleMajorVersionMismatchError) {
                 printResult(io, fail('loop.import', error.code, error.message, { ok: false, 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('loop.import', error.code, error.message, { ok: false }, [
-                    '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('loop.import', error.code, error.message, { ok: false }, [
-                    '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('loop.import', error.code, error.message, { ok: false, inPath: options.in }, [
-                    'Re-export from the source via `peaks loop export`.',
-                ]), asJson);
+                printResult(io, fail('loop.import', error.code, error.message, { ok: false, inPath: options.in }, ['Re-export from the source via `peaks loop export`.']), asJson);
                 process.exitCode = 1;
                 return;
             }

package/dist/cli/commands/loop-eval-commands.d.ts

@@ -15,6 +15,6 @@
  * Karpathy §2: separate file from workflow-commands.ts to stay under
  * the 800-line budget.
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerWorkflowEvalCommands(program: Command, io: ProgramIO): void;