diff --git a/docs/AGENT_TASK_ROADMAP.md b/docs/AGENT_TASK_ROADMAP.md index 88b3801..ce30468 100644 --- a/docs/AGENT_TASK_ROADMAP.md +++ b/docs/AGENT_TASK_ROADMAP.md @@ -1,5 +1,7 @@ # NoteLett — Agent Task Roadmap +> **Historical snapshot.** This March 31, 2026 task roadmap is superseded for production-readiness execution. In particular, the old claim that common-platform backend package sources are missing is stale: those packages now exist under `../learning_ai/learning_ai_common_plat/packages/`. Use [`docs/PRODUCTION_READINESS_HANDOFF_ROADMAP.md`](PRODUCTION_READINESS_HANDOFF_ROADMAP.md) as the active checklist. + **Date:** March 31, 2026 **Product:** NoteLett (`notelett`) — Structured notes for humans + AI agents **Repo:** `learning_ai_notes` @@ -16,7 +18,7 @@ | **Web** | 6 pages, 13 components, 15 lib files | 7 unit + 7 E2E | ✅ next build | 10 (all used) | | **Mobile** | 5 tabs incl. settings, note detail, auth (+ register + session-aware index), kill-switch gate, broadcast + survey in root layout, feedback on settings, **auth-gated** store hydrates + broadcast/survey polling, offline queue flush (after auth, boot + foreground), **`flushTelemetry` on background**, `app-metadata` for telemetry versions, Vitest RN mocks + component smokes (auth, home, settings), 5 stores | 33 tests (7 files) | ✅ typecheck | Direct `@bytelyst/*` clients (+ optional future RN platform SDK) | -**Package resolution note:** 5 backend `@bytelyst/*` packages (`backend-config`, `backend-flags`, `backend-telemetry`, `fastify-auth`, `field-encrypt`) do not have source directories in `learning_ai_common_plat/packages/`. They resolve via `^0.1.0` from the private Gitea npm registry but their source must be created in common_plat. This is a shared blocker with NomGap — see Phase 0 below. +**Historical package resolution note:** The earlier claim that 5 backend `@bytelyst/*` packages were missing from common platform is stale. On May 5, 2026, `backend-config`, `backend-flags`, `backend-telemetry`, `fastify-auth`, and `field-encrypt` exist in `../learning_ai/learning_ai_common_plat/packages/`. Current package/API drift is tracked in `docs/PRODUCTION_READINESS_HANDOFF_ROADMAP.md` P0.5/P2/P5. ### Web — AI-fast product roadmap @@ -38,7 +40,7 @@ For **ordered mobile implementation** (Expo app under `mobile/`), use **[`MOBILE --- -## Phase 0 — Missing Platform Package Source (SHARED BLOCKER) +## Phase 0 — Missing Platform Package Source (HISTORICAL, RESOLVED) These 5 backend packages are depended on by both NoteLett and NomGap but have no source directory in `learning_ai_common_plat/packages/`. They must be created there before either product's backend can be built from a clean checkout of common_plat. diff --git a/docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md b/docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md index 01f3918..8f33f9b 100644 --- a/docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md +++ b/docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md @@ -1,5 +1,7 @@ # NoteLett — Architecture Review, Gap Analysis, and Reuse-First Action Plan +> **Historical architecture review.** This March 10, 2026 review remains useful context for product-local versus common-platform boundaries, but it is not the active implementation tracker. Use [`docs/PRODUCTION_READINESS_HANDOFF_ROADMAP.md`](PRODUCTION_READINESS_HANDOFF_ROADMAP.md) for current production-readiness work and commit tracking. + Version: 1.0 Date: March 10, 2026 Status: Draft diff --git a/docs/GAP_ANALYSIS.md b/docs/GAP_ANALYSIS.md index 2c5f33e..32f161c 100644 --- a/docs/GAP_ANALYSIS.md +++ b/docs/GAP_ANALYSIS.md @@ -1,5 +1,7 @@ # NoteLett — Gap Analysis +> **Historical snapshot.** This March 19, 2026 audit is no longer an active execution source. Several gaps listed here have since been implemented, and several pass/fail counts are stale. Use [`docs/PRODUCTION_READINESS_HANDOFF_ROADMAP.md`](PRODUCTION_READINESS_HANDOFF_ROADMAP.md) as the active production-readiness checklist and [`docs/ROADMAP.md`](ROADMAP.md) for reconciled current status. + **Date:** March 19, 2026 **Auditor:** Cascade (systematic code review) **Scope:** Full repo audit — backend, web, mobile, MCP, tests, DevOps, docs diff --git a/docs/PRODUCTION_READINESS_HANDOFF_ROADMAP.md b/docs/PRODUCTION_READINESS_HANDOFF_ROADMAP.md index 529e932..e5f886f 100644 --- a/docs/PRODUCTION_READINESS_HANDOFF_ROADMAP.md +++ b/docs/PRODUCTION_READINESS_HANDOFF_ROADMAP.md @@ -109,7 +109,7 @@ Goal: remove roadmap drift so agents do not chase already completed or obsolete - [x] **P1.1** Reconcile `docs/ROADMAP.md` with actual implemented status for product identity, ports, CRUD, tests, Docker, CI, MCP, Smart Actions, intake, Palace, and platform integrations. Commit: `3553b6e`; Verified: `git diff --check`; roadmap now reflects NoteLett identity, port `4016`, implemented CRUD/MCP/review/search/mobile/platform surfaces, and the active May 5 Palace/LLM/lint/smoke blockers instead of March draft checkboxes. - [x] **P1.2** Update `AGENTS.md` with current module list, endpoint list, test counts, route modules, containers, shared packages, and verification commands. Commit: `99efad8`; Verified: `git diff --check`; AGENTS now points at the active production-readiness roadmap, the correct common-platform path, current backend/web/mobile modules, 14 API route modules, expanded endpoint/container lists, current test inventory, lint/E2E commands, and the May 5 baseline failure note. - [x] **P1.3** Update `README.md` quick start with required common-platform services, auth expectations, Docker path, local memory mode, and production env requirements. Commit: `014b098`; Verified: `git diff --check`; README now documents the local common-platform checkout, platform/extraction/MCP ports, memory-mode command, Docker compose smoke path, auth expectations, production env requirements, and current baseline caveat. -- [ ] **P1.4** Mark stale `docs/GAP_ANALYSIS.md`, `docs/AGENT_TASK_ROADMAP.md`, and older reuse roadmaps as historical or reconcile their open items with this roadmap. Commit: +- [x] **P1.4** Mark stale `docs/GAP_ANALYSIS.md`, `docs/AGENT_TASK_ROADMAP.md`, and older reuse roadmaps as historical or reconcile their open items with this roadmap. Commit: `pending`; Verified: `git diff --check`; added historical/superseded banners to the March gap analysis, agent task roadmap, architecture review, and reuse alignment roadmaps, including a correction that the common-platform backend package-source blocker is stale. - [ ] **P1.5** Add a concise architecture boundary section: product-local NoteLett logic versus common platform responsibilities. Commit: Acceptance criteria: diff --git a/docs/roadmaps/08_ARCHITECTURE_REUSE_MASTER_ROADMAP.md b/docs/roadmaps/08_ARCHITECTURE_REUSE_MASTER_ROADMAP.md index 23a969f..67dede4 100644 --- a/docs/roadmaps/08_ARCHITECTURE_REUSE_MASTER_ROADMAP.md +++ b/docs/roadmaps/08_ARCHITECTURE_REUSE_MASTER_ROADMAP.md @@ -1,5 +1,7 @@ # Architecture Reuse Master Roadmap +> **Historical reuse roadmap.** This draft is superseded by [`../PRODUCTION_READINESS_HANDOFF_ROADMAP.md`](../PRODUCTION_READINESS_HANDOFF_ROADMAP.md) for active production-readiness execution. Keep it as context only unless the active roadmap explicitly reopens an item. + Status: Draft Parent: `docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md` Scope: Whole repo architecture alignment diff --git a/docs/roadmaps/09_BACKEND_REUSE_ALIGNMENT_ROADMAP.md b/docs/roadmaps/09_BACKEND_REUSE_ALIGNMENT_ROADMAP.md index 7dd7326..244f815 100644 --- a/docs/roadmaps/09_BACKEND_REUSE_ALIGNMENT_ROADMAP.md +++ b/docs/roadmaps/09_BACKEND_REUSE_ALIGNMENT_ROADMAP.md @@ -1,5 +1,7 @@ # Backend Reuse Alignment Roadmap +> **Historical reuse roadmap.** This draft is superseded by [`../PRODUCTION_READINESS_HANDOFF_ROADMAP.md`](../PRODUCTION_READINESS_HANDOFF_ROADMAP.md) for active production-readiness execution. Backend platform/API drift is currently tracked there in P0.5, P2, P3, and P5. + Status: Draft Parent: `docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md` Scope: `backend/` diff --git a/docs/roadmaps/10_WEB_REUSE_ALIGNMENT_ROADMAP.md b/docs/roadmaps/10_WEB_REUSE_ALIGNMENT_ROADMAP.md index 8598dfb..0d2f700 100644 --- a/docs/roadmaps/10_WEB_REUSE_ALIGNMENT_ROADMAP.md +++ b/docs/roadmaps/10_WEB_REUSE_ALIGNMENT_ROADMAP.md @@ -1,5 +1,7 @@ # Web Reuse Alignment Roadmap +> **Historical reuse roadmap.** This draft is superseded by [`../PRODUCTION_READINESS_HANDOFF_ROADMAP.md`](../PRODUCTION_READINESS_HANDOFF_ROADMAP.md) for active production-readiness execution. Current web design-system, accessibility, auth, E2E, and production UX work is tracked there. + Status: Draft Parent: `docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md` Scope: `web/` diff --git a/docs/roadmaps/11_MOBILE_REUSE_ALIGNMENT_ROADMAP.md b/docs/roadmaps/11_MOBILE_REUSE_ALIGNMENT_ROADMAP.md index d2b5f26..78b5540 100644 --- a/docs/roadmaps/11_MOBILE_REUSE_ALIGNMENT_ROADMAP.md +++ b/docs/roadmaps/11_MOBILE_REUSE_ALIGNMENT_ROADMAP.md @@ -1,5 +1,7 @@ # Mobile Reuse Alignment Roadmap +> **Historical reuse roadmap.** This draft is superseded by [`../PRODUCTION_READINESS_HANDOFF_ROADMAP.md`](../PRODUCTION_READINESS_HANDOFF_ROADMAP.md) for active production-readiness execution. Current mobile SDK/sync/platform decisions are tracked there in P2 and P7. + Status: Draft Parent: `docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md` Scope: `mobile/` diff --git a/docs/roadmaps/12_PLATFORM_SHARED_SERVICES_ALIGNMENT_ROADMAP.md b/docs/roadmaps/12_PLATFORM_SHARED_SERVICES_ALIGNMENT_ROADMAP.md index 7e69a29..7c2af59 100644 --- a/docs/roadmaps/12_PLATFORM_SHARED_SERVICES_ALIGNMENT_ROADMAP.md +++ b/docs/roadmaps/12_PLATFORM_SHARED_SERVICES_ALIGNMENT_ROADMAP.md @@ -1,5 +1,7 @@ # Platform and Shared Services Alignment Roadmap +> **Historical reuse roadmap.** This draft is superseded by [`../PRODUCTION_READINESS_HANDOFF_ROADMAP.md`](../PRODUCTION_READINESS_HANDOFF_ROADMAP.md) for active production-readiness execution. Current platform-service, extraction-service, MCP, telemetry, diagnostics, flags, kill switch, and blob smoke work is tracked there in P2 and P8. + Status: Draft Parent: `docs/ARCHITECTURE_REVIEW_AND_REUSE_ROADMAP.md` Scope: cross-cutting shared service/package adoption