@cleocode/core 2.0.0

package/dist/config.js

@@ -0,0 +1,287 @@
+/**
+ * Configuration engine for CLEO V2.
+ *
+ * Resolution priority: CLI flags > Environment vars > Project config > Global config > Defaults
+ *
+ * @epic T4454
+ * @task T4458
+ */
+import { existsSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { readJson, saveJson } from './store/json.js';
+import { getConfigPath, getGlobalConfigPath } from './paths.js';
+/** Default configuration values. */
+const DEFAULTS = {
+    version: '2.10.0',
+    output: {
+        defaultFormat: 'json',
+        showColor: true,
+        showUnicode: true,
+        showProgressBars: true,
+        dateFormat: 'relative',
+    },
+    backup: {
+        maxOperationalBackups: 10,
+        maxSafetyBackups: 5,
+        compressionEnabled: false,
+    },
+    hierarchy: {
+        maxDepth: 3,
+        maxSiblings: 0,
+        cascadeDelete: false,
+        maxActiveSiblings: 0,
+        countDoneInLimit: false,
+        enforcementProfile: 'llm-agent-first',
+    },
+    session: {
+        autoStart: false,
+        requireNotes: false,
+        multiSession: false,
+    },
+    lifecycle: {
+        mode: 'strict',
+    },
+    logging: {
+        level: 'info',
+        filePath: 'logs/cleo.log',
+        maxFileSize: 10 * 1024 * 1024, // 10MB
+        maxFiles: 5,
+        auditRetentionDays: 90,
+        archiveBeforePrune: true,
+    },
+    sharing: {
+        mode: 'none',
+        commitAllowlist: [],
+        denylist: [],
+    },
+    signaldock: {
+        enabled: false,
+        mode: 'http',
+        endpoint: 'http://localhost:4000',
+        agentPrefix: 'cleo-',
+        privacyTier: 'private',
+    },
+};
+/** Environment variable to config path mapping. */
+const ENV_MAP = {
+    CLEO_FORMAT: 'output.defaultFormat',
+    CLEO_OUTPUT_DEFAULT_FORMAT: 'output.defaultFormat',
+    CLEO_OUTPUT_SHOW_COLOR: 'output.showColor',
+    CLEO_OUTPUT_SHOW_UNICODE: 'output.showUnicode',
+    CLEO_OUTPUT_SHOW_PROGRESS_BARS: 'output.showProgressBars',
+    CLEO_OUTPUT_DATE_FORMAT: 'output.dateFormat',
+    CLEO_HIERARCHY_MAX_DEPTH: 'hierarchy.maxDepth',
+    CLEO_HIERARCHY_MAX_SIBLINGS: 'hierarchy.maxSiblings',
+    CLEO_HIERARCHY_MAX_ACTIVE_SIBLINGS: 'hierarchy.maxActiveSiblings',
+    CLEO_HIERARCHY_ENFORCEMENT_PROFILE: 'hierarchy.enforcementProfile',
+    CLEO_SESSION_AUTO_START: 'session.autoStart',
+    CLEO_SESSION_REQUIRE_NOTES: 'session.requireNotes',
+    CLEO_LIFECYCLE_MODE: 'lifecycle.mode',
+    CLEO_LOG_LEVEL: 'logging.level',
+    CLEO_LOG_FILE: 'logging.filePath',
+    CLEO_AUDIT_RETENTION_DAYS: 'logging.auditRetentionDays',
+    CLEO_SIGNALDOCK_ENABLED: 'signaldock.enabled',
+    CLEO_SIGNALDOCK_ENDPOINT: 'signaldock.endpoint',
+};
+/**
+ * Get a value at a dotted path from an object.
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Set a value at a dotted path in an object (mutates).
+ */
+function setNestedValue(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (current[part] === undefined || typeof current[part] !== 'object') {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * Deep merge two objects. Source values override target values.
+ * Arrays are replaced (not merged).
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceVal = source[key];
+        const targetVal = result[key];
+        if (sourceVal !== null &&
+            typeof sourceVal === 'object' &&
+            !Array.isArray(sourceVal) &&
+            targetVal !== null &&
+            typeof targetVal === 'object' &&
+            !Array.isArray(targetVal)) {
+            result[key] = deepMerge(targetVal, sourceVal);
+        }
+        else {
+            result[key] = sourceVal;
+        }
+    }
+    return result;
+}
+/**
+ * Parse an environment variable value to the appropriate type.
+ */
+function parseEnvValue(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    const num = Number(value);
+    if (!Number.isNaN(num) && value.trim() !== '')
+        return num;
+    return value;
+}
+/**
+ * Load and merge configuration from all sources.
+ * Priority: defaults < global config < project config < environment vars
+ */
+export async function loadConfig(cwd) {
+    // Start with defaults
+    let merged = JSON.parse(JSON.stringify(DEFAULTS));
+    // Layer 1: Global config
+    const globalConfig = await readJson(getGlobalConfigPath());
+    if (globalConfig) {
+        merged = deepMerge(merged, globalConfig);
+    }
+    // Layer 2: Project config
+    const projectConfig = await readJson(getConfigPath(cwd));
+    if (projectConfig) {
+        // Map pinoLogging config key to the logging section used by the pino logger factory
+        if (projectConfig.pinoLogging && typeof projectConfig.pinoLogging === 'object') {
+            merged.logging = deepMerge((merged.logging ?? {}), projectConfig.pinoLogging);
+        }
+        merged = deepMerge(merged, projectConfig);
+    }
+    // Layer 3: Environment variables
+    for (const [envKey, configPath] of Object.entries(ENV_MAP)) {
+        const envValue = process.env[envKey];
+        if (envValue !== undefined) {
+            setNestedValue(merged, configPath, parseEnvValue(envValue));
+        }
+    }
+    // merged starts from DEFAULTS (CleoConfig) and is built via deep merge.
+    // Partial<CleoConfig> provides the structural overlap for a safe assertion.
+    return merged;
+}
+/**
+ * Get a single config value with source tracking.
+ * Returns the value and which source it came from.
+ */
+export async function getConfigValue(path, cwd) {
+    // Check environment variables first
+    for (const [envKey, configPath] of Object.entries(ENV_MAP)) {
+        if (configPath === path && process.env[envKey] !== undefined) {
+            return {
+                value: parseEnvValue(process.env[envKey]),
+                source: 'env',
+            };
+        }
+    }
+    // Check project config
+    const projectConfig = await readJson(getConfigPath(cwd));
+    if (projectConfig) {
+        const val = getNestedValue(projectConfig, path);
+        if (val !== undefined) {
+            return { value: val, source: 'project' };
+        }
+    }
+    // Check global config
+    const globalConfig = await readJson(getGlobalConfigPath());
+    if (globalConfig) {
+        const val = getNestedValue(globalConfig, path);
+        if (val !== undefined) {
+            return { value: val, source: 'global' };
+        }
+    }
+    // Fall back to defaults
+    const defaultVal = getNestedValue({ ...DEFAULTS }, path);
+    return { value: defaultVal, source: 'default' };
+}
+/**
+ * Get a raw config value from the project config file only (no cascade).
+ * Returns undefined if the key is not found.
+ * Used by the engine layer for simple key lookups without source tracking.
+ * @task T4789
+ */
+export async function getRawConfigValue(key, cwd) {
+    const configPath = getConfigPath(cwd);
+    const config = await readJson(configPath);
+    if (!config)
+        return undefined;
+    if (!key)
+        return config;
+    return getNestedValue(config, key);
+}
+/**
+ * Get the full raw project config (no cascade).
+ * Returns null if no config file exists.
+ * @task T4789
+ */
+export async function getRawConfig(cwd) {
+    return readJson(getConfigPath(cwd));
+}
+/**
+ * Parse a string value into its appropriate JS type.
+ * Handles booleans, null, integers, floats, and JSON.
+ * @task T4789
+ */
+export function parseConfigValue(value) {
+    if (typeof value !== 'string')
+        return value;
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value === 'null')
+        return null;
+    if (/^-?\d+$/.test(value))
+        return parseInt(value, 10);
+    if (/^-?\d+\.\d+$/.test(value))
+        return parseFloat(value);
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+/**
+ * Set a config value in the project or global config file (dot-notation supported).
+ * Creates intermediate objects as needed. Parses string values into
+ * appropriate types (boolean, number, null, JSON).
+ * @task T4789
+ * @task T4795
+ */
+export async function setConfigValue(key, value, cwd, opts) {
+    const configPath = opts?.global ? getGlobalConfigPath() : getConfigPath(cwd);
+    // Ensure file exists
+    if (!existsSync(configPath)) {
+        const dir = dirname(configPath);
+        await mkdir(dir, { recursive: true });
+        await writeFile(configPath, '{}', 'utf-8');
+    }
+    const config = (await readJson(configPath)) ?? {};
+    const parsedValue = parseConfigValue(value);
+    setNestedValue(config, key, parsedValue);
+    await saveJson(configPath, config);
+    return { key, value: parsedValue, scope: opts?.global ? 'global' : 'project' };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Centralized constants for CLEO core modules.
+ */
+/**
+ * Configuration files relative to .cleo/ that MUST remain tracked by project git.
+ * These are JSON/text config files only — NOT databases.
+ * SQLite databases (tasks.db) are excluded: they must be gitignored to
+ * prevent data-loss from merge conflicts (see ADR-013).
+ *
+ * If any of these files are gitignored, cleo doctor reports a critical finding.
+ */
+export declare const CORE_PROTECTED_FILES: readonly ["config.json", ".gitignore", "project-info.json", "project-context.json"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,qFAKvB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,18 @@
+/**
+ * Centralized constants for CLEO core modules.
+ */
+/**
+ * Configuration files relative to .cleo/ that MUST remain tracked by project git.
+ * These are JSON/text config files only — NOT databases.
+ * SQLite databases (tasks.db) are excluded: they must be gitignored to
+ * prevent data-loss from merge conflicts (see ADR-013).
+ *
+ * If any of these files are gitignored, cleo doctor reports a critical finding.
+ */
+export const CORE_PROTECTED_FILES = [
+    'config.json',
+    '.gitignore',
+    'project-info.json',
+    'project-context.json',
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,aAAa;IACb,YAAY;IACZ,mBAAmB;IACnB,sBAAsB;CACd,CAAC"}

package/dist/context/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Context window monitoring core module.
+ * @task T4535
+ * @epic T4454
+ */
+/** Get context status. */
+export declare function getContextStatus(opts: {
+    session?: string;
+    cwd?: string;
+}): Promise<Record<string, unknown>>;
+/** Check context threshold (returns exit code info). */
+export declare function checkContextThreshold(opts: {
+    session?: string;
+    cwd?: string;
+}): Promise<Record<string, unknown> & {
+    exitCode?: number;
+}>;
+/** List all context state files. */
+export declare function listContextSessions(cwd?: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+BH,0BAA0B;AAC1B,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmCnC;AAED,wDAAwD;AACxD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B3D;AAED,oCAAoC;AACpC,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4CxF"}

package/dist/context/index.js

@@ -0,0 +1,137 @@
+/**
+ * Context window monitoring core module.
+ * @task T4535
+ * @epic T4454
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+function getCleoDir(cwd) {
+    return join(cwd ?? process.cwd(), '.cleo');
+}
+function getStateFile(session, cwd) {
+    const cleoDir = getCleoDir(cwd);
+    if (session) {
+        const sessionFile = join(cleoDir, 'context-states', `context-state-${session}.json`);
+        if (existsSync(sessionFile))
+            return sessionFile;
+    }
+    // Check for current session binding
+    const currentSessionFile = join(cleoDir, '.current-session');
+    if (existsSync(currentSessionFile)) {
+        const currentSession = readFileSync(currentSessionFile, 'utf-8').trim();
+        if (currentSession) {
+            const sessionFile = join(cleoDir, 'context-states', `context-state-${currentSession}.json`);
+            if (existsSync(sessionFile))
+                return sessionFile;
+        }
+    }
+    // Fall back to global state file
+    return join(cleoDir, '.context-state.json');
+}
+/** Get context status. */
+export async function getContextStatus(opts) {
+    const stateFile = getStateFile(opts.session, opts.cwd);
+    if (!existsSync(stateFile)) {
+        return {
+            available: false,
+            message: 'No context state file',
+            hint: 'Ensure status line integration is configured',
+        };
+    }
+    const state = JSON.parse(readFileSync(stateFile, 'utf-8'));
+    const timestamp = state.timestamp;
+    const staleMs = state.staleAfterMs ?? 5000;
+    const percentage = state.contextWindow?.percentage ?? 0;
+    const current = state.contextWindow?.currentTokens ?? 0;
+    const max = state.contextWindow?.maxTokens ?? 0;
+    let status = state.status ?? 'unknown';
+    // Check staleness
+    const fileTime = new Date(timestamp).getTime();
+    const now = Date.now();
+    if (now - fileTime > staleMs) {
+        status = 'stale';
+    }
+    return {
+        available: true,
+        status,
+        percentage,
+        currentTokens: current,
+        maxTokens: max,
+        timestamp,
+        stale: status === 'stale',
+    };
+}
+/** Check context threshold (returns exit code info). */
+export async function checkContextThreshold(opts) {
+    const stateFile = getStateFile(opts.session, opts.cwd);
+    if (!existsSync(stateFile)) {
+        return { status: 'stale', exitCode: 54 };
+    }
+    const state = JSON.parse(readFileSync(stateFile, 'utf-8'));
+    const timestamp = state.timestamp;
+    const staleMs = state.staleAfterMs ?? 5000;
+    let status = state.status ?? 'unknown';
+    const fileTime = new Date(timestamp).getTime();
+    if (Date.now() - fileTime > staleMs) {
+        status = 'stale';
+    }
+    const exitCodeMap = {
+        ok: 0,
+        warning: 50,
+        caution: 51,
+        critical: 52,
+        emergency: 53,
+        stale: 54,
+    };
+    return {
+        status,
+        percentage: state.contextWindow?.percentage ?? 0,
+        exitCode: exitCodeMap[status] ?? 54,
+    };
+}
+/** List all context state files. */
+export async function listContextSessions(cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const sessions = [];
+    // Check canonical directory
+    const statesDir = join(cleoDir, 'context-states');
+    if (existsSync(statesDir)) {
+        for (const file of readdirSync(statesDir)) {
+            if (file.startsWith('context-state-') && file.endsWith('.json')) {
+                const filePath = join(statesDir, file);
+                try {
+                    const state = JSON.parse(readFileSync(filePath, 'utf-8'));
+                    sessions.push({
+                        file: basename(filePath),
+                        sessionId: state.sessionId ?? null,
+                        percentage: state.contextWindow?.percentage ?? 0,
+                        status: state.status ?? 'unknown',
+                        timestamp: state.timestamp,
+                    });
+                }
+                catch {
+                    // skip invalid files
+                }
+            }
+        }
+    }
+    // Check singleton fallback
+    const singletonFile = join(cleoDir, '.context-state.json');
+    if (existsSync(singletonFile)) {
+        try {
+            const state = JSON.parse(readFileSync(singletonFile, 'utf-8'));
+            sessions.push({
+                file: '.context-state.json',
+                sessionId: state.sessionId ?? 'global',
+                percentage: state.contextWindow?.percentage ?? 0,
+                status: state.status ?? 'unknown',
+                timestamp: state.timestamp,
+            });
+        }
+        catch {
+            // skip
+        }
+    }
+    return { sessions, count: sessions.length };
+}
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE3C,SAAS,UAAU,CAAC,GAAY;IAC9B,OAAO,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,YAAY,CAAC,OAAgB,EAAE,GAAY;IAClD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,OAAO,OAAO,CAAC,CAAC;QACrF,IAAI,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,WAAW,CAAC;IAClD,CAAC;IAED,oCAAoC;IACpC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAC7D,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACxE,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,cAAc,OAAO,CAAC,CAAC;YAC5F,IAAI,UAAU,CAAC,WAAW,CAAC;gBAAE,OAAO,WAAW,CAAC;QAClD,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,OAAO,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;AAC9C,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAGtC;IACC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,uBAAuB;YAChC,IAAI,EAAE,8CAA8C;SACrD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC;IAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,UAAU,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,EAAE,aAAa,IAAI,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,EAAE,SAAS,IAAI,CAAC,CAAC;IAChD,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC;IAEvC,kBAAkB;IAClB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,QAAQ,GAAG,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI;QACf,MAAM;QACN,UAAU;QACV,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,GAAG;QACd,SAAS;QACT,KAAK,EAAE,MAAM,KAAK,OAAO;KAC1B,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAG3C;IACC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC;IAC3C,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC;IAEvC,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/C,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,OAAO,EAAE,CAAC;QACpC,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAA2B;QAC1C,EAAE,EAAE,CAAC;QACL,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,OAAO;QACL,MAAM;QACN,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE,UAAU,IAAI,CAAC;QAChD,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAY;IACpD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAE/C,4BAA4B;IAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC1D,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC;wBACxB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;wBAClC,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE,UAAU,IAAI,CAAC;wBAChD,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;wBACjC,SAAS,EAAE,KAAK,CAAC,SAAS;qBAC3B,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,qBAAqB;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,qBAAqB;gBAC3B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,QAAQ;gBACtC,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE,UAAU,IAAI,CAAC;gBAChD,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;gBACjC,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC9C,CAAC"}

package/dist/engine-result.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Canonical EngineResult type used by dispatch engines and core modules.
+ *
+ * This type was originally defined in src/dispatch/engines/_error.ts.
+ * Moved to core so that core modules can reference it without
+ * importing from the dispatch layer.
+ *
+ * @task T5715
+ * @epic T5701
+ */
+import type { LAFSPage } from '@cleocode/lafs-protocol';
+/**
+ * Canonical EngineResult type used by all engines and core engine-compat modules.
+ */
+export interface EngineResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    page?: LAFSPage;
+    error?: {
+        code: string;
+        message: string;
+        exitCode?: number;
+        details?: unknown;
+        fix?: string;
+        alternatives?: Array<{
+            action: string;
+            command: string;
+        }>;
+    };
+}
+//# sourceMappingURL=engine-result.d.ts.map

package/dist/engine-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-result.d.ts","sourceRoot":"","sources":["../src/engine-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3D,CAAC;CACH"}

package/dist/engine-result.js

@@ -0,0 +1,12 @@
+/**
+ * Canonical EngineResult type used by dispatch engines and core modules.
+ *
+ * This type was originally defined in src/dispatch/engines/_error.ts.
+ * Moved to core so that core modules can reference it without
+ * importing from the dispatch layer.
+ *
+ * @task T5715
+ * @epic T5701
+ */
+export {};
+//# sourceMappingURL=engine-result.js.map

package/dist/engine-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-result.js","sourceRoot":"","sources":["../src/engine-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/error-catalog.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Unified Error Catalog -- single source of truth for all CLEO error definitions.
+ *
+ * Merges previously scattered error registries (error-registry.ts, _error.ts,
+ * mcp/lib/exit-codes.ts) into one canonical catalog keyed by ExitCode.
+ *
+ * Consumers should import from here instead of the legacy registries.
+ *
+ * @task T5240
+ */
+import type { LAFSErrorCategory } from '@cleocode/lafs-protocol';
+/**
+ * A single entry in the unified error catalog.
+ */
+export interface ErrorDefinition {
+    /** Numeric exit code from ExitCode enum. */
+    code: number;
+    /** Machine-readable name (matches ExitCode enum key). */
+    name: string;
+    /** LAFS error category for protocol conformance. */
+    category: LAFSErrorCategory;
+    /** Default human-readable message. */
+    message: string;
+    /** Default fix suggestion (copy-paste command or instruction). */
+    fix?: string;
+    /** HTTP status code for API/MCP responses. */
+    httpStatus: number;
+    /** Whether retry may succeed. */
+    recoverable: boolean;
+    /** LAFS-style string error code (E_CLEO_*). */
+    lafsCode: string;
+}
+/**
+ * The unified error catalog. Keyed by numeric ExitCode value.
+ */
+export declare const ERROR_CATALOG: ReadonlyMap<number, ErrorDefinition>;
+/**
+ * Look up an error definition by exit code.
+ */
+export declare function getErrorDefinition(code: number): ErrorDefinition | undefined;
+/**
+ * Look up an error definition by LAFS string code.
+ */
+export declare function getErrorDefinitionByLafsCode(lafsCode: string): ErrorDefinition | undefined;
+/**
+ * Get all error definitions as an array.
+ */
+export declare function getAllErrorDefinitions(): ErrorDefinition[];
+//# sourceMappingURL=error-catalog.d.ts.map

package/dist/error-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-catalog.d.ts","sourceRoot":"","sources":["../src/error-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAeD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAijC9D,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5E;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAK1F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CAE1D"}