@cleocode/adapters 2026.8.8 → 2026.9.1

package/dist/index.js

@@ -1969,7 +1969,7 @@ var init_output_contracts_data = __esm({
     init_service();
     tasksShowOutputContract = {
       operation: "tasks.show",
-      shapeNote: "The task record is nested under `task` \u2014 use /data/task/<field>, not /data/<field>. `view` may be null. `acRows` and `relations` are conditional. The listed pointers are the default (MVI) projection \u2014 `verification`, `acceptance`, `description`, and `evidence` live only in the full record (`cleo show <id> --full`); `--field` resolves them transparently when they exist (T12108).",
+      shapeNote: "The task record is nested under `task` \u2014 use /data/task/<field>, not /data/<field>. Mutation envelopes are FLAT by contrast (/data/created/0, /data/updated/0), which is the asymmetry that produced GH #1225/#1239/#1231. `view` may be null. `acRows` and `relations` are conditional. `description`, `acceptance` and `verification` are withheld by the default (MVI) projection but `--field` resolves them transparently (T12108) \u2014 no `--full` needed. Evidence is NOT a task field: it lives at /data/task/verification/evidence (keyed by gate), alongside /data/task/verification/gates. T12127 (GH #1231) \u2014 the previous wording advertised `/data/task/evidence`, which does not exist, in the very text shown to an agent whose pointer had just failed.",
       dataSchema: {
         type: "object",
         required: ["task", "view", "attachments"],
@@ -2013,6 +2013,16 @@ var init_output_contracts_data = __esm({
         "/data/task/priority",
         "/data/task/type",
         "/data/task/parentId",
+        // T12127 (GH #1231) — withheld by the MVI projection but resolvable
+        // through `--field` since T12108. They were absent from this list, so the
+        // remediation an agent is shown on a failed pointer never mentioned the
+        // fields it most often wanted, and `cleo show --field /data/task` came
+        // back looking like a write that had silently done nothing.
+        "/data/task/description",
+        "/data/task/acceptance",
+        "/data/task/verification",
+        "/data/task/verification/gates",
+        "/data/task/verification/evidence",
         "/data/view/id",
         "/data/view/title"
       ]
@@ -2683,19 +2693,31 @@ var init_operations_registry = __esm({
           { name: "status", type: "string", required: false, description: "Filter by task status" },
           { name: "priority", type: "string", required: false, description: "Filter by task priority" },
           { name: "type", type: "string", required: false, description: "Filter by task type" },
+          {
+            name: "severity",
+            type: "string",
+            required: false,
+            description: "Filter by severity axis (P0|P1|P2|P3); invalid values are rejected"
+          },
+          {
+            name: "kind",
+            type: "string",
+            required: false,
+            description: "Filter by kind axis (work|research|experiment|bug|spike|release); invalid values are rejected"
+          },
           { name: "phase", type: "string", required: false, description: "Filter by task phase" },
           { name: "label", type: "string", required: false, description: "Filter by task label" },
           {
             name: "children",
             type: "boolean",
             required: false,
-            description: "Limit parent queries to direct children"
+            description: "DEPRECATED (no effect; slated for removal in a future major): --parent already returns DIRECT children only, for every parent type including sagas. Do not use."
           },
           {
             name: "limit",
             type: "number",
             required: false,
-            description: "Maximum number of tasks to return"
+            description: "Maximum number of tasks to return (default 10). Use --all to return every match. (--limit 0 also returns every match, but only on this command \u2014 prefer --all.)"
           },
           {
             name: "offset",
@@ -16032,6 +16054,13 @@ var init_collection_keys = __esm({
   }
 });
 
+// packages/contracts/src/task-id.ts
+var init_task_id = __esm({
+  "packages/contracts/src/task-id.ts"() {
+    "use strict";
+  }
+});
+
 // packages/contracts/src/index.ts
 var init_src = __esm({
   "packages/contracts/src/index.ts"() {
@@ -16101,6 +16130,7 @@ var init_src = __esm({
     init_workgraph();
     init_caamp_markers();
     init_collection_keys();
+    init_task_id();
   }
 });