diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 9dc4660..b9cbce1 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -18,6 +18,14 @@ Use this document to: Detailed implementation plans live under `docs/roadmaps/`. +# Status Legend + +- **Scaffolded** — package/app/module structure exists and boots. +- **Mock-backed** — UI/workflow exists but currently runs on mock or fallback data. +- **Local-only** — behavior exists in client/local state without real backend persistence. +- **Integrated** — wired to the intended backend/platform dependency. +- **Verified** — exercised by build, typecheck, tests, or smoke checks. + # 2. Confirmed Stack - **Web** @@ -261,7 +269,7 @@ Detailed implementation plans live under `docs/roadmaps/`. - 2026-03-10 — Web workstream materially advanced: - `learning_ai_notes/web/` was scaffolded from scratch - authenticated shell and core route surfaces now exist - - dashboard, workspaces, note detail, search, settings, and error states are implemented with mock data + - dashboard, workspaces, note detail, search, settings, and error states are implemented as **mock-backed** surfaces - the web roadmap is now tracking real implementation state instead of draft-only planning - 2026-03-10 — Backend workstream materially advanced: - `learning_ai_notes/backend/` was scaffolded from scratch @@ -276,7 +284,7 @@ Detailed implementation plans live under `docs/roadmaps/`. - `web` `npm run build` passes after fixing the auth `BaseUser` shape and guarding demo session init from server-side `localStorage` - `backend/` dependencies are now installed - `backend` `npm run typecheck` passes after normalizing Fastify type boundaries for `file:` workspace deps - - `backend` `npm test` passes after fixing hoisted Vitest mock patterns and stale route registration count assertions + - `backend` `npm test` passes after fixing hoisted Vitest mock patterns and stale route registration count assertions, though the current route tests are still mostly registration-focused rather than deep API-behavior coverage - 2026-03-10 — Web operator/search density materially advanced: - saved views are now represented across dashboard, workspaces, and search - search results now expose a denser operational layout with status, owner, and workspace metadata @@ -296,7 +304,7 @@ Detailed implementation plans live under `docs/roadmaps/`. - Expo + TypeScript root config and Expo Router entrypoints now exist - auth shell, tab navigation, home/recent notes, search, quick capture, inbox, and note detail surfaces now exist - shared mobile wiring now exists for auth, platform client, offline queue, token-based theme usage, and first-pass Zustand stores - - mobile currently uses provisional product config values and fallback note/workspace data pending final identity and contract alignment + - mobile currently uses provisional product config values and **fallback/local-only** note-workspace behavior pending final identity and contract alignment - 2026-03-10 — Mobile utility materially advanced: - home/search/capture are workspace-aware, and home exposes a retrieval summary surface - capture exposes offline queue readiness details for the scaffold @@ -310,11 +318,11 @@ Detailed implementation plans live under `docs/roadmaps/`. # 9. Current Known Blockers / Deferrals - **Blocker** - - Product identity and backend contract details are still not finalized in the planning docs, so the web app currently uses provisional config values and mock data. + - Product identity and backend contract details are still not finalized in the planning docs, so the web app currently uses provisional config values and mock-backed data. - **Blocker** - `@bytelyst/react-native-platform-sdk` is part of the intended mobile architecture, but the current workspace package does not appear ready for direct runtime consumption in this app yet. - **Deferred** - - Real CRUD wiring - - Artifacts - - Approval/review/audit UX + - Real end-to-end CRUD wiring across web and mobile + - Blob-backed artifacts and upload/download flows + - Integrated approval/review/audit UX - Persisted saved views, keyboard shortcut expansion, and deeper performance hardening diff --git a/docs/roadmaps/02_BACKEND_ROADMAP.md b/docs/roadmaps/02_BACKEND_ROADMAP.md index 44767bc..88db273 100644 --- a/docs/roadmaps/02_BACKEND_ROADMAP.md +++ b/docs/roadmaps/02_BACKEND_ROADMAP.md @@ -1,6 +1,6 @@ # Backend Roadmap -Status: Draft +Status: In Progress Parent: `docs/ROADMAP.md` Stack: Fastify 5 + TypeScript ESM + Zod + Cosmos @@ -105,7 +105,7 @@ Stack: Fastify 5 + TypeScript ESM + Zod + Cosmos # Blockers -- Dependencies are not installed yet, so typecheck/test/build verification remains pending. +- Backend verification has advanced, but the current automated route coverage is still mostly registration-focused rather than deep API-behavior or cross-entity integration coverage. - The product identity is still provisional and may require small follow-up renames before wider integration. # Deferred diff --git a/docs/roadmaps/03_WEB_ROADMAP.md b/docs/roadmaps/03_WEB_ROADMAP.md index 58190e7..1628f54 100644 --- a/docs/roadmaps/03_WEB_ROADMAP.md +++ b/docs/roadmaps/03_WEB_ROADMAP.md @@ -29,28 +29,28 @@ Stack: Next.js 16 + React 19 + TypeScript # 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 +- [x] Full note editor scaffold +- [x] Note metadata panel scaffold +- [x] Linked notes UI scaffold +- [x] Artifact/attachment UI scaffold +- [x] Task extraction/review UI scaffold +- [x] Workspace filters and saved views scaffold - [x] Keyboard navigation improvements - [x] 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 -- [x] Product-specific operator workflows +- [x] Agent activity timeline scaffold +- [x] Approval queue UI scaffold +- [x] Before/after proposal review UI scaffold +- [x] Audit filters and review surfaces scaffold +- [x] Product-specific operator workflows scaffold # Phase W4 — Search / Retrieval UX -- [x] Advanced search UI -- [x] Smart views / saved searches if in scope -- [x] Relationship-aware navigation UI +- [x] Advanced search UI scaffold +- [x] Smart views / saved searches scaffold +- [x] Relationship-aware navigation UI scaffold - [x] Higher-density overview improvements # Phase W5 — Hardening @@ -146,7 +146,7 @@ Stack: Next.js 16 + React 19 + TypeScript - `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. +- Backend integration contracts are not yet aligned with the web shell, so the current routes still rely on mock data and demo auth fallback behavior. # Deferred diff --git a/docs/roadmaps/04_MOBILE_ROADMAP.md b/docs/roadmaps/04_MOBILE_ROADMAP.md index 3256eb8..d10ca26 100644 --- a/docs/roadmaps/04_MOBILE_ROADMAP.md +++ b/docs/roadmaps/04_MOBILE_ROADMAP.md @@ -1,6 +1,6 @@ # Mobile Roadmap -Status: Draft +Status: In Progress Parent: `docs/ROADMAP.md` Stack: React Native + Expo + TypeScript @@ -23,25 +23,25 @@ Stack: React Native + Expo + TypeScript - [x] Quick capture flow - [x] Search screen - [x] Notifications/inbox placeholder if needed -- [x] Connect notes/workspaces APIs +- [x] Connect notes/workspaces API client scaffold # Phase M2 — Product Utility -- [x] Lightweight editing +- [x] Lightweight local editing - [ ] Notification handling - [ ] Offline queue / sync polish -- [x] Approvals inbox if in MVP scope -- [x] Basic artifact metadata viewing if in MVP scope +- [x] Approvals inbox scaffold if in MVP scope +- [x] Basic artifact metadata viewing scaffold if in MVP scope # Phase M3 — Agent / Approval Utility -- [x] Approval/reject actions -- [x] Lightweight agent activity feed -- [x] Mobile-friendly review surfaces for simple actions +- [x] Approval/reject actions scaffold +- [x] Lightweight agent activity feed scaffold +- [x] Mobile-friendly review surfaces scaffold for simple actions # Phase M4 — Hardening -- [x] Smoke tests +- [ ] Smoke tests - [x] Error-state polish - [x] Build/compile verification - [x] Token compliance review @@ -56,8 +56,8 @@ Stack: React Native + Expo + TypeScript # Done When -- [x] Mobile is useful for capture and retrieval -- [x] Mobile supports lightweight editing and approvals for MVP +- [x] Mobile is useful for scaffolded capture and retrieval +- [x] Mobile supports lightweight local editing and approval scaffolds for MVP - [x] Mobile does not try to duplicate dense web-only workflows # Progress Notes @@ -101,3 +101,4 @@ Stack: React Native + Expo + TypeScript - Real notification handling - Offline queue flush/retry integration against live APIs +- Real backend persistence for note detail, edits, approvals, and activity diff --git a/docs/roadmaps/07_QA_RELEASE_DOCS_ROADMAP.md b/docs/roadmaps/07_QA_RELEASE_DOCS_ROADMAP.md index 98b61a1..04d9948 100644 --- a/docs/roadmaps/07_QA_RELEASE_DOCS_ROADMAP.md +++ b/docs/roadmaps/07_QA_RELEASE_DOCS_ROADMAP.md @@ -13,11 +13,11 @@ Parent: `docs/ROADMAP.md` # Phase Q1 — MVP Coverage -- [x] Backend CRUD/search test coverage +- [ ] Backend CRUD/search behavior coverage - [ ] Web flow coverage - [ ] Mobile smoke coverage - [ ] Platform integration smoke coverage -- [x] Artifact/task/relationship test coverage +- [ ] Artifact/task/relationship behavior coverage # Phase Q2 — Agent Coverage @@ -54,6 +54,7 @@ Parent: `docs/ROADMAP.md` - `backend` `npm test` passes - MCP contract tests and executable MCP tool tests now pass - MCP scope-guard regression tests now pass for invalid product-scoped mutating requests + - current route-module coverage is still shallow in places and should not yet be treated as full CRUD/integration behavior coverage # Open Questions