atlas-pipeline-mcp 1.0.20 → 1.0.22

package/dist/tools/code-migration.js

@@ -0,0 +1,339 @@
+/**
+ * Atlas Server - Intelligent Code Migration Assistant
+ *
+ * AI-powered code migration and modernization:
+ * - Framework upgrades (React 17→18, Vue 2→3, etc.)
+ * - Language conversion (JS→TS, Python 2→3)
+ * - API migration (deprecated→modern APIs)
+ * - Dependency upgrades with breaking change handling
+ * - Architecture modernization (Class→Functional, Callbacks→Promises→Async/Await)
+ * - Build tool migration (Webpack→Vite, etc.)
+ * - Database migration generation
+ * - CI/CD pipeline modernization
+ *
+ * @module code-migration
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { logger, createTimer } from '../utils.js';
+import { z } from 'zod';
+// ============================================================================
+// Validation Schema
+// ============================================================================
+const MigrationOptionsSchema = z.object({
+    projectPath: z.string().min(1),
+    migrationType: z.enum([
+        'javascript-to-typescript',
+        'react-upgrade',
+        'vue-upgrade',
+        'python-2-to-3',
+        'class-to-functional',
+        'callback-to-async',
+        'webpack-to-vite',
+        'jest-to-vitest',
+        'commonjs-to-esm',
+        'api-migration',
+        'database-migration',
+        'custom',
+    ]),
+    from: z.string(),
+    to: z.string(),
+    files: z.array(z.string()).optional(),
+    filePattern: z.string().optional(),
+    strategy: z.enum(['safe', 'aggressive', 'manual']).optional(),
+    preserveComments: z.boolean().optional(),
+    createBackup: z.boolean().optional(),
+    dryRun: z.boolean().optional(),
+    handleBreakingChanges: z.boolean().optional(),
+    updateDependencies: z.boolean().optional(),
+    generateTests: z.boolean().optional(),
+});
+// ============================================================================
+// Migration Strategies
+// ============================================================================
+/**
+ * Migrate JavaScript to TypeScript
+ */
+async function migrateJSToTS(code, filePath) {
+    const changes = [];
+    const lines = code.split('\n');
+    // Add type annotations to function parameters
+    const functionPattern = /function\s+(\w+)\s*\(([^)]*)\)/g;
+    let match;
+    while ((match = functionPattern.exec(code)) !== null) {
+        const funcName = match[1];
+        const params = match[2];
+        if (params && !params.includes(':')) {
+            const typedParams = params.split(',').map(p => `${p.trim()}: any`).join(', ');
+            const before = match[0];
+            const after = `function ${funcName}(${typedParams}): any`;
+            changes.push({
+                filePath,
+                changeType: 'type-annotation',
+                description: `Added type annotations to function ${funcName}`,
+                before,
+                after,
+                automated: true,
+                confidence: 0.7,
+            });
+        }
+    }
+    // Convert var to let/const
+    const varPattern = /\bvar\s+(\w+)/g;
+    while ((match = varPattern.exec(code)) !== null) {
+        changes.push({
+            filePath,
+            changeType: 'syntax',
+            description: 'Converted var to const/let',
+            before: `var ${match[1]}`,
+            after: `const ${match[1]}`,
+            automated: true,
+            confidence: 0.9,
+        });
+    }
+    return changes;
+}
+/**
+ * Migrate from callbacks to async/await
+ */
+async function migrateCallbackToAsync(code, filePath) {
+    const changes = [];
+    // Detect callback patterns
+    const callbackPattern = /(\w+)\s*\([^)]*,\s*function\s*\(([^)]*)\)\s*{([^}]*)}/g;
+    let match;
+    while ((match = callbackPattern.exec(code)) !== null) {
+        const funcName = match[1];
+        const params = match[2];
+        const body = match[3];
+        if (!funcName || !body)
+            continue;
+        // Convert to async/await
+        const before = match[0];
+        const after = `const result = await ${funcName}Async();\n// Process: ${body.trim()}`;
+        changes.push({
+            filePath,
+            changeType: 'syntax',
+            description: `Converted callback to async/await for ${funcName}`,
+            before,
+            after,
+            automated: false, // Requires manual verification
+            confidence: 0.6,
+        });
+    }
+    return changes;
+}
+/**
+ * Migrate React class components to functional
+ */
+async function migrateReactClassToFunctional(code, filePath) {
+    const changes = [];
+    // Detect class components
+    if (/class\s+\w+\s+extends\s+React\.Component/.test(code)) {
+        changes.push({
+            filePath,
+            changeType: 'structure',
+            description: 'Convert class component to functional component with hooks',
+            before: code.substring(0, 100) + '...',
+            after: '// Converted to functional component\nconst Component = () => {\n  // Use useState, useEffect hooks\n}',
+            automated: false,
+            confidence: 0.5,
+        });
+    }
+    // Convert this.state to useState
+    const statePattern = /this\.state\.(\w+)/g;
+    let match;
+    const stateVars = new Set();
+    while ((match = statePattern.exec(code)) !== null) {
+        if (match[1]) {
+            stateVars.add(match[1]);
+        }
+    }
+    if (stateVars.size > 0) {
+        changes.push({
+            filePath,
+            changeType: 'api',
+            description: `Convert ${stateVars.size} state variables to useState hooks`,
+            before: `this.state = { ${Array.from(stateVars).join(', ')} }`,
+            after: Array.from(stateVars).map(v => `const [${v}, set${v.charAt(0).toUpperCase() + v.slice(1)}] = useState()`).join('\n'),
+            automated: false,
+            confidence: 0.7,
+        });
+    }
+    return changes;
+}
+/**
+ * Migrate CommonJS to ESM
+ */
+async function migrateCommonJSToESM(code, filePath) {
+    const changes = [];
+    // Convert require to import
+    const requirePattern = /const\s+(\w+)\s*=\s*require\(['"]([^'"]+)['"]\)/g;
+    let match;
+    while ((match = requirePattern.exec(code)) !== null) {
+        const varName = match[1];
+        const modulePath = match[2];
+        changes.push({
+            filePath,
+            changeType: 'import',
+            description: 'Convert require to import',
+            before: match[0],
+            after: `import ${varName} from '${modulePath}'`,
+            automated: true,
+            confidence: 0.95,
+        });
+    }
+    // Convert module.exports to export
+    if (/module\.exports\s*=/.test(code)) {
+        changes.push({
+            filePath,
+            changeType: 'export',
+            description: 'Convert module.exports to export default',
+            before: 'module.exports = ',
+            after: 'export default ',
+            automated: true,
+            confidence: 0.9,
+        });
+    }
+    return changes;
+}
+/**
+ * Detect breaking changes
+ */
+function detectBreakingChanges(changes, migrationType) {
+    const breakingChanges = [];
+    // API changes with low confidence are potential breaking changes
+    const riskyChanges = changes.filter(c => c.changeType === 'api' && c.confidence < 0.8);
+    for (const change of riskyChanges) {
+        breakingChanges.push({
+            filePath: change.filePath,
+            issue: change.description,
+            impact: 'medium',
+            manualAction: 'Review and test this change carefully',
+            documentation: 'Check official migration guide',
+        });
+    }
+    return breakingChanges;
+}
+// ============================================================================
+// Main Migration Function
+// ============================================================================
+/**
+ * Intelligent code migration
+ */
+export async function migrateCode(options) {
+    const timer = createTimer();
+    const { projectPath, migrationType, from, to, files = [], strategy = 'safe', preserveComments = true, createBackup = true, dryRun = false, handleBreakingChanges = true, } = MigrationOptionsSchema.parse(options);
+    logger.info({ migrationType, from, to, dryRun }, 'Starting code migration');
+    // Collect files to migrate
+    const targetFiles = files.length > 0 ? files : [
+        join(projectPath, 'src', 'index.ts'),
+    ];
+    let allChanges = [];
+    let filesAnalyzed = 0;
+    let filesMigrated = 0;
+    let filesSkipped = 0;
+    // Process each file
+    for (const filePath of targetFiles) {
+        try {
+            const code = await fs.readFile(filePath, 'utf-8');
+            filesAnalyzed++;
+            let changes = [];
+            // Apply migration strategy
+            switch (migrationType) {
+                case 'javascript-to-typescript':
+                    changes = await migrateJSToTS(code, filePath);
+                    break;
+                case 'callback-to-async':
+                    changes = await migrateCallbackToAsync(code, filePath);
+                    break;
+                case 'class-to-functional':
+                    changes = await migrateReactClassToFunctional(code, filePath);
+                    break;
+                case 'commonjs-to-esm':
+                    changes = await migrateCommonJSToESM(code, filePath);
+                    break;
+                default:
+                    logger.warn({ migrationType }, 'Migration type not yet implemented');
+            }
+            if (changes.length > 0) {
+                allChanges = allChanges.concat(changes);
+                filesMigrated++;
+                // Apply changes if not dry run
+                if (!dryRun && strategy === 'aggressive') {
+                    let newCode = code;
+                    for (const change of changes.filter(c => c.automated)) {
+                        newCode = newCode.replace(change.before, change.after);
+                    }
+                    if (createBackup) {
+                        await fs.writeFile(`${filePath}.backup`, code);
+                    }
+                    await fs.writeFile(filePath, newCode);
+                }
+            }
+            else {
+                filesSkipped++;
+            }
+        }
+        catch (error) {
+            logger.error({ error, filePath }, 'Error processing file');
+            filesSkipped++;
+        }
+    }
+    // Detect breaking changes
+    const breakingChanges = handleBreakingChanges
+        ? detectBreakingChanges(allChanges, migrationType)
+        : [];
+    // Generate warnings
+    const warnings = [];
+    if (allChanges.some(c => !c.automated)) {
+        warnings.push({
+            filePath: 'multiple',
+            message: 'Some changes require manual intervention',
+            severity: 'warning',
+            suggestion: 'Review all changes marked as manual',
+        });
+    }
+    const stats = {
+        linesChanged: allChanges.length,
+        apiCallsUpdated: allChanges.filter(c => c.changeType === 'api').length,
+        dependenciesUpdated: 0,
+        testsGenerated: 0,
+        backupsCreated: createBackup ? filesMigrated : 0,
+    };
+    const recommendations = [
+        'Run all tests after migration',
+        'Review breaking changes carefully',
+        'Update documentation to reflect changes',
+        'Consider gradual rollout of migrated code',
+    ];
+    const migrationTimeMs = timer.elapsed();
+    logger.info({
+        filesMigrated,
+        changesCount: allChanges.length,
+        breakingChanges: breakingChanges.length,
+        migrationTimeMs
+    }, 'Migration completed');
+    return {
+        success: true,
+        migrationType,
+        from,
+        to,
+        filesAnalyzed,
+        filesMigrated,
+        filesSkipped,
+        changes: allChanges,
+        breakingChanges,
+        warnings,
+        stats,
+        recommendations,
+        migrationTimeMs,
+        dryRun,
+    };
+}
+// ============================================================================
+// Export
+// ============================================================================
+export default migrateCode;
+//# sourceMappingURL=code-migration.js.map

package/dist/tools/code-migration.js.map

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

package/dist/tools/dashboard.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Atlas Server - Live Code Metrics Dashboard Generator
+ *
+ * Generate beautiful, real-time HTML dashboards for code metrics:
+ * - Interactive visualizations
+ * - Complexity trends over time
+ * - Dependency graphs
+ * - Test coverage maps
+ * - Performance hotspots
+ * - Security audit results
+ * - Team velocity metrics
+ * - Technical debt tracking
+ *
+ * @module dashboard
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+export interface DashboardOptions {
+    projectPath: string;
+    outputPath?: string;
+    includeComplexity?: boolean;
+    includeCoverage?: boolean;
+    includeDependencies?: boolean;
+    includeSecurity?: boolean;
+    includePerformance?: boolean;
+    includeGitStats?: boolean;
+    metricsData?: ProjectMetrics;
+    historicalData?: HistoricalMetrics[];
+    title?: string;
+    theme?: 'light' | 'dark' | 'auto';
+    refreshInterval?: number;
+}
+export interface ProjectMetrics {
+    timestamp: string;
+    complexity: ComplexityMetrics;
+    coverage: CoverageMetrics;
+    dependencies: DependencyMetrics;
+    security: SecurityMetrics;
+    performance: PerformanceMetrics;
+    git: GitMetrics;
+}
+export interface ComplexityMetrics {
+    averageCyclomaticComplexity: number;
+    maxComplexity: number;
+    filesAboveThreshold: number;
+    maintainabilityIndex: number;
+    technicalDebt: {
+        hours: number;
+        cost: string;
+    };
+}
+export interface CoverageMetrics {
+    lineCoverage: number;
+    branchCoverage: number;
+    functionCoverage: number;
+    uncoveredFiles: number;
+    totalStatements: number;
+    coveredStatements: number;
+}
+export interface DependencyMetrics {
+    total: number;
+    direct: number;
+    transitive: number;
+    outdated: number;
+    vulnerable: number;
+    totalSize: number;
+}
+export interface SecurityMetrics {
+    vulnerabilities: {
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+    };
+    score: number;
+    lastScanDate: string;
+}
+export interface PerformanceMetrics {
+    buildTime: number;
+    bundleSize: number;
+    loadTime: number;
+    memoryUsage: number;
+}
+export interface GitMetrics {
+    totalCommits: number;
+    contributors: number;
+    filesChanged: number;
+    linesAdded: number;
+    linesDeleted: number;
+    branchCount: number;
+}
+export interface HistoricalMetrics {
+    date: string;
+    metrics: ProjectMetrics;
+}
+export interface DashboardResult {
+    htmlPath: string;
+    htmlContent: string;
+    metrics: ProjectMetrics;
+    executionTimeMs: number;
+}
+/**
+ * Generate interactive HTML dashboard
+ */
+export declare function generateDashboard(options: DashboardOptions): Promise<DashboardResult>;
+export default generateDashboard;
+//# sourceMappingURL=dashboard.d.ts.map

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

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