V46 Gate 5: Bind interface claim contracts

Add the package-backed V46InterfaceClaimContracts canonical artifact for public API, MCP API, ChatGPT App, Bitcode Chat, and package-consumer source-safe InterfaceClaim contracts.

Update V46 spec, delta, notes, parity matrix, roadmap, README, protocol package exports, package scripts, workflows, deterministic generator, focused checker, and protocol tests.

Regenerate dependent V46 artifacts and make Gate 3/Gate 4 roadmap predicates durable against later gates by checking closure anchors instead of moving latest/current status.

Validation: pnpm run check:v46-gate1 --skip-branch-check; pnpm run check:v46-gate2 --skip-branch-check; pnpm run check:v46-gate3 --skip-branch-check; pnpm run check:v46-gate4 --skip-branch-check; pnpm run check:v46-gate5; pnpm --filter @bitcode/protocol typecheck; pnpm --filter @bitcode/protocol test; focused BTD, MCP, ChatGPT App, and UAPI conversation suites; git diff --check.

Author: geraldarthurdavis

.bitcode/v46-interface-claim-contracts.json

@@ -1,27 +1,27 @@
 {
   "artifactId": "v46-product-route-comprehension-readback",
   "artifactPath": ".bitcode/v46-product-route-comprehension-readback.json",
-  "artifactRoot": "v46-product-route-comprehension-readback:5bc3193c537a60994221614c",
+  "artifactRoot": "v46-product-route-comprehension-readback:f1a5d0211f739510cb8d2154",
   "schemaId": "bitcode.v46.productRouteComprehensionReadback.v1",
   "version": "V46",
   "currentTarget": "V45",
   "sourceSafetyVerdict": "source-safe-product-route-comprehension-readback",
   "sourceRoots": {
     "activePointer": "BITCODE_SPEC.txt:674f33696f4048b636f67e13",
-    "spec": "BITCODE_SPEC_V46.md:4cc45d3f347055f6e1c41dfb",
-    "delta": "BITCODE_SPEC_V46_DELTA.md:d3a9827a2ab22d7586c9068a",
-    "notes": "BITCODE_SPEC_V46_NOTES.md:ec27a9894f9b42082fce5ceb",
-    "parity": "BITCODE_SPEC_V46_PARITY_MATRIX.md:fa329d3d950173391cc942b5",
-    "roadmap": "SPECIFICATIONS_ROADMAP.md:5c6e23123d158007377d52ec",
-    "packageJson": "package.json:a45f631d26b4b87124be7849",
-    "packageIndex": "packages/protocol/src/index.js:60ed0a4f219845b39e07e4bb",
-    "packageTypes": "packages/protocol/src/index.d.ts:1dddeb9bb40d80b131a30ce5",
-    "packageSource": "packages/protocol/src/canonical/v46-product-route-comprehension-readback.js:373f5861ee772d21f052de38",
+    "spec": "BITCODE_SPEC_V46.md:3b619dd4971f05e9f26d2d52",
+    "delta": "BITCODE_SPEC_V46_DELTA.md:ae7a032374ef3a15afc165b1",
+    "notes": "BITCODE_SPEC_V46_NOTES.md:553cd172a2197af62d359f90",
+    "parity": "BITCODE_SPEC_V46_PARITY_MATRIX.md:f136e996c7f10fec0294d763",
+    "roadmap": "SPECIFICATIONS_ROADMAP.md:1deef7aebb8b8ffaa629800b",
+    "packageJson": "package.json:c34b3c2fad27dcdda5681997",
+    "packageIndex": "packages/protocol/src/index.js:7d253665b2eb8abc2c84ef31",
+    "packageTypes": "packages/protocol/src/index.d.ts:91eb37870471a544f284be49",
+    "packageSource": "packages/protocol/src/canonical/v46-product-route-comprehension-readback.js:c7b3e44d22703ca4b8f17ac3",
     "packageTest": "packages/protocol/test/v46-product-route-comprehension-readback.test.js:3118d40ad600a9fb1d025bf6",
     "generator": "scripts/generate-v46-product-route-comprehension-readback.mjs:131473a8dcd0d665f74f56a7",
     "checker": "scripts/check-v46-gate4-product-route-comprehension-readback.mjs:483822ed6cd2809c20ee8fe5",
-    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:5ce1c8681bb2ef5d0ac25066",
-    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:0b6dfb96c5cbee7d42652666",
+    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:5146b7aad831ade15738e8e8",
+    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:c0dcd99e25b780873e412123",
     "productRouteShell": "uapi/components/base/bitcode/routes/product-route-shell.tsx:e71f90c289dec52fd158568a",
     "packsClient": "uapi/app/packs/PacksPageClient.tsx:68c61c8fd312e6c750d742ba",
     "packsModel": "uapi/components/base/bitcode/activity/pack-activity-model.ts:88d0334af8bc699e071ca2a1",
@@ -484,7 +484,7 @@
         "passed": true
       },
       {
-        "id": "roadmap-records-current-gate4",
+        "id": "roadmap-records-gate4-closure",
         "sourcePath": "SPECIFICATIONS_ROADMAP.md",
         "passed": true
       },

.bitcode/v46-product-route-comprehension-readback.json

@@ -8,18 +8,18 @@
   "sourceSafetyVerdict": "source-safe-protocol-comprehension-metadata",
   "sourceRoots": {
     "activePointer": "BITCODE_SPEC.txt:674f33696f4048b636f67e13",
-    "spec": "BITCODE_SPEC_V46.md:4cc45d3f347055f6e1c41dfb",
-    "delta": "BITCODE_SPEC_V46_DELTA.md:d3a9827a2ab22d7586c9068a",
-    "notes": "BITCODE_SPEC_V46_NOTES.md:ec27a9894f9b42082fce5ceb",
-    "parity": "BITCODE_SPEC_V46_PARITY_MATRIX.md:fa329d3d950173391cc942b5",
-    "roadmap": "SPECIFICATIONS_ROADMAP.md:5c6e23123d158007377d52ec",
-    "readme": "README.md:316f79e40a6922fa0bf29961",
-    "protocolReadme": "packages/protocol/README.md:3a3d3a1340fb98b87f722375",
-    "packageJson": "package.json:a45f631d26b4b87124be7849",
-    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:5ce1c8681bb2ef5d0ac25066",
-    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:0b6dfb96c5cbee7d42652666",
-    "packageIndex": "packages/protocol/src/index.js:60ed0a4f219845b39e07e4bb",
-    "packageTypes": "packages/protocol/src/index.d.ts:1dddeb9bb40d80b131a30ce5",
+    "spec": "BITCODE_SPEC_V46.md:3b619dd4971f05e9f26d2d52",
+    "delta": "BITCODE_SPEC_V46_DELTA.md:ae7a032374ef3a15afc165b1",
+    "notes": "BITCODE_SPEC_V46_NOTES.md:553cd172a2197af62d359f90",
+    "parity": "BITCODE_SPEC_V46_PARITY_MATRIX.md:f136e996c7f10fec0294d763",
+    "roadmap": "SPECIFICATIONS_ROADMAP.md:1deef7aebb8b8ffaa629800b",
+    "readme": "README.md:72b51bb4c1dd930185f6f4d6",
+    "protocolReadme": "packages/protocol/README.md:72af480ca278f8f038ee27af",
+    "packageJson": "package.json:c34b3c2fad27dcdda5681997",
+    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:5146b7aad831ade15738e8e8",
+    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:c0dcd99e25b780873e412123",
+    "packageIndex": "packages/protocol/src/index.js:7d253665b2eb8abc2c84ef31",
+    "packageTypes": "packages/protocol/src/index.d.ts:91eb37870471a544f284be49",
     "packageSource": "packages/protocol/src/canonical/v46-protocol-comprehension-object-model.js:a55974c399c15656961c7370",
     "packageTest": "packages/protocol/test/v46-protocol-comprehension-object-model.test.js:b3dd4b276e9c00b76becb15e",
     "generator": "scripts/generate-v46-protocol-comprehension-object-model.mjs:814f07e809e47d359485ba46",

.bitcode/v46-protocol-comprehension-object-model.json

@@ -8,22 +8,22 @@
   "sourceSafetyVerdict": "source-safe-public-operator-claim-boundary-metadata",
   "sourceRoots": {
     "activePointer": "BITCODE_SPEC.txt:674f33696f4048b636f67e13",
-    "spec": "BITCODE_SPEC_V46.md:4cc45d3f347055f6e1c41dfb",
-    "delta": "BITCODE_SPEC_V46_DELTA.md:d3a9827a2ab22d7586c9068a",
-    "notes": "BITCODE_SPEC_V46_NOTES.md:ec27a9894f9b42082fce5ceb",
-    "parity": "BITCODE_SPEC_V46_PARITY_MATRIX.md:fa329d3d950173391cc942b5",
-    "roadmap": "SPECIFICATIONS_ROADMAP.md:5c6e23123d158007377d52ec",
-    "readme": "README.md:316f79e40a6922fa0bf29961",
-    "protocolReadme": "packages/protocol/README.md:3a3d3a1340fb98b87f722375",
-    "packageJson": "package.json:a45f631d26b4b87124be7849",
-    "packageIndex": "packages/protocol/src/index.js:60ed0a4f219845b39e07e4bb",
-    "packageTypes": "packages/protocol/src/index.d.ts:1dddeb9bb40d80b131a30ce5",
-    "packageSource": "packages/protocol/src/canonical/v46-public-operator-claim-boundaries.js:c13ecca31452effec4966ea7",
+    "spec": "BITCODE_SPEC_V46.md:3b619dd4971f05e9f26d2d52",
+    "delta": "BITCODE_SPEC_V46_DELTA.md:ae7a032374ef3a15afc165b1",
+    "notes": "BITCODE_SPEC_V46_NOTES.md:553cd172a2197af62d359f90",
+    "parity": "BITCODE_SPEC_V46_PARITY_MATRIX.md:f136e996c7f10fec0294d763",
+    "roadmap": "SPECIFICATIONS_ROADMAP.md:1deef7aebb8b8ffaa629800b",
+    "readme": "README.md:72b51bb4c1dd930185f6f4d6",
+    "protocolReadme": "packages/protocol/README.md:72af480ca278f8f038ee27af",
+    "packageJson": "package.json:c34b3c2fad27dcdda5681997",
+    "packageIndex": "packages/protocol/src/index.js:7d253665b2eb8abc2c84ef31",
+    "packageTypes": "packages/protocol/src/index.d.ts:91eb37870471a544f284be49",
+    "packageSource": "packages/protocol/src/canonical/v46-public-operator-claim-boundaries.js:03799d116974cb5d9efba096",
     "packageTest": "packages/protocol/test/v46-public-operator-claim-boundaries.test.js:0afae65791ef7d7081b2a87a",
     "generator": "scripts/generate-v46-public-operator-claim-boundaries.mjs:5a7e5f8c9013c83e3c3818fb",
     "checker": "scripts/check-v46-gate3-public-operator-claim-boundaries.mjs:b958086681492633958639bf",
-    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:5ce1c8681bb2ef5d0ac25066",
-    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:0b6dfb96c5cbee7d42652666",
+    "gateWorkflow": ".github/workflows/bitcode-gate-quality.yml:5146b7aad831ade15738e8e8",
+    "canonWorkflow": ".github/workflows/bitcode-canon-quality.yml:c0dcd99e25b780873e412123",
     "publicCopy": "uapi/components/base/bitcode/layout/bitcode-public-copy.ts:9b39322f872b899e1c752701",
     "publicExplainers": "uapi/components/base/bitcode/layout/bitcode-public-explainers.ts:4e3b84dda50607ea8ea2b73e",
     "landingShared": "uapi/app/(root)/components/landing/marketing-landing-shared.tsx:27c33bd46ea46fd7608fd093",

.bitcode/v46-public-operator-claim-boundaries.json

@@ -431,6 +431,9 @@ jobs:
               if [ -f scripts/check-v46-gate4-product-route-comprehension-readback.mjs ]; then
                 node scripts/check-v46-gate4-product-route-comprehension-readback.mjs --skip-branch-check --skip-package-tests
               fi
+              if [ -f scripts/check-v46-gate5-interface-claim-contracts.mjs ]; then
+                node scripts/check-v46-gate5-interface-claim-contracts.mjs --skip-branch-check --skip-package-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

.github/workflows/bitcode-canon-quality.yml

@@ -560,6 +560,9 @@ jobs:
               if [ -f scripts/check-v46-gate4-product-route-comprehension-readback.mjs ]; then
                 node scripts/check-v46-gate4-product-route-comprehension-readback.mjs --skip-branch-check --skip-package-tests
               fi
+              if [ -f scripts/check-v46-gate5-interface-claim-contracts.mjs ]; then
+                node scripts/check-v46-gate5-interface-claim-contracts.mjs --skip-branch-check --skip-package-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
@@ -610,6 +613,9 @@ jobs:
               if [ -f BITCODE_SPEC_V46.md ] && [ -f scripts/check-v46-gate4-product-route-comprehension-readback.mjs ]; then
                 node scripts/check-v46-gate4-product-route-comprehension-readback.mjs --skip-branch-check --skip-package-tests
               fi
+              if [ -f BITCODE_SPEC_V46.md ] && [ -f scripts/check-v46-gate5-interface-claim-contracts.mjs ]; then
+                node scripts/check-v46-gate5-interface-claim-contracts.mjs --skip-branch-check --skip-package-tests
+              fi
             fi
             if [ "$POINTER" = "V43" ] && [ -f scripts/check-v44-gate1-scaled-economy-roadmap-opening.mjs ]; then
               node scripts/check-v44-gate1-scaled-economy-roadmap-opening.mjs --skip-branch-check

.github/workflows/bitcode-gate-quality.yml

@@ -315,6 +315,50 @@ The source-safe generated artifact for this Gate 4 atom is
 `.bitcode/v46-product-route-comprehension-readback.json`; it is generated by
 `buildV46ProductRouteComprehensionReadback` and checked by `check:v46-gate4`.
 
+## V46 interface claim contract law
+
+Gate 5: API/MCP, ChatGPT App, And Bitcode Chat Claim Contracts binds machine,
+assistant, conversation, and package-consumer surfaces to the same
+`InterfaceClaim` taxonomy as public docs and website routes. These surfaces
+may carry requests, responses, tool descriptors, action descriptors, source-safe
+rendering metadata, proof roots, denied states, and handoff metadata, but they
+must not become parallel protocol authority or serialize private payloads.
+
+The public API is the versionless machine contract for source-safe schema
+compatibility. It must expose only source-safe request/response fields, proof
+roots, denied repair states, and compatibility posture. It must not expose
+protected source, unpaid AssetPack source, raw prompts, provider responses,
+credentials, wallet private material, private settlement payloads, or
+value-bearing mainnet authority.
+
+The MCP API is the package-owned tool contract for source-safe protocol entry.
+It may expose tool registry names, permission requirements, provider binding
+blockers, write-admission posture, proof roots, queue metadata, and denied
+repair states. MCP does not settle BTC, transfer BTD rights, unlock source, or
+deliver source-bearing AssetPacks by itself.
+
+The ChatGPT App is the package-owned assistant action contract for Reading and
+delivery-adjacent actions. It may render source-safe Need, Finding Fits,
+preview, quote, settlement-blocker, delivery-lock, and proof-root metadata.
+It must require explicit write admission for stateful actions and must show
+settlement/right/delivery denied states until proof readback authorizes the
+next boundary.
+
+Bitcode Chat is the website conversation overlay and stream/handoff surface.
+It may guide Reading, summarize route-local state, display source-safe stream
+events, preserve proof roots, and hand off to `/read`; it cannot advance
+protocol state, settle, transfer rights, unlock source, or bypass Terminal,
+route, ledger, wallet, or proof authority.
+
+Package consumers receive stable source-safe contracts and generated readback
+metadata. Package exports may help consumers reason about claims, but package
+consumers do not get a separate state machine, value-bearing authority, or
+source disclosure boundary beyond the same proof-backed protocol law.
+
+The source-safe generated artifact for this Gate 5 atom is
+`.bitcode/v46-interface-claim-contracts.json`; it is generated by
+`buildV46InterfaceClaimContracts` and checked by `check:v46-gate5`.
+
 ## V46 whole Bitcode operator chain
 
 The V46 operator chain is: connect source and organization policy, synthesize
@@ -811,6 +855,7 @@ and quality summary.
 | `.bitcode/v46-protocol-comprehension-object-model.json` | protocol comprehension object and claim taxonomy artifact | Gate 2 |
 | `.bitcode/v46-public-operator-claim-boundaries.json` | public/operator claim-boundary artifact | Gate 3 |
 | `.bitcode/v46-product-route-comprehension-readback.json` | product route comprehension readback artifact | Gate 4 |
+| `.bitcode/v46-interface-claim-contracts.json` | API/MCP, ChatGPT App, Bitcode Chat, and package-consumer claim-contract artifact | Gate 5 |
 | `.bitcode/v46-inference-synthesis-proof.json` | inference proof-family artifact | future proof gate |
 | `.bitcode/v46-prompt-completeness-proof.json` | prompt proof-family artifact | future proof gate |
 | `.bitcode/v46-static-code-analysis-proof.json` | static-code proof-family artifact | future proof gate |
@@ -830,8 +875,9 @@ V46 specifying generated artifacts must include `.bitcode/v46-spec-family-report
 `.bitcode/v46-canonical-input-report.json`,
 `.bitcode/v46-protocol-comprehension-object-model.json`,
 `.bitcode/v46-public-operator-claim-boundaries.json`,
-`.bitcode/v46-product-route-comprehension-readback.json`, all nine V46
-proof-family artifacts, `.bitcode/v46-source-safe-e2e-rehearsal.json`,
+`.bitcode/v46-product-route-comprehension-readback.json`,
+`.bitcode/v46-interface-claim-contracts.json`, all nine V46 proof-family
+artifacts, `.bitcode/v46-source-safe-e2e-rehearsal.json`,
 `.bitcode/v46-promotion-readiness-report.json`, and future
 `BITCODE_SPEC_V46_PROVEN.md`; each artifact becomes required only when its own
 gate closes.
@@ -886,6 +932,7 @@ Gate 1 validates only active V45 plus draft V46 posture:
 - `pnpm run check:v46-gate2`
 - `pnpm run check:v46-gate3`
 - `pnpm run check:v46-gate4`
+- `pnpm run check:v46-gate5`
 
 ## V46 promotion canon
 
@@ -996,9 +1043,11 @@ artifact roots.
 
 ## Appendix D. Validation and checking gate catalog
 
-Validation commands include `check:v46-gate1`, draft V46 spec-family checks,
-active V45 promoted checks, V45/V46 canon posture drift checks, and later
-parity, proof, implementation, rehearsal, and promotion commands.
+Validation commands include `check:v46-gate1`, `check:v46-gate2`,
+`check:v46-gate3`, `check:v46-gate4`, `check:v46-gate5`, draft V46
+spec-family checks, active V45 promoted checks, V45/V46 canon posture drift
+checks, and later parity, proof, implementation, rehearsal, and promotion
+commands.
 
 ## Appendix E. Current canonical source map
 

BITCODE_SPEC_V46.md

@@ -145,6 +145,36 @@ Accepted Gate 4 decisions:
   prompts, raw provider responses, credentials, wallet private material,
   private settlement payloads, or value-bearing mainnet authority.
 
+## Gate 5: API/MCP, ChatGPT App, And Bitcode Chat Claim Contracts
+
+Gate 5 adds `V46InterfaceClaimContracts` as a source-safe generated artifact
+at `.bitcode/v46-interface-claim-contracts.json`. It binds public API, MCP
+API, ChatGPT App, Bitcode Chat, and package-consumer surfaces to the Gate 2
+`InterfaceClaim` taxonomy, Gate 3 public/operator claim boundaries, and Gate 4
+product-route readback law.
+
+Accepted Gate 5 decisions:
+
+- The public API exposes versionless source-safe schema compatibility, proof
+  roots, denied repair states, and compatibility posture without protected
+  source or private payload serialization.
+- MCP exposes package-owned tool contracts, permission requirements, provider
+  binding blockers, write-admission posture, proof roots, queue metadata, and
+  denied repair states; it does not settle BTC, transfer BTD rights, unlock
+  source, or deliver source-bearing AssetPacks by itself.
+- The ChatGPT App exposes package-owned Reading and delivery-adjacent action
+  contracts, source-safe rendering, explicit write admission, proof roots, and
+  settlement/right/delivery denied states until proof readback authorizes the
+  next boundary.
+- Bitcode Chat exposes route-local conversation, stream, proof-root, and
+  terminal-delegated handoff metadata; it does not advance protocol state or
+  create parallel state authority.
+- Package consumers receive stable source-safe contracts and generated
+  readback metadata, not a separate state machine or disclosure boundary.
+- Gate 5 remains source-safe metadata and contract readback work. It does not
+  authorize runtime behavior changes, source disclosure, settlement, delivery,
+  or value-bearing mainnet behavior.
+
 ## Commit-Body Direction
 
 V46 commit bodies should name the gate class, protocol law or interface claim