codestrate 0.6.1 → 0.6.3

package/dist/store/interface.d.ts

@@ -5,7 +5,35 @@
  * a lightweight fallback. All store operations go through this
  * interface so domain code never depends on a specific backend.
  */
-import type { RepoSnapshot, SymbolInfo, SymbolRelation, Experience, Memory, ValidationResult } from "../types.js";
+export interface GraphStats {
+    nodeCount: number;
+    edgeCount: number;
+    communityCount: number;
+    nodeKinds: Record<string, number>;
+    edgeKinds: Record<string, number>;
+    confidenceBreakdown: Record<string, number>;
+    maxDegree: number;
+    avgDegree: number;
+    unreferencedNodeCount: number;
+}
+export interface BfsOptions {
+    maxDepth?: number;
+    limit?: number;
+    edgeKinds?: string[];
+    nodeKinds?: string[];
+    direction?: "incoming" | "outgoing" | "both";
+}
+export interface SubgraphResult {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    stats: {
+        depth: number;
+        nodeCount: number;
+        edgeCount: number;
+        truncated: boolean;
+    };
+}
+import type { RepoSnapshot, SymbolInfo, SymbolRelation, Experience, Memory, ValidationResult, GraphNode, GraphEdge } from "../types.js";
 export interface Migration {
     version: number;
     name: string;
@@ -60,6 +88,47 @@ export interface ValidationResultStore {
     save(result: ValidationResult): void;
     getLatest(limit?: number): ValidationResult[];
 }
+export interface Store extends IndexStore, MemoryStore, ValidationResultStore {
+    open(): void;
+    close(): void;
+    isOpen(): boolean;
+    purge(repo?: string): void;
+    getCurrentVersion(): number;
+    migrate(targetVersion?: number): void;
+    vacuum(): void;
+    backup(destPath: string): void;
+    traverseBFS(nodeName: string, opts?: BfsOptions): SubgraphResult;
+    traverseBFSCallPath(startNode: string, endNode: string, opts?: BfsOptions): GraphEdge[] | null;
+    getGraphNodeByName(name: string): GraphNode | null;
+    /** Assign community IDs to graph nodes via connected-components analysis. */
+    computeCommunities(): number;
+    /** Return the top-N most-connected nodes (god nodes). */
+    getGodNodes(topN?: number): GraphNode[];
+    /** Return summary graph statistics. */
+    getGraphStats(): GraphStats;
+    /** Detect circular dependencies in the graph. Returns cycle chains. */
+    detectCycles(): Array<{
+        cycle: string[];
+        kind: string;
+        length: number;
+    }>;
+    /** Record a structured reflection about current session work. */
+    recordReflection(sessionId: string, goal: string, task: string, symbols?: string[], files?: string[]): void;
+    /** Get recent session reflections. */
+    getSessionReflections(sessionId?: string, limit?: number): Array<{
+        id: number;
+        sessionId: string;
+        goal: string;
+        task: string;
+        symbols: string;
+        files: string;
+        timestamp: string;
+    }>;
+    /** Search graph nodes by trigram for CJK support. */
+    searchGraphNodesTrigram(query: string, limit?: number): GraphNode[];
+    /** Search graph nodes via name_segment_vocab for fast partial match. */
+    searchGraphNodesBySegment(segment: string, limit?: number): GraphNode[];
+}
 export interface Store extends IndexStore, MemoryStore, ValidationResultStore {
     open(): void;
     close(): void;

package/dist/store/interface.d.ts.map

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

package/dist/store/service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Store Service — unified access layer over SQLiteStore.
+ *
+ * This is the production code path. JSON stores (`store/index.ts`,
+ * `store/memory.ts`) are kept for debug/export only.
+ *
+ * All read/write operations go through SQLite as the single
+ * source of truth, eliminating dual-write divergence.
+ */
+import type { SymbolInfo, SymbolRelation, RepoSnapshot, Experience, Memory, ValidationResult, GraphNode, GraphEdge } from "../types.js";
+import type { GraphStats } from "./interface.js";
+export declare function getSnapshot(): RepoSnapshot | null;
+export declare function getSymbols(): SymbolInfo[];
+export declare function getSymbol(name: string, file?: string): SymbolInfo | undefined;
+export declare function findSymbols(query: string): SymbolInfo[];
+export declare function findSymbol(name: string): SymbolInfo | undefined;
+export declare function getRelations(): SymbolRelation[];
+export declare function getRelationsForSymbol(symbol: string): SymbolRelation[];
+/**
+ * Find all callers of a symbol (incoming "calls" edges).
+ */
+export declare function findCallers(symbolName: string): SymbolRelation[];
+/**
+ * Find all callees of a symbol (outgoing "calls" edges).
+ */
+export declare function findCallees(symbolName: string): SymbolRelation[];
+export declare function searchGraphNodesFTS(query: string, limit?: number): GraphNode[];
+export declare function searchGraphNodesCamel(query: string, limit?: number): GraphNode[];
+export declare function findGraphPath(sourceName: string, targetName: string, maxDepth?: number): GraphEdge[] | null;
+export declare function traverseGraphBFS(nodeName: string, opts?: import("./interface.js").BfsOptions): import("./interface.js").SubgraphResult;
+export declare function findShortestPath(startNode: string, endNode: string, opts?: import("./interface.js").BfsOptions): GraphEdge[] | null;
+export declare function getGraphNodeByName(name: string): GraphNode | null;
+export declare function getGraphEdges(nodeName: string, direction?: "incoming" | "outgoing" | "both", kind?: string): GraphEdge[];
+export declare function getUnreferencedNodes(kinds?: string[], limit?: number): GraphNode[];
+export declare function populateGraph(symbols: SymbolInfo[], relations: SymbolRelation[]): void;
+export declare function computeGraphCommunities(): number;
+export declare function getGraphGodNodes(topN?: number): GraphNode[];
+export declare function getGraphStats(): GraphStats;
+export declare function getExperience(id: string): Experience | undefined;
+export declare function getAllExperiences(repo?: string): Experience[];
+export declare function getAllMemories(repo?: string): Memory[];
+export declare function updateQualityScore(id: string, delta: number): void;
+export declare function saveValidationResult(result: ValidationResult): void;
+export declare function getLatestValidationResults(limit?: number): ValidationResult[];
+export declare function openStore(): void;
+export declare function closeStore(): void;
+export declare function isStoreOpen(): boolean;
+export declare function vacuumStore(): void;
+//# sourceMappingURL=service.d.ts.map

package/dist/store/service.d.ts.map

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

package/dist/store/service.js

@@ -0,0 +1,147 @@
+/**
+ * Store Service — unified access layer over SQLiteStore.
+ *
+ * This is the production code path. JSON stores (`store/index.ts`,
+ * `store/memory.ts`) are kept for debug/export only.
+ *
+ * All read/write operations go through SQLite as the single
+ * source of truth, eliminating dual-write divergence.
+ */
+import { getStore } from "./sqlite.js";
+// ─── Repository snapshot ────────────────────────────────
+export function getSnapshot() {
+    return getStore().getSnapshot();
+}
+// ─── Symbol queries ─────────────────────────────────────
+export function getSymbols() {
+    return getStore().getSymbols();
+}
+export function getSymbol(name, file) {
+    return getStore().getSymbol(name, file) ?? undefined;
+}
+export function findSymbols(query) {
+    return getStore().searchSymbolsFTS(query);
+}
+export function findSymbol(name) {
+    const fromTable = getStore().getSymbol(name);
+    if (fromTable)
+        return fromTable;
+    // Graph fallback when symbols table and graph diverge mid-index or after partial load
+    const exact = getStore().getGraphNodeByName(name);
+    const node = exact ?? getStore().searchGraphNodes(name, 5).find((n) => n.name === name);
+    if (!node)
+        return undefined;
+    return {
+        name: node.name,
+        kind: node.kind || "unknown",
+        file: node.file,
+        line: node.line ?? 0,
+        column: node.column ?? 0,
+        signature: node.signature ?? "",
+        summary: node.signature ?? "",
+        imports: [],
+        calls: [],
+        calledBy: [],
+        relatedTests: [],
+        commitSha: "",
+        repoFingerprint: "",
+    };
+}
+// ─── Relation queries ──────────────────────────────────
+export function getRelations() {
+    return getStore().getRelations();
+}
+export function getRelationsForSymbol(symbol) {
+    return getStore().getRelationsForSymbol(symbol);
+}
+/**
+ * Find all callers of a symbol (incoming "calls" edges).
+ */
+export function findCallers(symbolName) {
+    return getStore().getRelationsForSymbol(symbolName).filter((r) => r.kind === "calls" && r.target === symbolName);
+}
+/**
+ * Find all callees of a symbol (outgoing "calls" edges).
+ */
+export function findCallees(symbolName) {
+    return getStore().getRelationsForSymbol(symbolName).filter((r) => r.kind === "calls" && r.source === symbolName);
+}
+// ─── Graph operations ──────────────────────────────────
+export function searchGraphNodesFTS(query, limit) {
+    return getStore().searchGraphNodesFTS(query, limit);
+}
+export function searchGraphNodesCamel(query, limit) {
+    return getStore().searchGraphNodesCamel(query, limit);
+}
+export function findGraphPath(sourceName, targetName, maxDepth) {
+    const sourceNode = getStore().searchGraphNodes(sourceName, 1);
+    const targetNode = getStore().searchGraphNodes(targetName, 1);
+    if (!sourceNode.length || !targetNode.length)
+        return null;
+    return getStore().findGraphPath(sourceNode[0].id, targetNode[0].id, maxDepth);
+}
+// ─── Graph traversal (BFS) ────────────────────────────
+export function traverseGraphBFS(nodeName, opts) {
+    return getStore().traverseBFS(nodeName, opts);
+}
+export function findShortestPath(startNode, endNode, opts) {
+    return getStore().traverseBFSCallPath(startNode, endNode, opts);
+}
+export function getGraphNodeByName(name) {
+    return getStore().getGraphNodeByName(name);
+}
+export function getGraphEdges(nodeName, direction, kind) {
+    const nodes = getStore().searchGraphNodes(nodeName, 1);
+    if (!nodes.length)
+        return [];
+    return getStore().getGraphEdges(nodes[0].id, direction, kind);
+}
+export function getUnreferencedNodes(kinds, limit) {
+    return getStore().getUnreferencedNodes(kinds, limit);
+}
+export function populateGraph(symbols, relations) {
+    getStore().populateGraph(symbols, relations);
+}
+export function computeGraphCommunities() {
+    return getStore().computeCommunities();
+}
+export function getGraphGodNodes(topN) {
+    return getStore().getGodNodes(topN);
+}
+export function getGraphStats() {
+    return getStore().getGraphStats();
+}
+// ─── Memory / Experience ───────────────────────────────
+export function getExperience(id) {
+    return getStore().getExperience(id) ?? undefined;
+}
+export function getAllExperiences(repo) {
+    return getStore().getAllExperiences(repo);
+}
+export function getAllMemories(repo) {
+    return getStore().getAllMemories(repo);
+}
+export function updateQualityScore(id, delta) {
+    getStore().updateQualityScore(id, delta);
+}
+// ─── Validation ────────────────────────────────────────
+export function saveValidationResult(result) {
+    getStore().save(result);
+}
+export function getLatestValidationResults(limit) {
+    return getStore().getLatest(limit);
+}
+// ─── Store lifecycle ───────────────────────────────────
+export function openStore() {
+    getStore().open();
+}
+export function closeStore() {
+    getStore().close();
+}
+export function isStoreOpen() {
+    return getStore().isOpen();
+}
+export function vacuumStore() {
+    getStore().vacuum();
+}
+//# sourceMappingURL=service.js.map

package/dist/store/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/store/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgBvC,2DAA2D;AAE3D,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,2DAA2D;AAE3D,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,EAAE,CAAC,UAAU,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAa;IACnD,OAAO,QAAQ,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,QAAQ,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhC,sFAAsF;IACtF,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACxF,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAG,IAAI,CAAC,IAA2B,IAAI,SAAS;QACpD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;QAC/B,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;QAC7B,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;QACb,eAAe,EAAE,EAAE;KACpB,CAAC;AACJ,CAAC;AAED,0DAA0D;AAE1D,MAAM,UAAU,YAAY;IAC1B,OAAO,QAAQ,EAAE,CAAC,YAAY,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,QAAQ,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,OAAO,QAAQ,EAAE,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,MAAM,CACxD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,OAAO,QAAQ,EAAE,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,MAAM,CACxD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CACrD,CAAC;AACJ,CAAC;AAED,0DAA0D;AAE1D,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAc;IAC/D,OAAO,QAAQ,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,KAAc;IACjE,OAAO,QAAQ,EAAE,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,UAAkB,EAClB,QAAiB;IAEjB,MAAM,UAAU,GAAG,QAAQ,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,QAAQ,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,QAAQ,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChF,CAAC;AAED,yDAAyD;AAEzD,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,IAA0C;IAC3F,OAAO,QAAQ,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,OAAe,EAAE,IAA0C;IAC7G,OAAO,QAAQ,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,QAAQ,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,SAA4C,EAC5C,IAAa;IAEb,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAC7B,OAAO,QAAQ,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAgB,EAAE,KAAc;IACnE,OAAO,QAAQ,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAqB,EAAE,SAA2B;IAC9E,QAAQ,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,QAAQ,EAAE,CAAC,kBAAkB,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,QAAQ,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,QAAQ,EAAE,CAAC,aAAa,EAAE,CAAC;AACpC,CAAC;AAED,0DAA0D;AAE1D,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,QAAQ,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,QAAQ,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,KAAa;IAC1D,QAAQ,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,0DAA0D;AAE1D,MAAM,UAAU,oBAAoB,CAAC,MAAwB;IAC3D,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,QAAQ,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,0DAA0D;AAE1D,MAAM,UAAU,SAAS;IACvB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;AACtB,CAAC"}

package/dist/store/sqlite.d.ts

@@ -6,7 +6,7 @@
  *
  * @module store/sqlite
  */
-import { type Store } from "./interface.js";
+import { type Store, type BfsOptions, type SubgraphResult, type GraphStats } from "./interface.js";
 import type { RepoSnapshot, SymbolInfo, SymbolRelation, Experience, Memory, ValidationResult, GraphNode, GraphEdge } from "../types.js";
 export declare class SQLiteStore implements Store {
     private db;
@@ -41,7 +41,7 @@ export declare class SQLiteStore implements Store {
     populateGraph(symbols: SymbolInfo[], relations: SymbolRelation[]): void;
     /** Get a graph node by ID. */
     getGraphNode(id: number): GraphNode | null;
-    /** Get edges for a graph node. */
+    /** Get edges for a graph node — single query with OR for direction="both". */
     getGraphEdges(nodeId: number, direction?: "incoming" | "outgoing" | "both", kind?: string): GraphEdge[];
     /** Search graph nodes by name (LIKE fallback). */
     searchGraphNodes(query: string, limit?: number): GraphNode[];
@@ -51,10 +51,20 @@ export declare class SQLiteStore implements Store {
     searchGraphNodesCamel(query: string, limit?: number): GraphNode[];
     /** Find nodes with zero incoming edges — potential dead code. */
     getUnreferencedNodes(kinds?: string[], limit?: number): GraphNode[];
-    /** Find a path between two graph nodes using BFS. */
+    /** Find a path between two graph nodes using BFS — pre-loads all edges for O(1) traversal. */
     findGraphPath(fromNodeId: number, toNodeId: number, maxDepth?: number): GraphEdge[] | null;
     /** Remove graph entries for a file (cascade via FK — foreign_keys must be ON). */
     removeGraphForFile(file: string): void;
+    /**
+     * Find test files related to a source file by naming convention.
+     * Tests are found by matching `<name>.test.<ext>`, `<name>.spec.<ext>`,
+     * or `test/<name>.<ext>` patterns against the source file's basename.
+     */
+    findRelatedTests(filePath: string): string[];
+    /**
+     * Find files in a scope (directory prefix match).
+     */
+    findFilesInScope(scope: string): string[];
     /** Clear all graph data. */
     clearGraph(): void;
     getRelations(): SymbolRelation[];
@@ -89,6 +99,61 @@ export declare class SQLiteStore implements Store {
     private rowToSymbol;
     private rowToExperience;
     private rowToMemory;
+    /**
+     * Look up a graph node by name.
+     * Returns the first matching node if multiple exist.
+     */
+    getGraphNodeByName(name: string): GraphNode | null;
+    /**
+     * BFS traversal from a named graph node using a recursive CTE.
+     * Returns a SubgraphResult with all reachable nodes, edges, and stats.
+     *
+     * The recursive CTE handles cycle detection via a visited-set path column,
+     * so a diamond pattern is traversed exactly once per node.
+     */
+    traverseBFS(nodeName: string, opts?: BfsOptions): SubgraphResult;
+    /**
+     * Find the shortest directed path between two named graph nodes.
+     * Uses a bidirectional BFS strategy: a recursive CTE anchored at the start
+     * searches for the end node, tracking paths.
+     *
+     * Returns the sequence of edges forming the path, or null if unreachable.
+     */
+    traverseBFSCallPath(startNode: string, endNode: string, opts?: BfsOptions): GraphEdge[] | null;
+    /**
+     * Assign community IDs to graph nodes via connected-components analysis.
+     * Uses Union-Find (DSU) with path compression, O(n α(n)) time.
+     * Each connected component gets the minimum node ID as its community value.
+     * Returns the number of communities found.
+     */
+    computeCommunities(): number;
+    /**
+     * Return the top-N most-connected graph nodes (god nodes).
+     */
+    getGodNodes(topN?: number): GraphNode[];
+    /**
+     * Return summary graph statistics.
+     */
+    getGraphStats(): GraphStats;
+    detectCycles(): Array<{
+        cycle: string[];
+        kind: string;
+        length: number;
+    }>;
+    /** Batch-resolve node IDs to names — one query instead of N. */
+    private resolveNodeNames;
+    searchGraphNodesTrigram(query: string, limit?: number): GraphNode[];
+    searchGraphNodesBySegment(segment: string, limit?: number): GraphNode[];
+    recordReflection(sessionId: string, goal: string, task: string, symbols?: string[], files?: string[]): void;
+    getSessionReflections(sessionId?: string, limit?: number): Array<{
+        id: number;
+        sessionId: string;
+        goal: string;
+        task: string;
+        symbols: string;
+        files: string;
+        timestamp: string;
+    }>;
 }
 export declare function getStore(dbPath?: string): SQLiteStore;
 export declare function closeStore(): void;

package/dist/store/sqlite.d.ts.map

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