@f5-sales-demo/xcsh 21.43.2 → 21.43.8

package/CHANGELOG.md

@@ -57,6 +57,8 @@
 
 ### Fixed
 
+- 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
   that require separately authorized setup ([#4253](https://github.com/f5-sales-demo/xcsh/issues/4253)).
 - Made marketplace plugin uninstall dry-runs return a deterministic preview without changing the

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "21.43.2",
+	"version": "21.43.8",
 	"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.43.2",
-		"@f5-sales-demo/pi-ai": "21.43.2",
-		"@f5-sales-demo/pi-natives": "21.43.2",
-		"@f5-sales-demo/pi-resource-management": "21.43.2",
-		"@f5-sales-demo/pi-tui": "21.43.2",
-		"@f5-sales-demo/pi-utils": "21.43.2",
-		"@f5-sales-demo/xcsh-stats": "21.43.2",
+		"@f5-sales-demo/pi-agent-core": "21.43.8",
+		"@f5-sales-demo/pi-ai": "21.43.8",
+		"@f5-sales-demo/pi-natives": "21.43.8",
+		"@f5-sales-demo/pi-resource-management": "21.43.8",
+		"@f5-sales-demo/pi-tui": "21.43.8",
+		"@f5-sales-demo/pi-utils": "21.43.8",
+		"@f5-sales-demo/xcsh-stats": "21.43.8",
 		"@mozilla/readability": "^0.6",
 		"@sinclair/typebox": "0.34.52",
 		"@tobilu/qmd": "2.8.3",

package/src/cli/args.ts

@@ -3,6 +3,7 @@
  */
 import { type Effort, THINKING_EFFORTS } from "@f5-sales-demo/pi-ai";
 import { APP_NAME, CONFIG_DIR_NAME, logger } from "@f5-sales-demo/pi-utils";
+import { CliUsageError } from "@f5-sales-demo/pi-utils/cli";
 import chalk from "chalk";
 import { parseEffort } from "../thinking";
 import {
@@ -49,6 +50,7 @@ export interface Args {
 	models?: string[];
 	tools?: string[];
 	noTools?: boolean;
+	mcp?: boolean;
 	noMcp?: boolean;
 	noLsp?: boolean;
 	noPty?: boolean;
@@ -159,6 +161,9 @@ const APPLY: Record<LaunchFlagName, (result: Args, value: string | true) => void
 	"no-tools": r => {
 		r.noTools = true;
 	},
+	mcp: r => {
+		r.mcp = true;
+	},
 	"no-mcp": r => {
 		r.noMcp = true;
 	},
@@ -399,6 +404,8 @@ export function parseArgs(args: string[], extensionFlags?: ExtensionFlagRegistry
 		result.unrecognizedFlags.push({ token, name: name ?? token.replace(/^-+/, "") });
 	}
 
+	if (result.mcp && result.noMcp) throw new CliUsageError("--mcp cannot be combined with --no-mcp");
+	if (result.mcp && result.noTools) throw new CliUsageError("--mcp cannot be combined with --no-tools");
 	return result;
 }
 

package/src/cli/flag-spec.ts

@@ -79,6 +79,7 @@ export const LAUNCH_FLAGS = defineFlags({
 	"provider-session-id": { arity: "value", description: "Resume a provider-side session", hidden: true },
 	models: { arity: "value", description: "Comma-separated model patterns for Ctrl+P cycling" },
 	"no-tools": { arity: "boolean", description: "Disable all built-in tools" },
+	mcp: { arity: "boolean", description: "Enable MCP servers for this run" },
 	"no-mcp": { arity: "boolean", description: "Disable MCP server discovery and tools" },
 	"no-lsp": { arity: "boolean", description: "Disable LSP tools, formatting, and diagnostics" },
 	"no-pty": { arity: "boolean", description: "Disable PTY-based interactive bash execution" },

package/src/cli/plugin-cli.ts

@@ -7,6 +7,7 @@
 import * as os from "node:os";
 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 { preloadPluginRoots, resolveOrDefaultProjectRegistryPath } from "../discovery/helpers";
 import { discoverAndLoadExtensions } from "../extensibility/extensions";
@@ -223,7 +224,8 @@ export async function loadIntegrationHandles(
 }
 
 function matchesIntegration(handle: IntegrationHandle<unknown>, target: string): boolean {
-	return handle.id === target || handle.plugin === target || handle.plugin?.split("@")[0] === target;
+	const pluginName = target.split("@")[0];
+	return handle.id === target || handle.plugin === target || handle.plugin?.split("@")[0] === pluginName;
 }
 
 export { describeIntegrationSetupNextAction } from "../integrations/setup";
@@ -294,7 +296,7 @@ export async function reviewAndExecuteIntegrationSetup(handle: IntegrationHandle
 }
 
 async function handleIntegrationSetup(args: string[], flags: { json?: boolean }): Promise<void> {
-	if (flags.json) throw new Error("plugin setup is human-only and does not accept --json");
+	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 (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error("Plugin setup requires an interactive terminal");
 	const handle = selectSetupIntegration(await loadIntegrationHandles(), args[0]);

package/src/config/settings-schema.ts

@@ -93,10 +93,13 @@ interface UiMetadata {
 	condition?: string;
 }
 
+type SettingScope = "user";
+
 interface BooleanDef {
 	type: "boolean";
 	default: boolean;
 	ui?: UiMetadata;
+	scope?: SettingScope;
 }
 
 interface StringDef {
@@ -1761,6 +1764,13 @@ export const SETTINGS_SCHEMA = {
 	},
 
 	// MCP
+	"mcp.enabled": {
+		type: "boolean",
+		default: false,
+		scope: "user",
+		ui: { tab: "tools", label: "MCP", description: "Enable MCP servers for new sessions" },
+	},
+
 	"mcp.enableProjectConfig": {
 		type: "boolean",
 		default: true,

package/src/config/settings.ts

@@ -662,10 +662,25 @@ export class Settings {
 	// ─────────────────────────────────────────────────────────────────────────
 
 	#rebuildMerged(): void {
-		this.#merged = this.#deepMerge(this.#deepMerge({}, this.#global), this.#project);
+		const trustedProject = structuredClone(this.#project);
+		for (const [settingPath, definition] of Object.entries(SETTINGS_SCHEMA)) {
+			if (!("scope" in definition) || definition.scope !== "user") continue;
+			this.#deleteByPath(trustedProject, settingPath.split("."));
+		}
+		this.#merged = this.#deepMerge(this.#deepMerge({}, this.#global), trustedProject);
 		this.#merged = this.#deepMerge(this.#merged, this.#overrides);
 	}
 
+	#deleteByPath(obj: RawSettings, segments: string[]): void {
+		let current = obj;
+		for (let i = 0; i < segments.length - 1; i++) {
+			const next = current[segments[i]];
+			if (!next || typeof next !== "object" || Array.isArray(next)) return;
+			current = next as RawSettings;
+		}
+		Reflect.deleteProperty(current, segments[segments.length - 1]);
+	}
+
 	#fireAllHooks(): void {
 		for (const key of Object.keys(SETTING_HOOKS) as SettingPath[]) {
 			const hook = SETTING_HOOKS[key];

package/src/extensibility/extensions/bundled/herdr-reporter.ts

@@ -3,6 +3,7 @@ import * as path from "node:path";
 import type { AssistantMessage } from "@f5-sales-demo/pi-ai";
 import type { ExtensionAPI, ExtensionContext, UserPromptKind } from "@f5-sales-demo/xcsh";
 import { HerdrClient } from "../../../herdr/client";
+import { requestHerdrIdempotent } from "../../../herdr/retry";
 import { HERDR_SEMANTIC_REPORT_TIMEOUT_MS, requestSemanticReport } from "../../../herdr/semantic-report";
 import { finalAnswerText } from "../../../session/final-answer";
 import { requestNativeLifecycleCancellation } from "./native-lifecycle-control";
@@ -314,7 +315,7 @@ async function sendToHerdrSocket(
 	onError: (err: unknown) => void,
 ): Promise<void> {
 	try {
-		await getHerdrClient(socketPath).request<Record<string, unknown>>(method, params);
+		await requestHerdrIdempotent(getHerdrClient(socketPath), method, params);
 	} catch (err) {
 		onError(err);
 	}

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": "5.1.2",\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": "Deterministic F5 Distributed Cloud Secure Mesh Site v2 lifecycle for KVM, libvirt, and Terraform-owned FRR routing",\n      "version": "2.0.2",\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", "frr", "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          "Docker CLI",\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.0",\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.0"\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.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';
 
 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": "512b3915e18e5bae247f58e2c7e3bbdb94656e7a",
-  "sha256": "7e3868a2afd6fbeb31e9d212c30947b9cc6b127ffa8412e9e4f9f06171834251",
-  "capturedAt": "2026-09-23T20:05:58.783Z"
+  "commit": "6e31f9524c178669b73ba6e38a2316cd860924b4",
+  "sha256": "3790d1958066a68a6aff310b2e79f37f40a2b40f00746f210d762e0085177e97",
+  "capturedAt": "2026-09-24T21:04:24.475Z"
 }

package/src/herdr/client.ts

@@ -16,6 +16,14 @@ export class HerdrProtocolError extends Error {
 	}
 }
 
+/** A request may have reached Herdr even though xcsh did not receive its reply. */
+export function isRetryableHerdrTransportError(error: unknown): error is HerdrProtocolError {
+	return (
+		error instanceof HerdrProtocolError &&
+		["timeout", "eof", "epipe", "connection_reset", "transport_error"].includes(error.code)
+	);
+}
+
 function isRecord(value: unknown): value is Record<string, unknown> {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -94,8 +102,19 @@ export class HerdrClient {
 	}
 
 	async request<T extends Record<string, unknown>>(method: string, params: Record<string, unknown>): Promise<T> {
-		await this.ensureProtocol();
-		return this.requestRaw<T>(method, params);
+		try {
+			await this.ensureProtocol();
+			return await this.requestRaw<T>(method, params);
+		} catch (error) {
+			if (isRetryableHerdrTransportError(error)) this.invalidateProtocol();
+			throw error;
+		}
+	}
+
+	private invalidateProtocol(): void {
+		this.protocolChecked = false;
+		this.negotiatedProtocol = undefined;
+		this.capabilities = {};
 	}
 
 	private requestRaw<T>(method: string, params: Record<string, unknown>): Promise<T> {
@@ -103,18 +122,37 @@ export class HerdrClient {
 		return new Promise<T>((resolve, reject) => {
 			let buffer = "";
 			let settled = false;
+			let timeout: ReturnType<typeof setTimeout> | undefined;
 			const socket = connect({ path: this.socketPath });
 			const finish = (error?: unknown, value?: T): void => {
 				if (settled) return;
 				settled = true;
+				if (timeout !== undefined) clearTimeout(timeout);
 				socket.destroy();
 				if (error !== undefined) reject(error);
 				else resolve(value as T);
 			};
+			const startResponseTimeout = (): void => {
+				if (settled) return;
+				timeout = setTimeout(
+					() => finish(new HerdrProtocolError("Herdr request timed out", "timeout")),
+					this.timeoutMs,
+				);
+				(timeout as { unref?: () => void }).unref?.();
+			};
+			const transportError = (error: NodeJS.ErrnoException): HerdrProtocolError => {
+				const code =
+					error.code === "EPIPE" ? "epipe" : error.code === "ECONNRESET" ? "connection_reset" : "transport_error";
+				return new HerdrProtocolError("Herdr transport failed", code);
+			};
 			socket.setEncoding("utf8");
-			socket.setTimeout(this.timeoutMs, () => finish(new HerdrProtocolError("Herdr request timed out", "timeout")));
-			socket.once("error", error => finish(new HerdrProtocolError(error.message, "transport_error")));
-			socket.once("connect", () => socket.write(`${JSON.stringify({ id, method, params })}\n`));
+			socket.once("error", error => finish(transportError(error)));
+			socket.once("connect", () => {
+				socket.write(`${JSON.stringify({ id, method, params })}\n`, error => {
+					if (error) finish(transportError(error));
+					else startResponseTimeout();
+				});
+			});
 			socket.on("data", chunk => {
 				buffer += chunk;
 				if (Buffer.byteLength(buffer) > MAX_RESPONSE_BYTES) {

package/src/herdr/retry.ts

@@ -0,0 +1,25 @@
+import { isRetryableHerdrTransportError } from "./client";
+
+export const HERDR_REPORT_RETRY_DELAY_MS = 250;
+
+interface HerdrRequestClient {
+	request<T extends Record<string, unknown>>(method: string, params: Record<string, unknown>): Promise<T>;
+}
+
+/**
+ * Retry exactly once after an ambiguous transport failure. The client assigns a
+ * fresh request id; callers retain the original method, payload and sequence.
+ */
+export async function requestHerdrIdempotent<T extends Record<string, unknown>>(
+	client: HerdrRequestClient,
+	method: string,
+	params: Record<string, unknown>,
+): Promise<T> {
+	try {
+		return await client.request<T>(method, params);
+	} catch (error) {
+		if (!isRetryableHerdrTransportError(error)) throw error;
+		await new Promise(resolve => setTimeout(resolve, HERDR_REPORT_RETRY_DELAY_MS));
+		return client.request<T>(method, params);
+	}
+}

package/src/herdr/semantic-report.ts

@@ -1,28 +1,12 @@
-import { HerdrProtocolError } from "./client";
+import { requestHerdrIdempotent } from "./retry";
 
 export const HERDR_SEMANTIC_REPORT_TIMEOUT_MS = 5_000;
 
-interface SemanticRequestClient {
-	request<T extends Record<string, unknown>>(method: string, params: Record<string, unknown>): Promise<T>;
-}
-
-function isAmbiguousSemanticFailure(error: unknown): boolean {
-	return (
-		error instanceof HerdrProtocolError &&
-		(error.code === "timeout" || error.code === "eof" || error.code === "transport_error")
-	);
-}
-
 /** Retry one semantically idempotent journal write only when its admission is ambiguous. */
 export async function requestSemanticReport(
-	client: SemanticRequestClient,
+	client: { request<T extends Record<string, unknown>>(method: string, params: Record<string, unknown>): Promise<T> },
 	method: string,
 	params: Record<string, unknown>,
 ): Promise<Record<string, unknown>> {
-	try {
-		return await client.request<Record<string, unknown>>(method, params);
-	} catch (error) {
-		if (!isAmbiguousSemanticFailure(error)) throw error;
-		return client.request<Record<string, unknown>>(method, params);
-	}
+	return requestHerdrIdempotent(client, method, params);
 }

package/src/integrations/setup.ts

@@ -50,7 +50,8 @@ export function describeInstallSetupOutcome(
 	const handle = handles.find(
 		candidate => candidate.id === target || candidate.plugin === target || candidate.plugin?.split("@")[0] === target,
 	);
-	const nextAction = handle ? describeIntegrationSetupNextAction(handle) : `xcsh plugin setup ${target}`;
+	const nextTarget = handle?.plugin?.split("@")[0] ?? handle?.id ?? target;
+	const nextAction = `/plugin setup ${nextTarget}`;
 	return `${summary}\nnext: ${nextAction}`;
 }