peaks-loop 4.0.54 → 4.1.0

package/dist/cli/commands/code-runtime-commands.js

@@ -12,7 +12,10 @@
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 import { detectPostCompactResume, formatPostCompactResumeLogLine } from '../../services/code/post-compact-detector.js';
-import { runAutoCompact } from '../../services/code/auto-compact-orchestrator.js';
+import { evaluateCompactTrigger, runAutoCompact } from '../../services/code/auto-compact-orchestrator.js';
+import { thresholdFor } from '../../services/code/auto-compact-modes.js';
+import { resolveAutoCompactProfile } from '../../services/mode/mode-status-service.js';
+import { AUTO_COMPACT_SOFT_WARN_RATIO } from '../../services/context/auto-compact-types.js';
 import { auditContext } from '../../services/context/context-audit.js';
 import { syncHarnessWindowForProject } from '../../services/context/auto-compact-reader.js';
 import { describeHarnessWindowSync, harnessWindowSyncWarning } from '../../services/context/harness-window-config.js';
@@ -25,6 +28,43 @@ import { readJobShapeDecision, JobShapeDecisionError } from '../../services/code
 import { getSkillPresence } from '../../services/skills/skill-presence-service.js';
 import { probeInFlightBatch } from '../../services/workflow/workflow-inflight-probe.js';
 import { resolveOuterSessionId } from '../../services/session/binding-status-service.js';
+/** The one dispatch verb the action and red-line tiers name. */
+const COMPACT_CMD = 'peaks code auto-compact';
+/**
+ * Slice H4 (rid=h4-context-now-mode-blind) — the ONE mapping from the shared
+ * `CompactTrigger` to this command's `action` vocabulary, so the two cannot
+ * drift: the trigger is `evaluateCompactTrigger`, the same function `peaks
+ * code auto-compact` decides with.
+ *
+ * `auto-fire` maps to `soft-warn` in BOTH modes: that tier is `peaks skill
+ * presence`'s — the every-turn probe, which reads this same table and mode
+ * resolver — so `context-now` has no auto-fire tier of its own (SKILL.md
+ * "two probes, two thresholds"). Reporting it as `auto-compact-now` would
+ * change every non-24h session's output, which slice H4 forbids.
+ */
+export function contextNowActionFor(ratio, mode) {
+    const kind = evaluateCompactTrigger(ratio, mode).kind;
+    if (kind === 'red-line')
+        return { action: 'red-line', next: COMPACT_CMD };
+    if (kind === 'pre-compact')
+        return { action: 'auto-compact-now', next: COMPACT_CMD };
+    return { action: kind === 'none' ? 'ok' : 'soft-warn', next: null };
+}
+/** Slice H4: the labels `context-now` prints, read out of the table for the mode
+ *  in force — the old hard-coded "≥0.85 / ≥0.95 / 50–85%" told a 24h operator
+ *  the wrong lines. `*Ratio` is the `0.85` form `gateModeNotice` uses. */
+function contextNowBandLabels(mode) {
+    const pct = (r) => `${(r * 100).toFixed(0)}`;
+    const pre = thresholdFor(mode, 'preCompact');
+    const red = thresholdFor(mode, 'redLine');
+    return {
+        softWarn: pct(AUTO_COMPACT_SOFT_WARN_RATIO),
+        preCompact: pct(pre),
+        redLine: pct(red),
+        preCompactRatio: pre.toFixed(2),
+        redLineRatio: red.toFixed(2)
+    };
+}
 /**
  * Adapt `runAutoCompact`'s domain result to a `ResultEnvelope`.
  *
@@ -55,7 +95,14 @@ export function buildAutoCompactEnvelope(result) {
     // `fail()` hard-codes `warnings: []`, so the warning is spread back over it —
     // a refused write can disagree with the ratio just as easily on the failure
     // path, and the state does not become less true because the dispatch failed.
-    return { ...fail('code.auto-compact', result.code, result.message, data, [...nextActions]), warnings };
+    return {
+        ...fail('code.auto-compact', result.code, result.message, data, [...nextActions]),
+        warnings
+    };
+}
+function printPostCompactNoActiveSession(io, opts) {
+    printResult(io, fail('code.post-compact-detect', 'NO_ACTIVE_SESSION', 'no active session id; pass --session-id or set presence via `peaks skill presence:set peaks-code`', null, ['Re-run with --session-id <sid>']), opts.json);
+    process.exitCode = 1;
 }
 export function registerCodeRuntimeCommands(code, io) {
     addJsonOption(code
@@ -69,8 +116,7 @@ export function registerCodeRuntimeCommands(code, io) {
         try {
             const sessionId = opts.sessionId ?? readActiveSid(opts.project);
             if (sessionId === null) {
-                printResult(io, fail('code.post-compact-detect', 'NO_ACTIVE_SESSION', 'no active session id; pass --session-id or set presence via `peaks skill presence:set peaks-code`', null, ['Re-run with --session-id <sid>']), opts.json);
-                process.exitCode = 1;
+                printPostCompactNoActiveSession(io, opts);
                 return;
             }
             const probe = await detectPostCompactResume({
@@ -161,7 +207,7 @@ export function registerCodeRuntimeCommands(code, io) {
                             // projects.
                             const out = probeInFlightBatch({ now: new Date().toISOString(), graphs: [] });
                             return out.inFlightBatch === true;
-                        },
+                        }
                     }
                     : {}),
                 force: opts.force === true,
@@ -191,14 +237,14 @@ export function registerCodeRuntimeCommands(code, io) {
     });
     addJsonOption(code
         .command('context-now')
-        .description('v2.13.0 AC-1: read the active IDE adapter\'s context-fill % ' +
+        .description("v2.13.0 AC-1: read the active IDE adapter's context-fill % " +
         'without requiring the LLM to pass --prompt-size <bytes> manually. ' +
         'Adapter-driven (no hard-coded IDE names): Claude Code is the MVP ' +
         'implementation; trae / codex / cursor / qoder / tongyi-lingma / ' +
         'hermes / openclaw register their own env-var via IdeAdapter.compact. ' +
-        'v3.1.2 / 2026-09-12: ≥0.85 emits action=auto-compact-now ' +
-        '(MANDATORY in every mode — single-rid included) and ' +
-        '≥0.95 emits action=red-line (the installed PreToolUse hook re-runs ' +
+        "v3.1.2 / 2026-09-12: the mode's pre-compact line emits " +
+        'action=auto-compact-now (MANDATORY, single-rid included) and ' +
+        'the red line emits action=red-line (the installed PreToolUse hook re-runs ' +
         'this command on the next Bash/Task tool call; nothing is blocked). ' +
         '--enforce-job-mode only changes the reported `jobMode` label; ' +
         'the thresholds are identical. ' +
@@ -296,42 +342,30 @@ export function registerCodeRuntimeCommands(code, io) {
             });
             const witnessNotice = describeHarnessWitness(harnessWitness);
             const ratioPct = (probe.ratio * 100).toFixed(1);
-            let action = 'ok';
-            let next = null;
-            if (probe.ratio >= 0.95) {
-                action = 'red-line';
-                next = 'peaks code auto-compact';
-            }
-            else if (probe.ratio >= 0.85) {
-                // Slice 2026-09-12-compact-band-policy (defect A): the
-                // 0.85–0.95 band is MANDATORY auto-compact for single-rid
-                // sessions too. It used to be downgraded to `soft-warn` here,
-                // which contradicted this command's own help text, the
-                // `pre-compact` action from `peaks skill presence`, the
-                // peaks-code SKILL.md, and the 2026-07-27 user-calibrated
-                // threshold policy — and left an LLM that follows the "single
-                // source of truth" (`context-now`) never compacting in the
-                // zone, violating the zero-pause contract.
-                action = 'auto-compact-now';
-                next = 'peaks code auto-compact';
-            }
-            else if (probe.ratio >= 0.5) {
-                action = 'soft-warn';
-            }
-            const verdict = action === 'red-line' ? 'red-line'
-                : action === 'auto-compact-now' ? 'pre-compact'
-                    : action === 'soft-warn' ? 'soft-warn'
-                        : 'ok';
-            // Slice 2026-09-12-compact-band-policy: the two modes no longer
-            // differ in behaviour ABOVE 0.50 — both auto-fire at ≥0.85 and
-            // both red-line at ≥0.95 — so the old "advisory mode
-            // (single-rid)" notice was a lie the moment the downgrade was
-            // removed. Job mode's remaining difference is that its threshold
-            // policy is recorded up front (`job-shape.json`), which the
-            // `jobMode` field already reports. The notice now says only that.
+            // Slice H4 (rid=h4-context-now-mode-blind): ONE table, ONE mode
+            // resolver. The hard-coded ladder that used to live here (≥0.95 / ≥0.85
+            // / ≥0.5) read no mode at all, so on a 24h run (`partial` =
+            // 0.65/0.70/0.85) it answered `soft-warn` + `next: null` across
+            // [0.70, 0.85) — the band in which `peaks code auto-compact` had
+            // already decided to compact. SKILL.md calls THIS command the "single
+            // source of truth", so an LLM obeying it did nothing.
+            const compactMode = resolveAutoCompactProfile(canonicalProjectRoot);
+            const decided = contextNowActionFor(probe.ratio, compactMode);
+            const action = decided.action;
+            const next = decided.next;
+            const verdict = action === 'red-line'
+                ? 'red-line'
+                : action === 'auto-compact-now'
+                    ? 'pre-compact'
+                    : action;
+            const bands = contextNowBandLabels(compactMode);
+            // Slice H4: the text here used to claim "the two modes no longer differ
+            // in behaviour ABOVE 0.50 — both auto-fire at ≥0.85 and both red-line at
+            // ≥0.95". That was false: `partial` fires at 0.70, red-lines at 0.85.
+            // The lines now come from the table for the mode in force.
             const gateModeNotice = isJobMode
-                ? 'Job mode (job-shape.json isJob=true): the same ≥0.85 / ≥0.95 thresholds apply, and the decision is recorded in job-shape.json.'
-                : 'Single-rid mode: the same ≥0.85 / ≥0.95 thresholds apply — ≥0.85 is MANDATORY auto-compact, not advisory.';
+                ? `Job mode (job-shape.json isJob=true): the same ≥${bands.preCompactRatio} / ≥${bands.redLineRatio} thresholds apply, and the decision is recorded in job-shape.json.`
+                : `Single-rid mode: the same ≥${bands.preCompactRatio} / ≥${bands.redLineRatio} thresholds apply — ≥${bands.preCompactRatio} is MANDATORY auto-compact, not advisory.`;
             printResult(io, ok('code.context-now', {
                 ratio: probe.ratio,
                 ratioPct: `${ratioPct}%`,
@@ -366,12 +400,12 @@ export function registerCodeRuntimeCommands(code, io) {
                 ...(witnessNotice === null ? [] : [witnessNotice])
             ], [
                 action === 'red-line'
-                    ? `RED LINE: ≥ 95%. Next: \`${next}\` — peaks-loop asks the harness to compact and KEEPS WORKING (dispatch is not blocked); re-probe to confirm it landed.`
+                    ? `RED LINE: ≥ ${bands.redLine}%. Next: \`${next}\` — peaks-loop asks the harness to compact and KEEPS WORKING (dispatch is not blocked); re-probe to confirm it landed.`
                     : action === 'auto-compact-now'
-                        ? `MANDATORY auto-compact (≥85%, every mode). Code MUST call \`${next}\` WITHOUT confirmation.`
+                        ? `MANDATORY auto-compact (≥${bands.preCompact}%, every mode). Code MUST call \`${next}\` WITHOUT confirmation.`
                         : action === 'soft-warn'
-                            ? `Soft warn (50–85%). Continue working; the next \`peaks code auto-compact\` will re-check.`
-                            : `Below 50%. No action required.`,
+                            ? `Soft warn (${bands.softWarn}–${bands.preCompact}%). Continue working; the next \`peaks code auto-compact\` will re-check.`
+                            : `Below ${bands.softWarn}%. No action required.`,
                 gateModeNotice,
                 // Single wording, shared with `peaks code auto-compact` — see
                 // `describeHarnessWindowSync`.
@@ -383,7 +417,9 @@ export function registerCodeRuntimeCommands(code, io) {
                 // the same split, and note this one never asks a question.
                 ...(witnessNotice === null
                     ? []
-                    : ['Re-probe with `peaks code context-now` to confirm; this is reported, not blocking.'])
+                    : [
+                        'Re-probe with `peaks code context-now` to confirm; this is reported, not blocking.'
+                    ])
             ]), 
             // Slice 2026-09-13-auto-compact-trigger-ownership: was hard-coded
             // `true`, which made the declared `--json` flag a no-op and left the
@@ -412,10 +448,10 @@ export function registerCodeRuntimeCommands(code, io) {
     // `available:false` with a reason and NEVER sets a non-zero exit code.
     addJsonOption(code
         .command('context-audit')
-        .description('Slice 2026-09-10 Slice A: report what fills the current session\'s ' +
+        .description("Slice 2026-09-10 Slice A: report what fills the current session's " +
         'context window, grouped by tool + short input key (command line / ' +
-        'path tail / pattern), sorted by bytes. Locates the CURRENT session\'s ' +
-        'IDE transcript through the active adapter\'s ' +
+        "path tail / pattern), sorted by bytes. Locates the CURRENT session's " +
+        "IDE transcript through the active adapter's " +
         '`compact.resolveTranscriptPath` (vendor-neutral); emits total bytes, ' +
         'entry count, and the top-N groups ' +
         '(`{tool, key, bytes, pctOfTotal, count}`). Read-only and fail-soft — ' +
@@ -434,13 +470,17 @@ export function registerCodeRuntimeCommands(code, io) {
             const result = auditContext({
                 outerSessionId: outerSessionId ?? null,
                 ...(opts.top !== undefined ? { topN: opts.top } : {}),
-                ...(opts.transcript !== undefined ? { transcriptPath: opts.transcript } : {}),
+                ...(opts.transcript !== undefined ? { transcriptPath: opts.transcript } : {})
             });
             // Fail-soft contract: unavailability is DATA, not an error. The exit
             // code stays 0 so a `context-audit` call can never block a workflow.
             const nextActions = result.available
-                ? [`${result.entryCount} tool result(s) across ${result.groupCount} group(s); showing top ${result.entries.length}.`]
-                : [`context-audit unavailable: ${result.reason ?? 'unknown'} — continue without it (read-only probe).`];
+                ? [
+                    `${result.entryCount} tool result(s) across ${result.groupCount} group(s); showing top ${result.entries.length}.`
+                ]
+                : [
+                    `context-audit unavailable: ${result.reason ?? 'unknown'} — continue without it (read-only probe).`
+                ];
             printResult(io, ok('code.context-audit', { ...result }, [], nextActions), opts.json);
         }
         catch (err) {
@@ -482,9 +522,7 @@ export function registerCodeRuntimeCommands(code, io) {
                     mode: 'no-session',
                     decision: null,
                     nextSlice: null
-                }, [], [
-                    'No active session id; gate passes through (single-rid mode).'
-                ]);
+                }, [], ['No active session id; gate passes through (single-rid mode).']);
                 printResult(io, envelope, opts.json);
                 return;
             }
@@ -524,10 +562,7 @@ export function registerCodeRuntimeCommands(code, io) {
                     mode: 'single',
                     decision: null,
                     nextSlice: null
-                }, [], [
-                    'job-shape.json says isJob=false; single-rid mode (gate allows).',
-                    ...hintActions
-                ]);
+                }, [], ['job-shape.json says isJob=false; single-rid mode (gate allows).', ...hintActions]);
                 printResult(io, envelope, opts.json);
                 return;
             }
@@ -584,9 +619,7 @@ export function registerCodeRuntimeCommands(code, io) {
         try {
             const sessionId = opts.sessionId ?? readActiveSid(opts.project);
             if (sessionId === null) {
-                const envelope = ok('code.emit-handoff', { allow: true, mode: 'no-session' }, [], [
-                    'No active session id; gate passes through (single-rid mode).'
-                ]);
+                const envelope = ok('code.emit-handoff', { allow: true, mode: 'no-session' }, [], ['No active session id; gate passes through (single-rid mode).']);
                 printResult(io, envelope, opts.json);
                 return;
             }
@@ -600,16 +633,12 @@ export function registerCodeRuntimeCommands(code, io) {
                 evalInput.forceUnderJob = true;
             const verdict = evaluateEmitHandoff(evalInput);
             if (verdict.kind === 'allow-not-job') {
-                const envelope = ok('code.emit-handoff', { allow: true, mode: 'single' }, [], [
-                    'job-shape.json says isJob=false (or absent); normal handoff allowed.'
-                ]);
+                const envelope = ok('code.emit-handoff', { allow: true, mode: 'single' }, [], ['job-shape.json says isJob=false (or absent); normal handoff allowed.']);
                 printResult(io, envelope, opts.json);
                 return;
             }
             if (verdict.kind === 'allow-done') {
-                const envelope = ok('code.emit-handoff', { allow: true, mode: 'job-done', remaining: verdict.remaining }, [], [
-                    `Job is complete (remaining=0); handoff allowed.`
-                ]);
+                const envelope = ok('code.emit-handoff', { allow: true, mode: 'job-done', remaining: verdict.remaining }, [], [`Job is complete (remaining=0); handoff allowed.`]);
                 printResult(io, envelope, opts.json);
                 return;
             }
@@ -621,7 +650,9 @@ export function registerCodeRuntimeCommands(code, io) {
                 return;
             }
             if (verdict.kind === 'block-not-initialized') {
-                const envelope = fail('code.emit-handoff', JOB_NOT_INITIALIZED, `Job ${verdict.jobId} has no state.json; peaks job init was skipped.`, { jobId: verdict.jobId }, [`Run \`peaks job init --job-id ${verdict.jobId} --slice-list <...>\` before emitting handoff.`]);
+                const envelope = fail('code.emit-handoff', JOB_NOT_INITIALIZED, `Job ${verdict.jobId} has no state.json; peaks job init was skipped.`, { jobId: verdict.jobId }, [
+                    `Run \`peaks job init --job-id ${verdict.jobId} --slice-list <...>\` before emitting handoff.`
+                ]);
                 printResult(io, envelope, opts.json);
                 process.exitCode = 1;
                 return;
@@ -656,7 +687,8 @@ function readActiveSid(projectRoot) {
             return null;
         return presence.sessionId ?? null;
     }
-    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;
     }
 }

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

@@ -134,9 +134,7 @@ async function runCodegraphRepairCommand(io, options, asJson, mode) {
     // in the third slot reads as a problem — and a real warning parked
     // there double-prefixes. Confirmations go to `nextActions`; only a
     // genuine `report.warning` reaches `warnings`, verbatim.
-    const confirmations = [
-        report.applied ? appliedRepairNote(report) : spec.noopNote
-    ];
+    const confirmations = [report.applied ? appliedRepairNote(report) : spec.noopNote];
     if (report.applied || mode === 'index') {
         confirmations.push('Re-run `peaks codegraph status --project <root>` to confirm the gap is closed.');
     }
@@ -525,8 +523,12 @@ async function runCodegraphAffectedCommand(io, files, options, asJson) {
     }
 }
 export function registerCodegraphCommands(program, io) {
-    const codegraph = program.command('codegraph').description('Run upstream codegraph commands through the Peaks launcher');
-    addProjectOption(codegraph.command('status').description('Show codegraph status, including the exclude integrity gate')).action((options) => runCodegraphStatusCommand(io, options, options.peaksJson));
+    const codegraph = program
+        .command('codegraph')
+        .description('Run upstream codegraph commands through the Peaks launcher');
+    addProjectOption(codegraph
+        .command('status')
+        .description('Show codegraph status, including the exclude integrity gate')).action((options) => runCodegraphStatusCommand(io, options, options.peaksJson));
     addProjectOption(codegraph
         .command('repair-exclude')
         .description('Normalize the codegraph include list, drop exclude rules that block tracked source files, then rebuild the index')).action((options) => runCodegraphRepairCommand(io, options, options.peaksJson, 'exclude'));
@@ -578,7 +580,10 @@ export function registerCodegraphCommands(program, io) {
             ...(options.maxDepth !== undefined ? { maxDepth: options.maxDepth } : {})
         }, options.peaksJson);
     });
-    addProjectOption(codegraph.command('context').description('Build task context with codegraph').argument('<task>', 'task text')).action(async (task, options) => {
+    addProjectOption(codegraph
+        .command('context')
+        .description('Build task context with codegraph')
+        .argument('<task>', 'task text')).action(async (task, options) => {
         await runCodegraphCommand(io, 'codegraph.context', { subcommand: 'context', project: options.project, task }, options.peaksJson);
     });
     addProjectOption(codegraph

package/dist/cli/commands/codegraph-status-command.js

@@ -113,10 +113,14 @@ async function runCodegraphStatusJson(io, options, integrity, integrityWarning,
         indexIntegritySeverity: indexVerdict === 'gap' ? (strict ? 'error' : 'warning') : null
     };
     if (upstreamFailed) {
-        printResult(io, fail('codegraph.status', 'CODEGRAPH_COMMAND_FAILED', redactSensitiveErrorMessage(upstream.stderr || upstream.stdout || `codegraph exited with code ${String(result.exitCode)}`), data, ['Check the codegraph project path before retrying']), true);
+        printResult(io, fail('codegraph.status', 'CODEGRAPH_COMMAND_FAILED', redactSensitiveErrorMessage(upstream.stderr ||
+            upstream.stdout ||
+            `codegraph exited with code ${String(result.exitCode)}`), data, ['Check the codegraph project path before retrying']), true);
     }
     else if (integrity?.gap === true) {
-        printResult(io, fail('codegraph.status', 'CODEGRAPH_INDEX_INCOMPLETE', `codegraph index is incomplete: ${integrity.excludedTrackedCount} of ${integrity.trackedSourceCount} tracked source files are excluded by ${integrity.rulesToRemove.length} rule(s).`, data, ['Run `peaks codegraph repair-exclude --project <root>` to drop the offending rules and rebuild the index.']), true);
+        printResult(io, fail('codegraph.status', 'CODEGRAPH_INDEX_INCOMPLETE', `codegraph index is incomplete: ${integrity.excludedTrackedCount} of ${integrity.trackedSourceCount} tracked source files are excluded by ${integrity.rulesToRemove.length} rule(s).`, data, [
+            'Run `peaks codegraph repair-exclude --project <root>` to drop the offending rules and rebuild the index.'
+        ]), true);
     }
     else if (indexVerdict === 'not-evaluated') {
         // Distinct from the `ok` branch below on purpose: this axis produced

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;