diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index b9cbce1..43837d2 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -269,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 as **mock-backed** surfaces + - dashboard, workspaces, note detail, search, settings, and error states now mix backend-backed data with a smaller set of still-derived operator/saved-view summaries - 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 @@ -304,12 +304,21 @@ 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/local-only** note-workspace behavior pending final identity and contract alignment + - mobile currently uses provisional product config values, but quick capture and note retrieval/edit flows are now wired to the product backend for the core note/workspace slice - 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 - - note detail supports lightweight local editing, artifact summary, and first-pass loading polish + - note detail supports lightweight backend-backed editing, artifact summary, and first-pass loading polish - inbox supports simple approval/reject flows plus a lightweight activity feed +- 2026-03-10 — Real note/workspace vertical slice materially advanced (`5995b6c`): + - mobile quick capture now persists notes to the product backend instead of saving local-only drafts + - mobile note editing continues to flow through backend note update endpoints for persisted notes + - web dashboard, workspaces, search, and reviews now derive their operator/saved-view side panels from live note/workspace/review data instead of static mock fixtures + - web note detail now hydrates linked notes from the backend `note-relationships` endpoint with graceful fallback when relationship data is unavailable + - verification passed for this slice with: + - `web` `npm run typecheck` + - `web` `npm test` + - `mobile` `npm run typecheck` - 2026-03-10 — Mobile verification materially advanced: - mobile dependencies now install successfully with corrected sibling `@bytelyst/*` package paths - `npm run typecheck`, `npm run lint`, and `npm test` now pass in `learning_ai_notes/mobile/` @@ -318,11 +327,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-backed 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 still derives some operator/saved-view summaries client-side. - **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 end-to-end CRUD wiring across web and mobile + - Complete real end-to-end CRUD wiring across every web/mobile surface - 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/03_WEB_ROADMAP.md b/docs/roadmaps/03_WEB_ROADMAP.md index 1628f54..af80d0d 100644 --- a/docs/roadmaps/03_WEB_ROADMAP.md +++ b/docs/roadmaps/03_WEB_ROADMAP.md @@ -83,7 +83,7 @@ Stack: Next.js 16 + React 19 + TypeScript - search - settings - not-found - - Used mock notes/workspaces and demo auth fallback so UI work can proceed before backend contracts are finalized. + - Initially used mock notes/workspaces and demo auth fallback so UI work could proceed before backend contracts were finalized. - Expanded W2/W3 surfaces with: - note metadata panel - linked notes panel @@ -116,15 +116,21 @@ Stack: Next.js 16 + React 19 + TypeScript - `npm run typecheck` - `npm run build` - Hardened Next.js build config by setting `outputFileTracingRoot`, removing the repeated workspace-root warning during `web` production builds - - Reconciled roadmap-vs-code drift by fully wiring the richer mock-data surfaces into the actual routes: - - dashboard now shows saved views and operator workflow cards in the primary operational shell - - workspaces now exposes saved-view inventory plus denser ownership/filter context - - search now renders saved searches, retrieval filters, and denser result rows - - reviews now surfaces operator workflow summaries alongside the approval queue + - Reconciled roadmap-vs-code drift by wiring the richer operational surfaces into the actual routes: + - dashboard now derives saved views and operator workflow cards from live note/workspace/review data + - workspaces now exposes saved-view inventory plus denser ownership/filter context from backend-backed workspace data + - search now renders live-derived saved searches, retrieval filters, and denser result rows + - reviews now surfaces live-derived operator workflow summaries alongside the approval queue - Re-verified the richer route slice with: - `npm run typecheck` - `npm test` - `npm run build` + - Added the first backend relationship hydration in the note-detail client: + - linked notes now load from the product backend `note-relationships` endpoint + - the client falls back safely when relationship data is unavailable + - Re-verified the backend-backed note/workspace slice with: + - `npm run typecheck` + - `npm test` # Open Questions @@ -146,11 +152,10 @@ Stack: Next.js 16 + React 19 + TypeScript - `ByteLyst Agentic Notes` - `agentic-notes` - `4016` as a placeholder notes API port in `.env.example` -- 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. +- Backend integration contracts are only partially aligned with the web shell, so some routes still rely on demo auth fallback and client-derived operator/saved-view summaries. # Deferred -- Real backend integration for notes, workspaces, auth, and search - Real saved-view persistence and backend-backed workspace filters - Artifact upload/download UX - Extraction-backed task review flows diff --git a/docs/roadmaps/04_MOBILE_ROADMAP.md b/docs/roadmaps/04_MOBILE_ROADMAP.md index d10ca26..1deb4e0 100644 --- a/docs/roadmaps/04_MOBILE_ROADMAP.md +++ b/docs/roadmaps/04_MOBILE_ROADMAP.md @@ -74,7 +74,7 @@ Stack: React Native + Expo + TypeScript - Zustand-backed auth, notes, and workspace stores were added for first-pass mobile state management. - Home/search/capture now use active workspace context for more useful mobile browsing. - Home now includes a workspace retrieval summary block to make the mobile surface more useful at a glance. -- Note detail now supports lightweight local editing plus basic artifact metadata viewing. +- Note detail now supports lightweight editing against persisted notes plus basic artifact metadata viewing. - Note detail now exposes first-pass loading-state polish. - Inbox now supports simple approval/reject flows and a lightweight activity feed. - Capture now surfaces offline queue readiness details for the current mobile scaffold. @@ -83,7 +83,10 @@ Stack: React Native + Expo + TypeScript - Mobile now uses token-backed placeholder and border colors instead of raw hardcoded fallbacks. - Expo now boots locally, and `tsconfig.json` was aligned to extend `expo/tsconfig.base`. - Mobile core Expo package versions were aligned to the SDK 55 expectations surfaced during runtime startup. -- Mobile currently uses provisional product config and fallback note/workspace data until product identity and backend contract details are finalized. +- Mobile currently uses provisional product config, but the core quick-capture and note retrieval/edit slice is now wired to the product backend. +- Quick capture now persists notes through the product backend instead of saving local-only drafts. +- Re-verified the current mobile slice with: + - `npm run typecheck` # Open Questions @@ -101,4 +104,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 +- Real backend persistence for approvals and activity