@f5-sales-demo/xcsh 22.0.1 → 22.1.2

package/src/cli/update-recommendation.ts

@@ -0,0 +1,299 @@
+import { readFile, realpath } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+
+const PACKAGE = "@f5-sales-demo/xcsh";
+const WINDOWS_INSTALL_COMMAND =
+	"irm https://raw.githubusercontent.com/f5-sales-demo/xcsh/main/scripts/install.ps1 | iex";
+
+export type InstallChannel =
+	| "homebrew-cask"
+	| "macos-mdm"
+	| "debian-apt"
+	| "npm"
+	| "bun"
+	| "standalone"
+	| "windows-installer"
+	| "unknown";
+
+export type UpdateRecommendation = {
+	channel: InstallChannel;
+	action: "external-command" | "self-update" | "managed" | "blocked";
+	command?: string;
+	evidence: string;
+};
+
+type CommandResult = { exitCode: number; stdout: string; stderr: string };
+
+export interface InstallChannelDependencies {
+	platform: NodeJS.Platform;
+	arch: string;
+	execPath: string;
+	version: string;
+	homeDir: string;
+	env: NodeJS.ProcessEnv;
+	realpath(value: string): Promise<string>;
+	readFile(value: string): Promise<string>;
+	run(command: string, args: string[]): Promise<CommandResult>;
+}
+
+interface InstallReceipt {
+	schemaVersion: 1;
+	channel: "standalone" | "windows-installer";
+	version: string;
+	executablePath: string;
+	platform: string;
+	arch: string;
+}
+
+function platformPath(platform: NodeJS.Platform): typeof path.posix | typeof path.win32 {
+	return platform === "win32" ? path.win32 : path.posix;
+}
+
+function comparablePath(value: string, platform: NodeJS.Platform): string {
+	const normalized = platformPath(platform).resolve(value);
+	return platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+
+function releaseAsset(platform: NodeJS.Platform, arch: string): string | undefined {
+	if (platform === "linux" && (arch === "x64" || arch === "arm64")) return `xcsh-linux-${arch}`;
+	if (platform === "darwin" && (arch === "x64" || arch === "arm64")) return `xcsh-darwin-${arch}`;
+	if (platform === "win32" && arch === "x64") return "xcsh-windows-x64.exe";
+	return undefined;
+}
+
+function expectedReleaseCacheBinary(deps: InstallChannelDependencies): string | undefined {
+	const asset = releaseAsset(deps.platform, deps.arch);
+	if (!asset) return undefined;
+	const pathApi = platformPath(deps.platform);
+	const cacheRoot =
+		deps.env.XCSH_RELEASE_CACHE_DIR ??
+		(deps.platform === "win32"
+			? pathApi.join(deps.env.LOCALAPPDATA ?? deps.env.TEMP ?? deps.homeDir, "xcsh", "releases")
+			: pathApi.join(deps.env.XDG_CACHE_HOME ?? pathApi.join(deps.homeDir, ".cache"), "xcsh", "releases"));
+	return pathApi.join(cacheRoot, `v${deps.version}`, `${deps.platform}-${deps.arch}`, asset);
+}
+
+function receiptIsValid(
+	value: unknown,
+	deps: InstallChannelDependencies,
+	resolvedExecPath: string,
+): value is InstallReceipt {
+	if (!value || typeof value !== "object") return false;
+	const receipt = value as Partial<InstallReceipt>;
+	if (
+		receipt.schemaVersion !== 1 ||
+		(receipt.channel !== "standalone" && receipt.channel !== "windows-installer") ||
+		receipt.version !== deps.version ||
+		receipt.platform !== deps.platform ||
+		receipt.arch !== deps.arch ||
+		typeof receipt.executablePath !== "string" ||
+		comparablePath(receipt.executablePath, deps.platform) !== comparablePath(resolvedExecPath, deps.platform)
+	) {
+		return false;
+	}
+	if (receipt.channel === "standalone") return deps.platform !== "win32";
+	if (deps.platform !== "win32") return false;
+	const localAppData = deps.env.LOCALAPPDATA;
+	if (!localAppData) return false;
+	return (
+		comparablePath(resolvedExecPath, deps.platform) ===
+		comparablePath(path.win32.join(localAppData, "xcsh", "xcsh.exe"), deps.platform)
+	);
+}
+
+async function defaultRun(command: string, args: string[]): Promise<CommandResult> {
+	try {
+		const child = Bun.spawn([command, ...args], { stdin: "ignore", stdout: "pipe", stderr: "pipe" });
+		const [exitCode, stdout, stderr] = await Promise.all([
+			child.exited,
+			new Response(child.stdout).text(),
+			new Response(child.stderr).text(),
+		]);
+		return { exitCode, stdout, stderr };
+	} catch (error) {
+		return { exitCode: 127, stdout: "", stderr: error instanceof Error ? error.message : String(error) };
+	}
+}
+
+export function defaultInstallChannelDependencies(version: string): InstallChannelDependencies {
+	return {
+		platform: process.platform,
+		arch: process.arch,
+		execPath: process.execPath,
+		version,
+		homeDir: homedir(),
+		env: process.env,
+		realpath,
+		readFile: value => readFile(value, "utf8"),
+		run: defaultRun,
+	};
+}
+
+function recommendationFor(channel: Exclude<InstallChannel, "unknown">, evidence: string): UpdateRecommendation {
+	switch (channel) {
+		case "homebrew-cask":
+			return {
+				channel,
+				action: "external-command",
+				command: "brew upgrade --cask f5-sales-demo/tap/xcsh",
+				evidence,
+			};
+		case "macos-mdm":
+			return { channel, action: "managed", evidence };
+		case "debian-apt":
+			return {
+				channel,
+				action: "external-command",
+				command: "sudo apt-get update && sudo apt-get install --only-upgrade xcsh",
+				evidence,
+			};
+		case "npm":
+		case "bun":
+			return {
+				channel,
+				action: "external-command",
+				command: `${channel} update --global ${PACKAGE}`,
+				evidence,
+			};
+		case "standalone":
+			return { channel, action: "self-update", command: "xcsh self-update", evidence };
+		case "windows-installer":
+			return { channel, action: "external-command", command: WINDOWS_INSTALL_COMMAND, evidence };
+	}
+}
+
+/** Resolve the owner of the running executable without mutating the installation. */
+export async function resolveInstallChannel(deps: InstallChannelDependencies): Promise<UpdateRecommendation> {
+	let resolvedExecPath: string;
+	try {
+		resolvedExecPath = await deps.realpath(deps.execPath);
+	} catch {
+		return { channel: "unknown", action: "blocked", evidence: "running executable could not be resolved" };
+	}
+
+	const signals: Array<{ channel: Exclude<InstallChannel, "unknown">; evidence: string }> = [];
+	const diagnostics: string[] = [];
+	const normalizedResolved = resolvedExecPath.replaceAll("\\", "/");
+
+	if (
+		deps.platform === "darwin" &&
+		/^\/(?:opt\/homebrew|usr\/local)\/Caskroom\/xcsh\/[^/]+\/bin\/xcsh$/u.test(normalizedResolved)
+	) {
+		signals.push({ channel: "homebrew-cask", evidence: `running executable resolves to ${resolvedExecPath}` });
+	}
+
+	if (deps.platform === "darwin" && deps.execPath === "/usr/local/bin/xcsh" && resolvedExecPath === deps.execPath) {
+		const pkg = await deps.run("pkgutil", ["--pkg-info", "com.f5.xcsh"]);
+		const files = await deps.run("pkgutil", ["--files", "com.f5.xcsh"]);
+		if (
+			pkg.exitCode === 0 &&
+			/(?:^|\n)package-id:\s*com\.f5\.xcsh(?:\n|$)/u.test(pkg.stdout) &&
+			files.exitCode === 0 &&
+			files.stdout.split("\n").some(line => line.trim() === "usr/local/bin/xcsh")
+		) {
+			signals.push({
+				channel: "macos-mdm",
+				evidence: "exact /usr/local/bin/xcsh identity and com.f5.xcsh receipt",
+			});
+		}
+	}
+
+	if (deps.platform === "linux") {
+		const dpkg = await deps.run("dpkg-query", ["--search", resolvedExecPath]);
+		if (dpkg.exitCode === 0 && dpkg.stdout.split("\n").some(line => line.trim() === `xcsh: ${resolvedExecPath}`)) {
+			signals.push({ channel: "debian-apt", evidence: `dpkg package xcsh owns ${resolvedExecPath}` });
+		}
+	}
+
+	const marker = deps.env.XCSH_DISTRIBUTION_CHANNEL;
+	if (marker === "npm" || marker === "bun") {
+		const expectedBinary = expectedReleaseCacheBinary(deps);
+		if (
+			expectedBinary &&
+			comparablePath(expectedBinary, deps.platform) === comparablePath(resolvedExecPath, deps.platform)
+		) {
+			signals.push({
+				channel: marker,
+				evidence: `${marker} launcher marker and compiled-release cache path ${resolvedExecPath}`,
+			});
+		} else {
+			diagnostics.push(`invalid ${marker} launcher marker for ${resolvedExecPath}`);
+		}
+	} else if (marker) {
+		diagnostics.push(`invalid launcher marker ${marker}`);
+	}
+
+	const receiptPath = platformPath(deps.platform).join(
+		platformPath(deps.platform).dirname(resolvedExecPath),
+		"xcsh-install.json",
+	);
+	try {
+		const parsed = JSON.parse(await deps.readFile(receiptPath));
+		if (receiptIsValid(parsed, deps, resolvedExecPath)) {
+			signals.push({
+				channel: parsed.channel,
+				evidence: `valid schema-v1 ${parsed.channel} receipt at ${receiptPath}`,
+			});
+		} else {
+			diagnostics.push(`invalid or stale install receipt at ${receiptPath}`);
+		}
+	} catch (error) {
+		if ((error as NodeJS.ErrnoException).code !== "ENOENT") {
+			diagnostics.push(`malformed install receipt at ${receiptPath}`);
+		}
+	}
+
+	const uniqueChannels = [...new Set(signals.map(signal => signal.channel))];
+	if (uniqueChannels.length > 1 || (uniqueChannels.length > 0 && diagnostics.length > 0)) {
+		return {
+			channel: "unknown",
+			action: "blocked",
+			evidence: `conflicting installation evidence: ${[...uniqueChannels, ...diagnostics].join(", ")}`,
+		};
+	}
+	if (signals.length === 1) return recommendationFor(signals[0].channel, signals[0].evidence);
+	if (signals.length > 1)
+		return recommendationFor(signals[0].channel, signals.map(signal => signal.evidence).join("; "));
+
+	return {
+		channel: "unknown",
+		action: "blocked",
+		evidence: diagnostics.join("; ") || `no trusted installation provenance for ${resolvedExecPath}`,
+	};
+}
+
+export function formatUpdateRecommendation(recommendation: UpdateRecommendation): string {
+	switch (recommendation.action) {
+		case "external-command":
+			return `Update with: ${recommendation.command}\nNo update was performed; this installation is owned by ${recommendation.channel}.`;
+		case "managed":
+			return "Managed by your organization; request an MDM deployment.\nNo update was performed.";
+		case "self-update":
+			return "This official standalone installation can update itself with: xcsh self-update";
+		case "blocked":
+			return `Update blocked: ${recommendation.evidence}. Reinstall using the documented installation channel that owns this executable.`;
+	}
+}
+
+export function formatStartupUpdateNotice(version: string, recommendation: UpdateRecommendation): string {
+	const prefix = `Update available: v${version} — `;
+	if (recommendation.action === "external-command") return `${prefix}run: ${recommendation.command}`;
+	if (recommendation.action === "managed") return `${prefix}managed by your organization; request an MDM deployment`;
+	if (recommendation.action === "self-update") return `${prefix}run: xcsh self-update`;
+	return `${prefix}update blocked: ${recommendation.evidence}`;
+}
+
+export interface StartupUpdateDependencies {
+	getLatestVersion(currentVersion: string): Promise<string | undefined>;
+	resolveRecommendation(): Promise<UpdateRecommendation>;
+}
+
+export async function getStartupUpdateNotice(
+	currentVersion: string,
+	deps: StartupUpdateDependencies,
+): Promise<string | undefined> {
+	const latestVersion = await deps.getLatestVersion(currentVersion);
+	if (!latestVersion) return undefined;
+	return formatStartupUpdateNotice(latestVersion, await deps.resolveRecommendation());
+}

package/src/commands/self-update.ts

@@ -1,18 +1,23 @@
-/** Check for and install xcsh executable updates. */
+/** Check for executable updates and follow the detected installation channel. */
 import { Command, Flags } from "@f5-sales-demo/pi-utils/cli";
 import { runUpdateCommand } from "../cli/update-cli";
 import { initTheme } from "../modes/theme/theme";
 
 export default class SelfUpdate extends Command {
-	static description = "Check for and install xcsh executable updates";
+	static description = "Check for xcsh updates and follow the detected installation channel";
 	static flags = {
-		force: Flags.boolean({ char: "f", description: "Force update", default: false }),
-		check: Flags.boolean({ char: "c", description: "Check for updates without installing", default: false }),
+		force: Flags.boolean({
+			char: "f",
+			description: "Show or perform the channel-owned action when current",
+			default: false,
+		}),
+		check: Flags.boolean({ char: "c", description: "Report the channel without changing files", default: false }),
 	};
 
 	async run(): Promise<void> {
 		const { flags } = await this.parse(SelfUpdate);
 		await initTheme();
-		await runUpdateCommand({ force: flags.force, check: flags.check });
+		const exitCode = await runUpdateCommand({ force: flags.force, check: flags.check });
+		if (exitCode !== 0) process.exitCode = exitCode;
 	}
 }

package/src/commands/update.ts

@@ -1,44 +1,22 @@
-import { CliUsageError, Command, Flags, parseCommandArgv } from "@f5-sales-demo/pi-utils/cli";
+import { CliUsageError, Command, parseCommandArgv } from "@f5-sales-demo/pi-utils/cli";
 import { runResourceCli } from "../cli/resource-cli";
-import { runUpdateCommand } from "../cli/update-cli";
-import { initTheme } from "../modes/theme/theme";
 import { manifestResourceFlags } from "./resource-flags";
 
-const updateFlags = {
-	...manifestResourceFlags,
-	force: Flags.boolean({
-		description: "Force executable update (short -f is reserved for resource manifests)",
-		default: false,
-	}),
-	check: Flags.boolean({ char: "c", description: "Check for executable updates without installing", default: false }),
-};
-
 type ResourceOutputFormat = "json" | "yaml" | "table" | "wide";
 
-export type UpdateInvocation =
-	| { mode: "executable"; force: boolean; check: boolean }
-	| {
-			mode: "resource";
-			filenames: string[] | undefined;
-			namespace: string | undefined;
-			outputFormat: ResourceOutputFormat;
-			recursive: boolean;
-			dryRun: "client" | undefined;
-			resultFile: string | undefined;
-	  };
-
-function explicitlyRequestsDefaultOutput(argv: readonly string[]): boolean {
-	return argv.some(arg => arg === "--output" || arg.startsWith("--output=") || arg === "-o");
-}
+export type UpdateInvocation = {
+	mode: "resource";
+	filenames: string[] | undefined;
+	namespace: string | undefined;
+	outputFormat: ResourceOutputFormat;
+	recursive: boolean;
+	dryRun: "client" | undefined;
+	resultFile: string | undefined;
+};
 
-/** Resolve the backward-compatible `update` command before either updater can perform I/O. */
+/** Parse the resource-update command before it can perform I/O. */
 export function parseUpdateInvocation(argv: readonly string[]): UpdateInvocation {
-	if (argv.length === 1 && argv[0] === "-f") {
-		throw new CliUsageError(
-			"Ambiguous -f: use 'xcsh update --force' or 'xcsh self-update -f' for executable updates; otherwise provide a resource manifest",
-		);
-	}
-	const parsed = parseCommandArgv(argv, { flags: updateFlags });
+	const parsed = parseCommandArgv(argv, { flags: manifestResourceFlags });
 	if (parsed.argv.length > 0) {
 		throw new CliUsageError(`Unexpected argument${parsed.argv.length === 1 ? "" : "s"}: ${parsed.argv.join(" ")}`);
 	}
@@ -50,25 +28,7 @@ export function parseUpdateInvocation(argv: readonly string[]): UpdateInvocation
 		recursive: boolean;
 		"dry-run"?: "client";
 		"result-file"?: string;
-		force: boolean;
-		check: boolean;
 	};
-	const executableRequested = flags.force || flags.check;
-	const resourceRequested =
-		flags.filename !== undefined ||
-		flags.namespace !== undefined ||
-		flags.recursive ||
-		flags["dry-run"] !== undefined ||
-		flags["result-file"] !== undefined ||
-		flags.output !== "table" ||
-		explicitlyRequestsDefaultOutput(argv);
-
-	if (executableRequested && resourceRequested) {
-		throw new CliUsageError("update cannot combine executable-update and resource-update flags");
-	}
-	if (!resourceRequested) {
-		return { mode: "executable", force: flags.force, check: flags.check };
-	}
 	return {
 		mode: "resource",
 		filenames: flags.filename,
@@ -81,23 +41,15 @@ export function parseUpdateInvocation(argv: readonly string[]): UpdateInvocation
 }
 
 export default class Update extends Command {
-	static description = "Update the xcsh executable or existing resources from manifests";
-	static flags = updateFlags;
+	static description = "Update F5 Distributed Cloud resources from manifests";
+	static flags = manifestResourceFlags;
 	static examples = [
-		"xcsh update                         # update the executable",
-		"xcsh update --check                 # check the executable version",
-		"xcsh update --force                 # force an executable reinstall",
-		"xcsh self-update -f                 # short force form for the executable",
 		"xcsh update -f manifest.yaml        # update resources from a manifest",
+		"xcsh update -f manifests/ -R        # update resources from a manifest directory",
 	];
 
 	async run(): Promise<void> {
 		const invocation = parseUpdateInvocation(this.argv);
-		if (invocation.mode === "executable") {
-			await initTheme();
-			await runUpdateCommand({ force: invocation.force, check: invocation.check });
-			return;
-		}
 		await runResourceCli({
 			operation: "update",
 			filenames: invocation.filenames,

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        "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.3",\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      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Herdr",\n        "version": "1.1.3"\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.8",\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.8"\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      "name": "ghostty",\n      "version": "1.0.2",\n      "description": "Curated Linux Ghostty setup for Xorg and Herdr terminal sessions",\n      "license": "MIT",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Ghostty",\n        "version": "1.0.2"\n      },\n      "source": "./plugins/ghostty",\n      "category": "development",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/ghostty",\n      "keywords": ["ghostty", "terminal", "xorg", "herdr"],\n      "tags": ["linux", "terminal", "xorg"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["ghostty"],\n        "requirements": ["Ubuntu Linux", "Xorg and Herdr marketplace plugins"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": ["xorg", "herdr"]\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.3",\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      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Herdr",\n        "version": "1.1.3"\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.9",\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.9"\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      "name": "ghostty",\n      "version": "1.0.2",\n      "description": "Curated Linux Ghostty setup for Xorg and Herdr terminal sessions",\n      "license": "MIT",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Ghostty",\n        "version": "1.0.2"\n      },\n      "source": "./plugins/ghostty",\n      "category": "development",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/ghostty",\n      "keywords": ["ghostty", "terminal", "xorg", "herdr"],\n      "tags": ["linux", "terminal", "xorg"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["ghostty"],\n        "requirements": ["Ubuntu Linux", "Xorg and Herdr marketplace plugins"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": ["xorg", "herdr"]\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": "229752aaa99ddfd929266d7cc66c15589b639bb0",
-  "sha256": "6da31bb20788ff089d1e60b9269672a734d2c95bcfa9d8504601d071a3d5d781",
-  "capturedAt": "2026-09-26T19:26:07.299Z"
+  "commit": "5683fee44ba0c4552625e28967b2fd1a09eb62d5",
+  "sha256": "5fec43e8aa49520cdb4206b792e6508c2048c5c4d178841c2477595a8a33f803",
+  "capturedAt": "2026-09-27T22:31:32.091Z"
 }