peaks-loop 4.0.53 → 4.1.0

package/dist/cli/commands/compact-command.js

@@ -4,7 +4,7 @@ import { fail, ok, getErrorMessage } from 'peaks-loop-shared/result';
 import { addJsonOption, printResult } from '../cli-helpers.js';
 import { writeCheckpoint } from '../../services/session/session-checkpoint-service.js';
 import { getSessionIdCanonical } from '../../services/session/session-manager.js';
-import { computeWindowCalibration, readCompactHistory, summarizeCompactHistory, } from '../../services/compact-history/compact-history-service.js';
+import { computeWindowCalibration, readCompactHistory, summarizeCompactHistory } from '../../services/compact-history/compact-history-service.js';
 import { readHarnessWindowState, resolveHarnessWindowLocation } from '../../services/context/auto-compact-reader.js';
 import { disableHarnessWindowSync, reenableHarnessWindowSync, resetHarnessWindow } from '../../services/context/harness-window-config.js';
 import { buildRecommendEnvelopePure, dryRunCompact, suggestCompact } from '../../services/compact/suggest-service.js';
@@ -47,7 +47,8 @@ async function readHookPayload() {
     try {
         return JSON.parse(raw);
     }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+    catch {
+        // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
         return null;
     }
 }
@@ -117,7 +118,9 @@ export function registerCompactCommands(program, io) {
             ]), options.json);
         }
         catch (error) {
-            printResult(io, fail('compact.suggest', 'COMPACT_SUGGEST_FAILED', getErrorMessage(error), {}, ['Verify project root and session binding before retrying']), options.json);
+            printResult(io, fail('compact.suggest', 'COMPACT_SUGGEST_FAILED', getErrorMessage(error), {}, [
+                'Verify project root and session binding before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -151,7 +154,11 @@ export function registerCompactCommands(program, io) {
                 rationale: envelope.rationale,
                 suggestedMessage: envelope.suggestedMessage,
                 notInTable: lookup.notInTable
-            }, lookup.notInTable ? [`Transition ${options.from} → ${options.to} is not in the strategic-compact table; defaulting to severity=no.`] : []), options.json);
+            }, lookup.notInTable
+                ? [
+                    `Transition ${options.from} → ${options.to} is not in the strategic-compact table; defaulting to severity=no.`
+                ]
+                : []), options.json);
         }
         catch (error) {
             printResult(io, fail('compact.recommend', 'COMPACT_RECOMMEND_FAILED', getErrorMessage(error), { from: options.from, to: options.to }, ['Verify the phase pair against the documented transitions']), options.json);
@@ -224,7 +231,9 @@ export function registerCompactCommands(program, io) {
             ]), options.json);
         }
         catch (error) {
-            printResult(io, fail('compact.dry-run', 'COMPACT_DRY_RUN_FAILED', getErrorMessage(error), {}, ['Verify project root, session binding, and phase pair before retrying']), options.json);
+            printResult(io, fail('compact.dry-run', 'COMPACT_DRY_RUN_FAILED', getErrorMessage(error), {}, [
+                'Verify project root, session binding, and phase pair before retrying'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -234,7 +243,7 @@ export function registerCompactCommands(program, io) {
     addJsonOption(compact
         .command('force')
         .description('Write a pre-compact checkpoint via `peaks session checkpoint --reason context-fill`. ' +
-        'The IDE-side `/compact` is still the LLM\'s call; this primitive guarantees ' +
+        "The IDE-side `/compact` is still the LLM's call; this primitive guarantees " +
         'the pre-compact state is persisted. NO sleep, NO wait for IDE response.')
         .option('--reason <text>', 'human-readable reason for the pre-compact checkpoint', 'pre-force-compact')
         .option('--project <path>', 'project root (defaults to git root or cwd)')
@@ -284,13 +293,15 @@ export function registerCompactCommands(program, io) {
                 sessionId: result.sessionId,
                 createdAt: result.createdAt,
                 totalRetained: result.totalRetained,
-                message: 'Pre-compact checkpoint written. The IDE-side /compact is still the LLM\'s call; this CLI does NOT invoke the IDE slash command.'
+                message: "Pre-compact checkpoint written. The IDE-side /compact is still the LLM's call; this CLI does NOT invoke the IDE slash command."
             }, [], [
                 'After the LLM fires the IDE-side /compact, call `peaks compact survival` to see what to persist before the next compact.'
             ]), options.json);
         }
         catch (error) {
-            printResult(io, fail('compact.force', 'COMPACT_FORCE_FAILED', getErrorMessage(error), {}, ['Verify the project path is writable and a session is bound']), options.json);
+            printResult(io, fail('compact.force', 'COMPACT_FORCE_FAILED', getErrorMessage(error), {}, [
+                'Verify the project path is writable and a session is bound'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -312,13 +323,16 @@ export function registerCompactCommands(program, io) {
                 process.exitCode = 1;
                 return;
             }
-            const result = readCompactHistory({ projectRoot: project, sessionId: session.sid });
+            const result = readCompactHistory({
+                projectRoot: project,
+                sessionId: session.sid
+            });
             if (result.kind === 'file-missing') {
                 printResult(io, ok('compact.history', {
                     sessionId: session.sid,
                     totalCompacts: 0,
                     message: 'No compact-history.jsonl yet; auto-compact has not fired in this session.',
-                    historyPath: result.path,
+                    historyPath: result.path
                 }), options.json);
                 return;
             }
@@ -327,7 +341,7 @@ export function registerCompactCommands(program, io) {
                     sessionId: session.sid,
                     totalCompacts: 0,
                     message: 'compact-history.jsonl exists but is empty.',
-                    historyPath: result.path,
+                    historyPath: result.path
                 }), options.json);
                 return;
             }
@@ -344,11 +358,13 @@ export function registerCompactCommands(program, io) {
                 windowCalibration,
                 events: result.events,
                 parseErrors: result.parseErrors,
-                historyPath: result.path,
+                historyPath: result.path
             }), options.json);
         }
         catch (error) {
-            printResult(io, fail('compact.history', 'COMPACT_HISTORY_READ_FAILED', getErrorMessage(error), {}, ['Verify the project path is readable and a session is bound']), options.json);
+            printResult(io, fail('compact.history', 'COMPACT_HISTORY_READ_FAILED', getErrorMessage(error), {}, [
+                'Verify the project path is readable and a session is bound'
+            ]), options.json);
             process.exitCode = 1;
         }
     }));
@@ -368,7 +384,7 @@ export function registerCompactCommands(program, io) {
     addJsonOption(compact
         .command('harness-window')
         .description('Report / roll back the auto-compact window peaks-loop writes into the ' +
-        'harness\'s own machine-local settings (the adapter-declared ' +
+        "harness's own machine-local settings (the adapter-declared " +
         'autoCompactWindowEnvVar, e.g. CLAUDE_CODE_AUTO_COMPACT_WINDOW in ' +
         '.claude/settings.local.json). peaks-loop computes its context ratio ' +
         'against exactly this number, so the value it reports as "85%" and the ' +
@@ -390,13 +406,16 @@ export function registerCompactCommands(program, io) {
             const project = options.project !== undefined
                 ? resolveCanonicalProjectRoot(options.project)
                 : (findProjectRoot(process.cwd()) ?? process.cwd());
-            const location = resolveHarnessWindowLocation({ projectRoot: project, env: process.env });
+            const location = resolveHarnessWindowLocation({
+                projectRoot: project,
+                env: process.env
+            });
             if (location === null) {
                 printResult(io, ok('compact.harness-window', {
                     projectRoot: project,
                     managed: false,
                     message: 'The active IDE adapter declares no auto-compact window key, so peaks-loop cannot tie ' +
-                        'the harness window to its own ratio. Nothing was written and there is nothing to roll back.',
+                        'the harness window to its own ratio. Nothing was written and there is nothing to roll back.'
                 }), options.json);
                 return;
             }
@@ -407,11 +426,11 @@ export function registerCompactCommands(program, io) {
                     action: result.action,
                     key: location.envVar,
                     settingsPath: result.settingsPath,
-                    previousTokens: result.previousTokens,
+                    previousTokens: result.previousTokens
                 }, [], [
                     result.action === 'removed'
                         ? `Removed ${location.envVar} from ${result.settingsPath} and opted this project out, so later probes stop writing it. Undo with \`peaks compact harness-window --reenable\`.`
-                        : `Nothing to remove — ${location.envVar} was already absent from ${result.settingsPath}, so nothing was written and no opt-out row was recorded: if a probe writes a window here later, run --reset again to remove it. To say "never manage this key here" WITHOUT waiting for that first write, run \`peaks compact harness-window --disable\`.`,
+                        : `Nothing to remove — ${location.envVar} was already absent from ${result.settingsPath}, so nothing was written and no opt-out row was recorded: if a probe writes a window here later, run --reset again to remove it. To say "never manage this key here" WITHOUT waiting for that first write, run \`peaks compact harness-window --disable\`.`
                 ]), options.json);
                 return;
             }
@@ -421,7 +440,7 @@ export function registerCompactCommands(program, io) {
                     projectRoot: project,
                     action: result.action,
                     key: location.envVar,
-                    settingsPath: result.settingsPath,
+                    settingsPath: result.settingsPath
                 }, [], [
                     result.action === 'disabled'
                         ? `Recorded the opt-out in ${result.settingsPath}: peaks-loop will not write ${location.envVar} here, and left any value already in the file exactly as it was. Undo with \`peaks compact harness-window --reenable\`.`
@@ -429,16 +448,21 @@ export function registerCompactCommands(program, io) {
                             ? `Already opted out — ${result.settingsPath} carries ${location.envVar}'s opt-out, so nothing was written. Undo with \`peaks compact harness-window --reenable\`.`
                             : result.action === 'refused-unsafe-project-root'
                                 ? `Nothing written: the resolved project root is the user's own home directory, so ${result.settingsPath} is their PERSONAL harness settings, not a project's. peaks-loop already refuses to write ${location.envVar} there, so an opt-out would change nothing except which refusal you see. Point --project at a project (a subdirectory of home is fine) and the opt-out lands there.`
-                                : `Nothing written — ${result.settingsPath} is not a JSON object peaks-loop can safely edit, so the opt-out could not be recorded there.`,
+                                : `Nothing written — ${result.settingsPath} is not a JSON object peaks-loop can safely edit, so the opt-out could not be recorded there.`
                 ]), options.json);
                 return;
             }
             if (options.reenable === true) {
                 const result = reenableHarnessWindowSync({ location });
-                printResult(io, ok('compact.harness-window', { projectRoot: project, action: result.action, key: location.envVar, settingsPath: result.settingsPath }, [], [
+                printResult(io, ok('compact.harness-window', {
+                    projectRoot: project,
+                    action: result.action,
+                    key: location.envVar,
+                    settingsPath: result.settingsPath
+                }, [], [
                     result.action === 'reenabled'
                         ? 'Opt-out cleared; the next context probe will materialize the window again.'
-                        : 'No opt-out was recorded for this project.',
+                        : 'No opt-out was recorded for this project.'
                 ]), options.json);
                 return;
             }
@@ -455,15 +479,15 @@ export function registerCompactCommands(program, io) {
                 // Provenance: whether this value is peaks-loop's own write or
                 // one the user set by hand. It decides whether the late 1M
                 // rescue may override it, so it is not just diagnostics.
-                peakWritten: state?.peakWritten ?? false,
+                peakWritten: state?.peakWritten ?? false
             }, [], [
                 state?.tokens === null || state?.tokens === undefined
                     ? 'No window is set yet. The next `peaks code context-now` probe materializes the window it computes its ratio against.'
                     : `peaks-loop computes its context ratio against ${state.tokens} tokens; the harness fires near the end of that window. ${state.peakWritten
                         ? 'peaks-loop wrote this value; it may raise it if a session outgrows it.'
-                        : 'This value is not peaks-loop\'s own write, so peaks-loop will not raise it — it is treated as your setting.'}`,
+                        : "This value is not peaks-loop's own write, so peaks-loop will not raise it — it is treated as your setting."}`,
                 'Rollback: `peaks compact harness-window --reset`.',
-                'Intent-vs-observed calibration: `peaks compact history --json` → windowCalibration.',
+                'Intent-vs-observed calibration: `peaks compact history --json` → windowCalibration.'
             ]), options.json);
         }
         catch (error) {
@@ -536,7 +560,9 @@ export function registerCompactCommands(program, io) {
         catch (error) {
             if (options.json !== true)
                 return;
-            printResult(io, fail('compact.settle', 'COMPACT_SETTLE_FAILED', getErrorMessage(error), {}, ['Verify the project path and session binding']), true);
+            printResult(io, fail('compact.settle', 'COMPACT_SETTLE_FAILED', getErrorMessage(error), {}, [
+                'Verify the project path and session binding'
+            ]), true);
         }
     });
 }

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

@@ -19,16 +19,15 @@ export function registerComplexityCommands(program, io) {
         .requiredOption('--files <list>', 'comma-separated file paths (relative to project root)')
         .option('--project <path>', 'project root (default: cwd)')).action((opts) => {
         const projectRoot = opts.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        const files = opts.files.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
+        const files = opts.files
+            .split(',')
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
         if (files.length === 0) {
-            printResult(io, fail('complexity-estimate', 'INVALID_INPUT', 'no files provided (--files)', { projectRoot }, [
-                'Pass --files with at least one file path.'
-            ]), opts.json ?? false);
+            printResult(io, fail('complexity-estimate', 'INVALID_INPUT', 'no files provided (--files)', { projectRoot }, ['Pass --files with at least one file path.']), opts.json ?? false);
             return;
         }
         const report = estimateComplexity(projectRoot, files);
-        printResult(io, ok('complexity-estimate', { projectRoot, report }, [], [
-            `Overall tier: ${report.overall}. Schedule accordingly.`
-        ]), opts.json ?? false);
+        printResult(io, ok('complexity-estimate', { projectRoot, report }, [], [`Overall tier: ${report.overall}. Schedule accordingly.`]), opts.json ?? false);
     });
 }

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

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

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

@@ -10,18 +10,30 @@ export function registerConfigCommands(program, io) {
     registerConfigMigrationCommands(config, io);
 }
 function registerConfigGetSetCommands(config, io) {
-    addJsonOption(config.command('get').description('Get current config or a specific key').option('--key <path>', 'dot-notation key path').option('--layer <layer>', 'user or project')).action((options) => {
+    addJsonOption(config
+        .command('get')
+        .description('Get current config or a specific key')
+        .option('--key <path>', 'dot-notation key path')
+        .option('--layer <layer>', 'user or project')).action((options) => {
         const layer = parseConfigLayer(options.layer);
         if (layer === null) {
             printInvalidConfigLayer(io, 'config.get', options.json);
             return;
         }
-        const getOpts = { ...(layer !== undefined ? { layer } : {}), ...(options.key !== undefined ? { key: options.key } : {}) };
+        const getOpts = {
+            ...(layer !== undefined ? { layer } : {}),
+            ...(options.key !== undefined ? { key: options.key } : {})
+        };
         const value = getConfig(getOpts);
         const isSensitiveKey = options.key !== undefined && isSensitiveConfigPath(options.key);
         printResult(io, ok('config.get', isSensitiveKey ? '***' : redactConfigSecrets(value, options.key ?? '')), options.json);
     });
-    addJsonOption(config.command('set').description('Set a config value').requiredOption('--key <path>', 'dot-notation key path').requiredOption('--value <json>', 'JSON value').option('--layer <layer>', 'user or project')).action((options) => {
+    addJsonOption(config
+        .command('set')
+        .description('Set a config value')
+        .requiredOption('--key <path>', 'dot-notation key path')
+        .requiredOption('--value <json>', 'JSON value')
+        .option('--layer <layer>', 'user or project')).action((options) => {
         const parsedLayer = parseConfigLayer(options.layer);
         if (parsedLayer === null) {
             printInvalidConfigLayer(io, 'config.set', options.json);
@@ -32,7 +44,9 @@ function registerConfigGetSetCommands(config, io) {
             parsed = JSON.parse(options.value);
         }
         catch {
-            printResult(io, fail('config.set', 'INVALID_JSON', 'Could not parse value as JSON', {}, ['Use valid JSON: --value \'{"key":"value"}\'']), options.json);
+            printResult(io, fail('config.set', 'INVALID_JSON', 'Could not parse value as JSON', {}, [
+                'Use valid JSON: --value \'{"key":"value"}\''
+            ]), options.json);
             process.exitCode = 1;
             return;
         }
@@ -69,7 +83,9 @@ function registerConfigMigrationCommands(config, io) {
             printResult(io, ok('config.migrate', { ...plan, applied: false }), options.json);
         }
         catch (error) {
-            printResult(io, fail('config.migrate', 'CONFIG_MIGRATE_FAILED', getErrorMessage(error), {}, ['Inspect ~/.peaks/config.json and re-run with --apply']), options.json);
+            printResult(io, fail('config.migrate', 'CONFIG_MIGRATE_FAILED', getErrorMessage(error), {}, [
+                'Inspect ~/.peaks/config.json and re-run with --apply'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -95,7 +111,9 @@ function registerConfigMigrationCommands(config, io) {
             // an `available: false` SUCCESS envelope (see `config-rollback.ts`).
             const message = getErrorMessage(error);
             io.stderr(`CONFIG_ROLLBACK_FAILED: ${message}`);
-            printResult(io, fail('config.rollback', 'CONFIG_ROLLBACK_FAILED', message, {}, ['Re-run peaks config migrate --apply to recreate the .bak']), options.json);
+            printResult(io, fail('config.rollback', 'CONFIG_ROLLBACK_FAILED', message, {}, [
+                'Re-run peaks config migrate --apply to recreate the .bak'
+            ]), options.json);
             process.exitCode = 1;
         }
     });
@@ -141,15 +159,21 @@ function registerConfigMigrationCommands(config, io) {
 function printConfigSetError(io, error, asJson) {
     const message = getErrorMessage(error);
     if (message === 'Sensitive config keys must be stored in the user config layer') {
-        printResult(io, fail('config.set', 'SECRET_CONFIG_REQUIRES_USER_LAYER', message, {}, ['Use --layer user for sensitive config keys']), asJson);
+        printResult(io, fail('config.set', 'SECRET_CONFIG_REQUIRES_USER_LAYER', message, {}, [
+            'Use --layer user for sensitive config keys'
+        ]), asJson);
         process.exitCode = 1;
         return;
     }
     if (message === 'Project config not found') {
-        printResult(io, fail('config.set', 'PROJECT_CONFIG_NOT_FOUND', message, {}, ['Create a safe .peaks/config.json in the project or use --layer user']), asJson);
+        printResult(io, fail('config.set', 'PROJECT_CONFIG_NOT_FOUND', message, {}, [
+            'Create a safe .peaks/config.json in the project or use --layer user'
+        ]), asJson);
         process.exitCode = 1;
         return;
     }
-    printResult(io, fail('config.set', 'CONFIG_SET_FAILED', message, {}, ['Check the config key and layer, then retry']), asJson);
+    printResult(io, fail('config.set', 'CONFIG_SET_FAILED', message, {}, [
+        'Check the config key and layer, then retry'
+    ]), asJson);
     process.exitCode = 1;
 }

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

@@ -37,7 +37,11 @@ function detectContainerRuntime(explicit) {
     const tryOrder = explicit ? [explicit] : ['docker', 'podman'];
     for (const r of tryOrder) {
         try {
-            const version = execSync(`${r} --version`, { stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8', windowsHide: true }).trim();
+            const version = execSync(`${r} --version`, {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                encoding: 'utf8',
+                windowsHide: true
+            }).trim();
             return { ok: true, runtime: r, binary: `${r} (${version.split('\n')[0] ?? ''})` };
         }
         catch {
@@ -65,8 +69,11 @@ function checkDockerAvailable() {
     return { ok: false, stderr: 'deprecated — use detectContainerRuntime' };
 }
 export function registerContainerCommand(program, io) {
-    const cmd = program.command('container').description('L4 container isolation: spawn/release container leases (Part 12; pairs with --isolation container on dispatch).');
-    addJsonOption(cmd.command('spawn')
+    const cmd = program
+        .command('container')
+        .description('L4 container isolation: spawn/release container leases (Part 12; pairs with --isolation container on dispatch).');
+    addJsonOption(cmd
+        .command('spawn')
         .description('Spawn a container via `docker run` and write a container lease. ' +
         'The lease is the source of truth for the L4 PreToolUse gate (Part 12 follow-up). ' +
         'Default TTL is role-aware (rd=30m / qa=15m / ui=1h); pass --ttl <ms> to override. ' +
@@ -78,9 +85,12 @@ export function registerContainerCommand(program, io) {
         .option('--ttl <ms>', 'time-to-live in ms (default role-aware; override with positive number)')
         .option('--mount <path>', 'host path to mount as the container working dir (default: <projectRoot>)')
         .option('--session <sid>', 'override session id')
-        .option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action(async (options) => {
+        .option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => {
         const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        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';
         try {
             const explicitRuntime = (() => {
                 if (options.runtime === 'docker')
@@ -101,7 +111,9 @@ export function registerContainerCommand(program, io) {
             }
             const leaseId = generateContainerLeaseId();
             const now = Date.now();
-            const ttlMs = options.ttl === undefined ? ttlForContainerRole(options.role) : Number.parseInt(options.ttl, 10);
+            const ttlMs = options.ttl === undefined
+                ? ttlForContainerRole(options.role)
+                : Number.parseInt(options.ttl, 10);
             if (!Number.isInteger(ttlMs) || ttlMs <= 0) {
                 printResult(io, fail('container.spawn', 'INVALID_TTL', '--ttl must be a positive integer (ms)', { ttl: options.ttl }, ['Re-run with --ttl 1800000 (30 min) or omit to use role default.']), options.json);
                 process.exitCode = 1;
@@ -162,13 +174,17 @@ export function registerContainerCommand(program, io) {
             process.exitCode = 1;
         }
     });
-    addJsonOption(cmd.command('release')
+    addJsonOption(cmd
+        .command('release')
         .description('Transition a container lease to released and run `docker rm --force`. Idempotent on already-released leases.')
         .requiredOption('--lease-id <id>', 'lease id returned by `peaks container spawn`')
         .option('--session <sid>', 'override session id')
         .option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => {
         const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        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';
         try {
             const file = containerLeaseFilePath(joinPathSession(projectRoot, sessionId), options.leaseId);
             if (!existsSync(file)) {
@@ -199,23 +215,31 @@ export function registerContainerCommand(program, io) {
             try {
                 const releaseRuntime = detectContainerRuntime(undefined);
                 const runtimeCmd = releaseRuntime.ok ? releaseRuntime.runtime : 'docker';
-                execSync(`${runtimeCmd} rm --force "${lease.containerId}"`, { cwd: projectRoot, stdio: 'pipe', encoding: 'utf8', windowsHide: true });
+                execSync(`${runtimeCmd} rm --force "${lease.containerId}"`, {
+                    cwd: projectRoot,
+                    stdio: 'pipe',
+                    encoding: 'utf8',
+                    windowsHide: true
+                });
             }
             catch {
                 dockerRmFailed = true;
             }
             const released = markContainerReleased(lease);
             atomicWriteJson(file, released);
-            printResult(io, ok('container.release', { lease: released, sessionId, projectRoot, dockerRmFailed }, dockerRmFailed ? ['docker rm failed (likely the container was already removed); lease marked released.'] : [], [
+            printResult(io, ok('container.release', { lease: released, sessionId, projectRoot, dockerRmFailed }, dockerRmFailed
+                ? [
+                    'docker rm failed (likely the container was already removed); lease marked released.'
+                ]
+                : [], [
                 `Lease ${lease.leaseId} marked released.`,
-                dockerRmFailed ? 'Manual `docker ps -a` + `docker rm` may be needed.' : `Container ${lease.containerId} removed.`
+                dockerRmFailed
+                    ? 'Manual `docker ps -a` + `docker rm` may be needed.'
+                    : `Container ${lease.containerId} removed.`
             ]), options.json);
         }
         catch (err) {
-            printResult(io, fail('container.release', 'RELEASE_FAILED', getErrorMessage(err), { leaseId: options.leaseId, sessionId }, [
-                'Verify the lease id and re-run.',
-                'If the lease was never spawned, no-op.'
-            ]), options.json);
+            printResult(io, fail('container.release', 'RELEASE_FAILED', getErrorMessage(err), { leaseId: options.leaseId, sessionId }, ['Verify the lease id and re-run.', 'If the lease was never spawned, no-op.']), options.json);
             process.exitCode = 1;
         }
     });

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

@@ -15,7 +15,7 @@
  *   - refactor: L0 + L1 + L2 + L3
  *   - migration: L0 + L1 + L2 + L3 + codegraph
  */
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export type ContextLayer = 'L0' | 'L1' | 'L2' | 'L3';
 export declare function registerContextCommands(program: Command, io: ProgramIO): void;

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

@@ -66,7 +66,14 @@ async function fetchL0(projectRoot) {
         sizes.push({ path: rel, bytes: body.length });
         byteSize += body.length;
     }
-    return { layer: 'L0', description: 'full read: every SKILL.md concatenated', files: sizes, content, byteSize, warnings };
+    return {
+        layer: 'L0',
+        description: 'full read: every SKILL.md concatenated',
+        files: sizes,
+        content,
+        byteSize,
+        warnings
+    };
 }
 async function fetchL1(projectRoot) {
     const files = readSkillsDir(projectRoot);
@@ -85,7 +92,14 @@ async function fetchL1(projectRoot) {
         sizes.push({ path: rel, bytes: firstPara.length });
         byteSize += firstPara.length;
     }
-    return { layer: 'L1', description: 'summary: first paragraph per skill', files: sizes, content, byteSize, warnings };
+    return {
+        layer: 'L1',
+        description: 'summary: first paragraph per skill',
+        files: sizes,
+        content,
+        byteSize,
+        warnings
+    };
 }
 async function fetchL2(projectRoot) {
     const files = readSkillsDir(projectRoot);
@@ -97,14 +111,21 @@ async function fetchL2(projectRoot) {
         files: files.map((f) => ({ path: f, bytes: 0 })),
         content,
         byteSize,
-        warnings: [],
+        warnings: []
     };
 }
 async function fetchL3(projectRoot, query) {
     const warnings = [];
     if (query.trim().length === 0) {
         warnings.push('empty query; L3 requires a --query string for fuzzy search');
-        return { layer: 'L3', description: 'fuzzy search (empty query)', files: [], content: '', byteSize: 0, warnings };
+        return {
+            layer: 'L3',
+            description: 'fuzzy search (empty query)',
+            files: [],
+            content: '',
+            byteSize: 0,
+            warnings
+        };
     }
     try {
         const hits = searchMemory({ projectRoot, query, limit: 10 });
@@ -119,7 +140,7 @@ async function fetchL3(projectRoot, query) {
             files: hits.map((h) => ({ path: h.sourcePath, bytes: h.description.length })),
             content,
             byteSize: content.length,
-            warnings,
+            warnings
         };
     }
     catch (error) {
@@ -129,7 +150,7 @@ async function fetchL3(projectRoot, query) {
             files: [],
             content: '',
             byteSize: 0,
-            warnings: [`L3 search failed: ${getErrorMessage(error)}`],
+            warnings: [`L3 search failed: ${getErrorMessage(error)}`]
         };
     }
 }
@@ -161,7 +182,9 @@ export function registerContextCommands(program, io) {
                 payload = await fetchL3(options.project, options.query ?? '');
             printResult(io, ok('context.layer', payload, [], [
                 `${payload.layer} loaded: ${payload.byteSize} bytes across ${payload.files.length} file(s)`,
-                payload.warnings.length > 0 ? `${payload.warnings.length} warning(s); see envelope.warnings` : null
+                payload.warnings.length > 0
+                    ? `${payload.warnings.length} warning(s); see envelope.warnings`
+                    : null
             ].filter((x) => typeof x === 'string')), options.json);
         }
         catch (error) {
@@ -183,12 +206,12 @@ export function registerContextCommands(program, io) {
                 return;
             }
             const evaluation = evaluateMainSessionThreshold(promptSize, capacity);
-            printResult(io, ok('context.status', { ...evaluation, ide: detectIdeFromEnv() }, [...evaluation.warnings], [
-                `Main-session tier=${evaluation.tier} (${(evaluation.ratio * 100).toFixed(0)}%)`
-            ]), opts.json);
+            printResult(io, ok('context.status', { ...evaluation, ide: detectIdeFromEnv() }, [...evaluation.warnings], [`Main-session tier=${evaluation.tier} (${(evaluation.ratio * 100).toFixed(0)}%)`]), opts.json);
         }
         catch (err) {
-            printResult(io, fail('context.status', 'CONTEXT_STATUS_FAILED', getErrorMessage(err), null, ['Verify --prompt-size is a non-negative number']), opts.json);
+            printResult(io, fail('context.status', 'CONTEXT_STATUS_FAILED', getErrorMessage(err), null, [
+                'Verify --prompt-size is a non-negative number'
+            ]), opts.json);
             process.exitCode = 1;
         }
     });
@@ -210,7 +233,9 @@ export function registerContextCommands(program, io) {
             const trigger = pickMainSessionTrigger({
                 promptSize,
                 capacityBytes: capacity,
-                inFlightBatch: opts.inFlightBatch === true ? { hasInFlightBatch: true, sharedChannelEntries: 1 } : undefined
+                inFlightBatch: opts.inFlightBatch === true
+                    ? { hasInFlightBatch: true, sharedChannelEntries: 1 }
+                    : undefined
             });
             // Slice C of v2.11.1 — observability hook #5/7. Fire-and-forget
             // per PRD Q4. The synchronous emit never throws.
@@ -248,7 +273,9 @@ export function registerContextCommands(program, io) {
             ]), opts.json);
         }
         catch (err) {
-            printResult(io, fail('context.check', 'CONTEXT_CHECK_FAILED', getErrorMessage(err), null, ['Verify --prompt-size is a non-negative number']), opts.json);
+            printResult(io, fail('context.check', 'CONTEXT_CHECK_FAILED', getErrorMessage(err), null, [
+                'Verify --prompt-size is a non-negative number'
+            ]), opts.json);
             process.exitCode = 1;
         }
     });

package/dist/cli/commands/core/artifacts-command.js

@@ -3,7 +3,9 @@ import { getArtifactWorkspaceStatus, planArtifactSync } from '../../../services/
 import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, failUnsupportedNonDryRun, isArtifactProvider, isArtifactSetupStep, printResult } from '../../cli-helpers.js';
 export function registerArtifactsCommand(program, io) {
-    const artifacts = program.command('artifacts').description('Manage intermediate artifact repositories');
+    const artifacts = program
+        .command('artifacts')
+        .description('Manage intermediate artifact repositories');
     addJsonOption(artifacts.command('status').description('Show artifact repository status')).action((options) => {
         printResult(io, ok('artifacts.status', getArtifactStatus()), options.json);
     });
@@ -43,10 +45,16 @@ export function registerArtifactsCommand(program, io) {
         }
         printResult(io, ok('artifacts.sync', planArtifactSync(options.workspace, true)), options.json);
     });
-    addJsonOption(artifacts.command('workspace').description('Show artifact workspace status for current or specified workspace').option('--workspace <id>', 'workspace identifier')).action((options) => {
+    addJsonOption(artifacts
+        .command('workspace')
+        .description('Show artifact workspace status for current or specified workspace')
+        .option('--workspace <id>', 'workspace identifier')).action((options) => {
         printResult(io, ok('artifacts.workspace', getArtifactWorkspaceStatus(options.workspace)), options.json);
     });
-    addJsonOption(artifacts.command('setup').description('Interactive guided artifact repository setup').option('--step <step>', 'start from specific step: detect, configure, validate, complete')).action((options) => {
+    addJsonOption(artifacts
+        .command('setup')
+        .description('Interactive guided artifact repository setup')
+        .option('--step <step>', 'start from specific step: detect, configure, validate, complete')).action((options) => {
         const requestedStep = options.step;
         const setup = createGuidedArtifactSetup();
         if (requestedStep) {