Architecture Decision Records

📄️ ADR-000 - Repository Topology and Subtree Vendoring

Git subtrees strategy for vendoring MCP, adapters, CLI repos.

React + Vite + TailwindCSS frontend from hackathon repo.

Separate D1 databases for sessions, courses, and adapters.

Hono routing with @hono/zod-openapi for OpenAPI generation.

Go 1.25 MCP server with official SDK and structured logging.

Rust CLI with clap for argument parsing and REPL mode.

ElevenLabs STT/TTS with server-side implementation.

Envelope encryption with KEK and DEK for user credentials.

Cloudflare Vectorize for cloud RAG, optional FAISS for local.

Lucia Auth with Workers + D1 adapter.

Polar subscriptions and Ko-fi donation links.

ULID identifiers, retention policies, transfer model.

28 tools across 4 domains with Zod schemas and pagination.

DO for real-time state, hybrid snapshots, agentic summarization.

WebSocket streaming, 16kHz audio, transcript persistence.

Envelope encryption, KEK versioning, lazy re-wrapping.

TS Workers + Cloudflare Queues + Go parser, R2 storage.

LHS→RHS rules, OR/N-of groups, BCTransferGuide integration.

Anonymous 10/day, Free 100/day, Paid 500/day, BYOK unlimited.

Docusaurus docs, pnpm, conventional commits, 1/2 approvals.