Rename the project to Pocket Physics, and make the play link work

[BruceMoseti]

Why

Two problems with how the project introduced itself.

The name led with the weakest claim. "CueAI" put the learned model in the title, when the surrogate is one tier of four and the interesting work is the validated simulator underneath it. To the audience this repository is aimed at, an -AI suffix reads as a wrapper around someone else's model rather than a physics engine with a measured speedup.

The play link was a 404. The README has advertised a playable page since it existed, and the deploy job has failed on every push to main: configure-pages asks the API for a Pages site, the repository never had one, and nobody was told.

What changed

Renamed to Pocket Physics. Pocket billiards is the sport — the same term the references use, Marlow's The Physics of Pocket Billiards among them — and "pocket" is also the claim: a rack shot that costs 4.6 s to integrate fits in 0.60 ms and a browser tab. The import path moves cueai → pocket, the distribution becomes pocket-physics, the console scripts become pocket-{ui,train,api}, and __version__ now comes from the installed metadata instead of a literal that had drifted to 0.1.0 against 0.3.0 in pyproject.toml.

The repository URL is deliberately untouched, so every link, badge and clone line still resolves.

The rebranded masthead above the table, mid-game

The game is now one click away from every front door. The table is an anchor, so a link lands on it rather than on the masthead; the README leads with it, the design doc points at it, the page nav offers Play first, and the bottom of the explainer has a way back up. Both published URLs are reference links defined in one place, so renaming the repository is a one-line change rather than a hunt.

The deploy can now publish. configure-pages gets enablement: true, so the workflow creates the Pages site with permissions the job already holds.

Two things found on the way.

• The demo clip and stills carried the old name in the masthead, so they are re-recorded. The regenerated inspector still came out showing a cue ball that had dropped after rebounding off a rail — the 5/7·v₀ handover it exists to illustrate was there, but the panel was captioned POCKETED and the trace stopped mid-roll. The aim already refuses headings that run at a pocket, which only covers the path to the first rail, so the capture now checks the outcome too and a scratch buys another attempt. The still it settles for is below: measured roll speed 2.26 m/s against 5/7·v₀ = 2.26 m/s predicted.
• Nothing was checking that the play link points anywhere. The browser test now resolves every in-page href and asserts that #play is the element containing the table. Confirmed it fails when the attribute is removed, rather than passing vacuously.

The cue-ball inspector showing the slip-to-roll handover landing on the predicted speed

Checks

Everything run locally on the committed tree:

ruff, mypy, pytest	clean, 54 passed
site_facts.py --check	page figures current
export_parity_cases.py --check	committed cases match the simulator, 0.00 mm drift
parity.mjs	35/35 shots agree, worst 1.2 × 10⁻³ mm, 65× faster than the reference
selfplay.mjs --games 6	every game reached a legal conclusion, worst overlap 0.400 mm, break moved 12/15
browser.mjs	page paints, links resolve, game completes, no console problems
input.mjs	15/15 interaction checks

One thing left for a human

Renaming the GitHub repository to pocket-physics would finish the job. GitHub redirects the old clone and badge URLs, but the Pages URL follows the repository name, so brucemoseti.github.io/cueai/ would become brucemoseti.github.io/pocket-physics/. That is the one line at the bottom of the README (and the same URL in docs/DESIGN.md) — nothing else depends on it.

_{To show artifacts inline, enable in settings.}