@cleocode/cleo 2026.4.57 → 2026.4.59

package/dist/dispatch/engines/_error.js

@@ -0,0 +1,298 @@
+/**
+ * Centralized engine error helper.
+ *
+ * All dispatch engines import `engineError()` from this module to produce
+ * consistently typed error results with correct exit codes and pino logging.
+ *
+ * The STRING_TO_EXIT map is the canonical mapping from string error codes
+ * to numeric exit codes. It mirrors ERROR_CODE_TO_EXIT in cli.ts.
+ *
+ * @remarks
+ * Error codes are organized into numeric ranges:
+ * - 1-9: General errors (invalid input, file, dependency, validation)
+ * - 10-19: Hierarchy errors (parent, depth, siblings, circular deps)
+ * - 20-29: Concurrency errors (checksum, modification, collision)
+ * - 30-39: Session errors (scope, claims, active task)
+ * - 40-47: Verification errors (gates, agents, rounds)
+ * - 50-54: Context safeguard (warning through emergency)
+ * - 60-67: Orchestrator / protocol errors
+ * - 70-79: Nexus errors
+ * - 80-94: Lifecycle, artifact, provenance errors
+ * - 95-99: Adapter errors
+ * - 100+: Special informational codes (not errors)
+ */
+import { getLogger } from '@cleocode/core';
+import { mapNumericExitCodeToString } from '../lib/exit-codes.js';
+/**
+ * Canonical mapping from string error codes to numeric exit codes.
+ *
+ * Source of truth: src/types/exit-codes.ts (ExitCode enum).
+ * Must stay in sync with ERROR_CODE_TO_EXIT in src/dispatch/adapters/cli.ts.
+ */
+export const STRING_TO_EXIT = {
+    // General Errors (1-9)
+    E_GENERAL: 1,
+    E_GENERAL_ERROR: 1,
+    E_INVALID_INPUT: 2,
+    E_MISSING_PARAMS: 2,
+    E_INVALID_OPERATION: 2,
+    E_FILE_ERROR: 3,
+    E_NOT_FOUND: 4,
+    E_DEPENDENCY: 5,
+    E_DEPENDENCY_ERROR: 5,
+    E_VALIDATION: 6,
+    E_VALIDATION_FAILED: 6,
+    E_VALIDATION_ERROR: 6,
+    E_RETRYABLE: 7,
+    E_LOCK_TIMEOUT: 7,
+    E_CONFIG_ERROR: 8,
+    // Hierarchy Errors (10-19)
+    E_PARENT_NOT_FOUND: 10,
+    E_DEPTH_EXCEEDED: 11,
+    E_SIBLING_LIMIT: 12,
+    E_INVALID_PARENT_TYPE: 13,
+    E_INVALID_PARENT: 13,
+    E_CIRCULAR_DEP: 14,
+    E_CIRCULAR_REFERENCE: 14,
+    E_ORPHAN_DETECTED: 15,
+    E_HAS_CHILDREN: 16,
+    E_TASK_COMPLETED: 17, // ExitCode.TASK_COMPLETED — canonical value from @cleocode/contracts
+    E_CASCADE_FAILED: 18,
+    E_HAS_DEPENDENTS: 19,
+    // Concurrency Errors (20-29)
+    E_CHECKSUM_MISMATCH: 20,
+    E_CONCURRENT_MODIFICATION: 21,
+    E_ID_COLLISION: 22,
+    // Session Errors (30-39)
+    E_SESSION_EXISTS: 30,
+    E_SESSION_CONFLICT: 30,
+    E_SESSION_NOT_FOUND: 31,
+    E_SCOPE_CONFLICT: 32,
+    E_SCOPE_INVALID: 33,
+    E_TASK_NOT_IN_SCOPE: 34,
+    E_TASK_CLAIMED: 35,
+    E_SESSION_REQUIRED: 36,
+    E_SESSION_CLOSE_BLOCKED: 37,
+    E_ACTIVE_TASK_REQUIRED: 38,
+    E_NOTES_REQUIRED: 39,
+    // Verification Errors (40-47)
+    E_VERIFICATION_INIT_FAILED: 40,
+    E_GATE_UPDATE_FAILED: 41,
+    E_INVALID_GATE: 42,
+    E_INVALID_AGENT: 43,
+    E_MAX_ROUNDS_EXCEEDED: 44,
+    E_GATE_DEPENDENCY: 45,
+    E_VERIFICATION_LOCKED: 46,
+    E_ROUND_MISMATCH: 47,
+    // Context Safeguard (50-54)
+    E_CONTEXT_WARNING: 50,
+    E_CONTEXT_CAUTION: 51,
+    E_CONTEXT_CRITICAL: 52,
+    E_CONTEXT_EMERGENCY: 53,
+    E_CONTEXT_STALE: 54,
+    // Orchestrator / Protocol Errors (60-67)
+    E_PROTOCOL_MISSING: 60,
+    E_PROTOCOL_RESEARCH: 60,
+    E_INVALID_RETURN_MESSAGE: 61,
+    E_PROTOCOL_CONSENSUS: 61,
+    E_MANIFEST_ENTRY_MISSING: 62,
+    E_PROTOCOL_SPECIFICATION: 62,
+    E_SPAWN_VALIDATION_FAILED: 63,
+    E_PROTOCOL_DECOMPOSITION: 63,
+    E_AUTONOMOUS_BOUNDARY: 64,
+    E_PROTOCOL_IMPLEMENTATION: 64,
+    E_HANDOFF_REQUIRED: 65,
+    E_PROTOCOL_CONTRIBUTION: 65,
+    E_RESUME_FAILED: 66,
+    E_PROTOCOL_RELEASE: 66,
+    E_CONCURRENT_SESSION: 67,
+    E_PROTOCOL_GENERIC: 67,
+    // Nexus Errors (70-79)
+    E_NEXUS_NOT_INITIALIZED: 70,
+    E_NEXUS_PROJECT_NOT_FOUND: 71,
+    E_NEXUS_PERMISSION_DENIED: 72,
+    E_NEXUS_INVALID_SYNTAX: 73,
+    E_NEXUS_SYNC_FAILED: 74,
+    E_NEXUS_REGISTRY_CORRUPT: 75,
+    E_NEXUS_PROJECT_EXISTS: 76,
+    E_NEXUS_QUERY_FAILED: 77,
+    E_NEXUS_GRAPH_ERROR: 78,
+    // Lifecycle Enforcement (80-84)
+    E_LIFECYCLE_GATE_FAILED: 80,
+    E_AUDIT_MISSING: 81,
+    E_CIRCULAR_VALIDATION: 82,
+    E_LIFECYCLE_TRANSITION_INVALID: 83,
+    E_PROVENANCE_REQUIRED: 84,
+    // Artifact Publish (85-89)
+    E_ARTIFACT_TYPE_UNKNOWN: 85,
+    E_ARTIFACT_VALIDATION_FAILED: 86,
+    E_ARTIFACT_BUILD_FAILED: 87,
+    E_ARTIFACT_PUBLISH_FAILED: 88,
+    E_ARTIFACT_ROLLBACK_FAILED: 89,
+    // Provenance (90-94)
+    E_PROVENANCE_CONFIG_INVALID: 90,
+    E_SIGNING_KEY_MISSING: 91,
+    E_SIGNATURE_INVALID: 92,
+    E_DIGEST_MISMATCH: 93,
+    E_ATTESTATION_INVALID: 94,
+    // Special Codes (100+) - NOT errors
+    E_NO_DATA: 100,
+    E_ALREADY_EXISTS: 101,
+    E_NO_CHANGE: 102,
+    E_TESTS_SKIPPED: 103,
+    // Adapter Errors (95-99)
+    E_ADAPTER_NOT_FOUND: 95,
+    E_ADAPTER_INIT_FAILED: 96,
+    E_ADAPTER_HOOK_FAILED: 97,
+    E_ADAPTER_SPAWN_FAILED: 98,
+    E_ADAPTER_INSTALL_FAILED: 99,
+    // Common engine-specific aliases
+    E_NOT_INITIALIZED: 3,
+    E_NO_HANDLER: 1,
+    E_INTERNAL: 1,
+    E_LIST_FAILED: 3,
+    E_READ_FAILED: 3,
+    E_WRITE_FAILED: 3,
+    E_PARSE_ERROR: 2,
+    E_TEMPLATE_ERROR: 2,
+};
+/**
+ * Derive pino log level from exit code.
+ *
+ * - 100+: special/informational -> 'debug'
+ * - 1-9 internal errors (1, 3): -> 'error'
+ * - 10-99 user/domain errors: -> 'warn'
+ * - 0: success (should not be called for errors) -> 'debug'
+ */
+function logLevel(exitCode) {
+    if (exitCode === 0 || exitCode >= 100)
+        return 'debug';
+    // Internal errors: general (1), file (3) — these indicate bugs or system issues
+    if (exitCode === 1 || exitCode === 3)
+        return 'error';
+    // Everything else is a user/domain error
+    return 'warn';
+}
+/**
+ * Create a typed engine error result with pino logging and correct exit code.
+ *
+ * @remarks
+ * The exit code is derived from the {@link STRING_TO_EXIT} mapping. If the
+ * code is not found in the map, exit code 1 (general error) is used.
+ * Pino logging is automatically triggered at the appropriate level
+ * (error for internal issues, warn for user/domain errors, debug for
+ * informational codes). Logging is suppressed under Vitest to keep
+ * test output clean.
+ *
+ * @param code - String error code (e.g., 'E_NOT_FOUND')
+ * @param message - Human-readable error message
+ * @param options - Optional details, fix command, and alternatives
+ * @returns EngineResult with success=false and properly structured error
+ *
+ * @example
+ * ```typescript
+ * import { engineError } from './_error.js';
+ *
+ * return engineError('E_NOT_FOUND', `Task ${id} not found`, {
+ *   fix: `cleo show ${id}`,
+ *   details: { taskId: id },
+ * });
+ * ```
+ */
+export function engineError(code, message, options) {
+    const exitCode = STRING_TO_EXIT[code] ?? 1;
+    const level = logLevel(exitCode);
+    // Keep test output clean: skip engine logging under Vitest.
+    const isVitest = process.env['VITEST'] === 'true';
+    if (!isVitest) {
+        // Lazy logger acquisition: avoids capturing the stderr fallback logger
+        // at module load time (before CLI's preAction hook calls initLogger()).
+        // This prevents the double-output envelope bug (T5148).
+        const logger = getLogger('engine');
+        logger[level]({ code, exitCode, ...(options?.details && { details: options.details }) }, message);
+    }
+    return {
+        success: false,
+        error: {
+            code,
+            message,
+            exitCode,
+            ...(options?.details && { details: options.details }),
+            ...(options?.fix && { fix: options.fix }),
+            ...(options?.alternatives && { alternatives: options.alternatives }),
+        },
+    };
+}
+/**
+ * Create an engine success result.
+ *
+ * @remarks
+ * Wraps arbitrary data in the standard EngineResult envelope with
+ * `success: true`. This is the complement to {@link engineError}.
+ *
+ * @param data - The result data
+ * @returns EngineResult with success=true
+ *
+ * @example
+ * ```typescript
+ * import { engineSuccess } from './_error.js';
+ *
+ * return engineSuccess({ tasks: filteredTasks, total: count });
+ * ```
+ */
+export function engineSuccess(data) {
+    return { success: true, data };
+}
+/**
+ * Convert any caught value into an {@link EngineResult}, forwarding the rich
+ * `fix`, `details`, and `alternatives` fields when the caught value is a
+ * `CleoError` (or structurally compatible object).
+ *
+ * @remarks
+ * This is the canonical catch-block helper for all dispatch engines. It
+ * replaces the previous pattern of:
+ * ```typescript
+ * const code = (err as { code?: number })?.code;
+ * if (code === 4) return engineError('E_NOT_FOUND', …);
+ * …
+ * ```
+ * with a single call that preserves every field the core layer attached.
+ *
+ * The `fallbackCode` is used when the numeric `err.code` is not present in
+ * the {@link STRING_TO_EXIT} mapping (e.g. unknown exit codes, plain `Error`
+ * instances, or values thrown by non-CLEO code).
+ *
+ * @param err - The caught value (unknown type)
+ * @param fallbackCode - String error code to use when mapping fails
+ * @param fallbackMessage - Human-readable message when `err.message` is absent
+ * @returns EngineResult with all available rich fields propagated
+ *
+ * @example
+ * ```typescript
+ * import { cleoErrorToEngineError } from './_error.js';
+ *
+ * } catch (err: unknown) {
+ *   return cleoErrorToEngineError(err, 'E_NOT_INITIALIZED', 'Task database not initialized');
+ * }
+ * ```
+ */
+export function cleoErrorToEngineError(err, fallbackCode, fallbackMessage) {
+    // Non-Error thrown values: a raw string is its own message; other primitives
+    // coerce to their String() form. Structured CleoError-like objects are
+    // handled in the branch below via `CaughtCleoErrorShape`.
+    if (typeof err === 'string') {
+        return engineError(fallbackCode, err);
+    }
+    if (err !== null && typeof err !== 'object') {
+        return engineError(fallbackCode, String(err));
+    }
+    const e = err;
+    const code = mapNumericExitCodeToString(e.code) ?? fallbackCode;
+    const message = e.message ?? fallbackMessage;
+    return engineError(code, message, {
+        ...(e.fix !== undefined && { fix: e.fix }),
+        ...(e.details !== undefined && { details: e.details }),
+        ...(e.alternatives !== undefined && { alternatives: e.alternatives }),
+    });
+}
+//# sourceMappingURL=_error.js.map

package/dist/dispatch/engines/_error.js.map

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

package/dist/dispatch/engines/code-engine.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Code analysis engine — dispatch wrapper for Smart Explore operations.
+ *
+ * Wraps @cleocode/core code analysis functions (parseFile, smartOutline,
+ * smartSearch, smartUnfold) for use via the dispatch gateway.
+ *
+ * @task T154
+ */
+import type { EngineResult } from '@cleocode/core/internal';
+/** code.outline — file structural skeleton. */
+export declare function codeOutline(params?: Record<string, unknown>): Promise<EngineResult>;
+/** code.search — cross-codebase symbol search. */
+export declare function codeSearch(params?: Record<string, unknown>): Promise<EngineResult>;
+/** code.unfold — single symbol extraction. */
+export declare function codeUnfold(params?: Record<string, unknown>): Promise<EngineResult>;
+/** code.parse — raw AST parse for a single file. */
+export declare function codeParse(params?: Record<string, unknown>): Promise<EngineResult>;
+//# sourceMappingURL=code-engine.d.ts.map

package/dist/dispatch/engines/code-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-engine.d.ts","sourceRoot":"","sources":["../../../src/dispatch/engines/code-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,+CAA+C;AAC/C,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAWzF;AAED,kDAAkD;AAClD,wBAAsB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBxF;AAED,8CAA8C;AAC9C,wBAAsB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAYxF;AAED,oDAAoD;AACpD,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAWvF"}

package/dist/dispatch/engines/code-engine.js

@@ -0,0 +1,71 @@
+/**
+ * Code analysis engine — dispatch wrapper for Smart Explore operations.
+ *
+ * Wraps @cleocode/core code analysis functions (parseFile, smartOutline,
+ * smartSearch, smartUnfold) for use via the dispatch gateway.
+ *
+ * @task T154
+ */
+import { join } from 'node:path';
+import { getProjectRoot } from '@cleocode/core';
+/** code.outline — file structural skeleton. */
+export async function codeOutline(params) {
+    const { smartOutline } = await import('@cleocode/core/internal');
+    const filePath = params?.file;
+    if (!filePath)
+        return {
+            success: false,
+            error: { code: 'E_INVALID_INPUT', message: 'file parameter required' },
+        };
+    const root = getProjectRoot();
+    const absPath = filePath.startsWith('/') ? filePath : join(root, filePath);
+    return { success: true, data: smartOutline(absPath, root) };
+}
+/** code.search — cross-codebase symbol search. */
+export async function codeSearch(params) {
+    const { smartSearch } = await import('@cleocode/core/internal');
+    const query = params?.query;
+    if (!query)
+        return {
+            success: false,
+            error: { code: 'E_INVALID_INPUT', message: 'query parameter required' },
+        };
+    const root = getProjectRoot();
+    const opts = {
+        rootDir: root,
+        maxResults: params?.max ?? 20,
+        filePattern: params?.path,
+    };
+    if (params?.lang) {
+        opts.language = params.lang;
+    }
+    return { success: true, data: smartSearch(query, opts) };
+}
+/** code.unfold — single symbol extraction. */
+export async function codeUnfold(params) {
+    const { smartUnfold } = await import('@cleocode/core/internal');
+    const filePath = params?.file;
+    const symbol = params?.symbol;
+    if (!filePath || !symbol)
+        return {
+            success: false,
+            error: { code: 'E_INVALID_INPUT', message: 'file and symbol parameters required' },
+        };
+    const root = getProjectRoot();
+    const absPath = filePath.startsWith('/') ? filePath : join(root, filePath);
+    return { success: true, data: smartUnfold(absPath, symbol, root) };
+}
+/** code.parse — raw AST parse for a single file. */
+export async function codeParse(params) {
+    const { parseFile } = await import('@cleocode/core/internal');
+    const filePath = params?.file;
+    if (!filePath)
+        return {
+            success: false,
+            error: { code: 'E_INVALID_INPUT', message: 'file parameter required' },
+        };
+    const root = getProjectRoot();
+    const absPath = filePath.startsWith('/') ? filePath : join(root, filePath);
+    return { success: true, data: parseFile(absPath, root) };
+}
+//# sourceMappingURL=code-engine.js.map

package/dist/dispatch/engines/code-engine.js.map

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

package/dist/dispatch/engines/codebase-map-engine.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Codebase Map Engine
+ *
+ * Thin wrapper around core codebase-map module for dispatch layer.
+ *
+ * @epic cognitive-cleo
+ */
+import { type EngineResult } from './_error.js';
+/**
+ * Analyze a codebase and return structured mapping.
+ * When storeToBrain is true, findings are persisted to brain.db.
+ *
+ * @remarks
+ * Delegates to the core `mapCodebase` module which performs static analysis
+ * of the project structure, conventions, testing setup, and integrations.
+ * The optional `focus` parameter narrows analysis to a specific aspect.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param options - Optional analysis options
+ * @returns EngineResult containing the structured codebase map
+ *
+ * @example
+ * ```typescript
+ * const result = await mapCodebase('/path/to/project', { focus: 'architecture' });
+ * ```
+ */
+export declare function mapCodebase(projectRoot: string, options?: {
+    focus?: string;
+    storeToBrain?: boolean;
+}): Promise<EngineResult>;
+//# sourceMappingURL=codebase-map-engine.d.ts.map

package/dist/dispatch/engines/codebase-map-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-map-engine.d.ts","sourceRoot":"","sources":["../../../src/dispatch/engines/codebase-map-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,aAAa,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,OAAO,CAAC,YAAY,CAAC,CAwBvB"}

package/dist/dispatch/engines/codebase-map-engine.js

@@ -0,0 +1,43 @@
+/**
+ * Codebase Map Engine
+ *
+ * Thin wrapper around core codebase-map module for dispatch layer.
+ *
+ * @epic cognitive-cleo
+ */
+import { engineError } from './_error.js';
+/**
+ * Analyze a codebase and return structured mapping.
+ * When storeToBrain is true, findings are persisted to brain.db.
+ *
+ * @remarks
+ * Delegates to the core `mapCodebase` module which performs static analysis
+ * of the project structure, conventions, testing setup, and integrations.
+ * The optional `focus` parameter narrows analysis to a specific aspect.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param options - Optional analysis options
+ * @returns EngineResult containing the structured codebase map
+ *
+ * @example
+ * ```typescript
+ * const result = await mapCodebase('/path/to/project', { focus: 'architecture' });
+ * ```
+ */
+export async function mapCodebase(projectRoot, options) {
+    try {
+        const { mapCodebase: coreMapCodebase } = await import('@cleocode/core/internal');
+        const result = await coreMapCodebase(projectRoot, {
+            focus: options?.focus,
+            storeToBrain: options?.storeToBrain,
+        });
+        return {
+            success: true,
+            data: result,
+        };
+    }
+    catch (err) {
+        return engineError('E_GENERAL', err instanceof Error ? err.message : String(err));
+    }
+}
+//# sourceMappingURL=codebase-map-engine.js.map

package/dist/dispatch/engines/codebase-map-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-map-engine.js","sourceRoot":"","sources":["../../../src/dispatch/engines/codebase-map-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqB,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAGC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QAEjF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE;YAChD,KAAK,EAAE,OAAO,EAAE,KAQH;YACb,YAAY,EAAE,OAAO,EAAE,YAAY;SACpC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,WAAW,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACpF,CAAC;AACH,CAAC"}

package/dist/dispatch/engines/config-engine.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Config Engine
+ *
+ * Thin wrapper around core config operations.
+ * Business logic lives in src/core/config.ts.
+ *
+ * @task T4815
+ * @task T067
+ */
+import { type EngineResult } from './_error.js';
+/**
+ * Get config value by key (dot-notation supported)
+ */
+export declare function configGet(projectRoot: string, key?: string): Promise<EngineResult<unknown>>;
+/**
+ * Set a config value by key (dot-notation supported)
+ */
+export declare function configSet(projectRoot: string, key: string, value: unknown): Promise<EngineResult<{
+    key: string;
+    value: unknown;
+}>>;
+/**
+ * Apply a strictness preset to the project config.
+ * @task T067
+ */
+export declare function configSetPreset(projectRoot: string, preset: string): Promise<EngineResult<unknown>>;
+/**
+ * List all available strictness presets.
+ * @task T067
+ */
+export declare function configListPresets(): EngineResult<unknown>;
+//# sourceMappingURL=config-engine.d.ts.map

package/dist/dispatch/engines/config-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-engine.d.ts","sourceRoot":"","sources":["../../../src/dispatch/engines/config-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,aAAa,CAAC;AAI7D;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAmBjG;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAOxD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAahC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,CAAC,OAAO,CAAC,CAEzD"}

package/dist/dispatch/engines/config-engine.js

@@ -0,0 +1,70 @@
+/**
+ * Config Engine
+ *
+ * Thin wrapper around core config operations.
+ * Business logic lives in src/core/config.ts.
+ *
+ * @task T4815
+ * @task T067
+ */
+import { applyStrictnessPreset, getRawConfig, getRawConfigValue, listStrictnessPresets, setConfigValue, } from '@cleocode/core';
+import { engineError } from './_error.js';
+const VALID_PRESETS = ['strict', 'standard', 'minimal'];
+/**
+ * Get config value by key (dot-notation supported)
+ */
+export async function configGet(projectRoot, key) {
+    try {
+        if (!key) {
+            const config = await getRawConfig(projectRoot);
+            if (!config) {
+                return engineError('E_NOT_INITIALIZED', 'No config.json found');
+            }
+            return { success: true, data: config };
+        }
+        const value = await getRawConfigValue(key, projectRoot);
+        if (value === undefined) {
+            return engineError('E_CONFIG_KEY_NOT_FOUND', `Config key '${key}' not found`);
+        }
+        return { success: true, data: value };
+    }
+    catch (err) {
+        return engineError('E_CONFIG_READ_FAILED', err.message);
+    }
+}
+/**
+ * Set a config value by key (dot-notation supported)
+ */
+export async function configSet(projectRoot, key, value) {
+    try {
+        const result = await setConfigValue(key, value, projectRoot);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_CONFIG_WRITE_FAILED', err.message);
+    }
+}
+/**
+ * Apply a strictness preset to the project config.
+ * @task T067
+ */
+export async function configSetPreset(projectRoot, preset) {
+    if (!VALID_PRESETS.includes(preset)) {
+        return engineError('E_INVALID_INPUT', `Invalid preset '${preset}'. Valid presets: ${VALID_PRESETS.join(', ')}`);
+    }
+    try {
+        const result = await applyStrictnessPreset(preset, projectRoot);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_CONFIG_WRITE_FAILED', err.message);
+    }
+}
+/**
+ * List all available strictness presets.
+ * @task T067
+ */
+export function configListPresets() {
+    return { success: true, data: listStrictnessPresets() };
+}
+//# sourceMappingURL=config-engine.js.map

package/dist/dispatch/engines/config-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-engine.js","sourceRoot":"","sources":["../../../src/dispatch/engines/config-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EAErB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAqB,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,aAAa,GAAuB,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAmB,EAAE,GAAY;IAC/D,IAAI,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,WAAW,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACzC,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,WAAW,CAAC,wBAAwB,EAAE,eAAe,GAAG,aAAa,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,sBAAsB,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,GAAW,EACX,KAAc;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,uBAAuB,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,MAAc;IAEd,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAA0B,CAAC,EAAE,CAAC;QACxD,OAAO,WAAW,CAChB,iBAAiB,EACjB,mBAAmB,MAAM,qBAAqB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAA0B,EAAE,WAAW,CAAC,CAAC;QACpF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,uBAAuB,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,qBAAqB,EAAE,EAAE,CAAC;AAC1D,CAAC"}

package/dist/dispatch/engines/diagnostics-engine.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Diagnostics Engine
+ *
+ * Business logic for `cleo diagnostics` — opt-in telemetry analysis and
+ * autonomous BRAIN observation generation.
+ *
+ * Operations:
+ *   - enable   → enable telemetry, generate anonymous ID
+ *   - disable  → disable telemetry collection
+ *   - status   → show current config and DB path
+ *   - analyze  → build diagnostics report and emit BRAIN observations
+ *   - export   → JSON dump for external analysis
+ *
+ * @task T624
+ */
+import { type EngineResult } from './_error.js';
+/**
+ * Enable telemetry collection.
+ * Generates a stable anonymous UUID on first call; preserves it on subsequent calls.
+ */
+export declare function diagnosticsEnable(): Promise<EngineResult<{
+    enabled: true;
+    anonymousId: string;
+    dbPath: string;
+    configPath: string;
+    message: string;
+}>>;
+/**
+ * Disable telemetry collection.
+ * Existing data in telemetry.db is preserved for historical analysis.
+ */
+export declare function diagnosticsDisable(): Promise<EngineResult<{
+    enabled: false;
+    message: string;
+}>>;
+/**
+ * Return current telemetry config and paths.
+ */
+export declare function diagnosticsStatus(): Promise<EngineResult<{
+    enabled: boolean;
+    anonymousId: string;
+    dbPath: string;
+    configPath: string;
+}>>;
+/**
+ * Build a diagnostics report and push high-signal patterns to BRAIN.
+ */
+export declare function diagnosticsAnalyze(days?: number, pushToBrain?: boolean): Promise<EngineResult<Record<string, unknown>>>;
+/**
+ * Export all telemetry events as a JSON array for external analysis.
+ */
+export declare function diagnosticsExport(days?: number): Promise<EngineResult<{
+    events: unknown[];
+    count: number;
+    exportedAt: string;
+}>>;
+//# sourceMappingURL=diagnostics-engine.d.ts.map

package/dist/dispatch/engines/diagnostics-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-engine.d.ts","sourceRoot":"","sources":["../../../src/dispatch/engines/diagnostics-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,aAAa,CAAC;AAM7D;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAChD,YAAY,CAAC;IACX,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CACH,CAiBA;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CACjD,YAAY,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAClD,CAcA;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAChD,YAAY,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CACH,CAWA;AAMD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,SAAK,EACT,WAAW,UAAO,GACjB,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAuDhD;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAsBjF"}