@oxagen/cli 0.5.0 → 0.6.0

package/README.md

@@ -23,6 +23,18 @@ pnpm -C apps/cli build
 node apps/cli/dist/index.js --version
 ```
 
+## Interactive mode
+
+Run `oxagen` with no arguments in a terminal to open the interactive TUI: an
+ASCII banner and a keyboard-navigable menu of every command group and command.
+
+- `↑/↓` move · `↵` select · `Esc` back · `q` quit · type to filter
+- Selecting a command opens a form for its arguments and flags, then runs it.
+- Secret inputs (passwords, tokens) are masked.
+
+Disable it (always print help instead) with `OXAGEN_NO_TUI=1`. Non-interactive
+usage — `oxagen <command> …`, pipes, and CI — is unaffected.
+
 ## Authentication
 
 ```bash
@@ -97,6 +109,7 @@ oxagen agent mcp list
 The Oxagen platform itself is an MCP server. Connect Claude Code, Claude Desktop, or Cursor to it using an API key.
 
 **Claude Code**
+
 ```bash
 oxagen api-key create   # copy the key that's printed
 
@@ -107,6 +120,7 @@ claude mcp add oxagen \
 ```
 
 **Claude Desktop** — add to `claude_desktop_config.json`:
+
 ```json
 {
   "mcpServers": {
@@ -120,6 +134,7 @@ claude mcp add oxagen \
 ```
 
 You can also retrieve connection instructions directly:
+
 ```bash
 oxagen system install instructions
 ```
@@ -260,7 +275,6 @@ oxagen document create / list / read
 oxagen archive create
 oxagen asset upload
 oxagen form create / fill / submit
-oxagen brandkit apply
 
 oxagen org create / list
 oxagen org member add / remove / role change / invite accept / invite decline
@@ -326,12 +340,14 @@ oxagen auth login --email you@example.com --password yourpassword
 ## Troubleshooting
 
 **`command not found: oxagen`** — ensure global install succeeded:
+
 ```bash
 npm list -g @oxagen/cli
 npm install -g @oxagen/cli
 ```
 
 **Auth failures** — clear and re-authenticate:
+
 ```bash
 oxagen auth logout && oxagen auth login
 ```
@@ -340,9 +356,51 @@ oxagen auth logout && oxagen auth login
 
 ## Development
 
+### Install the `oxagen` binary onto your PATH (live, auto-rebuilding)
+
+Run this once from the **repo root** and leave it running:
+
+```bash
+pnpm cli:dev
+```
+
+This builds the package, installs an `oxagen` binary onto your PATH, then watches
+`apps/cli/src/**` and rebuilds on every save. After it prints `watching for
+changes…`, open a second terminal and use `oxagen` like a published binary — every
+source edit is live on the next invocation, with no reinstall step:
+
 ```bash
-pnpm -C apps/cli dev -- auth whoami   # run from source with tsx
-pnpm -C apps/cli build                # compile to dist/
+oxagen --version
+oxagen --help
+oxagen auth whoami
+```
+
+**How it works.** The installed binary is a symlink from a PATH directory
+(`~/.local/bin/oxagen` when that's on your PATH) into the package's build output
+(`apps/cli/dist/index.js`). `tsc --watch` rewrites `dist/` in place on every change,
+and because a symlink always resolves to its target's current contents, the on-PATH
+`oxagen` is always the freshly-built code — the "reinstall" is automatic.
+
+Want a one-shot install without the watcher (build once, link, exit)?
+
+```bash
+pnpm cli:install
+```
+
+If `cli:dev` warns that the chosen directory isn't on your PATH, add it to your shell
+profile (the script prints the exact line), e.g.:
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+To uninstall the dev binary, remove the symlink: `rm "$(command -v oxagen)"`.
+
+### Other workflows
+
+```bash
+pnpm -C apps/cli dev -- auth whoami   # run a single command from source with tsx
+pnpm -C apps/cli build                # compile to dist/ once
 pnpm -C apps/cli test:unit            # run unit tests
 pnpm -C apps/cli lint                 # lint (zero warnings enforced)
 pnpm -C apps/cli typecheck            # type-check
@@ -350,6 +408,11 @@ pnpm -C apps/cli typecheck            # type-check
 
 Releases are managed monorepo-wide via `pnpm release:patch|minor|major`, which bumps all packages to the same version and syncs to Vercel.
 
+### Known gaps
+
+See [`GAPS.md`](./GAPS.md) for the tracked completeness, capability-parity, and `--help`
+documentation gaps and their prioritized fix plan.
+
 ---
 
 ## Support

package/dist/agent/__tests__/code-graph.test.d.ts

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

package/dist/agent/__tests__/code-graph.test.d.ts.map

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

package/dist/agent/__tests__/code-graph.test.js

@@ -0,0 +1,83 @@
+/**
+ * Code-graph retrieval — proves the agent can answer structural questions about
+ * a real on-disk project: symbol search, file-symbol listing, and (the part
+ * that was previously broken) import/dependent resolution for impact analysis.
+ */
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import { promises as fs } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { queryCodeGraph, codeGraphStats, clearCodeGraphCache, } from "../code-graph.js";
+let root = "";
+beforeAll(async () => {
+    root = await fs.mkdtemp(join(tmpdir(), "oxagen-cg-"));
+    await fs.writeFile(join(root, "alpha.ts"), [
+        "export function computeAlpha() {",
+        "  return 1;",
+        "}",
+        "export interface AlphaShape {",
+        "  x: number;",
+        "}",
+    ].join("\n"));
+    await fs.writeFile(join(root, "beta.ts"), [
+        'import { computeAlpha } from "./alpha.js";',
+        "export class BetaEngine {}",
+        "export function runBeta() {",
+        "  return computeAlpha();",
+        "}",
+    ].join("\n"));
+    await fs.mkdir(join(root, "sub"), { recursive: true });
+    await fs.writeFile(join(root, "sub", "gamma.ts"), [
+        'import { BetaEngine } from "../beta.js";',
+        'export type GammaKind = "a" | "b";',
+    ].join("\n"));
+});
+afterAll(async () => {
+    clearCodeGraphCache();
+    if (root)
+        await fs.rm(root, { recursive: true, force: true });
+});
+describe("code-graph retrieval", () => {
+    it("search finds where a symbol is defined", async () => {
+        const out = await queryCodeGraph(root, "search", "computeAlpha");
+        expect(out).toContain("computeAlpha");
+        expect(out).toContain("alpha.ts");
+        expect(out).toContain("function");
+    });
+    it("search matches classes and is case-insensitive", async () => {
+        const out = await queryCodeGraph(root, "search", "betaengine");
+        expect(out).toContain("BetaEngine");
+        expect(out).toContain("class");
+    });
+    it("file_symbols lists the symbols a file defines", async () => {
+        const out = await queryCodeGraph(root, "file_symbols", "beta.ts");
+        expect(out).toContain("BetaEngine");
+        expect(out).toContain("runBeta");
+    });
+    it("dependents resolves who imports a file (impact analysis)", async () => {
+        // beta.ts imports alpha.ts → alpha's dependents include beta.ts
+        const alphaDeps = await queryCodeGraph(root, "dependents", "alpha.ts");
+        expect(alphaDeps).toContain("beta.ts");
+        // sub/gamma.ts imports ../beta.js → beta's dependents include sub/gamma.ts
+        const betaDeps = await queryCodeGraph(root, "dependents", "beta.ts");
+        expect(betaDeps).toContain("sub/gamma.ts");
+    });
+    it("imports resolves a file's local imports", async () => {
+        const betaImports = await queryCodeGraph(root, "imports", "beta.ts");
+        expect(betaImports).toContain("alpha.ts");
+        const gammaImports = await queryCodeGraph(root, "imports", "sub/gamma.ts");
+        expect(gammaImports).toContain("beta.ts");
+    });
+    it("reports a clear miss for unknown symbols and files", async () => {
+        expect(await queryCodeGraph(root, "search", "doesNotExist")).toContain("No symbols matching");
+        expect(await queryCodeGraph(root, "dependents", "nope.ts")).toContain("No file matching");
+    });
+    it("stats reflect the indexed fixture", async () => {
+        const stats = await codeGraphStats(root);
+        expect(stats.files).toBe(3);
+        // computeAlpha, AlphaShape, BetaEngine, runBeta, GammaKind
+        expect(stats.symbols).toBeGreaterThanOrEqual(5);
+        expect(stats.edges).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=code-graph.test.js.map

package/dist/agent/__tests__/code-graph.test.js.map

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

package/dist/agent/__tests__/evaluator.test.d.ts

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

package/dist/agent/__tests__/evaluator.test.d.ts.map

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

package/dist/agent/__tests__/evaluator.test.js

@@ -0,0 +1,96 @@
+/**
+ * Prompt evaluator — proves the cheap front-of-pipeline call returns the model's
+ * structured read, clamps out-of-range scores, never drops intent to an empty
+ * rewrite, and degrades to a deterministic heuristic when the model call fails.
+ * The model call is mocked, so no gateway is touched.
+ */
+import { describe, it, expect, beforeEach, vi } from "vitest";
+vi.mock("ai", () => ({ generateObject: vi.fn() }));
+vi.mock("../../lib/config.js", () => ({ readConfig: () => ({}) }));
+import { generateObject } from "ai";
+import { evaluatePrompt } from "../evaluator.js";
+const mockGen = generateObject;
+beforeEach(() => {
+    delete process.env["OXAGEN_LLM_EVALUATOR"];
+    delete process.env["OXAGEN_LLM_FAST"];
+});
+describe("evaluatePrompt", () => {
+    it("returns the model's structured evaluation on the fast tier", async () => {
+        mockGen.mockResolvedValueOnce({
+            object: {
+                completeness: 80,
+                complexity: 40,
+                recommendedTier: "balanced",
+                missing: ["which file"],
+                contextQueries: ["loginUser"],
+                refinedPrompt: "fix loginUser null check",
+                removed: ["please"],
+                reasoning: "clear ask",
+            },
+            usage: { inputTokens: 10, outputTokens: 5 },
+        });
+        const ev = await evaluatePrompt({ prompt: "please fix loginUser" });
+        expect(ev.fallback).toBe(false);
+        expect(ev.completeness).toBe(80);
+        expect(ev.recommendedTier).toBe("balanced");
+        expect(ev.contextQueries).toEqual(["loginUser"]);
+        expect(ev.refinedPrompt).toBe("fix loginUser null check");
+        expect(ev.model).toContain("haiku");
+        expect(ev.usage.inputTokens).toBe(10);
+    });
+    it("clamps scores into 0–100 and rounds them", async () => {
+        mockGen.mockResolvedValueOnce({
+            object: {
+                completeness: 150,
+                complexity: -20,
+                recommendedTier: "fast",
+                missing: [],
+                contextQueries: [],
+                refinedPrompt: "x",
+                removed: [],
+                reasoning: "r",
+            },
+            usage: {},
+        });
+        const ev = await evaluatePrompt({ prompt: "do x" });
+        expect(ev.completeness).toBe(100);
+        expect(ev.complexity).toBe(0);
+    });
+    it("keeps the original prompt when the model returns an empty rewrite", async () => {
+        mockGen.mockResolvedValueOnce({
+            object: {
+                completeness: 50,
+                complexity: 50,
+                recommendedTier: "fast",
+                missing: [],
+                contextQueries: [],
+                refinedPrompt: "   ",
+                removed: [],
+                reasoning: "r",
+            },
+            usage: {},
+        });
+        const ev = await evaluatePrompt({ prompt: "keep me intact" });
+        expect(ev.refinedPrompt).toBe("keep me intact");
+    });
+    it("falls back to a heuristic when the model call throws", async () => {
+        mockGen.mockRejectedValueOnce(new Error("gateway down"));
+        const ev = await evaluatePrompt({ prompt: "implement the stripe billing refund flow" });
+        expect(ev.fallback).toBe(true);
+        // A high-stakes billing prompt routes to precise → complexity 85.
+        expect(ev.recommendedTier).toBe("precise");
+        expect(ev.complexity).toBe(85);
+        expect(ev.refinedPrompt).toBe("implement the stripe billing refund flow");
+        expect(ev.usage.costUsd).toBe(0);
+    });
+    it("heuristic completeness tracks prompt length", async () => {
+        mockGen.mockRejectedValue(new Error("down"));
+        const short = await evaluatePrompt({ prompt: "fix it" });
+        expect(short.completeness).toBe(45);
+        const long = await evaluatePrompt({
+            prompt: "a".repeat(200) + " refactor and debug the module thoroughly",
+        });
+        expect(long.completeness).toBe(80);
+    });
+});
+//# sourceMappingURL=evaluator.test.js.map

package/dist/agent/__tests__/evaluator.test.js.map

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

package/dist/agent/__tests__/fleet-memory.test.d.ts

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

package/dist/agent/__tests__/fleet-memory.test.d.ts.map

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

package/dist/agent/__tests__/fleet-memory.test.js

@@ -0,0 +1,107 @@
+/**
+ * Fleet memory — proves lessons are durably recorded as JSON Lines and that
+ * lexical recall ranks by term overlap, file overlap, and weight. Each test runs
+ * against an isolated $HOME so it never touches the developer's real store.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from "node:fs";
+import { tmpdir, homedir } from "node:os";
+import { join } from "node:path";
+import { openFleetMemory, formatLessons } from "../fleet/memory.js";
+let home = "";
+let prevHome = "";
+const cwd = "/work/myproj";
+beforeEach(() => {
+    prevHome = process.env["HOME"] ?? "";
+    home = mkdtempSync(join(tmpdir(), "oxagen-mem-home-"));
+    process.env["HOME"] = home;
+});
+afterEach(() => {
+    process.env["HOME"] = prevHome;
+    if (home)
+        rmSync(home, { recursive: true, force: true });
+});
+describe("record + all", () => {
+    it("persists records and reads them back newest-first", () => {
+        const mem = openFleetMemory(cwd);
+        mem.record({ kind: "routine-change", weight: "low", lesson: "first lesson", files: [], outcome: "success" });
+        mem.record({ kind: "gotcha", weight: "high", lesson: "second lesson", files: ["a.ts"], outcome: "failure" });
+        const all = mem.all();
+        expect(all).toHaveLength(2);
+        expect(all.map((r) => r.lesson)).toContain("first lesson");
+        expect(all.map((r) => r.lesson)).toContain("second lesson");
+        // ids and timestamps are assigned by the store.
+        expect(all.every((r) => r.id.startsWith("mem_") && r.createdAt > 0)).toBe(true);
+    });
+    it("persists across separate openFleetMemory instances (reads the file)", () => {
+        openFleetMemory(cwd).record({
+            kind: "constraint",
+            weight: "critical",
+            lesson: "keep the cache warm",
+            files: [],
+            outcome: "success",
+        });
+        const reopened = openFleetMemory(cwd);
+        expect(reopened.all().some((r) => r.lesson === "keep the cache warm")).toBe(true);
+    });
+    it("HOME isolation actually points the store under the temp home", () => {
+        expect(homedir()).toBe(home);
+    });
+});
+describe("recall", () => {
+    it("ranks by term overlap and ignores irrelevant lessons", () => {
+        const mem = openFleetMemory(cwd);
+        mem.record({ kind: "bug-root-cause", weight: "low", lesson: "the parser drops the final token", files: ["parser.ts"], outcome: "success" });
+        mem.record({ kind: "routine-change", weight: "low", lesson: "stylesheet needs a vendor prefix", files: ["style.css"], outcome: "success" });
+        const hits = mem.recall("why does the parser lose a token");
+        expect(hits.length).toBeGreaterThanOrEqual(1);
+        expect(hits[0]?.lesson).toContain("parser");
+        expect(hits.some((h) => h.files.includes("style.css"))).toBe(false);
+    });
+    it("weights file overlap above term overlap", () => {
+        const mem = openFleetMemory(cwd);
+        mem.record({ kind: "gotcha", weight: "low", lesson: "unrelated words entirely", files: ["target.ts"], outcome: "success" });
+        mem.record({ kind: "gotcha", weight: "low", lesson: "the target logic is fragile", files: ["other.ts"], outcome: "success" });
+        // Query term "target" hits the second lesson's text, but the file filter
+        // matches the first lesson's file — and file overlap is weighted higher.
+        const hits = mem.recall("target", { files: ["target.ts"] });
+        expect(hits[0]?.files).toEqual(["target.ts"]);
+    });
+    it("returns nothing when there is no overlap", () => {
+        const mem = openFleetMemory(cwd);
+        mem.record({ kind: "gotcha", weight: "low", lesson: "alpha beta gamma", files: [], outcome: "success" });
+        expect(mem.recall("zzz qqq xxx")).toHaveLength(0);
+    });
+    it("tolerates a corrupt line already on disk", () => {
+        const dir = join(home, ".config", "oxagen", "memories");
+        mkdirSync(dir, { recursive: true });
+        const good = {
+            id: "mem_x",
+            createdAt: 1,
+            kind: "gotcha",
+            weight: "high",
+            lesson: "real lesson about widgets",
+            files: [],
+            outcome: "success",
+        };
+        writeFileSync(join(dir, "myproj.jsonl"), `not json\n${JSON.stringify(good)}\n`, "utf8");
+        const mem = openFleetMemory(cwd);
+        expect(mem.recall("widgets")[0]?.lesson).toBe("real lesson about widgets");
+    });
+});
+describe("formatLessons", () => {
+    it("marks weight and lists files", () => {
+        const records = [
+            { id: "1", createdAt: 1, kind: "constraint", weight: "critical", lesson: "A", files: ["x.ts"], outcome: "success" },
+            { id: "2", createdAt: 2, kind: "gotcha", weight: "high", lesson: "B", files: [], outcome: "success" },
+            { id: "3", createdAt: 3, kind: "routine-change", weight: "low", lesson: "C", files: [], outcome: "success" },
+        ];
+        const out = formatLessons(records);
+        expect(out).toContain("‼");
+        expect(out).toContain("!");
+        expect(out).toContain("·");
+        expect(out).toContain("[x.ts]");
+        expect(formatLessons([])).toBe("");
+    });
+});
+//# sourceMappingURL=fleet-memory.test.js.map

package/dist/agent/__tests__/fleet-memory.test.js.map

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

package/dist/agent/__tests__/fleet-store.test.d.ts

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

package/dist/agent/__tests__/fleet-store.test.d.ts.map

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

package/dist/agent/__tests__/fleet-store.test.js

@@ -0,0 +1,93 @@
+/**
+ * Plan store — proves plans and their tasks round-trip to disk, that re-saving a
+ * plan replaces rather than duplicates it, and that history is bounded. Isolated
+ * to a temp $HOME.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { openPlanStore } from "../fleet/store.js";
+import { emptyUsage } from "../fleet/types.js";
+let home = "";
+let prevHome = "";
+const cwd = "/work/myproj";
+function task(id, over = {}) {
+    return {
+        id,
+        title: id,
+        description: id,
+        status: "queued",
+        dependsOn: [],
+        files: [],
+        tier: "balanced",
+        model: "anthropic/claude-sonnet-4.6",
+        createdAt: 1,
+        usage: emptyUsage(),
+        ...over,
+    };
+}
+function plan(id, tasks) {
+    return { id, goal: `goal ${id}`, createdAt: 1, tasks, status: "draft" };
+}
+beforeEach(() => {
+    prevHome = process.env["HOME"] ?? "";
+    home = mkdtempSync(join(tmpdir(), "oxagen-store-home-"));
+    process.env["HOME"] = home;
+});
+afterEach(() => {
+    process.env["HOME"] = prevHome;
+    if (home)
+        rmSync(home, { recursive: true, force: true });
+});
+describe("openPlanStore", () => {
+    it("returns empty results before anything is saved", () => {
+        const store = openPlanStore(cwd);
+        expect(store.list()).toEqual([]);
+        expect(store.get("nope")).toBeUndefined();
+    });
+    it("saves and reads a plan back", () => {
+        const store = openPlanStore(cwd);
+        const p = plan("p1", [task("a"), task("b")]);
+        store.save(p);
+        expect(store.get("p1")?.goal).toBe("goal p1");
+        expect(store.list()).toHaveLength(1);
+    });
+    it("replaces a plan on re-save instead of duplicating", () => {
+        const store = openPlanStore(cwd);
+        store.save(plan("p1", [task("a")]));
+        store.save(plan("p1", [task("a"), task("b")]));
+        expect(store.list()).toHaveLength(1);
+        expect(store.get("p1")?.tasks).toHaveLength(2);
+    });
+    it("updates a single task in place", () => {
+        const store = openPlanStore(cwd);
+        store.save(plan("p1", [task("a"), task("b")]));
+        store.updateTask("p1", task("a", { status: "done", summary: "did it" }));
+        const got = store.get("p1");
+        expect(got?.tasks.find((t) => t.id === "a")?.status).toBe("done");
+        expect(got?.tasks.find((t) => t.id === "b")?.status).toBe("queued");
+    });
+    it("sets a plan's lifecycle status", () => {
+        const store = openPlanStore(cwd);
+        store.save(plan("p1", [task("a")]));
+        store.setStatus("p1", "completed");
+        expect(store.get("p1")?.status).toBe("completed");
+    });
+    it("no-ops on updateTask/setStatus for an unknown plan", () => {
+        const store = openPlanStore(cwd);
+        expect(() => store.updateTask("ghost", task("a"))).not.toThrow();
+        expect(() => store.setStatus("ghost", "failed")).not.toThrow();
+    });
+    it("bounds stored history to the 50 most recent plans", () => {
+        const store = openPlanStore(cwd);
+        for (let i = 0; i < 55; i++)
+            store.save(plan(`p${i}`, [task("a")]));
+        const list = store.list();
+        expect(list).toHaveLength(50);
+        // Newest first: p54 present, the earliest plans evicted.
+        expect(list[0]?.id).toBe("p54");
+        expect(list.some((p) => p.id === "p0")).toBe(false);
+    });
+});
+//# sourceMappingURL=fleet-store.test.js.map

package/dist/agent/__tests__/fleet-store.test.js.map

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

package/dist/agent/__tests__/git-isolation.test.d.ts

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

package/dist/agent/__tests__/git-isolation.test.d.ts.map

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