Skip to content

Commit 82f5e3d

Browse files
geraldarthurdavisgeraldarthurdavis
committed
V33 Gate 7: Add API schema compatibility matrix
Introduce the package-owned APISchemaCompatibilityMatrix with required consumer surfaces, success/denied/blocked/stale/deferred examples, versionless path enforcement, and source-safe row roots. Wire generated Gate 7 artifacts, checks, workflow coverage, protocol specifying inputs, API/MCP/ChatGPT/Terminal fixture tests, and V33 specification parity updates.
1 parent bc622b6 commit 82f5e3d

29 files changed

Lines changed: 1665 additions & 33 deletions

‎.bitcode/v33-api-schema-compatibility-matrix.json‎

Lines changed: 289 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,289 @@
1+
{
2+
"artifactId": "v33-api-schema-compatibility-matrix",
3+
"artifactRoot": "v33-api-schema-compatibility-matrix-artifact:c60522772703721fbfb06480",
4+
"coverage": {
5+
"breakingChangePolicyRecorded": true,
6+
"compatibilityStatusRecorded": true,
7+
"consumerSurfacesRecorded": true,
8+
"credentialsSerialized": false,
9+
"examplesRecorded": true,
10+
"fixturePathsRecorded": true,
11+
"protectedSourceSerialized": false,
12+
"schemaIdsRecorded": true,
13+
"successDeniedBlockedStaleDeferredExamples": true,
14+
"validationCommandsRecorded": true,
15+
"versionlessPathDiscipline": true
16+
},
17+
"currentTarget": "V32",
18+
"docsEvidence": [
19+
{
20+
"digest": "sha256:ed089e16ee38dc0115d903f9050966e9c84bbb636fff36ad6abf677c3265e60a",
21+
"relativePath": "BITCODE_SPEC_V33.md",
22+
"requiredTokens": [
23+
{
24+
"present": true,
25+
"token": "APISchemaCompatibilityMatrix"
26+
},
27+
{
28+
"present": true,
29+
"token": "Gate 7"
30+
}
31+
]
32+
},
33+
{
34+
"digest": "sha256:d40a905149dd08f181a1d5eadcfc5f1abe73c9866492e56edbd6f750351cfa6a",
35+
"relativePath": "BITCODE_SPEC_V33_DELTA.md",
36+
"requiredTokens": [
37+
{
38+
"present": true,
39+
"token": "API Schemas Examples And Compatibility Matrix"
40+
}
41+
]
42+
},
43+
{
44+
"digest": "sha256:d0dac824bd68a730ab7ac4a93c5ee22cfdcbe1af656f3c6db62cde772cfb3008",
45+
"relativePath": "BITCODE_SPEC_V33_PARITY_MATRIX.md",
46+
"requiredTokens": [
47+
{
48+
"present": true,
49+
"token": "API schema compatibility"
50+
}
51+
]
52+
},
53+
{
54+
"digest": "sha256:b33aa3ac222b874d3c773bf3f06d9d0e9dc042f018d487776ddd71b3972959ea",
55+
"relativePath": "SPECIFICATIONS_ROADMAP.md",
56+
"requiredTokens": [
57+
{
58+
"present": true,
59+
"token": "V33 Gate 7 API Schemas Examples And Compatibility Matrix"
60+
}
61+
]
62+
}
63+
],
64+
"docsEvidenceComplete": true,
65+
"generatedAt": "2026-05-22T00:00:00.000Z",
66+
"matrixRows": [
67+
{
68+
"compatibilityStatus": "compatible",
69+
"consumerSurface": "public_api",
70+
"examplePosture": "success",
71+
"path": "/api/btd/registry",
72+
"proofRoot": "v33-api-schema-compatibility-row:beccdf20bc3aacb4ae460c24",
73+
"rowId": "public-api-btd-registry-success"
74+
},
75+
{
76+
"compatibilityStatus": "breaking_change_denied",
77+
"consumerSurface": "public_api",
78+
"examplePosture": "denied",
79+
"path": "/api/btd/mint-draft",
80+
"proofRoot": "v33-api-schema-compatibility-row:c21dbc68647a08009e50e3fe",
81+
"rowId": "public-api-btd-mint-draft-denied"
82+
},
83+
{
84+
"compatibilityStatus": "stale_rejected",
85+
"consumerSurface": "public_api",
86+
"examplePosture": "stale",
87+
"path": "/api/btd/organization-interface-authority",
88+
"proofRoot": "v33-api-schema-compatibility-row:02c4301c393cd9153bb06da8",
89+
"rowId": "public-api-organization-authority-stale"
90+
},
91+
{
92+
"compatibilityStatus": "compatible",
93+
"consumerSurface": "mcp_api",
94+
"examplePosture": "success",
95+
"path": "bitcode://pipelines/asset-pack/create",
96+
"proofRoot": "v33-api-schema-compatibility-row:5a207fa9e1b78eae0fe0a4d2",
97+
"rowId": "mcp-api-asset-pack-create-success"
98+
},
99+
{
100+
"compatibilityStatus": "blocked_until_rights",
101+
"consumerSurface": "chatgpt_app",
102+
"examplePosture": "blocked",
103+
"path": "chatgpt://actions/bitcode_deliver_asset_pack",
104+
"proofRoot": "v33-api-schema-compatibility-row:f4c7f4e3963452d1c31f8174",
105+
"rowId": "chatgpt-app-deliver-assetpack-blocked"
106+
},
107+
{
108+
"compatibilityStatus": "blocked_until_rights",
109+
"consumerSurface": "terminal_handoff",
110+
"examplePosture": "blocked",
111+
"path": "terminal://reading/asset-pack-preview",
112+
"proofRoot": "v33-api-schema-compatibility-row:662ca6ec8daece4b6accfe79",
113+
"rowId": "terminal-handoff-preview-blocked"
114+
},
115+
{
116+
"compatibilityStatus": "deferred_not_admitted",
117+
"consumerSurface": "package_consumer",
118+
"examplePosture": "deferred",
119+
"path": "package://@bitcode/btd/exchange-hook",
120+
"proofRoot": "v33-api-schema-compatibility-row:310f0178e7fcc94e72090b42",
121+
"rowId": "package-consumer-exchange-hook-deferred"
122+
}
123+
],
124+
"missingConsumerSurfaces": [],
125+
"missingExamplePostures": [],
126+
"observedConsumerSurfaces": [
127+
"chatgpt_app",
128+
"mcp_api",
129+
"package_consumer",
130+
"public_api",
131+
"terminal_handoff"
132+
],
133+
"observedExamplePostures": [
134+
"blocked",
135+
"deferred",
136+
"denied",
137+
"stale",
138+
"success"
139+
],
140+
"passed": true,
141+
"requiredConsumerSurfaces": [
142+
"public_api",
143+
"mcp_api",
144+
"chatgpt_app",
145+
"terminal_handoff",
146+
"package_consumer"
147+
],
148+
"requiredExamplePostures": [
149+
"success",
150+
"denied",
151+
"blocked",
152+
"stale",
153+
"deferred"
154+
],
155+
"schemaId": "bitcode.v33.apiSchemaCompatibilityMatrix.v1",
156+
"sourceEvidence": [
157+
{
158+
"digest": "sha256:21527a4ab84909ce72247fab17ae9030e8716e8a14116456f09066a5cc7d272e",
159+
"relativePath": "packages/btd/src/api-schema-compatibility-matrix.ts",
160+
"requiredTokens": [
161+
{
162+
"present": true,
163+
"token": "buildBtdApiSchemaCompatibilityMatrix"
164+
},
165+
{
166+
"present": true,
167+
"token": "BTD_API_SCHEMA_COMPATIBILITY_EXAMPLE_POSTURES"
168+
},
169+
{
170+
"present": true,
171+
"token": "public-api-btd-registry-success"
172+
},
173+
{
174+
"present": true,
175+
"token": "chatgpt-app-deliver-assetpack-blocked"
176+
},
177+
{
178+
"present": true,
179+
"token": "package-consumer-exchange-hook-deferred"
180+
},
181+
{
182+
"present": true,
183+
"token": "assertVersionlessPath"
184+
}
185+
]
186+
},
187+
{
188+
"digest": "sha256:1b5c3b41880dbc8ac3049ca3ece89a29f2a62e7be92e0796e7dea25cab5e8004",
189+
"relativePath": "packages/btd/src/index.ts",
190+
"requiredTokens": [
191+
{
192+
"present": true,
193+
"token": "api-schema-compatibility-matrix"
194+
}
195+
]
196+
},
197+
{
198+
"digest": "sha256:096f5097ed05b682f6a881d3e0d584050359b8bdfc20d576336b1a6c86c3f024",
199+
"relativePath": "packages/btd/package.json",
200+
"requiredTokens": [
201+
{
202+
"present": true,
203+
"token": "./api-schema-compatibility-matrix"
204+
}
205+
]
206+
}
207+
],
208+
"sourceEvidenceComplete": true,
209+
"sourceSafetyVerdict": "source-safe-api-schema-compatibility-metadata",
210+
"testEvidence": [
211+
{
212+
"digest": "sha256:32fa0cfd7301dc44808b3eacb743d1653567ec56cc04eaf029a4bebe3c54130c",
213+
"relativePath": "packages/btd/__tests__/api-schema-compatibility-matrix.test.ts",
214+
"requiredTokens": [
215+
{
216+
"present": true,
217+
"token": "publishes source-safe rows for every required consumer surface and example posture"
218+
},
219+
{
220+
"present": true,
221+
"token": "records package-owned success, denied, blocked, stale, and deferred examples"
222+
},
223+
{
224+
"present": true,
225+
"token": "enforces versionless paths and gate-neutral source identifiers"
226+
}
227+
]
228+
},
229+
{
230+
"digest": "sha256:c4d724dded5ca993998dbb5b096e427c53043e296fd7b3ac721fba197955d95c",
231+
"relativePath": "packages/api/src/routes/__tests__/btd-crypto.test.ts",
232+
"requiredTokens": [
233+
{
234+
"present": true,
235+
"token": "shares the package-owned API schema compatibility matrix for versionless public routes"
236+
},
237+
{
238+
"present": true,
239+
"token": "public-api-btd-registry-success"
240+
}
241+
]
242+
},
243+
{
244+
"digest": "sha256:b08b8c579bbfd8e7d9773a18db522aebc1d5f664a808209a697cf0f09a6abc7a",
245+
"relativePath": "packages/executions-mcp/src/mcp-server/src/__tests__/unit/pipeline-ingress-contract.test.ts",
246+
"requiredTokens": [
247+
{
248+
"present": true,
249+
"token": "shares the package-owned API schema compatibility matrix for MCP tool calls"
250+
},
251+
{
252+
"present": true,
253+
"token": "mcp-api-asset-pack-create-success"
254+
}
255+
]
256+
},
257+
{
258+
"digest": "sha256:5f224cf0b1ea3a7ee5917fe50cbeea0abbe79c48b2a0cb3b7775e8fa49e401d9",
259+
"relativePath": "packages/chatgptapp/src/__tests__/tools.test.ts",
260+
"requiredTokens": [
261+
{
262+
"present": true,
263+
"token": "shares the package-owned API schema compatibility matrix for ChatGPT App blocked delivery"
264+
},
265+
{
266+
"present": true,
267+
"token": "chatgpt-app-deliver-assetpack-blocked"
268+
}
269+
]
270+
},
271+
{
272+
"digest": "sha256:73196f8eefc7d3d3473b41f187a17191ec581566c639f242586a76db734d4825",
273+
"relativePath": "uapi/tests/terminalOrganizationAuthority.test.ts",
274+
"requiredTokens": [
275+
{
276+
"present": true,
277+
"token": "shares the package-owned API schema compatibility matrix for Terminal handoff rows"
278+
},
279+
{
280+
"present": true,
281+
"token": "terminal-handoff-preview-blocked"
282+
}
283+
]
284+
}
285+
],
286+
"testEvidenceComplete": true,
287+
"version": "V33",
288+
"versionedPaths": []
289+
}

‎.bitcode/v33-chatgpt-app-action-contracts.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -471,7 +471,7 @@
471471
"relativePath": "packages/btd/src/chatgpt-app-action-contract.ts"
472472
},
473473
{
474-
"digest": "sha256:cf56aa25a50932654784e7a89dd6730026437f42d5be176e7b64c316bd89578a",
474+
"digest": "sha256:1b5c3b41880dbc8ac3049ca3ece89a29f2a62e7be92e0796e7dea25cab5e8004",
475475
"relativePath": "packages/btd/src/index.ts"
476476
},
477477
{
@@ -528,7 +528,7 @@
528528
"relativePath": "packages/chatgptapp/src/__tests__/chatgpt-action-contract.test.ts"
529529
},
530530
{
531-
"digest": "sha256:e6eab944cec8b0c127007929b2af097bcc679e37932162e1c43f1b896272172b",
531+
"digest": "sha256:5f224cf0b1ea3a7ee5917fe50cbeea0abbe79c48b2a0cb3b7775e8fa49e401d9",
532532
"relativePath": "packages/chatgptapp/src/__tests__/tools.test.ts"
533533
},
534534
{

‎.bitcode/v33-interface-authorization-policy.json‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
"currentTarget": "V32",
1818
"docsEvidence": [
1919
{
20-
"digest": "sha256:0f5bfb507c4a67b352cc4be4c5c2f2f4d8eabfef5e397c229e08bf7bbd698e96",
20+
"digest": "sha256:ed089e16ee38dc0115d903f9050966e9c84bbb636fff36ad6abf677c3265e60a",
2121
"relativePath": "BITCODE_SPEC_V33.md",
2222
"requiredTokens": [
2323
{
@@ -31,7 +31,7 @@
3131
]
3232
},
3333
{
34-
"digest": "sha256:4fe80598680b731ab069d692869de6164ba12651ed50cef23b4d8c6d11fdc613",
34+
"digest": "sha256:d40a905149dd08f181a1d5eadcfc5f1abe73c9866492e56edbd6f750351cfa6a",
3535
"relativePath": "BITCODE_SPEC_V33_DELTA.md",
3636
"requiredTokens": [
3737
{
@@ -41,7 +41,7 @@
4141
]
4242
},
4343
{
44-
"digest": "sha256:639468a70e1fd15fd995e8cf1612179d4f7647b9aa19bdd71ea2206476487416",
44+
"digest": "sha256:d0dac824bd68a730ab7ac4a93c5ee22cfdcbe1af656f3c6db62cde772cfb3008",
4545
"relativePath": "BITCODE_SPEC_V33_PARITY_MATRIX.md",
4646
"requiredTokens": [
4747
{
@@ -51,7 +51,7 @@
5151
]
5252
},
5353
{
54-
"digest": "sha256:45b3871efc9140f1ca4da6e2e4724dcb2a8cc055353ed6b395c03663fd12ea3b",
54+
"digest": "sha256:b33aa3ac222b874d3c773bf3f06d9d0e9dc042f018d487776ddd71b3972959ea",
5555
"relativePath": "SPECIFICATIONS_ROADMAP.md",
5656
"requiredTokens": [
5757
{
@@ -234,7 +234,7 @@
234234
]
235235
},
236236
{
237-
"digest": "sha256:5f1bd9663b5c2b6fed8a4742a721a92ee47e8a27eaec7fdfca8bd8622018e089",
237+
"digest": "sha256:c4d724dded5ca993998dbb5b096e427c53043e296fd7b3ac721fba197955d95c",
238238
"relativePath": "packages/api/src/routes/__tests__/btd-crypto.test.ts",
239239
"requiredTokens": [
240240
{
@@ -244,7 +244,7 @@
244244
]
245245
},
246246
{
247-
"digest": "sha256:07199a0e7ba6c754b212d59279bd4b70d5a917f93f3477213e6d8aa783d5ad8c",
247+
"digest": "sha256:b08b8c579bbfd8e7d9773a18db522aebc1d5f664a808209a697cf0f09a6abc7a",
248248
"relativePath": "packages/executions-mcp/src/mcp-server/src/__tests__/unit/pipeline-ingress-contract.test.ts",
249249
"requiredTokens": [
250250
{
@@ -254,7 +254,7 @@
254254
]
255255
},
256256
{
257-
"digest": "sha256:e6eab944cec8b0c127007929b2af097bcc679e37932162e1c43f1b896272172b",
257+
"digest": "sha256:5f224cf0b1ea3a7ee5917fe50cbeea0abbe79c48b2a0cb3b7775e8fa49e401d9",
258258
"relativePath": "packages/chatgptapp/src/__tests__/tools.test.ts",
259259
"requiredTokens": [
260260
{
@@ -264,7 +264,7 @@
264264
]
265265
},
266266
{
267-
"digest": "sha256:f3f281488ac62a0f9f87545f746efd10726c1cb04afc12de88ea6e3537b7e429",
267+
"digest": "sha256:73196f8eefc7d3d3473b41f187a17191ec581566c639f242586a76db734d4825",
268268
"relativePath": "uapi/tests/terminalOrganizationAuthority.test.ts",
269269
"requiredTokens": [
270270
{

‎.bitcode/v33-interface-contract-catalog.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@
222222
]
223223
},
224224
{
225-
"digest": "sha256:cf56aa25a50932654784e7a89dd6730026437f42d5be176e7b64c316bd89578a",
225+
"digest": "sha256:1b5c3b41880dbc8ac3049ca3ece89a29f2a62e7be92e0796e7dea25cab5e8004",
226226
"relativePath": "packages/btd/src/index.ts",
227227
"requiredTokens": [
228228
{
@@ -232,7 +232,7 @@
232232
]
233233
},
234234
{
235-
"digest": "sha256:0f5bfb507c4a67b352cc4be4c5c2f2f4d8eabfef5e397c229e08bf7bbd698e96",
235+
"digest": "sha256:ed089e16ee38dc0115d903f9050966e9c84bbb636fff36ad6abf677c3265e60a",
236236
"relativePath": "BITCODE_SPEC_V33.md",
237237
"requiredTokens": [
238238
{

0 commit comments

Comments
 (0)