magus-cli 7.7.0 → 7.9.0

package/src/__tests__/toolchain.test.ts

@@ -2,12 +2,13 @@ import { describe, expect, test } from "bun:test";
 import {
 	PYTHON_CLI_INSTALLERS,
 	type PythonCliInstaller,
-	binInstallCommand,
 	binUpgradeCommand,
-	detectToolchains,
+	managedBins,
+	managedInstallCommand,
+	managedOption,
+	managedTool,
 	resolvePythonCliInstaller,
 } from "../services/toolchain.js";
-import type { ResolvedBin } from "../types/index.js";
 import { formatCommand } from "../utils/command-utils.js";
 
 /**
@@ -26,21 +27,21 @@ const UV = byProbe("uv");
 const PIPX = byProbe("pipx");
 const PY = byProbe("python3");
 
-describe("binInstallCommand", () => {
+describe("managedInstallCommand (rendered by requires-probe's renderInstall)", () => {
 	test("bun with and without a version pin", () => {
 		expect(
 			formatCommand(
-				binInstallCommand({
+				managedInstallCommand({
 					name: "claudish",
 					via: "bun",
 					package: "claudish",
 					version: "1.2.0",
 				}),
 			),
-		).toBe("bun install -g claudish@1.2.0");
+		).toBe("bun add -g claudish@1.2.0");
 		expect(
-			formatCommand(binInstallCommand({ name: "claudish", via: "bun" })),
-		).toBe("bun install -g claudish");
+			formatCommand(managedInstallCommand({ name: "claudish", via: "bun" })),
+		).toBe("bun add -g claudish");
 	});
 
 	test("the package name is ONE argv token, whatever is in it", () => {
@@ -51,18 +52,18 @@ describe("binInstallCommand", () => {
 		// words and a command separator. As argv it cannot be anything but a
 		// (nonexistent) package name, so the install fails instead of running.
 		const evil = "a b; rm -rf /";
-		const cmd = binInstallCommand({ name: "x", via: "bun", package: evil });
+		const cmd = managedInstallCommand({ name: "x", via: "bun", package: evil });
 		expect(cmd.cmd).toBe("bun");
-		expect(cmd.args).toEqual(["install", "-g", evil]);
+		expect(cmd.args).toEqual(["add", "-g", evil]);
 		expect(cmd.args.at(-1)).toBe(evil); // unsplit: still exactly one token
 		// ...and rendering it for display quotes it rather than emitting syntax.
-		expect(formatCommand(cmd)).toBe("bun install -g 'a b; rm -rf /'");
+		expect(formatCommand(cmd)).toBe("bun add -g 'a b; rm -rf /'");
 	});
 
 	test("a version pin joins the package as one token, not two", () => {
 		// Splitting `pkg@version` would ask the installer for two packages, the
 		// second of which is a version number.
-		const cmd = binInstallCommand({
+		const cmd = managedInstallCommand({
 			name: "claudish",
 			via: "bun",
 			version: "1.2.0",
@@ -76,24 +77,32 @@ describe("binInstallCommand", () => {
 		// quotes nothing and the printed line is byte-identical to the string
 		// these builders returned before they returned argv.
 		expect(
-			formatCommand(binInstallCommand({ name: "x", via: "npm", package: "x" })),
+			formatCommand(
+				managedInstallCommand({ name: "x", via: "npm", package: "x" }),
+			),
 		).toBe("npm install -g x");
 		expect(
 			formatCommand(
-				binInstallCommand(
-					{ name: "aider", via: "pip", package: "aider", version: "0.1" },
-					UV,
-				),
+				managedInstallCommand({
+					name: "aider",
+					via: "pip",
+					package: "aider",
+					version: "0.1",
+				}),
 			),
 		).toBe("uv tool install aider==0.1");
 		expect(
 			formatCommand(
-				binInstallCommand({ name: "tmux", via: "brew", formula: "tmux" }),
+				managedInstallCommand({ name: "tmux", via: "brew", formula: "tmux" }),
 			),
 		).toBe("brew install tmux");
 		expect(
 			formatCommand(
-				binInstallCommand({ name: "t", via: "go", module: "github.com/x/t" }),
+				managedInstallCommand({
+					name: "t",
+					via: "go",
+					module: "github.com/x/t",
+				}),
 			),
 		).toBe("go install github.com/x/t@latest");
 	});
@@ -132,7 +141,7 @@ describe("binUpgradeCommand", () => {
 			// they are distinct references — so comparing them directly would be
 			// an assertion that cannot fail.
 			expect(formatCommand(binUpgradeCommand(bin, python))).not.toBe(
-				formatCommand(binInstallCommand(bin, python)),
+				formatCommand(managedInstallCommand(bin)),
 			);
 		}
 	});
@@ -172,20 +181,11 @@ describe("resolvePythonCliInstaller", () => {
 	});
 
 	test("a version pin is expressed in the installer's own syntax", () => {
-		expect(
-			formatCommand(
-				binInstallCommand({ name: "a", via: "pip", version: "1.2" }, UV),
-			),
-		).toBe("uv tool install a==1.2");
-		expect(
-			formatCommand(
-				binInstallCommand({ name: "a", via: "pip", version: "1.2" }, PIPX),
-			),
-		).toBe("pipx install a==1.2");
+		expect(PIPX.install("a", "1.2").args).toEqual(["install", "a==1.2"]);
 		// `a==1.2` is one token. Two would ask uv to install a package called
 		// "1.2".
 		expect(
-			binInstallCommand({ name: "a", via: "pip", version: "1.2" }, UV).args,
+			managedInstallCommand({ name: "a", via: "pip", version: "1.2" }).args,
 		).toEqual(["tool", "install", "a==1.2"]);
 	});
 
@@ -207,26 +207,97 @@ describe("resolvePythonCliInstaller", () => {
 	});
 });
 
-describe("detectToolchains", () => {
-	test("groups bins by installer and reports requiredBy + presence", async () => {
-		const bins: ResolvedBin[] = [
-			{ name: "claudish", via: "bun", sources: ["a"] },
-			{ name: "mnemex", via: "bun", sources: ["b"] },
-			{ name: "tmux", via: "brew", sources: ["c"] },
-		];
-		const statuses = await detectToolchains(bins);
-		const bun = statuses.find((s) => s.name === "bun")!;
-		const brew = statuses.find((s) => s.name === "brew")!;
-		expect(bun.requiredBy.sort()).toEqual(["claudish", "mnemex"]);
-		expect(brew.requiredBy).toEqual(["tmux"]);
-		// bun/brew are bootstrappable; the field is populated.
-		expect(bun.bootstrap).toContain("bun.sh");
-		expect(typeof bun.present).toBe("boolean");
-		// stable order: bun before brew
-		expect(statuses.map((s) => s.name)).toEqual(["bun", "brew"]);
-	});
-
-	test("returns only toolchains actually needed (empty for no bins)", async () => {
-		expect(await detectToolchains([])).toEqual([]);
+describe("managedTool — the version-managed view of a requirement", () => {
+	test("bun/npm/pip/go/brew options map onto the managed shape, pin included", () => {
+		expect(
+			managedTool({
+				name: "claudish",
+				check: ["claudish", "--version"],
+				install: [],
+				chosen: { via: "bun", package: "claudish", version: "1.2.0" },
+			}),
+		).toEqual({
+			name: "claudish",
+			via: "bun",
+			package: "claudish",
+			check: "claudish --version",
+			version: "1.2.0",
+		});
+		expect(
+			managedTool({
+				name: "t",
+				check: ["t"],
+				install: [],
+				chosen: { via: "go", package: "github.com/x/t" },
+			}),
+		).toMatchObject({ via: "go", module: "github.com/x/t" });
+		expect(
+			managedTool({
+				name: "tmux",
+				check: ["tmux", "-V"],
+				install: [],
+				chosen: { via: "brew", formula: "tmux" },
+			}),
+		).toMatchObject({ via: "brew", formula: "tmux" });
+	});
+
+	test("apt, release, bootstrap and the uv kinds have no managed version", () => {
+		const base = { name: "x", check: ["x"], install: [] };
+		for (const chosen of [
+			{ via: "apt" as const, packages: ["x"] },
+			{ via: "bootstrap" as const, tool: "uv" as const },
+			{ via: "uv-script" as const, script: "s.py", args: [] },
+			{ via: "uv-module" as const, script: "s.py", module: "m", args: [] },
+		]) {
+			expect(managedTool({ ...base, chosen })).toBeNull();
+		}
+		expect(managedTool({ ...base, chosen: null })).toBeNull();
+	});
+
+	test("managedBins keeps provenance and drops what is not managed", () => {
+		const bins = managedBins([
+			{
+				name: "a",
+				check: ["a"],
+				install: [],
+				chosen: { via: "npm", package: "a" },
+				sources: ["plugin:p@m"],
+			},
+			{
+				name: "b",
+				check: ["b"],
+				install: [],
+				chosen: { via: "apt", packages: ["b"] },
+				sources: ["plugin:p@m"],
+			},
+		]);
+		expect(bins).toEqual([
+			{
+				name: "a",
+				via: "npm",
+				package: "a",
+				check: "a",
+				sources: ["plugin:p@m"],
+			},
+		]);
+	});
+
+	test("managedOption round-trips through managedTool", () => {
+		for (const t of [
+			{ name: "c", via: "bun" as const, package: "c", version: "1" },
+			{ name: "t", via: "brew" as const, formula: "tmux" },
+			{ name: "g", via: "go" as const, module: "github.com/x/g" },
+			{ name: "p", via: "pip" as const, package: "p" },
+		]) {
+			const option = managedOption(t);
+			expect(
+				managedTool({
+					name: t.name,
+					check: [t.name],
+					install: [option],
+					chosen: option,
+				}),
+			).toMatchObject(t);
+		}
 	});
 });

package/src/__tests__/update-apply.test.ts

@@ -26,7 +26,6 @@ import type {
 	UpdatePlan,
 } from "../services/update-plan.js";
 import type { InstalledPluginEntry, ResolvedBin } from "../types/index.js";
-import { noMoveReasons } from "../ui/adapters/pluginsAdapter.js";
 
 const PROJECT = "/tmp/project";
 
@@ -776,25 +775,6 @@ describe("applyPlugins — read-back against beforeVersions", () => {
 		expect(result.ok).toBe(1);
 		expect(result.unchanged).toEqual([]);
 	});
-
-	test("the TUI's collector names the same cause the CLI prints", async () => {
-		// The screen used to branch on `failed.length` alone: a no-op update
-		// closed with a success and a row that had not moved.
-		const { deps } = stubDeps("1.0.0");
-		const reasons = noMoveReasons();
-		const result = await applyPlugins(
-			[item({ beforeVersions: { project: "1.0.0" } })],
-			PROJECT,
-			deps,
-			reasons.reporter,
-		);
-		expect(result.unchanged).toEqual(["dev@magus"]);
-		expect(reasons.lines(result.unchanged)).toEqual([
-			"dev@magus: the installer exited 0 but dev@magus is still 1.0.0",
-		]);
-		// An item with no recorded cause still gets a line.
-		expect(reasons.lines(["other@magus"])).toEqual(["other@magus"]);
-	});
 });
 
 // ── B4: installed must mean LOADED ──────────────────────────────────────────
@@ -847,8 +827,7 @@ describe("B4: an install or update ends with the loader on the new version", ()
 			{
 				ok: true,
 				name: "dev@magus",
-				detail:
-					"project → 2.0.0 · Claude Code now loads v2.0.0 here (3 older records moved forward)",
+				detail: "project → 2.0.0 · Claude Code now loads v2.0.0 in this folder",
 			},
 		]);
 	});
@@ -876,8 +855,10 @@ describe("B4: an install or update ends with the loader on the new version", ()
 			{
 				ok: false,
 				name: "dev@magus",
+				// The version still loading IS the reason; the repair's own message
+				// said it a second time, in the mechanism's words.
 				detail:
-					"installed v2.0.0, but Claude Code still loads v1.0.0 here — the loader still resolves v1.0.0 here, not v2.0.0",
+					"installed v2.0.0, but Claude Code still loads v1.0.0 in this folder",
 			},
 		]);
 	});
@@ -917,7 +898,7 @@ describe("B4: an install or update ends with the loader on the new version", ()
 		await expect(
 			updatePluginInScope("dev@magus", "project", PROJECT, deps),
 		).rejects.toThrow(
-			"installed v2.0.0, but Claude Code still loads v1.0.0 here",
+			"installed v2.0.0, but Claude Code still loads v1.0.0 in this folder",
 		);
 	});
 
@@ -938,7 +919,9 @@ describe("B4: an install or update ends with the loader on the new version", ()
 		const { deps } = loaderDeps("1.0.0", false);
 		await expect(
 			updatePluginInScope("dev@magus", "user", PROJECT, deps),
-		).rejects.toThrow("the loader still resolves v1.0.0 here, not v2.0.0");
+		).rejects.toThrow(
+			"installed v2.0.0, but Claude Code still loads v1.0.0 in this folder",
+		);
 	});
 });
 
@@ -1067,7 +1050,8 @@ describe("7.5.2: an update Claude Code applied to another project's row", () =>
 			{
 				ok: true,
 				name: "dev@magus",
-				detail: `project → 8.1.3 · Claude Code updated ${OTHER} instead of this project — moved this project's record to v8.1.3 too`,
+				detail:
+					"project → 8.1.3 · Claude Code updated another folder of this repository instead of this one — this folder now loads v8.1.3 too",
 			},
 		]);
 	});
@@ -1084,7 +1068,7 @@ describe("7.5.2: an update Claude Code applied to another project's row", () =>
 		// forward by the loader check (B4), and no misdirection is reported.
 		expect(repaired).toEqual(["8.1.3"]);
 		expect(rows[0]?.detail).toBe(
-			"project → 8.1.3 · Claude Code now loads v8.1.3 here (1 older record moved forward)",
+			"project → 8.1.3 · Claude Code now loads v8.1.3 in this folder",
 		);
 	});
 
@@ -1097,7 +1081,7 @@ describe("7.5.2: an update Claude Code applied to another project's row", () =>
 		expect(row(HERE).version).toBe("8.0.0");
 		expect(result.unchanged).toEqual(["dev@magus"]);
 		expect(rows[0]?.detail).toBe(
-			`no change — the installer exited 0 but dev@magus is still 8.0.0 (Claude Code updated ${OTHER} instead of this project, and this project's record could not follow: no cache directory for v8.1.3)`,
+			"no change — the installer exited 0 but dev@magus is still 8.0.0 (Claude Code updated another folder of this repository instead of this one, and this folder could not follow: no cache directory for v8.1.3)",
 		);
 	});
 
@@ -1125,7 +1109,7 @@ describe("7.5.2: an update Claude Code applied to another project's row", () =>
 		expect(repaired).toEqual([]);
 		expect(result.unchanged).toEqual(["dev@magus"]);
 		expect(rows[0]?.detail).toBe(
-			`no change — the installer exited 0 but dev@magus is still 8.0.0 (Claude Code updated ${OTHER} instead of this project, and this project's record could not follow: it went to v8.5.0, not the v8.1.3 this update asked for)`,
+			"no change — the installer exited 0 but dev@magus is still 8.0.0 (Claude Code updated another folder of this repository instead of this one, and this folder could not follow: it went to v8.5.0, not the v8.1.3 this update asked for)",
 		);
 	});
 

package/src/__tests__/update-plan.test.ts

@@ -430,19 +430,23 @@ describe("per-scope decisions — a stale scope is never masked", () => {
 		// No note: there is nothing for the reader to do about it.
 		expect(item.note).toBeUndefined();
 		// And it is not confused with the withdrawn case, which is the next test.
-		expect(item.reason).not.toBe("not-offered");
+		expect(item.reason).not.toBe("deprecated");
 	});
 
-	test("an installed plugin ABSENT from every catalog is 'not offered'", () => {
+	test("a declared plugin ABSENT from every catalog is deprecated", () => {
 		// The genuinely withdrawn case: no catalog entry at all, the installed
 		// version known only from the registry.
 		const [item] = planPluginUpdates(
 			{ "withdrawn@magus": "latest" },
 			catalog(info({ id: "dev@magus", version: "4.6.1" })),
 		);
-		expect(item.action).toBe("unknown");
-		expect(item.note).toContain("not offered by any configured marketplace");
-		expect(item.reason).toBe("not-offered");
+		// Its marketplace was read and does not list it: no longer published, so
+		// the work is removing it — here from the profile alone, since nothing is
+		// installed to uninstall.
+		expect(item.action).toBe("remove");
+		expect(item.note).toBe("no longer published");
+		expect(item.reason).toBe("deprecated");
+		expect(item.scopes).toEqual([]);
 	});
 });
 
@@ -855,7 +859,7 @@ describe("binNeedsWork — one predicate for apply, the meter and 'has work'", (
 				{ ...itemFor("upgrade"), name: "mnemex", target: "1.0.0" },
 				spec,
 			),
-		).toEqual({ cmd: "bun", args: ["install", "-g", "mnemex@1.0.0"] });
+		).toEqual({ cmd: "bun", args: ["add", "-g", "mnemex@1.0.0"] });
 		expect(
 			binCommandFor(
 				{ ...itemFor("upgrade"), target: "2.0.0" },
@@ -993,19 +997,20 @@ describe("classifyPlugin — an orphan is never 'current'", () => {
 				info({ id: "dev@magus", version: "4.7.0" }),
 			),
 		);
-		expect(item.action).toBe("unknown");
+		expect(item.action).toBe("remove");
 		expect(item.action).not.toBe("current");
 		expect(item.available).toBeNull();
 		expect(item.target).toBeNull();
-		expect(item.scopes).toEqual([]);
+		// A removal's scopes are where it is uninstalled: every scope installed here.
+		expect(item.scopes).toEqual(["project"]);
 	});
 
 	// `moved` is GONE, and `movedTo` with it. It was inferred from a bare name
 	// match: a plugin published to two marketplaces — claudish is — reported
 	// "moved → magus" when nothing had moved and both copies were installed.
 	// The inference cannot tell a move from a dual publication, so it is not made
-	// at all. An orphan is `not-offered`, which is a fact rather than a guess.
-	test("an orphan is 'not offered', and never guesses where it went", () => {
+	// at all. An orphan is `deprecated`, which is a fact rather than a guess.
+	test("an orphan is deprecated, and never guesses where it went", () => {
 		const [item] = planPluginUpdates(
 			{ "seo@magus": "latest" },
 			catalog(
@@ -1014,13 +1019,13 @@ describe("classifyPlugin — an orphan is never 'current'", () => {
 			),
 		);
 		expect(item).toMatchObject({
-			action: "unknown",
-			reason: "not-offered",
+			action: "remove",
+			reason: "deprecated",
 		});
 		expect(item.note).not.toMatch(/moved/i);
 	});
 
-	test("an orphan whose marketplace we DID read is 'not offered'", () => {
+	test("an orphan whose marketplace we DID read is deprecated", () => {
 		const [item] = planPluginUpdates(
 			{ "seo@magus": "latest" },
 			catalog(
@@ -1029,9 +1034,9 @@ describe("classifyPlugin — an orphan is never 'current'", () => {
 			),
 		);
 		expect(item).toMatchObject({
-			action: "unknown",
-			reason: "not-offered",
-			note: "not offered by any configured marketplace",
+			action: "remove",
+			reason: "deprecated",
+			note: "no longer published",
 		});
 	});
 
@@ -1062,7 +1067,7 @@ describe("classifyPlugin — an orphan is never 'current'", () => {
 		expect(item.reason).toBe("marketplace-unread");
 	});
 
-	test("an orphan is unknown under an exact pin too", () => {
+	test("an orphan is deprecated under an exact pin too", () => {
 		const [item] = planPluginUpdates(
 			{ "seo@magus": "1.8.0" },
 			catalog(
@@ -1070,7 +1075,7 @@ describe("classifyPlugin — an orphan is never 'current'", () => {
 				info({ id: "dev@magus", version: "4.7.0" }),
 			),
 		);
-		expect(item.action).toBe("unknown");
+		expect(item.action).toBe("remove");
 	});
 });
 
@@ -1359,6 +1364,7 @@ describe("countPluginStates", () => {
 			repair: 1,
 			current: 0,
 			"stale-load": 0,
+			remove: 0,
 			unknown: 1,
 		});
 	});

package/src/__tests__/useStaleLoadModal.test.ts

@@ -1,8 +1,5 @@
 import { describe, expect, it } from "bun:test";
-import {
-	buildStaleLoadModal,
-	staleLoadRepairNotices,
-} from "../ui/hooks/useStaleLoadModal";
+import { buildStaleLoadModal } from "../ui/hooks/useStaleLoadModal";
 
 /**
  * The startup popup for a broken plugin.
@@ -137,56 +134,3 @@ describe("buildStaleLoadModal", () => {
 		});
 	});
 });
-
-describe("staleLoadRepairNotices", () => {
-	it("says what loads NOW for the repaired plugins, in one line", () => {
-		expect(
-			staleLoadRepairNotices([
-				{ pluginId: "madbench@magus", target: "0.5.0", ok: true },
-				{ pluginId: "dev@magus", target: "7.4.0", ok: true },
-			]),
-		).toEqual([
-			{
-				text: "Now loading madbench@magus v0.5.0, dev@magus v7.4.0",
-				tone: "success",
-			},
-		]);
-	});
-
-	it("reports a failed repair with its own reason, never as a success", () => {
-		expect(
-			staleLoadRepairNotices([
-				{
-					pluginId: "madbench@magus",
-					target: "0.5.0",
-					ok: false,
-					error: "the loader still resolves v0.3.0 here, not v0.5.0",
-				},
-			]),
-		).toEqual([
-			{
-				text: "madbench@magus not repaired: the loader still resolves v0.3.0 here, not v0.5.0",
-				tone: "warning",
-			},
-		]);
-	});
-
-	it("falls back to a plain reason rather than an empty line", () => {
-		expect(
-			staleLoadRepairNotices([
-				{ pluginId: "a@magus", target: "1.0.0", ok: false },
-			]),
-		).toEqual([
-			{
-				text: "a@magus not repaired: repair did not take effect",
-				tone: "warning",
-			},
-		]);
-	});
-
-	it("says so when there was nothing to repair", () => {
-		expect(staleLoadRepairNotices([])).toEqual([
-			{ text: "Nothing needed repairing", tone: "success" },
-		]);
-	});
-});

package/src/__tests__/version-unknown-state.test.ts

@@ -178,7 +178,7 @@ const magusCatalog = (...extra: PluginInfo[]) =>
 	);
 
 describe("planPluginUpdates — a pin its own marketplace does not offer", () => {
-	test("declared, not installed, marketplace read, plugin absent → unknown", () => {
+	test("declared, not installed, marketplace read, plugin absent → remove", () => {
 		// The bug: the !installed branch ran before any catalog guard, so
 		// `agentdev@magus` (retired) and `seo@magus` (moved to magus-marketing)
 		// planned as `install` with the literal pin as target on every run,
@@ -188,20 +188,20 @@ describe("planPluginUpdates — a pin its own marketplace does not offer", () =>
 			{ "agentdev@magus": "latest" },
 			magusCatalog(),
 		);
+		// Deprecated now, and the work is dropping the pin from the profile:
+		// still never an `install` of something nothing can fetch.
 		expect(items).toHaveLength(1);
-		expect(items[0]?.action).toBe("unknown");
+		expect(items[0]?.action).toBe("remove");
 		expect(items[0]?.target).toBeNull();
-		expect(items[0]?.note).toContain(
-			"not offered by any configured marketplace",
-		);
-		expect(items[0]?.reason).toBe("not-offered");
+		expect(items[0]?.note).toBe("no longer published");
+		expect(items[0]?.reason).toBe("deprecated");
 	});
 
-	test("an exact pin its marketplace does not offer is also unknown", () => {
+	test("an exact pin its marketplace does not offer is also deprecated", () => {
 		const items = planPluginUpdates({ "gone@magus": "3.0.0" }, magusCatalog());
-		expect(items[0]?.action).toBe("unknown");
+		expect(items[0]?.action).toBe("remove");
 		expect(items[0]?.target).toBeNull();
-		expect(items[0]?.reason).toBe("not-offered");
+		expect(items[0]?.reason).toBe("deprecated");
 	});
 
 	test("declared, not installed, and the catalog does offer it → install", () => {
@@ -345,14 +345,14 @@ describe("installed with no comparable catalog version — two different causes"
 		// The distinction this test exists for is between the two REASONS, and it
 		// still holds. What changed is the verdict: declaring no version is not a
 		// problem, so the row is `current` and says nothing. Being withdrawn IS a
-		// problem, so the next test's row is `unknown` and says so.
+		// problem, so the next test's row is `remove` and says so.
 		expect(items[0]?.reason).toBe("no-published-version");
-		expect(items[0]?.reason).not.toBe("not-offered");
+		expect(items[0]?.reason).not.toBe("deprecated");
 		expect(items[0]?.action).toBe("current");
 		expect(items[0]?.note).toBeUndefined();
 	});
 
-	test("absent from the catalog entirely IS 'not offered'", () => {
+	test("absent from the catalog entirely IS deprecated", () => {
 		const items = planPluginUpdates(
 			{ "gone@magus": "latest" },
 			new Map([
@@ -366,11 +366,9 @@ describe("installed with no comparable catalog version — two different causes"
 				],
 			]),
 		);
-		expect(items[0]?.action).toBe("unknown");
-		expect(items[0]?.note).toContain(
-			"not offered by any configured marketplace",
-		);
-		expect(items[0]?.reason).toBe("not-offered");
+		expect(items[0]?.action).toBe("remove");
+		expect(items[0]?.note).toBe("no longer published");
+		expect(items[0]?.reason).toBe("deprecated");
 	});
 });
 

package/src/cli/ansi.ts

@@ -23,6 +23,7 @@
 
 import { barTrack } from "../ui/theme-mode.js";
 import { brand } from "../ui/theme.js";
+import { CSI, stripAnsi } from "../utils/string-utils.js";
 
 // -- colour capability -------------------------------------------------------
 
@@ -192,13 +193,7 @@ export function dim(text: string): string {
 
 // -- measuring ---------------------------------------------------------------
 
-/** Every CSI sequence, not only SGR — the live region emits cursor moves too. */
-// biome-ignore lint/suspicious/noControlCharactersInRegex: ESC is the thing being matched.
-const CSI = /\x1b\[[0-9;?]*[\x20-\x2f]*[\x40-\x7e]/g;
-
-export function stripAnsi(text: string): string {
-	return text.replace(CSI, "");
-}
+export { stripAnsi };
 
 /**
  * Cells one codepoint occupies: 0, 1 or 2.