@robinmordasiewicz/f5xc-xcsh 6.35.0 → 6.36.0

package/dist/index.js

@@ -45354,8 +45354,8 @@ function getLogoModeFromEnv(envPrefix) {
 var CLI_NAME = "xcsh";
 var CLI_FULL_NAME = "F5 Distributed Cloud Shell";
 function getVersion() {
-  if ("6.35.0") {
-    return "6.35.0";
+  if ("6.36.0") {
+    return "6.36.0";
   }
   if (process.env.XCSH_VERSION) {
     return process.env.XCSH_VERSION;
@@ -46843,6 +46843,452 @@ function useHistory(options) {
 // src/repl/hooks/useCompletion.ts
 var import_react27 = __toESM(require_react(), 1);
 
+// src/config/envvars.ts
+var EnvVarRegistry = [
+  {
+    name: `${ENV_PREFIX}_API_URL`,
+    description: "API endpoint URL",
+    relatedFlag: "",
+    required: true
+  },
+  {
+    name: `${ENV_PREFIX}_API_TOKEN`,
+    description: "API authentication token",
+    relatedFlag: "",
+    required: true
+  },
+  {
+    name: `${ENV_PREFIX}_NAMESPACE`,
+    description: "Default namespace",
+    relatedFlag: "-ns"
+  },
+  {
+    name: `${ENV_PREFIX}_OUTPUT_FORMAT`,
+    description: "Output format (json, yaml, table)",
+    relatedFlag: "-o"
+  },
+  {
+    name: `${ENV_PREFIX}_LOGO`,
+    description: "Logo display mode (auto, image, ascii, both, none)",
+    relatedFlag: "--logo"
+  },
+  {
+    name: "NO_COLOR",
+    description: "Disable color output",
+    relatedFlag: "--no-color"
+  }
+];
+function formatEnvVarsSection() {
+  const maxLen = Math.max(...EnvVarRegistry.map((e) => e.name.length));
+  const lines = ["ENVIRONMENT VARIABLES"];
+  for (const env3 of EnvVarRegistry) {
+    const padding = " ".repeat(maxLen - env3.name.length + 3);
+    const flagNote = env3.relatedFlag ? ` [${env3.relatedFlag}]` : "";
+    lines.push(`  ${env3.name}${padding}${env3.description}${flagNote}`);
+  }
+  return lines;
+}
+function formatConfigSection() {
+  return [
+    "CONFIGURATION",
+    `  Config file:  ~/${CONFIG_FILE_NAME}`,
+    "  Priority:     CLI flags > environment variables > config file > defaults",
+    "",
+    "DOCUMENTATION",
+    `  ${DOCS_URL}`
+  ];
+}
+
+// src/repl/help.ts
+function wrapText2(text, width, indent) {
+  const prefix = " ".repeat(indent);
+  const words = text.split(/\s+/);
+  const lines = [];
+  let currentLine = prefix;
+  for (const word of words) {
+    if (currentLine.length + word.length + 1 > width && currentLine !== prefix) {
+      lines.push(currentLine);
+      currentLine = prefix + word;
+    } else {
+      currentLine += (currentLine === prefix ? "" : " ") + word;
+    }
+  }
+  if (currentLine.trim()) {
+    lines.push(currentLine);
+  }
+  return lines;
+}
+function formatRootHelp() {
+  return [
+    "",
+    colorBoldWhite(`${CLI_NAME} - ${CLI_FULL_NAME} v${CLI_VERSION}`),
+    "",
+    "DESCRIPTION",
+    ...wrapText2(CLI_DESCRIPTION_LONG, 80, 2),
+    "",
+    "USAGE",
+    `  ${CLI_NAME}                              Enter interactive REPL mode`,
+    `  ${CLI_NAME} <domain> <action>            Execute command non-interactively`,
+    `  ${CLI_NAME} help [topic]                 Show help for a topic`,
+    "",
+    "EXAMPLES",
+    `  ${CLI_NAME} tenant_and_identity list namespace   List all namespaces`,
+    `  ${CLI_NAME} virtual get http_loadbalancer        Get a specific load balancer`,
+    `  ${CLI_NAME} dns list                             List DNS zones`,
+    `  ${CLI_NAME} waf list -ns prod                    List WAF policies in prod`,
+    `  ${CLI_NAME} --interactive                        Force interactive REPL mode`,
+    "",
+    ...formatDomainsSection(),
+    "",
+    ...formatGlobalFlags(),
+    "",
+    ...formatEnvVarsSection(),
+    "",
+    ...formatConfigSection(),
+    "",
+    "NAVIGATION (Interactive Mode)",
+    "  <domain>              Navigate into a domain (e.g., 'dns', 'lb')",
+    "  /domain               Navigate directly to domain from anywhere",
+    "  ..                    Go up one level",
+    "  /                     Return to root",
+    "  context               Show current navigation context",
+    "",
+    "BUILTINS",
+    "  help                  Show this help",
+    "  domains               List all available domains",
+    "  clear                 Clear the screen",
+    "  history               Show command history",
+    "  quit, exit            Exit the shell",
+    ""
+  ];
+}
+function formatGlobalFlags() {
+  return [
+    "GLOBAL FLAGS",
+    "  -v, --version         Show version number",
+    "  -h, --help            Show this help",
+    "  -i, --interactive     Force interactive mode",
+    "  --no-color            Disable color output",
+    "  -o, --output <fmt>    Output format (json, yaml, table)",
+    "  -ns, --namespace <ns> Target namespace"
+  ];
+}
+function formatEnvironmentVariables() {
+  return formatEnvVarsSection();
+}
+function formatDomainHelp(domain) {
+  const output = ["", colorBoldWhite(`${domain.displayName}`), ""];
+  output.push(`  ${domain.description}`);
+  output.push("");
+  if (domain.category || domain.complexity) {
+    const meta = [];
+    if (domain.category) meta.push(`Category: ${domain.category}`);
+    if (domain.complexity) meta.push(`Complexity: ${domain.complexity}`);
+    output.push(colorDim(`  ${meta.join("  |  ")}`));
+    output.push("");
+  }
+  output.push("USAGE");
+  output.push(`  ${CLI_NAME} ${domain.name} <action> [options]`);
+  output.push("");
+  output.push("ACTIONS");
+  const actionDescriptions2 = {
+    list: "List resources",
+    get: "Get a specific resource by name",
+    create: "Create a new resource",
+    delete: "Delete a resource",
+    replace: "Replace a resource configuration",
+    apply: "Apply configuration from file",
+    status: "Get resource status",
+    patch: "Patch a resource",
+    "add-labels": "Add labels to a resource",
+    "remove-labels": "Remove labels from a resource"
+  };
+  for (const action of validActions) {
+    const desc = actionDescriptions2[action] ?? action;
+    output.push(`  ${action.padEnd(16)} ${desc}`);
+  }
+  output.push("");
+  output.push("EXAMPLES");
+  output.push(`  ${CLI_NAME} ${domain.name} list`);
+  output.push(`  ${CLI_NAME} ${domain.name} get my-resource`);
+  output.push(
+    `  ${CLI_NAME} ${domain.name} create my-resource -f config.yaml`
+  );
+  output.push(`  ${CLI_NAME} ${domain.name} delete my-resource`);
+  output.push("");
+  if (domain.useCases && domain.useCases.length > 0) {
+    output.push("USE CASES");
+    for (const useCase of domain.useCases.slice(0, 5)) {
+      output.push(`  - ${useCase}`);
+    }
+    output.push("");
+  }
+  if (domain.relatedDomains && domain.relatedDomains.length > 0) {
+    output.push("RELATED DOMAINS");
+    output.push(`  ${domain.relatedDomains.join(", ")}`);
+    output.push("");
+  }
+  if (domain.aliases && domain.aliases.length > 0) {
+    output.push("ALIASES");
+    output.push(`  ${domain.aliases.join(", ")}`);
+    output.push("");
+  }
+  output.push(colorDim(`For global options, run: ${CLI_NAME} --help`));
+  output.push("");
+  return output;
+}
+function formatActionHelp(domainName, action) {
+  const domain = getDomainInfo(domainName);
+  const displayDomain = domain?.displayName ?? domainName;
+  const actionDescriptions2 = {
+    list: {
+      desc: "List all resources in the namespace",
+      usage: `${CLI_NAME} ${domainName} list [--limit N] [--label key=value]`
+    },
+    get: {
+      desc: "Get a specific resource by name",
+      usage: `${CLI_NAME} ${domainName} get <name> [-o json|yaml|table]`
+    },
+    create: {
+      desc: "Create a new resource",
+      usage: `${CLI_NAME} ${domainName} create <name> -f <file.yaml>`
+    },
+    delete: {
+      desc: "Delete a resource by name",
+      usage: `${CLI_NAME} ${domainName} delete <name>`
+    },
+    replace: {
+      desc: "Replace an existing resource configuration",
+      usage: `${CLI_NAME} ${domainName} replace <name> -f <file.yaml>`
+    },
+    apply: {
+      desc: "Apply configuration from a file (create or update)",
+      usage: `${CLI_NAME} ${domainName} apply -f <file.yaml>`
+    },
+    status: {
+      desc: "Get the current status of a resource",
+      usage: `${CLI_NAME} ${domainName} status <name>`
+    },
+    patch: {
+      desc: "Patch specific fields of a resource",
+      usage: `${CLI_NAME} ${domainName} patch <name> -f <patch.yaml>`
+    },
+    "add-labels": {
+      desc: "Add labels to a resource",
+      usage: `${CLI_NAME} ${domainName} add-labels <name> key=value`
+    },
+    "remove-labels": {
+      desc: "Remove labels from a resource",
+      usage: `${CLI_NAME} ${domainName} remove-labels <name> key`
+    }
+  };
+  const actionInfo = actionDescriptions2[action] ?? {
+    desc: `Execute ${action} operation`,
+    usage: `${CLI_NAME} ${domainName} ${action} [options]`
+  };
+  return [
+    "",
+    colorBoldWhite(`${displayDomain} - ${action}`),
+    "",
+    `  ${actionInfo.desc}`,
+    "",
+    "USAGE",
+    `  ${actionInfo.usage}`,
+    "",
+    "OPTIONS",
+    "  -n, --name <name>     Resource name",
+    "  -ns, --namespace <ns> Target namespace",
+    "  -o, --output <fmt>    Output format (json, yaml, table)",
+    "  -f, --file <path>     Configuration file",
+    "",
+    colorDim(`For domain help, run: ${CLI_NAME} ${domainName} --help`),
+    ""
+  ];
+}
+function formatTopicHelp(topic) {
+  const lowerTopic = topic.toLowerCase();
+  const domainInfo = getDomainInfo(lowerTopic);
+  if (domainInfo) {
+    return formatDomainHelp(domainInfo);
+  }
+  switch (lowerTopic) {
+    case "domains":
+      return formatDomainsHelp();
+    case "actions":
+      return formatActionsHelp();
+    case "navigation":
+    case "nav":
+      return formatNavigationHelp();
+    case "env":
+    case "environment":
+      return ["", ...formatEnvironmentVariables(), ""];
+    case "flags":
+      return ["", ...formatGlobalFlags(), ""];
+    default:
+      return [
+        "",
+        `Unknown help topic: ${topic}`,
+        "",
+        "Available topics:",
+        "  domains      List all available domains",
+        "  actions      List available actions",
+        "  navigation   Navigation commands",
+        "  env          Environment variables",
+        "  flags        Global flags",
+        "  <domain>     Help for a specific domain (e.g., 'help dns')",
+        ""
+      ];
+  }
+}
+function formatDomainsHelp() {
+  const output = ["", colorBoldWhite("Available Domains"), ""];
+  const categories = /* @__PURE__ */ new Map();
+  for (const domain of domainRegistry.values()) {
+    const category = domain.category ?? "Other";
+    if (!categories.has(category)) {
+      categories.set(category, []);
+    }
+    categories.get(category)?.push(domain);
+  }
+  const sortedCategories = Array.from(categories.keys()).sort();
+  for (const category of sortedCategories) {
+    const domains = categories.get(category) ?? [];
+    output.push(colorBoldWhite(`  ${category}`));
+    for (const domain of domains.sort(
+      (a, b) => a.name.localeCompare(b.name)
+    )) {
+      const aliases = domain.aliases.length > 0 ? colorDim(` (${domain.aliases.join(", ")})`) : "";
+      output.push(
+        `    ${domain.name.padEnd(24)} ${domain.descriptionShort}`
+      );
+      if (aliases) {
+        output.push(`    ${"".padEnd(24)} Aliases:${aliases}`);
+      }
+    }
+    output.push("");
+  }
+  return output;
+}
+function formatActionsHelp() {
+  return [
+    "",
+    colorBoldWhite("Available Actions"),
+    "",
+    "  list              List all resources in the namespace",
+    "  get               Get a specific resource by name",
+    "  create            Create a new resource from a file",
+    "  delete            Delete a resource by name",
+    "  replace           Replace a resource configuration",
+    "  apply             Apply configuration (create or update)",
+    "  status            Get resource status",
+    "  patch             Patch specific fields of a resource",
+    "  add-labels        Add labels to a resource",
+    "  remove-labels     Remove labels from a resource",
+    "",
+    "USAGE",
+    `  ${CLI_NAME} <domain> <action> [options]`,
+    "",
+    "EXAMPLES",
+    `  ${CLI_NAME} dns list`,
+    `  ${CLI_NAME} lb get my-loadbalancer`,
+    `  ${CLI_NAME} waf create my-policy -f policy.yaml`,
+    ""
+  ];
+}
+function formatNavigationHelp() {
+  return [
+    "",
+    colorBoldWhite("Navigation Commands"),
+    "",
+    "  <domain>          Navigate into a domain context",
+    "  /<domain>         Navigate directly to domain from anywhere",
+    "  ..                Go up one level in context",
+    "  /                 Return to root context",
+    "  back              Go up one level (same as ..)",
+    "  root              Return to root (same as /)",
+    "",
+    "CONTEXT DISPLAY",
+    "  context           Show current navigation context",
+    "  ctx               Alias for context",
+    "",
+    "EXAMPLES",
+    "  xcsh> dns                    # Enter dns domain",
+    "  dns> list                    # Execute list in dns context",
+    "  dns> ..                      # Return to root",
+    "  xcsh> /waf                   # Jump directly to waf",
+    "  waf> /dns                    # Jump from waf to dns",
+    ""
+  ];
+}
+function formatDomainsSection() {
+  const output = ["DOMAINS"];
+  const domains = Array.from(domainRegistry.values()).sort(
+    (a, b) => a.name.localeCompare(b.name)
+  );
+  const maxNameLen = Math.max(...domains.map((d) => d.name.length));
+  for (const domain of domains) {
+    const padding = " ".repeat(maxNameLen - domain.name.length + 2);
+    output.push(`  ${domain.name}${padding}${domain.descriptionShort}`);
+  }
+  return output;
+}
+function formatCustomDomainHelp(domain) {
+  const output = ["", colorBoldWhite(domain.name), ""];
+  output.push("DESCRIPTION");
+  output.push(...wrapText2(domain.description, 80, 2));
+  output.push("");
+  output.push("USAGE");
+  output.push(`  ${CLI_NAME} ${domain.name} <command> [options]`);
+  output.push("");
+  if (domain.subcommands.size > 0) {
+    output.push("SUBCOMMANDS");
+    for (const [name, group] of domain.subcommands) {
+      output.push(`  ${name.padEnd(16)} ${group.descriptionShort}`);
+    }
+    output.push("");
+  }
+  if (domain.commands.size > 0) {
+    output.push("COMMANDS");
+    for (const [name, cmd] of domain.commands) {
+      output.push(`  ${name.padEnd(16)} ${cmd.descriptionShort}`);
+    }
+    output.push("");
+  }
+  output.push(colorDim(`For global options, run: ${CLI_NAME} --help`));
+  output.push("");
+  return output;
+}
+function formatSubcommandHelp(domainName, subcommand) {
+  const output = [
+    "",
+    colorBoldWhite(`${domainName} ${subcommand.name}`),
+    ""
+  ];
+  output.push("DESCRIPTION");
+  output.push(...wrapText2(subcommand.description, 80, 2));
+  output.push("");
+  output.push("USAGE");
+  output.push(
+    `  ${CLI_NAME} ${domainName} ${subcommand.name} <command> [options]`
+  );
+  output.push("");
+  if (subcommand.commands.size > 0) {
+    output.push("COMMANDS");
+    for (const [name, cmd] of subcommand.commands) {
+      const usage = cmd.usage ? ` ${cmd.usage}` : "";
+      output.push(
+        `  ${name}${usage.padEnd(16 - name.length)} ${cmd.descriptionShort}`
+      );
+    }
+    output.push("");
+  }
+  output.push(
+    colorDim(`For domain help, run: ${CLI_NAME} ${domainName} --help`)
+  );
+  output.push("");
+  return output;
+}
+
 // src/domains/registry.ts
 var DomainRegistry = class {
   domains = /* @__PURE__ */ new Map();
@@ -47024,45 +47470,24 @@ var DomainRegistry = class {
     return suggestions;
   }
   /**
-   * Show help for a domain
+   * Show help for a domain using the unified help formatter.
+   * This ensures consistent professional formatting across all domains.
    */
   showDomainHelp(domain) {
-    const output = [`${domain.name} - ${domain.description}`, ``];
-    if (domain.subcommands.size > 0) {
-      output.push(`Subcommands:`);
-      for (const [name, group] of domain.subcommands) {
-        output.push(`  ${name}  ${group.description}`);
-      }
-      output.push(``);
-    }
-    if (domain.commands.size > 0) {
-      output.push(`Commands:`);
-      for (const [name, cmd] of domain.commands) {
-        output.push(`  ${name}  ${cmd.description}`);
-      }
-    }
     return {
-      output,
+      output: formatCustomDomainHelp(domain),
       shouldExit: false,
       shouldClear: false,
       contextChanged: false
     };
   }
   /**
-   * Show help for a subcommand group
+   * Show help for a subcommand group using the unified help formatter.
+   * This ensures consistent professional formatting across all subcommands.
    */
   showSubcommandHelp(domain, subgroup) {
-    const output = [
-      `${domain.name} ${subgroup.name} - ${subgroup.description}`,
-      ``,
-      `Commands:`
-    ];
-    for (const [name, cmd] of subgroup.commands) {
-      const usage = cmd.usage ? ` ${cmd.usage}` : "";
-      output.push(`  ${name}${usage}  ${cmd.description}`);
-    }
     return {
-      output,
+      output: formatSubcommandHelp(domain.name, subgroup),
       shouldExit: false,
       shouldClear: false,
       contextChanged: false
@@ -47542,77 +47967,21 @@ var listCommand2 = {
       return successResult(lines);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      return errorResult(`Failed to list namespaces: ${message}`);
-    }
-  }
-};
-var contextSubcommands = {
-  name: "context",
-  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],
-    ["list", listCommand2]
-  ])
-};
-
-// src/config/envvars.ts
-var EnvVarRegistry = [
-  {
-    name: `${ENV_PREFIX}_API_URL`,
-    description: "API endpoint URL",
-    relatedFlag: "",
-    required: true
-  },
-  {
-    name: `${ENV_PREFIX}_API_TOKEN`,
-    description: "API authentication token",
-    relatedFlag: "",
-    required: true
-  },
-  {
-    name: `${ENV_PREFIX}_NAMESPACE`,
-    description: "Default namespace",
-    relatedFlag: "-ns"
-  },
-  {
-    name: `${ENV_PREFIX}_OUTPUT_FORMAT`,
-    description: "Output format (json, yaml, table)",
-    relatedFlag: "-o"
-  },
-  {
-    name: `${ENV_PREFIX}_LOGO`,
-    description: "Logo display mode (auto, image, ascii, both, none)",
-    relatedFlag: "--logo"
-  },
-  {
-    name: "NO_COLOR",
-    description: "Disable color output",
-    relatedFlag: "--no-color"
-  }
-];
-function formatEnvVarsSection() {
-  const maxLen = Math.max(...EnvVarRegistry.map((e) => e.name.length));
-  const lines = ["ENVIRONMENT VARIABLES"];
-  for (const env3 of EnvVarRegistry) {
-    const padding = " ".repeat(maxLen - env3.name.length + 3);
-    const flagNote = env3.relatedFlag ? ` [${env3.relatedFlag}]` : "";
-    lines.push(`  ${env3.name}${padding}${env3.description}${flagNote}`);
+      return errorResult(`Failed to list namespaces: ${message}`);
+    }
   }
-  return lines;
-}
-function formatConfigSection() {
-  return [
-    "CONFIGURATION",
-    `  Config file:  ~/${CONFIG_FILE_NAME}`,
-    "  Priority:     CLI flags > environment variables > config file > defaults",
-    "",
-    "DOCUMENTATION",
-    `  ${DOCS_URL}`
-  ];
-}
+};
+var contextSubcommands = {
+  name: "context",
+  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],
+    ["list", listCommand2]
+  ])
+};
 
 // src/config/settings.ts
 var import_yaml2 = __toESM(require_dist(), 1);
@@ -50539,572 +50908,238 @@ function useCompletion(options) {
     if (!isShowing || suggestions.length === 0) return;
     setSelectedIndex(
       (current) => current < suggestions.length - 1 ? current + 1 : 0
-    );
-  }, [isShowing, suggestions.length]);
-  const selectCurrent = (0, import_react27.useCallback)(() => {
-    if (!isShowing || suggestions.length === 0) return null;
-    const selected = suggestions.at(selectedIndex);
-    hide();
-    return selected ?? null;
-  }, [isShowing, suggestions, selectedIndex, hide]);
-  return {
-    suggestions,
-    selectedIndex,
-    isShowing,
-    triggerCompletion,
-    navigateUp,
-    navigateDown,
-    selectCurrent,
-    hide,
-    filterSuggestions
-  };
-}
-
-// src/output/formatter.ts
-var import_yaml3 = __toESM(require_dist(), 1);
-function formatOutput(data, format = "yaml") {
-  if (format === "none") {
-    return "";
-  }
-  switch (format) {
-    case "json":
-      return formatJSON(data);
-    case "yaml":
-      return formatYAML(data);
-    case "table":
-    case "text":
-      return formatTable(data);
-    case "tsv":
-      return formatTSV(data);
-    default:
-      return formatYAML(data);
-  }
-}
-function formatJSON(data) {
-  return JSON.stringify(data, null, 2);
-}
-function formatYAML(data) {
-  return import_yaml3.default.stringify(data, { indent: 2 });
-}
-function extractItems(data) {
-  if (data && typeof data === "object" && "items" in data) {
-    const items = data.items;
-    if (Array.isArray(items)) {
-      return items.filter(
-        (item) => item !== null && typeof item === "object"
-      );
-    }
-  }
-  if (Array.isArray(data)) {
-    return data.filter(
-      (item) => item !== null && typeof item === "object"
-    );
-  }
-  if (data && typeof data === "object") {
-    return [data];
-  }
-  return [];
-}
-function getStringField(obj, key) {
-  const value = obj[key];
-  if (typeof value === "string") {
-    return value;
-  }
-  if (value !== null && value !== void 0) {
-    return String(value);
-  }
-  return "";
-}
-function formatLabels(obj) {
-  const labels = obj["labels"];
-  if (!labels || typeof labels !== "object") {
-    return "";
-  }
-  const labelMap = labels;
-  const entries = Object.entries(labelMap).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}:${v}`);
-  if (entries.length === 0) {
-    return "";
-  }
-  return `map[${entries.join(" ")}]`;
-}
-function wrapText2(text, maxWidth) {
-  if (text.length <= maxWidth) {
-    return [text];
-  }
-  const lines = [];
-  let remaining = text;
-  while (remaining.length > 0) {
-    if (remaining.length <= maxWidth) {
-      lines.push(remaining);
-      break;
-    }
-    let breakPoint = maxWidth;
-    for (let i = maxWidth - 1; i > 0; i--) {
-      if (remaining[i] === " ") {
-        breakPoint = i;
-        break;
-      }
-    }
-    lines.push(remaining.slice(0, breakPoint));
-    remaining = remaining.slice(breakPoint).trimStart();
-  }
-  return lines;
-}
-function formatTable(data) {
-  const items = extractItems(data);
-  if (items.length === 0) {
-    return "";
-  }
-  const headers = ["NAMESPACE", "NAME", "LABELS"];
-  const widths = [9, 27, 30];
-  const rows = [];
-  for (const item of items) {
-    const row = [
-      getStringField(item, "namespace") || "<None>",
-      getStringField(item, "name") || "<None>",
-      formatLabels(item) || "<None>"
-    ];
-    const wrappedCells = row.map((cell, i) => wrapText2(cell, widths[i]));
-    const maxLines = Math.max(...wrappedCells.map((c) => c.length));
-    const wrappedRows = [];
-    for (let line = 0; line < maxLines; line++) {
-      wrappedRows.push(wrappedCells.map((c) => c[line] ?? ""));
-    }
-    rows.push(wrappedRows);
-  }
-  const lines = [];
-  const boxLine = "+" + widths.map((w) => "-".repeat(w + 2)).join("+") + "+";
-  lines.push(boxLine);
-  lines.push(
-    "|" + headers.map((h, i) => {
-      const padding = widths[i] - h.length;
-      const leftPad = Math.floor(padding / 2);
-      const rightPad = padding - leftPad;
-      return " " + " ".repeat(leftPad) + h + " ".repeat(rightPad) + " ";
-    }).join("|") + "|"
-  );
-  lines.push(boxLine);
-  for (const wrappedRows of rows) {
-    for (const row of wrappedRows) {
-      lines.push(
-        "|" + row.map((cell, i) => {
-          const padding = widths[i] - cell.length;
-          return " " + cell + " ".repeat(padding) + " ";
-        }).join("|") + "|"
-      );
-    }
-    lines.push(boxLine);
-  }
-  return lines.join("\n");
-}
-function formatTSV(data) {
-  const items = extractItems(data);
-  if (items.length === 0) {
-    return "";
-  }
-  const allKeys = /* @__PURE__ */ new Set();
-  for (const item of items) {
-    Object.keys(item).forEach((k) => allKeys.add(k));
-  }
-  const priority = ["name", "namespace", "status", "created", "modified"];
-  const headers = [
-    ...priority.filter((p) => allKeys.has(p)),
-    ...[...allKeys].filter((k) => !priority.includes(k)).sort()
-  ];
-  const lines = [];
-  for (const item of items) {
-    const values = headers.map((h) => {
-      const val = item[h];
-      if (val === null || val === void 0) return "";
-      if (typeof val === "object") return JSON.stringify(val);
-      return String(val);
-    });
-    lines.push(values.join("	"));
-  }
-  return lines.join("\n");
-}
-function formatAPIError(statusCode, body, operation) {
-  const lines = [];
-  lines.push(`ERROR: ${operation} failed (HTTP ${statusCode})`);
-  if (body && typeof body === "object") {
-    const errResp = body;
-    if (errResp.message) {
-      lines.push(`  Message: ${errResp.message}`);
-    }
-    if (errResp.code) {
-      lines.push(`  Code: ${errResp.code}`);
-    }
-    if (errResp.details) {
-      lines.push(`  Details: ${errResp.details}`);
-    }
-  }
-  switch (statusCode) {
-    case 401:
-      lines.push(
-        "\nHint: Authentication failed. Check your credentials with 'login profile show'"
-      );
-      break;
-    case 403:
-      lines.push(
-        "\nHint: Permission denied. You may not have access to this resource."
-      );
-      break;
-    case 404:
-      lines.push(
-        "\nHint: Resource not found. Verify the name and namespace are correct."
-      );
-      break;
-    case 409:
-      lines.push(
-        "\nHint: Conflict - resource may already exist or be in a conflicting state."
-      );
-      break;
-    case 429:
-      lines.push("\nHint: Rate limited. Please wait and try again.");
-      break;
-    case 500:
-    case 502:
-    case 503:
-      lines.push(
-        "\nHint: Server error. Please try again later or contact support."
-      );
-      break;
-  }
-  return lines.join("\n");
+    );
+  }, [isShowing, suggestions.length]);
+  const selectCurrent = (0, import_react27.useCallback)(() => {
+    if (!isShowing || suggestions.length === 0) return null;
+    const selected = suggestions.at(selectedIndex);
+    hide();
+    return selected ?? null;
+  }, [isShowing, suggestions, selectedIndex, hide]);
+  return {
+    suggestions,
+    selectedIndex,
+    isShowing,
+    triggerCompletion,
+    navigateUp,
+    navigateDown,
+    selectCurrent,
+    hide,
+    filterSuggestions
+  };
 }
 
-// src/repl/help.ts
-function wrapText3(text, width, indent) {
-  const prefix = " ".repeat(indent);
-  const words = text.split(/\s+/);
-  const lines = [];
-  let currentLine = prefix;
-  for (const word of words) {
-    if (currentLine.length + word.length + 1 > width && currentLine !== prefix) {
-      lines.push(currentLine);
-      currentLine = prefix + word;
-    } else {
-      currentLine += (currentLine === prefix ? "" : " ") + word;
-    }
+// src/output/formatter.ts
+var import_yaml3 = __toESM(require_dist(), 1);
+function formatOutput(data, format = "yaml") {
+  if (format === "none") {
+    return "";
   }
-  if (currentLine.trim()) {
-    lines.push(currentLine);
+  switch (format) {
+    case "json":
+      return formatJSON(data);
+    case "yaml":
+      return formatYAML(data);
+    case "table":
+    case "text":
+      return formatTable(data);
+    case "tsv":
+      return formatTSV(data);
+    default:
+      return formatYAML(data);
   }
-  return lines;
-}
-function formatRootHelp() {
-  return [
-    "",
-    colorBoldWhite(`${CLI_NAME} - ${CLI_FULL_NAME} v${CLI_VERSION}`),
-    "",
-    "DESCRIPTION",
-    ...wrapText3(CLI_DESCRIPTION_LONG, 80, 2),
-    "",
-    "USAGE",
-    `  ${CLI_NAME}                              Enter interactive REPL mode`,
-    `  ${CLI_NAME} <domain> <action>            Execute command non-interactively`,
-    `  ${CLI_NAME} help [topic]                 Show help for a topic`,
-    "",
-    "EXAMPLES",
-    `  ${CLI_NAME} tenant_and_identity list namespace   List all namespaces`,
-    `  ${CLI_NAME} virtual get http_loadbalancer        Get a specific load balancer`,
-    `  ${CLI_NAME} dns list                             List DNS zones`,
-    `  ${CLI_NAME} waf list -ns prod                    List WAF policies in prod`,
-    `  ${CLI_NAME} --interactive                        Force interactive REPL mode`,
-    "",
-    ...formatDomainsSection(),
-    "",
-    ...formatGlobalFlags(),
-    "",
-    ...formatEnvVarsSection(),
-    "",
-    ...formatConfigSection(),
-    "",
-    "NAVIGATION (Interactive Mode)",
-    "  <domain>              Navigate into a domain (e.g., 'dns', 'lb')",
-    "  /domain               Navigate directly to domain from anywhere",
-    "  ..                    Go up one level",
-    "  /                     Return to root",
-    "  context               Show current navigation context",
-    "",
-    "BUILTINS",
-    "  help                  Show this help",
-    "  domains               List all available domains",
-    "  clear                 Clear the screen",
-    "  history               Show command history",
-    "  quit, exit            Exit the shell",
-    ""
-  ];
 }
-function formatGlobalFlags() {
-  return [
-    "GLOBAL FLAGS",
-    "  -v, --version         Show version number",
-    "  -h, --help            Show this help",
-    "  -i, --interactive     Force interactive mode",
-    "  --no-color            Disable color output",
-    "  -o, --output <fmt>    Output format (json, yaml, table)",
-    "  -ns, --namespace <ns> Target namespace"
-  ];
+function formatJSON(data) {
+  return JSON.stringify(data, null, 2);
 }
-function formatEnvironmentVariables() {
-  return formatEnvVarsSection();
+function formatYAML(data) {
+  return import_yaml3.default.stringify(data, { indent: 2 });
 }
-function formatDomainHelp(domain) {
-  const output = ["", colorBoldWhite(`${domain.displayName}`), ""];
-  output.push(`  ${domain.description}`);
-  output.push("");
-  if (domain.category || domain.complexity) {
-    const meta = [];
-    if (domain.category) meta.push(`Category: ${domain.category}`);
-    if (domain.complexity) meta.push(`Complexity: ${domain.complexity}`);
-    output.push(colorDim(`  ${meta.join("  |  ")}`));
-    output.push("");
-  }
-  output.push("USAGE");
-  output.push(`  ${CLI_NAME} ${domain.name} <action> [options]`);
-  output.push("");
-  output.push("ACTIONS");
-  const actionDescriptions2 = {
-    list: "List resources",
-    get: "Get a specific resource by name",
-    create: "Create a new resource",
-    delete: "Delete a resource",
-    replace: "Replace a resource configuration",
-    apply: "Apply configuration from file",
-    status: "Get resource status",
-    patch: "Patch a resource",
-    "add-labels": "Add labels to a resource",
-    "remove-labels": "Remove labels from a resource"
-  };
-  for (const action of validActions) {
-    const desc = actionDescriptions2[action] ?? action;
-    output.push(`  ${action.padEnd(16)} ${desc}`);
-  }
-  output.push("");
-  output.push("EXAMPLES");
-  output.push(`  ${CLI_NAME} ${domain.name} list`);
-  output.push(`  ${CLI_NAME} ${domain.name} get my-resource`);
-  output.push(
-    `  ${CLI_NAME} ${domain.name} create my-resource -f config.yaml`
-  );
-  output.push(`  ${CLI_NAME} ${domain.name} delete my-resource`);
-  output.push("");
-  if (domain.useCases && domain.useCases.length > 0) {
-    output.push("USE CASES");
-    for (const useCase of domain.useCases.slice(0, 5)) {
-      output.push(`  - ${useCase}`);
+function extractItems(data) {
+  if (data && typeof data === "object" && "items" in data) {
+    const items = data.items;
+    if (Array.isArray(items)) {
+      return items.filter(
+        (item) => item !== null && typeof item === "object"
+      );
     }
-    output.push("");
   }
-  if (domain.relatedDomains && domain.relatedDomains.length > 0) {
-    output.push("RELATED DOMAINS");
-    output.push(`  ${domain.relatedDomains.join(", ")}`);
-    output.push("");
+  if (Array.isArray(data)) {
+    return data.filter(
+      (item) => item !== null && typeof item === "object"
+    );
   }
-  if (domain.aliases && domain.aliases.length > 0) {
-    output.push("ALIASES");
-    output.push(`  ${domain.aliases.join(", ")}`);
-    output.push("");
+  if (data && typeof data === "object") {
+    return [data];
   }
-  output.push(colorDim(`For global options, run: ${CLI_NAME} --help`));
-  output.push("");
-  return output;
+  return [];
 }
-function formatActionHelp(domainName, action) {
-  const domain = getDomainInfo(domainName);
-  const displayDomain = domain?.displayName ?? domainName;
-  const actionDescriptions2 = {
-    list: {
-      desc: "List all resources in the namespace",
-      usage: `${CLI_NAME} ${domainName} list [--limit N] [--label key=value]`
-    },
-    get: {
-      desc: "Get a specific resource by name",
-      usage: `${CLI_NAME} ${domainName} get <name> [-o json|yaml|table]`
-    },
-    create: {
-      desc: "Create a new resource",
-      usage: `${CLI_NAME} ${domainName} create <name> -f <file.yaml>`
-    },
-    delete: {
-      desc: "Delete a resource by name",
-      usage: `${CLI_NAME} ${domainName} delete <name>`
-    },
-    replace: {
-      desc: "Replace an existing resource configuration",
-      usage: `${CLI_NAME} ${domainName} replace <name> -f <file.yaml>`
-    },
-    apply: {
-      desc: "Apply configuration from a file (create or update)",
-      usage: `${CLI_NAME} ${domainName} apply -f <file.yaml>`
-    },
-    status: {
-      desc: "Get the current status of a resource",
-      usage: `${CLI_NAME} ${domainName} status <name>`
-    },
-    patch: {
-      desc: "Patch specific fields of a resource",
-      usage: `${CLI_NAME} ${domainName} patch <name> -f <patch.yaml>`
-    },
-    "add-labels": {
-      desc: "Add labels to a resource",
-      usage: `${CLI_NAME} ${domainName} add-labels <name> key=value`
-    },
-    "remove-labels": {
-      desc: "Remove labels from a resource",
-      usage: `${CLI_NAME} ${domainName} remove-labels <name> key`
-    }
-  };
-  const actionInfo = actionDescriptions2[action] ?? {
-    desc: `Execute ${action} operation`,
-    usage: `${CLI_NAME} ${domainName} ${action} [options]`
-  };
-  return [
-    "",
-    colorBoldWhite(`${displayDomain} - ${action}`),
-    "",
-    `  ${actionInfo.desc}`,
-    "",
-    "USAGE",
-    `  ${actionInfo.usage}`,
-    "",
-    "OPTIONS",
-    "  -n, --name <name>     Resource name",
-    "  -ns, --namespace <ns> Target namespace",
-    "  -o, --output <fmt>    Output format (json, yaml, table)",
-    "  -f, --file <path>     Configuration file",
-    "",
-    colorDim(`For domain help, run: ${CLI_NAME} ${domainName} --help`),
-    ""
-  ];
+function getStringField(obj, key) {
+  const value = obj[key];
+  if (typeof value === "string") {
+    return value;
+  }
+  if (value !== null && value !== void 0) {
+    return String(value);
+  }
+  return "";
 }
-function formatTopicHelp(topic) {
-  const lowerTopic = topic.toLowerCase();
-  const domainInfo = getDomainInfo(lowerTopic);
-  if (domainInfo) {
-    return formatDomainHelp(domainInfo);
+function formatLabels(obj) {
+  const labels = obj["labels"];
+  if (!labels || typeof labels !== "object") {
+    return "";
   }
-  switch (lowerTopic) {
-    case "domains":
-      return formatDomainsHelp();
-    case "actions":
-      return formatActionsHelp();
-    case "navigation":
-    case "nav":
-      return formatNavigationHelp();
-    case "env":
-    case "environment":
-      return ["", ...formatEnvironmentVariables(), ""];
-    case "flags":
-      return ["", ...formatGlobalFlags(), ""];
-    default:
-      return [
-        "",
-        `Unknown help topic: ${topic}`,
-        "",
-        "Available topics:",
-        "  domains      List all available domains",
-        "  actions      List available actions",
-        "  navigation   Navigation commands",
-        "  env          Environment variables",
-        "  flags        Global flags",
-        "  <domain>     Help for a specific domain (e.g., 'help dns')",
-        ""
-      ];
+  const labelMap = labels;
+  const entries = Object.entries(labelMap).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}:${v}`);
+  if (entries.length === 0) {
+    return "";
   }
+  return `map[${entries.join(" ")}]`;
 }
-function formatDomainsHelp() {
-  const output = ["", colorBoldWhite("Available Domains"), ""];
-  const categories = /* @__PURE__ */ new Map();
-  for (const domain of domainRegistry.values()) {
-    const category = domain.category ?? "Other";
-    if (!categories.has(category)) {
-      categories.set(category, []);
-    }
-    categories.get(category)?.push(domain);
+function wrapText3(text, maxWidth) {
+  if (text.length <= maxWidth) {
+    return [text];
   }
-  const sortedCategories = Array.from(categories.keys()).sort();
-  for (const category of sortedCategories) {
-    const domains = categories.get(category) ?? [];
-    output.push(colorBoldWhite(`  ${category}`));
-    for (const domain of domains.sort(
-      (a, b) => a.name.localeCompare(b.name)
-    )) {
-      const aliases = domain.aliases.length > 0 ? colorDim(` (${domain.aliases.join(", ")})`) : "";
-      output.push(
-        `    ${domain.name.padEnd(24)} ${domain.descriptionShort}`
-      );
-      if (aliases) {
-        output.push(`    ${"".padEnd(24)} Aliases:${aliases}`);
+  const lines = [];
+  let remaining = text;
+  while (remaining.length > 0) {
+    if (remaining.length <= maxWidth) {
+      lines.push(remaining);
+      break;
+    }
+    let breakPoint = maxWidth;
+    for (let i = maxWidth - 1; i > 0; i--) {
+      if (remaining[i] === " ") {
+        breakPoint = i;
+        break;
       }
     }
-    output.push("");
+    lines.push(remaining.slice(0, breakPoint));
+    remaining = remaining.slice(breakPoint).trimStart();
   }
-  return output;
+  return lines;
 }
-function formatActionsHelp() {
-  return [
-    "",
-    colorBoldWhite("Available Actions"),
-    "",
-    "  list              List all resources in the namespace",
-    "  get               Get a specific resource by name",
-    "  create            Create a new resource from a file",
-    "  delete            Delete a resource by name",
-    "  replace           Replace a resource configuration",
-    "  apply             Apply configuration (create or update)",
-    "  status            Get resource status",
-    "  patch             Patch specific fields of a resource",
-    "  add-labels        Add labels to a resource",
-    "  remove-labels     Remove labels from a resource",
-    "",
-    "USAGE",
-    `  ${CLI_NAME} <domain> <action> [options]`,
-    "",
-    "EXAMPLES",
-    `  ${CLI_NAME} dns list`,
-    `  ${CLI_NAME} lb get my-loadbalancer`,
-    `  ${CLI_NAME} waf create my-policy -f policy.yaml`,
-    ""
-  ];
+function formatTable(data) {
+  const items = extractItems(data);
+  if (items.length === 0) {
+    return "";
+  }
+  const headers = ["NAMESPACE", "NAME", "LABELS"];
+  const widths = [9, 27, 30];
+  const rows = [];
+  for (const item of items) {
+    const row = [
+      getStringField(item, "namespace") || "<None>",
+      getStringField(item, "name") || "<None>",
+      formatLabels(item) || "<None>"
+    ];
+    const wrappedCells = row.map((cell, i) => wrapText3(cell, widths[i]));
+    const maxLines = Math.max(...wrappedCells.map((c) => c.length));
+    const wrappedRows = [];
+    for (let line = 0; line < maxLines; line++) {
+      wrappedRows.push(wrappedCells.map((c) => c[line] ?? ""));
+    }
+    rows.push(wrappedRows);
+  }
+  const lines = [];
+  const boxLine = "+" + widths.map((w) => "-".repeat(w + 2)).join("+") + "+";
+  lines.push(boxLine);
+  lines.push(
+    "|" + headers.map((h, i) => {
+      const padding = widths[i] - h.length;
+      const leftPad = Math.floor(padding / 2);
+      const rightPad = padding - leftPad;
+      return " " + " ".repeat(leftPad) + h + " ".repeat(rightPad) + " ";
+    }).join("|") + "|"
+  );
+  lines.push(boxLine);
+  for (const wrappedRows of rows) {
+    for (const row of wrappedRows) {
+      lines.push(
+        "|" + row.map((cell, i) => {
+          const padding = widths[i] - cell.length;
+          return " " + cell + " ".repeat(padding) + " ";
+        }).join("|") + "|"
+      );
+    }
+    lines.push(boxLine);
+  }
+  return lines.join("\n");
 }
-function formatNavigationHelp() {
-  return [
-    "",
-    colorBoldWhite("Navigation Commands"),
-    "",
-    "  <domain>          Navigate into a domain context",
-    "  /<domain>         Navigate directly to domain from anywhere",
-    "  ..                Go up one level in context",
-    "  /                 Return to root context",
-    "  back              Go up one level (same as ..)",
-    "  root              Return to root (same as /)",
-    "",
-    "CONTEXT DISPLAY",
-    "  context           Show current navigation context",
-    "  ctx               Alias for context",
-    "",
-    "EXAMPLES",
-    "  xcsh> dns                    # Enter dns domain",
-    "  dns> list                    # Execute list in dns context",
-    "  dns> ..                      # Return to root",
-    "  xcsh> /waf                   # Jump directly to waf",
-    "  waf> /dns                    # Jump from waf to dns",
-    ""
+function formatTSV(data) {
+  const items = extractItems(data);
+  if (items.length === 0) {
+    return "";
+  }
+  const allKeys = /* @__PURE__ */ new Set();
+  for (const item of items) {
+    Object.keys(item).forEach((k) => allKeys.add(k));
+  }
+  const priority = ["name", "namespace", "status", "created", "modified"];
+  const headers = [
+    ...priority.filter((p) => allKeys.has(p)),
+    ...[...allKeys].filter((k) => !priority.includes(k)).sort()
   ];
+  const lines = [];
+  for (const item of items) {
+    const values = headers.map((h) => {
+      const val = item[h];
+      if (val === null || val === void 0) return "";
+      if (typeof val === "object") return JSON.stringify(val);
+      return String(val);
+    });
+    lines.push(values.join("	"));
+  }
+  return lines.join("\n");
 }
-function formatDomainsSection() {
-  const output = ["DOMAINS"];
-  const domains = Array.from(domainRegistry.values()).sort(
-    (a, b) => a.name.localeCompare(b.name)
-  );
-  const maxNameLen = Math.max(...domains.map((d) => d.name.length));
-  for (const domain of domains) {
-    const padding = " ".repeat(maxNameLen - domain.name.length + 2);
-    output.push(`  ${domain.name}${padding}${domain.descriptionShort}`);
+function formatAPIError(statusCode, body, operation) {
+  const lines = [];
+  lines.push(`ERROR: ${operation} failed (HTTP ${statusCode})`);
+  if (body && typeof body === "object") {
+    const errResp = body;
+    if (errResp.message) {
+      lines.push(`  Message: ${errResp.message}`);
+    }
+    if (errResp.code) {
+      lines.push(`  Code: ${errResp.code}`);
+    }
+    if (errResp.details) {
+      lines.push(`  Details: ${errResp.details}`);
+    }
   }
-  return output;
+  switch (statusCode) {
+    case 401:
+      lines.push(
+        "\nHint: Authentication failed. Check your credentials with 'login profile show'"
+      );
+      break;
+    case 403:
+      lines.push(
+        "\nHint: Permission denied. You may not have access to this resource."
+      );
+      break;
+    case 404:
+      lines.push(
+        "\nHint: Resource not found. Verify the name and namespace are correct."
+      );
+      break;
+    case 409:
+      lines.push(
+        "\nHint: Conflict - resource may already exist or be in a conflicting state."
+      );
+      break;
+    case 429:
+      lines.push("\nHint: Rate limited. Please wait and try again.");
+      break;
+    case 500:
+    case 502:
+    case 503:
+      lines.push(
+        "\nHint: Server error. Please try again later or contact support."
+      );
+      break;
+  }
+  return lines.join("\n");
 }
 
 // src/repl/executor.ts