chore(release): v8.2.10

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

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

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem",
-      "version": "8.2.6",
+      "version": "8.2.10",
       "source": "./plugin",
       "description": "Persistent memory system for Claude Code - context compression across sessions"
     }

CHANGELOG.md

@@ -4,6 +4,63 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [8.2.9] - 2025-12-29
+
+## Bug Fixes
+
+- **Worker Service**: Remove file-based locking and improve Windows stability
+  - Replaced file-based locking with health-check-first approach for cleaner mutual exclusion
+  - Removed AbortSignal.timeout() calls to reduce Bun libuv assertion errors on Windows
+  - Added 500ms shutdown delays on Windows to prevent zombie ports
+  - Reduced hook timeout values for improved responsiveness
+  - Increased worker readiness polling duration from 5s to 15s
+
+## Internal Changes
+
+- Updated worker CLI scripts to reference worker-service.cjs directly
+- Simplified hook command configurations
+
+## [8.2.8] - 2025-12-29
+
+## Bug Fixes
+
+- Fixed orphaned chroma-mcp processes during shutdown (#489)
+  - Added graceful shutdown handling with signal handlers registered early in WorkerService lifecycle
+  - Ensures ChromaSync subprocess cleanup even when interrupted during initialization
+  - Removes PID file during shutdown to prevent stale process tracking
+
+## Technical Details
+
+This patch release addresses a race condition where SIGTERM/SIGINT signals arriving during ChromaSync initialization could leave orphaned chroma-mcp processes. The fix moves signal handler registration from the start() method to the constructor, ensuring cleanup handlers exist throughout the entire initialization lifecycle.
+
+**Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v8.2.7...v8.2.8
+
+## [8.2.7] - 2025-12-29
+
+## What's Changed
+
+### Token Optimizations
+- Simplified MCP server tool definitions for reduced token usage
+- Removed outdated troubleshooting and mem-search skill documentation
+- Enhanced search parameter descriptions for better clarity
+- Streamlined MCP workflows for improved efficiency
+
+This release significantly reduces the token footprint of the plugin's MCP tools and documentation.
+
+**Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v8.2.6...v8.2.7
+
+## [8.2.6] - 2025-12-29
+
+## What's Changed
+
+### Bug Fixes & Improvements
+- Session ID semantic renaming for clarity (content_session_id, memory_session_id)
+- Queue system simplification with unified processing logic
+- Memory session ID capture for agent resume functionality
+- Comprehensive test suite for session ID refactoring
+
+**Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v8.2.5...v8.2.6
+
 ## [8.2.5] - 2025-12-28
 
 ## Bug Fixes

README.md

@@ -172,35 +172,40 @@ See [Architecture Overview](https://docs.claude-mem.ai/architecture/overview) fo
 
 ---
 
-## mem-search Skill
+## MCP Search Tools
 
-Claude-Mem provides intelligent search through the mem-search skill that auto-invokes when you ask about past work:
+Claude-Mem provides intelligent memory search through **4 MCP tools** following a token-efficient **3-layer workflow pattern**:
+
+**The 3-Layer Workflow:**
+
+1. **`search`** - Get compact index with IDs (~50-100 tokens/result)
+2. **`timeline`** - Get chronological context around interesting results
+3. **`get_observations`** - Fetch full details ONLY for filtered IDs (~500-1,000 tokens/result)
 
 **How It Works:**
-- Just ask naturally: *"What did we do last session?"* or *"Did we fix this bug before?"*
-- Claude automatically invokes the mem-search skill to find relevant context
+- Claude uses MCP tools to search your memory
+- Start with `search` to get an index of results
+- Use `timeline` to see what was happening around specific observations
+- Use `get_observations` to fetch full details for relevant IDs
+- **~10x token savings** by filtering before fetching details
 
-**Available Search Operations:**
+**Available MCP Tools:**
 
-1. **Search Observations** - Full-text search across observations
-2. **Search Sessions** - Full-text search across session summaries
-3. **Search Prompts** - Search raw user requests
-4. **By Concept** - Find by concept tags (discovery, problem-solution, pattern, etc.)
-5. **By File** - Find observations referencing specific files
-6. **By Type** - Find by type (decision, bugfix, feature, refactor, discovery, change)
-7. **Recent Context** - Get recent session context for a project
-8. **Timeline** - Get unified timeline of context around a specific point in time
-9. **Timeline by Query** - Search for observations and get timeline context around best match
-10. **API Help** - Get search API documentation
+1. **`search`** - Search memory index with full-text queries, filters by type/date/project
+2. **`timeline`** - Get chronological context around a specific observation or query
+3. **`get_observations`** - Fetch full observation details by IDs (always batch multiple IDs)
+4. **`__IMPORTANT`** - Workflow documentation (always visible to Claude)
 
-**Example Natural Language Queries:**
+**Example Usage:**
 
-```
-"What bugs did we fix last session?"
-"How did we implement authentication?"
-"What changes were made to worker-service.ts?"
-"Show me recent work on this project"
-"What was happening when we added the viewer UI?"
+```typescript
+// Step 1: Search for index
+search(query="authentication bug", type="bugfix", limit=10)
+
+// Step 2: Review index, identify relevant IDs (e.g., #123, #456)
+
+// Step 3: Fetch full details
+get_observations(ids=[123, 456])
 ```
 
 See [Search Tools Guide](https://docs.claude-mem.ai/usage/search-tools) for detailed examples.

docs/public/architecture-evolution.mdx

@@ -248,6 +248,164 @@ search_observations({
 
 ---
 
+## MCP Architecture Simplification (December 2025)
+
+### The Problem: Complex MCP Implementation
+
+**Before:**
+```
+9+ MCP tools registered at session start:
+- search_observations
+- find_by_type
+- find_by_file
+- find_by_concept
+- get_recent_context
+- get_observation
+- get_session
+- get_prompt
+- help
+
+Problems:
+- Overlapping operations (search_observations vs find_by_type)
+- Complex parameter schemas (~2,500 tokens in tool definitions)
+- No built-in workflow guidance
+- High cognitive load for Claude (which tool to use?)
+- Code size: ~2,718 lines in mcp-server.ts
+```
+
+**The Insight:** Progressive disclosure should be built into tool design itself, not something Claude has to remember.
+
+### The Solution: 3-Layer Workflow
+
+**After:**
+```
+4 MCP tools following 3-layer workflow:
+
+1. __IMPORTANT - Workflow documentation (always visible)
+   "3-LAYER WORKFLOW (ALWAYS FOLLOW):
+    1. search(query) → Get index with IDs
+    2. timeline(anchor=ID) → Get context
+    3. get_observations([IDs]) → Fetch details
+    NEVER fetch full details without filtering first."
+
+2. search - Layer 1: Get index with IDs (~50-100 tokens/result)
+3. timeline - Layer 2: Get chronological context
+4. get_observations - Layer 3: Fetch full details (~500-1,000 tokens/result)
+
+Benefits:
+- Progressive disclosure enforced by tool structure
+- No overlapping operations
+- Simple schemas (additionalProperties: true)
+- Clear workflow pattern
+- Code size: ~312 lines in mcp-server.ts (88% reduction)
+- ~10x token savings
+```
+
+### Migration: Skill-Based Search Removed
+
+**Previously:** Used skill-based search
+- mem-search skill invoked via natural language
+- HTTP API called directly via curl
+- Progressive disclosure through skill loading
+- 17 skill documentation files
+
+**Now:** Removed skill-based approach
+- MCP-only architecture
+- Native MCP protocol (better Claude integration)
+- Works with both Claude Desktop and Claude Code
+- Simpler to maintain (no skill files)
+- All 19 mem-search skill files removed (~2,744 lines)
+
+### Key Architectural Changes
+
+**MCP Server Refactor:**
+
+Before:
+```typescript
+// Complex parameter schemas
+{
+  name: "search_observations",
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: { type: "string", description: "..." },
+      type: { type: "array", items: { enum: [...] } },
+      format: { enum: ["index", "full"] },
+      limit: { type: "number", minimum: 1, maximum: 100 },
+      // ... many more parameters
+    }
+  }
+}
+```
+
+After:
+```typescript
+// Simple schemas with workflow guidance
+{
+  name: "search",
+  description: "Step 1: Search memory. Returns index with IDs.",
+  inputSchema: {
+    type: "object",
+    properties: {},
+    additionalProperties: true  // Accept any parameters
+  }
+}
+```
+
+**Workflow Enforcement:**
+
+Before: Claude had to remember progressive disclosure pattern
+
+After: Tool structure makes it impossible to skip steps
+- Can't get details without IDs from search
+- Can't search without seeing __IMPORTANT reminder
+- Timeline provides middle ground (context without full details)
+
+### Impact
+
+**Token Efficiency:**
+```
+Traditional: Fetch 20 observations upfront
+→ 10,000-20,000 tokens
+→ Only 2 observations relevant (90% waste)
+
+3-Layer Workflow:
+→ search (20 results): ~1,000-2,000 tokens
+→ Review index, identify 3 relevant IDs
+→ get_observations (3 IDs): ~1,500-3,000 tokens
+→ Total: 2,500-5,000 tokens (50-75% savings)
+```
+
+**Code Simplicity:**
+- MCP server: 2,718 lines → 312 lines (88% reduction)
+- Removed: 19 skill files (~2,744 lines)
+- Net reduction: ~5,150 lines of code removed
+
+**User Experience:**
+- Same natural language interaction
+- Better token efficiency
+- Clearer architecture
+- Works identically on Claude Desktop and Claude Code
+
+### Design Philosophy
+
+**Progressive Disclosure Through Structure:**
+
+The 3-layer workflow embodies progressive disclosure at the architectural level:
+
+1. **Layer 1 (Index)** - "What exists?" - Cheap survey of options
+2. **Layer 2 (Timeline)** - "What was happening?" - Context around specific points
+3. **Layer 3 (Details)** - "Tell me everything" - Full details only when justified
+
+Each layer provides a decision point where Claude can:
+- Stop if irrelevant
+- Get more context if uncertain
+- Dive deep if confident
+
+This makes it structurally difficult to waste tokens.
+
+---
+
 ## v1-v2: The Naive Approach
 
 ### The First Attempt: Dump Everything

docs/public/architecture/search-architecture.mdx

@@ -1,448 +1,497 @@
 ---
 title: "Search Architecture"
-description: "mem-search skill with HTTP API and progressive disclosure"
+description: "MCP tools with 3-layer workflow for token-efficient memory retrieval"
 ---
 
 # Search Architecture
 
-Claude-Mem uses a skill-based search architecture that provides intelligent memory retrieval through natural language queries. This replaced the MCP-based approach in v5.4.0 with a more efficient implementation. The skill was enhanced and renamed to "mem-search" in v5.5.0 for better scope differentiation.
+Claude-mem uses an **MCP-based search architecture** that provides intelligent memory retrieval through 4 streamlined tools following a 3-layer workflow pattern.
 
 ## Overview
 
-**Architecture**: Skill-Based Search + HTTP API + Progressive Disclosure
+**Architecture**: MCP Tools → MCP Protocol → HTTP API → Worker Service
 
 **Key Components**:
-1. **mem-search Skill** (`plugin/skills/mem-search/SKILL.md`) - Auto-invoked when users ask about past work
-2. **HTTP API Endpoints** (10 routes) - Fast, efficient search operations on port 37777
-3. **Worker Service** - Express.js server with FTS5 full-text search
-4. **SQLite Database** - Persistent storage with FTS5 virtual tables
-5. **Chroma Vector DB** - Semantic search with hybrid retrieval
+1. **MCP Tools** (4 tools) - `search`, `timeline`, `get_observations`, `__IMPORTANT`
+2. **MCP Server** (`plugin/scripts/mcp-server.cjs`) - Thin wrapper over HTTP API
+3. **HTTP API Endpoints** - Fast search operations on Worker Service (port 37777)
+4. **Worker Service** - Express.js server with FTS5 full-text search
+5. **SQLite Database** - Persistent storage with FTS5 virtual tables
+6. **Chroma Vector DB** - Semantic search with hybrid retrieval
 
-**v5.5.0 Enhancement**: Renamed from "search" to "mem-search" with:
-- Effectiveness increased from 67% to 100%
-- Concrete triggers increased from 44% to 85%
-- 5+ unique identifiers for better scope differentiation
-- Comprehensive documentation (17 files, 12 operation guides)
+**Token Efficiency**: ~10x savings through 3-layer workflow pattern
 
 ## How It Works
 
-### 1. User Query (Natural Language)
+### 1. User Query
+
+Claude has access to 4 MCP tools. When searching memory, Claude follows the 3-layer workflow:
 
 ```
-User: "What bugs did we fix last session?"
+Step 1: search(query="authentication bug", type="bugfix", limit=10)
+Step 2: timeline(anchor=<observation_id>, depth_before=3, depth_after=3)
+Step 3: get_observations(ids=[123, 456, 789])
 ```
 
-### 2. Skill Invocation
+### 2. MCP Protocol
 
-Claude recognizes the intent and invokes the mem-search skill:
-- Skill frontmatter (~250 tokens) loaded at session start
-- Full skill instructions loaded on-demand when skill is invoked
-- Progressive disclosure pattern minimizes context overhead
-- "mem-search" naming provides clear scope differentiation from native memory
+MCP server receives tool call via JSON-RPC over stdio:
+
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "search",
+    "arguments": {
+      "query": "authentication bug",
+      "type": "bugfix",
+      "limit": 10
+    }
+  }
+}
+```
 
 ### 3. HTTP API Call
 
-The skill uses `curl` to call the HTTP API:
+MCP server translates to HTTP request:
 
-```bash
-curl "http://localhost:37777/api/search/observations?query=bugs&type=bugfix&limit=5"
+```typescript
+const url = `http://localhost:37777/api/search?query=authentication%20bug&type=bugfix&limit=10`;
+const response = await fetch(url);
 ```
 
-### 4. FTS5 Search
+### 4. Worker Processing
 
-Worker service queries SQLite FTS5 virtual tables:
+Worker service executes FTS5 query:
 
 ```sql
 SELECT * FROM observations_fts
 WHERE observations_fts MATCH ?
 AND type = 'bugfix'
 ORDER BY rank
-LIMIT 5
+LIMIT 10
 ```
 
-### 5. Results Formatted
+### 5. Results Returned
 
-Skill formats results and returns to Claude:
+Worker returns structured data → MCP server → Claude:
 
-```
-## Recent Bugfixes
-
-1. [bugfix] Fixed authentication token expiry
-   Date: 2025-11-08 14:23:45
-   Files: src/auth/jwt.ts
-
-2. [bugfix] Resolved database connection leak
-   Date: 2025-11-08 13:15:22
-   Files: src/services/database.ts
-```
-
-### 6. User Sees Answer
-
-Claude presents the formatted results naturally in conversation.
-
-## Architecture Change (v5.4.0)
-
-### Before: MCP-Based Search
-
-**Approach**: 9 MCP tools registered at session start
-
-**Token Cost**: ~2,500 tokens in tool definitions per session
-- Each tool's schema, parameters, descriptions loaded
-- All 9 tools available whether needed or not
-- No progressive disclosure
-
-**Example MCP Tool**:
 ```json
 {
-  "name": "search_observations",
-  "description": "Full-text search across observations...",
-  "inputSchema": {
-    "type": "object",
-    "properties": {
-      "query": { "type": "string", "description": "..." },
-      "type": { "type": "array", "items": { "enum": [...] } },
-      "format": { "enum": ["index", "full"] },
-      // ... many more parameters
+  "content": [{
+    "type": "text",
+    "text": "| ID | Time | Title | Type |\n|---|---|---|---|\n| #123 | 2:15 PM | Fixed auth token expiry | bugfix |"
+  }]
+}
+```
+
+### 6. Claude Processes Results
+
+Claude reviews the index, decides which observations are relevant, and can:
+- Use `timeline` to get context
+- Use `get_observations` to fetch full details for selected IDs
+
+## The 4 MCP Tools
+
+### `__IMPORTANT` - Workflow Documentation
+
+Always visible to Claude. Explains the 3-layer workflow pattern.
+
+**Description:**
+```
+3-LAYER WORKFLOW (ALWAYS FOLLOW):
+1. search(query) → Get index with IDs (~50-100 tokens/result)
+2. timeline(anchor=ID) → Get context around interesting results
+3. get_observations([IDs]) → Fetch full details ONLY for filtered IDs
+NEVER fetch full details without filtering first. 10x token savings.
+```
+
+**Purpose:** Ensures Claude follows token-efficient pattern
+
+### `search` - Search Memory Index
+
+**Tool Definition:**
+```typescript
+{
+  name: 'search',
+  description: 'Step 1: Search memory. Returns index with IDs. Params: query, limit, project, type, obs_type, dateStart, dateEnd, offset, orderBy',
+  inputSchema: {
+    type: 'object',
+    properties: {},
+    additionalProperties: true  // Accepts any parameters
+  }
+}
+```
+
+**HTTP Endpoint:** `GET /api/search`
+
+**Parameters:**
+- `query` - Full-text search query
+- `limit` - Maximum results (default: 20)
+- `type` - Filter by observation type
+- `project` - Filter by project name
+- `dateStart`, `dateEnd` - Date range filters
+- `offset` - Pagination offset
+- `orderBy` - Sort order
+
+**Returns:** Compact index with IDs, titles, dates, types (~50-100 tokens per result)
+
+### `timeline` - Get Chronological Context
+
+**Tool Definition:**
+```typescript
+{
+  name: 'timeline',
+  description: 'Step 2: Get context around results. Params: anchor (observation ID) OR query (finds anchor automatically), depth_before, depth_after, project',
+  inputSchema: {
+    type: 'object',
+    properties: {},
+    additionalProperties: true
+  }
+}
+```
+
+**HTTP Endpoint:** `GET /api/timeline`
+
+**Parameters:**
+- `anchor` - Observation ID to center timeline around (optional if query provided)
+- `query` - Search query to find anchor automatically (optional if anchor provided)
+- `depth_before` - Number of observations before anchor (default: 3)
+- `depth_after` - Number of observations after anchor (default: 3)
+- `project` - Filter by project name
+
+**Returns:** Chronological view showing what happened before/during/after
+
+### `get_observations` - Fetch Full Details
+
+**Tool Definition:**
+```typescript
+{
+  name: 'get_observations',
+  description: 'Step 3: Fetch full details for filtered IDs. Params: ids (array of observation IDs, required), orderBy, limit, project',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'array',
+        items: { type: 'number' },
+        description: 'Array of observation IDs to fetch (required)'
+      }
+    },
+    required: ['ids'],
+    additionalProperties: true
+  }
+}
+```
+
+**HTTP Endpoint:** `POST /api/observations/batch`
+
+**Body:**
+```json
+{
+  "ids": [123, 456, 789],
+  "orderBy": "date_desc",
+  "project": "my-app"
+}
+```
+
+**Returns:** Complete observation details (~500-1,000 tokens per observation)
+
+## MCP Server Implementation
+
+**Location:** `/Users/YOUR_USERNAME/.claude/plugins/marketplaces/thedotmack/plugin/scripts/mcp-server.cjs`
+
+**Role:** Thin wrapper that translates MCP protocol to HTTP API calls
+
+**Key Characteristics:**
+- ~312 lines of code (reduced from ~2,718 lines in old implementation)
+- No business logic - just protocol translation
+- Single source of truth: Worker HTTP API
+- Simple schemas with `additionalProperties: true`
+
+**Handler Example:**
+```typescript
+{
+  name: 'search',
+  handler: async (args: any) => {
+    const endpoint = '/api/search';
+    const searchParams = new URLSearchParams();
+
+    for (const [key, value] of Object.entries(args)) {
+      searchParams.append(key, String(value));
+    }
+
+    const url = `http://localhost:37777${endpoint}?${searchParams}`;
+    const response = await fetch(url);
+    return await response.json();
+  }
+}
+```
+
+## Worker HTTP API
+
+**Location:** `src/services/worker-service.ts`
+
+**Port:** 37777
+
+**Search Endpoints:**
+```typescript
+GET  /api/search           # Main search (used by MCP search tool)
+GET  /api/timeline         # Timeline context (used by MCP timeline tool)
+POST /api/observations/batch  # Fetch by IDs (used by MCP get_observations tool)
+GET  /api/health           # Health check
+```
+
+**Database Access:**
+- Uses `SessionSearch` service for FTS5 queries
+- Uses `SessionStore` for structured queries
+- Hybrid search with ChromaDB for semantic similarity
+
+**FTS5 Full-Text Search:**
+```typescript
+// search tool → HTTP GET → FTS5 query
+SELECT * FROM observations_fts
+WHERE observations_fts MATCH ?
+AND type = ?
+AND date >= ? AND date <= ?
+ORDER BY rank
+LIMIT ? OFFSET ?
+```
+
+## The 3-Layer Workflow Pattern
+
+### Design Philosophy
+
+The 3-layer workflow embodies **progressive disclosure** - a core principle of claude-mem's architecture.
+
+**Layer 1: Index (Search)**
+- **What:** Compact table with IDs, titles, dates, types
+- **Cost:** ~50-100 tokens per result
+- **Purpose:** Survey what exists before committing tokens
+- **Decision Point:** "Which observations are relevant?"
+
+**Layer 2: Context (Timeline)**
+- **What:** Chronological view of observations around a point
+- **Cost:** Variable based on depth
+- **Purpose:** Understand narrative arc, see what led to/from a point
+- **Decision Point:** "Do I need full details?"
+
+**Layer 3: Details (Get Observations)**
+- **What:** Complete observation data (narrative, facts, files, concepts)
+- **Cost:** ~500-1,000 tokens per observation
+- **Purpose:** Deep dive on validated, relevant observations
+- **Decision Point:** "Apply knowledge to current task"
+
+### Token Efficiency
+
+**Traditional RAG Approach:**
+```
+Fetch 20 observations upfront: 10,000-20,000 tokens
+Relevance: ~10% (only 2 observations actually useful)
+Waste: 18,000 tokens on irrelevant context
+```
+
+**3-Layer Workflow:**
+```
+Step 1: search (20 results)        ~1,000-2,000 tokens
+Step 2: Review index, filter to 3 relevant IDs
+Step 3: get_observations (3 IDs)   ~1,500-3,000 tokens
+Total: 2,500-5,000 tokens (50-75% savings)
+```
+
+**10x Savings:** By filtering at index level before fetching full details
+
+## Architecture Evolution
+
+### Before: Complex MCP Implementation
+
+**Approach:** 9 MCP tools with detailed parameter schemas
+
+**Token Cost:** ~2,500 tokens in tool definitions per session
+- `search_observations` - Full-text search
+- `find_by_type` - Filter by type
+- `find_by_file` - Filter by file
+- `find_by_concept` - Filter by concept
+- `get_recent_context` - Recent sessions
+- `get_observation` - Fetch single observation
+- `get_session` - Fetch session
+- `get_prompt` - Fetch prompt
+- `help` - API documentation
+
+**Problems:**
+- Overlapping operations (search_observations vs find_by_type)
+- Complex parameter schemas
+- No built-in workflow guidance
+- High token cost at session start
+
+**Code Size:** ~2,718 lines in mcp-server.ts
+
+### After: Streamlined MCP Implementation
+
+**Approach:** 4 MCP tools following 3-layer workflow
+
+**Token Cost:** ~312 lines of code, simplified tool definitions
+
+**Tools:**
+1. `__IMPORTANT` - Workflow guidance (always visible)
+2. `search` - Step 1 (index)
+3. `timeline` - Step 2 (context)
+4. `get_observations` - Step 3 (details)
+
+**Benefits:**
+- Progressive disclosure built into tool design
+- No overlapping operations
+- Simple schemas (`additionalProperties: true`)
+- Clear workflow pattern
+- ~10x token savings
+
+**Code Size:** ~312 lines in mcp-server.ts (88% reduction)
+
+### Key Insight
+
+**Before:** Progressive disclosure was something Claude had to remember
+
+**After:** Progressive disclosure is enforced by tool design itself
+
+The 3-layer workflow pattern makes it structurally difficult to waste tokens:
+- Can't fetch details without first getting IDs from search
+- Can't search without seeing workflow reminder (`__IMPORTANT`)
+- Timeline provides middle ground between index and full details
+
+## Configuration
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-search": {
+      "command": "node",
+      "args": [
+        "/Users/YOUR_USERNAME/.claude/plugins/marketplaces/thedotmack/plugin/scripts/mcp-server.cjs"
+      ]
     }
   }
 }
 ```
 
-### After: Skill-Based Search
+### Claude Code
 
-**Approach**: 1 mem-search skill with progressive disclosure
+MCP server is automatically configured via plugin installation. No manual setup required.
 
-**Token Cost**: ~250 tokens in skill frontmatter per session
-- Only skill description loaded at session start
-- Full instructions loaded on-demand when skill is invoked
-- HTTP API endpoints instead of MCP protocol
+**Both clients use the same MCP tools** - the architecture works identically for Claude Desktop and Claude Code.
 
-**Example Skill Frontmatter**:
-```markdown
-# Claude-Mem mem-search Skill
+## Security
 
-Access claude-mem's persistent memory through a comprehensive HTTP API.
-Search for past work, understand context, and learn from previous decisions.
+### FTS5 Injection Prevention
 
-## When to Use This Skill
+All search queries are escaped before FTS5 processing:
 
-Invoke this skill when users ask about:
-- Past work: "What did we do last session?"
-- Bug fixes: "Did we fix this before?"
-- Features: "How did we implement authentication?"
-...
-```
-
-**Token Efficiency**: Minimal frontmatter at session start with progressive disclosure
-
-## HTTP API Endpoints
-
-The worker service exposes 10 search endpoints:
-
-### Full-Text Search
-
-```
-GET /api/search/observations
-GET /api/search/sessions
-GET /api/search/prompts
-```
-
-**Parameters**:
-- `query` - FTS5 search query (required)
-- `type` - Filter by type (bugfix, feature, refactor, etc.)
-- `project` - Filter by project name
-- `limit` - Maximum results (default: 20)
-- `offset` - Pagination offset
-- `format` - Response format (index or full)
-
-**Example**:
-```bash
-curl "http://localhost:37777/api/search/observations?query=authentication&type=decision&limit=5"
-```
-
-### Filtered Search
-
-```
-GET /api/search/by-type
-GET /api/search/by-concept
-GET /api/search/by-file
-```
-
-**Parameters**:
-- `type` / `concept` / `filePath` - Filter criteria (required)
-- `project` - Filter by project
-- `limit` - Maximum results
-- `format` - Response format
-
-**Example**:
-```bash
-curl "http://localhost:37777/api/search/by-file?filePath=worker-service.ts&limit=10"
-```
-
-### Context Retrieval
-
-```
-GET /api/context/recent
-GET /api/context/timeline
-GET /api/timeline/by-query
-```
-
-**Parameters**:
-- `project` - Filter by project
-- `limit` - Number of sessions/records
-- `anchor` - Timeline anchor point (ID or timestamp)
-- `depth_before` - Records before anchor
-- `depth_after` - Records after anchor
-
-**Example**:
-```bash
-curl "http://localhost:37777/api/context/recent?project=claude-mem&limit=5"
-```
-
-### Documentation
-
-```
-GET /api/search/help
-```
-
-Returns API documentation in JSON format.
-
-## Progressive Disclosure Pattern
-
-The mem-search skill uses progressive disclosure to minimize token usage:
-
-### Layer 1: Skill Frontmatter (Session Start)
-
-**What's Loaded**: Skill description and when to use it (~250 tokens)
-
-**Purpose**: Claude can recognize when to invoke the skill
-
-**Example**:
-```markdown
-# Claude-Mem mem-search Skill
-
-Access claude-mem's persistent memory through a comprehensive HTTP API.
-
-## When to Use This Skill
-Invoke this skill when users ask about:
-- Past work: "What did we do last session?"
-- Bug fixes: "Did we fix this before?"
-...
-```
-
-### Layer 2: Full Skill Instructions (On-Demand)
-
-**What's Loaded**: Complete operation documentation (~2,500 tokens)
-
-**Purpose**: Detailed instructions for each search operation
-
-**When Loaded**: Only when Claude invokes the skill
-
-**Example Structure**:
-```
-/skills/search/
-├── SKILL.md (main frontmatter)
-├── operations/
-│   ├── observations.md (detailed instructions)
-│   ├── sessions.md
-│   ├── prompts.md
-│   ├── by-type.md
-│   ├── by-concept.md
-│   ├── by-file.md
-│   ├── recent-context.md
-│   ├── timeline.md
-│   ├── timeline-by-query.md
-│   ├── help.md
-│   ├── formatting.md
-│   └── common-workflows.md
-```
-
-### Layer 3: API Response
-
-**What's Returned**: Search results in requested format
-
-**Format Options**:
-- `index` - Titles, dates, IDs only (~50-100 tokens per result)
-- `full` - Complete details (~500-1000 tokens per result)
-
-**Progressive Usage**: Start with `index`, drill down with `full` as needed
-
-## Implementation Details
-
-### mem-search Skill Structure
-
-```
-plugin/skills/mem-search/
-├── SKILL.md                           # Main frontmatter (~250 tokens)
-├── operations/
-│   ├── observations.md                # Search observations
-│   ├── sessions.md                    # Search sessions
-│   ├── prompts.md                     # Search prompts
-│   ├── by-type.md                     # Filter by type
-│   ├── by-concept.md                  # Filter by concept
-│   ├── by-file.md                     # Filter by file
-│   ├── recent-context.md              # Get recent context
-│   ├── timeline.md                    # Timeline around point
-│   ├── timeline-by-query.md           # Search + timeline
-│   ├── help.md                        # API documentation
-│   ├── formatting.md                  # Result formatting guide
-│   └── common-workflows.md            # Usage patterns
-```
-
-### Worker Service Integration
-
-**File**: `src/services/worker-service.ts`
-
-**Search Routes**:
-```typescript
-// Full-text search
-app.get('/api/search/observations', handleSearchObservations);
-app.get('/api/search/sessions', handleSearchSessions);
-app.get('/api/search/prompts', handleSearchPrompts);
-
-// Filtered search
-app.get('/api/search/by-type', handleSearchByType);
-app.get('/api/search/by-concept', handleSearchByConcept);
-app.get('/api/search/by-file', handleSearchByFile);
-
-// Context retrieval
-app.get('/api/context/recent', handleRecentContext);
-app.get('/api/context/timeline', handleTimeline);
-app.get('/api/timeline/by-query', handleTimelineByQuery);
-
-// Documentation
-app.get('/api/search/help', handleHelp);
-```
-
-**Database Access**:
-- Uses `SessionSearch` service for FTS5 queries
-- Uses `SessionStore` for structured queries
-- Hybrid search with ChromaDB for semantic similarity
-
-### Security
-
-**FTS5 Injection Prevention** (v4.2.3):
 ```typescript
 function escapeFTS5Query(query: string): string {
   return query.replace(/"/g, '""');
 }
 ```
 
-All user-provided search queries are properly escaped to prevent SQL injection.
+**Testing:** 332 injection attack tests covering special characters, SQL keywords, quote escaping, and boolean operators.
 
-**Comprehensive Testing**: 332 injection attack tests covering:
-- Special characters
-- SQL keywords
-- Quote escaping
-- Boolean operators
+### MCP Protocol Security
 
-## Benefits
+- Stdio transport (no network exposure)
+- Local-only HTTP API (localhost:37777)
+- No authentication needed (local development only)
 
-### 1. Token Efficiency
+## Performance
 
-**Before (MCP)**:
-- Session start: All tool definitions loaded upfront
-- Every session pays this cost
-- No progressive disclosure
+**FTS5 Full-Text Search:** Sub-10ms for typical queries
 
-**After (Skill)**:
-- Session start: Minimal token cost for skill frontmatter
-- Full instructions loaded only when invoked (progressive disclosure)
-- More efficient than loading all tool definitions upfront
+**MCP Overhead:** Minimal - simple protocol translation
 
-### 2. Natural Language Interface
+**Caching:** HTTP layer allows response caching (future enhancement)
 
-**Before**: Users needed to learn MCP tool syntax
-```
-search_observations with query="authentication" and type="decision"
-```
+**Pagination:** Efficient with offset/limit
 
-**After**: Users ask naturally
-```
-"What decisions did we make about authentication?"
-```
+**Batching:** `get_observations` accepts multiple IDs in single call
 
-Claude translates to appropriate API call.
+## Benefits Over Alternative Approaches
 
-### 3. Flexibility
+### vs. Traditional RAG
 
-**HTTP API Benefits**:
-- Can be called from skills, MCP tools, or other clients
-- Easy to test with curl
-- Standard REST conventions
-- JSON responses
+**Traditional RAG:**
+- Fetches everything upfront
+- High token cost
+- Low relevance ratio
 
-**Progressive Disclosure**:
-- Loads only what's needed
-- Can add more operations without increasing base cost
-- Documentation co-located with operations
+**3-Layer MCP:**
+- Fetches only what's needed
+- ~10x token savings
+- 100% relevance (Claude chooses what to fetch)
 
-### 4. Performance
+### vs. Previous MCP Implementation (v5.x)
 
-**Fast Queries**: FTS5 full-text search under 10ms for typical queries
+**Previous (9 tools):**
+- Complex schemas
+- Overlapping operations
+- No workflow guidance
+- ~2,500 tokens in definitions
 
-**Caching**: HTTP layer allows response caching
+**Current (4 tools):**
+- Simple schemas
+- Clear workflow
+- Built-in guidance
+- ~312 lines of code
 
-**Pagination**: Efficient result pagination with offset/limit
+### vs. Skill-Based Approach (Previously)
 
-## Migration Notes
+**Skill approach:**
+- Required separate skill files
+- HTTP API called directly via curl
+- Progressive disclosure through skill loading
 
-### For Users
+**MCP approach:**
+- Native MCP protocol (better Claude integration)
+- Cleaner architecture (protocol translation layer)
+- Works with both Claude Desktop and Claude Code
+- Simpler to maintain (no skill files)
 
-**No Action Required**: The migration from MCP to skill-based search is transparent.
-
-**Same Questions Work**: Natural language queries work exactly the same way.
-
-**Invisible Change**: Users won't notice any difference except better performance.
-
-### For Developers
-
-**Renamed**: MCP server (formerly `search-server.ts`, now `src/servers/mcp-server.ts`)
-- Source file kept for reference
-- No longer built or registered
-- MCP configuration removed from `plugin/.mcp.json`
-
-**New Implementation**: Skill-based search
-- Skill files: `plugin/skills/mem-search/`
-- HTTP endpoints: `src/services/worker-service.ts` (lines 200-400)
-- Build script: `npm run build` includes skill files
-- Sync script: `npm run sync-marketplace` copies to plugin directory
+**Migration:** Skill-based search was removed in favor of streamlined MCP architecture.
 
 ## Troubleshooting
 
+### MCP Server Not Connected
+
+**Symptoms:** Tools not appearing in Claude
+
+**Solution:**
+1. Check MCP server path in configuration
+2. Verify worker service is running: `curl http://localhost:37777/api/health`
+3. Restart Claude Desktop/Code
+
 ### Worker Service Not Running
 
-If searches fail, check worker service:
+**Symptoms:** MCP tools fail with connection errors
 
+**Solution:**
 ```bash
 npm run worker:status       # Check status
 npm run worker:restart      # Restart worker
 npm run worker:logs         # View logs
 ```
 
-### HTTP Endpoints Not Responding
+### Empty Search Results
 
-Test endpoints directly:
+**Symptoms:** search() returns no results
 
-```bash
-# Health check
-curl http://localhost:37777/health
-
-# Search test
-curl "http://localhost:37777/api/search/observations?query=test&limit=1"
-```
-
-### Skill Not Invoking
-
-If Claude doesn't invoke the mem-search skill automatically:
-
-1. Check skill files exist: `ls ~/.claude/plugins/marketplaces/thedotmack/plugin/skills/mem-search/`
-2. Restart Claude Code session to reload skill definitions
-3. Try more explicit phrasing: "Search past sessions for bug fixes" or "What did we do in yesterday's session?"
-4. Ensure your question is about previous sessions (not current conversation context)
+**Troubleshooting:**
+1. Test API directly: `curl "http://localhost:37777/api/search?query=test"`
+2. Check database: `ls ~/.claude-mem/claude-mem.db`
+3. Verify observations exist: `curl "http://localhost:37777/api/health"`
 
 ## Next Steps
 
-- [Search Tools Usage](/usage/search-tools) - User guide with examples
+- [Memory Search Usage](/usage/search-tools) - User guide with examples
+- [Progressive Disclosure](/progressive-disclosure) - Philosophy behind 3-layer workflow
 - [Worker Service Architecture](/architecture/worker-service) - HTTP API details
 - [Database Schema](/architecture/database) - FTS5 tables and indexes

docs/public/progressive-disclosure.mdx

@@ -260,14 +260,12 @@ The index is useless without retrieval mechanisms:
 *Use claude-mem MCP search to access records with the given ID*
 ```
 
-**Available tools:**
-- `search_observations` - Full-text search
-- `find_by_concept` - Concept-based retrieval
-- `find_by_file` - File-based retrieval
-- `find_by_type` - Type-based retrieval
-- `get_recent_context` - Recent session summaries
+**Available MCP tools:**
+- `search` - Search memory index (Layer 1: Get IDs)
+- `timeline` - Get chronological context (Layer 2: See narrative arc)
+- `get_observations` - Fetch full details (Layer 3: Deep dive)
 
-Each tool supports `format: "index"` (default) and `format: "full"`.
+The 3-layer workflow ensures progressive disclosure: index → context → details.
 
 ---
 
@@ -318,16 +316,18 @@ Is my task related to npm? → YES
 
 ---
 
-## The Two-Tier Search Strategy
+## The Three-Layer Workflow
 
-Claude-Mem implements progressive disclosure in search results too:
+Claude-Mem implements progressive disclosure through a 3-layer workflow pattern:
 
-### Tier 1: Index Format (Default)
+### Layer 1: Search (Index)
+
+Start by searching to get a compact index with IDs:
 
 ```typescript
-search_observations({
+search({
   query: "hook timeout",
-  format: "index"  // Default
+  limit: 10
 })
 ```
 
@@ -335,23 +335,40 @@ search_observations({
 ```
 Found 3 observations matching "hook timeout":
 
-| ID | Date | Type | Title | Tokens |
-|----|------|------|-------|--------|
-| #2543 | Oct 26 | gotcha | Hook timeout: 60s too short | ~155 |
-| #2891 | Oct 25 | how-it-works | Hook timeout configuration | ~203 |
-| #2102 | Oct 20 | problem-solution | Fixed timeout in CI | ~89 |
+| ID | Date | Type | Title |
+|----|------|------|-------|
+| #2543 | Oct 26 | gotcha | Hook timeout: 60s too short |
+| #2891 | Oct 25 | how-it-works | Hook timeout configuration |
+| #2102 | Oct 20 | problem-solution | Fixed timeout in CI |
 ```
 
-**Cost:** ~100 tokens for 3 results
-**Value:** Agent can scan and decide which to fetch
+**Cost:** ~50-100 tokens per result
+**Value:** Agent can scan and decide which observations are relevant
 
-### Tier 2: Full Format (On-Demand)
+### Layer 2: Timeline (Context)
+
+Get chronological context around interesting observations:
 
 ```typescript
-search_observations({
-  query: "hook timeout",
-  format: "full",
-  limit: 1  // Fetch just the most relevant
+timeline({
+  anchor: 2543,  // Observation ID from search
+  depth_before: 3,
+  depth_after: 3
+})
+```
+
+**Returns:** Chronological view showing what happened before/during/after observation #2543
+
+**Cost:** Variable based on depth
+**Value:** Understand narrative arc and context
+
+### Layer 3: Get Observations (Details)
+
+Fetch full details only for relevant observations:
+
+```typescript
+get_observations({
+  ids: [2543, 2102]  // Selected from search results
 })
 ```
 
@@ -463,29 +480,30 @@ Here are 10 observations.
 *Use MCP search tools to fetch full observation details on-demand*
 ```
 
-### ❌ Defaulting to Full Format
+### ❌ Skipping the Index Layer
 
 **Bad:**
 ```typescript
-search_observations({
-  query: "hooks",
-  format: "full"  // Fetches everything
+// Fetching full details immediately
+get_observations({
+  ids: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]  // Guessing which are relevant
 })
 ```
 
 **Good:**
 ```typescript
-search_observations({
+// Follow the 3-layer workflow
+// Layer 1: Search for index
+search({
   query: "hooks",
-  format: "index",  // Scan first
   limit: 20
 })
 
-// Then, if needed:
-search_observations({
-  query: "hooks",
-  format: "full",
-  limit: 1  // Just the most relevant
+// Layer 2: Review index, identify 2-3 relevant IDs
+
+// Layer 3: Fetch only relevant observations
+get_observations({
+  ids: [2543, 2891]  // Just the most relevant
 })
 ```
 
@@ -595,10 +613,9 @@ SessionStart({ source: "compact" }):
 
 ```typescript
 // Use embeddings to pre-sort index by relevance
-search_observations({
+search({
   query: "authentication bug",
-  format: "index",
-  sort: "relevance"  // Based on semantic similarity
+  orderBy: "relevance"  // Based on semantic similarity (future enhancement)
 })
 ```
 

docs/public/troubleshooting.mdx

@@ -742,17 +742,17 @@ sqlite3 ~/.claude-mem/claude-mem.db "
 
 3. Test simple query:
    ```bash
-   # In Claude Code
-   search_observations with query="test"
+   # Test MCP search tool
+   search(query="test", limit=5)
    ```
 
 4. Check query syntax:
    ```bash
-   # Bad: Special characters
-   search_observations with query="[test]"
+   # Bad: Special characters may cause issues
+   search(query="[test]")
 
    # Good: Simple words
-   search_observations with query="test"
+   search(query="test")
    ```
 
 ### Token Limit Errors
@@ -761,28 +761,40 @@ sqlite3 ~/.claude-mem/claude-mem.db "
 
 **Solutions**:
 
-1. Use index format:
+1. Follow 3-layer workflow (don't skip to get_observations):
    ```bash
-   search_observations with query="..." and format="index"
+   # Start with search to get index
+   search(query="...", limit=10)
+
+   # Review IDs, then fetch only relevant ones
+   get_observations(ids=[<2-3 relevant IDs>])
    ```
 
-2. Reduce limit:
+2. Reduce limit in search:
    ```bash
-   search_observations with query="..." and limit=3
+   search(query="...", limit=3)
    ```
 
 3. Use filters to narrow results:
    ```bash
-   search_observations with query="..." and type="decision" and limit=5
+   search(query="...", type="decision", limit=5)
    ```
 
 4. Paginate results:
    ```bash
    # First page
-   search_observations with query="..." and limit=5 and offset=0
+   search(query="...", limit=5, offset=0)
 
    # Second page
-   search_observations with query="..." and limit=5 and offset=5
+   search(query="...", limit=5, offset=5)
+   ```
+
+5. Batch IDs in get_observations:
+   ```bash
+   # Always batch multiple IDs in one call
+   get_observations(ids=[123, 456, 789])
+
+   # Don't make separate calls per ID
    ```
 
 ## Performance Issues

docs/public/usage/claude-desktop.mdx

@@ -17,7 +17,7 @@ Claude Desktop can access your claude-mem memory database through the **mem-sear
 Before installing the skill, ensure:
 
 1. **claude-mem is installed** and the worker service is running
-2. **MCP server is configured** in Claude Desktop (the skill uses the `mem-search` MCP server)
+2. **MCP server is configured** in Claude Desktop (the skill uses the `mcp-search` MCP server)
 
 ### Verify Worker is Running
 
@@ -28,31 +28,9 @@ curl http://localhost:37777/api/health
 
 ## Installation
 
-### Step 1: Download the Skill
+### Step 1: Configure MCP Server
 
-Download the skill package from the repository:
-
-<Card title="mem-search.zip" icon="download" href="https://github.com/thedotmack/claude-mem/raw/main/plugin/skills/mem-search.zip">
-  Download the mem-search skill for Claude Desktop
-</Card>
-
-Or build from source:
-
-```bash
-npm run build  # Generates plugin/skills/mem-search.zip
-```
-
-### Step 2: Install in Claude Desktop
-
-1. Open **Claude Desktop**
-2. Go to **Settings** (gear icon)
-3. Navigate to **Skills**
-4. Click **Install Skill** or drag the `mem-search.zip` file
-5. Confirm installation
-
-### Step 3: Configure MCP Server
-
-The skill requires the `mem-search` MCP server. Add this to your Claude Desktop configuration:
+The skill requires the `mcp-search` MCP server. Add this to your Claude Desktop configuration:
 
 <Tabs>
   <Tab title="macOS">
@@ -61,7 +39,7 @@ The skill requires the `mem-search` MCP server. Add this to your Claude Desktop
     ```json
     {
       "mcpServers": {
-        "mem-search": {
+        "mcp-search": {
           "command": "node",
           "args": [
             "/Users/YOUR_USERNAME/.claude/plugins/marketplaces/thedotmack/plugin/scripts/mcp-server.cjs"
@@ -77,7 +55,7 @@ The skill requires the `mem-search` MCP server. Add this to your Claude Desktop
     ```json
     {
       "mcpServers": {
-        "mem-search": {
+        "mcp-search": {
           "command": "node",
           "args": [
             "C:\\Users\\YOUR_USERNAME\\.claude\\plugins\\marketplaces\\thedotmack\\plugin\\scripts\\mcp-server.cjs"
@@ -93,7 +71,7 @@ The skill requires the `mem-search` MCP server. Add this to your Claude Desktop
 Replace `YOUR_USERNAME` with your actual username. Restart Claude Desktop after editing the configuration.
 </Warning>
 
-### Step 4: Restart Claude Desktop
+### Step 2: Restart Claude Desktop
 
 Close and reopen Claude Desktop for the MCP server configuration to take effect.
 
@@ -111,19 +89,21 @@ Once installed, the skill auto-activates when you ask about past work:
 
 ## Available MCP Tools
 
-The skill provides access to these MCP tools:
+The skill provides three core MCP tools following a 3-layer workflow pattern:
 
 | Tool | Description |
 |------|-------------|
-| `search` | Unified search across observations, sessions, and prompts |
+| `search` | Search memory index. Returns compact results with IDs for filtering |
 | `timeline` | Get chronological context around a query or observation ID |
-| `get_observation` | Fetch a single observation by ID |
-| `get_observations` | Fetch multiple observations efficiently |
-| `get_session` | Fetch session summary by ID |
-| `get_prompt` | Fetch user prompt by ID |
-| `get_recent_context` | Get recent timeline items |
-| `get_context_timeline` | Get timeline around a specific observation |
-| `help` | Load detailed usage instructions |
+| `get_observations` | Fetch full observation details by ID (use after filtering with search/timeline) |
+
+### Token-Efficient Workflow
+
+1. **Search** → Get index with IDs (~50-100 tokens/result)
+2. **Timeline** → Get context around interesting results
+3. **Get Observations** → Fetch full details ONLY for filtered IDs
+
+This 3-layer approach provides ~10x token savings compared to fetching full details upfront.
 
 ## Troubleshooting
 

docs/public/usage/search-tools.mdx

@@ -1,403 +1,454 @@
 ---
-title: "mem-search Skill"
-description: "Query your project history with natural language"
+title: "Memory Search"
+description: "Search your project history with MCP tools"
 ---
 
-# mem-search Skill Usage
+# Memory Search with MCP Tools
 
-Once claude-mem is installed as a plugin, you can search your project history using natural language. Claude automatically invokes the mem-search skill when you ask about past work.
+Claude-mem provides persistent memory across sessions through **4 MCP tools** that follow a token-efficient **3-layer workflow pattern**.
 
-## How It Works
+## Overview
 
-**v5.5.0 Enhancement**: The search skill was renamed to "mem-search" for better scope differentiation, with effectiveness increased from 67% to 100% and enhanced concrete triggers (85% vs 44%).
+Instead of fetching all historical data upfront (expensive), claude-mem uses a progressive disclosure approach:
 
-**v5.4.0 Architecture**: Claude-Mem uses a skill-based search architecture instead of MCP tools, saving ~2,250 tokens per session start through progressive disclosure.
+1. **Search** → Get a compact index with IDs (~50-100 tokens/result)
+2. **Timeline** → Get context around interesting results
+3. **Get Observations** → Fetch full details ONLY for filtered IDs
 
-**Simple Usage:**
-- Just ask naturally: *"What did we do last session?"*
-- Claude recognizes the intent and invokes the mem-search skill
-- The skill uses HTTP API endpoints to query your memory
-- Results are formatted and presented to you
+This achieves **~10x token savings** compared to traditional RAG approaches.
 
-**Benefits:**
-- **Token Efficient**: ~250 tokens (skill frontmatter) vs ~2,500 tokens (MCP tool definitions)
-- **Natural Language**: No need to learn specific tool syntax
-- **Progressive Disclosure**: Only loads detailed instructions when needed
-- **Auto-Invoked**: Claude knows when to search based on your questions
-- **Scope Differentiation**: "mem-search" clearly distinguishes from native conversation memory
+## The 3-Layer Workflow
 
-## Quick Reference
+### Layer 1: Search (Index)
 
-| Operation               | Purpose                                      |
-|-------------------------|----------------------------------------------|
-| Search Observations     | Full-text search across observations         |
-| Search Sessions         | Full-text search across session summaries    |
-| Search Prompts          | Full-text search across raw user prompts     |
-| By Concept              | Find observations tagged with concepts       |
-| By File                 | Find observations referencing files          |
-| By Type                 | Find observations by type                    |
-| Recent Context          | Get recent session context                   |
-| Timeline                | Get unified timeline around a specific point |
-| Timeline by Query       | Search and get timeline context in one step  |
-| API Help                | Get search API documentation                 |
-
-## Example Queries
-
-### Natural Language Queries
-
-**Search Observations:**
-```
-"What bugs did we fix related to authentication?"
-"Show me all decisions about the build system"
-"Find refactoring work on the database"
-```
-
-**Search Sessions:**
-```
-"What did we learn about hooks?"
-"What was accomplished in the API implementation?"
-"Show me recent work on this project"
-```
-
-**Search Prompts:**
-```
-"When did I ask about authentication features?"
-"Find all my requests about dark mode"
-```
-
-**Note**: Claude automatically translates your natural language queries into the appropriate search operations.
-
-### Search by File
+Start by searching to get a lightweight index of results:
 
 ```
-"Show me everything related to worker-service.ts"
-"What changes were made to migrations.ts?"
-"Find all work on the database file"
+search(query="authentication bug", type="bugfix", limit=10)
 ```
 
-### Search by Concept
+**Returns:** Compact table with IDs, titles, dates, types
+**Cost:** ~50-100 tokens per result
+**Purpose:** Survey what exists before fetching details
+
+### Layer 2: Timeline (Context)
+
+Get chronological context around specific observations:
 
 ```
-"Show observations tagged with architecture"
-"Find all security-related observations"
-"What patterns have we used?"
+timeline(anchor=<observation_id>, depth_before=3, depth_after=3)
 ```
 
-### Search by Type
+Or search and get timeline in one step:
 
 ```
-"Find all feature implementations"
-"Show me all decisions and discoveries"
-"What bugs have we fixed?"
+timeline(query="authentication", depth_before=2, depth_after=2)
 ```
 
-### Recent Context
+**Returns:** Chronological view showing what was happening before/after
+**Cost:** Variable, depends on depth
+**Purpose:** Understand narrative arc and context
+
+### Layer 3: Get Observations (Details)
+
+Fetch full details only for relevant observations:
 
 ```
-"Show me what we've been working on"
-"Get context from the last 5 sessions"
-"What happened recently on this project?"
+get_observations(ids=[123, 456, 789])
 ```
 
-### Timeline Queries
+**Returns:** Complete observation details (narrative, facts, files, concepts)
+**Cost:** ~500-1000 tokens per observation
+**Purpose:** Deep dive on specific, validated items
 
-**Get timeline around a specific point:**
+### Why This Works
+
+**Traditional Approach:**
+- Fetch everything upfront: 20,000 tokens
+- Relevance: ~10% (2,000 tokens actually useful)
+- Waste: 18,000 tokens on irrelevant context
+
+**3-Layer Approach:**
+- Search index: 1,000 tokens (10 results)
+- Timeline context: 500 tokens (around 2 key results)
+- Fetch details: 1,500 tokens (3 observations)
+- **Total: 3,000 tokens, 100% relevant**
+
+## Available Tools
+
+### `__IMPORTANT` - Workflow Documentation
+
+Always visible reminder of the 3-layer workflow pattern. Helps Claude understand how to use the search tools efficiently.
+
+**Usage:** Automatically shown, no need to invoke
+
+### `search` - Search Memory Index
+
+Search your memory and get a compact index with IDs.
+
+**Parameters:**
+- `query` - Full-text search query (supports AND, OR, NOT, phrase searches)
+- `limit` - Maximum results (default: 20)
+- `offset` - Skip first N results for pagination
+- `type` - Filter by observation type (bugfix, feature, decision, discovery, refactor, change)
+- `obs_type` - Filter by record type (observation, session, prompt)
+- `project` - Filter by project name
+- `dateStart` - Filter by start date (YYYY-MM-DD)
+- `dateEnd` - Filter by end date (YYYY-MM-DD)
+- `orderBy` - Sort order (date_desc, date_asc, relevance)
+
+**Returns:** Compact index table with IDs, titles, dates, types
+
+**Example:**
 ```
-"What was happening when we implemented authentication?"
-"Show me the context around that bug fix"
-"What led to the decision to refactor the database?"
+search(query="database migration", type="bugfix", limit=5, orderBy="date_desc")
 ```
 
-**Timeline by query:**
+### `timeline` - Get Chronological Context
+
+Get a chronological view of observations around a specific point or query.
+
+**Parameters:**
+- `anchor` - Observation ID to center timeline around (optional if query provided)
+- `query` - Search query to find anchor automatically (optional if anchor provided)
+- `depth_before` - Number of observations before anchor (default: 3)
+- `depth_after` - Number of observations after anchor (default: 3)
+- `project` - Filter by project name
+
+**Returns:** Chronological list showing what happened before/during/after
+
+**Example:**
 ```
-"Find when we added the viewer UI and show what happened around that time"
-"Search for authentication work and show the timeline"
+timeline(anchor=12345, depth_before=5, depth_after=5)
 ```
 
-**Benefits:**
-- See the complete narrative arc around key events
-- All record types (observations, sessions, prompts) in chronological view
-- Understand what was happening before and after important changes
-
-## Search Strategy
-
-The mem-search skill uses a progressive disclosure pattern to efficiently retrieve information:
-
-### 1. Ask Naturally
-
-Start with a natural language question:
+Or search-based:
 ```
-"What bugs did we fix related to authentication?"
+timeline(query="implemented JWT auth", depth_before=3, depth_after=3)
 ```
 
-### 2. Claude Invokes mem-search Skill
+### `get_observations` - Fetch Full Details
 
-Claude recognizes your intent and loads the mem-search skill (~250 tokens for skill frontmatter).
+Fetch complete observation details by IDs. **Always batch multiple IDs in a single call for efficiency.**
 
-### 3. Skill Uses HTTP API
+**Parameters:**
+- `ids` - Array of observation IDs (required)
+- `orderBy` - Sort order (date_desc, date_asc)
+- `limit` - Maximum observations to return
+- `project` - Filter by project name
 
-The skill calls the appropriate HTTP endpoint (e.g., `/api/search/observations`) with the query.
+**Returns:** Complete observation details including narrative, facts, files, concepts
 
-### 4. Results Formatted
-
-Results are formatted and presented to you, usually starting with an index/summary format.
-
-### 5. Deep Dive if Needed
-
-If you need more details, ask follow-up questions:
+**Example:**
 ```
-"Tell me more about observation #123"
-"Show me the full details of that decision"
+get_observations(ids=[123, 456, 789, 1011])
 ```
 
-**Benefits of This Approach:**
-- **Token Efficient**: Only loads what you need, when you need it
-- **Natural**: No syntax to learn
-- **Progressive**: Start with overview, drill down as needed
-- **Automatic**: Claude handles the search invocation
+**Important:** Always batch IDs instead of making separate calls per observation.
+
+## Common Use Cases
+
+### Debugging Issues
+
+**Scenario:** Find what went wrong with database connections
+
+```
+Step 1: search(query="error database connection", type="bugfix", limit=10)
+  → Review index, identify observations #245, #312, #489
+
+Step 2: timeline(anchor=312, depth_before=3, depth_after=3)
+  → See what was happening around the fix
+
+Step 3: get_observations(ids=[312, 489])
+  → Get full details on relevant fixes
+```
+
+### Understanding Decisions
+
+**Scenario:** Review architectural choices about authentication
+
+```
+Step 1: search(query="authentication", type="decision", limit=5)
+  → Find decision observations
+
+Step 2: get_observations(ids=[<relevant_ids>])
+  → Get full decision rationale, trade-offs, facts
+```
+
+### Code Archaeology
+
+**Scenario:** Find when a specific file was modified
+
+```
+Step 1: search(query="worker-service.ts", limit=20)
+  → Get all observations mentioning that file
+
+Step 2: timeline(query="worker-service.ts refactor", depth_before=2, depth_after=2)
+  → See what led to and followed from the refactor
+
+Step 3: get_observations(ids=[<specific_observation_ids>])
+  → Get implementation details
+```
+
+### Feature History
+
+**Scenario:** Track how a feature evolved
+
+```
+Step 1: search(query="dark mode", type="feature", orderBy="date_asc")
+  → Chronological view of feature work
+
+Step 2: timeline(anchor=<first_observation_id>, depth_after=10)
+  → See the full development timeline
+
+Step 3: get_observations(ids=[<key_milestones>])
+  → Deep dive on critical implementation points
+```
+
+### Learning from Past Work
+
+**Scenario:** Review refactoring patterns
+
+```
+Step 1: search(type="refactor", limit=10, orderBy="date_desc")
+  → Recent refactoring work
+
+Step 2: get_observations(ids=[<interesting_ids>])
+  → Study the patterns and approaches used
+```
+
+### Context Recovery
+
+**Scenario:** Restore context after time away from project
+
+```
+Step 1: search(query="project-name", limit=10, orderBy="date_desc")
+  → See recent work
+
+Step 2: timeline(anchor=<most_recent_id>, depth_before=10)
+  → Understand what led to current state
+
+Step 3: get_observations(ids=[<critical_observations>])
+  → Refresh memory on key decisions
+```
+
+## Search Query Syntax
+
+The `query` parameter supports SQLite FTS5 full-text search syntax:
+
+### Boolean Operators
+
+```
+query="authentication AND JWT"           # Both terms must appear
+query="OAuth OR JWT"                      # Either term can appear
+query="security NOT deprecated"           # Exclude deprecated items
+```
+
+### Phrase Searches
+
+```
+query='"database migration"'             # Exact phrase match
+```
+
+### Column-Specific Searches
+
+```
+query="title:authentication"             # Search in title only
+query="content:database"                  # Search in content only
+query="concepts:security"                 # Search in concepts only
+```
+
+### Combining Operators
+
+```
+query='"user auth" AND (JWT OR session) NOT deprecated'
+```
+
+## Token Management
+
+### Token Efficiency Best Practices
+
+1. **Always start with search** - Get index first (~50-100 tokens/result)
+2. **Use small limits** - Start with 3-5 results, increase if needed
+3. **Filter before fetching** - Use type, date, project filters
+4. **Batch get_observations** - Always group multiple IDs in one call
+5. **Use timeline strategically** - Get context only when narrative matters
+
+### Token Cost Estimates
+
+| Operation | Tokens per Result |
+|-----------|-------------------|
+| search (index) | 50-100 |
+| timeline (per observation) | 100-200 |
+| get_observations (full details) | 500-1,000 |
+
+**Example Comparison:**
+
+**Inefficient:**
+```
+# Fetching 20 full observations upfront: 10,000-20,000 tokens
+get_observations(ids=[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20])
+```
+
+**Efficient:**
+```
+# Search index: ~1,000 tokens
+search(query="bug fix", limit=20)
+
+# Review IDs, identify 3 relevant observations
+
+# Fetch only relevant: ~1,500-3,000 tokens
+get_observations(ids=[5, 12, 18])
+
+# Total: 2,500-4,000 tokens (vs 10,000-20,000)
+```
 
 ## Advanced Filtering
 
-You can refine searches using natural language filters:
-
 ### Date Ranges
 
 ```
-"What bugs did we fix in October?"
-"Show me work from last week"
-"Find decisions made between October 1-31"
+search(
+  query="performance optimization",
+  dateStart="2025-10-01",
+  dateEnd="2025-10-31"
+)
 ```
 
 ### Multiple Types
 
-```
-"Show me all decisions and features"
-"Find bugfixes and refactorings"
-```
-
-### Concepts
+For observations of multiple types, make multiple searches or use broader query:
 
 ```
-"Find database work related to architecture and performance"
-"Show security observations"
+search(query="database", type="bugfix", limit=10)
+search(query="database", type="feature", limit=10)
 ```
 
-### File-Specific
+### Project-Specific
 
 ```
-"Show refactoring work that touched worker-service.ts"
-"Find changes to auth files"
+search(query="API", project="my-app", limit=15)
 ```
 
-### Project Filtering
+### Pagination
 
 ```
-"Show authentication work on my-app project"
-"What have we done on this codebase?"
+# First page
+search(query="refactor", limit=10, offset=0)
+
+# Second page
+search(query="refactor", limit=10, offset=10)
+
+# Third page
+search(query="refactor", limit=10, offset=20)
 ```
 
-**Note**: Claude translates your natural language into the appropriate API filters automatically.
-
-## Under the Hood: HTTP API
-
-The mem-search skill uses HTTP endpoints on the worker service (port 37777):
-
-- `GET /api/search/observations` - Full-text search observations
-- `GET /api/search/sessions` - Full-text search session summaries
-- `GET /api/search/prompts` - Full-text search user prompts
-- `GET /api/search/by-concept` - Find observations by concept tag
-- `GET /api/search/by-file` - Find work related to specific files
-- `GET /api/search/by-type` - Find observations by type
-- `GET /api/context/recent` - Get recent session context
-- `GET /api/context/timeline` - Get timeline around specific point
-- `GET /api/timeline/by-query` - Search + timeline in one call
-- `GET /api/search/help` - API documentation
-
-These endpoints use FTS5 full-text search with support for:
-- Boolean operators (AND, OR, NOT)
-- Phrase searches
-- Column-specific searches
-- Date range filtering
-- Project filtering
-
 ## Result Metadata
 
-All results include rich metadata:
+All observations include rich metadata:
 
-```
-## JWT authentication decision
-
-**Type**: decision
-**Date**: 2025-10-21 14:23:45
-**Concepts**: authentication, security, architecture
-**Files Read**: src/auth/middleware.ts, src/utils/jwt.ts
-**Files Modified**: src/auth/jwt-strategy.ts
-
-**Narrative**:
-Decided to implement JWT-based authentication instead of session-based
-authentication for better scalability and stateless design...
-
-**Facts**:
-• JWT tokens expire after 1 hour
-• Refresh tokens stored in httpOnly cookies
-• Token signing uses RS256 algorithm
-• Public keys rotated every 30 days
-```
-
-## Citations
-
-All search results include observation IDs that can be accessed via the HTTP API:
-
-- `http://localhost:37777/api/observation/{id}` - Get specific observation by ID
-- View all observations in the web viewer at `http://localhost:37777`
-
-These citations enable referencing specific historical context in your work.
-
-## Token Management
-
-### Token Efficiency Tips
-
-1. **Start with index format**: ~50-100 tokens per result
-2. **Use small limits**: Start with 3-5 results
-3. **Apply filters**: Narrow results before searching
-4. **Paginate**: Use offset to browse results in batches
-
-### Token Estimates
-
-| Format | Tokens per Result |
-|--------|-------------------|
-| Index  | 50-100            |
-| Full   | 500-1000          |
-
-**Example**:
-- 20 results in index format: ~1,000-2,000 tokens
-- 20 results in full format: ~10,000-20,000 tokens
-
-## Common Use Cases
-
-### 1. Debugging Issues
-
-Find what went wrong:
-```
-search_observations with query="error database connection" and type="bugfix"
-```
-
-### 2. Understanding Decisions
-
-Review architectural choices:
-```
-find_by_type with type="decision" and format="index"
-```
-
-Then deep dive on specific decisions:
-```
-search_observations with query="[DECISION TITLE]" and format="full"
-```
-
-### 3. Code Archaeology
-
-Find when a file was modified:
-```
-find_by_file with filePath="worker-service.ts"
-```
-
-### 4. Feature History
-
-Track feature development:
-```
-search_sessions with query="authentication feature"
-search_user_prompts with query="add authentication"
-```
-
-### 5. Learning from Past Work
-
-Review refactoring patterns:
-```
-find_by_type with type="refactor" and limit=10
-```
-
-### 6. Context Recovery
-
-Restore context after time away:
-```
-get_recent_context with limit=5
-search_sessions with query="[YOUR PROJECT NAME]" and orderBy="date_desc"
-```
-
-## Best Practices
-
-1. **Index first, full later**: Always start with index format
-2. **Small limits**: Start with 3-5 results to avoid token limits
-3. **Use filters**: Narrow results before searching
-4. **Specific queries**: More specific = better results
-5. **Review citations**: Use citations to reference past decisions
-6. **Date filtering**: Use date ranges for time-based searches
-7. **Type filtering**: Use types to categorize searches
-8. **Concept tags**: Use concepts for thematic searches
+- **ID** - Unique observation identifier
+- **Type** - bugfix, feature, decision, discovery, refactor, change
+- **Date** - When the work occurred
+- **Title** - Concise description
+- **Concepts** - Tagged themes (e.g., security, performance, architecture)
+- **Files Read** - Files examined during work
+- **Files Modified** - Files changed during work
+- **Narrative** - Story of what happened and why
+- **Facts** - Key factual points (decisions made, patterns used, metrics)
 
 ## Troubleshooting
 
 ### No Results Found
 
-1. Check database has data:
+1. **Broaden your search:**
+   ```
+   # Too specific
+   search(query="JWT authentication implementation with RS256")
+
+   # Better
+   search(query="authentication")
+   ```
+
+2. **Check database has data:**
    ```bash
-   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
+   curl "http://localhost:37777/api/search?query=test"
    ```
 
-2. Try broader natural language query:
+3. **Try without filters:**
    ```
-   "Show me anything about authentication"  # Broader
-   vs
-   "Find exact JWT authentication implementation"  # Too specific
+   # Remove type/date filters to see if data exists
+   search(query="your-search-term")
    ```
 
-3. Ask without filters first:
-   ```
-   "What do we have about auth?"
-   # Then narrow down
-   "Show me auth-related decisions"
-   ```
+### IDs Not Found in get_observations
 
-### Worker Service Not Running
+**Error:** "Observation IDs not found: [123, 456]"
 
-If search isn't working, check the worker service:
+**Causes:**
+- IDs from different project (use `project` parameter)
+- IDs were deleted
+- Typo in ID numbers
 
-```bash
-npm run worker:status       # Check worker status
-npm run worker:restart      # Restart if needed
-npm run worker:logs         # View logs
+**Solution:**
+```
+# Verify IDs exist
+search(query="<related-search>")
+
+# Use correct project filter
+get_observations(ids=[123, 456], project="correct-project-name")
 ```
 
-Or describe the issue to Claude and the troubleshoot skill will automatically activate to provide diagnosis.
+### Token Limit Errors
 
-### Performance Issues
+**Error:** Response exceeds token limits
+
+**Solution:** Use the 3-layer workflow to reduce upfront costs:
+
+```
+# Instead of fetching 50 full observations:
+# get_observations(ids=[1,2,3,...,50])  # 25,000-50,000 tokens!
+
+# Do this:
+search(query="<your-query>", limit=50)  # ~2,500-5,000 tokens
+# Review index, identify 5 relevant observations
+get_observations(ids=[<5-most-relevant>])  # ~2,500-5,000 tokens
+# Total: 5,000-10,000 tokens (50-80% savings)
+```
+
+### Search Performance
 
 If searches seem slow:
-1. Be more specific in your queries
-2. Ask for recent work (naturally filters by date)
-3. Specify the project you're interested in
-4. Ask for fewer results initially
+1. Be more specific in queries (helps FTS5 index)
+2. Use date range filters to narrow scope
+3. Specify project filter when possible
+4. Use smaller limit values
+
+## Best Practices
+
+1. **Index First, Details Later** - Always start with search to survey options
+2. **Filter Before Fetching** - Use search parameters to narrow results
+3. **Batch ID Fetches** - Group multiple IDs in one get_observations call
+4. **Use Timeline for Context** - When narrative matters, timeline shows the story
+5. **Specific Queries** - More specific = better relevance
+6. **Small Limits Initially** - Start with 3-5 results, expand if needed
+7. **Review Before Deep Dive** - Check index before fetching full details
 
 ## Technical Details
 
-**Architecture Change (v5.4.0)**:
-- **Before**: 9 MCP tools (~2,500 tokens in tool definitions per session start)
-- **After**: 1 mem-search skill (~250 tokens in frontmatter, full instructions loaded on-demand)
-- **Savings**: ~2,250 tokens per session start
-- **Migration**: Transparent - users don't need to change how they ask questions
+**Architecture:** MCP tools are a thin wrapper over the Worker HTTP API (localhost:37777). The MCP server translates tool calls into HTTP requests to the worker service, which handles all business logic, database queries, and Chroma vector search.
 
-**v5.5.0 Enhancement**: Renamed from "search" to "mem-search" with improved effectiveness (67% → 100%) and enhanced triggers (44% → 85%).
+**MCP Server:** Located at `~/.claude/plugins/marketplaces/thedotmack/plugin/scripts/mcp-server.cjs`
 
-**How the Skill Works:**
-1. User asks a question about past work
-2. Claude recognizes the intent matches the mem-search skill description
-3. Skill loads full instructions from `plugin/skills/mem-search/SKILL.md`
-4. Skill uses `curl` to call HTTP API endpoints
-5. Results formatted and returned to Claude
-6. Claude presents results to user
+**Worker Service:** Express API on port 37777, managed by Bun
+
+**Database:** SQLite FTS5 full-text search on `~/.claude-mem/claude-mem.db`
+
+**Vector Search:** Chroma embeddings for semantic search (underlying implementation)
 
 ## Next Steps
 
+- [Progressive Disclosure](/progressive-disclosure) - Philosophy behind 3-layer workflow
 - [Architecture Overview](/architecture/overview) - System components
-- [Database Schema](/architecture/database) - Understanding the data
-- [Getting Started](/usage/getting-started) - Automatic operation
+- [Database Schema](/architecture/database) - Understanding the data structure
+- [Claude Desktop Setup](/usage/claude-desktop) - Installation and configuration

package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "8.2.6",
+  "version": "8.2.10",
   "description": "Memory compression system for Claude Code - persist context across sessions",
   "keywords": [
     "claude",
@@ -41,10 +41,10 @@
     "worker:tail": "tail -f 50 ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log",
     "changelog:generate": "node scripts/generate-changelog.js",
     "discord:notify": "node scripts/discord-release-notify.js",
-    "worker:start": "bun plugin/scripts/worker-cli.js start",
-    "worker:stop": "bun plugin/scripts/worker-cli.js stop",
-    "worker:restart": "bun plugin/scripts/worker-cli.js restart",
-    "worker:status": "bun plugin/scripts/worker-cli.js status",
+    "worker:start": "bun plugin/scripts/worker-service.cjs start",
+    "worker:stop": "bun plugin/scripts/worker-service.cjs stop",
+    "worker:restart": "bun plugin/scripts/worker-service.cjs restart",
+    "worker:status": "bun plugin/scripts/worker-service.cjs status",
     "queue:check": "bun scripts/check-pending-queue.ts",
     "queue:process": "bun scripts/check-pending-queue.ts --process",
     "translate-readme": "bun scripts/translate-readme/cli.ts -v -o docs/i18n README.md",

plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "8.2.6",
+  "version": "8.2.10",
   "description": "Persistent memory system for Claude Code - seamlessly preserve context across sessions",
   "author": {
     "name": "Alex Newman"

plugin/.mcp.json

@@ -1,6 +1,6 @@
 {
   "mcpServers": {
-    "mem-search": {
+    "mcp-search": {
       "type": "stdio",
       "command": "${CLAUDE_PLUGIN_ROOT}/scripts/mcp-server.cjs"
     }

plugin/hooks/hooks.json

@@ -13,17 +13,17 @@
           {
             "type": "command",
             "command": "bun \"${CLAUDE_PLUGIN_ROOT}/scripts/worker-service.cjs\" start",
-            "timeout": 180
+            "timeout": 15
           },
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/context-hook.js\"",
-            "timeout": 300
+            "timeout": 15
           },
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/user-message-hook.js\"",
-            "timeout": 10
+            "timeout": 15
           }
         ]
       }
@@ -34,12 +34,12 @@
           {
             "type": "command",
             "command": "bun \"${CLAUDE_PLUGIN_ROOT}/scripts/worker-service.cjs\" start",
-            "timeout": 180
+            "timeout": 15
           },
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/new-hook.js\"",
-            "timeout": 300
+            "timeout": 15
           }
         ]
       }
@@ -51,7 +51,7 @@
           {
             "type": "command",
             "command": "bun \"${CLAUDE_PLUGIN_ROOT}/scripts/worker-service.cjs\" start",
-            "timeout": 180
+            "timeout": 15
           },
           {
             "type": "command",
@@ -67,7 +67,7 @@
           {
             "type": "command",
             "command": "bun \"${CLAUDE_PLUGIN_ROOT}/scripts/worker-service.cjs\" start",
-            "timeout": 180
+            "timeout": 15
           },
           {
             "type": "command",

plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-plugin",
-  "version": "8.2.5",
+  "version": "8.2.10",
   "private": true,
   "description": "Runtime dependencies for claude-mem bundled hooks",
   "type": "module",

plugin/scripts/context-hook.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env bun
-import{stdin as L}from"process";import A from"path";import{homedir as K}from"os";import{readFileSync as X}from"fs";import{readFileSync as v,writeFileSync as w,existsSync as F}from"fs";import{join as W}from"path";import{homedir as x}from"os";var U="bugfix,feature,refactor,discovery,decision,change",R="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var a=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:W(x(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:U,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:R,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!F(t))return this.getAllDefaults();let r=v(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{w(t,JSON.stringify(n,null,2),"utf-8"),_.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(s){_.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},s)}}let o={...this.DEFAULTS};for(let s of Object.keys(this.DEFAULTS))n[s]!==void 0&&(o[s]=n[s]);return o}catch(r){return _.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as b,existsSync as H,mkdirSync as G}from"fs";import{join as S}from"path";var f=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(f||{}),p=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=a.get("CLAUDE_MEM_DATA_DIR"),r=S(t,"logs");H(r)||G(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=S(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=a.get("CLAUDE_MEM_DATA_DIR"),r=S(t,"settings.json"),n=a.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=f[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
-${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),s=String(t.getMinutes()).padStart(2,"0"),E=String(t.getSeconds()).padStart(2,"0"),T=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${s}:${E}.${T}`}log(t,r,e,n,o){if(t<this.getLevel())return;let s=this.formatTimestamp(new Date),E=f[t].padEnd(5),T=r.padEnd(6),l="";n?.correlationId?l=`[${n.correlationId}] `:n?.sessionId&&(l=`[session-${n.sessionId}] `);let c="";o!=null&&(o instanceof Error?c=this.getLevel()===0?`
+import{stdin as L}from"process";import A from"path";import{homedir as G}from"os";import{readFileSync as K}from"fs";import{readFileSync as k,writeFileSync as v,existsSync as w}from"fs";import{join as F}from"path";import{homedir as W}from"os";var U="bugfix,feature,refactor,discovery,decision,change",R="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var a=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:F(W(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:U,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:R,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!w(t))return this.getAllDefaults();let r=k(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{v(t,JSON.stringify(n,null,2),"utf-8"),_.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(i){_.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},i)}}let o={...this.DEFAULTS};for(let i of Object.keys(this.DEFAULTS))n[i]!==void 0&&(o[i]=n[i]);return o}catch(r){return _.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as x,existsSync as b,mkdirSync as H}from"fs";import{join as O}from"path";var S=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(S||{}),f=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=a.get("CLAUDE_MEM_DATA_DIR"),r=O(t,"logs");b(r)||H(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=O(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=a.get("CLAUDE_MEM_DATA_DIR"),r=O(t,"settings.json"),n=a.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=S[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
+${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),i=String(t.getMinutes()).padStart(2,"0"),E=String(t.getSeconds()).padStart(2,"0"),u=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${i}:${E}.${u}`}log(t,r,e,n,o){if(t<this.getLevel())return;let i=this.formatTimestamp(new Date),E=S[t].padEnd(5),u=r.padEnd(6),c="";n?.correlationId?c=`[${n.correlationId}] `:n?.sessionId&&(c=`[session-${n.sessionId}] `);let l="";o!=null&&(o instanceof Error?l=this.getLevel()===0?`
 ${o.message}
-${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?c=`
-`+JSON.stringify(o,null,2):c=" "+this.formatData(o));let O="";if(n){let{sessionId:m,memorySessionId:Q,correlationId:Z,...D}=n;Object.keys(D).length>0&&(O=` {${Object.entries(D).map(([k,$])=>`${k}=${$}`).join(", ")}}`)}let C=`[${s}] [${E}] [${T}] ${l}${e}${O}${c}`;if(this.logFilePath)try{b(this.logFilePath,C+`
+${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?l=`
+`+JSON.stringify(o,null,2):l=" "+this.formatData(o));let T="";if(n){let{sessionId:m,memorySessionId:q,correlationId:Q,...D}=n;Object.keys(D).length>0&&(T=` {${Object.entries(D).map(([P,$])=>`${P}=${$}`).join(", ")}}`)}let C=`[${i}] [${E}] [${u}] ${c}${e}${T}${l}`;if(this.logFilePath)try{x(this.logFilePath,C+`
 `,"utf8")}catch(m){process.stderr.write(`[LOGGER] Failed to write to log file: ${m}
 `)}else process.stderr.write(C+`
-`)}debug(t,r,e,n){this.log(0,t,r,e,n)}info(t,r,e,n){this.log(1,t,r,e,n)}warn(t,r,e,n){this.log(2,t,r,e,n)}error(t,r,e,n){this.log(3,t,r,e,n)}dataIn(t,r,e,n){this.info(t,`\u2192 ${r}`,e,n)}dataOut(t,r,e,n){this.info(t,`\u2190 ${r}`,e,n)}success(t,r,e,n){this.info(t,`\u2713 ${r}`,e,n)}failure(t,r,e,n){this.error(t,`\u2717 ${r}`,e,n)}timing(t,r,e,n){this.info(t,`\u23F1 ${r}`,n,{duration:`${e}ms`})}happyPathError(t,r,e,n,o=""){let l=((new Error().stack||"").split(`
-`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),c=l?`${l[1].split("/").pop()}:${l[2]}`:"unknown",O={...e,location:c};return this.warn(t,`[HAPPY-PATH] ${r}`,O,n),o}},_=new p;var g={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function d(i){return process.platform==="win32"?Math.round(i*g.WINDOWS_MULTIPLIER):i}function h(i={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=i,o=e||"Worker service connection failed.",s=t?` (port ${t})`:"",E=`${o}${s}
+`)}debug(t,r,e,n){this.log(0,t,r,e,n)}info(t,r,e,n){this.log(1,t,r,e,n)}warn(t,r,e,n){this.log(2,t,r,e,n)}error(t,r,e,n){this.log(3,t,r,e,n)}dataIn(t,r,e,n){this.info(t,`\u2192 ${r}`,e,n)}dataOut(t,r,e,n){this.info(t,`\u2190 ${r}`,e,n)}success(t,r,e,n){this.info(t,`\u2713 ${r}`,e,n)}failure(t,r,e,n){this.error(t,`\u2717 ${r}`,e,n)}timing(t,r,e,n){this.info(t,`\u23F1 ${r}`,n,{duration:`${e}ms`})}happyPathError(t,r,e,n,o=""){let c=((new Error().stack||"").split(`
+`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),l=c?`${c[1].split("/").pop()}:${c[2]}`:"unknown",T={...e,location:l};return this.warn(t,`[HAPPY-PATH] ${r}`,T,n),o}},_=new f;var p={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function d(s){return process.platform==="win32"?Math.round(s*p.WINDOWS_MULTIPLIER):s}function h(s={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=s,o=e||"Worker service connection failed.",i=t?` (port ${t})`:"",E=`${o}${i}
 
 `;return E+=`To restart the worker:
 `,E+=`1. Exit Claude Code completely
@@ -16,4 +16,4 @@ ${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?c=`
 
 If that doesn't work, try: /troubleshoot`),n&&(E=`Worker Error: ${n}
 
-${E}`),E}var j=A.join(K(),".claude","plugins","marketplaces","thedotmack"),I=d(g.HEALTH_CHECK),M=null;function u(){if(M!==null)return M;let i=A.join(a.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=a.loadFromFile(i);return M=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),M}async function V(){let i=u();return(await fetch(`http://127.0.0.1:${i}/api/readiness`,{signal:AbortSignal.timeout(I)})).ok}function B(){let i=A.join(j,"package.json");return JSON.parse(X(i,"utf-8")).version}async function Y(){let i=u(),t=await fetch(`http://127.0.0.1:${i}/api/version`,{signal:AbortSignal.timeout(I)});if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function J(){let i=B(),t=await Y();i!==t&&_.warn("SYSTEM","Worker version mismatch",{pluginVersion:i,workerVersion:t,hint:"Restart worker with: claude-mem worker restart"})}async function N(){for(let r=0;r<25;r++){try{if(await V()){await J();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(h({port:u(),customPrefix:"Worker did not become ready within 5 seconds."}))}import z from"path";function y(i){if(!i||i.trim()==="")return _.warn("PROJECT_NAME","Empty cwd provided, using fallback",{cwd:i}),"unknown-project";let t=z.basename(i);if(t===""){if(process.platform==="win32"){let e=i.match(/^([A-Z]):\\/i);if(e){let o=`drive-${e[1].toUpperCase()}`;return _.info("PROJECT_NAME","Drive root detected",{cwd:i,projectName:o}),o}}return _.warn("PROJECT_NAME","Root directory detected, using fallback",{cwd:i}),"unknown-project"}return t}async function P(i){await N();let t=i?.cwd??process.cwd(),r=y(t),n=`http://127.0.0.1:${u()}/api/context/inject?project=${encodeURIComponent(r)}`,o=await fetch(n,{signal:AbortSignal.timeout(g.DEFAULT)});if(!o.ok)throw new Error(`Context generation failed: ${o.status}`);return(await o.text()).trim()}var q=process.argv.includes("--colors");if(L.isTTY||q)P(void 0).then(i=>{console.log(i),process.exit(0)});else{let i="";L.on("data",t=>i+=t),L.on("end",async()=>{let t;try{t=i.trim()?JSON.parse(i):void 0}catch(e){throw new Error(`Failed to parse hook input: ${e instanceof Error?e.message:String(e)}`)}let r=await P(t);console.log(JSON.stringify({hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:r}})),process.exit(0)})}
+${E}`),E}var X=A.join(G(),".claude","plugins","marketplaces","thedotmack"),At=d(p.HEALTH_CHECK),M=null;function g(){if(M!==null)return M;let s=A.join(a.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=a.loadFromFile(s);return M=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),M}async function j(){let s=g();return(await fetch(`http://127.0.0.1:${s}/api/readiness`)).ok}function V(){let s=A.join(X,"package.json");return JSON.parse(K(s,"utf-8")).version}async function B(){let s=g(),t=await fetch(`http://127.0.0.1:${s}/api/version`);if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function Y(){let s=V(),t=await B();s!==t&&_.debug("SYSTEM","Version check",{pluginVersion:s,workerVersion:t,note:"Mismatch will be auto-restarted by worker-service start command"})}async function I(){for(let r=0;r<75;r++){try{if(await j()){await Y();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(h({port:g(),customPrefix:"Worker did not become ready within 15 seconds."}))}import J from"path";function N(s){if(!s||s.trim()==="")return _.warn("PROJECT_NAME","Empty cwd provided, using fallback",{cwd:s}),"unknown-project";let t=J.basename(s);if(t===""){if(process.platform==="win32"){let e=s.match(/^([A-Z]):\\/i);if(e){let o=`drive-${e[1].toUpperCase()}`;return _.info("PROJECT_NAME","Drive root detected",{cwd:s,projectName:o}),o}}return _.warn("PROJECT_NAME","Root directory detected, using fallback",{cwd:s}),"unknown-project"}return t}async function y(s){await I();let t=s?.cwd??process.cwd(),r=N(t),n=`http://127.0.0.1:${g()}/api/context/inject?project=${encodeURIComponent(r)}`,o=await fetch(n);if(!o.ok)throw new Error(`Context generation failed: ${o.status}`);return(await o.text()).trim()}var z=process.argv.includes("--colors");if(L.isTTY||z)y(void 0).then(s=>{console.log(s),process.exit(0)});else{let s="";L.on("data",t=>s+=t),L.on("end",async()=>{let t;try{t=s.trim()?JSON.parse(s):void 0}catch(e){throw new Error(`Failed to parse hook input: ${e instanceof Error?e.message:String(e)}`)}let r=await y(t);console.log(JSON.stringify({hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:r}})),process.exit(0)})}

plugin/scripts/new-hook.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env bun
-import{stdin as y}from"process";var S=JSON.stringify({continue:!0,suppressOutput:!0});import m from"path";import{homedir as X}from"os";import{readFileSync as j}from"fs";import{readFileSync as w,writeFileSync as b,existsSync as F}from"fs";import{join as H}from"path";import{homedir as W}from"os";var R="bugfix,feature,refactor,discovery,decision,change",U="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var g=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:H(W(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:R,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:U,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!F(t))return this.getAllDefaults();let r=w(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{b(t,JSON.stringify(n,null,2),"utf-8"),E.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(a){E.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},a)}}let o={...this.DEFAULTS};for(let a of Object.keys(this.DEFAULTS))n[a]!==void 0&&(o[a]=n[a]);return o}catch(r){return E.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as K,existsSync as x,mkdirSync as G}from"fs";import{join as T}from"path";var f=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(f||{}),M=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=g.get("CLAUDE_MEM_DATA_DIR"),r=T(t,"logs");x(r)||G(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=T(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=g.get("CLAUDE_MEM_DATA_DIR"),r=T(t,"settings.json"),n=g.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=f[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
-${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),a=String(t.getMinutes()).padStart(2,"0"),s=String(t.getSeconds()).padStart(2,"0"),l=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${a}:${s}.${l}`}log(t,r,e,n,o){if(t<this.getLevel())return;let a=this.formatTimestamp(new Date),s=f[t].padEnd(5),l=r.padEnd(6),_="";n?.correlationId?_=`[${n.correlationId}] `:n?.sessionId&&(_=`[session-${n.sessionId}] `);let c="";o!=null&&(o instanceof Error?c=this.getLevel()===0?`
+import{stdin as P}from"process";var T=JSON.stringify({continue:!0,suppressOutput:!0});import L from"path";import{homedir as G}from"os";import{readFileSync as X}from"fs";import{readFileSync as v,writeFileSync as w,existsSync as b}from"fs";import{join as F}from"path";import{homedir as H}from"os";var R="bugfix,feature,refactor,discovery,decision,change",U="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var g=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:F(H(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:R,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:U,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!b(t))return this.getAllDefaults();let r=v(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{w(t,JSON.stringify(n,null,2),"utf-8"),E.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(_){E.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},_)}}let o={...this.DEFAULTS};for(let _ of Object.keys(this.DEFAULTS))n[_]!==void 0&&(o[_]=n[_]);return o}catch(r){return E.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as W,existsSync as K,mkdirSync as x}from"fs";import{join as S}from"path";var f=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(f||{}),M=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=g.get("CLAUDE_MEM_DATA_DIR"),r=S(t,"logs");K(r)||x(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=S(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=g.get("CLAUDE_MEM_DATA_DIR"),r=S(t,"settings.json"),n=g.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=f[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
+${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),_=String(t.getMinutes()).padStart(2,"0"),s=String(t.getSeconds()).padStart(2,"0"),l=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${_}:${s}.${l}`}log(t,r,e,n,o){if(t<this.getLevel())return;let _=this.formatTimestamp(new Date),s=f[t].padEnd(5),l=r.padEnd(6),a="";n?.correlationId?a=`[${n.correlationId}] `:n?.sessionId&&(a=`[session-${n.sessionId}] `);let c="";o!=null&&(o instanceof Error?c=this.getLevel()===0?`
 ${o.message}
 ${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?c=`
-`+JSON.stringify(o,null,2):c=" "+this.formatData(o));let u="";if(n){let{sessionId:D,memorySessionId:Z,correlationId:tt,...d}=n;Object.keys(d).length>0&&(u=` {${Object.entries(d).map(([$,v])=>`${$}=${v}`).join(", ")}}`)}let C=`[${a}] [${s}] [${l}] ${_}${e}${u}${c}`;if(this.logFilePath)try{K(this.logFilePath,C+`
+`+JSON.stringify(o,null,2):c=" "+this.formatData(o));let p="";if(n){let{sessionId:D,memorySessionId:Q,correlationId:Z,...d}=n;Object.keys(d).length>0&&(p=` {${Object.entries(d).map(([k,$])=>`${k}=${$}`).join(", ")}}`)}let m=`[${_}] [${s}] [${l}] ${a}${e}${p}${c}`;if(this.logFilePath)try{W(this.logFilePath,m+`
 `,"utf8")}catch(D){process.stderr.write(`[LOGGER] Failed to write to log file: ${D}
-`)}else process.stderr.write(C+`
-`)}debug(t,r,e,n){this.log(0,t,r,e,n)}info(t,r,e,n){this.log(1,t,r,e,n)}warn(t,r,e,n){this.log(2,t,r,e,n)}error(t,r,e,n){this.log(3,t,r,e,n)}dataIn(t,r,e,n){this.info(t,`\u2192 ${r}`,e,n)}dataOut(t,r,e,n){this.info(t,`\u2190 ${r}`,e,n)}success(t,r,e,n){this.info(t,`\u2713 ${r}`,e,n)}failure(t,r,e,n){this.error(t,`\u2717 ${r}`,e,n)}timing(t,r,e,n){this.info(t,`\u23F1 ${r}`,n,{duration:`${e}ms`})}happyPathError(t,r,e,n,o=""){let _=((new Error().stack||"").split(`
-`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),c=_?`${_[1].split("/").pop()}:${_[2]}`:"unknown",u={...e,location:c};return this.warn(t,`[HAPPY-PATH] ${r}`,u,n),o}},E=new M;var A={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function h(i){return process.platform==="win32"?Math.round(i*A.WINDOWS_MULTIPLIER):i}function N(i={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=i,o=e||"Worker service connection failed.",a=t?` (port ${t})`:"",s=`${o}${a}
+`)}else process.stderr.write(m+`
+`)}debug(t,r,e,n){this.log(0,t,r,e,n)}info(t,r,e,n){this.log(1,t,r,e,n)}warn(t,r,e,n){this.log(2,t,r,e,n)}error(t,r,e,n){this.log(3,t,r,e,n)}dataIn(t,r,e,n){this.info(t,`\u2192 ${r}`,e,n)}dataOut(t,r,e,n){this.info(t,`\u2190 ${r}`,e,n)}success(t,r,e,n){this.info(t,`\u2713 ${r}`,e,n)}failure(t,r,e,n){this.error(t,`\u2717 ${r}`,e,n)}timing(t,r,e,n){this.info(t,`\u23F1 ${r}`,n,{duration:`${e}ms`})}happyPathError(t,r,e,n,o=""){let a=((new Error().stack||"").split(`
+`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),c=a?`${a[1].split("/").pop()}:${a[2]}`:"unknown",p={...e,location:c};return this.warn(t,`[HAPPY-PATH] ${r}`,p,n),o}},E=new M;var A={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function h(i){return process.platform==="win32"?Math.round(i*A.WINDOWS_MULTIPLIER):i}function N(i={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=i,o=e||"Worker service connection failed.",_=t?` (port ${t})`:"",s=`${o}${_}
 
 `;return s+=`To restart the worker:
 `,s+=`1. Exit Claude Code completely
@@ -16,4 +16,4 @@ ${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?c=`
 
 If that doesn't work, try: /troubleshoot`),n&&(s=`Worker Error: ${n}
 
-${s}`),s}var V=m.join(X(),".claude","plugins","marketplaces","thedotmack"),I=h(A.HEALTH_CHECK),O=null;function p(){if(O!==null)return O;let i=m.join(g.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=g.loadFromFile(i);return O=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),O}async function B(){let i=p();return(await fetch(`http://127.0.0.1:${i}/api/readiness`,{signal:AbortSignal.timeout(I)})).ok}function Y(){let i=m.join(V,"package.json");return JSON.parse(j(i,"utf-8")).version}async function J(){let i=p(),t=await fetch(`http://127.0.0.1:${i}/api/version`,{signal:AbortSignal.timeout(I)});if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function z(){let i=Y(),t=await J();i!==t&&E.warn("SYSTEM","Worker version mismatch",{pluginVersion:i,workerVersion:t,hint:"Restart worker with: claude-mem worker restart"})}async function P(){for(let r=0;r<25;r++){try{if(await B()){await z();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(N({port:p(),customPrefix:"Worker did not become ready within 5 seconds."}))}import q from"path";function k(i){if(!i||i.trim()==="")return E.warn("PROJECT_NAME","Empty cwd provided, using fallback",{cwd:i}),"unknown-project";let t=q.basename(i);if(t===""){if(process.platform==="win32"){let e=i.match(/^([A-Z]):\\/i);if(e){let o=`drive-${e[1].toUpperCase()}`;return E.info("PROJECT_NAME","Drive root detected",{cwd:i,projectName:o}),o}}return E.warn("PROJECT_NAME","Root directory detected, using fallback",{cwd:i}),"unknown-project"}return t}async function Q(i){if(await P(),!i)throw new Error("newHook requires input");let{session_id:t,cwd:r,prompt:e}=i,n=k(r);E.info("HOOK","new-hook: Received hook input",{session_id:t,has_prompt:!!e,cwd:r});let o=p();E.info("HOOK","new-hook: Calling /api/sessions/init",{contentSessionId:t,project:n,prompt_length:e?.length});let a=await fetch(`http://127.0.0.1:${o}/api/sessions/init`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({contentSessionId:t,project:n,prompt:e}),signal:AbortSignal.timeout(5e3)});if(!a.ok)throw new Error(`Session initialization failed: ${a.status}`);let s=await a.json(),l=s.sessionDbId,_=s.promptNumber;if(E.info("HOOK","new-hook: Received from /api/sessions/init",{sessionDbId:l,promptNumber:_,skipped:s.skipped}),s.skipped&&s.reason==="private"){E.info("HOOK",`new-hook: Session ${l}, prompt #${_} (fully private - skipped)`),console.log(S);return}E.info("HOOK",`new-hook: Session ${l}, prompt #${_}`);let c=e.startsWith("/")?e.substring(1):e;E.info("HOOK","new-hook: Calling /sessions/{sessionDbId}/init",{sessionDbId:l,promptNumber:_,userPrompt_length:c?.length});let u=await fetch(`http://127.0.0.1:${o}/sessions/${l}/init`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({userPrompt:c,promptNumber:_}),signal:AbortSignal.timeout(5e3)});if(!u.ok)throw new Error(`SDK agent start failed: ${u.status}`);console.log(S)}var L="";y.on("data",i=>L+=i);y.on("end",async()=>{let i;try{i=L?JSON.parse(L):void 0}catch(t){throw new Error(`Failed to parse hook input: ${t instanceof Error?t.message:String(t)}`)}await Q(i)});
+${s}`),s}var j=L.join(G(),".claude","plugins","marketplaces","thedotmack"),Ct=h(A.HEALTH_CHECK),O=null;function u(){if(O!==null)return O;let i=L.join(g.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=g.loadFromFile(i);return O=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),O}async function V(){let i=u();return(await fetch(`http://127.0.0.1:${i}/api/readiness`)).ok}function B(){let i=L.join(j,"package.json");return JSON.parse(X(i,"utf-8")).version}async function Y(){let i=u(),t=await fetch(`http://127.0.0.1:${i}/api/version`);if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function J(){let i=B(),t=await Y();i!==t&&E.debug("SYSTEM","Version check",{pluginVersion:i,workerVersion:t,note:"Mismatch will be auto-restarted by worker-service start command"})}async function I(){for(let r=0;r<75;r++){try{if(await V()){await J();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(N({port:u(),customPrefix:"Worker did not become ready within 15 seconds."}))}import z from"path";function y(i){if(!i||i.trim()==="")return E.warn("PROJECT_NAME","Empty cwd provided, using fallback",{cwd:i}),"unknown-project";let t=z.basename(i);if(t===""){if(process.platform==="win32"){let e=i.match(/^([A-Z]):\\/i);if(e){let o=`drive-${e[1].toUpperCase()}`;return E.info("PROJECT_NAME","Drive root detected",{cwd:i,projectName:o}),o}}return E.warn("PROJECT_NAME","Root directory detected, using fallback",{cwd:i}),"unknown-project"}return t}async function q(i){if(await I(),!i)throw new Error("newHook requires input");let{session_id:t,cwd:r,prompt:e}=i,n=y(r);E.info("HOOK","new-hook: Received hook input",{session_id:t,has_prompt:!!e,cwd:r});let o=u();E.info("HOOK","new-hook: Calling /api/sessions/init",{contentSessionId:t,project:n,prompt_length:e?.length});let _=await fetch(`http://127.0.0.1:${o}/api/sessions/init`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({contentSessionId:t,project:n,prompt:e})});if(!_.ok)throw new Error(`Session initialization failed: ${_.status}`);let s=await _.json(),l=s.sessionDbId,a=s.promptNumber;if(E.info("HOOK","new-hook: Received from /api/sessions/init",{sessionDbId:l,promptNumber:a,skipped:s.skipped}),s.skipped&&s.reason==="private"){E.info("HOOK",`new-hook: Session ${l}, prompt #${a} (fully private - skipped)`),console.log(T);return}E.info("HOOK",`new-hook: Session ${l}, prompt #${a}`);let c=e.startsWith("/")?e.substring(1):e;E.info("HOOK","new-hook: Calling /sessions/{sessionDbId}/init",{sessionDbId:l,promptNumber:a,userPrompt_length:c?.length});let p=await fetch(`http://127.0.0.1:${o}/sessions/${l}/init`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({userPrompt:c,promptNumber:a})});if(!p.ok)throw new Error(`SDK agent start failed: ${p.status}`);console.log(T)}var C="";P.on("data",i=>C+=i);P.on("end",async()=>{let i;try{i=C?JSON.parse(C):void 0}catch(t){throw new Error(`Failed to parse hook input: ${t instanceof Error?t.message:String(t)}`)}await q(i)});

plugin/scripts/save-hook.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env bun
-import{stdin as P}from"process";var U=JSON.stringify({continue:!0,suppressOutput:!0});import{readFileSync as v,writeFileSync as w,existsSync as F}from"fs";import{join as H}from"path";import{homedir as W}from"os";var R="bugfix,feature,refactor,discovery,decision,change",d="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var a=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:H(W(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:R,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:d,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!F(t))return this.getAllDefaults();let r=v(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{w(t,JSON.stringify(n,null,2),"utf-8"),_.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(i){_.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},i)}}let o={...this.DEFAULTS};for(let i of Object.keys(this.DEFAULTS))n[i]!==void 0&&(o[i]=n[i]);return o}catch(r){return _.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as b,existsSync as G,mkdirSync as x}from"fs";import{join as M}from"path";var f=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(f||{}),p=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=a.get("CLAUDE_MEM_DATA_DIR"),r=M(t,"logs");G(r)||x(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=M(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=a.get("CLAUDE_MEM_DATA_DIR"),r=M(t,"settings.json"),n=a.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=f[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
-${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),i=String(t.getMinutes()).padStart(2,"0"),E=String(t.getSeconds()).padStart(2,"0"),l=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${i}:${E}.${l}`}log(t,r,e,n,o){if(t<this.getLevel())return;let i=this.formatTimestamp(new Date),E=f[t].padEnd(5),l=r.padEnd(6),g="";n?.correlationId?g=`[${n.correlationId}] `:n?.sessionId&&(g=`[session-${n.sessionId}] `);let c="";o!=null&&(o instanceof Error?c=this.getLevel()===0?`
+import{stdin as y}from"process";var U=JSON.stringify({continue:!0,suppressOutput:!0});import{readFileSync as k,writeFileSync as v,existsSync as w}from"fs";import{join as F}from"path";import{homedir as H}from"os";var R="bugfix,feature,refactor,discovery,decision,change",d="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var a=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:F(H(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:R,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:d,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!w(t))return this.getAllDefaults();let r=k(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{v(t,JSON.stringify(n,null,2),"utf-8"),_.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(i){_.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},i)}}let o={...this.DEFAULTS};for(let i of Object.keys(this.DEFAULTS))n[i]!==void 0&&(o[i]=n[i]);return o}catch(r){return _.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as W,existsSync as b,mkdirSync as G}from"fs";import{join as M}from"path";var S=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(S||{}),f=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=a.get("CLAUDE_MEM_DATA_DIR"),r=M(t,"logs");b(r)||G(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=M(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=a.get("CLAUDE_MEM_DATA_DIR"),r=M(t,"settings.json"),n=a.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=S[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
+${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),i=String(t.getMinutes()).padStart(2,"0"),E=String(t.getSeconds()).padStart(2,"0"),l=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${i}:${E}.${l}`}log(t,r,e,n,o){if(t<this.getLevel())return;let i=this.formatTimestamp(new Date),E=S[t].padEnd(5),l=r.padEnd(6),c="";n?.correlationId?c=`[${n.correlationId}] `:n?.sessionId&&(c=`[session-${n.sessionId}] `);let g="";o!=null&&(o instanceof Error?g=this.getLevel()===0?`
 ${o.message}
-${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?c=`
-`+JSON.stringify(o,null,2):c=" "+this.formatData(o));let T="";if(n){let{sessionId:D,memorySessionId:z,correlationId:Q,...m}=n;Object.keys(m).length>0&&(T=` {${Object.entries(m).map(([$,k])=>`${$}=${k}`).join(", ")}}`)}let C=`[${i}] [${E}] [${l}] ${g}${e}${T}${c}`;if(this.logFilePath)try{b(this.logFilePath,C+`
+${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?g=`
+`+JSON.stringify(o,null,2):g=" "+this.formatData(o));let u="";if(n){let{sessionId:D,memorySessionId:q,correlationId:z,...m}=n;Object.keys(m).length>0&&(u=` {${Object.entries(m).map(([P,$])=>`${P}=${$}`).join(", ")}}`)}let C=`[${i}] [${E}] [${l}] ${c}${e}${u}${g}`;if(this.logFilePath)try{W(this.logFilePath,C+`
 `,"utf8")}catch(D){process.stderr.write(`[LOGGER] Failed to write to log file: ${D}
 `)}else process.stderr.write(C+`
-`)}debug(t,r,e,n){this.log(0,t,r,e,n)}info(t,r,e,n){this.log(1,t,r,e,n)}warn(t,r,e,n){this.log(2,t,r,e,n)}error(t,r,e,n){this.log(3,t,r,e,n)}dataIn(t,r,e,n){this.info(t,`\u2192 ${r}`,e,n)}dataOut(t,r,e,n){this.info(t,`\u2190 ${r}`,e,n)}success(t,r,e,n){this.info(t,`\u2713 ${r}`,e,n)}failure(t,r,e,n){this.error(t,`\u2717 ${r}`,e,n)}timing(t,r,e,n){this.info(t,`\u23F1 ${r}`,n,{duration:`${e}ms`})}happyPathError(t,r,e,n,o=""){let g=((new Error().stack||"").split(`
-`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),c=g?`${g[1].split("/").pop()}:${g[2]}`:"unknown",T={...e,location:c};return this.warn(t,`[HAPPY-PATH] ${r}`,T,n),o}},_=new p;import A from"path";import{homedir as K}from"os";import{readFileSync as X}from"fs";var u={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function I(s){return process.platform==="win32"?Math.round(s*u.WINDOWS_MULTIPLIER):s}function h(s={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=s,o=e||"Worker service connection failed.",i=t?` (port ${t})`:"",E=`${o}${i}
+`)}debug(t,r,e,n){this.log(0,t,r,e,n)}info(t,r,e,n){this.log(1,t,r,e,n)}warn(t,r,e,n){this.log(2,t,r,e,n)}error(t,r,e,n){this.log(3,t,r,e,n)}dataIn(t,r,e,n){this.info(t,`\u2192 ${r}`,e,n)}dataOut(t,r,e,n){this.info(t,`\u2190 ${r}`,e,n)}success(t,r,e,n){this.info(t,`\u2713 ${r}`,e,n)}failure(t,r,e,n){this.error(t,`\u2717 ${r}`,e,n)}timing(t,r,e,n){this.info(t,`\u23F1 ${r}`,n,{duration:`${e}ms`})}happyPathError(t,r,e,n,o=""){let c=((new Error().stack||"").split(`
+`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),g=c?`${c[1].split("/").pop()}:${c[2]}`:"unknown",u={...e,location:g};return this.warn(t,`[HAPPY-PATH] ${r}`,u,n),o}},_=new f;import A from"path";import{homedir as x}from"os";import{readFileSync as K}from"fs";var p={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function I(s){return process.platform==="win32"?Math.round(s*p.WINDOWS_MULTIPLIER):s}function h(s={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=s,o=e||"Worker service connection failed.",i=t?` (port ${t})`:"",E=`${o}${i}
 
 `;return E+=`To restart the worker:
 `,E+=`1. Exit Claude Code completely
@@ -16,4 +16,4 @@ ${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?c=`
 
 If that doesn't work, try: /troubleshoot`),n&&(E=`Worker Error: ${n}
 
-${E}`),E}var V=A.join(K(),".claude","plugins","marketplaces","thedotmack"),N=I(u.HEALTH_CHECK),S=null;function O(){if(S!==null)return S;let s=A.join(a.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=a.loadFromFile(s);return S=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),S}async function j(){let s=O();return(await fetch(`http://127.0.0.1:${s}/api/readiness`,{signal:AbortSignal.timeout(N)})).ok}function B(){let s=A.join(V,"package.json");return JSON.parse(X(s,"utf-8")).version}async function Y(){let s=O(),t=await fetch(`http://127.0.0.1:${s}/api/version`,{signal:AbortSignal.timeout(N)});if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function J(){let s=B(),t=await Y();s!==t&&_.warn("SYSTEM","Worker version mismatch",{pluginVersion:s,workerVersion:t,hint:"Restart worker with: claude-mem worker restart"})}async function y(){for(let r=0;r<25;r++){try{if(await j()){await J();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(h({port:O(),customPrefix:"Worker did not become ready within 5 seconds."}))}async function q(s){if(await y(),!s)throw new Error("saveHook requires input");let{session_id:t,cwd:r,tool_name:e,tool_input:n,tool_response:o}=s,i=O(),E=_.formatTool(e,n);if(_.dataIn("HOOK",`PostToolUse: ${E}`,{workerPort:i}),!r)throw new Error(`Missing cwd in PostToolUse hook input for session ${t}, tool ${e}`);let l=await fetch(`http://127.0.0.1:${i}/api/sessions/observations`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({contentSessionId:t,tool_name:e,tool_input:n,tool_response:o,cwd:r}),signal:AbortSignal.timeout(u.DEFAULT)});if(!l.ok)throw new Error(`Observation storage failed: ${l.status}`);_.debug("HOOK","Observation sent successfully",{toolName:e}),console.log(U)}var L="";P.on("data",s=>L+=s);P.on("end",async()=>{let s;try{s=L?JSON.parse(L):void 0}catch(t){throw new Error(`Failed to parse hook input: ${t instanceof Error?t.message:String(t)}`)}await q(s)});
+${E}`),E}var X=A.join(x(),".claude","plugins","marketplaces","thedotmack"),At=I(p.HEALTH_CHECK),T=null;function O(){if(T!==null)return T;let s=A.join(a.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=a.loadFromFile(s);return T=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),T}async function V(){let s=O();return(await fetch(`http://127.0.0.1:${s}/api/readiness`)).ok}function j(){let s=A.join(X,"package.json");return JSON.parse(K(s,"utf-8")).version}async function B(){let s=O(),t=await fetch(`http://127.0.0.1:${s}/api/version`);if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function Y(){let s=j(),t=await B();s!==t&&_.debug("SYSTEM","Version check",{pluginVersion:s,workerVersion:t,note:"Mismatch will be auto-restarted by worker-service start command"})}async function N(){for(let r=0;r<75;r++){try{if(await V()){await Y();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(h({port:O(),customPrefix:"Worker did not become ready within 15 seconds."}))}async function J(s){if(await N(),!s)throw new Error("saveHook requires input");let{session_id:t,cwd:r,tool_name:e,tool_input:n,tool_response:o}=s,i=O(),E=_.formatTool(e,n);if(_.dataIn("HOOK",`PostToolUse: ${E}`,{workerPort:i}),!r)throw new Error(`Missing cwd in PostToolUse hook input for session ${t}, tool ${e}`);let l=await fetch(`http://127.0.0.1:${i}/api/sessions/observations`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({contentSessionId:t,tool_name:e,tool_input:n,tool_response:o,cwd:r})});if(!l.ok)throw new Error(`Observation storage failed: ${l.status}`);_.debug("HOOK","Observation sent successfully",{toolName:e}),console.log(U)}var L="";y.on("data",s=>L+=s);y.on("end",async()=>{let s;try{s=L?JSON.parse(L):void 0}catch(t){throw new Error(`Failed to parse hook input: ${t instanceof Error?t.message:String(t)}`)}await J(s)});

plugin/scripts/smart-install.js

@@ -254,93 +254,57 @@ function installUv() {
 }
 
 /**
- * Install the claude-mem CLI command to PATH
- * Creates a wrapper script in ~/.local/bin (Unix) or %LOCALAPPDATA%\Programs\claude-mem (Windows)
+ * Add shell alias for claude-mem command
  */
 function installCLI() {
-  const CLI_NAME = 'claude-mem';
-  const WORKER_CLI = join(ROOT, 'plugin', 'scripts', 'worker-cli.js');
+  const WORKER_CLI = join(ROOT, 'plugin', 'scripts', 'worker-service.cjs');
+  const bunPath = getBunPath() || 'bun';
+  const aliasLine = `alias claude-mem='${bunPath} "${WORKER_CLI}"'`;
+  const markerPath = join(ROOT, '.cli-installed');
 
-  if (IS_WINDOWS) {
-    // Windows: Create .cmd file in LocalAppData
-    const cliDir = join(process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local'), 'Programs', 'claude-mem');
-    const cliPath = join(cliDir, `${CLI_NAME}.cmd`);
-    const markerPath = join(cliDir, '.cli-installed');
+  // Skip if already installed
+  if (existsSync(markerPath)) return;
 
-    // Skip if already installed
-    if (existsSync(markerPath)) return;
+  try {
+    if (IS_WINDOWS) {
+      // Windows: Add to PATH via PowerShell profile
+      const profilePath = join(process.env.USERPROFILE || homedir(), 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1');
+      const profileDir = join(process.env.USERPROFILE || homedir(), 'Documents', 'PowerShell');
+      const functionDef = `function claude-mem { & "${bunPath}" "${WORKER_CLI}" $args }\n`;
 
-    try {
-      // Create directory if needed
-      if (!existsSync(cliDir)) {
-        execSync(`mkdir "${cliDir}"`, { stdio: 'ignore', shell: true });
+      if (!existsSync(profileDir)) {
+        execSync(`mkdir "${profileDir}"`, { stdio: 'ignore', shell: true });
       }
 
-      // Get Bun path for the wrapper
-      const bunPath = getBunPath() || 'bun';
+      const existingContent = existsSync(profilePath) ? readFileSync(profilePath, 'utf-8') : '';
+      if (!existingContent.includes('function claude-mem')) {
+        writeFileSync(profilePath, existingContent + '\n' + functionDef);
+        console.error(`✅ PowerShell function added to profile`);
+        console.error('   Restart your terminal to use: claude-mem <command>');
+      }
+    } else {
+      // Unix: Add alias to shell configs
+      const shellConfigs = [
+        join(homedir(), '.bashrc'),
+        join(homedir(), '.zshrc')
+      ];
 
-      // Create the wrapper script
-      const cmdContent = `@echo off
-"${bunPath}" "${WORKER_CLI}" %*
-`;
-      writeFileSync(cliPath, cmdContent);
-      writeFileSync(markerPath, new Date().toISOString());
-
-      console.error(`✅ CLI installed: ${cliPath}`);
-      console.error('');
-      console.error('📋 Add to PATH (run once in PowerShell as Admin):');
-      console.error(`   [Environment]::SetEnvironmentVariable("Path", $env:Path + ";${cliDir}", "User")`);
-      console.error('');
-      console.error('   Then restart your terminal and use: npm run worker:start|stop|restart|status');
-    } catch (error) {
-      console.error(`⚠️  Could not install CLI: ${error.message}`);
-      console.error(`   You can still use: bun "${WORKER_CLI}" <command>`);
+      for (const config of shellConfigs) {
+        if (existsSync(config)) {
+          const content = readFileSync(config, 'utf-8');
+          if (!content.includes('alias claude-mem=')) {
+            writeFileSync(config, content + '\n' + aliasLine + '\n');
+            console.error(`✅ Alias added to ${config}`);
+          }
+        }
+      }
+      console.error('   Restart your terminal to use: claude-mem <command>');
     }
-  } else {
-    // Unix: Create shell script in ~/.local/bin
-    const cliDir = join(homedir(), '.local', 'bin');
-    const cliPath = join(cliDir, CLI_NAME);
-    const markerPath = join(ROOT, '.cli-installed');
 
-    // Skip if already installed
-    if (existsSync(markerPath) && existsSync(cliPath)) return;
-
-    try {
-      // Create directory if needed
-      if (!existsSync(cliDir)) {
-        execSync(`mkdir -p "${cliDir}"`, { stdio: 'ignore', shell: true });
-      }
-
-      // Get Bun path for the wrapper
-      const bunPath = getBunPath() || 'bun';
-
-      // Create the wrapper script
-      const shContent = `#!/usr/bin/env bash
-# claude-mem CLI wrapper - manages the worker service
-exec "${bunPath}" "${WORKER_CLI}" "$@"
-`;
-      writeFileSync(cliPath, shContent, { mode: 0o755 });
-      writeFileSync(markerPath, new Date().toISOString());
-
-      console.error(`✅ CLI installed: ${cliPath}`);
-
-      // Check if ~/.local/bin is in PATH
-      const pathDirs = (process.env.PATH || '').split(':');
-      const localBinInPath = pathDirs.some(p => p === cliDir || p === '$HOME/.local/bin' || p.endsWith('/.local/bin'));
-
-      if (!localBinInPath) {
-        console.error('');
-        console.error('📋 Add to PATH (add to ~/.bashrc or ~/.zshrc):');
-        console.error('   export PATH="$HOME/.local/bin:$PATH"');
-        console.error('');
-        console.error('   Then restart your terminal and use: npm run worker:start|stop|restart|status');
-      } else {
-        console.error('   Usage: npm run worker:start|stop|restart|status');
-      }
-    } catch (error) {
-      console.error(`⚠️  Could not install CLI: ${error.message}`);
-      console.error(`   You can still use: bun "${WORKER_CLI}" <command>`);
-    }
+    writeFileSync(markerPath, new Date().toISOString());
+  } catch (error) {
+    console.error(`⚠️  Could not add shell alias: ${error.message}`);
+    console.error(`   Use directly: ${bunPath} "${WORKER_CLI}" <command>`);
   }
 }
 

plugin/scripts/summary-hook.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env bun
-import{stdin as k}from"process";var f=JSON.stringify({continue:!0,suppressOutput:!0});import{readFileSync as v,writeFileSync as F,existsSync as x}from"fs";import{join as H}from"path";import{homedir as W}from"os";var h="bugfix,feature,refactor,discovery,decision,change",d="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var c=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:H(W(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:h,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:d,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!x(t))return this.getAllDefaults();let r=v(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{F(t,JSON.stringify(n,null,2),"utf-8"),g.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(E){g.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},E)}}let o={...this.DEFAULTS};for(let E of Object.keys(this.DEFAULTS))n[E]!==void 0&&(o[E]=n[E]);return o}catch(r){return g.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as b,existsSync as G,mkdirSync as K}from"fs";import{join as M}from"path";var p=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(p||{}),A=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=c.get("CLAUDE_MEM_DATA_DIR"),r=M(t,"logs");G(r)||K(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=M(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=c.get("CLAUDE_MEM_DATA_DIR"),r=M(t,"settings.json"),n=c.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=p[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
-${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),E=String(t.getMinutes()).padStart(2,"0"),i=String(t.getSeconds()).padStart(2,"0"),_=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${E}:${i}.${_}`}log(t,r,e,n,o){if(t<this.getLevel())return;let E=this.formatTimestamp(new Date),i=p[t].padEnd(5),_=r.padEnd(6),a="";n?.correlationId?a=`[${n.correlationId}] `:n?.sessionId&&(a=`[session-${n.sessionId}] `);let l="";o!=null&&(o instanceof Error?l=this.getLevel()===0?`
+import{stdin as $}from"process";var f=JSON.stringify({continue:!0,suppressOutput:!0});import{readFileSync as w,writeFileSync as v,existsSync as F}from"fs";import{join as x}from"path";import{homedir as H}from"os";var d="bugfix,feature,refactor,discovery,decision,change",h="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var g=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:x(H(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:d,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:h,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!F(t))return this.getAllDefaults();let r=w(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{v(t,JSON.stringify(n,null,2),"utf-8"),c.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(E){c.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},E)}}let o={...this.DEFAULTS};for(let E of Object.keys(this.DEFAULTS))n[E]!==void 0&&(o[E]=n[E]);return o}catch(r){return c.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as W,existsSync as b,mkdirSync as G}from"fs";import{join as T}from"path";var M=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(M||{}),p=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=g.get("CLAUDE_MEM_DATA_DIR"),r=T(t,"logs");b(r)||G(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=T(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=g.get("CLAUDE_MEM_DATA_DIR"),r=T(t,"settings.json"),n=g.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=M[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
+${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),E=String(t.getMinutes()).padStart(2,"0"),i=String(t.getSeconds()).padStart(2,"0"),_=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${E}:${i}.${_}`}log(t,r,e,n,o){if(t<this.getLevel())return;let E=this.formatTimestamp(new Date),i=M[t].padEnd(5),_=r.padEnd(6),a="";n?.correlationId?a=`[${n.correlationId}] `:n?.sessionId&&(a=`[session-${n.sessionId}] `);let l="";o!=null&&(o instanceof Error?l=this.getLevel()===0?`
 ${o.message}
 ${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?l=`
-`+JSON.stringify(o,null,2):l=" "+this.formatData(o));let S="";if(n){let{sessionId:U,memorySessionId:tt,correlationId:et,...R}=n;Object.keys(R).length>0&&(S=` {${Object.entries(R).map(([P,w])=>`${P}=${w}`).join(", ")}}`)}let D=`[${E}] [${i}] [${_}] ${a}${e}${S}${l}`;if(this.logFilePath)try{b(this.logFilePath,D+`
+`+JSON.stringify(o,null,2):l=" "+this.formatData(o));let O="";if(n){let{sessionId:U,memorySessionId:Z,correlationId:tt,...R}=n;Object.keys(R).length>0&&(O=` {${Object.entries(R).map(([k,P])=>`${k}=${P}`).join(", ")}}`)}let D=`[${E}] [${i}] [${_}] ${a}${e}${O}${l}`;if(this.logFilePath)try{W(this.logFilePath,D+`
 `,"utf8")}catch(U){process.stderr.write(`[LOGGER] Failed to write to log file: ${U}
 `)}else process.stderr.write(D+`
 `)}debug(t,r,e,n){this.log(0,t,r,e,n)}info(t,r,e,n){this.log(1,t,r,e,n)}warn(t,r,e,n){this.log(2,t,r,e,n)}error(t,r,e,n){this.log(3,t,r,e,n)}dataIn(t,r,e,n){this.info(t,`\u2192 ${r}`,e,n)}dataOut(t,r,e,n){this.info(t,`\u2190 ${r}`,e,n)}success(t,r,e,n){this.info(t,`\u2713 ${r}`,e,n)}failure(t,r,e,n){this.error(t,`\u2717 ${r}`,e,n)}timing(t,r,e,n){this.info(t,`\u23F1 ${r}`,n,{duration:`${e}ms`})}happyPathError(t,r,e,n,o=""){let a=((new Error().stack||"").split(`
-`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),l=a?`${a[1].split("/").pop()}:${a[2]}`:"unknown",S={...e,location:l};return this.warn(t,`[HAPPY-PATH] ${r}`,S,n),o}},g=new A;import L from"path";import{homedir as X}from"os";import{readFileSync as V}from"fs";var u={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function I(s){return process.platform==="win32"?Math.round(s*u.WINDOWS_MULTIPLIER):s}function N(s={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=s,o=e||"Worker service connection failed.",E=t?` (port ${t})`:"",i=`${o}${E}
+`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),l=a?`${a[1].split("/").pop()}:${a[2]}`:"unknown",O={...e,location:l};return this.warn(t,`[HAPPY-PATH] ${r}`,O,n),o}},c=new p;import L from"path";import{homedir as K}from"os";import{readFileSync as X}from"fs";var A={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5};function I(s){return process.platform==="win32"?Math.round(s*A.WINDOWS_MULTIPLIER):s}function N(s={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=s,o=e||"Worker service connection failed.",E=t?` (port ${t})`:"",i=`${o}${E}
 
 `;return i+=`To restart the worker:
 `,i+=`1. Exit Claude Code completely
@@ -16,8 +16,8 @@ ${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?l=`
 
 If that doesn't work, try: /troubleshoot`),n&&(i=`Worker Error: ${n}
 
-${i}`),i}var j=L.join(X(),".claude","plugins","marketplaces","thedotmack"),y=I(u.HEALTH_CHECK),T=null;function O(){if(T!==null)return T;let s=L.join(c.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=c.loadFromFile(s);return T=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),T}async function B(){let s=O();return(await fetch(`http://127.0.0.1:${s}/api/readiness`,{signal:AbortSignal.timeout(y)})).ok}function Y(){let s=L.join(j,"package.json");return JSON.parse(V(s,"utf-8")).version}async function J(){let s=O(),t=await fetch(`http://127.0.0.1:${s}/api/version`,{signal:AbortSignal.timeout(y)});if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function q(){let s=Y(),t=await J();s!==t&&g.warn("SYSTEM","Worker version mismatch",{pluginVersion:s,workerVersion:t,hint:"Restart worker with: claude-mem worker restart"})}async function $(){for(let r=0;r<25;r++){try{if(await B()){await q();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(N({port:O(),customPrefix:"Worker did not become ready within 5 seconds."}))}import{readFileSync as z,existsSync as Q}from"fs";function m(s,t,r=!1){if(!s||!Q(s))throw new Error(`Transcript path missing or file does not exist: ${s}`);let e=z(s,"utf-8").trim();if(!e)throw new Error(`Transcript file exists but is empty: ${s}`);let n=e.split(`
+${i}`),i}var V=L.join(K(),".claude","plugins","marketplaces","thedotmack"),Ct=I(A.HEALTH_CHECK),S=null;function u(){if(S!==null)return S;let s=L.join(g.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=g.loadFromFile(s);return S=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),S}async function j(){let s=u();return(await fetch(`http://127.0.0.1:${s}/api/readiness`)).ok}function B(){let s=L.join(V,"package.json");return JSON.parse(X(s,"utf-8")).version}async function Y(){let s=u(),t=await fetch(`http://127.0.0.1:${s}/api/version`);if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function J(){let s=B(),t=await Y();s!==t&&c.debug("SYSTEM","Version check",{pluginVersion:s,workerVersion:t,note:"Mismatch will be auto-restarted by worker-service start command"})}async function y(){for(let r=0;r<75;r++){try{if(await j()){await J();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(N({port:u(),customPrefix:"Worker did not become ready within 15 seconds."}))}import{readFileSync as q,existsSync as z}from"fs";function m(s,t,r=!1){if(!s||!z(s))throw new Error(`Transcript path missing or file does not exist: ${s}`);let e=q(s,"utf-8").trim();if(!e)throw new Error(`Transcript file exists but is empty: ${s}`);let n=e.split(`
 `),o=!1;for(let E=n.length-1;E>=0;E--){let i=JSON.parse(n[E]);if(i.type===t&&(o=!0,i.message?.content)){let _="",a=i.message.content;if(typeof a=="string")_=a;else if(Array.isArray(a))_=a.filter(l=>l.type==="text").map(l=>l.text).join(`
 `);else throw new Error(`Unknown message content format in transcript. Type: ${typeof a}`);return r&&(_=_.replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g,""),_=_.replace(/\n{3,}/g,`
 
-`).trim()),_}}if(!o)throw new Error(`No message found for role '${t}' in transcript: ${s}`);return""}async function Z(s){if(await $(),!s)throw new Error("summaryHook requires input");let{session_id:t}=s,r=O();if(!s.transcript_path)throw new Error(`Missing transcript_path in Stop hook input for session ${t}`);let e=m(s.transcript_path,"user"),n=m(s.transcript_path,"assistant",!0);g.dataIn("HOOK","Stop: Requesting summary",{workerPort:r,hasLastUserMessage:!!e,hasLastAssistantMessage:!!n});let o=await fetch(`http://127.0.0.1:${r}/api/sessions/summarize`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({contentSessionId:t,last_user_message:e,last_assistant_message:n}),signal:AbortSignal.timeout(u.DEFAULT)});if(!o.ok)throw console.log(f),new Error(`Summary generation failed: ${o.status}`);g.debug("HOOK","Summary request sent successfully"),console.log(f)}var C="";k.on("data",s=>C+=s);k.on("end",async()=>{let s;try{s=C?JSON.parse(C):void 0}catch(t){throw new Error(`Failed to parse hook input: ${t instanceof Error?t.message:String(t)}`)}await Z(s)});
+`).trim()),_}}if(!o)throw new Error(`No message found for role '${t}' in transcript: ${s}`);return""}async function Q(s){if(await y(),!s)throw new Error("summaryHook requires input");let{session_id:t}=s,r=u();if(!s.transcript_path)throw new Error(`Missing transcript_path in Stop hook input for session ${t}`);let e=m(s.transcript_path,"user"),n=m(s.transcript_path,"assistant",!0);c.dataIn("HOOK","Stop: Requesting summary",{workerPort:r,hasLastUserMessage:!!e,hasLastAssistantMessage:!!n});let o=await fetch(`http://127.0.0.1:${r}/api/sessions/summarize`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({contentSessionId:t,last_user_message:e,last_assistant_message:n})});if(!o.ok)throw console.log(f),new Error(`Summary generation failed: ${o.status}`);c.debug("HOOK","Summary request sent successfully"),console.log(f)}var C="";$.on("data",s=>C+=s);$.on("end",async()=>{let s;try{s=C?JSON.parse(C):void 0}catch(t){throw new Error(`Failed to parse hook input: ${t instanceof Error?t.message:String(t)}`)}await Q(s)});

plugin/scripts/user-message-hook.js

@@ -1,30 +1,30 @@
 #!/usr/bin/env bun
-import{basename as z}from"path";import L from"path";import{homedir as K}from"os";import{readFileSync as X}from"fs";import{readFileSync as v,writeFileSync as F,existsSync as w}from"fs";import{join as W}from"path";import{homedir as b}from"os";var U="bugfix,feature,refactor,discovery,decision,change",R="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var _=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:W(b(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:U,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:R,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!w(t))return this.getAllDefaults();let r=v(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{F(t,JSON.stringify(n,null,2),"utf-8"),c.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(E){c.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},E)}}let o={...this.DEFAULTS};for(let E of Object.keys(this.DEFAULTS))n[E]!==void 0&&(o[E]=n[E]);return o}catch(r){return c.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as x,existsSync as G,mkdirSync as H}from"fs";import{join as O}from"path";var S=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(S||{}),p=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=_.get("CLAUDE_MEM_DATA_DIR"),r=O(t,"logs");G(r)||H(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=O(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=_.get("CLAUDE_MEM_DATA_DIR"),r=O(t,"settings.json"),n=_.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=S[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
-${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),E=String(t.getMinutes()).padStart(2,"0"),s=String(t.getSeconds()).padStart(2,"0"),T=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${E}:${s}.${T}`}log(t,r,e,n,o){if(t<this.getLevel())return;let E=this.formatTimestamp(new Date),s=S[t].padEnd(5),T=r.padEnd(6),a="";n?.correlationId?a=`[${n.correlationId}] `:n?.sessionId&&(a=`[session-${n.sessionId}] `);let l="";o!=null&&(o instanceof Error?l=this.getLevel()===0?`
+import{basename as J}from"path";import f from"path";import{homedir as H}from"os";import{readFileSync as K}from"fs";import{readFileSync as k,writeFileSync as v,existsSync as F}from"fs";import{join as w}from"path";import{homedir as W}from"os";var U="bugfix,feature,refactor,discovery,decision,change",R="how-it-works,why-it-exists,what-changed,problem-solution,gotcha,pattern,trade-off";var _=class{static DEFAULTS={CLAUDE_MEM_MODEL:"claude-sonnet-4-5",CLAUDE_MEM_CONTEXT_OBSERVATIONS:"50",CLAUDE_MEM_WORKER_PORT:"37777",CLAUDE_MEM_WORKER_HOST:"127.0.0.1",CLAUDE_MEM_SKIP_TOOLS:"ListMcpResourcesTool,SlashCommand,Skill,TodoWrite,AskUserQuestion",CLAUDE_MEM_PROVIDER:"claude",CLAUDE_MEM_GEMINI_API_KEY:"",CLAUDE_MEM_GEMINI_MODEL:"gemini-2.5-flash-lite",CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED:"true",CLAUDE_MEM_OPENROUTER_API_KEY:"",CLAUDE_MEM_OPENROUTER_MODEL:"xiaomi/mimo-v2-flash:free",CLAUDE_MEM_OPENROUTER_SITE_URL:"",CLAUDE_MEM_OPENROUTER_APP_NAME:"claude-mem",CLAUDE_MEM_OPENROUTER_MAX_CONTEXT_MESSAGES:"20",CLAUDE_MEM_OPENROUTER_MAX_TOKENS:"100000",CLAUDE_MEM_DATA_DIR:w(W(),".claude-mem"),CLAUDE_MEM_LOG_LEVEL:"INFO",CLAUDE_MEM_PYTHON_VERSION:"3.13",CLAUDE_CODE_PATH:"",CLAUDE_MEM_MODE:"code",CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT:"true",CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_PERCENT:"true",CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES:U,CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS:R,CLAUDE_MEM_CONTEXT_FULL_COUNT:"5",CLAUDE_MEM_CONTEXT_FULL_FIELD:"narrative",CLAUDE_MEM_CONTEXT_SESSION_COUNT:"10",CLAUDE_MEM_CONTEXT_SHOW_LAST_SUMMARY:"true",CLAUDE_MEM_CONTEXT_SHOW_LAST_MESSAGE:"false"};static getAllDefaults(){return{...this.DEFAULTS}}static get(t){return this.DEFAULTS[t]}static getInt(t){let r=this.get(t);return parseInt(r,10)}static getBool(t){return this.get(t)==="true"}static loadFromFile(t){try{if(!F(t))return this.getAllDefaults();let r=k(t,"utf-8"),e=JSON.parse(r),n=e;if(e.env&&typeof e.env=="object"){n=e.env;try{v(t,JSON.stringify(n,null,2),"utf-8"),c.info("SETTINGS","Migrated settings file from nested to flat schema",{settingsPath:t})}catch(E){c.warn("SETTINGS","Failed to auto-migrate settings file",{settingsPath:t},E)}}let o={...this.DEFAULTS};for(let E of Object.keys(this.DEFAULTS))n[E]!==void 0&&(o[E]=n[E]);return o}catch(r){return c.warn("SETTINGS","Failed to load settings, using defaults",{settingsPath:t},r),this.getAllDefaults()}}};import{appendFileSync as b,existsSync as x,mkdirSync as G}from"fs";import{join as O}from"path";var S=(o=>(o[o.DEBUG=0]="DEBUG",o[o.INFO=1]="INFO",o[o.WARN=2]="WARN",o[o.ERROR=3]="ERROR",o[o.SILENT=4]="SILENT",o))(S||{}),p=class{level=null;useColor;logFilePath=null;constructor(){this.useColor=process.stdout.isTTY??!1,this.initializeLogFile()}initializeLogFile(){try{let t=_.get("CLAUDE_MEM_DATA_DIR"),r=O(t,"logs");x(r)||G(r,{recursive:!0});let e=new Date().toISOString().split("T")[0];this.logFilePath=O(r,`claude-mem-${e}.log`)}catch(t){console.error("[LOGGER] Failed to initialize log file:",t),this.logFilePath=null}}getLevel(){if(this.level===null)try{let t=_.get("CLAUDE_MEM_DATA_DIR"),r=O(t,"settings.json"),n=_.loadFromFile(r).CLAUDE_MEM_LOG_LEVEL.toUpperCase();this.level=S[n]??1}catch(t){console.error("[LOGGER] Failed to load settings, using INFO level:",t),this.level=1}return this.level}correlationId(t,r){return`obs-${t}-${r}`}sessionId(t){return`session-${t}`}formatData(t){if(t==null)return"";if(typeof t=="string")return t;if(typeof t=="number"||typeof t=="boolean")return t.toString();if(typeof t=="object"){if(t instanceof Error)return this.getLevel()===0?`${t.message}
+${t.stack}`:t.message;if(Array.isArray(t))return`[${t.length} items]`;let r=Object.keys(t);return r.length===0?"{}":r.length<=3?JSON.stringify(t):`{${r.length} keys: ${r.slice(0,3).join(", ")}...}`}return String(t)}formatTool(t,r){if(!r)return t;let e=typeof r=="string"?JSON.parse(r):r;if(t==="Bash"&&e.command)return`${t}(${e.command})`;if(e.file_path)return`${t}(${e.file_path})`;if(e.notebook_path)return`${t}(${e.notebook_path})`;if(t==="Glob"&&e.pattern)return`${t}(${e.pattern})`;if(t==="Grep"&&e.pattern)return`${t}(${e.pattern})`;if(e.url)return`${t}(${e.url})`;if(e.query)return`${t}(${e.query})`;if(t==="Task"){if(e.subagent_type)return`${t}(${e.subagent_type})`;if(e.description)return`${t}(${e.description})`}return t==="Skill"&&e.skill?`${t}(${e.skill})`:t==="LSP"&&e.operation?`${t}(${e.operation})`:t}formatTimestamp(t){let r=t.getFullYear(),e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0"),o=String(t.getHours()).padStart(2,"0"),E=String(t.getMinutes()).padStart(2,"0"),i=String(t.getSeconds()).padStart(2,"0"),T=String(t.getMilliseconds()).padStart(3,"0");return`${r}-${e}-${n} ${o}:${E}:${i}.${T}`}log(t,r,e,n,o){if(t<this.getLevel())return;let E=this.formatTimestamp(new Date),i=S[t].padEnd(5),T=r.padEnd(6),a="";n?.correlationId?a=`[${n.correlationId}] `:n?.sessionId&&(a=`[session-${n.sessionId}] `);let l="";o!=null&&(o instanceof Error?l=this.getLevel()===0?`
 ${o.message}
 ${o.stack}`:` ${o.message}`:this.getLevel()===0&&typeof o=="object"?l=`
-`+JSON.stringify(o,null,2):l=" "+this.formatData(o));let u="";if(n){let{sessionId:D,memorySessionId:Z,correlationId:tt,...m}=n;Object.keys(m).length>0&&(u=` {${Object.entries(m).map(([P,k])=>`${P}=${k}`).join(", ")}}`)}let C=`[${E}] [${s}] [${T}] ${a}${e}${u}${l}`;if(this.logFilePath)try{x(this.logFilePath,C+`
+`+JSON.stringify(o,null,2):l=" "+this.formatData(o));let u="";if(n){let{sessionId:D,memorySessionId:Q,correlationId:Z,...m}=n;Object.keys(m).length>0&&(u=` {${Object.entries(m).map(([$,P])=>`${$}=${P}`).join(", ")}}`)}let C=`[${E}] [${i}] [${T}] ${a}${e}${u}${l}`;if(this.logFilePath)try{b(this.logFilePath,C+`
 `,"utf8")}catch(D){process.stderr.write(`[LOGGER] Failed to write to log file: ${D}
 `)}else process.stderr.write(C+`
 `)}debug(t,r,e,n){this.log(0,t,r,e,n)}info(t,r,e,n){this.log(1,t,r,e,n)}warn(t,r,e,n){this.log(2,t,r,e,n)}error(t,r,e,n){this.log(3,t,r,e,n)}dataIn(t,r,e,n){this.info(t,`\u2192 ${r}`,e,n)}dataOut(t,r,e,n){this.info(t,`\u2190 ${r}`,e,n)}success(t,r,e,n){this.info(t,`\u2713 ${r}`,e,n)}failure(t,r,e,n){this.error(t,`\u2717 ${r}`,e,n)}timing(t,r,e,n){this.info(t,`\u23F1 ${r}`,n,{duration:`${e}ms`})}happyPathError(t,r,e,n,o=""){let a=((new Error().stack||"").split(`
-`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),l=a?`${a[1].split("/").pop()}:${a[2]}`:"unknown",u={...e,location:l};return this.warn(t,`[HAPPY-PATH] ${r}`,u,n),o}},c=new p;var A={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5},h={SUCCESS:0,FAILURE:1,USER_MESSAGE_ONLY:3};function I(i){return process.platform==="win32"?Math.round(i*A.WINDOWS_MULTIPLIER):i}function N(i={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=i,o=e||"Worker service connection failed.",E=t?` (port ${t})`:"",s=`${o}${E}
+`)[2]||"").match(/at\s+(?:.*\s+)?\(?([^:]+):(\d+):(\d+)\)?/),l=a?`${a[1].split("/").pop()}:${a[2]}`:"unknown",u={...e,location:l};return this.warn(t,`[HAPPY-PATH] ${r}`,u,n),o}},c=new p;var L={DEFAULT:3e5,HEALTH_CHECK:3e4,WORKER_STARTUP_WAIT:1e3,WORKER_STARTUP_RETRIES:300,PRE_RESTART_SETTLE_DELAY:2e3,WINDOWS_MULTIPLIER:1.5},h={SUCCESS:0,FAILURE:1,USER_MESSAGE_ONLY:3};function I(s){return process.platform==="win32"?Math.round(s*L.WINDOWS_MULTIPLIER):s}function d(s={}){let{port:t,includeSkillFallback:r=!1,customPrefix:e,actualError:n}=s,o=e||"Worker service connection failed.",E=t?` (port ${t})`:"",i=`${o}${E}
 
-`;return s+=`To restart the worker:
-`,s+=`1. Exit Claude Code completely
-`,s+=`2. Run: npm run worker:restart
-`,s+="3. Restart Claude Code",r&&(s+=`
+`;return i+=`To restart the worker:
+`,i+=`1. Exit Claude Code completely
+`,i+=`2. Run: npm run worker:restart
+`,i+="3. Restart Claude Code",r&&(i+=`
 
-If that doesn't work, try: /troubleshoot`),n&&(s=`Worker Error: ${n}
+If that doesn't work, try: /troubleshoot`),n&&(i=`Worker Error: ${n}
 
-${s}`),s}var V=L.join(K(),".claude","plugins","marketplaces","thedotmack"),d=I(A.HEALTH_CHECK),M=null;function g(){if(M!==null)return M;let i=L.join(_.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=_.loadFromFile(i);return M=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),M}async function j(){let i=g();return(await fetch(`http://127.0.0.1:${i}/api/readiness`,{signal:AbortSignal.timeout(d)})).ok}function B(){let i=L.join(V,"package.json");return JSON.parse(X(i,"utf-8")).version}async function Y(){let i=g(),t=await fetch(`http://127.0.0.1:${i}/api/version`,{signal:AbortSignal.timeout(d)});if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function J(){let i=B(),t=await Y();i!==t&&c.warn("SYSTEM","Worker version mismatch",{pluginVersion:i,workerVersion:t,hint:"Restart worker with: claude-mem worker restart"})}async function y(){for(let r=0;r<25;r++){try{if(await j()){await J();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(N({port:g(),customPrefix:"Worker did not become ready within 5 seconds."}))}await y();var $=g(),q=z(process.cwd()),f=await fetch(`http://127.0.0.1:${$}/api/context/inject?project=${encodeURIComponent(q)}&colors=true`,{method:"GET",signal:AbortSignal.timeout(5e3)});if(!f.ok)throw new Error(`Failed to fetch context: ${f.status}`);var Q=await f.text();console.error(`
+${i}`),i}var X=f.join(H(),".claude","plugins","marketplaces","thedotmack"),At=I(L.HEALTH_CHECK),M=null;function g(){if(M!==null)return M;let s=f.join(_.get("CLAUDE_MEM_DATA_DIR"),"settings.json"),t=_.loadFromFile(s);return M=parseInt(t.CLAUDE_MEM_WORKER_PORT,10),M}async function V(){let s=g();return(await fetch(`http://127.0.0.1:${s}/api/readiness`)).ok}function j(){let s=f.join(X,"package.json");return JSON.parse(K(s,"utf-8")).version}async function B(){let s=g(),t=await fetch(`http://127.0.0.1:${s}/api/version`);if(!t.ok)throw new Error(`Failed to get worker version: ${t.status}`);return(await t.json()).version}async function Y(){let s=j(),t=await B();s!==t&&c.debug("SYSTEM","Version check",{pluginVersion:s,workerVersion:t,note:"Mismatch will be auto-restarted by worker-service start command"})}async function N(){for(let r=0;r<75;r++){try{if(await V()){await Y();return}}catch{}await new Promise(e=>setTimeout(e,200))}throw new Error(d({port:g(),customPrefix:"Worker did not become ready within 15 seconds."}))}await N();var y=g(),z=J(process.cwd()),A=await fetch(`http://127.0.0.1:${y}/api/context/inject?project=${encodeURIComponent(z)}&colors=true`,{method:"GET"});if(!A.ok)throw new Error(`Failed to fetch context: ${A.status}`);var q=await A.text();console.error(`
 
 \u{1F4DD} Claude-Mem Context Loaded
    \u2139\uFE0F  Note: This appears as stderr but is informational only
 
-`+Q+`
+`+q+`
 
 \u{1F4A1} New! Wrap all or part of any message with <private> ... </private> to prevent storing sensitive information in your observation history.
 
 \u{1F4AC} Community https://discord.gg/J4wttp9vDu
-\u{1F4FA} Watch live in browser http://localhost:${$}/
+\u{1F4FA} Watch live in browser http://localhost:${y}/
 `);process.exit(h.USER_MESSAGE_ONLY);

plugin/skills/mem-search/SKILL.md

@@ -1,329 +0,0 @@
----
-name: mem-search
-description: Search claude-mem's persistent cross-session memory database. Use when user asks "did we already solve this?", "how did we do X last time?", or needs work from previous sessions.
----
-
-# Memory Search
-
-Search past work across all sessions. Simple workflow: search → get IDs → fetch details by ID.
-
-## When to Use
-
-Use when users ask about PREVIOUS sessions (not current conversation):
-
-- "Did we already fix this?"
-- "How did we solve X last time?"
-- "What happened last week?"
-
-## The Workflow
-
-**ALWAYS follow this exact flow:**
-
-1. **Search** - Get an index of results with IDs
-2. **Timeline** - Get context around top results to understand what was happening
-3. **Review** - Look at titles/dates/context, pick relevant IDs
-4. **Fetch** - Get full details ONLY for those IDs
-
-### Step 1: Search Everything
-
-Use the `search` MCP tool:
-
-**Required parameters:**
-
-- `query` - Search term
-- `limit: 20` - You can request large indexes as necessary
-- `project` - Project name (required)
-
-**Example:**
-
-```
-search(query="authentication", limit=20, project="my-project")
-```
-
-**Returns:**
-
-```
-| ID | Time | T | Title | Read | Work |
-|----|------|---|-------|------|------|
-| #11131 | 3:48 PM | 🟣 | Added JWT authentication | ~75 | 🛠️ 450 |
-| #10942 | 2:15 PM | 🔴 | Fixed auth token expiration | ~50 | 🛠️ 200 |
-```
-
-### Step 2: Get Timeline Context
-
-You MUST understand "what was happening" around a result.
-
-Use the `timeline` MCP tool:
-
-**Example with observation ID:**
-
-```
-timeline(anchor=11131, depth_before=3, depth_after=3, project="my-project")
-```
-
-**Example with query (finds anchor automatically):**
-
-```
-timeline(query="authentication", depth_before=3, depth_after=3, project="my-project")
-```
-
-**Returns exactly `depth_before + 1 + depth_after` items** - observations, sessions, and prompts interleaved chronologically around the anchor.
-
-**When to use:**
-
-- User asks "what was happening when..."
-- Need to understand sequence of events
-- Want broader context around a specific observation
-
-### Step 3: Pick IDs
-
-Review the index results (and timeline if used). Identify which IDs are actually relevant. Discard the rest.
-
-### Step 4: Fetch by ID
-
-For each relevant ID, fetch full details using MCP tools:
-
-**Fetch multiple observations (ALWAYS use for 2+ IDs):**
-
-```
-get_observations(ids=[11131, 10942, 10855])
-```
-
-**With ordering and limit:**
-
-```
-get_observations(
-  ids=[11131, 10942, 10855],
-  orderBy="date_desc",
-  limit=10,
-  project="my-project"
-)
-```
-
-**Fetch single observation (only when fetching exactly 1):**
-
-```
-get_observation(id=11131)
-```
-
-**Fetch session:**
-
-```
-get_session(id=2005)  # Just the number from S2005
-```
-
-**Fetch prompt:**
-
-```
-get_prompt(id=5421)
-```
-
-**ID formats:**
-
-- Observations: Just the number (11131)
-- Sessions: Just the number (2005) from "S2005"
-- Prompts: Just the number (5421)
-
-**Batch optimization:**
-
-- **ALWAYS use `get_observations` for 2+ observations**
-- 10-100x more efficient than individual fetches
-- Single HTTP request vs N requests
-- Returns all results in one response
-- Supports ordering and filtering
-
-## Search Parameters
-
-**Basic:**
-
-- `query` - What to search for (required)
-- `limit` - How many results (default 20)
-- `project` - Filter by project name (required)
-
-**Filters (optional):**
-
-- `type` - Filter to "observations", "sessions", or "prompts"
-- `dateStart` - Start date (YYYY-MM-DD or epoch timestamp)
-- `dateEnd` - End date (YYYY-MM-DD or epoch timestamp)
-- `obs_type` - Filter observations by type (comma-separated): bugfix, feature, decision, discovery, change
-
-## Examples
-
-**Find recent bug fixes:**
-
-Use the `search` MCP tool with filters:
-
-```
-search(query="bug", type="observations", obs_type="bugfix", limit=20, project="my-project")
-```
-
-**Find what happened last week:**
-
-Use date filters:
-
-```
-search(type="observations", dateStart="2025-11-11", limit=20, project="my-project")
-```
-
-**Search everything:**
-
-Simple query search:
-
-```
-search(query="database migration", limit=20, project="my-project")
-```
-
-**Get detailed instructions:**
-
-Use the `help` tool to load full instructions on-demand:
-
-```
-help(topic="workflow")  # Get 4-step workflow
-help(topic="search_params")  # Get parameters reference
-help(topic="examples")  # Get usage examples
-help(topic="all")  # Get complete guide
-```
-
-## Why This Workflow?
-
-**Token efficiency:**
-
-- **Search results:** ~50-100 tokens per result (table index)
-- **Full observation:** ~500-1000 tokens each
-- **10x savings** - only fetch full when you know it's relevant
-
-**Batch fetching:**
-
-- **Individual fetches:** 10 HTTP requests, ~5-10s latency
-- **Batch fetch:** 1 HTTP request, ~0.5-1s latency
-- **10-100x faster** for multi-observation queries
-
-**Clarity:**
-
-- See everything first (table index)
-- Get timeline context around interesting results
-- Pick what matters based on context
-- Fetch details only for what you need (batch when possible)
-
----
-
-**Remember:**
-
-- ALWAYS get timeline context to understand what was happening
-- ALWAYS use `get_observations` when fetching 2+ observations
-- The workflow is optimized: search → timeline → batch fetch = 10-100x faster
-
----
-
-## Tool Reference
-
-Comprehensive parameter documentation for all memory tools. For MCP usage, call `help(topic="search")` to load specific tool docs.
-
-### search
-
-Search across all memory types (observations, sessions, prompts).
-
-**Parameters:**
-
-- `query` (string, optional) - Search term for full-text search
-- `limit` (number, optional) - Maximum results to return. Default: 20, Max: 100
-- `offset` (number, optional) - Number of results to skip. Default: 0
-- `project` (string, required) - Project name to filter by
-- `type` (string, optional) - Filter by type: "observations", "sessions", "prompts"
-- `dateStart` (string, optional) - Start date filter (YYYY-MM-DD or epoch ms)
-- `dateEnd` (string, optional) - End date filter (YYYY-MM-DD or epoch ms)
-- `obs_type` (string, optional) - Filter observations by type (comma-separated): bugfix, feature, decision, discovery, change
-- `orderBy` (string, optional) - Sort order: "date_desc" (default), "date_asc", "relevance"
-
-**Returns:** Table of results with IDs, timestamps, types, titles
-
-### timeline
-
-Get chronological context around a specific point in time or observation.
-
-**Parameters:**
-
-- `anchor` (number, optional) - Observation ID to center timeline around. If not provided, uses most recent result from query
-- `query` (string, optional) - Search term to find anchor automatically (if anchor not provided)
-- `depth_before` (number, optional) - Items before anchor. Default: 5, Max: 20
-- `depth_after` (number, optional) - Items after anchor. Default: 5, Max: 20
-- `project` (string, required) - Project name to filter by
-
-**Returns:** Exactly `depth_before + 1 + depth_after` items in chronological order, with observations, sessions, and prompts interleaved
-
-### get_recent_context
-
-Get the most recent observations from current or recent sessions.
-
-**Parameters:**
-
-- `limit` (number, optional) - Maximum observations to return. Default: 10, Max: 50
-- `project` (string, required) - Project name to filter by
-
-**Returns:** Recent observations in reverse chronological order
-
-### get_context_timeline
-
-Get timeline context around a specific observation ID.
-
-**Parameters:**
-
-- `anchor` (number, required) - Observation ID to center timeline around
-- `depth_before` (number, optional) - Items before anchor. Default: 5, Max: 20
-- `depth_after` (number, optional) - Items after anchor. Default: 5, Max: 20
-- `project` (string, optional) - Project name to filter by
-
-**Returns:** Timeline items centered on the anchor observation
-
-### get_observation
-
-Fetch a single observation by ID with full details.
-
-**Parameters:**
-
-- `id` (number, required) - Observation ID to fetch
-
-**Returns:** Complete observation object with title, subtitle, narrative, facts, concepts, files, timestamps
-
-### get_observations
-
-Batch fetch multiple observations by IDs. Always prefer this over individual fetches for 2+ observations.
-
-**Parameters:**
-
-- `ids` (array of numbers, required) - Array of observation IDs to fetch
-- `orderBy` (string, optional) - Sort order: "date_desc" (default), "date_asc"
-- `limit` (number, optional) - Maximum observations to return. Default: no limit
-- `project` (string, optional) - Project name to filter by
-
-**Returns:** Array of complete observation objects, 10-100x faster than individual fetches
-
-### get_session
-
-Fetch a single session by ID with metadata.
-
-**Parameters:**
-
-- `id` (number, required) - Session ID to fetch (just the number, not "S2005" format)
-
-**Returns:** Session object with ID, start time, end time, project, model info
-
-### get_prompt
-
-Fetch a single prompt by ID with full text.
-
-**Parameters:**
-
-- `id` (number, required) - Prompt ID to fetch
-
-**Returns:** Prompt object with ID, text, timestamp, session reference
-
-### help
-
-Load detailed instructions for specific topics or all documentation.
-
-**Parameters:**
-
-- `topic` (string, optional) - Specific topic to load: "workflow", "search", "timeline", "get_recent_context", "get_context_timeline", "get_observation", "get_observations", "get_session", "get_prompt", "all". Default: "all"
-
-**Returns:** Formatted documentation for the requested topic

plugin/skills/mem-search/operations/by-concept.md

@@ -1,124 +0,0 @@
-# Search by Concept
-
-Find observations tagged with specific concepts.
-
-## When to Use
-
-- User asks: "What discoveries did we make?"
-- User asks: "What patterns did we identify?"
-- User asks: "What gotchas did we encounter?"
-- Looking for observations with semantic tags
-
-## Command
-
-```bash
-curl -s "http://localhost:37777/api/search/by-concept?concept=discovery&format=index&limit=5"
-```
-
-## Parameters
-
-- **concept** (required): Concept tag to search for
-  - `discovery` - New discoveries and insights
-  - `problem-solution` - Problems and their solutions
-  - `what-changed` - Change descriptions
-  - `how-it-works` - Explanations of mechanisms
-  - `pattern` - Identified patterns
-  - `gotcha` - Edge cases and gotchas
-  - `change` - General changes
-- **format**: "index" (summary) or "full" (complete details). Default: "full"
-- **limit**: Number of results (default: 20, max: 100)
-- **project**: Filter by project name (optional)
-- **dateStart/dateEnd**: Filter by date range (optional)
-
-## When to Use Each Format
-
-**Use format=index for:**
-- Quick overviews of observations by concept
-- Finding IDs for deeper investigation
-- Listing multiple results
-- **Token cost: ~50-100 per result**
-
-**Use format=full for:**
-- Complete details including narrative, facts, files, concepts
-- Understanding the full context of specific observations
-- **Token cost: ~500-1000 per result**
-
-## Example Response (format=index)
-
-```json
-{
-  "concept": "discovery",
-  "count": 3,
-  "format": "index",
-  "results": [
-    {
-      "id": 1240,
-      "type": "discovery",
-      "title": "Worker service uses PM2 for process management",
-      "subtitle": "Discovered persistent background worker pattern",
-      "created_at_epoch": 1699564800000,
-      "project": "claude-mem",
-      "concepts": ["discovery", "how-it-works"]
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-For format=index, present as a compact list:
-
-```markdown
-Found 3 observations tagged with "discovery":
-
-🔵 **#1240** Worker service uses PM2 for process management
-   > Discovered persistent background worker pattern
-   > Nov 9, 2024 • claude-mem
-   > Tags: discovery, how-it-works
-
-🔵 **#1241** FTS5 full-text search enables instant searches
-   > SQLite FTS5 virtual tables provide sub-100ms search
-   > Nov 9, 2024 • claude-mem
-   > Tags: discovery, pattern
-```
-
-For complete formatting guidelines, see [formatting.md](formatting.md).
-
-## Available Concepts
-
-| Concept | Description | When to Use |
-|---------|-------------|-------------|
-| `discovery` | New discoveries and insights | Finding what was learned |
-| `problem-solution` | Problems and their solutions | Finding how issues were resolved |
-| `what-changed` | Change descriptions | Understanding what changed |
-| `how-it-works` | Explanations of mechanisms | Learning how things work |
-| `pattern` | Identified patterns | Finding design patterns |
-| `gotcha` | Edge cases and gotchas | Learning about pitfalls |
-| `change` | General changes | Tracking modifications |
-
-## Error Handling
-
-**Missing concept parameter:**
-```json
-{"error": "Missing required parameter: concept"}
-```
-Fix: Add the concept parameter
-
-**Invalid concept:**
-```json
-{"error": "Invalid concept: foobar. Valid concepts: discovery, problem-solution, what-changed, how-it-works, pattern, gotcha, change"}
-```
-Fix: Use one of the valid concept values
-
-## Tips
-
-1. Use format=index first to see overview
-2. Start with limit=5-10 to avoid token overload
-3. Combine concepts with type filtering for precision
-4. Use `discovery` for learning what was found during investigation
-5. Use `problem-solution` for finding how past issues were resolved
-
-**Token Efficiency:**
-- Start with format=index (~50-100 tokens per result)
-- Use format=full only for relevant items (~500-1000 tokens per result)
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)

plugin/skills/mem-search/operations/by-file.md

@@ -1,127 +0,0 @@
-# Search by File
-
-Find all work related to a specific file path.
-
-## When to Use
-
-- User asks: "What changes to auth/login.ts?"
-- User asks: "What work was done on this file?"
-- User asks: "Show me the history of src/services/worker.ts"
-- Looking for all observations that reference a file
-
-## Command
-
-```bash
-curl -s "http://localhost:37777/api/search/by-file?filePath=src/services/worker-service.ts&format=index&limit=10"
-```
-
-## Parameters
-
-- **filePath** (required): File path to search for (supports partial matching)
-  - Full path: `src/services/worker-service.ts`
-  - Partial path: `worker-service.ts`
-  - Directory: `src/hooks/`
-- **format**: "index" (summary) or "full" (complete details). Default: "full"
-- **limit**: Number of results (default: 20, max: 100)
-- **project**: Filter by project name (optional)
-- **dateStart/dateEnd**: Filter by date range (optional)
-
-## When to Use Each Format
-
-**Use format=index for:**
-- Quick overviews of work on a file
-- Finding IDs for deeper investigation
-- Listing multiple changes
-- **Token cost: ~50-100 per result**
-
-**Use format=full for:**
-- Complete details including narrative, facts, files, concepts
-- Understanding the full context of specific changes
-- **Token cost: ~500-1000 per result**
-
-## Example Response (format=index)
-
-```json
-{
-  "filePath": "src/services/worker-service.ts",
-  "count": 8,
-  "format": "index",
-  "results": [
-    {
-      "id": 1245,
-      "type": "refactor",
-      "title": "Simplified worker health check logic",
-      "subtitle": "Removed redundant PM2 status check",
-      "created_at_epoch": 1699564800000,
-      "project": "claude-mem",
-      "files": ["src/services/worker-service.ts", "src/services/worker-utils.ts"]
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-For format=index, present as a compact list:
-
-```markdown
-Found 8 observations related to "src/services/worker-service.ts":
-
-🔄 **#1245** Simplified worker health check logic
-   > Removed redundant PM2 status check
-   > Nov 9, 2024 • claude-mem
-   > Files: worker-service.ts, worker-utils.ts
-
-🟣 **#1246** Added SSE endpoint for real-time updates
-   > Implemented Server-Sent Events for viewer UI
-   > Nov 8, 2024 • claude-mem
-   > Files: worker-service.ts
-```
-
-For complete formatting guidelines, see [formatting.md](formatting.md).
-
-## Partial Path Matching
-
-The file path parameter supports partial matching:
-
-```bash
-# These all match "src/services/worker-service.ts"
-curl -s "http://localhost:37777/api/search/by-file?filePath=worker-service.ts&format=index"
-curl -s "http://localhost:37777/api/search/by-file?filePath=services/worker&format=index"
-curl -s "http://localhost:37777/api/search/by-file?filePath=worker-service&format=index"
-```
-
-## Directory Searches
-
-Search for all work in a directory:
-
-```bash
-curl -s "http://localhost:37777/api/search/by-file?filePath=src/hooks/&format=index&limit=20"
-```
-
-## Error Handling
-
-**Missing filePath parameter:**
-```json
-{"error": "Missing required parameter: filePath"}
-```
-Fix: Add the filePath parameter
-
-**No results found:**
-```json
-{"filePath": "nonexistent.ts", "count": 0, "results": []}
-```
-Response: "No observations found for 'nonexistent.ts'. Try a partial path or check the spelling."
-
-## Tips
-
-1. Use format=index first to see overview of all changes
-2. Start with partial paths (e.g., filename only) for broader matches
-3. Use full paths when you need specific file matches
-4. Combine with dateStart to see recent changes: `?filePath=worker.ts&dateStart=2024-11-01`
-5. Use directory searches to see all work in a module
-
-**Token Efficiency:**
-- Start with format=index (~50-100 tokens per result)
-- Use format=full only for relevant items (~500-1000 tokens per result)
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)

plugin/skills/mem-search/operations/by-type.md

@@ -1,123 +0,0 @@
-# Search by Type
-
-Find observations by type: bugfix, feature, refactor, decision, discovery, or change.
-
-## When to Use
-
-- User asks: "What bugs did we fix?"
-- User asks: "What features did we add?"
-- User asks: "What decisions did we make?"
-- Looking for specific types of work
-
-## Command
-
-```bash
-curl -s "http://localhost:37777/api/search/by-type?type=bugfix&format=index&limit=5"
-```
-
-## Parameters
-
-- **type** (required): One or more types (comma-separated)
-  - `bugfix` - Bug fixes
-  - `feature` - New features
-  - `refactor` - Code refactoring
-  - `decision` - Architectural/design decisions
-  - `discovery` - Discoveries and insights
-  - `change` - General changes
-- **format**: "index" (summary) or "full" (complete details). Default: "full"
-- **limit**: Number of results (default: 20, max: 100)
-- **project**: Filter by project name (optional)
-- **dateStart/dateEnd**: Filter by date range (optional)
-
-## When to Use Each Format
-
-**Use format=index for:**
-- Quick overviews of work by type
-- Finding IDs for deeper investigation
-- Listing multiple results
-- **Token cost: ~50-100 per result**
-
-**Use format=full for:**
-- Complete details including narrative, facts, files, concepts
-- Understanding the full context of specific observations
-- **Token cost: ~500-1000 per result**
-
-## Example Response (format=index)
-
-```json
-{
-  "type": "bugfix",
-  "count": 5,
-  "format": "index",
-  "results": [
-    {
-      "id": 1235,
-      "type": "bugfix",
-      "title": "Fixed token expiration edge case",
-      "subtitle": "Handled race condition in refresh flow",
-      "created_at_epoch": 1699564800000,
-      "project": "api-server"
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-For format=index, present as a compact list with type emojis:
-
-```markdown
-Found 5 bugfixes:
-
-🔴 **#1235** Fixed token expiration edge case
-   > Handled race condition in refresh flow
-   > Nov 9, 2024 • api-server
-
-🔴 **#1236** Resolved memory leak in worker
-   > Fixed event listener cleanup
-   > Nov 8, 2024 • worker-service
-```
-
-**Type Emojis:**
-- 🔴 bugfix
-- 🟣 feature
-- 🔄 refactor
-- 🔵 discovery
-- 🧠 decision
-- ✅ change
-
-For complete formatting guidelines, see [formatting.md](formatting.md).
-
-## Multiple Types
-
-To search for multiple types:
-
-```bash
-curl -s "http://localhost:37777/api/search/by-type?type=bugfix,feature&format=index&limit=10"
-```
-
-## Error Handling
-
-**Missing type parameter:**
-```json
-{"error": "Missing required parameter: type"}
-```
-Fix: Add the type parameter
-
-**Invalid type:**
-```json
-{"error": "Invalid type: foobar. Valid types: bugfix, feature, refactor, decision, discovery, change"}
-```
-Fix: Use one of the valid type values
-
-## Tips
-
-1. Use format=index first to see overview
-2. Start with limit=5-10 to avoid token overload
-3. Combine with dateStart for recent work: `?type=bugfix&dateStart=2024-11-01`
-4. Use project filtering when working on one codebase
-
-**Token Efficiency:**
-- Start with format=index (~50-100 tokens per result)
-- Use format=full only for relevant items (~500-1000 tokens per result)
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)

plugin/skills/mem-search/operations/common-workflows.md

@@ -1,251 +0,0 @@
-# Common Workflows
-
-Step-by-step guides for typical user requests using the search API.
-
-## Workflow 1: Understanding Past Work
-
-**User asks:** "What did we do last session?" or "Catch me up on recent work"
-
-**Steps:**
-
-1. **Get recent context** (fastest path):
-```bash
-curl -s "http://localhost:37777/api/context/recent?limit=3"
-```
-
-2. **Present as narrative:**
-```markdown
-## Recent Work
-
-### Session #545 - Nov 9, 2024
-Implemented JWT authentication system
-
-**Completed:**
-- Added token-based auth with refresh tokens
-- Created JWT signing and verification logic
-
-**Key Learning:** JWT expiration requires careful handling of refresh race conditions
-```
-
-**Why this workflow:**
-- Single request gets both sessions and observations
-- Optimized for "catch me up" questions
-- ~1,500-2,500 tokens for 3 sessions
-
----
-
-## Workflow 2: Finding Specific Bug Fixes
-
-**User asks:** "What bugs did we fix?" or "Show me recent bug fixes"
-
-**Steps:**
-
-1. **Search by type** (index format first):
-```bash
-curl -s "http://localhost:37777/api/search/by-type?type=bugfix&format=index&limit=5"
-```
-
-2. **Review index results**, identify relevant items
-
-3. **Get full details** for specific bugs:
-```bash
-curl -s "http://localhost:37777/api/search/by-type?type=bugfix&format=full&limit=1&offset=2"
-```
-
-4. **Present findings:**
-```markdown
-Found 5 bug fixes:
-
-🔴 **#1235** Fixed token expiration edge case
-   > Handled race condition in refresh flow
-   > Nov 9, 2024 • api-server
-
-[Click for full details on #1235]
-```
-
-**Why this workflow:**
-- Progressive disclosure: index first, full details selectively
-- Type-specific search is more efficient than generic search
-- ~250-500 tokens for index, ~750-1000 per full detail
-
----
-
-## Workflow 3: Understanding File History
-
-**User asks:** "What changes to auth/login.ts?" or "Show me work on this file"
-
-**Steps:**
-
-1. **Search by file** (index format):
-```bash
-curl -s "http://localhost:37777/api/search/by-file?filePath=auth/login.ts&format=index&limit=10"
-```
-
-2. **Review chronological changes**
-
-3. **Get full details** for specific changes:
-```bash
-curl -s "http://localhost:37777/api/search/by-file?filePath=auth/login.ts&format=full&limit=1&offset=3"
-```
-
-4. **Present as file timeline:**
-```markdown
-## History of auth/login.ts
-
-🟣 **#1230** Added JWT authentication (Nov 9)
-🔴 **#1235** Fixed token expiration bug (Nov 9)
-🔄 **#1240** Refactored auth flow (Nov 8)
-```
-
-**Why this workflow:**
-- File-specific search finds all related work
-- Index format shows chronological overview
-- Selective full details for deep dives
-
----
-
-## Workflow 4: Timeline Investigation
-
-**User asks:** "What was happening when we deployed?" or "Show me context around that bug fix"
-
-**Steps:**
-
-1. **Find the event** using search:
-```bash
-curl -s "http://localhost:37777/api/search/observations?query=deployment&format=index&limit=5"
-```
-
-2. **Note observation ID** (e.g., #1234)
-
-3. **Get timeline context**:
-```bash
-curl -s "http://localhost:37777/api/timeline/context?anchor=1234&depth_before=10&depth_after=10"
-```
-
-4. **Present as chronological narrative:**
-```markdown
-## Timeline: Deployment
-
-### Before (10 records)
-**2:45 PM** - 🟣 Prepared deployment scripts
-**2:50 PM** - 💬 User asked: "Are we ready to deploy?"
-
-### ⭐ Anchor Point (2:55 PM)
-🎯 **Observation #1234**: Deployed to production
-
-### After (10 records)
-**3:00 PM** - 🔴 Fixed post-deployment routing issue
-```
-
-**Why this workflow:**
-- Timeline shows temporal context (what happened before/after)
-- Captures causality between events
-- All record types (observations, sessions, prompts) interleaved
-
----
-
-## Workflow 5: Quick Timeline (One Request)
-
-**User asks:** "Timeline of authentication work"
-
-**Steps:**
-
-1. **Use timeline-by-query** (auto mode):
-```bash
-curl -s "http://localhost:37777/api/timeline/by-query?query=authentication&mode=auto&depth_before=10&depth_after=10"
-```
-
-2. **Present timeline directly:**
-```markdown
-## Timeline: Authentication
-
-**Best Match:** 🟣 Observation #1234 - Implemented JWT authentication
-
-### Context (21 records)
-[... timeline around best match ...]
-```
-
-**Why this workflow:**
-- Single request combines search + timeline
-- Fastest path when query is specific
-- Auto mode uses top result as anchor
-
-**Alternative:** Use interactive mode for broad queries:
-```bash
-curl -s "http://localhost:37777/api/timeline/by-query?query=auth&mode=interactive&limit=5"
-```
-Then choose anchor manually.
-
----
-
-## Workflow 6: Search Composition
-
-**User asks:** "What features did we add to the authentication system recently?"
-
-**Steps:**
-
-1. **Combine filters** for precision:
-```bash
-curl -s "http://localhost:37777/api/search/observations?query=authentication&type=feature&dateStart=2024-11-01&format=index&limit=10"
-```
-
-2. **Review filtered results**
-
-3. **Get full details** for relevant features:
-```bash
-curl -s "http://localhost:37777/api/search/observations?query=authentication&type=feature&format=full&limit=1&offset=2"
-```
-
-4. **Present findings:**
-```markdown
-Found 10 authentication features added in November:
-
-🟣 **#1234** Implemented JWT authentication (Nov 9)
-🟣 **#1236** Added refresh token rotation (Nov 9)
-🟣 **#1238** Implemented OAuth2 flow (Nov 7)
-```
-
-**Why this workflow:**
-- Multiple filters narrow results before requesting full details
-- Type + query + dateStart/dateEnd = precise targeting
-- Progressive disclosure: index first, full details selectively
-
----
-
-## Workflow Selection Guide
-
-| User Request | Workflow | Operation | Token Cost |
-|--------------|----------|-----------|------------|
-| "What did we do last session?" | #1 | recent-context | 1,500-2,500 |
-| "What bugs did we fix?" | #2 | by-type | 500-3,000 |
-| "What changes to file.ts?" | #3 | by-file | 500-3,000 |
-| "What was happening then?" | #4 | search → timeline | 3,500-6,000 |
-| "Timeline of X work" | #5 | timeline-by-query | 3,000-4,000 |
-| "Recent features added?" | #6 | observations + filters | 500-3,000 |
-
-## General Principles
-
-1. **Start with index format** - Always use `format=index` first
-2. **Use specialized tools** - by-type, by-file, by-concept when applicable
-3. **Compose operations** - Combine search + timeline for investigations
-4. **Filter early** - Use type, dateStart/dateEnd, project to narrow before expanding
-5. **Progressive disclosure** - Load full details only for relevant items
-
-## Token Budget Awareness
-
-**Quick queries** (500-1,500 tokens):
-- Recent context (limit=3)
-- Index search (limit=5-10)
-- Filtered searches
-
-**Medium queries** (1,500-4,000 tokens):
-- Recent context (limit=5-10)
-- Full details (3-5 items)
-- Timeline (depth 10/10)
-
-**Deep queries** (4,000-8,000 tokens):
-- Timeline (depth 20/20)
-- Full details (10+ items)
-- Multiple composed operations
-
-Always start with minimal token investment, expand only when needed.

plugin/skills/mem-search/operations/formatting.md

@@ -1,403 +0,0 @@
-# Response Formatting Guidelines
-
-How to present search results to users for maximum clarity and usefulness.
-
-## General Principles
-
-1. **Progressive disclosure** - Show index results first, full details on demand
-2. **Visual hierarchy** - Use emojis, bold, and structure for scannability
-3. **Context-aware** - Tailor presentation to user's question
-4. **Actionable** - Include IDs for follow-up queries
-5. **Token-efficient** - Balance detail with token budget
-
----
-
-## Format: Index Results
-
-**When to use:** First response to searches, overviews, multiple results
-
-**Structure:**
-```markdown
-Found {count} results for "{query}":
-
-{emoji} **#{id}** {title}
-   > {subtitle}
-   > {date} • {project}
-```
-
-**Example:**
-```markdown
-Found 5 results for "authentication":
-
-🟣 **#1234** Implemented JWT authentication
-   > Added token-based auth with refresh tokens
-   > Nov 9, 2024 • api-server
-
-🔴 **#1235** Fixed token expiration edge case
-   > Handled race condition in refresh flow
-   > Nov 9, 2024 • api-server
-```
-
-**Type Emojis:**
-- 🔴 bugfix
-- 🟣 feature
-- 🔄 refactor
-- 🔵 discovery
-- 🧠 decision
-- ✅ change
-- 🎯 session
-- 💬 prompt
-
-**What to include:**
-- ✅ ID (for follow-up)
-- ✅ Type emoji
-- ✅ Title
-- ✅ Subtitle (if available)
-- ✅ Date (human-readable)
-- ✅ Project name
-- ❌ Don't include full narrative/facts/files in index format
-
----
-
-## Format: Full Results
-
-**When to use:** User requests details, specific items selected from index
-
-**Structure:**
-```markdown
-## {emoji} {type} #{id}: {title}
-
-**Summary:** {subtitle}
-
-**What happened:**
-{narrative}
-
-**Key Facts:**
-- {fact1}
-- {fact2}
-
-**Files modified:**
-- {file1}
-- {file2}
-
-**Concepts:** {concepts}
-
-**Date:** {human_readable_date}
-**Project:** {project}
-```
-
-**Example:**
-```markdown
-## 🟣 Feature #1234: Implemented JWT authentication
-
-**Summary:** Added token-based auth with refresh tokens
-
-**What happened:**
-Implemented a complete JWT authentication system with access and refresh tokens. Access tokens expire after 15 minutes, refresh tokens after 7 days. Added token signing with RS256 algorithm and proper key rotation infrastructure.
-
-**Key Facts:**
-- Access tokens use 15-minute expiration
-- Refresh tokens stored in httpOnly cookies
-- RS256 algorithm with key rotation support
-- Token refresh endpoint handles race conditions gracefully
-
-**Files modified:**
-- src/auth/jwt.ts (created)
-- src/auth/refresh.ts (created)
-- src/middleware/auth.ts (modified)
-
-**Concepts:** how-it-works, pattern
-
-**Date:** November 9, 2024 at 2:55 PM
-**Project:** api-server
-```
-
-**What to include:**
-- ✅ Full title with emoji and ID
-- ✅ Summary/subtitle
-- ✅ Complete narrative
-- ✅ All key facts
-- ✅ All files (with status: created/modified/deleted)
-- ✅ Concepts/tags
-- ✅ Precise timestamp
-- ✅ Project name
-
----
-
-## Format: Timeline Results
-
-**When to use:** Temporal investigations, "what was happening" questions
-
-**Structure:**
-```markdown
-## Timeline: {anchor_description}
-
-### Before ({count} records)
-
-**{time}** - {emoji} {type} #{id}: {title}
-**{time}** - {emoji} {type} #{id}: {title}
-
-### ⭐ Anchor Point ({time})
-{emoji} **{type} #{id}**: {title}
-
-### After ({count} records)
-
-**{time}** - {emoji} {type} #{id}: {title}
-**{time}** - {emoji} {type} #{id}: {title}
-```
-
-**Example:**
-```markdown
-## Timeline: Deployment
-
-### Before (10 records)
-
-**2:30 PM** - 🟣 #1230: Prepared deployment scripts
-**2:45 PM** - 🔄 #1232: Updated configuration files
-**2:50 PM** - 💬 User asked: "Are we ready to deploy?"
-
-### ⭐ Anchor Point (2:55 PM)
-🎯 **Session #545**: Deployed to production
-
-### After (10 records)
-
-**3:00 PM** - 🔴 #1235: Fixed post-deployment routing issue
-**3:10 PM** - 🔵 #1236: Discovered caching behavior in production
-**3:15 PM** - 🧠 #1237: Decided to add health check endpoint
-```
-
-**What to include:**
-- ✅ Chronological ordering (oldest to newest)
-- ✅ Human-readable times (not epochs)
-- ✅ Clear anchor point marker (⭐)
-- ✅ Mix of all record types (observations, sessions, prompts)
-- ✅ Concise titles (not full narratives)
-- ✅ Type emojis for quick scanning
-
----
-
-## Format: Session Summaries
-
-**When to use:** Recent context, "what did we do" questions
-
-**Structure:**
-```markdown
-## Recent Work on {project}
-
-### 🎯 Session #{id} - {date}
-
-**Request:** {user_request}
-
-**Completed:**
-- {completion1}
-- {completion2}
-
-**Key Learning:** {learning}
-
-**Observations:**
-- {emoji} **#{obs_id}** {obs_title}
-  - Files: {file_list}
-```
-
-**Example:**
-```markdown
-## Recent Work on api-server
-
-### 🎯 Session #545 - November 9, 2024
-
-**Request:** Add JWT authentication with refresh tokens
-
-**Completed:**
-- Implemented token-based auth with refresh logic
-- Added JWT signing and verification
-- Created refresh token rotation
-
-**Key Learning:** JWT expiration requires careful handling of refresh race conditions
-
-**Observations:**
-- 🟣 **#1234** Implemented JWT authentication
-  - Files: jwt.ts, refresh.ts, middleware/auth.ts
-- 🔴 **#1235** Fixed token expiration edge case
-  - Files: refresh.ts
-```
-
-**What to include:**
-- ✅ Session ID and date
-- ✅ Original user request
-- ✅ What was completed (bulleted list)
-- ✅ Key learnings/insights
-- ✅ Linked observations with file lists
-- ✅ Clear hierarchy (session → observations)
-
----
-
-## Format: User Prompts
-
-**When to use:** "What did I ask" questions, prompt searches
-
-**Structure:**
-```markdown
-Found {count} user prompts:
-
-💬 **Prompt #{id}** (Session #{session_id})
-   > "{preview_text}"
-   > {date} • {project}
-```
-
-**Example:**
-```markdown
-Found 5 user prompts about "authentication":
-
-💬 **Prompt #1250** (Session #545)
-   > "How do I implement JWT authentication with refresh tokens? I need to handle token expiration..."
-   > Nov 9, 2024 • api-server
-
-💬 **Prompt #1251** (Session #546)
-   > "The auth tokens are expiring too quickly. Can you help debug the refresh flow?"
-   > Nov 8, 2024 • api-server
-```
-
-**What to include:**
-- ✅ Prompt ID
-- ✅ Session ID (for context linking)
-- ✅ Preview text (200 chars for index, full text for full format)
-- ✅ Date and project
-- ✅ Quote formatting for prompt text
-
----
-
-## Error Responses
-
-**No results found:**
-```markdown
-No results found for "{query}". Try:
-- Different search terms
-- Broader keywords
-- Checking spelling
-- Using partial paths (for file searches)
-```
-
-**Service unavailable:**
-```markdown
-The search service isn't available. Check if the worker is running:
-
-```bash
-npm run worker:status
-```
-
-If the worker is stopped, restart it:
-
-```bash
-npm run worker:restart
-```
-```
-
-**Invalid parameters:**
-```markdown
-Invalid search parameters:
-- {parameter}: {error_message}
-
-See the [API help](help.md) for valid parameter options.
-```
-
----
-
-## Context-Aware Presentation
-
-Tailor formatting to user's question:
-
-**"What bugs did we fix?"**
-→ Use index format, emphasize date/type, group by recency
-
-**"How did we implement X?"**
-→ Use full format for best match, include complete narrative and files
-
-**"What was happening when..."**
-→ Use timeline format, emphasize chronology and causality
-
-**"Catch me up on recent work"**
-→ Use session summary format, focus on high-level accomplishments
-
----
-
-## Token Budget Guidelines
-
-**Minimal presentation (~100-200 tokens):**
-- Index format with 3-5 results
-- Compact list structure
-- Essential metadata only
-
-**Standard presentation (~500-1,000 tokens):**
-- Index format with 10-15 results
-- Include subtitles and context
-- Clear formatting and emojis
-
-**Detailed presentation (~1,500-3,000 tokens):**
-- Full format for 2-3 items
-- Complete narratives and facts
-- Timeline with 20-30 records
-
-**Comprehensive presentation (~5,000+ tokens):**
-- Multiple full results
-- Deep timelines (40+ records)
-- Session summaries with observations
-
-Always start minimal, expand only when needed.
-
----
-
-## Markdown Best Practices
-
-1. **Use headers (##, ###)** for hierarchy
-2. **Bold important elements** (IDs, titles, dates)
-3. **Quote user text** (prompts, questions)
-4. **Bullet lists** for facts and files
-5. **Code blocks** for commands and examples
-6. **Emojis** for type indicators
-7. **Horizontal rules (---)** for section breaks
-8. **Blockquotes (>)** for subtitles and previews
-
----
-
-## Examples by Use Case
-
-### Use Case 1: Quick Overview
-User: "What did we do last session?"
-
-```markdown
-## Recent Work
-
-### 🎯 Session #545 - November 9, 2024
-Implemented JWT authentication system
-
-**Key accomplishment:** Added token-based auth with refresh tokens
-**Key learning:** JWT expiration requires careful handling of refresh race conditions
-```
-
-### Use Case 2: Specific Investigation
-User: "How did we implement JWT authentication?"
-
-```markdown
-## 🟣 Feature #1234: Implemented JWT authentication
-
-**What happened:**
-Implemented a complete JWT authentication system with access and refresh tokens. Access tokens expire after 15 minutes, refresh tokens after 7 days. Added token signing with RS256 algorithm.
-
-**Files:**
-- src/auth/jwt.ts (created)
-- src/auth/refresh.ts (created)
-- src/middleware/auth.ts (modified)
-
-**Key insight:** Refresh race conditions require atomic token exchange logic.
-```
-
-### Use Case 3: Timeline Investigation
-User: "What was happening around the deployment?"
-
-```markdown
-## Timeline: Deployment
-
-[... chronological timeline with before/after context ...]
-```
-
-Choose presentation style based on user's question and information needs.

plugin/skills/mem-search/operations/help.md

@@ -1,171 +0,0 @@
-# API Help
-
-Get comprehensive API documentation for all search endpoints.
-
-## When to Use
-
-- User asks: "What search operations are available?"
-- User asks: "How do I use the search API?"
-- Need reference documentation for endpoints
-- Want to see all available parameters
-
-## Command
-
-```bash
-curl -s "http://localhost:37777/api/help"
-```
-
-## Response Structure
-
-Returns complete API documentation:
-
-```json
-{
-  "version": "6.5.0",
-  "base_url": "http://localhost:37777/api",
-  "endpoints": [
-    {
-      "path": "/search/observations",
-      "method": "GET",
-      "description": "Search observations using full-text search",
-      "parameters": [
-        {
-          "name": "query",
-          "required": true,
-          "type": "string",
-          "description": "Search terms"
-        },
-        {
-          "name": "format",
-          "required": false,
-          "type": "string",
-          "default": "full",
-          "options": ["index", "full"],
-          "description": "Response format"
-        }
-      ],
-      "example": "curl -s \"http://localhost:37777/api/search/observations?query=authentication&format=index&limit=5\""
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-Present as reference documentation:
-
-```markdown
-## claude-mem Search API Reference
-
-Base URL: `http://localhost:37777/api`
-
-### Search Operations
-
-**1. Search Observations**
-- **Endpoint:** `GET /search/observations`
-- **Description:** Search observations using full-text search
-- **Parameters:**
-  - `query` (required, string): Search terms
-  - `format` (optional, string): "index" or "full" (default: "full")
-  - `limit` (optional, number): Max results (default: 20, max: 100)
-- **Example:**
-  ```bash
-  curl -s "http://localhost:37777/api/search/observations?query=authentication&format=index&limit=5"
-  ```
-
-[... continue for all endpoints ...]
-```
-
-## Endpoint Categories
-
-The API help response organizes endpoints by category:
-
-1. **Full-Text Search**
-   - `/search/observations`
-   - `/search/sessions`
-   - `/search/prompts`
-
-2. **Filtered Search**
-   - `/search/by-type`
-   - `/search/by-concept`
-   - `/search/by-file`
-
-3. **Context Retrieval**
-   - `/context/recent`
-   - `/timeline/context`
-   - `/timeline/by-query`
-
-4. **Utilities**
-   - `/help`
-
-## Common Parameters
-
-Many endpoints share these parameters:
-
-- **format**: "index" (summary) or "full" (complete details)
-- **limit**: Number of results to return
-- **offset**: Number of results to skip (for pagination)
-- **project**: Filter by project name
-- **dateStart/dateEnd**: Filter by date range
-  - `dateStart`: Start date (YYYY-MM-DD or epoch timestamp)
-  - `dateEnd`: End date (YYYY-MM-DD or epoch timestamp)
-
-## Error Handling
-
-**Worker not running:**
-Connection refused error. Response: "The search API isn't available. Check if worker is running: `npm run worker:status`"
-
-**Invalid endpoint:**
-```json
-{"error": "Not found"}
-```
-Response: "Invalid API endpoint. Use /api/help to see available endpoints."
-
-## Tips
-
-1. Save help response for reference during investigation
-2. Use examples as starting point for your queries
-3. Check required parameters before making requests
-4. Refer to format options for each endpoint
-5. All endpoints use GET method with query parameters
-
-**Token Efficiency:**
-- Help response: ~2,000-3,000 tokens (complete API reference)
-- Use sparingly - refer to operation-specific docs instead
-- Keep help response cached for repeated reference
-
-## When to Use Help
-
-**Use help when:**
-- Starting to use the search API
-- Need complete parameter reference
-- Forgot which endpoints are available
-- Want to see all options at once
-
-**Don't use help when:**
-- You know which operation you need (use operation-specific docs)
-- Just need examples (use common-workflows.md)
-- Token budget is limited (help is comprehensive)
-
-## Alternative to Help Endpoint
-
-Instead of calling `/api/help`, you can:
-
-1. **Use SKILL.md** - Quick decision guide with operation links
-2. **Use operation docs** - Detailed guides for specific endpoints
-3. **Use common-workflows.md** - Step-by-step examples
-4. **Use formatting.md** - Response presentation templates
-
-The help endpoint is most useful when you need complete API reference in one response.
-
-## API Versioning
-
-The help response includes version information:
-
-```json
-{
-  "version": "6.5.0"
-}
-```
-
-Check version to ensure compatibility with documentation.

plugin/skills/mem-search/operations/observations.md

@@ -1,124 +0,0 @@
-# Search Observations (Semantic + Full-Text Hybrid)
-
-Search all observations using natural language queries.
-
-## When to Use
-
-- User asks: "How did we implement authentication?"
-- User asks: "What bugs did we fix?"
-- User asks: "What features did we add?"
-- Looking for past work by keyword or topic
-
-## Command
-
-```bash
-curl -s "http://localhost:37777/api/search/observations?query=authentication&format=index&limit=5"
-```
-
-## Parameters
-
-- **query** (optional): Natural language search query - uses semantic search (ChromaDB) for ranking with SQLite FTS5 fallback (e.g., "authentication", "bug fix", "database migration"). Can be omitted for filter-only searches.
-- **format**: "index" (summary) or "full" (complete details). Default: "full"
-- **limit**: Number of results (default: 20, max: 100)
-- **project**: Filter by project name (optional)
-- **dateStart/dateEnd**: Filter by date range (optional) - `dateStart` and/or `dateEnd` (YYYY-MM-DD format or epoch timestamp)
-- **obs_type**: Filter by observation type (comma-separated): bugfix, feature, refactor, decision, discovery, change (optional)
-- **concepts**: Filter by concept tags (comma-separated, optional)
-- **files**: Filter by file paths (comma-separated, optional)
-
-**Important**: When omitting `query`, you MUST provide at least one filter (project, dateStart/dateEnd, obs_type, concepts, or files)
-
-## When to Use Each Format
-
-**Use format=index for:**
-- Quick overviews
-- Finding IDs for deeper investigation
-- Listing multiple results
-- **Token cost: ~50-100 per result**
-
-**Use format=full for:**
-- Complete details including narrative, facts, files, concepts
-- Understanding the full context of specific observations
-- **Token cost: ~500-1000 per result**
-
-## Example Response (format=index)
-
-```json
-{
-  "query": "authentication",
-  "count": 5,
-  "format": "index",
-  "results": [
-    {
-      "id": 1234,
-      "type": "feature",
-      "title": "Implemented JWT authentication",
-      "subtitle": "Added token-based auth with refresh tokens",
-      "created_at_epoch": 1699564800000,
-      "project": "api-server",
-      "score": 0.95
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-For format=index, present as a compact list:
-
-```markdown
-Found 5 results for "authentication":
-
-1. **#1234** [feature] Implemented JWT authentication
-   > Added token-based auth with refresh tokens
-   > Nov 9, 2024 • api-server
-
-2. **#1235** [bugfix] Fixed token expiration edge case
-   > Handled race condition in refresh flow
-   > Nov 9, 2024 • api-server
-```
-
-**Include:** ID (for follow-up), type emoji (🔴 bugfix, 🟣 feature, 🔄 refactor, 🔵 discovery, 🧠 decision, ✅ change), title, subtitle, date, project.
-
-For complete formatting guidelines, see formatting.md (documentation coming soon).
-
-## Filter-Only Examples
-
-Search without query text (direct SQLite filtering):
-
-```bash
-# Get all observations from November 2025
-curl -s "http://localhost:37777/api/search?type=observations&dateStart=2025-11-01&format=index"
-
-# Get all bug fixes from a specific project
-curl -s "http://localhost:37777/api/search?type=observations&obs_type=bugfix&project=api-server&format=index"
-
-# Get all observations from last 7 days
-curl -s "http://localhost:37777/api/search?type=observations&dateStart=2025-11-11&format=index"
-```
-
-## Error Handling
-
-**Missing query and filters:**
-```json
-{"error": "Either query or filters required for search"}
-```
-Fix: Provide either a query parameter OR at least one filter (project, dateStart/dateEnd, obs_type, concepts, files)
-
-**No results found:**
-```json
-{"query": "foobar", "count": 0, "results": []}
-```
-Response: "No results found for 'foobar'. Try different search terms."
-
-## Tips
-
-1. Be specific: "authentication JWT" > "auth"
-2. Start with format=index and limit=5-10
-3. Use project filtering when working on one codebase
-4. If no results, try broader terms or check spelling
-
-**Token Efficiency:**
-- Start with format=index (~50-100 tokens per result)
-- Use format=full only for relevant items (~500-1000 tokens per result)
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)

plugin/skills/mem-search/operations/prompts.md

@@ -1,125 +0,0 @@
-# Search User Prompts (Full-Text)
-
-Search raw user prompts to find what was actually asked across all sessions.
-
-## When to Use
-
-- User asks: "What did I ask about authentication?"
-- User asks: "Find my question about database migrations"
-- User asks: "When did I ask about testing?"
-- Looking for specific user questions or requests
-
-## Command
-
-```bash
-curl -s "http://localhost:37777/api/search/prompts?query=authentication&format=index&limit=5"
-```
-
-## Parameters
-
-- **query** (required): Search terms (e.g., "authentication", "how do I", "bug fix")
-- **format**: "index" (truncated prompts) or "full" (complete prompt text). Default: "full"
-- **limit**: Number of results (default: 20, max: 100)
-- **project**: Filter by project name (optional)
-- **dateStart/dateEnd**: Filter by date range (optional)
-
-## When to Use Each Format
-
-**Use format=index for:**
-- Quick overviews of what was asked
-- Finding prompt IDs for full text
-- Listing multiple prompts
-- **Token cost: ~50-100 per result (truncated to 200 chars)**
-
-**Use format=full for:**
-- Complete prompt text
-- Understanding the full user request
-- **Token cost: Variable (depends on prompt length, typically 100-300 tokens)**
-
-## Example Response (format=index)
-
-```json
-{
-  "query": "authentication",
-  "count": 5,
-  "format": "index",
-  "results": [
-    {
-      "id": 1250,
-      "session_id": "S545",
-      "prompt_preview": "How do I implement JWT authentication with refresh tokens? I need to handle token expiration...",
-      "created_at_epoch": 1699564800000,
-      "project": "api-server"
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-For format=index, present as a compact list:
-
-```markdown
-Found 5 user prompts about "authentication":
-
-💬 **Prompt #1250** (Session #545)
-   > "How do I implement JWT authentication with refresh tokens? I need to handle token expiration..."
-   > Nov 9, 2024 • api-server
-
-💬 **Prompt #1251** (Session #546)
-   > "The auth tokens are expiring too quickly. Can you help debug the refresh flow?"
-   > Nov 8, 2024 • api-server
-```
-
-For complete formatting guidelines, see [formatting.md](formatting.md).
-
-## What Gets Searched
-
-User prompts search covers:
-- All user messages sent to Claude Code
-- Raw text as typed by the user
-- Multi-turn conversations (each message is a separate prompt)
-- Questions, requests, commands, and clarifications
-
-## Error Handling
-
-**Missing query parameter:**
-```json
-{"error": "Missing required parameter: query"}
-```
-Fix: Add the query parameter
-
-**No results found:**
-```json
-{"query": "foobar", "count": 0, "results": []}
-```
-Response: "No user prompts found for 'foobar'. Try different search terms."
-
-## Tips
-
-1. Use exact phrases in quotes: `?query="how do I"` for precise matches
-2. Start with format=index to see preview, then get full text if needed
-3. Use dateStart to find recent questions: `?query=bug&dateStart=2024-11-01`
-4. Prompts show what was asked, sessions/observations show what was done
-5. Combine with session search to see both question and answer
-
-**Token Efficiency:**
-- Start with format=index (~50-100 tokens per result, prompt truncated to 200 chars)
-- Use format=full only for relevant items (100-300 tokens per result)
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)
-
-## When to Use Prompts vs Sessions
-
-**Use prompts search when:**
-- Looking for specific user questions
-- Trying to remember what was asked
-- Finding original request wording
-
-**Use sessions search when:**
-- Looking for what was accomplished
-- Understanding work summaries
-- Getting high-level context
-
-**Combine both when:**
-- Understanding the full conversation (what was asked + what was done)
-- Investigating how a request was interpreted

plugin/skills/mem-search/operations/recent-context.md

@@ -1,134 +0,0 @@
-# Get Recent Context
-
-Get recent session summaries and observations for a project.
-
-## When to Use
-
-- User asks: "What did we do last session?"
-- User asks: "What have we been working on recently?"
-- User asks: "Catch me up on recent work"
-- Starting a new session and need context
-
-## Command
-
-```bash
-curl -s "http://localhost:37777/api/context/recent?project=api-server&limit=3"
-```
-
-## Parameters
-
-- **project**: Project name (defaults to current working directory basename)
-- **limit**: Number of recent sessions to retrieve (default: 3, max: 10)
-
-## Response Structure
-
-Returns combined context from recent sessions:
-
-```json
-{
-  "project": "api-server",
-  "limit": 3,
-  "sessions": [
-    {
-      "id": 545,
-      "session_id": "S545",
-      "title": "Implemented JWT authentication system",
-      "request": "Add JWT authentication with refresh tokens",
-      "completion": "Implemented token-based auth with refresh logic",
-      "learnings": "JWT expiration requires careful handling of refresh race conditions",
-      "created_at_epoch": 1699564800000,
-      "observations": [
-        {
-          "id": 1234,
-          "type": "feature",
-          "title": "Implemented JWT authentication",
-          "subtitle": "Added token-based auth with refresh tokens",
-          "files": ["src/auth/jwt.ts", "src/auth/refresh.ts"]
-        }
-      ]
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-Present as a chronological narrative:
-
-```markdown
-## Recent Work on api-server
-
-### Session #545 - Nov 9, 2024
-**Request:** Add JWT authentication with refresh tokens
-
-**Completed:**
-- Implemented token-based auth with refresh logic
-- Added JWT signing and verification
-- Created refresh token rotation
-
-**Key Learning:** JWT expiration requires careful handling of refresh race conditions
-
-**Observations:**
-- 🟣 **#1234** Implemented JWT authentication
-  - Files: jwt.ts, refresh.ts
-```
-
-For complete formatting guidelines, see [formatting.md](formatting.md).
-
-## Default Project Detection
-
-If no project parameter is provided, uses current working directory:
-
-```bash
-# Auto-detects project from current directory
-curl -s "http://localhost:37777/api/context/recent?limit=3"
-```
-
-## Error Handling
-
-**No sessions found:**
-```json
-{"project": "new-project", "sessions": []}
-```
-Response: "No recent sessions found for 'new-project'. This might be a new project."
-
-**Worker not running:**
-Connection refused error. Inform user to check if worker is running: `npm run worker:status`
-
-## Tips
-
-1. Start with limit=3 for quick overview (default)
-2. Increase to limit=5-10 for deeper context
-3. Recent context is perfect for session start
-4. Combines both sessions and observations in one request
-5. Use this when user asks "what did we do last time?"
-
-**Token Efficiency:**
-- limit=3 sessions: ~1,500-2,500 tokens (includes observations)
-- limit=5 sessions: ~2,500-4,000 tokens
-- limit=10 sessions: ~5,000-8,000 tokens
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)
-
-## When to Use Recent Context
-
-**Use recent-context when:**
-- Starting a new session
-- User asks about recent work
-- Need quick catch-up on project activity
-- Want both sessions and observations together
-
-**Don't use recent-context when:**
-- Looking for specific topics (use search instead)
-- Need timeline around specific event (use timeline instead)
-- Want only observations or only sessions (use search operations)
-
-## Comparison with Other Operations
-
-| Operation | Use Case | Token Cost |
-|-----------|----------|------------|
-| recent-context | Quick catch-up on recent work | 1,500-4,000 |
-| sessions search | Find sessions by topic | 50-100 per result (index) |
-| observations search | Find specific implementations | 50-100 per result (index) |
-| timeline | Context around specific point | 3,000-6,000 |
-
-Recent context is optimized for "what happened recently?" questions with minimal token usage.

plugin/skills/mem-search/operations/sessions.md

@@ -1,124 +0,0 @@
-# Search Sessions (Full-Text)
-
-Search session summaries using natural language queries.
-
-## When to Use
-
-- User asks: "What did we work on last week?"
-- User asks: "What sessions involved database work?"
-- User asks: "Show me sessions where we fixed bugs"
-- Looking for past sessions by topic or theme
-
-## Command
-
-```bash
-curl -s "http://localhost:37777/api/search/sessions?query=authentication&format=index&limit=5"
-```
-
-## Parameters
-
-- **query** (required): Search terms (e.g., "authentication", "database migration", "bug fixes")
-- **format**: "index" (summary) or "full" (complete details). Default: "full"
-- **limit**: Number of results (default: 20, max: 100)
-- **project**: Filter by project name (optional)
-- **dateStart/dateEnd**: Filter by date range (optional)
-
-## When to Use Each Format
-
-**Use format=index for:**
-- Quick overviews of past sessions
-- Finding session IDs for deeper investigation
-- Listing multiple sessions
-- **Token cost: ~50-100 per result**
-
-**Use format=full for:**
-- Complete session summaries with requests, completions, learnings
-- Understanding the full context of a session
-- **Token cost: ~500-1000 per result**
-
-## Example Response (format=index)
-
-```json
-{
-  "query": "authentication",
-  "count": 3,
-  "format": "index",
-  "results": [
-    {
-      "id": 545,
-      "session_id": "S545",
-      "title": "Implemented JWT authentication system",
-      "subtitle": "Added token-based auth with refresh tokens",
-      "created_at_epoch": 1699564800000,
-      "project": "api-server"
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-For format=index, present as a compact list:
-
-```markdown
-Found 3 sessions about "authentication":
-
-🎯 **Session #545** Implemented JWT authentication system
-   > Added token-based auth with refresh tokens
-   > Nov 9, 2024 • api-server
-
-🎯 **Session #546** Fixed authentication token expiration
-   > Resolved race condition in token refresh flow
-   > Nov 8, 2024 • api-server
-```
-
-For complete formatting guidelines, see [formatting.md](formatting.md).
-
-## Session Summary Structure
-
-Full session summaries include:
-
-- **Session request**: What the user asked for
-- **What was completed**: Summary of work done
-- **Key learnings**: Important insights and discoveries
-- **Files modified**: List of changed files
-- **Observations**: Links to detailed observations
-
-## Error Handling
-
-**Missing query parameter:**
-```json
-{"error": "Missing required parameter: query"}
-```
-Fix: Add the query parameter
-
-**No results found:**
-```json
-{"query": "foobar", "count": 0, "results": []}
-```
-Response: "No sessions found for 'foobar'. Try different search terms."
-
-## Tips
-
-1. Be specific: "JWT authentication implementation" > "auth"
-2. Start with format=index and limit=5-10
-3. Use dateStart for recent sessions: `?query=auth&dateStart=2024-11-01`
-4. Sessions provide high-level overview, observations provide details
-5. Use project filtering when working on one codebase
-
-**Token Efficiency:**
-- Start with format=index (~50-100 tokens per result)
-- Use format=full only for relevant items (~500-1000 tokens per result)
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)
-
-## When to Use Sessions vs Observations
-
-**Use sessions search when:**
-- Looking for high-level work summaries
-- Understanding what was done in past sessions
-- Getting overview of recent activity
-
-**Use observations search when:**
-- Looking for specific implementation details
-- Finding bugs, features, or decisions
-- Need fine-grained context about code changes

plugin/skills/mem-search/operations/timeline-by-query.md

@@ -1,194 +0,0 @@
-# Timeline by Query
-
-Search for observations and get timeline context in a single request. Combines search + timeline into one operation.
-
-## When to Use
-
-- User asks: "What was happening when we worked on authentication?"
-- User asks: "Show me context around bug fixes"
-- User asks: "Timeline of database work"
-- Need to find something then see temporal context
-
-## MCP Tool
-
-Use the `get_timeline_by_query` MCP tool:
-
-```
-# Auto mode: Uses top search result as timeline anchor
-get_timeline_by_query(query="authentication", mode="auto", depth_before=10, depth_after=10)
-
-# Interactive mode: Shows top N search results for manual selection
-get_timeline_by_query(query="authentication", mode="interactive", limit=5)
-```
-
-## Parameters
-
-- **query** (required): Search terms (e.g., "authentication", "bug fix", "database")
-- **mode**: Search mode
-  - `auto` (default): Automatically uses top search result as timeline anchor
-  - `interactive`: Returns top N search results for manual anchor selection
-- **depth_before**: Records before anchor (default: 10, max: 50) - for auto mode
-- **depth_after**: Records after anchor (default: 10, max: 50) - for auto mode
-- **limit**: Number of search results (default: 5, max: 20) - for interactive mode
-- **project**: Filter by project name (optional)
-
-## Auto Mode (Recommended)
-
-Automatically gets timeline around best match:
-
-```
-get_timeline_by_query(query="JWT authentication", mode="auto", depth_before=10, depth_after=10)
-```
-
-**Response:**
-```json
-{
-  "query": "JWT authentication",
-  "mode": "auto",
-  "best_match": {
-    "id": 1234,
-    "type": "feature",
-    "title": "Implemented JWT authentication",
-    "score": 0.95
-  },
-  "timeline": [
-    // ... timeline records around observation #1234
-  ]
-}
-```
-
-**When to use auto mode:**
-- You're confident the top result is what you want
-- Want fastest path to timeline context
-- Query is specific enough for accurate top result
-
-## Interactive Mode
-
-Shows top search results for manual review:
-
-```
-get_timeline_by_query(query="authentication", mode="interactive", limit=5)
-```
-
-**Response:**
-```json
-{
-  "query": "authentication",
-  "mode": "interactive",
-  "top_matches": [
-    {
-      "id": 1234,
-      "type": "feature",
-      "title": "Implemented JWT authentication",
-      "subtitle": "Added token-based auth with refresh tokens",
-      "score": 0.95
-    },
-    {
-      "id": 1240,
-      "type": "bugfix",
-      "title": "Fixed authentication token expiration",
-      "subtitle": "Resolved race condition in refresh flow",
-      "score": 0.87
-    }
-  ],
-  "next_step": "Use get_context_timeline(anchor=<id>, depth_before=10, depth_after=10)"
-}
-```
-
-**When to use interactive mode:**
-- Query is broad and may have multiple relevant results
-- Want to review options before getting timeline
-- Not sure which result is most relevant
-
-## How to Present Results
-
-**For auto mode:**
-
-```markdown
-## Timeline: JWT authentication
-
-**Best Match:** 🟣 Observation #1234 - Implemented JWT authentication (score: 0.95)
-
-### Before (10 records)
-**2:45 PM** - 🟣 Added authentication middleware
-
-### ⭐ Anchor Point (2:55 PM)
-🟣 **Observation #1234**: Implemented JWT authentication
-
-### After (10 records)
-**3:00 PM** - 🎯 Session completed: JWT authentication system
-```
-
-**For interactive mode:**
-
-```markdown
-Found 5 matches for "authentication":
-
-1. 🟣 **#1234** Implemented JWT authentication (score: 0.95)
-   > Added token-based auth with refresh tokens
-
-2. 🔴 **#1240** Fixed authentication token expiration (score: 0.87)
-   > Resolved race condition in refresh flow
-
-To see timeline context, use observation ID with timeline operation.
-```
-
-For complete formatting guidelines, see [formatting.md](formatting.md).
-
-## Error Handling
-
-**Missing query parameter:**
-```json
-{"error": "Missing required parameter: query"}
-```
-Fix: Add the query parameter
-
-**No results found:**
-```json
-{"query": "foobar", "top_matches": []}
-```
-Response: "No results found for 'foobar'. Try different search terms."
-
-## Tips
-
-1. **Use auto mode** for specific queries: "JWT authentication implementation"
-2. **Use interactive mode** for broad queries: "authentication"
-3. Start with depth 10/10 for balanced context
-4. Be specific in queries for better auto mode accuracy
-5. This is fastest way to find + explore context in one request
-
-**Token Efficiency:**
-- Auto mode: ~3,000-4,000 tokens (search + timeline)
-- Interactive mode: ~500-1,000 tokens (search results only)
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)
-
-## Workflow Comparison
-
-**timeline-by-query (auto):**
-1. One request → get timeline around best match
-2. ~3,000 tokens
-
-**timeline-by-query (interactive) → timeline:**
-1. First request → see top matches (~500 tokens)
-2. Second request → get timeline for chosen match (~3,000 tokens)
-3. Total: ~3,500 tokens
-
-**observations search → timeline:**
-1. Search observations (~500 tokens)
-2. Get timeline for chosen result (~3,000 tokens)
-3. Total: ~3,500 tokens
-
-Use auto mode when you're confident about the query. Use interactive mode or separate search when you want more control.
-
-## When to Use Timeline-by-Query
-
-**Use timeline-by-query when:**
-- Need to find something AND see temporal context
-- Want one-request convenience (auto mode)
-- Investigating "what was happening when we worked on X?"
-- Don't have observation ID already
-
-**Don't use timeline-by-query when:**
-- Already have observation ID (use timeline instead)
-- Just need search results (use observations search)
-- Need recent work overview (use recent-context)

plugin/skills/mem-search/operations/timeline.md

@@ -1,171 +0,0 @@
-# Get Context Timeline
-
-Get a chronological timeline of observations, sessions, and prompts around a specific point in time.
-
-## When to Use
-
-- User asks: "What was happening when we deployed?"
-- User asks: "Show me context around that bug fix"
-- User asks: "What happened before and after that change?"
-- Need temporal context around an event
-
-## MCP Tool
-
-Use the `get_context_timeline` MCP tool:
-
-```
-get_context_timeline(anchor=1234, depth_before=10, depth_after=10)
-get_context_timeline(anchor="S545", depth_before=10, depth_after=10)
-get_context_timeline(anchor="2024-11-09T12:00:00Z", depth_before=10, depth_after=10)
-```
-
-## Parameters
-
-- **anchor** (required): Point in time to center timeline
-  - Observation ID: `1234`
-  - Session ID: `S545`
-  - ISO timestamp: `2024-11-09T12:00:00Z`
-- **depth_before**: Number of records before anchor (default: 10, max: 50)
-- **depth_after**: Number of records after anchor (default: 10, max: 50)
-- **project**: Filter by project name (optional)
-
-## Response Structure
-
-Returns unified chronological timeline:
-
-```json
-{
-  "anchor": 1234,
-  "depth_before": 10,
-  "depth_after": 10,
-  "total_records": 21,
-  "timeline": [
-    {
-      "record_type": "observation",
-      "id": 1230,
-      "type": "feature",
-      "title": "Added authentication middleware",
-      "created_at_epoch": 1699564700000
-    },
-    {
-      "record_type": "prompt",
-      "id": 1250,
-      "session_id": "S545",
-      "prompt_preview": "How do I add JWT authentication?",
-      "created_at_epoch": 1699564750000
-    },
-    {
-      "record_type": "observation",
-      "id": 1234,
-      "type": "feature",
-      "title": "Implemented JWT authentication",
-      "created_at_epoch": 1699564800000,
-      "is_anchor": true
-    },
-    {
-      "record_type": "session",
-      "id": 545,
-      "session_id": "S545",
-      "title": "Implemented JWT authentication system",
-      "created_at_epoch": 1699564900000
-    }
-  ]
-}
-```
-
-## How to Present Results
-
-Present as chronological narrative with anchor highlighted:
-
-```markdown
-## Timeline around Observation #1234
-
-### Before (10 records)
-
-**2:45 PM** - 🟣 Observation #1230: Added authentication middleware
-
-**2:50 PM** - 💬 User asked: "How do I add JWT authentication?"
-
-### ⭐ Anchor Point (2:55 PM)
-🟣 **Observation #1234**: Implemented JWT authentication
-
-### After (10 records)
-
-**3:00 PM** - 🎯 Session #545 completed: Implemented JWT authentication system
-
-**3:05 PM** - 🔴 Observation #1235: Fixed token expiration edge case
-```
-
-For complete formatting guidelines, see [formatting.md](formatting.md).
-
-## Anchor Types
-
-**Observation ID:**
-- Use when you know the specific observation ID
-- Example: `anchor=1234`
-
-**Session ID:**
-- Use when you want context around a session
-- Example: `anchor=S545`
-
-**ISO Timestamp:**
-- Use when you know approximate time
-- Example: `anchor=2024-11-09T14:30:00Z`
-
-## Error Handling
-
-**Missing anchor parameter:**
-```json
-{"error": "Missing required parameter: anchor"}
-```
-Fix: Add the anchor parameter
-
-**Anchor not found:**
-```json
-{"error": "Anchor not found: 9999"}
-```
-Response: "Observation #9999 not found. Check the ID or try a different anchor."
-
-**Invalid timestamp:**
-```json
-{"error": "Invalid timestamp format"}
-```
-Fix: Use ISO 8601 format: `2024-11-09T14:30:00Z`
-
-## Tips
-
-1. Start with depth_before=10, depth_after=10 for balanced context
-2. Increase depth for broader investigation (max: 50 each)
-3. Use observation IDs from search results as anchors
-4. Timelines show all record types interleaved chronologically
-5. Perfect for understanding "what was happening when X occurred"
-
-**Token Efficiency:**
-- depth 10/10: ~3,000-4,000 tokens (21 records)
-- depth 20/20: ~6,000-8,000 tokens (41 records)
-- depth 50/50: ~15,000-20,000 tokens (101 records)
-- See [../principles/progressive-disclosure.md](../principles/progressive-disclosure.md)
-
-## When to Use Timeline
-
-**Use timeline when:**
-- Need context around specific event
-- Understanding sequence of events
-- Investigating "what was happening then?"
-- Want all record types (observations, sessions, prompts) together
-
-**Don't use timeline when:**
-- Just need recent work (use recent-context)
-- Looking for specific topics (use search)
-- Don't have an anchor point (use timeline-by-query)
-
-## Comparison with Timeline-by-Query
-
-| Feature | timeline | timeline-by-query |
-|---------|----------|-------------------|
-| Requires anchor | Yes (ID or timestamp) | No (uses search query) |
-| Best for | Known event investigation | Finding then exploring context |
-| Steps | 1 (direct timeline) | 2 (search + timeline) |
-| Use when | You have observation ID | You have search term |
-
-Timeline is faster when you already know the anchor point.

plugin/skills/mem-search/principles/anti-patterns.md

@@ -1,176 +0,0 @@
-# Anti-Pattern Catalogue
-
-Common mistakes to avoid when using the HTTP search API. These anti-patterns address LLM training biases and prevent token-wasting behaviors.
-
-## Anti-Pattern 1: Skipping Index Format
-
-**The Mistake:**
-```bash
-# ❌ Bad: Jump straight to full format
-curl -s "http://localhost:37777/api/search/observations?query=authentication&format=full&limit=20"
-```
-
-**Why It's Wrong:**
-- 20 × 750 tokens = 15,000 tokens
-- May hit MCP token limits
-- 99% wasted on irrelevant results
-
-**The Correction:**
-```bash
-# ✅ Good: Start with index, review, then request full selectively
-curl -s "http://localhost:37777/api/search/observations?query=authentication&format=index&limit=5"
-# Review results, identify relevant items
-curl -s "http://localhost:37777/api/search/observations?query=authentication&format=full&limit=1&offset=2"
-```
-
-**What It Teaches:**
-Progressive disclosure isn't optional - it's essential for scale.
-
-**LLM Behavior Insight:**
-LLMs trained on code examples may have seen `format=full` as "more complete" and default to it.
-
----
-
-## Anti-Pattern 2: Over-Requesting Results
-
-**The Mistake:**
-```bash
-# ❌ Bad: Request limit=20 without reviewing index first
-curl -s "http://localhost:37777/api/search/observations?query=auth&format=index&limit=20"
-```
-
-**Why It's Wrong:**
-- Most of 20 results will be irrelevant
-- Wastes tokens and time
-- Overwhelms review process
-
-**The Correction:**
-```bash
-# ✅ Good: Start small, paginate if needed
-curl -s "http://localhost:37777/api/search/observations?query=auth&format=index&limit=5"
-# If needed, paginate:
-curl -s "http://localhost:37777/api/search/observations?query=auth&format=index&limit=5&offset=5"
-```
-
-**What It Teaches:**
-Start small (limit=3-5), review, paginate if needed.
-
-**LLM Behavior Insight:**
-LLMs may think "more results = more thorough" without considering relevance.
-
----
-
-## Anti-Pattern 3: Ignoring Tool Specialization
-
-**The Mistake:**
-```bash
-# ❌ Bad: Use generic search for everything
-curl -s "http://localhost:37777/api/search/observations?query=bugfix&format=index&limit=10"
-```
-
-**Why It's Wrong:**
-- Specialized tools (by-type, by-concept, by-file) are more efficient
-- Generic search mixes all result types
-- Misses filtering optimization
-
-**The Correction:**
-```bash
-# ✅ Good: Use specialized endpoint when applicable
-curl -s "http://localhost:37777/api/search/by-type?type=bugfix&format=index&limit=10"
-```
-
-**What It Teaches:**
-The decision tree exists for a reason - follow it.
-
-**LLM Behavior Insight:**
-LLMs may gravitate toward "general purpose" tools to avoid decision-making.
-
----
-
-## Anti-Pattern 4: Loading Full Context Prematurely
-
-**The Mistake:**
-```bash
-# ❌ Bad: Request full format before understanding what's relevant
-curl -s "http://localhost:37777/api/search/observations?query=database&format=full&limit=10"
-```
-
-**Why It's Wrong:**
-- Can't filter relevance without seeing index first
-- Wastes tokens on irrelevant full details
-- 10 × 750 = 7,500 tokens for potentially zero useful results
-
-**The Correction:**
-```bash
-# ✅ Good: Index first to identify relevance
-curl -s "http://localhost:37777/api/search/observations?query=database&format=index&limit=10"
-# Identify relevant: #1234 and #1250
-curl -s "http://localhost:37777/api/search/observations?query=database+1234&format=full&limit=1"
-curl -s "http://localhost:37777/api/search/observations?query=database+1250&format=full&limit=1"
-```
-
-**What It Teaches:**
-Filtering is a prerequisite for expansion.
-
-**LLM Behavior Insight:**
-LLMs may try to "get everything at once" to avoid multiple tool calls.
-
----
-
-## Anti-Pattern 5: Not Using Timeline Tools
-
-**The Mistake:**
-```bash
-# ❌ Bad: Search for individual observations separately
-curl -s "http://localhost:37777/api/search/observations?query=before+deployment"
-curl -s "http://localhost:37777/api/search/observations?query=during+deployment"
-curl -s "http://localhost:37777/api/search/observations?query=after+deployment"
-```
-
-**Why It's Wrong:**
-- Misses context around events
-- Inefficient (N searches vs 1 timeline)
-- Temporal relationships lost
-
-**The Correction:**
-```bash
-# ✅ Good: Use timeline tool for contextual investigation
-curl -s "http://localhost:37777/api/timeline/by-query?query=deployment&depth_before=10&depth_after=10"
-```
-
-**What It Teaches:**
-Tool composition - some tools are designed to work together.
-
-**LLM Behavior Insight:**
-LLMs may not naturally discover tool composition patterns.
-
----
-
-## Why These Anti-Patterns Matter
-
-**Addresses LLM Training Bias:**
-LLMs default to "load everything" behavior from web scraping training data where thoroughness was rewarded.
-
-**Teaches Protocol Awareness:**
-HTTP APIs and MCP have real token limits that can break the system.
-
-**Prevents User Frustration:**
-Token limit errors confuse users and break workflows.
-
-**Builds Good Habits:**
-Anti-patterns teach the "why" behind best practices.
-
-**Makes Implicit Explicit:**
-Surfaces mental models that experienced users internalize but novices miss.
-
----
-
-## What Happens If These Are Ignored
-
-- **No progressive disclosure**: Every search loads limit=20 in full format → token exhaustion
-- **Over-requesting**: 15,000 token searches for 2 relevant results
-- **Wrong tool**: Generic search when specialized filters would be 10x faster
-- **Premature expansion**: Load full details before knowing relevance
-- **Missing composition**: Single-tool thinking, missing powerful multi-step workflows
-
-**Bottom Line:** These anti-patterns waste 5-10x more tokens than necessary and frequently cause system failures.

plugin/skills/mem-search/principles/progressive-disclosure.md

@@ -1,120 +0,0 @@
-# Progressive Disclosure Pattern (MANDATORY)
-
-**Core Principle**: Find the smallest set of high-signal tokens first (index format), then drill down to full details only for relevant items.
-
-## The 4-Step Workflow
-
-### Step 1: Start with Index Format
-
-**Action:**
-- Use `format=index` (default in most operations)
-- Set `limit=3-5` (not 20)
-- Review titles and dates ONLY
-
-**Token Cost:** ~50-100 tokens per result
-
-**Why:** Minimal token investment for maximum signal. Get overview before committing to full details.
-
-**Example:**
-```bash
-curl -s "http://localhost:37777/api/search/observations?query=authentication&format=index&limit=5"
-```
-
-**Response:**
-```json
-{
-  "query": "authentication",
-  "count": 5,
-  "format": "index",
-  "results": [
-    {
-      "id": 1234,
-      "type": "feature",
-      "title": "Implemented JWT authentication",
-      "subtitle": "Added token-based auth with refresh tokens",
-      "created_at_epoch": 1699564800000,
-      "project": "api-server"
-    }
-  ]
-}
-```
-
-### Step 2: Identify Relevant Items
-
-**Cognitive Task:**
-- Scan index results for relevance
-- Note which items need full details
-- Discard irrelevant items
-
-**Why:** Human-in-the-loop filtering before expensive operations. Don't load full details for items you'll ignore.
-
-### Step 3: Request Full Details (Selectively)
-
-**Action:**
-- Use `format=full` ONLY for specific items of interest
-- Target by ID or use refined search query
-
-**Token Cost:** ~500-1000 tokens per result
-
-**Principle:** Load only what you need
-
-**Example:**
-```bash
-# After reviewing index, get full details for observation #1234
-curl -s "http://localhost:37777/api/search/observations?query=authentication&format=full&limit=1&offset=2"
-```
-
-**Why:** Targeted token expenditure with high ROI. 10x cost difference means selectivity matters.
-
-### Step 4: Refine with Filters (If Needed)
-
-**Techniques:**
-- Use `type`, `dateStart`/`dateEnd`, `concepts`, `files` filters
-- Narrow scope BEFORE requesting more results
-- Use `offset` for pagination instead of large limits
-
-**Why:** Reduce result set first, then expand selectively. Don't load 20 results when filters could narrow to 3.
-
-## Token Budget Awareness
-
-**Costs:**
-- Index result: ~50-100 tokens
-- Full result: ~500-1000 tokens
-- 10x cost difference
-
-**Starting Points:**
-- Start with `limit=3-5` (not 20)
-- Reduce limit if hitting token errors
-
-**Savings Example:**
-- Naive: 10 items × 750 tokens (avg full) = 7,500 tokens
-- Progressive: (5 items × 75 tokens index) + (2 items × 750 tokens full) = 1,875 tokens
-- **Savings: 5,625 tokens (75% reduction)**
-
-## What Problems This Solves
-
-1. **Token exhaustion**: Without this, LLMs load everything in full format (9,000+ tokens for 10 items)
-2. **Poor signal-to-noise**: Loading full details for irrelevant items wastes tokens
-3. **MCP limits**: Large payloads hit protocol limits (system failures)
-4. **Inefficiency**: Loading 20 full results when only 2 are relevant
-
-## How It Scales
-
-**With 10 records:**
-- Index (500 tokens) → Full (2,000 tokens for 2 relevant) = 2,500 tokens
-- Without pattern: Full (10,000 tokens for all 10) = 4x more expensive
-
-**With 1,000 records:**
-- Index (500 tokens for top 5) → Full (1,000 tokens for 1 relevant) = 1,500 tokens
-- Without pattern: Would hit MCP limits before seeing relevant data
-
-## Context Engineering Alignment
-
-This pattern implements core context engineering principles:
-
-- **Just-in-time context**: Load data dynamically at runtime
-- **Progressive disclosure**: Lightweight identifiers (index) → full details as needed
-- **Token efficiency**: Minimal high-signal tokens first, expand selectively
-- **Attention budget**: Treat context as finite resource with diminishing returns
-
-Always start with the smallest set of high-signal tokens that maximize likelihood of desired outcome.

plugin/skills/troubleshoot/SKILL.md

@@ -1,89 +0,0 @@
----
-name: troubleshoot
-description: Diagnose and fix claude-mem installation issues. Checks worker status, database integrity, service health, dependencies, and provides automated fixes for common problems.
----
-
-# Claude-Mem Troubleshooting Skill
-
-Diagnose and resolve installation and operational issues with the claude-mem plugin.
-
-## When to Use This Skill
-
-**Invoke this skill when:**
-- Memory not persisting after `/clear`
-- Viewer UI empty or not loading
-- Worker service not running
-- Database missing or corrupted
-- Port conflicts
-- Missing dependencies
-- "Nothing is remembered" complaints
-- Search results empty when they shouldn't be
-
-**Do NOT invoke** for feature requests or usage questions (use regular documentation for that).
-
-## Quick Decision Guide
-
-Once the skill is loaded, choose the appropriate operation:
-
-**What's the problem?**
-
-- "Nothing is being remembered" → [operations/common-issues.md](operations/common-issues.md#nothing-remembered)
-- "Viewer is empty" → [operations/common-issues.md](operations/common-issues.md#viewer-empty)
-- "Worker won't start" → [operations/common-issues.md](operations/common-issues.md#worker-not-starting)
-- "Want to run full diagnostics" → [operations/diagnostics.md](operations/diagnostics.md)
-- "Need automated fix" → [operations/automated-fixes.md](operations/automated-fixes.md)
-
-## Available Operations
-
-Choose the appropriate operation file for detailed instructions:
-
-### Diagnostic Workflows
-1. **[Full System Diagnostics](operations/diagnostics.md)** - Comprehensive step-by-step diagnostic workflow
-2. **[Worker Diagnostics](operations/worker.md)** - Bun worker-specific troubleshooting
-3. **[Database Diagnostics](operations/database.md)** - Database integrity and data checks
-
-### Issue Resolution
-4. **[Common Issues](operations/common-issues.md)** - Quick fixes for frequently encountered problems
-5. **[Automated Fixes](operations/automated-fixes.md)** - One-command fix sequences
-
-### Reference
-6. **[Quick Commands](operations/reference.md)** - Essential commands for troubleshooting
-
-## Quick Start
-
-**Fast automated fix (try this first):**
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/ && \
-npm run worker:stop; \
-npm install && \
-npm run worker:start && \
-sleep 3 && \
-curl -s http://127.0.0.1:37777/health
-```
-
-Expected output: `{"status":"ok"}`
-
-If that doesn't work, proceed to detailed diagnostics.
-
-## Response Format
-
-When troubleshooting:
-1. **Identify the symptom** - What's the user reporting?
-2. **Choose operation file** - Use the decision guide above
-3. **Follow steps systematically** - Don't skip diagnostic steps
-4. **Report findings** - Tell user what you found and what was fixed
-5. **Verify resolution** - Confirm the issue is resolved
-
-## Technical Notes
-
-- **Worker port:** Default 37777 (configurable via `CLAUDE_MEM_WORKER_PORT`)
-- **Database location:** `~/.claude-mem/claude-mem.db`
-- **Plugin location:** `~/.claude/plugins/marketplaces/thedotmack/`
-- **Worker PID file:** `~/.claude-mem/worker.pid`
-
-## Error Reporting
-
-If troubleshooting doesn't resolve the issue, collect diagnostic data and direct user to:
-https://github.com/thedotmack/claude-mem/issues
-
-See [operations/diagnostics.md](operations/diagnostics.md#reporting-issues) for details on what to collect.

plugin/skills/troubleshoot/operations/automated-fixes.md

@@ -1,206 +0,0 @@
-# Automated Fix Sequences
-
-One-command fix sequences for common claude-mem issues.
-
-## Quick Fix: Complete Reset and Restart
-
-**Use when:** General issues, worker not responding, after updates
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/ && \
-npm run worker:stop; \
-npm install && \
-npm run worker:start && \
-sleep 3 && \
-curl -s http://127.0.0.1:37777/health
-```
-
-**Expected output:** `{"status":"ok"}`
-
-**What it does:**
-1. Stops the worker (if running)
-2. Ensures dependencies are installed
-3. Starts worker
-4. Waits for startup
-5. Verifies health
-
-## Fix: Worker Not Running
-
-**Use when:** Worker status shows it's not running
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/ && \
-npm run worker:start && \
-sleep 2 && \
-npm run worker:status
-```
-
-**Expected output:** Worker running with PID and health OK
-
-## Fix: Dependencies Missing
-
-**Use when:** Worker won't start due to missing packages
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/ && \
-npm install && \
-npm run worker:restart
-```
-
-## Fix: Stale PID File
-
-**Use when:** Worker reports running but health check fails
-
-```bash
-rm -f ~/.claude-mem/worker.pid && \
-cd ~/.claude/plugins/marketplaces/thedotmack/ && \
-npm run worker:start && \
-sleep 2 && \
-curl -s http://127.0.0.1:37777/health
-```
-
-**Expected output:** `{"status":"ok"}`
-
-## Fix: Port Conflict
-
-**Use when:** Error shows port already in use
-
-```bash
-# Change to port 37778
-mkdir -p ~/.claude-mem && \
-echo '{"CLAUDE_MEM_WORKER_PORT":"37778"}' > ~/.claude-mem/settings.json && \
-cd ~/.claude/plugins/marketplaces/thedotmack/ && \
-npm run worker:restart && \
-sleep 2 && \
-curl -s http://127.0.0.1:37778/health
-```
-
-**Expected output:** `{"status":"ok"}`
-
-## Fix: Database Issues
-
-**Use when:** Database appears corrupted or out of sync
-
-```bash
-# Backup and test integrity
-cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.backup && \
-sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;" && \
-cd ~/.claude/plugins/marketplaces/thedotmack/ && \
-npm run worker:restart
-```
-
-**If integrity check fails, recreate database:**
-```bash
-# WARNING: This deletes all memory data
-mv ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.old && \
-cd ~/.claude/plugins/marketplaces/thedotmack/ && \
-npm run worker:restart
-```
-
-## Fix: Clean Reinstall
-
-**Use when:** All else fails, nuclear option
-
-```bash
-# Backup data first
-cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.backup 2>/dev/null
-
-# Stop worker
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:stop
-
-# Clean PID file
-rm -f ~/.claude-mem/worker.pid
-
-# Reinstall dependencies
-rm -rf node_modules && \
-npm install
-
-# Start worker
-npm run worker:start && \
-sleep 3 && \
-curl -s http://127.0.0.1:37777/health
-```
-
-## Fix: Clear Old Logs
-
-**Use when:** Want to start with fresh logs
-
-```bash
-# Archive old logs
-tar -czf ~/.claude-mem/logs-archive-$(date +%Y-%m-%d).tar.gz ~/.claude-mem/logs/*.log 2>/dev/null
-
-# Remove logs older than 7 days
-find ~/.claude-mem/logs/ -name "worker-*.log" -mtime +7 -delete
-
-# Restart worker for fresh log
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:restart
-```
-
-**Note:** Logs auto-rotate daily, manual cleanup rarely needed.
-
-## Verification Commands
-
-**After running any fix, verify with these:**
-
-```bash
-# Check worker status
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:status
-
-# Check health
-curl -s http://127.0.0.1:37777/health
-
-# Check database
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
-
-# Check viewer
-curl -s http://127.0.0.1:37777/api/stats
-
-# Check logs for errors
-grep -i "error" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log | tail -20
-```
-
-**All checks should pass:**
-- Worker status: Shows PID and "Health: OK"
-- Health endpoint: `{"status":"ok"}`
-- Database: Shows count (may be 0 if new)
-- Stats: Returns JSON with counts
-- Logs: No recent errors
-
-## One-Line Complete Diagnostic
-
-**Quick health check:**
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/ && npm run worker:status && curl -s http://127.0.0.1:37777/health && echo " ✓ All systems OK"
-```
-
-## Troubleshooting the Fixes
-
-**If automated fix fails:**
-1. Run the diagnostic script from [diagnostics.md](diagnostics.md)
-2. Check specific error in worker logs:
-   ```bash
-   tail -50 ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-   ```
-3. Try manual worker start to see detailed error:
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   bun plugin/scripts/worker-service.js
-   ```
-4. Use the bug report tool:
-   ```bash
-   npm run bug-report
-   ```
-
-## Common Error Patterns and Fixes
-
-| Error Pattern | Likely Cause | Quick Fix |
-|---------------|--------------|-----------|
-| `EADDRINUSE` | Port conflict | Change port in settings.json |
-| `SQLITE_ERROR` | Database corruption | Run integrity check, recreate if needed |
-| `ENOENT` | Missing files | Run `npm install` |
-| `Module not found` | Dependency issue | Clean reinstall |
-| Connection refused | Worker not running | `npm run worker:start` |
-| Stale PID | Old PID file | Remove `~/.claude-mem/worker.pid` |

plugin/skills/troubleshoot/operations/common-issues.md

@@ -1,237 +0,0 @@
-# Common Issue Resolutions
-
-Quick fixes for frequently encountered claude-mem problems.
-
-## Issue: Nothing is Remembered After `/clear` {#nothing-remembered}
-
-**Symptoms:**
-- Data doesn't persist across sessions
-- Context is empty after `/clear`
-- Search returns no results for past work
-
-**Root cause:** Sessions are marked complete but data should persist. This suggests:
-- Worker not processing observations
-- Database not being written to
-- Context hook not reading from database
-
-**Fix:**
-1. Verify worker is running:
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   npm run worker:status
-   ```
-
-2. Check database has recent observations:
-   ```bash
-   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations WHERE created_at > datetime('now', '-1 day');"
-   ```
-
-3. Restart worker and start new session:
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   npm run worker:restart
-   ```
-
-4. Create a test observation: `/skill version-bump` then cancel
-
-5. Check if observation appears in viewer:
-   ```bash
-   open http://127.0.0.1:37777
-   # Or manually check database:
-   sqlite3 ~/.claude-mem/claude-mem.db "SELECT * FROM observations ORDER BY created_at DESC LIMIT 1;"
-   ```
-
-## Issue: Viewer Empty After Every Claude Restart {#viewer-empty}
-
-**Symptoms:**
-- Viewer shows no data at http://127.0.0.1:37777
-- Stats endpoint returns all zeros
-- Database appears empty in UI
-
-**Root cause:**
-- Database being recreated on startup (shouldn't happen)
-- Worker reading from wrong database location
-- Database permissions issue
-
-**Fix:**
-1. Check database file exists and has data:
-   ```bash
-   ls -lh ~/.claude-mem/claude-mem.db
-   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
-   ```
-
-2. Check file permissions:
-   ```bash
-   ls -la ~/.claude-mem/claude-mem.db
-   # Should be readable/writable by your user
-   ```
-
-3. Verify worker is using correct database path in logs:
-   ```bash
-   grep "Database" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-   ```
-
-4. Test viewer connection manually:
-   ```bash
-   curl -s http://127.0.0.1:37777/api/stats
-   # Should show non-zero counts if data exists
-   ```
-
-## Issue: Old Memory in Claude {#old-memory}
-
-**Symptoms:**
-- Context contains outdated observations
-- Irrelevant past work appearing in sessions
-- Context feels stale
-
-**Root cause:** Context hook injecting stale observations
-
-**Fix:**
-1. Check the observation count setting:
-   ```bash
-   grep CLAUDE_MEM_CONTEXT_OBSERVATIONS ~/.claude-mem/settings.json
-   ```
-
-2. Default is 50 observations - you can adjust this:
-   ```json
-   {
-     "env": {
-       "CLAUDE_MEM_CONTEXT_OBSERVATIONS": "25"
-     }
-   }
-   ```
-
-3. Check database for actual observation dates:
-   ```bash
-   sqlite3 ~/.claude-mem/claude-mem.db "SELECT created_at, project, title FROM observations ORDER BY created_at DESC LIMIT 10;"
-   ```
-
-4. Consider filtering by project if working on multiple codebases
-
-## Issue: Worker Not Starting {#worker-not-starting}
-
-**Symptoms:**
-- Worker status shows not running or error
-- Health check fails
-- Viewer not accessible
-
-**Root cause:**
-- Port already in use
-- Bun not installed
-- Missing dependencies
-
-**Fix:**
-1. Try manual worker start to see error:
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   bun plugin/scripts/worker-service.js
-   # Should start server on port 37777 or show error
-   ```
-
-2. If port in use, change it:
-   ```bash
-   mkdir -p ~/.claude-mem
-   echo '{"CLAUDE_MEM_WORKER_PORT":"37778"}' > ~/.claude-mem/settings.json
-   ```
-
-3. If dependencies missing:
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   npm install
-   npm run worker:start
-   ```
-
-## Issue: Search Results Empty
-
-**Symptoms:**
-- Search skill returns no results
-- API endpoints return empty arrays
-- Know there's data but can't find it
-
-**Root cause:**
-- FTS5 tables not synchronized
-- Wrong project filter
-- Database not being queried correctly
-
-**Fix:**
-1. Check if observations exist in database:
-   ```bash
-   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
-   ```
-
-2. Check FTS5 table sync:
-   ```bash
-   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations_fts;"
-   # Should match observation count
-   ```
-
-3. Try search via API directly:
-   ```bash
-   curl "http://127.0.0.1:37777/api/search/observations?q=test&format=index"
-   ```
-
-4. If FTS5 out of sync, restart worker (triggers reindex):
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   npm run worker:restart
-   ```
-
-## Issue: Port Conflicts
-
-**Symptoms:**
-- Worker won't start
-- Error: "EADDRINUSE: address already in use"
-- Health check fails
-
-**Fix:**
-1. Check what's using port 37777:
-   ```bash
-   lsof -i :37777
-   ```
-
-2. Either kill the conflicting process or change claude-mem port:
-   ```bash
-   mkdir -p ~/.claude-mem
-   echo '{"CLAUDE_MEM_WORKER_PORT":"37778"}' > ~/.claude-mem/settings.json
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   npm run worker:restart
-   ```
-
-## Issue: Database Corrupted
-
-**Symptoms:**
-- SQLite errors in logs
-- Worker crashes on startup
-- Queries fail
-
-**Fix:**
-1. Backup the database:
-   ```bash
-   cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.backup
-   ```
-
-2. Try to repair:
-   ```bash
-   sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"
-   ```
-
-3. If repair fails, recreate (loses data):
-   ```bash
-   rm ~/.claude-mem/claude-mem.db
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   npm run worker:restart
-   # Worker will create new database
-   ```
-
-## Prevention Tips
-
-**Keep claude-mem healthy:**
-- Regularly check viewer UI to see if observations are being captured
-- Monitor database size (shouldn't grow unbounded)
-- Update plugin when new versions are released
-- Keep Claude Code updated
-
-**Performance tuning:**
-- Adjust `CLAUDE_MEM_CONTEXT_OBSERVATIONS` if context is too large/small
-- Use `/clear` to mark sessions complete and start fresh
-- Use search skill to query specific memories instead of loading everything

plugin/skills/troubleshoot/operations/database.md

@@ -1,409 +0,0 @@
-# Database Diagnostics
-
-SQLite database troubleshooting for claude-mem.
-
-## Database Overview
-
-Claude-mem uses SQLite3 for persistent storage:
-- **Location:** `~/.claude-mem/claude-mem.db`
-- **Library:** bun:sqlite (native Bun SQLite, synchronous)
-- **Features:** FTS5 full-text search, triggers, indexes
-- **Tables:** observations, sessions, user_prompts, observations_fts, sessions_fts, prompts_fts
-
-## Basic Database Checks
-
-### Check Database Exists
-
-```bash
-# Check file exists
-ls -lh ~/.claude-mem/claude-mem.db
-
-# Check file size
-du -h ~/.claude-mem/claude-mem.db
-
-# Check permissions
-ls -la ~/.claude-mem/claude-mem.db
-```
-
-**Expected:**
-- File exists
-- Size: 100KB - 10MB+ (depends on usage)
-- Permissions: Readable/writable by your user
-
-### Check Database Integrity
-
-```bash
-# Run integrity check
-sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"
-```
-
-**Expected output:** `ok`
-
-**If errors appear:**
-- Database corrupted
-- Backup immediately: `cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.backup`
-- Consider recreating (data loss)
-
-## Data Inspection
-
-### Count Records
-
-```bash
-# Observation count
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
-
-# Session count
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM sessions;"
-
-# User prompt count
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM user_prompts;"
-
-# FTS5 table counts (should match main tables)
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations_fts;"
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM sessions_fts;"
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM prompts_fts;"
-```
-
-### View Recent Records
-
-```bash
-# Recent observations
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT
-  created_at,
-  type,
-  title,
-  project
-FROM observations
-ORDER BY created_at DESC
-LIMIT 10;
-"
-
-# Recent sessions
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT
-  created_at,
-  request,
-  project
-FROM sessions
-ORDER BY created_at DESC
-LIMIT 5;
-"
-
-# Recent user prompts
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT
-  created_at,
-  prompt
-FROM user_prompts
-ORDER BY created_at DESC
-LIMIT 10;
-"
-```
-
-### Check Projects
-
-```bash
-# List all projects
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT DISTINCT project
-FROM observations
-ORDER BY project;
-"
-
-# Count observations per project
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT
-  project,
-  COUNT(*) as count
-FROM observations
-GROUP BY project
-ORDER BY count DESC;
-"
-```
-
-## Database Schema
-
-### View Table Structure
-
-```bash
-# List all tables
-sqlite3 ~/.claude-mem/claude-mem.db ".tables"
-
-# Show observations table schema
-sqlite3 ~/.claude-mem/claude-mem.db ".schema observations"
-
-# Show all schemas
-sqlite3 ~/.claude-mem/claude-mem.db ".schema"
-```
-
-### Expected Tables
-
-- `observations` - Main observation records
-- `observations_fts` - FTS5 virtual table for full-text search
-- `sessions` - Session summary records
-- `sessions_fts` - FTS5 virtual table for session search
-- `user_prompts` - User prompt records
-- `prompts_fts` - FTS5 virtual table for prompt search
-
-## FTS5 Synchronization
-
-The FTS5 tables should stay synchronized with main tables via triggers.
-
-### Check FTS5 Sync
-
-```bash
-# Compare counts
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT
-  (SELECT COUNT(*) FROM observations) as observations,
-  (SELECT COUNT(*) FROM observations_fts) as observations_fts,
-  (SELECT COUNT(*) FROM sessions) as sessions,
-  (SELECT COUNT(*) FROM sessions_fts) as sessions_fts,
-  (SELECT COUNT(*) FROM user_prompts) as prompts,
-  (SELECT COUNT(*) FROM prompts_fts) as prompts_fts;
-"
-```
-
-**Expected:** All pairs should match (observations = observations_fts, etc.)
-
-### Fix FTS5 Desync
-
-If FTS5 counts don't match, triggers may have failed. Restart worker to rebuild:
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:restart
-```
-
-The worker will rebuild FTS5 indexes on startup if they're out of sync.
-
-## Common Database Issues
-
-### Issue: Database Doesn't Exist
-
-**Cause:** First run, or database was deleted
-
-**Fix:** Database will be created automatically on first observation. No action needed.
-
-### Issue: Database is Empty (0 Records)
-
-**Cause:**
-- New installation (normal)
-- Data was deleted
-- Worker not processing observations
-
-**Fix:**
-1. Create test observation (use any skill and cancel)
-2. Check worker logs for errors:
-   ```bash
-   tail -50 ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-   ```
-3. Verify observation appears in database
-
-### Issue: Database Permission Denied
-
-**Cause:** File permissions wrong, database owned by different user
-
-**Fix:**
-```bash
-# Check ownership
-ls -la ~/.claude-mem/claude-mem.db
-
-# Fix permissions (if needed)
-chmod 644 ~/.claude-mem/claude-mem.db
-chown $USER ~/.claude-mem/claude-mem.db
-```
-
-### Issue: Database Locked
-
-**Cause:**
-- Multiple processes accessing database
-- Crash left lock file
-- Long-running transaction
-
-**Fix:**
-```bash
-# Check for lock file
-ls -la ~/.claude-mem/claude-mem.db-wal
-ls -la ~/.claude-mem/claude-mem.db-shm
-
-# Remove lock files (only if worker is stopped!)
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:stop
-rm ~/.claude-mem/claude-mem.db-wal ~/.claude-mem/claude-mem.db-shm
-npm run worker:start
-```
-
-### Issue: Database Growing Too Large
-
-**Cause:** Too many observations accumulated
-
-**Check size:**
-```bash
-du -h ~/.claude-mem/claude-mem.db
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
-```
-
-**Options:**
-1. Delete old observations (manual cleanup):
-   ```bash
-   sqlite3 ~/.claude-mem/claude-mem.db "
-   DELETE FROM observations
-   WHERE created_at < datetime('now', '-90 days');
-   "
-   ```
-
-2. Vacuum to reclaim space:
-   ```bash
-   sqlite3 ~/.claude-mem/claude-mem.db "VACUUM;"
-   ```
-
-3. Archive and start fresh:
-   ```bash
-   mv ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.archive
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   npm run worker:restart
-   ```
-
-## Database Recovery
-
-### Backup Database
-
-**Before any destructive operations:**
-```bash
-cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.backup
-```
-
-### Restore from Backup
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:stop
-cp ~/.claude-mem/claude-mem.db.backup ~/.claude-mem/claude-mem.db
-npm run worker:start
-```
-
-### Export Data
-
-Export to JSON for safekeeping:
-
-```bash
-# Export observations
-sqlite3 ~/.claude-mem/claude-mem.db -json "SELECT * FROM observations;" > observations.json
-
-# Export sessions
-sqlite3 ~/.claude-mem/claude-mem.db -json "SELECT * FROM sessions;" > sessions.json
-
-# Export prompts
-sqlite3 ~/.claude-mem/claude-mem.db -json "SELECT * FROM user_prompts;" > prompts.json
-```
-
-### Recreate Database
-
-**WARNING: Data loss. Backup first!**
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-
-# Stop worker
-npm run worker:stop
-
-# Backup current database
-cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.old
-
-# Delete database
-rm ~/.claude-mem/claude-mem.db
-
-# Start worker (creates new database)
-npm run worker:start
-```
-
-## Database Statistics
-
-### Storage Analysis
-
-```bash
-# Database file size
-du -h ~/.claude-mem/claude-mem.db
-
-# Record counts by type
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT
-  type,
-  COUNT(*) as count
-FROM observations
-GROUP BY type
-ORDER BY count DESC;
-"
-
-# Observations per month
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT
-  strftime('%Y-%m', created_at) as month,
-  COUNT(*) as count
-FROM observations
-GROUP BY month
-ORDER BY month DESC;
-"
-
-# Average observation size (characters)
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT
-  AVG(LENGTH(content)) as avg_content_length,
-  MAX(LENGTH(content)) as max_content_length
-FROM observations;
-"
-```
-
-## Advanced Queries
-
-### Find Specific Observations
-
-```bash
-# Search by keyword (FTS5)
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT title, created_at
-FROM observations_fts
-WHERE observations_fts MATCH 'authentication'
-ORDER BY created_at DESC;
-"
-
-# Find by type
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT title, created_at
-FROM observations
-WHERE type = 'bugfix'
-ORDER BY created_at DESC
-LIMIT 10;
-"
-
-# Find by file path
-sqlite3 ~/.claude-mem/claude-mem.db "
-SELECT title, created_at
-FROM observations
-WHERE file_path LIKE '%auth%'
-ORDER BY created_at DESC;
-"
-```
-
-## Database Maintenance
-
-### Regular Maintenance Tasks
-
-```bash
-# Analyze for query optimization
-sqlite3 ~/.claude-mem/claude-mem.db "ANALYZE;"
-
-# Rebuild FTS5 indexes
-sqlite3 ~/.claude-mem/claude-mem.db "
-INSERT INTO observations_fts(observations_fts) VALUES('rebuild');
-INSERT INTO sessions_fts(sessions_fts) VALUES('rebuild');
-INSERT INTO prompts_fts(prompts_fts) VALUES('rebuild');
-"
-
-# Vacuum to reclaim space
-sqlite3 ~/.claude-mem/claude-mem.db "VACUUM;"
-```
-
-**Run monthly to keep database healthy.**

plugin/skills/troubleshoot/operations/diagnostics.md

@@ -1,309 +0,0 @@
-# Full System Diagnostics
-
-Comprehensive step-by-step diagnostic workflow for claude-mem issues.
-
-## Diagnostic Workflow
-
-Run these checks systematically to identify the root cause:
-
-### 1. Check Worker Status
-
-First, verify if the worker service is running:
-
-```bash
-# Check worker status using npm script
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:status
-
-# Or check health endpoint directly
-curl -s http://127.0.0.1:37777/health
-```
-
-**Expected output from npm run worker:status:**
-```
-✓ Worker is running (PID: 12345)
-  Port: 37777
-  Uptime: 45m
-  Health: OK
-```
-
-**Expected output from health endpoint:** `{"status":"ok"}`
-
-**If worker not running:**
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:start
-```
-
-**If health endpoint fails but worker reports running:**
-Check for stale PID file:
-```bash
-cat ~/.claude-mem/worker.pid
-ps -p $(cat ~/.claude-mem/worker.pid 2>/dev/null | grep -o '"pid":[0-9]*' | grep -o '[0-9]*') 2>/dev/null || echo "Stale PID - worker not actually running"
-rm ~/.claude-mem/worker.pid
-npm run worker:start
-```
-
-### 2. Check Worker Service Health
-
-Test if the worker service responds to HTTP requests:
-
-```bash
-# Default port is 37777
-curl -s http://127.0.0.1:37777/health
-
-# Check custom port from settings
-PORT=$(cat ~/.claude-mem/settings.json 2>/dev/null | grep CLAUDE_MEM_WORKER_PORT | grep -o '[0-9]\+' || echo "37777")
-curl -s http://127.0.0.1:$PORT/health
-```
-
-**Expected output:** `{"status":"ok"}`
-
-**If connection refused:**
-- Worker not running → Go back to step 1
-- Port conflict → Check what's using the port:
-  ```bash
-  lsof -i :37777 || netstat -tlnp | grep 37777
-  ```
-
-### 3. Check Database
-
-Verify the database exists and contains data:
-
-```bash
-# Check if database file exists
-ls -lh ~/.claude-mem/claude-mem.db
-
-# Check database size (should be > 0 bytes)
-du -h ~/.claude-mem/claude-mem.db
-
-# Query database for observation count (requires sqlite3)
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) as observation_count FROM observations;" 2>&1
-
-# Query for session count
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) as session_count FROM sessions;" 2>&1
-
-# Check recent observations
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT created_at, type, title FROM observations ORDER BY created_at DESC LIMIT 5;" 2>&1
-```
-
-**Expected:**
-- Database file exists (typically 100KB - 10MB+)
-- Contains observations and sessions
-- Recent observations visible
-
-**If database missing or empty:**
-- New installation - this is normal, database will populate as you work
-- After `/clear` - sessions are marked complete but not deleted, data should persist
-- Corrupted database - backup and recreate:
-  ```bash
-  cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.backup
-  # Worker will recreate on next observation
-  ```
-
-### 4. Check Dependencies Installation
-
-Verify all required npm packages are installed:
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-
-# Check for critical packages
-ls node_modules/@anthropic-ai/claude-agent-sdk 2>&1 | head -1
-ls node_modules/express 2>&1 | head -1
-
-# Check if Bun is available
-bun --version 2>&1
-```
-
-**Expected:** All critical packages present, Bun installed
-
-**If dependencies missing:**
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm install
-```
-
-### 5. Check Worker Logs
-
-Review recent worker logs for errors:
-
-```bash
-# View logs using npm script
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:logs
-
-# View today's log file directly
-cat ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Last 50 lines
-tail -50 ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Check for specific errors
-grep -iE "error|exception|failed" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log | tail -20
-```
-
-**Common error patterns to look for:**
-- `SQLITE_ERROR` - Database issues
-- `EADDRINUSE` - Port conflict
-- `ENOENT` - Missing files
-- `Module not found` - Dependency issues
-
-### 6. Test Viewer UI
-
-Check if the web viewer is accessible:
-
-```bash
-# Test viewer endpoint
-curl -s http://127.0.0.1:37777/ | head -20
-
-# Test stats endpoint
-curl -s http://127.0.0.1:37777/api/stats
-```
-
-**Expected:**
-- `/` returns HTML page with React viewer
-- `/api/stats` returns JSON with database counts
-
-### 7. Check Port Configuration
-
-Verify port settings and availability:
-
-```bash
-# Check if custom port is configured
-cat ~/.claude-mem/settings.json 2>/dev/null
-cat ~/.claude/settings.json 2>/dev/null
-
-# Check what's listening on default port
-lsof -i :37777 2>&1 || netstat -tlnp 2>&1 | grep 37777
-
-# Test connectivity
-nc -zv 127.0.0.1 37777 2>&1
-```
-
-## Full System Diagnosis Script
-
-Run this comprehensive diagnostic script to collect all information:
-
-```bash
-#!/bin/bash
-echo "=== Claude-Mem Troubleshooting Report ==="
-echo ""
-echo "1. Environment"
-echo "   OS: $(uname -s)"
-echo "   Node version: $(node --version 2>/dev/null || echo 'N/A')"
-echo "   Bun version: $(bun --version 2>/dev/null || echo 'N/A')"
-echo ""
-echo "2. Plugin Installation"
-echo "   Plugin directory exists: $([ -d ~/.claude/plugins/marketplaces/thedotmack ] && echo 'YES' || echo 'NO')"
-echo "   Package version: $(grep '"version"' ~/.claude/plugins/marketplaces/thedotmack/package.json 2>/dev/null | head -1)"
-echo ""
-echo "3. Database"
-echo "   Database exists: $([ -f ~/.claude-mem/claude-mem.db ] && echo 'YES' || echo 'NO')"
-echo "   Database size: $(du -h ~/.claude-mem/claude-mem.db 2>/dev/null | cut -f1)"
-echo "   Observation count: $(sqlite3 ~/.claude-mem/claude-mem.db 'SELECT COUNT(*) FROM observations;' 2>/dev/null || echo 'N/A')"
-echo "   Session count: $(sqlite3 ~/.claude-mem/claude-mem.db 'SELECT COUNT(*) FROM sessions;' 2>/dev/null || echo 'N/A')"
-echo ""
-echo "4. Worker Service"
-echo "   Worker PID file: $([ -f ~/.claude-mem/worker.pid ] && echo 'EXISTS' || echo 'MISSING')"
-if [ -f ~/.claude-mem/worker.pid ]; then
-  WORKER_PID=$(cat ~/.claude-mem/worker.pid 2>/dev/null | grep -o '"pid":[0-9]*' | grep -o '[0-9]*')
-  echo "   Worker PID: $WORKER_PID"
-  echo "   Process running: $(ps -p $WORKER_PID >/dev/null 2>&1 && echo 'YES' || echo 'NO (stale PID)')"
-fi
-echo "   Health check: $(curl -s http://127.0.0.1:37777/health 2>/dev/null || echo 'FAILED')"
-echo ""
-echo "5. Configuration"
-echo "   Port setting: $(cat ~/.claude-mem/settings.json 2>/dev/null | grep CLAUDE_MEM_WORKER_PORT || echo 'default (37777)')"
-echo "   Observation count: $(cat ~/.claude-mem/settings.json 2>/dev/null | grep CLAUDE_MEM_CONTEXT_OBSERVATIONS || echo 'default (50)')"
-echo "   Model: $(cat ~/.claude-mem/settings.json 2>/dev/null | grep CLAUDE_MEM_MODEL || echo 'default (claude-sonnet-4-5)')"
-echo ""
-echo "6. Recent Activity"
-echo "   Latest observation: $(sqlite3 ~/.claude-mem/claude-mem.db 'SELECT created_at FROM observations ORDER BY created_at DESC LIMIT 1;' 2>/dev/null || echo 'N/A')"
-echo "   Latest session: $(sqlite3 ~/.claude-mem/claude-mem.db 'SELECT created_at FROM sessions ORDER BY created_at DESC LIMIT 1;' 2>/dev/null || echo 'N/A')"
-echo ""
-echo "7. Logs"
-echo "   Today's log file: $([ -f ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log ] && echo 'EXISTS' || echo 'MISSING')"
-echo "   Log file size: $(du -h ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log 2>/dev/null | cut -f1 || echo 'N/A')"
-echo "   Recent errors: $(grep -c -i "error" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log 2>/dev/null || echo '0')"
-echo ""
-echo "=== End Report ==="
-```
-
-Save this as `/tmp/claude-mem-diagnostics.sh` and run:
-```bash
-bash /tmp/claude-mem-diagnostics.sh
-```
-
-## Quick Diagnostic One-Liners
-
-```bash
-# Full status check
-npm run worker:status && curl -s http://127.0.0.1:37777/health && echo " - All systems OK"
-
-# Database stats
-echo "DB: $(du -h ~/.claude-mem/claude-mem.db | cut -f1) | Obs: $(sqlite3 ~/.claude-mem/claude-mem.db 'SELECT COUNT(*) FROM observations;' 2>/dev/null) | Sessions: $(sqlite3 ~/.claude-mem/claude-mem.db 'SELECT COUNT(*) FROM sessions;' 2>/dev/null)"
-
-# Recent errors
-grep -i "error" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log 2>/dev/null | tail -5 || echo "No recent errors"
-
-# Port check
-lsof -i :37777 || echo "Port 37777 is free"
-
-# Worker process check
-ps aux | grep -E "bun.*worker-service" | grep -v grep || echo "Worker not running"
-```
-
-## Automated Fix Sequence
-
-If diagnostics show issues, run this automated fix sequence:
-
-```bash
-#!/bin/bash
-echo "Running automated fix sequence..."
-
-# 1. Stop worker if running
-echo "1. Stopping worker..."
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:stop
-
-# 2. Clean stale PID if exists
-echo "2. Cleaning stale PID file..."
-rm -f ~/.claude-mem/worker.pid
-
-# 3. Reinstall dependencies
-echo "3. Reinstalling dependencies..."
-npm install
-
-# 4. Start worker
-echo "4. Starting worker..."
-npm run worker:start
-
-# 5. Wait for startup
-echo "5. Waiting for worker to start..."
-sleep 3
-
-# 6. Verify health
-echo "6. Verifying health..."
-curl -s http://127.0.0.1:37777/health || echo "Worker health check FAILED"
-
-echo "Fix sequence complete!"
-```
-
-## Reporting Issues
-
-If troubleshooting doesn't resolve the issue, run the built-in bug report tool:
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run bug-report
-```
-
-This will collect:
-1. Full diagnostic report
-2. Worker logs
-3. System information
-4. Configuration details
-5. Database stats
-
-Post the generated report to: https://github.com/thedotmack/claude-mem/issues

plugin/skills/troubleshoot/operations/reference.md

@@ -1,207 +0,0 @@
-# Quick Commands Reference
-
-Essential commands for troubleshooting claude-mem.
-
-## Worker Management
-
-```bash
-# Check worker status
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:status
-
-# Start worker
-npm run worker:start
-
-# Restart worker
-npm run worker:restart
-
-# Stop worker
-npm run worker:stop
-
-# View logs
-npm run worker:logs
-
-# View today's log file
-cat ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Last 50 lines
-tail -50 ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Follow logs in real-time
-tail -f ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-```
-
-## Health Checks
-
-```bash
-# Check worker health (default port)
-curl -s http://127.0.0.1:37777/health
-
-# Check viewer stats
-curl -s http://127.0.0.1:37777/api/stats
-
-# Open viewer in browser
-open http://127.0.0.1:37777
-
-# Test custom port
-PORT=37778
-curl -s http://127.0.0.1:$PORT/health
-```
-
-## Database Queries
-
-```bash
-# Observation count
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
-
-# Session count
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM sessions;"
-
-# Recent observations
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT created_at, type, title FROM observations ORDER BY created_at DESC LIMIT 10;"
-
-# Recent sessions
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT created_at, request FROM sessions ORDER BY created_at DESC LIMIT 5;"
-
-# Database size
-du -h ~/.claude-mem/claude-mem.db
-
-# Database integrity check
-sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"
-
-# Projects in database
-sqlite3 ~/.claude-mem/claude-mem.db "SELECT DISTINCT project FROM observations ORDER BY project;"
-```
-
-## Configuration
-
-```bash
-# View current settings
-cat ~/.claude-mem/settings.json
-cat ~/.claude/settings.json
-
-# Change worker port
-echo '{"CLAUDE_MEM_WORKER_PORT":"37778"}' > ~/.claude-mem/settings.json
-
-# Change context observation count
-# Edit ~/.claude-mem/settings.json and add:
-{
-  "CLAUDE_MEM_CONTEXT_OBSERVATIONS": "25"
-}
-
-# Change AI model
-{
-  "CLAUDE_MEM_MODEL": "claude-sonnet-4-5"
-}
-```
-
-## Plugin Management
-
-```bash
-# Navigate to plugin directory
-cd ~/.claude/plugins/marketplaces/thedotmack/
-
-# Check plugin version
-grep '"version"' package.json
-
-# Reinstall dependencies
-npm install
-
-# View package.json
-cat package.json
-```
-
-## Port Diagnostics
-
-```bash
-# Check what's using port 37777
-lsof -i :37777
-netstat -tlnp | grep 37777
-
-# Test port connectivity
-nc -zv 127.0.0.1 37777
-curl -v http://127.0.0.1:37777/health
-```
-
-## Log Analysis
-
-```bash
-# Search logs for errors
-grep -i "error" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Search for specific keyword
-grep "keyword" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Search across all log files
-grep -i "error" ~/.claude-mem/logs/worker-*.log
-
-# Last 100 error lines
-grep -i "error" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log | tail -100
-
-# Follow logs in real-time
-tail -f ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-```
-
-## File Locations
-
-```bash
-# Plugin directory
-~/.claude/plugins/marketplaces/thedotmack/
-
-# Database
-~/.claude-mem/claude-mem.db
-
-# Settings
-~/.claude-mem/settings.json
-~/.claude/settings.json
-
-# Chroma vector database
-~/.claude-mem/chroma/
-
-# Worker logs (daily rotation)
-~/.claude-mem/logs/worker-*.log
-
-# Worker PID file
-~/.claude-mem/worker.pid
-```
-
-## System Information
-
-```bash
-# OS version
-uname -a
-
-# Node version
-node --version
-
-# NPM version
-npm --version
-
-# Bun version
-bun --version
-
-# SQLite version
-sqlite3 --version
-
-# Check disk space
-df -h ~/.claude-mem/
-```
-
-## One-Line Diagnostics
-
-```bash
-# Full worker status check
-npm run worker:status && curl -s http://127.0.0.1:37777/health
-
-# Quick health check
-curl -s http://127.0.0.1:37777/health && echo " - Worker is healthy"
-
-# Database stats
-echo "Observations: $(sqlite3 ~/.claude-mem/claude-mem.db 'SELECT COUNT(*) FROM observations;')" && echo "Sessions: $(sqlite3 ~/.claude-mem/claude-mem.db 'SELECT COUNT(*) FROM sessions;')"
-
-# Recent errors
-grep -i "error" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log | tail -10
-
-# Port check
-lsof -i :37777 || echo "Port 37777 is free"
-```

plugin/skills/troubleshoot/operations/worker.md

@@ -1,362 +0,0 @@
-# Worker Service Diagnostics
-
-Bun worker-specific troubleshooting for claude-mem.
-
-## Worker Overview
-
-The claude-mem worker is a persistent background service managed by Bun. It:
-- Runs Express.js server on port 37777 (default)
-- Processes observations asynchronously
-- Serves the viewer UI
-- Provides search API endpoints
-
-## Check Worker Status
-
-### Basic Status Check
-
-```bash
-# Check worker status using npm script
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:status
-
-# Or check health endpoint directly
-curl -s http://127.0.0.1:37777/health
-```
-
-**Expected npm run worker:status output:**
-```
-✓ Worker is running (PID: 12345)
-  Port: 37777
-  Uptime: 45m
-  Health: OK
-```
-
-**Expected health endpoint output:**
-```json
-{"status":"ok"}
-```
-
-**Status indicators:**
-- `Worker is running` - Worker running correctly
-- `Worker is not running` - Worker stopped or crashed
-- Connection refused - Worker not running
-- Timeout - Worker hung (restart needed)
-
-### Detailed Worker Info
-
-```bash
-# View PID file
-cat ~/.claude-mem/worker.pid
-
-# Check process details
-ps aux | grep "bun.*worker-service"
-```
-
-## Worker Health Endpoint
-
-The worker exposes a health endpoint at `/health`:
-
-```bash
-# Check health (default port)
-curl -s http://127.0.0.1:37777/health
-
-# With custom port
-PORT=$(grep CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json | grep -o '[0-9]\+' || echo "37777")
-curl -s http://127.0.0.1:$PORT/health
-```
-
-**Expected response:** `{"status":"ok"}`
-
-**Error responses:**
-- Connection refused - Worker not running
-- Timeout - Worker hung (restart needed)
-- Empty response - Worker crashed mid-request
-
-## Worker Logs
-
-### View Recent Logs
-
-```bash
-# View logs using npm script
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:logs
-
-# View today's log file directly
-cat ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Last 50 lines of today's log
-tail -50 ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Follow logs in real-time
-tail -f ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-```
-
-### Search Logs for Errors
-
-```bash
-# Find errors in today's log
-grep -i "error" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Find exceptions
-grep -i "exception" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Find failed requests
-grep -i "failed" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# All error patterns
-grep -iE "error|exception|failed|crash" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# Search across all log files
-grep -iE "error|exception|failed|crash" ~/.claude-mem/logs/worker-*.log
-```
-
-### Common Log Patterns
-
-**Good startup:**
-```
-Worker service started on port 37777
-Database initialized
-Express server listening
-```
-
-**Database errors:**
-```
-Error: SQLITE_ERROR
-Error initializing database
-Database locked
-```
-
-**Port conflicts:**
-```
-Error: listen EADDRINUSE
-Port 37777 already in use
-```
-
-**Crashes:**
-```
-Worker process exited with code 1
-Worker restarting...
-```
-
-## Starting the Worker
-
-### Basic Start
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:start
-```
-
-### Force Restart
-
-```bash
-# Restart worker (stops and starts)
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:restart
-
-# Or manually stop and start
-npm run worker:stop
-npm run worker:start
-```
-
-## Stopping the Worker
-
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm run worker:stop
-```
-
-## Worker Not Starting
-
-### Diagnostic Steps
-
-1. **Try manual start to see error:**
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   bun plugin/scripts/worker-service.js
-   ```
-   This runs the worker directly, showing full error output.
-
-2. **Check Bun installation:**
-   ```bash
-   which bun
-   bun --version
-   ```
-   If Bun not found, run: `npm install` (auto-installs Bun)
-
-3. **Check dependencies:**
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   ls node_modules/@anthropic-ai/claude-agent-sdk
-   ls node_modules/express
-   ```
-
-4. **Check port availability:**
-   ```bash
-   lsof -i :37777
-   ```
-   If port in use, either kill that process or change claude-mem port.
-
-5. **Check PID file:**
-   ```bash
-   cat ~/.claude-mem/worker.pid
-   ```
-   If worker PID exists but process is dead, remove stale PID:
-   ```bash
-   rm ~/.claude-mem/worker.pid
-   npm run worker:start
-   ```
-
-### Common Fixes
-
-**Dependencies missing:**
-```bash
-cd ~/.claude/plugins/marketplaces/thedotmack/
-npm install
-npm run worker:start
-```
-
-**Port conflict:**
-```bash
-echo '{"CLAUDE_MEM_WORKER_PORT":"37778"}' > ~/.claude-mem/settings.json
-npm run worker:restart
-```
-
-**Stale PID file:**
-```bash
-rm ~/.claude-mem/worker.pid
-npm run worker:start
-```
-
-## Worker Crashing Repeatedly
-
-If worker keeps restarting (check logs for repeated startup messages):
-
-### Find the Cause
-
-1. **Check error logs:**
-   ```bash
-   grep -i "error" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log | tail -100
-   ```
-
-2. **Look for crash pattern:**
-   ```bash
-   grep -A 5 "exited with code" ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-   ```
-
-3. **Run worker in foreground to see crashes:**
-   ```bash
-   cd ~/.claude/plugins/marketplaces/thedotmack/
-   bun plugin/scripts/worker-service.js
-   ```
-
-### Common Crash Causes
-
-**Database corruption:**
-```bash
-sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"
-```
-If fails, backup and recreate database.
-
-**Out of memory:**
-Check if database is too large or memory leak. Restart:
-```bash
-npm run worker:restart
-```
-
-**Port conflict race condition:**
-Another process grabbing port intermittently. Change port:
-```bash
-echo '{"CLAUDE_MEM_WORKER_PORT":"37778"}' > ~/.claude-mem/settings.json
-npm run worker:restart
-```
-
-## Worker Management Commands
-
-```bash
-# Check status
-npm run worker:status
-
-# Start worker
-npm run worker:start
-
-# Stop worker
-npm run worker:stop
-
-# Restart worker
-npm run worker:restart
-
-# View logs
-npm run worker:logs
-
-# Check health endpoint
-curl -s http://127.0.0.1:37777/health
-
-# View PID
-cat ~/.claude-mem/worker.pid
-
-# View today's log file
-cat ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# List all log files
-ls -lh ~/.claude-mem/logs/worker-*.log
-```
-
-## Log File Management
-
-Worker logs are stored in `~/.claude-mem/logs/` with daily rotation:
-
-```bash
-# View today's log
-cat ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
-
-# View yesterday's log
-cat ~/.claude-mem/logs/worker-$(date -d "yesterday" +%Y-%m-%d).log  # Linux
-cat ~/.claude-mem/logs/worker-$(date -v-1d +%Y-%m-%d).log          # macOS
-
-# List all logs
-ls -lh ~/.claude-mem/logs/
-
-# Clean old logs (older than 7 days)
-find ~/.claude-mem/logs/ -name "worker-*.log" -mtime +7 -delete
-
-# Archive logs
-tar -czf ~/claude-mem-logs-backup-$(date +%Y-%m-%d).tar.gz ~/.claude-mem/logs/
-```
-
-**Note:** Logs auto-rotate daily. No manual flush required.
-
-## Testing Worker Endpoints
-
-Once worker is running, test all endpoints:
-
-```bash
-# Health check
-curl -s http://127.0.0.1:37777/health
-
-# Viewer HTML
-curl -s http://127.0.0.1:37777/ | head -20
-
-# Stats API
-curl -s http://127.0.0.1:37777/api/stats
-
-# Search API
-curl -s "http://127.0.0.1:37777/api/search?query=test&limit=5"
-
-# Recent context
-curl -s "http://127.0.0.1:37777/api/context/recent?limit=3"
-```
-
-All should return appropriate responses (HTML for viewer, JSON for APIs).
-
-## Troubleshooting Quick Reference
-
-| Problem | Command | Expected Result |
-|---------|---------|----------------|
-| Check if running | `npm run worker:status` | Shows PID and uptime |
-| Worker not running | `npm run worker:start` | Worker starts successfully |
-| Worker crashed | `npm run worker:restart` | Worker restarts |
-| View recent errors | `grep -i error ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log \| tail -20` | Shows recent errors |
-| Port in use | `lsof -i :37777` | Shows process using port |
-| Stale PID | `rm ~/.claude-mem/worker.pid && npm run worker:start` | Removes stale PID and starts |
-| Dependencies missing | `npm install && npm run worker:start` | Installs deps and starts |

scripts/build-hooks.js

@@ -191,28 +191,11 @@ async function buildHooks() {
       console.log(`✓ ${hook.name} built (${sizeInKB} KB)`);
     }
 
-    // Build mem-search skill zip for Claude Desktop
-    console.log('\n📦 Building mem-search skill zip for Claude Desktop...');
-    const { execSync } = await import('child_process');
-    const zipOutput = 'plugin/skills/mem-search.zip';
-
-    // Remove old zip if exists
-    if (fs.existsSync(zipOutput)) {
-      fs.unlinkSync(zipOutput);
-    }
-
-    // Create zip from mem-search skill directory
-    execSync(`cd plugin/skills && zip -r mem-search.zip mem-search/`, { stdio: 'pipe' });
-    const zipStats = fs.statSync(zipOutput);
-    console.log(`✓ mem-search.zip built (${(zipStats.size / 1024).toFixed(2)} KB)`);
-
     console.log('\n✅ All hooks, worker service, and MCP server built successfully!');
     console.log(`   Output: ${hooksDir}/`);
     console.log(`   - Hooks: *-hook.js`);
     console.log(`   - Worker: worker-service.cjs`);
     console.log(`   - MCP Server: mcp-server.cjs`);
-    console.log(`   - Skills: plugin/skills/`);
-    console.log(`   - Desktop Skill: plugin/skills/mem-search.zip`);
     console.log('\n💡 Note: Dependencies will be auto-installed on first hook execution');
 
   } catch (error) {

src/bin/cleanup-duplicates.ts

@@ -15,14 +15,14 @@ function main() {
   console.log('Finding duplicate observations...');
 
   const duplicateObsQuery = db['db'].prepare(`
-    SELECT sdk_session_id, title, subtitle, type, COUNT(*) as count, GROUP_CONCAT(id) as ids
+    SELECT memory_session_id, title, subtitle, type, COUNT(*) as count, GROUP_CONCAT(id) as ids
     FROM observations
-    GROUP BY sdk_session_id, title, subtitle, type
+    GROUP BY memory_session_id, title, subtitle, type
     HAVING count > 1
   `);
 
   const duplicateObs = duplicateObsQuery.all() as Array<{
-    sdk_session_id: string;
+    memory_session_id: string;
     title: string;
     subtitle: string;
     type: string;
@@ -50,14 +50,14 @@ function main() {
   console.log('\n\nFinding duplicate summaries...');
 
   const duplicateSumQuery = db['db'].prepare(`
-    SELECT sdk_session_id, request, completed, learned, COUNT(*) as count, GROUP_CONCAT(id) as ids
+    SELECT memory_session_id, request, completed, learned, COUNT(*) as count, GROUP_CONCAT(id) as ids
     FROM session_summaries
-    GROUP BY sdk_session_id, request, completed, learned
+    GROUP BY memory_session_id, request, completed, learned
     HAVING count > 1
   `);
 
   const duplicateSum = duplicateSumQuery.all() as Array<{
-    sdk_session_id: string;
+    memory_session_id: string;
     request: string;
     completed: string;
     learned: string;

src/hooks/context-hook.ts

@@ -29,7 +29,9 @@ async function contextHook(input?: SessionStartInput): Promise<string> {
 
   const url = `http://127.0.0.1:${port}/api/context/inject?project=${encodeURIComponent(project)}`;
 
-  const response = await fetch(url, { signal: AbortSignal.timeout(HOOK_TIMEOUTS.DEFAULT) });
+  // Note: Removed AbortSignal.timeout due to Windows Bun cleanup issue (libuv assertion)
+  // Worker service has its own timeouts, so client-side timeout is redundant
+  const response = await fetch(url);
 
   if (!response.ok) {
     throw new Error(`Context generation failed: ${response.status}`);

src/hooks/new-hook.ts

@@ -39,8 +39,8 @@ async function newHook(input?: UserPromptSubmitInput): Promise<void> {
       contentSessionId: session_id,
       project,
       prompt
-    }),
-    signal: AbortSignal.timeout(5000)
+    })
+    // Note: Removed signal to avoid Windows Bun cleanup issue (libuv assertion)
   });
 
   if (!initResponse.ok) {
@@ -72,8 +72,8 @@ async function newHook(input?: UserPromptSubmitInput): Promise<void> {
   const response = await fetch(`http://127.0.0.1:${port}/sessions/${sessionDbId}/init`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ userPrompt: cleanedPrompt, promptNumber }),
-    signal: AbortSignal.timeout(5000)
+    body: JSON.stringify({ userPrompt: cleanedPrompt, promptNumber })
+    // Note: Removed signal to avoid Windows Bun cleanup issue (libuv assertion)
   });
 
   if (!response.ok) {

src/hooks/save-hook.ts

@@ -56,8 +56,8 @@ async function saveHook(input?: PostToolUseInput): Promise<void> {
       tool_input,
       tool_response,
       cwd
-    }),
-    signal: AbortSignal.timeout(HOOK_TIMEOUTS.DEFAULT)
+    })
+    // Note: Removed signal to avoid Windows Bun cleanup issue (libuv assertion)
   });
 
   if (!response.ok) {

src/hooks/summary-hook.ts

@@ -60,8 +60,8 @@ async function summaryHook(input?: StopInput): Promise<void> {
       contentSessionId: session_id,
       last_user_message: lastUserMessage,
       last_assistant_message: lastAssistantMessage
-    }),
-    signal: AbortSignal.timeout(HOOK_TIMEOUTS.DEFAULT)
+    })
+    // Note: Removed signal to avoid Windows Bun cleanup issue (libuv assertion)
   });
 
   if (!response.ok) {

src/hooks/user-message-hook.ts

@@ -18,9 +18,10 @@ const port = getWorkerPort();
 const project = basename(process.cwd());
 
 // Fetch formatted context directly from worker API
+// Note: Removed AbortSignal.timeout to avoid Windows Bun cleanup issue (libuv assertion)
 const response = await fetch(
   `http://127.0.0.1:${port}/api/context/inject?project=${encodeURIComponent(project)}&colors=true`,
-  { method: 'GET', signal: AbortSignal.timeout(5000) }
+  { method: 'GET' }
 );
 
 if (!response.ok) {

src/servers/mcp-server.ts

@@ -37,76 +37,7 @@ const WORKER_BASE_URL = `http://${WORKER_HOST}:${WORKER_PORT}`;
  */
 const TOOL_ENDPOINT_MAP: Record<string, string> = {
   'search': '/api/search',
-  'timeline': '/api/timeline',
-  'get_recent_context': '/api/context/recent',
-  'get_context_timeline': '/api/context/timeline',
-  'help': '/api/instructions'
-};
-
-/**
- * Detailed parameter schemas for each tool
- */
-const TOOL_SCHEMAS: Record<string, any> = {
-  search: {
-    query: { type: 'string', description: 'Full-text search query' },
-    type: { type: 'string', description: 'Filter by type: tool_use, tool_result, prompt, summary' },
-    obs_type: { type: 'string', description: 'Observation type filter' },
-    concepts: { type: 'string', description: 'Comma-separated concept tags' },
-    files: { type: 'string', description: 'Comma-separated file paths' },
-    project: { type: 'string', description: 'Project name filter' },
-    dateStart: { type: ['string', 'number'], description: 'Start date (ISO or timestamp)' },
-    dateEnd: { type: ['string', 'number'], description: 'End date (ISO or timestamp)' },
-    limit: { type: 'number', description: 'Max results (default: 10)' },
-    offset: { type: 'number', description: 'Result offset for pagination' },
-    orderBy: { type: 'string', description: 'Sort order: created_at, relevance' }
-  },
-  timeline: {
-    query: { type: 'string', description: 'Search query to find anchor point' },
-    anchor: { type: 'number', description: 'Observation ID as timeline center' },
-    depth_before: { type: 'number', description: 'Observations before anchor (default: 5)' },
-    depth_after: { type: 'number', description: 'Observations after anchor (default: 5)' },
-    type: { type: 'string', description: 'Filter by type' },
-    concepts: { type: 'string', description: 'Comma-separated concept tags' },
-    files: { type: 'string', description: 'Comma-separated file paths' },
-    project: { type: 'string', description: 'Project name filter' }
-  },
-  get_recent_context: {
-    limit: { type: 'number', description: 'Max results (default: 20)' },
-    type: { type: 'string', description: 'Filter by type' },
-    concepts: { type: 'string', description: 'Comma-separated concept tags' },
-    files: { type: 'string', description: 'Comma-separated file paths' },
-    project: { type: 'string', description: 'Project name filter' },
-    dateStart: { type: ['string', 'number'], description: 'Start date' },
-    dateEnd: { type: ['string', 'number'], description: 'End date' }
-  },
-  get_context_timeline: {
-    anchor: { type: 'number', description: 'Observation ID (required)', required: true },
-    depth_before: { type: 'number', description: 'Observations before anchor' },
-    depth_after: { type: 'number', description: 'Observations after anchor' },
-    type: { type: 'string', description: 'Filter by type' },
-    concepts: { type: 'string', description: 'Comma-separated concept tags' },
-    files: { type: 'string', description: 'Comma-separated file paths' },
-    project: { type: 'string', description: 'Project name filter' }
-  },
-  get_observations: {
-    ids: { type: 'array', items: { type: 'number' }, description: 'Array of observation IDs (required)', required: true },
-    orderBy: { type: 'string', description: 'Sort order' },
-    limit: { type: 'number', description: 'Max results' },
-    project: { type: 'string', description: 'Project filter' }
-  },
-  help: {
-    operation: { type: 'string', description: 'Operation type: "observations", "timeline", "sessions", etc.' },
-    topic: { type: 'string', description: 'Specific topic for help' }
-  },
-  get_observation: {
-    id: { type: 'number', description: 'Observation ID (required)', required: true }
-  },
-  get_session: {
-    id: { type: 'number', description: 'Session ID (required)', required: true }
-  },
-  get_prompt: {
-    id: { type: 'number', description: 'Prompt ID (required)', required: true }
-  }
+  'timeline': '/api/timeline'
 };
 
 /**
@@ -154,47 +85,6 @@ async function callWorkerAPI(
   }
 }
 
-/**
- * Call Worker HTTP API with path parameter (GET)
- */
-async function callWorkerAPIWithPath(
-  endpoint: string,
-  id: number
-): Promise<{ content: Array<{ type: 'text'; text: string }>; isError?: boolean }> {
-  logger.debug('HTTP', 'Worker API request (path)', undefined, { endpoint, id });
-
-  try {
-    const url = `${WORKER_BASE_URL}${endpoint}/${id}`;
-    const response = await fetch(url);
-
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`Worker API error (${response.status}): ${errorText}`);
-    }
-
-    const data = await response.json();
-
-    logger.debug('HTTP', 'Worker API success (path)', undefined, { endpoint, id });
-
-    // Wrap raw data in MCP format
-    return {
-      content: [{
-        type: 'text' as const,
-        text: JSON.stringify(data, null, 2)
-      }]
-    };
-  } catch (error: any) {
-    logger.error('HTTP', 'Worker API error (path)', undefined, { endpoint, id, error: error.message });
-    return {
-      content: [{
-        type: 'text' as const,
-        text: `Error calling Worker API: ${error.message}`
-      }],
-      isError: true
-    };
-  }
-}
-
 /**
  * Call Worker HTTP API with POST body
  */
@@ -260,38 +150,42 @@ async function verifyWorkerConnection(): Promise<boolean> {
  */
 const tools = [
   {
-    name: 'get_schema',
-    description: 'Get parameter schema for a tool. Call get_schema(tool_name) for details',
+    name: '__IMPORTANT',
+    description: `3-LAYER WORKFLOW (ALWAYS FOLLOW):
+1. search(query) → Get index with IDs (~50-100 tokens/result)
+2. timeline(anchor=ID) → Get context around interesting results
+3. get_observations([IDs]) → Fetch full details ONLY for filtered IDs
+NEVER fetch full details without filtering first. 10x token savings.`,
     inputSchema: {
       type: 'object',
-      properties: { tool_name: { type: 'string' } },
-      required: ['tool_name']
+      properties: {}
     },
-    handler: async (args: any) => {
-      // Validate tool_name to prevent prototype pollution
-      const toolName = args.tool_name;
-      if (typeof toolName !== 'string' || !Object.hasOwn(TOOL_SCHEMAS, toolName)) {
-        return {
-          content: [{
-            type: 'text' as const,
-            text: `Unknown tool: ${toolName}\n\nAvailable tools: ${Object.keys(TOOL_SCHEMAS).join(', ')}`
-          }],
-          isError: true
-        };
-      }
+    handler: async () => ({
+      content: [{
+        type: 'text' as const,
+        text: `# Memory Search Workflow
 
-      const schema = TOOL_SCHEMAS[toolName];
-      return {
-        content: [{
-          type: 'text' as const,
-          text: `# ${toolName} Parameters\n\n${JSON.stringify(schema, null, 2)}`
-        }]
-      };
-    }
+**3-Layer Pattern (ALWAYS follow this):**
+
+1. **Search** - Get index of results with IDs
+   \`search(query="...", limit=20, project="...")\`
+   Returns: Table with IDs, titles, dates (~50-100 tokens/result)
+
+2. **Timeline** - Get context around interesting results
+   \`timeline(anchor=<ID>, depth_before=3, depth_after=3)\`
+   Returns: Chronological context showing what was happening
+
+3. **Fetch** - Get full details ONLY for relevant IDs
+   \`get_observations(ids=[...])\`  # ALWAYS batch for 2+ items
+   Returns: Complete details (~500-1000 tokens/result)
+
+**Why:** 10x token savings. Never fetch full details without filtering first.`
+      }]
+    })
   },
   {
     name: 'search',
-    description: 'Search memory. All parameters optional - call get_schema("search") for details',
+    description: 'Step 1: Search memory. Returns index with IDs. Params: query, limit, project, type, obs_type, dateStart, dateEnd, offset, orderBy',
     inputSchema: {
       type: 'object',
       properties: {},
@@ -304,7 +198,7 @@ const tools = [
   },
   {
     name: 'timeline',
-    description: 'Timeline context. All parameters optional - call get_schema("timeline") for details',
+    description: 'Step 2: Get context around results. Params: anchor (observation ID) OR query (finds anchor automatically), depth_before, depth_after, project',
     inputSchema: {
       type: 'object',
       properties: {},
@@ -315,78 +209,16 @@ const tools = [
       return await callWorkerAPI(endpoint, args);
     }
   },
-  {
-    name: 'get_recent_context',
-    description: 'Recent context. All parameters optional - call get_schema("get_recent_context") for details',
-    inputSchema: {
-      type: 'object',
-      properties: {},
-      additionalProperties: true
-    },
-    handler: async (args: any) => {
-      const endpoint = TOOL_ENDPOINT_MAP['get_recent_context'];
-      return await callWorkerAPI(endpoint, args);
-    }
-  },
-  {
-    name: 'get_context_timeline',
-    description: 'Timeline around observation ID',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        anchor: {
-          type: 'number',
-          description: 'Observation ID (required). Optional params: get_schema("get_context_timeline")'
-        }
-      },
-      required: ['anchor'],
-      additionalProperties: true
-    },
-    handler: async (args: any) => {
-      const endpoint = TOOL_ENDPOINT_MAP['get_context_timeline'];
-      return await callWorkerAPI(endpoint, args);
-    }
-  },
-  {
-    name: 'help',
-    description: 'Get detailed docs. All parameters optional - call get_schema("help") for details',
-    inputSchema: {
-      type: 'object',
-      properties: {},
-      additionalProperties: true
-    },
-    handler: async (args: any) => {
-      const endpoint = TOOL_ENDPOINT_MAP['help'];
-      return await callWorkerAPI(endpoint, args);
-    }
-  },
-  {
-    name: 'get_observation',
-    description: 'Fetch observation by ID',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        id: {
-          type: 'number',
-          description: 'Observation ID (required)'
-        }
-      },
-      required: ['id']
-    },
-    handler: async (args: any) => {
-      return await callWorkerAPIWithPath('/api/observation', args.id);
-    }
-  },
   {
     name: 'get_observations',
-    description: 'Batch fetch observations',
+    description: 'Step 3: Fetch full details for filtered IDs. Params: ids (array of observation IDs, required), orderBy, limit, project',
     inputSchema: {
       type: 'object',
       properties: {
         ids: {
           type: 'array',
           items: { type: 'number' },
-          description: 'Array of observation IDs (required). Optional params: get_schema("get_observations")'
+          description: 'Array of observation IDs to fetch (required)'
         }
       },
       required: ['ids'],
@@ -395,47 +227,13 @@ const tools = [
     handler: async (args: any) => {
       return await callWorkerAPIPost('/api/observations/batch', args);
     }
-  },
-  {
-    name: 'get_session',
-    description: 'Fetch session by ID',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        id: {
-          type: 'number',
-          description: 'Session ID (required)'
-        }
-      },
-      required: ['id']
-    },
-    handler: async (args: any) => {
-      return await callWorkerAPIWithPath('/api/session', args.id);
-    }
-  },
-  {
-    name: 'get_prompt',
-    description: 'Fetch prompt by ID',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        id: {
-          type: 'number',
-          description: 'Prompt ID (required)'
-        }
-      },
-      required: ['id']
-    },
-    handler: async (args: any) => {
-      return await callWorkerAPIWithPath('/api/prompt', args.id);
-    }
   }
 ];
 
 // Create the MCP server
 const server = new Server(
   {
-    name: 'mem-search-server',
+    name: 'mcp-search-server',
     version: '1.0.0',
   },
   {

src/services/context-generator.ts

@@ -122,7 +122,7 @@ const colors = {
 
 interface Observation {
   id: number;
-  sdk_session_id: string;
+  memory_session_id: string;
   type: string;
   title: string | null;
   subtitle: string | null;
@@ -138,7 +138,7 @@ interface Observation {
 
 interface SessionSummary {
   id: number;
-  sdk_session_id: string;
+  memory_session_id: string;
   request: string | null;
   investigated: string | null;
   learned: string | null;
@@ -246,7 +246,7 @@ export async function generateContext(input?: ContextInput, useColors: boolean =
   // Get recent observations
   const observations = db.db.prepare(`
     SELECT
-      id, sdk_session_id, type, title, subtitle, narrative,
+      id, memory_session_id, type, title, subtitle, narrative,
       facts, concepts, files_read, files_modified, discovery_tokens,
       created_at, created_at_epoch
     FROM observations
@@ -262,7 +262,7 @@ export async function generateContext(input?: ContextInput, useColors: boolean =
 
   // Get recent summaries
   const recentSummaries = db.db.prepare(`
-    SELECT id, sdk_session_id, request, investigated, learned, completed, next_steps, created_at, created_at_epoch
+    SELECT id, memory_session_id, request, investigated, learned, completed, next_steps, created_at, created_at_epoch
     FROM session_summaries
     WHERE project = ?
     ORDER BY created_at_epoch DESC
@@ -275,10 +275,10 @@ export async function generateContext(input?: ContextInput, useColors: boolean =
 
   if (config.showLastMessage && observations.length > 0) {
     const currentSessionId = input?.session_id;
-    const priorSessionObs = observations.find(obs => obs.sdk_session_id !== currentSessionId);
+    const priorSessionObs = observations.find(obs => obs.memory_session_id !== currentSessionId);
 
     if (priorSessionObs) {
-      const priorSessionId = priorSessionObs.sdk_session_id;
+      const priorSessionId = priorSessionObs.memory_session_id;
       const dashedCwd = cwdToDashed(cwd);
       const transcriptPath = path.join(homedir(), '.claude', 'projects', dashedCwd, `${priorSessionId}.jsonl`);
       const messages = extractPriorMessages(transcriptPath);

src/services/sqlite/SessionStore.ts

@@ -44,6 +44,7 @@ export class SessionStore {
     this.ensureDiscoveryTokensColumn();
     this.createPendingMessagesTable();
     this.renameSessionIdColumns();
+    this.repairSessionIdColumnRename();
   }
 
   /**
@@ -583,22 +584,25 @@ export class SessionStore {
    * - sdk_session_id → memory_session_id (memory agent's session for resume)
    */
   private renameSessionIdColumns(): void {
+    const applied = this.db.prepare('SELECT version FROM schema_versions WHERE version = ?').get(17) as SchemaVersion | undefined;
+    if (applied) return;
+
+    // Check if columns are already renamed (idempotent check)
+    const sessionsInfo = this.db.query('PRAGMA table_info(sdk_sessions)').all() as TableColumnInfo[];
+    const hasContentSessionId = sessionsInfo.some(col => col.name === 'content_session_id');
+
+    if (hasContentSessionId) {
+      // Already renamed, just record migration
+      this.db.prepare('INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)').run(17, new Date().toISOString());
+      return;
+    }
+
+    logger.info('DB', 'Renaming session ID columns for semantic clarity');
+
+    // Begin transaction for atomic rename
+    this.db.run('BEGIN TRANSACTION');
+
     try {
-      const applied = this.db.prepare('SELECT version FROM schema_versions WHERE version = ?').get(17) as SchemaVersion | undefined;
-      if (applied) return;
-
-      logger.info('DB', 'Renaming session ID columns for semantic clarity');
-
-      // Check if columns are already renamed (idempotent check)
-      const sessionsInfo = this.db.query('PRAGMA table_info(sdk_sessions)').all() as TableColumnInfo[];
-      const hasContentSessionId = sessionsInfo.some(col => col.name === 'content_session_id');
-
-      if (hasContentSessionId) {
-        // Already renamed, just record migration
-        this.db.prepare('INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)').run(17, new Date().toISOString());
-        return;
-      }
-
       // SQLite 3.25+ supports ALTER TABLE RENAME COLUMN
       // Rename in sdk_sessions table
       this.db.run('ALTER TABLE sdk_sessions RENAME COLUMN claude_session_id TO content_session_id');
@@ -616,16 +620,90 @@ export class SessionStore {
       // Rename in user_prompts table
       this.db.run('ALTER TABLE user_prompts RENAME COLUMN claude_session_id TO content_session_id');
 
+      // Commit transaction
+      this.db.run('COMMIT');
+
       // Record migration
       this.db.prepare('INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)').run(17, new Date().toISOString());
 
       logger.info('DB', 'Successfully renamed session ID columns');
     } catch (error: any) {
+      // Rollback on error
+      this.db.run('ROLLBACK');
       logger.error('DB', 'Session ID column rename migration error', undefined, error);
       throw error;
     }
   }
 
+  /**
+   * Repair session ID column renames (migration 19)
+   * Migration 17 may have been recorded but failed to actually rename columns.
+   * This migration checks each table and renames if needed (idempotent).
+   */
+  private repairSessionIdColumnRename(): void {
+    try {
+      const applied = this.db.prepare('SELECT version FROM schema_versions WHERE version = ?').get(19) as SchemaVersion | undefined;
+      if (applied) return;
+
+      logger.info('DB', 'Checking session ID column renames (repair migration)');
+
+      let repairsNeeded = false;
+
+      // Check and fix sdk_sessions
+      const sessionsInfo = this.db.query('PRAGMA table_info(sdk_sessions)').all() as TableColumnInfo[];
+      if (sessionsInfo.some(col => col.name === 'claude_session_id')) {
+        logger.info('DB', 'Repairing sdk_sessions columns');
+        this.db.run('ALTER TABLE sdk_sessions RENAME COLUMN claude_session_id TO content_session_id');
+        this.db.run('ALTER TABLE sdk_sessions RENAME COLUMN sdk_session_id TO memory_session_id');
+        repairsNeeded = true;
+      }
+
+      // Check and fix pending_messages
+      const pendingInfo = this.db.query('PRAGMA table_info(pending_messages)').all() as TableColumnInfo[];
+      if (pendingInfo.some(col => col.name === 'claude_session_id')) {
+        logger.info('DB', 'Repairing pending_messages columns');
+        this.db.run('ALTER TABLE pending_messages RENAME COLUMN claude_session_id TO content_session_id');
+        repairsNeeded = true;
+      }
+
+      // Check and fix observations
+      const obsInfo = this.db.query('PRAGMA table_info(observations)').all() as TableColumnInfo[];
+      if (obsInfo.some(col => col.name === 'sdk_session_id')) {
+        logger.info('DB', 'Repairing observations columns');
+        this.db.run('ALTER TABLE observations RENAME COLUMN sdk_session_id TO memory_session_id');
+        repairsNeeded = true;
+      }
+
+      // Check and fix session_summaries
+      const summariesInfo = this.db.query('PRAGMA table_info(session_summaries)').all() as TableColumnInfo[];
+      if (summariesInfo.some(col => col.name === 'sdk_session_id')) {
+        logger.info('DB', 'Repairing session_summaries columns');
+        this.db.run('ALTER TABLE session_summaries RENAME COLUMN sdk_session_id TO memory_session_id');
+        repairsNeeded = true;
+      }
+
+      // Check and fix user_prompts
+      const promptsInfo = this.db.query('PRAGMA table_info(user_prompts)').all() as TableColumnInfo[];
+      if (promptsInfo.some(col => col.name === 'claude_session_id')) {
+        logger.info('DB', 'Repairing user_prompts columns');
+        this.db.run('ALTER TABLE user_prompts RENAME COLUMN claude_session_id TO content_session_id');
+        repairsNeeded = true;
+      }
+
+      // Record migration
+      this.db.prepare('INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)').run(19, new Date().toISOString());
+
+      if (repairsNeeded) {
+        logger.info('DB', 'Session ID column rename repairs completed');
+      } else {
+        logger.info('DB', 'No session ID column repairs needed');
+      }
+    } catch (error: any) {
+      logger.error('DB', 'Session ID column rename repair error', undefined, error);
+      throw error;
+    }
+  }
+
   /**
    * Update the memory session ID for a session
    * Called by SDKAgent when it captures the session ID from the first SDK message
@@ -1147,6 +1225,10 @@ export class SessionStore {
     const nowEpoch = now.getTime();
 
     // Pure INSERT OR IGNORE - no updates, no complexity
+    // NOTE: memory_session_id is initialized to contentSessionId as a placeholder for FK purposes.
+    // The REAL memory session ID is captured by SDKAgent from the first SDK response
+    // and stored via updateMemorySessionId(). The resume logic checks if memorySessionId
+    // differs from contentSessionId before using it - see SDKAgent.startSession().
     this.db.prepare(`
       INSERT OR IGNORE INTO sdk_sessions
       (content_session_id, memory_session_id, project, user_prompt, started_at, started_at_epoch, status)

src/services/worker-service.ts

@@ -21,6 +21,12 @@ import { promisify } from 'util';
 
 const execAsync = promisify(exec);
 
+// Build-time injected version constant (set by esbuild define)
+declare const __DEFAULT_PACKAGE_VERSION__: string;
+const BUILT_IN_VERSION = typeof __DEFAULT_PACKAGE_VERSION__ !== 'undefined'
+  ? __DEFAULT_PACKAGE_VERSION__
+  : 'development';
+
 // PID file management for self-spawn pattern
 const DATA_DIR = path.join(homedir(), '.claude-mem');
 const PID_FILE = path.join(DATA_DIR, 'worker.pid');
@@ -56,105 +62,7 @@ function removePidFile(): void {
   }
 }
 
-// Lockfile for CLI command mutual exclusion (prevents race conditions on Windows)
-const LOCK_FILE = path.join(DATA_DIR, 'worker.lock');
-const LOCK_STALE_MS = 120000; // Lock considered stale after 2 minutes
-
-interface LockInfo {
-  pid: number;
-  command: string;
-  startedAt: string;
-}
-
-/**
- * Clean up stale lock from crashed processes
- */
-function cleanupStaleLock(): void {
-  try {
-    if (!existsSync(LOCK_FILE)) return;
-    const lockData = readFileSync(LOCK_FILE, 'utf-8');
-    const lockInfo: LockInfo = JSON.parse(lockData);
-    const lockAge = Date.now() - new Date(lockInfo.startedAt).getTime();
-    if (lockAge > LOCK_STALE_MS) {
-      logger.warn('SYSTEM', 'Removing stale lock', {
-        lockAge: Math.round(lockAge / 1000) + 's',
-        originalPid: lockInfo.pid,
-        originalCommand: lockInfo.command
-      });
-      unlinkSync(LOCK_FILE);
-    }
-  } catch {
-    // If we can't read the lock, it's likely corrupted - remove it
-    try { unlinkSync(LOCK_FILE); } catch {}
-  }
-}
-
-/**
- * Acquire exclusive lock for worker operations
- * Uses atomic file creation (O_EXCL) for cross-process safety
- */
-function acquireLock(command: string): boolean {
-  mkdirSync(DATA_DIR, { recursive: true });
-  cleanupStaleLock();
-
-  const lockInfo: LockInfo = {
-    pid: process.pid,
-    command,
-    startedAt: new Date().toISOString()
-  };
-
-  let retries = 3;
-  while (retries > 0) {
-    try {
-      // O_EXCL ensures atomic creation - fails if file exists
-      const fd = fs.openSync(LOCK_FILE, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_WRONLY);
-      fs.writeSync(fd, JSON.stringify(lockInfo, null, 2));
-      fs.closeSync(fd);
-      return true;
-    } catch (error: unknown) {
-      if ((error as NodeJS.ErrnoException).code === 'EEXIST') {
-        return false;
-      }
-      // Retry on ENOENT (can happen on Windows if file/dir state is in flux)
-      if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
-        retries--;
-        if (retries === 0) {
-          logger.warn('SYSTEM', 'Lock acquisition error (ENOENT)', { error: (error as Error).message });
-          return false;
-        }
-        // Ensure directory exists and try again
-        try { mkdirSync(DATA_DIR, { recursive: true }); } catch {}
-        continue;
-      }
-      logger.warn('SYSTEM', 'Lock acquisition error', { error: (error as Error).message });
-      return false;
-    }
-  }
-  return false;
-}
-
-/**
- * Release lock file
- */
-function releaseLock(): void {
-  try {
-    if (existsSync(LOCK_FILE)) unlinkSync(LOCK_FILE);
-  } catch (error) {
-    logger.warn('SYSTEM', 'Lock release error', { error: (error as Error).message });
-  }
-}
-
-/**
- * Wait for lock with timeout
- */
-async function waitForLock(command: string, timeoutMs: number): Promise<boolean> {
-  const start = Date.now();
-  while (Date.now() - start < timeoutMs) {
-    if (acquireLock(command)) return true;
-    await new Promise(r => setTimeout(r, 200));
-  }
-  return false;
-}
+// No lock file needed - health checks and port binding provide coordination
 
 /**
  * Get platform-adjusted timeout (Windows socket cleanup is slower)
@@ -166,9 +74,8 @@ function getPlatformTimeout(baseMs: number): number {
 
 async function isPortInUse(port: number): Promise<boolean> {
   try {
-    const response = await fetch(`http://127.0.0.1:${port}/api/health`, {
-      signal: AbortSignal.timeout(2000)
-    });
+    // Note: Removed AbortSignal.timeout to avoid Windows Bun cleanup issue (libuv assertion)
+    const response = await fetch(`http://127.0.0.1:${port}/api/health`);
     return response.ok;
   } catch { return false; }
 }
@@ -177,9 +84,8 @@ async function waitForHealth(port: number, timeoutMs: number = 30000): Promise<b
   const start = Date.now();
   while (Date.now() - start < timeoutMs) {
     try {
-      const response = await fetch(`http://127.0.0.1:${port}/api/readiness`, {
-        signal: AbortSignal.timeout(2000)
-      });
+      // Note: Removed AbortSignal.timeout to avoid Windows Bun cleanup issue (libuv assertion)
+      const response = await fetch(`http://127.0.0.1:${port}/api/readiness`);
       if (response.ok) return true;
     } catch {
       // Not ready yet
@@ -191,9 +97,9 @@ async function waitForHealth(port: number, timeoutMs: number = 30000): Promise<b
 
 async function httpShutdown(port: number): Promise<boolean> {
   try {
+    // Note: Removed AbortSignal.timeout to avoid Windows Bun cleanup issue (libuv assertion)
     const response = await fetch(`http://127.0.0.1:${port}/api/admin/shutdown`, {
-      method: 'POST',
-      signal: AbortSignal.timeout(5000)
+      method: 'POST'
     });
     if (!response.ok) {
       logger.warn('SYSTEM', 'Shutdown request returned error', { port, status: response.status });
@@ -219,6 +125,46 @@ async function waitForPortFree(port: number, timeoutMs: number = 10000): Promise
   return false;
 }
 
+/**
+ * Get the plugin version from the installed marketplace package.json
+ */
+function getInstalledPluginVersion(): string {
+  const marketplaceRoot = path.join(homedir(), '.claude', 'plugins', 'marketplaces', 'thedotmack');
+  const packageJsonPath = path.join(marketplaceRoot, 'package.json');
+  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+  return packageJson.version;
+}
+
+/**
+ * Get the running worker's version via API
+ */
+async function getRunningWorkerVersion(port: number): Promise<string | null> {
+  try {
+    const response = await fetch(`http://127.0.0.1:${port}/api/version`);
+    if (!response.ok) return null;
+    const data = await response.json() as { version: string };
+    return data.version;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Check if worker version matches plugin version
+ * Returns true if versions match or if we can't determine (assume match)
+ */
+async function checkVersionMatch(port: number): Promise<{ matches: boolean; pluginVersion: string; workerVersion: string | null }> {
+  const pluginVersion = getInstalledPluginVersion();
+  const workerVersion = await getRunningWorkerVersion(port);
+
+  // If we can't get worker version, assume it matches (graceful degradation)
+  if (!workerVersion) {
+    return { matches: true, pluginVersion, workerVersion };
+  }
+
+  return { matches: pluginVersion === workerVersion, pluginVersion, workerVersion };
+}
+
 // Import composed service layer
 import { DatabaseManager } from './worker/DatabaseManager.js';
 import { SessionManager } from './worker/SessionManager.js';
@@ -250,6 +196,7 @@ export class WorkerService {
   // Initialization flags for MCP/SDK readiness tracking
   private mcpReady: boolean = false;
   private initializationCompleteFlag: boolean = false;
+  private isShuttingDown: boolean = false;
 
   // Service layer
   private dbManager: DatabaseManager;
@@ -315,6 +262,36 @@ export class WorkerService {
 
     this.setupMiddleware();
     this.setupRoutes();
+
+    // Register signal handlers early to ensure cleanup even if start() hasn't completed
+    // The shutdown() method is defensive and safe to call at any initialization stage
+    this.registerSignalHandlers();
+  }
+
+  /**
+   * Register signal handlers for graceful shutdown
+   * Called in constructor to ensure cleanup even if start() hasn't completed
+   */
+  private registerSignalHandlers(): void {
+    const handleShutdown = async (signal: string) => {
+      if (this.isShuttingDown) {
+        logger.warn('SYSTEM', `Received ${signal} but shutdown already in progress`);
+        return;
+      }
+      this.isShuttingDown = true;
+
+      logger.info('SYSTEM', `Received ${signal}, shutting down...`);
+      try {
+        await this.shutdown();
+        process.exit(0);
+      } catch (error) {
+        logger.error('SYSTEM', 'Error during shutdown', {}, error as Error);
+        process.exit(1);
+      }
+    };
+
+    process.on('SIGTERM', () => handleShutdown('SIGTERM'));
+    process.on('SIGINT', () => handleShutdown('SIGINT'));
   }
 
   /**
@@ -361,16 +338,10 @@ export class WorkerService {
       }
     });
 
-    // Version endpoint - returns the worker's current version
+    // Version endpoint - returns the worker's built-in version (compiled at build time)
+    // This is critical for detecting version mismatch when plugin is updated but worker is still running old code
     this.app.get('/api/version', (_req, res) => {
-      const { homedir } = require('os');
-      const { readFileSync } = require('fs');
-      const marketplaceRoot = path.join(homedir(), '.claude', 'plugins', 'marketplaces', 'thedotmack');
-      const packageJsonPath = path.join(marketplaceRoot, 'package.json');
-
-      // Read version from marketplace package.json
-      const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-      res.status(200).json({ version: packageJson.version });
+      res.status(200).json({ version: BUILT_IN_VERSION });
     });
 
     // Instructions endpoint - loads SKILL.md sections on-demand for progressive instruction loading
@@ -835,6 +806,9 @@ export class WorkerService {
   async shutdown(): Promise<void> {
     logger.info('SYSTEM', 'Shutdown initiated');
 
+    // Clean up PID file on shutdown
+    removePidFile();
+
     // STEP 1: Enumerate all child processes BEFORE we start closing things
     const childPids = await this.getChildProcesses(process.pid);
     logger.info('SYSTEM', 'Found child processes', { count: childPids.length, pids: childPids });
@@ -842,11 +816,23 @@ export class WorkerService {
     // STEP 2: Close HTTP server first
     if (this.server) {
       this.server.closeAllConnections();
+
+      // Give Windows time to close connections before closing server (prevents zombie ports)
+      if (process.platform === 'win32') {
+        await new Promise(r => setTimeout(r, 500));
+      }
+
       await new Promise<void>((resolve, reject) => {
         this.server!.close(err => err ? reject(err) : resolve());
       });
       this.server = null;
       logger.info('SYSTEM', 'HTTP server closed');
+
+      // Extra delay on Windows to ensure port is fully released
+      if (process.platform === 'win32') {
+        await new Promise(r => setTimeout(r, 500));
+        logger.info('SYSTEM', 'Waited for Windows port cleanup');
+      }
     }
 
     // STEP 3: Shutdown active sessions
@@ -997,159 +983,149 @@ async function main() {
 
   switch (command) {
     case 'start': {
-      // Acquire lock BEFORE checking port to prevent race condition
-      // If we can't get lock, another session is spawning - wait for health instead
-      if (!acquireLock('start')) {
-        logger.info('SYSTEM', 'Another session is spawning worker, waiting for health');
-        const healthy = await waitForHealth(port, getPlatformTimeout(30000));
-        if (healthy) {
-          logger.info('SYSTEM', 'Worker healthy, returning success');
-          process.exit(0);
-        }
-        // Still not healthy after wait - try to acquire lock and spawn
-        const gotLock = await waitForLock('start', 5000);
-        if (!gotLock) {
-          logger.error('SYSTEM', 'Failed to acquire lock after timeout');
-          process.exit(1);
-        }
-      }
+      // Health-check-first approach: simple, fast, reliable
+      // Check if worker is already healthy
+      if (await waitForHealth(port, 1000)) {
+        // Worker is healthy - check for version mismatch (issue #484)
+        const versionCheck = await checkVersionMatch(port);
+        if (!versionCheck.matches) {
+          logger.info('SYSTEM', 'Worker version mismatch detected - auto-restarting', {
+            pluginVersion: versionCheck.pluginVersion,
+            workerVersion: versionCheck.workerVersion
+          });
 
-      try {
-        // Re-check port AFTER acquiring lock
-        if (await isPortInUse(port)) {
-          releaseLock();
-          logger.info('SYSTEM', 'Port already in use, worker already running');
-          process.exit(0);
-        }
+          // Shutdown the old worker
+          await httpShutdown(port);
+          const freed = await waitForPortFree(port, getPlatformTimeout(15000));
 
-        // Spawn self as daemon
-        const child = spawn(process.execPath, [__filename, '--daemon'], {
-          detached: true,
-          stdio: 'ignore',
-          windowsHide: true,
-          env: { ...process.env, CLAUDE_MEM_WORKER_PORT: String(port) }
-        });
+          if (!freed) {
+            logger.error('SYSTEM', 'Port did not free up after shutdown for version mismatch restart', { port });
+            process.exit(1);
+          }
 
-        if (child.pid === undefined) {
-          releaseLock();
-          logger.error('SYSTEM', 'Failed to spawn worker daemon');
-          process.exit(1);
-        }
-
-        child.unref();
-
-        // Write PID file
-        writePidFile({ pid: child.pid, port, startedAt: new Date().toISOString() });
-
-        // Wait for health with platform-adjusted timeout
-        const healthy = await waitForHealth(port, getPlatformTimeout(30000));
-        releaseLock();
-
-        if (!healthy) {
           removePidFile();
-          logger.error('SYSTEM', 'Worker failed to start');
-          process.exit(1);
-        }
-
-        logger.info('SYSTEM', 'Worker started successfully');
-        process.exit(0);
-      } catch (error) {
-        releaseLock();
-        throw error;
-      }
-    }
-
-    case 'stop': {
-      // Acquire lock for stop operation
-      if (!acquireLock('stop')) {
-        // Wait briefly for concurrent operation to complete
-        await new Promise(r => setTimeout(r, 2000));
-      }
-
-      try {
-        await httpShutdown(port);
-        const freed = await waitForPortFree(port, getPlatformTimeout(15000));
-        
-        if (!freed) {
-          logger.warn('SYSTEM', 'Port did not free up after shutdown', { port });
-          // Could force kill here if we knew the PID, but for now just warn
-        }
-        
-        removePidFile();
-        releaseLock();
-        logger.info('SYSTEM', 'Worker stopped successfully');
-        process.exit(0);
-      } catch (error) {
-        releaseLock();
-        throw error;
-      }
-    }
-
-    case 'restart': {
-      // Acquire lock for restart operation
-      if (!acquireLock('restart')) {
-        // Another session is already restarting - wait for health
-        logger.info('SYSTEM', 'Another session is restarting worker, waiting');
-        const healthy = await waitForHealth(port, getPlatformTimeout(45000));
-        if (healthy) {
-          logger.info('SYSTEM', 'Worker healthy after restart');
+          // Fall through to spawn new daemon below
+        } else {
+          logger.info('SYSTEM', 'Worker already running and healthy');
           process.exit(0);
         }
-        logger.error('SYSTEM', 'Worker failed to restart (concurrent operation)');
+      }
+
+      // Worker not healthy - check if port is in use
+      const portInUse = await isPortInUse(port);
+
+      if (portInUse) {
+        // Port in use but not healthy - wait a bit longer in case it's starting up
+        logger.info('SYSTEM', 'Port in use, waiting for worker to become healthy');
+        const healthy = await waitForHealth(port, getPlatformTimeout(15000));
+        if (healthy) {
+          logger.info('SYSTEM', 'Worker is now healthy');
+          process.exit(0);
+        }
+        logger.error('SYSTEM', 'Port in use but worker not responding to health checks');
         process.exit(1);
       }
 
-      try {
-        await httpShutdown(port);
-        const freed = await waitForPortFree(port, getPlatformTimeout(15000));
-        
-        if (!freed) {
-          releaseLock();
-          logger.error('SYSTEM', 'Port did not free up after shutdown, aborting restart', { port });
-          process.exit(1);
-        }
-        
-        removePidFile();
+      // Port not in use - spawn daemon
+      logger.info('SYSTEM', 'Starting worker daemon');
+      const child = spawn(process.execPath, [__filename, '--daemon'], {
+        detached: true,
+        stdio: 'ignore',
+        windowsHide: true,
+        env: { ...process.env, CLAUDE_MEM_WORKER_PORT: String(port) }
+      });
 
-        const child = spawn(process.execPath, [__filename, '--daemon'], {
-          detached: true,
-          stdio: 'ignore',
-          windowsHide: true,
-          env: { ...process.env, CLAUDE_MEM_WORKER_PORT: String(port) }
-        });
-
-        if (child.pid === undefined) {
-          releaseLock();
-          logger.error('SYSTEM', 'Failed to spawn worker daemon during restart');
-          process.exit(1);
-        }
-
-        child.unref();
-        writePidFile({ pid: child.pid, port, startedAt: new Date().toISOString() });
-
-        const healthy = await waitForHealth(port, getPlatformTimeout(30000));
-        releaseLock();
-
-        if (!healthy) {
-          removePidFile();
-          logger.error('SYSTEM', 'Worker failed to restart');
-          process.exit(1);
-        }
-        logger.info('SYSTEM', 'Worker restarted successfully');
-        process.exit(0);
-      } catch (error) {
-        releaseLock();
-        throw error;
+      if (child.pid === undefined) {
+        logger.error('SYSTEM', 'Failed to spawn worker daemon');
+        process.exit(1);
       }
+
+      child.unref();
+
+      // Write PID file
+      writePidFile({ pid: child.pid, port, startedAt: new Date().toISOString() });
+
+      // Wait for health with platform-adjusted timeout
+      const healthy = await waitForHealth(port, getPlatformTimeout(30000));
+
+      if (!healthy) {
+        removePidFile();
+        logger.error('SYSTEM', 'Worker failed to start (health check timeout)');
+        process.exit(1);
+      }
+
+      logger.info('SYSTEM', 'Worker started successfully');
+      process.exit(0);
+    }
+
+    case 'stop': {
+      // Simple stop: send shutdown request, wait for port to free
+      await httpShutdown(port);
+      const freed = await waitForPortFree(port, getPlatformTimeout(15000));
+
+      if (!freed) {
+        logger.warn('SYSTEM', 'Port did not free up after shutdown', { port });
+        // Could force kill here if we knew the PID, but for now just warn
+      }
+
+      removePidFile();
+      logger.info('SYSTEM', 'Worker stopped successfully');
+      process.exit(0);
+    }
+
+    case 'restart': {
+      // Simple restart: stop, then start
+      logger.info('SYSTEM', 'Restarting worker');
+
+      await httpShutdown(port);
+      const freed = await waitForPortFree(port, getPlatformTimeout(15000));
+
+      if (!freed) {
+        logger.error('SYSTEM', 'Port did not free up after shutdown, aborting restart', { port });
+        process.exit(1);
+      }
+
+      removePidFile();
+
+      // Spawn new daemon
+      const child = spawn(process.execPath, [__filename, '--daemon'], {
+        detached: true,
+        stdio: 'ignore',
+        windowsHide: true,
+        env: { ...process.env, CLAUDE_MEM_WORKER_PORT: String(port) }
+      });
+
+      if (child.pid === undefined) {
+        logger.error('SYSTEM', 'Failed to spawn worker daemon during restart');
+        process.exit(1);
+      }
+
+      child.unref();
+      writePidFile({ pid: child.pid, port, startedAt: new Date().toISOString() });
+
+      // Wait for health
+      const healthy = await waitForHealth(port, getPlatformTimeout(30000));
+
+      if (!healthy) {
+        removePidFile();
+        logger.error('SYSTEM', 'Worker failed to restart');
+        process.exit(1);
+      }
+
+      logger.info('SYSTEM', 'Worker restarted successfully');
+      process.exit(0);
     }
 
     case 'status': {
       const running = await isPortInUse(port);
       const pidInfo = readPidFile();
       if (running && pidInfo) {
-        logger.info('SYSTEM', `Worker running (PID: ${pidInfo.pid}, Port: ${pidInfo.port})`);
+        console.log('Worker is running');
+        console.log(`  PID: ${pidInfo.pid}`);
+        console.log(`  Port: ${pidInfo.port}`);
+        console.log(`  Started: ${pidInfo.startedAt}`);
       } else {
-        logger.info('SYSTEM', 'Worker not running');
+        console.log('Worker is not running');
       }
       process.exit(0);
     }
@@ -1159,20 +1135,6 @@ async function main() {
       // Run server directly
       const worker = new WorkerService();
 
-      process.on('SIGTERM', async () => {
-        logger.info('SYSTEM', 'Received SIGTERM');
-        await worker.shutdown();
-        removePidFile();
-        process.exit(0);
-      });
-
-      process.on('SIGINT', async () => {
-        logger.info('SYSTEM', 'Received SIGINT');
-        await worker.shutdown();
-        removePidFile();
-        process.exit(0);
-      });
-
       worker.start().catch((error) => {
         logger.failure('SYSTEM', 'Worker failed to start', {}, error as Error);
         removePidFile();

src/services/worker/FormattingService.ts

@@ -74,7 +74,7 @@ Tips:
     const id = `#S${session.id}`;
     const time = this.formatTime(session.created_at_epoch);
     const icon = '🎯';
-    const title = session.request || `Session ${session.sdk_session_id?.substring(0, 8) || 'unknown'}`;
+    const title = session.request || `Session ${session.memory_session_id?.substring(0, 8) || 'unknown'}`;
 
     return `| ${id} | ${time} | ${icon} | ${title} | - | - |`;
   }
@@ -137,7 +137,7 @@ Tips:
     const id = `#S${session.id}`;
     const time = this.formatTime(session.created_at_epoch);
     const icon = '🎯';
-    const title = session.request || `Session ${session.sdk_session_id?.substring(0, 8) || 'unknown'}`;
+    const title = session.request || `Session ${session.memory_session_id?.substring(0, 8) || 'unknown'}`;
 
     // Use ditto mark if same time as previous row
     const timeDisplay = time === lastTime ? '″' : time;

src/services/worker/SDKAgent.ts

@@ -64,22 +64,29 @@ export class SDKAgent {
       // Create message generator (event-driven)
       const messageGenerator = this.createMessageGenerator(session);
 
+      // CRITICAL: Only resume if memorySessionId is a REAL captured SDK session ID,
+      // not the placeholder (which equals contentSessionId). The placeholder is set
+      // for FK purposes but would cause the bug where we try to resume the USER's session!
+      const hasRealMemorySessionId = session.memorySessionId &&
+        session.memorySessionId !== session.contentSessionId;
+
       logger.info('SDK', 'Starting SDK query', {
         sessionDbId: session.sessionDbId,
         contentSessionId: session.contentSessionId,
         memorySessionId: session.memorySessionId,
-        resume_parameter: session.memorySessionId || '(none - fresh start)',
+        hasRealMemorySessionId,
+        resume_parameter: hasRealMemorySessionId ? session.memorySessionId : '(none - fresh start)',
         lastPromptNumber: session.lastPromptNumber
       });
 
       // Run Agent SDK query loop
-      // Use memorySessionId for resume (captured from previous SDK response) if available
+      // Only resume if we have a REAL captured memory session ID (not the placeholder)
       const queryResult = query({
         prompt: messageGenerator,
         options: {
           model: modelId,
-          // Only resume if we have a captured memory session ID from previous SDK interaction
-          ...(session.memorySessionId && { resume: session.memorySessionId }),
+          // Only resume if memorySessionId differs from contentSessionId (meaning it was captured)
+          ...(hasRealMemorySessionId && { resume: session.memorySessionId }),
           disallowedTools,
           abortController: session.abortController,
           pathToClaudeCodeExecutable: claudePath

src/services/worker/SearchManager.ts

@@ -1376,13 +1376,13 @@ export class SearchManager {
         lines.push('');
 
         for (const session of sessions) {
-          if (!session.sdk_session_id) continue;
+          if (!session.memory_session_id) continue;
 
           lines.push('---');
           lines.push('');
 
           if (session.has_summary) {
-            const summary = this.sessionStore.getSummaryForSession(session.sdk_session_id);
+            const summary = this.sessionStore.getSummaryForSession(session.memory_session_id);
             if (summary) {
               const promptLabel = summary.prompt_number ? ` (Prompt #${summary.prompt_number})` : '';
               lines.push(`**Summary${promptLabel}**`);
@@ -1432,7 +1432,7 @@ export class SearchManager {
               lines.push(`**Request:** ${session.user_prompt}`);
             }
 
-            const observations = this.sessionStore.getObservationsForSession(session.sdk_session_id);
+            const observations = this.sessionStore.getObservationsForSession(session.memory_session_id);
             if (observations.length > 0) {
               lines.push('');
               lines.push(`**Observations (${observations.length}):**`);

src/shared/worker-utils.ts

@@ -62,9 +62,8 @@ export function clearPortCache(): void {
  */
 async function isWorkerHealthy(): Promise<boolean> {
   const port = getWorkerPort();
-  const response = await fetch(`http://127.0.0.1:${port}/api/readiness`, {
-    signal: AbortSignal.timeout(HEALTH_CHECK_TIMEOUT_MS)
-  });
+  // Note: Removed AbortSignal.timeout to avoid Windows Bun cleanup issue (libuv assertion)
+  const response = await fetch(`http://127.0.0.1:${port}/api/readiness`);
   return response.ok;
 }
 
@@ -82,9 +81,8 @@ function getPluginVersion(): string {
  */
 async function getWorkerVersion(): Promise<string> {
   const port = getWorkerPort();
-  const response = await fetch(`http://127.0.0.1:${port}/api/version`, {
-    signal: AbortSignal.timeout(HEALTH_CHECK_TIMEOUT_MS)
-  });
+  // Note: Removed AbortSignal.timeout to avoid Windows Bun cleanup issue (libuv assertion)
+  const response = await fetch(`http://127.0.0.1:${port}/api/version`);
   if (!response.ok) {
     throw new Error(`Failed to get worker version: ${response.status}`);
   }
@@ -94,17 +92,19 @@ async function getWorkerVersion(): Promise<string> {
 
 /**
  * Check if worker version matches plugin version
- * Logs a warning if mismatch is detected
+ * Note: Auto-restart on version mismatch is now handled in worker-service.ts start command (issue #484)
+ * This function logs for informational purposes only
  */
 async function checkWorkerVersion(): Promise<void> {
   const pluginVersion = getPluginVersion();
   const workerVersion = await getWorkerVersion();
 
   if (pluginVersion !== workerVersion) {
-    logger.warn('SYSTEM', 'Worker version mismatch', {
+    // Just log debug info - auto-restart handles the mismatch in worker-service.ts
+    logger.debug('SYSTEM', 'Version check', {
       pluginVersion,
       workerVersion,
-      hint: 'Restart worker with: claude-mem worker restart'
+      note: 'Mismatch will be auto-restarted by worker-service start command'
     });
   }
 }
@@ -112,10 +112,10 @@ async function checkWorkerVersion(): Promise<void> {
 
 /**
  * Ensure worker service is running
- * Polls until worker is ready (assumes worker-cli.js start was called by hooks.json)
+ * Polls until worker is ready (assumes worker-service.cjs start was called by hooks.json)
  */
 export async function ensureWorkerRunning(): Promise<void> {
-  const maxRetries = 25;  // 5 seconds total
+  const maxRetries = 75;  // 15 seconds total
   const pollInterval = 200;
 
   for (let i = 0; i < maxRetries; i++) {
@@ -132,6 +132,6 @@ export async function ensureWorkerRunning(): Promise<void> {
 
   throw new Error(getWorkerRestartInstructions({
     port: getWorkerPort(),
-    customPrefix: 'Worker did not become ready within 5 seconds.'
+    customPrefix: 'Worker did not become ready within 15 seconds.'
   }));
 }