codehere 0.1.1

package/dist/utils/diff-parser.js

@@ -0,0 +1,192 @@
+/**
+ * Unified Diff Parser
+ * Parses and applies unified diff patches to file content
+ *
+ * Handles standard unified diff format:
+ * --- a/filepath
+ * +++ b/filepath
+ * @@ -start,count +start,count @@
+ * -old line (remove)
+ * +new line (add)
+ *  context line (keep)
+ */
+/**
+ * Apply a unified diff to file content
+ */
+export function applyUnifiedDiff(originalContent, diff) {
+    if (!diff || !diff.trim()) {
+        return originalContent;
+    }
+    // Clean diff - remove any markdown formatting
+    let cleanDiff = diff.trim();
+    // Extract the actual diff lines
+    const diffLines = cleanDiff.split('\n');
+    const originalLines = originalContent.split('\n');
+    const result = [];
+    let originalIndex = 0; // Current position in original file
+    let inHunk = false;
+    let hunkStartLine = 0; // Line number where hunk starts (1-based from diff)
+    let hunkOldLineCount = 0; // Number of old lines in this hunk
+    let hunkOldLinesProcessed = 0; // How many old lines we've processed
+    for (let i = 0; i < diffLines.length; i++) {
+        const line = diffLines[i];
+        // Skip header lines
+        if (line.startsWith('---') || line.startsWith('+++')) {
+            continue;
+        }
+        // Parse hunk header: @@ -start,count +start,count @@
+        const hunkMatch = line.match(/^@@\s+-(\d+)(?:,(\d+))?\s+\+(\d+)(?:,(\d+))?\s+@@/);
+        if (hunkMatch) {
+            // Finish previous hunk
+            if (inHunk) {
+                // Make sure we've processed all old lines from previous hunk
+                while (hunkOldLinesProcessed < hunkOldLineCount && originalIndex < originalLines.length) {
+                    originalIndex++;
+                    hunkOldLinesProcessed++;
+                }
+            }
+            // Start new hunk
+            inHunk = true;
+            hunkStartLine = parseInt(hunkMatch[1], 10); // 1-based line number
+            hunkOldLineCount = parseInt(hunkMatch[2] || '0', 10);
+            hunkOldLinesProcessed = 0;
+            // Copy all lines from original up to (but not including) the hunk start
+            // hunkStartLine is 1-based, originalIndex is 0-based
+            while (originalIndex < hunkStartLine - 1 && originalIndex < originalLines.length) {
+                result.push(originalLines[originalIndex]);
+                originalIndex++;
+            }
+            continue;
+        }
+        if (!inHunk) {
+            continue; // Skip lines outside hunks
+        }
+        // Process hunk content
+        if (line.startsWith('-')) {
+            // Remove line: skip this line from original
+            if (originalIndex < originalLines.length) {
+                originalIndex++;
+                hunkOldLinesProcessed++;
+            }
+        }
+        else if (line.startsWith('+')) {
+            // Add line: add new line to result
+            result.push(line.substring(1));
+            // Don't increment originalIndex or hunkOldLinesProcessed for additions
+        }
+        else if (line.startsWith(' ')) {
+            // Context line: keep from original
+            if (originalIndex < originalLines.length) {
+                result.push(originalLines[originalIndex]);
+                originalIndex++;
+                hunkOldLinesProcessed++;
+            }
+        }
+        else if (line.trim() === '') {
+            // Empty line - preserve if it's part of the diff structure
+            // But don't add it if we're in the middle of processing
+            if (hunkOldLinesProcessed < hunkOldLineCount) {
+                // This might be a continuation, skip it
+                continue;
+            }
+        }
+        // Check if hunk is complete
+        if (hunkOldLinesProcessed >= hunkOldLineCount) {
+            inHunk = false;
+        }
+    }
+    // Copy all remaining lines from original
+    while (originalIndex < originalLines.length) {
+        result.push(originalLines[originalIndex]);
+        originalIndex++;
+    }
+    return result.join('\n');
+}
+/**
+ * Fallback: Try multiple strategies to apply the edit
+ * Now optimized for complete file content (preferred) or unified diff
+ */
+export function applyEditFallback(originalContent, diff) {
+    if (!diff || !diff.trim()) {
+        return originalContent;
+    }
+    // Clean the diff
+    let cleanDiff = diff.trim();
+    // Strategy 1: Extract from markdown code blocks (handle multiple blocks, take the largest)
+    const codeBlockMatches = cleanDiff.matchAll(/```(?:\w+)?\n([\s\S]*?)\n```/g);
+    let largestBlock = '';
+    for (const match of codeBlockMatches) {
+        const blockContent = match[1].trim();
+        if (blockContent.length > largestBlock.length) {
+            largestBlock = blockContent;
+        }
+    }
+    if (largestBlock) {
+        console.log('[DiffParser] Strategy 1: Extracted from code block, length:', largestBlock.length);
+        cleanDiff = largestBlock;
+    }
+    // Strategy 2: Check if it's a complete file (no diff markers)
+    const hasDiffMarkers = cleanDiff.includes('---') || cleanDiff.includes('+++') || cleanDiff.includes('@@');
+    // If no diff markers and substantial content, treat as complete file
+    if (!hasDiffMarkers) {
+        // More lenient check: if content is different from original and substantial, use it
+        // This handles simple files that don't have function/class keywords
+        // For very small original files (< 20 chars), accept any substantial diff (> 10 chars)
+        const originalIsSmall = originalContent.trim().length < 20;
+        const isSubstantial = cleanDiff.length > 10 || (originalIsSmall && cleanDiff.length > originalContent.trim().length);
+        const isDifferent = cleanDiff.trim() !== originalContent.trim();
+        // Additional check: if it looks like code (has common patterns) OR is different from original
+        // Use case-insensitive matching and check for patterns with word boundaries
+        const looksLikeCode = /\bfunction\b/i.test(cleanDiff) ||
+            /\bclass\b/i.test(cleanDiff) ||
+            /\bimport\b/i.test(cleanDiff) ||
+            /\bexport\b/i.test(cleanDiff) ||
+            /\bconst\b/i.test(cleanDiff) ||
+            /\basync\b/i.test(cleanDiff) ||
+            /\bconsole\b/i.test(cleanDiff) ||
+            /\breturn\b/i.test(cleanDiff) ||
+            /\bif\s+/i.test(cleanDiff) ||
+            /\btry\s*{/i.test(cleanDiff) ||
+            /\bcatch\s*\(/i.test(cleanDiff) ||
+            cleanDiff.includes('{') && cleanDiff.includes('}'); // Has code blocks
+        if (isSubstantial && (looksLikeCode || isDifferent)) {
+            // Likely complete file content
+            console.log('[DiffParser] Strategy 2 matched: complete file content detected');
+            return cleanDiff;
+        }
+        else {
+            console.log('[DiffParser] Strategy 2 failed:', { isSubstantial, looksLikeCode, isDifferent, cleanDiffLength: cleanDiff.length, originalLength: originalContent.length });
+        }
+    }
+    // Strategy 3: Try unified diff parsing if it has diff markers
+    if (hasDiffMarkers) {
+        try {
+            const result = applyUnifiedDiff(originalContent, cleanDiff);
+            // Basic sanity check
+            if (result && result.length > 0 && result !== originalContent) {
+                // Verify it's not just the diff itself
+                if (!result.startsWith('---') && !result.startsWith('+++')) {
+                    return result;
+                }
+            }
+        }
+        catch (error) {
+            console.warn('[DiffParser] Unified diff parsing failed:', error);
+        }
+    }
+    // Strategy 4: Last resort - if it's substantial content and different from original, use it
+    if (cleanDiff.length > 10 &&
+        cleanDiff !== originalContent.trim() &&
+        !cleanDiff.startsWith('---') &&
+        !cleanDiff.startsWith('+++') &&
+        !cleanDiff.toLowerCase().includes('here is') &&
+        !cleanDiff.toLowerCase().includes('here\'s') &&
+        !cleanDiff.toLowerCase().startsWith('the modified')) {
+        return cleanDiff;
+    }
+    // Strategy 5: If all else fails, return original (safer than broken code)
+    console.warn('[DiffParser] Could not parse diff, returning original content');
+    console.warn('[DiffParser] Diff preview (first 200 chars):', cleanDiff.substring(0, 200));
+    return originalContent;
+}
+//# sourceMappingURL=diff-parser.js.map

package/dist/utils/diff-parser.js.map

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

package/dist/utils/provider-check.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Utility: Provider Check
+ * Validates that a valid AI provider configuration exists
+ * Supports: Fake AI, Cohere, OpenAI, OpenRouter, Local (Ollama)
+ */
+export interface ProviderCheckResult {
+    hasValidProvider: boolean;
+    provider: string;
+    message: string;
+    setupInstructions?: string[];
+}
+/**
+ * Check if any valid AI provider is configured
+ * Returns true if FAKE_AI mode, Cohere, OpenAI, OpenRouter, or Local is configured
+ */
+export declare function checkProviderConfiguration(): ProviderCheckResult;
+/**
+ * Display provider error with setup instructions
+ */
+export declare function displayProviderError(result: ProviderCheckResult): void;
+//# sourceMappingURL=provider-check.d.ts.map

package/dist/utils/provider-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-check.d.ts","sourceRoot":"","sources":["../../src/utils/provider-check.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,mBAAmB,CA0GhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAUtE"}

package/dist/utils/provider-check.js

@@ -0,0 +1,124 @@
+/**
+ * Utility: Provider Check
+ * Validates that a valid AI provider configuration exists
+ * Supports: Fake AI, Cohere, OpenAI, OpenRouter, Local (Ollama)
+ */
+/**
+ * Check if any valid AI provider is configured
+ * Returns true if FAKE_AI mode, Cohere, OpenAI, OpenRouter, or Local is configured
+ */
+export function checkProviderConfiguration() {
+    // 1. FAKE_AI mode - always valid (for testing/demos)
+    if (process.env.CODEHERE_FAKE_AI === '1') {
+        return {
+            hasValidProvider: true,
+            provider: 'fake',
+            message: 'Using FAKE_AI mode (deterministic responses for testing)',
+        };
+    }
+    // 2. Check explicit provider selection
+    const selectedProvider = process.env.CODEHERE_AI_PROVIDER?.toLowerCase();
+    // 3. Local provider (Ollama) - no API key needed
+    if (selectedProvider === 'local') {
+        const baseUrl = process.env.CODEHERE_LOCAL_BASE_URL || 'http://localhost:11434';
+        return {
+            hasValidProvider: true,
+            provider: 'local',
+            message: `Using local LLM at ${baseUrl}`,
+        };
+    }
+    // 4. OpenAI provider
+    if (selectedProvider === 'openai') {
+        if (process.env.CODEHERE_OPENAI_API_KEY || process.env.OPENAI_API_KEY) {
+            return {
+                hasValidProvider: true,
+                provider: 'openai',
+                message: 'Using OpenAI provider',
+            };
+        }
+        return {
+            hasValidProvider: false,
+            provider: 'openai',
+            message: 'OpenAI provider selected but no API key found',
+            setupInstructions: [
+                'Set CODEHERE_OPENAI_API_KEY in your environment:',
+                '  export CODEHERE_OPENAI_API_KEY=sk-...',
+                'Or add to .env file:',
+                '  CODEHERE_AI_PROVIDER=openai',
+                '  CODEHERE_OPENAI_API_KEY=sk-...',
+            ],
+        };
+    }
+    // 5. OpenRouter provider
+    if (selectedProvider === 'openrouter') {
+        if (process.env.OPENROUTER_API_KEY) {
+            return {
+                hasValidProvider: true,
+                provider: 'openrouter',
+                message: 'Using OpenRouter provider (400+ models)',
+            };
+        }
+        return {
+            hasValidProvider: false,
+            provider: 'openrouter',
+            message: 'OpenRouter provider selected but no API key found',
+            setupInstructions: [
+                'Set OPENROUTER_API_KEY in your environment:',
+                '  export OPENROUTER_API_KEY=sk-or-v1-...',
+                'Or add to .env file:',
+                '  CODEHERE_AI_PROVIDER=openrouter',
+                '  OPENROUTER_API_KEY=sk-or-v1-...',
+            ],
+        };
+    }
+    // 6. Default: Cohere provider (or explicit cohere selection)
+    if (process.env.COHERE_API_KEY) {
+        return {
+            hasValidProvider: true,
+            provider: 'cohere',
+            message: 'Using Cohere provider',
+        };
+    }
+    // No valid provider found - show helpful message
+    return {
+        hasValidProvider: false,
+        provider: 'none',
+        message: 'No AI provider configured',
+        setupInstructions: [
+            'Choose one of the following options:',
+            '',
+            '1. Cohere (default):',
+            '   export COHERE_API_KEY=your_key',
+            '   Get key: https://dashboard.cohere.com/api-keys',
+            '',
+            '2. OpenAI:',
+            '   export CODEHERE_AI_PROVIDER=openai',
+            '   export CODEHERE_OPENAI_API_KEY=sk-...',
+            '',
+            '3. OpenRouter (400+ models):',
+            '   export CODEHERE_AI_PROVIDER=openrouter',
+            '   export OPENROUTER_API_KEY=sk-or-v1-...',
+            '',
+            '4. Local LLM (Ollama - free, no API key):',
+            '   export CODEHERE_AI_PROVIDER=local',
+            '   (requires Ollama running at localhost:11434)',
+            '',
+            '5. Demo mode (no API needed):',
+            '   export CODEHERE_FAKE_AI=1',
+        ],
+    };
+}
+/**
+ * Display provider error with setup instructions
+ */
+export function displayProviderError(result) {
+    console.error(`\n✗ ${result.message}\n`);
+    if (result.setupInstructions) {
+        console.log('Setup Instructions:');
+        result.setupInstructions.forEach(line => {
+            console.log(`  ${line}`);
+        });
+        console.log('');
+    }
+}
+//# sourceMappingURL=provider-check.js.map

package/dist/utils/provider-check.js.map

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

package/dist/utils/version.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Centralized Version Utility
+ * Single source of truth for version information
+ * Reads from package.json to ensure consistency
+ *
+ * Clean Architecture: Infrastructure/Utils Layer
+ */
+/**
+ * Get the current version from package.json
+ * Caches the result for performance
+ */
+export declare function getVersion(): string;
+/**
+ * Get version with 'v' prefix (e.g., "v0.2.0")
+ */
+export declare function getVersionWithPrefix(): string;
+/**
+ * Reset version cache (useful for testing)
+ */
+export declare function resetVersionCache(): void;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAyBnC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/utils/version.js

@@ -0,0 +1,52 @@
+/**
+ * Centralized Version Utility
+ * Single source of truth for version information
+ * Reads from package.json to ensure consistency
+ *
+ * Clean Architecture: Infrastructure/Utils Layer
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+let cachedVersion = null;
+/**
+ * Get the current version from package.json
+ * Caches the result for performance
+ */
+export function getVersion() {
+    if (cachedVersion) {
+        return cachedVersion;
+    }
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const agentDir = join(__dirname, '../..');
+        const packageJsonPath = join(agentDir, 'package.json');
+        if (existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            const version = packageJson.version || '0.3.0';
+            cachedVersion = version;
+            return version;
+        }
+    }
+    catch (error) {
+        // Fallback if can't read package.json
+        console.warn('Warning: Could not read version from package.json, using fallback');
+    }
+    // Fallback version (should match package.json)
+    cachedVersion = '0.3.0';
+    return cachedVersion;
+}
+/**
+ * Get version with 'v' prefix (e.g., "v0.2.0")
+ */
+export function getVersionWithPrefix() {
+    return `v${getVersion()}`;
+}
+/**
+ * Reset version cache (useful for testing)
+ */
+export function resetVersionCache() {
+    cachedVersion = null;
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAEvD,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;YAC/C,aAAa,GAAG,OAAO,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IACpF,CAAC;IAED,+CAA+C;IAC/C,aAAa,GAAG,OAAO,CAAC;IACxB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,UAAU,EAAE,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/verification/backup.d.ts

@@ -0,0 +1,30 @@
+/**
+ * File Backup and Rollback Module
+ * Creates backups before edits and enables rollback on verification failure
+ */
+export interface BackupInfo {
+    backupPath: string;
+    originalPath: string;
+    timestamp: Date;
+}
+/**
+ * Create backup of file before editing
+ */
+export declare function backupFile(filepath: string): Promise<string>;
+/**
+ * Restore file from backup
+ */
+export declare function rollbackFile(filepath: string, backupPath?: string): Promise<void>;
+/**
+ * Find latest backup for a file
+ */
+export declare function findLatestBackup(filepath: string): Promise<string | null>;
+/**
+ * List all backups for a file
+ */
+export declare function listBackups(filepath: string): Promise<BackupInfo[]>;
+/**
+ * Delete all backups for a file
+ */
+export declare function deleteAllBackups(filepath: string): Promise<void>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/verification/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/verification/backup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDlE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8B/E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0DzE;AAqCD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAetE"}