docs: add v0.17.x release notes

- Add v0.17.0, v0.17.1, v0.17.2 to latest-releases.mdx
- Add v0.17.0 section to whats-new.mdx with API v2 migration,
  auto-format, telemetry, and CLI stability details
- Update CLAUDE.md with current version v0.17.2 and features

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: groksrc

CLAUDE.md

@@ -12,7 +12,7 @@ This is the documentation website for Basic Memory (`docs.basicmemory.com`), bui
 
 **Repository**: https://github.com/basicmachines-co/basic-memory
 **Website**: https://basicmemory.com
-**Current Version**: v0.15.0 (released October 4, 2025)
+**Current Version**: v0.17.2 (released December 29, 2025)
 
 **Key Features**:
 - 17 MCP tools for AI integration (write_note, read_note, edit_note, search_notes, build_context, etc.)
@@ -21,19 +21,15 @@ This is the documentation website for Basic Memory (`docs.basicmemory.com`), bui
 - Integrations with Claude Desktop, VS Code, Cursor, Obsidian
 - Python-based with FastAPI endpoints and comprehensive CLI
 - Real-time file synchronization
-- SQLite indexing with markdown as source of truth
-
-**v0.15.0 Major Features**:
-- Cloud authentication support (WorkOS integration)
-- Stateless MCP architecture for cloud deployment
-- Cloud sync via rclone bisync
-- Cloud mount CLI commands for local file access
-- Subscription validation for cloud billing
-- ChatGPT tools integration
-- `.gitignore` support in sync operations
-- Configurable permalink generation
-- Performance optimizations for API and database
-- Critical bug fixes for permalink collisions
+- SQLite and PostgreSQL database backends
+
+**v0.17.x Major Features**:
+- API v2 migration complete - all MCP tools use optimized v2 endpoints
+- Auto-format files on save with built-in Python formatter
+- Anonymous usage telemetry (Homebrew-style opt-out)
+- CLI stability improvements - commands no longer hang on exit
+- Cloud mode discovery for recent_activity across projects
+- PostgreSQL/Neon database support as alternative to SQLite
 
 ### Basic Memory Cloud
 
@@ -65,7 +61,7 @@ This documentation site covers both:
 1. **Basic Memory** (local-first product) - Installation, MCP tools, CLI, integrations, knowledge format
 2. **Basic Memory Cloud** (upcoming) - Cloud-specific features, authentication, sync, billing
 
-The site is currently being updated for v0.15.0 and to include cloud product documentation.
+The site documents the latest v0.17.x release and includes cloud product documentation.
 
 ## Development Commands
 
@@ -211,56 +207,13 @@ The sidebar automatically highlights the current page based on `href` matching `
 
 ## Documentation Status & Priorities
 
-### Current Branch: v0.15.0-release-docs
-
-This branch is dedicated to updating documentation for:
-1. Basic Memory v0.15.0 release (October 4, 2025)
-2. Basic Memory Cloud product (upcoming release)
-
-### Areas Requiring Updates for v0.15.0
-
-**New Features to Document**:
-- Cloud authentication and WorkOS integration
-- Cloud sync capabilities via rclone bisync
-- Cloud mount CLI commands (fast/balanced/safe profiles)
-- Subscription validation and billing integration
-- ChatGPT tools integration
-- `.gitignore` support in sync operations
-- Configurable permalink generation (`disable_permalinks` flag)
-- Stateless MCP architecture changes
-
-**CLI Reference Updates**:
-- Cloud-specific commands (`cloud mount`, `cloud sync`, etc.)
-- New MCP tools if any were added
-- Subscription validation commands
-
-**Integration Updates**:
-- Any changes to Claude Desktop integration
-- Any changes to VS Code/Cursor integrations
-- ChatGPT integration documentation (new)
-
-### Areas Requiring Cloud Product Documentation
-
-**New Pages Needed**:
-- Cloud product overview and value proposition
-- Getting started with Basic Memory Cloud
-- Authentication (WorkOS magic links)
-- Subscription and billing (Polar integration)
-- Cloud sync setup and usage
-- Cloud mount for local editing
-- Cloud vs. Local comparison
-
-**Architecture Documentation**:
-- Multi-tenant architecture overview
-- Per-tenant isolation model
-- Cloud sync architecture
-- MCP gateway and proxy routing
+Documentation is up-to-date for v0.17.x release. Cloud product documentation is complete.
 
 ### Reference Materials
 
 When documenting features:
 - **Basic Memory CHANGELOG**: `gh api repos/basicmachines-co/basic-memory/contents/CHANGELOG.md`
-- **Release Notes**: `gh release view v0.15.0 --repo basicmachines-co/basic-memory`
+- **Release Notes**: `gh release view v0.17.2 --repo basicmachines-co/basic-memory`
 - **Basic Memory README**: https://github.com/basicmachines-co/basic-memory
 - **Cloud README**: https://github.com/basicmachines-co/basic-memory-cloud
 - **Cloud CLAUDE.md**: https://github.com/basicmachines-co/basic-memory-cloud/blob/main/CLAUDE.md

src/pages/latest-releases.mdx

@@ -10,6 +10,86 @@ import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, St
 
 View the latest changes to Basic Memory on [GitHub](https://github.com/basicmachines-co/basic-memory/releases)
 
+## [v0.17.2](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.17.2) — 2025-12-29
+
+**Focus:** Cloud mode improvements and build optimizations
+
+### Bug Fixes
+
+- **Allow recent_activity discovery mode in cloud mode**
+  - Added `allow_discovery` parameter to `resolve_project_parameter()` that enables tools like `recent_activity` to work across all projects in cloud mode without requiring a project parameter
+  - Fixes workflow where users want to see activity across all projects
+
+### Infrastructure
+
+- **Build optimizations** - Release builds now run lint and typecheck only, skipping full test suite for faster releases
+
+**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.17.1...v0.17.2
+
+---
+
+## [v0.17.1](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.17.1) — 2025-12-29
+
+**Focus:** Critical fix for file watch service
+
+### Bug Fixes
+
+- **Fix watch service not starting** ([#482](https://github.com/basicmachines-co/basic-memory/pull/482))
+  - Fixed issue where `BASIC_MEMORY_ENV='test'` was being set unconditionally at import time
+  - This caused `config.is_test_env` to always return True, preventing the MCP server from starting the file watch service
+  - File sync for external changes now works correctly in production
+
+**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.17.0...v0.17.1
+
+---
+
+## [v0.17.0](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.17.0) — 2025-12-28
+
+**Focus:** API v2 migration, auto-formatting, and telemetry
+
+<Info>
+**Highlights:**
+- MCP tools now use API v2 endpoints for improved performance
+- Auto-format files on save with built-in Python formatter
+- Anonymous usage telemetry (Homebrew-style opt-out)
+- CLI commands no longer hang on exit
+</Info>
+
+### Features
+
+- **API v2 Migration - Phase 2 Complete** ([#447](https://github.com/basicmachines-co/basic-memory/pull/447))
+  - All MCP tools now use v2 endpoints for improved performance
+  - Foundation for future API enhancements
+  - Backward compatible with existing integrations
+
+- **Auto-format files on save** ([#474](https://github.com/basicmachines-co/basic-memory/pull/474))
+  - Built-in Python formatter automatically formats files when saved
+  - Consistent formatting without external tools
+  - Configurable behavior
+
+- **Anonymous usage telemetry** ([#478](https://github.com/basicmachines-co/basic-memory/pull/478))
+  - Homebrew-style opt-out telemetry to help improve the product
+  - Privacy-respecting with no personal data collected
+  - Easy to disable via environment variable
+
+### Bug Fixes
+
+- **CLI commands no longer hang on exit** ([#471](https://github.com/basicmachines-co/basic-memory/pull/471))
+  - Fixed issue where CLI commands would hang instead of cleanly exiting
+  - Improved user experience with responsive command completion
+
+- **Rclone version detection** ([#473](https://github.com/basicmachines-co/basic-memory/pull/473))
+  - Detects rclone version to check for `--create-empty-src-dirs` support
+  - Better compatibility across different rclone versions
+
+- **Null titles in ChatGPT import** ([#475](https://github.com/basicmachines-co/basic-memory/pull/475))
+  - Handles null titles gracefully during ChatGPT conversation import
+  - Prevents crashes on malformed import data
+
+**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.16.3...v0.17.0
+
+---
+
 ## [v0.16.3](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.16.3) — 2025-12-20
 
 **Focus:** PostgreSQL database backend, API v2, and critical bug fixes

src/pages/whats-new.mdx

@@ -14,6 +14,62 @@ import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, St
 
 Work with your knowledge base across multiple devices using cloud sync and storage.
 
+## v0.17.0
+
+Basic Memory v0.17.0 completes the API v2 migration, adds auto-formatting, and improves CLI stability.
+
+<Info>
+**Key improvements:**
+- All MCP tools now use API v2 endpoints for improved performance
+- Auto-format files on save with built-in Python formatter
+- CLI commands no longer hang on exit
+- Anonymous usage telemetry (Homebrew-style opt-out)
+</Info>
+
+### API v2 Migration Complete
+
+Phase 2 of the API v2 migration is complete. All MCP tools now use the new v2 endpoints, providing:
+
+- **Improved performance** - Optimized endpoints for faster responses
+- **Better scalability** - Foundation for future API enhancements
+- **Backward compatibility** - Existing integrations continue to work
+
+### Auto-Format on Save
+
+Basic Memory now includes a built-in Python formatter that automatically formats files when saved:
+
+```bash
+# Files are automatically formatted on save
+# No external tools required
+```
+
+This ensures consistent formatting across your knowledge base without needing to configure external formatters.
+
+### CLI Stability Improvements
+
+Several improvements make the CLI more reliable:
+
+- **No more hanging** - Commands exit cleanly after completion
+- **Rclone version detection** - Automatically checks for `--create-empty-src-dirs` support
+- **Better ChatGPT import** - Handles null titles gracefully
+
+### Anonymous Telemetry
+
+Basic Memory now includes opt-out anonymous telemetry (similar to Homebrew) to help improve the product:
+
+- No personal data collected
+- Privacy-respecting design
+- Easy to disable via environment variable
+
+```bash
+# Disable telemetry
+export BASIC_MEMORY_NO_TELEMETRY=1
+```
+
+See the [complete v0.17.0 changelog](/latest-releases) for full details.
+
+---
+
 ## v0.16.0
 
 Basic Memory v0.16.0 focuses on cloud sync reliability, Windows platform support, and overall system robustness.