@grafema/core 0.1.0-alpha.5 → 0.2.0-beta

package/dist/schema/InterfaceSchemaExtractor.d.ts

@@ -0,0 +1,73 @@
+/**
+ * InterfaceSchemaExtractor - Extracts interface schemas from graph
+ *
+ * Usage:
+ *   const extractor = new InterfaceSchemaExtractor(backend);
+ *   const schema = await extractor.extract('ConfigSchema');
+ *
+ * When to use:
+ *   - Export interface contracts for documentation
+ *   - Track interface changes via checksum
+ *   - Generate API documentation from graph
+ */
+import type { RFDBServerBackend } from '../storage/backends/RFDBServerBackend.js';
+export interface PropertySchema {
+    type: string;
+    required: boolean;
+    readonly: boolean;
+}
+export interface InterfaceSchema {
+    $schema: 'grafema-interface-v1';
+    name: string;
+    source: {
+        file: string;
+        line: number;
+        column: number;
+    };
+    typeParameters?: string[];
+    properties: Record<string, PropertySchema>;
+    extends: string[];
+    checksum: string;
+}
+export interface ExtractOptions {
+    /** Specific file path if multiple interfaces have same name */
+    file?: string;
+}
+export interface InterfaceNodeRecord {
+    id: string;
+    type: 'INTERFACE';
+    name: string;
+    file: string;
+    line: number;
+    column: number;
+    extends: string[];
+    properties: Array<{
+        name: string;
+        type?: string;
+        optional?: boolean;
+        readonly?: boolean;
+    }>;
+    typeParameters?: string[];
+}
+export declare class InterfaceSchemaExtractor {
+    private backend;
+    constructor(backend: RFDBServerBackend);
+    /**
+     * Extract schema for interface by name
+     *
+     * @param interfaceName - Name of the interface (e.g., 'ConfigSchema')
+     * @param options - Optional filters
+     * @returns InterfaceSchema or null if not found
+     * @throws Error if multiple interfaces match and no file specified
+     */
+    extract(interfaceName: string, options?: ExtractOptions): Promise<InterfaceSchema | null>;
+    /**
+     * Find all interfaces with given name
+     */
+    findInterfaces(name: string): Promise<InterfaceNodeRecord[]>;
+    /**
+     * Build InterfaceSchema from node record
+     */
+    private buildSchema;
+}
+//# sourceMappingURL=InterfaceSchemaExtractor.d.ts.map

package/dist/schema/InterfaceSchemaExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterfaceSchemaExtractor.d.ts","sourceRoot":"","sources":["../../src/schema/InterfaceSchemaExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAMlF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,sBAAsB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD,qBAAa,wBAAwB;IACvB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,iBAAiB;IAE9C;;;;;;;OAOG;IACG,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA6B/F;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAYlE;;OAEG;IACH,OAAO,CAAC,WAAW;CAgDpB"}

package/dist/schema/InterfaceSchemaExtractor.js

@@ -0,0 +1,112 @@
+/**
+ * InterfaceSchemaExtractor - Extracts interface schemas from graph
+ *
+ * Usage:
+ *   const extractor = new InterfaceSchemaExtractor(backend);
+ *   const schema = await extractor.extract('ConfigSchema');
+ *
+ * When to use:
+ *   - Export interface contracts for documentation
+ *   - Track interface changes via checksum
+ *   - Generate API documentation from graph
+ */
+import { createHash } from 'crypto';
+// ============================================================================
+// Extractor
+// ============================================================================
+export class InterfaceSchemaExtractor {
+    backend;
+    constructor(backend) {
+        this.backend = backend;
+    }
+    /**
+     * Extract schema for interface by name
+     *
+     * @param interfaceName - Name of the interface (e.g., 'ConfigSchema')
+     * @param options - Optional filters
+     * @returns InterfaceSchema or null if not found
+     * @throws Error if multiple interfaces match and no file specified
+     */
+    async extract(interfaceName, options) {
+        const interfaces = await this.findInterfaces(interfaceName);
+        if (interfaces.length === 0) {
+            return null;
+        }
+        // Filter by file if specified
+        let match;
+        if (options?.file) {
+            const fileFilter = options.file;
+            const filtered = interfaces.filter(i => i.file === fileFilter || i.file.endsWith(fileFilter));
+            if (filtered.length === 0) {
+                return null;
+            }
+            match = filtered[0];
+        }
+        else if (interfaces.length > 1) {
+            const locations = interfaces.map(i => `  - ${i.file}:${i.line}`).join('\n');
+            throw new Error(`Multiple interfaces named "${interfaceName}" found:\n${locations}\n` +
+                `Use --file option to specify which one.`);
+        }
+        else {
+            match = interfaces[0];
+        }
+        return this.buildSchema(match);
+    }
+    /**
+     * Find all interfaces with given name
+     */
+    async findInterfaces(name) {
+        const result = [];
+        for await (const node of this.backend.queryNodes({ nodeType: 'INTERFACE' })) {
+            if (node.name === name) {
+                result.push(node);
+            }
+        }
+        return result;
+    }
+    /**
+     * Build InterfaceSchema from node record
+     */
+    buildSchema(node) {
+        // Sort properties alphabetically for deterministic output
+        const sortedProperties = [...(node.properties || [])].sort((a, b) => a.name.localeCompare(b.name));
+        const properties = {};
+        for (const prop of sortedProperties) {
+            properties[prop.name] = {
+                type: prop.type || 'unknown',
+                required: !prop.optional,
+                readonly: prop.readonly || false
+            };
+        }
+        // Compute checksum from normalized content
+        const checksumContent = {
+            name: node.name,
+            properties: sortedProperties.map(p => ({
+                name: p.name,
+                type: p.type,
+                optional: p.optional,
+                readonly: p.readonly
+            })),
+            extends: [...(node.extends || [])].sort(),
+            typeParameters: node.typeParameters
+        };
+        const checksum = createHash('sha256')
+            .update(JSON.stringify(checksumContent))
+            .digest('hex');
+        return {
+            $schema: 'grafema-interface-v1',
+            name: node.name,
+            source: {
+                file: node.file,
+                line: node.line,
+                column: node.column
+            },
+            ...(node.typeParameters && node.typeParameters.length > 0 && {
+                typeParameters: node.typeParameters
+            }),
+            properties,
+            extends: node.extends || [],
+            checksum: `sha256:${checksum}`
+        };
+    }
+}

package/dist/schema/index.d.ts

@@ -0,0 +1,5 @@
+export { InterfaceSchemaExtractor } from './InterfaceSchemaExtractor.js';
+export type { InterfaceSchema, PropertySchema, ExtractOptions } from './InterfaceSchemaExtractor.js';
+export { GraphSchemaExtractor } from './GraphSchemaExtractor.js';
+export type { GraphSchema, NodeTypeSchema, EdgeTypeSchema, GraphExtractOptions } from './GraphSchemaExtractor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAErG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,2 @@
+export { InterfaceSchemaExtractor } from './InterfaceSchemaExtractor.js';
+export { GraphSchemaExtractor } from './GraphSchemaExtractor.js';

package/dist/storage/backends/RFDBServerBackend.d.ts

@@ -18,6 +18,7 @@
  *   await backend.flush();
  */
 import type { NodeType, EdgeType } from '@grafema/types';
+import type { BaseNodeRecord, EdgeRecord } from '@grafema/types';
 import type { AttrQuery, GraphStats, GraphExport } from '../../core/GraphBackend.js';
 /**
  * Options for RFDBServerBackend
@@ -26,28 +27,6 @@ export interface RFDBServerBackendOptions {
     socketPath?: string;
     dbPath?: string;
 }
-/**
- * Node as returned from the backend
- */
-export interface BackendNode {
-    id: string;
-    type: string;
-    nodeType: string;
-    name: string;
-    file: string;
-    exported: boolean;
-    [key: string]: unknown;
-}
-/**
- * Edge as returned from the backend
- */
-export interface BackendEdge {
-    src: string;
-    dst: string;
-    type: string;
-    edgeType: string;
-    [key: string]: unknown;
-}
 /**
  * Input node format (flexible)
  */
@@ -108,9 +87,9 @@ export declare class RFDBServerBackend {
     initialize(): Promise<void>;
     /**
      * Find RFDB server binary in order of preference:
-     * 1. @grafema/rfdb npm package
-     * 2. rust-engine/target/release (monorepo development)
-     * 3. rust-engine/target/debug
+     * 1. packages/rfdb-server/target/release (monorepo development - prioritized for dev)
+     * 2. packages/rfdb-server/target/debug
+     * 3. @grafema/rfdb npm package (fallback for production)
      */
     private _findServerBinary;
     /**
@@ -118,7 +97,7 @@ export declare class RFDBServerBackend {
      */
     private _startServer;
     /**
-     * Close connection and stop server if we started it
+     * Close client connection. Server continues running to serve other clients.
      */
     close(): Promise<void>;
     /**
@@ -148,7 +127,7 @@ export declare class RFDBServerBackend {
     /**
      * Get a node by ID
      */
-    getNode(id: string): Promise<BackendNode | null>;
+    getNode(id: string): Promise<BaseNodeRecord | null>;
     /**
      * Check if node exists
      */
@@ -165,14 +144,18 @@ export declare class RFDBServerBackend {
      * Parse a node from wire format to JS format
      */
     private _parseNode;
+    /**
+     * Parse an edge from wire format to EdgeRecord
+     */
+    private _parseEdge;
     /**
      * Async generator for querying nodes
      */
-    queryNodes(query: NodeQuery): AsyncGenerator<BackendNode, void, unknown>;
+    queryNodes(query: NodeQuery): AsyncGenerator<BaseNodeRecord, void, unknown>;
     /**
      * Get ALL nodes matching query (collects from queryNodes into array)
      */
-    getAllNodes(query?: NodeQuery): Promise<BackendNode[]>;
+    getAllNodes(query?: NodeQuery): Promise<BaseNodeRecord[]>;
     /**
      * Delete an edge
      */
@@ -180,19 +163,19 @@ export declare class RFDBServerBackend {
     /**
      * Get all edges
      */
-    getAllEdges(): Promise<BackendEdge[]>;
+    getAllEdges(): Promise<EdgeRecord[]>;
     /**
      * Get all edges (async version)
      */
-    getAllEdgesAsync(): Promise<BackendEdge[]>;
+    getAllEdgesAsync(): Promise<EdgeRecord[]>;
     /**
      * Get outgoing edges from a node
      */
-    getOutgoingEdges(nodeId: string, edgeTypes?: EdgeType[] | null): Promise<BackendEdge[]>;
+    getOutgoingEdges(nodeId: string, edgeTypes?: EdgeType[] | null): Promise<EdgeRecord[]>;
     /**
      * Get incoming edges to a node
      */
-    getIncomingEdges(nodeId: string, edgeTypes?: EdgeType[] | null): Promise<BackendEdge[]>;
+    getIncomingEdges(nodeId: string, edgeTypes?: EdgeType[] | null): Promise<EdgeRecord[]>;
     /**
      * BFS traversal
      */
@@ -201,6 +184,10 @@ export declare class RFDBServerBackend {
      * DFS traversal
      */
     dfs(startIds: string[], maxDepth: number, edgeTypes?: EdgeType[]): Promise<string[]>;
+    /**
+     * Reachability query - find all nodes reachable from start nodes
+     */
+    reachability(startIds: string[], maxDepth: number, edgeTypes?: EdgeType[], backward?: boolean): Promise<string[]>;
     /**
      * Get node count
      */
@@ -258,7 +245,7 @@ export declare class RFDBServerBackend {
     /**
      * Find nodes by predicate (for compatibility)
      */
-    findNodes(predicate: (node: BackendNode) => boolean): Promise<BackendNode[]>;
+    findNodes(predicate: (node: BaseNodeRecord) => boolean): Promise<BaseNodeRecord[]>;
     get graph(): this;
 }
 export default RFDBServerBackend;

package/dist/storage/backends/RFDBServerBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RFDBServerBackend.d.ts","sourceRoot":"","sources":["../../../src/storage/backends/RFDBServerBackend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RFDBServerBackend.d.ts","sourceRoot":"","sources":["../../../src/storage/backends/RFDBServerBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAWH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAKrF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAsB;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,iBAAiB,CAAqC;IAC9D,OAAO,CAAC,iBAAiB,CAAqC;gBAElD,OAAO,GAAE,wBAA6B;IAiBlD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA6CzB;;OAEG;YACW,YAAY;IAuD1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCzE;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAQzD;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9C;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrD;;OAEG;IACH,OAAO,CAAC,UAAU;IAuClB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC;IA0BlF;;OAEG;IACG,WAAW,CAAC,KAAK,GAAE,SAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAYnE;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAI1C;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAM/C;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,EAAE,GAAG,IAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAMlG;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,EAAE,GAAG,IAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAUlG;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzF;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,EAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK9F;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,QAAQ,EAAO,EAC1B,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC;IASpB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAKlC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAKlC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAevC;;OAEG;IACG,gBAAgB,CAAC,MAAM,GAAE,MAAM,EAAE,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAKvF;;OAEG;IACG,gBAAgB,CAAC,UAAU,GAAE,MAAM,EAAE,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAK3F;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAS9G;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAavG;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IASpC;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IASxF,IAAI,KAAK,IAAI,IAAI,CAEhB;CACF;AAED,eAAe,iBAAiB,CAAC"}

package/dist/storage/backends/RFDBServerBackend.js

@@ -22,6 +22,7 @@ import { existsSync, unlinkSync } from 'fs';
 import { spawn } from 'child_process';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
 import { setTimeout as sleep } from 'timers/promises';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -89,13 +90,27 @@ export class RFDBServerBackend {
     }
     /**
      * Find RFDB server binary in order of preference:
-     * 1. @grafema/rfdb npm package
-     * 2. rust-engine/target/release (monorepo development)
-     * 3. rust-engine/target/debug
+     * 1. packages/rfdb-server/target/release (monorepo development - prioritized for dev)
+     * 2. packages/rfdb-server/target/debug
+     * 3. @grafema/rfdb npm package (fallback for production)
      */
     _findServerBinary() {
-        // 1. Check @grafema/rfdb npm package
+        // 1. Check packages/rfdb-server in monorepo (prioritized for development)
+        const projectRoot = join(__dirname, '../../../../..');
+        const releaseBinary = join(projectRoot, 'packages/rfdb-server/target/release/rfdb-server');
+        if (existsSync(releaseBinary)) {
+            console.log(`[RFDBServerBackend] Found release binary: ${releaseBinary}`);
+            return releaseBinary;
+        }
+        // 2. Check debug build
+        const debugBinary = join(projectRoot, 'packages/rfdb-server/target/debug/rfdb-server');
+        if (existsSync(debugBinary)) {
+            console.log(`[RFDBServerBackend] Found debug binary: ${debugBinary}`);
+            return debugBinary;
+        }
+        // 3. Check @grafema/rfdb npm package (fallback)
         try {
+            const require = createRequire(import.meta.url);
             const rfdbPkg = require.resolve('@grafema/rfdb');
             const rfdbDir = dirname(rfdbPkg);
             const platform = process.platform;
@@ -119,19 +134,6 @@ export class RFDBServerBackend {
         catch {
             // @grafema/rfdb not installed
         }
-        // 2. Check rust-engine in monorepo
-        const projectRoot = join(__dirname, '../../../../..');
-        const releaseBinary = join(projectRoot, 'rust-engine/target/release/rfdb-server');
-        if (existsSync(releaseBinary)) {
-            console.log(`[RFDBServerBackend] Found release binary: ${releaseBinary}`);
-            return releaseBinary;
-        }
-        // 3. Check debug build
-        const debugBinary = join(projectRoot, 'rust-engine/target/debug/rfdb-server');
-        if (existsSync(debugBinary)) {
-            console.log(`[RFDBServerBackend] Found debug binary: ${debugBinary}`);
-            return debugBinary;
-        }
         return null;
     }
     /**
@@ -180,19 +182,26 @@ export class RFDBServerBackend {
         console.log(`[RFDBServerBackend] Server started on ${this.socketPath}`);
     }
     /**
-     * Close connection and stop server if we started it
+     * Close client connection. Server continues running to serve other clients.
      */
     async close() {
+        // Request server flush before disconnecting
         if (this.client) {
+            try {
+                await this.client.flush();
+            }
+            catch {
+                // Ignore flush errors on close - best effort
+            }
             await this.client.close();
             this.client = null;
         }
         this.connected = false;
-        // Kill server process if we started it
-        if (this.serverProcess) {
-            this.serverProcess.kill('SIGTERM');
-            this.serverProcess = null;
-        }
+        // NOTE: We intentionally do NOT kill the server process.
+        // The server continues running to serve other clients (MCP, other CLI invocations).
+        // This is by design for multi-client architecture.
+        // Server lifecycle is managed separately (system process, or manual grafema server stop).
+        this.serverProcess = null;
     }
     /**
      * Clear the database
@@ -262,13 +271,20 @@ export class RFDBServerBackend {
                 this.edgeTypes.add(edgeType);
         }
         const wireEdges = edges.map(e => {
-            const { src, dst, type, edgeType, edge_type, etype, ...rest } = e;
+            const { src, dst, type, edgeType, edge_type, etype, metadata, ...rest } = e;
+            // Flatten metadata: spread both edge-level properties and nested metadata
+            const flatMetadata = {
+                _origSrc: String(src),
+                _origDst: String(dst),
+                ...rest,
+                ...(typeof metadata === 'object' && metadata !== null ? metadata : {})
+            };
             return {
                 src: String(src),
                 dst: String(dst),
                 edgeType: (edgeType || edge_type || etype || type || 'UNKNOWN'),
-                // Store original string IDs in metadata for retrieval
-                metadata: JSON.stringify({ _origSrc: String(src), _origDst: String(dst), ...rest }),
+                // Store flattened metadata for retrieval
+                metadata: JSON.stringify(flatMetadata),
             };
         });
         await this.client.addEdges(wireEdges, skipValidation);
@@ -325,14 +341,31 @@ export class RFDBServerBackend {
             }
         }
         const humanId = metadata.originalId || wireNode.id;
+        // Exclude standard fields from metadata to prevent overwriting wireNode values
+        // REG-325: Metadata spread was overwriting name with LITERAL node data
+        const { id: _id, type: _type, name: _name, file: _file, exported: _exported, nodeType: _nodeType, originalId: _originalId, // Already extracted above
+        ...safeMetadata } = metadata;
         return {
             id: humanId,
-            nodeType: wireNode.nodeType,
             type: wireNode.nodeType,
             name: wireNode.name,
             file: wireNode.file,
             exported: wireNode.exported,
-            ...metadata,
+            ...safeMetadata,
+        };
+    }
+    /**
+     * Parse an edge from wire format to EdgeRecord
+     */
+    _parseEdge(wireEdge) {
+        const meta = wireEdge.metadata ? JSON.parse(wireEdge.metadata) : {};
+        // Use original string IDs if stored, otherwise use wire IDs
+        const { _origSrc, _origDst, ...rest } = meta;
+        return {
+            src: _origSrc || wireEdge.src,
+            dst: _origDst || wireEdge.dst,
+            type: wireEdge.edgeType,
+            metadata: Object.keys(rest).length > 0 ? rest : undefined,
         };
     }
     /**
@@ -400,18 +433,7 @@ export class RFDBServerBackend {
         if (!this.client)
             throw new Error('Not connected');
         const edges = await this.client.getAllEdges();
-        return edges.map(e => {
-            const meta = JSON.parse(e.metadata || '{}');
-            // Use original string IDs if stored, otherwise use numeric IDs
-            const { _origSrc, _origDst, ...rest } = meta;
-            return {
-                src: _origSrc || e.src,
-                dst: _origDst || e.dst,
-                type: e.edgeType,
-                edgeType: e.edgeType,
-                ...rest,
-            };
-        });
+        return edges.map(e => this._parseEdge(e));
     }
     /**
      * Get outgoing edges from a node
@@ -420,17 +442,7 @@ export class RFDBServerBackend {
         if (!this.client)
             throw new Error('Not connected');
         const edges = await this.client.getOutgoingEdges(nodeId, edgeTypes || undefined);
-        return edges.map(e => {
-            const meta = JSON.parse(e.metadata || '{}');
-            const { _origSrc, _origDst, ...rest } = meta;
-            return {
-                src: _origSrc || e.src,
-                dst: _origDst || e.dst,
-                type: e.edgeType,
-                edgeType: e.edgeType,
-                ...rest,
-            };
-        });
+        return edges.map(e => this._parseEdge(e));
     }
     /**
      * Get incoming edges to a node
@@ -439,17 +451,7 @@ export class RFDBServerBackend {
         if (!this.client)
             throw new Error('Not connected');
         const edges = await this.client.getIncomingEdges(nodeId, edgeTypes || undefined);
-        return edges.map(e => {
-            const meta = JSON.parse(e.metadata || '{}');
-            const { _origSrc, _origDst, ...rest } = meta;
-            return {
-                src: _origSrc || e.src,
-                dst: _origDst || e.dst,
-                type: e.edgeType,
-                edgeType: e.edgeType,
-                ...rest,
-            };
-        });
+        return edges.map(e => this._parseEdge(e));
     }
     // ===========================================================================
     // Graph Traversal
@@ -470,6 +472,14 @@ export class RFDBServerBackend {
             throw new Error('Not connected');
         return this.client.dfs(startIds, maxDepth, edgeTypes);
     }
+    /**
+     * Reachability query - find all nodes reachable from start nodes
+     */
+    async reachability(startIds, maxDepth, edgeTypes = [], backward = false) {
+        if (!this.client)
+            throw new Error('Not connected');
+        return this.client.reachability(startIds, maxDepth, edgeTypes, backward);
+    }
     // ===========================================================================
     // Statistics
     // ===========================================================================

package/dist/storage/backends/typeValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeValidation.d.ts","sourceRoot":"","sources":["../../../src/storage/backends/typeValidation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+CH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAcxD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAS3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAS/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvD"}
+{"version":3,"file":"typeValidation.d.ts","sourceRoot":"","sources":["../../../src/storage/backends/typeValidation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgDH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAcxD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAS3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAS/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvD"}

package/dist/storage/backends/typeValidation.js

@@ -42,6 +42,7 @@ const KNOWN_EDGE_TYPES = new Set([
     'INTERACTS_WITH', 'CALLS_API', 'LISTENS_TO', 'JOINS_ROOM', 'EMITS_EVENT',
     'RETURNS', 'RECEIVES_ARGUMENT', 'READS_FROM', 'THROWS', 'REGISTERS_VIEW',
     'GOVERNS', 'VIOLATES', 'HAS_PARAMETER', 'DERIVES_FROM',
+    'RESOLVES_TO', // Promise resolve() data flow
 ]);
 // Store initial edge types for reset
 const INITIAL_EDGE_TYPES = [...KNOWN_EDGE_TYPES];

package/dist/validation/PathValidator.d.ts

@@ -30,7 +30,7 @@ export interface PathValidationResult {
 /**
  * Endpoint diff info
  */
-interface EndpointDiff {
+export interface EndpointDiff {
     type: string;
     name: string;
     reason: string;
@@ -77,5 +77,4 @@ export declare class PathValidator {
      */
     private _getAddedReason;
 }
-export {};
 //# sourceMappingURL=PathValidator.d.ts.map

package/dist/validation/PathValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PathValidator.d.ts","sourceRoot":"","sources":["../../src/validation/PathValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAmBnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,YAAY;IAIjC;;;;;;OAMG;IACG,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsF7F;;;;;OAKG;YACW,sBAAsB;IAwDpC;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAexB"}
+{"version":3,"file":"PathValidator.d.ts","sourceRoot":"","sources":["../../src/validation/PathValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAmBnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,YAAY;IAIjC;;;;;;OAMG;IACG,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsF7F;;;;;OAKG;YACW,sBAAsB;IAwDpC;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAexB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafema/core",
-  "version": "0.1.0-alpha.5",
+  "version": "0.2.0-beta",
   "description": "Core analysis engine for Grafema code analysis toolkit",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,8 +42,8 @@
     "node-source-walk": "^7.0.1",
     "oxc-parser": "^0.96.0",
     "yaml": "^2.8.2",
-    "@grafema/rfdb-client": "0.1.0-alpha.5",
-    "@grafema/types": "0.1.0-alpha.5"
+    "@grafema/rfdb-client": "0.2.0-beta",
+    "@grafema/types": "0.2.0-beta"
   },
   "optionalDependencies": {
     "@grafema/rfdb": "^0.1.0-alpha.2"