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

package/dist/index.js

@@ -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-2601142307") {
+    return "v2.0.21-2601142307";
   }
   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-2601142307",
   "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",