spaxel/scripts
jedarden eba9e74457 docs(bf-5cr3): capture deterministic hardware-free runtime reproduce artifact
Adds the single canonical reproduce for the working end-to-end runtime path
(sim connect -> CSI ingest -> phase/fusion -> tracked blob), so later beads
(e.g. bf-f841 blob-identity runtime checks) and reruns reuse it instead of
re-deriving the command sequence or the rate tuning that caused bf-40hc's
repeated failures.

- scripts/run-sim-local.sh: builds mothership + canonical sim
  (mothership/cmd/sim, the one with --verify) from source, starts the
  mothership on an ephemeral port/data dir, streams simulated CSI, and gates
  on peak>=1 blob via GET /api/blobs. No hardware/Docker/manual IP/manual token.
- notes/hardware-free-runtime.md: full reproduce sequence, the two gotchas
  (two cmd/sim packages; rate=30 not 20), the token path, env/params, and the
  determinism contract.

Verified clean-checkout run at HEAD 5bbe52c: peak_blob_count=2, first blob
@1s, sim --verify PASSED, 0 rejects, ~363 FPS, exit 0. Closes the chain
bf-3zll -> bf-3hji -> bf-51fq -> bf-5cr3.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-08 01:19:25 -04:00
..
run-sim-local.sh docs(bf-5cr3): capture deterministic hardware-free runtime reproduce artifact 2026-07-08 01:19:25 -04:00