Skip to content

BACKLOG.md

Latest commit

 

History

History
135 lines (120 loc) · 7.19 KB

BACKLOG.md

File metadata and controls

135 lines (120 loc) · 7.19 KB
Raw

Backlog

Things noted during v1.0.0 bring-up that didn't make it in, plus follow-ups raised since. None are blockers; the device is fully functional per PAGER_SPEC.md §9.

Recently shipped (post-v1.0.0)

  • Experimental M5Stack Dial build target — [env:dial] in platformio.ini flashes a working pager onto the M5Stack Dial (ESP32-S3, 8 MB flash, no PSRAM, round 240×240 LCD + rotary encoder). Back half (BLE / protocol / state) ports unchanged. Approval modal uses a Dial-native rotate-then-press: encoder CW arms approve, CCW arms deny (with a green/red perimeter arc that fills with commitment and brightens past the arm threshold), then a push of the encoder commits. A "press to Approve/Deny" hint appears once armed. On-screen Approve/Deny buttons remain as a touch fallback for no-rotation operation. Glance / Recent / Settings still use the CoreS3 SE landscape layout cropped to the round canvas — round-aware repositioning is the next polish item. Upload needs --no-stub — the USB-CDC stub handoff is even flakier than the CoreS3 SE.
  • Bezel-button bindings on the CoreS3 SE touch strip below the LCD — M5.BtnA/B/C virtualise three zones at Y≈267-279. Right = Approve / left hold = Deny on the approval modal (mirrors the on-screen layout), centre = focus toggle on Glance. Verified on hardware.
  • State-coloured status pill (green/amber/red/gray/violet).
  • Heartbeat msg surfaced as a subtitle on Glance.
  • Local clock + date in the top-right corner of Glance.
  • Token-burn sparkline above the today bar (~10 min of history) and rolling burn-rate label (≈X/min) on the today line.
  • Idle / active-now footer at the bottom of Glance.
  • Focus mode (long-press Glance to silence chime + dim backlight for 60 min; partly addresses the idle-dim item below).
  • RGB565 byte-order fix — text on the panel is now sharp instead of chromatically fringed.
  • Status-response shape that satisfies Claude's deviceStatus validator (full bat, vel/nap zeros).
  • MTU-aware notify chunking in pager::ble::sendLine.
  • Diagnostic scripts under scripts/ (BLE GATT inspector, synthetic prompt tester, persistent serial monitor, LVGL .S strip script).

Polish

  • Randomize BLE identity on Forget bonds. macOS keeps its own BLE pairing cache keyed on our fixed BT MAC, so after device-side Forget bonds the host re-uses the old link keys and skips the passkey display — leaving the device in a "pairing? not pairing?" limbo until the user also forgets the device under System Settings → Bluetooth. NimBLE supports random addresses; rotating ours each time clearIdentity() fires would make the next advertisement look like a fresh peripheral to the host and force a clean re-pair every time, removing the macOS-side step entirely.
  • Font sizes for the small panel. Body text at lv_font_montserrat_14 is legible but tight on a 2" 320×240 IPS at typical desk distance. Enable LV_FONT_MONTSERRAT_16 (or 18) in include/lv_conf.h and switch the disconnected banner / token-bar caption / entry rows over.
  • A nicer chime. Currently two queued sine tones (A5 + C#6, 90 ms each). PAGER_SPEC.md §10 left the door open to a short WAV on flash — would be a friendlier sound than raw oscillator pips.
  • Smoother idle-dim transition + tunable threshold. Focus mode pins the backlight low when active, but the regular dim path still steps 220 → 40 instantly after a hard IDLE_DIM_MS = 30 s. Fade over ~500 ms and let the threshold be NVS-backed (Settings UI).
  • Approval timing. Spec §6.2 mentions a "fast approvals" counter (under 5 s); we track appr/deny counters but don't surface the velocity stat anywhere. Could go on Settings.
  • Sparkline polish. Currently logs whatever tokens_today delta we measure each heartbeat. Two improvements worth considering: fixed Y range (auto-scale makes a single big spike compress everything else flat), and labelling the X axis ("last 10 min").
  • ESC / cancel button. No-op today: REFERENCE.md only documents four device → desktop verbs (permission, name, owner, unpair) and Claude Desktop silently drops anything else, so an on-device cancel button has nothing to bind to. Worth revisiting if Anthropic adds an interrupt / stop verb upstream — at that point a single big ESC on Glance becomes useful for "stop generating" while a session is running.

Honest fields

  • bat.pct is still fabricated. We send pct:100 while on USB, but there's no cell. A more honest representation would treat the bat object as advisory and let pct flag "no battery" somehow — needs Claude Desktop validator behaviour to be more permissive than it is today (it rejected omitted bat fields entirely; see protocol.cpp).

Validation gaps

  • §9 #7 — 24 h stability soak. Not run yet. Things to watch for: heap fragmentation in pager::store::stats writes, NimBLE bond store growth on repeated unpair/repair, LVGL animation timer drift over a long interval.
  • §9 #8 — cmd:unpair from desktop. Code path exists (onCmdUnpair → ack → forgetEverythingAndReboot) but not exercised end-to-end. Testing requires Claude Desktop to actually send the command, which the current Hardware Buddy panel doesn't have a UI for; would need a custom test client or wait for the feature to land.

Build & infra

  • Pre-build script mutates .pio/libdeps/. scripts/fix_lvgl_xtensa.py removes LVGL's ARM-only .S files on every build. Works in practice but it's a "fixed at the wrong layer" patch — a cleaner solution would be a library.json override or a lib_compat_mode setting that filters by extension. Open to upstreaming the fix to LVGL too: the C preprocessor includes inside the .S files should sit behind an __ASSEMBLER__ guard so non-ARM targets don't trip on <stdint.h>.
  • Hardcoded library pin pair. M5Unified 0.2.13 + M5GFX 0.2.19 is the last combination that compiles against any released LVGL 9.x (the 2026-04-21 release pair broke this). Worth periodically re-checking the latest pair to see if upstream re-aligned.
  • Upload speed at 460800. CoreS3 SE USB-CDC sometimes hangs the baud-change at 1.5 Mbit/s; we dropped to a slower-but-reliable rate. Could revisit once esptool / the on-chip USB stack handles it.

Known behaviour to investigate

  • Claude Desktop's prompt: heartbeat timing. During bring-up we watched many Claude heartbeats come through with running:0, waiting:0 even while the user was actively approving Claude Code permission prompts. We later did catch a real prompt:-bearing heartbeat (the pwsh one in the README) and confirmed end-to-end works. But the bridge appears to drop in-flight prompts that resolve inside the 10 s heartbeat cycle. Worth filing upstream against anthropics/claude-desktop-buddy once we can reproduce reliably.

Stretch

  • Cowork support. Spec mentions Claude Cowork sessions alongside Claude Code; we haven't tested that path.
  • Windows desktop. Anthropic's REFERENCE.md says the BLE bridge works on Windows too. Untested with this firmware.
  • LV_LARGE_FONT. If we add CJK or larger glyph sets, may need LV_FONT_FMT_TXT_LARGE 1 in lv_conf.h.