# Physics-audit (t1111 / t1112)

Problemen die we vonden in de vlucht-, bots-, merge-, landings-, settle-
en recolor-logica op master `1ede900`, nagegaan aan de hand van
`t1111.webm` en een gerandomiseerde soak. Daarna de herschrijving.

## Wat Tim zag (video, 3e kolom)

- Gegoide roze blokjes liepen een eerder gegooid roze blokje in en
  overlapten in dezelfde cel.
- Een gegooid geel blokje ging door twee roze blokjes heen en overlapte
  een vallend groen blokje.
- Bij de landing snapte de stapel, met een gat (geel, gat, roze, groen,
  roze).
- Een blokje leek van kleur of type te veranderen.
- Nog een worp ging door het onderste blokje heen.
- De cluster stortte in tot 2 cellen met overlaps, alsof blokjes
  verdwenen.
- Een worp liet de cluster in een gatloze 5-stapel teleporten, die
  vervolgens tot 3 rijen met overlaps inzakte.
- De stapel spreidde zich daarna naar beneden uit, met gaten en
  overlaps over meerdere frames.

## Gevonden oorzaken

1. **Een gegooid blokje duwde een cluster-kolom omhoog maar sloot niet
   aan (t1111).** `checkManualPush` / `pushClusterColumn` schoof de
   geraakte kolom 1 tegel op en zette `pushedClusters` zodat die worp
   de cluster niet nóg eens duwde. Het gegoide blokje zelf bleef
   MANUAL en vloog door de cluster heen. Elke volgende worp deed
   hetzelfde: door elkaar, overlaps, daarna een late pack die alles
   in één stapel duwde (“teleport naar een 5-stapel”).

2. **Twee gegooide (MANUAL) blokjes hadden geen botsing.** Een tweede
   worp in dezelfde kolom liep de eerste in en deelde een cel. Precies
   “roze haalt eerder roze in”.

3. **Een vliegende cluster was geen star lichaam.** Elk lid had een
   eigen `y`. `integrateClusters` telde dezelfde `dy` op, maar duwen,
   attach, merge en `packClusterOverlaps` werkten per blokje.
   Relatieve posities dreven uit elkaar (niet-gehele offsets, gaten
   én overlaps in dezelfde kolom).

4. **`packClusterOverlaps` herstelde alleen overlaps, en pas achteraf,
   door hogere blokjes omhoog te zetten.** Als vijf blokjes al in twee
   cellen zaten, werden ze in één keer een 5-stapel — de teleport uit
   de video. Bij gelijke `y` was de sorteervolgorde instabiel, wat als
   een kleur- of typewisseling oogde (identiteit van twee overlappende
   sprites).

5. **Botsingsdetectie was niet fully swept en niet alle paren.**
   Cluster-cluster keek alleen naar de eindstand van de substep, niet
   naar het pad. MANUAL–MANUAL ontbrak. MANUAL–cluster duwde zonder
   te mergen. Vallend–vliegend en MANUAL–vallend waren er (t1108)
   maar misten gevallen door de volgorde van de integrates.

6. **`stackTop` negeerde gaten.** Het nam de hoogste grounded
   oppervlakte in de hele kolom. Een hangend STILL-blokje boven een
   gat (bijvoorbeeld na het loslaten van een gelande cluster) liet
   vallende blokjes *onder* dat gat omhoog teleporten en daar landen.
   Dat is de “gatloze 5-stapel”-teleport bij landing, gevolgd door
   inzakkende overlaps als die blokjes daarna weer zonder steun
   vallen (“spreidt zich naar beneden uit”).

7. **`releaseUnsupported` deed maar twee vaste passes.** Een keten
   van stills op een net losgelaten gelande groep (A op B op C, C
   valt) liet de bovenste stills soms een tick te lang staan. Samen
   met (6) gaf dat hangende stills boven vallende buren, en dan de
   teleport.

8. **Landing van een slordige cluster hield gaten en overlaps.**
   `tryLandCluster` schoof het geheel zodat het diepste contact vlak
   zat, maar pakte niet eerst. Een gelande groep met rommelige `y`
   snapte, herschikte en kon onbedoelde matches triggeren (t1110
   op SETTLING cargo) — “verandering van kleur” die eigenlijk een
   match naar grijs of een overlap-illusie was. Echte kleurwijziging
   is alleen: match → grijs, en grijs → recolor.

9. **`fromManual`-snelheid middelen (t1108) kon de fase van een
   cluster omdraaien** als vallend cargo aansloot. Dat blijft de
   bedoelde regel voor worp+vallen, niet voor een schot in een
   bestaande cluster (die houdt zijn `vy`, het schot neemt die over).

## Wat er nu geldt

- Een vliegende cluster is één star lichaam: één `anchorY`, één `vy`,
  gehele `clusterOffset` per lid. `y = anchorY + offset` altijd.
  Merges en attaches zijn rooster-uitgelijnd. Volgorde in een kolom
  blijft (lagere `y` blijft lager; gelijke `y` breekt op `id`).
- **Schot in een cluster (t1111):** de geraakte kolom schuift 1 cel
  omhoog, het schot sluit onderaan aan, grid-aligned, als lid van de
  cluster. Elke volgende worp hetzelfde. De cluster houdt zijn
  snelheid. Andere kolommen blijven. Een schot dat van boven komt
  (dalend) gaat op het dak zitten, zoals vallend cargo.
- Twee gegooide blokjes die botsen: de eerste wordt een 1-blokjes-
  cluster, daarna geldt t1111. Een enkele worp blijft MANUAL (en
  blijft binnen het veld) tot hij ergens tegenaan botst.
- Worp + vallend: blijft t1108 (massagemiddelde `vy`, star lichaam).
  Vallend op een gewone match-raket: blijft “pak op, zelfde `vy`”.
- Swept botsing per substep tussen alle paren: worp–cluster,
  worp–worp, vallend–vliegend, vallend–worp, cluster–cluster.
  Daarna een vangnet (`resolveAirborneCollisions`) en herbouw van
  elk star lichaam.
- `stackTop(..., belowY)` telt alleen grounded blokjes onder de
  valler, nooit een hangend blokje erboven.
- `releaseUnsupported` herhaalt tot de keten stil is.
- Landing verschuift `anchorY`; offsets (en dus gaten die bewust in
  de starre vorm zitten, zoals een hangend lid over een vloer-gat)
  blijven. Overlaps zijn er dan niet meer.
- Invariant-checker (`checkInvariants`): geen overlap, geen dubbele
  cel, vliegende leden grid-aligned. Draait aan het eind van elke
  `tick` in tests (`strictInvariants`, standaard aan via `makeGame`)
  en met `?debug` (overlay, zonder te gooien). Kleur mag alleen
  wijzigen via match→grijs of grijs-recolor; de soak test beweert
  dat, en dat geen blokje verdwijnt zonder te scoren.

Zie ook de aannames onder t1111/t1112 in `docs/ASSUMPTIONS.md`.
