@robinmordasiewicz/f5xc-xcsh 6.28.0 → 6.29.0

package/completions/_xcsh

@@ -67,7 +67,10 @@ _xcsh() {
             'users:User accounts, tokens, and label management'
             'virtual:Configure HTTP and TCP load balancers'
             'vpm_and_node_management:Vpm And Node Management API'
-            'waf:Configure web application firewall rules and policies'
+            'waf:Configure application firewall rules and bot protection'
+            'console-ui:Alias for admin_console_and_ui'
+            'ui-assets:Alias for admin_console_and_ui'
+            'static-components:Alias for admin_console_and_ui'
             'apisec:Alias for api'
             'api-discovery:Alias for api'
             'authn:Alias for authentication'
@@ -76,11 +79,20 @@ _xcsh() {
             'f5-bigip:Alias for bigip'
             'irule:Alias for bigip'
             'ltm:Alias for bigip'
+            'billing-usage:Alias for billing_and_usage'
+            'quotas:Alias for billing_and_usage'
+            'usage-tracking:Alias for billing_and_usage'
             'bf:Alias for blindfold'
             'encrypt:Alias for blindfold'
             'secrets:Alias for blindfold'
+            'threat-defense:Alias for bot_and_threat_defense'
+            'tpm:Alias for bot_and_threat_defense'
+            'shape-bot:Alias for bot_and_threat_defense'
             'cache:Alias for cdn'
             'content:Alias for cdn'
+            'ce-mgmt:Alias for ce_management'
+            'edge-management:Alias for ce_management'
+            'ce-lifecycle:Alias for ce_management'
             'cert:Alias for certificates'
             'certs:Alias for certificates'
             'ssl:Alias for certificates'
@@ -91,6 +103,10 @@ _xcsh() {
             'vk8s:Alias for container_services'
             'containers:Alias for container_services'
             'workloads:Alias for container_services'
+            'data-privacy:Alias for data_and_privacy_security'
+            'pii:Alias for data_and_privacy_security'
+            'sensitive-data:Alias for data_and_privacy_security'
+            'lma:Alias for data_and_privacy_security'
             'di:Alias for data_intelligence'
             'intelligence:Alias for data_intelligence'
             'insights:Alias for data_intelligence'
@@ -124,6 +140,9 @@ _xcsh() {
             'ratelimit:Alias for rate_limiting'
             'throttle:Alias for rate_limiting'
             'policer:Alias for rate_limiting'
+            'secops:Alias for secops_and_incident_response'
+            'incident-response:Alias for secops_and_incident_response'
+            'mitigation:Alias for secops_and_incident_response'
             'mesh:Alias for service_mesh'
             'svc-mesh:Alias for service_mesh'
             'shape-sec:Alias for shape'
@@ -137,6 +156,9 @@ _xcsh() {
             'help-desk:Alias for support'
             'telemetry:Alias for telemetry_and_insights'
             'ti:Alias for telemetry_and_insights'
+            'tenant-identity:Alias for tenant_and_identity'
+            'idm:Alias for tenant_and_identity'
+            'user-settings:Alias for tenant_and_identity'
             'threats:Alias for threat_campaign'
             'campaigns:Alias for threat_campaign'
             'threat-intel:Alias for threat_campaign'

package/completions/xcsh.bash

@@ -6,7 +6,7 @@ _xcsh_completions() {
   local cur prev words cword
   _init_completion || return
 
-  local commands="admin_console_and_ui api authentication bigip billing_and_usage blindfold bot_and_threat_defense cdn ce_management certificates cloud_infrastructure cloudstatus completion container_services data_and_privacy_security data_intelligence ddos dns generative_ai login managed_kubernetes marketplace network network_security nginx_one object_storage observability rate_limiting secops_and_incident_response service_mesh shape sites statistics subscription support telemetry_and_insights tenant_and_identity threat_campaign users virtual vpm_and_node_management waf apisec api-discovery authn oidc sso f5-bigip irule ltm bf encrypt secrets cache content cert certs ssl tls cloud infra provider vk8s containers workloads di intelligence insights dos ddos-protect dns-zone zones ai genai assistant mk8s appstack k8s-mgmt market addons extensions net routing bgp netsec nfw nginx nms nginx-plus storage s3 buckets obs monitoring synth ratelimit throttle policer mesh svc-mesh shape-sec safeap site deployment stats metrics logs tickets help-desk telemetry ti threats campaigns threat-intel user accounts iam lb loadbalancer vhost vpm nodes node-mgmt firewall appfw help quit exit clear history"
+  local commands="admin_console_and_ui api authentication bigip billing_and_usage blindfold bot_and_threat_defense cdn ce_management certificates cloud_infrastructure cloudstatus completion container_services data_and_privacy_security data_intelligence ddos dns generative_ai login managed_kubernetes marketplace network network_security nginx_one object_storage observability rate_limiting secops_and_incident_response service_mesh shape sites statistics subscription support telemetry_and_insights tenant_and_identity threat_campaign users virtual vpm_and_node_management waf console-ui ui-assets static-components apisec api-discovery authn oidc sso f5-bigip irule ltm billing-usage quotas usage-tracking bf encrypt secrets threat-defense tpm shape-bot cache content ce-mgmt edge-management ce-lifecycle cert certs ssl tls cloud infra provider vk8s containers workloads data-privacy pii sensitive-data lma di intelligence insights dos ddos-protect dns-zone zones ai genai assistant mk8s appstack k8s-mgmt market addons extensions net routing bgp netsec nfw nginx nms nginx-plus storage s3 buckets obs monitoring synth ratelimit throttle policer secops incident-response mitigation mesh svc-mesh shape-sec safeap site deployment stats metrics logs tickets help-desk telemetry ti tenant-identity idm user-settings threats campaigns threat-intel user accounts iam lb loadbalancer vhost vpm nodes node-mgmt firewall appfw help quit exit clear history"
   local actions="list get create delete replace apply status patch add-labels remove-labels"
   local builtins="help quit exit clear history context ctx"
   local global_flags="--help -h --version -v --interactive -i --no-color --output -o --namespace -ns"

package/completions/xcsh.fish

@@ -63,9 +63,12 @@ complete -c xcsh -n "__fish_use_subcommand" -a "threat_campaign" -d 'Threat Camp
 complete -c xcsh -n "__fish_use_subcommand" -a "users" -d 'User accounts, tokens, and label management'
 complete -c xcsh -n "__fish_use_subcommand" -a "virtual" -d 'Configure HTTP and TCP load balancers'
 complete -c xcsh -n "__fish_use_subcommand" -a "vpm_and_node_management" -d 'Vpm And Node Management API'
-complete -c xcsh -n "__fish_use_subcommand" -a "waf" -d 'Configure web application firewall rules and policies'
+complete -c xcsh -n "__fish_use_subcommand" -a "waf" -d 'Configure application firewall rules and bot protection'
 
 # Alias completions
+complete -c xcsh -n "__fish_use_subcommand" -a "console-ui" -d 'Alias for admin_console_and_ui'
+complete -c xcsh -n "__fish_use_subcommand" -a "ui-assets" -d 'Alias for admin_console_and_ui'
+complete -c xcsh -n "__fish_use_subcommand" -a "static-components" -d 'Alias for admin_console_and_ui'
 complete -c xcsh -n "__fish_use_subcommand" -a "apisec" -d 'Alias for api'
 complete -c xcsh -n "__fish_use_subcommand" -a "api-discovery" -d 'Alias for api'
 complete -c xcsh -n "__fish_use_subcommand" -a "authn" -d 'Alias for authentication'
@@ -74,11 +77,20 @@ complete -c xcsh -n "__fish_use_subcommand" -a "sso" -d 'Alias for authenticatio
 complete -c xcsh -n "__fish_use_subcommand" -a "f5-bigip" -d 'Alias for bigip'
 complete -c xcsh -n "__fish_use_subcommand" -a "irule" -d 'Alias for bigip'
 complete -c xcsh -n "__fish_use_subcommand" -a "ltm" -d 'Alias for bigip'
+complete -c xcsh -n "__fish_use_subcommand" -a "billing-usage" -d 'Alias for billing_and_usage'
+complete -c xcsh -n "__fish_use_subcommand" -a "quotas" -d 'Alias for billing_and_usage'
+complete -c xcsh -n "__fish_use_subcommand" -a "usage-tracking" -d 'Alias for billing_and_usage'
 complete -c xcsh -n "__fish_use_subcommand" -a "bf" -d 'Alias for blindfold'
 complete -c xcsh -n "__fish_use_subcommand" -a "encrypt" -d 'Alias for blindfold'
 complete -c xcsh -n "__fish_use_subcommand" -a "secrets" -d 'Alias for blindfold'
+complete -c xcsh -n "__fish_use_subcommand" -a "threat-defense" -d 'Alias for bot_and_threat_defense'
+complete -c xcsh -n "__fish_use_subcommand" -a "tpm" -d 'Alias for bot_and_threat_defense'
+complete -c xcsh -n "__fish_use_subcommand" -a "shape-bot" -d 'Alias for bot_and_threat_defense'
 complete -c xcsh -n "__fish_use_subcommand" -a "cache" -d 'Alias for cdn'
 complete -c xcsh -n "__fish_use_subcommand" -a "content" -d 'Alias for cdn'
+complete -c xcsh -n "__fish_use_subcommand" -a "ce-mgmt" -d 'Alias for ce_management'
+complete -c xcsh -n "__fish_use_subcommand" -a "edge-management" -d 'Alias for ce_management'
+complete -c xcsh -n "__fish_use_subcommand" -a "ce-lifecycle" -d 'Alias for ce_management'
 complete -c xcsh -n "__fish_use_subcommand" -a "cert" -d 'Alias for certificates'
 complete -c xcsh -n "__fish_use_subcommand" -a "certs" -d 'Alias for certificates'
 complete -c xcsh -n "__fish_use_subcommand" -a "ssl" -d 'Alias for certificates'
@@ -89,6 +101,10 @@ complete -c xcsh -n "__fish_use_subcommand" -a "provider" -d 'Alias for cloud_in
 complete -c xcsh -n "__fish_use_subcommand" -a "vk8s" -d 'Alias for container_services'
 complete -c xcsh -n "__fish_use_subcommand" -a "containers" -d 'Alias for container_services'
 complete -c xcsh -n "__fish_use_subcommand" -a "workloads" -d 'Alias for container_services'
+complete -c xcsh -n "__fish_use_subcommand" -a "data-privacy" -d 'Alias for data_and_privacy_security'
+complete -c xcsh -n "__fish_use_subcommand" -a "pii" -d 'Alias for data_and_privacy_security'
+complete -c xcsh -n "__fish_use_subcommand" -a "sensitive-data" -d 'Alias for data_and_privacy_security'
+complete -c xcsh -n "__fish_use_subcommand" -a "lma" -d 'Alias for data_and_privacy_security'
 complete -c xcsh -n "__fish_use_subcommand" -a "di" -d 'Alias for data_intelligence'
 complete -c xcsh -n "__fish_use_subcommand" -a "intelligence" -d 'Alias for data_intelligence'
 complete -c xcsh -n "__fish_use_subcommand" -a "insights" -d 'Alias for data_intelligence'
@@ -122,6 +138,9 @@ complete -c xcsh -n "__fish_use_subcommand" -a "synth" -d 'Alias for observabili
 complete -c xcsh -n "__fish_use_subcommand" -a "ratelimit" -d 'Alias for rate_limiting'
 complete -c xcsh -n "__fish_use_subcommand" -a "throttle" -d 'Alias for rate_limiting'
 complete -c xcsh -n "__fish_use_subcommand" -a "policer" -d 'Alias for rate_limiting'
+complete -c xcsh -n "__fish_use_subcommand" -a "secops" -d 'Alias for secops_and_incident_response'
+complete -c xcsh -n "__fish_use_subcommand" -a "incident-response" -d 'Alias for secops_and_incident_response'
+complete -c xcsh -n "__fish_use_subcommand" -a "mitigation" -d 'Alias for secops_and_incident_response'
 complete -c xcsh -n "__fish_use_subcommand" -a "mesh" -d 'Alias for service_mesh'
 complete -c xcsh -n "__fish_use_subcommand" -a "svc-mesh" -d 'Alias for service_mesh'
 complete -c xcsh -n "__fish_use_subcommand" -a "shape-sec" -d 'Alias for shape'
@@ -135,6 +154,9 @@ complete -c xcsh -n "__fish_use_subcommand" -a "tickets" -d 'Alias for support'
 complete -c xcsh -n "__fish_use_subcommand" -a "help-desk" -d 'Alias for support'
 complete -c xcsh -n "__fish_use_subcommand" -a "telemetry" -d 'Alias for telemetry_and_insights'
 complete -c xcsh -n "__fish_use_subcommand" -a "ti" -d 'Alias for telemetry_and_insights'
+complete -c xcsh -n "__fish_use_subcommand" -a "tenant-identity" -d 'Alias for tenant_and_identity'
+complete -c xcsh -n "__fish_use_subcommand" -a "idm" -d 'Alias for tenant_and_identity'
+complete -c xcsh -n "__fish_use_subcommand" -a "user-settings" -d 'Alias for tenant_and_identity'
 complete -c xcsh -n "__fish_use_subcommand" -a "threats" -d 'Alias for threat_campaign'
 complete -c xcsh -n "__fish_use_subcommand" -a "campaigns" -d 'Alias for threat_campaign'
 complete -c xcsh -n "__fish_use_subcommand" -a "threat-intel" -d 'Alias for threat_campaign'

package/dist/index.js

@@ -44111,13 +44111,13 @@ var generatedDomains = /* @__PURE__ */ new Map([
     description: "Provides management capabilities for static components used in the F5 XC admin console and user interface. Enables operations to deploy, retrieve, update, and list static UI assets within namespace boundaries. Supports configuration of console interface elements, component metadata management, and asset lifecycle operations. Use this domain to manage custom UI components, static resources, and interface configurations that extend or customize the admin console experience.",
     descriptionShort: "Static UI component and console asset management",
     descriptionMedium: "Manage static components for the admin console interface. Deploy, retrieve, and list UI assets and configuration elements within namespaces.",
-    aliases: [],
+    aliases: ["console-ui", "ui-assets", "static-components"],
     complexity: "simple",
     isPreview: false,
     requiresTier: "Standard",
-    category: "Other",
-    useCases: [],
-    relatedDomains: []
+    category: "Platform",
+    useCases: ["Manage static UI components for admin console", "Deploy and retrieve UI assets within namespaces", "Configure console interface elements", "Manage custom UI component metadata"],
+    relatedDomains: ["admin", "system"]
   }],
   ["api", {
     name: "api",
@@ -44217,13 +44217,13 @@ var generatedDomains = /* @__PURE__ */ new Map([
     description: "Comprehensive billing and usage management for F5 XC tenants. Handle subscription plan transitions between tiers, configure primary and secondary payment methods, and download invoice PDFs. Monitor resource quota limits and current usage across namespaces. Supports custom invoice listing, quota configuration per namespace, and contact management for billing communications. Essential for financial operations, capacity planning, and subscription lifecycle management.",
     descriptionShort: "Subscription billing, payment methods, and usage tracking",
     descriptionMedium: "Manage subscription plans, payment methods, invoices, and resource quotas. Track usage limits and billing transitions across namespaces.",
-    aliases: [],
+    aliases: ["billing-usage", "quotas", "usage-tracking"],
     complexity: "moderate",
     isPreview: false,
     requiresTier: "Standard",
-    category: "Other",
-    useCases: [],
-    relatedDomains: []
+    category: "Platform",
+    useCases: ["Manage subscription plans and billing transitions", "Configure payment methods and invoices", "Track resource quota usage across namespaces", "Monitor usage limits and capacity"],
+    relatedDomains: ["system", "users"]
   }],
   ["blindfold", {
     name: "blindfold",
@@ -44245,20 +44245,20 @@ var generatedDomains = /* @__PURE__ */ new Map([
     description: "Manage comprehensive bot and threat defense capabilities including Shape bot defense instance configuration, threat protection manager (TPM) categories for threat classification, and API key provisioning for automated defense systems. Create and manage TPM categories to organize threats by type, configure bot defense instances per namespace, and handle TPM manager lifecycle operations. Supports preauthorization and provisioning workflows for integrating threat intelligence services with...",
     descriptionShort: "Bot detection, threat categorization, and defense management",
     descriptionMedium: "Configure bot defense instances, manage threat categories, and provision TPM API keys for automated threat detection and mitigation.",
-    aliases: [],
+    aliases: ["threat-defense", "tpm", "shape-bot"],
     complexity: "moderate",
     isPreview: false,
-    requiresTier: "Standard",
-    category: "Other",
-    useCases: [],
-    relatedDomains: []
+    requiresTier: "Advanced",
+    category: "Security",
+    useCases: ["Configure bot defense instances per namespace", "Manage TPM threat categories for classification", "Provision API keys for automated defense systems", "Integrate threat intelligence services"],
+    relatedDomains: ["bot_defense", "shape", "waf"]
   }],
   ["cdn", {
     name: "cdn",
     displayName: "Cdn",
-    description: "Create cache rules with expression-based matching for paths, headers, cookies, and query parameters. Deploy load balancers optimized for content distribution with configurable TTL settings and cache eligibility options. Monitor access logs and metrics for delivery performance. Purge cached content on demand and track service operation status across namespaces.",
+    description: "Create cache rules using path matchers, cookie matching, header conditions, and query parameter filters. Configure TTL settings and cache eligibility options for fine-grained control over cached content. Deploy load balancers with access logging, metrics collection, and cache purge capabilities. Manage subscription services and monitor service operation status for active deployments.",
     descriptionShort: "Configure content delivery and caching rules",
-    descriptionMedium: "Define cache rules and load balancers for content distribution. Set TTL policies, path matching, and header-based caching decisions.",
+    descriptionMedium: "Set up cache rules with path matching and TTL controls. Define load balancers for optimized content distribution across edge locations.",
     aliases: ["cache", "content"],
     complexity: "advanced",
     isPreview: false,
@@ -44273,13 +44273,13 @@ var generatedDomains = /* @__PURE__ */ new Map([
     description: "Configure and manage Customer Edge (CE) site infrastructure across distributed deployments. Define network interfaces with DHCP, IPv6, and dedicated management settings. Organize sites into fleets for coordinated management. Handle site registration workflows including token-based registration, image downloads, and suggested configuration values. Monitor and execute site upgrades with pre-upgrade checks and status tracking. Supports both dedicated and Ethernet interface types with...",
     descriptionShort: "Customer Edge site lifecycle and network configuration",
     descriptionMedium: "Manage Customer Edge sites including network interfaces, fleet configurations, site upgrades, and registration workflows for distributed deployments.",
-    aliases: [],
+    aliases: ["ce-mgmt", "edge-management", "ce-lifecycle"],
     complexity: "advanced",
     isPreview: false,
     requiresTier: "Standard",
-    category: "Other",
-    useCases: [],
-    relatedDomains: []
+    category: "Infrastructure",
+    useCases: ["Manage Customer Edge site lifecycle", "Configure network interfaces and fleet settings", "Handle site registration and token workflows", "Execute site upgrades with pre-upgrade checks"],
+    relatedDomains: ["customer_edge", "sites"]
   }],
   ["certificates", {
     name: "certificates",
@@ -44329,13 +44329,13 @@ var generatedDomains = /* @__PURE__ */ new Map([
     description: "Manage comprehensive data privacy and security controls including sensitive data detection policies, custom data type definitions, and log management analytics (LMA) region configurations. Define patterns for identifying PII, financial data, and other sensitive information with configurable actions for masking, alerting, or blocking. Configure LMA regions with Elasticsearch, Kafka, or ClickHouse backends for centralized security logging and compliance auditing. Integrate geo-configurations...",
     descriptionShort: "Sensitive data detection, classification, and privacy...",
     descriptionMedium: "Configure data types, sensitive data policies, and LMA regions for detecting, classifying, and protecting personally identifiable information and...",
-    aliases: [],
+    aliases: ["data-privacy", "pii", "sensitive-data", "lma"],
     complexity: "simple",
     isPreview: false,
-    requiresTier: "Standard",
-    category: "Other",
-    useCases: [],
-    relatedDomains: []
+    requiresTier: "Advanced",
+    category: "Security",
+    useCases: ["Configure sensitive data detection policies", "Define custom data types for PII classification", "Manage LMA region configurations", "Integrate geo-configurations for compliance"],
+    relatedDomains: ["blindfold", "client_side_defense"]
   }],
   ["data_intelligence", {
     name: "data_intelligence",
@@ -44561,13 +44561,13 @@ var generatedDomains = /* @__PURE__ */ new Map([
     description: "Security operations and incident response capabilities for detecting and mitigating malicious user activity. Create mitigation policies that define automated responses based on user threat levels, including blocking, challenging, or rate limiting suspicious users. Configure rules that match specific malicious user types and threat severity levels to appropriate mitigation actions. Supports namespace-scoped configurations for managing security policies across different application...",
     descriptionShort: "Malicious user detection and automated threat mitigation",
     descriptionMedium: "Configure automated responses to malicious user behavior. Define mitigation rules based on threat levels and apply actions like blocking or rate...",
-    aliases: [],
+    aliases: ["secops", "incident-response", "mitigation"],
     complexity: "simple",
     isPreview: false,
-    requiresTier: "Standard",
-    category: "Other",
-    useCases: [],
-    relatedDomains: []
+    requiresTier: "Advanced",
+    category: "Security",
+    useCases: ["Configure automated threat mitigation policies", "Define rules for malicious user detection", "Manage incident response workflows", "Apply blocking or rate limiting to threats"],
+    relatedDomains: ["bot_defense", "waf", "network_security"]
   }],
   ["service_mesh", {
     name: "service_mesh",
@@ -44711,13 +44711,13 @@ var generatedDomains = /* @__PURE__ */ new Map([
     description: "Comprehensive user and tenant identity management for F5 Distributed Cloud. Configure user settings including profile images, notification preferences (admin and combined), and view preferences. Manage user sessions with listing and control capabilities. Handle OTP (one-time password) administration including admin resets. Support identity management (IDM) enable/disable operations. Process initial access requests for new users. Manage customer support ticket attachments and interactions for...",
     descriptionShort: "User settings, notifications, sessions, and identity...",
     descriptionMedium: "Manage user profiles, notification preferences, session controls, OTP settings, and customer support interactions. Configure identity management...",
-    aliases: [],
+    aliases: ["tenant-identity", "idm", "user-settings"],
     complexity: "advanced",
     isPreview: false,
     requiresTier: "Standard",
-    category: "Other",
-    useCases: [],
-    relatedDomains: []
+    category: "Platform",
+    useCases: ["Manage user profiles and notification preferences", "Configure session controls and OTP settings", "Handle identity management operations", "Process initial user access requests"],
+    relatedDomains: ["users", "authentication", "system"]
   }],
   ["threat_campaign", {
     name: "threat_campaign",
@@ -44830,9 +44830,9 @@ var generatedDomains = /* @__PURE__ */ new Map([
   ["waf", {
     name: "waf",
     displayName: "Waf",
-    description: "Deploy protection against common web attacks including injection, cross-site scripting, and protocol violations. Set up bot detection with configurable actions for automated traffic handling. Create exclusion policies to whitelist trusted requests and reduce false positives. Monitor security events and rule hits through metrics collection to analyze threat patterns and refine defensive configurations for virtual hosts.",
-    descriptionShort: "Configure web application firewall rules and policies",
-    descriptionMedium: "Manage application security through attack detection and blocking settings. Define custom response codes and signature-based threat mitigation.",
+    description: "Set up firewall configurations with attack type settings and violation detection. Create exclusion policies to tune false positives and customize blocking responses. Deploy staged signatures before production release and monitor rule hits through security event metrics. Integrate with virtual hosts for layered protection using AI-based risk blocking and anonymization settings for sensitive data handling.",
+    descriptionShort: "Configure application firewall rules and bot protection",
+    descriptionMedium: "Define security policies for web applications. Manage attack signatures, exclusion rules, and threat detection settings.",
     aliases: ["firewall", "appfw"],
     complexity: "advanced",
     isPreview: false,
@@ -45309,8 +45309,8 @@ function getLogoModeFromEnv(envPrefix) {
 var CLI_NAME = "xcsh";
 var CLI_FULL_NAME = "F5 Distributed Cloud Shell";
 function getVersion() {
-  if ("6.28.0") {
-    return "6.28.0";
+  if ("6.29.0") {
+    return "6.29.0";
   }
   if (process.env.XCSH_VERSION) {
     return process.env.XCSH_VERSION;
@@ -47366,6 +47366,9 @@ var DomainRegistry = class {
     const subgroup = domain.subcommands.get(firstArg);
     if (subgroup) {
       if (restArgs.length === 0) {
+        if (subgroup.defaultCommand) {
+          return subgroup.defaultCommand.execute([], session);
+        }
         return this.showSubcommandHelp(domain, subgroup);
       }
       const cmdName = restArgs[0]?.toLowerCase() ?? "";
@@ -47429,7 +47432,7 @@ var DomainRegistry = class {
         if (name.toLowerCase().startsWith(partial.toLowerCase())) {
           suggestions.push({
             text: name,
-            description: group.description,
+            description: group.descriptionShort,
             category: "subcommand"
           });
         }
@@ -47438,7 +47441,7 @@ var DomainRegistry = class {
         if (name.toLowerCase().startsWith(partial.toLowerCase())) {
           suggestions.push({
             text: name,
-            description: cmd.description,
+            description: cmd.descriptionShort,
             category: "command"
           });
         }
@@ -47452,7 +47455,7 @@ var DomainRegistry = class {
         if (name.toLowerCase().startsWith(partial.toLowerCase())) {
           suggestions.push({
             text: name,
-            description: cmd.description,
+            description: cmd.descriptionShort,
             category: "command"
           });
         }
@@ -47555,7 +47558,9 @@ function rawStdoutResult(content) {
 // src/domains/login/profile/list.ts
 var listCommand = {
   name: "list",
-  description: "List all saved profiles",
+  description: "Display all saved connection profiles with their tenant URLs and authentication types. Highlights the currently active profile for easy identification when managing multiple tenants.",
+  descriptionShort: "List all saved profiles",
+  descriptionMedium: "Show all profiles with tenant URLs, auth types, and active status indicator.",
   aliases: ["ls"],
   async execute(_args, _session) {
     const manager = getProfileManager();
@@ -47590,7 +47595,9 @@ var listCommand = {
 // src/domains/login/profile/show.ts
 var showCommand = {
   name: "show",
-  description: "Show profile details (sensitive data masked)",
+  description: "Display detailed configuration for a specific profile. Shows tenant URL, authentication method, and namespace settings with sensitive credentials securely masked for safe viewing.",
+  descriptionShort: "Show profile details (masked credentials)",
+  descriptionMedium: "Display profile configuration with tenant URL, auth type, and masked credentials.",
   usage: "<name>",
   aliases: ["get", "view"],
   async execute(args, _session) {
@@ -47646,7 +47653,9 @@ var showCommand = {
 // src/domains/login/profile/create.ts
 var createCommand2 = {
   name: "create",
-  description: "Create a new profile",
+  description: "Create a new connection profile with tenant URL and authentication credentials. Profiles store all settings needed to connect to a tenant, including optional default namespace for scoped operations.",
+  descriptionShort: "Create a new connection profile",
+  descriptionMedium: "Create a profile with tenant URL, authentication token, and optional default namespace.",
   usage: "<name> --url <api-url> --token <api-token> [--namespace <ns>]",
   aliases: ["add", "new"],
   async execute(args, _session) {
@@ -47719,7 +47728,9 @@ var createCommand2 = {
 // src/domains/login/profile/use.ts
 var useCommand = {
   name: "use",
-  description: "Switch to a different profile",
+  description: "Switch the active connection to a different saved profile. Updates the session context to use the new profile's tenant URL, credentials, and default namespace for all subsequent operations.",
+  descriptionShort: "Switch to a different profile",
+  descriptionMedium: "Activate a profile and update session context with its tenant and namespace settings.",
   usage: "<name>",
   aliases: ["switch", "activate"],
   async execute(args, session) {
@@ -47766,7 +47777,9 @@ var useCommand = {
 // src/domains/login/profile/delete.ts
 var deleteCommand = {
   name: "delete",
-  description: "Delete a saved profile",
+  description: "Delete a saved connection profile permanently. Requires --force flag to delete the currently active profile to prevent accidental disconnection from active tenant.",
+  descriptionShort: "Delete a saved profile",
+  descriptionMedium: "Remove a saved profile permanently. Use --force to delete active profile.",
   usage: "<name> [--force]",
   aliases: ["rm", "remove"],
   async execute(args, _session) {
@@ -47815,10 +47828,66 @@ var deleteCommand = {
   }
 };
 
+// src/domains/login/profile/active.ts
+var activeCommand = {
+  name: "active",
+  description: "Display the currently active profile configuration including tenant URL, authentication method, and default namespace. Shows masked credentials for security while confirming connection settings.",
+  descriptionShort: "Display active profile configuration",
+  descriptionMedium: "Show current active profile details including tenant URL, auth type, and namespace settings.",
+  async execute(_args, _session) {
+    const manager = getProfileManager();
+    try {
+      const activeName = await manager.getActive();
+      if (!activeName) {
+        return successResult([
+          "No active profile set.",
+          "",
+          "Run 'login profile list' to see available profiles.",
+          "Run 'login profile use <name>' to activate a profile."
+        ]);
+      }
+      const profile = await manager.get(activeName);
+      if (!profile) {
+        return errorResult(
+          `Active profile '${activeName}' not found. Run 'login profile list' to see available profiles.`
+        );
+      }
+      const masked = manager.maskProfile(profile);
+      const output = [
+        `Active Profile: ${profile.name}`,
+        ``,
+        `  API URL:    ${masked.apiUrl}`
+      ];
+      if (masked.apiToken) {
+        output.push(`  API Token:  ${masked.apiToken}`);
+      }
+      if (masked.p12Bundle) {
+        output.push(`  P12 Bundle: ${masked.p12Bundle}`);
+      }
+      if (masked.cert) {
+        output.push(`  Certificate: ${masked.cert}`);
+      }
+      if (masked.key) {
+        output.push(`  Private Key: ${masked.key}`);
+      }
+      if (masked.defaultNamespace) {
+        output.push(`  Namespace:  ${masked.defaultNamespace}`);
+      }
+      return successResult(output);
+    } catch (error) {
+      return errorResult(
+        `Failed to get active profile: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+};
+
 // src/domains/login/context/index.ts
 var showCommand2 = {
   name: "show",
-  description: "Show current default namespace context",
+  description: "Display the currently active namespace context used for scoping operations. Shows both the namespace value and its source (environment variable, profile default, or session configuration).",
+  descriptionShort: "Show current default namespace",
+  descriptionMedium: "Display active namespace context and its configuration source.",
   usage: "",
   aliases: ["current", "get"],
   async execute(_args, session) {
@@ -47843,7 +47912,9 @@ function determineNamespaceSource(namespace) {
 }
 var setCommand = {
   name: "set",
-  description: "Set default namespace context for API operations",
+  description: "Change the default namespace context for all subsequent operations. Updates the session scope so operations target the specified namespace unless explicitly overridden.",
+  descriptionShort: "Set default namespace context",
+  descriptionMedium: "Switch namespace context for scoped operations without specifying namespace each time.",
   usage: "<namespace>",
   aliases: ["use", "switch"],
   async execute(args, session) {
@@ -47887,7 +47958,9 @@ var setCommand = {
 };
 var listCommand2 = {
   name: "list",
-  description: "List available namespaces",
+  description: "Fetch and display all available namespaces from the tenant. Requires authenticated connection. Shows current namespace indicator and provides switch command guidance.",
+  descriptionShort: "List available namespaces",
+  descriptionMedium: "Query tenant for available namespaces with current context indicator.",
   usage: "",
   aliases: ["ls"],
   async execute(_args, session) {
@@ -47928,7 +48001,9 @@ var listCommand2 = {
 };
 var contextSubcommands = {
   name: "context",
-  description: "Manage default namespace context for API operations",
+  description: "Manage default namespace context for scoping operations. Set, display, and list namespaces to control which namespace is used when no explicit namespace is specified in commands.",
+  descriptionShort: "Manage default namespace context",
+  descriptionMedium: "Set, display, and list namespaces for scoping operations without explicit namespace flags.",
   commands: /* @__PURE__ */ new Map([
     ["show", showCommand2],
     ["set", setCommand],
@@ -48338,7 +48413,9 @@ function parseLogoArg(args) {
 }
 var bannerCommand = {
   name: "banner",
-  description: "Display the xcsh banner with optional logo mode",
+  description: "Render the xcsh startup banner with customizable logo display. Supports multiple render modes including image, ASCII, Unicode, and sixel graphics based on terminal capabilities.",
+  descriptionShort: "Display xcsh banner with logo",
+  descriptionMedium: "Show startup banner with configurable logo mode (image, ASCII, sixel) based on terminal.",
   usage: "[--logo <mode>]",
   async execute(args, _session) {
     if (args.includes("--help") || args.includes("-h")) {
@@ -48638,7 +48715,9 @@ function formatWhoamiBox(info, options) {
 // src/domains/login/whoami/index.ts
 var whoamiCommand = {
   name: "show",
-  description: "Show connection and identity information",
+  description: "Display current connection status and authenticated identity information. Shows active profile, tenant URL, username, tenant details, and session context including namespace targeting.",
+  descriptionShort: "Show connection and identity info",
+  descriptionMedium: "Display active profile, tenant URL, user identity, and current namespace context.",
   async execute(_args, session) {
     try {
       const info = await getWhoamiInfo(session);
@@ -48655,14 +48734,17 @@ var whoamiCommand = {
 // src/domains/login/index.ts
 var profileSubcommands = {
   name: "profile",
-  description: "Manage saved connection profiles",
+  description: "Manage saved connection profiles for tenant authentication. Create, list, activate, and delete profiles that store tenant URL, credentials, and default namespace settings for seamless tenant switching.",
+  descriptionShort: "Manage saved connection profiles",
+  descriptionMedium: "Create, list, switch, and delete saved authentication profiles for multi-tenant management.",
   commands: /* @__PURE__ */ new Map([
     ["list", listCommand],
     ["show", showCommand],
     ["create", createCommand2],
     ["use", useCommand],
     ["delete", deleteCommand]
-  ])
+  ]),
+  defaultCommand: activeCommand
 };
 var loginDomain = {
   name: "login",
@@ -49022,7 +49104,9 @@ function getClient() {
 }
 var statusCommand = {
   name: "status",
-  description: "Get overall F5 Cloud status indicator",
+  description: "Retrieve the current overall health indicator for F5 Distributed Cloud services. Returns status level (operational, degraded, major outage) with description. Use --quiet for script-friendly exit code output.",
+  descriptionShort: "Get overall cloud status indicator",
+  descriptionMedium: "Check overall service health status. Use --quiet for exit code suitable for scripts.",
   usage: "[--quiet]",
   aliases: ["st"],
   async execute(args, session) {
@@ -49071,7 +49155,9 @@ var statusCommand = {
 };
 var summaryCommand = {
   name: "summary",
-  description: "Get complete status summary including components and incidents",
+  description: "Display comprehensive status overview combining overall health, component statuses, active incidents, and scheduled maintenance in a single report. Use --brief for condensed statistics output.",
+  descriptionShort: "Get complete status summary",
+  descriptionMedium: "Show combined overview of health, components, incidents, and maintenance windows.",
   usage: "[--brief]",
   aliases: ["sum"],
   async execute(args, session) {
@@ -49098,7 +49184,9 @@ var summaryCommand = {
 };
 var componentsCommand = {
   name: "components",
-  description: "List all components and their status",
+  description: "List all service components with their current operational status. Shows each component's health level. Use --degraded-only to filter for components experiencing issues.",
+  descriptionShort: "List all components and status",
+  descriptionMedium: "Display service component health. Use --degraded-only to show only affected components.",
   usage: "[--degraded-only]",
   aliases: ["comp"],
   async execute(args, session) {
@@ -49139,7 +49227,9 @@ var componentsCommand = {
 };
 var incidentsCommand = {
   name: "incidents",
-  description: "List active and recent incidents",
+  description: "Track service incidents with their impact levels, status, and latest updates. Shows both active and recently resolved incidents. Use --active-only to filter for ongoing issues requiring attention.",
+  descriptionShort: "List active and recent incidents",
+  descriptionMedium: "Display incidents with impact levels and updates. Use --active-only for ongoing issues.",
   usage: "[--active-only]",
   aliases: ["inc"],
   async execute(args, session) {
@@ -49178,7 +49268,9 @@ var incidentsCommand = {
 };
 var maintenanceCommand = {
   name: "maintenance",
-  description: "List scheduled and active maintenance windows",
+  description: "View scheduled and in-progress maintenance windows with their timing and affected services. Plan around downtime windows. Use --upcoming to filter for future maintenance only.",
+  descriptionShort: "List scheduled maintenance windows",
+  descriptionMedium: "Show maintenance schedules and timing. Use --upcoming for future windows only.",
   usage: "[--upcoming]",
   aliases: ["maint"],
   async execute(args, session) {
@@ -49605,7 +49697,9 @@ function getClient2(apiClient) {
 }
 var overviewCommand = {
   name: "overview",
-  description: "Display subscription tier, active addons, and quota summary",
+  description: "Display a comprehensive overview of your tenant subscription including current tier level, activated addon services, and quota usage summary. Provides at-a-glance subscription health assessment.",
+  descriptionShort: "Display subscription tier and summary",
+  descriptionMedium: "Show subscription tier, active addons, and quota usage summary for tenant health assessment.",
   usage: "[--json]",
   aliases: ["show", "info"],
   async execute(args, session) {
@@ -49660,7 +49754,9 @@ var overviewCommand = {
 };
 var addonsCommand = {
   name: "addons",
-  description: "List addon services and their subscription status",
+  description: "List all addon services with their activation state and access status. Filter by active, available, or denied status. Shows tier requirements and enables identification of upgradable features.",
+  descriptionShort: "List addon services and status",
+  descriptionMedium: "Display addon services with activation state. Filter by active, available, or denied status.",
   usage: "[--filter active|available|denied] [--all] [--json]",
   aliases: ["services"],
   async execute(args, session) {
@@ -49757,7 +49853,9 @@ var addonsCommand = {
 };
 var quotaCommand = {
   name: "quota",
-  description: "Display tenant-level quota limits and usage",
+  description: "Display tenant-level quota limits and current usage for all resource types. Identify resources approaching limits with warning thresholds. Use --warnings to filter for at-risk quotas only.",
+  descriptionShort: "Display quota limits and usage",
+  descriptionMedium: "Show tenant-level quota limits with usage percentages. Filter for at-risk resources.",
   usage: "[--warnings] [--json]",
   aliases: ["quotas", "limits"],
   async execute(args, session) {
@@ -49834,7 +49932,9 @@ var quotaCommand = {
 };
 var validateCommand = {
   name: "validate",
-  description: "Pre-deployment validation for quotas and features",
+  description: "Run pre-deployment validation checks against quota limits and feature availability. Verify resource creation will succeed before deployment. Check if specific features are enabled for your subscription tier.",
+  descriptionShort: "Validate quotas and feature access",
+  descriptionMedium: "Pre-deployment validation for quota capacity and feature availability checks.",
   usage: "[--resource-type <type> --count <n>] [--feature <name>] [--json]",
   async execute(args, session) {
     const jsonOutput = args.includes("--json");
@@ -49922,7 +50022,9 @@ var validateCommand = {
 };
 var activationStatusCommand = {
   name: "activation-status",
-  description: "Check pending addon activation requests",
+  description: "Monitor the status of pending addon service activation requests. Track which addons are awaiting approval or provisioning. View currently active addons alongside pending requests.",
+  descriptionShort: "Check pending addon activations",
+  descriptionMedium: "Monitor pending addon activation requests and track provisioning status.",
   usage: "[--json]",
   async execute(args, session) {
     const jsonOutput = args.includes("--json");
@@ -50317,7 +50419,9 @@ complete -c xcsh -l cascade -d 'Cascade delete'
 // src/domains/completion/index.ts
 var bashCommand = {
   name: "bash",
-  description: "Generate bash completion script",
+  description: "Generate a bash shell completion script for xcsh. Output the script to stdout for manual installation or pipe to a file. Enables tab-completion for commands, domains, actions, and option flags.",
+  descriptionShort: "Generate bash completion script",
+  descriptionMedium: "Output bash completion script for tab-completion of commands, domains, and flags.",
   async execute() {
     try {
       const script = generateBashCompletion();
@@ -50331,7 +50435,9 @@ var bashCommand = {
 };
 var zshCommand = {
   name: "zsh",
-  description: "Generate zsh completion script",
+  description: "Generate a zsh shell completion script for xcsh. Output the script to stdout for manual installation or add to your fpath. Provides rich tab-completion with descriptions for commands, domains, and options.",
+  descriptionShort: "Generate zsh completion script",
+  descriptionMedium: "Output zsh completion script with rich descriptions for commands and options.",
   async execute() {
     try {
       const script = generateZshCompletion();
@@ -50345,7 +50451,9 @@ var zshCommand = {
 };
 var fishCommand = {
   name: "fish",
-  description: "Generate fish completion script",
+  description: "Generate a fish shell completion script for xcsh. Output the script to stdout for manual installation or save to your fish completions directory. Enables intelligent tab-completion with inline descriptions.",
+  descriptionShort: "Generate fish completion script",
+  descriptionMedium: "Output fish completion script with inline descriptions for commands and options.",
   async execute() {
     try {
       const script = generateFishCompletion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robinmordasiewicz/f5xc-xcsh",
-  "version": "6.28.0",
+  "version": "6.29.0",
   "description": "F5 Distributed Cloud Shell - Interactive CLI for F5 XC",
   "type": "module",
   "bin": {
@@ -39,7 +39,9 @@
     "generate:domains": "tsx scripts/generate-domains.ts",
     "generate:completions": "tsx scripts/generate-completions.ts",
     "generate:logo": "tsx scripts/generate-logo-asset.ts",
-    "generate": "npm run generate:domains && npm run generate:completions && npm run generate:logo",
+    "generate:descriptions": "tsx scripts/generate-descriptions.ts",
+    "generate:description-loader": "tsx scripts/generate-description-loader.ts",
+    "generate": "npm run generate:domains && npm run generate:completions && npm run generate:logo && npm run generate:description-loader",
     "prebuild": "npm run generate"
   },
   "keywords": [