@cleocode/cleo 2026.4.57 → 2026.4.59

package/dist/dispatch/domains/_base.js

@@ -0,0 +1,77 @@
+/**
+ * Shared base helpers for domain handlers.
+ * DRY utility -- extracts the 4 common patterns found in all domain handlers.
+ *
+ * All functions are standalone (not a class) to match the function-based helper style.
+ * Handlers call these instead of re-implementing wrapEngineResult, errorResponse, etc.
+ *
+ * @epic T5671
+ */
+import { dispatchMeta } from './_meta.js';
+/**
+ * Wrap a native engine result into a DispatchResponse.
+ * Handles success data, page metadata, and structured errors.
+ */
+export function wrapResult(result, gateway, domain, operation, startTime) {
+    return {
+        meta: dispatchMeta(gateway, domain, operation, startTime),
+        success: result.success,
+        ...(result.success ? { data: result.data } : {}),
+        ...(result.page ? { page: result.page } : {}),
+        ...(result.error
+            ? {
+                error: {
+                    code: result.error.code,
+                    message: result.error.message,
+                    details: result.error.details,
+                    exitCode: result.error.exitCode,
+                    fix: result.error.fix,
+                    alternatives: result.error.alternatives,
+                    ...(result.error.problemDetails ? { problemDetails: result.error.problemDetails } : {}),
+                },
+            }
+            : {}),
+    };
+}
+/**
+ * Return a standard error response.
+ */
+export function errorResult(gateway, domain, operation, code, message, startTime) {
+    return {
+        meta: dispatchMeta(gateway, domain, operation, startTime),
+        success: false,
+        error: { code, message },
+    };
+}
+/**
+ * Return a standard "unsupported operation" error response.
+ */
+export function unsupportedOp(gateway, domain, operation, startTime) {
+    return {
+        meta: dispatchMeta(gateway, domain, operation, startTime),
+        success: false,
+        error: { code: 'E_INVALID_OPERATION', message: `Unknown ${domain} ${gateway}: ${operation}` },
+    };
+}
+/**
+ * Extract limit and offset pagination params from a params dict.
+ */
+export function getListParams(params) {
+    const limit = typeof params?.limit === 'number' && params.limit > 0 ? params.limit : undefined;
+    const offset = typeof params?.offset === 'number' && params.offset > 0 ? params.offset : undefined;
+    return { limit, offset };
+}
+/**
+ * Handle a caught error: extract message and return an internal error response.
+ * Callers should log the error themselves (with their domain-specific logger)
+ * before or after calling this.
+ */
+export function handleErrorResult(gateway, domain, operation, error, startTime) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        meta: dispatchMeta(gateway, domain, operation, startTime),
+        success: false,
+        error: { code: 'E_INTERNAL', message },
+    };
+}
+//# sourceMappingURL=_base.js.map

package/dist/dispatch/domains/_base.js.map

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

package/dist/dispatch/domains/_meta.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Convenience wrapper for dispatch metadata creation.
+ *
+ * Domain handlers call dispatchMeta() to build DispatchResponse['meta']
+ * without importing the factory directly.
+ *
+ * @task T4772
+ */
+import type { DispatchResponse, Source } from '../types.js';
+/**
+ * Build metadata for a dispatch domain response.
+ *
+ * @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
+ * @param source    - Where the request originated
+ * @returns Metadata conforming to DispatchResponse['meta']
+ *
+ * @task T4772
+ */
+export declare function dispatchMeta(gateway: string, domain: string, operation: string, startTime: number, source?: Source): DispatchResponse['meta'];
+//# sourceMappingURL=_meta.d.ts.map

package/dist/dispatch/domains/_meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_meta.d.ts","sourceRoot":"","sources":["../../../src/dispatch/domains/_meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAc,GACrB,gBAAgB,CAAC,MAAM,CAAC,CAE1B"}

package/dist/dispatch/domains/_meta.js

@@ -0,0 +1,25 @@
+/**
+ * Convenience wrapper for dispatch metadata creation.
+ *
+ * Domain handlers call dispatchMeta() to build DispatchResponse['meta']
+ * without importing the factory directly.
+ *
+ * @task T4772
+ */
+import { createDispatchMeta } from '../lib/meta.js';
+/**
+ * Build metadata for a dispatch domain response.
+ *
+ * @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
+ * @param source    - Where the request originated
+ * @returns Metadata conforming to DispatchResponse['meta']
+ *
+ * @task T4772
+ */
+export function dispatchMeta(gateway, domain, operation, startTime, source = 'cli') {
+    return createDispatchMeta(gateway, domain, operation, startTime, source);
+}
+//# sourceMappingURL=_meta.js.map

package/dist/dispatch/domains/_meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_meta.js","sourceRoot":"","sources":["../../../src/dispatch/domains/_meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,MAAc,EACd,SAAiB,EACjB,SAAiB,EACjB,SAAiB,KAAK;IAEtB,OAAO,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAC3E,CAAC"}

package/dist/dispatch/domains/_routing.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared parameter-based routing for merged operations.
+ * DRY utility -- all domain handlers use this instead of re-implementing action dispatch.
+ *
+ * @epic T5671
+ */
+export declare function routeByParam<T>(params: Record<string, unknown> | undefined, paramName: string, routes: Record<string, () => T>, defaultRoute?: string): T;
+//# sourceMappingURL=_routing.d.ts.map

package/dist/dispatch/domains/_routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_routing.d.ts","sourceRoot":"","sources":["../../../src/dispatch/domains/_routing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC/B,YAAY,CAAC,EAAE,MAAM,GACpB,CAAC,CAYH"}

package/dist/dispatch/domains/_routing.js

@@ -0,0 +1,20 @@
+/**
+ * Shared parameter-based routing for merged operations.
+ * DRY utility -- all domain handlers use this instead of re-implementing action dispatch.
+ *
+ * @epic T5671
+ */
+export function routeByParam(params, paramName, routes, defaultRoute) {
+    const value = params?.[paramName] ?? defaultRoute;
+    if (!value) {
+        const available = Object.keys(routes).join(', ');
+        throw new Error(`Missing required param '${paramName}'. Available: ${available}`);
+    }
+    const handler = routes[value];
+    if (!handler) {
+        const available = Object.keys(routes).join(', ');
+        throw new Error(`Unknown ${paramName} '${value}'. Available: ${available}`);
+    }
+    return handler();
+}
+//# sourceMappingURL=_routing.js.map

package/dist/dispatch/domains/_routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_routing.js","sourceRoot":"","sources":["../../../src/dispatch/domains/_routing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,YAAY,CAC1B,MAA2C,EAC3C,SAAiB,EACjB,MAA+B,EAC/B,YAAqB;IAErB,MAAM,KAAK,GAAI,MAAM,EAAE,CAAC,SAAS,CAAY,IAAI,YAAY,CAAC;IAC9D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,iBAAiB,SAAS,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,KAAK,KAAK,iBAAiB,SAAS,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC"}

package/dist/dispatch/domains/admin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Admin Domain Handler (Dispatch Layer)
+ *
+ * Consolidates system domain operations into the canonical "admin"
+ * domain. Handles version, health, config, stats, context, job management,
+ * dashboard, log, sequence, init, backup, restore, migrate, cleanup,
+ * safestop, inject.generate, token, adr, export, import, install.global,
+ * and context.inject.
+ *
+ * All operations delegate to native engine functions from system-engine,
+ * config-engine, and init-engine.
+ *
+ * @epic T4820
+ * @task T5671
+ */
+import type { DispatchResponse, DomainHandler } from '../types.js';
+export declare class AdminHandler implements DomainHandler {
+    query(operation: string, params?: Record<string, unknown>): Promise<DispatchResponse>;
+    mutate(operation: string, params?: Record<string, unknown>): Promise<DispatchResponse>;
+    getSupportedOperations(): {
+        query: string[];
+        mutate: string[];
+    };
+}
+//# sourceMappingURL=admin.d.ts.map

package/dist/dispatch/domains/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../src/dispatch/domains/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4DH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAenE,qBAAa,YAAa,YAAW,aAAa;IAK1C,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6jBrF,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqgB5F,sBAAsB,IAAI;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAiDhE"}