Release v4.3.1: Version bump and documentation updates

- Updated package.json version to 4.3.1
- Updated marketplace.json version to 4.3.1
- Added v4.3.1 entry to CLAUDE.md version history
- Documented SessionStart hook context injection fix
- Documented hooks architecture consolidation
- Rebuilt all executables with updated version

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

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

.claude-plugin/marketplace.json

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

.claude/settings.json

@@ -0,0 +1,3 @@
+{
+  "env": {}
+}

.claude/skills/version-bump/SKILL.md

@@ -0,0 +1,222 @@
+---
+name: version-bump
+description: Manage semantic version updates for claude-mem project. Handles patch, minor, and major version increments following semantic versioning. Updates package.json, marketplace.json, and CLAUDE.md consistently.
+---
+
+# Version Bump Skill
+
+IMPORTANT: This skill manages semantic versioning across the claude-mem project. YOU MUST update all three version-tracked files consistently.
+
+## Quick Reference
+
+**Files requiring updates:**
+1. `package.json` (line 3)
+2. `.claude-plugin/marketplace.json` (line 13)
+3. `CLAUDE.md` (version history section)
+
+**Semantic versioning:**
+- PATCH (x.y.Z): Bugfixes only
+- MINOR (x.Y.0): New features, backward compatible
+- MAJOR (X.0.0): Breaking changes
+
+## Workflow
+
+When invoked, follow this process:
+
+### 1. Analyze Changes
+First, understand what changed:
+```bash
+git log --oneline -5
+git diff HEAD~1
+```
+
+### 2. Determine Version Type
+Ask yourself:
+- Breaking changes? → MAJOR
+- New features? → MINOR
+- Bugfixes only? → PATCH
+
+If unclear, ASK THE USER explicitly.
+
+### 3. Calculate New Version
+From current version in `package.json`:
+```bash
+grep '"version"' package.json
+```
+
+Apply semantic versioning rules:
+- Patch: increment Z (4.2.8 → 4.2.9)
+- Minor: increment Y, reset Z (4.2.8 → 4.3.0)
+- Major: increment X, reset Y and Z (4.2.8 → 5.0.0)
+
+### 4. Preview Changes
+BEFORE making changes, show the user:
+```
+Current version: 4.2.8
+New version: 4.2.9 (PATCH)
+Reason: Fixed database query bug
+
+Files to update:
+- package.json: "version": "4.2.9"
+- marketplace.json: "version": "4.2.9"
+- CLAUDE.md: Add v4.2.9 entry
+
+Proceed? (yes/no)
+```
+
+### 5. Update Files
+
+**Update package.json:**
+```json
+{
+  "name": "claude-mem",
+  "version": "4.2.9",
+  ...
+}
+```
+
+**Update .claude-plugin/marketplace.json:**
+```json
+{
+  "name": "claude-mem",
+  "version": "4.2.9",
+  ...
+}
+```
+
+**Update CLAUDE.md:**
+Add entry at top of Version History section following the template below.
+
+### 6. Verify Consistency
+```bash
+# Check all versions match
+grep -n '"version"' package.json .claude-plugin/marketplace.json
+# Should show same version in both files
+```
+
+### 7. Test
+```bash
+# Verify the plugin loads correctly
+npm run build
+# Or whatever build command is appropriate
+```
+
+## CLAUDE.md Templates
+
+### PATCH Version Template
+```markdown
+### v4.2.9
+**Breaking Changes**: None (patch version)
+
+**Fixes**:
+- [Specific bug fixed with file reference: src/db/query.ts:45]
+- [Impact: what this fixes for users]
+
+**Technical Details**:
+- Modified: [file paths with line numbers]
+- Root cause: [brief explanation]
+```
+
+### MINOR Version Template
+```markdown
+### v4.3.0
+**Breaking Changes**: None (minor version)
+
+**Features**:
+- [Feature name and user benefit]
+- [How to use: command or API example]
+
+**Improvements**:
+- [Enhancement description]
+
+**Technical Details**:
+- New files: [paths]
+- Modified: [paths with line numbers]
+- Dependencies: [any new dependencies added]
+```
+
+### MAJOR Version Template
+```markdown
+### v5.0.0
+**Breaking Changes**:
+⚠️ [Change 1: what breaks and why]
+⚠️ [Change 2: what breaks and why]
+
+**Migration Guide**:
+1. [Step-by-step instructions]
+2. [Code examples showing old vs new]
+3. [Data migration commands if needed]
+
+**Features**:
+- [New capabilities enabled by breaking changes]
+
+**Technical Details**:
+- Architectural changes: [high-level overview]
+- Modified: [key files with line numbers]
+- Removed: [deprecated APIs or features]
+```
+
+## Common Scenarios
+
+**Scenario 1: Bug fix after testing**
+```
+User: "Fixed the memory leak in the search function"
+You: Determine → PATCH
+     Calculate → 4.2.8 → 4.2.9
+     Update all three files
+     CLAUDE.md: Focus on the fix and impact
+```
+
+**Scenario 2: New MCP tool added**
+```
+User: "Added web search MCP integration"
+You: Determine → MINOR (new feature)
+     Calculate → 4.2.8 → 4.3.0
+     Update all three files
+     CLAUDE.md: Describe feature and usage
+```
+
+**Scenario 3: Database schema redesign**
+```
+User: "Rewrote storage layer, old data needs migration"
+You: Determine → MAJOR (breaking change)
+     Calculate → 4.2.8 → 5.0.0
+     Update all three files
+     CLAUDE.md: Include migration steps
+```
+
+## Error Prevention
+
+**ALWAYS verify:**
+- [ ] All three files have matching version numbers
+- [ ] CLAUDE.md entry matches version type (patch/minor/major)
+- [ ] Breaking changes are clearly marked with ⚠️
+- [ ] File references use format: `path/to/file.ts:line_number`
+- [ ] CLAUDE.md entry is added at TOP of version history
+
+**NEVER:**
+- Update only one or two files
+- Skip the verification step
+- Forget to ask user if version type is unclear
+- Use vague descriptions in CLAUDE.md
+
+## Best Practices
+
+1. **Be explicit about breaking changes** - Users need clear migration paths[(2)](https://docs.claude.com/en/docs/claude-code/plugins-reference#plugin-manifest-schema)
+2. **Include file references** - Makes debugging easier later[(1)](https://www.anthropic.com/engineering/claude-code-best-practices)
+3. **Test after bumping** - Ensure version displays correctly[(3)](https://www.anthropic.com/engineering/claude-code-best-practices)
+4. **Keep CLAUDE.md concise** - Focus on user impact, not implementation minutiae[(1)](https://www.anthropic.com/engineering/claude-code-best-practices)
+5. **Use consistent formatting** - Follow existing CLAUDE.md style[(1)](https://www.anthropic.com/engineering/claude-code-best-practices)
+
+## Reference Commands
+
+```bash
+# View current version
+cat package.json | grep version
+
+# Check version history
+head -50 CLAUDE.md | grep "^###"
+
+# Verify consistency
+diff <(jq -r .version package.json) <(jq -r .version .claude-plugin/marketplace.json)
+```

.gitignore

@@ -5,6 +5,7 @@ node_modules/
 .env.local
 *.tmp
 *.temp
-.claude/
+.claude/settings.local.json
 plugin/data/
-plugin/data.backup/
+plugin/data.backup/
+package-lock.json

CHANGELOG.md

@@ -5,6 +5,119 @@ 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/).
 
 
+## [Unreleased]
+
+
+## [4.3.0] - 2025-10-25
+
+### Added
+- **Progressive Disclosure Context**: Enhanced context hook with layered memory retrieval system
+  - Layer 1 (Index): Observation titles, token costs, and type indicators at session start
+  - Layer 2 (Details): Full narratives retrieved on-demand via MCP search
+  - Layer 3 (Perfect Recall): Source code and original transcripts
+  - Context hook now displays observations in table format with ID, timestamp, type indicator, title, and token count
+  - Type indicators: 🔴 (critical/gotcha), 🟤 (decision), 🔵 (informational/how-it-works)
+  - Progressive disclosure instructions guide Claude on when to fetch full observation details vs. reading code
+  - Token counts (~200-500 per observation) help Claude make informed retrieval decisions
+- **Agent Skills documentation**: Added comprehensive documentation on creating and using Claude Code agent skills
+- **Version bump skill**: Added automated version bump management skill for streamlined releases
+- **Memory toggle feature planning**: Added design document for future pause/resume recording capability
+
+### Changed
+- **Enhanced session summary handling**: Improved timeline rendering and summary organization
+- **Improved context hook output**: Added structured timeline with session grouping and observation details
+- **Context token cost**: Increased from ~800 tokens to ~2,500 tokens for richer observation index
+
+### Fixed
+- **Cross-platform path detection**: Removed hardcoded macOS-specific paths for project and Claude Code executable (fixes #23)
+  - Removed hardcoded paths in context hook, worker service, and SDK integration
+  - Now uses dynamic path resolution for cross-platform compatibility
+  - Affects: `src/hooks/context.ts`, `src/services/worker-service.ts`, `src/sdk/worker.ts`
+
+
+## [4.2.11] - 2025-10-25
+
+### Fixed
+- **Cross-platform Claude path detection**: Fixed SDK auto-detection failure by implementing explicit `which`/`where` command execution
+  - SDK's automatic Claude path detection was returning undefined
+  - Unix/macOS: Uses `which claude` command to find executable
+  - Windows: Uses `where claude` command (works in both CMD and PowerShell)
+  - Fallback to `CLAUDE_CODE_PATH` environment variable if set
+  - Handles Windows multiple results by taking first match
+  - Worker now logs discovered path for debugging: "Found Claude executable: /path/to/claude"
+
+### Technical Details
+- Added `findClaudePath()` helper function using `child_process.execSync`
+- Platform detection via `process.platform === 'win32'` to choose appropriate command
+- Updated `src/sdk/worker.ts` and `src/services/worker-service.ts` with explicit path detection
+- Both files now pass `pathToClaudeCodeExecutable: claudePath` to SDK query
+
+
+## [4.2.10] - 2025-10-25
+
+### Fixed
+- **Windows compatibility**: Removed hardcoded macOS-specific Claude executable path that prevented worker service from running on Windows
+  - Removed hardcoded path: `/Users/alexnewman/.nvm/versions/node/v24.5.0/bin/claude`
+  - Removed `pathToClaudeCodeExecutable` parameter from SDK query() calls
+  - SDK now automatically detects Claude Code executable path on all platforms
+  - Affects: `src/sdk/worker.ts`, `src/services/worker-service.ts`, `plugin/scripts/worker-service.cjs`
+
+
+## [4.2.3] - 2025-10-23
+
+### Security
+- **FTS5 injection vulnerability fix**: Added proper escaping to prevent SQL injection attacks in search functions
+  - Implemented double-quote escaping for FTS5 full-text search queries
+  - Added comprehensive test suite with 332 new tests covering injection scenarios
+  - Affects: `search_observations`, `search_sessions`, `search_user_prompts` MCP tools
+
+### Fixed
+- **ESM/CJS compatibility**: Fixed getDirname function to work in both ESM (hooks) and CJS (worker) contexts
+  - Detects context using `typeof __dirname !== 'undefined'`
+  - Falls back to `fileURLToPath(import.meta.url)` for ESM modules
+  - Resolves path resolution issues across different module systems
+- **Windows PowerShell compatibility**: Fixed SessionStart hook error on Windows systems
+  - Replaced bash-specific test command `[` with standard cross-platform npm install
+  - Simplified hook command to use idempotent npm install (fast when dependencies exist)
+  - Dependencies install from root package.json in marketplace folder
+
+### Changed
+- **SessionStart hook command**: Now uses `cd ... && npm install --prefer-offline --no-audit --no-fund --loglevel=error && node context-hook.js`
+  - Removed bash-specific conditional check
+  - npm install is fast (~500ms) and idempotent when dependencies already exist
+  - Works cross-platform on Windows, macOS, and Linux
+
+
+## [4.2.1] - 2025-10-22
+
+### Added
+- **Summary skip logic**: Summaries now skip when work is already covered, banter/trivial requests, or no meaningful observations
+  - New "WHEN NOT TO SUMMARIZE" section in buildSummaryPrompt guides SDK to avoid duplicate/trivial summaries
+  - Parser detects `<skip_summary reason="..."/>` format and logs reason
+  - Prevents duplicate summaries like the three "restore 6 types" summaries observed in session d9137878
+
+### Fixed
+- **Observation type validation**: Parser now validates all 6 observation types (bugfix, feature, refactor, change, discovery, decision) instead of only 3
+
+### Changed
+- **Chronological summary guidance**: Summaries now explicitly instructed to capture "what happened in THIS prompt" rather than re-summarizing previous work
+
+
+## [4.1.1] - 2025-10-21
+
+### Removed
+- **advanced_search tool**: Removed redundant MCP tool that provided no functionality beyond calling search_observations + search_sessions
+
+### Fixed
+- **MCP search limit bug**: Fixed findByConcept, findByType, and findByFile methods to properly respect limit/offset parameters
+- **Type contamination in concepts**: Added parser validation to prevent observation types from being added to concepts array
+- **Token limit warnings**: Added guidance in tool descriptions to start with 3-5 results to avoid MCP token limits
+
+### Changed
+- **Simplified MCP API**: Reduced from 7 to 6 search tools by removing the redundant advanced_search
+- **Improved search prompts**: Enhanced type and concept constraint language in SDK prompts to prevent AI contamination
+
+
 ## [4.1.0] - 2025-10-21
 
 ### Changed

CLAUDE.md

@@ -0,0 +1,303 @@
+# Claude-Mem: Persistent Memory for Claude Code
+
+## Overview
+
+Claude-mem is a persistent memory compression system that preserves context across Claude Code sessions. It automatically captures tool usage observations, processes them through the Claude Agent SDK, and makes summaries available to future sessions.
+
+**Current Version**: 4.3.1
+**License**: AGPL-3.0
+**Author**: Alex Newman (@thedotmack)
+
+## What It Does
+
+Claude-mem operates as a Claude Code plugin that:
+- Captures every tool execution during your coding sessions
+- Processes observations using AI-powered compression
+- Generates session summaries when sessions end
+- Injects relevant context into future sessions
+- Provides full-text search across your entire project history
+
+This creates a continuous memory system where Claude can learn from past sessions and maintain context across your entire project lifecycle.
+
+## Architecture
+
+### Hook-Based Lifecycle System
+
+Claude-mem integrates with Claude Code through 5 lifecycle hooks:
+
+1. **SessionStart Hook** (`context-hook`)
+   - Ensures dependencies are installed (runs fast idempotent npm install)
+   - Injects context from previous sessions
+   - Auto-starts PM2 worker service
+   - Retrieves last 10 session summaries with three-tier verbosity (v4.2.0)
+   - Fixed in v4.1.0 to use proper JSON hookSpecificOutput format
+
+2. **UserPromptSubmit Hook** (`new-hook`)
+   - Creates new session records
+   - Initializes session tracking
+   - Saves raw user prompts for full-text search (as of v4.2.0)
+
+3. **PostToolUse Hook** (`save-hook`)
+   - Captures tool execution observations
+   - Sends observations to worker service for processing
+
+4. **Summary Hook**
+   - Generates AI-powered session summaries
+   - Processes accumulated observations
+
+5. **SessionEnd Hook** (`cleanup-hook`)
+   - Marks sessions as completed (graceful cleanup as of v4.1.0)
+   - Skips cleanup on `/clear` commands to preserve ongoing sessions
+   - Previously sent DELETE requests; now allows workers to finish naturally
+
+### Worker Service Architecture
+
+- **Technology**: HTTP REST API built with Express.js, managed by PM2
+- **Port**: Fixed port 37777 (configurable via CLAUDE_MEM_WORKER_PORT)
+- **Location**: `src/services/worker-service.ts`
+- **Configurable Model**: Uses `CLAUDE_MEM_MODEL` environment variable (default: claude-sonnet-4-5)
+
+**REST API Endpoints** (6 total):
+- Session management endpoints
+- Observation processing endpoints
+- Worker port tracking
+
+The worker service runs as a PM2-managed background process that handles AI processing separately from the hook execution, preventing hook timeout issues.
+
+### Database Layer
+
+**Technology**: SQLite 3 with better-sqlite3 native module
+**Location**: `~/.claude-mem/claude-mem.db`
+
+**Note**: SessionStore and SessionSearch use better-sqlite3 as the primary database implementation. Database.ts (which uses bun:sqlite) is legacy code.
+
+**Core Tables**:
+- `sdk_sessions` - Session tracking with prompt counters
+- `session_summaries` - AI-generated session summaries (multiple per session)
+- `observations` - Captured tool usage with structured fields
+- `user_prompts` - Raw user prompts with FTS5 search (as of v4.2.0)
+
+**Schema Features**:
+- FTS5 (Full-Text Search) virtual tables for fast searching
+- Automatic sync triggers between main tables and FTS5 tables
+- Support for multi-prompt sessions (prompt_counter, prompt_number)
+- Hierarchical observations (title, subtitle, facts, narrative, concepts, files_read, files_modified)
+- Observation types: decision, bugfix, feature, refactor, discovery, change
+
+**Database Classes**:
+- `SessionStore` - CRUD operations for sessions, observations, summaries, user prompts
+- `SessionSearch` - FTS5 full-text search with 8 search methods
+
+### MCP Search Server
+
+**Location**: `src/servers/search-server.ts`
+**Configuration**: `plugin/.mcp.json`
+
+Exposes 8 specialized search tools to Claude:
+
+1. **search_observations** - Full-text search across observations
+2. **search_sessions** - Full-text search across session summaries
+3. **search_user_prompts** - Full-text search across raw user prompts (as of v4.2.0)
+4. **find_by_concept** - Find observations tagged with specific concepts
+5. **find_by_file** - Find observations referencing specific file paths
+6. **find_by_type** - Find observations by type (decision/bugfix/feature/etc.)
+7. **get_recent_context** - Get recent session context including summaries and observations for a project
+8. **advanced_search** - Combine multiple filters with full-text search
+
+**Search Pipeline**:
+```
+Claude Request → MCP Server → SessionSearch Service → FTS5 Database → Results → Claude
+```
+
+**Citations**: All search results use the `claude-mem://` URI scheme for referencing specific observations and sessions.
+
+## Installation
+
+### Requirements
+- Node.js 18+
+- Claude Code plugin system
+
+### Installation Method
+
+**Local Marketplace Installation** (recommended as of v4.0.4+):
+
+```bash
+# 1. Clone the repository
+git clone https://github.com/thedotmack/claude-mem.git
+cd claude-mem
+
+# 2. Add to Claude Code marketplace
+/plugin marketplace add .claude-plugin/marketplace.json
+
+# 3. Install the plugin
+/plugin install claude-mem
+```
+
+## Configuration
+
+### Model Selection
+
+Configure which AI model processes your observations:
+
+**Using the interactive script**:
+```bash
+./claude-mem-settings.sh
+```
+
+**Available models**:
+- `claude-haiku-4-5` - Fast, cost-efficient
+- `claude-sonnet-4-5` - Balanced (default)
+- `claude-opus-4` - Most capable
+- `claude-3-7-sonnet` - Alternative version
+
+The script manages `CLAUDE_MEM_MODEL` in `~/.claude/settings.json`.
+TODO: also have script create and manage `CLAUDE_MEM_MODEL` in `~/.claude/plugins/marketplaces/thedotmack/.env` so our worker script has access to the value (we may not even need it in our settings but only in our plugin folder since hooks shouldn't be calling queries, not sure).
+
+## Data Flow
+
+### Memory Pipeline
+```
+Tool Execution → Hook Capture → Worker Processing → AI Compression → Database Storage → Future Context Injection
+```
+
+### Search Pipeline
+```
+Search Query → MCP Server → SessionSearch → FTS5 Query → Results with Citations
+```
+
+## Development
+
+### Directory Structure
+```
+claude-mem/
+├── src/
+│   ├── bin/hooks/          # Hook entry points
+│   ├── hooks/              # Hook implementations
+│   ├── services/           # Worker service
+│   ├── services/sqlite/    # Database layer
+│   ├── servers/            # MCP search server
+│   ├── sdk/                # Claude Agent SDK integration
+│   ├── shared/             # Shared utilities
+│   └── utils/              # General utilities
+├── plugin/                 # Built plugin files
+│   ├── scripts/            # Built hook executables
+│   └── .mcp.json          # MCP server configuration
+└── .claude-plugin/        # Plugin metadata
+    └── marketplace.json   # Marketplace definition
+```
+
+### Technology Stack
+- **Language**: TypeScript
+- **Database**: SQLite 3 with better-sqlite3
+- **HTTP**: Express.js
+- **Process Management**: PM2
+- **AI SDK**: @anthropic-ai/claude-agent-sdk (v0.1.23)
+- **MCP SDK**: @modelcontextprotocol/sdk (v1.20.1)
+- **Schema Validation**: zod-to-json-schema (v3.24.6)
+
+### Build Process
+```bash
+npm run build && git commit -a -m "Build and update" && git push && cd ~/.claude/plugins/marketplaces/thedotmack/ && git pull && pm2 flush claude-mem-worker && pm2 restart claude-mem-worker && pm2 logs claude-mem-worker --nostream
+```
+
+1) Compiles TypeScript and outputs hook executables to `plugin/scripts/`
+2) Does all the things needed to update and test since plugin-based installs are out of the .claude/ folder
+
+**Build Outputs**:
+- Hook executables: `*-hook.js` (ESM format)
+- Worker service: `worker-service.cjs` (CJS format)
+- Search server: `search-server.js` (ESM format)
+
+## Version History
+
+For detailed version history and changelog, see [CHANGELOG.md](CHANGELOG.md).
+
+**Current Version**: 4.3.1
+
+### Recent Highlights
+
+#### v4.3.1 (2025-10-26)
+**Breaking Changes**: None (patch version)
+
+**Fixes**:
+- Fixed SessionStart hook context injection by silencing npm install output (plugin/hooks/hooks.json:25)
+- Changed npm loglevel from `--loglevel=error` to `--loglevel=silent` to ensure clean JSON output
+- Consolidated hooks architecture by removing bin/hooks wrapper layer (src/hooks/*-hook.ts)
+- Fixed double shebang issues in hook executables (esbuild now adds shebang during build)
+
+**Technical Details**:
+- Modified: plugin/hooks/hooks.json (npm install verbosity)
+- Removed: src/bin/hooks/* (wrapper layer no longer needed)
+- Consolidated: Hook logic moved directly into src/hooks/*-hook.ts files
+- Root cause: npm install stderr/stdout was polluting hook JSON output, preventing context injection
+
+#### v4.3.0 (2025-10-25)
+- Progressive Disclosure Context: Enhanced context hook with observation timeline and token cost visibility
+- Session observations now display in table format showing ID, timestamp, type indicators, title, and token counts
+- Added progressive disclosure usage instructions to guide Claude on when to fetch full observation details vs. reading code
+- Added Agent Skills documentation and version bump management skill
+- Cross-platform path improvements: Removed hardcoded paths for project and Claude Code executable (fixes #23)
+
+#### v4.2.11 (2025-10-25)
+- Fixed cross-platform Claude executable path detection using `which`/`where` commands
+- Full Windows, macOS, and Linux compatibility
+
+#### v4.2.8 (2025-10-25)
+- Fixed NOT NULL constraint violation for claude_session_id
+
+#### v4.2.3 (2025-10-23)
+- Fixed FTS5 injection vulnerability
+- Fixed Windows PowerShell compatibility
+
+#### v4.0.0 (2025-10-18)
+- MCP Search Server with FTS5 full-text search
+- Plugin data directory integration
+- HTTP REST API architecture with PM2
+
+## Key Design Decisions
+
+### Graceful Cleanup (v4.1.0)
+Changed from aggressive session deletion (HTTP DELETE to workers) to graceful completion (marking sessions complete and allowing workers to finish). This prevents interruption of important operations like summary generation.
+
+### FTS5 for Search Performance
+Implements SQLite FTS5 (Full-Text Search) virtual tables with automatic synchronization triggers, enabling fast full-text search across thousands of observations without performance degradation.
+
+### Multi-Prompt Session Support
+Tracks `prompt_counter` and `prompt_number` across sessions and observations, enabling context preservation across conversation restarts within the same coding session.
+
+## Troubleshooting
+
+### Worker Service Issues
+- Check PM2 status: `pm2 list`
+- View logs: `npm run worker:logs`
+- Restart worker: `npm run worker:restart`
+
+### Database Issues
+- Database location: `~/.claude-mem/claude-mem.db`
+- Check schema: `sqlite3 <db-path> ".schema"`
+- FTS5 tables are automatically synchronized via triggers
+
+### Hook Issues
+- Hooks output to Claude Code's hook execution log
+- Check `plugin/scripts/` for built executables
+
+### Model Configuration Issues
+- Use `./claude-mem-settings.sh` to manage model settings
+- Settings stored in `~/.claude/settings.json`
+- Default fallback: `claude-sonnet-4-5`
+
+## Citations & References
+
+This project uses the `claude-mem://` URI scheme for citations:
+- `claude-mem://observation/{id}` - References specific observations
+- `claude-mem://session/{id}` - References specific sessions
+
+All MCP search results include citations, enabling Claude to reference specific historical context.
+
+## License
+
+AGPL-3.0
+
+## Repository
+
+https://github.com/thedotmack/claude-mem

EXPERIMENTAL_RELEASE_NOTES.md

@@ -0,0 +1,331 @@
+# Experimental Release: Progressive Disclosure Context System
+
+## 🧪 Branch: `feature/context-with-observations`
+
+**Status:** Seeking user feedback before merging to main
+
+**We'd love your testing and feedback!** This experimental branch reimagines how Claude-Mem presents context at session startup, using a progressive disclosure approach that could significantly improve Claude's ability to leverage past learnings.
+
+---
+
+## What is Progressive Disclosure?
+
+Progressive disclosure is a **layered memory retrieval system** inspired by how humans remember information:
+
+### Layer 1: Index (The "Table of Contents")
+**Frontloaded at session start** - Claude sees:
+- **What exists**: Titles of all recent observations and session summaries
+- **Retrieval cost**: Token counts for each observation
+- **Priority signals**: Type indicators (🔴 critical gotcha, 🟤 architectural decision, 🔵 explanatory)
+
+### Layer 2: Details (On-Demand Retrieval)
+**Retrieved via MCP search** - Claude fetches:
+- Full observation narratives when deeper context is needed
+- Search by concept, file path, type, or keywords
+- Only loads what's relevant to the current task
+
+### Layer 3: Perfect Recall (Source of Truth)
+**Direct code access** - When needed:
+- Read actual source files for implementation details
+- Access original transcripts for exact quotes
+- Full context without compression artifacts
+
+---
+
+## The Problem This Solves
+
+### Current Version (v4.2.x) Limitation
+
+The current context hook shows **only session summaries** at startup:
+
+```markdown
+**Session #312**: Put date/time at end of session titles
+Completed: Added date/time to session list with proper formatting
+Next Steps: Test edge cases with long dates
+```
+
+**Strengths:**
+- ✅ Minimal token overhead (~800 tokens)
+- ✅ Clean, readable summaries
+
+**Weaknesses:**
+- ❌ Claude doesn't know **what** detailed observations exist
+- ❌ Can't make informed decisions about whether to search vs read code
+- ❌ Often re-reads code to understand decisions that were already documented
+
+### Experimental Version Enhancement
+
+The experimental hook shows an **observation index** alongside session summaries:
+
+```markdown
+**src/hooks/context.ts**
+| ID | Time | T | Title | Tokens |
+|----|------|---|-------|--------|
+| #2332 | 1:07 AM | 🔴 | Critical Bugfix: Session ID NULL Constraint | ~201 |
+| #2340 | 1:10 AM | 🟠 | Remove Redundant Summary Section | ~280 |
+| #2344 | 1:34 AM | 🔵 | Added progressive disclosure usage instructions | ~149 |
+```
+
+**Benefits:**
+- ✅ Claude knows **what** learnings exist (titles/types)
+- ✅ Token counts inform **cost-benefit** decisions (fetch ~200 tokens vs re-read 2000-line file)
+- ✅ Progressive disclosure instructions **teach Claude** how to use the system
+- ✅ Type indicators help prioritize (critical gotchas > explanatory notes)
+
+**Trade-offs:**
+- ⚠️ Higher initial token cost (~2,500 tokens vs ~800)
+- ⚠️ More visual noise in the context output
+- ❓ Unknown: Does this actually improve Claude's behavior enough to justify the cost?
+
+---
+
+## What's New in This Branch
+
+### 1. Observation Index Display
+
+Full table view of recent observations grouped by file:
+
+```markdown
+### Oct 25, 2025
+
+**src/hooks/context.ts**
+| ID | Time | T | Title | Tokens |
+|----|------|---|-------|--------|
+| #2296 | 12:12 AM | 🟢 | Session summaries now display date and time | ~141 |
+| #2298 | 12:44 AM | 🔵 | Timeline rendering refactored | ~231 |
+
+**General**
+| ID | Time | T | Title | Tokens |
+|----|------|---|-------|--------|
+| #2301 | 12:50 AM | 🟢 | Development Task Breakdown Created | ~128 |
+```
+
+### 2. Token Cost Metadata
+
+Every observation shows estimated token count:
+- Helps Claude decide: "Is it worth fetching this 500-token explanation, or should I just read the code?"
+- Makes cost-benefit analysis explicit
+
+### 3. Progressive Disclosure Instructions
+
+New guidance section teaches Claude how to use the system:
+
+```markdown
+💡 Progressive Disclosure: This index shows WHAT exists (titles) and retrieval COST (token counts).
+- Use MCP search tools to fetch full observation details on-demand (Layer 2)
+- Prefer searching observations over re-reading code for past decisions and learnings
+- Critical types (🔴 gotcha, 🟤 decision, ⚖️ trade-off) often worth fetching immediately
+```
+
+### 4. Type-Based Priority System
+
+Observations categorized by importance:
+- 🔴 **gotcha** - Critical bugs/blockers (fetch immediately)
+- 🟤 **decision** - Architectural choices (high value)
+- ⚖️ **trade-off** - Design considerations (prevents re-debating)
+- 🟠 **why-it-exists** - Rationale documentation
+- 🟡 **problem-solution** - How issues were solved
+- 🟣 **discovery** - Important learnings
+- 🔵 **how-it-works** - Explanatory/educational
+- 🟢 **what-changed** - Implementation details
+
+---
+
+## Testing Instructions
+
+### Option 1: Quick Test (No Installation)
+
+```bash
+# Clone and checkout experimental branch
+git clone https://github.com/thedotmack/claude-mem.git
+cd claude-mem
+git checkout feature/context-with-observations
+
+# Build the experimental version
+npm install
+npm run build
+
+# Navigate to YOUR project directory
+cd /path/to/your/project
+
+# Run the experimental context hook with full path
+node /path/to/claude-mem/plugin/scripts/context-hook.js
+
+# Example:
+# cd ~/my-app
+# node ~/Downloads/claude-mem/plugin/scripts/context-hook.js
+```
+
+**Important:** The context hook reads from the current working directory (cwd). You must run it from your project's root folder to see context for that specific project.
+
+This shows you the new context format without installing the plugin.
+
+### Option 2: Full Testing (Install Locally)
+
+If you're already using claude-mem and want to test the experimental version:
+
+```bash
+# Navigate to your local claude-mem plugin directory
+cd ~/.claude/plugins/marketplaces/thedotmack
+
+# Checkout experimental branch
+git fetch origin
+git checkout feature/context-with-observations
+
+# Rebuild
+npm install
+npm run build
+
+# Restart Claude Code to see the new context injection
+```
+
+**⚠️ Warning:** This will replace your current context hook. To revert:
+```bash
+git checkout main
+npm run build
+```
+
+---
+
+## What We Want to Know
+
+Please test the experimental branch and share your feedback on these questions:
+
+### 1. Behavioral Impact
+- ✅ **Does Claude use MCP search more effectively?**
+  - Does it fetch observation details more often?
+  - Does it make better decisions about when to search vs read code?
+
+### 2. Token Cost Analysis
+- 💰 **Do token counts influence Claude's retrieval decisions?**
+  - Does Claude reference the token counts when deciding whether to fetch?
+  - Example: "This observation is 500 tokens, so I'll read the code instead"
+
+### 3. Instruction Effectiveness
+- 📖 **Is the progressive disclosure guidance helpful or noisy?**
+  - Does Claude seem to understand the layered retrieval concept?
+  - Do the instructions clutter the context or improve clarity?
+
+### 4. Efficiency Gains
+- 🚀 **Does it reduce redundant code reading?**
+  - Does Claude fetch learnings instead of re-reading entire files?
+  - Overall: Is it faster/smarter despite the higher initial token cost?
+
+### 5. User Experience
+- 👤 **Is the observation table too cluttered?**
+  - Does the table format help or hurt readability?
+  - Would you prefer a different presentation?
+
+---
+
+## How to Provide Feedback
+
+### 📣 GitHub Issues (Please Use This!)
+
+**[→ Click here to open a new issue](https://github.com/thedotmack/claude-mem/issues/new)**
+
+Add the label `feedback: progressive-disclosure` and use this template:
+
+```markdown
+## Progressive Disclosure Feedback
+
+**Branch tested:** feature/context-with-observations
+**Test duration:** [e.g., 2 days, 10 sessions]
+**Project type:** [e.g., TypeScript library, React app, Python backend]
+
+### What worked well:
+- [Your positive observations]
+
+### What didn't work:
+- [Issues or concerns]
+
+### Specific answers:
+1. **Claude's MCP search usage:** [Improved/Same/Worse]
+2. **Token count influence:** [Yes/No/Unclear]
+3. **Instructions helpful:** [Yes/No/Too verbose]
+4. **Code reading reduction:** [Yes/No/Hard to tell]
+5. **Overall impression:** [Worth merging/Needs work/Not useful]
+
+### Additional notes:
+[Any other feedback, screenshots, or examples]
+```
+
+**Why issues?** It keeps all feedback in one searchable place and lets other users see what's being discussed. Please don't hesitate to open an issue - all feedback is valuable, positive or negative!
+
+---
+
+## Next Steps
+
+Based on feedback, we'll decide:
+
+### ✅ If Successful:
+- Merge to `main` branch
+- Release as v4.3.0
+- Make progressive disclosure the default
+- Potentially add verbosity settings (minimal/standard/detailed)
+
+### ⚠️ If Mixed Results:
+- Make it opt-in via settings: `CLAUDE_MEM_VERBOSE_CONTEXT=true`
+- Default to current minimal approach
+- Allow users to choose their preference
+
+### ❌ If Unsuccessful:
+- Keep as experimental branch
+- Continue iterating on the approach
+- May explore alternative presentation formats
+
+---
+
+## Technical Details
+
+### Files Changed
+
+- **src/hooks/context.ts** (lines 227-240)
+  - Added progressive disclosure instructions
+  - Enhanced observation table rendering
+  - Token count display for each observation
+
+### Token Cost Breakdown
+
+**Current version (v4.2.x):**
+- Session summaries only: ~800 tokens
+- 3 sessions × ~250 tokens each
+- Minimal overhead
+
+**Experimental version:**
+- Progressive disclosure instructions: ~150 tokens
+- Observation index: ~2,000 tokens
+  - 50 observations × ~40 tokens per row
+- Session summaries: ~800 tokens
+- **Total: ~2,950 tokens**
+
+**ROI Analysis:**
+- If this prevents even ONE 2,000-token file read per session, it pays for itself
+- If Claude makes smarter retrieval decisions, overall token usage could be lower
+
+---
+
+## Acknowledgments
+
+This experimental feature was inspired by:
+- Anthropic's "Effective context engineering for AI agents" (Sept 2025)
+- Claude Skills' progressive disclosure architecture (Oct 2025)
+- Real-world usage patterns from 200+ GitHub stars in 36 hours
+
+Special thanks to our early adopters for pushing the boundaries of what's possible with persistent memory!
+
+---
+
+## Questions?
+
+- 📖 **Docs:** [docs/](docs/)
+- 🐛 **Issues:** [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
+- 💬 **Discussion:** [GitHub Discussions](https://github.com/thedotmack/claude-mem/discussions)
+
+---
+
+**Happy Testing!** 🧪
+
+We're excited to hear what you discover with progressive disclosure. This could be a game-changer for how Claude leverages long-term memory, but we need your real-world testing to validate the approach.
+
+— Alex Newman ([@thedotmack](https://github.com/thedotmack))

GITHUB_RELEASE_TEMPLATE.md

@@ -0,0 +1,83 @@
+# 🧪 Experimental: Progressive Disclosure Context System
+
+> **We'd love your feedback!** Test the new context injection approach and share your experience.
+
+## What is Progressive Disclosure?
+
+A **layered memory retrieval system** that shows Claude:
+1. **Index** (frontloaded): What observations exist + token costs
+2. **Details** (on-demand): Full narratives via MCP search
+3. **Perfect recall**: Source code when needed
+
+**The idea:** Instead of hiding observations completely, show an index so Claude can make informed decisions about what to fetch.
+
+## Try It Out
+
+```bash
+# Clone and build experimental version
+git clone https://github.com/thedotmack/claude-mem.git
+cd claude-mem
+git checkout feature/context-with-observations
+npm install && npm run build
+
+# Navigate to YOUR project and run the hook
+cd /path/to/your/project
+node /path/to/claude-mem/plugin/scripts/context-hook.js
+```
+
+**Important:** Run from your project's root directory to see context for that project.
+
+## What's Different?
+
+**Current (v4.2.x):** Session summaries only (~800 tokens)
+```markdown
+Session #312: Put date/time at end of session titles
+Completed: Added formatting
+Next: Test edge cases
+```
+
+**Experimental:** Observation index + summaries (~2,500 tokens)
+```markdown
+**src/hooks/context.ts**
+| ID | Time | T | Title | Tokens |
+|----|------|---|-------|--------|
+| #2332 | 1:07 AM | 🔴 | Critical Bugfix: Session ID NULL | ~201 |
+| #2340 | 1:10 AM | 🟠 | Remove Redundant Summary Section | ~280 |
+```
+
+Now Claude knows:
+- What learnings exist (without loading them)
+- Cost to fetch details (~200 tokens)
+- Priority (🔴 critical vs 🔵 informational)
+
+## We Want Your Feedback
+
+Test the experimental branch and tell us:
+
+✅ **Does Claude use MCP search more effectively?**
+💰 **Do token counts influence retrieval decisions?**
+📖 **Are the instructions helpful or noisy?**
+🚀 **Does it reduce redundant code reading?**
+
+### 📣 [Please Open a GitHub Issue](https://github.com/thedotmack/claude-mem/issues/new) With Your Experience!
+
+Use the label `feedback: progressive-disclosure` - all feedback is valuable, positive or negative!
+
+## Files Changed
+
+- Updated `README.md` with experimental feature section
+- Enhanced `src/hooks/context.ts` with progressive disclosure instructions
+- New docs: `EXPERIMENTAL_RELEASE_NOTES.md` (full details)
+
+## Next Steps
+
+Based on your feedback:
+- ✅ **If successful:** Merge to main, release as v4.3.0
+- ⚠️ **If mixed:** Make opt-in via settings
+- ❌ **If unsuccessful:** Keep iterating as experimental
+
+---
+
+**Full details:** See [EXPERIMENTAL_RELEASE_NOTES.md](EXPERIMENTAL_RELEASE_NOTES.md)
+
+**Questions?** Join the discussion or open an issue!

bun.lock

@@ -1,260 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "claude-mem",
-      "dependencies": {
-        "@anthropic-ai/claude-agent-sdk": "^0.1.0",
-        "@clack/prompts": "^0.11.0",
-        "better-sqlite3": "^11.8.1",
-        "boxen": "^8.0.1",
-        "chalk": "^5.6.0",
-        "commander": "^14.0.0",
-        "glob": "^11.0.3",
-        "gradient-string": "^3.0.0",
-        "handlebars": "^4.7.8",
-      },
-    },
-  },
-  "packages": {
-    "@anthropic-ai/claude-agent-sdk": ["@anthropic-ai/claude-agent-sdk@0.1.15", "", { "optionalDependencies": { "@img/sharp-darwin-arm64": "^0.33.5", "@img/sharp-darwin-x64": "^0.33.5", "@img/sharp-linux-arm": "^0.33.5", "@img/sharp-linux-arm64": "^0.33.5", "@img/sharp-linux-x64": "^0.33.5", "@img/sharp-win32-x64": "^0.33.5" }, "peerDependencies": { "zod": "^3.24.1" } }, "sha512-x0UR/YW87lRel3wYVimWjAkUOEGapg/nXx2GYNLbUD1ORsetRHeXZGFdJMuhRkk1Jt9sbn5m/RpT42b5R0pgYg=="],
-
-    "@clack/core": ["@clack/core@0.5.0", "", { "dependencies": { "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-p3y0FIOwaYRUPRcMO7+dlmLh8PSRcrjuTndsiA0WAFbWES0mLZlrjVoBRZ9DzkPFJZG6KGkJmoEAY0ZcVWTkow=="],
-
-    "@clack/prompts": ["@clack/prompts@0.11.0", "", { "dependencies": { "@clack/core": "0.5.0", "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-pMN5FcrEw9hUkZA4f+zLlzivQSeQf5dRGJjSUbvVYDLvpKCdQx5OaknvKzgbtXOizhP+SJJJjqEbOe55uKKfAw=="],
-
-    "@img/sharp-darwin-arm64": ["@img/sharp-darwin-arm64@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.0.4" }, "os": "darwin", "cpu": "arm64" }, "sha512-UT4p+iz/2H4twwAoLCqfA9UH5pI6DggwKEGuaPy7nCVQ8ZsiY5PIcrRvD1DzuY3qYL07NtIQcWnBSY/heikIFQ=="],
-
-    "@img/sharp-darwin-x64": ["@img/sharp-darwin-x64@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-x64": "1.0.4" }, "os": "darwin", "cpu": "x64" }, "sha512-fyHac4jIc1ANYGRDxtiqelIbdWkIuQaI84Mv45KvGRRxSAa7o7d1ZKAOBaYbnepLC1WqxfpimdeWfvqqSGwR2Q=="],
-
-    "@img/sharp-libvips-darwin-arm64": ["@img/sharp-libvips-darwin-arm64@1.0.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-XblONe153h0O2zuFfTAbQYAX2JhYmDHeWikp1LM9Hul9gVPjFY427k6dFEcOL72O01QxQsWi761svJ/ev9xEDg=="],
-
-    "@img/sharp-libvips-darwin-x64": ["@img/sharp-libvips-darwin-x64@1.0.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-xnGR8YuZYfJGmWPvmlunFaWJsb9T/AO2ykoP3Fz/0X5XV2aoYBPkX6xqCQvUTKKiLddarLaxpzNe+b1hjeWHAQ=="],
-
-    "@img/sharp-libvips-linux-arm": ["@img/sharp-libvips-linux-arm@1.0.5", "", { "os": "linux", "cpu": "arm" }, "sha512-gvcC4ACAOPRNATg/ov8/MnbxFDJqf/pDePbBnuBDcjsI8PssmjoKMAz4LtLaVi+OnSb5FK/yIOamqDwGmXW32g=="],
-
-    "@img/sharp-libvips-linux-arm64": ["@img/sharp-libvips-linux-arm64@1.0.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-9B+taZ8DlyyqzZQnoeIvDVR/2F4EbMepXMc/NdVbkzsJbzkUjhXv/70GQJ7tdLA4YJgNP25zukcxpX2/SueNrA=="],
-
-    "@img/sharp-libvips-linux-x64": ["@img/sharp-libvips-linux-x64@1.0.4", "", { "os": "linux", "cpu": "x64" }, "sha512-MmWmQ3iPFZr0Iev+BAgVMb3ZyC4KeFc3jFxnNbEPas60e1cIfevbtuyf9nDGIzOaW9PdnDciJm+wFFaTlj5xYw=="],
-
-    "@img/sharp-linux-arm": ["@img/sharp-linux-arm@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm": "1.0.5" }, "os": "linux", "cpu": "arm" }, "sha512-JTS1eldqZbJxjvKaAkxhZmBqPRGmxgu+qFKSInv8moZ2AmT5Yib3EQ1c6gp493HvrvV8QgdOXdyaIBrhvFhBMQ=="],
-
-    "@img/sharp-linux-arm64": ["@img/sharp-linux-arm64@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm64": "1.0.4" }, "os": "linux", "cpu": "arm64" }, "sha512-JMVv+AMRyGOHtO1RFBiJy/MBsgz0x4AWrT6QoEVVTyh1E39TrCUpTRI7mx9VksGX4awWASxqCYLCV4wBZHAYxA=="],
-
-    "@img/sharp-linux-x64": ["@img/sharp-linux-x64@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-x64": "1.0.4" }, "os": "linux", "cpu": "x64" }, "sha512-opC+Ok5pRNAzuvq1AG0ar+1owsu842/Ab+4qvU879ippJBHvyY5n2mxF1izXqkPYlGuP/M556uh53jRLJmzTWA=="],
-
-    "@img/sharp-win32-x64": ["@img/sharp-win32-x64@0.33.5", "", { "os": "win32", "cpu": "x64" }, "sha512-MpY/o8/8kj+EcnxwvrP4aTJSWw/aZ7JIGR4aBeZkZw5B7/Jn+tY9/VNwtcoGmdT7GfggGIU4kygOMSbYnOrAbg=="],
-
-    "@isaacs/balanced-match": ["@isaacs/balanced-match@4.0.1", "", {}, "sha512-yzMTt9lEb8Gv7zRioUilSglI0c0smZ9k5D65677DLWLtWJaXIS3CqcGyUFByYKlnUj6TkjLVs54fBl6+TiGQDQ=="],
-
-    "@isaacs/brace-expansion": ["@isaacs/brace-expansion@5.0.0", "", { "dependencies": { "@isaacs/balanced-match": "^4.0.1" } }, "sha512-ZT55BDLV0yv0RBm2czMiZ+SqCGO7AvmOM3G/w2xhVPH+te0aKgFjmBvGlL1dH+ql2tgGO3MVrbb3jCKyvpgnxA=="],
-
-    "@isaacs/cliui": ["@isaacs/cliui@8.0.2", "", { "dependencies": { "string-width": "^5.1.2", "string-width-cjs": "npm:string-width@^4.2.0", "strip-ansi": "^7.0.1", "strip-ansi-cjs": "npm:strip-ansi@^6.0.1", "wrap-ansi": "^8.1.0", "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0" } }, "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA=="],
-
-    "@types/tinycolor2": ["@types/tinycolor2@1.4.6", "", {}, "sha512-iEN8J0BoMnsWBqjVbWH/c0G0Hh7O21lpR2/+PrvAVgWdzL7eexIFm4JN/Wn10PTcmNdtS6U67r499mlWMXOxNw=="],
-
-    "ansi-align": ["ansi-align@3.0.1", "", { "dependencies": { "string-width": "^4.1.0" } }, "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w=="],
-
-    "ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
-
-    "ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],
-
-    "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="],
-
-    "better-sqlite3": ["better-sqlite3@11.10.0", "", { "dependencies": { "bindings": "^1.5.0", "prebuild-install": "^7.1.1" } }, "sha512-EwhOpyXiOEL/lKzHz9AW1msWFNzGc/z+LzeB3/jnFJpxu+th2yqvzsSWas1v9jgs9+xiXJcD5A8CJxAG2TaghQ=="],
-
-    "bindings": ["bindings@1.5.0", "", { "dependencies": { "file-uri-to-path": "1.0.0" } }, "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ=="],
-
-    "bl": ["bl@4.1.0", "", { "dependencies": { "buffer": "^5.5.0", "inherits": "^2.0.4", "readable-stream": "^3.4.0" } }, "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w=="],
-
-    "boxen": ["boxen@8.0.1", "", { "dependencies": { "ansi-align": "^3.0.1", "camelcase": "^8.0.0", "chalk": "^5.3.0", "cli-boxes": "^3.0.0", "string-width": "^7.2.0", "type-fest": "^4.21.0", "widest-line": "^5.0.0", "wrap-ansi": "^9.0.0" } }, "sha512-F3PH5k5juxom4xktynS7MoFY+NUWH5LC4CnH11YB8NPew+HLpmBLCybSAEyb2F+4pRXhuhWqFesoQd6DAyc2hw=="],
-
-    "buffer": ["buffer@5.7.1", "", { "dependencies": { "base64-js": "^1.3.1", "ieee754": "^1.1.13" } }, "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ=="],
-
-    "camelcase": ["camelcase@8.0.0", "", {}, "sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA=="],
-
-    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
-
-    "chownr": ["chownr@1.1.4", "", {}, "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg=="],
-
-    "cli-boxes": ["cli-boxes@3.0.0", "", {}, "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g=="],
-
-    "color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
-
-    "color-name": ["color-name@1.1.4", "", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="],
-
-    "commander": ["commander@14.0.1", "", {}, "sha512-2JkV3gUZUVrbNA+1sjBOYLsMZ5cEEl8GTFP2a4AVz5hvasAMCQ1D2l2le/cX+pV4N6ZU17zjUahLpIXRrnWL8A=="],
-
-    "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
-
-    "decompress-response": ["decompress-response@6.0.0", "", { "dependencies": { "mimic-response": "^3.1.0" } }, "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ=="],
-
-    "deep-extend": ["deep-extend@0.6.0", "", {}, "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA=="],
-
-    "detect-libc": ["detect-libc@2.1.2", "", {}, "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ=="],
-
-    "eastasianwidth": ["eastasianwidth@0.2.0", "", {}, "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA=="],
-
-    "emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
-
-    "end-of-stream": ["end-of-stream@1.4.5", "", { "dependencies": { "once": "^1.4.0" } }, "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg=="],
-
-    "expand-template": ["expand-template@2.0.3", "", {}, "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg=="],
-
-    "file-uri-to-path": ["file-uri-to-path@1.0.0", "", {}, "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw=="],
-
-    "foreground-child": ["foreground-child@3.3.1", "", { "dependencies": { "cross-spawn": "^7.0.6", "signal-exit": "^4.0.1" } }, "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw=="],
-
-    "fs-constants": ["fs-constants@1.0.0", "", {}, "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow=="],
-
-    "get-east-asian-width": ["get-east-asian-width@1.4.0", "", {}, "sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q=="],
-
-    "github-from-package": ["github-from-package@0.0.0", "", {}, "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw=="],
-
-    "glob": ["glob@11.0.3", "", { "dependencies": { "foreground-child": "^3.3.1", "jackspeak": "^4.1.1", "minimatch": "^10.0.3", "minipass": "^7.1.2", "package-json-from-dist": "^1.0.0", "path-scurry": "^2.0.0" }, "bin": { "glob": "dist/esm/bin.mjs" } }, "sha512-2Nim7dha1KVkaiF4q6Dj+ngPPMdfvLJEOpZk/jKiUAkqKebpGAWQXAq9z1xu9HKu5lWfqw/FASuccEjyznjPaA=="],
-
-    "gradient-string": ["gradient-string@3.0.0", "", { "dependencies": { "chalk": "^5.3.0", "tinygradient": "^1.1.5" } }, "sha512-frdKI4Qi8Ihp4C6wZNB565de/THpIaw3DjP5ku87M+N9rNSGmPTjfkq61SdRXB7eCaL8O1hkKDvf6CDMtOzIAg=="],
-
-    "handlebars": ["handlebars@4.7.8", "", { "dependencies": { "minimist": "^1.2.5", "neo-async": "^2.6.2", "source-map": "^0.6.1", "wordwrap": "^1.0.0" }, "optionalDependencies": { "uglify-js": "^3.1.4" }, "bin": { "handlebars": "bin/handlebars" } }, "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ=="],
-
-    "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="],
-
-    "inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],
-
-    "ini": ["ini@1.3.8", "", {}, "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew=="],
-
-    "is-fullwidth-code-point": ["is-fullwidth-code-point@3.0.0", "", {}, "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg=="],
-
-    "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
-
-    "jackspeak": ["jackspeak@4.1.1", "", { "dependencies": { "@isaacs/cliui": "^8.0.2" } }, "sha512-zptv57P3GpL+O0I7VdMJNBZCu+BPHVQUk55Ft8/QCJjTVxrnJHuVuX/0Bl2A6/+2oyR/ZMEuFKwmzqqZ/U5nPQ=="],
-
-    "lru-cache": ["lru-cache@11.2.2", "", {}, "sha512-F9ODfyqML2coTIsQpSkRHnLSZMtkU8Q+mSfcaIyKwy58u+8k5nvAYeiNhsyMARvzNcXJ9QfWVrcPsC9e9rAxtg=="],
-
-    "mimic-response": ["mimic-response@3.1.0", "", {}, "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ=="],
-
-    "minimatch": ["minimatch@10.0.3", "", { "dependencies": { "@isaacs/brace-expansion": "^5.0.0" } }, "sha512-IPZ167aShDZZUMdRk66cyQAW3qr0WzbHkPdMYa8bzZhlHhO3jALbKdxcaak7W9FfT2rZNpQuUu4Od7ILEpXSaw=="],
-
-    "minimist": ["minimist@1.2.8", "", {}, "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA=="],
-
-    "minipass": ["minipass@7.1.2", "", {}, "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw=="],
-
-    "mkdirp-classic": ["mkdirp-classic@0.5.3", "", {}, "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A=="],
-
-    "napi-build-utils": ["napi-build-utils@2.0.0", "", {}, "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA=="],
-
-    "neo-async": ["neo-async@2.6.2", "", {}, "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw=="],
-
-    "node-abi": ["node-abi@3.78.0", "", { "dependencies": { "semver": "^7.3.5" } }, "sha512-E2wEyrgX/CqvicaQYU3Ze1PFGjc4QYPGsjUrlYkqAE0WjHEZwgOsGMPMzkMse4LjJbDmaEuDX3CM036j5K2DSQ=="],
-
-    "once": ["once@1.4.0", "", { "dependencies": { "wrappy": "1" } }, "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w=="],
-
-    "package-json-from-dist": ["package-json-from-dist@1.0.1", "", {}, "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw=="],
-
-    "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
-
-    "path-scurry": ["path-scurry@2.0.0", "", { "dependencies": { "lru-cache": "^11.0.0", "minipass": "^7.1.2" } }, "sha512-ypGJsmGtdXUOeM5u93TyeIEfEhM6s+ljAhrk5vAvSx8uyY/02OvrZnA0YNGUrPXfpJMgI1ODd3nwz8Npx4O4cg=="],
-
-    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
-
-    "prebuild-install": ["prebuild-install@7.1.3", "", { "dependencies": { "detect-libc": "^2.0.0", "expand-template": "^2.0.3", "github-from-package": "0.0.0", "minimist": "^1.2.3", "mkdirp-classic": "^0.5.3", "napi-build-utils": "^2.0.0", "node-abi": "^3.3.0", "pump": "^3.0.0", "rc": "^1.2.7", "simple-get": "^4.0.0", "tar-fs": "^2.0.0", "tunnel-agent": "^0.6.0" }, "bin": { "prebuild-install": "bin.js" } }, "sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug=="],
-
-    "pump": ["pump@3.0.3", "", { "dependencies": { "end-of-stream": "^1.1.0", "once": "^1.3.1" } }, "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA=="],
-
-    "rc": ["rc@1.2.8", "", { "dependencies": { "deep-extend": "^0.6.0", "ini": "~1.3.0", "minimist": "^1.2.0", "strip-json-comments": "~2.0.1" }, "bin": { "rc": "./cli.js" } }, "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw=="],
-
-    "readable-stream": ["readable-stream@3.6.2", "", { "dependencies": { "inherits": "^2.0.3", "string_decoder": "^1.1.1", "util-deprecate": "^1.0.1" } }, "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA=="],
-
-    "safe-buffer": ["safe-buffer@5.2.1", "", {}, "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="],
-
-    "semver": ["semver@7.7.3", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q=="],
-
-    "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
-
-    "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
-
-    "signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
-
-    "simple-concat": ["simple-concat@1.0.1", "", {}, "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q=="],
-
-    "simple-get": ["simple-get@4.0.1", "", { "dependencies": { "decompress-response": "^6.0.0", "once": "^1.3.1", "simple-concat": "^1.0.0" } }, "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA=="],
-
-    "sisteransi": ["sisteransi@1.0.5", "", {}, "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="],
-
-    "source-map": ["source-map@0.6.1", "", {}, "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g=="],
-
-    "string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
-
-    "string-width-cjs": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
-
-    "string_decoder": ["string_decoder@1.3.0", "", { "dependencies": { "safe-buffer": "~5.2.0" } }, "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA=="],
-
-    "strip-ansi": ["strip-ansi@7.1.2", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],
-
-    "strip-ansi-cjs": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
-
-    "strip-json-comments": ["strip-json-comments@2.0.1", "", {}, "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ=="],
-
-    "tar-fs": ["tar-fs@2.1.4", "", { "dependencies": { "chownr": "^1.1.1", "mkdirp-classic": "^0.5.2", "pump": "^3.0.0", "tar-stream": "^2.1.4" } }, "sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ=="],
-
-    "tar-stream": ["tar-stream@2.2.0", "", { "dependencies": { "bl": "^4.0.3", "end-of-stream": "^1.4.1", "fs-constants": "^1.0.0", "inherits": "^2.0.3", "readable-stream": "^3.1.1" } }, "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ=="],
-
-    "tinycolor2": ["tinycolor2@1.6.0", "", {}, "sha512-XPaBkWQJdsf3pLKJV9p4qN/S+fm2Oj8AIPo1BTUhg5oxkvm9+SVEGFdhyOz7tTdUTfvxMiAs4sp6/eZO2Ew+pw=="],
-
-    "tinygradient": ["tinygradient@1.1.5", "", { "dependencies": { "@types/tinycolor2": "^1.4.0", "tinycolor2": "^1.0.0" } }, "sha512-8nIfc2vgQ4TeLnk2lFj4tRLvvJwEfQuabdsmvDdQPT0xlk9TaNtpGd6nNRxXoK6vQhN6RSzj+Cnp5tTQmpxmbw=="],
-
-    "tunnel-agent": ["tunnel-agent@0.6.0", "", { "dependencies": { "safe-buffer": "^5.0.1" } }, "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w=="],
-
-    "type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
-
-    "uglify-js": ["uglify-js@3.19.3", "", { "bin": { "uglifyjs": "bin/uglifyjs" } }, "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ=="],
-
-    "util-deprecate": ["util-deprecate@1.0.2", "", {}, "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw=="],
-
-    "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
-
-    "widest-line": ["widest-line@5.0.0", "", { "dependencies": { "string-width": "^7.0.0" } }, "sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA=="],
-
-    "wordwrap": ["wordwrap@1.0.0", "", {}, "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q=="],
-
-    "wrap-ansi": ["wrap-ansi@9.0.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww=="],
-
-    "wrap-ansi-cjs": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],
-
-    "wrappy": ["wrappy@1.0.2", "", {}, "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="],
-
-    "zod": ["zod@3.25.76", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
-
-    "@isaacs/cliui/string-width": ["string-width@5.1.2", "", { "dependencies": { "eastasianwidth": "^0.2.0", "emoji-regex": "^9.2.2", "strip-ansi": "^7.0.1" } }, "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA=="],
-
-    "@isaacs/cliui/wrap-ansi": ["wrap-ansi@8.1.0", "", { "dependencies": { "ansi-styles": "^6.1.0", "string-width": "^5.0.1", "strip-ansi": "^7.0.1" } }, "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ=="],
-
-    "ansi-align/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
-
-    "string-width-cjs/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
-
-    "string-width-cjs/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
-
-    "strip-ansi-cjs/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
-
-    "wrap-ansi-cjs/ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="],
-
-    "wrap-ansi-cjs/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
-
-    "wrap-ansi-cjs/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
-
-    "@isaacs/cliui/string-width/emoji-regex": ["emoji-regex@9.2.2", "", {}, "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg=="],
-
-    "ansi-align/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
-
-    "ansi-align/string-width/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
-
-    "string-width-cjs/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
-
-    "wrap-ansi-cjs/string-width/emoji-regex": ["emoji-regex@8.0.0", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],
-
-    "wrap-ansi-cjs/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
-
-    "ansi-align/string-width/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
-  }
-}

context/architecture/v3-to-v4.md

@@ -1,4 +1,6 @@
-# Claude-Mem Architecture Refactor Plan
+# Claude-Mem Architecture v3 to v4 Plan (✅ Completed)
+
+This file exists as a reference to explain the path forward from v3 to v4.
 
 ## Core Purpose
 

context/claude-code/agent-skills.md

@@ -0,0 +1,607 @@
+# Agent Skills
+
+> Create, manage, and share Skills to extend Claude's capabilities in Claude Code.
+
+This guide shows you how to create, use, and manage Agent Skills in Claude Code. Skills are modular capabilities that extend Claude's functionality through organized folders containing instructions, scripts, and resources.
+
+## Prerequisites
+
+* Claude Code version 1.0 or later
+* Basic familiarity with [Claude Code](/en/docs/claude-code/quickstart)
+
+## What are Agent Skills?
+
+Agent Skills package expertise into discoverable capabilities. Each Skill consists of a `SKILL.md` file with instructions that Claude reads when relevant, plus optional supporting files like scripts and templates.
+
+**How Skills are invoked**: Skills are **model-invoked**—Claude autonomously decides when to use them based on your request and the Skill's description. This is different from slash commands, which are **user-invoked** (you explicitly type `/command` to trigger them).
+
+**Benefits**:
+
+* Extend Claude's capabilities for your specific workflows
+* Share expertise across your team via git
+* Reduce repetitive prompting
+* Compose multiple Skills for complex tasks
+
+Learn more in the [Agent Skills overview](/en/docs/agents-and-tools/agent-skills/overview).
+
+<Note>
+  For a deep dive into the architecture and real-world applications of Agent Skills, read our engineering blog: [Equipping agents for the real world with Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills).
+</Note>
+
+## Create a Skill
+
+Skills are stored as directories containing a `SKILL.md` file.
+
+### Personal Skills
+
+Personal Skills are available across all your projects. Store them in `~/.claude/skills/`:
+
+```bash  theme={null}
+mkdir -p ~/.claude/skills/my-skill-name
+```
+
+**Use personal Skills for**:
+
+* Your individual workflows and preferences
+* Experimental Skills you're developing
+* Personal productivity tools
+
+### Project Skills
+
+Project Skills are shared with your team. Store them in `.claude/skills/` within your project:
+
+```bash  theme={null}
+mkdir -p .claude/skills/my-skill-name
+```
+
+**Use project Skills for**:
+
+* Team workflows and conventions
+* Project-specific expertise
+* Shared utilities and scripts
+
+Project Skills are checked into git and automatically available to team members.
+
+### Plugin Skills
+
+Skills can also come from [Claude Code plugins](/en/docs/claude-code/plugins). Plugins may bundle Skills that are automatically available when the plugin is installed. These Skills work the same way as personal and project Skills.
+
+## Write SKILL.md
+
+Create a `SKILL.md` file with YAML frontmatter and Markdown content:
+
+```yaml  theme={null}
+---
+name: your-skill-name
+description: Brief description of what this Skill does and when to use it
+---
+
+# Your Skill Name
+
+## Instructions
+Provide clear, step-by-step guidance for Claude.
+
+## Examples
+Show concrete examples of using this Skill.
+```
+
+**Field requirements**:
+
+* `name`: Must use lowercase letters, numbers, and hyphens only (max 64 characters)
+* `description`: Brief description of what the Skill does and when to use it (max 1024 characters)
+
+The `description` field is critical for Claude to discover when to use your Skill. It should include both what the Skill does and when Claude should use it.
+
+See the [best practices guide](/en/docs/agents-and-tools/agent-skills/best-practices) for complete authoring guidance including validation rules.
+
+## Add supporting files
+
+Create additional files alongside SKILL.md:
+
+```
+my-skill/
+├── SKILL.md (required)
+├── reference.md (optional documentation)
+├── examples.md (optional examples)
+├── scripts/
+│   └── helper.py (optional utility)
+└── templates/
+    └── template.txt (optional template)
+```
+
+Reference these files from SKILL.md:
+
+````markdown  theme={null}
+For advanced usage, see [reference.md](reference.md).
+
+Run the helper script:
+```bash
+python scripts/helper.py input.txt
+```
+````
+
+Claude reads these files only when needed, using progressive disclosure to manage context efficiently.
+
+## Restrict tool access with allowed-tools
+
+Use the `allowed-tools` frontmatter field to limit which tools Claude can use when a Skill is active:
+
+```yaml  theme={null}
+---
+name: safe-file-reader
+description: Read files without making changes. Use when you need read-only file access.
+allowed-tools: Read, Grep, Glob
+---
+
+# Safe File Reader
+
+This Skill provides read-only file access.
+
+## Instructions
+1. Use Read to view file contents
+2. Use Grep to search within files
+3. Use Glob to find files by pattern
+```
+
+When this Skill is active, Claude can only use the specified tools (Read, Grep, Glob) without needing to ask for permission. This is useful for:
+
+* Read-only Skills that shouldn't modify files
+* Skills with limited scope (e.g., only data analysis, no file writing)
+* Security-sensitive workflows where you want to restrict capabilities
+
+If `allowed-tools` is not specified, Claude will ask for permission to use tools as normal, following the standard permission model.
+
+<Note>
+  `allowed-tools` is only supported for Skills in Claude Code.
+</Note>
+
+## View available Skills
+
+Skills are automatically discovered by Claude from three sources:
+
+* Personal Skills: `~/.claude/skills/`
+* Project Skills: `.claude/skills/`
+* Plugin Skills: bundled with installed plugins
+
+**To view all available Skills**, ask Claude directly:
+
+```
+What Skills are available?
+```
+
+or
+
+```
+List all available Skills
+```
+
+This will show all Skills from all sources, including plugin Skills.
+
+**To inspect a specific Skill**, you can also check the filesystem:
+
+```bash  theme={null}
+# List personal Skills
+ls ~/.claude/skills/
+
+# List project Skills (if in a project directory)
+ls .claude/skills/
+
+# View a specific Skill's content
+cat ~/.claude/skills/my-skill/SKILL.md
+```
+
+## Test a Skill
+
+After creating a Skill, test it by asking questions that match your description.
+
+**Example**: If your description mentions "PDF files":
+
+```
+Can you help me extract text from this PDF?
+```
+
+Claude autonomously decides to use your Skill if it matches the request—you don't need to explicitly invoke it. The Skill activates automatically based on the context of your question.
+
+## Debug a Skill
+
+If Claude doesn't use your Skill, check these common issues:
+
+### Make description specific
+
+**Too vague**:
+
+```yaml  theme={null}
+description: Helps with documents
+```
+
+**Specific**:
+
+```yaml  theme={null}
+description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
+```
+
+Include both what the Skill does and when to use it in the description.
+
+### Verify file path
+
+**Personal Skills**: `~/.claude/skills/skill-name/SKILL.md`
+**Project Skills**: `.claude/skills/skill-name/SKILL.md`
+
+Check the file exists:
+
+```bash  theme={null}
+# Personal
+ls ~/.claude/skills/my-skill/SKILL.md
+
+# Project
+ls .claude/skills/my-skill/SKILL.md
+```
+
+### Check YAML syntax
+
+Invalid YAML prevents the Skill from loading. Verify the frontmatter:
+
+```bash  theme={null}
+cat SKILL.md | head -n 10
+```
+
+Ensure:
+
+* Opening `---` on line 1
+* Closing `---` before Markdown content
+* Valid YAML syntax (no tabs, correct indentation)
+
+### View errors
+
+Run Claude Code with debug mode to see Skill loading errors:
+
+```bash  theme={null}
+claude --debug
+```
+
+## Share Skills with your team
+
+**Recommended approach**: Distribute Skills through [plugins](/en/docs/claude-code/plugins).
+
+To share Skills via plugin:
+
+1. Create a plugin with Skills in the `skills/` directory
+2. Add the plugin to a marketplace
+3. Team members install the plugin
+
+For complete instructions, see [Add Skills to your plugin](/en/docs/claude-code/plugins#add-skills-to-your-plugin).
+
+You can also share Skills directly through project repositories:
+
+### Step 1: Add Skill to your project
+
+Create a project Skill:
+
+```bash  theme={null}
+mkdir -p .claude/skills/team-skill
+# Create SKILL.md
+```
+
+### Step 2: Commit to git
+
+```bash  theme={null}
+git add .claude/skills/
+git commit -m "Add team Skill for PDF processing"
+git push
+```
+
+### Step 3: Team members get Skills automatically
+
+When team members pull the latest changes, Skills are immediately available:
+
+```bash  theme={null}
+git pull
+claude  # Skills are now available
+```
+
+## Update a Skill
+
+Edit SKILL.md directly:
+
+```bash  theme={null}
+# Personal Skill
+code ~/.claude/skills/my-skill/SKILL.md
+
+# Project Skill
+code .claude/skills/my-skill/SKILL.md
+```
+
+Changes take effect the next time you start Claude Code. If Claude Code is already running, restart it to load the updates.
+
+## Remove a Skill
+
+Delete the Skill directory:
+
+```bash  theme={null}
+# Personal
+rm -rf ~/.claude/skills/my-skill
+
+# Project
+rm -rf .claude/skills/my-skill
+git commit -m "Remove unused Skill"
+```
+
+## Best practices
+
+### Keep Skills focused
+
+One Skill should address one capability:
+
+**Focused**:
+
+* "PDF form filling"
+* "Excel data analysis"
+* "Git commit messages"
+
+**Too broad**:
+
+* "Document processing" (split into separate Skills)
+* "Data tools" (split by data type or operation)
+
+### Write clear descriptions
+
+Help Claude discover when to use Skills by including specific triggers in your description:
+
+**Clear**:
+
+```yaml  theme={null}
+description: Analyze Excel spreadsheets, create pivot tables, and generate charts. Use when working with Excel files, spreadsheets, or analyzing tabular data in .xlsx format.
+```
+
+**Vague**:
+
+```yaml  theme={null}
+description: For files
+```
+
+### Test with your team
+
+Have teammates use Skills and provide feedback:
+
+* Does the Skill activate when expected?
+* Are the instructions clear?
+* Are there missing examples or edge cases?
+
+### Document Skill versions
+
+You can document Skill versions in your SKILL.md content to track changes over time. Add a version history section:
+
+```markdown  theme={null}
+# My Skill
+
+## Version History
+- v2.0.0 (2025-10-01): Breaking changes to API
+- v1.1.0 (2025-09-15): Added new features
+- v1.0.0 (2025-09-01): Initial release
+```
+
+This helps team members understand what changed between versions.
+
+## Troubleshooting
+
+### Claude doesn't use my Skill
+
+**Symptom**: You ask a relevant question but Claude doesn't use your Skill.
+
+**Check**: Is the description specific enough?
+
+Vague descriptions make discovery difficult. Include both what the Skill does and when to use it, with key terms users would mention.
+
+**Too generic**:
+
+```yaml  theme={null}
+description: Helps with data
+```
+
+**Specific**:
+
+```yaml  theme={null}
+description: Analyze Excel spreadsheets, generate pivot tables, create charts. Use when working with Excel files, spreadsheets, or .xlsx files.
+```
+
+**Check**: Is the YAML valid?
+
+Run validation to check for syntax errors:
+
+```bash  theme={null}
+# View frontmatter
+cat .claude/skills/my-skill/SKILL.md | head -n 15
+
+# Check for common issues
+# - Missing opening or closing ---
+# - Tabs instead of spaces
+# - Unquoted strings with special characters
+```
+
+**Check**: Is the Skill in the correct location?
+
+```bash  theme={null}
+# Personal Skills
+ls ~/.claude/skills/*/SKILL.md
+
+# Project Skills
+ls .claude/skills/*/SKILL.md
+```
+
+### Skill has errors
+
+**Symptom**: The Skill loads but doesn't work correctly.
+
+**Check**: Are dependencies available?
+
+Claude will automatically install required dependencies (or ask for permission to install them) when it needs them.
+
+**Check**: Do scripts have execute permissions?
+
+```bash  theme={null}
+chmod +x .claude/skills/my-skill/scripts/*.py
+```
+
+**Check**: Are file paths correct?
+
+Use forward slashes (Unix style) in all paths:
+
+**Correct**: `scripts/helper.py`
+**Wrong**: `scripts\helper.py` (Windows style)
+
+### Multiple Skills conflict
+
+**Symptom**: Claude uses the wrong Skill or seems confused between similar Skills.
+
+**Be specific in descriptions**: Help Claude choose the right Skill by using distinct trigger terms in your descriptions.
+
+Instead of:
+
+```yaml  theme={null}
+# Skill 1
+description: For data analysis
+
+# Skill 2
+description: For analyzing data
+```
+
+Use:
+
+```yaml  theme={null}
+# Skill 1
+description: Analyze sales data in Excel files and CRM exports. Use for sales reports, pipeline analysis, and revenue tracking.
+
+# Skill 2
+description: Analyze log files and system metrics data. Use for performance monitoring, debugging, and system diagnostics.
+```
+
+## Examples
+
+### Simple Skill (single file)
+
+```
+commit-helper/
+└── SKILL.md
+```
+
+```yaml  theme={null}
+---
+name: generating-commit-messages
+description: Generates clear commit messages from git diffs. Use when writing commit messages or reviewing staged changes.
+---
+
+# Generating Commit Messages
+
+## Instructions
+
+1. Run `git diff --staged` to see changes
+2. I'll suggest a commit message with:
+   - Summary under 50 characters
+   - Detailed description
+   - Affected components
+
+## Best practices
+
+- Use present tense
+- Explain what and why, not how
+```
+
+### Skill with tool permissions
+
+```
+code-reviewer/
+└── SKILL.md
+```
+
+```yaml  theme={null}
+---
+name: code-reviewer
+description: Review code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
+allowed-tools: Read, Grep, Glob
+---
+
+# Code Reviewer
+
+## Review checklist
+
+1. Code organization and structure
+2. Error handling
+3. Performance considerations
+4. Security concerns
+5. Test coverage
+
+## Instructions
+
+1. Read the target files using Read tool
+2. Search for patterns using Grep
+3. Find related files using Glob
+4. Provide detailed feedback on code quality
+```
+
+### Multi-file Skill
+
+```
+pdf-processing/
+├── SKILL.md
+├── FORMS.md
+├── REFERENCE.md
+└── scripts/
+    ├── fill_form.py
+    └── validate.py
+```
+
+**SKILL.md**:
+
+````yaml  theme={null}
+---
+name: pdf-processing
+description: Extract text, fill forms, merge PDFs. Use when working with PDF files, forms, or document extraction. Requires pypdf and pdfplumber packages.
+---
+
+# PDF Processing
+
+## Quick start
+
+Extract text:
+```python
+import pdfplumber
+with pdfplumber.open("doc.pdf") as pdf:
+    text = pdf.pages[0].extract_text()
+```
+
+For form filling, see [FORMS.md](FORMS.md).
+For detailed API reference, see [REFERENCE.md](REFERENCE.md).
+
+## Requirements
+
+Packages must be installed in your environment:
+```bash
+pip install pypdf pdfplumber
+```
+````
+
+<Note>
+  List required packages in the description. Packages must be installed in your environment before Claude can use them.
+</Note>
+
+Claude loads additional files only when needed.
+
+## Next steps
+
+<CardGroup cols={2}>
+  <Card title="Authoring best practices" icon="lightbulb" href="/en/docs/agents-and-tools/agent-skills/best-practices">
+    Write Skills that Claude can use effectively
+  </Card>
+
+  <Card title="Agent Skills overview" icon="book" href="/en/docs/agents-and-tools/agent-skills/overview">
+    Learn how Skills work across Claude products
+  </Card>
+
+  <Card title="Use Skills in the Agent SDK" icon="cube" href="/en/api/agent-sdk/skills">
+    Use Skills programmatically with TypeScript and Python
+  </Card>
+
+  <Card title="Get started with Agent Skills" icon="rocket" href="/en/docs/agents-and-tools/agent-skills/quickstart">
+    Create your first Skill
+  </Card>
+</CardGroup>

context/temp/PHASE1-COMPLETE.md

@@ -1,134 +0,0 @@
-# Phase 1 Implementation - Complete ✅
-
-Phase 1 of the REFACTOR-PLAN.md has been successfully implemented and tested.
-
-## What Was Implemented
-
-### 1. Database Schema (Migration 004)
-Created four new tables to support the SDK agent architecture:
-
-- **`sdk_sessions`** - Tracks SDK streaming sessions
-- **`observation_queue`** - Message queue for pending observations
-- **`observations`** - Stores extracted observations from SDK
-- **`session_summaries`** - Stores structured session summaries
-
-All tables include proper indexes for performance and foreign key constraints for data integrity.
-
-### 2. Shared Database Layer
-Created `HooksDatabase` class ([src/services/sqlite/HooksDatabase.ts](src/services/sqlite/HooksDatabase.ts)) that provides:
-
-- Simple, synchronous database operations for hooks
-- No complex logic - just basic CRUD operations
-- Optimized SQLite settings (WAL mode, foreign keys enabled)
-- Methods for all hook operations:
-  - `getRecentSummaries()` - Retrieve session context
-  - `createSDKSession()` - Initialize new session
-  - `queueObservation()` - Add observation to queue
-  - `storeObservation()` - Save SDK observations
-  - `storeSummary()` - Save session summaries
-  - And more...
-
-### 3. Hook Functions
-Implemented all four hook functions in [src/hooks/](src/hooks/):
-
-#### **context.ts** - SessionStart Hook
-- Shows user recent session context on startup
-- Formats summaries in markdown for Claude
-- Exits silently if no context or errors occur
-
-#### **save.ts** - PostToolUse Hook
-- Queues tool observations for SDK processing
-- Skips low-value tools (TodoWrite, ListMcpResourcesTool)
-- Non-blocking - returns immediately
-
-#### **new.ts** - UserPromptSubmit Hook
-- Initializes SDK session in database
-- Prepares for SDK worker spawn (TODO in Phase 2)
-- Non-blocking - returns immediately
-
-#### **summary.ts** - Stop Hook
-- Queues FINALIZE message for SDK
-- Signals SDK to generate session summary
-- Non-blocking - returns immediately
-
-### 4. CLI Integration
-Added four new commands to [src/bin/cli.ts](src/bin/cli.ts:227-274):
-
-```bash
-claude-mem context   # SessionStart hook
-claude-mem new       # UserPromptSubmit hook
-claude-mem save      # PostToolUse hook
-claude-mem summary   # Stop hook
-```
-
-All commands read JSON input from stdin and execute the corresponding hook function.
-
-### 5. Testing
-Created comprehensive test suite ([test-phase1.ts](test-phase1.ts)) that validates:
-
-- ✅ Database schema migration 004 applied correctly
-- ✅ All four tables exist
-- ✅ SDK session creation and retrieval
-- ✅ Observation queue operations
-- ✅ Observation and summary storage
-- ✅ Session status transitions
-
-**All tests pass! 🎉**
-
-## What's Left for Phase 2
-
-The foundation is complete. Next steps:
-
-1. **SDK Worker Process** - Implement the background agent that:
-   - Polls observation queue
-   - Sends observations to Claude SDK
-   - Parses XML responses (`<observation>` and `<summary>` blocks)
-   - Stores results in database
-
-2. **SDK Prompts** - Implement the three prompt builders:
-   - `buildInitPrompt()` - Initialize SDK agent
-   - `buildObservationPrompt()` - Send tool observation
-   - `buildFinalizePrompt()` - Request session summary
-
-3. **Process Management** - Update [src/hooks/new.ts](src/hooks/new.ts:35-42) to spawn SDK worker as detached process
-
-4. **End-to-End Testing** - Test with real Claude Code session
-
-## File Changes
-
-### New Files
-- [src/services/sqlite/HooksDatabase.ts](src/services/sqlite/HooksDatabase.ts) - Shared database layer
-- [src/hooks/context.ts](src/hooks/context.ts) - SessionStart hook
-- [src/hooks/save.ts](src/hooks/save.ts) - PostToolUse hook
-- [src/hooks/new.ts](src/hooks/new.ts) - UserPromptSubmit hook
-- [src/hooks/summary.ts](src/hooks/summary.ts) - Stop hook
-- [src/hooks/index.ts](src/hooks/index.ts) - Exports
-- [test-phase1.ts](test-phase1.ts) - Test suite
-
-### Modified Files
-- [src/services/sqlite/migrations.ts](src/services/sqlite/migrations.ts:205-315) - Added migration 004
-- [src/services/sqlite/index.ts](src/services/sqlite/index.ts:13) - Exported HooksDatabase
-- [src/bin/cli.ts](src/bin/cli.ts:227-274) - Added hook commands
-
-## Verification
-
-To verify Phase 1 implementation:
-
-```bash
-# Build
-bun run build
-
-# Run tests
-bun test-phase1.ts
-
-# Check hook commands exist
-./dist/claude-mem.min.js --help | grep -A 1 'context\|new\|save\|summary'
-```
-
-All should pass without errors.
-
-## Next Steps
-
-Ready to proceed to Phase 2: **SDK Worker Implementation**
-
-The architecture is sound, the database layer is working, and all hook functions are ready to integrate with the SDK worker process.

context/temp/PHASE2-COMPLETE.md

@@ -1,175 +0,0 @@
-# Phase 2 Implementation Complete
-
-## Summary
-
-Phase 2 of the SDK Worker Process has been successfully implemented. This phase adds the background agent architecture that processes tool observations and generates session summaries.
-
-## Implementation Date
-
-October 15, 2025
-
-## Files Created
-
-### 1. SDK Prompts Module
-- **File**: [src/sdk/prompts.ts](src/sdk/prompts.ts)
-- **Purpose**: Generates prompts for the Claude Agent SDK
-- **Functions**:
-  - `buildInitPrompt()` - Initialize the memory agent
-  - `buildObservationPrompt()` - Send tool observations to agent
-  - `buildFinalizePrompt()` - Request session summary
-
-### 2. XML Parser Module
-- **File**: [src/sdk/parser.ts](src/sdk/parser.ts)
-- **Purpose**: Parse XML responses from SDK agent
-- **Functions**:
-  - `parseObservations()` - Extract observation blocks
-  - `parseSummary()` - Extract session summary
-- **Features**:
-  - Validates observation types (decision, bugfix, feature, refactor, discovery)
-  - Validates all required summary fields
-  - Handles file arrays in summaries
-  - No external dependencies (uses regex)
-
-### 3. SDK Worker Process
-- **File**: [src/sdk/worker.ts](src/sdk/worker.ts)
-- **Purpose**: Background agent that processes observations
-- **Features**:
-  - Runs as detached background process
-  - Uses Claude Agent SDK streaming input mode
-  - Polls observation queue every 1 second
-  - Parses and stores observations and summaries
-  - Handles graceful shutdown via FINALIZE message
-  - Automatic error handling and session status updates
-
-### 4. SDK Index Module
-- **File**: [src/sdk/index.ts](src/sdk/index.ts)
-- **Purpose**: Export all SDK module functionality
-
-### 5. Test Suite
-- **File**: [test-phase2.ts](test-phase2.ts)
-- **Coverage**:
-  - SDK prompt generation (3 tests)
-  - XML observation parsing (4 tests)
-  - XML summary parsing (4 tests)
-  - Database integration (3 tests)
-- **Result**: ✅ All 14 tests passing
-
-## Files Modified
-
-### 1. newHook Implementation
-- **File**: [src/hooks/new.ts](src/hooks/new.ts:38-61)
-- **Changes**:
-  - Uncommented SDK worker spawn code
-  - Added worker path resolution (dev vs production)
-  - Spawns worker as detached process with stdio: 'ignore'
-  - Worker receives session DB ID as argument
-
-## Architecture Validation
-
-### SDK Worker Flow
-1. ✅ newHook spawns worker as detached process
-2. ✅ Worker loads session from database
-3. ✅ Worker initializes SDK agent with streaming input
-4. ✅ Worker polls observation queue continuously
-5. ✅ Worker sends observations to SDK agent
-6. ✅ Worker parses XML responses
-7. ✅ Worker stores observations and summaries
-8. ✅ Worker handles FINALIZE message
-9. ✅ Worker updates session status
-
-### Data Flow
-```
-User Prompt → newHook → Create SDK Session → Spawn Worker
-                                                    ↓
-                                            Initialize SDK Agent
-                                                    ↓
-                                        ← Poll Observation Queue
-                                                    ↓
-                                        Send Observations to SDK
-                                                    ↓
-                                        ← Parse XML Response
-                                                    ↓
-                                        Store in Database
-                                                    ↓
-                                        Wait for FINALIZE
-                                                    ↓
-                                        Generate Summary → Exit
-```
-
-## Test Results
-
-```bash
-$ bun test ./test-phase2.ts
-
-✅ SDK Prompts (3 tests)
-  ✅ should build init prompt with all required sections
-  ✅ should build observation prompt with tool details
-  ✅ should build finalize prompt with session context
-
-✅ XML Parser (8 tests)
-  ✅ parseObservations
-    ✅ should parse single observation
-    ✅ should parse multiple observations
-    ✅ should skip observations with invalid types
-    ✅ should handle observations with surrounding text
-  ✅ parseSummary
-    ✅ should parse complete summary with all fields
-    ✅ should handle empty file arrays
-    ✅ should return null if required fields are missing
-    ✅ should return null if no summary block found
-
-✅ HooksDatabase Integration (3 tests)
-  ✅ should store and retrieve observations
-  ✅ should store and retrieve summaries
-  ✅ should queue and process observations
-
-14 pass, 0 fail, 53 expect() calls
-Ran 14 tests across 1 file. [60.00ms]
-```
-
-## Build Verification
-
-```bash
-$ npm run build
-
-📌 Version: 3.9.16
-✓ Bun detected
-✓ Cleaned dist directory
-✓ Bundle created
-✓ Shebang added
-✓ Made executable
-✅ Build complete! (344.57 KB)
-```
-
-## Success Criteria
-
-All Phase 2 success criteria have been met:
-
-- [x] SDK worker runs as detached process
-- [x] Worker polls observation queue continuously
-- [x] Worker sends observations to Claude SDK
-- [x] Worker parses `<observation>` and `<summary>` XML correctly
-- [x] Worker stores results in database using HooksDatabase
-- [x] Worker handles FINALIZE message and exits gracefully
-- [x] All tests pass
-- [x] No blocking of main Claude Code session
-
-## Known Limitations
-
-1. **Bundled CLI**: The worker process is currently bundled into the main CLI. For production use, we may want to extract it as a separate executable.
-2. **No logging**: Worker runs with `stdio: 'ignore'` for non-blocking behavior. Consider adding file-based logging for debugging.
-
-## Next Steps
-
-Phase 2 is complete and ready for integration testing with a real Claude Code session. The next phase would involve:
-
-1. Testing the full end-to-end flow with actual tool observations
-2. Implementing the `saveHook` to queue observations
-3. Implementing the `summaryHook` to send FINALIZE message
-4. Verifying the context hook retrieves summaries correctly
-
-## Related Documentation
-
-- [REFACTOR-PLAN.md](REFACTOR-PLAN.md) - Original refactor plan
-- [PHASE1-COMPLETE.md](PHASE1-COMPLETE.md) - Phase 1 completion
-- [PHASE2-PROMPT.md](PHASE2-PROMPT.md) - Phase 2 implementation requirements

context/temp/PHASE2-PROMPT.md

@@ -1,118 +0,0 @@
-# Phase 2 Implementation Prompt
-
-Use this prompt to start a new chat for Phase 2 implementation:
-
----
-
-## Context
-
-I'm implementing a refactor of the claude-mem memory system based on [REFACTOR-PLAN.md](REFACTOR-PLAN.md).
-
-**Phase 1 is complete** (see [PHASE1-COMPLETE.md](PHASE1-COMPLETE.md)):
-- ✅ Database schema with migration 004
-- ✅ HooksDatabase shared layer
-- ✅ All four hook functions (context, new, save, summary)
-- ✅ CLI integration and tests passing
-
-## Task
-
-Implement **Phase 2: SDK Worker Process**
-
-According to [REFACTOR-PLAN.md](REFACTOR-PLAN.md#2-userpromptsubmit-hook) (lines 296-423), I need to:
-
-1. **Create SDK Worker Process** (`src/sdk/worker.ts`)
-   - Uses Agent SDK streaming input mode
-   - AsyncIterable message generator that:
-     - Yields initial prompt
-     - Polls observation_queue table
-     - Yields observation prompts
-     - Handles FINALIZE message
-   - Parses SDK responses for `<observation>` and `<summary>` XML blocks
-   - Stores results using HooksDatabase methods
-
-2. **Create SDK Prompts** (`src/sdk/prompts.ts`)
-   - `buildInitPrompt()` - Initialize agent (see REFACTOR-PLAN.md:537-595)
-   - `buildObservationPrompt()` - Send tool observation (see REFACTOR-PLAN.md:601-634)
-   - `buildFinalizePrompt()` - Request summary (see REFACTOR-PLAN.md:640-692)
-
-3. **Create XML Parser** (`src/sdk/parser.ts`)
-   - Parse `<observation>` blocks with `<type>` and `<text>`
-   - Parse `<summary>` blocks with 8 required fields
-   - Extract file arrays from `<file>` child elements
-
-4. **Update newHook** ([src/hooks/new.ts](src/hooks/new.ts:35-42))
-   - Uncomment SDK worker spawn code
-   - Pass session ID to worker
-   - Detached process with stdio: 'ignore'
-
-5. **Test End-to-End**
-   - Create test that simulates full lifecycle
-   - Verify observations are queued, processed, and stored
-   - Verify summary generation works
-
-## Key Requirements
-
-From [REFACTOR-PLAN.md](REFACTOR-PLAN.md):
-
-- Use `@anthropic-ai/claude-agent-sdk` query function with streaming input mode
-- Model: `claude-sonnet-4-5`
-- Use `disallowedTools: ['Glob', 'Grep', 'ListMcpResourcesTool', 'WebSearch']`
-- Message generator yields `{ role: "user", content: string }` objects
-- Capture SDK session ID from system init message
-- Poll observation queue every 1 second
-- Use AbortController for graceful cancellation
-- Parse XML with a library (not regex) - suggest fast-xml-parser
-- Store observations and summaries using HooksDatabase methods
-
-## Architecture Reference
-
-The SDK worker is a **synthesis engine** that:
-- Receives tool observations (not raw data)
-- Extracts meaningful insights
-- Stores atomic observations in SQLite
-- Generates structured summaries at session end
-
-See [REFACTOR-PLAN.md](REFACTOR-PLAN.md#visual-overview) (lines 69-119) for the full architecture diagram.
-
-## Files to Create
-
-1. `src/sdk/worker.ts` - Main SDK worker process
-2. `src/sdk/prompts.ts` - Prompt builders
-3. `src/sdk/parser.ts` - XML response parser
-4. `src/sdk/index.ts` - Exports
-5. `test-phase2.ts` - End-to-end tests
-
-## Files to Modify
-
-1. [src/hooks/new.ts](src/hooks/new.ts:35-42) - Spawn worker process
-2. [package.json](package.json) - May need to add fast-xml-parser dependency
-
-## Testing Strategy
-
-1. Unit tests for prompts (verify prompt structure)
-2. Unit tests for parser (verify XML parsing)
-3. Integration test for worker (mock SDK responses)
-4. End-to-end test (simulate full observation → summary flow)
-
-## Success Criteria
-
-- [ ] SDK worker runs as detached process
-- [ ] Worker polls observation queue continuously
-- [ ] Worker sends observations to Claude SDK
-- [ ] Worker parses `<observation>` and `<summary>` XML correctly
-- [ ] Worker stores results in database using HooksDatabase
-- [ ] Worker handles FINALIZE message and exits gracefully
-- [ ] All tests pass
-- [ ] No blocking of main Claude Code session
-
-## Notes
-
-- Keep hooks fast and non-blocking (they already are)
-- SDK worker is fire-and-forget background process
-- Use HooksDatabase methods (already implemented in Phase 1)
-- Follow the exact prompt formats from REFACTOR-PLAN.md
-- Use proper TypeScript types from Agent SDK
-
----
-
-**Start with:** Create the SDK prompts module first, then the parser, then the worker. Test each piece before integrating.

context/temp/PHASE3-COMPLETE.md

@@ -1,271 +0,0 @@
-# Phase 3 Implementation Complete ✅
-
-## Summary
-
-Phase 3 of the claude-mem architecture refactor has been successfully completed. This phase integrated all hook functions with the database layer and validated the complete end-to-end lifecycle through comprehensive testing.
-
-## Implementation Date
-
-October 15, 2025
-
-## What Was Implemented
-
-### 1. Hook Integration Verification
-
-All four hook functions were verified to be working correctly with the database layer:
-
-#### **[contextHook](src/hooks/context.ts)** - SessionStart Hook
-- ✅ Retrieves recent session summaries from database
-- ✅ Formats summaries in markdown for Claude consumption
-- ✅ Handles missing summaries gracefully
-- ✅ Only runs on startup (skips resume)
-- ✅ Fast, non-blocking operation (< 50ms)
-
-#### **[newHook](src/hooks/new.ts)** - UserPromptSubmit Hook
-- ✅ Creates SDK session record in database
-- ✅ Spawns SDK worker as detached background process
-- ✅ Handles duplicate sessions gracefully
-- ✅ Fast, non-blocking operation (< 50ms)
-- ✅ Returns immediately with suppressed output
-
-#### **[saveHook](src/hooks/save.ts)** - PostToolUse Hook
-- ✅ Queues tool observations to database
-- ✅ Filters out low-value tools (TodoWrite, ListMcpResourcesTool)
-- ✅ Handles missing sessions gracefully
-- ✅ Fast, non-blocking operation (< 50ms)
-- ✅ Stores JSON-stringified tool input/output
-
-#### **[summaryHook](src/hooks/summary.ts)** - Stop Hook
-- ✅ Sends FINALIZE message to observation queue
-- ✅ Triggers SDK worker to generate session summary
-- ✅ Handles missing sessions gracefully
-- ✅ Fast, non-blocking operation (< 50ms)
-
-### 2. Comprehensive Test Suite
-
-Created two new comprehensive test files:
-
-#### **[test-phase3-integration.ts](test-phase3-integration.ts)**
-Tests individual hook database integration:
-- ✅ Session management (create, find, update, complete)
-- ✅ Observation queue (queue, retrieve, process, FINALIZE)
-- ✅ Observations storage (store and retrieve)
-- ✅ Summaries (store and retrieve, project isolation)
-- **9 tests, all passing**
-
-#### **[test-phase3-e2e.ts](test-phase3-e2e.ts)**
-Tests complete session lifecycle:
-- ✅ Full lifecycle: new → save → summary → context
-- ✅ Performance requirements (< 50ms per operation)
-- ✅ Interrupted sessions (observations remain in queue)
-- ✅ Multiple concurrent projects (project isolation)
-- **4 tests, all passing**
-
-### 3. Database Integration
-
-All hooks correctly use the [HooksDatabase](src/services/sqlite/HooksDatabase.ts) layer:
-- ✅ Simple, synchronous database operations
-- ✅ Foreign key constraints enforced
-- ✅ Proper session lifecycle management
-- ✅ Atomic operations with WAL mode
-- ✅ No complex logic in hooks (delegated to SDK worker)
-
-### 4. CLI Commands
-
-All four CLI commands verified working:
-- ✅ `claude-mem context` - [src/bin/cli.ts:228-234](src/bin/cli.ts#L228-L234)
-- ✅ `claude-mem new` - [src/bin/cli.ts:237-243](src/bin/cli.ts#L237-L243)
-- ✅ `claude-mem save` - [src/bin/cli.ts:246-252](src/bin/cli.ts#L246-L252)
-- ✅ `claude-mem summary` - [src/bin/cli.ts:255-261](src/bin/cli.ts#L255-L261)
-
-All commands:
-- Read JSON from stdin
-- Execute corresponding hook function
-- Return proper JSON response
-- Exit with code 0
-
-## Test Results
-
-### All Tests Passing
-```bash
-Phase 1: ✅ Database schema and HooksDatabase tests
-Phase 2: ✅ 14 tests (SDK prompts, parser, database integration)
-Phase 3: ✅ 13 tests (9 integration + 4 e2e)
-Total:   ✅ 27+ tests passing
-```
-
-### Performance Validation
-```
-Average operation time: 0.04ms (well under 50ms requirement)
-Maximum operation time: 1.60ms (well under 100ms threshold)
-```
-
-### Build Verification
-```bash
-✅ Build complete! (344.57 KB)
-   Output: dist/claude-mem.min.js
-```
-
-## Architecture Validation
-
-### ✅ Complete Hook Lifecycle
-
-```
-1. SessionStart (contextHook)
-   ↓ Retrieves recent summaries from database
-   ↓ Formats for Claude consumption
-   ↓
-2. UserPromptSubmit (newHook)
-   ↓ Creates SDK session
-   ↓ Spawns background SDK worker
-   ↓
-3. PostToolUse (saveHook)
-   ↓ Queues observations
-   ↓ SDK worker polls queue
-   ↓ SDK processes observations
-   ↓ SDK stores meaningful insights
-   ↓
-4. Stop (summaryHook)
-   ↓ Sends FINALIZE message
-   ↓ SDK generates structured summary
-   ↓ SDK stores summary in database
-   ↓
-5. Next SessionStart
-   ↓ New context retrieved
-   ⟲ Cycle repeats
-```
-
-### ✅ Non-Blocking Requirements
-
-All hooks meet the < 50ms performance requirement:
-- **contextHook**: Retrieves summaries (simple SELECT query)
-- **newHook**: Creates session + spawns detached process
-- **saveHook**: Inserts into queue (simple INSERT)
-- **summaryHook**: Inserts FINALIZE message (simple INSERT)
-
-SDK worker runs in background independently of main session.
-
-### ✅ Error Handling
-
-All hooks handle errors gracefully:
-- Database errors → log + continue
-- Missing sessions → silently continue
-- Process spawn failures → log + continue
-- Never block Claude Code session
-
-### ✅ Data Integrity
-
-Foreign key constraints enforce referential integrity:
-- Observations reference SDK sessions
-- Summaries reference SDK sessions
-- Queue items reference SDK sessions
-- Sessions reference Claude sessions
-
-## Success Criteria Met
-
-All Phase 3 success criteria have been achieved:
-
-- [x] saveHook queues observations to database
-- [x] summaryHook sends FINALIZE message
-- [x] contextHook retrieves and formats summaries
-- [x] End-to-end test passes (full lifecycle)
-- [x] All hooks respond in < 50ms
-- [x] Worker processes observations and generates summary
-- [x] CLI commands work correctly
-- [x] All tests pass (27+ tests)
-- [x] Build succeeds (344.57 KB)
-- [x] Database foreign key constraints enforced
-- [x] Multiple concurrent projects supported
-- [x] Interrupted sessions handled gracefully
-
-## Files Modified
-
-### Hook Implementations (Already Complete)
-- [src/hooks/context.ts](src/hooks/context.ts) - SessionStart hook
-- [src/hooks/save.ts](src/hooks/save.ts) - PostToolUse hook
-- [src/hooks/new.ts](src/hooks/new.ts) - UserPromptSubmit hook
-- [src/hooks/summary.ts](src/hooks/summary.ts) - Stop hook
-
-### Test Files Created
-- [test-phase3-integration.ts](test-phase3-integration.ts) - Hook database integration tests
-- [test-phase3-e2e.ts](test-phase3-e2e.ts) - End-to-end lifecycle tests
-
-### CLI Integration (Already Complete)
-- [src/bin/cli.ts](src/bin/cli.ts) - CLI commands for all hooks
-
-## Install Flow Updates
-
-### ✅ CLI-Based Hook Architecture
-
-Updated the install flow to use the new CLI-based architecture:
-
-**Before (Old Architecture):**
-- Installed hook template files (`session-start.js`, etc.)
-- Copied shared helper modules
-- Configured settings.json to point to hook files
-
-**After (New Architecture):**
-- Hooks are CLI commands: `claude-mem context`, `claude-mem new`, `claude-mem save`, `claude-mem summary`
-- Settings.json configured directly with CLI commands
-- No separate hook files needed
-- Simpler installation and maintenance
-
-**Updated Install Steps:**
-```javascript
-settings.hooks.SessionStart = [{ type: "command", command: "claude-mem context", timeout: 180 }]
-settings.hooks.Stop = [{ type: "command", command: "claude-mem summary", timeout: 60 }]
-settings.hooks.UserPromptSubmit = [{ type: "command", command: "claude-mem new", timeout: 60 }]
-settings.hooks.PostToolUse = [{ type: "command", command: "claude-mem save", timeout: 180, matcher: "*" }]
-```
-
-**Benefits:**
-- ✅ Single source of truth (CLI implementation)
-- ✅ No hook file synchronization issues
-- ✅ Easier debugging (just test CLI commands)
-- ✅ Simpler installation process
-- ✅ Better maintainability
-
-## Related Documentation
-
-- [REFACTOR-PLAN.md](REFACTOR-PLAN.md) - Complete architecture plan
-- [PHASE1-COMPLETE.md](PHASE1-COMPLETE.md) - Database & HooksDatabase layer
-- [PHASE2-COMPLETE.md](PHASE2-COMPLETE.md) - SDK worker process
-- **PHASE3-COMPLETE.md** (this document) - Hook integration & testing
-
-## Next Steps
-
-Phase 3 is complete! The claude-mem system is now ready for real-world testing with actual Claude Code sessions.
-
-### Recommended Next Actions
-
-1. **Manual Testing**
-   - Configure hooks in `~/.config/claude-code/settings.json`
-   - Run a real Claude Code session
-   - Verify observations are queued
-   - Verify summaries are generated
-   - Verify context is injected on next session
-
-2. **Monitoring & Debugging**
-   - Add file-based logging to SDK worker
-   - Monitor `~/.claude-mem/claude-mem.db` for data
-   - Check observation queue processing
-   - Verify summary generation
-
-3. **Future Enhancements**
-   - Extract SDK worker as separate executable (not bundled)
-   - Add resumption support for interrupted SDK sessions
-   - Implement retry logic for failed observations
-   - Add telemetry and error reporting
-   - Optimize database queries with additional indexes
-
-## Conclusion
-
-Phase 3 successfully completes the claude-mem architecture refactor. All three phases are now complete:
-
-- ✅ **Phase 1**: Database schema and shared layer
-- ✅ **Phase 2**: SDK worker process and prompts
-- ✅ **Phase 3**: Hook integration and end-to-end testing
-
-The system is architecturally sound, fully tested, and ready for production use!
-
-🎉 **Refactor Complete!** 🎉

docs/architecture/database.mdx

@@ -0,0 +1,309 @@
+---
+title: "Database Architecture"
+description: "SQLite schema, FTS5 search, and data storage"
+---
+
+# Database Architecture
+
+Claude-Mem uses SQLite 3 with the better-sqlite3 native module for persistent storage and FTS5 for full-text search.
+
+## Database Location
+
+- **Current**: `~/.claude-mem/claude-mem.db`
+
+**Note**: Despite the README claiming v4.0.0+ moved the database to `${CLAUDE_PLUGIN_ROOT}/data/`, the actual implementation still uses `~/.claude-mem/`.
+
+## Database Implementation
+
+**Primary Implementation**: better-sqlite3 (native SQLite module)
+- Used by: SessionStore and SessionSearch
+- Format: Synchronous API with better performance
+- **Note**: Database.ts (using bun:sqlite) is legacy code
+
+## Core Tables
+
+### 1. sdk_sessions
+
+Tracks active and completed sessions.
+
+```sql
+CREATE TABLE sdk_sessions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  sdk_session_id TEXT UNIQUE NOT NULL,
+  claude_session_id TEXT,
+  project TEXT NOT NULL,
+  prompt_counter INTEGER DEFAULT 0,
+  status TEXT NOT NULL DEFAULT 'active',
+  created_at TEXT NOT NULL,
+  created_at_epoch INTEGER NOT NULL,
+  completed_at TEXT,
+  completed_at_epoch INTEGER,
+  last_activity_at TEXT,
+  last_activity_epoch INTEGER
+);
+```
+
+**Indexes**:
+- `idx_sdk_sessions_claude_session` on `claude_session_id`
+- `idx_sdk_sessions_project` on `project`
+- `idx_sdk_sessions_status` on `status`
+- `idx_sdk_sessions_created_at` on `created_at_epoch DESC`
+
+### 2. observations
+
+Individual tool executions with hierarchical structure.
+
+```sql
+CREATE TABLE observations (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL,
+  sdk_session_id TEXT NOT NULL,
+  claude_session_id TEXT,
+  project TEXT NOT NULL,
+  prompt_number INTEGER,
+  tool_name TEXT NOT NULL,
+  correlation_id TEXT,
+
+  -- Hierarchical fields
+  title TEXT,
+  subtitle TEXT,
+  narrative TEXT,
+  text TEXT,
+  facts TEXT,
+  concepts TEXT,
+  type TEXT,
+  files_read TEXT,
+  files_modified TEXT,
+
+  created_at TEXT NOT NULL,
+  created_at_epoch INTEGER NOT NULL,
+
+  FOREIGN KEY (sdk_session_id) REFERENCES sdk_sessions(sdk_session_id)
+);
+```
+
+**Observation Types**:
+- `decision` - Architectural or design decisions
+- `bugfix` - Bug fixes and corrections
+- `feature` - New features or capabilities
+- `refactor` - Code refactoring and cleanup
+- `discovery` - Learnings about the codebase
+- `change` - General changes and modifications
+
+**Indexes**:
+- `idx_observations_session` on `session_id`
+- `idx_observations_sdk_session` on `sdk_session_id`
+- `idx_observations_project` on `project`
+- `idx_observations_tool_name` on `tool_name`
+- `idx_observations_created_at` on `created_at_epoch DESC`
+- `idx_observations_type` on `type`
+
+### 3. session_summaries
+
+AI-generated session summaries (multiple per session).
+
+```sql
+CREATE TABLE session_summaries (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  sdk_session_id TEXT NOT NULL,
+  claude_session_id TEXT,
+  project TEXT NOT NULL,
+  prompt_number INTEGER,
+
+  -- Summary fields
+  request TEXT,
+  investigated TEXT,
+  learned TEXT,
+  completed TEXT,
+  next_steps TEXT,
+  notes TEXT,
+
+  created_at TEXT NOT NULL,
+  created_at_epoch INTEGER NOT NULL,
+
+  FOREIGN KEY (sdk_session_id) REFERENCES sdk_sessions(sdk_session_id)
+);
+```
+
+**Indexes**:
+- `idx_session_summaries_sdk_session` on `sdk_session_id`
+- `idx_session_summaries_project` on `project`
+- `idx_session_summaries_created_at` on `created_at_epoch DESC`
+
+### 4. user_prompts
+
+Raw user prompts with FTS5 search (as of v4.2.0).
+
+```sql
+CREATE TABLE user_prompts (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  sdk_session_id TEXT NOT NULL,
+  claude_session_id TEXT,
+  project TEXT NOT NULL,
+  prompt_number INTEGER,
+  prompt_text TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  created_at_epoch INTEGER NOT NULL,
+
+  FOREIGN KEY (sdk_session_id) REFERENCES sdk_sessions(sdk_session_id)
+);
+```
+
+**Indexes**:
+- `idx_user_prompts_sdk_session` on `sdk_session_id`
+- `idx_user_prompts_project` on `project`
+- `idx_user_prompts_created_at` on `created_at_epoch DESC`
+
+### Legacy Tables
+
+- **sessions**: Legacy session tracking (v3.x)
+- **memories**: Legacy compressed memory chunks (v3.x)
+- **overviews**: Legacy session summaries (v3.x)
+
+## FTS5 Full-Text Search
+
+SQLite FTS5 (Full-Text Search) virtual tables enable fast full-text search across observations, summaries, and user prompts.
+
+### FTS5 Virtual Tables
+
+#### observations_fts
+
+```sql
+CREATE VIRTUAL TABLE observations_fts USING fts5(
+  title,
+  subtitle,
+  narrative,
+  text,
+  facts,
+  concepts,
+  content='observations',
+  content_rowid='id'
+);
+```
+
+#### session_summaries_fts
+
+```sql
+CREATE VIRTUAL TABLE session_summaries_fts USING fts5(
+  request,
+  investigated,
+  learned,
+  completed,
+  next_steps,
+  notes,
+  content='session_summaries',
+  content_rowid='id'
+);
+```
+
+#### user_prompts_fts
+
+```sql
+CREATE VIRTUAL TABLE user_prompts_fts USING fts5(
+  prompt_text,
+  content='user_prompts',
+  content_rowid='id'
+);
+```
+
+### Automatic Synchronization
+
+FTS5 tables stay in sync via triggers:
+
+```sql
+-- Insert trigger example
+CREATE TRIGGER observations_ai AFTER INSERT ON observations BEGIN
+  INSERT INTO observations_fts(rowid, title, subtitle, narrative, text, facts, concepts)
+  VALUES (new.id, new.title, new.subtitle, new.narrative, new.text, new.facts, new.concepts);
+END;
+
+-- Update trigger example
+CREATE TRIGGER observations_au AFTER UPDATE ON observations BEGIN
+  INSERT INTO observations_fts(observations_fts, rowid, title, subtitle, narrative, text, facts, concepts)
+  VALUES('delete', old.id, old.title, old.subtitle, old.narrative, old.text, old.facts, old.concepts);
+  INSERT INTO observations_fts(rowid, title, subtitle, narrative, text, facts, concepts)
+  VALUES (new.id, new.title, new.subtitle, new.narrative, new.text, new.facts, new.concepts);
+END;
+
+-- Delete trigger example
+CREATE TRIGGER observations_ad AFTER DELETE ON observations BEGIN
+  INSERT INTO observations_fts(observations_fts, rowid, title, subtitle, narrative, text, facts, concepts)
+  VALUES('delete', old.id, old.title, old.subtitle, old.narrative, old.text, old.facts, old.concepts);
+END;
+```
+
+### FTS5 Query Syntax
+
+FTS5 supports rich query syntax:
+
+- **Simple**: `"error handling"`
+- **AND**: `"error" AND "handling"`
+- **OR**: `"bug" OR "fix"`
+- **NOT**: `"bug" NOT "feature"`
+- **Phrase**: `"'exact phrase'"`
+- **Column**: `title:"authentication"`
+
+### Security
+
+As of v4.2.3, all FTS5 queries are properly escaped to prevent SQL injection:
+- Double quotes are escaped: `query.replace(/"/g, '""')`
+- Comprehensive test suite with 332 injection attack tests
+
+## Database Classes
+
+### SessionStore
+
+CRUD operations for sessions, observations, summaries, and user prompts.
+
+**Location**: `src/services/sqlite/SessionStore.ts`
+
+**Methods**:
+- `createSession()`
+- `getSession()`
+- `updateSession()`
+- `createObservation()`
+- `getObservations()`
+- `createSummary()`
+- `getSummaries()`
+- `createUserPrompt()`
+
+### SessionSearch
+
+FTS5 full-text search with 8 specialized search methods.
+
+**Location**: `src/services/sqlite/SessionSearch.ts`
+
+**Methods**:
+- `searchObservations()` - Full-text search across observations
+- `searchSessions()` - Full-text search across summaries
+- `searchUserPrompts()` - Full-text search across user prompts
+- `findByConcept()` - Find by concept tags
+- `findByFile()` - Find by file references
+- `findByType()` - Find by observation type
+- `getRecentContext()` - Get recent session context
+- `advancedSearch()` - Combined filters
+
+## Migrations
+
+Database schema is managed via migrations in `src/services/sqlite/migrations.ts`.
+
+**Migration History**:
+- Migration 001: Initial schema (sessions, memories, overviews, diagnostics, transcript_events)
+- Migration 002: Hierarchical memory fields (title, subtitle, facts, concepts, files_touched)
+- Migration 003: SDK sessions and observations
+- Migration 004: Session summaries
+- Migration 005: Multi-prompt sessions (prompt_counter, prompt_number)
+- Migration 006: FTS5 virtual tables and triggers
+- Migration 007-010: Various improvements and user prompts table
+
+## Performance Considerations
+
+- **Indexes**: All foreign keys and frequently queried columns are indexed
+- **FTS5**: Full-text search is significantly faster than LIKE queries
+- **Triggers**: Automatic synchronization has minimal overhead
+- **Connection Pooling**: better-sqlite3 reuses connections efficiently
+- **Synchronous API**: better-sqlite3 uses synchronous API for better performance
+
+## Troubleshooting
+
+See [Troubleshooting - Database Issues](../troubleshooting.md#database-issues) for common problems and solutions.

docs/architecture/hooks.mdx

@@ -0,0 +1,201 @@
+---
+title: "Plugin Hooks"
+description: "5 lifecycle hooks that power Claude-Mem"
+---
+
+# Plugin Hooks
+
+Claude-Mem integrates with Claude Code through 5 lifecycle hooks that capture events and inject context.
+
+## Hook Overview
+
+| Hook Name           | Purpose                              | Timeout | Script                  |
+|---------------------|--------------------------------------|---------|-------------------------|
+| SessionStart        | Inject context from previous sessions| 120s    | context-hook.js         |
+| UserPromptSubmit    | Create/track new sessions            | 120s    | new-hook.js             |
+| PostToolUse         | Capture tool execution observations  | 120s    | save-hook.js            |
+| Stop                | Generate session summaries           | 120s    | summary-hook.js         |
+| SessionEnd          | Mark sessions complete               | 120s    | cleanup-hook.js         |
+
+## Hook Configuration
+
+Hooks are configured in `plugin/hooks/hooks.json`:
+
+```json
+{
+  "description": "Claude-mem memory system hooks",
+  "hooks": {
+    "SessionStart": [{
+      "hooks": [{
+        "type": "command",
+        "command": "cd \"${CLAUDE_PLUGIN_ROOT}/..\" && npm install --prefer-offline --no-audit --no-fund --loglevel=error && node ${CLAUDE_PLUGIN_ROOT}/scripts/context-hook.js",
+        "timeout": 120
+      }]
+    }],
+    "UserPromptSubmit": [{
+      "hooks": [{
+        "type": "command",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/new-hook.js",
+        "timeout": 120
+      }]
+    }],
+    "PostToolUse": [{
+      "matcher": "*",
+      "hooks": [{
+        "type": "command",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/save-hook.js",
+        "timeout": 120
+      }]
+    }],
+    "Stop": [{
+      "hooks": [{
+        "type": "command",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/summary-hook.js",
+        "timeout": 120
+      }]
+    }],
+    "SessionEnd": [{
+      "hooks": [{
+        "type": "command",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/cleanup-hook.js",
+        "timeout": 120
+      }]
+    }]
+  }
+}
+```
+
+## 1. SessionStart Hook (`context-hook.js`)
+
+**Purpose**: Inject context from previous sessions into Claude's initial context.
+
+**Behavior**:
+- Ensures dependencies are installed (runs fast idempotent npm install)
+- Auto-starts PM2 worker service if not running
+- Retrieves last 10 session summaries with three-tier verbosity (v4.2.0)
+- Returns context via `hookSpecificOutput` in JSON format (fixed in v4.1.0)
+
+**Input** (via stdin):
+```json
+{
+  "session_id": "claude-session-123",
+  "cwd": "/path/to/project",
+  "source": "startup"
+}
+```
+
+**Output** (via stdout):
+```json
+{
+  "hookSpecificOutput": "# Recent Sessions\n\n## Session 1...\n"
+}
+```
+
+**Implementation**: `src/hooks/context.ts` and `src/bin/hooks/context-hook.ts`
+
+## 2. UserPromptSubmit Hook (`new-hook.js`)
+
+**Purpose**: Create new session records and initialize session tracking.
+
+**Behavior**:
+- Creates new session in database
+- Initializes session tracking
+- Saves raw user prompts for full-text search (as of v4.2.0)
+- Sends init signal to worker service
+
+**Input** (via stdin):
+```json
+{
+  "session_id": "claude-session-123",
+  "cwd": "/path/to/project",
+  "prompt": "User's actual prompt text"
+}
+```
+
+**Implementation**: `src/hooks/new.ts` and `src/bin/hooks/new-hook.ts`
+
+## 3. PostToolUse Hook (`save-hook.js`)
+
+**Purpose**: Capture tool execution observations.
+
+**Behavior**:
+- Fires after EVERY tool execution (Read, Write, Edit, Bash, etc.)
+- Sends observations to worker service for processing
+- Includes correlation IDs for tracing
+- Filters low-value observations
+
+**Input** (via stdin):
+```json
+{
+  "session_id": "claude-session-123",
+  "cwd": "/path/to/project",
+  "tool_name": "Read",
+  "tool_input": {...},
+  "tool_result": "...",
+  "correlation_id": "abc-123"
+}
+```
+
+**Implementation**: `src/hooks/save.ts` and `src/bin/hooks/save-hook.ts`
+
+## 4. Stop Hook (`summary-hook.js`)
+
+**Purpose**: Generate session summaries when Claude stops.
+
+**Behavior**:
+- Triggers final summary generation
+- Sends summarize request to worker service
+- Summary includes: request, completed, learned, next_steps
+
+**Input** (via stdin):
+```json
+{
+  "session_id": "claude-session-123",
+  "cwd": "/path/to/project",
+  "source": "user_stop"
+}
+```
+
+**Implementation**: `src/hooks/summary.ts` and `src/bin/hooks/summary-hook.ts`
+
+## 5. SessionEnd Hook (`cleanup-hook.js`)
+
+**Purpose**: Mark sessions as completed (graceful cleanup as of v4.1.0).
+
+**Behavior**:
+- Marks sessions as completed
+- Skips cleanup on `/clear` commands to preserve ongoing sessions
+- Allows workers to finish pending operations naturally
+- Previously sent DELETE requests; now uses graceful completion
+
+**Input** (via stdin):
+```json
+{
+  "session_id": "claude-session-123",
+  "cwd": "/path/to/project",
+  "source": "normal"
+}
+```
+
+**Implementation**: `src/hooks/cleanup.ts` and `src/bin/hooks/cleanup-hook.ts`
+
+## Hook Development
+
+### Adding a New Hook
+
+1. Create hook implementation in `src/hooks/your-hook.ts`
+2. Create entry point in `src/bin/hooks/your-hook.ts`
+3. Add to `plugin/hooks/hooks.json`
+4. Rebuild with `npm run build`
+
+### Hook Best Practices
+
+- **Fast execution**: Hooks should complete quickly (< 1s ideal)
+- **Graceful degradation**: Don't block Claude if worker is down
+- **Structured logging**: Use logger for debugging
+- **Error handling**: Catch and log errors, don't crash
+- **JSON output**: Use `hookSpecificOutput` for context injection
+
+## Troubleshooting
+
+See [Troubleshooting - Hook Issues](../troubleshooting.md#hook-issues) for common problems and solutions.

docs/architecture/mcp-search.mdx

@@ -0,0 +1,313 @@
+---
+title: "MCP Search Server"
+description: "7 search tools with examples and usage patterns"
+---
+
+# MCP Search Server
+
+Claude-Mem includes a Model Context Protocol (MCP) server that exposes 7 specialized search tools for querying stored observations and sessions.
+
+## Overview
+
+- **Location**: `src/servers/search-server.ts`
+- **Configuration**: `plugin/.mcp.json`
+- **Transport**: stdio
+- **Tools**: 7 specialized search functions
+- **Citations**: All results use `claude-mem://` URI scheme
+
+## Configuration
+
+The MCP server is automatically registered via `plugin/.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "claude-mem-search": {
+      "type": "stdio",
+      "command": "${CLAUDE_PLUGIN_ROOT}/scripts/search-server.js"
+    }
+  }
+}
+```
+
+This registers the `claude-mem-search` server with Claude Code, making the 7 search tools available in all sessions. The server is automatically started when Claude Code launches and communicates via stdio transport.
+
+## Search Tools
+
+### 1. search_observations
+
+Full-text search across observation titles, narratives, facts, and concepts.
+
+**Parameters**:
+- `query` (required): Search query for FTS5 full-text search
+- `type`: Filter by observation type(s) (decision, bugfix, feature, refactor, discovery, change)
+- `concepts`: Filter by concept tags
+- `files`: Filter by file paths (partial match)
+- `project`: Filter by project name
+- `dateRange`: Filter by date range (`{start, end}`)
+- `orderBy`: Sort order (relevance, date_desc, date_asc)
+- `limit`: Maximum results (default: 20, max: 100)
+- `offset`: Number of results to skip
+- `format`: Output format ("index" for titles/dates only, "full" for complete details)
+
+**Example**:
+```
+search_observations with query="build system" and type="decision"
+```
+
+### 2. search_sessions
+
+Full-text search across session summaries, requests, and learnings.
+
+**Parameters**:
+- `query` (required): Search query for FTS5 full-text search
+- `project`: Filter by project name
+- `dateRange`: Filter by date range
+- `orderBy`: Sort order (relevance, date_desc, date_asc)
+- `limit`: Maximum results (default: 20, max: 100)
+- `offset`: Number of results to skip
+- `format`: Output format ("index" or "full")
+
+**Example**:
+```
+search_sessions with query="hooks implementation"
+```
+
+### 3. search_user_prompts
+
+Search raw user prompts with full-text search. Use this to find what the user actually said/requested across all sessions.
+
+**Parameters**:
+- `query` (required): Search query for FTS5 full-text search
+- `project`: Filter by project name
+- `dateRange`: Filter by date range
+- `orderBy`: Sort order (relevance, date_desc, date_asc)
+- `limit`: Maximum results (default: 20, max: 100)
+- `offset`: Number of results to skip
+- `format`: Output format ("index" for truncated prompts/dates, "full" for complete prompt text)
+
+**Example**:
+```
+search_user_prompts with query="authentication feature"
+```
+
+**Benefits**:
+- Full context reconstruction from user intent → Claude actions → outcomes
+- Pattern detection for repeated requests
+- Improved debugging by tracing from original user words to final implementation
+
+### 4. find_by_concept
+
+Find observations tagged with specific concepts.
+
+**Parameters**:
+- `concept` (required): Concept tag to search for
+- `project`: Filter by project name
+- `dateRange`: Filter by date range
+- `orderBy`: Sort order (relevance, date_desc, date_asc)
+- `limit`: Maximum results (default: 20, max: 100)
+- `offset`: Number of results to skip
+- `format`: Output format ("index" or "full")
+
+**Example**:
+```
+find_by_concept with concept="architecture"
+```
+
+### 5. find_by_file
+
+Find observations and sessions that reference specific file paths.
+
+**Parameters**:
+- `filePath` (required): File path to search for (supports partial matching)
+- `project`: Filter by project name
+- `dateRange`: Filter by date range
+- `orderBy`: Sort order (relevance, date_desc, date_asc)
+- `limit`: Maximum results (default: 20, max: 100)
+- `offset`: Number of results to skip
+- `format`: Output format ("index" or "full")
+
+**Example**:
+```
+find_by_file with filePath="worker-service.ts"
+```
+
+### 6. find_by_type
+
+Find observations by type (decision, bugfix, feature, refactor, discovery, change).
+
+**Parameters**:
+- `type` (required): Observation type(s) to filter by (single type or array)
+- `project`: Filter by project name
+- `dateRange`: Filter by date range
+- `orderBy`: Sort order (relevance, date_desc, date_asc)
+- `limit`: Maximum results (default: 20, max: 100)
+- `offset`: Number of results to skip
+- `format`: Output format ("index" or "full")
+
+**Example**:
+```
+find_by_type with type=["decision", "feature"]
+```
+
+### 7. get_recent_context
+
+Get recent session context including summaries and observations for a project.
+
+**Parameters**:
+- `project`: Project name (defaults to current working directory basename)
+- `limit`: Number of recent sessions to retrieve (default: 3, max: 10)
+
+**Example**:
+```
+get_recent_context with limit=5
+```
+
+## Output Formats
+
+All search tools support two output formats:
+
+### Index Format (Default)
+
+Returns titles, dates, and source URIs only. Uses ~10x fewer tokens than full format.
+
+**Always use index format first** to get an overview and identify relevant results.
+
+**Example Output**:
+```
+1. [decision] Implement graceful session cleanup
+   Date: 2025-10-21 14:23:45
+   Source: claude-mem://observation/123
+
+2. [feature] Add FTS5 full-text search
+   Date: 2025-10-21 13:15:22
+   Source: claude-mem://observation/124
+```
+
+### Full Format
+
+Returns complete observation/summary details including narrative, facts, concepts, files, etc.
+
+**Only use after reviewing index results** to dive deep into specific items of interest.
+
+## Search Strategy
+
+**Recommended Workflow**:
+
+1. **Initial search**: Use default (index) format to see titles, dates, and sources
+2. **Review results**: Identify which items are most relevant to your needs
+3. **Deep dive**: Only then use `format: "full"` on specific items of interest
+4. **Narrow down**: Use filters (type, dateRange, concepts, files) to refine results
+
+**Token Efficiency**:
+- Index format: ~50-100 tokens per result
+- Full format: ~500-1000 tokens per result
+- Start with 3-5 results to avoid MCP token limits
+
+## Citations
+
+All search results use the `claude-mem://` URI scheme for citations:
+
+- `claude-mem://observation/{id}` - References specific observations
+- `claude-mem://session/{id}` - References specific sessions
+- `claude-mem://user-prompt/{id}` - References specific user prompts
+
+These citations allow Claude to reference specific historical context in responses.
+
+## FTS5 Query Syntax
+
+The `query` parameter supports SQLite FTS5 full-text search syntax:
+
+- **Simple**: `"error handling"`
+- **AND**: `"error" AND "handling"`
+- **OR**: `"bug" OR "fix"`
+- **NOT**: `"bug" NOT "feature"`
+- **Phrase**: `"'exact phrase'"`
+- **Column**: `title:"authentication"`
+
+## Security
+
+As of v4.2.3, all FTS5 queries are properly escaped to prevent SQL injection attacks:
+- Double quotes are escaped: `query.replace(/"/g, '""')`
+- Comprehensive test suite with 332 injection attack tests
+- Affects: `search_observations`, `search_sessions`, `search_user_prompts`
+
+## Example Queries
+
+```
+# Find all decisions about build system
+search_observations with query="build system" and type="decision"
+
+# Show everything related to worker-service.ts
+find_by_file with filePath="worker-service.ts"
+
+# Search what we learned about hooks
+search_sessions with query="hooks"
+
+# Show observations tagged with 'architecture'
+find_by_concept with concept="architecture"
+
+# Find what user asked about authentication
+search_user_prompts with query="authentication"
+
+# Get recent context for debugging
+get_recent_context with limit=5
+```
+
+## Implementation
+
+The MCP search server is implemented using:
+- `@modelcontextprotocol/sdk` (v1.20.1)
+- `SessionSearch` service for FTS5 queries
+- `SessionStore` for database access
+- `zod-to-json-schema` for parameter validation
+
+**Source Code**: `src/servers/search-server.ts`
+
+## Troubleshooting
+
+### Tool Not Available
+
+If search tools are not available in Claude Code sessions:
+
+1. Check MCP configuration:
+   ```bash
+   cat plugin/.mcp.json
+   ```
+
+2. Verify search server is built:
+   ```bash
+   ls -l plugin/scripts/search-server.js
+   ```
+
+3. Rebuild if needed:
+   ```bash
+   npm run build
+   ```
+
+### Search Returns No Results
+
+1. Check database has data:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
+   ```
+
+2. Verify FTS5 tables exist:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT name FROM sqlite_master WHERE type='table' AND name LIKE '%_fts';"
+   ```
+
+3. Test query syntax:
+   ```bash
+   # Simple query should work
+   search_observations with query="test"
+   ```
+
+### Token Limit Errors
+
+If you hit MCP token limits:
+
+1. Use `format: "index"` instead of `format: "full"`
+2. Reduce `limit` parameter (try 3-5 instead of 20)
+3. Use more specific filters to narrow results
+4. Use `offset` to paginate through results

docs/architecture/overview.mdx

@@ -0,0 +1,165 @@
+---
+title: "Architecture Overview"
+description: "System components and data flow in Claude-Mem"
+---
+
+# Architecture Overview
+
+## System Components
+
+Claude-Mem operates as a Claude Code plugin with four core components:
+
+1. **Plugin Hooks** - Capture lifecycle events
+2. **Worker Service** - Process observations via Claude Agent SDK
+3. **Database Layer** - Store sessions and observations (SQLite + FTS5)
+4. **MCP Search Server** - Query historical context
+
+## Technology Stack
+
+| Layer                  | Technology                                |
+|------------------------|-------------------------------------------|
+| **Language**           | TypeScript (ES2022, ESNext modules)       |
+| **Runtime**            | Node.js 18+                               |
+| **Database**           | SQLite 3 with better-sqlite3 driver       |
+| **HTTP Server**        | Express.js 4.18                           |
+| **AI SDK**             | @anthropic-ai/claude-agent-sdk            |
+| **Build Tool**         | esbuild (bundles TypeScript)              |
+| **Process Manager**    | PM2                                       |
+| **Testing**            | Node.js built-in test runner              |
+
+## Data Flow
+
+### Memory Pipeline
+```
+Hook (stdin) → Database → Worker Service → SDK Processor → Database → Next Session Hook
+```
+
+1. **Input**: Claude Code sends tool execution data via stdin to hooks
+2. **Storage**: Hooks write observations to SQLite database
+3. **Processing**: Worker service reads observations, processes via SDK
+4. **Output**: Processed summaries written back to database
+5. **Retrieval**: Next session's context hook reads summaries from database
+
+### Search Pipeline
+```
+Claude Request → MCP Server → SessionSearch Service → FTS5 Database → Search Results → Claude
+```
+
+1. **Query**: Claude uses MCP search tools (e.g., `search_observations`)
+2. **Search**: MCP server calls SessionSearch service with query parameters
+3. **FTS5**: Full-text search executes against FTS5 virtual tables
+4. **Format**: Results formatted as `search_result` blocks with citations
+5. **Return**: Claude receives citable search results for analysis
+
+## Session Lifecycle
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ 1. Session Starts → Context Hook Fires                          │
+│    Injects summaries from last 3 sessions into Claude's context │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│ 2. User Types Prompt → UserPromptSubmit Hook Fires              │
+│    Creates SDK session in database, notifies worker service     │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│ 3. Claude Uses Tools → PostToolUse Hook Fires (100+ times)      │
+│    Sends observations to worker service for processing          │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│ 4. Worker Processes → Claude Agent SDK Analyzes                 │
+│    Extracts structured learnings via iterative AI processing    │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│ 5. Claude Stops → Stop Hook Fires                               │
+│    Generates final summary with request, status, next steps     │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│ 6. Session Ends → Cleanup Hook Fires                            │
+│    Marks session complete, ready for next session context       │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Directory Structure
+
+```
+claude-mem/
+├── src/
+│   ├── bin/hooks/              # Entry point scripts for 5 hooks
+│   │   ├── context-hook.ts     # SessionStart
+│   │   ├── new-hook.ts         # UserPromptSubmit
+│   │   ├── save-hook.ts        # PostToolUse
+│   │   ├── summary-hook.ts     # Stop
+│   │   └── cleanup-hook.ts     # SessionEnd
+│   │
+│   ├── hooks/                  # Hook implementation logic
+│   │   ├── context.ts
+│   │   ├── new.ts
+│   │   ├── save.ts
+│   │   ├── summary.ts
+│   │   └── cleanup.ts
+│   │
+│   ├── servers/                # MCP servers
+│   │   └── search-server.ts    # MCP search tools server
+│   │
+│   ├── sdk/                    # Claude Agent SDK integration
+│   │   ├── prompts.ts          # XML prompt builders
+│   │   ├── parser.ts           # XML response parser
+│   │   └── worker.ts           # Main SDK agent loop
+│   │
+│   ├── services/
+│   │   ├── worker-service.ts   # Express HTTP service
+│   │   └── sqlite/             # Database layer
+│   │       ├── SessionStore.ts # CRUD operations
+│   │       ├── SessionSearch.ts # FTS5 search service
+│   │       ├── migrations.ts
+│   │       └── types.ts
+│   │
+│   ├── shared/                 # Shared utilities
+│   │   ├── config.ts
+│   │   ├── paths.ts
+│   │   └── storage.ts
+│   │
+│   └── utils/
+│       ├── logger.ts
+│       ├── platform.ts
+│       └── port-allocator.ts
+│
+├── plugin/                     # Plugin distribution
+│   ├── .claude-plugin/
+│   │   └── plugin.json
+│   ├── .mcp.json               # MCP server configuration
+│   ├── hooks/
+│   │   └── hooks.json
+│   └── scripts/                # Built executables
+│       ├── context-hook.js
+│       ├── new-hook.js
+│       ├── save-hook.js
+│       ├── summary-hook.js
+│       ├── cleanup-hook.js
+│       ├── worker-service.cjs  # Background worker
+│       └── search-server.js    # MCP search server
+│
+├── tests/                      # Test suite
+├── docs/                       # Documentation
+└── ecosystem.config.cjs        # PM2 configuration
+```
+
+## Component Details
+
+### 1. Plugin Hooks
+See [Plugin Hooks](/architecture/hooks) for detailed hook documentation.
+
+### 2. Worker Service
+See [Worker Service](/architecture/worker-service) for HTTP API and endpoints.
+
+### 3. Database Layer
+See [Database Architecture](/architecture/database) for schema and FTS5 search.
+
+### 4. MCP Search Server
+See [MCP Search Server](/architecture/mcp-search) for search tools and examples.

docs/architecture/worker-service.mdx

@@ -0,0 +1,248 @@
+---
+title: "Worker Service"
+description: "HTTP API and PM2 process management"
+---
+
+# Worker Service
+
+The worker service is a long-running HTTP API built with Express.js and managed by PM2. It processes observations through the Claude Agent SDK separately from hook execution to prevent timeout issues.
+
+## Overview
+
+- **Technology**: Express.js HTTP server
+- **Process Manager**: PM2
+- **Port**: Fixed port 37777 (configurable via `CLAUDE_MEM_WORKER_PORT`)
+- **Location**: `src/services/worker-service.ts`
+- **Built Output**: `plugin/scripts/worker-service.cjs`
+- **Model**: Configurable via `CLAUDE_MEM_MODEL` environment variable (default: claude-sonnet-4-5)
+
+## REST API Endpoints
+
+The worker service exposes 6 HTTP endpoints:
+
+### 1. Health Check
+```
+GET /health
+```
+
+**Response**:
+```json
+{
+  "status": "ok",
+  "uptime": 12345,
+  "port": 37777
+}
+```
+
+### 2. Initialize Session
+```
+POST /sessions/:sessionDbId/init
+```
+
+**Request Body**:
+```json
+{
+  "sdk_session_id": "abc-123",
+  "project": "my-project"
+}
+```
+
+**Response**:
+```json
+{
+  "success": true,
+  "session_id": "abc-123"
+}
+```
+
+### 3. Add Observation
+```
+POST /sessions/:sessionDbId/observations
+```
+
+**Request Body**:
+```json
+{
+  "tool_name": "Read",
+  "tool_input": {...},
+  "tool_result": "...",
+  "correlation_id": "xyz-789"
+}
+```
+
+**Response**:
+```json
+{
+  "success": true,
+  "observation_id": 123
+}
+```
+
+### 4. Generate Summary
+```
+POST /sessions/:sessionDbId/summarize
+```
+
+**Request Body**:
+```json
+{
+  "trigger": "stop"
+}
+```
+
+**Response**:
+```json
+{
+  "success": true,
+  "summary_id": 456
+}
+```
+
+### 5. Session Status
+```
+GET /sessions/:sessionDbId/status
+```
+
+**Response**:
+```json
+{
+  "session_id": "abc-123",
+  "status": "active",
+  "observation_count": 42,
+  "summary_count": 1
+}
+```
+
+### 6. Delete Session
+```
+DELETE /sessions/:sessionDbId
+```
+
+**Response**:
+```json
+{
+  "success": true
+}
+```
+
+**Note**: As of v4.1.0, the cleanup hook no longer calls this endpoint. Sessions are marked complete instead of deleted to allow graceful worker shutdown.
+
+## PM2 Management
+
+### Configuration
+
+The worker is configured via `ecosystem.config.cjs`:
+
+```javascript
+module.exports = {
+  apps: [{
+    name: 'claude-mem-worker',
+    script: './plugin/scripts/worker-service.cjs',
+    instances: 1,
+    autorestart: true,
+    watch: false,
+    max_memory_restart: '1G',
+    env: {
+      NODE_ENV: 'production',
+      FORCE_COLOR: '1'
+    }
+  }]
+};
+```
+
+### Commands
+
+```bash
+# Start worker (auto-starts on first session)
+npm run worker:start
+
+# Stop worker
+npm run worker:stop
+
+# Restart worker
+npm run worker:restart
+
+# View logs
+npm run worker:logs
+
+# Check status
+npm run worker:status
+```
+
+### Auto-Start Behavior
+
+As of v4.0.0, the worker service auto-starts when the SessionStart hook fires. Manual start is optional.
+
+## Claude Agent SDK Integration
+
+The worker service routes observations to the Claude Agent SDK for AI-powered processing:
+
+### Processing Flow
+
+1. **Observation Queue**: Observations accumulate in memory
+2. **SDK Processing**: Observations sent to Claude via Agent SDK
+3. **XML Parsing**: Responses parsed for structured data
+4. **Database Storage**: Processed observations stored in SQLite
+
+### SDK Components
+
+- **Prompts** (`src/sdk/prompts.ts`): Builds XML-structured prompts
+- **Parser** (`src/sdk/parser.ts`): Parses Claude's XML responses
+- **Worker** (`src/sdk/worker.ts`): Main SDK agent loop
+
+### Model Configuration
+
+Set the AI model used for processing via environment variable:
+
+```bash
+export CLAUDE_MEM_MODEL=claude-sonnet-4-5
+```
+
+Available models:
+- `claude-haiku-4-5` - Fast, cost-efficient
+- `claude-sonnet-4-5` - Balanced (default)
+- `claude-opus-4` - Most capable
+- `claude-3-7-sonnet` - Alternative version
+
+## Port Allocation
+
+The worker uses a fixed port (37777 by default) for consistent communication:
+
+- **Default**: Port 37777
+- **Override**: Set `CLAUDE_MEM_WORKER_PORT` environment variable
+- **Port File**: `${CLAUDE_PLUGIN_ROOT}/data/worker.port` tracks current port
+
+If port 37777 is in use, the worker will fail to start. Set a custom port via environment variable.
+
+## Data Storage
+
+The worker service stores data in the plugin data directory:
+
+```
+${CLAUDE_PLUGIN_ROOT}/data/
+├── claude-mem.db           # SQLite database
+├── worker.port             # Current worker port file
+└── logs/
+    ├── worker-out.log      # Worker stdout logs
+    └── worker-error.log    # Worker stderr logs
+```
+
+## Error Handling
+
+The worker implements graceful degradation:
+
+- **Database Errors**: Logged but don't crash the service
+- **SDK Errors**: Retried with exponential backoff
+- **Network Errors**: Logged and skipped
+- **Invalid Input**: Validated and rejected with error response
+
+## Performance
+
+- **Async Processing**: Observations processed asynchronously
+- **In-Memory Queue**: Fast observation accumulation
+- **Batch Processing**: Multiple observations processed together
+- **Connection Pooling**: SQLite connections reused
+
+## Troubleshooting
+
+See [Troubleshooting - Worker Issues](../troubleshooting.md#worker-service-issues) for common problems and solutions.

docs/configuration.mdx

@@ -0,0 +1,303 @@
+---
+title: "Configuration"
+description: "Environment variables and settings for Claude-Mem"
+---
+
+# Configuration
+
+## Environment Variables
+
+| Variable                | Default                         | Description                           |
+|-------------------------|---------------------------------|---------------------------------------|
+| `CLAUDE_PLUGIN_ROOT`    | Set by Claude Code              | Plugin installation directory         |
+| `CLAUDE_MEM_DATA_DIR`   | `~/.claude-mem/`                | Data directory (dev override)         |
+| `CLAUDE_MEM_WORKER_PORT`| `37777`                         | Worker service port                   |
+| `CLAUDE_MEM_MODEL`      | `claude-sonnet-4-5`             | AI model for processing observations  |
+| `NODE_ENV`              | `production`                    | Environment mode                      |
+| `FORCE_COLOR`           | `1`                             | Enable colored logs                   |
+
+## Model Configuration
+
+Configure which AI model processes your observations.
+
+### Available Models
+
+- `claude-haiku-4-5` - Fast, cost-efficient
+- `claude-sonnet-4-5` - Balanced (default)
+- `claude-opus-4` - Most capable
+- `claude-3-7-sonnet` - Alternative version
+
+### Using the Interactive Script
+
+```bash
+./claude-mem-settings.sh
+```
+
+This script manages `CLAUDE_MEM_MODEL` in `~/.claude/settings.json`.
+
+### Manual Configuration
+
+Edit `~/.claude/settings.json`:
+
+```json
+{
+  "CLAUDE_MEM_MODEL": "claude-sonnet-4-5"
+}
+```
+
+## Files and Directories
+
+### Data Directory Structure
+
+```
+~/.claude-mem/
+├── claude-mem.db           # SQLite database
+├── worker.port             # Current worker port file
+└── logs/
+    ├── worker-out.log      # Worker stdout logs
+    └── worker-error.log    # Worker stderr logs
+```
+
+### Plugin Directory Structure
+
+```
+${CLAUDE_PLUGIN_ROOT}/
+├── .claude-plugin/
+│   └── plugin.json         # Plugin metadata
+├── .mcp.json               # MCP server configuration
+├── hooks/
+│   └── hooks.json          # Hook configuration
+└── scripts/                # Built executables
+    ├── context-hook.js
+    ├── new-hook.js
+    ├── save-hook.js
+    ├── summary-hook.js
+    ├── cleanup-hook.js
+    ├── worker-service.cjs
+    └── search-server.js
+```
+
+## Plugin Configuration
+
+### Hooks Configuration
+
+Hooks are configured in `plugin/hooks/hooks.json`:
+
+```json
+{
+  "description": "Claude-mem memory system hooks",
+  "hooks": {
+    "SessionStart": [{
+      "hooks": [{
+        "type": "command",
+        "command": "cd \"${CLAUDE_PLUGIN_ROOT}/..\" && npm install --prefer-offline --no-audit --no-fund --loglevel=error && node ${CLAUDE_PLUGIN_ROOT}/scripts/context-hook.js",
+        "timeout": 120
+      }]
+    }],
+    "UserPromptSubmit": [{
+      "hooks": [{
+        "type": "command",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/new-hook.js",
+        "timeout": 120
+      }]
+    }],
+    "PostToolUse": [{
+      "matcher": "*",
+      "hooks": [{
+        "type": "command",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/save-hook.js",
+        "timeout": 120
+      }]
+    }],
+    "Stop": [{
+      "hooks": [{
+        "type": "command",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/summary-hook.js",
+        "timeout": 120
+      }]
+    }],
+    "SessionEnd": [{
+      "hooks": [{
+        "type": "command",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/cleanup-hook.js",
+        "timeout": 120
+      }]
+    }]
+  }
+}
+```
+
+### MCP Server Configuration
+
+The MCP search server is configured in `plugin/.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "claude-mem-search": {
+      "type": "stdio",
+      "command": "${CLAUDE_PLUGIN_ROOT}/scripts/search-server.js"
+    }
+  }
+}
+```
+
+This registers the `claude-mem-search` server with Claude Code, making the 7 search tools available in all sessions.
+
+## PM2 Configuration
+
+Worker service is managed by PM2 via `ecosystem.config.cjs`:
+
+```javascript
+module.exports = {
+  apps: [{
+    name: 'claude-mem-worker',
+    script: './plugin/scripts/worker-service.cjs',
+    instances: 1,
+    autorestart: true,
+    watch: false,
+    max_memory_restart: '1G',
+    env: {
+      NODE_ENV: 'production',
+      FORCE_COLOR: '1'
+    }
+  }]
+};
+```
+
+### PM2 Settings
+
+- **instances**: 1 (single instance)
+- **autorestart**: true (auto-restart on crash)
+- **watch**: false (no file watching)
+- **max_memory_restart**: 1G (restart if memory exceeds 1GB)
+
+## Customization
+
+### Custom Data Directory
+
+For development or testing, override the data directory:
+
+```bash
+export CLAUDE_MEM_DATA_DIR=/custom/path
+```
+
+### Custom Worker Port
+
+If port 37777 is in use:
+
+```bash
+export CLAUDE_MEM_WORKER_PORT=38000
+npm run worker:restart
+```
+
+### Custom Model
+
+Use a different AI model:
+
+```bash
+export CLAUDE_MEM_MODEL=claude-opus-4
+npm run worker:restart
+```
+
+## Advanced Configuration
+
+### Hook Timeouts
+
+Modify timeouts in `plugin/hooks/hooks.json`:
+
+```json
+{
+  "timeout": 120  // Default: 120 seconds
+}
+```
+
+Recommended values:
+- SessionStart: 120s (needs time for npm install and context retrieval)
+- UserPromptSubmit: 60s
+- PostToolUse: 120s (can process many observations)
+- Stop: 60s
+- SessionEnd: 60s
+
+### Worker Memory Limit
+
+Modify PM2 memory limit in `ecosystem.config.cjs`:
+
+```javascript
+{
+  max_memory_restart: '2G'  // Increase if needed
+}
+```
+
+### Logging Verbosity
+
+Enable debug logging:
+
+```bash
+export DEBUG=claude-mem:*
+npm run worker:restart
+npm run worker:logs
+```
+
+## Configuration Best Practices
+
+1. **Use defaults**: Default configuration works for most use cases
+2. **Override selectively**: Only change what you need
+3. **Document changes**: Keep track of custom configurations
+4. **Test after changes**: Verify worker restarts successfully
+5. **Monitor logs**: Check worker logs after configuration changes
+
+## Troubleshooting Configuration
+
+### Configuration Not Applied
+
+1. Restart worker after changes:
+   ```bash
+   npm run worker:restart
+   ```
+
+2. Verify environment variables:
+   ```bash
+   echo $CLAUDE_MEM_MODEL
+   echo $CLAUDE_MEM_WORKER_PORT
+   ```
+
+3. Check worker logs:
+   ```bash
+   npm run worker:logs
+   ```
+
+### Invalid Model Name
+
+If you specify an invalid model name, the worker will fall back to `claude-sonnet-4-5` and log a warning.
+
+Valid models:
+- claude-haiku-4-5
+- claude-sonnet-4-5
+- claude-opus-4
+- claude-3-7-sonnet
+
+### Port Already in Use
+
+If port 37777 is already in use:
+
+1. Set custom port:
+   ```bash
+   export CLAUDE_MEM_WORKER_PORT=38000
+   ```
+
+2. Restart worker:
+   ```bash
+   npm run worker:restart
+   ```
+
+3. Verify new port:
+   ```bash
+   cat ~/.claude-mem/worker.port
+   ```
+
+## Next Steps
+
+- [Architecture Overview](architecture/overview) - Understand the system
+- [Troubleshooting](troubleshooting) - Common issues
+- [Development](development) - Building from source

docs/development.mdx

@@ -0,0 +1,562 @@
+---
+title: "Development"
+description: "Build from source, run tests, and contribute to Claude-Mem"
+---
+
+# Development Guide
+
+## Building from Source
+
+### Prerequisites
+
+- Node.js 18.0.0 or higher
+- npm (comes with Node.js)
+- Git
+
+### Clone and Build
+
+```bash
+# Clone repository
+git clone https://github.com/thedotmack/claude-mem.git
+cd claude-mem
+
+# Install dependencies
+npm install
+
+# Build all components
+npm run build
+```
+
+### Build Process
+
+The build process uses esbuild to compile TypeScript:
+
+1. Compiles TypeScript to JavaScript
+2. Creates standalone executables for each hook in `plugin/scripts/`
+3. Bundles MCP search server to `plugin/scripts/search-server.js`
+4. Bundles worker service to `plugin/scripts/worker-service.cjs`
+
+**Build Output**:
+- Hook executables: `*-hook.js` (ESM format)
+- Worker service: `worker-service.cjs` (CJS format)
+- Search server: `search-server.js` (ESM format)
+
+### Build Scripts
+
+```bash
+# Build everything
+npm run build
+
+# Build only hooks
+npm run build:hooks
+
+# The build script is defined in scripts/build-hooks.js
+```
+
+## Development Workflow
+
+### 1. Make Changes
+
+Edit TypeScript source files in `src/`:
+
+```
+src/
+├── bin/hooks/       # Hook entry points
+├── hooks/           # Hook implementations
+├── services/        # Worker service and database
+├── servers/         # MCP search server
+├── sdk/             # Claude Agent SDK integration
+├── shared/          # Shared utilities
+└── utils/           # General utilities
+```
+
+### 2. Build
+
+```bash
+npm run build
+```
+
+### 3. Test
+
+```bash
+# Run all tests
+npm test
+
+# Test specific file
+node --test tests/session-lifecycle.test.ts
+
+# Test context injection
+npm run test:context
+
+# Verbose context test
+npm run test:context:verbose
+```
+
+### 4. Manual Testing
+
+```bash
+# Start worker manually
+npm run worker:start
+
+# Check worker status
+npm run worker:status
+
+# View logs
+npm run worker:logs
+
+# Test hooks manually
+echo '{"session_id":"test-123","cwd":"'$(pwd)'","source":"startup"}' | node plugin/scripts/context-hook.js
+```
+
+### 5. Iterate
+
+Repeat steps 1-4 until your changes work as expected.
+
+## Adding New Features
+
+### Adding a New Hook
+
+1. Create hook implementation in `src/hooks/your-hook.ts`:
+
+```typescript
+import { HookInput } from './types';
+
+export async function yourHook(input: HookInput) {
+  // Hook implementation
+  return {
+    hookSpecificOutput: 'Optional output'
+  };
+}
+```
+
+2. Create entry point in `src/bin/hooks/your-hook.ts`:
+
+```typescript
+#!/usr/bin/env node
+import { readStdin } from '../../shared/stdin';
+import { yourHook } from '../../hooks/your-hook';
+
+async function main() {
+  const input = await readStdin();
+  const result = await yourHook(input);
+  console.log(JSON.stringify(result));
+}
+
+main().catch(console.error);
+```
+
+3. Add to `plugin/hooks/hooks.json`:
+
+```json
+{
+  "YourHook": [{
+    "hooks": [{
+      "type": "command",
+      "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/your-hook.js",
+      "timeout": 120
+    }]
+  }]
+}
+```
+
+4. Rebuild:
+
+```bash
+npm run build
+```
+
+### Modifying Database Schema
+
+1. Add migration to `src/services/sqlite/migrations.ts`:
+
+```typescript
+export const migration011: Migration = {
+  version: 11,
+  up: (db: Database) => {
+    db.run(`
+      ALTER TABLE observations ADD COLUMN new_field TEXT;
+    `);
+  },
+  down: (db: Database) => {
+    // Optional: define rollback
+  }
+};
+```
+
+2. Update types in `src/services/sqlite/types.ts`:
+
+```typescript
+export interface Observation {
+  // ... existing fields
+  new_field?: string;
+}
+```
+
+3. Update database methods in `src/services/sqlite/SessionStore.ts`:
+
+```typescript
+createObservation(obs: Observation) {
+  // Include new_field in INSERT
+}
+```
+
+4. Test migration:
+
+```bash
+# Backup database first!
+cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.backup
+
+# Run tests
+npm test
+```
+
+### Extending SDK Prompts
+
+1. Modify prompts in `src/sdk/prompts.ts`:
+
+```typescript
+export function buildObservationPrompt(observation: Observation): string {
+  return `
+    <observation>
+      <!-- Add new XML structure -->
+    </observation>
+  `;
+}
+```
+
+2. Update parser in `src/sdk/parser.ts`:
+
+```typescript
+export function parseObservation(xml: string): ParsedObservation {
+  // Parse new XML fields
+}
+```
+
+3. Test:
+
+```bash
+npm test
+```
+
+### Adding MCP Search Tools
+
+1. Add tool definition in `src/servers/search-server.ts`:
+
+```typescript
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (request.params.name === 'your_new_tool') {
+    // Implement tool logic
+    const results = await search.yourNewSearch(params);
+    return formatResults(results);
+  }
+});
+```
+
+2. Add search method in `src/services/sqlite/SessionSearch.ts`:
+
+```typescript
+yourNewSearch(params: YourParams): SearchResult[] {
+  // Implement FTS5 search
+}
+```
+
+3. Rebuild and test:
+
+```bash
+npm run build
+npm test
+```
+
+## Testing
+
+### Running Tests
+
+```bash
+# All tests
+npm test
+
+# Specific test file
+node --test tests/your-test.test.ts
+
+# With coverage (if configured)
+npm test -- --coverage
+```
+
+### Writing Tests
+
+Create test files in `tests/`:
+
+```typescript
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+
+describe('YourFeature', () => {
+  it('should do something', () => {
+    // Test implementation
+    assert.strictEqual(result, expected);
+  });
+});
+```
+
+### Test Database
+
+Use a separate test database:
+
+```typescript
+import { SessionStore } from '../src/services/sqlite/SessionStore';
+
+const store = new SessionStore(':memory:'); // In-memory database
+```
+
+## Code Style
+
+### TypeScript Guidelines
+
+- Use TypeScript strict mode
+- Define interfaces for all data structures
+- Use async/await for asynchronous code
+- Handle errors explicitly
+- Add JSDoc comments for public APIs
+
+### Formatting
+
+- Follow existing code formatting
+- Use 2-space indentation
+- Use single quotes for strings
+- Add trailing commas in objects/arrays
+
+### Example
+
+```typescript
+/**
+ * Create a new observation in the database
+ */
+export async function createObservation(
+  obs: Observation
+): Promise<number> {
+  try {
+    const result = await db.insert('observations', {
+      session_id: obs.session_id,
+      tool_name: obs.tool_name,
+      // ...
+    });
+    return result.id;
+  } catch (error) {
+    logger.error('Failed to create observation', error);
+    throw error;
+  }
+}
+```
+
+## Debugging
+
+### Enable Debug Logging
+
+```bash
+export DEBUG=claude-mem:*
+npm run worker:restart
+npm run worker:logs
+```
+
+### Inspect Database
+
+```bash
+sqlite3 ~/.claude-mem/claude-mem.db
+
+# View schema
+.schema observations
+
+# Query data
+SELECT * FROM observations LIMIT 10;
+```
+
+### Trace Observations
+
+Use correlation IDs to trace observations through the pipeline:
+
+```bash
+sqlite3 ~/.claude-mem/claude-mem.db
+SELECT correlation_id, tool_name, created_at
+FROM observations
+WHERE session_id = 'YOUR_SESSION_ID'
+ORDER BY created_at;
+```
+
+### Debug Hooks
+
+Run hooks manually with test input:
+
+```bash
+# Test context hook
+echo '{"session_id":"test-123","cwd":"'$(pwd)'","source":"startup"}' | node plugin/scripts/context-hook.js
+
+# Test new hook
+echo '{"session_id":"test-123","cwd":"'$(pwd)'","prompt":"test"}' | node plugin/scripts/new-hook.js
+```
+
+## Publishing
+
+### NPM Publishing
+
+```bash
+# Update version in package.json
+npm version patch  # or minor, or major
+
+# Build
+npm run build
+
+# Publish to NPM
+npm run release
+```
+
+The `release` script:
+1. Runs tests
+2. Builds all components
+3. Publishes to NPM registry
+
+### Creating a Release
+
+1. Update version in `package.json`
+2. Update `CHANGELOG.md`
+3. Commit changes
+4. Create git tag
+5. Push to GitHub
+6. Publish to NPM
+
+```bash
+# Update version
+npm version 4.2.4
+
+# Update changelog
+# Edit CHANGELOG.md manually
+
+# Commit
+git add .
+git commit -m "chore: Release v4.2.4"
+
+# Tag
+git tag v4.2.4
+
+# Push
+git push origin main --tags
+
+# Publish to NPM
+npm run release
+```
+
+## Contributing
+
+### Contribution Workflow
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Write tests
+5. Update documentation
+6. Commit your changes (`git commit -m 'Add amazing feature'`)
+7. Push to the branch (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
+### Pull Request Guidelines
+
+- **Clear title**: Describe what the PR does
+- **Description**: Explain why the change is needed
+- **Tests**: Include tests for new features
+- **Documentation**: Update docs as needed
+- **Changelog**: Add entry to CHANGELOG.md
+- **Commits**: Use clear, descriptive commit messages
+
+### Code Review Process
+
+1. Automated tests must pass
+2. Code review by maintainer
+3. Address feedback
+4. Final approval
+5. Merge to main
+
+## Development Tools
+
+### Recommended VSCode Extensions
+
+- TypeScript
+- ESLint
+- Prettier
+- SQLite Viewer
+
+### Useful Commands
+
+```bash
+# Check TypeScript types
+npx tsc --noEmit
+
+# Lint code (if configured)
+npm run lint
+
+# Format code (if configured)
+npm run format
+
+# Clean build artifacts
+rm -rf plugin/scripts/*.js plugin/scripts/*.cjs
+```
+
+## Troubleshooting Development
+
+### Build Fails
+
+1. Clean node_modules:
+   ```bash
+   rm -rf node_modules
+   npm install
+   ```
+
+2. Check Node.js version:
+   ```bash
+   node --version  # Should be >= 18.0.0
+   ```
+
+3. Check for syntax errors:
+   ```bash
+   npx tsc --noEmit
+   ```
+
+### Tests Fail
+
+1. Check database:
+   ```bash
+   rm ~/.claude-mem/claude-mem.db
+   npm test
+   ```
+
+2. Check worker status:
+   ```bash
+   npm run worker:status
+   ```
+
+3. View logs:
+   ```bash
+   npm run worker:logs
+   ```
+
+### Worker Won't Start
+
+1. Kill existing process:
+   ```bash
+   pm2 delete claude-mem-worker
+   ```
+
+2. Check port:
+   ```bash
+   lsof -i :37777
+   ```
+
+3. Try custom port:
+   ```bash
+   export CLAUDE_MEM_WORKER_PORT=38000
+   npm run worker:start
+   ```
+
+## Next Steps
+
+- [Architecture Overview](architecture/overview) - Understand the system
+- [Configuration](configuration) - Customize Claude-Mem
+- [Troubleshooting](troubleshooting) - Common issues

docs/docs.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://mintlify.com/schema.json",
+  "name": "Claude-Mem",
+  "description": "Persistent memory compression system that preserves context across Claude Code sessions",
+  "theme": "mint",
+  "favicon": "/claude-mem-logomark.webp",
+  "logo": {
+    "light": "/claude-mem-logo-for-light-mode.webp",
+    "dark": "/claude-mem-logo-for-dark-mode.webp",
+    "href": "https://github.com/thedotmack/claude-mem"
+  },
+  "colors": {
+    "primary": "#3B82F6",
+    "light": "#EFF6FF",
+    "dark": "#1E40AF"
+  },
+  "navbar": {
+    "links": [
+      {
+        "label": "GitHub",
+        "href": "https://github.com/thedotmack/claude-mem"
+      }
+    ],
+    "primary": {
+      "type": "button",
+      "label": "Install",
+      "href": "https://github.com/thedotmack/claude-mem#quick-start"
+    }
+  },
+  "navigation": {
+    "groups": [
+      {
+        "group": "Get Started",
+        "icon": "rocket",
+        "pages": [
+          "introduction",
+          "installation",
+          "usage/getting-started",
+          "usage/search-tools"
+        ]
+      },
+      {
+        "group": "Configuration & Development",
+        "icon": "gear",
+        "pages": [
+          "configuration",
+          "development",
+          "troubleshooting"
+        ]
+      },
+      {
+        "group": "Architecture",
+        "icon": "diagram-project",
+        "pages": [
+          "architecture/overview",
+          "architecture/hooks",
+          "architecture/worker-service",
+          "architecture/database",
+          "architecture/mcp-search"
+        ]
+      }
+    ]
+  },
+  "footer": {
+    "socials": {
+      "github": "https://github.com/thedotmack/claude-mem"
+    },
+    "links": [
+      {
+        "header": "Resources",
+        "items": [
+          {
+            "label": "Documentation",
+            "href": "https://github.com/thedotmack/claude-mem"
+          },
+          {
+            "label": "Issues",
+            "href": "https://github.com/thedotmack/claude-mem/issues"
+          }
+        ]
+      },
+      {
+        "header": "Legal",
+        "items": [
+          {
+            "label": "License (AGPL-3.0)",
+            "href": "https://github.com/thedotmack/claude-mem/blob/main/LICENSE"
+          }
+        ]
+      }
+    ]
+  },
+  "seo": {
+    "indexing": "all",
+    "metatags": {
+      "og:type": "website",
+      "og:site_name": "Claude-Mem Documentation",
+      "og:description": "Persistent memory compression system that preserves context across Claude Code sessions"
+    }
+  },
+  "contextual": {
+    "options": [
+      "copy",
+      "view",
+      "chatgpt",
+      "claude",
+      "cursor"
+    ]
+  },
+  "integrations": {
+    "telemetry": {
+      "enabled": false
+    }
+  }
+}

docs/installation.mdx

@@ -0,0 +1,113 @@
+---
+title: "Installation"
+description: "Install Claude-Mem plugin for persistent memory across sessions"
+---
+
+# Installation Guide
+
+## Quick Start
+
+Install Claude-Mem directly from the plugin marketplace:
+
+```bash
+/plugin marketplace add thedotmack/claude-mem
+/plugin install claude-mem
+```
+
+That's it! The plugin will automatically:
+- Download prebuilt binaries (no compilation needed)
+- Install all dependencies (including PM2 and SQLite binaries)
+- Configure hooks for session lifecycle management
+- Set up the MCP search server
+- Auto-start the worker service on first session
+
+Start a new Claude Code session and you'll see context from previous sessions automatically loaded.
+
+## System Requirements
+
+- **Node.js**: 18.0.0 or higher
+- **Claude Code**: Latest version with plugin support
+- **PM2**: Process manager (bundled with plugin - no global install required)
+- **SQLite 3**: For persistent storage (bundled)
+
+## Advanced Installation
+
+For development or testing, you can clone and build from source:
+
+### Clone and Build
+
+```bash
+# Clone the repository
+git clone https://github.com/thedotmack/claude-mem.git
+cd claude-mem
+
+# Install dependencies
+npm install
+
+# Build hooks and worker service
+npm run build
+
+# Worker service will auto-start on first Claude Code session
+# Or manually start with:
+npm run worker:start
+
+# Verify worker is running
+npm run worker:status
+```
+
+### Post-Installation Verification
+
+#### 1. Automatic Dependency Installation
+
+Dependencies are installed automatically during plugin installation. The SessionStart hook also ensures dependencies are up-to-date on each session start (this is fast and idempotent). Works cross-platform on Windows, macOS, and Linux.
+
+#### 2. Verify Plugin Installation
+
+Check that hooks are configured in Claude Code:
+```bash
+cat plugin/hooks/hooks.json
+```
+
+#### 3. Data Directory Location
+
+v4.0.0+ stores data in `${CLAUDE_PLUGIN_ROOT}/data/`:
+- Database: `${CLAUDE_PLUGIN_ROOT}/data/claude-mem.db`
+- Worker port file: `${CLAUDE_PLUGIN_ROOT}/data/worker.port`
+- Logs: `${CLAUDE_PLUGIN_ROOT}/data/logs/`
+
+For development/testing, you can override:
+```bash
+export CLAUDE_MEM_DATA_DIR=/custom/path
+```
+
+#### 4. Check Worker Logs
+
+```bash
+npm run worker:logs
+```
+
+#### 5. Test Context Retrieval
+
+```bash
+npm run test:context
+```
+
+## Upgrading from v3.x
+
+**BREAKING CHANGES - Please Read:**
+
+v4.0.0 introduces breaking changes:
+
+- **Data Location Changed**: Database moved from `~/.claude-mem/` to `${CLAUDE_PLUGIN_ROOT}/data/` (inside plugin directory)
+- **Fresh Start Required**: No automatic migration from v3.x. You must start with a clean database
+- **Worker Auto-Starts**: Worker service now starts automatically - no manual `npm run worker:start` needed
+- **MCP Search Server**: 7 new search tools with full-text search and citations
+- **Enhanced Architecture**: Improved plugin integration and data organization
+
+See [CHANGELOG](https://github.com/thedotmack/claude-mem/blob/main/CHANGELOG.md) for complete details.
+
+## Next Steps
+
+- [Getting Started Guide](usage/getting-started) - Learn how Claude-Mem works automatically
+- [MCP Search Tools](usage/search-tools) - Query your project history
+- [Configuration](configuration) - Customize Claude-Mem behavior

docs/introduction.mdx

@@ -0,0 +1,96 @@
+---
+title: "Introduction"
+description: "Persistent memory compression system for Claude Code"
+---
+
+# Claude-Mem
+
+**Persistent memory compression system for Claude Code**
+
+Claude-Mem seamlessly preserves context across sessions by automatically capturing tool usage observations, generating semantic summaries, and making them available to future sessions. This enables Claude to maintain continuity of knowledge about projects even after sessions end or reconnect.
+
+## Quick Start
+
+Start a new Claude Code session in the terminal and enter the following commands:
+
+```bash
+/plugin marketplace add thedotmack/claude-mem
+/plugin install claude-mem
+```
+
+Restart Claude Code. Context from previous sessions will automatically appear in new sessions.
+
+## Key Features
+
+- 🧠 **Persistent Memory** - Context survives across sessions
+- 🔍 **7 Search Tools** - Query your project history via MCP
+- 🤖 **Automatic Operation** - No manual intervention required
+- 📊 **FTS5 Search** - Fast full-text search across observations
+- 🔗 **Citations** - Reference past decisions with `claude-mem://` URIs
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Session Start → Inject context from last 10 sessions       │
+└─────────────────────────────────────────────────────────────┘
+                            ↓
+┌─────────────────────────────────────────────────────────────┐
+│ User Prompts → Create session, save user prompts           │
+└─────────────────────────────────────────────────────────────┘
+                            ↓
+┌─────────────────────────────────────────────────────────────┐
+│ Tool Executions → Capture observations (Read, Write, etc.)  │
+└─────────────────────────────────────────────────────────────┘
+                            ↓
+┌─────────────────────────────────────────────────────────────┐
+│ Worker Processes → Extract learnings via Claude Agent SDK   │
+└─────────────────────────────────────────────────────────────┘
+                            ↓
+┌─────────────────────────────────────────────────────────────┐
+│ Session Ends → Generate summary, ready for next session     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Core Components:**
+1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd
+2. **Worker Service** - HTTP API on port 37777 managed by PM2
+3. **SQLite Database** - Stores sessions, observations, summaries with FTS5 search
+4. **7 MCP Search Tools** - Query historical context with citations
+
+See [Architecture Overview](architecture/overview) for details.
+
+## System Requirements
+
+- **Node.js**: 18.0.0 or higher
+- **Claude Code**: Latest version with plugin support
+- **PM2**: Process manager (bundled - no global install required)
+- **SQLite 3**: For persistent storage (bundled)
+
+## What's New in v4.2.3
+
+**Security:**
+- Fixed FTS5 injection vulnerability in search functions
+- Added comprehensive test suite with 332 injection attack tests
+
+**Fixes:**
+- Fixed ESM/CJS compatibility for getDirname function
+- Fixed Windows PowerShell compatibility in SessionStart hook
+- Cross-platform dependency installation now works on Windows, macOS, and Linux
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Installation" icon="download" href="/installation">
+    Quick start & advanced installation
+  </Card>
+  <Card title="Getting Started" icon="rocket" href="/usage/getting-started">
+    Learn how Claude-Mem works automatically
+  </Card>
+  <Card title="Architecture" icon="sitemap" href="/architecture/overview">
+    System components & data flow
+  </Card>
+  <Card title="Search Tools" icon="magnifying-glass" href="/usage/search-tools">
+    Query your project history
+  </Card>
+</CardGroup>

docs/memory-toggle-feature.md

@@ -0,0 +1,338 @@
+# Memory Toggle Feature - Design Plan
+
+## Overview
+
+Users need the ability to pause/resume claude-mem memory recording without uninstalling the plugin. This addresses use cases where users want temporary privacy, testing sessions, or simply don't want certain conversations saved.
+
+## User Requirements (from feedback)
+
+- "I don't want to save everything always"
+- Need persistent on/off state across sessions
+- Should be easy to toggle without complex commands
+- Should not interfere with conversation context
+
+## Design Principles
+
+1. **Non-intrusive**: Toggling memory should not require special characters in prompts
+2. **Persistent**: State should survive across Claude Code sessions
+3. **Simple**: Clear on/off with easy status checking
+4. **Fast**: Minimal overhead when checking enabled state
+
+## Implementation Options
+
+### Option A: Settings Flag (Recommended)
+
+**Storage**: `~/.claude/settings.json`
+```json
+{
+  "CLAUDE_MEM_ENABLED": true  // default: true
+}
+```
+
+**CLI Commands**:
+```bash
+claude-mem pause    # Disable memory recording
+claude-mem resume   # Enable memory recording
+claude-mem status   # Show current state
+```
+
+**Hook Behavior**:
+- All hooks check `CLAUDE_MEM_ENABLED` setting at start
+- If `false`, hooks return early without saving/processing
+- Worker service continues running (ready for resume)
+
+**Pros**:
+- Uses existing Claude settings infrastructure
+- Simple boolean flag
+- Easy to implement in all hooks
+
+**Cons**:
+- Modifies Claude Code's settings file
+
+---
+
+### Option B: Local Config File
+
+**Storage**: `~/.claude-mem/config.json`
+```json
+{
+  "enabled": true,
+  "version": "4.2.8",
+  "lastToggled": "2025-10-25T01:30:00Z"
+}
+```
+
+**Same CLI commands as Option A**
+
+**Pros**:
+- Isolated from Claude Code settings
+- Can add metadata (timestamp, reason, etc.)
+- Full control over config structure
+
+**Cons**:
+- Additional file to manage
+- Hooks need to read separate config file
+
+---
+
+### Option C: Slash Command Integration
+
+**Usage**: In-session control via slash commands
+```bash
+/claude-mem pause
+/claude-mem resume
+/claude-mem status
+```
+
+**Pros**:
+- No need to leave Claude Code session
+- Immediate feedback
+- Familiar interface for users
+
+**Cons**:
+- Requires slash command setup
+- Need to update `.claude/commands/` structure
+- More complex implementation
+
+---
+
+## Recommended Approach: Hybrid A + C
+
+Combine Settings Flag (A) with optional Slash Commands (C):
+
+1. **Persistent State**: Store in `~/.claude/settings.json` or `~/.claude-mem/config.json`
+2. **CLI Control**: `claude-mem pause/resume/status`
+3. **Optional In-Session Control**: `/claude-mem pause/resume` slash commands
+4. **Hook Check**: All hooks read setting at startup, skip if disabled
+
+---
+
+## Implementation Details
+
+### Hook Modifications
+
+All hooks need to check enabled state:
+
+```typescript
+// src/shared/settings.ts
+export function isMemoryEnabled(): boolean {
+  try {
+    const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+    const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+    return settings.CLAUDE_MEM_ENABLED !== false; // default true
+  } catch {
+    return true; // default to enabled if settings missing
+  }
+}
+```
+
+```typescript
+// In each hook
+import { isMemoryEnabled } from '../shared/settings.js';
+
+export function hookFunction(input: HookInput) {
+  if (!isMemoryEnabled()) {
+    return; // Skip all memory operations
+  }
+
+  // Normal hook logic...
+}
+```
+
+### CLI Commands
+
+```typescript
+// src/bin/cli.ts
+program
+  .command('pause')
+  .description('Pause memory recording (sessions will not be saved)')
+  .action(() => {
+    updateMemorySetting(false);
+    console.log('✓ Memory recording paused');
+  });
+
+program
+  .command('resume')
+  .description('Resume memory recording')
+  .action(() => {
+    updateMemorySetting(true);
+    console.log('✓ Memory recording resumed');
+  });
+
+program
+  .command('status')
+  .description('Show current memory recording status')
+  .action(() => {
+    const enabled = isMemoryEnabled();
+    console.log(`Memory recording: ${enabled ? '✓ ENABLED' : '✗ PAUSED'}`);
+  });
+```
+
+### Slash Commands (Optional)
+
+Create `.claude/commands/claude-mem.md`:
+```markdown
+# Claude Mem Control
+
+Usage: /claude-mem [pause|resume|status]
+
+- pause: Stop recording this session
+- resume: Resume recording
+- status: Show current state
+```
+
+---
+
+## User Experience
+
+### Pausing Memory
+```bash
+$ claude-mem pause
+✓ Memory recording paused
+
+  All future sessions will NOT be saved until you run:
+  claude-mem resume
+```
+
+### Checking Status
+```bash
+$ claude-mem status
+Memory recording: ✗ PAUSED
+
+To resume recording: claude-mem resume
+```
+
+### Resume Recording
+```bash
+$ claude-mem resume
+✓ Memory recording resumed
+
+All sessions will now be saved to ~/.claude-mem/
+```
+
+---
+
+## Affected Hooks
+
+### new-hook (UserPromptSubmit)
+- Skip creating session records
+- Skip saving user prompts
+
+### save-hook (PostToolUse)
+- Skip capturing observations
+- Skip sending to worker service
+
+### summary-hook
+- Skip generating summaries
+- Session remains unprocessed
+
+### context-hook (SessionStart)
+- Still runs (to show status message?)
+- Could display: "Memory recording is currently paused"
+
+### cleanup-hook (SessionEnd)
+- Skip marking sessions complete
+- No cleanup needed if nothing was saved
+
+---
+
+## Edge Cases
+
+1. **Mid-session toggle**: What if user pauses during a session?
+   - Decision: New state takes effect immediately
+   - Observations before pause are saved, after pause are not
+
+2. **Worker service**: Should it stop when paused?
+   - Decision: Keep running (minimal resource usage)
+   - Ready to process when resumed
+
+3. **Existing data**: What happens to saved sessions when paused?
+   - Decision: No change, data persists
+   - Context hook can still load past sessions
+
+4. **Uninstall vs Pause**: Clear distinction?
+   - Pause: Temporary, easy to resume
+   - Uninstall: Complete removal, requires reinstall
+
+---
+
+## Migration & Compatibility
+
+- Default to `true` (enabled) for backward compatibility
+- Existing users unaffected unless they explicitly pause
+- No database schema changes needed
+- No breaking changes to hooks
+
+---
+
+## Future Enhancements
+
+1. **Selective Recording**: Fine-grained control
+   ```bash
+   claude-mem pause --observations-only
+   claude-mem pause --summaries-only
+   ```
+
+2. **Project-Level Control**: Different settings per project
+   ```bash
+   claude-mem pause --project claude-mem
+   ```
+
+3. **Temporary Pause**: Auto-resume after duration
+   ```bash
+   claude-mem pause --duration 1h
+   ```
+
+4. **Pause Reasons**: Track why users pause
+   ```bash
+   claude-mem pause --reason "debugging session"
+   ```
+
+---
+
+## Open Questions
+
+1. Should context hook still inject past context when paused?
+   - Lean toward: Yes, show past but don't save current
+
+2. Should we show a status indicator when paused?
+   - Could add to context hook output: "🔴 Memory recording paused"
+
+3. CLI command naming: `pause/resume` vs `disable/enable` vs `off/on`?
+   - Lean toward: `pause/resume` (temporary feeling)
+
+4. Should worker service stop when paused?
+   - Lean toward: Keep running (fast resume)
+
+---
+
+## Timeline
+
+- **Phase 1**: Settings flag + CLI commands (1-2 days)
+- **Phase 2**: Status indicator in context hook (1 day)
+- **Phase 3**: Slash commands (optional, 1 day)
+- **Phase 4**: User testing & feedback (1 week)
+- **Phase 5**: Release in v4.3.0
+
+---
+
+## Success Metrics
+
+- Users report successful pausing/resuming
+- No saved data when paused (verify in tests)
+- Fast toggle time (< 100ms)
+- Clear status feedback
+- No edge case bugs in production
+
+---
+
+## Related Issues
+
+- GitHub feedback: "I don't want to save everything always"
+- Privacy concerns: Users want control over what's saved
+- Testing workflows: Developers need clean test sessions
+
+---
+
+*Last Updated: October 25, 2025*
+*Status: Planning / Not Yet Implemented*

docs/prompts/drafts/_prompt-analysis.md

@@ -1,444 +0,0 @@
-# Prompt Flow Analysis & Rankings
-
-## Rating System
-- ✅ **Smart**: Well-designed, clear purpose, effective
-- ⚠️ **Problematic**: Has issues but salvageable
-- ❌ **Stupid**: Poorly designed, confusing, or counterproductive
-- 🧠 **Context Poison**: Will confuse the AI or create inconsistent behavior
-- 🔍 **No Clear Purpose**: Exists but unclear why
-- 🎯 **Clarity Score**: 1-10 (10 = crystal clear, 1 = incomprehensible)
-
----
-
-## Element-by-Element Comparison
-
-### INIT PROMPTS (Session Start)
-
-#### CURRENT: "You are a memory processor"
-```
-You will PROCESS tool executions during this Claude Code session. Your job is to:
-1. ANALYZE each tool response for meaningful content
-2. DECIDE whether it contains something worth storing
-3. EXTRACT the key insight
-4. STORE it as an observation in the XML format below
-
-For MOST meaningful tool outputs, you should generate an observation. Only skip truly routine operations.
-```
-
-**Rating**: ❌ **Stupid** + 🧠 **Context Poison**
-**Clarity**: 3/10
-
-**Issues**:
-1. "For MOST" is ambiguous - does that mean 51%? 80%? 95%?
-2. Creates bias toward over-storage (fear of missing things)
-3. Contradicts "Only skip truly routine operations" later in prompt
-4. No clear guidance on what "meaningful" actually means
-5. "Only skip truly routine" implies almost everything should be stored
-
-**Why Context Poison**:
-- Agent will second-guess every decision
-- Creates inconsistent thresholds across sessions
-- User gets frustrated with noise
-
----
-
-#### OLD: "You are a semantic memory compressor"
-```
-## FIRST: Generate Session Title
-IMMEDIATELY generate a title and subtitle for this session based on the user request.
-
-## THEN: Process Tool Responses
-You will receive a stream of tool responses. For each one:
-1. ANALYZE: Does this contain information worth remembering?
-2. DECIDE: Should I store this or skip it?
-3. EXTRACT: What are the key semantic concepts?
-4. DECOMPOSE: Break into title + subtitle + atomic facts + narrative
-5. STORE: Use bash to save the hierarchical memory
-6. TRACK: Keep count of stored memories (001, 002, 003...)
-
-# IMPORTANT REMINDERS
-- Be selective - quality over quantity
-```
-
-**Rating**: ⚠️ **Problematic** but contains ✅ **Smart** elements
-**Clarity**: 6/10
-
-**Issues**:
-1. "IMMEDIATELY" vs "THEN" creates ordering confusion
-2. Session title generation is unclear when it should happen
-3. Bash tool dependency is fragile
-4. Manual counter tracking is error-prone
-
-**Smart Elements**:
-1. "Quality over quantity" is clear directive
-2. Hierarchical decomposition gives structure
-3. Explicit state tracking (counter)
-4. "Be selective" is unambiguous
-
-**Verdict**: The philosophy is better (selective, quality-focused), execution is messier (bash commands, ordering confusion)
-
----
-
-### OBSERVATION PROMPTS
-
-#### CURRENT: buildObservationPrompt
-```
-ANALYSIS TASK
--------------
-ANALYZE this tool response and DECIDE: Does it contain something worth storing?
-
-Most Read, Edit, Grep, Bash, and Write operations contain meaningful content.
-
-If this contains something worth remembering, output the observation...
-```
-
-**Rating**: ❌ **Stupid** + 🧠 **Context Poison**
-**Clarity**: 4/10
-
-**Issues**:
-1. "Most Read, Edit, Grep, Bash, and Write operations contain meaningful content" - Why repeat this per observation?
-2. Contradicts init prompt's "be selective" guidance
-3. Creates bias: agent thinks "well, this is a Read, so I should probably store it"
-4. No guidance on WHAT to extract from the content
-5. One-sentence observations lose context
-
-**Why Context Poison**:
-- Tool-type bias ("It's a Read, so store it") instead of content-based evaluation
-- Encourages lazy pattern matching instead of semantic analysis
-- Results in garbage like "Read package.json file" with no insight
-
----
-
-#### OLD: Tool Message
-```
-# Tool Response {timeFormatted}
-
-Tool: {toolName}
-User Context: "{userPrompt}"
-
-```
-{toolResponse}
-```
-
-Analyze and store if meaningful.
-```
-
-**Rating**: ✅ **Smart** (minimal, non-leading)
-**Clarity**: 8/10
-
-**Smart Elements**:
-1. Doesn't tell agent what to think about tool types
-2. Trusts agent's judgment from system prompt
-3. Short and clear
-4. Includes user context for relevance filtering
-
-**Issue**:
-1. Maybe TOO minimal - no reminder of format requirements
-
----
-
-### STORAGE FORMATS
-
-#### CURRENT: XML Observations
-```xml
-<observation>
-  <type>feature</type>
-  <text>Implemented JWT token refresh flow with 7-day expiry</text>
-</observation>
-```
-
-**Rating**: ⚠️ **Problematic**
-**Clarity**: 7/10
-
-**Issues**:
-1. One sentence only - loses narrative context
-2. Five types (decision, bugfix, feature, refactor, discovery) - are these actually useful categories?
-3. No file associations
-4. No concept tagging
-5. Flat structure - all observations equal weight
-
-**Smart Elements**:
-1. Simple to parse
-2. Structured typing
-3. Regex-parseable
-
----
-
-#### OLD: Hierarchical Memory (4 levels)
-```bash
---title "SDK Transcript Auto-Cleanup"
---subtitle "Automatic deletion of SDK transcripts after completion prevents memory conversations from appearing in UI history"
---facts '["stop-streaming.js: Deletes SDK transcript after overview generation", "Path: ~/.claude/projects/{sanitized-cwd}/{sessionId}.jsonl"]'
---concepts '["cleanup", "SDK-lifecycle", "UX"]'
---files '["hooks/stop-streaming.js"]'
-```
-
-**Rating**: ✅ **Smart** (structure) but ❌ **Stupid** (execution via bash)
-**Clarity**: 8/10 (concept), 3/10 (implementation)
-
-**Smart Elements**:
-1. Multiple levels of granularity (title → subtitle → facts → narrative)
-2. Atomic facts enable precise retrieval
-3. File associations explicit
-4. Concept tags for categorization
-5. Subtitle gives the "why it matters"
-
-**Stupid Elements**:
-1. Bash command execution is fragile
-2. Quote escaping nightmare
-3. Manual counter tracking
-4. JSON in bash arguments is error-prone
-
-**Verdict**: Great data model, terrible implementation
-
----
-
-### SUMMARY/FINALIZE PROMPTS
-
-#### CURRENT: buildFinalizePrompt (per prompt)
-```xml
-<summary>
-  <request>Implement JWT authentication system</request>
-  <investigated>Existing auth middleware, session management</investigated>
-  <learned>Current system uses session cookies; no JWT support</learned>
-  <completed>Implemented JWT token + refresh flow</completed>
-  <next_steps>Add token revocation API endpoint</next_steps>
-  <files_read><file>src/auth.ts</file></files_read>
-  <files_edited><file>src/auth.ts</file></files_edited>
-  <notes>Token secret stored in .env</notes>
-</summary>
-```
-
-**Rating**: ✅ **Smart** (structure) but 🔍 **No Clear Purpose** (frequency)
-**Clarity**: 9/10
-
-**Smart Elements**:
-1. Structured format with clear fields
-2. Tracks what was learned (semantic value)
-3. Files read/edited tracked explicitly
-4. Next steps captured
-
-**Issues**:
-1. Generated PER PROMPT - is this too granular?
-2. Will create many summaries per session
-3. Unclear how these summaries are used
-4. No aggregation across prompts
-
-**Question**: Should this be per-session instead of per-prompt?
-
----
-
-#### OLD: Session Overview (per session)
-```bash
-claude-mem store-overview --project "{project}" --session "{sessionId}" --content "2-3 sentence overview"
-```
-
-**Rating**: ⚠️ **Problematic**
-**Clarity**: 5/10
-
-**Issues**:
-1. Only 2-3 sentences - very lossy
-2. No structured fields
-3. Happens once at end - loses per-prompt context
-4. Relies on agent's memory of entire session
-
-**Smart Element**:
-1. One overview per session (not noisy)
-
----
-
-### DECISION GUIDANCE
-
-#### CURRENT: What to Store/Skip
-```
-Store these:
-✓ File contents with logic, algorithms, or patterns
-✓ Search results revealing project structure
-✓ Build errors or test failures with context
-...
-
-Skip these:
-✗ Simple status checks (git status with no changes)
-✗ Trivial edits (one-line config changes)
-...
-```
-
-**Rating**: ✅ **Smart**
-**Clarity**: 8/10
-
-**Smart Elements**:
-1. Concrete examples
-2. Both positive and negative cases
-3. Action-oriented
-
-**Issue**:
-1. Contradicted by "For MOST" and "Most Read, Edit..." statements elsewhere
-
----
-
-#### OLD: What to Store/Skip
-```
-Store these:
-- File contents with logic, algorithms, or patterns
-- Search results revealing project structure
-...
-
-Skip these:
-- Simple status checks (git status with no changes)
-- Trivial edits (one-line config changes)
-- Binary data or noise
-- Anything without semantic value
-```
-
-**Rating**: ✅ **Smart**
-**Clarity**: 8/10
-
-**Same as current**, which is good.
-
----
-
-## CRITICAL ISSUES RANKED
-
-### 1. "For MOST meaningful tool outputs" - 🧠 **CONTEXT POISON #1**
-**Severity**: CRITICAL
-**Impact**: Destroys selectivity, fills DB with noise
-**Fix**: Remove entirely. Replace with: "Be selective. Only store if it reveals important information about the codebase."
-
----
-
-### 2. "Most Read, Edit, Grep, Bash, and Write operations contain meaningful content" - 🧠 **CONTEXT POISON #2**
-**Severity**: CRITICAL
-**Impact**: Creates tool-type bias instead of content-based evaluation
-**Fix**: Remove entirely. It's redundant and harmful.
-
----
-
-### 3. One-sentence observations lose context - ❌ **STUPID**
-**Severity**: HIGH
-**Impact**: Can't understand observation without narrative
-**Fix**: Add narrative field to observations (like old system)
-
----
-
-### 4. No hierarchical structure in current system - ❌ **STUPID**
-**Severity**: HIGH
-**Impact**: Can't do granular retrieval (fact-level vs narrative-level)
-**Fix**: Adopt 4-level hierarchy from old system
-
----
-
-### 5. Bash command execution in old system - ❌ **STUPID**
-**Severity**: HIGH
-**Impact**: Fragile, error-prone, quote-escaping nightmare
-**Fix**: Keep current approach (XML parsing + direct DB writes)
-
----
-
-### 6. Manual memory counter in old system - ⚠️ **PROBLEMATIC**
-**Severity**: MEDIUM
-**Impact**: Agent forgets, skips numbers, duplicates
-**Fix**: Auto-increment in database (current approach)
-
----
-
-### 7. Per-prompt summaries unclear purpose - 🔍 **NO CLEAR PURPOSE**
-**Severity**: MEDIUM
-**Impact**: Creates many summaries, unclear how they're used
-**Fix**: Decide: per-session summary only, or per-prompt with aggregation?
-
----
-
-### 8. Five observation types unclear value - 🔍 **NO CLEAR PURPOSE**
-**Severity**: LOW
-**Impact**: Are these categories actually useful for retrieval?
-**Fix**: Evaluate if types should be: (1) kept as-is, (2) expanded, (3) removed
-
----
-
-## BEST ELEMENTS FROM EACH SYSTEM
-
-### From OLD System (Keep These)
-1. ✅ 4-level hierarchy (title → subtitle → facts → narrative)
-2. ✅ "Be selective - quality over quantity"
-3. ✅ Atomic facts (50-150 char, self-contained, no pronouns)
-4. ✅ Concept tagging
-5. ✅ File associations
-6. ✅ Minimal observation prompts (don't bias agent)
-
-### From CURRENT System (Keep These)
-1. ✅ XML parsing (not bash commands)
-2. ✅ Auto-increment IDs (not manual counters)
-3. ✅ Structured summary format (8 fields)
-4. ✅ Per-prompt tracking
-5. ✅ Foreign key integrity
-6. ✅ Typed observations (decision/bugfix/feature/refactor/discovery)
-
-### From NEITHER System (Add These)
-1. Clear threshold guidance: "Only store if it reveals important information about the codebase"
-2. Explicit narrative field in observations
-3. Vector embeddings for semantic search (current stores in SQLite only)
-
----
-
-## RECOMMENDED HYBRID SYSTEM
-
-### Storage Format: Hierarchical Observations (XML)
-```xml
-<observation>
-  <type>feature</type>
-  <title>JWT Token Refresh Implementation</title>
-  <subtitle>Added 7-day refresh token rotation with Redis storage</subtitle>
-  <facts>
-    <fact>src/auth.ts: refreshToken() generates new JWT with 7-day expiry</fact>
-    <fact>Redis key format: refresh:{userId}:{tokenId} with TTL 604800s</fact>
-    <fact>Old token invalidated on refresh to prevent replay attacks</fact>
-  </facts>
-  <narrative>Implemented JWT refresh token functionality in src/auth.ts. The refreshToken() function validates the old refresh token from Redis, generates a new JWT access token (7-day expiry) and new refresh token, stores the new refresh token in Redis with key format refresh:{userId}:{tokenId} and TTL of 604800 seconds (7 days), and invalidates the old refresh token to prevent replay attacks. This enables long-lived authenticated sessions without requiring users to re-login while maintaining security through token rotation.</narrative>
-  <concepts>
-    <concept>authentication</concept>
-    <concept>security</concept>
-    <concept>session-management</concept>
-  </concepts>
-  <files>
-    <file>src/auth.ts</file>
-    <file>src/middleware/auth.ts</file>
-  </files>
-</observation>
-```
-
-### Guidance: Clear and Unambiguous
-```
-Be selective. Only store observations when the tool output reveals important information about:
-- Architecture or design patterns
-- Implementation details of features or bug fixes
-- System state or configuration
-- Business logic or algorithms
-
-Skip routine operations like empty git status, simple npm installs, or trivial config changes.
-
-Each observation should be self-contained and searchable.
-```
-
-### Summary: Per-Session (Not Per-Prompt)
-- Generate ONE summary when session ends
-- Aggregate all observations from session
-- Use current structured format (request, investigated, learned, completed, next_steps, files_read, files_edited, notes)
-
----
-
-## FINAL VERDICT
-
-| Element | Current | Old | Winner |
-|---------|---------|-----|--------|
-| **Storage Structure** | Flat one-sentence | 4-level hierarchy | **OLD** |
-| **Storage Implementation** | XML parsing | Bash commands | **CURRENT** |
-| **Decision Guidance** | Contradictory | Clear | **OLD** |
-| **Session Metadata** | None | Title + subtitle | **OLD** |
-| **Per-Prompt Tracking** | Yes (summaries) | No | **CURRENT** |
-| **Semantic Search** | No | Yes (ChromaDB) | **OLD** |
-| **Observation Prompts** | Biased, repetitive | Minimal, clear | **OLD** |
-| **Auto-Increment IDs** | Yes | No (manual) | **CURRENT** |
-| **File Associations** | No | Yes | **OLD** |
-| **Concept Tagging** | No | Yes | **OLD** |
-
-**Optimal System**: Hybrid - Old system's data model + Current system's implementation approach

docs/prompts/drafts/draft-finalize-prompt.md

@@ -1,41 +0,0 @@
-# Draft Finalize Prompt
-
-```
-SESSION ENDING
-==============
-This Claude Code session is completing.
-
-TASK
-----
-Review the observations you generated and create a session summary.
-
-Output this XML:
-
-```xml
-<summary>
-  <request>What did the user request?</request>
-  <investigated>What code and systems did you explore?</investigated>
-  <learned>What did you learn about the codebase?</learned>
-  <completed>What was accomplished in this session?</completed>
-  <next_steps>What should be done next?</next_steps>
-  <files_read>
-    <file>src/auth.ts</file>
-    <file>src/middleware/session.ts</file>
-  </files_read>
-  <files_edited>
-    <file>src/auth.ts</file>
-  </files_edited>
-  <notes>Additional insights or context</notes>
-</summary>
-```
-
-REQUIREMENTS
-------------
-All 8 fields are required: request, investigated, learned, completed, next_steps, files_read, files_edited, notes
-
-Files must be wrapped in <file> tags
-
-If no files were read/edited, use empty tags: <files_read></files_read>
-
-Focus on semantic insights, not mechanical details.
-```

docs/prompts/drafts/draft-init-prompt.md

@@ -1,92 +0,0 @@
-# Draft Init Prompt
-
-```
-You are a memory processor for the "{project}" project.
-
-SESSION CONTEXT
----------------
-Session ID: {sessionId}
-User's Goal: {userPrompt}
-Date: {date}
-
-YOUR ROLE
----------
-Process tool executions from this Claude Code session and store important observations.
-
-WHEN TO STORE
--------------
-Store an observation when the tool output reveals significant information about:
-- Implementation of features or bug fixes
-- Architecture, design patterns, or system structure
-- Configuration, environment, or deployment details
-- Algorithms, business logic, or data flows
-- Errors, failures, or debugging insights
-
-WHEN TO SKIP
-------------
-Skip routine operations:
-- Empty status checks (git status with no changes)
-- Package installations with no errors
-- Simple file listings
-- Repetitive operations you've already documented
-
-OBSERVATION FORMAT
-------------------
-Output observations using this XML structure:
-
-```xml
-<observation>
-  <type>feature</type>
-  <title>JWT Refresh Token Implementation</title>
-  <subtitle>Added token rotation with Redis storage for secure sessions without re-login</subtitle>
-  <facts>
-    <fact>src/auth.ts: refreshToken() generates new JWT with 7-day expiry</fact>
-    <fact>Redis stores tokens as refresh:{userId}:{tokenId} with 604800s TTL</fact>
-    <fact>Old token invalidated on refresh to prevent replay attacks</fact>
-  </facts>
-  <narrative>Implemented JWT refresh token functionality in src/auth.ts. The refreshToken() function validates the old refresh token from Redis, generates a new JWT access token with 7-day expiry and new refresh token, stores the new refresh token in Redis using the key format refresh:{userId}:{tokenId} with TTL of 604800 seconds, and invalidates the old refresh token to prevent replay attacks. This enables long-lived authenticated sessions without requiring users to re-login while maintaining security through token rotation.</narrative>
-  <concepts>
-    <concept>authentication</concept>
-    <concept>security</concept>
-    <concept>session-management</concept>
-  </concepts>
-  <files>
-    <file>src/auth.ts</file>
-    <file>src/middleware/auth.ts</file>
-  </files>
-</observation>
-```
-
-FIELD REQUIREMENTS
-------------------
-
-**type**: One of: decision, bugfix, feature, refactor, discovery
-
-**title**: 3-8 words capturing the core action
-  Examples: "JWT Refresh Token Implementation", "Database Connection Pool Fix"
-
-**subtitle**: One sentence (max 24 words) explaining the significance
-  Focus on outcome or benefit
-  Examples: "Added token rotation with Redis storage for secure sessions without re-login"
-
-**facts**: 3-7 specific, searchable statements (each 50-150 chars)
-  Each fact is ONE piece of information
-  Include filename or component name
-  No pronouns - each fact must stand alone
-  Examples:
-    - "src/auth.ts: refreshToken() generates new JWT with 7-day expiry"
-    - "Redis stores tokens as refresh:{userId}:{tokenId} with 604800s TTL"
-
-**narrative**: Full explanation (200-400 words)
-  What was done, how it works, why it matters
-  Technical details: files, functions, data structures
-
-**concepts**: 2-5 broad categories
-  Examples: "authentication", "caching", "error-handling", "performance"
-
-**files**: All files touched
-  Full paths from project root
-  Examples: "src/auth.ts", "tests/auth.test.ts"
-
-Ready to process tool executions.
-```

docs/prompts/drafts/draft-observation-prompt.md

@@ -1,21 +0,0 @@
-# Draft Observation Prompt
-
-```
-TOOL OBSERVATION
-================
-Tool: {tool_name}
-Time: {timestamp}
-Prompt: {prompt_number}
-
-Input:
-{tool_input JSON}
-
-Output:
-{tool_output JSON}
-
-TASK
-----
-Analyze this tool output. If it contains significant information about the codebase, generate an observation using the XML format from the init prompt.
-
-If this is routine or repetitive, you can skip it.
-```

docs/prompts/drafts/draft-prompt-flow.md

@@ -1,286 +0,0 @@
-# Current Prompt Flow (SDK System)
-
-## Architecture Overview
-- **System**: SDK Agent (persistent HTTP service via PM2)
-- **Storage**: SQLite (observations + summaries per prompt)
-- **Hooks**: Context (START), Summary (STOP)
-
----
-
-## Flow Timeline
-
-### 1. SESSION START (context-hook.js)
-
-**Trigger**: Claude Code session starts
-**Hook**: `user-prompt-submit`
-
-**Actions**:
-1. Create SDK session in database
-2. Initialize HTTP worker (if not running)
-3. Send init request to worker
-4. Worker starts SDK agent subprocess
-
-**Init Prompt Sent to SDK**:
-```
-You are a memory processor for the "{project}" project.
-
-SESSION CONTEXT
----------------
-Session ID: {sessionId}
-User's Goal: {userPrompt}
-Date: {date}
-
-YOUR ROLE
----------
-You will PROCESS tool executions during this Claude Code session. Your job is to:
-
-1. ANALYZE each tool response for meaningful content
-2. DECIDE whether it contains something worth storing
-3. EXTRACT the key insight
-4. STORE it as an observation in the XML format below
-
-For MOST meaningful tool outputs, you should generate an observation. Only skip truly routine operations.
-
-WHAT TO STORE
---------------
-Store these:
-✓ File contents with logic, algorithms, or patterns
-✓ Search results revealing project structure
-✓ Build errors or test failures with context
-✓ Code revealing architecture or design decisions
-✓ Git diffs with significant changes
-✓ Command outputs showing system state
-✓ Bug fixes (e.g., "fixed race condition in auth middleware by adding mutex")
-✓ New features (e.g., "implemented JWT refresh token flow")
-✓ Refactorings (e.g., "extracted validation logic into separate service")
-✓ Discoveries (e.g., "found that API rate limit is 100 req/min")
-
-WHAT TO SKIP
-------------
-Skip these:
-✗ Simple status checks (git status with no changes)
-✗ Trivial edits (one-line config changes)
-✗ Repeated operations
-✗ Anything without semantic value
-
-HOW TO STORE OBSERVATIONS
---------------------------
-When you identify something worth remembering, output your observation in this EXACT XML format:
-
-```xml
-<observation>
-  <type>feature</type>
-  <text>Implemented JWT token refresh flow with 7-day expiry</text>
-</observation>
-```
-
-Valid types: decision, bugfix, feature, refactor, discovery
-
-Structure requirements:
-- <observation> is the root element
-- <type> must be one of the 5 valid types (single word)
-- <text> contains your concise observation (one sentence preferred)
-- No additional fields or nesting
-
-The SDK worker will parse all <observation> blocks from your response using regex and store them in SQLite.
-
-You can include your reasoning before or after the observation block, or just output the observation by itself.
-
-Ready to process tool responses.
-```
-
-**SDK Agent State**: Running, waiting for observations
-
----
-
-### 2. TOOL EXECUTION (context-hook.js, continuous)
-
-**Trigger**: Each tool execution in Claude Code
-**Hook**: `user-prompt-submit` (captures tool results)
-
-**Actions**:
-1. Hook captures tool_name, tool_input, tool_output
-2. Sends observation to worker HTTP endpoint
-3. Worker queues observation for SDK agent
-
-**Observation Prompt Sent to SDK**:
-```
-TOOL OBSERVATION
-================
-Tool: {tool_name}
-Time: {timestamp}
-
-Input:
-{tool_input JSON}
-
-Output:
-{tool_output JSON}
-
-ANALYSIS TASK
--------------
-ANALYZE this tool response and DECIDE: Does it contain something worth storing?
-
-Most Read, Edit, Grep, Bash, and Write operations contain meaningful content.
-
-If this contains something worth remembering, output the observation in this EXACT XML format:
-
-```xml
-<observation>
-  <type>feature</type>
-  <text>Your concise observation here</text>
-</observation>
-```
-
-Requirements:
-- Use one of these types: decision, bugfix, feature, refactor, discovery
-- Keep text concise (one sentence preferred)
-- No markdown formatting inside <text>
-- No additional XML fields
-
-If this is truly routine (e.g., empty git status), you can skip it. Otherwise, PROCESS and STORE it.
-```
-
-**SDK Response**:
-- Generates 0-N `<observation>` XML blocks
-- Worker parses and stores in `observations` table
-- Links to `prompt_number` (increments per user prompt)
-
----
-
-### 3. PROMPT END (summary-hook.js)
-
-**Trigger**: User prompt completes (stop-streaming event)
-**Hook**: `stop-streaming`
-
-**Actions**:
-1. Send summarize request to worker
-2. Worker sends finalize prompt to SDK agent
-
-**Finalize Prompt Sent to SDK**:
-```
-SESSION ENDING
-==============
-The Claude Code session is finishing.
-
-FINAL TASK
-----------
-1. Review the observations you've stored this session
-2. Generate a structured summary that answers these questions:
-   - What did user request?
-   - What did you investigate?
-   - What did you learn?
-   - What did you do?
-   - What's next?
-   - Files read
-   - Files edited
-   - Notes
-
-3. Generate the structured summary and output it in this EXACT XML format:
-
-```xml
-<summary>
-  <request>Implement JWT authentication system</request>
-  <investigated>Existing auth middleware, session management, token storage patterns</investigated>
-  <learned>Current system uses session cookies; no JWT support; race condition in middleware</learned>
-  <completed>Implemented JWT token + refresh flow with 7-day expiry; fixed race condition with mutex; added token validation middleware</completed>
-  <next_steps>Add token revocation API endpoint; write integration tests</next_steps>
-  <files_read>
-    <file>src/auth.ts</file>
-    <file>src/middleware/session.ts</file>
-    <file>src/types/user.ts</file>
-  </files_read>
-  <files_edited>
-    <file>src/auth.ts</file>
-    <file>src/middleware/auth.ts</file>
-    <file>src/routes/auth.ts</file>
-  </files_edited>
-  <notes>Token secret stored in .env; refresh tokens use rotation strategy</notes>
-</summary>
-```
-
-Structure requirements:
-- <summary> is the root element
-- All 8 child elements are REQUIRED: request, investigated, learned, completed, next_steps, files_read, files_edited, notes
-- <files_read> and <files_edited> must contain <file> child elements (one per file)
-- If no files were read/edited, use empty tags: <files_read></files_read>
-- Text fields can be multiple sentences but avoid markdown formatting
-- Use underscores in element names: next_steps, files_read, files_edited
-
-The SDK worker will parse the <summary> block and extract all fields to store in SQLite.
-
-Generate the summary now in the required XML format.
-```
-
-**SDK Response**:
-- Generates `<summary>` XML block
-- Worker parses and stores in `session_summaries` table
-- Links to specific `prompt_number`
-
----
-
-### 4. SESSION END (cleanup-hook.js)
-
-**Trigger**: Claude Code session ends
-**Hook**: `session-end`
-
-**Actions**:
-1. Mark session as completed
-2. SDK agent continues running (doesn't terminate)
-3. Worker stays alive for next session
-
----
-
-## Data Storage
-
-### Observations Table
-```sql
-CREATE TABLE observations (
-  id INTEGER PRIMARY KEY,
-  sdk_session_id TEXT NOT NULL,
-  project TEXT NOT NULL,
-  type TEXT NOT NULL,
-  text TEXT NOT NULL,
-  prompt_number INTEGER NOT NULL,
-  created_at INTEGER NOT NULL,
-  FOREIGN KEY(sdk_session_id) REFERENCES sdk_sessions(sdk_session_id)
-)
-```
-
-### Session Summaries Table
-```sql
-CREATE TABLE session_summaries (
-  id INTEGER PRIMARY KEY,
-  sdk_session_id TEXT NOT NULL,
-  project TEXT NOT NULL,
-  request TEXT NOT NULL,
-  investigated TEXT NOT NULL,
-  learned TEXT NOT NULL,
-  completed TEXT NOT NULL,
-  next_steps TEXT NOT NULL,
-  files_read TEXT NOT NULL,      -- JSON array
-  files_edited TEXT NOT NULL,    -- JSON array
-  notes TEXT NOT NULL,
-  prompt_number INTEGER NOT NULL,
-  created_at INTEGER NOT NULL,
-  FOREIGN KEY(sdk_session_id) REFERENCES sdk_sessions(sdk_session_id)
-)
-```
-
----
-
-## Key Characteristics
-
-### Strengths
-1. **Persistent SDK agent**: No restart overhead per prompt
-2. **Structured data**: Typed observations, structured summaries
-3. **Per-prompt tracking**: `prompt_number` links observations to specific requests
-4. **Foreign key integrity**: Observations link to sessions via SDK session ID
-
-### Weaknesses
-1. **"MOST" ambiguity**: Init prompt says "For MOST meaningful tool outputs" - confusing
-2. **Observation prompt repetition**: "Most Read, Edit, Grep, Bash, and Write operations contain meaningful content" - contradicts selectivity
-3. **XML parsing brittleness**: Regex-based XML parsing fragile
-4. **No narrative context**: Observations are one-sentence only
-5. **Summary per prompt**: Creates many summaries, unclear if useful
-6. **No hierarchical organization**: Flat observation list
-7. **Limited searchability**: Simple text fields, no embedding/vector search

docs/prompts/drafts/suggested-finalize-prompt.md

@@ -1,38 +0,0 @@
-# Final Finalize Prompt
-
-```
-SESSION ENDING
-==============
-This Claude Code session is completing.
-
-TASK
-----
-Review the observations you generated and create a session summary.
-
-Output this XML:
-
-```xml
-<summary>
-  <request>[What did the user request?]</request>
-  <investigated>[What code and systems did you explore?]</investigated>
-  <learned>[What did you learn about the codebase?]</learned>
-  <completed>[What was accomplished in this session?]</completed>
-  <next_steps>[What should be done next?]</next_steps>
-  <files_read>
-    <file>[path/to/file]</file>
-  </files_read>
-  <files_edited>
-    <file>[path/to/file]</file>
-  </files_edited>
-  <notes>[Additional insights or context]</notes>
-</summary>
-```
-
-REQUIREMENTS
-------------
-All 8 fields are required: request, investigated, learned, completed, next_steps, files_read, files_edited, notes
-
-Files must be wrapped in <file> tags
-
-If no files were read/edited, use empty tags: <files_read></files_read>
-```

docs/prompts/drafts/suggested-flow.md

@@ -1,389 +0,0 @@
-# Recommended Prompt Flow (Hybrid System)
-
-## Design Principles
-
-1. **Be Selective**: Quality over quantity - only store meaningful insights
-2. **Hierarchical Storage**: Multiple levels for granular retrieval
-3. **Clear Guidance**: No ambiguous language like "MOST"
-4. **Structured Data**: XML format with clear schema
-5. **Session Tracking**: Title + subtitle per session
-6. **Per-Prompt Context**: Track which observations came from which user request
-
----
-
-## Flow Timeline
-
-### 1. SESSION START
-
-**Trigger**: Claude Code session starts
-**Hook**: `user-prompt-submit` (context-hook.js)
-
-**Init Prompt Sent to SDK**:
-```
-You are a memory processor for the "{project}" project.
-
-SESSION CONTEXT
----------------
-Session ID: {sessionId}
-User's Goal: {userPrompt}
-Date: {date}
-
-YOUR ROLE
----------
-Process tool executions from this Claude Code session and store important observations.
-
-Be selective. Only store observations when the tool output reveals important information about:
-- Architecture or design patterns
-- Implementation details of features or bug fixes
-- System state or configuration
-- Business logic or algorithms
-
-Skip routine operations like:
-- Empty git status checks
-- Simple npm install output
-- Trivial config changes
-- Repetitive operations
-
-OBSERVATION FORMAT
-------------------
-When you identify something worth remembering, output this XML structure:
-
-```xml
-<observation>
-  <type>feature</type>
-  <title>Short Title (3-8 words)</title>
-  <subtitle>Concise summary explaining the significance (max 24 words)</subtitle>
-  <facts>
-    <fact>Specific detail 1 (50-150 chars, self-contained)</fact>
-    <fact>Specific detail 2 (50-150 chars, self-contained)</fact>
-    <fact>Specific detail 3 (50-150 chars, self-contained)</fact>
-  </facts>
-  <narrative>Full context: what was done, why it matters, how it works. (200-400 words)</narrative>
-  <concepts>
-    <concept>broad-category-1</concept>
-    <concept>broad-category-2</concept>
-  </concepts>
-  <files>
-    <file>path/to/file1.ts</file>
-    <file>path/to/file2.ts</file>
-  </files>
-</observation>
-```
-
-FIELD REQUIREMENTS
-------------------
-
-**Type**: One of: decision, bugfix, feature, refactor, discovery
-
-**Title**: 3-8 words capturing the core action
-- Examples: "JWT Refresh Token Implementation", "Race Condition Fix in Auth Middleware"
-
-**Subtitle**: Max 24 words explaining the significance
-- Focus on outcome or benefit
-- Examples: "Added 7-day refresh token rotation with Redis storage for secure long-lived sessions"
-
-**Facts**: 3-7 atomic facts (50-150 chars each)
-- Each fact is ONE specific piece of information
-- Include filename/component when relevant
-- No pronouns - each fact stands alone
-- Examples:
-  - "src/auth.ts: refreshToken() generates new JWT with 7-day expiry"
-  - "Redis key format: refresh:{userId}:{tokenId} with TTL 604800s"
-  - "Old token invalidated on refresh to prevent replay attacks"
-
-**Narrative**: Full story (200-400 words)
-- What was done
-- Technical details (files, functions, implementation)
-- Why it matters
-
-**Concepts**: 2-5 broad categories for filtering
-- Examples: "authentication", "caching", "error-handling"
-
-**Files**: All files touched
-- Full relative paths from project root
-
-Ready to process tool executions.
-```
-
----
-
-### 2. TOOL EXECUTION
-
-**Trigger**: Each tool execution
-**Hook**: `user-prompt-submit` (context-hook.js)
-
-**Observation Prompt Sent to SDK**:
-```
-TOOL OBSERVATION
-================
-Tool: {tool_name}
-Time: {timestamp}
-Prompt: {prompt_number}
-
-Input:
-{tool_input JSON}
-
-Output:
-{tool_output JSON}
-
-Analyze this tool output. If it reveals important information about the codebase, generate an observation using the XML format from the init prompt.
-```
-
-**SDK Response Processing**:
-1. SDK agent analyzes output
-2. If meaningful, generates `<observation>` XML block
-3. Worker parses XML and stores in SQLite
-4. Links to `prompt_number` for per-request tracking
-
-**Database Schema**:
-```sql
-CREATE TABLE observations (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  sdk_session_id TEXT NOT NULL,
-  project TEXT NOT NULL,
-  prompt_number INTEGER NOT NULL,
-
-  -- Core fields
-  type TEXT NOT NULL,
-  title TEXT NOT NULL,
-  subtitle TEXT NOT NULL,
-  narrative TEXT NOT NULL,
-
-  -- Arrays (stored as JSON)
-  facts TEXT NOT NULL,      -- JSON array of strings
-  concepts TEXT NOT NULL,   -- JSON array of strings
-  files TEXT NOT NULL,      -- JSON array of strings
-
-  created_at INTEGER NOT NULL,
-
-  FOREIGN KEY(sdk_session_id) REFERENCES sdk_sessions(sdk_session_id) ON DELETE CASCADE
-);
-
--- Indexes for fast retrieval
-CREATE INDEX idx_observations_session ON observations(sdk_session_id);
-CREATE INDEX idx_observations_type ON observations(type);
-CREATE INDEX idx_observations_prompt ON observations(prompt_number);
-```
-
----
-
-### 3. SESSION END
-
-**Trigger**: Claude Code session ends
-**Hook**: `session-end` (cleanup-hook.js)
-
-**Finalize Prompt Sent to SDK**:
-```
-SESSION ENDING
-==============
-The Claude Code session is completing.
-
-FINAL TASK
-----------
-Review all observations you've generated and create a session summary.
-
-Output this XML structure:
-
-```xml
-<summary>
-  <request>What did the user request?</request>
-  <investigated>What code/systems did you explore?</investigated>
-  <learned>What did you learn about the codebase?</learned>
-  <completed>What was accomplished?</completed>
-  <next_steps>What should happen next?</next_steps>
-  <files_read>
-    <file>path/to/file1.ts</file>
-    <file>path/to/file2.ts</file>
-  </files_read>
-  <files_edited>
-    <file>path/to/file3.ts</file>
-  </files_edited>
-  <notes>Additional context or insights</notes>
-</summary>
-```
-
-Be concise but comprehensive. Focus on semantic insights, not mechanical details.
-```
-
-**Database Schema**:
-```sql
-CREATE TABLE session_summaries (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  sdk_session_id TEXT NOT NULL,
-  project TEXT NOT NULL,
-
-  request TEXT NOT NULL,
-  investigated TEXT NOT NULL,
-  learned TEXT NOT NULL,
-  completed TEXT NOT NULL,
-  next_steps TEXT NOT NULL,
-  files_read TEXT NOT NULL,   -- JSON array
-  files_edited TEXT NOT NULL, -- JSON array
-  notes TEXT NOT NULL,
-
-  created_at INTEGER NOT NULL,
-
-  FOREIGN KEY(sdk_session_id) REFERENCES sdk_sessions(sdk_session_id) ON DELETE CASCADE
-);
-```
-
----
-
-## Data Retrieval Patterns
-
-### Level 1: Session Titles (High-Level Browsing)
-```sql
-SELECT
-  sdk_session_id,
-  user_prompt as title,
-  created_at
-FROM sdk_sessions
-WHERE project = ?
-ORDER BY created_at DESC;
-```
-
-### Level 2: Session Summaries (Session Overview)
-```sql
-SELECT
-  request,
-  completed,
-  next_steps
-FROM session_summaries
-WHERE sdk_session_id = ?;
-```
-
-### Level 3: Observation Titles (Scannable List)
-```sql
-SELECT
-  type,
-  title,
-  subtitle
-FROM observations
-WHERE sdk_session_id = ?
-ORDER BY id;
-```
-
-### Level 4: Atomic Facts (Precise Search)
-```sql
-SELECT
-  title,
-  facts
-FROM observations
-WHERE
-  sdk_session_id = ?
-  AND facts LIKE '%keyword%';
-```
-
-### Level 5: Full Narrative (Deep Dive)
-```sql
-SELECT
-  title,
-  subtitle,
-  facts,
-  narrative,
-  files
-FROM observations
-WHERE id = ?;
-```
-
-### By Concept (Category Filter)
-```sql
-SELECT
-  title,
-  subtitle,
-  concepts
-FROM observations
-WHERE concepts LIKE '%"authentication"%';
-```
-
-### By File (File-Based Search)
-```sql
-SELECT
-  title,
-  subtitle,
-  files
-FROM observations
-WHERE files LIKE '%src/auth.ts%';
-```
-
----
-
-## Future Enhancements
-
-### Phase 2: Semantic Search
-- Add vector embeddings for facts and narratives
-- Store in ChromaDB or similar
-- Enable similarity search: "Find observations about authentication patterns"
-
-### Phase 3: Cross-Session Memory
-- Link related observations across sessions
-- "Show all JWT-related observations from past 30 days"
-
-### Phase 4: Session Metadata
-- Add title/subtitle to sdk_sessions table
-- Auto-generate from user_prompt or first summary
-
----
-
-## Migration from Current System
-
-### Step 1: Update Database Schema
-```sql
--- Add new columns to observations table
-ALTER TABLE observations ADD COLUMN title TEXT;
-ALTER TABLE observations ADD COLUMN subtitle TEXT;
-ALTER TABLE observations ADD COLUMN narrative TEXT;
-ALTER TABLE observations ADD COLUMN facts TEXT;
-ALTER TABLE observations ADD COLUMN concepts TEXT;
-ALTER TABLE observations ADD COLUMN files TEXT;
-
--- Migrate existing observations (best-effort)
-UPDATE observations
-SET
-  title = type || ' - ' || substr(text, 1, 50),
-  subtitle = text,
-  narrative = text,
-  facts = '[]',
-  concepts = '[]',
-  files = '[]'
-WHERE title IS NULL;
-```
-
-### Step 2: Update Prompts
-- Replace `buildInitPrompt()` with new version (no "MOST")
-- Replace `buildObservationPrompt()` with new version (no tool-type bias)
-- Keep `buildFinalizePrompt()` mostly as-is
-
-### Step 3: Update Parser
-- Extend `parseObservations()` to extract all new fields
-- Add `extractFactArray()`, `extractConceptArray()`, `extractFileArray()` helpers
-- Keep backward compatibility with old one-sentence format
-
-### Step 4: Update Storage
-- Modify `HooksDatabase.storeObservation()` to accept all fields
-- Store arrays as JSON strings
-
----
-
-## Key Improvements Over Current System
-
-1. ✅ **No "MOST" ambiguity** - Clear "be selective" guidance
-2. ✅ **No tool-type bias** - Observation prompt doesn't mention tool names
-3. ✅ **Hierarchical storage** - Title → Subtitle → Facts → Narrative
-4. ✅ **Atomic facts** - Precise, searchable details
-5. ✅ **File associations** - Track which files each observation relates to
-6. ✅ **Concept tagging** - Categorical organization
-7. ✅ **Rich narratives** - Full context for deep dives
-8. ✅ **Multiple retrieval levels** - Can search at any granularity
-
----
-
-## Key Improvements Over Old System
-
-1. ✅ **No bash commands** - XML parsing instead of shell execution
-2. ✅ **Auto-increment IDs** - No manual counter tracking
-3. ✅ **Per-prompt tracking** - `prompt_number` links observations to requests
-4. ✅ **Foreign key integrity** - Automatic cascade deletes
-5. ✅ **No quote escaping hell** - JSON arrays instead of bash arguments
-6. ✅ **Structured typing** - Typed observations (decision/bugfix/feature/refactor/discovery)
-7. ✅ **Session summary at end** - Not just 2-3 sentences, but full structured summary

docs/prompts/drafts/suggested-init-prompt.md

@@ -1,91 +0,0 @@
-# Final Init Prompt
-
-```
-You are a memory processor for the "{project}" project.
-
-SESSION CONTEXT
----------------
-Session ID: {sessionId}
-User's Goal: {userPrompt}
-Date: {date}
-
-YOUR ROLE
----------
-Process tool executions from this Claude Code session and store observations that contain information worth remembering.
-
-WHEN TO STORE
--------------
-Store an observation when the tool output contains information worth remembering about:
-- How things work
-- Why things exist or were chosen
-- What changed
-- Problems and their solutions
-- Important patterns or gotchas
-
-WHEN TO SKIP
-------------
-Skip routine operations:
-- Empty status checks
-- Package installations with no errors
-- Simple file listings
-- Repetitive operations you've already documented
-
-OBSERVATION FORMAT
-------------------
-Output observations using this XML structure:
-
-```xml
-<observation>
-  <type>change</type>
-  <title>[Short title]</title>
-  <subtitle>[One sentence explanation (max 24 words)]</subtitle>
-  <facts>
-    <fact>[Concise, self-contained statement]</fact>
-    <fact>[Concise, self-contained statement]</fact>
-    <fact>[Concise, self-contained statement]</fact>
-  </facts>
-  <narrative>[Full context: what, how, and why]</narrative>
-  <concepts>
-    <concept>[knowledge-type-category]</concept>
-    <concept>[knowledge-type-category]</concept>
-  </concepts>
-  <files>
-    <file>[path/to/file]</file>
-    <file>[path/to/file]</file>
-  </files>
-</observation>
-```
-
-FIELD REQUIREMENTS
-------------------
-
-**type**: One of:
-  - change: modifications to code, config, or documentation
-  - discovery: learning about existing system
-  - decision: choosing an approach and why it was chosen
-
-**title**: Short title capturing the core action or topic
-
-**subtitle**: One sentence explanation (max 24 words)
-
-**facts**: Concise, self-contained statements
-  Each fact is ONE piece of information
-  No pronouns - each fact must stand alone
-  Include specific details: filenames, functions, values
-
-**narrative**: Full context: what, how, and why
-  What was done, how it works, why it matters
-
-**concepts**: 2-5 knowledge-type categories:
-  - how-it-works: understanding mechanisms
-  - why-it-exists: purpose or rationale
-  - what-changed: modifications made
-  - problem-solution: issues and their fixes
-  - gotcha: traps or edge cases
-  - pattern: reusable approach
-  - trade-off: pros/cons of a decision
-
-**files**: All files touched (full paths from project root)
-
-Ready to process tool executions.
-```

docs/prompts/drafts/suggested-observation-prompt.md

@@ -1,17 +0,0 @@
-# Final Observation Prompt
-
-```
-TOOL OBSERVATION
-================
-Tool: {tool_name}
-Time: {timestamp}
-Prompt: {prompt_number}
-
-Input:
-{tool_input JSON}
-
-Output:
-{tool_output JSON}
-
-Analyze this tool output. If it contains information worth remembering, generate an observation using the XML format.
-```

docs/prompts/original/old-prompt-flow.md

@@ -1,293 +0,0 @@
-# Old Prompt Flow (Bash Command System)
-
-## Architecture Overview
-- **System**: SDK Agent (per-session subprocess)
-- **Storage**: ChromaDB (hierarchical memories via bash commands)
-- **Hooks**: Session lifecycle tracking
-
----
-
-## Flow Timeline
-
-### 1. SESSION START (system prompt)
-
-**Trigger**: Session initialization
-**Hook**: Implicit (session start)
-
-**System Prompt Sent to SDK**:
-```
-You are a semantic memory compressor for claude-mem. You process tool responses from an active Claude Code session and store the important ones as searchable, hierarchical memories.
-
-# SESSION CONTEXT
-- Project: {project}
-- Session: {sessionId}
-- Date: {date}
-- User Request: "{userPrompt}"
-
-# YOUR JOB
-
-## FIRST: Generate Session Title
-
-IMMEDIATELY generate a title and subtitle for this session based on the user request.
-
-Use this bash command:
-```bash
-claude-mem update-session-metadata \
-  --project "{project}" \
-  --session "{sessionId}" \
-  --title "Short title (3-6 words)" \
-  --subtitle "One sentence description (max 20 words)"
-```
-
-Example for "Help me add dark mode to my app":
-- Title: "Dark Mode Implementation"
-- Subtitle: "Adding theme toggle and dark color scheme support to the application"
-
-## THEN: Process Tool Responses
-
-You will receive a stream of tool responses. For each one:
-
-1. ANALYZE: Does this contain information worth remembering?
-2. DECIDE: Should I store this or skip it?
-3. EXTRACT: What are the key semantic concepts?
-4. DECOMPOSE: Break into title + subtitle + atomic facts + narrative
-5. STORE: Use bash to save the hierarchical memory
-6. TRACK: Keep count of stored memories (001, 002, 003...)
-
-# WHAT TO STORE
-
-Store these:
-- File contents with logic, algorithms, or patterns
-- Search results revealing project structure
-- Build errors or test failures with context
-- Code revealing architecture or design decisions
-- Git diffs with significant changes
-- Command outputs showing system state
-
-Skip these:
-- Simple status checks (git status with no changes)
-- Trivial edits (one-line config changes)
-- Repeated operations
-- Binary data or noise
-- Anything without semantic value
-
-# HIERARCHICAL MEMORY FORMAT
-
-Each memory has FOUR components:
-
-## 1. TITLE (3-8 words)
-A scannable headline that captures the core action or topic.
-Examples:
-- "SDK Transcript Cleanup Implementation"
-- "Hook System Architecture Analysis"
-- "ChromaDB Migration Planning"
-
-## 2. SUBTITLE (max 24 words)
-A concise, memorable summary that captures the essence of the change.
-Examples:
-- "Automatic transcript cleanup after SDK session completion prevents memory conversations from appearing in UI history"
-- "Four lifecycle hooks coordinate session events: start, prompt submission, tool processing, and completion"
-- "Data migration from SQLite to ChromaDB enables semantic search across compressed conversation memories"
-
-Guidelines:
-- Clear and descriptive
-- Focus on the outcome or benefit
-- Use active voice when possible
-- Keep it professional and informative
-
-## 3. ATOMIC FACTS (3-7 facts, 50-150 chars each)
-Individual, searchable statements that can be vector-embedded separately.
-Each fact is ONE specific piece of information.
-
-Examples:
-- "stop-streaming.js: Auto-deletes SDK transcripts after completion"
-- "Path format: ~/.claude/projects/{sanitized-cwd}/{sessionId}.jsonl"
-- "Uses fs.unlink with graceful error handling for missing files"
-- "Checks two transcript path formats for backward compatibility"
-
-Guidelines:
-- Start with filename or component when relevant
-- Be specific: include paths, function names, actual values
-- Each fact stands alone (no pronouns like "it" or "this")
-- 50-150 characters target
-- Focus on searchable technical details
-
-## 4. NARRATIVE (512-1024 tokens, same as current format)
-The full contextual story for deep dives:
-
-"In the {project} project, [action taken]. [Technical details: files, functions, concepts]. [Why this matters]."
-
-This is the detailed explanation for when someone needs full context.
-
-# STORAGE COMMAND FORMAT
-
-Store using this EXACT bash command structure:
-```bash
-claude-mem store-memory \
-  --id "{project}_{sessionId}_{date}_001" \
-  --title "Your Title Here" \
-  --subtitle "Your concise subtitle here" \
-  --facts '["Fact 1 here", "Fact 2 here", "Fact 3 here"]' \
-  --concepts '["concept1", "concept2", "concept3"]' \
-  --files '["path/to/file1.js", "path/to/file2.ts"]' \
-  --project "{project}" \
-  --session "{sessionId}" \
-  --date "{date}"
-```
-
-CRITICAL FORMATTING RULES:
-- Use single quotes around JSON arrays: --facts '["item1", "item2"]'
-- Use double quotes inside the JSON arrays: "item"
-- Use double quotes around simple string values: --title "Title"
-- Escape any quotes in the content properly
-- Sequential numbering: 001, 002, 003, etc.
-
-Concepts: 2-5 broad categories (e.g., "hooks", "storage", "async-processing")
-Files: Actual file paths touched (e.g., "hooks/stop-streaming.js")
-
-# EXAMPLE MEMORY
-
-Tool response shows: [Read file hooks/stop-streaming.js with 167 lines of code implementing SDK cleanup]
-
-Your storage command:
-```bash
-claude-mem store-memory \
-  --id "claude-mem_abc123_2025-10-01_001" \
-  --title "SDK Transcript Auto-Cleanup" \
-  --subtitle "Automatic deletion of SDK transcripts after completion prevents memory conversations from appearing in UI history" \
-  --facts '["stop-streaming.js: Deletes SDK transcript after overview generation", "Path: ~/.claude/projects/{sanitized-cwd}/{sessionId}.jsonl", "Uses fs.unlink with error handling for missing files", "Prevents memory conversations from polluting Claude Code UI"]' \
-  --concepts '["cleanup", "SDK-lifecycle", "UX", "file-management"]' \
-  --files '["hooks/stop-streaming.js"]' \
-  --project "claude-mem" \
-  --session "abc123" \
-  --date "2025-10-01"
-```
-
-# STATE TRACKING
-
-CRITICAL: Keep track of your memory counter across all tool messages.
-- Start at 001
-- Increment for each stored memory
-- Never repeat numbers
-- Each session has separate numbering
-
-# SESSION END
-
-At the end (when I send "SESSION ENDING"), generate an overview using:
-```bash
-claude-mem store-overview --project "{project}" --session "{sessionId}" --content "2-3 sentence overview"
-```
-
-# IMPORTANT REMINDERS
-
-- You're processing a DIFFERENT Claude Code session (not your own)
-- Use Bash tool to call claude-mem commands
-- Keep subtitles clear and informative (max 24 words)
-- Each fact is ONE specific thing (not multiple ideas)
-- Be selective - quality over quantity
-- Always increment memory numbers
-- Facts should be searchable (specific file names, paths, functions)
-
-Ready for tool responses.
-```
-
-**SDK Agent State**: Running, waiting for first tool response, expected to generate session title
-
----
-
-### 2. TOOL EXECUTION (tool message, continuous)
-
-**Trigger**: Each tool execution
-**Hook**: Per-tool message
-
-**Tool Message Sent to SDK**:
-```
-# Tool Response {timeFormatted}
-
-Tool: {toolName}
-User Context: "{userPrompt}"
-
-```
-{toolResponse}
-```
-
-Analyze and store if meaningful.
-```
-
-**Expected SDK Behavior**:
-1. Analyze tool response
-2. If meaningful, decompose into 4-part hierarchical memory
-3. Generate bash command: `claude-mem store-memory ...`
-4. Execute bash command via Bash tool
-5. Increment memory counter (001, 002, 003...)
-
-**Memory Storage**:
-- Bash command writes to ChromaDB
-- Each memory has: title, subtitle, atomic facts (array), narrative, concepts, files
-- Vector embeddings generated for semantic search
-- Hierarchical structure enables multiple levels of retrieval
-
----
-
-### 3. SESSION END (end message)
-
-**Trigger**: Session completion
-**Hook**: Explicit end signal
-
-**End Message Sent to SDK**:
-```
-# SESSION ENDING
-
-Review our entire conversation. Generate a concise 2-3 sentence overview of what was accomplished.
-
-Store it using Bash:
-```bash
-claude-mem store-overview --project "{project}" --session "{sessionId}" --content "YOUR_OVERVIEW_HERE"
-```
-
-Focus on: what was done, current state, key decisions, outcomes.
-```
-
-**Expected SDK Behavior**:
-1. Review all stored memories from session
-2. Generate 2-3 sentence overview
-3. Execute: `claude-mem store-overview ...`
-4. Overview stored in ChromaDB
-
----
-
-## Data Storage
-
-### ChromaDB Collections
-- **Memories**: title, subtitle, facts[], narrative, concepts[], files[]
-- **Overviews**: session summaries
-- **Metadata**: project, session, date
-- **Embeddings**: Vector representations for semantic search
-
----
-
-## Key Characteristics
-
-### Strengths
-1. **Hierarchical memory**: 4 levels (title → subtitle → facts → narrative)
-2. **Semantic search**: Vector embeddings via ChromaDB
-3. **Granular retrieval**: Can search at fact level or narrative level
-4. **Concept tagging**: Broad categories for filtering
-5. **File tracking**: Explicit file associations
-6. **Session metadata**: Title + subtitle per session
-7. **Clear examples**: Concrete bash command examples
-8. **State tracking**: Explicit memory counter (001, 002, 003...)
-9. **Quality over quantity**: Emphasis on being selective
-10. **Standalone facts**: No pronouns, each fact self-contained
-
-### Weaknesses
-1. **Bash tool dependency**: Requires SDK agent to execute bash commands
-2. **Complex prompt**: Very long system prompt (185 lines)
-3. **Manual counter**: Agent must track memory numbers manually
-4. **Quote escaping**: Complex bash quoting rules prone to errors
-5. **No structured types**: Observations not categorized (decision/bugfix/feature/refactor/discovery)
-6. **Single overview**: Only one overview per session (not per prompt)
-7. **ChromaDB dependency**: Requires external vector database
-8. **Token-heavy**: 512-1024 token narratives + long prompts = high token usage
-9. **Session title ambiguity**: "IMMEDIATELY generate" but also "THEN process tools" - unclear ordering
-10. **No per-prompt summaries**: Can't track what was accomplished per user request

docs/prompts/original/old-prompt.js

@@ -1,217 +0,0 @@
-// src/prompts/hook-prompts.config.ts
-var HOOK_CONFIG = {
-  maxUserPromptLength: 200,
-  maxToolResponseLength: 20000,
-  sdk: {
-    model: "claude-sonnet-4-5",
-    allowedTools: ["Bash"],
-    maxTokensSystem: 8192,
-    maxTokensTool: 8192,
-    maxTokensEnd: 2048
-  }
-};
-var SYSTEM_PROMPT = `You are a semantic memory compressor for claude-mem. You process tool responses from an active Claude Code session and store the important ones as searchable, hierarchical memories.
-
-# SESSION CONTEXT
-- Project: {{project}}
-- Session: {{sessionId}}
-- Date: {{date}}
-- User Request: "{{userPrompt}}"
-
-# YOUR JOB
-
-## FIRST: Generate Session Title
-
-IMMEDIATELY generate a title and subtitle for this session based on the user request.
-
-Use this bash command:
-\`\`\`bash
-claude-mem update-session-metadata \\
-  --project "{{project}}" \\
-  --session "{{sessionId}}" \\
-  --title "Short title (3-6 words)" \\
-  --subtitle "One sentence description (max 20 words)"
-\`\`\`
-
-Example for "Help me add dark mode to my app":
-- Title: "Dark Mode Implementation"
-- Subtitle: "Adding theme toggle and dark color scheme support to the application"
-
-## THEN: Process Tool Responses
-
-You will receive a stream of tool responses. For each one:
-
-1. ANALYZE: Does this contain information worth remembering?
-2. DECIDE: Should I store this or skip it?
-3. EXTRACT: What are the key semantic concepts?
-4. DECOMPOSE: Break into title + subtitle + atomic facts + narrative
-5. STORE: Use bash to save the hierarchical memory
-6. TRACK: Keep count of stored memories (001, 002, 003...)
-
-# WHAT TO STORE
-
-Store these:
-- File contents with logic, algorithms, or patterns
-- Search results revealing project structure
-- Build errors or test failures with context
-- Code revealing architecture or design decisions
-- Git diffs with significant changes
-- Command outputs showing system state
-
-Skip these:
-- Simple status checks (git status with no changes)
-- Trivial edits (one-line config changes)
-- Repeated operations
-- Binary data or noise
-- Anything without semantic value
-
-# HIERARCHICAL MEMORY FORMAT
-
-Each memory has FOUR components:
-
-## 1. TITLE (3-8 words)
-A scannable headline that captures the core action or topic.
-Examples:
-- "SDK Transcript Cleanup Implementation"
-- "Hook System Architecture Analysis"
-- "ChromaDB Migration Planning"
-
-## 2. SUBTITLE (max 24 words)
-A concise, memorable summary that captures the essence of the change.
-Examples:
-- "Automatic transcript cleanup after SDK session completion prevents memory conversations from appearing in UI history"
-- "Four lifecycle hooks coordinate session events: start, prompt submission, tool processing, and completion"
-- "Data migration from SQLite to ChromaDB enables semantic search across compressed conversation memories"
-
-Guidelines:
-- Clear and descriptive
-- Focus on the outcome or benefit
-- Use active voice when possible
-- Keep it professional and informative
-
-## 3. ATOMIC FACTS (3-7 facts, 50-150 chars each)
-Individual, searchable statements that can be vector-embedded separately.
-Each fact is ONE specific piece of information.
-
-Examples:
-- "stop-streaming.js: Auto-deletes SDK transcripts after completion"
-- "Path format: ~/.claude/projects/{sanitized-cwd}/{sessionId}.jsonl"
-- "Uses fs.unlink with graceful error handling for missing files"
-- "Checks two transcript path formats for backward compatibility"
-
-Guidelines:
-- Start with filename or component when relevant
-- Be specific: include paths, function names, actual values
-- Each fact stands alone (no pronouns like "it" or "this")
-- 50-150 characters target
-- Focus on searchable technical details
-
-## 4. NARRATIVE (512-1024 tokens, same as current format)
-The full contextual story for deep dives:
-
-"In the {{project}} project, [action taken]. [Technical details: files, functions, concepts]. [Why this matters]."
-
-This is the detailed explanation for when someone needs full context.
-
-# STORAGE COMMAND FORMAT
-
-Store using this EXACT bash command structure:
-\`\`\`bash
-claude-mem store-memory \\
-  --id "{{project}}_{{sessionId}}_{{date}}_001" \\
-  --title "Your Title Here" \\
-  --subtitle "Your concise subtitle here" \\
-  --facts '["Fact 1 here", "Fact 2 here", "Fact 3 here"]' \\
-  --concepts '["concept1", "concept2", "concept3"]' \\
-  --files '["path/to/file1.js", "path/to/file2.ts"]' \\
-  --project "{{project}}" \\
-  --session "{{sessionId}}" \\
-  --date "{{date}}"
-\`\`\`
-
-CRITICAL FORMATTING RULES:
-- Use single quotes around JSON arrays: --facts '["item1", "item2"]'
-- Use double quotes inside the JSON arrays: "item"
-- Use double quotes around simple string values: --title "Title"
-- Escape any quotes in the content properly
-- Sequential numbering: 001, 002, 003, etc.
-
-Concepts: 2-5 broad categories (e.g., "hooks", "storage", "async-processing")
-Files: Actual file paths touched (e.g., "hooks/stop-streaming.js")
-
-# EXAMPLE MEMORY
-
-Tool response shows: [Read file hooks/stop-streaming.js with 167 lines of code implementing SDK cleanup]
-
-Your storage command:
-\`\`\`bash
-claude-mem store-memory \\
-  --id "claude-mem_abc123_2025-10-01_001" \\
-  --title "SDK Transcript Auto-Cleanup" \\
-  --subtitle "Automatic deletion of SDK transcripts after completion prevents memory conversations from appearing in UI history" \\
-  --facts '["stop-streaming.js: Deletes SDK transcript after overview generation", "Path: ~/.claude/projects/{sanitized-cwd}/{sessionId}.jsonl", "Uses fs.unlink with error handling for missing files", "Prevents memory conversations from polluting Claude Code UI"]' \\
-  --concepts '["cleanup", "SDK-lifecycle", "UX", "file-management"]' \\
-  --files '["hooks/stop-streaming.js"]' \\
-  --project "claude-mem" \\
-  --session "abc123" \\
-  --date "2025-10-01"
-\`\`\`
-
-# STATE TRACKING
-
-CRITICAL: Keep track of your memory counter across all tool messages.
-- Start at 001
-- Increment for each stored memory
-- Never repeat numbers
-- Each session has separate numbering
-
-# SESSION END
-
-At the end (when I send "SESSION ENDING"), generate an overview using:
-\`\`\`bash
-claude-mem store-overview --project "{{project}}" --session "{{sessionId}}" --content "2-3 sentence overview"
-\`\`\`
-
-# IMPORTANT REMINDERS
-
-- You're processing a DIFFERENT Claude Code session (not your own)
-- Use Bash tool to call claude-mem commands
-- Keep subtitles clear and informative (max 24 words)
-- Each fact is ONE specific thing (not multiple ideas)
-- Be selective - quality over quantity
-- Always increment memory numbers
-- Facts should be searchable (specific file names, paths, functions)
-
-Ready for tool responses.`;
-var TOOL_MESSAGE = `# Tool Response {{timeFormatted}}
-
-Tool: {{toolName}}
-User Context: "{{userPrompt}}"
-
-\`\`\`
-{{toolResponse}}
-\`\`\`
-
-Analyze and store if meaningful.`;
-var END_MESSAGE = `# SESSION ENDING
-
-Review our entire conversation. Generate a concise 2-3 sentence overview of what was accomplished.
-
-Store it using Bash:
-\`\`\`bash
-claude-mem store-overview --project "{{project}}" --session "{{sessionId}}" --content "YOUR_OVERVIEW_HERE"
-\`\`\`
-
-Focus on: what was done, current state, key decisions, outcomes.`;
-var PROMPTS = {
-  system: SYSTEM_PROMPT,
-  tool: TOOL_MESSAGE,
-  end: END_MESSAGE
-};
-export {
-  TOOL_MESSAGE,
-  SYSTEM_PROMPT,
-  PROMPTS,
-  HOOK_CONFIG,
-  END_MESSAGE
-};

docs/prompts/publish/prompt-finalize.mdx

@@ -1,17 +0,0 @@
-MEMORY PROCESSING SESSION COMPLETED
-===================================
-This session has completed. Review the observations you generated and create a session summary.
-
-Output this XML:
-<summary>
-  <request>[What did the user request?]</request>
-  <investigated>[What code and systems did you explore?]</investigated>
-  <learned>[What did you learn about the codebase?]</learned>
-  <completed>[What was accomplished in this session?]</completed>
-  <next_steps>[What should be done next?]</next_steps>
-  <notes>[Additional insights or context]</notes>
-</summary>
-
-**Required fields**: request, investigated, learned, completed, next_steps
-
-**Optional fields**: notes

docs/prompts/publish/prompt-init.mdx

@@ -1,83 +0,0 @@
-You are a memory processor for a Claude Code session. Your job is to analyze tool executions and create structured observations for information worth remembering.
-
-You are processing tool executions from a Claude Code session with the following context:
-
-User's Goal: {userPrompt}
-Date: {date}
-
-WHEN TO STORE
--------------
-Store observations when the tool output contains information worth remembering about:
-- How things work
-- Why things exist or were chosen
-- What changed
-- Problems and their solutions
-- Important patterns or gotchas
-
-WHEN TO SKIP
-------------
-Skip routine operations:
-- Empty status checks
-- Package installations with no errors
-- Simple file listings
-- Repetitive operations you've already documented
-
-OUTPUT FORMAT
--------------
-Output observations using this XML structure:
-
-```xml
-<observation>
-  <type>[ change | discovery | decision ]</type>
-  <!--
-    **type**: One of:
-      - change: modifications to code, config, or documentation
-      - discovery: learning about existing system
-      - decision: choosing an approach and why it was chosen
-  -->
-  <title>[**title**: Short title capturing the core action or topic]</title>
-  <subtitle>[**subtitle**: One sentence explanation (max 24 words)]</subtitle>
-  <facts>
-    <fact>[Concise, self-contained statement]</fact>
-    <fact>[Concise, self-contained statement]</fact>
-    <fact>[Concise, self-contained statement]</fact>
-  </facts>
-  <!--
-    **facts**: Concise, self-contained statements
-      Each fact is ONE piece of information
-      No pronouns - each fact must stand alone
-      Include specific details: filenames, functions, values
-  -->
-  <narrative>[**narrative**: Full context: What was done, how it works, why it matters]</narrative>
-  <concepts>
-    <concept>[knowledge-type-category]</concept>
-    <concept>[knowledge-type-category]</concept>
-  </concepts>
-  <!--
-    **concepts**: 2-5 knowledge-type categories:
-      - how-it-works: understanding mechanisms
-      - why-it-exists: purpose or rationale
-      - what-changed: modifications made
-      - problem-solution: issues and their fixes
-      - gotcha: traps or edge cases
-      - pattern: reusable approach
-      - trade-off: pros/cons of a decision
-  -->
-  <files_read>
-    <file>[path/to/file]</file>
-    <file>[path/to/file]</file>
-  </files_read>
-  <files_modified>
-    <file>[path/to/file]</file>
-    <file>[path/to/file]</file>
-  </files_modified>
-  <!--
-    **files**: All files touched (full paths from project root)
-  -->
-</observation>
-```
-
-Process the following tool executions.
-
-MEMORY PROCESSING SESSION START
-===============================

docs/prompts/publish/prompt-observation.mdx

@@ -1,6 +0,0 @@
-<tool_used>
-  <tool_name>[tool_name]</tool_name>
-  <tool_time>[time_formatted]</tool_time>
-  <tool_input>[tool_input JSON]</tool_input>
-  <tool_output>[tool_output JSON]</tool_output>
-</tool_used>

docs/troubleshooting.mdx

@@ -0,0 +1,674 @@
+---
+title: "Troubleshooting"
+description: "Common issues and solutions for Claude-Mem"
+---
+
+# Troubleshooting Guide
+
+## Worker Service Issues
+
+### Worker Service Not Starting
+
+**Symptoms**: Worker doesn't start, or `pm2 status` shows no processes.
+
+**Solutions**:
+
+1. Check if PM2 is running:
+   ```bash
+   pm2 status
+   ```
+
+2. Try starting manually:
+   ```bash
+   npm run worker:start
+   ```
+
+3. Check worker logs for errors:
+   ```bash
+   npm run worker:logs
+   ```
+
+4. Full reset:
+   ```bash
+   pm2 delete claude-mem-worker
+   npm run worker:start
+   ```
+
+5. Verify PM2 is installed:
+   ```bash
+   which pm2
+   npm list pm2
+   ```
+
+### Port Allocation Failed
+
+**Symptoms**: Worker fails to start with "port already in use" error.
+
+**Solutions**:
+
+1. Check if port 37777 is in use:
+   ```bash
+   lsof -i :37777
+   ```
+
+2. Kill process using the port:
+   ```bash
+   kill -9 $(lsof -t -i:37777)
+   ```
+
+3. Or use a different port:
+   ```bash
+   export CLAUDE_MEM_WORKER_PORT=38000
+   npm run worker:restart
+   ```
+
+4. Verify new port:
+   ```bash
+   cat ~/.claude-mem/worker.port
+   ```
+
+### Worker Keeps Crashing
+
+**Symptoms**: Worker restarts repeatedly, PM2 shows high restart count.
+
+**Solutions**:
+
+1. Check error logs:
+   ```bash
+   npm run worker:logs
+   ```
+
+2. Check memory usage:
+   ```bash
+   pm2 status
+   ```
+
+3. Increase memory limit in `ecosystem.config.cjs`:
+   ```javascript
+   {
+     max_memory_restart: '2G'  // Increase if needed
+   }
+   ```
+
+4. Check database for corruption:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"
+   ```
+
+### Worker Not Processing Observations
+
+**Symptoms**: Observations saved but not processed, no summaries generated.
+
+**Solutions**:
+
+1. Check worker is running:
+   ```bash
+   npm run worker:status
+   ```
+
+2. Check worker logs:
+   ```bash
+   npm run worker:logs
+   ```
+
+3. Verify database has observations:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
+   ```
+
+4. Restart worker:
+   ```bash
+   npm run worker:restart
+   ```
+
+## Hook Issues
+
+### Hooks Not Firing
+
+**Symptoms**: No context appears, observations not saved.
+
+**Solutions**:
+
+1. Verify hooks are configured:
+   ```bash
+   cat plugin/hooks/hooks.json
+   ```
+
+2. Test hooks manually:
+   ```bash
+   # Test context hook
+   echo '{"session_id":"test-123","cwd":"'$(pwd)'","source":"startup"}' | node plugin/scripts/context-hook.js
+   ```
+
+3. Check hook permissions:
+   ```bash
+   ls -la plugin/scripts/*.js
+   ```
+
+4. Verify hooks.json is valid JSON:
+   ```bash
+   cat plugin/hooks/hooks.json | jq .
+   ```
+
+### Context Not Appearing
+
+**Symptoms**: No session context when Claude starts.
+
+**Solutions**:
+
+1. Check if summaries exist:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM session_summaries;"
+   ```
+
+2. View recent sessions:
+   ```bash
+   npm run test:context:verbose
+   ```
+
+3. Check database integrity:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"
+   ```
+
+4. Manually test context hook:
+   ```bash
+   npm run test:context
+   ```
+
+### Hooks Timeout
+
+**Symptoms**: Hook execution times out, errors in Claude Code.
+
+**Solutions**:
+
+1. Increase timeout in `plugin/hooks/hooks.json`:
+   ```json
+   {
+     "timeout": 180  // Increase from 120
+   }
+   ```
+
+2. Check worker is running (prevents timeout waiting for worker):
+   ```bash
+   npm run worker:status
+   ```
+
+3. Check database size (large database = slow queries):
+   ```bash
+   ls -lh ~/.claude-mem/claude-mem.db
+   ```
+
+4. Optimize database:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "VACUUM;"
+   ```
+
+### Dependencies Not Installing
+
+**Symptoms**: SessionStart hook fails with "module not found" errors.
+
+**Solutions**:
+
+1. Manually install dependencies:
+   ```bash
+   cd ~/.claude/plugins/marketplaces/thedotmack
+   npm install
+   ```
+
+2. Check npm is available:
+   ```bash
+   which npm
+   npm --version
+   ```
+
+3. Check package.json exists:
+   ```bash
+   ls -la ~/.claude/plugins/marketplaces/thedotmack/package.json
+   ```
+
+## Database Issues
+
+### Database Locked
+
+**Symptoms**: "database is locked" errors in logs.
+
+**Solutions**:
+
+1. Close all connections:
+   ```bash
+   pm2 stop claude-mem-worker
+   ```
+
+2. Check for stale locks:
+   ```bash
+   lsof ~/.claude-mem/claude-mem.db
+   ```
+
+3. Kill processes holding locks:
+   ```bash
+   kill -9 <PID>
+   ```
+
+4. Restart worker:
+   ```bash
+   npm run worker:start
+   ```
+
+### Database Corruption
+
+**Symptoms**: Integrity check fails, weird errors.
+
+**Solutions**:
+
+1. Check database integrity:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"
+   ```
+
+2. Backup database:
+   ```bash
+   cp ~/.claude-mem/claude-mem.db ~/.claude-mem/claude-mem.db.backup
+   ```
+
+3. Try to repair:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "VACUUM;"
+   ```
+
+4. Nuclear option - recreate database:
+   ```bash
+   rm ~/.claude-mem/claude-mem.db
+   npm run worker:start  # Will recreate schema
+   ```
+
+### FTS5 Search Not Working
+
+**Symptoms**: Search returns no results, FTS5 errors.
+
+**Solutions**:
+
+1. Check FTS5 tables exist:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT name FROM sqlite_master WHERE type='table' AND name LIKE '%_fts';"
+   ```
+
+2. Rebuild FTS5 tables:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "
+     INSERT INTO observations_fts(observations_fts) VALUES('rebuild');
+     INSERT INTO session_summaries_fts(session_summaries_fts) VALUES('rebuild');
+     INSERT INTO user_prompts_fts(user_prompts_fts) VALUES('rebuild');
+   "
+   ```
+
+3. Check triggers exist:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT name FROM sqlite_master WHERE type='trigger';"
+   ```
+
+### Database Too Large
+
+**Symptoms**: Slow performance, large database file.
+
+**Solutions**:
+
+1. Check database size:
+   ```bash
+   ls -lh ~/.claude-mem/claude-mem.db
+   ```
+
+2. Vacuum database:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "VACUUM;"
+   ```
+
+3. Delete old sessions:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "
+     DELETE FROM observations WHERE created_at_epoch < $(date -v-30d +%s);
+     DELETE FROM session_summaries WHERE created_at_epoch < $(date -v-30d +%s);
+     DELETE FROM sdk_sessions WHERE created_at_epoch < $(date -v-30d +%s);
+   "
+   ```
+
+4. Rebuild FTS5 after deletion:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "
+     INSERT INTO observations_fts(observations_fts) VALUES('rebuild');
+     INSERT INTO session_summaries_fts(session_summaries_fts) VALUES('rebuild');
+   "
+   ```
+
+## MCP Search Issues
+
+### Search Tools Not Available
+
+**Symptoms**: MCP search tools not visible in Claude Code.
+
+**Solutions**:
+
+1. Check MCP configuration:
+   ```bash
+   cat plugin/.mcp.json
+   ```
+
+2. Verify search server is built:
+   ```bash
+   ls -l plugin/scripts/search-server.js
+   ```
+
+3. Rebuild if needed:
+   ```bash
+   npm run build
+   ```
+
+4. Restart Claude Code
+
+### Search Returns No Results
+
+**Symptoms**: Valid queries return empty results.
+
+**Solutions**:
+
+1. Check database has data:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
+   ```
+
+2. Verify FTS5 tables populated:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations_fts;"
+   ```
+
+3. Test simple query:
+   ```bash
+   # In Claude Code
+   search_observations with query="test"
+   ```
+
+4. Check query syntax:
+   ```bash
+   # Bad: Special characters
+   search_observations with query="[test]"
+
+   # Good: Simple words
+   search_observations with query="test"
+   ```
+
+### Token Limit Errors
+
+**Symptoms**: "exceeded token limit" errors from MCP.
+
+**Solutions**:
+
+1. Use index format:
+   ```bash
+   search_observations with query="..." and format="index"
+   ```
+
+2. Reduce limit:
+   ```bash
+   search_observations with query="..." and limit=3
+   ```
+
+3. Use filters to narrow results:
+   ```bash
+   search_observations with query="..." and type="decision" and limit=5
+   ```
+
+4. Paginate results:
+   ```bash
+   # First page
+   search_observations with query="..." and limit=5 and offset=0
+
+   # Second page
+   search_observations with query="..." and limit=5 and offset=5
+   ```
+
+## Performance Issues
+
+### Slow Context Injection
+
+**Symptoms**: SessionStart hook takes too long.
+
+**Solutions**:
+
+1. Reduce context sessions:
+   ```typescript
+   // In src/hooks/context.ts
+   const CONTEXT_SESSIONS = 5;  // Reduce from 10
+   ```
+
+2. Optimize database:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "
+     ANALYZE;
+     VACUUM;
+   "
+   ```
+
+3. Add indexes (if missing):
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "
+     CREATE INDEX IF NOT EXISTS idx_sessions_project_created ON sdk_sessions(project, created_at_epoch DESC);
+   "
+   ```
+
+### Slow Search Queries
+
+**Symptoms**: MCP search tools take too long.
+
+**Solutions**:
+
+1. Use more specific queries
+2. Add date range filters
+3. Add type/concept filters
+4. Reduce result limit
+5. Use index format instead of full format
+
+### High Memory Usage
+
+**Symptoms**: Worker uses too much memory, frequent restarts.
+
+**Solutions**:
+
+1. Check current usage:
+   ```bash
+   pm2 status
+   ```
+
+2. Increase memory limit:
+   ```javascript
+   // In ecosystem.config.cjs
+   {
+     max_memory_restart: '2G'
+   }
+   ```
+
+3. Restart worker:
+   ```bash
+   npm run worker:restart
+   ```
+
+4. Clean up old data (see "Database Too Large" above)
+
+## Installation Issues
+
+### Plugin Not Found
+
+**Symptoms**: `/plugin install claude-mem` fails.
+
+**Solutions**:
+
+1. Add marketplace first:
+   ```bash
+   /plugin marketplace add thedotmack/claude-mem
+   ```
+
+2. Then install:
+   ```bash
+   /plugin install claude-mem
+   ```
+
+3. Verify installation:
+   ```bash
+   ls -la ~/.claude/plugins/marketplaces/thedotmack/
+   ```
+
+### Build Failures
+
+**Symptoms**: `npm run build` fails.
+
+**Solutions**:
+
+1. Clean and reinstall:
+   ```bash
+   rm -rf node_modules package-lock.json
+   npm install
+   ```
+
+2. Check Node.js version:
+   ```bash
+   node --version  # Should be >= 18.0.0
+   ```
+
+3. Check for TypeScript errors:
+   ```bash
+   npx tsc --noEmit
+   ```
+
+### Missing Dependencies
+
+**Symptoms**: "Cannot find module" errors.
+
+**Solutions**:
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+2. Check package.json:
+   ```bash
+   cat package.json
+   ```
+
+3. Verify node_modules exists:
+   ```bash
+   ls -la node_modules/
+   ```
+
+## Debugging
+
+### Enable Verbose Logging
+
+```bash
+export DEBUG=claude-mem:*
+npm run worker:restart
+npm run worker:logs
+```
+
+### Check Correlation IDs
+
+Trace observations through the pipeline:
+
+```bash
+sqlite3 ~/.claude-mem/claude-mem.db "
+  SELECT correlation_id, tool_name, created_at
+  FROM observations
+  WHERE session_id = 'YOUR_SESSION_ID'
+  ORDER BY created_at;
+"
+```
+
+### Inspect Worker State
+
+```bash
+# Check if worker is running
+pm2 status
+
+# View logs
+pm2 logs claude-mem-worker
+
+# Check port file
+cat ~/.claude-mem/worker.port
+
+# Test worker health
+curl http://localhost:37777/health
+```
+
+### Database Inspection
+
+```bash
+sqlite3 ~/.claude-mem/claude-mem.db
+
+# View schema
+.schema
+
+# Check table counts
+SELECT 'sessions', COUNT(*) FROM sdk_sessions
+UNION ALL
+SELECT 'observations', COUNT(*) FROM observations
+UNION ALL
+SELECT 'summaries', COUNT(*) FROM session_summaries
+UNION ALL
+SELECT 'prompts', COUNT(*) FROM user_prompts;
+
+# View recent activity
+SELECT created_at, tool_name FROM observations ORDER BY created_at DESC LIMIT 10;
+```
+
+## Common Error Messages
+
+### "Worker service not responding"
+
+**Cause**: Worker not running or port mismatch.
+
+**Solution**: Restart worker with `npm run worker:restart`.
+
+### "Database is locked"
+
+**Cause**: Multiple processes accessing database.
+
+**Solution**: Stop worker, kill stale processes, restart.
+
+### "FTS5: syntax error"
+
+**Cause**: Invalid search query syntax.
+
+**Solution**: Use simpler query, avoid special characters.
+
+### "SQLITE_CANTOPEN"
+
+**Cause**: Database file permissions or missing directory.
+
+**Solution**: Check `~/.claude-mem/` exists and is writable.
+
+### "Module not found"
+
+**Cause**: Missing dependencies.
+
+**Solution**: Run `npm install`.
+
+## Getting Help
+
+If none of these solutions work:
+
+1. **Check logs**:
+   ```bash
+   npm run worker:logs
+   ```
+
+2. **Create issue**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
+   - Include error messages
+   - Include relevant logs
+   - Include steps to reproduce
+
+3. **Check existing issues**: Someone may have already solved your problem
+
+## Next Steps
+
+- [Configuration](configuration) - Customize Claude-Mem
+- [Development](development) - Build from source
+- [Architecture](architecture/overview) - Understand the system

docs/usage/getting-started.mdx

@@ -0,0 +1,176 @@
+---
+title: "Getting Started"
+description: "Learn how Claude-Mem works automatically in the background"
+---
+
+# Getting Started with Claude-Mem
+
+## Automatic Operation
+
+Claude-Mem works automatically once installed. No manual intervention required!
+
+### The Full Cycle
+
+1. **Start Claude Code** - Context from last 3 sessions appears automatically
+2. **Work normally** - Every tool execution is captured
+3. **Stop Claude** - Summary is generated and saved
+4. **Next session** - Previous work appears in context
+
+### What Gets Captured
+
+Every time Claude uses a tool, claude-mem captures it:
+
+- **Read** - File reads and content access
+- **Write** - New file creation
+- **Edit** - File modifications
+- **Bash** - Command executions
+- **Glob** - File pattern searches
+- **Grep** - Content searches
+- And all other Claude Code tools
+
+### What Gets Processed
+
+The worker service processes tool observations and extracts:
+
+- **Title** - Brief description of what happened
+- **Subtitle** - Additional context
+- **Narrative** - Detailed explanation
+- **Facts** - Key learnings as bullet points
+- **Concepts** - Relevant tags and categories
+- **Type** - Classification (decision, bugfix, feature, etc.)
+- **Files** - Which files were read or modified
+
+### Session Summaries
+
+When you stop Claude (or a session ends), a summary is generated with:
+
+- **Request** - What you asked for
+- **Investigated** - What Claude explored
+- **Learned** - Key discoveries and insights
+- **Completed** - What was accomplished
+- **Next Steps** - What to do next
+
+### Context Injection
+
+When you start a new Claude Code session, the SessionStart hook:
+
+1. Queries the database for recent sessions in your project
+2. Retrieves the last 10 session summaries
+3. Formats them with three-tier verbosity (most recent = most detail)
+4. Injects them into Claude's initial context
+
+This means Claude "remembers" what happened in previous sessions!
+
+## Manual Commands (Optional)
+
+### Worker Management
+
+v4.0+ auto-starts the worker on first session. Manual commands below are optional.
+
+```bash
+# Start worker service (optional - auto-starts automatically)
+npm run worker:start
+
+# Stop worker service
+npm run worker:stop
+
+# Restart worker service
+npm run worker:restart
+
+# View worker logs
+npm run worker:logs
+
+# Check worker status
+npm run worker:status
+```
+
+### Testing
+
+```bash
+# Run all tests
+npm test
+
+# Test context injection
+npm run test:context
+
+# Verbose context test
+npm run test:context:verbose
+```
+
+### Development
+
+```bash
+# Build hooks and worker
+npm run build
+
+# Build only hooks
+npm run build:hooks
+
+# Publish to NPM (maintainers only)
+npm run publish:npm
+```
+
+## Viewing Stored Context
+
+Context is stored in SQLite database at `~/.claude-mem/claude-mem.db`.
+
+Query the database directly:
+
+```bash
+# Open database
+sqlite3 ~/.claude-mem/claude-mem.db
+
+# View recent sessions
+SELECT session_id, project, created_at, status
+FROM sdk_sessions
+ORDER BY created_at DESC
+LIMIT 10;
+
+# View session summaries
+SELECT session_id, request, completed, learned
+FROM session_summaries
+ORDER BY created_at DESC
+LIMIT 5;
+
+# View observations for a session
+SELECT tool_name, created_at
+FROM observations
+WHERE session_id = 'YOUR_SESSION_ID';
+```
+
+## Understanding Verbosity Levels
+
+Context injection uses three-tier verbosity for efficient token usage:
+
+### Tier 1 (Most Recent Session)
+- Full summary with all details
+- Request, investigated, learned, completed, next_steps, notes
+- ~500-1000 tokens
+
+### Tier 2 (Sessions 2-5)
+- Medium detail
+- Request, learned, completed
+- ~200-400 tokens
+
+### Tier 3 (Sessions 6-10)
+- Brief summary
+- Request and completed only
+- ~100-200 tokens
+
+This ensures you get maximum detail for recent work while still having context from older sessions.
+
+## Multi-Prompt Sessions
+
+Claude-Mem supports sessions that span multiple user prompts:
+
+- **prompt_counter**: Tracks total prompts in a session
+- **prompt_number**: Identifies specific prompt within session
+- **Session continuity**: Observations and summaries link across prompts
+
+When you use `/clear`, the session doesn't end - it continues with a new prompt number. This preserves context across conversation restarts.
+
+## Next Steps
+
+- [MCP Search Tools](/usage/search-tools) - Learn how to search your project history
+- [Architecture Overview](/architecture/overview) - Understand how it works
+- [Troubleshooting](/troubleshooting) - Common issues and solutions

docs/usage/search-tools.mdx

@@ -0,0 +1,426 @@
+---
+title: "MCP Search Tools"
+description: "Query your project history with 7 specialized search tools"
+---
+
+# MCP Search Tools Usage
+
+Once claude-mem is installed as a plugin, 7 search tools become available in your Claude Code sessions for querying project history.
+
+## Quick Reference
+
+| Tool                    | Purpose                                      |
+|-------------------------|----------------------------------------------|
+| search_observations     | Full-text search across observations         |
+| search_sessions         | Full-text search across session summaries    |
+| search_user_prompts     | Full-text search across raw user prompts     |
+| find_by_concept         | Find observations tagged with concepts       |
+| find_by_file            | Find observations referencing files          |
+| find_by_type            | Find observations by type                    |
+| get_recent_context      | Get recent session context                   |
+
+## Example Queries
+
+### search_observations
+
+Find all decisions about the build system:
+```
+Use search_observations to find all decisions about the build system
+```
+
+Find bugs related to authentication:
+```
+search_observations with query="authentication" and type="bugfix"
+```
+
+Search for refactoring work:
+```
+search_observations with query="refactor database" and type="refactor"
+```
+
+### search_sessions
+
+Find what we learned about hooks:
+```
+Use search_sessions to find what we learned about hooks
+```
+
+Search for completed work on the API:
+```
+search_sessions with query="API implementation"
+```
+
+### search_user_prompts
+
+Find when user asked about authentication:
+```
+search_user_prompts with query="authentication feature"
+```
+
+Trace user requests for a specific feature:
+```
+search_user_prompts with query="dark mode"
+```
+
+**Benefits**:
+- See exactly what the user asked for (vs what was implemented)
+- Detect patterns in repeated requests
+- Debug miscommunications between user intent and implementation
+
+### find_by_file
+
+Show everything related to worker-service.ts:
+```
+Use find_by_file to show me everything related to worker-service.ts
+```
+
+Find all work on the database migration file:
+```
+find_by_file with filePath="migrations.ts"
+```
+
+### find_by_concept
+
+Show observations tagged with 'architecture':
+```
+Use find_by_concept to show observations tagged with 'architecture'
+```
+
+Find all 'security' related observations:
+```
+find_by_concept with concept="security"
+```
+
+### find_by_type
+
+Find all feature implementations:
+```
+find_by_type with type="feature"
+```
+
+Find all decisions and discoveries:
+```
+find_by_type with type=["decision", "discovery"]
+```
+
+### get_recent_context
+
+Get the last 5 sessions for context:
+```
+get_recent_context with limit=5
+```
+
+Get recent context for debugging:
+```
+Use get_recent_context to show me what we've been working on
+```
+
+## Search Strategy
+
+### 1. Start with Index Format
+
+**Always use index format first** to get an overview:
+
+```
+search_observations with query="authentication" and format="index"
+```
+
+**Why?**
+- Index format uses ~10x fewer tokens than full format
+- See titles, dates, and sources to identify relevant results
+- Avoid hitting MCP token limits
+
+### 2. Review Results
+
+Look at the index results to identify items of interest:
+
+```
+1. [decision] Implement JWT authentication
+   Date: 2025-10-21 14:23:45
+   Source: claude-mem://observation/123
+
+2. [feature] Add user authentication endpoints
+   Date: 2025-10-21 13:15:22
+   Source: claude-mem://observation/124
+
+3. [bugfix] Fix authentication token expiry
+   Date: 2025-10-20 16:45:30
+   Source: claude-mem://observation/125
+```
+
+### 3. Deep Dive with Full Format
+
+Only use full format for specific items:
+
+```
+search_observations with query="JWT authentication" and format="full" and limit=3
+```
+
+### 4. Use Filters to Narrow Results
+
+Combine filters for precise searches:
+
+```
+search_observations with query="authentication" and type="decision" and dateRange={start: "2025-10-20", end: "2025-10-21"}
+```
+
+## Advanced Filtering
+
+### Date Ranges
+
+Search within specific time periods:
+
+```json
+{
+  "dateRange": {
+    "start": "2025-10-01",
+    "end": "2025-10-31"
+  }
+}
+```
+
+Or use epoch timestamps:
+
+```json
+{
+  "dateRange": {
+    "start": 1729449600,
+    "end": 1732128000
+  }
+}
+```
+
+### Multiple Types
+
+Search across multiple observation types:
+
+```
+find_by_type with type=["decision", "feature", "refactor"]
+```
+
+### Multiple Concepts
+
+Search observations with specific concepts:
+
+```
+search_observations with query="database" and concepts=["architecture", "performance"]
+```
+
+### File Filtering
+
+Search observations that touched specific files:
+
+```
+search_observations with query="refactor" and files="worker-service.ts"
+```
+
+### Project Filtering
+
+Search within specific projects:
+
+```
+search_observations with query="authentication" and project="my-app"
+```
+
+## FTS5 Query Syntax
+
+The `query` parameter supports SQLite FTS5 full-text search syntax:
+
+### Simple Queries
+```
+"authentication"           # Single word
+"error handling"           # Multiple words (OR)
+```
+
+### Boolean Operators
+```
+"error" AND "handling"     # Both terms required
+"bug" OR "fix"             # Either term
+"bug" NOT "feature"        # First term, not second
+```
+
+### Phrase Searches
+```
+"'exact phrase'"           # Exact phrase match
+```
+
+### Column Searches
+```
+title:"authentication"     # Search specific column
+narrative:"bug fix"        # Search narrative field
+```
+
+## Result Metadata
+
+All results 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 citations using the `claude-mem://` URI scheme:
+
+- `claude-mem://observation/123` - Specific observation
+- `claude-mem://session/abc-456` - Specific session
+- `claude-mem://user-prompt/789` - Specific user prompt
+
+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
+
+## Troubleshooting
+
+### No Results Found
+
+1. Check database has data:
+   ```bash
+   sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM observations;"
+   ```
+
+2. Try broader query:
+   ```
+   search_observations with query="authentication"  # Good
+   vs
+   search_observations with query="'exact JWT authentication implementation'"  # Too specific
+   ```
+
+3. Remove filters:
+   ```
+   # Start broad
+   search_observations with query="auth"
+
+   # Then add filters
+   search_observations with query="auth" and type="decision"
+   ```
+
+### Token Limit Errors
+
+1. Use index format:
+   ```
+   search_observations with query="..." and format="index"
+   ```
+
+2. Reduce limit:
+   ```
+   search_observations with query="..." and limit=3
+   ```
+
+3. Use pagination:
+   ```
+   # First page
+   search_observations with query="..." and limit=5 and offset=0
+
+   # Second page
+   search_observations with query="..." and limit=5 and offset=5
+   ```
+
+### Search Too Slow
+
+1. Use more specific queries
+2. Add date range filters
+3. Add type/concept filters
+4. Reduce result limit
+
+## Next Steps
+
+- [MCP Search Architecture](/architecture/mcp-search) - Technical details
+- [Database Schema](/architecture/database) - Understanding the data
+- [Getting Started](/usage/getting-started) - Automatic operation

package-lock.json

@@ -1,15 +1,15 @@
 {
   "name": "claude-mem",
-  "version": "4.1.0",
+  "version": "4.2.10",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "claude-mem",
-      "version": "4.1.0",
-      "license": "SEE LICENSE IN LICENSE",
+      "version": "4.2.10",
+      "license": "AGPL-3.0",
       "dependencies": {
-        "@anthropic-ai/claude-agent-sdk": "^0.1.23",
+        "@anthropic-ai/claude-agent-sdk": "^0.1.27",
         "@modelcontextprotocol/sdk": "^1.20.1",
         "better-sqlite3": "^11.0.0",
         "express": "^4.18.2",
@@ -23,6 +23,7 @@
         "@types/express": "^4.17.21",
         "@types/node": "^20.0.0",
         "esbuild": "^0.20.0",
+        "tsx": "^4.20.6",
         "typescript": "^5.3.0"
       },
       "engines": {
@@ -30,9 +31,9 @@
       }
     },
     "node_modules/@anthropic-ai/claude-agent-sdk": {
-      "version": "0.1.23",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk/-/claude-agent-sdk-0.1.23.tgz",
-      "integrity": "sha512-DktXOjzS2hOuuj2Zpo7fEooONfMa5bm09pt1/Vt4vn30YugELoezn/ZQ/TG5uSQ7+Zl/ElxAvi4vGDorj1Tirg==",
+      "version": "0.1.27",
+      "resolved": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk/-/claude-agent-sdk-0.1.27.tgz",
+      "integrity": "sha512-HuMPW6spj2q8FODiP/WBCqUZAYGwDPoI1EpicP9KUXvuYk+2MZQYSaD7oiN6iNPupR2T5oJ2HY/D9OzjyCD2Mw==",
       "license": "SEE LICENSE IN README.md",
       "engines": {
         "node": ">=18.0.0"
@@ -338,6 +339,23 @@
         "node": ">=12"
       }
     },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.11.tgz",
+      "integrity": "sha512-hr9Oxj1Fa4r04dNpWr3P8QKVVsjQhqrMSUzZzf+LZcYjZNqhA3IAfPQdEh1FLVUJSiu6sgAwp3OmwBfbFgG2Xg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@esbuild/netbsd-x64": {
       "version": "0.20.2",
       "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.20.2.tgz",
@@ -355,6 +373,23 @@
         "node": ">=12"
       }
     },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.11.tgz",
+      "integrity": "sha512-Qq6YHhayieor3DxFOoYM1q0q1uMFYb7cSpLD2qzDSvK1NAvqFi8Xgivv0cFC6J+hWVw2teCYltyy9/m/14ryHg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@esbuild/openbsd-x64": {
       "version": "0.20.2",
       "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.20.2.tgz",
@@ -372,6 +407,23 @@
         "node": ">=12"
       }
     },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.11.tgz",
+      "integrity": "sha512-rOREuNIQgaiR+9QuNkbkxubbp8MSO9rONmwP5nKncnWJ9v5jQ4JxFnLu4zDSRPf3x4u+2VN4pM4RdyIzDty/wQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@esbuild/sunos-x64": {
       "version": "0.20.2",
       "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.20.2.tgz",
@@ -2492,6 +2544,19 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/get-tsconfig": {
+      "version": "4.13.0",
+      "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.13.0.tgz",
+      "integrity": "sha512-1VKTZJCwBrvbd+Wn3AOgQP/2Av+TfTCOlE4AcRJE72W1ksZXbAx8PPBR9RzgTeSPzlPMHrbANMH3LbltH73wxQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "resolve-pkg-maps": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
+      }
+    },
     "node_modules/get-uri": {
       "version": "6.0.5",
       "resolved": "https://registry.npmjs.org/get-uri/-/get-uri-6.0.5.tgz",
@@ -3866,6 +3931,16 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/resolve-pkg-maps": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
+      "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
+      }
+    },
     "node_modules/router": {
       "version": "2.2.0",
       "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
@@ -4455,6 +4530,459 @@
       "integrity": "sha512-4krF8scpejhaOgqzBEcGM7yDIEfi0/8+8zDRZhNZZ2kjmHJ4hv3zCbQWxoJGz1iw5U0Jl0nma13xzHXcncMavQ==",
       "license": "Apache-2.0"
     },
+    "node_modules/tsx": {
+      "version": "4.20.6",
+      "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.20.6.tgz",
+      "integrity": "sha512-ytQKuwgmrrkDTFP4LjR0ToE2nqgy886GpvRSpU0JAnrdBYppuY5rLkRUYPU1yCryb24SsKBTL/hlDQAEFVwtZg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.25.0",
+        "get-tsconfig": "^4.7.5"
+      },
+      "bin": {
+        "tsx": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/aix-ppc64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.11.tgz",
+      "integrity": "sha512-Xt1dOL13m8u0WE8iplx9Ibbm+hFAO0GsU2P34UNoDGvZYkY8ifSiy6Zuc1lYxfG7svWE2fzqCUmFp5HCn51gJg==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/android-arm": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.11.tgz",
+      "integrity": "sha512-uoa7dU+Dt3HYsethkJ1k6Z9YdcHjTrSb5NUy66ZfZaSV8hEYGD5ZHbEMXnqLFlbBflLsl89Zke7CAdDJ4JI+Gg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/android-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.11.tgz",
+      "integrity": "sha512-9slpyFBc4FPPz48+f6jyiXOx/Y4v34TUeDDXJpZqAWQn/08lKGeD8aDp9TMn9jDz2CiEuHwfhRmGBvpnd/PWIQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/android-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.11.tgz",
+      "integrity": "sha512-Sgiab4xBjPU1QoPEIqS3Xx+R2lezu0LKIEcYe6pftr56PqPygbB7+szVnzoShbx64MUupqoE0KyRlN7gezbl8g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/darwin-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.11.tgz",
+      "integrity": "sha512-VekY0PBCukppoQrycFxUqkCojnTQhdec0vevUL/EDOCnXd9LKWqD/bHwMPzigIJXPhC59Vd1WFIL57SKs2mg4w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/darwin-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.11.tgz",
+      "integrity": "sha512-+hfp3yfBalNEpTGp9loYgbknjR695HkqtY3d3/JjSRUyPg/xd6q+mQqIb5qdywnDxRZykIHs3axEqU6l1+oWEQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.11.tgz",
+      "integrity": "sha512-CmKjrnayyTJF2eVuO//uSjl/K3KsMIeYeyN7FyDBjsR3lnSJHaXlVoAK8DZa7lXWChbuOk7NjAc7ygAwrnPBhA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/freebsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.11.tgz",
+      "integrity": "sha512-Dyq+5oscTJvMaYPvW3x3FLpi2+gSZTCE/1ffdwuM6G1ARang/mb3jvjxs0mw6n3Lsw84ocfo9CrNMqc5lTfGOw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-arm": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.11.tgz",
+      "integrity": "sha512-TBMv6B4kCfrGJ8cUPo7vd6NECZH/8hPpBHHlYI3qzoYFvWu2AdTvZNuU/7hsbKWqu/COU7NIK12dHAAqBLLXgw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.11.tgz",
+      "integrity": "sha512-Qr8AzcplUhGvdyUF08A1kHU3Vr2O88xxP0Tm8GcdVOUm25XYcMPp2YqSVHbLuXzYQMf9Bh/iKx7YPqECs6ffLA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-ia32": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.11.tgz",
+      "integrity": "sha512-TmnJg8BMGPehs5JKrCLqyWTVAvielc615jbkOirATQvWWB1NMXY77oLMzsUjRLa0+ngecEmDGqt5jiDC6bfvOw==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-loong64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.11.tgz",
+      "integrity": "sha512-DIGXL2+gvDaXlaq8xruNXUJdT5tF+SBbJQKbWy/0J7OhU8gOHOzKmGIlfTTl6nHaCOoipxQbuJi7O++ldrxgMw==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-mips64el": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.11.tgz",
+      "integrity": "sha512-Osx1nALUJu4pU43o9OyjSCXokFkFbyzjXb6VhGIJZQ5JZi8ylCQ9/LFagolPsHtgw6himDSyb5ETSfmp4rpiKQ==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-ppc64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.11.tgz",
+      "integrity": "sha512-nbLFgsQQEsBa8XSgSTSlrnBSrpoWh7ioFDUmwo158gIm5NNP+17IYmNWzaIzWmgCxq56vfr34xGkOcZ7jX6CPw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-riscv64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.11.tgz",
+      "integrity": "sha512-HfyAmqZi9uBAbgKYP1yGuI7tSREXwIb438q0nqvlpxAOs3XnZ8RsisRfmVsgV486NdjD7Mw2UrFSw51lzUk1ww==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-s390x": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.11.tgz",
+      "integrity": "sha512-HjLqVgSSYnVXRisyfmzsH6mXqyvj0SA7pG5g+9W7ESgwA70AXYNpfKBqh1KbTxmQVaYxpzA/SvlB9oclGPbApw==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/linux-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.11.tgz",
+      "integrity": "sha512-HSFAT4+WYjIhrHxKBwGmOOSpphjYkcswF449j6EjsjbinTZbp8PJtjsVK1XFJStdzXdy/jaddAep2FGY+wyFAQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/netbsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.11.tgz",
+      "integrity": "sha512-u7tKA+qbzBydyj0vgpu+5h5AeudxOAGncb8N6C9Kh1N4n7wU1Xw1JDApsRjpShRpXRQlJLb9wY28ELpwdPcZ7A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/openbsd-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.11.tgz",
+      "integrity": "sha512-CN+7c++kkbrckTOz5hrehxWN7uIhFFlmS/hqziSFVWpAzpWrQoAG4chH+nN3Be+Kzv/uuo7zhX716x3Sn2Jduw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/sunos-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.11.tgz",
+      "integrity": "sha512-nq2xdYaWxyg9DcIyXkZhcYulC6pQ2FuCgem3LI92IwMgIZ69KHeY8T4Y88pcwoLIjbed8n36CyKoYRDygNSGhA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/win32-arm64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.11.tgz",
+      "integrity": "sha512-3XxECOWJq1qMZ3MN8srCJ/QfoLpL+VaxD/WfNRm1O3B4+AZ/BnLVgFbUV3eiRYDMXetciH16dwPbbHqwe1uU0Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/win32-ia32": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.11.tgz",
+      "integrity": "sha512-3ukss6gb9XZ8TlRyJlgLn17ecsK4NSQTmdIXRASVsiS2sQ6zPPZklNJT5GR5tE/MUarymmy8kCEf5xPCNCqVOA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/@esbuild/win32-x64": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.11.tgz",
+      "integrity": "sha512-D7Hpz6A2L4hzsRpPaCYkQnGOotdUpDzSGRIv9I+1ITdHROSFUWW95ZPZWQmGka1Fg7W3zFJowyn9WGwMJ0+KPA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/tsx/node_modules/esbuild": {
+      "version": "0.25.11",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.11.tgz",
+      "integrity": "sha512-KohQwyzrKTQmhXDW1PjCv3Tyspn9n5GcY2RTDqeORIdIJY8yKIF7sTSopFmn/wpMPW4rdPXI0UE5LJLuq3bx0Q==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.25.11",
+        "@esbuild/android-arm": "0.25.11",
+        "@esbuild/android-arm64": "0.25.11",
+        "@esbuild/android-x64": "0.25.11",
+        "@esbuild/darwin-arm64": "0.25.11",
+        "@esbuild/darwin-x64": "0.25.11",
+        "@esbuild/freebsd-arm64": "0.25.11",
+        "@esbuild/freebsd-x64": "0.25.11",
+        "@esbuild/linux-arm": "0.25.11",
+        "@esbuild/linux-arm64": "0.25.11",
+        "@esbuild/linux-ia32": "0.25.11",
+        "@esbuild/linux-loong64": "0.25.11",
+        "@esbuild/linux-mips64el": "0.25.11",
+        "@esbuild/linux-ppc64": "0.25.11",
+        "@esbuild/linux-riscv64": "0.25.11",
+        "@esbuild/linux-s390x": "0.25.11",
+        "@esbuild/linux-x64": "0.25.11",
+        "@esbuild/netbsd-arm64": "0.25.11",
+        "@esbuild/netbsd-x64": "0.25.11",
+        "@esbuild/openbsd-arm64": "0.25.11",
+        "@esbuild/openbsd-x64": "0.25.11",
+        "@esbuild/openharmony-arm64": "0.25.11",
+        "@esbuild/sunos-x64": "0.25.11",
+        "@esbuild/win32-arm64": "0.25.11",
+        "@esbuild/win32-ia32": "0.25.11",
+        "@esbuild/win32-x64": "0.25.11"
+      }
+    },
     "node_modules/tunnel-agent": {
       "version": "0.6.0",
       "license": "Apache-2.0",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "4.1.0",
+  "version": "4.3.1",
   "description": "Memory compression system for Claude Code - persist context across sessions",
   "keywords": [
     "claude",
@@ -16,7 +16,7 @@
     "nodejs"
   ],
   "author": "Alex Newman",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "AGPL-3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/thedotmack/claude-mem.git"
@@ -25,32 +25,23 @@
   "bugs": {
     "url": "https://github.com/thedotmack/claude-mem/issues"
   },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
   "type": "module",
   "engines": {
     "node": ">=18.0.0"
   },
   "scripts": {
     "build": "node scripts/build-hooks.js",
-    "build:hooks": "node scripts/build-hooks.js",
-    "release": "node scripts/publish.js",
-    "prepublishOnly": "npm run build",
     "test": "node --test tests/",
+    "test:parser": "npx tsx src/sdk/parser.test.ts",
     "test:context": "echo '{\"session_id\":\"test-'$(date +%s)'\",\"cwd\":\"'$(pwd)'\",\"source\":\"startup\"}' | node plugin/scripts/context-hook.js 2>/dev/null",
     "test:context:verbose": "echo '{\"session_id\":\"test-'$(date +%s)'\",\"cwd\":\"'$(pwd)'\",\"source\":\"startup\"}' | node plugin/scripts/context-hook.js",
-    "import:xml": "tsx src/bin/import-xml-observations.ts",
-    "cleanup:duplicates": "tsx src/bin/cleanup-duplicates.ts",
-    "worker:start": "npx pm2 start ecosystem.config.cjs",
-    "worker:stop": "npx pm2 stop claude-mem-worker",
-    "worker:restart": "npx pm2 restart claude-mem-worker",
-    "worker:logs": "npx pm2 logs claude-mem-worker",
-    "worker:status": "npx pm2 status claude-mem-worker"
+    "worker:start": "pm2 start ecosystem.config.cjs",
+    "worker:stop": "pm2 stop claude-mem-worker",
+    "worker:restart": "pm2 restart claude-mem-worker",
+    "worker:logs": "pm2 logs claude-mem-worker"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.1.23",
+    "@anthropic-ai/claude-agent-sdk": "^0.1.27",
     "@modelcontextprotocol/sdk": "^1.20.1",
     "better-sqlite3": "^11.0.0",
     "express": "^4.18.2",
@@ -64,15 +55,7 @@
     "@types/express": "^4.17.21",
     "@types/node": "^20.0.0",
     "esbuild": "^0.20.0",
+    "tsx": "^4.20.6",
     "typescript": "^5.3.0"
-  },
-  "files": [
-    "plugin",
-    "src",
-    "scripts",
-    "docs",
-    "ecosystem.config.cjs",
-    "LICENSE",
-    "README.md"
-  ]
+  }
 }

plugin/.claude-plugin/plugin.json

@@ -1,12 +1,12 @@
 {
   "name": "claude-mem",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "description": "Persistent memory system for Claude Code - seamlessly preserve context across sessions",
   "author": {
     "name": "Alex Newman"
   },
   "repository": "https://github.com/thedotmack/claude-mem",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "AGPL-3.0",
   "keywords": [
     "memory",
     "context",

plugin/hooks/hooks.json

@@ -6,8 +6,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "[ ! -d \"${CLAUDE_PLUGIN_ROOT}/../node_modules\" ] && cd \"${CLAUDE_PLUGIN_ROOT}/..\" && npm install && node ${CLAUDE_PLUGIN_ROOT}/scripts/context-hook.js || node ${CLAUDE_PLUGIN_ROOT}/scripts/context-hook.js",
-            "timeout": 120
+            "command": "cd \"${CLAUDE_PLUGIN_ROOT}/..\" && npm install --prefer-offline --no-audit --no-fund --loglevel=silent && node ${CLAUDE_PLUGIN_ROOT}/scripts/context-hook.js",
+            "timeout": 300
           }
         ]
       }

plugin/scripts/claude-mem-settings.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+# claude-mem-settings.sh - User settings manager for claude-mem plugin
+
+USER_SETTINGS_FILE="$HOME/.claude/settings.json"
+
+# Function to check if jq is available
+check_jq() {
+    if ! command -v jq &> /dev/null; then
+        echo "Error: jq is required for JSON manipulation"
+        echo "Install with: brew install jq"
+        exit 1
+    fi
+}
+
+# Function to create settings file if it doesn't exist
+ensure_settings_file() {
+    if [ ! -f "$USER_SETTINGS_FILE" ]; then
+        mkdir -p "$(dirname "$USER_SETTINGS_FILE")"
+        echo '{}' > "$USER_SETTINGS_FILE"
+    fi
+}
+
+# Function to get current model setting
+get_model() {
+    if [ -f "$USER_SETTINGS_FILE" ]; then
+        jq -r '.env.CLAUDE_MEM_MODEL // "claude-sonnet-4-5"' "$USER_SETTINGS_FILE"
+    else
+        echo "claude-sonnet-4-5"
+    fi
+}
+
+# Function to set model setting
+set_model() {
+    local model=$1
+
+    ensure_settings_file
+
+    # Update or create the env.CLAUDE_MEM_MODEL setting
+    jq --arg model "$model" '.env.CLAUDE_MEM_MODEL = $model' "$USER_SETTINGS_FILE" > tmp.json && mv tmp.json "$USER_SETTINGS_FILE"
+    echo "Set CLAUDE_MEM_MODEL to: $model"
+}
+
+# Function to remove model setting
+remove_model() {
+    if [ -f "$USER_SETTINGS_FILE" ]; then
+        jq 'del(.env.CLAUDE_MEM_MODEL)' "$USER_SETTINGS_FILE" > tmp.json && mv tmp.json "$USER_SETTINGS_FILE"
+        echo "Removed CLAUDE_MEM_MODEL (will use default: claude-sonnet-4-5)"
+    fi
+}
+
+# Function to list available models
+list_models() {
+    echo "Available models:"
+    echo "  claude-haiku-4-5     - Fast and efficient"
+    echo "  claude-sonnet-4-5    - Balanced (default)"
+    echo "  claude-opus-4        - Most capable"
+    echo "  claude-3-7-sonnet    - Alternative version"
+}
+
+# Interactive menu
+show_menu() {
+    echo "Claude Mem Plugin - Model Configuration"
+    echo "======================================"
+    echo "Current model: $(get_model)"
+    echo "Settings file: $USER_SETTINGS_FILE"
+    echo ""
+    echo "1) Set model"
+    echo "2) Remove model setting (use default)"
+    echo "3) List available models"
+    echo "4) Exit"
+    echo ""
+}
+
+# Main interactive loop
+main() {
+    check_jq
+
+    while true; do
+        show_menu
+        read -p "Choose an option (1-4): " choice
+
+        case $choice in
+            1)
+                list_models
+                echo ""
+                read -p "Enter model name: " model
+                set_model "$model"
+                ;;
+            2)
+                remove_model
+                ;;
+            3)
+                list_models
+                ;;
+            4)
+                echo "Goodbye!"
+                exit 0
+                ;;
+            *)
+                echo "Invalid option. Please choose 1-4."
+                ;;
+        esac
+        echo ""
+        read -p "Press Enter to continue..."
+    done
+}
+
+# Run main if script is executed directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi

plugin/scripts/cleanup-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import F from"better-sqlite3";import{join as i,dirname as U,basename as q}from"path";import{homedir as f}from"os";import{existsSync as z,mkdirSync as X}from"fs";import{fileURLToPath as w}from"url";function M(){return typeof __dirname<"u"?__dirname:U(w(import.meta.url))}var P=M(),d=process.env.CLAUDE_MEM_DATA_DIR||i(f(),".claude-mem"),l=process.env.CLAUDE_CONFIG_DIR||i(f(),".claude"),ee=i(d,"archives"),se=i(d,"logs"),te=i(d,"trash"),re=i(d,"backups"),ne=i(d,"settings.json"),I=i(d,"claude-mem.db"),oe=i(l,"settings.json"),ie=i(l,"commands"),ae=i(l,"CLAUDE.md");function O(o){X(o,{recursive:!0})}function L(){return i(P,"..","..")}var _=(n=>(n[n.DEBUG=0]="DEBUG",n[n.INFO=1]="INFO",n[n.WARN=2]="WARN",n[n.ERROR=3]="ERROR",n[n.SILENT=4]="SILENT",n))(_||{}),T=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=_[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,s){return`obs-${e}-${s}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
-${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Object.keys(e);return s.length===0?"{}":s.length<=3?JSON.stringify(e):`{${s.length} keys: ${s.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,s){if(!s)return e;try{let t=typeof s=="string"?JSON.parse(s):s;if(e==="Bash"&&t.command){let r=t.command.length>50?t.command.substring(0,50)+"...":t.command;return`${e}(${r})`}if(e==="Read"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Edit"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Write"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,s,t,r,n){if(e<this.level)return;let a=new Date().toISOString().replace("T"," ").substring(0,23),p=_[e].padEnd(5),c=s.padEnd(6),m="";r?.correlationId?m=`[${r.correlationId}] `:r?.sessionId&&(m=`[session-${r.sessionId}] `);let u="";n!=null&&(this.level===0&&typeof n=="object"?u=`
-`+JSON.stringify(n,null,2):u=" "+this.formatData(n));let N="";if(r){let{sessionId:B,sdkSessionId:G,correlationId:$,...R}=r;Object.keys(R).length>0&&(N=` {${Object.entries(R).map(([y,x])=>`${y}=${x}`).join(", ")}}`)}let h=`[${a}] [${p}] [${c}] ${m}${t}${N}${u}`;e===3?console.error(h):console.log(h)}debug(e,s,t,r){this.log(0,e,s,t,r)}info(e,s,t,r){this.log(1,e,s,t,r)}warn(e,s,t,r){this.log(2,e,s,t,r)}error(e,s,t,r){this.log(3,e,s,t,r)}dataIn(e,s,t,r){this.info(e,`\u2192 ${s}`,t,r)}dataOut(e,s,t,r){this.info(e,`\u2190 ${s}`,t,r)}success(e,s,t,r){this.info(e,`\u2713 ${s}`,t,r)}failure(e,s,t,r){this.error(e,`\u2717 ${s}`,t,r)}timing(e,s,t,r){this.info(e,`\u23F1 ${s}`,r,{duration:`${t}ms`})}},v=new T;var E=class{db;constructor(){O(d),this.db=new F(I),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable()}initializeSchema(){try{this.db.exec(`
+import{stdin as N}from"process";import F from"better-sqlite3";import{join as p,dirname as x,basename as Y}from"path";import{homedir as h}from"os";import{existsSync as Q,mkdirSync as U}from"fs";import{fileURLToPath as w}from"url";function X(){return typeof __dirname<"u"?__dirname:x(w(import.meta.url))}var M=X(),c=process.env.CLAUDE_MEM_DATA_DIR||p(h(),".claude-mem"),u=process.env.CLAUDE_CONFIG_DIR||p(h(),".claude"),Z=p(c,"archives"),ee=p(c,"logs"),se=p(c,"trash"),te=p(c,"backups"),re=p(c,"settings.json"),I=p(c,"claude-mem.db"),ne=p(u,"settings.json"),oe=p(u,"commands"),ie=p(u,"CLAUDE.md");function O(o){U(o,{recursive:!0})}function L(){return p(M,"..","..")}var l=(n=>(n[n.DEBUG=0]="DEBUG",n[n.INFO=1]="INFO",n[n.WARN=2]="WARN",n[n.ERROR=3]="ERROR",n[n.SILENT=4]="SILENT",n))(l||{}),T=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=l[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,s){return`obs-${e}-${s}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
+${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Object.keys(e);return s.length===0?"{}":s.length<=3?JSON.stringify(e):`{${s.length} keys: ${s.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,s){if(!s)return e;try{let t=typeof s=="string"?JSON.parse(s):s;if(e==="Bash"&&t.command){let r=t.command.length>50?t.command.substring(0,50)+"...":t.command;return`${e}(${r})`}if(e==="Read"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Edit"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Write"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,s,t,r,n){if(e<this.level)return;let i=new Date().toISOString().replace("T"," ").substring(0,23),a=l[e].padEnd(5),d=s.padEnd(6),E="";r?.correlationId?E=`[${r.correlationId}] `:r?.sessionId&&(E=`[session-${r.sessionId}] `);let _="";n!=null&&(this.level===0&&typeof n=="object"?_=`
+`+JSON.stringify(n,null,2):_=" "+this.formatData(n));let b="";if(r){let{sessionId:H,sdkSessionId:B,correlationId:j,...f}=r;Object.keys(f).length>0&&(b=` {${Object.entries(f).map(([D,y])=>`${D}=${y}`).join(", ")}}`)}let R=`[${i}] [${a}] [${d}] ${E}${t}${b}${_}`;e===3?console.error(R):console.log(R)}debug(e,s,t,r){this.log(0,e,s,t,r)}info(e,s,t,r){this.log(1,e,s,t,r)}warn(e,s,t,r){this.log(2,e,s,t,r)}error(e,s,t,r){this.log(3,e,s,t,r)}dataIn(e,s,t,r){this.info(e,`\u2192 ${s}`,t,r)}dataOut(e,s,t,r){this.info(e,`\u2190 ${s}`,t,r)}success(e,s,t,r){this.info(e,`\u2713 ${s}`,t,r)}failure(e,s,t,r){this.error(e,`\u2717 ${s}`,t,r)}timing(e,s,t,r){this.info(e,`\u23F1 ${s}`,r,{duration:`${t}ms`})}},A=new T;var m=class{db;constructor(){O(c),this.db=new F(I),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable(),this.createUserPromptsTable()}initializeSchema(){try{this.db.exec(`
         CREATE TABLE IF NOT EXISTS schema_versions (
           id INTEGER PRIMARY KEY,
           version INTEGER UNIQUE NOT NULL,
@@ -63,7 +63,7 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
           CREATE INDEX IF NOT EXISTS idx_session_summaries_sdk_session ON session_summaries(sdk_session_id);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_project ON session_summaries(project);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_created ON session_summaries(created_at_epoch DESC);
-        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(c=>c.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(c=>c.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(c=>c.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(d=>d.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
           CREATE TABLE session_summaries_new (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             sdk_session_id TEXT NOT NULL,
@@ -129,7 +129,44 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
           CREATE INDEX idx_observations_project ON observations(project);
           CREATE INDEX idx_observations_type ON observations(type);
           CREATE INDEX idx_observations_created ON observations(created_at_epoch DESC);
-        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}getRecentSummaries(e,s=10){return this.db.prepare(`
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}createUserPromptsTable(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(10))return;if(this.db.pragma("table_info(user_prompts)").length>0){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString());return}console.error("[SessionStore] Creating user_prompts table with FTS5 support..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+          CREATE TABLE user_prompts (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            claude_session_id TEXT NOT NULL,
+            prompt_number INTEGER NOT NULL,
+            prompt_text TEXT NOT NULL,
+            created_at TEXT NOT NULL,
+            created_at_epoch INTEGER NOT NULL,
+            FOREIGN KEY(claude_session_id) REFERENCES sdk_sessions(claude_session_id) ON DELETE CASCADE
+          );
+
+          CREATE INDEX idx_user_prompts_claude_session ON user_prompts(claude_session_id);
+          CREATE INDEX idx_user_prompts_created ON user_prompts(created_at_epoch DESC);
+          CREATE INDEX idx_user_prompts_prompt_number ON user_prompts(prompt_number);
+        `),this.db.exec(`
+          CREATE VIRTUAL TABLE user_prompts_fts USING fts5(
+            prompt_text,
+            content='user_prompts',
+            content_rowid='id'
+          );
+        `),this.db.exec(`
+          CREATE TRIGGER user_prompts_ai AFTER INSERT ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_ad AFTER DELETE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_au AFTER UPDATE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString()),console.error("[SessionStore] Successfully created user_prompts table with FTS5 support")}catch(t){throw this.db.exec("ROLLBACK"),t}}catch(e){console.error("[SessionStore] Migration error (create user_prompts table):",e.message)}}getRecentSummaries(e,s=10){return this.db.prepare(`
       SELECT
         request, investigated, learned, completed, next_steps,
         files_read, files_edited, notes, prompt_number, created_at
@@ -137,6 +174,14 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       WHERE project = ?
       ORDER BY created_at_epoch DESC
       LIMIT ?
+    `).all(e,s)}getRecentSummariesWithSessionInfo(e,s=3){return this.db.prepare(`
+      SELECT
+        sdk_session_id, request, learned, completed, next_steps,
+        prompt_number, created_at
+      FROM session_summaries
+      WHERE project = ?
+      ORDER BY created_at_epoch DESC
+      LIMIT ?
     `).all(e,s)}getRecentObservations(e,s=20){return this.db.prepare(`
       SELECT type, text, prompt_number, created_at
       FROM observations
@@ -173,8 +218,12 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       WHERE sdk_session_id = ?
       ORDER BY created_at_epoch DESC
       LIMIT 1
-    `).get(e)||null}getSessionById(e){return this.db.prepare(`
-      SELECT id, sdk_session_id, project, user_prompt
+    `).get(e)||null}getFilesForSession(e){let t=this.db.prepare(`
+      SELECT files_read, files_modified
+      FROM observations
+      WHERE sdk_session_id = ?
+    `).all(e),r=new Set,n=new Set;for(let i of t){if(i.files_read)try{let a=JSON.parse(i.files_read);Array.isArray(a)&&a.forEach(d=>r.add(d))}catch{}if(i.files_modified)try{let a=JSON.parse(i.files_modified);Array.isArray(a)&&a.forEach(d=>n.add(d))}catch{}}return{filesRead:Array.from(r),filesModified:Array.from(n)}}getSessionById(e){return this.db.prepare(`
+      SELECT id, claude_session_id, sdk_session_id, project, user_prompt
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
@@ -200,15 +249,17 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
     `).get(e)?.prompt_counter||1}getPromptCounter(e){return this.db.prepare(`
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
-    `).get(e)?.prompt_counter||0}createSDKSession(e,s,t){let r=new Date,n=r.getTime();return this.db.prepare(`
-      INSERT INTO sdk_sessions
-      (claude_session_id, project, user_prompt, started_at, started_at_epoch, status)
-      VALUES (?, ?, ?, ?, ?, 'active')
-    `).run(e,s,t,r.toISOString(),n).lastInsertRowid}updateSDKSessionId(e,s){return this.db.prepare(`
+    `).get(e)?.prompt_counter||0}createSDKSession(e,s,t){let r=new Date,n=r.getTime(),a=this.db.prepare(`
+      INSERT OR IGNORE INTO sdk_sessions
+      (claude_session_id, sdk_session_id, project, user_prompt, started_at, started_at_epoch, status)
+      VALUES (?, ?, ?, ?, ?, ?, 'active')
+    `).run(e,e,s,t,r.toISOString(),n);return a.lastInsertRowid===0||a.changes===0?this.db.prepare(`
+        SELECT id FROM sdk_sessions WHERE claude_session_id = ? LIMIT 1
+      `).get(e).id:a.lastInsertRowid}updateSDKSessionId(e,s){return this.db.prepare(`
       UPDATE sdk_sessions
       SET sdk_session_id = ?
       WHERE id = ? AND sdk_session_id IS NULL
-    `).run(s,e).changes===0?(v.debug("DB","sdk_session_id already set, skipping update",{sessionId:e,sdkSessionId:s}),!1):!0}setWorkerPort(e,s){this.db.prepare(`
+    `).run(s,e).changes===0?(A.debug("DB","sdk_session_id already set, skipping update",{sessionId:e,sdkSessionId:s}),!1):!0}setWorkerPort(e,s){this.db.prepare(`
       UPDATE sdk_sessions
       SET worker_port = ?
       WHERE id = ?
@@ -217,17 +268,33 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
-    `).get(e)?.worker_port||null}storeObservation(e,s,t,r){let n=new Date,a=n.getTime();this.db.prepare(`
+    `).get(e)?.worker_port||null}saveUserPrompt(e,s,t){let r=new Date,n=r.getTime();return this.db.prepare(`
+      INSERT INTO user_prompts
+      (claude_session_id, prompt_number, prompt_text, created_at, created_at_epoch)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(e,s,t,r.toISOString(),n).lastInsertRowid}storeObservation(e,s,t,r){let n=new Date,i=n.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,s,n.toISOString(),i),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO observations
       (sdk_session_id, project, type, title, subtitle, facts, narrative, concepts,
        files_read, files_modified, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,s,t.type,t.title,t.subtitle,JSON.stringify(t.facts),t.narrative,JSON.stringify(t.concepts),JSON.stringify(t.files_read),JSON.stringify(t.files_modified),r||null,n.toISOString(),a)}storeSummary(e,s,t,r){let n=new Date,a=n.getTime();this.db.prepare(`
+    `).run(e,s,t.type,t.title,t.subtitle,JSON.stringify(t.facts),t.narrative,JSON.stringify(t.concepts),JSON.stringify(t.files_read),JSON.stringify(t.files_modified),r||null,n.toISOString(),i)}storeSummary(e,s,t,r){let n=new Date,i=n.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,s,n.toISOString(),i),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO session_summaries
       (sdk_session_id, project, request, investigated, learned, completed,
        next_steps, notes, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,s,t.request,t.investigated,t.learned,t.completed,t.next_steps,t.notes,r||null,n.toISOString(),a)}markSessionCompleted(e){let s=new Date,t=s.getTime();this.db.prepare(`
+    `).run(e,s,t.request,t.investigated,t.learned,t.completed,t.next_steps,t.notes,r||null,n.toISOString(),i)}markSessionCompleted(e){let s=new Date,t=s.getTime();this.db.prepare(`
       UPDATE sdk_sessions
       SET status = 'completed', completed_at = ?, completed_at_epoch = ?
       WHERE id = ?
@@ -239,5 +306,5 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       UPDATE sdk_sessions
       SET status = 'failed', completed_at = ?, completed_at_epoch = ?
       WHERE status = 'active'
-    `).run(e.toISOString(),s).changes}close(){this.db.close()}};import g from"path";import{existsSync as S}from"fs";import{spawn as H}from"child_process";var W=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),j=`http://127.0.0.1:${W}/health`;async function A(){try{return(await fetch(j,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function k(){try{if(await A())return!0;console.error("[claude-mem] Worker not responding, starting...");let o=L(),e=g.join(o,"plugin","scripts","worker-service.cjs");if(!S(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let s=g.join(o,"ecosystem.config.cjs"),t=g.join(o,"node_modules",".bin","pm2");if(!S(t))throw new Error(`PM2 binary not found at ${t}. This is a bundled dependency - try running: npm install`);if(!S(s))throw new Error(`PM2 ecosystem config not found at ${s}. Plugin installation may be corrupted.`);let r=H(t,["start",s],{detached:!0,stdio:"ignore",cwd:o});r.on("error",n=>{throw new Error(`Failed to spawn PM2: ${n.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let n=0;n<3;n++)if(await new Promise(a=>setTimeout(a,500)),await A())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(o){return console.error(`[claude-mem] Failed to start worker: ${o.message}`),!1}}async function C(o){try{console.error("[claude-mem cleanup] Hook fired",{input:o?{session_id:o.session_id,cwd:o.cwd,reason:o.reason}:null}),o||(console.log("No input provided - this script is designed to run as a Claude Code SessionEnd hook"),console.log(`
-Expected input format:`),console.log(JSON.stringify({session_id:"string",cwd:"string",transcript_path:"string",hook_event_name:"SessionEnd",reason:"exit"},null,2)),process.exit(0));let{session_id:e,reason:s}=o;console.error("[claude-mem cleanup] Searching for active SDK session",{session_id:e,reason:s}),await k()||console.error("[claude-mem cleanup] Worker not available - skipping HTTP cleanup");let r=new E,n=r.findActiveSDKSession(e);n||(console.error("[claude-mem cleanup] No active SDK session found",{session_id:e}),r.close(),console.log('{"continue": true, "suppressOutput": true}'),process.exit(0)),console.error("[claude-mem cleanup] Active SDK session found",{session_id:n.id,sdk_session_id:n.sdk_session_id,project:n.project,worker_port:n.worker_port});try{r.markSessionCompleted(n.id),console.error("[claude-mem cleanup] Session marked as completed in database")}catch(a){console.error("[claude-mem cleanup] Failed to mark session as completed:",a)}r.close(),console.error("[claude-mem cleanup] Cleanup completed successfully"),console.log('{"continue": true, "suppressOutput": true}'),process.exit(0)}catch(e){console.error("[claude-mem cleanup] Unexpected error in hook",{error:e.message,stack:e.stack,name:e.name}),console.log('{"continue": true, "suppressOutput": true}'),process.exit(0)}}import{stdin as D}from"process";var b="";D.on("data",o=>b+=o);D.on("end",async()=>{try{let o=b.trim()?JSON.parse(b):void 0;await C(o)}catch(o){console.error(`[claude-mem cleanup-hook error: ${o.message}]`),console.log('{"continue": true, "suppressOutput": true}'),process.exit(0)}});
+    `).run(e.toISOString(),s).changes}close(){this.db.close()}};import S from"path";import{existsSync as g}from"fs";import{spawn as P}from"child_process";var G=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),W=`http://127.0.0.1:${G}/health`;async function v(){try{return(await fetch(W,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function C(){try{if(await v())return!0;console.error("[claude-mem] Worker not responding, starting...");let o=L(),e=S.join(o,"plugin","scripts","worker-service.cjs");if(!g(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let s=S.join(o,"ecosystem.config.cjs"),t=S.join(o,"node_modules",".bin","pm2");if(!g(t))throw new Error(`PM2 binary not found at ${t}. This is a bundled dependency - try running: npm install`);if(!g(s))throw new Error(`PM2 ecosystem config not found at ${s}. Plugin installation may be corrupted.`);let r=P(t,["start",s],{detached:!0,stdio:"ignore",cwd:o});r.on("error",n=>{throw new Error(`Failed to spawn PM2: ${n.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let n=0;n<3;n++)if(await new Promise(i=>setTimeout(i,500)),await v())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(o){return console.error(`[claude-mem] Failed to start worker: ${o.message}`),!1}}async function k(o){console.error("[claude-mem cleanup] Hook fired",{input:o?{session_id:o.session_id,cwd:o.cwd,reason:o.reason}:null}),o||(console.log("No input provided - this script is designed to run as a Claude Code SessionEnd hook"),console.log(`
+Expected input format:`),console.log(JSON.stringify({session_id:"string",cwd:"string",transcript_path:"string",hook_event_name:"SessionEnd",reason:"exit"},null,2)),process.exit(0));let{session_id:e,reason:s}=o;console.error("[claude-mem cleanup] Searching for active SDK session",{session_id:e,reason:s}),await C()||console.error("[claude-mem cleanup] Worker not available - skipping HTTP cleanup");let r=new m,n=r.findActiveSDKSession(e);n||(console.error("[claude-mem cleanup] No active SDK session found",{session_id:e}),r.close(),console.log('{"continue": true, "suppressOutput": true}'),process.exit(0)),console.error("[claude-mem cleanup] Active SDK session found",{session_id:n.id,sdk_session_id:n.sdk_session_id,project:n.project,worker_port:n.worker_port}),r.markSessionCompleted(n.id),console.error("[claude-mem cleanup] Session marked as completed in database"),r.close(),console.error("[claude-mem cleanup] Cleanup completed successfully"),console.log('{"continue": true, "suppressOutput": true}'),process.exit(0)}if(N.isTTY)k(void 0);else{let o="";N.on("data",e=>o+=e),N.on("end",async()=>{let e=o?JSON.parse(o):void 0;await k(e)})}

plugin/scripts/context-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import W from"path";import F from"better-sqlite3";import{join as p,dirname as x,basename as q}from"path";import{homedir as I}from"os";import{existsSync as z,mkdirSync as U}from"fs";import{fileURLToPath as X}from"url";function w(){return typeof __dirname<"u"?__dirname:x(X(import.meta.url))}var M=w(),u=process.env.CLAUDE_MEM_DATA_DIR||p(I(),".claude-mem"),_=process.env.CLAUDE_CONFIG_DIR||p(I(),".claude"),ee=p(u,"archives"),se=p(u,"logs"),te=p(u,"trash"),re=p(u,"backups"),ne=p(u,"settings.json"),O=p(u,"claude-mem.db"),oe=p(_,"settings.json"),ie=p(_,"commands"),ae=p(_,"CLAUDE.md");function L(a){U(a,{recursive:!0})}function v(){return p(M,"..","..")}var l=(r=>(r[r.DEBUG=0]="DEBUG",r[r.INFO=1]="INFO",r[r.WARN=2]="WARN",r[r.ERROR=3]="ERROR",r[r.SILENT=4]="SILENT",r))(l||{}),T=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=l[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,t){return`obs-${e}-${t}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
-${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Object.keys(e);return t.length===0?"{}":t.length<=3?JSON.stringify(e):`{${t.length} keys: ${t.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,t){if(!t)return e;try{let s=typeof t=="string"?JSON.parse(t):t;if(e==="Bash"&&s.command){let n=s.command.length>50?s.command.substring(0,50)+"...":s.command;return`${e}(${n})`}if(e==="Read"&&s.file_path){let n=s.file_path.split("/").pop()||s.file_path;return`${e}(${n})`}if(e==="Edit"&&s.file_path){let n=s.file_path.split("/").pop()||s.file_path;return`${e}(${n})`}if(e==="Write"&&s.file_path){let n=s.file_path.split("/").pop()||s.file_path;return`${e}(${n})`}return e}catch{return e}}log(e,t,s,n,r){if(e<this.level)return;let i=new Date().toISOString().replace("T"," ").substring(0,23),o=l[e].padEnd(5),d=t.padEnd(6),m="";n?.correlationId?m=`[${n.correlationId}] `:n?.sessionId&&(m=`[session-${n.sessionId}] `);let c="";r!=null&&(this.level===0&&typeof r=="object"?c=`
-`+JSON.stringify(r,null,2):c=" "+this.formatData(r));let b="";if(n){let{sessionId:H,sdkSessionId:B,correlationId:G,...R}=n;Object.keys(R).length>0&&(b=` {${Object.entries(R).map(([D,y])=>`${D}=${y}`).join(", ")}}`)}let N=`[${i}] [${o}] [${d}] ${m}${s}${b}${c}`;e===3?console.error(N):console.log(N)}debug(e,t,s,n){this.log(0,e,t,s,n)}info(e,t,s,n){this.log(1,e,t,s,n)}warn(e,t,s,n){this.log(2,e,t,s,n)}error(e,t,s,n){this.log(3,e,t,s,n)}dataIn(e,t,s,n){this.info(e,`\u2192 ${t}`,s,n)}dataOut(e,t,s,n){this.info(e,`\u2190 ${t}`,s,n)}success(e,t,s,n){this.info(e,`\u2713 ${t}`,s,n)}failure(e,t,s,n){this.error(e,`\u2717 ${t}`,s,n)}timing(e,t,s,n){this.info(e,`\u23F1 ${t}`,n,{duration:`${s}ms`})}},A=new T;var E=class{db;constructor(){L(u),this.db=new F(O),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable()}initializeSchema(){try{this.db.exec(`
+import W from"path";import{stdin as P}from"process";import de from"better-sqlite3";import{join as T,dirname as re,basename as fe}from"path";import{homedir as j}from"os";import{existsSync as Re,mkdirSync as ne}from"fs";import{fileURLToPath as ie}from"url";function oe(){return typeof __dirname<"u"?__dirname:re(ie(import.meta.url))}var ae=oe(),I=process.env.CLAUDE_MEM_DATA_DIR||T(j(),".claude-mem"),U=process.env.CLAUDE_CONFIG_DIR||T(j(),".claude"),Oe=T(I,"archives"),Le=T(I,"logs"),ve=T(I,"trash"),Ae=T(I,"backups"),ye=T(I,"settings.json"),Y=T(I,"claude-mem.db"),De=T(U,"settings.json"),Ce=T(U,"commands"),ke=T(U,"CLAUDE.md");function K(a){ne(a,{recursive:!0})}function V(){return T(ae,"..","..")}var $=(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=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=$[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,t){return`obs-${e}-${t}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
+${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Object.keys(e);return t.length===0?"{}":t.length<=3?JSON.stringify(e):`{${t.length} keys: ${t.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,t){if(!t)return e;try{let s=typeof t=="string"?JSON.parse(t):t;if(e==="Bash"&&s.command){let r=s.command.length>50?s.command.substring(0,50)+"...":s.command;return`${e}(${r})`}if(e==="Read"&&s.file_path){let r=s.file_path.split("/").pop()||s.file_path;return`${e}(${r})`}if(e==="Edit"&&s.file_path){let r=s.file_path.split("/").pop()||s.file_path;return`${e}(${r})`}if(e==="Write"&&s.file_path){let r=s.file_path.split("/").pop()||s.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,t,s,r,o){if(e<this.level)return;let c=new Date().toISOString().replace("T"," ").substring(0,23),p=$[e].padEnd(5),u=t.padEnd(6),O="";r?.correlationId?O=`[${r.correlationId}] `:r?.sessionId&&(O=`[session-${r.sessionId}] `);let b="";o!=null&&(this.level===0&&typeof o=="object"?b=`
+`+JSON.stringify(o,null,2):b=" "+this.formatData(o));let n="";if(r){let{sessionId:h,sdkSessionId:k,correlationId:L,...D}=r;Object.keys(D).length>0&&(n=` {${Object.entries(D).map(([d,m])=>`${d}=${m}`).join(", ")}}`)}let N=`[${c}] [${p}] [${u}] ${O}${s}${n}${b}`;e===3?console.error(N):console.log(N)}debug(e,t,s,r){this.log(0,e,t,s,r)}info(e,t,s,r){this.log(1,e,t,s,r)}warn(e,t,s,r){this.log(2,e,t,s,r)}error(e,t,s,r){this.log(3,e,t,s,r)}dataIn(e,t,s,r){this.info(e,`\u2192 ${t}`,s,r)}dataOut(e,t,s,r){this.info(e,`\u2190 ${t}`,s,r)}success(e,t,s,r){this.info(e,`\u2713 ${t}`,s,r)}failure(e,t,s,r){this.error(e,`\u2717 ${t}`,s,r)}timing(e,t,s,r){this.info(e,`\u23F1 ${t}`,r,{duration:`${s}ms`})}},q=new M;var C=class{db;constructor(){K(I),this.db=new de(Y),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable(),this.createUserPromptsTable()}initializeSchema(){try{this.db.exec(`
         CREATE TABLE IF NOT EXISTS schema_versions (
           id INTEGER PRIMARY KEY,
           version INTEGER UNIQUE NOT NULL,
@@ -63,7 +63,7 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
           CREATE INDEX IF NOT EXISTS idx_session_summaries_sdk_session ON session_summaries(sdk_session_id);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_project ON session_summaries(project);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_created ON session_summaries(created_at_epoch DESC);
-        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(n=>n.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(d=>d.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(n=>n.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(u=>u.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(u=>u.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(u=>u.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
           CREATE TABLE session_summaries_new (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             sdk_session_id TEXT NOT NULL,
@@ -91,7 +91,7 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
           CREATE INDEX idx_session_summaries_sdk_session ON session_summaries(sdk_session_id);
           CREATE INDEX idx_session_summaries_project ON session_summaries(project);
           CREATE INDEX idx_session_summaries_created ON session_summaries(created_at_epoch DESC);
-        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString()),console.error("[SessionStore] Successfully removed UNIQUE constraint from session_summaries.sdk_session_id")}catch(n){throw this.db.exec("ROLLBACK"),n}}catch(e){console.error("[SessionStore] Migration error (remove UNIQUE constraint):",e.message)}}addObservationHierarchicalFields(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(8))return;if(this.db.pragma("table_info(observations)").some(n=>n.name==="title")){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(8,new Date().toISOString());return}console.error("[SessionStore] Adding hierarchical fields to observations table..."),this.db.exec(`
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString()),console.error("[SessionStore] Successfully removed UNIQUE constraint from session_summaries.sdk_session_id")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (remove UNIQUE constraint):",e.message)}}addObservationHierarchicalFields(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(8))return;if(this.db.pragma("table_info(observations)").some(r=>r.name==="title")){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(8,new Date().toISOString());return}console.error("[SessionStore] Adding hierarchical fields to observations table..."),this.db.exec(`
         ALTER TABLE observations ADD COLUMN title TEXT;
         ALTER TABLE observations ADD COLUMN subtitle TEXT;
         ALTER TABLE observations ADD COLUMN facts TEXT;
@@ -99,7 +99,7 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
         ALTER TABLE observations ADD COLUMN concepts TEXT;
         ALTER TABLE observations ADD COLUMN files_read TEXT;
         ALTER TABLE observations ADD COLUMN files_modified TEXT;
-      `),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(8,new Date().toISOString()),console.error("[SessionStore] Successfully added hierarchical fields to observations table")}catch(e){console.error("[SessionStore] Migration error (add hierarchical fields):",e.message)}}makeObservationsTextNullable(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(9))return;let s=this.db.pragma("table_info(observations)").find(n=>n.name==="text");if(!s||s.notnull===0){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString());return}console.error("[SessionStore] Making observations.text nullable..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+      `),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(8,new Date().toISOString()),console.error("[SessionStore] Successfully added hierarchical fields to observations table")}catch(e){console.error("[SessionStore] Migration error (add hierarchical fields):",e.message)}}makeObservationsTextNullable(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(9))return;let s=this.db.pragma("table_info(observations)").find(r=>r.name==="text");if(!s||s.notnull===0){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString());return}console.error("[SessionStore] Making observations.text nullable..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
           CREATE TABLE observations_new (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             sdk_session_id TEXT NOT NULL,
@@ -129,7 +129,44 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
           CREATE INDEX idx_observations_project ON observations(project);
           CREATE INDEX idx_observations_type ON observations(type);
           CREATE INDEX idx_observations_created ON observations(created_at_epoch DESC);
-        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(n){throw this.db.exec("ROLLBACK"),n}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}getRecentSummaries(e,t=10){return this.db.prepare(`
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}createUserPromptsTable(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(10))return;if(this.db.pragma("table_info(user_prompts)").length>0){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString());return}console.error("[SessionStore] Creating user_prompts table with FTS5 support..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+          CREATE TABLE user_prompts (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            claude_session_id TEXT NOT NULL,
+            prompt_number INTEGER NOT NULL,
+            prompt_text TEXT NOT NULL,
+            created_at TEXT NOT NULL,
+            created_at_epoch INTEGER NOT NULL,
+            FOREIGN KEY(claude_session_id) REFERENCES sdk_sessions(claude_session_id) ON DELETE CASCADE
+          );
+
+          CREATE INDEX idx_user_prompts_claude_session ON user_prompts(claude_session_id);
+          CREATE INDEX idx_user_prompts_created ON user_prompts(created_at_epoch DESC);
+          CREATE INDEX idx_user_prompts_prompt_number ON user_prompts(prompt_number);
+        `),this.db.exec(`
+          CREATE VIRTUAL TABLE user_prompts_fts USING fts5(
+            prompt_text,
+            content='user_prompts',
+            content_rowid='id'
+          );
+        `),this.db.exec(`
+          CREATE TRIGGER user_prompts_ai AFTER INSERT ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_ad AFTER DELETE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_au AFTER UPDATE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString()),console.error("[SessionStore] Successfully created user_prompts table with FTS5 support")}catch(s){throw this.db.exec("ROLLBACK"),s}}catch(e){console.error("[SessionStore] Migration error (create user_prompts table):",e.message)}}getRecentSummaries(e,t=10){return this.db.prepare(`
       SELECT
         request, investigated, learned, completed, next_steps,
         files_read, files_edited, notes, prompt_number, created_at
@@ -137,6 +174,14 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
       WHERE project = ?
       ORDER BY created_at_epoch DESC
       LIMIT ?
+    `).all(e,t)}getRecentSummariesWithSessionInfo(e,t=3){return this.db.prepare(`
+      SELECT
+        sdk_session_id, request, learned, completed, next_steps,
+        prompt_number, created_at
+      FROM session_summaries
+      WHERE project = ?
+      ORDER BY created_at_epoch DESC
+      LIMIT ?
     `).all(e,t)}getRecentObservations(e,t=20){return this.db.prepare(`
       SELECT type, text, prompt_number, created_at
       FROM observations
@@ -173,8 +218,12 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
       WHERE sdk_session_id = ?
       ORDER BY created_at_epoch DESC
       LIMIT 1
-    `).get(e)||null}getSessionById(e){return this.db.prepare(`
-      SELECT id, sdk_session_id, project, user_prompt
+    `).get(e)||null}getFilesForSession(e){let s=this.db.prepare(`
+      SELECT files_read, files_modified
+      FROM observations
+      WHERE sdk_session_id = ?
+    `).all(e),r=new Set,o=new Set;for(let c of s){if(c.files_read)try{let p=JSON.parse(c.files_read);Array.isArray(p)&&p.forEach(u=>r.add(u))}catch{}if(c.files_modified)try{let p=JSON.parse(c.files_modified);Array.isArray(p)&&p.forEach(u=>o.add(u))}catch{}}return{filesRead:Array.from(r),filesModified:Array.from(o)}}getSessionById(e){return this.db.prepare(`
+      SELECT id, claude_session_id, sdk_session_id, project, user_prompt
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
@@ -200,15 +249,17 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
     `).get(e)?.prompt_counter||1}getPromptCounter(e){return this.db.prepare(`
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
-    `).get(e)?.prompt_counter||0}createSDKSession(e,t,s){let n=new Date,r=n.getTime();return this.db.prepare(`
-      INSERT INTO sdk_sessions
-      (claude_session_id, project, user_prompt, started_at, started_at_epoch, status)
-      VALUES (?, ?, ?, ?, ?, 'active')
-    `).run(e,t,s,n.toISOString(),r).lastInsertRowid}updateSDKSessionId(e,t){return this.db.prepare(`
+    `).get(e)?.prompt_counter||0}createSDKSession(e,t,s){let r=new Date,o=r.getTime(),p=this.db.prepare(`
+      INSERT OR IGNORE INTO sdk_sessions
+      (claude_session_id, sdk_session_id, project, user_prompt, started_at, started_at_epoch, status)
+      VALUES (?, ?, ?, ?, ?, ?, 'active')
+    `).run(e,e,t,s,r.toISOString(),o);return p.lastInsertRowid===0||p.changes===0?this.db.prepare(`
+        SELECT id FROM sdk_sessions WHERE claude_session_id = ? LIMIT 1
+      `).get(e).id:p.lastInsertRowid}updateSDKSessionId(e,t){return this.db.prepare(`
       UPDATE sdk_sessions
       SET sdk_session_id = ?
       WHERE id = ? AND sdk_session_id IS NULL
-    `).run(t,e).changes===0?(A.debug("DB","sdk_session_id already set, skipping update",{sessionId:e,sdkSessionId:t}),!1):!0}setWorkerPort(e,t){this.db.prepare(`
+    `).run(t,e).changes===0?(q.debug("DB","sdk_session_id already set, skipping update",{sessionId:e,sdkSessionId:t}),!1):!0}setWorkerPort(e,t){this.db.prepare(`
       UPDATE sdk_sessions
       SET worker_port = ?
       WHERE id = ?
@@ -217,17 +268,33 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
-    `).get(e)?.worker_port||null}storeObservation(e,t,s,n){let r=new Date,i=r.getTime();this.db.prepare(`
+    `).get(e)?.worker_port||null}saveUserPrompt(e,t,s){let r=new Date,o=r.getTime();return this.db.prepare(`
+      INSERT INTO user_prompts
+      (claude_session_id, prompt_number, prompt_text, created_at, created_at_epoch)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(e,t,s,r.toISOString(),o).lastInsertRowid}storeObservation(e,t,s,r){let o=new Date,c=o.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,t,o.toISOString(),c),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO observations
       (sdk_session_id, project, type, title, subtitle, facts, narrative, concepts,
        files_read, files_modified, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,t,s.type,s.title,s.subtitle,JSON.stringify(s.facts),s.narrative,JSON.stringify(s.concepts),JSON.stringify(s.files_read),JSON.stringify(s.files_modified),n||null,r.toISOString(),i)}storeSummary(e,t,s,n){let r=new Date,i=r.getTime();this.db.prepare(`
+    `).run(e,t,s.type,s.title,s.subtitle,JSON.stringify(s.facts),s.narrative,JSON.stringify(s.concepts),JSON.stringify(s.files_read),JSON.stringify(s.files_modified),r||null,o.toISOString(),c)}storeSummary(e,t,s,r){let o=new Date,c=o.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,t,o.toISOString(),c),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO session_summaries
       (sdk_session_id, project, request, investigated, learned, completed,
        next_steps, notes, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,t,s.request,s.investigated,s.learned,s.completed,s.next_steps,s.notes,n||null,r.toISOString(),i)}markSessionCompleted(e){let t=new Date,s=t.getTime();this.db.prepare(`
+    `).run(e,t,s.request,s.investigated,s.learned,s.completed,s.next_steps,s.notes,r||null,o.toISOString(),c)}markSessionCompleted(e){let t=new Date,s=t.getTime();this.db.prepare(`
       UPDATE sdk_sessions
       SET status = 'completed', completed_at = ?, completed_at_epoch = ?
       WHERE id = ?
@@ -239,7 +306,26 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let t=Obje
       UPDATE sdk_sessions
       SET status = 'failed', completed_at = ?, completed_at_epoch = ?
       WHERE status = 'active'
-    `).run(e.toISOString(),t).changes}close(){this.db.close()}};import g from"path";import{existsSync as h}from"fs";import{spawn as P}from"child_process";var $=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),j=`http://127.0.0.1:${$}/health`;async function C(){try{return(await fetch(j,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function k(){try{if(await C())return!0;console.error("[claude-mem] Worker not responding, starting...");let a=v(),e=g.join(a,"plugin","scripts","worker-service.cjs");if(!h(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let t=g.join(a,"ecosystem.config.cjs"),s=g.join(a,"node_modules",".bin","pm2");if(!h(s))throw new Error(`PM2 binary not found at ${s}. This is a bundled dependency - try running: npm install`);if(!h(t))throw new Error(`PM2 ecosystem config not found at ${t}. Plugin installation may be corrupted.`);let n=P(s,["start",t],{detached:!0,stdio:"ignore",cwd:a});n.on("error",r=>{throw new Error(`Failed to spawn PM2: ${r.message}`)}),n.unref(),console.error("[claude-mem] Worker started with PM2");for(let r=0;r<3;r++)if(await new Promise(i=>setTimeout(i,500)),await C())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(a){return console.error(`[claude-mem] Failed to start worker: ${a.message}`),!1}}function S(a){k();let e=a?.cwd??process.cwd(),t=e?W.basename(e):"unknown-project",s=new E;try{let n=s.getRecentSessionsWithStatus(t,3);if(n.length===0)return`# Recent Session Context
+    `).run(e.toISOString(),t).changes}close(){this.db.close()}};import X from"path";import{existsSync as F}from"fs";import{spawn as ce}from"child_process";var pe=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),ue=`http://127.0.0.1:${pe}/health`;async function J(){try{return(await fetch(ue,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function Q(){try{if(await J())return!0;console.error("[claude-mem] Worker not responding, starting...");let a=V(),e=X.join(a,"plugin","scripts","worker-service.cjs");if(!F(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let t=X.join(a,"ecosystem.config.cjs"),s=X.join(a,"node_modules",".bin","pm2");if(!F(s))throw new Error(`PM2 binary not found at ${s}. This is a bundled dependency - try running: npm install`);if(!F(t))throw new Error(`PM2 ecosystem config not found at ${t}. Plugin installation may be corrupted.`);let r=ce(s,["start",t],{detached:!0,stdio:"ignore",cwd:a});r.on("error",o=>{throw new Error(`Failed to spawn PM2: ${o.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let o=0;o<3;o++)if(await new Promise(c=>setTimeout(c,500)),await J())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(a){return console.error(`[claude-mem] Failed to start worker: ${a.message}`),!1}}var i={reset:"\x1B[0m",bright:"\x1B[1m",dim:"\x1B[2m",cyan:"\x1B[36m",green:"\x1B[32m",yellow:"\x1B[33m",blue:"\x1B[34m",magenta:"\x1B[35m",gray:"\x1B[90m",red:"\x1B[31m"};function G(a){if(!a)return[];let e=JSON.parse(a);return Array.isArray(e)?e:[]}function le(a){return new Date(a).toLocaleString("en-US",{month:"short",day:"numeric",hour:"numeric",minute:"2-digit",hour12:!0})}function me(a){return new Date(a).toLocaleString("en-US",{hour:"numeric",minute:"2-digit",hour12:!0})}function _e(a){return new Date(a).toLocaleString("en-US",{month:"short",day:"numeric",year:"numeric"})}function Ee(a){return a?Math.ceil(a.length/4):0}function Te(a,e){return W.isAbsolute(a)?W.relative(e,a):a}function he(a,e){if(e.length===0)return[];let t=e.map(()=>"?").join(",");return a.db.prepare(`
+    SELECT
+      id, sdk_session_id, type, title, subtitle, narrative,
+      facts, concepts, files_read, files_modified,
+      created_at, created_at_epoch
+    FROM observations
+    WHERE sdk_session_id IN (${t})
+    ORDER BY created_at_epoch DESC
+  `).all(...e)}function z(a,e=!1,t=!1){Q();let s=a?.cwd??process.cwd(),r=s?W.basename(s):"unknown-project",o=new C,c=o.db.prepare(`
+    SELECT id, sdk_session_id, request, completed, next_steps, created_at, created_at_epoch
+    FROM session_summaries
+    WHERE project = ?
+    ORDER BY created_at_epoch DESC
+    LIMIT 4
+  `).all(r);if(c.length===0)return o.close(),e?`
+${i.bright}${i.cyan}\u{1F4DD} [${r}] recent context${i.reset}
+${i.gray}${"\u2500".repeat(60)}${i.reset}
 
-No previous sessions found for this project yet.`;let r=[];r.push("# Recent Session Context"),r.push(""),r.push(`Showing last ${n.length} session(s) for **${t}**:`),r.push("");for(let i of n)if(i.sdk_session_id){if(r.push("---"),r.push(""),i.has_summary){let o=s.getSummaryForSession(i.sdk_session_id);if(o){let d=o.prompt_number?` (Prompt #${o.prompt_number})`:"";if(r.push(`**Summary${d}**`),r.push(""),o.request&&r.push(`**Request:** ${o.request}`),o.completed&&r.push(`**Completed:** ${o.completed}`),o.learned&&r.push(`**Learned:** ${o.learned}`),o.next_steps&&r.push(`**Next Steps:** ${o.next_steps}`),o.files_read)try{let c=JSON.parse(o.files_read);Array.isArray(c)&&c.length>0&&r.push(`**Files Read:** ${c.join(", ")}`)}catch{o.files_read.trim()&&r.push(`**Files Read:** ${o.files_read}`)}if(o.files_edited)try{let c=JSON.parse(o.files_edited);Array.isArray(c)&&c.length>0&&r.push(`**Files Edited:** ${c.join(", ")}`)}catch{o.files_edited.trim()&&r.push(`**Files Edited:** ${o.files_edited}`)}let m=new Date(o.created_at).toLocaleString();r.push(`**Date:** ${m}`)}}else if(i.status==="active"){r.push("**In Progress**"),r.push(""),i.user_prompt&&r.push(`**Request:** ${i.user_prompt}`);let o=s.getObservationsForSession(i.sdk_session_id);if(o.length>0){r.push(""),r.push(`**Observations (${o.length}):**`);for(let m of o)r.push(`- ${m.title}`)}else r.push(""),r.push("*No observations yet*");r.push(""),r.push("**Status:** Active - summary pending");let d=new Date(i.started_at).toLocaleString();r.push(`**Date:** ${d}`)}else{let o=i.status==="failed"?"stopped":i.status;r.push(`**${o.charAt(0).toUpperCase()+o.slice(1)}**`),r.push(""),i.user_prompt&&r.push(`**Request:** ${i.user_prompt}`),r.push(""),r.push(`**Status:** ${o} - no summary available`);let d=new Date(i.started_at).toLocaleString();r.push(`**Date:** ${d}`)}r.push("")}return r.join(`
-`)}finally{s.close()}}import{stdin as f}from"process";try{if(f.isTTY){let e={hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:S()}};console.log(JSON.stringify(e)),process.exit(0)}else{let a="";f.on("data",e=>a+=e),f.on("end",()=>{let e=a.trim()?JSON.parse(a):void 0,s={hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:S(e)}};console.log(JSON.stringify(s)),process.exit(0)})}}catch(a){console.error(`[claude-mem context-hook error: ${a.message}]`),process.exit(0)}
+${i.dim}No previous sessions found for this project yet.${i.reset}
+`:`# [${r}] recent context
+
+No previous sessions found for this project yet.`;let p=c.slice(0,3),u=[...new Set(p.map(N=>N.sdk_session_id))],b=he(o,u).filter(N=>{let h=G(N.concepts);return h.includes("what-changed")||h.includes("how-it-works")||h.includes("problem-solution")||h.includes("gotcha")||h.includes("discovery")||h.includes("why-it-exists")||h.includes("decision")||h.includes("trade-off")}),n=[];if(e?(n.push(""),n.push(`${i.bright}${i.cyan}\u{1F4DD} [${r}] recent context${i.reset}`),n.push(`${i.gray}${"\u2500".repeat(60)}${i.reset}`),n.push("")):(n.push(`# [${r}] recent context`),n.push("")),b.length>0){e?(n.push(`${i.dim}Legend: \u{1F3AF} session-request | \u{1F534} gotcha | \u{1F7E1} problem-solution | \u{1F535} how-it-works | \u{1F7E2} what-changed | \u{1F7E3} discovery | \u{1F7E0} why-it-exists | \u{1F7E4} decision | \u2696\uFE0F trade-off${i.reset}`),n.push("")):(n.push("**Legend:** \u{1F3AF} session-request | \u{1F534} gotcha | \u{1F7E1} problem-solution | \u{1F535} how-it-works | \u{1F7E2} what-changed | \u{1F7E3} discovery | \u{1F7E0} why-it-exists | \u{1F7E4} decision | \u2696\uFE0F trade-off"),n.push("")),e?(n.push(`${i.dim}\u{1F4A1} Progressive Disclosure: This index shows WHAT exists (titles) and retrieval COST (token counts).${i.reset}`),n.push(`${i.dim}   \u2192 Use MCP search tools to fetch full observation details on-demand (Layer 2)${i.reset}`),n.push(`${i.dim}   \u2192 Prefer searching observations over re-reading code for past decisions and learnings${i.reset}`),n.push(`${i.dim}   \u2192 Critical types (\u{1F534} gotcha, \u{1F7E4} decision, \u2696\uFE0F trade-off) often worth fetching immediately${i.reset}`),n.push("")):(n.push("\u{1F4A1} **Progressive Disclosure:** This index shows WHAT exists (titles) and retrieval COST (token counts)."),n.push("- Use MCP search tools to fetch full observation details on-demand (Layer 2)"),n.push("- Prefer searching observations over re-reading code for past decisions and learnings"),n.push("- Critical types (\u{1F534} gotcha, \u{1F7E4} decision, \u2696\uFE0F trade-off) often worth fetching immediately"),n.push(""));let N=c[0]?.id,h=p.map((d,m)=>{let l=m===0?null:c[m+1];return{...d,displayEpoch:l?l.created_at_epoch:d.created_at_epoch,displayTime:l?l.created_at:d.created_at,isMostRecent:d.id===N}}),k=[...b.map(d=>({type:"observation",data:d})),...h.map(d=>({type:"summary",data:d}))];k.sort((d,m)=>{let l=d.type==="observation"?d.data.created_at_epoch:d.data.displayEpoch,R=m.type==="observation"?m.data.created_at_epoch:m.data.displayEpoch;return l-R});let L=new Map;for(let d of k){let m=d.type==="observation"?d.data.created_at:d.data.displayTime,l=_e(m);L.has(l)||L.set(l,[]),L.get(l).push(d)}let D=Array.from(L.entries()).sort((d,m)=>{let l=new Date(d[0]).getTime(),R=new Date(m[0]).getTime();return l-R});for(let[d,m]of D){e?(n.push(`${i.bright}${i.cyan}${d}${i.reset}`),n.push("")):(n.push(`### ${d}`),n.push(""));let l=null,R="",v=!1;for(let x of m)if(x.type==="summary"){v&&(n.push(""),v=!1,l=null,R="");let _=x.data,A=`${_.request||"Session started"} (${le(_.displayTime)})`,S=_.isMostRecent?"":`claude-mem://session-summary/${_.id}`;if(e){let E=S?`${i.dim}[${S}]${i.reset}`:"";n.push(`\u{1F3AF} ${i.yellow}#S${_.id}${i.reset} ${A} ${E}`)}else{let E=S?` [\u2192](${S})`:"";n.push(`**\u{1F3AF} #S${_.id}** ${A}${E}`)}n.push("")}else{let _=x.data,A=G(_.files_modified),S=A.length>0?Te(A[0],s):"General";S!==l&&(v&&n.push(""),e?n.push(`${i.dim}${S}${i.reset}`):n.push(`**${S}**`),e||(n.push("| ID | Time | T | Title | Tokens |"),n.push("|----|------|---|-------|--------|")),l=S,v=!0,R="");let E=G(_.concepts),f="\u2022";E.includes("gotcha")?f="\u{1F534}":E.includes("decision")?f="\u{1F7E4}":E.includes("trade-off")?f="\u2696\uFE0F":E.includes("problem-solution")?f="\u{1F7E1}":E.includes("discovery")?f="\u{1F7E3}":E.includes("why-it-exists")?f="\u{1F7E0}":E.includes("how-it-works")?f="\u{1F535}":E.includes("what-changed")&&(f="\u{1F7E2}");let y=me(_.created_at),H=_.title||"Untitled",w=Ee(_.narrative),B=y!==R,ee=B?y:"";if(R=y,e){let se=B?`${i.dim}${y}${i.reset}`:" ".repeat(y.length),te=w>0?`${i.dim}(~${w}t)${i.reset}`:"";n.push(`  ${i.dim}#${_.id}${i.reset}  ${se}  ${f}  ${H} ${te}`)}else n.push(`| #${_.id} | ${ee||"\u2033"} | ${f} | ${H} | ~${w} |`)}v&&n.push("")}let g=c[0];g&&(g.completed||g.next_steps)&&(g.completed&&(e?n.push(`${i.green}Completed:${i.reset} ${g.completed}`):n.push(`**Completed**: ${g.completed}`),n.push("")),g.next_steps&&(e?n.push(`${i.magenta}Next Steps:${i.reset} ${g.next_steps}`):n.push(`**Next Steps**: ${g.next_steps}`),n.push(""))),e?n.push(`${i.dim}Use claude-mem MCP search to access records with the given ID${i.reset}`):n.push("*Use claude-mem MCP search to access records with the given ID*"),n.push("")}return e&&(n.push(`${i.gray}${"\u2500".repeat(60)}${i.reset}`),n.push("")),o.close(),n.join(`
+`)}var Z=process.argv.includes("--index");if(P.isTTY){let a=z(void 0,!0,Z);console.log(a),process.exit(0)}else{let a="";P.on("data",e=>a+=e),P.on("end",()=>{let e=a.trim()?JSON.parse(a):void 0,s={hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:z(e,!1,Z)}};console.log(JSON.stringify(s)),process.exit(0)})}

plugin/scripts/new-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import K from"path";import W from"better-sqlite3";import{join as d,dirname as P,basename as z}from"path";import{homedir as R}from"os";import{existsSync as te,mkdirSync as M}from"fs";import{fileURLToPath as F}from"url";function H(){return typeof __dirname<"u"?__dirname:P(F(import.meta.url))}var $=H(),m=process.env.CLAUDE_MEM_DATA_DIR||d(R(),".claude-mem"),T=process.env.CLAUDE_CONFIG_DIR||d(R(),".claude"),ne=d(m,"archives"),oe=d(m,"logs"),ie=d(m,"trash"),ae=d(m,"backups"),de=d(m,"settings.json"),O=d(m,"claude-mem.db"),pe=d(T,"settings.json"),ce=d(T,"commands"),ue=d(T,"CLAUDE.md");function I(o){M(o,{recursive:!0})}function L(){return d($,"..","..")}var g=(n=>(n[n.DEBUG=0]="DEBUG",n[n.INFO=1]="INFO",n[n.WARN=2]="WARN",n[n.ERROR=3]="ERROR",n[n.SILENT=4]="SILENT",n))(g||{}),S=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=g[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,s){return`obs-${e}-${s}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
-${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Object.keys(e);return s.length===0?"{}":s.length<=3?JSON.stringify(e):`{${s.length} keys: ${s.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,s){if(!s)return e;try{let t=typeof s=="string"?JSON.parse(s):s;if(e==="Bash"&&t.command){let r=t.command.length>50?t.command.substring(0,50)+"...":t.command;return`${e}(${r})`}if(e==="Read"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Edit"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Write"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,s,t,r,n){if(e<this.level)return;let a=new Date().toISOString().replace("T"," ").substring(0,23),c=g[e].padEnd(5),i=s.padEnd(6),E="";r?.correlationId?E=`[${r.correlationId}] `:r?.sessionId&&(E=`[session-${r.sessionId}] `);let l="";n!=null&&(this.level===0&&typeof n=="object"?l=`
-`+JSON.stringify(n,null,2):l=" "+this.formatData(n));let p="";if(r){let{sessionId:Y,sdkSessionId:q,correlationId:V,...h}=r;Object.keys(h).length>0&&(p=` {${Object.entries(h).map(([w,X])=>`${w}=${X}`).join(", ")}}`)}let u=`[${a}] [${c}] [${i}] ${E}${t}${p}${l}`;e===3?console.error(u):console.log(u)}debug(e,s,t,r){this.log(0,e,s,t,r)}info(e,s,t,r){this.log(1,e,s,t,r)}warn(e,s,t,r){this.log(2,e,s,t,r)}error(e,s,t,r){this.log(3,e,s,t,r)}dataIn(e,s,t,r){this.info(e,`\u2192 ${s}`,t,r)}dataOut(e,s,t,r){this.info(e,`\u2190 ${s}`,t,r)}success(e,s,t,r){this.info(e,`\u2713 ${s}`,t,r)}failure(e,s,t,r){this.error(e,`\u2717 ${s}`,t,r)}timing(e,s,t,r){this.info(e,`\u23F1 ${s}`,r,{duration:`${t}ms`})}},v=new S;var _=class{db;constructor(){I(m),this.db=new W(O),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable()}initializeSchema(){try{this.db.exec(`
+import j from"path";import{stdin as x}from"process";import G from"better-sqlite3";import{join as p,dirname as X,basename as z}from"path";import{homedir as h}from"os";import{existsSync as te,mkdirSync as M}from"fs";import{fileURLToPath as P}from"url";function F(){return typeof __dirname<"u"?__dirname:X(P(import.meta.url))}var H=F(),u=process.env.CLAUDE_MEM_DATA_DIR||p(h(),".claude-mem"),l=process.env.CLAUDE_CONFIG_DIR||p(h(),".claude"),ne=p(u,"archives"),oe=p(u,"logs"),ie=p(u,"trash"),ae=p(u,"backups"),de=p(u,"settings.json"),O=p(u,"claude-mem.db"),pe=p(l,"settings.json"),ce=p(l,"commands"),Ee=p(l,"CLAUDE.md");function I(o){M(o,{recursive:!0})}function L(){return p(H,"..","..")}var T=(n=>(n[n.DEBUG=0]="DEBUG",n[n.INFO=1]="INFO",n[n.WARN=2]="WARN",n[n.ERROR=3]="ERROR",n[n.SILENT=4]="SILENT",n))(T||{}),S=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=T[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,s){return`obs-${e}-${s}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
+${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Object.keys(e);return s.length===0?"{}":s.length<=3?JSON.stringify(e):`{${s.length} keys: ${s.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,s){if(!s)return e;try{let t=typeof s=="string"?JSON.parse(s):s;if(e==="Bash"&&t.command){let r=t.command.length>50?t.command.substring(0,50)+"...":t.command;return`${e}(${r})`}if(e==="Read"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Edit"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Write"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,s,t,r,n){if(e<this.level)return;let i=new Date().toISOString().replace("T"," ").substring(0,23),a=T[e].padEnd(5),d=s.padEnd(6),E="";r?.correlationId?E=`[${r.correlationId}] `:r?.sessionId&&(E=`[session-${r.sessionId}] `);let c="";n!=null&&(this.level===0&&typeof n=="object"?c=`
+`+JSON.stringify(n,null,2):c=" "+this.formatData(n));let _="";if(r){let{sessionId:K,sdkSessionId:V,correlationId:q,...f}=r;Object.keys(f).length>0&&(_=` {${Object.entries(f).map(([U,w])=>`${U}=${w}`).join(", ")}}`)}let R=`[${i}] [${a}] [${d}] ${E}${t}${_}${c}`;e===3?console.error(R):console.log(R)}debug(e,s,t,r){this.log(0,e,s,t,r)}info(e,s,t,r){this.log(1,e,s,t,r)}warn(e,s,t,r){this.log(2,e,s,t,r)}error(e,s,t,r){this.log(3,e,s,t,r)}dataIn(e,s,t,r){this.info(e,`\u2192 ${s}`,t,r)}dataOut(e,s,t,r){this.info(e,`\u2190 ${s}`,t,r)}success(e,s,t,r){this.info(e,`\u2713 ${s}`,t,r)}failure(e,s,t,r){this.error(e,`\u2717 ${s}`,t,r)}timing(e,s,t,r){this.info(e,`\u23F1 ${s}`,r,{duration:`${t}ms`})}},A=new S;var m=class{db;constructor(){I(u),this.db=new G(O),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable(),this.createUserPromptsTable()}initializeSchema(){try{this.db.exec(`
         CREATE TABLE IF NOT EXISTS schema_versions (
           id INTEGER PRIMARY KEY,
           version INTEGER UNIQUE NOT NULL,
@@ -63,7 +63,7 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
           CREATE INDEX IF NOT EXISTS idx_session_summaries_sdk_session ON session_summaries(sdk_session_id);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_project ON session_summaries(project);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_created ON session_summaries(created_at_epoch DESC);
-        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(i=>i.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(i=>i.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(i=>i.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(d=>d.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
           CREATE TABLE session_summaries_new (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             sdk_session_id TEXT NOT NULL,
@@ -129,7 +129,44 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
           CREATE INDEX idx_observations_project ON observations(project);
           CREATE INDEX idx_observations_type ON observations(type);
           CREATE INDEX idx_observations_created ON observations(created_at_epoch DESC);
-        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}getRecentSummaries(e,s=10){return this.db.prepare(`
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}createUserPromptsTable(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(10))return;if(this.db.pragma("table_info(user_prompts)").length>0){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString());return}console.error("[SessionStore] Creating user_prompts table with FTS5 support..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+          CREATE TABLE user_prompts (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            claude_session_id TEXT NOT NULL,
+            prompt_number INTEGER NOT NULL,
+            prompt_text TEXT NOT NULL,
+            created_at TEXT NOT NULL,
+            created_at_epoch INTEGER NOT NULL,
+            FOREIGN KEY(claude_session_id) REFERENCES sdk_sessions(claude_session_id) ON DELETE CASCADE
+          );
+
+          CREATE INDEX idx_user_prompts_claude_session ON user_prompts(claude_session_id);
+          CREATE INDEX idx_user_prompts_created ON user_prompts(created_at_epoch DESC);
+          CREATE INDEX idx_user_prompts_prompt_number ON user_prompts(prompt_number);
+        `),this.db.exec(`
+          CREATE VIRTUAL TABLE user_prompts_fts USING fts5(
+            prompt_text,
+            content='user_prompts',
+            content_rowid='id'
+          );
+        `),this.db.exec(`
+          CREATE TRIGGER user_prompts_ai AFTER INSERT ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_ad AFTER DELETE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_au AFTER UPDATE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString()),console.error("[SessionStore] Successfully created user_prompts table with FTS5 support")}catch(t){throw this.db.exec("ROLLBACK"),t}}catch(e){console.error("[SessionStore] Migration error (create user_prompts table):",e.message)}}getRecentSummaries(e,s=10){return this.db.prepare(`
       SELECT
         request, investigated, learned, completed, next_steps,
         files_read, files_edited, notes, prompt_number, created_at
@@ -137,6 +174,14 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       WHERE project = ?
       ORDER BY created_at_epoch DESC
       LIMIT ?
+    `).all(e,s)}getRecentSummariesWithSessionInfo(e,s=3){return this.db.prepare(`
+      SELECT
+        sdk_session_id, request, learned, completed, next_steps,
+        prompt_number, created_at
+      FROM session_summaries
+      WHERE project = ?
+      ORDER BY created_at_epoch DESC
+      LIMIT ?
     `).all(e,s)}getRecentObservations(e,s=20){return this.db.prepare(`
       SELECT type, text, prompt_number, created_at
       FROM observations
@@ -173,8 +218,12 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       WHERE sdk_session_id = ?
       ORDER BY created_at_epoch DESC
       LIMIT 1
-    `).get(e)||null}getSessionById(e){return this.db.prepare(`
-      SELECT id, sdk_session_id, project, user_prompt
+    `).get(e)||null}getFilesForSession(e){let t=this.db.prepare(`
+      SELECT files_read, files_modified
+      FROM observations
+      WHERE sdk_session_id = ?
+    `).all(e),r=new Set,n=new Set;for(let i of t){if(i.files_read)try{let a=JSON.parse(i.files_read);Array.isArray(a)&&a.forEach(d=>r.add(d))}catch{}if(i.files_modified)try{let a=JSON.parse(i.files_modified);Array.isArray(a)&&a.forEach(d=>n.add(d))}catch{}}return{filesRead:Array.from(r),filesModified:Array.from(n)}}getSessionById(e){return this.db.prepare(`
+      SELECT id, claude_session_id, sdk_session_id, project, user_prompt
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
@@ -200,15 +249,17 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
     `).get(e)?.prompt_counter||1}getPromptCounter(e){return this.db.prepare(`
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
-    `).get(e)?.prompt_counter||0}createSDKSession(e,s,t){let r=new Date,n=r.getTime();return this.db.prepare(`
-      INSERT INTO sdk_sessions
-      (claude_session_id, project, user_prompt, started_at, started_at_epoch, status)
-      VALUES (?, ?, ?, ?, ?, 'active')
-    `).run(e,s,t,r.toISOString(),n).lastInsertRowid}updateSDKSessionId(e,s){return this.db.prepare(`
+    `).get(e)?.prompt_counter||0}createSDKSession(e,s,t){let r=new Date,n=r.getTime(),a=this.db.prepare(`
+      INSERT OR IGNORE INTO sdk_sessions
+      (claude_session_id, sdk_session_id, project, user_prompt, started_at, started_at_epoch, status)
+      VALUES (?, ?, ?, ?, ?, ?, 'active')
+    `).run(e,e,s,t,r.toISOString(),n);return a.lastInsertRowid===0||a.changes===0?this.db.prepare(`
+        SELECT id FROM sdk_sessions WHERE claude_session_id = ? LIMIT 1
+      `).get(e).id:a.lastInsertRowid}updateSDKSessionId(e,s){return this.db.prepare(`
       UPDATE sdk_sessions
       SET sdk_session_id = ?
       WHERE id = ? AND sdk_session_id IS NULL
-    `).run(s,e).changes===0?(v.debug("DB","sdk_session_id already set, skipping update",{sessionId:e,sdkSessionId:s}),!1):!0}setWorkerPort(e,s){this.db.prepare(`
+    `).run(s,e).changes===0?(A.debug("DB","sdk_session_id already set, skipping update",{sessionId:e,sdkSessionId:s}),!1):!0}setWorkerPort(e,s){this.db.prepare(`
       UPDATE sdk_sessions
       SET worker_port = ?
       WHERE id = ?
@@ -217,17 +268,33 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
-    `).get(e)?.worker_port||null}storeObservation(e,s,t,r){let n=new Date,a=n.getTime();this.db.prepare(`
+    `).get(e)?.worker_port||null}saveUserPrompt(e,s,t){let r=new Date,n=r.getTime();return this.db.prepare(`
+      INSERT INTO user_prompts
+      (claude_session_id, prompt_number, prompt_text, created_at, created_at_epoch)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(e,s,t,r.toISOString(),n).lastInsertRowid}storeObservation(e,s,t,r){let n=new Date,i=n.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,s,n.toISOString(),i),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO observations
       (sdk_session_id, project, type, title, subtitle, facts, narrative, concepts,
        files_read, files_modified, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,s,t.type,t.title,t.subtitle,JSON.stringify(t.facts),t.narrative,JSON.stringify(t.concepts),JSON.stringify(t.files_read),JSON.stringify(t.files_modified),r||null,n.toISOString(),a)}storeSummary(e,s,t,r){let n=new Date,a=n.getTime();this.db.prepare(`
+    `).run(e,s,t.type,t.title,t.subtitle,JSON.stringify(t.facts),t.narrative,JSON.stringify(t.concepts),JSON.stringify(t.files_read),JSON.stringify(t.files_modified),r||null,n.toISOString(),i)}storeSummary(e,s,t,r){let n=new Date,i=n.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,s,n.toISOString(),i),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO session_summaries
       (sdk_session_id, project, request, investigated, learned, completed,
        next_steps, notes, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,s,t.request,t.investigated,t.learned,t.completed,t.next_steps,t.notes,r||null,n.toISOString(),a)}markSessionCompleted(e){let s=new Date,t=s.getTime();this.db.prepare(`
+    `).run(e,s,t.request,t.investigated,t.learned,t.completed,t.next_steps,t.notes,r||null,n.toISOString(),i)}markSessionCompleted(e){let s=new Date,t=s.getTime();this.db.prepare(`
       UPDATE sdk_sessions
       SET status = 'completed', completed_at = ?, completed_at_epoch = ?
       WHERE id = ?
@@ -239,4 +306,4 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       UPDATE sdk_sessions
       SET status = 'failed', completed_at = ?, completed_at_epoch = ?
       WHERE status = 'active'
-    `).run(e.toISOString(),s).changes}close(){this.db.close()}};function j(o,e,s){return o==="PreCompact"?e?{continue:!0,suppressOutput:!0}:{continue:!1,stopReason:s.reason||"Pre-compact operation failed",suppressOutput:!0}:o==="SessionStart"?e&&s.context?{continue:!0,suppressOutput:!0,hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:s.context}}:{continue:!0,suppressOutput:!0}:o==="UserPromptSubmit"||o==="PostToolUse"?{continue:!0,suppressOutput:!0}:o==="Stop"?{continue:!0,suppressOutput:!0}:{continue:e,suppressOutput:!0,...s.reason&&!e?{stopReason:s.reason}:{}}}function A(o,e,s={}){let t=j(o,e,s);return JSON.stringify(t)}import b from"path";import{existsSync as N}from"fs";import{spawn as B}from"child_process";var C=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),G=`http://127.0.0.1:${C}/health`;async function k(){try{return(await fetch(G,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function D(){try{if(await k())return!0;console.error("[claude-mem] Worker not responding, starting...");let o=L(),e=b.join(o,"plugin","scripts","worker-service.cjs");if(!N(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let s=b.join(o,"ecosystem.config.cjs"),t=b.join(o,"node_modules",".bin","pm2");if(!N(t))throw new Error(`PM2 binary not found at ${t}. This is a bundled dependency - try running: npm install`);if(!N(s))throw new Error(`PM2 ecosystem config not found at ${s}. Plugin installation may be corrupted.`);let r=B(t,["start",s],{detached:!0,stdio:"ignore",cwd:o});r.on("error",n=>{throw new Error(`Failed to spawn PM2: ${n.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let n=0;n<3;n++)if(await new Promise(a=>setTimeout(a,500)),await k())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(o){return console.error(`[claude-mem] Failed to start worker: ${o.message}`),!1}}function y(){return C}async function x(o){if(!o)throw new Error("newHook requires input");let{session_id:e,cwd:s,prompt:t}=o,r=K.basename(s);if(!await D())throw new Error("Worker service failed to start or become healthy");let a=new _;try{let c=a.findActiveSDKSession(e),i,E=!1;if(c){i=c.id;let p=a.incrementPromptCounter(i);console.error(`[new-hook] Continuing session ${i}, prompt #${p}`)}else{let p=a.findAnySDKSession(e);if(p){i=p.id,a.reactivateSession(i,t);let u=a.incrementPromptCounter(i);E=!0,console.error(`[new-hook] Reactivated session ${i}, prompt #${u}`)}else{i=a.createSDKSession(e,r,t);let u=a.incrementPromptCounter(i);E=!0,console.error(`[new-hook] Created new session ${i}, prompt #${u}`)}}let l=y();if(E){let p=await fetch(`http://127.0.0.1:${l}/sessions/${i}/init`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({project:r,userPrompt:t}),signal:AbortSignal.timeout(5e3)});if(!p.ok){let u=await p.text();throw new Error(`Failed to initialize session: ${p.status} ${u}`)}}console.log(A("UserPromptSubmit",!0))}finally{a.close()}}import{stdin as U}from"process";var f="";U.on("data",o=>f+=o);U.on("end",async()=>{let o=f.trim()?JSON.parse(f):void 0;await x(o),process.exit(0)});
+    `).run(e.toISOString(),s).changes}close(){this.db.close()}};function W(o,e,s){return o==="PreCompact"?e?{continue:!0,suppressOutput:!0}:{continue:!1,stopReason:s.reason||"Pre-compact operation failed",suppressOutput:!0}:o==="SessionStart"?e&&s.context?{continue:!0,suppressOutput:!0,hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:s.context}}:{continue:!0,suppressOutput:!0}:o==="UserPromptSubmit"||o==="PostToolUse"?{continue:!0,suppressOutput:!0}:o==="Stop"?{continue:!0,suppressOutput:!0}:{continue:e,suppressOutput:!0,...s.reason&&!e?{stopReason:s.reason}:{}}}function v(o,e,s={}){let t=W(o,e,s);return JSON.stringify(t)}import g from"path";import{existsSync as b}from"fs";import{spawn as B}from"child_process";var k=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),$=`http://127.0.0.1:${k}/health`;async function C(){try{return(await fetch($,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function D(){try{if(await C())return!0;console.error("[claude-mem] Worker not responding, starting...");let o=L(),e=g.join(o,"plugin","scripts","worker-service.cjs");if(!b(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let s=g.join(o,"ecosystem.config.cjs"),t=g.join(o,"node_modules",".bin","pm2");if(!b(t))throw new Error(`PM2 binary not found at ${t}. This is a bundled dependency - try running: npm install`);if(!b(s))throw new Error(`PM2 ecosystem config not found at ${s}. Plugin installation may be corrupted.`);let r=B(t,["start",s],{detached:!0,stdio:"ignore",cwd:o});r.on("error",n=>{throw new Error(`Failed to spawn PM2: ${n.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let n=0;n<3;n++)if(await new Promise(i=>setTimeout(i,500)),await C())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(o){return console.error(`[claude-mem] Failed to start worker: ${o.message}`),!1}}function y(){return k}async function Y(o){if(!o)throw new Error("newHook requires input");let{session_id:e,cwd:s,prompt:t}=o,r=j.basename(s);if(!await D())throw new Error("Worker service failed to start or become healthy");let i=new m,a=i.createSDKSession(e,r,t),d=i.incrementPromptCounter(a);i.saveUserPrompt(e,d,t),console.error(`[new-hook] Session ${a}, prompt #${d}`),i.close();let E=y(),c=await fetch(`http://127.0.0.1:${E}/sessions/${a}/init`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({project:r,userPrompt:t}),signal:AbortSignal.timeout(5e3)});if(!c.ok){let _=await c.text();throw new Error(`Failed to initialize session: ${c.status} ${_}`)}console.log(v("UserPromptSubmit",!0))}var N="";x.on("data",o=>N+=o);x.on("end",async()=>{let o=N?JSON.parse(N):void 0;await Y(o)});

plugin/scripts/package-lock.json

@@ -1,463 +0,0 @@
-{
-  "name": "claude-mem-scripts",
-  "version": "4.0.5",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "claude-mem-scripts",
-      "version": "4.0.5",
-      "dependencies": {
-        "better-sqlite3": "^11.0.0"
-      }
-    },
-    "node_modules/base64-js": {
-      "version": "1.5.1",
-      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
-      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/better-sqlite3": {
-      "version": "11.10.0",
-      "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.10.0.tgz",
-      "integrity": "sha512-EwhOpyXiOEL/lKzHz9AW1msWFNzGc/z+LzeB3/jnFJpxu+th2yqvzsSWas1v9jgs9+xiXJcD5A8CJxAG2TaghQ==",
-      "hasInstallScript": true,
-      "license": "MIT",
-      "dependencies": {
-        "bindings": "^1.5.0",
-        "prebuild-install": "^7.1.1"
-      }
-    },
-    "node_modules/bindings": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz",
-      "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==",
-      "license": "MIT",
-      "dependencies": {
-        "file-uri-to-path": "1.0.0"
-      }
-    },
-    "node_modules/bl": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz",
-      "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==",
-      "license": "MIT",
-      "dependencies": {
-        "buffer": "^5.5.0",
-        "inherits": "^2.0.4",
-        "readable-stream": "^3.4.0"
-      }
-    },
-    "node_modules/buffer": {
-      "version": "5.7.1",
-      "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz",
-      "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "base64-js": "^1.3.1",
-        "ieee754": "^1.1.13"
-      }
-    },
-    "node_modules/chownr": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz",
-      "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==",
-      "license": "ISC"
-    },
-    "node_modules/decompress-response": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz",
-      "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==",
-      "license": "MIT",
-      "dependencies": {
-        "mimic-response": "^3.1.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/deep-extend": {
-      "version": "0.6.0",
-      "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz",
-      "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=4.0.0"
-      }
-    },
-    "node_modules/detect-libc": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
-      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
-      "license": "Apache-2.0",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/end-of-stream": {
-      "version": "1.4.5",
-      "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz",
-      "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==",
-      "license": "MIT",
-      "dependencies": {
-        "once": "^1.4.0"
-      }
-    },
-    "node_modules/expand-template": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz",
-      "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==",
-      "license": "(MIT OR WTFPL)",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/file-uri-to-path": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz",
-      "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==",
-      "license": "MIT"
-    },
-    "node_modules/fs-constants": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz",
-      "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==",
-      "license": "MIT"
-    },
-    "node_modules/github-from-package": {
-      "version": "0.0.0",
-      "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz",
-      "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==",
-      "license": "MIT"
-    },
-    "node_modules/ieee754": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
-      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/inherits": {
-      "version": "2.0.4",
-      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
-      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
-      "license": "ISC"
-    },
-    "node_modules/ini": {
-      "version": "1.3.8",
-      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
-      "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
-      "license": "ISC"
-    },
-    "node_modules/mimic-response": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz",
-      "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/minimist": {
-      "version": "1.2.8",
-      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
-      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
-      "license": "MIT",
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/mkdirp-classic": {
-      "version": "0.5.3",
-      "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz",
-      "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==",
-      "license": "MIT"
-    },
-    "node_modules/napi-build-utils": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-2.0.0.tgz",
-      "integrity": "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==",
-      "license": "MIT"
-    },
-    "node_modules/node-abi": {
-      "version": "3.78.0",
-      "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.78.0.tgz",
-      "integrity": "sha512-E2wEyrgX/CqvicaQYU3Ze1PFGjc4QYPGsjUrlYkqAE0WjHEZwgOsGMPMzkMse4LjJbDmaEuDX3CM036j5K2DSQ==",
-      "license": "MIT",
-      "dependencies": {
-        "semver": "^7.3.5"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/once": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
-      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
-      "license": "ISC",
-      "dependencies": {
-        "wrappy": "1"
-      }
-    },
-    "node_modules/prebuild-install": {
-      "version": "7.1.3",
-      "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz",
-      "integrity": "sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==",
-      "license": "MIT",
-      "dependencies": {
-        "detect-libc": "^2.0.0",
-        "expand-template": "^2.0.3",
-        "github-from-package": "0.0.0",
-        "minimist": "^1.2.3",
-        "mkdirp-classic": "^0.5.3",
-        "napi-build-utils": "^2.0.0",
-        "node-abi": "^3.3.0",
-        "pump": "^3.0.0",
-        "rc": "^1.2.7",
-        "simple-get": "^4.0.0",
-        "tar-fs": "^2.0.0",
-        "tunnel-agent": "^0.6.0"
-      },
-      "bin": {
-        "prebuild-install": "bin.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/pump": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.3.tgz",
-      "integrity": "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA==",
-      "license": "MIT",
-      "dependencies": {
-        "end-of-stream": "^1.1.0",
-        "once": "^1.3.1"
-      }
-    },
-    "node_modules/rc": {
-      "version": "1.2.8",
-      "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz",
-      "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==",
-      "license": "(BSD-2-Clause OR MIT OR Apache-2.0)",
-      "dependencies": {
-        "deep-extend": "^0.6.0",
-        "ini": "~1.3.0",
-        "minimist": "^1.2.0",
-        "strip-json-comments": "~2.0.1"
-      },
-      "bin": {
-        "rc": "cli.js"
-      }
-    },
-    "node_modules/readable-stream": {
-      "version": "3.6.2",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
-      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
-      "license": "MIT",
-      "dependencies": {
-        "inherits": "^2.0.3",
-        "string_decoder": "^1.1.1",
-        "util-deprecate": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/safe-buffer": {
-      "version": "5.2.1",
-      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/semver": {
-      "version": "7.7.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz",
-      "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==",
-      "license": "ISC",
-      "bin": {
-        "semver": "bin/semver.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/simple-concat": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz",
-      "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/simple-get": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz",
-      "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "decompress-response": "^6.0.0",
-        "once": "^1.3.1",
-        "simple-concat": "^1.0.0"
-      }
-    },
-    "node_modules/string_decoder": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
-      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
-      "license": "MIT",
-      "dependencies": {
-        "safe-buffer": "~5.2.0"
-      }
-    },
-    "node_modules/strip-json-comments": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz",
-      "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/tar-fs": {
-      "version": "2.1.4",
-      "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.4.tgz",
-      "integrity": "sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ==",
-      "license": "MIT",
-      "dependencies": {
-        "chownr": "^1.1.1",
-        "mkdirp-classic": "^0.5.2",
-        "pump": "^3.0.0",
-        "tar-stream": "^2.1.4"
-      }
-    },
-    "node_modules/tar-stream": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz",
-      "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==",
-      "license": "MIT",
-      "dependencies": {
-        "bl": "^4.0.3",
-        "end-of-stream": "^1.4.1",
-        "fs-constants": "^1.0.0",
-        "inherits": "^2.0.3",
-        "readable-stream": "^3.1.1"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/tunnel-agent": {
-      "version": "0.6.0",
-      "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz",
-      "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "safe-buffer": "^5.0.1"
-      },
-      "engines": {
-        "node": "*"
-      }
-    },
-    "node_modules/util-deprecate": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
-      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
-      "license": "MIT"
-    },
-    "node_modules/wrappy": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
-      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
-      "license": "ISC"
-    }
-  }
-}

plugin/scripts/save-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import H from"better-sqlite3";import{join as d,dirname as w,basename as Q}from"path";import{homedir as I}from"os";import{existsSync as se,mkdirSync as X}from"fs";import{fileURLToPath as P}from"url";function M(){return typeof __dirname<"u"?__dirname:w(P(import.meta.url))}var F=M(),u=process.env.CLAUDE_MEM_DATA_DIR||d(I(),".claude-mem"),g=process.env.CLAUDE_CONFIG_DIR||d(I(),".claude"),re=d(u,"archives"),oe=d(u,"logs"),ne=d(u,"trash"),ie=d(u,"backups"),ae=d(u,"settings.json"),L=d(u,"claude-mem.db"),de=d(g,"settings.json"),pe=d(g,"commands"),ce=d(g,"CLAUDE.md");function v(n){X(n,{recursive:!0})}function A(){return d(F,"..","..")}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||{}),b=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=S[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,s){return`obs-${e}-${s}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
-${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Object.keys(e);return s.length===0?"{}":s.length<=3?JSON.stringify(e):`{${s.length} keys: ${s.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,s){if(!s)return e;try{let t=typeof s=="string"?JSON.parse(s):s;if(e==="Bash"&&t.command){let r=t.command.length>50?t.command.substring(0,50)+"...":t.command;return`${e}(${r})`}if(e==="Read"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Edit"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Write"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,s,t,r,o){if(e<this.level)return;let a=new Date().toISOString().replace("T"," ").substring(0,23),i=S[e].padEnd(5),p=s.padEnd(6),m="";r?.correlationId?m=`[${r.correlationId}] `:r?.sessionId&&(m=`[session-${r.sessionId}] `);let c="";o!=null&&(this.level===0&&typeof o=="object"?c=`
-`+JSON.stringify(o,null,2):c=" "+this.formatData(o));let l="";if(r){let{sessionId:K,sdkSessionId:Y,correlationId:q,...O}=r;Object.keys(O).length>0&&(l=` {${Object.entries(O).map(([x,U])=>`${x}=${U}`).join(", ")}}`)}let h=`[${a}] [${i}] [${p}] ${m}${t}${l}${c}`;e===3?console.error(h):console.log(h)}debug(e,s,t,r){this.log(0,e,s,t,r)}info(e,s,t,r){this.log(1,e,s,t,r)}warn(e,s,t,r){this.log(2,e,s,t,r)}error(e,s,t,r){this.log(3,e,s,t,r)}dataIn(e,s,t,r){this.info(e,`\u2192 ${s}`,t,r)}dataOut(e,s,t,r){this.info(e,`\u2190 ${s}`,t,r)}success(e,s,t,r){this.info(e,`\u2713 ${s}`,t,r)}failure(e,s,t,r){this.error(e,`\u2717 ${s}`,t,r)}timing(e,s,t,r){this.info(e,`\u23F1 ${s}`,r,{duration:`${t}ms`})}},E=new b;var _=class{db;constructor(){v(u),this.db=new H(L),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable()}initializeSchema(){try{this.db.exec(`
+import{stdin as D}from"process";import F from"better-sqlite3";import{join as p,dirname as U,basename as Q}from"path";import{homedir as I}from"os";import{existsSync as se,mkdirSync as w}from"fs";import{fileURLToPath as M}from"url";function X(){return typeof __dirname<"u"?__dirname:U(M(import.meta.url))}var P=X(),u=process.env.CLAUDE_MEM_DATA_DIR||p(I(),".claude-mem"),S=process.env.CLAUDE_CONFIG_DIR||p(I(),".claude"),re=p(u,"archives"),oe=p(u,"logs"),ne=p(u,"trash"),ie=p(u,"backups"),ae=p(u,"settings.json"),L=p(u,"claude-mem.db"),de=p(S,"settings.json"),pe=p(S,"commands"),ce=p(S,"CLAUDE.md");function A(n){w(n,{recursive:!0})}function v(){return p(P,"..","..")}var g=(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))(g||{}),b=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=g[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,s){return`obs-${e}-${s}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
+${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Object.keys(e);return s.length===0?"{}":s.length<=3?JSON.stringify(e):`{${s.length} keys: ${s.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,s){if(!s)return e;try{let t=typeof s=="string"?JSON.parse(s):s;if(e==="Bash"&&t.command){let r=t.command.length>50?t.command.substring(0,50)+"...":t.command;return`${e}(${r})`}if(e==="Read"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Edit"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Write"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,s,t,r,o){if(e<this.level)return;let i=new Date().toISOString().replace("T"," ").substring(0,23),a=g[e].padEnd(5),d=s.padEnd(6),c="";r?.correlationId?c=`[${r.correlationId}] `:r?.sessionId&&(c=`[session-${r.sessionId}] `);let E="";o!=null&&(this.level===0&&typeof o=="object"?E=`
+`+JSON.stringify(o,null,2):E=" "+this.formatData(o));let _="";if(r){let{sessionId:K,sdkSessionId:Y,correlationId:V,...h}=r;Object.keys(h).length>0&&(_=` {${Object.entries(h).map(([y,x])=>`${y}=${x}`).join(", ")}}`)}let l=`[${i}] [${a}] [${d}] ${c}${t}${_}${E}`;e===3?console.error(l):console.log(l)}debug(e,s,t,r){this.log(0,e,s,t,r)}info(e,s,t,r){this.log(1,e,s,t,r)}warn(e,s,t,r){this.log(2,e,s,t,r)}error(e,s,t,r){this.log(3,e,s,t,r)}dataIn(e,s,t,r){this.info(e,`\u2192 ${s}`,t,r)}dataOut(e,s,t,r){this.info(e,`\u2190 ${s}`,t,r)}success(e,s,t,r){this.info(e,`\u2713 ${s}`,t,r)}failure(e,s,t,r){this.error(e,`\u2717 ${s}`,t,r)}timing(e,s,t,r){this.info(e,`\u23F1 ${s}`,r,{duration:`${t}ms`})}},m=new b;var T=class{db;constructor(){A(u),this.db=new F(L),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable(),this.createUserPromptsTable()}initializeSchema(){try{this.db.exec(`
         CREATE TABLE IF NOT EXISTS schema_versions (
           id INTEGER PRIMARY KEY,
           version INTEGER UNIQUE NOT NULL,
@@ -63,7 +63,7 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
           CREATE INDEX IF NOT EXISTS idx_session_summaries_sdk_session ON session_summaries(sdk_session_id);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_project ON session_summaries(project);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_created ON session_summaries(created_at_epoch DESC);
-        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(p=>p.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(p=>p.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(p=>p.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(d=>d.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
           CREATE TABLE session_summaries_new (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             sdk_session_id TEXT NOT NULL,
@@ -129,7 +129,44 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
           CREATE INDEX idx_observations_project ON observations(project);
           CREATE INDEX idx_observations_type ON observations(type);
           CREATE INDEX idx_observations_created ON observations(created_at_epoch DESC);
-        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}getRecentSummaries(e,s=10){return this.db.prepare(`
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}createUserPromptsTable(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(10))return;if(this.db.pragma("table_info(user_prompts)").length>0){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString());return}console.error("[SessionStore] Creating user_prompts table with FTS5 support..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+          CREATE TABLE user_prompts (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            claude_session_id TEXT NOT NULL,
+            prompt_number INTEGER NOT NULL,
+            prompt_text TEXT NOT NULL,
+            created_at TEXT NOT NULL,
+            created_at_epoch INTEGER NOT NULL,
+            FOREIGN KEY(claude_session_id) REFERENCES sdk_sessions(claude_session_id) ON DELETE CASCADE
+          );
+
+          CREATE INDEX idx_user_prompts_claude_session ON user_prompts(claude_session_id);
+          CREATE INDEX idx_user_prompts_created ON user_prompts(created_at_epoch DESC);
+          CREATE INDEX idx_user_prompts_prompt_number ON user_prompts(prompt_number);
+        `),this.db.exec(`
+          CREATE VIRTUAL TABLE user_prompts_fts USING fts5(
+            prompt_text,
+            content='user_prompts',
+            content_rowid='id'
+          );
+        `),this.db.exec(`
+          CREATE TRIGGER user_prompts_ai AFTER INSERT ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_ad AFTER DELETE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_au AFTER UPDATE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString()),console.error("[SessionStore] Successfully created user_prompts table with FTS5 support")}catch(t){throw this.db.exec("ROLLBACK"),t}}catch(e){console.error("[SessionStore] Migration error (create user_prompts table):",e.message)}}getRecentSummaries(e,s=10){return this.db.prepare(`
       SELECT
         request, investigated, learned, completed, next_steps,
         files_read, files_edited, notes, prompt_number, created_at
@@ -137,6 +174,14 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       WHERE project = ?
       ORDER BY created_at_epoch DESC
       LIMIT ?
+    `).all(e,s)}getRecentSummariesWithSessionInfo(e,s=3){return this.db.prepare(`
+      SELECT
+        sdk_session_id, request, learned, completed, next_steps,
+        prompt_number, created_at
+      FROM session_summaries
+      WHERE project = ?
+      ORDER BY created_at_epoch DESC
+      LIMIT ?
     `).all(e,s)}getRecentObservations(e,s=20){return this.db.prepare(`
       SELECT type, text, prompt_number, created_at
       FROM observations
@@ -173,8 +218,12 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       WHERE sdk_session_id = ?
       ORDER BY created_at_epoch DESC
       LIMIT 1
-    `).get(e)||null}getSessionById(e){return this.db.prepare(`
-      SELECT id, sdk_session_id, project, user_prompt
+    `).get(e)||null}getFilesForSession(e){let t=this.db.prepare(`
+      SELECT files_read, files_modified
+      FROM observations
+      WHERE sdk_session_id = ?
+    `).all(e),r=new Set,o=new Set;for(let i of t){if(i.files_read)try{let a=JSON.parse(i.files_read);Array.isArray(a)&&a.forEach(d=>r.add(d))}catch{}if(i.files_modified)try{let a=JSON.parse(i.files_modified);Array.isArray(a)&&a.forEach(d=>o.add(d))}catch{}}return{filesRead:Array.from(r),filesModified:Array.from(o)}}getSessionById(e){return this.db.prepare(`
+      SELECT id, claude_session_id, sdk_session_id, project, user_prompt
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
@@ -200,15 +249,17 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
     `).get(e)?.prompt_counter||1}getPromptCounter(e){return this.db.prepare(`
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
-    `).get(e)?.prompt_counter||0}createSDKSession(e,s,t){let r=new Date,o=r.getTime();return this.db.prepare(`
-      INSERT INTO sdk_sessions
-      (claude_session_id, project, user_prompt, started_at, started_at_epoch, status)
-      VALUES (?, ?, ?, ?, ?, 'active')
-    `).run(e,s,t,r.toISOString(),o).lastInsertRowid}updateSDKSessionId(e,s){return this.db.prepare(`
+    `).get(e)?.prompt_counter||0}createSDKSession(e,s,t){let r=new Date,o=r.getTime(),a=this.db.prepare(`
+      INSERT OR IGNORE INTO sdk_sessions
+      (claude_session_id, sdk_session_id, project, user_prompt, started_at, started_at_epoch, status)
+      VALUES (?, ?, ?, ?, ?, ?, 'active')
+    `).run(e,e,s,t,r.toISOString(),o);return a.lastInsertRowid===0||a.changes===0?this.db.prepare(`
+        SELECT id FROM sdk_sessions WHERE claude_session_id = ? LIMIT 1
+      `).get(e).id:a.lastInsertRowid}updateSDKSessionId(e,s){return this.db.prepare(`
       UPDATE sdk_sessions
       SET sdk_session_id = ?
       WHERE id = ? AND sdk_session_id IS NULL
-    `).run(s,e).changes===0?(E.debug("DB","sdk_session_id already set, skipping update",{sessionId:e,sdkSessionId:s}),!1):!0}setWorkerPort(e,s){this.db.prepare(`
+    `).run(s,e).changes===0?(m.debug("DB","sdk_session_id already set, skipping update",{sessionId:e,sdkSessionId:s}),!1):!0}setWorkerPort(e,s){this.db.prepare(`
       UPDATE sdk_sessions
       SET worker_port = ?
       WHERE id = ?
@@ -217,17 +268,33 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
-    `).get(e)?.worker_port||null}storeObservation(e,s,t,r){let o=new Date,a=o.getTime();this.db.prepare(`
+    `).get(e)?.worker_port||null}saveUserPrompt(e,s,t){let r=new Date,o=r.getTime();return this.db.prepare(`
+      INSERT INTO user_prompts
+      (claude_session_id, prompt_number, prompt_text, created_at, created_at_epoch)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(e,s,t,r.toISOString(),o).lastInsertRowid}storeObservation(e,s,t,r){let o=new Date,i=o.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,s,o.toISOString(),i),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO observations
       (sdk_session_id, project, type, title, subtitle, facts, narrative, concepts,
        files_read, files_modified, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,s,t.type,t.title,t.subtitle,JSON.stringify(t.facts),t.narrative,JSON.stringify(t.concepts),JSON.stringify(t.files_read),JSON.stringify(t.files_modified),r||null,o.toISOString(),a)}storeSummary(e,s,t,r){let o=new Date,a=o.getTime();this.db.prepare(`
+    `).run(e,s,t.type,t.title,t.subtitle,JSON.stringify(t.facts),t.narrative,JSON.stringify(t.concepts),JSON.stringify(t.files_read),JSON.stringify(t.files_modified),r||null,o.toISOString(),i)}storeSummary(e,s,t,r){let o=new Date,i=o.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,s,o.toISOString(),i),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO session_summaries
       (sdk_session_id, project, request, investigated, learned, completed,
        next_steps, notes, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,s,t.request,t.investigated,t.learned,t.completed,t.next_steps,t.notes,r||null,o.toISOString(),a)}markSessionCompleted(e){let s=new Date,t=s.getTime();this.db.prepare(`
+    `).run(e,s,t.request,t.investigated,t.learned,t.completed,t.next_steps,t.notes,r||null,o.toISOString(),i)}markSessionCompleted(e){let s=new Date,t=s.getTime();this.db.prepare(`
       UPDATE sdk_sessions
       SET status = 'completed', completed_at = ?, completed_at_epoch = ?
       WHERE id = ?
@@ -239,4 +306,4 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       UPDATE sdk_sessions
       SET status = 'failed', completed_at = ?, completed_at_epoch = ?
       WHERE status = 'active'
-    `).run(e.toISOString(),s).changes}close(){this.db.close()}};function W(n,e,s){return n==="PreCompact"?e?{continue:!0,suppressOutput:!0}:{continue:!1,stopReason:s.reason||"Pre-compact operation failed",suppressOutput:!0}:n==="SessionStart"?e&&s.context?{continue:!0,suppressOutput:!0,hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:s.context}}:{continue:!0,suppressOutput:!0}:n==="UserPromptSubmit"||n==="PostToolUse"?{continue:!0,suppressOutput:!0}:n==="Stop"?{continue:!0,suppressOutput:!0}:{continue:e,suppressOutput:!0,...s.reason&&!e?{stopReason:s.reason}:{}}}function T(n,e,s={}){let t=W(n,e,s);return JSON.stringify(t)}import f from"path";import{existsSync as N}from"fs";import{spawn as $}from"child_process";var j=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),B=`http://127.0.0.1:${j}/health`;async function k(){try{return(await fetch(B,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function C(){try{if(await k())return!0;console.error("[claude-mem] Worker not responding, starting...");let n=A(),e=f.join(n,"plugin","scripts","worker-service.cjs");if(!N(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let s=f.join(n,"ecosystem.config.cjs"),t=f.join(n,"node_modules",".bin","pm2");if(!N(t))throw new Error(`PM2 binary not found at ${t}. This is a bundled dependency - try running: npm install`);if(!N(s))throw new Error(`PM2 ecosystem config not found at ${s}. Plugin installation may be corrupted.`);let r=$(t,["start",s],{detached:!0,stdio:"ignore",cwd:n});r.on("error",o=>{throw new Error(`Failed to spawn PM2: ${o.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let o=0;o<3;o++)if(await new Promise(a=>setTimeout(a,500)),await k())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(n){return console.error(`[claude-mem] Failed to start worker: ${n.message}`),!1}}var G=new Set(["ListMcpResourcesTool"]);async function D(n){if(!n)throw new Error("saveHook requires input");let{session_id:e,tool_name:s,tool_input:t,tool_output:r}=n;if(G.has(s)){console.log(T("PostToolUse",!0));return}if(!await C())throw new Error("Worker service failed to start or become healthy");let a=new _,i=a.findActiveSDKSession(e);if(!i){a.close(),console.log(T("PostToolUse",!0));return}if(!i.worker_port)throw a.close(),E.error("HOOK","No worker port for session",{sessionId:i.id}),new Error("No worker port for session - session may not be properly initialized");let p=a.getPromptCounter(i.id);a.close();let m=E.formatTool(s,t);E.dataIn("HOOK",`PostToolUse: ${m}`,{sessionId:i.id,workerPort:i.worker_port});let c=await fetch(`http://127.0.0.1:${i.worker_port}/sessions/${i.id}/observations`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({tool_name:s,tool_input:t!==void 0?JSON.stringify(t):"{}",tool_output:r!==void 0?JSON.stringify(r):"{}",prompt_number:p}),signal:AbortSignal.timeout(2e3)});if(!c.ok){let l=await c.text();throw E.failure("HOOK","Failed to send observation",{sessionId:i.id,status:c.status},l),new Error(`Failed to send observation to worker: ${c.status} ${l}`)}E.debug("HOOK","Observation sent successfully",{sessionId:i.id,toolName:s}),console.log(T("PostToolUse",!0))}import{stdin as y}from"process";var R="";y.on("data",n=>R+=n);y.on("end",async()=>{let n=R.trim()?JSON.parse(R):void 0;await D(n),process.exit(0)});
+    `).run(e.toISOString(),s).changes}close(){this.db.close()}};function H(n,e,s){return n==="PreCompact"?e?{continue:!0,suppressOutput:!0}:{continue:!1,stopReason:s.reason||"Pre-compact operation failed",suppressOutput:!0}:n==="SessionStart"?e&&s.context?{continue:!0,suppressOutput:!0,hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:s.context}}:{continue:!0,suppressOutput:!0}:n==="UserPromptSubmit"||n==="PostToolUse"?{continue:!0,suppressOutput:!0}:n==="Stop"?{continue:!0,suppressOutput:!0}:{continue:e,suppressOutput:!0,...s.reason&&!e?{stopReason:s.reason}:{}}}function N(n,e,s={}){let t=H(n,e,s);return JSON.stringify(t)}import R from"path";import{existsSync as f}from"fs";import{spawn as G}from"child_process";var W=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),B=`http://127.0.0.1:${W}/health`;async function C(){try{return(await fetch(B,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function k(){try{if(await C())return!0;console.error("[claude-mem] Worker not responding, starting...");let n=v(),e=R.join(n,"plugin","scripts","worker-service.cjs");if(!f(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let s=R.join(n,"ecosystem.config.cjs"),t=R.join(n,"node_modules",".bin","pm2");if(!f(t))throw new Error(`PM2 binary not found at ${t}. This is a bundled dependency - try running: npm install`);if(!f(s))throw new Error(`PM2 ecosystem config not found at ${s}. Plugin installation may be corrupted.`);let r=G(t,["start",s],{detached:!0,stdio:"ignore",cwd:n});r.on("error",o=>{throw new Error(`Failed to spawn PM2: ${o.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let o=0;o<3;o++)if(await new Promise(i=>setTimeout(i,500)),await C())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(n){return console.error(`[claude-mem] Failed to start worker: ${n.message}`),!1}}var $=new Set(["ListMcpResourcesTool"]);async function j(n){if(!n)throw new Error("saveHook requires input");let{session_id:e,tool_name:s,tool_input:t,tool_output:r}=n;if($.has(s)){console.log(N("PostToolUse",!0));return}if(!await k())throw new Error("Worker service failed to start or become healthy");let i=new T,a=i.createSDKSession(e,"",""),d=i.getPromptCounter(a);i.close();let c=m.formatTool(s,t),E=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10);m.dataIn("HOOK",`PostToolUse: ${c}`,{sessionId:a,workerPort:E});let _=await fetch(`http://127.0.0.1:${E}/sessions/${a}/observations`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({tool_name:s,tool_input:t!==void 0?JSON.stringify(t):"{}",tool_output:r!==void 0?JSON.stringify(r):"{}",prompt_number:d}),signal:AbortSignal.timeout(2e3)});if(!_.ok){let l=await _.text();throw m.failure("HOOK","Failed to send observation",{sessionId:a,status:_.status},l),new Error(`Failed to send observation to worker: ${_.status} ${l}`)}m.debug("HOOK","Observation sent successfully",{sessionId:a,toolName:s}),console.log(N("PostToolUse",!0))}var O="";D.on("data",n=>O+=n);D.on("end",async()=>{let n=O?JSON.parse(O):void 0;await j(n)});

plugin/scripts/summary-hook.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import H from"better-sqlite3";import{join as a,dirname as w,basename as J}from"path";import{homedir as I}from"os";import{existsSync as ee,mkdirSync as X}from"fs";import{fileURLToPath as M}from"url";function P(){return typeof __dirname<"u"?__dirname:w(M(import.meta.url))}var F=P(),p=process.env.CLAUDE_MEM_DATA_DIR||a(I(),".claude-mem"),l=process.env.CLAUDE_CONFIG_DIR||a(I(),".claude"),te=a(p,"archives"),re=a(p,"logs"),oe=a(p,"trash"),ne=a(p,"backups"),ie=a(p,"settings.json"),L=a(p,"claude-mem.db"),ae=a(l,"settings.json"),de=a(l,"commands"),pe=a(l,"CLAUDE.md");function v(n){X(n,{recursive:!0})}function A(){return a(F,"..","..")}var T=(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))(T||{}),g=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=T[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,s){return`obs-${e}-${s}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
-${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Object.keys(e);return s.length===0?"{}":s.length<=3?JSON.stringify(e):`{${s.length} keys: ${s.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,s){if(!s)return e;try{let t=typeof s=="string"?JSON.parse(s):s;if(e==="Bash"&&t.command){let r=t.command.length>50?t.command.substring(0,50)+"...":t.command;return`${e}(${r})`}if(e==="Read"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Edit"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Write"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,s,t,r,o){if(e<this.level)return;let i=new Date().toISOString().replace("T"," ").substring(0,23),d=T[e].padEnd(5),c=s.padEnd(6),E="";r?.correlationId?E=`[${r.correlationId}] `:r?.sessionId&&(E=`[session-${r.sessionId}] `);let _="";o!=null&&(this.level===0&&typeof o=="object"?_=`
-`+JSON.stringify(o,null,2):_=" "+this.formatData(o));let R="";if(r){let{sessionId:G,sdkSessionId:K,correlationId:Y,...O}=r;Object.keys(O).length>0&&(R=` {${Object.entries(O).map(([x,U])=>`${x}=${U}`).join(", ")}}`)}let h=`[${i}] [${d}] [${c}] ${E}${t}${R}${_}`;e===3?console.error(h):console.log(h)}debug(e,s,t,r){this.log(0,e,s,t,r)}info(e,s,t,r){this.log(1,e,s,t,r)}warn(e,s,t,r){this.log(2,e,s,t,r)}error(e,s,t,r){this.log(3,e,s,t,r)}dataIn(e,s,t,r){this.info(e,`\u2192 ${s}`,t,r)}dataOut(e,s,t,r){this.info(e,`\u2190 ${s}`,t,r)}success(e,s,t,r){this.info(e,`\u2713 ${s}`,t,r)}failure(e,s,t,r){this.error(e,`\u2717 ${s}`,t,r)}timing(e,s,t,r){this.info(e,`\u23F1 ${s}`,r,{duration:`${t}ms`})}},u=new g;var m=class{db;constructor(){v(p),this.db=new H(L),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable()}initializeSchema(){try{this.db.exec(`
+import{stdin as D}from"process";import F from"better-sqlite3";import{join as p,dirname as U,basename as J}from"path";import{homedir as O}from"os";import{existsSync as ee,mkdirSync as w}from"fs";import{fileURLToPath as X}from"url";function M(){return typeof __dirname<"u"?__dirname:U(X(import.meta.url))}var P=M(),c=process.env.CLAUDE_MEM_DATA_DIR||p(O(),".claude-mem"),l=process.env.CLAUDE_CONFIG_DIR||p(O(),".claude"),te=p(c,"archives"),re=p(c,"logs"),ne=p(c,"trash"),oe=p(c,"backups"),ie=p(c,"settings.json"),I=p(c,"claude-mem.db"),ae=p(l,"settings.json"),de=p(l,"commands"),pe=p(l,"CLAUDE.md");function L(o){w(o,{recursive:!0})}function A(){return p(P,"..","..")}var T=(n=>(n[n.DEBUG=0]="DEBUG",n[n.INFO=1]="INFO",n[n.WARN=2]="WARN",n[n.ERROR=3]="ERROR",n[n.SILENT=4]="SILENT",n))(T||{}),S=class{level;useColor;constructor(){let e=process.env.CLAUDE_MEM_LOG_LEVEL?.toUpperCase()||"INFO";this.level=T[e]??1,this.useColor=process.stdout.isTTY??!1}correlationId(e,s){return`obs-${e}-${s}`}sessionId(e){return`session-${e}`}formatData(e){if(e==null)return"";if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return e.toString();if(typeof e=="object"){if(e instanceof Error)return this.level===0?`${e.message}
+${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Object.keys(e);return s.length===0?"{}":s.length<=3?JSON.stringify(e):`{${s.length} keys: ${s.slice(0,3).join(", ")}...}`}return String(e)}formatTool(e,s){if(!s)return e;try{let t=typeof s=="string"?JSON.parse(s):s;if(e==="Bash"&&t.command){let r=t.command.length>50?t.command.substring(0,50)+"...":t.command;return`${e}(${r})`}if(e==="Read"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Edit"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}if(e==="Write"&&t.file_path){let r=t.file_path.split("/").pop()||t.file_path;return`${e}(${r})`}return e}catch{return e}}log(e,s,t,r,n){if(e<this.level)return;let i=new Date().toISOString().replace("T"," ").substring(0,23),a=T[e].padEnd(5),d=s.padEnd(6),E="";r?.correlationId?E=`[${r.correlationId}] `:r?.sessionId&&(E=`[session-${r.sessionId}] `);let _="";n!=null&&(this.level===0&&typeof n=="object"?_=`
+`+JSON.stringify(n,null,2):_=" "+this.formatData(n));let b="";if(r){let{sessionId:j,sdkSessionId:K,correlationId:Y,...h}=r;Object.keys(h).length>0&&(b=` {${Object.entries(h).map(([y,x])=>`${y}=${x}`).join(", ")}}`)}let f=`[${i}] [${a}] [${d}] ${E}${t}${b}${_}`;e===3?console.error(f):console.log(f)}debug(e,s,t,r){this.log(0,e,s,t,r)}info(e,s,t,r){this.log(1,e,s,t,r)}warn(e,s,t,r){this.log(2,e,s,t,r)}error(e,s,t,r){this.log(3,e,s,t,r)}dataIn(e,s,t,r){this.info(e,`\u2192 ${s}`,t,r)}dataOut(e,s,t,r){this.info(e,`\u2190 ${s}`,t,r)}success(e,s,t,r){this.info(e,`\u2713 ${s}`,t,r)}failure(e,s,t,r){this.error(e,`\u2717 ${s}`,t,r)}timing(e,s,t,r){this.info(e,`\u23F1 ${s}`,r,{duration:`${t}ms`})}},u=new S;var m=class{db;constructor(){L(c),this.db=new F(I),this.db.pragma("journal_mode = WAL"),this.db.pragma("synchronous = NORMAL"),this.db.pragma("foreign_keys = ON"),this.initializeSchema(),this.ensureWorkerPortColumn(),this.ensurePromptTrackingColumns(),this.removeSessionSummariesUniqueConstraint(),this.addObservationHierarchicalFields(),this.makeObservationsTextNullable(),this.createUserPromptsTable()}initializeSchema(){try{this.db.exec(`
         CREATE TABLE IF NOT EXISTS schema_versions (
           id INTEGER PRIMARY KEY,
           version INTEGER UNIQUE NOT NULL,
@@ -63,7 +63,7 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
           CREATE INDEX IF NOT EXISTS idx_session_summaries_sdk_session ON session_summaries(sdk_session_id);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_project ON session_summaries(project);
           CREATE INDEX IF NOT EXISTS idx_session_summaries_created ON session_summaries(created_at_epoch DESC);
-        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(c=>c.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(c=>c.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(c=>c.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+        `),this.db.prepare("INSERT INTO schema_versions (version, applied_at) VALUES (?, ?)").run(4,new Date().toISOString()),console.error("[SessionStore] Migration004 applied successfully"))}catch(e){throw console.error("[SessionStore] Schema initialization error:",e.message),e}}ensureWorkerPortColumn(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(5))return;this.db.pragma("table_info(sdk_sessions)").some(r=>r.name==="worker_port")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN worker_port INTEGER"),console.error("[SessionStore] Added worker_port column to sdk_sessions table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(5,new Date().toISOString())}catch(e){console.error("[SessionStore] Migration error:",e.message)}}ensurePromptTrackingColumns(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(6))return;this.db.pragma("table_info(sdk_sessions)").some(d=>d.name==="prompt_counter")||(this.db.exec("ALTER TABLE sdk_sessions ADD COLUMN prompt_counter INTEGER DEFAULT 0"),console.error("[SessionStore] Added prompt_counter column to sdk_sessions table")),this.db.pragma("table_info(observations)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE observations ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to observations table")),this.db.pragma("table_info(session_summaries)").some(d=>d.name==="prompt_number")||(this.db.exec("ALTER TABLE session_summaries ADD COLUMN prompt_number INTEGER"),console.error("[SessionStore] Added prompt_number column to session_summaries table")),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(6,new Date().toISOString())}catch(e){console.error("[SessionStore] Prompt tracking migration error:",e.message)}}removeSessionSummariesUniqueConstraint(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(7))return;if(!this.db.pragma("index_list(session_summaries)").some(r=>r.unique===1)){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(7,new Date().toISOString());return}console.error("[SessionStore] Removing UNIQUE constraint from session_summaries.sdk_session_id..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
           CREATE TABLE session_summaries_new (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             sdk_session_id TEXT NOT NULL,
@@ -129,7 +129,44 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
           CREATE INDEX idx_observations_project ON observations(project);
           CREATE INDEX idx_observations_type ON observations(type);
           CREATE INDEX idx_observations_created ON observations(created_at_epoch DESC);
-        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}getRecentSummaries(e,s=10){return this.db.prepare(`
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(9,new Date().toISOString()),console.error("[SessionStore] Successfully made observations.text nullable")}catch(r){throw this.db.exec("ROLLBACK"),r}}catch(e){console.error("[SessionStore] Migration error (make text nullable):",e.message)}}createUserPromptsTable(){try{if(this.db.prepare("SELECT version FROM schema_versions WHERE version = ?").get(10))return;if(this.db.pragma("table_info(user_prompts)").length>0){this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString());return}console.error("[SessionStore] Creating user_prompts table with FTS5 support..."),this.db.exec("BEGIN TRANSACTION");try{this.db.exec(`
+          CREATE TABLE user_prompts (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            claude_session_id TEXT NOT NULL,
+            prompt_number INTEGER NOT NULL,
+            prompt_text TEXT NOT NULL,
+            created_at TEXT NOT NULL,
+            created_at_epoch INTEGER NOT NULL,
+            FOREIGN KEY(claude_session_id) REFERENCES sdk_sessions(claude_session_id) ON DELETE CASCADE
+          );
+
+          CREATE INDEX idx_user_prompts_claude_session ON user_prompts(claude_session_id);
+          CREATE INDEX idx_user_prompts_created ON user_prompts(created_at_epoch DESC);
+          CREATE INDEX idx_user_prompts_prompt_number ON user_prompts(prompt_number);
+        `),this.db.exec(`
+          CREATE VIRTUAL TABLE user_prompts_fts USING fts5(
+            prompt_text,
+            content='user_prompts',
+            content_rowid='id'
+          );
+        `),this.db.exec(`
+          CREATE TRIGGER user_prompts_ai AFTER INSERT ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_ad AFTER DELETE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_au AFTER UPDATE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+        `),this.db.exec("COMMIT"),this.db.prepare("INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)").run(10,new Date().toISOString()),console.error("[SessionStore] Successfully created user_prompts table with FTS5 support")}catch(t){throw this.db.exec("ROLLBACK"),t}}catch(e){console.error("[SessionStore] Migration error (create user_prompts table):",e.message)}}getRecentSummaries(e,s=10){return this.db.prepare(`
       SELECT
         request, investigated, learned, completed, next_steps,
         files_read, files_edited, notes, prompt_number, created_at
@@ -137,6 +174,14 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       WHERE project = ?
       ORDER BY created_at_epoch DESC
       LIMIT ?
+    `).all(e,s)}getRecentSummariesWithSessionInfo(e,s=3){return this.db.prepare(`
+      SELECT
+        sdk_session_id, request, learned, completed, next_steps,
+        prompt_number, created_at
+      FROM session_summaries
+      WHERE project = ?
+      ORDER BY created_at_epoch DESC
+      LIMIT ?
     `).all(e,s)}getRecentObservations(e,s=20){return this.db.prepare(`
       SELECT type, text, prompt_number, created_at
       FROM observations
@@ -173,8 +218,12 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       WHERE sdk_session_id = ?
       ORDER BY created_at_epoch DESC
       LIMIT 1
-    `).get(e)||null}getSessionById(e){return this.db.prepare(`
-      SELECT id, sdk_session_id, project, user_prompt
+    `).get(e)||null}getFilesForSession(e){let t=this.db.prepare(`
+      SELECT files_read, files_modified
+      FROM observations
+      WHERE sdk_session_id = ?
+    `).all(e),r=new Set,n=new Set;for(let i of t){if(i.files_read)try{let a=JSON.parse(i.files_read);Array.isArray(a)&&a.forEach(d=>r.add(d))}catch{}if(i.files_modified)try{let a=JSON.parse(i.files_modified);Array.isArray(a)&&a.forEach(d=>n.add(d))}catch{}}return{filesRead:Array.from(r),filesModified:Array.from(n)}}getSessionById(e){return this.db.prepare(`
+      SELECT id, claude_session_id, sdk_session_id, project, user_prompt
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
@@ -200,11 +249,13 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
     `).get(e)?.prompt_counter||1}getPromptCounter(e){return this.db.prepare(`
       SELECT prompt_counter FROM sdk_sessions WHERE id = ?
-    `).get(e)?.prompt_counter||0}createSDKSession(e,s,t){let r=new Date,o=r.getTime();return this.db.prepare(`
-      INSERT INTO sdk_sessions
-      (claude_session_id, project, user_prompt, started_at, started_at_epoch, status)
-      VALUES (?, ?, ?, ?, ?, 'active')
-    `).run(e,s,t,r.toISOString(),o).lastInsertRowid}updateSDKSessionId(e,s){return this.db.prepare(`
+    `).get(e)?.prompt_counter||0}createSDKSession(e,s,t){let r=new Date,n=r.getTime(),a=this.db.prepare(`
+      INSERT OR IGNORE INTO sdk_sessions
+      (claude_session_id, sdk_session_id, project, user_prompt, started_at, started_at_epoch, status)
+      VALUES (?, ?, ?, ?, ?, ?, 'active')
+    `).run(e,e,s,t,r.toISOString(),n);return a.lastInsertRowid===0||a.changes===0?this.db.prepare(`
+        SELECT id FROM sdk_sessions WHERE claude_session_id = ? LIMIT 1
+      `).get(e).id:a.lastInsertRowid}updateSDKSessionId(e,s){return this.db.prepare(`
       UPDATE sdk_sessions
       SET sdk_session_id = ?
       WHERE id = ? AND sdk_session_id IS NULL
@@ -217,17 +268,33 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
-    `).get(e)?.worker_port||null}storeObservation(e,s,t,r){let o=new Date,i=o.getTime();this.db.prepare(`
+    `).get(e)?.worker_port||null}saveUserPrompt(e,s,t){let r=new Date,n=r.getTime();return this.db.prepare(`
+      INSERT INTO user_prompts
+      (claude_session_id, prompt_number, prompt_text, created_at, created_at_epoch)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(e,s,t,r.toISOString(),n).lastInsertRowid}storeObservation(e,s,t,r){let n=new Date,i=n.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,s,n.toISOString(),i),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO observations
       (sdk_session_id, project, type, title, subtitle, facts, narrative, concepts,
        files_read, files_modified, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,s,t.type,t.title,t.subtitle,JSON.stringify(t.facts),t.narrative,JSON.stringify(t.concepts),JSON.stringify(t.files_read),JSON.stringify(t.files_modified),r||null,o.toISOString(),i)}storeSummary(e,s,t,r){let o=new Date,i=o.getTime();this.db.prepare(`
+    `).run(e,s,t.type,t.title,t.subtitle,JSON.stringify(t.facts),t.narrative,JSON.stringify(t.concepts),JSON.stringify(t.files_read),JSON.stringify(t.files_modified),r||null,n.toISOString(),i)}storeSummary(e,s,t,r){let n=new Date,i=n.getTime();this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `).get(e)||(this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `).run(e,e,s,n.toISOString(),i),console.error(`[SessionStore] Auto-created session record for session_id: ${e}`)),this.db.prepare(`
       INSERT INTO session_summaries
       (sdk_session_id, project, request, investigated, learned, completed,
        next_steps, notes, prompt_number, created_at, created_at_epoch)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(e,s,t.request,t.investigated,t.learned,t.completed,t.next_steps,t.notes,r||null,o.toISOString(),i)}markSessionCompleted(e){let s=new Date,t=s.getTime();this.db.prepare(`
+    `).run(e,s,t.request,t.investigated,t.learned,t.completed,t.next_steps,t.notes,r||null,n.toISOString(),i)}markSessionCompleted(e){let s=new Date,t=s.getTime();this.db.prepare(`
       UPDATE sdk_sessions
       SET status = 'completed', completed_at = ?, completed_at_epoch = ?
       WHERE id = ?
@@ -239,4 +306,4 @@ ${e.stack}`:e.message;if(Array.isArray(e))return`[${e.length} items]`;let s=Obje
       UPDATE sdk_sessions
       SET status = 'failed', completed_at = ?, completed_at_epoch = ?
       WHERE status = 'active'
-    `).run(e.toISOString(),s).changes}close(){this.db.close()}};function W(n,e,s){return n==="PreCompact"?e?{continue:!0,suppressOutput:!0}:{continue:!1,stopReason:s.reason||"Pre-compact operation failed",suppressOutput:!0}:n==="SessionStart"?e&&s.context?{continue:!0,suppressOutput:!0,hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:s.context}}:{continue:!0,suppressOutput:!0}:n==="UserPromptSubmit"||n==="PostToolUse"?{continue:!0,suppressOutput:!0}:n==="Stop"?{continue:!0,suppressOutput:!0}:{continue:e,suppressOutput:!0,...s.reason&&!e?{stopReason:s.reason}:{}}}function S(n,e,s={}){let t=W(n,e,s);return JSON.stringify(t)}import b from"path";import{existsSync as N}from"fs";import{spawn as $}from"child_process";var j=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),B=`http://127.0.0.1:${j}/health`;async function k(){try{return(await fetch(B,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function C(){try{if(await k())return!0;console.error("[claude-mem] Worker not responding, starting...");let n=A(),e=b.join(n,"plugin","scripts","worker-service.cjs");if(!N(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let s=b.join(n,"ecosystem.config.cjs"),t=b.join(n,"node_modules",".bin","pm2");if(!N(t))throw new Error(`PM2 binary not found at ${t}. This is a bundled dependency - try running: npm install`);if(!N(s))throw new Error(`PM2 ecosystem config not found at ${s}. Plugin installation may be corrupted.`);let r=$(t,["start",s],{detached:!0,stdio:"ignore",cwd:n});r.on("error",o=>{throw new Error(`Failed to spawn PM2: ${o.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let o=0;o<3;o++)if(await new Promise(i=>setTimeout(i,500)),await k())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(n){return console.error(`[claude-mem] Failed to start worker: ${n.message}`),!1}}async function D(n){if(!n)throw new Error("summaryHook requires input");let{session_id:e}=n;if(!await C())throw new Error("Worker service failed to start or become healthy");let t=new m,r=t.findActiveSDKSession(e);if(!r){t.close(),console.log(S("Stop",!0));return}if(!r.worker_port)throw t.close(),u.error("HOOK","No worker port for session",{sessionId:r.id}),new Error("No worker port for session - session may not be properly initialized");let o=t.getPromptCounter(r.id);t.close(),u.dataIn("HOOK","Stop: Requesting summary",{sessionId:r.id,workerPort:r.worker_port,promptNumber:o});let i=await fetch(`http://127.0.0.1:${r.worker_port}/sessions/${r.id}/summarize`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({prompt_number:o}),signal:AbortSignal.timeout(2e3)});if(!i.ok){let d=await i.text();throw u.failure("HOOK","Failed to generate summary",{sessionId:r.id,status:i.status},d),new Error(`Failed to request summary from worker: ${i.status} ${d}`)}u.debug("HOOK","Summary request sent successfully",{sessionId:r.id}),console.log(S("Stop",!0))}import{stdin as y}from"process";var f="";y.on("data",n=>f+=n);y.on("end",async()=>{let n=f.trim()?JSON.parse(f):void 0;await D(n),process.exit(0)});
+    `).run(e.toISOString(),s).changes}close(){this.db.close()}};function H(o,e,s){return o==="PreCompact"?e?{continue:!0,suppressOutput:!0}:{continue:!1,stopReason:s.reason||"Pre-compact operation failed",suppressOutput:!0}:o==="SessionStart"?e&&s.context?{continue:!0,suppressOutput:!0,hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:s.context}}:{continue:!0,suppressOutput:!0}:o==="UserPromptSubmit"||o==="PostToolUse"?{continue:!0,suppressOutput:!0}:o==="Stop"?{continue:!0,suppressOutput:!0}:{continue:e,suppressOutput:!0,...s.reason&&!e?{stopReason:s.reason}:{}}}function v(o,e,s={}){let t=H(o,e,s);return JSON.stringify(t)}import g from"path";import{existsSync as R}from"fs";import{spawn as G}from"child_process";var W=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10),B=`http://127.0.0.1:${W}/health`;async function C(){try{return(await fetch(B,{signal:AbortSignal.timeout(500)})).ok}catch{return!1}}async function k(){try{if(await C())return!0;console.error("[claude-mem] Worker not responding, starting...");let o=A(),e=g.join(o,"plugin","scripts","worker-service.cjs");if(!R(e))return console.error(`[claude-mem] Worker service not found at ${e}`),!1;let s=g.join(o,"ecosystem.config.cjs"),t=g.join(o,"node_modules",".bin","pm2");if(!R(t))throw new Error(`PM2 binary not found at ${t}. This is a bundled dependency - try running: npm install`);if(!R(s))throw new Error(`PM2 ecosystem config not found at ${s}. Plugin installation may be corrupted.`);let r=G(t,["start",s],{detached:!0,stdio:"ignore",cwd:o});r.on("error",n=>{throw new Error(`Failed to spawn PM2: ${n.message}`)}),r.unref(),console.error("[claude-mem] Worker started with PM2");for(let n=0;n<3;n++)if(await new Promise(i=>setTimeout(i,500)),await C())return console.error("[claude-mem] Worker is healthy"),!0;return console.error("[claude-mem] Worker failed to become healthy after startup"),!1}catch(o){return console.error(`[claude-mem] Failed to start worker: ${o.message}`),!1}}async function $(o){if(!o)throw new Error("summaryHook requires input");let{session_id:e}=o;if(!await k())throw new Error("Worker service failed to start or become healthy");let t=new m,r=t.createSDKSession(e,"",""),n=t.getPromptCounter(r);t.close();let i=parseInt(process.env.CLAUDE_MEM_WORKER_PORT||"37777",10);u.dataIn("HOOK","Stop: Requesting summary",{sessionId:r,workerPort:i,promptNumber:n});let a=await fetch(`http://127.0.0.1:${i}/sessions/${r}/summarize`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({prompt_number:n}),signal:AbortSignal.timeout(2e3)});if(!a.ok){let d=await a.text();throw u.failure("HOOK","Failed to generate summary",{sessionId:r,status:a.status},d),new Error(`Failed to request summary from worker: ${a.status} ${d}`)}u.debug("HOOK","Summary request sent successfully",{sessionId:r}),console.log(v("Stop",!0))}var N="";D.on("data",o=>N+=o);D.on("end",async()=>{let o=N?JSON.parse(N):void 0;await $(o)});

scripts/build-hooks.js

@@ -13,11 +13,11 @@ import { fileURLToPath } from 'url';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 const HOOKS = [
-  { name: 'context-hook', source: 'src/bin/hooks/context-hook.ts' },
-  { name: 'new-hook', source: 'src/bin/hooks/new-hook.ts' },
-  { name: 'save-hook', source: 'src/bin/hooks/save-hook.ts' },
-  { name: 'summary-hook', source: 'src/bin/hooks/summary-hook.ts' },
-  { name: 'cleanup-hook', source: 'src/bin/hooks/cleanup-hook.ts' }
+  { name: 'context-hook', source: 'src/hooks/context-hook.ts' },
+  { name: 'new-hook', source: 'src/hooks/new-hook.ts' },
+  { name: 'save-hook', source: 'src/hooks/save-hook.ts' },
+  { name: 'summary-hook', source: 'src/hooks/summary-hook.ts' },
+  { name: 'cleanup-hook', source: 'src/hooks/cleanup-hook.ts' }
 ];
 
 const WORKER_SERVICE = {

src/bin/hooks/cleanup-hook.ts

@@ -1,22 +0,0 @@
-
-/**
- * Cleanup Hook Entry Point - SessionEnd
- * Standalone executable for plugin hooks
- */
-
-import { cleanupHook } from '../../hooks/cleanup.js';
-import { stdin } from 'process';
-
-// Read input from stdin
-let input = '';
-stdin.on('data', (chunk) => input += chunk);
-stdin.on('end', async () => {
-  try {
-    const parsed = input.trim() ? JSON.parse(input) : undefined;
-    await cleanupHook(parsed);
-  } catch (error: any) {
-    console.error(`[claude-mem cleanup-hook error: ${error.message}]`);
-    console.log('{"continue": true, "suppressOutput": true}');
-    process.exit(0);
-  }
-});

src/bin/hooks/context-hook.ts

@@ -1,40 +0,0 @@
-
-/**
- * Context Hook Entry Point - SessionStart
- * Standalone executable for plugin hooks
- */
-
-import { contextHook } from '../../hooks/context.js';
-import { stdin } from 'process';
-
-try {
-  if (stdin.isTTY) {
-    const contextOutput = contextHook();
-    const result = {
-      hookSpecificOutput: {
-        hookEventName: "SessionStart",
-        additionalContext: contextOutput
-      }
-    };
-    console.log(JSON.stringify(result));
-    process.exit(0);
-  } else {
-    let input = '';
-    stdin.on('data', (chunk) => input += chunk);
-    stdin.on('end', () => {
-      const parsed = input.trim() ? JSON.parse(input) : undefined;
-      const contextOutput = contextHook(parsed);
-      const result = {
-        hookSpecificOutput: {
-          hookEventName: "SessionStart",
-          additionalContext: contextOutput
-        }
-      };
-      console.log(JSON.stringify(result));
-      process.exit(0);
-    });
-  }
-} catch (error: any) {
-  console.error(`[claude-mem context-hook error: ${error.message}]`);
-  process.exit(0);
-}

src/bin/hooks/new-hook.ts

@@ -1,17 +0,0 @@
-
-/**
- * New Hook Entry Point - UserPromptSubmit
- * Standalone executable for plugin hooks
- */
-
-import { newHook } from '../../hooks/new.js';
-import { stdin } from 'process';
-
-// Read input from stdin
-let input = '';
-stdin.on('data', (chunk) => input += chunk);
-stdin.on('end', async () => {
-  const parsed = input.trim() ? JSON.parse(input) : undefined;
-  await newHook(parsed);
-  process.exit(0);
-});

src/bin/hooks/save-hook.ts

@@ -1,17 +0,0 @@
-
-/**
- * Save Hook Entry Point - PostToolUse
- * Standalone executable for plugin hooks
- */
-
-import { saveHook } from '../../hooks/save.js';
-import { stdin } from 'process';
-
-// Read input from stdin
-let input = '';
-stdin.on('data', (chunk) => input += chunk);
-stdin.on('end', async () => {
-  const parsed = input.trim() ? JSON.parse(input) : undefined;
-  await saveHook(parsed);
-  process.exit(0);
-});

src/bin/hooks/summary-hook.ts

@@ -1,17 +0,0 @@
-
-/**
- * Summary Hook Entry Point - Stop
- * Standalone executable for plugin hooks
- */
-
-import { summaryHook } from '../../hooks/summary.js';
-import { stdin } from 'process';
-
-// Read input from stdin
-let input = '';
-stdin.on('data', (chunk) => input += chunk);
-stdin.on('end', async () => {
-  const parsed = input.trim() ? JSON.parse(input) : undefined;
-  await summaryHook(parsed);
-  process.exit(0);
-});

src/bin/hooks/worker.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Worker Entry Point
- * Standalone background process for SDK agent
- */
-
-import { main } from '../../sdk/worker.js';
-
-// Entry point - just call the worker main function
-main().catch((error) => {
-  console.error('[SDK Worker] Fatal error:', error);
-  process.exit(1);
-});

src/bin/import-xml-observations.ts

@@ -61,7 +61,7 @@ function buildTimestampMap(): TimestampMapping {
         const data = JSON.parse(line);
         const timestamp = data.timestamp;
         const sessionId = data.sessionId;
-        const project = data.cwd || '/Users/alexnewman/Scripts/claude-mem';
+        const project = data.cwd;
 
         if (timestamp && sessionId) {
           // Round timestamp to second for matching with XML timestamps

src/hooks/cleanup-hook.ts

@@ -0,0 +1,95 @@
+/**
+ * Cleanup Hook - SessionEnd
+ * Consolidated entry point + logic
+ */
+
+import { stdin } from 'process';
+import { SessionStore } from '../services/sqlite/SessionStore.js';
+import { ensureWorkerRunning } from '../shared/worker-utils.js';
+
+export interface SessionEndInput {
+  session_id: string;
+  cwd: string;
+  transcript_path?: string;
+  hook_event_name: string;
+  reason: 'exit' | 'clear' | 'logout' | 'prompt_input_exit' | 'other';
+}
+
+/**
+ * Cleanup Hook Main Logic
+ */
+async function cleanupHook(input?: SessionEndInput): Promise<void> {
+  // Log hook entry point
+  console.error('[claude-mem cleanup] Hook fired', {
+    input: input ? {
+      session_id: input.session_id,
+      cwd: input.cwd,
+      reason: input.reason
+    } : null
+  });
+
+  // Handle standalone execution (no input provided)
+  if (!input) {
+    console.log('No input provided - this script is designed to run as a Claude Code SessionEnd hook');
+    console.log('\nExpected input format:');
+    console.log(JSON.stringify({
+      session_id: "string",
+      cwd: "string",
+      transcript_path: "string",
+      hook_event_name: "SessionEnd",
+      reason: "exit"
+    }, null, 2));
+    process.exit(0);
+  }
+
+  const { session_id, reason } = input;
+  console.error('[claude-mem cleanup] Searching for active SDK session', { session_id, reason });
+
+  // Ensure worker is running first
+  const workerReady = await ensureWorkerRunning();
+  if (!workerReady) {
+    console.error('[claude-mem cleanup] Worker not available - skipping HTTP cleanup');
+  }
+
+  // Find active SDK session
+  const db = new SessionStore();
+  const session = db.findActiveSDKSession(session_id);
+
+  if (!session) {
+    // No active session - nothing to clean up
+    console.error('[claude-mem cleanup] No active SDK session found', { session_id });
+    db.close();
+    console.log('{"continue": true, "suppressOutput": true}');
+    process.exit(0);
+  }
+
+  console.error('[claude-mem cleanup] Active SDK session found', {
+    session_id: session.id,
+    sdk_session_id: session.sdk_session_id,
+    project: session.project,
+    worker_port: session.worker_port
+  });
+
+  // Mark session as completed in DB
+  db.markSessionCompleted(session.id);
+  console.error('[claude-mem cleanup] Session marked as completed in database');
+
+  db.close();
+
+  console.error('[claude-mem cleanup] Cleanup completed successfully');
+  console.log('{"continue": true, "suppressOutput": true}');
+  process.exit(0);
+}
+
+// Entry Point
+if (stdin.isTTY) {
+  // Running manually
+  cleanupHook(undefined);
+} else {
+  let input = '';
+  stdin.on('data', (chunk) => input += chunk);
+  stdin.on('end', async () => {
+    const parsed = input ? JSON.parse(input) : undefined;
+    await cleanupHook(parsed);
+  });
+}

src/hooks/cleanup.ts

@@ -1,98 +0,0 @@
-import { SessionStore } from '../services/sqlite/SessionStore.js';
-import { ensureWorkerRunning } from '../shared/worker-utils.js';
-
-export interface SessionEndInput {
-  session_id: string;
-  cwd: string;
-  transcript_path?: string;
-  hook_event_name: string;
-  reason: 'exit' | 'clear' | 'logout' | 'prompt_input_exit' | 'other';
-}
-
-/**
- * Cleanup Hook - SessionEnd
- * Marks session as completed when Claude Code session ends
- *
- * This hook runs when a Claude Code session ends. It:
- * 1. Finds active SDK session for this Claude session
- * 2. Marks session as completed in database
- * 3. Allows worker to finish pending operations naturally
- */
-export async function cleanupHook(input?: SessionEndInput): Promise<void> {
-  try {
-    // Log hook entry point
-    console.error('[claude-mem cleanup] Hook fired', {
-      input: input ? {
-        session_id: input.session_id,
-        cwd: input.cwd,
-        reason: input.reason
-      } : null
-    });
-
-    // Handle standalone execution (no input provided)
-    if (!input) {
-      console.log('No input provided - this script is designed to run as a Claude Code SessionEnd hook');
-      console.log('\nExpected input format:');
-      console.log(JSON.stringify({
-        session_id: "string",
-        cwd: "string",
-        transcript_path: "string",
-        hook_event_name: "SessionEnd",
-        reason: "exit"
-      }, null, 2));
-      process.exit(0);
-    }
-
-    const { session_id, reason } = input;
-    console.error('[claude-mem cleanup] Searching for active SDK session', { session_id, reason });
-
-    // Ensure worker is running first (runs cleanup if restarting)
-    const workerReady = await ensureWorkerRunning();
-    if (!workerReady) {
-      console.error('[claude-mem cleanup] Worker not available - skipping HTTP cleanup');
-    }
-
-    // Find active SDK session
-    const db = new SessionStore();
-    const session = db.findActiveSDKSession(session_id);
-
-    if (!session) {
-      // No active session - nothing to clean up
-      console.error('[claude-mem cleanup] No active SDK session found', { session_id });
-      db.close();
-      console.log('{"continue": true, "suppressOutput": true}');
-      process.exit(0);
-    }
-
-    console.error('[claude-mem cleanup] Active SDK session found', {
-      session_id: session.id,
-      sdk_session_id: session.sdk_session_id,
-      project: session.project,
-      worker_port: session.worker_port
-    });
-
-    // 1. Mark session as completed in DB (if not already completed)
-    try {
-      db.markSessionCompleted(session.id);
-      console.error('[claude-mem cleanup] Session marked as completed in database');
-    } catch (markErr: any) {
-      console.error('[claude-mem cleanup] Failed to mark session as completed:', markErr);
-    }
-
-    db.close();
-
-    console.error('[claude-mem cleanup] Cleanup completed successfully');
-    console.log('{"continue": true, "suppressOutput": true}');
-    process.exit(0);
-
-  } catch (error: any) {
-    // On error, don't block Claude Code exit
-    console.error('[claude-mem cleanup] Unexpected error in hook', {
-      error: error.message,
-      stack: error.stack,
-      name: error.name
-    });
-    console.log('{"continue": true, "suppressOutput": true}');
-    process.exit(0);
-  }
-}

src/hooks/context-hook.ts

@@ -0,0 +1,439 @@
+/**
+ * Context Hook - SessionStart
+ * Consolidated entry point + logic (no try-catch bullshit)
+ */
+
+import path from 'path';
+import { stdin } from 'process';
+import { SessionStore } from '../services/sqlite/SessionStore.js';
+import { ensureWorkerRunning } from '../shared/worker-utils.js';
+
+export interface SessionStartInput {
+  session_id?: string;
+  transcript_path?: string;
+  cwd?: string;
+  hook_event_name?: string;
+  source?: "startup" | "resume" | "clear" | "compact";
+  [key: string]: any;
+}
+
+// ANSI color codes for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  gray: '\x1b[90m',
+  red: '\x1b[31m',
+};
+
+interface Observation {
+  id: number;
+  sdk_session_id: string;
+  type: string;
+  title: string | null;
+  subtitle: string | null;
+  narrative: string | null;
+  facts: string | null;
+  concepts: string | null;
+  files_read: string | null;
+  files_modified: string | null;
+  created_at: string;
+  created_at_epoch: number;
+}
+
+// Helper: Parse JSON array safely
+function parseJsonArray(json: string | null): string[] {
+  if (!json) return [];
+  const parsed = JSON.parse(json);
+  return Array.isArray(parsed) ? parsed : [];
+}
+
+// Helper: Format date with time
+function formatDateTime(dateStr: string): string {
+  const date = new Date(dateStr);
+  return date.toLocaleString('en-US', {
+    month: 'short',
+    day: 'numeric',
+    hour: 'numeric',
+    minute: '2-digit',
+    hour12: true
+  });
+}
+
+// Helper: Format just time (no date)
+function formatTime(dateStr: string): string {
+  const date = new Date(dateStr);
+  return date.toLocaleString('en-US', {
+    hour: 'numeric',
+    minute: '2-digit',
+    hour12: true
+  });
+}
+
+// Helper: Format just date
+function formatDate(dateStr: string): string {
+  const date = new Date(dateStr);
+  return date.toLocaleString('en-US', {
+    month: 'short',
+    day: 'numeric',
+    year: 'numeric'
+  });
+}
+
+// Helper: Estimate token count for text
+function estimateTokens(text: string | null): number {
+  if (!text) return 0;
+  // Rough estimate: ~4 characters per token
+  return Math.ceil(text.length / 4);
+}
+
+// Helper: Convert absolute paths to relative paths
+function toRelativePath(filePath: string, cwd: string): string {
+  if (path.isAbsolute(filePath)) {
+    return path.relative(cwd, filePath);
+  }
+  return filePath;
+}
+
+// Helper: Get all observations for given sessions
+function getObservations(db: SessionStore, sessionIds: string[]): Observation[] {
+  if (sessionIds.length === 0) return [];
+
+  const placeholders = sessionIds.map(() => '?').join(',');
+  const observations = db.db.prepare(`
+    SELECT
+      id, sdk_session_id, type, title, subtitle, narrative,
+      facts, concepts, files_read, files_modified,
+      created_at, created_at_epoch
+    FROM observations
+    WHERE sdk_session_id IN (${placeholders})
+    ORDER BY created_at_epoch DESC
+  `).all(...sessionIds) as Observation[];
+
+  return observations;
+}
+
+/**
+ * Context Hook Main Logic
+ */
+function contextHook(input?: SessionStartInput, useColors: boolean = false, useIndexView: boolean = false): string {
+  ensureWorkerRunning();
+  const cwd = input?.cwd ?? process.cwd();
+  const project = cwd ? path.basename(cwd) : 'unknown-project';
+
+  const db = new SessionStore();
+
+  // Get last 4 summaries (use 4th for offset calculation)
+  const recentSummaries = db.db.prepare(`
+    SELECT id, sdk_session_id, request, completed, next_steps, created_at, created_at_epoch
+    FROM session_summaries
+    WHERE project = ?
+    ORDER BY created_at_epoch DESC
+    LIMIT 4
+  `).all(project) as Array<{ id: number; sdk_session_id: string; request: string | null; completed: string | null; next_steps: string | null; created_at: string; created_at_epoch: number }>;
+
+  if (recentSummaries.length === 0) {
+    db.close();
+    if (useColors) {
+      return `\n${colors.bright}${colors.cyan}📝 [${project}] recent context${colors.reset}\n${colors.gray}${'─'.repeat(60)}${colors.reset}\n\n${colors.dim}No previous sessions found for this project yet.${colors.reset}\n`;
+    }
+    return `# [${project}] recent context\n\nNo previous sessions found for this project yet.`;
+  }
+
+  // Extract unique session IDs from first 3 summaries
+  const displaySummaries = recentSummaries.slice(0, 3);
+  const sessionIds = [...new Set(displaySummaries.map(s => s.sdk_session_id))];
+
+  // Get all observations from these sessions
+  const observations = getObservations(db, sessionIds);
+
+  // Filter observations by key concepts for timeline
+  const timelineObs = observations.filter(obs => {
+    const concepts = parseJsonArray(obs.concepts);
+    return concepts.includes('what-changed') ||
+           concepts.includes('how-it-works') ||
+           concepts.includes('problem-solution') ||
+           concepts.includes('gotcha') ||
+           concepts.includes('discovery') ||
+           concepts.includes('why-it-exists') ||
+           concepts.includes('decision') ||
+           concepts.includes('trade-off');
+  });
+
+  // Build output
+  const output: string[] = [];
+
+  // Header
+  if (useColors) {
+    output.push('');
+    output.push(`${colors.bright}${colors.cyan}📝 [${project}] recent context${colors.reset}`);
+    output.push(`${colors.gray}${'─'.repeat(60)}${colors.reset}`);
+    output.push('');
+  } else {
+    output.push(`# [${project}] recent context`);
+    output.push('');
+  }
+
+  // Chronological Timeline
+  if (timelineObs.length > 0) {
+    // Legend/Key
+    if (useColors) {
+      output.push(`${colors.dim}Legend: 🎯 session-request | 🔴 gotcha | 🟡 problem-solution | 🔵 how-it-works | 🟢 what-changed | 🟣 discovery | 🟠 why-it-exists | 🟤 decision | ⚖️ trade-off${colors.reset}`);
+      output.push('');
+    } else {
+      output.push(`**Legend:** 🎯 session-request | 🔴 gotcha | 🟡 problem-solution | 🔵 how-it-works | 🟢 what-changed | 🟣 discovery | 🟠 why-it-exists | 🟤 decision | ⚖️ trade-off`);
+      output.push('');
+    }
+
+    // Progressive Disclosure Usage Instructions
+    if (useColors) {
+      output.push(`${colors.dim}💡 Progressive Disclosure: This index shows WHAT exists (titles) and retrieval COST (token counts).${colors.reset}`);
+      output.push(`${colors.dim}   → Use MCP search tools to fetch full observation details on-demand (Layer 2)${colors.reset}`);
+      output.push(`${colors.dim}   → Prefer searching observations over re-reading code for past decisions and learnings${colors.reset}`);
+      output.push(`${colors.dim}   → Critical types (🔴 gotcha, 🟤 decision, ⚖️ trade-off) often worth fetching immediately${colors.reset}`);
+      output.push('');
+    } else {
+      output.push(`💡 **Progressive Disclosure:** This index shows WHAT exists (titles) and retrieval COST (token counts).`);
+      output.push(`- Use MCP search tools to fetch full observation details on-demand (Layer 2)`);
+      output.push(`- Prefer searching observations over re-reading code for past decisions and learnings`);
+      output.push(`- Critical types (🔴 gotcha, 🟤 decision, ⚖️ trade-off) often worth fetching immediately`);
+      output.push('');
+    }
+
+    // Create unified timeline with both observations and summaries
+    const mostRecentSummaryId = recentSummaries[0]?.id;
+
+    // Create offset summaries
+    const summariesWithOffset = displaySummaries.map((summary, i) => {
+      // Most recent keeps its own time, others offset to next summary's time
+      const nextSummary = i === 0 ? null : recentSummaries[i + 1];
+      return {
+        ...summary,
+        displayEpoch: nextSummary ? nextSummary.created_at_epoch : summary.created_at_epoch,
+        displayTime: nextSummary ? nextSummary.created_at : summary.created_at,
+        isMostRecent: summary.id === mostRecentSummaryId
+      };
+    });
+
+    type TimelineItem =
+      | { type: 'observation'; data: Observation }
+      | { type: 'summary'; data: typeof summariesWithOffset[0] };
+
+    const timeline: TimelineItem[] = [
+      ...timelineObs.map(obs => ({ type: 'observation' as const, data: obs })),
+      ...summariesWithOffset.map(summary => ({ type: 'summary' as const, data: summary }))
+    ];
+
+    // Sort chronologically
+    timeline.sort((a, b) => {
+      const aEpoch = a.type === 'observation' ? a.data.created_at_epoch : a.data.displayEpoch;
+      const bEpoch = b.type === 'observation' ? b.data.created_at_epoch : b.data.displayEpoch;
+      return aEpoch - bEpoch;
+    });
+
+    // Group by day for rendering
+    const dayTimelines = new Map<string, typeof timeline>();
+    for (const item of timeline) {
+      const itemDate = item.type === 'observation' ? item.data.created_at : item.data.displayTime;
+      const day = formatDate(itemDate);
+      if (!dayTimelines.has(day)) {
+        dayTimelines.set(day, []);
+      }
+      dayTimelines.get(day)!.push(item);
+    }
+
+    // Sort days chronologically
+    const sortedDays = Array.from(dayTimelines.entries()).sort((a, b) => {
+      const aDate = new Date(a[0]).getTime();
+      const bDate = new Date(b[0]).getTime();
+      return aDate - bDate;
+    });
+
+    // Render each day's timeline
+    for (const [day, dayItems] of sortedDays) {
+      // Day header
+      if (useColors) {
+        output.push(`${colors.bright}${colors.cyan}${day}${colors.reset}`);
+        output.push('');
+      } else {
+        output.push(`### ${day}`);
+        output.push('');
+      }
+
+      // Render items chronologically with visual file grouping
+      let currentFile: string | null = null;
+      let lastTime = '';
+      let tableOpen = false;
+
+      for (const item of dayItems) {
+        if (item.type === 'summary') {
+          // Close any open table
+          if (tableOpen) {
+            output.push('');
+            tableOpen = false;
+            currentFile = null;
+            lastTime = '';
+          }
+
+          // Render summary
+          const summary = item.data;
+          const summaryTitle = `${summary.request || 'Session started'} (${formatDateTime(summary.displayTime)})`;
+          const link = summary.isMostRecent ? '' : `claude-mem://session-summary/${summary.id}`;
+
+          if (useColors) {
+            const linkPart = link ? `${colors.dim}[${link}]${colors.reset}` : '';
+            output.push(`🎯 ${colors.yellow}#S${summary.id}${colors.reset} ${summaryTitle} ${linkPart}`);
+          } else {
+            const linkPart = link ? ` [→](${link})` : '';
+            output.push(`**🎯 #S${summary.id}** ${summaryTitle}${linkPart}`);
+          }
+          output.push('');
+        } else {
+          // Render observation
+          const obs = item.data;
+          const files = parseJsonArray(obs.files_modified);
+          const file = files.length > 0 ? toRelativePath(files[0], cwd) : 'General';
+
+          // Check if we need a new file section
+          if (file !== currentFile) {
+            // Close previous table
+            if (tableOpen) {
+              output.push('');
+            }
+
+            // File header
+            if (useColors) {
+              output.push(`${colors.dim}${file}${colors.reset}`);
+            } else {
+              output.push(`**${file}**`);
+            }
+
+            // Table header (markdown only)
+            if (!useColors) {
+              output.push(`| ID | Time | T | Title | Tokens |`);
+              output.push(`|----|------|---|-------|--------|`);
+            }
+
+            currentFile = file;
+            tableOpen = true;
+            lastTime = '';
+          }
+
+          // Render observation row
+          const concepts = parseJsonArray(obs.concepts);
+          let icon = '•';
+
+          // Priority order: gotcha > decision > trade-off > problem-solution > discovery > why-it-exists > how-it-works > what-changed
+          if (concepts.includes('gotcha')) {
+            icon = '🔴';
+          } else if (concepts.includes('decision')) {
+            icon = '🟤';
+          } else if (concepts.includes('trade-off')) {
+            icon = '⚖️';
+          } else if (concepts.includes('problem-solution')) {
+            icon = '🟡';
+          } else if (concepts.includes('discovery')) {
+            icon = '🟣';
+          } else if (concepts.includes('why-it-exists')) {
+            icon = '🟠';
+          } else if (concepts.includes('how-it-works')) {
+            icon = '🔵';
+          } else if (concepts.includes('what-changed')) {
+            icon = '🟢';
+          }
+
+          const time = formatTime(obs.created_at);
+          const title = obs.title || 'Untitled';
+          const tokens = estimateTokens(obs.narrative);
+
+          const showTime = time !== lastTime;
+          const timeDisplay = showTime ? time : '';
+          lastTime = time;
+
+          if (useColors) {
+            const timePart = showTime ? `${colors.dim}${time}${colors.reset}` : ' '.repeat(time.length);
+            const tokensPart = tokens > 0 ? `${colors.dim}(~${tokens}t)${colors.reset}` : '';
+            output.push(`  ${colors.dim}#${obs.id}${colors.reset}  ${timePart}  ${icon}  ${title} ${tokensPart}`);
+          } else {
+            output.push(`| #${obs.id} | ${timeDisplay || '″'} | ${icon} | ${title} | ~${tokens} |`);
+          }
+        }
+      }
+
+      // Close final table if open
+      if (tableOpen) {
+        output.push('');
+      }
+    }
+
+    // Add full summary details for most recent session
+    const mostRecentSummary = recentSummaries[0];
+    if (mostRecentSummary && (mostRecentSummary.completed || mostRecentSummary.next_steps)) {
+      if (mostRecentSummary.completed) {
+        if (useColors) {
+          output.push(`${colors.green}Completed:${colors.reset} ${mostRecentSummary.completed}`);
+        } else {
+          output.push(`**Completed**: ${mostRecentSummary.completed}`);
+        }
+        output.push('');
+      }
+
+      if (mostRecentSummary.next_steps) {
+        if (useColors) {
+          output.push(`${colors.magenta}Next Steps:${colors.reset} ${mostRecentSummary.next_steps}`);
+        } else {
+          output.push(`**Next Steps**: ${mostRecentSummary.next_steps}`);
+        }
+        output.push('');
+      }
+    }
+
+    // Footer with MCP search instructions
+    if (useColors) {
+      output.push(`${colors.dim}Use claude-mem MCP search to access records with the given ID${colors.reset}`);
+    } else {
+      output.push(`*Use claude-mem MCP search to access records with the given ID*`);
+    }
+    output.push('');
+  }
+
+  // Footer
+  if (useColors) {
+    output.push(`${colors.gray}${'─'.repeat(60)}${colors.reset}`);
+    output.push('');
+  }
+
+  db.close();
+  return output.join('\n');
+}
+
+// Entry Point - handle stdin/stdout
+const useIndexView = process.argv.includes('--index');
+
+if (stdin.isTTY) {
+  // Running manually from terminal - print formatted output with colors
+  const contextOutput = contextHook(undefined, true, useIndexView);
+  console.log(contextOutput);
+  process.exit(0);
+} else {
+  // Running from hook - wrap in hookSpecificOutput JSON format
+  let input = '';
+  stdin.on('data', (chunk) => input += chunk);
+  stdin.on('end', () => {
+    const parsed = input.trim() ? JSON.parse(input) : undefined;
+    const contextOutput = contextHook(parsed, false, useIndexView);
+    const result = {
+      hookSpecificOutput: {
+        hookEventName: "SessionStart",
+        additionalContext: contextOutput
+      }
+    };
+    console.log(JSON.stringify(result));
+    process.exit(0);
+  });
+}

src/hooks/context.ts

@@ -1,150 +0,0 @@
-import path from 'path';
-import { SessionStore } from '../services/sqlite/SessionStore.js';
-import { ensureWorkerRunning } from '../shared/worker-utils.js';
-
-export interface SessionStartInput {
-  session_id?: string;
-  transcript_path?: string;
-  cwd?: string;
-  hook_event_name?: string;
-  source?: "startup" | "resume" | "clear" | "compact";
-  [key: string]: any;
-}
-
-/**
- * Context Hook - SessionStart
- * Shows user what happened in recent sessions
- *
- * Output: Returns formatted context string to be wrapped in hookSpecificOutput
- */
-export function contextHook(input?: SessionStartInput): string {
-  // v4.0.0: Ensure worker is running before loading context
-  ensureWorkerRunning();
-  const cwd = input?.cwd ?? process.cwd();
-  const project = cwd ? path.basename(cwd) : 'unknown-project';
-
-  const db = new SessionStore();
-
-  try {
-    const sessions = db.getRecentSessionsWithStatus(project, 3);
-
-    if (sessions.length === 0) {
-      return '# Recent Session Context\n\nNo previous sessions found for this project yet.';
-    }
-
-    const output: string[] = [];
-    output.push('# Recent Session Context');
-    output.push('');
-    output.push(`Showing last ${sessions.length} session(s) for **${project}**:`);
-    output.push('');
-
-    for (const session of sessions) {
-      if (!session.sdk_session_id) continue;
-
-      output.push('---');
-      output.push('');
-
-      // Check if session has a summary
-      if (session.has_summary) {
-        const summary = db.getSummaryForSession(session.sdk_session_id);
-
-        if (summary) {
-          const promptLabel = summary.prompt_number ? ` (Prompt #${summary.prompt_number})` : '';
-          output.push(`**Summary${promptLabel}**`);
-          output.push('');
-
-          if (summary.request) {
-            output.push(`**Request:** ${summary.request}`);
-          }
-
-          if (summary.completed) {
-            output.push(`**Completed:** ${summary.completed}`);
-          }
-
-          if (summary.learned) {
-            output.push(`**Learned:** ${summary.learned}`);
-          }
-
-          if (summary.next_steps) {
-            output.push(`**Next Steps:** ${summary.next_steps}`);
-          }
-
-          if (summary.files_read) {
-            try {
-              const files = JSON.parse(summary.files_read);
-              if (Array.isArray(files) && files.length > 0) {
-                output.push(`**Files Read:** ${files.join(', ')}`);
-              }
-            } catch {
-              if (summary.files_read.trim()) {
-                output.push(`**Files Read:** ${summary.files_read}`);
-              }
-            }
-          }
-
-          if (summary.files_edited) {
-            try {
-              const files = JSON.parse(summary.files_edited);
-              if (Array.isArray(files) && files.length > 0) {
-                output.push(`**Files Edited:** ${files.join(', ')}`);
-              }
-            } catch {
-              if (summary.files_edited.trim()) {
-                output.push(`**Files Edited:** ${summary.files_edited}`);
-              }
-            }
-          }
-
-          const dateTime = new Date(summary.created_at).toLocaleString();
-          output.push(`**Date:** ${dateTime}`);
-        }
-      } else if (session.status === 'active') {
-        // Active session without summary - show observation titles
-        output.push(`**In Progress**`);
-        output.push('');
-
-        if (session.user_prompt) {
-          output.push(`**Request:** ${session.user_prompt}`);
-        }
-
-        const observations = db.getObservationsForSession(session.sdk_session_id);
-
-        if (observations.length > 0) {
-          output.push('');
-          output.push(`**Observations (${observations.length}):**`);
-          for (const obs of observations) {
-            output.push(`- ${obs.title}`);
-          }
-        } else {
-          output.push('');
-          output.push('*No observations yet*');
-        }
-
-        output.push('');
-        output.push(`**Status:** Active - summary pending`);
-        const activeDateTime = new Date(session.started_at).toLocaleString();
-        output.push(`**Date:** ${activeDateTime}`);
-      } else {
-        // Failed or completed session without summary
-        const displayStatus = session.status === 'failed' ? 'stopped' : session.status;
-        output.push(`**${displayStatus.charAt(0).toUpperCase() + displayStatus.slice(1)}**`);
-        output.push('');
-
-        if (session.user_prompt) {
-          output.push(`**Request:** ${session.user_prompt}`);
-        }
-
-        output.push('');
-        output.push(`**Status:** ${displayStatus} - no summary available`);
-        const failedDateTime = new Date(session.started_at).toLocaleString();
-        output.push(`**Date:** ${failedDateTime}`);
-      }
-
-      output.push('');
-    }
-
-    return output.join('\n');
-  } finally {
-    db.close();
-  }
-}

src/hooks/new-hook.ts

@@ -0,0 +1,74 @@
+/**
+ * New Hook - UserPromptSubmit
+ * Consolidated entry point + logic
+ */
+
+import path from 'path';
+import { stdin } from 'process';
+import { SessionStore } from '../services/sqlite/SessionStore.js';
+import { createHookResponse } from './hook-response.js';
+import { ensureWorkerRunning, getWorkerPort } from '../shared/worker-utils.js';
+
+export interface UserPromptSubmitInput {
+  session_id: string;
+  cwd: string;
+  prompt: string;
+  [key: string]: any;
+}
+
+/**
+ * New Hook Main Logic
+ */
+async function newHook(input?: UserPromptSubmitInput): Promise<void> {
+  if (!input) {
+    throw new Error('newHook requires input');
+  }
+
+  const { session_id, cwd, prompt } = input;
+  const project = path.basename(cwd);
+
+  // Ensure worker is running first
+  const workerReady = await ensureWorkerRunning();
+  if (!workerReady) {
+    throw new Error('Worker service failed to start or become healthy');
+  }
+
+  const db = new SessionStore();
+
+  // Save session_id for indexing
+  const sessionDbId = db.createSDKSession(session_id, project, prompt);
+  const promptNumber = db.incrementPromptCounter(sessionDbId);
+
+  // Save raw user prompt for full-text search
+  db.saveUserPrompt(session_id, promptNumber, prompt);
+
+  console.error(`[new-hook] Session ${sessionDbId}, prompt #${promptNumber}`);
+
+  db.close();
+
+  // Get fixed port
+  const port = getWorkerPort();
+
+  // Initialize session via HTTP
+  const response = await fetch(`http://127.0.0.1:${port}/sessions/${sessionDbId}/init`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ project, userPrompt: prompt }),
+    signal: AbortSignal.timeout(5000)
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to initialize session: ${response.status} ${errorText}`);
+  }
+
+  console.log(createHookResponse('UserPromptSubmit', true));
+}
+
+// Entry Point
+let input = '';
+stdin.on('data', (chunk) => input += chunk);
+stdin.on('end', async () => {
+  const parsed = input ? JSON.parse(input) : undefined;
+  await newHook(parsed);
+});

src/hooks/new.ts

@@ -1,88 +0,0 @@
-import path from 'path';
-import { SessionStore } from '../services/sqlite/SessionStore.js';
-import { createHookResponse } from './hook-response.js';
-import { ensureWorkerRunning, getWorkerPort } from '../shared/worker-utils.js';
-
-export interface UserPromptSubmitInput {
-  session_id: string;
-  cwd: string;
-  prompt: string;
-  [key: string]: any;
-}
-
-/**
- * New Hook - UserPromptSubmit
- * Initializes SDK memory session via HTTP POST to worker service
- */
-export async function newHook(input?: UserPromptSubmitInput): Promise<void> {
-  if (!input) {
-    throw new Error('newHook requires input');
-  }
-
-  const { session_id, cwd, prompt } = input;
-  const project = path.basename(cwd);
-
-  // Ensure worker is running first (runs cleanup if restarting)
-  const workerReady = await ensureWorkerRunning();
-  if (!workerReady) {
-    throw new Error('Worker service failed to start or become healthy');
-  }
-
-  const db = new SessionStore();
-
-  try {
-
-    // Check for any existing session (active, failed, or completed)
-    let existing = db.findActiveSDKSession(session_id);
-    let sessionDbId: number;
-    let isNewSession = false;
-
-    if (existing) {
-      // Session already active, increment prompt counter
-      sessionDbId = existing.id;
-      const promptNumber = db.incrementPromptCounter(sessionDbId);
-      console.error(`[new-hook] Continuing session ${sessionDbId}, prompt #${promptNumber}`);
-    } else {
-      // Check for inactive sessions we can reuse
-      const inactive = db.findAnySDKSession(session_id);
-
-      if (inactive) {
-        // Reactivate the existing session
-        sessionDbId = inactive.id;
-        db.reactivateSession(sessionDbId, prompt);
-        const promptNumber = db.incrementPromptCounter(sessionDbId);
-        isNewSession = true;
-        console.error(`[new-hook] Reactivated session ${sessionDbId}, prompt #${promptNumber}`);
-      } else {
-        // Create new session
-        sessionDbId = db.createSDKSession(session_id, project, prompt);
-        const promptNumber = db.incrementPromptCounter(sessionDbId);
-        isNewSession = true;
-        console.error(`[new-hook] Created new session ${sessionDbId}, prompt #${promptNumber}`);
-      }
-    }
-
-    // Get fixed port
-    const port = getWorkerPort();
-
-    // Only initialize worker on new sessions
-    if (isNewSession) {
-      // Initialize session via HTTP
-      const response = await fetch(`http://127.0.0.1:${port}/sessions/${sessionDbId}/init`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ project, userPrompt: prompt }),
-        signal: AbortSignal.timeout(5000)
-      });
-
-      if (!response.ok) {
-        const errorText = await response.text();
-        throw new Error(`Failed to initialize session: ${response.status} ${errorText}`);
-      }
-    }
-
-    console.log(createHookResponse('UserPromptSubmit', true));
-  } finally {
-    db.close();
-  }
-}

src/hooks/save-hook.ts

@@ -1,3 +1,9 @@
+/**
+ * Save Hook - PostToolUse
+ * Consolidated entry point + logic
+ */
+
+import { stdin } from 'process';
 import { SessionStore } from '../services/sqlite/SessionStore.js';
 import { createHookResponse } from './hook-response.js';
 import { logger } from '../utils/logger.js';
@@ -18,10 +24,9 @@ const SKIP_TOOLS = new Set([
 ]);
 
 /**
- * Save Hook - PostToolUse
- * Sends tool observations to worker via HTTP POST
+ * Save Hook Main Logic
  */
-export async function saveHook(input?: PostToolUseInput): Promise<void> {
+async function saveHook(input?: PostToolUseInput): Promise<void> {
   if (!input) {
     throw new Error('saveHook requires input');
   }
@@ -33,39 +38,30 @@ export async function saveHook(input?: PostToolUseInput): Promise<void> {
     return;
   }
 
-  // Ensure worker is running first (runs cleanup if restarting)
+  // Ensure worker is running first
   const workerReady = await ensureWorkerRunning();
   if (!workerReady) {
     throw new Error('Worker service failed to start or become healthy');
   }
 
   const db = new SessionStore();
-  const session = db.findActiveSDKSession(session_id);
 
-  if (!session) {
-    db.close();
-    console.log(createHookResponse('PostToolUse', true));
-    return;
-  }
-
-  if (!session.worker_port) {
-    db.close();
-    logger.error('HOOK', 'No worker port for session', { sessionId: session.id });
-    throw new Error('No worker port for session - session may not be properly initialized');
-  }
-
-  // Get current prompt number for this session
-  const promptNumber = db.getPromptCounter(session.id);
+  // Get or create session
+  const sessionDbId = db.createSDKSession(session_id, '', '');
+  const promptNumber = db.getPromptCounter(sessionDbId);
   db.close();
 
   const toolStr = logger.formatTool(tool_name, tool_input);
 
+  // Use fixed worker port
+  const FIXED_PORT = parseInt(process.env.CLAUDE_MEM_WORKER_PORT || '37777', 10);
+
   logger.dataIn('HOOK', `PostToolUse: ${toolStr}`, {
-    sessionId: session.id,
-    workerPort: session.worker_port
+    sessionId: sessionDbId,
+    workerPort: FIXED_PORT
   });
 
-  const response = await fetch(`http://127.0.0.1:${session.worker_port}/sessions/${session.id}/observations`, {
+  const response = await fetch(`http://127.0.0.1:${FIXED_PORT}/sessions/${sessionDbId}/observations`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({
@@ -80,12 +76,20 @@ export async function saveHook(input?: PostToolUseInput): Promise<void> {
   if (!response.ok) {
     const errorText = await response.text();
     logger.failure('HOOK', 'Failed to send observation', {
-      sessionId: session.id,
+      sessionId: sessionDbId,
       status: response.status
     }, errorText);
     throw new Error(`Failed to send observation to worker: ${response.status} ${errorText}`);
   }
 
-  logger.debug('HOOK', 'Observation sent successfully', { sessionId: session.id, toolName: tool_name });
+  logger.debug('HOOK', 'Observation sent successfully', { sessionId: sessionDbId, toolName: tool_name });
   console.log(createHookResponse('PostToolUse', true));
 }
+
+// Entry Point
+let input = '';
+stdin.on('data', (chunk) => input += chunk);
+stdin.on('end', async () => {
+  const parsed = input ? JSON.parse(input) : undefined;
+  await saveHook(parsed);
+});

src/hooks/summary-hook.ts

@@ -1,3 +1,9 @@
+/**
+ * Summary Hook - Stop
+ * Consolidated entry point + logic
+ */
+
+import { stdin } from 'process';
 import { SessionStore } from '../services/sqlite/SessionStore.js';
 import { createHookResponse } from './hook-response.js';
 import { logger } from '../utils/logger.js';
@@ -10,48 +16,38 @@ export interface StopInput {
 }
 
 /**
- * Summary Hook - Stop
- * Sends SUMMARIZE message to worker via HTTP POST (not finalize - keeps SDK agent running)
+ * Summary Hook Main Logic
  */
-export async function summaryHook(input?: StopInput): Promise<void> {
+async function summaryHook(input?: StopInput): Promise<void> {
   if (!input) {
     throw new Error('summaryHook requires input');
   }
 
   const { session_id } = input;
 
-  // Ensure worker is running first (runs cleanup if restarting)
+  // Ensure worker is running first
   const workerReady = await ensureWorkerRunning();
   if (!workerReady) {
     throw new Error('Worker service failed to start or become healthy');
   }
 
   const db = new SessionStore();
-  const session = db.findActiveSDKSession(session_id);
 
-  if (!session) {
-    db.close();
-    console.log(createHookResponse('Stop', true));
-    return;
-  }
-
-  if (!session.worker_port) {
-    db.close();
-    logger.error('HOOK', 'No worker port for session', { sessionId: session.id });
-    throw new Error('No worker port for session - session may not be properly initialized');
-  }
-
-  // Get current prompt number
-  const promptNumber = db.getPromptCounter(session.id);
+  // Get or create session
+  const sessionDbId = db.createSDKSession(session_id, '', '');
+  const promptNumber = db.getPromptCounter(sessionDbId);
   db.close();
 
+  // Use fixed worker port
+  const FIXED_PORT = parseInt(process.env.CLAUDE_MEM_WORKER_PORT || '37777', 10);
+
   logger.dataIn('HOOK', 'Stop: Requesting summary', {
-    sessionId: session.id,
-    workerPort: session.worker_port,
+    sessionId: sessionDbId,
+    workerPort: FIXED_PORT,
     promptNumber
   });
 
-  const response = await fetch(`http://127.0.0.1:${session.worker_port}/sessions/${session.id}/summarize`, {
+  const response = await fetch(`http://127.0.0.1:${FIXED_PORT}/sessions/${sessionDbId}/summarize`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({ prompt_number: promptNumber }),
@@ -61,12 +57,20 @@ export async function summaryHook(input?: StopInput): Promise<void> {
   if (!response.ok) {
     const errorText = await response.text();
     logger.failure('HOOK', 'Failed to generate summary', {
-      sessionId: session.id,
+      sessionId: sessionDbId,
       status: response.status
     }, errorText);
     throw new Error(`Failed to request summary from worker: ${response.status} ${errorText}`);
   }
 
-  logger.debug('HOOK', 'Summary request sent successfully', { sessionId: session.id });
+  logger.debug('HOOK', 'Summary request sent successfully', { sessionId: sessionDbId });
   console.log(createHookResponse('Stop', true));
 }
+
+// Entry Point
+let input = '';
+stdin.on('data', (chunk) => input += chunk);
+stdin.on('end', async () => {
+  const parsed = input ? JSON.parse(input) : undefined;
+  await summaryHook(parsed);
+});

src/sdk/parser.test.ts

@@ -0,0 +1,403 @@
+/**
+ * Parser Regression Tests
+ * Ensures v4.2.5 and v4.2.6 bugfixes remain stable
+ */
+
+import { parseObservations, parseSummary } from './parser.js';
+
+// ANSI color codes for output
+const GREEN = '\x1b[32m';
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const RESET = '\x1b[0m';
+
+let testsRun = 0;
+let testsPassed = 0;
+let testsFailed = 0;
+
+function assert(condition: boolean, testName: string, errorMsg?: string): void {
+  testsRun++;
+  if (condition) {
+    testsPassed++;
+    console.log(`${GREEN}✓${RESET} ${testName}`);
+  } else {
+    testsFailed++;
+    console.log(`${RED}✗${RESET} ${testName}`);
+    if (errorMsg) {
+      console.log(`  ${RED}${errorMsg}${RESET}`);
+    }
+  }
+}
+
+function assertEqual<T>(actual: T, expected: T, testName: string): void {
+  const isEqual = JSON.stringify(actual) === JSON.stringify(expected);
+  if (!isEqual) {
+    assert(false, testName, `Expected: ${JSON.stringify(expected)}, Got: ${JSON.stringify(actual)}`);
+  } else {
+    assert(true, testName);
+  }
+}
+
+console.log('\n' + YELLOW + '='.repeat(60) + RESET);
+console.log(YELLOW + 'Parser Regression Tests (v4.2.5 & v4.2.6)' + RESET);
+console.log(YELLOW + '='.repeat(60) + RESET + '\n');
+
+// ============================================================================
+// v4.2.6: Observation Parsing - NEVER Skip Observations
+// ============================================================================
+
+console.log(YELLOW + '\nv4.2.6: Observation Validation Fixes' + RESET);
+console.log('─'.repeat(60) + '\n');
+
+// Test 1: Observation with missing title should be saved
+const missingTitleXml = `
+<observation>
+  <type>feature</type>
+  <subtitle>Added new feature</subtitle>
+  <narrative>Implemented the feature successfully</narrative>
+  <facts>
+    <fact>Created new file</fact>
+  </facts>
+  <concepts>
+    <concept>authentication</concept>
+  </concepts>
+  <files_read></files_read>
+  <files_modified>
+    <file>src/app.ts</file>
+  </files_modified>
+</observation>
+`;
+
+const missingTitleResult = parseObservations(missingTitleXml);
+assert(missingTitleResult.length === 1, 'Should parse observation with missing title');
+assert(missingTitleResult[0].title === null, 'Missing title should be null');
+assertEqual(missingTitleResult[0].type, 'feature', 'Should preserve type when title missing');
+
+// Test 2: Observation with missing subtitle should be saved
+const missingSubtitleXml = `
+<observation>
+  <type>bugfix</type>
+  <title>Fixed critical bug</title>
+  <narrative>Resolved the issue</narrative>
+  <facts></facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+
+const missingSubtitleResult = parseObservations(missingSubtitleXml);
+assert(missingSubtitleResult.length === 1, 'Should parse observation with missing subtitle');
+assert(missingSubtitleResult[0].subtitle === null, 'Missing subtitle should be null');
+assertEqual(missingSubtitleResult[0].title, 'Fixed critical bug', 'Should preserve title when subtitle missing');
+
+// Test 3: Observation with missing narrative should be saved
+const missingNarrativeXml = `
+<observation>
+  <type>refactor</type>
+  <title>Code cleanup</title>
+  <subtitle>Improved structure</subtitle>
+  <facts>
+    <fact>Removed dead code</fact>
+  </facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+
+const missingNarrativeResult = parseObservations(missingNarrativeXml);
+assert(missingNarrativeResult.length === 1, 'Should parse observation with missing narrative');
+assert(missingNarrativeResult[0].narrative === null, 'Missing narrative should be null');
+assertEqual(missingNarrativeResult[0].facts, ['Removed dead code'], 'Should preserve facts when narrative missing');
+
+// Test 4: Observation with ALL fields missing (except type) should be saved
+const minimalObservationXml = `
+<observation>
+  <type>change</type>
+  <title></title>
+  <subtitle></subtitle>
+  <narrative></narrative>
+  <facts></facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+
+const minimalResult = parseObservations(minimalObservationXml);
+assert(minimalResult.length === 1, 'Should parse minimal observation with only type');
+assertEqual(minimalResult[0].type, 'change', 'Should preserve type for minimal observation');
+assert(minimalResult[0].title === null, 'Empty title should be null');
+assert(minimalResult[0].subtitle === null, 'Empty subtitle should be null');
+assert(minimalResult[0].narrative === null, 'Empty narrative should be null');
+
+// Test 5: Observation with missing type should use "change" as fallback
+const missingTypeXml = `
+<observation>
+  <title>Something happened</title>
+  <subtitle>Details here</subtitle>
+  <narrative>More info</narrative>
+  <facts></facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+
+const missingTypeResult = parseObservations(missingTypeXml);
+assert(missingTypeResult.length === 1, 'Should parse observation with missing type');
+assertEqual(missingTypeResult[0].type, 'change', 'Missing type should default to "change"');
+
+// Test 6: Observation with invalid type should use "change" as fallback
+const invalidTypeXml = `
+<observation>
+  <type>invalid_type_here</type>
+  <title>Something happened</title>
+  <subtitle>Details here</subtitle>
+  <narrative>More info</narrative>
+  <facts></facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+
+const invalidTypeResult = parseObservations(invalidTypeXml);
+assert(invalidTypeResult.length === 1, 'Should parse observation with invalid type');
+assertEqual(invalidTypeResult[0].type, 'change', 'Invalid type should default to "change"');
+
+// Test 7: Multiple observations with mixed completeness should all be saved
+const mixedObservationsXml = `
+<observation>
+  <type>feature</type>
+  <title>Full observation</title>
+  <subtitle>Complete</subtitle>
+  <narrative>All fields present</narrative>
+  <facts><fact>Fact 1</fact></facts>
+  <concepts><concept>concept1</concept></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+<observation>
+  <type>bugfix</type>
+  <subtitle>Only subtitle and type</subtitle>
+  <facts></facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+<observation>
+  <title>Only title, no type</title>
+  <facts></facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+
+const mixedResult = parseObservations(mixedObservationsXml);
+assertEqual(mixedResult.length, 3, 'Should parse all three observations regardless of completeness');
+assertEqual(mixedResult[0].type, 'feature', 'First observation should have correct type');
+assertEqual(mixedResult[1].type, 'bugfix', 'Second observation should have correct type');
+assertEqual(mixedResult[2].type, 'change', 'Third observation should default to "change"');
+
+// ============================================================================
+// v4.2.5: Summary Parsing - NEVER Skip Summaries
+// ============================================================================
+
+console.log(YELLOW + '\nv4.2.5: Summary Validation Fixes' + RESET);
+console.log('─'.repeat(60) + '\n');
+
+// Test 8: Summary with missing request field should be saved
+const missingRequestXml = `
+<summary>
+  <investigated>Looked into the codebase</investigated>
+  <learned>Found the issue</learned>
+  <completed>Fixed the bug</completed>
+  <next_steps>Deploy to production</next_steps>
+</summary>
+`;
+
+const missingRequestResult = parseSummary(missingRequestXml);
+assert(missingRequestResult !== null, 'Should parse summary with missing request');
+assert(missingRequestResult!.request === null, 'Missing request should be null');
+assertEqual(missingRequestResult!.investigated, 'Looked into the codebase', 'Should preserve other fields');
+
+// Test 9: Summary with missing investigated field should be saved
+const missingInvestigatedXml = `
+<summary>
+  <request>Fix the bug</request>
+  <learned>Root cause identified</learned>
+  <completed>Applied the fix</completed>
+  <next_steps>Monitor production</next_steps>
+</summary>
+`;
+
+const missingInvestigatedResult = parseSummary(missingInvestigatedXml);
+assert(missingInvestigatedResult !== null, 'Should parse summary with missing investigated');
+assert(missingInvestigatedResult!.investigated === null, 'Missing investigated should be null');
+
+// Test 10: Summary with missing learned field should be saved
+const missingLearnedXml = `
+<summary>
+  <request>Add new feature</request>
+  <investigated>Reviewed the requirements</investigated>
+  <completed>Implemented the feature</completed>
+  <next_steps>Write tests</next_steps>
+</summary>
+`;
+
+const missingLearnedResult = parseSummary(missingLearnedXml);
+assert(missingLearnedResult !== null, 'Should parse summary with missing learned');
+assert(missingLearnedResult!.learned === null, 'Missing learned should be null');
+
+// Test 11: Summary with missing completed field should be saved
+const missingCompletedXml = `
+<summary>
+  <request>Refactor code</request>
+  <investigated>Analyzed the structure</investigated>
+  <learned>Found improvement opportunities</learned>
+  <next_steps>Continue refactoring</next_steps>
+</summary>
+`;
+
+const missingCompletedResult = parseSummary(missingCompletedXml);
+assert(missingCompletedResult !== null, 'Should parse summary with missing completed');
+assert(missingCompletedResult!.completed === null, 'Missing completed should be null');
+
+// Test 12: Summary with missing next_steps field should be saved
+const missingNextStepsXml = `
+<summary>
+  <request>Review code</request>
+  <investigated>Examined all files</investigated>
+  <learned>Code quality is good</learned>
+  <completed>Review complete</completed>
+</summary>
+`;
+
+const missingNextStepsResult = parseSummary(missingNextStepsXml);
+assert(missingNextStepsResult !== null, 'Should parse summary with missing next_steps');
+assert(missingNextStepsResult!.next_steps === null, 'Missing next_steps should be null');
+
+// Test 13: Summary with only notes field should be saved
+const onlyNotesXml = `
+<summary>
+  <notes>Some random notes</notes>
+</summary>
+`;
+
+const onlyNotesResult = parseSummary(onlyNotesXml);
+assert(onlyNotesResult !== null, 'Should parse summary with only notes field');
+assertEqual(onlyNotesResult!.notes, 'Some random notes', 'Should preserve notes field');
+
+// Test 14: Completely empty summary should be saved
+const emptySummaryXml = `
+<summary>
+  <request></request>
+  <investigated></investigated>
+  <learned></learned>
+  <completed></completed>
+  <next_steps></next_steps>
+</summary>
+`;
+
+const emptySummaryResult = parseSummary(emptySummaryXml);
+assert(emptySummaryResult !== null, 'Should parse completely empty summary');
+assert(emptySummaryResult!.request === null, 'Empty request should be null');
+assert(emptySummaryResult!.investigated === null, 'Empty investigated should be null');
+
+// Test 15: Summary with skip_summary should return null (valid use case)
+const skipSummaryXml = `
+<skip_summary reason="Not enough context yet" />
+`;
+
+const skipSummaryResult = parseSummary(skipSummaryXml);
+assert(skipSummaryResult === null, 'Should return null for skip_summary directive');
+
+// ============================================================================
+// Edge Cases & Data Integrity
+// ============================================================================
+
+console.log(YELLOW + '\nEdge Cases & Data Integrity' + RESET);
+console.log('─'.repeat(60) + '\n');
+
+// Test 16: Observation with whitespace-only fields should be null
+const whitespaceObservationXml = `
+<observation>
+  <type>change</type>
+  <title>   </title>
+  <subtitle>
+
+  </subtitle>
+  <narrative></narrative>
+  <facts></facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+
+const whitespaceResult = parseObservations(whitespaceObservationXml);
+assert(whitespaceResult.length === 1, 'Should parse observation with whitespace fields');
+assert(whitespaceResult[0].title === null || whitespaceResult[0].title!.trim() === '', 'Whitespace title should be null or empty');
+
+// Test 17: Observation with concepts including type should filter out type
+const conceptsWithTypeXml = `
+<observation>
+  <type>feature</type>
+  <title>New feature</title>
+  <subtitle>Details</subtitle>
+  <narrative>Description</narrative>
+  <facts></facts>
+  <concepts>
+    <concept>feature</concept>
+    <concept>authentication</concept>
+  </concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+
+const conceptsWithTypeResult = parseObservations(conceptsWithTypeXml);
+assert(conceptsWithTypeResult.length === 1, 'Should parse observation with type in concepts');
+assertEqual(conceptsWithTypeResult[0].concepts, ['authentication'], 'Should filter out type from concepts');
+
+// Test 18: Observation with all valid types
+const validTypes = ['decision', 'bugfix', 'feature', 'refactor', 'discovery', 'change'];
+validTypes.forEach(type => {
+  const typeXml = `
+<observation>
+  <type>${type}</type>
+  <title>Test</title>
+  <subtitle>Test</subtitle>
+  <narrative>Test</narrative>
+  <facts></facts>
+  <concepts></concepts>
+  <files_read></files_read>
+  <files_modified></files_modified>
+</observation>
+`;
+  const result = parseObservations(typeXml);
+  assertEqual(result[0].type, type, `Should accept valid type: ${type}`);
+});
+
+// ============================================================================
+// Results Summary
+// ============================================================================
+
+console.log('\n' + YELLOW + '='.repeat(60) + RESET);
+console.log(YELLOW + 'Test Results Summary' + RESET);
+console.log(YELLOW + '='.repeat(60) + RESET + '\n');
+
+console.log(`Total Tests: ${testsRun}`);
+console.log(`${GREEN}Passed: ${testsPassed}${RESET}`);
+console.log(`${RED}Failed: ${testsFailed}${RESET}`);
+
+if (testsFailed > 0) {
+  console.log(`\n${RED}❌ TESTS FAILED${RESET}\n`);
+  process.exit(1);
+} else {
+  console.log(`\n${GREEN}✅ ALL TESTS PASSED${RESET}\n`);
+  process.exit(0);
+}

src/sdk/parser.ts

@@ -7,10 +7,10 @@ import { logger } from '../utils/logger.js';
 
 export interface ParsedObservation {
   type: string;
-  title: string;
-  subtitle: string;
+  title: string | null;
+  subtitle: string | null;
   facts: string[];
-  narrative: string;
+  narrative: string | null;
   concepts: string[];
   files_read: string[];
   files_modified: string[];
@@ -49,32 +49,44 @@ export function parseObservations(text: string, correlationId?: string): ParsedO
     const files_read = extractArrayElements(obsContent, 'files_read', 'file');
     const files_modified = extractArrayElements(obsContent, 'files_modified', 'file');
 
-    // Validate required fields
-    if (!type || !title || !subtitle || !narrative) {
-      logger.warn('PARSER', 'Observation missing required fields, skipping', {
-        correlationId,
-        hasType: !!type,
-        hasTitle: !!title,
-        hasSubtitle: !!subtitle,
-        hasNarrative: !!narrative
-      });
-      continue;
+    // NOTE FROM THEDOTMACK: ALWAYS save observations - never skip. 10/24/2025
+    // All fields except type are nullable in schema
+    // If type is missing or invalid, use "change" as catch-all fallback
+
+    // Determine final type
+    let finalType = 'change'; // Default catch-all
+    if (type) {
+      const validTypes = ['bugfix', 'feature', 'refactor', 'change', 'discovery', 'decision'];
+      if (validTypes.includes(type.trim())) {
+        finalType = type.trim();
+      } else {
+        logger.warn('PARSER', `Invalid observation type: ${type}, using "change"`, { correlationId });
+      }
+    } else {
+      logger.warn('PARSER', 'Observation missing type field, using "change"', { correlationId });
     }
 
-    // Validate type
-    const validTypes = ['change', 'discovery', 'decision'];
-    if (!validTypes.includes(type.trim())) {
-      logger.warn('PARSER', `Invalid observation type: ${type}, skipping`, { correlationId });
-      continue;
+    // All other fields are optional - save whatever we have
+
+    // Filter out type from concepts array (types and concepts are separate dimensions)
+    const cleanedConcepts = concepts.filter(c => c !== finalType);
+
+    if (cleanedConcepts.length !== concepts.length) {
+      logger.warn('PARSER', 'Removed observation type from concepts array', {
+        correlationId,
+        type: finalType,
+        originalConcepts: concepts,
+        cleanedConcepts
+      });
     }
 
     observations.push({
-      type: type.trim(),
+      type: finalType,
       title,
       subtitle,
       facts,
       narrative,
-      concepts,
+      concepts: cleanedConcepts,
       files_read,
       files_modified
     });
@@ -85,9 +97,21 @@ export function parseObservations(text: string, correlationId?: string): ParsedO
 
 /**
  * Parse summary XML block from SDK response
- * Returns null if no valid summary found
+ * Returns null if no valid summary found or if summary was skipped
  */
 export function parseSummary(text: string, sessionId?: number): ParsedSummary | null {
+  // Check for skip_summary first
+  const skipRegex = /<skip_summary\s+reason="([^"]+)"\s*\/>/;
+  const skipMatch = skipRegex.exec(text);
+
+  if (skipMatch) {
+    logger.info('PARSER', 'Summary skipped', {
+      sessionId,
+      reason: skipMatch[1]
+    });
+    return null;
+  }
+
   // Match <summary>...</summary> block (non-greedy)
   const summaryRegex = /<summary>([\s\S]*?)<\/summary>/;
   const summaryMatch = summaryRegex.exec(text);
@@ -106,18 +130,21 @@ export function parseSummary(text: string, sessionId?: number): ParsedSummary |
   const next_steps = extractField(summaryContent, 'next_steps');
   const notes = extractField(summaryContent, 'notes'); // Optional
 
+  // NOTE FROM THEDOTMACK: 100% of the time we must SAVE the summary, even if fields are missing. 10/24/2025 
+  // NEVER DO THIS NONSENSE AGAIN.
+
   // Validate required fields are present (notes is optional)
-  if (!request || !investigated || !learned || !completed || !next_steps) {
-    logger.warn('PARSER', 'Summary missing required fields', {
-      sessionId,
-      hasRequest: !!request,
-      hasInvestigated: !!investigated,
-      hasLearned: !!learned,
-      hasCompleted: !!completed,
-      hasNextSteps: !!next_steps
-    });
-    return null;
-  }
+  // if (!request || !investigated || !learned || !completed || !next_steps) {
+  //   logger.warn('PARSER', 'Summary missing required fields', {
+  //     sessionId,
+  //     hasRequest: !!request,
+  //     hasInvestigated: !!investigated,
+  //     hasLearned: !!learned,
+  //     hasCompleted: !!completed,
+  //     hasNextSteps: !!next_steps
+  //   });
+  //   return null;
+  // }
 
   return {
     request,
@@ -131,43 +158,19 @@ export function parseSummary(text: string, sessionId?: number): ParsedSummary |
 
 /**
  * Extract a simple field value from XML content
+ * Returns null for missing or empty/whitespace-only fields
  */
 function extractField(content: string, fieldName: string): string | null {
   const regex = new RegExp(`<${fieldName}>([^<]*)</${fieldName}>`);
   const match = regex.exec(content);
-  return match ? match[1].trim() : null;
-}
+  if (!match) return null;
 
-/**
- * Extract file array from XML content
- * Handles both <file> children and empty tags
- */
-function extractFileArray(content: string, arrayName: string): string[] {
-  const files: string[] = [];
-
-  // Match the array block
-  const arrayRegex = new RegExp(`<${arrayName}>(.*?)</${arrayName}>`, 's');
-  const arrayMatch = arrayRegex.exec(content);
-
-  if (!arrayMatch) {
-    return files;
-  }
-
-  const arrayContent = arrayMatch[1];
-
-  // Extract individual <file> elements
-  const fileRegex = /<file>([^<]+)<\/file>/g;
-  let fileMatch;
-  while ((fileMatch = fileRegex.exec(arrayContent)) !== null) {
-    files.push(fileMatch[1].trim());
-  }
-
-  return files;
+  const trimmed = match[1].trim();
+  return trimmed === '' ? null : trimmed;
 }
 
 /**
  * Extract array of elements from XML content
- * Generic version of extractFileArray that works with any element name
  */
 function extractArrayElements(content: string, arrayName: string, elementName: string): string[] {
   const elements: string[] = [];

src/sdk/prompts.ts

@@ -22,21 +22,31 @@ export interface SDKSession {
  * Build initial prompt to initialize the SDK agent
  */
 export function buildInitPrompt(project: string, sessionId: string, userPrompt: string): string {
-  return `You are a memory processor for a Claude Code session. Your job is to analyze tool executions and create structured observations for information worth remembering.
+  return `You are observing a development session to create searchable memory FOR FUTURE SESSIONS.
 
-You are processing tool executions from a Claude Code session with the following context:
+CRITICAL: Record what was BUILT/FIXED/DEPLOYED/CONFIGURED, not what you (the observer) are doing.
 
 User's Goal: ${userPrompt}
 Date: ${new Date().toISOString().split('T')[0]}
 
-WHEN TO STORE
--------------
-Store observations when the tool output contains information worth remembering about:
-- How things work
-- Why things exist or were chosen
-- What changed
-- Problems and their solutions
-- Important patterns or gotchas
+WHAT TO RECORD
+--------------
+Focus on deliverables and capabilities:
+- What the system NOW DOES differently (new capabilities)
+- What shipped to users/production (features, fixes, configs, docs)
+- Changes in technical domains (auth, data, UI, infra, DevOps, docs)
+
+Use verbs like: implemented, fixed, deployed, configured, migrated, optimized, added, refactored
+
+✅ GOOD EXAMPLES (describes what was built):
+- "Authentication now supports OAuth2 with PKCE flow"
+- "Deployment pipeline runs canary releases with auto-rollback"
+- "Database indexes optimized for common query patterns"
+
+❌ BAD EXAMPLES (describes observation process - DO NOT DO THIS):
+- "Analyzed authentication implementation and stored findings"
+- "Tracked deployment steps and logged outcomes"
+- "Monitored database performance and recorded metrics"
 
 WHEN TO SKIP
 ------------
@@ -53,12 +63,15 @@ Output observations using this XML structure:
 
 \`\`\`xml
 <observation>
-  <type>[ change | discovery | decision ]</type>
+  <type>[ bugfix | feature | refactor | change | discovery | decision ]</type>
   <!--
-    **type**: One of:
-      - change: modifications to code, config, or documentation
+    **type**: MUST be EXACTLY one of these 6 options (no other values allowed):
+      - bugfix: something was broken, now fixed
+      - feature: new capability or functionality added
+      - refactor: code restructured, behavior unchanged
+      - change: generic modification (docs, config, misc)
       - discovery: learning about existing system
-      - decision: choosing an approach and why it was chosen
+      - decision: architectural/design choice with rationale
   -->
   <title>[**title**: Short title capturing the core action or topic]</title>
   <subtitle>[**subtitle**: One sentence explanation (max 24 words)]</subtitle>
@@ -79,7 +92,7 @@ Output observations using this XML structure:
     <concept>[knowledge-type-category]</concept>
   </concepts>
   <!--
-    **concepts**: 2-5 knowledge-type categories:
+    **concepts**: 2-5 knowledge-type categories. MUST use ONLY these exact keywords:
       - how-it-works: understanding mechanisms
       - why-it-exists: purpose or rationale
       - what-changed: modifications made
@@ -87,6 +100,9 @@ Output observations using this XML structure:
       - gotcha: traps or edge cases
       - pattern: reusable approach
       - trade-off: pros/cons of a decision
+
+    IMPORTANT: Do NOT include the observation type (change/discovery/decision) as a concept.
+    Types and concepts are separate dimensions.
   -->
   <files_read>
     <file>[path/to/file]</file>
@@ -137,24 +153,26 @@ export function buildObservationPrompt(obs: Observation): string {
 }
 
 /**
- * Build finalization prompt to generate session summary
+ * Build prompt to generate request summary
  */
-export function buildFinalizePrompt(session: SDKSession): string {
-  return `MEMORY PROCESSING SESSION COMPLETED
-===================================
-This session has completed. Review the observations you generated and create a session summary.
+export function buildSummaryPrompt(session: SDKSession): string {
+  return `THIS REQUEST'S SUMMARY
+===============
+Think about the last request, and write a summary of what was done, what was learned, and what's next.
 
-Output this XML:
+IMPORTANT! DO NOT summarize the observation process itself - you are summarizing a DIFFERENT claude code session, not this one.
+
+User's Original Request: ${session.user_prompt}
+
+Respond in this XML format:
 <summary>
-  <request>[What did the user request?]</request>
-  <investigated>[What code and systems did you explore?]</investigated>
-  <learned>[What did you learn about the codebase?]</learned>
-  <completed>[What was accomplished in this session?]</completed>
-  <next_steps>[What should be done next?]</next_steps>
-  <notes>[Additional insights or context]</notes>
+  <request>[What did the user request? Form a title that reflects the actual request: ${session.user_prompt}]</request>
+  <investigated>[Was anything explored? What was it?]</investigated>
+  <learned>[Did you learn anything? What was learned about how things work?]</learned>
+  <completed>[Did you do any work? What shipped? What does the system now do?]</completed>
+  <next_steps>[What are the next steps?]</next_steps>
+  <notes>[Additional insights]</notes>
 </summary>
 
-**Required fields**: request, investigated, learned, completed, next_steps
-
-**Optional fields**: notes`;
-}
+IMPORTANT: This is not the end of the session. You will receive more requests to process, and more tool usages to observe and record. The summary helps keep track of progress. Always write at least a minimal summary explaining where we are at currently, even if you didn't learn anything new or complete any work.`; 
+}

src/sdk/worker.ts

@@ -13,17 +13,47 @@ declare global {
 
 import net from 'net';
 import { unlinkSync, existsSync } from 'fs';
+import { execSync } from 'child_process';
 import { query } from '@anthropic-ai/claude-agent-sdk';
 import type { SDKUserMessage, SDKSystemMessage } from '@anthropic-ai/claude-agent-sdk';
 import { SessionStore } from '../services/sqlite/SessionStore.js';
 import { getWorkerSocketPath } from '../shared/paths.js';
-import { buildInitPrompt, buildObservationPrompt, buildFinalizePrompt } from './prompts.js';
+import { buildInitPrompt, buildObservationPrompt, buildSummaryPrompt } from './prompts.js';
 import { parseObservations, parseSummary } from './parser.js';
 import type { SDKSession } from './prompts.js';
 
 const MODEL = 'claude-sonnet-4-5';
 const DISALLOWED_TOOLS = ['Glob', 'Grep', 'ListMcpResourcesTool', 'WebSearch'];
 
+/**
+ * Find Claude Code executable path using which (Unix/Mac) or where (Windows)
+ */
+function findClaudePath(): string {
+  try {
+    // Try environment variable first
+    if (process.env.CLAUDE_CODE_PATH) {
+      return process.env.CLAUDE_CODE_PATH;
+    }
+
+    // Use which on Unix/Mac, where on Windows
+    const command = process.platform === 'win32' ? 'where claude' : 'which claude';
+    const result = execSync(command, { encoding: 'utf8' }).trim();
+
+    // On Windows, 'where' returns multiple lines if there are multiple matches, take the first
+    const path = result.split('\n')[0].trim();
+
+    if (!path) {
+      throw new Error('Claude executable not found in PATH');
+    }
+
+    console.error(`[SDK Worker] Found Claude executable: ${path}`);
+    return path;
+  } catch (error: any) {
+    console.error('[SDK Worker] Failed to find Claude executable:', error.message);
+    throw new Error('Claude Code executable not found. Please ensure claude is in your PATH or set CLAUDE_CODE_PATH environment variable.');
+  }
+}
+
 interface ObservationMessage {
   type: 'observation';
   tool_name: string;
@@ -282,9 +312,8 @@ class SDKWorker {
    * Run SDK agent with streaming input mode
    */
   private async runSDKAgent(): Promise<void> {
-    // Find Claude Code executable
-    const claudePath = process.env.CLAUDE_CODE_PATH || '/Users/alexnewman/.nvm/versions/node/v24.5.0/bin/claude';
-    console.error(`[SDK Worker DEBUG] About to call query with claudePath: ${claudePath}`);
+    const claudePath = findClaudePath();
+    console.error(`[SDK Worker DEBUG] Using Claude executable: ${claudePath}`);
 
     const queryResult = query({
       prompt: this.createMessageGenerator(),
@@ -374,7 +403,7 @@ class SDKWorker {
           this.isFinalized = true;
           const session = await this.loadSession();
           if (session) {
-            const finalizePrompt = buildFinalizePrompt(session);
+            const finalizePrompt = buildSummaryPrompt(session);
             console.error('[claude-mem worker] Yielding finalize prompt to SDK agent', {
               sessionDbId: this.sessionDbId,
               sdkSessionId: this.sdkSessionId,

src/servers/search-server.ts

@@ -14,7 +14,7 @@ import { zodToJsonSchema } from 'zod-to-json-schema';
 import { basename } from 'path';
 import { SessionSearch } from '../services/sqlite/SessionSearch.js';
 import { SessionStore } from '../services/sqlite/SessionStore.js';
-import { ObservationSearchResult, SessionSummarySearchResult } from '../services/sqlite/types.js';
+import { ObservationSearchResult, SessionSummarySearchResult, UserPromptSearchResult } from '../services/sqlite/types.js';
 
 // Initialize search instance
 let search: SessionSearch;
@@ -27,6 +27,52 @@ try {
   process.exit(1);
 }
 
+/**
+ * Format search tips footer
+ */
+function formatSearchTips(): string {
+  return `\n---
+💡 Search Strategy:
+ALWAYS search with index format FIRST to get an overview and identify relevant results.
+This is critical for token efficiency - index format uses ~10x fewer tokens than full format.
+
+Search workflow:
+1. Initial search: Use default (index) format to see titles, dates, and sources
+2. Review results: Identify which items are most relevant to your needs
+3. Deep dive: Only then use format: "full" on specific items of interest
+4. Narrow down: Use filters (type, dateRange, concepts, files) to refine results
+
+Other tips:
+• To search by concept: Use find_by_concept tool
+• To browse by type: Use find_by_type with ["decision", "feature", etc.]
+• To sort by date: Use orderBy: "date_desc" or "date_asc"`;
+}
+
+/**
+ * Format observation as index entry (title, date, ID only)
+ */
+function formatObservationIndex(obs: ObservationSearchResult, index: number): string {
+  const title = obs.title || `Observation #${obs.id}`;
+  const date = new Date(obs.created_at_epoch).toLocaleString();
+  const type = obs.type ? `[${obs.type}]` : '';
+
+  return `${index + 1}. ${type} ${title}
+   Date: ${date}
+   Source: claude-mem://observation/${obs.id}`;
+}
+
+/**
+ * Format session summary as index entry (title, date, ID only)
+ */
+function formatSessionIndex(session: SessionSummarySearchResult, index: number): string {
+  const title = session.request || `Session ${session.sdk_session_id.substring(0, 8)}`;
+  const date = new Date(session.created_at_epoch).toLocaleString();
+
+  return `${index + 1}. ${title}
+   Date: ${date}
+   Source: claude-mem://session/${session.sdk_session_id}`;
+}
+
 /**
  * Format observation as text content with metadata
  */
@@ -98,6 +144,12 @@ function formatObservationResult(obs: ObservationSearchResult, index: number): s
     contentParts.push(metadata.join(' | '));
   }
 
+  // Add date
+  const date = new Date(obs.created_at_epoch).toLocaleString();
+  contentParts.push('');
+  contentParts.push(`---`);
+  contentParts.push(`Date: ${date}`);
+
   return contentParts.join('\n');
 }
 
@@ -169,6 +221,38 @@ function formatSessionResult(session: SessionSummarySearchResult, index: number)
   return contentParts.join('\n');
 }
 
+/**
+ * Format user prompt as index entry (truncated text, date, ID only)
+ */
+function formatUserPromptIndex(prompt: UserPromptSearchResult, index: number): string {
+  const truncated = prompt.prompt_text.length > 100
+    ? prompt.prompt_text.substring(0, 100) + '...'
+    : prompt.prompt_text;
+  const date = new Date(prompt.created_at_epoch).toLocaleString();
+
+  return `${index + 1}. "${truncated}"
+   Date: ${date} | Prompt #${prompt.prompt_number}
+   Source: claude-mem://user-prompt/${prompt.id}`;
+}
+
+/**
+ * Format user prompt as text content with metadata
+ */
+function formatUserPromptResult(prompt: UserPromptSearchResult, index: number): string {
+  const contentParts: string[] = [];
+  contentParts.push(`## User Prompt #${prompt.prompt_number}`);
+  contentParts.push(`*Source: claude-mem://user-prompt/${prompt.id}*`);
+  contentParts.push('');
+  contentParts.push(prompt.prompt_text);
+  contentParts.push('');
+  contentParts.push('---');
+
+  const date = new Date(prompt.created_at_epoch).toLocaleString();
+  contentParts.push(`Date: ${date}`);
+
+  return contentParts.join('\n');
+}
+
 /**
  * Common filter schema
  */
@@ -193,14 +277,15 @@ const filterSchema = z.object({
 const tools = [
   {
     name: 'search_observations',
-    description: 'Search observations using full-text search across titles, narratives, facts, and concepts',
+    description: 'Search observations using full-text search across titles, narratives, facts, and concepts. IMPORTANT: Always use index format first (default) to get an overview with minimal token usage, then use format: "full" only for specific items of interest.',
     inputSchema: z.object({
       query: z.string().describe('Search query for FTS5 full-text search'),
+      format: z.enum(['index', 'full']).default('index').describe('Output format: "index" for titles/dates only (default, RECOMMENDED for initial search), "full" for complete details (use only after reviewing index results)'),
       ...filterSchema.shape
     }),
     handler: async (args: any) => {
       try {
-        const { query, ...options } = args;
+        const { query, format = 'index', ...options } = args;
         const results = search.searchObservations(query, options);
 
         if (results.length === 0) {
@@ -212,9 +297,16 @@ const tools = [
           };
         }
 
-        // Combine all results into a single text response
-        const formattedResults = results.map((obs, i) => formatObservationResult(obs, i));
-        const combinedText = formattedResults.join('\n\n---\n\n');
+        // Format based on requested format
+        let combinedText: string;
+        if (format === 'index') {
+          const header = `Found ${results.length} observation(s) matching "${query}":\n\n`;
+          const formattedResults = results.map((obs, i) => formatObservationIndex(obs, i));
+          combinedText = header + formattedResults.join('\n\n') + formatSearchTips();
+        } else {
+          const formattedResults = results.map((obs, i) => formatObservationResult(obs, i));
+          combinedText = formattedResults.join('\n\n---\n\n');
+        }
 
         return {
           content: [{
@@ -235,9 +327,10 @@ const tools = [
   },
   {
     name: 'search_sessions',
-    description: 'Search session summaries using full-text search across requests, completions, learnings, and notes',
+    description: 'Search session summaries using full-text search across requests, completions, learnings, and notes. IMPORTANT: Always use index format first (default) to get an overview with minimal token usage, then use format: "full" only for specific items of interest.',
     inputSchema: z.object({
       query: z.string().describe('Search query for FTS5 full-text search'),
+      format: z.enum(['index', 'full']).default('index').describe('Output format: "index" for titles/dates only (default, RECOMMENDED for initial search), "full" for complete details (use only after reviewing index results)'),
       project: z.string().optional().describe('Filter by project name'),
       dateRange: z.object({
         start: z.union([z.string(), z.number()]).optional(),
@@ -249,7 +342,7 @@ const tools = [
     }),
     handler: async (args: any) => {
       try {
-        const { query, ...options } = args;
+        const { query, format = 'index', ...options } = args;
         const results = search.searchSessions(query, options);
 
         if (results.length === 0) {
@@ -261,9 +354,16 @@ const tools = [
           };
         }
 
-        // Combine all results into a single text response
-        const formattedResults = results.map((session, i) => formatSessionResult(session, i));
-        const combinedText = formattedResults.join('\n\n---\n\n');
+        // Format based on requested format
+        let combinedText: string;
+        if (format === 'index') {
+          const header = `Found ${results.length} session(s) matching "${query}":\n\n`;
+          const formattedResults = results.map((session, i) => formatSessionIndex(session, i));
+          combinedText = header + formattedResults.join('\n\n') + formatSearchTips();
+        } else {
+          const formattedResults = results.map((session, i) => formatSessionResult(session, i));
+          combinedText = formattedResults.join('\n\n---\n\n');
+        }
 
         return {
           content: [{
@@ -284,21 +384,22 @@ const tools = [
   },
   {
     name: 'find_by_concept',
-    description: 'Find observations tagged with a specific concept',
+    description: 'Find observations tagged with a specific concept. IMPORTANT: Always use index format first (default) to get an overview with minimal token usage, then use format: "full" only for specific items of interest.',
     inputSchema: z.object({
       concept: z.string().describe('Concept tag to search for'),
+      format: z.enum(['index', 'full']).default('index').describe('Output format: "index" for titles/dates only (default, RECOMMENDED for initial search), "full" for complete details (use only after reviewing index results)'),
       project: z.string().optional().describe('Filter by project name'),
       dateRange: z.object({
         start: z.union([z.string(), z.number()]).optional(),
         end: z.union([z.string(), z.number()]).optional()
       }).optional().describe('Filter by date range'),
-      limit: z.number().min(1).max(100).default(20).describe('Maximum number of results'),
+      limit: z.number().min(1).max(100).default(20).describe('Maximum results. IMPORTANT: Start with 3-5 to avoid exceeding MCP token limits, even in index mode.'),
       offset: z.number().min(0).default(0).describe('Number of results to skip'),
       orderBy: z.enum(['relevance', 'date_desc', 'date_asc']).default('date_desc').describe('Sort order')
     }),
     handler: async (args: any) => {
       try {
-        const { concept, ...filters } = args;
+        const { concept, format = 'index', ...filters } = args;
         const results = search.findByConcept(concept, filters);
 
         if (results.length === 0) {
@@ -310,9 +411,16 @@ const tools = [
           };
         }
 
-        // Combine all results into a single text response
-        const formattedResults = results.map((obs, i) => formatObservationResult(obs, i));
-        const combinedText = formattedResults.join('\n\n---\n\n');
+        // Format based on requested format
+        let combinedText: string;
+        if (format === 'index') {
+          const header = `Found ${results.length} observation(s) with concept "${concept}":\n\n`;
+          const formattedResults = results.map((obs, i) => formatObservationIndex(obs, i));
+          combinedText = header + formattedResults.join('\n\n') + formatSearchTips();
+        } else {
+          const formattedResults = results.map((obs, i) => formatObservationResult(obs, i));
+          combinedText = formattedResults.join('\n\n---\n\n');
+        }
 
         return {
           content: [{
@@ -333,21 +441,22 @@ const tools = [
   },
   {
     name: 'find_by_file',
-    description: 'Find observations and sessions that reference a specific file path',
+    description: 'Find observations and sessions that reference a specific file path. IMPORTANT: Always use index format first (default) to get an overview with minimal token usage, then use format: "full" only for specific items of interest.',
     inputSchema: z.object({
       filePath: z.string().describe('File path to search for (supports partial matching)'),
+      format: z.enum(['index', 'full']).default('index').describe('Output format: "index" for titles/dates only (default, RECOMMENDED for initial search), "full" for complete details (use only after reviewing index results)'),
       project: z.string().optional().describe('Filter by project name'),
       dateRange: z.object({
         start: z.union([z.string(), z.number()]).optional(),
         end: z.union([z.string(), z.number()]).optional()
       }).optional().describe('Filter by date range'),
-      limit: z.number().min(1).max(100).default(20).describe('Maximum number of results'),
+      limit: z.number().min(1).max(100).default(20).describe('Maximum results. IMPORTANT: Start with 3-5 to avoid exceeding MCP token limits, even in index mode.'),
       offset: z.number().min(0).default(0).describe('Number of results to skip'),
       orderBy: z.enum(['relevance', 'date_desc', 'date_asc']).default('date_desc').describe('Sort order')
     }),
     handler: async (args: any) => {
       try {
-        const { filePath, ...filters } = args;
+        const { filePath, format = 'index', ...filters } = args;
         const results = search.findByFile(filePath, filters);
 
         const totalResults = results.observations.length + results.sessions.length;
@@ -361,19 +470,37 @@ const tools = [
           };
         }
 
-        const formattedResults: string[] = [];
+        let combinedText: string;
+        if (format === 'index') {
+          const header = `Found ${totalResults} result(s) for file "${filePath}":\n\n`;
+          const formattedResults: string[] = [];
 
-        // Add observations
-        results.observations.forEach((obs, i) => {
-          formattedResults.push(formatObservationResult(obs, i));
-        });
+          // Add observations
+          results.observations.forEach((obs, i) => {
+            formattedResults.push(formatObservationIndex(obs, i));
+          });
 
-        // Add sessions
-        results.sessions.forEach((session, i) => {
-          formattedResults.push(formatSessionResult(session, i + results.observations.length));
-        });
+          // Add sessions
+          results.sessions.forEach((session, i) => {
+            formattedResults.push(formatSessionIndex(session, i + results.observations.length));
+          });
 
-        const combinedText = formattedResults.join('\n\n---\n\n');
+          combinedText = header + formattedResults.join('\n\n') + formatSearchTips();
+        } else {
+          const formattedResults: string[] = [];
+
+          // Add observations
+          results.observations.forEach((obs, i) => {
+            formattedResults.push(formatObservationResult(obs, i));
+          });
+
+          // Add sessions
+          results.sessions.forEach((session, i) => {
+            formattedResults.push(formatSessionResult(session, i + results.observations.length));
+          });
+
+          combinedText = formattedResults.join('\n\n---\n\n');
+        }
 
         return {
           content: [{
@@ -394,24 +521,25 @@ const tools = [
   },
   {
     name: 'find_by_type',
-    description: 'Find observations of a specific type (decision, bugfix, feature, refactor, discovery, change)',
+    description: 'Find observations of a specific type (decision, bugfix, feature, refactor, discovery, change). IMPORTANT: Always use index format first (default) to get an overview with minimal token usage, then use format: "full" only for specific items of interest.',
     inputSchema: z.object({
       type: z.union([
         z.enum(['decision', 'bugfix', 'feature', 'refactor', 'discovery', 'change']),
         z.array(z.enum(['decision', 'bugfix', 'feature', 'refactor', 'discovery', 'change']))
       ]).describe('Observation type(s) to filter by'),
+      format: z.enum(['index', 'full']).default('index').describe('Output format: "index" for titles/dates only (default, RECOMMENDED for initial search), "full" for complete details (use only after reviewing index results)'),
       project: z.string().optional().describe('Filter by project name'),
       dateRange: z.object({
         start: z.union([z.string(), z.number()]).optional(),
         end: z.union([z.string(), z.number()]).optional()
       }).optional().describe('Filter by date range'),
-      limit: z.number().min(1).max(100).default(20).describe('Maximum number of results'),
+      limit: z.number().min(1).max(100).default(20).describe('Maximum results. IMPORTANT: Start with 3-5 to avoid exceeding MCP token limits, even in index mode.'),
       offset: z.number().min(0).default(0).describe('Number of results to skip'),
       orderBy: z.enum(['relevance', 'date_desc', 'date_asc']).default('date_desc').describe('Sort order')
     }),
     handler: async (args: any) => {
       try {
-        const { type, ...filters } = args;
+        const { type, format = 'index', ...filters } = args;
         const results = search.findByType(type, filters);
 
         if (results.length === 0) {
@@ -424,9 +552,17 @@ const tools = [
           };
         }
 
-        // Combine all results into a single text response
-        const formattedResults = results.map((obs, i) => formatObservationResult(obs, i));
-        const combinedText = formattedResults.join('\n\n---\n\n');
+        // Format based on requested format
+        const typeStr = Array.isArray(type) ? type.join(', ') : type;
+        let combinedText: string;
+        if (format === 'index') {
+          const header = `Found ${results.length} observation(s) with type "${typeStr}":\n\n`;
+          const formattedResults = results.map((obs, i) => formatObservationIndex(obs, i));
+          combinedText = header + formattedResults.join('\n\n') + formatSearchTips();
+        } else {
+          const formattedResults = results.map((obs, i) => formatObservationResult(obs, i));
+          combinedText = formattedResults.join('\n\n---\n\n');
+        }
 
         return {
           content: [{
@@ -584,41 +720,44 @@ const tools = [
     }
   },
   {
-    name: 'advanced_search',
-    description: 'Advanced search combining full-text search with structured filters across both observations and sessions',
+    name: 'search_user_prompts',
+    description: 'Search raw user prompts with full-text search. Use this to find what the user actually said/requested across all sessions. IMPORTANT: Always use index format first (default) to get an overview with minimal token usage, then use format: "full" only for specific items of interest.',
     inputSchema: z.object({
-      textQuery: z.string().optional().describe('Optional text query for FTS5 search'),
-      searchSessions: z.boolean().default(true).describe('Include session summaries in results'),
-      ...filterSchema.shape
+      query: z.string().describe('Search query for FTS5 full-text search'),
+      format: z.enum(['index', 'full']).default('index').describe('Output format: "index" for truncated prompts/dates (default, RECOMMENDED for initial search), "full" for complete prompt text (use only after reviewing index results)'),
+      project: z.string().optional().describe('Filter by project name'),
+      dateRange: z.object({
+        start: z.union([z.string(), z.number()]).optional(),
+        end: z.union([z.string(), z.number()]).optional()
+      }).optional().describe('Filter by date range'),
+      limit: z.number().min(1).max(100).default(20).describe('Maximum number of results'),
+      offset: z.number().min(0).default(0).describe('Number of results to skip'),
+      orderBy: z.enum(['relevance', 'date_desc', 'date_asc']).default('relevance').describe('Sort order')
     }),
     handler: async (args: any) => {
       try {
-        const results = search.advancedSearch(args);
+        const { query, format = 'index', ...options } = args;
+        const results = search.searchUserPrompts(query, options);
 
-        const totalResults = results.observations.length + results.sessions.length;
-
-        if (totalResults === 0) {
+        if (results.length === 0) {
           return {
             content: [{
               type: 'text' as const,
-              text: 'No results found matching the search criteria'
+              text: `No user prompts found matching "${query}"`
             }]
           };
         }
 
-        const formattedResults: string[] = [];
-
-        // Add observations
-        results.observations.forEach((obs, i) => {
-          formattedResults.push(formatObservationResult(obs, i));
-        });
-
-        // Add sessions
-        results.sessions.forEach((session, i) => {
-          formattedResults.push(formatSessionResult(session, i + results.observations.length));
-        });
-
-        const combinedText = formattedResults.join('\n\n---\n\n');
+        // Format based on requested format
+        let combinedText: string;
+        if (format === 'index') {
+          const header = `Found ${results.length} user prompt(s) matching "${query}":\n\n`;
+          const formattedResults = results.map((prompt, i) => formatUserPromptIndex(prompt, i));
+          combinedText = header + formattedResults.join('\n\n') + formatSearchTips();
+        } else {
+          const formattedResults = results.map((prompt, i) => formatUserPromptResult(prompt, i));
+          combinedText = formattedResults.join('\n\n---\n\n');
+        }
 
         return {
           content: [{

src/services/sqlite/SessionSearch.ts

@@ -3,10 +3,12 @@ import { DATA_DIR, DB_PATH, ensureDir } from '../../shared/paths.js';
 import {
   ObservationSearchResult,
   SessionSummarySearchResult,
+  UserPromptSearchResult,
   SearchOptions,
   SearchFilters,
   DateRange,
-  ObservationRow
+  ObservationRow,
+  UserPromptRow
 } from './types.js';
 
 /**
@@ -134,12 +136,19 @@ export class SessionSearch {
 
   /**
    * Escape FTS5 special characters in user input
+   * 
+   * FTS5 uses double quotes for phrase searches and treats certain characters
+   * as operators (*, AND, OR, NOT, parentheses, etc.). To prevent injection,
+   * we wrap user input in double quotes and escape internal quotes by doubling them.
+   * This converts any user input into a safe phrase search.
+   * 
+   * @param text - User input to escape for FTS5 MATCH queries
+   * @returns Safely escaped FTS5 query string
    */
   private escapeFTS5(text: string): string {
-    // FTS5 special characters: " * ( ) AND OR NOT
-    // For safety, we'll wrap the entire query in quotes for phrase search
-    // or let advanced users pass boolean operators directly
-    return text;
+    // Escape internal double quotes by doubling them (FTS5 standard)
+    // Then wrap the entire string in double quotes for phrase search
+    return `"${text.replace(/"/g, '""')}"`;
   }
 
   /**
@@ -349,43 +358,53 @@ export class SessionSearch {
   /**
    * Find observations by concept tag
    */
-  findByConcept(concept: string, filters: SearchFilters = {}): ObservationSearchResult[] {
+  findByConcept(concept: string, options: SearchOptions = {}): ObservationSearchResult[] {
     const params: any[] = [];
+    const { limit = 50, offset = 0, orderBy = 'date_desc', ...filters } = options;
 
     // Add concept to filters
     const conceptFilters = { ...filters, concepts: concept };
     const filterClause = this.buildFilterClause(conceptFilters, params, 'o');
+    const orderClause = this.buildOrderClause(orderBy, false);
 
     const sql = `
       SELECT o.*
       FROM observations o
       WHERE ${filterClause}
-      ORDER BY o.created_at_epoch DESC
+      ${orderClause}
+      LIMIT ? OFFSET ?
     `;
 
+    params.push(limit, offset);
+
     return this.db.prepare(sql).all(...params) as ObservationSearchResult[];
   }
 
   /**
    * Find observations and summaries by file path
    */
-  findByFile(filePath: string, filters: SearchFilters = {}): {
+  findByFile(filePath: string, options: SearchOptions = {}): {
     observations: ObservationSearchResult[];
     sessions: SessionSummarySearchResult[];
   } {
     const params: any[] = [];
+    const { limit = 50, offset = 0, orderBy = 'date_desc', ...filters } = options;
 
     // Add file to filters
     const fileFilters = { ...filters, files: filePath };
     const filterClause = this.buildFilterClause(fileFilters, params, 'o');
+    const orderClause = this.buildOrderClause(orderBy, false);
 
     const observationsSql = `
       SELECT o.*
       FROM observations o
       WHERE ${filterClause}
-      ORDER BY o.created_at_epoch DESC
+      ${orderClause}
+      LIMIT ? OFFSET ?
     `;
 
+    params.push(limit, offset);
+
     const observations = this.db.prepare(observationsSql).all(...params) as ObservationSearchResult[];
 
     // For session summaries, search files_read and files_edited
@@ -425,8 +444,11 @@ export class SessionSearch {
       FROM session_summaries s
       WHERE ${baseConditions.join(' AND ')}
       ORDER BY s.created_at_epoch DESC
+      LIMIT ? OFFSET ?
     `;
 
+    sessionParams.push(limit, offset);
+
     const sessions = this.db.prepare(sessionsSql).all(...sessionParams) as SessionSummarySearchResult[];
 
     return { observations, sessions };
@@ -437,83 +459,122 @@ export class SessionSearch {
    */
   findByType(
     type: ObservationRow['type'] | ObservationRow['type'][],
-    filters: SearchFilters = {}
+    options: SearchOptions = {}
   ): ObservationSearchResult[] {
     const params: any[] = [];
+    const { limit = 50, offset = 0, orderBy = 'date_desc', ...filters } = options;
 
     // Add type to filters
     const typeFilters = { ...filters, type };
     const filterClause = this.buildFilterClause(typeFilters, params, 'o');
+    const orderClause = this.buildOrderClause(orderBy, false);
 
     const sql = `
       SELECT o.*
       FROM observations o
       WHERE ${filterClause}
-      ORDER BY o.created_at_epoch DESC
+      ${orderClause}
+      LIMIT ? OFFSET ?
     `;
 
+    params.push(limit, offset);
+
     return this.db.prepare(sql).all(...params) as ObservationSearchResult[];
   }
 
   /**
-   * Advanced search combining FTS5 and structured filters
+   * Search user prompts with full-text search
    */
-  advancedSearch(options: {
-    textQuery?: string;
-    searchSessions?: boolean;
-  } & SearchOptions): {
-    observations: ObservationSearchResult[];
-    sessions: SessionSummarySearchResult[];
-  } {
-    const { textQuery, searchSessions = true, ...searchOptions } = options;
+  searchUserPrompts(query: string, options: SearchOptions = {}): UserPromptSearchResult[] {
+    const params: any[] = [];
+    const { limit = 20, offset = 0, orderBy = 'relevance', ...filters } = options;
 
-    let observations: ObservationSearchResult[] = [];
-    let sessions: SessionSummarySearchResult[] = [];
+    // Build FTS5 match query
+    const ftsQuery = this.escapeFTS5(query);
+    params.push(ftsQuery);
 
-    if (textQuery) {
-      // Use FTS5 search
-      observations = this.searchObservations(textQuery, searchOptions);
-      if (searchSessions) {
-        sessions = this.searchSessions(textQuery, searchOptions);
+    // Build filter conditions (join with sdk_sessions for project filtering)
+    const baseConditions: string[] = [];
+    if (filters.project) {
+      baseConditions.push('s.project = ?');
+      params.push(filters.project);
+    }
+
+    if (filters.dateRange) {
+      const { start, end } = filters.dateRange;
+      if (start) {
+        const startEpoch = typeof start === 'number' ? start : new Date(start).getTime();
+        baseConditions.push('up.created_at_epoch >= ?');
+        params.push(startEpoch);
       }
-    } else {
-      // Pure structured query (no FTS)
-      const params: any[] = [];
-      const filterClause = this.buildFilterClause(searchOptions, params, 'o');
-
-      if (filterClause) {
-        const obsSql = `
-          SELECT o.*
-          FROM observations o
-          WHERE ${filterClause}
-          ${this.buildOrderClause(searchOptions.orderBy, false)}
-          LIMIT ? OFFSET ?
-        `;
-        params.push(searchOptions.limit || 50, searchOptions.offset || 0);
-        observations = this.db.prepare(obsSql).all(...params) as ObservationSearchResult[];
-      }
-
-      if (searchSessions) {
-        const sessionParams: any[] = [];
-        const sessionFilters = { ...searchOptions };
-        delete sessionFilters.type;
-        const sessionFilterClause = this.buildFilterClause(sessionFilters, sessionParams, 's');
-
-        if (sessionFilterClause) {
-          const sessSql = `
-            SELECT s.*
-            FROM session_summaries s
-            WHERE ${sessionFilterClause}
-            ORDER BY s.created_at_epoch DESC
-            LIMIT ? OFFSET ?
-          `;
-          sessionParams.push(searchOptions.limit || 50, searchOptions.offset || 0);
-          sessions = this.db.prepare(sessSql).all(...sessionParams) as SessionSummarySearchResult[];
-        }
+      if (end) {
+        const endEpoch = typeof end === 'number' ? end : new Date(end).getTime();
+        baseConditions.push('up.created_at_epoch <= ?');
+        params.push(endEpoch);
       }
     }
 
-    return { observations, sessions };
+    const whereClause = baseConditions.length > 0 ? `AND ${baseConditions.join(' AND ')}` : '';
+
+    // Build ORDER BY
+    const orderClause = orderBy === 'relevance'
+      ? 'ORDER BY user_prompts_fts.rank ASC'
+      : orderBy === 'date_asc'
+      ? 'ORDER BY up.created_at_epoch ASC'
+      : 'ORDER BY up.created_at_epoch DESC';
+
+    // Main query with FTS5 (join sdk_sessions for project filtering)
+    const sql = `
+      SELECT
+        up.*,
+        user_prompts_fts.rank as rank
+      FROM user_prompts up
+      JOIN user_prompts_fts ON up.id = user_prompts_fts.rowid
+      JOIN sdk_sessions s ON up.claude_session_id = s.claude_session_id
+      WHERE user_prompts_fts MATCH ?
+      ${whereClause}
+      ${orderClause}
+      LIMIT ? OFFSET ?
+    `;
+
+    params.push(limit, offset);
+
+    const results = this.db.prepare(sql).all(...params) as UserPromptSearchResult[];
+
+    // Normalize rank to score
+    if (results.length > 0) {
+      const minRank = Math.min(...results.map(r => r.rank || 0));
+      const maxRank = Math.max(...results.map(r => r.rank || 0));
+      const range = maxRank - minRank || 1;
+
+      results.forEach(r => {
+        if (r.rank !== undefined) {
+          r.score = 1 - ((r.rank - minRank) / range);
+        }
+      });
+    }
+
+    return results;
+  }
+
+  /**
+   * Get all prompts for a session by claude_session_id
+   */
+  getUserPromptsBySession(claudeSessionId: string): UserPromptRow[] {
+    const stmt = this.db.prepare(`
+      SELECT
+        id,
+        claude_session_id,
+        prompt_number,
+        prompt_text,
+        created_at,
+        created_at_epoch
+      FROM user_prompts
+      WHERE claude_session_id = ?
+      ORDER BY prompt_number ASC
+    `);
+
+    return stmt.all(claudeSessionId) as UserPromptRow[];
   }
 
   /**

src/services/sqlite/SessionStore.ts

@@ -7,7 +7,7 @@ import { logger } from '../../utils/logger.js';
  * Provides simple, synchronous CRUD operations for session-based memory
  */
 export class SessionStore {
-  private db: Database.Database;
+  public db: Database.Database;
 
   constructor() {
     ensureDir(DATA_DIR);
@@ -27,6 +27,7 @@ export class SessionStore {
     this.removeSessionSummariesUniqueConstraint();
     this.addObservationHierarchicalFields();
     this.makeObservationsTextNullable();
+    this.createUserPromptsTable();
   }
 
   /**
@@ -405,6 +406,92 @@ export class SessionStore {
     }
   }
 
+  /**
+   * Create user_prompts table with FTS5 support (migration 10)
+   */
+  private createUserPromptsTable(): void {
+    try {
+      // Check if migration already applied
+      const applied = this.db.prepare('SELECT version FROM schema_versions WHERE version = ?').get(10) as {version: number} | undefined;
+      if (applied) return;
+
+      // Check if table already exists
+      const tableInfo = this.db.pragma('table_info(user_prompts)');
+      if ((tableInfo as any[]).length > 0) {
+        // Already migrated
+        this.db.prepare('INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)').run(10, new Date().toISOString());
+        return;
+      }
+
+      console.error('[SessionStore] Creating user_prompts table with FTS5 support...');
+
+      // Begin transaction
+      this.db.exec('BEGIN TRANSACTION');
+
+      try {
+        // Create main table (using claude_session_id since sdk_session_id is set asynchronously by worker)
+        this.db.exec(`
+          CREATE TABLE user_prompts (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            claude_session_id TEXT NOT NULL,
+            prompt_number INTEGER NOT NULL,
+            prompt_text TEXT NOT NULL,
+            created_at TEXT NOT NULL,
+            created_at_epoch INTEGER NOT NULL,
+            FOREIGN KEY(claude_session_id) REFERENCES sdk_sessions(claude_session_id) ON DELETE CASCADE
+          );
+
+          CREATE INDEX idx_user_prompts_claude_session ON user_prompts(claude_session_id);
+          CREATE INDEX idx_user_prompts_created ON user_prompts(created_at_epoch DESC);
+          CREATE INDEX idx_user_prompts_prompt_number ON user_prompts(prompt_number);
+        `);
+
+        // Create FTS5 virtual table
+        this.db.exec(`
+          CREATE VIRTUAL TABLE user_prompts_fts USING fts5(
+            prompt_text,
+            content='user_prompts',
+            content_rowid='id'
+          );
+        `);
+
+        // Create triggers to sync FTS5
+        this.db.exec(`
+          CREATE TRIGGER user_prompts_ai AFTER INSERT ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_ad AFTER DELETE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+          END;
+
+          CREATE TRIGGER user_prompts_au AFTER UPDATE ON user_prompts BEGIN
+            INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+            VALUES('delete', old.id, old.prompt_text);
+            INSERT INTO user_prompts_fts(rowid, prompt_text)
+            VALUES (new.id, new.prompt_text);
+          END;
+        `);
+
+        // Commit transaction
+        this.db.exec('COMMIT');
+
+        // Record migration
+        this.db.prepare('INSERT OR IGNORE INTO schema_versions (version, applied_at) VALUES (?, ?)').run(10, new Date().toISOString());
+
+        console.error('[SessionStore] Successfully created user_prompts table with FTS5 support');
+      } catch (error: any) {
+        // Rollback on error
+        this.db.exec('ROLLBACK');
+        throw error;
+      }
+    } catch (error: any) {
+      console.error('[SessionStore] Migration error (create user_prompts table):', error.message);
+    }
+  }
+
   /**
    * Get recent session summaries for a project
    */
@@ -433,6 +520,31 @@ export class SessionStore {
     return stmt.all(project, limit) as any[];
   }
 
+  /**
+   * Get recent summaries with session info for context display
+   */
+  getRecentSummariesWithSessionInfo(project: string, limit: number = 3): Array<{
+    sdk_session_id: string;
+    request: string | null;
+    learned: string | null;
+    completed: string | null;
+    next_steps: string | null;
+    prompt_number: number | null;
+    created_at: string;
+  }> {
+    const stmt = this.db.prepare(`
+      SELECT
+        sdk_session_id, request, learned, completed, next_steps,
+        prompt_number, created_at
+      FROM session_summaries
+      WHERE project = ?
+      ORDER BY created_at_epoch DESC
+      LIMIT ?
+    `);
+
+    return stmt.all(project, limit) as any[];
+  }
+
   /**
    * Get recent observations for a project
    */
@@ -532,17 +644,71 @@ export class SessionStore {
     return stmt.get(sdkSessionId) as any || null;
   }
 
+  /**
+   * Get aggregated files from all observations for a session
+   */
+  getFilesForSession(sdkSessionId: string): {
+    filesRead: string[];
+    filesModified: string[];
+  } {
+    const stmt = this.db.prepare(`
+      SELECT files_read, files_modified
+      FROM observations
+      WHERE sdk_session_id = ?
+    `);
+
+    const rows = stmt.all(sdkSessionId) as Array<{
+      files_read: string | null;
+      files_modified: string | null;
+    }>;
+
+    const filesReadSet = new Set<string>();
+    const filesModifiedSet = new Set<string>();
+
+    for (const row of rows) {
+      // Parse files_read
+      if (row.files_read) {
+        try {
+          const files = JSON.parse(row.files_read);
+          if (Array.isArray(files)) {
+            files.forEach(f => filesReadSet.add(f));
+          }
+        } catch {
+          // Skip invalid JSON
+        }
+      }
+
+      // Parse files_modified
+      if (row.files_modified) {
+        try {
+          const files = JSON.parse(row.files_modified);
+          if (Array.isArray(files)) {
+            files.forEach(f => filesModifiedSet.add(f));
+          }
+        } catch {
+          // Skip invalid JSON
+        }
+      }
+    }
+
+    return {
+      filesRead: Array.from(filesReadSet),
+      filesModified: Array.from(filesModifiedSet)
+    };
+  }
+
   /**
    * Get session by ID
    */
   getSessionById(id: number): {
     id: number;
+    claude_session_id: string;
     sdk_session_id: string | null;
     project: string;
     user_prompt: string;
   } | null {
     const stmt = this.db.prepare(`
-      SELECT id, sdk_session_id, project, user_prompt
+      SELECT id, claude_session_id, sdk_session_id, project, user_prompt
       FROM sdk_sessions
       WHERE id = ?
       LIMIT 1
@@ -628,19 +794,32 @@ export class SessionStore {
   }
 
   /**
-   * Create a new SDK session
+   * Create a new SDK session (idempotent - returns existing session ID if already exists)
+   * Sets both claude_session_id and sdk_session_id to the same value
    */
   createSDKSession(claudeSessionId: string, project: string, userPrompt: string): number {
     const now = new Date();
     const nowEpoch = now.getTime();
 
+    // Try to insert - will be ignored if session already exists
+    // claude_session_id and sdk_session_id are the same value
     const stmt = this.db.prepare(`
-      INSERT INTO sdk_sessions
-      (claude_session_id, project, user_prompt, started_at, started_at_epoch, status)
-      VALUES (?, ?, ?, ?, ?, 'active')
+      INSERT OR IGNORE INTO sdk_sessions
+      (claude_session_id, sdk_session_id, project, user_prompt, started_at, started_at_epoch, status)
+      VALUES (?, ?, ?, ?, ?, ?, 'active')
     `);
 
-    const result = stmt.run(claudeSessionId, project, userPrompt, now.toISOString(), nowEpoch);
+    const result = stmt.run(claudeSessionId, claudeSessionId, project, userPrompt, now.toISOString(), nowEpoch);
+
+    // If lastInsertRowid is 0, insert was ignored (session exists), so fetch existing ID
+    if (result.lastInsertRowid === 0 || result.changes === 0) {
+      const selectStmt = this.db.prepare(`
+        SELECT id FROM sdk_sessions WHERE claude_session_id = ? LIMIT 1
+      `);
+      const existing = selectStmt.get(claudeSessionId) as { id: number } | undefined;
+      return existing!.id;
+    }
+
     return result.lastInsertRowid as number;
   }
 
@@ -699,18 +878,36 @@ export class SessionStore {
     return result?.worker_port || null;
   }
 
+  /**
+   * Save a user prompt
+   */
+  saveUserPrompt(claudeSessionId: string, promptNumber: number, promptText: string): number {
+    const now = new Date();
+    const nowEpoch = now.getTime();
+
+    const stmt = this.db.prepare(`
+      INSERT INTO user_prompts
+      (claude_session_id, prompt_number, prompt_text, created_at, created_at_epoch)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+
+    const result = stmt.run(claudeSessionId, promptNumber, promptText, now.toISOString(), nowEpoch);
+    return result.lastInsertRowid as number;
+  }
+
   /**
    * Store an observation (from SDK parsing)
+   * Auto-creates session record if it doesn't exist in the index
    */
   storeObservation(
     sdkSessionId: string,
     project: string,
     observation: {
       type: string;
-      title: string;
-      subtitle: string;
+      title: string | null;
+      subtitle: string | null;
       facts: string[];
-      narrative: string;
+      narrative: string | null;
       concepts: string[];
       files_read: string[];
       files_modified: string[];
@@ -720,6 +917,29 @@ export class SessionStore {
     const now = new Date();
     const nowEpoch = now.getTime();
 
+    // Ensure session record exists in the index (auto-create if missing)
+    const checkStmt = this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `);
+    const existingSession = checkStmt.get(sdkSessionId) as { id: number } | undefined;
+
+    if (!existingSession) {
+      // Auto-create session record if it doesn't exist
+      const insertSession = this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `);
+      insertSession.run(
+        sdkSessionId, // claude_session_id and sdk_session_id are the same
+        sdkSessionId,
+        project,
+        now.toISOString(),
+        nowEpoch
+      );
+      console.error(`[SessionStore] Auto-created session record for session_id: ${sdkSessionId}`);
+    }
+
     const stmt = this.db.prepare(`
       INSERT INTO observations
       (sdk_session_id, project, type, title, subtitle, facts, narrative, concepts,
@@ -746,6 +966,7 @@ export class SessionStore {
 
   /**
    * Store a session summary (from SDK parsing)
+   * Auto-creates session record if it doesn't exist in the index
    */
   storeSummary(
     sdkSessionId: string,
@@ -763,6 +984,29 @@ export class SessionStore {
     const now = new Date();
     const nowEpoch = now.getTime();
 
+    // Ensure session record exists in the index (auto-create if missing)
+    const checkStmt = this.db.prepare(`
+      SELECT id FROM sdk_sessions WHERE sdk_session_id = ?
+    `);
+    const existingSession = checkStmt.get(sdkSessionId) as { id: number } | undefined;
+
+    if (!existingSession) {
+      // Auto-create session record if it doesn't exist
+      const insertSession = this.db.prepare(`
+        INSERT INTO sdk_sessions
+        (claude_session_id, sdk_session_id, project, started_at, started_at_epoch, status)
+        VALUES (?, ?, ?, ?, ?, 'active')
+      `);
+      insertSession.run(
+        sdkSessionId, // claude_session_id and sdk_session_id are the same
+        sdkSessionId,
+        project,
+        now.toISOString(),
+        nowEpoch
+      );
+      console.error(`[SessionStore] Auto-created session record for session_id: ${sdkSessionId}`);
+    }
+
     const stmt = this.db.prepare(`
       INSERT INTO session_summaries
       (sdk_session_id, project, request, investigated, learned, completed,

src/services/sqlite/types.ts

@@ -236,6 +236,15 @@ export interface SessionSummaryRow {
   created_at_epoch: number;
 }
 
+export interface UserPromptRow {
+  id: number;
+  claude_session_id: string;
+  prompt_number: number;
+  prompt_text: string;
+  created_at: string;
+  created_at_epoch: number;
+}
+
 /**
  * Search and Filter Types
  */
@@ -267,3 +276,8 @@ export interface SessionSummarySearchResult extends SessionSummaryRow {
   rank?: number; // FTS5 relevance score (lower is better)
   score?: number; // Normalized score (higher is better, 0-1)
 }
+
+export interface UserPromptSearchResult extends UserPromptRow {
+  rank?: number; // FTS5 relevance score (lower is better)
+  score?: number; // Normalized score (higher is better, 0-1)
+}

src/services/worker-service.ts

@@ -7,16 +7,46 @@ import express, { Request, Response } from 'express';
 import { query } from '@anthropic-ai/claude-agent-sdk';
 import type { SDKUserMessage, SDKSystemMessage } from '@anthropic-ai/claude-agent-sdk';
 import { SessionStore } from './sqlite/SessionStore.js';
-import { buildInitPrompt, buildObservationPrompt, buildFinalizePrompt } from '../sdk/prompts.js';
+import { buildInitPrompt, buildObservationPrompt, buildSummaryPrompt } from '../sdk/prompts.js';
 import { parseObservations, parseSummary } from '../sdk/parser.js';
 import type { SDKSession } from '../sdk/prompts.js';
 import { logger } from '../utils/logger.js';
 import { ensureAllDataDirs } from '../shared/paths.js';
+import { execSync } from 'child_process';
 
-const MODEL = 'claude-sonnet-4-5';
+const MODEL = process.env.CLAUDE_MEM_MODEL || 'claude-sonnet-4-5';
 const DISALLOWED_TOOLS = ['Glob', 'Grep', 'ListMcpResourcesTool', 'WebSearch'];
 const FIXED_PORT = parseInt(process.env.CLAUDE_MEM_WORKER_PORT || '37777', 10);
 
+/**
+ * Find Claude Code executable path using which (Unix/Mac) or where (Windows)
+ */
+function findClaudePath(): string {
+  try {
+    // Try environment variable first
+    if (process.env.CLAUDE_CODE_PATH) {
+      return process.env.CLAUDE_CODE_PATH;
+    }
+
+    // Use which on Unix/Mac, where on Windows
+    const command = process.platform === 'win32' ? 'where claude' : 'which claude';
+    const result = execSync(command, { encoding: 'utf8' }).trim();
+
+    // On Windows, 'where' returns multiple lines if there are multiple matches, take the first
+    const path = result.split('\n')[0].trim();
+
+    if (!path) {
+      throw new Error('Claude executable not found in PATH');
+    }
+
+    logger.info('SYSTEM', `Found Claude executable: ${path}`);
+    return path;
+  } catch (error: any) {
+    logger.failure('SYSTEM', 'Failed to find Claude executable', {}, error);
+    throw new Error('Claude Code executable not found. Please ensure claude is in your PATH or set CLAUDE_CODE_PATH environment variable.');
+  }
+}
+
 interface ObservationMessage {
   type: 'observation';
   tool_name: string;
@@ -37,6 +67,7 @@ type WorkerMessage = ObservationMessage | SummarizeMessage;
  */
 interface ActiveSession {
   sessionDbId: number;
+  claudeSessionId: string; // Real Claude Code session ID
   sdkSessionId: string | null;
   project: string;
   userPrompt: string;
@@ -118,14 +149,21 @@ class WorkerService {
     const correlationId = logger.sessionId(sessionDbId);
     logger.info('WORKER', 'Session init', { correlationId, project });
 
-    if (this.sessions.has(sessionDbId)) {
-      res.status(409).json({ error: 'Session already exists' });
+    // Fetch real Claude Code session ID from database
+    const db = new SessionStore();
+    const dbSession = db.getSessionById(sessionDbId);
+    if (!dbSession) {
+      db.close();
+      res.status(404).json({ error: 'Session not found in database' });
       return;
     }
 
+    const claudeSessionId = dbSession.claude_session_id;
+
     // Create session state
     const session: ActiveSession = {
       sessionDbId,
+      claudeSessionId,
       sdkSessionId: null,
       project,
       userPrompt,
@@ -140,7 +178,6 @@ class WorkerService {
     this.sessions.set(sessionDbId, session);
 
     // Update port in database
-    const db = new SessionStore();
     db.setWorkerPort(sessionDbId, this.port!);
     db.close();
 
@@ -169,10 +206,36 @@ class WorkerService {
     const sessionDbId = parseInt(req.params.sessionDbId, 10);
     const { tool_name, tool_input, tool_output, prompt_number } = req.body;
 
-    const session = this.sessions.get(sessionDbId);
+    let session = this.sessions.get(sessionDbId);
     if (!session) {
-      res.status(404).json({ error: 'Session not found' });
-      return;
+      // Auto-create session if it doesn't exist (e.g., worker restarted)
+      const db = new SessionStore();
+      const dbSession = db.getSessionById(sessionDbId);
+      db.close();
+
+      session = {
+        sessionDbId,
+        claudeSessionId: dbSession!.claude_session_id,
+        sdkSessionId: null,
+        project: dbSession!.project,
+        userPrompt: dbSession!.user_prompt,
+        pendingMessages: [],
+        abortController: new AbortController(),
+        generatorPromise: null,
+        lastPromptNumber: 0,
+        observationCounter: 0,
+        startTime: Date.now()
+      };
+      this.sessions.set(sessionDbId, session);
+
+      // Start SDK agent in background
+      session.generatorPromise = this.runSDKAgent(session).catch(err => {
+        logger.failure('WORKER', 'SDK agent error', { sessionId: sessionDbId }, err);
+        const db = new SessionStore();
+        db.markSessionFailed(sessionDbId);
+        db.close();
+        this.sessions.delete(sessionDbId);
+      });
     }
 
     // Create correlation ID for tracking this observation
@@ -204,10 +267,36 @@ class WorkerService {
     const sessionDbId = parseInt(req.params.sessionDbId, 10);
     const { prompt_number } = req.body;
 
-    const session = this.sessions.get(sessionDbId);
+    let session = this.sessions.get(sessionDbId);
     if (!session) {
-      res.status(404).json({ error: 'Session not found' });
-      return;
+      // Auto-create session if it doesn't exist (e.g., worker restarted)
+      const db = new SessionStore();
+      const dbSession = db.getSessionById(sessionDbId);
+      db.close();
+
+      session = {
+        sessionDbId,
+        claudeSessionId: dbSession!.claude_session_id,
+        sdkSessionId: null,
+        project: dbSession!.project,
+        userPrompt: dbSession!.user_prompt,
+        pendingMessages: [],
+        abortController: new AbortController(),
+        generatorPromise: null,
+        lastPromptNumber: 0,
+        observationCounter: 0,
+        startTime: Date.now()
+      };
+      this.sessions.set(sessionDbId, session);
+
+      // Start SDK agent in background
+      session.generatorPromise = this.runSDKAgent(session).catch(err => {
+        logger.failure('WORKER', 'SDK agent error', { sessionId: sessionDbId }, err);
+        const db = new SessionStore();
+        db.markSessionFailed(sessionDbId);
+        db.close();
+        this.sessions.delete(sessionDbId);
+      });
     }
 
     logger.dataIn('WORKER', 'Summary requested', {
@@ -286,7 +375,8 @@ class WorkerService {
   private async runSDKAgent(session: ActiveSession): Promise<void> {
     logger.info('SDK', 'Agent starting', { sessionId: session.sessionDbId });
 
-    const claudePath = process.env.CLAUDE_CODE_PATH || '/Users/alexnewman/.nvm/versions/node/v24.5.0/bin/claude';
+    const claudePath = findClaudePath();
+    logger.info('SDK', `Using Claude executable: ${claudePath}`, { sessionId: session.sessionDbId });
 
     try {
       const queryResult = query({
@@ -300,26 +390,8 @@ class WorkerService {
       });
 
       for await (const message of queryResult) {
-        // Handle system init message
-        if (message.type === 'system' && message.subtype === 'init') {
-          const systemMsg = message as SDKSystemMessage;
-          if (systemMsg.session_id) {
-            // Update in database first, check if it succeeded
-            const db = new SessionStore();
-            const updated = db.updateSDKSessionId(session.sessionDbId, systemMsg.session_id);
-            db.close();
-
-            if (updated) {
-              logger.success('SDK', 'Session initialized', {
-                sessionId: session.sessionDbId,
-                sdkSessionId: systemMsg.session_id
-              });
-              session.sdkSessionId = systemMsg.session_id;
-            }
-          }
-        }
         // Handle assistant messages
-        else if (message.type === 'assistant') {
+        if (message.type === 'assistant') {
           const content = message.message.content;
           const textContent = Array.isArray(content)
             ? content.filter((c: any) => c.type === 'text').map((c: any) => c.text).join('\n')
@@ -367,18 +439,19 @@ class WorkerService {
    * Keeps running continuously - no finalize, agent stays alive for entire Claude Code session
    */
   private async* createMessageGenerator(session: ActiveSession): AsyncIterable<SDKUserMessage> {
-    const claudeSessionId = `session-${session.sessionDbId}`;
-    const initPrompt = buildInitPrompt(session.project, claudeSessionId, session.userPrompt);
+    // Use real Claude Code session ID instead of fake session-{dbId}
+    const initPrompt = buildInitPrompt(session.project, session.claudeSessionId, session.userPrompt);
 
     logger.dataIn('SDK', `Init prompt sent (${initPrompt.length} chars)`, {
       sessionId: session.sessionDbId,
+      claudeSessionId: session.claudeSessionId,
       project: session.project
     });
     logger.debug('SDK', 'Full init prompt', { sessionId: session.sessionDbId }, initPrompt);
 
     yield {
       type: 'user',
-      session_id: session.sdkSessionId || claudeSessionId,
+      session_id: session.claudeSessionId, // Use real session ID from the start
       parent_tool_use_id: null,
       message: {
         role: 'user',
@@ -404,28 +477,26 @@ class WorkerService {
           session.lastPromptNumber = message.prompt_number;
 
           const db = new SessionStore();
-          const dbSession = db.getSessionById(session.sessionDbId) as SDKSession | undefined;
+          const dbSession = db.getSessionById(session.sessionDbId) as SDKSession;
           db.close();
 
-          if (dbSession) {
-            const summarizePrompt = buildFinalizePrompt(dbSession);
+          const summarizePrompt = buildSummaryPrompt(dbSession);
 
-            logger.dataIn('SDK', `Summary prompt sent (${summarizePrompt.length} chars)`, {
-              sessionId: session.sessionDbId,
-              promptNumber: message.prompt_number
-            });
-            logger.debug('SDK', 'Full summary prompt', { sessionId: session.sessionDbId }, summarizePrompt);
+          logger.dataIn('SDK', `Summary prompt sent (${summarizePrompt.length} chars)`, {
+            sessionId: session.sessionDbId,
+            promptNumber: message.prompt_number
+          });
+          logger.debug('SDK', 'Full summary prompt', { sessionId: session.sessionDbId }, summarizePrompt);
 
-            yield {
-              type: 'user',
-              session_id: session.sdkSessionId || claudeSessionId,
-              parent_tool_use_id: null,
-              message: {
-                role: 'user',
-                content: summarizePrompt
-              }
-            };
-          }
+          yield {
+            type: 'user',
+            session_id: session.claudeSessionId,
+            parent_tool_use_id: null,
+            message: {
+              role: 'user',
+              content: summarizePrompt
+            }
+          };
         } else if (message.type === 'observation') {
           session.lastPromptNumber = message.prompt_number;
 
@@ -449,7 +520,7 @@ class WorkerService {
 
           yield {
             type: 'user',
-            session_id: session.sdkSessionId || claudeSessionId,
+            session_id: session.claudeSessionId, // Use real session ID
             parent_tool_use_id: null,
             message: {
               role: 'user',
@@ -468,6 +539,13 @@ class WorkerService {
   private handleAgentMessage(session: ActiveSession, content: string, promptNumber: number): void {
     const correlationId = logger.correlationId(session.sessionDbId, session.observationCounter);
 
+    // Always log what we received for debugging
+    logger.info('PARSER', `Processing response (${content.length} chars)`, {
+      sessionId: session.sessionDbId,
+      promptNumber,
+      preview: content.substring(0, 200)
+    });
+
     // Parse observations
     const observations = parseObservations(content, correlationId);
 
@@ -481,26 +559,35 @@ class WorkerService {
 
     const db = new SessionStore();
     for (const obs of observations) {
-      if (session.sdkSessionId) {
-        db.storeObservation(session.sdkSessionId, session.project, obs, promptNumber);
-        logger.success('DB', 'Observation stored', {
-          correlationId,
-          type: obs.type,
-          title: obs.title
-        });
-      }
+      db.storeObservation(session.claudeSessionId, session.project, obs, promptNumber);
+      logger.success('DB', 'Observation stored', {
+        correlationId,
+        type: obs.type,
+        title: obs.title
+      });
     }
 
-    // Parse summary
+    // Parse summary and ALWAYS store it
+    logger.info('PARSER', 'Looking for summary tags...', { sessionId: session.sessionDbId });
     const summary = parseSummary(content, session.sessionDbId);
-    if (summary && session.sdkSessionId) {
-      logger.info('PARSER', 'Summary parsed', {
+    if (summary) {
+      logger.success('PARSER', 'Summary parsed successfully!', {
         sessionId: session.sessionDbId,
-        promptNumber
+        promptNumber,
+        hasRequest: !!summary.request,
+        hasInvestigated: !!summary.investigated,
+        hasLearned: !!summary.learned,
+        hasCompleted: !!summary.completed,
+        hasNextSteps: !!summary.next_steps
+      });
+      db.storeSummary(session.claudeSessionId, session.project, summary, promptNumber);
+      logger.success('DB', '📝 SUMMARY STORED IN DATABASE', { sessionId: session.sessionDbId, promptNumber });
+    } else {
+      logger.warn('PARSER', 'NO SUMMARY TAGS FOUND in response', {
+        sessionId: session.sessionDbId,
+        promptNumber,
+        contentSample: content.substring(0, 500)
       });
-
-      db.storeSummary(session.sdkSessionId, session.project, summary, promptNumber);
-      logger.success('DB', 'Summary stored', { sessionId: session.sessionDbId });
     }
 
     db.close();

tests/session-search.test.ts

@@ -0,0 +1,332 @@
+import { test, describe } from 'node:test';
+import assert from 'node:assert';
+import Database from 'better-sqlite3';
+import { SessionSearch } from '../src/services/sqlite/SessionSearch';
+import fs from 'fs';
+import path from 'path';
+
+const TEST_DB_DIR = '/tmp/claude-mem-test';
+const TEST_DB_PATH = path.join(TEST_DB_DIR, 'test.db');
+
+describe('SessionSearch FTS5 Injection Tests', () => {
+  let search: SessionSearch;
+  let db: Database.Database;
+
+  // Setup test database before each test
+  function setupTestDB() {
+    // Clean up any existing test database
+    if (fs.existsSync(TEST_DB_DIR)) {
+      fs.rmSync(TEST_DB_DIR, { recursive: true, force: true });
+    }
+    fs.mkdirSync(TEST_DB_DIR, { recursive: true });
+
+    // Create database with required schema
+    db = new Database(TEST_DB_PATH);
+    db.pragma('journal_mode = WAL');
+
+    // Create minimal schema needed for search tests
+    // Note: Using claude_session_id to match SessionSearch expectations
+    db.exec(`
+      CREATE TABLE sdk_sessions (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        claude_session_id TEXT UNIQUE NOT NULL,
+        project TEXT NOT NULL,
+        started_at_epoch INTEGER DEFAULT ((unixepoch() * 1000))
+      );
+
+      CREATE TABLE observations (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        claude_session_id TEXT NOT NULL,
+        prompt_number INTEGER DEFAULT 1,
+        type TEXT NOT NULL,
+        title TEXT,
+        subtitle TEXT,
+        narrative TEXT,
+        text TEXT,
+        facts TEXT,
+        concepts TEXT,
+        files_read TEXT,
+        files_modified TEXT,
+        project TEXT,
+        created_at_epoch INTEGER DEFAULT ((unixepoch() * 1000)),
+        FOREIGN KEY (claude_session_id) REFERENCES sdk_sessions(claude_session_id)
+      );
+
+      CREATE TABLE session_summaries (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        claude_session_id TEXT NOT NULL,
+        prompt_number INTEGER DEFAULT 1,
+        request TEXT,
+        investigated TEXT,
+        learned TEXT,
+        completed TEXT,
+        next_steps TEXT,
+        notes TEXT,
+        files_read TEXT,
+        files_edited TEXT,
+        project TEXT,
+        created_at_epoch INTEGER DEFAULT ((unixepoch() * 1000)),
+        FOREIGN KEY (claude_session_id) REFERENCES sdk_sessions(claude_session_id)
+      );
+
+      CREATE TABLE user_prompts (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        claude_session_id TEXT NOT NULL,
+        prompt_number INTEGER DEFAULT 1,
+        prompt_text TEXT NOT NULL,
+        created_at_epoch INTEGER DEFAULT ((unixepoch() * 1000)),
+        FOREIGN KEY (claude_session_id) REFERENCES sdk_sessions(claude_session_id)
+      );
+
+      -- Create FTS5 tables manually
+      CREATE VIRTUAL TABLE observations_fts USING fts5(
+        title,
+        subtitle,
+        narrative,
+        text,
+        facts,
+        concepts,
+        content='observations',
+        content_rowid='id'
+      );
+
+      CREATE VIRTUAL TABLE session_summaries_fts USING fts5(
+        request,
+        investigated,
+        learned,
+        completed,
+        next_steps,
+        notes,
+        content='session_summaries',
+        content_rowid='id'
+      );
+
+      CREATE VIRTUAL TABLE user_prompts_fts USING fts5(
+        prompt_text,
+        content='user_prompts',
+        content_rowid='id'
+      );
+
+      -- Create triggers for observations
+      CREATE TRIGGER observations_ai AFTER INSERT ON observations BEGIN
+        INSERT INTO observations_fts(rowid, title, subtitle, narrative, text, facts, concepts)
+        VALUES (new.id, new.title, new.subtitle, new.narrative, new.text, new.facts, new.concepts);
+      END;
+
+      CREATE TRIGGER observations_ad AFTER DELETE ON observations BEGIN
+        INSERT INTO observations_fts(observations_fts, rowid, title, subtitle, narrative, text, facts, concepts)
+        VALUES('delete', old.id, old.title, old.subtitle, old.narrative, old.text, old.facts, old.concepts);
+      END;
+
+      CREATE TRIGGER observations_au AFTER UPDATE ON observations BEGIN
+        INSERT INTO observations_fts(observations_fts, rowid, title, subtitle, narrative, text, facts, concepts)
+        VALUES('delete', old.id, old.title, old.subtitle, old.narrative, old.text, old.facts, old.concepts);
+        INSERT INTO observations_fts(rowid, title, subtitle, narrative, text, facts, concepts)
+        VALUES (new.id, new.title, new.subtitle, new.narrative, new.text, new.facts, new.concepts);
+      END;
+
+      -- Create triggers for session_summaries
+      CREATE TRIGGER session_summaries_ai AFTER INSERT ON session_summaries BEGIN
+        INSERT INTO session_summaries_fts(rowid, request, investigated, learned, completed, next_steps, notes)
+        VALUES (new.id, new.request, new.investigated, new.learned, new.completed, new.next_steps, new.notes);
+      END;
+
+      CREATE TRIGGER session_summaries_ad AFTER DELETE ON session_summaries BEGIN
+        INSERT INTO session_summaries_fts(session_summaries_fts, rowid, request, investigated, learned, completed, next_steps, notes)
+        VALUES('delete', old.id, old.request, old.investigated, old.learned, old.completed, old.next_steps, old.notes);
+      END;
+
+      CREATE TRIGGER session_summaries_au AFTER UPDATE ON session_summaries BEGIN
+        INSERT INTO session_summaries_fts(session_summaries_fts, rowid, request, investigated, learned, completed, next_steps, notes)
+        VALUES('delete', old.id, old.request, old.investigated, old.learned, old.completed, old.next_steps, old.notes);
+        INSERT INTO session_summaries_fts(rowid, request, investigated, learned, completed, next_steps, notes)
+        VALUES (new.id, new.request, new.investigated, new.learned, new.completed, new.next_steps, new.notes);
+      END;
+
+      -- Create triggers for user_prompts
+      CREATE TRIGGER user_prompts_ai AFTER INSERT ON user_prompts BEGIN
+        INSERT INTO user_prompts_fts(rowid, prompt_text)
+        VALUES (new.id, new.prompt_text);
+      END;
+
+      CREATE TRIGGER user_prompts_ad AFTER DELETE ON user_prompts BEGIN
+        INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+        VALUES('delete', old.id, old.prompt_text);
+      END;
+
+      CREATE TRIGGER user_prompts_au AFTER UPDATE ON user_prompts BEGIN
+        INSERT INTO user_prompts_fts(user_prompts_fts, rowid, prompt_text)
+        VALUES('delete', old.id, old.prompt_text);
+        INSERT INTO user_prompts_fts(rowid, prompt_text)
+        VALUES (new.id, new.prompt_text);
+      END;
+    `);
+
+    db.close();
+
+    // Create SessionSearch instance
+    return new SessionSearch(TEST_DB_PATH);
+  }
+
+  function teardownTestDB() {
+    if (search) {
+      search.close();
+      search = null;
+    }
+    if (fs.existsSync(TEST_DB_DIR)) {
+      fs.rmSync(TEST_DB_DIR, { recursive: true, force: true });
+    }
+  }
+
+  test('should escape double quotes in search queries', () => {
+    search = setupTestDB();
+    
+    // Insert test data
+    const db = new Database(TEST_DB_PATH);
+    db.exec(`
+      INSERT INTO sdk_sessions (claude_session_id, project) VALUES ('test-session-1', 'test-project');
+      INSERT INTO observations (claude_session_id, prompt_number, type, title, narrative, text, facts, concepts, files_read, files_modified, project)
+      VALUES ('test-session-1', 1, 'feature', 'Test observation', 'A test "quoted" narrative', 'Some text', '[]', '[]', '[]', '[]', 'test-project');
+    `);
+    db.close();
+
+    // Test query with double quotes - should not cause injection
+    const maliciousQuery = 'test" OR 1=1 --';
+    
+    // This should not throw an error and should search safely
+    const results = search.searchObservations(maliciousQuery);
+    
+    // With proper escaping, this should return 0 results (no match for the literal string)
+    // Without escaping, it could match everything due to OR 1=1
+    assert.strictEqual(Array.isArray(results), true, 'Should return an array');
+    
+    teardownTestDB();
+  });
+
+  test('should handle FTS5 special operators safely', () => {
+    search = setupTestDB();
+    
+    // Insert test data
+    const db = new Database(TEST_DB_PATH);
+    db.exec(`
+      INSERT INTO sdk_sessions (claude_session_id, project) VALUES ('test-session-2', 'test-project');
+      INSERT INTO observations (claude_session_id, prompt_number, type, title, narrative, text, facts, concepts, files_read, files_modified, project)
+      VALUES ('test-session-2', 1, 'feature', 'Security feature', 'Implements security', 'Authentication system', '[]', '[]', '[]', '[]', 'test-project');
+    `);
+    db.close();
+
+    // Test queries with FTS5 operators that should be escaped
+    const testQueries = [
+      'AND OR NOT',           // Boolean operators
+      '(parentheses)',        // Grouping
+      'asterisk*',            // Wildcard
+      'column:value',         // Column filter attempt
+    ];
+
+    testQueries.forEach(query => {
+      // Should not throw an error
+      const results = search.searchObservations(query);
+      assert.strictEqual(Array.isArray(results), true, `Should return array for query: ${query}`);
+    });
+    
+    teardownTestDB();
+  });
+
+  test('should find exact phrase matches when properly escaped', () => {
+    search = setupTestDB();
+    
+    // Insert test data
+    const db = new Database(TEST_DB_PATH);
+    db.exec(`
+      INSERT INTO sdk_sessions (claude_session_id, project) VALUES ('test-session-3', 'test-project');
+      INSERT INTO observations (claude_session_id, prompt_number, type, title, narrative, text, facts, concepts, files_read, files_modified, project)
+      VALUES ('test-session-3', 1, 'feature', 'Hello world', 'This is a hello world example', 'Hello world program', '[]', '[]', '[]', '[]', 'test-project');
+      INSERT INTO observations (claude_session_id, prompt_number, type, title, narrative, text, facts, concepts, files_read, files_modified, project)
+      VALUES ('test-session-3', 2, 'feature', 'Goodbye moon', 'This is something else', 'Different content', '[]', '[]', '[]', '[]', 'test-project');
+    `);
+    db.close();
+
+    // Search for exact phrase
+    const results = search.searchObservations('hello world');
+    
+    assert.strictEqual(Array.isArray(results), true, 'Should return an array');
+    assert.ok(results.length > 0, 'Should find at least one result');
+    assert.ok(
+      results.some(r => r.title?.toLowerCase().includes('hello') || r.narrative?.toLowerCase().includes('hello')),
+      'Should find observation with "hello"'
+    );
+    
+    teardownTestDB();
+  });
+
+  test('should handle empty and special character queries safely', () => {
+    search = setupTestDB();
+    
+    // Insert test data
+    const db = new Database(TEST_DB_PATH);
+    db.exec(`
+      INSERT INTO sdk_sessions (claude_session_id, project) VALUES ('test-session-4', 'test-project');
+      INSERT INTO observations (claude_session_id, prompt_number, type, title, narrative, text, facts, concepts, files_read, files_modified, project)
+      VALUES ('test-session-4', 1, 'feature', 'Test', 'Test observation', 'Test content', '[]', '[]', '[]', '[]', 'test-project');
+    `);
+    db.close();
+
+    // Test edge cases
+    const edgeCases = [
+      '""',                   // Empty quoted string
+      '   ',                  // Whitespace only
+      '!!!',                  // Special characters
+      '@#$%',                 // More special characters
+    ];
+
+    edgeCases.forEach(query => {
+      // Should not throw an error
+      const results = search.searchObservations(query);
+      assert.strictEqual(Array.isArray(results), true, `Should return array for edge case: "${query}"`);
+    });
+    
+    teardownTestDB();
+  });
+
+  test('should search session summaries safely', () => {
+    search = setupTestDB();
+    
+    // Insert test data
+    const db = new Database(TEST_DB_PATH);
+    db.exec(`
+      INSERT INTO sdk_sessions (claude_session_id, project) VALUES ('test-session-5', 'test-project');
+      INSERT INTO session_summaries (claude_session_id, prompt_number, request, investigated, learned, completed, next_steps, notes, files_read, files_edited, project)
+      VALUES ('test-session-5', 1, 'Implement feature', 'Looked into options', 'Learned new approach', 'Completed task', 'Next: testing', 'Notes here', '[]', '[]', 'test-project');
+    `);
+    db.close();
+
+    // Test with potential injection
+    const maliciousQuery = 'feature" OR type:*';
+    const results = search.searchSessions(maliciousQuery);
+    
+    assert.strictEqual(Array.isArray(results), true, 'Should return an array');
+    
+    teardownTestDB();
+  });
+
+  test('should search user prompts safely', () => {
+    search = setupTestDB();
+    
+    // Insert test data
+    const db = new Database(TEST_DB_PATH);
+    db.exec(`
+      INSERT INTO sdk_sessions (claude_session_id, project) VALUES ('test-session-6', 'test-project');
+      INSERT INTO user_prompts (claude_session_id, prompt_number, prompt_text)
+      VALUES ('test-session-6', 1, 'Please implement authentication');
+    `);
+    db.close();
+
+    // Test with potential injection
+    const maliciousQuery = 'authentication" AND request:*';
+    const results = search.searchUserPrompts(maliciousQuery);
+    
+    assert.strictEqual(Array.isArray(results), true, 'Should return an array');
+    
+    teardownTestDB();
+  });
+});