@claude-flow/hooks 3.0.0-alpha.1

package/dist/bridge/official-hooks-bridge.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Official Claude Code Hooks Bridge
+ *
+ * Maps V3 internal hook events to official Claude Code hook events.
+ * This bridge enables seamless integration between claude-flow's
+ * internal hook system and the official Claude Code plugin API.
+ *
+ * @module v3/hooks/bridge/official-hooks-bridge
+ */
+import { HookEvent, type HookHandler, type HookContext, type HookResult } from '../types.js';
+/**
+ * Official Claude Code hook event types
+ * Based on https://code.claude.com/docs/en/hooks
+ */
+export type OfficialHookEvent = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'PermissionRequest' | 'Notification' | 'Stop' | 'SubagentStop' | 'PreCompact' | 'SessionStart';
+/**
+ * Official hook input structure (received via stdin)
+ */
+export interface OfficialHookInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode: string;
+    hook_event_name: OfficialHookEvent;
+    tool_name?: string;
+    tool_input?: Record<string, unknown>;
+    tool_output?: unknown;
+    tool_success?: boolean;
+    tool_exit_code?: number;
+    prompt?: string;
+    notification_message?: string;
+    notification_level?: 'info' | 'warning' | 'error';
+}
+/**
+ * Official hook output structure (returned via stdout)
+ */
+export interface OfficialHookOutput {
+    /** Decision for permission/flow control */
+    decision?: 'allow' | 'deny' | 'block' | 'ask' | 'approve' | 'stop' | 'continue';
+    /** Reason for the decision */
+    reason?: string;
+    /** Whether to continue processing (false stops Claude) */
+    continue?: boolean;
+    /** Modified tool input (for PreToolUse) */
+    updatedInput?: Record<string, unknown>;
+    /** Suppress the tool call result display */
+    suppressOutput?: boolean;
+}
+/**
+ * Mapping from V3 HookEvent to Official hook events
+ */
+export declare const V3_TO_OFFICIAL_HOOK_MAP: Record<HookEvent, OfficialHookEvent | null>;
+/**
+ * Tool matchers for V3 events that map to PreToolUse/PostToolUse
+ */
+export declare const V3_TOOL_MATCHERS: Partial<Record<HookEvent, string>>;
+/**
+ * Bridge class for converting between V3 and official hooks
+ */
+export declare class OfficialHooksBridge {
+    /**
+     * Convert official hook input to V3 HookContext
+     */
+    static toV3Context(input: OfficialHookInput): HookContext;
+    /**
+     * Convert V3 HookResult to official hook output
+     */
+    static toOfficialOutput(result: HookResult, event: OfficialHookEvent): OfficialHookOutput;
+    /**
+     * Convert official hook event to V3 HookEvent
+     */
+    static officialToV3Event(officialEvent: OfficialHookEvent, toolName?: string): HookEvent;
+    /**
+     * Get tool matcher for a V3 event
+     */
+    static getToolMatcher(event: HookEvent): string | null;
+    /**
+     * Check if V3 event maps to an official hook
+     */
+    static hasOfficialMapping(event: HookEvent): boolean;
+    /**
+     * Create a CLI command for a V3 hook handler
+     */
+    static createCLICommand(event: HookEvent, handler: string): string;
+}
+/**
+ * Process stdin from official Claude Code hook system
+ */
+export declare function processOfficialHookInput(): Promise<OfficialHookInput | null>;
+/**
+ * Output result to official Claude Code hook system
+ */
+export declare function outputOfficialHookResult(output: OfficialHookOutput): void;
+/**
+ * Execute a V3 handler and bridge to official output
+ */
+export declare function executeWithBridge(input: OfficialHookInput, handler: HookHandler): Promise<OfficialHookOutput>;
+export default OfficialHooksBridge;
+//# sourceMappingURL=official-hooks-bridge.d.ts.map

package/dist/bridge/official-hooks-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-hooks-bridge.d.ts","sourceRoot":"","sources":["../../src/bridge/official-hooks-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAgB,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3G;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,cAAc,GACd,MAAM,GACN,cAAc,GACd,YAAY,GACZ,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,iBAAiB,CAAC;IAGnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAEhF,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAoC/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAU/D,CAAC;AAEF;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW;IAiEzD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,GAAG,kBAAkB;IA2BzF;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,aAAa,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS;IAkDxF;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI;IAItD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIpD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAwBnE;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA2BlF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAEzE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED,eAAe,mBAAmB,CAAC"}

package/dist/bridge/official-hooks-bridge.js

@@ -0,0 +1,280 @@
+/**
+ * Official Claude Code Hooks Bridge
+ *
+ * Maps V3 internal hook events to official Claude Code hook events.
+ * This bridge enables seamless integration between claude-flow's
+ * internal hook system and the official Claude Code plugin API.
+ *
+ * @module v3/hooks/bridge/official-hooks-bridge
+ */
+import { HookEvent } from '../types.js';
+/**
+ * Mapping from V3 HookEvent to Official hook events
+ */
+export const V3_TO_OFFICIAL_HOOK_MAP = {
+    // Direct mappings
+    [HookEvent.PreToolUse]: 'PreToolUse',
+    [HookEvent.PostToolUse]: 'PostToolUse',
+    [HookEvent.SessionStart]: 'SessionStart',
+    // File operations map to tool hooks with matchers
+    [HookEvent.PreEdit]: 'PreToolUse', // matcher: Edit|Write|MultiEdit
+    [HookEvent.PostEdit]: 'PostToolUse', // matcher: Edit|Write|MultiEdit
+    [HookEvent.PreRead]: 'PreToolUse', // matcher: Read
+    [HookEvent.PostRead]: 'PostToolUse', // matcher: Read
+    // Command operations map to tool hooks
+    [HookEvent.PreCommand]: 'PreToolUse', // matcher: Bash
+    [HookEvent.PostCommand]: 'PostToolUse', // matcher: Bash
+    // Task operations
+    [HookEvent.PreTask]: 'UserPromptSubmit',
+    [HookEvent.PostTask]: 'PostToolUse', // matcher: Task
+    [HookEvent.TaskProgress]: null, // Internal only
+    // Session operations
+    [HookEvent.SessionEnd]: 'Stop',
+    [HookEvent.SessionRestore]: 'SessionStart',
+    // Agent operations
+    [HookEvent.AgentSpawn]: 'PostToolUse', // matcher: Task
+    [HookEvent.AgentTerminate]: 'SubagentStop',
+    // Routing (internal)
+    [HookEvent.PreRoute]: 'UserPromptSubmit',
+    [HookEvent.PostRoute]: null, // Internal only
+    // Learning (internal)
+    [HookEvent.PatternLearned]: null, // Internal only
+    [HookEvent.PatternConsolidated]: null, // Internal only
+};
+/**
+ * Tool matchers for V3 events that map to PreToolUse/PostToolUse
+ */
+export const V3_TOOL_MATCHERS = {
+    [HookEvent.PreEdit]: '^(Write|Edit|MultiEdit)$',
+    [HookEvent.PostEdit]: '^(Write|Edit|MultiEdit)$',
+    [HookEvent.PreRead]: '^Read$',
+    [HookEvent.PostRead]: '^Read$',
+    [HookEvent.PreCommand]: '^Bash$',
+    [HookEvent.PostCommand]: '^Bash$',
+    [HookEvent.PreTask]: '^Task$',
+    [HookEvent.PostTask]: '^Task$',
+    [HookEvent.AgentSpawn]: '^Task$',
+};
+/**
+ * Bridge class for converting between V3 and official hooks
+ */
+export class OfficialHooksBridge {
+    /**
+     * Convert official hook input to V3 HookContext
+     */
+    static toV3Context(input) {
+        const event = this.officialToV3Event(input.hook_event_name, input.tool_name);
+        const context = {
+            event,
+            timestamp: new Date(),
+            metadata: {
+                session_id: input.session_id,
+                transcript_path: input.transcript_path,
+                cwd: input.cwd,
+                permission_mode: input.permission_mode,
+            },
+        };
+        // Add tool information
+        if (input.tool_name) {
+            context.tool = {
+                name: input.tool_name,
+                parameters: input.tool_input ?? {},
+            };
+        }
+        // Add file information for file operations
+        if (input.tool_name && ['Write', 'Edit', 'MultiEdit', 'Read'].includes(input.tool_name)) {
+            context.file = {
+                path: input.tool_input?.file_path ?? '',
+                operation: input.tool_name === 'Read' ? 'read' : 'modify',
+            };
+        }
+        // Add command information for Bash
+        if (input.tool_name === 'Bash') {
+            context.command = {
+                raw: input.tool_input?.command ?? '',
+                workingDirectory: input.cwd,
+                exitCode: input.tool_exit_code,
+                output: typeof input.tool_output === 'string' ? input.tool_output : undefined,
+            };
+        }
+        // Add task information for Task tool
+        if (input.tool_name === 'Task') {
+            context.task = {
+                id: `task-${Date.now()}`,
+                description: input.tool_input?.prompt ?? '',
+                agent: input.tool_input?.subagent_type,
+            };
+        }
+        // Add session information
+        context.session = {
+            id: input.session_id,
+            startedAt: new Date(),
+        };
+        // Add prompt for UserPromptSubmit
+        if (input.prompt) {
+            context.routing = {
+                task: input.prompt,
+            };
+        }
+        return context;
+    }
+    /**
+     * Convert V3 HookResult to official hook output
+     */
+    static toOfficialOutput(result, event) {
+        const output = {};
+        // Map abort to decision
+        if (result.abort) {
+            output.decision = event === 'PermissionRequest' ? 'deny' : 'block';
+            output.continue = false;
+        }
+        else if (result.success) {
+            output.decision = event === 'PermissionRequest' ? 'allow' : 'continue';
+            output.continue = true;
+        }
+        // Add reason
+        if (result.error) {
+            output.reason = result.error;
+        }
+        else if (result.message) {
+            output.reason = result.message;
+        }
+        // Pass through updated input if present
+        if (result.data?.updatedInput) {
+            output.updatedInput = result.data.updatedInput;
+        }
+        return output;
+    }
+    /**
+     * Convert official hook event to V3 HookEvent
+     */
+    static officialToV3Event(officialEvent, toolName) {
+        // Handle tool-specific mappings
+        if (officialEvent === 'PreToolUse' && toolName) {
+            if (['Write', 'Edit', 'MultiEdit'].includes(toolName)) {
+                return HookEvent.PreEdit;
+            }
+            if (toolName === 'Read') {
+                return HookEvent.PreRead;
+            }
+            if (toolName === 'Bash') {
+                return HookEvent.PreCommand;
+            }
+            if (toolName === 'Task') {
+                return HookEvent.PreTask;
+            }
+            return HookEvent.PreToolUse;
+        }
+        if (officialEvent === 'PostToolUse' && toolName) {
+            if (['Write', 'Edit', 'MultiEdit'].includes(toolName)) {
+                return HookEvent.PostEdit;
+            }
+            if (toolName === 'Read') {
+                return HookEvent.PostRead;
+            }
+            if (toolName === 'Bash') {
+                return HookEvent.PostCommand;
+            }
+            if (toolName === 'Task') {
+                return HookEvent.PostTask;
+            }
+            return HookEvent.PostToolUse;
+        }
+        // Direct mappings
+        const mapping = {
+            PreToolUse: HookEvent.PreToolUse,
+            PostToolUse: HookEvent.PostToolUse,
+            UserPromptSubmit: HookEvent.PreTask,
+            PermissionRequest: HookEvent.PreToolUse,
+            Notification: HookEvent.PostTask, // Closest match
+            Stop: HookEvent.SessionEnd,
+            SubagentStop: HookEvent.AgentTerminate,
+            PreCompact: HookEvent.SessionEnd, // Closest match
+            SessionStart: HookEvent.SessionStart,
+        };
+        return mapping[officialEvent] ?? HookEvent.PreToolUse;
+    }
+    /**
+     * Get tool matcher for a V3 event
+     */
+    static getToolMatcher(event) {
+        return V3_TOOL_MATCHERS[event] ?? null;
+    }
+    /**
+     * Check if V3 event maps to an official hook
+     */
+    static hasOfficialMapping(event) {
+        return V3_TO_OFFICIAL_HOOK_MAP[event] !== null;
+    }
+    /**
+     * Create a CLI command for a V3 hook handler
+     */
+    static createCLICommand(event, handler) {
+        const baseCommand = 'npx claude-flow@alpha hooks';
+        switch (event) {
+            case HookEvent.PreEdit:
+                return `${baseCommand} pre-edit --file "$TOOL_INPUT_file_path"`;
+            case HookEvent.PostEdit:
+                return `${baseCommand} post-edit --file "$TOOL_INPUT_file_path" --success "$TOOL_SUCCESS" --train-patterns`;
+            case HookEvent.PreCommand:
+                return `${baseCommand} pre-command --command "$TOOL_INPUT_command"`;
+            case HookEvent.PostCommand:
+                return `${baseCommand} post-command --command "$TOOL_INPUT_command" --success "$TOOL_SUCCESS"`;
+            case HookEvent.PreTask:
+                return `${baseCommand} pre-task --description "$PROMPT"`;
+            case HookEvent.PostTask:
+                return `${baseCommand} post-task --task-id "$TOOL_RESULT_agent_id" --analyze-performance`;
+            case HookEvent.SessionStart:
+                return `${baseCommand} session-start --session-id "$SESSION_ID" --load-context`;
+            case HookEvent.SessionEnd:
+                return `${baseCommand} session-end --session-id "$SESSION_ID" --export-metrics`;
+            default:
+                return `${baseCommand} ${handler}`;
+        }
+    }
+}
+/**
+ * Process stdin from official Claude Code hook system
+ */
+export async function processOfficialHookInput() {
+    return new Promise((resolve) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('readable', () => {
+            let chunk;
+            while ((chunk = process.stdin.read()) !== null) {
+                data += chunk;
+            }
+        });
+        process.stdin.on('end', () => {
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                resolve(null);
+            }
+        });
+        // Handle case where no stdin (testing)
+        setTimeout(() => {
+            if (!data) {
+                resolve(null);
+            }
+        }, 100);
+    });
+}
+/**
+ * Output result to official Claude Code hook system
+ */
+export function outputOfficialHookResult(output) {
+    console.log(JSON.stringify(output));
+}
+/**
+ * Execute a V3 handler and bridge to official output
+ */
+export async function executeWithBridge(input, handler) {
+    const context = OfficialHooksBridge.toV3Context(input);
+    const result = await handler(context);
+    return OfficialHooksBridge.toOfficialOutput(result, input.hook_event_name);
+}
+export default OfficialHooksBridge;
+//# sourceMappingURL=official-hooks-bridge.js.map

package/dist/bridge/official-hooks-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-hooks-bridge.js","sourceRoot":"","sources":["../../src/bridge/official-hooks-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAqE,MAAM,aAAa,CAAC;AA8D3G;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAgD;IAClF,kBAAkB;IAClB,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,YAAY;IACpC,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,aAAa;IACtC,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,cAAc;IAExC,kDAAkD;IAClD,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,gCAAgC;IACnE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,gCAAgC;IACrE,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,gBAAgB;IACnD,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,gBAAgB;IAErD,uCAAuC;IACvC,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,gBAAgB;IACtD,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,gBAAgB;IAExD,kBAAkB;IAClB,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,kBAAkB;IACvC,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,gBAAgB;IACrD,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,gBAAgB;IAEhD,qBAAqB;IACrB,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM;IAC9B,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,cAAc;IAE1C,mBAAmB;IACnB,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,gBAAgB;IACvD,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,cAAc;IAE1C,qBAAqB;IACrB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,kBAAkB;IACxC,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB;IAE7C,sBAAsB;IACtB,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,gBAAgB;IAClD,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,gBAAgB;CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuC;IAClE,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,0BAA0B;IAC/C,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,0BAA0B;IAChD,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ;IAC7B,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ;IAC9B,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,QAAQ;IAChC,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,QAAQ;IACjC,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ;IAC7B,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ;IAC9B,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,QAAQ;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAwB;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAE7E,MAAM,OAAO,GAAgB;YAC3B,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE;gBACR,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,eAAe,EAAE,KAAK,CAAC,eAAe;aACvC;SACF,CAAC;QAEF,uBAAuB;QACvB,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,GAAG;gBACb,IAAI,EAAE,KAAK,CAAC,SAAS;gBACrB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;aACnC,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACxF,OAAO,CAAC,IAAI,GAAG;gBACb,IAAI,EAAG,KAAK,CAAC,UAAU,EAAE,SAAoB,IAAI,EAAE;gBACnD,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;aAC1D,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,CAAC,OAAO,GAAG;gBAChB,GAAG,EAAG,KAAK,CAAC,UAAU,EAAE,OAAkB,IAAI,EAAE;gBAChD,gBAAgB,EAAE,KAAK,CAAC,GAAG;gBAC3B,QAAQ,EAAE,KAAK,CAAC,cAAc;gBAC9B,MAAM,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;aAC9E,CAAC;QACJ,CAAC;QAED,qCAAqC;QACrC,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,GAAG;gBACb,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE;gBACxB,WAAW,EAAG,KAAK,CAAC,UAAU,EAAE,MAAiB,IAAI,EAAE;gBACvD,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,aAAuB;aACjD,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,OAAO,CAAC,OAAO,GAAG;YAChB,EAAE,EAAE,KAAK,CAAC,UAAU;YACpB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QAEF,kCAAkC;QAClC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,CAAC,OAAO,GAAG;gBAChB,IAAI,EAAE,KAAK,CAAC,MAAM;aACnB,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAkB,EAAE,KAAwB;QAClE,MAAM,MAAM,GAAuB,EAAE,CAAC;QAEtC,wBAAwB;QACxB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,QAAQ,GAAG,KAAK,KAAK,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACnE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC1B,CAAC;aAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,QAAQ,GAAG,KAAK,KAAK,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;YACvE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;QACzB,CAAC;QAED,aAAa;QACb,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;QAC/B,CAAC;aAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;QACjC,CAAC;QAED,wCAAwC;QACxC,IAAI,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;YAC9B,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAuC,CAAC;QAC5E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,aAAgC,EAAE,QAAiB;QAC1E,gCAAgC;QAChC,IAAI,aAAa,KAAK,YAAY,IAAI,QAAQ,EAAE,CAAC;YAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtD,OAAO,SAAS,CAAC,OAAO,CAAC;YAC3B,CAAC;YACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,OAAO,CAAC;YAC3B,CAAC;YACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,UAAU,CAAC;YAC9B,CAAC;YACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,OAAO,CAAC;YAC3B,CAAC;YACD,OAAO,SAAS,CAAC,UAAU,CAAC;QAC9B,CAAC;QAED,IAAI,aAAa,KAAK,aAAa,IAAI,QAAQ,EAAE,CAAC;YAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtD,OAAO,SAAS,CAAC,QAAQ,CAAC;YAC5B,CAAC;YACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,QAAQ,CAAC;YAC5B,CAAC;YACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,WAAW,CAAC;YAC/B,CAAC;YACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,QAAQ,CAAC;YAC5B,CAAC;YACD,OAAO,SAAS,CAAC,WAAW,CAAC;QAC/B,CAAC;QAED,kBAAkB;QAClB,MAAM,OAAO,GAAyC;YACpD,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,gBAAgB,EAAE,SAAS,CAAC,OAAO;YACnC,iBAAiB,EAAE,SAAS,CAAC,UAAU;YACvC,YAAY,EAAE,SAAS,CAAC,QAAQ,EAAE,gBAAgB;YAClD,IAAI,EAAE,SAAS,CAAC,UAAU;YAC1B,YAAY,EAAE,SAAS,CAAC,cAAc;YACtC,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,gBAAgB;YAClD,YAAY,EAAE,SAAS,CAAC,YAAY;SACrC,CAAC;QAEF,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAgB;QACpC,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAgB;QACxC,OAAO,uBAAuB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAgB,EAAE,OAAe;QACvD,MAAM,WAAW,GAAG,6BAA6B,CAAC;QAElD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,SAAS,CAAC,OAAO;gBACpB,OAAO,GAAG,WAAW,0CAA0C,CAAC;YAClE,KAAK,SAAS,CAAC,QAAQ;gBACrB,OAAO,GAAG,WAAW,sFAAsF,CAAC;YAC9G,KAAK,SAAS,CAAC,UAAU;gBACvB,OAAO,GAAG,WAAW,8CAA8C,CAAC;YACtE,KAAK,SAAS,CAAC,WAAW;gBACxB,OAAO,GAAG,WAAW,yEAAyE,CAAC;YACjG,KAAK,SAAS,CAAC,OAAO;gBACpB,OAAO,GAAG,WAAW,mCAAmC,CAAC;YAC3D,KAAK,SAAS,CAAC,QAAQ;gBACrB,OAAO,GAAG,WAAW,oEAAoE,CAAC;YAC5F,KAAK,SAAS,CAAC,YAAY;gBACzB,OAAO,GAAG,WAAW,0DAA0D,CAAC;YAClF,KAAK,SAAS,CAAC,UAAU;gBACvB,OAAO,GAAG,WAAW,0DAA0D,CAAC;YAClF;gBACE,OAAO,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE;YAChC,IAAI,KAAK,CAAC;YACV,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC/C,IAAI,IAAI,KAAK,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,uCAAuC;QACvC,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IACjE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAoB;IAEpB,MAAM,OAAO,GAAG,mBAAmB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;AAC7E,CAAC;AAED,eAAe,mBAAmB,CAAC"}

package/dist/cli/guidance-cli.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * V3 Guidance CLI
+ *
+ * Command-line interface for hooks guidance system.
+ * Outputs plain text or JSON that Claude Code hooks can consume.
+ *
+ * Usage:
+ *   npx @claude-flow/hooks session-context
+ *   npx @claude-flow/hooks user-prompt "Fix authentication bug"
+ *   npx @claude-flow/hooks pre-edit "/path/to/file.ts"
+ *   npx @claude-flow/hooks route "Implement caching layer"
+ *
+ * @module @claude-flow/hooks/cli/guidance-cli
+ */
+export {};
+//# sourceMappingURL=guidance-cli.d.ts.map

package/dist/cli/guidance-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-cli.d.ts","sourceRoot":"","sources":["../../src/cli/guidance-cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}