V39 Gate 7: Settlement Rights Delivery Boundary

[geraldarthurdavis]

Summary

• Adds AssetPackSettlementRightsDeliveryBoundary for BTC payment/finality, source-to-shares compensation, BTD rights/read receipts, settlement unlock readback, ledger/database/object-storage reconciliation, delivery unlock, replay, repair posture, and storage projection.
• Wires paid-boundary receipts through AssetPack preprocess/postprocess and exports required BTD/AssetPack subpaths.
• Adds the V39 Gate 7 protocol artifact, generator/checker, workflow coverage, package/protocol tests, and specification/roadmap documentation.
• Refreshes the Gate 6 preview artifact predicate now that the V39 roadmap has advanced to Gate 7.

Validation

• pnpm --filter @bitcode/pipeline-asset-pack typecheck
• pnpm --filter @bitcode/btd typecheck
• pnpm --filter @bitcode/protocol typecheck
• pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --runInBand --forceExit
• pnpm --filter @bitcode/btd exec jest --config jest.config.cjs --runTestsByPath tests/source-to-shares.test.ts tests/reconciliation.test.ts tests/btd.test.ts --runInBand --forceExit
• pnpm run check:v39-gate7
• pnpm run check:v39-gate6
• node scripts/check-bitcode-spec-family.mjs --version V39 --mode draft --current-target V38
• node scripts/check-bitcode-spec-family.mjs --version V38 --mode promoted --current-target V38
• node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V38 --draft-target V39
• node scripts/check-bitcode-canonical-inputs.mjs --current-target V38
• node scripts/check-v38-gate11-promotion-readiness.mjs --promotion-mode --skip-branch-check --skip-package-tests
• V39 gate checker sequence for gates 1-7 with workflow skip flags
• git diff --check

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
engi-uapi	Ready	Preview, Comment	May 25, 2026 8:02am

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a695b5ea31

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

[chatgpt-codex-connector]

Require explicit BTC finality before marking settlement confirmed

Do not default finalityState to confirmed when no finality receipt is provided. In the current flow, buildAssetPackSettlementRightsDeliveryBoundary can be called with a payment observation but finality undefined (see preprocess wiring), and this fallback marks the payment as confirmed, which allows downstream rights-transfer/delivery logic to proceed as if chain finality were proven. This breaks the fail-closed settlement gate for any caller that has payment metadata but has not yet observed confirmation.

Useful? React with 👍 / 👎.