Implement revised Advanced Family Atomics rules

docs/FAMILY_ATOMICS.md

@@ -0,0 +1,78 @@
+# Family Atomics source cutover
+
+27 October 2026. **Prototyped / Partial.** The supplied Advanced authority,
+physical39/printed37, gives the revised card's complete timing, sector test and
+removal. It also expressly excludes advisors. The source is bound by the
+[authorized amendment](RULE_DECISIONS.md#authorized-source-amendment--1-october-2026).
+
+```sh
+pdftotext -f 39 -l 39 -layout UNOFFICIAL_Revised_Dune_Rulebook_v.2.3_web.pdf -
+```
+
+## Connected Advanced behavior
+
+- Play after the first game turn, after movement distance is calculated and
+  before the storm actually moves. Weather Control zero is calculated distance.
+  Native Advanced Storm2 reveals its card immediately at turn opening; the
+  prototype does not invent an earlier quiet/null-distance turn2 boundary.
+- Physical fighters must be on the Wall or in an adjacent territory with no
+  storm strictly between their sector and the touching Wall sector. A storm
+  in the originating sector or on the Wall is permitted. Basin11 reaches Wall9
+  through sector10; a storm10 blocks it. Pasty Mesa/Minor Erg approach Wall8.
+  The helper uses that direct interval, without a circular detour.
+- Destroy all original Wall forces with the existing typed casualty path, clear
+  earlier confirmations and retain the permanent destroyed-wall state. The
+  three protected territories lose protection; rock/entry and ordinary storm
+  movement remain. Destruction does not retroactively sweep an unchanged sector.
+- Move the physical card from hand to public `removedTreachery`, outside draw,
+  discard, recycling, Semuta offers and Box candidates. The persistent Removed
+  from game pile supplies its name and normal inspector. No discard receipt or
+  separate collection/confirmation is fabricated. Already completed older plays
+  retain their recorded outcome; no game is rewritten.
+
+`game/family-atomics.ts` owns legality through shared ordinary-card availability.
+The native action, printed-window witnesses and actual hand control use it.
+The engine owns force destruction and the optional additive removed-card array;
+legacy games project an empty array. Removed cards retain normal card-name
+normalization. Detached printed-card guards do not invent discard knowledge for
+the removed card. Minimal AI retains legal Storm confirmation; optional strategic
+card use and calibration remain deferred.
+
+## Basic boundary and remaining scope
+
+Basic retains its existing territory-level qualification, before/after-distance
+Storm window and ordinary discard. Earlier bounded primary comparison verified
+storm endpoints and optional waiting for distance, but did not locate a primary
+Basic card face imposing all four revision requirements. This cutover therefore
+does not silently import the supplied Advanced revision into Basic.
+
+Physical-fighter qualification is connected. Concealed No-Field qualification
+and broader optional-module/card combinations remain interaction scope; the
+prototype does not certify full modes. No database migration/reset, conversion
+of completed plays, recovery/privacy campaign or deployed acceptance is claimed.
+
+## Focused evidence
+
+Frozen **10-file union 82/82 plus one changed disposal case**, types/lint/build
+and five original-game programmes pass. Actual public Basic/explicit Advanced
+preview starts, original unopened deal/Spice choices and scalar lotteries,
+real dials0+0/9+0, paid shipment2 for4 and a full first turn earn actual Storm2.
+Wall, clear adjacent, actual Weather0, blocked interval and Basic pre-distance
+sources install no played state. Advanced reveals its original1 immediately;
+Basic supplies its real null-distance window.
+
+Runtime records 14 GameTable SSR, 4 public removed-pile renders and 4
+actual GameTable-configured HandBrowser card-render Play callbacks. The hand
+navigation/selection UI and browser hydration were not operated. Source/further
+action arrays total 192/19 across programmes. Weather/remaining Storm packets
+use the native engine directly. Nineteen new focused cases cover legality,
+actual original forces/cards, public removal, Basic and four minimal policies.
+The former Advanced discard case now verifies immediate removal and all typed
+Wall casualties; Basic's existing continuation remains separate.
+
+Proof: `/home/quintine/.local/share/dune/checkpoints/20261027-family-atomics-proof-v2/`;
+HTML/journeys: adjacent `20261027-family-atomics-runtime/run-v2/`.
+Tests/disposal/types/lint carry from v1 under the identical source snapshot;
+only the private HandBrowser-render capture changed. The existing server returned
+HTTP200 without restart. Concealed No-Field qualification, broader interactions,
+complete modes and final assurance/deployed acceptance remain open.