ghagga-core 2.5.0 → 2.6.0

package/dist/graph/extractors/typescript.js

@@ -0,0 +1,151 @@
+/**
+ * TypeScript Extractor
+ *
+ * Regex-based extractor for TypeScript/TSX files.
+ * Handles ES module imports/exports including type-only imports.
+ */
+// ─── Import Patterns ────────────────────────────────────────────
+/** import { x, y } from 'module' — also handles `import type { x } from 'module'` */
+const NAMED_IMPORT_RE = /import\s+(?:type\s+)?{([^}]+)}\s+from\s+['"]([^'"]+)['"]/g;
+/** import x from 'module' — default import */
+const DEFAULT_IMPORT_RE = /import\s+(\w+)\s+from\s+['"]([^'"]+)['"]/g;
+/** import * as x from 'module' — namespace import */
+const NAMESPACE_IMPORT_RE = /import\s+\*\s+as\s+(\w+)\s+from\s+['"]([^'"]+)['"]/g;
+/** import 'module' — side-effect import */
+const SIDE_EFFECT_IMPORT_RE = /import\s+['"]([^'"]+)['"]/g;
+/** import x, { y, z } from 'module' — mixed default + named */
+const MIXED_IMPORT_RE = /import\s+(\w+)\s*,\s*{([^}]+)}\s+from\s+['"]([^'"]+)['"]/g;
+// ─── Export Patterns ────────────────────────────────────────────
+/** export function x() / export async function x() */
+const EXPORT_FUNCTION_RE = /export\s+(?:async\s+)?function\s+(\w+)/g;
+/** export class x */
+const EXPORT_CLASS_RE = /export\s+class\s+(\w+)/g;
+/** export const/let/var x */
+const EXPORT_VARIABLE_RE = /export\s+(?:const|let|var)\s+(\w+)/g;
+/** export type x / export interface x */
+const EXPORT_TYPE_RE = /export\s+(?:type|interface)\s+(\w+)/g;
+/** export default */
+const EXPORT_DEFAULT_RE = /export\s+default\s+(?:function\s+(\w+)|class\s+(\w+)|(\w+))/g;
+/** export { x, y, z } — re-exports or named exports */
+const EXPORT_NAMED_RE = /export\s+{([^}]+)}/g;
+/** export default (anonymous) — export default function() {}, export default class {} */
+const EXPORT_DEFAULT_ANON_RE = /export\s+default\s+(?:function|class)\s*[({]/g;
+// ─── Extractor ──────────────────────────────────────────────────
+export const typescriptExtractor = {
+    language: 'typescript',
+    extensions: ['.ts', '.tsx'],
+    extractImports(content) {
+        const imports = [];
+        const seen = new Set();
+        // Mixed default + named: import x, { y, z } from 'module'
+        for (const match of content.matchAll(MIXED_IMPORT_RE)) {
+            const defaultName = match[1];
+            const namedPart = match[2];
+            const source = match[3];
+            const symbols = [
+                defaultName,
+                ...namedPart
+                    .split(',')
+                    .map((s) => s.trim().replace(/\s+as\s+\w+/, ''))
+                    .filter(Boolean),
+            ];
+            const key = `${source}:${symbols.sort().join(',')}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                imports.push({ source, symbols });
+            }
+        }
+        // Named imports: import { x, y } from 'module'
+        for (const match of content.matchAll(NAMED_IMPORT_RE)) {
+            const symbols = match[1]
+                ?.split(',')
+                .map((s) => s.trim().replace(/\s+as\s+\w+/, ''))
+                .filter(Boolean);
+            const source = match[2];
+            const key = `${source}:named`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                imports.push({ source, symbols });
+            }
+        }
+        // Default imports: import x from 'module'
+        for (const match of content.matchAll(DEFAULT_IMPORT_RE)) {
+            const name = match[1];
+            const source = match[2];
+            const key = `${source}:default`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                imports.push({ source, symbols: [name] });
+            }
+        }
+        // Namespace imports: import * as x from 'module'
+        for (const match of content.matchAll(NAMESPACE_IMPORT_RE)) {
+            const name = match[1];
+            const source = match[2];
+            const key = `${source}:namespace`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                imports.push({ source, symbols: [name] });
+            }
+        }
+        // Side-effect imports: import 'module'
+        for (const match of content.matchAll(SIDE_EFFECT_IMPORT_RE)) {
+            const source = match[1];
+            const key = `${source}:side-effect`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                imports.push({ source, symbols: [] });
+            }
+        }
+        return imports;
+    },
+    extractExports(content) {
+        const exports = [];
+        const seen = new Set();
+        function add(name, kind) {
+            if (!seen.has(name)) {
+                seen.add(name);
+                exports.push({ name, kind });
+            }
+        }
+        // export default (named)
+        for (const match of content.matchAll(EXPORT_DEFAULT_RE)) {
+            const name = match[1] ?? match[2] ?? match[3];
+            if (name)
+                add(name, 'default');
+        }
+        // export default (anonymous)
+        for (const _match of content.matchAll(EXPORT_DEFAULT_ANON_RE)) {
+            if (!seen.has('default'))
+                add('default', 'default');
+        }
+        // export function
+        for (const match of content.matchAll(EXPORT_FUNCTION_RE)) {
+            add(match[1], 'function');
+        }
+        // export class
+        for (const match of content.matchAll(EXPORT_CLASS_RE)) {
+            add(match[1], 'class');
+        }
+        // export const/let/var
+        for (const match of content.matchAll(EXPORT_VARIABLE_RE)) {
+            add(match[1], 'variable');
+        }
+        // export type/interface
+        for (const match of content.matchAll(EXPORT_TYPE_RE)) {
+            add(match[1], 'type');
+        }
+        // export { x, y, z }
+        for (const match of content.matchAll(EXPORT_NAMED_RE)) {
+            const names = match[1]
+                ?.split(',')
+                .map((s) => s.trim().replace(/\s+as\s+\w+/, ''))
+                .filter(Boolean);
+            for (const name of names) {
+                add(name, 'variable'); // Can't determine kind from re-export
+            }
+        }
+        return exports;
+    },
+};
+//# sourceMappingURL=typescript.js.map

package/dist/graph/extractors/typescript.js.map

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

package/dist/graph/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Graph module barrel export.
+ *
+ * Re-exports all public types, interfaces, constants, and functions
+ * from the graph subsystem.
+ */
+export type { BlastRadiusMetadata, DependencyGraph, GraphLoader, GraphMetadata, GraphNode, SupportedLanguage, } from './schema.js';
+export { DEFAULT_TRAVERSAL_DEPTH, EXCLUDED_DIRS, GRAPH_STALE_DAYS, GRAPH_VERSION, isGraphStale, isTestFile, LANGUAGE_EXTENSIONS, MAX_BLAST_RADIUS_FILES, MAX_GRAPH_SIZE_BYTES, TEST_FILE_PATTERNS, validateGraph, validateMetadata, } from './schema.js';
+export type { BlastRadiusOptions, BlastRadiusResult } from './blast-radius.js';
+export { buildReverseIndex, computeBlastRadius } from './blast-radius.js';
+export { GitHubApiGraphLoader, NullGraphLoader, PreloadedGraphLoader } from './loader.js';
+export type { ExportInfo, Extractor, ImportInfo } from './extractors/index.js';
+export { getExtractor } from './extractors/index.js';
+export { buildGraph, buildGraphIncremental, detectLanguage, resolveImportPath } from './builder.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,aAAa,EACb,SAAS,EACT,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAIrB,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAI1E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAI1F,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/graph/index.js

@@ -0,0 +1,14 @@
+/**
+ * Graph module barrel export.
+ *
+ * Re-exports all public types, interfaces, constants, and functions
+ * from the graph subsystem.
+ */
+export { DEFAULT_TRAVERSAL_DEPTH, EXCLUDED_DIRS, GRAPH_STALE_DAYS, GRAPH_VERSION, isGraphStale, isTestFile, LANGUAGE_EXTENSIONS, MAX_BLAST_RADIUS_FILES, MAX_GRAPH_SIZE_BYTES, TEST_FILE_PATTERNS, validateGraph, validateMetadata, } from './schema.js';
+export { buildReverseIndex, computeBlastRadius } from './blast-radius.js';
+// ─── Graph Loaders ──────────────────────────────────────────────
+export { GitHubApiGraphLoader, NullGraphLoader, PreloadedGraphLoader } from './loader.js';
+export { getExtractor } from './extractors/index.js';
+// ─── Graph Builder ──────────────────────────────────────────────
+export { buildGraph, buildGraphIncremental, detectLanguage, resolveImportPath } from './builder.js';
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,mEAAmE;AAEnE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAK1F,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,mEAAmE;AAEnE,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/graph/loader.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Graph Loaders
+ *
+ * Implementations of the GraphLoader interface for different environments:
+ * - GitHubApiGraphLoader: fetches from ghagga/graph orphan branch via GitHub API
+ * - NullGraphLoader: always returns null (used when blast-radius is disabled)
+ * - PreloadedGraphLoader: wraps an already-fetched graph (used by SaaS for early fetch)
+ */
+import { type DependencyGraph, type GraphLoader, type GraphMetadata } from './schema.js';
+/**
+ * Fetches the dependency graph from a GitHub repository's ghagga/graph orphan branch.
+ *
+ * Uses the GitHub Contents API with `Accept: application/vnd.github.raw` to get
+ * the raw JSON without base64 encoding.
+ */
+export declare class GitHubApiGraphLoader implements GraphLoader {
+    private readonly owner;
+    private readonly repo;
+    private readonly token;
+    constructor(owner: string, repo: string, token: string);
+    load(): Promise<DependencyGraph | null>;
+    loadMetadata(): Promise<GraphMetadata | null>;
+}
+/**
+ * A no-op loader that always returns null.
+ * Used when blast-radius is disabled or no graph source is available.
+ */
+export declare class NullGraphLoader implements GraphLoader {
+    load(): Promise<DependencyGraph | null>;
+    loadMetadata(): Promise<GraphMetadata | null>;
+}
+/**
+ * A loader that wraps a pre-fetched graph and optional metadata.
+ * Used by the SaaS server when the graph is fetched early (before pipeline).
+ */
+export declare class PreloadedGraphLoader implements GraphLoader {
+    private readonly graph;
+    private readonly metadata?;
+    constructor(graph: DependencyGraph, metadata?: (GraphMetadata | null) | undefined);
+    load(): Promise<DependencyGraph | null>;
+    loadMetadata(): Promise<GraphMetadata | null>;
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/graph/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/graph/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAGnB,MAAM,aAAa,CAAC;AAIrB;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,WAAW;IAEpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM;IAG1B,IAAI,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAuBvC,YAAY,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAqBpD;AAID;;;GAGG;AACH,qBAAa,eAAgB,YAAW,WAAW;IAC3C,IAAI,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIvC,YAAY,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAGpD;AAID;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,WAAW;IAEpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,KAAK,EAAE,eAAe,EACtB,QAAQ,CAAC,GAAE,aAAa,GAAG,IAAI,aAAA;IAG5C,IAAI,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIvC,YAAY,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAGpD"}

package/dist/graph/loader.js

@@ -0,0 +1,104 @@
+/**
+ * Graph Loaders
+ *
+ * Implementations of the GraphLoader interface for different environments:
+ * - GitHubApiGraphLoader: fetches from ghagga/graph orphan branch via GitHub API
+ * - NullGraphLoader: always returns null (used when blast-radius is disabled)
+ * - PreloadedGraphLoader: wraps an already-fetched graph (used by SaaS for early fetch)
+ */
+import { validateGraph, validateMetadata, } from './schema.js';
+// ─── GitHub API Graph Loader ────────────────────────────────────
+/**
+ * Fetches the dependency graph from a GitHub repository's ghagga/graph orphan branch.
+ *
+ * Uses the GitHub Contents API with `Accept: application/vnd.github.raw` to get
+ * the raw JSON without base64 encoding.
+ */
+export class GitHubApiGraphLoader {
+    owner;
+    repo;
+    token;
+    constructor(owner, repo, token) {
+        this.owner = owner;
+        this.repo = repo;
+        this.token = token;
+    }
+    async load() {
+        try {
+            const url = `https://api.github.com/repos/${this.owner}/${this.repo}/contents/.ghagga/graph.json?ref=ghagga/graph`;
+            const response = await fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                    Accept: 'application/vnd.github.raw',
+                    'X-GitHub-Api-Version': '2022-11-28',
+                },
+                signal: AbortSignal.timeout(5_000),
+            });
+            if (response.status === 404)
+                return null;
+            if (!response.ok)
+                return null;
+            const json = await response.json();
+            return validateGraph(json);
+        }
+        catch {
+            // Network error, timeout, parse error — all return null
+            return null;
+        }
+    }
+    async loadMetadata() {
+        try {
+            const url = `https://api.github.com/repos/${this.owner}/${this.repo}/contents/.ghagga/metadata.json?ref=ghagga/graph`;
+            const response = await fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                    Accept: 'application/vnd.github.raw',
+                    'X-GitHub-Api-Version': '2022-11-28',
+                },
+                signal: AbortSignal.timeout(5_000),
+            });
+            if (response.status === 404)
+                return null;
+            if (!response.ok)
+                return null;
+            const json = await response.json();
+            return validateMetadata(json);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// ─── Null Graph Loader ──────────────────────────────────────────
+/**
+ * A no-op loader that always returns null.
+ * Used when blast-radius is disabled or no graph source is available.
+ */
+export class NullGraphLoader {
+    async load() {
+        return null;
+    }
+    async loadMetadata() {
+        return null;
+    }
+}
+// ─── Preloaded Graph Loader ─────────────────────────────────────
+/**
+ * A loader that wraps a pre-fetched graph and optional metadata.
+ * Used by the SaaS server when the graph is fetched early (before pipeline).
+ */
+export class PreloadedGraphLoader {
+    graph;
+    metadata;
+    constructor(graph, metadata) {
+        this.graph = graph;
+        this.metadata = metadata;
+    }
+    async load() {
+        return this.graph;
+    }
+    async loadMetadata() {
+        return this.metadata ?? null;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/graph/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/graph/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,mEAAmE;AAEnE;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAEZ;IACA;IACA;IAHnB,YACmB,KAAa,EACb,IAAY,EACZ,KAAa;QAFb,UAAK,GAAL,KAAK,CAAQ;QACb,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAQ;IAC7B,CAAC;IAEJ,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,gCAAgC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,+CAA+C,CAAC;YACnH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;oBACrC,MAAM,EAAE,4BAA4B;oBACpC,sBAAsB,EAAE,YAAY;iBACrC;gBACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;aACnC,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAE9B,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC5C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,gCAAgC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,kDAAkD,CAAC;YACtH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;oBACrC,MAAM,EAAE,4BAA4B;oBACpC,sBAAsB,EAAE,YAAY;iBACrC;gBACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;aACnC,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAE9B,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC5C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED,mEAAmE;AAEnE;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC1B,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,mEAAmE;AAEnE;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,KAAsB,EACtB,QAA+B;QAD/B,UAAK,GAAL,KAAK,CAAiB;QACtB,aAAQ,GAAR,QAAQ,CAAuB;IAC/C,CAAC;IAEJ,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC/B,CAAC;CACF"}

package/dist/graph/schema.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Dependency Graph Schema & Types
+ *
+ * Defines the core data structures for the blast-radius feature:
+ * - DependencyGraph: the file-level import/export/call graph
+ * - GraphMetadata: indexing metadata (commit, timestamp, stats)
+ * - BlastRadiusMetadata: per-review blast-radius summary
+ * - Validation functions for runtime type checking
+ * - Constants for limits, patterns, and language support
+ */
+export type SupportedLanguage = 'typescript' | 'javascript' | 'python' | 'go' | 'java' | 'rust';
+export interface DependencyGraph {
+    /** Schema version for forward compatibility */
+    version: number;
+    /** Base path for all relative file paths */
+    rootDir: string;
+    /** File nodes keyed by relative path */
+    nodes: Record<string, GraphNode>;
+}
+export interface GraphNode {
+    /** SHA-256 hash of file content (for incremental indexing) */
+    hash: string;
+    /** Detected language */
+    language: SupportedLanguage;
+    /** Relative paths of files this file imports from */
+    imports: string[];
+    /** Exported symbol names (for cross-reference) */
+    exports: string[];
+    /** Cross-file function/method calls */
+    calls: Array<{
+        target: string;
+        symbol: string;
+    }>;
+    /** True if file matches test patterns */
+    isTest: boolean;
+}
+export interface GraphMetadata {
+    /** Full SHA of the commit that was last indexed */
+    lastIndexedCommit: string;
+    /** ISO 8601 timestamp */
+    lastIndexedAt: string;
+    /** Must match graph.version */
+    schemaVersion: number;
+    /** Total nodes in the graph */
+    fileCount: number;
+    /** Languages present */
+    languages: string[];
+    /** Indexing duration in milliseconds */
+    indexDurationMs: number;
+}
+export interface BlastRadiusMetadata {
+    /** Whether blast-radius was enabled for this review */
+    enabled: boolean;
+    /** Whether a dependency graph was available */
+    graphAvailable: boolean;
+    /** Total files in the diff */
+    totalFiles: number;
+    /** Files after blast-radius filtering */
+    blastRadiusFiles: number;
+    /** Reason for falling back to full diff (when applicable) */
+    fallbackReason?: string;
+    /** Whether the graph was stale (>7 days old) */
+    graphStale?: boolean;
+}
+export interface GraphLoader {
+    /** Load the dependency graph. Returns null if unavailable. */
+    load(): Promise<DependencyGraph | null>;
+    /** Load graph metadata. Returns null if unavailable. */
+    loadMetadata(): Promise<GraphMetadata | null>;
+}
+/** Current graph schema version */
+export declare const GRAPH_VERSION = 1;
+/** Maximum graph.json size in bytes (5 MB) */
+export declare const MAX_GRAPH_SIZE_BYTES: number;
+/** Maximum files in a blast-radius result before falling back to full diff */
+export declare const MAX_BLAST_RADIUS_FILES = 50;
+/** Default BFS traversal depth for reverse dependency lookup */
+export declare const DEFAULT_TRAVERSAL_DEPTH = 3;
+/** Number of days after which a graph is considered stale */
+export declare const GRAPH_STALE_DAYS = 7;
+/** Regex patterns that identify test files across supported languages */
+export declare const TEST_FILE_PATTERNS: RegExp[];
+/** Directories excluded from graph indexing */
+export declare const EXCLUDED_DIRS: Set<string>;
+/** Map from file extension to supported language */
+export declare const LANGUAGE_EXTENSIONS: Record<string, SupportedLanguage>;
+/**
+ * Check if a file path matches any known test file pattern.
+ * Tests against the basename (last segment) of the path.
+ */
+export declare function isTestFile(filePath: string): boolean;
+/**
+ * Validate a parsed JSON value as a DependencyGraph.
+ * Returns the typed graph if valid, null otherwise.
+ *
+ * Checks:
+ * - Is an object with version, rootDir, nodes
+ * - version matches GRAPH_VERSION
+ * - rootDir is a string
+ * - nodes is a Record<string, GraphNode> with required fields
+ */
+export declare function validateGraph(json: unknown): DependencyGraph | null;
+/**
+ * Validate a parsed JSON value as GraphMetadata.
+ * Returns the typed metadata if valid, null otherwise.
+ */
+export declare function validateMetadata(json: unknown): GraphMetadata | null;
+/**
+ * Check if a graph's metadata indicates it is stale.
+ * A graph is stale if it was last indexed more than GRAPH_STALE_DAYS ago.
+ */
+export declare function isGraphStale(metadata: GraphMetadata): boolean;
+//# sourceMappingURL=schema.d.ts.map

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

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

package/dist/graph/schema.js

@@ -0,0 +1,144 @@
+/**
+ * Dependency Graph Schema & Types
+ *
+ * Defines the core data structures for the blast-radius feature:
+ * - DependencyGraph: the file-level import/export/call graph
+ * - GraphMetadata: indexing metadata (commit, timestamp, stats)
+ * - BlastRadiusMetadata: per-review blast-radius summary
+ * - Validation functions for runtime type checking
+ * - Constants for limits, patterns, and language support
+ */
+// ─── Constants ──────────────────────────────────────────────────
+/** Current graph schema version */
+export const GRAPH_VERSION = 1;
+/** Maximum graph.json size in bytes (5 MB) */
+export const MAX_GRAPH_SIZE_BYTES = 5 * 1024 * 1024;
+/** Maximum files in a blast-radius result before falling back to full diff */
+export const MAX_BLAST_RADIUS_FILES = 50;
+/** Default BFS traversal depth for reverse dependency lookup */
+export const DEFAULT_TRAVERSAL_DEPTH = 3;
+/** Number of days after which a graph is considered stale */
+export const GRAPH_STALE_DAYS = 7;
+/** Regex patterns that identify test files across supported languages */
+export const TEST_FILE_PATTERNS = [
+    /\.test\.[jt]sx?$/,
+    /\.spec\.[jt]sx?$/,
+    /^test_.*\.py$/,
+    /_test\.go$/,
+    /Test\.java$/,
+    /_test\.rs$/,
+];
+/** Directories excluded from graph indexing */
+export const EXCLUDED_DIRS = new Set([
+    'node_modules',
+    'vendor',
+    '.git',
+    '__pycache__',
+    'target',
+    'build',
+    'dist',
+    '.next',
+    '.turbo',
+]);
+/** Map from file extension to supported language */
+export const LANGUAGE_EXTENSIONS = {
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.mjs': 'javascript',
+    '.cjs': 'javascript',
+    '.py': 'python',
+    '.go': 'go',
+    '.java': 'java',
+    '.rs': 'rust',
+};
+// ─── Utility Functions ──────────────────────────────────────────
+/**
+ * Check if a file path matches any known test file pattern.
+ * Tests against the basename (last segment) of the path.
+ */
+export function isTestFile(filePath) {
+    const basename = filePath.split('/').pop() ?? filePath;
+    return TEST_FILE_PATTERNS.some((pattern) => pattern.test(basename));
+}
+/**
+ * Validate a parsed JSON value as a DependencyGraph.
+ * Returns the typed graph if valid, null otherwise.
+ *
+ * Checks:
+ * - Is an object with version, rootDir, nodes
+ * - version matches GRAPH_VERSION
+ * - rootDir is a string
+ * - nodes is a Record<string, GraphNode> with required fields
+ */
+export function validateGraph(json) {
+    if (!json || typeof json !== 'object')
+        return null;
+    const obj = json;
+    // Check required top-level fields
+    if (typeof obj.version !== 'number')
+        return null;
+    if (obj.version !== GRAPH_VERSION)
+        return null;
+    if (typeof obj.rootDir !== 'string')
+        return null;
+    if (!obj.nodes || typeof obj.nodes !== 'object')
+        return null;
+    // Validate nodes structure (spot-check — not exhaustive for perf)
+    const nodes = obj.nodes;
+    for (const [key, value] of Object.entries(nodes)) {
+        if (typeof key !== 'string')
+            return null;
+        if (!value || typeof value !== 'object')
+            return null;
+        const node = value;
+        if (typeof node.hash !== 'string')
+            return null;
+        if (typeof node.language !== 'string')
+            return null;
+        if (!Array.isArray(node.imports))
+            return null;
+        if (!Array.isArray(node.exports))
+            return null;
+        if (!Array.isArray(node.calls))
+            return null;
+        if (typeof node.isTest !== 'boolean')
+            return null;
+    }
+    return json;
+}
+/**
+ * Validate a parsed JSON value as GraphMetadata.
+ * Returns the typed metadata if valid, null otherwise.
+ */
+export function validateMetadata(json) {
+    if (!json || typeof json !== 'object')
+        return null;
+    const obj = json;
+    if (typeof obj.lastIndexedCommit !== 'string')
+        return null;
+    if (typeof obj.lastIndexedAt !== 'string')
+        return null;
+    if (typeof obj.schemaVersion !== 'number')
+        return null;
+    if (typeof obj.fileCount !== 'number')
+        return null;
+    if (!Array.isArray(obj.languages))
+        return null;
+    if (typeof obj.indexDurationMs !== 'number')
+        return null;
+    return json;
+}
+/**
+ * Check if a graph's metadata indicates it is stale.
+ * A graph is stale if it was last indexed more than GRAPH_STALE_DAYS ago.
+ */
+export function isGraphStale(metadata) {
+    const lastIndexed = new Date(metadata.lastIndexedAt);
+    const now = new Date();
+    const diffMs = now.getTime() - lastIndexed.getTime();
+    const diffDays = diffMs / (1000 * 60 * 60 * 24);
+    return diffDays > GRAPH_STALE_DAYS;
+}
+//# sourceMappingURL=schema.js.map

package/dist/graph/schema.js.map

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

package/dist/health/trends.js

@@ -55,7 +55,7 @@ export function saveHistory(configDir, entry) {
             const key = e.projectPath;
             if (!grouped.has(key))
                 grouped.set(key, []);
-            grouped.get(key).push(e);
+            grouped.get(key)?.push(e);
         }
         const pruned = [];
         for (const entries of grouped.values()) {