@f5-sales-demo/xcsh 21.44.0 → 21.44.1

package/CHANGELOG.md

@@ -57,6 +57,15 @@
 
 ### Fixed
 
+- Published KVM 3.0.4 through the built-in marketplace snapshot with immutable source provenance,
+  so fresh xcsh installations discover the qualified plugin without a development catalog
+  ([#4321](https://github.com/f5-sales-demo/xcsh/issues/4321),
+   [#4323](https://github.com/f5-sales-demo/xcsh/issues/4323)).
+- Made Platform plugin setup offer sorted activation commands for saved session contexts,
+  resolved unique short plugin names during reviewed uninstall while rejecting ambiguity, and
+  directed slash-command health checks to the supported `xcsh plugin doctor` CLI. Plugin
+  integration status and setup can now select a saved session context explicitly with `--context`
+  ([#4306](https://github.com/f5-sales-demo/xcsh/issues/4306)).
 - Accepted fully qualified marketplace plugin identifiers in `plugin setup`, matching install,
   upgrade, uninstall, and doctor behavior ([#4288](https://github.com/f5-sales-demo/xcsh/issues/4288)).
 - Added the exact `/plugin setup <plugin>` next action after interactive installation of plugins

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "21.44.0",
+	"version": "21.44.1",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -64,13 +64,13 @@
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "1.4.0",
-		"@f5-sales-demo/pi-agent-core": "21.44.0",
-		"@f5-sales-demo/pi-ai": "21.44.0",
-		"@f5-sales-demo/pi-natives": "21.44.0",
-		"@f5-sales-demo/pi-resource-management": "21.44.0",
-		"@f5-sales-demo/pi-tui": "21.44.0",
-		"@f5-sales-demo/pi-utils": "21.44.0",
-		"@f5-sales-demo/xcsh-stats": "21.44.0",
+		"@f5-sales-demo/pi-agent-core": "21.44.1",
+		"@f5-sales-demo/pi-ai": "21.44.1",
+		"@f5-sales-demo/pi-natives": "21.44.1",
+		"@f5-sales-demo/pi-resource-management": "21.44.1",
+		"@f5-sales-demo/pi-tui": "21.44.1",
+		"@f5-sales-demo/pi-utils": "21.44.1",
+		"@f5-sales-demo/xcsh-stats": "21.44.1",
 		"@mozilla/readability": "^0.6",
 		"@sinclair/typebox": "0.34.52",
 		"@tobilu/qmd": "2.8.3",

package/src/cli/plugin-cli.ts

@@ -9,6 +9,7 @@ import { createInterface } from "node:readline/promises";
 import { APP_NAME, getProjectDir } from "@f5-sales-demo/pi-utils";
 import { CliUsageError } from "@f5-sales-demo/pi-utils/cli";
 import chalk from "chalk";
+import { Settings } from "../config/settings";
 import { preloadPluginRoots, resolveOrDefaultProjectRegistryPath } from "../discovery/helpers";
 import { discoverAndLoadExtensions } from "../extensibility/extensions";
 import { PluginManager, parseSettingValue, validateSetting } from "../extensibility/plugins";
@@ -30,6 +31,16 @@ import {
 import type { IntegrationHandle } from "../integrations/types";
 import { theme } from "../modes/theme/theme";
 import { personProfileService } from "../person-profile/service";
+import { ContextError, ContextService, type XCSHContext } from "../services/xcsh-context";
+import {
+	deriveTenantFromUrl,
+	isInjectableContextEnvKey,
+	XCSH_API_TOKEN,
+	XCSH_API_URL,
+	XCSH_CONTEXT_NAME,
+	XCSH_NAMESPACE,
+	XCSH_TENANT,
+} from "../services/xcsh-env";
 
 // =============================================================================
 // Types
@@ -64,6 +75,7 @@ export interface PluginCommandArgs {
 		disable?: string;
 		set?: string;
 		scope?: "user" | "project";
+		context?: string;
 	};
 }
 
@@ -145,6 +157,11 @@ export function parsePluginArgs(args: string[]): PluginCommandArgs | undefined {
 			// --scope with no value following
 			console.error(chalk.red(`--scope requires a value: "user" or "project".`));
 			process.exit(1);
+		} else if (arg === "--context" && i + 1 < args.length && !args[i + 1].startsWith("-")) {
+			result.flags.context = args[++i];
+		} else if (arg === "--context") {
+			console.error(chalk.red("--context requires a saved context name."));
+			process.exit(1);
 		} else if (!arg.startsWith("-")) {
 			result.args.push(arg);
 		}
@@ -166,6 +183,8 @@ export { classifyInstallTarget } from "./classify-install-target";
  */
 export async function runPluginCommand(cmd: PluginCommandArgs): Promise<void> {
 	const manager = new PluginManager();
+	if (cmd.flags.context && cmd.action !== "status" && cmd.action !== "setup")
+		throw new CliUsageError("plugin --context is supported only for integration status or setup");
 
 	switch (cmd.action) {
 		case "install":
@@ -243,34 +262,78 @@ export function selectSetupIntegration(
 	return setupMatches[0];
 }
 
-async function handleIntegrationStatus(args: string[], flags: { json?: boolean }): Promise<void> {
-	if (args.length > 1) throw new Error(`Usage: ${APP_NAME} plugin status [plugin] [--json]`);
+function contextEnvironment(context: XCSHContext): Record<string, string> {
+	const environment: Record<string, string> = {
+		[XCSH_API_URL]: context.apiUrl,
+		[XCSH_API_TOKEN]: context.apiToken,
+		[XCSH_NAMESPACE]: context.defaultNamespace,
+		[XCSH_CONTEXT_NAME]: context.name,
+	};
+	const tenant = deriveTenantFromUrl(context.apiUrl);
+	if (tenant) environment[XCSH_TENANT] = tenant;
+	for (const [name, value] of Object.entries(context.env ?? {})) {
+		if (isInjectableContextEnvKey(name) && value) environment[name] = value;
+	}
+	return environment;
+}
+
+async function withPluginContext<T>(name: string | undefined, run: () => Promise<T>): Promise<T> {
+	if (!name) return run();
+	let context: XCSHContext;
+	try {
+		await Settings.init({ cwd: getProjectDir() });
+		const service = await ContextService.getOrInit(undefined, getProjectDir());
+		const review = service.prepareActivation(name);
+		context = await service.activate(name, { revision: review.revision, beforeCommit: () => {} });
+	} catch (error) {
+		if (error instanceof ContextError) throw new CliUsageError(error.message);
+		throw error;
+	}
+	const previous = new Map<string, string | undefined>();
+	for (const [key, value] of Object.entries(contextEnvironment(context))) {
+		previous.set(key, process.env[key]);
+		if (!process.env[key]) process.env[key] = value;
+	}
+	try {
+		return await run();
+	} finally {
+		for (const [key, value] of previous) {
+			if (value === undefined) delete process.env[key];
+			else process.env[key] = value;
+		}
+	}
+}
+
+async function handleIntegrationStatus(args: string[], flags: { json?: boolean; context?: string }): Promise<void> {
+	if (args.length > 1) throw new Error(`Usage: ${APP_NAME} plugin status [plugin] [--context <name>] [--json]`);
 	const handles = await loadIntegrationHandles();
 	const selected = args[0] ? handles.filter(handle => matchesIntegration(handle, args[0])) : handles;
 	if (args[0] && !selected.length) throw new Error(`No enabled integration is registered for ${args[0]}`);
-	const statuses = await Promise.all(
-		selected.map(async handle => {
-			const { value: _, ...status } = await handle.get();
-			return {
-				...status,
-				nextAction: status.state === "setup_required" ? describeIntegrationSetupNextAction(handle) : undefined,
-			};
-		}),
-	);
-	if (flags.json) {
-		process.stdout.write(`${JSON.stringify({ integrations: statuses })}\n`);
-		return;
-	}
-	if (!statuses.length) {
-		process.stdout.write("No enabled plugin integrations are registered.\n");
-		return;
-	}
-	for (const status of statuses) {
-		process.stdout.write(
-			`${status.plugin ?? status.id}: ${status.state}${status.reason ? ` (${status.reason})` : ""}\n`,
+	await withPluginContext(flags.context, async () => {
+		const statuses = await Promise.all(
+			selected.map(async handle => {
+				const { value: _, ...status } = await handle.get();
+				return {
+					...status,
+					nextAction: status.state === "setup_required" ? describeIntegrationSetupNextAction(handle) : undefined,
+				};
+			}),
 		);
-		if (status.nextAction) process.stdout.write(`  next: ${status.nextAction}\n`);
-	}
+		if (flags.json) {
+			process.stdout.write(`${JSON.stringify({ integrations: statuses })}\n`);
+			return;
+		}
+		if (!statuses.length) {
+			process.stdout.write("No enabled plugin integrations are registered.\n");
+			return;
+		}
+		for (const status of statuses) {
+			process.stdout.write(
+				`${status.plugin ?? status.id}: ${status.state}${status.reason ? ` (${status.reason})` : ""}\n`,
+			);
+			if (status.nextAction) process.stdout.write(`  next: ${status.nextAction}\n`);
+		}
+	});
 }
 
 export async function reviewAndExecuteIntegrationSetup(handle: IntegrationHandle<unknown>) {
@@ -295,20 +358,23 @@ export async function reviewAndExecuteIntegrationSetup(handle: IntegrationHandle
 	return result;
 }
 
-async function handleIntegrationSetup(args: string[], flags: { json?: boolean }): Promise<void> {
+async function handleIntegrationSetup(args: string[], flags: { json?: boolean; context?: string }): Promise<void> {
 	if (flags.json) throw new CliUsageError("plugin setup is human-only and does not accept --json");
-	if (args.length !== 1) throw new Error(`Usage: ${APP_NAME} plugin setup <plugin>`);
+	if (args.length !== 1) throw new Error(`Usage: ${APP_NAME} plugin setup <plugin> [--context <name>]`);
 	if (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error("Plugin setup requires an interactive terminal");
-	const handle = selectSetupIntegration(await loadIntegrationHandles(), args[0]);
-	const current = await handle.get();
-	if (current.state === "ready") {
-		process.stdout.write(`${handle.plugin ?? handle.id}: ready (setup is not required)\n`);
-		return;
-	}
-	const result = await reviewAndExecuteIntegrationSetup(handle);
-	process.stdout.write(
-		`${handle.plugin ?? handle.id}: ${result.state}${result.reason ? ` (${result.reason})` : ""}\n`,
-	);
+	const handles = await loadIntegrationHandles();
+	await withPluginContext(flags.context, async () => {
+		const handle = selectSetupIntegration(handles, args[0]);
+		const current = await handle.get();
+		if (current.state === "ready") {
+			process.stdout.write(`${handle.plugin ?? handle.id}: ready (setup is not required)\n`);
+			return;
+		}
+		const result = await reviewAndExecuteIntegrationSetup(handle);
+		process.stdout.write(
+			`${handle.plugin ?? handle.id}: ${result.state}${result.reason ? ` (${result.reason})` : ""}\n`,
+		);
+	});
 }
 
 async function reportMarketplaceInstallation(

package/src/commands/plugin.ts

@@ -51,6 +51,9 @@ export default class Plugin extends Command {
 			description: 'Install scope: "user" (default) or "project"',
 			options: ["user", "project"],
 		}),
+		context: Flags.string({
+			description: "Use a saved context for integration status or setup",
+		}),
 	};
 
 	async run(): Promise<void> {
@@ -71,6 +74,7 @@ export default class Plugin extends Command {
 				disable: flags.disable,
 				set: flags.set,
 				scope: flags.scope as "user" | "project" | undefined,
+				context: flags.context,
 			},
 		};
 

package/src/extensibility/extensions/runner.ts

@@ -256,7 +256,7 @@ export class ExtensionRunner {
 	}
 
 	/** Replace every registration surface after marketplace state changes. */
-	reloadExtensions(extensions: readonly Extension[], runtime: ExtensionRuntime): void {
+	async reloadExtensions(extensions: readonly Extension[], runtime: ExtensionRuntime): Promise<void> {
 		const activeOwners = new Set(extensions.map(extension => extension.resolvedPath));
 		for (const extension of this.extensions) {
 			if (activeOwners.has(extension.resolvedPath)) continue;
@@ -269,6 +269,7 @@ export class ExtensionRunner {
 		if (this.#initialization) {
 			const { actions, contextActions, commandContextActions, uiContext } = this.#initialization;
 			this.initialize(actions, contextActions, commandContextActions, uiContext);
+			await this.emit({ type: "session_start" });
 		}
 	}
 

package/src/extensibility/plugins/marketplace/builtin-marketplace-snapshot.ts

@@ -1,4 +1,4 @@
 const builtinMarketplaceSnapshot =
-	'{\n  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",\n  "name": "f5-sales-demo-marketplace",\n  "version": "1.0.0",\n  "metadata": {\n    "description": "Claude Code plugins for f5-sales-demo documentation repositories"\n  },\n  "owner": {\n    "name": "f5-sales-demo",\n    "url": "https://github.com/f5-sales-demo"\n  },\n  "plugins": [\n    {\n      "name": "docs-tools",\n      "description": "MDX content validation and review tools for f5-sales-demo docs repos",\n      "version": "1.1.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/docs-tools",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/docs-tools",\n      "category": "productivity",\n      "keywords": ["mdx", "documentation", "validation", "starlight", "astro"],\n      "tags": ["docs", "linting", "content-review", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Documentation content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "sales-engineer",\n      "description": "Sales Engineer persona framework for F5 XC demo repositories — demo execution, environment operations, presentation, Q&A, post-session debrief",\n      "version": "1.0.12",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/sales-engineer",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/sales-engineer",\n      "category": "productivity",\n      "keywords": ["sales-engineer", "demo", "persona", "presentation", "f5xc"],\n      "tags": ["demo", "sales", "persona", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Sales engineering content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "docs-pipeline",\n      "description": "Documentation pipeline architecture — config ownership, release dispatch chain, content authoring, managed files, local preview",\n      "version": "1.0.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/docs-pipeline",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/docs-pipeline",\n      "category": "productivity",\n      "keywords": ["docs", "pipeline", "astro", "starlight", "content", "authoring"],\n      "tags": ["docs", "pipeline", "content", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Documentation pipeline content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "brand",\n      "description": "F5 corporate branding enforcement — colors, typography, logos, icons, accessibility, and visual identity standards across all content types",\n      "version": "1.0.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/brand",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/brand",\n      "category": "productivity",\n      "keywords": ["brand", "design-system", "colors", "typography", "accessibility"],\n      "tags": ["brand", "design", "visual-identity", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Brand guidance content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "meddpicc",\n      "description": "MEDDPICC sales qualification and deal-execution framework — evidence-based deal management, stakeholder mapping, mutual action plans, and forecast integrity for complex enterprise B2B sales",\n      "version": "7.5.9",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/meddpicc",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/meddpicc",\n      "category": "productivity",\n      "keywords": [\n        "meddpicc",\n        "sales-qualification",\n        "deal-management",\n        "enterprise-sales",\n        "forecast",\n        "champion",\n        "economic-buyer",\n        "mutual-action-plan",\n        "f5xc"\n      ],\n      "tags": ["sales", "qualification", "deal-management", "forecast", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["MEDDPICC content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "devcontainer",\n      "description": "Container awareness — tool catalog, self-identity, self-diagnosis, and maintenance for the f5-sales-demo devcontainer",\n      "version": "1.2.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/devcontainer",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/devcontainer",\n      "category": "productivity",\n      "keywords": ["devcontainer", "tools", "catalog", "cli", "inventory", "container"],\n      "tags": ["devcontainer", "tools", "catalog", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["devcontainer"],\n        "requirements": ["A supported development container runtime"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "platform",\n      "description": "Provider-neutral F5 Distributed Cloud Secure Mesh Site v2 capabilities, configuration, bootstrap, and status tools",\n      "version": "6.0.1",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/platform",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/platform",\n      "category": "productivity",\n      "keywords": [\n        "console",\n        "browser",\n        "automation",\n        "azure-sso",\n        "mcp",\n        "chrome-devtools",\n        "f5xc",\n        "api",\n        "rest",\n        "platform",\n        "openapi",\n        "crud",\n        "spec-aware"\n      ],\n      "tags": ["console", "browser", "automation", "f5xc", "api", "platform", "openapi"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["platform"],\n        "requirements": ["F5 Distributed Cloud API URL and token environment variables"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "osint-framework",\n      "description": "OSINT Framework tool catalog and investigation skills — 1,064 free intelligence-gathering tools across 34 categories, mapped from osintframework.com. Category-based skills, executable investigation pipelines, CLI tool execution, and OPSEC-aware workflows.",\n      "version": "1.0.8",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/osint-framework",\n      "keywords": ["osint", "reconnaissance", "intelligence", "investigation", "security"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/osint-framework",\n      "category": "security",\n      "tags": ["osint", "recon", "security", "intelligence"],\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["OSINT framework content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "firecrawl",\n      "description": "Local self-hosted firecrawl web scraping — scrape, crawl, and map websites via the local firecrawl API on port 3002. No API keys, no subscriptions, fully open-source.",\n      "version": "1.2.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/firecrawl",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/firecrawl",\n      "category": "productivity",\n      "keywords": ["firecrawl", "scrape", "crawl", "web-scraping", "markdown", "self-hosted", "local", "open-source"],\n      "tags": ["firecrawl", "scraping", "web", "local"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["firecrawl"],\n        "requirements": ["A reachable local Firecrawl service"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "salesforce",\n      "description": "Salesforce pipeline intelligence with shared lifecycle setup, account discovery, context, and reporting tools",\n      "version": "1.5.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/salesforce",\n      "keywords": [\n        "salesforce",\n        "sf",\n        "apex",\n        "lwc",\n        "soql",\n        "metadata",\n        "deploy",\n        "testing",\n        "sfdx",\n        "agentforce",\n        "pipeline",\n        "xcsh"\n      ],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/salesforce",\n      "category": "development",\n      "tags": ["salesforce", "development", "cli", "crm", "xcsh-extension"],\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["salesforce"],\n        "requirements": ["Salesforce CLI", "An authenticated default Salesforce org"],\n        "setupRequired": true,\n        "collectedData": ["accounts", "identifiers", "business_profile"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "cloudstatus",\n      "description": "Live cloud status and Internet network intelligence for xcsh — current incidents, routing, registration, RPKI, peering, facilities, F5 Regional Edge evidence, and bounded path diagnostics",\n      "version": "1.7.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/cloudstatus",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/cloudstatus",\n      "category": "productivity",\n      "keywords": [\n        "status",\n        "monitoring",\n        "incidents",\n        "maintenance",\n        "statuspage",\n        "operational-intelligence",\n        "network-intelligence",\n        "bgp",\n        "rdap",\n        "rpki",\n        "routing",\n        "location",\n        "peeringdb",\n        "facilities",\n        "f5xc",\n        "atlassian"\n      ],\n      "tags": ["status", "network-intelligence", "routing", "peering", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "on_demand",\n        "integrations": ["cloudstatus"],\n        "requirements": ["Network access when a cloud-status command is invoked"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "azure",\n      "description": "Azure CLI integration and deterministic F5 Customer Edge discovery, planning, lifecycle, and diagnostics",\n      "version": "4.4.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/azure",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/azure",\n      "category": "development",\n      "keywords": ["azure", "az", "cloud", "f5xc", "customer-edge", "secure-mesh-site"],\n      "tags": ["azure", "cloud", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["azure"],\n        "requirements": ["Azure CLI", "An authenticated Azure account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "aws",\n      "description": "AWS CLI integration and deterministic F5 Secure Mesh Site v2 Customer Edge discovery, planning, lifecycle, and diagnostics",\n      "version": "2.1.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/aws",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/aws",\n      "category": "development",\n      "keywords": ["aws", "amazon", "cloud", "f5xc", "customer-edge", "secure-mesh-site", "tgw", "nlb"],\n      "tags": ["aws", "cloud", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["aws"],\n        "requirements": ["AWS CLI", "AWS credentials or an authenticated SSO profile"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "kvm",\n      "description": "Dual-NIC KVM Secure Mesh Site v2 with isolated SLO, home-LAN SLI, inside VIP, and rollback-protected host preparation",\n      "version": "3.0.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/kvm",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/kvm",\n      "category": "development",\n      "keywords": ["kvm", "libvirt", "qemu", "f5xc", "customer-edge", "secure-mesh-site", "home-lan", "terraform"],\n      "tags": ["kvm", "libvirt", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["kvm"],\n        "requirements": [\n          "Terraform CLI",\n          "libvirt and qemu system access",\n          "curl",\n          "F5 Distributed Cloud Platform integration"\n        ],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "gcloud",\n      "description": "Google Cloud CLI integration — container-adapted auth, context injection, CLI operator agent, token expiry detection, and welcome screen status",\n      "version": "1.3.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/gcloud",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/gcloud",\n      "category": "development",\n      "keywords": ["gcloud", "google", "cloud"],\n      "tags": ["gcloud", "google", "cloud", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["gcloud"],\n        "requirements": ["Google Cloud CLI", "An authenticated Google Cloud account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "gitlab",\n      "description": "GitLab CLI integration with shared lifecycle readiness, profile discovery, and issue management tools",\n      "version": "1.3.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "keywords": ["gitlab", "glab", "issues", "git"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/gitlab",\n      "category": "development",\n      "tags": ["gitlab", "development", "cli", "xcsh-extension"],\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/gitlab",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["gitlab"],\n        "requirements": ["GitLab CLI", "An authenticated GitLab account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "github",\n      "description": "GitHub and Git operations with typed lifecycle stages, normalized evidence, and advisory governance",\n      "version": "3.1.1",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/github",\n      "keywords": ["github", "gh", "git", "pr", "issues", "ci", "workflow", "git-sops", "github-ops"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/github",\n      "category": "development",\n      "tags": ["github", "development", "cli", "workflow", "xcsh-extension"],\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["github", "github_email"],\n        "requirements": ["GitHub CLI", "An authenticated GitHub account"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": ["accounts", "email", "identifiers", "sameAs"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "herdr",\n      "description": "Install and operate the stable F5 Herdr fork with verified native xcsh health, explicit pairing, and complete pane-control guidance.",\n      "version": "1.1.2",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/herdr",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/herdr",\n      "category": "development",\n      "keywords": ["herdr", "terminal", "multiplexer", "panes", "agents"],\n      "tags": ["terminal", "orchestration", "agents", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["herdr"],\n        "requirements": [\n          "Supported 64-bit Linux, macOS, or Windows host",\n          "HTTPS access to the f5-sales-demo/herdr stable manifest and release"\n        ],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "asm-migration",\n      "description": "Deterministic BIG-IP ASM conversion and guarded F5 Distributed Cloud deployment",\n      "version": "2.1.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/asm-migration",\n      "keywords": ["asm", "waf", "migration", "f5xc", "xcsh-extension"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/asm-migration",\n      "category": "security",\n      "tags": ["asm", "waf", "security", "migration", "f5xc"],\n      "recommended": false,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["asm_migration"],\n        "requirements": ["ASM migration runtime dependencies", "F5 Distributed Cloud Platform integration"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "terraform",\n      "description": "Senior DevOps Infrastructure-as-Code plugin providing HashiCorp Registry proactive version checks, HCL authoring, testing frameworks, and troubleshooting playbooks.",\n      "version": "2.1.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/terraform",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/terraform",\n      "category": "development",\n      "keywords": ["terraform", "hcl", "iac", "devops", "hashicorp", "testing", "troubleshooting"],\n      "tags": ["terraform", "iac", "devops", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["terraform"],\n        "requirements": ["Terraform CLI"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "xorg",\n      "version": "1.1.2",\n      "description": "Ubuntu 24.04 Xorg desktop automation substrate",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Xorg",\n        "version": "1.1.2"\n      },\n      "source": "./plugins/xorg",\n      "category": "development",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/xorg",\n      "keywords": ["xorg", "at-spi", "xtest", "pipewire"],\n      "tags": ["linux", "desktop", "automation"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["xorg"],\n        "requirements": ["Ubuntu 24.04 with passwordless sudo"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "zoom",\n      "version": "1.0.5",\n      "description": "Verified Zoom Workplace control through public xorgctl JSON",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Zoom",\n        "version": "1.0.5"\n      },\n      "source": "./plugins/zoom",\n      "category": "productivity",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/zoom",\n      "keywords": ["zoom", "meeting", "accessibility", "virtual-camera"],\n      "tags": ["zoom", "meeting", "automation"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["zoom"],\n        "requirements": ["Ubuntu 24.04", "Zoom Workplace", "Xorg plugin"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": ["xorg"]\n      }\n    }\n  ]\n}\n';
+	'{\n  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",\n  "name": "f5-sales-demo-marketplace",\n  "version": "1.0.0",\n  "metadata": {\n    "description": "Claude Code plugins for f5-sales-demo documentation repositories"\n  },\n  "owner": {\n    "name": "f5-sales-demo",\n    "url": "https://github.com/f5-sales-demo"\n  },\n  "plugins": [\n    {\n      "name": "docs-tools",\n      "description": "MDX content validation and review tools for f5-sales-demo docs repos",\n      "version": "1.1.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/docs-tools",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/docs-tools",\n      "category": "productivity",\n      "keywords": ["mdx", "documentation", "validation", "starlight", "astro"],\n      "tags": ["docs", "linting", "content-review", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Documentation content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "sales-engineer",\n      "description": "Sales Engineer persona framework for F5 XC demo repositories — demo execution, environment operations, presentation, Q&A, post-session debrief",\n      "version": "1.0.12",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/sales-engineer",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/sales-engineer",\n      "category": "productivity",\n      "keywords": ["sales-engineer", "demo", "persona", "presentation", "f5xc"],\n      "tags": ["demo", "sales", "persona", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Sales engineering content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "docs-pipeline",\n      "description": "Documentation pipeline architecture — config ownership, release dispatch chain, content authoring, managed files, local preview",\n      "version": "1.0.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/docs-pipeline",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/docs-pipeline",\n      "category": "productivity",\n      "keywords": ["docs", "pipeline", "astro", "starlight", "content", "authoring"],\n      "tags": ["docs", "pipeline", "content", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Documentation pipeline content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "brand",\n      "description": "F5 corporate branding enforcement — colors, typography, logos, icons, accessibility, and visual identity standards across all content types",\n      "version": "1.0.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/brand",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/brand",\n      "category": "productivity",\n      "keywords": ["brand", "design-system", "colors", "typography", "accessibility"],\n      "tags": ["brand", "design", "visual-identity", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Brand guidance content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "meddpicc",\n      "description": "MEDDPICC sales qualification and deal-execution framework — evidence-based deal management, stakeholder mapping, mutual action plans, and forecast integrity for complex enterprise B2B sales",\n      "version": "7.5.9",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/meddpicc",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/meddpicc",\n      "category": "productivity",\n      "keywords": [\n        "meddpicc",\n        "sales-qualification",\n        "deal-management",\n        "enterprise-sales",\n        "forecast",\n        "champion",\n        "economic-buyer",\n        "mutual-action-plan",\n        "f5xc"\n      ],\n      "tags": ["sales", "qualification", "deal-management", "forecast", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["MEDDPICC content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "devcontainer",\n      "description": "Container awareness — tool catalog, self-identity, self-diagnosis, and maintenance for the f5-sales-demo devcontainer",\n      "version": "1.2.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/devcontainer",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/devcontainer",\n      "category": "productivity",\n      "keywords": ["devcontainer", "tools", "catalog", "cli", "inventory", "container"],\n      "tags": ["devcontainer", "tools", "catalog", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["devcontainer"],\n        "requirements": ["A supported development container runtime"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "platform",\n      "description": "Provider-neutral F5 Distributed Cloud Secure Mesh Site v2 capabilities, configuration, bootstrap, and status tools",\n      "version": "6.0.1",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/platform",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/platform",\n      "category": "productivity",\n      "keywords": [\n        "console",\n        "browser",\n        "automation",\n        "azure-sso",\n        "mcp",\n        "chrome-devtools",\n        "f5xc",\n        "api",\n        "rest",\n        "platform",\n        "openapi",\n        "crud",\n        "spec-aware"\n      ],\n      "tags": ["console", "browser", "automation", "f5xc", "api", "platform", "openapi"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["platform"],\n        "requirements": ["F5 Distributed Cloud API URL and token environment variables"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "osint-framework",\n      "description": "OSINT Framework tool catalog and investigation skills — 1,064 free intelligence-gathering tools across 34 categories, mapped from osintframework.com. Category-based skills, executable investigation pipelines, CLI tool execution, and OPSEC-aware workflows.",\n      "version": "1.0.8",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/osint-framework",\n      "keywords": ["osint", "reconnaissance", "intelligence", "investigation", "security"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/osint-framework",\n      "category": "security",\n      "tags": ["osint", "recon", "security", "intelligence"],\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["OSINT framework content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "firecrawl",\n      "description": "Local self-hosted firecrawl web scraping — scrape, crawl, and map websites via the local firecrawl API on port 3002. No API keys, no subscriptions, fully open-source.",\n      "version": "1.2.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/firecrawl",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/firecrawl",\n      "category": "productivity",\n      "keywords": ["firecrawl", "scrape", "crawl", "web-scraping", "markdown", "self-hosted", "local", "open-source"],\n      "tags": ["firecrawl", "scraping", "web", "local"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["firecrawl"],\n        "requirements": ["A reachable local Firecrawl service"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "salesforce",\n      "description": "Salesforce pipeline intelligence with shared lifecycle setup, account discovery, context, and reporting tools",\n      "version": "1.5.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/salesforce",\n      "keywords": [\n        "salesforce",\n        "sf",\n        "apex",\n        "lwc",\n        "soql",\n        "metadata",\n        "deploy",\n        "testing",\n        "sfdx",\n        "agentforce",\n        "pipeline",\n        "xcsh"\n      ],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/salesforce",\n      "category": "development",\n      "tags": ["salesforce", "development", "cli", "crm", "xcsh-extension"],\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["salesforce"],\n        "requirements": ["Salesforce CLI", "An authenticated default Salesforce org"],\n        "setupRequired": true,\n        "collectedData": ["accounts", "identifiers", "business_profile"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "cloudstatus",\n      "description": "Live cloud status and Internet network intelligence for xcsh — current incidents, routing, registration, RPKI, peering, facilities, F5 Regional Edge evidence, and bounded path diagnostics",\n      "version": "1.7.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/cloudstatus",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/cloudstatus",\n      "category": "productivity",\n      "keywords": [\n        "status",\n        "monitoring",\n        "incidents",\n        "maintenance",\n        "statuspage",\n        "operational-intelligence",\n        "network-intelligence",\n        "bgp",\n        "rdap",\n        "rpki",\n        "routing",\n        "location",\n        "peeringdb",\n        "facilities",\n        "f5xc",\n        "atlassian"\n      ],\n      "tags": ["status", "network-intelligence", "routing", "peering", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "on_demand",\n        "integrations": ["cloudstatus"],\n        "requirements": ["Network access when a cloud-status command is invoked"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "azure",\n      "description": "Azure CLI integration and deterministic F5 Customer Edge discovery, planning, lifecycle, and diagnostics",\n      "version": "4.4.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/azure",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/azure",\n      "category": "development",\n      "keywords": ["azure", "az", "cloud", "f5xc", "customer-edge", "secure-mesh-site"],\n      "tags": ["azure", "cloud", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["azure"],\n        "requirements": ["Azure CLI", "An authenticated Azure account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "aws",\n      "description": "AWS CLI integration and deterministic F5 Secure Mesh Site v2 Customer Edge discovery, planning, lifecycle, and diagnostics",\n      "version": "2.1.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/aws",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/aws",\n      "category": "development",\n      "keywords": ["aws", "amazon", "cloud", "f5xc", "customer-edge", "secure-mesh-site", "tgw", "nlb"],\n      "tags": ["aws", "cloud", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["aws"],\n        "requirements": ["AWS CLI", "AWS credentials or an authenticated SSO profile"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "kvm",\n      "description": "Dual-NIC KVM Secure Mesh Site v2 with isolated SLO, home-LAN SLI, inside VIP, and rollback-protected host preparation",\n      "version": "3.0.4",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/kvm",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/kvm",\n      "category": "development",\n      "keywords": ["kvm", "libvirt", "qemu", "f5xc", "customer-edge", "secure-mesh-site", "home-lan", "terraform"],\n      "tags": ["kvm", "libvirt", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["kvm"],\n        "requirements": [\n          "Terraform CLI",\n          "libvirt and qemu system access",\n          "curl",\n          "F5 Distributed Cloud Platform integration"\n        ],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "gcloud",\n      "description": "Google Cloud CLI integration — container-adapted auth, context injection, CLI operator agent, token expiry detection, and welcome screen status",\n      "version": "1.3.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/gcloud",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/gcloud",\n      "category": "development",\n      "keywords": ["gcloud", "google", "cloud"],\n      "tags": ["gcloud", "google", "cloud", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["gcloud"],\n        "requirements": ["Google Cloud CLI", "An authenticated Google Cloud account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "gitlab",\n      "description": "GitLab CLI integration with shared lifecycle readiness, profile discovery, and issue management tools",\n      "version": "1.3.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "keywords": ["gitlab", "glab", "issues", "git"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/gitlab",\n      "category": "development",\n      "tags": ["gitlab", "development", "cli", "xcsh-extension"],\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/gitlab",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["gitlab"],\n        "requirements": ["GitLab CLI", "An authenticated GitLab account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "github",\n      "description": "GitHub and Git operations with typed lifecycle stages, normalized evidence, and advisory governance",\n      "version": "3.1.1",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/github",\n      "keywords": ["github", "gh", "git", "pr", "issues", "ci", "workflow", "git-sops", "github-ops"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/github",\n      "category": "development",\n      "tags": ["github", "development", "cli", "workflow", "xcsh-extension"],\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["github", "github_email"],\n        "requirements": ["GitHub CLI", "An authenticated GitHub account"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": ["accounts", "email", "identifiers", "sameAs"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "herdr",\n      "description": "Install and operate the stable F5 Herdr fork with verified native xcsh health, explicit pairing, and complete pane-control guidance.",\n      "version": "1.1.2",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/herdr",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/herdr",\n      "category": "development",\n      "keywords": ["herdr", "terminal", "multiplexer", "panes", "agents"],\n      "tags": ["terminal", "orchestration", "agents", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["herdr"],\n        "requirements": [\n          "Supported 64-bit Linux, macOS, or Windows host",\n          "HTTPS access to the f5-sales-demo/herdr stable manifest and release"\n        ],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "asm-migration",\n      "description": "Deterministic BIG-IP ASM conversion and guarded F5 Distributed Cloud deployment",\n      "version": "2.1.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/asm-migration",\n      "keywords": ["asm", "waf", "migration", "f5xc", "xcsh-extension"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/asm-migration",\n      "category": "security",\n      "tags": ["asm", "waf", "security", "migration", "f5xc"],\n      "recommended": false,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["asm_migration"],\n        "requirements": ["ASM migration runtime dependencies", "F5 Distributed Cloud Platform integration"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "terraform",\n      "description": "Senior DevOps Infrastructure-as-Code plugin providing HashiCorp Registry proactive version checks, HCL authoring, testing frameworks, and troubleshooting playbooks.",\n      "version": "2.1.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/terraform",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/terraform",\n      "category": "development",\n      "keywords": ["terraform", "hcl", "iac", "devops", "hashicorp", "testing", "troubleshooting"],\n      "tags": ["terraform", "iac", "devops", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["terraform"],\n        "requirements": ["Terraform CLI"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "xorg",\n      "version": "1.1.2",\n      "description": "Ubuntu 24.04 Xorg desktop automation substrate",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Xorg",\n        "version": "1.1.2"\n      },\n      "source": "./plugins/xorg",\n      "category": "development",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/xorg",\n      "keywords": ["xorg", "at-spi", "xtest", "pipewire"],\n      "tags": ["linux", "desktop", "automation"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["xorg"],\n        "requirements": ["Ubuntu 24.04 with passwordless sudo"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "zoom",\n      "version": "1.0.5",\n      "description": "Verified Zoom Workplace control through public xorgctl JSON",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Zoom",\n        "version": "1.0.5"\n      },\n      "source": "./plugins/zoom",\n      "category": "productivity",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/zoom",\n      "keywords": ["zoom", "meeting", "accessibility", "virtual-camera"],\n      "tags": ["zoom", "meeting", "automation"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["zoom"],\n        "requirements": ["Ubuntu 24.04", "Zoom Workplace", "Xorg plugin"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": ["xorg"]\n      }\n    }\n  ]\n}\n';
 
 export default builtinMarketplaceSnapshot;

package/src/extensibility/plugins/marketplace/builtin-marketplace.provenance.json

@@ -1,7 +1,7 @@
 {
   "repository": "https://github.com/f5-sales-demo/marketplace",
   "sourcePath": ".xcsh-plugin/marketplace.json",
-  "commit": "6e31f9524c178669b73ba6e38a2316cd860924b4",
-  "sha256": "3790d1958066a68a6aff310b2e79f37f40a2b40f00746f210d762e0085177e97",
-  "capturedAt": "2026-09-24T21:04:24.475Z"
+  "commit": "748c48091741810c56dcdc418b881536ff2d61d9",
+  "sha256": "5c86fd246160eccaf0e961080000d6df73ff8c5828fcfe545860c32e8c032ba4",
+  "capturedAt": "2026-09-25T09:36:59.948Z"
 }

package/src/extensibility/plugins/marketplace/manager.ts

@@ -42,7 +42,7 @@ import type {
 	MarketplacePluginEntry,
 	MarketplaceRegistryEntry,
 } from "./types";
-import { buildPluginId, isInstalledPluginEffectivelyEnabled, parsePluginId } from "./types";
+import { buildPluginId, isInstalledPluginEffectivelyEnabled, isValidNameSegment, parsePluginId } from "./types";
 
 // ── Options ──────────────────────────────────────────────────────────────────
 
@@ -697,19 +697,38 @@ export class MarketplaceManager {
 		return "0.0.0";
 	}
 
-	async #resolvePluginUninstall(pluginId: string, scope?: "user" | "project") {
-		const parsed = parsePluginId(pluginId);
-		if (!parsed) {
-			throw new Error(`Invalid plugin ID format: "${pluginId}". Expected "name@marketplace".`);
+	async resolveInstalledPluginId(pluginId: string, scope?: "user" | "project"): Promise<string> {
+		if (parsePluginId(pluginId)) return pluginId;
+		if (!isValidNameSegment(pluginId)) {
+			throw new Error(`Invalid plugin ID format: "${pluginId}". Expected "name" or "name@marketplace".`);
 		}
 
-		const { userEntries, projectEntries, userReg, projectReg } = await this.#findInBothRegistries(pluginId);
+		const { userReg, projectReg } = await this.#findInBothRegistries(pluginId);
+		const registries = scope === "user" ? [userReg] : scope === "project" ? [projectReg] : [userReg, projectReg];
+		const matches = new Set<string>();
+		for (const registry of registries) {
+			for (const [installedId, entries] of Object.entries(registry.plugins)) {
+				if (entries.length > 0 && parsePluginId(installedId)?.name === pluginId) matches.add(installedId);
+			}
+		}
+		const candidates = [...matches].sort();
+		if (candidates.length === 0) throw new Error(`Plugin "${pluginId}" is not installed`);
+		if (candidates.length > 1) {
+			throw new Error(`Plugin name "${pluginId}" is ambiguous. Use one of: ${candidates.join(", ")}`);
+		}
+		return candidates[0]!;
+	}
+
+	async #resolvePluginUninstall(pluginId: string, scope?: "user" | "project") {
+		const resolvedPluginId = await this.resolveInstalledPluginId(pluginId, scope);
+
+		const { userEntries, projectEntries, userReg, projectReg } = await this.#findInBothRegistries(resolvedPluginId);
 
 		const inUser = userEntries && userEntries.length > 0;
 		const inProject = projectEntries && projectEntries.length > 0;
 
 		if (!inUser && !inProject) {
-			throw new Error(`Plugin "${pluginId}" is not installed`);
+			throw new Error(`Plugin "${resolvedPluginId}" is not installed`);
 		}
 
 		// Disambiguation: if installed in both scopes and no explicit scope, require one.
@@ -736,26 +755,33 @@ export class MarketplaceManager {
 		const targetEntries = targetScope === "project" ? projectEntries! : userEntries!;
 		const targetReg = targetScope === "project" ? projectReg : userReg;
 		const registryPath = this.#registryPath(targetScope);
-		await this.#assertNoInstalledDependents(pluginId, targetReg);
-		return { targetEntries, targetReg, targetScope, registryPath };
+		await this.#assertNoInstalledDependents(resolvedPluginId, targetReg);
+		return { pluginId: resolvedPluginId, targetEntries, targetReg, targetScope, registryPath };
 	}
 
 	async previewUninstallPlugin(pluginId: string, scope?: "user" | "project"): Promise<PluginUninstallPreview> {
-		const { targetEntries, targetScope } = await this.#resolvePluginUninstall(pluginId, scope);
+		const {
+			pluginId: resolvedPluginId,
+			targetEntries,
+			targetScope,
+		} = await this.#resolvePluginUninstall(pluginId, scope);
 		return {
-			pluginId,
+			pluginId: resolvedPluginId,
 			scope: targetScope,
 			installPaths: targetEntries.map(entry => entry.installPath),
 		};
 	}
 
 	async uninstallPlugin(pluginId: string, scope?: "user" | "project"): Promise<void> {
-		const { targetEntries, targetReg, targetScope, registryPath } = await this.#resolvePluginUninstall(
-			pluginId,
-			scope,
-		);
-
-		const updatedReg = removeInstalledPlugin(targetReg, pluginId);
+		const {
+			pluginId: resolvedPluginId,
+			targetEntries,
+			targetReg,
+			targetScope,
+			registryPath,
+		} = await this.#resolvePluginUninstall(pluginId, scope);
+
+		const updatedReg = removeInstalledPlugin(targetReg, resolvedPluginId);
 		await writeInstalledPluginsRegistry(registryPath, updatedReg);
 
 		// Read both registries AFTER removal — only delete paths no longer referenced by either.
@@ -778,7 +804,7 @@ export class MarketplaceManager {
 
 		this.#clearCache();
 
-		logger.debug("Plugin uninstalled", { pluginId, scope: targetScope });
+		logger.debug("Plugin uninstalled", { pluginId: resolvedPluginId, scope: targetScope });
 	}
 
 	// ── Plugin state ──────────────────────────────────────────────────────────