ultraenv 1.0.0

package/dist/cli/index.d.cts

@@ -0,0 +1,9 @@
+/**
+ * Run the ultraenv CLI.
+ *
+ * @param argv - The raw argv array (process.argv.slice(2))
+ * @returns The exit code (0 = success, non-zero = failure)
+ */
+declare function run(argv: string[]): Promise<number>;
+
+export { run };

package/dist/cli/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Run the ultraenv CLI.
+ *
+ * @param argv - The raw argv array (process.argv.slice(2))
+ * @returns The exit code (0 = success, non-zero = failure)
+ */
+declare function run(argv: string[]): Promise<number>;
+
+export { run };

package/dist/cli/index.js

@@ -0,0 +1,339 @@
+import {
+  bold,
+  initColorSupport,
+  red
+} from "../chunk-OMAOROL4.js";
+import {
+  configureRenderer,
+  writeError,
+  writeLine
+} from "../chunk-YN2KGTCB.js";
+import {
+  loadConfig
+} from "../chunk-4XUYMRK5.js";
+import "../chunk-3VYXPTYV.js";
+import {
+  VERSION
+} from "../chunk-XC65ORJ5.js";
+import {
+  UltraenvError
+} from "../chunk-5G2DU52U.js";
+
+// src/cli/parser.ts
+var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
+  "init",
+  "validate",
+  "typegen",
+  "sync",
+  "scan",
+  "debug",
+  "protect",
+  "vault",
+  "envs",
+  "ci",
+  "install-hook",
+  "doctor",
+  "completion",
+  "help",
+  "version"
+]);
+var VAULT_SUBCOMMANDS = /* @__PURE__ */ new Set([
+  "init",
+  "encrypt",
+  "decrypt",
+  "rekey",
+  "status",
+  "diff",
+  "verify"
+]);
+var ENVS_SUBCOMMANDS = /* @__PURE__ */ new Set([
+  "list",
+  "compare",
+  "validate",
+  "create",
+  "switch"
+]);
+var CI_SUBCOMMANDS = /* @__PURE__ */ new Set([
+  "validate",
+  "check-sync",
+  "scan",
+  "setup"
+]);
+var OPTIONS_WITH_VALUES = /* @__PURE__ */ new Set([
+  "--config",
+  "--format",
+  "--output",
+  "--cwd",
+  "--env",
+  "--schema",
+  "--out",
+  "--source",
+  "--target",
+  "--shell",
+  "--file",
+  "--exclude",
+  "--include"
+]);
+function parseArgs(args) {
+  const flags = {};
+  const positional = [];
+  const commandParts = [];
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+    if (arg === "") {
+      i++;
+      continue;
+    }
+    if (arg.startsWith("--no-")) {
+      const flagName = arg.slice(5);
+      flags[`--${flagName}`] = false;
+      i++;
+      continue;
+    }
+    if (arg.startsWith("--")) {
+      const eqIndex = arg.indexOf("=");
+      if (eqIndex !== -1) {
+        const key = arg.slice(0, eqIndex);
+        const value = arg.slice(eqIndex + 1);
+        flags[key] = value;
+        i++;
+        continue;
+      }
+      if (OPTIONS_WITH_VALUES.has(arg) && i + 1 < args.length) {
+        const nextArg = args[i + 1];
+        if (!nextArg.startsWith("-")) {
+          flags[arg] = nextArg;
+          i += 2;
+          continue;
+        }
+      }
+      flags[arg] = true;
+      i++;
+      continue;
+    }
+    if (arg.startsWith("-") && arg.length > 1) {
+      const shortFlags = arg.slice(1);
+      for (let j = 0; j < shortFlags.length; j++) {
+        const ch = shortFlags[j];
+        const shortKey = `-${ch}`;
+        if (j === shortFlags.length - 1) {
+          const valuePart = shortFlags.slice(j + 1);
+          if (valuePart.length > 0) {
+            flags[shortKey] = valuePart;
+            break;
+          }
+        }
+        if ((ch === "c" || ch === "f" || ch === "o") && i + 1 < args.length && j === shortFlags.length - 1) {
+          const nextArg = args[i + 1];
+          if (!nextArg.startsWith("-")) {
+            flags[shortKey] = nextArg;
+            i++;
+            break;
+          }
+        }
+        flags[shortKey] = true;
+      }
+      i++;
+      continue;
+    }
+    if (commandParts.length === 0 && KNOWN_COMMANDS.has(arg)) {
+      commandParts.push(arg);
+      i++;
+      if (arg === "vault" && i < args.length && VAULT_SUBCOMMANDS.has(args[i])) {
+        commandParts.push(args[i]);
+        i++;
+      } else if (arg === "envs" && i < args.length && ENVS_SUBCOMMANDS.has(args[i])) {
+        commandParts.push(args[i]);
+        i++;
+      } else if (arg === "ci" && i < args.length && CI_SUBCOMMANDS.has(args[i])) {
+        commandParts.push(args[i]);
+        i++;
+      }
+      continue;
+    }
+    positional.push(arg);
+    i++;
+  }
+  const command = commandParts.length > 0 ? commandParts.join(".") : flags["--help"] || flags["-h"] ? "help" : flags["--version"] || flags["-v"] === "--version" ? "version" : "help";
+  return {
+    command,
+    flags,
+    positional,
+    raw: args
+  };
+}
+
+// src/cli/ui/banner.ts
+function showBanner() {
+  return `
+  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+  \u2551                                                   \u2551
+  \u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557     \u2551
+  \u2551    \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2551 \u2588\u2588\u2554\u255D     \u2551
+  \u2551    \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2554\u255D      \u2551
+  \u2551    \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2588\u2588\u2557      \u2551
+  \u2551    \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2557     \u2551
+  \u2551     \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D     \u2551
+  \u2551                                                   \u2551
+  \u2551   The Ultimate Environment Variable Manager        \u2551
+  \u2551   v${VERSION.padEnd(42)}\u2551
+  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D`.trimStart();
+}
+var TAGLINE = "The Ultimate Environment Variable Manager";
+function showWelcome() {
+  return `${showBanner()}
+  ${TAGLINE}
+`;
+}
+
+// src/cli/index.ts
+import { resolve } from "path";
+var COMMAND_REGISTRY = {
+  // Core commands
+  "init": () => import("../init-Y7JQ2KYJ.js").then((m) => ({ runner: m.run, description: "Initialize project" })),
+  "validate": () => import("../validate-IOAM5HWS.js").then((m) => ({ runner: m.run, description: "Validate environment" })),
+  "typegen": () => import("../typegen-SQOSXBWM.js").then((m) => ({ runner: m.run, description: "Generate TypeScript types" })),
+  "sync": () => import("../sync-TMHMTLH2.js").then((m) => ({ runner: m.run, description: "Sync .env.example" })),
+  "scan": () => import("../scan-TRLY36TT.js").then((m) => ({ runner: m.run, description: "Scan for secrets" })),
+  "debug": () => import("../debug-PTPXAF3K.js").then((m) => ({ runner: m.run, description: "Show diagnostics" })),
+  "protect": () => import("../protect-NCWPM6VC.js").then((m) => ({ runner: m.run, description: "Check .gitignore" })),
+  // Vault subcommands
+  "vault.init": () => import("../vault-init-GUBOTOUL.js").then((m) => ({ runner: m.run, description: "Initialize vault" })),
+  "vault.encrypt": () => import("../vault-encrypt-GUSLCSKS.js").then((m) => ({ runner: m.run, description: "Encrypt to vault" })),
+  "vault.decrypt": () => import("../vault-decrypt-U6HJZNBV.js").then((m) => ({ runner: m.run, description: "Decrypt from vault" })),
+  "vault.rekey": () => import("../vault-rekey-DAHT7JCN.js").then((m) => ({ runner: m.run, description: "Rotate keys" })),
+  "vault.status": () => import("../vault-status-GDLRU2OK.js").then((m) => ({ runner: m.run, description: "Vault status" })),
+  "vault.diff": () => import("../vault-diff-B3ZOQTWI.js").then((m) => ({ runner: m.run, description: "Compare vs vault" })),
+  "vault.verify": () => import("../vault-verify-CD76FJSF.js").then((m) => ({ runner: m.run, description: "Verify integrity" })),
+  // Environment subcommands
+  "envs.list": () => import("../envs-list-NQM5252B.js").then((m) => ({ runner: m.run, description: "List environments" })),
+  "envs.compare": () => import("../envs-compare-5K3HESX5.js").then((m) => ({ runner: m.run, description: "Compare envs" })),
+  "envs.validate": () => import("../envs-validate-FL73Q76T.js").then((m) => ({ runner: m.run, description: "Validate envs" })),
+  "envs.create": () => import("../envs-create-2XXHXMGA.js").then((m) => ({ runner: m.run, description: "Create environment" })),
+  "envs.switch": () => import("../envs-switch-6L2AQYID.js").then((m) => ({ runner: m.run, description: "Switch environment" })),
+  // CI subcommands
+  "ci.validate": () => import("../ci-validate-7AW24LSQ.js").then((m) => ({ runner: m.run, description: "CI validate" })),
+  "ci.check-sync": () => import("../ci-check-sync-VBMSVWIV.js").then((m) => ({ runner: m.run, description: "CI sync check" })),
+  "ci.scan": () => import("../ci-scan-24MT5XGS.js").then((m) => ({ runner: m.run, description: "CI scan" })),
+  "ci.setup": () => import("../ci-setup-C2NKEFRD.js").then((m) => ({ runner: m.run, description: "CI setup" })),
+  // Utility commands
+  "install-hook": () => import("../install-hook-SKXIV6NV.js").then((m) => ({ runner: m.run, description: "Install git hook" })),
+  "doctor": () => import("../doctor-FZAUPKHS.js").then((m) => ({ runner: m.run, description: "Self-check" })),
+  "completion": () => import("../completion-MW35C2XO.js").then((m) => ({ runner: m.run, description: "Shell completions" })),
+  "help": () => import("../help-3XJBXEHE.js").then((m) => ({ runner: m.run, description: "Show help" }))
+};
+function handleVersion() {
+  writeLine(`ultraenv v${VERSION}`);
+  return 0;
+}
+function resolveConfig(args) {
+  const configPath = args.flags["--config"];
+  const cwd = resolve(args.flags["--cwd"] ?? process.cwd());
+  const config = loadConfig(configPath);
+  const outputFormat = args.flags["--format"] ?? config.outputFormat;
+  const debug = args.flags["--debug"] ?? config.debug ?? false;
+  const quiet = args.flags["--quiet"] ?? args.flags["-q"] ?? config.silent ?? false;
+  return { config, cwd, outputFormat, debug, quiet };
+}
+async function run(argv) {
+  const args = parseArgs(argv);
+  if (args.flags["--version"] || args.flags["-v"] === "--version" || args.command === "version") {
+    return handleVersion();
+  }
+  if (args.flags["--help"] || args.flags["-h"] || args.command === "help") {
+    const config2 = resolveConfig(args);
+    configureRenderer({
+      quiet: config2.quiet,
+      debug: config2.debug,
+      format: config2.outputFormat
+    });
+    if (args.positional.length > 0) {
+      const helpCmd2 = COMMAND_REGISTRY["help"];
+      if (helpCmd2) {
+        const entry = await helpCmd2();
+        return entry.runner(args, { config: config2.config, cwd: config2.cwd, colorEnabled: true, debug: config2.debug, quiet: config2.quiet, outputFormat: config2.outputFormat });
+      }
+      return 1;
+    }
+    const helpCmd = COMMAND_REGISTRY["help"];
+    if (helpCmd) {
+      const entry = await helpCmd();
+      return entry.runner(args, { config: config2.config, cwd: config2.cwd, colorEnabled: true, debug: config2.debug, quiet: config2.quiet, outputFormat: config2.outputFormat });
+    }
+    return 1;
+  }
+  const { config, cwd, outputFormat, debug, quiet } = resolveConfig(args);
+  const noColor = args.flags["--no-color"];
+  initColorSupport(noColor);
+  configureRenderer({
+    quiet,
+    debug,
+    format: outputFormat
+  });
+  const ctx = {
+    config,
+    cwd,
+    colorEnabled: !noColor,
+    debug,
+    quiet,
+    outputFormat
+  };
+  if (!quiet && outputFormat === "terminal") {
+    if (!args.command.includes(".") && args.command !== "completion") {
+      writeLine(showWelcome());
+    }
+  }
+  const commandLoader = COMMAND_REGISTRY[args.command];
+  if (!commandLoader) {
+    writeError(red(bold(`  Unknown command: ${args.command}`)));
+    writeLine("");
+    writeError('  Run "ultraenv help" to see available commands.');
+    writeLine("");
+    return 1;
+  }
+  try {
+    const entry = await commandLoader();
+    const exitCode = await entry.runner(args, ctx);
+    return exitCode;
+  } catch (error) {
+    if (error instanceof UltraenvError) {
+      if (outputFormat === "json") {
+        writeError(JSON.stringify({
+          error: true,
+          code: error.code,
+          message: error.message,
+          hint: error.hint
+        }, null, 2));
+      } else {
+        writeError("");
+        writeError(red(bold(`  [${error.code}] ${error.message}`)));
+        if (error.hint) {
+          writeError("");
+          writeError(`  Hint: ${error.hint}`);
+        }
+        writeError("");
+      }
+      return 1;
+    }
+    if (outputFormat === "json") {
+      writeError(JSON.stringify({
+        error: true,
+        message: error instanceof Error ? error.message : String(error)
+      }, null, 2));
+    } else {
+      writeError("");
+      writeError(red(bold("  Unexpected error:")));
+      writeError(red(`  ${error instanceof Error ? error.message : String(error)}`));
+      if (debug && error instanceof Error && error.stack) {
+        writeError("");
+        writeError(error.stack);
+      }
+      writeError("");
+    }
+    return 1;
+  }
+}
+export {
+  run
+};

package/dist/comparator-RDKX3OI7.js

@@ -0,0 +1,13 @@
+import {
+  compareSync,
+  compareValues,
+  formatSyncDiff
+} from "./chunk-YVWLXFUT.js";
+import "./chunk-HFXQGJY3.js";
+import "./chunk-3VYXPTYV.js";
+import "./chunk-5G2DU52U.js";
+export {
+  compareSync,
+  compareValues,
+  formatSyncDiff
+};

package/dist/completion-MW35C2XO.js

@@ -0,0 +1,168 @@
+import {
+  writeError,
+  writeLine
+} from "./chunk-YN2KGTCB.js";
+
+// src/cli/commands/completion.ts
+var BASH_COMPLETION = `# ultraenv bash completion
+_ultraenv_completions() {
+    local cur prev words cword
+    _init_completion || return
+
+    local commands="init validate typegen sync scan debug protect vault envs ci install-hook doctor completion help version"
+    local vault_cmds="init encrypt decrypt rekey status diff verify"
+    local envs_cmds="list compare validate create switch"
+    local ci_cmds="validate check-sync scan setup"
+
+    if [[ \${cword} -eq 1 ]]; then
+        COMPREPLY=($(compgen -W "\${commands}" -- "\${cur}"))
+        return
+    fi
+
+    if [[ "\${prev}" == "vault" ]]; then
+        COMPREPLY=($(compgen -W "\${vault_cmds}" -- "\${cur}"))
+        return
+    fi
+
+    if [[ "\${prev}" == "envs" ]]; then
+        COMPREPLY=($(compgen -W "\${envs_cmds}" -- "\${cur}"))
+        return
+    fi
+
+    if [[ "\${prev}" == "ci" ]]; then
+        COMPREPLY=($(compgen -W "\${ci_cmds}" -- "\${cur}"))
+        return
+    fi
+
+    # Complete flags
+    local flags="--help -h --version -v --no-color --verbose --quiet -q --strict --debug --cwd --config --format"
+    COMPREPLY=($(compgen -W "\${flags}" -- "\${cur}"))
+}
+
+complete -F _ultraenv_completions ultraenv
+`;
+var ZSH_COMPLETION = `#compdef ultraenv
+
+_ultraenv() {
+    local -a commands
+    commands=(
+        'init:Initialize ultraenv project'
+        'validate:Validate environment'
+        'typegen:Generate TypeScript types'
+        'sync:Sync .env.example'
+        'scan:Scan for secrets'
+        'debug:Show diagnostics'
+        'protect:Check .gitignore protection'
+        'vault:Vault operations'
+        'envs:Environment management'
+        'ci:CI/CD operations'
+        'install-hook:Install git hook'
+        'doctor:Self-check'
+        'completion:Shell completions'
+        'help:Show help'
+        'version:Show version'
+    )
+
+    local -a vault_cmds
+    vault_cmds=(init encrypt decrypt rekey status diff verify)
+
+    local -a envs_cmds
+    envs_cmds=(list compare validate create switch)
+
+    local -a ci_cmds
+    ci_cmds=(validate check-sync scan setup)
+
+    local -a flags
+    flags=(--help -h --version --no-color --verbose --quiet --strict --debug --cwd --config --format)
+
+    if (( CURRENT == 2 )); then
+        _describe 'command' commands
+        return
+    fi
+
+    case $words[2] in
+        vault)
+            if (( CURRENT == 3 )); then
+                _describe 'vault command' vault_cmds
+            fi
+            ;;
+        envs)
+            if (( CURRENT == 3 )); then
+                _describe 'envs command' envs_cmds
+            fi
+            ;;
+        ci)
+            if (( CURRENT == 3 )); then
+                _describe 'ci command' ci_cmds
+            fi
+            ;;
+        *)
+            _describe 'flags' flags
+            ;;
+    esac
+}
+
+_ultraenv "$@"
+`;
+var FISH_COMPLETION = `# ultraenv fish shell completion
+
+# Disable file completions
+complete -c ultraenv -f
+
+# Main commands
+complete -c ultraenv -n '__fish_is_first_arg' -a init validate typegen sync scan debug protect vault envs ci install-hook doctor completion help version
+
+# Vault subcommands
+complete -c ultraenv -n '__fish_seen_subcommand_from vault' -a init encrypt decrypt rekey status diff verify
+
+# Envs subcommands
+complete -c ultraenv -n '__fish_seen_subcommand_from envs' -a list compare validate create switch
+
+# CI subcommands
+complete -c ultraenv -n '__fish_seen_subcommand_from ci' -a validate check-sync scan setup
+
+# Global flags
+complete -c ultraenv -l help -s h -d 'Show help'
+complete -c ultraenv -l version -d 'Show version'
+complete -c ultraenv -l no-color -d 'Disable colors'
+complete -c ultraenv -l verbose -s v -d 'Verbose output'
+complete -c ultraenv -l quiet -s q -d 'Quiet output'
+complete -c ultraenv -l strict -d 'Strict mode'
+complete -c ultraenv -l debug -d 'Debug output'
+complete -c ultraenv -l cwd -d 'Working directory'
+complete -c ultraenv -l config -d 'Config file path'
+complete -c ultraenv -l format -d 'Output format'
+`;
+async function run(args, _ctx) {
+  const shell = args.flags["--shell"] ?? args.positional[0];
+  if (!shell || shell === "help") {
+    writeLine("  Usage: ultraenv completion <shell>");
+    writeLine("");
+    writeLine("  Available shells: bash, zsh, fish");
+    writeLine("");
+    writeLine("  Install:");
+    writeLine('    eval "$(ultraenv completion bash)"');
+    writeLine('    eval "$(ultraenv completion zsh)"');
+    writeLine("    ultraenv completion fish | source");
+    writeLine("");
+    return 0;
+  }
+  switch (shell) {
+    case "bash":
+      process.stdout.write(BASH_COMPLETION);
+      return 0;
+    case "zsh":
+      process.stdout.write(ZSH_COMPLETION);
+      return 0;
+    case "fish":
+      process.stdout.write(FISH_COMPLETION);
+      return 0;
+    default:
+      writeError(`  Unsupported shell: ${shell}`);
+      writeError("  Supported: bash, zsh, fish");
+      return 1;
+  }
+}
+export {
+  run
+};

package/dist/config-O5YRQP5Z.js

@@ -0,0 +1,13 @@
+import {
+  DEFAULT_CONFIG,
+  findConfig,
+  loadConfig
+} from "./chunk-4XUYMRK5.js";
+import "./chunk-3VYXPTYV.js";
+import "./chunk-XC65ORJ5.js";
+import "./chunk-5G2DU52U.js";
+export {
+  DEFAULT_CONFIG,
+  findConfig,
+  loadConfig
+};

package/dist/debug-PTPXAF3K.js

@@ -0,0 +1,131 @@
+import {
+  drawTable
+} from "./chunk-WMHN5RW2.js";
+import {
+  isGitRepository
+} from "./chunk-R7PZRSZ7.js";
+import {
+  loadWithResult
+} from "./chunk-MNVFG7H4.js";
+import "./chunk-HFXQGJY3.js";
+import {
+  bold,
+  cyan,
+  dim,
+  green,
+  red,
+  yellow
+} from "./chunk-OMAOROL4.js";
+import {
+  writeError,
+  writeLine
+} from "./chunk-YN2KGTCB.js";
+import {
+  findConfig
+} from "./chunk-4XUYMRK5.js";
+import "./chunk-3VYXPTYV.js";
+import {
+  VERSION
+} from "./chunk-XC65ORJ5.js";
+import "./chunk-5G2DU52U.js";
+
+// src/cli/commands/debug.ts
+import { resolve } from "path";
+import { existsSync } from "fs";
+async function run(args, ctx) {
+  try {
+    const cwd = args.flags["--cwd"] ?? ctx.cwd;
+    const baseDir = resolve(cwd);
+    writeLine(bold("\u{1F527} ultraenv Diagnostics"));
+    writeLine("");
+    writeLine(bold("  System Information:"));
+    writeLine(`    ultraenv version: ${cyan(VERSION)}`);
+    writeLine(`    Node.js:          ${cyan(process.version)}`);
+    writeLine(`    Platform:         ${cyan(process.platform)} ${process.arch}`);
+    writeLine(`    CWD:              ${cyan(baseDir)}`);
+    writeLine(`    TTY:              ${cyan(String(process.stdout.isTTY))}`);
+    writeLine("");
+    writeLine(bold("  Git Status:"));
+    const isGit = await isGitRepository(baseDir);
+    writeLine(`    Repository:      ${isGit ? green("Yes") : yellow("No")}`);
+    if (isGit) {
+      const { getCurrentBranch, isDirty, getCommitHash } = await import("./git-BZS4DPAI.js");
+      const branch = await getCurrentBranch(baseDir);
+      const dirty = await isDirty(baseDir);
+      const commit = await getCommitHash(baseDir);
+      writeLine(`    Branch:          ${cyan(branch ?? "detached")}`);
+      writeLine(`    Dirty:           ${dirty ? yellow("Yes") : green("No")}`);
+      writeLine(`    Commit:          ${cyan(commit ?? "unknown")}`);
+    }
+    writeLine("");
+    writeLine(bold("  Configuration:"));
+    const configPath = findConfig(baseDir);
+    if (configPath !== null) {
+      writeLine(`    Config file:     ${cyan(configPath)}`);
+    } else {
+      writeLine(`    Config file:     ${yellow("Not found (using defaults)")}`);
+    }
+    writeLine(`    envDir:          ${cyan(ctx.config.envDir)}`);
+    writeLine(`    mergeStrategy:   ${cyan(ctx.config.mergeStrategy)}`);
+    writeLine(`    expandVars:      ${cyan(String(ctx.config.expandVariables))}`);
+    writeLine(`    outputFormat:    ${cyan(ctx.config.outputFormat)}`);
+    writeLine(`    debug:           ${cyan(String(ctx.config.debug))}`);
+    writeLine("");
+    writeLine(bold("  Environment Files:"));
+    const envFiles = [
+      ".env",
+      ".env.local",
+      ".env.development",
+      ".env.production",
+      ".env.staging",
+      ".env.test",
+      ".env.ci"
+    ];
+    const fileHeaders = ["File", "Exists", "Size", "Modified"];
+    const fileRows = [];
+    for (const file of envFiles) {
+      const filePath = resolve(baseDir, ctx.config.envDir, file);
+      const exists = existsSync(filePath);
+      if (exists) {
+        const stat = await import("fs/promises").then((m) => m.stat(filePath));
+        const size = `${(stat.size / 1024).toFixed(1)} KB`;
+        const modified = stat.mtime.toISOString().slice(0, 19).replace("T", " ");
+        fileRows.push([file, green("Yes"), size, modified]);
+      } else {
+        fileRows.push([file, dim("No"), "-", "-"]);
+      }
+    }
+    writeLine(drawTable(fileHeaders, fileRows, { maxWidth: 100 }));
+    writeLine("");
+    writeLine(bold("  Load Test:"));
+    const startTime = Date.now();
+    try {
+      const result = loadWithResult({
+        envDir: baseDir,
+        expandVariables: ctx.config.expandVariables,
+        overrideProcessEnv: false
+      });
+      const loadTime = Date.now() - startTime;
+      writeLine(`    Status:          ${green("Success")}`);
+      writeLine(`    Variables:       ${cyan(String(result.metadata.totalVars))}`);
+      writeLine(`    Files parsed:    ${cyan(String(result.metadata.filesParsed))}`);
+      writeLine(`    Load time:       ${cyan(`${loadTime}ms`)}`);
+    } catch (err) {
+      const loadTime = Date.now() - startTime;
+      writeLine(`    Status:          ${red("Failed")}`);
+      writeLine(`    Load time:       ${cyan(`${loadTime}ms`)}`);
+      writeLine(`    Error:           ${red(err instanceof Error ? err.message : String(err))}`);
+    }
+    writeLine("");
+    writeLine(green(bold("  Diagnostics complete.")));
+    writeLine("");
+    return 0;
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    writeError(red(`  Diagnostics error: ${msg}`));
+    return 1;
+  }
+}
+export {
+  run
+};