@dewtech/dare-cli 3.4.0 → 3.6.0

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

@@ -7,7 +7,7 @@
  *  - persist incrementally (or on close, when that's safer)
  *  - never throw on unknown ids — return `null` / empty arrays
  */
-import type { GraphNode, GraphEdge, NodeType, EdgeType, SearchResult, GraphStatistics } from './types.js';
+import type { GraphNode, GraphEdge, NodeType, EdgeType, SearchResult, GraphStatistics, TraverseOptions, TraverseResult, LocateOptions, LocateResult, CodeSymbolNode } from './types.js';
 export interface KnowledgeGraph {
     init(): Promise<void>;
     addNode(node: GraphNode): void;
@@ -19,6 +19,9 @@ export interface KnowledgeGraph {
     getEdges(nodeId: string, direction?: 'out' | 'in' | 'both'): GraphEdge[];
     getNodeDependencies(nodeId: string, depth?: number): GraphNode[];
     getStatistics(): GraphStatistics;
+    traverse(opts: TraverseOptions): TraverseResult;
+    locate(seedQuery: string, opts?: LocateOptions): LocateResult;
+    findByQualifiedName(qn: string): CodeSymbolNode | null;
     exportToJson(): {
         nodes: GraphNode[];
         edges: GraphEdge[];
@@ -27,7 +30,9 @@ export interface KnowledgeGraph {
         nodes: GraphNode[];
         edges: GraphEdge[];
     }): void;
-    close(): void;
+    /** Optional — Neo4j batches writes and flushes on demand. */
+    flush?(): Promise<void>;
+    close(): void | Promise<void>;
 }
-export type { NodeType, EdgeType, GraphNode, GraphEdge, SearchResult, GraphStatistics };
+export type { NodeType, EdgeType, GraphNode, GraphEdge, SearchResult, GraphStatistics, TraverseOptions, TraverseResult, LocateOptions, LocateResult, CodeSymbolNode, };
 //# sourceMappingURL=knowledge-graph.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/graphrag/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACzD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAC3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;IACzE,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAEjE,aAAa,IAAI,eAAe,CAAC;IAEjC,YAAY,IAAI;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAC3D,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAEvE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/graphrag/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACzD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAC3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;IACzE,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAEjE,aAAa,IAAI,eAAe,CAAC;IAEjC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAAC;IAChD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IAC9D,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAEvD,YAAY,IAAI;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAC3D,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAEvE,6DAA6D;IAC7D,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,GACf,CAAC"}

package/dist/graphrag/neo4j-graph.d.ts

@@ -1,40 +1,34 @@
 /**
  * Neo4jGraph — knowledge graph backend that talks to a Neo4j server via the
  * official HTTP API (`/db/{database}/tx/commit`).
- *
- * No external Node driver is pulled in — we use the global `fetch` available
- * in Node 18+ and Bolt is not required for our usage. This trades a bit of
- * latency for zero install footprint, which fits the DARE "single package"
- * goal.
- *
- * Activated by `dare-graph.yml`:
- *
- *   backend: neo4j
- *   neo4j:
- *     url: http://localhost:7474
- *     database: dare
- *     username: neo4j
- *     password: dare-secret
- *     # Or:
- *     # auth: bearer <token>
  */
 import type { KnowledgeGraph, GraphNode, GraphEdge, NodeType, SearchResult, GraphStatistics } from './knowledge-graph.js';
+import type { CodeSymbolNode, TraverseOptions, TraverseResult, LocateOptions, LocateResult } from './types.js';
+export declare class Neo4jQueryError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
 export interface Neo4jConfig {
     url: string;
     database?: string;
     username?: string;
     password?: string;
-    /** Optional pre-built Authorization header (overrides username/password). */
     auth?: string;
+    /** Must be true to use the neo4j backend (RF-09 experimental gate). */
+    experimental?: boolean;
 }
+export declare function parseNodeFromRecord(row: unknown[]): GraphNode;
+export declare function parseEdgeFromRecord(row: unknown[]): GraphEdge;
 export declare class Neo4jGraph implements KnowledgeGraph {
     private readonly config;
     private endpoint;
     private headers;
     private nodeCache;
     private edgeCache;
+    private pendingWrites;
     constructor(config: Neo4jConfig);
     init(): Promise<void>;
+    private hydrateFromServer;
     addNode(node: GraphNode): void;
     getNode(id: string): GraphNode | null;
     queryNodes(type?: NodeType, limit?: number): GraphNode[];
@@ -52,7 +46,14 @@ export declare class Neo4jGraph implements KnowledgeGraph {
         nodes: GraphNode[];
         edges: GraphEdge[];
     }): void;
-    close(): void;
+    traverse(opts: TraverseOptions): TraverseResult;
+    locate(seedQuery: string, opts?: LocateOptions): LocateResult;
+    findByQualifiedName(qn: string): CodeSymbolNode | null;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    private enqueue;
+    private runRead;
     private runMany;
+    private postCypher;
 }
 //# sourceMappingURL=neo4j-graph.d.ts.map

package/dist/graphrag/neo4j-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"neo4j-graph.d.ts","sourceRoot":"","sources":["../../src/graphrag/neo4j-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EAER,YAAY,EACZ,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,UAAW,YAAW,cAAc;IAMnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,SAAS,CAAgC;gBAEpB,MAAM,EAAE,WAAW;IAkB1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAuB9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIrC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,SAAK,GAAG,SAAS,EAAE;IAOpD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE;IAatD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAY5B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAqB9B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,KAAK,GAAG,IAAI,GAAG,MAAe,GAAG,SAAS,EAAE;IAQhF,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,SAAS,EAAE;IAmB3D,aAAa,IAAI,eAAe;IAiBhC,YAAY,IAAI;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE;IAO1D,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,IAAI;IAKtE,KAAK,IAAI,IAAI;YAMC,OAAO;CAmBtB"}
+{"version":3,"file":"neo4j-graph.d.ts","sourceRoot":"","sources":["../../src/graphrag/neo4j-graph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EAER,YAAY,EACZ,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAUpB,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAYD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,SAAS,CA8B7D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,SAAS,CA2B7D;AAED,qBAAa,UAAW,YAAW,cAAc;IAOnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,aAAa,CAA0B;gBAElB,MAAM,EAAE,WAAW;IAkB1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAQb,iBAAiB;IAoB/B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAqB9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIrC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,SAAK,GAAG,SAAS,EAAE;IAOpD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE;IAatD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAW5B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAmB9B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,KAAK,GAAG,IAAI,GAAG,MAAe,GAAG,SAAS,EAAE;IAQhF,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,SAAS,EAAE;IAmB3D,aAAa,IAAI,eAAe;IAahC,YAAY,IAAI;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE;IAO1D,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,IAAI;IAKtE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc;IAI/C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY;IAI7D,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAYhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,OAAO;YAUD,OAAO;YASP,OAAO;YAMP,UAAU;CAqBzB"}

package/dist/graphrag/neo4j-graph.js

@@ -1,8 +1,83 @@
+import { ALL_EDGE_TYPES, ALL_NODE_TYPES, emptyEdgesByType, emptyNodesByType, } from './types.js';
+import { traverse as traverseFn, locate as locateFn } from './traverse.js';
+const FLUSH_THRESHOLD = 500;
+export class Neo4jQueryError extends Error {
+    constructor(code, message) {
+        super(`Neo4j[${code}]: ${message}`);
+        this.code = code;
+        this.name = 'Neo4jQueryError';
+    }
+}
+const NODE_TYPES = new Set(ALL_NODE_TYPES);
+const EDGE_TYPES = new Set(ALL_EDGE_TYPES);
+export function parseNodeFromRecord(row) {
+    const [id, type, label, description, metadata, createdAt, updatedAt] = row;
+    if (typeof id !== 'string' || !id) {
+        throw new Neo4jQueryError('SHAPE', 'node id must be a non-empty string');
+    }
+    if (typeof type !== 'string' || !NODE_TYPES.has(type)) {
+        throw new Neo4jQueryError('SHAPE', `invalid node type: ${String(type)}`);
+    }
+    if (typeof label !== 'string' || !label) {
+        throw new Neo4jQueryError('SHAPE', 'node label must be a non-empty string');
+    }
+    let meta = {};
+    if (typeof metadata === 'string' && metadata) {
+        try {
+            meta = JSON.parse(metadata);
+        }
+        catch {
+            meta = {};
+        }
+    }
+    else if (metadata && typeof metadata === 'object') {
+        meta = metadata;
+    }
+    return {
+        id,
+        type: type,
+        label,
+        description: typeof description === 'string' ? description : undefined,
+        metadata: meta,
+        createdAt: typeof createdAt === 'string' ? createdAt : undefined,
+        updatedAt: typeof updatedAt === 'string' ? updatedAt : undefined,
+    };
+}
+export function parseEdgeFromRecord(row) {
+    const [id, sourceId, targetId, type, weight, metadata] = row;
+    if (typeof id !== 'string' || !id) {
+        throw new Neo4jQueryError('SHAPE', 'edge id must be a non-empty string');
+    }
+    if (typeof sourceId !== 'string' || typeof targetId !== 'string') {
+        throw new Neo4jQueryError('SHAPE', 'edge endpoints must be strings');
+    }
+    if (typeof type !== 'string' || !EDGE_TYPES.has(type)) {
+        throw new Neo4jQueryError('SHAPE', `invalid edge type: ${String(type)}`);
+    }
+    let meta = {};
+    if (typeof metadata === 'string' && metadata) {
+        try {
+            meta = JSON.parse(metadata);
+        }
+        catch {
+            meta = {};
+        }
+    }
+    return {
+        id,
+        sourceId,
+        targetId,
+        type: type,
+        weight: typeof weight === 'number' ? weight : 1,
+        metadata: meta,
+    };
+}
 export class Neo4jGraph {
     constructor(config) {
         this.config = config;
         this.nodeCache = new Map();
         this.edgeCache = new Map();
+        this.pendingWrites = [];
         if (!config.url) {
             throw new Error('Neo4jGraph: `url` is required.');
         }
@@ -21,13 +96,24 @@ export class Neo4jGraph {
         }
     }
     async init() {
-        // Verify connectivity + ensure indexes exist (idempotent).
         await this.runMany([
             { statement: 'CREATE CONSTRAINT dare_node_id IF NOT EXISTS FOR (n:DareNode) REQUIRE n.id IS UNIQUE' },
             { statement: 'CREATE INDEX dare_node_type IF NOT EXISTS FOR (n:DareNode) ON (n.type)' },
         ]);
+        await this.hydrateFromServer();
+    }
+    async hydrateFromServer() {
+        const nodeRows = await this.runRead('MATCH (n:DareNode) RETURN n.id, n.type, n.label, n.description, n.metadata, n.created_at, n.updated_at LIMIT $limit', { limit: 10000 });
+        for (const row of nodeRows) {
+            const node = parseNodeFromRecord(row);
+            this.nodeCache.set(node.id, node);
+        }
+        const edgeRows = await this.runRead('MATCH (s:DareNode)-[r:DARE_EDGE]->(t:DareNode) RETURN r.id, s.id, t.id, r.type, r.weight, r.metadata LIMIT $limit', { limit: 10000 });
+        for (const row of edgeRows) {
+            const edge = parseEdgeFromRecord(row);
+            this.edgeCache.set(edge.id, edge);
+        }
     }
-    // ─── Nodes ────────────────────────────────────────────────────────────────
     addNode(node) {
         const now = new Date().toISOString();
         const params = {
@@ -39,14 +125,12 @@ export class Neo4jGraph {
             createdAt: node.createdAt ?? now,
             updatedAt: now,
         };
-        void this.runMany([
-            {
-                statement: 'MERGE (n:DareNode {id:$id}) ' +
-                    'ON CREATE SET n.type=$type,n.label=$label,n.description=$description,n.metadata=$metadata,n.created_at=$createdAt,n.updated_at=$updatedAt ' +
-                    'ON MATCH SET n.label=$label,n.description=$description,n.metadata=$metadata,n.updated_at=$updatedAt',
-                parameters: params,
-            },
-        ]);
+        this.enqueue({
+            statement: 'MERGE (n:DareNode {id:$id}) ' +
+                'ON CREATE SET n.type=$type,n.label=$label,n.description=$description,n.metadata=$metadata,n.created_at=$createdAt,n.updated_at=$updatedAt ' +
+                'ON MATCH SET n.label=$label,n.description=$description,n.metadata=$metadata,n.updated_at=$updatedAt',
+            parameters: params,
+        });
         this.nodeCache.set(node.id, { ...node, createdAt: params.createdAt, updatedAt: params.updatedAt });
     }
     getNode(id) {
@@ -72,16 +156,16 @@ export class Neo4jGraph {
         return out;
     }
     deleteNode(id) {
-        void this.runMany([
-            { statement: 'MATCH (n:DareNode {id:$id}) DETACH DELETE n', parameters: { id } },
-        ]);
+        this.enqueue({
+            statement: 'MATCH (n:DareNode {id:$id}) DETACH DELETE n',
+            parameters: { id },
+        });
         this.nodeCache.delete(id);
         for (const [edgeId, e] of this.edgeCache) {
             if (e.sourceId === id || e.targetId === id)
                 this.edgeCache.delete(edgeId);
         }
     }
-    // ─── Edges ────────────────────────────────────────────────────────────────
     addEdge(edge) {
         const params = {
             id: edge.id,
@@ -91,14 +175,12 @@ export class Neo4jGraph {
             weight: edge.weight ?? 1,
             metadata: JSON.stringify(edge.metadata ?? {}),
         };
-        void this.runMany([
-            {
-                statement: 'MATCH (s:DareNode {id:$sourceId}),(t:DareNode {id:$targetId}) ' +
-                    'MERGE (s)-[r:DARE_EDGE {id:$id}]->(t) ' +
-                    'SET r.type=$type,r.weight=$weight,r.metadata=$metadata',
-                parameters: params,
-            },
-        ]);
+        this.enqueue({
+            statement: 'MATCH (s:DareNode {id:$sourceId}),(t:DareNode {id:$targetId}) ' +
+                'MERGE (s)-[r:DARE_EDGE {id:$id}]->(t) ' +
+                'SET r.type=$type,r.weight=$weight,r.metadata=$metadata',
+            parameters: params,
+        });
         this.edgeCache.set(edge.id, { ...edge, weight: params.weight, metadata: edge.metadata ?? {} });
     }
     getEdges(nodeId, direction = 'both') {
@@ -113,7 +195,7 @@ export class Neo4jGraph {
     getNodeDependencies(nodeId, depth = 3) {
         const visited = new Set();
         const out = [];
-        const traverse = (id, d) => {
+        const walk = (id, d) => {
             if (d === 0 || visited.has(id))
                 return;
             visited.add(id);
@@ -123,22 +205,20 @@ export class Neo4jGraph {
                 const target = this.nodeCache.get(e.targetId);
                 if (target) {
                     out.push(target);
-                    traverse(e.targetId, d - 1);
+                    walk(e.targetId, d - 1);
                 }
             }
         };
-        traverse(nodeId, depth);
+        walk(nodeId, depth);
         return out;
     }
     getStatistics() {
-        const nodesByType = {};
-        const edgesByType = {};
-        for (const n of this.nodeCache.values()) {
-            nodesByType[n.type] = (nodesByType[n.type] ?? 0) + 1;
-        }
-        for (const e of this.edgeCache.values()) {
-            edgesByType[e.type] = (edgesByType[e.type] ?? 0) + 1;
-        }
+        const nodesByType = emptyNodesByType();
+        const edgesByType = emptyEdgesByType();
+        for (const n of this.nodeCache.values())
+            nodesByType[n.type] += 1;
+        for (const e of this.edgeCache.values())
+            edgesByType[e.type] += 1;
         return {
             totalNodes: this.nodeCache.size,
             totalEdges: this.edgeCache.size,
@@ -158,11 +238,55 @@ export class Neo4jGraph {
         for (const e of data.edges)
             this.addEdge(e);
     }
-    close() {
-        // HTTP API has no persistent connection; cache is GC-collected on exit.
+    traverse(opts) {
+        return traverseFn(this, opts);
+    }
+    locate(seedQuery, opts) {
+        return locateFn(this, seedQuery, opts);
+    }
+    findByQualifiedName(qn) {
+        const normalized = qn.startsWith('code_symbol:') ? qn.slice('code_symbol:'.length) : qn;
+        const direct = this.nodeCache.get(`code_symbol:${normalized}`);
+        if (direct?.type === 'code_symbol')
+            return direct;
+        for (const node of this.nodeCache.values()) {
+            if (node.type === 'code_symbol' && node.metadata?.qualifiedName === normalized) {
+                return node;
+            }
+        }
+        return null;
+    }
+    async flush() {
+        if (this.pendingWrites.length === 0)
+            return;
+        const batch = this.pendingWrites;
+        this.pendingWrites = [];
+        try {
+            await this.runMany(batch);
+        }
+        catch (err) {
+            this.pendingWrites = batch.concat(this.pendingWrites);
+            throw err;
+        }
+    }
+    async close() {
+        await this.flush();
+    }
+    enqueue(stmt) {
+        this.pendingWrites.push(stmt);
+        if (this.pendingWrites.length > FLUSH_THRESHOLD) {
+            throw new Neo4jQueryError('QUEUE_OVERFLOW', `pending write queue exceeded ${FLUSH_THRESHOLD} statements — call flush() before adding more`);
+        }
+    }
+    async runRead(statement, parameters = {}) {
+        const payload = await this.postCypher([{ statement, parameters }]);
+        const rows = payload.results?.[0]?.data ?? [];
+        return rows.map((d) => d.row);
     }
-    // ─── Internal HTTP plumbing ──────────────────────────────────────────────
     async runMany(statements) {
+        await this.postCypher(statements);
+    }
+    async postCypher(statements) {
         const res = await fetch(this.endpoint, {
             method: 'POST',
             headers: this.headers,
@@ -170,12 +294,14 @@ export class Neo4jGraph {
         });
         if (!res.ok) {
             const body = await res.text().catch(() => '');
-            throw new Error(`Neo4j ${res.status} ${res.statusText}: ${body.slice(0, 200)}`);
+            throw new Neo4jQueryError(String(res.status), `${res.statusText}: ${body.slice(0, 200)}`);
         }
         const payload = (await res.json());
         if (payload.errors && payload.errors.length > 0) {
-            throw new Error(`Neo4j: ${payload.errors.map((e) => `${e.code} — ${e.message}`).join('; ')}`);
+            const first = payload.errors[0];
+            throw new Neo4jQueryError(first.code, first.message);
         }
+        return payload;
     }
 }
 function stripTrailingSlash(url) {

package/dist/graphrag/neo4j-graph.js.map

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

package/dist/graphrag/requirement-ingest.d.ts

@@ -0,0 +1,15 @@
+import type { KnowledgeGraph } from './knowledge-graph.js';
+import type { RequirementNode } from './types.js';
+export interface ParsedRequirement {
+    readonly reqId: string;
+    readonly title: string;
+    readonly priority?: 'MUST' | 'SHOULD' | 'COULD';
+    readonly parentId?: string;
+    readonly source: RequirementNode['source'];
+}
+export declare function parseRequirementsFromMarkdown(content: string, source: RequirementNode['source']): ParsedRequirement[];
+export declare function ingestRequirements(graph: KnowledgeGraph, projectRoot: string): {
+    nodes: number;
+    edges: number;
+};
+//# sourceMappingURL=requirement-ingest.d.ts.map

package/dist/graphrag/requirement-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-ingest.d.ts","sourceRoot":"","sources":["../../src/graphrag/requirement-ingest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;CAC5C;AAmBD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAChC,iBAAiB,EAAE,CA0ErB;AAiBD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA2DlC"}

package/dist/graphrag/requirement-ingest.js

@@ -0,0 +1,158 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const RF_RE = /^\|\s*(RF-\d+)\s*\|([^|]*)/;
+const O_RE = /^\|\s*(O-\d+)\s*\|([^|]*)/;
+const TASK_TABLE_RE = /^\|\s*(task-\d+)\s*\|([^|]*)/i;
+const TASK_HEADING_RE = /\btask-(\d+)\s*:/i;
+const PHASE_RE = /^###\s+(?:Phase|Fase)\s+(\d+)/i;
+const PRIORITY_RE = /\b(MUST|SHOULD|COULD)\b/i;
+function parsePriority(text) {
+    const m = PRIORITY_RE.exec(text);
+    if (!m)
+        return undefined;
+    return m[1].toUpperCase();
+}
+function cleanTitle(raw) {
+    return raw.replace(/\|/g, '').trim();
+}
+export function parseRequirementsFromMarkdown(content, source) {
+    const lines = content.split(/\r?\n/);
+    const out = [];
+    let currentParent;
+    for (const line of lines) {
+        const phase = PHASE_RE.exec(line);
+        if (phase) {
+            const phaseId = `phase-${phase[1]}`;
+            currentParent = phaseId;
+            out.push({
+                reqId: phaseId,
+                title: `Phase ${phase[1]}`,
+                source,
+                parentId: undefined,
+            });
+            continue;
+        }
+        let match = RF_RE.exec(line);
+        if (match) {
+            const title = cleanTitle(match[2] ?? '');
+            out.push({
+                reqId: match[1],
+                title,
+                priority: parsePriority(title),
+                parentId: currentParent,
+                source,
+            });
+            continue;
+        }
+        match = O_RE.exec(line);
+        if (match) {
+            const title = cleanTitle(match[2] ?? '');
+            out.push({
+                reqId: match[1],
+                title,
+                priority: parsePriority(title),
+                parentId: currentParent,
+                source,
+            });
+            continue;
+        }
+        match = TASK_TABLE_RE.exec(line);
+        if (match) {
+            const reqId = match[1].toLowerCase();
+            const title = cleanTitle(match[2] ?? reqId);
+            out.push({
+                reqId,
+                title,
+                priority: parsePriority(title),
+                parentId: currentParent,
+                source,
+            });
+            continue;
+        }
+        const taskHeading = TASK_HEADING_RE.exec(line);
+        if (taskHeading) {
+            const reqId = `task-${taskHeading[1]}`;
+            const title = line.replace(/^#+\s*/, '').trim();
+            out.push({
+                reqId,
+                title,
+                priority: parsePriority(title),
+                parentId: currentParent,
+                source,
+            });
+        }
+    }
+    return out;
+}
+function listMarkdownFiles(dir, prefix) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs
+        .readdirSync(dir)
+        .filter((f) => f.startsWith(prefix) && f.endsWith('.md'))
+        .map((f) => path.join(dir, f));
+}
+function sourceForFile(name) {
+    if (name.startsWith('DESIGN'))
+        return 'design';
+    if (name.startsWith('BLUEPRINT'))
+        return 'blueprint';
+    if (name.startsWith('TASKS'))
+        return 'tasks';
+    return null;
+}
+export function ingestRequirements(graph, projectRoot) {
+    const dareDir = path.join(projectRoot, 'DARE');
+    let nodes = 0;
+    let edges = 0;
+    const files = [];
+    for (const f of listMarkdownFiles(dareDir, 'DESIGN')) {
+        files.push({ file: f, source: 'design' });
+    }
+    for (const f of listMarkdownFiles(dareDir, 'BLUEPRINT')) {
+        files.push({ file: f, source: 'blueprint' });
+    }
+    for (const f of listMarkdownFiles(dareDir, 'TASKS')) {
+        files.push({ file: f, source: 'tasks' });
+    }
+    const parsed = [];
+    for (const { file, source } of files) {
+        const content = fs.readFileSync(file, 'utf-8');
+        parsed.push(...parseRequirementsFromMarkdown(content, source));
+    }
+    const seenNodes = new Set();
+    const seenEdges = new Set();
+    for (const req of parsed) {
+        const nodeId = `requirement:${req.reqId}`;
+        graph.addNode({
+            id: nodeId,
+            type: 'requirement',
+            label: req.title || req.reqId,
+            metadata: {
+                reqId: req.reqId,
+                source: req.source,
+                priority: req.priority,
+                title: req.title,
+            },
+        });
+        if (!seenNodes.has(nodeId)) {
+            seenNodes.add(nodeId);
+            nodes++;
+        }
+        if (req.parentId) {
+            const edgeId = `derives_from:${req.reqId}->${req.parentId}`;
+            graph.addEdge({
+                id: edgeId,
+                sourceId: nodeId,
+                targetId: `requirement:${req.parentId}`,
+                type: 'derives_from',
+            });
+            if (!seenEdges.has(edgeId)) {
+                seenEdges.add(edgeId);
+                edges++;
+            }
+        }
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=requirement-ingest.js.map

package/dist/graphrag/requirement-ingest.js.map

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

package/dist/graphrag/traverse.d.ts

@@ -0,0 +1,5 @@
+import type { KnowledgeGraph } from './knowledge-graph.js';
+import type { LocateOptions, LocateResult, TraverseOptions, TraverseResult } from './types.js';
+export declare function traverse(graph: KnowledgeGraph, opts: TraverseOptions): TraverseResult;
+export declare function locate(graph: KnowledgeGraph, seedQuery: string, opts?: LocateOptions): LocateResult;
+//# sourceMappingURL=traverse.d.ts.map

package/dist/graphrag/traverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../src/graphrag/traverse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAGV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AA4BpB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,GAAG,cAAc,CA+CrF;AAQD,wBAAgB,MAAM,CACpB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,aAAkB,GACvB,YAAY,CA2Ed"}