Files
Dune/docs/HARASS_WITHDRAW_RUNTIME.md
T
Quintine 62e87d2b96 Connect revealed Harass force allocation and exact casualties
Harass & Withdraw now admits legal Basic/Advanced mixed ordinary/elite commitments and multi-sector returns. A shared physical quote validates every returned counter against one exact legal dial/support complement. After both plans are revealed, the owner selects an ambiguous allocation; unique returns remain automatic. Selected counters become public before Traitor declarations, while physical transfer waits for atomic settlement and opposing-Traitor cancellation. This information is never added to a sealed Battle Plan or complete-plan inspection. Existing optional-module and Richese/Ecaz-allied gates remain.

The player panel, four AI profiles and saved event use the same quote. A versioned receipt binds the revealed plans, current typed location pools, battle and owner. Missing or altered receipts fail before reads, normalization and writes; concurrent choices select once. Previously valid legacy unique plans continue without reopening. Winner casualties now equal the selected dialed group, preventing a second smaller physical commitment after its undialed complement has returned.

Independent source and implementation review passed. Pure, engine, control and SQLite regressions cover typed/sector legality, exact complement, private pre-reveal views, public selected views, stale/malformed state, cross-owner actions, raced allocations, selected restoration, automatic exact casualties, opposing-Traitor cancellation and mandatory disposal. Types, lint and 4850 offline tests, production build and 43 HTTP/session tests pass. The first broad check caught the exhaustive decision registry and test union-narrowing omissions; those were fixed before the final stable checks. Browser testing corrected the incomplete-allocation selector label before verification.

Eight genuine card-variant Basic/Advanced games across all four homogeneous AI profiles completed with 9956 accepted actions, 266 periodic JSON restores and zero rejected candidates. Three Harass plans/returns and two Recruits plays occurred; no ambiguous allocation arose in these seeds. The new choice is exercised by targeted engine, authenticated recovery and browser cases, not inferred from those full-game samples. Full variant and combined-expansion acceptance remains incomplete.

A fresh isolated browser room used genuine Advanced card-variant setup followed by a conserved two-sector battle fixture. Actual controls rejected a partial return, selected two ordinary counters from sector nine, and preserved the selected state after refresh. Following actual owner and engine-driven opponent Traitor declines, two counters returned, the exact remaining ordinary/elite pair went to the Tanks, support cost one, and Harass discarded once. Final refresh restored 18 reserves, two Tanks, 29 spice and the same private Traitor. This is targeted browser evidence, not a complete human game.

All 1038 opening games and original seat/recovery/entry/handover records are unchanged; 1072 rooms remain including new QA. SQLite integrity and foreign keys pass. The healthy development server was reused without restart or reset. No mode/publication gate was opened.

Verified source tree: 61ee78f6e2bce47cb322b04f896db27fef28c56ba2097571a1d85bad5c121156
2026-09-14 06:37:23 +10:00

6.6 KiB
Raw Blame History

Harass & Withdraw development prototype

Updated 14 September 2026. This connects the physical card to battle plans, private inspections, force returns, controls, AI and saved continuation. It does not complete the independent three-card variant or open public mode gates.

Authority and interpretation

The Ecaz card audit records the inspected physical face, designer walkthrough and publisher rules. The GF9 Ecaz & Moritani rulebook, printed pp. 11 and 16, establishes the slot/category distinction, mandatory after-use disposal and the restriction to the card user's undialed forces. The designer walkthrough at 9:11 and physical close-up at 4:28 establish reveal timing, opponent-Traitor cancellation, ordinary leader death, Face Dancer protection for returned forces and the own-Homeworld prohibition.

Two implementation inferences are explicit:

  • Withdrawal precedes weapon/explosion losses because it acts during wheel reveal. Execution waits atomically for Traitor declarations so a successful opposing call cancels the return without reversing a previous resource change. No retrieved publisher FAQ directly answers the explosion combination.
  • Discard the card after use even when its owner wins through a Traitor call. The later card-specific instruction overrides ordinary winner retention, using the same recorded precedence as Planetologist. This is a specificity inference, not a dedicated Harass FAQ.

Planetologist's existing inspection answers remain unchanged. Ecaz's explicit instruction to report no weapon/defense is not silently extended to other slot substitutions.

Connected behavior

Use the existing independent Ecaz card development setup. All three cards enter the physical deck before genuine Basic or Advanced setup; selecting Ecaz alone does not enable this variant. The owner may place Harass in either card slot. It supplies no weapon attack or defense, cannot occupy both slots, and cannot supply the actual opposite category needed by Chemistry or Weirding Way's alternate role. Ordinary leader and Voice requirements remain in force.

Atreides receives a category-null answer without learning the physical card's identity. The owner can retain a slot-only card after that answer. The sealed plan still contains its exact ID. Complete-plan inspection reveals the actual physical plan; Truthtrance's existing literal slot-occupancy promises keep their meaning. An empty-category answer is not a promise that the physical slot is empty.

The shared physical quote validates dialed counters from casualtyOptions, then returns the undialed normal and elite counters to their owner's reserves. The leader resolves normally. An opponent's successful Traitor call, including mutual calls, cancels withdrawal. Returned reserves are outside subsequent board losses and Face Dancer replacement. Harass is discarded once and excluded from ordinary winner retention and Moritani ally retention.

Both selectors enforce the complete pair in either selection order. The private guide explains unique returns or the later revealed allocation choice. The physical allocation follow-up connects typed and sector selection after reveal, with exact committed winner losses. All four AI profiles use the same physical quote and category-aware inspection comparison; the card adds no fictitious weapon or defense value. Stronger profiles value saved forces when expecting defeat and discourage use when expecting to win. This is a legal strategy path, not strength calibration.

Current boundaries

  • Basic and Advanced now support explicit ordinary/elite and sector allocation after reveal. Unique returns are automatic; previously valid legacy battles retain unique-only derivation. See the allocation contract.
  • Additional optional modules remain gated, including Homeworlds, Nexus, Leader Skills, Tech Tokens, Stronghold Cards and Discoveries. This includes the printed own-Homeworld prohibition without claiming other Homeworld battles are already implemented for this card.
  • Richese card-family configurations remain gated because Stone Burner may compare original or post-withdrawal undialed forces, which can reverse the winner. A user question has been sent; no answer is assumed. The guard uses public configuration, never Stone Burner's hidden custody. CHOAM without Richese remains eligible. This is a development boundary, not a printed ban.
  • Co-present reciprocal Ecaz allied armies on either side reject before sealing; other faction integration gates remain in force. This prototype does not settle Ecaz's undialed allied support allocation.
  • Reinforcements remains unavailable pending its separate cost and outcome accounting. Neither slot recognition nor card text proves its effect complete.

Verification and preservation

Focused rules, controls, AI and authenticated recovery suites record the exact supported paths. Fixtures explicitly distinguish genuine variant setup from later conserved battle staging. Independent review precedes final complete-game samples and browser checks. Final commands and source fingerprints are retained in the private checkpoint report and Git message; a sample does not certify every faction or expansion combination.

The opening baseline contains 936 rooms and 1,959 seats. Every room and original seat/recovery/entry/handover record survived the reported outage unchanged; SQLite integrity and foreign-key checks passed. Browser refresh restored the existing test seat. The server was reused without a reset or scheduled restart.

The isolated browser room used a genuine three-seat Emperor/Atreides/Tleilaxu setup, followed by an explicitly conserved battle fixture. Actual controls verified full-card inspection, the category-None answer, Defense-first selection without a duplicate Harass or alternate Chemistry weapon, a one-force plan, public reveal and the owner’s traitor decline. Four forces returned; one went to the Tanks and the leader died. Opposing decisions completed through the engine, including a genuine Face Dancer replacement of the other army. Refresh restored the collection-phase state, exact private views and the single discarded Harass. The private script’s first comparison failed only because its expected version omitted the HTTP layer’s increment; the preserved failure was corrected without changing production code or overwriting a game.