@litmers/cursorflow-orchestrator 0.1.40 → 0.2.2

package/dist/hooks/contexts/index.d.ts

@@ -0,0 +1,104 @@
+/**
+ * CursorFlow Hook System - Context Builders
+ *
+ * 각 Hook Point에 대한 컨텍스트를 생성하는 빌더 함수들입니다.
+ */
+import { BeforeTaskContext, AfterTaskContext, OnErrorContext, OnStallContext, OnLaneEndContext, TaskDefinition, TaskResult, DependencyResult } from '../types';
+import { FlowControllerImpl } from '../flow-controller';
+export interface BaseContextOptions {
+    /** Lane 이름 */
+    laneName: string;
+    /** Run ID */
+    runId: string;
+    /** 현재 태스크 인덱스 */
+    taskIndex: number;
+    /** 전체 태스크 수 */
+    totalTasks: number;
+    /** 현재 태스크 */
+    task: {
+        name: string;
+        prompt: string;
+        model: string;
+        dependsOn?: string[];
+    };
+    /** Worktree 디렉토리 */
+    worktreeDir: string;
+    /** Run 디렉토리 */
+    runDir: string;
+    /** 태스크 브랜치 */
+    taskBranch: string;
+    /** 파이프라인 브랜치 */
+    pipelineBranch: string;
+    /** 태스크 파일 경로 */
+    tasksFile: string;
+    /** Chat ID */
+    chatId: string;
+    /** 태스크 목록 (수정 가능 참조) */
+    tasks: TaskDefinition[];
+    /** 완료된 태스크 목록 */
+    completedTasks: TaskResult[];
+    /** 의존성 결과 */
+    dependencyResults: DependencyResult[];
+    /** 태스크 시작 시간 */
+    taskStartTime: number;
+    /** Lane 시작 시간 */
+    laneStartTime: number;
+    /** AgentSupervisor 인스턴스 */
+    agentSupervisor?: any;
+    /** Run Root */
+    runRoot?: string;
+}
+/**
+ * beforeTask 컨텍스트 생성
+ */
+export declare function createBeforeTaskContext(options: BaseContextOptions): {
+    context: BeforeTaskContext;
+    flowController: FlowControllerImpl;
+};
+/**
+ * afterTask 컨텍스트 생성
+ */
+export declare function createAfterTaskContext(options: BaseContextOptions, result: {
+    status: 'success' | 'error' | 'blocked';
+    exitCode?: number;
+    error?: string;
+}): {
+    context: AfterTaskContext;
+    flowController: FlowControllerImpl;
+};
+/**
+ * onError 컨텍스트 생성
+ */
+export declare function createOnErrorContext(options: BaseContextOptions, error: {
+    type: 'agent_error' | 'git_error' | 'timeout' | 'unknown';
+    message: string;
+    stack?: string;
+    retryable: boolean;
+}): {
+    context: OnErrorContext;
+    flowController: FlowControllerImpl;
+};
+/**
+ * onStall 컨텍스트 생성
+ */
+export declare function createOnStallContext(options: BaseContextOptions, stall: {
+    idleTimeMs: number;
+    lastActivity: string;
+    bytesReceived: number;
+    phase: 'initial' | 'warning' | 'critical';
+}): {
+    context: OnStallContext;
+    flowController: FlowControllerImpl;
+};
+/**
+ * onLaneEnd 컨텍스트 생성
+ */
+export declare function createOnLaneEndContext(options: BaseContextOptions, summary: {
+    status: 'completed' | 'failed' | 'aborted';
+    completedTasks: number;
+    failedTasks: number;
+    totalDuration: number;
+}): {
+    context: OnLaneEndContext;
+    flowController: FlowControllerImpl;
+};

package/dist/hooks/contexts/index.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * CursorFlow Hook System - Context Builders
+ *
+ * 각 Hook Point에 대한 컨텍스트를 생성하는 빌더 함수들입니다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBeforeTaskContext = createBeforeTaskContext;
+exports.createAfterTaskContext = createAfterTaskContext;
+exports.createOnErrorContext = createOnErrorContext;
+exports.createOnStallContext = createOnStallContext;
+exports.createOnLaneEndContext = createOnLaneEndContext;
+const data_accessor_1 = require("../data-accessor");
+const flow_controller_1 = require("../flow-controller");
+// ============================================================================
+// Context Builders
+// ============================================================================
+/**
+ * 기본 컨텍스트 생성
+ */
+function createBaseContext(options) {
+    // FlowController 생성
+    const flowControllerOptions = {
+        laneName: options.laneName,
+        runDir: options.runDir,
+        worktreeDir: options.worktreeDir,
+        currentTaskIndex: options.taskIndex,
+        tasks: options.tasks,
+        tasksFile: options.tasksFile,
+        chatId: options.chatId,
+        agentSupervisor: options.agentSupervisor,
+    };
+    const flowController = (0, flow_controller_1.createFlowController)(flowControllerOptions);
+    // DataAccessor 생성
+    const dataAccessorOptions = {
+        worktreeDir: options.worktreeDir,
+        runDir: options.runDir,
+        taskBranch: options.taskBranch,
+        pipelineBranch: options.pipelineBranch,
+        laneName: options.laneName,
+        taskName: options.task.name,
+        completedTasks: options.completedTasks,
+        pendingTasks: options.tasks.slice(options.taskIndex + 1),
+        dependencyResults: options.dependencyResults,
+        taskStartTime: options.taskStartTime,
+        laneStartTime: options.laneStartTime,
+        runRoot: options.runRoot,
+    };
+    const dataAccessor = (0, data_accessor_1.createDataAccessor)(dataAccessorOptions);
+    // 기본 컨텍스트
+    const context = {
+        laneName: options.laneName,
+        runId: options.runId,
+        taskIndex: options.taskIndex,
+        totalTasks: options.totalTasks,
+        task: options.task,
+    };
+    return { context, flowController, dataAccessor };
+}
+/**
+ * beforeTask 컨텍스트 생성
+ */
+function createBeforeTaskContext(options) {
+    const { context, flowController, dataAccessor } = createBaseContext(options);
+    return {
+        context: {
+            ...context,
+            flow: flowController,
+            getData: dataAccessor,
+        },
+        flowController,
+    };
+}
+/**
+ * afterTask 컨텍스트 생성
+ */
+function createAfterTaskContext(options, result) {
+    const { context, flowController, dataAccessor } = createBaseContext(options);
+    return {
+        context: {
+            ...context,
+            flow: flowController,
+            getData: dataAccessor,
+            result,
+        },
+        flowController,
+    };
+}
+/**
+ * onError 컨텍스트 생성
+ */
+function createOnErrorContext(options, error) {
+    const { context, flowController, dataAccessor } = createBaseContext(options);
+    return {
+        context: {
+            ...context,
+            flow: flowController,
+            getData: dataAccessor,
+            error,
+        },
+        flowController,
+    };
+}
+/**
+ * onStall 컨텍스트 생성
+ */
+function createOnStallContext(options, stall) {
+    const { context, flowController, dataAccessor } = createBaseContext(options);
+    return {
+        context: {
+            ...context,
+            flow: flowController,
+            getData: dataAccessor,
+            stall,
+        },
+        flowController,
+    };
+}
+/**
+ * onLaneEnd 컨텍스트 생성
+ */
+function createOnLaneEndContext(options, summary) {
+    const { context, flowController, dataAccessor } = createBaseContext(options);
+    return {
+        context: {
+            ...context,
+            flow: flowController,
+            getData: dataAccessor,
+            summary,
+        },
+        flowController,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/contexts/index.js.map

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

package/dist/hooks/data-accessor.d.ts

@@ -0,0 +1,86 @@
+/**
+ * CursorFlow Hook System - Data Accessor Implementation
+ *
+ * Hook에서 Git, 대화 기록, 로그 등의 데이터에 접근하기 위한 구현체입니다.
+ * 모든 메서드는 Lazy Loading으로 필요할 때만 데이터를 로드합니다.
+ */
+import { HookDataAccessor, ChangedFile, Commit, Message, TaskResult, TaskDefinition, ToolCall, ErrorLog, DependencyResult } from './types';
+export interface DataAccessorOptions {
+    /** Worktree 디렉토리 */
+    worktreeDir: string;
+    /** Run 디렉토리 (로그 파일 위치) */
+    runDir: string;
+    /** 현재 태스크 브랜치 */
+    taskBranch: string;
+    /** 파이프라인 브랜치 */
+    pipelineBranch: string;
+    /** Lane 이름 */
+    laneName: string;
+    /** 현재 태스크 이름 */
+    taskName: string;
+    /** 완료된 태스크 목록 */
+    completedTasks: TaskResult[];
+    /** 남은 태스크 목록 */
+    pendingTasks: TaskDefinition[];
+    /** 의존성 결과 */
+    dependencyResults: DependencyResult[];
+    /** 태스크 시작 시간 */
+    taskStartTime: number;
+    /** Lane 시작 시간 */
+    laneStartTime: number;
+    /** Run Root (lanes 디렉토리의 부모) */
+    runRoot?: string;
+}
+/**
+ * HookDataAccessor 구현체
+ */
+export declare class HookDataAccessorImpl implements HookDataAccessor {
+    private options;
+    private cachedChangedFiles;
+    private cachedDiff;
+    private cachedMessages;
+    private cachedToolCalls;
+    private cachedRawOutput;
+    constructor(options: DataAccessorOptions);
+    git: {
+        getChangedFiles: () => Promise<ChangedFile[]>;
+        getDiff: () => Promise<string>;
+        getRecentCommits: (count?: number) => Promise<Commit[]>;
+        getCurrentBranch: () => string;
+        getConflictFiles: () => Promise<string[]>;
+    };
+    conversation: {
+        getCurrentTaskMessages: () => Promise<Message[]>;
+        getAllMessages: () => Promise<Message[]>;
+        getRecentMessages: (count?: number) => Promise<Message[]>;
+        getLastResponse: () => Promise<string | null>;
+    };
+    tasks: {
+        getCompletedTasks: () => TaskResult[];
+        getPendingTasks: () => TaskDefinition[];
+        getTaskResult: (taskName: string) => TaskResult | null;
+        getDependencyResults: () => DependencyResult[];
+    };
+    logs: {
+        getRawOutput: () => Promise<string>;
+        getToolCalls: () => Promise<ToolCall[]>;
+        getErrors: () => Promise<ErrorLog[]>;
+    };
+    get timing(): {
+        taskStartTime: number;
+        laneStartTime: number;
+        getElapsedTime: () => number;
+    };
+    /**
+     * 캐시 초기화
+     */
+    clearCache(): void;
+    /**
+     * 옵션 업데이트 (태스크 변경 시)
+     */
+    updateOptions(updates: Partial<DataAccessorOptions>): void;
+}
+/**
+ * HookDataAccessor 인스턴스 생성
+ */
+export declare function createDataAccessor(options: DataAccessorOptions): HookDataAccessor;