V35 Gate 10: Close promotion readiness

Adds the source-safe DocumentationTelemetryPromotionReadinessReport artifact, generator, checker, package exports, and focused protocol coverage for V35 Gate 10.

Wires V35 canon promotion through promotion command planning, spec/runtime posture preparation, generated PROVEN support, gate/canon quality workflows, and the version promotion workflow.

Validation: check:v35-gate1..10; V35 spec-family/canonical-input/canon-posture checks; V35 promotion dry-run; protocol typecheck/test; BTD typecheck/test; pipeline typechecks; UAPI TypeScript; git diff --check.

Author: geraldarthurdavis

.bitcode/v35-documentation-telemetry-promotion-readiness-report.json

@@ -66,6 +66,13 @@ jobs:
             if [ -f BITCODE_SPEC_V35.md ]; then
               node scripts/check-bitcode-spec-family.mjs --version V35 --mode draft --current-target V34
             fi
+          elif [ "$POINTER" = "V35" ]; then
+            node scripts/check-bitcode-canonical-inputs.mjs --current-target V35
+            node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V35 --draft-target V36
+            node scripts/check-bitcode-spec-family.mjs --version V35 --mode promoted --current-target V35
+            if [ -f BITCODE_SPEC_V36.md ]; then
+              node scripts/check-bitcode-spec-family.mjs --version V36 --mode draft --current-target V35
+            fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
             exit 1

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

@@ -188,8 +188,19 @@ jobs:
               if [ -f scripts/check-v35-gate9-local-staging-telemetry-documentation-rehearsal.mjs ]; then
                 node scripts/check-v35-gate9-local-staging-telemetry-documentation-rehearsal.mjs --skip-branch-check
               fi
+              if [ -f scripts/check-v35-gate10-promotion-readiness.mjs ]; then
+                node scripts/check-v35-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check
+              fi
             fi
             node scripts/check-v34-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check
+          elif [ "$POINTER" = "V35" ]; then
+            node scripts/check-bitcode-spec-family.mjs --version V35 --mode promoted --current-target V35
+            node scripts/check-bitcode-canonical-inputs.mjs --current-target V35
+            node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V35 --draft-target V36
+            node scripts/check-v35-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check
+            if [ -f BITCODE_SPEC_V36.md ]; then
+              node scripts/check-bitcode-spec-family.mjs --version V36 --mode draft --current-target V35
+            fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
             exit 1
@@ -243,6 +254,7 @@ jobs:
           pnpm --dir packages/protocol exec node --test --test-force-exit test/v35-testnet-rollout-readiness-guide.test.js
           pnpm --dir packages/protocol exec node --test --test-force-exit test/v35-telemetry-documentation-interface-integration.test.js
           pnpm --dir packages/protocol exec node --test --test-force-exit test/v35-local-staging-telemetry-documentation-rehearsal.test.js
+          pnpm --dir packages/protocol exec node --test --test-force-exit test/v35-promotion-readiness.test.js
           pnpm --filter @bitcode/api exec jest --config jest.config.cjs --runTestsByPath src/routes/__tests__/btd-crypto.test.ts --runInBand
           pnpm --filter @bitcode/api exec jest --config jest.config.cjs --runTestsByPath src/routes/__tests__/auxillaries-contract.test.ts --runInBand
           pnpm --dir packages/executions-mcp/src/mcp-server run test:mcp -- --runTestsByPath src/__tests__/unit/auth.test.ts --runInBand

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

@@ -0,0 +1,158 @@
+name: V35 Canon Promotion
+
+on:
+  pull_request:
+    branches:
+      - main
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - ready_for_review
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+  pull-requests: read
+
+jobs:
+  promote-v35:
+    name: V35 Promotion Validation
+    if: >-
+      ${{
+        github.event_name == 'workflow_dispatch' ||
+        (
+          github.event.pull_request.base.ref == 'main' &&
+          github.event.pull_request.head.ref == 'version/v35' &&
+          github.event.pull_request.head.repo.full_name == github.repository
+        )
+      }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout version branch
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref || github.ref_name }}
+          token: ${{ github.token }}
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Validate V35 promotion readiness
+        run: |
+          POINTER="$(cat BITCODE_SPEC.txt)"
+          if [ "$POINTER" = "V34" ]; then
+            node scripts/check-bitcode-spec-family.mjs --version V35 --mode draft --current-target V34
+            node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V34 --draft-target V35
+            node scripts/check-bitcode-canonical-inputs.mjs --current-target V34
+            node scripts/check-v35-gate1-telemetry-docs-roadmap-opening.mjs --skip-branch-check
+            node scripts/check-v35-gate2-documentation-surface-catalog.mjs --skip-branch-check
+            node scripts/check-v35-gate3-telemetry-taxonomy-event-schema-redaction.mjs --skip-branch-check
+            node scripts/check-v35-gate4-public-docs-usage-guides.mjs --skip-branch-check
+            node scripts/check-v35-gate5-dashboards-alerts-runbooks-incident-escalation.mjs --skip-branch-check
+            node scripts/check-v35-gate6-documentation-qa-alignment-proofs.mjs --skip-branch-check
+            node scripts/check-v35-gate7-developer-operator-testnet-rollout-guides.mjs --skip-branch-check
+            node scripts/check-v35-gate8-telemetry-documentation-interface-integration.mjs --skip-branch-check
+            node scripts/check-v35-gate9-local-staging-telemetry-documentation-rehearsal.mjs --skip-branch-check
+            node scripts/check-v35-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check
+            node scripts/promote-bitcode-canon.mjs --version V35 --commit HEAD --dry-run
+          elif [ "$POINTER" = "V35" ]; then
+            node scripts/check-bitcode-spec-family.mjs --version V35 --mode promoted --current-target V35
+            node scripts/check-bitcode-canonical-inputs.mjs --current-target V35
+            node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V35 --draft-target V36
+            node scripts/check-v35-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check
+          else
+            echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2
+            exit 1
+          fi
+          pnpm test:qa:v28:pipeline-readback
+          pnpm --filter @bitcode/protocol typecheck
+          pnpm --filter @bitcode/protocol test
+          pnpm --filter @bitcode/btd typecheck
+          pnpm --filter @bitcode/btd test
+          npm --prefix protocol-demonstration test
+          npm --prefix protocol-demonstration run test:v28-mvp-qa
+          pnpm --filter @bitcode/pipeline-asset-pack typecheck
+          pnpm --filter @bitcode/pipeline-hosts typecheck
+          pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --passWithNoTests --forceExit
+          pnpm --filter @bitcode/pipeline-hosts exec jest --config jest.config.cjs --passWithNoTests --forceExit
+          pnpm --dir uapi exec jest --runTestsByPath \
+            tests/userDataRoute.test.ts \
+            tests/auxillariesWalletPane.test.tsx \
+            tests/auxillariesContent.access.test.tsx \
+            tests/auxillariesWorkspacePanels.access.test.tsx \
+            tests/auxillariesWorkspacePanels.test.tsx \
+            tests/api/auxillariesGithubConnectionRoute.test.ts \
+            tests/api/vcsRoutes.test.ts \
+            tests/auxillariesExternalsPane.test.tsx \
+            tests/profileStep.test.tsx \
+            tests/api/readReviewRoute.test.ts \
+            tests/api/pipelineHarnessRoute.test.ts \
+            tests/terminalPipelineHarnessClient.test.ts \
+            tests/terminalDepositReadWorkbench.test.ts \
+            tests/terminalTransactionQuery.test.ts \
+            tests/terminalTransactionReadModel.test.ts \
+            tests/terminalProtocolProjection.test.ts \
+            tests/terminalInterfaceIntegrationRegression.test.ts \
+            tests/terminalWalletBtcOperation.test.ts \
+            tests/terminalJournalReconciliation.test.ts \
+            tests/terminalOrganizationAuthority.test.ts \
+            tests/protocolCommercialBoundary.test.ts \
+            tests/terminalTransactionDetailCards.test.tsx \
+            tests/terminalTransactionDetailSnapshot.test.ts \
+            tests/terminalUxBrowserProof.test.tsx \
+            tests/bitcodeBrowserAccessibilityResponsiveProof.test.ts \
+            tests/pipelineExecutionLogHeader.test.tsx \
+            --runInBand
+          pnpm --dir uapi exec playwright install chromium --with-deps
+          pnpm --dir uapi run test:e2e:terminal-ux
+          pnpm --dir uapi run test:e2e:v32-browser-proof
+          git diff --check
+
+      - name: Promote V35 canon files
+        if: >-
+          ${{
+            github.event_name == 'pull_request' &&
+            github.event.pull_request.head.ref == 'version/v35'
+          }}
+        env:
+          HEAD_BRANCH: ${{ github.event.pull_request.head.ref }}
+        run: |
+          if [ "$(cat BITCODE_SPEC.txt)" = "V35" ]; then
+            echo "BITCODE_SPEC.txt already points to V35."
+            exit 0
+          fi
+          PROOF_SOURCE_COMMIT="$(git rev-parse HEAD)"
+          npm run promote:canon -- --version V35 --commit "$PROOF_SOURCE_COMMIT"
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add \
+            BITCODE_SPEC.txt \
+            BITCODE_SPEC_V35.md \
+            BITCODE_SPEC_V35_DELTA.md \
+            BITCODE_SPEC_V35_NOTES.md \
+            BITCODE_SPEC_V35_PARITY_MATRIX.md \
+            BITCODE_SPEC_V35_PROVEN.md \
+            protocol-demonstration/src/canon-posture.js \
+            protocol-demonstration/README.md \
+            packages/protocol/src/canon-posture.js \
+            packages/protocol/data/state.json \
+            packages/protocol/README.md \
+            .bitcode
+          git commit -m "Promote Bitcode canon to V35"
+          git push origin "HEAD:$HEAD_BRANCH"

.github/workflows/v35-canon-promotion.yml

@@ -663,6 +663,7 @@ V35 Gate 10 closes when `version/v35` can promote to active V35 without direct `
 The readiness report `.bitcode/v35-documentation-telemetry-promotion-readiness-report.json` proves that all V35 telemetry/documentation artifacts are present, source-safe, parseable, wired into gate checks, wired into promotion checks, generated proof appendix support, and workflow validation.
 Promotion rewrites runtime posture from `V34` active / `V35` draft to `V35` active / `V36` draft and generates `BITCODE_SPEC_V35_PROVEN.md`.
 The exact post-promotion readiness posture token is active V35 / draft V36.
+The promotion script validation token is V35 active / draft V36.
 
 ## V35 validation canon
 

BITCODE_SPEC_V35.md

@@ -58,6 +58,7 @@ Read the system as:
 - `TestnetRolloutReadinessGuide` carries contributor, local development, operator, enterprise reader, depositor, interface consumer, lane posture, wallet/settlement caveat, known blocker, and rehearsal evidence paths for local, staging-testnet, public testnet, mainnet-ready dry run, and blocked value-bearing mainnet use.
 - `TelemetryDocumentationInterfaceIntegration` binds Terminal, Auxillaries, API, MCP API, ChatGPT App, package READMEs, internal docs, and public docs to event ids, proof roots, docs links, runbook links, redaction posture, correlation ids, and source-safe interface payload boundaries.
 - `LocalStagingTelemetryDocumentationRehearsal` binds local and staging-testnet documentation discovery, telemetry event emission, dashboard/runbook lookup, docs QA, incident drill, source-safe proof-root review, redacted screenshot/log roots, and blocked value-bearing mainnet posture.
+- Gate 10: V35 Promotion Readiness closes `DocumentationTelemetryPromotionReadinessReport` with `.bitcode/v35-documentation-telemetry-promotion-readiness-report.json`, active V35 / draft V36 runtime posture preparation, generated proof appendix support, promotion workflow wiring, package test coverage, source-safe artifact coverage, and `check:v35-gate10`.
 - V35 public docs can expose measurements, proof posture, fee/right boundaries, setup steps, and known blockers; they cannot expose secrets, wallet private material, protected source, raw prompts containing protected data, or unpaid AssetPack source.
 - Gate 2 closes `DocumentationSurfaceCatalog` with `.bitcode/v35-documentation-surface-catalog.json`, `source-safe-documentation-surface-metadata`, package export `buildDocumentationSurfaceCatalog`, package test coverage, and `check:v35-gate2`.
 - Gate 3 closes `TelemetryTaxonomyCatalog` with `.bitcode/v35-telemetry-taxonomy-catalog.json`, `source-safe-telemetry-taxonomy-metadata`, package export `buildTelemetryTaxonomyCatalog`, package test coverage, redaction posture for every event family, ThricifiedGeneration inference telemetry boundaries, and `check:v35-gate3`.

BITCODE_SPEC_V35_NOTES.md

@@ -187,9 +187,9 @@ No `_legacy/` source is active source truth.
 
 | Requirement | Source evidence | Current V35 judgment |
 | --- | --- | --- |
-| Promotion readiness report planned | `DocumentationTelemetryPromotionReadinessReport` in V35 SPEC | drafted |
-| All telemetry/documentation artifacts covered | V35 Gate 10 acceptance criteria | drafted |
-| Runtime posture advances to V35 active / draft V36 | V35 SPEC, DELTA, and README promotion posture | drafted |
+| Promotion readiness report generated | `DocumentationTelemetryPromotionReadinessReport` source, `.bitcode/v35-documentation-telemetry-promotion-readiness-report.json`, package export, and package test coverage | closed |
+| All telemetry/documentation artifacts covered | Gate 10 readiness report covers V35 gate artifacts, generated proof outputs, workflows, source safety, and `pnpm run check:v35-gate10` | closed |
+| Runtime posture advances to V35 active / draft V36 | `scripts/promote-bitcode-canon.mjs`, `scripts/prepare-bitcode-spec-family-promotion.mjs`, `scripts/prepare-bitcode-runtime-canon-promotion.mjs`, and `.github/workflows/v35-canon-promotion.yml` | closed |
 
 ## V35 accepted boundaries
 

BITCODE_SPEC_V35_PARITY_MATRIX.md

@@ -109,9 +109,10 @@ run the version promotion workflow. For V35, promotion work must validate the
 telemetry/documentation posture, generate `BITCODE_SPEC_V35_PROVEN.md`, and
 commit promotion artifacts plus the `BITCODE_SPEC.txt` pointer change from
 `V34` to `V35` on the version branch.
-Gate 10 is the promotion-readiness gate. V35 Gate 10 will be wired through
+Gate 10 is the promotion-readiness gate. V35 Gate 10 is wired through
 `pnpm run check:v35-gate10`, backed by source-safe telemetry/documentation
-artifacts, a promotion readiness report, and a V35 canon-promotion workflow.
+artifacts, a promotion readiness report, and
+[v35-canon-promotion.yml](.github/workflows/v35-canon-promotion.yml).
 The promoted V34 closure remains reproducible through `pnpm run check:v34-gate10`
 and [v34-canon-promotion.yml](.github/workflows/v34-canon-promotion.yml).
 The application CI workflow uses the root pnpm workspace install, runs uapi

README.md

@@ -26,6 +26,7 @@
 - V35 Gate 7 closure anchor: telemetry/documentation depth now owns package-backed `TestnetRolloutReadinessGuide` source, deterministic `.bitcode/v35-testnet-rollout-readiness-guide.json`, `source-safe-rollout-guide-metadata`, contributor onboarding, local development, operator use, enterprise reader flow, depositor flow, interface consumer flow, environment lane posture, wallet/settlement caveats, known blockers, rehearsal evidence, local/staging-testnet/public-testnet/mainnet-ready dry-run/value-bearing-mainnet lane distinctions, visible blocked value-bearing mainnet posture, package tests, workflow wiring, and `check:v35-gate7`.
 - V35 Gate 8 closure anchor: telemetry/documentation depth now owns package-backed `TelemetryDocumentationInterfaceIntegration` source, deterministic `.bitcode/v35-telemetry-documentation-interface-integration.json`, `source-safe-interface-integration-metadata`, Terminal, Auxillaries, API, MCP API, ChatGPT App, package README, internal docs, and public docs integration rows, event ids, proof roots, docs links, runbook links, redaction posture, source-safe allowed payload fields, forbidden-data boundaries, package tests, workflow wiring, and `check:v35-gate8`.
 - V35 Gate 9 closure anchor: telemetry/documentation depth now owns package-backed `LocalStagingTelemetryDocumentationRehearsal` source, deterministic `.bitcode/v35-local-staging-telemetry-documentation-rehearsal.json`, `source-safe-rehearsal-metadata`, local and staging-testnet rehearsal rows, documentation discovery, telemetry event emission, dashboard/runbook lookup, docs QA, incident drills, source-safe proof-root review, redacted screenshot/log roots, visible blocked value-bearing mainnet posture, package tests, workflow wiring, and `check:v35-gate9`.
+- V35 Gate 10 closure anchor: telemetry/documentation depth now owns package-backed `DocumentationTelemetryPromotionReadinessReport` source, deterministic `.bitcode/v35-documentation-telemetry-promotion-readiness-report.json`, source-safe coverage for all V35 telemetry/documentation artifacts, `BITCODE_SPEC_V35_PROVEN.md` generation support, promotion command dry-run support, `v35-canon-promotion.yml`, active V35 / draft V36 posture preparation, package tests, workflow wiring, and `check:v35-gate10`.
 - Purpose: concise running index of Bitcode/ENGI specification history, current work, and planned work.
 
 This roadmap is not an active system specification.

SPECIFICATIONS_ROADMAP.md

@@ -181,6 +181,9 @@
     "generate:v35-local-staging-telemetry-documentation-rehearsal": "node scripts/generate-v35-local-staging-telemetry-documentation-rehearsal.mjs",
     "check:v35-local-staging-telemetry-documentation-rehearsal": "node scripts/generate-v35-local-staging-telemetry-documentation-rehearsal.mjs --check",
     "check:v35-gate9": "node scripts/check-v35-gate9-local-staging-telemetry-documentation-rehearsal.mjs",
+    "generate:v35-documentation-telemetry-promotion-readiness": "node scripts/generate-v35-documentation-telemetry-promotion-readiness-report.mjs",
+    "check:v35-documentation-telemetry-promotion-readiness": "node scripts/generate-v35-documentation-telemetry-promotion-readiness-report.mjs --check",
+    "check:v35-gate10": "node scripts/check-v35-gate10-promotion-readiness.mjs",
     "check:spec-quality": "node scripts/run-bitcode-spec-quality.mjs --mode basic",
     "check:spec-quality:title": "node scripts/run-bitcode-spec-quality.mjs --mode strict-from-title",
     "check:spec-quality:v24": "node scripts/run-bitcode-spec-quality.mjs --mode strict-version --version V24",