Erich Blume 4baa8e1c9d feat(heph-pwa): mobile app shell — views, quick-add, triage, search, voice

A buildless, installable PWA that mirrors heph-tui: sidebar of built-in views
(tom/tasks/work/chores/ondeck/inbox) + projects, a task list with attention
flags / project bullets / date chips, tap-to-expand triage (done/drop/skip/
attention/reschedule/move/delete + undo), full-text search, and a read-only
context+log preview. The primary surface is the quick-add modal (FAB or Cmd-'),
which live-parses the TUI syntax into preview chips and supports voice via
on-device dictation / the Web Speech API. rpc.js is the online-only JSON-RPC
client mirroring heph-tui's Backend; settings persist in localStorage. Service
worker caches the app shell for offline launch.

Verified end-to-end against a local server-mode hephd (--web-root): the app
boots, calls the view RPC, and renders RankedTasks in headless Chrome.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-04 16:59:37 -07:00

2.3 KiB

Raw Blame History

heph-pwa

A phone-first, installable Progressive Web App that mirrors heph-tui: browse the built-in views and projects, triage tasks, and — the primary use case — capture tasks fast with the same quick-add syntax as the TUI's a / Cmd-' popover. Context/KB is read-only here.

Full guide: docs/how-to/heph-pwa.md.

What it is

Thin, online-only client. Every read/write is a JSON-RPC call to a server-mode hephd (the sync hub). No local replica, no offline write queue.
Buildless. Plain ES modules, no bundler, no npm install. Serve the directory and go.
Same parser as the TUI. src/quickadd.js + src/datespec.js are faithful ports of the Rust hephd::quickadd / hephd::datespec modules, verified by parity tests against the original Rust unit cases.

Layout

index.html              # app shell
styles.css              # dark, terminal-flavored, touch-tuned
manifest.webmanifest    # PWA manifest (installable)
sw.js                   # service worker — caches the app shell for offline launch
icons/                  # app icons (svg + rasterized png, incl. maskable)
src/
  app.js                # UI controller: views, list, quick-add, triage, search, voice
  rpc.js                # hephd JSON-RPC-over-HTTP client + settings (localStorage)
  quickadd.js           # quick-add parser (port of quickadd.rs)
  datespec.js           # date + recurrence parser (port of datespec.rs)
  fmt.js                # display helpers (date chips, attention colors, bullets)
test/
  parsers.test.mjs      # parity tests for the parser ports

Run it

Serve from the hub (recommended — same-origin, no CORS):

hephd --mode server --http-addr 0.0.0.0:8787 --web-root /path/to/heph-pwa
# then open http://<host>:8787/ on your phone and Add to Home Screen

Or from any static server (the hub now sends CORS headers, so cross-origin /rpc calls work); set the hub URL in the app's Settings screen.

Test

node --test heph-pwa/test/parsers.test.mjs

Status / next steps

First cut (C1). Known gaps, roughly in priority order:

In-app OIDC device-code login (today: paste a bearer token in Settings).
Offline write queue / CRDT replica (today: online-only).
Read-only context could grow wiki-link navigation.
A native Swift wrapper, if/when an Apple Developer account is in play.

2.3 KiB Raw Blame History