hivemind-pipeline 0.1.0

package/dist/src/core/telemetry.js

@@ -0,0 +1,276 @@
+/**
+ * Telemetry module — opt-in, local-only anonymous usage statistics.
+ *
+ * All data is stored at ~/.swarm/telemetry.json. Nothing is sent remotely.
+ * Telemetry is OFF by default; users must explicitly enable it via `hivemind telemetry on`.
+ *
+ * ── Pipeline integration point ──
+ * To wire telemetry into the pipeline, add calls in `packages/cli/src/core/pipeline.ts`:
+ *
+ *   import { Telemetry } from './telemetry.js';
+ *   const telemetry = new Telemetry();
+ *
+ *   // After each stage completes (in runStage / runMayday):
+ *   telemetry.record({
+ *     type: 'stage-run',
+ *     stage: stageName,          // e.g. 'analyze', 'build'
+ *     status: 'success',         // or 'error'
+ *     cost: agent.cost.totalUsd,
+ *     duration: Date.now() - stageStartedAt,
+ *     stack: config.stack,
+ *     model: agent.model,
+ *   });
+ *
+ *   // After a full pipeline run completes:
+ *   telemetry.record({
+ *     type: 'pipeline-run',
+ *     stages: ['analyze', 'architect', 'plan', 'build', 'test'],
+ *     totalCost: state.totalCost.totalUsd,
+ *     duration: Date.now() - pipelineStartedAt,
+ *     success: true,
+ *   });
+ *
+ *   // After each fix loop iteration:
+ *   telemetry.record({
+ *     type: 'fix-iteration',
+ *     iteration: currentIteration,
+ *     fixed: fixedCount,
+ *     remaining: remainingCount,
+ *   });
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+function emptyData() {
+    return {
+        enabled: false,
+        firstRecordedAt: null,
+        lastRecordedAt: null,
+        stages: {},
+        pipelineRuns: 0,
+        pipelineSuccesses: 0,
+        pipelineFailures: 0,
+        pipelineTotalCost: 0,
+        pipelineTotalDuration: 0,
+        stacks: {},
+        models: {},
+        fixIterationsTotal: 0,
+        fixIterationsMax: 0,
+        fixTotalFixed: 0,
+        fixTotalRemaining: 0,
+        fixLoopRuns: 0,
+    };
+}
+export class Telemetry {
+    filePath;
+    data;
+    constructor(baseDir) {
+        const dir = baseDir ?? join(homedir(), '.swarm');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        this.filePath = join(dir, 'telemetry.json');
+        this.data = this.load();
+    }
+    // ── Public API ──
+    isEnabled() {
+        return this.data.enabled;
+    }
+    setEnabled(enabled) {
+        this.data.enabled = enabled;
+        this.save();
+    }
+    reset() {
+        const wasEnabled = this.data.enabled;
+        this.data = emptyData();
+        this.data.enabled = wasEnabled;
+        this.save();
+    }
+    record(event) {
+        if (!this.data.enabled)
+            return;
+        const now = Date.now();
+        if (!this.data.firstRecordedAt)
+            this.data.firstRecordedAt = now;
+        this.data.lastRecordedAt = now;
+        switch (event.type) {
+            case 'stage-run':
+                this.recordStageRun(event);
+                break;
+            case 'pipeline-run':
+                this.recordPipelineRun(event);
+                break;
+            case 'fix-iteration':
+                this.recordFixIteration(event);
+                break;
+        }
+        this.save();
+    }
+    getData() {
+        return { ...this.data };
+    }
+    getSummary() {
+        const d = this.data;
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push('  SWARM TELEMETRY — Local Usage Statistics');
+        lines.push('  ========================================');
+        lines.push('');
+        if (!d.firstRecordedAt) {
+            lines.push('  No data recorded yet. Run some pipelines to see stats!');
+            lines.push('');
+            return lines.join('\n');
+        }
+        // Time range
+        const first = new Date(d.firstRecordedAt).toLocaleDateString();
+        const last = new Date(d.lastRecordedAt).toLocaleDateString();
+        lines.push(`  Tracking since: ${first}  |  Last activity: ${last}`);
+        lines.push('');
+        // Pipeline overview
+        lines.push('  PIPELINE RUNS');
+        lines.push('  ─────────────');
+        lines.push(`  Total runs:     ${d.pipelineRuns}`);
+        lines.push(`  Successes:      ${d.pipelineSuccesses}`);
+        lines.push(`  Failures:       ${d.pipelineFailures}`);
+        if (d.pipelineRuns > 0) {
+            const successRate = ((d.pipelineSuccesses / d.pipelineRuns) * 100).toFixed(1);
+            const avgCost = (d.pipelineTotalCost / d.pipelineRuns).toFixed(4);
+            const avgDuration = formatDuration(d.pipelineTotalDuration / d.pipelineRuns);
+            lines.push(`  Success rate:   ${successRate}%`);
+            lines.push(`  Total cost:     $${d.pipelineTotalCost.toFixed(4)}`);
+            lines.push(`  Avg cost/run:   $${avgCost}`);
+            lines.push(`  Avg duration:   ${avgDuration}`);
+        }
+        lines.push('');
+        // Stage breakdown
+        const stageNames = Object.keys(d.stages);
+        if (stageNames.length > 0) {
+            lines.push('  STAGE BREAKDOWN');
+            lines.push('  ───────────────');
+            const header = '  ' + 'Stage'.padEnd(14) + 'Runs'.padEnd(8) + 'OK'.padEnd(6) + 'Fail'.padEnd(8) + 'Avg Cost'.padEnd(12) + 'Avg Time';
+            lines.push(header);
+            lines.push('  ' + '─'.repeat(60));
+            for (const name of stageNames) {
+                const s = d.stages[name];
+                const avgCost = s.runs > 0 ? `$${(s.totalCost / s.runs).toFixed(4)}` : '$0.0000';
+                const avgTime = s.runs > 0 ? formatDuration(s.totalDuration / s.runs) : '—';
+                lines.push('  ' +
+                    name.padEnd(14) +
+                    String(s.runs).padEnd(8) +
+                    String(s.successes).padEnd(6) +
+                    String(s.failures).padEnd(8) +
+                    avgCost.padEnd(12) +
+                    avgTime);
+            }
+            lines.push('');
+        }
+        // Models & stacks
+        const modelEntries = Object.entries(d.models).sort((a, b) => b[1] - a[1]);
+        const stackEntries = Object.entries(d.stacks).sort((a, b) => b[1] - a[1]);
+        if (modelEntries.length > 0 || stackEntries.length > 0) {
+            lines.push('  USAGE PATTERNS');
+            lines.push('  ──────────────');
+            if (modelEntries.length > 0) {
+                lines.push(`  Models:  ${modelEntries.map(([m, c]) => `${m} (${c})`).join(', ')}`);
+            }
+            if (stackEntries.length > 0) {
+                lines.push(`  Stacks:  ${stackEntries.map(([s, c]) => `${s} (${c})`).join(', ')}`);
+            }
+            lines.push('');
+        }
+        // Fix loop stats
+        if (d.fixLoopRuns > 0) {
+            const avgIterations = (d.fixIterationsTotal / d.fixLoopRuns).toFixed(1);
+            lines.push('  FIX LOOP STATS');
+            lines.push('  ──────────────');
+            lines.push(`  Total fix loops:    ${d.fixLoopRuns}`);
+            lines.push(`  Avg iterations:     ${avgIterations}`);
+            lines.push(`  Max iterations:     ${d.fixIterationsMax}`);
+            lines.push(`  Total tests fixed:  ${d.fixTotalFixed}`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    // ── Private helpers ──
+    recordStageRun(event) {
+        const stage = event.stage;
+        if (!this.data.stages[stage]) {
+            this.data.stages[stage] = { runs: 0, successes: 0, failures: 0, totalCost: 0, totalDuration: 0 };
+        }
+        const s = this.data.stages[stage];
+        s.runs++;
+        if (event.status === 'success') {
+            s.successes++;
+        }
+        else {
+            s.failures++;
+        }
+        s.totalCost += event.cost;
+        s.totalDuration += event.duration;
+        if (event.stack) {
+            this.data.stacks[event.stack] = (this.data.stacks[event.stack] || 0) + 1;
+        }
+        if (event.model) {
+            this.data.models[event.model] = (this.data.models[event.model] || 0) + 1;
+        }
+    }
+    recordPipelineRun(event) {
+        this.data.pipelineRuns++;
+        if (event.success) {
+            this.data.pipelineSuccesses++;
+        }
+        else {
+            this.data.pipelineFailures++;
+        }
+        this.data.pipelineTotalCost += event.totalCost;
+        this.data.pipelineTotalDuration += event.duration;
+    }
+    recordFixIteration(event) {
+        // Each fix-iteration event with iteration === 1 starts a new fix loop run
+        if (event.iteration === 1) {
+            this.data.fixLoopRuns++;
+        }
+        this.data.fixIterationsTotal++;
+        if (event.iteration > this.data.fixIterationsMax) {
+            this.data.fixIterationsMax = event.iteration;
+        }
+        this.data.fixTotalFixed += event.fixed;
+        this.data.fixTotalRemaining += event.remaining;
+    }
+    load() {
+        if (!existsSync(this.filePath))
+            return emptyData();
+        try {
+            const raw = readFileSync(this.filePath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            return { ...emptyData(), ...parsed };
+        }
+        catch {
+            return emptyData();
+        }
+    }
+    save() {
+        try {
+            writeFileSync(this.filePath, JSON.stringify(this.data, null, 2) + '\n');
+        }
+        catch {
+            // Non-critical — don't crash if telemetry write fails
+        }
+    }
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    const seconds = ms / 1000;
+    if (seconds < 60)
+        return `${seconds.toFixed(1)}s`;
+    const minutes = Math.floor(seconds / 60);
+    const secs = Math.round(seconds % 60);
+    if (minutes < 60)
+        return `${minutes}m ${secs}s`;
+    const hours = Math.floor(minutes / 60);
+    const mins = minutes % 60;
+    return `${hours}h ${mins}m`;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/src/core/telemetry.js.map

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

package/dist/src/core/tools/definitions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Swarm Tool Definitions
+ *
+ * OpenAI function-calling format tool definitions for API-based models.
+ * These tools give non-Claude models the ability to read/write files,
+ * run commands, and search code within the project sandbox.
+ */
+import type { ToolDefinition } from '../providers/types.js';
+export declare const SWARM_TOOLS: ToolDefinition[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/src/core/tools/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,eAAO,MAAM,WAAW,EAAE,cAAc,EAmKvC,CAAC"}

package/dist/src/core/tools/definitions.js

@@ -0,0 +1,165 @@
+/**
+ * Swarm Tool Definitions
+ *
+ * OpenAI function-calling format tool definitions for API-based models.
+ * These tools give non-Claude models the ability to read/write files,
+ * run commands, and search code within the project sandbox.
+ */
+export const SWARM_TOOLS = [
+    {
+        type: 'function',
+        function: {
+            name: 'read_file',
+            description: 'Read the contents of a file. Returns the file content with line numbers. Use startLine/endLine to read a specific range for large files.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'File path relative to project root',
+                    },
+                    startLine: {
+                        type: 'number',
+                        description: 'Start reading from this line (1-indexed, inclusive)',
+                    },
+                    endLine: {
+                        type: 'number',
+                        description: 'Stop reading at this line (1-indexed, inclusive)',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'write_file',
+            description: 'Write content to a file. Creates the file if it does not exist, overwrites if it does. Parent directories are created automatically.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'File path relative to project root',
+                    },
+                    content: {
+                        type: 'string',
+                        description: 'Full content to write to the file',
+                    },
+                },
+                required: ['path', 'content'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'edit_file',
+            description: 'Replace a specific string in a file. The old_text must appear exactly once in the file (unique match required). Use this for surgical edits instead of rewriting entire files.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'File path relative to project root',
+                    },
+                    old_text: {
+                        type: 'string',
+                        description: 'The exact text to find and replace (must be a unique match)',
+                    },
+                    new_text: {
+                        type: 'string',
+                        description: 'The replacement text',
+                    },
+                },
+                required: ['path', 'old_text', 'new_text'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'run_command',
+            description: 'Execute a shell command and return stdout/stderr. Commands run in /bin/sh. Use cwd to change the working directory. Long-running commands will be terminated after the timeout.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    command: {
+                        type: 'string',
+                        description: 'The shell command to execute',
+                    },
+                    cwd: {
+                        type: 'string',
+                        description: 'Working directory for the command (relative to project root)',
+                    },
+                    timeout: {
+                        type: 'number',
+                        description: 'Maximum execution time in milliseconds (default: 30000)',
+                    },
+                },
+                required: ['command'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'search_files',
+            description: 'Search file contents using a regex pattern (like grep). Returns matching lines with file paths and line numbers. Searches recursively from the given path.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    pattern: {
+                        type: 'string',
+                        description: 'Regex pattern to search for in file contents',
+                    },
+                    path: {
+                        type: 'string',
+                        description: 'Directory to search in, relative to project root (default: project root)',
+                    },
+                    glob: {
+                        type: 'string',
+                        description: 'File glob pattern to filter which files to search (e.g. "*.ts", "**/*.js")',
+                    },
+                },
+                required: ['pattern'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'list_files',
+            description: 'List files matching a glob pattern. Returns file paths relative to the project root, sorted alphabetically. Use this to explore the project structure.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    pattern: {
+                        type: 'string',
+                        description: 'Glob pattern to match files (e.g. "src/**/*.ts", "*.json", "**/*")',
+                    },
+                },
+                required: ['pattern'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'create_directory',
+            description: 'Create a directory, including any necessary parent directories.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Directory path relative to project root',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+    },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/src/core/tools/definitions.js.map

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

package/dist/src/core/tools/executor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tool Executor
+ *
+ * Executes tool calls from API-based LLMs within the sandbox.
+ * Each tool maps to a file/shell operation performed safely within
+ * the project root boundary.
+ */
+import { type ToolSandboxConfig } from './sandbox.js';
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export declare class ToolExecutor {
+    private sandbox;
+    constructor(sandboxConfig: ToolSandboxConfig);
+    /** Execute a tool call by name and return the result */
+    execute(toolName: string, args: Record<string, unknown>): Promise<ToolResult>;
+    private readFileImpl;
+    private writeFileImpl;
+    private editFileImpl;
+    private runCommandImpl;
+    private searchFilesImpl;
+    private listFilesImpl;
+    private createDirectoryImpl;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/src/core/tools/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/core/tools/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAgBnE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAc;gBAEjB,aAAa,EAAE,iBAAiB;IAI5C,wDAAwD;IAClD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;YA4BrE,YAAY;YAsCZ,aAAa;YA0Bb,YAAY;YAoDZ,cAAc;YAqDd,eAAe;YAiEf,aAAa;YAyDb,mBAAmB;CAWlC"}