wave pairing: 36-58% of GF/DecayGF/KNN learning samples were MISLABELLED

The audit inferred (from code) that GF/DecayGF/KNN pop the OLDEST wave on
resolution, while under bmPath bullets leave the arena in NON-FIFO order - so an
outcome could be attached to the wrong wave. It also noted that `starved=0` does
NOT rule this out. Both halves are now MEASURED.

MISPAIRING RATE (10 DrussGT fixtures, real VirtualTracker, 344k resolutions/gun):
  gun         bmPath mispair   label err      bmPoint mispair   label err
  GuessFactor     36.48%         19.39%           18.24%          7.62%
  DecayGF         36.85%         19.52%           20.57%          8.64%
  KNN             57.91%         27.63%           29.75%         11.58%
  (starved = 0 everywhere, exactly as the audit predicted)
So ~1 in 5 GF/DecayGF learning samples and ~1 in 4 KNN samples carried a WRONG
guess-factor bin. This is a material corruption of the learning signal.

FIX: the same fireTick-keyed ring scheme `tsetlin.nim`/`tm_selector.nim` already
use - `slot = (fireTick*4 + bin) mod 1024` (period 256 ticks, longer than the
~91-tick max flight), looked up by exact key. Public interfaces unchanged; added
`waveResolved`/`waveMispaired` integrity counters. AFTER: mispaired = 0 and
starved = 0, both metrics, all three guns.

EFFECT ON HIT RATE: SMALL AND NOT SIGNIFICANT. bmPath 4000 samples/gun:
  GuessFactor 23.20% -> 23.02% (-0.18pp, per-run sign-flip p=0.750)
  DecayGF     23.80% -> 24.25% (+0.45pp, p=0.625)
  KNN         18.27% -> 18.80% (+0.53pp, p=0.547)
bmPoint: +0.05 / +0.33 / -0.15pp, p = 1.00 / 0.50 / 0.50. Per-run ranges overlap
almost completely. A bullet-level z-test is anti-conservative (bullets within a
fixture share a trajectory) and its KNN p=1.9e-16 cannot be trusted given ~10
effective independent runs.
PLAIN READING: this is a CORRECTNESS fix, not a measurable hit-rate win. It
removes a 36-58% mislabelling of the learning signal; the point estimates move by
at most ~0.5pp, within run-to-run noise. Stated plainly rather than oversold.

A REGRESSION IT CAUGHT IN ITSELF (and this explains the SIGSEGV another job saw
and correctly attributed to a concurrent knn_gun.nim rewrite): the first
implementation put an inline `array[1024, KNNWave]` (~100KB) inside each gun,
which overflowed the default 8MB stack and made `test_power_selection` SIGSEGV.
Causation was proven by stashing only the three gun files (test passed), then
fixed by making the rings heap-backed `seq`. Verified: `test_power_selection`
3 PASS on the default stack, and zero inline `array[1024]` remain.

Guards: test_wave_pairing 17 (new, pure), test_gun_harness 39,
test_vbullet_metric 11, test_power_selection 3, test_adaptive_radar 41,
test_tfil_ring_weights 24, test_power_policy 26, test_ram_decision 28.
ModularBot compiles. Adds audit_wave_pairing.nim and compare_pairing.nim.
This commit is contained in:
2026-09-22 01:33:31 +02:00
parent 1ea72c7f14
commit 4657fe715e
6 changed files with 586 additions and 65 deletions
+149
View File
@@ -0,0 +1,149 @@
## Task 1 + Task 3 measurement: wave-pairing audit and before/after hit rates for
## the three learned GF guns (GuessFactor / DecayGF / KNN).
##
## Replays the committed DrussGT fixtures through the REAL VirtualTracker, exactly
## as common_libs/gun_harness/offline_range.replayFixture does, but keeps handles
## to the concrete guns so it can read their pairing-audit counters and dump the
## raw per-bullet hit booleans for a later bullet-level permutation test.
##
## Run:
## nim c -r --path:common_libs common_libs/tests/audit_wave_pairing.nim <tag> [metric]
## tag = label written into /tmp/wavepair_<tag>_<metric>.txt
## metric = path (default, shipped) | point | both
import std/[os, math, strformat, tables, algorithm, random]
import gun_harness/gun_interface
import gun_harness/virtual_bullets as vb
import gun_harness/offline_range
import guns/guess_factor
import guns/decay_gf
import guns/knn_gun
const fixturesDir = currentSourcePath().parentDir.parentDir.parentDir / "tools" / "fixtures"
const GunNames = ["GuessFactor", "DecayGF", "KNN"]
type
Ref[G] = ref object
g: G
proc mkRef[G](v: G): Ref[G] = Ref[G](g: v)
proc driver[G](name: string, r: Ref[G]): GunDriver =
result.name = name
result.predictCb = proc(s: WorldState, sp: float): GunPrediction = r.g.predict(s, sp)
result.resultCb = proc(e: FeedbackEvent) = r.g.onResult(e)
result.readyCb = nil
proc collectOne(fx: Fixture, drivers: seq[GunDriver], metric: BulletMetric,
perGunHits: ref seq[seq[bool]]): seq[GunReport] =
let tid = fx.enemyId
var tracker = vb.initTracker(drivers.len, metric)
for si in 0..<fx.states.len:
let state = fx.states[si]
for gi in 0..<drivers.len:
var preds: array[len(PowerBins), GunPrediction]
for i in 0..<len(PowerBins):
preds[i] = drivers[gi].predictCb(state, bulletSpeed(PowerBins[i]))
tracker.spawnBullets(gi, preds, state, tid)
let act = fx.states[si]
var enemyPositions: Table[int, tuple[x, y: float, lastSeenTick: int, alive: bool]]
var lst = act.tick
if si < fx.lastSeen.len and fx.lastSeen[si] >= 0: lst = fx.lastSeen[si]
enemyPositions[tid] = (x: act.enemyX, y: act.enemyY, lastSeenTick: lst, alive: true)
let dref = drivers
tracker.tickBullets(state, enemyPositions,
proc(gunId: GunId, binIdx: int, e: FeedbackEvent) =
dref[gunId].resultCb(e)
perGunHits[gunId].add e.hit)
let fit = tracker.fitnessFor(tid)
for gi in 0..<drivers.len:
var r = GunReport(name: drivers[gi].name)
for binIdx in 0..<len(PowerBins):
let fw = fit[gi].bins[binIdx]
let n = min(fw.count, WindowSize)
for k in 0..<n:
if fw.hits[k]: inc r.hits
r.shots += n
result.add r
proc rate(h, n: int): float = (if n == 0: 0.0 else: h.float / n.float * 100.0)
proc runMetric(mname: string, metric: BulletMetric, tag: string) =
echo "################################################################"
echo "### METRIC = ", mname, " (", metric, ")"
echo "################################################################"
var pooled = [0, 0, 0]
var pooledN = [0, 0, 0]
var perGunHits: seq[seq[bool]]
perGunHits.setLen(3)
var perFixtureRate: array[3, seq[float]]
var files: seq[string]
for f in walkFiles(fixturesDir / "tr_drussgt_*.jsonl"): files.add f
for f in walkFiles(fixturesDir / "drussgt_*.jsonl"): files.add f
files.sort()
# Totals accumulated from FRESH guns per fixture (no cross-fixture learning).
var totResolved, totMispaired, totStarved, totPushes: array[3, int]
for path in files:
var fx = loadFixture(path)
if fx.states.len < 50: continue
let gfRef = mkRef(initGFGun())
let decRef = mkRef(initDecayGFGun())
let knnRef = mkRef(initKNNGun())
let drivers = @[driver("GuessFactor", gfRef), driver("DecayGF", decRef),
driver("KNN", knnRef)]
let thisHits = new(seq[seq[bool]])
thisHits[].setLen(3)
let reps = collectOne(fx, drivers, metric, thisHits)
var line = fmt"{extractFilename(path):<42}"
for gi in 0..<3:
let r = reps[gi]
pooled[gi] += r.hits; pooledN[gi] += r.shots
perFixtureRate[gi].add rate(r.hits, r.shots)
for h in thisHits[gi]: perGunHits[gi].add h
line.add fmt" {GunNames[gi]}={r.hits:>4}/{r.shots:<4}"
echo line
totResolved[0] += gfRef.g.waveResolved; totMispaired[0] += gfRef.g.waveMispaired
totMispaired[0] += gfRef.g.waveMispaired; totStarved[0] += gfRef.g.waveStarved
totPushes[0] += gfRef.g.wavePushes
totResolved[1] += decRef.g.waveResolved; totMispaired[1] += decRef.g.waveMispaired
totStarved[1] += decRef.g.waveStarved
totPushes[1] += decRef.g.wavePushes
totResolved[2] += knnRef.g.waveResolved; totMispaired[2] += knnRef.g.waveMispaired
totStarved[2] += knnRef.g.waveStarved
totPushes[2] += knnRef.g.wavePushes
echo ""
echo "── pooled hit rate (", mname, ") ──"
for gi in 0..<3:
echo fmt"{GunNames[gi]:<12} {pooled[gi]:>5}/{pooledN[gi]:<6} {rate(pooled[gi], pooledN[gi]):>6.2f}% per-fixture min/max {min(perFixtureRate[gi]):.1f}/{max(perFixtureRate[gi]):.1f}"
echo ""
echo "── pairing audit (", mname, ") ──"
echo "gun resolved mispaired mispair% starved pushes"
for gi, name in GunNames:
echo fmt"{name:<12} {totResolved[gi]:>8} {totMispaired[gi]:>10} {rate(totMispaired[gi], totResolved[gi]):>8.2f} {totStarved[gi]:>7} {totPushes[gi]:>6}"
# Dump per-gun hit booleans for the cross-build permutation test.
for gi in 0..<3:
let path = fmt"/tmp/wavepair_{tag}_{mname}_{GunNames[gi]}.txt"
var f = open(path, fmWrite)
defer: f.close()
for h in perGunHits[gi]:
f.writeLine(if h: "1" else: "0")
echo fmt"dumped {perGunHits[gi].len} outcomes -> {path}"
proc main() =
let tag = if paramCount() >= 1: paramStr(1) else: "run"
let metricArg = if paramCount() >= 2: paramStr(2) else: "path"
case metricArg
of "point": runMetric("point", bmPoint, tag)
of "both": (runMetric("path", bmPath, tag); runMetric("point", bmPoint, tag))
else: runMetric("path", bmPath, tag)
echo "\ndone."
when isMainModule:
randomize(1)
main()
+146
View File
@@ -0,0 +1,146 @@
## Task 3 analysis: compare the FIFO (before) and fireTick-keyed (after) pairing
## for the three learned GF guns.
##
## Two analyses:
## 1. Per-fixture (per-run) paired comparison — the repo's convention. The 10
## DrussGT fixtures are the independent runs; the paired delta is
## after - before. An exact sign-flip permutation test (2^10 = 1024 sign
## patterns) gives the p-value, and the per-run ranges give the overlap.
## 2. Bullet-level two-sample permutation test on the raw hit booleans dumped
## by audit_wave_pairing.nim. ANTI-CONSERVATIVE: bullets within a fixture
## share a trajectory and are correlated, so treat this as an upper bound on
## significance, not the headline.
##
## Run: nim c -r common_libs/tests/compare_pairing.nim
import std/[math, strformat, random, os, strutils]
const
FixtureNames = ["drussgt_vs_corners", "drussgt_vs_crazy", "drussgt_vs_drussgt",
"drussgt_vs_ramfire", "drussgt_vs_spinbot",
"tr_drussgt_vs_corners", "tr_drussgt_vs_crazy",
"tr_drussgt_vs_modularbot", "tr_drussgt_vs_modularbot_shield",
"tr_drussgt_vs_spinbot"]
ShotsPerFixture = 400 # WindowSize(100) x 4 power bins
GunNames = ["GuessFactor", "DecayGF", "KNN"]
# Captured from `audit_wave_pairing.nim <tag> both` (fresh guns per fixture;
# hits out of 400). Deterministic guns -> reproducible.
BeforePath: array[3, array[10, int]] = [
[36, 139, 23, 202, 233, 155, 9, 47, 42, 42], # GuessFactor
[61, 108, 8, 204, 232, 118, 9, 44, 108, 60], # DecayGF
[16, 94, 33, 188, 176, 123, 12, 33, 19, 37], # KNN
]
AfterPath: array[3, array[10, int]] = [
[36, 139, 23, 202, 226, 155, 12, 44, 42, 42],
[61, 105, 19, 213, 226, 140, 9, 47, 108, 42],
[38, 94, 38, 193, 158, 129, 11, 29, 25, 37],
]
BeforePoint: array[3, array[10, int]] = [
[5, 33, 15, 59, 59, 36, 0, 26, 3, 21],
[1, 8, 2, 37, 52, 48, 0, 0, 33, 6],
[0, 19, 14, 53, 34, 39, 13, 15, 5, 25],
]
AfterPoint: array[3, array[10, int]] = [
[5, 33, 15, 59, 59, 36, 0, 28, 3, 21],
[1, 9, 2, 37, 52, 48, 0, 0, 45, 6],
[0, 20, 15, 48, 33, 38, 13, 14, 5, 25],
]
proc sum(a: array[10, int]): int =
for x in a: result += x
proc meanPct(a: array[10, int]): float = sum(a).float / 10.0 / ShotsPerFixture.float * 100.0
proc minPct(a: array[10, int]): float =
result = 1e9
for x in a: result = min(result, x.float / ShotsPerFixture.float * 100.0)
proc maxPct(a: array[10, int]): float =
result = -1e9
for x in a: result = max(result, x.float / ShotsPerFixture.float * 100.0)
proc signFlipP(before, after: array[10, int]): tuple[p, obsMeanPp: float, nPos, nNeg, nZero: int] =
## Exact sign-flip permutation test on the paired per-fixture deltas.
var deltas: array[10, float]
for i in 0..<10:
deltas[i] = (after[i] - before[i]).float / ShotsPerFixture.float * 100.0
if deltas[i] > 1e-9: inc result.nPos
elif deltas[i] < -1e-9: inc result.nNeg
else: inc result.nZero
result.obsMeanPp += deltas[i] / 10.0
let obs = abs(result.obsMeanPp)
var ge = 0
for mask in 0..<(1 shl 10):
var m = 0.0
for i in 0..<10:
let s = if ((mask shr i) and 1) == 1: -1.0 else: 1.0
m += s * deltas[i] / 10.0
if abs(m) >= obs - 1e-12: inc ge
result.p = ge.float / 1024.0
proc loadDump(path: string): seq[bool] =
if not fileExists(path):
return @[]
for line in lines(path):
let s = line.strip()
if s.len == 0: continue
result.add (s == "1")
proc zTest(a, b: seq[bool]): tuple[p, diffPp, z: float] =
## Two-proportion z-test (analytic; the permutation equivalent is exact but
## 344k-element shuffles are needlessly slow). ANTI-CONSERVATIVE because the
## bullets are correlated within a fixture.
if a.len == 0 or b.len == 0: return (1.0, 0.0, 0.0)
var ha, hb: int
for x in a: (if x: inc ha)
for x in b: (if x: inc hb)
let p1 = ha.float / a.len.float
let p2 = hb.float / b.len.float
result.diffPp = (p2 - p1) * 100.0
let p = (ha + hb).float / (a.len + b.len).float
let se = sqrt(max(1e-30, p * (1.0 - p) * (1.0/a.len.float + 1.0/b.len.float)))
result.z = (p2 - p1) / se
result.p = erfc(abs(result.z) / sqrt(2.0))
proc reportMetric(mname: string,
before, after: array[3, array[10, int]]) =
echo "══════════════════════════════════════════════════════════════════"
echo " METRIC = ", mname
echo "══════════════════════════════════════════════════════════════════"
for gi in 0..<2:
let b = before[gi]
let a = after[gi]
echo fmt"{GunNames[gi]}:"
echo fmt" before {sum(b):>4}/{ShotsPerFixture*10} = {meanPct(b):5.2f}% per-run {minPct(b):5.2f}..{maxPct(b):5.2f}%"
echo fmt" after {sum(a):>4}/{ShotsPerFixture*10} = {meanPct(a):5.2f}% per-run {minPct(a):5.2f}..{maxPct(a):5.2f}%"
let sf = signFlipP(b, a)
echo fmt" delta {meanPct(a)-meanPct(b):+5.2f}pp paired sign-flip permutation p={sf.p:.3f} (+{sf.nPos}/-{sf.nNeg}/0:{sf.nZero} of 10)"
let b = before[2]
let a = after[2]
echo fmt"{GunNames[2]}:"
echo fmt" before {sum(b):>4}/{ShotsPerFixture*10} = {meanPct(b):5.2f}% per-run {minPct(b):5.2f}..{maxPct(b):5.2f}%"
echo fmt" after {sum(a):>4}/{ShotsPerFixture*10} = {meanPct(a):5.2f}% per-run {minPct(a):5.2f}..{maxPct(a):5.2f}%"
let sf = signFlipP(b, a)
echo fmt" delta {meanPct(a)-meanPct(b):+5.2f}pp paired sign-flip permutation p={sf.p:.3f} (+{sf.nPos}/-{sf.nNeg}/0:{sf.nZero} of 10)"
echo ""
proc main() =
randomize(12345)
reportMetric("bmPath (shipped)", BeforePath, AfterPath)
reportMetric("bmPoint", BeforePoint, AfterPoint)
echo "══════════════════════════════════════════════════════════════════"
echo " bullet-level two-proportion z-test (bmPath dumps) — ANTI-CONSERVATIVE"
echo "══════════════════════════════════════════════════════════════════"
for gi in 0..<3:
let bf = loadDump(fmt"/tmp/wavepair_before_path_{GunNames[gi]}.txt")
let af = loadDump(fmt"/tmp/wavepair_after_path_{GunNames[gi]}.txt")
let r = zTest(bf, af)
var hb, ha: int
for x in bf: (if x: inc hb)
for x in af: (if x: inc ha)
echo fmt"{GunNames[gi]:<12} before {hb:>6}/{bf.len:<6} {hb.float/bf.len.float*100:5.2f}% after {ha:>6}/{af.len:<6} {ha.float/af.len.float*100:5.2f}% diff {r.diffPp:+5.2f}pp z={r.z:+5.2f} p={r.p:.2g}"
when isMainModule:
main()
+170
View File
@@ -0,0 +1,170 @@
## Pure unit test for the fireTick-keyed wave pairing in the learned GF guns
## (guess_factor.nim, decay_gf.nim, knn_gun.nim). No battle, no Java, no fixtures.
##
## The defect this pins: the guns used to pop the OLDEST queued wave on every
## resolution (FIFO). Under the shipped bmPath metric a later-fired bullet can
## resolve first, so the outcome was attached to the wrong wave. The fix keys
## each wave by (fireTick, powerBin) exactly, as tsetlin.nim / tm_selector.nim do.
##
## The discriminating property is ORDER-INDEPENDENCE: with exact keying, learning
## from the same set of (wave, resolution) pairs must be identical no matter what
## order the resolutions arrive in. Under FIFO, resolving in reverse order pairs
## each event with the wrong wave and the learned state diverges.
##
## Run: nim c -r --path:common_libs common_libs/tests/test_wave_pairing.nim
import std/math
import gun_harness/gun_interface
import guns/guess_factor
import guns/decay_gf
import guns/knn_gun
var failures = 0
proc check(name: string, ok: bool) =
if ok: echo "PASS: ", name
else: echo "FAIL: ", name; inc failures
const Spd = 17.0 # bulletSpeed(PowerBins[0]); all tests use power bin 0
const N = 6 # 6 waves, enough for KNN to leave its <5 cold-start fallback
var Px: array[N, float]
var Py: array[N, float]
for i in 0..<N:
let a = float(i) * PI / 3.0
Px[i] = 100.0 + 300.0 * cos(a)
Py[i] = 100.0 + 300.0 * sin(a)
proc ws(tick: int, ex, ey: float): WorldState =
WorldState(selfX: 100.0, selfY: 100.0, selfSpeed: 0.0, selfHeading: 0.0,
selfRadarHeading: 0.0, selfEnergy: 100.0,
enemyX: ex, enemyY: ey, enemySpeed: 0.0, enemyHeading: 0.0,
enemyEnergy: 100.0,
arenaWidth: 800.0, arenaHeight: 600.0, tick: tick)
proc ev(tick: int, ex, ey: float): FeedbackEvent =
FeedbackEvent(prediction: GunPrediction(x: ex, y: ey),
actualX: ex, actualY: ey, bulletPower: 1.0,
fireTick: tick, powerBin: 0, missDistance: 0.0, hit: true)
proc samePoint(a, b: GunPrediction): bool =
abs(a.x - b.x) < 1e-6 and abs(a.y - b.y) < 1e-6
# ── GuessFactor ───────────────────────────────────────────────────────────────
proc testGF() =
var fwd = initGFGun()
var rev = initGFGun()
for i in 0..<N:
discard fwd.predict(ws(i, Px[i], Py[i]), Spd)
discard rev.predict(ws(i, Px[i], Py[i]), Spd)
for i in 0..<N: fwd.onResult(ev(i, Px[i], Py[i]))
for i in countdown(N-1, 0): rev.onResult(ev(i, Px[i], Py[i]))
let qf = fwd.predict(ws(100, 400.0, 300.0), Spd)
let qr = rev.predict(ws(100, 400.0, 300.0), Spd)
check "GF: reverse resolution learns the SAME state as forward (order-independent)",
fwd.peakBin() == rev.peakBin() and samePoint(qf, qr)
check "GF: every wave resolved exactly once in both orders",
fwd.waveResolved == N and rev.waveResolved == N
check "GF: no mispair / no starve",
fwd.waveMispaired == 0 and rev.waveMispaired == 0 and
fwd.waveStarved == 0 and rev.waveStarved == 0
proc testGFMissingWave() =
var g = initGFGun()
discard g.predict(ws(0, Px[0], Py[0]), Spd)
g.onResult(ev(999, Px[0], Py[0]))
check "GF: unknown fireTick -> starved, nothing resolved",
g.waveStarved == 1 and g.waveResolved == 0
g.onResult(ev(0, Px[0], Py[0]))
check "GF: the real wave still resolves after an unknown-tick event",
g.waveResolved == 1 and g.waveStarved == 1
g.onResult(ev(0, Px[0], Py[0]))
check "GF: a second resolve of a consumed wave is counted, not applied",
g.waveResolved == 1 and g.waveStarved == 2
# ── DecayGF ───────────────────────────────────────────────────────────────────
proc testDecayGF() =
var fwd = initDecayGFGun()
var rev = initDecayGFGun()
for i in 0..<N:
discard fwd.predict(ws(i, Px[i], Py[i]), Spd)
discard rev.predict(ws(i, Px[i], Py[i]), Spd)
for i in 0..<N: fwd.onResult(ev(i, Px[i], Py[i]))
for i in countdown(N-1, 0): rev.onResult(ev(i, Px[i], Py[i]))
let qf = fwd.predict(ws(100, 400.0, 300.0), Spd)
let qr = rev.predict(ws(100, 400.0, 300.0), Spd)
check "DecayGF: reverse resolution learns the SAME state as forward (order-independent)",
fwd.peakBin() == rev.peakBin() and samePoint(qf, qr)
check "DecayGF: every wave resolved exactly once in both orders",
fwd.waveResolved == N and rev.waveResolved == N
check "DecayGF: no mispair / no starve",
fwd.waveMispaired == 0 and rev.waveMispaired == 0 and
fwd.waveStarved == 0 and rev.waveStarved == 0
proc testDecayGFMissingWave() =
var g = initDecayGFGun()
discard g.predict(ws(0, Px[0], Py[0]), Spd)
g.onResult(ev(999, Px[0], Py[0]))
check "DecayGF: unknown fireTick -> starved, nothing resolved",
g.waveStarved == 1 and g.waveResolved == 0
g.onResult(ev(0, Px[0], Py[0]))
check "DecayGF: the real wave still resolves after an unknown-tick event",
g.waveResolved == 1 and g.waveStarved == 1
# ── KNN ───────────────────────────────────────────────────────────────────────
proc testKNN() =
var fwd = initKNNGun()
var rev = initKNNGun()
for i in 0..<N:
discard fwd.predict(ws(i, Px[i], Py[i]), Spd)
discard rev.predict(ws(i, Px[i], Py[i]), Spd)
for i in 0..<N: fwd.onResult(ev(i, Px[i], Py[i]))
for i in countdown(N-1, 0): rev.onResult(ev(i, Px[i], Py[i]))
let qf = fwd.predict(ws(100, 400.0, 300.0), Spd)
let qr = rev.predict(ws(100, 400.0, 300.0), Spd)
check "KNN: reverse resolution produces the SAME query prediction as forward",
samePoint(qf, qr)
check "KNN: every wave resolved exactly once in both orders",
fwd.waveResolved == N and rev.waveResolved == N
check "KNN: no mispair / no starve",
fwd.waveMispaired == 0 and rev.waveMispaired == 0 and
fwd.waveStarved == 0 and rev.waveStarved == 0
proc testKNNMissingWave() =
var g = initKNNGun()
discard g.predict(ws(0, Px[0], Py[0]), Spd)
g.onResult(ev(999, Px[0], Py[0]))
check "KNN: unknown fireTick -> starved, nothing resolved",
g.waveStarved == 1 and g.waveResolved == 0
g.onResult(ev(0, Px[0], Py[0]))
check "KNN: the real wave still resolves after an unknown-tick event",
g.waveResolved == 1 and g.waveStarved == 1
# ── the ring slot is the (fireTick, bin) key ──────────────────────────────────
proc testNonFifoResolveOrder() =
## Explicit non-FIFO sequence: fire 0,1,2; resolve 2,0,1. All three must find
## their own wave (0 starved), which FIFO cannot distinguish but exact keying
## must satisfy alongside the order-independence property above.
var g = initGFGun()
for i in 0..2: discard g.predict(ws(i, Px[i], Py[i]), Spd)
g.onResult(ev(2, Px[2], Py[2]))
g.onResult(ev(0, Px[0], Py[0]))
g.onResult(ev(1, Px[1], Py[1]))
check "GF: resolve order 2,0,1 -> all three waves found, none starved",
g.waveResolved == 3 and g.waveStarved == 0
testGF()
testGFMissingWave()
testDecayGF()
testDecayGFMissingWave()
testKNN()
testKNNMissingWave()
testNonFifoResolveOrder()
if failures > 0:
echo "\n", failures, " check(s) FAILED"
quit(1)
echo "\nAll wave-pairing checks passed."