erosolar-cli 1.7.439 → 1.7.440

package/dist/core/toolValidation.js

@@ -0,0 +1,282 @@
+/**
+ * Comprehensive Tool Validation System
+ *
+ * Provides proactive validation for AI tool usage with:
+ * - Pre-flight validation before tool execution
+ * - Real-time AI flow guidance
+ * - Pattern-based anti-pattern detection
+ * - Recovery suggestions for common failures
+ */
+import { analyzeBashFlow } from './bashCommandGuidance.js';
+/**
+ * Comprehensive tool validator
+ */
+export class ToolValidator {
+    patterns = [
+        {
+            pattern: 'edit_without_read',
+            description: 'Attempting Edit tool without first reading the file',
+            guidance: 'ALWAYS use Read tool before Edit tool to get exact text including whitespace and indentation',
+            examples: [
+                'Edit tool called without preceding Read tool',
+                'old_string contains guessed content instead of exact file content'
+            ]
+        },
+        {
+            pattern: 'broad_search_pattern',
+            description: 'Using overly broad search patterns that may cause context overflow',
+            guidance: 'Use specific search patterns like "**/*.ts" or "src/**/*.js" instead of "*" or "."',
+            examples: [
+                'Glob(".") or Glob("*") without head_limit',
+                'Search patterns that could return thousands of files'
+            ]
+        },
+        {
+            pattern: 'redundant_git_operations',
+            description: 'Running multiple git status calls or inefficient git command chains',
+            guidance: 'Use single combined commands: "git add -A && git commit -m msg && git push"',
+            examples: [
+                'git status → git add → git status → git commit → git push',
+                'Multiple git status calls in sequence'
+            ]
+        },
+        {
+            pattern: 'incomplete_npm_publish',
+            description: 'npm publish detected without confirming release prerequisites',
+            guidance: 'Ensure auth, version bump, build/tests, publish, and git push follow the project release process; automation (npm_publish) is preferred but not required',
+            examples: [
+                'Running npm publish before bumping version',
+                'Publishing without build/test steps required by the project'
+            ]
+        },
+        {
+            pattern: 'sequential_file_reads',
+            description: 'Reading files sequentially when parallel execution is possible',
+            guidance: 'Use parallel tool calls for independent file reads to improve performance',
+            examples: [
+                'Multiple Read calls in separate tool calls',
+                'Sequential file operations that could be parallelized'
+            ]
+        },
+        {
+            pattern: 'validation_after_each_edit',
+            description: 'Running validation after each individual edit',
+            guidance: 'Complete ALL edits first, run ONE validation at the end only if needed',
+            examples: [
+                'Running type-check after each file edit',
+                'Running build/test after every small change'
+            ]
+        }
+    ];
+    /**
+     * Validate tool usage before execution
+     */
+    validateToolUsage(tool, context) {
+        const warnings = [];
+        const suggestions = [];
+        const criticalErrors = [];
+        // Tool-specific validation
+        this.validateToolSpecific(tool, context, warnings, suggestions, criticalErrors);
+        // AI flow pattern validation
+        this.validateAIFlowPatterns(tool, context, warnings, suggestions);
+        // Performance optimization validation
+        this.validatePerformance(tool, context, warnings, suggestions);
+        return {
+            valid: criticalErrors.length === 0,
+            warnings,
+            suggestions,
+            criticalErrors
+        };
+    }
+    /**
+     * Validate tool-specific patterns
+     */
+    validateToolSpecific(tool, context, warnings, suggestions, criticalErrors) {
+        switch (tool.name) {
+            case 'Edit':
+                this.validateEditTool(tool, context, warnings, criticalErrors);
+                break;
+            case 'Glob':
+            case 'Grep':
+                this.validateSearchTools(tool, context, warnings, suggestions);
+                break;
+            case 'execute_bash':
+                this.validateBashCommands(tool, context, warnings, suggestions);
+                break;
+        }
+    }
+    /**
+     * Validate Edit tool usage
+     */
+    validateEditTool(tool, context, warnings, criticalErrors) {
+        const params = tool.parameters;
+        // Check for placeholder patterns in old_string
+        if (params.old_string && this.containsPlaceholderPattern(params.old_string)) {
+            warnings.push({
+                code: 'EDIT_PLACEHOLDER_DETECTED',
+                message: 'Edit tool old_string contains placeholder patterns',
+                severity: 'high',
+                suggestion: 'Use Read tool first to get exact file content instead of guessing'
+            });
+        }
+        // Check for long single lines (likely guessed content)
+        if (params.old_string && this.isLongSingleLine(params.old_string)) {
+            warnings.push({
+                code: 'EDIT_LONG_SINGLE_LINE',
+                message: 'Edit tool old_string is a long single line (likely guessed content)',
+                severity: 'medium',
+                suggestion: 'Read the file first to get exact multi-line content'
+            });
+        }
+        // Check for indentation mismatches
+        if (params.old_string && params.new_string && this.hasIndentationMismatch(params.old_string, params.new_string)) {
+            warnings.push({
+                code: 'EDIT_INDENTATION_MISMATCH',
+                message: 'Edit tool old_string and new_string have indentation mismatches',
+                severity: 'high',
+                suggestion: 'Ensure exact whitespace matching between old and new strings'
+            });
+        }
+    }
+    /**
+     * Validate search tools (Glob, Grep)
+     */
+    validateSearchTools(tool, context, warnings, suggestions) {
+        const params = tool.parameters;
+        // Check for overly broad patterns
+        if (params.pattern && this.isOverlyBroadPattern(params.pattern)) {
+            warnings.push({
+                code: 'SEARCH_OVERLY_BROAD',
+                message: `Search pattern "${params.pattern}" is overly broad`,
+                severity: 'medium',
+                suggestion: 'Use specific patterns like "**/*.ts" or add head_limit parameter'
+            });
+        }
+        // Suggest head_limit for broad patterns
+        if (params.pattern && this.isBroadPattern(params.pattern) && !params.head_limit) {
+            suggestions.push({
+                code: 'SEARCH_SUGGEST_HEAD_LIMIT',
+                message: 'Broad search pattern detected without head_limit',
+                action: 'Add head_limit parameter to prevent context overflow'
+            });
+        }
+    }
+    /**
+     * Validate bash commands
+     */
+    validateBashCommands(tool, context, warnings, suggestions) {
+        const params = tool.parameters;
+        if (!params.command)
+            return;
+        const flowWarnings = analyzeBashFlow(params.command);
+        for (const flow of flowWarnings) {
+            warnings.push({
+                code: flow.code,
+                message: flow.message,
+                severity: this.mapFlowSeverity(flow.severity),
+                suggestion: flow.suggestion,
+            });
+            if (flow.suggestion) {
+                suggestions.push({
+                    code: flow.code,
+                    message: flow.message,
+                    action: flow.suggestion,
+                });
+            }
+        }
+    }
+    /**
+     * Validate AI flow patterns
+     */
+    validateAIFlowPatterns(tool, context, warnings, suggestions) {
+        // Check for sequential file reads
+        if (tool.name === 'read_file' && context.workspaceContext?.recentOperations) {
+            const recentReads = context.workspaceContext.recentOperations
+                .filter(op => op === 'read_file')
+                .length;
+            if (recentReads > 2) {
+                suggestions.push({
+                    code: 'PARALLEL_READ_SUGGESTION',
+                    message: 'Multiple sequential file reads detected',
+                    action: 'Use parallel tool calls (e.g., read_files) for independent file reads to improve performance'
+                });
+            }
+        }
+    }
+    /**
+     * Validate performance optimizations
+     */
+    validatePerformance(tool, context, warnings, suggestions) {
+        // Add performance optimization suggestions
+        if (tool.name === 'execute_bash' && context.workspaceContext?.recentOperations) {
+            const recentValidations = context.workspaceContext.recentOperations
+                .filter(op => op.includes('validate') || op.includes('test') || op.includes('build'))
+                .length;
+            if (recentValidations > 1) {
+                warnings.push({
+                    code: 'EXCESSIVE_VALIDATION',
+                    message: 'Multiple validation operations detected',
+                    severity: 'low',
+                    suggestion: 'Complete ALL edits first, run ONE validation at the end only if needed'
+                });
+            }
+        }
+    }
+    // Helper methods
+    containsPlaceholderPattern(text) {
+        const patterns = [
+            /\.\.\./,
+            /\[.*\]/,
+            /\/\/.*\.\.\./,
+            /TODO/,
+            /FIXME/
+        ];
+        return patterns.some(pattern => pattern.test(text));
+    }
+    isLongSingleLine(text) {
+        const lines = text.split('\n');
+        return lines.length === 1 && text.length > 100;
+    }
+    hasIndentationMismatch(oldString, newString) {
+        const oldIndent = this.detectIndentation(oldString);
+        const newIndent = this.detectIndentation(newString);
+        return oldIndent !== newIndent;
+    }
+    detectIndentation(text) {
+        const firstLine = text.split('\n')[0] || '';
+        const match = firstLine.match(/^(\s+)/);
+        return match?.[1] ?? '';
+    }
+    isOverlyBroadPattern(pattern) {
+        const broadPatterns = ['.', '*', '**'];
+        return broadPatterns.includes(pattern);
+    }
+    isBroadPattern(pattern) {
+        return pattern.includes('*') && !pattern.includes('.');
+    }
+    mapFlowSeverity(severity) {
+        switch (severity) {
+            case 'critical':
+                return 'high';
+            case 'info':
+                return 'low';
+            default:
+                return 'medium';
+        }
+    }
+    /**
+     * Get AI flow guidance for a specific pattern
+     */
+    getAIFlowGuidance(patternId) {
+        return this.patterns.find(p => p.pattern === patternId);
+    }
+    /**
+     * Get all AI flow patterns
+     */
+    getAllAIFlowPatterns() {
+        return [...this.patterns];
+    }
+}
+// Global tool validator instance
+export const globalToolValidator = new ToolValidator();
+//# sourceMappingURL=toolValidation.js.map

package/dist/core/toolValidation.js.map

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

package/dist/core/types/utilityTypes.d.ts

@@ -0,0 +1,192 @@
+/**
+ * TypeScript Utility Types and Helper Functions
+ *
+ * Provides comprehensive TypeScript utilities for:
+ * - Advanced type manipulation
+ * - Functional programming patterns
+ * - Immutable data structures
+ * - Runtime type checking
+ */
+/**
+ * Deep Readonly type for complete immutability
+ */
+export type DeepReadonly<T> = {
+    readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];
+};
+/**
+ * Make specific properties optional
+ */
+export type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Make specific properties required
+ */
+export type RequiredBy<T, K extends keyof T> = T & Required<Pick<T, K>>;
+/**
+ * Extract only function properties from type
+ */
+export type FunctionProperties<T> = {
+    [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? T[K] : never;
+};
+/**
+ * Extract only data properties from type
+ */
+export type DataProperties<T> = {
+    [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? never : T[K];
+};
+/**
+ * Branded type for nominal typing
+ */
+export type Brand<T, B> = T & {
+    readonly __brand: B;
+};
+/**
+ * Union to intersection type
+ */
+export type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+/**
+ * Async function return type
+ */
+export type AsyncReturnType<T extends (...args: unknown[]) => unknown> = T extends (...args: unknown[]) => Promise<infer R> ? R : never;
+/**
+ * Constructor type
+ */
+export type Constructor<T = unknown> = new (...args: unknown[]) => T;
+/**
+ * Instance type from constructor
+ */
+export type InstanceType<T extends Constructor> = T extends Constructor<infer R> ? R : never;
+/**
+ * Runtime type checking utilities
+ */
+export declare class TypeGuards {
+    /**
+     * Check if value is a string
+     */
+    static isString(value: unknown): value is string;
+    /**
+     * Check if value is a number
+     */
+    static isNumber(value: unknown): value is number;
+    /**
+     * Check if value is a boolean
+     */
+    static isBoolean(value: unknown): value is boolean;
+    /**
+     * Check if value is an object (not null, not array)
+     */
+    static isObject(value: unknown): value is Record<string, unknown>;
+    /**
+     * Check if value is an array
+     */
+    static isArray(value: unknown): value is unknown[];
+    /**
+     * Check if value is a function
+     */
+    static isFunction(value: unknown): value is (...args: unknown[]) => unknown;
+    /**
+     * Check if value is null or undefined
+     */
+    static isNil(value: unknown): value is null | undefined;
+    /**
+     * Check if value has a specific property
+     */
+    static hasProperty<T extends string>(value: unknown, property: T): value is {
+        [K in T]: unknown;
+    };
+}
+/**
+ * Functional programming utilities
+ */
+export declare class Functional {
+    /**
+     * Compose multiple functions
+     */
+    static compose<T>(...fns: Array<(x: T) => T>): (x: T) => T;
+    /**
+     * Pipe value through multiple functions
+     */
+    static pipe<T>(value: T, ...fns: Array<(x: T) => T>): T;
+    /**
+     * Memoize function with cache
+     */
+    static memoize<T extends (...args: unknown[]) => unknown>(fn: T, cacheKey?: (...args: Parameters<T>) => string): T;
+    /**
+     * Debounce function execution
+     */
+    static debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (...args: Parameters<T>) => void;
+    /**
+     * Throttle function execution
+     */
+    static throttle<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (...args: Parameters<T>) => void;
+}
+/**
+ * Immutable data utilities
+ */
+export declare class Immutable {
+    /**
+     * Deep freeze object
+     */
+    static deepFreeze<T>(obj: T): DeepReadonly<T>;
+    /**
+     * Create immutable copy with updates
+     */
+    static update<T extends Record<string, unknown>>(obj: T, updates: Partial<T>): T;
+    /**
+     * Create immutable copy with nested updates
+     */
+    static updateIn<T extends Record<string, unknown>>(obj: T, path: string[], value: unknown): T;
+}
+/**
+ * Type-safe event emitter
+ */
+export declare class TypedEventEmitter<T extends Record<string, unknown[]>> {
+    private listeners;
+    /**
+     * Add event listener
+     */
+    on<K extends keyof T>(event: K, listener: (...args: T[K]) => void): void;
+    /**
+     * Remove event listener
+     */
+    off<K extends keyof T>(event: K, listener: (...args: T[K]) => void): void;
+    /**
+     * Emit event
+     */
+    emit<K extends keyof T>(event: K, ...args: T[K]): void;
+    /**
+     * Remove all listeners
+     */
+    removeAllListeners(): void;
+}
+/**
+ * Utility functions for common TypeScript patterns
+ */
+export declare class TypeScriptUtils {
+    /**
+     * Assert value is not null or undefined
+     */
+    static assertDefined<T>(value: T | null | undefined, message?: string): asserts value is T;
+    /**
+     * Create type-safe enum from array
+     */
+    static createStringEnum<T extends string>(values: readonly T[]): {
+        [K in T]: K;
+    };
+    /**
+     * Create branded type
+     */
+    static createBranded<T, B>(value: T): Brand<T, B>;
+    /**
+     * Extract keys from type that match a condition
+     */
+    static extractKeys<T extends object>(obj: T, predicate: (key: keyof T, value: T[keyof T]) => boolean): Array<keyof T>;
+    /**
+     * Pick properties from object
+     */
+    static pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+    /**
+     * Omit properties from object
+     */
+    static omit<T, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+}
+//# sourceMappingURL=utilityTypes.d.ts.map

package/dist/core/types/utilityTypes.d.ts.map

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