@ryanstark24/sfgraph-cli 1.1.0

package/dist/__tests__/doctor.test.d.ts

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

package/dist/__tests__/doctor.test.d.ts.map

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

package/dist/__tests__/doctor.test.js

@@ -0,0 +1,64 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { runDoctorChecks } from "../commands/doctor.js";
+let home;
+let dataDir;
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), "sfgraph-doctor-home-"));
+    dataDir = mkdtempSync(join(tmpdir(), "sfgraph-doctor-data-"));
+});
+afterEach(() => {
+    rmSync(home, { recursive: true, force: true });
+    rmSync(dataDir, { recursive: true, force: true });
+});
+describe("runDoctorChecks", () => {
+    it("flags ABI mismatch as a hard fail with a rebuild hint", () => {
+        const requireFn = () => {
+            throw new Error("NODE_MODULE_VERSION 137 mismatch — was compiled against a different Node.js version");
+        };
+        const report = runDoctorChecks({
+            dataDir,
+            homeOverride: home,
+            requireFn,
+            sfProbe: () => ({ ok: true, detail: "@salesforce/cli 2.0.0" }),
+        });
+        const binding = report.checks.find((c) => c.name === "better-sqlite3 native binding");
+        expect(binding?.status).toBe("fail");
+        expect(binding?.fix).toMatch(/rebuild better-sqlite3/);
+        expect(report.ok).toBe(false);
+    });
+    it("reports all-green when the environment is healthy and no orgs are ingested yet", () => {
+        const requireFn = () => ({
+        /* mock Database ctor never used because no .sqlite files */
+        });
+        const report = runDoctorChecks({
+            dataDir,
+            homeOverride: home,
+            requireFn,
+            sfProbe: () => ({ ok: true, detail: "@salesforce/cli 2.0.0" }),
+        });
+        expect(report.ok).toBe(true);
+        // No org DBs yet → warn (still ok overall)
+        const orgs = report.checks.find((c) => c.name === "org databases");
+        expect(orgs?.status).toBe("warn");
+        const node = report.checks.find((c) => c.name === "node runtime");
+        expect(node?.detail).toContain(process.version);
+    });
+    it("emits a warn (not fail) when no IDE MCP configs are present yet", () => {
+        const requireFn = () => ({});
+        const report = runDoctorChecks({
+            dataDir,
+            homeOverride: home,
+            requireFn,
+            sfProbe: () => ({ ok: false, detail: "not found" }),
+        });
+        const mcp = report.checks.find((c) => c.name === "IDE MCP configs");
+        expect(mcp?.status).toBe("warn");
+        expect(mcp?.fix).toMatch(/sfgraph install/);
+        // sf CLI missing is warn, not fail
+        expect(report.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=doctor.test.js.map

package/dist/__tests__/doctor.test.js.map

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

package/dist/__tests__/ingest-db-guard.test.d.ts

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

package/dist/__tests__/ingest-db-guard.test.d.ts.map

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

package/dist/__tests__/ingest-db-guard.test.js

@@ -0,0 +1,110 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+/**
+ * `--db <path>` lets a user override the SQLite path the ingester writes to.
+ * Without containment, a script could overwrite arbitrary files or fill `/`.
+ * We require the resolved path to land inside `getSfgraphPaths().data`
+ * unless `SFGRAPH_ALLOW_ANY_DB=1` is set.
+ */
+let tmpDataDir;
+let tmpDbDir;
+let prevAllowAnyDb;
+beforeEach(() => {
+    tmpDataDir = mkdtempSync(join(tmpdir(), "sfg-dbguard-data-"));
+    tmpDbDir = mkdtempSync(join(tmpdir(), "sfg-dbguard-elsewhere-"));
+    prevAllowAnyDb = process.env.SFGRAPH_ALLOW_ANY_DB;
+    // biome-ignore lint/performance/noDelete: cleanest reset of an env var override
+    delete process.env.SFGRAPH_ALLOW_ANY_DB;
+});
+afterEach(() => {
+    rmSync(tmpDataDir, { recursive: true, force: true });
+    rmSync(tmpDbDir, { recursive: true, force: true });
+    if (prevAllowAnyDb === undefined) {
+        // biome-ignore lint/performance/noDelete: cleanest reset of an env var override
+        delete process.env.SFGRAPH_ALLOW_ANY_DB;
+    }
+    else {
+        process.env.SFGRAPH_ALLOW_ANY_DB = prevAllowAnyDb;
+    }
+    vi.restoreAllMocks();
+    vi.resetModules();
+});
+async function loadIngestWithStubs() {
+    vi.doMock("@ryanstark24/sfgraph-core", async () => {
+        const actual = await vi.importActual("@ryanstark24/sfgraph-core");
+        return {
+            ...actual,
+            liveIngest: async () => ({
+                orgId: "00DxxGuardTest001",
+                capabilities: {},
+                mode: "full",
+                membersProcessed: 0,
+                parseErrors: 0,
+                deletions: 0,
+                durationMs: 0,
+            }),
+            resolveOrg: async (alias) => ({
+                orgId: "00DxxGuardTest001",
+                alias,
+                username: "u@example.com",
+                instanceUrl: "https://x.test",
+                apiVersion: "60.0",
+                conn: {},
+            }),
+        };
+    });
+    vi.doMock("@ryanstark24/sfgraph-shared", async () => {
+        const actual = await vi.importActual("@ryanstark24/sfgraph-shared");
+        return {
+            ...actual,
+            getSfgraphPaths: () => ({ data: tmpDataDir, cache: tmpDataDir, config: tmpDataDir }),
+        };
+    });
+    return await import("../commands/ingest.js");
+}
+describe("ingest --db containment", () => {
+    it("rejects --db path outside the data dir", async () => {
+        const { ingestCmd } = await loadIngestWithStubs();
+        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const badDbPath = join(tmpDbDir, "anywhere.sqlite");
+        await ingestCmd({ org: "myalias", db: badDbPath });
+        expect(process.exitCode).toBe(1);
+        const calls = errSpy.mock.calls.map((c) => String(c[0]));
+        expect(calls.some((s) => s.includes("resolves outside the sfgraph data dir"))).toBe(true);
+        process.exitCode = 0;
+        errSpy.mockRestore();
+    });
+    it("rejects --db with parent-dir traversal", async () => {
+        const { ingestCmd } = await loadIngestWithStubs();
+        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const traversed = join(tmpDataDir, "..", "escape.sqlite");
+        await ingestCmd({ org: "myalias", db: traversed });
+        expect(process.exitCode).toBe(1);
+        process.exitCode = 0;
+        errSpy.mockRestore();
+    });
+    it("accepts --db inside the data dir", async () => {
+        const { ingestCmd } = await loadIngestWithStubs();
+        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const goodDbPath = join(tmpDataDir, "00DxxGuardTest001.sqlite");
+        await ingestCmd({ org: "myalias", db: goodDbPath });
+        // Either succeeds or fails inside liveIngest (we stubbed it to no-op),
+        // but it should NOT bail with the containment error.
+        const calls = errSpy.mock.calls.map((c) => String(c[0]));
+        expect(calls.some((s) => s.includes("resolves outside the sfgraph data dir"))).toBe(false);
+        errSpy.mockRestore();
+    });
+    it("permits cross-dir --db when SFGRAPH_ALLOW_ANY_DB=1 is set", async () => {
+        process.env.SFGRAPH_ALLOW_ANY_DB = "1";
+        const { ingestCmd } = await loadIngestWithStubs();
+        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const elsewhere = join(tmpDbDir, "ok.sqlite");
+        await ingestCmd({ org: "myalias", db: elsewhere });
+        const calls = errSpy.mock.calls.map((c) => String(c[0]));
+        expect(calls.some((s) => s.includes("resolves outside the sfgraph data dir"))).toBe(false);
+        errSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=ingest-db-guard.test.js.map

package/dist/__tests__/ingest-db-guard.test.js.map

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

package/dist/__tests__/ingest-multi.test.d.ts

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

package/dist/__tests__/ingest-multi.test.d.ts.map

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

package/dist/__tests__/ingest-multi.test.js

@@ -0,0 +1,51 @@
+import { describe, expect, it } from "vitest";
+import { buildProgram } from "../index.js";
+/**
+ * These tests parse the CLI argv into the `ingest` command and assert that the
+ * commander option model exposes the new flags. We don't actually invoke
+ * `ingestCmd` (that would hit @salesforce/core); we just verify the parser.
+ */
+describe("sfgraph ingest CLI flags", () => {
+    function getIngest() {
+        const program = buildProgram();
+        const ingest = program.commands.find((c) => c.name() === "ingest");
+        if (!ingest)
+            throw new Error("ingest command not registered");
+        return { program, ingest: ingest };
+    }
+    it("registers --orgs, --all, and --parallel options", () => {
+        const { ingest } = getIngest();
+        const opts = ingest.options.map((o) => o.long);
+        expect(opts).toContain("--orgs");
+        expect(opts).toContain("--all");
+        expect(opts).toContain("--parallel");
+        expect(opts).toContain("--org");
+    });
+    it("parses --orgs a,b correctly", () => {
+        const { ingest } = getIngest();
+        // Parse without running the action by using parseOptions on a clone.
+        const parsed = ingest.parseOptions(["--orgs", "a,b"]);
+        expect(parsed).toBeDefined();
+        // After parse, commander stores parsed values on the command.
+        const opts = ingest.opts();
+        expect(opts.orgs).toBe("a,b");
+    });
+    it("honors --all flag", () => {
+        const { ingest } = getIngest();
+        ingest.parseOptions(["--all"]);
+        const opts = ingest.opts();
+        expect(opts.all).toBe(true);
+    });
+    it("honors --parallel flag", () => {
+        const { ingest } = getIngest();
+        ingest.parseOptions([
+            "--orgs",
+            "a,b",
+            "--parallel",
+        ]);
+        const opts = ingest.opts();
+        expect(opts.parallel).toBe(true);
+        expect(opts.orgs).toBe("a,b");
+    });
+});
+//# sourceMappingURL=ingest-multi.test.js.map

package/dist/__tests__/ingest-multi.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-multi.test.js","sourceRoot":"","sources":["../../src/__tests__/ingest-multi.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,SAAS,SAAS;QAMhB,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAe,EAAE,CAAC;IAC9C,CAAC;IAED,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAI,MAA2D,CAAC,OAAO,CAAC,GAAG,CACnF,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACd,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QAC/B,qEAAqE;QACrE,MAAM,MAAM,GACV,MAGD,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,8DAA8D;QAC9D,MAAM,IAAI,GAAI,MAA6D,CAAC,IAAI,EAAE,CAAC;QACnF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QAC9B,MAAiE,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAI,MAA6D,CAAC,IAAI,EAAE,CAAC;QACnF,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QAC9B,MAAiE,CAAC,YAAY,CAAC;YAC9E,QAAQ;YACR,KAAK;YACL,YAAY;SACb,CAAC,CAAC;QACH,MAAM,IAAI,GAAI,MAA6D,CAAC,IAAI,EAAE,CAAC;QACnF,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/install-dry-run.test.d.ts

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

package/dist/__tests__/install-dry-run.test.d.ts.map

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

package/dist/__tests__/install-dry-run.test.js

@@ -0,0 +1,29 @@
+import { existsSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { installCmd } from "../commands/install.js";
+let home;
+let logs;
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), "sfgraph-inst-"));
+    logs = [];
+});
+afterEach(() => {
+    rmSync(home, { recursive: true, force: true });
+});
+describe("installCmd --dry-run", () => {
+    it("logs would-write rows and writes nothing", async () => {
+        const rows = await installCmd({
+            target: "all",
+            dryRun: true,
+            homeOverride: home,
+            log: (s) => logs.push(s),
+        });
+        expect(rows.every((r) => r.action === "would-write")).toBe(true);
+        expect(logs.join("\n")).toMatch(/\[dry-run\] no files written/);
+        expect(existsSync(join(home, ".claude"))).toBe(false);
+        expect(existsSync(join(home, ".cursor"))).toBe(false);
+    });
+});
+//# sourceMappingURL=install-dry-run.test.js.map

package/dist/__tests__/install-dry-run.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-dry-run.test.js","sourceRoot":"","sources":["../../src/__tests__/install-dry-run.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,IAAI,IAAY,CAAC;AACjB,IAAI,IAAc,CAAC;AAEnB,UAAU,CAAC,GAAG,EAAE;IACd,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;IACpD,IAAI,GAAG,EAAE,CAAC;AACZ,CAAC,CAAC,CAAC;AACH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,IAAI;YAClB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;SACzB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAChE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/install-e2e.test.d.ts

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

package/dist/__tests__/install-e2e.test.d.ts.map

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

package/dist/__tests__/install-e2e.test.js

@@ -0,0 +1,33 @@
+import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { configPathFor } from "../commands/_mcp-config.js";
+import { installCmd } from "../commands/install.js";
+let home;
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), "sfgraph-e2e-"));
+});
+afterEach(() => {
+    rmSync(home, { recursive: true, force: true });
+});
+describe("installCmd e2e", () => {
+    it("installs skills + MCP config for all targets", async () => {
+        const rows = await installCmd({
+            target: "all",
+            homeOverride: home,
+            log: () => { },
+        });
+        const skillRows = rows.filter((r) => r.kind === "skill");
+        const mcpRows = rows.filter((r) => r.kind === "mcp");
+        expect(skillRows.length).toBe(48); // 16 skills * 3 targets
+        expect(mcpRows.length).toBe(3);
+        expect(existsSync(join(home, ".claude", "skills"))).toBe(true);
+        expect(existsSync(join(home, ".cursor", "rules"))).toBe(true);
+        // verify cursor mcp.json has sfgraph entry
+        const cursorMcp = configPathFor("cursor", { homeOverride: home });
+        const parsed = JSON.parse(readFileSync(cursorMcp, "utf8"));
+        expect(parsed.mcpServers.sfgraph).toBeDefined();
+    });
+});
+//# sourceMappingURL=install-e2e.test.js.map

package/dist/__tests__/install-e2e.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-e2e.test.js","sourceRoot":"","sources":["../../src/__tests__/install-e2e.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,IAAI,IAAY,CAAC;AAEjB,UAAU,CAAC,GAAG,EAAE;IACd,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AACH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,IAAI;YAClB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;SACd,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;QACrD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,wBAAwB;QAC3D,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,2CAA2C;QAC3C,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/mcp-config.test.d.ts

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

package/dist/__tests__/mcp-config.test.d.ts.map

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

package/dist/__tests__/mcp-config.test.js

@@ -0,0 +1,104 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { configPathFor, writeMcpConfig } from "../commands/_mcp-config.js";
+let home;
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), "sfgraph-mcp-"));
+});
+afterEach(() => {
+    rmSync(home, { recursive: true, force: true });
+});
+describe("writeMcpConfig", () => {
+    it("creates a fresh config file with the sfgraph entry", async () => {
+        const res = await writeMcpConfig("cursor", { homeOverride: home, platformOverride: "darwin" });
+        expect(res.action).toBe("created");
+        const path = configPathFor("cursor", { homeOverride: home });
+        expect(existsSync(path)).toBe(true);
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        expect(parsed.mcpServers.sfgraph).toEqual({
+            command: "npx",
+            args: ["-y", "@ryanstark24/sfgraph"],
+        });
+    });
+    it("emits npx.cmd on Windows so spawned process doesn't ENOENT", async () => {
+        const res = await writeMcpConfig("cursor", { homeOverride: home, platformOverride: "win32" });
+        expect(res.action).toBe("created");
+        const path = configPathFor("cursor", { homeOverride: home });
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        expect(parsed.mcpServers.sfgraph).toEqual({
+            command: "npx.cmd",
+            args: ["-y", "@ryanstark24/sfgraph"],
+        });
+    });
+    it("with localBinPath, invokes the local build directly via node", async () => {
+        const res = await writeMcpConfig("cursor", {
+            homeOverride: home,
+            platformOverride: "darwin",
+            localBinPath: "/abs/path/to/sfgraph.mjs",
+        });
+        expect(res.action).toBe("created");
+        const path = configPathFor("cursor", { homeOverride: home });
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        expect(parsed.mcpServers.sfgraph).toEqual({
+            command: "node",
+            args: ["/abs/path/to/sfgraph.mjs", "mcp"],
+        });
+    });
+    it("propagates SFGRAPH_* env vars into the MCP entry for sandboxed IDE children", async () => {
+        const res = await writeMcpConfig("cursor", {
+            homeOverride: home,
+            platformOverride: "darwin",
+            env: {
+                SFGRAPH_DATA_DIR: "/Users/x/Library/Application Support/sfgraph",
+                SFGRAPH_CONFIG_DIR: "/Users/x/Library/Preferences/sfgraph",
+            },
+        });
+        expect(res.action).toBe("created");
+        const path = configPathFor("cursor", { homeOverride: home });
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        expect(parsed.mcpServers.sfgraph.env).toEqual({
+            SFGRAPH_DATA_DIR: "/Users/x/Library/Application Support/sfgraph",
+            SFGRAPH_CONFIG_DIR: "/Users/x/Library/Preferences/sfgraph",
+        });
+    });
+    it("with pinNode + localBinPath, pins the command to the absolute Node path", async () => {
+        const res = await writeMcpConfig("cursor", {
+            homeOverride: home,
+            platformOverride: "darwin",
+            localBinPath: "/abs/path/to/sfgraph.mjs",
+            pinNode: "/opt/cursor/bin/node-v24",
+        });
+        expect(res.action).toBe("created");
+        const path = configPathFor("cursor", { homeOverride: home });
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        expect(parsed.mcpServers.sfgraph).toEqual({
+            command: "/opt/cursor/bin/node-v24",
+            args: ["/abs/path/to/sfgraph.mjs", "mcp"],
+        });
+    });
+    it("merges with an existing config preserving other servers", async () => {
+        const path = configPathFor("cursor", { homeOverride: home });
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify({
+            mcpServers: { other: { command: "node", args: ["other.js"] } },
+            unrelated: { keep: true },
+        }), "utf8");
+        const res = await writeMcpConfig("cursor", { homeOverride: home, platformOverride: "darwin" });
+        expect(res.action).toBe("updated");
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        expect(parsed.mcpServers.other).toEqual({ command: "node", args: ["other.js"] });
+        expect(parsed.mcpServers.sfgraph.command).toBe("npx");
+        expect(parsed.unrelated).toEqual({ keep: true });
+    });
+    it("is idempotent — second write reports skipped", async () => {
+        await writeMcpConfig("cursor", { homeOverride: home, platformOverride: "darwin" });
+        const res2 = await writeMcpConfig("cursor", {
+            homeOverride: home,
+            platformOverride: "darwin",
+        });
+        expect(res2.action).toBe("skipped");
+    });
+});
+//# sourceMappingURL=mcp-config.test.js.map

package/dist/__tests__/mcp-config.test.js.map

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

package/dist/__tests__/rebuild.test.d.ts

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

package/dist/__tests__/rebuild.test.d.ts.map

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