@robinmordasiewicz/f5xc-xcsh 2.0.21-2601142039 → 2.0.21-2601150211

package/dist/index.js

@@ -30560,8 +30560,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "api_definition",
-              description: "Create API Definition.",
-              descriptionShort: "Create API Definition.",
+              description: "API schema definition for discovery and protection",
+              descriptionShort: "API definition",
               tier: "Advanced",
               icon: "\u{1F4C4}",
               category: "API Management",
@@ -30846,8 +30846,8 @@ var init_domains_generated = __esm({
           allResources: [
             {
               name: "api_credential",
-              description: "It is used to revoke multiple API credentials. This API would disable the credentials and mark them for deletion.\nThe actual removal of objects would be done in the background.\nDepending upon if user is admin or not, following behaviour is supported:-\n* for admins : user has the access to DELETE their own as well as credentials created by others\n* for non-admins: user can only DELETE their own credentials.",
-              descriptionShort: "It is used to revoke multiple API credentials. This API woul",
+              description: "API credential for service authentication",
+              descriptionShort: "API credential",
               tier: "Standard",
               icon: "\u{1F511}",
               category: "Identity",
@@ -31161,8 +31161,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "quota",
-              description: "Create quota creates a given object from storage backend for metadata.namespace.",
-              descriptionShort: "Create quota creates a given object from storage backend for",
+              description: "Resource quota for usage limits",
+              descriptionShort: "Quota",
               tier: "Standard",
               icon: "\u{1F4CA}",
               category: "Other",
@@ -31409,8 +31409,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "secret_policy",
-              description: "Create secret_policy creates a new object in the storage backend for metadata.namespace.",
-              descriptionShort: "Create secret_policy creates a new object in the storage bac",
+              description: "Secret management policy configuration",
+              descriptionShort: "Secret policy",
               tier: "Standard",
               icon: "\u{1F4CB}",
               category: "Security",
@@ -31690,8 +31690,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "cdn_loadbalancer",
-              description: "Shape of the CDN loadbalancer specification.",
-              descriptionShort: "Shape of the CDN loadbalancer specification.",
+              description: "Content delivery network load balancer for edge caching",
+              descriptionShort: "CDN load balancer",
               tier: "Standard",
               icon: "\u{1F30D}",
               category: "Load Balancing",
@@ -31996,8 +31996,8 @@ var init_domains_generated = __esm({
           allResources: [
             {
               name: "certificate",
-              description: "Shape of the Certificate specification.",
-              descriptionShort: "Shape of the Certificate specification.",
+              description: "TLS certificate for secure HTTPS connections",
+              descriptionShort: "Certificate",
               tier: "Standard",
               icon: "\u{1F4DC}",
               category: "Security",
@@ -32009,8 +32009,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "certificate_chain",
-              description: "Shape of the Certificate Chain specification.",
-              descriptionShort: "Shape of the Certificate Chain specification.",
+              description: "Certificate chain for complete trust verification",
+              descriptionShort: "Certificate chain",
               tier: "Standard",
               icon: "\u{1F517}",
               category: "Security",
@@ -32366,8 +32366,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "workload",
-              description: "Shape of Workload.",
-              descriptionShort: "Shape of Workload.",
+              description: "Container workload deployment configuration",
+              descriptionShort: "Workload",
               tier: "Advanced",
               icon: "\u{1F4E6}",
               category: "Container",
@@ -32476,8 +32476,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "sensitive_data_policy",
-              description: "Create sensitive_data_policy creates a new object in the storage backend for metadata.namespace.",
-              descriptionShort: "Create sensitive_data_policy creates a new object in the sto",
+              description: "Sensitive data policy for PII protection",
+              descriptionShort: "Sensitive data policy",
               tier: "Advanced",
               icon: "\u{1F510}",
               category: "Security",
@@ -33172,8 +33172,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "dns_domain",
-              description: "Create DNS Domain in a given namespace. If one already exist it will give a error.",
-              descriptionShort: "Create DNS Domain in a given namespace. If one already exist",
+              description: "DNS domain delegation and configuration settings",
+              descriptionShort: "DNS domain",
               tier: "Standard",
               icon: "\u{1F517}",
               category: "DNS",
@@ -33203,8 +33203,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "dns_load_balancer",
-              description: "Create DNS Load Balancer in a given namespace. If one already exist it will give a error.",
-              descriptionShort: "Create DNS Load Balancer in a given namespace. If one alread",
+              description: "DNS-based traffic distribution with geographic routing and failover",
+              descriptionShort: "DNS load balancer",
               tier: "Standard",
               icon: "\u2696\uFE0F",
               category: "DNS",
@@ -33220,8 +33220,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "dns_zone",
-              description: "Create DNS Zone in a given namespace. If one already exist it will give a error.",
-              descriptionShort: "Create DNS Zone in a given namespace. If one already exist i",
+              description: "Authoritative DNS zone with record management capabilities",
+              descriptionShort: "DNS zone",
               tier: "Standard",
               icon: "\u{1F310}",
               category: "DNS",
@@ -33485,8 +33485,8 @@ var init_domains_generated = __esm({
           allResources: [
             {
               name: "container_registry",
-              description: "Shape of Container Registry.",
-              descriptionShort: "Shape of Container Registry.",
+              description: "Container image registry for workload images",
+              descriptionShort: "Container registry",
               tier: "Advanced",
               icon: "\u{1F4E6}",
               category: "Container",
@@ -33498,8 +33498,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "k8s_cluster_role",
-              description: "Create k8s_cluster_role will create the object in the storage backend for namespace metadata.namespace.",
-              descriptionShort: "Create k8s_cluster_role will create the object in the storag",
+              description: "Kubernetes cluster RBAC role configuration",
+              descriptionShort: "K8s cluster role",
               tier: "Advanced",
               icon: "\u{1F464}",
               category: "Container",
@@ -33967,8 +33967,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "network_connector",
-              description: "Network Connector is created by users in system namespace.",
-              descriptionShort: "Network Connector is created by users in system namespace.",
+              description: "Network connector for site-to-site or cloud connectivity",
+              descriptionShort: "Network connector",
               tier: "Advanced",
               icon: "\u{1F50C}",
               category: "Networking",
@@ -34045,8 +34045,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "virtual_network",
-              description: "Create virtual network in given namespace.",
-              descriptionShort: "Create virtual network in given namespace.",
+              description: "Virtual network for site connectivity and segmentation",
+              descriptionShort: "Virtual network",
               tier: "Standard",
               icon: "\u{1F517}",
               category: "Networking",
@@ -34208,8 +34208,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "forward_proxy_policy",
-              description: "Shape of the Forward Proxy Policy specification.",
-              descriptionShort: "Shape of the Forward Proxy Policy specification.",
+              description: "Forward proxy policy for outbound traffic control",
+              descriptionShort: "Forward proxy policy",
               tier: "Advanced",
               icon: "\u27A1\uFE0F",
               category: "Security",
@@ -34257,8 +34257,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "network_firewall",
-              description: "Network firewall is created by users in system namespace.",
-              descriptionShort: "Network firewall is created by users in system namespace.",
+              description: "Network firewall for layer 3/4 traffic protection",
+              descriptionShort: "Network firewall",
               tier: "Standard",
               icon: "\u{1F9F1}",
               category: "Security",
@@ -34270,8 +34270,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "network_policy",
-              description: "Creates a new network policy with configured parameters in specified namespace.",
-              descriptionShort: "Creates a new network policy with configured parameters in s",
+              description: "Network security policy for traffic filtering",
+              descriptionShort: "Network policy",
               tier: "Standard",
               icon: "\u{1F512}",
               category: "Security",
@@ -35101,8 +35101,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "rate_limiter",
-              description: "Create rate_limiter creates a new object in the storage backend for metadata.namespace.",
-              descriptionShort: "Create rate_limiter creates a new object in the storage back",
+              description: "Rate limiter for traffic throttling and protection",
+              descriptionShort: "Rate limiter",
               tier: "Standard",
               icon: "\u23F1\uFE0F",
               category: "Security",
@@ -35277,8 +35277,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "endpoint",
-              description: "Create endpoint will create the object in the storage backend for namespace metadata.namespace.",
-              descriptionShort: "Create endpoint will create the object in the storage backen",
+              description: "Service mesh endpoint for traffic routing",
+              descriptionShort: "Endpoint",
               tier: "Advanced",
               icon: "\u{1F3AF}",
               category: "Networking",
@@ -37282,8 +37282,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "site",
-              description: "",
-              descriptionShort: "site",
+              description: "Physical or cloud deployment location for edge services",
+              descriptionShort: "Site",
               tier: "Standard",
               icon: "\u{1F3E2}",
               category: "Infrastructure",
@@ -37299,8 +37299,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "site_mesh_group",
-              description: "GET topology of a site mesh.",
-              descriptionShort: "GET topology of a site mesh.",
+              description: "Mesh connectivity configuration between multiple sites",
+              descriptionShort: "Site mesh group",
               tier: "Advanced",
               icon: "\u{1F578}\uFE0F",
               category: "Infrastructure",
@@ -37352,8 +37352,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "virtual_site",
-              description: "Create a virtual site object in given namespace.",
-              descriptionShort: "Create a virtual site object in given namespace.",
+              description: "Logical grouping of sites using label selectors",
+              descriptionShort: "Virtual site",
               tier: "Standard",
               icon: "\u{1F3F7}\uFE0F",
               category: "Infrastructure",
@@ -39409,8 +39409,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "session",
-              description: "GetUserSessions returns a list of user sessions.",
-              descriptionShort: "GetUserSessions returns a list of user sessions.",
+              description: "User session for authentication state",
+              descriptionShort: "Session",
               tier: "Standard",
               icon: "\u{1F511}",
               category: "Identity",
@@ -40187,8 +40187,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "healthcheck",
-              description: "Healthcheck object defines method to determine if the given Endpoint is healthy.\nSingle Healthcheck object can be referred to by one or many Cluster objects.",
-              descriptionShort: "Healthcheck object defines method to determine if the given ",
+              description: "Health monitoring configuration for origin server availability",
+              descriptionShort: "Health check",
               tier: "Standard",
               icon: "\u{1F493}",
               category: "Monitoring",
@@ -40200,8 +40200,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "http_loadbalancer",
-              description: "Shape of the HTTP load balancer specification.",
-              descriptionShort: "Shape of the HTTP load balancer specification.",
+              description: "Layer 7 HTTP/HTTPS load balancer for application traffic distribution",
+              descriptionShort: "HTTP load balancer",
               tier: "Standard",
               icon: "\u{1F310}",
               category: "Load Balancing",
@@ -40240,8 +40240,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "origin_pool",
-              description: "Shape of the origin pool create specification.",
-              descriptionShort: "Shape of the origin pool create specification.",
+              description: "Backend server group for load balancer traffic distribution",
+              descriptionShort: "Origin pool",
               tier: "Standard",
               icon: "\u{1F3AF}",
               category: "Load Balancing",
@@ -40302,8 +40302,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "tcp_loadbalancer",
-              description: "Shape of the TCP load balancer create specification.",
-              descriptionShort: "Shape of the TCP load balancer create specification.",
+              description: "Layer 4 TCP/UDP load balancer for non-HTTP protocol traffic",
+              descriptionShort: "TCP load balancer",
               tier: "Standard",
               icon: "\u{1F50C}",
               category: "Load Balancing",
@@ -40720,8 +40720,8 @@ var init_domains_generated = __esm({
             },
             {
               name: "app_firewall",
-              description: "Create Application Firewall.",
-              descriptionShort: "Create Application Firewall.",
+              description: "Web Application Firewall policy for HTTP traffic protection",
+              descriptionShort: "WAF policy",
               tier: "Advanced",
               icon: "\u{1F6E1}\uFE0F",
               category: "Security",
@@ -41228,8 +41228,8 @@ var init_logo_renderer = __esm({
 
 // src/branding/index.ts
 function getVersion() {
-  if ("v2.0.21-2601142039") {
-    return "v2.0.21-2601142039";
+  if ("v2.0.21-2601150211") {
+    return "v2.0.21-2601150211";
   }
   if (process.env.XCSH_VERSION) {
     return process.env.XCSH_VERSION;
@@ -77869,6 +77869,132 @@ var init_response_renderer = __esm({
   }
 });
 
+// src/utils/usage-parser.ts
+function parseUsage(usageString) {
+  if (!usageString) {
+    return { positional: [], flags: [], raw: "" };
+  }
+  const positional = [];
+  const flags = [];
+  const tokens = tokenizeUsage(usageString);
+  for (let i = 0; i < tokens.length; i++) {
+    const token = tokens[i];
+    if (!token) continue;
+    if (token.startsWith("--")) {
+      const flagName = token;
+      const nextToken = tokens[i + 1];
+      let valueType;
+      let valueName;
+      let required = true;
+      if (nextToken && isValuePlaceholder(nextToken)) {
+        valueName = stripBrackets(nextToken);
+        valueType = "string";
+        i++;
+        required = !token.match(/^\[--/) && !nextToken.match(/^\[/);
+      } else {
+        required = !token.match(/^\[--/);
+      }
+      const cleanName = flagName.replace(/[[\]]/g, "");
+      if (cleanName) {
+        const flag = {
+          name: cleanName,
+          required,
+          ...valueType && { valueType },
+          ...valueName && { valueName }
+        };
+        flags.push(flag);
+      }
+    } else if (isValuePlaceholder(token)) {
+      const name = stripBrackets(token);
+      const required = isRequired(token);
+      if (name) {
+        positional.push({
+          name,
+          required
+        });
+      }
+    }
+  }
+  return {
+    positional,
+    flags,
+    raw: usageString
+  };
+}
+function tokenizeUsage(usageString) {
+  const tokens = [];
+  let current = "";
+  let bracketDepth = 0;
+  for (let i = 0; i < usageString.length; i++) {
+    const char = usageString[i];
+    if (char === "[") {
+      bracketDepth++;
+      current += char;
+    } else if (char === "]") {
+      bracketDepth--;
+      current += char;
+      if (bracketDepth === 0 && current.trim()) {
+        tokens.push(current.trim());
+        current = "";
+      }
+    } else if (char === " " && bracketDepth === 0) {
+      if (current.trim()) {
+        tokens.push(current.trim());
+        current = "";
+      }
+    } else if (char === "<") {
+      if (current.trim() && !current.includes("<")) {
+        tokens.push(current.trim());
+        current = "";
+      }
+      current += char;
+    } else if (char === ">") {
+      current += char;
+      if (bracketDepth === 0) {
+        tokens.push(current.trim());
+        current = "";
+      }
+    } else {
+      current += char;
+    }
+  }
+  if (current.trim()) {
+    tokens.push(current.trim());
+  }
+  return tokens;
+}
+function isValuePlaceholder(token) {
+  return /^[<[][\w-]+[\]>]$/.test(token) || /^<[\w-]+>$/.test(token);
+}
+function isRequired(token) {
+  return token.startsWith("<") && token.endsWith(">");
+}
+function stripBrackets(token) {
+  return token.replace(/^[<[]/, "").replace(/[>\]]$/, "");
+}
+function generateSmartCompletions(usage, args, flags) {
+  if (!usage) {
+    return flags;
+  }
+  const requirements = parseUsage(usage);
+  const positionalArgsProvided = args.filter(
+    (arg) => !arg.startsWith("--")
+  ).length;
+  const requiredPositional = requirements.positional.filter(
+    (p) => p.required
+  );
+  if (positionalArgsProvided < requiredPositional.length) {
+    const placeholders = requiredPositional.slice(positionalArgsProvided).map((p) => `<${p.name}>`);
+    return [...placeholders, ...flags];
+  }
+  return flags;
+}
+var init_usage_parser = __esm({
+  "src/utils/usage-parser.ts"() {
+    "use strict";
+  }
+});
+
 // src/domains/ai_services/query.ts
 function getLastQueryState() {
   return lastQueryState;
@@ -77925,6 +78051,7 @@ var init_query = __esm({
     init_domain_formatter();
     init_client();
     init_response_renderer();
+    init_usage_parser();
     lastQueryState = {
       namespace: "",
       lastQueryId: null,
@@ -77937,8 +78064,26 @@ var init_query = __esm({
       description: "Send a natural language query to the F5 Distributed Cloud AI assistant. Ask about load balancers, WAF configurations, site status, security events, or any platform topic. Returns AI-generated responses with optional follow-up suggestions. Use --namespace to specify the context for namespace-scoped resources.",
       descriptionShort: "Query the AI assistant",
       descriptionMedium: "Send natural language queries to the AI assistant for help with F5 XC platform operations, configurations, and troubleshooting.",
-      usage: "<question> [--namespace <ns>]",
+      usage: "<question> [--namespace <ns>] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
       aliases: ["ask", "q"],
+      async completion(_partial, args, session) {
+        const flags = [
+          "--namespace",
+          "-ns",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        const namespaces = session.getNamespaceCache();
+        return generateSmartCompletions(this.usage, args, [
+          ...flags,
+          ...namespaces
+        ]);
+      },
       async execute(args, session) {
         const { format, noColor, spec, namespace, question } = parseQueryArgs(
           args,
@@ -78161,6 +78306,7 @@ var init_list = __esm({
       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.",
+      usage: "[--format <json|table|yaml>]",
       async execute(args, session) {
         const { options } = parseDomainOutputFlags(
           args,
@@ -78237,7 +78383,7 @@ var init_show = __esm({
         const manager = getProfileManager();
         const name = remainingArgs[0];
         if (!name) {
-          return errorResult("Usage: login profile show <name>");
+          return errorResult("Usage: login show profile <name>");
         }
         try {
           const profile = await manager.get(name);
@@ -78725,6 +78871,33 @@ var init_validation = __esm({
   }
 });
 
+// src/domains/error-messages.ts
+function generateUsageError(commandPath, usageField, additionalHelp) {
+  const lines = [];
+  lines.push(`Usage: ${commandPath} ${usageField}`);
+  lines.push("");
+  if (additionalHelp?.options && additionalHelp.options.length > 0) {
+    lines.push("Options:");
+    for (const opt of additionalHelp.options) {
+      lines.push(`  ${opt.flag.padEnd(12)} ${opt.description}`);
+    }
+    lines.push("");
+  }
+  if (additionalHelp?.examples && additionalHelp.examples.length > 0) {
+    lines.push("Example:");
+    for (const example of additionalHelp.examples) {
+      lines.push(`  ${example}`);
+    }
+  }
+  return lines.join("\n");
+}
+var init_error_messages = __esm({
+  "src/domains/error-messages.ts"() {
+    "use strict";
+    init_usage_parser();
+  }
+});
+
 // src/domains/login/profile/create.ts
 var createCommand2;
 var init_create = __esm({
@@ -78734,6 +78907,8 @@ var init_create = __esm({
     init_profile();
     init_connection_table();
     init_validation();
+    init_error_messages();
+    init_usage_parser();
     createCommand2 = {
       name: "create",
       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.",
@@ -78741,25 +78916,44 @@ var init_create = __esm({
       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"],
-      completion: async (_currentWord, _args) => {
-        return ["--url", "--token", "--namespace"];
+      completion: async (_currentWord, args) => {
+        return generateSmartCompletions(createCommand2.usage, args, [
+          "--url",
+          "--token",
+          "--namespace"
+        ]);
       },
       async execute(args, session) {
         const manager = getProfileManager();
         const name = args[0];
         if (!name || name.startsWith("-")) {
           return errorResult(
-            [
-              "Usage: login profile create <name> --url <api-url> --token <api-token>",
-              "",
-              "Options:",
-              "  --url       F5 XC API URL (e.g., https://tenant.console.ves.volterra.io)",
-              "  --token     API token for authentication",
-              "  --namespace Default namespace (optional)",
-              "",
-              "Example:",
-              "  login profile create myprofile --url https://tenant.console.ves.volterra.io --token abc123"
-            ].join("\n")
+            generateUsageError(
+              "login create profile",
+              // FIXED: Correct registry path (verb-first)
+              createCommand2.usage,
+              // Single source of truth
+              {
+                options: [
+                  {
+                    flag: "--url",
+                    description: "F5 XC API URL (e.g., https://tenant.console.ves.volterra.io)"
+                  },
+                  {
+                    flag: "--token",
+                    description: "API token for authentication"
+                  },
+                  {
+                    flag: "--namespace",
+                    description: "Default namespace (optional)"
+                  }
+                ],
+                examples: [
+                  "login create profile myprofile --url https://tenant.console.ves.volterra.io --token abc123",
+                  "login create profile prod --url https://prod.console.ves.volterra.io --token xyz789 --namespace production"
+                ]
+              }
+            )
           );
         }
         const nameValidation = validateResourceName(name, {
@@ -78858,7 +79052,7 @@ var init_use = __esm({
       async execute(args, session) {
         const name = args[0];
         if (!name) {
-          return errorResult("Usage: login profile use <name>");
+          return errorResult("Usage: login use profile <name>");
         }
         try {
           const success = await session.switchProfile(name);
@@ -78918,7 +79112,7 @@ var init_delete = __esm({
         const manager = getProfileManager();
         const name = args.find((arg) => !arg.startsWith("-"));
         if (!name) {
-          return errorResult("Usage: login profile delete <name>");
+          return errorResult("Usage: login delete profile <name>");
         }
         try {
           const profile = await manager.get(name);
@@ -79074,7 +79268,8 @@ var init_edit = __esm({
           const active = await manager.getActive();
           if (!active) {
             return errorResult(
-              "No profile specified and no active profile set.\nUsage: login profile edit <name>"
+              "No profile specified and no active profile set.\nUsage: login edit profile <name>"
+              // FIXED: Correct registry path
             );
           }
           profileName = active;
@@ -79186,7 +79381,7 @@ var init_context = __esm({
       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: "",
+      usage: "[--format <json|table|yaml|tsv>]",
       aliases: ["current", "get"],
       async execute(args, session) {
         const { options } = parseDomainOutputFlags(
@@ -79275,7 +79470,7 @@ var init_context = __esm({
       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: "",
+      usage: "[--format <json|table|yaml|tsv>]",
       aliases: ["ls"],
       async execute(args, session) {
         const { options } = parseDomainOutputFlags(
@@ -80417,13 +80612,28 @@ var init_cloudstatus2 = __esm({
     init_cloudstatus();
     init_output();
     init_domain_formatter();
+    init_usage_parser();
     cloudstatusClient = null;
     statusCommand = {
       name: "status",
       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]",
+      usage: "[--quiet] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--quiet",
+          "-q",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec, filteredArgs } = parseOutputArgs(
           args,
@@ -80474,7 +80684,21 @@ var init_cloudstatus2 = __esm({
       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]",
+      usage: "[--brief] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--brief",
+          "-b",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec, filteredArgs } = parseOutputArgs(
           args,
@@ -80513,7 +80737,21 @@ var init_cloudstatus2 = __esm({
       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]",
+      usage: "[--degraded-only] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--degraded-only",
+          "-d",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec, filteredArgs } = parseOutputArgs(
           args,
@@ -80569,7 +80807,21 @@ var init_cloudstatus2 = __esm({
       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]",
+      usage: "[--active-only] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--active-only",
+          "-a",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec, filteredArgs } = parseOutputArgs(
           args,
@@ -80621,7 +80873,21 @@ var init_cloudstatus2 = __esm({
       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]",
+      usage: "[--upcoming] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--upcoming",
+          "-u",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec, filteredArgs } = parseOutputArgs(
           args,
@@ -81323,6 +81589,7 @@ var init_completion2 = __esm({
       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.",
+      usage: "(no arguments)",
       async execute() {
         try {
           const script = generateBashCompletion();
@@ -81339,6 +81606,7 @@ var init_completion2 = __esm({
       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.",
+      usage: "(no arguments)",
       async execute() {
         try {
           const script = generateZshCompletion();
@@ -81355,6 +81623,7 @@ var init_completion2 = __esm({
       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.",
+      usage: "(no arguments)",
       async execute() {
         try {
           const script = generateFishCompletion();
@@ -81536,13 +81805,36 @@ var init_feedback = __esm({
     init_client();
     init_query();
     init_types3();
+    init_usage_parser();
     feedbackCommand = {
       name: "feedback",
       description: "Submit feedback on AI assistant responses to help improve future answers. Provide positive feedback when responses are helpful, or negative feedback with a reason type when improvements are needed. Feedback is associated with the most recent query unless a specific query ID is provided. Negative feedback types include: inaccurate (wrong information), irrelevant (off-topic), poor_format (hard to read), slow (response time), or other.",
       descriptionShort: "Submit feedback for AI responses",
       descriptionMedium: "Provide positive or negative feedback for AI assistant responses. Use --negative with a type: inaccurate, irrelevant, poor_format, slow, or other.",
-      usage: "--positive | --negative <type> [--comment <text>] [--query-id <id>]",
+      usage: "--positive | --negative <type> [--comment <text>] [--query-id <id>] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
       aliases: ["fb", "rate"],
+      async completion(_partial, args) {
+        const feedbackTypes = getValidFeedbackTypes();
+        const flags = [
+          "--positive",
+          "-p",
+          "--negative",
+          "-n",
+          "--comment",
+          "-c",
+          "--query-id",
+          "-q",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv",
+          ...feedbackTypes
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const {
           format,
@@ -81760,13 +82052,32 @@ var init_eval = __esm({
     init_response_renderer();
     init_query();
     init_types3();
+    init_usage_parser();
     evalQueryCommand = {
       name: "query",
       description: "Send a query to the AI assistant using the eval endpoint. This endpoint is used for RBAC testing and validation purposes, allowing administrators to test permission scenarios without affecting production query analytics.",
       descriptionShort: "Eval mode AI query",
       descriptionMedium: "Query the AI assistant in eval mode for RBAC testing and permission validation.",
-      usage: "<question> [--namespace <ns>]",
+      usage: "<question> [--namespace <ns>] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
       aliases: ["q"],
+      async completion(_partial, args, session) {
+        const flags = [
+          "--namespace",
+          "-ns",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        const namespaces = session.getNamespaceCache();
+        return generateSmartCompletions(this.usage, args, [
+          ...flags,
+          ...namespaces
+        ]);
+      },
       async execute(args, session) {
         const { format, noColor, spec, namespace, question } = parseEvalQueryArgs(args, session);
         if (spec) {
@@ -81822,8 +82133,30 @@ var init_eval = __esm({
       description: "Submit feedback for an eval mode query. Use this endpoint when providing feedback for queries made through the eval endpoint, ensuring proper RBAC testing analytics separation.",
       descriptionShort: "Eval mode feedback submission",
       descriptionMedium: "Submit feedback for eval mode AI queries, keeping RBAC testing analytics separate.",
-      usage: "--positive | --negative <type> [--comment <text>] [--query-id <id>]",
+      usage: "--positive | --negative <type> [--comment <text>] [--query-id <id>] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
       aliases: ["fb"],
+      async completion(_partial, args) {
+        const feedbackTypes = getValidFeedbackTypes();
+        const flags = [
+          "--positive",
+          "-p",
+          "--negative",
+          "-n",
+          "--comment",
+          "-c",
+          "--query-id",
+          "-q",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv",
+          ...feedbackTypes
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { spec, namespace, positive, negativeType, comment, queryId } = parseEvalFeedbackArgs(args, session);
         if (spec) {
@@ -82511,12 +82844,25 @@ var init_subscription = __esm({
     init_output();
     init_domain_formatter();
     init_client3();
+    init_usage_parser();
     showCommand3 = {
       name: "show",
       description: "Display comprehensive subscription overview including plan tier, addon summary, quota utilization, and current billing period usage. Provides a quick snapshot of your F5 XC subscription status.",
       descriptionShort: "Display subscription overview",
       descriptionMedium: "Show subscription tier, active addons, quota usage summary, and current billing status.",
-      usage: "",
+      usage: "[--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec } = parseOutputArgs2(args, session);
         if (spec) {
@@ -82616,7 +82962,19 @@ var init_subscription = __esm({
       description: "Display detailed information about your current subscription plan including tier, features, and limits.",
       descriptionShort: "Show current plan details",
       descriptionMedium: "Display detailed subscription plan information including tier level, features, and resource limits.",
-      usage: "",
+      usage: "[--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec } = parseOutputArgs2(args, session);
         if (spec) {
@@ -82672,7 +83030,19 @@ var init_subscription = __esm({
       description: "List all available subscription plans with their features and pricing tiers.",
       descriptionShort: "List available plans",
       descriptionMedium: "Display all subscription plan options with tier information and feature comparisons.",
-      usage: "",
+      usage: "[--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec } = parseOutputArgs2(args, session);
         if (spec) {
@@ -82727,7 +83097,20 @@ var init_subscription = __esm({
       description: "List all available addon services with their status, category, and access level. Use --subscribed to filter for active subscriptions only.",
       descriptionShort: "List addon services",
       descriptionMedium: "Display all addon services with status and access information. Use --subscribed for active only.",
-      usage: "[--subscribed]",
+      usage: "[--subscribed] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--subscribed",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec, filteredArgs } = parseOutputArgs2(
           args,
@@ -82793,7 +83176,19 @@ var init_subscription = __esm({
       description: "Display detailed information about a specific addon service including features, pricing, and requirements.",
       descriptionShort: "Show addon details",
       descriptionMedium: "Display detailed addon service information including features, pricing, and dependencies.",
-      usage: "<addon-name>",
+      usage: "<addon-name> [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec, filteredArgs } = parseOutputArgs2(
           args,
@@ -82869,7 +83264,19 @@ var init_subscription = __esm({
       description: "Display activation status for all addon services showing which are active, pending, or inactive.",
       descriptionShort: "Show addon activation status",
       descriptionMedium: "Display activation status for all addon services with detailed state information.",
-      usage: "",
+      usage: "[--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec } = parseOutputArgs2(args, session);
         if (spec) {
@@ -82924,7 +83331,19 @@ var init_subscription = __esm({
       description: "Display all tenant-level quota limits including resource caps for load balancers, origins, sites, and other configurable resources.",
       descriptionShort: "Show quota limits",
       descriptionMedium: "Display all tenant-level resource quota limits and their current values.",
-      usage: "",
+      usage: "[--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec } = parseOutputArgs2(args, session);
         if (spec) {
@@ -82985,7 +83404,21 @@ var init_subscription = __esm({
       description: "Display current quota usage against limits with utilization percentages. Use --critical to show only quotas above 80% utilization.",
       descriptionShort: "Show quota usage",
       descriptionMedium: "Display current resource usage against quota limits with utilization percentage.",
-      usage: "[--critical]",
+      usage: "[--critical] [--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--critical",
+          "-c",
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec, filteredArgs } = parseOutputArgs2(
           args,
@@ -83056,7 +83489,19 @@ var init_subscription = __esm({
       description: "Display current billing period usage including itemized costs and projected totals.",
       descriptionShort: "Show current period usage",
       descriptionMedium: "Display current billing period usage with cost breakdown and projections.",
-      usage: "",
+      usage: "[--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec } = parseOutputArgs2(args, session);
         if (spec) {
@@ -83183,7 +83628,19 @@ var init_subscription = __esm({
       description: "List all configured payment methods showing type, status, and primary designation.",
       descriptionShort: "List payment methods",
       descriptionMedium: "Display all payment methods with type, status, and primary/secondary designation.",
-      usage: "",
+      usage: "[--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec } = parseOutputArgs2(args, session);
         if (spec) {
@@ -83311,7 +83768,19 @@ var init_subscription = __esm({
       description: "Generate comprehensive subscription report combining plan details, addon status, quota utilization, usage metrics, and billing summary.",
       descriptionShort: "Generate subscription report",
       descriptionMedium: "Create comprehensive report with plan, addons, quotas, usage, and billing data.",
-      usage: "",
+      usage: "[--format <json|table|yaml|tsv>] [--spec] [--no-color]",
+      async completion(_partial, args) {
+        const flags = [
+          "--format",
+          "--spec",
+          "--no-color",
+          "json",
+          "table",
+          "yaml",
+          "tsv"
+        ];
+        return generateSmartCompletions(this.usage, args, flags);
+      },
       async execute(args, session) {
         const { format, noColor, spec } = parseOutputArgs2(args, session);
         if (spec) {
@@ -84372,7 +84841,14 @@ var init_completer = __esm({
           );
         }
         if (subgroupNode?.children) {
-          if (args.length === 1 || args.length === 2 && currentWord === args[1]) {
+          const cmdName = args[1]?.toLowerCase() ?? "";
+          const domain2 = customDomains.get(domainName);
+          let cmd = domain2?.actions?.get(subgroupName)?.resources.get(cmdName);
+          if (!cmd) {
+            const subgroup = domain2?.subcommands.get(subgroupName);
+            cmd = subgroup?.commands.get(cmdName);
+          }
+          if (args.length === 1 || args.length === 2 && currentWord === args[1] && !cmd) {
             const prefix = args.length === 2 ? currentWord : "";
             return completionRegistry.getNestedChildSuggestions(
               domainName,
@@ -84380,14 +84856,7 @@ var init_completer = __esm({
               prefix
             );
           }
-          if (args.length >= 2 && this.session) {
-            const cmdName = args[1]?.toLowerCase() ?? "";
-            const domain2 = customDomains.get(domainName);
-            let cmd = domain2?.actions?.get(subgroupName)?.resources.get(cmdName);
-            if (!cmd) {
-              const subgroup = domain2?.subcommands.get(subgroupName);
-              cmd = subgroup?.commands.get(cmdName);
-            }
+          if (args.length >= 2 && this.session && cmd) {
             if (cmd?.completion) {
               try {
                 const completions = await cmd.completion(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robinmordasiewicz/f5xc-xcsh",
-  "version": "2.0.21-2601142039",
+  "version": "2.0.21-2601150211",
   "description": "F5 Distributed Cloud Shell - Interactive CLI for F5 XC",
   "type": "module",
   "bin": {
@@ -40,7 +40,9 @@
     "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
     "typecheck": "tsc --noEmit",
     "security:audit": "npm audit --audit-level=high",
-    "validate": "npm run typecheck && npm run lint && npm run format:check",
+    "analyze:consistency": "tsx scripts/analyze-command-consistency.ts",
+    "verify:consistency": "tsx scripts/verify-command-consistency.ts",
+    "validate": "npm run typecheck && npm run lint && npm run format:check && npm run verify:consistency",
     "generate:domains": "tsx scripts/generate-domains.ts",
     "generate:completions": "tsx scripts/generate-completions.ts",
     "generate:logo": "tsx scripts/generate-logo-asset.ts",