Align CLI and MCP with v19 vocabulary

.github/workflows/ci.yml

@@ -124,6 +124,8 @@ jobs:
           node-version: '22'
           cache: 'npm'
       - run: npm ci
+      - name: 'Gate 5a: v19 capability contract drift'
+        run: npm run check:capabilities
       - name: 'Gate 5b: Install pinned Wesley generator'
         run: >-
           cargo install

README.md

@@ -137,9 +137,10 @@ under `diagnostics`. Support-plan and host machinery stay behind the runtime.
 - Missing support should produce an honest receipt status, not a silent
   whole-history materialization.
 
-Create a missing basis with `git warp checkpoint create`, or ask git-cas to
-reconcile retained materializations with
-`git warp doctor --repair-materialization-cache`.
+Prepare a missing bounded basis with
+`git warp repair --lane <name> --action materialization`. Inspect the local
+Runtime boundary with `git warp doctor --lane <name>`; physical cache repair
+remains owned by git-cas.
 
 <details>
 <summary><h4>For the Nerds™: Optics</h4></summary>

bin/cli/capabilities/V19CapabilityContract.generated.ts

@@ -0,0 +1,296 @@
+/* @generated from v19-capabilities.json. Do not edit by hand. */
+
+export const V19_CAPABILITY_CONTRACT = {
+  "version": "git-warp.capabilities/v19",
+  "cli": [
+    {
+      "command": "write",
+      "summary": "Write one Intent to a Lane.",
+      "usage": "git warp write --lane <name> [--strand <name>] --intent <json>"
+    },
+    {
+      "command": "observe",
+      "summary": "Run one bounded Observer over a Lane.",
+      "usage": "git warp observe --lane <name> [--strand <name>] --observer <id> --reading <json>"
+    },
+    {
+      "command": "fork",
+      "summary": "Fork a Lane into a named strand Lane.",
+      "usage": "git warp fork --lane <source> --name <strand>"
+    },
+    {
+      "command": "settle",
+      "summary": "Preview or apply an immutable Settlement plan.",
+      "usage": "git warp settle preview --source <lane> --strand <name> --target <lane> | settle apply --plan <path>"
+    },
+    {
+      "command": "receipt",
+      "summary": "Render a canonical Receipt envelope.",
+      "usage": "git warp receipt show --input <path|->"
+    },
+    {
+      "command": "doctor",
+      "summary": "Diagnose the local Runtime and Lane.",
+      "usage": "git warp doctor --lane <name>"
+    },
+    {
+      "command": "repair",
+      "summary": "Apply one explicit Runtime repair.",
+      "usage": "git warp repair --lane <name> --action materialization"
+    },
+    {
+      "command": "audit",
+      "summary": "Verify the local Runtime audit trail.",
+      "usage": "git warp audit --lane <name> [--writer <id>]"
+    },
+    {
+      "command": "mcp",
+      "summary": "Serve the v19 capabilities over MCP stdio.",
+      "usage": "git warp mcp --repo <path> --writer <id>"
+    }
+  ],
+  "mcp": [
+    {
+      "name": "warp_lane_describe",
+      "description": "Describe one Runtime Lane.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "lane": {
+            "type": "string",
+            "minLength": 1
+          },
+          "strand": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "lane"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_intent_write",
+      "description": "Write one validated Intent to a Lane and return its canonical Receipt.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "lane": {
+            "type": "string",
+            "minLength": 1
+          },
+          "strand": {
+            "type": "string",
+            "minLength": 1
+          },
+          "intent": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "lane",
+          "intent"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_observation_start",
+      "description": "Start one bounded Observation and retain its Readings for transport.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "lane": {
+            "type": "string",
+            "minLength": 1
+          },
+          "strand": {
+            "type": "string",
+            "minLength": 1
+          },
+          "observerId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "reading": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "lane",
+          "observerId",
+          "reading"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_observation_read",
+      "description": "Read the next bounded transport batch from an Observation.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "observationId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "cursor": {
+            "type": "string",
+            "minLength": 1
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 256
+          }
+        },
+        "required": [
+          "observationId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_observation_cancel",
+      "description": "Cancel and discard one retained Observation transport.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "observationId": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "observationId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_receipt_get",
+      "description": "Return one canonical Receipt retained by this MCP server.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "receiptRef": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "receiptRef"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_settlement_preview",
+      "description": "Preview an immutable Settlement plan between two Lanes.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "sourceLane": {
+            "type": "string",
+            "minLength": 1
+          },
+          "sourceStrand": {
+            "type": "string",
+            "minLength": 1
+          },
+          "targetLane": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "sourceLane",
+          "sourceStrand",
+          "targetLane"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_settlement_apply",
+      "description": "Revalidate and apply one retained immutable Settlement plan.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "planRef": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "planRef"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_doctor",
+      "description": "Diagnose one local Runtime Lane.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "lane": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "lane"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_repair",
+      "description": "Apply one explicit local Runtime repair.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "lane": {
+            "type": "string",
+            "minLength": 1
+          },
+          "action": {
+            "type": "string",
+            "enum": [
+              "materialization"
+            ]
+          }
+        },
+        "required": [
+          "lane",
+          "action"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "warp_audit",
+      "description": "Verify the local Runtime audit trail.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "lane": {
+            "type": "string",
+            "minLength": 1
+          },
+          "writer": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "lane"
+        ],
+        "additionalProperties": false
+      }
+    }
+  ]
+} as const;