@mcp-graph-workflow/mcp-graph 3.0.0

package/dist/core/store/sqlite-store.d.ts

@@ -0,0 +1,86 @@
+import Database from "better-sqlite3";
+import type { GraphDocument, GraphNode, GraphEdge, GraphProject, NodeType, NodeStatus } from "../graph/graph-types.js";
+export declare class SqliteStore {
+    private db;
+    private projectId;
+    private _eventBus;
+    private constructor();
+    /** Attach an event bus to emit mutation events */
+    set eventBus(bus: import("../events/event-bus.js").GraphEventBus | null);
+    get eventBus(): import("../events/event-bus.js").GraphEventBus | null;
+    /**
+     * Open (or create) a store at basePath/workflow-graph/graph.db.
+     * Pass ":memory:" for in-memory testing.
+     *
+     * Handles automatic migration from legacy `.mcp-graph/` directory:
+     * - If only `.mcp-graph/` exists → rename to `workflow-graph/`
+     * - If both exist → use `workflow-graph/`, log warning
+     * - If neither → create `workflow-graph/`
+     */
+    static open(basePath?: string): SqliteStore;
+    /** Expose the raw database instance for extension modules (e.g. DocsCacheStore). */
+    getDb(): Database.Database;
+    close(): void;
+    initProject(name?: string): GraphProject;
+    getProject(): GraphProject | null;
+    /** Alias for getProject — returns the currently active project. */
+    getActiveProject(): GraphProject | null;
+    /** List all projects in the database. */
+    listProjects(): GraphProject[];
+    /** Switch the active project. Throws if project ID does not exist. */
+    activateProject(projectId: string): void;
+    private ensureProject;
+    insertNode(node: GraphNode): void;
+    getNodeById(id: string): GraphNode | null;
+    getAllNodes(): GraphNode[];
+    getNodesByType(type: NodeType): GraphNode[];
+    getNodesByStatus(status: NodeStatus): GraphNode[];
+    getChildNodes(parentId: string): GraphNode[];
+    updateNodeStatus(id: string, status: NodeStatus): GraphNode | null;
+    updateNode(id: string, fields: Partial<Pick<GraphNode, "title" | "description" | "type" | "priority" | "xpSize" | "estimateMinutes" | "tags" | "parentId" | "sprint" | "blocked" | "acceptanceCriteria" | "metadata">>): GraphNode | null;
+    deleteNode(id: string): boolean;
+    deleteEdge(id: string): boolean;
+    insertEdge(edge: GraphEdge): void;
+    getEdgesFrom(nodeId: string): GraphEdge[];
+    getEdgesTo(nodeId: string): GraphEdge[];
+    getAllEdges(): GraphEdge[];
+    /**
+     * Check if a source file has been previously imported.
+     */
+    hasImport(sourceFile: string): boolean;
+    /**
+     * Delete all nodes (and their edges) that were imported from a specific source file.
+     * Also removes the import history entry so re-import is clean.
+     */
+    clearImportedNodes(sourceFile: string): {
+        nodesDeleted: number;
+        edgesDeleted: number;
+    };
+    bulkInsert(nodes: GraphNode[], edges: GraphEdge[]): void;
+    createSnapshot(): number;
+    recordImport(sourceFile: string, nodesCreated: number, edgesCreated: number): void;
+    getStats(): {
+        totalNodes: number;
+        totalEdges: number;
+        byType: Record<string, number>;
+        byStatus: Record<string, number>;
+    };
+    /**
+     * Search nodes using FTS5 with BM25 ranking.
+     * Returns nodes ordered by relevance score.
+     */
+    searchNodes(query: string, limit?: number): Array<GraphNode & {
+        score: number;
+    }>;
+    bulkUpdateStatus(ids: string[], status: NodeStatus): {
+        updated: string[];
+        notFound: string[];
+    };
+    restoreSnapshot(snapshotId: number): void;
+    listSnapshots(): Array<{
+        snapshotId: number;
+        createdAt: string;
+    }>;
+    toGraphDocument(): GraphDocument;
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

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

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