This directory contains the primary documentation for the repository.
- Architecture Overview — high-level design and layering
- Getting Started — build, test, and run the demo
- Testing Guide — testing philosophy and commands
- Serverless Deployment Guide — deploying to per-request runtimes (Cloudflare Workers + Hyperdrive worked example, with pointers for AWS Lambda, Vercel, Deno, Bun)
- ADRs — decisions (append-only)
- Subsystems — deeper technical guides by subsystem
- Package Layering — package boundaries and import constraints
- Glossary — user-facing terminology (source of truth for naming)
- Commands — command docs and entry points
- Reference docs — conventions and patterns used across the codebase
- Codec authoring guide — class-based codecs (
CodecImpl,CodecDescriptorImpl) and column helpers - CLI Style Guide — CLI UX conventions
- Cursor Cloud Agents — how cloud agents run against this repo, where config lives, how to change it, how to debug a failed run