V45 Gate 13: Deterministic BTD Quote Conservation

[geraldarthurdavis]

Summary

• add package-owned BTD scalar-volume quote-conservation projection for Need-relative fixed-point measurement rows, deterministic quote audit, BTD range projection, rights receipt posture, and source-to-shares readback
• cover final-BTD blockers for reviewed Need, selected Fit set, synthesized Need-Fit AssetPack, deterministic weights, proof/dedupe roots, settlement-bound quote, and BTD range assignment
• wire package exports, V45 parity readback, and the Gate 13 closure checker

Verification

• pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs src/tests/btd-scalar-volume-quote.test.ts --runInBand
• pnpm --filter @bitcode/pipeline-asset-pack typecheck
• pnpm run check:v45-gate13
• pnpm run check:v45-gate12
• node scripts/check-bitcode-spec-family.mjs --version V45 --mode draft --current-target V44
• node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V44 --draft-target V45
• pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs src/tests/read-need.test.ts src/tests/asset-pack-settlement-rights-delivery.test.ts --runInBand
• pnpm --filter @bitcode/btd exec jest --config jest.config.cjs tests/source-to-shares.test.ts --runInBand
• git diff --check
• pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --runInBand

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
engi-uapi	Ready	Preview, Comment	May 31, 2026 11:47pm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 64436300d6

ℹ️ 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]

Preserve fractional row remainders before quote comparison

When a valid quote is produced by buildShareToFeePreview, it rounds the total weighted admitted volume after summing the measurement vector, but this path floors each row to micro-BTD before summing. For fractional measurement volumes whose per-row micro remainders add up, e.g. two 50% rows with volume: 1.000001 and quality 1, the existing quote builder can emit 1,000,001 sats at 1,000,000 sats/volume while this audit computes 1,000,000 and adds quote_conservation_failed, so valid settlement-bound quotes are rejected.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

Detect duplicate selected fits before deduping IDs

For an input with duplicate selected Fit IDs, this helper collapses duplicates before the blocker check later compares selectedIds.length to new Set(selectedIds).size, making that duplicate check unreachable. The projection then reaches buildSourceToSharesProof, which throws Duplicate source-to-shares fit deposit instead of returning a fail-closed final_btd_scalar_volume_blocked projection with selected_fit_set_required, so malformed Fit-set data can crash callers that expect blocker readback.

Useful? React with 👍 / 👎.