cli-node-graph 1.0.1

package/README.md

@@ -0,0 +1,69 @@
+# cli-node-graph
+
+TypeScript codebase knowledge graph analyzer — an Nx-style dependency graph tool with deep symbol-level analysis.
+
+## Features
+
+- **Full AST analysis** using the TypeScript Compiler API
+- **Rich graph model** — files, classes, interfaces, functions, methods, imports, calls, inheritance, decorators, and more
+- **Graph algorithms** — cycle detection, shortest path, impact analysis, topological sort
+- **Multiple export formats** — JSON, DOT, GraphML, Mermaid, Cytoscape, React Flow, Neo4j CSV
+- **CLI** for analysis, export, and querying
+- **React Flow visualization** with search, filtering, path finder, and layouts
+
+## Quick Start
+
+```bash
+npm install
+npm run build
+npm test
+
+# Analyze a project
+npm run cli-node-graph analyze ./tests/fixtures/sample-project
+
+# Export graph
+npm run cli-node-graph export ./tests/fixtures/sample-project --format reactflow -o graph.json
+
+# Detect cycles
+npm run cli-node-graph cycles ./tests/fixtures/sample-project
+
+# Impact analysis
+npm run cli-node-graph impact UserService ./tests/fixtures/sample-project
+
+# Statistics
+npm run cli-node-graph stats ./tests/fixtures/sample-project
+```
+
+## Visualization
+
+```bash
+cd visualization
+npm install
+npm run dev
+```
+
+Load a React Flow JSON export from the CLI to visualize your codebase graph interactively.
+
+## Architecture
+
+```
+CLI → Project Loader → TypeScript Program → AST Walker → Visitors → Resolvers → Graph Builder → Graph → Exporters / Analyzers
+```
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for details.
+
+## API
+
+```typescript
+import { GraphBuilder, GraphAlgorithms, JsonExporter } from 'cli-node-graph';
+
+const graph = new GraphBuilder().build({ projectRoot: './my-project' });
+const cycles = new GraphAlgorithms(graph).detectCycles();
+const json = new JsonExporter().export(graph);
+```
+
+See [docs/API.md](docs/API.md) for the full API reference.
+
+## License
+
+MIT

package/dist/analysis/CircularDependencyAnalyzer.d.ts

@@ -0,0 +1,13 @@
+import type { Graph } from '../graph/Graph.js';
+/** Detects circular dependencies in the graph. */
+export declare class CircularDependencyAnalyzer {
+    analyze(graph: Graph): CycleReport[];
+}
+/** Report of a single dependency cycle. */
+export interface CycleReport {
+    id: string;
+    nodes: string[];
+    length: number;
+    labels: string[];
+}
+//# sourceMappingURL=CircularDependencyAnalyzer.d.ts.map

package/dist/analysis/CircularDependencyAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircularDependencyAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/CircularDependencyAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,kDAAkD;AAClD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,EAAE;CAWrC;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/analysis/CircularDependencyAnalyzer.js

@@ -0,0 +1,15 @@
+import { GraphAlgorithms } from '../graph/GraphAlgorithms.js';
+/** Detects circular dependencies in the graph. */
+export class CircularDependencyAnalyzer {
+    analyze(graph) {
+        const algorithms = new GraphAlgorithms(graph);
+        const cycles = algorithms.detectCycles();
+        return cycles.map((cycle, index) => ({
+            id: `cycle-${String(index + 1)}`,
+            nodes: cycle,
+            length: cycle.length,
+            labels: cycle.map((id) => graph.getNode(id)?.label ?? id),
+        }));
+    }
+}
+//# sourceMappingURL=CircularDependencyAnalyzer.js.map

package/dist/analysis/CircularDependencyAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircularDependencyAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/CircularDependencyAnalyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,kDAAkD;AAClD,MAAM,OAAO,0BAA0B;IACrC,OAAO,CAAC,KAAY;QAClB,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,EAAE,CAAC;QAEzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACnC,EAAE,EAAE,SAAS,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE;YAChC,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;SAC1D,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/analysis/DeadCodeAnalyzer.d.ts

@@ -0,0 +1,13 @@
+import type { Graph } from '../graph/Graph.js';
+/** Finds potentially unused code in the graph. */
+export declare class DeadCodeAnalyzer {
+    analyze(graph: Graph): DeadCodeReport;
+}
+/** Report of dead/unused code findings. */
+export interface DeadCodeReport {
+    unusedExports: string[];
+    unusedFunctions: string[];
+    unreachableClasses: string[];
+    orphanModules: string[];
+}
+//# sourceMappingURL=DeadCodeAnalyzer.d.ts.map

package/dist/analysis/DeadCodeAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeadCodeAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/DeadCodeAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,kDAAkD;AAClD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc;CAwCtC;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/analysis/DeadCodeAnalyzer.js

@@ -0,0 +1,37 @@
+import { EdgeKind } from '../model/EdgeKind.js';
+import { NodeKind } from '../model/NodeKind.js';
+/** Finds potentially unused code in the graph. */
+export class DeadCodeAnalyzer {
+    analyze(graph) {
+        const unusedExports = [];
+        const unusedFunctions = [];
+        const unreachableClasses = [];
+        const orphanModules = [];
+        for (const node of graph.getNodes()) {
+            const incoming = graph.getIncomingEdges(node.id);
+            const hasReferences = incoming.some((e) => e.kind === EdgeKind.IMPORTS ||
+                e.kind === EdgeKind.CALLS ||
+                e.kind === EdgeKind.REFERENCES ||
+                e.kind === EdgeKind.EXTENDS ||
+                e.kind === EdgeKind.IMPLEMENTS);
+            if (node.metadata['exported'] === true && !hasReferences && incoming.length === 0) {
+                unusedExports.push(node.id);
+            }
+            if (node.kind === NodeKind.Function && !hasReferences) {
+                unusedFunctions.push(node.id);
+            }
+            if (node.kind === NodeKind.Class && !hasReferences) {
+                unreachableClasses.push(node.id);
+            }
+            if (node.kind === NodeKind.File) {
+                const imports = graph.getOutgoingEdges(node.id).filter((e) => e.kind === EdgeKind.IMPORTS);
+                const importedBy = graph.getIncomingEdges(node.id).filter((e) => e.kind === EdgeKind.IMPORTS);
+                if (imports.length === 0 && importedBy.length === 0) {
+                    orphanModules.push(node.id);
+                }
+            }
+        }
+        return { unusedExports, unusedFunctions, unreachableClasses, orphanModules };
+    }
+}
+//# sourceMappingURL=DeadCodeAnalyzer.js.map

package/dist/analysis/DeadCodeAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeadCodeAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/DeadCodeAnalyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,kDAAkD;AAClD,MAAM,OAAO,gBAAgB;IAC3B,OAAO,CAAC,KAAY;QAClB,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,MAAM,eAAe,GAAa,EAAE,CAAC;QACrC,MAAM,kBAAkB,GAAa,EAAE,CAAC;QACxC,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO;gBAC3B,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK;gBACzB,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,UAAU;gBAC9B,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO;gBAC3B,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,UAAU,CACjC,CAAC;YAEF,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClF,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9B,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;gBACtD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnD,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,MAAM,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC3F,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC9F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACpD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC;IAC/E,CAAC;CACF"}

package/dist/analysis/DependencyAnalyzer.d.ts

@@ -0,0 +1,16 @@
+import type { Graph } from '../graph/Graph.js';
+/** Analyzes dependency relationships between nodes. */
+export declare class DependencyAnalyzer {
+    analyze(graph: Graph): DependencyReport;
+}
+/** Summary of dependency relationships. */
+export interface DependencyReport {
+    totalImports: number;
+    totalCalls: number;
+    tightlyCoupled: {
+        nodeId: string;
+        importCount: number;
+        label: string;
+    }[];
+}
+//# sourceMappingURL=DependencyAnalyzer.d.ts.map

package/dist/analysis/DependencyAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/DependencyAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,uDAAuD;AACvD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB;CAwBxC;AAED,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1E"}

package/dist/analysis/DependencyAnalyzer.js

@@ -0,0 +1,26 @@
+import { EdgeKind } from '../model/EdgeKind.js';
+/** Analyzes dependency relationships between nodes. */
+export class DependencyAnalyzer {
+    analyze(graph) {
+        const importEdges = graph.getEdgesByKind(EdgeKind.IMPORTS);
+        const callEdges = graph.getEdgesByKind(EdgeKind.CALLS);
+        const fileImportCounts = new Map();
+        for (const edge of importEdges) {
+            fileImportCounts.set(edge.source, (fileImportCounts.get(edge.source) ?? 0) + 1);
+        }
+        const tightlyCoupled = [...fileImportCounts.entries()]
+            .filter(([, count]) => count >= 5)
+            .map(([id, count]) => ({
+            nodeId: id,
+            importCount: count,
+            label: graph.getNode(id)?.label ?? id,
+        }))
+            .sort((a, b) => b.importCount - a.importCount);
+        return {
+            totalImports: importEdges.length,
+            totalCalls: callEdges.length,
+            tightlyCoupled,
+        };
+    }
+}
+//# sourceMappingURL=DependencyAnalyzer.js.map

package/dist/analysis/DependencyAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/DependencyAnalyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,uDAAuD;AACvD,MAAM,OAAO,kBAAkB;IAC7B,OAAO,CAAC,KAAY;QAClB,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEnD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,cAAc,GAAG,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC;aACnD,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,MAAM,EAAE,EAAE;YACV,WAAW,EAAE,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE;SACtC,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;QAEjD,OAAO;YACL,YAAY,EAAE,WAAW,CAAC,MAAM;YAChC,UAAU,EAAE,SAAS,CAAC,MAAM;YAC5B,cAAc;SACf,CAAC;IACJ,CAAC;CACF"}

package/dist/analysis/ImpactAnalyzer.d.ts

@@ -0,0 +1,16 @@
+import type { Graph } from '../graph/Graph.js';
+/** Analyzes downstream impact of changing a node. */
+export declare class ImpactAnalyzer {
+    analyze(graph: Graph, nodeId: string): ImpactReport;
+    analyzeByFile(graph: Graph, filePath: string): ImpactReport[];
+}
+/** Report of downstream impact from a change. */
+export interface ImpactReport {
+    source: string;
+    sourceLabel?: string;
+    affected: string[];
+    affectedCount: number;
+    depth: number;
+    affectedLabels?: string[];
+}
+//# sourceMappingURL=ImpactAnalyzer.d.ts.map

package/dist/analysis/ImpactAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImpactAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/ImpactAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,qDAAqD;AACrD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IAoBnD,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE;CAI9D;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B"}

package/dist/analysis/ImpactAnalyzer.js

@@ -0,0 +1,26 @@
+import { GraphAlgorithms } from '../graph/GraphAlgorithms.js';
+/** Analyzes downstream impact of changing a node. */
+export class ImpactAnalyzer {
+    analyze(graph, nodeId) {
+        const node = graph.getNode(nodeId);
+        if (!node) {
+            return { source: nodeId, affected: [], affectedCount: 0, depth: 0 };
+        }
+        const algorithms = new GraphAlgorithms(graph);
+        const affected = [...algorithms.reverseDependencies(nodeId)];
+        const depth = algorithms.dependencyDepth(nodeId);
+        return {
+            source: nodeId,
+            sourceLabel: node.label,
+            affected,
+            affectedCount: affected.length,
+            depth,
+            affectedLabels: affected.map((id) => graph.getNode(id)?.label ?? id),
+        };
+    }
+    analyzeByFile(graph, filePath) {
+        const fileNodes = graph.getNodesByFile(filePath);
+        return fileNodes.map((n) => this.analyze(graph, n.id));
+    }
+}
+//# sourceMappingURL=ImpactAnalyzer.js.map

package/dist/analysis/ImpactAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImpactAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/ImpactAnalyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,qDAAqD;AACrD,MAAM,OAAO,cAAc;IACzB,OAAO,CAAC,KAAY,EAAE,MAAc;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACtE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAEjD,OAAO;YACL,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,QAAQ;YACR,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,KAAK;YACL,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;SACrE,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,KAAY,EAAE,QAAgB;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/analysis/LayerViolationAnalyzer.d.ts

@@ -0,0 +1,31 @@
+import type { LayerRule } from '../config/AnalysisConfig.js';
+import type { Graph } from '../graph/Graph.js';
+/** Detects layer architecture violations. */
+export declare class LayerViolationAnalyzer {
+    analyze(graph: Graph, rules: LayerRule[]): LayerViolationReport[];
+    private buildLayerMap;
+    private resolveLayer;
+}
+/** A single layer violation. */
+export interface LayerViolationReport {
+    source: string;
+    target: string;
+    sourceLayer: string;
+    targetLayer: string;
+    sourceFile: string;
+    targetFile: string;
+}
+/** Computes graph statistics. */
+export declare function computeStats(graph: Graph): GraphStats;
+/** Summary statistics for a graph. */
+export interface GraphStats {
+    nodeCount: number;
+    edgeCount: number;
+    fileCount: number;
+    classCount: number;
+    functionCount: number;
+    interfaceCount: number;
+    nodesByKind: Record<string, number>;
+    edgesByKind: Record<string, number>;
+}
+//# sourceMappingURL=LayerViolationAnalyzer.d.ts.map

package/dist/analysis/LayerViolationAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayerViolationAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/LayerViolationAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,6CAA6C;AAC7C,qBAAa,sBAAsB;IACjC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,oBAAoB,EAAE;IA+BjE,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;CASrB;AAED,gCAAgC;AAChC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAqBrD;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

package/dist/analysis/LayerViolationAnalyzer.js

@@ -0,0 +1,71 @@
+import { EdgeKind } from '../model/EdgeKind.js';
+import { NodeKind } from '../model/NodeKind.js';
+/** Detects layer architecture violations. */
+export class LayerViolationAnalyzer {
+    analyze(graph, rules) {
+        const violations = [];
+        const layerMap = this.buildLayerMap(rules);
+        for (const edge of graph.getEdgesByKind(EdgeKind.IMPORTS)) {
+            const sourceNode = graph.getNode(edge.source);
+            const targetNode = graph.getNode(edge.target);
+            if (!sourceNode?.file || !targetNode?.file)
+                continue;
+            const sourceLayer = this.resolveLayer(sourceNode.file, layerMap);
+            const targetLayer = this.resolveLayer(targetNode.file, layerMap);
+            if (!sourceLayer || !targetLayer)
+                continue;
+            const sourceRule = rules.find((r) => r.name === sourceLayer);
+            if (!sourceRule?.allowedImports)
+                continue;
+            if (!sourceRule.allowedImports.includes(targetLayer)) {
+                violations.push({
+                    source: edge.source,
+                    target: edge.target,
+                    sourceLayer,
+                    targetLayer,
+                    sourceFile: sourceNode.file,
+                    targetFile: targetNode.file,
+                });
+            }
+        }
+        return violations;
+    }
+    buildLayerMap(rules) {
+        const map = new Map();
+        for (const rule of rules) {
+            map.set(rule.name, rule.name);
+        }
+        return map;
+    }
+    resolveLayer(filePath, _layerMap) {
+        for (const [layer] of _layerMap) {
+            const rule = layer;
+            if (filePath.includes(`/${rule.toLowerCase()}/`) || filePath.includes(`\\${rule.toLowerCase()}\\`)) {
+                return layer;
+            }
+        }
+        return undefined;
+    }
+}
+/** Computes graph statistics. */
+export function computeStats(graph) {
+    const nodesByKind = {};
+    const edgesByKind = {};
+    for (const node of graph.getNodes()) {
+        nodesByKind[node.kind] = (nodesByKind[node.kind] ?? 0) + 1;
+    }
+    for (const edge of graph.getEdges()) {
+        edgesByKind[edge.kind] = (edgesByKind[edge.kind] ?? 0) + 1;
+    }
+    return {
+        nodeCount: graph.nodeCount,
+        edgeCount: graph.edgeCount,
+        fileCount: graph.getNodesByKind(NodeKind.File).length,
+        classCount: graph.getNodesByKind(NodeKind.Class).length,
+        functionCount: graph.getNodesByKind(NodeKind.Function).length,
+        interfaceCount: graph.getNodesByKind(NodeKind.Interface).length,
+        nodesByKind,
+        edgesByKind,
+    };
+}
+//# sourceMappingURL=LayerViolationAnalyzer.js.map

package/dist/analysis/LayerViolationAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayerViolationAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/LayerViolationAnalyzer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,6CAA6C;AAC7C,MAAM,OAAO,sBAAsB;IACjC,OAAO,CAAC,KAAY,EAAE,KAAkB;QACtC,MAAM,UAAU,GAA2B,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,UAAU,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI;gBAAE,SAAS;YAErD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACjE,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACjE,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW;gBAAE,SAAS;YAE3C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;YAC7D,IAAI,CAAC,UAAU,EAAE,cAAc;gBAAE,SAAS;YAE1C,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrD,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,WAAW;oBACX,WAAW;oBACX,UAAU,EAAE,UAAU,CAAC,IAAI;oBAC3B,UAAU,EAAE,UAAU,CAAC,IAAI;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,aAAa,CAAC,KAAkB;QACtC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,YAAY,CAAC,QAAgB,EAAE,SAA8B;QACnE,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC;YACnB,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;gBACnG,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAYD,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;QACpC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;QACpC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM;QACrD,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM;QACvD,aAAa,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM;QAC7D,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM;QAC/D,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/cli/ProjectLoader.d.ts

@@ -0,0 +1,13 @@
+import type { AnalysisConfig } from '../config/AnalysisConfig.js';
+import { Graph } from '../graph/Graph.js';
+/** Loads and caches project analysis results. */
+export declare class ProjectLoader {
+    private graph;
+    private config;
+    analyze(config: AnalysisConfig): Graph;
+    getGraph(): Graph | null;
+    getConfig(): AnalysisConfig | null;
+    loadCache(projectRoot: string): Graph | null;
+    private saveCache;
+}
+//# sourceMappingURL=ProjectLoader.d.ts.map

package/dist/cli/ProjectLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/cli/ProjectLoader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAO1C,iDAAiD;AACjD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAA+B;IAE7C,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK;IAQtC,QAAQ,IAAI,KAAK,GAAG,IAAI;IAIxB,SAAS,IAAI,cAAc,GAAG,IAAI;IAIlC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAsB5C,OAAO,CAAC,SAAS;CAQlB"}

package/dist/cli/ProjectLoader.js

@@ -0,0 +1,48 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { GraphBuilder } from '../graph/GraphBuilder.js';
+import { Graph } from '../graph/Graph.js';
+const CACHE_DIR = '.cli-node-graph';
+const CACHE_FILE = 'graph.json';
+/** Loads and caches project analysis results. */
+export class ProjectLoader {
+    graph = null;
+    config = null;
+    analyze(config) {
+        this.config = config;
+        const builder = new GraphBuilder();
+        this.graph = builder.build(config);
+        this.saveCache(config.projectRoot, this.graph);
+        return this.graph;
+    }
+    getGraph() {
+        return this.graph;
+    }
+    getConfig() {
+        return this.config;
+    }
+    loadCache(projectRoot) {
+        try {
+            const cachePath = join(resolve(projectRoot), CACHE_DIR, CACHE_FILE);
+            const data = JSON.parse(readFileSync(cachePath, 'utf-8'));
+            const graph = new Graph();
+            for (const node of data.nodes) {
+                graph.addNode(node);
+            }
+            for (const edge of data.edges) {
+                graph.addEdge(edge);
+            }
+            this.graph = graph;
+            return graph;
+        }
+        catch {
+            return null;
+        }
+    }
+    saveCache(projectRoot, graph) {
+        const cacheDir = join(resolve(projectRoot), CACHE_DIR);
+        mkdirSync(cacheDir, { recursive: true });
+        writeFileSync(join(cacheDir, CACHE_FILE), JSON.stringify({ nodes: graph.getNodes(), edges: graph.getEdges() }));
+    }
+}
+//# sourceMappingURL=ProjectLoader.js.map

package/dist/cli/ProjectLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectLoader.js","sourceRoot":"","sources":["../../src/cli/ProjectLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI1C,MAAM,SAAS,GAAG,iBAAiB,CAAC;AACpC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,iDAAiD;AACjD,MAAM,OAAO,aAAa;IAChB,KAAK,GAAiB,IAAI,CAAC;IAC3B,MAAM,GAA0B,IAAI,CAAC;IAE7C,OAAO,CAAC,MAAsB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,WAAmB;QAC3B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;YACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAGvD,CAAC;YAEF,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,WAAmB,EAAE,KAAY;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;QACvD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,aAAa,CACX,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAC1B,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CACrE,CAAC;IACJ,CAAC;CACF"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Command } from 'commander';
+import { CircularDependencyAnalyzer } from '../analysis/CircularDependencyAnalyzer.js';
+import { computeStats } from '../analysis/LayerViolationAnalyzer.js';
+import { ImpactAnalyzer } from '../analysis/ImpactAnalyzer.js';
+import { CytoscapeExporter } from '../exporters/CytoscapeExporter.js';
+import { DotExporter, MermaidExporter } from '../exporters/DotExporter.js';
+import { GraphMLExporter } from '../exporters/GraphMLExporter.js';
+import { JsonExporter } from '../exporters/JsonExporter.js';
+import { Neo4jExporter, ReactFlowExporter } from '../exporters/CytoscapeExporter.js';
+import { ProjectLoader } from './ProjectLoader.js';
+const program = new Command();
+const loader = new ProjectLoader();
+program
+    .name('cli-node-graph')
+    .description('TypeScript codebase knowledge graph analyzer')
+    .version('1.0.1');
+program
+    .command('analyze')
+    .description('Analyze a TypeScript project and build the dependency graph')
+    .argument('[path]', 'Project root path', '.')
+    .option('--tsconfig <path>', 'Path to tsconfig.json', 'tsconfig.json')
+    .action((path, options) => {
+    const projectRoot = resolve(path);
+    console.error(`Analyzing ${projectRoot}...`);
+    const graph = loader.analyze({ projectRoot, tsconfigPath: options.tsconfig });
+    console.error(`Done: ${String(graph.nodeCount)} nodes, ${String(graph.edgeCount)} edges`);
+    console.log(JSON.stringify({ nodeCount: graph.nodeCount, edgeCount: graph.edgeCount }));
+});
+program
+    .command('graph')
+    .description('Show summary of the last analyzed graph')
+    .argument('[path]', 'Project root path', '.')
+    .action((path) => {
+    let graph = loader.getGraph();
+    if (!graph)
+        graph = loader.loadCache(resolve(path));
+    if (!graph) {
+        console.error('No graph found. Run: cli-node-graph analyze');
+        process.exit(1);
+    }
+    const stats = computeStats(graph);
+    console.log(JSON.stringify(stats, null, 2));
+});
+program
+    .command('export')
+    .description('Export the graph to a file format')
+    .argument('[path]', 'Project root path', '.')
+    .requiredOption('--format <format>', 'Export format (json|dot|graphml|cytoscape|reactflow|neo4j|mermaid)')
+    .option('-o, --output <file>', 'Output file path')
+    .action((path, options) => {
+    let graph = loader.getGraph();
+    if (!graph)
+        graph = loader.loadCache(resolve(path));
+    if (!graph) {
+        graph = loader.analyze({ projectRoot: resolve(path) });
+    }
+    const exporter = getExporter(options.format);
+    const output = exporter.export(graph);
+    const outFile = options.output ?? `cli-node-graph.${options.format === 'reactflow' ? 'json' : options.format}`;
+    if (options.output || !process.stdout.isTTY) {
+        writeFileSync(outFile, output);
+        console.error(`Exported to ${outFile}`);
+    }
+    else {
+        console.log(output);
+    }
+});
+program
+    .command('cycles')
+    .description('Detect circular dependencies')
+    .argument('[path]', 'Project root path', '.')
+    .action((path) => {
+    let graph = loader.getGraph();
+    if (!graph)
+        graph = loader.loadCache(resolve(path));
+    if (!graph) {
+        graph = loader.analyze({ projectRoot: resolve(path) });
+    }
+    const analyzer = new CircularDependencyAnalyzer();
+    const cycles = analyzer.analyze(graph);
+    console.log(JSON.stringify(cycles, null, 2));
+});
+program
+    .command('impact')
+    .description('Analyze downstream impact of a file or symbol')
+    .argument('<target>', 'File path or node id')
+    .argument('[path]', 'Project root path', '.')
+    .action((target, path) => {
+    let graph = loader.getGraph();
+    if (!graph)
+        graph = loader.loadCache(resolve(path));
+    if (!graph) {
+        graph = loader.analyze({ projectRoot: resolve(path) });
+    }
+    const analyzer = new ImpactAnalyzer();
+    const fileNode = graph.getNodes().find((n) => n.file?.includes(target) || n.id === target);
+    if (!fileNode) {
+        console.error(`Node not found: ${target}`);
+        process.exit(1);
+    }
+    const report = analyzer.analyze(graph, fileNode.id);
+    console.log(JSON.stringify(report, null, 2));
+});
+program
+    .command('stats')
+    .description('Show graph statistics')
+    .argument('[path]', 'Project root path', '.')
+    .action((path) => {
+    let graph = loader.getGraph();
+    if (!graph)
+        graph = loader.loadCache(resolve(path));
+    if (!graph) {
+        graph = loader.analyze({ projectRoot: resolve(path) });
+    }
+    const stats = computeStats(graph);
+    console.log(JSON.stringify(stats, null, 2));
+});
+function getExporter(format) {
+    const exporters = {
+        json: new JsonExporter(),
+        dot: new DotExporter(),
+        graphml: new GraphMLExporter(),
+        cytoscape: new CytoscapeExporter(),
+        reactflow: new ReactFlowExporter(),
+        neo4j: new Neo4jExporter(),
+        mermaid: new MermaidExporter(),
+    };
+    const exporter = exporters[format];
+    if (!exporter) {
+        console.error(`Unknown format: ${format}. Available: ${Object.keys(exporters).join(', ')}`);
+        process.exit(1);
+    }
+    return exporter;
+}
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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