magus-cli 7.9.1 → 7.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "magus-cli",
-  "version": "7.9.1",
+  "version": "7.10.0",
   "description": "TUI tool for managing Claude Code plugins, MCPs, and configuration",
   "type": "module",
   "main": "src/main.tsx",
@@ -65,8 +65,8 @@
     "typescript": "^5.6.3"
   },
   "optionalDependencies": {
-    "magus-cli-darwin-arm64": "7.9.1",
-    "magus-cli-darwin-x64": "7.9.1",
-    "magus-cli-linux-x64": "7.9.1"
+    "magus-cli-darwin-arm64": "7.10.0",
+    "magus-cli-darwin-x64": "7.10.0",
+    "magus-cli-linux-x64": "7.10.0"
   }
 }

package/src/__tests__/blind/plugin-deps/doctor.test.ts

@@ -174,6 +174,7 @@ describe("magus doctor black-box contract", () => {
 				"plugins_needing_update",
 				"schema",
 				"unfixable",
+				"worktreesWithoutProfile",
 			]);
 			expect(new Set(report.plugins)).toEqual(
 				new Set(["user-tool@test", "project-tool@test", "local-tool@test"]),

package/src/__tests__/plugin-mcp-source-shapes.test.ts

@@ -0,0 +1,250 @@
+/**
+ * Marketplace plugin `source` comes in two shapes: a string path
+ * ("./plugins/foo") or an object (git-subdir / github / url). Only a string
+ * source has an on-disk MCP config under the marketplace clone.
+ *
+ * Regression guarded: the Plugins screen does
+ *   src = await getPluginSourcePath(mp, name); if (!src) skip;
+ *   await getPluginEnvRequirements(mp, src)
+ * and an object source used to throw `pluginSource.replace is not a function`.
+ *
+ * The module resolves the home directory at import time, and Bun's
+ * os.homedir() ignores a HOME changed at runtime, so every scenario runs in a
+ * child bun process with HOME pointed at a temp directory.
+ */
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
+import { spawnSync } from "node:child_process";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const MODULE_PATH = path.resolve(
+	import.meta.dir,
+	"../services/plugin-mcp-config.ts",
+);
+const MP = "testmp";
+
+const CHILD_SCRIPT = `
+import { getPluginSourcePath, getPluginEnvRequirements } from ${JSON.stringify(MODULE_PATH)};
+
+const input = JSON.parse(process.env.MCP_SHAPES_INPUT ?? "{}");
+const out = {};
+
+try {
+	const sp = await getPluginSourcePath(input.mp, input.plugin);
+	out.sourcePathType = typeof sp;
+	out.sourcePath = sp === undefined ? null : sp;
+	out.sourcePathOk = true;
+} catch (e) {
+	out.sourcePathOk = false;
+	out.sourcePathError = String(e && e.message ? e.message : e);
+}
+
+// The exact Plugins-screen sequence.
+try {
+	const src = await getPluginSourcePath(input.mp, input.plugin);
+	if (!src) {
+		out.sequence = { ok: true, skipped: true };
+	} else {
+		const reqs = await getPluginEnvRequirements(input.mp, src);
+		out.sequence = { ok: true, skipped: false, names: reqs.map((r) => r.name) };
+	}
+} catch (e) {
+	out.sequence = { ok: false, error: String(e && e.message ? e.message : e) };
+}
+
+if (typeof input.direct === "string") {
+	try {
+		const reqs = await getPluginEnvRequirements(input.mp, input.direct);
+		out.direct = {
+			ok: true,
+			reqs: reqs.map((r) => ({ name: r.name, serverName: r.serverName })),
+		};
+	} catch (e) {
+		out.direct = { ok: false, error: String(e && e.message ? e.message : e) };
+	}
+}
+
+process.stdout.write("__RESULT__" + JSON.stringify(out) + "\\n");
+`;
+
+interface ChildResult {
+	sourcePathOk: boolean;
+	sourcePathError?: string;
+	sourcePathType?: string;
+	sourcePath?: unknown;
+	sequence: {
+		ok: boolean;
+		skipped?: boolean;
+		names?: string[];
+		error?: string;
+	};
+	direct?: {
+		ok: boolean;
+		reqs?: Array<{ name: string; serverName: string }>;
+		error?: string;
+	};
+}
+
+let tmpHome: string;
+let scriptPath: string;
+
+async function writeMarketplace(
+	plugins: Array<{ name: string; source: unknown }>,
+): Promise<void> {
+	const dir = path.join(
+		tmpHome,
+		".claude",
+		"plugins",
+		"marketplaces",
+		MP,
+		".claude-plugin",
+	);
+	await fs.mkdir(dir, { recursive: true });
+	await fs.writeFile(
+		path.join(dir, "marketplace.json"),
+		JSON.stringify({ name: MP, plugins }, null, 2),
+	);
+}
+
+async function writeMcpConfig(
+	relSource: string,
+	config: Record<string, unknown>,
+): Promise<void> {
+	const dir = path.join(
+		tmpHome,
+		".claude",
+		"plugins",
+		"marketplaces",
+		MP,
+		relSource.replace(/^\.\//, ""),
+		"mcp-servers",
+	);
+	await fs.mkdir(dir, { recursive: true });
+	await fs.writeFile(
+		path.join(dir, "mcp-config.json"),
+		JSON.stringify(config, null, 2),
+	);
+}
+
+function runChild(input: {
+	mp: string;
+	plugin: string;
+	direct?: string;
+}): ChildResult {
+	const res = spawnSync("bun", ["--no-env-file", scriptPath], {
+		cwd: tmpHome,
+		env: {
+			...process.env,
+			HOME: tmpHome,
+			MCP_SHAPES_INPUT: JSON.stringify(input),
+		},
+		encoding: "utf-8",
+		timeout: 30_000,
+	});
+	const stdout = res.stdout ?? "";
+	const line = stdout.split("\n").find((l) => l.startsWith("__RESULT__"));
+	if (!line) {
+		throw new Error(
+			`child produced no result (status ${res.status})\nstdout:\n${stdout}\nstderr:\n${res.stderr ?? ""}`,
+		);
+	}
+	return JSON.parse(line.slice("__RESULT__".length)) as ChildResult;
+}
+
+beforeEach(async () => {
+	tmpHome = await fs.mkdtemp(path.join(os.tmpdir(), "mcp-source-shapes-"));
+	scriptPath = path.join(tmpHome, "child.ts");
+	await fs.writeFile(scriptPath, CHILD_SCRIPT);
+});
+
+afterEach(async () => {
+	await fs.rm(tmpHome, { recursive: true, force: true });
+});
+
+describe("string source", () => {
+	test("getPluginSourcePath returns the string and env requirements resolve from its mcp-config", async () => {
+		await writeMarketplace([{ name: "foo", source: "./plugins/foo" }]);
+		await writeMcpConfig("./plugins/foo", {
+			"foo-server": {
+				command: "node",
+				args: ["server.js"],
+				env: { FOO_TOKEN: "${FOO_TOKEN}" },
+			},
+		});
+
+		const r = runChild({ mp: MP, plugin: "foo", direct: "./plugins/foo" });
+
+		expect(r.sourcePathOk).toBe(true);
+		expect(r.sourcePathType).toBe("string");
+		expect(r.sourcePath).toBe("./plugins/foo");
+
+		expect(r.direct?.ok).toBe(true);
+		const names = (r.direct?.reqs ?? []).map((q) => q.name);
+		expect(names).toContain("FOO_TOKEN");
+		const foo = r.direct?.reqs?.find((q) => q.name === "FOO_TOKEN");
+		expect(foo?.serverName).toBe("foo-server");
+
+		// The Plugins-screen sequence reaches the same requirement.
+		expect(r.sequence.ok).toBe(true);
+		expect(r.sequence.skipped).toBe(false);
+		expect(r.sequence.names).toContain("FOO_TOKEN");
+	});
+});
+
+describe("object source", () => {
+	const shapes: Array<[string, Record<string, unknown>]> = [
+		[
+			"git-subdir",
+			{
+				source: "git-subdir",
+				url: "https://github.com/expo/skills.git",
+				path: "plugins/expo",
+				ref: "main",
+			},
+		],
+		["github", { source: "github", repo: "owner/name" }],
+		["url", { source: "url", url: "https://example.com/x.git" }],
+	];
+
+	for (const [label, source] of shapes) {
+		test(`${label}: getPluginSourcePath returns undefined, not the object`, async () => {
+			await writeMarketplace([
+				{ name: "foo", source: "./plugins/foo" },
+				{ name: "remote", source },
+			]);
+			await writeMcpConfig("./plugins/foo", {
+				"foo-server": { env: { FOO_TOKEN: "${FOO_TOKEN}" } },
+			});
+
+			const r = runChild({ mp: MP, plugin: "remote" });
+
+			expect(r.sourcePathError).toBeUndefined();
+			expect(r.sourcePathOk).toBe(true);
+			expect(r.sourcePathType).toBe("undefined");
+			expect(r.sourcePathType).not.toBe("object");
+		});
+
+		test(`${label}: the Plugins-screen sequence resolves without throwing`, async () => {
+			await writeMarketplace([{ name: "remote", source }]);
+
+			const r = runChild({ mp: MP, plugin: "remote" });
+
+			expect(r.sequence.error).toBeUndefined();
+			expect(r.sequence.ok).toBe(true);
+		});
+	}
+});
+
+describe("unknown plugin", () => {
+	test("getPluginSourcePath returns undefined for a name not in the marketplace", async () => {
+		await writeMarketplace([{ name: "foo", source: "./plugins/foo" }]);
+
+		const r = runChild({ mp: MP, plugin: "does-not-exist" });
+
+		expect(r.sourcePathOk).toBe(true);
+		expect(r.sourcePathType).toBe("undefined");
+		expect(r.sequence.ok).toBe(true);
+		expect(r.sequence.skipped).toBe(true);
+	});
+});