claude-context-auto-handoff 1.0.0 → 1.0.2

package/.claude-plugin/marketplace.json

@@ -0,0 +1,28 @@
+{
+  "name": "context-handoff",
+  "description": "Claude Code plugin for automatic session context handoff across compactions and stops.",
+  "owner": {
+    "name": "Ethualo",
+    "email": "lkh0926ym@naver.com"
+  },
+  "plugins": [
+    {
+      "name": "claude-context-handoff",
+      "displayName": "Context Auto-Handoff",
+      "description": "Automatically saves session context and generates handoff manifests before Claude compacts or stops.",
+      "source": {
+        "source": "npm",
+        "package": "claude-context-auto-handoff"
+      },
+      "homepage": "https://github.com/Ethualo/claude-context-auto-handoff",
+      "repository": "https://github.com/Ethualo/claude-context-auto-handoff",
+      "license": "MIT",
+      "author": {
+        "name": "Ethualo",
+        "email": "lkh0926ym@naver.com"
+      },
+      "keywords": ["context", "handoff", "session", "memory", "compaction", "claude-code"],
+      "category": "productivity"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -6,9 +6,11 @@
     "name": "Ethualo",
     "email": "lkh0926ym@naver.com"
   },
-  "engines": {
-    "claude": "^1.0.0"
-  },
+  "homepage": "https://github.com/Ethualo/claude-context-auto-handoff",
+  "repository": "https://github.com/Ethualo/claude-context-auto-handoff",
+  "license": "MIT",
+  "keywords": ["context", "handoff", "session", "memory", "compaction", "claude-code"],
+  "category": "productivity",
   "mcpServers": {
     "context-handoff-manager": {
       "command": "node",

package/README.ko.md

@@ -6,7 +6,13 @@
 
 ![npm version](https://img.shields.io/npm/v/claude-context-auto-handoff)
 ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
-![Claude Code](https://img.shields.io/badge/Claude%20Code-%E2%89%A51.0.0-orange)
+
+---
+
+## 필수 요구사항
+
+- **Node.js 18+** — `node` 명령어가 `PATH`에 있어야 함
+- **Claude Code** 또는 **Codex** — 플러그인 및 훅 실행에 Claude Code CLI 또는 Codex CLI 필요
 
 ---
 

package/README.md

@@ -6,7 +6,13 @@ Claude Code plugin that automatically saves session context and generates token-
 
 ![npm version](https://img.shields.io/npm/v/claude-context-auto-handoff)
 ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
-![Claude Code](https://img.shields.io/badge/Claude%20Code-%E2%89%A51.0.0-orange)
+
+---
+
+## Requirements
+
+- **Node.js 18+** — must be on `PATH` as `node`
+- **Claude Code** or **Codex** — plugin and hooks require Claude Code CLI or Codex CLI
 
 ---
 

package/build/index.js

@@ -8,17 +8,16 @@ const server = new McpServer({
     name: 'context-handoff-manager',
     version: '1.0.0'
 });
-const CONTEXT_THRESHOLD = parseInt(process.env.CONTEXT_THRESHOLD ?? '70', 10);
 server.tool('generate_handoff_manifest', {
-    summary: z.string().optional().describe('Detailed session recap — omit if other fields cover it'),
-    nextSteps: z.array(z.string()).describe('Tasks to continue immediately in the next session'),
-    taskDescription: z.string().optional().describe('High-level goal + core intent (why this matters). Use telegraphese — drop articles/pronouns.'),
-    currentStatus: z.string().optional().describe('What is done vs what remains. State why, not just what.'),
-    keyDecisions: z.array(z.string()).optional().describe('Architecture choices and why — prevents post-compaction amnesia. Format: "Decision: X — Reason: Y"'),
-    failedApproaches: z.array(z.string()).optional().describe('Already-failed attempts. Format each: "Approach: X → Result: Y → Lesson: Z". Prevents repeating mistakes.'),
-    blockers: z.string().optional().describe('Unresolved errors or blockers'),
+    summary: z.string().optional().describe('Detailed session recap in English — omit if other fields cover it'),
+    nextSteps: z.array(z.string()).describe('Tasks to continue immediately in the next session. Write in English.'),
+    taskDescription: z.string().optional().describe('High-level goal + core intent (why this matters). Use telegraphese — drop articles/pronouns. Write in English.'),
+    currentStatus: z.string().optional().describe('What is done vs what remains. State why, not just what. Write in English.'),
+    keyDecisions: z.array(z.string()).optional().describe('Architecture choices and why — prevents post-compaction amnesia. Format: "Decision: X — Reason: Y". Write in English.'),
+    failedApproaches: z.array(z.string()).optional().describe('Already-failed attempts. Format each: "Approach: X → Result: Y → Lesson: Z". Prevents repeating mistakes. Write in English.'),
+    blockers: z.string().optional().describe('Unresolved errors or blockers. Write in English.'),
     modifiedFiles: z.array(z.string()).optional().describe('Changed files with delta notes. Format: "path/to/file: what changed" — NO code snippets, path+delta only.'),
-    implicitRules: z.array(z.string()).optional().describe('Tech stack, naming conventions, env vars, implicit project rules — anything not derivable from reading code')
+    implicitRules: z.array(z.string()).optional().describe('Tech stack, naming conventions, env vars, implicit project rules — anything not derivable from reading code. Write in English.')
 }, async ({ summary, nextSteps, taskDescription, currentStatus, keyDecisions, failedApproaches, blockers, modifiedFiles, implicitRules }) => {
     try {
         const claudeDir = path.join(process.cwd(), '.claude');
@@ -38,7 +37,7 @@ server.tool('generate_handoff_manifest', {
         return {
             content: [{
                     type: 'text',
-                    text: `Handoff saved.\nLatest: ${mainPath}\nArchive: ${archivePath}\n[Handoff Guard] threshold: ${CONTEXT_THRESHOLD}% | run /resume in next session`
+                    text: `Handoff saved.\nLatest: ${mainPath}\nArchive: ${archivePath}`
                 }]
         };
     }
@@ -90,7 +89,7 @@ function buildMarkdown(params) {
     if (summary) {
         sections.push(`## Summary\n${summary}\n`);
     }
-    sections.push(`---\n*Run \`/resume\` in the next session to restore this context.*`);
+    sections.push(`---\n*Context is auto-restored on session start. Manual restore: \`/resume\`*`);
     return sections.join('\n');
 }
 async function main() {

package/hooks/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "prompt",
-            "prompt": "CRITICAL: Context compaction imminent. Call 'generate_handoff_manifest' NOW before compaction. Fill all fields: summary (full session recap), taskDescription (goal), currentStatus (done vs remaining), keyDecisions (architecture choices + why), failedApproaches (already-failed — do NOT retry), nextSteps (next session tasks), blockers (unresolved errors). Do NOT allow compaction without calling this tool."
+            "prompt": "CRITICAL: Context compaction imminent. Call 'generate_handoff_manifest' NOW before compaction. Fill all fields: summary (full session recap), taskDescription (goal), currentStatus (done vs remaining), keyDecisions (architecture choices + why), failedApproaches (already-failed — do NOT retry), nextSteps (next session tasks), blockers (unresolved errors). Write ALL field values in English. Do NOT allow compaction without calling this tool."
           }
         ]
       }
@@ -15,7 +15,7 @@
         "hooks": [
           {
             "type": "prompt",
-            "prompt": "If a work unit just completed (feature done, tests passed, commit made), call 'generate_handoff_manifest'. Fill taskDescription, keyDecisions, and failedApproaches so the next session has full context."
+            "prompt": "If a work unit just completed (feature done, tests passed, commit made), call 'generate_handoff_manifest'. Fill taskDescription, keyDecisions, and failedApproaches so the next session has full context. Write ALL field values in English."
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-context-auto-handoff",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A Claude Code plugin to automate session handoffs before context compaction.",
   "type": "module",
   "main": "build/index.js",
@@ -33,4 +33,4 @@
     "@types/node": "^20.11.0",
     "typescript": "^5.3.3"
   }
-}
+}

package/scripts/setup.ps1

@@ -1,4 +1,4 @@
-# context-handoff-mcp-server — one-line setup for Windows (PowerShell)
+# context-handoff-mcp-server -- one-line setup for Windows (PowerShell)
 # Usage: irm https://raw.githubusercontent.com/Ethualo/context-handoff-mcp-server/main/scripts/setup.ps1 | iex
 
 $ErrorActionPreference = "Stop"
@@ -11,28 +11,25 @@ Write-Host "[Handoff Setup] Installing $PluginName..."
 # 1. npm global install (builds TypeScript)
 npm install -g claude-context-auto-handoff
 
-# 2. hooks.json 등록 (기존 파일이 있으면 경고만)
+# 2. Register hooks.json (warn if already exists)
 $NpmRoot = (npm root -g).Trim()
 $HooksSrc = Join-Path $NpmRoot "claude-context-auto-handoff\hooks\hooks.json"
 
 if (Test-Path $HooksTarget) {
-  Write-Host "[Handoff Setup] WARNING: $HooksTarget 이미 존재합니다."
-  Write-Host "  수동으로 $HooksSrc 내용을 병합하세요."
+  Write-Host "[Handoff Setup] WARNING: $HooksTarget already exists."
+  Write-Host "  Manually merge contents from: $HooksSrc"
 } else {
   $HooksDir = Split-Path $HooksTarget
   if (-not (Test-Path $HooksDir)) { New-Item -ItemType Directory -Force $HooksDir | Out-Null }
   Copy-Item $HooksSrc $HooksTarget
-  Write-Host "[Handoff Setup] hooks.json 등록 완료: $HooksTarget"
+  Write-Host "[Handoff Setup] hooks.json registered: $HooksTarget"
 }
 
 Write-Host ""
-Write-Host "[Handoff Setup] 완료!"
+Write-Host "[Handoff Setup] Done!"
 Write-Host ""
-Write-Host "  임계값 조정 (기본 70%):"
-Write-Host "    [System.Environment]::SetEnvironmentVariable('CONTEXT_THRESHOLD','65','User')"
+Write-Host "  Usage:"
+Write-Host "    /handoff  -- save current session"
+Write-Host "    /resume   -- restore previous session"
 Write-Host ""
-Write-Host "  사용법:"
-Write-Host "    /handoff  — 현재 세션 저장"
-Write-Host "    /resume   — 이전 세션 복원"
-Write-Host ""
-Write-Host "  SessionStart 훅이 세션 시작 시 자동으로 이전 컨텍스트를 복원합니다."
+Write-Host "  SessionStart hook auto-restores previous context on session open."

package/scripts/setup.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# context-handoff-mcp-server — one-line setup for Linux/macOS
+# context-handoff-mcp-server -- one-line setup for Linux/macOS
 # Usage: curl -fsSL https://raw.githubusercontent.com/Ethualo/context-handoff-mcp-server/main/scripts/setup.sh | bash
 
 set -e
@@ -12,26 +12,23 @@ echo "[Handoff Setup] Installing $PLUGIN_NAME..."
 # 1. npm global install (builds TypeScript)
 npm install -g claude-context-auto-handoff
 
-# 2. hooks.json 등록 (기존 파일이 있으면 경고만)
+# 2. Register hooks.json (warn if already exists)
 HOOKS_SRC="$(npm root -g)/claude-context-auto-handoff/hooks/hooks.json"
 
 if [ -f "$HOOKS_TARGET" ]; then
-  echo "[Handoff Setup] WARNING: $HOOKS_TARGET 이미 존재합니다."
-  echo "  수동으로 $HOOKS_SRC 내용을 병합하세요."
+  echo "[Handoff Setup] WARNING: $HOOKS_TARGET already exists."
+  echo "  Manually merge contents from: $HOOKS_SRC"
 else
   mkdir -p "$(dirname "$HOOKS_TARGET")"
   cp "$HOOKS_SRC" "$HOOKS_TARGET"
-  echo "[Handoff Setup] hooks.json 등록 완료: $HOOKS_TARGET"
+  echo "[Handoff Setup] hooks.json registered: $HOOKS_TARGET"
 fi
 
 echo ""
-echo "[Handoff Setup] 완료!"
+echo "[Handoff Setup] Done!"
 echo ""
-echo "  임계값 조정 (기본 70%):"
-echo "    export CONTEXT_THRESHOLD=65   # ~/.bashrc 또는 ~/.zshrc에 추가"
+echo "  Usage:"
+echo "    /handoff  -- save current session"
+echo "    /resume   -- restore previous session"
 echo ""
-echo "  사용법:"
-echo "    /handoff  — 현재 세션 저장"
-echo "    /resume   — 이전 세션 복원"
-echo ""
-echo "  SessionStart 훅이 세션 시작 시 자동으로 이전 컨텍스트를 복원합니다."
+echo "  SessionStart hook auto-restores previous context on session open."