claude-mycelium 2.0.0 → 2.2.0

package/dist/task/agent-coordinator.js

@@ -0,0 +1,168 @@
+/**
+ * Task Agent Coordinator
+ *
+ * Coordinates multi-agent execution of task steps using the mycelium
+ * process spawning system (Phase 3) for true RALPH-style parallelization.
+ *
+ * This replaces the simple Promise.all() approach with real agent processes
+ * that use file locks, inhibitors, and the full executeAgent() cycle.
+ */
+import { fork } from 'child_process';
+import { logDebug, logError, logInfo } from '../utils/logger.js';
+import { randomUUID } from 'crypto';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Spawn an agent for a specific task step
+ * Each agent runs as an independent process via child_process.fork()
+ */
+export function spawnAgentForStep(task, step) {
+    return new Promise((resolve) => {
+        const agentId = `agent-${randomUUID().substring(0, 8)}`;
+        logDebug('Spawning agent for task step', {
+            agentId,
+            taskId: task.id,
+            stepOrder: step.order,
+            targetFile: step.target_file,
+            mode: step.mode,
+        });
+        // Path to the compiled task worker file
+        const workerPath = path.join(__dirname, '../agent/task-worker.js');
+        // Spawn agent process with task context
+        const child = fork(workerPath, [], {
+            env: {
+                ...process.env,
+                AGENT_ID: agentId,
+                TASK_ID: task.id,
+                STEP_ORDER: String(step.order),
+                TARGET_FILE: step.target_file,
+                MODE: step.mode,
+                STEP_DESCRIPTION: step.description,
+            },
+            stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+        });
+        let result = {
+            stepOrder: step.order,
+            success: false,
+            exitCode: null,
+        };
+        // Set timeout (5 minutes)
+        const timeout = setTimeout(() => {
+            logError('Agent timeout', new Error('Agent timed out'), {
+                agentId,
+                stepOrder: step.order,
+            });
+            child.kill('SIGTERM');
+            result.error = 'Agent timed out after 5 minutes';
+            result.exitCode = -1;
+            resolve(result);
+        }, 300_000);
+        // Handle IPC messages from agent
+        child.on('message', (message) => {
+            if (message.type === 'result') {
+                logDebug('Agent result received', {
+                    agentId,
+                    stepOrder: step.order,
+                    success: message.success,
+                });
+                result = {
+                    stepOrder: step.order,
+                    success: message.success,
+                    traceId: message.traceId,
+                    error: message.error,
+                    exitCode: 0,
+                };
+            }
+            else if (message.type === 'progress') {
+                logInfo('Agent progress', {
+                    agentId,
+                    stepOrder: step.order,
+                    message: message.message,
+                });
+            }
+        });
+        // Handle agent exit
+        child.on('exit', (code, signal) => {
+            clearTimeout(timeout);
+            result.exitCode = code;
+            logInfo('Agent exited', {
+                agentId,
+                stepOrder: step.order,
+                code,
+                signal,
+                success: result.success,
+            });
+            // If we didn't receive a result message, mark as failure
+            if (!result.success && !result.error) {
+                result.error = `Agent exited with code ${code}`;
+            }
+            resolve(result);
+        });
+        // Handle errors
+        child.on('error', (error) => {
+            clearTimeout(timeout);
+            logError('Agent error', error, {
+                agentId,
+                stepOrder: step.order,
+            });
+            result.error = error.message;
+            result.exitCode = -1;
+            resolve(result);
+        });
+        // Forward stderr for debugging
+        if (child.stderr) {
+            child.stderr.on('data', (data) => {
+                logDebug('Agent stderr', {
+                    agentId,
+                    stepOrder: step.order,
+                    output: data.toString(),
+                });
+            });
+        }
+    });
+}
+/**
+ * Execute a wave of task steps in parallel using agent processes
+ * This is the true mycelium multi-agent coordination
+ */
+export async function executeWaveWithAgents(task, wave) {
+    logInfo('Executing wave with agent processes', {
+        taskId: task.id,
+        waveSize: wave.length,
+        steps: wave.map(s => s.order),
+    });
+    // Spawn all agents in parallel
+    const agentPromises = wave.map(step => spawnAgentForStep(task, step));
+    // Wait for all agents to complete
+    const results = await Promise.all(agentPromises);
+    logInfo('Wave execution complete', {
+        taskId: task.id,
+        total: results.length,
+        successful: results.filter(r => r.success).length,
+        failed: results.filter(r => !r.success).length,
+    });
+    return results;
+}
+/**
+ * Get parallelizable steps grouped by dependency waves
+ * Same logic as before, but now we spawn agents for each wave
+ */
+export function getParallelizableSteps(steps) {
+    const waves = [];
+    const completed = new Set();
+    while (completed.size < steps.length) {
+        // Find steps whose dependencies are all completed
+        const ready = steps.filter(step => !completed.has(step.order) &&
+            step.depends_on.every(dep => completed.has(dep)));
+        if (ready.length === 0) {
+            throw new Error('Circular dependency detected in task steps');
+        }
+        waves.push(ready);
+        ready.forEach(step => completed.add(step.order));
+    }
+    return waves;
+}
+//# sourceMappingURL=agent-coordinator.js.map

package/dist/task/agent-coordinator.js.map

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

package/dist/task/executor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Task Execution Implementation
+ * Per second-spec §12.2: Task Step Execution
+ *
+ * Executes task steps using the mycelium multi-agent system.
+ * Each step spawns an independent agent process that uses file locks,
+ * inhibitors, and the full RALPH-style executeAgent() cycle.
+ *
+ * This is TRUE multi-agent coordination as per ADR-004.
+ */
+import { Task, TaskStep } from '../types/index.js';
+/**
+ * Execute a complete task by running all steps in dependency order
+ *
+ * This spawns independent agent processes for each step, coordinated
+ * via file locks. Multiple agents can work in parallel on different
+ * files, implementing true RALPH-style multi-agent coordination.
+ */
+export declare function executeTask(task: Task): Promise<Task>;
+/**
+ * Execute a single task step
+ */
+export declare function executeStep(task: Task, step: TaskStep): Promise<{
+    success: boolean;
+    trace_id?: string;
+    error?: string;
+}>;
+/**
+ * Track progress of task execution
+ */
+export declare function trackProgress(task: Task): {
+    percentage: number;
+    completed: number;
+    total: number;
+    status: string;
+};
+//# sourceMappingURL=executor.d.ts.map

package/dist/task/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/task/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAQnD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAqF3D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAWA"}

package/dist/task/executor.js

@@ -0,0 +1,462 @@
+/**
+ * Task Execution Implementation
+ * Per second-spec §12.2: Task Step Execution
+ *
+ * Executes task steps using the mycelium multi-agent system.
+ * Each step spawns an independent agent process that uses file locks,
+ * inhibitors, and the full RALPH-style executeAgent() cycle.
+ *
+ * This is TRUE multi-agent coordination as per ADR-004.
+ */
+import { logDebug, logError, logInfo } from '../utils/logger.js';
+import { executeWaveWithAgents, } from './agent-coordinator.js';
+/**
+ * Execute a complete task by running all steps in dependency order
+ *
+ * This spawns independent agent processes for each step, coordinated
+ * via file locks. Multiple agents can work in parallel on different
+ * files, implementing true RALPH-style multi-agent coordination.
+ */
+export async function executeTask(task) {
+    logInfo('Executing task with multi-agent coordination', {
+        taskId: task.id,
+        steps: task.plan?.steps.length,
+    });
+    if (!task.plan) {
+        throw new Error('Cannot execute task without a plan');
+    }
+    const waves = getParallelizableSteps(task.plan.steps);
+    logInfo('Task execution plan', {
+        taskId: task.id,
+        totalSteps: task.plan.steps.length,
+        waves: waves.length,
+        waveSizes: waves.map(w => w.length),
+    });
+    for (let waveIndex = 0; waveIndex < waves.length; waveIndex++) {
+        const wave = waves[waveIndex];
+        logInfo('Executing wave', {
+            taskId: task.id,
+            wave: waveIndex + 1,
+            totalWaves: waves.length,
+            stepsInWave: wave.length,
+        });
+        // Execute all steps in this wave using agent processes
+        // Each agent runs in its own process with file locks
+        const results = await executeWaveWithAgents(task, wave);
+        // Check for failures
+        const failed = results.find(r => !r.success);
+        if (failed) {
+            task.status = 'failed';
+            task.error = failed.error || 'Agent execution failed';
+            logError('Task wave failed', new Error(task.error), {
+                taskId: task.id,
+                wave: waveIndex + 1,
+                failedStep: failed.stepOrder,
+            });
+            return task;
+        }
+        // Update completed steps
+        for (let i = 0; i < wave.length; i++) {
+            const result = results.find(r => r.stepOrder === wave[i].order);
+            if (result && result.success) {
+                wave[i].completed = true;
+                wave[i].trace_id = result.traceId;
+                task.steps_completed++;
+                // Track file changes
+                if (wave[i].mode === 'create') {
+                    task.files_created.push(wave[i].target_file);
+                }
+                else {
+                    if (!task.files_modified.includes(wave[i].target_file)) {
+                        task.files_modified.push(wave[i].target_file);
+                    }
+                }
+                if (result.traceId) {
+                    task.traces.push(result.traceId);
+                }
+            }
+        }
+        logInfo('Wave complete', {
+            taskId: task.id,
+            wave: waveIndex + 1,
+            successCount: results.filter(r => r.success).length,
+            failureCount: results.filter(r => !r.success).length,
+        });
+    }
+    task.status = 'completed';
+    logInfo('Task execution completed', {
+        taskId: task.id,
+        stepsCompleted: task.steps_completed,
+        filesCreated: task.files_created.length,
+        filesModified: task.files_modified.length,
+    });
+    return task;
+}
+/**
+ * Execute a single task step
+ */
+export async function executeStep(task, step) {
+    logDebug('Executing step', {
+        taskId: task.id,
+        stepOrder: step.order,
+        mode: step.mode,
+        file: step.target_file,
+    });
+    try {
+        if (step.mode === 'create') {
+            return await executeCreateStep(task, step);
+        }
+        else {
+            return await executeModifyStep(task, step);
+        }
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+        const errorObj = error instanceof Error ? error : new Error(String(error));
+        logError('Step execution failed', errorObj, {
+            taskId: task.id,
+            stepOrder: step.order,
+        });
+        return { success: false, error: errorMsg };
+    }
+}
+/**
+ * Track progress of task execution
+ */
+export function trackProgress(task) {
+    const percentage = task.steps_total > 0
+        ? Math.round((task.steps_completed / task.steps_total) * 100)
+        : 0;
+    return {
+        percentage,
+        completed: task.steps_completed,
+        total: task.steps_total,
+        status: task.status,
+    };
+}
+/**
+ * Execute a create mode step (new file)
+ */
+async function executeCreateStep(task, step) {
+    // Check if file already exists
+    if (fileExists(step.target_file)) {
+        return {
+            success: false,
+            error: `Cannot create file ${step.target_file} - already exists`,
+        };
+    }
+    // Build prompt for file creation
+    const systemPrompt = buildCreateSystemPrompt();
+    const userPrompt = buildCreateUserPrompt(task, step);
+    // Call LLM to generate file content
+    const response = await callLLM({
+        prompt: userPrompt,
+        systemPrompt,
+        temperature: 0.5,
+        maxTokens: 4000,
+    });
+    // Extract code from response
+    const fileContent = extractCodeFromResponse(response.content);
+    if (!fileContent) {
+        return {
+            success: false,
+            error: 'Failed to extract code from LLM response',
+        };
+    }
+    // Write the file
+    writeFile(step.target_file, fileContent);
+    // Run CI to validate
+    const ciResult = await ciProvider.run({
+        additions: fileContent.split('\n').length,
+        deletions: 0,
+        files_touched: [step.target_file],
+    });
+    if (!ciResult.passed) {
+        // Revert - delete the file
+        try {
+            const fs = await import('fs');
+            fs.unlinkSync(step.target_file);
+        }
+        catch { }
+        return {
+            success: false,
+            error: `CI failed: ${ciResult.output}`,
+        };
+    }
+    // Record trace
+    const traceId = await recordCreateTrace(step.target_file, fileContent, response.usage, response.model, task.id);
+    logDebug('Create step completed', {
+        file: step.target_file,
+        lines: fileContent.split('\n').length,
+        traceId,
+    });
+    return { success: true, trace_id: traceId };
+}
+/**
+ * Execute a modify mode step (existing file)
+ */
+async function executeModifyStep(task, step) {
+    if (!fileExists(step.target_file)) {
+        return {
+            success: false,
+            error: `Cannot modify file ${step.target_file} - does not exist`,
+        };
+    }
+    const originalContent = readFile(step.target_file);
+    const gradientBefore = await calculateGradient(step.target_file);
+    // Build prompt for modification
+    const systemPrompt = buildModifySystemPrompt(step.mode);
+    const userPrompt = buildModifyUserPrompt(task, step, originalContent);
+    // Call LLM to generate changes
+    const response = await callLLM({
+        prompt: userPrompt,
+        systemPrompt,
+        temperature: 0.5,
+        maxTokens: 4000,
+    });
+    // Extract modified content
+    const modifiedContent = extractCodeFromResponse(response.content);
+    if (!modifiedContent) {
+        return {
+            success: false,
+            error: 'Failed to extract modified code from LLM response',
+        };
+    }
+    // Apply changes
+    writeFile(step.target_file, modifiedContent);
+    // Calculate change stats
+    const changeSet = calculateChanges(originalContent, modifiedContent, step.target_file);
+    // Run CI
+    const ciResult = await ciProvider.run(changeSet);
+    if (!ciResult.passed) {
+        // Revert changes
+        writeFile(step.target_file, originalContent);
+        return {
+            success: false,
+            error: `CI failed: ${ciResult.output}`,
+        };
+    }
+    // Calculate metrics after
+    const gradientAfter = await calculateGradient(step.target_file);
+    // Record trace
+    const traceId = await recordModifyTrace(step.target_file, step.mode, gradientBefore, gradientAfter, changeSet, response.usage, response.model, task.id);
+    logDebug('Modify step completed', {
+        file: step.target_file,
+        mode: step.mode,
+        gradientDelta: gradientBefore.score - gradientAfter.score,
+        traceId,
+    });
+    return { success: true, trace_id: traceId };
+}
+/**
+ * Helper to calculate file metrics (not used in current implementation)
+ */
+/*
+async function calculateFileMetrics(filePath: string, allFiles: string[]): Promise<FileMetrics> {
+  const [complexity, churn, errorRate, debt, centrality] = await Promise.all([
+    calculateComplexity(filePath),
+    calculateChurn(filePath),
+    calculateErrorRate(filePath),
+    calculateDebt(filePath),
+    calculateCentrality(filePath),
+  ]);
+
+  return {
+    path: filePath,
+    complexity: complexity.normalized,
+    churn: churn.normalized,
+    error_rate: errorRate.normalized,
+    debt: debt.normalized,
+    centrality: centrality.normalized,
+    loc: getLineCount(filePath),
+  };
+}
+*/
+/**
+ * Get steps grouped by waves (parallelizable groups)
+ */
+function getParallelizableSteps(steps) {
+    const waves = [];
+    const completed = new Set();
+    while (completed.size < steps.length) {
+        // Find steps whose dependencies are all completed
+        const ready = steps.filter(step => !completed.has(step.order) &&
+            step.depends_on.every(dep => completed.has(dep)));
+        if (ready.length === 0) {
+            throw new Error('Circular dependency detected in task steps');
+        }
+        waves.push(ready);
+        ready.forEach(step => completed.add(step.order));
+    }
+    return waves;
+}
+/**
+ * Build system prompt for create mode
+ */
+function buildCreateSystemPrompt() {
+    return `You are creating a new file as part of a larger task.
+
+Output the complete file content wrapped in triple backticks with the language identifier.
+
+Example:
+\`\`\`typescript
+// File content here
+\`\`\`
+
+Requirements:
+- Include all necessary imports
+- Add appropriate error handling
+- Include JSDoc comments for exported functions
+- Follow TypeScript best practices`;
+}
+/**
+ * Build user prompt for create mode
+ */
+function buildCreateUserPrompt(task, step) {
+    return `## Overall Task
+${task.description}
+
+## This Step
+${step.description}
+
+## File to Create
+${step.target_file}
+
+## Requirements
+- Create a working implementation
+- Include basic error handling
+- Add type annotations
+- Follow existing project patterns
+
+Generate the complete file content.`;
+}
+/**
+ * Build system prompt for modify mode
+ */
+function buildModifySystemPrompt(mode) {
+    const modeInstructions = {
+        error_reducer: 'Focus on fixing bugs and adding error handling. Do not refactor for style.',
+        complexity_reducer: 'Focus on simplifying code structure. Extract functions, reduce nesting.',
+        debt_payer: 'Focus on fixing lint issues and improving types. Do not change logic.',
+        stabilizer: 'Focus on adding tests and documentation. Do not change implementation.',
+        explorer: 'You may challenge assumptions and propose larger changes within constraints.',
+    };
+    return `You are modifying an existing file in ${mode} mode.
+
+${modeInstructions[mode]}
+
+Output the complete modified file content wrapped in triple backticks.`;
+}
+/**
+ * Build user prompt for modify mode
+ */
+function buildModifyUserPrompt(task, step, currentContent) {
+    return `## Overall Task
+${task.description}
+
+## This Step
+${step.description}
+
+## Current File Content
+\`\`\`typescript
+${currentContent}
+\`\`\`
+
+Modify the file according to the step description and mode constraints.
+Output the complete modified file.`;
+}
+/**
+ * Extract code from LLM response (handle markdown code blocks)
+ */
+function extractCodeFromResponse(content) {
+    // Try to find code in triple backticks
+    const codeBlockMatch = content.match(/```(?:typescript|ts|javascript|js)?\n([\s\S]*?)\n```/);
+    if (codeBlockMatch) {
+        return codeBlockMatch[1];
+    }
+    // If no code block found, check if entire content looks like code
+    if (content.includes('import') || content.includes('export') || content.includes('function')) {
+        return content.trim();
+    }
+    return null;
+}
+/**
+ * Calculate changes between original and modified content
+ */
+function calculateChanges(original, modified, filePath) {
+    const originalLines = original.split('\n');
+    const modifiedLines = modified.split('\n');
+    // Simple diff: count added and removed lines
+    const additions = modifiedLines.length > originalLines.length
+        ? modifiedLines.length - originalLines.length
+        : 0;
+    const deletions = originalLines.length > modifiedLines.length
+        ? originalLines.length - modifiedLines.length
+        : 0;
+    return {
+        additions,
+        deletions,
+        files_touched: [filePath],
+    };
+}
+/**
+ * Record trace for create step
+ */
+async function recordCreateTrace(filePath, content, usage, model, taskId) {
+    const cost = {
+        tokens_in: usage.inputTokens,
+        tokens_out: usage.outputTokens,
+        model,
+        estimated_usd: calculateCost(model, usage.inputTokens, usage.outputTokens),
+    };
+    // For create mode, gradient goes from 0 to 0 (no improvement measured)
+    const trace = createTraceEvent({
+        filePath,
+        mode: 'debt_payer', // Create is treated as debt_payer for metrics
+        gradientBefore: 0,
+        gradientAfter: 0,
+        metabolicCost: cost.estimated_usd * 100, // Normalize
+        efficiency: 0,
+        ciPassed: true,
+        changes: {
+            additions: content.split('\n').length,
+            deletions: 0,
+            files_touched: [filePath],
+        },
+        costRecord: cost,
+        notes: ['File created as part of task'],
+        taskId,
+    });
+    await recordTraceEvent(trace);
+    return trace.id;
+}
+/**
+ * Record trace for modify step
+ */
+async function recordModifyTrace(filePath, mode, gradientBefore, gradientAfter, changes, usage, model, taskId) {
+    const cost = {
+        tokens_in: usage.inputTokens,
+        tokens_out: usage.outputTokens,
+        model,
+        estimated_usd: calculateCost(model, usage.inputTokens, usage.outputTokens),
+    };
+    const gradientDelta = gradientBefore.score - gradientAfter.score;
+    const metabolicCost = cost.estimated_usd * 100; // Normalize
+    const efficiency = metabolicCost > 0 ? gradientDelta / metabolicCost : 0;
+    const trace = createTraceEvent({
+        filePath,
+        mode,
+        gradientBefore: gradientBefore.score,
+        gradientAfter: gradientAfter.score,
+        metabolicCost,
+        efficiency,
+        ciPassed: true,
+        changes,
+        costRecord: cost,
+        notes: ['Modified as part of task'],
+        taskId,
+    });
+    await recordTraceEvent(trace);
+    return trace.id;
+}
+//# sourceMappingURL=executor.js.map