Skip to content

Promote Bitcode canon to V28#19

Merged
geraldarthurdavis merged 47 commits into
mainfrom
version/v28
May 20, 2026
Merged

Promote Bitcode canon to V28#19
geraldarthurdavis merged 47 commits into
mainfrom
version/v28

Conversation

@geraldarthurdavis

Copy link
Copy Markdown
Contributor

Summary

  • promotes the completed V28 version branch into the protected main promotion path
  • triggers the V28 Canon Promotion workflow, which validates all Gate 9-13 closure checks plus promotion-grade package, UAPI, demonstration, and readback checks
  • lets the workflow produce the standalone canon promotion commit that advances BITCODE_SPEC.txt to V28 and generates V28 proof artifacts only after validation passes

Promotion source

  • version branch: version/v28
  • proof-source commit before automated promotion: 4bb9667

Local validation before PR

  • pnpm run check:v28-gate13
  • node scripts/promote-bitcode-canon.mjs --version V28 --commit HEAD --dry-run

Notes

  • No manual deployment was run. Any Vercel preview activity is the repository's automatic PR integration.
  • Staging-testnet Data API readback evidence is recorded in BITCODE_V28_QA.md from Gate 13.

…ng-need-fit

Gate 3: Implement staged Read Need-Fit boundary
…t-settlement

Gate 4: staged Read-Need Fit settlement
Merge Gate 5 into the V28 version branch after repository-owned gate quality, CI, spec, demonstration, docs, UI SSOT, and casing/import checks passed. External Vercel contexts for engi and legacy-engi remain failing while engi-uapi passed; those contexts are not changed by this gate.
Derive organization BTD posture from registry ownership and read-license rows, require owner-read or licensed-read evidence for MCP and ChatGPT App write admission, and cover the registry access-policy templates in BTD tests.

Keep Terminal-facing copy on registry, range, ownership, license, and proof posture without price-appreciation, dividend, copyright-transfer, or marketplace-royalty framing.
Add the focused Read-Need and Need-Fit test contract to the V28 gate criteria, including typed phase/agent/tool/step/substep mock requirements and the rule that specification, tests, and core algorithmic design must move together.
Specify the ReadNeedComprehensionSynthesis and ReadFindingFitsSynthesis contracts with PTRR agents, ThricifiedGeneration ids, prompt registry metadata, and V28 parity/QA coverage.

Implement bounded ThricifiedGeneration telemetry for Reading inference, source-safe Finding Fits admission, richer pipeline harness stream metadata, and default Terminal visibility for the five enterprise Reading steps.

Expand asset-pack, harness, protocol, and UAPI tests for Read-Need synthesis, Finding Fits discovery, source-safe preview, stream telemetry, and local Terminal browser/build readiness.
Normalize common real-model response variance in Reading inference outputs while keeping PTRR ThricifiedGeneration telemetry typed and auditable.

Coerce scalar list fields into arrays and fail closed on nonnumeric confidence or quality labels returned by live OpenAI runs so local staging Read-Need synthesis can complete without weakening the contract.
Update the V28 parity matrix and QA ledger with current local OpenAI, Terminal browser, REST readback, and DB readback validation for the Reading pipelines.

Mark the bounded ReadNeedComprehensionSynthesis and ReadFindingFitsSynthesis gate surfaces closed where the source-bound staging-testnet verifier now proves telemetry, Finding Fits, AssetPack delivery, settlement, and ledger/database synchronization.
Carry the verified source-bound Reading run back into the high-level V28 staging parity rows so Fit-finding, pipeline runtime, telemetry, BTC fee, ledger, and database readback no longer contradict the detailed Gate 7 closure evidence.

Leave unrelated V28 promotion blockers, including MCP/ChatGPT parity and broad ledgerized model-selection cleanup, explicitly outside this gate closure.
…n-access-policy

Gate 6 registry access policy
Resolve Gate 6 to Gate 7 conflicts after registry access policy landed on version/v28.

The resolution preserves Gate 7's BTD exports and Jest module mappers while adopting Gate 6's BTD typecheck script and newer Jest dependency ranges. The lockfile remains frozen-consistent.
…eline-coverage

Gate 7 reading pipeline coverage criteria
Adds V28 metadevelopment readiness checks, wires gate and promotion workflows to the canonical promotion plan, and extends promotion scripts for the root Bitcode V28 spec family.

Documents Gate 8 as the repository metadevelopment closure, adds the product-gate carryforward audit, and removes active broad model selection from ledgerized Reading posture.

Aligns the current spec-quality runner with the V27-to-V28 transition: V27 remains active-canon input/posture checked while V28 owns appendix-grade draft and promotion validation.
Adds deposited-source evidence roots, lexical/vector search document roots, depositor wallet boundary projection, Terminal readback rows, and Read/Fit harness deposit-root propagation for the V28 Gate 9 depository evidence gate.

Documents the Gate 9 closure contract, adds a Supabase QA readback query, extends focused protocol/pipeline/Terminal tests, and wires the gate-quality workflow to the new V28 Gate 9 readiness check.
…evidence

Gate 9 project depository evidence through Reading
Adds the typed bitcode.read.request record inside Read-Needs, preserves feedback and previous-Need lineage during resynthesis, and exposes ReadNeedComprehensionSynthesis contract traces through route telemetry.

Updates Terminal gating so accepted Read-Need truth is recorded with Finding Fits admission evidence, adds focused package and route coverage, and wires the Gate 10 readiness check into V28 gate quality.
Rename the second Reading pipeline and dependent contract fields to ReadFitsFindingSynthesis, including route payloads, Terminal harness types, QA text, and gate checks.

Move the concrete ReadFitsFindingSynthesis PTRR agent files and runtime registry keys under prefixed names so setup, read-comprehension, and AssetPack synthesis identifiers match the V28 pipeline contract.
…comprehension

Gate 10: close Read-Need comprehension
Implements canonical ReadFitsFindingSynthesis tool telemetry for lexical and vector depository search posture, propagates accepted Need plus Finding Fits evidence into source-safe AssetPack previews, and exposes the deterministic Share-to-Fee quote through the postprocessed output.

Adds Gate 11 specification, parity, QA, workflow, and package checks, with tests covering all qualifying fit deposits, canonical tool telemetry, preview storage, fee quotes, and protected-source non-disclosure before settlement.
…finding-preview

Gate 11: close Finding Fits preview
Adds the settlement-unlock primitive for protected AssetPack source visibility, wires settlement/read-license/readback evidence into the sandbox harness and Terminal stream surfaces, and documents the Gate 12 closure contract.

Extends V28 gate quality checks to cover the new settlement closure script plus BTD primitive typecheck/test coverage.
…-rights-delivery

Close Gate 12 settlement rights delivery
Add the Gate 13 product-closure readiness check, wire it into gate and promotion workflows, and expand the V28 promotion dry-run command plan.

Align the full protocol demonstration proof suite with the current proof catalog and active-canon posture, including the deposit-to-read-fit enum and superseded V26 readiness assertions.

Harden staging-testnet readback validation with bounded DB audits, Data API evidence, updated QA/spec notes, and verifier coverage for the single-client DB path.
…osure-promotion-readiness

Close V28 gate 13 promotion readiness
@geraldarthurdavis
geraldarthurdavis requested a review from a team May 20, 2026 14:41
@vercel

vercel Bot commented May 20, 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 20, 2026 3:07pm

@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: 4bb9667ec1

ℹ️ 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".

Comment on lines +283 to +286
async function validateAuthenticatedContext(
context: MCPAuthContext,
options: MCPAuthOptions = {}
): AuthResult {
): Promise<AuthResult> {

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 Await async auth validation to preserve error wrapping

Converting validateAuthenticatedContext to async means it can now reject when validateRequiredReadAccess hits a registry/query error, but authenticateMCPRequest still returns this promise directly (return validateAuthenticatedContext(...)) instead of awaiting it. In that flow, rejections bypass the surrounding try/catch, so callers can receive an unhandled exception instead of the expected structured AuthResult (INTERNAL_ERROR). Please either await the call sites or handle errors inside this function so auth failures remain deterministic.

Useful? React with 👍 / 👎.

Reconciles V28 parity rows that were still carrying draft-era or pending judgments so promoted spec-family validation can close cleanly. Updates the runtime canon promotion script to rewrite the current inline demonstration README posture, and adds a regression test for that README form.

Validated with V28 draft spec-family check, V27/V28 canon posture drift check, v22 canon drift node test, V28 promotion dry run, Gate 13 readiness check, and a clean temporary promoted-worktree simulation through canonical inputs, promoted spec-family, canon posture drift, generated PROVEN check, and diff hygiene.
@geraldarthurdavis geraldarthurdavis self-assigned this May 20, 2026
@geraldarthurdavis
geraldarthurdavis merged commit 7a7e1e1 into main May 20, 2026
6 checks passed
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