@cleocode/contracts 2026.5.121 → 2026.5.123

package/dist/dispatch/__tests__/operation-envelope-snapshots.test.js

@@ -0,0 +1,265 @@
+import { describe, expect, it } from 'vitest';
+import { OPERATIONS } from '../operations-registry.js';
+function opId(op) {
+    return `${op.gateway}:${op.domain}:${op.operation}`;
+}
+function envelopeSnapshot(op) {
+    expect(op).toBeDefined();
+    return {
+        gateway: op?.gateway,
+        domain: op?.domain,
+        operation: op?.operation,
+        tier: op?.tier,
+        idempotent: op?.idempotent,
+        sessionRequired: op?.sessionRequired,
+        requiredParams: op?.requiredParams ?? [],
+        params: (op?.params ?? []).map((param) => ({
+            name: param.name,
+            type: param.type,
+            required: param.required,
+            cli: param.cli,
+        })),
+    };
+}
+function getOp(gateway, domain, operation) {
+    return OPERATIONS.find((op) => op.gateway === gateway && op.domain === domain && op.operation === operation);
+}
+describe('operation envelope registry snapshots (T10615)', () => {
+    it('keeps high-risk operation identities unique across gateway/domain/operation', () => {
+        const criticalIds = [
+            'query:tasks:show',
+            'query:tasks:workgraph.audit',
+            'mutate:tasks:saga.create',
+            'mutate:docs:update',
+        ];
+        const seen = new Set(OPERATIONS.map(opId));
+        expect([...seen].filter((id) => criticalIds.includes(id)).sort()).toEqual([...criticalIds].sort());
+    });
+    it('keeps requiredParams aligned with declared params for high-risk envelopes', () => {
+        const criticalOps = [
+            getOp('query', 'tasks', 'show'),
+            getOp('query', 'tasks', 'workgraph.audit'),
+            getOp('mutate', 'tasks', 'saga.create'),
+            getOp('mutate', 'docs', 'update'),
+        ].filter((op) => op !== undefined);
+        const offenders = criticalOps.flatMap((op) => {
+            const paramNames = new Set((op.params ?? []).map((param) => param.name));
+            return (op.requiredParams ?? [])
+                .filter((name) => !paramNames.has(name))
+                .map((missing) => `${opId(op)} missing declared param ${missing}`);
+        });
+        expect(offenders).toEqual([]);
+    });
+    it('snapshots high-risk operation envelopes consumed by CLI/domain dispatch adapters', () => {
+        const snapshots = {
+            'query:tasks:show': envelopeSnapshot(getOp('query', 'tasks', 'show')),
+            'query:tasks:workgraph.audit': envelopeSnapshot(getOp('query', 'tasks', 'workgraph.audit')),
+            'mutate:tasks:saga.create': envelopeSnapshot(getOp('mutate', 'tasks', 'saga.create')),
+            'mutate:docs:update': envelopeSnapshot(getOp('mutate', 'docs', 'update')),
+        };
+        expect(snapshots).toMatchInlineSnapshot(`
+      {
+        "mutate:docs:update": {
+          "domain": "docs",
+          "gateway": "mutate",
+          "idempotent": false,
+          "operation": "update",
+          "params": [
+            {
+              "cli": {
+                "positional": true,
+              },
+              "name": "slug",
+              "required": true,
+              "type": "string",
+            },
+            {
+              "cli": undefined,
+              "name": "file",
+              "required": false,
+              "type": "string",
+            },
+            {
+              "cli": {
+                "flag": "allow-external",
+              },
+              "name": "allowExternal",
+              "required": false,
+              "type": "boolean",
+            },
+            {
+              "cli": undefined,
+              "name": "content",
+              "required": false,
+              "type": "string",
+            },
+            {
+              "cli": undefined,
+              "name": "message",
+              "required": false,
+              "type": "string",
+            },
+            {
+              "cli": undefined,
+              "name": "status",
+              "required": false,
+              "type": "string",
+            },
+            {
+              "cli": {
+                "flag": "dry-run",
+              },
+              "name": "dryRun",
+              "required": false,
+              "type": "boolean",
+            },
+            {
+              "cli": undefined,
+              "name": "strict",
+              "required": false,
+              "type": "boolean",
+            },
+            {
+              "cli": {
+                "flag": "attached-by",
+              },
+              "name": "attachedBy",
+              "required": false,
+              "type": "string",
+            },
+          ],
+          "requiredParams": [
+            "slug",
+          ],
+          "sessionRequired": false,
+          "tier": 1,
+        },
+        "mutate:tasks:saga.create": {
+          "domain": "tasks",
+          "gateway": "mutate",
+          "idempotent": false,
+          "operation": "saga.create",
+          "params": [
+            {
+              "cli": {
+                "flag": "title",
+              },
+              "name": "title",
+              "required": true,
+              "type": "string",
+            },
+            {
+              "cli": {
+                "flag": "description",
+                "short": "-d",
+              },
+              "name": "description",
+              "required": false,
+              "type": "string",
+            },
+            {
+              "cli": {
+                "flag": "acceptance",
+              },
+              "name": "acceptance",
+              "required": false,
+              "type": "array",
+            },
+            {
+              "cli": {
+                "flag": "dry-run",
+              },
+              "name": "dryRun",
+              "required": false,
+              "type": "boolean",
+            },
+          ],
+          "requiredParams": [
+            "title",
+          ],
+          "sessionRequired": false,
+          "tier": 0,
+        },
+        "query:tasks:show": {
+          "domain": "tasks",
+          "gateway": "query",
+          "idempotent": true,
+          "operation": "show",
+          "params": [
+            {
+              "cli": {
+                "positional": true,
+              },
+              "name": "taskId",
+              "required": true,
+              "type": "string",
+            },
+            {
+              "cli": undefined,
+              "name": "history",
+              "required": false,
+              "type": "boolean",
+            },
+            {
+              "cli": undefined,
+              "name": "ivtr-history",
+              "required": false,
+              "type": "boolean",
+            },
+          ],
+          "requiredParams": [
+            "taskId",
+          ],
+          "sessionRequired": false,
+          "tier": 0,
+        },
+        "query:tasks:workgraph.audit": {
+          "domain": "tasks",
+          "gateway": "query",
+          "idempotent": true,
+          "operation": "workgraph.audit",
+          "params": [
+            {
+              "cli": {
+                "positional": true,
+              },
+              "name": "rootId",
+              "required": true,
+              "type": "string",
+            },
+            {
+              "cli": undefined,
+              "name": "maxDepth",
+              "required": false,
+              "type": "number",
+            },
+            {
+              "cli": undefined,
+              "name": "includeRelations",
+              "required": false,
+              "type": "boolean",
+            },
+            {
+              "cli": undefined,
+              "name": "cursor",
+              "required": false,
+              "type": "string",
+            },
+            {
+              "cli": undefined,
+              "name": "limit",
+              "required": false,
+              "type": "number",
+            },
+          ],
+          "requiredParams": [
+            "rootId",
+          ],
+          "sessionRequired": false,
+          "tier": 1,
+        },
+      }
+    `);
+    });
+});
+//# sourceMappingURL=operation-envelope-snapshots.test.js.map

package/dist/dispatch/__tests__/operation-envelope-snapshots.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-envelope-snapshots.test.js","sourceRoot":"","sources":["../../../src/dispatch/__tests__/operation-envelope-snapshots.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,SAAS,IAAI,CAAC,EAAgB;IAC5B,OAAO,GAAG,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,gBAAgB,CAAC,EAA4B;IACpD,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACzB,OAAO;QACL,OAAO,EAAE,EAAE,EAAE,OAAO;QACpB,MAAM,EAAE,EAAE,EAAE,MAAM;QAClB,SAAS,EAAE,EAAE,EAAE,SAAS;QACxB,IAAI,EAAE,EAAE,EAAE,IAAI;QACd,UAAU,EAAE,EAAE,EAAE,UAAU;QAC1B,eAAe,EAAE,EAAE,EAAE,eAAe;QACpC,cAAc,EAAE,EAAE,EAAE,cAAc,IAAI,EAAE;QACxC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CACZ,OAAgC,EAChC,MAAc,EACd,SAAiB;IAEjB,OAAO,UAAU,CAAC,IAAI,CACpB,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,KAAK,OAAO,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM,IAAI,EAAE,CAAC,SAAS,KAAK,SAAS,CACrF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC9D,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,WAAW,GAAG;YAClB,kBAAkB;YAClB,6BAA6B;YAC7B,0BAA0B;YAC1B,oBAAoB;SACrB,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAE3C,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CACvE,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,WAAW,GAAG;YAClB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;YAC/B,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC;YAC1C,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC;YACvC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAsB,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QAEvD,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YAC3C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACzE,OAAO,CAAC,EAAE,CAAC,cAAc,IAAI,EAAE,CAAC;iBAC7B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;iBACvC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;QAC1F,MAAM,SAAS,GAAG;YAChB,kBAAkB,EAAE,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACrE,6BAA6B,EAAE,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;YAC3F,0BAA0B,EAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;YACrF,oBAAoB,EAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SAC1E,CAAC;QAEF,MAAM,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0MvC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -1 +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,EAk/PpC,CAAC"}
+{"version":3,"file":"operations-registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/operations-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,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,EAg+QpC,CAAC"}