BlueGit

projects-timfalken-com meteors

docs: physics-audit root causes and the new cluster rules (t1111/t1112)

timfa Grok Bot · pushed by timfa

Authored 2026-11-13 · 4 days ago

Hash
dab38eda9a7d425684f91abd037e814ff99d1567
Parent
7a7ea000
2 files changed +131 −0
docs/ASSUMPTIONS.md +14 −0
@@ -434,3 +434,17 @@ Aanname:
434 434 - De vlam onder raketten is 3× zo groot, in lengte én breedte
435 435 (`0,85 × 3` tegels). De bovenkant van de vlam blijft op dezelfde
436 436 overlap in het blokje; de extra lengte steekt naar beneden uit.
437
438 ## t1111 / t1112 — schot in een cluster, en physics-audit
439
440 - Zie `docs/PHYSICS.md` voor de volledige lijst van gevonden oorzaken
441 (video `t1111.webm`) en de herschreven regels.
442 - Schot in een vliegende cluster: de geraakte kolom 1 cel omhoog, het
443 schot sluit onderaan aan, rooster-uitgelijnd, als lid. Elke volgende
444 worp hetzelfde. Vliegende clusters zijn één star lichaam (één `y`/`vy`,
445 gehele offsets). Geen twee blokjes delen een cel of overlappen;
446 volgorde in een kolom blijft; verdwijnen/dupliceren/kleur veranderen
447 alleen via de bekende regels (match → grijs, grijs recolor, of
448 scoren over de bovenkant).
449 - `?debug` (of `?debug=physics` / `?debug=drag`) zet de
450 invariant-checker aan en toont overtredingen in de overlay.
@@ -434,3 +434,17 @@ Aanname:
434- De vlam onder raketten is 3× zo groot, in lengte én breedte
434- De vlam onder raketten is 3× zo groot, in lengte én breedte
435 (`0,85 × 3` tegels). De bovenkant van de vlam blijft op dezelfde
435 (`0,85 × 3` tegels). De bovenkant van de vlam blijft op dezelfde
436 overlap in het blokje; de extra lengte steekt naar beneden uit.
436 overlap in het blokje; de extra lengte steekt naar beneden uit.
437
438## t1111 / t1112 — schot in een cluster, en physics-audit
439
440- Zie `docs/PHYSICS.md` voor de volledige lijst van gevonden oorzaken
441 (video `t1111.webm`) en de herschreven regels.
442- Schot in een vliegende cluster: de geraakte kolom 1 cel omhoog, het
443 schot sluit onderaan aan, rooster-uitgelijnd, als lid. Elke volgende
444 worp hetzelfde. Vliegende clusters zijn één star lichaam (één `y`/`vy`,
445 gehele offsets). Geen twee blokjes delen een cel of overlappen;
446 volgorde in een kolom blijft; verdwijnen/dupliceren/kleur veranderen
447 alleen via de bekende regels (match → grijs, grijs recolor, of
448 scoren over de bovenkant).
449- `?debug` (of `?debug=physics` / `?debug=drag`) zet de
450 invariant-checker aan en toont overtredingen in de overlay.
docs/PHYSICS.md added +117 −0
@@ -0,0 +1,117 @@
1 # Physics-audit (t1111 / t1112)
2
3 Problemen die we vonden in de vlucht-, bots-, merge-, landings-, settle-
4 en recolor-logica op master `1ede900`, nagegaan aan de hand van
5 `t1111.webm` en een gerandomiseerde soak. Daarna de herschrijving.
6
7 ## Wat Tim zag (video, 3e kolom)
8
9 - Gegoide roze blokjes liepen een eerder gegooid roze blokje in en
10 overlapten in dezelfde cel.
11 - Een gegooid geel blokje ging door twee roze blokjes heen en overlapte
12 een vallend groen blokje.
13 - Bij de landing snapte de stapel, met een gat (geel, gat, roze, groen,
14 roze).
15 - Een blokje leek van kleur of type te veranderen.
16 - Nog een worp ging door het onderste blokje heen.
17 - De cluster stortte in tot 2 cellen met overlaps, alsof blokjes
18 verdwenen.
19 - Een worp liet de cluster in een gatloze 5-stapel teleporten, die
20 vervolgens tot 3 rijen met overlaps inzakte.
21 - De stapel spreidde zich daarna naar beneden uit, met gaten en
22 overlaps over meerdere frames.
23
24 ## Gevonden oorzaken
25
26 1. **Een gegooid blokje duwde een cluster-kolom omhoog maar sloot niet
27 aan (t1111).** `checkManualPush` / `pushClusterColumn` schoof de
28 geraakte kolom 1 tegel op en zette `pushedClusters` zodat die worp
29 de cluster niet nóg eens duwde. Het gegoide blokje zelf bleef
30 MANUAL en vloog door de cluster heen. Elke volgende worp deed
31 hetzelfde: door elkaar, overlaps, daarna een late pack die alles
32 in één stapel duwde (“teleport naar een 5-stapel”).
33
34 2. **Twee gegooide (MANUAL) blokjes hadden geen botsing.** Een tweede
35 worp in dezelfde kolom liep de eerste in en deelde een cel. Precies
36 “roze haalt eerder roze in”.
37
38 3. **Een vliegende cluster was geen star lichaam.** Elk lid had een
39 eigen `y`. `integrateClusters` telde dezelfde `dy` op, maar duwen,
40 attach, merge en `packClusterOverlaps` werkten per blokje.
41 Relatieve posities dreven uit elkaar (niet-gehele offsets, gaten
42 én overlaps in dezelfde kolom).
43
44 4. **`packClusterOverlaps` herstelde alleen overlaps, en pas achteraf,
45 door hogere blokjes omhoog te zetten.** Als vijf blokjes al in twee
46 cellen zaten, werden ze in één keer een 5-stapel — de teleport uit
47 de video. Bij gelijke `y` was de sorteervolgorde instabiel, wat als
48 een kleur- of typewisseling oogde (identiteit van twee overlappende
49 sprites).
50
51 5. **Botsingsdetectie was niet fully swept en niet alle paren.**
52 Cluster-cluster keek alleen naar de eindstand van de substep, niet
53 naar het pad. MANUAL–MANUAL ontbrak. MANUAL–cluster duwde zonder
54 te mergen. Vallend–vliegend en MANUAL–vallend waren er (t1108)
55 maar misten gevallen door de volgorde van de integrates.
56
57 6. **`stackTop` negeerde gaten.** Het nam de hoogste grounded
58 oppervlakte in de hele kolom. Een hangend STILL-blokje boven een
59 gat (bijvoorbeeld na het loslaten van een gelande cluster) liet
60 vallende blokjes *onder* dat gat omhoog teleporten en daar landen.
61 Dat is de “gatloze 5-stapel”-teleport bij landing, gevolgd door
62 inzakkende overlaps als die blokjes daarna weer zonder steun
63 vallen (“spreidt zich naar beneden uit”).
64
65 7. **`releaseUnsupported` deed maar twee vaste passes.** Een keten
66 van stills op een net losgelaten gelande groep (A op B op C, C
67 valt) liet de bovenste stills soms een tick te lang staan. Samen
68 met (6) gaf dat hangende stills boven vallende buren, en dan de
69 teleport.
70
71 8. **Landing van een slordige cluster hield gaten en overlaps.**
72 `tryLandCluster` schoof het geheel zodat het diepste contact vlak
73 zat, maar pakte niet eerst. Een gelande groep met rommelige `y`
74 snapte, herschikte en kon onbedoelde matches triggeren (t1110
75 op SETTLING cargo) — “verandering van kleur” die eigenlijk een
76 match naar grijs of een overlap-illusie was. Echte kleurwijziging
77 is alleen: match → grijs, en grijs → recolor.
78
79 9. **`fromManual`-snelheid middelen (t1108) kon de fase van een
80 cluster omdraaien** als vallend cargo aansloot. Dat blijft de
81 bedoelde regel voor worp+vallen, niet voor een schot in een
82 bestaande cluster (die houdt zijn `vy`, het schot neemt die over).
83
84 ## Wat er nu geldt
85
86 - Een vliegende cluster is één star lichaam: één `anchorY`, één `vy`,
87 gehele `clusterOffset` per lid. `y = anchorY + offset` altijd.
88 Merges en attaches zijn rooster-uitgelijnd. Volgorde in een kolom
89 blijft (lagere `y` blijft lager; gelijke `y` breekt op `id`).
90 - **Schot in een cluster (t1111):** de geraakte kolom schuift 1 cel
91 omhoog, het schot sluit onderaan aan, grid-aligned, als lid van de
92 cluster. Elke volgende worp hetzelfde. De cluster houdt zijn
93 snelheid. Andere kolommen blijven. Een schot dat van boven komt
94 (dalend) gaat op het dak zitten, zoals vallend cargo.
95 - Twee gegooide blokjes die botsen: de eerste wordt een 1-blokjes-
96 cluster, daarna geldt t1111. Een enkele worp blijft MANUAL (en
97 blijft binnen het veld) tot hij ergens tegenaan botst.
98 - Worp + vallend: blijft t1108 (massagemiddelde `vy`, star lichaam).
99 Vallend op een gewone match-raket: blijft “pak op, zelfde `vy`”.
100 - Swept botsing per substep tussen alle paren: worp–cluster,
101 worp–worp, vallend–vliegend, vallend–worp, cluster–cluster.
102 Daarna een vangnet (`resolveAirborneCollisions`) en herbouw van
103 elk star lichaam.
104 - `stackTop(..., belowY)` telt alleen grounded blokjes onder de
105 valler, nooit een hangend blokje erboven.
106 - `releaseUnsupported` herhaalt tot de keten stil is.
107 - Landing verschuift `anchorY`; offsets (en dus gaten die bewust in
108 de starre vorm zitten, zoals een hangend lid over een vloer-gat)
109 blijven. Overlaps zijn er dan niet meer.
110 - Invariant-checker (`checkInvariants`): geen overlap, geen dubbele
111 cel, vliegende leden grid-aligned. Draait aan het eind van elke
112 `tick` in tests (`strictInvariants`, standaard aan via `makeGame`)
113 en met `?debug` (overlay, zonder te gooien). Kleur mag alleen
114 wijzigen via match→grijs of grijs-recolor; de soak test beweert
115 dat, en dat geen blokje verdwijnt zonder te scoren.
116
117 Zie ook de aannames onder t1111/t1112 in `docs/ASSUMPTIONS.md`.
@@ -0,0 +1,117 @@
1# Physics-audit (t1111 / t1112)
2
3Problemen die we vonden in de vlucht-, bots-, merge-, landings-, settle-
4en recolor-logica op master `1ede900`, nagegaan aan de hand van
5`t1111.webm` en een gerandomiseerde soak. Daarna de herschrijving.
6
7## Wat Tim zag (video, 3e kolom)
8
9- Gegoide roze blokjes liepen een eerder gegooid roze blokje in en
10 overlapten in dezelfde cel.
11- Een gegooid geel blokje ging door twee roze blokjes heen en overlapte
12 een vallend groen blokje.
13- Bij de landing snapte de stapel, met een gat (geel, gat, roze, groen,
14 roze).
15- Een blokje leek van kleur of type te veranderen.
16- Nog een worp ging door het onderste blokje heen.
17- De cluster stortte in tot 2 cellen met overlaps, alsof blokjes
18 verdwenen.
19- Een worp liet de cluster in een gatloze 5-stapel teleporten, die
20 vervolgens tot 3 rijen met overlaps inzakte.
21- De stapel spreidde zich daarna naar beneden uit, met gaten en
22 overlaps over meerdere frames.
23
24## Gevonden oorzaken
25
261. **Een gegooid blokje duwde een cluster-kolom omhoog maar sloot niet
27 aan (t1111).** `checkManualPush` / `pushClusterColumn` schoof de
28 geraakte kolom 1 tegel op en zette `pushedClusters` zodat die worp
29 de cluster niet nóg eens duwde. Het gegoide blokje zelf bleef
30 MANUAL en vloog door de cluster heen. Elke volgende worp deed
31 hetzelfde: door elkaar, overlaps, daarna een late pack die alles
32 in één stapel duwde (“teleport naar een 5-stapel”).
33
342. **Twee gegooide (MANUAL) blokjes hadden geen botsing.** Een tweede
35 worp in dezelfde kolom liep de eerste in en deelde een cel. Precies
36 “roze haalt eerder roze in”.
37
383. **Een vliegende cluster was geen star lichaam.** Elk lid had een
39 eigen `y`. `integrateClusters` telde dezelfde `dy` op, maar duwen,
40 attach, merge en `packClusterOverlaps` werkten per blokje.
41 Relatieve posities dreven uit elkaar (niet-gehele offsets, gaten
42 én overlaps in dezelfde kolom).
43
444. **`packClusterOverlaps` herstelde alleen overlaps, en pas achteraf,
45 door hogere blokjes omhoog te zetten.** Als vijf blokjes al in twee
46 cellen zaten, werden ze in één keer een 5-stapel — de teleport uit
47 de video. Bij gelijke `y` was de sorteervolgorde instabiel, wat als
48 een kleur- of typewisseling oogde (identiteit van twee overlappende
49 sprites).
50
515. **Botsingsdetectie was niet fully swept en niet alle paren.**
52 Cluster-cluster keek alleen naar de eindstand van de substep, niet
53 naar het pad. MANUAL–MANUAL ontbrak. MANUAL–cluster duwde zonder
54 te mergen. Vallend–vliegend en MANUAL–vallend waren er (t1108)
55 maar misten gevallen door de volgorde van de integrates.
56
576. **`stackTop` negeerde gaten.** Het nam de hoogste grounded
58 oppervlakte in de hele kolom. Een hangend STILL-blokje boven een
59 gat (bijvoorbeeld na het loslaten van een gelande cluster) liet
60 vallende blokjes *onder* dat gat omhoog teleporten en daar landen.
61 Dat is de “gatloze 5-stapel”-teleport bij landing, gevolgd door
62 inzakkende overlaps als die blokjes daarna weer zonder steun
63 vallen (“spreidt zich naar beneden uit”).
64
657. **`releaseUnsupported` deed maar twee vaste passes.** Een keten
66 van stills op een net losgelaten gelande groep (A op B op C, C
67 valt) liet de bovenste stills soms een tick te lang staan. Samen
68 met (6) gaf dat hangende stills boven vallende buren, en dan de
69 teleport.
70
718. **Landing van een slordige cluster hield gaten en overlaps.**
72 `tryLandCluster` schoof het geheel zodat het diepste contact vlak
73 zat, maar pakte niet eerst. Een gelande groep met rommelige `y`
74 snapte, herschikte en kon onbedoelde matches triggeren (t1110
75 op SETTLING cargo) — “verandering van kleur” die eigenlijk een
76 match naar grijs of een overlap-illusie was. Echte kleurwijziging
77 is alleen: match → grijs, en grijs → recolor.
78
799. **`fromManual`-snelheid middelen (t1108) kon de fase van een
80 cluster omdraaien** als vallend cargo aansloot. Dat blijft de
81 bedoelde regel voor worp+vallen, niet voor een schot in een
82 bestaande cluster (die houdt zijn `vy`, het schot neemt die over).
83
84## Wat er nu geldt
85
86- Een vliegende cluster is één star lichaam: één `anchorY`, één `vy`,
87 gehele `clusterOffset` per lid. `y = anchorY + offset` altijd.
88 Merges en attaches zijn rooster-uitgelijnd. Volgorde in een kolom
89 blijft (lagere `y` blijft lager; gelijke `y` breekt op `id`).
90- **Schot in een cluster (t1111):** de geraakte kolom schuift 1 cel
91 omhoog, het schot sluit onderaan aan, grid-aligned, als lid van de
92 cluster. Elke volgende worp hetzelfde. De cluster houdt zijn
93 snelheid. Andere kolommen blijven. Een schot dat van boven komt
94 (dalend) gaat op het dak zitten, zoals vallend cargo.
95- Twee gegooide blokjes die botsen: de eerste wordt een 1-blokjes-
96 cluster, daarna geldt t1111. Een enkele worp blijft MANUAL (en
97 blijft binnen het veld) tot hij ergens tegenaan botst.
98- Worp + vallend: blijft t1108 (massagemiddelde `vy`, star lichaam).
99 Vallend op een gewone match-raket: blijft “pak op, zelfde `vy`”.
100- Swept botsing per substep tussen alle paren: worp–cluster,
101 worp–worp, vallend–vliegend, vallend–worp, cluster–cluster.
102 Daarna een vangnet (`resolveAirborneCollisions`) en herbouw van
103 elk star lichaam.
104- `stackTop(..., belowY)` telt alleen grounded blokjes onder de
105 valler, nooit een hangend blokje erboven.
106- `releaseUnsupported` herhaalt tot de keten stil is.
107- Landing verschuift `anchorY`; offsets (en dus gaten die bewust in
108 de starre vorm zitten, zoals een hangend lid over een vloer-gat)
109 blijven. Overlaps zijn er dan niet meer.
110- Invariant-checker (`checkInvariants`): geen overlap, geen dubbele
111 cel, vliegende leden grid-aligned. Draait aan het eind van elke
112 `tick` in tests (`strictInvariants`, standaard aan via `makeGame`)
113 en met `?debug` (overlay, zonder te gooien). Kleur mag alleen
114 wijzigen via match→grijs of grijs-recolor; de soak test beweert
115 dat, en dat geen blokje verdwijnt zonder te scoren.
116
117Zie ook de aannames onder t1111/t1112 in `docs/ASSUMPTIONS.md`.