[epic] Pre-release (v0.5.0) hardening batch — audit follow-ups

[sobechestnut-dev]

Source: a 4-dimension pre-release audit (GitHub backlog, documented gaps, test coverage, UX/DX) run from a read-only planning session. This is the entry point for the main coding session to pick up the batch.

The codebase is healthy (1 TODO, 1 intentional skip). Findings cluster in release mechanics, the newest v0.4.0 CNC/laser surface, doc accuracy, and demo/adapter polish. Goal: turn the currently-thin next release (two camera changesets only) into a substantive, honest v0.5.0.

Themed PRs → dev

• Docs accuracy — [docs] Refresh stale compatibility matrix + README adapter count (Q1, Q4) #273 (Q1 compat matrix + Q4 README adapter count). No changeset.
• Svelte parity bug — [bug] Svelte adapter: buildVolume is not reactive after mount (parity break) #274 (Q2 buildVolume reactivity). Patch changeset. Verify at GcodePreview.svelte:71 first.
• Adapter surface — [feat] Adapter surface: capabilities/warnings event, view/cameraState prop, keyboard a11y (M3, M6, M4) #275 (M3 capabilities/warnings event, M6 view/cameraState prop, M4 keyboard a11y). Minor changesets. Verify M4 tabindex/keys absence first. May split into two PRs.
• Demo — [feat] Demo: surface preset views + save/restore view + print-time/time-scrub (Q3) #276 (Q3 preset views + save/restore + time-scrub/print-time). No changeset.
• CNC test hardening — [test] Harden CNC/laser parsing coverage — adversarial tier + hostile canned cycles (M1, M2, M5) #277 (M1 adversarial tier, M2 hostile canned cycles, M5 G82/$32/NaN). Changeset only if a real fix surfaces.

Non-PR tasks

• Housekeeping — [housekeeping] Close completed milestones M0–M5, dedupe label pairs (Q5) #278 (Q5 close milestones M0–M5, dedupe label pairs). GitHub admin only.
• Release finale — [release] Regenerate version PR to v0.5.0 — #271 is stale and drops the #268 changeset #272 (B1). Do LAST. After the themed PRs merge to dev, regenerate the Changesets version PR (currently the stale release: version packages (lockstep) #271, which under-versions to 0.4.1 and drops the Preset views + camera-state API — threaded through core + all adapters (zero-dependency) #268 changeset) so it consumes everything and cuts v0.5.0.

Sequencing

1. Land the themed PRs ([docs] Refresh stale compatibility matrix + README adapter count (Q1, Q4) #273–[test] Harden CNC/laser parsing coverage — adversarial tier + hostile canned cycles (M1, M2, M5) #277) on dev, each carrying its own changeset where noted.
2. [housekeeping] Close completed milestones M0–M5, dedupe label pairs (Q5) #278 housekeeping anytime (independent).
3. Then [release] Regenerate version PR to v0.5.0 — #271 is stale and drops the #268 changeset #272 — verify/regenerate the version PR → v0.5.0, all changesets consumed, CHANGELOGs complete.

Checklist

• [docs] Refresh stale compatibility matrix + README adapter count (Q1, Q4) #273 docs accuracy
• [bug] Svelte adapter: buildVolume is not reactive after mount (parity break) #274 Svelte buildVolume reactivity
• [feat] Adapter surface: capabilities/warnings event, view/cameraState prop, keyboard a11y (M3, M6, M4) #275 adapter surface (capabilities/warnings, view/cameraState, keyboard)
• [feat] Demo: surface preset views + save/restore view + print-time/time-scrub (Q3) #276 demo affordances
• [test] Harden CNC/laser parsing coverage — adversarial tier + hostile canned cycles (M1, M2, M5) #277 CNC test hardening
• [housekeeping] Close completed milestones M0–M5, dedupe label pairs (Q5) #278 housekeeping
• [release] Regenerate version PR to v0.5.0 — #271 is stale and drops the #268 changeset #272 regenerate version PR → v0.5.0 (finale)

Two items are agent-reported with file refs but unconfirmed by hand — verify before coding: #274 (GcodePreview.svelte:71 non-reactivity) and #275/M4 (canvas tabindex + OrbitControls keys absence).

[sobechestnut-dev]

Epic complete — all items landed and shipped in v0.5.0 (13/13 on npm):

• [docs] Refresh stale compatibility matrix + README adapter count (Q1, Q4) #273 docs · [bug] Svelte adapter: buildVolume is not reactive after mount (parity break) #274 svelte fix · [feat] Adapter surface: capabilities/warnings event, view/cameraState prop, keyboard a11y (M3, M6, M4) #275 adapter surface (M3/M4/M6) · [feat] Demo: surface preset views + save/restore view + print-time/time-scrub (Q3) #276 demo · [test] Harden CNC/laser parsing coverage — adversarial tier + hostile canned cycles (M1, M2, M5) #277 CNC tests · [housekeeping] Close completed milestones M0–M5, dedupe label pairs (Q5) #278 housekeeping · [release] Regenerate version PR to v0.5.0 — #271 is stale and drops the #268 changeset #272 release finale.
  FDM byte-identical throughout.