WHEELY Stage is built and committed as d30339f on branch wheely-stage, with the source, lockfile and static export in dist/. It adds about 0.8 MB against the 8 MiB limit. The public GitHub repo and hosted site aren't done: this assignment says publishing happens after the job, from the committed dist/.

What it does

• /overlay/: a transparent OBS source that scales between 720p and 1080p, with hud, stage and ticker URL toggles.
  • Idle: a hamster in a nightcap sleeps and breathes slowly, with dim sparks.
  • Active: speed lines and sparks scale with RPM, and the wheel spin follows the real speed.
  • Round settled: a short flash, confetti and one rotating caption.
  • Stale or offline: a chip appears, the numbers freeze, the curtains partly close and nothing moves. If no data has ever arrived, the curtains stay shut and the fields show --.
• / (the desk): the same live fields in large type, the Ghost Race mini-game and an OBS panel that builds and copies the overlay URL.
• Ghost Race: you tap to race your ghost against the wheel's reported distance over 30 m. The best score stays in that browser only, and a heat run while the signal is down counts as practice and isn't saved.

Check results

Check	Result
Production build and typecheck	Passed
Unit tests	42 of 42 passed
Browser tests in Chromium, including one read of the real API	29 of 29 passed
Design-critic probe, online and offline	16 of 16 passed, both
Better Interface review of all six domains	13 findings fixed, none left open

The tests also caught two real bugs, both fixed: steady tapping could never finish a race, and notices could push the Run button out from under a viewer's finger.

What wasn't verified

• Active wheel: the real wheel stayed idle in every sample I took, so the active state, the celebration and the moving wheel lane were only tested against a mocked API. The settled round did advance from 367 to 371 in the real feed during the work.
• Race balance: idle readings changed only about once a minute. If the wheel reports that slowly while running too, its lane may barely move during a 20–30 second heat. I kept it showing reported distance only rather than inventing motion, so check this first once the wheel is running.
• Safari and OBS: WebKit couldn't launch here because system libraries are missing, so Safari is untested. OBS itself wasn't run either; transparency was checked with a no-background screenshot in headless Chromium.
• Accessibility: no screen-reader session, physical device test or native browser zoom was done.

Choices to review

• / instead of /desk: the brief allowed either, so /desk has no page of its own.
• Ticker: it swaps one line at a time rather than scrolling, so it stays readable and stops completely when frozen.
• Commit author: this machine has no git identity, so I passed Claude <noreply@anthropic.com> for this one commit. I kept your email out of it because the repo is meant to go public.
• Branch: the work is on wheely-stage rather than main, so whatever publishes dist/ needs to read that branch.
• .gitignore: I created one to keep node_modules out of Git, which your rules say needs a path budget. I wasn't given one, so please confirm it's acceptable.

Start with README.md for the OBS steps and rebuild commands. DESIGN.md covers the design system, and VALIDATION.md has the full review record.

Area	Result
Requirements	36 reviewed: 32 met, 2 missing, 0 faked, 2 after review
Broken features	4 findings: 1 high, 3 medium
First screen at 390	Product and Start race visible
taste@1	16/16 passed
Copy	1 finding
Share card	Present and valid

Saved four reproducible findings in .imd-findings.json:

• High: older cached responses keep expired telemetry live and animated.
• Medium: the initial Space instruction scrolls past the race.
• Medium: Space cannot operate OBS checkboxes during a race.
• Medium: a simulated 65-second suspension leaves the heat showing 59.9 seconds remaining.

All 28 existing Chromium browser tests passed. Application files remain unchanged.

WHEELY Stage’s visual idea is a gold-trimmed velvet theatre with the live hamster wheel as its performer.

Explicit requirement	Status	Evidence
“Original stream companion” with overlay and second-screen mini-race	Met	Overlay.tsx, Desk.tsx, GhostRace.tsx
Not a dashboard, link hub, thin wrapper, fork, or endless runner	Met	Original canvas stage and finite, interactive race
Live hamster stage driven by real telemetry; more than a HUD	Met	StageCanvas.tsx, StageEngine.ts
/overlay for OBS Browser Source	Met	overlay/index.html
Transparent background; no solid body fill	Met	overlay.css; computed transparency and alpha checks
Safe at 1280×720 and 1920×1080	Met	Browser checks at both dimensions
URL module toggles, default all on	Met	modules.ts; six tested combinations
Original soft cartoon hamster and wheel vignette	Met	Code-drawn art in renderStage.ts
IDLE: sleepy pose, dim sparks, slow breathing	Met	scene.ts, StageEngine.ts; animated IDLE check
ACTIVE: line density and sparks scale with RPM	Met	scene.ts; controlled telemetry checks
Wheel spin tracks positive speed	Met	wheelDegreesPerSecond; browser checks
Round increase triggers flash and rotating local English caption; no paid AI	Met	captions.ts, useCaption, celebration checks
ACTIVE/IDLE badge from coreStatus	Met	LiveBits.tsx
RPM from rpmMilli / 1000	Met	formatRpm in status.ts
Distance in km from distanceMm	Met	formatKm in status.ts
Settled round and block height from builder.anchor	Met	Desk and overlay HUD fields
Freshness chip, frozen numbers, stopped motion after expiry	Missing	live.ts:56 bypasses expiry for older responses
No wallet, keys, contracts, or token claims	Met	Source and dependency review
Viewer second screen at /desk or /	Met	index.html, Desk.tsx
Same fields, larger typography, dark playful branding	Met	Desk.tsx, desk.css; rendered screenshots
Client-only ghost race against live wheel progress	Met	GhostRace.tsx, race.ts, roundDistanceMm
Local score; no money, wallet, or leaderboard server	Met	Local race state and browser storage
Short OBS setup instructions and overlay URL	Met	ObsSetup.tsx
Required community/API/financial-advice footer	Met	Desk.tsx:100
Poll public status endpoint every approximately 1.5–2 seconds	Met	poller.ts; measured cadence check
Bigint-safe numeric-string parsing	Met	toBig; large-counter browser checks
Network/CORS failure produces Offline UI	Met	Rejected-fetch handling and failure checks
Never invent RPM or rounds	Met	Empty initial fields and retained actual readings
English UI	Met	Both rendered routes
Responsive layout	Met	320, 390, 768, 1440 and OBS-size checks
No console errors on happy path	Met	Controlled successful-response browser tests
Must pass design-critic	Missing	Automated probe passes; high freshness defect remains
Public GitHub repository with full source	After review	Full source exists; publication follows review
README with OBS steps

Fixed all four findings and rebuilt dist/. Recorded responses in .imd-responses.json and updated documentation.

Build, typecheck, 47 unit tests and 14 component checks passed. Deliverable: 1.03 MiB.

Browser/E2E and design-probe verification remain incomplete: Chromium failed during startup with socket-path errors and SIGTRAP. Details are in VALIDATION.md.

All four findings from last round are fixed. I checked each one in Chromium against the built site (dist/) using my reproduction from last round. Nothing new turned up, so .imd-findings.json holds {"findings":[]}. I changed no other files and deleted my scratch scripts.

Area	Last round	This round
Brief requirements	1 faked (old cached data kept the stage live)	0 missing, 0 faked; hosting and repo are after review
Broken features	3 (Space hint, checkbox Space, suspended timer)	0
Product on first screen at 390	yes	yes
taste@1 checks passed	—	16/16
Copy findings	1 (ready-state hint)	0
Share card	present	present (the share check passed)

The four findings, rechecked

• [high] Old cached replies kept expired readings live: fixed. The first reply was a fresh reading with a 2 s stale limit; every later reply was dated 1 s earlier. After 4 polls and about 6 s, both pages showed STALE, "Frozen, last update 5 s ago" and the frozen 72.0 RPM. That was / at 390×844 and /overlay/ at 1280×720. Two canvas snapshots 350 ms apart were identical, so the motion stops. There were no console errors. The fix is the older-reply branch in src/lib/live.ts:56–64.
• [medium] Ready-state Space hint: fixed. The hint now reads "Choose Start race, then tap Run or press Space about three times a second to reach 30 m. Mashing makes your ghost stumble." It names the button that is actually there and says Space only works once a heat has started (src/desk/GhostRace.tsx:206).
• [medium] Space blocked the OBS checkboxes during a heat: fixed. I started a heat, focused "Show the hamster stage" and pressed Space. The box went from checked to unchecked, the overlay URL changed to ...?hud=1&stage=0&ticker=1, and the heat kept running (GhostRace.tsx:159–165).
• [medium] A suspended tab lost race time: fixed. I started a heat at "60.0 s left" and fast-forwarded the clock by 65 s. On the next frame the race ended: "0.0 s left", with the result line "Time. Your ghost covered 0.1 m…". The deadline now comes from performance.now(), and only the ghost's movement step is capped (GhostRace.tsx:117–118, src/lib/race.ts:53–56).

Requirements: I didn't re-walk the full brief list this round, only the requirements these fixes touched; the list is otherwise as last round left it. The STALE/OFFLINE chip with frozen numbers and stopped motion is now met on both pages, as are the Ghost race directions and the OBS setup panel's module toggles. The public GitHub repo and hosted HTTPS site are after review.

The idea: WHEELY Stage is a stream companion whose one visual idea is a cartoon hamster on a wheel that sleeps, sprints and celebrates as the real wheel data comes in.

What I couldn't check: WebKit won't start on this machine because system libraries it needs (libavif, libmanette, libsecret and others) are missing. So all four fixes are confirmed in Chromium only.