ai-mind-map 1.1.0

package/dist/knowledge-graph/cypher.d.ts

@@ -0,0 +1,113 @@
+/**
+ * AI Mind Map — Mini Cypher Query Parser & Executor
+ *
+ * A read-only openCypher subset that compiles Cypher queries into SQL
+ * targeting the knowledge graph's `nodes` and `edges` tables in SQLite.
+ *
+ * Inspired by codebase-memory-mcp's Cypher-like query interface.
+ *
+ * Supported Cypher syntax:
+ *   MATCH (f:Function) RETURN f.name LIMIT 10
+ *   MATCH (f:Function)-[:CALLS]->(g:Function) WHERE f.name = 'auth' RETURN f.name, g.name
+ *   MATCH (f:Function) WHERE f.filePath CONTAINS 'auth' RETURN f.name, f.signature
+ *   MATCH (f:Function) WHERE NOT EXISTS { (f)<-[:CALLS]-() } RETURN f.name
+ */
+import type { KnowledgeGraph } from './graph.js';
+/** The result of executing a Cypher query */
+export interface CypherResult {
+    /** Column names in the result set */
+    columns: string[];
+    /** Array of row objects keyed by column name */
+    rows: Record<string, unknown>[];
+    /** Total number of rows returned */
+    count: number;
+    /** The SQL query that was generated (for debugging) */
+    generatedSql: string;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+}
+/**
+ * Mini Cypher query engine that compiles Cypher queries into SQL
+ * and executes them against the knowledge graph's SQLite database.
+ *
+ * This is a read-only engine — no CREATE, MERGE, SET, or DELETE.
+ *
+ * @example
+ * ```ts
+ * const engine = new CypherEngine(db);
+ * const result = engine.execute("MATCH (f:Function) RETURN f.name LIMIT 10");
+ * console.log(result.rows);
+ * ```
+ */
+export declare class CypherEngine {
+    private db;
+    /**
+     * Create a new CypherEngine.
+     *
+     * @param graph - A KnowledgeGraph instance (the DB is extracted via graph.getDb())
+     */
+    constructor(graph: KnowledgeGraph);
+    /**
+     * Execute a Cypher query and return the results.
+     *
+     * @param query - A Cypher query string (read-only subset)
+     * @param projectFilter - Optional project path to scope results by filePath
+     * @returns The query result with columns, rows, and metadata
+     * @throws {CypherSyntaxError} If the query has a syntax error
+     * @throws {CypherExecutionError} If the query fails during execution
+     */
+    execute(query: string, projectFilter?: string): CypherResult;
+    /**
+     * Inject a filePath filter into the AST's WHERE clause to scope results to a project path.
+     */
+    private injectProjectFilter;
+    /**
+     * Compile a CypherAST into a SQL query string, bound parameters, and column list.
+     */
+    private compileToSql;
+    /**
+     * Compile a WHERE expression into a SQL fragment, appending bound params.
+     */
+    private compileWhereExpr;
+    /**
+     * Compile a comparison expression into SQL.
+     */
+    private compileComparison;
+    /**
+     * Compile a NOT EXISTS pattern into a SQL NOT EXISTS subquery.
+     */
+    private compileNotExists;
+    /**
+     * Resolve a property reference to a SQL column expression.
+     */
+    private resolvePropertyRef;
+    /**
+     * Resolve a Cypher node label to the internal node type string.
+     */
+    private resolveNodeLabel;
+    /**
+     * Resolve a Cypher edge type label to the internal edge type string.
+     */
+    private resolveEdgeType;
+    /**
+     * Convert a Cypher literal to a SQL-safe value.
+     */
+    private toLiteralSqlValue;
+}
+/**
+ * Syntax error in a Cypher query string.
+ */
+export declare class CypherSyntaxError extends Error {
+    /** Character position where the error occurred */
+    readonly position: number;
+    constructor(message: string, position: number);
+}
+/**
+ * Runtime error during Cypher query execution.
+ */
+export declare class CypherExecutionError extends Error {
+    /** The original Cypher query that caused the error */
+    readonly query: string;
+    constructor(message: string, query: string);
+}
+//# sourceMappingURL=cypher.d.ts.map

package/dist/knowledge-graph/cypher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypher.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/cypher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;CACzB;AAs1BD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;IAE9B;;;;OAIG;gBACS,KAAK,EAAE,cAAc;IAIjC;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY;IAwC5D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IA2IpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAI1B;AAMD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAK9C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAK3C"}