diffintel 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# diffintel
+
+Experimantal(!) structural diff explainer for pull requests. Parses changed JS/TS files with Tree-sitter, detects structural changes (functions, classes, imports, exports), and uses an LLM to generate a concise explanation with risk assessment. Outputs a self-contained HTML report. Helpful for getting a concise explanation on diffs. Inspired by the hard-to-ingest-code-masses the ai-agents write.
+
+## Install
+
+```bash
+npm install -g diffintel
+```
+
+## Usage
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+diffintel explain --base main --out report.html
+```
+
+| Flag | Default | Description |
+|---|---|---|
+| `--base <ref>` | `origin/main` | Base git ref |
+| `--head <ref>` | `HEAD` | Head git ref |
+| `--out <file>` | `explain-report.html` | Output path |
+
+## GitHub Action
+
+```yaml
+name: PR Explain
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  explain:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm install -g diffintel
+      - name: Generate report
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+        run: diffintel explain --base origin/${{ github.base_ref }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: explain-report
+          path: explain-report.html
+```
+
+## Development
+
+```bash
+npm install
+npm test
+npx tsx src/cli.ts explain --base HEAD~3
+```

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const package_json_1 = __importDefault(require("../package.json"));
+commander_1.program
+    .name("diffintel")
+    .description("AI-powered structural diff explainer for pull requests")
+    .version(package_json_1.default.version);
+commander_1.program
+    .command("explain")
+    .description("Generate an HTML report explaining code changes between refs")
+    .option("--base <ref>", "Base ref to diff from (default: origin/main)")
+    .option("--head <ref>", "Head ref to diff to (default: HEAD)")
+    .option("--out <file>", "Output HTML file path (default: explain-report.html)")
+    .action(async (opts) => {
+    require("dotenv").config();
+    const { run } = require("./commands/explain");
+    const code = await run(opts);
+    process.exit(code);
+});
+commander_1.program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AACpC,mEAAkC;AAElC,mBAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,sBAAG,CAAC,OAAO,CAAC,CAAC;AAExB,mBAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,MAAM,CAAC,cAAc,EAAE,8CAA8C,CAAC;KACtE,MAAM,CAAC,cAAc,EAAE,qCAAqC,CAAC;KAC7D,MAAM,CAAC,cAAc,EAAE,sDAAsD,CAAC;KAC9E,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC;AAEL,mBAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/explain.d.ts

@@ -0,0 +1,7 @@
+interface ExplainOptions {
+    base?: string;
+    head?: string;
+    out?: string;
+}
+export declare function run(opts: ExplainOptions): Promise<number>;
+export {};

package/dist/commands/explain.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const fs_1 = __importDefault(require("fs"));
+const git_diff_1 = require("../explain/git-diff");
+const ast_diff_1 = require("../explain/ast-diff");
+const llm_explain_1 = require("../explain/llm-explain");
+const html_report_1 = require("../explain/html-report");
+async function run(opts) {
+    const baseRef = opts.base || "origin/main";
+    const headRef = opts.head || "HEAD";
+    const outFile = opts.out || "explain-report.html";
+    if (!process.env.ANTHROPIC_API_KEY) {
+        console.error("Error: ANTHROPIC_API_KEY environment variable is required.");
+        return 1;
+    }
+    try {
+        console.error(`Analyzing diff: ${baseRef}...${headRef}`);
+        const { files: fileDiffs, rawDiff } = (0, git_diff_1.getDiff)(baseRef, headRef);
+        if (fileDiffs.length === 0) {
+            console.error("No changes found between refs.");
+            return 0;
+        }
+        console.error(`Found ${fileDiffs.length} changed file(s). Analyzing...`);
+        const fileAnalyses = fileDiffs.map(ast_diff_1.analyzeFile);
+        const totalChanges = fileAnalyses.reduce((sum, f) => sum + f.structuralChanges.length, 0);
+        console.error(`Detected ${totalChanges} structural change(s). Calling LLM...`);
+        const explanation = await (0, llm_explain_1.explainChanges)(fileAnalyses, rawDiff);
+        const totalAdditions = fileDiffs.reduce((sum, f) => sum + f.additions, 0);
+        const totalDeletions = fileDiffs.reduce((sum, f) => sum + f.deletions, 0);
+        const report = {
+            generatedAt: new Date().toISOString(),
+            baseRef,
+            headRef,
+            summary: {
+                filesChanged: fileDiffs.length,
+                additions: totalAdditions,
+                deletions: totalDeletions,
+            },
+            explanation,
+            files: fileAnalyses,
+        };
+        const html = (0, html_report_1.renderReport)(report);
+        fs_1.default.writeFileSync(outFile, html, "utf-8");
+        console.error(`\nTitle: ${explanation.title}`);
+        console.error(`Files: ${fileDiffs.length} | +${totalAdditions} -${totalDeletions}`);
+        console.error(`Risks: ${explanation.risks.length > 0 ? explanation.risks.map((r) => `${r.level}: ${r.description}`).join("; ") : "none"}`);
+        console.error(`Tokens: ${explanation.tokenUsage.input} in / ${explanation.tokenUsage.output} out`);
+        console.error(`\nReport written to: ${outFile}`);
+        return 0;
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=explain.js.map

package/dist/commands/explain.js.map

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

package/dist/explain/ast-diff.d.ts

@@ -0,0 +1,10 @@
+import { FileDiff, FileAnalysis, ChangeType } from "./types";
+interface Declaration {
+    name: string;
+    type: ChangeType;
+    text: string;
+    startLine: number;
+}
+export declare function analyzeFile(diff: FileDiff): FileAnalysis;
+export declare function extractDeclarations(source: string, ext: string): Declaration[];
+export {};

package/dist/explain/ast-diff.js

@@ -0,0 +1,169 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeFile = analyzeFile;
+exports.extractDeclarations = extractDeclarations;
+const path_1 = __importDefault(require("path"));
+const parser_1 = require("../parsing/parser");
+const SUPPORTED_EXTS = new Set([".js", ".ts", ".tsx", ".jsx"]);
+function analyzeFile(diff) {
+    const ext = path_1.default.extname(diff.path);
+    if (!SUPPORTED_EXTS.has(ext)) {
+        return {
+            path: diff.path,
+            status: diff.status,
+            language: null,
+            structuralChanges: [],
+            rawDiff: diff.hunks,
+        };
+    }
+    const language = ext.replace(".", "");
+    const structuralChanges = [];
+    if (diff.status === "added" && diff.newContent) {
+        const decls = extractDeclarations(diff.newContent, ext);
+        for (const d of decls) {
+            structuralChanges.push({
+                file: diff.path,
+                type: d.type,
+                action: "added",
+                name: d.name,
+                startLine: d.startLine,
+            });
+        }
+    }
+    else if (diff.status === "deleted" && diff.oldContent) {
+        const decls = extractDeclarations(diff.oldContent, ext);
+        for (const d of decls) {
+            structuralChanges.push({
+                file: diff.path,
+                type: d.type,
+                action: "removed",
+                name: d.name,
+                startLine: d.startLine,
+            });
+        }
+    }
+    else if ((diff.status === "modified" || diff.status === "renamed") && diff.oldContent && diff.newContent) {
+        const oldDecls = extractDeclarations(diff.oldContent, ext);
+        const newDecls = extractDeclarations(diff.newContent, ext);
+        const oldMap = new Map(oldDecls.map((d) => [d.name, d]));
+        const newMap = new Map(newDecls.map((d) => [d.name, d]));
+        // Removed declarations
+        for (const [name, decl] of oldMap) {
+            if (!newMap.has(name)) {
+                structuralChanges.push({
+                    file: diff.path,
+                    type: decl.type,
+                    action: "removed",
+                    name,
+                    startLine: decl.startLine,
+                });
+            }
+        }
+        // Added or modified declarations
+        for (const [name, decl] of newMap) {
+            const old = oldMap.get(name);
+            if (!old) {
+                structuralChanges.push({
+                    file: diff.path,
+                    type: decl.type,
+                    action: "added",
+                    name,
+                    startLine: decl.startLine,
+                });
+            }
+            else if (old.text !== decl.text) {
+                structuralChanges.push({
+                    file: diff.path,
+                    type: decl.type,
+                    action: "modified",
+                    name,
+                    startLine: decl.startLine,
+                });
+            }
+        }
+    }
+    return {
+        path: diff.path,
+        status: diff.status,
+        language,
+        structuralChanges,
+        rawDiff: diff.hunks,
+    };
+}
+function extractDeclarations(source, ext) {
+    if (!source.trim())
+        return [];
+    const { tree } = (0, parser_1.parseSource)(source, ext);
+    const decls = [];
+    const root = tree.rootNode;
+    for (let i = 0; i < root.childCount; i++) {
+        const node = root.child(i);
+        const extracted = extractFromNode(node);
+        if (extracted) {
+            decls.push(...extracted);
+        }
+    }
+    return decls;
+}
+function extractFromNode(node) {
+    const type = node.type;
+    if (type === "function_declaration") {
+        const name = node.childForFieldName("name")?.text || "<anonymous>";
+        return [{ name, type: "function", text: node.text, startLine: node.startPosition.row + 1 }];
+    }
+    if (type === "class_declaration") {
+        const name = node.childForFieldName("name")?.text || "<anonymous>";
+        return [{ name, type: "class", text: node.text, startLine: node.startPosition.row + 1 }];
+    }
+    if (type === "import_statement") {
+        const source = node.childForFieldName("source")?.text || node.text;
+        return [{ name: source, type: "import", text: node.text, startLine: node.startPosition.row + 1 }];
+    }
+    if (type === "export_statement") {
+        // Named export with declaration inside
+        const decl = node.childForFieldName("declaration");
+        if (decl) {
+            const inner = extractFromNode(decl);
+            if (inner) {
+                return inner.map((d) => ({ ...d, type: "export" }));
+            }
+        }
+        const name = node.text.slice(0, 60);
+        return [{ name, type: "export", text: node.text, startLine: node.startPosition.row + 1 }];
+    }
+    if (type === "variable_declaration" || type === "lexical_declaration") {
+        const results = [];
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === "variable_declarator") {
+                const name = child.childForFieldName("name")?.text || "<unknown>";
+                // Check if value is an arrow function or function expression
+                const value = child.childForFieldName("value");
+                const isFn = value && (value.type === "arrow_function" || value.type === "function");
+                results.push({
+                    name,
+                    type: isFn ? "function" : "variable",
+                    text: node.text,
+                    startLine: node.startPosition.row + 1,
+                });
+            }
+        }
+        if (results.length)
+            return results;
+    }
+    // Expression statements like module.exports = ...
+    if (type === "expression_statement") {
+        const expr = node.child(0);
+        if (expr?.type === "assignment_expression") {
+            const left = expr.childForFieldName("left");
+            if (left?.text?.startsWith("module.exports")) {
+                return [{ name: "module.exports", type: "export", text: node.text, startLine: node.startPosition.row + 1 }];
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=ast-diff.js.map

package/dist/explain/ast-diff.js.map

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

package/dist/explain/git-diff.d.ts

@@ -0,0 +1,13 @@
+import { FileDiff } from "./types";
+/**
+ * Get the unified diff between two refs.
+ * If headRef is omitted, diffs against the working tree.
+ */
+export declare function getDiff(baseRef: string, headRef?: string): {
+    files: FileDiff[];
+    rawDiff: string;
+};
+/**
+ * Parse unified diff text into per-file FileDiff objects.
+ */
+export declare function parseDiffText(text: string): Array<Pick<FileDiff, "path" | "hunks" | "additions" | "deletions">>;

package/dist/explain/git-diff.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDiff = getDiff;
+exports.parseDiffText = parseDiffText;
+const child_process_1 = require("child_process");
+/**
+ * Get the unified diff between two refs.
+ * If headRef is omitted, diffs against the working tree.
+ */
+function getDiff(baseRef, headRef) {
+    const range = headRef ? `${baseRef}...${headRef}` : baseRef;
+    const nameStatus = (0, child_process_1.execSync)(`git diff --name-status ${range}`, { encoding: "utf-8" });
+    const rawDiff = (0, child_process_1.execSync)(`git diff ${range}`, { encoding: "utf-8" });
+    const fileStatuses = parseNameStatus(nameStatus);
+    const fileDiffs = parseDiffText(rawDiff);
+    // Merge name-status info with parsed diffs
+    const merged = [];
+    for (const fs of fileStatuses) {
+        const diff = fileDiffs.find((d) => d.path === fs.path) || {
+            path: fs.path,
+            hunks: "",
+            additions: 0,
+            deletions: 0,
+        };
+        const oldContent = fs.status !== "added"
+            ? getFileContent(baseRef, fs.oldPath || fs.path)
+            : undefined;
+        const newContent = fs.status !== "deleted"
+            ? getFileContent(headRef || "HEAD", fs.path)
+            : undefined;
+        merged.push({
+            path: fs.path,
+            oldPath: fs.oldPath,
+            status: fs.status,
+            hunks: diff.hunks,
+            oldContent,
+            newContent,
+            additions: diff.additions,
+            deletions: diff.deletions,
+        });
+    }
+    return { files: merged, rawDiff };
+}
+function parseNameStatus(text) {
+    const results = [];
+    for (const line of text.trim().split("\n")) {
+        if (!line.trim())
+            continue;
+        const parts = line.split("\t");
+        const code = parts[0].charAt(0);
+        if (code === "R") {
+            results.push({ path: parts[2], oldPath: parts[1], status: "renamed" });
+        }
+        else if (code === "A") {
+            results.push({ path: parts[1], status: "added" });
+        }
+        else if (code === "D") {
+            results.push({ path: parts[1], status: "deleted" });
+        }
+        else {
+            results.push({ path: parts[1], status: "modified" });
+        }
+    }
+    return results;
+}
+/**
+ * Parse unified diff text into per-file FileDiff objects.
+ */
+function parseDiffText(text) {
+    if (!text.trim())
+        return [];
+    const files = [];
+    // Split on diff headers
+    const parts = text.split(/^diff --git /m).filter(Boolean);
+    for (const part of parts) {
+        const lines = part.split("\n");
+        // First line: a/path b/path
+        const headerMatch = lines[0].match(/a\/(.+?) b\/(.+)/);
+        if (!headerMatch)
+            continue;
+        const path = headerMatch[2];
+        // Find the start of hunks (@@)
+        let hunkStart = 0;
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i].startsWith("@@")) {
+                hunkStart = i;
+                break;
+            }
+        }
+        const hunkLines = hunkStart > 0 ? lines.slice(hunkStart) : [];
+        const hunks = hunkLines.join("\n");
+        let additions = 0;
+        let deletions = 0;
+        for (const line of hunkLines) {
+            if (line.startsWith("+") && !line.startsWith("+++"))
+                additions++;
+            if (line.startsWith("-") && !line.startsWith("---"))
+                deletions++;
+        }
+        files.push({ path, hunks, additions, deletions });
+    }
+    return files;
+}
+function getFileContent(ref, filePath) {
+    try {
+        return (0, child_process_1.execSync)(`git show ${ref}:${filePath}`, { encoding: "utf-8" });
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=git-diff.js.map

package/dist/explain/git-diff.js.map

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

package/dist/explain/html-report.d.ts

@@ -0,0 +1,2 @@
+import { ExplainReport } from "./types";
+export declare function renderReport(report: ExplainReport): string;

package/dist/explain/html-report.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderReport = renderReport;
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+const STATUS_ICON = {
+    added: "&#43;", // +
+    modified: "&#9998;", // pencil
+    deleted: "&#10005;", // x
+    renamed: "&#8594;", // arrow
+};
+const ACTION_BADGE = {
+    added: { label: "added", color: "#22c55e" },
+    removed: { label: "removed", color: "#ef4444" },
+    modified: { label: "modified", color: "#f59e0b" },
+};
+const RISK_COLORS = {
+    low: { bg: "#dcfce7", text: "#166534" },
+    medium: { bg: "#fef3c7", text: "#92400e" },
+    high: { bg: "#fee2e2", text: "#991b1b" },
+};
+function renderReport(report) {
+    const { explanation, summary, files } = report;
+    const riskBadges = explanation.risks.length > 0
+        ? explanation.risks.map((r) => {
+            const c = RISK_COLORS[r.level] || RISK_COLORS.low;
+            return `<span style="display:inline-block;padding:2px 8px;border-radius:4px;font-size:13px;background:${c.bg};color:${c.text};margin-right:6px;">${r.level.toUpperCase()}: ${escapeHtml(r.description)}</span>`;
+        }).join("\n")
+        : '<span style="color:#166534;">No risks identified</span>';
+    const filesTable = files.map((f) => {
+        const icon = STATUS_ICON[f.status] || "";
+        const changeCount = f.structuralChanges.length;
+        return `<tr>
+      <td>${icon}</td>
+      <td style="font-family:monospace;font-size:13px;">${escapeHtml(f.path)}</td>
+      <td>${f.status}</td>
+      <td>${f.language || "—"}</td>
+      <td>${changeCount}</td>
+    </tr>`;
+    }).join("\n");
+    const fileDetails = files.map((f) => {
+        const changesList = f.structuralChanges.length > 0
+            ? "<ul style=\"margin:8px 0;padding-left:20px;\">" +
+                f.structuralChanges.map((c) => {
+                    const badge = ACTION_BADGE[c.action] || ACTION_BADGE.modified;
+                    return `<li><span style="display:inline-block;padding:1px 6px;border-radius:3px;font-size:11px;background:${badge.color};color:white;margin-right:4px;">${badge.label}</span> <code>${escapeHtml(c.name)}</code> <span style="color:#666;">(${c.type})</span></li>`;
+                }).join("\n") +
+                "</ul>"
+            : "<p style=\"color:#888;margin:8px 0;\">No structural changes detected</p>";
+        const diffBlock = f.rawDiff
+            ? `<pre style="background:#1e1e1e;color:#d4d4d4;padding:12px;border-radius:6px;overflow-x:auto;font-size:12px;line-height:1.5;margin:8px 0;">${colorDiff(f.rawDiff)}</pre>`
+            : "<p style=\"color:#888;\">No diff available</p>";
+        return `<details style="margin-bottom:12px;border:1px solid #e5e7eb;border-radius:8px;padding:0;">
+      <summary style="padding:10px 14px;cursor:pointer;font-family:monospace;font-size:14px;background:#f9fafb;border-radius:8px;">${STATUS_ICON[f.status] || ""} ${escapeHtml(f.path)} <span style="color:#888;">(${f.structuralChanges.length} changes)</span></summary>
+      <div style="padding:10px 14px;">
+        ${changesList}
+        ${diffBlock}
+      </div>
+    </details>`;
+    }).join("\n");
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(explanation.title)}</title>
+<style>
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; max-width: 900px; margin: 0 auto; padding: 24px; color: #1f2937; background: #fff; line-height: 1.6; }
+  h1 { font-size: 22px; margin-bottom: 6px; }
+  h2 { font-size: 16px; margin: 24px 0 10px; color: #374151; border-bottom: 1px solid #e5e7eb; padding-bottom: 6px; }
+  table { width: 100%; border-collapse: collapse; margin: 10px 0; }
+  th, td { text-align: left; padding: 6px 10px; border-bottom: 1px solid #f3f4f6; font-size: 13px; }
+  th { background: #f9fafb; font-weight: 600; }
+  .stats { display: flex; gap: 16px; margin: 12px 0; }
+  .stat { padding: 8px 14px; border-radius: 6px; background: #f3f4f6; font-size: 14px; }
+  .stat b { font-size: 18px; }
+  .meta { color: #6b7280; font-size: 12px; margin-bottom: 16px; }
+</style>
+</head>
+<body>
+  <h1>${escapeHtml(explanation.title)}</h1>
+  <div class="meta">${escapeHtml(report.baseRef)} &rarr; ${escapeHtml(report.headRef)} &middot; ${escapeHtml(report.generatedAt)}</div>
+
+  <div class="stats">
+    <div class="stat"><b>${summary.filesChanged}</b> files changed</div>
+    <div class="stat" style="color:#166534;"><b>+${summary.additions}</b> additions</div>
+    <div class="stat" style="color:#991b1b;"><b>-${summary.deletions}</b> deletions</div>
+  </div>
+
+  <h2>Description</h2>
+  <p style="margin:8px 0;">${escapeHtml(explanation.description)}</p>
+
+  <h2>Risk Assessment</h2>
+  <div style="margin:8px 0;">${riskBadges}</div>
+
+  <h2>Files Overview</h2>
+  <table>
+    <thead><tr><th></th><th>File</th><th>Status</th><th>Language</th><th>Changes</th></tr></thead>
+    <tbody>${filesTable}</tbody>
+  </table>
+
+  <h2>File Details</h2>
+  ${fileDetails}
+
+  <div style="margin-top:32px;padding-top:12px;border-top:1px solid #e5e7eb;color:#9ca3af;font-size:11px;">
+    Generated by intent-spec explain &middot; Tokens: ${explanation.tokenUsage.input} in / ${explanation.tokenUsage.output} out
+  </div>
+</body>
+</html>`;
+}
+function colorDiff(diff) {
+    return escapeHtml(diff)
+        .split("\n")
+        .map((line) => {
+        if (line.startsWith("+"))
+            return `<span style="color:#4ade80;">${line}</span>`;
+        if (line.startsWith("-"))
+            return `<span style="color:#f87171;">${line}</span>`;
+        if (line.startsWith("@@"))
+            return `<span style="color:#60a5fa;">${line}</span>`;
+        return line;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=html-report.js.map

package/dist/explain/html-report.js.map

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

package/dist/explain/llm-explain.d.ts

@@ -0,0 +1,2 @@
+import { FileAnalysis, LLMExplanation } from "./types";
+export declare function explainChanges(files: FileAnalysis[], rawDiff: string): Promise<LLMExplanation>;

package/dist/explain/llm-explain.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainChanges = explainChanges;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const SYSTEM_PROMPT = "You analyze code changes. Respond ONLY with valid JSON. Be extremely concise.";
+const ACTION_ICON = {
+    added: "+",
+    removed: "-",
+    modified: "~",
+};
+async function explainChanges(files, rawDiff) {
+    const structuralSummary = files
+        .filter((f) => f.structuralChanges.length > 0)
+        .map((f) => {
+        const changes = f.structuralChanges
+            .map((c) => `${ACTION_ICON[c.action]}${c.name} (${c.type})`)
+            .join(", ");
+        return `- ${f.path} (${f.status}): ${changes}`;
+    })
+        .join("\n");
+    // Truncate diff to ~4000 chars, prioritizing modified files
+    const truncatedDiff = truncateDiff(rawDiff, 4000);
+    const prompt = `## Structural changes
+${structuralSummary || "(no structural changes detected)"}
+
+## Diff (truncated)
+${truncatedDiff || "(empty diff)"}
+
+Respond with JSON:
+{ "title": "<60 char PR title>",
+  "description": "<2-4 sentences summarizing the changes>",
+  "risks": [{"level":"low|medium|high","description":"<one sentence>"}] }`;
+    const client = new sdk_1.default();
+    const message = await client.messages.create({
+        model: "claude-sonnet-4-5-20250929",
+        max_tokens: 512,
+        system: SYSTEM_PROMPT,
+        messages: [{ role: "user", content: prompt }],
+    });
+    const text = message.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("\n");
+    const tokenUsage = {
+        input: message.usage?.input_tokens || 0,
+        output: message.usage?.output_tokens || 0,
+    };
+    let parsed;
+    try {
+        const cleaned = text.replace(/^```json\s*/m, "").replace(/```\s*$/m, "").trim();
+        parsed = JSON.parse(cleaned);
+    }
+    catch {
+        // Fallback if LLM doesn't return valid JSON
+        parsed = {
+            title: "Code changes",
+            description: text.slice(0, 200),
+            risks: [{ level: "low", description: "LLM response was not valid JSON; showing raw text." }],
+        };
+    }
+    return {
+        title: parsed.title || "Code changes",
+        description: parsed.description || "",
+        risks: Array.isArray(parsed.risks) ? parsed.risks : [],
+        tokenUsage,
+    };
+}
+function truncateDiff(diff, maxLen) {
+    if (diff.length <= maxLen)
+        return diff;
+    // Split by file sections, keep as many as fit
+    const sections = diff.split(/^diff --git /m).filter(Boolean);
+    let result = "";
+    for (const section of sections) {
+        const chunk = `diff --git ${section}`;
+        if (result.length + chunk.length > maxLen) {
+            result += "\n... (diff truncated)";
+            break;
+        }
+        result += chunk;
+    }
+    return result || diff.slice(0, maxLen) + "\n... (truncated)";
+}
+//# sourceMappingURL=llm-explain.js.map

package/dist/explain/llm-explain.js.map

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

package/dist/explain/types.d.ts

@@ -0,0 +1,53 @@
+export type FileStatus = "added" | "modified" | "deleted" | "renamed";
+export interface FileDiff {
+    path: string;
+    oldPath?: string;
+    status: FileStatus;
+    hunks: string;
+    oldContent?: string;
+    newContent?: string;
+    additions: number;
+    deletions: number;
+}
+export type ChangeAction = "added" | "removed" | "modified";
+export type ChangeType = "function" | "import" | "export" | "class" | "variable" | "route" | "other";
+export interface StructuralChange {
+    file: string;
+    type: ChangeType;
+    action: ChangeAction;
+    name: string;
+    startLine?: number;
+    detail?: string;
+}
+export interface FileAnalysis {
+    path: string;
+    status: FileStatus;
+    language: string | null;
+    structuralChanges: StructuralChange[];
+    rawDiff: string;
+}
+export interface Risk {
+    level: "low" | "medium" | "high";
+    description: string;
+}
+export interface LLMExplanation {
+    title: string;
+    description: string;
+    risks: Risk[];
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+}
+export interface ExplainReport {
+    generatedAt: string;
+    baseRef: string;
+    headRef: string;
+    summary: {
+        filesChanged: number;
+        additions: number;
+        deletions: number;
+    };
+    explanation: LLMExplanation;
+    files: FileAnalysis[];
+}

package/dist/explain/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/explain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/explain/types.ts"],"names":[],"mappings":""}

package/dist/parsing/index.d.ts

@@ -0,0 +1,2 @@
+export { parseFile, parseSource, Query, language, getLanguageForExt } from "./parser";
+export type { Tree, SyntaxNode, QueryMatch, QueryCapture } from "./parser";

package/dist/parsing/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLanguageForExt = exports.language = exports.Query = exports.parseSource = exports.parseFile = void 0;
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseFile", { enumerable: true, get: function () { return parser_1.parseFile; } });
+Object.defineProperty(exports, "parseSource", { enumerable: true, get: function () { return parser_1.parseSource; } });
+Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return parser_1.Query; } });
+Object.defineProperty(exports, "language", { enumerable: true, get: function () { return parser_1.language; } });
+Object.defineProperty(exports, "getLanguageForExt", { enumerable: true, get: function () { return parser_1.getLanguageForExt; } });
+//# sourceMappingURL=index.js.map

package/dist/parsing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsing/index.ts"],"names":[],"mappings":";;;AAAA,mCAAsF;AAA7E,mGAAA,SAAS,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,+FAAA,KAAK,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,2GAAA,iBAAiB,OAAA"}

package/dist/parsing/parser.d.ts

@@ -0,0 +1,18 @@
+import Parser from "tree-sitter";
+export type { Parser };
+export type Tree = Parser.Tree;
+export type SyntaxNode = Parser.SyntaxNode;
+export type QueryMatch = Parser.QueryMatch;
+export type QueryCapture = Parser.QueryCapture;
+export declare const Query: typeof Parser.Query;
+/** Backward-compat export: the JavaScript language */
+export declare const language: Parser.Language;
+export declare function getLanguageForExt(ext: string): Parser.Language;
+export declare function parseSource(source: string, ext?: string): {
+    tree: Tree;
+    source: string;
+};
+export declare function parseFile(filePath: string): {
+    tree: Tree;
+    source: string;
+};

package/dist/parsing/parser.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.language = exports.Query = void 0;
+exports.getLanguageForExt = getLanguageForExt;
+exports.parseSource = parseSource;
+exports.parseFile = parseFile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const tree_sitter_1 = __importDefault(require("tree-sitter"));
+const tree_sitter_javascript_1 = __importDefault(require("tree-sitter-javascript"));
+const tree_sitter_typescript_1 = __importDefault(require("tree-sitter-typescript"));
+exports.Query = tree_sitter_1.default.Query;
+const jsLanguage = tree_sitter_javascript_1.default;
+const tsLanguage = tree_sitter_typescript_1.default.typescript;
+const tsxLanguage = tree_sitter_typescript_1.default.tsx;
+/** Backward-compat export: the JavaScript language */
+exports.language = jsLanguage;
+const parsers = new Map();
+function getParser(lang) {
+    let p = parsers.get(lang);
+    if (!p) {
+        p = new tree_sitter_1.default();
+        p.setLanguage(lang);
+        parsers.set(lang, p);
+    }
+    return p;
+}
+const extToLanguage = {
+    ".js": jsLanguage,
+    ".ts": tsLanguage,
+    ".tsx": tsxLanguage,
+};
+function getLanguageForExt(ext) {
+    return extToLanguage[ext] || jsLanguage;
+}
+function parseSource(source, ext = ".js") {
+    const lang = getLanguageForExt(ext);
+    const tree = getParser(lang).parse(source);
+    return { tree, source };
+}
+function parseFile(filePath) {
+    const source = fs_1.default.readFileSync(filePath, "utf-8");
+    const ext = path_1.default.extname(filePath);
+    return parseSource(source, ext);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parsing/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/parsing/parser.ts"],"names":[],"mappings":";;;;;;AAsCA,8CAEC;AAED,kCAOC;AAED,8BAIC;AAvDD,4CAAoB;AACpB,gDAAwB;AACxB,8DAAiC;AACjC,oFAAgD;AAChD,oFAAyD;AAO5C,QAAA,KAAK,GAAG,qBAAM,CAAC,KAAK,CAAC;AAElC,MAAM,UAAU,GAAG,gCAAwC,CAAC;AAC5D,MAAM,UAAU,GAAG,gCAAmB,CAAC,UAAwC,CAAC;AAChF,MAAM,WAAW,GAAG,gCAAmB,CAAC,GAAiC,CAAC;AAE1E,sDAAsD;AACzC,QAAA,QAAQ,GAAG,UAAU,CAAC;AAEnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEnD,SAAS,SAAS,CAAC,IAAqB;IACtC,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,GAAG,IAAI,qBAAM,EAAE,CAAC;QACjB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,aAAa,GAAoC;IACrD,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,SAAgB,iBAAiB,CAAC,GAAW;IAC3C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC;AAC1C,CAAC;AAED,SAAgB,WAAW,CACzB,MAAc,EACd,MAAc,KAAK;IAEnB,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,SAAgB,SAAS,CAAC,QAAgB;IACxC,MAAM,MAAM,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "diffintel",
+  "version": "0.1.0",
+  "description": "AI-powered structural diff explainer for pull requests",
+  "bin": {
+    "diffintel": "dist/cli.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "test": "tsc && node --import tsx --test test/unit/*.test.ts",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": ["diff", "pull-request", "code-review", "ast", "tree-sitter", "ai", "llm"],
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "commander": "^14.0.3",
+    "dotenv": "^17.2.4",
+    "tree-sitter": "^0.25.0",
+    "tree-sitter-javascript": "^0.25.0",
+    "tree-sitter-typescript": "^0.23.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.11",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}