diff --git a/docs/roadmaps/WORKSPACE_REVIEW_2026_03_19.md b/docs/roadmaps/WORKSPACE_REVIEW_2026_03_19.md new file mode 100644 index 00000000..e9aa3a8a --- /dev/null +++ b/docs/roadmaps/WORKSPACE_REVIEW_2026_03_19.md @@ -0,0 +1,474 @@ +# ByteLyst Ecosystem — Master Workspace Review + +> **Date:** 2026-03-19 +> **Scope:** 14 repos + 1 temp workspace, 53 platform modules, 51 packages, 9 product backends, 3 dashboards +> **Status:** All Android builds fixed — Full cross-platform compilation achieved + +--- + +## 1. Executive Summary + +### Key Milestones Since Last Review (2026-03-03 → 2026-03-19) + +| Initiative | Status | Key Deliverables | +| ------------------------------ | ---------------- | ------------------------------------------------------------------------- | +| **Android/KMP Build Fixes** | ✅ COMPLETE | All 5 Android apps compile (were broken due to proxy blocking Gradle) | +| **Corporate Proxy Resolution** | ✅ COMPLETE | Gradle truststore, Android SDK CLI install, all deps downloadable | +| **Android SDK Setup** | ✅ COMPLETE | platforms 35+36, build-tools 34/35/36, emulator 36.4.10 | +| **kotlin-platform-sdk Fixes** | ✅ COMPLETE | 56/57 tests pass (13 deferred UI files restored), serializer import fixes | +| **Shared Client Packages** | ✅ 51 packages | Product migrations complete per roadmap | +| **Product Backends** | ✅ All 9 running | 9 Fastify backends + platform-service | +| **NoteLett** | ✅ 100% | Backend + web + mobile, 8 MCP tools, batch review | +| **ActionTrail** | ✅ 100% | 13 modules, SDK, 40 E2E tests | +| **FlowMonk** | ✅ 100% | Scheduler engine, 10 modules, web + mobile | + +### Current Test Counts + +| Component | Tests | Status | +| ----------------------------- | ---------- | --------------------------- | +| platform-service (53 modules) | 1,020 | ✅ | +| Product backends (9 repos) | 1,217 | ✅ | +| Web Vitest (all products) | ~590 | ✅ | +| Mobile (NomGap Vitest) | ~505 | ✅ | +| E2E Playwright (3 products) | ~57 | ✅ | +| iOS XCTest (4 apps) | ~377 | ✅ | +| Android/KMP JUnit (3 apps) | ~217 | ✅ | +| Shared packages (8 tested) | ~139 | ✅ | +| kotlin-platform-sdk | 56/57 | ✅ (1 pre-existing failure) | +| ActionTrail SDK | ~21 | ✅ | +| Python (LysnrAI desktop) | ~52 files | ✅ | +| **Grand Total** | **~4,220** | ✅ | + +--- + +## 2. Platform Infrastructure (learning_ai_common_plat) + +### Services + +| Service | Port | Status | +| ---------------------- | ---- | ----------------------------------- | +| **platform-service** | 4003 | ✅ 53 modules | +| **extraction-service** | 4005 | ✅ Text extraction + Python sidecar | +| **mcp-server** | 4007 | ✅ MCP tool server | + +### Platform-Service Modules (53) + +ab-testing, agent-evals, agents, ai-budgets, ai-diagnostics, analytics, audit, auth, blob, broadcasts, changelog, comments, delivery, diagnostics, experiments, exports, feedback, flags, impersonation, invitations, ip-rules, items, jobs, knowledge, licenses, maintenance, marketplace, notifications, orgs, plans, predictive-analytics, products, promos, public, ratelimit, referrals, reviews, runs, scim, sessions, settings, status, stripe, subscriptions, support-cases, surveys, telemetry, themes, tokens, usage, votes, waitlist, webhooks + +### Shared Packages (51) + +accessibility, api-client, auth, auth-client, auth-ui, blob, blob-client, broadcast-client, celebrations, config, cosmos, dashboard-components, datastore, design-tokens, diagnostics-client, errors, event-store, events, extraction, fastify-core, fastify-sse, feature-flag-client, feedback-client, gentle-notifications, kill-switch-client, kotlin-platform-sdk, llm, llm-router, logger, marketplace-client, monitoring, offline-queue, org-client, platform-client, push, queue, quick-actions, react-auth, react-native-platform-sdk, referral-client, speech, storage, subscription-client, survey-client, swift-diagnostics, swift-platform-sdk, sync, telemetry-client, testing, time-references, webhook-dispatch + +### Dashboards + +| Dashboard | Port | Stack | +| ---------------------- | ---- | ------------------------------------------- | +| **admin-web** | 3001 | Next.js 16 — Platform admin console | +| **user-dashboard-web** | 3002 | Next.js 16 — User portal (in LysnrAI repo) | +| **tracker-web** | 3003 | Next.js 16 — Issue tracker + public roadmap | + +--- + +## 3. Product Repos — Detailed Status + +### 3.1 LysnrAI (`learning_voice_ai_agent`) + +| Surface | Tech | Status | +| --------------- | --------------------------------------------- | ------------------------------ | +| Desktop | Python 3.12, tkinter, Azure Speech SDK | ✅ macOS/Windows/Linux | +| Backend | Fastify 5, port 4015, 7 modules | ✅ 67 tests | +| iOS | SwiftUI + Keyboard Extension (65 Swift files) | ✅ ~94 XCTests | +| Android | Kotlin + Jetpack Compose (66 Kotlin files) | ✅ Compiles (fixed 2026-03-19) | +| Admin Dashboard | Next.js 16, port 3001 | ✅ (in common-plat) | +| User Dashboard | Next.js 16, port 3002 | ✅ | + +**Backend modules:** transcripts, sessions, organizations, api-tokens, webhooks, themes, export +**Latest commit:** `4065fbc` — fix(android): fix LysnrAI Android compile errors +**Dirty files:** 0 + +--- + +### 3.2 ChronoMind (`learning_ai_clock`) + +| Surface | Tech | Status | +| ------------- | --------------------------------- | ---------------------- | +| Web PWA | Next.js 16, React 19, Serwist | ✅ ~394 Vitest tests | +| Backend | Fastify 5, port 4011, 5 modules | ✅ 176 tests | +| iOS | SwiftUI (84 Swift files) | ✅ ~121 XCTests | +| watchOS | SwiftUI (watchOS 10+) | ✅ | +| macOS | SwiftUI menu bar | ✅ | +| Widgets | WidgetKit (3 widgets) | ✅ | +| Live Activity | ActivityKit | ✅ | +| Android | Jetpack Compose (32 Kotlin files) | ✅ ~47 tests, compiles | +| Wear OS | Compose for Wear OS | ✅ Stub | +| E2E | Playwright | ✅ ~10 tests | + +**Backend modules:** timers, routines, households, shared-timers, webhooks +**Latest commit:** `83e54c2` — fix(web): append /api to baseUrl for shared clients +**Dirty files:** 0 + +--- + +### 3.3 NomGap (`learning_ai_fastgap`) + +| Surface | Tech | Status | +| ------- | ------------------------------- | -------------------- | +| Mobile | React Native (Expo SDK 55) | ✅ ~505 Vitest tests | +| Web | Next.js 16, Canvas 2D body viz | ✅ ~130 Vitest tests | +| Backend | Fastify 5, port 4013, 7 modules | ✅ 203 tests | + +**Backend modules:** fasting-sessions, fasting-protocols, body-stages, social-fasting, meal-log, push-triggers, weight-log +**Latest commit:** `f49e42e` — fix(lib): address code review findings +**Dirty files:** 27 (docs + config updates pending) + +--- + +### 3.4 JarvisJr (`learning_ai_jarvis_jr`) + +| Surface | Tech | Status | +| ------- | --------------------------------------------- | ---------------------- | +| iOS | SwiftUI, OpenAI Realtime API (58 Swift files) | ✅ ~4 XCTests | +| watchOS | SwiftUI (watchOS 10+) | ✅ | +| macOS | SwiftUI menu bar | ✅ | +| Web | Next.js 16 | ✅ ~32 Vitest tests | +| Android | Jetpack Compose (24 Kotlin files) | ✅ ~24 tests, compiles | +| Wear OS | Compose stub | ✅ | +| Backend | Fastify 5, port 4012, 5 modules | ✅ 203 tests | + +**Backend modules:** jarvis-agents, jarvis-sessions, jarvis-memory, jarvis-teams, marketplace +**Latest commit:** `2a9cf70` — fix(android): fix Gradle wrapper URL +**Dirty files:** 0 + +--- + +### 3.5 PeakPulse (`learning_ai_peakpulse`) + +| Surface | Tech | Status | +| ------------- | ------------------------------------------------------- | --------------- | +| iOS | SwiftUI, SwiftData, MapKit, WeatherKit (92 Swift files) | ✅ ~158 XCTests | +| watchOS | SwiftUI (watchOS 10+) | ✅ | +| Widgets | WidgetKit (3 widgets) | ✅ | +| Live Activity | ActivityKit | ✅ | +| Backend | Fastify 5, port 4010, 2 modules | ✅ 59 tests | + +**Backend modules:** peak-sessions, peak-routes +**Latest commit:** `6ff8cb0` — fix(ios): fix Platform SDK wrapper API mismatches +**Dirty files:** 0 + +--- + +### 3.6 MindLyst (`learning_multimodal_memory_agents`) + +| Surface | Tech | Status | +| ---------- | --------------------------------- | --------------- | +| KMP Shared | Kotlin Multiplatform (commonMain) | ✅ ~146 tests | +| iOS | SwiftUI (26 Swift files) | ✅ | +| Android | Jetpack Compose (46 Kotlin files) | ✅ APK produced | +| Web | Next.js 16, port 3050 | ✅ | +| Backend | Fastify 5, port 4014, 5 modules | ✅ 63 tests | + +**Backend modules:** brains, memory, reflections, daily-briefs, streaks +**Latest commit:** `289dec4` — fix(android): fix MindLyst Android compile errors +**Dirty files:** 0 + +--- + +### 3.7 NoteLett (`learning_ai_notes`) + +| Surface | Tech | Status | +| ------- | --------------------------------------------- | ------------------------ | +| Backend | Fastify 5, port 4016, 7 modules + 8 MCP tools | ✅ 80 tests | +| Web | Next.js 16, React 19 | ✅ ~14 Vitest tests | +| Mobile | React Native + Expo | ✅ | +| E2E | Playwright | ✅ ~7 tests (scaffolded) | + +**Backend modules:** notes, workspaces, note-relationships, note-tasks, note-artifacts, note-agent-actions, saved-views +**MCP Tools:** list, get, search, create_draft, update, link_notes, extract_tasks, attach_artifact +**Latest commit:** `6babe05` — docs: update IMPLEMENTATION_TRACKER +**Dirty files:** 0 + +--- + +### 3.8 FlowMonk (`learning_ai_flowmonk`) + +| Surface | Tech | Status | +| ------- | -------------------------------- | ------------------- | +| Backend | Fastify 5, port 4017, 10 modules | ✅ 181 tests | +| Web | Next.js 16 | ✅ ~20 Vitest tests | +| Mobile | React Native + Expo | ✅ | + +**Backend modules:** zones, flows, tasks, schedule, schedule-entries, recommendations, audit, export, execution-actions, push-triggers +**Latest commit:** `fff3391` — chore(web): update next-env.d.ts +**Dirty files:** 0 + +--- + +### 3.9 ActionTrail (`learning_ai_trails`) + +| Surface | Tech | Status | +| ------- | --------------------------------------------------------- | ------------ | +| Backend | Fastify 5, port 4018, 13 modules | ✅ 185 tests | +| SDK | @actiontrail/sdk (client + LangChain + OpenAI middleware) | ✅ ~21 tests | +| Web | Next.js 16 | ✅ | +| E2E | Playwright | ✅ ~40 tests | + +**Backend modules:** actions, agents, alerts, approvals, connectors, export, insights, notification-prefs, onboard, reverts, teams, traces, webhooks +**Latest commit:** `99197b2` — fix(auth): JWKS URL-tracking singleton +**Dirty files:** 0 + +--- + +### 3.10 ByteLyst Auth App (`learning_ai_auth_app`) + +| Surface | Tech | Status | +| -------- | --------------------------------- | ----------- | +| iOS | SwiftUI (14 Swift files) | ✅ Scaffold | +| watchOS | SwiftUI companion | ✅ Scaffold | +| Android | Jetpack Compose (17 Kotlin files) | ✅ Scaffold | +| Widgets | WidgetKit (TOTP) + Glance | ✅ Scaffold | +| App Clip | SwiftUI QR scanner | ✅ Scaffold | + +**No separate backend** — consumes platform-service directly via BLAuthClient +**Latest commit:** `7d1dd9d` — docs: add corporate network/Gradle proxy section +**Dirty files:** 0 + +--- + +### 3.11 SmartAuth (`learning_ai_smart_auth`) + +| Type | Status | +| -------------- | ------------------------------------ | +| PRD | ✅ Full 6-phase roadmap | +| Implementation | Extends platform-service auth module | + +**Not a separate service.** Design docs + PRD for OneAuth identity, OAuth, MFA, passkeys, device trust. +**Latest commit:** `4ebe9ff` — docs(roadmap): mark all phases 0-6 complete +**Dirty files:** 0 + +--- + +### 3.12 Productivity Web (`learning_ai_productivity_web`) + +| Type | Status | +| ---- | ------------------------------ | +| Web | Next.js standalone utility app | + +**Latest commit:** `e63b679` — chore: add tsbuildinfo to gitignore +**Dirty files:** 0 + +--- + +### 3.13 Local Memory GPT (`learning_ai_local_memory_gpt`) + +| Type | Status | +| --------- | ----------------------------------------- | +| Prototype | Client/server local LLM memory experiment | + +**No commits on main yet.** + +--- + +### 3.14 temp_uxlab + +**Not a git repo.** Temporary workspace — can be cleaned up. + +--- + +## 4. Cross-Platform Build Matrix + +### Android Builds (All Fixed 2026-03-19) + +| App | compileSdk | Status | Fix Applied | +| -------------- | ---------- | ------------------------ | ----------------------------------------------------------- | +| **ChronoMind** | 35 | ✅ Compiles + tests pass | Serializer imports, CMColors, TimerWidget, SyncRepository | +| **JarvisJr** | 35 | ✅ Compiles | Gradle wrapper URL | +| **LysnrAI** | 35 | ✅ Compiles | 10+ file fixes, Gson→kotlinx, deferred notification service | +| **MindLyst** | 35 | ✅ APK produced | Serializer, WavAudioRecorder, kotlin.serialization plugin | +| **AuthApp** | 35 | ✅ Scaffold | No build issues | + +### Android SDK Installed + +| Package | Version | +| -------------------- | ----------- | +| platforms;android-35 | 1 | +| platforms;android-36 | 2 (Baklava) | +| build-tools;34.0.0 | 34.0.0 | +| build-tools;35.0.0 | 35.0.0 | +| build-tools;36.0.0 | 36.0.0 | +| emulator | 36.4.10 | +| platform-tools | 36.0.2 | +| sources;android-35 | 1 | + +### iOS Builds + +| App | Swift Files | Tests | Status | +| -------------- | ----------- | ----- | ------------------------------------------ | +| **ChronoMind** | 84 | ~121 | ✅ iOS + watchOS + macOS + Widgets | +| **PeakPulse** | 92 | ~158 | ✅ iOS + watchOS + Widgets + Live Activity | +| **LysnrAI** | 65 | ~94 | ✅ iOS + Keyboard Extension | +| **JarvisJr** | 58 | ~4 | ✅ iOS + watchOS + macOS | +| **MindLyst** | 26 | — | ✅ iOS | +| **AuthApp** | 14 | — | ✅ iOS + watchOS + App Clip | + +--- + +## 5. Port Allocation + +| Port | Service | +| ---- | ------------------------------- | +| 3001 | Admin Dashboard (common-plat) | +| 3002 | User Dashboard (LysnrAI) | +| 3003 | Tracker Dashboard (common-plat) | +| 3050 | MindLyst Web | +| 3060 | ActionTrail Web | +| 4003 | platform-service | +| 4005 | extraction-service | +| 4007 | mcp-server | +| 4010 | PeakPulse backend | +| 4011 | ChronoMind backend | +| 4012 | JarvisJr backend | +| 4013 | NomGap backend | +| 4014 | MindLyst backend | +| 4015 | LysnrAI backend | +| 4016 | NoteLett backend | +| 4017 | FlowMonk backend | +| 4018 | ActionTrail backend | + +**Web dev servers** (default `npm run dev` ports, not allocated — run one at a time): + +| Port | App | +| ---- | ------------------------------------------------------------ | +| 3000 | ChronoMind, NomGap, NoteLett, JarvisJr web (default Next.js) | +| 3050 | MindLyst web | +| 3060 | ActionTrail web | + +--- + +## 6. Roadmaps Inventory + +### Completed (15) + +| Roadmap | Achievement | +| ------------------------------------------ | -------------------------------------------- | +| diagnostics_REMOTE_DIAGNOSTICS_ROADMAP.md | Phases 1-3: Server, Client SDKs, Admin UI | +| platform_COMPONENTS_ROADMAP.md | 23/25 gap items built | +| platform_BACKEND_MIGRATION.md | All 9 product backends migrated | +| platform_SERVICE_CONSOLIDATION_ROADMAP.md | 3→1 service consolidation | +| telemetry_IMPLEMENTATION_ROADMAP.md | Full client telemetry system | +| extraction_SERVICE_ROADMAP.md | Text extraction + Python sidecar | +| mobile_IOS_PLATFORM_SDK.md | Swift SDK (13 components, 5 apps) | +| mobile_ANDROID_PLATFORM_SDK.md | Kotlin SDK (13 components, 5 apps) | +| mobile_REACT_NATIVE_PLATFORM_SDK.md | TS client packages (4 built) | +| cloud_AGNOSTIC_REFACTOR_ROADMAP.md | @bytelyst/datastore abstraction | +| cloud_REFERRALS_PARTITION_KEY_MIGRATION.md | DB migration runner | +| platform_COMMON_EXTRACTION_ROADMAP.md | Shared extraction client | +| product_MARKETPLACE_MODULE_DESIGN.md | Marketplace module + purchases | +| product_PRE_LAUNCH_SIGNUP_SYSTEM.md | Waitlist + pre-launch | +| SHARED_CLIENT_PACKAGES_ROADMAP.md | 9 packages + all product migrations complete | + +### Active (Top-Level) + +| Roadmap | Priority | Status | +| ------------------------------------------ | -------- | ----------- | +| AI_DIAGNOSTIC_ASSISTANT_ROADMAP.md | MEDIUM | Not started | +| INTELLIGENT_AB_TESTING_ROADMAP.md | MEDIUM | Not started | +| PREDICTIVE_CHURN_HEALTH_SCORING_ROADMAP.md | MEDIUM | Not started | + +### Not Started (10) + +| Roadmap | Priority | +| -------------------------------------------------------- | -------- | +| platform_ACCELERATION_ROADMAP.md | HIGH | +| platform_BROADCAST_SURVEY_ROADMAP.md | MEDIUM | +| platform_AGENT_PLATFORM_GAP_ROADMAP_INDEX.md | MEDIUM | +| platform_AGENT_REGISTRY_PROMPT_VERSIONING_ROADMAP.md | MEDIUM | +| platform_AGENT_RUNTIME_ORCHESTRATION_ROADMAP.md | MEDIUM | +| platform_AI_BUDGET_COST_GOVERNANCE_ROADMAP.md | LOW | +| platform_AI_GOVERNANCE_EVALS_ROADMAP.md | LOW | +| platform_DURABLE_EVENT_BUS_AND_WORKER_RUNTIME_ROADMAP.md | MEDIUM | +| platform_ENTERPRISE_PROVISIONING_SCIM_ROADMAP.md | LOW | +| platform_HUMAN_REVIEW_APPROVAL_QUEUE_ROADMAP.md | MEDIUM | +| platform_KNOWLEDGE_RAG_SERVICE_ROADMAP.md | MEDIUM | +| platform_ORG_WORKSPACE_RBAC_ROADMAP.md | MEDIUM | +| platform_SUPPORT_CASE_MANAGEMENT_ROADMAP.md | LOW | + +--- + +## 7. What's Next — Priority Rankings + +### P0 — Immediate + +| # | Item | Repo | Effort | Impact | +| --- | ------------------------------------------ | ----------------------- | ------- | ------------------------------------ | +| 1 | **Commit + push NomGap pending changes** | learning_ai_fastgap | 30 min | Cleanup | +| 2 | **Commit + push common-plat chat history** | learning_ai_common_plat | 30 min | Cleanup | +| 3 | **Platform Acceleration Phase 1** | common-plat | 2 weeks | High | +| 4 | **kotlin-platform-sdk deferred UI files** | common-plat | 1 week | Medium — 13 files need Compose fixes | + +### P1 — Near Term (Next 2-4 Weeks) + +| # | Item | Repo | Effort | Impact | +| --- | -------------------------------------------------- | ----------- | ------- | ------ | +| 5 | Broadcast & Surveys backend | common-plat | 2 weeks | Medium | +| 6 | Agent Platform gap work (registry, runtime, evals) | common-plat | 3 weeks | High | +| 7 | iOS Keyboard extension polish | LysnrAI | 1 week | High | +| 8 | Durable Event Bus + Worker Runtime | common-plat | 2 weeks | High | + +### P2 — Medium Term (1-2 Months) + +| # | Item | Repo | Effort | Impact | +| --- | --------------------------- | ----------- | ------- | ------ | +| 9 | Knowledge/RAG service | common-plat | 2 weeks | High | +| 10 | Org/Workspace RBAC | common-plat | 2 weeks | Medium | +| 11 | Human Review/Approval Queue | common-plat | 1 week | Medium | +| 12 | A/B Testing framework | common-plat | 1 week | Medium | + +### P3 — Future + +| # | Item | Repo | Effort | Impact | +| --- | ---------------------------- | ----------- | ------- | ------ | +| 13 | AI Budget/Cost Governance | common-plat | 2 weeks | Low | +| 14 | AI Governance Evals | common-plat | 2 weeks | Low | +| 15 | Enterprise SCIM provisioning | common-plat | 2 weeks | Low | +| 16 | Support Case Management | common-plat | 1 week | Low | + +--- + +## 8. Platform Maturity Score + +``` +Platform Maturity Score: 91/100 (↑4 from 87) +├── P0 Foundational: 100% ✅ (8/8 complete) +├── P1 Operational: 100% ✅ (5/5 complete) +├── P2 Product Intel: 60% 🟡 (3/5 complete — shared clients done) +├── P3 Scale/Polish: 20% 🟡 (1/5 complete) +├── Client SDKs: 100% ✅ (Swift + Kotlin + TS — all platforms) +├── Android Builds: 100% ✅ (5/5 apps compile — NEW) +└── Product Backends: 100% ✅ (9/9 running) +``` + +--- + +## 9. Uncommitted Work Check + +```bash +for repo in learning_ai_auth_app learning_ai_clock learning_ai_common_plat learning_ai_fastgap learning_ai_flowmonk learning_ai_jarvis_jr learning_ai_local_memory_gpt learning_ai_notes learning_ai_peakpulse learning_ai_productivity_web learning_ai_smart_auth learning_ai_trails learning_multimodal_memory_agents learning_voice_ai_agent; do + echo "=== $repo ===" + cd /Users/sd9235/code/mygh/$repo 2>/dev/null && git status --short | head -5 || echo "N/A" + echo "" +done +``` + +### Current Dirty Repos (as of 2026-03-19) + +| Repo | Dirty Files | Nature | +| --------------------------- | ----------- | ---------------------------- | +| **learning_ai_common_plat** | 30 | Chat history + workflow docs | +| **learning_ai_fastgap** | 27 | Docs + config updates | +| All others | 0 | Clean | + +--- + +**Last Updated:** 2026-03-19 +**Previous Review:** 2026-03-03 +**Next Review:** 2026-03-26