graphyn-core

Language-agnostic graph engine for Graphyn.

graphyn-core owns the canonical IR, graph structure, alias resolution, and query algorithms. It does not parse source code directly and does not contain language-specific logic.

Responsibilities

Defines the frozen IR contract (Symbol, Relationship, FileIR, RepoIR)
Stores a directed symbol graph (GraphynGraph)
Resolves alias chains (import aliases, re-exports, barrel/default alias metadata)
Provides query APIs:
- blast_radius
- dependencies
- symbol_usages
Supports incremental graph update plumbing
Provides the shared symbol-id and AST-traversal helpers every adapter builds on

Public modules

ir: shared IR contract used by all adapters
graph: graph container + indexes
index: symbol lookup indexes
resolver: alias chain ingestion and canonicalization helpers
query: traversal-based query functions
incremental: file-level replacement/update helpers
scan: source-file discovery, filtering and extension-to-language detection
symbol_id: canonical SymbolId construction, shared by every adapter
ast: iterative, depth-bounded tree-sitter traversal helpers (feature ast)
error: GraphynError

Features

ast (default): shared tree-sitter traversal helpers used by every language adapter. Graph-only consumers such as graphyn-store turn this off so they do not link a parser.

Minimal usage

use graphyn_core::graph::GraphynGraph;
use graphyn_core::query;

let graph = GraphynGraph::new();
let _ = query::blast_radius(&graph, "UserPayload", None, Some(2));

Notes