claude-session-continuity-mcp 1.3.0 → 1.4.1

package/README.md

@@ -1,4 +1,4 @@
-# claude-session-continuity-mcp (v5)
+# claude-session-continuity-mcp (v1.4.0)
 
 > **Zero Re-explanation Session Continuity for Claude Code** — Automatic context capture + semantic search
 
@@ -20,9 +20,9 @@ Every new Claude Code session:
 
 **5 minutes of context-setting. Every. Single. Time.**
 
-## The Solution (v5)
+## The Solution
 
-v5 is **fully automatic**. Claude Hooks handle everything without manual calls:
+**Fully automatic.** Claude Hooks handle everything without manual calls:
 
 ```bash
 # Session start → Auto-loads relevant context (Git-based semantic search)
@@ -54,47 +54,65 @@ v5 is **fully automatic**. Claude Hooks handle everything without manual calls:
 
 ## Quick Start
 
-### 1. MCP Server Installation
+### One Command Installation
 
 ```bash
 npm install claude-session-continuity-mcp
 ```
 
-Add to `~/.claude.json` or `.mcp.json`:
+**That's it!** The postinstall script automatically:
+1. Registers MCP server in `~/.claude.json`
+2. Installs Claude Hooks in `~/.claude/settings.local.json`
 
+### What Gets Installed
+
+**MCP Server** (in `~/.claude.json`):
 ```json
 {
   "mcpServers": {
-    "session-continuity": {
+    "project-manager": {
       "command": "npx",
-      "args": ["claude-session-continuity-mcp"],
-      "env": {
-        "WORKSPACE_ROOT": "/path/to/your/workspace"
-      }
+      "args": ["claude-session-continuity-mcp"]
     }
   }
 }
 ```
 
-### 2. Claude Hooks Installation (v5 Auto-Capture)
+**Claude Hooks** (in `~/.claude/settings.local.json`):
+```json
+{
+  "hooks": {
+    "SessionStart": [{ "hooks": [{ "type": "command", "command": "npx claude-hook-session-start" }] }],
+    "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "npx claude-hook-user-prompt" }] }]
+  }
+}
+```
+
+**Note (v1.4.0+):** Hooks use `npx` commands instead of absolute paths, so they work correctly regardless of which project installed the package.
+
+### Installed Hooks
+
+| Hook | Command | Function |
+|------|---------|----------|
+| `SessionStart` | `npx claude-hook-session-start` | Auto-loads project context on session start |
+| `UserPromptSubmit` | `npx claude-hook-user-prompt` | Auto-injects relevant memories per prompt |
+
+### Manual Hook Management
 
 ```bash
-cd tools/project-manager-mcp/claude-hooks
-python install_hooks.py
-```
+# Check hook status
+npx claude-session-hooks status
 
-This registers automatic context hooks in `~/.claude/settings.local.json`.
+# Reinstall hooks
+npx claude-session-hooks install
 
-**Installed Hooks:**
+# Remove hooks
+npx claude-session-hooks uninstall
+```
 
-| Hook | File | Function |
-|------|------|----------|
-| `SessionStart` | `session_start.py` | Auto-loads relevant context via semantic search on session start |
-| `PrePromptSubmit` | `pre_prompt_submit.py` | Auto-injects memories/solutions related to your query |
-| `PostPromptSubmit` | `post_prompt_submit.py` | Auto-captures important info (decision, error, learning, etc.) |
-| `SessionEnd` | `session_end.py` | Auto-saves sessions/memories based on Git commits |
+### 3. Restart Claude Code
 
-### 3. That's it. Fully automatic.
+After installation, restart Claude Code to activate the hooks.
 
 ---
 
@@ -115,85 +133,70 @@ This registers automatic context hooks in `~/.claude/settings.local.json`.
 
 ---
 
-## Claude Hooks (v5) - Auto-Capture System
+## Claude Hooks - Auto Context System
 
-### Directory Structure
+### How It Works
 
-```
-claude-hooks/
-├── session_start.py      # Session start - Semantic context load
-├── pre_prompt_submit.py  # Pre-prompt - Query-based memory injection
-├── post_prompt_submit.py # Post-prompt - Auto memory capture
-├── session_end.py        # Session end - Git-based save
-└── install_hooks.py      # Install script
-```
-
-### session_start.py - Semantic Context Load
-
-Auto-loads relevant memories via **4-phase multi-stage search** on session start:
-
-```
-Phase 0: Semantic search (embedding similarity based on Git keywords)
-Phase 1: Git commit keyword FTS search
-Phase 2: Recent 7-day memories
-Phase 3: Important tags (decision, error)
-Phase 4: Fallback (general context)
-```
-
-### pre_prompt_submit.py - Query-Based Injection
-
-Auto-injects **only memories/solutions related** to user's query:
-
-```python
-# Example: When asking "How to fix OAuth error"
-→ Search OAuth-related memories (FTS + keyword)
-→ Search error-type solutions
-→ Auto-add to context
-```
+**SessionStart Hook** (`npx claude-hook-session-start`):
+- Detects current project from `apps/` directory or `package.json`
+- Loads context from `~/.claude/sessions.db`
+- Injects: Tech stack, current state, pending tasks, recent memories
 
-### post_prompt_submit.py - Auto Memory Capture
+**UserPromptSubmit Hook** (`npx claude-hook-user-prompt`):
+- Runs on every prompt submission
+- Injects relevant context based on current project
 
-Auto-detects and saves **6 types** from conversation content:
+### Example Output (Session Start)
 
-| Type | Detection Patterns (Multilingual) | Example |
-|------|-----------------------------------|---------|
-| `decision` | "decided", "chose", "결정", "選択" | Architecture decisions |
-| `error` | "fixed", "solved", "에러", "解決" | Bug fixes |
-| `learning` | "learned", "discovered", "배웠", "学んだ" | New knowledge |
-| `implementation` | "implemented", "completed", "구현", "実装" | Feature implementation |
-| `important` | "critical", "must", "중요", "重要" | Important notes |
-| `code` | Code blocks (100+ chars) | Code snippets |
+```markdown
+# 🚀 my-app - Session Resumed
 
-**User Overrides:**
-- `#remember` / `#기억` / `#覚える` - Force save
-- `#skip` / `#무시` / `#スキップ` - Don't save
+## Tech Stack
+**framework**: Next.js, **language**: TypeScript
 
-### session_end.py - Git-Based Save
+## Current State
+📍 Implementing signup form
+🚧 **Blocker**: OAuth callback URL issue
 
-Saves sessions/memories **only when commits exist** (noise prevention):
+## 📋 Pending Tasks
+- 🔄 [P8] Implement form validation
+- ⏳ [P5] Add error handling
 
-```
-1. New commit detected → Save session + memory
-2. Only uncommitted changes → Update active_context only
-3. Track commit hash → Prevent duplicate saves
+## 🧠 Key Memories
+- 🎯 [decision] Decided on App Router, using Server Actions
+- ⚠️ [error] OAuth redirect_uri mismatch → check env file
 ```
 
-### Install/Remove
+### Hook Management
 
 ```bash
-# Install
-cd claude-hooks && python install_hooks.py
+# Check status
+npx claude-session-hooks status
 
-# Remove
-python install_hooks.py --remove
+# Reinstall
+npx claude-session-hooks install
 
-# Check status
-python install_hooks.py --status
+# Remove
+npx claude-session-hooks uninstall
 
 # Temporarily disable
 export MCP_HOOKS_DISABLED=true
 ```
 
+### Why npx? (v1.4.0+)
+
+Previous versions used absolute paths like:
+```json
+"command": "node \"/path/to/project-a/node_modules/.../session-start.js\""
+```
+
+This broke when installing in multiple projects. Now we use:
+```json
+"command": "npx claude-hook-session-start"
+```
+
+**npx automatically finds the correct package**, regardless of which project installed it.
+
 ---
 
 ## Tools (v5 API) - 24 Focused Tools

package/dist/hooks/install.js

@@ -105,43 +105,38 @@ function install() {
     console.log('║   Claude Session Continuity MCP - Installation             ║');
     console.log('╚════════════════════════════════════════════════════════════╝');
     console.log('');
-    const packagePath = getPackagePath();
-    const hooksDir = path.join(packagePath, 'hooks');
-    // Hook 스크립트 경로
-    const sessionStartHook = path.join(hooksDir, 'session-start.js');
-    const userPromptHook = path.join(hooksDir, 'user-prompt-submit.js');
-    // ===== 1. Hooks 설치 =====
-    console.log('📌 Step 1: Installing Hooks...');
+    // ===== 1. Hooks 설치 (npx 방식 - 경로 독립적) =====
+    console.log('📌 Step 1: Installing Hooks (npx mode)...');
     const settings = loadSettings();
     // 기존 hooks 유지하면서 추가
     const hooks = settings.hooks || {};
-    // SessionStart Hook
+    // SessionStart Hook - npx로 실행 (어느 프로젝트에서든 동작)
     hooks.SessionStart = [
         {
             hooks: [
                 {
                     type: 'command',
-                    command: `node "${sessionStartHook}"`
+                    command: 'npx claude-hook-session-start'
                 }
             ]
         }
     ];
-    // UserPromptSubmit Hook
+    // UserPromptSubmit Hook - npx로 실행
     hooks.UserPromptSubmit = [
         {
             hooks: [
                 {
                     type: 'command',
-                    command: `node "${userPromptHook}"`
+                    command: 'npx claude-hook-user-prompt'
                 }
             ]
         }
     ];
     settings.hooks = hooks;
     saveSettings(settings);
-    console.log('✅ Hooks installed');
-    console.log(`   SessionStart: ${sessionStartHook}`);
-    console.log(`   UserPromptSubmit: ${userPromptHook}`);
+    console.log('✅ Hooks installed (npx mode - works in any project!)');
+    console.log('   SessionStart: npx claude-hook-session-start');
+    console.log('   UserPromptSubmit: npx claude-hook-user-prompt');
     console.log('');
     // ===== 2. MCP 서버 등록 =====
     console.log('📌 Step 2: Registering MCP Server...');

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "claude-session-continuity-mcp",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Session Continuity for Claude Code - Never re-explain your project again",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "claude-session-continuity-mcp": "./dist/index.js",
-    "claude-session-hooks": "./dist/hooks/install.js"
+    "claude-session-continuity-mcp": "dist/index.js",
+    "claude-session-hooks": "dist/hooks/install.js",
+    "claude-hook-session-start": "dist/hooks/session-start.js",
+    "claude-hook-user-prompt": "dist/hooks/user-prompt-submit.js"
   },
   "scripts": {
     "build": "tsc",