erosolar-cli 1.7.415 → 1.7.417

package/dist/workspace.validator.js

@@ -0,0 +1,214 @@
+/**
+ * Workspace Context Validator - Enforces strict safety limits
+ *
+ * CRITICAL: Prevents context explosion by validating all workspace context
+ * before it's sent to the LLM. Multiple safety layers ensure we never
+ * exceed token limits.
+ */
+import { ContextOverflowError, ResourceLimitError } from './core/errors/errorTypes.js';
+// ABSOLUTE MAXIMUM LIMITS - Never exceed these under any circumstances
+const ABSOLUTE_MAX_CHARS = 5000; // ~1,250 tokens (4 chars per token)
+const ABSOLUTE_MAX_LINES = 100; // Maximum lines in any context
+const ABSOLUTE_MAX_FILE_ENTRIES = 50; // Maximum files in tree
+const ABSOLUTE_MAX_DOC_CHARS = 300; // Maximum chars per priority doc
+const WARNING_THRESHOLD = 0.7; // Warn at 70% of max
+/**
+ * Estimate token count (rough: 1 token ≈ 4 characters)
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Validate workspace context options BEFORE building context
+ */
+export function validateWorkspaceOptions(options) {
+    const errors = [];
+    const warnings = [];
+    // Validate tree depth
+    if (options.treeDepth !== undefined) {
+        if (options.treeDepth < 0) {
+            errors.push('treeDepth cannot be negative');
+        }
+        if (options.treeDepth > 2) {
+            errors.push(`treeDepth ${options.treeDepth} exceeds maximum of 2`);
+        }
+        if (options.treeDepth > 1) {
+            warnings.push('treeDepth > 1 can significantly increase context size');
+        }
+    }
+    // Validate max entries
+    if (options.maxEntries !== undefined) {
+        if (options.maxEntries < 0) {
+            errors.push('maxEntries cannot be negative');
+        }
+        if (options.maxEntries > ABSOLUTE_MAX_FILE_ENTRIES) {
+            errors.push(`maxEntries ${options.maxEntries} exceeds maximum of ${ABSOLUTE_MAX_FILE_ENTRIES}`);
+        }
+        if (options.maxEntries > 40) {
+            warnings.push('maxEntries > 40 may use significant context');
+        }
+    }
+    // Validate doc excerpt limit
+    if (options.docExcerptLimit !== undefined) {
+        if (options.docExcerptLimit < 0) {
+            errors.push('docExcerptLimit cannot be negative');
+        }
+        if (options.docExcerptLimit > ABSOLUTE_MAX_DOC_CHARS) {
+            errors.push(`docExcerptLimit ${options.docExcerptLimit} exceeds maximum of ${ABSOLUTE_MAX_DOC_CHARS}`);
+        }
+        if (options.docExcerptLimit > 250) {
+            warnings.push('docExcerptLimit > 250 may use significant context');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        stats: {
+            totalChars: 0,
+            totalLines: 0,
+            estimatedTokens: 0,
+            fileEntries: options.maxEntries ?? 0,
+            docChars: options.docExcerptLimit ?? 0,
+        },
+    };
+}
+/**
+ * Validate workspace context AFTER building - CRITICAL SAFETY CHECK
+ * This is the final line of defense against context explosion
+ */
+export function validateWorkspaceContext(content) {
+    const errors = [];
+    const warnings = [];
+    // Count basic metrics
+    const totalChars = content.length;
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+    const estimatedTokens = estimateTokens(content);
+    // Count file entries (lines that look like file paths)
+    const fileEntries = lines.filter(line => line.trim() && !line.startsWith('---') && !line.startsWith('cwd:')).length;
+    // Count chars in priority docs section
+    const docMatch = content.match(/--- .* ---[\s\S]*?(?=\n\n|$)/g);
+    const docChars = docMatch ? docMatch.join('').length : 0;
+    const stats = {
+        totalChars,
+        totalLines,
+        estimatedTokens,
+        fileEntries,
+        docChars,
+    };
+    // CRITICAL: Check absolute maximum character limit
+    if (totalChars > ABSOLUTE_MAX_CHARS) {
+        const error = new ContextOverflowError(totalChars, ABSOLUTE_MAX_CHARS, 'chars', true);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // CRITICAL: Check absolute maximum line limit
+    if (totalLines > ABSOLUTE_MAX_LINES) {
+        const error = new ContextOverflowError(totalLines, ABSOLUTE_MAX_LINES, 'lines', true);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // CRITICAL: Check absolute maximum file entries
+    if (fileEntries > ABSOLUTE_MAX_FILE_ENTRIES) {
+        const error = new ResourceLimitError('file entries', fileEntries, ABSOLUTE_MAX_FILE_ENTRIES, false);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // WARNING: Approaching limits
+    if (totalChars > ABSOLUTE_MAX_CHARS * WARNING_THRESHOLD) {
+        warnings.push(`Context size ${totalChars} chars is ${Math.round(totalChars / ABSOLUTE_MAX_CHARS * 100)}% of maximum. ` +
+            `Consider reducing treeDepth, maxEntries, or docExcerptLimit.`);
+    }
+    if (estimatedTokens > 1000) {
+        warnings.push(`Estimated ${estimatedTokens} tokens in workspace context. This is high and may impact performance.`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        stats,
+    };
+}
+/**
+ * Safe truncation - if content exceeds limits, truncate intelligently
+ */
+export function truncateWorkspaceContext(content) {
+    const validation = validateWorkspaceContext(content);
+    // If valid, return as-is
+    if (validation.valid) {
+        return {
+            content,
+            stats: validation.stats,
+        };
+    }
+    // CRITICAL: Content exceeds limits, must truncate
+    const lines = content.split('\n');
+    const truncatedLines = [];
+    let charCount = 0;
+    // Keep up to absolute maximums
+    for (const line of lines) {
+        if (truncatedLines.length >= ABSOLUTE_MAX_LINES) {
+            break;
+        }
+        if (charCount + line.length > ABSOLUTE_MAX_CHARS) {
+            break;
+        }
+        truncatedLines.push(line);
+        charCount += line.length + 1; // +1 for newline
+    }
+    // Add truncation notice
+    if (truncatedLines.length < lines.length) {
+        truncatedLines.push('');
+        truncatedLines.push('[Workspace context truncated to prevent context overflow]');
+        truncatedLines.push(`[Showing ${truncatedLines.length} of ${lines.length} lines]`);
+    }
+    const truncatedContent = truncatedLines.join('\n');
+    const stats = validateWorkspaceContext(truncatedContent).stats;
+    return {
+        content: truncatedContent,
+        stats,
+    };
+}
+/**
+ * Validate and enforce limits in a single call - RECOMMENDED USAGE
+ */
+export function safeWorkspaceContext(content, options) {
+    const { truncate = true, throwOnError = false } = options ?? {};
+    if (!content) {
+        return {
+            content: '',
+            stats: {
+                totalChars: 0,
+                totalLines: 0,
+                estimatedTokens: 0,
+                fileEntries: 0,
+                docChars: 0,
+            },
+        };
+    }
+    const validation = validateWorkspaceContext(content);
+    // Log warnings to console
+    if (validation.warnings.length > 0) {
+        console.warn('[Workspace Context Validator] Warnings:');
+        for (const warning of validation.warnings) {
+            console.warn(`  - ${warning}`);
+        }
+    }
+    // Handle errors
+    if (!validation.valid) {
+        console.error('[Workspace Context Validator] CRITICAL ERRORS:');
+        for (const error of validation.errors) {
+            console.error(`  - ${error}`);
+        }
+        if (throwOnError) {
+            throw new Error(`Workspace context validation failed:\n${validation.errors.join('\n')}`);
+        }
+        if (truncate) {
+            console.warn('[Workspace Context Validator] Auto-truncating to safe limits...');
+            return truncateWorkspaceContext(content);
+        }
+    }
+    return {
+        content,
+        stats: validation.stats,
+    };
+}
+//# sourceMappingURL=workspace.validator.js.map

package/dist/workspace.validator.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erosolar-cli",
-  "version": "1.7.415",
+  "version": "1.7.417",
   "description": "Unified AI agent framework for the command line - Multi-provider support with schema-driven tools, code intelligence, and transparent reasoning",
   "main": "dist/bin/erosolar.js",
   "type": "module",