ccjk 3.6.1 → 3.7.2

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "ccjk",
   "type": "module",
-  "version": "3.6.1",
+  "version": "3.7.2",
+  "packageManager": "pnpm@10.17.1",
   "description": "Ultimate AI Development Tool - Code Tool Abstraction Layer with 83% Token Savings",
   "author": {
     "name": "CCJK Team",
@@ -73,62 +74,12 @@
   "engines": {
     "node": ">=20"
   },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.52.0",
-    "@iarna/toml": "^2.2.5",
-    "@types/semver": "^7.7.1",
-    "@types/tar": "^6.1.13",
-    "ansis": "^4.1.0",
-    "cac": "^6.7.14",
-    "chalk": "^5.6.2",
-    "chokidar": "^4.0.3",
-    "commander": "^14.0.2",
-    "dayjs": "^1.11.18",
-    "find-up-simple": "^1.0.1",
-    "fs-extra": "^11.3.2",
-    "gray-matter": "^4.0.3",
-    "i18next": "^25.5.2",
-    "i18next-fs-backend": "^2.6.0",
-    "inquirer": "^12.9.6",
-    "inquirer-toggle": "^1.0.1",
-    "nanoid": "^5.1.6",
-    "ora": "^9.0.0",
-    "pathe": "^2.0.3",
-    "semver": "^7.7.2",
-    "smol-toml": "^1.4.2",
-    "tar": "^7.5.2",
-    "tinyexec": "^1.0.1",
-    "trash": "^10.0.0",
-    "zod": "^3.22.0"
-  },
-  "devDependencies": {
-    "@antfu/eslint-config": "^5.4.1",
-    "@types/fs-extra": "^11.0.4",
-    "@types/inquirer": "^9.0.9",
-    "@types/jest": "^29.5.0",
-    "@types/node": "^22.18.6",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "@vitest/coverage-v8": "^3.2.4",
-    "@vitest/ui": "^3.2.4",
-    "eslint": "^9.36.0",
-    "eslint-plugin-format": "^1.0.2",
-    "glob": "^11.0.3",
-    "husky": "^9.1.7",
-    "jest": "^29.5.0",
-    "lint-staged": "^16.2.0",
-    "prettier": "^3.0.0",
-    "ts-jest": "^29.1.0",
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.2",
-    "unbuild": "^3.6.1",
-    "vitest": "^3.2.4"
-  },
   "scripts": {
     "dev": "tsx ./src/cli.ts",
     "build": "unbuild",
     "start": "node bin/ccjk.mjs",
     "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "test": "vitest",
@@ -136,6 +87,64 @@
     "test:coverage": "vitest run --coverage",
     "test:run": "vitest run",
     "test:watch": "vitest watch",
+    "prepare": "husky",
     "format": "prettier --write src/**/*.ts"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "catalog:",
+    "@iarna/toml": "catalog:",
+    "@types/semver": "catalog:",
+    "@types/tar": "catalog:",
+    "ansis": "catalog:",
+    "cac": "catalog:",
+    "chalk": "catalog:",
+    "chokidar": "catalog:",
+    "commander": "catalog:",
+    "dayjs": "catalog:",
+    "find-up-simple": "catalog:",
+    "fs-extra": "catalog:",
+    "gray-matter": "catalog:",
+    "i18next": "catalog:",
+    "i18next-fs-backend": "catalog:",
+    "imap": "catalog:",
+    "inquirer": "catalog:",
+    "inquirer-toggle": "catalog:",
+    "mailparser": "catalog:",
+    "nanoid": "catalog:",
+    "nodemailer": "catalog:",
+    "ora": "catalog:",
+    "pathe": "catalog:",
+    "semver": "catalog:",
+    "smol-toml": "catalog:",
+    "tar": "catalog:",
+    "tinyexec": "catalog:",
+    "trash": "catalog:",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "catalog:",
+    "@types/fs-extra": "catalog:",
+    "@types/imap": "catalog:",
+    "@types/inquirer": "catalog:",
+    "@types/jest": "catalog:",
+    "@types/mailparser": "catalog:",
+    "@types/node": "catalog:conflicts_@types/node_h20_11_5",
+    "@types/nodemailer": "catalog:",
+    "@typescript-eslint/eslint-plugin": "catalog:",
+    "@typescript-eslint/parser": "catalog:",
+    "@vitest/coverage-v8": "catalog:",
+    "@vitest/ui": "catalog:",
+    "eslint": "catalog:",
+    "eslint-plugin-format": "catalog:",
+    "glob": "catalog:",
+    "husky": "catalog:",
+    "jest": "catalog:",
+    "lint-staged": "catalog:",
+    "prettier": "catalog:",
+    "ts-jest": "catalog:",
+    "tsx": "catalog:conflicts_tsx_h4_7_2",
+    "typescript": "catalog:conflicts_typescript_h5_3_3",
+    "unbuild": "catalog:",
+    "vitest": "catalog:"
   }
-}
+}

package/templates/common/error-prevention.md

@@ -0,0 +1,267 @@
+# CCJK Error Prevention System
+
+**IMPORTANT**: This project uses the CCJK Error Prevention System to automatically prevent and fix common Claude Code CLI errors.
+
+---
+
+## 🛡️ Automatic Error Prevention
+
+All file operations and commands are automatically protected by CCJK's intelligent error prevention system.
+
+### What It Does
+
+The Error Prevention System operates in 5 layers:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│              CCJK Error Prevention System                        │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  Layer 1: Pre-Execution Validation                               │
+│    ├─ Parameter format validation                                │
+│    ├─ Path validity checks                                       │
+│    ├─ Permission verification                                    │
+│    └─ Command existence validation                               │
+│                                                                  │
+│  Layer 2: Intelligent Wrappers                                   │
+│    ├─ Smart Write: Handles existing files automatically          │
+│    ├─ Smart Bash: Validates and retries commands                 │
+│    ├─ Smart Path: Resolves cross-platform paths                  │
+│    └─ Smart Edit: Detects content changes before editing         │
+│                                                                  │
+│  Layer 3: Auto-Recovery                                          │
+│    ├─ Retry with exponential backoff                             │
+│    ├─ Automatic error correction                                 │
+│    ├─ Rollback support                                           │
+│    └─ Fallback mechanisms                                        │
+│                                                                  │
+│  Layer 4: Real-time Monitoring                                   │
+│    ├─ Error detection and classification                         │
+│    ├─ Pattern analysis                                           │
+│    └─ Alert system                                               │
+│                                                                  │
+│  Layer 5: Learning System                                        │
+│    ├─ Error history tracking                                     │
+│    └─ Solution database                                          │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📋 Errors That Are Automatically Prevented
+
+### 1. Error Writing File
+
+**Causes**: File already exists, permission denied, path errors
+
+**CCJK Auto-Fix**:
+- ✅ Checks if file exists before writing
+- ✅ Automatically backs up existing files
+- ✅ Uses Edit instead of Write when file exists
+- ✅ Creates missing directories automatically
+- ✅ Retries on transient failures
+
+### 2. Invalid Tool Parameters
+
+**Causes**: Wrong parameter format, missing required parameters, type mismatch
+
+**CCJK Auto-Fix**:
+- ✅ Validates parameter format before execution
+- ✅ Checks for unclosed quotes
+- ✅ Validates file paths
+- ✅ Provides specific error messages
+
+### 3. Bash Command Failures (Exit Code 1)
+
+**Causes**: Command not found, syntax errors, missing environment variables
+
+**CCJK Auto-Fix**:
+- ✅ Validates command exists before execution
+- ✅ Checks parameter format
+- ✅ Sets up environment automatically
+- ✅ Retries on failures with exponential backoff
+- ✅ Suggests alternative commands
+
+### 4. Path Resolution Issues
+
+**Causes**: Relative path errors, symlinks, cross-platform differences
+
+**CCJK Auto-Fix**:
+- ✅ Handles ~ (home directory)
+- ✅ Expands environment variables
+- ✅ Resolves symlinks
+- ✅ Cross-platform path normalization
+- ✅ Provides path fix suggestions
+
+### 5. Permission Denied Errors
+
+**Causes**: File permissions, directory permissions, read-only filesystem
+
+**CCJK Auto-Fix**:
+- ✅ Checks permissions before operations
+- ✅ Attempts to fix script permissions (chmod +x)
+- ✅ Provides specific permission error messages
+- ✅ Suggests appropriate fixes
+
+---
+
+## 🚀 Best Practices
+
+### When Writing Files
+
+**❌ Don't worry about**:
+- File already existing → CCJK handles it
+- Creating directories → CCJK does it automatically
+- Backing up files → CCJK backs up automatically
+- Content validation → CCJK checks before writing
+
+**✅ Just write**:
+- CCJK will detect if file exists
+- CCJK will use Edit tool if appropriate
+- CCJK will create directories if needed
+- CCJK will retry if write fails
+
+### When Running Commands
+
+**❌ Don't worry about**:
+- Command not existing → CCJK checks first
+- Parameter format → CCJK validates
+- Environment setup → CCJK sets up automatically
+- Command failing → CCJK retries with auto-fix
+
+**✅ Just run**:
+- CCJK will validate command exists
+- CCJK will check parameters
+- CCJK will handle dangerous command warnings
+- CCJK will retry on failures
+
+### When Reading Files
+
+**❌ Don't worry about**:
+- Path resolution → CCJK resolves paths
+- File not found → CCJK provides clear error
+- Permission issues → CCJK checks permissions
+
+**✅ Just read**:
+- CCJK will resolve relative paths
+- CCJK will handle symlinks
+- CCJK will provide helpful error messages
+
+---
+
+## 💡 Error Recovery Flow
+
+When an error occurs, CCJK follows this process:
+
+```
+1. Detect → Classify error type
+2. Analyze → Determine if retryable
+3. Auto-fix → Apply automatic correction if possible
+4. Retry → Retry with exponential backoff
+5. Fallback → Suggest alternative approach
+6. Report → Provide detailed error and suggestion
+```
+
+---
+
+## 🔧 Debugging
+
+### Enable Debug Logging
+
+```bash
+# Enable error prevention debug output
+export CCJK_ERROR_PREVENTION_DEBUG=1
+
+# Or enable all CCJK debug output
+export CCJK_DEBUG=1
+```
+
+### View Error Statistics
+
+```typescript
+import { getMiddleware } from 'ccjk/error-prevention'
+
+const middleware = getMiddleware()
+const errorStats = middleware.getErrorStats()
+const fixStats = middleware.getFixStats()
+
+console.log('Error Stats:', errorStats)
+console.log('Fix Stats:', fixStats)
+```
+
+---
+
+## 📊 Expected Impact
+
+| Error Type | Before CCJK | After CCJK | Reduction |
+|------------|-------------|------------|-----------|
+| Error writing file | ⭐⭐⭐⭐⭐ | ⭐ | **80%** |
+| Invalid tool parameters | ⭐⭐⭐⭐ | ⭐ | **75%** |
+| Bash command failures | ⭐⭐⭐⭐ | ⭐ | **70%** |
+| Path resolution issues | ⭐⭐⭐ | ⭐ | **85%** |
+| Permission denied | ⭐⭐⭐ | ⭐ | **90%** |
+
+---
+
+## 🎯 Tips
+
+1. **Trust CCJK's automatic handling** - Let the system prevent errors
+2. **Check console for CCJK messages** - Look for `[CCJK ErrorPrevention]` prefix
+3. **Review suggestions when errors occur** - CCJK provides specific fix suggestions
+4. **Report persistent errors** - Help improve the system
+
+---
+
+## 📖 API Reference
+
+```typescript
+import {
+  getMiddleware,
+  SmartWriteTool,
+  SmartBashTool,
+  SmartPathResolver,
+} from 'ccjk/error-prevention'
+
+// Use middleware (recommended)
+const middleware = getMiddleware()
+
+// Write files
+const writeResult = await middleware.interceptWrite(path, content)
+
+// Execute commands
+const bashResult = await middleware.interceptBash(command, options)
+
+// Read files
+const readResult = await middleware.interceptRead(path)
+
+// Edit files
+const editResult = await middleware.interceptEdit(path, oldString, newString)
+
+// Get path info
+const pathInfo = await middleware.getPathInfo(path)
+
+// Get statistics
+const errors = middleware.getErrorStats()
+const fixes = middleware.getFixStats()
+```
+
+---
+
+## 🎉 Summary
+
+**Before CCJK Error Prevention**:
+- ❌ Frequent errors
+- ❌ Manual debugging
+- ❌ Time wasted
+- ❌ Frustration
+
+**After CCJK Error Prevention**:
+- ✅ Automatic prevention
+- ✅ Intelligent fixes
+- ✅ Efficient development
+- ✅ Peace of mind
+
+---
+
+**Let CCJK handle the errors, focus on your code! 🚀**