@ryanstark24/sfgraph-server 1.1.0

package/dist/tools/start_ingest_job.js

@@ -0,0 +1,83 @@
+import { validateOrgIdentifier } from "@ryanstark24/sfgraph-shared";
+import { defineTool, z } from "./_define.js";
+// Reject all C0 control characters (0x00-0x1F) and DEL (0x7F). Built from
+// a code-point check so the source file stays clean of literal control bytes.
+function hasControlChar(s) {
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c < 0x20 || c === 0x7f)
+            return true;
+    }
+    return false;
+}
+const sourceSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("live-org"),
+        alias: z
+            .string()
+            .min(1)
+            .refine((s) => {
+            try {
+                validateOrgIdentifier(s);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }, { message: "alias must be a Salesforce 15/18-char id or a safe alias" }),
+    }),
+    z.object({
+        type: z.literal("filesystem"),
+        // Reject control chars / newlines outright. The CLI command we render
+        // is meant to be copy-pasted; a path containing a newline or a NUL
+        // could splice a second shell command into the agent's clipboard.
+        path: z
+            .string()
+            .min(1)
+            .refine((p) => !hasControlChar(p), { message: "path contains control characters" }),
+    }),
+]);
+const inputSchema = z.object({
+    source: sourceSchema,
+    mode: z.enum(["full", "incremental", "auto"]).default("auto"),
+});
+/**
+ * POSIX single-quote shell escape. Wraps the value in `'...'`, replacing
+ * embedded single quotes with `'\''`. Safe to copy-paste into bash/zsh.
+ */
+function shellQuotePosix(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+// Stays in the registry so agents can `tools/list` and discover the right
+// out-of-band call to make, but refuses to enqueue. The previous version
+// returned a fake queued record that would never advance — agents would
+// poll `get_ingest_job` forever waiting for a worker that doesn't exist.
+defineTool({
+    name: "start_ingest_job",
+    description: "RETURNS INSTRUCTIONS ONLY. The MCP server does NOT run ingest workers. To actually ingest, run `sfgraph ingest --org <alias>` in a shell. Calling this tool now returns the exact shell command to run rather than enqueueing a phantom job.",
+    inputSchema,
+    async execute(input) {
+        const aliasHint = input.source.type === "live-org" ? input.source.alias : null;
+        const cmd = input.source.type === "live-org"
+            ? // Alias already validated by validateOrgIdentifier; safe to interpolate.
+                `sfgraph ingest --org ${input.source.alias}${input.mode !== "auto" ? ` --mode ${input.mode}` : ""}`
+            : // Path may contain spaces / shell metacharacters — quote it.
+                `sfgraph ingest --from-fs ${shellQuotePosix(input.source.path)}`;
+        return {
+            summary: "ingest must run out-of-band",
+            markdown: [
+                "> **The MCP server cannot start ingests itself.** Run the command below in a shell.",
+                "",
+                "```bash",
+                cmd,
+                "```",
+                "",
+                aliasHint
+                    ? `When it completes, MCP tools like \`trace_upstream\` / \`what_broke\` against \`${aliasHint}\` will see the new data.`
+                    : "When it completes, MCP tools will see the new data on next invocation.",
+            ].join("\n"),
+            data: { executed: false, run_this_command: cmd },
+        };
+    },
+});
+//# sourceMappingURL=start_ingest_job.js.map

package/dist/tools/start_ingest_job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start_ingest_job.js","sourceRoot":"","sources":["../../src/tools/start_ingest_job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAE7C,0EAA0E;AAC1E,8EAA8E;AAC9E,SAAS,cAAc,CAAC,CAAS;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAChD,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3B,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,MAAM,CACL,CAAC,CAAC,EAAE,EAAE;YACJ,IAAI,CAAC;gBACH,qBAAqB,CAAC,CAAC,CAAC,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,EACD,EAAE,OAAO,EAAE,0DAA0D,EAAE,CACxE;KACJ,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;QAC7B,sEAAsE;QACtE,mEAAmE;QACnE,kEAAkE;QAClE,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;KACtF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CAC9D,CAAC,CAAC;AAEH;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,0EAA0E;AAC1E,yEAAyE;AACzE,wEAAwE;AACxE,yEAAyE;AACzE,UAAU,CAAC;IACT,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,8OAA8O;IAChP,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,MAAM,GAAG,GACP,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;YAC9B,CAAC,CAAC,yEAAyE;gBACzE,wBAAwB,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACrG,CAAC,CAAC,6DAA6D;gBAC7D,4BAA4B,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE;gBACR,qFAAqF;gBACrF,EAAE;gBACF,SAAS;gBACT,GAAG;gBACH,KAAK;gBACL,EAAE;gBACF,SAAS;oBACP,CAAC,CAAC,mFAAmF,SAAS,2BAA2B;oBACzH,CAAC,CAAC,wEAAwE;aAC7E,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE;SACjD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/test_gap_intelligence_from_git_diff.d.ts

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

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

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

package/dist/tools/test_gap_intelligence_from_git_diff.js

@@ -0,0 +1,50 @@
+import { analyze } from "@ryanstark24/sfgraph-core";
+import { asQualifiedName } from "@ryanstark24/sfgraph-shared";
+import { getToolContext } from "../context.js";
+import { defineTool, z } from "./_define.js";
+const inputSchema = z.object({
+    org: z.string().min(1),
+    diff: z.string().min(1),
+});
+defineTool({
+    name: "test_gap_intelligence_from_git_diff",
+    description: "List dependents of a git diff that have no test coverage.",
+    inputSchema,
+    async execute(input) {
+        const ctx = await getToolContext({ orgId: input.org });
+        const files = analyze.parseUnifiedDiff(input.diff);
+        const seedQnames = [];
+        for (const f of files) {
+            const qn = analyze.pathToQualifiedName(f.path);
+            if (qn)
+                seedQnames.push(qn);
+        }
+        const gaps = [];
+        const covered = [];
+        const seen = new Set();
+        for (const qn of seedQnames) {
+            const dep = analyze.findDependents(ctx.graphStore, ctx.orgId, asQualifiedName(qn), 3);
+            for (const n of dep.nodes) {
+                if (seen.has(n.qualifiedName))
+                    continue;
+                seen.add(n.qualifiedName);
+                const hasTest = analyze.hasTestCoverage(ctx.graphStore, ctx.orgId, asQualifiedName(n.qualifiedName));
+                if (hasTest)
+                    covered.push(n.qualifiedName);
+                else
+                    gaps.push(n.qualifiedName);
+            }
+        }
+        const md = [
+            `**Test gaps:** ${gaps.length}`,
+            "",
+            ...gaps.slice(0, 50).map((g) => `- \`${g}\``),
+        ].join("\n");
+        return {
+            summary: `${gaps.length} dependents lack tests`,
+            markdown: md,
+            data: { gaps, covered },
+        };
+    },
+});
+//# sourceMappingURL=test_gap_intelligence_from_git_diff.js.map

package/dist/tools/test_gap_intelligence_from_git_diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_gap_intelligence_from_git_diff.js","sourceRoot":"","sources":["../../src/tools/test_gap_intelligence_from_git_diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH,UAAU,CAAC;IACT,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,2DAA2D;IACxE,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,EAAE;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACtF,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;oBAAE,SAAS;gBACxC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;gBAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CACrC,GAAG,CAAC,UAAU,EACd,GAAG,CAAC,KAAK,EACT,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,CACjC,CAAC;gBACF,IAAI,OAAO;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;;oBACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,MAAM,EAAE,GAAG;YACT,kBAAkB,IAAI,CAAC,MAAM,EAAE;YAC/B,EAAE;YACF,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;SAC9C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO;YACL,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,wBAAwB;YAC/C,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SACxB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/trace_downstream.d.ts

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

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

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

package/dist/tools/trace_downstream.js

@@ -0,0 +1,43 @@
+import { analyze, render } from "@ryanstark24/sfgraph-core";
+import { asQualifiedName } from "@ryanstark24/sfgraph-shared";
+import { getToolContext } from "../context.js";
+import { defineTool, z } from "./_define.js";
+const inputSchema = z.object({
+    org: z.string().min(1),
+    qname: z.string().min(1),
+    depth: z.number().int().min(1).max(5).default(3),
+});
+defineTool({
+    name: "trace_downstream",
+    description: "USE THIS for any 'what does X depend on' / 'show dependencies' / 'what does this method call' question about a Salesforce metadata node (ApexClass, LWC, Flow, CustomField, etc.). Forward-edge graph N hops out.",
+    inputSchema,
+    async execute(input) {
+        const ctx = await getToolContext({ orgId: input.org });
+        const qname = asQualifiedName(input.qname);
+        const r = analyze.findDependencies(ctx.graphStore, ctx.orgId, qname, input.depth);
+        const nodes = [
+            { qualifiedName: qname, label: "Target" },
+            ...r.nodes.map((n) => ({ qualifiedName: n.qualifiedName, label: n.label })),
+        ];
+        const mermaid = render.renderDependencyGraph({
+            nodes,
+            edges: r.edges.map((e) => ({
+                srcQualifiedName: e.srcQualifiedName,
+                dstQualifiedName: e.dstQualifiedName,
+                relType: e.relType,
+            })),
+            title: "downstream",
+        });
+        const truncated = r.truncated === true;
+        const mdLines = ["```mermaid", mermaid, "```"];
+        if (truncated) {
+            mdLines.push("", "_truncated_ — traversal hit the node cap; deeper downstream paths were not explored. Lower `depth` or pick a narrower `qname`.");
+        }
+        return {
+            summary: `${r.nodes.length} downstream nodes${truncated ? " (truncated)" : ""}`,
+            markdown: mdLines.join("\n"),
+            data: { nodes: r.nodes, edges: r.edges, truncated },
+        };
+    },
+});
+//# sourceMappingURL=trace_downstream.js.map

package/dist/tools/trace_downstream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace_downstream.js","sourceRoot":"","sources":["../../src/tools/trace_downstream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD,CAAC,CAAC;AAEH,UAAU,CAAC;IACT,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,mNAAmN;IACrN,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAClF,MAAM,KAAK,GAAG;YACZ,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE;YACzC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SAC5E,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,qBAAqB,CAAC;YAC3C,KAAK;YACL,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;gBACpC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;gBACpC,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC;YACH,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC;QACvC,MAAM,OAAO,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CACV,EAAE,EACF,gIAAgI,CACjI,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,oBAAoB,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE;YAC/E,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5B,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE;SACpD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/trace_upstream.d.ts

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

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

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

package/dist/tools/trace_upstream.js

@@ -0,0 +1,43 @@
+import { analyze, render } from "@ryanstark24/sfgraph-core";
+import { asQualifiedName } from "@ryanstark24/sfgraph-shared";
+import { getToolContext } from "../context.js";
+import { defineTool, z } from "./_define.js";
+const inputSchema = z.object({
+    org: z.string().min(1),
+    qname: z.string().min(1),
+    depth: z.number().int().min(1).max(5).default(3),
+});
+defineTool({
+    name: "trace_upstream",
+    description: "USE THIS for any 'what depends on X' / 'who uses this' / 'find callers of' / 'who references this method' question about a Salesforce metadata node. Returns every node that depends on the target, N hops back.",
+    inputSchema,
+    async execute(input) {
+        const ctx = await getToolContext({ orgId: input.org });
+        const qname = asQualifiedName(input.qname);
+        const r = analyze.findDependents(ctx.graphStore, ctx.orgId, qname, input.depth);
+        const nodes = [
+            { qualifiedName: qname, label: "Target" },
+            ...r.nodes.map((n) => ({ qualifiedName: n.qualifiedName, label: n.label })),
+        ];
+        const mermaid = render.renderDependencyGraph({
+            nodes,
+            edges: r.edges.map((e) => ({
+                srcQualifiedName: e.srcQualifiedName,
+                dstQualifiedName: e.dstQualifiedName,
+                relType: e.relType,
+            })),
+            title: "upstream",
+        });
+        const truncated = r.truncated === true;
+        const mdLines = ["```mermaid", mermaid, "```"];
+        if (truncated) {
+            mdLines.push("", "_truncated_ — traversal hit the node cap; deeper upstream paths were not explored. Lower `depth` or pick a narrower `qname`.");
+        }
+        return {
+            summary: `${r.nodes.length} upstream nodes${truncated ? " (truncated)" : ""}`,
+            markdown: mdLines.join("\n"),
+            data: { nodes: r.nodes, edges: r.edges, truncated },
+        };
+    },
+});
+//# sourceMappingURL=trace_upstream.js.map

package/dist/tools/trace_upstream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace_upstream.js","sourceRoot":"","sources":["../../src/tools/trace_upstream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD,CAAC,CAAC;AAEH,UAAU,CAAC;IACT,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,kNAAkN;IACpN,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG;YACZ,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE;YACzC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SAC5E,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,qBAAqB,CAAC;YAC3C,KAAK;YACL,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;gBACpC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;gBACpC,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC;YACH,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC;QACvC,MAAM,OAAO,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CACV,EAAE,EACF,8HAA8H,CAC/H,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,kBAAkB,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7E,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5B,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE;SACpD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/what_broke.d.ts

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

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

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

package/dist/tools/what_broke.js

@@ -0,0 +1,86 @@
+import { analyze, render } from "@ryanstark24/sfgraph-core";
+import { asQualifiedName } from "@ryanstark24/sfgraph-shared";
+import { getToolContext } from "../context.js";
+import { defineTool, z } from "./_define.js";
+const inputSchema = z.object({
+    org: z.string().min(1),
+    since: z.string().optional(),
+});
+defineTool({
+    name: "what_broke",
+    description: "USE THIS for any 'what broke' / 'post-deploy regression' / 'what changed since the deploy' question about a Salesforce org. Compares current graph against latest pre-sync snapshot, identifies changed nodes, buckets dependents as at-risk (no tests) or covered.",
+    inputSchema,
+    async execute(input) {
+        const ctx = await getToolContext({ orgId: input.org });
+        let fromId = input.since;
+        if (!fromId) {
+            const snaps = ctx.snapshotStore.listSnapshots(ctx.orgId);
+            const auto = snaps.find((s) => s.isAuto || s.label.startsWith("pre-sync"));
+            if (!auto) {
+                return {
+                    summary: "no baseline snapshot",
+                    markdown: "> no auto snapshot found; pass `since` explicitly",
+                    data: { atRisk: [], covered: [] },
+                };
+            }
+            fromId = auto.id;
+        }
+        const nodeDiff = ctx.snapshotStore.diffNodes(ctx.orgId, fromId, "current");
+        const changedQnames = [
+            ...nodeDiff.changed.map((c) => c.after.qualifiedName),
+            ...nodeDiff.removed.map((r) => r.qualifiedName),
+        ];
+        if (changedQnames.length === 0) {
+            return {
+                summary: "no changes",
+                markdown: "_no changes since snapshot_",
+                data: { atRisk: [], covered: [] },
+            };
+        }
+        const atRisk = [];
+        const covered = [];
+        const allNodes = new Map();
+        const allEdges = [];
+        for (const qn of changedQnames) {
+            const qname = asQualifiedName(qn);
+            allNodes.set(qn, { qualifiedName: qn, label: "Changed" });
+            const dep = analyze.findDependents(ctx.graphStore, ctx.orgId, qname, 3);
+            for (const n of dep.nodes) {
+                allNodes.set(n.qualifiedName, { qualifiedName: n.qualifiedName, label: n.label });
+                // Skip nodes that are themselves test classes (they reach the target via IS_TEST_FOR chain).
+                const isTestClass = ctx.graphStore.listEdgesFrom(ctx.orgId, asQualifiedName(n.qualifiedName), "IS_TEST_FOR").length > 0;
+                if (isTestClass)
+                    continue;
+                const hasTest = analyze.hasTestCoverage(ctx.graphStore, ctx.orgId, asQualifiedName(n.qualifiedName));
+                if (hasTest)
+                    covered.push(n.qualifiedName);
+                else
+                    atRisk.push(n.qualifiedName);
+            }
+            for (const e of dep.edges) {
+                allEdges.push({
+                    srcQualifiedName: e.srcQualifiedName,
+                    dstQualifiedName: e.dstQualifiedName,
+                });
+            }
+        }
+        const mermaid = render.renderDependencyGraph({
+            nodes: Array.from(allNodes.values()),
+            edges: allEdges,
+            title: "what_broke",
+        });
+        const md = [
+            `Changed: ${changedQnames.length}, at risk: ${atRisk.length}, covered: ${covered.length}`,
+            "",
+            "```mermaid",
+            mermaid,
+            "```",
+        ].join("\n");
+        return {
+            summary: `${atRisk.length} dependents at risk`,
+            markdown: md,
+            data: { changed: changedQnames, atRisk, covered },
+        };
+    },
+});
+//# sourceMappingURL=what_broke.js.map

package/dist/tools/what_broke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"what_broke.js","sourceRoot":"","sources":["../../src/tools/what_broke.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,UAAU,CAAC;IACT,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,qQAAqQ;IACvQ,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,IAAI,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;YAC3E,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO;oBACL,OAAO,EAAE,sBAAsB;oBAC/B,QAAQ,EAAE,mDAAmD;oBAC7D,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;iBAClC,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3E,MAAM,aAAa,GAAG;YACpB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;YACrD,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;SAChD,CAAC;QACF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE,YAAY;gBACrB,QAAQ,EAAE,6BAA6B;gBACvC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;aAClC,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoD,CAAC;QAC7E,MAAM,QAAQ,GAAkE,EAAE,CAAC;QACnF,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;YAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACxE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC1B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBAClF,6FAA6F;gBAC7F,MAAM,WAAW,GACf,GAAG,CAAC,UAAU,CAAC,aAAa,CAC1B,GAAG,CAAC,KAAK,EACT,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,EAChC,aAAsB,CACvB,CAAC,MAAM,GAAG,CAAC,CAAC;gBACf,IAAI,WAAW;oBAAE,SAAS;gBAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CACrC,GAAG,CAAC,UAAU,EACd,GAAG,CAAC,KAAK,EACT,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,CACjC,CAAC;gBACF,IAAI,OAAO;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;;oBACtC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YACpC,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC;oBACZ,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;oBACpC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,qBAAqB,CAAC;YAC3C,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpC,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;QACH,MAAM,EAAE,GAAG;YACT,YAAY,aAAa,CAAC,MAAM,cAAc,MAAM,CAAC,MAAM,cAAc,OAAO,CAAC,MAAM,EAAE;YACzF,EAAE;YACF,YAAY;YACZ,OAAO;YACP,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO;YACL,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,qBAAqB;YAC9C,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE;SAClD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/wip_diff.d.ts

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

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

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

package/dist/tools/wip_diff.js

@@ -0,0 +1,55 @@
+import { analyze } from "@ryanstark24/sfgraph-core";
+import { ConfigError, readWorkspace } from "@ryanstark24/sfgraph-shared";
+import { getToolContext } from "../context.js";
+import { defineTool, z } from "./_define.js";
+import { resolveWipProjectRoot } from "./_project-root.js";
+const inputSchema = z.object({
+    project_root: z.string().min(1).optional(),
+    org: z.string().min(1).optional(),
+    mode: z.enum(["changed-only", "full-folder"]).default("changed-only"),
+});
+defineTool({
+    name: "wip_diff",
+    description: "USE THIS for any 'show me what is different between my local source and the org' / 'list local-only / org-only metadata' question. Returns just the added/changed/removed sets — no dependent fan-out. Faster than wip_impact when you only need the diff.",
+    inputSchema,
+    async execute(input) {
+        const projectRoot = resolveWipProjectRoot(input.project_root ?? process.cwd());
+        let orgArg = input.org;
+        if (!orgArg) {
+            const ws = await readWorkspace(projectRoot);
+            if (ws?.orgId) {
+                orgArg = ws.orgId;
+            }
+            else {
+                throw new ConfigError("wip_diff: no `org` provided and no workspace binding found. Run `sfgraph link --org <alias>` first.");
+            }
+        }
+        const ctx = await getToolContext(orgArg ? { orgId: orgArg } : {});
+        const result = await analyze.analyzeLocalImpact({
+            graphStore: ctx.graphStore,
+            orgId: ctx.orgId,
+            projectRoot,
+            mode: input.mode,
+        });
+        const md = [
+            `Added (${result.addedQnames.length}):`,
+            ...result.addedQnames.map((q) => `  + ${q}`),
+            "",
+            `Changed (${result.changedQnames.length}):`,
+            ...result.changedQnames.map((q) => `  ~ ${q}`),
+            "",
+            `Removed (${result.removedQnames.length}):`,
+            ...result.removedQnames.map((q) => `  - ${q}`),
+        ].join("\n");
+        return {
+            summary: `WIP diff: +${result.addedQnames.length} ~${result.changedQnames.length} -${result.removedQnames.length}`,
+            markdown: md,
+            data: {
+                added: result.addedQnames,
+                changed: result.changedQnames,
+                removed: result.removedQnames,
+            },
+        };
+    },
+});
+//# sourceMappingURL=wip_diff.js.map

package/dist/tools/wip_diff.js.map

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

package/dist/tools/wip_impact.d.ts

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

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

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

package/dist/tools/wip_impact.js

@@ -0,0 +1,55 @@
+import { analyze } from "@ryanstark24/sfgraph-core";
+import { ConfigError, readWorkspace } from "@ryanstark24/sfgraph-shared";
+import { getToolContext } from "../context.js";
+import { defineTool, z } from "./_define.js";
+import { resolveWipProjectRoot } from "./_project-root.js";
+const inputSchema = z.object({
+    project_root: z.string().min(1).optional(),
+    org: z.string().min(1).optional(),
+    depth: z.number().int().min(1).max(5).default(3),
+    mode: z.enum(["changed-only", "full-folder"]).default("changed-only"),
+});
+defineTool({
+    name: "wip_impact",
+    description: "USE THIS for any 'what does this branch break' / 'dry-run my local changes' / 'what would happen if I deployed this' / 'impact of my uncommitted changes' question. Parses the local sfdx-source tree (force-app/) and overlays it on the org's persisted graph WITHOUT writing to it. Returns changed/added/removed qnames + N-hop dependent BFS + Mermaid. The local-equivalent of impact_from_git_diff for uncommitted work.",
+    inputSchema,
+    async execute(input) {
+        const projectRoot = resolveWipProjectRoot(input.project_root ?? process.cwd());
+        let orgArg = input.org;
+        if (!orgArg) {
+            const ws = await readWorkspace(projectRoot);
+            if (ws?.orgId) {
+                orgArg = ws.orgId;
+            }
+            else {
+                throw new ConfigError("wip_impact: no `org` provided and no workspace binding found. Run `sfgraph link --org <alias>` first.");
+            }
+        }
+        const ctx = await getToolContext(orgArg ? { orgId: orgArg } : {});
+        const result = await analyze.analyzeLocalImpact({
+            graphStore: ctx.graphStore,
+            orgId: ctx.orgId,
+            projectRoot,
+            depth: input.depth,
+            mode: input.mode,
+        });
+        const md = [
+            `Changed: ${result.changedQnames.length}, Added: ${result.addedQnames.length}, Removed: ${result.removedQnames.length}, Dependents: ${result.dependents.length}`,
+            "",
+            "```mermaid",
+            result.mermaid,
+            "```",
+        ].join("\n");
+        return {
+            summary: `WIP impact: ${result.changedQnames.length} changed, ${result.addedQnames.length} added, ${result.dependents.length} dependents`,
+            markdown: md,
+            data: {
+                changed: result.changedQnames,
+                added: result.addedQnames,
+                removed: result.removedQnames,
+                dependents: result.dependents,
+            },
+        };
+    },
+});
+//# sourceMappingURL=wip_impact.js.map

package/dist/tools/wip_impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wip_impact.js","sourceRoot":"","sources":["../../src/tools/wip_impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;CACtE,CAAC,CAAC;AAEH,UAAU,CAAC;IACT,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,iaAAia;IACna,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,WAAW,GAAG,qBAAqB,CAAC,KAAK,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/E,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;gBACd,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,WAAW,CACnB,uGAAuG,CACxG,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC;YAC9C,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW;YACX,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,MAAM,EAAE,GAAG;YACT,YAAY,MAAM,CAAC,aAAa,CAAC,MAAM,YAAY,MAAM,CAAC,WAAW,CAAC,MAAM,cAAc,MAAM,CAAC,aAAa,CAAC,MAAM,iBAAiB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE;YAChK,EAAE;YACF,YAAY;YACZ,MAAM,CAAC,OAAO;YACd,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO;YACL,OAAO,EAAE,eAAe,MAAM,CAAC,aAAa,CAAC,MAAM,aAAa,MAAM,CAAC,WAAW,CAAC,MAAM,WAAW,MAAM,CAAC,UAAU,CAAC,MAAM,aAAa;YACzI,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE;gBACJ,OAAO,EAAE,MAAM,CAAC,aAAa;gBAC7B,KAAK,EAAE,MAAM,CAAC,WAAW;gBACzB,OAAO,EAAE,MAAM,CAAC,aAAa;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/wip_test_gap.d.ts

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

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

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

package/dist/tools/wip_test_gap.js

@@ -0,0 +1,50 @@
+import { analyze } from "@ryanstark24/sfgraph-core";
+import { ConfigError, readWorkspace } from "@ryanstark24/sfgraph-shared";
+import { getToolContext } from "../context.js";
+import { defineTool, z } from "./_define.js";
+import { resolveWipProjectRoot } from "./_project-root.js";
+const inputSchema = z.object({
+    project_root: z.string().min(1).optional(),
+    org: z.string().min(1).optional(),
+    depth: z.number().int().min(1).max(5).default(3),
+    mode: z.enum(["changed-only", "full-folder"]).default("changed-only"),
+});
+defineTool({
+    name: "wip_test_gap",
+    description: "USE THIS for any 'what tests am I missing for these local changes' / 'will my uncommitted changes have test coverage gaps' question. Runs wip_impact internally then filters dependents to those without IS_TEST_FOR coverage.",
+    inputSchema,
+    async execute(input) {
+        const projectRoot = resolveWipProjectRoot(input.project_root ?? process.cwd());
+        let orgArg = input.org;
+        if (!orgArg) {
+            const ws = await readWorkspace(projectRoot);
+            if (ws?.orgId) {
+                orgArg = ws.orgId;
+            }
+            else {
+                throw new ConfigError("wip_test_gap: no `org` provided and no workspace binding found. Run `sfgraph link --org <alias>` first.");
+            }
+        }
+        const ctx = await getToolContext(orgArg ? { orgId: orgArg } : {});
+        const result = await analyze.analyzeLocalImpact({
+            graphStore: ctx.graphStore,
+            orgId: ctx.orgId,
+            projectRoot,
+            depth: input.depth,
+            mode: input.mode,
+        });
+        const uncovered = result.dependents.filter((d) => !d.coveredByTest);
+        const md = uncovered.length === 0
+            ? "No uncovered dependents found."
+            : [
+                `Uncovered dependents (${uncovered.length}):`,
+                ...uncovered.map((d) => `- ${d.qname} (${d.label}, depth=${d.depth}${d.viaRelType ? `, via=${d.viaRelType}` : ""})`),
+            ].join("\n");
+        return {
+            summary: `${uncovered.length} uncovered dependents from WIP changes`,
+            markdown: md,
+            data: { uncovered },
+        };
+    },
+});
+//# sourceMappingURL=wip_test_gap.js.map

package/dist/tools/wip_test_gap.js.map

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