@outfitter/cli 0.2.0 → 0.4.0

package/README.md

@@ -36,7 +36,7 @@ if (cursor) {
 
 Output data to the console with automatic mode selection.
 
-Defaults to human-friendly output for TTY, JSON for non-TTY. Override via `mode` option or `OUTFITTER_JSON`/`OUTFITTER_JSONL` environment variables.
+Defaults to human-friendly output. Override via `mode` option or `OUTFITTER_JSON`/`OUTFITTER_JSONL` environment variables.
 
 ```typescript
 import { output } from "@outfitter/cli/output";
@@ -278,10 +278,10 @@ if (result.isOk()) {
 
 #### `confirmDestructive(options)`
 
-Prompt for confirmation before destructive operations. Respects `--yes` flag for non-interactive mode.
+> **Moved to `@outfitter/tui`** -- This function is now exported from `@outfitter/tui/confirm`. Update your imports accordingly.
 
 ```typescript
-import { confirmDestructive } from "@outfitter/cli/input";
+import { confirmDestructive } from "@outfitter/tui/confirm";
 
 const result = await confirmDestructive({
   message: "Delete 5 notes?",
@@ -367,17 +367,56 @@ if (flags.reset) {
 
 | Variable | Description | Default |
 |----------|-------------|---------|
+| `OUTFITTER_ENV` | Environment profile (`development`, `production`, `test`) | `production` |
+| `OUTFITTER_VERBOSE` | Override verbose mode (`1` or `0`) | - |
 | `OUTFITTER_JSON` | Set to `1` to force JSON output | - |
 | `OUTFITTER_JSONL` | Set to `1` to force JSONL output (takes priority over JSON) | - |
 | `XDG_STATE_HOME` | State directory for pagination | Platform-specific |
 
+### `resolveVerbose(verbose?)`
+
+Resolve verbose mode from environment configuration. Use this instead of hardcoding verbosity so your CLI responds to `OUTFITTER_ENV` and `OUTFITTER_VERBOSE` automatically.
+
+**Precedence** (highest wins):
+1. `OUTFITTER_VERBOSE` environment variable (`"1"` or `"0"`)
+2. Explicit `verbose` parameter (from `--verbose` CLI flag)
+3. `OUTFITTER_ENV` profile defaults (`true` in development)
+4. `false` (default)
+
+```typescript
+import { resolveVerbose } from "@outfitter/cli/output";
+
+const isVerbose = resolveVerbose();
+// With OUTFITTER_ENV=development → true
+// With OUTFITTER_VERBOSE=0 → false (overrides everything)
+// With nothing set → false
+
+// Pass through from CLI flag
+const isVerbose = resolveVerbose(cliFlags.verbose);
+```
+
+### JSON Output
+
+`createCLI()` registers a global `--json` flag that bridges to `OUTFITTER_JSON=1` via a `preAction` hook. This means `output()` auto-detects JSON mode — no manual `if (json)` branching needed:
+
+```typescript
+// No need for this:
+if (opts.json) output(data, { mode: "json" });
+else output(data);
+
+// Just use output() directly — it reads OUTFITTER_JSON:
+output(data);
+```
+
+The bridge uses `optsWithGlobals()` so global and subcommand `--json` flags both work and coalesce into a single env var. Subcommands should **not** define their own `--json` — use the global flag. If they do, both coalesce safely.
+
 ### Output Mode Priority
 
 1. Explicit `mode` option in `output()` call
 2. `OUTFITTER_JSONL=1` environment variable (highest env priority)
 3. `OUTFITTER_JSON=1` environment variable
 4. `OUTFITTER_JSON=0` or `OUTFITTER_JSONL=0` forces human mode
-5. TTY detection: `json` for non-TTY, `human` for TTY
+5. Default fallback: `human`
 
 ## Error Handling
 
@@ -420,6 +459,10 @@ import type { CollectIdsOptions, ExpandFileOptions, ParseGlobOptions } from "@ou
 import type { PaginationState, CursorOptions } from "@outfitter/cli/pagination";
 ```
 
+## Upgrading
+
+Run `outfitter update --guide` for version-specific migration instructions, or check the [migration docs](https://github.com/outfitter-dev/outfitter/tree/main/plugins/outfitter/shared/migrations) for detailed upgrade steps.
+
 ## License
 
 MIT

package/dist/actions.js

@@ -1,6 +1,4 @@
 // @bun
-import"./shared/@outfitter/cli-v1tzwxkt.js";
-
 // packages/cli/src/actions.ts
 import {
   createContext as createHandlerContext,

package/dist/cli.d.ts

@@ -1,4 +1,4 @@
-import { CLI, CLIConfig } from "./shared/@outfitter/cli-ttt7r0j7";
+import { CLI, CLIConfig } from "./shared/@outfitter/cli-02kyvj7h";
 /**
 * Create a new CLI instance with the given configuration.
 *

package/dist/cli.js

@@ -1,8 +1,7 @@
 // @bun
 import {
   createCLI
-} from "./shared/@outfitter/cli-efy6jfcj.js";
-import"./shared/@outfitter/cli-v1tzwxkt.js";
+} from "./shared/@outfitter/cli-zahqsaby.js";
 export {
   createCLI
 };

package/dist/{render → colors}/colors.d.ts

@@ -1,2 +1,2 @@
-import { ANSI, ColorName, Theme, TokenOptions, Tokens, applyColor, createTheme, createTokens, resolveTokenColorEnabled } from "../shared/@outfitter/cli-ykxn7rb2";
+import { ANSI, ColorName, Theme, TokenOptions, Tokens, applyColor, createTheme, createTokens, resolveTokenColorEnabled } from "../shared/@outfitter/cli-xppg982q";
 export { resolveTokenColorEnabled, createTokens, createTheme, applyColor, Tokens, TokenOptions, Theme, ColorName, ANSI };

package/dist/{render → colors}/colors.js

@@ -4,13 +4,9 @@ import {
   applyColor,
   createTheme,
   createTokens,
-  init_colors,
   resolveTokenColorEnabled
-} from "../shared/@outfitter/cli-5g6rkv3d.js";
-import"../shared/@outfitter/cli-d9ad0rqj.js";
-import"../shared/@outfitter/cli-v1tzwxkt.js";
-init_colors();
-
+} from "../shared/@outfitter/cli-rk9zagkm.js";
+import"../shared/@outfitter/cli-jbj78ac5.js";
 export {
   resolveTokenColorEnabled,
   createTokens,

package/dist/colors/index.d.ts

@@ -1,3 +1,3 @@
 import "../shared/@outfitter/cli-qz47jk6d";
-import { ANSI, ColorName, Theme, TokenOptions, Tokens, applyColor, createTheme, createTokens, resolveTokenColorEnabled } from "../shared/@outfitter/cli-ykxn7rb2";
+import { ANSI, ColorName, Theme, TokenOptions, Tokens, applyColor, createTheme, createTokens, resolveTokenColorEnabled } from "../shared/@outfitter/cli-xppg982q";
 export { resolveTokenColorEnabled, createTokens, createTheme, applyColor, Tokens, TokenOptions, Theme, ColorName, ANSI };

package/dist/colors/index.js

@@ -1,14 +1,13 @@
 // @bun
-import"../shared/@outfitter/cli-47yw5h6a.js";
+import"../shared/@outfitter/cli-zw75pdk8.js";
 import {
   ANSI,
   applyColor,
   createTheme,
   createTokens,
   resolveTokenColorEnabled
-} from "../shared/@outfitter/cli-5g6rkv3d.js";
-import"../shared/@outfitter/cli-d9ad0rqj.js";
-import"../shared/@outfitter/cli-v1tzwxkt.js";
+} from "../shared/@outfitter/cli-rk9zagkm.js";
+import"../shared/@outfitter/cli-jbj78ac5.js";
 export {
   resolveTokenColorEnabled,
   createTokens,

package/dist/command.d.ts

@@ -1,4 +1,4 @@
-import { CLI, CLIConfig, CommandAction, CommandBuilder, CommandConfig, CommandFlags } from "./shared/@outfitter/cli-ttt7r0j7";
+import { CLI, CLIConfig, CommandAction, CommandBuilder, CommandConfig, CommandFlags } from "./shared/@outfitter/cli-02kyvj7h";
 /**
 * Create a CLI instance with a portable return type from this module.
 */

package/dist/command.js

@@ -1,8 +1,7 @@
 // @bun
 import {
   createCLI
-} from "./shared/@outfitter/cli-efy6jfcj.js";
-import"./shared/@outfitter/cli-v1tzwxkt.js";
+} from "./shared/@outfitter/cli-zahqsaby.js";
 
 // packages/cli/src/command.ts
 import { Command } from "commander";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import "./shared/@outfitter/cli-qz47jk6d";
-import { ANSI, Theme, Tokens, createTheme } from "./shared/@outfitter/cli-ykxn7rb2";
-import { output } from "./shared/@outfitter/cli-72kg550t";
-import { OutputMode } from "./shared/@outfitter/cli-ttt7r0j7";
+import { ANSI, Theme, Tokens, createTheme } from "./shared/@outfitter/cli-xppg982q";
+import { output } from "./shared/@outfitter/cli-f79bwzsp";
+import { OutputMode } from "./shared/@outfitter/cli-02kyvj7h";
 export { output, createTheme, Tokens, Theme, OutputMode, ANSI };

package/dist/index.js

@@ -1,14 +1,13 @@
 // @bun
-import"./shared/@outfitter/cli-47yw5h6a.js";
+import"./shared/@outfitter/cli-zw75pdk8.js";
 import {
   ANSI,
   createTheme
-} from "./shared/@outfitter/cli-5g6rkv3d.js";
-import"./shared/@outfitter/cli-d9ad0rqj.js";
+} from "./shared/@outfitter/cli-rk9zagkm.js";
+import"./shared/@outfitter/cli-jbj78ac5.js";
 import {
   output
-} from "./shared/@outfitter/cli-8gg0hck1.js";
-import"./shared/@outfitter/cli-v1tzwxkt.js";
+} from "./shared/@outfitter/cli-7wp5nj0s.js";
 export {
   output,
   createTheme,

package/dist/input.d.ts

@@ -1,5 +1,5 @@
-import { CollectIdsOptions, ConfirmDestructiveOptions, ExpandFileOptions, FilterExpression, KeyValuePair, NormalizeIdOptions, ParseGlobOptions, Range, SortCriteria } from "./shared/@outfitter/cli-ttt7r0j7";
-import { CancelledError, ValidationError } from "@outfitter/contracts";
+import { CollectIdsOptions, ExpandFileOptions, FilterExpression, KeyValuePair, NormalizeIdOptions, ParseGlobOptions, Range, SortCriteria } from "./shared/@outfitter/cli-02kyvj7h";
+import { ValidationError } from "@outfitter/contracts";
 import { Result } from "better-result";
 /**
 * Collect IDs from various input formats.
@@ -138,27 +138,4 @@ declare function parseSortSpec(input: string): Result<SortCriteria[], InstanceTy
 * ```
 */
 declare function normalizeId(input: string, options?: NormalizeIdOptions): Result<string, InstanceType<typeof ValidationError>>;
-/**
-* Prompt for confirmation before destructive operations.
-*
-* Respects --yes flag for non-interactive mode.
-*
-* @param options - Confirmation options
-* @returns Whether the user confirmed
-*
-* @example
-* ```typescript
-* const confirmed = await confirmDestructive({
-*   message: "Delete 5 notes?",
-*   bypassFlag: flags.yes,
-*   itemCount: 5,
-* });
-*
-* if (confirmed.isErr()) {
-*   // User cancelled
-*   process.exit(0);
-* }
-* ```
-*/
-declare function confirmDestructive(options: ConfirmDestructiveOptions): Promise<Result<boolean, InstanceType<typeof CancelledError>>>;
-export { parseSortSpec, parseRange, parseKeyValue, parseGlob, parseFilter, normalizeId, expandFileArg, confirmDestructive, collectIds };
+export { parseSortSpec, parseRange, parseKeyValue, parseGlob, parseFilter, normalizeId, expandFileArg, collectIds };

package/dist/input.js

@@ -1,11 +1,7 @@
 // @bun
-import {
-  __require
-} from "./shared/@outfitter/cli-v1tzwxkt.js";
-
 // packages/cli/src/input.ts
 import path from "path";
-import { CancelledError, ValidationError } from "@outfitter/contracts";
+import { ValidationError } from "@outfitter/contracts";
 import { Err, Ok } from "better-result";
 function isSecurePath(filePath, allowAbsolute = false) {
   if (filePath.includes("\x00")) {
@@ -400,31 +396,6 @@ function normalizeId(input, options) {
   }
   return new Ok(normalized);
 }
-async function confirmDestructive(options) {
-  const { message, bypassFlag = false, itemCount } = options;
-  if (bypassFlag) {
-    return new Ok(true);
-  }
-  const isTTY = process.stdout.isTTY;
-  const isDumbTerminal = process.env["TERM"] === "dumb";
-  if (!isTTY || isDumbTerminal) {
-    return new Err(new CancelledError({
-      message: "Cannot prompt for confirmation in non-interactive mode. Use --yes to bypass."
-    }));
-  }
-  let promptMessage = message;
-  if (itemCount !== undefined) {
-    promptMessage = `${message} (${itemCount} items)`;
-  }
-  const { confirm, isCancel } = await import("@clack/prompts");
-  const response = await confirm({ message: promptMessage });
-  if (isCancel(response) || response === false) {
-    return new Err(new CancelledError({
-      message: "Operation cancelled by user."
-    }));
-  }
-  return new Ok(true);
-}
 export {
   parseSortSpec,
   parseRange,
@@ -433,6 +404,5 @@ export {
   parseFilter,
   normalizeId,
   expandFileArg,
-  confirmDestructive,
   collectIds
 };

package/dist/output.d.ts

@@ -1,3 +1,3 @@
-import { exitWithError, output } from "./shared/@outfitter/cli-72kg550t";
-import "./shared/@outfitter/cli-ttt7r0j7";
-export { output, exitWithError };
+import { exitWithError, output, resolveVerbose } from "./shared/@outfitter/cli-f79bwzsp";
+import "./shared/@outfitter/cli-02kyvj7h";
+export { resolveVerbose, output, exitWithError };

package/dist/output.js

@@ -1,10 +1,11 @@
 // @bun
 import {
   exitWithError,
-  output
-} from "./shared/@outfitter/cli-8gg0hck1.js";
-import"./shared/@outfitter/cli-v1tzwxkt.js";
+  output,
+  resolveVerbose
+} from "./shared/@outfitter/cli-7wp5nj0s.js";
 export {
+  resolveVerbose,
   output,
   exitWithError
 };

package/dist/pagination.d.ts

@@ -1,4 +1,4 @@
-import { CursorOptions, PaginationState } from "./shared/@outfitter/cli-ttt7r0j7";
+import { CursorOptions, PaginationState } from "./shared/@outfitter/cli-02kyvj7h";
 /**
 * Load persisted pagination state for a command.
 *

package/dist/pagination.js

@@ -1,6 +1,4 @@
 // @bun
-import"./shared/@outfitter/cli-v1tzwxkt.js";
-
 // packages/cli/src/pagination.ts
 import fs from "fs";
 import os from "os";

package/dist/shared/@outfitter/{cli-ttt7r0j7.d.ts → cli-02kyvj7h.d.ts}

@@ -23,7 +23,7 @@ interface CLIConfig {
 	/** Custom error handler */
 	readonly onError?: (error: Error) => void;
 	/** Custom exit handler (defaults to process.exit) */
-	readonly onExit?: (code: number) => never;
+	readonly onExit?: (code: number) => void | Promise<void>;
 }
 /**
 * CLI instance returned by createCLI.
@@ -164,17 +164,6 @@ interface NormalizeIdOptions {
 	readonly pattern?: RegExp;
 }
 /**
-* Options for confirmDestructive().
-*/
-interface ConfirmDestructiveOptions {
-	/** Message to display to the user */
-	readonly message: string;
-	/** Whether to bypass confirmation (e.g., --yes flag) */
-	readonly bypassFlag?: boolean;
-	/** Number of items affected (shown in confirmation) */
-	readonly itemCount?: number;
-}
-/**
 * Numeric or date range parsed from CLI input.
 */
 type Range = NumericRange | DateRange;
@@ -250,4 +239,4 @@ interface CursorOptions {
 	/** Total count of results (if known) */
 	readonly total?: number;
 }
-export { CLIConfig, CLI, CommandConfig, CommandAction, CommandFlags, CommandBuilder, OutputMode, OutputOptions, CollectIdsOptions, ExpandFileOptions, ParseGlobOptions, NormalizeIdOptions, ConfirmDestructiveOptions, Range, NumericRange, DateRange, FilterExpression, SortCriteria, KeyValuePair, PaginationState, CursorOptions, CancelledError, ErrorCategory, ValidationError, Result };
+export { CLIConfig, CLI, CommandConfig, CommandAction, CommandFlags, CommandBuilder, OutputMode, OutputOptions, CollectIdsOptions, ExpandFileOptions, ParseGlobOptions, NormalizeIdOptions, Range, NumericRange, DateRange, FilterExpression, SortCriteria, KeyValuePair, PaginationState, CursorOptions, CancelledError, ErrorCategory, ValidationError, Result };

package/dist/shared/@outfitter/{cli-8gg0hck1.js → cli-7wp5nj0s.js}

@@ -1,5 +1,6 @@
 // @bun
 // packages/cli/src/output.ts
+import { getEnvironment, getEnvironmentDefaults } from "@outfitter/config";
 import {
   safeStringify as contractsSafeStringify,
   exitCodeMap
@@ -19,14 +20,6 @@ function writeWithBackpressure(stream, data) {
     }
   });
 }
-function getStreamIsTTY(stream) {
-  if (!stream)
-    return;
-  if ("isTTY" in stream) {
-    return Boolean(stream.isTTY);
-  }
-  return;
-}
 function detectMode(options) {
   if (options?.mode) {
     return options.mode;
@@ -39,9 +32,7 @@ function detectMode(options) {
     return "json";
   if (envJsonl === "0" || envJson === "0")
     return "human";
-  const streamIsTTY = getStreamIsTTY(options?.stream);
-  const isTTY = streamIsTTY ?? process.stdout.isTTY;
-  return isTTY ? "human" : "json";
+  return "human";
 }
 function isValidCategory(category) {
   return category in exitCodeMap;
@@ -161,5 +152,18 @@ function exitWithError(error, options) {
   }
   process.exit(exitCode);
 }
+function resolveVerbose(verbose) {
+  const envVerbose = process.env["OUTFITTER_VERBOSE"];
+  if (envVerbose === "1")
+    return true;
+  if (envVerbose === "0")
+    return false;
+  if (verbose !== undefined) {
+    return verbose;
+  }
+  const env = getEnvironment();
+  const defaults = getEnvironmentDefaults(env);
+  return defaults.verbose;
+}
 
-export { output, exitWithError };
+export { output, exitWithError, resolveVerbose };

package/dist/shared/@outfitter/{cli-72kg550t.d.ts → cli-f79bwzsp.d.ts}

@@ -1,4 +1,4 @@
-import { OutputOptions } from "./cli-ttt7r0j7";
+import { OutputOptions } from "./cli-02kyvj7h";
 /**
 * Output data to the console with automatic mode selection.
 *
@@ -50,4 +50,32 @@ declare function output(data: unknown, options?: OutputOptions): Promise<void>;
 * ```
 */
 declare function exitWithError(error: Error, options?: OutputOptions): never;
-export { output, exitWithError };
+/**
+* Resolve verbose mode from environment configuration.
+*
+* Precedence (highest wins):
+* 1. `OUTFITTER_VERBOSE` environment variable (`"1"` or `"0"`)
+* 2. Explicit `verbose` parameter (from CLI flag)
+* 3. `OUTFITTER_ENV` environment profile defaults
+* 4. `false` (default)
+*
+* @param verbose - Optional explicit verbose flag (e.g. from --verbose CLI flag)
+* @returns Whether verbose mode is enabled
+*
+* @example
+* ```typescript
+* import { resolveVerbose } from "@outfitter/cli/output";
+*
+* // Auto-resolve from environment
+* const isVerbose = resolveVerbose();
+*
+* // With OUTFITTER_ENV=development → true
+* // With OUTFITTER_VERBOSE=0 → false (overrides everything)
+* // With nothing set → false
+*
+* // From CLI flag
+* const isVerbose = resolveVerbose(cliFlags.verbose);
+* ```
+*/
+declare function resolveVerbose(verbose?: boolean): boolean;
+export { output, exitWithError, resolveVerbose };

package/dist/shared/@outfitter/{cli-d9ad0rqj.js → cli-jbj78ac5.js}

@@ -1,8 +1,4 @@
 // @bun
-import {
-  __esm
-} from "./cli-v1tzwxkt.js";
-
 // packages/cli/src/terminal/detection.ts
 import { getEnvBoolean } from "@outfitter/config";
 function getEnvValue(key) {
@@ -70,6 +66,5 @@ function isInteractive(options) {
   const isTTY = options?.isTTY ?? process.stdout.isTTY ?? false;
   return isTTY;
 }
-var init_detection = () => {};
 
-export { getEnvValue, hasNoColorEnv, resolveForceColorEnv, resolveColorEnv, supportsColor, getTerminalWidth, isInteractive, init_detection };
+export { getEnvValue, hasNoColorEnv, resolveForceColorEnv, resolveColorEnv, supportsColor, getTerminalWidth, isInteractive };

package/dist/shared/@outfitter/{cli-5g6rkv3d.js → cli-rk9zagkm.js}

@@ -1,14 +1,31 @@
 // @bun
 import {
-  init_detection,
   resolveColorEnv,
   supportsColor
-} from "./cli-d9ad0rqj.js";
-import {
-  __esm
-} from "./cli-v1tzwxkt.js";
+} from "./cli-jbj78ac5.js";
 
-// packages/cli/src/render/colors.ts
+// packages/cli/src/colors/colors.ts
+var ANSI = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  italic: "\x1B[3m",
+  underline: "\x1B[4m",
+  inverse: "\x1B[7m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  blue: "\x1B[34m",
+  cyan: "\x1B[36m",
+  magenta: "\x1B[35m",
+  white: "\x1B[37m",
+  gray: "\x1B[90m",
+  brightCyan: "\x1B[96m",
+  brightRed: "\x1B[91m",
+  brightYellow: "\x1B[93m",
+  brightGreen: "\x1B[92m",
+  brightBlue: "\x1B[94m"
+};
 function createTheme() {
   const colorEnabled = supportsColor();
   const colorFn = (ansiCode) => (text) => {
@@ -103,30 +120,5 @@ function applyColor(text, color) {
   const ansiCode = ANSI[color];
   return `${ansiCode}${text}${ANSI.reset}`;
 }
-var ANSI;
-var init_colors = __esm(() => {
-  init_detection();
-  ANSI = {
-    reset: "\x1B[0m",
-    bold: "\x1B[1m",
-    dim: "\x1B[2m",
-    italic: "\x1B[3m",
-    underline: "\x1B[4m",
-    inverse: "\x1B[7m",
-    green: "\x1B[32m",
-    yellow: "\x1B[33m",
-    red: "\x1B[31m",
-    blue: "\x1B[34m",
-    cyan: "\x1B[36m",
-    magenta: "\x1B[35m",
-    white: "\x1B[37m",
-    gray: "\x1B[90m",
-    brightCyan: "\x1B[96m",
-    brightRed: "\x1B[91m",
-    brightYellow: "\x1B[93m",
-    brightGreen: "\x1B[92m",
-    brightBlue: "\x1B[94m"
-  };
-});
 
-export { ANSI, createTheme, resolveTokenColorEnabled, createTokens, applyColor, init_colors };
+export { ANSI, createTheme, resolveTokenColorEnabled, createTokens, applyColor };

package/dist/shared/@outfitter/{cli-efy6jfcj.js → cli-zahqsaby.js}

@@ -6,32 +6,55 @@ function isCommanderHelp(error) {
 }
 function createCLI(config) {
   const program = new Command;
+  let bridgedJsonEnvPrevious;
+  let bridgedJsonEnvActive = false;
+  const restoreJsonEnvBridge = () => {
+    if (!bridgedJsonEnvActive) {
+      return;
+    }
+    if (bridgedJsonEnvPrevious === undefined) {
+      process.env["OUTFITTER_JSON"] = undefined;
+    } else {
+      process.env["OUTFITTER_JSON"] = bridgedJsonEnvPrevious;
+    }
+    bridgedJsonEnvPrevious = undefined;
+    bridgedJsonEnvActive = false;
+  };
   program.name(config.name).version(config.version);
   if (config.description) {
     program.description(config.description);
   }
-  const exit = config.onExit ?? ((code) => process.exit(code));
-  program.exitOverride((error) => {
-    if (isCommanderHelp(error)) {
-      exit(0);
+  program.option("--json", "Output as JSON", false);
+  program.hook("preAction", (thisCommand) => {
+    const allOpts = thisCommand.optsWithGlobals();
+    if (allOpts["json"] && !bridgedJsonEnvActive) {
+      bridgedJsonEnvPrevious = process.env["OUTFITTER_JSON"];
+      process.env["OUTFITTER_JSON"] = "1";
+      bridgedJsonEnvActive = true;
     }
-    if (config.onError) {
-      config.onError(error);
-    }
-    const exitCode = typeof error.exitCode === "number" && Number.isFinite(error.exitCode) ? error.exitCode : 1;
-    exit(exitCode);
   });
+  program.hook("postAction", () => {
+    restoreJsonEnvBridge();
+  });
+  const exit = config.onExit ?? ((code) => void process.exit(code));
+  program.exitOverride();
   const parse = async (argv) => {
     try {
       await program.parseAsync(argv ?? process.argv);
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
+      if (isCommanderHelp(err)) {
+        await exit(0);
+        return;
+      }
       if (config.onError) {
         config.onError(err);
       }
       const errorExitCode = error.exitCode;
       const exitCode = typeof errorExitCode === "number" ? errorExitCode : 1;
-      exit(exitCode);
+      await exit(exitCode);
+    } finally {
+      restoreJsonEnvBridge();
     }
   };
   const cli = {

package/dist/terminal/detection.js

@@ -3,15 +3,11 @@ import {
   getEnvValue,
   getTerminalWidth,
   hasNoColorEnv,
-  init_detection,
   isInteractive,
   resolveColorEnv,
   resolveForceColorEnv,
   supportsColor
-} from "../shared/@outfitter/cli-d9ad0rqj.js";
-import"../shared/@outfitter/cli-v1tzwxkt.js";
-init_detection();
-
+} from "../shared/@outfitter/cli-jbj78ac5.js";
 export {
   supportsColor,
   resolveForceColorEnv,

package/dist/terminal/index.js

@@ -3,16 +3,11 @@ import {
   getEnvValue,
   getTerminalWidth,
   hasNoColorEnv,
-  init_detection,
   isInteractive,
   resolveColorEnv,
   resolveForceColorEnv,
   supportsColor
-} from "../shared/@outfitter/cli-d9ad0rqj.js";
-import"../shared/@outfitter/cli-v1tzwxkt.js";
-
-// packages/cli/src/terminal/index.ts
-init_detection();
+} from "../shared/@outfitter/cli-jbj78ac5.js";
 export {
   supportsColor,
   resolveForceColorEnv,

package/dist/{shared/@outfitter/cli-4cb5g831.d.ts → text.d.ts}

@@ -144,4 +144,4 @@ declare function pluralize(count: number, singular: string, plural?: string): st
 * ```
 */
 declare function slugify(text: string): string;
-export { ANSI_REGEX, stripAnsi, getStringWidth, wrapText, truncateText, padText, pluralize, slugify };
+export { wrapText, truncateText, stripAnsi, slugify, pluralize, padText, getStringWidth, ANSI_REGEX };