sqlew 4.0.5 → 4.1.0

package/dist/cli/hooks/plan-id-utils.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Plan ID utilities for YAML frontmatter manipulation
+ *
+ * Handles reading and writing sqlew-plan-id in markdown files.
+ * Uses YAML frontmatter format (--- delimited section at top of file).
+ *
+ * @since v4.1.0
+ */
+/**
+ * Parsed frontmatter data
+ */
+export interface Frontmatter {
+    /** Raw frontmatter content (between --- delimiters) */
+    raw: string;
+    /** Parsed key-value pairs */
+    data: Record<string, string>;
+    /** Content after frontmatter */
+    content: string;
+    /** Whether the file had frontmatter */
+    hasFrontmatter: boolean;
+}
+/**
+ * Parse YAML frontmatter from markdown content
+ *
+ * @param content - Full file content
+ * @returns Parsed frontmatter and content
+ */
+export declare function parseFrontmatter(content: string): Frontmatter;
+/**
+ * Serialize frontmatter data back to string
+ *
+ * @param data - Key-value pairs to serialize
+ * @returns YAML frontmatter string (without delimiters)
+ */
+export declare function serializeFrontmatter(data: Record<string, string>): string;
+/**
+ * Build file content with frontmatter
+ *
+ * @param data - Frontmatter key-value pairs
+ * @param content - Main content after frontmatter
+ * @returns Complete file content
+ */
+export declare function buildFileWithFrontmatter(data: Record<string, string>, content: string): string;
+/**
+ * Get plan ID from a markdown file
+ *
+ * @param filePath - Path to markdown file
+ * @returns Plan ID or null if not found
+ */
+export declare function getPlanId(filePath: string): string | null;
+/**
+ * Set or add plan ID to a markdown file
+ *
+ * If the file has no frontmatter, adds one.
+ * If the file has frontmatter without plan ID, adds the ID.
+ * If the file already has a plan ID, does nothing.
+ *
+ * @param filePath - Path to markdown file
+ * @param planId - Plan ID to set (generates UUID if not provided)
+ * @returns The plan ID that was set or already existed
+ */
+export declare function ensurePlanId(filePath: string, planId?: string): string;
+/**
+ * Check if a file has a plan ID
+ *
+ * @param filePath - Path to markdown file
+ * @returns true if file has a plan ID
+ */
+export declare function hasPlanId(filePath: string): boolean;
+/**
+ * Generate a new plan ID (UUID v4)
+ *
+ * @returns New UUID
+ */
+export declare function generatePlanId(): string;
+/**
+ * Extract plan file name from a full path
+ *
+ * @param filePath - Full path to plan file
+ * @returns File name only (e.g., "rippling-spinning-eagle.md")
+ */
+export declare function extractPlanFileName(filePath: string): string;
+//# sourceMappingURL=plan-id-utils.d.ts.map

package/dist/cli/hooks/plan-id-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-id-utils.d.ts","sourceRoot":"","sources":["../../../src/cli/hooks/plan-id-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,cAAc,EAAE,OAAO,CAAC;CACzB;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAwD7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG9F;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BtE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI5D"}

package/dist/cli/hooks/plan-id-utils.js

@@ -0,0 +1,183 @@
+/**
+ * Plan ID utilities for YAML frontmatter manipulation
+ *
+ * Handles reading and writing sqlew-plan-id in markdown files.
+ * Uses YAML frontmatter format (--- delimited section at top of file).
+ *
+ * @since v4.1.0
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { randomUUID } from 'crypto';
+// ============================================================================
+// Constants
+// ============================================================================
+/** YAML frontmatter delimiter */
+const FRONTMATTER_DELIMITER = '---';
+/** Key for plan ID in frontmatter */
+const PLAN_ID_KEY = 'sqlew-plan-id';
+// ============================================================================
+// Parsing
+// ============================================================================
+/**
+ * Parse YAML frontmatter from markdown content
+ *
+ * @param content - Full file content
+ * @returns Parsed frontmatter and content
+ */
+export function parseFrontmatter(content) {
+    const lines = content.split('\n');
+    // Check if file starts with ---
+    if (lines[0]?.trim() !== FRONTMATTER_DELIMITER) {
+        return {
+            raw: '',
+            data: {},
+            content,
+            hasFrontmatter: false,
+        };
+    }
+    // Find closing ---
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i]?.trim() === FRONTMATTER_DELIMITER) {
+            endIndex = i;
+            break;
+        }
+    }
+    if (endIndex === -1) {
+        // No closing delimiter - treat as no frontmatter
+        return {
+            raw: '',
+            data: {},
+            content,
+            hasFrontmatter: false,
+        };
+    }
+    // Extract frontmatter content
+    const frontmatterLines = lines.slice(1, endIndex);
+    const raw = frontmatterLines.join('\n');
+    const data = {};
+    // Parse simple key: value pairs
+    for (const line of frontmatterLines) {
+        const match = line.match(/^([^:]+):\s*(.*)$/);
+        if (match) {
+            const key = match[1].trim();
+            const value = match[2].trim();
+            data[key] = value;
+        }
+    }
+    // Extract content after frontmatter
+    const restContent = lines.slice(endIndex + 1).join('\n');
+    return {
+        raw,
+        data,
+        content: restContent,
+        hasFrontmatter: true,
+    };
+}
+/**
+ * Serialize frontmatter data back to string
+ *
+ * @param data - Key-value pairs to serialize
+ * @returns YAML frontmatter string (without delimiters)
+ */
+export function serializeFrontmatter(data) {
+    return Object.entries(data)
+        .map(([key, value]) => `${key}: ${value}`)
+        .join('\n');
+}
+/**
+ * Build file content with frontmatter
+ *
+ * @param data - Frontmatter key-value pairs
+ * @param content - Main content after frontmatter
+ * @returns Complete file content
+ */
+export function buildFileWithFrontmatter(data, content) {
+    const frontmatter = serializeFrontmatter(data);
+    return `${FRONTMATTER_DELIMITER}\n${frontmatter}\n${FRONTMATTER_DELIMITER}\n${content}`;
+}
+// ============================================================================
+// Plan ID Operations
+// ============================================================================
+/**
+ * Get plan ID from a markdown file
+ *
+ * @param filePath - Path to markdown file
+ * @returns Plan ID or null if not found
+ */
+export function getPlanId(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const frontmatter = parseFrontmatter(content);
+        return frontmatter.data[PLAN_ID_KEY] || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Set or add plan ID to a markdown file
+ *
+ * If the file has no frontmatter, adds one.
+ * If the file has frontmatter without plan ID, adds the ID.
+ * If the file already has a plan ID, does nothing.
+ *
+ * @param filePath - Path to markdown file
+ * @param planId - Plan ID to set (generates UUID if not provided)
+ * @returns The plan ID that was set or already existed
+ */
+export function ensurePlanId(filePath, planId) {
+    if (!existsSync(filePath)) {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    const content = readFileSync(filePath, 'utf-8');
+    const frontmatter = parseFrontmatter(content);
+    // If already has plan ID, return it
+    if (frontmatter.data[PLAN_ID_KEY]) {
+        return frontmatter.data[PLAN_ID_KEY];
+    }
+    // Generate new ID if not provided
+    const newPlanId = planId || randomUUID();
+    // Add plan ID to frontmatter data
+    const newData = {
+        [PLAN_ID_KEY]: newPlanId,
+        ...frontmatter.data,
+    };
+    // Build new file content
+    const newContent = buildFileWithFrontmatter(newData, frontmatter.content);
+    // Write back to file
+    writeFileSync(filePath, newContent, 'utf-8');
+    return newPlanId;
+}
+/**
+ * Check if a file has a plan ID
+ *
+ * @param filePath - Path to markdown file
+ * @returns true if file has a plan ID
+ */
+export function hasPlanId(filePath) {
+    return getPlanId(filePath) !== null;
+}
+/**
+ * Generate a new plan ID (UUID v4)
+ *
+ * @returns New UUID
+ */
+export function generatePlanId() {
+    return randomUUID();
+}
+/**
+ * Extract plan file name from a full path
+ *
+ * @param filePath - Full path to plan file
+ * @returns File name only (e.g., "rippling-spinning-eagle.md")
+ */
+export function extractPlanFileName(filePath) {
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    const parts = normalizedPath.split('/');
+    return parts[parts.length - 1] || '';
+}
+//# sourceMappingURL=plan-id-utils.js.map

package/dist/cli/hooks/plan-id-utils.js.map

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

package/dist/cli/hooks/save.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Save Hook Command
+ *
+ * PostToolUse hook for ExitPlanMode - enqueues decision status update.
+ * When plan mode exits, enqueues update from draft to in_progress.
+ * Actual DB operations happen when MCP server processes the queue.
+ *
+ * Usage:
+ *   echo '{"tool_name": "ExitPlanMode"}' | sqlew save
+ *
+ * @since v4.1.0
+ * @updated v4.1.0 - Changed trigger from Edit|Write to ExitPlanMode only (zero delay on code edits)
+ * @updated v4.1.0 - File queue architecture (no DB operations in hooks)
+ */
+/**
+ * Main save command entry point
+ *
+ * Called as PostToolUse hook when ExitPlanMode completes.
+ * Enqueues decision status update if a plan is being tracked.
+ * No DB operations - fast execution (<100ms).
+ */
+export declare function saveCommand(): Promise<void>;
+//# sourceMappingURL=save.d.ts.map

package/dist/cli/hooks/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../src/cli/hooks/save.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoBH;;;;;;GAMG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA+DjD"}

package/dist/cli/hooks/save.js

@@ -0,0 +1,90 @@
+/**
+ * Save Hook Command
+ *
+ * PostToolUse hook for ExitPlanMode - enqueues decision status update.
+ * When plan mode exits, enqueues update from draft to in_progress.
+ * Actual DB operations happen when MCP server processes the queue.
+ *
+ * Usage:
+ *   echo '{"tool_name": "ExitPlanMode"}' | sqlew save
+ *
+ * @since v4.1.0
+ * @updated v4.1.0 - Changed trigger from Edit|Write to ExitPlanMode only (zero delay on code edits)
+ * @updated v4.1.0 - File queue architecture (no DB operations in hooks)
+ */
+import { readStdinJson, sendContinue, getProjectPath } from './stdin-parser.js';
+import { loadCurrentPlan, saveCurrentPlan } from '../../config/global-config.js';
+import { enqueueDecisionUpdate } from '../../utils/hook-queue.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Decision key prefix for plan-based decisions */
+const PLAN_DECISION_PREFIX = 'plan/implementation';
+/** Status for in-progress decisions */
+const IN_PROGRESS_STATUS = 'in_progress';
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+/**
+ * Main save command entry point
+ *
+ * Called as PostToolUse hook when ExitPlanMode completes.
+ * Enqueues decision status update if a plan is being tracked.
+ * No DB operations - fast execution (<100ms).
+ */
+export async function saveCommand() {
+    try {
+        const input = await readStdinJson();
+        // Only process ExitPlanMode tool
+        const toolName = input.tool_name;
+        if (toolName !== 'ExitPlanMode') {
+            sendContinue();
+            return;
+        }
+        const projectPath = getProjectPath(input);
+        if (!projectPath) {
+            sendContinue();
+            return;
+        }
+        // Check if there's a current plan being tracked
+        const planInfo = loadCurrentPlan(projectPath);
+        if (!planInfo) {
+            // No plan being tracked - continue without action
+            sendContinue();
+            return;
+        }
+        // Check if already recorded for this plan
+        if (planInfo.recorded) {
+            // Already recorded - no need to record again
+            sendContinue();
+            return;
+        }
+        // Build decision key from plan file name
+        const planName = planInfo.plan_file.replace(/\.md$/, '');
+        const decisionKey = `${PLAN_DECISION_PREFIX}/${planName}`;
+        // Enqueue status update (no DB operations here)
+        enqueueDecisionUpdate(projectPath, {
+            key: decisionKey,
+            value: `Implementation in progress for plan: ${planInfo.plan_file}`,
+            status: IN_PROGRESS_STATUS,
+            layer: 'cross-cutting',
+            tags: ['plan', 'implementation', 'active', planInfo.plan_id.slice(0, 8)],
+        });
+        // Mark plan as recorded
+        const updatedInfo = {
+            ...planInfo,
+            recorded: true,
+            decision_pending: false,
+            plan_updated_at: new Date().toISOString(),
+        };
+        saveCurrentPlan(projectPath, updatedInfo);
+        sendContinue(`[sqlew] Queued decision update for plan: ${planInfo.plan_file} (will process on MCP startup)`);
+    }
+    catch (error) {
+        // On error, log to stderr but continue execution
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[sqlew save] Error: ${message}`);
+        sendContinue();
+    }
+}
+//# sourceMappingURL=save.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../src/cli/hooks/save.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAwB,MAAM,+BAA+B,CAAC;AACvG,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,mDAAmD;AACnD,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEnD,uCAAuC;AACvC,MAAM,kBAAkB,GAAG,aAAsB,CAAC;AAElD,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QAEpC,iCAAiC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;QACjC,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAChC,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,gDAAgD;QAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,kDAAkD;YAClD,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,0CAA0C;QAC1C,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,6CAA6C;YAC7C,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,GAAG,oBAAoB,IAAI,QAAQ,EAAE,CAAC;QAE1D,gDAAgD;QAChD,qBAAqB,CAAC,WAAW,EAAE;YACjC,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,wCAAwC,QAAQ,CAAC,SAAS,EAAE;YACnE,MAAM,EAAE,kBAAkB;YAC1B,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SACzE,CAAC,CAAC;QAEH,wBAAwB;QACxB,MAAM,WAAW,GAAoB;YACnC,GAAG,QAAQ;YACX,QAAQ,EAAE,IAAI;YACd,gBAAgB,EAAE,KAAK;YACvB,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC1C,CAAC;QACF,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAE1C,YAAY,CACV,4CAA4C,QAAQ,CAAC,SAAS,gCAAgC,CAC/F,CAAC;IACJ,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,uBAAuB,OAAO,EAAE,CAAC,CAAC;QAChD,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/cli/hooks/stdin-parser.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Claude Code Hooks stdin parser
+ *
+ * Parses JSON input from Claude Code Hooks.
+ * Hooks receive data via stdin in JSON format.
+ *
+ * @since v4.1.0
+ */
+/**
+ * Tool input for various Claude Code tools
+ */
+export interface ToolInput {
+    /** File path (Edit, Write tools) */
+    file_path?: string;
+    /** Command (Bash tool) */
+    command?: string;
+    /** Description (Task tool) */
+    description?: string;
+    /** Prompt (Task tool) */
+    prompt?: string;
+    /** Subagent type (Task tool) */
+    subagent_type?: string;
+    /** Todos (TodoWrite tool) */
+    todos?: TodoItem[];
+    /** Generic key-value pairs */
+    [key: string]: unknown;
+}
+/**
+ * Todo item from TodoWrite tool
+ */
+export interface TodoItem {
+    /** Todo content */
+    content: string;
+    /** Todo status: pending, in_progress, completed */
+    status: 'pending' | 'in_progress' | 'completed';
+    /** Active form description */
+    activeForm: string;
+}
+/**
+ * Tool response from PostToolUse
+ */
+export interface ToolResponse {
+    /** Whether the tool completed successfully */
+    completed?: boolean;
+    /** Summary of what was done */
+    summary?: string;
+    /** Output content */
+    output?: string;
+    /** Generic key-value pairs */
+    [key: string]: unknown;
+}
+/**
+ * Hook input from Claude Code
+ */
+export interface HookInput {
+    /** Session ID (changes on resume) */
+    session_id?: string;
+    /** Current working directory */
+    cwd?: string;
+    /** Hook event name */
+    hook_event_name?: 'PreToolUse' | 'PostToolUse' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'SubagentStop';
+    /** Tool name being called */
+    tool_name?: string;
+    /** Tool input parameters */
+    tool_input?: ToolInput;
+    /** Tool response (PostToolUse only) */
+    tool_response?: ToolResponse;
+    /** Transcript path */
+    transcript_path?: string;
+    /** Permission mode */
+    permission_mode?: string;
+}
+/**
+ * Hook output to Claude Code
+ */
+export interface HookOutput {
+    /** Whether to continue execution */
+    continue?: boolean;
+    /** Reason for stopping (if continue=false) */
+    stopReason?: string;
+    /** Additional context to inject */
+    additionalContext?: string;
+    /** System message to add */
+    systemMessage?: string;
+    /** Whether to suppress output */
+    suppressOutput?: boolean;
+}
+/**
+ * Read and parse JSON from stdin
+ *
+ * Claude Code Hooks send data via stdin in JSON format.
+ * This function reads all stdin and parses it as JSON.
+ *
+ * @returns Parsed hook input
+ * @throws Error if stdin is empty or invalid JSON
+ */
+export declare function readStdinJson(): Promise<HookInput>;
+/**
+ * Write hook output to stdout
+ *
+ * @param output - Hook output to send
+ */
+export declare function writeHookOutput(output: HookOutput): void;
+/**
+ * Send a continue response
+ *
+ * @param additionalContext - Optional context to inject
+ * @param systemMessage - Optional system message
+ */
+export declare function sendContinue(additionalContext?: string, systemMessage?: string): void;
+/**
+ * Send a block response (exit code 2)
+ *
+ * @param reason - Reason for blocking
+ */
+export declare function sendBlock(reason: string): void;
+/**
+ * Check if the hook input is for a plan file
+ *
+ * @param input - Hook input
+ * @returns true if the tool is operating on a plan file
+ */
+export declare function isPlanFile(input: HookInput): boolean;
+/**
+ * Check if all todos are completed
+ *
+ * @param input - Hook input
+ * @returns true if all todos have status "completed"
+ */
+export declare function areAllTodosCompleted(input: HookInput): boolean;
+/**
+ * Get project path from hook input
+ * Uses cwd from input or falls back to CLAUDE_PROJECT_DIR
+ *
+ * @param input - Hook input
+ * @returns Project path or undefined
+ */
+export declare function getProjectPath(input: HookInput): string | undefined;
+//# sourceMappingURL=stdin-parser.d.ts.map

package/dist/cli/hooks/stdin-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin-parser.d.ts","sourceRoot":"","sources":["../../../src/cli/hooks/stdin-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,8BAA8B;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,eAAe,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,CAAC;IACzG,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,uCAAuC;IACvC,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,sBAAsB;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAMD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAoCxD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CASrF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAG9C;AAMD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CASpD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAO9D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEnE"}

package/dist/cli/hooks/stdin-parser.js

@@ -0,0 +1,127 @@
+/**
+ * Claude Code Hooks stdin parser
+ *
+ * Parses JSON input from Claude Code Hooks.
+ * Hooks receive data via stdin in JSON format.
+ *
+ * @since v4.1.0
+ */
+// ============================================================================
+// Parsing
+// ============================================================================
+/**
+ * Read and parse JSON from stdin
+ *
+ * Claude Code Hooks send data via stdin in JSON format.
+ * This function reads all stdin and parses it as JSON.
+ *
+ * @returns Parsed hook input
+ * @throws Error if stdin is empty or invalid JSON
+ */
+export async function readStdinJson() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        // Set encoding for text input
+        process.stdin.setEncoding('utf8');
+        // Read all data from stdin
+        process.stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        // Parse when stdin closes
+        process.stdin.on('end', () => {
+            if (!data.trim()) {
+                // Empty stdin - return empty object
+                resolve({});
+                return;
+            }
+            try {
+                const parsed = JSON.parse(data);
+                resolve(parsed);
+            }
+            catch (error) {
+                reject(new Error(`Invalid JSON input: ${error instanceof Error ? error.message : String(error)}`));
+            }
+        });
+        // Handle errors
+        process.stdin.on('error', (error) => {
+            reject(new Error(`Failed to read stdin: ${error.message}`));
+        });
+        // Resume stdin (it might be paused)
+        process.stdin.resume();
+    });
+}
+/**
+ * Write hook output to stdout
+ *
+ * @param output - Hook output to send
+ */
+export function writeHookOutput(output) {
+    console.log(JSON.stringify(output));
+}
+/**
+ * Send a continue response
+ *
+ * @param additionalContext - Optional context to inject
+ * @param systemMessage - Optional system message
+ */
+export function sendContinue(additionalContext, systemMessage) {
+    const output = { continue: true };
+    if (additionalContext) {
+        output.additionalContext = additionalContext;
+    }
+    if (systemMessage) {
+        output.systemMessage = systemMessage;
+    }
+    writeHookOutput(output);
+}
+/**
+ * Send a block response (exit code 2)
+ *
+ * @param reason - Reason for blocking
+ */
+export function sendBlock(reason) {
+    console.error(reason);
+    process.exit(2);
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Check if the hook input is for a plan file
+ *
+ * @param input - Hook input
+ * @returns true if the tool is operating on a plan file
+ */
+export function isPlanFile(input) {
+    const filePath = input.tool_input?.file_path;
+    if (!filePath) {
+        return false;
+    }
+    // Check if the path matches .claude/plans/*.md pattern
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    return /\.claude\/plans\/[^/]+\.md$/.test(normalizedPath);
+}
+/**
+ * Check if all todos are completed
+ *
+ * @param input - Hook input
+ * @returns true if all todos have status "completed"
+ */
+export function areAllTodosCompleted(input) {
+    const todos = input.tool_input?.todos;
+    if (!todos || !Array.isArray(todos) || todos.length === 0) {
+        return false;
+    }
+    return todos.every((todo) => todo.status === 'completed');
+}
+/**
+ * Get project path from hook input
+ * Uses cwd from input or falls back to CLAUDE_PROJECT_DIR
+ *
+ * @param input - Hook input
+ * @returns Project path or undefined
+ */
+export function getProjectPath(input) {
+    return input.cwd || process.env.CLAUDE_PROJECT_DIR;
+}
+//# sourceMappingURL=stdin-parser.js.map

package/dist/cli/hooks/stdin-parser.js.map

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