arcvision 0.2.2 → 0.2.4

package/src/core/tsconfig-utils.js

@@ -1,35 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Load and parse tsconfig.json from project root
- * @param {string} projectRoot - The root directory of the project
- * @returns {Object|null} The compilerOptions from tsconfig.json or null if not found
- */
-function loadTSConfig(projectRoot) {
-  const tsconfigPaths = [
-    path.join(projectRoot, 'tsconfig.json'),
-    path.join(projectRoot, 'jsconfig.json')
-  ];
-
-  for (const tsconfigPath of tsconfigPaths) {
-    if (fs.existsSync(tsconfigPath)) {
-      try {
-        let content = fs.readFileSync(tsconfigPath, 'utf-8');
-        // Remove BOM if present (0xFEFF)
-        if (content.charCodeAt(0) === 0xFEFF) {
-          content = content.slice(1);
-        }
-        const raw = JSON.parse(content);
-        return raw.compilerOptions || {};
-      } catch (error) {
-        console.warn(`Warning: Could not parse ${tsconfigPath}:`, error.message);
-        return null;
-      }
-    }
-  }
-
-  return null;
-}
-
-module.exports = { loadTSConfig };

package/src/core/watcher.js

@@ -1,18 +0,0 @@
-const chokidar = require('chokidar');
-
-function watch(directory, callback) {
-    const watcher = chokidar.watch(directory, {
-        ignored: [/(^|[\/\\])\../, '**/node_modules/**'], // ignore dotfiles
-        persistent: true,
-        ignoreInitial: true
-    });
-
-    watcher
-        .on('add', path => callback('add', path))
-        .on('change', path => callback('change', path))
-        .on('unlink', path => callback('unlink', path));
-
-    return watcher;
-}
-
-module.exports = { watch };

package/src/engine/context_builder.js

@@ -1,130 +0,0 @@
-const path = require('path');
-const { stableId } = require('./id-generator');
-
-/**
- * Build the context object that conforms to the Arcvision schema
- * @param {Array} files - List of files from scanner
- * @param {Array} edges - List of edges from scanner
- * @param {Object} options - Options including directory path and project name
- * @returns {Object} - Context object conforming to schema
- */
-function buildContext(files, edges, options = {}) {
-    const {
-        directory = '.',
-        projectName = 'arcvision',
-        language = 'javascript'
-    } = options;
-
-    // Build nodes from files
-    const nodes = files.map(file => {
-        // Use the node's id field which is already the normalized relative path
-        const normalizedPath = file.id;
-    
-        // Determine role based on multiple factors for better accuracy
-        const hasFunctions = file.metadata.functions && file.metadata.functions.length > 0;
-        const hasClasses = file.metadata.classes && file.metadata.classes.length > 0;
-        const hasExports = file.metadata.exports && file.metadata.exports.length > 0;
-        const hasApiCalls = file.metadata.apiCalls && file.metadata.apiCalls.length > 0;
-        
-        let role = 'Structure';
-        if (hasFunctions || hasClasses || hasApiCalls) {
-            role = 'Implementation';
-        } else if (hasExports) {
-            role = 'Interface';
-        }
-        
-        // Extract dependencies more accurately and remove duplicates
-        const dependencies = [];
-        const uniqueDeps = new Set();
-        if (file.metadata.imports && Array.isArray(file.metadata.imports)) {
-            file.metadata.imports.forEach(imp => {
-                if (imp.source && typeof imp.source === 'string') {
-                    // Only add unique dependencies
-                    if (!uniqueDeps.has(imp.source)) {
-                        uniqueDeps.add(imp.source);
-                        dependencies.push(imp.source);
-                    }
-                }
-            });
-        }
-        
-        return {
-            id: stableId(normalizedPath),
-            type: 'file',
-            path: normalizedPath,
-            role: role,
-            dependencies: dependencies,
-            blast_radius: file.metadata.blast_radius || 0
-        };
-    });
-
-    // Build edges from dependencies
-    const schemaEdges = [];
-    for (const edge of edges) {
-        // Find source and target nodes to get their stable IDs
-        const sourceNode = nodes.find(n => n.path === edge.source);
-        const targetNode = nodes.find(n => n.path === edge.target);
-        
-        // Include edges where source exists (even if target doesn't exist as a node)
-        if (sourceNode) {
-            // Normalize the edge type to fit the schema
-            let relationType = 'imports';
-            if (edge.type === 'imports' || edge.type === 'require' || edge.type === 'export-from' || edge.type === 'export-all' || edge.type === 'dynamic-import' || edge.type === 'require-assignment') {
-                relationType = 'imports';
-            } else if (edge.type === 'calls') {
-                relationType = 'calls';
-            } else if (edge.type === 'owns') {
-                relationType = 'owns';
-            } else if (edge.type === 'depends_on') {
-                relationType = 'depends_on';
-            }
-            
-            if (targetNode) {
-                // Both source and target nodes exist
-                schemaEdges.push({
-                    from: sourceNode.id,
-                    to: targetNode.id,
-                    relation: relationType
-                });
-            } else {
-                // Source exists but target doesn't (external dependency like node_modules)
-                // We'll still include the edge to preserve the relationship
-                // However, since the schema requires valid node IDs, we'll only add if the target is a known node
-                // For now, we'll skip edges to non-existent targets to maintain schema compliance
-            }
-        }
-    }
-
-    // Calculate metrics
-    const metrics = {
-        total_files: nodes.length,
-        total_nodes: nodes.length,
-        total_edges: schemaEdges.length,
-        total_imports: schemaEdges.length,
-        files_with_functions: nodes.filter(n => n.role === 'Implementation').length
-    };
-
-    // Build and return the context object
-    const context = {
-        schema_version: '1.0.0',
-        generated_at: new Date().toISOString(),
-        system: {
-            name: projectName,
-            root_path: path.resolve(directory),
-            language: language
-        },
-        nodes,
-        edges: schemaEdges,
-        metrics,
-        contextSurface: options.contextSurface || {}
-    };
-    
-    // Add additional computed metrics
-    context.metrics.files_with_functions = nodes.filter(n => n.role === 'Implementation').length;
-    context.metrics.files_with_high_blast_radius = nodes.filter(n => n.blast_radius > 5).length;
-    context.metrics.total_dependencies = schemaEdges.length;
-    
-    return context;
-}
-
-module.exports = { buildContext };

package/src/engine/context_sorter.js

@@ -1,41 +0,0 @@
-/**
- * Sort the context object deterministically to ensure consistent output
- * @param {Object} context - The context object to sort
- * @returns {Object} - The sorted context object
- */
-function sortContext(context) {
-    // Create a copy of the context to avoid modifying the original
-    const sortedContext = { ...context };
-    
-    // Sort nodes by ID
-    if (Array.isArray(sortedContext.nodes)) {
-        sortedContext.nodes = [...sortedContext.nodes].sort((a, b) => a.id.localeCompare(b.id));
-    }
-    
-    // Sort edges by from, to, and relation
-    if (Array.isArray(sortedContext.edges)) {
-        sortedContext.edges = [...sortedContext.edges].sort((a, b) => {
-            if (a.from !== b.from) {
-                return a.from.localeCompare(b.from);
-            }
-            if (a.to !== b.to) {
-                return a.to.localeCompare(b.to);
-            }
-            return a.relation.localeCompare(b.relation);
-        });
-    }
-    
-    // Sort metrics alphabetically
-    if (sortedContext.metrics && typeof sortedContext.metrics === 'object') {
-        const sortedMetrics = {};
-        const keys = Object.keys(sortedContext.metrics).sort();
-        for (const key of keys) {
-            sortedMetrics[key] = sortedContext.metrics[key];
-        }
-        sortedContext.metrics = sortedMetrics;
-    }
-    
-    return sortedContext;
-}
-
-module.exports = { sortContext };

package/src/engine/context_validator.js

@@ -1,75 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const Ajv = require('ajv');
-
-// Create AJV instance with options for detailed error reporting
-const ajv = new Ajv({ allErrors: true, strict: false });
-
-/**
- * Validate the context object against the Arcvision schema using AJV
- * @param {Object} context - The context object to validate
- * @param {string} schemaPath - Path to the schema file (optional, defaults to standard schema)
- * @returns {Object} - Validation result with valid flag and errors
- */
-function validateContext(context, schemaPath = null) {
-    try {
-        // Use provided schema path or default to the standard schema
-        // When bundled, the schema file is located differently
-        let schemaFilePath;
-        if (schemaPath) {
-            schemaFilePath = schemaPath;
-        } else {
-            // Try multiple possible locations for the schema file
-            const possiblePaths = [
-                path.join(__dirname, '../../schema/arcvision_context_schema_v1.json'), // Standard path
-                path.join(__dirname, '../schema/arcvision_context_schema_v1.json'),    // Bundled path
-                path.join(__dirname, 'schema/arcvision_context_schema_v1.json'),       // Alternative bundled path
-                path.join(process.cwd(), 'schema/arcvision_context_schema_v1.json'),    // Current working directory
-            ];
-            
-            for (const possiblePath of possiblePaths) {
-                if (fs.existsSync(possiblePath)) {
-                    schemaFilePath = possiblePath;
-                    break;
-                }
-            }
-            
-            if (!schemaFilePath) {
-                throw new Error(`Schema file not found in any of the expected locations: ${possiblePaths.join(', ')}`);
-            }
-        }
-        
-        if (!fs.existsSync(schemaFilePath)) {
-            throw new Error(`Schema file not found: ${schemaFilePath}`);
-        }
-        
-        const schema = JSON.parse(fs.readFileSync(schemaFilePath, 'utf8'));
-        
-        // Compile the schema with AJV
-        const validate = ajv.compile(schema);
-        
-        // Validate the context
-        const valid = validate(context);
-
-        if (!valid) {
-            // Format errors for human readability
-            const errors = (validate.errors || []).map(err => {
-                const path = err.instancePath || "root";
-                const message = err.message || "schema violation";
-                return `${path}: ${message}`;
-            });
-
-            return { valid: false, errors };
-        }
-
-        return { valid: true };
-    } catch (error) {
-        return {
-            valid: false,
-            errors: [`Validation error: ${error.message}`],
-            details: null
-        };
-    }
-}
-
-module.exports = { validateContext };

package/src/engine/id-generator.js

@@ -1,16 +0,0 @@
-const crypto = require('crypto');
-
-/**
- * Generate a stable, deterministic ID based on the file path
- * Same path will always produce the same ID
- * @param {string} relativePath - The relative path to generate ID for
- * @returns {string} - 16-character deterministic ID
- */
-function stableId(relativePath) {
-    // Normalize the path by replacing backslashes with forward slashes and converting to lowercase
-    const normalized = relativePath.replace(/\\/g, '/').toLowerCase();
-    // Generate SHA-256 hash and take first 16 characters
-    return crypto.createHash('sha256').update(normalized).digest('hex').substring(0, 16);
-}
-
-module.exports = { stableId };

package/src/index.js

@@ -1,325 +0,0 @@
-#!/usr/bin/env node
-
-const { Command } = require('commander');
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs');
-const os = require('os');
-const scanner = require('./core/scanner');
-
-// Get version from package.json
-// Use a try-catch to handle bundled environment
-let version = '1.0.0'; // fallback version
-try {
-  // Try to get the package.json path relative to the bundled file
-  const packageJsonPath = path.join(__dirname, '../package.json');
-  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-  version = packageJson.version;
-} catch (error) {
-  // Fallback to 1.0.0 if package.json cannot be found
-  // This can happen in bundled environments
-  console.warn('Warning: Could not load version from package.json, using default');
-}
-
-const CONFIG_FILE = path.join(os.homedir(), '.arcvisionrc');
-const API_URL = process.env.ARCVISION_API_URL || 'https://arcvisiondev.vercel.app';
-
-// Blast radius analysis
-const { findHighestBlastRadius, getTopBlastRadiusFiles, computeBlastRadiusWithPercentage } = require('./core/blastRadius');
-
-function analyzeBlastRadius(architectureMap) {
-  // Extract blast radius information from nodes
-  // Handle both old and new schema formats
-  const blastRadiusData = [];
-  
-  if (architectureMap.nodes && architectureMap.nodes.length > 0) {
-    // Check if nodes have the old format (with metadata) or new format
-    architectureMap.nodes.forEach(node => {
-      let blastRadius = 0;
-      
-      // Try to get blast radius from different possible locations
-      if (node.metadata && node.metadata.blast_radius !== undefined) {
-        // Old format
-        blastRadius = node.metadata.blast_radius;
-      } else if (architectureMap.contextSurface && architectureMap.contextSurface.topBlastRadiusFiles) {
-        // Get from contextSurface if available
-        const foundFile = architectureMap.contextSurface.topBlastRadiusFiles.find(f => f.file === node.path || f.file === node.id);
-        if (foundFile) {
-          blastRadius = foundFile.blastRadius || 0;
-        }
-      }
-      
-      blastRadiusData.push({
-        file: node.path || node.id, // Use path if available, otherwise id
-        blast_radius: blastRadius
-      });
-    });
-  }
-  
-  const blastRadiusMap = blastRadiusData.reduce((acc, item) => {
-    acc[item.file] = item.blast_radius;
-    return acc;
-  }, {});
-  
-  const totalFiles = architectureMap.nodes ? architectureMap.nodes.length : 0;
-  
-  // Get top 3 files by blast radius with percentages
-  const topFiles = computeBlastRadiusWithPercentage(blastRadiusMap, totalFiles);
-  
-  return {
-    topFiles: topFiles.slice(0, 3),
-    totalFiles: totalFiles
-  };
-}
-
-function saveToken(token) {
-  try {
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify({ token }));
-    console.log(chalk.green('✅ Token saved successfully!'));
-  } catch (error) {
-    if (error.code === 'EACCES') {
-      console.error(chalk.red('❌ Permission denied: Cannot write to config file.'));
-      console.error(chalk.yellow(`Please ensure you have write permissions for: ${CONFIG_FILE}`));
-    } else {
-      console.error(chalk.red('❌ Failed to save token:'), error.message);
-    }
-    process.exit(1);
-  }
-}
-
-function getToken() {
-  try {
-    if (fs.existsSync(CONFIG_FILE)) {
-      const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
-      return config.token;
-    }
-  } catch (error) {
-    console.error(chalk.red('❌ Failed to read token configuration:'), error.message);
-    console.error(chalk.yellow('Token file may be corrupted. Run `arcvision link <TOKEN>` to reset.'));
-    return null;
-  }
-  return null;
-}
-
-// Function to upload JSON to database via Token
-async function uploadToDatabase(jsonData) {
-  const token = getToken();
-  if (!token) {
-    console.log(chalk.red('❌ No upload token found.'));
-    console.log(chalk.yellow('Run `arcvision link <TOKEN>` first to connect to a project.'));
-    process.exit(1);
-  }
-
-  try {
-    console.log(chalk.blue(`Uploading to ${API_URL}/api/upload...`));
-    
-    // Add timeout to fetch request with progress indicators
-    const controller = new AbortController();
-    
-    // Set up progress indicators
-    const progress30s = setTimeout(() => {
-      console.log(chalk.yellow('Upload taking longer than expected, please wait while the process continues...'));
-    }, 30000); // 30 seconds
-    
-    const progress60s = setTimeout(() => {
-      console.log(chalk.yellow('File size is large and may take additional time, process still working...'));
-    }, 60000); // 60 seconds
-    
-    const timeoutId = setTimeout(() => {
-      controller.abort();
-      clearTimeout(progress30s);
-      clearTimeout(progress60s);
-    }, 120000); // 120 second timeout
-    
-    const response = await fetch(`${API_URL}/api/upload`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${token}`
-      },
-      body: JSON.stringify({
-        graph: jsonData
-      }),
-      signal: controller.signal
-    });
-    
-    // Clear all timeouts and intervals
-    clearTimeout(timeoutId);
-    clearTimeout(progress30s);
-    clearTimeout(progress60s);
-    
-    if (response.status === 401) {
-      console.error(chalk.red('❌ Invalid or revoked token.'));
-      console.error(chalk.yellow('The token may be invalid, revoked, or the associated project may have been deleted.'));
-      console.log(chalk.yellow('💡 Please create a new project on the dashboard and generate a new token.'));
-      process.exit(1);
-    }
-
-    if (response.status === 404) {
-      console.error(chalk.red('❌ Project not found.'));
-      console.error(chalk.yellow('The project associated with this token may have been deleted.'));
-      console.log(chalk.yellow('💡 Please create a new project on the dashboard and generate a new token.'));
-      process.exit(1);
-    }
-    
-    if (response.status === 429) {
-      console.error(chalk.red('❌ Rate limit exceeded. Please wait before trying again.'));
-      process.exit(1);
-    }
-
-    if (!response.ok) {
-      console.error(chalk.red(`❌ Upload failed: ${response.status} ${response.statusText}`));
-      const text = await response.text();
-      try {
-        const errorJson = JSON.parse(text);
-        if (errorJson.error) console.error(chalk.red(`Server Error: ${errorJson.error}`));
-      } catch (e) {
-        console.error(chalk.red(`Server Error: ${text}`));
-      }
-      process.exit(1);
-    }
-
-    const result = await response.json();
-    if (result.success) {
-      console.log(chalk.green('✅ Graph uploaded successfully!'));
-    } else {
-      console.log(chalk.red('❌ Upload reported failure despite 200 OK.'));
-      if (result.error) {
-        console.error(chalk.red(`Error details: ${result.error}`));
-      }
-    }
-
-  } catch (error) {
-    if (error.name === 'AbortError') {
-      console.error(chalk.red('❌ Upload timeout: Request took too long to complete.'));
-      console.error(chalk.yellow('Check your internet connection and try again.'));
-    } else if (error.code === 'ENOTFOUND' || error.code === 'ECONNREFUSED' || error.code === 'ECONNRESET') {
-      console.error(chalk.red('❌ Network error: Unable to connect to the server.'));
-      console.error(chalk.yellow('Check your internet connection and ensure the API endpoint is accessible.'));
-      console.error(chalk.yellow(`API endpoint: ${API_URL}/api/upload`));
-    } else {
-      console.error(chalk.red('Upload network error:'), error.message);
-      console.error(chalk.yellow('This might be a temporary issue. Please try again later.'));
-    }
-    process.exit(1);
-  }
-}
-
-const program = new Command();
-
-program
-  .name('arcvision')
-  .description(`CLI to visualize codebase architecture
-
-Quick Start:
-  1. Sign up at the ArcVision dashboard
-  2. Create a project and name it
-  3. Generate a CLI token
-  4. Run: arcvision link <token>
-  5. Run: arcvision scan --upload
-  6. Open dashboard to see results
-  `)
-  .version(version);
-
-program
-  .command('link <token>')
-  .description('Link this CLI to a project via upload token')
-  .action((token) => {
-    try {
-      saveToken(token);
-    } catch (error) {
-      // saveToken already handles its own errors and exits
-      process.exit(1);
-    }
-  });
-
-program
-  .command('scan')
-  .description('Scan the current directory and generate architecture map')
-  .argument('[directory]', 'Directory to scan', '.')
-  .option('-u, --upload', 'Upload to database')
-  .action(async (directory, options) => {
-    const targetDir = path.resolve(directory);
-    console.log(chalk.blue(`Scanning directory: ${targetDir}`));
-    
-    try {
-      const map = await scanner.scan(targetDir);
-      console.log(chalk.green('Scan complete!'));
-
-      // Analyze and print blast radius insight
-      const blastRadiusAnalysis = analyzeBlastRadius(map);
-      if (blastRadiusAnalysis && blastRadiusAnalysis.topFiles && blastRadiusAnalysis.topFiles.length > 0) {
-        console.log('\n⚠️  Top Structural Context Hubs Detected:\n');
-        
-        blastRadiusAnalysis.topFiles.forEach((item, index) => {
-          let warningMessage = '';
-          if (index === 0) {
-            warningMessage = 'Changes here may silently propagate across the system.';
-          } else if (index === 1) {
-            warningMessage = 'Acts as a coordination layer between components.';
-          } else {
-            warningMessage = 'Modifications can cause widespread inconsistencies.';
-          }
-          
-          console.log(`${index + 1}. ${item.file}`);
-          console.log(`   Blast Radius: ${item.blastRadius} files (${item.percentOfGraph}%)`);
-          console.log(`   Warning: ${warningMessage}\n`);
-        });
-      } else {
-        console.log('\nNo high-structure files detected based on import dependencies.');
-      }
-            
-      // Validate the map before saving or uploading
-      const { validateContext } = require('./engine/context_validator');
-      const validation = validateContext(map);
-      
-      if (!validation.valid) {
-        console.error('FINAL VALIDATION FAILED:');
-        validation.errors.forEach(e => console.error(' -', e));
-        console.error('ABORTING. JSON NOT SAVED.');
-        process.exit(1);
-      }
-      
-      // Upload to database if requested
-      if (options.upload) {
-        await uploadToDatabase(map);
-      } else {
-        // Save to file with validation
-        const fs = require('fs');
-        const outputFileName = 'arcvision.context.json';
-        fs.writeFileSync(outputFileName, JSON.stringify(map, null, 2));
-        console.log(chalk.green(`✅ Structural context saved to ${outputFileName}`));
-        console.log(JSON.stringify(map, null, 2)); // Print if not uploading
-        console.log(chalk.dim('\nUse --upload to send to dashboard.'));
-      }
-    } catch (error) {
-      if (error.code === 'ENOENT') {
-        console.error(chalk.red('❌ Directory not found:'), targetDir);
-        console.error(chalk.yellow('Please check the directory path and ensure it exists.'));
-        process.exit(1);
-      } else if (error.code === 'EACCES') {
-        console.error(chalk.red('❌ Permission denied:'), targetDir);
-        console.error(chalk.yellow('Please ensure you have read permissions for the specified directory.'));
-        process.exit(1);
-      } else {
-        console.error(chalk.red('Scan failed:'), error.message);
-        console.error(chalk.yellow('This might be caused by file access issues or unsupported file types.'));
-        
-        // Provide more specific guidance based on common errors
-        if (error.message && error.message.toLowerCase().includes('parse')) {
-          console.error(chalk.yellow('If this is a TypeScript declaration file, note that .d.ts files are now skipped.'));
-        }
-        
-        // Additional error handling for validation failures
-        if (error.message && error.message.includes('VALIDATION FAILED')) {
-          console.error(chalk.red('❌ Schema validation failed - output not saved'));
-        }
-        
-        process.exit(1);
-      }
-    }
-  });
-
-
-
-program.parse();

package/src/plugins/express-plugin.js

@@ -1,48 +0,0 @@
-const parser = require('@babel/parser');
-const traverse = require('@babel/traverse').default;
-const fs = require('fs');
-
-module.exports = {
-    name: 'express-route-detector',
-
-    process: async (filePath, metadata) => {
-        try {
-            const content = fs.readFileSync(filePath, 'utf-8');
-            const ast = parser.parse(content, {
-                sourceType: 'module',
-                plugins: ['jsx', 'typescript']
-            });
-
-            const routes = [];
-
-            traverse(ast, {
-                CallExpression({ node }) {
-                    // Detect Express routes: app.get(), app.post(), router.get(), etc.
-                    if (node.callee.type === 'MemberExpression') {
-                        const obj = node.callee.object.name;
-                        const method = node.callee.property.name;
-
-                        if ((obj === 'app' || obj === 'router') &&
-                            ['get', 'post', 'put', 'delete', 'patch'].includes(method)) {
-                            const pathArg = node.arguments[0];
-                            if (pathArg && pathArg.type === 'StringLiteral') {
-                                routes.push({
-                                    method: method.toUpperCase(),
-                                    path: pathArg.value
-                                });
-                            }
-                        }
-                    }
-                }
-            });
-
-            if (routes.length > 0) {
-                return { expressRoutes: routes };
-            }
-
-            return null;
-        } catch (error) {
-            return null;
-        }
-    }
-};