Skip to content

docs(plans): add direction plans 014-015 with execution index#218

Merged
G4brym merged 1 commit into
mainfrom
plans-014-015
Jul 8, 2026
Merged

docs(plans): add direction plans 014-015 with execution index#218
G4brym merged 1 commit into
mainfrom
plans-014-015

Conversation

@G4brym

@G4brym G4brym commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Third /improve next (direction audit) run, planned against e6d6454. Adds two selected direction plans and reconciles the execution index.

  • Plan 014 - Persist entity state (P1, M): emitState is currently broadcast-only (deviceSession.ts:574) - nothing is stored, so sensor readings are invisible unless a watcher is open. Adds a history table with retention + write coalescing (mirroring the device_logs pattern), a last-known-value table that survives retention, watcher replay of last-known state on attach, GET .../state + .../state/history endpoints, and a dashboard State tab with echarts history charts. Best landed before plan 001 (HA integration) executes so HA gets state restore on reconnect from day one.
  • Plan 015 - Flash devices from the dashboard (P2, M): dashboard-only WebSerial flashing for ESP32 via esptool-js (the server already streams fully patched, checksum-corrected images) plus one-click patched UF2 download for Pico. Feature-detects the secure-context requirement and falls back to download + CLI instructions until plan 008 (TLS) ships.
  • Index: rows for 014/015, dependency notes (014↔001/007/012, 015↔008/010), and the round's not-selected findings recorded (webhook/ntfy alerting, CodeMirror script editor, Pico OTA deferred until 010 lands) so future audits don't re-litigate them.

Plans only - no source code changes, hence no changeset (same as #215-#217).

🤖 Generated with Claude Code

@G4brym
G4brym merged commit 595a142 into main Jul 8, 2026
5 checks passed
@G4brym
G4brym deleted the plans-014-015 branch July 8, 2026 08:56
…oard web flasher)

Third /improve next run. Plan 014 persists emitState values (last-known +
history + watch replay + dashboard charts); plan 015 adds browser-based
ESP32 flashing over WebSerial plus patched UF2 download to the dashboard.
Index updated with dependency notes and the round's not-selected findings
(alerting egress, script editor, Pico OTA).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant