Merge pull request #176 from engineeredsoftware/v42/gate-7-ai-reading-demonstration-mvp

V42 Gate 7: AI-Reading Demonstration MVP

Author: geraldarthurdavis

.bitcode/v42-ai-reading-demonstration.json

@@ -521,7 +521,7 @@
       "passed": true
     },
     {
-      "id": "roadmap-advanced-to-gate6",
+      "id": "roadmap-records-gate6-closure",
       "sourcePath": "SPECIFICATIONS_ROADMAP.md",
       "passed": true
     },
@@ -583,5 +583,5 @@
     "failedPredicateIds": []
   },
   "passed": true,
-  "artifactRoot": "v42-settlement-rights-delivery:09c7a0fd5dd0b1952aa75eb9"
+  "artifactRoot": "v42-settlement-rights-delivery:6866f71624c147178c383189"
 }

.bitcode/v42-settlement-rights-delivery.json

@@ -310,6 +310,9 @@ jobs:
               if [ -f scripts/check-v42-gate6-settlement-rights-delivery.mjs ]; then
                 node scripts/check-v42-gate6-settlement-rights-delivery.mjs --skip-branch-check --skip-package-tests --skip-uapi-tests
               fi
+              if [ -f scripts/check-v42-gate7-ai-reading-demonstration.mjs ]; then
+                node scripts/check-v42-gate7-ai-reading-demonstration.mjs --skip-branch-check --skip-package-tests --skip-demonstration-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

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

@@ -439,6 +439,9 @@ jobs:
               if [ -f scripts/check-v42-gate6-settlement-rights-delivery.mjs ]; then
                 node scripts/check-v42-gate6-settlement-rights-delivery.mjs --skip-branch-check --skip-package-tests --skip-uapi-tests
               fi
+              if [ -f scripts/check-v42-gate7-ai-reading-demonstration.mjs ]; then
+                node scripts/check-v42-gate7-ai-reading-demonstration.mjs --skip-branch-check --skip-package-tests --skip-demonstration-tests
+              fi
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

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

@@ -157,6 +157,9 @@ Source-bearing AssetPack delivery remains withheld until payment, finality, BTD
 Gate 7 must update the standalone demonstration so it proves Bitcode's AI-reading value.
 The demonstration should show deposited non-public technical intelligence becoming an AssetPack that measurably improves an AI system's training, prompt/context, or evaluation performance beyond a public-data-only baseline.
 It must remain minimal, self-contained inside `protocol-demonstration/`, and independent from commercial product code.
+Gate 7 is implemented by `.bitcode/v42-ai-reading-demonstration.json`.
+The artifact binds the local public-data-only baseline, reviewed ReadNeed synthesis, local Depository Finding Fits, selected AssetPack preview, AssetPack-enhanced AI-reading answer, basis-point benchmark uplift, settlement-gated source-safety boundary, self-contained demonstration import boundary, demonstration tests, protocol tests, docs, package scripts, and workflow wiring.
+The accepted proof is an AI-reading AssetPack improvement: public-only assistance scores below the AssetPack-enhanced result, selected deposit provenance is explicit, protected source remains withheld before settlement, and the demonstration can run locally without product runtime imports.
 
 ## V42 Gate 8 Local And Staging-Testnet Full MVP Rehearsal
 

BITCODE_SPEC_V42.md

@@ -62,6 +62,7 @@ Gate 6 now binds settlement rights transfer through `AssetPackSettlementRightsDe
 ### Gate 7: AI-Reading Dominant Demonstration MVP
 
 Implement and prove the standalone demonstration where deposited technical intelligence improves an AI system beyond a public-data-only baseline.
+Gate 7 now binds the local AI-reading demonstration runtime, public-data-only baseline, reviewed Need, local Depository fit selection, source-safe AssetPack preview, AssetPack-enhanced answer, deterministic basis-point uplift, settlement-gated source boundary, `.bitcode/v42-ai-reading-demonstration.json`, and `check:v42-gate7`.
 
 ### Gate 8: Local And Staging-Testnet Full MVP Rehearsal
 
@@ -76,7 +77,7 @@ Bind every V42 product artifact, workflow, generated proof, promotion command, s
 - V43+ agentic deposit AssetPack option synthesis remains deferred.
 - `/terminal` is not split into `/read` and `/deposit` during V42.
 - `/exchange` is not renamed to `/packs` during V42.
-- V43+ must take the route-vocabulary cleanup seriously: `/packs` replaces Exchange as the searchable master-detail activity route, while `/read` and `/deposit` become the short core paths for buying and selling AssetPacks.
+- V43+ must take the route-vocabulary cleanup seriously: `/packs` replaces Exchange as the searchable master-detail activity route, including route names, component prefixes, tests, docs, and product vocabulary, while `/read` and `/deposit` become the short core paths for buying and selling AssetPacks.
 - Production-mainnet value-bearing operation remains blocked unless a later promoted canon explicitly admits it.
 - V42 Gate 1 does not change route behavior, pipeline behavior, settlement behavior, or demonstration behavior.
 

BITCODE_SPEC_V42_DELTA.md

@@ -81,6 +81,8 @@ Protected source, private settlement payloads, wallet private material, raw prot
 The standalone demonstration should prove why Bitcode matters for AI-dominant Reading.
 A deposited proprietary or otherwise non-public technical intelligence source should contribute to an AssetPack that measurably improves an AI system's training, prompt/context, or evaluation result beyond what a public-data-only baseline can do.
 The demonstration must remain minimal, local, deterministic where feasible, and self-contained inside `protocol-demonstration/`.
+Gate 7 records that proof as a public-data-only baseline, a reviewed local Need, a local Depository Finding Fits step, a selected AssetPack preview, an AssetPack-enhanced AI-reading answer, and deterministic benchmark uplift.
+The demonstration proves value without weakening the settlement-gated visibility boundary: protected source is still withheld until settlement, and the demonstration remains independent from product runtime imports.
 
 ## V43+ agentic depositing roadmap note
 
@@ -93,7 +95,7 @@ The `/packs` master view should support column sorting, filtering, and search ov
 The detail view should expose the selected activity's source-safe data, proof roots, telemetry, ledger/database synchronization, and expandable payloads without replacing the short default path.
 Outside public documentation, product UX should avoid self-referential explanatory copy; route structure, concise labels, progressive detail, and proof-on-expand must make Depositing, Reading, and Pack activity self-explanatory.
 The current transitional Terminal/Exchange UX remains too dense for the final MVP posture.
-V43+ should explicitly own the broad UX cleanup: remove Exchange naming from route and component vocabulary in favor of Packs, split Terminal into `/read` and `/deposit`, keep `/packs` as searchable master-detail activity, and use rich themed reusable components without relying on in-product explanatory copy to compensate for unclear flows.
+V43+ route vocabulary must remove Exchange naming from route and component prefixes in favor of Packs, split Terminal into `/read` and `/deposit`, keep `/packs` as searchable master-detail activity, and use rich themed reusable components without relying on in-product explanatory copy to compensate for unclear flows.
 
 ## Concise current-system reading
 

BITCODE_SPEC_V42_NOTES.md

@@ -38,7 +38,7 @@ This matrix records the reliable MVP product surfaces that must become promotion
 | ReadNeed product closure | Need synthesis, review, feedback, resynthesis, accepted-Need admission, rejected Need blockers, source-safe telemetry, and Terminal runtime readback are product-ready | `.bitcode/v42-readneed-review-resynthesis-product-closure.json`, `ReadNeedReviewResynthesisRuntime`, `/api/read-review`, Terminal Need runtime readback | implemented |
 | Finding Fits preview and quote | Many-candidate search, selected-fit provenance, source-safe preview, and quote are product-ready | `.bitcode/v42-readfitsfinding-preview-quote.json`, `ReadFitsFindingRuntime`, `AssetPackPreviewBoundary`, harness preview summary, Terminal preview/quote/provenance readback | implemented |
 | Settlement and delivery | BTC/BTD settlement, rights transfer, compensation, and repository PR delivery are synchronized | `.bitcode/v42-settlement-rights-delivery.json`, `AssetPackSettlementRightsDeliveryBoundary`, live harness settlement boundary, route summary, Terminal settlement readback | implemented |
-| AI-reading demonstration | Standalone demonstration proves AssetPack improves AI beyond public-data-only baseline | later V42 Gate 7 artifact | draft-required |
+| AI-reading demonstration | Standalone demonstration proves AssetPack improves AI beyond public-data-only baseline | `.bitcode/v42-ai-reading-demonstration.json`, `protocol-demonstration/src/ai-reading-demonstration.js`, `test:v42-ai-reading-mvp` | implemented |
 | Local/staging rehearsal | Full MVP path rehearsed locally and in staging-testnet with mainnet blocked | later V42 Gate 8 artifact | draft-required |
 | Promotion readiness | V42 proof and workflow promotion ready | later V42 Gate 9 artifact | draft-required |
 
@@ -52,7 +52,7 @@ This matrix records the reliable MVP product surfaces that must become promotion
 | Gate 4 | ReadNeed review and resynthesis product closure artifact | implemented |
 | Gate 5 | ReadFitsFinding AssetPack preview and quote closure artifact | implemented |
 | Gate 6 | Settlement rights transfer and repository delivery closure artifact | implemented |
-| Gate 7 | AI-reading dominant demonstration MVP artifact | draft-required |
+| Gate 7 | AI-reading dominant demonstration MVP artifact | implemented |
 | Gate 8 | Local and staging-testnet full MVP rehearsal artifact | draft-required |
 | Gate 9 | Promotion readiness artifact and workflow | draft-required |
 

BITCODE_SPEC_V42_PARITY_MATRIX.md

@@ -127,6 +127,14 @@ pull-request delivery only after paid readback agrees. Route summaries and
 Terminal detail remain source-safe metadata: unpaid AssetPack source, wallet
 private material, private settlement payloads, credentials, raw protected
 prompts, and raw provider responses are withheld.
+V42 Gate 7 adds the AI-reading dominant demonstration MVP with
+`protocol-demonstration/src/ai-reading-demonstration.js`,
+`.bitcode/v42-ai-reading-demonstration.json`, and `check:v42-gate7`.
+It compares a public-data-only AI remediation answer against an
+AssetPack-enhanced answer after a reviewed local Need and local Finding Fits
+step select the deposited runbook AssetPack. The benchmark uplift is
+deterministic, the demonstration stays self-contained, and protected source
+remains withheld before settlement.
 V43+ is roadmapped as the later agentic depositing evolution: repository
 agents synthesize deposit AssetPack options from connected enterprise code,
 Depository state, and Reading demand; enterprises approve or reject
@@ -806,4 +814,5 @@ Demonstration verification:
 cd protocol-demonstration
 pnpm test:integration
 pnpm test:v28-mvp-qa
+pnpm test:v42-ai-reading-mvp
 ```