docs: move roadmap from #4 to docs/ROADMAP.md

docs/ROADMAP.md

@@ -0,0 +1,44 @@
+# Roadmap
+
+> Moved from issue #4 on 2026-09-04. Issues are for bug reports and feature requests; the roadmap lives here. To pick up an item, open an issue referencing it.
+
+## Where we are (v1.12)
+
+- **5 platforms** — OpenClaw, Codex, Claude Code, Hermes (SQLite) and OMP, parsed from their native log formats
+- **Session browser** with tool-call inspection, trace/waterfall view, spawn tracking and message timeline
+- **Prompt tooling** — extraction (noise filtered), template clustering with outcome attribution, Claude-powered rewrites, and a prompt library that installs entries as native slash commands
+- **Global search** across all platforms, insights dashboard, incremental session backup
+- **React + Vite frontend** served by an Express backend; 46 tests on Node's built-in runner, CI on Node 22
+
+## Roadmap
+
+- [x] **Publish to npm** so `npx agent-xray` works without cloning — automated from GitHub releases (v1.14.0+)
+- [x] **Hosted live demo** on GitHub Pages with clearly-labeled synthetic session data, so people can try the UI before installing
+- [x] **Gemini CLI adapter** (`~/.gemini/tmp`) — shipped (#5)
+- [ ] **More platform adapters** — opencode and Aider are the most-requested log formats; the per-platform module layout in `lib/platforms/` is designed for this
+- [x] **Session export & sharing** — render a session (with tool calls) to a standalone Markdown/HTML file you can attach to a bug report or blog post (#6)
+- [ ] **Cost & token analytics** — per-session and per-day token spend, broken down by model, building on the token counts we already parse for the summary panel
+- [ ] **Watch mode ergonomics** — highlight the currently-active session and surface "agent is waiting for input" state in the sidebar
+
+### Product
+
+From a product review (2026-08-21) — funnel and retention fixes around the npm release:
+
+- [x] Demo must showcase the differentiators (search, spawn navigation, prompt library), not the thinnest layer (#12)
+- [x] First launch: auto-pick the first platform that actually has sessions (#13)
+- [x] Prompt optimization: drop the hard dependency on a local claude CLI (#14)
+
+### Tech debt
+
+Structural cleanups surfaced by a code review — not features, but they lower the cost of every future one:
+
+- [x] Extract a unified PLATFORMS registry to collapse seven copy-pasted adapter skeletons (#8)
+- [x] Decide the legacy UI's fate and eliminate the markdown/pure double-write (#9)
+- [x] Split server.js into route modules and lib/ business logic (#10)
+
+## Non-goals (for now)
+
+- Cloud sync or any server-side storage of session data — AgentXRay stays a local, read-only viewer of your own logs
+- A plugin marketplace — adapters land in-tree until the format count justifies more
+
+Issue references above are created alongside this roadmap; anything without a link is open for discussion.