@cleocode/cleo 2026.4.10 → 2026.4.11

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

@@ -0,0 +1,217 @@
+/**
+ * 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 { 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', '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, MCPConfig } 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,SAAS,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,117 @@
+/**
+ * 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
+ */
+/** Alias for DispatchConfig. */
+export type MCPConfig = DispatchConfig;
+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,gCAAgC;AAChC,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC;AAEvC,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,58 @@
+/**
+ * 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,
+};
+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;AAQF,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,26 @@
+/**
+ * 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 { Session as SessionRecord } from '@cleocode/contracts';
+export { filterEntries as filterManifestEntries, type ManifestEntry as ResearchManifestEntry, pipelineManifestAppend, pipelineManifestArchive, pipelineManifestFind, pipelineManifestList, pipelineManifestPending, pipelineManifestShow, pipelineManifestStats, readManifestEntries, } from '@cleocode/core/internal';
+export { mapCodebase } from '../engines/codebase-map-engine.js';
+export { configGet, configListPresets, configSet, configSetPreset, } from '../engines/config-engine.js';
+export { type HookMatrixResult, type ProviderMatrixEntry, queryCommonHooks, queryHookProviders, systemHooksMatrix, } from '../engines/hooks-engine.js';
+export { ensureInitialized, getVersion, initProject, isAutoInitEnabled, } from '../engines/init-engine.js';
+export { lifecycleCheck, lifecycleGateFail, lifecycleGatePass, lifecycleGates, lifecycleHistory, lifecyclePrerequisites, lifecycleProgress, lifecycleReset, lifecycleSkip, lifecycleStatus, } from '../engines/lifecycle-engine.js';
+export { memoryBrainStats, memoryContradictions, memoryDecisionFind, memoryDecisionStore, memoryFetch, memoryFind, memoryGraphAdd, memoryGraphNeighbors, memoryGraphRemove, memoryGraphShow, memoryLearningFind, memoryLearningStats, memoryLearningStore, memoryLink, memoryObserve, memoryPatternFind, memoryPatternStats, memoryPatternStore, memoryReasonSimilar, memoryReasonWhy, memorySearchHybrid, memoryShow, memorySuperseded, memoryTimeline, memoryUnlink, } from '../engines/memory-engine.js';
+export { orchestrateAnalyze, orchestrateBootstrap, orchestrateCheck, orchestrateContext, orchestrateCriticalPath, orchestrateHandoff, orchestrateNext, orchestrateParallelEnd, orchestrateParallelStart, orchestrateReady, orchestrateSkillInject, orchestrateSpawn, orchestrateSpawnExecute, orchestrateStartup, orchestrateStatus, orchestrateUnblockOpportunities, orchestrateValidate, orchestrateWaves, } from '../engines/orchestrate-engine.js';
+export { phaseAdvance, phaseComplete, phaseDelete, phaseList, phaseRename, phaseSet, phaseShow, phaseStart, } from '../engines/pipeline-engine.js';
+export { releaseCancel, releaseChangelog, releaseCommit, releaseGatesRun, releaseList, releasePrepare, releasePush, releaseRollback, releaseShip, releaseShow, releaseTag, } from '../engines/release-engine.js';
+export { type DecisionRecord, 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, taskCurrentGet, taskStart, taskStop, taskWorkHistory, } from '../engines/session-engine.js';
+export { type ArchiveStatsData, type AuditData, type BackupData, backupRestore, type CleanupData, type ComplianceData, type ContextData, type DashboardData, type DiagnosticsData, type HealthData, type HelpData, type InjectGenerateData, type LabelsData, type LogQueryData, type MetricsData, type MigrateData, type PathsData, type RestoreData, type RoadmapData, type RuntimeData, type SafestopData, type ScaffoldHubData, type SequenceData, type SmokeProbe, type SmokeResult, type StatsData, type SyncData, systemArchiveStats, systemAudit, systemBackup, systemCleanup, systemCompliance, systemContext, systemDash, systemDiagnostics, systemDoctor, systemFix, systemHealth, systemHelp, systemInjectGenerate, systemLabels, systemListBackups, systemLog, systemMetrics, systemMigrate, systemPaths, systemRestore, systemRoadmap, systemRuntime, systemSafestop, systemScaffoldHub, systemSequence, systemSequenceRepair, systemSmoke, systemStats, systemSync, systemUncancel, type UncancelData, } from '../engines/system-engine.js';
+export { type CompactTask, type MinimalTaskRecord, type TaskRecord, taskAnalyze, taskArchive, taskBatchValidate, taskBlockers, taskCancel, taskClaim, taskComplete, taskComplexityEstimate, taskCreate, 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, taskStats, taskSyncLinks, taskSyncLinksRemove, taskSyncReconcile, taskTree, taskUnarchive, taskUnclaim, taskUpdate, } from '../engines/task-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,46 @@
+/**
+ * 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)
+export { filterEntries as filterManifestEntries, pipelineManifestAppend, pipelineManifestArchive, pipelineManifestFind, pipelineManifestList, pipelineManifestPending, pipelineManifestShow, pipelineManifestStats, readManifestEntries, } from '@cleocode/core/internal';
+// Codebase map engine
+export { mapCodebase } from '../engines/codebase-map-engine.js';
+// Config engine
+export { configGet, configListPresets, configSet, configSetPreset, } from '../engines/config-engine.js';
+// Hooks engine (T167)
+export { queryCommonHooks, queryHookProviders, systemHooksMatrix, } from '../engines/hooks-engine.js';
+// Init engine
+export { ensureInitialized, getVersion, initProject, isAutoInitEnabled, } from '../engines/init-engine.js';
+// Lifecycle engine
+export { lifecycleCheck, lifecycleGateFail, lifecycleGatePass, lifecycleGates, lifecycleHistory, lifecyclePrerequisites, lifecycleProgress, lifecycleReset, lifecycleSkip, lifecycleStatus, } from '../engines/lifecycle-engine.js';
+// Memory engine — brain.db cognitive memory (T5241 cutover)
+export { memoryBrainStats, memoryContradictions, memoryDecisionFind, memoryDecisionStore, memoryFetch, memoryFind, memoryGraphAdd, memoryGraphNeighbors, memoryGraphRemove, memoryGraphShow, memoryLearningFind, memoryLearningStats, memoryLearningStore, memoryLink, memoryObserve, memoryPatternFind, memoryPatternStats, memoryPatternStore, memoryReasonSimilar, memoryReasonWhy, memorySearchHybrid, memoryShow, memorySuperseded, memoryTimeline, memoryUnlink, } from '../engines/memory-engine.js';
+// Orchestrate engine
+export { orchestrateAnalyze, orchestrateBootstrap, orchestrateCheck, orchestrateContext, orchestrateCriticalPath, orchestrateHandoff, orchestrateNext, orchestrateParallelEnd, orchestrateParallelStart, orchestrateReady, orchestrateSkillInject, orchestrateSpawn, orchestrateSpawnExecute, orchestrateStartup, orchestrateStatus, orchestrateUnblockOpportunities, orchestrateValidate, orchestrateWaves, } from '../engines/orchestrate-engine.js';
+// Pipeline engine (Phase operations)
+export { phaseAdvance, phaseComplete, phaseDelete, phaseList, phaseRename, phaseSet, phaseShow, phaseStart, } from '../engines/pipeline-engine.js';
+// Release engine
+export { releaseCancel, releaseChangelog, releaseCommit, releaseGatesRun, releaseList, releasePrepare, releasePush, releaseRollback, releaseShip, releaseShow, releaseTag, } from '../engines/release-engine.js';
+// Session engine
+export { 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, taskCurrentGet, taskStart, taskStop, taskWorkHistory, } from '../engines/session-engine.js';
+// System engine
+export { backupRestore, systemArchiveStats, systemAudit, systemBackup, systemCleanup, systemCompliance, systemContext, systemDash, systemDiagnostics, systemDoctor, systemFix, systemHealth, systemHelp, systemInjectGenerate, systemLabels, systemListBackups, systemLog, systemMetrics, systemMigrate, systemPaths, systemRestore, systemRoadmap, systemRuntime, systemSafestop, systemScaffoldHub, systemSequence, systemSequenceRepair, systemSmoke, systemStats, systemSync, systemUncancel, } from '../engines/system-engine.js';
+// Task engine (CRUD + non-CRUD operations)
+export { taskAnalyze, taskArchive, taskBatchValidate, taskBlockers, taskCancel, taskClaim, taskComplete, taskComplexityEstimate, taskCreate, 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, taskStats, taskSyncLinks, taskSyncLinksRemove, taskSyncReconcile, taskTree, taskUnarchive, taskUnclaim, taskUpdate, } from '../engines/task-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/gateway-meta.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Gateway metadata factory for domain handlers.
+ *
+ * Creates LAFS-conformant GatewayMeta objects with all required fields,
+ * replacing the inline _meta construction previously duplicated across
+ * every domain handler.
+ *
+ * Uses the canonical GatewayMeta type from src/types/lafs.ts (which
+ * extends LAFSMeta from @cleocode/lafs) to ensure LAFS v1.2.3
+ * conformance.
+ *
+ * @epic T4663
+ * @task T4700
+ */
+import type { GatewayMeta } from '@cleocode/contracts';
+/**
+ * GatewayMeta with an index signature for DomainResponse._meta
+ * compatibility.  All domain handlers receive this from
+ * createGatewayMeta().
+ *
+ * @task T4655
+ */
+export type GatewayMetaRecord = GatewayMeta & Record<string, unknown>;
+/**
+ * Create a fully typed GatewayMeta for domain responses.
+ *
+ * @param gateway - Gateway name (e.g., 'query', 'mutate')
+ * @param domain - Domain name (e.g., 'tasks', 'session')
+ * @param operation - Operation name (e.g., 'show', 'list')
+ * @param startTime - Timestamp from Date.now() at start of request
+ * @returns GatewayMeta with all LAFS and CLEO-specific fields
+ *
+ * @task T4700
+ * @epic T4663
+ */
+export declare function createGatewayMeta(gateway: string, domain: string, operation: string, startTime: number): GatewayMetaRecord;
+//# sourceMappingURL=gateway-meta.d.ts.map

package/dist/dispatch/lib/gateway-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-meta.d.ts","sourceRoot":"","sources":["../../../src/dispatch/lib/gateway-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAoBnB"}

package/dist/dispatch/lib/gateway-meta.js

@@ -0,0 +1,50 @@
+/**
+ * Gateway metadata factory for domain handlers.
+ *
+ * Creates LAFS-conformant GatewayMeta objects with all required fields,
+ * replacing the inline _meta construction previously duplicated across
+ * every domain handler.
+ *
+ * Uses the canonical GatewayMeta type from src/types/lafs.ts (which
+ * extends LAFSMeta from @cleocode/lafs) to ensure LAFS v1.2.3
+ * conformance.
+ *
+ * @epic T4663
+ * @task T4700
+ */
+import { randomUUID } from 'node:crypto';
+import { getCurrentSessionId } from '@cleocode/core/internal';
+/**
+ * Create a fully typed GatewayMeta for domain responses.
+ *
+ * @param gateway - Gateway name (e.g., 'query', 'mutate')
+ * @param domain - Domain name (e.g., 'tasks', 'session')
+ * @param operation - Operation name (e.g., 'show', 'list')
+ * @param startTime - Timestamp from Date.now() at start of request
+ * @returns GatewayMeta with all LAFS and CLEO-specific fields
+ *
+ * @task T4700
+ * @epic T4663
+ */
+export function createGatewayMeta(gateway, domain, operation, startTime) {
+    const sessionId = getCurrentSessionId();
+    return {
+        // LAFS canonical fields
+        specVersion: '1.2.3',
+        schemaVersion: '2026.2.1',
+        timestamp: new Date().toISOString(),
+        operation,
+        requestId: randomUUID(),
+        transport: 'sdk',
+        strict: true,
+        mvi: 'minimal',
+        contextVersion: 1,
+        ...(sessionId && { sessionId }),
+        // CLEO gateway extensions
+        gateway,
+        domain,
+        duration_ms: Date.now() - startTime,
+        'x-cleo-transport': 'stdio',
+    };
+}
+//# sourceMappingURL=gateway-meta.js.map

package/dist/dispatch/lib/gateway-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-meta.js","sourceRoot":"","sources":["../../../src/dispatch/lib/gateway-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAW9D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,MAAc,EACd,SAAiB,EACjB,SAAiB;IAEjB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,OAAO;QACL,wBAAwB;QACxB,WAAW,EAAE,OAAO;QACpB,aAAa,EAAE,UAAU;QACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS;QACT,SAAS,EAAE,UAAU,EAAE;QACvB,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,SAAS;QACd,cAAc,EAAE,CAAC;QACjB,GAAG,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC/B,0BAA0B;QAC1B,OAAO;QACP,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QACnC,kBAAkB,EAAE,OAAO;KAC5B,CAAC;AACJ,CAAC"}