erosolar-cli 1.7.436 → 1.7.439

package/dist/core/toolValidation.js

@@ -1,282 +0,0 @@
-/**
- * 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

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

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

@@ -1,192 +0,0 @@
-/**
- * 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

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