Connect stable occupied Homeworld income sharing and native protections

docs/CURRENT_STATUS.md

@@ -16,6 +16,37 @@ open mode gates.
 
 ## Current checkpoint and work
 
+**Stable Homeworld occupation — bounded Development Verified:**
+fresh original2..6 Basic/Advanced setup/selected decks and Homeworlds alone;
+no played-game conversion or inferred current controller. Continuously present
+sole qualification, without competing/departed/contested/restored-high history,
+supports actual bank Collection/immediate ally allocation and printed Wallach/
+Tleilax/Grumman/Salusa protections without physical star conversion.
+Original board/shared allocation/phase order and once-only credit receipts
+remain; actual Homeworld portions feed Giedi once. Original dispatcher capture
+and zero-icon income admission defects are repaired, not their source guards.
+Twenty-four original setups,21 new/262 affected cases, types/lint/build and
+original-phase bank/native programs/four legal keep-all policies pass.
+
+Fifty genuine2..6 samples attempted on unchanged09f8b0d tree:37 complete with
+11,762 accepted actions/300 JSON continuations, including153 rejected candidates
+(not a zero-rejection certificate). All50 total19,080 accepted/19,283 attempts/
+491 JSON continuations. Two preserved zero-award captures finish7/14 more actions
+at their original seeds on correction treeeed8f319. **39/50 finish**; nine
+occupation/Salusa-combat and two low-Tupile CHOAM source-ruling captures remain
+preserved, with no rerun to hide failures, forced outcome or guard bypass.
+
+Original CLI **CPBXKFGD v14/setup** retains actual offers/cards/actors. Real
+turn-two Nexus earns Guild/Harkonnen alliance. Human390px **v21/Mentat** shares
+Caladan2 as1/1, gives Wallach1 to Harkonnen and awards Giedi2 once: Guild3→4,
+Harkonnen8→12; original readiness reaches Mentat. Refreshed original source
+cards/notice and force inspector show18 Guild reserves/0 Tanks/two separate
+foreign visitors, no root390px overflow. Controlled positions are labelled;
+only dedicated QA changes, no reset. Owned temporary scripts are removed.
+Percentage receipts, other occupied powers, unresolved occupation/CHOAM
+rulings, public starts, save conversion and full/deployed assurance remain.
+[Exact source and evidence](HOMEWORLD_OCCUPATION_RULES.md#stable-continuous-occupation-prototype--5-october-2026).
+
 **Standalone E3 Nexus / Skills / selected Tech/Strongholds — bounded Development Verified:**
 native Ecaz OR Moritani plus classics, exact ecaz33/all14/all12,
 Basic/Advanced2..6; original Tech3+ and/or Advanced Strongholds2+, both3+.

docs/HOMEWORLD_OCCUPATION_RULES.md

@@ -2,6 +2,84 @@
 
 Runtime follow-up, 10 September 2026: [Tupile intelligence and qualification history](HOMEWORLD_TUPILE_INTELLIGENCE_RUNTIME.md#occupation-observation-boundaries) implement confirmed observations while retaining the unresolved entitlement and expiry questions below. The source audit remains historical evidence.
 
+## Stable continuous occupation prototype — 5 October 2026
+
+The fresh local `homeworld-occupation` entry uses original two-through-six-seat
+Basic/Advanced setup, selected faction decks, thirteen physical card facts and
+the original qualification history. It never converts a played Homeworld save
+or infers entitlement from a current garrison. One original qualifier must
+remain continuously present since qualification, without another foreign army,
+another qualifier, departure or restored native high threshold. All unresolved
+histories retain the existing source guards; this is a supported unambiguous
+subset, not an expiry/replacement ruling.
+
+Printed occupied **bank icons** now enter one Collection queue before ordinary
+Collection mutates balances. After original board/shared allocations and phase
+opening, each occupier may keep the award or immediately allocate a portion to
+its current reciprocal ally. Zero-icon/no-ally rows settle their only legal
+allocation automatically. Actual bank credits and the cursor/receipt commit
+together; reading a view or replaying an old command cannot mint spice.
+The bank queue does not implement Kaitain/Junction/Richese percentage receipts.
+The original Giedi hook counts actual allocated Homeworld credits once, rather
+than printed capacity; applying that hook to an immediately shared bank portion
+is explicit source composition, not a newly retrieved worked FAQ.
+
+The same proved entitlement supplies Wallach IX Voice immunity, Tleilax
+Face Dancer exclusions, Grumman reveal immunity and occupied Salusa suppression.
+Both occupier and current reciprocal ally receive the three targeted protections.
+Sardaukar keep their original starred identity/custody but fight at strength one;
+no Karama opportunity can restore the printed occupied penalty.
+Known Voice immunity skips that declaration; ambiguous Voice permits only a
+source-blocked choice/decline. Ambiguous Terror keeps an owned blocked Reveal/
+Decline window, rather than silently authorizing revelation or guessing an owner.
+
+Twenty-four original three-seat setup programs,21 new/262 affected cases,
+types/lint and build pass. Actual original-phase runtime proves partial bank
+allocation (owner1/ally1 plus one high-Giedi2), immutable replay rejection and
+four legal keep-all policies. The original captured decision is retained through
+the generic dispatcher; the reproduced clearing error is fixed. Native programs
+exercise real protected battles, two actual strength-one starred counters,
+an original matching Face Dancer with labelled conserved unused-deck exchange,
+and real first-Mentat Robbery placement followed by paid second-Movement
+three-force occupier entry without token revelation.
+
+Fifty genuine classic/paired E1/E2/standalone E3 games were attempted on
+unchanged tree `09f8b0dcdc54bf284f234c6e0f27936689cce1bb1a7b6381548ee13a149d2dae`.
+Thirty-seven complete11,762 accepted actions/300 JSON continuations; those
+complete samples include153 rejected candidates, so this is not a zero-rejection
+or complete-mode certificate. All50 contain19,080 accepted/19,283 attempted
+actions and491 JSON continuations. Thirteen captures retain the actual blockers.
+Two were a source-clear bug: zero-icon Salusa needlessly blocked unrelated bank
+Collection. Quantity-zero ambiguity now grants nothing without choosing a
+recipient, while its mandatory combat-strength guard remains. A meaningful
+regression preserves a real Kaitain2 grant and the unresolved Salusa penalty.
+The two original snapshots finish7/14 more accepted actions without rejection
+at original scenario seeds20263435/20263443 on unchanged correction tree
+`eed8f319ece875181b9412ded145189691db3a8ca56fa6ff00e11f5ca11965ee`.
+Resume restarts that seed, not the lost pre-capture random stream.
+Thirty-nine of the original50 now finish; nine occupation/departure/competition/
+repopulation or Salusa-combat captures and two low-Tupile CHOAM captures remain
+at their existing pending rulings. No duplicate question, favorable new seed,
+forced outcome or guard bypass.
+
+Original backed-up CLI **CPBXKFGD v14/setup** preserves actual prediction/
+Traitor/card/actor custody. A real second-turn worm/Nexus earns Guild/Harkonnen
+alliance before labelled conserved positions. Human390px **v21/Mentat** settles
+Caladan2 as Guild1/Harkonnen1, then Wallach1 wholly to Harkonnen, with one Giedi2:
+Guild3→4, Harkonnen8→12. Queue/world/event continue once; original phase-ready
+actions reach Mentat. Refreshed source cards/notice/force inspector show Guild18
+native reserves/0 Tanks/one visitor on each world, with no root390px overflow.
+Only this QA room changed. An early driver staging error was corrected by
+settling the original foresight response first; no Caladan rule was changed.
+Private receipts/reports stay outside Git; owned throwaway scripts were removed.
+
+See [runtime bank regression](../tests/homeworld-occupation-runtime.test.ts),
+[income cases](../tests/homeworld-occupied-income.test.ts) and
+[native defense cases](../tests/homeworld-occupied-defenses.test.ts).
+The historical pending questions below, percentage/borrowed occupied powers,
+full-module assurance, public starts and deployed acceptance remain open.
+
+
 Source audit, 9 September 2026. This supplements [Homeworld rules](HOMEWORLD_RULES.md#occupier-lifecycle-and-benefits) and the [invasion audit](HOMEWORLD_INVASION_RULES.md#occupation-evidence-and-unresolved-lifecycle). It defines the evidence that can safely be recorded; it does **not** settle every occupied benefit or authorize a complete occupation release. The [integration audit](HOMEWORLD_OCCUPATION_LIFECYCLE_AUDIT.md) maps the physical mutation and recovery boundaries.
 
 ## Confirmed publisher contract

docs/HOMEWORLD_RULES.md

@@ -2,6 +2,17 @@
 
 Source audit, 9 September 2026. No runtime activation. The primary module source is the [GF9 Ecaz & Moritani rulebook](https://www.gf9games.com/dune/wp-content/uploads/EcazMoritani-Rulebook-LOWRES.pdf), especially printed pp.4, 9–10 and the Homeworld FAQ on pp.15–16. The local publisher-text transcription is `/tmp/dune-rules/ecaz-audit.txt`; fresh official indexed pp.9, 10 and 15 were checked against it. Direct PDF retrieval currently returns HTTP 403. Physical card faces are separately audited in [Homeworld component audit](HOMEWORLD_COMPONENT_AUDIT.md); a rulebook statement and a card-face statement are not interchangeable evidence.
 
+### Stable occupation runtime follow-up — 5 October 2026
+
+Original fresh `homeworld-occupation` setup now connects continuously proved,
+uncontested bank Collection/immediate ally sharing and the printed Wallach/
+Tleilax/Grumman/Salusa occupied protections. The immutable qualification history
+remains distinct from present armies; departure, replacement, contested or
+repopulated histories retain their pending guards. Percentage receipts and
+other occupied powers remain separate. This does not open normal starts,
+convert old saves or certify Homeworlds. See the
+[exact supported source/runtime subset](HOMEWORLD_OCCUPATION_RULES.md#stable-continuous-occupation-prototype--5-october-2026).
+
 ## Module scope and component inventory
 
 There are **13 double-sided Homeworld cards and 13 corresponding planet discs for twelve factions**, not twelve of each. Emperor uses Kaitain and, in Advanced, Salusa Secundus. Only the seated factions' components enter the game. E3 permits the module independently of the selected factions and independently of Nexus cards, Discovery tokens and new Treachery cards. It does not require either Ecaz or Moritani to be seated, or all expansion factions to be present. [E3 pp.4, 9–10](https://www.gf9games.com/dune/wp-content/uploads/EcazMoritani-Rulebook-LOWRES.pdf#page=9)

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,49 @@
 # Dune implementation status
 
+## 5 October 2026 — stable occupied Homeworld bank income and protections
+
+Fresh original `homeworld-occupation` enters Basic/Advanced2..6 and selected
+faction decks with Homeworlds alone. One original continuously present qualifier,
+no other foreign army/departure/competing qualifier/restored-high history,
+supports the unambiguous printed bank/defensive effects. Original qualification,
+physical native population and current garrisons stay separate. No expiry/
+replacement policy or old-save conversion is introduced.
+
+Two bounded owners supplied bank queue/component and printed defensive cases;
+parent integrated original setup/CLI/samples, source history, typed combat/
+Voice/FaceDance/Terror, Collection/actual Giedi sources, controls and legal bots.
+Original captured decision survives the generic dispatcher. Salusa's zero bank
+icons no longer block unrelated income; its unresolved combat penalty still
+does. New21/affected262, types/lint/build,24 original setups and real source
+programs/four legal keep-all policies pass; final clean-Movement regression1/1.
+
+Fifty genuine classic/paired E1/E2/standalone E3 samples ran on unchanged
+`09f8b0dcdc54bf284f234c6e0f27936689cce1bb1a7b6381548ee13a149d2dae`.
+37 complete11,762 accepted/300 JSON continuations, with153 rejected candidates.
+All50 total19,080 accepted/19,283 attempts/491 JSON continuations; not a
+zero-rejection certificate. Two exact zero-award captures finish7/14 more
+accepted actions/no rejection at original scenario seeds on correction tree
+`eed8f319ece875181b9412ded145189691db3a8ca56fa6ff00e11f5ca11965ee`.
+Resume restarts the same seed, not the lost original stream.39/50 finish;
+nine occupation/Salusa-combat and two low-Tupile CHOAM ruling captures remain
+preserved, not replayed to hide them or forced into invented outcomes.
+
+Original backed-up CLI CPBXKFGD v14 retains actual setup/cards/actors. A real
+second-turn worm/Nexus earns Guild/Harkonnen alliance before labelled conserved
+positions. Human390px v21/Mentat settles Caladan2 as1/1, then Wallach1 to ally,
+with Giedi2 once: Guild3→4/Harkonnen8→12. Source cards, warning, refresh and
+force inspector show18 Guild reserves/0 Tanks/one visitor on each world with
+no root overflow. Original readiness reaches Mentat. Native runtime programs
+exercise protected Voice, two strength-one real starred counters/no Karama
+restore, an original matching Face Dancer conserved from the unused deck and
+actual first-Mentat Robbery then paid three-force protected second-Movement entry.
+
+Only dedicated QA changes; no reset/credential disclosure/assurance campaign.
+Owned throwaway scripts removed; reports/private receipts remain outside Git.
+Percentage receipts, other occupied powers, unresolved rulings, public/save
+conversion, complete-mode and deployed acceptance remain open.
+[Canonical source and exact evidence](HOMEWORLD_OCCUPATION_RULES.md#stable-continuous-occupation-prototype--5-october-2026).
+
 ## 5 October 2026 — standalone E3 Nexus, Skills and original components
 
 Original `leader-skills --nexus-cards` now admits Ecaz OR Moritani/classic

docs/RULE_DECISIONS.md

@@ -155,6 +155,7 @@ See [the cutover and Advanced sequence](MORITANI_ASSASSINATE_LEADERS.md#authorit
 
 | Topic | Decision to preserve | Detailed authority and evidence |
 | --- | --- | --- |
+| Stable Homeworld occupation | Fresh original Homeworlds alone, original setup and qualification history. Admit only one continuously present qualifier without another foreign army, departure, competing qualification or restored native high threshold. Actual bank icons/immediate reciprocal-ally allocation and Wallach/Tleilax/Grumman/Salusa protections compose source-clear cases; no current-controller shortcut or expiry/replacement ruling. Zero-icon ambiguity cannot block unrelated currency awards or select combat strength. Paid percentages, remaining borrowed powers, pending rulings and public/save conversion stay separate. | [Source and bounded runtime evidence](HOMEWORLD_OCCUPATION_RULES.md#stable-continuous-occupation-prototype--5-october-2026) |
 | Standalone E3 Nexus / Skills / original components | Fresh Ecaz OR Moritani/classic ecaz33/all14/all12, Basic/Advanced2..6, original Tech3+/Advanced Strongholds2+. Original Duke/assassination/Terror, chosen-plan Advanced Occupy and separate physical armies remain. Ecaz-led Suk rescues only its own fixed casualties; Diplomat uses the selected faction's own undialed commitment. Owner-pool skill composition is an explicit implementation inference, not a combined-skill FAQ. E3 pairs/Harkonnen Advanced/HW/previews/shared-Duke training/enhanced relocation and pending rulings remain guarded. | [Source and verified scope](NEXUS_CARD_RULES.md#standalone-e3-nexus-skills-and-original-components--5-october-2026), [coalition contract](ECAZ_OCCUPY_RULES.md#standalone-nexus--skills-coalition--5-october-2026) |
 | Harkonnen special-Karama forced return | Return automatically only when the combined hand equals the count owed. Keep actual drawn-card observations owner-private after settlement; legacy forced saves describe held-card history without inventing draw provenance. Existing provisional auction-payment recovery and mode gates remain. | [Contract and limits](HARKONNEN_EXCHANGE.md) |
 | Basic Moritani / Leader Skills | Ordinary Terror death returns the assigned skill once; own revival offers the existing private optional replacement. Sabotage does not take skills, alliances do not transfer assignments, and mandatory Planetologist/Diplomat disposal excludes those cards from ally retention. This is composition of existing contracts, not a new ruling or resolution of unfinished skill effects. Advanced and other roster/module combinations remain gated. | [Integration contract](MORITANI_LEADER_SKILLS.md) |