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
134 lines
9.8 KiB
Markdown
134 lines
9.8 KiB
Markdown
# 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-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:*` 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 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_plat` remains product-agnostic.
|
|
- `mcp-server` and `ux-lab` are active capability surfaces.
|
|
- `learning_ai_local_memory_gpt` is a standalone prototype, not part of the ByteLyst ecosystem.
|
|
- `learning_ai_productivity_web` is an internal tools site, not a consumer of platform-service.
|