Authoritative what-and-how reference; sufficient to re-implement the program from scratch.
- Spec index
- Commands — all commands, options, argument parsing, exit codes
- Output formats — exact output for every command and mode
- IMAP protocol — operations issued, flag handling, encoding
- Local store — account-based store, reverse digit bucketing, text indexes
- Pagination — terminal detection, pager, batch mode
- Email sync — email synchronization
- Gmail API — Gmail native API specification
- HTML rendering — HTML-to-text rendering
- Input line — interactive line editing
- Manifest cache — warm-start optimization
See the project README for installation, configuration, interactive mode, and CLI reference.
- User stories directory — 32 user stories covering all features
- Gmail-specific: US-27, US-28, US-29, US-30, US-31, US-32
- Testing — unit, functional, integration tests; coverage requirements
- Logging — log levels, rotation, IMAP traffic capture
- Gmail milestones — GML-01 through GML-24 implementation log
- ADR-0001: CLEAN Layered Architecture
- ADR-0002: RAII Memory Safety
- ADR-0003: Custom Test Framework
- ADR-0004: Binary Split — trust boundaries for email-cli-ro / email-tui / email-sync