@cleocode/contracts 2026.6.6 → 2026.6.8

package/dist/operations/__tests__/output-contracts.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tests for the per-operation OUTPUT contract SSoT (T11692 / DHQ-057).
+ *
+ * Pins the proof-set of OUTPUT contracts and — critically — encodes the exact
+ * shape fact that produced the bug: `tasks.show` returns the task under `task`,
+ * so the canonical pointer is `/data/task/title`, NOT `/data/title`.
+ *
+ * Also validates that mutation contracts reflect the MinimalMutateEnvelope
+ * shape (string[] ids, NOT object arrays) and that tasks.find uses the
+ * { results, total } wrapper (NOT a bare array).
+ *
+ * @task T11692
+ * @epic T11679
+ */
+export {};
+//# sourceMappingURL=output-contracts.test.d.ts.map

package/dist/operations/__tests__/output-contracts.test.d.ts.map

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

package/dist/operations/__tests__/output-contracts.test.js

@@ -0,0 +1,103 @@
+/**
+ * Tests for the per-operation OUTPUT contract SSoT (T11692 / DHQ-057).
+ *
+ * Pins the proof-set of OUTPUT contracts and — critically — encodes the exact
+ * shape fact that produced the bug: `tasks.show` returns the task under `task`,
+ * so the canonical pointer is `/data/task/title`, NOT `/data/title`.
+ *
+ * Also validates that mutation contracts reflect the MinimalMutateEnvelope
+ * shape (string[] ids, NOT object arrays) and that tasks.find uses the
+ * { results, total } wrapper (NOT a bare array).
+ *
+ * @task T11692
+ * @epic T11679
+ */
+import { describe, expect, it } from 'vitest';
+import { OUTPUT_CONTRACTS } from '../output-contracts-data.js';
+describe('operations/output-contracts (T11692 · DHQ-057)', () => {
+    it('registers the high-traffic proof-set operations', () => {
+        for (const op of [
+            'tasks.show',
+            'tasks.list',
+            'tasks.find',
+            'tasks.add',
+            'tasks.add-batch',
+            'tasks.update',
+            'tasks.complete',
+        ]) {
+            expect(OUTPUT_CONTRACTS[op], `missing output contract for ${op}`).toBeDefined();
+        }
+    });
+    it('keys every entry by its own operation id', () => {
+        for (const [key, contract] of Object.entries(OUTPUT_CONTRACTS)) {
+            expect(contract.operation).toBe(key);
+        }
+    });
+    describe('tasks.show — the operation that bit us', () => {
+        const show = OUTPUT_CONTRACTS['tasks.show'];
+        it('encodes that the task is nested under `task` (data schema)', () => {
+            const schema = show.dataSchema;
+            expect(schema.required).toContain('task');
+            // The title lives under task.properties.title — NOT at the data root.
+            expect(schema.properties?.task?.properties).toHaveProperty('title');
+            expect(schema.properties).not.toHaveProperty('title');
+        });
+        it('lists /data/task/title as a valid --field pointer and NOT /data/title', () => {
+            expect(show.fieldPointers).toContain('/data/task/title');
+            expect(show.fieldPointers).not.toContain('/data/title');
+        });
+        it('carries a shapeNote steering agents away from /data/<field>', () => {
+            expect(show.shapeNote).toBeTruthy();
+            expect(show.shapeNote).toContain('/data/task/');
+        });
+        it('notes that view may be null', () => {
+            expect(show.shapeNote).toContain('null');
+        });
+    });
+    describe('mutation envelopes — MinimalMutateEnvelope (string[] ids, T9931)', () => {
+        it('tasks.add surfaces the created task ID as a bare string at /data/created/0', () => {
+            const add = OUTPUT_CONTRACTS['tasks.add'];
+            // Correct: /data/created/0 → "T11692" (string), NOT /data/created/0/id
+            expect(add.fieldPointers).toContain('/data/created/0');
+            expect(add.fieldPointers).not.toContain('/data/created/0/id');
+            // Schema must reflect string[] items, not object[]
+            const schema = add.dataSchema;
+            expect(schema.required).toEqual(expect.arrayContaining(['count', 'created', 'updated', 'deleted']));
+            expect(schema.properties?.created?.items?.type).toBe('string');
+            expect(schema.properties?.updated?.items?.type).toBe('string');
+            expect(schema.properties?.deleted?.items?.type).toBe('string');
+        });
+        it('tasks.update / tasks.complete surface the changed task ID at /data/updated/0 (string)', () => {
+            for (const op of ['tasks.update', 'tasks.complete']) {
+                const c = OUTPUT_CONTRACTS[op];
+                // Correct: /data/updated/0 → "T11692" (string), NOT /data/updated/0/id
+                expect(c.fieldPointers).toContain('/data/updated/0');
+                expect(c.fieldPointers).not.toContain('/data/updated/0/id');
+                const schema = c.dataSchema;
+                expect(schema.properties?.updated?.items?.type).toBe('string');
+            }
+        });
+        it('tasks.add-batch dry-run pointers point to root /data/wouldCreate and /data/insertedCount', () => {
+            const batch = OUTPUT_CONTRACTS['tasks.add-batch'];
+            // Correct: root-level, NOT /data/dryRunSummary/wouldCreate
+            expect(batch.fieldPointers).toContain('/data/wouldCreate');
+            expect(batch.fieldPointers).toContain('/data/insertedCount');
+            expect(batch.fieldPointers).not.toContain('/data/dryRunSummary/wouldCreate');
+            expect(batch.fieldPointers).not.toContain('/data/dryRunSummary/insertedCount');
+            // shapeNote should clarify they are NOT under dryRunSummary
+            expect(batch.shapeNote).toContain('/data/wouldCreate');
+        });
+    });
+    it('tasks.find data is a wrapper object with /data/results (array) and /data/total', () => {
+        const find = OUTPUT_CONTRACTS['tasks.find'];
+        // Correct: wrapper object, NOT a bare array
+        expect(find.dataSchema.type).toBe('object');
+        // Correct pointers
+        expect(find.fieldPointers).toContain('/data/results/0/id');
+        expect(find.fieldPointers).toContain('/data/total');
+        // Wrong pointers must NOT appear
+        expect(find.fieldPointers).not.toContain('/data/0/id');
+        expect(find.shapeNote).toContain('/data/results');
+    });
+});
+//# sourceMappingURL=output-contracts.test.js.map

package/dist/operations/__tests__/output-contracts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-contracts.test.js","sourceRoot":"","sources":["../../../src/operations/__tests__/output-contracts.test.ts"],"names":[],"mappings":"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"}

package/dist/operations/docs.d.ts

@@ -329,15 +329,25 @@ export interface DocsGenerateResult {
 /**
  * Parameters for `docs.add`.
  *
- * Exactly one of `file` or `url` must be provided.
+ * Exactly one of `file`, `url`, or `content` must be provided.
  */
 export interface DocsAddParams {
     /** Owner entity ID (task, session, observation, etc.) — required. */
     ownerId: string;
-    /** Local file path to attach (mutually exclusive with `url`). */
+    /** Local file path to attach (mutually exclusive with `url` and `content`). */
     file?: string;
-    /** URL to attach as reference (mutually exclusive with `file`). */
+    /** URL to attach as reference (mutually exclusive with `file` and `content`). */
     url?: string;
+    /**
+     * Inline document body authored directly on the command line or piped via
+     * stdin (`--content -`). Mutually exclusive with `file` and `url`. Stored
+     * as a `text/markdown` blob exactly as a file-sourced add would be —
+     * including the manifest.db mirror, slug reservation, memory observation,
+     * and audit trail — so a doc can be created without a pre-existing file.
+     *
+     * @task T10965
+     */
+    content?: string;
     /** Optional human-readable description. */
     desc?: string;
     /** Optional comma-separated labels for categorization. */

package/dist/operations/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/operations/docs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/operations/docs.ts"],"names":[],"mappings":"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"}

package/dist/operations/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/operations/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,uBAAuB,EAAuB,MAAM,qBAAqB,CAAC;AAuBnF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,uBAAwD,CAAC;AA2H3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAiT1C,6EAA6E;AAC7E,kDAAkD;AAClD,6EAA6E;AAE7E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO;IACP,UAAU;IACV,UAAU;IACV,YAAY;IACZ,UAAU;IACV,YAAY;CACJ,CAAC;AAoHX,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,aAAa;IACb,mBAAmB;CACX,CAAC"}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/operations/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,uBAAuB,EAAuB,MAAM,qBAAqB,CAAC;AAuBnF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,uBAAwD,CAAC;AA2H3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AA2T1C,6EAA6E;AAC7E,kDAAkD;AAClD,6EAA6E;AAE7E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO;IACP,UAAU;IACV,UAAU;IACV,YAAY;IACZ,UAAU;IACV,YAAY;CACJ,CAAC;AAoHX,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,aAAa;IACb,mBAAmB;CACX,CAAC"}

package/dist/operations/output-contract.d.ts

@@ -0,0 +1,127 @@
+/**
+ * OperationOutputContract — schema-first OUTPUT contract for CLEO operations.
+ *
+ * This module is the SINGLE SOURCE OF TRUTH for the per-operation OUTPUT
+ * (result) shape introspection surface (DHQ-057 · T11692 · EP-DHQ-CORE-FIXES
+ * T11679 · SG-CORE-SELF-TOOLING T11480). It is the OUTPUT-side mirror of
+ * {@link OperationInputContract}.
+ *
+ * ## Why this exists
+ *
+ * Before this contract, {@link OperationDef} declared INPUT (`params`) but had
+ * NO machine-readable description of the OUTPUT envelope's `data` payload.
+ * Consequently:
+ *
+ *   - `cleo show T123 --field /data/title` returned `E_FIELD_NOT_FOUND` because
+ *     the real shape is `/data/task/title` — agents had no way to predict the
+ *     envelope `data` shape and `--field` JSON pointers were guesswork.
+ *   - Every consumer (CLI `--field`, REST clients, the SDK) hand-sniffed the
+ *     result per verb instead of resolving against a declared contract.
+ *
+ * An {@link OperationOutputContract} pairs a stable operation identifier with
+ * the JSON Schema (draft-07) document describing the envelope's `data` payload
+ * AND the curated set of valid `--field` JSON pointers (rooted at `/data`) that
+ * an agent can use without trial and error.
+ *
+ * ZERO runtime dependencies: `contracts` is a leaf package. JSON Schema
+ * documents are modeled as the loose {@link JsonSchema} alias (re-used from the
+ * input-contract module) so this module does not pull in a JSON Schema typings
+ * package.
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/operations/output-contract
+ *
+ * @see {@link https://json-schema.org/draft-07/schema}
+ * @see OperationInputContract — the INPUT-side mirror of this contract
+ *
+ * @epic T11679
+ * @task T11692 — DHQ-057: per-operation output schema SSoT
+ */
+import type { JsonSchema } from './input-contract.js';
+/**
+ * Schema-first OUTPUT (result) contract for a single CLEO operation.
+ *
+ * Pairs a stable operation identifier with the JSON Schema draft-07 document
+ * that describes the LAFS envelope's `data` payload, plus the curated list of
+ * valid `--field` JSON pointers an agent can rely on.
+ *
+ * The `dataSchema` describes the shape of `envelope.data` — i.e. the value the
+ * dispatch handler returns, BEFORE the LAFS `{ success, data, meta }` wrapper
+ * is applied. For example, `tasks.show` returns
+ * `{ task, view, attachments, acRows?, relations? }`, so its `dataSchema` has
+ * `task` as a required property and `/data/task/title` is the canonical pointer
+ * for the task title — NOT `/data/title`.
+ *
+ * @example
+ * ```ts
+ * const showOutput: OperationOutputContract = {
+ *   operation: 'tasks.show',
+ *   dataSchema: {
+ *     type: 'object',
+ *     required: ['task'],
+ *     properties: {
+ *       task: { type: 'object', description: 'Full task record' },
+ *       view: { type: ['object', 'null'] },
+ *       attachments: { type: 'array' },
+ *     },
+ *   },
+ *   fieldPointers: ['/data/task/id', '/data/task/title', '/data/task/status'],
+ * };
+ * ```
+ */
+export interface OperationOutputContract {
+    /**
+     * Stable, fully-qualified operation identifier in `<domain>.<verb>` form
+     * (e.g. `'tasks.show'`, `'tasks.add-batch'`). Used as the registry key in
+     * {@link OperationOutputContractRegistry}.
+     */
+    operation: string;
+    /**
+     * JSON Schema draft-07 document describing the shape of the LAFS envelope's
+     * `data` payload returned by this operation.
+     *
+     * This is the shape of `envelope.data` — the dispatch handler's return value
+     * BEFORE the `{ success, data, meta }` wrapper. Pointers used by `--field`
+     * are therefore rooted at `/data` (e.g. `/data/task/title` resolves against
+     * `dataSchema.properties.task.properties.title`).
+     */
+    dataSchema: JsonSchema;
+    /**
+     * Curated, copy-pasteable list of valid `--field` JSON pointers an agent can
+     * use without trial and error. Each pointer is rooted at the envelope root
+     * (`/data/...`), matching the resolution semantics of `cleo <op> --field`.
+     *
+     * This is the direct remediation for the `--field /data/title` →
+     * `E_FIELD_NOT_FOUND` class of failures: instead of guessing, an agent runs
+     * `cleo show --describe` and reads the exact pointers that resolve.
+     *
+     * Conventionally lists the high-value scalar/leaf pointers (ids, titles,
+     * statuses, counts) — not every possible deep pointer.
+     */
+    fieldPointers: string[];
+    /**
+     * Optional one-line note clarifying non-obvious shape facts (e.g. "task body
+     * is nested under `task`, not the root"). Surfaced in `--describe` output to
+     * pre-empt the exact mistakes this contract is designed to prevent.
+     */
+    shapeNote?: string;
+}
+/**
+ * Registry of every {@link OperationOutputContract} known to the CLEO runtime,
+ * keyed by the contract's `operation` identifier (e.g. `'tasks.show'`).
+ *
+ * The OUTPUT-side mirror of `OperationInputContractRegistry`. Populated
+ * incrementally — high-traffic operations first. A `null` lookup (operation
+ * absent from the registry) is expected and MUST NOT error: callers render a
+ * structured "no output contract yet" payload instead.
+ *
+ * @example
+ * ```ts
+ * const registry: OperationOutputContractRegistry = {
+ *   'tasks.show': showOutputContract,
+ *   'tasks.list': listOutputContract,
+ * };
+ * ```
+ */
+export type OperationOutputContractRegistry = Record<string, OperationOutputContract>;
+//# sourceMappingURL=output-contract.d.ts.map

package/dist/operations/output-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-contract.d.ts","sourceRoot":"","sources":["../../src/operations/output-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;OAQG;IACH,UAAU,EAAE,UAAU,CAAC;IAEvB;;;;;;;;;;;OAWG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC"}

package/dist/operations/output-contract.js

@@ -0,0 +1,41 @@
+/**
+ * OperationOutputContract — schema-first OUTPUT contract for CLEO operations.
+ *
+ * This module is the SINGLE SOURCE OF TRUTH for the per-operation OUTPUT
+ * (result) shape introspection surface (DHQ-057 · T11692 · EP-DHQ-CORE-FIXES
+ * T11679 · SG-CORE-SELF-TOOLING T11480). It is the OUTPUT-side mirror of
+ * {@link OperationInputContract}.
+ *
+ * ## Why this exists
+ *
+ * Before this contract, {@link OperationDef} declared INPUT (`params`) but had
+ * NO machine-readable description of the OUTPUT envelope's `data` payload.
+ * Consequently:
+ *
+ *   - `cleo show T123 --field /data/title` returned `E_FIELD_NOT_FOUND` because
+ *     the real shape is `/data/task/title` — agents had no way to predict the
+ *     envelope `data` shape and `--field` JSON pointers were guesswork.
+ *   - Every consumer (CLI `--field`, REST clients, the SDK) hand-sniffed the
+ *     result per verb instead of resolving against a declared contract.
+ *
+ * An {@link OperationOutputContract} pairs a stable operation identifier with
+ * the JSON Schema (draft-07) document describing the envelope's `data` payload
+ * AND the curated set of valid `--field` JSON pointers (rooted at `/data`) that
+ * an agent can use without trial and error.
+ *
+ * ZERO runtime dependencies: `contracts` is a leaf package. JSON Schema
+ * documents are modeled as the loose {@link JsonSchema} alias (re-used from the
+ * input-contract module) so this module does not pull in a JSON Schema typings
+ * package.
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/operations/output-contract
+ *
+ * @see {@link https://json-schema.org/draft-07/schema}
+ * @see OperationInputContract — the INPUT-side mirror of this contract
+ *
+ * @epic T11679
+ * @task T11692 — DHQ-057: per-operation output schema SSoT
+ */
+export {};
+//# sourceMappingURL=output-contract.js.map

package/dist/operations/output-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-contract.js","sourceRoot":"","sources":["../../src/operations/output-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG"}

package/dist/operations/output-contracts-data.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OUTPUT_CONTRACTS data — the proof-set of per-operation OUTPUT contracts.
+ *
+ * SSoT for the OUTPUT (result) shape of CLEO's highest-traffic operations
+ * (DHQ-057 · T11692). Each entry is an {@link OperationOutputContract}: a
+ * JSON Schema draft-07 document for the LAFS envelope's `data` payload plus
+ * the curated list of valid `--field` JSON pointers.
+ *
+ * Populated INCREMENTALLY — high-traffic operations first. This is the OUTPUT
+ * mirror of `INPUT_CONTRACTS` (which lives in core). The data lives here in
+ * `contracts` (a leaf package, zero runtime deps) so every consumer — CLI
+ * `--describe`, the SDK `describeOperation`, REST clients — resolves against
+ * one source of truth.
+ *
+ * Each `dataSchema` is grounded in the concrete result interface declared in
+ * `./tasks.js` (e.g. {@link TasksShowResult}, {@link MinimalMutateEnvelope}) so
+ * the schema can never drift from the typed shape without a compile-time touch
+ * to this file.
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/operations/output-contracts-data
+ *
+ * @epic T11679
+ * @task T11692 — DHQ-057: per-operation output schema SSoT
+ */
+import type { OperationOutputContractRegistry } from './output-contract.js';
+/**
+ * SSoT registry of per-operation OUTPUT contracts, keyed by the canonical
+ * `<domain>.<verb>` operation id. Extend this map as operations are migrated
+ * to the schema-first OUTPUT surface (high-traffic first).
+ *
+ * @task T11692
+ */
+export declare const OUTPUT_CONTRACTS: OperationOutputContractRegistry;
+//# sourceMappingURL=output-contracts-data.d.ts.map

package/dist/operations/output-contracts-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-contracts-data.d.ts","sourceRoot":"","sources":["../../src/operations/output-contracts-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAEV,+BAA+B,EAChC,MAAM,sBAAsB,CAAC;AAuT9B;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,+BAQ9B,CAAC"}