@cleocode/adapters 2026.10.12 → 2026.10.13

package/dist/index.js

@@ -7646,6 +7646,34 @@ var init_operations_registry = __esm({
           }
         ]
       },
+      {
+        gateway: "mutate",
+        domain: "pipeline",
+        operation: "manifest.update",
+        description: "pipeline.manifest.update (mutate) \u2014 change only the given fields of a manifest entry; linkTask adds a linked task (T13678)",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["id"],
+        params: [
+          { name: "id", type: "string", required: true, description: "Manifest entry id" },
+          {
+            name: "linkTask",
+            type: "string",
+            required: false,
+            description: "Task id to add to linked_tasks"
+          },
+          { name: "title", type: "string", required: false, description: "New title" },
+          { name: "topics", type: "array", required: false, description: "Replacement topics" },
+          {
+            name: "key_findings",
+            type: "array",
+            required: false,
+            description: "Replacement key findings"
+          },
+          { name: "status", type: "string", required: false, description: "New status" }
+        ]
+      },
       {
         gateway: "mutate",
         domain: "pipeline",
@@ -11172,11 +11200,23 @@ var init_operations_registry = __esm({
           }
         ]
       },
+      // ── docs.stats (T13363 — Epic T13340 / Saga T13339) ───────────────────────
+      {
+        gateway: "query",
+        domain: "docs",
+        operation: "stats",
+        description: "docs.stats (query) \u2014 per-project CleoDocs adoption metrics (read-only): add:update ratio from the docs audit log, loose-markdown count with scanned/excluded dirs, docs_wikilinks edge count, and live decision_adr_links count. Emitted for the Council pilot baseline comparisons.",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: []
+      },
       {
         gateway: "mutate",
         domain: "docs",
         operation: "doctor",
-        description: "docs.doctor (mutate) \u2014 apply the docs doctor repairs: set docVersion from the audit log, backfill topics/related_tasks from content, archive dangling local-file rows, rebuild docs_wikilinks. The dispatch layer creates a fresh backup (cleo backup add path) and requires its receipt before any write.",
+        description: "docs.doctor (mutate) \u2014 apply the docs doctor repairs: set docVersion from the audit log, backfill topics/related_tasks from content, archive dangling local-file rows, rebuild docs_wikilinks, and backfill hash-verified legacy bytes into the blob store. The dispatch layer creates a fresh backup (cleo backup add path) and requires its receipt before any write. repair:true restricts the run to the legacy-blob-coverage backfill only (T13653).",
         tier: 1,
         idempotent: false,
         sessionRequired: false,
@@ -11188,6 +11228,12 @@ var init_operations_registry = __esm({
             required: false,
             description: "Execute repairs (default false \u2014 dry-run plan only)"
           },
+          {
+            name: "repair",
+            type: "boolean",
+            required: false,
+            description: "Execute ONLY the legacy-blob-coverage backfill: mirror hash-verified legacy bytes into the blob store so unmigrated docs become readable (T13653)"
+          },
           {
             name: "olderThanDays",
             type: "number",
@@ -11196,6 +11242,18 @@ var init_operations_registry = __esm({
           }
         ]
       },
+      // ── docs.migrate (T13360 — Epic T13340 / Saga T13339) ─────────────────────
+      {
+        gateway: "mutate",
+        domain: "docs",
+        operation: "migrate",
+        description: "docs.migrate (mutate) \u2014 the T13360 legacy docs migration (spec \xA75): import legacy docs + history into the re-keyed conduit store inside the T13448 safety harness (pre-step VACUUM INTO backup, before/after fingerprints, COMMIT only on full verification). Imported rows are labeled origin:migrated; dangling-pointer docs are content-captured or recorded dangling in conduit_doc_migration_ledger. Idempotent \u2014 a re-run is a verified no-op.",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: []
+      },
       // ── docs.generate (T798) ─────────────────────────────────────────────────
       {
         gateway: "query",
@@ -11297,6 +11355,13 @@ var init_operations_registry = __esm({
             required: false,
             description: "Inline UTF-8 content (mutually exclusive with file)"
           },
+          {
+            name: "baseVersionUid",
+            type: "string",
+            required: false,
+            description: "Expected base version uid \u2014 the metadata.headVersionUid from the `cleo docs fetch <slug>` envelope the edit was authored against (T13674). When the stored head has moved past it: append-shaped section edits are three-way merged through the section CRDT (both writers survive); a non-mergeable section edit is recorded as a named section conflict \u2014 nothing is silently dropped. A base that does not resolve to this doc's version history is refused with E_DOC_BASE_UNKNOWN before any write. Works with --content and with a UTF-8 text --file; a non-text --file with a base is refused with E_DOC_BASE_UNSUPPORTED. The update result carries the new headVersionUid, so edits can chain without a re-fetch. Omit only when the edit was not based on an earlier fetch (the current head is then assumed).",
+            cli: { flag: "base-version-uid" }
+          },
           {
             name: "message",
             type: "string",
@@ -14709,21 +14774,25 @@ var init_sync_write_invariants = __esm({
           ["tasks_audit_log", "audit_log"]
         )
       ),
-      rule(
-        "sticky.status.one-way",
-        "T12942",
-        "brain_sticky_notes",
-        ["status", "converted_to_json"],
-        ["SK2", "SK3", "B24"],
-        "active\u2192{converted, archived} is one-way; converted_to_json is write-once"
+      implemented(
+        rule(
+          "sticky.status.one-way",
+          "T12942",
+          "brain_sticky_notes",
+          ["status", "converted_to_json"],
+          ["SK2", "SK3", "B24"],
+          "active\u2192{converted, archived} is one-way; converted_to_json is write-once"
+        )
       ),
-      rule(
-        "release.status.absorbing",
-        "T12943",
-        "tasks_releases",
-        ["status"],
-        ["REL-2", "REL-3", "REL-4", "REL-5", "REL-6", "REL-7", "REL-8"],
-        "shipped release statuses are absorbing"
+      implemented(
+        rule(
+          "release.status.absorbing",
+          "T12943",
+          "tasks_releases",
+          ["status"],
+          ["REL-2", "REL-3", "REL-4", "REL-5", "REL-6", "REL-7", "REL-8"],
+          "shipped release statuses are absorbing"
+        )
       ),
       implemented(
         rule(
@@ -14736,13 +14805,15 @@ var init_sync_write_invariants = __esm({
           ["tasks_playbook_approvals", "playbook_approvals"]
         )
       ),
-      rule(
-        "docs.lifecycle.transitions",
-        "T12945",
-        "docs_attachments",
-        ["lifecycle_status"],
-        ["D04", "D05", "D31", "D32", "D39", "D50"],
-        "superseded is sticky; lifecycle transitions follow a matrix"
+      implemented(
+        rule(
+          "docs.lifecycle.transitions",
+          "T12945",
+          "docs_attachments",
+          ["lifecycle_status"],
+          ["D04", "D05", "D31", "D32", "D39", "D50"],
+          "superseded is sticky; lifecycle transitions follow a matrix"
+        )
       ),
       // T13354 (D11165) — CleoDocs re-keyed history family; the typed merge rules
       // land with the write path (T13355).
@@ -14770,14 +14841,33 @@ var init_sync_write_invariants = __esm({
         [],
         "alias rows carry natural identity over (slug, doc_uid); identical aliases merge to one row"
       ),
-      rule(
-        "docs.head.max-hlc",
-        "T13355",
-        "conduit_doc_heads",
-        ["*"],
-        [],
-        "the projection keeps the max-HLC head; a losing concurrent head is recorded (conflict_count/last_conflict_json), never silently shadowed"
-      ),
+      // T13355 (D11165): the write-path behavior is implemented at the writer
+      // chokepoint (`upsertConduitDocHead`, now reachable from the docs update
+      // write path); cross-device convergence rides the Stage C journal merge
+      // engine (T12344) and needs no second rule.
+      {
+        id: "docs.head.max-hlc",
+        class: "monotonic-merge-rule",
+        tables: ["conduit_doc_heads"],
+        sites: [],
+        mergeRule: { table: "conduit_doc_heads", columns: ["*"] },
+        inventory: [],
+        runtimeGate: {
+          module: "packages/core/src/store/conduit-doc-history.ts",
+          functionName: "upsertConduitDocHead"
+        },
+        reason: "the projection keeps the max-HLC head; a losing concurrent head is recorded (conflict_count/last_conflict_json), never silently shadowed"
+      },
+      // T13355 — the docs write path adopts a legacy doc into the conduit family
+      // once (identity shell keyed by the immutable uid); the read-back guard is
+      // a local write-confirmation, not a merge rule.
+      {
+        id: "docs.doc.adopt-once",
+        class: "not-sync-relevant",
+        tables: ["conduit_attachments"],
+        sites: [],
+        reason: "adopting a legacy doc inserts one immutable-uid identity shell; losing the write is refused loudly at the writer, not merged"
+      },
       // T13359 (D11165) — decisions-vs-ADRs link table; the natural composite key
       // makes identical links merge to one row, and the revoke is a one-way latch.
       // T13597: enforced at merge, not just by the local accessor — 'revoked' is an