@yesprasad/fluent-graph 0.2.2 → 0.2.4

package/dist/cli/commands/blast.js

@@ -1,296 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.blastCommand = void 0;
-const commander_1 = require("commander");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const cli_table3_1 = __importDefault(require("cli-table3"));
-const registry_1 = require("../../sdk/registry");
-const detector_1 = require("../../sdk/detector");
-const traversal_1 = require("../../blast/traversal");
-exports.blastCommand = new commander_1.Command('blast')
-    .description('Analyze blast radius for a target table')
-    .argument('<target>', 'Target table name (e.g., incident, x_bank_account)')
-    .option('-g, --graph <path>', 'Path to graph JSON file', 'fluent-graph.json')
-    .option('-f, --format <type>', 'Output format: table, json, csv', 'table')
-    .option('--depth <n>', 'Maximum traversal depth', '10')
-    .option('--show-paths', 'Show the full dependency chain for each transitive artifact')
-    .option('--direct-only', 'Show only hop-1 (direct) impacts')
-    .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
-            : path.join(process.cwd(), options.graph);
-        // Load registry for type name derivation (best-effort; falls back gracefully)
-        const registry = new registry_1.ArtifactTypeRegistry();
-        const sdkDetection = await (0, detector_1.detectSDK)(process.cwd());
-        if (sdkDetection.found && sdkDetection.sdkPath) {
-            registry.load(sdkDetection.sdkPath);
-        }
-        if (!fs.existsSync(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'));
-        // ── STEP 1: Validate target exists or is referenced ─────────────────────
-        const targetNode = lineageGraph.nodes.find(node => node.name === targetTableName);
-        const targetNodeId = targetNode ? targetNode.id : `platform:${targetTableName}`;
-        const isBaseTable = !targetNode;
-        const isTargetReferenced = lineageGraph.edges.some(edge => edge.to === targetNodeId || edge.targetTable === targetTableName);
-        if (!targetNode && !isTargetReferenced) {
-            const customTables = lineageGraph.nodes
-                .filter(node => registry.getPluginName(node.table) === 'TablePlugin' && !registry.isChild(node.table) && node.action !== 'DELETE')
-                .map(node => node.name)
-                .sort();
-            const platformTables = [...new Set(lineageGraph.edges
-                    .filter(edge => edge.to.startsWith('platform:'))
-                    .map(edge => edge.to.split(':')[1]))].sort();
-            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 ───────────────────────────────────────────────
-        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)));
-        }
-        // ── 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);
-        // ── STEP 4: Apply display filter ─────────────────────────────────────────
-        // Show a node if it has a source file OR is a non-deleted local node.
-        // Suppress SDK-managed child records that have no user-authored source.
-        const isDisplayable = (tn) => {
-            if (!options.includeDeleted && tn.node.action === 'DELETE')
-                return false;
-            if (tn.node.source.file)
-                return true;
-            // Suppress isChild records with no source file (intermediate composition nodes)
-            if (registry.isChild(tn.node.table))
-                return false;
-            return true;
-        };
-        const displayed = traversal.hops.filter(isDisplayable);
-        const directImpact = displayed.filter(tn => tn.hop === 1);
-        const transitiveImpact = displayed.filter(tn => tn.hop > 1);
-        if (displayed.length === 0) {
-            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 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': {
-                console.log('Artifact,Type,File,Hop,Via,State,Path');
-                displayed.forEach(tn => {
-                    const via = tn.viaEdge.via ?? tn.viaEdge.type;
-                    const pathStr = tn.path.join(' > ');
-                    console.log(`"${tn.node.name}","${registry.getDisplayGroupName(tn.node.table).toLowerCase()}","${tn.node.source.file}",${tn.hop},"${via}","${tn.node.action}","${pathStr}"`);
-                });
-                break;
-            }
-            case 'table':
-            default: {
-                // ── Direct Impact section ────────────────────────────────────────────
-                if (directImpact.length > 0) {
-                    console.log(chalk_1.default.bold('\n⚡ DIRECT IMPACT') + chalk_1.default.gray(' (Hop 1)'));
-                    const directTable = new cli_table3_1.default({
-                        head: [
-                            chalk_1.default.cyan('Artifact'),
-                            chalk_1.default.cyan('Type'),
-                            chalk_1.default.cyan('File'),
-                            chalk_1.default.cyan('Via'),
-                            chalk_1.default.cyan('State'),
-                        ],
-                        wordWrap: true,
-                        style: { head: [], border: ['gray'] },
-                    });
-                    directImpact.forEach(tn => {
-                        const via = formatVia(tn);
-                        const stateColor = tn.node.action === 'DELETE' ? chalk_1.default.red : chalk_1.default.green;
-                        directTable.push([
-                            chalk_1.default.white(tn.node.name),
-                            chalk_1.default.gray(registry.getDisplayGroupName(tn.node.table).toLowerCase()),
-                            chalk_1.default.gray(tn.node.source.file || '—'),
-                            chalk_1.default.gray(via),
-                            stateColor(tn.node.action === 'DELETE' ? 'DELETE' : 'ACTIVE'),
-                        ]);
-                    });
-                    console.log(directTable.toString());
-                }
-                // ── Transitive Impact section ────────────────────────────────────────
-                if (transitiveImpact.length > 0 && !options.directOnly) {
-                    console.log(chalk_1.default.bold('\n🌊 TRANSITIVE IMPACT') + chalk_1.default.gray(' (Hop 2+)'));
-                    const transitiveHead = [
-                        chalk_1.default.cyan('Artifact'),
-                        chalk_1.default.cyan('Type'),
-                        chalk_1.default.cyan('File'),
-                        chalk_1.default.cyan('Hop'),
-                        chalk_1.default.cyan('State'),
-                    ];
-                    if (options.showPaths) {
-                        transitiveHead.push(chalk_1.default.cyan('Path'));
-                    }
-                    const transitiveTable = new cli_table3_1.default({
-                        head: transitiveHead,
-                        wordWrap: true,
-                        style: { head: [], border: ['gray'] },
-                    });
-                    transitiveImpact.forEach(tn => {
-                        const stateColor = tn.node.action === 'DELETE' ? chalk_1.default.red : chalk_1.default.green;
-                        const row = [
-                            chalk_1.default.white(tn.node.name),
-                            chalk_1.default.gray(registry.getDisplayGroupName(tn.node.table).toLowerCase()),
-                            chalk_1.default.gray(tn.node.source.file || '—'),
-                            chalk_1.default.yellow(String(tn.hop)),
-                            stateColor(tn.node.action === 'DELETE' ? 'DELETE' : 'ACTIVE'),
-                        ];
-                        if (options.showPaths) {
-                            row.push(chalk_1.default.gray(tn.path.join(' → ')));
-                        }
-                        transitiveTable.push(row);
-                    });
-                    console.log(transitiveTable.toString());
-                }
-                // ── Impact Summary ───────────────────────────────────────────────────
-                console.log(chalk_1.default.yellow('\n📊 IMPACT SUMMARY'));
-                const totalCount = displayed.length;
-                const riskLevel = totalCount < 3 ? 'LOW' : totalCount < 8 ? 'MEDIUM' : 'HIGH';
-                const riskColor = riskLevel === 'LOW' ? chalk_1.default.green
-                    : riskLevel === 'MEDIUM' ? chalk_1.default.yellow
-                        : chalk_1.default.red;
-                console.log(chalk_1.default.gray('Total Impacted:    ') + chalk_1.default.cyan(totalCount) +
-                    chalk_1.default.gray(` (${directImpact.length} direct, ${transitiveImpact.length} transitive)`));
-                console.log(chalk_1.default.gray('Max Depth Reached: ') + chalk_1.default.cyan(traversal.maxHopReached));
-                console.log(chalk_1.default.gray('Risk Level:        ') + riskColor.bold(riskLevel));
-                console.log(chalk_1.default.gray('─'.repeat(80)) + '\n');
-                if (riskLevel === 'HIGH') {
-                    console.log(chalk_1.default.yellow('⚠️  High impact — review carefully before deploying'));
-                }
-                else if (riskLevel === 'MEDIUM') {
-                    console.log(chalk_1.default.yellow('💡 Moderate impact'));
-                }
-                break;
-            }
-        }
-    }
-    catch (error) {
-        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);
-    }
-});
-/** Format the "Via" column label from a traversal node's edge. */
-function formatVia(tn) {
-    const edge = tn.viaEdge;
-    if (edge.type === 'schema_relationship') {
-        return `${edge.via ?? 'ref'} (ref field)`;
-    }
-    return edge.via ?? edge.type;
-}

package/dist/cli/commands/extract.d.ts

@@ -1,6 +0,0 @@
-import { Command } from 'commander';
-/**
- * The Extract Command: Orchestrates the transformation of a ServiceNow Fluent
- * project into a formal directed graph.
- */
-export declare const extractCommand: Command;

package/dist/cli/commands/extract.js

@@ -1,125 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractCommand = void 0;
-const commander_1 = require("commander");
-const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
-const detector_1 = require("../../sdk/detector");
-const loader_1 = require("../../sdk/loader");
-const extractor_1 = require("../../extractor");
-const writer_1 = require("../../output/writer");
-const display_1 = require("../utils/display");
-/**
- * The Extract Command: Orchestrates the transformation of a ServiceNow Fluent
- * project into a formal directed graph.
- */
-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 && !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');
-            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 && !isJson) {
-            spinner = (0, ora_1.default)('Loading workspace SDK...').start();
-        }
-        const workspaceSDK = (0, loader_1.loadWorkspaceSDK)(sdkDetectionResult.sdkPath);
-        if (spinner) {
-            spinner.succeed('Workspace SDK loaded');
-        }
-        // Step 3: Instantiate the Project Proxy
-        if (!options.quiet && !isJson) {
-            spinner = (0, ora_1.default)('Loading project configuration...').start();
-        }
-        const projectInstance = new workspaceSDK.sdkapi.Project({ rootDir: currentWorkingDir });
-        if (spinner) {
-            spinner.succeed('Project loaded');
-        }
-        // Step 4: Extract Lineage Graph
-        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`);
-        }
-        // Step 5: Persist the Graph
-        const outputFilePath = path_1.default.isAbsolute(options.output)
-            ? options.output
-            : path_1.default.join(currentWorkingDir, options.output);
-        (0, writer_1.writeGraph)(lineageGraph, outputFilePath);
-        if (isJson) {
-            // Pure JSON on stdout: the full lineage graph, ready for agent/tool consumption.
-            console.log(JSON.stringify(lineageGraph, null, 2));
-        }
-        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 (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:'));
-                console.error(error.stack);
-            }
-        }
-        else {
-            console.error(chalk_1.default.red('\n❌ Unknown error occurred'));
-            console.error(error);
-        }
-        process.exit(1);
-    }
-});

package/dist/cli/index.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli/utils/banner.d.ts

@@ -1,2 +0,0 @@
-export declare function displayBanner(): void;
-export declare function displayVersion(): void;

package/dist/cli/utils/banner.js

@@ -1,25 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.displayBanner = displayBanner;
-exports.displayVersion = displayVersion;
-const chalk_1 = __importDefault(require("chalk"));
-function displayBanner() {
-    const banner = `
-  ███████╗██╗     ██╗   ██╗███████╗███╗   ██╗████████╗ ██████╗ ██████╗  █████╗ ██████╗ ██╗  ██╗
-  ██╔════╝██║     ██║   ██║██╔════╝████╗  ██║╚══██╔══╝██╔════╝ ██╔══██╗██╔══██╗██╔══██╗██║  ██║
-  █████╗  ██║     ██║   ██║█████╗  ██╔██╗ ██║   ██║   ██║  ███╗██████╔╝███████║██████╔╝███████║
-  ██╔══╝  ██║     ██║   ██║██╔══╝  ██║╚██╗██║   ██║   ██║   ██║██╔══██╗██╔══██║██╔════╝██╔══██║
-  ██║     ███████╗╚██████╔╝███████╗██║ ╚████║   ██║   ╚██████╔╝██║  ██║██║  ██║██║     ██║  ██║
-  ╚═╝     ╚══════╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝
-  `;
-    console.log(chalk_1.default.cyan(banner));
-    console.log(chalk_1.default.gray('        Dependency visibility and impact analysis for ServiceNow Fluent SDK projects'));
-    console.log(chalk_1.default.gray('        ────────────────────────────────────────────────────────────────────────────\n'));
-}
-function displayVersion() {
-    console.log(chalk_1.default.cyan.bold('Fluent Graph') + chalk_1.default.gray(' v0.1.0'));
-    console.log(chalk_1.default.gray('Dependency visibility and impact analysis for ServiceNow Fluent SDK projects\n'));
-}

package/dist/cli/utils/display.d.ts

@@ -1,3 +0,0 @@
-import { LineageGraph } from '../../types/graphs';
-import { ArtifactTypeRegistry } from '../../sdk/registry';
-export declare function displayLineageMap(graph: LineageGraph, registry: ArtifactTypeRegistry): void;

package/dist/cli/utils/display.js

@@ -1,137 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.displayLineageMap = displayLineageMap;
-const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const cli_table3_1 = __importDefault(require("cli-table3"));
-function displayLineageMap(graph, registry) {
-    console.log(chalk_1.default.yellow.bold('\n📊 LINEAGE MAP'));
-    console.log(chalk_1.default.gray('═'.repeat(80)));
-    // ===== DYNAMIC PLUGIN GROUPS =====
-    const pluginGroups = new Map();
-    for (const node of graph.nodes) {
-        if (node.action === 'DELETE')
-            continue;
-        const groupName = registry.getDisplayGroupName(node.table);
-        if (!pluginGroups.has(groupName)) {
-            pluginGroups.set(groupName, []);
-        }
-        pluginGroups.get(groupName).push(node);
-    }
-    for (const [groupName, nodes] of pluginGroups) {
-        // Only show primary (non-child) nodes in the section
-        const primaryNodes = nodes.filter(n => !registry.isChild(n.table) && n.source.file);
-        if (primaryNodes.length === 0)
-            continue;
-        console.log(chalk_1.default.cyan.bold(`\n${groupName}`));
-        const isBusinessRuleGroup = primaryNodes.some(n => registry.getPluginName(n.table) === 'BusinessRulePlugin');
-        if (isBusinessRuleGroup) {
-            const table = new cli_table3_1.default({
-                head: [
-                    chalk_1.default.cyan('Name'),
-                    chalk_1.default.cyan('When'),
-                    chalk_1.default.cyan('Table'),
-                    chalk_1.default.cyan('On'),
-                    chalk_1.default.cyan('Order'),
-                    chalk_1.default.cyan('Status'),
-                    chalk_1.default.cyan('File'),
-                ],
-                colWidths: [32, 8, 28, 16, 7, 8, 28],
-                wordWrap: true,
-                style: { head: [], border: ['gray'] },
-            });
-            primaryNodes.forEach(node => {
-                const statusLabel = node.action === 'DELETE' ? chalk_1.default.red('DELETE') : chalk_1.default.green('ACTIVE');
-                const when = node.attributes.when || '';
-                const depEdge = graph.edges.find(e => e.from === node.id && e.type === 'dependency' && e.targetTable);
-                const targetTable = depEdge?.targetTable || '';
-                const ops = [];
-                if (node.attributes.action_insert)
-                    ops.push('Insert');
-                if (node.attributes.action_update)
-                    ops.push('Update');
-                if (node.attributes.action_delete)
-                    ops.push('Delete');
-                if (node.attributes.action_query)
-                    ops.push('Query');
-                table.push([
-                    chalk_1.default.white(node.name),
-                    chalk_1.default.yellow(when),
-                    chalk_1.default.magenta(targetTable),
-                    ops.length ? ops.join(', ') : chalk_1.default.gray('—'),
-                    String(node.attributes.order ?? ''),
-                    statusLabel,
-                    chalk_1.default.gray(path_1.default.basename(node.source.file)),
-                ]);
-            });
-            console.log(table.toString());
-        }
-        else {
-            const table = new cli_table3_1.default({
-                head: [
-                    chalk_1.default.cyan('Name'),
-                    chalk_1.default.cyan('Status'),
-                    chalk_1.default.cyan('Source File')
-                ],
-                wordWrap: true,
-                style: { head: [], border: ['gray'] }
-            });
-            primaryNodes.forEach(node => {
-                const statusLabel = node.action === 'DELETE' ? chalk_1.default.red('DELETE') : chalk_1.default.green('ACTIVE');
-                table.push([
-                    chalk_1.default.white(node.name),
-                    statusLabel,
-                    chalk_1.default.gray(node.source.file)
-                ]);
-            });
-            console.log(table.toString());
-        }
-    }
-    // ===== SCHEMA RELATIONSHIPS =====
-    const schemaEdges = graph.edges.filter(edge => edge.type === 'schema_relationship');
-    if (schemaEdges.length > 0) {
-        console.log(chalk_1.default.cyan.bold('\n🔗 SCHEMA RELATIONSHIPS (Reference Fields)'));
-        const table = new cli_table3_1.default({
-            head: [
-                chalk_1.default.cyan('Field'),
-                chalk_1.default.cyan('From Table'),
-                chalk_1.default.cyan('Target Table')
-            ],
-            wordWrap: true,
-            style: { head: [], border: ['gray'] }
-        });
-        schemaEdges.forEach(edge => {
-            const fromNode = graph.nodes.find(node => node.id === edge.from);
-            const fieldName = fromNode?.attributes?.element || edge.via || 'unknown';
-            const fromTableName = fromNode?.attributes?.name || 'unknown';
-            const targetTableName = edge.to.startsWith('platform:')
-                ? edge.to.split(':')[1]
-                : graph.nodes.find(node => node.id === edge.to)?.name || edge.to;
-            table.push([chalk_1.default.white(fieldName), chalk_1.default.gray(fromTableName), chalk_1.default.magenta(targetTableName)]);
-        });
-        console.log(table.toString());
-    }
-    // ===== PROJECT INSIGHTS =====
-    console.log(chalk_1.default.cyan.bold('\n🧠 PROJECT INSIGHTS'));
-    const platformDeps = graph.edges.filter(edge => edge.to.startsWith('platform:')).length;
-    const internalDeps = graph.edges.filter(edge => !edge.to.startsWith('platform:')).length;
-    const userArtifacts = graph.nodes.filter(node => node.action !== 'DELETE' &&
-        node.source.file &&
-        !node.id.startsWith('platform:') &&
-        !registry.isChild(node.table));
-    console.log(` • Total User Artifacts: ${chalk_1.default.cyan(userArtifacts.length)}`);
-    const countsByType = userArtifacts.reduce((acc, node) => {
-        const groupName = registry.getDisplayGroupName(node.table);
-        acc[groupName] = (acc[groupName] || 0) + 1;
-        return acc;
-    }, {});
-    console.log(` • User Artifacts Breakdown: ${JSON.stringify(countsByType, null, 2)}`);
-    console.log(` • Platform Dependencies: ${chalk_1.default.magenta(platformDeps)}`);
-    console.log(` • Internal References:   ${chalk_1.default.white(internalDeps)}`);
-    console.log(` • Total Artifacts:       ${chalk_1.default.cyan(graph.nodes.length)}`);
-    console.log(` • Total Relationships:   ${chalk_1.default.cyan(graph.edges.length)}`);
-    console.log(chalk_1.default.gray('═'.repeat(80)) + '\n');
-}

package/dist/extractor/edges.d.ts

@@ -1,13 +0,0 @@
-import type { ArtifactEdge, ArtifactNode } from '../types/graphs';
-import type { ArtifactTypeRegistry } from '../sdk/registry';
-/**
- * UNIVERSAL EDGE EXTRACTOR
- *
- * Strategy:
- * 1. Property-based schema relationship detection (internal_type=reference)
- * 2. Logic attachment via table/collection property
- * 3. ACL name parsing — detected via registry plugin name
- * 4. Universal RecordId scan across all properties
- */
-export declare function extractReferenceEdges(records: any, allNodes: ArtifactNode[], registry: ArtifactTypeRegistry): ArtifactEdge[];
-export declare function extractCompositionEdges(records: any): ArtifactEdge[];