@kaitranntt/ccs 7.76.0 → 7.77.0

package/dist/config/loader/io-locks.d.ts

@@ -0,0 +1,76 @@
+/**
+ * io-locks.ts
+ *
+ * Path constants, lockfile management, and config I/O helpers extracted from
+ * unified-config-loader.ts (Phase 1 split — issue #1164).
+ *
+ * Forward-reference note: loadUnifiedConfigWithLockHeld and
+ * writeUnifiedConfigWithLockHeld depend on mergeWithDefaults,
+ * validateCompositeVariants, generateYamlHeader, and generateYamlWithComments
+ * which still live in unified-config-loader.ts (extracted in later phases).
+ * Those are passed as callbacks to avoid a circular import. Once Phases 2–3
+ * land in separate modules with no dependency on this file, they can be
+ * imported directly.
+ */
+import type { UnifiedConfig } from '../unified-config-types';
+export declare const CONFIG_YAML = "config.yaml";
+export declare const CONFIG_JSON = "config.json";
+export declare const CONFIG_LOCK = "config.yaml.lock";
+/** Lock is stale after this many milliseconds */
+export declare const LOCK_STALE_MS = 5000;
+export declare const GO_DURATION_SEGMENT: string;
+export declare const GO_DURATION_PATTERN: RegExp;
+/**
+ * Get path to unified config.yaml
+ */
+export declare function getConfigYamlPath(): string;
+/**
+ * Get path to legacy config.json
+ */
+export declare function getConfigJsonPath(): string;
+/**
+ * Acquire lockfile for config write operations.
+ * Returns a lock token if acquired, null if already locked by another process.
+ * Cleans up stale locks (older than LOCK_STALE_MS).
+ */
+export declare function acquireLock(): string | null;
+/**
+ * Release lockfile after config write operation.
+ */
+export declare function releaseLock(lockToken: string): void;
+/**
+ * Check if unified config.yaml exists
+ */
+export declare function hasUnifiedConfig(): boolean;
+/**
+ * Check if legacy config.json exists
+ */
+export declare function hasLegacyConfig(): boolean;
+/**
+ * Sync sleep helper for lock retry loops.
+ * Uses Atomics.wait when available to avoid CPU-intensive busy-wait.
+ */
+export declare function sleepSync(ms: number): void;
+/**
+ * Execute a callback while holding the config lock.
+ */
+export declare function withConfigWriteLock<T>(callback: () => T): T;
+/**
+ * Load unified config directly from disk while lock is already held.
+ * Falls back to empty config when file doesn't exist.
+ *
+ * Forward-reference: mergeWithDefaults and validateCompositeVariants are
+ * passed as callbacks to avoid a circular dependency. They will be imported
+ * directly once all phases are complete.
+ */
+export declare function loadUnifiedConfigWithLockHeld(mergeWithDefaults: (partial: Partial<UnifiedConfig>) => UnifiedConfig, validateCompositeVariants: (config: UnifiedConfig) => void): UnifiedConfig;
+/**
+ * Write unified config to disk while lock is already held.
+ * Uses atomic write (temp file + rename) to prevent corruption.
+ *
+ * Forward-reference: generateYamlHeader and generateYamlWithComments are
+ * passed as callbacks to avoid a circular dependency. They will be imported
+ * directly once all phases are complete.
+ */
+export declare function writeUnifiedConfigWithLockHeld(config: UnifiedConfig, generateYamlHeader: () => string, generateYamlWithComments: (config: UnifiedConfig) => string): void;
+//# sourceMappingURL=io-locks.d.ts.map

package/dist/config/loader/io-locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-locks.d.ts","sourceRoot":"","sources":["../../../src/config/loader/io-locks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAC9C,iDAAiD;AACjD,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,mBAAmB,QAAwD,CAAC;AACzF,eAAO,MAAM,mBAAmB,QAA0C,CAAC;AAM3E;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AA0BD;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAuC3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAanD;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAS1C;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAwB3D;AAMD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,aAAa,EACrE,yBAAyB,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GACzD,aAAa,CAgBf;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,kBAAkB,EAAE,MAAM,MAAM,EAChC,wBAAwB,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,GAC1D,IAAI,CAwCN"}

package/dist/config/loader/io-locks.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * io-locks.ts
+ *
+ * Path constants, lockfile management, and config I/O helpers extracted from
+ * unified-config-loader.ts (Phase 1 split — issue #1164).
+ *
+ * Forward-reference note: loadUnifiedConfigWithLockHeld and
+ * writeUnifiedConfigWithLockHeld depend on mergeWithDefaults,
+ * validateCompositeVariants, generateYamlHeader, and generateYamlWithComments
+ * which still live in unified-config-loader.ts (extracted in later phases).
+ * Those are passed as callbacks to avoid a circular import. Once Phases 2–3
+ * land in separate modules with no dependency on this file, they can be
+ * imported directly.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeUnifiedConfigWithLockHeld = exports.loadUnifiedConfigWithLockHeld = exports.withConfigWriteLock = exports.sleepSync = exports.hasLegacyConfig = exports.hasUnifiedConfig = exports.releaseLock = exports.acquireLock = exports.getConfigJsonPath = exports.getConfigYamlPath = exports.GO_DURATION_PATTERN = exports.GO_DURATION_SEGMENT = exports.LOCK_STALE_MS = exports.CONFIG_LOCK = exports.CONFIG_JSON = exports.CONFIG_YAML = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const yaml = __importStar(require("js-yaml"));
+const config_manager_1 = require("../../utils/config-manager");
+const unified_config_types_1 = require("../unified-config-types");
+// ---------------------------------------------------------------------------
+// Path constants
+// ---------------------------------------------------------------------------
+exports.CONFIG_YAML = 'config.yaml';
+exports.CONFIG_JSON = 'config.json';
+exports.CONFIG_LOCK = 'config.yaml.lock';
+/** Lock is stale after this many milliseconds */
+exports.LOCK_STALE_MS = 5000;
+exports.GO_DURATION_SEGMENT = String.raw `(?:\d+(?:\.\d+)?(?:ns|us|µs|μs|ms|s|m|h))`;
+exports.GO_DURATION_PATTERN = new RegExp(`^${exports.GO_DURATION_SEGMENT}+$`);
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+/**
+ * Get path to unified config.yaml
+ */
+function getConfigYamlPath() {
+    return path.join((0, config_manager_1.getCcsDir)(), exports.CONFIG_YAML);
+}
+exports.getConfigYamlPath = getConfigYamlPath;
+/**
+ * Get path to legacy config.json
+ */
+function getConfigJsonPath() {
+    return path.join((0, config_manager_1.getCcsDir)(), exports.CONFIG_JSON);
+}
+exports.getConfigJsonPath = getConfigJsonPath;
+/**
+ * Get path to config lockfile (internal)
+ */
+function getLockFilePath() {
+    return path.join((0, config_manager_1.getCcsDir)(), exports.CONFIG_LOCK);
+}
+// ---------------------------------------------------------------------------
+// Process check
+// ---------------------------------------------------------------------------
+function processExists(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Lockfile primitives
+// ---------------------------------------------------------------------------
+/**
+ * Acquire lockfile for config write operations.
+ * Returns a lock token if acquired, null if already locked by another process.
+ * Cleans up stale locks (older than LOCK_STALE_MS).
+ */
+function acquireLock() {
+    const lockPath = getLockFilePath();
+    const lockDir = path.dirname(lockPath);
+    const lockToken = crypto.randomUUID();
+    const lockData = `${process.pid}\n${Date.now()}\n${lockToken}`;
+    try {
+        if (!fs.existsSync(lockDir)) {
+            fs.mkdirSync(lockDir, { recursive: true, mode: 0o700 });
+        }
+        // Check if lock exists
+        if (fs.existsSync(lockPath)) {
+            const content = fs.readFileSync(lockPath, 'utf8');
+            const [pidStr, timestampStr] = content.trim().split('\n');
+            const pid = Number.parseInt(pidStr, 10);
+            const timestamp = Number.parseInt(timestampStr, 10);
+            const hasLiveOwner = Number.isInteger(pid) && pid > 0 && processExists(pid);
+            const isStale = !Number.isFinite(timestamp) || Date.now() - timestamp > exports.LOCK_STALE_MS;
+            if (hasLiveOwner) {
+                return null;
+            }
+            if (isStale || !hasLiveOwner) {
+                fs.unlinkSync(lockPath);
+            }
+        }
+        // Acquire lock
+        fs.writeFileSync(lockPath, lockData, { flag: 'wx', mode: 0o600 });
+        return lockToken;
+    }
+    catch (error) {
+        // EEXIST means another process acquired the lock between our check and write
+        if (error.code === 'EEXIST') {
+            return null;
+        }
+        return null;
+    }
+}
+exports.acquireLock = acquireLock;
+/**
+ * Release lockfile after config write operation.
+ */
+function releaseLock(lockToken) {
+    const lockPath = getLockFilePath();
+    try {
+        if (fs.existsSync(lockPath)) {
+            const content = fs.readFileSync(lockPath, 'utf8');
+            const fileToken = content.trim().split('\n')[2];
+            if (fileToken === lockToken) {
+                fs.unlinkSync(lockPath);
+            }
+        }
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+}
+exports.releaseLock = releaseLock;
+// ---------------------------------------------------------------------------
+// Config format detection
+// ---------------------------------------------------------------------------
+/**
+ * Check if unified config.yaml exists
+ */
+function hasUnifiedConfig() {
+    return fs.existsSync(getConfigYamlPath());
+}
+exports.hasUnifiedConfig = hasUnifiedConfig;
+/**
+ * Check if legacy config.json exists
+ */
+function hasLegacyConfig() {
+    return fs.existsSync(getConfigJsonPath());
+}
+exports.hasLegacyConfig = hasLegacyConfig;
+// ---------------------------------------------------------------------------
+// Sync sleep
+// ---------------------------------------------------------------------------
+/**
+ * Sync sleep helper for lock retry loops.
+ * Uses Atomics.wait when available to avoid CPU-intensive busy-wait.
+ */
+function sleepSync(ms) {
+    try {
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+    }
+    catch {
+        const end = Date.now() + ms;
+        while (Date.now() < end) {
+            /* busy-wait */
+        }
+    }
+}
+exports.sleepSync = sleepSync;
+// ---------------------------------------------------------------------------
+// Lock-aware execution wrapper
+// ---------------------------------------------------------------------------
+/**
+ * Execute a callback while holding the config lock.
+ */
+function withConfigWriteLock(callback) {
+    // Acquire lock (retry for up to 1 second)
+    const maxRetries = 10;
+    const retryDelayMs = 100;
+    let lockToken = null;
+    for (let i = 0; i < maxRetries; i++) {
+        const acquiredToken = acquireLock();
+        if (acquiredToken) {
+            lockToken = acquiredToken;
+            break;
+        }
+        sleepSync(retryDelayMs);
+    }
+    if (!lockToken) {
+        throw new Error('Config file is locked by another process. Wait a moment and try again.');
+    }
+    try {
+        return callback();
+    }
+    finally {
+        // Always release lock
+        releaseLock(lockToken);
+    }
+}
+exports.withConfigWriteLock = withConfigWriteLock;
+// ---------------------------------------------------------------------------
+// Lock-held read/write helpers
+// ---------------------------------------------------------------------------
+/**
+ * Load unified config directly from disk while lock is already held.
+ * Falls back to empty config when file doesn't exist.
+ *
+ * Forward-reference: mergeWithDefaults and validateCompositeVariants are
+ * passed as callbacks to avoid a circular dependency. They will be imported
+ * directly once all phases are complete.
+ */
+function loadUnifiedConfigWithLockHeld(mergeWithDefaults, validateCompositeVariants) {
+    const yamlPath = getConfigYamlPath();
+    if (!fs.existsSync(yamlPath)) {
+        return (0, unified_config_types_1.createEmptyUnifiedConfig)();
+    }
+    const content = fs.readFileSync(yamlPath, 'utf8');
+    const parsed = yaml.load(content);
+    if (!(0, unified_config_types_1.isUnifiedConfig)(parsed)) {
+        throw new Error(`Invalid config format in ${yamlPath}`);
+    }
+    const merged = mergeWithDefaults(parsed);
+    validateCompositeVariants(merged);
+    return merged;
+}
+exports.loadUnifiedConfigWithLockHeld = loadUnifiedConfigWithLockHeld;
+/**
+ * Write unified config to disk while lock is already held.
+ * Uses atomic write (temp file + rename) to prevent corruption.
+ *
+ * Forward-reference: generateYamlHeader and generateYamlWithComments are
+ * passed as callbacks to avoid a circular dependency. They will be imported
+ * directly once all phases are complete.
+ */
+function writeUnifiedConfigWithLockHeld(config, generateYamlHeader, generateYamlWithComments) {
+    const yamlPath = getConfigYamlPath();
+    const dir = path.dirname(yamlPath);
+    // Ensure directory exists
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    // Ensure version is set
+    config.version = unified_config_types_1.UNIFIED_CONFIG_VERSION;
+    // Generate YAML with section comments
+    const yamlContent = generateYamlWithComments(config);
+    const content = generateYamlHeader() + yamlContent;
+    // Atomic write: write to temp file, then rename
+    const tempPath = `${yamlPath}.tmp.${process.pid}`;
+    try {
+        fs.writeFileSync(tempPath, content, { mode: 0o600 });
+        fs.renameSync(tempPath, yamlPath);
+    }
+    catch (error) {
+        // Clean up temp file on error
+        if (fs.existsSync(tempPath)) {
+            try {
+                fs.unlinkSync(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+        // Classify filesystem errors
+        const err = error;
+        if (err.code === 'ENOSPC') {
+            throw new Error('Disk full - cannot save config. Free up space and try again.');
+        }
+        else if (err.code === 'EROFS' || err.code === 'EACCES') {
+            throw new Error(`Cannot write config - check file permissions: ${err.message}`);
+        }
+        throw error;
+    }
+}
+exports.writeUnifiedConfigWithLockHeld = writeUnifiedConfigWithLockHeld;
+//# sourceMappingURL=io-locks.js.map

package/dist/config/loader/io-locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-locks.js","sourceRoot":"","sources":["../../../src/config/loader/io-locks.ts"],"names":[],"mappings":"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"}

package/dist/config/loader/normalizers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * normalizers.ts
+ *
+ * Input normalization and validation helpers extracted from
+ * unified-config-loader.ts (Phase 2 split — issue #1164).
+ *
+ * Contains: browser config normalizers, session affinity TTL normalizer,
+ * composite variant validator, continuity config normalizer, and official
+ * channels config normalizer.
+ */
+import type { UnifiedConfig, BrowserConfig, BrowserEvalMode, BrowserToolPolicy, OfficialChannelsConfig, ContinuityConfig } from '../unified-config-types';
+export declare function normalizeBrowserDevtoolsPort(value: number | undefined): number;
+export declare function normalizeBrowserPolicy(value: string | undefined): BrowserToolPolicy;
+export declare function normalizeBrowserEvalMode(value: string | undefined): BrowserEvalMode;
+export declare function canonicalizeBrowserConfig(config?: BrowserConfig, fallback?: BrowserConfig): BrowserConfig;
+export declare function normalizeSessionAffinityTtl(value: unknown, fallback: string): string;
+export declare function hasPositiveDuration(value: string): boolean;
+/**
+ * Validate composite variant provider strings.
+ * Warns about invalid providers in composite variant configurations.
+ */
+export declare function validateCompositeVariants(config: UnifiedConfig): void;
+/**
+ * Normalize continuity inheritance mapping payload.
+ * Keeps only non-empty string keys and values.
+ */
+export declare function normalizeContinuityInheritanceMap(value: unknown): Record<string, string> | undefined;
+/**
+ * Normalize continuity section.
+ * Supports legacy root key: continuity_inherit_from_account.
+ */
+export declare function normalizeContinuityConfig(partial: Partial<UnifiedConfig>): ContinuityConfig | undefined;
+export interface LegacyDiscordChannelsConfig {
+    enabled?: boolean;
+    unattended?: boolean;
+}
+export declare function normalizeOfficialChannelsConfig(partial: Partial<UnifiedConfig> & {
+    discord_channels?: LegacyDiscordChannelsConfig;
+}): OfficialChannelsConfig;
+//# sourceMappingURL=normalizers.d.ts.map

package/dist/config/loader/normalizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizers.d.ts","sourceRoot":"","sources":["../../../src/config/loader/normalizers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EAEtB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAcjC,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAW9E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAEnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAMnF;AAED,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,aAAa,EACtB,QAAQ,GAAE,aAAsC,GAC/C,aAAa,CAsBf;AAMD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWpF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAU1D;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAerE;AAMD;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAkBpC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,gBAAgB,GAAG,SAAS,CAiB9B;AAMD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;IAAE,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;CAAE,GACnF,sBAAsB,CAqBxB"}

package/dist/config/loader/normalizers.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * normalizers.ts
+ *
+ * Input normalization and validation helpers extracted from
+ * unified-config-loader.ts (Phase 2 split — issue #1164).
+ *
+ * Contains: browser config normalizers, session affinity TTL normalizer,
+ * composite variant validator, continuity config normalizer, and official
+ * channels config normalizer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOfficialChannelsConfig = exports.normalizeContinuityConfig = exports.normalizeContinuityInheritanceMap = exports.validateCompositeVariants = exports.hasPositiveDuration = exports.normalizeSessionAffinityTtl = exports.canonicalizeBrowserConfig = exports.normalizeBrowserEvalMode = exports.normalizeBrowserPolicy = exports.normalizeBrowserDevtoolsPort = void 0;
+const unified_config_types_1 = require("../unified-config-types");
+const composite_validator_1 = require("../../cliproxy/config/composite-validator");
+const official_channels_ids_1 = require("../../channels/official-channels-ids");
+const browser_settings_1 = require("../../utils/browser/browser-settings");
+const io_locks_1 = require("./io-locks");
+// ---------------------------------------------------------------------------
+// Browser normalizers
+// ---------------------------------------------------------------------------
+function normalizeBrowserDevtoolsPort(value) {
+    if (!Number.isFinite(value)) {
+        return unified_config_types_1.DEFAULT_BROWSER_CONFIG.claude.devtools_port;
+    }
+    const port = Math.floor(value);
+    if (port < 1 || port > 65535) {
+        return unified_config_types_1.DEFAULT_BROWSER_CONFIG.claude.devtools_port;
+    }
+    return port;
+}
+exports.normalizeBrowserDevtoolsPort = normalizeBrowserDevtoolsPort;
+function normalizeBrowserPolicy(value) {
+    return value === 'auto' || value === 'manual' ? value : unified_config_types_1.DEFAULT_BROWSER_CONFIG.claude.policy;
+}
+exports.normalizeBrowserPolicy = normalizeBrowserPolicy;
+function normalizeBrowserEvalMode(value) {
+    if (value === 'disabled' || value === 'readonly' || value === 'readwrite') {
+        return value;
+    }
+    return unified_config_types_1.DEFAULT_BROWSER_CONFIG.claude.eval_mode ?? 'readonly';
+}
+exports.normalizeBrowserEvalMode = normalizeBrowserEvalMode;
+function canonicalizeBrowserConfig(config, fallback = unified_config_types_1.DEFAULT_BROWSER_CONFIG) {
+    const claudeUserDataDir = config?.claude?.user_data_dir === undefined
+        ? fallback.claude.user_data_dir || (0, browser_settings_1.getRecommendedBrowserUserDataDir)()
+        : config.claude.user_data_dir.trim() || (0, browser_settings_1.getRecommendedBrowserUserDataDir)();
+    return {
+        claude: {
+            enabled: config?.claude?.enabled ?? fallback.claude.enabled,
+            policy: normalizeBrowserPolicy(config?.claude?.policy ?? fallback.claude.policy),
+            user_data_dir: claudeUserDataDir,
+            devtools_port: normalizeBrowserDevtoolsPort(config?.claude?.devtools_port ?? fallback.claude.devtools_port),
+            eval_mode: normalizeBrowserEvalMode(config?.claude?.eval_mode ?? fallback.claude.eval_mode),
+        },
+        codex: {
+            enabled: config?.codex?.enabled ?? fallback.codex.enabled,
+            policy: normalizeBrowserPolicy(config?.codex?.policy ?? fallback.codex.policy),
+            eval_mode: normalizeBrowserEvalMode(config?.codex?.eval_mode ?? fallback.codex.eval_mode),
+        },
+    };
+}
+exports.canonicalizeBrowserConfig = canonicalizeBrowserConfig;
+// ---------------------------------------------------------------------------
+// Session affinity TTL normalizer
+// ---------------------------------------------------------------------------
+function normalizeSessionAffinityTtl(value, fallback) {
+    if (typeof value !== 'string') {
+        return fallback;
+    }
+    const trimmed = value.trim();
+    if (!trimmed || !io_locks_1.GO_DURATION_PATTERN.test(trimmed) || !hasPositiveDuration(trimmed)) {
+        return fallback;
+    }
+    return trimmed;
+}
+exports.normalizeSessionAffinityTtl = normalizeSessionAffinityTtl;
+function hasPositiveDuration(value) {
+    const segments = value.match(new RegExp(io_locks_1.GO_DURATION_SEGMENT, 'g'));
+    if (!segments) {
+        return false;
+    }
+    return segments.some((segment) => {
+        const numeric = parseFloat(segment);
+        return Number.isFinite(numeric) && numeric > 0;
+    });
+}
+exports.hasPositiveDuration = hasPositiveDuration;
+// ---------------------------------------------------------------------------
+// Composite variant validator
+// ---------------------------------------------------------------------------
+/**
+ * Validate composite variant provider strings.
+ * Warns about invalid providers in composite variant configurations.
+ */
+function validateCompositeVariants(config) {
+    const variants = config.cliproxy?.variants;
+    if (!variants)
+        return;
+    for (const [name, variant] of Object.entries(variants)) {
+        if ('type' in variant && variant.type === 'composite') {
+            const error = (0, composite_validator_1.validateCompositeTiers)(variant.tiers, {
+                defaultTier: variant.default_tier,
+                requireAllTiers: true,
+            });
+            if (error) {
+                console.warn(`[!] Variant '${name}': invalid composite config (${error})`);
+            }
+        }
+    }
+}
+exports.validateCompositeVariants = validateCompositeVariants;
+// ---------------------------------------------------------------------------
+// Continuity config normalizer
+// ---------------------------------------------------------------------------
+/**
+ * Normalize continuity inheritance mapping payload.
+ * Keeps only non-empty string keys and values.
+ */
+function normalizeContinuityInheritanceMap(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const normalized = {};
+    for (const [profileName, accountName] of Object.entries(value)) {
+        const normalizedProfile = profileName.trim();
+        const normalizedAccount = typeof accountName === 'string' ? accountName.trim() : '';
+        if (!normalizedProfile || !normalizedAccount) {
+            continue;
+        }
+        normalized[normalizedProfile] = normalizedAccount;
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+exports.normalizeContinuityInheritanceMap = normalizeContinuityInheritanceMap;
+/**
+ * Normalize continuity section.
+ * Supports legacy root key: continuity_inherit_from_account.
+ */
+function normalizeContinuityConfig(partial) {
+    const legacyMap = normalizeContinuityInheritanceMap(partial
+        .continuity_inherit_from_account);
+    const continuityMap = normalizeContinuityInheritanceMap(partial.continuity?.inherit_from_account);
+    if (!legacyMap && !continuityMap) {
+        return undefined;
+    }
+    return {
+        inherit_from_account: {
+            ...(legacyMap ?? {}),
+            ...(continuityMap ?? {}),
+        },
+    };
+}
+exports.normalizeContinuityConfig = normalizeContinuityConfig;
+function normalizeOfficialChannelsConfig(partial) {
+    const hasCanonicalChannelsSection = partial.channels !== undefined;
+    const hasExplicitSelectedField = hasCanonicalChannelsSection &&
+        Object.prototype.hasOwnProperty.call(partial.channels, 'selected');
+    const rawSelected = hasExplicitSelectedField && Array.isArray(partial.channels?.selected)
+        ? partial.channels.selected.filter((value) => (0, official_channels_ids_1.isOfficialChannelId)(value))
+        : [];
+    return {
+        selected: hasCanonicalChannelsSection
+            ? (0, official_channels_ids_1.normalizeOfficialChannelIds)(rawSelected)
+            : (0, official_channels_ids_1.resolveLegacyDiscordSelection)(partial.discord_channels?.enabled),
+        unattended: partial.channels?.unattended ??
+            partial.discord_channels?.unattended ??
+            unified_config_types_1.DEFAULT_OFFICIAL_CHANNELS_CONFIG.unattended,
+    };
+}
+exports.normalizeOfficialChannelsConfig = normalizeOfficialChannelsConfig;
+//# sourceMappingURL=normalizers.js.map

package/dist/config/loader/normalizers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizers.js","sourceRoot":"","sources":["../../../src/config/loader/normalizers.ts"],"names":[],"mappings":"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"}

package/dist/config/loader/yaml-serializer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * yaml-serializer.ts
+ *
+ * YAML generation helpers extracted from unified-config-loader.ts
+ * (Phase 3 split — issue #1164).
+ *
+ * Contains: generateYamlHeader, generateYamlWithComments.
+ * These produce the commented YAML written to config.yaml on every save.
+ */
+import type { UnifiedConfig } from '../unified-config-types';
+/**
+ * Generate YAML header with helpful comments.
+ */
+export declare function generateYamlHeader(): string;
+/**
+ * Generate YAML content with section comments for better readability.
+ */
+export declare function generateYamlWithComments(config: UnifiedConfig): string;
+//# sourceMappingURL=yaml-serializer.d.ts.map

package/dist/config/loader/yaml-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-serializer.d.ts","sourceRoot":"","sources":["../../../src/config/loader/yaml-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAsUtE"}