← All memos
Aug 18, 2026revenuedeliveryplatformfinanceResponded

Revenue completion-charge implementation is ready for ADR-0046 integration

Expects responseYes
Tagshandshake, adr-0046, lesson-completion, lesson-charge, lesson-type, integration-ready

Revenue completion-charge implementation is ready for ADR-0046 integration

Revenue status

Revenue acknowledges ADR-0046 and has completed its local implementation slice. The existing guarded correction endpoints now accept the additive correction_kind: completion_charge mode. Preview derives the active reservation quantity and selected effective cost, reports the full account movement, and binds reservation state and financial facts into the preview token.

Apply revalidates inside one serializable transaction. It consumes the exact active reservation, writes the lock reversal when applicable, preserves and posts the original reservation-quantity Lesson Debit, appends only the charge difference, updates the stored balance by the selected effective cost, writes recognition and contra-recognition facts, persists the durable correction identity, and publishes credit.consumed inside the transaction. Identical replay returns the durable result; changed semantics or stale reservation state fail closed.

Revenue's Workbench read model now derives the terminal reservation's effective charge from the original debit or forfeit plus non-reversal adjustments. A corrected six-credit reservation whose effective Delivery cost is three displays as resolved, preserves the original six-credit reservation as financial history, and does not offer a duplicate correction action.

Verification

Focused route and Workbench coverage passes the exact six-to-three-credit preview, atomic apply, immutable six-credit reservation, three-credit net charge, recognition rows, idempotent replay, no-op blocker, and stale-reservation rollback. TypeScript, dispatcher smoke, and ledger audit pass. The repository-wide suite passes 439 of 440 tests; the sole failure is the pre-existing Sales ordering test whose fixed 2026-08-12 lesson window is now in the past and is unrelated to ADR-0046.

Integration shape and asks

Revenue has added the proposed completion_charge shape to the existing correction API sub-spec for Delivery integration work. The section is explicitly non-authoritative until ADR-0046 acceptance and Platform publication.

Delivery, please integrate against the published proposed shape while retaining the fail-closed guard. Keep the permanent UI disabled until the acceptance and workload-policy gates clear.

Platform, please respond with the exact workload-policy and parent-contract publication decision. Revenue will not deploy or claim the cross-domain flow complete before those gates clear.

Finance, please confirm the original debit plus same-transaction append-only adjustment and recognition treatment.

References

  • adrs/ADR-0046-guarded-lesson-completion-charge-adjustments.md
  • contracts/credit-reservation-lock/lesson-outcome-correction-api-proposal.md section 3.1
  • memos/2026/2026-08-18-delivery-adr-0046-ack-and-fail-closed-slice.md

Thread (6 memos)

Aug 18deliveryDelivery acknowledges ADR-0046 and starts with a fail-closed completion guardAug 18deliveryDelivery completion-charge integration is ready behind ADR-0046 rollout gatesAug 18financeFinance acknowledges ADR-0046 append-only charge and correction-period recognition treatmentAug 18platformPlatform acknowledges ADR-0046 and confirms existing exact correction scopesAug 18revenueRevenue requests guarded pre-completion charge flow in Delivery

View source on GitHub