Files
Dune/docs/SAPHO_BATTLE_ORDER.md
T
Quintine 9b67a780eb Connect early Juice of Sapho battle aggressor
During the existing public pre-plan opportunity, the holder can discard canonical unreserved Sapho to become aggressor before their readiness or any binding plan/Voice/inspection/Truthtrance commitment. Unchosen preparation prompts remain available. No new confirmation-only or holder-dependent response window is introduced. Later intervention and its allocation/privacy protocol remain unfinished.

A battle/turn/revision-bound history and independent event list preserve accepted priority while keeping attacker, defender and chooser stable. Legitimately recovered cards can change priority again at a fresh event. Reads, actions and normalization reject corrupt histories/custody. Shared tie priority respects Habbanya in either physical slot and reaches pre-commit Stone/Voice checks, public views, bot calculations and actual ordinary/Stone resolution. The final quote previously assumed original attacker priority and now consumes the validated aggressor. Harkonnen capture still follows actual winner/loser.

Owner controls, public aggressor/tie text, automatic notices and internal guidance are connected. Focused tests exercise actual tied results in Basic/Advanced, both Habbanya sides, mixed-force Stone finishability before opposing commitments, a real allied Prescience boundary, stale/late/cross-owner rejection, private rival noninterference, receipt corruption, saved recovered-card revision, actual policies at all four AI levels and authenticated SQLite races/seat restoration. Independent review found no material defect. A prior scheduling test now explicitly readies its human holder to save the card instead of allowing the new legal AI play.

Types, lint and 4866 offline tests, production build and 43 HTTP/session tests pass on the unchanged source fingerprint below. Two genuine CHOAM/Richese samples completed with 1279 accepted actions, 34 periodic JSON restores and no rejected candidates. One movement Sapho play occurred; neither sample used aggressor. Targeted tests and browser evidence, not those samples, establish the new effect. Full expansion and module acceptance remain incomplete.

In a new isolated browser room, genuine Advanced faction setup was followed by conserved battle staging. The human Guild used the actual aggressor button, restored the spent card and priority after refresh, readied, selected Master Bewt with zero dial/support, and declined a Traitor call. The staged Emperor opponent used real engine ready/plan/vote actions with Caid and zero dial/support. Guild won the 3-3 tie, retained four forces and 30 spice, and Emperor lost four forces. Final refresh and private JSON views restored the same outcome; the original seat row is unchanged. Screenshot capture timed out, so visual screenshot acceptance is not claimed.

All 1072 original games and original seat/recovery/entry/handover records are unchanged; 1106 rooms remain including isolated QA and HTTP fixtures. SQLite quick-check and foreign keys pass. The healthy server was reused without reset/restart or automation.

The Mirror audit now records why every genuine CHOAM/Richese setup includes unresolved copy candidates: an ordinary-copy-only gate would need hidden eligibility or altered inventory. Mirror stays gated pending the existing disposal ruling and copied-choice work. No mode/publication gate is opened.

Verified source tree: 2fb3160efd713a3f7068aedb474868ba6863bccc420848a56e69e1df1d84441b
2026-09-20 11:45:47 +10:00

4.7 KiB

Juice of Sapho: remaining battle-choice order

Updated 14 September 2026. This connects first/last Battle-phase ordering through controls, AI and saved continuation. The separate aggressor mode and full Richese/Advanced publication gates remain unfinished.

Authority and interpretation

The physical-card audit and source follow-up establish first/last in an ordered phase/action as a separate printed alternative from becoming a battle's aggressor. The battle review explains why chooser identity, participants and tie priority must remain separate.

The selected scope is the remaining Battle phase, at clean boundaries between battles. Accepted priority lasts for the rest of that phase. Keeping a reordered chooser separate from physical attacker and tie advantage is the existing audit's implementation interpretation of those distinct alternatives, not an explicit publisher FAQ ruling. The base game normally combines those identities through storm order. No new official timing ruling is claimed.

First and last reorder future choices; completed battles stay resolved. Other players can still select battles against a last-position holder. Sapho grants no immunity or additional battle and does not move forces or alter physical storm order. Aggressor mode needs its separate late-intervention protocol and Stone Burner allocation work. No new confirmation-only window is introduced here.

Connected behavior

20 September follow-up: early aggressor now connects the separate pre-plan effect. References below to unavailable intervention concern later or suspended battle timing; chooser ordering retains the contract here.

The existing Richese development configuration supplies the physical card. Its holder receives private battleOrder first/last options at a clean boundary. The command binds the current opportunity and discards the exact unreserved card once. A held position, stale event, absent unresolved battle or suspended interaction cannot consume it. Earlier completed battles do not prevent a later order change; a current battle and its aftermath must finish first.

The stored priority is separate from g.order. Legal pair geometry comes from the public combat board. Each choice has a chooser and stable attacker/defender identities. A reordered physical defender can choose the actual opposing attacker without swapping leaders, plans or faction powers. UI and bots use the same authoritative choices and owner-relative target.

Priority includes all seats, even those currently without a battle, so a later Face Dancer replacement does not move a newly relevant seat behind an accepted last position. Actual eligibility is recomputed after all aftermath. A battle start or Sapho use expires the old opportunity event. Legally recovering the physical card permits a new use at a fresh opportunity; there is no invented once-per-phase restriction.

All four AI profiles use their private view and public board. Their initial ordering policy favors first when an unresolved stronghold battle is available, otherwise last. They can then choose an opponent from either stable battle slot. This is a legal strategy path, not difficulty calibration.

Evidence and boundaries

Focused engine, controls, bot and authenticated SQLite tests exercise ordering, actual opponent choice, saved continuation, duplicate-request custody and rejected action immutability. Fixtures distinguish genuine Basic/Advanced CHOAM/Richese setup from later conserved battle staging. A genuine five-seat Ix/CHOAM regression resolves a battle, activates Face Dance and gives the newly eligible replacement its next choice ahead of a protected last seat, in Basic and Advanced.

The isolated browser table used first from a later physical circle, chose the earlier Emperor attacker, completed the battle and restored the next battle choice after refresh. Emperor retained the tie win. All nine accepted actions replayed exactly with the recorded battle event; private views, physical custody and the original seat row passed. Final check results, fingerprints, browser and complete-game evidence are retained in the private checkpoint report and Git message.

Intervention within an unresolved battle or suspended aftermath is unavailable. Aggressor mode, ordinary cyclic-auction scope, first versus an unspent Advanced Guild and interruption of partly completed movement turns retain their existing boundaries. Prototype evidence does not certify full card or mode compliance.

The opening preservation baseline contains 970 rooms. Keep all saved games and seat/recovery records, reuse the healthy server and leave recurring restarts absent.