docs(readme)!: update documentation for v2.3 breaking changes

Update README to reflect removal of user-scoped memories and scope parameter. Simplify feature descriptions, consolidate configuration examples, and streamline API documentation by moving detailed content to wiki. Add migration guide for v2.3 breaking changes.

BREAKING CHANGE: scope parameter removed from all memory operations. All memories are now project-scoped by default. Configuration options renamed: userMemoryAnalysisInterval → userProfileAnalysisInterval, maxProjectMemories removed in favor of unified maxMemories.

Author: tickernelz

README.md

@@ -11,10 +11,9 @@ OpenCode Memory provides AI coding agents with the ability to remember and recal
 ## Key Features
 
 - **Local Vector Database**: SQLite-based storage with sqlite-vec extension
-- **Dual Memory Scopes**: Separate user-level and project-level memory contexts
+- **Project Memory System**: Persistent storage for project-specific knowledge
+- **User Profile System**: Automatic learning of preferences, patterns, and workflows
 - **Unified Timeline**: Browse memories and prompts together with linking support
-- **Prompt-Memory Linking**: Bidirectional links between prompts and generated memories
-- **User Profile System**: Structured learning with preferences, patterns, workflows, and skill assessment
 - **Web Interface**: Full-featured UI for memory management and search
 - **Auto-Capture System**: Intelligent prompt-based memory extraction
 - **Multi-Provider AI**: Support for OpenAI, Anthropic, and OpenAI-compatible APIs
@@ -52,12 +51,18 @@ bun run build
 ### Basic Usage
 
 ```typescript
-memory({ mode: "add", content: "Project uses microservices", scope: "project" })
-memory({ mode: "search", query: "architecture decisions", scope: "project" })
+// Add project memory
+memory({ mode: "add", content: "Project uses microservices architecture" })
+
+// Search memories
+memory({ mode: "search", query: "architecture decisions" })
+
+// View user profile
 memory({ mode: "profile" })
-```
 
-**Note**: User-scoped `add` is deprecated in v2.2+. Use profile system instead.
+// List recent memories
+memory({ mode: "list", limit: 10 })
+```
 
 ### Web Interface
 
@@ -71,7 +76,7 @@ Access at `http://127.0.0.1:4747` to browse memories, view prompt-memory links,
 
 ![User Profile Viewer](.github/screenshot-user-profile.png)
 
-### Configuration
+## Configuration
 
 Configuration file: `~/.config/opencode/opencode-mem.jsonc`
 
@@ -86,38 +91,48 @@ Configuration file: `~/.config/opencode/opencode-mem.jsonc`
   "memoryModel": "gpt-4",
   "memoryApiUrl": "https://api.openai.com/v1",
   "memoryApiKey": "sk-...",
-  "userMemoryAnalysisInterval": 10,
-  "userProfileMaxPreferences": 20,
-  "userProfileMaxPatterns": 15,
-  "userProfileMaxWorkflows": 10,
-  "userProfileConfidenceDecayDays": 30,
-  "userProfileChangelogRetentionCount": 5
+  "userProfileAnalysisInterval": 10,
+  "maxMemories": 10
 }
 ```
 
-## Breaking Changes (v2.2)
+See [Configuration Guide](https://github.com/tickernelz/opencode-mem/wiki/Configuration-Guide) for all options.
 
-**User-scoped memories deprecated in favor of structured user profiles:**
+## Breaking Changes (v2.3)
 
-- Removed: User-scoped `addMemory` (now returns error)
-- Changed: `memory({ mode: "profile" })` returns new structure (preferences/patterns/workflows/skillLevel)
-- Added: 5 new config options for profile management
-- New behavior: User learning creates/updates structured profile instead of individual memories
-- Migration: Existing user memories remain readable but new ones cannot be created
+**User-scoped memories completely removed:**
 
-**Migration required**: Update code using `mode: "profile"` to handle new structure.
+- **Removed**: `scope` parameter from all memory operations
+- **Removed**: `maxProjectMemories` config (use `maxMemories` instead)
+- **Renamed**: `userMemoryAnalysisInterval` → `userProfileAnalysisInterval`
+- **Renamed**: `performUserMemoryLearning()` → `performUserProfileLearning()`
+- **Changed**: All memories are now project-scoped by default
+- **Changed**: User preferences managed exclusively through automatic profile system
 
-## Breaking Changes (v2.0)
+**Migration required:**
+```jsonc
+// OLD
+{
+  "userMemoryAnalysisInterval": 10,
+  "maxMemories": 5,
+  "maxProjectMemories": 10
+}
 
-**Token-based auto-capture has been replaced with prompt-based system:**
+// NEW
+{
+  "userProfileAnalysisInterval": 10,
+  "maxMemories": 10
+}
+```
 
-- Removed: `autoCaptureTokenThreshold`, `autoCaptureMinTokens`, `autoCaptureMaxMemories`, `autoCaptureSummaryMaxLength`, `autoCaptureContextWindow`
-- Added: `memoryProvider`, `userMemoryAnalysisInterval`, `autoCaptureMaxIterations`, `autoCaptureIterationTimeout`
-- New behavior: Triggers on session idle, analyzes last uncaptured prompt
-- Automatic skip logic for non-technical conversations
-- Prompt-memory linking with cascade delete support
+Remove `scope` parameter from all `memory()` calls:
+```typescript
+// OLD
+memory({ mode: "add", content: "...", scope: "project" })
 
-**Migration required**: Remove deprecated config options and add new ones.
+// NEW
+memory({ mode: "add", content: "..." })
+```
 
 ## Documentation
 
@@ -126,88 +141,13 @@ For detailed documentation, see the [Wiki](https://github.com/tickernelz/opencod
 - [Installation Guide](https://github.com/tickernelz/opencode-mem/wiki/Installation-Guide)
 - [Quick Start](https://github.com/tickernelz/opencode-mem/wiki/Quick-Start)
 - [Configuration Guide](https://github.com/tickernelz/opencode-mem/wiki/Configuration-Guide)
-- [User Profile System](https://github.com/tickernelz/opencode-mem/wiki/User-Profile)
+- [User Profile System](https://github.com/tickernelz/opencode-mem/wiki/User-Profile-System)
 - [Memory Operations](https://github.com/tickernelz/opencode-mem/wiki/Memory-Operations)
 - [Auto-Capture System](https://github.com/tickernelz/opencode-mem/wiki/Auto-Capture-System)
 - [Web Interface](https://github.com/tickernelz/opencode-mem/wiki/Web-Interface)
-- [Embedding Models](https://github.com/tickernelz/opencode-mem/wiki/Embedding-Models)
-- [Performance Tuning](https://github.com/tickernelz/opencode-mem/wiki/Performance-Tuning)
+- [API Reference](https://github.com/tickernelz/opencode-mem/wiki/API-Reference)
 - [Troubleshooting](https://github.com/tickernelz/opencode-mem/wiki/Troubleshooting)
 
-## Features Overview
-
-### Memory Scopes
-
-- **User Scope**: Cross-project preferences, coding style, communication patterns
-- **Project Scope**: Architecture decisions, technology stack, implementation details
-
-### Auto-Capture System
-
-Automatically extracts memories from conversations:
-
-1. Triggers on session idle
-2. Analyzes last uncaptured prompt and response
-3. Links memory to source prompt
-4. Skips non-technical conversations
-
-### User Profile System
-
-Builds structured user profile from conversation history (default: every 10 prompts):
-
-- **Preferences**: Code style, communication style, tool preferences (with confidence scores)
-- **Patterns**: Recurring topics, problem domains, technical interests (with frequency tracking)
-- **Workflows**: Development sequences, habits, learning style
-- **Skill Level**: Overall and per-domain assessment
-
-Profile includes versioning, changelog, and confidence decay mechanism.
-
-### Web Interface
-
-- Unified timeline of memories and prompts
-- User profile viewer with changelog
-- Visual prompt-memory link indicators
-- Cascade delete for linked items
-- Bulk operations
-- Search and filters
-- Maintenance tools (cleanup, deduplication)
-
-## API Reference
-
-### Memory Tool
-
-```typescript
-memory({ mode: "add", content: "...", scope: "project" })
-memory({ mode: "search", query: "...", scope: "user|project" })
-memory({ mode: "list", scope: "user|project", limit: 10 })
-memory({ mode: "profile" })
-memory({ mode: "forget", memoryId: "..." })
-memory({ mode: "auto-capture-toggle" })
-memory({ mode: "auto-capture-stats" })
-memory({ mode: "capture-now" })
-```
-
-**Note**: `scope: "user"` for `add` mode is deprecated in v2.2+.
-
-### REST API
-
-**Memory & Prompt Management:**
-- `GET /api/memories?scope=project&includePrompts=true` - List memories/prompts
-- `POST /api/memories` - Create memory
-- `PUT /api/memories/:id` - Update memory
-- `DELETE /api/memories/:id?cascade=true` - Delete memory (and linked prompt)
-- `DELETE /api/prompts/:id?cascade=true` - Delete prompt (and linked memory)
-- `POST /api/search` - Vector search
-
-**User Profile:**
-- `GET /api/profile` - Get user profile
-- `GET /api/profile/changelog?limit=5` - Get profile changelog
-- `GET /api/profile/snapshot/:changelogId` - Get profile snapshot
-- `POST /api/profile/refresh` - Force profile refresh
-
-**Maintenance:**
-- `POST /api/cleanup` - Run cleanup
-- `POST /api/deduplicate` - Run deduplication
-
 ## Development
 
 ```bash

package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-mem",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "OpenCode plugin that gives coding agents persistent memory using local vector database",
   "type": "module",
   "main": "dist/plugin.js",

src/services/api-handlers.ts

@@ -505,7 +505,6 @@ export async function handleSearch(
         }
       }
     } else {
-      
       const projectShards = shardManager.getAllShards("project", "");
       const allShards = [...projectShards];
 
@@ -586,7 +585,6 @@ export async function handleStats(): Promise<
   try {
     await embeddingService.warmup();
 
-    
     const projectShards = shardManager.getAllShards("project", "");
     const allShards = [...projectShards];
 
@@ -631,7 +629,6 @@ export async function handlePinMemory(id: string): Promise<ApiResponse<void>> {
       return { success: false, error: "id is required" };
     }
 
-    
     const projectShards = shardManager.getAllShards("project", "");
     const allShards = [...projectShards];
 
@@ -658,7 +655,6 @@ export async function handleUnpinMemory(id: string): Promise<ApiResponse<void>>
       return { success: false, error: "id is required" };
     }
 
-    
     const projectShards = shardManager.getAllShards("project", "");
     const allShards = [...projectShards];