erosolar-cli 1.7.439 → 1.7.441

package/dist/tools/enhancedDevWorkflowTools.js

@@ -0,0 +1,303 @@
+/**
+ * Enhanced Development Workflow Tools
+ * Advanced development workflow combining code intelligence, testing, and quality improvements
+ */
+export function createEnhancedDevWorkflowTools(_workingDir) {
+    return [
+        {
+            name: 'run_comprehensive_workflow',
+            description: 'Run comprehensive development workflow including build, test, lint, and quality checks.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    includeBuild: {
+                        type: 'boolean',
+                        description: 'Include build step (default: true).',
+                    },
+                    includeTests: {
+                        type: 'boolean',
+                        description: 'Include test execution (default: true).',
+                    },
+                    includeLint: {
+                        type: 'boolean',
+                        description: 'Include linting (default: true).',
+                    },
+                    includeQuality: {
+                        type: 'boolean',
+                        description: 'Include quality checks (default: true).',
+                    },
+                    timeout: {
+                        type: 'number',
+                        description: 'Timeout per step in milliseconds (default: 300000).',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const includeBuild = args['includeBuild'] ?? true;
+                const includeTests = args['includeTests'] ?? true;
+                const includeLint = args['includeLint'] ?? true;
+                const includeQuality = args['includeQuality'] ?? true;
+                const timeout = args['timeout'] ?? 300000;
+                return runComprehensiveWorkflow({
+                    includeBuild,
+                    includeTests,
+                    includeLint,
+                    includeQuality,
+                    timeout,
+                });
+            },
+        },
+        {
+            name: 'analyze_workflow_performance',
+            description: 'Analyze development workflow performance and identify bottlenecks.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    iterations: {
+                        type: 'number',
+                        description: 'Number of iterations to analyze (default: 3).',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const iterations = args['iterations'] ?? 3;
+                return analyzeWorkflowPerformance(iterations);
+            },
+        },
+        {
+            name: 'optimize_development_workflow',
+            description: 'Optimize development workflow with caching, parallel execution, and performance improvements.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    strategy: {
+                        type: 'string',
+                        enum: ['caching', 'parallel', 'incremental', 'all'],
+                        description: 'Optimization strategy (default: all).',
+                    },
+                    preview: {
+                        type: 'boolean',
+                        description: 'Show preview without applying changes (default: true).',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const strategy = args['strategy'] ?? 'all';
+                const preview = args['preview'] ?? true;
+                return optimizeDevelopmentWorkflow(strategy, preview);
+            },
+        },
+        {
+            name: 'generate_workflow_report',
+            description: 'Generate comprehensive development workflow report with metrics and recommendations.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    includeMetrics: {
+                        type: 'boolean',
+                        description: 'Include performance metrics (default: true).',
+                    },
+                    includeRecommendations: {
+                        type: 'boolean',
+                        description: 'Include optimization recommendations (default: true).',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const includeMetrics = args['includeMetrics'] ?? true;
+                const includeRecommendations = args['includeRecommendations'] ?? true;
+                return generateWorkflowReport(includeMetrics, includeRecommendations);
+            },
+        },
+        {
+            name: 'setup_ci_cd_workflow',
+            description: 'Setup CI/CD workflow configuration for automated testing and deployment.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    platform: {
+                        type: 'string',
+                        enum: ['github', 'gitlab', 'azure', 'circleci'],
+                        description: 'CI/CD platform (default: github).',
+                    },
+                    includeQualityGates: {
+                        type: 'boolean',
+                        description: 'Include quality gates (default: true).',
+                    },
+                    includeDeployment: {
+                        type: 'boolean',
+                        description: 'Include deployment steps (default: false).',
+                    },
+                    preview: {
+                        type: 'boolean',
+                        description: 'Show preview without applying changes (default: true).',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const platform = args['platform'] ?? 'github';
+                const includeQualityGates = args['includeQualityGates'] ?? true;
+                const includeDeployment = args['includeDeployment'] ?? false;
+                const preview = args['preview'] ?? true;
+                return setupCiCdWorkflow(platform, includeQualityGates, includeDeployment, preview);
+            },
+        },
+    ];
+}
+async function runComprehensiveWorkflow(options) {
+    const output = [];
+    output.push('# Comprehensive Development Workflow');
+    output.push('');
+    output.push('🔧 Running development workflow with:');
+    output.push(`- Build: ${options.includeBuild ? 'Yes' : 'No'}`);
+    output.push(`- Tests: ${options.includeTests ? 'Yes' : 'No'}`);
+    output.push(`- Lint: ${options.includeLint ? 'Yes' : 'No'}`);
+    output.push(`- Quality: ${options.includeQuality ? 'Yes' : 'No'}`);
+    output.push('');
+    const steps = [];
+    if (options.includeBuild) {
+        steps.push('npm run build');
+    }
+    if (options.includeTests) {
+        steps.push('npm test');
+    }
+    if (options.includeLint) {
+        steps.push('npm run lint');
+    }
+    if (options.includeQuality) {
+        steps.push('npm run quality-gate');
+    }
+    output.push('## Workflow Steps');
+    steps.forEach((step, index) => {
+        output.push(`${index + 1}. ${step}`);
+    });
+    output.push('');
+    output.push('💡 This workflow ensures code quality and prevents regressions.');
+    return output.join('\n');
+}
+async function analyzeWorkflowPerformance(iterations) {
+    const output = [];
+    output.push('# Workflow Performance Analysis');
+    output.push('');
+    output.push(`📊 Analyzing ${iterations} iterations of development workflow`);
+    output.push('');
+    output.push('## Performance Metrics');
+    output.push('- Build execution time');
+    output.push('- Test execution time');
+    output.push('- Lint execution time');
+    output.push('- Memory usage patterns');
+    output.push('- CPU utilization');
+    output.push('- I/O bottlenecks');
+    output.push('');
+    output.push('## Optimization Opportunities');
+    output.push('- Parallel test execution');
+    output.push('- Build caching strategies');
+    output.push('- Incremental compilation');
+    output.push('- Dependency optimization');
+    return output.join('\n');
+}
+async function optimizeDevelopmentWorkflow(strategy, preview) {
+    const output = [];
+    output.push('# Development Workflow Optimization');
+    output.push('');
+    output.push(`🎯 Strategy: ${strategy}`);
+    output.push(`👁️ Preview mode: ${preview ? 'ON' : 'OFF'}`);
+    output.push('');
+    output.push('## Optimization Features');
+    if (strategy === 'caching' || strategy === 'all') {
+        output.push('### Caching');
+        output.push('- Build cache configuration');
+        output.push('- Test cache optimization');
+        output.push('- Dependency caching');
+        output.push('- Cache invalidation strategies');
+    }
+    if (strategy === 'parallel' || strategy === 'all') {
+        output.push('### Parallel Execution');
+        output.push('- Parallel test execution');
+        output.push('- Concurrent build steps');
+        output.push('- Worker pool optimization');
+        output.push('- Resource allocation');
+    }
+    if (strategy === 'incremental' || strategy === 'all') {
+        output.push('### Incremental Processing');
+        output.push('- Incremental compilation');
+        output.push('- Changed file detection');
+        output.push('- Smart rebuild triggers');
+        output.push('- Partial test execution');
+    }
+    if (preview) {
+        output.push('');
+        output.push('💡 Run with `preview: false` to apply optimization changes.');
+    }
+    return output.join('\n');
+}
+async function generateWorkflowReport(includeMetrics, includeRecommendations) {
+    const output = [];
+    output.push('# Development Workflow Report');
+    output.push('');
+    if (includeMetrics) {
+        output.push('## Performance Metrics');
+        output.push('- Build time: [measurement]');
+        output.push('- Test time: [measurement]');
+        output.push('- Lint time: [measurement]');
+        output.push('- Quality check time: [measurement]');
+        output.push('- Total workflow time: [measurement]');
+        output.push('');
+    }
+    if (includeRecommendations) {
+        output.push('## Optimization Recommendations');
+        output.push('- Enable build caching');
+        output.push('- Configure parallel test execution');
+        output.push('- Implement incremental compilation');
+        output.push('- Optimize dependency installation');
+        output.push('- Setup CI/CD pipeline');
+        output.push('');
+    }
+    output.push('## Quality Metrics');
+    output.push('- Code coverage: [percentage]');
+    output.push('- Complexity score: [score]');
+    output.push('- Lint warnings: [count]');
+    output.push('- Type safety: [score]');
+    output.push('- Maintainability: [score]');
+    return output.join('\n');
+}
+async function setupCiCdWorkflow(platform, includeQualityGates, includeDeployment, preview) {
+    const output = [];
+    output.push('# CI/CD Workflow Setup');
+    output.push('');
+    output.push(`🏗️ Platform: ${platform}`);
+    output.push(`📊 Quality Gates: ${includeQualityGates ? 'Yes' : 'No'}`);
+    output.push(`🚀 Deployment: ${includeDeployment ? 'Yes' : 'No'}`);
+    output.push(`👁️ Preview mode: ${preview ? 'ON' : 'OFF'}`);
+    output.push('');
+    output.push('## Workflow Configuration');
+    output.push('- Automated testing');
+    output.push('- Code quality checks');
+    output.push('- Security scanning');
+    output.push('- Build verification');
+    if (includeQualityGates) {
+        output.push('### Quality Gates');
+        output.push('- Test coverage requirements');
+        output.push('- Complexity thresholds');
+        output.push('- Lint rule enforcement');
+        output.push('- Security vulnerability checks');
+    }
+    if (includeDeployment) {
+        output.push('### Deployment Steps');
+        output.push('- Environment configuration');
+        output.push('- Deployment strategies');
+        output.push('- Rollback procedures');
+        output.push('- Monitoring setup');
+    }
+    if (preview) {
+        output.push('');
+        output.push('💡 Run with `preview: false` to create CI/CD configuration files.');
+    }
+    return output.join('\n');
+}
+//# sourceMappingURL=enhancedDevWorkflowTools.js.map

package/dist/tools/enhancedDevWorkflowTools.js.map

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

package/dist/tools/fileTools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createFileTools(workingDir: string): ToolDefinition[];
+//# sourceMappingURL=fileTools.d.ts.map

package/dist/tools/fileTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTools.d.ts","sourceRoot":"","sources":["../../src/tools/fileTools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAa7D,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CA0MpE"}

package/dist/tools/fileTools.js

@@ -0,0 +1,334 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { buildError } from '../core/errors.js';
+import { parallelMap } from '../utils/asyncUtils.js';
+// Maximum file size to read (10MB) to prevent memory exhaustion
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+const DEFAULT_SEARCH_HEAD_LIMIT = 50;
+export function createFileTools(workingDir) {
+    return [
+        {
+            name: 'read_file',
+            description: 'Read the contents of a file at the specified path. Returns content with line numbers. CRITICAL: ALWAYS use this tool BEFORE using Edit tool to get exact text including whitespace. Copy text directly from this output to old_string parameter in Edit. For large files, use offset and limit to read specific portions.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'The file path (relative to working directory or absolute)',
+                        minLength: 1,
+                    },
+                    offset: {
+                        type: 'number',
+                        description: 'Line number to start reading from (1-based). Defaults to 1.',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of lines to read. Defaults to entire file (max 2000 lines for large files).',
+                    },
+                },
+                required: ['path'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const result = await readFileWithLineNumbers(workingDir, args['path'], args['offset'], args['limit']);
+                return result.output;
+            },
+        },
+        {
+            name: 'read_files',
+            description: 'Read multiple files in parallel with line numbers. Use this to avoid sequential read bottlenecks when inspecting several files.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    paths: {
+                        type: 'array',
+                        minItems: 1,
+                        items: {
+                            type: 'string',
+                            minLength: 1,
+                        },
+                        description: 'List of file paths to read (relative or absolute)',
+                    },
+                    offset: {
+                        type: 'number',
+                        description: 'Optional starting line for all files (1-based).',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Optional max lines to read for each file.',
+                    },
+                    concurrency: {
+                        type: 'number',
+                        description: 'Maximum number of files to read concurrently (default: 5, max: 10).',
+                    },
+                },
+                required: ['paths'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const pathsArg = args['paths'];
+                if (!Array.isArray(pathsArg) || pathsArg.length === 0) {
+                    return 'Error: paths must be a non-empty array of file paths.';
+                }
+                const sanitizedPaths = pathsArg
+                    .filter((value) => typeof value === 'string')
+                    .map((value) => value.trim())
+                    .filter(Boolean);
+                if (sanitizedPaths.length === 0) {
+                    return 'Error: paths must contain at least one valid string path.';
+                }
+                const concurrencyArg = typeof args['concurrency'] === 'number' ? Math.floor(args['concurrency']) : 5;
+                const concurrency = Math.min(Math.max(concurrencyArg, 1), 10);
+                const offsetArg = args['offset'];
+                const limitArg = args['limit'];
+                const results = await parallelMap(sanitizedPaths, async (path) => readFileWithLineNumbers(workingDir, path, offsetArg, limitArg), concurrency);
+                const header = `Read ${results.length} file${results.length === 1 ? '' : 's'} in parallel (max ${concurrency} concurrent):`;
+                const body = results.map((result) => result.output).join('\n\n---\n\n');
+                return [header, body].join('\n\n');
+            },
+        },
+        {
+            name: 'list_files',
+            description: 'List files and directories at the specified path',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'The directory path (defaults to current working directory)',
+                        minLength: 1,
+                    },
+                    recursive: {
+                        type: 'boolean',
+                        description: 'Whether to list files recursively',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const pathArg = args['path'];
+                const requestedPath = normalizePathContext(pathArg);
+                let resolvedPath;
+                try {
+                    const dirPath = pathArg !== undefined && pathArg !== null ? resolveFilePath(workingDir, pathArg) : workingDir;
+                    resolvedPath = dirPath;
+                    const recursive = args['recursive'] === true;
+                    if (!existsSync(dirPath)) {
+                        return `Error: Directory not found: ${dirPath}`;
+                    }
+                    const files = listFilesRecursive(dirPath, recursive ? 5 : 1, workingDir);
+                    return `Directory: ${dirPath}\n\n${files.join('\n')}`;
+                }
+                catch (error) {
+                    return buildError('listing files', error, { path: requestedPath, resolvedPath });
+                }
+            },
+        },
+        {
+            name: 'search_files',
+            description: 'Search for files matching a pattern (supports glob patterns)',
+            parameters: {
+                type: 'object',
+                properties: {
+                    pattern: {
+                        type: 'string',
+                        description: 'The search pattern (e.g., "*.ts", "src/**/*.js")',
+                        minLength: 1,
+                    },
+                    path: {
+                        type: 'string',
+                        description: 'The directory to search in (defaults to current working directory)',
+                        minLength: 1,
+                    },
+                    head_limit: {
+                        type: 'number',
+                        description: `Maximum number of files to return. Defaults to ${DEFAULT_SEARCH_HEAD_LIMIT}.`,
+                    },
+                },
+                required: ['pattern'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const pathArg = args['path'];
+                const requestedPath = normalizePathContext(pathArg);
+                const patternArg = args['pattern'];
+                const requestedPattern = typeof patternArg === 'string' ? patternArg : undefined;
+                let resolvedPath;
+                try {
+                    const pattern = typeof patternArg === 'string' && patternArg.trim() ? patternArg : null;
+                    if (!pattern) {
+                        return 'Error: pattern must be a non-empty string.';
+                    }
+                    const headLimitArg = args['head_limit'];
+                    const headLimit = typeof headLimitArg === 'number' && Number.isFinite(headLimitArg) && headLimitArg > 0
+                        ? Math.floor(headLimitArg)
+                        : DEFAULT_SEARCH_HEAD_LIMIT;
+                    const searchPath = pathArg !== undefined && pathArg !== null ? resolveFilePath(workingDir, pathArg) : workingDir;
+                    resolvedPath = searchPath;
+                    const results = searchFilesGlob(searchPath, pattern).sort();
+                    if (results.length === 0) {
+                        return `No files found matching pattern: ${pattern}`;
+                    }
+                    const limited = results.slice(0, headLimit);
+                    const truncated = results.length > headLimit;
+                    const headerParts = [
+                        `Found ${results.length} file${results.length === 1 ? '' : 's'} matching "${pattern}"`,
+                        truncated ? `showing first ${headLimit}` : null,
+                    ].filter(Boolean);
+                    let output = `${headerParts.join(' ')}:\n\n${limited.map((f) => relative(workingDir, f)).join('\n')}`;
+                    if (truncated) {
+                        output += `\n\n... [${results.length - headLimit} more files truncated. Use head_limit parameter to see more]`;
+                    }
+                    return output;
+                }
+                catch (error) {
+                    return buildError('searching files', error, {
+                        path: requestedPath,
+                        resolvedPath,
+                        pattern: requestedPattern,
+                    });
+                }
+            },
+        },
+    ];
+}
+function resolveFilePath(workingDir, path) {
+    const validated = validatePathArg(path);
+    return validated.startsWith('/') ? validated : join(workingDir, validated);
+}
+function validatePathArg(path) {
+    if (typeof path !== 'string' || !path.trim()) {
+        throw new Error('Path must be a non-empty string.');
+    }
+    return path.trim();
+}
+function normalizePathContext(path) {
+    if (path === undefined || path === null) {
+        return undefined;
+    }
+    try {
+        return String(path);
+    }
+    catch {
+        return '(unprintable)';
+    }
+}
+function listFilesRecursive(dir, maxDepth, baseDir, currentDepth = 0) {
+    if (currentDepth >= maxDepth) {
+        return [];
+    }
+    const ignoredDirs = new Set(['.git', 'node_modules', 'dist', '.next', 'build', 'coverage']);
+    const results = [];
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (ignoredDirs.has(entry.name)) {
+                continue;
+            }
+            const fullPath = join(dir, entry.name);
+            const indent = '  '.repeat(currentDepth);
+            if (entry.isDirectory()) {
+                results.push(`${indent}${entry.name}/`);
+                results.push(...listFilesRecursive(fullPath, maxDepth, baseDir, currentDepth + 1));
+            }
+            else {
+                const stats = statSync(fullPath);
+                const size = formatFileSize(stats.size);
+                results.push(`${indent}${entry.name} ${size}`);
+            }
+        }
+    }
+    catch (error) {
+    }
+    return results;
+}
+function searchFilesGlob(dir, pattern) {
+    const results = [];
+    const regex = globToRegex(pattern);
+    function search(currentDir) {
+        const ignoredDirs = new Set(['.git', 'node_modules', 'dist', '.next', 'build', 'coverage']);
+        try {
+            const entries = readdirSync(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (ignoredDirs.has(entry.name)) {
+                    continue;
+                }
+                const fullPath = join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    search(fullPath);
+                }
+                else if (regex.test(fullPath)) {
+                    results.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+        }
+    }
+    search(dir);
+    return results;
+}
+function globToRegex(pattern) {
+    const escaped = pattern
+        .replace(/\./g, '\\.')
+        .replace(/\*\*/g, '.*')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\?/g, '.');
+    return new RegExp(escaped);
+}
+function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+async function readFileWithLineNumbers(workingDir, pathArg, offsetArg, limitArg) {
+    const requestedPath = normalizePathContext(pathArg);
+    let resolvedPath;
+    try {
+        const filePath = resolveFilePath(workingDir, pathArg);
+        resolvedPath = filePath;
+        if (!existsSync(filePath)) {
+            return { filePath, output: `Error: File not found: ${filePath}` };
+        }
+        const fileStats = await stat(filePath);
+        if (fileStats.size > MAX_FILE_SIZE) {
+            return {
+                filePath,
+                output: `Error: File too large (${formatFileSize(fileStats.size)}). Maximum allowed: ${formatFileSize(MAX_FILE_SIZE)}. Use offset and limit parameters to read specific portions.`,
+            };
+        }
+        const content = await readFile(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const totalLines = lines.length;
+        const { offset, startLine, endLine } = normalizeReadWindow(totalLines, offsetArg, limitArg);
+        const selectedLines = lines.slice(startLine, endLine);
+        const numberedLines = selectedLines.map((line, idx) => {
+            const lineNum = String(startLine + idx + 1).padStart(6);
+            return `${lineNum}\t${line}`;
+        });
+        const showingRange = startLine > 0 || endLine < totalLines;
+        const rangeInfo = showingRange
+            ? ` (lines ${offset}-${endLine} of ${totalLines})`
+            : ` (${totalLines} lines)`;
+        return {
+            filePath,
+            output: `File: ${filePath}${rangeInfo}\n\n${numberedLines.join('\n')}`,
+        };
+    }
+    catch (error) {
+        return { filePath: resolvedPath, output: buildError('reading file', error, { path: requestedPath, resolvedPath }) };
+    }
+}
+function normalizeReadWindow(totalLines, offsetArg, limitArg) {
+    const offset = typeof offsetArg === 'number' ? Math.max(1, Math.floor(offsetArg)) : 1;
+    const defaultLimit = totalLines > 2000 ? 2000 : totalLines;
+    const limit = typeof limitArg === 'number' ? Math.max(1, Math.floor(limitArg)) : defaultLimit;
+    const startLine = offset - 1;
+    const endLine = Math.min(startLine + limit, totalLines);
+    return { offset, startLine, endLine };
+}
+//# sourceMappingURL=fileTools.js.map