Skip to main content

Architecture Decisions

IDTitleStatus
0001-sqlite-driver-mattn-cgo1. SQLite driver: mattn/go-sqlite3 (cgo) with FTS5unknown
0002-vector-backend2. Vector 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