feat(core,mcp): persistent relational code graph

.npmrc

@@ -0,0 +1 @@
+ignore-scripts=false

.nvmrc

@@ -1 +1 @@
-20
+22

README.md

@@ -84,6 +84,9 @@ packages/
 
 ## Quickstart
 
+Use Node 22 locally (`.nvmrc`) on macOS arm64 so `better-sqlite3` can use its published prebuilds.
+If you normally run with `ignore-scripts=true`, this repo overrides it via `.npmrc` because the native SQLite deps must run their install hooks.
+
 ```bash
 pnpm install
 pnpm build

packages/core/src/chunking.ts

@@ -43,6 +43,12 @@ const MAX_STRUCTURAL_CHUNK_TOKENS = 1_200
 const SPLIT_WINDOW_LINES = 90
 const SPLIT_OVERLAP_LINES = 12
 
+const typeScriptSourceFileCache = new WeakMap<ScannedFile, ts.SourceFile>()
+
+export function getCachedTypeScriptSourceFile(file: ScannedFile): ts.SourceFile | undefined {
+  return typeScriptSourceFileCache.get(file)
+}
+
 export function buildChunks(file: ScannedFile): ChunkRecord[] {
   let chunks: ChunkRecord[] = []
 
@@ -76,6 +82,7 @@ function buildTypeScriptChunks(file: ScannedFile): ChunkRecord[] {
     true,
     scriptKindFromPath(file.relativePath)
   )
+  typeScriptSourceFileCache.set(file, sourceFile)
 
   const chunks: ChunkRecord[] = []
 
@@ -1195,7 +1202,7 @@ function countRubyClosers(line: string): number {
   return /^end\b/.test(line.trim()) ? 1 : 0
 }
 
-function maskCStyleSyntax(lines: string[]): string[] {
+export function maskCStyleSyntax(lines: string[]): string[] {
   const maskedLines: string[] = []
   let inBlockComment = false
   let stringQuote: '"' | "'" | '`' | null = null

packages/core/src/index.ts

@@ -1,8 +1,14 @@
 export type {
+  EdgeResult,
   EmbeddingBatchOptions,
   EmbeddingProvider,
   EmbeddingRole,
+  FindEdgeOptions,
+  FindImportersOptions,
   FindSymbolOptions,
+  ImpactNode,
+  ImpactOptions,
+  ImpactResult,
   GrepHit,
   GrepOptions,
   IndexCompatibilitySnapshot,
@@ -27,6 +33,8 @@ export type {
   StopWatching,
   SymbolDefinition,
   SymbolKind,
+  SymbolNeighbor,
+  SymbolRelations,
   SymbolUsage,
   SyncOptions,
   SyncProgressEvent,