@cleocode/cleo 2026.4.158 → 2026.5.0

package/dist/dispatch/lib/config-loader.js

@@ -0,0 +1,218 @@
+/**
+ * Configuration loader for CLEO dispatch layer.
+ *
+ * Loads configuration from:
+ * 1. Environment variables (CLEO_*)
+ * 2. Config file (.cleo/config.json)
+ * 3. Defaults (fallback values)
+ *
+ * @task T2928
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { CLEO_DIR_NAME, CONFIG_JSON } from '../../cli/paths.js';
+import { CONFIG_SCHEMA, DEFAULT_CONFIG, DEFAULT_LIFECYCLE_ENFORCEMENT, DEFAULT_PROTOCOL_VALIDATION, DEFAULT_RATE_LIMITING, ENV_PREFIX, } from './defaults.js';
+/**
+ * Configuration validation error
+ */
+export class ConfigValidationError extends Error {
+    field;
+    value;
+    constraint;
+    constructor(field, value, constraint) {
+        super(`Invalid config field '${field}': ${constraint} (got ${value})`);
+        this.field = field;
+        this.value = value;
+        this.constraint = constraint;
+        this.name = 'ConfigValidationError';
+    }
+}
+/**
+ * Load configuration value from environment variable
+ */
+function loadFromEnv(key) {
+    const envKey = `${ENV_PREFIX}${key.toUpperCase()}`;
+    return process.env[envKey];
+}
+/**
+ * Parse environment variable to appropriate type
+ */
+function parseEnvValue(key, value) {
+    const schema = CONFIG_SCHEMA[key];
+    if (schema.type === 'boolean') {
+        return value.toLowerCase() === 'true' || value === '1';
+    }
+    if (schema.type === 'number') {
+        const num = parseInt(value, 10);
+        if (Number.isNaN(num)) {
+            throw new ConfigValidationError(key, value, 'must be a number');
+        }
+        return num;
+    }
+    return value;
+}
+/**
+ * Load configuration from .cleo/config.json file
+ */
+function loadFromFile(projectRoot) {
+    const root = projectRoot || process.cwd();
+    const configPath = join(root, CLEO_DIR_NAME, CONFIG_JSON);
+    if (!existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        // Extract config values
+        const result = {};
+        // Extract lifecycle enforcement config (Section 12.2)
+        if (config.lifecycleEnforcement) {
+            result.lifecycleEnforcement = {
+                ...DEFAULT_LIFECYCLE_ENFORCEMENT,
+                ...config.lifecycleEnforcement,
+            };
+        }
+        // Extract protocol validation config (Section 12.3)
+        if (config.protocolValidation) {
+            result.protocolValidation = {
+                ...DEFAULT_PROTOCOL_VALIDATION,
+                ...config.protocolValidation,
+            };
+        }
+        // Extract rate limiting config
+        if (config.rateLimiting) {
+            const rlConfig = config.rateLimiting;
+            result.rateLimiting = {
+                ...DEFAULT_RATE_LIMITING,
+                ...rlConfig,
+                query: { ...DEFAULT_RATE_LIMITING.query, ...rlConfig?.query },
+                mutate: { ...DEFAULT_RATE_LIMITING.mutate, ...rlConfig?.mutate },
+                spawn: { ...DEFAULT_RATE_LIMITING.spawn, ...rlConfig?.spawn },
+            };
+        }
+        return result;
+    }
+    catch (error) {
+        // Log error but don't fail - fall back to defaults
+        console.error(`Warning: Failed to load config file: ${error}`);
+        return {};
+    }
+}
+/**
+ * Validate configuration field
+ */
+function validateField(key, value) {
+    const schema = CONFIG_SCHEMA[key];
+    if (!schema) {
+        return; // Unknown fields are ignored
+    }
+    // Type check
+    const actualType = typeof value;
+    if (actualType !== schema.type) {
+        throw new ConfigValidationError(key, value, `must be of type ${schema.type}`);
+    }
+    // Enum check
+    if ('enum' in schema && schema.enum && !schema.enum.includes(value)) {
+        throw new ConfigValidationError(key, value, `must be one of: ${schema.enum.join(', ')}`);
+    }
+    // Range check for numbers
+    if (schema.type === 'number') {
+        const numValue = value;
+        if ('min' in schema && numValue < schema.min) {
+            throw new ConfigValidationError(key, value, `must be >= ${schema.min}`);
+        }
+        if ('max' in schema && numValue > schema.max) {
+            throw new ConfigValidationError(key, value, `must be <= ${schema.max}`);
+        }
+    }
+}
+/**
+ * Validate complete configuration
+ */
+export function validateConfig(config) {
+    for (const [key, value] of Object.entries(config)) {
+        validateField(key, value);
+    }
+    // Required field check
+    for (const [key, schema] of Object.entries(CONFIG_SCHEMA)) {
+        if ('required' in schema && schema.required) {
+            if (config[key] === undefined) {
+                throw new ConfigValidationError(key, undefined, 'is required');
+            }
+        }
+    }
+}
+/**
+ * Load configuration from all sources
+ *
+ * Priority order:
+ * 1. Environment variables (CLEO_*)
+ * 2. Config file (.cleo/config.json)
+ * 3. Defaults
+ */
+export function loadConfig(projectRoot) {
+    // Start with defaults (deep copy nested objects)
+    const config = {
+        ...DEFAULT_CONFIG,
+        lifecycleEnforcement: { ...DEFAULT_LIFECYCLE_ENFORCEMENT },
+        protocolValidation: { ...DEFAULT_PROTOCOL_VALIDATION },
+        rateLimiting: {
+            ...DEFAULT_RATE_LIMITING,
+            query: { ...DEFAULT_RATE_LIMITING.query },
+            mutate: { ...DEFAULT_RATE_LIMITING.mutate },
+            spawn: { ...DEFAULT_RATE_LIMITING.spawn },
+        },
+    };
+    // Load from file (overrides defaults)
+    const fileConfig = loadFromFile(projectRoot);
+    // Merge nested objects carefully
+    // Destructure nested config fields to merge them deeply, then spread the rest shallowly
+    const { lifecycleEnforcement: fileLc, protocolValidation: filePv, rateLimiting: fileRl, ...restFileConfig } = fileConfig;
+    if (fileLc) {
+        config.lifecycleEnforcement = { ...config.lifecycleEnforcement, ...fileLc };
+    }
+    if (filePv) {
+        config.protocolValidation = { ...config.protocolValidation, ...filePv };
+    }
+    if (fileRl) {
+        config.rateLimiting = {
+            ...config.rateLimiting,
+            ...fileRl,
+            query: { ...config.rateLimiting.query, ...fileRl.query },
+            mutate: { ...config.rateLimiting.mutate, ...fileRl.mutate },
+            spawn: { ...config.rateLimiting.spawn, ...fileRl.spawn },
+        };
+    }
+    Object.assign(config, restFileConfig);
+    // Load from environment (overrides file and defaults)
+    for (const key of Object.keys(DEFAULT_CONFIG)) {
+        const envValue = loadFromEnv(key);
+        if (envValue !== undefined) {
+            config[key] = parseEnvValue(key, envValue);
+        }
+    }
+    // Validate final configuration
+    validateConfig(config);
+    return config;
+}
+/**
+ * Global configuration singleton
+ * Loaded once at module initialization
+ */
+let globalConfig = null;
+/**
+ * Get global configuration (singleton)
+ */
+export function getConfig() {
+    if (globalConfig === null) {
+        globalConfig = loadConfig();
+    }
+    return globalConfig;
+}
+/**
+ * Reset global configuration (for testing)
+ */
+export function resetConfig() {
+    globalConfig = null;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/dispatch/lib/config-loader.js.map

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

package/dist/dispatch/lib/config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Configuration for the dispatch layer.
+ *
+ * Re-exports shared configuration utilities from config-loader.ts
+ * and defaults.ts.
+ *
+ * @task T4830
+ */
+export { ConfigValidationError, getConfig, loadConfig, resetConfig, validateConfig, } from './config-loader.js';
+export type { DispatchConfig } from './defaults.js';
+//# sourceMappingURL=config.d.ts.map

package/dist/dispatch/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/dispatch/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/dispatch/lib/config.js

@@ -0,0 +1,10 @@
+/**
+ * Configuration for the dispatch layer.
+ *
+ * Re-exports shared configuration utilities from config-loader.ts
+ * and defaults.ts.
+ *
+ * @task T4830
+ */
+export { ConfigValidationError, getConfig, loadConfig, resetConfig, validateConfig, } from './config-loader.js';
+//# sourceMappingURL=config.js.map

package/dist/dispatch/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/dispatch/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/dist/dispatch/lib/defaults.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Default configuration values for the CLEO dispatch layer.
+ *
+ * @task T2928
+ * @task T3145
+ * @task T2916 - Rate limiting configuration
+ */
+import type { RateLimitingConfig } from '../middleware/rate-limiter.js';
+export type { RateLimitingConfig } from '../middleware/rate-limiter.js';
+export { DEFAULT_RATE_LIMITING } from '../middleware/rate-limiter.js';
+/**
+ * Lifecycle enforcement configuration (Section 12.2)
+ */
+export interface LifecycleEnforcementConfig {
+    /** Enforcement mode: strict blocks, advisory warns, off skips */
+    mode: 'strict' | 'advisory' | 'off';
+    /** Stages that may be skipped without failing gates */
+    allowSkip: string[];
+    /** Emergency bypass flag - disables all gate checks */
+    emergencyBypass: boolean;
+}
+/**
+ * Protocol validation configuration (Section 12.3)
+ */
+export interface ProtocolValidationConfig {
+    /** Enable strict protocol validation */
+    strictMode: boolean;
+    /** Block operations on protocol violations */
+    blockOnViolation: boolean;
+    /** Log protocol violations to audit trail */
+    logViolations: boolean;
+}
+export interface DispatchConfig {
+    /** Path to CLEO CLI binary (default: 'cleo') */
+    cliPath: string;
+    /** Operation timeout in milliseconds (default: 30000) */
+    timeout: number;
+    /** Logging verbosity level (default: 'info') */
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    /** Enable token tracking metrics (default: false) */
+    enableMetrics: boolean;
+    /** Retry count for failed operations (default: 3) */
+    maxRetries: number;
+    /** Enable query cache (default: true) */
+    queryCache: boolean;
+    /** Query cache TTL in milliseconds (default: 30000) */
+    queryCacheTtl: number;
+    /** Enable audit logging (default: true) */
+    auditLog: boolean;
+    /** Strict validation mode (default: true) */
+    strictValidation: boolean;
+    /** Lifecycle enforcement configuration (Section 12.2) */
+    lifecycleEnforcement: LifecycleEnforcementConfig;
+    /** Protocol validation configuration (Section 12.3) */
+    protocolValidation: ProtocolValidationConfig;
+    /** Rate limiting configuration (Section 13.3) */
+    rateLimiting: RateLimitingConfig;
+}
+/**
+ * Default lifecycle enforcement configuration
+ */
+export declare const DEFAULT_LIFECYCLE_ENFORCEMENT: LifecycleEnforcementConfig;
+/**
+ * Default protocol validation configuration
+ */
+export declare const DEFAULT_PROTOCOL_VALIDATION: ProtocolValidationConfig;
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: DispatchConfig;
+/**
+ * Environment variable prefix for CLEO configuration
+ */
+export declare const ENV_PREFIX = "CLEO_";
+/**
+ * Configuration schema for validation
+ */
+export declare const CONFIG_SCHEMA: {
+    readonly cliPath: {
+        readonly type: "string";
+        readonly required: true;
+    };
+    readonly timeout: {
+        readonly type: "number";
+        readonly min: 1000;
+        readonly max: 300000;
+    };
+    readonly logLevel: {
+        readonly type: "string";
+        readonly enum: readonly ["debug", "info", "warn", "error"];
+    };
+    readonly enableMetrics: {
+        readonly type: "boolean";
+    };
+    readonly maxRetries: {
+        readonly type: "number";
+        readonly min: 0;
+        readonly max: 10;
+    };
+    readonly queryCache: {
+        readonly type: "boolean";
+    };
+    readonly queryCacheTtl: {
+        readonly type: "number";
+        readonly min: 0;
+        readonly max: 600000;
+    };
+    readonly auditLog: {
+        readonly type: "boolean";
+    };
+    readonly strictValidation: {
+        readonly type: "boolean";
+    };
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/dispatch/lib/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/dispatch/lib/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAIxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;IACpC,uDAAuD;IACvD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uDAAuD;IACvD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,6CAA6C;IAC7C,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE9C,qDAAqD;IACrD,aAAa,EAAE,OAAO,CAAC;IAEvB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IAEpB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IAEtB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAElB,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAC;IAE1B,yDAAyD;IACzD,oBAAoB,EAAE,0BAA0B,CAAC;IAEjD,uDAAuD;IACvD,kBAAkB,EAAE,wBAAwB,CAAC;IAE7C,iDAAiD;IACjD,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,0BAI3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,wBAIzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAa5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,UAAU,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUhB,CAAC"}

package/dist/dispatch/lib/defaults.js

@@ -0,0 +1,61 @@
+/**
+ * Default configuration values for the CLEO dispatch layer.
+ *
+ * @task T2928
+ * @task T3145
+ * @task T2916 - Rate limiting configuration
+ */
+import { DEFAULT_RATE_LIMITING } from '../middleware/rate-limiter.js';
+export { DEFAULT_RATE_LIMITING } from '../middleware/rate-limiter.js';
+/**
+ * Default lifecycle enforcement configuration
+ */
+export const DEFAULT_LIFECYCLE_ENFORCEMENT = {
+    mode: 'strict',
+    allowSkip: ['consensus'],
+    emergencyBypass: false,
+};
+/**
+ * Default protocol validation configuration
+ */
+export const DEFAULT_PROTOCOL_VALIDATION = {
+    strictMode: true,
+    blockOnViolation: true,
+    logViolations: true,
+};
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    cliPath: 'cleo',
+    timeout: 30000, // 30 seconds
+    logLevel: 'info',
+    enableMetrics: false,
+    maxRetries: 3,
+    queryCache: true,
+    queryCacheTtl: 30000, // 30 seconds
+    auditLog: true,
+    strictValidation: true,
+    lifecycleEnforcement: { ...DEFAULT_LIFECYCLE_ENFORCEMENT },
+    protocolValidation: { ...DEFAULT_PROTOCOL_VALIDATION },
+    rateLimiting: { ...DEFAULT_RATE_LIMITING },
+};
+/**
+ * Environment variable prefix for CLEO configuration
+ */
+export const ENV_PREFIX = 'CLEO_';
+/**
+ * Configuration schema for validation
+ */
+export const CONFIG_SCHEMA = {
+    cliPath: { type: 'string', required: true },
+    timeout: { type: 'number', min: 1000, max: 300000 },
+    logLevel: { type: 'string', enum: ['debug', 'info', 'warn', 'error'] },
+    enableMetrics: { type: 'boolean' },
+    maxRetries: { type: 'number', min: 0, max: 10 },
+    queryCache: { type: 'boolean' },
+    queryCacheTtl: { type: 'number', min: 0, max: 600000 },
+    auditLog: { type: 'boolean' },
+    strictValidation: { type: 'boolean' },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/dispatch/lib/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/dispatch/lib/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAgEtE;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA+B;IACvE,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA6B;IACnE,UAAU,EAAE,IAAI;IAChB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,KAAK,EAAE,aAAa;IAC7B,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,KAAK,EAAE,aAAa;IACnC,QAAQ,EAAE,IAAI;IACd,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,EAAE,GAAG,6BAA6B,EAAE;IAC1D,kBAAkB,EAAE,EAAE,GAAG,2BAA2B,EAAE;IACtD,YAAY,EAAE,EAAE,GAAG,qBAAqB,EAAE;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC3C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE;IACnD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IACtE,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC/C,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE;IACtD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC7B,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAC7B,CAAC"}

package/dist/dispatch/lib/engine.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Engine Re-exports for Dispatch Domain Handlers
+ *
+ * Centralizes the dispatch layer's engine imports into a single barrel.
+ * All imports use dispatch/engines/ (which delegate to src/core/).
+ *
+ * @epic T4820
+ * @task T4815
+ */
+export type { MinimalTaskRecord, Session as SessionRecord, TaskRecord } from '@cleocode/contracts';
+export type { OrchestratePlanResult } from '@cleocode/contracts/operations/orchestrate';
+export type { ArchiveStatsResult as ArchiveStatsData, AuditResult as AuditData, BackupEntry as BackupEntryData, BackupResult as BackupData, CleanupResult as CleanupData, CompactTask, ComplianceData, ContextData, DashboardData, DiagnosticsResult as DiagnosticsData, FileRestoreResult, HealthResult as HealthData, HelpData, InjectGenerateResult as InjectGenerateData, IvtrHistoryEntry, LabelsResult as LabelsData, LifecycleStageEntry, LogQueryData, MigrateResult as MigrateData, OrchestratePlanInput, PathsData, PlanWarning, PlanWave, PlanWorkerEntry, RestoreResult as RestoreData, RuntimeDiagnostics as RuntimeData, SafestopResult as SafestopData, ScaffoldHubData, StatsData, SyncData, SystemMetricsResult as MetricsData, UncancelResult as UncancelData, } from '@cleocode/core/internal';
+export { addTaskWithSessionScope, completeTaskStrict, configGet, configListPresets, configSet, configSetPreset, type DecisionRecord, ensureInitialized, filterEntries as filterManifestEntries, getVersion, type HookMatrixResult, initProject, isAutoInitEnabled, lifecycleCheck, lifecycleGateFail, lifecycleGatePass, lifecycleGates, lifecycleHistory, lifecyclePrerequisites, lifecycleProgress, lifecycleReset, lifecycleSkip, lifecycleStatus, type ManifestEntry as ResearchManifestEntry, mapCodebase, orchestrateAnalyze, orchestrateBootstrap, orchestrateCheck, orchestrateContext, orchestrateCriticalPath, orchestrateHandoff, orchestrateNext, orchestrateParallelEnd, orchestrateParallelStart, orchestratePlan, orchestrateReady, orchestrateSkillInject, orchestrateSpawn, orchestrateSpawnExecute, orchestrateStartup, orchestrateStatus, orchestrateUnblockOpportunities, orchestrateValidate, orchestrateWaves, type ProviderMatrixEntry, phaseAdvance, phaseComplete, phaseDelete, phaseList, phaseRename, phaseSet, phaseShow, phaseStart, pipelineManifestAppend, pipelineManifestArchive, pipelineManifestFind, pipelineManifestList, pipelineManifestPending, pipelineManifestShow, pipelineManifestStats, queryCommonHooks, queryHookProviders, readManifestEntries, releaseCancel, releaseChangelog, releaseChangelogSince, releaseCommit, releaseGateCheck, releaseGatesRun, releaseIvtrAutoSuggest, releaseList, releasePrepare, releasePush, releaseRollback, releaseRollbackFull, releaseShip, releaseShow, releaseTag, sessionArchive, sessionBriefing, sessionChainShow, sessionCleanup, sessionComputeDebrief, sessionComputeHandoff, sessionContextDrift, sessionContextInject, sessionDebriefShow, sessionDecisionLog, sessionEnd, sessionFind, sessionGc, sessionHandoff, sessionHistory, sessionList, sessionRecordAssumption, sessionRecordDecision, sessionResume, sessionShow, sessionStart, sessionStats, sessionStatus, sessionSuspend, sessionSwitch, systemHooksMatrix, taskAnalyze, taskArchive, taskBatchValidate, taskBlockers, taskCancel, taskClaim, taskComplete, taskComplexityEstimate, taskCurrentGet, taskDelete, taskDepends, taskDeps, taskDepsCycles, taskDepsOverview, taskExists, taskExport, taskFind, taskHistory, taskImpact, taskImport, taskLabelList, taskLabelShow, taskLint, taskList, taskNext, taskPlan, taskPromote, taskRelates, taskRelatesAdd, taskRelatesFind, taskReopen, taskReorder, taskReparent, taskRestore, taskShow, taskShowIvtrHistory, taskShowWithHistory, taskStart, taskStats, taskStop, taskSyncLinks, taskSyncLinksRemove, taskSyncReconcile, taskTree, taskUnarchive, taskUnclaim, taskUpdate, taskWorkHistory, } from '@cleocode/core/internal';
+export { memoryBrainStats, memoryContradictions, memoryDecisionFind, memoryDecisionStore, memoryFetch, memoryFind, memoryGraphAdd, memoryGraphContext, memoryGraphNeighbors, memoryGraphRelated, memoryGraphRemove, memoryGraphShow, memoryGraphStatsFull, memoryGraphTrace, memoryLearningFind, memoryLearningStats, memoryLearningStore, memoryLink, memoryObserve, memoryPatternFind, memoryPatternStats, memoryPatternStore, memoryQualityReport, memoryReasonSimilar, memoryReasonWhy, memorySearchHybrid, memoryShow, memorySuperseded, memoryTimeline, memoryUnlink, } from '../engines/memory-engine.js';
+export { generateTemplateConfig, getTemplateForSubcommand, type IssueTemplate, parseIssueTemplates, type TemplateConfig, type TemplateSection, validateLabels, } from '../engines/template-parser.js';
+export { validateBatchValidate, validateCoherenceCheck, validateComplianceRecord, validateComplianceSummary, validateComplianceViolations, validateGateVerify, validateManifest as validateManifestOp, validateOutput, validateProtocol, validateProtocolArchitectureDecision, validateProtocolArtifactPublish, validateProtocolConsensus, validateProtocolContribution, validateProtocolDecomposition, validateProtocolImplementation, validateProtocolProvenance, validateProtocolRelease, validateProtocolResearch, validateProtocolSpecification, validateProtocolTesting, validateProtocolValidation, validateSchemaOp, validateTask as validateTaskOp, validateTestCoverage, validateTestRun, validateTestStatus, } from '../engines/validate-engine.js';
+//# sourceMappingURL=engine.d.ts.map

package/dist/dispatch/lib/engine.d.ts.map

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

package/dist/dispatch/lib/engine.js

@@ -0,0 +1,36 @@
+/**
+ * Engine Re-exports for Dispatch Domain Handlers
+ *
+ * Centralizes the dispatch layer's engine imports into a single barrel.
+ * All imports use dispatch/engines/ (which delegate to src/core/).
+ *
+ * @epic T4820
+ * @task T4815
+ */
+// Pipeline manifest functions (moved from memory domain in T5241)
+// Release engine (T1572 — ENG-MIG-5: migrated to @cleocode/core/internal)
+// Session engine (T1573 — ENG-MIG-6: migrated to @cleocode/core/internal)
+// Lifecycle engine ops — re-exported from @cleocode/core/internal (T1576 / ENG-MIG-9 / ADR-057)
+// lifecycle-engine.ts shrunk to a shim; all symbols now live in core/lifecycle/engine-ops.ts.
+// Hooks engine (ENG-MIG-12 / T1579 — logic in @cleocode/core/internal)
+// Init engine-ops — migrated to @cleocode/core/internal (ENG-MIG-14 / T1581 / ADR-057)
+// Config engine-ops — migrated to @cleocode/core/internal (ENG-MIG-15 / T1582 / ADR-057)
+// config-engine.ts shrunk to a shim; all symbols now live in core/config/engine-ops.ts.
+// Codebase map — re-exported from core (engine shim deleted, T1584)
+export { addTaskWithSessionScope, completeTaskStrict, configGet, configListPresets, configSet, configSetPreset, ensureInitialized, filterEntries as filterManifestEntries, getVersion, initProject, isAutoInitEnabled, lifecycleCheck, lifecycleGateFail, lifecycleGatePass, lifecycleGates, lifecycleHistory, lifecyclePrerequisites, lifecycleProgress, lifecycleReset, lifecycleSkip, lifecycleStatus, mapCodebase, orchestrateAnalyze, orchestrateBootstrap, orchestrateCheck, orchestrateContext, orchestrateCriticalPath, orchestrateHandoff, orchestrateNext, orchestrateParallelEnd, orchestrateParallelStart, orchestratePlan, orchestrateReady, orchestrateSkillInject, orchestrateSpawn, orchestrateSpawnExecute, orchestrateStartup, orchestrateStatus, orchestrateUnblockOpportunities, orchestrateValidate, orchestrateWaves, 
+// Pipeline engine-ops (ENG-MIG-11 / T1578 — migrated to @cleocode/core/internal)
+// pipeline-engine.ts shrunk to a shim; all symbols now live in core/pipeline/engine-ops.ts.
+phaseAdvance, phaseComplete, phaseDelete, phaseList, phaseRename, phaseSet, phaseShow, phaseStart, pipelineManifestAppend, pipelineManifestArchive, pipelineManifestFind, pipelineManifestList, pipelineManifestPending, pipelineManifestShow, pipelineManifestStats, queryCommonHooks, queryHookProviders, readManifestEntries, releaseCancel, releaseChangelog, releaseChangelogSince, releaseCommit, releaseGateCheck, releaseGatesRun, releaseIvtrAutoSuggest, releaseList, releasePrepare, releasePush, releaseRollback, releaseRollbackFull, releaseShip, releaseShow, releaseTag, sessionArchive, sessionBriefing, sessionChainShow, sessionCleanup, 
+// T4959: Rich debrief + chain
+sessionComputeDebrief, sessionComputeHandoff, sessionContextDrift, sessionContextInject, sessionDebriefShow, sessionDecisionLog, sessionEnd, 
+// T5119: Lightweight session discovery
+sessionFind, sessionGc, sessionHandoff, sessionHistory, sessionList, sessionRecordAssumption, sessionRecordDecision, sessionResume, sessionShow, sessionStart, sessionStats, sessionStatus, sessionSuspend, sessionSwitch, systemHooksMatrix, taskAnalyze, taskArchive, taskBatchValidate, taskBlockers, taskCancel, taskClaim, taskComplete, taskComplexityEstimate, taskCurrentGet, taskDelete, taskDepends, taskDeps, taskDepsCycles, taskDepsOverview, taskExists, taskExport, taskFind, taskHistory, taskImpact, taskImport, taskLabelList, taskLabelShow, taskLint, taskList, taskNext, taskPlan, taskPromote, taskRelates, taskRelatesAdd, taskRelatesFind, taskReopen, taskReorder, taskReparent, taskRestore, taskShow, taskShowIvtrHistory, taskShowWithHistory, taskStart, taskStats, taskStop, taskSyncLinks, taskSyncLinksRemove, taskSyncReconcile, taskTree, taskUnarchive, taskUnclaim, taskUpdate, taskWorkHistory, } from '@cleocode/core/internal';
+// Memory engine — brain.db cognitive memory (T5241 cutover)
+export { memoryBrainStats, memoryContradictions, memoryDecisionFind, memoryDecisionStore, memoryFetch, memoryFind, memoryGraphAdd, memoryGraphContext, memoryGraphNeighbors, memoryGraphRelated, memoryGraphRemove, memoryGraphShow, memoryGraphStatsFull, memoryGraphTrace, memoryLearningFind, memoryLearningStats, memoryLearningStore, memoryLink, memoryObserve, memoryPatternFind, memoryPatternStats, memoryPatternStore, memoryQualityReport, memoryReasonSimilar, memoryReasonWhy, memorySearchHybrid, memoryShow, memorySuperseded, memoryTimeline, memoryUnlink, } from '../engines/memory-engine.js';
+// Template parser engine
+export { generateTemplateConfig, getTemplateForSubcommand, parseIssueTemplates, validateLabels, } from '../engines/template-parser.js';
+// Validate engine
+export { validateBatchValidate, validateCoherenceCheck, validateComplianceRecord, validateComplianceSummary, validateComplianceViolations, validateGateVerify, validateManifest as validateManifestOp, validateOutput, validateProtocol, 
+// T5327 + T260: Protocol validation operations (12 protocols)
+validateProtocolArchitectureDecision, validateProtocolArtifactPublish, validateProtocolConsensus, validateProtocolContribution, validateProtocolDecomposition, validateProtocolImplementation, validateProtocolProvenance, validateProtocolRelease, validateProtocolResearch, validateProtocolSpecification, validateProtocolTesting, validateProtocolValidation, validateSchemaOp, validateTask as validateTaskOp, validateTestCoverage, validateTestRun, validateTestStatus, } from '../engines/validate-engine.js';
+//# sourceMappingURL=engine.js.map

package/dist/dispatch/lib/engine.js.map

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

package/dist/dispatch/lib/exit-codes.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared exit-code mapping utilities for the dispatch layer.
+ *
+ * Provides a canonical reverse lookup from numeric exit code to string error code,
+ * shared between dispatch engines and the CLI adapter.
+ *
+ * @remarks
+ * The forward mapping (string → number) lives in `engines/_error.ts` as
+ * `STRING_TO_EXIT`. This module derives the inverse on first call and memoises
+ * it so engines can resolve a caught `CleoError.code` (numeric) to the
+ * string code expected by `engineError()`.
+ *
+ * @task T374
+ * @epic T335
+ */
+/**
+ * Map a numeric CleoError exit code to the canonical string engine error code.
+ *
+ * @remarks
+ * Returns `undefined` when the numeric code is not present in the
+ * `STRING_TO_EXIT` map, allowing callers to fall back to their own default.
+ *
+ * @param numericCode - Numeric exit code from a caught `CleoError.code`
+ * @returns Canonical string error code (e.g. `'E_NOT_FOUND'`), or `undefined`
+ *
+ * @example
+ * ```typescript
+ * import { mapNumericExitCodeToString } from '../lib/exit-codes.js';
+ *
+ * const code = mapNumericExitCodeToString(4) ?? 'E_NOT_INITIALIZED';
+ * // → 'E_NOT_FOUND'
+ * ```
+ */
+export declare function mapNumericExitCodeToString(numericCode: number | undefined): string | undefined;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/dispatch/lib/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../../src/dispatch/lib/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0BH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG9F"}

package/dist/dispatch/lib/exit-codes.js

@@ -0,0 +1,60 @@
+/**
+ * Shared exit-code mapping utilities for the dispatch layer.
+ *
+ * Provides a canonical reverse lookup from numeric exit code to string error code,
+ * shared between dispatch engines and the CLI adapter.
+ *
+ * @remarks
+ * The forward mapping (string → number) lives in `engines/_error.ts` as
+ * `STRING_TO_EXIT`. This module derives the inverse on first call and memoises
+ * it so engines can resolve a caught `CleoError.code` (numeric) to the
+ * string code expected by `engineError()`.
+ *
+ * @task T374
+ * @epic T335
+ */
+import { STRING_TO_EXIT } from '../engines/_error.js';
+/** Lazily built inverse of STRING_TO_EXIT (number → string). */
+let _inverseCache = null;
+/**
+ * Build and memoize the inverse of STRING_TO_EXIT.
+ *
+ * When multiple string codes map to the same exit number (e.g. E_GENERAL
+ * and E_GENERAL_ERROR both map to 1), the first occurrence wins.
+ */
+function getInverseMap() {
+    if (_inverseCache)
+        return _inverseCache;
+    const map = new Map();
+    for (const [key, value] of Object.entries(STRING_TO_EXIT)) {
+        if (!map.has(value)) {
+            map.set(value, key);
+        }
+    }
+    _inverseCache = map;
+    return map;
+}
+/**
+ * Map a numeric CleoError exit code to the canonical string engine error code.
+ *
+ * @remarks
+ * Returns `undefined` when the numeric code is not present in the
+ * `STRING_TO_EXIT` map, allowing callers to fall back to their own default.
+ *
+ * @param numericCode - Numeric exit code from a caught `CleoError.code`
+ * @returns Canonical string error code (e.g. `'E_NOT_FOUND'`), or `undefined`
+ *
+ * @example
+ * ```typescript
+ * import { mapNumericExitCodeToString } from '../lib/exit-codes.js';
+ *
+ * const code = mapNumericExitCodeToString(4) ?? 'E_NOT_INITIALIZED';
+ * // → 'E_NOT_FOUND'
+ * ```
+ */
+export function mapNumericExitCodeToString(numericCode) {
+    if (numericCode === undefined)
+        return undefined;
+    return getInverseMap().get(numericCode);
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/dispatch/lib/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../../src/dispatch/lib/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,gEAAgE;AAChE,IAAI,aAAa,GAA+B,IAAI,CAAC;AAErD;;;;;GAKG;AACH,SAAS,aAAa;IACpB,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,aAAa,GAAG,GAAG,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAA+B;IACxE,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,aAAa,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC"}