@su-record/vibe 2.7.2 → 2.7.5

package/dist/orchestrator/agentDiscovery.js

@@ -0,0 +1,175 @@
+/**
+ * Agent Discovery - .claude/agents/ 폴더에서 에이전트 동적 탐색
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { glob } from 'glob';
+import { errorLog } from '../lib/utils.js';
+// 에이전트 디렉토리 우선순위: .claude/agents > agents
+const AGENTS_DIRS = ['.claude/agents', 'agents'];
+/**
+ * 에이전트 마크다운 파일에서 메타데이터 추출
+ */
+function parseAgentMarkdown(content, filePath) {
+    const lines = content.split('\n');
+    let name = path.basename(filePath, '.md');
+    let description = '';
+    // 첫 번째 # 헤더에서 이름 추출
+    for (const line of lines) {
+        if (line.startsWith('# ')) {
+            name = line.slice(2).trim();
+            break;
+        }
+    }
+    // 첫 번째 일반 텍스트 단락에서 설명 추출
+    let inDescription = false;
+    for (const line of lines) {
+        if (line.startsWith('# ') || line.startsWith('## ')) {
+            if (inDescription)
+                break;
+            inDescription = true;
+            continue;
+        }
+        if (inDescription && line.trim() && !line.startsWith('#') && !line.startsWith('```')) {
+            description = line.trim();
+            break;
+        }
+    }
+    return { name, description };
+}
+/**
+ * 카테고리 추출 (폴더명 기반)
+ */
+function extractCategory(filePath, basePath) {
+    const relativePath = path.relative(basePath, filePath);
+    const parts = relativePath.split(path.sep);
+    // agents/review/xxx.md -> review
+    // agents/research/xxx.md -> research
+    if (parts.length > 1) {
+        return parts[0];
+    }
+    return 'general';
+}
+/**
+ * 에이전트 동적 탐색
+ */
+export async function discoverAgents(args) {
+    const { projectPath = process.cwd(), category, pattern } = args;
+    try {
+        // 에이전트 디렉토리 찾기 (우선순위대로)
+        let agentsBasePath = null;
+        for (const dir of AGENTS_DIRS) {
+            const candidatePath = path.join(projectPath, dir);
+            try {
+                await fs.access(candidatePath);
+                agentsBasePath = candidatePath;
+                break;
+            }
+            catch { /* ignore: optional operation */
+                // 다음 경로 시도
+            }
+        }
+        if (!agentsBasePath) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `No agents directory found. Searched: ${AGENTS_DIRS.join(', ')}. Create agents in .claude/agents/ or agents/ folder.`
+                    }]
+            };
+        }
+        // 패턴 구성
+        let searchPattern = '**/*.md';
+        if (category) {
+            searchPattern = `${category}/**/*.md`;
+        }
+        if (pattern) {
+            searchPattern = pattern;
+        }
+        // 에이전트 파일 검색
+        const agentFiles = await glob(searchPattern, {
+            cwd: agentsBasePath,
+            absolute: true
+        });
+        if (agentFiles.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `No agents found matching pattern: ${searchPattern}`
+                    }]
+            };
+        }
+        // 에이전트 정보 수집
+        const agents = [];
+        for (const filePath of agentFiles) {
+            try {
+                const content = await fs.readFile(filePath, 'utf-8');
+                const metadata = parseAgentMarkdown(content, filePath);
+                const agentCategory = extractCategory(filePath, agentsBasePath);
+                agents.push({
+                    name: metadata.name || path.basename(filePath, '.md'),
+                    path: path.relative(projectPath, filePath),
+                    category: agentCategory,
+                    description: metadata.description || '',
+                    content
+                });
+            }
+            catch (error) {
+                // 개별 파일 에러는 무시하고 계속 진행
+                errorLog(`Failed to read agent file: ${filePath}`, error);
+            }
+        }
+        // 카테고리별 그룹핑
+        const byCategory = agents.reduce((acc, agent) => {
+            if (!acc[agent.category]) {
+                acc[agent.category] = [];
+            }
+            acc[agent.category].push(agent);
+            return acc;
+        }, {});
+        // 결과 포맷팅
+        let summary = `## Discovered Agents (${agents.length} total)\n\n`;
+        for (const [cat, catAgents] of Object.entries(byCategory)) {
+            summary += `### ${cat} (${catAgents.length})\n`;
+            for (const agent of catAgents) {
+                summary += `- **${agent.name}**: ${agent.description || 'No description'}\n`;
+                summary += `  Path: ${agent.path}\n`;
+            }
+            summary += '\n';
+        }
+        return {
+            content: [{ type: 'text', text: summary }],
+            agents // 추가 데이터로 에이전트 목록 포함
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to discover agents: ${error instanceof Error ? error.message : String(error)}`
+                }]
+        };
+    }
+}
+/**
+ * 특정 에이전트 로드
+ */
+export async function loadAgent(agentName, projectPath = process.cwd()) {
+    const result = await discoverAgents({ projectPath });
+    if ('agents' in result) {
+        const agents = result.agents;
+        return agents.find(a => a.name.toLowerCase() === agentName.toLowerCase() ||
+            a.path.includes(agentName)) || null;
+    }
+    return null;
+}
+/**
+ * 카테고리별 에이전트 목록
+ */
+export async function listAgentsByCategory(category, projectPath = process.cwd()) {
+    const result = await discoverAgents({ projectPath, category });
+    if ('agents' in result) {
+        return result.agents;
+    }
+    return [];
+}
+//# sourceMappingURL=agentDiscovery.js.map

package/dist/orchestrator/agentDiscovery.js.map

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

package/dist/orchestrator/backgroundAgent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Background Agent - 백그라운드 에이전트 관리
+ *
+ * v2.6.0: 기능이 2개 모듈로 분리됨
+ * - SessionStore: 세션 저장소, 정리, 히스토리 관리
+ * - AgentExecutor: 에이전트 실행 로직
+ *
+ * 이 파일은 하위 호환성을 위해 모든 함수를 re-export
+ */
+export { sessionStore, listActiveSessions, getSessionHistory } from './SessionStore.js';
+export type { SessionData } from './SessionStore.js';
+export { launchBackgroundAgent, getBackgroundAgentResult, cancelBackgroundAgent, launchParallelAgents } from './AgentExecutor.js';
+export { backgroundManager, launch, poll, cancel, getStats, QueueOverflowError, TaskTimeoutError, PipelineTimeoutError, AgentExecutionError } from './BackgroundManager.js';
+export type { TaskStatus, TaskInfo, QueueStats } from './BackgroundManager.js';
+//# sourceMappingURL=backgroundAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundAgent.d.ts","sourceRoot":"","sources":["../../src/orchestrator/backgroundAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/orchestrator/backgroundAgent.js

@@ -0,0 +1,16 @@
+/**
+ * Background Agent - 백그라운드 에이전트 관리
+ *
+ * v2.6.0: 기능이 2개 모듈로 분리됨
+ * - SessionStore: 세션 저장소, 정리, 히스토리 관리
+ * - AgentExecutor: 에이전트 실행 로직
+ *
+ * 이 파일은 하위 호환성을 위해 모든 함수를 re-export
+ */
+// SessionStore
+export { sessionStore, listActiveSessions, getSessionHistory } from './SessionStore.js';
+// AgentExecutor
+export { launchBackgroundAgent, getBackgroundAgentResult, cancelBackgroundAgent, launchParallelAgents } from './AgentExecutor.js';
+// BackgroundManager (v2.6.0)
+export { backgroundManager, launch, poll, cancel, getStats, QueueOverflowError, TaskTimeoutError, PipelineTimeoutError, AgentExecutionError } from './BackgroundManager.js';
+//# sourceMappingURL=backgroundAgent.js.map

package/dist/orchestrator/backgroundAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundAgent.js","sourceRoot":"","sources":["../../src/orchestrator/backgroundAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAe;AACf,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAG3B,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC"}

package/dist/orchestrator/index.d.ts

@@ -0,0 +1,213 @@
+/**
+ * VIBE Orchestrator - Agent SDK 기반 멀티 에이전트 오케스트레이션
+ *
+ * 사용법 (hooks에서):
+ *   node -e "import('@su-record/core/orchestrator').then(o => o.parallelResearch({...})).then(console.log)"
+ *
+ * 사용법 (코드에서):
+ *   import { CoreOrchestrator, parallelResearch } from '@su-record/core/orchestrator';
+ */
+export type { AgentConfig, AgentResult, ResearchTask, ParallelResearchArgs, ParallelResearchResult, BackgroundAgentArgs, BackgroundAgentHandle, DiscoveredAgent, AgentDiscoveryArgs, SessionInfo, OrchestratorOptions, AgentMessage, TaskType, LLMProvider, SmartRouteRequest, SmartRouteResult, LLMAvailabilityCache, MultiLlmResult, MultiLlmResearchResult } from './types.js';
+export { TASK_LLM_PRIORITY } from './types.js';
+export { discoverAgents, loadAgent, listAgentsByCategory } from './agentDiscovery.js';
+export { parallelResearch, researchFeature, createResearchTasks, parallelResearchWithMultiLlm, executeMultiLlmResearch, formatMultiLlmResults } from './parallelResearch.js';
+export { launchBackgroundAgent, getBackgroundAgentResult, cancelBackgroundAgent, listActiveSessions, getSessionHistory, launchParallelAgents, backgroundManager, launch, poll, cancel, getStats, QueueOverflowError, TaskTimeoutError, PipelineTimeoutError, AgentExecutionError } from './backgroundAgent.js';
+export type { TaskStatus, TaskInfo, QueueStats } from './backgroundAgent.js';
+export { CoreOrchestrator, getOrchestrator } from './orchestrator.js';
+export { SmartRouter, SmartRouterOptions, getSmartRouter, AllProvidersFailedError } from './SmartRouter.js';
+export { LLMCluster, LLMClusterOptions, MultiLlmQueryResult, LlmStatusResult, getLLMCluster } from './LLMCluster.js';
+export { AgentManager, AgentManagerOptions, getAgentManager } from './AgentManager.js';
+export { AgentAnnouncer, agentAnnouncer } from './AgentAnnouncer.js';
+export type { AgentStartEvent, AgentCompleteEvent, AgentErrorEvent, AgentStats } from './AgentAnnouncer.js';
+export { AgentRegistry } from './AgentRegistry.js';
+export type { AgentExecution, AgentHistoryItem, AgentStatsSummary, GlobalAgentStats } from './AgentRegistry.js';
+export { PhasePipeline, createStage, createPipeline, createUltraworkPipeline, pipelineResultToToolResult } from './PhasePipeline.js';
+export type { PipelineStage, StageContext, StageResult, PipelineOptions, PipelineResult } from './PhasePipeline.js';
+export { PhaseResultStore } from './PhaseResultStore.js';
+export type { PhaseResultFile } from './PhaseResultStore.js';
+export { CheckpointManager } from './CheckpointManager.js';
+export type { CheckpointGate } from './CheckpointManager.js';
+export { SwarmOrchestrator, swarm, analyzeTaskComplexity } from './SwarmOrchestrator.js';
+export type { SwarmConfig, SwarmTask, SwarmResult } from './SwarmOrchestrator.js';
+import { ToolResult } from '../types/tool.js';
+/**
+ * 기능 기반 병렬 리서치 (간편 API)
+ * v2.5.0: Multi-LLM Research (Claude + GPT + Gemini) 지원
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.research('login feature', ['React', 'TypeScript'])).then(console.log)"
+ */
+export declare function research(feature: string, techStack?: string[], projectPath?: string): Promise<ToolResult>;
+/**
+ * 백그라운드 에이전트 시작 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.runAgent('Fix the login bug', 'bug-fixer')).then(console.log)"
+ */
+export declare function runAgent(prompt: string, agentName?: string, projectPath?: string): Promise<ToolResult>;
+/**
+ * 에이전트 결과 조회 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.getResult('session-id')).then(console.log)"
+ */
+export declare function getResult(sessionId: string): Promise<ToolResult>;
+/**
+ * 에이전트 목록 조회 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.listAgents()).then(console.log)"
+ */
+export declare function listAgents(category?: string, projectPath?: string): Promise<ToolResult>;
+/**
+ * 병렬 리뷰 실행 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.review(['src/api/user.ts'], ['TypeScript'])).then(console.log)"
+ */
+export declare function review(filePaths: string[], techStack?: string[], projectPath?: string): Promise<ToolResult>;
+/**
+ * 오케스트레이터 상태 확인
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.status()).then(console.log)"
+ */
+export declare function status(): ToolResult;
+/**
+ * GPT 질문 (간편 API) - 웹 검색 없음, Gemini로 위임
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.gptSearch('React 19 features')).then(console.log)"
+ * @deprecated GPT Codex API는 웹 검색을 지원하지 않습니다. geminiSearch를 사용하세요.
+ */
+export declare function gptSearch(query: string): Promise<ToolResult>;
+/**
+ * GPT 오케스트레이션 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.gpt('Analyze this architecture')).then(console.log)"
+ */
+export declare function gpt(prompt: string, systemPrompt?: string): Promise<ToolResult>;
+/**
+ * Gemini 웹 검색 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.geminiSearch('React 19 features')).then(console.log)"
+ */
+export declare function geminiSearch(query: string): Promise<ToolResult>;
+/**
+ * Gemini 오케스트레이션 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.gemini('Review this UI')).then(console.log)"
+ */
+export declare function gemini(prompt: string, systemPrompt?: string): Promise<ToolResult>;
+/**
+ * AZ (Kimi K2.5) 오케스트레이션 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.az('Review this code')).then(console.log)"
+ */
+export declare function az(prompt: string, systemPrompt?: string): Promise<ToolResult>;
+/**
+ * 멀티 LLM 병렬 쿼리 (간편 API)
+ * GPT, Gemini 동시 호출
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.multiLlm('Review this code')).then(console.log)"
+ */
+export declare function multiLlm(prompt: string, options?: {
+    useGpt?: boolean;
+    useGemini?: boolean;
+    useAz?: boolean;
+}): Promise<ToolResult>;
+/**
+ * LLM 상태 확인 (간편 API)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.llmStatus()).then(console.log)"
+ */
+export declare function llmStatus(): Promise<ToolResult>;
+import type { TaskType, SmartRouteResult } from './types.js';
+/**
+ * 스마트 라우팅 - 작업 유형에 따라 최적의 LLM 선택 + 자동 fallback
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartRoute({type:'architecture',prompt:'Review this design'})).then(console.log)"
+ */
+export declare function smartRoute(type: TaskType, prompt: string, systemPrompt?: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+/**
+ * 아키텍처 분석 with fallback (GPT → Gemini → Claude)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartArchitecture('Review this system design')).then(console.log)"
+ */
+export declare function smartArchitecture(prompt: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+/**
+ * UI/UX 분석 with fallback (Gemini → GPT → Claude)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartUiux('Improve this form UX')).then(console.log)"
+ */
+export declare function smartUiux(prompt: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+/**
+ * 코드 분석 with fallback (Gemini → GPT → Claude)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartCodeAnalysis('Analyze this code')).then(console.log)"
+ */
+export declare function smartCodeAnalysis(prompt: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+/**
+ * 디버깅 with fallback (GPT → Gemini → Claude)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartDebugging('Find bugs in this code')).then(console.log)"
+ */
+export declare function smartDebugging(prompt: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+/**
+ * 웹 검색 with fallback (GPT → Gemini → Claude)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartWebSearch('React 19 new features')).then(console.log)"
+ */
+export declare function smartWebSearch(query: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+/**
+ * 코드 생성 with fallback (Claude 직접)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartCodeGen('Create a React button component')).then(console.log)"
+ */
+export declare function smartCodeGen(description: string, context?: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+/**
+ * 코드 리뷰 with fallback (AZ Kimi K2.5 → GPT → Gemini → Claude)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartCodeReview('Review this PR')).then(console.log)"
+ */
+export declare function smartCodeReview(prompt: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+/**
+ * 추론/분석 with fallback (AZ Kimi K2.5 → GPT → Gemini → Claude)
+ *
+ * @example
+ * node -e "import('@su-record/core/orchestrator').then(o => o.smartReasoning('Analyze this problem')).then(console.log)"
+ */
+export declare function smartReasoning(prompt: string): Promise<ToolResult & {
+    result: SmartRouteResult;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

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