Summary

Feature + UX release bundling the 22 commits merged to main since v0.1.24. Feature PRs already landed separately; this PR carries the version bump, CHANGELOG.md rename from [Unreleased] → [0.1.25], and the matching uv.lock workspace-package version sync.

Highlights

• mm status CLI (CLI: add mm status to mirror the MCP mem_status tool (no CLI equivalent today) #382) — terminal mirror of the MCP mem_status tool, closing the post-install-verification gap the README had asked users to run through an editor.
• Lazy app_lifespan (Lazy DB init: defer ~/.memtomem/memtomem.db creation until first tool call #399 phases 1–3, feat(server): lazy app_lifespan + ensure_initialized owns background loops (#399 phase 3) #411, server: relocate .server.pid to $XDG_RUNTIME_DIR so ~/.memtomem/ stays lazy #412) — MCP handshake no longer creates ~/.memtomem/memtomem.db or .server.pid. DB opens on the first tool call, and the pid file lives under $XDG_RUNTIME_DIR/memtomem/ (or $TMPDIR/memtomem-$UID/ on macOS). An idle client leaves ~/.memtomem/ untouched. Two accepted trade-offs are documented in CHANGELOG: the degraded-mode embedding-mismatch warning moves from boot stderr to the first tool call, and background schedulers start on first use instead of lifespan handshake.
• mm init back-nav + flag-precedence fixes (mm init: "b" does not work at step 3 (Memory Directory) #371, init: step_header(N, ...) hardcodes step number — preset flows show misleading positions #420, init wizard: b at _step_mcp silently re-runs _step_provider_dirs_auto instead of reaching a real prompt #421) — step headers now report the actual flow position (not a hardcoded number correct only for --advanced), "b" through silent steps reaches the previous interactive step, preset-picker "b" works, and --memory-dir wins over prompts in the default interactive path.
• MCP serverInfo.version pin (MCP serverInfo.version reports SDK version (1.27.0) instead of mm --version (0.1.23) #383) — initialize response now reports the memtomem version instead of the MCP SDK version.
• mem_embedding_reset(mode="revert_to_stored") fix (bug(server): _revert_to_stored writes to read-only AppContext properties (#399 phase 1 regression) #409) — recovery path no longer raises AttributeError on AppContext properties (regression from Lazy DB init: defer ~/.memtomem/memtomem.db creation until first tool call #399 Phase 1's property introduction).
• mm init -y extras check (mm init: -y (non-interactive) accepts provider/tokenizer choices without checking required extras #396, fix(init): -y refuses to write config for missing required extras (closes #396) #402) — refuses to write config.json when the requested provider/tokenizer extras aren't importable, with an actionable error that collapses to a memtomem[all] hint when all four are missing.
• Troubleshooting docs cleanup (docs(troubleshoot): drop misleading memtomem-server verify command #398, closes docs: uvx --from memtomem memtomem-server verify command is misleading and has hidden side effect #381) — docs/guides/getting-started.md and docs/guides/mcp-clients.md drop the misleading uvx --from memtomem memtomem-server TTY verify command in favour of side-effect-free mm --version + mem_status checks.

Plus the usual minor fixes: uninstall DB-writer liveness probe (#397), SIGTERM pid cleanup (#387), wizard openai probe (#407), install-path docs flip to memtomem[all] as primary (#395), PyPI-cache-lag --refresh hint (#393), uv tool update-shell hint (#394).

Release plan

• packages/memtomem/pyproject.toml 0.1.24 → 0.1.25
• uv.lock workspace [[package]] version updated (manual edit; uv sync --frozen confirms the lockfile still validates)
• CHANGELOG.md [Unreleased] → [0.1.25] — 2026-04-23, fresh [Unreleased] scaffold restored
• uv run ruff check packages/memtomem/src packages/memtomem/tests tools — clean
• uv run ruff format --check ... — 309 files already formatted
• uv run pytest -m "not ollama" — 2240 passed, 46 deselected
• uv run mm --version reports memtomem 0.1.25
• Merge → push test-v0.1.25 tag → TestPyPI dry-run → fresh-install verify (empty-HOME mm status smoke for the lazy-handshake invariant)
• Push v0.1.25 tag → OIDC trusted publisher uploads to PyPI → approve pypi environment
• gh release create v0.1.25 --latest with notes sourced from CHANGELOG.md [0.1.25]

🤖 Generated with Claude Code