b9e37bb8b4
- telemetry-client: createWebTelemetry() wraps createTelemetryClient() with web defaults - diagnostics-client: createWebDiagnostics() wraps DiagnosticsClient with install ID + web defaults - Eliminates ~70 lines of boilerplate per web app - 11/11 telemetry tests pass, 21/21 diagnostics tests pass
9.8 KiB
9.8 KiB
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.txtLast Updated: 2026-03-20
1. Active Workspace Repositories
| Repository | Product / Role | Primary Stack | Current Scope |
|---|---|---|---|
learning_ai_common_plat |
Shared platform | TypeScript, Fastify, Next.js, Swift, Kotlin | 53 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_smart_auth |
SmartAuth | Docs + extends platform-service | Unified auth & identity design (OneAuth, OAuth, MFA, Passkeys) |
learning_ai_auth_app |
ByteLyst Auth App | SwiftUI, Jetpack Compose | 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 | React, Express | Local memory-augmented GPT prototype |
2. Shared Platform Repo Role
learning_ai_common_plat is the shared infrastructure layer for the whole workspace.
2.1 Shared Packages (53 total)
- Core:
config,cosmos,errors,logger,testing,datastore,storage - Auth:
auth,auth-client,auth-ui,react-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 - 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) |
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 | shared packages, platform-service, extraction-service, dashboards integration |
| MindLyst | 4014 | shared packages, extraction integration, design tokens, platform-service patterns |
| ChronoMind | 4011 | shared packages, design token flow, platform-service patterns |
| NomGap | 4013 | React Native platform SDK, shared packages, platform-service patterns |
| JarvisJr | 4012 | shared SDKs, platform-service, marketplace patterns |
| PeakPulse | 4010 | Swift platform SDK, shared platform wrappers, design/system patterns |
| NoteLett | 4016 | shared packages, platform-service, extraction-service, mobile/web client patterns |
| FlowMonk | 4017 | shared packages, platform-service, offline queue, planning-platform patterns |
| ActionTrail | 4018 | shared packages, platform-service, SSE/webhooks, SDK (@actiontrail/sdk) |
| 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:*orfile:references during local development. - Repo workflows use
.windsurf/workflows/repos.txtas 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 Count Summary
| Component | Tests |
|---|---|
| platform-service | ~1,050+ |
| extraction-service | ~47 |
| Product backends (9) | ~1,217 |
| ActionTrail SDK | 21 |
| ActionTrail E2E | 40 |
| Kotlin platform SDK | 57 |
| NomGap mobile tests | 505 |
| ChronoMind web tests | 373 |
| Estimated total | 3,500+ |
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 |
7. Notes
- This document reflects the currently active 13-repo workspace (plus 1 prototype repo).
- Product-specific backends now live in their product repositories, while
learning_ai_common_platremains product-agnostic. mcp-serverandux-labare active capability surfaces.learning_ai_local_memory_gptis a standalone prototype, not part of the ByteLyst ecosystem.learning_ai_productivity_webis an internal tools site, not a consumer of platform-service.