bytelyst/learning_ai_common_plat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(docs): correct 10 issues in workspace review 2026-03-19

Browse Source 
- platform-service tests: ~1,027 -> 1,020 (verified)
- Product backend total: ~1,256 -> 1,217 (verified)
- ChronoMind backend: ~179 -> 176
- FlowMonk backend: ~194 -> 181
- ActionTrail backend: ~187 -> 185
- Grand total: ~4,298 -> ~4,220
- kotlin-platform-sdk: 38/39 -> 56/57 (13 deferred files restored)
- Scope: 15 repos -> 14 repos + 1 temp workspace
- SHARED_CLIENT_PACKAGES_ROADMAP moved from Active to Completed (15 total)
- P2 maturity: 40% -> 60%, Client SDKs: 98% -> 100%
- Added web dev server port table (3000/3050/3060)
- Removed ~ approximation from all verified backend test counts
This commit is contained in:
saravanakumardb1 2026-03-19 18:51:26 -07:00
parent 35487137e1
commit 6115ae5c0f
1 changed files with 474 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

474
docs/roadmaps/WORKSPACE_REVIEW_2026_03_19.md Normal file
View File

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