@cleocode/contracts 2026.5.98 → 2026.5.100

package/dist/__tests__/operations-registry.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Snapshot test for the OPERATIONS registry data.
+ *
+ * Pins the exact JSON shape of the full OPERATIONS array so that any
+ * accidental addition, removal, or mutation of an entry is caught
+ * immediately. This test MUST pass before and after the T10061 data
+ * relocation — it is the primary guard against behavior change.
+ *
+ * To update the snapshot intentionally:
+ *   pnpm vitest --filter @cleocode/contracts run -u
+ *
+ * @since T10061 — T9833b / E-CLI-BOUNDARY / SG-ARCH-SOLID T9831
+ */
+export {};
+//# sourceMappingURL=operations-registry.test.d.ts.map

package/dist/__tests__/operations-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/operations-registry.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/__tests__/operations-registry.test.js

@@ -0,0 +1,48 @@
+/**
+ * Snapshot test for the OPERATIONS registry data.
+ *
+ * Pins the exact JSON shape of the full OPERATIONS array so that any
+ * accidental addition, removal, or mutation of an entry is caught
+ * immediately. This test MUST pass before and after the T10061 data
+ * relocation — it is the primary guard against behavior change.
+ *
+ * To update the snapshot intentionally:
+ *   pnpm vitest --filter @cleocode/contracts run -u
+ *
+ * @since T10061 — T9833b / E-CLI-BOUNDARY / SG-ARCH-SOLID T9831
+ */
+import { describe, expect, it } from 'vitest';
+import { defineDomain, defineOp, OPERATIONS } from '../dispatch/operations-registry.js';
+describe('operations-registry', () => {
+    it('OPERATIONS snapshot — zero behavior change across relocation', () => {
+        expect(JSON.stringify(OPERATIONS)).toMatchSnapshot();
+    });
+    it('OPERATIONS count is consistent', () => {
+        expect(OPERATIONS.length).toBeGreaterThan(0);
+        const queryCount = OPERATIONS.filter((o) => o.gateway === 'query').length;
+        const mutateCount = OPERATIONS.filter((o) => o.gateway === 'mutate').length;
+        expect(queryCount + mutateCount).toBe(OPERATIONS.length);
+    });
+    it('every operation has required structural fields', () => {
+        for (const op of OPERATIONS) {
+            expect(typeof op.gateway).toBe('string');
+            expect(typeof op.domain).toBe('string');
+            expect(typeof op.operation).toBe('string');
+            expect(typeof op.description).toBe('string');
+            expect(typeof op.tier).toBe('number');
+            expect(typeof op.idempotent).toBe('boolean');
+            expect(typeof op.sessionRequired).toBe('boolean');
+            expect(Array.isArray(op.requiredParams)).toBe(true);
+        }
+    });
+    it('defineOp is an identity function', () => {
+        const def = OPERATIONS[0];
+        expect(defineOp(def)).toBe(def);
+    });
+    it('defineDomain returns the ops array unchanged', () => {
+        const ops = OPERATIONS.filter((o) => o.domain === 'tasks');
+        const result = defineDomain('tasks', ops);
+        expect(result).toBe(ops);
+    });
+});
+//# sourceMappingURL=operations-registry.test.js.map

package/dist/__tests__/operations-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations-registry.test.js","sourceRoot":"","sources":["../../src/__tests__/operations-registry.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAExF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QAC1E,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QAC5E,MAAM,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7C,MAAM,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/dispatch/operations-registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Operations Registry — canonical OPERATIONS data for the CLEO dispatch layer.
+ *
+ * Relocated from `packages/cleo/src/dispatch/registry.ts` in T10061 /
+ * T9833b (E-CLI-BOUNDARY · Saga T9831 SG-ARCH-SOLID). The data array and
+ * builder helpers live here so that contracts owns the registry shape while
+ * `packages/cleo/src/dispatch/registry.ts` becomes a thin re-export shim.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CLI-BOUNDARY T9833 · T10061
+ */
+import type { CanonicalDomain, Gateway, OperationDef, ParamDef, Tier } from './operation-def.js';
+export type { CanonicalDomain, Gateway, OperationDef, ParamDef, Tier };
+/**
+ * Type-constraining builder for a single {@link OperationDef}.
+ *
+ * Acts as an identity function: accepts an OperationDef literal and returns
+ * it unchanged. The purpose is to enforce the type at the call site so that
+ * editors provide auto-complete and TypeScript catches structural errors at
+ * authoring time rather than at array-level `satisfies` checks.
+ */
+export declare function defineOp(def: OperationDef): OperationDef;
+/**
+ * Groups N {@link OperationDef} entries that share a {@link CanonicalDomain}.
+ *
+ * Returns the flat array of definitions — the grouping is purely a
+ * documentation/authoring convenience so large domains can be broken up
+ * into domain-scoped sections without changing the flat {@link OPERATIONS}
+ * shape that the dispatcher consumes.
+ */
+export declare function defineDomain(_domain: CanonicalDomain, ops: OperationDef[]): OperationDef[];
+/** The single source of truth for all operations in CLEO. */
+export declare const OPERATIONS: OperationDef[];
+//# sourceMappingURL=operations-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations-registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/operations-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjG,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAMvE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE1F;AAMD,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,YAAY,EAkwPpC,CAAC"}