docs: initial Hermes Mobile planning scaffold

2026-07-09 03:45:48 +00:00
commit 2cd4730324
14 changed files with 2139 additions and 0 deletions
@@ -0,0 +1,132 @@
+# Roadmap
+
+## Phase 0 — Planning Scaffold
+
+Status: current.
+
+Deliverables:
+- Repo created
+- Product plan
+- Architecture plan
+- Design direction
+- Install strategy
+- Project structure
+
+## Phase 1 — Skeleton
+
+Goal: empty but runnable monorepo.
+
+Deliverables:
+- pnpm workspace
+- `apps/mobile` Vite React PWA
+- `apps/companion` Fastify server
+- shared TypeScript package for event/API schemas
+- basic app shell with bottom nav
+- `/api/health`
+- local dev scripts
+
+## Phase 2 — Basic Hermes Prompting
+
+Goal: phone can send text prompt and receive final answer.
+
+Deliverables:
+- pairing/auth MVP
+- Settings connect flow
+- task creation endpoint
+- Hermes CLI/API adapter MVP
+- Ask screen sends prompt
+- response display
+- task history in SQLite
+
+## Phase 3 — Realtime Activity + Tool Timeline
+
+Goal: see Hermes work live.
+
+Deliverables:
+- event bus
+- WebSocket/SSE stream
+- tool timeline UI
+- Python worker adapter using AIAgent callbacks if needed
+- coarse/fine tool event mapping
+
+## Phase 4 — Uploads + Voice
+
+Goal: prompt with files and voice notes.
+
+Deliverables:
+- multipart upload endpoint
+- upload tray UI
+- image/archive/pdf metadata
+- voice recorder UI
+- local STT or Hermes STT bridge
+- attach files to task prompt
+
+## Phase 5 — Notifications
+
+Goal: close phone and get told when done.
+
+Deliverables:
+- PWA service worker
+- Web Push subscription management
+- notification provider abstraction
+- ntfy fallback
+- completion/failure/approval notifications
+
+## Phase 6 — Cron + Approvals
+
+Goal: mobile control plane.
+
+Deliverables:
+- cron list/run/pause/resume/remove
+- cron output viewer
+- approval queue UI
+- companion approval API
+- Hermes approval integration strategy
+
+## Phase 7 — Installer + Release
+
+Goal: one-liner install.
+
+Deliverables:
+- production build
+- install.sh
+- systemd service
+- update/uninstall modes
+- release artifact
+- pairing URL output
+
+## Phase 8 — Android Polish
+
+Goal: feels native.
+
+Deliverables:
+- refined Happy-inspired UI
+- animations/microinteractions
+- adaptive icons/splash
+- share target
+- haptics
+- offline shell polish
+- optional Capacitor wrapper evaluation
+
+## Phase 9 — Deep Hermes Integration
+
+Goal: full Hermes-native experience.
+
+Deliverables:
+- structured event stream from Hermes core or stable Python adapter
+- richer session browsing
+- generated file detection
+- background process control
+- subagent visualization
+- memory/skills dashboards possibly
+
+## Open Feature Ideas
+
+- Quick action tiles: “Check homelab”, “Run DV status”, “Start coding task”.
+- Voice-to-voice mode.
+- Per-task model/toolset selection.
+- “Watch mode” for long-running coding tasks.
+- Home Assistant widgets/actions.
+- Secure notification actions: approve/deny from notification.
+- Android native share target.
+- QR pairing from terminal output.