Kylins Mail — Documentation

Architecture & Design

Document	Description
architecture.md	System architecture overview
comparison-report.md	Comparison with Velo, Mailspring, Thunderbird
design/AI_Security_Native_Architecture.md	Canonical AI + security native full-stack plan (P0–P6)
design/Agentic_Projects_Reference.md	Open-source agentic mail reference: agentic-inbox / agenticmail / Exo / GitHub ecosystem
design/Kylins_CLI_Command_Design_Review.md	kylins-cli command design review: himalaya / fastmail-cli / mcp-email-server / thunderbird-mcp / imap-mcp-server / agentmail-mcp
design/	AI native research, memory, composer AI, competitor studies
specs/	Detailed technical specifications

Frontend

Document	Description
message-list-incremental-update.md	Design: incremental insert + in-place update for message list (flicker fix)
composer-viewer-calendar-state-report.md	Composer, viewer, calendar component status
folder-pane-enhancement-plan.md	Folder pane UI enhancement plan
message-list-loading-plan.md	Message list loading strategy

Sync Engine

Document	Description
mail-sync-engine-research.md	Research on IMAP/EAS sync approaches
attachment-caching-research.md	How Velo, Thunderbird & Mailspring store/cache attachments
sync-engine-design.md	Sync engine specification (phases, architecture)
sync-engine-phase0.md	Phase 0: baseline poll-based sync
sync-engine-phase1.md	Phase 1: mutations + offline queue
sync-engine-phase2.md	Phase 2: IDLE watcher + realtime strategy
sync-engine-phase3-eas.md	Phase 3a: EAS WBXML sync
sync-engine-phase3-gmail.md	Phase 3b: Gmail API provider
sync-engine-phase3-graph.md	Phase 3c: Microsoft Graph provider
sync-engine-phase3-imap-qresync.md	Phase 3e: IMAP QRESYNC + CONDESTORE
sync-engine-flag-move-detection.md	Bug: flag changes / message moves not detected
activesync-improvements-design.md	ActiveSync improvements design

Composer / Viewer / Calendar

Document	Description
composer-viewer-calendar-next-phases.md	Next phases for composer/viewer/calendar
composer-viewer-calendar-reference-design.md	Reference design from Velo/Mailspring/Thunderbird

Contacts & Address Book

Document	Description
contacts-addressbook-reference-design.md	Contacts and address book reference design

Account Setup

Document	Description
account-setup.md	Account setup flow design
account-setup-design.md	Account setup technical specification

Providers & Integration

Document	Description
imap-improvement-plan.md	IMAP client improvement plan
inbox-zero-graph-gmail-provider-migration.md	Gmail provider migration research

Protocols & References

Directory	Description
RFC/	IMAP RFC 9051
Exchange/	MS Exchange ActiveSync protocol PDFs