@outfitter/cli 0.2.0 → 0.3.0

package/README.md

@@ -367,10 +367,34 @@ 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);
+```
+
 ### Output Mode Priority
 
 1. Explicit `mode` option in `output()` call

package/dist/cli.js

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

package/dist/command.js

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

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 { output } from "./shared/@outfitter/cli-e6yv2764";
 import { OutputMode } from "./shared/@outfitter/cli-ttt7r0j7";
 export { output, createTheme, Tokens, Theme, OutputMode, ANSI };

package/dist/index.js

@@ -7,7 +7,7 @@ import {
 import"./shared/@outfitter/cli-d9ad0rqj.js";
 import {
   output
-} from "./shared/@outfitter/cli-8gg0hck1.js";
+} from "./shared/@outfitter/cli-7wp5nj0s.js";
 import"./shared/@outfitter/cli-v1tzwxkt.js";
 export {
   output,

package/dist/output.d.ts

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

package/dist/output.js

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

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

@@ -10,6 +10,7 @@ function createCLI(config) {
   if (config.description) {
     program.description(config.description);
   }
+  program.option("--json", "Output as JSON", false);
   const exit = config.onExit ?? ((code) => process.exit(code));
   program.exitOverride((error) => {
     if (isCommanderHelp(error)) {

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-e6yv2764.d.ts}

@@ -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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outfitter/cli",
   "description": "Typed CLI runtime with terminal detection, rendering, output contracts, and input parsing",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "files": [
     "dist"
@@ -269,7 +269,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@outfitter/config": "0.2.0",
+    "@outfitter/config": "0.3.0",
     "@outfitter/contracts": "0.2.0",
     "@outfitter/types": "0.2.0",
     "better-result": "^2.5.1",