peaks-loop 4.0.54 → 4.1.0

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

@@ -52,9 +52,18 @@ function hasLegacyGlobalFields(raw) {
  */
 function promoteLegacyGlobalFieldsToSidecars(raw) {
     if (isRecord(raw.providers)) {
-        const existing = readSidecarJson(providersConfigPath(), { version: SIDECAR_SCHEMA_VERSION, providers: {} });
-        const mergedProviders = { ...(existing.providers ?? {}), ...raw.providers };
-        writeSidecarJson(providersConfigPath(), { version: SIDECAR_SCHEMA_VERSION, providers: mergedProviders });
+        const existing = readSidecarJson(providersConfigPath(), {
+            version: SIDECAR_SCHEMA_VERSION,
+            providers: {}
+        });
+        const mergedProviders = {
+            ...(existing.providers ?? {}),
+            ...raw.providers
+        };
+        writeSidecarJson(providersConfigPath(), {
+            version: SIDECAR_SCHEMA_VERSION,
+            providers: mergedProviders
+        });
     }
     if (isRecord(raw.proxy) && typeof raw.proxy.httpProxy === 'string') {
         const httpProxy = raw.proxy.httpProxy;
@@ -104,7 +113,8 @@ function readJsonFile(path, validateBeforeRead, errorMessage = 'Config path must
     try {
         return JSON.parse(content);
     }
-    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;
     }
 }
@@ -125,7 +135,9 @@ function readUserJsonFile() {
 }
 function readProjectJsonFile(projectRoot) {
     const projectPath = getProjectConfigPath(projectRoot);
-    return readJsonFile(projectPath, projectRoot && projectPath ? () => validateProjectBootstrapConfigPathForWrite(projectRoot, projectPath) : undefined, 'Project config path must stay inside the project root');
+    return readJsonFile(projectPath, projectRoot && projectPath
+        ? () => validateProjectBootstrapConfigPathForWrite(projectRoot, projectPath)
+        : undefined, 'Project config path must stay inside the project root');
 }
 function ensureDir(dirPath) {
     if (!existsSync(dirPath)) {
@@ -134,7 +146,10 @@ function ensureDir(dirPath) {
 }
 const UNSAFE_NESTED_PATH_SEGMENTS = new Set(['__proto__', 'constructor', 'prototype']);
 function getNestedPathParts(path) {
-    return path.replace(/\[(\d+)\]/g, '.$1').split('.').filter(Boolean);
+    return path
+        .replace(/\[(\d+)\]/g, '.$1')
+        .split('.')
+        .filter(Boolean);
 }
 function hasUnsafeNestedPathSegment(parts) {
     return parts.some((part) => UNSAFE_NESTED_PATH_SEGMENTS.has(part));
@@ -146,7 +161,10 @@ function getNestedValue(obj, path) {
     }
     let current = obj;
     for (const part of parts) {
-        if (current === null || current === undefined || typeof current !== 'object' || !Object.prototype.hasOwnProperty.call(current, part)) {
+        if (current === null ||
+            current === undefined ||
+            typeof current !== 'object' ||
+            !Object.prototype.hasOwnProperty.call(current, part)) {
             return undefined;
         }
         current = current[part];
@@ -161,7 +179,10 @@ function setNestedValue(obj, path, value) {
     let current = obj;
     for (let i = 0; i < parts.length - 1; i++) {
         const part = parts[i];
-        if (!Object.prototype.hasOwnProperty.call(current, part) || typeof current[part] !== 'object' || current[part] === null || Array.isArray(current[part])) {
+        if (!Object.prototype.hasOwnProperty.call(current, part) ||
+            typeof current[part] !== 'object' ||
+            current[part] === null ||
+            Array.isArray(current[part])) {
             current[part] = {};
         }
         current = current[part];
@@ -206,13 +227,22 @@ export function readContextWindowTokensOverride(projectRoot) {
         }
         return undefined;
     }
-    catch { // TODO(g2): legacy silent catch — never let config IO break a probe (grace: 1 minor release, v2.14.0)
+    catch {
+        // TODO(g2): legacy silent catch — never let config IO break a probe (grace: 1 minor release, v2.14.0)
         return undefined;
     }
 }
 export function isSensitiveConfigPath(path) {
     const normalized = path.toLowerCase().replace(/[^a-z0-9]/g, '');
-    return normalized.includes('apikey') || normalized.includes('accesskey') || normalized.includes('privatekey') || normalized.includes('token') || normalized.includes('secret') || normalized.includes('password') || normalized.includes('bearer') || normalized.includes('credential') || normalized.includes('auth');
+    return (normalized.includes('apikey') ||
+        normalized.includes('accesskey') ||
+        normalized.includes('privatekey') ||
+        normalized.includes('token') ||
+        normalized.includes('secret') ||
+        normalized.includes('password') ||
+        normalized.includes('bearer') ||
+        normalized.includes('credential') ||
+        normalized.includes('auth'));
 }
 /**
  * 2.0.1 slim-config contract: `~/.peaks/config.json` only stores
@@ -259,7 +289,11 @@ function isProviderBaseUrlPath(path) {
 function isValidProviderBaseUrl(value) {
     try {
         const url = new URL(value);
-        return url.protocol === 'https:' && url.username.length === 0 && url.password.length === 0 && url.search.length === 0 && url.hash.length === 0;
+        return (url.protocol === 'https:' &&
+            url.username.length === 0 &&
+            url.password.length === 0 &&
+            url.search.length === 0 &&
+            url.hash.length === 0);
     }
     catch {
         return false;
@@ -293,7 +327,12 @@ function validateProviderConfig(partial) {
 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;
@@ -311,10 +350,13 @@ function isRecord(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
 function isSafeConfigSegment(value) {
-    return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value) && !value.includes('..') && !value.endsWith('.');
+    return (/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value) && !value.includes('..') && !value.endsWith('.'));
 }
 function toArtifactRemoteRepoConfig(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 (!isSafeConfigSegment(value.owner) || !isSafeConfigSegment(value.name)) {
@@ -339,7 +381,12 @@ function toWorkspaceConfig(value) {
     if (!isRecord(value))
         return null;
     const { workspaceId, name, rootPath, installedCapabilityIds } = value;
-    if (typeof workspaceId !== 'string' || !isSafeConfigSegment(workspaceId) || typeof name !== 'string' || typeof rootPath !== 'string' || !Array.isArray(installedCapabilityIds) || !installedCapabilityIds.every((id) => typeof id === 'string')) {
+    if (typeof workspaceId !== 'string' ||
+        !isSafeConfigSegment(workspaceId) ||
+        typeof name !== 'string' ||
+        typeof rootPath !== 'string' ||
+        !Array.isArray(installedCapabilityIds) ||
+        !installedCapabilityIds.every((id) => typeof id === 'string')) {
         return null;
     }
     const artifactRepo = toArtifactRemoteRepoConfig(value.artifactRepo);
@@ -354,18 +401,29 @@ function toWorkspaceConfig(value) {
     };
 }
 function toWorkspaceConfigs(value) {
-    return Array.isArray(value) ? value.map(toWorkspaceConfig).filter((workspace) => workspace !== null) : [];
+    return Array.isArray(value)
+        ? value
+            .map(toWorkspaceConfig)
+            .filter((workspace) => workspace !== null)
+        : [];
 }
 function toProviderModelConfig(value) {
     if (!isRecord(value))
         return {};
     return {
-        ...(typeof value.model === 'string' && value.model.trim().length > 0 ? { model: value.model.trim() } : {}),
+        ...(typeof value.model === 'string' && value.model.trim().length > 0
+            ? { model: value.model.trim() }
+            : {}),
         ...(typeof value.baseUrl === 'string' ? { baseUrl: value.baseUrl } : {}),
         ...(typeof value.apiKey === 'string' ? { apiKey: value.apiKey } : {})
     };
 }
-const TOKEN_CONFIG_KEYS = new Set(['AnthropicApiKey', 'OpenAiApiKey', 'GitHubToken', 'GitLabToken']);
+const TOKEN_CONFIG_KEYS = new Set([
+    'AnthropicApiKey',
+    'OpenAiApiKey',
+    'GitHubToken',
+    'GitLabToken'
+]);
 function toTokenRef(value) {
     if (!isRecord(value))
         return null;
@@ -399,12 +457,17 @@ function toTokenConfig(value) {
 function toModelProviderConfig(value) {
     if (!isRecord(value))
         return {};
-    return Object.fromEntries(Object.entries(value).map(([providerId, providerConfig]) => [providerId, toProviderModelConfig(providerConfig)]));
+    return Object.fromEntries(Object.entries(value).map(([providerId, providerConfig]) => [
+        providerId,
+        toProviderModelConfig(providerConfig)
+    ]));
 }
 function toProxyConfig(value) {
     if (!isRecord(value))
         return null;
-    return typeof value.httpProxy === 'string' && isValidProxyUrl(value.httpProxy) ? { httpProxy: value.httpProxy } : null;
+    return typeof value.httpProxy === 'string' && isValidProxyUrl(value.httpProxy)
+        ? { httpProxy: value.httpProxy }
+        : null;
 }
 function getProjectWriteTarget() {
     const projectRoot = findProjectRoot(process.cwd());
@@ -464,7 +527,9 @@ function toPeaksConfig(value) {
     return {
         ...(typeof value.version === 'string' ? { version: value.version } : {}),
         ...(typeof value.language === 'string' ? { language: value.language } : {}),
-        ...(typeof value.model === 'string' && ['haiku', 'sonnet', 'opus'].includes(value.model) ? { model: value.model } : {}),
+        ...(typeof value.model === 'string' && ['haiku', 'sonnet', 'opus'].includes(value.model)
+            ? { model: value.model }
+            : {}),
         ...(typeof value.economyMode === 'boolean' ? { economyMode: value.economyMode } : {}),
         ...(typeof value.swarmMode === 'boolean' ? { swarmMode: value.swarmMode } : {}),
         ...(isRecord(value.tokens) ? { tokens: toTokenConfig(value.tokens) } : {}),
@@ -497,7 +562,9 @@ function sanitizeWorkspacePartial(partial) {
     if (Array.isArray(result.workspaces)) {
         result.workspaces = toWorkspaceConfigs(result.workspaces);
     }
-    if (typeof result.currentWorkspace !== 'string' && result.currentWorkspace !== null && result.currentWorkspace !== undefined) {
+    if (typeof result.currentWorkspace !== 'string' &&
+        result.currentWorkspace !== null &&
+        result.currentWorkspace !== undefined) {
         delete result.currentWorkspace;
     }
     return result;
@@ -506,7 +573,10 @@ export function writeConfig(partial, layer = 'user') {
     if (!isConfigLayer(layer)) {
         throw new Error('Invalid config layer');
     }
-    if (layer === 'project' && (partial.providers !== undefined || partial.proxy !== undefined || containsSensitiveConfigValue(partial))) {
+    if (layer === 'project' &&
+        (partial.providers !== undefined ||
+            partial.proxy !== undefined ||
+            containsSensitiveConfigValue(partial))) {
         throw new Error('Sensitive config keys must be stored in the user config layer');
     }
     validateProviderConfig(partial);
@@ -538,7 +608,12 @@ export function getConfig(options = {}) {
                 ...userConfig,
                 ...projectConfigWithoutProxy
             };
-    const config = isRecord(source) ? { ...source, ...(source.tokens !== undefined ? { tokens: toTokenConfig(source.tokens) } : {}) } : source;
+    const config = isRecord(source)
+        ? {
+            ...source,
+            ...(source.tokens !== undefined ? { tokens: toTokenConfig(source.tokens) } : {})
+        }
+        : source;
     if (options.key !== undefined) {
         return getNestedValue(config, options.key);
     }
@@ -553,7 +628,11 @@ export function setConfig(options) {
         throw new Error(`Legacy config key "${options.key}" is no longer stored in ~/.peaks/config.json. ` +
             'Set it under <project>/.peaks/preferences.json (e.g. `peaks preferences set --key <key> --value <value>`).');
     }
-    if (layer === 'project' && (isProviderConfigPath(options.key) || isProxyConfigPath(options.key) || isSensitiveConfigPath(options.key) || containsSensitiveConfigValue(options.value))) {
+    if (layer === 'project' &&
+        (isProviderConfigPath(options.key) ||
+            isProxyConfigPath(options.key) ||
+            isSensitiveConfigPath(options.key) ||
+            containsSensitiveConfigValue(options.value))) {
         throw new Error('Sensitive config keys must be stored in the user config layer');
     }
     if (options.key === 'providers') {
@@ -573,8 +652,8 @@ export function setConfig(options) {
     const targetPath = projectTarget?.configPath ?? getUserConfigPath();
     ensureDir(dirname(targetPath));
     const existing = projectTarget
-        ? readJsonFile(targetPath, () => validateProjectBootstrapConfigPathForWrite(projectTarget.projectRoot, targetPath)) ?? {}
-        : readJsonFile(targetPath, () => validateUserConfigPathForWrite(targetPath)) ?? {};
+        ? (readJsonFile(targetPath, () => validateProjectBootstrapConfigPathForWrite(projectTarget.projectRoot, targetPath)) ?? {})
+        : (readJsonFile(targetPath, () => validateUserConfigPathForWrite(targetPath)) ?? {});
     const updated = { ...existing };
     setNestedValue(updated, options.key, options.value);
     const content = JSON.stringify(updated, null, 2);
@@ -599,8 +678,8 @@ function writeRawWorkspaceData(data, layer) {
     const targetPath = projectTarget?.configPath ?? getUserConfigPath();
     ensureDir(dirname(targetPath));
     const existing = projectTarget
-        ? readJsonFile(targetPath, () => validateProjectBootstrapConfigPathForWrite(projectTarget.projectRoot, targetPath)) ?? {}
-        : readJsonFile(targetPath, () => validateUserConfigPathForWrite(targetPath)) ?? {};
+        ? (readJsonFile(targetPath, () => validateProjectBootstrapConfigPathForWrite(projectTarget.projectRoot, targetPath)) ?? {})
+        : (readJsonFile(targetPath, () => validateUserConfigPathForWrite(targetPath)) ?? {});
     const merged = { ...existing, ...data };
     const content = JSON.stringify(merged, null, 2);
     if (projectTarget) {
@@ -651,7 +730,9 @@ export function removeWorkspace(workspaceId, layer = 'user') {
     if (idx < 0)
         return false;
     const updatedWorkspaces = workspaces.filter((w) => w.workspaceId !== workspaceId);
-    const currentWorkspace = config.currentWorkspace === workspaceId ? updatedWorkspaces[0]?.workspaceId ?? null : config.currentWorkspace ?? null;
+    const currentWorkspace = config.currentWorkspace === workspaceId
+        ? (updatedWorkspaces[0]?.workspaceId ?? null)
+        : (config.currentWorkspace ?? null);
     writeRawWorkspaceData({ workspaces: updatedWorkspaces, currentWorkspace }, layer);
     return true;
 }
@@ -689,7 +770,9 @@ function findWorkspaceForPath(workspaces, path) {
     return matches.reduce((best, match) => match.rootPath.length > best.rootPath.length ? match : best).workspace;
 }
 function getWorkspaceArtifactRoot(workspace) {
-    return workspace.artifactStorage?.localPath ? resolve(workspace.artifactStorage.localPath) : resolve(workspace.rootPath, '.peaks', 'artifacts');
+    return workspace.artifactStorage?.localPath
+        ? resolve(workspace.artifactStorage.localPath)
+        : resolve(workspace.rootPath, '.peaks', 'artifacts');
 }
 function ensureArtifactWorkspaceMarker(workspace) {
     const artifactRoot = getWorkspaceArtifactRoot(workspace);

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;