Skip to content

docs(plans): add improvement plans 009-013 with execution index#217

Merged
G4brym merged 1 commit into
mainfrom
plans-009-013
Jul 6, 2026
Merged

docs(plans): add improvement plans 009-013 with execution index#217
G4brym merged 1 commit into
mainfrom
plans-009-013

Conversation

@G4brym

@G4brym G4brym commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

What

Checks in five new self-contained implementation plans written by the improve skill for executor agents, plus the plans/README.md index updates (execution order, dependency notes, rejected-findings ledger).

Plan Title Effort
009 DNS-SD _devicesdk._tcp advertisement + CLI browse discovery S-M
010 OTA firmware updates for ESP32 (server push, A/B partitions, rollback-safe) L
011 Design spike: extract device runtime into packages/device-engine (kill workerd) M
012 Device KV inspector: REST list/delete endpoints + dashboard Storage tab S
013 Design spike: multi-user project sharing (household roles, report-only) M

Plans 009-011 come from the first /improve next direction audit on 2026-07-06; plans 012-013 from the second audit the same day (both against commit bbd724d). The README ledger also records the findings offered but not selected (actions API, new boards, backup/restore, captive portal, Prometheus) plus the Pico i2c_batch_write parity gap noted for a standard audit.

Notes

🤖 Generated with Claude Code

@G4brym
G4brym merged commit e6d6454 into main Jul 6, 2026
8 checks passed
@G4brym
G4brym deleted the plans-009-013 branch July 6, 2026 20:28
Five self-contained plans from the two /improve direction audits on
2026-07-06 (commit bbd724d), plus plans/README.md updates: execution
order rows, dependency notes, and the rejected-findings ledger for both
rounds.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
G4brym added a commit that referenced this pull request Jul 8, 2026
## 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](https://claude.com/claude-code)

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