rolodex v0.3.0
[0.3.0] - 2026-08-12
First tagged release.
Changed
mcp-tool-bodiesrelease finalization. Applied the plannedminorversion bump (0.2.1→0.3.0) for wiring the MCP tool bodies.followups-viewrelease finalization. Applied the plannedpatchversion bump (0.2.0→0.2.1) for the follow-up tracking epic.standalone-app-foundationrelease finalization. Applied the plannedminorversion bump (0.1.0→0.2.0) for the standalone-app foundation epic.
Added
- Standalone desktop app: local shell + server hosting the SQLite store directly (
npm run shell), superseding the MCP-only pre-1.0 shape as the primary way to run rolodex. - Full contact CRUD (add, view, edit, verdict, next-step) through a real UI, backed by real
Storemethods. - A pluggable
SecretsAdapter(macOS Keychain via thesecurityCLI, with an in-memory fallback) for OAuth credential storage — no environment-variable fallback, ever. - A 5-screen first-run setup wizard (welcome, database location, Google connect, secrets check, finish) with no login/logout anywhere — this app is single-user-per-instance.
- One-shot Google Contacts sync (
pull()), preserving local-only fields (verdict, angle, next step) across a sync. - Full-text search (FTS5 with a LIKE-based fallback on Node builds without the fts5 module) and interaction logging with history.
- CI (typecheck + test on push/PR).
Added (followups-view)
Store.needsFollowUp()implemented for real — the last unimplemented piece of the originalStoreinterface — surfacing contacts with an overdue next step.- A configurable follow-up window and grace period, backed by a new
settingstable, rather than hardcoded numbers — editable from a settings panel in the app.
Added (mcp-tool-bodies)
- All 5
rolodex_*MCP tools (upsert,search,followups,log_interaction,sync_google) wired to realStore/GoogleSynclogic — the last unimplemented surface in the project. An agent host (Claude Desktop, another agent) can now actually read/write the owner's rolodex through MCP, not just get placeholder text back. - A real favicon (
assets/favicon.svg, index-card motif in the paper/brass palette) and Open Graph meta tags for the shell app.
Documentation
docs/ARCHITECTURE.mdandREADME.mdrewritten to describe the standalone-app-first architecture, explicitly superseding the prior MCP-first framing.