peaks-loop 4.0.0-beta.7 → 4.0.0-beta.8

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

@@ -1,814 +0,0 @@
-import { existsSync, mkdirSync } from 'node:fs';
-import { dirname, isAbsolute, resolve } from 'node:path';
-import { DEFAULT_CONFIG } from './config-types.js';
-import { stablePath } from '../../shared/path-utils.js';
-import { findProjectRoot, getProjectBootstrapConfigPath, getProjectConfigPath, getUserConfigPath, isInsidePath, readConfigFileSafely, resolveProjectRootForConfig, validateArtifactWorkspaceMarkerPath, validateArtifactWorkspaceRoot, validateProjectBootstrapConfigPathForWrite, validateUserConfigPathForWrite, writeConfigFileSafely, writeProjectConfigFile, writeUserConfigFile } from './config-safety.js';
-import { globalConfigPath, CONFIG_SCHEMA_VERSION_V2 } from './config-migration.js';
-import { isConfigV2 } from './config-types.js';
-import { providersConfigPath, proxyConfigPath, readSidecarJson, sidecarExists, workspacesConfigPath, writeSidecarJson } from './sidecar-store.js';
-import { SIDECAR_SCHEMA_VERSION } from './sidecar-store.js';
-// Re-export resolveProjectRootForConfig and resolveCanonicalProjectRoot for external consumers
-export { resolveProjectRootForConfig, resolveCanonicalProjectRoot } from './config-safety.js';
-/**
- * Load the slim 2.0 `~/.peaks/config.json` file. Returns the parsed
- * object when the file is at schema 2.0.0; returns null when the
- * file is absent (fresh install, no global config yet).
- *
- * Throws `CONFIG_LEGACY_VERSION` when the file exists at a 1.x
- * schema version — the caller is expected to run
- * `peaks config migrate --apply` to bring it forward before
- * continuing. This gate is intentional: a slim 2.0 reader must
- * not silently pass through a 1.x shape, because every field it
- * ignores is a field the caller is going to look for elsewhere
- * (preferences.json, .bak, _state/).
- */
-export function loadGlobalConfig() {
-    const path = globalConfigPath();
-    if (!existsSync(path))
-        return null;
-    const content = readConfigFileSafely(path, 'Global config path must stay inside the user root');
-    const raw = JSON.parse(content);
-    if (isConfigV2(raw)) {
-        if (hasLegacyGlobalFields(raw)) {
-            promoteLegacyGlobalFieldsToSidecars(raw);
-            rewriteSlimGlobalConfig();
-        }
-        return readSlimGlobalConfig();
-    }
-    const detected = typeof raw.version === 'string' ? raw.version : 'unknown';
-    throw new Error(`CONFIG_LEGACY_VERSION: ~/.peaks/config.json is at version "${detected}", expected ${CONFIG_SCHEMA_VERSION_V2}. Run \`peaks config migrate --apply\`.`);
-}
-/**
- * Slim 2.0 schema allows `version` + `ocr`. Any other top-level
- * field is a legacy artifact that needs to be promoted to a
- * sidecar file.
- */
-function hasLegacyGlobalFields(raw) {
-    const allowed = new Set(['version', 'ocr']);
-    return Object.keys(raw).some((k) => !allowed.has(k));
-}
-/**
- * One-shot promotion of legacy fields into their dedicated sidecar
- * files. Idempotent: if the sidecar already has the field, the
- * legacy value is dropped (sidecar is the new source of truth).
- */
-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 });
-    }
-    if (isRecord(raw.proxy) && typeof raw.proxy.httpProxy === 'string') {
-        const httpProxy = raw.proxy.httpProxy;
-        if (!sidecarExists(proxyConfigPath())) {
-            writeSidecarJson(proxyConfigPath(), { version: SIDECAR_SCHEMA_VERSION, httpProxy });
-        }
-    }
-    if (Array.isArray(raw.workspaces) || typeof raw.currentWorkspace === 'string') {
-        if (!sidecarExists(workspacesConfigPath())) {
-            writeSidecarJson(workspacesConfigPath(), {
-                version: SIDECAR_SCHEMA_VERSION,
-                workspaces: Array.isArray(raw.workspaces) ? raw.workspaces : [],
-                currentWorkspace: typeof raw.currentWorkspace === 'string' ? raw.currentWorkspace : null
-            });
-        }
-    }
-}
-function readSlimGlobalConfig() {
-    const path = globalConfigPath();
-    if (!existsSync(path)) {
-        return { version: CONFIG_SCHEMA_VERSION_V2 };
-    }
-    const content = readConfigFileSafely(path, 'Global config path must stay inside the user root');
-    return JSON.parse(content);
-}
-function rewriteSlimGlobalConfig() {
-    const path = globalConfigPath();
-    const ocr = readOcrFromRawConfigFile();
-    const slim = { version: CONFIG_SCHEMA_VERSION_V2 };
-    if (ocr !== null)
-        slim['ocr'] = ocr;
-    writeUserConfigFile(path, JSON.stringify(slim, null, 2) + '\n');
-}
-function readOcrFromRawConfigFile() {
-    const path = globalConfigPath();
-    if (!existsSync(path))
-        return null;
-    const content = readConfigFileSafely(path, 'Global config path must stay inside the user root');
-    const raw = JSON.parse(content);
-    return isRecord(raw.ocr) ? raw.ocr : null;
-}
-function readJsonFile(path, validateBeforeRead, errorMessage = 'Config path must stay inside the config root') {
-    if (!path || !existsSync(path))
-        return null;
-    validateBeforeRead?.();
-    const content = readConfigFileSafely(path, errorMessage);
-    try {
-        return JSON.parse(content);
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        return null;
-    }
-}
-function readExistingJsonFile(path, errorMessage, validateBeforeRead) {
-    if (!existsSync(path))
-        return null;
-    validateBeforeRead?.();
-    try {
-        return JSON.parse(readConfigFileSafely(path, errorMessage));
-    }
-    catch {
-        throw new Error(errorMessage);
-    }
-}
-function readUserJsonFile() {
-    const userPath = getUserConfigPath();
-    return readJsonFile(userPath, () => validateUserConfigPathForWrite(userPath), 'User config path must stay inside the user root');
-}
-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');
-}
-function ensureDir(dirPath) {
-    if (!existsSync(dirPath)) {
-        mkdirSync(dirPath, { recursive: true });
-    }
-}
-const UNSAFE_NESTED_PATH_SEGMENTS = new Set(['__proto__', 'constructor', 'prototype']);
-function getNestedPathParts(path) {
-    return path.replace(/\[(\d+)\]/g, '.$1').split('.').filter(Boolean);
-}
-function hasUnsafeNestedPathSegment(parts) {
-    return parts.some((part) => UNSAFE_NESTED_PATH_SEGMENTS.has(part));
-}
-function getNestedValue(obj, path) {
-    const parts = getNestedPathParts(path);
-    if (parts.length === 0 || hasUnsafeNestedPathSegment(parts)) {
-        return undefined;
-    }
-    let current = obj;
-    for (const part of parts) {
-        if (current === null || current === undefined || typeof current !== 'object' || !Object.prototype.hasOwnProperty.call(current, part)) {
-            return undefined;
-        }
-        current = current[part];
-    }
-    return current;
-}
-function setNestedValue(obj, path, value) {
-    const parts = getNestedPathParts(path);
-    if (parts.length === 0 || hasUnsafeNestedPathSegment(parts)) {
-        throw new Error('Unsafe config path');
-    }
-    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])) {
-            current[part] = {};
-        }
-        current = current[part];
-    }
-    const last = parts[parts.length - 1];
-    current[last] = value;
-}
-function removeProjectSensitiveConfig(config) {
-    const { providers, proxy, tokens, ...safeConfig } = config;
-    return Object.fromEntries(Object.entries(safeConfig).filter(([key, value]) => !isSecretKey(key) && !containsSensitiveConfigValue(value)));
-}
-export function isConfigLayer(value) {
-    return value === 'user' || value === 'project';
-}
-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');
-}
-/**
- * 2.0.1 slim-config contract: `~/.peaks/config.json` only stores
- * `version` + `ocr.llm.*` placeholders. The 1.x → 2.0 migration
- * moved per-project fields (`language`, `model`, `economyMode`,
- * `swarmMode`) to `<project>/.peaks/preferences.json` (per spec
- * §10.4). `setConfig` rejects writes to those keys and points the
- * user to the preferences path; tokens / providers / proxy still
- * live in `~/.peaks/config.json` (the loader is tolerant of them
- * but does not synthesise defaults for them anymore).
- */
-const LEGACY_CONFIG_KEYS = new Set([
-    'language',
-    'model',
-    'economyMode',
-    'swarmMode'
-]);
-export function isLegacyConfigKey(path) {
-    const topLevel = path.split(/[.[].*/, 1)[0] ?? '';
-    return LEGACY_CONFIG_KEYS.has(topLevel);
-}
-function isProviderConfigPath(path) {
-    return path === 'providers' || path.startsWith('providers.');
-}
-function isSecretKey(key) {
-    return isSensitiveConfigPath(key);
-}
-function sanitizeBaseUrlForDisplay(value) {
-    try {
-        const url = new URL(value);
-        url.username = '';
-        url.password = '';
-        url.search = '';
-        url.hash = '';
-        return url.toString();
-    }
-    catch {
-        return '[invalid-url-redacted]';
-    }
-}
-const MINIMAX_API_HOST = 'api.minimaxi.com';
-function isProviderBaseUrlPath(path) {
-    return /^providers\.[^.]+\.baseUrl$/.test(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;
-    }
-    catch {
-        return false;
-    }
-}
-function isValidMiniMaxBaseUrl(value) {
-    try {
-        const url = new URL(value);
-        return url.protocol === 'https:' && url.hostname === MINIMAX_API_HOST && url.username.length === 0 && url.password.length === 0 && url.search.length === 0 && url.hash.length === 0;
-    }
-    catch {
-        return false;
-    }
-}
-function getMiniMaxBaseUrlCandidate(key, value) {
-    if (key === 'providers.minimax.baseUrl') {
-        return value;
-    }
-    if (key === 'providers.minimax' && value !== null && typeof value === 'object' && !Array.isArray(value)) {
-        return value.baseUrl;
-    }
-    if (key === 'providers' && value !== null && typeof value === 'object' && !Array.isArray(value)) {
-        return value.minimax?.baseUrl;
-    }
-    return undefined;
-}
-function validateProviderBaseUrl(value) {
-    if (value !== undefined && (typeof value !== 'string' || !isValidProviderBaseUrl(value))) {
-        throw new Error('Provider base URL must be HTTPS without embedded credentials, query, or fragment');
-    }
-}
-function validateMiniMaxBaseUrl(value) {
-    if (value !== undefined && (typeof value !== 'string' || !isValidMiniMaxBaseUrl(value))) {
-        throw new Error('MiniMax base URL must be the MiniMax HTTPS endpoint without embedded credentials');
-    }
-}
-function getProxyUrlCandidate(key, value) {
-    if (key === 'proxy.httpProxy') {
-        return value;
-    }
-    if (key === 'proxy' && isRecord(value)) {
-        return value.httpProxy;
-    }
-    return undefined;
-}
-function isProxyConfigPath(path) {
-    return path === 'proxy' || path.startsWith('proxy.');
-}
-function validateModelProviderConfig(providers) {
-    validateMiniMaxBaseUrl(providers.minimax?.baseUrl);
-    for (const [providerId, provider] of Object.entries(providers)) {
-        if (providerId !== 'minimax') {
-            validateProviderBaseUrl(provider?.baseUrl);
-        }
-    }
-}
-function validateProviderConfig(partial) {
-    validateModelProviderConfig(partial.providers ?? {});
-}
-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;
-    }
-    catch {
-        return false;
-    }
-}
-function validateProxyUrl(value) {
-    if (value !== undefined && (typeof value !== 'string' || !isValidProxyUrl(value))) {
-        throw new Error('Proxy URL must be an HTTP or HTTPS URL without embedded credentials');
-    }
-}
-function validateProxyConfig(partial) {
-    validateProxyUrl(partial.proxy?.httpProxy);
-}
-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('.');
-}
-function toArtifactRemoteRepoConfig(value) {
-    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)) {
-        return null;
-    }
-    return { provider: value.provider, owner: value.owner, name: value.name };
-}
-function toArtifactStorageConfig(value) {
-    if (!isRecord(value))
-        return null;
-    const localPath = typeof value.localPath === 'string' ? { localPath: value.localPath } : {};
-    if (value.mode === 'local') {
-        return { mode: 'local', ...localPath };
-    }
-    const remote = toArtifactRemoteRepoConfig(value.remote);
-    if (value.mode === 'local-with-remote-sync' && remote) {
-        return { mode: 'local-with-remote-sync', ...localPath, remote };
-    }
-    return null;
-}
-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')) {
-        return null;
-    }
-    const artifactRepo = toArtifactRemoteRepoConfig(value.artifactRepo);
-    const artifactStorage = toArtifactStorageConfig(value.artifactStorage);
-    return {
-        workspaceId,
-        name,
-        rootPath,
-        installedCapabilityIds,
-        ...(artifactRepo ? { artifactRepo } : {}),
-        ...(artifactStorage ? { artifactStorage } : {})
-    };
-}
-function toWorkspaceConfigs(value) {
-    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.baseUrl === 'string' ? { baseUrl: value.baseUrl } : {}),
-        ...(typeof value.apiKey === 'string' ? { apiKey: value.apiKey } : {})
-    };
-}
-function toMiniMaxProviderConfig(value) {
-    return toProviderModelConfig(value);
-}
-const TOKEN_CONFIG_KEYS = new Set(['AnthropicApiKey', 'OpenAiApiKey', 'GitHubToken', 'GitLabToken']);
-function toTokenRef(value) {
-    if (!isRecord(value))
-        return null;
-    const env = typeof value.env === 'string' ? value.env.trim() : '';
-    const keychain = typeof value.keychain === 'string' ? value.keychain.trim() : '';
-    if (env.length > 0) {
-        return { env };
-    }
-    if (keychain.length > 0) {
-        return { keychain };
-    }
-    if (value.ghCli === true) {
-        return { ghCli: true };
-    }
-    return null;
-}
-function toTokenConfig(value) {
-    if (!isRecord(value))
-        return {};
-    const tokens = {};
-    for (const [key, entry] of Object.entries(value)) {
-        if (!TOKEN_CONFIG_KEYS.has(key))
-            continue;
-        const tokenRef = toTokenRef(entry);
-        if (tokenRef) {
-            tokens[key] = tokenRef;
-        }
-    }
-    return tokens;
-}
-function toModelProviderConfig(value) {
-    if (!isRecord(value))
-        return {};
-    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;
-}
-function getProjectWriteTarget() {
-    const projectRoot = findProjectRoot(process.cwd());
-    const configPath = getProjectConfigPath(projectRoot);
-    if (!projectRoot || !configPath) {
-        throw new Error('Project config not found');
-    }
-    return { projectRoot, configPath };
-}
-export function containsSensitiveConfigValue(value) {
-    if (Array.isArray(value)) {
-        return value.some(containsSensitiveConfigValue);
-    }
-    if (value === null || typeof value !== 'object') {
-        return false;
-    }
-    return Object.entries(value).some(([key, entry]) => isSecretKey(key) || containsSensitiveConfigValue(entry));
-}
-export function redactConfigSecrets(value, path = '') {
-    if (Array.isArray(value)) {
-        return value.map((item, index) => redactConfigSecrets(item, `${path}[${index}]`));
-    }
-    if (value === null || typeof value !== 'object') {
-        if (isProviderBaseUrlPath(path) && typeof value === 'string') {
-            return sanitizeBaseUrlForDisplay(value);
-        }
-        return value;
-    }
-    return Object.fromEntries(Object.entries(value).map(([key, entry]) => {
-        const nextPath = path ? `${path}.${key}` : key;
-        if (isSecretKey(key)) {
-            return [key, '***'];
-        }
-        if (isProviderBaseUrlPath(nextPath) && typeof entry === 'string') {
-            return [key, sanitizeBaseUrlForDisplay(entry)];
-        }
-        return [key, redactConfigSecrets(entry, nextPath)];
-    }));
-}
-function createMiniMaxProviderStatus(config) {
-    const baseUrl = config.baseUrl?.trim();
-    const apiKey = config.apiKey?.trim();
-    const baseUrlConfigured = typeof baseUrl === 'string' && baseUrl.length > 0 && isValidMiniMaxBaseUrl(baseUrl);
-    const apiKeyConfigured = typeof apiKey === 'string' && apiKey.length > 0;
-    return {
-        provider: 'minimax',
-        configured: baseUrlConfigured && apiKeyConfigured,
-        baseUrlConfigured,
-        apiKeyConfigured,
-        storage: 'user-plaintext-v1',
-        nextActions: baseUrlConfigured && apiKeyConfigured ? [] : ['Export MINIMAX_API_KEY and rerun peaks config provider minimax set --base-url <url>']
-    };
-}
-export function getMiniMaxProviderConfig() {
-    return toMiniMaxProviderConfig(readUserJsonFile()?.providers?.minimax);
-}
-export function getMiniMaxProviderStatus() {
-    return createMiniMaxProviderStatus(getMiniMaxProviderConfig());
-}
-export function setMiniMaxProviderConfig(input) {
-    validateMiniMaxBaseUrl(input.baseUrl);
-    const userConfig = readUserJsonFile() ?? {};
-    const existingProviders = toModelProviderConfig(userConfig.providers);
-    const providers = {
-        ...existingProviders,
-        minimax: {
-            ...existingProviders.minimax,
-            ...input
-        }
-    };
-    validateMiniMaxBaseUrl(providers.minimax?.baseUrl);
-    writeConfig({ providers }, 'user');
-    return createMiniMaxProviderStatus(providers.minimax ?? {});
-}
-const OCR_AUTH_HEADERS = new Set(['authorization', 'x-api-key', 'bearer']);
-function toOcrLlmConfig(value) {
-    if (!isRecord(value))
-        return {};
-    const url = typeof value.url === 'string' && value.url.trim().length > 0 ? value.url.trim() : undefined;
-    const authToken = typeof value.authToken === 'string' && value.authToken.length > 0 ? value.authToken : undefined;
-    const model = typeof value.model === 'string' && value.model.trim().length > 0 ? value.model.trim() : undefined;
-    const useAnthropic = typeof value.useAnthropic === 'boolean' ? value.useAnthropic : undefined;
-    const rawAuthHeader = typeof value.authHeader === 'string' ? value.authHeader : undefined;
-    const authHeader = rawAuthHeader !== undefined && OCR_AUTH_HEADERS.has(rawAuthHeader)
-        ? rawAuthHeader
-        : undefined;
-    return {
-        ...(url !== undefined ? { url } : {}),
-        ...(authToken !== undefined ? { authToken } : {}),
-        ...(model !== undefined ? { model } : {}),
-        ...(useAnthropic !== undefined ? { useAnthropic } : {}),
-        ...(authHeader !== undefined ? { authHeader } : {})
-    };
-}
-function toOcrConfig(value) {
-    if (!isRecord(value))
-        return {};
-    return {
-        ...(isRecord(value.llm) ? { llm: toOcrLlmConfig(value.llm) } : {})
-    };
-}
-/**
- * Read the ocr LLM endpoint config from the user-layer
- * `~/.peaks/config.json`. The user populates this themselves by
- * pasting the `peaks code-review config-template` output (or by
- * running `peaks config set --key ocr.llm.url --value '...'`).
- * peaks-loop never auto-writes these values.
- */
-export function getOcrConfig() {
-    const userConfig = readUserJsonFile() ?? {};
-    return toOcrConfig(userConfig.ocr);
-}
-/**
- * Return the resolved `OcrLlmConfig` block (`peaksConfig.ocr.llm`)
- * or `null` when the user has not populated the user config. The
- * 5-state OCR detector uses this as the source of truth; when the
- * returned block is missing required fields it produces a
- * `config-missing` state with a templated `nextActions` payload
- * the user can paste into their config.
- */
-export function getOcrLlmConfig() {
-    const ocr = getOcrConfig();
-    if (!ocr.llm)
-        return null;
-    return ocr.llm;
-}
-function inferHumanLanguage(value) {
-    const normalized = value.trim();
-    if (!normalized) {
-        throw new Error('Language must be non-empty');
-    }
-    if (/^zh(?:-|$)/i.test(normalized) || /[㐀-鿿]/u.test(normalized)) {
-        return 'zh-CN';
-    }
-    if (/^en(?:-|$)/i.test(normalized)) {
-        return 'en';
-    }
-    return 'en';
-}
-function toPeaksConfig(value) {
-    if (!isRecord(value))
-        return {};
-    const proxy = toProxyConfig(value.proxy);
-    return {
-        ...(typeof value.version === 'string' ? { version: value.version } : {}),
-        ...(typeof value.language === 'string' ? { language: value.language } : {}),
-        ...(typeof value.model === 'string' && ['haiku', 'sonnet', 'opus', 'minimax'].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) } : {}),
-        ...(isRecord(value.providers) ? { providers: toModelProviderConfig(value.providers) } : {}),
-        ...(proxy ? { proxy } : {})
-    };
-}
-export function bootstrapProjectLanguageConfig(projectRoot, language) {
-    const inferredLanguage = inferHumanLanguage(language);
-    const projectPath = getProjectBootstrapConfigPath(projectRoot);
-    const existing = readExistingJsonFile(projectPath, 'Project config must contain valid JSON', () => validateProjectBootstrapConfigPathForWrite(projectRoot, projectPath)) ?? {};
-    if (typeof existing.language === 'string' && existing.language.trim().length > 0) {
-        return;
-    }
-    writeProjectConfigFile(projectRoot, projectPath, JSON.stringify({ ...existing, language: inferredLanguage }, null, 2));
-}
-export function readConfig(projectRoot) {
-    const detectedRoot = projectRoot ?? findProjectRoot(process.cwd());
-    const userConfig = toPeaksConfig(readUserJsonFile());
-    const projectConfig = removeProjectSensitiveConfig(toPeaksConfig(readProjectJsonFile(detectedRoot)));
-    const { proxy: projectProxy, ...projectConfigWithoutProxy } = projectConfig;
-    return {
-        ...DEFAULT_CONFIG,
-        ...userConfig,
-        ...projectConfigWithoutProxy
-    };
-}
-function sanitizeWorkspacePartial(partial) {
-    const result = { ...partial };
-    if (Array.isArray(result.workspaces)) {
-        result.workspaces = toWorkspaceConfigs(result.workspaces);
-    }
-    if (typeof result.currentWorkspace !== 'string' && result.currentWorkspace !== null && result.currentWorkspace !== undefined) {
-        delete result.currentWorkspace;
-    }
-    return result;
-}
-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))) {
-        throw new Error('Sensitive config keys must be stored in the user config layer');
-    }
-    validateProviderConfig(partial);
-    validateProxyConfig(partial);
-    if (layer === 'project') {
-        const { projectRoot, configPath } = getProjectWriteTarget();
-        ensureDir(dirname(configPath));
-        const existing = readJsonFile(configPath, () => validateProjectBootstrapConfigPathForWrite(projectRoot, configPath)) ?? {};
-        const merged = sanitizeWorkspacePartial({ ...existing, ...partial });
-        writeProjectConfigFile(projectRoot, configPath, JSON.stringify(merged, null, 2));
-        return;
-    }
-    const userPath = getUserConfigPath();
-    ensureDir(dirname(userPath));
-    const existing = readJsonFile(userPath, () => validateUserConfigPathForWrite(userPath)) ?? {};
-    const merged = sanitizeWorkspacePartial({ ...existing, ...partial });
-    writeUserConfigFile(userPath, JSON.stringify(merged, null, 2));
-}
-export function getConfig(options = {}) {
-    const projectRoot = findProjectRoot(process.cwd());
-    const userConfig = readUserJsonFile() ?? {};
-    const projectConfig = removeProjectSensitiveConfig(readProjectJsonFile(projectRoot) ?? {});
-    const { proxy: projectProxy, ...projectConfigWithoutProxy } = projectConfig;
-    const source = options.layer === 'user'
-        ? userConfig
-        : options.layer === 'project'
-            ? projectConfig
-            : {
-                ...userConfig,
-                ...projectConfigWithoutProxy
-            };
-    const config = isRecord(source) ? { ...source, ...(source.tokens !== undefined ? { tokens: toTokenConfig(source.tokens) } : {}) } : source;
-    if (options.key !== undefined) {
-        return getNestedValue(config, options.key);
-    }
-    return config;
-}
-export function setConfig(options) {
-    const layer = options.layer ?? 'user';
-    if (!isConfigLayer(layer)) {
-        throw new Error('Invalid config layer');
-    }
-    if (isLegacyConfigKey(options.key)) {
-        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))) {
-        throw new Error('Sensitive config keys must be stored in the user config layer');
-    }
-    validateMiniMaxBaseUrl(getMiniMaxBaseUrlCandidate(options.key, options.value));
-    if (options.key === 'providers') {
-        validateModelProviderConfig(toModelProviderConfig(options.value));
-    }
-    else if (options.key.startsWith('providers.') && !options.key.startsWith('providers.minimax.')) {
-        const providerId = getNestedPathParts(options.key)[1];
-        if (options.key === `providers.${providerId}`) {
-            validateModelProviderConfig({ [providerId]: toProviderModelConfig(options.value) });
-        }
-        else if (isProviderBaseUrlPath(options.key)) {
-            validateProviderBaseUrl(options.value);
-        }
-    }
-    validateProxyUrl(getProxyUrlCandidate(options.key, options.value));
-    const projectTarget = layer === 'project' ? getProjectWriteTarget() : null;
-    const targetPath = projectTarget?.configPath ?? getUserConfigPath();
-    ensureDir(dirname(targetPath));
-    const existing = projectTarget
-        ? 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);
-    if (projectTarget) {
-        writeProjectConfigFile(projectTarget.projectRoot, targetPath, content);
-    }
-    else {
-        writeUserConfigFile(targetPath, content);
-    }
-}
-function readRawWorkspaceData(layer) {
-    const config = getConfig({ layer });
-    return isRecord(config)
-        ? {
-            currentWorkspace: typeof config.currentWorkspace === 'string' ? config.currentWorkspace : null,
-            workspaces: toWorkspaceConfigs(config.workspaces)
-        }
-        : { currentWorkspace: null, workspaces: [] };
-}
-function writeRawWorkspaceData(data, layer) {
-    const projectTarget = layer === 'project' ? getProjectWriteTarget() : null;
-    const targetPath = projectTarget?.configPath ?? getUserConfigPath();
-    ensureDir(dirname(targetPath));
-    const existing = projectTarget
-        ? readJsonFile(targetPath, () => validateProjectBootstrapConfigPathForWrite(projectTarget.projectRoot, targetPath)) ?? {}
-        : readJsonFile(targetPath, () => validateUserConfigPathForWrite(targetPath)) ?? {};
-    const merged = { ...existing, ...data };
-    const content = JSON.stringify(merged, null, 2);
-    if (projectTarget) {
-        writeProjectConfigFile(projectTarget.projectRoot, targetPath, content);
-    }
-    else {
-        writeUserConfigFile(targetPath, content);
-    }
-}
-function readAllWorkspaces() {
-    const userData = readRawWorkspaceData('user');
-    const projectData = readRawWorkspaceData('project');
-    const mergedWorkspaces = new Map();
-    for (const w of userData.workspaces)
-        mergedWorkspaces.set(w.workspaceId, w);
-    for (const w of projectData.workspaces)
-        mergedWorkspaces.set(w.workspaceId, w);
-    return {
-        currentWorkspace: projectData.currentWorkspace ?? userData.currentWorkspace,
-        workspaces: [...mergedWorkspaces.values()]
-    };
-}
-export function getWorkspaceConfig(workspaceId, _projectRoot) {
-    const { workspaces } = readAllWorkspaces();
-    return workspaces.find((w) => w.workspaceId === workspaceId) ?? null;
-}
-function readLayerConfig(layer) {
-    return readRawWorkspaceData(layer);
-}
-export function addWorkspace(workspace, layer = 'user') {
-    if (!isSafeConfigSegment(workspace.workspaceId)) {
-        throw new Error('Workspace id must only contain letters, numbers, dots, underscores, or hyphens and must not contain path traversal');
-    }
-    const config = readRawWorkspaceData(layer);
-    const workspaces = config.workspaces;
-    const existing = workspaces.findIndex((w) => w.workspaceId === workspace.workspaceId);
-    const updatedWorkspaces = existing >= 0
-        ? workspaces.map((existingWorkspace) => existingWorkspace.workspaceId === workspace.workspaceId ? workspace : existingWorkspace)
-        : [...workspaces, workspace];
-    writeRawWorkspaceData({ workspaces: updatedWorkspaces }, layer);
-}
-export function removeWorkspace(workspaceId, layer = 'user') {
-    if (!isSafeConfigSegment(workspaceId))
-        return false;
-    const config = readRawWorkspaceData(layer);
-    const workspaces = config.workspaces;
-    const idx = workspaces.findIndex((w) => w.workspaceId === workspaceId);
-    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;
-    writeRawWorkspaceData({ workspaces: updatedWorkspaces, currentWorkspace }, layer);
-    return true;
-}
-export function setCurrentWorkspace(workspaceId, layer = 'user') {
-    if (!isSafeConfigSegment(workspaceId))
-        return false;
-    const config = readRawWorkspaceData(layer);
-    const workspaces = config.workspaces;
-    const exists = workspaces.some((w) => w.workspaceId === workspaceId);
-    if (!exists)
-        return false;
-    writeRawWorkspaceData({ currentWorkspace: workspaceId }, layer);
-    return true;
-}
-export function getCurrentWorkspaceConfig() {
-    const { currentWorkspace, workspaces } = readAllWorkspaces();
-    if (!currentWorkspace)
-        return null;
-    return workspaces.find((w) => w.workspaceId === currentWorkspace) ?? null;
-}
-export function getWorkspaceConfigForPath(path = process.cwd()) {
-    const { workspaces } = readAllWorkspaces();
-    return findWorkspaceForPath(workspaces, path);
-}
-function findWorkspaceForPath(workspaces, path) {
-    const targetPath = stablePath(path);
-    const matches = workspaces.flatMap((workspace) => {
-        if (!isAbsolute(workspace.rootPath) || !existsSync(workspace.rootPath))
-            return [];
-        const rootPath = stablePath(workspace.rootPath);
-        return isInsidePath(targetPath, rootPath) ? [{ workspace, rootPath }] : [];
-    });
-    if (matches.length === 0)
-        return null;
-    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');
-}
-function ensureArtifactWorkspaceMarker(workspace) {
-    const artifactRoot = getWorkspaceArtifactRoot(workspace);
-    const peaksPath = resolve(artifactRoot, '.peaks');
-    const markerPath = resolve(peaksPath, 'config.json');
-    ensureDir(artifactRoot);
-    validateArtifactWorkspaceRoot(artifactRoot, workspace.rootPath);
-    ensureDir(peaksPath);
-    validateArtifactWorkspaceMarkerPath(artifactRoot, peaksPath, markerPath);
-    if (!existsSync(markerPath)) {
-        writeConfigFileSafely(markerPath, '{}\n', () => validateArtifactWorkspaceMarkerPath(artifactRoot, peaksPath, markerPath), 'Artifact workspace marker must stay inside the artifact workspace');
-    }
-}
-export function ensureWorkspaceConfigForPath(path = process.cwd()) {
-    const projectRoot = resolveProjectRootForConfig(path);
-    if (!isAbsolute(projectRoot) || !existsSync(projectRoot))
-        return null;
-    const config = readLayerConfig('user');
-    const existingWorkspace = findWorkspaceForPath(config.workspaces, path);
-    if (existingWorkspace) {
-        ensureArtifactWorkspaceMarker(existingWorkspace);
-        return existingWorkspace;
-    }
-    return null;
-}
-export function getWorkspaceConfigForCurrentPath() {
-    return getWorkspaceConfigForPath(process.cwd());
-}
-export function ensureWorkspaceConfigForCurrentPath() {
-    return ensureWorkspaceConfigForPath(process.cwd());
-}
-export { getUserConfigPath } from './config-safety.js';
-export { globalConfigPath } from './config-migration.js';