Merge pull request #76 from engineeredsoftware/version/v33

V33 Canonical Promotion: Commercial Interface Depth

Author: geraldarthurdavis

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

@@ -0,0 +1,289 @@
+{
+  "artifactId": "v33-api-schema-compatibility-matrix",
+  "artifactRoot": "v33-api-schema-compatibility-matrix-artifact:c60522772703721fbfb06480",
+  "coverage": {
+    "breakingChangePolicyRecorded": true,
+    "compatibilityStatusRecorded": true,
+    "consumerSurfacesRecorded": true,
+    "credentialsSerialized": false,
+    "examplesRecorded": true,
+    "fixturePathsRecorded": true,
+    "protectedSourceSerialized": false,
+    "schemaIdsRecorded": true,
+    "successDeniedBlockedStaleDeferredExamples": true,
+    "validationCommandsRecorded": true,
+    "versionlessPathDiscipline": true
+  },
+  "currentTarget": "V32",
+  "docsEvidence": [
+    {
+      "digest": "sha256:f4f18279dea8ecc27de7e13ee5c4c4496b45ad5e4dfd37aa2909355fda7f391e",
+      "relativePath": "BITCODE_SPEC_V33.md",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "APISchemaCompatibilityMatrix"
+        },
+        {
+          "present": true,
+          "token": "Gate 7"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:82166f72b7f63ad1dae97e1ddb258af14cfca8d69b1e0dbd4437432e8455ca5d",
+      "relativePath": "BITCODE_SPEC_V33_DELTA.md",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "API Schemas Examples And Compatibility Matrix"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:a08ef4caf86e231ca2402522f3d750de8ab81a8271bd63b8b541adb91b87d164",
+      "relativePath": "BITCODE_SPEC_V33_PARITY_MATRIX.md",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "API schema compatibility"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:ce9ec6145a06aed32c5b346095152dc44892f5d71bf0987ed2af282c664ac5c1",
+      "relativePath": "SPECIFICATIONS_ROADMAP.md",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "V33 Gate 7 API Schemas Examples And Compatibility Matrix"
+        }
+      ]
+    }
+  ],
+  "docsEvidenceComplete": true,
+  "generatedAt": "2026-05-22T00:00:00.000Z",
+  "matrixRows": [
+    {
+      "compatibilityStatus": "compatible",
+      "consumerSurface": "public_api",
+      "examplePosture": "success",
+      "path": "/api/btd/registry",
+      "proofRoot": "v33-api-schema-compatibility-row:beccdf20bc3aacb4ae460c24",
+      "rowId": "public-api-btd-registry-success"
+    },
+    {
+      "compatibilityStatus": "breaking_change_denied",
+      "consumerSurface": "public_api",
+      "examplePosture": "denied",
+      "path": "/api/btd/mint-draft",
+      "proofRoot": "v33-api-schema-compatibility-row:c21dbc68647a08009e50e3fe",
+      "rowId": "public-api-btd-mint-draft-denied"
+    },
+    {
+      "compatibilityStatus": "stale_rejected",
+      "consumerSurface": "public_api",
+      "examplePosture": "stale",
+      "path": "/api/btd/organization-interface-authority",
+      "proofRoot": "v33-api-schema-compatibility-row:02c4301c393cd9153bb06da8",
+      "rowId": "public-api-organization-authority-stale"
+    },
+    {
+      "compatibilityStatus": "compatible",
+      "consumerSurface": "mcp_api",
+      "examplePosture": "success",
+      "path": "bitcode://pipelines/asset-pack/create",
+      "proofRoot": "v33-api-schema-compatibility-row:5a207fa9e1b78eae0fe0a4d2",
+      "rowId": "mcp-api-asset-pack-create-success"
+    },
+    {
+      "compatibilityStatus": "blocked_until_rights",
+      "consumerSurface": "chatgpt_app",
+      "examplePosture": "blocked",
+      "path": "chatgpt://actions/bitcode_deliver_asset_pack",
+      "proofRoot": "v33-api-schema-compatibility-row:f4c7f4e3963452d1c31f8174",
+      "rowId": "chatgpt-app-deliver-assetpack-blocked"
+    },
+    {
+      "compatibilityStatus": "blocked_until_rights",
+      "consumerSurface": "terminal_handoff",
+      "examplePosture": "blocked",
+      "path": "terminal://reading/asset-pack-preview",
+      "proofRoot": "v33-api-schema-compatibility-row:662ca6ec8daece4b6accfe79",
+      "rowId": "terminal-handoff-preview-blocked"
+    },
+    {
+      "compatibilityStatus": "deferred_not_admitted",
+      "consumerSurface": "package_consumer",
+      "examplePosture": "deferred",
+      "path": "package://@bitcode/btd/exchange-hook",
+      "proofRoot": "v33-api-schema-compatibility-row:310f0178e7fcc94e72090b42",
+      "rowId": "package-consumer-exchange-hook-deferred"
+    }
+  ],
+  "missingConsumerSurfaces": [],
+  "missingExamplePostures": [],
+  "observedConsumerSurfaces": [
+    "chatgpt_app",
+    "mcp_api",
+    "package_consumer",
+    "public_api",
+    "terminal_handoff"
+  ],
+  "observedExamplePostures": [
+    "blocked",
+    "deferred",
+    "denied",
+    "stale",
+    "success"
+  ],
+  "passed": true,
+  "requiredConsumerSurfaces": [
+    "public_api",
+    "mcp_api",
+    "chatgpt_app",
+    "terminal_handoff",
+    "package_consumer"
+  ],
+  "requiredExamplePostures": [
+    "success",
+    "denied",
+    "blocked",
+    "stale",
+    "deferred"
+  ],
+  "schemaId": "bitcode.v33.apiSchemaCompatibilityMatrix.v1",
+  "sourceEvidence": [
+    {
+      "digest": "sha256:21527a4ab84909ce72247fab17ae9030e8716e8a14116456f09066a5cc7d272e",
+      "relativePath": "packages/btd/src/api-schema-compatibility-matrix.ts",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "buildBtdApiSchemaCompatibilityMatrix"
+        },
+        {
+          "present": true,
+          "token": "BTD_API_SCHEMA_COMPATIBILITY_EXAMPLE_POSTURES"
+        },
+        {
+          "present": true,
+          "token": "public-api-btd-registry-success"
+        },
+        {
+          "present": true,
+          "token": "chatgpt-app-deliver-assetpack-blocked"
+        },
+        {
+          "present": true,
+          "token": "package-consumer-exchange-hook-deferred"
+        },
+        {
+          "present": true,
+          "token": "assertVersionlessPath"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:820b0db3c5cfa0bf533ac140d95b41c3d9f499a7d910ea0a191aa6ed8eb4d0b0",
+      "relativePath": "packages/btd/src/index.ts",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "api-schema-compatibility-matrix"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:e7775638c2da3d41e61b4cc2af2c3bdf4ea3696fe3d0261803381dd385149df9",
+      "relativePath": "packages/btd/package.json",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "./api-schema-compatibility-matrix"
+        }
+      ]
+    }
+  ],
+  "sourceEvidenceComplete": true,
+  "sourceSafetyVerdict": "source-safe-api-schema-compatibility-metadata",
+  "testEvidence": [
+    {
+      "digest": "sha256:32fa0cfd7301dc44808b3eacb743d1653567ec56cc04eaf029a4bebe3c54130c",
+      "relativePath": "packages/btd/__tests__/api-schema-compatibility-matrix.test.ts",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "publishes source-safe rows for every required consumer surface and example posture"
+        },
+        {
+          "present": true,
+          "token": "records package-owned success, denied, blocked, stale, and deferred examples"
+        },
+        {
+          "present": true,
+          "token": "enforces versionless paths and gate-neutral source identifiers"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:c0c94cbd3006b1eb181d3dde771765c530b66870c1287ce584eb4e4e06cf34aa",
+      "relativePath": "packages/api/src/routes/__tests__/btd-crypto.test.ts",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "shares the package-owned API schema compatibility matrix for versionless public routes"
+        },
+        {
+          "present": true,
+          "token": "public-api-btd-registry-success"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:ef8475335bd430ca5926466e8556f9da3ca9db4e8d1f4ec86b9fc27f5c34a07c",
+      "relativePath": "packages/executions-mcp/src/mcp-server/src/__tests__/unit/pipeline-ingress-contract.test.ts",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "shares the package-owned API schema compatibility matrix for MCP tool calls"
+        },
+        {
+          "present": true,
+          "token": "mcp-api-asset-pack-create-success"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:bd3b2ab267858fb98a2ccc0e7d50666c3f7d86c55d44b81dd79202d0d0394014",
+      "relativePath": "packages/chatgptapp/src/__tests__/tools.test.ts",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "shares the package-owned API schema compatibility matrix for ChatGPT App blocked delivery"
+        },
+        {
+          "present": true,
+          "token": "chatgpt-app-deliver-assetpack-blocked"
+        }
+      ]
+    },
+    {
+      "digest": "sha256:67b4f82b5e94bfcddef7f349f6dd9eb361753c7bc1690be1266f2025147eee4c",
+      "relativePath": "uapi/tests/terminalOrganizationAuthority.test.ts",
+      "requiredTokens": [
+        {
+          "present": true,
+          "token": "shares the package-owned API schema compatibility matrix for Terminal handoff rows"
+        },
+        {
+          "present": true,
+          "token": "terminal-handoff-preview-blocked"
+        }
+      ]
+    }
+  ],
+  "testEvidenceComplete": true,
+  "version": "V33",
+  "versionedPaths": []
+}

.bitcode/v33-canon-posture-drift-report.json

@@ -0,0 +1,77 @@
+{
+  "reportId": "v33-canon-posture-drift-report",
+  "version": "V33",
+  "checkedActiveCanonVersion": "V33",
+  "checkedDraftTargetVersion": "V34",
+  "pointerVersion": "V33",
+  "proofSourceCommit": "6c3cc76c4a41bdbaf02c78334b3cd9c6fa3554b6",
+  "generatedAt": "2026-05-22T17:06:47-03:00",
+  "generatorId": "bitcode.proven-generator.v1",
+  "worktreeState": "clean",
+  "passed": true,
+  "checkCount": 10,
+  "blockingFailureCount": 0,
+  "blockingFailures": [],
+  "runtimeSpecVersion": "Bitcode Spec V33 active canon / V34 system draft",
+  "publicSpecVersion": "Bitcode Spec V33 active canon / V34 system draft",
+  "activeProvenAppendixPath": "BITCODE_SPEC_V33_PROVEN.md",
+  "policyRef": "policy://bitcode/spec-v33-active-v34-system-draft/current",
+  "checkedFiles": [
+    "protocol-demonstration/README.md",
+    "protocol-demonstration/public/index.html",
+    "protocol-demonstration/public/app.js",
+    "protocol-demonstration/server.js"
+  ],
+  "checks": [
+    {
+      "checkId": "pointer-active-canon-alignment",
+      "passed": true,
+      "detail": "BITCODE_SPEC.txt points to V33 while runtime expects V33."
+    },
+    {
+      "checkId": "canon-posture-constant-alignment",
+      "passed": true,
+      "detail": "canon-posture constants resolve V33/V34 with operator label V33 active canon / V34 system draft."
+    },
+    {
+      "checkId": "proven-appendix-alignment",
+      "passed": true,
+      "detail": "active generated appendix path is BITCODE_SPEC_V33_PROVEN.md."
+    },
+    {
+      "checkId": "policy-ref-alignment",
+      "passed": true,
+      "detail": "policy reference is policy://bitcode/spec-v33-active-v34-system-draft/current."
+    },
+    {
+      "checkId": "runtime-state-alignment",
+      "passed": true,
+      "detail": "buildInitialState() reports Bitcode Spec V33 active canon / V34 system draft with canon posture V33/V34."
+    },
+    {
+      "checkId": "public-state-alignment",
+      "passed": true,
+      "detail": "publicState() reports Bitcode Spec V33 active canon / V34 system draft with canon posture V33/V34."
+    },
+    {
+      "checkId": "server-api-alignment",
+      "passed": true,
+      "detail": "server.js keeps API posture sourced from SPEC_VERSION and buildPublicState(...)."
+    },
+    {
+      "checkId": "browser-shell-placeholder-alignment",
+      "passed": true,
+      "detail": "public/index.html exposes canon-posture placeholders and no stale hardcoded hero posture."
+    },
+    {
+      "checkId": "browser-shell-render-alignment",
+      "passed": true,
+      "detail": "public/app.js renders canon posture from runtime state and omits stale V15 explainer keys."
+    },
+    {
+      "checkId": "readme-alignment",
+      "passed": true,
+      "detail": "README states V33 active canon and BITCODE_SPEC_V33_PROVEN.md as the current generated appendix."
+    }
+  ]
+}