Promote Bitcode canon to V28 (#19)

* Implement staged Read Need-Fit boundary

* Document gate branch contribution workflow

* Repair Gate 3 quality and promotion workflows

* Stabilize Gate 3 CI checks

* Harden long-runner image workflow

* Build local ESLint plugin in CI

* Satisfy long-runner workflow shell lint

* Track SVG module declarations for CI

* Provide inert Supabase env for CI builds

* Cover Supabase server env in CI builds

* Expose public Supabase env to Next builds

* Resolve Supabase public env aliases consistently

* Inline Supabase public aliases for CI builds

* Provide CI-safe Supabase client fallback

* Allow ORM build checks without Supabase secrets

* Track Jest resolver mocks for CI

* Implement staged Read-Need Fit gate

* Stabilize mock cache verification

* Gate 5 journal reconciliation detail

* Gate 6 registry access policy

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.

* Gate 7 reading pipeline coverage criteria

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.

* Gate 7 Terminal operational readiness

* Gate 7 reading pipeline PTRR coverage

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.

* Harden Reading inference parsing

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.

* Close Gate 7 Reading validation evidence

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.

* Align Gate 7 staging parity closure

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.

* Gate 8 harden V28 promotion workflow

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.

* Gate 9 project depository evidence through Reading

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.

* Gate 10 close Read-Need comprehension

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.

* Gate 10 align Reading pipeline names

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.

* Close Gate 11 Finding Fits preview

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.

* Close Gate 12 settlement rights delivery

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.

* Close V28 gate 13 promotion readiness

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.

* Repair V28 promotion closure checks

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.

* Promote Bitcode canon to V28

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: geraldarthurdavis

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

@@ -20,11 +20,14 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Run Bitcode spec-quality basics
-        run: node scripts/run-bitcode-spec-quality.mjs --mode basic
+      - name: Validate active canon and V28 draft posture
+        run: |
+          node scripts/check-bitcode-canonical-inputs.mjs --current-target V27
+          node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V27 --draft-target V28
+          node scripts/check-bitcode-spec-family.mjs --version V28 --mode draft --current-target V27
 
-  bitcode-full:
-    name: Bitcode Full Test Suite
+  bitcode-demonstration-mvp:
+    name: Bitcode Demonstration MVP
     runs-on: ubuntu-latest
     needs: bitcode-spec-basics
     container:
@@ -34,8 +37,8 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Run full Bitcode protocol-demonstration suite
-        run: npm --prefix protocol-demonstration run test
+      - name: Run V28 protocol-demonstration MVP QA
+        run: npm --prefix protocol-demonstration run test:v28-mvp-qa
 
   bitcode-spec-commit-conformance:
     name: Bitcode Spec Commit Conformance
@@ -50,5 +53,13 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Run strict spec conformance for `spec: VN` titles
-        run: node scripts/run-bitcode-spec-quality.mjs --mode strict-from-title --commit-title "$SPEC_TITLE"
+      - name: Run V28 strict draft conformance for spec-title changes
+        run: |
+          case "$SPEC_TITLE" in
+            spec:\ V28*|spec:\ v28*)
+              node scripts/check-bitcode-spec-family.mjs --version V28 --mode draft --current-target V27
+              ;;
+            *)
+              echo "Skipping strict spec-title conformance; title is not a V28 spec change."
+              ;;
+          esac

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

@@ -0,0 +1,91 @@
+name: Bitcode Gate Quality
+
+on:
+  push:
+    branches:
+      - "v*/gate-*"
+      - "version/**"
+  pull_request:
+    branches:
+      - "version/**"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  gate-quality:
+    name: Gate Quality
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - 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 draft canon posture
+        run: |
+          test "$(cat BITCODE_SPEC.txt)" = "V27"
+          node scripts/check-bitcode-spec-family.mjs --version V28 --mode draft --current-target V27
+          node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V27 --draft-target V28
+          node scripts/check-bitcode-canonical-inputs.mjs --current-target V27
+          node scripts/check-v28-metadevelopment-readiness.mjs --skip-branch-check
+          node scripts/check-v28-gate9-depository-evidence.mjs
+          node scripts/check-v28-gate10-read-need-comprehension.mjs
+          node scripts/check-v28-gate11-read-fits-finding-preview.mjs
+          node scripts/check-v28-gate12-settlement-rights-delivery.mjs
+          node scripts/check-v28-gate13-product-closure-promotion-readiness.mjs
+          node scripts/promote-bitcode-canon.mjs --version V28 --commit HEAD --dry-run
+
+      - name: Validate source casing and imports
+        run: |
+          bash scripts/find-uppercase-raw-promptparts.sh
+          bash scripts/check-import-casing.sh
+
+      - name: Type-check gate packages
+        run: |
+          pnpm --filter @bitcode/btd typecheck
+          pnpm --filter @bitcode/pipeline-asset-pack typecheck
+          pnpm --filter @bitcode/pipeline-hosts typecheck
+
+      - name: Test gate packages
+        run: |
+          pnpm --filter @bitcode/btd test
+          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
+
+      - name: Test staged Reading route and Terminal harness contracts
+        run: |
+          pnpm --dir uapi exec jest --runTestsByPath \
+            tests/api/readReviewRoute.test.ts \
+            tests/api/pipelineHarnessRoute.test.ts \
+            tests/terminalPipelineHarnessClient.test.ts \
+            tests/terminalDepositReadWorkbench.test.ts \
+            tests/pipelineExecutionLogHeader.test.tsx \
+            --runInBand
+
+      - name: Test pipeline readback verifier
+        run: pnpm test:qa:v28:pipeline-readback
+
+      - name: Test protocol demonstration
+        run: |
+          npm --prefix protocol-demonstration test
+          npm --prefix protocol-demonstration run test:v28-mvp-qa
+
+      - name: Check diff hygiene
+        run: git diff --check