V46 Gate 5: Interface Claim Contracts

.bitcode/v46-product-route-comprehension-readback.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-protocol-comprehension-object-model.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-public-operator-claim-boundaries.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",

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

@@ -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-gate-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

BITCODE_SPEC_V46.md

@@ -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_DELTA.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