V42 Gate 6: Close settlement rights delivery

Implement the paid AssetPack settlement boundary through the live harness, route summaries, and Terminal readback. Add the V42 settlement-rights proof artifact, protocol exports, gate checker, workflow wiring, and documentation updates for BTC payment observation, BTD rights transfer, source-to-shares compensation, reconciliation, and repository delivery unlock.

Validation: pnpm run check:v42-gate6; pnpm -C uapi exec tsc --noEmit --pretty false; pnpm -C uapi lint; pnpm --filter @bitcode/protocol test; git diff --check; changed-file value-marker secret scan.

Author: geraldarthurdavis

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

@@ -307,6 +307,9 @@ jobs:
               if [ -f scripts/check-v42-gate5-readfitsfinding-preview-quote.mjs ]; then
                 node scripts/check-v42-gate5-readfitsfinding-preview-quote.mjs --skip-branch-check --skip-package-tests --skip-uapi-tests
               fi
+              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
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

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

@@ -436,6 +436,9 @@ jobs:
               if [ -f scripts/check-v42-gate5-readfitsfinding-preview-quote.mjs ]; then
                 node scripts/check-v42-gate5-readfitsfinding-preview-quote.mjs --skip-branch-check --skip-package-tests --skip-uapi-tests
               fi
+              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
             fi
           else
             echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

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

@@ -148,6 +148,9 @@ The artifact binds the accepted-Need gate, many-channel Depository search, candi
 Gate 6 must make purchase and delivery reliable.
 The accepted user path is: review the AssetPack preview, choose to buy, receive settlement instructions, observe BTC/testnet settlement in the admitted lane, transfer BTD rights to the Reader, unlock source-bearing AssetPack delivery, and create the repository pull request.
 It must prove ledger/database/object-storage synchronization, delivery locks, no pre-settlement source leakage, compensation accounting, repair actions, and operator readback.
+Gate 6 is implemented by `.bitcode/v42-settlement-rights-delivery.json`.
+The artifact binds `AssetPackSettlementRightsDeliveryBoundary`, `AssetPackSettlementPaymentObservation`, confirmed BTC/testnet finality, `BtdRightsTransferReceipt`, `BtdReadReceipt`, `SourceToSharesProof`, `AssetPackDeliveryUnlockReceipt`, ledger/database/object-storage reconciliation, live harness materialization, source-safe route summaries, and Terminal settlement rights readback.
+Source-bearing AssetPack delivery remains withheld until payment, finality, BTD rights transfer, source-to-shares compensation conservation, reconciliation readback, and pull-request delivery all agree.
 
 ## V42 Gate 7 AI-Reading Dominant Demonstration MVP
 

BITCODE_SPEC_V42.md

@@ -57,6 +57,7 @@ Gate 5 now binds `ReadFitsFindingRuntime`, many-channel Depository search, `Asse
 ### Gate 6: Settlement Rights Transfer And Repository Delivery Closure
 
 Implement and prove purchase, settlement observation, BTD rights transfer, source unlock, repository pull request delivery, compensation accounting, and repair posture.
+Gate 6 now binds settlement rights transfer through `AssetPackSettlementRightsDeliveryBoundary` to the live harness, route summary, Terminal readback, source-to-shares conservation, BTD read/right receipts, and ledger/database/object-storage reconciliation through `.bitcode/v42-settlement-rights-delivery.json`.
 
 ### Gate 7: AI-Reading Dominant Demonstration MVP
 

BITCODE_SPEC_V42_DELTA.md

@@ -69,6 +69,13 @@ Selected-fit provenance carries selected candidate ids, fit deposit ids, query a
 `AssetPackPreviewBoundary` is the review object before payment: it contains the source-safe preview, deterministic quote receipt, disclosure review, settlement instructions, delivery lock, storage projection, replay receipt, and repair posture.
 The route and Terminal readback expose those fields as metadata only; protected source and unpaid AssetPack source remain absent until Gate 6 settlement, rights transfer, and delivery unlock.
 
+## Gate 6 implementation notes
+
+Gate 6 closes the paid settlement and source-bearing delivery boundary.
+`AssetPackSettlementRightsDeliveryBoundary` is the reviewable post-payment object: it records BTC payment observation, confirmed finality, source-to-shares compensation, BTD read and rights transfer receipts, settlement unlock, source-bearing pull-request delivery unlock, ledger/database/object-storage reconciliation, storage projection, replay receipt, and repair posture.
+The live Vercel Sandbox harness materializes this boundary after ledger readback, the route summarizes it as source-safe metadata, and Terminal renders settlement rights, source-to-shares compensation, delivery unlock, reconciliation, and replay roots.
+Protected source, private settlement payloads, wallet private material, raw protected prompts, raw provider responses, and credentials remain absent from the generated artifact, route summaries, and pre-delivery readback.
+
 ## AI-reading demonstration note
 
 The standalone demonstration should prove why Bitcode matters for AI-dominant Reading.

BITCODE_SPEC_V42_NOTES.md

@@ -37,7 +37,7 @@ This matrix records the reliable MVP product surfaces that must become promotion
 | Reading state machine | Five-step Reading UX is route-owned, persistent, and source-safe | `.bitcode/v42-reading-shortest-path-state-machine.json`, `TerminalEnterpriseReadingRouteState`, `readingStage`, route/retry/failure tests | implemented |
 | 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 | later V42 Gate 6 artifact | draft-required |
+| 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 |
 | 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 |
@@ -51,7 +51,7 @@ This matrix records the reliable MVP product surfaces that must become promotion
 | Gate 3 | Reading shortest path state machine artifact | implemented |
 | 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 | draft-required |
+| Gate 6 | Settlement rights transfer and repository delivery closure artifact | implemented |
 | Gate 7 | AI-reading dominant demonstration MVP artifact | draft-required |
 | 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

@@ -116,6 +116,17 @@ readback, `.bitcode/v42-readfitsfinding-preview-quote.json`, and
 protected source, unpaid AssetPack source, wallet private material, private
 settlement payloads, credentials, raw protected prompts, and raw provider
 responses stay out of route and UI readback.
+V42 Gate 6 adds paid settlement, BTD rights transfer, source-to-shares
+compensation, and repository delivery closure with
+`AssetPackSettlementRightsDeliveryBoundary`,
+`.bitcode/v42-settlement-rights-delivery.json`, and `check:v42-gate6`.
+The boundary observes the quote payment, confirms BTC/testnet finality,
+allocates depositor compensation, records BTD read-right receipts, reconciles
+ledger/database/object-storage projections, and unlocks source-bearing
+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.
 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

README.md

@@ -5,14 +5,15 @@
 - Current active canonical pointer: `BITCODE_SPEC.txt` -> `V41`
 - Current active canon: `BITCODE_SPEC_V41.md`
 - Current draft target: `BITCODE_SPEC_V42.md`.
-- Current working gate: V42 Gate 5 ReadFitsFinding AssetPack Preview And Quote Closure.
-- Next queued gate after V42 Gate 5: V42 Gate 6 Settlement Rights Transfer And Repository Delivery Closure.
+- Current working gate: V42 Gate 6 Settlement Rights Transfer And Repository Delivery Closure.
+- Next queued gate after V42 Gate 6: V42 Gate 7 AI-Reading Dominant Demonstration MVP.
 - Latest closed version: V41 Prompt And PromptPart Excellence, which promoted PromptPart and Prompt inventory, registry interpolation contracts, Reading prompt baselines, ReadNeedComprehensionSynthesis prompt hardening, ReadFitsFindingSynthesis prompt hardening, Conversation/tool/interface prompt rewrite, prompt benchmark telemetry, and V41 promotion readiness.
 - Recent V42 opening anchor: reliable MVP experience opens over promoted V41 with V42 SPEC, DELTA, NOTES, and PARITY files, `check:v42-gate1`, active V41 / draft V42 posture, and a nine-gate plan for shortest-path Depositing, five-step Reading, ReadNeed product closure, ReadFitsFinding preview and quote closure, settlement and repository delivery, AI-reading demonstration, local/staging rehearsal, and promotion readiness.
 - V42 Gate 2 closure anchor: reliable MVP experience now owns source-safe Depositing compensation visibility through `DepositorySupplyCompensationPreview`, deposit route `depositoryEvidence.compensationPreview`, deterministic `.bitcode/v42-depositing-shortest-path.json`, route/API readiness checks, source validation, Depository search/vector/storage projection, source-to-shares compensation readback keys, Terminal compensation roots, focused package/protocol tests, workflow wiring, and `check:v42-gate2`.
 - V42 Gate 3 closure anchor: reliable MVP experience now owns the five-step Reading shortest path state machine through `TerminalEnterpriseReadingUxState`, `TerminalEnterpriseReadingRouteState`, recoverable transaction ids, `readingStage` route hydration, retry/restart posture, source-safe failure repair actions, accepted-Need blockers, source-safe preview blockers, rich Reading pipeline telemetry readback, deterministic `.bitcode/v42-reading-shortest-path-state-machine.json`, focused route/component/protocol tests, workflow wiring, and `check:v42-gate3`.
 - V42 Gate 4 closure anchor: reliable MVP experience now owns ReadNeed product closure through `ReadNeedReviewResynthesisRuntime`, source-safe storage projection, reviewed Need feedback/resynthesis lineage, accepted-Need Finding Fits admission, rejected Need blockers, PTRR/Failsafe/Thricified telemetry receipts, Terminal Need runtime/storage/telemetry readback, deterministic `.bitcode/v42-readneed-review-resynthesis-product-closure.json`, focused package/route/protocol tests, workflow wiring, and `check:v42-gate4`.
 - V42 Gate 5 closure anchor: reliable MVP experience now owns ReadFitsFinding preview and quote closure through accepted-Need-gated `ReadFitsFindingRuntime`, many-channel Depository search, selected-fit provenance, `AssetPackPreviewBoundary`, deterministic share-to-fee quote receipts, disclosure review, settlement instructions, delivery lock, harness evidence summaries, Terminal preview/quote/provenance readback, deterministic `.bitcode/v42-readfitsfinding-preview-quote.json`, focused package/route/protocol tests, workflow wiring, and `check:v42-gate5`.
+- V42 Gate 6 closure anchor: reliable MVP experience now owns settlement rights transfer and repository delivery closure through `AssetPackSettlementRightsDeliveryBoundary`, BTC payment observation/finality, BTD read and rights transfer receipts, source-to-shares compensation conservation, delivery unlock, ledger/database/object-storage reconciliation, live harness materialization, route settlement summaries, Terminal settlement rights readback, deterministic `.bitcode/v42-settlement-rights-delivery.json`, focused package/host/route/protocol tests, workflow wiring, and `check:v42-gate6`.
 - Recent V41 closure anchor: V41 canonical promotion updated `BITCODE_SPEC.txt` to `V41`, generated `BITCODE_SPEC_V41_PROVEN.md`, preserved active V41 / draft V42 runtime posture, and closed prompt-program excellence canon.
 - Recent V40 closure anchor: V40 canonical promotion updated `BITCODE_SPEC.txt` to `V40`, generated `BITCODE_SPEC_V40_PROVEN.md`, preserved active V40 / draft V41 runtime posture, and closed exhaustive commercial application testing canon.
 - Recent V39 closure anchor: V39 canonical promotion updated `BITCODE_SPEC.txt` to `V39`, generated `BITCODE_SPEC_V39_PROVEN.md`, preserved active V39 / draft V40 runtime posture, and closed commercial Reading readiness canon.

SPECIFICATIONS_ROADMAP.md

@@ -316,6 +316,9 @@
     "generate:v42-readfitsfinding-preview-quote": "node scripts/generate-v42-readfitsfinding-preview-quote.mjs",
     "check:v42-readfitsfinding-preview-quote": "node scripts/generate-v42-readfitsfinding-preview-quote.mjs --check",
     "check:v42-gate5": "node scripts/check-v42-gate5-readfitsfinding-preview-quote.mjs",
+    "generate:v42-settlement-rights-delivery": "node scripts/generate-v42-settlement-rights-delivery.mjs",
+    "check:v42-settlement-rights-delivery": "node scripts/generate-v42-settlement-rights-delivery.mjs --check",
+    "check:v42-gate6": "node scripts/check-v42-gate6-settlement-rights-delivery.mjs",
     "generate:v38-inference-surface-inventory": "node scripts/generate-v38-inference-surface-inventory.mjs",
     "check:v38-inference-surface-inventory": "node scripts/generate-v38-inference-surface-inventory.mjs --check",
     "check:v38-gate2": "node scripts/check-v38-gate2-inference-surface-inventory.mjs",