@yesprasad/fluent-graph 0.2.1 → 0.2.2

package/dist/cli/commands/blast.js

@@ -56,6 +56,7 @@ exports.blastCommand = new commander_1.Command('blast')
     .option('--include-deleted', 'Include deleted artifacts in the analysis')
     .option('--no-banner', 'Skip banner (inherited)')
     .action(async (targetTableName, options) => {
+    const isJson = options.format === 'json';
     try {
         const graphFilePath = path.isAbsolute(options.graph)
             ? options.graph
@@ -67,7 +68,12 @@ exports.blastCommand = new commander_1.Command('blast')
             registry.load(sdkDetection.sdkPath);
         }
         if (!fs.existsSync(graphFilePath)) {
-            console.error(chalk_1.default.red(`\n❌ Error: Graph file not found at ${graphFilePath}`));
+            if (isJson) {
+                console.log(JSON.stringify({ error: `Graph file not found at ${graphFilePath}`, code: 'GRAPH_NOT_FOUND' }));
+            }
+            else {
+                console.error(chalk_1.default.red(`\n❌ Error: Graph file not found at ${graphFilePath}`));
+            }
             process.exit(1);
         }
         const lineageGraph = JSON.parse(fs.readFileSync(graphFilePath, 'utf8'));
@@ -77,28 +83,40 @@ exports.blastCommand = new commander_1.Command('blast')
         const isBaseTable = !targetNode;
         const isTargetReferenced = lineageGraph.edges.some(edge => edge.to === targetNodeId || edge.targetTable === targetTableName);
         if (!targetNode && !isTargetReferenced) {
-            console.log(chalk_1.default.red(`\n❌ Target "${targetTableName}" not found or referenced`));
-            console.log(chalk_1.default.yellow('\n💡 Available custom tables:'));
             const customTables = lineageGraph.nodes
                 .filter(node => registry.getPluginName(node.table) === 'TablePlugin' && !registry.isChild(node.table) && node.action !== 'DELETE')
                 .map(node => node.name)
                 .sort();
-            customTables.forEach(tableName => console.log(chalk_1.default.gray(' • ') + chalk_1.default.white(tableName)));
-            console.log(chalk_1.default.yellow('\n💡 Referenced platform tables:'));
             const platformTables = [...new Set(lineageGraph.edges
                     .filter(edge => edge.to.startsWith('platform:'))
                     .map(edge => edge.to.split(':')[1]))].sort();
-            platformTables.forEach(tableName => console.log(chalk_1.default.gray(' • ') + chalk_1.default.magenta(tableName)));
+            if (isJson) {
+                console.log(JSON.stringify({
+                    error: `Target "${targetTableName}" not found or referenced`,
+                    code: 'TARGET_NOT_FOUND',
+                    availableCustomTables: customTables,
+                    availablePlatformTables: platformTables,
+                }));
+            }
+            else {
+                console.log(chalk_1.default.red(`\n❌ Target "${targetTableName}" not found or referenced`));
+                console.log(chalk_1.default.yellow('\n💡 Available custom tables:'));
+                customTables.forEach(tableName => console.log(chalk_1.default.gray(' • ') + chalk_1.default.white(tableName)));
+                console.log(chalk_1.default.yellow('\n💡 Referenced platform tables:'));
+                platformTables.forEach(tableName => console.log(chalk_1.default.gray(' • ') + chalk_1.default.magenta(tableName)));
+            }
             process.exit(1);
         }
         // ── STEP 2: Display header ───────────────────────────────────────────────
-        console.log(chalk_1.default.yellow.bold('\n🔥 BLAST RADIUS ANALYSIS'));
-        console.log(chalk_1.default.gray('═'.repeat(80)));
-        console.log(chalk_1.default.gray('Target:   ') + chalk_1.default.white(targetTableName) + (isBaseTable ? chalk_1.default.yellow(' [Base Table]') : ''));
-        if (!isBaseTable) {
-            console.log(chalk_1.default.gray('File:     ') + chalk_1.default.gray(targetNode.source.file));
+        if (!isJson) {
+            console.log(chalk_1.default.yellow.bold('\n🔥 BLAST RADIUS ANALYSIS'));
+            console.log(chalk_1.default.gray('═'.repeat(80)));
+            console.log(chalk_1.default.gray('Target:   ') + chalk_1.default.white(targetTableName) + (isBaseTable ? chalk_1.default.yellow(' [Base Table]') : ''));
+            if (!isBaseTable) {
+                console.log(chalk_1.default.gray('File:     ') + chalk_1.default.gray(targetNode.source.file));
+            }
+            console.log(chalk_1.default.gray('═'.repeat(80)));
         }
-        console.log(chalk_1.default.gray('═'.repeat(80)));
         // ── STEP 3: BFS traversal ────────────────────────────────────────────────
         const maxDepth = options.directOnly ? 1 : Math.max(1, parseInt(options.depth, 10) || 10);
         const traversal = (0, traversal_1.traverseBlastRadius)(lineageGraph, targetTableName, maxDepth);
@@ -119,23 +137,49 @@ exports.blastCommand = new commander_1.Command('blast')
         const directImpact = displayed.filter(tn => tn.hop === 1);
         const transitiveImpact = displayed.filter(tn => tn.hop > 1);
         if (displayed.length === 0) {
-            console.log(chalk_1.default.green('\n✅ Zero dependencies detected in local project.\n'));
+            if (isJson) {
+                console.log(JSON.stringify({
+                    target: targetTableName,
+                    isBaseTable,
+                    totalImpacted: 0,
+                    direct: 0,
+                    transitive: 0,
+                    maxHopReached: 0,
+                    cyclesPrevented: traversal.cyclesPrevented,
+                    riskLevel: 'LOW',
+                    impacts: [],
+                }, null, 2));
+            }
+            else {
+                console.log(chalk_1.default.green('\n✅ Zero dependencies detected in local project.\n'));
+            }
             return;
         }
         // ── STEP 5: Output ───────────────────────────────────────────────────────
         switch (options.format) {
             case 'json': {
-                const output = displayed.map(tn => ({
-                    artifact: tn.node.name,
-                    type: registry.getDisplayGroupName(tn.node.table).toLowerCase(),
-                    file: tn.node.source.file,
-                    hop: tn.hop,
-                    path: tn.path,
-                    via: tn.viaEdge.via ?? tn.viaEdge.type,
-                    edgeType: tn.viaEdge.type,
-                    state: tn.node.action,
-                }));
-                console.log(JSON.stringify(output, null, 2));
+                const totalCount = displayed.length;
+                const riskLevel = totalCount < 3 ? 'LOW' : totalCount < 8 ? 'MEDIUM' : 'HIGH';
+                console.log(JSON.stringify({
+                    target: targetTableName,
+                    isBaseTable,
+                    totalImpacted: totalCount,
+                    direct: directImpact.length,
+                    transitive: transitiveImpact.length,
+                    maxHopReached: traversal.maxHopReached,
+                    cyclesPrevented: traversal.cyclesPrevented,
+                    riskLevel,
+                    impacts: displayed.map(tn => ({
+                        artifact: tn.node.name,
+                        type: registry.getDisplayGroupName(tn.node.table).toLowerCase(),
+                        file: tn.node.source.file,
+                        hop: tn.hop,
+                        path: tn.path,
+                        via: tn.viaEdge.via ?? tn.viaEdge.type,
+                        edgeType: tn.viaEdge.type,
+                        state: tn.node.action,
+                    })),
+                }, null, 2));
                 break;
             }
             case 'csv': {
@@ -233,7 +277,12 @@ exports.blastCommand = new commander_1.Command('blast')
         }
     }
     catch (error) {
-        console.error(chalk_1.default.red('\n❌ Error:'), error.message);
+        if (isJson) {
+            console.log(JSON.stringify({ error: error.message ?? 'Unexpected error', code: 'UNEXPECTED_ERROR' }));
+        }
+        else {
+            console.error(chalk_1.default.red('\n❌ Error:'), error.message);
+        }
         process.exit(1);
     }
 });

package/dist/cli/commands/extract.js

@@ -20,30 +20,37 @@ const display_1 = require("../utils/display");
 exports.extractCommand = new commander_1.Command('analyze')
     .description('Analyze and extract dependency graph from the current project')
     .option('-o, --output <path>', 'Output file path', 'fluent-graph.json')
+    .option('-f, --format <type>', 'Output format: table, json', 'table')
     .option('-q, --quiet', 'Suppress console output')
     .option('--no-display', 'Skip visual display')
     .option('--no-banner', 'Skip banner (inherited)')
     .action(async (options) => {
+    const isJson = options.format === 'json';
     let spinner;
     try {
         const currentWorkingDir = process.cwd();
         // Step 1: Detect ServiceNow SDK Environment
-        if (!options.quiet) {
+        if (!options.quiet && !isJson) {
             spinner = (0, ora_1.default)('Detecting ServiceNow SDK...').start();
         }
         const sdkDetectionResult = await (0, detector_1.detectSDK)(currentWorkingDir);
         if (!sdkDetectionResult.found) {
             if (spinner)
                 spinner.fail('SDK not found');
-            console.error(chalk_1.default.red('\n❌ Error:'), sdkDetectionResult.error);
-            console.log(chalk_1.default.yellow('\n💡 Make sure you\'re in a ServiceNow Fluent project directory'));
+            if (isJson) {
+                console.log(JSON.stringify({ error: sdkDetectionResult.error, code: 'SDK_NOT_FOUND' }));
+            }
+            else {
+                console.error(chalk_1.default.red('\n❌ Error:'), sdkDetectionResult.error);
+                console.log(chalk_1.default.yellow('\n💡 Make sure you\'re in a ServiceNow Fluent project directory'));
+            }
             process.exit(1);
         }
         if (spinner) {
             spinner.succeed(`✅ SDK detected at ${chalk_1.default.gray(sdkDetectionResult.sdkPath)}`);
         }
         // Step 2: Dynamically Load Workspace SDK
-        if (!options.quiet) {
+        if (!options.quiet && !isJson) {
             spinner = (0, ora_1.default)('Loading workspace SDK...').start();
         }
         const workspaceSDK = (0, loader_1.loadWorkspaceSDK)(sdkDetectionResult.sdkPath);
@@ -51,7 +58,7 @@ exports.extractCommand = new commander_1.Command('analyze')
             spinner.succeed('Workspace SDK loaded');
         }
         // Step 3: Instantiate the Project Proxy
-        if (!options.quiet) {
+        if (!options.quiet && !isJson) {
             spinner = (0, ora_1.default)('Loading project configuration...').start();
         }
         const projectInstance = new workspaceSDK.sdkapi.Project({ rootDir: currentWorkingDir });
@@ -59,10 +66,19 @@ exports.extractCommand = new commander_1.Command('analyze')
             spinner.succeed('Project loaded');
         }
         // Step 4: Extract Lineage Graph
-        if (!options.quiet) {
+        if (!options.quiet && !isJson) {
             spinner = (0, ora_1.default)('Building dependency graph...').start();
         }
+        // In JSON mode, redirect SDK diagnostic noise (e.g. "Record defined N times")
+        // from stdout to stderr so stdout stays pure JSON for agent/tool consumption.
+        let restoreStdout;
+        if (isJson) {
+            const original = process.stdout.write.bind(process.stdout);
+            process.stdout.write = process.stderr.write.bind(process.stderr);
+            restoreStdout = () => { process.stdout.write = original; };
+        }
         const lineageGraph = await (0, extractor_1.extractLineageGraph)(projectInstance, workspaceSDK.registry);
+        restoreStdout?.();
         if (spinner) {
             spinner.succeed(`Graph built: ${chalk_1.default.cyan(lineageGraph.nodes.length)} nodes, ${chalk_1.default.cyan(lineageGraph.edges.length)} edges`);
         }
@@ -71,19 +87,29 @@ exports.extractCommand = new commander_1.Command('analyze')
             ? options.output
             : path_1.default.join(currentWorkingDir, options.output);
         (0, writer_1.writeGraph)(lineageGraph, outputFilePath);
-        if (!options.quiet) {
-            console.log(chalk_1.default.green('\n✅ Analysis complete'));
-            console.log(chalk_1.default.gray('   Location:     ') + chalk_1.default.white(outputFilePath));
-            console.log(chalk_1.default.gray('   Complexity:   ') + chalk_1.default.cyan((lineageGraph.edges.length / lineageGraph.nodes.length).toFixed(2)) + chalk_1.default.gray(' edges/node'));
-            console.log(chalk_1.default.gray('   Generated at: ') + chalk_1.default.gray(new Date().toLocaleTimeString()));
+        if (isJson) {
+            // Pure JSON on stdout: the full lineage graph, ready for agent/tool consumption.
+            console.log(JSON.stringify(lineageGraph, null, 2));
         }
-        // Step 6: Visual Lineage Map
-        if (options.display && !options.quiet) {
-            (0, display_1.displayLineageMap)(lineageGraph, workspaceSDK.registry);
+        else {
+            if (!options.quiet) {
+                console.log(chalk_1.default.green('\n✅ Analysis complete'));
+                console.log(chalk_1.default.gray('   Location:     ') + chalk_1.default.white(outputFilePath));
+                console.log(chalk_1.default.gray('   Complexity:   ') + chalk_1.default.cyan((lineageGraph.edges.length / lineageGraph.nodes.length).toFixed(2)) + chalk_1.default.gray(' edges/node'));
+                console.log(chalk_1.default.gray('   Generated at: ') + chalk_1.default.gray(new Date().toLocaleTimeString()));
+            }
+            // Step 6: Visual Lineage Map
+            if (options.display && !options.quiet) {
+                (0, display_1.displayLineageMap)(lineageGraph, workspaceSDK.registry);
+            }
         }
     }
     catch (error) {
-        if (error instanceof Error) {
+        if (isJson) {
+            const msg = error instanceof Error ? error.message : 'Unexpected error';
+            console.log(JSON.stringify({ error: msg, code: 'EXTRACTION_FAILED' }));
+        }
+        else if (error instanceof Error) {
             console.error(chalk_1.default.red('\n❌ Error:'), error.message);
             if (process.env.DEBUG) {
                 console.error(chalk_1.default.gray('\nStack trace:'));

package/dist/cli/index.js

@@ -15,8 +15,21 @@ const packageJsonContent = fs_1.default.readFileSync(packageJsonPath, 'utf-8');
 const packageJson = JSON.parse(packageJsonContent);
 // ===== 2. Initialize CLI program =====
 const program = new commander_1.Command();
-// Show banner on first run (unless --no-banner or --quiet flag)
-const showBanner = !process.argv.includes('--no-banner') && !process.argv.includes('--quiet');
+// Show banner on first run (unless --no-banner / --quiet, or JSON output requested).
+// JSON consumers (agents, scripts) need stdout to be pure JSON, so the banner is
+// suppressed whenever `--format json` (or `-f json`) is present.
+const wantsJsonOutput = (() => {
+    const argv = process.argv;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--format' || a === '-f')
+            return argv[i + 1] === 'json';
+        if (a === '--format=json' || a === '-f=json')
+            return true;
+    }
+    return false;
+})();
+const showBanner = !process.argv.includes('--no-banner') && !process.argv.includes('--quiet') && !wantsJsonOutput;
 if (showBanner) {
     (0, banner_1.displayBanner)();
 }

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './extractor';
 export * from './types/graphs';
+export * from './blast/traversal';

package/dist/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./extractor"), exports);
 __exportStar(require("./types/graphs"), exports);
+__exportStar(require("./blast/traversal"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yesprasad/fluent-graph",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Dependency visibility and impact analysis for ServiceNow Fluent SDK projects",
   "bin": {
     "fluent-graph": "./bin/fluent-graph.js"