claude-mycelium 2.0.0

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * Claude-Mycelium v2.0
+ * Main Entry Point
+ *
+ * Decentralized, gradient-driven agent system for autonomous codebase improvement.
+ *
+ * Core exports:
+ * - Core: Signals, Gradient, Mode Selection
+ * - LLM: Anthropic integration
+ * - Trace: Event tracking
+ * - Cost: Token and cost tracking
+ * - Utils: Logging, file I/O, configuration
+ * - Types: Complete TypeScript interfaces
+ *
+ * Per initial-spec and Phase 2 spec.
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   calculateGradient,
+ *   selectMode,
+ *   createAnthropicClient,
+ *   recordTraceEvent,
+ *   calculateCost,
+ * } from 'claude-mycelium';
+ * ```
+ */
+// Core Phase 1 modules
+export * from './core/index.js';
+export * from './coordination/index.js';
+// Phase 2 modules - note: anthropic-client calculates cost too, so we
+// only export from cost/index (not the full llm module to avoid conflicts)
+export { createAnthropicClient, LLMError } from './llm/index.js';
+export * from './trace/index.js';
+export * from './cost/index.js';
+// Utilities
+export * from './utils/index.js';
+// Types
+export * from './types/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,uBAAuB;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AAExC,sEAAsE;AACtE,2EAA2E;AAC3E,OAAO,EAAE,qBAAqB,EAAqC,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpG,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAEhC,YAAY;AACZ,cAAc,kBAAkB,CAAC;AAEjC,QAAQ;AACR,cAAc,kBAAkB,CAAC"}

package/dist/llm/anthropic-client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Anthropic API Client
+ * Per second-spec §3: LLM Integration
+ *
+ * Provides non-streaming and streaming interfaces to Claude API
+ * with automatic retries, error handling, and cost tracking.
+ */
+/**
+ * Request configuration for LLM calls
+ */
+export interface LLMRequest {
+    prompt: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    systemPrompt?: string;
+}
+/**
+ * Response from LLM call with usage metrics
+ */
+export interface LLMResponse {
+    content: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    model: string;
+}
+/**
+ * Error types for better error handling
+ */
+export declare class LLMError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly originalError?: unknown | undefined;
+    constructor(message: string, code: string, retryable?: boolean, originalError?: unknown | undefined);
+}
+/**
+ * Make a non-streaming LLM call with automatic retries
+ */
+export declare function callLLM(request: LLMRequest): Promise<LLMResponse>;
+/**
+ * Stream LLM responses with automatic retries
+ * Yields content chunks as they arrive
+ */
+export declare function streamLLM(request: LLMRequest): AsyncGenerator<string, void, undefined>;
+/**
+ * Calculate cost in USD for a given token usage
+ * Pricing per second-spec §3.3
+ */
+export declare function calculateCost(model: string, inputTokens: number, outputTokens: number): number;
+//# sourceMappingURL=anthropic-client.d.ts.map

package/dist/llm/anthropic-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-client.d.ts","sourceRoot":"","sources":["../../src/llm/anthropic-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf;AAWD;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,OAAO;aAClB,aAAa,CAAC,EAAE,OAAO;gBAHvC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,OAAe,EAC1B,aAAa,CAAC,EAAE,OAAO,YAAA;CAK1C;AAiID;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAgGvE;AAED;;;GAGG;AACH,wBAAuB,SAAS,CAC9B,OAAO,EAAE,UAAU,GAClB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CA8FzC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAkBR"}

package/dist/llm/anthropic-client.js

@@ -0,0 +1,310 @@
+/**
+ * Anthropic API Client
+ * Per second-spec §3: LLM Integration
+ *
+ * Provides non-streaming and streaming interfaces to Claude API
+ * with automatic retries, error handling, and cost tracking.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { logDebug, logError, logWarn } from '../utils/logger.js';
+/**
+ * Configuration defaults
+ */
+const DEFAULT_MODEL = 'claude-sonnet-4-5-20250929';
+const DEFAULT_MAX_TOKENS = 8000;
+const DEFAULT_TEMPERATURE = 0.7;
+const MAX_RETRIES = 3;
+const INITIAL_RETRY_DELAY_MS = 1000;
+/**
+ * Error types for better error handling
+ */
+export class LLMError extends Error {
+    code;
+    retryable;
+    originalError;
+    constructor(message, code, retryable = false, originalError) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.originalError = originalError;
+        this.name = 'LLMError';
+    }
+}
+/**
+ * Validate that API key is configured
+ */
+function getAPIKey() {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        throw new LLMError('ANTHROPIC_API_KEY environment variable is not set. Please configure your API key.', 'MISSING_API_KEY', false);
+    }
+    return apiKey;
+}
+/**
+ * Create Anthropic client instance
+ */
+function createClient() {
+    const apiKey = getAPIKey();
+    return new Anthropic({ apiKey });
+}
+/**
+ * Calculate exponential backoff delay
+ */
+function calculateBackoff(attempt) {
+    return INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt);
+}
+/**
+ * Sleep utility for retry delays
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Determine if an error is retryable
+ */
+function isRetryableError(error) {
+    // Check for Anthropic API errors with status property
+    if (typeof error === 'object' && error !== null && 'status' in error) {
+        const status = error.status;
+        // Rate limit errors are retryable
+        if (status === 429)
+            return true;
+        // Server errors are retryable
+        if (status >= 500)
+            return true;
+    }
+    // Check for connection errors
+    if (error instanceof Error) {
+        if (error.message?.includes('ECONNRESET'))
+            return true;
+        if (error.message?.includes('ETIMEDOUT'))
+            return true;
+    }
+    return false;
+}
+/**
+ * Convert API error to LLMError
+ */
+function handleAPIError(error) {
+    // Don't wrap if already an LLMError
+    if (error instanceof LLMError) {
+        return error;
+    }
+    // Handle Anthropic API errors with status code
+    if (typeof error === 'object' && error !== null && 'status' in error) {
+        const apiError = error;
+        const status = apiError.status;
+        const message = apiError.message || 'API error';
+        const retryable = isRetryableError(error);
+        if (status === 429) {
+            return new LLMError('Rate limit exceeded. Retrying with exponential backoff.', 'RATE_LIMIT', true, error);
+        }
+        if (status === 401) {
+            return new LLMError('Invalid API key. Please check your ANTHROPIC_API_KEY.', 'INVALID_API_KEY', false, error);
+        }
+        if (status >= 500) {
+            return new LLMError(`Anthropic API error: ${message}`, 'SERVER_ERROR', true, error);
+        }
+        return new LLMError(`API error: ${message}`, 'API_ERROR', retryable, error);
+    }
+    if (error instanceof Error) {
+        return new LLMError(`Unexpected error: ${error.message}`, 'UNKNOWN_ERROR', isRetryableError(error), error);
+    }
+    return new LLMError('Unknown error occurred', 'UNKNOWN_ERROR', false, error);
+}
+/**
+ * Make a non-streaming LLM call with automatic retries
+ */
+export async function callLLM(request) {
+    const client = createClient();
+    const model = request.model ?? DEFAULT_MODEL;
+    const maxTokens = request.maxTokens ?? DEFAULT_MAX_TOKENS;
+    const temperature = request.temperature ?? DEFAULT_TEMPERATURE;
+    logDebug('Making LLM call', {
+        model,
+        maxTokens,
+        temperature,
+        promptLength: request.prompt.length,
+        hasSystemPrompt: !!request.systemPrompt,
+    });
+    let lastError = null;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        try {
+            const response = await client.messages.create({
+                model,
+                max_tokens: maxTokens,
+                temperature,
+                system: request.systemPrompt,
+                messages: [
+                    {
+                        role: 'user',
+                        content: request.prompt,
+                    },
+                ],
+            });
+            // Extract text content
+            const textContent = response.content.find(block => block.type === 'text');
+            if (!textContent || textContent.type !== 'text') {
+                const error = new LLMError('No text content in API response', 'INVALID_RESPONSE', false);
+                logError('Invalid API response', error, { model });
+                throw error;
+            }
+            const result = {
+                content: textContent.text,
+                usage: {
+                    inputTokens: response.usage.input_tokens,
+                    outputTokens: response.usage.output_tokens,
+                },
+                model: response.model,
+            };
+            logDebug('LLM call completed', {
+                model: result.model,
+                inputTokens: result.usage.inputTokens,
+                outputTokens: result.usage.outputTokens,
+                contentLength: result.content.length,
+                attempts: attempt + 1,
+            });
+            return result;
+        }
+        catch (error) {
+            lastError = handleAPIError(error);
+            // Don't retry if error is not retryable
+            if (!lastError.retryable) {
+                logError('Non-retryable LLM error', lastError, {
+                    code: lastError.code,
+                    model,
+                });
+                throw lastError;
+            }
+            // Don't retry on last attempt
+            if (attempt === MAX_RETRIES - 1) {
+                break;
+            }
+            const backoffMs = calculateBackoff(attempt);
+            logWarn('LLM call failed, retrying', {
+                code: lastError.code,
+                attempt: attempt + 1,
+                maxRetries: MAX_RETRIES,
+                backoffMs,
+            });
+            await sleep(backoffMs);
+        }
+    }
+    // All retries exhausted
+    logError('LLM call failed after all retries', lastError, {
+        maxRetries: MAX_RETRIES,
+        model,
+    });
+    throw lastError;
+}
+/**
+ * Stream LLM responses with automatic retries
+ * Yields content chunks as they arrive
+ */
+export async function* streamLLM(request) {
+    const client = createClient();
+    const model = request.model ?? DEFAULT_MODEL;
+    const maxTokens = request.maxTokens ?? DEFAULT_MAX_TOKENS;
+    const temperature = request.temperature ?? DEFAULT_TEMPERATURE;
+    logDebug('Starting LLM stream', {
+        model,
+        maxTokens,
+        temperature,
+        promptLength: request.prompt.length,
+        hasSystemPrompt: !!request.systemPrompt,
+    });
+    let lastError = null;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        try {
+            const stream = await client.messages.create({
+                model,
+                max_tokens: maxTokens,
+                temperature,
+                system: request.systemPrompt,
+                messages: [
+                    {
+                        role: 'user',
+                        content: request.prompt,
+                    },
+                ],
+                stream: true,
+            });
+            let totalTokensIn = 0;
+            let totalTokensOut = 0;
+            let totalContent = '';
+            for await (const event of stream) {
+                if (event.type === 'message_start') {
+                    totalTokensIn = event.message.usage.input_tokens;
+                }
+                else if (event.type === 'content_block_delta') {
+                    if (event.delta.type === 'text_delta') {
+                        const chunk = event.delta.text;
+                        totalContent += chunk;
+                        yield chunk;
+                    }
+                }
+                else if (event.type === 'message_delta') {
+                    totalTokensOut = event.usage.output_tokens;
+                }
+            }
+            logDebug('LLM stream completed', {
+                model,
+                inputTokens: totalTokensIn,
+                outputTokens: totalTokensOut,
+                contentLength: totalContent.length,
+                attempts: attempt + 1,
+            });
+            return;
+        }
+        catch (error) {
+            lastError = handleAPIError(error);
+            // Don't retry if error is not retryable
+            if (!lastError.retryable) {
+                logError('Non-retryable LLM streaming error', lastError, {
+                    code: lastError.code,
+                    model,
+                });
+                throw lastError;
+            }
+            // Don't retry on last attempt
+            if (attempt === MAX_RETRIES - 1) {
+                break;
+            }
+            const backoffMs = calculateBackoff(attempt);
+            logWarn('LLM stream failed, retrying', {
+                code: lastError.code,
+                attempt: attempt + 1,
+                maxRetries: MAX_RETRIES,
+                backoffMs,
+            });
+            await sleep(backoffMs);
+        }
+    }
+    // All retries exhausted
+    logError('LLM stream failed after all retries', lastError, {
+        maxRetries: MAX_RETRIES,
+        model,
+    });
+    throw lastError;
+}
+/**
+ * Calculate cost in USD for a given token usage
+ * Pricing per second-spec §3.3
+ */
+export function calculateCost(model, inputTokens, outputTokens) {
+    const pricing = {
+        'claude-sonnet-4-5-20250929': { input: 3.0, output: 15.0 },
+        'claude-sonnet-4-20250514': { input: 3.0, output: 15.0 },
+        'claude-haiku-4-20250514': { input: 0.25, output: 1.25 },
+    };
+    const modelPricing = pricing[model];
+    if (!modelPricing) {
+        logWarn('Unknown model for cost calculation, returning 0', { model });
+        return 0;
+    }
+    // Pricing is per million tokens
+    const inputCost = (inputTokens / 1_000_000) * modelPricing.input;
+    const outputCost = (outputTokens / 1_000_000) * modelPricing.output;
+    return inputCost + outputCost;
+}
+//# sourceMappingURL=anthropic-client.js.map

package/dist/llm/anthropic-client.js.map

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

package/dist/llm/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * LLM Module - Anthropic Integration
+ *
+ * Exports the Anthropic SDK client and utilities for AI model interactions.
+ * Per Phase 2 specification, this provides:
+ * - Model instantiation (Claude)
+ * - Prompt generation and response handling
+ * - Token counting and cost estimation
+ * - Automatic retries and error handling
+ *
+ * Usage:
+ * ```typescript
+ * import { createAnthropicClient, callClaude } from './llm/index.js';
+ * const client = createAnthropicClient();
+ * const response = await callClaude({ prompt: '...' });
+ * ```
+ */
+import Anthropic from '@anthropic-ai/sdk';
+export * from './anthropic-client.js';
+/**
+ * Create and configure Anthropic client
+ * Uses API key from ANTHROPIC_API_KEY environment variable
+ */
+export declare function createAnthropicClient(): Anthropic;
+export type { Message, MessageParam, ContentBlock } from '@anthropic-ai/sdk/resources';
+export { Anthropic };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,cAAc,uBAAuB,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,CAWjD;AAGD,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,34 @@
+/**
+ * LLM Module - Anthropic Integration
+ *
+ * Exports the Anthropic SDK client and utilities for AI model interactions.
+ * Per Phase 2 specification, this provides:
+ * - Model instantiation (Claude)
+ * - Prompt generation and response handling
+ * - Token counting and cost estimation
+ * - Automatic retries and error handling
+ *
+ * Usage:
+ * ```typescript
+ * import { createAnthropicClient, callClaude } from './llm/index.js';
+ * const client = createAnthropicClient();
+ * const response = await callClaude({ prompt: '...' });
+ * ```
+ */
+import Anthropic from '@anthropic-ai/sdk';
+// Export all utilities from anthropic-client
+export * from './anthropic-client.js';
+/**
+ * Create and configure Anthropic client
+ * Uses API key from ANTHROPIC_API_KEY environment variable
+ */
+export function createAnthropicClient() {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        throw new Error('ANTHROPIC_API_KEY environment variable not set. ' +
+            'Please set your Anthropic API key to use the LLM module.');
+    }
+    return new Anthropic({ apiKey });
+}
+export { Anthropic };
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,6CAA6C;AAC7C,cAAc,uBAAuB,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,kDAAkD;YAChD,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AACnC,CAAC;AAID,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/prompts/complexity-reducer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Complexity Reducer Prompt
+ * Focus: Simplify and refactor complex code
+ */
+import type { PromptContext } from './types.js';
+export declare function generatePrompt(context: PromptContext): string;
+//# sourceMappingURL=complexity-reducer.d.ts.map

package/dist/prompts/complexity-reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-reducer.d.ts","sourceRoot":"","sources":["../../src/prompts/complexity-reducer.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/complexity-reducer.js

@@ -0,0 +1,55 @@
+/**
+ * Complexity Reducer Prompt
+ * Focus: Simplify and refactor complex code
+ */
+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 \`complexity_reducer\`.
+
+## File Context
+**Current gradient**: ${score.toFixed(3)} ${rankInfo}
+**Dominant issue**: ${dominantSignal.name} = ${dominantSignal.value.toFixed(3)}
+
+${getModeInstructions('complexity_reducer')}
+
+## Current File Content
+\`\`\`typescript
+${content}
+\`\`\`
+
+## Your Task
+Simplify and refactor this code to reduce complexity:
+
+1. Identify complexity issues:
+   - Long functions (>20 lines)
+   - Deep nesting (>3 levels)
+   - Complex conditionals
+   - Duplicate code patterns
+   - Unclear variable names
+
+2. Refactor to simplify:
+   - Extract long functions into smaller ones
+   - Reduce nesting with early returns
+   - Simplify conditional logic
+   - Remove code duplication
+   - Improve naming for clarity
+
+3. Preserve behavior:
+   - Do NOT change functionality
+   - Do NOT fix bugs (use error_reducer for that)
+   - Do NOT remove tests or validation
+
+**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=complexity-reducer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-reducer.js","sourceRoot":"","sources":["../../src/prompts/complexity-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,oBAAoB,CAAC;;;;EAIzC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA8B0B,CAAC;AACpC,CAAC"}

package/dist/prompts/debt-payer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Debt Payer Prompt
+ * Focus: Fix lint issues and improve code quality
+ */
+import type { PromptContext } from './types.js';
+export declare function generatePrompt(context: PromptContext): string;
+//# sourceMappingURL=debt-payer.d.ts.map

package/dist/prompts/debt-payer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debt-payer.d.ts","sourceRoot":"","sources":["../../src/prompts/debt-payer.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/debt-payer.js

@@ -0,0 +1,55 @@
+/**
+ * Debt Payer Prompt
+ * Focus: Fix lint issues and improve code quality
+ */
+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 \`debt_payer\`.
+
+## File Context
+**Current gradient**: ${score.toFixed(3)} ${rankInfo}
+**Dominant issue**: ${dominantSignal.name} = ${dominantSignal.value.toFixed(3)}
+
+${getModeInstructions('debt_payer')}
+
+## Current File Content
+\`\`\`typescript
+${content}
+\`\`\`
+
+## Your Task
+Fix technical debt and improve code quality:
+
+1. Identify quality issues:
+   - ESLint errors and warnings
+   - Missing type annotations
+   - Poor naming conventions
+   - Unused imports or variables
+   - Formatting inconsistencies
+
+2. Make quality improvements:
+   - Fix ESLint errors
+   - Add TypeScript types
+   - Improve variable/function names
+   - Remove unused code
+   - Fix formatting
+
+3. Stay focused on quality:
+   - Do NOT refactor structure (use complexity_reducer for that)
+   - Do NOT fix logic bugs (use error_reducer for that)
+   - Do NOT change functionality
+
+**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=debt-payer.js.map

package/dist/prompts/debt-payer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debt-payer.js","sourceRoot":"","sources":["../../src/prompts/debt-payer.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/error-reducer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error Reducer Prompt
+ * Focus: Fix bugs and add error handling
+ */
+import type { PromptContext } from './types.js';
+export declare function generatePrompt(context: PromptContext): string;
+//# sourceMappingURL=error-reducer.d.ts.map

package/dist/prompts/error-reducer.d.ts.map

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