@codeyam/codeyam-cli 0.1.0-bleeding-edge.8afd3ee

package/codeyam-cli/src/utils/memoryProfiler.js

@@ -0,0 +1,168 @@
+import v8 from 'v8';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+/**
+ * Get detailed memory statistics including V8 heap info
+ */
+export function getMemoryStats() {
+    const memUsage = process.memoryUsage();
+    const heapStats = v8.getHeapStatistics();
+    return {
+        // Process memory usage (in MB)
+        process: {
+            rss: Math.round(memUsage.rss / 1024 / 1024), // Resident Set Size (total memory)
+            heapTotal: Math.round(memUsage.heapTotal / 1024 / 1024),
+            heapUsed: Math.round(memUsage.heapUsed / 1024 / 1024),
+            external: Math.round(memUsage.external / 1024 / 1024), // C++ objects bound to JS
+            arrayBuffers: Math.round(memUsage.arrayBuffers / 1024 / 1024),
+        },
+        // V8 heap statistics (in MB)
+        heap: {
+            totalHeapSize: Math.round(heapStats.total_heap_size / 1024 / 1024),
+            totalHeapSizeExecutable: Math.round(heapStats.total_heap_size_executable / 1024 / 1024),
+            totalPhysicalSize: Math.round(heapStats.total_physical_size / 1024 / 1024),
+            totalAvailableSize: Math.round(heapStats.total_available_size / 1024 / 1024),
+            usedHeapSize: Math.round(heapStats.used_heap_size / 1024 / 1024),
+            heapSizeLimit: Math.round(heapStats.heap_size_limit / 1024 / 1024),
+            mallocedMemory: Math.round(heapStats.malloced_memory / 1024 / 1024),
+            peakMallocedMemory: Math.round(heapStats.peak_malloced_memory / 1024 / 1024),
+        },
+        // System info
+        system: {
+            totalMemory: Math.round(os.totalmem() / 1024 / 1024),
+            freeMemory: Math.round(os.freemem() / 1024 / 1024),
+        },
+    };
+}
+/**
+ * Log detailed memory statistics
+ */
+export function logDetailedMemoryStats() {
+    const stats = getMemoryStats();
+    console.log('\n[Memory Profiler] Detailed Statistics:');
+    console.log('  Process Memory:');
+    console.log(`    RSS: ${stats.process.rss} MB (total memory used by process)`);
+    console.log(`    Heap Used: ${stats.process.heapUsed} MB / ${stats.process.heapTotal} MB`);
+    console.log(`    External: ${stats.process.external} MB (C++ objects)`);
+    console.log(`    ArrayBuffers: ${stats.process.arrayBuffers} MB`);
+    console.log('  V8 Heap:');
+    console.log(`    Used: ${stats.heap.usedHeapSize} MB / ${stats.heap.totalHeapSize} MB`);
+    console.log(`    Physical: ${stats.heap.totalPhysicalSize} MB`);
+    console.log(`    Limit: ${stats.heap.heapSizeLimit} MB`);
+    console.log(`    Malloced: ${stats.heap.mallocedMemory} MB (peak: ${stats.heap.peakMallocedMemory} MB)`);
+    console.log('  System:');
+    console.log(`    Total: ${stats.system.totalMemory} MB`);
+    console.log(`    Free: ${stats.system.freeMemory} MB`);
+    // Calculate percentage of heap limit
+    const heapUsagePercent = ((stats.heap.usedHeapSize / stats.heap.heapSizeLimit) * 100).toFixed(1);
+    console.log(`  Heap Usage: ${heapUsagePercent}% of limit`);
+    return stats;
+}
+/**
+ * Take a heap snapshot and save to disk
+ * Returns the path to the snapshot file
+ */
+export function takeHeapSnapshot() {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filename = `heap-${timestamp}.heapsnapshot`;
+    const snapshotDir = path.join(os.tmpdir(), 'codeyam-memory-profiles');
+    // Ensure directory exists
+    if (!fs.existsSync(snapshotDir)) {
+        fs.mkdirSync(snapshotDir, { recursive: true });
+    }
+    const filepath = path.join(snapshotDir, filename);
+    console.log(`[Memory Profiler] Taking heap snapshot...`);
+    const startTime = Date.now();
+    // Write snapshot to file
+    v8.writeHeapSnapshot(filepath);
+    const duration = Date.now() - startTime;
+    const fileSize = fs.statSync(filepath).size;
+    const fileSizeMB = (fileSize / 1024 / 1024).toFixed(2);
+    console.log(`[Memory Profiler] Heap snapshot saved to: ${filepath}`);
+    console.log(`[Memory Profiler] Size: ${fileSizeMB} MB, took ${duration}ms`);
+    console.log(`[Memory Profiler] Open in Chrome DevTools > Memory > Load`);
+    return filepath;
+}
+/**
+ * Force garbage collection if available
+ * Note: Requires Node to be started with --expose-gc flag
+ */
+export function forceGarbageCollection() {
+    if (global.gc) {
+        console.log('[Memory Profiler] Running garbage collection...');
+        const beforeStats = getMemoryStats();
+        global.gc();
+        const afterStats = getMemoryStats();
+        const freed = beforeStats.process.heapUsed - afterStats.process.heapUsed;
+        console.log(`[Memory Profiler] GC freed ${freed} MB`);
+        console.log(`[Memory Profiler] Heap: ${afterStats.process.heapUsed} MB (was ${beforeStats.process.heapUsed} MB)`);
+        return true;
+    }
+    else {
+        console.log('[Memory Profiler] GC not available. Start Node with --expose-gc to enable.');
+        return false;
+    }
+}
+/**
+ * Get memory leak indicators
+ */
+export function getMemoryLeakIndicators() {
+    const stats = getMemoryStats();
+    const heapUsagePercent = (stats.heap.usedHeapSize / stats.heap.heapSizeLimit) * 100;
+    const indicators = {
+        highHeapUsage: heapUsagePercent > 80, // Over 80% of heap limit
+        highExternalMemory: stats.process.external > 200, // Over 200MB external memory
+        highArrayBuffers: stats.process.arrayBuffers > 100, // Over 100MB in ArrayBuffers
+        nearHeapLimit: stats.heap.totalAvailableSize < 100, // Less than 100MB available
+    };
+    const warnings = [];
+    if (indicators.highHeapUsage) {
+        warnings.push(`High heap usage: ${heapUsagePercent.toFixed(1)}% of limit`);
+    }
+    if (indicators.highExternalMemory) {
+        warnings.push(`High external memory: ${stats.process.external} MB`);
+    }
+    if (indicators.highArrayBuffers) {
+        warnings.push(`High ArrayBuffer usage: ${stats.process.arrayBuffers} MB`);
+    }
+    if (indicators.nearHeapLimit) {
+        warnings.push(`Near heap limit: only ${stats.heap.totalAvailableSize} MB available`);
+    }
+    return {
+        indicators,
+        warnings,
+        hasIssues: warnings.length > 0,
+    };
+}
+/**
+ * Start memory monitoring with periodic logging
+ */
+export function startMemoryMonitoring(intervalMs = 60000) {
+    console.log(`[Memory Profiler] Starting memory monitoring (interval: ${intervalMs}ms)`);
+    let checkCount = 0;
+    const baselineStats = getMemoryStats();
+    const intervalId = setInterval(() => {
+        checkCount++;
+        const currentStats = getMemoryStats();
+        const growth = currentStats.process.heapUsed - baselineStats.process.heapUsed;
+        console.log(`[Memory Check #${checkCount}] ` +
+            `Heap: ${currentStats.process.heapUsed} MB (${growth >= 0 ? '+' : ''}${growth} MB from baseline), ` +
+            `RSS: ${currentStats.process.rss} MB`);
+        // Check for potential leaks
+        const leakCheck = getMemoryLeakIndicators();
+        if (leakCheck.hasIssues) {
+            console.warn(`[Memory Warning] Potential issues detected:`);
+            leakCheck.warnings.forEach(warning => console.warn(`  - ${warning}`));
+        }
+    }, intervalMs);
+    return {
+        intervalId,
+        baseline: baselineStats,
+        stop: () => {
+            clearInterval(intervalId);
+            console.log('[Memory Profiler] Stopped memory monitoring');
+        },
+    };
+}
+//# sourceMappingURL=memoryProfiler.js.map

package/codeyam-cli/src/utils/memoryProfiler.js.map

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

package/codeyam-cli/src/utils/mockValidator.js

@@ -0,0 +1,267 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import ts from 'typescript';
+import { extractEntitiesFromContent } from "../../../packages/utils/index.js";
+/**
+ * Validate a mock file against its corresponding original file.
+ *
+ * Checks:
+ * 1. Target file exists
+ * 2. Mock export names match original exports
+ * 3. No non-exported helper variables
+ * 4. Valid TypeScript syntax
+ */
+export async function validateMock(mockFilePath, projectRoot) {
+    const errors = [];
+    const warnings = [];
+    // Normalize mock file path
+    const absoluteMockPath = path.isAbsolute(mockFilePath)
+        ? mockFilePath
+        : path.join(projectRoot, mockFilePath);
+    // Determine the original file path from the mock path
+    // Mock paths mirror project structure: .codeyam/universal-mocks/{path}
+    const mocksDir = path.join(projectRoot, '.codeyam', 'universal-mocks');
+    const relativeMockPath = path.relative(mocksDir, absoluteMockPath);
+    const isNodeModule = relativeMockPath.startsWith('node_modules' + path.sep);
+    // For project files, the original path is the same relative path from project root
+    // For node_modules, we don't check the original file (they're external packages)
+    let originalFilePath;
+    if (isNodeModule) {
+        // Node module mocks don't have a corresponding original file to check
+        originalFilePath = relativeMockPath
+            .replace(/^node_modules[\\/]/, '')
+            .replace(/\.(ts|tsx)$/, '');
+    }
+    else {
+        originalFilePath = relativeMockPath;
+    }
+    const absoluteOriginalPath = path.join(projectRoot, originalFilePath);
+    // Initialize result
+    const result = {
+        valid: true,
+        errors,
+        warnings,
+        mockFile: {
+            path: relativeMockPath,
+            exports: [],
+        },
+        originalFile: {
+            path: originalFilePath,
+            exists: false,
+            exports: [],
+        },
+    };
+    // Read mock file
+    let mockContent;
+    try {
+        mockContent = await fs.promises.readFile(absoluteMockPath, 'utf-8');
+    }
+    catch {
+        errors.push({
+            type: 'file_not_found',
+            message: `Mock file not found: ${absoluteMockPath}`,
+            suggestion: `Create the mock file at ${mockFilePath}`,
+        });
+        result.valid = false;
+        return result;
+    }
+    // Parse mock file and extract exports
+    let mockEntities;
+    try {
+        mockEntities = extractEntitiesFromContent(mockContent, absoluteMockPath);
+    }
+    catch (e) {
+        errors.push({
+            type: 'syntax_error',
+            message: `Failed to parse mock file: ${e instanceof Error ? e.message : String(e)}`,
+            suggestion: 'Fix the TypeScript syntax errors in the mock file',
+        });
+        result.valid = false;
+        return result;
+    }
+    if (mockEntities.length === 0) {
+        errors.push({
+            type: 'no_exports',
+            message: 'Mock file has no exports',
+            suggestion: 'Add exported declarations (e.g., export const foo = ...). Only exported code is used.',
+        });
+        result.valid = false;
+        return result;
+    }
+    result.mockFile.exports = mockEntities.map((e) => e.name);
+    // Check for non-exported helper variables
+    const nonExported = detectNonExportedCode(mockContent, absoluteMockPath);
+    if (nonExported.length > 0) {
+        for (const item of nonExported) {
+            errors.push({
+                type: 'helper_variable',
+                message: `Non-exported ${item.type}: ${item.name || '(anonymous)'} will be dropped`,
+                suggestion: `Inline this ${item.type} directly inside your exports. Non-exported code is not included when mocks are applied.`,
+                details: { type: item.type, name: item.name },
+            });
+        }
+        result.valid = false;
+    }
+    // For node_modules, we can't check against original exports
+    if (isNodeModule) {
+        result.originalFile.exists = false;
+        result.originalFile.path = originalFilePath;
+        return result;
+    }
+    // Check if original file exists
+    const originalExists = fs.existsSync(absoluteOriginalPath);
+    result.originalFile.exists = originalExists;
+    if (!originalExists) {
+        // Try with different extensions
+        const extensions = ['.ts', '.tsx', '.js', '.jsx'];
+        const basePath = absoluteOriginalPath.replace(/\.(ts|tsx|js|jsx)$/, '');
+        let foundPath = null;
+        for (const ext of extensions) {
+            const tryPath = basePath + ext;
+            if (fs.existsSync(tryPath)) {
+                foundPath = tryPath;
+                break;
+            }
+        }
+        if (!foundPath) {
+            errors.push({
+                type: 'file_not_found',
+                message: `Original file not found: ${originalFilePath}`,
+                suggestion: `Check that the mock path mirrors the original file path. The mock at .codeyam/universal-mocks/foo/bar.ts should replace foo/bar.ts`,
+            });
+            result.valid = false;
+            return result;
+        }
+        // Update with found path
+        result.originalFile.exists = true;
+        result.originalFile.path = path.relative(projectRoot, foundPath);
+    }
+    // Read and parse original file
+    const actualOriginalPath = result.originalFile.exists
+        ? path.join(projectRoot, result.originalFile.path)
+        : absoluteOriginalPath;
+    let originalContent;
+    try {
+        originalContent = await fs.promises.readFile(actualOriginalPath, 'utf-8');
+    }
+    catch {
+        // File exists check passed but read failed - permissions issue?
+        errors.push({
+            type: 'file_not_found',
+            message: `Could not read original file: ${result.originalFile.path}`,
+            suggestion: 'Check file permissions',
+        });
+        result.valid = false;
+        return result;
+    }
+    const originalEntities = extractEntitiesFromContent(originalContent, actualOriginalPath);
+    result.originalFile.exports = originalEntities.map((e) => e.name);
+    // Compare exports
+    const originalExportSet = new Set(result.originalFile.exports);
+    const mockExportSet = new Set(result.mockFile.exports);
+    // Check for mock exports that don't match any original export
+    for (const mockExport of result.mockFile.exports) {
+        if (!originalExportSet.has(mockExport)) {
+            errors.push({
+                type: 'entity_mismatch',
+                message: `Mock exports '${mockExport}' but original file does not export this name`,
+                suggestion: `Available exports in original: ${result.originalFile.exports.join(', ') || '(none)'}. Rename your mock export to match.`,
+                details: {
+                    mockEntity: mockExport,
+                    originalExports: result.originalFile.exports,
+                },
+            });
+            result.valid = false;
+        }
+    }
+    // Warn about original exports not covered by mock (info only, not an error)
+    for (const originalExport of result.originalFile.exports) {
+        if (!mockExportSet.has(originalExport)) {
+            warnings.push({
+                type: 'missing_export',
+                message: `Original exports '${originalExport}' but mock does not include it`,
+                suggestion: 'This is usually fine - unmocked exports will use original code. Add to mock if it also needs mocking.',
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Detect non-exported code in a mock file that will be dropped during sync.
+ * Returns a list of non-exported declarations that won't be included.
+ */
+function detectNonExportedCode(content, filePath) {
+    const nonExported = [];
+    try {
+        const sourceFile = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true);
+        // Check each top-level statement
+        for (const statement of sourceFile.statements) {
+            // Skip import statements - those are fine
+            if (ts.isImportDeclaration(statement)) {
+                continue;
+            }
+            // Skip export statements
+            if (ts.isExportDeclaration(statement) ||
+                ts.isExportAssignment(statement)) {
+                continue;
+            }
+            // Check if the statement has an export modifier
+            const hasExport = ts.canHaveModifiers(statement) &&
+                ts
+                    .getModifiers(statement)
+                    ?.some((mod) => mod.kind === ts.SyntaxKind.ExportKeyword);
+            if (hasExport) {
+                continue;
+            }
+            // This is a non-exported statement - it will be dropped
+            if (ts.isVariableStatement(statement)) {
+                // Get all variable names
+                for (const decl of statement.declarationList.declarations) {
+                    if (ts.isIdentifier(decl.name)) {
+                        nonExported.push({
+                            type: 'variable',
+                            name: decl.name.text,
+                        });
+                    }
+                }
+            }
+            else if (ts.isFunctionDeclaration(statement)) {
+                nonExported.push({
+                    type: 'function',
+                    name: statement.name?.text || null,
+                });
+            }
+            else if (ts.isClassDeclaration(statement)) {
+                nonExported.push({
+                    type: 'class',
+                    name: statement.name?.text || null,
+                });
+            }
+            else if (ts.isInterfaceDeclaration(statement)) {
+                nonExported.push({
+                    type: 'interface',
+                    name: statement.name.text,
+                });
+            }
+            else if (ts.isTypeAliasDeclaration(statement)) {
+                nonExported.push({
+                    type: 'type',
+                    name: statement.name.text,
+                });
+            }
+            else if (ts.isEnumDeclaration(statement)) {
+                nonExported.push({
+                    type: 'enum',
+                    name: statement.name.text,
+                });
+            }
+            // Skip other statement types like expression statements (e.g., console.log)
+        }
+    }
+    catch {
+        // If parsing fails, don't warn - the main extractor will handle errors
+    }
+    return nonExported;
+}
+export default validateMock;
+//# sourceMappingURL=mockValidator.js.map

package/codeyam-cli/src/utils/mockValidator.js.map

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

package/codeyam-cli/src/utils/pathIgnoring.js

@@ -0,0 +1,127 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Parse .gitignore file and return patterns
+ */
+export function parseGitignore(gitignorePath) {
+    if (!fs.existsSync(gitignorePath)) {
+        return [];
+    }
+    const content = fs.readFileSync(gitignorePath, 'utf8');
+    return content
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith('#'))
+        .map((line) => {
+        // Remove leading slash for consistency
+        if (line.startsWith('/')) {
+            return line.slice(1);
+        }
+        return line;
+    });
+}
+/**
+ * Load all .gitignore files recursively from a directory
+ */
+export function loadGitignorePatterns(rootPath) {
+    const patterns = [];
+    function traverse(dir) {
+        const gitignorePath = path.join(dir, '.gitignore');
+        if (fs.existsSync(gitignorePath)) {
+            const localPatterns = parseGitignore(gitignorePath);
+            // Make patterns relative to root
+            const relativeDir = path.relative(rootPath, dir);
+            const prefixedPatterns = localPatterns.map((pattern) => relativeDir ? path.join(relativeDir, pattern) : pattern);
+            patterns.push(...prefixedPatterns);
+        }
+        // Traverse subdirectories (excluding node_modules, .git, etc.)
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() &&
+                    entry.name !== 'node_modules' &&
+                    entry.name !== '.git' &&
+                    entry.name !== 'dist' &&
+                    entry.name !== 'build') {
+                    traverse(path.join(dir, entry.name));
+                }
+            }
+        }
+        catch (error) {
+            // Ignore permission errors
+        }
+    }
+    traverse(rootPath);
+    return patterns;
+}
+/**
+ * Check if a file path matches a gitignore pattern
+ */
+export function matchesGitignorePattern(filePath, pattern) {
+    // Normalize paths
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    const normalizedPattern = pattern.replace(/\\/g, '/');
+    // Exact match
+    if (normalizedPath === normalizedPattern) {
+        return true;
+    }
+    // Directory match - if pattern ends with /, match only at root level
+    if (normalizedPattern.endsWith('/')) {
+        const dir = normalizedPattern.slice(0, -1);
+        // Only match at root level (start of path)
+        if (normalizedPath === dir || normalizedPath.startsWith(dir + '/')) {
+            // But not if it's nested (has a slash before the pattern)
+            const beforePattern = normalizedPath.substring(0, normalizedPath.indexOf(dir));
+            if (!beforePattern || !beforePattern.includes('/')) {
+                return true;
+            }
+        }
+    }
+    // Pattern matching with wildcards
+    if (normalizedPattern.includes('*')) {
+        const regexPattern = normalizedPattern
+            .replace(/\./g, '\\.')
+            .replace(/\*/g, '.*')
+            .replace(/\?/g, '.');
+        const regex = new RegExp(`^${regexPattern}$`);
+        if (regex.test(normalizedPath)) {
+            return true;
+        }
+    }
+    // Substring match - pattern matches anywhere in path (but not nested for directory names)
+    // For simple patterns without trailing slash, match anywhere
+    if (!pattern.endsWith('/')) {
+        if (normalizedPath.includes(normalizedPattern) ||
+            normalizedPath.includes('/' + normalizedPattern) ||
+            normalizedPath.endsWith('/' + normalizedPattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a file path should be ignored based on patterns
+ */
+export function shouldIgnorePath(filePath, customPatterns, gitignorePatterns) {
+    // Check custom regex patterns
+    for (const pattern of customPatterns) {
+        try {
+            const regex = new RegExp(pattern);
+            if (regex.test(filePath)) {
+                return true;
+            }
+        }
+        catch (error) {
+            // Invalid regex, skip
+            console.warn(`Invalid regex pattern: ${pattern}`);
+        }
+    }
+    // Check gitignore patterns
+    for (const pattern of gitignorePatterns) {
+        if (matchesGitignorePattern(filePath, pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=pathIgnoring.js.map

package/codeyam-cli/src/utils/pathIgnoring.js.map

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