kirograph 0.12.1

package/dist/db/database.d.ts

@@ -0,0 +1,133 @@
+/**
+ * KiroGraph Database Layer
+ * Wraps node-sqlite3-wasm for portability (no native bindings needed).
+ */
+import type { Node, Edge, FileRecord, NodeKind, GraphStats, NodeContext, NodeMetrics, SearchOptions } from '../types';
+import type { ArchPackage, ArchLayer, ArchPackageDep, ArchLayerDep, ArchCoupling } from '../architecture/types';
+export declare class GraphDatabase {
+    private db;
+    private projectRoot;
+    constructor(projectRoot: string);
+    private applySchema;
+    private runMigrations;
+    upsertFile(record: FileRecord): void;
+    getFile(filePath: string): FileRecord | null;
+    getAllFiles(): FileRecord[];
+    deleteFile(filePath: string): void;
+    private rowToFile;
+    upsertNode(node: Node): void;
+    getNode(id: string): Node | null;
+    getNodesByFile(filePath: string): Node[];
+    getNodesByKind(kind: Node['kind']): Node[];
+    findNodesByExactName(name: string, kinds?: NodeKind[], limit?: number): Node[];
+    searchNodes(query: string, opts?: SearchOptions): Node[];
+    searchNodesByName(name: string, opts?: SearchOptions): Node[];
+    deleteNodesByFile(filePath: string): void;
+    private rowToNode;
+    insertEdge(edge: Edge): void;
+    getCallers(nodeId: string, limit?: number): Node[];
+    getCallees(nodeId: string, limit?: number): Node[];
+    getImpactRadius(nodeId: string, depth?: number): Node[];
+    getEdgesForNodes(nodeIds: string[]): Edge[];
+    /**
+     * Find files that import (depend on) the given file path.
+     * Used for affected-test traversal.
+     */
+    getDependentFiles(filePath: string): string[];
+    insertUnresolvedRef(sourceId: string, refName: string, refKind: string, filePath: string, line?: number, column?: number): void;
+    deleteUnresolvedRefsByFile(filePath: string): void;
+    /**
+     * Resolve pending references:
+     * - refKind='function': 3-strategy name matching → 'calls' edge
+     * - refKind='import': path-based resolution → 'imports' edge
+     *
+     * Returns the number of edges successfully created.
+     */
+    resolveUnresolvedRefs(): number;
+    /** @deprecated Use resolveUnresolvedRefs() */
+    resolveCallEdges(): number;
+    /**
+     * Resolve a module import path to the ID of the first node in the target file.
+     * Returns null if no indexed file matches.
+     */
+    private resolveImportPath;
+    getNodeContext(nodeId: string): NodeContext | null;
+    getNodeMetrics(nodeId: string): NodeMetrics;
+    /**
+     * Find symbols with no incoming edges (potential dead code).
+     * Excludes exported symbols since they may be consumed externally.
+     */
+    findDeadCode(limit?: number): Node[];
+    /**
+     * Find circular import dependencies using DFS over import edges.
+     * Returns arrays of file paths forming cycles.
+     */
+    findCircularDependencies(): string[][];
+    /**
+     * Find the shortest path between two nodes via directed BFS (outgoing edges only).
+     */
+    findPath(fromId: string, toId: string, maxDepth?: number): Node[];
+    /**
+     * Traverse type hierarchy via 'extends' and 'implements' edges.
+     * direction 'up' = base types, 'down' = derived types, 'both' = all.
+     */
+    getTypeHierarchy(nodeId: string, direction?: 'up' | 'down' | 'both'): Node[];
+    getEmbeddingCount(): number;
+    storeEmbedding(nodeId: string, embedding: Float32Array, model: string): void;
+    getEmbeddedNodeIds(): string[];
+    getAllEmbeddings(): Array<{
+        nodeId: string;
+        embedding: Float32Array;
+    }>;
+    getAllNodes(): import('../types').Node[];
+    getStats(): GraphStats;
+    clearArchitecture(): void;
+    upsertArchPackage(pkg: ArchPackage): void;
+    upsertArchLayer(layer: ArchLayer): void;
+    upsertArchFilePackage(filePath: string, packageId: string): void;
+    upsertArchFileLayer(filePath: string, layerId: string, confidence: number, matchedPattern: string): void;
+    upsertArchPackageDep(sourcePkg: string, targetPkg: string, depCount: number, files?: Array<{
+        from: string;
+        to: string;
+    }>): void;
+    upsertArchLayerDep(sourceLayer: string, targetLayer: string, depCount: number): void;
+    upsertArchCoupling(coupling: ArchCoupling): void;
+    getArchPackages(): ArchPackage[];
+    getArchLayers(): ArchLayer[];
+    getArchPackageDeps(): ArchPackageDep[];
+    getArchLayerDeps(): ArchLayerDep[];
+    getArchCoupling(): ArchCoupling[];
+    getArchStats(): {
+        packages: number;
+        layers: number;
+        packageDeps: number;
+    };
+    /**
+     * Return file-to-file import relationships by joining edges + nodes.
+     * Used by ArchitectureAnalyzer to roll up package-level dependencies.
+     */
+    getFileImportPairs(): Array<{
+        sourceFile: string;
+        targetFile: string;
+    }>;
+    getArchFilePackages(): Array<{
+        filePath: string;
+        packageId: string;
+    }>;
+    getArchFileLayers(): Array<{
+        filePath: string;
+        layerId: string;
+        confidence: number;
+        matchedPattern: string;
+    }>;
+    getArchitectureResult(): {
+        packages: ArchPackage[];
+        layers: ArchLayer[];
+        packageDeps: ArchPackageDep[];
+        layerDeps: ArchLayerDep[];
+        coupling: ArchCoupling[];
+    };
+    transaction<T>(fn: () => T): T;
+    close(): void;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/db/database.d.ts.map

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