Skip to main content

Architecture Decisions

IDTitleStatus
0001-sqlite-driver-mattn-cgoSQLite driver — mattn/go-sqlite3 (cgo) with FTS5unknown
0002-vector-backendVector backend — sqlite-vec loadable extension, Go brute-force fallbackunknown
0003-dual-source-archiveDual-source archive with unified contactsunknown
0004-mcp-sdk-and-ragMCP SDK choice and RAG retrieval designunknown
0005-imessage-txt-parseriMessage source via the imessage-exporter txt formatunknown
0006-web-stack-htmxWeb stack — net/http (Go 1.22 routing) + html/template + HTMX, no SPAunknown
0007-frontend-styling-tailwind-daisyuiFrontend styling — Tailwind CSS v4 + daisyUI via the standalone CLIunknown
0008-structured-logging-charmbraceletStructured logging via charmbracelet/log as an slog.Handlerunknown
0009-config-cli-cobra-viperConfiguration & CLI — Cobra (commands) + Viper (config)unknown
0010-security-privacy-postureSecurity & privacy postureunknown
0011-contact-facts-extractionAI contact facts — incremental, cited extractionunknown
0012-slate-redesign-design-systemAdopt the "slate" design system and a dense-log transcriptunknown
0013-pure-go-sqlite-driverPure-Go SQLite driver (modernc.org/sqlite) — toolchain-free go installunknown
0014-image-transcoding-external-converterTranscode HEIC/TIFF via an optional external image converterunknown
0015-onboarding-doctor-export-syncOnboarding — doctor diagnostics + orchestrated export/syncunknown
0016-whatsapp-source-exporterWhatsApp as a third source via WhatsApp-Chat-Exporter JSONunknown
0017-desktop-shell-wailsDesktop shell via Wails v2 wrapping the embedded serverunknown
0018-device-pairing-archive-syncMulti-device via QR pairing and archive synchronizationunknown
0019-gitea-primary-github-publishingGitea-primary development with GitHub as the publishing mirrorunknown
0020-bundled-exporters-guided-setupSelf-contained desktop onboarding — bundled exporter toolchain + in-app guided setupunknown
0021-syncthing-sync-engineAdopt Syncthing as the device-sync transfer engine (supersedes ADR-0018)unknown
0022-telegram-source-delegated-exporterTelegram as a fourth source via a delegated exporter (tdl)unknown
0023-ai-editorialized-journalAI-editorialized journal — mechanical day rollups + cached LLM digestsunknown
0024-contact-merging-and-address-book-abstractionContact merging and the address-book abstractionunknown
0025-semantic-search-web-ui-and-index-observabilitySemantic search in the web UI + in-app index managementunknown
0026-msgbrowse-owned-snapshotsmsgbrowse owns its own snapshots — create, prune, restoreunknown
0027-telegram-tg-export-exporterTelegram extraction via a purpose-built tg-export exporter (supersedes ADR-0022)unknown
0028-ipip-sentiment-trait-scoringIPIP-anchored sentiment & trait scoring — the message_sentiment tableunknown
0029-unsolicited-contact-evidenceUnsolicited-contact evidence — the spam_findings layerunknown
0030-late-interaction-retrievalLate-interaction retrieval for semantic searchunknown