Combine current-turn payments with shipment and movement promises

docs/TRUTHTRANCE_TURN_ACTIONS.md

@@ -0,0 +1,105 @@
+# Truthtrance combined current-turn actions
+
+## Payments, reserve shipment and physical movement prototype
+
+**Prototyped / Partial.** New raw question:
+`{kind:'turnActions',target,turn,mixed}`. Action leaves are ordinary
+`{kind:'payment',recipient,minimum}` or native
+`{kind:'ship'|'move',territory,minimum}`. Optional current facts and full AND/OR
+share sixteen logical leaves/four grouping levels. Old travel/payment question
+shapes and mode gates remain.
+
+## Authority and meaning
+
+Reuse publisher November2020 FAQp8 current-turn AND/OR/compliance and supplied
+Advanced physical39/printed37 authority recorded in RULE_DECISIONS. This is the
+next provisional composition of existing native funded-payment and owned-stage
+travel prototypes, not a printed exhaustive promise solver. Native scope and
+current timing remain authoritative; optional modules retain their fences.
+
+All facts freeze at actual answer, with the existing guaranteed aggregate
+unknown interpretation. No negates the whole expression, not each action.
+Alternative native routes are never fixed publicly or stored as separate
+answers. The raw question is public; compiled facts/branches stay private.
+
+Only actual ordinary payer bribes after this answer add cumulative payment
+progress. Shipment fees, gifts, subsidies, earlier payments and later Mentat
+receipts do not add that progress. The recipient's existing receipt/late-next-
+opening mechanism stays unchanged. Each shipment leaf describes the same one
+future original reserve shipment. Each movement minimum requires one physical
+ground group; smaller moves never sum. Previous-turn physical events never count.
+
+Transport closes at the respondent's actual Movement end. A whole OR answer
+can retain a funded payment alternative after that close; an AND requiring a
+missing transport event cannot evade it. Residual payments remain binding through
+the current full turn, including Mentat. A whole Yes fulfills on actual events;
+No lasts until the relevant native opportunities have closed. Constant answers
+need no event. Earlier current-turn payments have separate intervals for each
+answer; one future payment can satisfy compatible minima without double reserve.
+
+## Native integration contract
+
+The focused helper owns strict trees, signed branches and actual progress only.
+Detached branch witnesses use the original scalar shipment/movement/payment
+ledgers and native fee/funding/completion functions. No selected branch is
+installed in the real ledgers. Existing bids, Revival, bribes, travel and battle
+obligations retain their native resource protections and actual receipts.
+
+Current funds support ordinary payments under the existing bribe prototype;
+unknown future gifts/income/unowned cards are not invented. Existing owned
+Charity/Revival/auction/card preparations remain the travel forecast. Mandatory
+native progress or completed opposing effects can release impossibility; own
+spending or closing an opportunity must leave a completion. Pending foreign
+invoice/income outcomes retain original timing.
+
+A persistent own raw aggregate history and one exact current native guide connect
+human controls and four minimal profiles. Guide packets carry event/phase source
+metadata, preserve actual recipients/forces/cost splits and native modal priority.
+Every definite question uniformly reopens applicable concurrent preparation/
+Mentat readiness, including constants, preserving the existing private boundary.
+No new action rights or turn allowance is granted.
+
+## Evidence and remaining scope
+
+Helper: game/turn-action-promises.ts and its focused tests. Human controls:
+components/turn-action-fields.tsx and components/turn-action-promises.tsx.
+Native sources/tests: tests/fixture-truth-turn-action.ts and
+tests/truth-turn-action-runtime.test.ts. Genuine prior Bid/Revival funding sources
+are in tests/truth-turn-action-funding.test.ts.
+
+The frozen source passes **23 files,234/234**, types/lint, production build and
+three native paths with11 GameTable SSR renders, three actual answer callbacks
+and five actual guide callbacks. Source27 +9 performs frozen facts, pay2,
+original paid shipment1 and ground1. A second source27 +14 closes transport,
+then pays in late Mentat and advances the turn. Original Advanced Mentat35 +9
+pays after opening and retains the recipient's next-opening receipt timing.
+All original physical inventories remain. These are local engine/SSR/callback
+journeys, not browser/hydration or deployed acceptance.
+
+Fourteen helper and fourteen control cases supplement eighteen native cases and
+four genuine two-Truth funding conflicts. Compatible scalar/aggregate intervals
+share an actual payment once; incompatible Bid/payment and Revival/payment Yes
+answers reject in both acceptance orders. Earlier history/receipts survive and
+the original accepted answer is fulfilled by an actual action. Current facts
+freeze, movement maxima never sum, OR retains manual alternatives, whole No
+survives own transport close, all four minimal profiles complete, and Basic/
+Advanced late recipient receipts do not add payer progress again. A controlled
+Inflation Double token variant, explicitly distinguished from original native
+sources, rejects a payment-only Yes while allowing truthful No.
+
+Initial focused feedback repairs exact stored metadata and a test fact-call
+signature. Bounded review adds actual payment timing and later native Bid/Revival
+resource preflight. A proposed payment gap is rejected as an incorrect test
+assumption: pay9 toward a cumulative10 minimum leaves progress9 plus one funded
+spice. The corrected regression proves partial9 then1, full10 and shipment routes.
+
+Proof/manifest:
+`/home/quintine/.local/share/dune/checkpoints/20261026-truth-turn-action-proof-v1/`;
+journeys and HTML: adjacent `20261026-truth-turn-action-runtime/`.
+
+
+Other action families, broader owned preparations/optional compositions,
+unknown-fact correlations and complete rules/browser/deployed/recovery/privacy/
+custody acceptance remain. Full strategy/calibration stays deferred. Preserve
+all games and the hosting project; this batch performs no save/database/server/
+reset/restart/deployment operations and certifies no complete mode.