spaxel/notes
jedarden 83c761a5e8 docs(bf-14wx5): document BLE identity fixture + verifiable run-sim-ble-fixture.sh
The bf-14wx5 deliverables were written but uncommitted (stuck-open-but-done —
auto-split fired at failure-count:3 only because the templated br close --body
had been failing). Commit the focused set so the bead is genuinely closable.

Adds:
- scripts/run-sim-ble-fixture.sh — canonical, self-verifying fixture: starts a
  fresh-data-dir mothership, registers a person (POST /api/people), binds the
  sim's advertised AA:BB:CC:DD:EE:00 (walker 0) via preregister + PUT, and gates
  on GET /api/ble/devices?registered=true showing person_id/person_name in BOTH
  phases.
- notes/ble-identity-fixture.md — reuse-note recording the exact REST sequence,
  the observed sim BLE address convention (AA:BB:CC:DD:EE:%02X per walker, ids
  from 0), and the answer to "must the device be seen-live first?": NO —
  PreregisterDevice sets last_seen_at=now so it falls inside the
  GetDevicesSeenInHours window with no live sighting, and the binding survives
  live sim --ble advertisements (ProcessRelayMessage upserts never touch
  person_id).

Verified 2026-07-08 at HEAD 36b9729: ./scripts/run-sim-ble-fixture.sh PASSes
phaseA (bind with NO live adv) and phaseB (binding survives live adv), exit 0.
All four acceptance criteria met; deliberately excludes scripts/run-sim-
identity.sh (parent bf-2m534 capstone) and notes/hardware-free-runtime.md
(bf-40hc re-verify).

Bead-Id: bf-14wx5
2026-07-08 13:59:41 -04:00
..
bf-1bmg-js-ts.md docs(bf-1bmg): inventory JS/TS dashboard blob-creation sites 2026-07-06 15:46:02 -04:00
bf-1m2x-verification.md docs(bf-1m2x): verify blob-creation inventory is current at HEAD 2026-07-06 16:18:25 -04:00
bf-1oj7-transformcontrols-analysis.md docs(bf-1oj7): verify TransformControls already implemented for live nodes 2026-07-05 23:48:18 -04:00
bf-1q3m-consolidated.md docs(bf-1q3m): consolidate & re-verify all blob-creation findings into single report 2026-07-06 16:03:28 -04:00
bf-2irz-findings.md docs(bf-2irz): verify registry bridge receives simulator positions 2026-07-06 01:37:40 -04:00
bf-2r5o-findings.md docs(bf-2r5o): document simulator position data structure 2026-07-06 01:35:06 -04:00
bf-2y6u-implementation.md feat(bf-2y6u): implement coverage degradation overlay for self-healing events 2026-07-06 02:29:06 -04:00
bf-3aij-pattern.md docs(bf-3aij): define blob object literal search pattern 2026-07-06 02:05:49 -04:00
bf-3f16.md docs(bf-3f16): document API path verification - all endpoints match plan spec 2026-07-06 02:40:53 -04:00
bf-3ifj.md docs(bf-3ifj): document simulator-to-registry position wiring trace 2026-07-06 01:14:12 -04:00
bf-3ldj-findings.md docs(bf-5ywk): banner superseded blob-inventory notes, confirm bf-1q3m as sole source 2026-07-06 16:28:50 -04:00
bf-3ukb.md docs(bf-3ukb): verify crowd flow API path is in sync across all layers 2026-07-06 00:13:27 -04:00
bf-3wkz-dashboard-identity-surface.md docs(bf-3wkz): record independent re-verification of dashboard identity surface 2026-07-06 17:58:29 -04:00
bf-3y9r.md docs(bf-3y9r): verify position propagation through registry and fusion engine 2026-07-06 00:58:57 -04:00
bf-4bhd-reverification.md docs(bf-4bhd): re-verify blob-creation inventory current at HEAD 63f0c87 2026-07-06 16:50:22 -04:00
bf-4bhd.md docs(bf-5ywk): banner superseded blob-inventory notes, confirm bf-1q3m as sole source 2026-07-06 16:28:50 -04:00
bf-4oiz-findings.md docs(bf-4oiz): mark registry-bridge position audit resolved, close out 2026-07-06 12:22:25 -04:00
bf-4wwt-projections.md docs(bf-4wwt): inventory blob projection/derived types & construction sites 2026-07-06 15:36:14 -04:00
bf-5cgc-handoff.md docs(bf-5cgc): hand off blob-creation inventory to identity-field beads 2026-07-06 16:40:27 -04:00
bf-5kns.md docs(bf-5ywk): banner superseded blob-inventory notes, confirm bf-1q3m as sole source 2026-07-06 16:28:50 -04:00
bf-5occ-findings.md docs(bf-5occ): document position format mismatch between simulator and registry 2026-07-06 01:48:06 -04:00
bf-5uzm-conversions.md docs(bf-5uzm): map cross-package blob conversion boundaries in main.go 2026-07-06 15:21:10 -04:00
bf-5yff.md docs(bf-5yff): verify realistic node geometry implementation 2026-07-06 00:46:45 -04:00
bf-6aif.md docs(bf-6aif): add accessibility quality gate implementation notes 2026-07-06 00:32:32 -04:00
bf-13s0.md docs(bf-13s0): document blob data structure definition and usage patterns 2026-07-06 01:01:33 -04:00
bf-26ta-findings.md docs(bf-5ywk): banner superseded blob-inventory notes, confirm bf-1q3m as sole source 2026-07-06 16:28:50 -04:00
bf-26ta-javascript-results.md docs(bf-5ywk): banner superseded blob-inventory notes, confirm bf-1q3m as sole source 2026-07-06 16:28:50 -04:00
bf-26ta-typescript-results.md docs(bf-5ywk): banner superseded blob-inventory notes, confirm bf-1q3m as sole source 2026-07-06 16:28:50 -04:00
bf-28dv.md docs(bf-28dv): verify Component 24 already implemented 2026-07-05 23:18:41 -04:00
bf-33za.md docs(bf-33za): verify Component 33 already implemented 2026-07-05 23:00:59 -04:00
bf-55rp-primary-types.md docs(bf-55rp): re-verify primary tracked-blob Go types & construction sites 2026-07-06 14:56:35 -04:00
bf-67ao-findings.md docs(bf-5ywk): banner superseded blob-inventory notes, confirm bf-1q3m as sole source 2026-07-06 16:28:50 -04:00
bf-195o.md docs(bf-195o): document node geometry placement research and design 2026-07-06 00:44:23 -04:00
bf-5151-coverage.md docs(bf-1mwy): correct coverage-gate HEAD ref to real ancestor 908adf2 2026-07-06 18:24:50 -04:00
bf-5613-findings.md docs(bf-5613): analyze multi-person bedroom sleep monitoring edge case 2026-07-06 02:47:37 -04:00
ble-identity-fixture.md docs(bf-14wx5): document BLE identity fixture + verifiable run-sim-ble-fixture.sh 2026-07-08 13:59:41 -04:00
blob-identity-diagnosis.md docs(bf-m1ynp): diagnose empty blob identity — match-found link broken 2026-07-08 07:17:02 -04:00
hardware-free-runtime.md docs(bf-40hc): record hardware-free runtime blob path acceptance 2026-07-08 07:17:02 -04:00