# 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.