bytelyst/learning_ai_common_plat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
e4baa2fc16
learning_ai_common_plat/docs/WORKSPACE_INVENTORY.md

6.6 KiB
Raw Blame History

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

1. Active Workspace Repositories

Repository Product / Role Primary Stack Current Scope
learning_ai_common_plat Shared platform TypeScript, Fastify, Next.js, Swift, Kotlin 36 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
learning_ai_clock ChronoMind Next.js, SwiftUI, Kotlin, Fastify Timer/focus product across web, Apple, Android, backend
learning_ai_fastgap NomGap React Native (Expo), Fastify Fasting engine, mobile UI, 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

2. Shared Platform Repo Role

learning_ai_common_plat is the shared infrastructure layer for the whole workspace.

2.1 Shared Packages

  • @bytelyst/config, @bytelyst/cosmos, @bytelyst/errors, @bytelyst/logger, @bytelyst/testing
  • @bytelyst/auth, @bytelyst/auth-client, @bytelyst/api-client, @bytelyst/platform-client, @bytelyst/react-auth
  • @bytelyst/blob, @bytelyst/blob-client, @bytelyst/datastore, @bytelyst/storage, @bytelyst/sync, @bytelyst/offline-queue
  • @bytelyst/telemetry-client, @bytelyst/diagnostics-client, @bytelyst/swift-diagnostics
  • @bytelyst/feature-flag-client, @bytelyst/feedback-client, @bytelyst/broadcast-client, @bytelyst/survey-client, @bytelyst/kill-switch-client
  • @bytelyst/design-tokens, @bytelyst/dashboard-components
  • @bytelyst/extraction, @bytelyst/llm, @bytelyst/speech
  • @bytelyst/swift-platform-sdk, @bytelyst/kotlin-platform-sdk, @bytelyst/react-native-platform-sdk

2.2 Services

Service Purpose
platform-service Product-agnostic platform APIs: auth, flags, telemetry, diagnostics, jobs, analytics, A/B testing, changelog, webhooks, marketplace, predictive analytics, and more
extraction-service LangExtract-based extraction tasks with Python sidecar
mcp-server MCP tool registry, tool execution, product/operator tools, and A2A orchestration pipelines
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 Shared Platform Dependencies
LysnrAI shared packages, platform-service, extraction-service, dashboards integration
MindLyst shared packages, extraction integration, design tokens, platform-service patterns
ChronoMind shared packages, design token flow, platform-service patterns
NomGap React Native platform SDK, shared packages, platform-service patterns
JarvisJr shared SDKs, platform-service, marketplace patterns
PeakPulse Swift platform SDK, shared platform wrappers, design/system patterns

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

6. Notes

  • This document reflects the currently active seven-repo workspace rather than the earlier three-repo migration model.
  • 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 and should be included in future inventory updates.