@robinmordasiewicz/f5xc-xcsh 6.34.0 → 6.35.0

package/completions/_xcsh

@@ -26,14 +26,14 @@ _xcsh() {
         (domain)
             local -a domains builtins
             domains=(
-            'admin_console_and_ui:Manage static UI assets for admin console'
+            'admin_console_and_ui:Manage static UI components for admin console'
             'api:Discover, catalog, and test service interfaces'
             'authentication:Authentication API'
             'bigip:Manage iRules, data groups, and virtual servers'
             'billing_and_usage:Manage subscription plans and payment methods'
             'blindfold:Manage secret encryption and policy rules'
-            'bot_and_threat_defense:Configure bot protection and threat categories'
-            'cdn:Configure caching rules and load balancers'
+            'bot_and_threat_defense:Detect and block automated attacks'
+            'cdn:Configure caching rules and load balancing'
             'ce_management:Manage Customer Edge sites and network interfaces'
             'certificates:Manage SSL/TLS certificate chains and trusted CAs'
             'cloud_infrastructure:Connect and manage multi-cloud providers'

package/completions/xcsh.fish

@@ -22,14 +22,14 @@ complete -c xcsh -n "__fish_use_subcommand" -a "context" -d 'Show current naviga
 complete -c xcsh -n "__fish_use_subcommand" -a "ctx" -d 'Show current navigation context'
 
 # Domain completions
-complete -c xcsh -n "__fish_use_subcommand" -a "admin_console_and_ui" -d 'Manage static UI assets for admin console'
+complete -c xcsh -n "__fish_use_subcommand" -a "admin_console_and_ui" -d 'Manage static UI components for admin console'
 complete -c xcsh -n "__fish_use_subcommand" -a "api" -d 'Discover, catalog, and test service interfaces'
 complete -c xcsh -n "__fish_use_subcommand" -a "authentication" -d 'Authentication API'
 complete -c xcsh -n "__fish_use_subcommand" -a "bigip" -d 'Manage iRules, data groups, and virtual servers'
 complete -c xcsh -n "__fish_use_subcommand" -a "billing_and_usage" -d 'Manage subscription plans and payment methods'
 complete -c xcsh -n "__fish_use_subcommand" -a "blindfold" -d 'Manage secret encryption and policy rules'
-complete -c xcsh -n "__fish_use_subcommand" -a "bot_and_threat_defense" -d 'Configure bot protection and threat categories'
-complete -c xcsh -n "__fish_use_subcommand" -a "cdn" -d 'Configure caching rules and load balancers'
+complete -c xcsh -n "__fish_use_subcommand" -a "bot_and_threat_defense" -d 'Detect and block automated attacks'
+complete -c xcsh -n "__fish_use_subcommand" -a "cdn" -d 'Configure caching rules and load balancing'
 complete -c xcsh -n "__fish_use_subcommand" -a "ce_management" -d 'Manage Customer Edge sites and network interfaces'
 complete -c xcsh -n "__fish_use_subcommand" -a "certificates" -d 'Manage SSL/TLS certificate chains and trusted CAs'
 complete -c xcsh -n "__fish_use_subcommand" -a "cloud_infrastructure" -d 'Connect and manage multi-cloud providers'

package/dist/index.js

@@ -44108,9 +44108,9 @@ var generatedDomains = /* @__PURE__ */ new Map([
   ["admin_console_and_ui", {
     name: "admin_console_and_ui",
     displayName: "Admin Console And Ui",
-    description: "Set up static resource definitions that control administrative dashboard appearance. Register named entries using object references, status tracking fields, and view settings. Fetch individual records through dedicated get operations or enumerate available entries with pagination and sorting. Handle request validation through typed error responses and support multiple output codes for success states. Define custom initialization blocks and namespace-scoped boundaries for organization.",
-    descriptionShort: "Manage static UI assets for admin console",
-    descriptionMedium: "Deploy and list dashboard widgets within namespaces. Create named visual resources with initialization parameters and structured configuration data.",
+    description: "Create administrative dashboard building blocks with tailored setup data and view bindings. Organize presentational materials by namespace and fetch them by name or list all available items. Define display parameters, track system object relationships, and maintain consistent portal appearance through centralized resource management workflows.",
+    descriptionShort: "Manage static UI components for admin console",
+    descriptionMedium: "Deploy and retrieve graphical elements within namespaces. Configure custom startup parameters and view references for display composition.",
     aliases: ["console-ui", "ui-assets", "static-components"],
     complexity: "simple",
     isPreview: false,
@@ -44242,9 +44242,9 @@ var generatedDomains = /* @__PURE__ */ new Map([
   ["bot_and_threat_defense", {
     name: "bot_and_threat_defense",
     displayName: "Bot And Threat Defense",
-    description: "Deploy Shape bot defense instances with namespace-scoped configuration for automated threat detection. Create TPM categories to classify and organize threat types across your security infrastructure. Generate and manage provisioning keys for programmatic access to defense systems. Set up threat managers to coordinate detection rules, integrate with WAF policies, and enable real-time protection against malicious traffic patterns.",
-    descriptionShort: "Configure bot protection and threat categories",
-    descriptionMedium: "Manage bot defense instances and threat classification per namespace. Provision automated defense keys for security integration.",
+    description: "Deploy namespace-scoped protection using behavioral analysis and machine learning. Provision dedicated keys for system automation and real-time intelligence feeds. Coordinate detection across protected applications through centralized managers. Configure pre-authentication checks to identify suspicious patterns before they reach backends. Enable adaptive blocking decisions based on risk scoring and historical activity profiles.",
+    descriptionShort: "Detect and block automated attacks",
+    descriptionMedium: "Create bot defense instances with Shape integration. Set up traffic classification rules and automated response policies for malicious actors.",
     aliases: ["threat-defense", "tpm", "shape-bot"],
     complexity: "moderate",
     isPreview: false,
@@ -44256,9 +44256,9 @@ var generatedDomains = /* @__PURE__ */ new Map([
   ["cdn", {
     name: "cdn",
     displayName: "Cdn",
-    description: "Create cache rules with cookie, header, and query parameter matching to control content eligibility. Configure load balancers with origin pool routing, access logging, and metrics collection. Manage cache purge operations for immediate content invalidation. Monitor service operation status and aggregate access logs for performance analysis. Define path matchers and expressions for granular cache behavior control across namespaces.",
-    descriptionShort: "Configure caching rules and load balancers",
-    descriptionMedium: "Define cache TTL policies and path matching rules. Set up load balancers with origin pools and purge controls for content delivery.",
+    description: "Set up cache eligibility based on headers, cookies, and query parameters. Create expression-based rules with custom TTL settings and path matchers. Deploy load balancers that handle content distribution across origin pools. Monitor access logs and metrics, aggregate performance data, and execute cache purge operations when content updates require immediate invalidation.",
+    descriptionShort: "Configure caching rules and load balancing",
+    descriptionMedium: "Define cache rules, TTLs, and path matching. Manage load balancers with origin pools and purge operations.",
     aliases: ["cache", "content"],
     complexity: "advanced",
     isPreview: false,
@@ -45166,6 +45166,51 @@ var HistoryManager = class _HistoryManager {
   }
 };
 
+// src/domains/descriptions.generated.ts
+var generatedDescriptions = {
+  version: "1.0.0",
+  generatedAt: "2025-12-30T03:58:36.781Z",
+  cli: {
+    "xcsh": {
+      short: "Navigate cloud services via interactive shell",
+      medium: "Manage multi-tenant connections, execute domain operations across 100+ services, and output results in JSON, YAML, or table format.",
+      long: "Interact with cloud services through an intelligent shell environment. Navigate over 100 domain operations using tab completion for commands, flags, and values. Organize multiple tenant connections with named profiles and switch contexts without re-authenticating. Execute commands directly from scripts or explore interactively with history and suggestions. Configure output format as JSON, YAML, or formatted tables. Set behavior through environment variables or persistent profile settings. Generate shell completions for bash, zsh, and fish terminals."
+    }
+  },
+  domains: {
+    "login": {
+      short: "Configure session credentials and environment profiles",
+      medium: "Set up authentication tokens, organize named profiles for multiple tenants, and switch between target environments for CLI operations.",
+      long: "Control authentication and session state across multiple environments. Run 'show' to display current connection details and token status. Organize credentials with 'profile' to maintain separate configurations for development, staging, and production tenants. Switch active targets via 'context' without re-authenticating. Run 'banner' for visual confirmation of the active environment. Profiles persist locally with token-based and certificate authentication support.",
+      subcommands: {
+        "profile": {
+          short: "Manage saved connection configurations for authentication",
+          medium: "Store and switch between multiple tenant connection settings. Create, list, and activate named configurations to avoid repeated credential entry.",
+          long: "Organize tenant connections as reusable named entries for rapid environment switching. Each entry persists URLs and authentication tokens, removing manual reconfiguration overhead. Available operations: 'list' enumerates saved entries, 'show' reveals configuration details, 'create' registers new connections, 'delete' purges obsolete ones, 'active' identifies the current selection, and 'use' changes context. Ideal for workflows spanning development, staging, and production tiers."
+        },
+        "context": {
+          short: "Manage default namespace for scoping operations",
+          medium: "Configure and display the active namespace used to scope commands. Set, view, or list available namespaces for your session.",
+          long: "Control which namespace subsequent operations target by default. Namespaces partition resources and configurations, ensuring commands affect only the intended area. Use 'show' to display the current selection, 'set' to switch contexts, and 'list' to enumerate accessible options. Once configured, the choice persists across commands until explicitly changed, eliminating repeated namespace flag usage."
+        }
+      }
+    },
+    "cloudstatus": {
+      short: "Check infrastructure health and active incidents",
+      medium: "Query service availability, component health, ongoing incidents, and scheduled maintenance windows across infrastructure regions.",
+      long: "Display real-time operational state for infrastructure components and services. Track ongoing incidents with severity levels and resolution timelines. View upcoming maintenance windows affecting particular regions or deployments. Filter results by component type, severity, time range, or operational condition. Retrieve incident history and outage notifications. Commands support monitoring degraded performance indicators and uptime metrics useful for operations teams."
+    },
+    "completion": {
+      short: "Generate tab-assist scripts for supported shells",
+      medium: "Create shell scripts enabling tab-triggered suggestions for commands, subcommands, flags, and option values in bash, zsh, and fish.",
+      long: "Output autocomplete functionality for your terminal environment. Bash, zsh, and fish are fully supported with context-aware prompts covering command names, nested subcommands, available flags, and valid argument values. Installation requires sourcing the generated content in your shell's configuration file (.bashrc, .zshrc, or config.fish). Execute the appropriate subcommand to produce the script, then follow shell-specific setup instructions to activate intelligent tab behavior."
+    }
+  }
+};
+function getCliDescriptions(cliName = "xcsh") {
+  return generatedDescriptions.cli?.[cliName];
+}
+
 // src/branding/terminal.ts
 function detectTerminalCapabilities() {
   const termProgram = process.env.TERM_PROGRAM ?? "";
@@ -45309,8 +45354,8 @@ function getLogoModeFromEnv(envPrefix) {
 var CLI_NAME = "xcsh";
 var CLI_FULL_NAME = "F5 Distributed Cloud Shell";
 function getVersion() {
-  if ("6.34.0") {
-    return "6.34.0";
+  if ("6.35.0") {
+    return "6.35.0";
   }
   if (process.env.XCSH_VERSION) {
     return process.env.XCSH_VERSION;
@@ -45318,6 +45363,10 @@ function getVersion() {
   return "dev";
 }
 var CLI_VERSION = getVersion();
+var cliDescs = getCliDescriptions();
+var CLI_DESCRIPTION_SHORT = cliDescs?.short ?? "Navigate cloud services via interactive shell";
+var CLI_DESCRIPTION_MEDIUM = cliDescs?.medium ?? CLI_DESCRIPTION_SHORT;
+var CLI_DESCRIPTION_LONG = cliDescs?.long ?? CLI_DESCRIPTION_MEDIUM;
 var CONFIG_FILE_NAME = ".xcshconfig";
 var ENV_PREFIX = "F5XC";
 var F5_LOGO = `                   ________
@@ -50725,13 +50774,31 @@ function formatAPIError(statusCode, body, operation) {
 }
 
 // src/repl/help.ts
+function wrapText3(text, width, indent) {
+  const prefix = " ".repeat(indent);
+  const words = text.split(/\s+/);
+  const lines = [];
+  let currentLine = prefix;
+  for (const word of words) {
+    if (currentLine.length + word.length + 1 > width && currentLine !== prefix) {
+      lines.push(currentLine);
+      currentLine = prefix + word;
+    } else {
+      currentLine += (currentLine === prefix ? "" : " ") + word;
+    }
+  }
+  if (currentLine.trim()) {
+    lines.push(currentLine);
+  }
+  return lines;
+}
 function formatRootHelp() {
   return [
     "",
     colorBoldWhite(`${CLI_NAME} - ${CLI_FULL_NAME} v${CLI_VERSION}`),
     "",
     "DESCRIPTION",
-    `  Interactive CLI for F5 Distributed Cloud services.`,
+    ...wrapText3(CLI_DESCRIPTION_LONG, 80, 2),
     "",
     "USAGE",
     `  ${CLI_NAME}                              Enter interactive REPL mode`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robinmordasiewicz/f5xc-xcsh",
-  "version": "6.34.0",
+  "version": "6.35.0",
   "description": "F5 Distributed Cloud Shell - Interactive CLI for F5 XC",
   "type": "module",
   "bin": {