claude-mycelium 2.0.0 → 2.2.0

package/dist/quarantine/manager.js

@@ -0,0 +1,275 @@
+/**
+ * Quarantine Manager for Claude-Mycelium
+ * Full withdrawal mechanism when files resist all approaches
+ * Storage: .agent-meta/_quarantine.json
+ * Reference: initial-spec §6, second-spec §9
+ */
+import * as path from 'path';
+import { readJsonFile, writeJsonFile, fileExists } from '../utils/file-utils.js';
+import { logInfo, logWarn, logError } from '../utils/logger.js';
+// Compute file path at runtime to respect TEST_META_DIR
+function getQuarantineFile() {
+    const META_DIR = process.env.TEST_META_DIR || '.agent-meta';
+    return path.join(META_DIR, '_quarantine.json');
+}
+const DEFAULT_CONFIG = {
+    minSamplesBeforeQuarantine: 10, // Spec requirement
+    efficiencyThreshold: 0.02, // All samples must be below this
+    maxExplorerAttempts: 3, // Spec requirement
+};
+/**
+ * Check if a file should be quarantined
+ * Trigger: 10+ samples, all with efficiency < 0.02
+ */
+export async function shouldQuarantine(file, getTracesForFile, config = DEFAULT_CONFIG) {
+    try {
+        const traces = await getTracesForFile(file);
+        // Need minimum samples
+        if (traces.length < config.minSamplesBeforeQuarantine) {
+            return false;
+        }
+        // Take last 10 samples
+        const recent = traces.slice(-config.minSamplesBeforeQuarantine);
+        // All must have poor efficiency
+        const allPoor = recent.every(t => {
+            const efficiency = t.efficiency || 0;
+            return efficiency < config.efficiencyThreshold;
+        });
+        return allPoor;
+    }
+    catch (error) {
+        logError('Failed to check quarantine condition', error, { file });
+        return false;
+    }
+}
+/**
+ * Add a file to quarantine
+ */
+export async function addToQuarantine(entry) {
+    try {
+        const state = await readQuarantineState();
+        // Check if already quarantined
+        const existing = state.entries.find(e => e.file === entry.file);
+        if (existing) {
+            logWarn('File already quarantined', { file: entry.file });
+            return;
+        }
+        // Add entry
+        state.entries.push(entry);
+        state.updated_at = new Date().toISOString();
+        await writeQuarantineState(state);
+        logWarn('File quarantined', {
+            file: entry.file,
+            reason: entry.reason,
+            attempts: entry.attempts_before_quarantine,
+        });
+    }
+    catch (error) {
+        logError('Failed to add to quarantine', error, { entry });
+        throw error;
+    }
+}
+/**
+ * Check if a file is quarantined
+ */
+export async function isQuarantined(file) {
+    try {
+        const state = await readQuarantineState();
+        return state.entries.some(e => e.file === file);
+    }
+    catch (error) {
+        logError('Failed to check quarantine status', error, { file });
+        return false;
+    }
+}
+/**
+ * Get quarantine entry for a file
+ */
+export async function getQuarantineEntry(file) {
+    try {
+        const state = await readQuarantineState();
+        return state.entries.find(e => e.file === file) ?? null;
+    }
+    catch (error) {
+        logError('Failed to get quarantine entry', error, { file });
+        return null;
+    }
+}
+/**
+ * Check if explorer can attempt quarantined file
+ */
+export async function canExplorerAttempt(file) {
+    try {
+        const entry = await getQuarantineEntry(file);
+        if (!entry)
+            return true; // Not quarantined
+        return entry.explorer_attempts < entry.max_explorer_attempts;
+    }
+    catch (error) {
+        logError('Failed to check explorer attempts', error, { file });
+        return false;
+    }
+}
+/**
+ * Record an explorer attempt on quarantined file
+ */
+export async function recordExplorerAttempt(file) {
+    try {
+        const state = await readQuarantineState();
+        const entry = state.entries.find(e => e.file === file);
+        if (entry) {
+            entry.explorer_attempts++;
+            state.updated_at = new Date().toISOString();
+            await writeQuarantineState(state);
+            logInfo('Explorer attempt recorded', {
+                file,
+                attempts: entry.explorer_attempts,
+                remaining: entry.max_explorer_attempts - entry.explorer_attempts,
+            });
+        }
+    }
+    catch (error) {
+        logError('Failed to record explorer attempt', error, { file });
+    }
+}
+/**
+ * Check if quarantine should be released after explorer success
+ * Only explorer mode with efficiency >= 0.2 can release
+ */
+export async function checkQuarantineRelease(file, trace) {
+    try {
+        if (!(await isQuarantined(file)))
+            return false;
+        // Only explorer can release
+        if (trace.mode !== 'explorer')
+            return false;
+        // Must have good efficiency
+        const efficiency = trace.efficiency || 0;
+        if (efficiency < 0.2)
+            return false;
+        await removeFromQuarantine(file);
+        logInfo('Quarantine released', {
+            file,
+            explorer_efficiency: efficiency.toFixed(3),
+        });
+        return true;
+    }
+    catch (error) {
+        logError('Failed to check quarantine release', error, { file });
+        return false;
+    }
+}
+/**
+ * Remove a file from quarantine
+ */
+export async function removeFromQuarantine(file) {
+    try {
+        const state = await readQuarantineState();
+        const before = state.entries.length;
+        state.entries = state.entries.filter(e => e.file !== file);
+        state.updated_at = new Date().toISOString();
+        await writeQuarantineState(state);
+        if (state.entries.length < before) {
+            logInfo('File removed from quarantine', { file });
+        }
+    }
+    catch (error) {
+        logError('Failed to remove from quarantine', error, { file });
+        throw error;
+    }
+}
+/**
+ * Get all quarantined files
+ */
+export async function getQuarantinedFiles() {
+    try {
+        const state = await readQuarantineState();
+        return state.entries;
+    }
+    catch (error) {
+        logError('Failed to get quarantined files', error);
+        return [];
+    }
+}
+/**
+ * Check and potentially quarantine a file after agent run
+ */
+export async function checkAndQuarantine(file, getTracesForFile, config) {
+    try {
+        // Already quarantined?
+        if (await isQuarantined(file)) {
+            return true;
+        }
+        // Should quarantine now?
+        if (await shouldQuarantine(file, getTracesForFile, config)) {
+            const traces = await getTracesForFile(file);
+            const recentEfficiency = traces.slice(-5).map(t => t.efficiency || 0);
+            const avgEfficiency = recentEfficiency.reduce((a, b) => a + b, 0) / recentEfficiency.length;
+            await addToQuarantine({
+                file,
+                quarantined_at: new Date().toISOString(),
+                reason: `No progress after ${traces.length} attempts. Avg efficiency: ${avgEfficiency.toFixed(3)}`,
+                attempts_before_quarantine: traces.length,
+                explorer_attempts: 0,
+                max_explorer_attempts: config?.maxExplorerAttempts ?? DEFAULT_CONFIG.maxExplorerAttempts,
+            });
+            return true;
+        }
+        return false;
+    }
+    catch (error) {
+        logError('Failed to check and quarantine', error, { file });
+        return false;
+    }
+}
+/**
+ * Read quarantine state from file
+ */
+async function readQuarantineState() {
+    try {
+        if (!fileExists(getQuarantineFile())) {
+            return {
+                updated_at: new Date().toISOString(),
+                entries: [],
+            };
+        }
+        return readJsonFile(getQuarantineFile());
+    }
+    catch (error) {
+        logError('Failed to read quarantine state', error);
+        return {
+            updated_at: new Date().toISOString(),
+            entries: [],
+        };
+    }
+}
+/**
+ * Write quarantine state to file
+ */
+async function writeQuarantineState(state) {
+    try {
+        writeJsonFile(getQuarantineFile(), state, 2);
+    }
+    catch (error) {
+        logError('Failed to write quarantine state', error);
+        throw error;
+    }
+}
+/**
+ * Get quarantine statistics
+ */
+export async function getQuarantineStats() {
+    try {
+        const state = await readQuarantineState();
+        return {
+            total: state.entries.length,
+            withExplorerAttempts: state.entries.filter(e => e.explorer_attempts > 0).length,
+            exhausted: state.entries.filter(e => e.explorer_attempts >= e.max_explorer_attempts).length,
+        };
+    }
+    catch (error) {
+        logError('Failed to get quarantine stats', error);
+        return { total: 0, withExplorerAttempts: 0, exhausted: 0 };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/quarantine/manager.js.map

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

package/dist/task/acceptance.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Acceptance Criteria Validation
+ * Per ROADMAP §Phase 5 Week 6 Day 5-6: Acceptance Criteria
+ *
+ * Validates task completion against acceptance criteria including
+ * file existence, test execution, lint checks, and custom validation.
+ */
+import { Task, AcceptanceCriterion } from '../types/index.js';
+/**
+ * Validate all acceptance criteria for a task
+ */
+export declare function validateAcceptance(task: Task): Promise<boolean>;
+/**
+ * Check if a file exists
+ */
+export declare function checkFileExists(filePath: string): Promise<boolean>;
+/**
+ * Run specific tests and check if they pass
+ */
+export declare function runTests(testPattern: string): Promise<boolean>;
+/**
+ * Generate default acceptance criteria for a task
+ */
+export declare function generateDefaultCriteria(task: Task): AcceptanceCriterion[];
+/**
+ * Check if task can be marked as completed
+ */
+export declare function canCompleteTask(task: Task): boolean;
+//# sourceMappingURL=acceptance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance.d.ts","sourceRoot":"","sources":["../../src/task/acceptance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAQ9D;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BrE;AAoCD;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIxE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BpE;AA2ED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,mBAAmB,EAAE,CA8CzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAanD"}

package/dist/task/acceptance.js

@@ -0,0 +1,228 @@
+/**
+ * Acceptance Criteria Validation
+ * Per ROADMAP §Phase 5 Week 6 Day 5-6: Acceptance Criteria
+ *
+ * Validates task completion against acceptance criteria including
+ * file existence, test execution, lint checks, and custom validation.
+ */
+import { fileExists } from '../utils/file-utils.js';
+import { logDebug, logError } from '../utils/logger.js';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Validate all acceptance criteria for a task
+ */
+export async function validateAcceptance(task) {
+    logDebug('Validating acceptance criteria', {
+        taskId: task.id,
+        criteriaCount: task.acceptance_criteria.length,
+    });
+    let allMet = true;
+    for (const criterion of task.acceptance_criteria) {
+        const met = await validateCriterion(criterion);
+        criterion.met = met;
+        if (!met) {
+            allMet = false;
+            logDebug('Acceptance criterion not met', {
+                taskId: task.id,
+                type: criterion.type,
+                description: criterion.description,
+            });
+        }
+    }
+    logDebug('Acceptance validation complete', {
+        taskId: task.id,
+        allMet,
+        metCount: task.acceptance_criteria.filter(c => c.met).length,
+    });
+    return allMet;
+}
+/**
+ * Validate a single acceptance criterion
+ */
+async function validateCriterion(criterion) {
+    try {
+        switch (criterion.type) {
+            case 'file_exists':
+                return await checkFileExists(criterion.check);
+            case 'test_passes':
+                return await runTests(criterion.check);
+            case 'no_lint_errors':
+                return await checkLintErrors(criterion.check);
+            case 'custom':
+                return await runCustomValidation(criterion.check);
+            default:
+                logError('Unknown criterion type', new Error('Invalid type'), {
+                    type: criterion.type,
+                });
+                return false;
+        }
+    }
+    catch (error) {
+        const errorObj = error instanceof Error ? error : new Error(String(error));
+        logError('Criterion validation failed', errorObj, {
+            type: criterion.type,
+            check: criterion.check,
+        });
+        return false;
+    }
+}
+/**
+ * Check if a file exists
+ */
+export async function checkFileExists(filePath) {
+    const exists = fileExists(filePath);
+    logDebug('File existence check', { filePath, exists });
+    return exists;
+}
+/**
+ * Run specific tests and check if they pass
+ */
+export async function runTests(testPattern) {
+    logDebug('Running tests', { pattern: testPattern });
+    try {
+        // Run vitest with specific pattern
+        const command = `npm test -- --run ${testPattern}`;
+        const { stdout, stderr } = await execAsync(command, {
+            timeout: 60000, // 60 second timeout
+        });
+        // Check for test failures in output
+        const output = stdout + stderr;
+        const hasFailed = output.includes('FAILED') ||
+            output.includes('failed') ||
+            output.includes('Error:');
+        logDebug('Test execution result', {
+            pattern: testPattern,
+            passed: !hasFailed,
+        });
+        return !hasFailed;
+    }
+    catch (error) {
+        // exec throws on non-zero exit code
+        const errorObj = error instanceof Error ? error : new Error(String(error));
+        logError('Test execution failed', errorObj, { pattern: testPattern });
+        return false;
+    }
+}
+/**
+ * Check if file has lint errors
+ */
+async function checkLintErrors(filePath) {
+    logDebug('Checking lint errors', { filePath });
+    try {
+        // Run eslint on specific file
+        const command = `npx eslint ${filePath} --format json`;
+        const { stdout } = await execAsync(command, {
+            timeout: 30000, // 30 second timeout
+        });
+        // Parse eslint JSON output
+        const results = JSON.parse(stdout);
+        // Check if there are any errors
+        const totalErrors = results.reduce((sum, result) => sum + result.errorCount, 0);
+        const noErrors = totalErrors === 0;
+        logDebug('Lint check result', {
+            filePath,
+            errors: totalErrors,
+            passed: noErrors,
+        });
+        return noErrors;
+    }
+    catch (error) {
+        // eslint returns non-zero exit code when errors found
+        // Try to parse the output to get error count
+        if (error instanceof Error && 'stdout' in error) {
+            try {
+                const results = JSON.parse(error.stdout);
+                const totalErrors = results.reduce((sum, result) => sum + result.errorCount, 0);
+                return totalErrors === 0;
+            }
+            catch {
+                // Failed to parse, assume errors
+                return false;
+            }
+        }
+        const errorObj = error instanceof Error ? error : new Error(String(error));
+        logError('Lint check failed', errorObj, { filePath });
+        return false;
+    }
+}
+/**
+ * Run custom validation command
+ */
+async function runCustomValidation(command) {
+    logDebug('Running custom validation', { command });
+    try {
+        await execAsync(command, {
+            timeout: 60000, // 60 second timeout
+        });
+        logDebug('Custom validation passed', { command });
+        return true;
+    }
+    catch (error) {
+        const errorObj = error instanceof Error ? error : new Error(String(error));
+        logError('Custom validation failed', errorObj, { command });
+        return false;
+    }
+}
+/**
+ * Generate default acceptance criteria for a task
+ */
+export function generateDefaultCriteria(task) {
+    const criteria = [];
+    // If task plan exists, generate criteria based on files
+    if (task.plan) {
+        // Check that all created files exist
+        const createSteps = task.plan.steps.filter(s => s.mode === 'create');
+        for (const step of createSteps) {
+            criteria.push({
+                description: `File ${step.target_file} exists`,
+                type: 'file_exists',
+                check: step.target_file,
+                met: false,
+            });
+            // If it's a test file, add a test_passes criterion
+            if (step.target_file.includes('.test.')) {
+                criteria.push({
+                    description: `Tests in ${step.target_file} pass`,
+                    type: 'test_passes',
+                    check: step.target_file,
+                    met: false,
+                });
+            }
+        }
+        // Add lint check for all touched files
+        const allFiles = new Set([
+            ...createSteps.map(s => s.target_file),
+            ...task.plan.steps.filter(s => s.mode !== 'create').map(s => s.target_file),
+        ]);
+        for (const file of allFiles) {
+            // Only check non-test files for lint
+            if (!file.includes('.test.')) {
+                criteria.push({
+                    description: `No lint errors in ${file}`,
+                    type: 'no_lint_errors',
+                    check: file,
+                    met: false,
+                });
+            }
+        }
+    }
+    return criteria;
+}
+/**
+ * Check if task can be marked as completed
+ */
+export function canCompleteTask(task) {
+    // All steps must be completed
+    if (task.steps_completed < task.steps_total) {
+        return false;
+    }
+    // All acceptance criteria must be met
+    if (task.acceptance_criteria.length > 0) {
+        return task.acceptance_criteria.every(c => c.met);
+    }
+    // If no criteria defined, task is complete when all steps done
+    return true;
+}
+//# sourceMappingURL=acceptance.js.map

package/dist/task/acceptance.js.map

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

package/dist/task/agent-coordinator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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 { Task, TaskStep, Mode } from '../types/index.js';
+export interface StepAssignment {
+    stepOrder: number;
+    targetFile: string;
+    mode: Mode;
+    description: string;
+    taskId: string;
+}
+export interface AgentResult {
+    stepOrder: number;
+    success: boolean;
+    traceId?: string;
+    error?: string;
+    exitCode: number | null;
+}
+/**
+ * Spawn an agent for a specific task step
+ * Each agent runs as an independent process via child_process.fork()
+ */
+export declare function spawnAgentForStep(task: Task, step: TaskStep): Promise<AgentResult>;
+/**
+ * Execute a wave of task steps in parallel using agent processes
+ * This is the true mycelium multi-agent coordination
+ */
+export declare function executeWaveWithAgents(task: Task, wave: TaskStep[]): Promise<AgentResult[]>;
+/**
+ * Get parallelizable steps grouped by dependency waves
+ * Same logic as before, but now we spawn agents for each wave
+ */
+export declare function getParallelizableSteps(steps: TaskStep[]): TaskStep[][];
+//# sourceMappingURL=agent-coordinator.d.ts.map

package/dist/task/agent-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-coordinator.d.ts","sourceRoot":"","sources":["../../src/task/agent-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAUzD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,WAAW,CAAC,CAsHtB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,QAAQ,EAAE,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAqBxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,CAqBtE"}