arcvision 0.1.17 → 0.1.18

package/dist/index.js

@@ -56558,10 +56558,32 @@ var require_blastRadius = __commonJS({
       }
       return maxFile;
     }
+    function getTopBlastRadiusFiles2(blastRadiusMap, limit = 3) {
+      if (Object.keys(blastRadiusMap).length === 0) {
+        return [];
+      }
+      const sortedFiles = Object.entries(blastRadiusMap).map(([file, blast_radius]) => ({ file, blast_radius })).sort((a, b) => b.blast_radius - a.blast_radius);
+      return sortedFiles.slice(0, limit);
+    }
+    function computeBlastRadiusWithPercentage2(blastRadiusMap, totalFiles) {
+      if (Object.keys(blastRadiusMap).length === 0 || totalFiles === 0) {
+        return [];
+      }
+      return Object.entries(blastRadiusMap).map(([file, blastRadius]) => {
+        const percentOfGraph = Number((blastRadius / totalFiles * 100).toFixed(2));
+        return {
+          file,
+          blastRadius,
+          percentOfGraph
+        };
+      }).sort((a, b) => b.blastRadius - a.blastRadius);
+    }
     module2.exports = {
       buildReverseDependencyGraph,
       computeBlastRadius,
-      findHighestBlastRadius: findHighestBlastRadius2
+      findHighestBlastRadius: findHighestBlastRadius2,
+      getTopBlastRadiusFiles: getTopBlastRadiusFiles2,
+      computeBlastRadiusWithPercentage: computeBlastRadiusWithPercentage2
     };
   }
 });
@@ -56638,6 +56660,12 @@ var require_scanner = __commonJS({
         architectureMap.nodes.forEach((node) => {
           node.metadata.blast_radius = blastRadiusMap[node.id] || 0;
         });
+        const totalFiles = architectureMap.nodes.length;
+        const { computeBlastRadiusWithPercentage: computeBlastRadiusWithPercentage2 } = require_blastRadius();
+        const topFiles = computeBlastRadiusWithPercentage2(blastRadiusMap, totalFiles);
+        architectureMap.riskSurface = {
+          topBlastRadiusFiles: topFiles.slice(0, 3)
+        };
         return architectureMap;
       } catch (err) {
         throw err;
@@ -56664,7 +56692,7 @@ try {
 }
 var CONFIG_FILE = path.join(os.homedir(), ".arcvisionrc");
 var API_URL = process.env.ARCVISION_API_URL || "https://arcvisiondev.vercel.app";
-var { findHighestBlastRadius } = require_blastRadius();
+var { findHighestBlastRadius, getTopBlastRadiusFiles, computeBlastRadiusWithPercentage } = require_blastRadius();
 function analyzeBlastRadius(architectureMap) {
   const blastRadiusData = [];
   architectureMap.nodes.forEach((node) => {
@@ -56673,10 +56701,16 @@ function analyzeBlastRadius(architectureMap) {
       blast_radius: node.metadata.blast_radius || 0
     });
   });
-  return findHighestBlastRadius(blastRadiusData.reduce((acc, item) => {
+  const blastRadiusMap = blastRadiusData.reduce((acc, item) => {
     acc[item.file] = item.blast_radius;
     return acc;
-  }, {}));
+  }, {});
+  const totalFiles = architectureMap.nodes.length;
+  const topFiles = computeBlastRadiusWithPercentage(blastRadiusMap, totalFiles);
+  return {
+    topFiles: topFiles.slice(0, 3),
+    totalFiles
+  };
 }
 function saveToken(token) {
   try {
@@ -56816,11 +56850,23 @@ program.command("scan").description("Scan the current directory and generate arc
   try {
     const map = await scanner.scan(targetDir);
     console.log(chalk.green("Scan complete!"));
-    const blastRadiusInfo = analyzeBlastRadius(map);
-    if (blastRadiusInfo && blastRadiusInfo.blast_radius > 0) {
-      const totalFiles = map.nodes.length;
-      console.log(`
-\u26A0\uFE0F ${blastRadiusInfo.file} at the center of the system (blast radius: ${blastRadiusInfo.blast_radius} out of ${totalFiles}). This file represents a single point of systemic failure. Changes here may affect many parts of the system.`);
+    const blastRadiusAnalysis = analyzeBlastRadius(map);
+    if (blastRadiusAnalysis && blastRadiusAnalysis.topFiles && blastRadiusAnalysis.topFiles.length > 0) {
+      console.log("\n\u26A0\uFE0F  Top Structural Risk 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}
+`);
+      });
     } else {
       console.log("\nNo high-risk files detected based on import dependencies.");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcvision",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "Architecture scanner for modern codebases",
   "bin": {
     "arcvision": "./dist/index.js"

package/src/core/blastRadius.js

@@ -77,8 +77,52 @@ function findHighestBlastRadius(blastRadiusMap) {
     return maxFile;
 }
 
+/**
+ * Gets the top N files by blast radius
+ * @param {Object} blastRadiusMap - Map of file paths to their blast radius
+ * @param {number} limit - Number of top files to return (default: 3)
+ * @returns {Array} Array of top N files with their blast radius
+ */
+function getTopBlastRadiusFiles(blastRadiusMap, limit = 3) {
+    if (Object.keys(blastRadiusMap).length === 0) {
+        return [];
+    }
+    
+    // Convert to array and sort by blast radius descending
+    const sortedFiles = Object.entries(blastRadiusMap)
+        .map(([file, blast_radius]) => ({ file, blast_radius }))
+        .sort((a, b) => b.blast_radius - a.blast_radius);
+    
+    return sortedFiles.slice(0, limit);
+}
+
+/**
+ * Computes blast radius results with percentage of total files
+ * @param {Object} blastRadiusMap - Map of file paths to their blast radius
+ * @param {number} totalFiles - Total number of files in the project
+ * @returns {Array} Array of files with blast radius and percentage
+ */
+function computeBlastRadiusWithPercentage(blastRadiusMap, totalFiles) {
+    if (Object.keys(blastRadiusMap).length === 0 || totalFiles === 0) {
+        return [];
+    }
+    
+    return Object.entries(blastRadiusMap)
+        .map(([file, blastRadius]) => {
+            const percentOfGraph = Number(((blastRadius / totalFiles) * 100).toFixed(2));
+            return {
+                file,
+                blastRadius,
+                percentOfGraph
+            };
+        })
+        .sort((a, b) => b.blastRadius - a.blastRadius);
+}
+
 module.exports = {
     buildReverseDependencyGraph,
     computeBlastRadius,
-    findHighestBlastRadius
+    findHighestBlastRadius,
+    getTopBlastRadiusFiles,
+    computeBlastRadiusWithPercentage
 };

package/src/core/scanner.js

@@ -97,6 +97,15 @@ async function scan(directory) {
             node.metadata.blast_radius = blastRadiusMap[node.id] || 0;
         });
         
+        // Add top blast radius files to the architecture map
+        const totalFiles = architectureMap.nodes.length;
+        const { computeBlastRadiusWithPercentage } = require('./blastRadius');
+        const topFiles = computeBlastRadiusWithPercentage(blastRadiusMap, totalFiles);
+        
+        architectureMap.riskSurface = {
+            topBlastRadiusFiles: topFiles.slice(0, 3)
+        };
+        
         return architectureMap;
 
     } catch (err) {

package/src/index.js

@@ -25,7 +25,7 @@ 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 } = require('./core/blastRadius');
+const { findHighestBlastRadius, getTopBlastRadiusFiles, computeBlastRadiusWithPercentage } = require('./core/blastRadius');
 
 function analyzeBlastRadius(architectureMap) {
   // Extract blast radius information from nodes
@@ -38,11 +38,20 @@ function analyzeBlastRadius(architectureMap) {
     });
   });
   
-  // Find the file with the highest blast radius
-  return findHighestBlastRadius(blastRadiusData.reduce((acc, item) => {
+  const blastRadiusMap = blastRadiusData.reduce((acc, item) => {
     acc[item.file] = item.blast_radius;
     return acc;
-  }, {}));
+  }, {});
+  
+  const totalFiles = architectureMap.nodes.length;
+  
+  // 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) {
@@ -220,10 +229,24 @@ program
       console.log(chalk.green('Scan complete!'));
 
       // Analyze and print blast radius insight
-      const blastRadiusInfo = analyzeBlastRadius(map);
-      if (blastRadiusInfo && blastRadiusInfo.blast_radius > 0) {
-        const totalFiles = map.nodes.length;
-        console.log(`\n⚠️ ${blastRadiusInfo.file} at the center of the system (blast radius: ${blastRadiusInfo.blast_radius} out of ${totalFiles}). This file represents a single point of systemic failure. Changes here may affect many parts of the system.`);
+      const blastRadiusAnalysis = analyzeBlastRadius(map);
+      if (blastRadiusAnalysis && blastRadiusAnalysis.topFiles && blastRadiusAnalysis.topFiles.length > 0) {
+        console.log('\n⚠️  Top Structural Risk 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-risk files detected based on import dependencies.');
       }