@litmers/cursorflow-orchestrator 0.1.40 → 0.2.3

package/dist/hooks/flow-controller.js

@@ -0,0 +1,351 @@
+"use strict";
+/**
+ * CursorFlow Hook System - Flow Controller Implementation
+ *
+ * Hook 핸들러에서 실행 플로우를 제어하기 위한 구현체입니다.
+ * pause, resume, injectTask 등의 기능을 제공합니다.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowRetryError = exports.FlowAbortError = exports.FlowControllerImpl = void 0;
+exports.createFlowController = createFlowController;
+const fs = __importStar(require("fs"));
+const path_1 = require("../utils/path");
+const logger = __importStar(require("../utils/logger"));
+const events_1 = require("../utils/events");
+// ============================================================================
+// Flow Controller Implementation
+// ============================================================================
+/**
+ * FlowController 구현체
+ */
+class FlowControllerImpl {
+    options;
+    state;
+    pauseResolver = null;
+    constructor(options) {
+        this.options = options;
+        this.state = {
+            isPaused: false,
+            isAborted: false,
+            shouldRetry: false,
+        };
+    }
+    // ==========================================================================
+    // Flow Control Methods
+    // ==========================================================================
+    /**
+     * 플로우 일시 중지
+     */
+    async pause(reason) {
+        if (this.state.isPaused) {
+            logger.warn(`[Hook] Already paused, ignoring duplicate pause request`);
+            return;
+        }
+        this.state.isPaused = true;
+        this.state.reason = reason;
+        logger.info(`[Hook] Flow paused: ${reason}`);
+        // 이벤트 발행
+        events_1.events.emit('lane.paused', {
+            laneName: this.options.laneName,
+            reason,
+        });
+        // Pause 상태 파일 생성 (외부에서 확인 가능)
+        const pauseFile = (0, path_1.safeJoin)(this.options.runDir, 'paused.json');
+        fs.writeFileSync(pauseFile, JSON.stringify({
+            paused: true,
+            reason,
+            timestamp: Date.now(),
+        }, null, 2));
+        // resume이 호출될 때까지 대기
+        return new Promise((resolve) => {
+            this.pauseResolver = (data) => {
+                this.state.isPaused = false;
+                this.state.resumeData = data;
+                // Pause 파일 삭제
+                try {
+                    fs.unlinkSync(pauseFile);
+                }
+                catch {
+                    // Ignore
+                }
+                resolve();
+            };
+        });
+    }
+    /**
+     * 플로우 재개
+     */
+    resume(data) {
+        if (!this.state.isPaused) {
+            logger.warn(`[Hook] Not paused, ignoring resume request`);
+            return;
+        }
+        logger.info(`[Hook] Flow resumed`);
+        // 이벤트 발행
+        events_1.events.emit('lane.resumed', {
+            laneName: this.options.laneName,
+        });
+        if (this.pauseResolver) {
+            this.pauseResolver(data);
+            this.pauseResolver = null;
+        }
+    }
+    /**
+     * Lane 중단
+     */
+    abort(reason) {
+        this.state.isAborted = true;
+        this.state.reason = reason;
+        logger.error(`[Hook] Flow aborted: ${reason}`);
+        // 이벤트 발행
+        events_1.events.emit('lane.failed', {
+            laneName: this.options.laneName,
+            exitCode: 1,
+            error: reason,
+        });
+        // Abort 예외 던지기 (Runner에서 catch)
+        throw new FlowAbortError(reason);
+    }
+    /**
+     * 현재 태스크 재시도
+     */
+    retry(options) {
+        this.state.shouldRetry = true;
+        this.state.retryPrompt = options?.modifiedPrompt;
+        logger.info(`[Hook] Task retry requested${options?.modifiedPrompt ? ' with modified prompt' : ''}`);
+        throw new FlowRetryError(options?.modifiedPrompt);
+    }
+    // ==========================================================================
+    // Task Manipulation Methods
+    // ==========================================================================
+    /**
+     * 다음에 실행할 태스크 삽입
+     */
+    injectTask(task) {
+        const insertIndex = this.options.currentTaskIndex + 1;
+        // 태스크 배열에 삽입
+        this.options.tasks.splice(insertIndex, 0, task);
+        logger.info(`[Hook] Injected task "${task.name}" at index ${insertIndex}`);
+        // tasks.json 파일 업데이트
+        this.persistTasks();
+    }
+    /**
+     * 현재 태스크 프롬프트 수정 (beforeTask에서만 유효)
+     */
+    modifyCurrentPrompt(newPrompt) {
+        this.state.modifiedCurrentPrompt = newPrompt;
+        const currentTask = this.options.tasks[this.options.currentTaskIndex];
+        if (currentTask) {
+            logger.info(`[Hook] Modified prompt for task "${currentTask.name}"`);
+        }
+    }
+    /**
+     * 다음 태스크 수정
+     */
+    modifyNextTask(modifier) {
+        const nextIndex = this.options.currentTaskIndex + 1;
+        if (nextIndex >= this.options.tasks.length) {
+            logger.warn(`[Hook] No next task to modify`);
+            return;
+        }
+        const nextTask = this.options.tasks[nextIndex];
+        const modifiedTask = modifier(nextTask);
+        this.options.tasks[nextIndex] = modifiedTask;
+        logger.info(`[Hook] Modified next task "${modifiedTask.name}"`);
+        // tasks.json 파일 업데이트
+        this.persistTasks();
+    }
+    /**
+     * 남은 태스크 전체 교체
+     */
+    replaceRemainingTasks(tasks) {
+        const currentIndex = this.options.currentTaskIndex;
+        // 현재까지의 태스크 유지, 이후 교체
+        const completedTasks = this.options.tasks.slice(0, currentIndex + 1);
+        this.options.tasks.length = 0;
+        this.options.tasks.push(...completedTasks, ...tasks);
+        logger.info(`[Hook] Replaced remaining tasks with ${tasks.length} new tasks`);
+        // tasks.json 파일 업데이트
+        this.persistTasks();
+    }
+    /**
+     * tasks.json 파일에 변경사항 저장
+     */
+    persistTasks() {
+        try {
+            const tasksFile = this.options.tasksFile;
+            if (fs.existsSync(tasksFile)) {
+                const config = JSON.parse(fs.readFileSync(tasksFile, 'utf8'));
+                config.tasks = this.options.tasks;
+                fs.writeFileSync(tasksFile, JSON.stringify(config, null, 2));
+            }
+        }
+        catch (error) {
+            logger.warn(`[Hook] Failed to persist tasks: ${error}`);
+        }
+    }
+    // ==========================================================================
+    // Agent Communication Methods
+    // ==========================================================================
+    /**
+     * AI 에이전트에게 메시지 전송 (현재 세션)
+     */
+    async sendMessage(message) {
+        const { agentSupervisor, worktreeDir, chatId, laneName, runDir } = this.options;
+        if (!agentSupervisor) {
+            throw new Error('AgentSupervisor not available');
+        }
+        logger.info(`[Hook] Sending message to agent`);
+        try {
+            const result = await agentSupervisor.sendTaskPrompt({
+                workspaceDir: worktreeDir,
+                chatId,
+                prompt: message,
+                laneName,
+                signalDir: runDir,
+                taskName: 'hook-intervention',
+            });
+            return result.resultText || '';
+        }
+        catch (error) {
+            logger.error(`[Hook] Failed to send message: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * 별도 AI 호출 (새 세션)
+     */
+    async callAI(prompt, options) {
+        const { agentSupervisor, worktreeDir, laneName, runDir } = this.options;
+        if (!agentSupervisor) {
+            throw new Error('AgentSupervisor not available');
+        }
+        logger.info(`[Hook] Calling AI with new session`);
+        try {
+            // 새 채팅 세션 생성
+            const newChatId = agentSupervisor.createChat(worktreeDir);
+            const result = await agentSupervisor.sendTaskPrompt({
+                workspaceDir: worktreeDir,
+                chatId: newChatId,
+                prompt,
+                model: options?.model,
+                laneName,
+                signalDir: runDir,
+                timeout: options?.timeout,
+                taskName: 'hook-ai-call',
+            });
+            return result.resultText || '';
+        }
+        catch (error) {
+            logger.error(`[Hook] Failed to call AI: ${error.message}`);
+            throw error;
+        }
+    }
+    // ==========================================================================
+    // State Access Methods
+    // ==========================================================================
+    /**
+     * 현재 상태 조회
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * 수정된 프롬프트 조회 (beforeTask에서 설정된 경우)
+     */
+    getModifiedPrompt() {
+        return this.state.modifiedCurrentPrompt;
+    }
+    /**
+     * 재개 데이터 조회
+     */
+    getResumeData() {
+        return this.state.resumeData;
+    }
+    /**
+     * 상태 리셋
+     */
+    resetState() {
+        this.state = {
+            isPaused: false,
+            isAborted: false,
+            shouldRetry: false,
+        };
+        this.pauseResolver = null;
+    }
+    /**
+     * 옵션 업데이트
+     */
+    updateOptions(updates) {
+        this.options = { ...this.options, ...updates };
+    }
+}
+exports.FlowControllerImpl = FlowControllerImpl;
+// ============================================================================
+// Custom Errors
+// ============================================================================
+/**
+ * Flow 중단 에러
+ */
+class FlowAbortError extends Error {
+    constructor(reason) {
+        super(`Flow aborted: ${reason}`);
+        this.name = 'FlowAbortError';
+    }
+}
+exports.FlowAbortError = FlowAbortError;
+/**
+ * Flow 재시도 에러
+ */
+class FlowRetryError extends Error {
+    modifiedPrompt;
+    constructor(modifiedPrompt) {
+        super('Flow retry requested');
+        this.name = 'FlowRetryError';
+        this.modifiedPrompt = modifiedPrompt;
+    }
+}
+exports.FlowRetryError = FlowRetryError;
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * FlowController 인스턴스 생성
+ */
+function createFlowController(options) {
+    return new FlowControllerImpl(options);
+}
+//# sourceMappingURL=flow-controller.js.map

package/dist/hooks/flow-controller.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * CursorFlow Hook System
+ *
+ * 외부 개발자가 Supervisor AI, 모니터링 시스템, 커스텀 로직 등을
+ * 구현할 수 있도록 제공하는 Hook API입니다.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { hooks, HookPoint } from '@litmers/cursorflow-orchestrator';
+ *
+ * // 태스크 완료 후 결과 리뷰
+ * hooks.register({
+ *   point: HookPoint.AFTER_TASK,
+ *   mode: 'sync',
+ *   name: 'my-reviewer',
+ *   handler: async (ctx) => {
+ *     // 수정된 파일 확인
+ *     const files = await ctx.getData.git.getChangedFiles();
+ *     console.log('Modified files:', files.map(f => f.path));
+ *
+ *     // AI 응답 분석
+ *     const response = await ctx.getData.conversation.getLastResponse();
+ *
+ *     // 필요시 추가 태스크 삽입
+ *     if (needsFix(response)) {
+ *       ctx.flow.injectTask({
+ *         name: 'Fix: ' + ctx.task.name,
+ *         prompt: 'Fix the issues...',
+ *       });
+ *     }
+ *   },
+ * });
+ * ```
+ *
+ * ## Hook Points
+ *
+ * | Hook Point | 트리거 시점 | 주요 용도 |
+ * |------------|------------|----------|
+ * | `beforeTask` | 태스크 실행 직전 | 프롬프트 검토/수정 |
+ * | `afterTask` | 태스크 완료 직후 | 결과 리뷰, 태스크 삽입 |
+ * | `onError` | 에러 발생 시 | 에러 분석, 복구 |
+ * | `onStall` | 응답 없음 감지 시 | 상황 분석, 개입 |
+ * | `onLaneEnd` | Lane 종료 시 | 최종 리뷰, 보고서 |
+ *
+ * ## Configuration
+ *
+ * `.cursorflow.json`에서 Hook 설정:
+ *
+ * ```json
+ * {
+ *   "hooks": {
+ *     "file": "./cursorflow.hooks.ts",
+ *     "timeout": 30000,
+ *     "continueOnError": false
+ *   }
+ * }
+ * ```
+ *
+ * @module hooks
+ */
+export { HookPoint, HookMode, HookContext, BeforeTaskContext, AfterTaskContext, OnErrorContext, OnStallContext, OnLaneEndContext, ChangedFile, Commit, Message, TaskResult, TaskDefinition, ToolCall, ErrorLog, DependencyResult, HookDataAccessor, FlowController, AICallOptions, HookRegistration, HookExecutionResult, HookHandlerMap, HooksConfig, } from './types';
+export { HookManager, hooks, getHookManager, resetHookManager, } from './manager';
+export { HookDataAccessorImpl, DataAccessorOptions, createDataAccessor, } from './data-accessor';
+export { FlowControllerImpl, FlowControllerOptions, FlowControlState, FlowAbortError, FlowRetryError, createFlowController, } from './flow-controller';
+export { BaseContextOptions, createBeforeTaskContext, createAfterTaskContext, createOnErrorContext, createOnStallContext, createOnLaneEndContext, } from './contexts';
+import { hooks as hooksSingleton } from './manager';
+export default hooksSingleton;

package/dist/hooks/index.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * CursorFlow Hook System
+ *
+ * 외부 개발자가 Supervisor AI, 모니터링 시스템, 커스텀 로직 등을
+ * 구현할 수 있도록 제공하는 Hook API입니다.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { hooks, HookPoint } from '@litmers/cursorflow-orchestrator';
+ *
+ * // 태스크 완료 후 결과 리뷰
+ * hooks.register({
+ *   point: HookPoint.AFTER_TASK,
+ *   mode: 'sync',
+ *   name: 'my-reviewer',
+ *   handler: async (ctx) => {
+ *     // 수정된 파일 확인
+ *     const files = await ctx.getData.git.getChangedFiles();
+ *     console.log('Modified files:', files.map(f => f.path));
+ *
+ *     // AI 응답 분석
+ *     const response = await ctx.getData.conversation.getLastResponse();
+ *
+ *     // 필요시 추가 태스크 삽입
+ *     if (needsFix(response)) {
+ *       ctx.flow.injectTask({
+ *         name: 'Fix: ' + ctx.task.name,
+ *         prompt: 'Fix the issues...',
+ *       });
+ *     }
+ *   },
+ * });
+ * ```
+ *
+ * ## Hook Points
+ *
+ * | Hook Point | 트리거 시점 | 주요 용도 |
+ * |------------|------------|----------|
+ * | `beforeTask` | 태스크 실행 직전 | 프롬프트 검토/수정 |
+ * | `afterTask` | 태스크 완료 직후 | 결과 리뷰, 태스크 삽입 |
+ * | `onError` | 에러 발생 시 | 에러 분석, 복구 |
+ * | `onStall` | 응답 없음 감지 시 | 상황 분석, 개입 |
+ * | `onLaneEnd` | Lane 종료 시 | 최종 리뷰, 보고서 |
+ *
+ * ## Configuration
+ *
+ * `.cursorflow.json`에서 Hook 설정:
+ *
+ * ```json
+ * {
+ *   "hooks": {
+ *     "file": "./cursorflow.hooks.ts",
+ *     "timeout": 30000,
+ *     "continueOnError": false
+ *   }
+ * }
+ * ```
+ *
+ * @module hooks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOnLaneEndContext = exports.createOnStallContext = exports.createOnErrorContext = exports.createAfterTaskContext = exports.createBeforeTaskContext = exports.createFlowController = exports.FlowRetryError = exports.FlowAbortError = exports.FlowControllerImpl = exports.createDataAccessor = exports.HookDataAccessorImpl = exports.resetHookManager = exports.getHookManager = exports.hooks = exports.HookManager = exports.HookPoint = void 0;
+// ============================================================================
+// Type Exports
+// ============================================================================
+var types_1 = require("./types");
+// Hook Points & Modes
+Object.defineProperty(exports, "HookPoint", { enumerable: true, get: function () { return types_1.HookPoint; } });
+// ============================================================================
+// Manager Exports
+// ============================================================================
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "HookManager", { enumerable: true, get: function () { return manager_1.HookManager; } });
+Object.defineProperty(exports, "hooks", { enumerable: true, get: function () { return manager_1.hooks; } });
+Object.defineProperty(exports, "getHookManager", { enumerable: true, get: function () { return manager_1.getHookManager; } });
+Object.defineProperty(exports, "resetHookManager", { enumerable: true, get: function () { return manager_1.resetHookManager; } });
+// ============================================================================
+// Implementation Exports (for advanced usage)
+// ============================================================================
+var data_accessor_1 = require("./data-accessor");
+Object.defineProperty(exports, "HookDataAccessorImpl", { enumerable: true, get: function () { return data_accessor_1.HookDataAccessorImpl; } });
+Object.defineProperty(exports, "createDataAccessor", { enumerable: true, get: function () { return data_accessor_1.createDataAccessor; } });
+var flow_controller_1 = require("./flow-controller");
+Object.defineProperty(exports, "FlowControllerImpl", { enumerable: true, get: function () { return flow_controller_1.FlowControllerImpl; } });
+Object.defineProperty(exports, "FlowAbortError", { enumerable: true, get: function () { return flow_controller_1.FlowAbortError; } });
+Object.defineProperty(exports, "FlowRetryError", { enumerable: true, get: function () { return flow_controller_1.FlowRetryError; } });
+Object.defineProperty(exports, "createFlowController", { enumerable: true, get: function () { return flow_controller_1.createFlowController; } });
+// ============================================================================
+// Context Builder Exports (for internal/advanced usage)
+// ============================================================================
+var contexts_1 = require("./contexts");
+Object.defineProperty(exports, "createBeforeTaskContext", { enumerable: true, get: function () { return contexts_1.createBeforeTaskContext; } });
+Object.defineProperty(exports, "createAfterTaskContext", { enumerable: true, get: function () { return contexts_1.createAfterTaskContext; } });
+Object.defineProperty(exports, "createOnErrorContext", { enumerable: true, get: function () { return contexts_1.createOnErrorContext; } });
+Object.defineProperty(exports, "createOnStallContext", { enumerable: true, get: function () { return contexts_1.createOnStallContext; } });
+Object.defineProperty(exports, "createOnLaneEndContext", { enumerable: true, get: function () { return contexts_1.createOnLaneEndContext; } });
+// ============================================================================
+// Re-export for convenience
+// ============================================================================
+// Default export: hooks singleton
+const manager_2 = require("./manager");
+exports.default = manager_2.hooks;
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;;;AAEH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,iCAmCiB;AAlCf,sBAAsB;AACtB,kGAAA,SAAS,OAAA;AAmCX,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,qCAKmB;AAJjB,sGAAA,WAAW,OAAA;AACX,gGAAA,KAAK,OAAA;AACL,yGAAA,cAAc,OAAA;AACd,2GAAA,gBAAgB,OAAA;AAGlB,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E;AAE/E,iDAIyB;AAHvB,qHAAA,oBAAoB,OAAA;AAEpB,mHAAA,kBAAkB,OAAA;AAGpB,qDAO2B;AANzB,qHAAA,kBAAkB,OAAA;AAGlB,iHAAA,cAAc,OAAA;AACd,iHAAA,cAAc,OAAA;AACd,uHAAA,oBAAoB,OAAA;AAGtB,+EAA+E;AAC/E,wDAAwD;AACxD,+EAA+E;AAE/E,uCAOoB;AALlB,mHAAA,uBAAuB,OAAA;AACvB,kHAAA,sBAAsB,OAAA;AACtB,gHAAA,oBAAoB,OAAA;AACpB,gHAAA,oBAAoB,OAAA;AACpB,kHAAA,sBAAsB,OAAA;AAGxB,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E,kCAAkC;AAClC,uCAAoD;AACpD,kBAAe,eAAc,CAAC"}

package/dist/hooks/manager.d.ts

@@ -0,0 +1,129 @@
+/**
+ * CursorFlow Hook System - Hook Manager
+ *
+ * Hook 등록 및 실행을 관리하는 중앙 매니저입니다.
+ * 외부 개발자가 Hook을 등록하고 CursorFlow가 적절한 시점에 실행합니다.
+ *
+ * @example
+ * ```typescript
+ * import { hooks, HookPoint } from '@litmers/cursorflow-orchestrator';
+ *
+ * hooks.register({
+ *   point: HookPoint.AFTER_TASK,
+ *   mode: 'sync',
+ *   handler: async (ctx) => {
+ *     // Your logic here
+ *   },
+ * });
+ * ```
+ */
+import { HookPoint, HookMode, HookRegistration, HookExecutionResult, HookContext, BeforeTaskContext, AfterTaskContext, OnErrorContext, OnStallContext, OnLaneEndContext, HooksConfig } from './types';
+/**
+ * Hook Manager 클래스
+ *
+ * 싱글톤 패턴으로 구현되어 전역에서 접근 가능합니다.
+ */
+export declare class HookManager {
+    private static instance;
+    /** 등록된 Hook 목록 (Hook Point별로 분류) */
+    private hooks;
+    /** 설정 */
+    private config;
+    private constructor();
+    /**
+     * 싱글톤 인스턴스 획득
+     */
+    static getInstance(): HookManager;
+    /**
+     * 인스턴스 리셋 (테스트용)
+     */
+    static resetInstance(): void;
+    /**
+     * 설정 업데이트
+     */
+    configure(config: Partial<HooksConfig>): void;
+    /**
+     * 현재 설정 조회
+     */
+    getConfig(): HooksConfig;
+    /**
+     * Hook 등록
+     *
+     * @param registration Hook 등록 정보
+     * @returns 등록 해제 함수
+     */
+    register<T extends HookPoint>(registration: HookRegistration<T>): () => void;
+    /**
+     * Hook 등록 해제
+     */
+    private unregister;
+    /**
+     * 특정 Hook Point의 모든 Hook 제거
+     */
+    clearHooks(point?: HookPoint): void;
+    /**
+     * 등록된 Hook 수 조회
+     */
+    getHookCount(point?: HookPoint): number;
+    /**
+     * Hook 등록 여부 확인
+     */
+    hasHooks(point: HookPoint): boolean;
+    /**
+     * beforeTask Hook 실행
+     */
+    executeBeforeTask(context: BeforeTaskContext): Promise<HookExecutionResult[]>;
+    /**
+     * afterTask Hook 실행
+     */
+    executeAfterTask(context: AfterTaskContext): Promise<HookExecutionResult[]>;
+    /**
+     * onError Hook 실행
+     */
+    executeOnError(context: OnErrorContext): Promise<HookExecutionResult[]>;
+    /**
+     * onStall Hook 실행
+     */
+    executeOnStall(context: OnStallContext): Promise<HookExecutionResult[]>;
+    /**
+     * onLaneEnd Hook 실행
+     */
+    executeOnLaneEnd(context: OnLaneEndContext): Promise<HookExecutionResult[]>;
+    /**
+     * 일반 Hook 실행
+     */
+    execute<T extends HookPoint>(point: T, context: HookContext): Promise<HookExecutionResult[]>;
+    /**
+     * 단일 Hook 실행
+     */
+    private executeHook;
+    /**
+     * 파일에서 Hook 로드
+     */
+    loadHooksFromFile(filePath: string): Promise<number>;
+    /**
+     * 등록된 Hook 목록 조회
+     */
+    listHooks(point?: HookPoint): Array<{
+        point: HookPoint;
+        name: string;
+        mode: HookMode;
+        priority: number;
+    }>;
+    /**
+     * 디버그 정보 출력
+     */
+    debug(): void;
+}
+/**
+ * 전역 HookManager 인스턴스
+ */
+export declare const hooks: HookManager;
+/**
+ * HookManager 인스턴스 획득
+ */
+export declare function getHookManager(): HookManager;
+/**
+ * HookManager 인스턴스 리셋 (테스트용)
+ */
+export declare function resetHookManager(): void;