@intrect/openswarm 0.2.0

package/dist/orchestration/workflow.js

@@ -0,0 +1,301 @@
+// ============================================
+// OpenSwarm - DAG Workflow Engine
+// Agent task dependency management and execution
+// ============================================
+import { resolve } from 'path';
+import { homedir } from 'os';
+import * as fs from 'fs/promises';
+import * as yaml from 'yaml';
+// DAG Utilities
+/**
+ * Topological Sort (Kahn's Algorithm)
+ * Sort steps in dependency order
+ */
+export function topologicalSort(steps) {
+    const graph = new Map();
+    const inDegree = new Map();
+    const stepMap = new Map();
+    // Initialize graph
+    for (const step of steps) {
+        stepMap.set(step.id, step);
+        graph.set(step.id, new Set());
+        inDegree.set(step.id, 0);
+    }
+    // Add edges (dependencies)
+    for (const step of steps) {
+        if (step.dependsOn) {
+            for (const dep of step.dependsOn) {
+                if (!graph.has(dep)) {
+                    throw new Error(`Step "${step.id}" depends on unknown step "${dep}"`);
+                }
+                graph.get(dep).add(step.id);
+                inDegree.set(step.id, (inDegree.get(step.id) || 0) + 1);
+            }
+        }
+    }
+    // Kahn's Algorithm
+    const queue = [];
+    const result = [];
+    // Add nodes with in-degree 0 to queue
+    for (const [id, degree] of inDegree) {
+        if (degree === 0) {
+            queue.push(id);
+        }
+    }
+    while (queue.length > 0) {
+        const current = queue.shift();
+        result.push(stepMap.get(current));
+        for (const neighbor of graph.get(current)) {
+            inDegree.set(neighbor, inDegree.get(neighbor) - 1);
+            if (inDegree.get(neighbor) === 0) {
+                queue.push(neighbor);
+            }
+        }
+    }
+    // Cycle detection
+    if (result.length !== steps.length) {
+        throw new Error('Workflow contains circular dependencies');
+    }
+    return result;
+}
+/**
+ * Find currently executable steps (all dependencies completed)
+ */
+export function getExecutableSteps(steps, results) {
+    return steps.filter(step => {
+        // Already executed
+        if (results[step.id])
+            return false;
+        // Check dependencies
+        if (step.dependsOn) {
+            for (const depId of step.dependsOn) {
+                const depResult = results[depId];
+                if (!depResult || depResult.status !== 'completed') {
+                    return false;
+                }
+            }
+        }
+        return true;
+    });
+}
+/**
+ * Find parallelizable step groups
+ */
+export function getParallelGroups(steps) {
+    const sorted = topologicalSort(steps);
+    const groups = [];
+    const completed = new Set();
+    while (completed.size < sorted.length) {
+        const group = [];
+        for (const step of sorted) {
+            if (completed.has(step.id))
+                continue;
+            // All dependencies completed?
+            const depsCompleted = !step.dependsOn ||
+                step.dependsOn.every(dep => completed.has(dep));
+            if (depsCompleted) {
+                group.push(step);
+            }
+        }
+        if (group.length === 0)
+            break;
+        groups.push(group);
+        group.forEach(s => completed.add(s.id));
+    }
+    return groups;
+}
+// Workflow Storage
+const WORKFLOW_DIR = resolve(homedir(), '.openswarm/workflows');
+const EXECUTION_DIR = resolve(homedir(), '.openswarm/executions');
+/**
+ * Save workflow
+ */
+export async function saveWorkflow(workflow) {
+    await fs.mkdir(WORKFLOW_DIR, { recursive: true });
+    const filePath = resolve(WORKFLOW_DIR, `${workflow.id}.yaml`);
+    await fs.writeFile(filePath, yaml.stringify(workflow), 'utf-8');
+    console.log(`[Workflow] Saved: ${workflow.name} (${workflow.id})`);
+}
+/**
+ * Load workflow
+ */
+export async function loadWorkflow(workflowId) {
+    try {
+        const filePath = resolve(WORKFLOW_DIR, `${workflowId}.yaml`);
+        const content = await fs.readFile(filePath, 'utf-8');
+        return yaml.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all workflows
+ */
+export async function listWorkflows() {
+    try {
+        await fs.mkdir(WORKFLOW_DIR, { recursive: true });
+        const files = await fs.readdir(WORKFLOW_DIR);
+        const workflows = [];
+        for (const file of files) {
+            if (file.endsWith('.yaml')) {
+                const content = await fs.readFile(resolve(WORKFLOW_DIR, file), 'utf-8');
+                workflows.push(yaml.parse(content));
+            }
+        }
+        return workflows;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Save execution state
+ */
+export async function saveExecution(execution) {
+    await fs.mkdir(EXECUTION_DIR, { recursive: true });
+    const filePath = resolve(EXECUTION_DIR, `${execution.executionId}.json`);
+    await fs.writeFile(filePath, JSON.stringify(execution, null, 2), 'utf-8');
+}
+/**
+ * Load execution state
+ */
+export async function loadExecution(executionId) {
+    try {
+        const filePath = resolve(EXECUTION_DIR, `${executionId}.json`);
+        const content = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+// Workflow Templates
+/**
+ * CI pipeline template
+ */
+export function createCIPipelineTemplate(projectPath) {
+    return {
+        id: `ci-pipeline-${Date.now()}`,
+        name: 'CI Pipeline',
+        description: 'Lint → Test → Build → PR',
+        projectPath,
+        onFailure: 'rollback',
+        steps: [
+            {
+                id: 'lint',
+                name: 'Lint & Format',
+                prompt: 'Run linting and fix any issues. Report what was fixed.',
+                onFailure: 'abort',
+            },
+            {
+                id: 'test',
+                name: 'Run Tests',
+                prompt: 'Run all tests and report results. Fix any failing tests if possible.',
+                dependsOn: ['lint'],
+                onFailure: 'abort',
+            },
+            {
+                id: 'build',
+                name: 'Build Check',
+                prompt: 'Run build and verify it succeeds. Fix any build errors.',
+                dependsOn: ['test'],
+                onFailure: 'abort',
+            },
+            {
+                id: 'pr',
+                name: 'Create PR',
+                prompt: 'Create a pull request with all changes made. Include a summary of fixes.',
+                dependsOn: ['build'],
+                onFailure: 'notify',
+            },
+        ],
+    };
+}
+/**
+ * Code review pipeline template
+ */
+export function createReviewPipelineTemplate(projectPath, prNumber) {
+    return {
+        id: `review-pipeline-${Date.now()}`,
+        name: 'Code Review Pipeline',
+        description: 'Security → Quality → Tests → Approve',
+        projectPath,
+        onFailure: 'notify',
+        steps: [
+            {
+                id: 'security',
+                name: 'Security Review',
+                prompt: `Review PR #${prNumber} for security vulnerabilities. Check for injection, auth issues, data exposure.`,
+            },
+            {
+                id: 'quality',
+                name: 'Code Quality',
+                prompt: `Review PR #${prNumber} for code quality. Check naming, structure, SOLID principles.`,
+            },
+            {
+                id: 'tests',
+                name: 'Test Coverage',
+                prompt: `Check if PR #${prNumber} has adequate test coverage. Suggest missing tests.`,
+                dependsOn: ['security', 'quality'], // Execute after parallel steps
+            },
+            {
+                id: 'summary',
+                name: 'Review Summary',
+                prompt: 'Compile all review findings and create a summary comment on the PR.',
+                dependsOn: ['tests'],
+            },
+        ],
+    };
+}
+// Workflow Validation
+/**
+ * Validate workflow
+ */
+export function validateWorkflow(workflow) {
+    const errors = [];
+    // Basic field validation
+    if (!workflow.id)
+        errors.push('Workflow ID is required');
+    if (!workflow.name)
+        errors.push('Workflow name is required');
+    if (!workflow.steps || workflow.steps.length === 0) {
+        errors.push('Workflow must have at least one step');
+    }
+    // Step validation
+    const stepIds = new Set();
+    for (const step of workflow.steps || []) {
+        if (!step.id) {
+            errors.push('Each step must have an ID');
+            continue;
+        }
+        if (stepIds.has(step.id)) {
+            errors.push(`Duplicate step ID: ${step.id}`);
+        }
+        stepIds.add(step.id);
+        if (!step.prompt) {
+            errors.push(`Step "${step.id}" must have a prompt`);
+        }
+        // Dependency validation
+        if (step.dependsOn) {
+            for (const dep of step.dependsOn) {
+                if (!stepIds.has(dep) && !workflow.steps.some(s => s.id === dep)) {
+                    errors.push(`Step "${step.id}" depends on unknown step "${dep}"`);
+                }
+            }
+        }
+    }
+    // Circular dependency check
+    if (workflow.steps && workflow.steps.length > 0) {
+        try {
+            topologicalSort(workflow.steps);
+        }
+        catch (e) {
+            errors.push(e.message);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+// Exports
+export { WORKFLOW_DIR, EXECUTION_DIR, };
+//# sourceMappingURL=workflow.js.map

package/dist/orchestration/workflow.js.map

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

package/dist/runners/cliRunner.d.ts

@@ -0,0 +1,11 @@
+export interface CliRunOptions {
+    task: string;
+    projectPath?: string;
+    model?: string;
+    pipeline?: boolean;
+    workerOnly?: boolean;
+    maxIterations?: number;
+    verbose?: boolean;
+}
+export declare function runCli(options: CliRunOptions): Promise<void>;
+//# sourceMappingURL=cliRunner.d.ts.map

package/dist/runners/cliRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliRunner.d.ts","sourceRoot":"","sources":["../../src/runners/cliRunner.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA4BD,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoIlE"}

package/dist/runners/cliRunner.js

@@ -0,0 +1,194 @@
+// ============================================
+// OpenSwarm - CLI Runner
+// Standalone task execution without daemon services
+// ============================================
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { PairPipeline } from '../agents/pairPipeline.js';
+import { initLocale } from '../locale/index.js';
+import { expandPath } from '../core/config.js';
+// Helpers
+// expandPath imported from core/config.ts (with resolveRelative=true for CLI paths)
+/** Check if Claude CLI is installed */
+function checkClaudeCli() {
+    try {
+        execSync('which claude', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Format duration as human-readable string */
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const seconds = ms / 1000;
+    if (seconds < 60)
+        return `${seconds.toFixed(1)}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remaining = seconds % 60;
+    return `${minutes}m ${remaining.toFixed(0)}s`;
+}
+// Main Runner
+export async function runCli(options) {
+    // Initialize locale (needed for prompt templates)
+    initLocale('en');
+    // 1. Check Claude CLI
+    if (!checkClaudeCli()) {
+        console.error('Error: Claude CLI not found.');
+        console.error('Install it: https://docs.anthropic.com/en/docs/claude-code');
+        process.exit(1);
+    }
+    // 2. Resolve project path
+    const projectPath = expandPath(options.projectPath ?? process.cwd(), true);
+    if (!existsSync(projectPath)) {
+        console.error(`Error: Project path does not exist: ${projectPath}`);
+        process.exit(1);
+    }
+    // 3. Determine stages
+    let stages;
+    if (options.workerOnly) {
+        stages = ['worker'];
+    }
+    else if (options.pipeline) {
+        stages = ['worker', 'reviewer', 'tester', 'documenter'];
+    }
+    else {
+        stages = ['worker', 'reviewer'];
+    }
+    // 4. Build role config
+    const roles = {};
+    if (options.model) {
+        roles.worker = { enabled: true, model: options.model, timeoutMs: 0 };
+    }
+    // 5. Create local TaskItem
+    const task = {
+        id: `cli-${Date.now()}`,
+        source: 'local',
+        title: options.task,
+        description: options.task,
+        priority: 3,
+        projectPath,
+        createdAt: Date.now(),
+    };
+    // 6. Create pipeline
+    const pipeline = new PairPipeline({
+        stages,
+        maxIterations: options.maxIterations ?? 3,
+        roles: Object.keys(roles).length > 0 ? roles : undefined,
+        verbose: options.verbose,
+    });
+    // 7. Print header
+    const stageNames = stages.join(' -> ');
+    const shortPath = projectPath.replace(homedir(), '~');
+    console.log('');
+    console.log('  OpenSwarm v0.1.0');
+    console.log('');
+    console.log(`  Project:  ${shortPath}`);
+    console.log(`  Pipeline: ${stageNames}`);
+    if (options.model) {
+        console.log(`  Model:    ${options.model}`);
+    }
+    if (options.verbose) {
+        console.log(`  Verbose:  enabled`);
+    }
+    console.log('');
+    // 8. Attach event listeners for progress
+    const stageStartTimes = new Map();
+    pipeline.on('stage:start', ({ stage }) => {
+        stageStartTimes.set(stage, Date.now());
+        process.stdout.write(`  ~ ${stage}...`);
+    });
+    pipeline.on('stage:complete', ({ stage, result }) => {
+        const symbol = result.success ? 'v' : 'x';
+        const duration = (result.duration / 1000).toFixed(1);
+        // Clear the "running" line and replace with result
+        process.stdout.write(`\r  ${symbol} ${stage} (${duration}s)\n`);
+    });
+    pipeline.on('stage:fail', ({ stage, result }) => {
+        const duration = (result.duration / 1000).toFixed(1);
+        process.stdout.write(`\r  x ${stage} (${duration}s) FAILED\n`);
+    });
+    pipeline.on('iteration:start', ({ iteration, maxIterations }) => {
+        if (iteration > 1) {
+            console.log(`\n  --- Iteration ${iteration}/${maxIterations} ---`);
+        }
+    });
+    // 8.5. Verbose event listeners
+    if (options.verbose) {
+        pipeline.on('log', ({ line }) => {
+            console.log(`  ${line}`);
+        });
+        pipeline.on('halt', ({ reason, sessionId }) => {
+            console.log(`  [verbose] HALT: ${reason} (session: ${sessionId})`);
+        });
+        pipeline.on('stuck', ({ sessionId, iteration }) => {
+            console.log(`  [verbose] STUCK detected at iteration ${iteration} (session: ${sessionId})`);
+        });
+        pipeline.on('iteration:fail', ({ iteration, reason }) => {
+            console.log(`  [verbose] Iteration ${iteration} failed${reason ? `: ${reason}` : ''}`);
+        });
+        pipeline.on('iteration:complete', ({ iteration }) => {
+            console.log(`  [verbose] Iteration ${iteration} completed`);
+        });
+    }
+    // 9. Run pipeline
+    let result;
+    try {
+        result = await pipeline.run(task, projectPath);
+    }
+    catch (error) {
+        console.error('\n  Pipeline execution failed:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+    // 10. Format & print result
+    printResult(result);
+    // 11. Exit code
+    process.exit(result.success ? 0 : 1);
+}
+// Result Formatting
+function printResult(result) {
+    console.log('');
+    console.log('  ======================================');
+    const statusLabel = result.finalStatus.toUpperCase();
+    const statusLine = result.success
+        ? `  Result: ${statusLabel}`
+        : `  Result: ${statusLabel}`;
+    console.log(statusLine);
+    console.log('  ======================================');
+    // Summary
+    if (result.workerResult?.summary) {
+        console.log(`  Summary: ${result.workerResult.summary}`);
+    }
+    // Files changed
+    if (result.workerResult?.filesChanged && result.workerResult.filesChanged.length > 0) {
+        const files = result.workerResult.filesChanged;
+        if (files.length <= 5) {
+            console.log(`  Files:   ${files.join(', ')}`);
+        }
+        else {
+            console.log(`  Files:   ${files.slice(0, 5).join(', ')} +${files.length - 5} more`);
+        }
+    }
+    // Cost and duration
+    const parts = [];
+    if (result.totalCost) {
+        parts.push(`$${result.totalCost.costUsd.toFixed(4)}`);
+    }
+    parts.push(`Duration: ${formatDuration(result.totalDuration)}`);
+    console.log(`  ${parts.join(' | ')}`);
+    // Reviewer feedback on failure
+    if (!result.success && result.reviewResult?.feedback) {
+        console.log('');
+        console.log('  Feedback:');
+        const lines = result.reviewResult.feedback.split('\n').slice(0, 5);
+        for (const line of lines) {
+            console.log(`    ${line}`);
+        }
+    }
+    console.log('  ======================================');
+    console.log('');
+}
+//# sourceMappingURL=cliRunner.js.map

package/dist/runners/cliRunner.js.map

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

package/dist/support/apiCache.d.ts

@@ -0,0 +1,85 @@
+/**
+ * API 응답 캐싱 매니저
+ *
+ * 목적:
+ * - 빈번한 API 호출의 응답 시간 단축 (30-40% 개선 목표)
+ * - 메모리 효율성 유지
+ * - 캐시 무효화 전략 통합
+ *
+ * 구현:
+ * - 메모리 기반 LRU 캐시
+ * - TTL(Time-To-Live) 기반 자동 만료
+ * - 캐시 통계 추적
+ */
+interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    hitRate: number;
+}
+export declare class APICache {
+    private cache;
+    private stats;
+    private cleanupInterval;
+    constructor(cleanupIntervalMs?: number);
+    /**
+     * 캐시에서 데이터 조회
+     */
+    get<T>(key: string): T | null;
+    /**
+     * 캐시에 데이터 저장
+     */
+    set<T>(key: string, data: T, ttlMs: number): void;
+    /**
+     * 캐시 초기화
+     */
+    clear(): void;
+    /**
+     * 특정 키 무효화
+     */
+    invalidate(key: string): void;
+    /**
+     * 패턴 기반 무효화 (와일드카드)
+     */
+    invalidatePattern(pattern: string): void;
+    /**
+     * 캐시 통계 조회
+     */
+    getStats(key?: string): Record<string, CacheStats> | CacheStats | null;
+    /**
+     * 캐시 크기 조회
+     */
+    getSize(): number;
+    /**
+     * 캐시 정리 (만료된 항목 제거)
+     */
+    private cleanup;
+    /**
+     * 히트 기록
+     */
+    private recordHit;
+    /**
+     * 미스 기록
+     */
+    private recordMiss;
+    /**
+     * 정리 타이머 중단
+     */
+    destroy(): void;
+}
+export declare const apiCache: APICache;
+/**
+ * 캐시 유틸리티
+ */
+export declare class CachedAPI {
+    /**
+     * 캐시를 활용한 비동기 함수 래핑
+     */
+    static cached<T>(key: string, fn: () => Promise<T>, ttlMs?: number): Promise<T>;
+    /**
+     * 다중 캐시 키 검증
+     */
+    static invalidateMultiple(patterns: string[]): void;
+}
+export {};
+//# sourceMappingURL=apiCache.d.ts.map

package/dist/support/apiCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiCache.d.ts","sourceRoot":"","sources":["../../src/support/apiCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,eAAe,CAA+B;gBAE1C,iBAAiB,GAAE,MAAc;IAK7C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAqB7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASxC;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,UAAU,GAAG,IAAI;IAOtE;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB;AAGD,eAAO,MAAM,QAAQ,UAAiB,CAAC;AAEvC;;GAEG;AACH,qBAAa,SAAS;IACpB;;OAEG;WACU,MAAM,CAAC,CAAC,EACnB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,KAAK,GAAE,MAAc,GACpB,OAAO,CAAC,CAAC,CAAC;IAgBb;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;CAKpD"}