learning_ai_common_plat/CLAUDE.md

CLAUDE.md — Compact Agent Reference

Read AGENTS.md for full instructions. This file is a quick summary.

Identity

• Repo: learning_ai_common_plat — shared @bytelyst/* packages + @lysnrai/* microservices
• Consumers: LysnrAI (voice dictation), MindLyst (multimodal memory)
• Stack: TypeScript, ESM, pnpm workspace, Fastify 5, Vitest, Azure Cosmos DB

Key Commands

pnpm install && pnpm build && pnpm test   # full verify
pnpm --filter @lysnrai/platform-service dev  # run one service
pnpm --filter @bytelyst/design-tokens generate  # regen tokens

Critical Rules

• Every Cosmos doc needs productId
• Every endpoint validates with Zod
• Services re-export @bytelyst/* in src/lib/ files
• Services use self-contained Zod config (not from shared package)
• @bytelyst/* = packages, @lysnrai/* = services
• Use pnpm, never npm
• Commit format: type(scope): description

---

Cross-Repo Automation

See docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md for periodic maintenance tasks: test audits, coverage gaps, dependency checks, secret scans, typecheck sweeps.