@f5-sales-demo/xcsh 20.20.0 → 20.20.2

package/CHANGELOG.md

@@ -16,6 +16,12 @@
   contract so TUI, Browser, Office, RPC, and ACP transports no longer identify media by tool name
   ([#3202](https://github.com/f5-sales-demo/xcsh/issues/3202)).
 
+### Fixed
+
+- Restored bare `xcsh update` as a backward-compatible executable updater while preserving
+  manifest-based resource updates and the explicit `xcsh self-update` command
+  ([#3249](https://github.com/f5-sales-demo/xcsh/issues/3249)).
+
 ## [20.6.3] - 2026-08-07
 
 ### Improved

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "20.20.0",
+	"version": "20.20.2",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -61,13 +61,13 @@
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "1.3.0",
-		"@f5-sales-demo/pi-agent-core": "20.20.0",
-		"@f5-sales-demo/pi-ai": "20.20.0",
-		"@f5-sales-demo/pi-natives": "20.20.0",
-		"@f5-sales-demo/pi-resource-management": "20.20.0",
-		"@f5-sales-demo/pi-tui": "20.20.0",
-		"@f5-sales-demo/pi-utils": "20.20.0",
-		"@f5-sales-demo/xcsh-stats": "20.20.0",
+		"@f5-sales-demo/pi-agent-core": "20.20.2",
+		"@f5-sales-demo/pi-ai": "20.20.2",
+		"@f5-sales-demo/pi-natives": "20.20.2",
+		"@f5-sales-demo/pi-resource-management": "20.20.2",
+		"@f5-sales-demo/pi-tui": "20.20.2",
+		"@f5-sales-demo/pi-utils": "20.20.2",
+		"@f5-sales-demo/xcsh-stats": "20.20.2",
 		"@mozilla/readability": "^0.6",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",

package/src/cli/update-cli.ts

@@ -1,7 +1,7 @@
 /**
  * Update CLI command handler.
  *
- * Handles `xcsh self-update` to check for and install executable updates.
+ * Handles executable updates for explicit `xcsh self-update` and compatible `xcsh update` forms.
  * Auto-detects the installation method (npm, brew, bun, or standalone binary)
  * and updates through the appropriate channel.
  */
@@ -439,14 +439,21 @@ export async function runUpdateCommand(opts: { force: boolean; check: boolean })
  * Print update command help.
  */
 export function printUpdateHelp(): void {
-	console.log(`${chalk.bold(`${APP_NAME} update`)} - Check for and install updates
+	console.log(`${chalk.bold(`${APP_NAME} update`)} - Update the executable or existing resources from manifests
 
 ${chalk.bold("Usage:")}
-  ${APP_NAME} update [options]
+  ${APP_NAME} update [--check | --force]
+  ${APP_NAME} update -f <manifest> [resource options]
 
-${chalk.bold("Options:")}
-  -c, --check   Check for updates without installing
-  -f, --force   Force reinstall even if up to date
+${chalk.bold("Executable options:")}
+  -c, --check   Check for executable updates without installing
+      --force   Force reinstall even if up to date
+
+${chalk.bold("Resource input:")}
+  -f, --filename <manifest>   Update resources from a manifest
+
+Short -f means --filename for xcsh update. Use xcsh self-update -f for the
+short executable force form. Executable and resource flags cannot be mixed.
 
 ${chalk.bold("Install methods (auto-detected):")}
   npm           Installed via npm install -g
@@ -458,5 +465,6 @@ ${chalk.bold("Examples:")}
   ${APP_NAME} update           Update to latest version
   ${APP_NAME} update --check   Check if updates are available
   ${APP_NAME} update --force   Force reinstall
+  ${APP_NAME} update -f manifest.yaml   Update resources
 `);
 }

package/src/commands/update.ts

@@ -1,21 +1,111 @@
-import { Command } from "@f5-sales-demo/pi-utils/cli";
+import { CliUsageError, Command, Flags, 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");
+}
+
+/** Resolve the backward-compatible `update` command before either updater 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 });
+	if (parsed.argv.length > 0) {
+		throw new CliUsageError(`Unexpected argument${parsed.argv.length === 1 ? "" : "s"}: ${parsed.argv.join(" ")}`);
+	}
+
+	const flags = parsed.flags as {
+		filename?: string[];
+		namespace?: string;
+		output: ResourceOutputFormat;
+		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,
+		namespace: flags.namespace,
+		outputFormat: flags.output,
+		recursive: flags.recursive,
+		dryRun: flags["dry-run"],
+		resultFile: flags["result-file"],
+	};
+}
+
 export default class Update extends Command {
-	static description = "Update existing resources from manifests";
-	static flags = manifestResourceFlags;
+	static description = "Update the xcsh executable or existing resources from manifests";
+	static flags = updateFlags;
+	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",
+	];
 
 	async run(): Promise<void> {
-		const { flags } = await this.parse(Update);
+		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: flags.filename,
-			namespace: flags.namespace,
-			outputFormat: flags.output as "json" | "yaml" | "table" | "wide",
-			recursive: flags.recursive,
-			dryRun: flags["dry-run"] as "client" | undefined,
-			resultFile: flags["result-file"],
+			filenames: invocation.filenames,
+			namespace: invocation.namespace,
+			outputFormat: invocation.outputFormat,
+			recursive: invocation.recursive,
+			dryRun: invocation.dryRun,
+			resultFile: invocation.resultFile,
 		});
 	}
 }

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "20.20.0",
-	"commit": "2017729c40c9c2253301fd8860bcac960b5837d2",
-	"shortCommit": "2017729",
+	"version": "20.20.2",
+	"commit": "04c71999d5ced53fa9200d3ae79a4ad2ba86debb",
+	"shortCommit": "04c7199",
 	"branch": "main",
-	"tag": "v20.20.0",
-	"commitDate": "2026-08-16T22:46:12Z",
-	"buildDate": "2026-08-16T23:14:16.083Z",
+	"tag": "v20.20.2",
+	"commitDate": "2026-08-17T12:59:16Z",
+	"buildDate": "2026-08-17T13:25:27.576Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5-sales-demo/xcsh",
 	"repoSlug": "f5-sales-demo/xcsh",
-	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/2017729c40c9c2253301fd8860bcac960b5837d2",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v20.20.0"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/04c71999d5ced53fa9200d3ae79a4ad2ba86debb",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v20.20.2"
 };

package/src/internal-urls/console-catalog.generated.ts

@@ -2,10 +2,10 @@
 
 import type { ConsoleCatalogData } from "./console-catalog-types";
 
-export const CONSOLE_CATALOG_VERSION = "35f6e40dcaccc906474e2c28999f04d4bee4f519";
+export const CONSOLE_CATALOG_VERSION = "1999b4cee787136ee0bc7cd02deba57ac6381885";
 
 export const CONSOLE_CATALOG_DATA: ConsoleCatalogData = {
-	version: "35f6e40dcaccc906474e2c28999f04d4bee4f519",
+	version: "1999b4cee787136ee0bc7cd02deba57ac6381885",
 	workflows: {
 		"address-allocator/create":
 			'---\nschema: urn:xcsh:console:workflow:v1\nid: address-allocator-create\nlabel: Create IP Address Allocators\nresource: address-allocator\noperation: create\npreconditions:\n  - user_logged_in\n  - "role_minimum: admin"\nparams:\n  name:\n    required: true\n    description: IP Address Allocators name (lowercase alphanumeric and hyphens)\n    example: example-address-allocator\n  address_allocator_mode:\n    required: true\n    description: Address Allocator Mode\n  allocation_unit:\n    required: false\n    description: Allocation Unit\n    default: 0\n  address_pool:\n    required: false\n    description: Address Pool\n    default: value\n  address_allocation_scheme:\n    required: false\n    description: "Server-required: Field should be not nil"\n    default: value\nsteps:\n  - id: navigate-to-list\n    action: navigate\n    url: /web/workspaces/multi-cloud-network-connect/manage/networking/legacy_network_configuration/address_allocators\n    wait_for: text(\'IP Address Allocators\')\n    description: Navigate to IP Address Allocators list page\n  - id: click-add-tab\n    action: click\n    selector: text(\'Add IP Address Allocator\')\n    wait_for: textbox[name=\'Name\']\n    description: Click Add IP Address Allocator to open the create form\n  - id: fill-name\n    action: fill\n    selector: textbox[name=\'Name\']\n    value: "{name}"\n    description: Enter Name\n  - id: select-address_allocator_mode\n    action: select\n    selector: listbox\n    context: Address Allocator Mode section\n    value: "{address_allocator_mode}"\n    description: Select Address Allocator Mode\n  - id: fill-allocation_unit\n    action: fill\n    selector: spinbutton[name=\'Allocation Unit\']\n    value: "{allocation_unit}"\n    description: Set Allocation Unit\n  - id: fill-address_pool\n    action: fill\n    selector: ngx-datatable input.form-control\n    context: Address Pool table\n    value: "{address_pool}"\n    description: Enter Address Pool in the existing table row (no Add Item needed — the table ships one empty row)\n  - id: select-address_allocation_scheme\n    action: select\n    selector: listbox\n    context: Address Allocation Scheme section\n    value: "{address_allocation_scheme}"\n    description: Select Address Allocation Scheme\n  - id: save\n    action: click\n    selector: "[class*=\'save-bt\'],[class*=\'submit-button\']"\n    context: footer\n    wait_for: text(\'{name}\')\n    wait_timeout_ms: 30000\n    description: Save/submit the form (union selector matches save-bt OR submit-button)\npostconditions:\n  - resource_list_page_visible\n  - "resource_name_in_list: {name}"\nmetadata:\n  confidence: inferred\n  discovered_at: 2026-06-24\n  console_version: "2025.06"\n  notes: Auto-generated by scripts/generate-workflows.ts from api-specs-enriched field metadata.\n',

package/src/locales/en.json

@@ -288,7 +288,7 @@
 	"welcome.modelProvider": "Model Provider",
 	"welcome.plugins": "Plugins",
 	"welcome.pluginSetupHint": "run: /plugin setup",
-	"welcome.updateHint": "run: xcsh self-update",
+	"welcome.updateHint": "run: xcsh update",
 	"welcome.newVersion": "new version",
 	"welcome.connectionFailed": "— connection failed",
 	"welcome.runLoginReconnect": "Run /login to reconnect",

package/src/main.ts

@@ -180,7 +180,7 @@ async function runInteractiveMode(
 	if (settings.get("startup.checkUpdate")) {
 		void versionCheckPromise
 			.then(latest => {
-				if (latest) mode.showStatus(`Update available: v${latest} — run: xcsh self-update`, { dim: true });
+				if (latest) mode.showStatus(`Update available: v${latest} — run: xcsh update`, { dim: true });
 			})
 			.catch(() => {});
 	}