@f5xc-salesdemos/xcsh 19.6.0 → 19.8.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "19.6.0",
+	"version": "19.8.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -50,12 +50,12 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "19.6.0",
-		"@f5xc-salesdemos/pi-agent-core": "19.6.0",
-		"@f5xc-salesdemos/pi-ai": "19.6.0",
-		"@f5xc-salesdemos/pi-natives": "19.6.0",
-		"@f5xc-salesdemos/pi-tui": "19.6.0",
-		"@f5xc-salesdemos/pi-utils": "19.6.0",
+		"@f5xc-salesdemos/xcsh-stats": "19.8.0",
+		"@f5xc-salesdemos/pi-agent-core": "19.8.0",
+		"@f5xc-salesdemos/pi-ai": "19.8.0",
+		"@f5xc-salesdemos/pi-natives": "19.8.0",
+		"@f5xc-salesdemos/pi-tui": "19.8.0",
+		"@f5xc-salesdemos/pi-utils": "19.8.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

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

@@ -0,0 +1,50 @@
+import type { MarketplacePluginEntry } from "./types";
+
+const cache = new Map<string, boolean>();
+
+export async function checkPrerequisite(detectCmd: string): Promise<boolean> {
+	const cached = cache.get(detectCmd);
+	if (cached !== undefined) return cached;
+
+	try {
+		const [cmd, ...args] = detectCmd.split(/\s+/);
+		const proc = Bun.spawn([cmd!, ...args], {
+			stdout: "ignore",
+			stderr: "ignore",
+		});
+		const exitCode = await proc.exited;
+		const available = exitCode === 0;
+		cache.set(detectCmd, available);
+		return available;
+	} catch {
+		cache.set(detectCmd, false);
+		return false;
+	}
+}
+
+export async function checkAllPrerequisites(
+	plugins: MarketplacePluginEntry[],
+): Promise<Map<string, { available: boolean; missing: string[] }>> {
+	const results = new Map<string, { available: boolean; missing: string[] }>();
+
+	for (const plugin of plugins) {
+		if (!plugin.prerequisites || plugin.prerequisites.length === 0) {
+			results.set(plugin.name, { available: true, missing: [] });
+			continue;
+		}
+
+		const missing: string[] = [];
+		for (const prereq of plugin.prerequisites) {
+			const ok = await checkPrerequisite(prereq.detectCmd);
+			if (!ok) missing.push(prereq.tool);
+		}
+
+		results.set(plugin.name, { available: missing.length === 0, missing });
+	}
+
+	return results;
+}
+
+export function clearPrerequisiteCache(): void {
+	cache.clear();
+}

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

@@ -89,6 +89,8 @@ export interface MarketplacePluginEntry {
 	tags?: string[];
 	strict?: boolean;
 	defaultEnabled?: boolean;
+	recommended?: boolean;
+	prerequisites?: Array<{ tool: string; installCmd: string; detectCmd: string }>;
 	commands?: string | string[];
 	agents?: string | string[];
 	hooks?: string | Record<string, unknown>;

package/src/internal-urls/build-info.generated.ts

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.6.0",
-	"commit": "8505c9827499b1e269615db372fec4132b61c506",
-	"shortCommit": "8505c98",
+	"version": "19.8.0",
+	"commit": "ea6c3e825dbbdf4e3e471bbe3a22dc503e00f30e",
+	"shortCommit": "ea6c3e8",
 	"branch": "main",
-	"tag": "v19.6.0",
-	"commitDate": "2026-06-04T18:26:24Z",
-	"buildDate": "2026-06-04T18:51:12.169Z",
+	"tag": "v19.8.0",
+	"commitDate": "2026-06-05T00:33:42Z",
+	"buildDate": "2026-06-05T00:57:39.846Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/8505c9827499b1e269615db372fec4132b61c506",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.6.0"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/ea6c3e825dbbdf4e3e471bbe3a22dc503e00f30e",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.8.0"
 };

package/src/modes/components/plugins/state-manager.ts

@@ -62,6 +62,8 @@ function catalogToDashboard(entry: MarketplacePluginEntry, marketplace: string):
 		installed: false,
 		enabled: false,
 		hasUpdate: false,
+		recommended: entry.recommended,
+		prerequisites: entry.prerequisites,
 	};
 }
 
@@ -98,6 +100,8 @@ export async function loadAllPlugins(mgr: MarketplaceManager, npmMgr: PluginMana
 				const existing = plugins.find(p => p.id === pluginId);
 				if (existing) {
 					existing.displayName = existing.displayName || entry.displayName;
+					existing.recommended = existing.recommended || entry.recommended;
+					existing.prerequisites = existing.prerequisites || entry.prerequisites;
 					existing.description = existing.description || entry.description;
 					existing.category = existing.category || entry.category;
 					existing.tags = existing.tags || entry.tags;
@@ -126,10 +130,14 @@ export async function loadAllPlugins(mgr: MarketplaceManager, npmMgr: PluginMana
 export function buildTabs(plugins: DashboardPlugin[]): PluginTab[] {
 	const tabs: PluginTab[] = [];
 	const installedCount = plugins.filter(p => p.installed).length;
+	const recommendedCount = plugins.filter(p => !p.installed && p.recommended).length;
 	const discoverCount = plugins.filter(p => !p.installed).length;
 	const updatesCount = plugins.filter(p => p.hasUpdate).length;
 
 	tabs.push({ id: "installed", label: "Installed", count: installedCount });
+	if (recommendedCount > 0) {
+		tabs.push({ id: "recommended", label: "Recommended", count: recommendedCount });
+	}
 	if (discoverCount > 0) {
 		tabs.push({ id: "discover", label: "Discover", count: discoverCount });
 	}
@@ -143,6 +151,8 @@ export function filterByTab(plugins: DashboardPlugin[], tabId: PluginTabId): Das
 	switch (tabId) {
 		case "installed":
 			return plugins.filter(p => p.installed);
+		case "recommended":
+			return plugins.filter(p => !p.installed && p.recommended);
 		case "discover":
 			return plugins.filter(p => !p.installed);
 		case "updates":

package/src/modes/components/plugins/types.ts

@@ -18,9 +18,11 @@ export interface DashboardPlugin {
 	shadowedBy?: "project";
 	hasUpdate: boolean;
 	updateVersion?: string;
+	recommended?: boolean;
+	prerequisites?: Array<{ tool: string; installCmd: string; detectCmd: string }>;
 }
 
-export type PluginTabId = "installed" | "discover" | "updates";
+export type PluginTabId = "installed" | "recommended" | "discover" | "updates";
 
 export interface PluginTab {
 	id: PluginTabId;

package/src/slash-commands/builtin-registry.ts

@@ -875,6 +875,7 @@ const BUILTIN_SLASH_COMMAND_REGISTRY: ReadonlyArray<BuiltinSlashCommandSpec> = [
 			{ name: "discover", description: "Browse available plugins", usage: "[marketplace]" },
 			{ name: "list", description: "List all installed plugins" },
 			{ name: "validate", description: "Validate marketplace or plugin manifest", usage: "[path]" },
+			{ name: "setup", description: "Guided setup for recommended plugins" },
 			{ name: "help", description: "Show usage guide" },
 		],
 		allowArgs: true,
@@ -969,7 +970,6 @@ const BUILTIN_SLASH_COMMAND_REGISTRY: ReadonlyArray<BuiltinSlashCommandSpec> = [
 								}
 								break;
 							}
-							case "list":
 							default: {
 								const marketplaces = await mgr.listMarketplaces();
 								if (marketplaces.length === 0) {
@@ -1162,6 +1162,80 @@ const BUILTIN_SLASH_COMMAND_REGISTRY: ReadonlyArray<BuiltinSlashCommandSpec> = [
 						}
 						break;
 					}
+					// ── Setup (guided recommended plugin install) ──
+					case "setup": {
+						const { checkPrerequisite } = await import("../extensibility/plugins/marketplace/prerequisites");
+						const allPlugins = await mgr.listAvailablePlugins();
+						const recommended = allPlugins.filter(p => p.recommended);
+						if (recommended.length === 0) {
+							runtime.ctx.showStatus("No recommended plugins found in configured marketplaces");
+							break;
+						}
+
+						const installed = await mgr.listInstalledPlugins();
+						const installedIds = new Set(installed.map(p => p.id));
+						const toInstall = recommended.filter(
+							p => !Array.from(installedIds).some(id => id.startsWith(`${p.name}@`)),
+						);
+
+						if (toInstall.length === 0) {
+							runtime.ctx.showStatus("All recommended plugins are already installed");
+							break;
+						}
+
+						const lines: string[] = ["Recommended plugins setup:\n"];
+						let installedCount = 0;
+						let skippedCount = 0;
+						const skippedReasons: string[] = [];
+
+						for (const plugin of toInstall) {
+							if (plugin.prerequisites && plugin.prerequisites.length > 0) {
+								const missing: string[] = [];
+								for (const prereq of plugin.prerequisites) {
+									const ok = await checkPrerequisite(prereq.detectCmd);
+									if (!ok) missing.push(`${prereq.tool} (${prereq.installCmd})`);
+								}
+								if (missing.length > 0) {
+									lines.push(`  ⊘ ${plugin.displayName || plugin.name} — missing: ${missing.join(", ")}`);
+									skippedCount++;
+									skippedReasons.push(...missing);
+									continue;
+								}
+							}
+
+							const marketplaces = await mgr.listMarketplaces();
+							let installed = false;
+							for (const mkt of marketplaces) {
+								const available = await mgr.listAvailablePlugins(mkt.name);
+								if (available.some(a => a.name === plugin.name)) {
+									try {
+										await mgr.installPlugin(plugin.name, mkt.name);
+										lines.push(`  + ${plugin.displayName || plugin.name} — installed`);
+										installedCount++;
+										installed = true;
+									} catch (err) {
+										lines.push(
+											`  ! ${plugin.displayName || plugin.name} — ${err instanceof Error ? err.message : String(err)}`,
+										);
+										skippedCount++;
+									}
+									break;
+								}
+							}
+							if (!installed && skippedCount === 0) {
+								lines.push(`  ? ${plugin.displayName || plugin.name} — not found in any marketplace`);
+								skippedCount++;
+							}
+						}
+
+						lines.push("");
+						lines.push(`Installed ${installedCount}/${toInstall.length} recommended plugin(s)`);
+						if (skippedCount > 0) {
+							lines.push(`${skippedCount} skipped — install missing tools and run /plugin setup again`);
+						}
+						runtime.ctx.showStatus(lines.join("\n"));
+						break;
+					}
 					// ── Help ──
 					case "help": {
 						runtime.ctx.showStatus(
@@ -1180,6 +1254,7 @@ const BUILTIN_SLASH_COMMAND_REGISTRY: ReadonlyArray<BuiltinSlashCommandSpec> = [
 								"  /plugin upgrade [name@marketplace]         Upgrade plugin(s)",
 								"  /plugin list                               List installed plugins",
 								"  /plugin validate [path]                    Validate marketplace or plugin",
+								"  /plugin setup                              Guided setup for recommended plugins",
 								"",
 								"Quick start:",
 								"  /plugin marketplace add f5xc-salesdemos/marketplace",