@ryanstark24/sfgraph-server 1.1.0

package/dist/tools/__tests__/dispatcher.test.js

@@ -0,0 +1,39 @@
+import { describe, expect, it } from "vitest";
+import { SfgraphMcpServer } from "../../server.js";
+describe("dispatcher (server.dispatch)", () => {
+    it("returns isError + UNKNOWN_TOOL for unregistered name", async () => {
+        const s = new SfgraphMcpServer();
+        await s.loadAllTools();
+        const r = await s.dispatch("does_not_exist", {});
+        expect(r.isError).toBe(true);
+        expect(r._meta?.code).toBe("UNKNOWN_TOOL");
+    });
+    it("surfaces INVALID_INPUT on ZodError", async () => {
+        const s = new SfgraphMcpServer();
+        await s.loadAllTools();
+        const r = await s.dispatch("start_ingest_job", { source: { type: "garbage" } });
+        expect(r.isError).toBe(true);
+        expect(r._meta?.code).toBe("INVALID_INPUT");
+    });
+    it("returns success envelope (no isError) on valid ping call", async () => {
+        const s = new SfgraphMcpServer();
+        await s.loadAllTools();
+        const r = await s.dispatch("ping", {});
+        expect(r.isError).toBeFalsy();
+    });
+    it("INVALID_INPUT when required field missing", async () => {
+        const s = new SfgraphMcpServer();
+        await s.loadAllTools();
+        const r = await s.dispatch("trace_upstream", { org: "x" }); // qname missing
+        expect(r.isError).toBe(true);
+        expect(r._meta?.code).toBe("INVALID_INPUT");
+    });
+    it("INVALID_INPUT when scalar fails refinement (depth out of range)", async () => {
+        const s = new SfgraphMcpServer();
+        await s.loadAllTools();
+        const r = await s.dispatch("trace_upstream", { org: "x", qname: "ApexClass:X", depth: 99 });
+        expect(r.isError).toBe(true);
+        expect(r._meta?.code).toBe("INVALID_INPUT");
+    });
+});
+//# sourceMappingURL=dispatcher.test.js.map

package/dist/tools/__tests__/dispatcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/dispatcher.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,CAAC,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,CAAC,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,CAAC,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,CAAC,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAgB;QAC5E,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,CAAC,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5F,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/__tests__/explain_code.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=explain_code.test.d.ts.map

package/dist/tools/__tests__/explain_code.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain_code.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/explain_code.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/explain_code.test.js

@@ -0,0 +1,88 @@
+import { asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { createFixture } from "./_fixture.js";
+import { callTool } from "./_runner.js";
+let fix;
+beforeEach(async () => {
+    fix = await createFixture();
+});
+afterEach(async () => {
+    await fix.cleanup();
+});
+function seedSnippet(f, qname, body, hash, explanation) {
+    f.ctx.graphStore.upsertSnippet({
+        orgId: f.orgId,
+        qualifiedName: asQualifiedName(qname),
+        sourceFormat: "apex",
+        sourceText: body,
+        sourceHash: asSha256(hash),
+        startLine: 1,
+        endLine: body.split("\n").length,
+    });
+    if (explanation) {
+        f.ctx.graphStore.updateSnippetExplanation(f.orgId, asQualifiedName(qname), explanation, Date.now());
+    }
+}
+describe("explain_code", () => {
+    it("returns sourceText for an existing snippet", async () => {
+        seedSnippet(fix, "ApexMethod:Foo.bar(0)", "return 1;", "h1");
+        const r = await callTool("explain_code", {
+            org: fix.orgId,
+            qname: "ApexMethod:Foo.bar(0)",
+        });
+        const d = r.data;
+        expect(d.sourceText).toBe("return 1;");
+        expect(d.cachedExplanation).toBeNull();
+        expect(r.markdown).toContain("```apex");
+    });
+    it("returns the cached explanation when one is stored", async () => {
+        seedSnippet(fix, "ApexMethod:Foo.bar(0)", "return 1;", "h1", "returns one");
+        const r = await callTool("explain_code", {
+            org: fix.orgId,
+            qname: "ApexMethod:Foo.bar(0)",
+        });
+        const d = r.data;
+        expect(d.cachedExplanation).toBe("returns one");
+    });
+    it("persists annotation and returns stored=true", async () => {
+        seedSnippet(fix, "ApexMethod:Foo.bar(0)", "return 1;", "h1");
+        const r = await callTool("explain_code", {
+            org: fix.orgId,
+            qname: "ApexMethod:Foo.bar(0)",
+            annotation: "explains the bar method",
+        });
+        const d = r.data;
+        expect(d.stored).toBe(true);
+        expect(d.cachedExplanation).toBe("explains the bar method");
+        // Verify persistence
+        const got = fix.ctx.graphStore.getSnippet(fix.orgId, asQualifiedName("ApexMethod:Foo.bar(0)"));
+        expect(got?.llmExplanation).toBe("explains the bar method");
+    });
+    it("returns a clear summary when qname has no snippet", async () => {
+        const r = await callTool("explain_code", {
+            org: fix.orgId,
+            qname: "CustomField:Account.Name",
+        });
+        const d = r.data;
+        expect(d.stored).toBe(false);
+        expect(d.sourceText).toBeNull();
+        expect(r.summary).toContain("no snippet stored");
+    });
+    it("overwrites a prior annotation when a new one is supplied", async () => {
+        seedSnippet(fix, "ApexMethod:Foo.baz(0)", "return 2;", "h2", "first explanation");
+        const r = await callTool("explain_code", {
+            org: fix.orgId,
+            qname: "ApexMethod:Foo.baz(0)",
+            annotation: "replacement explanation",
+        });
+        const d = r.data;
+        expect(d.cachedExplanation).toBe("replacement explanation");
+    });
+    it("rejects empty qname", async () => {
+        await expect(callTool("explain_code", { org: fix.orgId, qname: "" })).rejects.toThrow();
+    });
+    it("rejects missing qname", async () => {
+        await expect(callTool("explain_code", { org: fix.orgId })).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=explain_code.test.js.map

package/dist/tools/__tests__/explain_code.test.js.map

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

package/dist/tools/__tests__/freshness_report.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=freshness_report.test.d.ts.map

package/dist/tools/__tests__/freshness_report.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness_report.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/freshness_report.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/freshness_report.test.js

@@ -0,0 +1,103 @@
+import { asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { createFixture } from "./_fixture.js";
+import { callTool } from "./_runner.js";
+let fix;
+beforeEach(async () => {
+    fix = await createFixture();
+});
+afterEach(async () => {
+    await fix.cleanup();
+});
+describe("freshness_report", () => {
+    it("buckets a hot and a dead node", async () => {
+        const now = Date.now();
+        fix.addNode({
+            qualifiedName: "ApexClass:Recent",
+            label: "ApexClass",
+            lastModifiedAt: now,
+        });
+        fix.addNode({
+            qualifiedName: "ApexClass:Ancient",
+            label: "ApexClass",
+            lastModifiedAt: now - 1000 * 60 * 60 * 24 * 1000,
+        });
+        const r = await callTool("freshness_report", { org: fix.orgId });
+        const d = r.data;
+        expect((d.buckets.hot?.length ?? 0) + (d.buckets.current?.length ?? 0)).toBeGreaterThanOrEqual(1);
+        expect(d.buckets.dead?.length ?? 0).toBeGreaterThanOrEqual(1);
+    });
+    it("surfaces truncated=false on small fixtures (P2)", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:X", label: "ApexClass" });
+        const r = await callTool("freshness_report", { org: fix.orgId });
+        expect(r.data.truncated).toBe(false);
+    });
+    it("respects bucket filter", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:X", label: "ApexClass" });
+        const r = await callTool("freshness_report", { org: fix.orgId, bucket: "hot" });
+        expect(r.markdown).toContain("hot");
+        expect(r.markdown).not.toContain("### dead");
+    });
+    it("returns all-empty buckets for empty graph", async () => {
+        const r = await callTool("freshness_report", { org: fix.orgId });
+        const d = r.data;
+        expect(d.buckets.hot?.length ?? 0).toBe(0);
+        expect(d.buckets.current?.length ?? 0).toBe(0);
+        expect(d.buckets.stale?.length ?? 0).toBe(0);
+        expect(d.buckets.dead?.length ?? 0).toBe(0);
+    });
+    it("rejects invalid bucket value", async () => {
+        await expect(callTool("freshness_report", { org: fix.orgId, bucket: "lukewarm" })).rejects.toThrow();
+    });
+    it("rejects empty org", async () => {
+        await expect(callTool("freshness_report", { org: "" })).rejects.toThrow();
+    });
+    it("accepts each valid bucket without throwing", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:Y", label: "ApexClass" });
+        for (const b of ["stale", "hot", "dead", "current"]) {
+            const r = await callTool("freshness_report", { org: fix.orgId, bucket: b });
+            expect(r.summary).toContain(b);
+        }
+    });
+    it("flags truncated=true when a label exceeds the 5000-node cap", async () => {
+        const facts = [];
+        for (let i = 0; i < 5001; i++) {
+            facts.push({
+                orgId: fix.orgId,
+                qualifiedName: asQualifiedName(`ApexClass:Bulk${i}`),
+                label: "ApexClass",
+                attributes: {},
+                sourceHash: asSha256(`h-${i}`),
+                firstSeenAt: 1,
+                lastSeenAt: 1,
+                lastModifiedAt: Date.now(),
+            });
+        }
+        fix.ctx.graphStore.mergeNodes(facts);
+        const r = await callTool("freshness_report", { org: fix.orgId });
+        expect(r.data.truncated).toBe(true);
+        expect(r.markdown).toContain("incomplete");
+    });
+    it("each bucket is sorted+capped at 20 rows", async () => {
+        const facts = [];
+        for (let i = 0; i < 100; i++) {
+            facts.push({
+                orgId: fix.orgId,
+                qualifiedName: asQualifiedName(`ApexClass:H${i}`),
+                label: "ApexClass",
+                attributes: {},
+                sourceHash: asSha256(`h-${i}`),
+                firstSeenAt: 1,
+                lastSeenAt: 1,
+                lastModifiedAt: Date.now(),
+            });
+        }
+        fix.ctx.graphStore.mergeNodes(facts);
+        const r = await callTool("freshness_report", { org: fix.orgId });
+        const d = r.data;
+        for (const k of Object.keys(d.buckets)) {
+            expect((d.buckets[k] ?? []).length).toBeLessThanOrEqual(20);
+        }
+    });
+});
+//# sourceMappingURL=freshness_report.test.js.map

package/dist/tools/__tests__/freshness_report.test.js.map

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

package/dist/tools/__tests__/get_ingest_job.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get_ingest_job.test.d.ts.map

package/dist/tools/__tests__/get_ingest_job.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_ingest_job.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/get_ingest_job.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/get_ingest_job.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { _resetJobStore } from "../_job-store.js";
+import { callTool } from "./_runner.js";
+describe("get_ingest_job", () => {
+    it("returns not-found for unknown id", async () => {
+        _resetJobStore();
+        const r = await callTool("get_ingest_job", { job_id: "job_does_not_exist" });
+        expect(r.data.found).toBe(false);
+    });
+    it("returns the job after a manual enqueue (job store still functions even though start_ingest_job no longer writes to it)", async () => {
+        _resetJobStore();
+        const { enqueueJob } = await import("../_job-store.js");
+        const job = enqueueJob({ type: "filesystem", path: "/tmp/x" }, "auto");
+        const r = await callTool("get_ingest_job", { job_id: job.job_id });
+        expect(r.data.job_id).toBe(job.job_id);
+    });
+    it("rejects empty job_id", async () => {
+        _resetJobStore();
+        await expect(callTool("get_ingest_job", { job_id: "" })).rejects.toThrow();
+    });
+    it("rejects missing job_id", async () => {
+        _resetJobStore();
+        await expect(callTool("get_ingest_job", {})).rejects.toThrow();
+    });
+    it("distinguishes between multiple jobs", async () => {
+        _resetJobStore();
+        const { enqueueJob } = await import("../_job-store.js");
+        const j1 = enqueueJob({ type: "filesystem", path: "/tmp/a" }, "auto");
+        const j2 = enqueueJob({ type: "filesystem", path: "/tmp/b" }, "auto");
+        expect(j1.job_id).not.toBe(j2.job_id);
+        const r1 = await callTool("get_ingest_job", { job_id: j1.job_id });
+        const r2 = await callTool("get_ingest_job", { job_id: j2.job_id });
+        expect(r1.data.job_id).toBe(j1.job_id);
+        expect(r2.data.job_id).toBe(j2.job_id);
+    });
+    it("includes summary text identifying the unknown id", async () => {
+        _resetJobStore();
+        const r = await callTool("get_ingest_job", { job_id: "job_phantom" });
+        expect(r.summary).toContain("job_phantom");
+    });
+});
+//# sourceMappingURL=get_ingest_job.test.js.map

package/dist/tools/__tests__/get_ingest_job.test.js.map

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

package/dist/tools/__tests__/governor_risk_check.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=governor_risk_check.test.d.ts.map

package/dist/tools/__tests__/governor_risk_check.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governor_risk_check.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/governor_risk_check.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/governor_risk_check.test.js

@@ -0,0 +1,66 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { createFixture } from "./_fixture.js";
+import { callTool } from "./_runner.js";
+let fix;
+beforeEach(async () => {
+    fix = await createFixture();
+});
+afterEach(async () => {
+    await fix.cleanup();
+});
+describe("governor_risk_check", () => {
+    it("empty when no attributes hint", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:Clean", label: "ApexClass" });
+        const r = await callTool("governor_risk_check", { org: fix.orgId });
+        expect(r.data.risks.length).toBe(0);
+    });
+    it("flags soql_in_loop attribute", async () => {
+        fix.addNode({
+            qualifiedName: "ApexClass:Risky",
+            label: "ApexClass",
+            attributes: { hasSoqlInLoop: true },
+        });
+        const r = await callTool("governor_risk_check", { org: fix.orgId });
+        const risks = r.data.risks;
+        expect(risks.some((x) => x.qualifiedName === "ApexClass:Risky")).toBe(true);
+    });
+    it("returns no-risks summary for empty graph", async () => {
+        const r = await callTool("governor_risk_check", { org: fix.orgId });
+        expect(r.summary).toBe("no risks detected");
+        expect(r.data.risks).toEqual([]);
+    });
+    it("flags dml_in_loop attribute", async () => {
+        fix.addNode({
+            qualifiedName: "ApexClass:DmlLoop",
+            label: "ApexClass",
+            attributes: { hasDmlInLoop: true },
+        });
+        const r = await callTool("governor_risk_check", { org: fix.orgId });
+        const risks = r.data.risks;
+        expect(risks.some((x) => x.qualifiedName === "ApexClass:DmlLoop")).toBe(true);
+    });
+    it("flags multiple classes independently", async () => {
+        fix.addNode({
+            qualifiedName: "ApexClass:R1",
+            label: "ApexClass",
+            attributes: { hasSoqlInLoop: true },
+        });
+        fix.addNode({
+            qualifiedName: "ApexClass:R2",
+            label: "ApexClass",
+            attributes: { hasDmlInLoop: true },
+        });
+        const r = await callTool("governor_risk_check", { org: fix.orgId });
+        const risks = r.data.risks;
+        expect(risks.length).toBeGreaterThanOrEqual(2);
+    });
+    it("rejects empty org", async () => {
+        await expect(callTool("governor_risk_check", { org: "" })).rejects.toThrow();
+    });
+    it("reports cached=false when no cache table is present", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:X", label: "ApexClass" });
+        const r = await callTool("governor_risk_check", { org: fix.orgId });
+        expect(r.data.cached).toBe(false);
+    });
+});
+//# sourceMappingURL=governor_risk_check.test.js.map

package/dist/tools/__tests__/governor_risk_check.test.js.map

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

package/dist/tools/__tests__/impact_from_git_diff.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=impact_from_git_diff.test.d.ts.map

package/dist/tools/__tests__/impact_from_git_diff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact_from_git_diff.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/impact_from_git_diff.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/impact_from_git_diff.test.js

@@ -0,0 +1,115 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { REL_TYPES, createFixture } from "./_fixture.js";
+import { callTool } from "./_runner.js";
+let fix;
+const DIFF = `diff --git a/force-app/main/default/classes/Foo.cls b/force-app/main/default/classes/Foo.cls
+--- a/force-app/main/default/classes/Foo.cls
++++ b/force-app/main/default/classes/Foo.cls
+@@ -1 +1 @@
+-old
++new
+`;
+beforeEach(async () => {
+    fix = await createFixture();
+    fix.addNode({ qualifiedName: "ApexClass:Foo", label: "ApexClass" });
+    fix.addNode({ qualifiedName: "ApexClass:Bar", label: "ApexClass" });
+    fix.addEdge({
+        srcQualifiedName: "ApexClass:Bar",
+        dstQualifiedName: "ApexClass:Foo",
+        relType: REL_TYPES.CALLS,
+    });
+});
+afterEach(async () => {
+    await fix.cleanup();
+});
+describe("impact_from_git_diff", () => {
+    it("finds upstream dependents from diff", async () => {
+        const r = await callTool("impact_from_git_diff", { org: fix.orgId, diff: DIFF });
+        const d = r.data;
+        expect(d.impacted).toContain("ApexClass:Bar");
+    });
+    it("includes seed in summary", async () => {
+        const r = await callTool("impact_from_git_diff", { org: fix.orgId, diff: DIFF });
+        expect(r.summary).toMatch(/from 1 changed/);
+    });
+    it("rejects depth out of range", async () => {
+        await expect(callTool("impact_from_git_diff", { org: fix.orgId, diff: DIFF, depth: 99 })).rejects.toThrow();
+    });
+    it("rejects depth below minimum (0)", async () => {
+        await expect(callTool("impact_from_git_diff", { org: fix.orgId, diff: DIFF, depth: 0 })).rejects.toThrow();
+    });
+    it("rejects non-integer depth", async () => {
+        await expect(callTool("impact_from_git_diff", { org: fix.orgId, diff: DIFF, depth: 2.5 })).rejects.toThrow();
+    });
+    it("rejects empty diff", async () => {
+        await expect(callTool("impact_from_git_diff", { org: fix.orgId, diff: "" })).rejects.toThrow();
+    });
+    it("rejects missing diff", async () => {
+        await expect(callTool("impact_from_git_diff", { org: fix.orgId })).rejects.toThrow();
+    });
+    it("returns zero impacted when diff parses to no Salesforce paths", async () => {
+        const nonSfDiff = `diff --git a/README.md b/README.md
+--- a/README.md
++++ b/README.md
+@@ -1 +1 @@
+-old
++new
+`;
+        const r = await callTool("impact_from_git_diff", { org: fix.orgId, diff: nonSfDiff });
+        const d = r.data;
+        expect(d.seedQnames).toEqual([]);
+        expect(d.impacted).toEqual([]);
+    });
+    it("returns the seed itself when the changed file has no dependents", async () => {
+        const isolatedDiff = `diff --git a/force-app/main/default/classes/Bar.cls b/force-app/main/default/classes/Bar.cls
+--- a/force-app/main/default/classes/Bar.cls
++++ b/force-app/main/default/classes/Bar.cls
+@@ -1 +1 @@
+-x
++y
+`;
+        const r = await callTool("impact_from_git_diff", { org: fix.orgId, diff: isolatedDiff });
+        const d = r.data;
+        expect(d.impacted).toContain("ApexClass:Bar");
+    });
+    it("aggregates seeds across a multi-file diff", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:Baz", label: "ApexClass" });
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:Baz",
+            dstQualifiedName: "ApexClass:Foo",
+            relType: REL_TYPES.CALLS,
+        });
+        const multi = `diff --git a/force-app/main/default/classes/Foo.cls b/force-app/main/default/classes/Foo.cls
+--- a/force-app/main/default/classes/Foo.cls
++++ b/force-app/main/default/classes/Foo.cls
+@@ -1 +1 @@
+-a
++b
+diff --git a/force-app/main/default/classes/Bar.cls b/force-app/main/default/classes/Bar.cls
+--- a/force-app/main/default/classes/Bar.cls
++++ b/force-app/main/default/classes/Bar.cls
+@@ -1 +1 @@
+-x
++y
+`;
+        const r = await callTool("impact_from_git_diff", { org: fix.orgId, diff: multi });
+        const d = r.data;
+        expect(d.seedQnames.length).toBe(2);
+        expect(d.impacted).toContain("ApexClass:Baz");
+        expect(r.summary).toMatch(/from 2 changed/);
+    });
+    it("respects custom depth=1 vs depth=3", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:Baz", label: "ApexClass" });
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:Baz",
+            dstQualifiedName: "ApexClass:Bar",
+            relType: REL_TYPES.CALLS,
+        });
+        const r1 = await callTool("impact_from_git_diff", { org: fix.orgId, diff: DIFF, depth: 1 });
+        const r3 = await callTool("impact_from_git_diff", { org: fix.orgId, diff: DIFF, depth: 3 });
+        const d1 = r1.data;
+        const d3 = r3.data;
+        expect(d3.impacted.length).toBeGreaterThanOrEqual(d1.impacted.length);
+    });
+});
+//# sourceMappingURL=impact_from_git_diff.test.js.map

package/dist/tools/__tests__/impact_from_git_diff.test.js.map

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

package/dist/tools/__tests__/list_orgs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=list_orgs.test.d.ts.map

package/dist/tools/__tests__/list_orgs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_orgs.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/list_orgs.test.ts"],"names":[],"mappings":""}