peaks-loop 4.1.0 → 4.1.2

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

@@ -15,7 +15,6 @@
  *   - `peaks code should-pause --step <step> --mode <mode>` (D5)
  *   - `peaks code post-compact-detect --project <path>` (D7)
  *
- * rid-024: 7 sub-commands extracted into 3 sibling files:
  *   - code-mode-gate-commands.ts (plan + should-pause)
  *   - code-job-shape-commands.ts (detect-job + read-job-shape)
  *   - code-runtime-commands.ts (post-compact-detect + auto-compact + context-now + gate-step-08 + emit-handoff)
@@ -106,8 +105,6 @@ export async function runCodeFast(opts) {
  * CLI command is a thin surface that builds the plan and emits a JSON
  * envelope for downstream tooling.
  *
- * rid-024: this function is now a thin orchestrator that delegates to 3
- * sibling register functions + the rid-020b run register.
  */
 export function registerCodeCommands(program, io) {
     const code = program

package/dist/cli/commands/code-gate-command.d.ts

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-06-codegate-vendor-neutral — `peaks code-gate` CLI command.
  *
  * Vendor-neutral PreToolUse hook entry. Reads the standard hook JSON
  * payload from stdin (`{tool, input}` shape) and either exits 0

package/dist/cli/commands/code-gate-command.js

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-06-codegate-vendor-neutral — `peaks code-gate` CLI command.
  *
  * Vendor-neutral PreToolUse hook entry. Reads the standard hook JSON
  * payload from stdin (`{tool, input}` shape) and either exits 0

package/dist/cli/commands/code-job-shape-commands-read-job-shape.d.ts

@@ -1,5 +1,4 @@
 /**
- * Slice rid-024 — `peaks code read-job-shape`.
  *
  * Extracted from code-job-shape-commands.ts (C wave 4 near-cap split). Owns:
  * read-job-shape (read + print). Command name, options, emitted message text,

package/dist/cli/commands/code-job-shape-commands-read-job-shape.js

@@ -1,5 +1,4 @@
 /**
- * Slice rid-024 — `peaks code read-job-shape`.
  *
  * Extracted from code-job-shape-commands.ts (C wave 4 near-cap split). Owns:
  * read-job-shape (read + print). Command name, options, emitted message text,

package/dist/cli/commands/code-job-shape-commands.d.ts

@@ -1,7 +1,5 @@
 /**
- * Slice rid-024 — `peaks code detect-job` + `peaks code read-job-shape`.
  *
- * Extracted from code-commands.ts (rid-024 split).
  * Owns: detect-job (write JobShapeDecision), read-job-shape (read+print).
  */
 import type { Command } from 'commander';

package/dist/cli/commands/code-job-shape-commands.js

@@ -1,7 +1,5 @@
 /**
- * Slice rid-024 — `peaks code detect-job` + `peaks code read-job-shape`.
  *
- * Extracted from code-commands.ts (rid-024 split).
  * Owns: detect-job (write JobShapeDecision), read-job-shape (read+print).
  */
 import { existsSync, readFileSync } from 'node:fs';
@@ -131,7 +129,6 @@ export function registerCodeJobShapeCommands(code, io) {
     // `catch` is not duplicated into a second silent-swallow site.
     registerCodeJobShapeReadCommand(code, io, readActiveSidForJobShape);
 }
-// Local helper (was `readActiveSid` in code-commands.ts before rid-024 split).
 // Both detect-job and read-job-shape need to read the active sid from
 // presence. We re-import getSkillPresence here to avoid the cross-file
 // helper import.

package/dist/cli/commands/code-mode-gate-commands.d.ts

@@ -1,7 +1,5 @@
 /**
- * Slice rid-024 — `peaks code plan` + `peaks code should-pause` (mode-gate).
  *
- * Extracted from code-commands.ts (rid-024 split).
  * Owns: `plan` (build+print CodePlan), `should-pause` (D5 mode-gate).
  *
  * Slice c1-eslint-family-sweep / leaf c4w1-cli-b: the two sub-command

package/dist/cli/commands/code-mode-gate-commands.js

@@ -1,7 +1,5 @@
 /**
- * Slice rid-024 — `peaks code plan` + `peaks code should-pause` (mode-gate).
  *
- * Extracted from code-commands.ts (rid-024 split).
  * Owns: `plan` (build+print CodePlan), `should-pause` (D5 mode-gate).
  *
  * Slice c1-eslint-family-sweep / leaf c4w1-cli-b: the two sub-command
@@ -25,7 +23,6 @@ export function registerCodeModeGateCommands(code, io) {
     registerCodeModePlan(code);
     registerCodeModeShouldPause(code, io, readActiveSidForModeGate);
 }
-// Local helper (was `readActiveSid` in code-commands.ts before rid-024 split).
 // The mode-gate stale-presence check needs the active sid for the
 // observability event; `getSkillPresence` is imported at the top of the file
 // alongside `checkStalePresence` to keep imports deduplicated.

package/dist/cli/commands/code-mode-gate-should-pause-command.js

@@ -15,7 +15,6 @@ export function registerCodeModeShouldPause(code, io, readActiveSid) {
         'even if the user passed --mode full-auto. The re-ask is mandatory — sticky-mode from a previous ' +
         'session is NOT authoritative.')
         .requiredOption('--step <step>', `one of: ${GATED_STEPS.join(', ')}`)
-        // v2.18.4 slice 002-fix-first-run-step-gates (Bug 2):
         // `--mode` is now OPTIONAL. Step 1's SEMANTIC is "ask the user
         // what mode to use" — requiring --mode to ask mode is a
         // chicken-and-egg. When --mode is omitted, default to
@@ -67,7 +66,7 @@ function validateModeAndStep(opts) {
     if (!GATED_STEPS.includes(opts.step)) {
         return {
             ok: false,
-            envelope: fail('code.should-pause', 'INVALID_STEP', `step must be one of the 14 GATED_STEPS (got "${opts.step}")`, { provided: opts.step, allowed: [...GATED_STEPS] }, ['Pass --step <one of the 14 GATED_STEPS>'])
+            envelope: fail('code.should-pause', 'INVALID_STEP', `step must be one of the ${GATED_STEPS.length} GATED_STEPS (got "${opts.step}")`, { provided: opts.step, allowed: [...GATED_STEPS] }, [`Pass --step <one of the ${GATED_STEPS.length} GATED_STEPS>`])
         };
     }
     return { ok: true, mode, step: opts.step };
@@ -80,7 +79,6 @@ function validateHardFloorAndCommitBoundary(opts) {
             envelope: fail('code.should-pause', 'INVALID_HARD_FLOOR', `hard-floor must be one of: irreversible-external-side-effect | authentication-credential | multi-day-investment | commit-boundary-side-effect (got "${hardFloor}")`, { provided: hardFloor }, ['Omit --hard-floor or pass a valid category'])
         };
     }
-    // v2.15.0 slice 002 repair (QA blocker): validate the
     // --commit-boundary-action flag at the CLI boundary. The
     // service-layer `shouldPauseAtGate` accepts a boolean
     // `commitBoundaryAction: true`; this flag tells the CLI to
@@ -96,7 +94,6 @@ function validateHardFloorAndCommitBoundary(opts) {
     return { ok: true, hardFloor, commitBoundaryActionId };
 }
 /**
- * Slice 002 (v2.15.0) AC-2: when the caller is asking about Step 1 AND the
  * recorded presence is stale, the CLI overrides the gate decision to PAUSE.
  * Returns `null` when the check does not apply (not a swallow — no catch, no
  * error path, just the branch HEAD did not take).
@@ -110,7 +107,6 @@ function resolveStalePresence(opts) {
 }
 function runShouldPauseAction(io, opts, readActiveSid) {
     try {
-        // v2.18.4 slice 002-fix-first-run-step-gates (Bug 2):
         // --mode is optional. Default to 'full-auto' when omitted
         // so step-1-mode-select can run without forcing the caller
         // to know the mode up front. The gate's hard-pause on

package/dist/cli/commands/code-mode-gate-should-pause-envelope.d.ts

@@ -49,7 +49,6 @@ type HandleDecisionArgs = {
  * (full-auto must never fail-loud). projectRoot resolution mirrors
  * observability-commands.ts (findProjectRoot → cwd fallback).
  *
- * v2.15.0 slice 002 repair (QA blocker): translate the CLI
  * --commit-boundary-action flag into the service-layer boolean. The CLI accepts
  * the action id (e.g. "git-push") for ergonomic machine consumption; the
  * service layer only cares that *some* commit-boundary action triggered the

package/dist/cli/commands/code-mode-gate-should-pause-envelope.js

@@ -76,7 +76,6 @@ function printStalePresenceEnvelope(args) {
  * (full-auto must never fail-loud). projectRoot resolution mirrors
  * observability-commands.ts (findProjectRoot → cwd fallback).
  *
- * v2.15.0 slice 002 repair (QA blocker): translate the CLI
  * --commit-boundary-action flag into the service-layer boolean. The CLI accepts
  * the action id (e.g. "git-push") for ergonomic machine consumption; the
  * service layer only cares that *some* commit-boundary action triggered the
@@ -123,7 +122,6 @@ function emitModeGateDecision(args) {
     }, { projectRoot });
 }
 /**
- * v2.15.0 slice 002 repair: include the commit-boundary
  * action id in the envelope (when provided) so the LLM-side
  * caller can echo which boundary was checked. Null when no
  * --commit-boundary-action flag was passed.

package/dist/cli/commands/code-mode-status-command.d.ts

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-09-09-mode-consolidation (Slice D) — `peaks code mode status`.
  *
  * One read for the whole stacked autonomy picture:
  *   - presence MODE (`full-auto | assisted | strict | 24h`),

package/dist/cli/commands/code-mode-status-command.js

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-09-09-mode-consolidation (Slice D) — `peaks code mode status`.
  *
  * One read for the whole stacked autonomy picture:
  *   - presence MODE (`full-auto | assisted | strict | 24h`),

package/dist/cli/commands/code-orchestrator-can-do.d.ts

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-05-orchestrator-can-do-probe — CLI shim for
  * `peaks code orchestrator-can-do`.
  *
  * Thin entry point that wires the `orchestrator-can-do` subcommand

package/dist/cli/commands/code-orchestrator-can-do.js

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-05-orchestrator-can-do-probe — CLI shim for
  * `peaks code orchestrator-can-do`.
  *
  * Thin entry point that wires the `orchestrator-can-do` subcommand

package/dist/cli/commands/code-run-command.js

@@ -72,7 +72,6 @@ export function registerCodeRunCommand(code, io) {
                 enteredFrom: current.state,
                 exitCondition: null
             });
-            // Slice 2026-09-09-mode-consolidation (Slice B): auto-engage is the
             // ONLY path allowed to set a mode without a user pick, and `24h` is
             // the only mode it may set. Stamp it onto the in-flight presence
             // lease so the mode gate / statusline / `peaks code mode status`

package/dist/cli/commands/code-runtime-commands.d.ts

@@ -1,12 +1,9 @@
 /**
- * Slice rid-024 — runtime probes: post-compact-detect / auto-compact /
  * context-now / context-audit / gate-step-08 / emit-handoff.
  *
- * Extracted from code-commands.ts (rid-024 split).
  * Owns: 6 sub-commands that read or mutate runtime state.
  * Owns the `readActiveSid` helper (only used by these runtime probes).
  *
- * Slice 2026-09-10-context-audit-and-discipline added `context-audit`
  * (what fills the window, grouped by tool + short input key).
  */
 import type { Command } from 'commander';

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

@@ -1,12 +1,9 @@
 /**
- * Slice rid-024 — runtime probes: post-compact-detect / auto-compact /
  * context-now / context-audit / gate-step-08 / emit-handoff.
  *
- * Extracted from code-commands.ts (rid-024 split).
  * Owns: 6 sub-commands that read or mutate runtime state.
  * Owns the `readActiveSid` helper (only used by these runtime probes).
  *
- * Slice 2026-09-10-context-audit-and-discipline added `context-audit`
  * (what fills the window, grouped by tool + short input key).
  */
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
@@ -158,7 +155,6 @@ export function registerCodeRuntimeCommands(code, io) {
         // Accepted and inert. There is no longer a 95% gate to skip: peaks-loop
         // cannot compact a running session, so the red line never blocked
         // dispatch and `bypassRedLine` is read by nothing (slice
-        // 2026-09-13-auto-compact-trigger-ownership, T3/A1). The flag is KEPT
         // rather than deleted because it is a published CLI surface — deleting it
         // would make an existing caller fail on an unknown option, which is a
         // harder break than a no-op — and because the honest fix here is to stop
@@ -258,7 +254,6 @@ export function registerCodeRuntimeCommands(code, io) {
         .option('--prompt-size <bytes>', 'override the bytes-from-env path; takes priority over env / statusline / transcript. Useful when CLAUDE_CONTEXT_USAGE_PERCENT is absent (e.g. Mac Claude Code).')).action(async (opts) => {
         try {
             const { readContextPercent } = await import('../../services/context/auto-compact-reader.js');
-            // rid-002: parse --prompt-size <bytes> defensively. CLI-layer
             // guard rejects non-finite / negative values; only finite
             // non-negative numbers reach the reader. Undefined → no override.
             let promptSizeBytes;
@@ -306,7 +301,6 @@ export function registerCodeRuntimeCommands(code, io) {
             // host), so calling it twice with the same argument charged the witness
             // read it precedes — 0.027 ms — roughly 4,000x its own cost.
             const canonicalProjectRoot = resolveCanonicalProjectRoot(opts.project);
-            // Slice 2026-09-13-auto-compact-trigger-ownership (T1 + T2): materialize
             // the window this probe just divided by into the harness's own settings,
             // so "85%" here and the harness's own trigger are one point on one
             // scale. Idempotent (no write when the value is already in force) and a
@@ -324,7 +318,6 @@ export function registerCodeRuntimeCommands(code, io) {
             // sentence; this one line rides `warnings` so a JSON consumer cannot
             // miss it either.
             const harnessWindowWarning = harnessWindowSyncWarning(harnessWindow);
-            // Slice 2026-09-13-statusline-window-witness (AC2/AC3): the harness's
             // own number for the same quantity, captured by the statusline. This is
             // OBSERVATION ONLY — it never feeds `verdict` / `action` / any threshold
             // below. A wrong reading here must not be able to fire a compact.
@@ -359,7 +352,6 @@ export function registerCodeRuntimeCommands(code, io) {
                     ? '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.
@@ -379,18 +371,15 @@ export function registerCodeRuntimeCommands(code, io) {
                 rawBytes: probe.rawBytes ?? null,
                 rawTokens: probe.rawTokens ?? null,
                 capacityTokens: probe.capacityTokens ?? null,
-                // Slice 2026-09-09-context-window-override: which layer produced
                 // capacityTokens (env-override | config | model-heuristic |
                 // default) — null for byte/percent sources, which have no window.
                 capacitySource: probe.capacitySource ?? null,
                 bytesPrompt: promptSizeBytes ?? null,
                 capturedAt: probe.capturedAt,
-                // Slice 2026-09-13-auto-compact-trigger-ownership: what the harness
                 // window sync did on this probe. Reported rather than silent — the
                 // harness tells a user who overrides the window only via
                 // `/autocompact`, so peaks-loop must be the one that says it.
                 harnessWindow,
-                // Slice 2026-09-13-statusline-window-witness: the second scale.
                 harnessWitness
             }, [
                 ...(harnessWindowWarning === null ? [] : [harnessWindowWarning]),
@@ -421,7 +410,6 @@ export function registerCodeRuntimeCommands(code, io) {
                         '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
             // human with raw JSON and no `next:` lines — so a person running this
             // command could not see that peaks-loop had just written their
@@ -441,7 +429,6 @@ export function registerCodeRuntimeCommands(code, io) {
             process.exitCode = 1;
         }
     });
-    // Slice 2026-09-10-context-audit-and-discipline (Slice A): visibility into
     // WHAT fills the orchestrator window. `context-now` returns a ratio; this
     // returns the grouped byte breakdown of tool results from the live
     // transcript. Read-only + fail-soft: an unavailable transcript reports
@@ -526,7 +513,6 @@ export function registerCodeRuntimeCommands(code, io) {
                 printResult(io, envelope, opts.json);
                 return;
             }
-            // Slice 2026-09-10-three-fixes (Slice 2): proactive context-consumer
             // hint. Runs ONLY when the window is ≥ 0.70 full, caches the audit
             // result for ≥ 5 min so the transcript is scanned at most once per
             // TTL window, and is fail-soft (null → no extra line). It never
@@ -677,7 +663,6 @@ export function registerCodeRuntimeCommands(code, io) {
         }
     });
 }
-// Local helper (was `readActiveSid` in code-commands.ts before rid-024 split).
 // Only the 5 runtime probes above use it; keeping it local avoids the
 // cross-file helper import.
 function readActiveSid(projectRoot) {

package/dist/cli/commands/codegraph-command-runtime.d.ts

@@ -1,4 +1,5 @@
 import { type CodegraphInvocationOptions } from '../../services/codegraph/codegraph-service.js';
+export { rewriteSqliteBackendAdvice } from '../../services/codegraph/codegraph-backend-advice.js';
 import { type ProgramIO } from '../cli-helpers.js';
 export interface CommonCodegraphOptions {
     project: string;
@@ -15,6 +16,11 @@ export declare function printCodegraphFailure(io: ProgramIO, command: string, er
  * untouched.
  */
 export declare function rewriteBareCodegraphHints(text: string): string;
+/**
+ * Both localizations upstream output needs before it reaches the reader, in
+ * the order the shipped pipeline applies them.
+ */
+export declare function localizeUpstreamCodegraphText(text: string): string;
 /**
  * Proxy one upstream invocation. Returns whether UPSTREAM FAILED — the
  * caller needs that to rank the exit-code precedence (an upstream failure

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

@@ -1,20 +1,25 @@
 // src/cli/commands/codegraph-command-runtime.ts
 //
 // Shared invocation runtime for every `peaks codegraph <verb>`: the option
-// shape they all extend, the failure envelope they all print, the hint
-// rewriter that keeps upstream's bare `codegraph …` hints runnable, and the
-// upstream proxy itself.
+// shape they all extend, the failure envelope they all print, the two text
+// localizations upstream output needs before it reaches the reader (bare
+// `codegraph …` hints, and the SQLite-backend advice for a dependency this
+// project removed), and the upstream proxy itself.
 //
 // Extracted verbatim from `codegraph-commands.ts` (rid
-// 2026-09-17-oversize-and-scale, D1 — the 800-line file-size cap). Every moved
 // line is byte-identical and no behaviour changed; `codegraph-commands.ts`
-// re-exports `rewriteBareCodegraphHints` so the public surface is stable.
+// re-exports the hint rewriter so its public surface is stable.
 //
 // This module is the BOTTOM of the codegraph CLI's import graph. It must not
 // import `codegraph-commands.ts` or `codegraph-status-command.ts`, or the
 // extraction would introduce a cycle.
+import { rewriteSqliteBackendAdvice } from '../../services/codegraph/codegraph-backend-advice.js';
 import { createCodegraphInvocation, executeCodegraphInvocation } from '../../services/codegraph/codegraph-service.js';
 import { fail } from 'peaks-loop-shared/result';
+// Re-exported so the CLI surface keeps serving the tests and callers that
+// import it from here; the implementation lives in the service layer because
+// the failure-note builders need the same matcher and may not import `src/cli`.
+export { rewriteSqliteBackendAdvice } from '../../services/codegraph/codegraph-backend-advice.js';
 import { getErrorMessage, printResult, redactSensitiveErrorMessage } from '../cli-helpers.js';
 export function printCodegraphFailure(io, command, error, asJson, exitCode = 1) {
     printResult(io, fail(command, 'CODEGRAPH_COMMAND_FAILED', redactSensitiveErrorMessage(getErrorMessage(error)), {}, ['Check the codegraph command options and project path before retrying']), asJson);
@@ -32,6 +37,13 @@ export function printCodegraphFailure(io, command, error, asJson, exitCode = 1)
 export function rewriteBareCodegraphHints(text) {
     return text.replace(/(?<![\w-])(?<!peaks\s)codegraph(?=\s+(?:status|init|index|query|files|context|affected)\b)/g, 'peaks codegraph');
 }
+/**
+ * Both localizations upstream output needs before it reaches the reader, in
+ * the order the shipped pipeline applies them.
+ */
+export function localizeUpstreamCodegraphText(text) {
+    return rewriteSqliteBackendAdvice(rewriteBareCodegraphHints(text));
+}
 /**
  * Proxy one upstream invocation. Returns whether UPSTREAM FAILED — the
  * caller needs that to rank the exit-code precedence (an upstream failure
@@ -51,9 +63,9 @@ export async function runCodegraphCommand(io, command, options, asJson, attribut
             return true;
         }
         const didFail = result.exitCode !== null && result.exitCode !== 0;
-        const rewritten = rewriteBareCodegraphHints(result.stdout);
+        const rewritten = localizeUpstreamCodegraphText(result.stdout);
         const stdout = attributeStdout === undefined ? rewritten : attributeStdout(rewritten);
-        const stderr = rewriteBareCodegraphHints(result.stderr);
+        const stderr = localizeUpstreamCodegraphText(result.stderr);
         if (stdout.length > 0) {
             io.stdout((didFail ? redactSensitiveErrorMessage(stdout) : stdout).trimEnd());
         }