peaks-loop 4.0.53 → 4.1.0

package/dist/services/config/model-routing.js

@@ -68,7 +68,8 @@ export async function getStrongestModelIdAsync(config, runtimeProbeDisabled = fa
             if (probed && probed.length > 0)
                 return probed;
         }
-        catch { // TODO(g2): best-effort runtime probe — fall through to back-compat default is intentional
+        catch {
+            // TODO(g2): best-effort runtime probe — fall through to back-compat default is intentional
             // best-effort — fall through to back-compat default
         }
     }
@@ -101,5 +102,7 @@ export function getEconomyAwareExecutionModelId(config) {
     // (matches the pre-slice implicit default from DEFAULT_CONFIG.economyMode = true). Only an
     // explicit `economyMode === false` switches execution to the strongest planner/reviewer
     // model (resolved dynamically per Slice 2026-07-09 add-zcode-adapter A.3).
-    return config.economyMode !== false ? getConfiguredExecutionModelId(config.providers) : getStrongestModelId(config);
+    return config.economyMode !== false
+        ? getConfiguredExecutionModelId(config.providers)
+        : getStrongestModelId(config);
 }

package/dist/services/config/proxy-service.js

@@ -3,7 +3,12 @@ const EMPTY_PROXY = { version: SIDECAR_SCHEMA_VERSION, httpProxy: null };
 export function isValidProxyUrl(value) {
     try {
         const url = new URL(value);
-        return (url.protocol === 'http:' || url.protocol === 'https:') && url.username.length === 0 && url.password.length === 0 && url.pathname === '/' && url.search.length === 0 && url.hash.length === 0;
+        return ((url.protocol === 'http:' || url.protocol === 'https:') &&
+            url.username.length === 0 &&
+            url.password.length === 0 &&
+            url.pathname === '/' &&
+            url.search.length === 0 &&
+            url.hash.length === 0);
     }
     catch {
         return false;

package/dist/services/config/workspace-state-service.js

@@ -16,7 +16,10 @@ function isRecord(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
 function sanitizeArtifactRemoteRepo(value) {
-    if (!isRecord(value) || (value.provider !== 'github' && value.provider !== 'gitlab') || typeof value.owner !== 'string' || typeof value.name !== 'string')
+    if (!isRecord(value) ||
+        (value.provider !== 'github' && value.provider !== 'gitlab') ||
+        typeof value.owner !== 'string' ||
+        typeof value.name !== 'string')
         return null;
     if (!isSafeSegment(value.owner) || !isSafeSegment(value.name))
         return null;
@@ -37,7 +40,12 @@ function sanitizeWorkspace(value) {
     if (!isRecord(value))
         return null;
     const { workspaceId, name, rootPath, installedCapabilityIds } = value;
-    if (typeof workspaceId !== 'string' || !isSafeSegment(workspaceId) || typeof name !== 'string' || typeof rootPath !== 'string' || !Array.isArray(installedCapabilityIds) || !installedCapabilityIds.every((id) => typeof id === 'string'))
+    if (typeof workspaceId !== 'string' ||
+        !isSafeSegment(workspaceId) ||
+        typeof name !== 'string' ||
+        typeof rootPath !== 'string' ||
+        !Array.isArray(installedCapabilityIds) ||
+        !installedCapabilityIds.every((id) => typeof id === 'string'))
         return null;
     const artifactRepo = sanitizeArtifactRemoteRepo(value.artifactRepo);
     const artifactStorage = sanitizeArtifactStorage(value.artifactStorage);
@@ -51,7 +59,9 @@ function sanitizeWorkspace(value) {
     };
 }
 function sanitizeWorkspaces(value) {
-    return Array.isArray(value) ? value.map(sanitizeWorkspace).filter((w) => w !== null) : [];
+    return Array.isArray(value)
+        ? value.map(sanitizeWorkspace).filter((w) => w !== null)
+        : [];
 }
 function loadWorkspacesSidecar() {
     const raw = readSidecarJson(workspacesConfigPath(), EMPTY_WORKSPACES);
@@ -103,7 +113,9 @@ export function removeWorkspace(workspaceId) {
     if (idx < 0)
         return false;
     const nextWorkspaces = data.workspaces.filter((w) => w.workspaceId !== workspaceId);
-    const nextCurrent = data.currentWorkspace === workspaceId ? nextWorkspaces[0]?.workspaceId ?? null : data.currentWorkspace;
+    const nextCurrent = data.currentWorkspace === workspaceId
+        ? (nextWorkspaces[0]?.workspaceId ?? null)
+        : data.currentWorkspace;
     saveWorkspacesSidecar({ ...data, workspaces: nextWorkspaces, currentWorkspace: nextCurrent });
     return true;
 }
@@ -126,7 +138,7 @@ function findWorkspaceForPath(workspaces, path) {
     });
     if (matches.length === 0)
         return null;
-    return matches.reduce((best, match) => (match.rootPath.length > best.rootPath.length ? match : best)).workspace;
+    return matches.reduce((best, match) => match.rootPath.length > best.rootPath.length ? match : best).workspace;
 }
 export function getWorkspaceConfigForPath(path) {
     return findWorkspaceForPath(getWorkspaces(), path);

package/dist/services/context/auto-compact-dispatcher-input.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Input types for the IDE-aware compact dispatcher (`auto-compact-dispatcher.ts`).
+ *
+ * Split out of `auto-compact-dispatcher.ts` (file-size cap campaign) so the
+ * dispatcher stays under the raw-line cap. The dispatcher re-exports every
+ * name declared here, so existing importers keep using
+ * `./auto-compact-dispatcher.js` unchanged.
+ */
+export type CompactTarget = 'main' | 'sub-agent';
+export interface DispatchIdeCompactInput {
+    readonly projectRoot: string;
+    readonly sessionId: string;
+    readonly env?: NodeJS.ProcessEnv | undefined;
+    /** Spawn timeout (ms). Default 30s — Claude Code `/compact` is sync. */
+    readonly timeoutMs?: number | undefined;
+    /**
+     * Slice 2026-06-28-code-mode-bypass-fix (defect #4): which session
+     * the compact should target. Default `'main'` — the orchestrator
+     * (peaks-code body) runs in the main-session Claude Code window and
+     * wants to compress *its* context, not a sub-agent's. Sub-agent
+     * shells that spawn their own `peaks code auto-compact` flow pass
+     * `'sub-agent'` to preserve the legacy shell-spawn behaviour.
+     *
+     * Behaviour matrix, keyed on the ADAPTER'S DECLARED pathway only
+     * — never on the adapter's name (slice
+     * 2026-09-12-auto-compact-vendor-neutrality):
+     *   - target='main'     → llm-self-compress (write intent; main LLM
+     *                          fires its compact command on its next turn).
+     *   - target='sub-agent'→ shell-exec stub (DEPRECATED — no host
+     *                          CLI spawn; returns envelope with
+     *                          `pathway: 'shell-exec'` for legacy
+     *                          contract only — see rid-031).
+     * An adapter with no registered `compact` profile returns noop for
+     * BOTH targets; an adapter whose profile serves the main session is
+     * dispatched regardless of which IDE it is.
+     */
+    readonly target?: CompactTarget | undefined;
+}

package/dist/services/context/auto-compact-dispatcher-input.js

@@ -0,0 +1,9 @@
+/**
+ * Input types for the IDE-aware compact dispatcher (`auto-compact-dispatcher.ts`).
+ *
+ * Split out of `auto-compact-dispatcher.ts` (file-size cap campaign) so the
+ * dispatcher stays under the raw-line cap. The dispatcher re-exports every
+ * name declared here, so existing importers keep using
+ * `./auto-compact-dispatcher.js` unchanged.
+ */
+export {};

package/dist/services/context/auto-compact-dispatcher.d.ts

@@ -1,34 +1,6 @@
 import type { CompactDispatchResult } from './auto-compact-types.js';
-export type CompactTarget = 'main' | 'sub-agent';
-export interface DispatchIdeCompactInput {
-    readonly projectRoot: string;
-    readonly sessionId: string;
-    readonly env?: NodeJS.ProcessEnv | undefined;
-    /** Spawn timeout (ms). Default 30s — Claude Code `/compact` is sync. */
-    readonly timeoutMs?: number | undefined;
-    /**
-     * Slice 2026-06-28-code-mode-bypass-fix (defect #4): which session
-     * the compact should target. Default `'main'` — the orchestrator
-     * (peaks-code body) runs in the main-session Claude Code window and
-     * wants to compress *its* context, not a sub-agent's. Sub-agent
-     * shells that spawn their own `peaks code auto-compact` flow pass
-     * `'sub-agent'` to preserve the legacy shell-spawn behaviour.
-     *
-     * Behaviour matrix, keyed on the ADAPTER'S DECLARED pathway only
-     * — never on the adapter's name (slice
-     * 2026-09-12-auto-compact-vendor-neutrality):
-     *   - target='main'     → llm-self-compress (write intent; main LLM
-     *                          fires its compact command on its next turn).
-     *   - target='sub-agent'→ shell-exec stub (DEPRECATED — no host
-     *                          CLI spawn; returns envelope with
-     *                          `pathway: 'shell-exec'` for legacy
-     *                          contract only — see rid-031).
-     * An adapter with no registered `compact` profile returns noop for
-     * BOTH targets; an adapter whose profile serves the main session is
-     * dispatched regardless of which IDE it is.
-     */
-    readonly target?: CompactTarget | undefined;
-}
+import type { CompactTarget, DispatchIdeCompactInput } from './auto-compact-dispatcher-input.js';
+export type { CompactTarget, DispatchIdeCompactInput };
 /**
  * Dispatch compact via the active IDE's registered pathway.
  *

package/dist/services/context/auto-compact-reader-input.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Input type for the auto context-percent probe (`auto-compact-reader.ts`).
+ *
+ * Split out of `auto-compact-reader.ts` (file-size cap campaign) so the reader
+ * stays under the raw-line cap. The reader re-exports every name declared
+ * here, so existing importers keep using `./auto-compact-reader.js` unchanged.
+ */
+export interface ReadContextPercentInput {
+    readonly projectRoot: string;
+    readonly sessionId: string;
+    /**
+     * Outer (harness / IDE) session id — the id the IDE uses to name its
+     * transcript / session files. Resolved by the caller (env signal → bound
+     * session meta) and passed through to the adapter's
+     * `readContextPercentFallback`. Optional: when unresolved, the adapter
+     * fallback returns null → conservative-fallback.
+     */
+    readonly outerSessionId?: string | undefined;
+    readonly env?: NodeJS.ProcessEnv | undefined;
+    /**
+     * Slice 2026-07-31-rid-002: explicit byte count from `--prompt-size <bytes>`.
+     * When set to a finite non-negative number, short-circuits the entire
+     * env / statusline / transcript chain with `source: 'user-overridden'`.
+     * Mac escape hatch — some IDEs (e.g. Claude Code on macOS) do NOT
+     * inject their context-percent env-var into PreToolUse sub-shells, so the
+     * user (or a hook wrapper) can inject the bytes they observed themselves.
+     * Priority P0 — above everything else.
+     */
+    readonly promptSizeBytes?: number | undefined;
+}

package/dist/services/context/auto-compact-reader-input.js

@@ -0,0 +1,8 @@
+/**
+ * Input type for the auto context-percent probe (`auto-compact-reader.ts`).
+ *
+ * Split out of `auto-compact-reader.ts` (file-size cap campaign) so the reader
+ * stays under the raw-line cap. The reader re-exports every name declared
+ * here, so existing importers keep using `./auto-compact-reader.js` unchanged.
+ */
+export {};

package/dist/services/context/auto-compact-reader.d.ts

@@ -1,28 +1,7 @@
 import type { ContextPercentProbe } from './auto-compact-types.js';
 import { type HarnessWindowLocation, type HarnessWindowReadResult, type HarnessWindowSyncResult } from './harness-window-config.js';
-export interface ReadContextPercentInput {
-    readonly projectRoot: string;
-    readonly sessionId: string;
-    /**
-     * Outer (harness / IDE) session id — the id the IDE uses to name its
-     * transcript / session files. Resolved by the caller (env signal → bound
-     * session meta) and passed through to the adapter's
-     * `readContextPercentFallback`. Optional: when unresolved, the adapter
-     * fallback returns null → conservative-fallback.
-     */
-    readonly outerSessionId?: string | undefined;
-    readonly env?: NodeJS.ProcessEnv | undefined;
-    /**
-     * Slice 2026-07-31-rid-002: explicit byte count from `--prompt-size <bytes>`.
-     * When set to a finite non-negative number, short-circuits the entire
-     * env / statusline / transcript chain with `source: 'user-overridden'`.
-     * Mac escape hatch — some IDEs (e.g. Claude Code on macOS) do NOT
-     * inject their context-percent env-var into PreToolUse sub-shells, so the
-     * user (or a hook wrapper) can inject the bytes they observed themselves.
-     * Priority P0 — above everything else.
-     */
-    readonly promptSizeBytes?: number | undefined;
-}
+import type { ReadContextPercentInput } from './auto-compact-reader-input.js';
+export type { ReadContextPercentInput };
 /**
  * Resolve WHERE the harness auto-compact window lives, for the IDE the
  * current env selects. Returns `null` when either half is undeclared:
@@ -113,4 +92,3 @@ export declare function readContextPercent(input: ReadContextPercentInput): Cont
 export declare const _internal: {
     readEnvPercent: typeof readEnvPercent;
 };
-export {};

package/dist/services/context/auto-compact-reader.js

@@ -238,7 +238,10 @@ export function readContextPercent(input) {
             // peaks-loop is the one that wrote it, so the adapter may self-correct
             // its own earlier resolution without ever overruling a human's pin.
             ...(harnessWindowTokens !== undefined
-                ? { harnessWindowTokens, harnessWindowPeakWritten: harnessWindowState?.peakWritten === true }
+                ? {
+                    harnessWindowTokens,
+                    harnessWindowPeakWritten: harnessWindowState?.peakWritten === true
+                }
                 : {})
         });
         if (fallback)

package/dist/services/context/auto-compact-thresholds.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Auto-compact threshold ratios and the `CompactTrigger` decision shape.
+ *
+ * Split out of `auto-compact-types.ts` (file-size cap campaign) so the shared
+ * types module stays under the raw-line cap. `auto-compact-types.ts`
+ * re-exports every name declared here, so existing importers keep using
+ * `./auto-compact-types.js` unchanged.
+ */
+export declare const AUTO_COMPACT_SOFT_WARN_RATIO = 0.5;
+export declare const AUTO_COMPACT_AUTO_FIRE_RATIO = 0.8;
+export declare const AUTO_COMPACT_PRE_COMPACT_RATIO = 0.85;
+export declare const AUTO_COMPACT_RED_LINE_RATIO = 0.95;
+export declare const AUTO_COMPACT_THRESHOLD_RATIO = 0.8;
+/** Single source of truth for "what should we do at ratio X?" */
+export type CompactTrigger = {
+    kind: 'none';
+} | {
+    kind: 'soft-warn';
+    ratio: number;
+    message: string;
+}
+/**
+ * Part 22: auto-fire zone (0.80 ≤ ratio < 0.85). peaks-loop
+ * preempts and runs `peaks code auto-compact` itself
+ * without LLM involvement. The LLM is not asked to "decide";
+ * the toolkit is applied synchronously.
+ */
+ | {
+    kind: 'auto-fire';
+    ratio: number;
+    message: string;
+}
+/**
+ * Pre-compact zone (0.85 ≤ ratio < 0.95): LLM-runner can still
+ * pre-empt the compact for one in-flight sub-agent or one
+ * todo row, but peaks-loop flags this as the last safe
+ * window. Kept for backward compat; in practice peaks-loop
+ * auto-fired at 0.80 already.
+ */
+ | {
+    kind: 'pre-compact';
+    ratio: number;
+    message: string;
+    toolkitReady: true;
+}
+/**
+ * Red line (ratio ≥ 0.95): peaks-loop asks the harness to compact and says
+ * it is waiting. Dispatch is NOT blocked — see `redLineRequested`.
+ */
+ | {
+    kind: 'red-line';
+    ratio: number;
+    message: string;
+};

package/dist/services/context/auto-compact-thresholds.js

@@ -0,0 +1,19 @@
+/**
+ * Auto-compact threshold ratios and the `CompactTrigger` decision shape.
+ *
+ * Split out of `auto-compact-types.ts` (file-size cap campaign) so the shared
+ * types module stays under the raw-line cap. `auto-compact-types.ts`
+ * re-exports every name declared here, so existing importers keep using
+ * `./auto-compact-types.js` unchanged.
+ */
+export const AUTO_COMPACT_SOFT_WARN_RATIO = 0.5;
+// Part 22: auto-fire threshold (was 0.85 pre-compact zone where
+// the LLM had to decide; LLM misjudged 0.85–0.95 and only fired
+// at 0.95, which let the LLM time the run anyway). Lowered to
+// 0.80 so peaks-loop auto-fires compact without LLM involvement
+// — the LLM keeps working, peaks-loop preempts when ratio crosses
+// the new threshold.
+export const AUTO_COMPACT_AUTO_FIRE_RATIO = 0.8;
+export const AUTO_COMPACT_PRE_COMPACT_RATIO = 0.85;
+export const AUTO_COMPACT_RED_LINE_RATIO = 0.95;
+export const AUTO_COMPACT_THRESHOLD_RATIO = AUTO_COMPACT_AUTO_FIRE_RATIO;

package/dist/services/context/auto-compact-types.d.ts

@@ -36,52 +36,8 @@
  * harness — see `harness-window-config.ts`.
  */
 import type { HarnessWindowSyncResult } from './harness-window-config.js';
-export declare const AUTO_COMPACT_SOFT_WARN_RATIO = 0.5;
-export declare const AUTO_COMPACT_AUTO_FIRE_RATIO = 0.8;
-export declare const AUTO_COMPACT_PRE_COMPACT_RATIO = 0.85;
-export declare const AUTO_COMPACT_RED_LINE_RATIO = 0.95;
-export declare const AUTO_COMPACT_THRESHOLD_RATIO = 0.8;
-/** Single source of truth for "what should we do at ratio X?" */
-export type CompactTrigger = {
-    kind: 'none';
-} | {
-    kind: 'soft-warn';
-    ratio: number;
-    message: string;
-}
-/**
- * Part 22: auto-fire zone (0.80 ≤ ratio < 0.85). peaks-loop
- * preempts and runs `peaks code auto-compact` itself
- * without LLM involvement. The LLM is not asked to "decide";
- * the toolkit is applied synchronously.
- */
- | {
-    kind: 'auto-fire';
-    ratio: number;
-    message: string;
-}
-/**
- * Pre-compact zone (0.85 ≤ ratio < 0.95): LLM-runner can still
- * pre-empt the compact for one in-flight sub-agent or one
- * todo row, but peaks-loop flags this as the last safe
- * window. Kept for backward compat; in practice peaks-loop
- * auto-fired at 0.80 already.
- */
- | {
-    kind: 'pre-compact';
-    ratio: number;
-    message: string;
-    toolkitReady: true;
-}
-/**
- * Red line (ratio ≥ 0.95): peaks-loop asks the harness to compact and says
- * it is waiting. Dispatch is NOT blocked — see `redLineRequested`.
- */
- | {
-    kind: 'red-line';
-    ratio: number;
-    message: string;
-};
+export { AUTO_COMPACT_SOFT_WARN_RATIO, AUTO_COMPACT_AUTO_FIRE_RATIO, AUTO_COMPACT_PRE_COMPACT_RATIO, AUTO_COMPACT_RED_LINE_RATIO, AUTO_COMPACT_THRESHOLD_RATIO } from './auto-compact-thresholds.js';
+export type { CompactTrigger } from './auto-compact-thresholds.js';
 /** Caller-side info about sub-agent batches in flight (D6.e). */
 export interface InFlightBatchProbe {
     readonly hasInFlightBatch: boolean;

package/dist/services/context/auto-compact-types.js

@@ -1,14 +1,4 @@
-export const AUTO_COMPACT_SOFT_WARN_RATIO = 0.5;
-// Part 22: auto-fire threshold (was 0.85 pre-compact zone where
-// the LLM had to decide; LLM misjudged 0.85–0.95 and only fired
-// at 0.95, which let the LLM time the run anyway). Lowered to
-// 0.80 so peaks-loop auto-fires compact without LLM involvement
-// — the LLM keeps working, peaks-loop preempts when ratio crosses
-// the new threshold.
-export const AUTO_COMPACT_AUTO_FIRE_RATIO = 0.80;
-export const AUTO_COMPACT_PRE_COMPACT_RATIO = 0.85;
-export const AUTO_COMPACT_RED_LINE_RATIO = 0.95;
-export const AUTO_COMPACT_THRESHOLD_RATIO = AUTO_COMPACT_AUTO_FIRE_RATIO;
+export { AUTO_COMPACT_SOFT_WARN_RATIO, AUTO_COMPACT_AUTO_FIRE_RATIO, AUTO_COMPACT_PRE_COMPACT_RATIO, AUTO_COMPACT_RED_LINE_RATIO, AUTO_COMPACT_THRESHOLD_RATIO } from './auto-compact-thresholds.js';
 /**
  * Old → new map of envelope fields that were renamed but are still emitted
  * under their old name as deprecated aliases.

package/dist/services/context/build-dispatch-system-prompt.js

@@ -352,7 +352,7 @@ export const BINDING_RULE_TOKENS = [
     'do NOT invoke `npx <runner>`',
     '## Test Scope (mandatory)',
     'PEAKS_FULL_TEST=1',
-    'refused',
+    'refused'
 ];
 /**
  * The runner-direct-path tokens: the refusal example, the two direct paths
@@ -371,7 +371,7 @@ export const TEST_RUNNER_RULE_TOKENS = [
     'PB-5',
     '`peaks test --json`',
     'ask the user before assuming a runner',
-    '(Windows-aware)',
+    '(Windows-aware)'
 ];
 /**
  * Return the subset of `tokens` that `text` does NOT contain. Pure; used by

package/dist/services/context/collector.js

@@ -11,7 +11,7 @@ const CollectInputSchema = z.object({
     goal: z.string().min(1),
     project: z.string().min(1),
     depsMode: z.enum(['locked', 'latest']),
-    out: z.string().optional(),
+    out: z.string().optional()
 });
 function classifyKind(path) {
     if (path.includes('/__tests__/') || path.endsWith('.test.ts') || path.endsWith('.test.tsx')) {
@@ -47,7 +47,7 @@ async function scanFiles(root, exclude) {
                 path: rel,
                 kind: classifyKind(relative(root, full)),
                 lines: 0, // computed lazily; full line count is expensive
-                hash: '', // computed lazily via content-hash-cache-pattern
+                hash: '' // computed lazily via content-hash-cache-pattern
             });
         }
     }
@@ -61,7 +61,7 @@ async function readGitStatus(project) {
     return {
         branch: 'main',
         lastCommit: 'unknown',
-        dirty: false,
+        dirty: false
     };
 }
 async function readMemoryEntries(project) {
@@ -76,7 +76,7 @@ async function readMemoryEntries(project) {
             path: join('.peaks/memory', n),
             title: n,
             relevanceScore: 0,
-            excerptHash: '',
+            excerptHash: ''
         }));
     }
     catch {
@@ -110,24 +110,22 @@ async function readDeps(project, depsMode) {
         result[name] = {
             version,
             source: 'package.json',
-            resolved: '', // filled by lockfile parser in a later slice
+            resolved: '' // filled by lockfile parser in a later slice
         };
     }
     return result;
 }
 export async function collectContext(rawInput) {
     const input = CollectInputSchema.parse(rawInput);
-    const exclude = input.out !== undefined
-        ? relative(input.project, input.out).replaceAll('\\', '/')
-        : undefined;
+    const exclude = input.out !== undefined ? relative(input.project, input.out).replaceAll('\\', '/') : undefined;
     const [files, gitStatus, memoryEntries, deps] = await Promise.all([
         scanFiles(input.project, exclude),
         readGitStatus(input.project),
         readMemoryEntries(input.project),
-        readDeps(input.project, input.depsMode),
+        readDeps(input.project, input.depsMode)
     ]);
     return {
         goal: input.goal,
-        collector: { files, gitStatus, memoryEntries, deps },
+        collector: { files, gitStatus, memoryEntries, deps }
     };
 }

package/dist/services/context/context-audit-hint.js

@@ -69,8 +69,10 @@ function readCache(cachePath) {
             tool: typeof parsed.tool === 'string' ? parsed.tool : null,
             key: typeof parsed.key === 'string' ? parsed.key : null,
             bytes: typeof parsed.bytes === 'number' && Number.isFinite(parsed.bytes) ? parsed.bytes : 0,
-            pctOfTotal: typeof parsed.pctOfTotal === 'number' && Number.isFinite(parsed.pctOfTotal) ? parsed.pctOfTotal : 0,
-            count: typeof parsed.count === 'number' && Number.isFinite(parsed.count) ? parsed.count : 0,
+            pctOfTotal: typeof parsed.pctOfTotal === 'number' && Number.isFinite(parsed.pctOfTotal)
+                ? parsed.pctOfTotal
+                : 0,
+            count: typeof parsed.count === 'number' && Number.isFinite(parsed.count) ? parsed.count : 0
         };
     }
     catch {
@@ -93,7 +95,7 @@ function probeRatioSafe(input) {
             projectRoot: input.projectRoot,
             sessionId: input.sessionId,
             outerSessionId: input.outerSessionId ?? undefined,
-            env: input.env ?? process.env,
+            env: input.env ?? process.env
         });
         return Number.isFinite(probe.ratio) ? probe.ratio : null;
     }
@@ -123,7 +125,7 @@ export function buildContextAuditHint(input) {
         // Cache miss / stale → at most one scan per TTL window.
         const result = (input.runAudit ?? auditContext)({
             outerSessionId: input.outerSessionId ?? null,
-            topN: 1,
+            topN: 1
         });
         const top = result.available ? (result.entries[0] ?? null) : null;
         const entry = {
@@ -134,7 +136,7 @@ export function buildContextAuditHint(input) {
             key: top?.key ?? null,
             bytes: top?.bytes ?? 0,
             pctOfTotal: top?.pctOfTotal ?? 0,
-            count: top?.count ?? 0,
+            count: top?.count ?? 0
         };
         try {
             atomicWriteJson(cachePath, entry);

package/dist/services/context/context-audit-keys.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Stable group-key builders for `peaks code context-audit` — the
+ * `(tool name, short input key)` half of the grouping contract.
+ *
+ * Moved out of `./context-audit.ts` (wave 3, eslint-family sweep). Every
+ * case body, predicate and clip budget below is copied EXACTLY from the
+ * original switch; the switch is only split into two sequential halves so
+ * no single function crosses the complexity ceiling. For every `(tool,
+ * input)` pair the returned key is identical to before the move.
+ */
+/**
+ * Build the stable group key for one tool call. Unknown tools fall back to a
+ * clipped JSON rendering of their input so the group is still recognizable.
+ */
+export declare function contextAuditKey(tool: string, input: unknown): string;

package/dist/services/context/context-audit-keys.js

@@ -0,0 +1,77 @@
+/**
+ * Stable group-key builders for `peaks code context-audit` — the
+ * `(tool name, short input key)` half of the grouping contract.
+ *
+ * Moved out of `./context-audit.ts` (wave 3, eslint-family sweep). Every
+ * case body, predicate and clip budget below is copied EXACTLY from the
+ * original switch; the switch is only split into two sequential halves so
+ * no single function crosses the complexity ceiling. For every `(tool,
+ * input)` pair the returned key is identical to before the move.
+ */
+/** Max characters kept in a group key — keys are labels, not payloads. */
+const KEY_MAX_CHARS = 100;
+/** `Task` / `Agent` descriptions are kept even shorter (label, not payload). */
+const TASK_KEY_MAX_CHARS = 60;
+/** Budget for the JSON fallback used by unknown tools. */
+const FALLBACK_KEY_MAX_CHARS = 80;
+function readInputString(v) {
+    return typeof v === 'string' ? v : '';
+}
+function clip(text, max) {
+    const collapsed = text.replace(/\s+/g, ' ').trim();
+    return collapsed.length <= max ? collapsed : `${collapsed.slice(0, max - 1)}…`;
+}
+/** Last `n` path segments — keeps `Read` / `Edit` keys short but identifiable. */
+function tailPath(value, n) {
+    const parts = value.split(/[\\/]/).filter((p) => p.length > 0);
+    return parts.slice(Math.max(0, parts.length - n)).join('/');
+}
+const NOT_A_KEY = null;
+/** First half of the original switch: execution / file / search tools. */
+function keyForKnownTool(tool, i) {
+    switch (tool) {
+        case 'Bash':
+            return clip(readInputString(i.command), KEY_MAX_CHARS);
+        case 'Read':
+        case 'Write':
+        case 'Edit':
+        case 'NotebookEdit':
+            return clip(tailPath(readInputString(i.file_path), 2), KEY_MAX_CHARS);
+        case 'Grep':
+        case 'Glob':
+            return clip(`${readInputString(i.pattern)} @ ${readInputString(i.path) || '.'}`, KEY_MAX_CHARS);
+        default:
+            return NOT_A_KEY;
+    }
+}
+/** Second half of the original switch: agent tools + unknown-tool fallback. */
+function keyForRemainingTool(tool, i) {
+    switch (tool) {
+        case 'Task':
+        case 'Agent':
+            return clip(readInputString(i.description) || readInputString(i.subagent_type), TASK_KEY_MAX_CHARS);
+        default: {
+            let json;
+            try {
+                json = JSON.stringify(i) ?? '';
+            }
+            catch {
+                json = '';
+            }
+            return clip(json, FALLBACK_KEY_MAX_CHARS);
+        }
+    }
+}
+/**
+ * Build the stable group key for one tool call. Unknown tools fall back to a
+ * clipped JSON rendering of their input so the group is still recognizable.
+ */
+export function contextAuditKey(tool, input) {
+    if (typeof input !== 'object' || input === null)
+        return '';
+    const i = input;
+    const known = keyForKnownTool(tool, i);
+    if (known !== NOT_A_KEY)
+        return known;
+    return keyForRemainingTool(tool, i);
+}

package/dist/services/context/context-audit-limits.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Size/limit constants and `--top` normalization for `peaks code
+ * context-audit`, moved VERBATIM out of `./context-audit.ts` (wave 3,
+ * eslint-family sweep) so that module stays under the 300 raw-line cap.
+ *
+ * The two transcript-size ceilings keep their exact previous values; they
+ * are written as a named 1 MiB constant times a named Mebibyte count
+ * because the `no-magic-numbers` family flags each factor of a literal
+ * product (`256 * 1024 * 1024`) but not a direct `const` assignment.
+ */
+/** Default number of top entries emitted. */
+export declare const CONTEXT_AUDIT_DEFAULT_TOP = 15;
+/** Hard ceiling for `--top` — the envelope must stay small by construction. */
+export declare const CONTEXT_AUDIT_MAX_TOP = 100;
+/** Transcripts larger than this are reported `available:false` (fail-soft). */
+export declare const CONTEXT_AUDIT_MAX_TRANSCRIPT_BYTES: number;
+/** Streaming chunk size (bounded memory on multi-MB transcripts) = 1 MiB. */
+export declare const CONTEXT_AUDIT_SCAN_CHUNK_BYTES = 1048576;
+/** Clamp a caller-supplied `--top` into the documented range. */
+export declare function normalizeTopN(value: unknown): number;