@su-record/vibe 2.7.2 → 2.7.5

package/dist/orchestrator/SmartRouter.js

@@ -0,0 +1,305 @@
+/**
+ * SmartRouter - LLM 스마트 라우팅 및 fallback 관리
+ * orchestrator.ts에서 추출된 라우팅 전용 모듈
+ */
+import { TASK_LLM_PRIORITY } from './types.js';
+import * as gptApi from '../lib/gpt-api.js';
+import * as geminiApi from '../lib/gemini-api.js';
+import * as azApi from '../lib/az-api.js';
+import * as kimiApi from '../lib/kimi-api.js';
+import { loadPriorityConfig } from '../lib/priority-config.js';
+import { debugLog } from '../lib/utils.js';
+// LLM 가용성 캐시 (5분 TTL)
+const LLM_CACHE_TTL = 5 * 60 * 1000;
+// 프로바이더별 timeout (30초)
+const PROVIDER_TIMEOUT_MS = 30_000;
+/**
+ * AllProvidersFailedError - 모든 LLM 프로바이더 실패 시 throw
+ */
+export class AllProvidersFailedError extends Error {
+    attemptedProviders;
+    errors;
+    duration;
+    constructor(attemptedProviders, errors, duration) {
+        const lastProvider = attemptedProviders[attemptedProviders.length - 1];
+        const lastError = lastProvider ? errors[lastProvider] : 'No providers attempted';
+        super(`All LLM providers failed. Last error (${lastProvider}): ${lastError}`);
+        this.name = 'AllProvidersFailedError';
+        this.attemptedProviders = attemptedProviders;
+        this.errors = errors;
+        this.duration = duration;
+    }
+}
+/**
+ * SmartRouter - Task 유형별 최적 LLM 선택 + fallback chain
+ */
+const PRIORITY_CONFIG_CACHE_TTL = 60_000; // 1분
+export class SmartRouter {
+    cache;
+    verbose;
+    priorityConfigCache = null;
+    constructor(options = {}) {
+        this.verbose = options.verbose ?? false;
+        this.cache = {
+            gpt: { available: true, checkedAt: 0, errorCount: 0 },
+            gemini: { available: true, checkedAt: 0, errorCount: 0 },
+            az: { available: true, checkedAt: 0, errorCount: 0 },
+            kimi: { available: true, checkedAt: 0, errorCount: 0 }
+        };
+    }
+    /**
+     * 스마트 라우팅 - 작업 유형에 따라 최적의 LLM 선택 + fallback
+     */
+    async route(request) {
+        const startTime = Date.now();
+        const { type, prompt, systemPrompt = 'You are a helpful assistant.', preferredLlm, maxRetries = 2 } = request;
+        // LLM 우선순위 결정
+        const providers = this.getProviderPriority(type, preferredLlm);
+        const attemptedProviders = [];
+        const errors = {};
+        // 각 LLM 순차 시도 (fallback chain)
+        for (const provider of providers) {
+            if (this.isUnavailable(provider)) {
+                if (this.verbose) {
+                    debugLog(`[SmartRouter] Skipping ${provider} (recently failed)`);
+                }
+                continue;
+            }
+            attemptedProviders.push(provider);
+            // 재시도 로직
+            for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                try {
+                    const content = await this.callLlmWithTimeout(provider, prompt, systemPrompt);
+                    this.markAvailable(provider);
+                    return {
+                        content,
+                        provider,
+                        success: true,
+                        usedFallback: attemptedProviders.length > 1,
+                        attemptedProviders,
+                        duration: Date.now() - startTime
+                    };
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    errors[provider] = errorMsg;
+                    if (this.verbose) {
+                        debugLog(`[SmartRouter] ${provider} attempt ${attempt + 1} failed: ${errorMsg}`);
+                    }
+                    if (this.shouldSkipRetry(errorMsg)) {
+                        this.markUnavailable(provider);
+                        break;
+                    }
+                    if (attempt < maxRetries) {
+                        await this.delay(1000 * (attempt + 1));
+                    }
+                }
+            }
+            this.markUnavailable(provider);
+        }
+        // 모든 외부 LLM 실패 - AllProvidersFailedError throw
+        throw new AllProvidersFailedError(attemptedProviders, errors, Date.now() - startTime);
+    }
+    /**
+     * LLM 우선순위 결정
+     * priority config에 따라 az/kimi 순서를 동적으로 조정
+     */
+    getProviderPriority(type, preferredLlm) {
+        if (preferredLlm) {
+            const others = TASK_LLM_PRIORITY[type].filter(p => p !== preferredLlm);
+            return [preferredLlm, ...others];
+        }
+        const providers = [...TASK_LLM_PRIORITY[type]];
+        // priority config에 따라 az/kimi 순서 조정 (캐시 사용)
+        try {
+            const priorityConfig = this.getCachedPriorityConfig();
+            if (priorityConfig.kimi[0] === 'kimi') {
+                // Kimi Direct 우선: kimi를 az 앞으로 이동
+                const azIdx = providers.indexOf('az');
+                const kimiIdx = providers.indexOf('kimi');
+                if (azIdx >= 0 && kimiIdx >= 0 && kimiIdx > azIdx) {
+                    providers.splice(kimiIdx, 1);
+                    providers.splice(azIdx, 0, 'kimi');
+                }
+            }
+        }
+        catch { /* priority config 실패 시 기본 순서 유지 */ }
+        return providers;
+    }
+    /**
+     * LLM 호출 with timeout (프로바이더당 30초)
+     */
+    async callLlmWithTimeout(provider, prompt, systemPrompt) {
+        let timer;
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error(`Provider ${provider} timeout (${PROVIDER_TIMEOUT_MS / 1000}s)`)), PROVIDER_TIMEOUT_MS);
+        });
+        try {
+            const result = await Promise.race([
+                this.callLlm(provider, prompt, systemPrompt),
+                timeoutPromise
+            ]);
+            return result;
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    /**
+     * LLM 호출
+     */
+    async callLlm(provider, prompt, systemPrompt) {
+        switch (provider) {
+            case 'gpt':
+                return gptApi.coreGptOrchestrate(prompt, systemPrompt, { jsonMode: false });
+            case 'gemini':
+                return geminiApi.coreGeminiOrchestrate(prompt, systemPrompt, { jsonMode: false });
+            case 'az':
+                return azApi.coreAzOrchestrate(prompt, systemPrompt, { jsonMode: false });
+            case 'kimi':
+                return kimiApi.coreKimiOrchestrate(prompt, systemPrompt, { jsonMode: false });
+            case 'claude':
+                throw new Error('Claude fallback - handled by caller');
+            default:
+                throw new Error(`Unknown provider: ${provider}`);
+        }
+    }
+    /**
+     * 재시도 없이 즉시 다음 LLM으로 넘어가야 하는 에러
+     */
+    shouldSkipRetry(errorMsg) {
+        const skipPatterns = [
+            'rate limit', 'quota', 'exhausted', '429', 'usage limit', 'too many requests',
+            'no token', 'token not set', 'no api key', 'api key not set',
+            'missing token', 'missing api key', 'not authenticated',
+            'authentication failed', 'unauthorized', '401', 'auth'
+        ];
+        const lowerMsg = errorMsg.toLowerCase();
+        return skipPatterns.some(pattern => lowerMsg.includes(pattern));
+    }
+    /**
+     * LLM 가용성 확인 (캐시 기반)
+     */
+    isUnavailable(provider) {
+        if (provider === 'claude')
+            return false;
+        const cache = this.cache[provider];
+        const now = Date.now();
+        if (now - cache.checkedAt > LLM_CACHE_TTL) {
+            cache.available = true;
+            cache.errorCount = 0;
+            return false;
+        }
+        return !cache.available || cache.errorCount >= 3;
+    }
+    /**
+     * LLM 가용 상태로 마킹
+     */
+    markAvailable(provider) {
+        if (provider === 'claude')
+            return;
+        this.cache[provider] = {
+            available: true,
+            checkedAt: Date.now(),
+            errorCount: 0
+        };
+    }
+    /**
+     * LLM 불가용 상태로 마킹
+     */
+    markUnavailable(provider) {
+        if (provider === 'claude')
+            return;
+        const cache = this.cache[provider];
+        cache.errorCount++;
+        cache.checkedAt = Date.now();
+        if (cache.errorCount >= 3) {
+            cache.available = false;
+        }
+    }
+    getCachedPriorityConfig() {
+        const now = Date.now();
+        if (this.priorityConfigCache && now - this.priorityConfigCache.cachedAt < PRIORITY_CONFIG_CACHE_TTL) {
+            return this.priorityConfigCache.config;
+        }
+        const config = loadPriorityConfig();
+        this.priorityConfigCache = { config, cachedAt: now };
+        return config;
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    // ============================================
+    // Convenience Methods (Smart* shortcuts)
+    // ============================================
+    async webSearch(query) {
+        return this.route({
+            type: 'web-search',
+            prompt: query,
+            systemPrompt: 'Search the web and provide relevant information.'
+        });
+    }
+    async architectureReview(prompt) {
+        return this.route({
+            type: 'architecture',
+            prompt,
+            systemPrompt: 'You are a software architect. Analyze and review the architecture.'
+        });
+    }
+    async uiuxReview(prompt) {
+        return this.route({
+            type: 'uiux',
+            prompt,
+            systemPrompt: 'You are a UI/UX expert. Analyze and provide feedback.'
+        });
+    }
+    async codeAnalysis(prompt) {
+        return this.route({
+            type: 'code-analysis',
+            prompt,
+            systemPrompt: 'You are a code analysis expert. Review and analyze the code.'
+        });
+    }
+    async debugging(prompt) {
+        return this.route({
+            type: 'debugging',
+            prompt,
+            systemPrompt: 'You are a debugging expert. Find bugs and suggest fixes.'
+        });
+    }
+    async codeGen(description, context) {
+        const prompt = context ? `${description}\n\nContext:\n${context}` : description;
+        return this.route({
+            type: 'code-gen',
+            prompt,
+            systemPrompt: 'Generate clean, well-documented code.'
+        });
+    }
+    /**
+     * 캐시 상태 조회 (디버깅용)
+     */
+    getCacheStatus() {
+        return { ...this.cache };
+    }
+    /**
+     * 캐시 초기화
+     */
+    resetCache() {
+        this.cache = {
+            gpt: { available: true, checkedAt: 0, errorCount: 0 },
+            gemini: { available: true, checkedAt: 0, errorCount: 0 },
+            az: { available: true, checkedAt: 0, errorCount: 0 },
+            kimi: { available: true, checkedAt: 0, errorCount: 0 }
+        };
+    }
+}
+// 싱글톤 인스턴스
+let defaultRouter = null;
+export function getSmartRouter(options) {
+    if (!defaultRouter || options) {
+        defaultRouter = new SmartRouter(options);
+    }
+    return defaultRouter;
+}
+//# sourceMappingURL=SmartRouter.js.map

package/dist/orchestrator/SmartRouter.js.map

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

package/dist/orchestrator/SwarmOrchestrator.d.ts

@@ -0,0 +1,144 @@
+/**
+ * SwarmOrchestrator - 에이전트 자가 복제 패턴 (Swarm Pattern)
+ * v2.7.0: 복잡한 작업을 자동으로 분할하여 병렬 처리
+ *
+ * SKILL.md 참조: Claude Code의 Swarm 패턴을 Core 자체 구현으로 재현
+ * - 에이전트가 "너무 복잡하다" 판단 시 하위 에이전트 동적 생성
+ * - 기존 launch()/poll() 인프라 활용
+ * - Claude Code + Cursor IDE 모두 지원 (플랫폼 독립)
+ */
+import { ToolResult } from '../types/tool.js';
+import type { AgentResult, ClaudeModel } from './types.js';
+/** Swarm 설정 */
+export interface SwarmConfig {
+    /** 루트 프롬프트 */
+    prompt: string;
+    /** 에이전트 이름 (선택) */
+    agentName?: string;
+    /** 모델 (기본: sonnet) */
+    model?: ClaudeModel;
+    /** 최대 분할 깊이 (기본: 2) */
+    maxDepth?: number;
+    /** 복잡도 임계값 - 이 이상이면 분할 (기본: 15) */
+    splitThreshold?: number;
+    /** 최대 동시 하위 에이전트 수 (기본: 5) */
+    maxConcurrentChildren?: number;
+    /** 분할 시 콜백 */
+    onSplit?: (task: SwarmTask) => void;
+    /** 완료 시 콜백 */
+    onComplete?: (task: SwarmTask, result: AgentResult) => void;
+    /** 프로젝트 경로 */
+    projectPath?: string;
+    /** 타임아웃 (ms, 기본: 5분) */
+    timeout?: number;
+}
+/** Swarm 작업 */
+export interface SwarmTask {
+    id: string;
+    parentId: string | null;
+    prompt: string;
+    depth: number;
+    status: 'pending' | 'analyzing' | 'running' | 'splitting' | 'completed' | 'failed';
+    complexity?: number;
+    children: string[];
+    taskId?: string;
+    result?: AgentResult;
+    error?: string;
+    createdAt: number;
+    startedAt?: number;
+    completedAt?: number;
+}
+/** Swarm 결과 */
+export interface SwarmResult {
+    rootTaskId: string;
+    tasks: SwarmTask[];
+    totalDuration: number;
+    splitCount: number;
+    successCount: number;
+    failureCount: number;
+    maxDepthReached: number;
+    mergedResult: string;
+}
+/** 복잡도 분석 결과 */
+interface ComplexityAnalysis {
+    score: number;
+    factors: string[];
+    suggestedSplits?: string[];
+}
+export declare class SwarmOrchestrator {
+    private tasks;
+    private config;
+    private startTime;
+    constructor(config: SwarmConfig);
+    /**
+     * Swarm 실행
+     */
+    execute(): Promise<SwarmResult>;
+    /**
+     * 태스크 처리
+     */
+    private processTask;
+    /**
+     * 복잡도 분석
+     */
+    private analyzeComplexity;
+    /**
+     * 분할 제안 생성
+     */
+    private suggestSplits;
+    /**
+     * 분할 여부 결정
+     */
+    private shouldSplit;
+    /**
+     * 태스크 분할
+     */
+    private splitTask;
+    /**
+     * 하위 프롬프트 생성
+     */
+    private createChildPrompt;
+    /**
+     * 하위 결과 병합
+     */
+    private mergeChildResults;
+    /**
+     * 태스크 실행 (분할 없이)
+     */
+    private executeTask;
+    /**
+     * 결과 수집
+     */
+    private collectResults;
+    /**
+     * 태스크 생성
+     */
+    private createTask;
+    private sleep;
+}
+/**
+ * Swarm 패턴으로 복잡한 작업 실행
+ *
+ * @example
+ * import { swarm } from '@su-record/core/orchestrator';
+ *
+ * const result = await swarm({
+ *   prompt: 'Implement login feature with: 1. UI form 2. Validation 3. API call 4. Error handling',
+ *   maxDepth: 2,
+ *   splitThreshold: 15,
+ *   onSplit: (task) => console.log(`Splitting: ${task.id}`),
+ * });
+ */
+export declare function swarm(config: SwarmConfig): Promise<ToolResult & {
+    swarmResult: SwarmResult;
+}>;
+/**
+ * 작업 복잡도 분석 (swarm 없이)
+ *
+ * @example
+ * const analysis = analyzeTaskComplexity('Implement login with validation and error handling');
+ * console.log(analysis.score); // 15
+ */
+export declare function analyzeTaskComplexity(prompt: string): ComplexityAnalysis;
+export {};
+//# sourceMappingURL=SwarmOrchestrator.d.ts.map

package/dist/orchestrator/SwarmOrchestrator.d.ts.map

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