peaks-loop 4.0.53 → 4.1.0

package/dist/services/compact-statusline/compact-statusline-service.js

@@ -41,59 +41,10 @@ import { existsSync, readFileSync } from 'node:fs';
 import { getSessionDir } from '../session/getSessionDir.js';
 import { AUTO_COMPACT_RED_LINE_RATIO } from '../context/auto-compact-types.js';
 import { readCompactHistory } from '../compact-history/compact-history-service.js';
-import { readCompactLifecycle, } from './compact-lifecycle-store.js';
-/**
- * Concrete first-version stale timeout. Adjustable after real timing
- * evidence from the auto-compact orchestrator (it currently writes a
- * heartbeat on every state transition; 120 s is the longest realistic
- * gap between a heartbeat and an actual stall).
- */
-const DEFAULT_STALE_AFTER_MS = 120_000;
-/**
- * 10-second completed-window expiry. The brief (Task 6 design requirement)
- * calls out: once a compact lifecycle reaches `completed`, the primary
- * statusline should surface the success indicator for at most 10 seconds,
- * then fall back to the C1 baseline so the consumer (the IDE) does not
- * keep a green ✓ pinned on the status bar indefinitely. The narrow window
- * is sufficient for the human to see "we just compacted" and long enough
- * to not flap on subsequent reads. Adjustable after real timing feedback.
- */
-export const COMPLETED_EXPIRY_MS = 10_000;
-/**
- * How recently the last history row must itself have been written for the
- * legacy path to report it as "just compacted". Measured against the row's own
- * `ts` — the fact — rather than the file's mtime, which is only a proxy for it
- * and is also moved by rows that record no compaction (repair R9).
- */
-const LEGACY_JUST_COMPACTED_WINDOW_MS = 30_000;
-// PRD-002b slice 2 — extract cell-table magic numbers (4/6/8) into named
-// consts so the no-magic-numbers lint rule stops flagging the typed
-// literal-union cell-table values. Values match the documented contract.
-const STAGE_CELL_COMPACTING = 4;
-const STAGE_CELL_VERIFYING = 6;
-const STAGE_CELL_COMPLETED = 8;
-/* eslint-disable no-magic-numbers -- cell-table contract uses literal-type unions (`0 | 2 | 4 | 6 | 8`); these are type-position discriminators, not runtime values. Magic-number extraction is done at the runtime call sites via STAGE_CELL_* constants above. */
-const CELL_BY_STAGE = new Map([
-    ['queued', 0],
-    ['preparing', 2],
-    ['compacting', STAGE_CELL_COMPACTING],
-    ['verifying', STAGE_CELL_VERIFYING],
-    ['completed', STAGE_CELL_COMPLETED],
-    ['failed', STAGE_CELL_COMPACTING],
-    // `armed` is not in the cell table: it renders WITHOUT a bar (see
-    // renderCompactStatusline). Lookups therefore miss and fall back to 0.
-]);
-const FILLED = '█';
-const EMPTY = '░';
-const BAR_WIDTH = STAGE_CELL_COMPLETED;
-const NO_AFTER_RATIO_HINT = 'after-ratio not recorded';
-function renderBar(filledCells) {
-    return `[${FILLED.repeat(filledCells)}${EMPTY.repeat(BAR_WIDTH - filledCells)}]`;
-}
-function renderLegacyBar(filledCells) {
-    return renderBar(filledCells);
-}
-/* eslint-enable no-magic-numbers */
+import { readCompactLifecycle } from './compact-lifecycle-store.js';
+import { CELL_BY_STAGE, COMPLETED_EXPIRY_MS, DEFAULT_STALE_AFTER_MS, LEGACY_JUST_COMPACTED_WINDOW_MS, NO_AFTER_RATIO_HINT, renderBar, renderLegacyBar, STAGE_CELL_COMPACTING, STAGE_CELL_VERIFYING, STAGE_CELL_COMPLETED } from './compact-statusline-cell-table.js';
+import { stateFromLifecycle, stateFromStalled } from './compact-statusline-state.js';
+export { COMPLETED_EXPIRY_MS } from './compact-statusline-cell-table.js';
 export function decideCompactStatusline(input) {
     const staleAfterMs = input.staleAfterMs ?? DEFAULT_STALE_AFTER_MS;
     const completedExpiryMs = input.completedExpiryMs ?? COMPLETED_EXPIRY_MS;
@@ -107,7 +58,7 @@ export function decideCompactStatusline(input) {
         projectRoot: input.projectRoot,
         sessionId: input.sessionId,
         nowMs: input.now,
-        staleAfterMs,
+        staleAfterMs
     });
     if (lifecycle.kind === 'valid') {
         // 10-second completed-expiry: once a compact lifecycle reaches
@@ -142,7 +93,7 @@ export function decideCompactStatusline(input) {
         return {
             kind: 'invalid',
             filledCells: 0,
-            detail: lifecycle.reason,
+            detail: lifecycle.reason
         };
     }
     // lifecycle.kind === 'missing' → fall back to legacy files.
@@ -150,52 +101,9 @@ export function decideCompactStatusline(input) {
         projectRoot: input.projectRoot,
         sessionId: input.sessionId,
         sessionDir,
-        now: input.now,
+        now: input.now
     });
 }
-function stateFromLifecycle(record) {
-    if (record.stage === 'failed') {
-        const failedAt = record.failedAt ?? 'compacting';
-        const state = {
-            kind: 'failed',
-            filledCells: CELL_BY_STAGE.get(failedAt) ?? STAGE_CELL_COMPACTING,
-            triggerRatio: record.triggerRatio,
-            redLine: record.redLine,
-            failedAt,
-        };
-        if (record.errorSummary !== undefined) {
-            return { ...state, detail: record.errorSummary };
-        }
-        return state;
-    }
-    const filledCells = CELL_BY_STAGE.get(record.stage) ?? 0;
-    const base = {
-        kind: record.stage,
-        filledCells,
-        triggerRatio: record.triggerRatio,
-        redLine: record.redLine,
-    };
-    if (record.stage === 'completed' && typeof record.afterRatio === 'number') {
-        return { ...base, afterRatio: record.afterRatio };
-    }
-    return base;
-}
-function stateFromStalled(record) {
-    const filledCells = CELL_BY_STAGE.get(record.stage) ?? STAGE_CELL_COMPACTING;
-    const detailText = record.stage === 'failed'
-        ? record.errorSummary
-        : `no heartbeat for ${record.stage} stage`;
-    const state = {
-        kind: 'stalled',
-        filledCells,
-        triggerRatio: record.triggerRatio,
-        redLine: record.redLine,
-    };
-    if (detailText !== undefined) {
-        return { ...state, detail: detailText };
-    }
-    return state;
-}
 function decideLegacyFallback(input) {
     const { sessionDir, now } = input;
     const pendingPath = `${sessionDir}/txt/auto-compact-pending.json`;
@@ -211,7 +119,7 @@ function decideLegacyFallback(input) {
                     filledCells: 0,
                     ...(typeof parsed.ratio === 'number' ? { triggerRatio: parsed.ratio } : {}),
                     ...(parsed.redLine === true ? { redLine: true } : {}),
-                    detail: pendingPath,
+                    detail: pendingPath
                 };
             }
         }
@@ -259,7 +167,7 @@ function decideLegacyFallback(input) {
             return {
                 kind: 'completed',
                 filledCells: 8,
-                detail: historyPath,
+                detail: historyPath
             };
         }
     }

package/dist/services/compact-statusline/compact-statusline-state.d.ts

@@ -0,0 +1,4 @@
+import type { CompactLifecycleRecord } from './compact-lifecycle-store.js';
+import { type CompactStatuslineState } from './compact-statusline-cell-table.js';
+export declare function stateFromLifecycle(record: CompactLifecycleRecord): CompactStatuslineState;
+export declare function stateFromStalled(record: CompactLifecycleRecord): CompactStatuslineState;

package/dist/services/compact-statusline/compact-statusline-state.js

@@ -0,0 +1,50 @@
+// src/services/compact-statusline/compact-statusline-state.ts
+//
+// Wave-5 class-A hoist (rid 2026-10-01-wave5-w5-3-compact-release): the two
+// lifecycle-state readers `stateFromLifecycle` and `stateFromStalled` moved
+// VERBATIM out of `compact-statusline-service.ts` (:210-252 at the split)
+// for the 300-raw-line cap. They are module-internal helpers of the parent
+// decision layer; nothing outside imports them. One-directional imports
+// only: this module reads the cell table, the parent reads both.
+import { CELL_BY_STAGE, STAGE_CELL_COMPACTING } from './compact-statusline-cell-table.js';
+export function stateFromLifecycle(record) {
+    if (record.stage === 'failed') {
+        const failedAt = record.failedAt ?? 'compacting';
+        const state = {
+            kind: 'failed',
+            filledCells: CELL_BY_STAGE.get(failedAt) ?? STAGE_CELL_COMPACTING,
+            triggerRatio: record.triggerRatio,
+            redLine: record.redLine,
+            failedAt
+        };
+        if (record.errorSummary !== undefined) {
+            return { ...state, detail: record.errorSummary };
+        }
+        return state;
+    }
+    const filledCells = CELL_BY_STAGE.get(record.stage) ?? 0;
+    const base = {
+        kind: record.stage,
+        filledCells,
+        triggerRatio: record.triggerRatio,
+        redLine: record.redLine
+    };
+    if (record.stage === 'completed' && typeof record.afterRatio === 'number') {
+        return { ...base, afterRatio: record.afterRatio };
+    }
+    return base;
+}
+export function stateFromStalled(record) {
+    const filledCells = CELL_BY_STAGE.get(record.stage) ?? STAGE_CELL_COMPACTING;
+    const detailText = record.stage === 'failed' ? record.errorSummary : `no heartbeat for ${record.stage} stage`;
+    const state = {
+        kind: 'stalled',
+        filledCells,
+        triggerRatio: record.triggerRatio,
+        redLine: record.redLine
+    };
+    if (detailText !== undefined) {
+        return { ...state, detail: detailText };
+    }
+    return state;
+}

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

@@ -55,14 +55,14 @@ export function planMigration(opts) {
             alreadyAtV2: true,
             detectedSchemaVersion,
             newConfigSchemaVersion: CONFIG_SCHEMA_VERSION_V2,
-            willMigrateFields: [],
+            willMigrateFields: []
         };
     }
     return {
         alreadyAtV2: false,
         detectedSchemaVersion,
         newConfigSchemaVersion: CONFIG_SCHEMA_VERSION_V2,
-        willMigrateFields,
+        willMigrateFields
     };
 }
 export function executeMigration(opts) {

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

@@ -71,7 +71,7 @@ export function restoreField(opts) {
         field: opts.field,
         value: bak[opts.field],
         source: 'config.json.1.x.bak',
-        restoredAt: new Date().toISOString(),
+        restoredAt: new Date().toISOString()
     };
     writeFileSync(sidecar, JSON.stringify(payload, null, 2) + '\n', 'utf8');
     return { available: true, field: opts.field, applied: true, sidecarPath: sidecar };

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

@@ -9,7 +9,7 @@ export function planRollback() {
     return {
         available: true,
         detectedVersion: raw.version ?? null,
-        backupPath: backup,
+        backupPath: backup
     };
 }
 export function executeRollback(opts) {

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

@@ -43,10 +43,14 @@ function normalizeBoundaryPath(path) {
     catch {
         realPath = resolved;
     }
-    return process.platform === 'win32' || process.platform === 'darwin' ? realPath.toLowerCase() : realPath;
+    return process.platform === 'win32' || process.platform === 'darwin'
+        ? realPath.toLowerCase()
+        : realPath;
 }
 function getHomeBoundaryPaths() {
-    return new Set([homedir(), process.env.HOME, process.env.USERPROFILE].filter((path) => typeof path === 'string' && path.length > 0).map(normalizeBoundaryPath));
+    return new Set([homedir(), process.env.HOME, process.env.USERPROFILE]
+        .filter((path) => typeof path === 'string' && path.length > 0)
+        .map(normalizeBoundaryPath));
 }
 export function findProjectRoot(startPath) {
     const homeBoundaryPaths = getHomeBoundaryPaths();
@@ -54,7 +58,8 @@ export function findProjectRoot(startPath) {
     let parent = dirname(current);
     let pkgRoot = null;
     while (current !== parent && !homeBoundaryPaths.has(normalizeBoundaryPath(current))) {
-        if (existsSync(resolve(current, '.peaks', 'config.json')) && isSafeProjectConfigMarker(current)) {
+        if (existsSync(resolve(current, '.peaks', 'config.json')) &&
+            isSafeProjectConfigMarker(current)) {
             return current;
         }
         // .git is the definitive project root — return immediately
@@ -77,7 +82,8 @@ export function resolveProjectRootForConfig(startPath) {
     let parent = dirname(current);
     let pkgRoot = null;
     while (current !== parent && !homeBoundaryPaths.has(normalizeBoundaryPath(current))) {
-        if (existsSync(resolve(current, '.peaks', 'config.json')) && isSafeProjectConfigMarker(current)) {
+        if (existsSync(resolve(current, '.peaks', 'config.json')) &&
+            isSafeProjectConfigMarker(current)) {
             return current;
         }
         if (existsSync(resolve(current, '.git'))) {
@@ -213,7 +219,8 @@ function resolveProjectRootFromGit(startPath) {
             return null;
         rawRoot = resolve(trimmed);
     }
-    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)
         // git not on PATH, startPath is not in a repo, or some other
         // benign failure — fall through to the heuristic.
         return null;
@@ -327,7 +334,9 @@ function validateProjectBootstrapConfigPath(projectRootPath, peaksPath, configPa
     const projectRootReal = realpathSync(projectRootPath);
     const peaksStats = lstatSync(peaksPath);
     const peaksReal = realpathSync(peaksPath);
-    if (!peaksStats.isDirectory() || peaksStats.isSymbolicLink() || peaksReal !== resolve(projectRootReal, '.peaks')) {
+    if (!peaksStats.isDirectory() ||
+        peaksStats.isSymbolicLink() ||
+        peaksReal !== resolve(projectRootReal, '.peaks')) {
         throw new Error('Project config path must stay inside the project root');
     }
     try {
@@ -359,7 +368,9 @@ export function validateUserConfigPathForWrite(configPath) {
     const userRootReal = realpathSync(userRoot);
     const peaksStats = lstatSync(peaksPath);
     const peaksReal = realpathSync(peaksPath);
-    if (!peaksStats.isDirectory() || peaksStats.isSymbolicLink() || peaksReal !== resolve(userRootReal, '.peaks')) {
+    if (!peaksStats.isDirectory() ||
+        peaksStats.isSymbolicLink() ||
+        peaksReal !== resolve(userRootReal, '.peaks')) {
         throw new Error('User config path must stay inside the user root');
     }
     try {
@@ -395,7 +406,9 @@ export function validateArtifactWorkspaceMarkerPath(artifactRoot, peaksPath, mar
     const artifactRootReal = realpathSync(artifactRoot);
     const peaksStats = lstatSync(peaksPath);
     const peaksReal = realpathSync(peaksPath);
-    if (!peaksStats.isDirectory() || peaksStats.isSymbolicLink() || peaksReal !== resolve(artifactRootReal, '.peaks')) {
+    if (!peaksStats.isDirectory() ||
+        peaksStats.isSymbolicLink() ||
+        peaksReal !== resolve(artifactRootReal, '.peaks')) {
         throw new Error('Artifact workspace marker must stay inside the artifact workspace');
     }
     try {
@@ -420,7 +433,10 @@ export function validateArtifactWorkspaceMarkerPath(artifactRoot, peaksPath, mar
 function validateOpenConfigFile(fd, tempPath, errorMessage) {
     const fdStats = fstatSync(fd);
     const pathStats = lstatSync(tempPath);
-    if (!fdStats.isFile() || !pathStats.isFile() || fdStats.dev !== pathStats.dev || fdStats.ino !== pathStats.ino) {
+    if (!fdStats.isFile() ||
+        !pathStats.isFile() ||
+        fdStats.dev !== pathStats.dev ||
+        fdStats.ino !== pathStats.ino) {
         throw new Error(errorMessage);
     }
     if (fdStats.nlink !== 1 || pathStats.nlink !== 1) {
@@ -432,7 +448,9 @@ function getSafeTempOpenFlags() {
     return typeof constants.O_NOFOLLOW === 'number' ? baseFlags | constants.O_NOFOLLOW : baseFlags;
 }
 function getSafeReadOpenFlags() {
-    return typeof constants.O_NOFOLLOW === 'number' ? constants.O_RDONLY | constants.O_NOFOLLOW : constants.O_RDONLY;
+    return typeof constants.O_NOFOLLOW === 'number'
+        ? constants.O_RDONLY | constants.O_NOFOLLOW
+        : constants.O_RDONLY;
 }
 export function readConfigFileSafely(configPath, errorMessage) {
     const fd = openSync(configPath, getSafeReadOpenFlags());

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);