docs: physics-audit root causes and the new cluster rules (t1111/t1112)
@@ -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 breedte434
- De vlam onder raketten is 3× zo groot, in lengte én breedte435
(`0,85 × 3` tegels). De bovenkant van de vlam blijft op dezelfde435
(`0,85 × 3` tegels). De bovenkant van de vlam blijft op dezelfde436
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-audit439
440
- Zie `docs/PHYSICS.md` voor de volledige lijst van gevonden oorzaken441
(video `t1111.webm`) en de herschreven regels.442
- Schot in een vliegende cluster: de geraakte kolom 1 cel omhoog, het443
schot sluit onderaan aan, rooster-uitgelijnd, als lid. Elke volgende444
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 veranderen447
alleen via de bekende regels (match → grijs, grijs recolor, of448
scoren over de bovenkant).449
- `?debug` (of `?debug=physics` / `?debug=drag`) zet de450
invariant-checker aan en toont overtredingen in de overlay.@@ -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
3
Problemen die we vonden in de vlucht-, bots-, merge-, landings-, settle-4
en recolor-logica op master `1ede900`, nagegaan aan de hand van5
`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 en10
overlapten in dezelfde cel.11
- Een gegooid geel blokje ging door twee roze blokjes heen en overlapte12
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 blokjes18
verdwenen.19
- Een worp liet de cluster in een gatloze 5-stapel teleporten, die20
vervolgens tot 3 rijen met overlaps inzakte.21
- De stapel spreidde zich daarna naar beneden uit, met gaten en22
overlaps over meerdere frames.23
24
## Gevonden oorzaken25
26
1. **Een gegooid blokje duwde een cluster-kolom omhoog maar sloot niet27
aan (t1111).** `checkManualPush` / `pushClusterColumn` schoof de28
geraakte kolom 1 tegel op en zette `pushedClusters` zodat die worp29
de cluster niet nóg eens duwde. Het gegoide blokje zelf bleef30
MANUAL en vloog door de cluster heen. Elke volgende worp deed31
hetzelfde: door elkaar, overlaps, daarna een late pack die alles32
in één stapel duwde (“teleport naar een 5-stapel”).33
34
2. **Twee gegooide (MANUAL) blokjes hadden geen botsing.** Een tweede35
worp in dezelfde kolom liep de eerste in en deelde een cel. Precies36
“roze haalt eerder roze in”.37
38
3. **Een vliegende cluster was geen star lichaam.** Elk lid had een39
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, gaten42
é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 twee46
cellen zaten, werden ze in één keer een 5-stapel — de teleport uit47
de video. Bij gelijke `y` was de sorteervolgorde instabiel, wat als48
een kleur- of typewisseling oogde (identiteit van twee overlappende49
sprites).50
51
5. **Botsingsdetectie was niet fully swept en niet alle paren.**52
Cluster-cluster keek alleen naar de eindstand van de substep, niet53
naar het pad. MANUAL–MANUAL ontbrak. MANUAL–cluster duwde zonder54
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 grounded58
oppervlakte in de hele kolom. Een hangend STILL-blokje boven een59
gat (bijvoorbeeld na het loslaten van een gelande cluster) liet60
vallende blokjes *onder* dat gat omhoog teleporten en daar landen.61
Dat is de “gatloze 5-stapel”-teleport bij landing, gevolgd door62
inzakkende overlaps als die blokjes daarna weer zonder steun63
vallen (“spreidt zich naar beneden uit”).64
65
7. **`releaseUnsupported` deed maar twee vaste passes.** Een keten66
van stills op een net losgelaten gelande groep (A op B op C, C67
valt) liet de bovenste stills soms een tick te lang staan. Samen68
met (6) gaf dat hangende stills boven vallende buren, en dan de69
teleport.70
71
8. **Landing van een slordige cluster hield gaten en overlaps.**72
`tryLandCluster` schoof het geheel zodat het diepste contact vlak73
zat, maar pakte niet eerst. Een gelande groep met rommelige `y`74
snapte, herschikte en kon onbedoelde matches triggeren (t111075
op SETTLING cargo) — “verandering van kleur” die eigenlijk een76
match naar grijs of een overlap-illusie was. Echte kleurwijziging77
is alleen: match → grijs, en grijs → recolor.78
79
9. **`fromManual`-snelheid middelen (t1108) kon de fase van een80
cluster omdraaien** als vallend cargo aansloot. Dat blijft de81
bedoelde regel voor worp+vallen, niet voor een schot in een82
bestaande cluster (die houdt zijn `vy`, het schot neemt die over).83
84
## Wat er nu geldt85
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 kolom89
blijft (lagere `y` blijft lager; gelijke `y` breekt op `id`).90
- **Schot in een cluster (t1111):** de geraakte kolom schuift 1 cel91
omhoog, het schot sluit onderaan aan, grid-aligned, als lid van de92
cluster. Elke volgende worp hetzelfde. De cluster houdt zijn93
snelheid. Andere kolommen blijven. Een schot dat van boven komt94
(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 (en97
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 van103
elk star lichaam.104
- `stackTop(..., belowY)` telt alleen grounded blokjes onder de105
valler, nooit een hangend blokje erboven.106
- `releaseUnsupported` herhaalt tot de keten stil is.107
- Landing verschuift `anchorY`; offsets (en dus gaten die bewust in108
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 dubbele111
cel, vliegende leden grid-aligned. Draait aan het eind van elke112
`tick` in tests (`strictInvariants`, standaard aan via `makeGame`)113
en met `?debug` (overlay, zonder te gooien). Kleur mag alleen114
wijzigen via match→grijs of grijs-recolor; de soak test beweert115
dat, en dat geen blokje verdwijnt zonder te scoren.116
117
Zie ook de aannames onder t1111/t1112 in `docs/ASSUMPTIONS.md`.