docs(roadmap): mark stale planning docs historical

This commit is contained in:
Saravana Achu Mac 2026-05-05 09:16:17 -07:00
parent cd40cecd09
commit 6307c60c41
9 changed files with 19 additions and 3 deletions

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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:

View File

@ -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

View File

@ -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/`

View File

@ -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/`

View File

@ -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/`

View File

@ -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