# ByteLyst Workspace Inventory > **Purpose:** Workspace-level inventory for the active multi-repo ByteLyst development environment. > **Workspace Root:** `~/code/mygh/` > **Canonical Repo List:** `.windsurf/workflows/repos.txt` > **Last Updated:** 2026-03-21 --- ## 1. Active Workspace Repositories | Repository | Product / Role | Primary Stack | Current Scope | | ----------------------------------- | ------------------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | `learning_ai_common_plat` | Shared platform | TypeScript, Fastify, Next.js, Swift, Kotlin | 58 shared packages, 4 services, 3 dashboards, MCP/A2A orchestration | | `learning_voice_ai_agent` | LysnrAI | Python 3.12, Fastify, Next.js, Swift, Kotlin | Desktop app, product backend, user dashboard, mobile apps | | `learning_multimodal_memory_agents` | MindLyst | Kotlin Multiplatform, SwiftUI, Jetpack Compose, Next.js | Shared KMP core, iOS, Android, web dashboard, product backend | | `learning_ai_clock` | ChronoMind | Next.js, SwiftUI, Kotlin, Fastify | Timer/focus product across web, Apple, Android, backend | | `learning_ai_fastgap` | NomGap | React Native (Expo), Next.js, Fastify | Fasting engine, mobile UI, web app, product backend | | `learning_ai_jarvis_jr` | JarvisJr | SwiftUI, Next.js, Kotlin, Fastify | Voice-first coaching apps, marketplace/backend | | `learning_ai_peakpulse` | PeakPulse | SwiftUI, Fastify | Sensor-driven tracking app and backend | | `learning_ai_notes` | NoteLett | Fastify, Next.js, React Native (Expo) | Structured notes platform across backend, web, and mobile | | `learning_ai_flowmonk` | FlowMonk | Fastify, Next.js, React Native (Expo) | Agent-first planning platform across backend, web, and mobile | | `learning_ai_trails` | ActionTrail | Fastify, Next.js | AI activity oversight: actions, alerts, approvals, SDK | | `learning_ai_auth_app` | ByteLyst SmartAuth | SwiftUI, Jetpack Compose + docs (extends platform-service) | Unified auth & identity design (OneAuth, OAuth, MFA, Passkeys) + standalone auth companion app (iOS, Android, watchOS, widgets) | | `learning_ai_productivity_web` | Productivity Tools | Next.js | Internal productivity web tools | | `learning_ai_local_memory_gpt` | LocalMemoryGPT | Fastify 5, Next.js 16, SQLite, Ollama | Local-first AI chat with persistent memory, RAG, multi-model compare | --- ## 2. Shared Platform Repo Role `learning_ai_common_plat` is the shared infrastructure layer for the whole workspace. ### 2.1 Shared Packages (58 total) - **Core:** `config`, `cosmos`, `errors`, `logger`, `testing`, `datastore`, `storage` - **Auth:** `auth`, `auth-client`, `auth-ui`, `react-auth`, `fastify-auth` - **API/Clients:** `api-client`, `platform-client`, `broadcast-client`, `survey-client`, `feedback-client`, `marketplace-client`, `org-client`, `referral-client`, `subscription-client` - **Telemetry/Diagnostics:** `telemetry-client`, `diagnostics-client`, `swift-diagnostics` - **Feature Control:** `feature-flag-client`, `kill-switch-client` - **Storage/Data:** `blob`, `blob-client`, `sync`, `offline-queue` - **Backend Framework:** `fastify-core`, `fastify-sse`, `events`, `event-store`, `monitoring`, `push`, `queue`, `webhook-dispatch`, `backend-config`, `backend-flags`, `backend-telemetry` - **Security:** `field-encrypt` (AES-256-GCM envelope encryption, 3 key providers) - **AI/ML:** `extraction`, `llm`, `llm-router`, `speech` - **UI/UX:** `design-tokens`, `dashboard-components`, `dashboard-shell`, `celebrations`, `gentle-notifications`, `quick-actions`, `time-references`, `accessibility`, `create-app` - **Platform SDKs:** `swift-platform-sdk`, `kotlin-platform-sdk`, `react-native-platform-sdk` _(All under the `@bytelyst/` scope — consumed via `file:` or `workspace:_` refs)\* ### 2.2 Services | Service | Port | Purpose | | -------------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `platform-service` | 4003 | Product-agnostic platform APIs: auth, flags, telemetry, diagnostics, jobs, analytics, A/B testing, changelog, webhooks, marketplace, predictive analytics, orgs, SCIM, and more (63 modules, ~117 test files) | | `extraction-service` | 4005 | LangExtract-based extraction tasks with Python sidecar | | `mcp-server` | 4007 | MCP tool registry, tool execution, product/operator tools, and A2A orchestration pipelines (14 tool namespaces) | | `monitoring` | — | Loki/Grafana and health-check infrastructure | ### 2.3 Dashboards | Dashboard | Purpose | | ------------- | ----------------------------------------- | | `admin-web` | Platform admin console | | `tracker-web` | Tracker and public roadmap dashboard | | `ux-lab` | Internal UX and ops prototyping workspace | --- ## 3. Product Repos and Shared Platform Consumption | Product | Port | Shared Platform Dependencies | | ------------- | ---- | ----------------------------------------------------------------- | | LysnrAI | 4015 | 7 modules, field-encrypt, extraction-service, dashboards | | MindLyst | 4014 | 5 modules, KMP shared core, extraction integration, design tokens | | ChronoMind | 4011 | 5 modules, design token flow, platform-service patterns | | NomGap | 4013 | 7 modules, field-encrypt, React Native platform SDK | | JarvisJr | 4012 | 5 modules, field-encrypt, marketplace patterns | | PeakPulse | 4010 | 2 modules, Swift platform SDK, sensor-driven tracking | | NoteLett | 4016 | 7 modules + 8 MCP tools, field-encrypt, mobile/web | | FlowMonk | 4017 | 10 modules, offline queue, deterministic scheduler | | ActionTrail | 4018 | 13 modules, field-encrypt, SDK (@actiontrail/sdk), SSE/webhooks | | LocalMemGPT | 4019 | 8 modules, SQLite + Ollama, standalone (not platform-service) | | SmartAuth | — | Extends platform-service auth module (no separate backend) | | ByteLyst Auth | — | Consumes platform-service directly via Swift/Kotlin platform SDKs | --- ## 4. Workspace Operating Model - Common platform changes land first when shared packages or shared services change. - Product repos consume `workspace:*` or `file:` references during local development. - Repo workflows use `.windsurf/workflows/repos.txt` as the source of truth. - Backup, sync, and workspace commit workflows operate across all active repos. - MCP/A2A capabilities in `learning_ai_common_plat/services/mcp-server/` provide cross-product orchestration and operator tooling. --- ## 5. Test File Summary (by surface) | Component | Test Files | Notes | | -------------------------- | ---------- | ---------------------------------------------- | | platform-service | 117 | 63 modules, Vitest | | extraction-service | 12 | Python sidecar + TS | | mcp-server | 5 | 14 tool namespaces | | Shared packages | 63 | Vitest across 58 packages | | Dashboards (admin+tracker) | 32 | Next.js tests + E2E | | Kotlin platform SDK | 9 | JUnit5 + MockWebServer | | LysnrAI (all surfaces) | 48 | backend=14, web=17, ios=7, android=9, python | | MindLyst (all surfaces) | 25 | backend=13, ios=1, android=12 | | ChronoMind (all surfaces) | 34 | backend=7, web=18, ios=8, android=1 | | NomGap (all surfaces) | 41 | backend=11, web=12, mobile=18 | | JarvisJr (all surfaces) | 18 | backend=10, web=6, ios=1, android=1 | | PeakPulse (all surfaces) | 22 | backend=6, ios=16 | | NoteLett (all surfaces) | 32 | backend=20, web=8, mobile=4 | | FlowMonk (all surfaces) | 28 | backend=15, web=8, mobile=5 | | ActionTrail (all) | 32 | backend=17, web=12, sdk=3 | | LocalMemGPT (all) | 19 | backend=15, web=4 | | E2E (common plat) | 1 | Playwright diagnostics | | **Total test files** | **~538** | Across 14 active repos (excluding test runner) | --- ## 6. Recommended Source-of-Truth Docs | Scope | Document | | ------------------------------ | --------------------------------------------- | | Common platform repo inventory | `docs/learning_ai_common_plat_INVENTORY.md` | | Whole active workspace | `docs/WORKSPACE_INVENTORY.md` | | Agent implementation guidance | `AGENTS.md` | | High-level architecture | `docs/architecture/ECOSYSTEM_ARCHITECTURE.md` | | Canonical active repo list | `.windsurf/workflows/repos.txt` | | MCP/A2A orchestration | `docs/MCP+A2A/README.md` | | Azure resource inventory | `docs/devops/AZURE_RESOURCE_INVENTORY.md` | | Gitea runner rollout | `docs/devops/gitea-runner/README.md` | --- ## 7. Notes - This document reflects the currently active 13-repo workspace (plus `temp_uxlab` which is empty). (May 2026: `learning_ai_smart_auth` merged into `learning_ai_auth_app`.) - Product-specific backends now live in their product repositories, while `learning_ai_common_plat` remains product-agnostic. - `mcp-server` and `ux-lab` are active capability surfaces. - `learning_ai_local_memory_gpt` has been rebuilt as Fastify 5 + Next.js 16 + SQLite/Ollama (no longer Express/React). - `learning_ai_productivity_web` is an internal tools site, not a consumer of platform-service. - `learning_ai_auth_app` (SmartAuth) owns the PRD + roadmap (in `docs/`) plus the standalone authenticator app; the backend implementation of SmartAuth features lives in the platform-service auth module. (May 2026: absorbed the former `learning_ai_smart_auth` docs-only repo.) - `@bytelyst/field-encrypt` is integrated into 5 product backends (LysnrAI, JarvisJr, NoteLett, NomGap, ActionTrail).