@robinmordasiewicz/f5xc-xcsh 6.43.0 → 6.45.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.43.0") {
-    return "6.43.0";
+  if ("6.45.0") {
+    return "6.45.0";
   }
   if (process.env.XCSH_VERSION) {
     return process.env.XCSH_VERSION;
@@ -46540,1819 +46540,2113 @@ function formatAPIError(statusCode, body, operation) {
   return lines.join("\n");
 }
 
-// src/output/spec.ts
-function buildCommandSpec(options) {
-  const spec = {
-    command: options.command,
-    description: options.description,
-    usage: options.usage ?? `xcsh ${options.command} [options]`,
-    flags: options.flags ?? [],
-    examples: options.examples ?? [],
-    outputFormats: options.outputFormats ?? ["table", "json", "yaml"]
-  };
-  if (options.related !== void 0) {
-    spec.related = options.related;
+// 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"
   }
-  if (options.category !== void 0) {
-    spec.category = options.category;
+];
+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 spec;
+  return lines;
 }
-function formatSpec(spec) {
-  return JSON.stringify(spec, null, 2);
+function formatConfigSection() {
+  return [
+    "CONFIGURATION",
+    `  Config file:  ~/${CONFIG_FILE_NAME}`,
+    "  Priority:     CLI flags > environment variables > config file > defaults",
+    "",
+    "DOCUMENTATION",
+    `  ${DOCS_URL}`
+  ];
 }
-function buildCloudstatusSpecs() {
-  return {
-    status: buildCommandSpec({
-      command: "cloudstatus status",
-      description: "Get the overall health indicator for F5 Distributed Cloud services. Returns status level (operational, degraded, major outage) with description.",
-      usage: "xcsh cloudstatus status [--quiet]",
-      flags: [
-        {
-          name: "--quiet",
-          alias: "-q",
-          description: "Return exit code only (0=operational, 1=degraded, 2=outage)",
-          type: "boolean"
-        }
-      ],
-      examples: [
-        {
-          command: "xcsh cloudstatus status",
-          description: "Check current F5 XC service status"
-        },
-        {
-          command: "xcsh cloudstatus status --quiet && echo 'All systems operational'",
-          description: "Use in scripts for health checks"
-        },
-        {
-          command: "xcsh cloudstatus status --output json",
-          description: "Get status as JSON for automation"
-        }
-      ],
-      category: "cloudstatus",
-      related: [
-        "cloudstatus summary",
-        "cloudstatus components",
-        "cloudstatus incidents"
-      ]
-    }),
-    summary: buildCommandSpec({
-      command: "cloudstatus summary",
-      description: "Get complete status summary including overall health, component status, and active incidents.",
-      usage: "xcsh cloudstatus summary",
-      examples: [
-        {
-          command: "xcsh cloudstatus summary",
-          description: "View full infrastructure health overview"
-        },
-        {
-          command: "xcsh cloudstatus summary --output json",
-          description: "Get complete summary as JSON"
-        }
-      ],
-      category: "cloudstatus",
-      related: ["cloudstatus status", "cloudstatus components"]
-    }),
-    components: buildCommandSpec({
-      command: "cloudstatus components",
-      description: "List all infrastructure components and their current operational status.",
-      usage: "xcsh cloudstatus components",
-      examples: [
-        {
-          command: "xcsh cloudstatus components",
-          description: "List all components with status"
-        },
-        {
-          command: "xcsh cloudstatus components --output json",
-          description: "Get components as JSON for monitoring integration"
-        }
-      ],
-      category: "cloudstatus",
-      related: ["cloudstatus status", "cloudstatus summary"]
-    }),
-    incidents: buildCommandSpec({
-      command: "cloudstatus incidents",
-      description: "List active and recent incidents affecting F5 Distributed Cloud services.",
-      usage: "xcsh cloudstatus incidents",
-      examples: [
-        {
-          command: "xcsh cloudstatus incidents",
-          description: "View active incidents"
-        },
-        {
-          command: "xcsh cloudstatus incidents --output json",
-          description: "Get incidents as JSON for alerting systems"
-        }
-      ],
-      category: "cloudstatus",
-      related: ["cloudstatus status", "cloudstatus maintenance"]
-    }),
-    maintenance: buildCommandSpec({
-      command: "cloudstatus maintenance",
-      description: "List scheduled maintenance windows for F5 Distributed Cloud services.",
-      usage: "xcsh cloudstatus maintenance",
-      examples: [
-        {
-          command: "xcsh cloudstatus maintenance",
-          description: "View upcoming maintenance windows"
-        },
-        {
-          command: "xcsh cloudstatus maintenance --output json",
-          description: "Get maintenance schedule as JSON"
-        }
-      ],
-      category: "cloudstatus",
-      related: ["cloudstatus status", "cloudstatus incidents"]
-    })
-  };
+
+// src/repl/help.ts
+function wrapText3(text, width, indent) {
+  const prefix = " ".repeat(indent);
+  const words = text.split(/\s+/);
+  const lines = [];
+  let currentLine = prefix;
+  for (const word of words) {
+    if (currentLine.length + word.length + 1 > width && currentLine !== prefix) {
+      lines.push(currentLine);
+      currentLine = prefix + word;
+    } else {
+      currentLine += (currentLine === prefix ? "" : " ") + word;
+    }
+  }
+  if (currentLine.trim()) {
+    lines.push(currentLine);
+  }
+  return lines;
 }
-function buildLoginSpecs() {
-  return {
-    banner: buildCommandSpec({
-      command: "login banner",
-      description: "Display xcsh banner with logo and connection information.",
-      usage: "xcsh login banner",
-      examples: [
-        {
-          command: "xcsh login banner",
-          description: "Show the xcsh welcome banner"
-        }
-      ],
-      category: "login",
-      related: ["login profile show"]
-    }),
-    "profile list": buildCommandSpec({
-      command: "login profile list",
-      description: "List all saved connection profiles.",
-      usage: "xcsh login profile list",
-      examples: [
-        {
-          command: "xcsh login profile list",
-          description: "List saved profiles"
-        },
-        {
-          command: "xcsh login profile list --output json",
-          description: "Get profiles as JSON"
-        }
-      ],
-      category: "login",
-      related: [
-        "login profile show",
-        "login profile create",
-        "login profile use"
-      ]
-    }),
-    "profile show": buildCommandSpec({
-      command: "login profile show",
-      description: "Show current connection profile and authentication status.",
-      usage: "xcsh login profile show [name]",
-      flags: [
-        {
-          name: "name",
-          description: "Profile name to show (optional, defaults to active)",
-          type: "string"
-        }
-      ],
-      examples: [
-        {
-          command: "xcsh login profile show",
-          description: "Show active profile"
-        },
-        {
-          command: "xcsh login profile show production",
-          description: "Show specific profile"
-        }
-      ],
-      category: "login",
-      related: ["login profile list", "login profile use"]
-    }),
-    "profile create": buildCommandSpec({
-      command: "login profile create",
-      description: "Create a new connection profile with URL and credentials.",
-      usage: "xcsh login profile create <name>",
-      flags: [
-        {
-          name: "name",
-          description: "Profile name",
-          type: "string",
-          required: true
-        }
-      ],
-      examples: [
-        {
-          command: "xcsh login profile create production",
-          description: "Create a new profile named 'production'"
-        }
-      ],
-      category: "login",
-      related: ["login profile list", "login profile use"]
-    }),
-    "profile use": buildCommandSpec({
-      command: "login profile use",
-      description: "Switch to a different connection profile.",
-      usage: "xcsh login profile use <name>",
-      flags: [
-        {
-          name: "name",
-          description: "Profile name to activate",
-          type: "string",
-          required: true
-        }
-      ],
-      examples: [
-        {
-          command: "xcsh login profile use staging",
-          description: "Switch to staging profile"
-        }
-      ],
-      category: "login",
-      related: ["login profile list", "login profile show"]
-    }),
-    "context show": buildCommandSpec({
-      command: "login context show",
-      description: "Show the current default namespace context.",
-      usage: "xcsh login context show",
-      examples: [
-        {
-          command: "xcsh login context show",
-          description: "Display current namespace"
-        }
-      ],
-      category: "login",
-      related: ["login context set", "login context list"]
-    }),
-    "context set": buildCommandSpec({
-      command: "login context set",
-      description: "Set the default namespace for subsequent operations.",
-      usage: "xcsh login context set <namespace>",
-      flags: [
-        {
-          name: "namespace",
-          description: "Namespace to set as default",
-          type: "string",
-          required: true
-        }
-      ],
-      examples: [
-        {
-          command: "xcsh login context set production",
-          description: "Set production as default namespace"
-        }
-      ],
-      category: "login",
-      related: ["login context show", "login context list"]
-    })
-  };
+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`,
+    "",
+    ...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 getCommandSpec(commandPath) {
-  const cloudstatusSpecs = buildCloudstatusSpecs();
-  const loginSpecs = buildLoginSpecs();
-  const normalized = commandPath.toLowerCase().trim();
-  if (normalized.startsWith("cloudstatus ")) {
-    const subcommand = normalized.replace("cloudstatus ", "");
-    return cloudstatusSpecs[subcommand];
+function formatGlobalFlags() {
+  return [
+    "GLOBAL FLAGS",
+    "  -v, --version         Show version number",
+    "  -h, --help            Show this help",
+    "  --no-color            Disable color output",
+    "  -o, --output <fmt>    Output format (json, yaml, table)",
+    "  -ns, --namespace <ns> Target namespace",
+    "  --spec                Output command specification as JSON (for AI)"
+  ];
+}
+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("");
   }
-  if (normalized.startsWith("login ")) {
-    const subcommand = normalized.replace("login ", "");
-    return loginSpecs[subcommand];
+  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}`);
   }
-  return void 0;
-}
-
-// src/repl/session.ts
-var NAMESPACE_CACHE_TTL = 5 * 60 * 1e3;
-var REPLSession = class {
-  _history = null;
-  _namespace;
-  _lastExitCode = 0;
-  _contextPath;
-  _tenant = "";
-  _username = "";
-  _validator;
-  _serverUrl = "";
-  _apiToken = "";
-  _apiClient = null;
-  _outputFormat = "table";
-  _debug = false;
-  _profileManager;
-  _activeProfile = null;
-  _activeProfileName = null;
-  _namespaceCache = [];
-  _namespaceCacheTime = 0;
-  // Token validation state
-  _tokenValidated = false;
-  _validationError = null;
-  constructor(config = {}) {
-    this._namespace = config.namespace ?? this.getDefaultNamespace();
-    this._contextPath = new ContextPath();
-    this._validator = new ContextValidator();
-    this._profileManager = getProfileManager();
-    this._serverUrl = config.serverUrl ?? process.env[`${ENV_PREFIX}_API_URL`] ?? "";
-    this._apiToken = config.apiToken ?? process.env[`${ENV_PREFIX}_API_TOKEN`] ?? "";
-    this._outputFormat = config.outputFormat ?? getOutputFormatFromEnv() ?? "table";
-    this._debug = config.debug ?? process.env[`${ENV_PREFIX}_DEBUG`] === "true";
-    if (this._serverUrl) {
-      this._tenant = this.extractTenant(this._serverUrl);
-    }
-    if (this._serverUrl) {
-      this._apiClient = new APIClient({
-        serverUrl: this._serverUrl,
-        apiToken: this._apiToken,
-        debug: this._debug
-      });
+  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("");
   }
-  /**
-   * Initialize the session (async operations)
-   */
-  async initialize() {
-    try {
-      this._history = await HistoryManager.create(
-        getHistoryFilePath(),
-        1e3
-      );
-    } catch (error) {
-      console.error("Warning: could not initialize history:", error);
-      this._history = new HistoryManager(getHistoryFilePath(), 1e3);
-    }
-    await this.loadActiveProfile();
-    if (this._apiClient?.isAuthenticated()) {
-      const result = await this._apiClient.validateToken();
-      this._tokenValidated = result.valid;
-      this._validationError = result.error ?? null;
-      if (result.valid) {
-        await this.fetchUserInfo();
-      }
-    }
+  if (domain.relatedDomains && domain.relatedDomains.length > 0) {
+    output.push("RELATED DOMAINS");
+    output.push(`  ${domain.relatedDomains.join(", ")}`);
+    output.push("");
   }
-  /**
-   * Fetch user info from the API
-   */
-  async fetchUserInfo() {
-    if (!this._apiClient) return;
-    try {
-      const response = await this._apiClient.get("/api/web/custom/user/info");
-      if (response.ok && response.data) {
-        this._username = response.data.email || response.data.name || response.data.username || "";
-      }
-    } catch {
-    }
+  if (domain.aliases && domain.aliases.length > 0) {
+    output.push("ALIASES");
+    output.push(`  ${domain.aliases.join(", ")}`);
+    output.push("");
   }
-  /**
-   * Load the active profile from profile manager
-   * Note: Environment variables take priority over profile settings
-   * If no active profile is set but exactly one profile exists, auto-activate it
-   */
-  async loadActiveProfile() {
-    try {
-      let activeName = await this._profileManager.getActive();
-      if (!activeName) {
-        const profiles = await this._profileManager.list();
-        if (profiles.length === 1 && profiles[0]) {
-          const singleProfile = profiles[0];
-          await this._profileManager.setActive(singleProfile.name);
-          activeName = singleProfile.name;
-        }
-      }
-      if (activeName) {
-        const profile = await this._profileManager.get(activeName);
-        if (profile) {
-          this._activeProfileName = activeName;
-          this._activeProfile = profile;
-          const envUrl = process.env[`${ENV_PREFIX}_API_URL`];
-          const envToken = process.env[`${ENV_PREFIX}_API_TOKEN`];
-          const envNamespace = process.env[`${ENV_PREFIX}_NAMESPACE`];
-          if (!envUrl && profile.apiUrl) {
-            this._serverUrl = profile.apiUrl;
-            this._tenant = this.extractTenant(profile.apiUrl);
-          }
-          if (!envToken && profile.apiToken) {
-            this._apiToken = profile.apiToken;
-          }
-          if (!envNamespace && profile.defaultNamespace) {
-            this._namespace = profile.defaultNamespace;
-          }
-          if (this._serverUrl) {
-            this._apiClient = new APIClient({
-              serverUrl: this._serverUrl,
-              apiToken: this._apiToken,
-              debug: this._debug
-            });
-          }
-        }
-      }
-    } catch {
+  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);
   }
-  /**
-   * Get the default namespace from environment or config
-   */
-  getDefaultNamespace() {
-    return process.env[`${ENV_PREFIX}_NAMESPACE`] ?? "default";
+  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')",
+        ""
+      ];
   }
-  /**
-   * Extract tenant name from server URL
-   */
-  extractTenant(url) {
-    try {
-      const parsed = new URL(url);
-      const hostname = parsed.hostname;
-      const parts = hostname.split(".");
-      if (parts.length > 0 && parts[0]) {
-        return parts[0];
-      }
-      return hostname;
-    } catch {
-      return "";
+}
+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);
   }
-  /**
-   * Set the default namespace for the session
-   */
-  setNamespace(ns) {
-    this._namespace = ns;
-  }
-  /**
-   * Get the current default namespace
-   */
-  getNamespace() {
-    return this._namespace;
-  }
-  /**
-   * Get the exit code of the last command
-   */
-  getLastExitCode() {
-    return this._lastExitCode;
-  }
-  /**
-   * Set the exit code of the last command
-   */
-  setLastExitCode(code) {
-    this._lastExitCode = code;
-  }
-  /**
-   * Get the current navigation context
-   */
-  getContextPath() {
-    return this._contextPath;
-  }
-  /**
-   * Get the current tenant name
-   */
-  getTenant() {
-    return this._tenant;
-  }
-  /**
-   * Get the logged-in user's name/email
-   */
-  getUsername() {
-    return this._username;
-  }
-  /**
-   * Set the username (used when fetched from API)
-   */
-  setUsername(username) {
-    this._username = username;
-  }
-  /**
-   * Get the context validator
-   */
-  getValidator() {
-    return this._validator;
+  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("");
   }
-  /**
-   * Get the history manager
-   */
-  getHistory() {
-    return this._history;
-  }
-  /**
-   * Get the server URL
-   */
-  getServerUrl() {
-    return this._serverUrl;
-  }
-  /**
-   * Check if connected to an API server
-   */
-  isConnected() {
-    return this._serverUrl !== "" && this._apiClient !== null;
-  }
-  /**
-   * Check if authenticated with API
-   */
-  isAuthenticated() {
-    return this._apiClient?.isAuthenticated() ?? false;
-  }
-  /**
-   * Check if the token has been validated (verified working)
-   */
-  isTokenValidated() {
-    return this._tokenValidated;
+  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}`);
   }
-  /**
-   * Get the token validation error, if any
-   */
-  getValidationError() {
-    return this._validationError;
+  return output;
+}
+function formatCustomDomainHelp(domain) {
+  const output = ["", colorBoldWhite(domain.name), ""];
+  output.push("DESCRIPTION");
+  output.push(...wrapText3(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("");
   }
-  /**
-   * Get the API client
-   */
-  getAPIClient() {
-    return this._apiClient;
+  if (domain.commands.size > 0) {
+    output.push("COMMANDS");
+    for (const [name, cmd] of domain.commands) {
+      output.push(`  ${name.padEnd(16)} ${cmd.descriptionShort}`);
+    }
+    output.push("");
   }
-  /**
-   * Get the current output format
-   */
-  getOutputFormat() {
-    return this._outputFormat;
+  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(...wrapText3(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();
   /**
-   * Set the output format
+   * Register a custom domain
    */
-  setOutputFormat(format) {
-    this._outputFormat = format;
+  register(domain) {
+    this.domains.set(domain.name, domain);
   }
   /**
-   * Get debug mode status
+   * Check if a domain is registered
    */
-  isDebug() {
-    return this._debug;
+  has(name) {
+    return this.domains.has(name);
   }
   /**
-   * Get the profile manager
+   * Get a domain by name
    */
-  getProfileManager() {
-    return this._profileManager;
+  get(name) {
+    return this.domains.get(name);
   }
   /**
-   * Get the active profile
+   * Get all registered domain names
    */
-  getActiveProfile() {
-    return this._activeProfile;
+  list() {
+    return Array.from(this.domains.keys());
   }
   /**
-   * Get the active profile name
+   * Get all domains
    */
-  getActiveProfileName() {
-    return this._activeProfileName;
+  all() {
+    return Array.from(this.domains.values());
   }
   /**
-   * Switch to a different profile
+   * Execute a command within a domain
+   * Handles routing through subcommand groups
+   *
+   * @param domainName - Name of the domain (e.g., "login")
+   * @param args - Command arguments (e.g., ["profile", "list"])
+   * @param session - REPL session
    */
-  async switchProfile(profileName) {
-    const profile = await this._profileManager.get(profileName);
-    if (!profile) {
-      return false;
-    }
-    const result = await this._profileManager.setActive(profileName);
-    if (!result.success) {
-      return false;
-    }
-    this.clearNamespaceCache();
-    this._tokenValidated = false;
-    this._validationError = null;
-    this._activeProfileName = profileName;
-    this._activeProfile = profile;
-    if (profile.apiUrl) {
-      this._serverUrl = profile.apiUrl;
-      this._tenant = this.extractTenant(profile.apiUrl);
-    }
-    if (profile.apiToken) {
-      this._apiToken = profile.apiToken;
-    }
-    if (profile.defaultNamespace) {
-      this._namespace = profile.defaultNamespace;
+  async execute(domainName, args, session) {
+    const domain = this.domains.get(domainName);
+    if (!domain) {
+      return {
+        output: [`Unknown domain: ${domainName}`],
+        shouldExit: false,
+        shouldClear: false,
+        contextChanged: false,
+        error: "Unknown domain"
+      };
     }
-    if (this._serverUrl) {
-      this._apiClient = new APIClient({
-        serverUrl: this._serverUrl,
-        apiToken: this._apiToken,
-        debug: this._debug
-      });
-      if (this._apiClient.isAuthenticated()) {
-        const validationResult = await this._apiClient.validateToken();
-        this._tokenValidated = validationResult.valid;
-        this._validationError = validationResult.error ?? null;
+    if (args.length === 0) {
+      if (domain.defaultCommand) {
+        return domain.defaultCommand.execute([], session);
       }
-    } else {
-      this._apiClient = null;
+      return this.showDomainHelp(domain);
     }
-    return true;
-  }
-  /**
-   * Clear the active profile
-   */
-  clearActiveProfile() {
-    this._activeProfileName = null;
-    this._activeProfile = null;
-  }
-  /**
-   * Get cached namespaces (returns empty array if cache is stale/empty)
-   */
-  getNamespaceCache() {
-    const now = Date.now();
-    if (this._namespaceCache.length > 0 && now - this._namespaceCacheTime < NAMESPACE_CACHE_TTL) {
-      return this._namespaceCache;
+    const firstArg = args[0]?.toLowerCase() ?? "";
+    const restArgs = args.slice(1);
+    if (firstArg === "--help" || firstArg === "-h" || firstArg === "help") {
+      return this.showDomainHelp(domain);
     }
-    return [];
-  }
-  /**
-   * Set namespace cache
-   */
-  setNamespaceCache(namespaces) {
-    this._namespaceCache = namespaces;
-    this._namespaceCacheTime = Date.now();
-  }
-  /**
-   * Clear namespace cache (called when switching profiles)
-   */
-  clearNamespaceCache() {
-    this._namespaceCache = [];
-    this._namespaceCacheTime = 0;
+    const subgroup = domain.subcommands.get(firstArg);
+    if (subgroup) {
+      if (restArgs.length === 0) {
+        if (subgroup.defaultCommand) {
+          return subgroup.defaultCommand.execute([], session);
+        }
+        return this.showSubcommandHelp(domain, subgroup);
+      }
+      const cmdName = restArgs[0]?.toLowerCase() ?? "";
+      if (cmdName === "--help" || cmdName === "-h" || cmdName === "help") {
+        return this.showSubcommandHelp(domain, subgroup);
+      }
+      const cmdArgs = restArgs.slice(1);
+      const cmd2 = subgroup.commands.get(cmdName);
+      if (cmd2) {
+        return cmd2.execute(cmdArgs, session);
+      }
+      for (const [, command] of subgroup.commands) {
+        if (command.aliases?.includes(cmdName)) {
+          return command.execute(cmdArgs, session);
+        }
+      }
+      return {
+        output: [
+          `Unknown command: ${domainName} ${firstArg} ${cmdName}`,
+          ``,
+          `Run '${domainName} ${firstArg}' for available commands.`
+        ],
+        shouldExit: false,
+        shouldClear: false,
+        contextChanged: false,
+        error: "Unknown command"
+      };
+    }
+    const cmd = domain.commands.get(firstArg);
+    if (cmd) {
+      return cmd.execute(restArgs, session);
+    }
+    for (const [, command] of domain.commands) {
+      if (command.aliases?.includes(firstArg)) {
+        return command.execute(restArgs, session);
+      }
+    }
+    return {
+      output: [
+        `Unknown command: ${domainName} ${firstArg}`,
+        ``,
+        `Run '${domainName}' for available commands.`
+      ],
+      shouldExit: false,
+      shouldClear: false,
+      contextChanged: false,
+      error: "Unknown command"
+    };
   }
   /**
-   * Add a command to history
+   * Get completions for a domain command
    */
-  addToHistory(cmd) {
-    this._history?.add(cmd);
+  async getCompletions(domainName, args, partial, session) {
+    const domain = this.domains.get(domainName);
+    if (!domain) {
+      return [];
+    }
+    const suggestions = [];
+    if (args.length === 0) {
+      for (const [name, group] of domain.subcommands) {
+        if (name.toLowerCase().startsWith(partial.toLowerCase())) {
+          suggestions.push({
+            text: name,
+            description: group.descriptionShort,
+            category: "subcommand"
+          });
+        }
+      }
+      for (const [name, cmd] of domain.commands) {
+        if (name.toLowerCase().startsWith(partial.toLowerCase())) {
+          suggestions.push({
+            text: name,
+            description: cmd.descriptionShort,
+            category: "command"
+          });
+        }
+      }
+      return suggestions;
+    }
+    const firstArg = args[0]?.toLowerCase() ?? "";
+    const subgroup = domain.subcommands.get(firstArg);
+    if (subgroup && args.length === 1) {
+      for (const [name, cmd] of subgroup.commands) {
+        if (name.toLowerCase().startsWith(partial.toLowerCase())) {
+          suggestions.push({
+            text: name,
+            description: cmd.descriptionShort,
+            category: "command"
+          });
+        }
+      }
+      return suggestions;
+    }
+    if (subgroup && args.length >= 2) {
+      const cmdName = args[1]?.toLowerCase() ?? "";
+      const cmd = subgroup.commands.get(cmdName);
+      if (cmd?.completion) {
+        const completions = await cmd.completion(
+          partial,
+          args.slice(2),
+          session
+        );
+        return completions.map((text) => ({
+          text,
+          description: "",
+          category: "argument"
+        }));
+      }
+    }
+    return suggestions;
   }
   /**
-   * Save history to disk
+   * Show help for a domain using the unified help formatter.
+   * This ensures consistent professional formatting across all domains.
    */
-  async saveHistory() {
-    await this._history?.save();
+  showDomainHelp(domain) {
+    return {
+      output: formatCustomDomainHelp(domain),
+      shouldExit: false,
+      shouldClear: false,
+      contextChanged: false
+    };
   }
   /**
-   * Clean up session resources
+   * Show help for a subcommand group using the unified help formatter.
+   * This ensures consistent professional formatting across all subcommands.
    */
-  async cleanup() {
-    await this.saveHistory();
+  showSubcommandHelp(domain, subgroup) {
+    return {
+      output: formatSubcommandHelp(domain.name, subgroup),
+      shouldExit: false,
+      shouldClear: false,
+      contextChanged: false
+    };
   }
 };
-
-// src/repl/prompt.ts
-function buildPlainPrompt(_session) {
-  return "> ";
+var customDomains = new DomainRegistry();
+function successResult(output, contextChanged = false) {
+  return {
+    output,
+    shouldExit: false,
+    shouldClear: false,
+    contextChanged
+  };
+}
+function errorResult(message) {
+  return {
+    output: [message],
+    shouldExit: false,
+    shouldClear: false,
+    contextChanged: false,
+    error: message
+  };
+}
+function rawStdoutResult(content) {
+  return {
+    output: [],
+    // No regular output - rawStdout is used instead
+    shouldExit: false,
+    shouldClear: false,
+    contextChanged: false,
+    rawStdout: content
+  };
 }
 
-// src/repl/App.tsx
-var import_react28 = __toESM(require_react(), 1);
-
-// src/repl/components/InputBox.tsx
-var import_react23 = __toESM(require_react(), 1);
-
-// node_modules/ink-text-input/build/index.js
-var import_react22 = __toESM(require_react(), 1);
-function TextInput({ value: originalValue, placeholder = "", focus = true, mask, highlightPastedText = false, showCursor = true, onChange, onSubmit }) {
-  const [state, setState] = (0, import_react22.useState)({
-    cursorOffset: (originalValue || "").length,
-    cursorWidth: 0
-  });
-  const { cursorOffset, cursorWidth } = state;
-  (0, import_react22.useEffect)(() => {
-    setState((previousState) => {
-      if (!focus || !showCursor) {
-        return previousState;
-      }
-      const newValue = originalValue || "";
-      if (previousState.cursorOffset > newValue.length - 1) {
-        return {
-          cursorOffset: newValue.length,
-          cursorWidth: 0
-        };
-      }
-      return previousState;
-    });
-  }, [originalValue, focus, showCursor]);
-  const cursorActualWidth = highlightPastedText ? cursorWidth : 0;
-  const value = mask ? mask.repeat(originalValue.length) : originalValue;
-  let renderedValue = value;
-  let renderedPlaceholder = placeholder ? source_default.grey(placeholder) : void 0;
-  if (showCursor && focus) {
-    renderedPlaceholder = placeholder.length > 0 ? source_default.inverse(placeholder[0]) + source_default.grey(placeholder.slice(1)) : source_default.inverse(" ");
-    renderedValue = value.length > 0 ? "" : source_default.inverse(" ");
-    let i = 0;
-    for (const char of value) {
-      renderedValue += i >= cursorOffset - cursorActualWidth && i <= cursorOffset ? source_default.inverse(char) : char;
-      i++;
-    }
-    if (value.length > 0 && cursorOffset === value.length) {
-      renderedValue += source_default.inverse(" ");
-    }
+// src/output/spec.ts
+function buildCommandSpec(options) {
+  const spec = {
+    command: options.command,
+    description: options.description,
+    usage: options.usage ?? `xcsh ${options.command} [options]`,
+    flags: options.flags ?? [],
+    examples: options.examples ?? [],
+    outputFormats: options.outputFormats ?? ["table", "json", "yaml"]
+  };
+  if (options.related !== void 0) {
+    spec.related = options.related;
   }
-  use_input_default((input, key) => {
-    if (key.upArrow || key.downArrow || key.ctrl && input === "c" || key.tab || key.shift && key.tab) {
-      return;
-    }
-    if (key.return) {
-      if (onSubmit) {
-        onSubmit(originalValue);
-      }
-      return;
-    }
-    let nextCursorOffset = cursorOffset;
-    let nextValue = originalValue;
-    let nextCursorWidth = 0;
-    if (key.leftArrow) {
-      if (showCursor) {
-        nextCursorOffset--;
-      }
-    } else if (key.rightArrow) {
-      if (showCursor) {
-        nextCursorOffset++;
-      }
-    } else if (key.backspace || key.delete) {
-      if (cursorOffset > 0) {
-        nextValue = originalValue.slice(0, cursorOffset - 1) + originalValue.slice(cursorOffset, originalValue.length);
-        nextCursorOffset--;
-      }
-    } else {
-      nextValue = originalValue.slice(0, cursorOffset) + input + originalValue.slice(cursorOffset, originalValue.length);
-      nextCursorOffset += input.length;
-      if (input.length > 1) {
-        nextCursorWidth = input.length;
-      }
-    }
-    if (cursorOffset < 0) {
-      nextCursorOffset = 0;
-    }
-    if (cursorOffset > originalValue.length) {
-      nextCursorOffset = originalValue.length;
-    }
-    setState({
-      cursorOffset: nextCursorOffset,
-      cursorWidth: nextCursorWidth
-    });
-    if (nextValue !== originalValue) {
-      onChange(nextValue);
-    }
-  }, { isActive: focus });
-  return import_react22.default.createElement(Text, null, placeholder ? value.length > 0 ? renderedValue : renderedPlaceholder : renderedValue);
+  if (options.category !== void 0) {
+    spec.category = options.category;
+  }
+  return spec;
 }
-var build_default = TextInput;
-
-// src/repl/components/InputBox.tsx
-var import_jsx_runtime = __toESM(require_jsx_runtime(), 1);
-function HorizontalRule({ width }) {
-  const rule = "\u2500".repeat(Math.max(width, 1));
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { color: "#CA260A", children: rule });
+function formatSpec(spec) {
+  return JSON.stringify(spec, null, 2);
 }
-function InputBox({
-  prompt,
-  value,
-  onChange,
-  onSubmit,
-  width = 80,
-  isActive = true,
-  inputKey = 0
-}) {
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Box_default, { flexDirection: "column", width, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(HorizontalRule, { width }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Box_default, { children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { bold: true, color: "#ffffff", children: prompt }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        build_default,
+var GLOBAL_FLAGS = [
+  {
+    name: "--output",
+    alias: "-o",
+    description: "Output format",
+    type: "string",
+    default: "table",
+    choices: ["table", "json", "yaml", "tsv"]
+  },
+  {
+    name: "--namespace",
+    alias: "-ns",
+    description: "Namespace to use for the operation",
+    type: "string"
+  },
+  {
+    name: "--no-color",
+    description: "Disable colored output",
+    type: "boolean",
+    default: "false"
+  },
+  {
+    name: "--spec",
+    description: "Output command specification as JSON (for AI assistants)",
+    type: "boolean"
+  },
+  {
+    name: "--help",
+    alias: "-h",
+    description: "Show help information",
+    type: "boolean"
+  },
+  {
+    name: "--version",
+    alias: "-v",
+    description: "Show version number",
+    type: "boolean"
+  }
+];
+function buildCloudstatusSpecs() {
+  return {
+    status: buildCommandSpec({
+      command: "cloudstatus status",
+      description: "Get the overall health indicator for F5 Distributed Cloud services. Returns status level (operational, degraded, major outage) with description.",
+      usage: "xcsh cloudstatus status [--quiet]",
+      flags: [
         {
-          value,
-          onChange,
-          onSubmit,
-          focus: isActive
+          name: "--quiet",
+          alias: "-q",
+          description: "Return exit code only (0=operational, 1=degraded, 2=outage)",
+          type: "boolean"
+        }
+      ],
+      examples: [
+        {
+          command: "xcsh cloudstatus status",
+          description: "Check current F5 XC service status"
         },
-        inputKey
-      )
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(HorizontalRule, { width })
-  ] });
-}
-
-// src/repl/components/StatusBar.tsx
-import { execSync } from "child_process";
-var import_jsx_runtime2 = __toESM(require_jsx_runtime(), 1);
-function getStatusIcon(gitInfo) {
-  if (gitInfo.ahead > 0 && gitInfo.behind > 0) {
-    return "\u21C5";
-  }
-  if (gitInfo.ahead > 0) {
-    return "\u2191";
-  }
-  if (gitInfo.behind > 0) {
-    return "\u2193";
-  }
-  if (gitInfo.isDirty) {
-    return "*";
-  }
-  return "\u2713";
-}
-function getStatusColor(gitInfo) {
-  if (gitInfo.ahead > 0 || gitInfo.behind > 0) {
-    return "#2196f3";
-  }
-  if (gitInfo.isDirty) {
-    return "#ffc107";
-  }
-  return "#00c853";
-}
-function StatusBar({
-  gitInfo,
-  width = 80,
-  hint = "Ctrl+C: quit"
-}) {
-  const renderLeft = () => {
-    if (gitInfo?.inRepo) {
-      const icon = getStatusIcon(gitInfo);
-      const color = getStatusColor(gitInfo);
-      return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "#ffffff", children: gitInfo.repoName }),
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "#666666", children: "/" }),
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color, children: gitInfo.branch }),
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { children: " " }),
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color, children: icon })
-      ] });
-    }
-    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "#ffffff", children: CLI_NAME });
-  };
-  const renderRight = () => {
-    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "#666666", children: hint });
+        {
+          command: "xcsh cloudstatus status --quiet && echo 'All systems operational'",
+          description: "Use in scripts for health checks"
+        },
+        {
+          command: "xcsh cloudstatus status --output json",
+          description: "Get status as JSON for automation"
+        }
+      ],
+      category: "cloudstatus",
+      related: [
+        "cloudstatus summary",
+        "cloudstatus components",
+        "cloudstatus incidents"
+      ]
+    }),
+    summary: buildCommandSpec({
+      command: "cloudstatus summary",
+      description: "Get complete status summary including overall health, component status, and active incidents.",
+      usage: "xcsh cloudstatus summary",
+      examples: [
+        {
+          command: "xcsh cloudstatus summary",
+          description: "View full infrastructure health overview"
+        },
+        {
+          command: "xcsh cloudstatus summary --output json",
+          description: "Get complete summary as JSON"
+        }
+      ],
+      category: "cloudstatus",
+      related: ["cloudstatus status", "cloudstatus components"]
+    }),
+    components: buildCommandSpec({
+      command: "cloudstatus components",
+      description: "List all infrastructure components and their current operational status.",
+      usage: "xcsh cloudstatus components",
+      examples: [
+        {
+          command: "xcsh cloudstatus components",
+          description: "List all components with status"
+        },
+        {
+          command: "xcsh cloudstatus components --output json",
+          description: "Get components as JSON for monitoring integration"
+        }
+      ],
+      category: "cloudstatus",
+      related: ["cloudstatus status", "cloudstatus summary"]
+    }),
+    incidents: buildCommandSpec({
+      command: "cloudstatus incidents",
+      description: "List active and recent incidents affecting F5 Distributed Cloud services.",
+      usage: "xcsh cloudstatus incidents",
+      examples: [
+        {
+          command: "xcsh cloudstatus incidents",
+          description: "View active incidents"
+        },
+        {
+          command: "xcsh cloudstatus incidents --output json",
+          description: "Get incidents as JSON for alerting systems"
+        }
+      ],
+      category: "cloudstatus",
+      related: ["cloudstatus status", "cloudstatus maintenance"]
+    }),
+    maintenance: buildCommandSpec({
+      command: "cloudstatus maintenance",
+      description: "List scheduled maintenance windows for F5 Distributed Cloud services.",
+      usage: "xcsh cloudstatus maintenance",
+      examples: [
+        {
+          command: "xcsh cloudstatus maintenance",
+          description: "View upcoming maintenance windows"
+        },
+        {
+          command: "xcsh cloudstatus maintenance --output json",
+          description: "Get maintenance schedule as JSON"
+        }
+      ],
+      category: "cloudstatus",
+      related: ["cloudstatus status", "cloudstatus incidents"]
+    })
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { width, paddingX: 1, justifyContent: "space-between", children: [
-    renderLeft(),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Spacer, {}),
-    renderRight()
-  ] });
 }
-function getGitInfo() {
-  const defaultInfo = {
-    inRepo: false,
-    repoName: "",
-    branch: "",
-    isDirty: false,
-    ahead: 0,
-    behind: 0
-  };
-  try {
-    try {
-      execSync("git rev-parse --is-inside-work-tree", {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"]
-      });
-    } catch {
-      return defaultInfo;
-    }
-    let repoName = "";
-    try {
-      const topLevel = execSync("git rev-parse --show-toplevel", {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"]
-      }).trim();
-      repoName = topLevel.split("/").pop() ?? "";
-    } catch {
-      repoName = "repo";
-    }
-    let branch = "";
-    try {
-      branch = execSync("git rev-parse --abbrev-ref HEAD", {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"]
-      }).trim();
-    } catch {
-      branch = "unknown";
-    }
-    let isDirty = false;
-    try {
-      const status = execSync("git status --porcelain", {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"]
-      });
-      isDirty = status.trim().length > 0;
-    } catch {
-    }
-    let ahead = 0;
-    let behind = 0;
-    try {
-      const counts = execSync(
-        "git rev-list --left-right --count HEAD...@{upstream}",
+function buildLoginSpecs() {
+  return {
+    banner: buildCommandSpec({
+      command: "login banner",
+      description: "Display xcsh banner with logo and connection information.",
+      usage: "xcsh login banner",
+      examples: [
+        {
+          command: "xcsh login banner",
+          description: "Show the xcsh welcome banner"
+        }
+      ],
+      category: "login",
+      related: ["login profile show"]
+    }),
+    "profile list": buildCommandSpec({
+      command: "login profile list",
+      description: "List all saved connection profiles.",
+      usage: "xcsh login profile list",
+      examples: [
+        {
+          command: "xcsh login profile list",
+          description: "List saved profiles"
+        },
+        {
+          command: "xcsh login profile list --output json",
+          description: "Get profiles as JSON"
+        }
+      ],
+      category: "login",
+      related: [
+        "login profile show",
+        "login profile create",
+        "login profile use"
+      ]
+    }),
+    "profile show": buildCommandSpec({
+      command: "login profile show",
+      description: "Show current connection profile and authentication status.",
+      usage: "xcsh login profile show [name]",
+      flags: [
+        {
+          name: "name",
+          description: "Profile name to show (optional, defaults to active)",
+          type: "string"
+        }
+      ],
+      examples: [
+        {
+          command: "xcsh login profile show",
+          description: "Show active profile"
+        },
+        {
+          command: "xcsh login profile show production",
+          description: "Show specific profile"
+        }
+      ],
+      category: "login",
+      related: ["login profile list", "login profile use"]
+    }),
+    "profile create": buildCommandSpec({
+      command: "login profile create",
+      description: "Create a new connection profile with URL and credentials.",
+      usage: "xcsh login profile create <name>",
+      flags: [
+        {
+          name: "name",
+          description: "Profile name",
+          type: "string",
+          required: true
+        }
+      ],
+      examples: [
+        {
+          command: "xcsh login profile create production",
+          description: "Create a new profile named 'production'"
+        }
+      ],
+      category: "login",
+      related: ["login profile list", "login profile use"]
+    }),
+    "profile use": buildCommandSpec({
+      command: "login profile use",
+      description: "Switch to a different connection profile.",
+      usage: "xcsh login profile use <name>",
+      flags: [
         {
-          encoding: "utf-8",
-          stdio: ["pipe", "pipe", "pipe"]
+          name: "name",
+          description: "Profile name to activate",
+          type: "string",
+          required: true
         }
-      ).trim();
-      const [aheadStr, behindStr] = counts.split(/\s+/);
-      ahead = parseInt(aheadStr ?? "0", 10) || 0;
-      behind = parseInt(behindStr ?? "0", 10) || 0;
-    } catch {
-    }
-    return {
-      inRepo: true,
-      repoName,
-      branch,
-      isDirty,
-      ahead,
-      behind
-    };
-  } catch {
-    return defaultInfo;
-  }
+      ],
+      examples: [
+        {
+          command: "xcsh login profile use staging",
+          description: "Switch to staging profile"
+        }
+      ],
+      category: "login",
+      related: ["login profile list", "login profile show"]
+    }),
+    "context show": buildCommandSpec({
+      command: "login context show",
+      description: "Show the current default namespace context.",
+      usage: "xcsh login context show",
+      examples: [
+        {
+          command: "xcsh login context show",
+          description: "Display current namespace"
+        }
+      ],
+      category: "login",
+      related: ["login context set", "login context list"]
+    }),
+    "context set": buildCommandSpec({
+      command: "login context set",
+      description: "Set the default namespace for subsequent operations.",
+      usage: "xcsh login context set <namespace>",
+      flags: [
+        {
+          name: "namespace",
+          description: "Namespace to set as default",
+          type: "string",
+          required: true
+        }
+      ],
+      examples: [
+        {
+          command: "xcsh login context set production",
+          description: "Set production as default namespace"
+        }
+      ],
+      category: "login",
+      related: ["login context show", "login context list"]
+    })
+  };
 }
-
-// src/repl/components/Suggestions.tsx
-var import_react24 = __toESM(require_react(), 1);
-var import_jsx_runtime3 = __toESM(require_jsx_runtime(), 1);
-function getCategoryColor(category) {
-  switch (category) {
-    case "domain":
-      return "#2196f3";
-    // Blue
-    case "action":
-      return "#4caf50";
-    // Green
-    case "flag":
-      return "#ffc107";
-    // Yellow
-    case "value":
-      return "#9c27b0";
-    // Purple
-    default:
-      return "#ffffff";
+function getCommandSpec(commandPath) {
+  const cloudstatusSpecs = buildCloudstatusSpecs();
+  const loginSpecs = buildLoginSpecs();
+  const normalized = commandPath.toLowerCase().trim();
+  if (normalized.startsWith("cloudstatus ")) {
+    const subcommand = normalized.replace("cloudstatus ", "");
+    return cloudstatusSpecs[subcommand];
+  }
+  if (normalized.startsWith("login ")) {
+    const subcommand = normalized.replace("login ", "");
+    return loginSpecs[subcommand];
   }
+  return void 0;
 }
-function SuggestionItem({
-  suggestion,
-  isSelected,
-  maxLabelWidth
-}) {
-  const categoryColor = getCategoryColor(suggestion.category);
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Box_default, { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: isSelected ? "#CA260A" : "#333333", children: isSelected ? "\u25B6 " : "   " }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: categoryColor, bold: isSelected, inverse: isSelected, children: suggestion.label.padEnd(maxLabelWidth) }),
-    suggestion.description && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#666666", children: [
-      " - ",
-      suggestion.description
-    ] })
-  ] });
+function toGlobalFlagSpec(flag) {
+  return {
+    name: flag.name,
+    type: flag.type ?? "string",
+    description: flag.description,
+    shorthand: flag.alias ?? "",
+    default: flag.default ?? ""
+  };
 }
-function Suggestions({
-  suggestions,
-  selectedIndex,
-  onSelect,
-  onNavigate,
-  onCancel,
-  maxVisible = 20,
-  isActive = true
-}) {
-  use_input_default(
-    (_input, key) => {
-      if (!isActive) return;
-      if (key.upArrow) {
-        onNavigate("up");
-        return;
-      }
-      if (key.downArrow) {
-        onNavigate("down");
-        return;
-      }
-      if (key.return || key.tab) {
-        const selected = suggestions.at(selectedIndex);
-        if (selected) {
-          onSelect(selected);
-        }
-        return;
-      }
-      if (key.escape) {
-        onCancel();
-        return;
-      }
-    },
-    { isActive }
-  );
-  if (suggestions.length === 0) {
-    return null;
+function buildCustomDomainSpec(domainName) {
+  const domain = customDomains.get(domainName);
+  if (!domain) return null;
+  const subcommands = [];
+  for (const [cmdName, cmd] of domain.commands) {
+    subcommands.push({
+      path: [domainName, cmdName],
+      use: cmd.usage ?? cmdName,
+      short: cmd.descriptionShort,
+      long: cmd.description,
+      example: "",
+      aliases: cmd.aliases ?? [],
+      flags: [],
+      subcommands: []
+    });
   }
-  const totalCount = suggestions.length;
-  const startIndex = Math.max(
-    0,
-    Math.min(
-      selectedIndex - Math.floor(maxVisible / 2),
-      totalCount - maxVisible
-    )
-  );
-  const visibleSuggestions = suggestions.slice(
-    startIndex,
-    startIndex + maxVisible
-  );
-  const showScrollUp = startIndex > 0;
-  const showScrollDown = startIndex + maxVisible < totalCount;
-  const maxLabelWidth = Math.max(
-    ...visibleSuggestions.map((s) => s.label.length)
-  );
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-    Box_default,
-    {
-      flexDirection: "column",
-      borderStyle: "round",
-      borderColor: "#CA260A",
-      paddingX: 1,
-      children: [
-        showScrollUp && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#666666", dimColor: true, children: [
-          "\u25B2",
-          " (",
-          startIndex,
-          " more above)"
-        ] }),
-        visibleSuggestions.map((suggestion, index) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-          SuggestionItem,
-          {
-            suggestion,
-            isSelected: startIndex + index === selectedIndex,
-            index: startIndex + index,
-            maxLabelWidth
-          },
-          suggestion.value
-        )),
-        showScrollDown && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#666666", dimColor: true, children: [
-          "\u25BC",
-          " (",
-          totalCount - startIndex - maxVisible,
-          " more below)"
-        ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Box_default, { marginTop: 1, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: "#666666", dimColor: true, children: "Tab: select | Up/Down: navigate | Esc: cancel" }) })
-      ]
+  for (const [groupName, group] of domain.subcommands) {
+    const groupSubcommands = [];
+    for (const [cmdName, cmd] of group.commands) {
+      groupSubcommands.push({
+        path: [domainName, groupName, cmdName],
+        use: cmd.usage ?? cmdName,
+        short: cmd.descriptionShort,
+        long: cmd.description,
+        example: "",
+        aliases: cmd.aliases ?? [],
+        flags: [],
+        subcommands: []
+      });
     }
-  );
+    subcommands.push({
+      path: [domainName, groupName],
+      use: groupName,
+      short: group.descriptionShort,
+      long: group.description,
+      example: "",
+      aliases: [],
+      flags: [],
+      subcommands: groupSubcommands
+    });
+  }
+  return {
+    path: [domainName],
+    use: domainName,
+    short: domain.descriptionShort,
+    long: domain.description,
+    example: "",
+    aliases: [],
+    flags: [],
+    subcommands
+  };
 }
-
-// src/repl/hooks/useDoubleCtrlC.ts
-var import_react25 = __toESM(require_react(), 1);
-function useDoubleCtrlC(options = {}) {
-  const { windowMs = 500, onFirstPress, onDoublePress } = options;
-  const lastPressRef = (0, import_react25.useRef)(0);
-  const [isWaiting, setIsWaiting] = (0, import_react25.useState)(false);
-  const timeoutRef = (0, import_react25.useRef)(null);
-  const reset = (0, import_react25.useCallback)(() => {
-    lastPressRef.current = 0;
-    setIsWaiting(false);
-    if (timeoutRef.current) {
-      clearTimeout(timeoutRef.current);
-      timeoutRef.current = null;
-    }
-  }, []);
-  const handleCtrlC = (0, import_react25.useCallback)(() => {
-    const now = Date.now();
-    const elapsed = now - lastPressRef.current;
-    if (elapsed < windowMs && lastPressRef.current !== 0) {
-      reset();
-      onDoublePress?.();
-      return true;
-    }
-    lastPressRef.current = now;
-    setIsWaiting(true);
-    onFirstPress?.();
-    if (timeoutRef.current) {
-      clearTimeout(timeoutRef.current);
-    }
-    timeoutRef.current = setTimeout(() => {
-      setIsWaiting(false);
-    }, windowMs);
-    return false;
-  }, [windowMs, onFirstPress, onDoublePress, reset]);
+function buildApiDomainSpec(domainName) {
+  const info = domainRegistry.get(domainName);
+  if (!info) return null;
+  const actions = Array.from(validActions);
+  const subcommands = actions.map((action) => ({
+    path: [domainName, action],
+    use: action,
+    short: `${action.charAt(0).toUpperCase() + action.slice(1)} ${info.displayName} resources`,
+    long: `${action.charAt(0).toUpperCase() + action.slice(1)} ${info.displayName} resources in F5 Distributed Cloud`,
+    example: `xcsh ${domainName} ${action}`,
+    aliases: [],
+    flags: [],
+    subcommands: []
+  }));
   return {
-    handleCtrlC,
-    reset,
-    isWaiting
+    path: [domainName],
+    use: domainName,
+    short: info.descriptionShort,
+    long: info.description,
+    example: "",
+    aliases: info.aliases,
+    flags: [],
+    subcommands
   };
 }
-
-// src/repl/hooks/useHistory.ts
-var import_react26 = __toESM(require_react(), 1);
-function useHistory(options) {
-  const { history, onSelect } = options;
-  const [historyIndex, setHistoryIndex] = (0, import_react26.useState)(-1);
-  const reset = (0, import_react26.useCallback)(() => {
-    setHistoryIndex(-1);
-  }, []);
-  const navigateUp = (0, import_react26.useCallback)(() => {
-    if (history.length === 0) {
-      return null;
-    }
-    const newIndex = Math.min(historyIndex + 1, history.length - 1);
-    setHistoryIndex(newIndex);
-    const command = history[history.length - 1 - newIndex];
-    if (command !== void 0) {
-      onSelect?.(command);
-      return command;
+function buildFullCLISpec() {
+  const commands = [];
+  for (const domain of customDomains.all()) {
+    const spec = buildCustomDomainSpec(domain.name);
+    if (spec) {
+      commands.push(spec);
     }
-    return null;
-  }, [history, historyIndex, onSelect]);
-  const navigateDown = (0, import_react26.useCallback)(() => {
-    if (historyIndex <= 0) {
-      if (historyIndex === 0) {
-        setHistoryIndex(-1);
-        onSelect?.("");
-        return "";
+  }
+  const customDomainNames = new Set(customDomains.list());
+  for (const [domainName] of domainRegistry) {
+    if (!customDomainNames.has(domainName)) {
+      const spec = buildApiDomainSpec(domainName);
+      if (spec) {
+        commands.push(spec);
       }
-      return null;
-    }
-    const newIndex = historyIndex - 1;
-    setHistoryIndex(newIndex);
-    const command = history[history.length - 1 - newIndex];
-    if (command !== void 0) {
-      onSelect?.(command);
-      return command;
     }
-    return null;
-  }, [history, historyIndex, onSelect]);
+  }
+  commands.sort((a, b) => (a.path[0] ?? "").localeCompare(b.path[0] ?? ""));
   return {
-    navigateUp,
-    navigateDown,
-    reset,
-    isNavigating: historyIndex >= 0,
-    currentIndex: historyIndex
+    version: CLI_VERSION,
+    global_flags: GLOBAL_FLAGS.map(toGlobalFlagSpec),
+    commands
   };
 }
+function formatFullCLISpec() {
+  return JSON.stringify(buildFullCLISpec(), null, 2);
+}
 
-// src/repl/hooks/useCompletion.ts
-var import_react27 = __toESM(require_react(), 1);
+// src/debug/protocol.ts
+function getDebugFormat() {
+  const envValue = process.env[`${ENV_PREFIX}_DEBUG_EVENTS`];
+  if (envValue === "jsonl" || envValue === "human") {
+    return envValue;
+  }
+  if (process.env[`${ENV_PREFIX}_DEBUG`] === "true") {
+    return "human";
+  }
+  return "none";
+}
+var DebugProtocolImpl = class {
+  format;
+  events = [];
+  startTime;
+  constructor() {
+    this.format = getDebugFormat();
+    this.startTime = Date.now();
+  }
+  /**
+   * Check if debug events are enabled
+   */
+  isEnabled() {
+    return this.format !== "none";
+  }
+  /**
+   * Check if JSONL format is enabled
+   */
+  isJsonl() {
+    return this.format === "jsonl";
+  }
+  /**
+   * Emit a debug event
+   */
+  emit(type, event, data = {}) {
+    if (!this.isEnabled()) return;
+    const entry = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      type,
+      event,
+      data: {
+        ...data,
+        elapsedMs: Date.now() - this.startTime
+      }
+    };
+    this.events.push(entry);
+    if (this.format === "jsonl") {
+      console.error(JSON.stringify(entry));
+    } else if (this.format === "human") {
+      const prefix = `DEBUG [${type}:${event}]`;
+      const dataStr = Object.keys(data).length > 0 ? ` ${JSON.stringify(data)}` : "";
+      console.error(`${prefix}${dataStr}`);
+    }
+  }
+  /**
+   * Emit session-related event
+   */
+  session(event, data = {}) {
+    this.emit("session", event, data);
+  }
+  /**
+   * Emit API-related event
+   */
+  api(event, data = {}) {
+    this.emit("api", event, data);
+  }
+  /**
+   * Emit authentication-related event
+   */
+  auth(event, data = {}) {
+    this.emit("auth", event, data);
+  }
+  /**
+   * Emit profile-related event
+   */
+  profile(event, data = {}) {
+    this.emit("profile", event, data);
+  }
+  /**
+   * Emit UI-related event
+   */
+  ui(event, data = {}) {
+    this.emit("ui", event, data);
+  }
+  /**
+   * Emit error event
+   */
+  error(event, error, data = {}) {
+    this.emit("error", event, {
+      ...data,
+      error: error instanceof Error ? error.message : String(error),
+      stack: error instanceof Error ? error.stack : void 0
+    });
+  }
+  /**
+   * Get all captured events
+   */
+  getEvents() {
+    return [...this.events];
+  }
+  /**
+   * Dump session state on exit (for --dump-state-on-exit)
+   */
+  dumpState(state) {
+    if (!this.isEnabled()) return;
+    console.error("\n=== Session State Dump ===");
+    console.error(JSON.stringify(state, null, 2));
+    console.error("=== End Session State ===\n");
+  }
+};
+var debugProtocol = new DebugProtocolImpl();
+function emitSessionState(session) {
+  debugProtocol.auth("session_state", {
+    isAuthenticated: session.isAuthenticated(),
+    isTokenValidated: session.isTokenValidated(),
+    validationError: session.getValidationError(),
+    serverUrl: session.getServerUrl(),
+    activeProfile: session.getActiveProfileName(),
+    hasApiClient: session.getAPIClient() !== null
+  });
+  const showsWarning = session.isAuthenticated() && !session.isTokenValidated() && session.getValidationError();
+  debugProtocol.auth("warning_check", {
+    shouldShowWarning: !!showsWarning,
+    isAuthenticated: session.isAuthenticated(),
+    isTokenValidated: session.isTokenValidated(),
+    hasValidationError: !!session.getValidationError()
+  });
+}
 
-// 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"
+// src/repl/session.ts
+var NAMESPACE_CACHE_TTL = 5 * 60 * 1e3;
+var REPLSession = class {
+  _history = null;
+  _namespace;
+  _lastExitCode = 0;
+  _contextPath;
+  _tenant = "";
+  _username = "";
+  _validator;
+  _serverUrl = "";
+  _apiToken = "";
+  _apiClient = null;
+  _outputFormat = "table";
+  _debug = false;
+  _profileManager;
+  _activeProfile = null;
+  _activeProfileName = null;
+  _namespaceCache = [];
+  _namespaceCacheTime = 0;
+  // Token validation state
+  _tokenValidated = false;
+  _validationError = null;
+  constructor(config = {}) {
+    this._namespace = config.namespace ?? this.getDefaultNamespace();
+    this._contextPath = new ContextPath();
+    this._validator = new ContextValidator();
+    this._profileManager = getProfileManager();
+    this._serverUrl = config.serverUrl ?? process.env[`${ENV_PREFIX}_API_URL`] ?? "";
+    this._apiToken = config.apiToken ?? process.env[`${ENV_PREFIX}_API_TOKEN`] ?? "";
+    this._outputFormat = config.outputFormat ?? getOutputFormatFromEnv() ?? "table";
+    this._debug = config.debug ?? process.env[`${ENV_PREFIX}_DEBUG`] === "true";
+    if (this._serverUrl) {
+      this._tenant = this.extractTenant(this._serverUrl);
+    }
+    if (this._serverUrl) {
+      this._apiClient = new APIClient({
+        serverUrl: this._serverUrl,
+        apiToken: this._apiToken,
+        debug: this._debug
+      });
+    }
+  }
+  /**
+   * Initialize the session (async operations)
+   */
+  async initialize() {
+    try {
+      this._history = await HistoryManager.create(
+        getHistoryFilePath(),
+        1e3
+      );
+    } catch (error) {
+      console.error("Warning: could not initialize history:", error);
+      this._history = new HistoryManager(getHistoryFilePath(), 1e3);
+    }
+    await this.loadActiveProfile();
+    if (this._apiClient?.isAuthenticated()) {
+      debugProtocol.auth("token_validation_start", {
+        serverUrl: this._serverUrl,
+        hasApiClient: true
+      });
+      const result = await this._apiClient.validateToken();
+      this._tokenValidated = result.valid;
+      this._validationError = result.error ?? null;
+      debugProtocol.auth("token_validation_complete", {
+        valid: result.valid,
+        error: result.error,
+        tokenValidated: this._tokenValidated,
+        validationError: this._validationError
+      });
+      if (result.valid) {
+        await this.fetchUserInfo();
+      }
+    }
+  }
+  /**
+   * Fetch user info from the API
+   */
+  async fetchUserInfo() {
+    if (!this._apiClient) return;
+    try {
+      const response = await this._apiClient.get("/api/web/custom/user/info");
+      if (response.ok && response.data) {
+        this._username = response.data.email || response.data.name || response.data.username || "";
+      }
+    } catch {
+    }
+  }
+  /**
+   * Load the active profile from profile manager
+   * Note: Environment variables take priority over profile settings
+   * If no active profile is set but exactly one profile exists, auto-activate it
+   */
+  async loadActiveProfile() {
+    try {
+      let activeName = await this._profileManager.getActive();
+      if (!activeName) {
+        const profiles = await this._profileManager.list();
+        if (profiles.length === 1 && profiles[0]) {
+          const singleProfile = profiles[0];
+          await this._profileManager.setActive(singleProfile.name);
+          activeName = singleProfile.name;
+        }
+      }
+      if (activeName) {
+        const profile = await this._profileManager.get(activeName);
+        if (profile) {
+          this._activeProfileName = activeName;
+          this._activeProfile = profile;
+          const envUrl = process.env[`${ENV_PREFIX}_API_URL`];
+          const envToken = process.env[`${ENV_PREFIX}_API_TOKEN`];
+          const envNamespace = process.env[`${ENV_PREFIX}_NAMESPACE`];
+          if (!envUrl && profile.apiUrl) {
+            this._serverUrl = profile.apiUrl;
+            this._tenant = this.extractTenant(profile.apiUrl);
+          }
+          if (!envToken && profile.apiToken) {
+            this._apiToken = profile.apiToken;
+          }
+          if (!envNamespace && profile.defaultNamespace) {
+            this._namespace = profile.defaultNamespace;
+          }
+          if (this._serverUrl) {
+            this._apiClient = new APIClient({
+              serverUrl: this._serverUrl,
+              apiToken: this._apiToken,
+              debug: this._debug
+            });
+          }
+        }
+      }
+    } catch (error) {
+      debugProtocol.error("profile_load_failed", error, {
+        activeProfile: this._activeProfileName
+      });
+    }
   }
-];
-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}`);
+  /**
+   * Get the default namespace from environment or config
+   */
+  getDefaultNamespace() {
+    return process.env[`${ENV_PREFIX}_NAMESPACE`] ?? "default";
   }
-  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 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;
+  /**
+   * Extract tenant name from server URL
+   */
+  extractTenant(url) {
+    try {
+      const parsed = new URL(url);
+      const hostname = parsed.hostname;
+      const parts = hostname.split(".");
+      if (parts.length > 0 && parts[0]) {
+        return parts[0];
+      }
+      return hostname;
+    } catch {
+      return "";
     }
   }
-  if (currentLine.trim()) {
-    lines.push(currentLine);
+  /**
+   * Set the default namespace for the session
+   */
+  setNamespace(ns) {
+    this._namespace = ns;
   }
-  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`,
-    "",
-    ...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",
-    "  --no-color            Disable color output",
-    "  -o, --output <fmt>    Output format (json, yaml, table)",
-    "  -ns, --namespace <ns> Target namespace",
-    "  --spec                Output command specification as JSON (for AI)"
-  ];
-}
-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("");
+  /**
+   * Get the current default namespace
+   */
+  getNamespace() {
+    return this._namespace;
   }
-  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}`);
+  /**
+   * Get the exit code of the last command
+   */
+  getLastExitCode() {
+    return this._lastExitCode;
   }
-  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("");
+  /**
+   * Set the exit code of the last command
+   */
+  setLastExitCode(code) {
+    this._lastExitCode = code;
   }
-  if (domain.relatedDomains && domain.relatedDomains.length > 0) {
-    output.push("RELATED DOMAINS");
-    output.push(`  ${domain.relatedDomains.join(", ")}`);
-    output.push("");
+  /**
+   * Get the current navigation context
+   */
+  getContextPath() {
+    return this._contextPath;
+  }
+  /**
+   * Get the current tenant name
+   */
+  getTenant() {
+    return this._tenant;
+  }
+  /**
+   * Get the logged-in user's name/email
+   */
+  getUsername() {
+    return this._username;
+  }
+  /**
+   * Set the username (used when fetched from API)
+   */
+  setUsername(username) {
+    this._username = username;
+  }
+  /**
+   * Get the context validator
+   */
+  getValidator() {
+    return this._validator;
+  }
+  /**
+   * Get the history manager
+   */
+  getHistory() {
+    return this._history;
+  }
+  /**
+   * Get the server URL
+   */
+  getServerUrl() {
+    return this._serverUrl;
+  }
+  /**
+   * Check if connected to an API server
+   */
+  isConnected() {
+    return this._serverUrl !== "" && this._apiClient !== null;
+  }
+  /**
+   * Check if authenticated with API
+   */
+  isAuthenticated() {
+    return this._apiClient?.isAuthenticated() ?? false;
+  }
+  /**
+   * Check if the token has been validated (verified working)
+   */
+  isTokenValidated() {
+    return this._tokenValidated;
+  }
+  /**
+   * Get the token validation error, if any
+   */
+  getValidationError() {
+    return this._validationError;
+  }
+  /**
+   * Get the API client
+   */
+  getAPIClient() {
+    return this._apiClient;
   }
-  if (domain.aliases && domain.aliases.length > 0) {
-    output.push("ALIASES");
-    output.push(`  ${domain.aliases.join(", ")}`);
-    output.push("");
+  /**
+   * Get the current output format
+   */
+  getOutputFormat() {
+    return this._outputFormat;
   }
-  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);
+  /**
+   * Set the output format
+   */
+  setOutputFormat(format) {
+    this._outputFormat = format;
   }
-  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')",
-        ""
-      ];
+  /**
+   * Get debug mode status
+   */
+  isDebug() {
+    return this._debug;
   }
-}
-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);
+  /**
+   * Get the profile manager
+   */
+  getProfileManager() {
+    return this._profileManager;
   }
-  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("");
+  /**
+   * Get the active profile
+   */
+  getActiveProfile() {
+    return this._activeProfile;
   }
-  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}`);
+  /**
+   * Get the active profile name
+   */
+  getActiveProfileName() {
+    return this._activeProfileName;
   }
-  return output;
-}
-function formatCustomDomainHelp(domain) {
-  const output = ["", colorBoldWhite(domain.name), ""];
-  output.push("DESCRIPTION");
-  output.push(...wrapText3(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}`);
+  /**
+   * Switch to a different profile
+   */
+  async switchProfile(profileName) {
+    const profile = await this._profileManager.get(profileName);
+    if (!profile) {
+      return false;
+    }
+    const result = await this._profileManager.setActive(profileName);
+    if (!result.success) {
+      return false;
+    }
+    this.clearNamespaceCache();
+    this._tokenValidated = false;
+    this._validationError = null;
+    this._activeProfileName = profileName;
+    this._activeProfile = profile;
+    if (profile.apiUrl) {
+      this._serverUrl = profile.apiUrl;
+      this._tenant = this.extractTenant(profile.apiUrl);
     }
-    output.push("");
+    if (profile.apiToken) {
+      this._apiToken = profile.apiToken;
+    }
+    if (profile.defaultNamespace) {
+      this._namespace = profile.defaultNamespace;
+    }
+    if (this._serverUrl) {
+      this._apiClient = new APIClient({
+        serverUrl: this._serverUrl,
+        apiToken: this._apiToken,
+        debug: this._debug
+      });
+      if (this._apiClient.isAuthenticated()) {
+        const validationResult = await this._apiClient.validateToken();
+        this._tokenValidated = validationResult.valid;
+        this._validationError = validationResult.error ?? null;
+      }
+    } else {
+      this._apiClient = null;
+    }
+    return true;
   }
-  if (domain.commands.size > 0) {
-    output.push("COMMANDS");
-    for (const [name, cmd] of domain.commands) {
-      output.push(`  ${name.padEnd(16)} ${cmd.descriptionShort}`);
+  /**
+   * Clear the active profile
+   */
+  clearActiveProfile() {
+    this._activeProfileName = null;
+    this._activeProfile = null;
+  }
+  /**
+   * Get cached namespaces (returns empty array if cache is stale/empty)
+   */
+  getNamespaceCache() {
+    const now = Date.now();
+    if (this._namespaceCache.length > 0 && now - this._namespaceCacheTime < NAMESPACE_CACHE_TTL) {
+      return this._namespaceCache;
     }
-    output.push("");
+    return [];
   }
-  output.push(colorDim(`For global options, run: ${CLI_NAME} --help`));
-  output.push("");
-  return output;
+  /**
+   * Set namespace cache
+   */
+  setNamespaceCache(namespaces) {
+    this._namespaceCache = namespaces;
+    this._namespaceCacheTime = Date.now();
+  }
+  /**
+   * Clear namespace cache (called when switching profiles)
+   */
+  clearNamespaceCache() {
+    this._namespaceCache = [];
+    this._namespaceCacheTime = 0;
+  }
+  /**
+   * Add a command to history
+   */
+  addToHistory(cmd) {
+    this._history?.add(cmd);
+  }
+  /**
+   * Save history to disk
+   */
+  async saveHistory() {
+    await this._history?.save();
+  }
+  /**
+   * Clean up session resources
+   */
+  async cleanup() {
+    await this.saveHistory();
+  }
+};
+
+// src/repl/prompt.ts
+function buildPlainPrompt(_session) {
+  return "> ";
 }
-function formatSubcommandHelp(domainName, subcommand) {
-  const output = [
-    "",
-    colorBoldWhite(`${domainName} ${subcommand.name}`),
-    ""
-  ];
-  output.push("DESCRIPTION");
-  output.push(...wrapText3(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}`
-      );
+
+// src/repl/App.tsx
+var import_react28 = __toESM(require_react(), 1);
+
+// src/repl/components/InputBox.tsx
+var import_react23 = __toESM(require_react(), 1);
+
+// node_modules/ink-text-input/build/index.js
+var import_react22 = __toESM(require_react(), 1);
+function TextInput({ value: originalValue, placeholder = "", focus = true, mask, highlightPastedText = false, showCursor = true, onChange, onSubmit }) {
+  const [state, setState] = (0, import_react22.useState)({
+    cursorOffset: (originalValue || "").length,
+    cursorWidth: 0
+  });
+  const { cursorOffset, cursorWidth } = state;
+  (0, import_react22.useEffect)(() => {
+    setState((previousState) => {
+      if (!focus || !showCursor) {
+        return previousState;
+      }
+      const newValue = originalValue || "";
+      if (previousState.cursorOffset > newValue.length - 1) {
+        return {
+          cursorOffset: newValue.length,
+          cursorWidth: 0
+        };
+      }
+      return previousState;
+    });
+  }, [originalValue, focus, showCursor]);
+  const cursorActualWidth = highlightPastedText ? cursorWidth : 0;
+  const value = mask ? mask.repeat(originalValue.length) : originalValue;
+  let renderedValue = value;
+  let renderedPlaceholder = placeholder ? source_default.grey(placeholder) : void 0;
+  if (showCursor && focus) {
+    renderedPlaceholder = placeholder.length > 0 ? source_default.inverse(placeholder[0]) + source_default.grey(placeholder.slice(1)) : source_default.inverse(" ");
+    renderedValue = value.length > 0 ? "" : source_default.inverse(" ");
+    let i = 0;
+    for (const char of value) {
+      renderedValue += i >= cursorOffset - cursorActualWidth && i <= cursorOffset ? source_default.inverse(char) : char;
+      i++;
+    }
+    if (value.length > 0 && cursorOffset === value.length) {
+      renderedValue += source_default.inverse(" ");
     }
-    output.push("");
   }
-  output.push(
-    colorDim(`For domain help, run: ${CLI_NAME} ${domainName} --help`)
-  );
-  output.push("");
-  return output;
+  use_input_default((input, key) => {
+    if (key.upArrow || key.downArrow || key.ctrl && input === "c" || key.tab || key.shift && key.tab) {
+      return;
+    }
+    if (key.return) {
+      if (onSubmit) {
+        onSubmit(originalValue);
+      }
+      return;
+    }
+    let nextCursorOffset = cursorOffset;
+    let nextValue = originalValue;
+    let nextCursorWidth = 0;
+    if (key.leftArrow) {
+      if (showCursor) {
+        nextCursorOffset--;
+      }
+    } else if (key.rightArrow) {
+      if (showCursor) {
+        nextCursorOffset++;
+      }
+    } else if (key.backspace || key.delete) {
+      if (cursorOffset > 0) {
+        nextValue = originalValue.slice(0, cursorOffset - 1) + originalValue.slice(cursorOffset, originalValue.length);
+        nextCursorOffset--;
+      }
+    } else {
+      nextValue = originalValue.slice(0, cursorOffset) + input + originalValue.slice(cursorOffset, originalValue.length);
+      nextCursorOffset += input.length;
+      if (input.length > 1) {
+        nextCursorWidth = input.length;
+      }
+    }
+    if (cursorOffset < 0) {
+      nextCursorOffset = 0;
+    }
+    if (cursorOffset > originalValue.length) {
+      nextCursorOffset = originalValue.length;
+    }
+    setState({
+      cursorOffset: nextCursorOffset,
+      cursorWidth: nextCursorWidth
+    });
+    if (nextValue !== originalValue) {
+      onChange(nextValue);
+    }
+  }, { isActive: focus });
+  return import_react22.default.createElement(Text, null, placeholder ? value.length > 0 ? renderedValue : renderedPlaceholder : renderedValue);
 }
+var build_default = TextInput;
 
-// src/domains/registry.ts
-var DomainRegistry = class {
-  domains = /* @__PURE__ */ new Map();
-  /**
-   * Register a custom domain
-   */
-  register(domain) {
-    this.domains.set(domain.name, domain);
+// src/repl/components/InputBox.tsx
+var import_jsx_runtime = __toESM(require_jsx_runtime(), 1);
+function HorizontalRule({ width }) {
+  const rule = "\u2500".repeat(Math.max(width, 1));
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { color: "#CA260A", children: rule });
+}
+function InputBox({
+  prompt,
+  value,
+  onChange,
+  onSubmit,
+  width = 80,
+  isActive = true,
+  inputKey = 0
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Box_default, { flexDirection: "column", width, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(HorizontalRule, { width }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Box_default, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { bold: true, color: "#ffffff", children: prompt }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        build_default,
+        {
+          value,
+          onChange,
+          onSubmit,
+          focus: isActive
+        },
+        inputKey
+      )
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(HorizontalRule, { width })
+  ] });
+}
+
+// src/repl/components/StatusBar.tsx
+import { execSync } from "child_process";
+var import_jsx_runtime2 = __toESM(require_jsx_runtime(), 1);
+function getStatusIcon(gitInfo) {
+  if (gitInfo.ahead > 0 && gitInfo.behind > 0) {
+    return "\u21C5";
+  }
+  if (gitInfo.ahead > 0) {
+    return "\u2191";
   }
-  /**
-   * Check if a domain is registered
-   */
-  has(name) {
-    return this.domains.has(name);
+  if (gitInfo.behind > 0) {
+    return "\u2193";
   }
-  /**
-   * Get a domain by name
-   */
-  get(name) {
-    return this.domains.get(name);
+  if (gitInfo.isDirty) {
+    return "*";
   }
-  /**
-   * Get all registered domain names
-   */
-  list() {
-    return Array.from(this.domains.keys());
+  return "\u2713";
+}
+function getStatusColor(gitInfo) {
+  if (gitInfo.ahead > 0 || gitInfo.behind > 0) {
+    return "#2196f3";
   }
-  /**
-   * Get all domains
-   */
-  all() {
-    return Array.from(this.domains.values());
+  if (gitInfo.isDirty) {
+    return "#ffc107";
   }
-  /**
-   * Execute a command within a domain
-   * Handles routing through subcommand groups
-   *
-   * @param domainName - Name of the domain (e.g., "login")
-   * @param args - Command arguments (e.g., ["profile", "list"])
-   * @param session - REPL session
-   */
-  async execute(domainName, args, session) {
-    const domain = this.domains.get(domainName);
-    if (!domain) {
-      return {
-        output: [`Unknown domain: ${domainName}`],
-        shouldExit: false,
-        shouldClear: false,
-        contextChanged: false,
-        error: "Unknown domain"
-      };
+  return "#00c853";
+}
+function StatusBar({
+  gitInfo,
+  width = 80,
+  hint = "Ctrl+C: quit"
+}) {
+  const renderLeft = () => {
+    if (gitInfo?.inRepo) {
+      const icon = getStatusIcon(gitInfo);
+      const color = getStatusColor(gitInfo);
+      return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "#ffffff", children: gitInfo.repoName }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "#666666", children: "/" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color, children: gitInfo.branch }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { children: " " }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color, children: icon })
+      ] });
     }
-    if (args.length === 0) {
-      if (domain.defaultCommand) {
-        return domain.defaultCommand.execute([], session);
-      }
-      return this.showDomainHelp(domain);
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "#ffffff", children: CLI_NAME });
+  };
+  const renderRight = () => {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "#666666", children: hint });
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { width, paddingX: 1, justifyContent: "space-between", children: [
+    renderLeft(),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Spacer, {}),
+    renderRight()
+  ] });
+}
+function getGitInfo() {
+  const defaultInfo = {
+    inRepo: false,
+    repoName: "",
+    branch: "",
+    isDirty: false,
+    ahead: 0,
+    behind: 0
+  };
+  try {
+    try {
+      execSync("git rev-parse --is-inside-work-tree", {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+    } catch {
+      return defaultInfo;
     }
-    const firstArg = args[0]?.toLowerCase() ?? "";
-    const restArgs = args.slice(1);
-    if (firstArg === "--help" || firstArg === "-h" || firstArg === "help") {
-      return this.showDomainHelp(domain);
+    let repoName = "";
+    try {
+      const topLevel = execSync("git rev-parse --show-toplevel", {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      }).trim();
+      repoName = topLevel.split("/").pop() ?? "";
+    } catch {
+      repoName = "repo";
     }
-    const subgroup = domain.subcommands.get(firstArg);
-    if (subgroup) {
-      if (restArgs.length === 0) {
-        if (subgroup.defaultCommand) {
-          return subgroup.defaultCommand.execute([], session);
-        }
-        return this.showSubcommandHelp(domain, subgroup);
-      }
-      const cmdName = restArgs[0]?.toLowerCase() ?? "";
-      if (cmdName === "--help" || cmdName === "-h" || cmdName === "help") {
-        return this.showSubcommandHelp(domain, subgroup);
-      }
-      const cmdArgs = restArgs.slice(1);
-      const cmd2 = subgroup.commands.get(cmdName);
-      if (cmd2) {
-        return cmd2.execute(cmdArgs, session);
-      }
-      for (const [, command] of subgroup.commands) {
-        if (command.aliases?.includes(cmdName)) {
-          return command.execute(cmdArgs, session);
-        }
-      }
-      return {
-        output: [
-          `Unknown command: ${domainName} ${firstArg} ${cmdName}`,
-          ``,
-          `Run '${domainName} ${firstArg}' for available commands.`
-        ],
-        shouldExit: false,
-        shouldClear: false,
-        contextChanged: false,
-        error: "Unknown command"
-      };
+    let branch = "";
+    try {
+      branch = execSync("git rev-parse --abbrev-ref HEAD", {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      }).trim();
+    } catch {
+      branch = "unknown";
     }
-    const cmd = domain.commands.get(firstArg);
-    if (cmd) {
-      return cmd.execute(restArgs, session);
+    let isDirty = false;
+    try {
+      const status = execSync("git status --porcelain", {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      isDirty = status.trim().length > 0;
+    } catch {
     }
-    for (const [, command] of domain.commands) {
-      if (command.aliases?.includes(firstArg)) {
-        return command.execute(restArgs, session);
-      }
+    let ahead = 0;
+    let behind = 0;
+    try {
+      const counts = execSync(
+        "git rev-list --left-right --count HEAD...@{upstream}",
+        {
+          encoding: "utf-8",
+          stdio: ["pipe", "pipe", "pipe"]
+        }
+      ).trim();
+      const [aheadStr, behindStr] = counts.split(/\s+/);
+      ahead = parseInt(aheadStr ?? "0", 10) || 0;
+      behind = parseInt(behindStr ?? "0", 10) || 0;
+    } catch {
     }
     return {
-      output: [
-        `Unknown command: ${domainName} ${firstArg}`,
-        ``,
-        `Run '${domainName}' for available commands.`
-      ],
-      shouldExit: false,
-      shouldClear: false,
-      contextChanged: false,
-      error: "Unknown command"
+      inRepo: true,
+      repoName,
+      branch,
+      isDirty,
+      ahead,
+      behind
     };
+  } catch {
+    return defaultInfo;
   }
-  /**
-   * Get completions for a domain command
-   */
-  async getCompletions(domainName, args, partial, session) {
-    const domain = this.domains.get(domainName);
-    if (!domain) {
-      return [];
-    }
-    const suggestions = [];
-    if (args.length === 0) {
-      for (const [name, group] of domain.subcommands) {
-        if (name.toLowerCase().startsWith(partial.toLowerCase())) {
-          suggestions.push({
-            text: name,
-            description: group.descriptionShort,
-            category: "subcommand"
-          });
-        }
+}
+
+// src/repl/components/Suggestions.tsx
+var import_react24 = __toESM(require_react(), 1);
+var import_jsx_runtime3 = __toESM(require_jsx_runtime(), 1);
+function getCategoryColor(category) {
+  switch (category) {
+    case "domain":
+      return "#2196f3";
+    // Blue
+    case "action":
+      return "#4caf50";
+    // Green
+    case "flag":
+      return "#ffc107";
+    // Yellow
+    case "value":
+      return "#9c27b0";
+    // Purple
+    default:
+      return "#ffffff";
+  }
+}
+function SuggestionItem({
+  suggestion,
+  isSelected,
+  maxLabelWidth
+}) {
+  const categoryColor = getCategoryColor(suggestion.category);
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Box_default, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: isSelected ? "#CA260A" : "#333333", children: isSelected ? "\u25B6 " : "   " }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: categoryColor, bold: isSelected, inverse: isSelected, children: suggestion.label.padEnd(maxLabelWidth) }),
+    suggestion.description && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#666666", children: [
+      " - ",
+      suggestion.description
+    ] })
+  ] });
+}
+function Suggestions({
+  suggestions,
+  selectedIndex,
+  onSelect,
+  onNavigate,
+  onCancel,
+  maxVisible = 20,
+  isActive = true
+}) {
+  use_input_default(
+    (_input, key) => {
+      if (!isActive) return;
+      if (key.upArrow) {
+        onNavigate("up");
+        return;
       }
-      for (const [name, cmd] of domain.commands) {
-        if (name.toLowerCase().startsWith(partial.toLowerCase())) {
-          suggestions.push({
-            text: name,
-            description: cmd.descriptionShort,
-            category: "command"
-          });
-        }
+      if (key.downArrow) {
+        onNavigate("down");
+        return;
       }
-      return suggestions;
-    }
-    const firstArg = args[0]?.toLowerCase() ?? "";
-    const subgroup = domain.subcommands.get(firstArg);
-    if (subgroup && args.length === 1) {
-      for (const [name, cmd] of subgroup.commands) {
-        if (name.toLowerCase().startsWith(partial.toLowerCase())) {
-          suggestions.push({
-            text: name,
-            description: cmd.descriptionShort,
-            category: "command"
-          });
+      if (key.return || key.tab) {
+        const selected = suggestions.at(selectedIndex);
+        if (selected) {
+          onSelect(selected);
         }
+        return;
       }
-      return suggestions;
-    }
-    if (subgroup && args.length >= 2) {
-      const cmdName = args[1]?.toLowerCase() ?? "";
-      const cmd = subgroup.commands.get(cmdName);
-      if (cmd?.completion) {
-        const completions = await cmd.completion(
-          partial,
-          args.slice(2),
-          session
-        );
-        return completions.map((text) => ({
-          text,
-          description: "",
-          category: "argument"
-        }));
+      if (key.escape) {
+        onCancel();
+        return;
       }
-    }
-    return suggestions;
-  }
-  /**
-   * Show help for a domain using the unified help formatter.
-   * This ensures consistent professional formatting across all domains.
-   */
-  showDomainHelp(domain) {
-    return {
-      output: formatCustomDomainHelp(domain),
-      shouldExit: false,
-      shouldClear: false,
-      contextChanged: false
-    };
-  }
-  /**
-   * Show help for a subcommand group using the unified help formatter.
-   * This ensures consistent professional formatting across all subcommands.
-   */
-  showSubcommandHelp(domain, subgroup) {
-    return {
-      output: formatSubcommandHelp(domain.name, subgroup),
-      shouldExit: false,
-      shouldClear: false,
-      contextChanged: false
-    };
+    },
+    { isActive }
+  );
+  if (suggestions.length === 0) {
+    return null;
   }
-};
-var customDomains = new DomainRegistry();
-function successResult(output, contextChanged = false) {
-  return {
-    output,
-    shouldExit: false,
-    shouldClear: false,
-    contextChanged
-  };
+  const totalCount = suggestions.length;
+  const startIndex = Math.max(
+    0,
+    Math.min(
+      selectedIndex - Math.floor(maxVisible / 2),
+      totalCount - maxVisible
+    )
+  );
+  const visibleSuggestions = suggestions.slice(
+    startIndex,
+    startIndex + maxVisible
+  );
+  const showScrollUp = startIndex > 0;
+  const showScrollDown = startIndex + maxVisible < totalCount;
+  const maxLabelWidth = Math.max(
+    ...visibleSuggestions.map((s) => s.label.length)
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+    Box_default,
+    {
+      flexDirection: "column",
+      borderStyle: "round",
+      borderColor: "#CA260A",
+      paddingX: 1,
+      children: [
+        showScrollUp && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#666666", dimColor: true, children: [
+          "\u25B2",
+          " (",
+          startIndex,
+          " more above)"
+        ] }),
+        visibleSuggestions.map((suggestion, index) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+          SuggestionItem,
+          {
+            suggestion,
+            isSelected: startIndex + index === selectedIndex,
+            index: startIndex + index,
+            maxLabelWidth
+          },
+          suggestion.value
+        )),
+        showScrollDown && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#666666", dimColor: true, children: [
+          "\u25BC",
+          " (",
+          totalCount - startIndex - maxVisible,
+          " more below)"
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Box_default, { marginTop: 1, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: "#666666", dimColor: true, children: "Tab: select | Up/Down: navigate | Esc: cancel" }) })
+      ]
+    }
+  );
 }
-function errorResult(message) {
+
+// src/repl/hooks/useDoubleCtrlC.ts
+var import_react25 = __toESM(require_react(), 1);
+function useDoubleCtrlC(options = {}) {
+  const { windowMs = 500, onFirstPress, onDoublePress } = options;
+  const lastPressRef = (0, import_react25.useRef)(0);
+  const [isWaiting, setIsWaiting] = (0, import_react25.useState)(false);
+  const timeoutRef = (0, import_react25.useRef)(null);
+  const reset = (0, import_react25.useCallback)(() => {
+    lastPressRef.current = 0;
+    setIsWaiting(false);
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+  }, []);
+  const handleCtrlC = (0, import_react25.useCallback)(() => {
+    const now = Date.now();
+    const elapsed = now - lastPressRef.current;
+    if (elapsed < windowMs && lastPressRef.current !== 0) {
+      reset();
+      onDoublePress?.();
+      return true;
+    }
+    lastPressRef.current = now;
+    setIsWaiting(true);
+    onFirstPress?.();
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+    }
+    timeoutRef.current = setTimeout(() => {
+      setIsWaiting(false);
+    }, windowMs);
+    return false;
+  }, [windowMs, onFirstPress, onDoublePress, reset]);
   return {
-    output: [message],
-    shouldExit: false,
-    shouldClear: false,
-    contextChanged: false,
-    error: message
+    handleCtrlC,
+    reset,
+    isWaiting
   };
 }
-function rawStdoutResult(content) {
+
+// src/repl/hooks/useHistory.ts
+var import_react26 = __toESM(require_react(), 1);
+function useHistory(options) {
+  const { history, onSelect } = options;
+  const [historyIndex, setHistoryIndex] = (0, import_react26.useState)(-1);
+  const reset = (0, import_react26.useCallback)(() => {
+    setHistoryIndex(-1);
+  }, []);
+  const navigateUp = (0, import_react26.useCallback)(() => {
+    if (history.length === 0) {
+      return null;
+    }
+    const newIndex = Math.min(historyIndex + 1, history.length - 1);
+    setHistoryIndex(newIndex);
+    const command = history[history.length - 1 - newIndex];
+    if (command !== void 0) {
+      onSelect?.(command);
+      return command;
+    }
+    return null;
+  }, [history, historyIndex, onSelect]);
+  const navigateDown = (0, import_react26.useCallback)(() => {
+    if (historyIndex <= 0) {
+      if (historyIndex === 0) {
+        setHistoryIndex(-1);
+        onSelect?.("");
+        return "";
+      }
+      return null;
+    }
+    const newIndex = historyIndex - 1;
+    setHistoryIndex(newIndex);
+    const command = history[history.length - 1 - newIndex];
+    if (command !== void 0) {
+      onSelect?.(command);
+      return command;
+    }
+    return null;
+  }, [history, historyIndex, onSelect]);
   return {
-    output: [],
-    // No regular output - rawStdout is used instead
-    shouldExit: false,
-    shouldClear: false,
-    contextChanged: false,
-    rawStdout: content
+    navigateUp,
+    navigateDown,
+    reset,
+    isNavigating: historyIndex >= 0,
+    currentIndex: historyIndex
   };
 }
 
+// src/repl/hooks/useCompletion.ts
+var import_react27 = __toESM(require_react(), 1);
+
 // src/domains/login/profile/list.ts
 var listCommand = {
   name: "list",
@@ -53175,6 +53469,10 @@ program2.name(CLI_NAME).description("F5 Distributed Cloud Shell - Interactive CL
       formatRootHelp().forEach((line) => console.log(line));
       process.exit(0);
     }
+    if (options.spec && commandArgs.length === 0) {
+      console.log(formatFullCLISpec());
+      process.exit(0);
+    }
     if (options.help && commandArgs.length > 0) {
       commandArgs.push("--help");
     }
@@ -53201,6 +53499,8 @@ program2.name(CLI_NAME).description("F5 Distributed Cloud Shell - Interactive CL
       process.stdout.write("Initializing...");
       const session = new REPLSession();
       await session.initialize();
+      debugProtocol.session("init", { mode: "repl" });
+      emitSessionState(session);
       process.stdout.write("\r\x1B[K");
       renderBanner(cliLogoMode, "startup");
       if (session.isAuthenticated() && !session.isTokenValidated() && session.getValidationError()) {
@@ -53246,6 +53546,11 @@ program2.name(CLI_NAME).description("F5 Distributed Cloud Shell - Interactive CL
 async function executeNonInteractive(args) {
   const session = new REPLSession();
   await session.initialize();
+  debugProtocol.session("init", {
+    mode: "non-interactive",
+    command: args.join(" ")
+  });
+  emitSessionState(session);
   if (session.isAuthenticated() && !session.isTokenValidated() && session.getValidationError()) {
     console.error(
       `${colors.yellow}Warning: ${session.getValidationError()}${colors.reset}`