claude-mycelium 2.0.0

package/dist/prompts/error-reducer.js

@@ -0,0 +1,54 @@
+/**
+ * Error Reducer Prompt
+ * Focus: Fix bugs and add error handling
+ */
+import { getModeInstructions } from '../core/mode-selector.js';
+export function generatePrompt(context) {
+    const { file, content, gradient, rank, totalFiles } = context;
+    const { dominantSignal, signals, score } = gradient;
+    const rankInfo = rank && totalFiles
+        ? `(ranked #${rank} of ${totalFiles})`
+        : '';
+    return `# Task
+You are improving \`${file}\` in mode \`error_reducer\`.
+
+## File Context
+**Current gradient**: ${score.toFixed(3)} ${rankInfo}
+**Dominant issue**: ${dominantSignal.name} = ${dominantSignal.value.toFixed(3)}
+
+${getModeInstructions('error_reducer')}
+
+## Current File Content
+\`\`\`typescript
+${content}
+\`\`\`
+
+## Your Task
+Fix bugs and improve error handling in this file:
+
+1. Analyze the code for potential errors:
+   - Null/undefined access patterns
+   - Missing error handling
+   - Type errors or mismatches
+   - Edge cases and off-by-one errors
+   - Input validation issues
+
+2. Make minimal, focused fixes:
+   - Add try/catch blocks where appropriate
+   - Add null checks before accessing properties
+   - Improve error messages
+   - Add input validation
+
+3. Preserve existing functionality:
+   - Do NOT refactor for style
+   - Do NOT change the public API
+   - Do NOT add new features
+
+**Important**:
+- Make minimal, focused changes
+- Preserve existing functionality
+- Add tests if removing code
+- Keep the same file structure
+- Explain what you changed and why`;
+}
+//# sourceMappingURL=error-reducer.js.map

package/dist/prompts/error-reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reducer.js","sourceRoot":"","sources":["../../src/prompts/error-reducer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC9D,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IAEpD,MAAM,QAAQ,GAAG,IAAI,IAAI,UAAU;QACjC,CAAC,CAAC,YAAY,IAAI,OAAO,UAAU,GAAG;QACtC,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;sBACa,IAAI;;;wBAGF,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ;sBAC9B,cAAc,CAAC,IAAI,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;;EAE5E,mBAAmB,CAAC,eAAe,CAAC;;;;EAIpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA6B0B,CAAC;AACpC,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Prompt Templates
+ * Per initial-spec §4.1
+ *
+ * Mode-specific prompts for guiding agents.
+ * Each prompt provides context and instructions for a specific improvement mode.
+ */
+import type { Mode, GradientScore } from '../types/index.js';
+export { generatePrompt as generateErrorReducerPrompt } from './error-reducer.js';
+export { generatePrompt as generateComplexityReducerPrompt } from './complexity-reducer.js';
+export { generatePrompt as generateDebtPayerPrompt } from './debt-payer.js';
+export { generatePrompt as generateStabilizerPrompt } from './stabilizer.js';
+export type { PromptContext } from './types.js';
+/**
+ * Build complete prompt for agent (system + user)
+ * Used by agent-executor
+ */
+export declare function buildPrompt(file: string, mode: Mode, gradient: GradientScore): Promise<{
+    system: string;
+    user: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EAAE,cAAc,IAAI,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkE3C"}

package/dist/prompts/index.js

@@ -0,0 +1,112 @@
+/**
+ * Prompt Templates
+ * Per initial-spec §4.1
+ *
+ * Mode-specific prompts for guiding agents.
+ * Each prompt provides context and instructions for a specific improvement mode.
+ */
+import { readFile } from 'fs/promises';
+export { generatePrompt as generateErrorReducerPrompt } from './error-reducer.js';
+export { generatePrompt as generateComplexityReducerPrompt } from './complexity-reducer.js';
+export { generatePrompt as generateDebtPayerPrompt } from './debt-payer.js';
+export { generatePrompt as generateStabilizerPrompt } from './stabilizer.js';
+/**
+ * Build complete prompt for agent (system + user)
+ * Used by agent-executor
+ */
+export async function buildPrompt(file, mode, gradient) {
+    // Read file content
+    const content = await readFile(file, 'utf-8');
+    // Build context
+    const context = {
+        file,
+        content,
+        gradient,
+        mode,
+    };
+    // Generate mode-specific prompt
+    let userPrompt;
+    switch (mode) {
+        case 'error_reducer': {
+            const { generatePrompt } = await import('./error-reducer.js');
+            userPrompt = generatePrompt(context);
+            break;
+        }
+        case 'complexity_reducer': {
+            const { generatePrompt } = await import('./complexity-reducer.js');
+            userPrompt = generatePrompt(context);
+            break;
+        }
+        case 'debt_payer': {
+            const { generatePrompt } = await import('./debt-payer.js');
+            userPrompt = generatePrompt(context);
+            break;
+        }
+        case 'stabilizer': {
+            const { generatePrompt } = await import('./stabilizer.js');
+            userPrompt = generatePrompt(context);
+            break;
+        }
+        case 'explorer': {
+            // Explorer mode - use generic improvement prompt
+            userPrompt = buildExplorerPrompt(context);
+            break;
+        }
+        default:
+            throw new Error(`Unknown mode: ${mode}`);
+    }
+    // System prompt is common across all modes
+    const systemPrompt = `You are a code improvement agent. Your task is to analyze and improve code files.
+
+CRITICAL OUTPUT FORMAT:
+1. Brief analysis (2-3 sentences)
+2. Complete modified file in code fence:
+
+\`\`\`typescript
+// complete modified code here
+\`\`\`
+
+RULES:
+- Output COMPLETE file, not just changes
+- Make MINIMAL changes for your mode's focus
+- PRESERVE all existing functionality
+- Do NOT add comments explaining changes
+- Do NOT introduce new dependencies`;
+    return {
+        system: systemPrompt,
+        user: userPrompt,
+    };
+}
+/**
+ * Build explorer mode prompt
+ */
+function buildExplorerPrompt(context) {
+    const { file, content, gradient } = context;
+    return `# Task
+You are exploring \`${file}\` to find novel improvement opportunities.
+
+## File Context
+**Gradient**: ${gradient.score.toFixed(3)}
+**Dominant issue**: ${gradient.dominantSignal.name} = ${gradient.dominantSignal.value.toFixed(3)}
+
+## Explorer Mode Instructions
+This file has resisted conventional improvements. You have permission to:
+- Challenge fundamental assumptions
+- Suggest structural changes (within limits)
+- Try unconventional approaches
+
+**Constraints**:
+- Maximum 50 lines changed
+- Cannot change public API signatures
+- Cannot remove validation logic
+- Changes will be flagged for human review
+
+## Current File Content
+\`\`\`typescript
+${content}
+\`\`\`
+
+## Your Task
+Explore creative improvements to this file while respecting the constraints.`;
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAAE,cAAc,IAAI,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,cAAc,IAAI,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,cAAc,IAAI,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAI7E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,IAAU,EACV,QAAuB;IAEvB,oBAAoB;IACpB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE9C,gBAAgB;IAChB,MAAM,OAAO,GAAkB;QAC7B,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,IAAI;KACL,CAAC;IAEF,gCAAgC;IAChC,IAAI,UAAkB,CAAC;IACvB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC9D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YACnE,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC3D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC3D,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,iDAAiD;YACjD,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM;QACR,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,2CAA2C;IAC3C,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;oCAea,CAAC;IAEnC,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,IAAI,EAAE,UAAU;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAsB;IACjD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE5C,OAAO;sBACa,IAAI;;;gBAGV,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;sBACnB,QAAQ,CAAC,cAAc,CAAC,IAAI,MAAM,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;EAgB9F,OAAO;;;;6EAIoE,CAAC;AAC9E,CAAC"}

package/dist/prompts/stabilizer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Stabilizer Prompt
+ * Focus: Reduce churn with tests and documentation
+ */
+import type { PromptContext } from './types.js';
+export declare function generatePrompt(context: PromptContext): string;
+//# sourceMappingURL=stabilizer.d.ts.map

package/dist/prompts/stabilizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stabilizer.d.ts","sourceRoot":"","sources":["../../src/prompts/stabilizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAkD7D"}

package/dist/prompts/stabilizer.js

@@ -0,0 +1,55 @@
+/**
+ * Stabilizer Prompt
+ * Focus: Reduce churn with tests and documentation
+ */
+import { getModeInstructions } from '../core/mode-selector.js';
+export function generatePrompt(context) {
+    const { file, content, gradient, rank, totalFiles } = context;
+    const { dominantSignal, signals, score } = gradient;
+    const rankInfo = rank && totalFiles
+        ? `(ranked #${rank} of ${totalFiles})`
+        : '';
+    return `# Task
+You are improving \`${file}\` in mode \`stabilizer\`.
+
+## File Context
+**Current gradient**: ${score.toFixed(3)} ${rankInfo}
+**Dominant issue**: ${dominantSignal.name} = ${dominantSignal.value.toFixed(3)}
+
+${getModeInstructions('stabilizer')}
+
+## Current File Content
+\`\`\`typescript
+${content}
+\`\`\`
+
+## Your Task
+Improve stability to reduce future changes:
+
+1. Identify stability issues:
+   - Missing tests
+   - Unclear behavior that requires frequent changes
+   - Weak interfaces that allow misuse
+   - Magic numbers without constants
+   - Poor encapsulation
+
+2. Make stability improvements:
+   - Add unit tests for untested code
+   - Document unclear behavior
+   - Improve interfaces to prevent misuse
+   - Extract constants from magic numbers
+   - Improve encapsulation
+
+3. Avoid major changes:
+   - Do NOT refactor internals (use complexity_reducer for that)
+   - Do NOT change public APIs without good reason
+   - Do NOT remove existing tests
+
+**Important**:
+- Make minimal, focused changes
+- Preserve existing functionality
+- Add tests if removing code
+- Keep the same file structure
+- Explain what you changed and why`;
+}
+//# sourceMappingURL=stabilizer.js.map

package/dist/prompts/stabilizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stabilizer.js","sourceRoot":"","sources":["../../src/prompts/stabilizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC9D,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IAEpD,MAAM,QAAQ,GAAG,IAAI,IAAI,UAAU;QACjC,CAAC,CAAC,YAAY,IAAI,OAAO,UAAU,GAAG;QACtC,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;sBACa,IAAI;;;wBAGF,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ;sBAC9B,cAAc,CAAC,IAAI,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;;EAE5E,mBAAmB,CAAC,YAAY,CAAC;;;;EAIjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA8B0B,CAAC;AACpC,CAAC"}

package/dist/prompts/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Prompt Template Types
+ */
+import type { Mode } from '../types/index.js';
+import type { GradientScore } from '../core/gradient.js';
+export interface PromptContext {
+    file: string;
+    content: string;
+    gradient: GradientScore;
+    mode: Mode;
+    rank?: number;
+    totalFiles?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/prompts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompts/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/prompts/types.js

@@ -0,0 +1,5 @@
+/**
+ * Prompt Template Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/prompts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/prompts/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/trace/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Trace Module - Event Tracking System
+ *
+ * Per Phase 2 specification, this tracks:
+ * - Agent execution traces with timing
+ * - File changes (additions, deletions, modifications)
+ * - Gradient measurements (before/after)
+ * - Cost metrics (tokens, USD)
+ * - CI pass/fail status
+ *
+ * Traces are stored as JSON Lines format for efficient querying.
+ *
+ * Usage:
+ * ```typescript
+ * import { recordTraceEvent } from './trace/index.js';
+ * await recordTraceEvent({ ... });
+ * ```
+ */
+import type { TraceEvent, ChangeSet } from '../types/index.js';
+/**
+ * Create a trace event for an agent execution
+ */
+export declare function createTraceEvent(data: {
+    filePath: string;
+    mode: string;
+    gradientBefore: number;
+    gradientAfter: number;
+    metabolicCost: number;
+    efficiency: number;
+    ciPassed: boolean;
+    changes: ChangeSet;
+    costRecord: {
+        tokens_in: number;
+        tokens_out: number;
+        model: string;
+        estimated_usd: number;
+    };
+    notes?: string[];
+    taskId?: string;
+    agentId?: string;
+}): TraceEvent;
+/**
+ * Record a trace event to the trace log
+ * In Phase 2, we store this in memory; in Phase 3+ it goes to persistent storage
+ */
+export declare function recordTraceEvent(event: TraceEvent): Promise<void>;
+/**
+ * Export trace event type and utilities for Phase 2 integration
+ */
+export type { TraceEvent, ChangeSet } from '../types/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,UAAU,CAoBb;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvE;AAED;;GAEG;AACH,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/trace/index.js

@@ -0,0 +1,60 @@
+/**
+ * Trace Module - Event Tracking System
+ *
+ * Per Phase 2 specification, this tracks:
+ * - Agent execution traces with timing
+ * - File changes (additions, deletions, modifications)
+ * - Gradient measurements (before/after)
+ * - Cost metrics (tokens, USD)
+ * - CI pass/fail status
+ *
+ * Traces are stored as JSON Lines format for efficient querying.
+ *
+ * Usage:
+ * ```typescript
+ * import { recordTraceEvent } from './trace/index.js';
+ * await recordTraceEvent({ ... });
+ * ```
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { logDebug } from '../utils/logger.js';
+/**
+ * Create a trace event for an agent execution
+ */
+export function createTraceEvent(data) {
+    const now = new Date().toISOString();
+    return {
+        id: uuidv4(),
+        timestamp: now,
+        file_path: data.filePath,
+        mode: data.mode,
+        gradient_before: data.gradientBefore,
+        gradient_after: data.gradientAfter,
+        gradient_delta: data.gradientAfter - data.gradientBefore,
+        metabolic_cost: data.metabolicCost,
+        efficiency: data.efficiency,
+        ci_passed: data.ciPassed,
+        changes: data.changes,
+        notes: data.notes || [],
+        task_id: data.taskId,
+        agent_id: data.agentId,
+        cost: data.costRecord,
+    };
+}
+/**
+ * Record a trace event to the trace log
+ * In Phase 2, we store this in memory; in Phase 3+ it goes to persistent storage
+ */
+export async function recordTraceEvent(event) {
+    logDebug('Trace event recorded', {
+        event_id: event.id,
+        file: event.file_path,
+        mode: event.mode,
+        gradient_delta: event.gradient_delta.toFixed(3),
+        cost_usd: event.cost.estimated_usd.toFixed(4),
+    });
+    // In Phase 2, trace events are collected in memory
+    // In Phase 3+, they will be written to persistent storage (JSON Lines format)
+    // For now, this is a no-op that validates the event structure
+}
+//# sourceMappingURL=index.js.map

package/dist/trace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAkBhC;IACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,OAAO;QACL,EAAE,EAAE,MAAM,EAAE;QACZ,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,IAAI,EAAE,IAAI,CAAC,IAAW;QACtB,eAAe,EAAE,IAAI,CAAC,cAAc;QACpC,cAAc,EAAE,IAAI,CAAC,aAAa;QAClC,cAAc,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,cAAc;QACxD,cAAc,EAAE,IAAI,CAAC,aAAa;QAClC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,OAAO,EAAE,IAAI,CAAC,MAAM;QACpB,QAAQ,EAAE,IAAI,CAAC,OAAO;QACtB,IAAI,EAAE,IAAI,CAAC,UAAU;KACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAiB;IACtD,QAAQ,CAAC,sBAAsB,EAAE;QAC/B,QAAQ,EAAE,KAAK,CAAC,EAAE;QAClB,IAAI,EAAE,KAAK,CAAC,SAAS;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;KAC9C,CAAC,CAAC;IAEH,mDAAmD;IACnD,8EAA8E;IAC9E,8DAA8D;AAChE,CAAC"}

package/dist/trace/trace-event.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Trace Event System for Claude-Mycelium
+ * Records agent actions for learning and analysis
+ * Storage: .agent-meta/traces.jsonl (JSON Lines format)
+ */
+export type Mode = 'error_reducer' | 'complexity_reducer' | 'debt_payer' | 'stabilizer' | 'explorer';
+export interface TraceEvent {
+    id: string;
+    timestamp: string;
+    agent_id: string;
+    file_path: string;
+    mode: Mode;
+    gradient_before: number;
+    gradient_after: number;
+    gradient_delta: number;
+    changes_made: string[];
+    tokens_used: number;
+    cost_usd: number;
+    duration_ms: number;
+    success: boolean;
+    error?: string;
+}
+export interface TraceFilters {
+    file?: string;
+    mode?: Mode;
+    since?: Date;
+    limit?: number;
+}
+export interface TraceStats {
+    totalCost: number;
+    avgDelta: number;
+    successRate: number;
+    totalTraces: number;
+}
+/**
+ * Record a trace event to the append-only log
+ */
+export declare function recordTrace(event: TraceEvent): Promise<void>;
+/**
+ * Read traces with optional filters
+ * Returns traces sorted by timestamp (newest first)
+ */
+export declare function readTraces(filters?: TraceFilters): Promise<TraceEvent[]>;
+/**
+ * Calculate recent efficiency for a file
+ * Efficiency = gradient improvement per dollar spent
+ * Returns null if insufficient data
+ */
+export declare function getRecentEfficiency(file: string, lastN?: number): Promise<number | null>;
+/**
+ * Calculate efficiency from traces
+ * Efficiency = sum(gradient_delta) / sum(cost_usd)
+ */
+export declare function calculateEfficiency(traces: TraceEvent[]): number;
+/**
+ * Get statistics from traces
+ */
+export declare function getTraceStats(traces: TraceEvent[]): TraceStats;
+/**
+ * Generate a unique trace ID
+ */
+export declare function generateTraceId(): string;
+/**
+ * Calculate cost from token usage
+ * Based on model pricing (Claude Sonnet 4)
+ */
+export declare function calculateCost(tokensIn: number, tokensOut: number, model?: string): number;
+/**
+ * Create a trace event with defaults
+ */
+export declare function createTraceEvent(partial: Omit<TraceEvent, 'id' | 'timestamp' | 'gradient_delta'>): TraceEvent;
+//# sourceMappingURL=trace-event.d.ts.map

package/dist/trace/trace-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-event.d.ts","sourceRoot":"","sources":["../../src/trace/trace-event.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,oBAAoB,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;AAErG,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BlE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAkD9E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAchE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAoB9D;AA4ED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAA0B,GAAG,MAAM,CAe5G;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,CAAC,GAC/D,UAAU,CAOZ"}