Make CueAI reviewable: correct the physics, make the ML result real, and put the simulator in front of the reader as a playable game - #1

Merged

cursor[bot] merged 37 commits into

mainfrom

cursor/recruiter-ready-cueai-6a10

Aug 12, 2026

Commits on Aug 12, 2026

fix(physics): correct slip velocity and friction torque signs

cursoragent
and
BruceMoseti
committed
81197dd
feat(physics): closed-form free-ball solver as a baseline predictor

cursoragent
and
BruceMoseti
committed
fe693c0
chore: package hygiene, lint, types and CI

cursoragent
and
BruceMoseti
committed
3869656
feat(ml): learn the residual against the closed-form solver

cursoragent
and
BruceMoseti
committed
cace58e
docs: publish measured results, validation and design notes

cursoragent
and
BruceMoseti
committed
2ceba5b
feat(ml): report accuracy against coverage using the free closed-form gate

cursoragent
and
BruceMoseti
committed
8c5e2de
fix(api): reject tip offsets past the miscue limit

cursoragent
and
BruceMoseti
committed
763bd57
test(physics): bound label discretisation and pin ghost-ball aim geometry

cursoragent
and
BruceMoseti
committed
8d7a41c
feat(ml): stratify by ball-ball contact and ablate the physics features

cursoragent
and
BruceMoseti
committed
0b6c716
docs: report what the averages hide and where the residual loses

cursoragent
and
BruceMoseti
committed
e84b315
fix(infer): report no object endpoint when no object ball was given

cursoragent
and
BruceMoseti
committed
815c046
feat(web): playable 8-ball against a search bot on the ported physics

cursoragent
and
BruceMoseti
committed
f44d05e
fix(physics): stop vertical spin chattering around zero

cursoragent
and
BruceMoseti
committed
123b35b
fix(physics): make every contact in a rack visible to the solver

cursoragent
and
BruceMoseti
committed
e1c46e3
feat(web): steady the shot loop and show the cue, the drop and the handover

cursoragent
and
BruceMoseti
committed
e01bf31
feat(web): quote measured numbers on the page, and fail CI when they drift

cursoragent
and
BruceMoseti
committed
0733120
test(web): play the real page in Chrome, and record the README assets from it

cursoragent
and
BruceMoseti
committed
5f8de49
style: satisfy ruff on the new scripts, and ignore the node_modules symlink

cursoragent
and
BruceMoseti
committed
97ddb27
ci: deploy the playable table to Pages, but only if it matches the reference

cursoragent
and
BruceMoseti
committed
59b5982
docs: republish every number against the corrected physics

cursoragent
and
BruceMoseti
committed
774a42e
test(physics): assert that a harder break opens the table further

cursoragent
and
BruceMoseti
committed
23401fb
docs: record the README assets on an idle machine and pick the shots for them

cursoragent
and
BruceMoseti
committed
85cc130
test(web): check that no two balls ever share space while the shot is running

cursoragent
and
BruceMoseti
committed
6a20f73
docs: quantify the break-spread fix and the restitution choice behind it

cursoragent
and
BruceMoseti
committed
9e17ddb
fix(web): say when the cue ball drops, and keep the trace labels legible

cursoragent
and
BruceMoseti
committed
5b7a8a8
test(web): choose the inspector still deliberately and verify it before shooting

cursoragent
and
BruceMoseti
committed
e953ff5
docs: re-record the README stills and clip from the running page

cursoragent
and
BruceMoseti
committed
fc3c686
feat(web): keep the referee's reasoning on screen in a shot log

cursoragent
and
BruceMoseti
committed
903d8e9
docs: re-record the stills with the shot log in frame

cursoragent
and
BruceMoseti
committed
02ede60
docs: mention the shot log in the tour of the page

cursoragent
and
BruceMoseti
committed
721344e
docs: stop committing stills nothing links to

cursoragent
and
BruceMoseti
committed
a26c121
docs: re-record the stills after trimming the capture set

cursoragent
and
BruceMoseti
committed
9d3424b
docs: describe the browser port and the search that runs on it

cursoragent
and
BruceMoseti
committed
fa06071
test(web): play the page with a real cursor and keyboard

cursoragent
and
BruceMoseti
committed
81bb447
fix(capture): aim the demo break at the apex, and keep the clip moving

cursoragent
and
BruceMoseti
committed
d7eb9bb
test(web): assert that the break opens the rack

cursoragent
and
BruceMoseti
committed
00f4cb8
fix(ci): let mypy target the interpreter it runs on

cursoragent
and
BruceMoseti
committed
baf99d2