@su-record/vibe 2.5.21 → 2.6.1

package/dist/orchestrator/BackgroundManager.js

@@ -0,0 +1,456 @@
+/**
+ * BackgroundManager - Fire-and-forget 패턴 기반 백그라운드 에이전트 매니저
+ * v2.6.0: Concurrency Manager + TaskQueue 도입
+ */
+import { CONCURRENCY, DEFAULT_MODELS } from '../lib/constants.js';
+import { warnLog } from '../lib/utils.js';
+import { launchBackgroundAgent } from './AgentExecutor.js';
+// ============================================
+// Error Types (SPEC Error Taxonomy)
+// ============================================
+/** 큐 용량 초과 에러 */
+export class QueueOverflowError extends Error {
+    constructor(queueSize, maxSize) {
+        super(`Queue overflow: ${queueSize}/${maxSize}. Retry later.`);
+        this.name = 'QueueOverflowError';
+    }
+}
+/** 개별 태스크 타임아웃 에러 */
+export class TaskTimeoutError extends Error {
+    constructor(taskId, timeout) {
+        super(`Task "${taskId}" exceeded timeout: ${timeout}ms`);
+        this.name = 'TaskTimeoutError';
+    }
+}
+/** 전체 파이프라인 타임아웃 에러 */
+export class PipelineTimeoutError extends Error {
+    constructor(timeout) {
+        super(`Pipeline exceeded timeout: ${timeout}ms`);
+        this.name = 'PipelineTimeoutError';
+    }
+}
+/** Agent 실행 실패 에러 */
+export class AgentExecutionError extends Error {
+    constructor(agentName, reason) {
+        super(`Agent "${agentName}" execution failed: ${reason}`);
+        this.name = 'AgentExecutionError';
+    }
+}
+// ============================================
+// ConcurrencyManager - 동시 실행 제한 관리
+// ============================================
+class ConcurrencyManager {
+    runningByModel = new Map();
+    runningByProvider = new Map();
+    /** 실행 가능 여부 확인 */
+    canRun(model, provider) {
+        const modelLimit = this.getModelLimit(model);
+        const providerLimit = this.getProviderLimit(provider);
+        const currentModel = this.runningByModel.get(model) || 0;
+        const currentProvider = this.runningByProvider.get(provider) || 0;
+        return currentModel < modelLimit && currentProvider < providerLimit;
+    }
+    /** 실행 시작 (슬롯 획득) */
+    acquire(model, provider) {
+        const currentModel = this.runningByModel.get(model) || 0;
+        const currentProvider = this.runningByProvider.get(provider) || 0;
+        this.runningByModel.set(model, currentModel + 1);
+        this.runningByProvider.set(provider, currentProvider + 1);
+    }
+    /** 실행 종료 (슬롯 반환) */
+    release(model, provider) {
+        const currentModel = this.runningByModel.get(model) || 0;
+        const currentProvider = this.runningByProvider.get(provider) || 0;
+        if (currentModel > 0)
+            this.runningByModel.set(model, currentModel - 1);
+        if (currentProvider > 0)
+            this.runningByProvider.set(provider, currentProvider - 1);
+    }
+    /** 모델별 제한 조회 */
+    getModelLimit(model) {
+        return CONCURRENCY.MODEL_LIMITS[model] ?? CONCURRENCY.MODEL_LIMITS['default'];
+    }
+    /** 프로바이더별 제한 조회 */
+    getProviderLimit(provider) {
+        return CONCURRENCY.PROVIDER_LIMITS[provider] ?? CONCURRENCY.PROVIDER_LIMITS['default'];
+    }
+    /** 현재 상태 조회 */
+    getStatus() {
+        return {
+            byModel: Object.fromEntries(this.runningByModel),
+            byProvider: Object.fromEntries(this.runningByProvider)
+        };
+    }
+}
+// ============================================
+// TaskQueue - Bounded Queue with Backpressure
+// ============================================
+class TaskQueue {
+    queue = [];
+    maxSize;
+    constructor(maxSize = CONCURRENCY.QUEUE_MAX_SIZE) {
+        this.maxSize = maxSize;
+    }
+    /** 큐에 추가 (backpressure 적용) */
+    enqueue(task) {
+        if (this.queue.length >= this.maxSize) {
+            throw new QueueOverflowError(this.queue.length, this.maxSize);
+        }
+        this.queue.push(task);
+    }
+    /** 다음 대기 중인 태스크 조회 */
+    peek() {
+        return this.queue.find(t => t.status === 'pending');
+    }
+    /** 다음 대기 중인 태스크 제거 및 반환 */
+    dequeue() {
+        const index = this.queue.findIndex(t => t.status === 'pending');
+        if (index === -1)
+            return undefined;
+        return this.queue[index];
+    }
+    /** 큐 사이즈 */
+    get size() {
+        return this.queue.filter(t => t.status === 'pending').length;
+    }
+    /** 전체 태스크 수 */
+    get totalSize() {
+        return this.queue.length;
+    }
+    /** 큐가 비었는지 확인 */
+    isEmpty() {
+        return this.size === 0;
+    }
+    /** 큐가 가득 찼는지 확인 */
+    isFull() {
+        return this.queue.length >= this.maxSize;
+    }
+    /** 태스크 조회 */
+    get(taskId) {
+        return this.queue.find(t => t.id === taskId);
+    }
+    /** 완료된 태스크 정리 (24시간 후) */
+    cleanup() {
+        const cutoff = Date.now() - 24 * 60 * 60 * 1000;
+        const before = this.queue.length;
+        this.queue = this.queue.filter(t => {
+            if (t.status === 'pending' || t.status === 'running')
+                return true;
+            return (t.completedAt || t.createdAt) > cutoff;
+        });
+        return before - this.queue.length;
+    }
+    /** 통계 */
+    getStats() {
+        const stats = {
+            total: this.queue.length,
+            pending: 0,
+            running: 0,
+            completed: 0,
+            failed: 0,
+            cancelled: 0,
+            queueSize: this.size,
+            maxQueueSize: this.maxSize
+        };
+        for (const task of this.queue) {
+            stats[task.status]++;
+        }
+        return stats;
+    }
+    /** 모든 태스크 */
+    getAll() {
+        return [...this.queue];
+    }
+}
+// ============================================
+// BackgroundManager - 메인 클래스
+// ============================================
+class BackgroundManagerImpl {
+    concurrency = new ConcurrencyManager();
+    taskQueue = new TaskQueue();
+    tasks = new Map();
+    processing = false;
+    cleanupTimer = null;
+    constructor() {
+        this.startCleanupTimer();
+    }
+    startCleanupTimer() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => {
+            const cleaned = this.taskQueue.cleanup();
+            if (cleaned > 0) {
+                warnLog(`[BackgroundManager] Cleaned up ${cleaned} old tasks`);
+            }
+        }, 10 * 60 * 1000); // 10분마다
+        if (this.cleanupTimer.unref) {
+            this.cleanupTimer.unref();
+        }
+    }
+    /**
+     * Fire-and-forget 방식으로 백그라운드 에이전트 시작
+     * 즉시 handle 반환 (< 100ms)
+     */
+    launch(args) {
+        const taskId = `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const model = args.model || DEFAULT_MODELS.BACKGROUND;
+        const provider = this.extractProvider(model);
+        const task = {
+            id: taskId,
+            args,
+            status: 'pending',
+            createdAt: Date.now(),
+            model,
+            provider
+        };
+        try {
+            this.taskQueue.enqueue(task);
+            this.tasks.set(taskId, task);
+        }
+        catch (error) {
+            if (error instanceof QueueOverflowError) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ ${error.message}`
+                        }],
+                    taskId,
+                    isError: true
+                };
+            }
+            throw error;
+        }
+        // 비동기로 큐 처리 시작 (fire-and-forget)
+        this.processQueue().catch(err => {
+            warnLog(`[BackgroundManager] Queue processing error: ${err.message}`);
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: `🚀 Task queued: ${taskId}\nAgent: ${args.agentName || 'unnamed'}\nModel: ${model}\nQueue position: ${this.taskQueue.size}\n\nUse poll("${taskId}") to check status.`
+                }],
+            taskId
+        };
+    }
+    /**
+     * 결과 폴링 (비동기)
+     */
+    async poll(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return {
+                content: [{ type: 'text', text: `Task "${taskId}" not found` }]
+            };
+        }
+        switch (task.status) {
+            case 'pending':
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `⏳ Task "${taskId}" is pending\nQueue position: ${this.getQueuePosition(taskId)}`
+                        }],
+                    task
+                };
+            case 'running':
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `🔄 Task "${taskId}" is running\nStarted: ${new Date(task.startedAt).toISOString()}`
+                        }],
+                    task
+                };
+            case 'completed':
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `✅ Task "${taskId}" completed\nDuration: ${this.formatDuration(task)}\n\nResult:\n${task.result?.result || 'No result'}`
+                        }],
+                    task,
+                    result: task.result
+                };
+            case 'failed':
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ Task "${taskId}" failed\nError: ${task.error || 'Unknown error'}`
+                        }],
+                    task
+                };
+            case 'cancelled':
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `🚫 Task "${taskId}" was cancelled`
+                        }],
+                    task
+                };
+        }
+    }
+    /**
+     * 태스크 취소
+     */
+    cancel(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return {
+                content: [{ type: 'text', text: `Task "${taskId}" not found` }]
+            };
+        }
+        if (task.status !== 'pending' && task.status !== 'running') {
+            return {
+                content: [{ type: 'text', text: `Task "${taskId}" is already ${task.status}` }]
+            };
+        }
+        if (task.handle) {
+            task.handle.cancel();
+        }
+        task.status = 'cancelled';
+        task.completedAt = Date.now();
+        return {
+            content: [{ type: 'text', text: `Task "${taskId}" cancelled` }]
+        };
+    }
+    /**
+     * 통계 조회
+     */
+    getStats() {
+        const stats = this.taskQueue.getStats();
+        const concurrencyStatus = this.concurrency.getStatus();
+        let text = `## BackgroundManager Stats\n\n`;
+        text += `**Queue**: ${stats.queueSize}/${stats.maxQueueSize}\n`;
+        text += `**Total tasks**: ${stats.total}\n`;
+        text += `- Pending: ${stats.pending}\n`;
+        text += `- Running: ${stats.running}\n`;
+        text += `- Completed: ${stats.completed}\n`;
+        text += `- Failed: ${stats.failed}\n`;
+        text += `- Cancelled: ${stats.cancelled}\n\n`;
+        text += `**Concurrency**:\n`;
+        text += `- By Model: ${JSON.stringify(concurrencyStatus.byModel)}\n`;
+        text += `- By Provider: ${JSON.stringify(concurrencyStatus.byProvider)}\n`;
+        return {
+            content: [{ type: 'text', text }],
+            stats
+        };
+    }
+    /**
+     * 큐 처리 (내부)
+     */
+    async processQueue() {
+        if (this.processing)
+            return;
+        this.processing = true;
+        try {
+            while (!this.taskQueue.isEmpty()) {
+                const task = this.taskQueue.peek();
+                if (!task)
+                    break;
+                if (!this.concurrency.canRun(task.model, task.provider)) {
+                    await this.sleep(100);
+                    continue;
+                }
+                task.status = 'running';
+                task.startedAt = Date.now();
+                this.concurrency.acquire(task.model, task.provider);
+                // Fire-and-forget 실행
+                this.executeTask(task).catch(err => {
+                    warnLog(`[BackgroundManager] Task ${task.id} error: ${err.message}`);
+                });
+            }
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    /**
+     * 태스크 실행 (내부)
+     */
+    async executeTask(task) {
+        const timeout = CONCURRENCY.TASK_TIMEOUT;
+        const timeoutId = setTimeout(() => {
+            if (task.status === 'running') {
+                task.status = 'failed';
+                task.error = new TaskTimeoutError(task.id, timeout).message;
+                task.completedAt = Date.now();
+                this.concurrency.release(task.model, task.provider);
+                warnLog(`[BackgroundManager] Task ${task.id} timed out`);
+            }
+        }, timeout);
+        try {
+            const result = await launchBackgroundAgent(task.args);
+            const handle = result.handle;
+            if (handle) {
+                task.handle = handle;
+                const agentResult = await handle.getResult();
+                task.result = agentResult;
+                task.status = agentResult.success ? 'completed' : 'failed';
+                if (!agentResult.success) {
+                    task.error = agentResult.error;
+                }
+            }
+            else {
+                task.status = 'failed';
+                task.error = 'No handle returned';
+            }
+        }
+        catch (error) {
+            task.status = 'failed';
+            task.error = error instanceof Error ? error.message : String(error);
+            warnLog(`[BackgroundManager] Task ${task.id} failed: ${task.error}`);
+        }
+        finally {
+            clearTimeout(timeoutId);
+            task.completedAt = Date.now();
+            this.concurrency.release(task.model, task.provider);
+            // 큐에 대기 중인 태스크가 있으면 계속 처리
+            if (!this.taskQueue.isEmpty()) {
+                this.processQueue().catch(() => { });
+            }
+        }
+    }
+    extractProvider(model) {
+        if (model.startsWith('claude'))
+            return 'claude';
+        if (model.startsWith('gpt'))
+            return 'gpt';
+        if (model.startsWith('gemini'))
+            return 'gemini';
+        return 'default';
+    }
+    getQueuePosition(taskId) {
+        const all = this.taskQueue.getAll();
+        let position = 0;
+        for (const task of all) {
+            if (task.status === 'pending') {
+                position++;
+                if (task.id === taskId)
+                    return position;
+            }
+        }
+        return -1;
+    }
+    formatDuration(task) {
+        if (!task.startedAt || !task.completedAt)
+            return 'N/A';
+        const ms = task.completedAt - task.startedAt;
+        return `${(ms / 1000).toFixed(1)}s`;
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+// 싱글톤 인스턴스
+export const backgroundManager = new BackgroundManagerImpl();
+// 편의 함수
+export function launch(args) {
+    return backgroundManager.launch(args);
+}
+export function poll(taskId) {
+    return backgroundManager.poll(taskId);
+}
+export function cancel(taskId) {
+    return backgroundManager.cancel(taskId);
+}
+export function getStats() {
+    return backgroundManager.getStats();
+}
+//# sourceMappingURL=BackgroundManager.js.map

package/dist/orchestrator/BackgroundManager.js.map

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

package/dist/orchestrator/BackgroundManager.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * BackgroundManager Tests
+ * Fire-and-forget pattern, Concurrency control, TaskQueue
+ */
+export {};
+//# sourceMappingURL=BackgroundManager.test.d.ts.map

package/dist/orchestrator/BackgroundManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundManager.test.d.ts","sourceRoot":"","sources":["../../src/orchestrator/BackgroundManager.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/orchestrator/BackgroundManager.test.js

@@ -0,0 +1,162 @@
+/**
+ * BackgroundManager Tests
+ * Fire-and-forget pattern, Concurrency control, TaskQueue
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { launch, poll, cancel, getStats, QueueOverflowError, TaskTimeoutError, PipelineTimeoutError, AgentExecutionError, } from './BackgroundManager.js';
+// Mock the AgentExecutor
+vi.mock('./AgentExecutor.js', () => ({
+    launchBackgroundAgent: vi.fn().mockResolvedValue({
+        content: [{ type: 'text', text: 'Mocked' }],
+        handle: {
+            getResult: vi.fn().mockResolvedValue({
+                success: true,
+                result: 'Test result',
+            }),
+            cancel: vi.fn(),
+        },
+    }),
+}));
+describe('BackgroundManager', () => {
+    describe('Error Classes', () => {
+        it('should create QueueOverflowError with correct message', () => {
+            const error = new QueueOverflowError(100, 100);
+            expect(error.name).toBe('QueueOverflowError');
+            expect(error.message).toContain('Queue overflow');
+            expect(error.message).toContain('100/100');
+        });
+        it('should create TaskTimeoutError with correct message', () => {
+            const error = new TaskTimeoutError('task-123', 180000);
+            expect(error.name).toBe('TaskTimeoutError');
+            expect(error.message).toContain('task-123');
+            expect(error.message).toContain('180000ms');
+        });
+        it('should create PipelineTimeoutError with correct message', () => {
+            const error = new PipelineTimeoutError(600000);
+            expect(error.name).toBe('PipelineTimeoutError');
+            expect(error.message).toContain('600000ms');
+        });
+        it('should create AgentExecutionError with correct message', () => {
+            const error = new AgentExecutionError('test-agent', 'connection failed');
+            expect(error.name).toBe('AgentExecutionError');
+            expect(error.message).toContain('test-agent');
+            expect(error.message).toContain('connection failed');
+        });
+    });
+    describe('launch()', () => {
+        it('should return taskId immediately (fire-and-forget)', () => {
+            const result = launch({
+                prompt: 'Test task',
+                agentName: 'test-agent',
+            });
+            expect(result.taskId).toBeDefined();
+            expect(result.taskId).toMatch(/^task-\d+-[a-z0-9]+$/);
+            expect(result.content[0].text).toContain('Task queued');
+        });
+        it('should include agent name in response', () => {
+            const result = launch({
+                prompt: 'Test task',
+                agentName: 'my-special-agent',
+            });
+            expect(result.content[0].text).toContain('my-special-agent');
+        });
+        it('should include model information', () => {
+            const result = launch({
+                prompt: 'Test task',
+                agentName: 'test-agent',
+                model: 'claude-sonnet-4-5',
+            });
+            expect(result.content[0].text).toContain('claude-sonnet-4-5');
+        });
+    });
+    describe('poll()', () => {
+        it('should return task not found for invalid taskId', async () => {
+            const result = await poll('non-existent-task');
+            expect(result.content[0].text).toContain('not found');
+        });
+        it('should return pending status for queued task', async () => {
+            const launchResult = launch({
+                prompt: 'Pending task',
+                agentName: 'test-agent',
+            });
+            const pollResult = await poll(launchResult.taskId);
+            expect(pollResult.task).toBeDefined();
+            // Task could be pending or running depending on timing
+            expect(['pending', 'running', 'completed']).toContain(pollResult.task?.status);
+        });
+    });
+    describe('cancel()', () => {
+        it('should return not found for invalid taskId', () => {
+            const result = cancel('non-existent-task');
+            expect(result.content[0].text).toContain('not found');
+        });
+        it('should cancel a pending task', async () => {
+            const launchResult = launch({
+                prompt: 'Task to cancel',
+                agentName: 'test-agent',
+            });
+            const cancelResult = cancel(launchResult.taskId);
+            // Could be cancelled or already running/completed
+            expect(cancelResult.content[0].text).toMatch(/cancelled|already/);
+        });
+    });
+    describe('getStats()', () => {
+        it('should return queue statistics', () => {
+            const result = getStats();
+            expect(result.stats).toBeDefined();
+            expect(result.stats.maxQueueSize).toBe(100);
+            expect(typeof result.stats.total).toBe('number');
+            expect(typeof result.stats.pending).toBe('number');
+            expect(typeof result.stats.running).toBe('number');
+            expect(typeof result.stats.completed).toBe('number');
+            expect(typeof result.stats.failed).toBe('number');
+            expect(typeof result.stats.cancelled).toBe('number');
+        });
+        it('should include formatted text output', () => {
+            const result = getStats();
+            expect(result.content[0].text).toContain('BackgroundManager Stats');
+            expect(result.content[0].text).toContain('Queue');
+            expect(result.content[0].text).toContain('Concurrency');
+        });
+    });
+    describe('Concurrency Control', () => {
+        it('should respect model limits', () => {
+            // Launch multiple tasks
+            const tasks = [];
+            for (let i = 0; i < 5; i++) {
+                tasks.push(launch({
+                    prompt: `Concurrent task ${i}`,
+                    agentName: `agent-${i}`,
+                    model: 'claude-opus-4',
+                }));
+            }
+            // All should be queued successfully
+            expect(tasks.every(t => t.taskId)).toBe(true);
+        });
+    });
+});
+describe('TaskQueue', () => {
+    describe('bounded queue behavior', () => {
+        it('should track queue size', () => {
+            const stats = getStats();
+            expect(stats.stats.queueSize).toBeGreaterThanOrEqual(0);
+            expect(stats.stats.maxQueueSize).toBe(100);
+        });
+    });
+});
+describe('Integration', () => {
+    it('should complete full task lifecycle', async () => {
+        // Launch
+        const launchResult = launch({
+            prompt: 'Integration test task',
+            agentName: 'integration-agent',
+        });
+        expect(launchResult.taskId).toBeDefined();
+        // Wait for completion
+        await new Promise(resolve => setTimeout(resolve, 100));
+        // Poll for result
+        const pollResult = await poll(launchResult.taskId);
+        expect(pollResult.task).toBeDefined();
+    });
+});
+//# sourceMappingURL=BackgroundManager.test.js.map

package/dist/orchestrator/BackgroundManager.test.js.map

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