@cleocode/core 2026.9.3 → 2026.9.5

package/dist/release/version.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Canonical release-version normalisation (gh#1440).
+ *
+ * ## Why this is a shared module
+ *
+ * Release versions are accepted from operators in both spellings — `2026.9.4`
+ * and `v2026.9.4` — and the pipeline stores, tags and names files with the
+ * `v`-prefixed form. Every verb therefore has to normalise, and before this
+ * module two verbs did it from private copies while a third did not do it at
+ * all:
+ *
+ * | verb | behaviour before |
+ * |---|---|
+ * | `release plan` | private copy in `plan.ts` — normalised |
+ * | manifest reads | private copy in `release-manifest.ts` — normalised |
+ * | `release reconcile` | **took the argument verbatim** |
+ *
+ * The consequence, measured cutting v2026.9.4: `cleo release plan 2026.9.4`
+ * wrote `.cleo/release/v2026.9.4.plan.json` and reported success, then
+ * `cleo release reconcile 2026.9.4` — the same string — failed with
+ * `E_PLAN_NOT_FOUND` looking for `2026.9.4.plan.json`, and its `fix` told the
+ * operator to run `cleo release plan 2026.9.4`: the command that had just
+ * succeeded and produced the file it could not see. Following the fix loops
+ * forever, and the documented runbook in AGENTS.md uses the bare form for both
+ * verbs, so the runbook as written could not work.
+ *
+ * Two copies of a rule is how the third callsite comes to not have it. One
+ * function, one place — the same conclusion `collection-keys.ts` reached after
+ * three outages of its own.
+ *
+ * @task gh#1440
+ */
+/**
+ * Normalise a release version to its canonical `v`-prefixed form.
+ *
+ * Idempotent: an already-prefixed version is returned unchanged.
+ *
+ * @param version - Version as supplied by an operator (`2026.9.4` or `v2026.9.4`).
+ * @returns The `v`-prefixed form (`v2026.9.4`).
+ *
+ * @example
+ * ```ts
+ * normalizeVersion('2026.9.4');  // 'v2026.9.4'
+ * normalizeVersion('v2026.9.4'); // 'v2026.9.4'
+ * ```
+ */
+export declare function normalizeVersion(version: string): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/release/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/release/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/release/version.js

@@ -0,0 +1,50 @@
+/**
+ * Canonical release-version normalisation (gh#1440).
+ *
+ * ## Why this is a shared module
+ *
+ * Release versions are accepted from operators in both spellings — `2026.9.4`
+ * and `v2026.9.4` — and the pipeline stores, tags and names files with the
+ * `v`-prefixed form. Every verb therefore has to normalise, and before this
+ * module two verbs did it from private copies while a third did not do it at
+ * all:
+ *
+ * | verb | behaviour before |
+ * |---|---|
+ * | `release plan` | private copy in `plan.ts` — normalised |
+ * | manifest reads | private copy in `release-manifest.ts` — normalised |
+ * | `release reconcile` | **took the argument verbatim** |
+ *
+ * The consequence, measured cutting v2026.9.4: `cleo release plan 2026.9.4`
+ * wrote `.cleo/release/v2026.9.4.plan.json` and reported success, then
+ * `cleo release reconcile 2026.9.4` — the same string — failed with
+ * `E_PLAN_NOT_FOUND` looking for `2026.9.4.plan.json`, and its `fix` told the
+ * operator to run `cleo release plan 2026.9.4`: the command that had just
+ * succeeded and produced the file it could not see. Following the fix loops
+ * forever, and the documented runbook in AGENTS.md uses the bare form for both
+ * verbs, so the runbook as written could not work.
+ *
+ * Two copies of a rule is how the third callsite comes to not have it. One
+ * function, one place — the same conclusion `collection-keys.ts` reached after
+ * three outages of its own.
+ *
+ * @task gh#1440
+ */
+/**
+ * Normalise a release version to its canonical `v`-prefixed form.
+ *
+ * Idempotent: an already-prefixed version is returned unchanged.
+ *
+ * @param version - Version as supplied by an operator (`2026.9.4` or `v2026.9.4`).
+ * @returns The `v`-prefixed form (`v2026.9.4`).
+ *
+ * @example
+ * ```ts
+ * normalizeVersion('2026.9.4');  // 'v2026.9.4'
+ * normalizeVersion('v2026.9.4'); // 'v2026.9.4'
+ * ```
+ */
+export function normalizeVersion(version) {
+    return version.startsWith('v') ? version : `v${version}`;
+}
+//# sourceMappingURL=version.js.map

package/dist/release/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/release/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;AAC3D,CAAC"}

package/dist/selfimprove/fix-gen.js

@@ -1183,6 +1183,83 @@ var init_docs = __esm({
   }
 });
 
+// packages/contracts/src/operations/check.ts
+var VERIFICATION_SCHEMA, GATE_RESULT_SCHEMA, GATE_FIELD_POINTERS, checkGateSetOutputContract, checkGateStatusOutputContract;
+var init_check = __esm({
+  "packages/contracts/src/operations/check.ts"() {
+    "use strict";
+    VERIFICATION_SCHEMA = {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        passed: { type: "boolean", description: "True when every required gate is set." },
+        round: { type: "number", description: "IVTR round counter." },
+        gates: {
+          type: "object",
+          additionalProperties: { type: "boolean" },
+          description: "Gate name \u2192 whether it is recorded as passed."
+        },
+        evidence: {
+          type: "object",
+          additionalProperties: true,
+          description: "Gate name \u2192 the evidence atom kinds validated for it."
+        }
+      }
+    };
+    GATE_RESULT_SCHEMA = {
+      type: "object",
+      required: ["taskId", "verification", "verificationStatus", "passed"],
+      additionalProperties: true,
+      properties: {
+        taskId: { type: "string", description: "The task the gates belong to." },
+        title: { type: "string", description: "Task title, for operator display." },
+        status: { type: "string", description: "Task lifecycle status." },
+        type: { type: "string", description: "Task type (epic | task | subtask)." },
+        verification: VERIFICATION_SCHEMA,
+        verificationStatus: {
+          type: "string",
+          enum: ["passed", "pending"],
+          description: "Whether every required gate is now recorded."
+        },
+        passed: { type: "boolean", description: "Mirror of verification.passed." },
+        round: { type: "number", description: "IVTR round counter." },
+        requiredGates: {
+          type: "array",
+          items: { type: "string" },
+          description: "Gates this project requires before complete."
+        },
+        missingGates: {
+          type: "array",
+          items: { type: "string" },
+          description: "Required gates not yet recorded \u2014 empty means ready to complete."
+        }
+      }
+    };
+    GATE_FIELD_POINTERS = [
+      "/data/taskId",
+      "/data/verification",
+      "/data/verification/passed",
+      "/data/verification/gates",
+      "/data/verificationStatus",
+      "/data/passed",
+      "/data/missingGates",
+      "/data/requiredGates"
+    ];
+    checkGateSetOutputContract = {
+      operation: "check.gate.set",
+      shapeNote: "FLAT record, not the nested read shape. The verification object is at /data/verification \u2014 NEVER /data/task/verification, which is how `cleo show` nests a task and does not exist here. The response is self-confirming: it returns the full verification after the write, so there is no need to re-read.",
+      dataSchema: { ...GATE_RESULT_SCHEMA },
+      fieldPointers: [...GATE_FIELD_POINTERS]
+    };
+    checkGateStatusOutputContract = {
+      operation: "check.gate.status",
+      shapeNote: "FLAT record identical in shape to check.gate.set. Read-only: reports which gates are recorded and which are still missing. /data/missingGates being empty is the precondition for `cleo complete`.",
+      dataSchema: { ...GATE_RESULT_SCHEMA },
+      fieldPointers: [...GATE_FIELD_POINTERS]
+    };
+  }
+});
+
 // packages/contracts/src/operations/entities.ts
 var ACCOUNT_VIEW_SCHEMA, accountAddOutputContract, accountListOutputContract, accountRemoveOutputContract, PROVIDER_VIEW_SCHEMA, providerListOutputContract, providerShowOutputContract, providerConnectOutputContract, MODEL_VIEW_SCHEMA, modelQueryOutputContract, modelShowOutputContract, profileCreateOutputContract, profileListOutputContract, profilePinOutputContract, profileUseOutputContract;
 var init_entities = __esm({
@@ -1630,6 +1707,7 @@ var tasksShowOutputContract, tasksListOutputContract, tasksFindOutputContract, T
 var init_output_contracts_data = __esm({
   "packages/contracts/src/operations/output-contracts-data.ts"() {
     "use strict";
+    init_check();
     init_entities();
     init_service();
     tasksShowOutputContract = {
@@ -1981,6 +2059,11 @@ var init_output_contracts_data = __esm({
       fieldPointers: ["/data/key", "/data/scope", "/data/removed"]
     };
     OUTPUT_CONTRACTS = {
+      // gate verification (T12192 · gh#1420 · gh#1423) — `cleo verify`, the op
+      // every agent is told to run before every `cleo complete`, previously fell
+      // through to the generic contract with an EMPTY pointer list.
+      "check.gate.set": checkGateSetOutputContract,
+      "check.gate.status": checkGateStatusOutputContract,
       "tasks.show": tasksShowOutputContract,
       "tasks.list": tasksListOutputContract,
       "tasks.find": tasksFindOutputContract,
@@ -13818,6 +13901,7 @@ var init_operations = __esm({
     init_agent_operation_contract();
     init_attention();
     init_brain();
+    init_check();
     init_conduit();
     init_dialectic();
     init_docs();