@cleocode/contracts 2026.10.9 → 2026.10.10-canary.2

package/src/dispatch/operations-registry.ts

@@ -8600,6 +8600,41 @@ export const OPERATIONS: OperationDef[] = [
       },
     ],
   },
+  // ── docs.triage (T13446 — Epic T13340 / Saga T13339) ──────────────────────
+  {
+    gateway: 'query',
+    domain: 'docs',
+    operation: 'triage',
+    description:
+      'docs.triage (query) — batch-triage docs through the docs.triage decision site: ' +
+      'proposed keep/update/supersede/archive verdicts plus staleness scores, oldest first ' +
+      '(default: drafts). Proposals only — never mutates a doc; --record persists each ' +
+      'verdict as a proposed D#### decision.',
+    tier: 1,
+    idempotent: true,
+    sessionRequired: false,
+    requiredParams: [],
+    params: [
+      {
+        name: 'limit',
+        type: 'number' as const,
+        required: false,
+        description: 'Maximum docs to scan, oldest first (default 25)',
+      },
+      {
+        name: 'status',
+        type: 'string' as const,
+        required: false,
+        description: 'Lifecycle status to scan (default draft)',
+      },
+      {
+        name: 'record',
+        type: 'boolean' as const,
+        required: false,
+        description: 'Persist every verdict as a proposed D#### decision (default false)',
+      },
+    ],
+  },
   {
     gateway: 'mutate',
     domain: 'docs',

package/src/invariants/sync-write-invariants.ts

@@ -485,6 +485,40 @@ export const SYNC_WRITE_INVARIANTS: readonly SyncWriteInvariant[] = Object.freez
     ['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).
+  rule(
+    'docs.versions.append-only',
+    'T13355',
+    'conduit_attachment_versions',
+    ['*'],
+    [],
+    'version rows are append-only and unique by uid; inserts never conflict, so no merge rule fires',
+  ),
+  rule(
+    'docs.approvals.append-only',
+    'T13355',
+    'conduit_attachment_approvals',
+    ['*'],
+    [],
+    'approval rows are append-only; a revoke is a tombstone row, never an UPDATE/DELETE',
+  ),
+  rule(
+    'docs.doc-alias.append-only',
+    'T13355',
+    'conduit_doc_slug_aliases',
+    ['*'],
+    [],
+    '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',
+  ),
 
   // §3.6.0 identity-layer rows.
   {

package/src/operations/worktree.ts

@@ -1034,4 +1034,10 @@ export interface AdoptWorktreeResult {
   isNew: boolean;
   /** ISO-8601 timestamp when the sentinel entry was written. */
   adoptedAt: string;
+  /**
+   * The worktree's `.cleo/project-info.json` (T13568): `seeded` from the
+   * adopting project, already `present` with a matching projectId, or
+   * `skipped` when the adopting project has none to copy.
+   */
+  projectInfo: 'seeded' | 'present' | 'skipped';
 }