Skip to content

V34 Canonical Promotion: Deployment Depth#87

Merged
geraldarthurdavis merged 23 commits into
mainfrom
version/v34
May 24, 2026
Merged

V34 Canonical Promotion: Deployment Depth#87
geraldarthurdavis merged 23 commits into
mainfrom
version/v34

Conversation

@geraldarthurdavis

Copy link
Copy Markdown
Contributor

Summary

  • promotes V34 deployment depth after all ten V34 gates have closed into version/v34
  • carries deployment host capability, environment lane, distributed runtime, storage, secret rotation, migration CI/CD, observer/repair, rollback/upgrade, staging-testnet rehearsal, and promotion-readiness proof coverage
  • relies on the V34 promotion workflow to run promotion-grade validation and commit the standalone canonical pointer/proven updates only after the validations pass

Promotion Evidence

  • Gate 10 PR V34 Gate 10: Promotion Readiness #86 is merged and green
  • local dry run: node scripts/promote-bitcode-canon.mjs --version V34 --commit HEAD --dry-run
  • Gate 10 branch validation included focused BTD test, pnpm run check:v34-gate10, diff hygiene, and changed-file secret-shaped marker scan

Notes

  • packages/agent-generics/src/steps/factories.ts remains an unrelated local dirty file and is not part of this promotion PR.

Open the V34 deployment-depth specification family over promoted V33 canon, including SPEC, DELTA, NOTES, and PARITY content for host capabilities, environment lanes, distributed execution receipts, storage posture, secret rotation, approval gates, repair jobs, rehearsal, and promotion readiness.

Refresh roadmap, root/protocol/demonstration docs, PR template, package script, and gate/canon workflows for V33 active / V34 draft posture.

Add check:v34-gate1 through scripts/check-v34-gate1-deployment-roadmap-opening.mjs to fail closed on stale posture, missing deployment vocabulary, missing gate plan, workflow drift, and versioned API routes.

Proof: node scripts/check-bitcode-spec-family.mjs --version V34 --mode draft --current-target V33; node scripts/check-bitcode-canonical-inputs.mjs --current-target V33; node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V33 --draft-target V34; pnpm run check:v34-gate1; git diff --check.
…roadmap-opening

V34 Gate 1: Deployment Roadmap And Spec Opening
Adds package-owned DeploymentHostCapabilityCatalog and EnvironmentLaneContract builders for website, API, MCP API, ChatGPT App, workers, observers, broadcasters, proof services, repair jobs, object storage, database projection, ledger projection, and environment lanes.

Generates source-safe V34 host/lane artifacts, wires Gate 2 checks into package scripts and gate-quality workflow, updates V34 spec/roadmap parity, and covers value-bearing mainnet as blocked_future_canon_required.

Validation: pnpm run check:v34-gate2; pnpm run check:v34-gate1; pnpm --filter @bitcode/btd typecheck; pnpm --filter @bitcode/btd test; pnpm --filter @bitcode/protocol test; node scripts/check-bitcode-spec-family.mjs --version V34 --mode draft --current-target V33; node scripts/check-bitcode-canonical-inputs.mjs --current-target V33; node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V33 --draft-target V34; node scripts/check-v33-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check; git diff --check
…lity-environment-lanes

V34 Gate 2: Host Capability And Environment Lane Catalog
Close the distributed execution runtime contract gate by adding package-owned receipt types, fixtures, source-safety validation, and focused Jest coverage for pipeline runs, PTRR agents, ThricifiedGenerations, tools, ledger operations, wallet operations, proof generation, object-storage writes, and repair jobs.

Generate the source-safe V34 distributed execution runtime receipts artifact, wire freshness checks and gate-quality workflow coverage, update V34 spec family parity, and refresh earlier Gate 2 artifact digests after the spec evidence changed.

Validation run locally: pnpm run check:v34-gate1; pnpm run check:v34-gate2; pnpm run check:v34-gate3; pnpm run check:v34-distributed-execution-runtime-receipts; pnpm --filter @bitcode/pipeline-hosts typecheck; pnpm --filter @bitcode/pipeline-hosts test; pnpm --filter @bitcode/btd test -- --runTestsByPath __tests__/deployment-host-capability-catalog.test.ts; pnpm --filter @bitcode/protocol test; node scripts/check-bitcode-spec-family.mjs --version V34 --mode draft --current-target V33; node scripts/check-bitcode-canonical-inputs.mjs --current-target V33; node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V33 --draft-target V34; node scripts/check-v33-gate10-promotion-readiness.mjs --promotion-mode --skip-branch-check; git diff --check.
…-execution-runtime-contracts

V34 Gate 3: Distributed Execution Runtime Contracts
Add package-owned DeploymentStoragePosture carriers for ledger-derived state, database projections, protected and source-safe object storage, proof artifacts, audit logs, rollback material, and encrypted backups.

Generate the V34 storage posture artifact, wire the gate checker into scripts and CI, update V34 specs/parity/roadmap, and refresh prior V34 artifact digests after spec edits.

Proof: pnpm run check:v34-gate2; pnpm run check:v34-gate3; pnpm run check:v34-gate4; pnpm --filter @bitcode/btd typecheck; pnpm --filter @bitcode/btd test; pnpm --filter @bitcode/protocol test; pnpm --filter @bitcode/protocol typecheck; node scripts/check-bitcode-spec-family.mjs --version V34 --mode draft --current-target V33; git diff --check.
…base-object-storage-posture

V34 Gate 4: Ledger Database Object Storage Deployment Posture
Add the package-owned SecretRotationPlan contract for OpenAI, Supabase, Vercel, GitHub, wallet, object storage, webhook, MCP, and ChatGPT App credential families.

Generate and validate the source-safe V34 secret rotation artifact, wire Gate Quality and V34 specifying inputs, and refresh prior V34 artifact digests after spec-family updates.

Validated with check:v34-gate2, check:v34-gate3, check:v34-gate4, check:v34-gate5, V34/V33 spec checks, @bitcode/btd typecheck/test, @bitcode/protocol typecheck/test, and diff hygiene.
…tion-credential-boundaries

V34 Gate 5: Secret Rotation Boundary Operations
Adds package-owned MigrationApprovalGate coverage for schema migration approval, generated type refresh, route scans, build/test gates, generated artifact freshness, Vercel/Supabase lane checks, and promotion commit approval.

Generates the source-safe Gate 6 artifact, wires gate-quality checks, updates V34 specifications and roadmap, and keeps earlier V34 artifact digests current.
…icd-approval-gates

V34 Gate 6: Migration CI/CD Approval Gates
Adds the RuntimeObserverRepairJob contract for settlement observers, ledger broadcasters, finality watchers, projection repair, object-storage repair, generated proof jobs, and queue consumers.

Generates the source-safe V34 observer/broadcaster/repair artifact, wires Gate Quality, updates V34 spec parity, and proves fail-closed runtime receipt, lane, replay, repair, unsafe drift, and secret-serialization coverage.
…ervers-broadcasters-repair-jobs

V34 Gate 7: Runtime Observers Broadcasters Repair Jobs
Defines the package-owned RollbackUpgradeRepairPlaybook contract for rollback, upgrade, migration rollback, object-storage repair, database repair, ledger projection repair, secret rotation incident response, and generated artifact repair.

Adds source-safe generated artifact and checker coverage, wires Gate Quality and the canonical generated-artifact allowlist, advances V34 docs and roadmap to Gate 9, and keeps prior V34 artifact roots current after spec/workflow changes.

Validation: pnpm --filter @bitcode/btd typecheck; pnpm --filter @bitcode/btd test; pnpm --filter @bitcode/protocol typecheck; pnpm --filter @bitcode/protocol test; pnpm run check:v34-gate2; pnpm run check:v34-gate3; pnpm run check:v34-gate4; pnpm run check:v34-gate5; pnpm run check:v34-gate6; pnpm run check:v34-gate7; pnpm run check:v34-gate8; spec-family/canon posture checks; git diff --check; git diff --cached --check.
…grade-data-repair-playbooks

V34 Gate 8: Rollback Upgrade Data Repair Playbooks
Define DeploymentReadinessRehearsal as the package-owned contract for local full-stack, staging-testnet full-stack, and value-bearing mainnet blocked rehearsal coverage.

Generate the source-safe rehearsal proof artifact, wire package exports, gate scripts, workflow checks, and generated-artifact allowlisting.

Update the V34 spec family and roadmap to close Gate 9 and advance the draft to Gate 10 promotion readiness.

Proof: pnpm --filter @bitcode/btd typecheck; pnpm --filter @bitcode/btd test; pnpm run check:v34-gate2 through check:v34-gate9; protocol typecheck/test; spec-family/canonical/posture checks; Terminal browser proof; responsive browser proof. Live staging readback reached tkpyosihuouusyaxtbau but has no recent pipeline/ledger rows.
…ng-testnet-deployment-rehearsal

V34 Gate 9: Local Staging Testnet Deployment Rehearsal
Adds the DeploymentPromotionReadinessReport primitive, V34 promotion-readiness generator and checker scripts, promotion workflow wiring, protocol proof generation support, refreshed V34 deployment artifacts, and Gate 10 specification/parity documentation. Validated the focused BTD test, diff hygiene, changed-file secret scan, and the V34 Gate 10 checker.
…readiness

V34 Gate 10: Promotion Readiness
@geraldarthurdavis
geraldarthurdavis requested a review from a team May 23, 2026 23:00
@vercel

vercel Bot commented May 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
engi-uapi Ready Ready Preview, Comment May 24, 2026 12:43am

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3cb6f256c8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

V30: { activeCanon: 'V30', draftTarget: 'V31' },
V31: { activeCanon: 'V31', draftTarget: 'V32' },
V32: { activeCanon: 'V32', draftTarget: 'V33' },
V33: { activeCanon: 'V33', draftTarget: 'V34' },

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Add V34 posture mapping for promoted canonical pointer

The supported-pointer map stops at V33, so after the V34 promotion flow rewrites BITCODE_SPEC.txt to V34, expectedPostureByPointer[pointer] becomes undefined and the assertion immediately fails. This makes the protocol boundary test fail in the promoted state (e.g., with pointer set to V34, this test errors with “Unsupported canonical pointer”), which can block post-promotion CI on the same branch.

Useful? React with 👍 / 👎.

Teach runtime canon promotion to rewrite the current inline demonstration README posture so promoted V34/V35 drift checks see the standalone pointer and generated appendix sentence. Tighten the regression fixture and refresh the V34 promotion-readiness artifact digest.

Proof: npm --prefix protocol-demonstration test -- --test-name-pattern "runtime promotion preparation rewrites current inline demonstration README posture"; pnpm run check:v34-gate10; git diff --check.
…readme-posture-repair

V34 Gate 10: Promotion README Posture Repair
@geraldarthurdavis
geraldarthurdavis merged commit d9cb3e7 into main May 24, 2026
8 checks passed
@geraldarthurdavis
geraldarthurdavis deleted the version/v34 branch May 24, 2026 00:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant