Interface IGraphStore

Graph storage interface.

Responsible for: causal graph CRUD, graph versioning, graph similarity search.

Typical backends:

Embedded: overgraph (Rust/napi-rs, LSM-tree, temporal edges)
Distributed: Neo4j or any Cypher/Bolt-compatible graph database

interface IGraphStore {
    close(): void;
    findSimilarGraphs(
        graph: CausalGraph,
        limit: number,
    ): Promise<CausalGraph[]>;
    listGraphVersions(graphId: string): Promise<GraphVersion[]>;
    loadGraph(graphId: string): Promise<CausalGraph | null>;
    loadGraphVersion(
        graphId: string,
        version: number,
    ): Promise<CausalGraph | null>;
    saveGraph(graph: CausalGraph, metadata: GraphMetadata): Promise<string>;
}

Implemented by

Index

Methods

close findSimilarGraphs listGraphVersions loadGraph loadGraphVersion saveGraph

Methods

close

close(): void
Close the store and release all resources

Returns void
- Defined in packages/core/src/interfaces/index.ts:112

findSimilarGraphs

findSimilarGraphs(graph: CausalGraph, limit: number): Promise<CausalGraph[]>
Find causal graphs structurally similar to the given graph. Used for detecting structural drift over time.
Parameters
- graph: CausalGraph
- limit: number
Returns Promise<CausalGraph[]>
- Defined in packages/core/src/interfaces/index.ts:109

listGraphVersions

listGraphVersions(graphId: string): Promise<GraphVersion[]>
List all versions of a causal graph
Parameters
- graphId: string
Returns Promise<GraphVersion[]>
- Defined in packages/core/src/interfaces/index.ts:103

loadGraph

loadGraph(graphId: string): Promise<CausalGraph | null>
Load the latest version of a causal graph by ID
Parameters
- graphId: string
Returns Promise<CausalGraph | null>
- Defined in packages/core/src/interfaces/index.ts:97

loadGraphVersion

loadGraphVersion(graphId: string, version: number): Promise<CausalGraph | null>
Load a specific version of a causal graph
Parameters
- graphId: string
- version: number
Returns Promise<CausalGraph | null>
- Defined in packages/core/src/interfaces/index.ts:100

saveGraph

saveGraph(graph: CausalGraph, metadata: GraphMetadata): Promise<string>
Persist a causal graph with metadata. Returns the assigned graph ID.
Parameters
- graph: CausalGraph
- metadata: GraphMetadata
Returns Promise<string>
- Defined in packages/core/src/interfaces/index.ts:94