sqlew 4.1.2 → 4.3.1

package/dist/cli/hooks/suggest.js

@@ -1,83 +1,20 @@
 /**
  * Suggest Hook Command
  *
- * PreToolUse hook for Task tool - suggests related decisions.
- * Extracts keywords from task description/prompt and finds related decisions.
+ * PreToolUse hook for Task tool - manages Plan agent sessions.
+ * Clears stale caches when a new Plan agent starts.
+ *
+ * NOTE: Template injection removed in v4.2.2 - didn't work reliably.
+ * Using Skills-based template injection instead.
  *
  * Usage:
- *   echo '{"tool_input": {"description": "implement auth"}}' | sqlew suggest
+ *   echo '{"tool_input": {"subagent_type": "Plan"}}' | sqlew suggest
  *
  * @since v4.1.0
+ * @modified v4.2.2 - Removed template injection, simplified to cache management
  */
-import { readStdinJson, sendContinue, getProjectPath } from './stdin-parser.js';
-import { initializeDatabase } from '../../database.js';
-import { suggestByContext } from '../../tools/suggest/actions/by-context.js';
-import { join } from 'path';
-// ============================================================================
-// Constants
-// ============================================================================
-/** Minimum keyword length to use for search */
-const MIN_KEYWORD_LENGTH = 3;
-/** Default limit for suggestions */
-const DEFAULT_LIMIT = 5;
-/** Minimum score for suggestions */
-const MIN_SCORE = 30;
-// ============================================================================
-// Keyword Extraction
-// ============================================================================
-/**
- * Extract meaningful keywords from text
- *
- * Removes common stop words and short words.
- *
- * @param text - Text to extract keywords from
- * @returns Array of keywords
- */
-function extractKeywords(text) {
-    // Common stop words to filter out
-    const stopWords = new Set([
-        'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
-        'of', 'with', 'by', 'from', 'as', 'is', 'was', 'are', 'were', 'been',
-        'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
-        'should', 'may', 'might', 'must', 'shall', 'can', 'need', 'this', 'that',
-        'these', 'those', 'i', 'you', 'he', 'she', 'it', 'we', 'they', 'what',
-        'which', 'who', 'when', 'where', 'why', 'how', 'all', 'each', 'every',
-        'both', 'few', 'more', 'most', 'other', 'some', 'such', 'no', 'not',
-        'only', 'same', 'so', 'than', 'too', 'very', 'just', 'also', 'now',
-        'use', 'using', 'implement', 'create', 'add', 'update', 'fix', 'make',
-        'get', 'set', 'new', 'file', 'code', 'function', 'method', 'class',
-    ]);
-    // Split on word boundaries and filter
-    const words = text
-        .toLowerCase()
-        .replace(/[^a-z0-9\s-_]/g, ' ')
-        .split(/\s+/)
-        .filter(word => word.length >= MIN_KEYWORD_LENGTH &&
-        !stopWords.has(word) &&
-        !/^\d+$/.test(word) // Filter out pure numbers
-    );
-    // Deduplicate while preserving order
-    return [...new Set(words)];
-}
-/**
- * Extract search context from hook input
- *
- * Combines description and prompt from Task tool input.
- *
- * @param input - Hook input
- * @returns Combined search text
- */
-function extractSearchContext(input) {
-    const parts = [];
-    // Task tool uses description and prompt
-    if (input.tool_input?.description) {
-        parts.push(input.tool_input.description);
-    }
-    if (input.tool_input?.prompt) {
-        parts.push(input.tool_input.prompt);
-    }
-    return parts.join(' ');
-}
+import { readStdinJson, sendContinue, isPlanAgent, getProjectPath } from './stdin-parser.js';
+import { clearPlanTomlCache, clearCurrentPlan } from '../../config/global-config.js';
 // ============================================================================
 // Main Entry Point
 // ============================================================================
@@ -85,67 +22,28 @@ function extractSearchContext(input) {
  * Main suggest command entry point
  *
  * Called as PreToolUse hook when Task tool is invoked.
- * Finds related decisions and injects them as context.
+ * For Plan agents: clears stale caches from previous sessions.
  */
 export async function suggestCommand() {
     try {
         const input = await readStdinJson();
-        // Only process Task tool
+        // Only process Task tool (PreToolUse hook)
         if (input.tool_name !== 'Task') {
             sendContinue();
             return;
         }
-        const projectPath = getProjectPath(input);
-        if (!projectPath) {
-            sendContinue();
-            return;
-        }
-        // Extract search context
-        const searchText = extractSearchContext(input);
-        if (!searchText.trim()) {
-            sendContinue();
-            return;
-        }
-        // Extract keywords for search
-        const keywords = extractKeywords(searchText);
-        if (keywords.length === 0) {
-            sendContinue();
-            return;
-        }
-        // Initialize database
-        const dbPath = join(projectPath, '.sqlew', 'sqlew.db');
-        try {
-            await initializeDatabase({ configPath: dbPath });
-        }
-        catch {
-            // Database not initialized - continue without suggestions
-            sendContinue();
-            return;
-        }
-        // Build search key from keywords
-        const searchKey = keywords.slice(0, 5).join(' ');
-        // Find related decisions
-        const result = await suggestByContext({
-            key: searchKey,
-            limit: DEFAULT_LIMIT,
-            min_score: MIN_SCORE,
-        });
-        if (result.suggestions.length === 0) {
-            sendContinue();
-            return;
-        }
-        // Format suggestions as context
-        const contextLines = [
-            '[sqlew] Related decisions found:',
-            '',
-        ];
-        for (const suggestion of result.suggestions) {
-            contextLines.push(`- **${suggestion.key}**: ${suggestion.value}`);
-            if (suggestion.reason) {
-                contextLines.push(`  (${suggestion.reason})`);
+        // Check if this is a Plan agent - clear stale caches
+        if (isPlanAgent(input)) {
+            const projectPath = getProjectPath(input);
+            if (projectPath) {
+                // Clear stale caches from previous sessions (v4.2.0+)
+                // This prevents false positives in on-subagent-stop hook
+                clearCurrentPlan(projectPath);
+                clearPlanTomlCache(projectPath);
             }
         }
-        sendContinue(contextLines.join('\n'));
+        // Continue without modification
+        sendContinue();
     }
     catch (error) {
         // On error, log to stderr but continue execution

package/dist/cli/hooks/suggest.js.map

@@ -1 +1 @@
-{"version":3,"file":"suggest.js","sourceRoot":"","sources":["../../../src/cli/hooks/suggest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"suggest.js","sourceRoot":"","sources":["../../../src/cli/hooks/suggest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAErF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QAEpC,2CAA2C;QAC3C,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YAC/B,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,qDAAqD;QACrD,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,WAAW,EAAE,CAAC;gBAChB,sDAAsD;gBACtD,yDAAyD;gBACzD,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBAC9B,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,YAAY,EAAE,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iDAAiD;QACjD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QACnD,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/cli/hooks/track-plan.d.ts

@@ -1,15 +1,20 @@
 /**
  * Track Plan Hook Command
  *
- * PreToolUse hook for Write tool - tracks plan files.
+ * PreToolUse hook for Write tool - tracks plan files and injects templates.
  * When a .claude/plans/*.md file is being written:
  * 1. Ensures plan has sqlew-plan-id in YAML frontmatter
  * 2. Saves current plan info to session cache
+ * 3. Injects Decision/Constraint template on new plan creation
+ *
+ * Decision/constraint extraction happens in on-exit-plan.ts using pattern matching.
  *
  * Usage:
  *   echo '{"tool_input": {"file_path": ".claude/plans/my-plan.md"}}' | sqlew track-plan
  *
  * @since v4.1.0
+ * @modified v4.2.2 - Removed LLM extraction, simplified to plan tracking only
+ * @modified v4.2.3 - Added template injection on new plan creation
  */
 import { type CurrentPlanInfo } from '../../config/global-config.js';
 /**
@@ -17,6 +22,8 @@ import { type CurrentPlanInfo } from '../../config/global-config.js';
  *
  * Called as PreToolUse hook when Write tool is invoked.
  * Only processes .claude/plans/*.md files.
+ *
+ * v4.2.2: Simplified to plan tracking only. Pattern extraction happens in on-exit-plan.
  */
 export declare function trackPlanCommand(): Promise<void>;
 /**

package/dist/cli/hooks/track-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"track-plan.d.ts","sourceRoot":"","sources":["../../../src/cli/hooks/track-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAoC,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAgBvG;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAyHtD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAGjF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE"}
+{"version":3,"file":"track-plan.d.ts","sourceRoot":"","sources":["../../../src/cli/hooks/track-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAiCvC;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAoFtD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE"}

package/dist/cli/hooks/track-plan.js

@@ -1,27 +1,49 @@
 /**
  * Track Plan Hook Command
  *
- * PreToolUse hook for Write tool - tracks plan files.
+ * PreToolUse hook for Write tool - tracks plan files and injects templates.
  * When a .claude/plans/*.md file is being written:
  * 1. Ensures plan has sqlew-plan-id in YAML frontmatter
  * 2. Saves current plan info to session cache
+ * 3. Injects Decision/Constraint template on new plan creation
+ *
+ * Decision/constraint extraction happens in on-exit-plan.ts using pattern matching.
  *
  * Usage:
  *   echo '{"tool_input": {"file_path": ".claude/plans/my-plan.md"}}' | sqlew track-plan
  *
  * @since v4.1.0
+ * @modified v4.2.2 - Removed LLM extraction, simplified to plan tracking only
+ * @modified v4.2.3 - Added template injection on new plan creation
  */
 import { readStdinJson, sendContinue, isPlanFile, getProjectPath } from './stdin-parser.js';
-import { ensurePlanId, extractPlanFileName, getPlanId, parseFrontmatter, generatePlanId } from './plan-id-utils.js';
-import { saveCurrentPlan, loadCurrentPlan } from '../../config/global-config.js';
-import { enqueueDecisionCreate } from '../../utils/hook-queue.js';
-import { existsSync } from 'fs';
+import { extractPlanFileName, parseFrontmatter, generatePlanId, getPlanId } from './plan-id-utils.js';
+import { saveCurrentPlan, loadCurrentPlan, clearPlanTomlCache, } from '../../config/global-config.js';
+import { existsSync, readFileSync } from 'fs';
 import { resolve } from 'path';
 // ============================================================================
-// Constants
+// Template Constants
 // ============================================================================
-/** Decision key prefix for plan-based decisions */
-const PLAN_DECISION_PREFIX = 'plan/implementation';
+/**
+ * Decision/Constraint template to inject on new plan creation
+ * Compact format for context window efficiency
+ */
+const PLAN_TEMPLATE = `
+---
+## 📝 Decision/Constraint Recording (auto-detected on ExitPlanMode)
+
+### 📌 Decision: [key/path]
+- **Value**: Description
+- **Layer**: presentation | business | data | infrastructure | cross-cutting
+- **Rationale**: Why this decision was made
+
+### 🚫 Constraint: [category]
+- **Rule**: Description (category: architecture | security | code-style | performance)
+- **Priority**: critical | high | medium | low
+- **Tags**: comma-separated tags
+
+---
+`.trim();
 // ============================================================================
 // Main Entry Point
 // ============================================================================
@@ -30,19 +52,24 @@ const PLAN_DECISION_PREFIX = 'plan/implementation';
  *
  * Called as PreToolUse hook when Write tool is invoked.
  * Only processes .claude/plans/*.md files.
+ *
+ * v4.2.2: Simplified to plan tracking only. Pattern extraction happens in on-exit-plan.
  */
 export async function trackPlanCommand() {
     try {
         const input = await readStdinJson();
-        // Only process plan files
+        // Handle EnterPlanMode - prepare for plan tracking
+        if (input.tool_name === 'EnterPlanMode') {
+            sendContinue('[sqlew] Plan mode entered. Waiting for plan file...');
+            return;
+        }
+        // Only process plan files for Write tool
         if (!isPlanFile(input)) {
-            // Not a plan file - continue without action
             sendContinue();
             return;
         }
         const projectPath = getProjectPath(input);
         if (!projectPath) {
-            // No project path - continue without action
             sendContinue();
             return;
         }
@@ -53,78 +80,50 @@ export async function trackPlanCommand() {
         }
         // Resolve absolute path
         const absolutePath = resolve(projectPath, filePath);
-        // Check if file exists (it might be a new file being created)
+        // Parse frontmatter for plan ID (from tool_input content if available)
+        let content;
         if (!existsSync(absolutePath)) {
-            // File doesn't exist yet - this is PreToolUse for new file creation
-            // Try to extract plan_id from the content being written (tool_input.content)
-            const content = input.tool_input?.content;
-            if (!content) {
-                // No content to parse - continue without action
-                sendContinue(`[sqlew] New plan file detected: ${extractPlanFileName(absolutePath)}. ` +
-                    `No content provided, skipping tracking.`);
-                return;
-            }
-            // Parse frontmatter from content being written
+            content = input.tool_input?.content;
+        }
+        else {
+            content = input.tool_input?.content || readFileSync(absolutePath, 'utf-8');
+        }
+        // Get or generate plan ID
+        let planId;
+        if (content) {
             const frontmatter = parseFrontmatter(content);
-            let planId = frontmatter.data['sqlew-plan-id'];
-            // Generate new plan ID if not present in content
-            if (!planId) {
-                planId = generatePlanId();
-            }
-            const planFileName = extractPlanFileName(absolutePath);
-            // Save current plan info to session cache
-            const planInfo = {
-                plan_id: planId,
-                plan_file: planFileName,
-                plan_updated_at: new Date().toISOString(),
-                recorded: false,
-                decision_pending: true,
-            };
-            saveCurrentPlan(projectPath, planInfo);
-            // Enqueue draft decision for later processing by MCP server
-            const decisionKey = `${PLAN_DECISION_PREFIX}/${planFileName.replace(/\.md$/, '')}`;
-            enqueueDecisionCreate(projectPath, {
-                key: decisionKey,
-                value: `Plan created: ${planFileName}`,
-                status: 'draft',
-                layer: 'cross-cutting',
-                tags: ['plan', 'draft', planId.slice(0, 8)],
-            });
-            // Continue with context about the tracked plan
-            sendContinue(`[sqlew] Tracking new plan: ${planFileName} (ID: ${planId.slice(0, 8)}...)`);
-            return;
+            planId = frontmatter.data['sqlew-plan-id'] || generatePlanId();
+        }
+        else {
+            planId = generatePlanId();
         }
-        // Ensure plan has an ID (creates one if missing)
-        const planId = ensurePlanId(absolutePath);
         const planFileName = extractPlanFileName(absolutePath);
         // Check if we already have cached info for this plan
         const existingPlan = loadCurrentPlan(projectPath);
         const isNewPlan = !existingPlan || existingPlan.plan_id !== planId;
-        // Save current plan info to session cache
+        // Clear old cache if switching plans
+        if (isNewPlan) {
+            clearPlanTomlCache(projectPath);
+        }
+        // Save current plan info to cache
+        // CRITICAL: Reset recorded flag on new plan to allow pattern extraction
         const planInfo = {
             plan_id: planId,
             plan_file: planFileName,
             plan_updated_at: new Date().toISOString(),
-            recorded: existingPlan?.recorded ?? false,
+            recorded: isNewPlan ? false : (existingPlan?.recorded ?? false),
             decision_pending: isNewPlan ? true : (existingPlan?.decision_pending ?? false),
         };
         saveCurrentPlan(projectPath, planInfo);
-        // Enqueue draft decision for new plans
+        // Build context message
+        let contextMsg = `[sqlew] Tracking plan: ${planFileName} (ID: ${planId.slice(0, 8)}...)`;
+        // Inject template on new plan creation
         if (isNewPlan) {
-            const decisionKey = `${PLAN_DECISION_PREFIX}/${planFileName.replace(/\.md$/, '')}`;
-            enqueueDecisionCreate(projectPath, {
-                key: decisionKey,
-                value: `Plan created: ${planFileName}`,
-                status: 'draft',
-                layer: 'cross-cutting',
-                tags: ['plan', 'draft', planId.slice(0, 8)],
-            });
+            contextMsg += `\n\n${PLAN_TEMPLATE}`;
         }
-        // Continue with context about the tracked plan
-        sendContinue(`[sqlew] Tracking plan: ${planFileName} (ID: ${planId.slice(0, 8)}...)`);
+        sendContinue(contextMsg);
     }
     catch (error) {
-        // On error, log to stderr but continue execution
         const message = error instanceof Error ? error.message : String(error);
         console.error(`[sqlew track-plan] Error: ${message}`);
         sendContinue();
@@ -137,7 +136,6 @@ export async function trackPlanCommand() {
  * @returns Current plan info or null
  */
 export function getCurrentTrackedPlan(projectPath) {
-    const { loadCurrentPlan } = require('../../config/global-config.js');
     return loadCurrentPlan(projectPath);
 }
 /**

package/dist/cli/hooks/track-plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"track-plan.js","sourceRoot":"","sources":["../../../src/cli/hooks/track-plan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"track-plan.js","sourceRoot":"","sources":["../../../src/cli/hooks/track-plan.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAuQH;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2F7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOrD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAqVH;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyH7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CASrD"}

package/dist/cli.js

@@ -16,6 +16,11 @@ import { saveCommand } from './cli/hooks/save.js';
 import { checkCompletionCommand } from './cli/hooks/check-completion.js';
 import { markDoneCommand } from './cli/hooks/mark-done.js';
 import { initHooksCommand } from './cli/hooks/init-hooks.js';
+import { initializeSkills, initializeRules, initializeGitignore } from './init-skills.js';
+import { onSubagentStopCommand } from './cli/hooks/on-subagent-stop.js';
+import { onStopCommand } from './cli/hooks/on-stop.js';
+import { onEnterPlanCommand } from './cli/hooks/on-enter-plan.js';
+import { onExitPlanCommand } from './cli/hooks/on-exit-plan.js';
 // ============================================================================
 // Helper Functions
 // ============================================================================
@@ -35,6 +40,9 @@ function parseArgs(args) {
             else if (key === 'help') {
                 parsed.help = true;
             }
+            else if (key === 'init') {
+                parsed.init = true;
+            }
             else if (value && !value.startsWith('--')) {
                 // Handle different key types
                 if (key === 'limit') {
@@ -106,8 +114,13 @@ sqlew CLI - Query and database migration tool for mcp-sqlew
 
 USAGE:
   sqlew <command> [options]
+  sqlew --init              # One-shot project setup (recommended)
 
 COMMANDS:
+  Setup:
+    --init           One-shot initialization (Skills + CLAUDE.md + Hooks + gitignore)
+    init --hooks     Initialize Claude Code and Git hooks only
+
   Database:
     db:dump    Generate SQL dump for database migration (schema + data)
     db:export  Export project data to JSON format (data-only, for append-import)
@@ -119,21 +132,27 @@ COMMANDS:
     save             Save decisions on code edit (PostToolUse hook for Edit|Write)
     check-completion Check task completion (PostToolUse hook for TodoWrite)
     mark-done        Mark decisions as implemented (Git hooks or manual)
-    init --hooks     Initialize Claude Code and Git hooks
+
+  Plan Mode Hooks (v4.2.0+):
+    on-enter-plan    Inject TOML template (PostToolUse hook for EnterPlanMode)
+    on-exit-plan     Prompt TOML documentation (PostToolUse hook for ExitPlanMode)
+    on-subagent-stop Process Plan agent completion (SubagentStop hook)
+    on-stop          Process main agent stop (Stop hook)
 
 OPTIONS:
+  --init                   Initialize all sqlew integrations
   --help                   Show this help message
 
 EXAMPLES:
-  # Initialize hooks for Claude Code integration
+  # Full project setup (Skills, CLAUDE.md, Hooks, gitignore)
+  sqlew --init
+
+  # Initialize only hooks
   sqlew init --hooks
 
   # Generate MySQL dump for database migration
   npm run db:dump -- mysql -o dump-mysql.sql
 
-  # Test hook commands manually
-  echo '{"tool_input": {"description": "auth"}}' | sqlew suggest
-
 For more information on commands, run:
   npm run db:dump -- --help
   npm run db:export -- --help
@@ -211,6 +230,61 @@ async function queryFiles(args) {
     }
 }
 // ============================================================================
+// Initialization Commands
+// ============================================================================
+/**
+ * Comprehensive project initialization
+ * Sets up Skills, CLAUDE.md integration, Hooks, and gitignore in one command
+ */
+async function initAllCommand() {
+    const { determineProjectRoot } = await import('./utils/project-root.js');
+    const projectPath = determineProjectRoot();
+    console.log('[sqlew --init] Starting comprehensive initialization...');
+    console.log(`[sqlew --init] Project root: ${projectPath}`);
+    console.log('');
+    // 1. Initialize Skills
+    console.log('[1/4] Initializing Skills...');
+    try {
+        initializeSkills(projectPath);
+        console.log('      ✓ Skills initialized');
+    }
+    catch (error) {
+        console.log(`      ✗ Skills failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // 2. Initialize .claude/rules/
+    console.log('[2/4] Setting up .claude/rules/...');
+    try {
+        initializeRules(projectPath);
+        console.log('      ✓ Plan mode integration rule installed');
+    }
+    catch (error) {
+        console.log(`      ✗ Rules setup failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // 3. Initialize Hooks
+    console.log('[3/4] Setting up Claude Code Hooks...');
+    try {
+        await initHooksCommand([]);
+    }
+    catch (error) {
+        console.log(`      ✗ Hooks failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // 4. Initialize gitignore
+    console.log('[4/4] Updating .gitignore...');
+    try {
+        initializeGitignore(projectPath);
+        console.log('      ✓ .gitignore updated');
+    }
+    catch (error) {
+        console.log(`      ✗ .gitignore failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    console.log('');
+    console.log('[sqlew --init] Initialization complete!');
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. Restart Claude Code for hooks to take effect');
+    console.log('  2. Run "/sqlew" to start using sqlew context management');
+}
+// ============================================================================
 // Main Entry Point
 // ============================================================================
 /**
@@ -256,7 +330,32 @@ export async function runCli(rawArgs) {
         await markDoneCommand(rawArgs.slice(1));
         return;
     }
-    // init --hooks command
+    // SubagentStop hook (v4.2.0+)
+    if (args.command === 'on-subagent-stop') {
+        await onSubagentStopCommand();
+        return;
+    }
+    // Stop hook (v4.2.0+)
+    if (args.command === 'on-stop') {
+        await onStopCommand();
+        return;
+    }
+    // EnterPlanMode hook (v4.2.0+)
+    if (args.command === 'on-enter-plan') {
+        await onEnterPlanCommand();
+        return;
+    }
+    // ExitPlanMode hook (v4.2.0+)
+    if (args.command === 'on-exit-plan') {
+        await onExitPlanCommand();
+        return;
+    }
+    // --init flag: comprehensive initialization (Skills + CLAUDE.md + Hooks + gitignore)
+    if (args.init) {
+        await initAllCommand();
+        return;
+    }
+    // init --hooks command (hooks only)
     if (args.command === 'init' && rawArgs.includes('--hooks')) {
         await initHooksCommand(rawArgs.slice(1));
         return;
@@ -308,6 +407,8 @@ export function isCliCommand(command) {
         'db:dump', 'db:export', 'db:import', 'query',
         // Claude Code Hooks commands (v4.1.0+)
         'suggest', 'track-plan', 'save', 'check-completion', 'mark-done', 'init',
+        // New hook events (v4.2.0+)
+        'on-subagent-stop', 'on-stop', 'on-enter-plan', 'on-exit-plan',
     ];
     return cliCommands.includes(command);
 }