spaxel/docs/notes
jedarden 4dcc06af2b docs(bf-29wyl): confirm token-supply path dead — header-only, unread
Verify the sim/header-side half of the tokenless-sim REJECT root cause
against current source (second link of the bf-34lwt split). Three facts
re-checked against current source:

- Sim supplies its token ONLY as the X-Spaxel-Token HTTP header on the
  WS dial — cmd/sim/main.go:313, mothership/cmd/sim/main.go:633,
  mothership/cmd/sim/scenario.go:318 (all three connect paths).
- The hello JSON map the sim sends has NO token field —
  cmd/sim/main.go:348-359, mothership/cmd/sim/main.go:652-665,
  mothership/cmd/sim/scenario.go:331-342. Only "--token" hits are CLI
  flag defs, never a JSON body key.
- The mothership NEVER reads that header on the WS path —
  grep 'X-Spaxel-Token' mothership/ excluding _test.go and cmd/sim/
  returns zero hits. HandleNodeWS (server.go:455-469) passes r straight
  to Upgrade; the only Header ref on the path is the outbound
  w.Header().Set response header.

Conclusion: header ignored -> hello.Token (message.go:22) empty ->
tokenOK (server.go:513) always false. The "have the sim supply valid
tokens" option is currently DEAD. Companion to bf-5ig3e (validator half);
both roll up into bf-34lwt.

Co-Authored-By: Claude <noreply@anthropic.com>
Bead-Id: bf-29wyl
2026-07-07 06:55:56 -04:00
..
.gitkeep init: spaxel project — docs, plan, and marathon infrastructure 2026-03-26 06:43:25 -04:00
ci-test-sim-reference-map.md docs(notes): correct acceptance-test file count in spaxel-build inventory (bf-1yeh) 2026-07-04 09:36:38 -04:00
firmware-host-test-approach.md docs: decide firmware host test approach — gcc harness over ESP-IDF linux (bf-21t) 2026-07-03 06:01:55 -04:00
mdns-override.md feat(provisioning): carry ms_ip in payload for mDNS-less networks 2026-04-24 01:06:05 -04:00
recovery-mechanisms.md init: spaxel project — docs, plan, and marathon infrastructure 2026-03-26 06:43:25 -04:00
simulation-testing.md init: spaxel project — docs, plan, and marathon infrastructure 2026-03-26 06:43:25 -04:00
token-reject-root-cause.md docs(bf-34lwt): root-cause tokenless-sim REJECT in WS hello path 2026-07-07 06:19:29 -04:00
token-supply-path-dead-confirm.md docs(bf-29wyl): confirm token-supply path dead — header-only, unread 2026-07-07 06:55:56 -04:00
token-validator-wiring-confirm.md docs(bf-5ig3e): confirm validator wired unconditionally + hello.Token-only check 2026-07-07 06:38:33 -04:00
ux-visualization.md init: spaxel project — docs, plan, and marathon infrastructure 2026-03-26 06:43:25 -04:00