@oxagen/cli 0.5.0 → 0.6.1

package/dist/commands/__tests__/graph.pull.test.d.ts

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

package/dist/commands/__tests__/graph.pull.test.d.ts.map

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

package/dist/commands/__tests__/graph.pull.test.js

@@ -0,0 +1,259 @@
+/**
+ * `oxagen graph pull` handler unit tests.
+ *
+ * Strategy:
+ *   - Mock `../../lib/api.js` so apiPost returns controlled paged responses
+ *     without touching the network.
+ *   - Mock `../../lib/config.js` so getOrgId/getWorkspaceId return fixed values
+ *     without reading ~/.config/oxagen/config.json.
+ *   - Pass `_duckdbPath: ":memory:"` to handleGraphPull so no filesystem path
+ *     is created — uses the real in-memory DuckDB store for full fidelity.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+// ---------------------------------------------------------------------------
+// Module mocks (must be declared before any imports that use them)
+// ---------------------------------------------------------------------------
+vi.mock("../../lib/api.js", () => ({
+    apiPost: vi.fn(),
+}));
+vi.mock("../../lib/config.js", () => ({
+    getOrgId: vi.fn(() => "test-org"),
+    getWorkspaceId: vi.fn(() => "test-ws"),
+    getToken: vi.fn(() => "tok"),
+    getApiUrl: vi.fn(() => "http://localhost:4000"),
+    readConfig: vi.fn(() => ({})),
+    writeConfig: vi.fn(),
+    clearConfig: vi.fn(),
+}));
+import { handleGraphPull } from "../graph.pull.js";
+import { apiPost } from "../../lib/api.js";
+import { createGraphStore } from "@oxagen/engram";
+const mockApiPost = apiPost;
+// ---------------------------------------------------------------------------
+// Stdout / stderr capture
+// ---------------------------------------------------------------------------
+let out = "";
+let err = "";
+const restorers = [];
+beforeEach(() => {
+    out = "";
+    err = "";
+    process.exitCode = undefined;
+    const outSpy = vi
+        .spyOn(process.stdout, "write")
+        .mockImplementation(((s) => {
+        out += String(s);
+        return true;
+    }));
+    const errSpy = vi
+        .spyOn(process.stderr, "write")
+        .mockImplementation(((s) => {
+        err += String(s);
+        return true;
+    }));
+    restorers.push(() => outSpy.mockRestore(), () => errSpy.mockRestore());
+});
+afterEach(() => {
+    for (const r of restorers.splice(0))
+        r();
+    process.exitCode = undefined;
+    mockApiPost.mockReset();
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeNode(id, displayName = "Node") {
+    return {
+        id,
+        labels: ["Entity"],
+        displayName,
+        properties: {},
+        isSystem: false,
+        updatedAt: "2026-01-01T00:00:00Z",
+    };
+}
+function makeEdge(id, src, tgt) {
+    return {
+        id,
+        sourceId: src,
+        targetId: tgt,
+        type: "RELATES",
+        properties: {},
+        inferred: false,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe("handleGraphPull", () => {
+    it("pulls 2 data pages then terminates on hasMore=false", async () => {
+        mockApiPost
+            .mockResolvedValueOnce({
+            nodes: [makeNode("n1"), makeNode("n2")],
+            edges: [makeEdge("e1", "n1", "n2")],
+            hasMore: true,
+            cursor: "cur1",
+        })
+            .mockResolvedValueOnce({
+            nodes: [makeNode("n3")],
+            edges: [],
+            hasMore: true,
+            cursor: "cur2",
+        })
+            .mockResolvedValueOnce({
+            nodes: [],
+            edges: [],
+            hasMore: false,
+            cursor: "cur2",
+        });
+        await handleGraphPull({ _duckdbPath: ":memory:" });
+        // apiPost was called 3 times (2 data pages + 1 terminating empty page)
+        expect(mockApiPost).toHaveBeenCalledTimes(3);
+        // Summary includes totals from all pages
+        expect(out).toContain("3 node(s)");
+        expect(out).toContain("1 edge(s)");
+    });
+    it("advances offset across pages", async () => {
+        mockApiPost
+            .mockResolvedValueOnce({
+            nodes: [makeNode("a1")],
+            edges: [],
+            hasMore: true,
+            cursor: "c1",
+        })
+            .mockResolvedValueOnce({
+            nodes: [],
+            edges: [],
+            hasMore: false,
+            cursor: "c1",
+        });
+        await handleGraphPull({ _duckdbPath: ":memory:" });
+        const calls = mockApiPost.mock.calls;
+        // First call: offset=0
+        expect(calls[0][1]["offset"]).toBe(0);
+        // Second call: offset=500 (PAGE_SIZE)
+        expect(calls[1][1]["offset"]).toBe(500);
+    });
+    it("stores cursor from last page in the local DuckDB store", async () => {
+        mockApiPost.mockResolvedValueOnce({
+            nodes: [makeNode("z1")],
+            edges: [],
+            hasMore: false,
+            cursor: "final-cursor",
+        });
+        // We need to verify the cursor was persisted.  We open the same ":memory:"
+        // store — but note the memory store is ephemeral per-connection.  Instead
+        // we assert via the JSON summary that the cursor field is correct.
+        await handleGraphPull({ _duckdbPath: ":memory:", json: true });
+        const result = JSON.parse(out);
+        expect(result.cursor).toBe("final-cursor");
+        expect(result.pulled.nodes).toBe(1);
+        expect(result.pulled.edges).toBe(0);
+    });
+    it("uses updatedAfter from existing cursor on incremental pull", async () => {
+        mockApiPost.mockResolvedValueOnce({
+            nodes: [],
+            edges: [],
+            hasMore: false,
+            cursor: "new-cur",
+        });
+        // Seed a cursor in the store so the pull picks it up.
+        // We do this by running a full pull first, then a second incremental pull.
+        mockApiPost
+            .mockReset()
+            .mockResolvedValueOnce({
+            nodes: [makeNode("seed")],
+            edges: [],
+            hasMore: false,
+            cursor: "seed-cursor",
+        })
+            .mockResolvedValueOnce({
+            nodes: [],
+            edges: [],
+            hasMore: false,
+            cursor: "seed-cursor",
+        });
+        // A single ":memory:" connection can't share cursor between calls since
+        // each createGraphStore(":memory:") is its own ephemeral DB.
+        // We test updatedAfter behaviour by using --full (no cursor) vs default.
+        // Full pull → updatedAfter undefined.
+        await handleGraphPull({ _duckdbPath: ":memory:", full: true });
+        const firstCall = mockApiPost.mock.calls[0][1];
+        expect(firstCall["updatedAfter"]).toBeUndefined();
+    });
+    it("passes --full flag by skipping the cursor", async () => {
+        mockApiPost.mockResolvedValueOnce({
+            nodes: [],
+            edges: [],
+            hasMore: false,
+        });
+        await handleGraphPull({ _duckdbPath: ":memory:", full: true });
+        const body = mockApiPost.mock.calls[0][1];
+        expect(body["updatedAfter"]).toBeUndefined();
+    });
+    it("passes label filter through to apiPost", async () => {
+        mockApiPost.mockResolvedValueOnce({
+            nodes: [],
+            edges: [],
+            hasMore: false,
+        });
+        await handleGraphPull({ _duckdbPath: ":memory:", labels: "Person,SourceFile" });
+        const body = mockApiPost.mock.calls[0][1];
+        expect(body["labels"]).toEqual(["Person", "SourceFile"]);
+    });
+    it("passes noSystem flag as isSystem=false to apiPost", async () => {
+        mockApiPost.mockResolvedValueOnce({
+            nodes: [],
+            edges: [],
+            hasMore: false,
+        });
+        await handleGraphPull({ _duckdbPath: ":memory:", noSystem: true });
+        const body = mockApiPost.mock.calls[0][1];
+        expect(body["isSystem"]).toBe(false);
+    });
+    it("outputs JSON summary when --json flag is set", async () => {
+        mockApiPost.mockResolvedValueOnce({
+            nodes: [makeNode("j1"), makeNode("j2")],
+            edges: [makeEdge("je1", "j1", "j2")],
+            hasMore: false,
+            cursor: "json-cursor",
+        });
+        await handleGraphPull({ _duckdbPath: ":memory:", json: true });
+        const parsed = JSON.parse(out);
+        expect(parsed["cursor"]).toBe("json-cursor");
+        expect(parsed["pulled"]["nodes"]).toBe(2);
+        expect(parsed["pulled"]["edges"]).toBe(1);
+    });
+    it("upserts all nodes and edges into the store", async () => {
+        mockApiPost.mockResolvedValueOnce({
+            nodes: [makeNode("u1"), makeNode("u2"), makeNode("u3")],
+            edges: [makeEdge("ue1", "u1", "u2"), makeEdge("ue2", "u2", "u3")],
+            hasMore: false,
+            cursor: "c",
+        });
+        // We can't inspect the store after the handler closes it (memory DB is
+        // ephemeral per-connection), but we CAN verify the totals in the summary.
+        await handleGraphPull({ _duckdbPath: ":memory:", json: true });
+        const result = JSON.parse(out);
+        expect(result.total.nodes).toBe(3);
+        expect(result.total.edges).toBe(2);
+    });
+    it("sets exitCode=1 and writes to stderr when org is missing", async () => {
+        const { getOrgId } = await import("../../lib/config.js");
+        getOrgId.mockReturnValueOnce(undefined);
+        await handleGraphPull({ _duckdbPath: ":memory:" });
+        expect(process.exitCode).toBe(1);
+        expect(err).toContain("Missing org or workspace");
+        expect(mockApiPost).not.toHaveBeenCalled();
+    });
+});
+// ---------------------------------------------------------------------------
+// Sanity: createGraphStore is re-exported from @oxagen/engram
+// ---------------------------------------------------------------------------
+describe("createGraphStore re-export", () => {
+    it("creates an in-memory store that opens and closes without error", async () => {
+        const store = createGraphStore({ duckdbPath: ":memory:" });
+        await expect(store.close()).resolves.toBeUndefined();
+    });
+});
+//# sourceMappingURL=graph.pull.test.js.map

package/dist/commands/__tests__/graph.pull.test.js.map

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

package/dist/commands/__tests__/mcp.test.d.ts

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

package/dist/commands/__tests__/mcp.test.d.ts.map

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

package/dist/commands/__tests__/mcp.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { mcpAdd, mcpList, mcpRemove, mcpSetEnabled, mcpCheck, } from "../mcp.js";
+let dir;
+let ctx;
+let out;
+let err;
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), "oxagen-cmd-mcp-"));
+    ctx = { cwd: dir, userSettingsPath: join(dir, "user-settings.json") };
+    out = [];
+    err = [];
+    vi.spyOn(console, "log").mockImplementation((...a) => void out.push(a.join(" ")));
+    vi.spyOn(console, "error").mockImplementation((...a) => void err.push(a.join(" ")));
+    vi.spyOn(process.stdout, "write").mockImplementation(() => true);
+    process.exitCode = undefined;
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    rmSync(dir, { recursive: true, force: true });
+    process.exitCode = undefined;
+});
+const text = () => out.join("\n");
+describe("mcp command handlers", () => {
+    it("adds a stdio server, then lists it", () => {
+        mcpAdd("fs", { command: "npx", arg: ["-y", "server-fs"] }, ctx);
+        expect(text()).toContain('Added MCP server "fs" (stdio)');
+        out = [];
+        mcpList(ctx);
+        expect(text()).toContain("fs");
+        expect(text()).toContain("npx -y server-fs");
+        expect(text()).toContain("(project)");
+    });
+    it("adds an http server with bearer auth and reminds about the token", () => {
+        mcpAdd("gh", { url: "https://mcp.example.com", auth: "bearer", envToken: "GH_TOKEN" }, ctx);
+        expect(text()).toContain('Added MCP server "gh" (streamable-http)');
+        expect(text()).toContain("export GH_TOKEN");
+    });
+    it("errors when neither --command nor --url is given", () => {
+        mcpAdd("bad", {}, ctx);
+        expect(err.join("\n")).toContain("either --command");
+        expect(process.exitCode).toBe(1);
+    });
+    it("errors on an unknown scope", () => {
+        mcpAdd("x", { command: "true", scope: "bogus" }, ctx);
+        expect(err.join("\n")).toContain("Unknown scope");
+        expect(process.exitCode).toBe(1);
+    });
+    it("errors on a bad transport", () => {
+        mcpAdd("x", { url: "https://e.com", transport: "carrier-pigeon" }, ctx);
+        expect(err.join("\n")).toContain("--transport must be");
+        expect(process.exitCode).toBe(1);
+    });
+    it("lists nothing when empty", () => {
+        mcpList(ctx);
+        expect(text()).toContain("No MCP servers configured");
+    });
+    it("removes a server, and reports not-found otherwise", () => {
+        mcpAdd("fs", { command: "true" }, ctx);
+        out = [];
+        mcpRemove("fs", undefined, ctx);
+        expect(text()).toContain('Removed MCP server "fs"');
+        mcpRemove("ghost", undefined, ctx);
+        expect(err.join("\n")).toContain("not found");
+        expect(process.exitCode).toBe(1);
+    });
+    it("enables and disables a server", () => {
+        mcpAdd("fs", { command: "true" }, ctx);
+        out = [];
+        mcpSetEnabled("fs", false, undefined, ctx);
+        expect(text()).toContain('Disabled MCP server "fs"');
+        out = [];
+        mcpSetEnabled("fs", true, undefined, ctx);
+        expect(text()).toContain('Enabled MCP server "fs"');
+    });
+    it("check reports not-found for an unknown server without connecting", async () => {
+        await mcpCheck("ghost", ctx);
+        expect(err.join("\n")).toContain("not found");
+        expect(process.exitCode).toBe(1);
+    });
+    it("check says nothing to do when no servers are enabled", async () => {
+        await mcpCheck(undefined, ctx);
+        expect(text()).toContain("No enabled MCP servers");
+    });
+});
+//# sourceMappingURL=mcp.test.js.map

package/dist/commands/__tests__/mcp.test.js.map

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

package/dist/commands/__tests__/replay.test.d.ts

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

package/dist/commands/__tests__/replay.test.d.ts.map

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

package/dist/commands/__tests__/replay.test.js

@@ -0,0 +1,76 @@
+/**
+ * `oxagen replay` handler — proves --list prints the list, a resolved turn prints
+ * the full report, and an unresolved turn errors to stderr with a non-zero exit.
+ * The trace store and formatter are mocked, so no filesystem is touched.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+vi.mock("../../agent/trace-store.js", () => ({ openTraceStore: vi.fn() }));
+vi.mock("../../agent/trace-format.js", () => ({
+    formatTraceText: vi.fn(() => "FULL REPORT"),
+    formatTraceList: vi.fn(() => "THE LIST"),
+}));
+import { handleReplay } from "../replay.js";
+import { openTraceStore } from "../../agent/trace-store.js";
+const mockOpen = openTraceStore;
+let out = "";
+let err = "";
+const restorers = [];
+function storeWith(over) {
+    mockOpen.mockReturnValue({
+        list: () => [],
+        resolve: () => undefined,
+        get: () => undefined,
+        last: () => undefined,
+        record: () => undefined,
+        ...over,
+    });
+}
+beforeEach(() => {
+    out = "";
+    err = "";
+    process.exitCode = undefined;
+    const outSpy = vi
+        .spyOn(process.stdout, "write")
+        .mockImplementation(((s) => {
+        out += String(s);
+        return true;
+    }));
+    const errSpy = vi
+        .spyOn(process.stderr, "write")
+        .mockImplementation(((s) => {
+        err += String(s);
+        return true;
+    }));
+    restorers.push(() => outSpy.mockRestore(), () => errSpy.mockRestore());
+});
+afterEach(() => {
+    for (const r of restorers.splice(0))
+        r();
+    process.exitCode = undefined;
+});
+describe("handleReplay", () => {
+    it("prints the list with --list", async () => {
+        storeWith({ list: () => [{ id: "a" }] });
+        await handleReplay(undefined, { list: true });
+        expect(out).toContain("THE LIST");
+    });
+    it("prints the full report for a resolved turn", async () => {
+        storeWith({ resolve: (arg) => (arg === "2" ? { id: "x" } : undefined) });
+        await handleReplay("2", {});
+        expect(out).toContain("FULL REPORT");
+        expect(process.exitCode).toBeUndefined();
+    });
+    it("errors to stderr with a non-zero exit when the turn is not found", async () => {
+        storeWith({ resolve: () => undefined });
+        await handleReplay("99", {});
+        expect(err).toContain('No turn matches "99"');
+        expect(process.exitCode).toBe(1);
+    });
+    it("reports the empty case when no turns exist", async () => {
+        storeWith({ resolve: () => undefined });
+        await handleReplay(undefined, {});
+        expect(err).toContain("No turns recorded yet");
+        expect(process.exitCode).toBe(1);
+    });
+});
+//# sourceMappingURL=replay.test.js.map

package/dist/commands/__tests__/replay.test.js.map

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

package/dist/commands/__tests__/rules.test.d.ts

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

package/dist/commands/__tests__/rules.test.d.ts.map

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

package/dist/commands/__tests__/rules.test.js

@@ -0,0 +1,95 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { rulesList, rulesShow, rulesNew, rulesCheck } from "../rules.js";
+let dir;
+let ctx;
+let out;
+let err;
+function writeRule(name, body) {
+    const p = join(dir, ".oxagen", "rules", `${name}.md`);
+    mkdirSync(join(p, ".."), { recursive: true });
+    writeFileSync(p, body, "utf8");
+}
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), "oxagen-cmd-rules-"));
+    ctx = { cwd: dir, userRulesDir: join(dir, "user-rules") };
+    out = [];
+    err = [];
+    vi.spyOn(console, "log").mockImplementation((...a) => void out.push(a.join(" ")));
+    vi.spyOn(console, "error").mockImplementation((...a) => void err.push(a.join(" ")));
+    process.exitCode = undefined;
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    rmSync(dir, { recursive: true, force: true });
+    process.exitCode = undefined;
+});
+const text = () => out.join("\n");
+const errText = () => err.join("\n");
+describe("rules command handlers", () => {
+    it("lists rules and flags enforced ones", () => {
+        writeRule("style", "---\ndescription: match style\n---\nMatch surrounding style.");
+        writeRule("no-mig", "---\ndescription: migrations\nguard-tool: Edit\nguard-deny-path: m/*-applied/**\n---\nAdd a forward migration.");
+        rulesList(ctx);
+        expect(text()).toContain("style");
+        expect(text()).toContain("no-mig  [enforced]");
+    });
+    it("lists nothing when empty", () => {
+        rulesList(ctx);
+        expect(text()).toContain("No rules defined");
+    });
+    it("shows a rule with its guard", () => {
+        writeRule("no-mig", "---\nguard-tool: Edit\nguard-deny-path: m/**\n---\nAdd a forward migration.");
+        rulesShow("no-mig", ctx);
+        expect(text()).toContain("# no-mig");
+        expect(text()).toContain("denyPath=m/**");
+        expect(text()).toContain("Add a forward migration.");
+    });
+    it("errors showing an unknown rule", () => {
+        rulesShow("ghost", ctx);
+        expect(errText()).toContain("Unknown rule");
+        expect(process.exitCode).toBe(1);
+    });
+    it("scaffolds a rule and is idempotent", () => {
+        rulesNew("safety", ctx);
+        expect(text()).toContain("Created rule");
+        expect(existsSync(join(dir, ".oxagen", "rules", "safety.md"))).toBe(true);
+        out = [];
+        rulesNew("safety", ctx);
+        expect(text()).toContain("already exists");
+    });
+    it("rejects an invalid rule name", () => {
+        rulesNew("bad name", ctx);
+        expect(errText()).toContain("Invalid rule name");
+        expect(process.exitCode).toBe(1);
+    });
+    describe("rules check (dry-run)", () => {
+        beforeEach(() => {
+            writeRule("no-mig", "---\nguard-tool: Edit\nguard-deny-path: packages/database/migrations/*-applied/**\n---\nAdd a forward migration instead.");
+            writeRule("no-rm", "---\nguard-tool: Bash\nguard-deny-command: rm -rf*\n---\nNo destructive deletes.");
+        });
+        it("blocks a violating edit and shows the rule", () => {
+            rulesCheck("edit", "packages/database/migrations/0001-applied/up.sql", ctx);
+            expect(text()).toContain("⛔ BLOCKED");
+            expect(text()).toContain("Add a forward migration instead.");
+            expect(process.exitCode).toBe(1);
+        });
+        it("blocks a violating bash command", () => {
+            rulesCheck("bash", "rm -rf /tmp", ctx);
+            expect(text()).toContain("BLOCKED");
+            expect(text()).toContain("No destructive deletes.");
+        });
+        it("allows a non-matching call", () => {
+            rulesCheck("edit", "src/app.ts", ctx);
+            expect(text()).toContain("allowed");
+        });
+        it("errors on an unknown tool", () => {
+            rulesCheck("telepathy", "x", ctx);
+            expect(errText()).toContain("Unknown tool");
+            expect(process.exitCode).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=rules.test.js.map

package/dist/commands/__tests__/rules.test.js.map

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

package/dist/commands/__tests__/settings.test.d.ts

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

package/dist/commands/__tests__/settings.test.d.ts.map

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