ghagga-core 2.5.0 → 2.6.0

package/dist/enhance/enhance.js

@@ -4,9 +4,9 @@
  * Calls an LLM to group, prioritize, and filter static analysis findings.
  * Failures are non-blocking — returns empty result on any error.
  */
-import { generateText } from 'ai';
 import { createModel } from '../providers/index.js';
-import { buildEnhancePrompt, ENHANCE_SYSTEM_PROMPT, truncateByTokenBudget, } from './prompt.js';
+import { generateTextWithTimeout } from '../utils/llm-timeout.js';
+import { buildEnhancePrompt, ENHANCE_SYSTEM_PROMPT, truncateByTokenBudget } from './prompt.js';
 /** Default token budget for the enhance prompt (4K tokens). */
 const DEFAULT_TOKEN_BUDGET = 4000;
 /** Empty result returned on failure or zero findings. */
@@ -41,12 +41,24 @@ export async function enhanceFindings(input) {
         const prompt = buildEnhancePrompt(truncated);
         // Call LLM
         const model = createModel(input.provider, input.model, input.apiKey);
-        const response = await generateText({
+        const response = await generateTextWithTimeout({
             model,
             system: ENHANCE_SYSTEM_PROMPT,
             prompt,
             maxOutputTokens: 2000,
-        });
+        }, { provider: input.provider, model: input.model });
+        // Timeout: return empty result (enhance is already non-blocking)
+        if (response === null) {
+            return {
+                result: EMPTY_RESULT,
+                metadata: {
+                    model: input.model,
+                    tokenUsage: { input: 0, output: 0 },
+                    groupCount: 0,
+                    filteredCount: 0,
+                },
+            };
+        }
         // Parse response
         const parsed = parseEnhanceResponse(response.text);
         return {

package/dist/enhance/enhance.js.map

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

package/dist/format.d.ts

@@ -5,7 +5,53 @@
  * suitable for posting to a PR via the GitHub API.
  */
 import type { ReviewResult, ReviewStatus } from './types.js';
+export interface FileStats {
+    additions: number;
+    deletions: number;
+}
+interface FileCategory {
+    key: string;
+    name: string;
+    emoji: string;
+    patterns: RegExp[];
+}
+export declare const FILE_CATEGORIES: FileCategory[];
 export declare const STATUS_EMOJI: Record<ReviewStatus, string>;
 export declare const SEVERITY_EMOJI: Record<string, string>;
-export declare function formatReviewComment(result: ReviewResult): string;
+/** Idempotent comment marker — used to find and update existing comments. */
+export declare const REVIEW_COMMENT_MARKER = "<!-- ghagga-review -->";
+/**
+ * Build a visual emoji stats bar showing additions vs deletions.
+ *
+ * Format: `🟩🟩🟩🟩🟩🟩🟩🟩🟩🟥🟥 +120 / -15 (net +105)`
+ * Uses 20 emoji blocks proportional to the add/delete ratio.
+ */
+export declare function buildStatsBar(stats: FileStats): string;
+/**
+ * Categorize a list of file paths into groups.
+ * Returns categories with at least one file, in definition order.
+ */
+export declare function categorizeFiles(fileList: string[]): Array<{
+    name: string;
+    emoji: string;
+    files: string[];
+}>;
+/**
+ * Format a file category summary section.
+ * Max 3 files shown per category, then "+N more".
+ */
+export declare function formatFileCategorySummary(fileList: string[]): string;
+export interface FormatReviewCommentOptions {
+    /** File-level additions/deletions stats. When provided, renders the emoji stats bar. */
+    fileStats?: FileStats;
+    /** List of changed file paths. When provided, renders the categorized file summary. */
+    fileList?: string[];
+    /**
+     * GitHub username of the PR author. When provided, a @mention is appended
+     * so GitHub sends a notification to the author when the review is posted.
+     */
+    prAuthor?: string;
+}
+export declare function formatReviewComment(result: ReviewResult, options?: FormatReviewCommentOptions): string;
+export {};
 //# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI7D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKrD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAIF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAyFhE"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI7D,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,EAAE,YAAY,EAqEzC,CAAC;AAIF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKrD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAIF,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAI9D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAYtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwBzD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAoBpE;AAID,MAAM,WAAW,0BAA0B;IACzC,wFAAwF;IACxF,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,0BAA0B,GACnC,MAAM,CA2HR"}

package/dist/format.js

@@ -7,6 +7,76 @@
 import { initializeDefaultTools } from './tools/plugins/index.js';
 import { toolRegistry } from './tools/registry.js';
 import { isToolRegistryEnabled } from './tools/runner.js';
+export const FILE_CATEGORIES = [
+    {
+        key: 'test',
+        name: 'Tests',
+        emoji: '\ud83e\uddea',
+        patterns: [/\.test\./, /\.spec\./, /__tests__/, /test[s]?\//],
+    },
+    {
+        key: 'docs',
+        name: 'Docs',
+        emoji: '\ud83d\udcdd',
+        patterns: [/\.md$/, /docs?\//, /README/, /CHANGELOG/],
+    },
+    {
+        key: 'ci',
+        name: 'CI/CD',
+        emoji: '\ud83d\udd04',
+        patterns: [/\.github\/workflows/, /\.gitlab-ci/, /Jenkinsfile/],
+    },
+    {
+        key: 'config',
+        name: 'Config',
+        emoji: '\u2699\ufe0f',
+        patterns: [
+            /\.config\.[jt]s$/,
+            /tsconfig/,
+            /\.eslint/,
+            /\.prettier/,
+            /Dockerfile/,
+            /docker-compose/,
+        ],
+    },
+    {
+        key: 'deps',
+        name: 'Dependencies',
+        emoji: '\ud83d\udce6',
+        patterns: [
+            /package(-lock)?\.json$/,
+            /yarn\.lock/,
+            /pnpm-lock/,
+            /go\.(mod|sum)$/,
+            /requirements.*\.txt$/,
+        ],
+    },
+    {
+        key: 'style',
+        name: 'Styling',
+        emoji: '\ud83c\udfa8',
+        patterns: [/\.css$/, /\.scss$/, /\.sass$/, /\.less$/],
+    },
+    {
+        key: 'migration',
+        name: 'Database',
+        emoji: '\ud83d\uddc4\ufe0f',
+        patterns: [/migrat/, /schema\./, /seed\./],
+    },
+    {
+        key: 'api',
+        name: 'API',
+        emoji: '\ud83d\udd0c',
+        patterns: [/routes?\//, /api\//, /controllers?\//, /handlers?\//],
+    },
+    {
+        key: 'ui',
+        name: 'UI',
+        emoji: '\ud83d\uddbc\ufe0f',
+        patterns: [/components?\//, /pages?\//, /views?\//, /\.tsx$/],
+    },
+    { key: 'core', name: 'Core', emoji: '\ud83d\udd27', patterns: [/src\//, /lib\//, /\.[jt]sx?$/] },
+];
 // ─── Constants ──────────────────────────────────────────────────
 export const STATUS_EMOJI = {
     PASSED: '\u2705 PASSED',
@@ -21,13 +91,106 @@ export const SEVERITY_EMOJI = {
     low: '\ud83d\udfe2',
     info: '\ud83d\udfe3',
 };
+// ─── Formatting Helpers ─────────────────────────────────────────
+/** Idempotent comment marker — used to find and update existing comments. */
+export const REVIEW_COMMENT_MARKER = '<!-- ghagga-review -->';
+const STATS_BAR_BLOCKS = 20;
+/**
+ * Build a visual emoji stats bar showing additions vs deletions.
+ *
+ * Format: `🟩🟩🟩🟩🟩🟩🟩🟩🟩🟥🟥 +120 / -15 (net +105)`
+ * Uses 20 emoji blocks proportional to the add/delete ratio.
+ */
+export function buildStatsBar(stats) {
+    const total = stats.additions + stats.deletions;
+    if (total === 0)
+        return '';
+    const greenCount = Math.round((stats.additions / total) * STATS_BAR_BLOCKS);
+    const redCount = STATS_BAR_BLOCKS - greenCount;
+    const bar = '\ud83d\udfe9'.repeat(greenCount) + '\ud83d\udfe5'.repeat(redCount);
+    const net = stats.additions - stats.deletions;
+    const netStr = net >= 0 ? `+${net}` : `${net}`;
+    return `${bar} +${stats.additions} / -${stats.deletions} (net ${netStr})`;
+}
+/**
+ * Categorize a list of file paths into groups.
+ * Returns categories with at least one file, in definition order.
+ */
+export function categorizeFiles(fileList) {
+    const categorized = new Map();
+    const assigned = new Set();
+    for (const cat of FILE_CATEGORIES) {
+        const matched = [];
+        for (const filePath of fileList) {
+            if (assigned.has(filePath))
+                continue;
+            if (cat.patterns.some((p) => p.test(filePath))) {
+                matched.push(filePath);
+                assigned.add(filePath);
+            }
+        }
+        if (matched.length > 0) {
+            categorized.set(cat.key, matched);
+        }
+    }
+    // Return in definition order, only non-empty categories
+    return FILE_CATEGORIES.filter((cat) => categorized.has(cat.key)).map((cat) => ({
+        name: cat.name,
+        emoji: cat.emoji,
+        files: categorized.get(cat.key),
+    }));
+}
+/**
+ * Format a file category summary section.
+ * Max 3 files shown per category, then "+N more".
+ */
+export function formatFileCategorySummary(fileList) {
+    const categories = categorizeFiles(fileList);
+    if (categories.length === 0)
+        return '';
+    let section = `### Files Changed (${fileList.length})\n`;
+    for (const cat of categories) {
+        const basenames = cat.files.map((f) => f.split('/').pop() ?? f);
+        const MAX_SHOWN = 3;
+        const shown = basenames.slice(0, MAX_SHOWN);
+        const remaining = basenames.length - MAX_SHOWN;
+        section += `${cat.emoji} **${cat.name}**: ${shown.join(', ')}`;
+        if (remaining > 0) {
+            section += ` (+${remaining} more)`;
+        }
+        section += '\n';
+    }
+    return section + '\n';
+}
 // ─── Formatting ─────────────────────────────────────────────────
-export function formatReviewComment(result) {
+export function formatReviewComment(result, options) {
     const status = STATUS_EMOJI[result.status] ?? result.status;
     const timeSeconds = (result.metadata.executionTimeMs / 1000).toFixed(1);
-    let comment = `## \ud83e\udd16 GHAGGA Code Review\n\n`;
+    let comment = `${REVIEW_COMMENT_MARKER}\n## \ud83e\udd16 GHAGGA Code Review\n\n`;
     comment += `**Status:** ${status}\n`;
-    comment += `**Mode:** ${result.metadata.mode} | **Model:** ${result.metadata.model} | **Time:** ${timeSeconds}s\n\n`;
+    const modelsUsed = result.metadata.modelsUsed;
+    if (modelsUsed && modelsUsed.length > 1) {
+        // Multi-model: show primary model + details per specialist/stance
+        comment += `**Mode:** ${result.metadata.mode} | **Model:** ${result.metadata.model} | **Time:** ${timeSeconds}s\n`;
+        comment += `<details><summary>\ud83e\udde0 Models used (${modelsUsed.length})</summary>\n\n`;
+        comment += '| Role | Model |\n|------|-------|\n';
+        for (const entry of modelsUsed) {
+            const [role, model] = entry.includes(':') ? entry.split(':', 2) : ['—', entry];
+            comment += `| ${role} | \`${model}\` |\n`;
+        }
+        comment += '\n</details>\n';
+    }
+    else {
+        comment += `**Mode:** ${result.metadata.mode} | **Model:** ${result.metadata.model} | **Time:** ${timeSeconds}s\n`;
+    }
+    // Emoji stats bar (Enhancement 1)
+    if (options?.fileStats) {
+        const statsBar = buildStatsBar(options.fileStats);
+        if (statsBar) {
+            comment += `${statsBar}\n`;
+        }
+    }
+    comment += '\n';
     // Summary
     comment += `### Summary\n${result.summary}\n\n`;
     // Findings grouped by source
@@ -98,7 +261,16 @@ export function formatReviewComment(result) {
         }
         comment += '\n';
     }
+    // File category summary (Enhancement 3)
+    if (options?.fileList && options.fileList.length > 0) {
+        comment += formatFileCategorySummary(options.fileList);
+    }
     comment += `---\n*Powered by [GHAGGA](https://github.com/JNZader/ghagga) \u2014 AI Code Review*`;
+    // @mention the PR author so GitHub sends them a notification.
+    // Rendered as small text to keep the footer clean.
+    if (options?.prAuthor) {
+        comment += ` — @${options.prAuthor}`;
+    }
     return comment;
 }
 //# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/graph/blast-radius.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Blast-Radius Computation
+ *
+ * Given a dependency graph and a set of changed files, computes the
+ * "blast radius" — the set of files transitively affected by the changes.
+ *
+ * Uses BFS reverse traversal: for each changed file, find all files that
+ * import/call it, up to a configurable depth limit. Test files that depend
+ * on any impacted file are automatically included.
+ */
+import { type DependencyGraph } from './schema.js';
+export interface BlastRadiusOptions {
+    /** Maximum BFS traversal depth. Default: DEFAULT_TRAVERSAL_DEPTH (3) */
+    maxDepth?: number;
+    /** Maximum files before declaring "exceeded cap". Default: MAX_BLAST_RADIUS_FILES (50) */
+    maxFiles?: number;
+    /** Whether to include test files in the result. Default: true */
+    includeTests?: boolean;
+}
+export interface BlastRadiusResult {
+    /** All files in the blast radius (changed + dependents + tests) */
+    files: Set<string>;
+    /** Only the changed files from the input that exist in the graph */
+    changedFiles: string[];
+    /** Files that depend on changed files (not including the changed files themselves) */
+    dependents: string[];
+    /** Test files added to the blast radius */
+    testFiles: string[];
+    /** Max depth actually reached during BFS */
+    depth: number;
+    /** Whether the blast radius exceeded the file cap */
+    exceededCap: boolean;
+}
+/**
+ * Build a reverse adjacency map from the dependency graph.
+ *
+ * For each edge A → B (A imports B), creates a reverse edge B → A.
+ * This allows efficient lookup of "who depends on this file?"
+ * Also includes reverse edges for `calls[].target`.
+ */
+export declare function buildReverseIndex(graph: DependencyGraph): Map<string, Set<string>>;
+/**
+ * Compute the blast radius for a set of changed files.
+ *
+ * Algorithm:
+ * 1. Build reverse index (who depends on whom)
+ * 2. BFS from changed files through reverse dependencies, up to maxDepth
+ * 3. Collect test files that import any file in the blast radius
+ * 4. If total exceeds maxFiles, set exceededCap flag
+ *
+ * @param graph - The dependency graph
+ * @param changedFiles - File paths that were modified in the PR
+ * @param options - Traversal limits
+ * @returns BlastRadiusResult with all impacted files
+ */
+export declare function computeBlastRadius(graph: DependencyGraph, changedFiles: string[], options?: BlastRadiusOptions): BlastRadiusResult;
+//# sourceMappingURL=blast-radius.d.ts.map

package/dist/graph/blast-radius.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blast-radius.d.ts","sourceRoot":"","sources":["../../src/graph/blast-radius.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAA2B,KAAK,eAAe,EAA0B,MAAM,aAAa,CAAC;AAIpG,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,sFAAsF;IACtF,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IAEd,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;CACtB;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAsBlF;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,iBAAiB,CAoGnB"}

package/dist/graph/blast-radius.js

@@ -0,0 +1,145 @@
+/**
+ * Blast-Radius Computation
+ *
+ * Given a dependency graph and a set of changed files, computes the
+ * "blast radius" — the set of files transitively affected by the changes.
+ *
+ * Uses BFS reverse traversal: for each changed file, find all files that
+ * import/call it, up to a configurable depth limit. Test files that depend
+ * on any impacted file are automatically included.
+ */
+import { DEFAULT_TRAVERSAL_DEPTH, MAX_BLAST_RADIUS_FILES } from './schema.js';
+// ─── Reverse Index ──────────────────────────────────────────────
+/**
+ * Build a reverse adjacency map from the dependency graph.
+ *
+ * For each edge A → B (A imports B), creates a reverse edge B → A.
+ * This allows efficient lookup of "who depends on this file?"
+ * Also includes reverse edges for `calls[].target`.
+ */
+export function buildReverseIndex(graph) {
+    const reverseIndex = new Map();
+    for (const [filePath, node] of Object.entries(graph.nodes)) {
+        // Reverse edges for imports: if filePath imports target, then target → filePath
+        for (const importPath of node.imports) {
+            if (!reverseIndex.has(importPath)) {
+                reverseIndex.set(importPath, new Set());
+            }
+            reverseIndex.get(importPath).add(filePath);
+        }
+        // Reverse edges for calls: if filePath calls target, then target → filePath
+        for (const call of node.calls) {
+            if (!reverseIndex.has(call.target)) {
+                reverseIndex.set(call.target, new Set());
+            }
+            reverseIndex.get(call.target).add(filePath);
+        }
+    }
+    return reverseIndex;
+}
+// ─── BFS Computation ────────────────────────────────────────────
+/**
+ * Compute the blast radius for a set of changed files.
+ *
+ * Algorithm:
+ * 1. Build reverse index (who depends on whom)
+ * 2. BFS from changed files through reverse dependencies, up to maxDepth
+ * 3. Collect test files that import any file in the blast radius
+ * 4. If total exceeds maxFiles, set exceededCap flag
+ *
+ * @param graph - The dependency graph
+ * @param changedFiles - File paths that were modified in the PR
+ * @param options - Traversal limits
+ * @returns BlastRadiusResult with all impacted files
+ */
+export function computeBlastRadius(graph, changedFiles, options) {
+    const maxDepth = options?.maxDepth ?? DEFAULT_TRAVERSAL_DEPTH;
+    const maxFiles = options?.maxFiles ?? MAX_BLAST_RADIUS_FILES;
+    const includeTests = options?.includeTests ?? true;
+    // Handle empty input
+    if (changedFiles.length === 0) {
+        return {
+            files: new Set(),
+            changedFiles: [],
+            dependents: [],
+            testFiles: [],
+            depth: 0,
+            exceededCap: false,
+        };
+    }
+    const reverseIndex = buildReverseIndex(graph);
+    // Track all visited non-test nodes (for cycle detection and BFS)
+    const visited = new Set();
+    const dependentsSet = new Set();
+    const testFilesSet = new Set();
+    // Include changed files in visited (but not in dependents)
+    for (const file of changedFiles) {
+        visited.add(file);
+    }
+    // BFS traversal — only follows non-test files
+    // Test files are collected separately after BFS
+    let queue = [...changedFiles];
+    let actualDepth = 0;
+    for (let depth = 0; depth < maxDepth && queue.length > 0; depth++) {
+        const nextQueue = [];
+        for (const file of queue) {
+            const reverseDeps = reverseIndex.get(file);
+            if (!reverseDeps)
+                continue;
+            for (const dependent of reverseDeps) {
+                if (visited.has(dependent) || testFilesSet.has(dependent))
+                    continue;
+                const node = graph.nodes[dependent];
+                if (node?.isTest) {
+                    // Test files are collected but not traversed further
+                    if (includeTests) {
+                        testFilesSet.add(dependent);
+                    }
+                }
+                else {
+                    visited.add(dependent);
+                    dependentsSet.add(dependent);
+                    nextQueue.push(dependent);
+                }
+            }
+        }
+        if (nextQueue.length > 0) {
+            actualDepth = depth + 1;
+        }
+        queue = nextQueue;
+    }
+    // Post-BFS: find additional test files that import any file in the blast radius
+    // This catches tests that weren't direct reverse deps during BFS
+    if (includeTests) {
+        for (const file of visited) {
+            const reverseDeps = reverseIndex.get(file);
+            if (!reverseDeps)
+                continue;
+            for (const dependent of reverseDeps) {
+                if (visited.has(dependent) || testFilesSet.has(dependent))
+                    continue;
+                const node = graph.nodes[dependent];
+                if (node?.isTest) {
+                    testFilesSet.add(dependent);
+                }
+            }
+        }
+    }
+    // Build the full file set
+    const allFiles = new Set(visited);
+    for (const testFile of testFilesSet) {
+        allFiles.add(testFile);
+    }
+    const dependents = [...dependentsSet];
+    // Check cap
+    const exceededCap = allFiles.size > maxFiles;
+    return {
+        files: allFiles,
+        changedFiles: changedFiles.filter((f) => visited.has(f)),
+        dependents,
+        testFiles: [...testFilesSet],
+        depth: actualDepth,
+        exceededCap,
+    };
+}
+//# sourceMappingURL=blast-radius.js.map

package/dist/graph/blast-radius.js.map

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

package/dist/graph/builder.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Graph Builder
+ *
+ * Builds a DependencyGraph from a map of file paths → file content.
+ * Pure function: no filesystem access — the caller provides content.
+ *
+ * Two modes:
+ * - `buildGraph()` — full build from scratch
+ * - `buildGraphIncremental()` — updates only changed/deleted nodes
+ */
+import { type DependencyGraph, type SupportedLanguage } from './schema.js';
+/**
+ * Detect the language of a file based on its extension.
+ * Returns undefined for unsupported extensions.
+ */
+export declare function detectLanguage(filePath: string): SupportedLanguage | undefined;
+/**
+ * Check if a file path traverses any excluded directory.
+ */
+export declare function isExcludedPath(filePath: string): boolean;
+/**
+ * Resolve a relative import path to an absolute path within the project.
+ *
+ * Given the file doing the import and the import specifier, resolves
+ * to a project-relative path. Only resolves relative imports (starting
+ * with `.` or `..`). Non-relative imports (e.g., 'lodash') are returned
+ * as-is since they refer to external packages.
+ */
+export declare function resolveImportPath(importerPath: string, importSpecifier: string, availableFiles: Set<string>): string;
+/**
+ * Build a complete dependency graph from a map of file paths → file content.
+ *
+ * @param rootDir - Base directory for all paths (used in the graph metadata)
+ * @param files - Map of relative file paths to their content
+ * @returns Complete DependencyGraph
+ */
+export declare function buildGraph(rootDir: string, files: Map<string, string>): DependencyGraph;
+/**
+ * Update a dependency graph incrementally.
+ *
+ * Only re-processes changed files and removes deleted files.
+ * Unchanged files keep their existing nodes.
+ *
+ * @param existing - The existing dependency graph
+ * @param changedFiles - Map of changed file paths → new content
+ * @param deletedFiles - Array of file paths that were deleted
+ * @returns Updated DependencyGraph
+ */
+export declare function buildGraphIncremental(existing: DependencyGraph, changedFiles: Map<string, string>, deletedFiles: string[]): DependencyGraph;
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/graph/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EACL,KAAK,eAAe,EAMpB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAIrB;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAG9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGxD;AASD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,MAAM,CAmDR;AAID;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,CAkDvF;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,YAAY,EAAE,MAAM,EAAE,GACrB,eAAe,CAuDjB"}