@cleocode/cleo 2026.4.161 → 2026.5.0

package/dist/dispatch/registry.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Unified CQRS Dispatch Layer -- Operation Registry
+ *
+ * Single source of truth for all operations mapped to 10 canonical domains.
+ * Canonical domains only -- no legacy alias support.
+ *
+ * @epic T4820
+ * @task T4814, T5241, T5615
+ */
+import type { CanonicalDomain, Gateway, ParamDef, Tier } from './types.js';
+/** Definition of a single dispatchable operation. */
+export interface OperationDef {
+    /** The CQRS gateway ('query' or 'mutate'). */
+    gateway: Gateway;
+    /** The canonical domain this operation belongs to. */
+    domain: CanonicalDomain;
+    /** The specific operation name (e.g. 'show', 'skill.list'). */
+    operation: string;
+    /** Brief description of what the operation does. */
+    description: string;
+    /** Agent progressive-disclosure tier (0=basic, 1=memory/check, 2=full). */
+    tier: Tier;
+    /** Whether the operation is safe to retry. */
+    idempotent: boolean;
+    /** Whether this operation requires an active session. */
+    sessionRequired: boolean;
+    /** List of parameter keys that MUST be present in the request. */
+    requiredParams: string[];
+    /**
+     * Fully-described parameter list. Replaces `requiredParams` when populated.
+     * Empty array = "no declared params" (not "no params accepted").
+     * Optional during T4897 migration — defaults to [] when absent.
+     * @see T4897 for progressive migration
+     */
+    params?: ParamDef[];
+}
+/**
+ * Resolution output for a dispatch request.
+ */
+export interface Resolution {
+    /** The canonical domain. */
+    domain: CanonicalDomain;
+    /** The operation name. */
+    operation: string;
+    /** The definition of the matched operation. */
+    def: OperationDef;
+}
+/**
+ * The single source of truth for all operations in CLEO.
+ */
+export declare const OPERATIONS: OperationDef[];
+/**
+ * Derive a gateway operation matrix from the registry.
+ *
+ * Returns `Record<string, string[]>` containing:
+ * - All canonical domains with their operations
+ *
+ * This is the SINGLE derivation point — gateways use this instead of
+ * maintaining independent operation lists.
+ */
+export declare function deriveGatewayMatrix(gateway: Gateway): Record<string, string[]>;
+/**
+ * Get all accepted domain names for a gateway (canonical only).
+ */
+export declare function getGatewayDomains(gateway: Gateway): string[];
+/**
+ * Resolves a domain + operation to its registered definition.
+ */
+export declare function resolve(gateway: Gateway, domain: string, operation: string): Resolution | undefined;
+/**
+ * Validates that all required parameters are present in the request.
+ * Returns an array of missing parameter keys.
+ */
+export declare function validateRequiredParams(def: OperationDef, params?: Record<string, unknown>): string[];
+/** Get all operations for a specific canonical domain. */
+export declare function getByDomain(domain: CanonicalDomain): OperationDef[];
+/** Get all operations for a specific gateway. */
+export declare function getByGateway(gateway: Gateway): OperationDef[];
+/** Get all operations available at or below a specific tier. */
+export declare function getByTier(tier: Tier): OperationDef[];
+/** Get a list of canonical domains that actually have operations registered. */
+export declare function getActiveDomains(): CanonicalDomain[];
+/**
+ * Returns summary counts of operations for module validation.
+ */
+export declare function getCounts(): {
+    query: number;
+    mutate: number;
+    total: number;
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/dispatch/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE3E,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,MAAM,EAAE,eAAe,CAAC;IACxB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,IAAI,EAAE,IAAI,CAAC;IACX,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,eAAe,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,GAAG,EAAE,YAAY,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,YAAY,EAo3MpC,CAAC;AAMF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAU9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAE5D;AAMD;;GAEG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,SAAS,CAQxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,YAAY,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,EAAE,CAMV;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,EAAE,CAEnE;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,EAAE,CAE7D;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,EAAE,CAEpD;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CAGpD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM5E"}