@ryanstark24/sfgraph-server 1.1.0

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

@@ -0,0 +1,77 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { REL_TYPES, createFixture } from "./_fixture.js";
+import { callTool } from "./_runner.js";
+let fix;
+const DIFF = `--- a/force-app/main/default/classes/Target.cls
++++ b/force-app/main/default/classes/Target.cls
+@@
+`;
+beforeEach(async () => {
+    fix = await createFixture();
+    fix.addNode({ qualifiedName: "ApexClass:Target", label: "ApexClass" });
+    fix.addNode({ qualifiedName: "ApexClass:Caller", label: "ApexClass" });
+    fix.addNode({ qualifiedName: "ApexClass:Untested", label: "ApexClass" });
+    fix.addNode({ qualifiedName: "ApexClass:CallerTest", label: "ApexClass" });
+    fix.addEdge({
+        srcQualifiedName: "ApexClass:Caller",
+        dstQualifiedName: "ApexClass:Target",
+        relType: REL_TYPES.CALLS,
+    });
+    fix.addEdge({
+        srcQualifiedName: "ApexClass:Untested",
+        dstQualifiedName: "ApexClass:Target",
+        relType: REL_TYPES.CALLS,
+    });
+    fix.addEdge({
+        srcQualifiedName: "ApexClass:CallerTest",
+        dstQualifiedName: "ApexClass:Caller",
+        relType: REL_TYPES.IS_TEST_FOR,
+    });
+});
+afterEach(async () => {
+    await fix.cleanup();
+});
+describe("test_gap_intelligence_from_git_diff", () => {
+    it("finds Untested dependent", async () => {
+        const r = await callTool("test_gap_intelligence_from_git_diff", {
+            org: fix.orgId,
+            diff: DIFF,
+        });
+        const d = r.data;
+        expect(d.gaps).toContain("ApexClass:Untested");
+        expect(d.covered).toContain("ApexClass:Caller");
+    });
+    it("markdown lists gaps", async () => {
+        const r = await callTool("test_gap_intelligence_from_git_diff", {
+            org: fix.orgId,
+            diff: DIFF,
+        });
+        expect(r.markdown).toContain("Untested");
+    });
+    it("rejects empty diff", async () => {
+        await expect(callTool("test_gap_intelligence_from_git_diff", { org: fix.orgId, diff: "" })).rejects.toThrow();
+    });
+    it("rejects missing diff", async () => {
+        await expect(callTool("test_gap_intelligence_from_git_diff", { org: fix.orgId })).rejects.toThrow();
+    });
+    it("returns zero gaps for diff with no recognizable Salesforce files", async () => {
+        const r = await callTool("test_gap_intelligence_from_git_diff", {
+            org: fix.orgId,
+            diff: "--- a/README.md\n+++ b/README.md\n@@\n",
+        });
+        const d = r.data;
+        expect(d.gaps).toEqual([]);
+        expect(d.covered).toEqual([]);
+    });
+    it("counts each dependent exactly once even if multiple paths converge", async () => {
+        const r = await callTool("test_gap_intelligence_from_git_diff", {
+            org: fix.orgId,
+            diff: DIFF,
+        });
+        const d = r.data;
+        const all = [...d.gaps, ...d.covered];
+        const unique = new Set(all);
+        expect(unique.size).toBe(all.length);
+    });
+});
+//# sourceMappingURL=test_gap_intelligence.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,130 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { REL_TYPES, createFixture } from "./_fixture.js";
+import { callTool } from "./_runner.js";
+let fix;
+beforeEach(async () => {
+    fix = await createFixture();
+    fix.addNode({ qualifiedName: "ApexClass:A", label: "ApexClass" });
+    fix.addNode({ qualifiedName: "ApexClass:B", label: "ApexClass" });
+    fix.addNode({ qualifiedName: "ApexClass:C", label: "ApexClass" });
+    fix.addEdge({
+        srcQualifiedName: "ApexClass:A",
+        dstQualifiedName: "ApexClass:B",
+        relType: REL_TYPES.CALLS,
+    });
+    fix.addEdge({
+        srcQualifiedName: "ApexClass:B",
+        dstQualifiedName: "ApexClass:C",
+        relType: REL_TYPES.CALLS,
+    });
+});
+afterEach(async () => {
+    await fix.cleanup();
+});
+describe("trace_upstream / trace_downstream", () => {
+    it("upstream finds A from C", async () => {
+        const r = await callTool("trace_upstream", { org: fix.orgId, qname: "ApexClass:C" });
+        const d = r.data;
+        expect(d.nodes.map((n) => n.qualifiedName)).toContain("ApexClass:A");
+    });
+    it("downstream finds C from A", async () => {
+        const r = await callTool("trace_downstream", { org: fix.orgId, qname: "ApexClass:A" });
+        const d = r.data;
+        expect(d.nodes.map((n) => n.qualifiedName)).toContain("ApexClass:C");
+    });
+    it("upstream returns empty nodes for unknown qname", async () => {
+        const r = await callTool("trace_upstream", { org: fix.orgId, qname: "ApexClass:Phantom" });
+        const d = r.data;
+        expect(d.nodes).toEqual([]);
+    });
+    it("downstream returns empty nodes for isolated node", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:Island", label: "ApexClass" });
+        const r = await callTool("trace_downstream", { org: fix.orgId, qname: "ApexClass:Island" });
+        const d = r.data;
+        expect(d.nodes).toEqual([]);
+    });
+    it("respects depth=1 (only direct neighbor)", async () => {
+        const r = await callTool("trace_downstream", {
+            org: fix.orgId,
+            qname: "ApexClass:A",
+            depth: 1,
+        });
+        const d = r.data;
+        const names = d.nodes.map((n) => n.qualifiedName);
+        expect(names).toContain("ApexClass:B");
+        expect(names).not.toContain("ApexClass:C");
+    });
+    it("does not loop forever on cycles (upstream)", async () => {
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:C",
+            dstQualifiedName: "ApexClass:A",
+            relType: REL_TYPES.CALLS,
+        });
+        const r = await callTool("trace_upstream", {
+            org: fix.orgId,
+            qname: "ApexClass:A",
+            depth: 5,
+        });
+        const d = r.data;
+        const seen = new Set(d.nodes.map((n) => n.qualifiedName));
+        expect(seen.size).toBe(d.nodes.length);
+    });
+    it("rejects upstream depth>5", async () => {
+        await expect(callTool("trace_upstream", { org: fix.orgId, qname: "ApexClass:A", depth: 99 })).rejects.toThrow();
+    });
+    it("rejects downstream depth=0", async () => {
+        await expect(callTool("trace_downstream", { org: fix.orgId, qname: "ApexClass:A", depth: 0 })).rejects.toThrow();
+    });
+    it("rejects empty qname for upstream", async () => {
+        await expect(callTool("trace_upstream", { org: fix.orgId, qname: "" })).rejects.toThrow();
+    });
+    it("rejects missing qname for downstream", async () => {
+        await expect(callTool("trace_downstream", { org: fix.orgId })).rejects.toThrow();
+    });
+    it("walks a 5-hop deep chain end-to-end at depth=5", async () => {
+        for (const q of ["ApexClass:D", "ApexClass:E", "ApexClass:F"]) {
+            fix.addNode({ qualifiedName: q, label: "ApexClass" });
+        }
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:C",
+            dstQualifiedName: "ApexClass:D",
+            relType: REL_TYPES.CALLS,
+        });
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:D",
+            dstQualifiedName: "ApexClass:E",
+            relType: REL_TYPES.CALLS,
+        });
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:E",
+            dstQualifiedName: "ApexClass:F",
+            relType: REL_TYPES.CALLS,
+        });
+        const r = await callTool("trace_downstream", {
+            org: fix.orgId,
+            qname: "ApexClass:A",
+            depth: 5,
+        });
+        const names = r.data.nodes.map((n) => n.qualifiedName);
+        expect(names).toContain("ApexClass:F");
+    });
+    it("handles wide fan-out (1 source -> 50 children)", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:Hub", label: "ApexClass" });
+        for (let i = 0; i < 50; i++) {
+            fix.addNode({ qualifiedName: `ApexClass:Leaf${i}`, label: "ApexClass" });
+            fix.addEdge({
+                srcQualifiedName: "ApexClass:Hub",
+                dstQualifiedName: `ApexClass:Leaf${i}`,
+                relType: REL_TYPES.CALLS,
+            });
+        }
+        const r = await callTool("trace_downstream", {
+            org: fix.orgId,
+            qname: "ApexClass:Hub",
+            depth: 1,
+        });
+        const d = r.data;
+        expect(d.nodes.length).toBeGreaterThanOrEqual(50);
+    });
+});
+//# sourceMappingURL=trace.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,60 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { REL_TYPES, createFixture } from "./_fixture.js";
+import { callTool } from "./_runner.js";
+let fix;
+beforeEach(async () => {
+    fix = await createFixture();
+});
+afterEach(async () => {
+    await fix.cleanup();
+});
+describe("what_broke", () => {
+    it("returns no-baseline message when no snapshot exists", async () => {
+        const r = await callTool("what_broke", { org: fix.orgId });
+        expect(r.summary).toBe("no baseline snapshot");
+    });
+    it("reports zero changes when nothing changed", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:A", label: "ApexClass", sourceHash: "h1" });
+        // Create an "auto" snapshot via direct API
+        const auto = fix.ctx.snapshotStore.createSnapshot(fix.orgId, "pre-sync-x", true);
+        const r = await callTool("what_broke", { org: fix.orgId, since: auto.id });
+        expect(r.summary).toBe("no changes");
+    });
+    it("buckets covered vs at-risk dependents", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:Target", label: "ApexClass", sourceHash: "v1" });
+        fix.addNode({ qualifiedName: "ApexClass:Caller", label: "ApexClass" });
+        fix.addNode({ qualifiedName: "ApexClass:CallerTest", label: "ApexClass" });
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:Caller",
+            dstQualifiedName: "ApexClass:Target",
+            relType: REL_TYPES.CALLS,
+        });
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:CallerTest",
+            dstQualifiedName: "ApexClass:Caller",
+            relType: REL_TYPES.IS_TEST_FOR,
+        });
+        const snap = fix.ctx.snapshotStore.createSnapshot(fix.orgId, "pre-sync", true);
+        // Change Target
+        fix.addNode({ qualifiedName: "ApexClass:Target", label: "ApexClass", sourceHash: "v2" });
+        const r = await callTool("what_broke", { org: fix.orgId, since: snap.id });
+        const d = r.data;
+        expect(d.covered).toContain("ApexClass:Caller");
+        expect(d.atRisk.length).toBe(0);
+    });
+    it("at-risk when no test edge", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:T2", label: "ApexClass", sourceHash: "v1" });
+        fix.addNode({ qualifiedName: "ApexClass:C2", label: "ApexClass" });
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:C2",
+            dstQualifiedName: "ApexClass:T2",
+            relType: REL_TYPES.CALLS,
+        });
+        const snap = fix.ctx.snapshotStore.createSnapshot(fix.orgId, "pre-sync", true);
+        fix.addNode({ qualifiedName: "ApexClass:T2", label: "ApexClass", sourceHash: "v2" });
+        const r = await callTool("what_broke", { org: fix.orgId, since: snap.id });
+        const d = r.data;
+        expect(d.atRisk).toContain("ApexClass:C2");
+    });
+});
+//# sourceMappingURL=what_broke.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,173 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { REL_TYPES, createFixture } from "./_fixture.js";
+import { callTool } from "./_runner.js";
+let fix;
+let projectRoot;
+function w(rel, content) {
+    const abs = path.join(projectRoot, rel);
+    mkdirSync(path.dirname(abs), { recursive: true });
+    writeFileSync(abs, content, "utf8");
+}
+beforeEach(async () => {
+    fix = await createFixture();
+    projectRoot = mkdtempSync(path.join(tmpdir(), "sfg-wip-tool-"));
+    // WIP tools now require an sfdx-project.json at the root — without it
+    // resolveWipProjectRoot rejects the dir as "not a Salesforce DX project".
+    writeFileSync(path.join(projectRoot, "sfdx-project.json"), JSON.stringify({ packageDirectories: [{ path: "force-app", default: true }] }), "utf8");
+    // Seed: ApexClass:Foo and ApexClass:Bar with Bar extends Foo.
+    fix.addNode({
+        qualifiedName: "ApexClass:Foo",
+        label: "ApexClass",
+        sourceHash: "seed-foo",
+    });
+    fix.addNode({
+        qualifiedName: "ApexClass:Bar",
+        label: "ApexClass",
+        sourceHash: "seed-bar",
+    });
+    fix.addEdge({
+        srcQualifiedName: "ApexClass:Bar",
+        dstQualifiedName: "ApexClass:Foo",
+        relType: REL_TYPES.EXTENDS,
+    });
+    // Local Foo with different content -> "changed". And new Brand -> "added".
+    w("force-app/main/default/classes/Foo.cls", "public class Foo { Integer y; }");
+    w("force-app/main/default/classes/Brand.cls", "public class Brand {}");
+});
+afterEach(async () => {
+    await fix.cleanup();
+    rmSync(projectRoot, { recursive: true, force: true });
+});
+describe("wip_impact", () => {
+    it("returns changed + added qnames and mermaid", async () => {
+        const r = await callTool("wip_impact", {
+            org: fix.orgId,
+            project_root: projectRoot,
+        });
+        const d = r.data;
+        expect(d.changed).toContain("ApexClass:Foo");
+        expect(d.added).toContain("ApexClass:Brand");
+        expect(d.dependents.some((x) => x.qname === "ApexClass:Bar")).toBe(true);
+        expect(r.markdown).toContain("```mermaid");
+    });
+});
+describe("wip_diff", () => {
+    it("returns sets and no mermaid", async () => {
+        const r = await callTool("wip_diff", {
+            org: fix.orgId,
+            project_root: projectRoot,
+        });
+        expect(r.markdown).not.toContain("```mermaid");
+        const d = r.data;
+        expect(d.changed).toContain("ApexClass:Foo");
+        expect(d.added).toContain("ApexClass:Brand");
+    });
+});
+describe("wip_test_gap", () => {
+    it("filters to uncovered dependents", async () => {
+        const r = await callTool("wip_test_gap", {
+            org: fix.orgId,
+            project_root: projectRoot,
+        });
+        const d = r.data;
+        // Bar has no IS_TEST_FOR edge — so it's uncovered.
+        expect(d.uncovered.some((x) => x.qname === "ApexClass:Bar")).toBe(true);
+        expect(d.uncovered.every((x) => !x.coveredByTest)).toBe(true);
+    });
+    it("excludes dependents that have IS_TEST_FOR coverage", async () => {
+        fix.addNode({ qualifiedName: "ApexClass:BarTest", label: "ApexClass" });
+        fix.addEdge({
+            srcQualifiedName: "ApexClass:BarTest",
+            dstQualifiedName: "ApexClass:Bar",
+            relType: REL_TYPES.IS_TEST_FOR,
+        });
+        const r = await callTool("wip_test_gap", {
+            org: fix.orgId,
+            project_root: projectRoot,
+        });
+        const d = r.data;
+        expect(d.uncovered.some((x) => x.qname === "ApexClass:Bar")).toBe(false);
+    });
+    it("emits friendly markdown when no uncovered dependents", async () => {
+        const emptyRoot = mkdtempSync(path.join(tmpdir(), "sfg-wip-empty-"));
+        writeFileSync(path.join(emptyRoot, "sfdx-project.json"), JSON.stringify({ packageDirectories: [{ path: "force-app", default: true }] }), "utf8");
+        try {
+            const r = await callTool("wip_test_gap", {
+                org: fix.orgId,
+                project_root: emptyRoot,
+            });
+            expect(r.markdown).toContain("No uncovered dependents");
+        }
+        finally {
+            rmSync(emptyRoot, { recursive: true, force: true });
+        }
+    });
+});
+describe("wip schema validation", () => {
+    it("rejects invalid mode for wip_diff", async () => {
+        await expect(callTool("wip_diff", {
+            org: fix.orgId,
+            project_root: projectRoot,
+            mode: "everything",
+        })).rejects.toThrow();
+    });
+    it("rejects invalid mode for wip_impact", async () => {
+        await expect(callTool("wip_impact", {
+            org: fix.orgId,
+            project_root: projectRoot,
+            mode: "everything",
+        })).rejects.toThrow();
+    });
+    it("rejects out-of-range depth for wip_impact", async () => {
+        await expect(callTool("wip_impact", {
+            org: fix.orgId,
+            project_root: projectRoot,
+            depth: 99,
+        })).rejects.toThrow();
+    });
+    it("rejects out-of-range depth for wip_test_gap", async () => {
+        await expect(callTool("wip_test_gap", {
+            org: fix.orgId,
+            project_root: projectRoot,
+            depth: 0,
+        })).rejects.toThrow();
+    });
+    it("rejects empty project_root", async () => {
+        await expect(callTool("wip_diff", { org: fix.orgId, project_root: "" })).rejects.toThrow();
+    });
+    it("wip_diff returns empty sets when no local source tree present", async () => {
+        const bareRoot = mkdtempSync(path.join(tmpdir(), "sfg-wip-bare-"));
+        writeFileSync(path.join(bareRoot, "sfdx-project.json"), JSON.stringify({ packageDirectories: [{ path: "force-app", default: true }] }), "utf8");
+        try {
+            const r = await callTool("wip_diff", {
+                org: fix.orgId,
+                project_root: bareRoot,
+            });
+            const d = r.data;
+            expect(d.added).toEqual([]);
+            expect(d.changed).toEqual([]);
+        }
+        finally {
+            rmSync(bareRoot, { recursive: true, force: true });
+        }
+    });
+    it("rejects project_root without sfdx-project.json (security guard)", async () => {
+        const arbitraryRoot = mkdtempSync(path.join(tmpdir(), "sfg-wip-not-sfdx-"));
+        try {
+            await expect(callTool("wip_diff", { org: fix.orgId, project_root: arbitraryRoot })).rejects.toThrow(/not a Salesforce DX project/);
+        }
+        finally {
+            rmSync(arbitraryRoot, { recursive: true, force: true });
+        }
+    });
+    it("rejects nonexistent project_root", async () => {
+        await expect(callTool("wip_diff", {
+            org: fix.orgId,
+            project_root: "/this/path/does/not/exist/anywhere",
+        })).rejects.toThrow(/does not exist/);
+    });
+});
+//# sourceMappingURL=wip.test.js.map

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

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

package/dist/tools/_define.d.ts

@@ -0,0 +1,11 @@
+import type { ToolResponse } from "@ryanstark24/sfgraph-core";
+import { type ZodTypeAny, z } from "zod";
+export interface DefineToolSpec<S extends ZodTypeAny> {
+    name: string;
+    description: string;
+    inputSchema: S;
+    execute: (input: z.infer<S>) => Promise<ToolResponse<unknown>>;
+}
+export declare function defineTool<S extends ZodTypeAny>(spec: DefineToolSpec<S>): void;
+export { z };
+//# sourceMappingURL=_define.d.ts.map

package/dist/tools/_define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_define.d.ts","sourceRoot":"","sources":["../../src/tools/_define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIzC,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,UAAU;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;CAChE;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAuB9E;AAED,OAAO,EAAE,CAAC,EAAE,CAAC"}

package/dist/tools/_define.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { registerTool } from "../tool-registry.js";
+export function defineTool(spec) {
+    const jsonSchema = zodToJsonSchema(spec.inputSchema, {
+        name: spec.name,
+        target: "jsonSchema7",
+    });
+    let schemaObj = jsonSchema;
+    const defs = jsonSchema.definitions;
+    if (defs?.[spec.name]) {
+        schemaObj = defs[spec.name];
+    }
+    if (typeof schemaObj.type !== "string") {
+        schemaObj = { type: "object", ...schemaObj };
+    }
+    registerTool({
+        name: spec.name,
+        description: spec.description,
+        inputSchema: schemaObj,
+        async execute(raw) {
+            const parsed = spec.inputSchema.parse(raw);
+            const r = await spec.execute(parsed);
+            return r;
+        },
+    });
+}
+export { z };
+//# sourceMappingURL=_define.js.map

package/dist/tools/_define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_define.js","sourceRoot":"","sources":["../../src/tools/_define.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,CAAC,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASnD,MAAM,UAAU,UAAU,CAAuB,IAAuB;IACtE,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE;QACnD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IACH,IAAI,SAAS,GAA4B,UAAqC,CAAC;IAC/E,MAAM,IAAI,GAAI,UAAwD,CAAC,WAAW,CAAC;IACnF,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAA4B,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,SAAS,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC;IAC/C,CAAC;IACD,YAAY,CAAC;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,SAAS;QACtB,KAAK,CAAC,OAAO,CAAC,GAAG;YACf,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;YACzD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,CAAuC,CAAC;QACjD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,CAAC,EAAE,CAAC"}

package/dist/tools/_job-store.d.ts

@@ -0,0 +1,19 @@
+export type JobState = "queued" | "running" | "succeeded" | "failed";
+export interface IngestJob {
+    job_id: string;
+    state: JobState;
+    source: unknown;
+    mode: string;
+    queue_position: number;
+    started_at?: number;
+    finished_at?: number;
+    errors: string[];
+    progress: {
+        processed: number;
+        total: number;
+    };
+}
+export declare function enqueueJob(source: unknown, mode: string): IngestJob;
+export declare function getJob(id: string): IngestJob | undefined;
+export declare function _resetJobStore(): void;
+//# sourceMappingURL=_job-store.d.ts.map

package/dist/tools/_job-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_job-store.d.ts","sourceRoot":"","sources":["../../src/tools/_job-store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAKD,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAcnE;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAExD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/tools/_job-store.js

@@ -0,0 +1,26 @@
+import { randomUUID } from "node:crypto";
+const jobs = new Map();
+const queue = [];
+export function enqueueJob(source, mode) {
+    const id = `job_${randomUUID()}`;
+    const job = {
+        job_id: id,
+        state: "queued",
+        source,
+        mode,
+        queue_position: queue.length,
+        errors: [],
+        progress: { processed: 0, total: 0 },
+    };
+    jobs.set(id, job);
+    queue.push(id);
+    return job;
+}
+export function getJob(id) {
+    return jobs.get(id);
+}
+export function _resetJobStore() {
+    jobs.clear();
+    queue.length = 0;
+}
+//# sourceMappingURL=_job-store.js.map

package/dist/tools/_job-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_job-store.js","sourceRoot":"","sources":["../../src/tools/_job-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgBzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;AAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;AAE3B,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAY;IACtD,MAAM,EAAE,GAAG,OAAO,UAAU,EAAE,EAAE,CAAC;IACjC,MAAM,GAAG,GAAc;QACrB,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,QAAQ;QACf,MAAM;QACN,IAAI;QACJ,cAAc,EAAE,KAAK,CAAC,MAAM;QAC5B,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;KACrC,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;IACb,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACnB,CAAC"}

package/dist/tools/_project-root.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resolve and sanity-check a user-supplied `project_root` for the WIP tools.
+ *
+ * The WIP tools walk the local filesystem under `project_root`. Without a
+ * containment check, a malicious or careless caller can point them at `/`,
+ * `/etc`, or anywhere the user can read — turning local read-access into
+ * an MCP-mediated arbitrary-file read.
+ *
+ * This helper:
+ *   1. Resolves `project_root` to an absolute path via `path.resolve`.
+ *   2. Verifies the path exists and is a directory.
+ *   3. Requires an `sfdx-project.json` at the root (proof this is a real
+ *      Salesforce DX project, not `/home/victim`).
+ *   4. Returns the `realpath`-resolved root so downstream walkers operate
+ *      on a stable, symlink-resolved path.
+ *
+ * Throws `ConfigError` on any failure.
+ */
+export declare function resolveWipProjectRoot(rawProjectRoot: string): string;
+//# sourceMappingURL=_project-root.d.ts.map

package/dist/tools/_project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_project-root.d.ts","sourceRoot":"","sources":["../../src/tools/_project-root.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAsBpE"}