History

Erich Blume 9a487cbe3b All checks were successful Build / validate (pull_request) Successful in 6m57s Details feat(heph-tui,heph-pwa): humanized recurrence + indented/counted/scrolling project sidebar Bundles the cosmetic/UI-polish backlog for the agenda surfaces. All read-side; no schema or sync change (see hub-spoke-data-evolution). - humanize_rrule (hephd::datespec): inverse of parse_recurrence — renders an RRULE as 'every other week', 'weekdays', 'yearly on Apr 15', etc.; falls back to the raw rule for unmodeled parts (COUNT/UNTIL/ordinal BYDAY). Mirrored in the PWA's datespec.js. Shown in the TUI recurs detail line and PWA task/qa previews instead of the raw FREQ= string. - project.overview RPC + Store::project_overview: each project's parent (via the existing 'parent' links) and direct outstanding-task count, a read-only query. - TUI sidebar: subprojects indented by depth, per-project counts, wider pane, and ListState + scrollbar so it scrolls instead of clipping on overflow. Tests: humanize parity (Rust + JS), round-trip through parse_recurrence, raw-passthrough; project_overview count/parent; sidebar tree ordering + cycle safety. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>		2026-06-05 17:44:43 -07:00
..
icons
src	feat(heph-tui,heph-pwa): humanized recurrence + indented/counted/scrolling project sidebar	2026-06-05 17:44:43 -07:00
test	feat(heph-tui,heph-pwa): humanized recurrence + indented/counted/scrolling project sidebar	2026-06-05 17:44:43 -07:00
index.html
manifest.webmanifest
README.md
styles.css	feat(heph-pwa): Login with Authentik (Authorization Code + PKCE)	2026-06-05 07:17:05 -07:00
sw.js	feat(heph-pwa): Login with Authentik (Authorization Code + PKCE)	2026-06-05 07:17:05 -07:00

README.md

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.