# 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`.