# Web Roadmap

Status: In Progress
Parent: `docs/ROADMAP.md`
Stack: Next.js 16 + React 19 + TypeScript

# Phase W0 — Scaffold

- [x] Create Next.js app structure
- [x] Wire `@bytelyst/api-client`
- [x] Wire `@bytelyst/platform-client`
- [x] Wire `@bytelyst/react-auth`
- [x] Wire `@bytelyst/telemetry-client`
- [x] Wire `@bytelyst/diagnostics-client`
- [x] Import shared tokens
- [x] Create app shell/layout
- [x] Define route structure

# Phase W1 — Core Product Shell

- [x] Authenticated shell
- [x] Sidebar/navigation
- [x] Dashboard page
- [x] Workspace page
- [x] Note detail/editor page
- [x] Search page
- [x] Settings page
- [x] Empty/loading/error states

# Phase W2 — Notes MVP UX

- [x] Full note editor experience
- [x] Note metadata panel
- [x] Linked notes UI
- [x] Artifact/attachment UI
- [x] Task extraction/review UI
- [x] Workspace filters and saved views
- [ ] Keyboard navigation improvements
- [ ] Dense knowledge UX polish

# Phase W3 — Agent UX

- [x] Agent activity timeline
- [x] Approval queue UI
- [x] Before/after proposal review UI
- [x] Audit filters and review surfaces
- [ ] Product-specific operator workflows

# Phase W4 — Search / Retrieval UX

- [x] Advanced search UI
- [ ] Smart views / saved searches if in scope
- [x] Relationship-aware navigation UI
- [ ] Higher-density overview improvements

# Phase W5 — Hardening

- [ ] Performance pass
- [ ] Accessibility pass
- [ ] Token validation pass
- [ ] Production build passes
- [ ] UX polish pass

# High-Collision Areas

- [ ] top-level layout files
- [ ] auth provider setup
- [ ] navigation config
- [ ] token/theme entrypoints

# Progress Notes

- 2026-03-10
  - Created a new `web/` Next.js 16 scaffold from scratch because the repo started docs-only.
  - Added ByteLyst shared package wiring for auth, platform client, telemetry, diagnostics, and shared design tokens.
  - Implemented the first production-shaped route shells:
    - landing page
    - app shell layout
    - sidebar navigation
    - dashboard
    - workspaces
    - note detail/editor
    - search
    - settings
    - not-found
  - Used mock notes/workspaces and demo auth fallback so UI work can proceed before backend contracts are finalized.
  - Expanded W2/W3 surfaces with:
    - note metadata panel
    - linked notes panel
    - task review panel
    - artifact panel
    - workspace filter/saved-view shell
    - advanced search filter/explainability shell
    - review route with approval queue, before/after proposal card, and agent timeline

# Open Questions

- What are the final values for:
  - product name
  - `productId`
  - backend port
  - domain identifiers
- What are the exact product-backend endpoints and response shapes for:
  - auth
  - notes CRUD
  - workspaces CRUD
  - search
- Which operator review/audit surfaces should stay product-local vs shared-dashboard-owned?

# Blockers

- The new `web/` app dependencies have not been installed yet, so IDE/typecheck errors currently reflect missing installed packages rather than route structure failures.
- Product identity is still draft-level in the planning docs, so the scaffold currently uses provisional values:
  - `ByteLyst Agentic Notes`
  - `agentic-notes`
  - `4016` as a placeholder notes API port in `.env.example`
- Backend contracts are not implemented yet, so the current shell relies on mock data and demo auth fallback behavior.

# Deferred

- Real backend integration for notes, workspaces, auth, and search
- Real saved-view persistence and richer workspace filters
- Artifact upload/download UX
- Extraction-backed task review flows
- Backend-backed agent activity timeline, approval queue, proposal diff review, and audit filtering
- Dense keyboard navigation, accessibility hardening, and performance polish
- Production verification:
  - install dependencies
  - run typecheck
  - run tests
  - run production build

# Done When

- [ ] Web is the strongest authoring and operator surface
- [ ] Dense knowledge workflows feel production-shaped
- [ ] Agent review and approval flows are usable
