@cleocode/cleo 2026.3.56 → 2026.3.58

package/dist/cli/renderers/tasks.js

@@ -0,0 +1,306 @@
+/**
+ * Human-readable renderers for task-related CLI commands.
+ *
+ * Each renderer takes the same data shape that would be passed to formatSuccess()
+ * and returns a string suitable for terminal display.
+ *
+ * @task T4666
+ * @epic T4663
+ */
+import { BOLD, BOX, DIM, GREEN, hRule, NC, priorityColor, prioritySymbol, RED, shortDate, statusColor, statusSymbol, YELLOW, } from './colors.js';
+// ---------------------------------------------------------------------------
+// show: single task detail
+// ---------------------------------------------------------------------------
+/** Render a single task in a box format (mirrors bash display_text). */
+export function renderShow(data, quiet) {
+    const task = data['task'];
+    if (!task)
+        return 'No task found.';
+    if (quiet)
+        return renderShowQuiet(task);
+    return renderShowFull(task);
+}
+function renderShowQuiet(task) {
+    const sym = statusSymbol(task.status);
+    const pLabel = `[${task.priority}]`;
+    return `${task.id} ${sym} ${task.title} ${pLabel}\nStatus: ${task.status}`;
+}
+function renderShowFull(task) {
+    const lines = [];
+    const w = 65;
+    const hr = hRule(w);
+    const pCol = priorityColor(task.priority);
+    const sym = statusSymbol(task.status);
+    // Header box
+    lines.push('');
+    lines.push(`${BOX.tl}${hr}${BOX.tr}`);
+    lines.push(`${BOX.v}  ${BOLD}${task.id}${NC} ${sym} ${pCol}[${task.priority}]${NC}`);
+    lines.push(`${BOX.v}  ${task.title}`);
+    lines.push(`${BOX.ml}${hr}${BOX.mr}`);
+    // Core fields
+    lines.push(`${BOX.v}  ${DIM}Status:${NC}      ${task.status}`);
+    lines.push(`${BOX.v}  ${DIM}Priority:${NC}    ${task.priority}`);
+    if (task.type)
+        lines.push(`${BOX.v}  ${DIM}Type:${NC}        ${task.type}`);
+    if (task.phase)
+        lines.push(`${BOX.v}  ${DIM}Phase:${NC}       ${task.phase}`);
+    if (task.size)
+        lines.push(`${BOX.v}  ${DIM}Size:${NC}        ${task.size}`);
+    if (task.labels?.length)
+        lines.push(`${BOX.v}  ${DIM}Labels:${NC}      ${task.labels.join(', ')}`);
+    if (task.parentId)
+        lines.push(`${BOX.v}  ${DIM}Parent:${NC}      ${task.parentId}`);
+    const created = shortDate(task.createdAt);
+    if (created)
+        lines.push(`${BOX.v}  ${DIM}Created:${NC}     ${created}`);
+    const completed = shortDate(task.completedAt);
+    if (completed)
+        lines.push(`${BOX.v}  ${DIM}Completed:${NC}   ${completed}`);
+    // Description
+    if (task.description) {
+        lines.push(`${BOX.ml}${hr}${BOX.mr}`);
+        lines.push(`${BOX.v}  ${BOLD}Description${NC}`);
+        for (const line of task.description.split('\n')) {
+            lines.push(`${BOX.v}    ${line}`);
+        }
+    }
+    // Dependencies
+    if (task.depends?.length) {
+        lines.push(`${BOX.ml}${hr}${BOX.mr}`);
+        lines.push(`${BOX.v}  ${BOLD}Depends On${NC}`);
+        lines.push(`${BOX.v}    ${task.depends.join(', ')}`);
+    }
+    // Blocked by
+    if (task.blockedBy) {
+        lines.push(`${BOX.v}  ${BOLD}Blocked By${NC}`);
+        lines.push(`${BOX.v}    ${RED}${task.blockedBy}${NC}`);
+    }
+    // Notes
+    if (task.notes?.length) {
+        lines.push(`${BOX.ml}${hr}${BOX.mr}`);
+        lines.push(`${BOX.v}  ${BOLD}Notes${NC} (${task.notes.length})`);
+        const shown = task.notes.slice(-5);
+        for (const note of shown) {
+            const short = note.length > 58 ? note.slice(0, 55) + '...' : note;
+            lines.push(`${BOX.v}    \u2022 ${short}`);
+        }
+        if (task.notes.length > 5) {
+            lines.push(`${BOX.v}    ${DIM}... and ${task.notes.length - 5} more${NC}`);
+        }
+    }
+    // Files
+    if (task.files?.length) {
+        lines.push(`${BOX.ml}${hr}${BOX.mr}`);
+        lines.push(`${BOX.v}  ${BOLD}Files${NC}`);
+        lines.push(`${BOX.v}    ${task.files.join(', ')}`);
+    }
+    // Acceptance criteria
+    if (task.acceptance?.length) {
+        lines.push(`${BOX.ml}${hr}${BOX.mr}`);
+        lines.push(`${BOX.v}  ${BOLD}Acceptance Criteria${NC}`);
+        for (const criterion of task.acceptance) {
+            lines.push(`${BOX.v}    \u2610 ${criterion}`);
+        }
+    }
+    // Footer
+    lines.push(`${BOX.bl}${hr}${BOX.br}`);
+    lines.push('');
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// list: task list
+// ---------------------------------------------------------------------------
+/** Render a list of tasks (mirrors bash list.sh text output). */
+export function renderList(data, quiet) {
+    const tasks = data['tasks'] ?? [];
+    const total = data['total'] ?? tasks.length;
+    if (tasks.length === 0) {
+        return quiet ? '' : 'No tasks found.';
+    }
+    if (quiet) {
+        return tasks.map((t) => `${t.id} ${statusSymbol(t.status)} ${t.title}`).join('\n');
+    }
+    const lines = [];
+    // Group by priority
+    const groups = { critical: [], high: [], medium: [], low: [] };
+    for (const t of tasks) {
+        const key = t.priority ?? 'medium';
+        if (!groups[key])
+            groups[key] = [];
+        groups[key].push(t);
+    }
+    for (const prio of ['critical', 'high', 'medium', 'low']) {
+        const group = groups[prio];
+        if (!group || group.length === 0)
+            continue;
+        const pSym = prioritySymbol(prio);
+        const pCol = priorityColor(prio);
+        lines.push('');
+        lines.push(`${pCol}${pSym} ${prio.toUpperCase()} (${group.length})${NC}`);
+        for (const t of group) {
+            const sCol = statusColor(t.status);
+            const sSym = statusSymbol(t.status);
+            lines.push(`  ${BOLD}${t.id}${NC} ${sCol}${sSym} ${t.status}${NC}`);
+            lines.push(`      ${BOLD}${t.title}${NC}`);
+            if (t.labels?.length) {
+                lines.push(`      ${DIM}# ${t.labels.join(', ')}${NC}`);
+            }
+        }
+    }
+    lines.push('');
+    lines.push(`${DIM}${hRule(40)}${NC}`);
+    lines.push(`Total: ${total} tasks`);
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// find: search results
+// ---------------------------------------------------------------------------
+/** Render search results. */
+export function renderFind(data, quiet) {
+    const results = data['results'] ?? [];
+    const total = data['total'] ?? results.length;
+    if (results.length === 0) {
+        return quiet ? '' : 'No matching tasks found.';
+    }
+    if (quiet) {
+        return results.map((t) => `${t.id} ${t.title}`).join('\n');
+    }
+    const lines = [];
+    lines.push(`${BOLD}Found ${total} result${total !== 1 ? 's' : ''}${NC}`);
+    lines.push('');
+    for (const t of results) {
+        const sCol = statusColor(t.status);
+        const sSym = statusSymbol(t.status);
+        const pCol = priorityColor(t.priority);
+        lines.push(`  ${BOLD}${t.id}${NC} ${sCol}${sSym}${NC} ${pCol}[${t.priority}]${NC} ${t.title}`);
+        if (t.description) {
+            const short = t.description.length > 60 ? t.description.slice(0, 57) + '...' : t.description;
+            lines.push(`       ${DIM}${short}${NC}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// add: task created
+// ---------------------------------------------------------------------------
+/** Render add result. */
+export function renderAdd(data, quiet) {
+    const task = data['task'];
+    const duplicate = data['duplicate'];
+    const dryRun = data['dryRun'];
+    if (!task)
+        return 'No task created.';
+    if (quiet)
+        return task.id;
+    const prefix = dryRun
+        ? `${YELLOW}[DRY RUN]${NC} Would create:`
+        : duplicate
+            ? `${YELLOW}[DUPLICATE]${NC} Created:`
+            : `${GREEN}Created:${NC}`;
+    return `${prefix} ${BOLD}${task.id}${NC} ${task.title} [${task.priority}]`;
+}
+// ---------------------------------------------------------------------------
+// update: task updated
+// ---------------------------------------------------------------------------
+/** Render update result. */
+export function renderUpdate(data, quiet) {
+    const task = data['task'];
+    const changes = data['changes'];
+    if (!task)
+        return 'No task updated.';
+    if (quiet)
+        return task.id;
+    const lines = [];
+    lines.push(`${GREEN}Updated:${NC} ${BOLD}${task.id}${NC} ${task.title}`);
+    if (Array.isArray(changes) && changes.length > 0) {
+        lines.push(`  ${DIM}Changed:${NC} ${changes.join(', ')}`);
+    }
+    else if (changes && typeof changes === 'object' && Object.keys(changes).length > 0) {
+        for (const [key, val] of Object.entries(changes)) {
+            lines.push(`  ${DIM}${key}:${NC} ${String(val)}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// complete: task completed
+// ---------------------------------------------------------------------------
+/** Render complete result. */
+export function renderComplete(data, quiet) {
+    const task = data['task'];
+    const autoCompleted = data['autoCompleted'];
+    if (!task)
+        return 'No task completed.';
+    if (quiet)
+        return task.id;
+    const lines = [];
+    lines.push(`${GREEN}\u2713 Completed:${NC} ${BOLD}${task.id}${NC} ${task.title}`);
+    if (autoCompleted?.length) {
+        lines.push(`  ${DIM}Auto-completed ${autoCompleted.length} child task${autoCompleted.length > 1 ? 's' : ''}:${NC}`);
+        for (const child of autoCompleted) {
+            lines.push(`    ${child.id} ${child.title}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// delete: task deleted
+// ---------------------------------------------------------------------------
+/** Render delete result. */
+export function renderDelete(data, quiet) {
+    const deletedTask = data['deletedTask'];
+    const cascadeDeleted = data['cascadeDeleted'];
+    if (!deletedTask)
+        return 'No task deleted.';
+    if (quiet)
+        return deletedTask.id;
+    const lines = [];
+    lines.push(`${RED}\u2717 Deleted:${NC} ${BOLD}${deletedTask.id}${NC} ${deletedTask.title}`);
+    if (cascadeDeleted?.length) {
+        lines.push(`  ${DIM}Cascade-deleted ${cascadeDeleted.length} child task${cascadeDeleted.length > 1 ? 's' : ''}:${NC}`);
+        for (const child of cascadeDeleted) {
+            lines.push(`    ${child.id} ${child.title}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// archive: tasks archived
+// ---------------------------------------------------------------------------
+/** Render archive result. */
+export function renderArchive(data, quiet) {
+    const count = data['archivedCount'];
+    const dryRun = data['dryRun'];
+    const tasks = data['archivedTasks'];
+    if (quiet)
+        return String(count ?? 0);
+    if (dryRun) {
+        return `${YELLOW}[DRY RUN]${NC} Would archive ${count ?? 0} task${count !== 1 ? 's' : ''}`;
+    }
+    const lines = [];
+    lines.push(`${GREEN}Archived ${count ?? 0} task${count !== 1 ? 's' : ''}${NC}`);
+    if (tasks?.length) {
+        for (const t of tasks.slice(0, 10)) {
+            lines.push(`  ${t.id} ${t.title}`);
+        }
+        if (tasks.length > 10) {
+            lines.push(`  ${DIM}... and ${tasks.length - 10} more${NC}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// restore: task restored
+// ---------------------------------------------------------------------------
+/** Render restore result. */
+export function renderRestore(data, quiet) {
+    const task = data['task'];
+    const restoredTask = data['restoredTask'];
+    const t = task ?? restoredTask;
+    if (!t)
+        return 'No task restored.';
+    if (quiet)
+        return t.id;
+    return `${GREEN}Restored:${NC} ${BOLD}${t.id}${NC} ${t.title}`;
+}
+//# sourceMappingURL=tasks.js.map

package/dist/cli/renderers/tasks.js.map

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

package/dist/dispatch/adapters/cli.d.ts

@@ -0,0 +1,67 @@
+/**
+ * CLI Adapter for the CQRS Dispatch Layer.
+ *
+ * Provides dispatchFromCli() — the single entry point for all CLI commands
+ * that route through the dispatch pipeline. Also exports getCliDispatcher()
+ * for commands needing custom output handling.
+ *
+ * @epic T4820
+ * @task T4818
+ */
+import { type CliOutputOptions } from '../../cli/renderers/index.js';
+import { Dispatcher } from '../dispatcher.js';
+import type { DispatchResponse, Gateway } from '../types.js';
+/**
+ * Get or create the singleton CLI dispatcher.
+ *
+ * Creates a Dispatcher with all 9 domain handlers and sanitizer middleware.
+ * No rate limiter — CLI is a single-user tool.
+ */
+export declare function getCliDispatcher(): Dispatcher;
+/**
+ * Factory: creates a Dispatcher with all domain handlers + session-resolver,
+ * sanitizer, field-filter, and audit middleware.
+ *
+ * @epic T4959 — added session-resolver + audit to CLI pipeline
+ */
+export declare function createCliDispatcher(): Dispatcher;
+/**
+ * Reset the singleton dispatcher (for testing).
+ */
+export declare function resetCliDispatcher(): void;
+/**
+ * Build a DispatchRequest, dispatch it, and handle output/errors.
+ *
+ * This is the primary entry point for migrated CLI commands:
+ *   await dispatchFromCli('query', 'tasks', 'show', { taskId }, { command: 'show' });
+ *
+ * Automatically honors global --field/--fields/--mvi flags from the FieldContext:
+ * - --field <name>   → plain-text extraction, no JSON envelope
+ * - --fields <list>  → field-filter middleware filters the JSON response
+ * - --mvi <level>    → envelope verbosity passed to field-filter middleware
+ *
+ * On success: calls cliOutput(response.data, outputOpts)
+ * On error: calls cliError(message, exitCode) + process.exit(exitCode)
+ *
+ * @epic T4953
+ * @task T4955
+ */
+export declare function dispatchFromCli(gateway: Gateway, domain: string, operation: string, params?: Record<string, unknown>, outputOpts?: CliOutputOptions): Promise<void>;
+/**
+ * Handle an error response from dispatchRaw().
+ *
+ * Calls cliError() and process.exit() when the response indicates failure.
+ * No-op when response.success is true.
+ */
+export declare function handleRawError(response: DispatchResponse, _opts: {
+    command: string;
+    operation: string;
+}): void;
+/**
+ * Dispatch and return the raw response without handling output.
+ *
+ * For commands that need custom output logic (pagination, conditional
+ * messages, etc.), call this instead of dispatchFromCli().
+ */
+export declare function dispatchRaw(gateway: Gateway, domain: string, operation: string, params?: Record<string, unknown>): Promise<DispatchResponse>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/dispatch/adapters/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/dispatch/adapters/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,KAAK,gBAAgB,EAAuB,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAsC7D;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAK7C;AAmBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,CAWhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5C,IAAI,CAUN;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAU3B"}

package/dist/dispatch/adapters/cli.js

@@ -0,0 +1,205 @@
+/**
+ * CLI Adapter for the CQRS Dispatch Layer.
+ *
+ * Provides dispatchFromCli() — the single entry point for all CLI commands
+ * that route through the dispatch pipeline. Also exports getCliDispatcher()
+ * for commands needing custom output handling.
+ *
+ * @epic T4820
+ * @task T4818
+ */
+import { randomUUID } from 'node:crypto';
+import { autoRecordDispatchTokenUsage, getProjectRoot } from '@cleocode/core/internal';
+import { cliError, cliOutput } from '../../cli/renderers/index.js';
+import { Dispatcher } from '../dispatcher.js';
+import { createDomainHandlers } from '../domains/index.js';
+import { createAudit } from '../middleware/audit.js';
+import { createFieldFilter } from '../middleware/field-filter.js';
+import { createSanitizer } from '../middleware/sanitizer.js';
+import { createSessionResolver } from '../middleware/session-resolver.js';
+// Reverse mapping from string error codes to numeric exit codes.
+// Used when dispatch handlers return string error codes without exitCode.
+const ERROR_CODE_TO_EXIT = {
+    E_NOT_FOUND: 4,
+    E_INVALID_INPUT: 2,
+    E_FILE_ERROR: 3,
+    E_DEPENDENCY: 5,
+    E_VALIDATION: 6,
+    E_RETRYABLE: 7,
+    E_CONFIG_ERROR: 8,
+    E_PARENT_NOT_FOUND: 10,
+    E_DEPTH_EXCEEDED: 11,
+    E_SIBLING_LIMIT: 12,
+    E_CIRCULAR_DEP: 14,
+    E_INVALID_PARENT_TYPE: 13,
+    E_ORPHAN_DETECTED: 15,
+    E_HAS_CHILDREN: 16,
+    E_TASK_COMPLETED: 104,
+    E_HAS_DEPENDENTS: 19,
+    E_CHECKSUM_MISMATCH: 20,
+    E_SESSION_EXISTS: 30,
+    E_SESSION_NOT_FOUND: 31,
+    E_SCOPE_CONFLICT: 32,
+    E_ACTIVE_TASK_REQUIRED: 38,
+    E_INVALID_OPERATION: 2,
+    E_MISSING_PARAMS: 2,
+    E_NO_HANDLER: 1,
+    E_INTERNAL: 1,
+};
+// ---------------------------------------------------------------------------
+// Lazy singleton dispatcher
+// ---------------------------------------------------------------------------
+let _dispatcher = null;
+/**
+ * Get or create the singleton CLI dispatcher.
+ *
+ * Creates a Dispatcher with all 9 domain handlers and sanitizer middleware.
+ * No rate limiter — CLI is a single-user tool.
+ */
+export function getCliDispatcher() {
+    if (!_dispatcher) {
+        _dispatcher = createCliDispatcher();
+    }
+    return _dispatcher;
+}
+/**
+ * Best-effort lookup of the active session ID from SQLite.
+ * Used by session-resolver middleware for CLI commands.
+ * Returns null on any failure (many CLI commands don't need a session).
+ *
+ * @epic T4959
+ */
+async function lookupCliSession() {
+    try {
+        const { getActiveSession } = await import('@cleocode/core/internal');
+        const session = await getActiveSession();
+        return session?.id ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Factory: creates a Dispatcher with all domain handlers + session-resolver,
+ * sanitizer, field-filter, and audit middleware.
+ *
+ * @epic T4959 — added session-resolver + audit to CLI pipeline
+ */
+export function createCliDispatcher() {
+    const handlers = createDomainHandlers();
+    return new Dispatcher({
+        handlers,
+        middlewares: [
+            createSessionResolver(lookupCliSession), // T4959: session identity first
+            createSanitizer(() => getProjectRoot()),
+            createFieldFilter(),
+            createAudit(), // T4959: CLI now gets audit trail
+        ],
+    });
+}
+/**
+ * Reset the singleton dispatcher (for testing).
+ */
+export function resetCliDispatcher() {
+    _dispatcher = null;
+}
+// ---------------------------------------------------------------------------
+// Main adapter function
+// ---------------------------------------------------------------------------
+/**
+ * Build a DispatchRequest, dispatch it, and handle output/errors.
+ *
+ * This is the primary entry point for migrated CLI commands:
+ *   await dispatchFromCli('query', 'tasks', 'show', { taskId }, { command: 'show' });
+ *
+ * Automatically honors global --field/--fields/--mvi flags from the FieldContext:
+ * - --field <name>   → plain-text extraction, no JSON envelope
+ * - --fields <list>  → field-filter middleware filters the JSON response
+ * - --mvi <level>    → envelope verbosity passed to field-filter middleware
+ *
+ * On success: calls cliOutput(response.data, outputOpts)
+ * On error: calls cliError(message, exitCode) + process.exit(exitCode)
+ *
+ * @epic T4953
+ * @task T4955
+ */
+export async function dispatchFromCli(gateway, domain, operation, params, outputOpts) {
+    const dispatcher = getCliDispatcher();
+    const response = await dispatcher.dispatch({
+        gateway,
+        domain,
+        operation,
+        params,
+        source: 'cli',
+        requestId: randomUUID(),
+    });
+    if (response.success) {
+        await autoRecordDispatchTokenUsage({
+            requestPayload: params,
+            responsePayload: { data: response.data, page: response.page },
+            transport: 'cli',
+            gateway,
+            domain,
+            operation,
+            sessionId: response._meta.sessionId,
+            requestId: response._meta.requestId,
+            cwd: getProjectRoot(),
+        });
+        const opts = {
+            command: outputOpts?.command ?? operation,
+            operation: outputOpts?.operation ?? `${domain}.${operation}`,
+            ...outputOpts,
+        };
+        if (opts.page === undefined && response.page !== undefined) {
+            opts.page = response.page;
+        }
+        cliOutput(response.data, opts);
+    }
+    else {
+        // Derive exit code from the string error code when exitCode is not set
+        const errorCode = response.error?.code ?? 'E_GENERAL';
+        const exitCode = response.error?.exitCode ?? ERROR_CODE_TO_EXIT[errorCode] ?? 1;
+        cliError(response.error?.message ?? 'Unknown error', exitCode, {
+            name: errorCode,
+            details: response.error?.details,
+            fix: response.error?.fix,
+        });
+        process.exit(exitCode);
+    }
+}
+/**
+ * Handle an error response from dispatchRaw().
+ *
+ * Calls cliError() and process.exit() when the response indicates failure.
+ * No-op when response.success is true.
+ */
+export function handleRawError(response, _opts) {
+    if (response.success)
+        return;
+    const errorCode = response.error?.code ?? 'E_GENERAL';
+    const exitCode = response.error?.exitCode ?? ERROR_CODE_TO_EXIT[errorCode] ?? 1;
+    cliError(response.error?.message ?? 'Unknown error', exitCode, {
+        name: errorCode,
+        details: response.error?.details,
+        fix: response.error?.fix,
+    });
+    process.exit(exitCode);
+}
+/**
+ * Dispatch and return the raw response without handling output.
+ *
+ * For commands that need custom output logic (pagination, conditional
+ * messages, etc.), call this instead of dispatchFromCli().
+ */
+export async function dispatchRaw(gateway, domain, operation, params) {
+    const dispatcher = getCliDispatcher();
+    return dispatcher.dispatch({
+        gateway,
+        domain,
+        operation,
+        params,
+        source: 'cli',
+        requestId: randomUUID(),
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/dispatch/adapters/cli.js.map

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

package/dist/dispatch/adapters/mcp.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MCP Adapter for the CQRS Dispatch Layer.
+ *
+ * Provides handleMcpToolCall() — the single entry point for MCP requests
+ * that route through the dispatch pipeline.
+ *
+ * @epic T4820
+ * @task T4819
+ */
+import type { RateLimitingConfig } from '../../mcp/lib/rate-limiter.js';
+import { Dispatcher } from '../dispatcher.js';
+import type { DispatchResponse } from '../types.js';
+export interface McpDispatcherConfig {
+    rateLimiting?: Partial<RateLimitingConfig>;
+    strictMode?: boolean;
+}
+/**
+ * Initialize and get the singleton MCP dispatcher.
+ */
+export declare function initMcpDispatcher(config?: McpDispatcherConfig): Dispatcher;
+/**
+ * Get the initialized singleton MCP dispatcher.
+ */
+export declare function getMcpDispatcher(): Dispatcher;
+/**
+ * Reset the singleton dispatcher (for testing).
+ */
+export declare function resetMcpDispatcher(): void;
+/**
+ * Handle an MCP tool call (query or mutate).
+ *
+ * Translates the MCP parameters into a DispatchRequest, executes it
+ * through the dispatcher, and formats the response back to the standard
+ * MCP SDK format.
+ */
+export declare function handleMcpToolCall(gateway: string, domain: string, operation: string, params?: Record<string, unknown>, requestId?: string): Promise<DispatchResponse>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/dispatch/adapters/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/dispatch/adapters/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAU9C,OAAO,KAAK,EAAmB,gBAAgB,EAAW,MAAM,aAAa,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,mBAAwB,GAAG,UAAU,CAqB9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAK7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CA6D3B"}