@outfitter/cli 0.5.1 → 0.5.2

package/README.md

@@ -363,7 +363,7 @@ if (flags.reset) {
 
 ## Conventions
 
-Composable flag presets provide typed, reusable CLI flag definitions. See the [full conventions guide](../../docs/CLI-CONVENTIONS.md) for the complete catalog.
+Composable flag presets provide typed, reusable CLI flag definitions. See the [full conventions guide](../../docs/cli/conventions.md) for the complete catalog.
 
 ```typescript
 import { composePresets, verbosePreset, cwdPreset, forcePreset } from "@outfitter/cli/flags";

package/dist/actions.d.ts

@@ -1,5 +1,5 @@
-import { SchemaCommandOptions } from "./shared/@outfitter/cli-n1k0d23k";
-import { FlagPreset } from "./shared/@outfitter/cli-7n5zmndx";
+import { SchemaCommandOptions } from "./shared/@outfitter/cli-n1k0d23k.js";
+import { FlagPreset } from "./shared/@outfitter/cli-98aa9104.js";
 import { ActionCliInputContext, ActionCliOption, ActionRegistry, ActionSurface, AnyActionSpec, HandlerContext } from "@outfitter/contracts";
 import { Command } from "commander";
 interface BuildCliCommandsOptions {

package/dist/actions.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   createSchemaCommand
-} from "./shared/@outfitter/cli-g0sn0r0b.js";
+} from "./shared/@outfitter/cli-0cjts94k.js";
 import {
   composePresets
 } from "./shared/@outfitter/cli-pdb7znbq.js";

package/dist/cli.d.ts

@@ -1,4 +1,4 @@
-import { CLI, CLIConfig } from "./shared/@outfitter/cli-7n5zmndx";
+import { CLI, CLIConfig } from "./shared/@outfitter/cli-98aa9104.js";
 /**
 * Create a new CLI instance with the given configuration.
 *

package/dist/colors/colors.d.ts

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

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-xppg982q";
+import "../shared/@outfitter/cli-qz47jk6d.js";
+import { ANSI, ColorName, Theme, TokenOptions, Tokens, applyColor, createTheme, createTokens, resolveTokenColorEnabled } from "../shared/@outfitter/cli-j2x88att.js";
 export { resolveTokenColorEnabled, createTokens, createTheme, applyColor, Tokens, TokenOptions, Theme, ColorName, ANSI };

package/dist/command.d.ts

@@ -1,4 +1,4 @@
-import { CLI, CLIConfig, CommandAction, CommandBuilder, CommandConfig, CommandFlags, FlagPreset } from "./shared/@outfitter/cli-7n5zmndx";
+import { CLI, CLIConfig, CommandAction, CommandBuilder, CommandConfig, CommandFlags, FlagPreset } from "./shared/@outfitter/cli-98aa9104.js";
 /**
 * Create a CLI instance with a portable return type from this module.
 */

package/dist/completion.d.ts

@@ -3,10 +3,10 @@ import { Command } from "commander";
 * Configuration for the completion command.
 */
 interface CompletionConfig {
-	/** Supported shells (default: bash, zsh, fish) */
-	readonly shells?: readonly ("bash" | "zsh" | "fish")[];
 	/** Program name for completion scripts (inferred from CLI name if not provided) */
 	readonly programName?: string;
+	/** Supported shells (default: bash, zsh, fish) */
+	readonly shells?: readonly ("bash" | "zsh" | "fish")[];
 }
 /**
 * Generate a completion script for the given shell.

package/dist/flags.d.ts

@@ -1,4 +1,4 @@
-import { BooleanFlagPresetConfig, ColorFlags, ColorMode, ComposedPreset, EnumFlagPresetConfig, ExecutionFlags, ExecutionPresetConfig, FlagPreset, FlagPresetConfig, InteractionFlags, NumberFlagPresetConfig, PaginationFlags, PaginationPresetConfig, ProjectionFlags, StrictFlags, StringListFlagPresetConfig, TimeWindowFlags, TimeWindowPresetConfig } from "./shared/@outfitter/cli-7n5zmndx";
+import { BooleanFlagPresetConfig, ColorFlags, ColorMode, ComposedPreset, EnumFlagPresetConfig, ExecutionFlags, ExecutionPresetConfig, FlagPreset, FlagPresetConfig, InteractionFlags, NumberFlagPresetConfig, PaginationFlags, PaginationPresetConfig, ProjectionFlags, StrictFlags, StringListFlagPresetConfig, TimeWindowFlags, TimeWindowPresetConfig } from "./shared/@outfitter/cli-98aa9104.js";
 /**
 * Create a typed flag preset.
 *

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import "./shared/@outfitter/cli-qz47jk6d";
-import { ANSI, Theme, Tokens, createTheme } from "./shared/@outfitter/cli-xppg982q";
-import { exitWithError, output } from "./shared/@outfitter/cli-z7mgapx5";
-import { OutputMode } from "./shared/@outfitter/cli-7n5zmndx";
+import "./shared/@outfitter/cli-qz47jk6d.js";
+import { ANSI, Theme, Tokens, createTheme } from "./shared/@outfitter/cli-j2x88att.js";
+import { exitWithError, output } from "./shared/@outfitter/cli-xy3gs50c.js";
+import { OutputMode } from "./shared/@outfitter/cli-98aa9104.js";
 export { output, exitWithError, createTheme, Tokens, Theme, OutputMode, ANSI };

package/dist/input.d.ts

@@ -1,4 +1,4 @@
-import { CollectIdsOptions, ExpandFileOptions, FilterExpression, KeyValuePair, NormalizeIdOptions, ParseGlobOptions, Range, SortCriteria } from "./shared/@outfitter/cli-7n5zmndx";
+import { CollectIdsOptions, ExpandFileOptions, FilterExpression, KeyValuePair, NormalizeIdOptions, ParseGlobOptions, Range, SortCriteria } from "./shared/@outfitter/cli-98aa9104.js";
 import { ValidationError } from "@outfitter/contracts";
 import { Result } from "better-result";
 /**

package/dist/output.d.ts

@@ -1,3 +1,3 @@
-import { exitWithError, output, resolveVerbose } from "./shared/@outfitter/cli-z7mgapx5";
-import "./shared/@outfitter/cli-7n5zmndx";
+import { exitWithError, output, resolveVerbose } from "./shared/@outfitter/cli-xy3gs50c.js";
+import "./shared/@outfitter/cli-98aa9104.js";
 export { resolveVerbose, output, exitWithError };

package/dist/pagination.d.ts

@@ -1,4 +1,4 @@
-import { CursorOptions, PaginationState } from "./shared/@outfitter/cli-7n5zmndx";
+import { CursorOptions, PaginationState } from "./shared/@outfitter/cli-98aa9104.js";
 /**
 * Load persisted pagination state for a command.
 *

package/dist/query.d.ts

@@ -1,14 +1,14 @@
-import { FlagPreset, OutputMode } from "./shared/@outfitter/cli-7n5zmndx";
+import { FlagPreset, OutputMode } from "./shared/@outfitter/cli-98aa9104.js";
 /**
 * Configuration for the output mode preset.
 */
 interface OutputModePresetConfig {
-	/** Allowed output modes (default: ["human", "json"]) */
-	readonly modes?: readonly OutputMode[];
 	/** Default mode when not specified (default: "human") */
 	readonly defaultMode?: OutputMode;
 	/** Whether to include "jsonl" in allowed modes (default: false) */
 	readonly includeJsonl?: boolean;
+	/** Allowed output modes (default: ["human", "json"]) */
+	readonly modes?: readonly OutputMode[];
 }
 /**
 * Resolved output mode from CLI input.

package/dist/schema.d.ts

@@ -1,2 +1,2 @@
-import { ActionManifest, ActionManifestEntry, ActionSource, GenerateManifestOptions, SchemaCommandOptions, SurfaceCommandOptions, createSchemaCommand, formatManifestHuman, generateManifest } from "./shared/@outfitter/cli-n1k0d23k";
+import { ActionManifest, ActionManifestEntry, ActionSource, GenerateManifestOptions, SchemaCommandOptions, SurfaceCommandOptions, createSchemaCommand, formatManifestHuman, generateManifest } from "./shared/@outfitter/cli-n1k0d23k.js";
 export { generateManifest, formatManifestHuman, createSchemaCommand, SurfaceCommandOptions, SchemaCommandOptions, GenerateManifestOptions, ActionSource, ActionManifestEntry, ActionManifest };

package/dist/schema.js

@@ -3,7 +3,7 @@ import {
   createSchemaCommand,
   formatManifestHuman,
   generateManifest
-} from "./shared/@outfitter/cli-g0sn0r0b.js";
+} from "./shared/@outfitter/cli-0cjts94k.js";
 export {
   generateManifest,
   formatManifestHuman,

package/dist/shared/@outfitter/{cli-g0sn0r0b.js → cli-0cjts94k.js}

@@ -42,9 +42,9 @@ function formatSummary(manifest, programName) {
   for (const [groupName, groupActions] of grouped.entries()) {
     lines.push(groupName);
     for (const action of groupActions) {
-      const commandPart = action.cli?.command ?? action.id;
+      const commandPart = action.cli?.command ?? "";
       const isBase = !commandPart || commandPart.startsWith("[") || commandPart.startsWith("<");
-      const displayCommand = isBase ? `  ${groupName} ${commandPart ?? ""}`.trimEnd() : `  ${groupName} ${commandPart}`;
+      const displayCommand = isBase ? `  ${groupName} ${commandPart}`.trimEnd() : `  ${groupName} ${commandPart}`;
       const desc = action.cli?.description ?? action.description ?? "";
       lines.push(padCommand(displayCommand, desc));
     }
@@ -76,8 +76,8 @@ function formatActionDetail(manifest, actionId) {
   lines.push("");
   if (entry.cli) {
     const group = entry.cli.group;
-    const commandPart = entry.cli.command ?? entry.id;
-    const fullCommand = group ? `${group} ${commandPart}` : commandPart;
+    const commandPart = entry.cli.command ?? (group ? "" : entry.id);
+    const fullCommand = group ? `${group} ${commandPart}`.trimEnd() : commandPart;
     lines.push(`  Command:  ${fullCommand}`);
   }
   lines.push(`  Surfaces: ${entry.surfaces.join(", ")}`);

package/dist/shared/@outfitter/{cli-z7mgapx5.d.ts → cli-xy3gs50c.d.ts}

@@ -1,4 +1,4 @@
-import { OutputOptions } from "./cli-7n5zmndx";
+import { OutputOptions } from "./cli-98aa9104.js";
 /**
 * Output data to the console with automatic mode selection.
 *

package/dist/terminal/detection.d.ts

@@ -1,2 +1,2 @@
-import { TerminalOptions, getEnvValue, getTerminalWidth, hasNoColorEnv, isInteractive, resolveColorEnv, resolveForceColorEnv, supportsColor } from "../shared/@outfitter/cli-8aa1vhdn";
+import { TerminalOptions, getEnvValue, getTerminalWidth, hasNoColorEnv, isInteractive, resolveColorEnv, resolveForceColorEnv, supportsColor } from "../shared/@outfitter/cli-rr1sq5s4.js";
 export { supportsColor, resolveForceColorEnv, resolveColorEnv, isInteractive, hasNoColorEnv, getTerminalWidth, getEnvValue, TerminalOptions };

package/dist/terminal/index.d.ts

@@ -1,2 +1,2 @@
-import { TerminalOptions, getEnvValue, getTerminalWidth, hasNoColorEnv, isInteractive, resolveColorEnv, resolveForceColorEnv, supportsColor } from "../shared/@outfitter/cli-8aa1vhdn";
+import { TerminalOptions, getEnvValue, getTerminalWidth, hasNoColorEnv, isInteractive, resolveColorEnv, resolveForceColorEnv, supportsColor } from "../shared/@outfitter/cli-rr1sq5s4.js";
 export { supportsColor, resolveForceColorEnv, resolveColorEnv, isInteractive, hasNoColorEnv, getTerminalWidth, getEnvValue, TerminalOptions };

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { BooleanFlagPresetConfig, CLI, CLIConfig, CancelledError, CollectIdsOptions, ColorFlags, ColorMode, CommandAction, CommandBuilder, CommandConfig, CommandFlags, ComposedPreset, CursorOptions, DateRange, EnumFlagPresetConfig, ErrorCategory, ExecutionFlags, ExecutionPresetConfig, ExpandFileOptions, FilterExpression, FlagPreset, FlagPresetConfig, InteractionFlags, KeyValuePair, NormalizeIdOptions, NumberFlagPresetConfig, NumericRange, OutputMode, OutputOptions, PaginationFlags, PaginationPresetConfig, PaginationState, ParseGlobOptions, ProjectionFlags, Range, Result, SortCriteria, StrictFlags, StringListFlagPresetConfig, TimeWindowFlags, TimeWindowPresetConfig, ValidationError, VerbConfig, VerbFamily } from "./shared/@outfitter/cli-7n5zmndx";
+import { BooleanFlagPresetConfig, CLI, CLIConfig, CancelledError, CollectIdsOptions, ColorFlags, ColorMode, CommandAction, CommandBuilder, CommandConfig, CommandFlags, ComposedPreset, CursorOptions, DateRange, EnumFlagPresetConfig, ErrorCategory, ExecutionFlags, ExecutionPresetConfig, ExpandFileOptions, FilterExpression, FlagPreset, FlagPresetConfig, InteractionFlags, KeyValuePair, NormalizeIdOptions, NumberFlagPresetConfig, NumericRange, OutputMode, OutputOptions, PaginationFlags, PaginationPresetConfig, PaginationState, ParseGlobOptions, ProjectionFlags, Range, Result, SortCriteria, StrictFlags, StringListFlagPresetConfig, TimeWindowFlags, TimeWindowPresetConfig, ValidationError, VerbConfig, VerbFamily } from "./shared/@outfitter/cli-98aa9104.js";
 export { VerbFamily, VerbConfig, ValidationError, TimeWindowPresetConfig, TimeWindowFlags, StringListFlagPresetConfig, StrictFlags, SortCriteria, Result, Range, ProjectionFlags, ParseGlobOptions, PaginationState, PaginationPresetConfig, PaginationFlags, OutputOptions, OutputMode, NumericRange, NumberFlagPresetConfig, NormalizeIdOptions, KeyValuePair, InteractionFlags, FlagPresetConfig, FlagPreset, FilterExpression, ExpandFileOptions, ExecutionPresetConfig, ExecutionFlags, ErrorCategory, EnumFlagPresetConfig, DateRange, CursorOptions, ComposedPreset, CommandFlags, CommandConfig, CommandBuilder, CommandAction, ColorMode, ColorFlags, CollectIdsOptions, CancelledError, CLIConfig, CLI, BooleanFlagPresetConfig };

package/dist/verbs.d.ts

@@ -1,4 +1,4 @@
-import { CommandBuilder, VerbConfig, VerbFamily } from "./shared/@outfitter/cli-7n5zmndx";
+import { CommandBuilder, VerbConfig, VerbFamily } from "./shared/@outfitter/cli-98aa9104.js";
 /**
 * Built-in verb families with standard primary verbs and aliases.
 *

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.5.1",
+  "version": "0.5.2",
   "type": "module",
   "files": [
     "dist"
@@ -119,7 +119,7 @@
     "prepublishOnly": "bun ../../scripts/check-publish-manifest.ts"
   },
   "dependencies": {
-    "@clack/prompts": "^0.11.0",
+    "@clack/prompts": "^1.0.1",
     "better-result": "^2.5.1",
     "commander": "^14.0.2"
   },
@@ -131,15 +131,15 @@
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@outfitter/config": "0.3.2",
-    "@outfitter/contracts": "0.4.0",
-    "@outfitter/schema": "0.2.1",
-    "@types/bun": "^1.3.7",
+    "@outfitter/config": "0.3.3",
+    "@outfitter/contracts": "0.4.1",
+    "@outfitter/schema": "0.2.2",
+    "@types/bun": "^1.3.9",
     "@types/node": "^25.0.10",
     "typescript": "^5.9.3"
   },
   "engines": {
-    "bun": ">=1.3.7"
+    "bun": ">=1.3.9"
   },
   "publishConfig": {
     "access": "public"

package/dist/shared/@outfitter/{cli-7n5zmndx.d.ts → cli-98aa9104.d.ts}

@@ -15,40 +15,40 @@ import { Result } from "better-result";
 * ```
 */
 interface CLIConfig {
-	/** CLI name (used in help output and error messages) */
-	readonly name: string;
-	/** CLI version (displayed with --version) */
-	readonly version: string;
 	/** CLI description (displayed in help output) */
 	readonly description?: string;
+	/** CLI name (used in help output and error messages) */
+	readonly name: string;
 	/** Custom error handler */
 	readonly onError?: (error: Error) => void;
 	/** Custom exit handler (defaults to process.exit) */
 	readonly onExit?: (code: number) => void | Promise<void>;
+	/** CLI version (displayed with --version) */
+	readonly version: string;
 }
 /**
 * CLI instance returned by createCLI.
 */
 interface CLI {
-	/** Register a command with the CLI */
-	register(command: CommandBuilder | Command): this;
 	/** Parse arguments and execute the matched command */
 	parse(argv?: readonly string[]): Promise<void>;
 	/** Get the underlying Commander program */
 	readonly program: Command;
+	/** Register a command with the CLI */
+	register(command: CommandBuilder | Command): this;
 }
 /**
 * Configuration for a single command.
 */
 interface CommandConfig {
-	/** Command name and argument syntax (e.g., "list" or "get <id>") */
-	readonly name: string;
-	/** Command description */
-	readonly description?: string;
 	/** Command aliases */
 	readonly aliases?: readonly string[];
+	/** Command description */
+	readonly description?: string;
 	/** Whether to hide from help output */
 	readonly hidden?: boolean;
+	/** Command name and argument syntax (e.g., "list" or "get <id>") */
+	readonly name: string;
 }
 /**
 * Action function executed when a command is invoked.
@@ -72,44 +72,44 @@ type CommandFlags = Record<string, unknown>;
 * Builder interface for constructing commands fluently.
 */
 interface CommandBuilder {
+	/** Set the action handler */
+	action<TFlags extends CommandFlags = CommandFlags>(handler: CommandAction<TFlags>): this;
+	/** Add command aliases */
+	alias(alias: string): this;
+	/** Build the underlying Commander command */
+	build(): Command;
 	/** Set command description */
 	description(text: string): this;
 	/** Add a command option/flag */
 	option(flags: string, description: string, defaultValue?: unknown): this;
-	/** Add a required option */
-	requiredOption(flags: string, description: string, defaultValue?: unknown): this;
-	/** Add command aliases */
-	alias(alias: string): this;
 	/** Apply a flag preset (adds its options to the command) */
 	preset(preset: FlagPreset<Record<string, unknown>>): this;
-	/** Set the action handler */
-	action<TFlags extends CommandFlags = CommandFlags>(handler: CommandAction<TFlags>): this;
-	/** Build the underlying Commander command */
-	build(): Command;
+	/** Add a required option */
+	requiredOption(flags: string, description: string, defaultValue?: unknown): this;
 }
 /**
 * A family of related command verbs with a primary name and aliases.
 */
 interface VerbFamily {
-	/** Primary verb name */
-	readonly primary: string;
 	/** Alternative names for this verb */
 	readonly aliases: readonly string[];
 	/** Description of what this verb family does */
 	readonly description: string;
+	/** Primary verb name */
+	readonly primary: string;
 }
 /**
 * Configuration for resolving a verb family with project-level overrides.
 */
 interface VerbConfig {
-	/** Override the primary verb (e.g., "edit" instead of "modify") */
-	readonly primary?: string;
 	/** Whether to include aliases (default: true) */
 	readonly aliases?: boolean;
-	/** Additional aliases beyond defaults */
-	readonly extraAliases?: readonly string[];
 	/** Aliases to exclude */
 	readonly excludeAliases?: readonly string[];
+	/** Additional aliases beyond defaults */
+	readonly extraAliases?: readonly string[];
+	/** Override the primary verb (e.g., "edit" instead of "modify") */
+	readonly primary?: string;
 }
 /**
 * A composable set of CLI flags with typed resolution.
@@ -140,22 +140,22 @@ interface FlagPresetConfig<TResolved extends Record<string, unknown>> {
 * Configuration for creating a custom boolean flag preset.
 */
 interface BooleanFlagPresetConfig<TKey extends string> {
+	/** Default resolved value (defaults to false) */
+	readonly defaultValue?: boolean;
+	/** Help description for the option */
+	readonly description: string;
+	/** Commander option definition (e.g., "--force" or "--no-codemods") */
+	readonly flags: string;
 	/** Unique identifier for deduplication */
 	readonly id: string;
 	/** Resolved output property name */
 	readonly key: TKey;
-	/** Commander option definition (e.g., "--force" or "--no-codemods") */
-	readonly flags: string;
-	/** Help description for the option */
-	readonly description: string;
-	/** Default resolved value (defaults to false) */
-	readonly defaultValue?: boolean;
-	/** Candidate raw flag keys to read (defaults to [key]) */
-	readonly sources?: readonly string[];
 	/** Positive keys that should be negated (e.g., "codemods" for --no-codemods) */
 	readonly negatedSources?: readonly string[];
 	/** Whether the option is required */
 	readonly required?: boolean;
+	/** Candidate raw flag keys to read (defaults to [key]) */
+	readonly sources?: readonly string[];
 }
 /**
 * Configuration for creating a custom enum flag preset.
@@ -164,70 +164,70 @@ interface EnumFlagPresetConfig<
 	TKey extends string,
 	TValue extends string
 > {
+	/** Fallback value when input is missing or invalid */
+	readonly defaultValue: TValue;
+	/** Help description for the option */
+	readonly description: string;
+	/** Commander option definition */
+	readonly flags: string;
 	/** Unique identifier for deduplication */
 	readonly id: string;
 	/** Resolved output property name */
 	readonly key: TKey;
-	/** Commander option definition */
-	readonly flags: string;
-	/** Help description for the option */
-	readonly description: string;
-	/** Allowed enum values */
-	readonly values: readonly TValue[];
-	/** Fallback value when input is missing or invalid */
-	readonly defaultValue: TValue;
-	/** Candidate raw flag keys to read (defaults to [key]) */
-	readonly sources?: readonly string[];
 	/** Whether the option is required */
 	readonly required?: boolean;
+	/** Candidate raw flag keys to read (defaults to [key]) */
+	readonly sources?: readonly string[];
+	/** Allowed enum values */
+	readonly values: readonly TValue[];
 }
 /**
 * Configuration for creating a custom numeric flag preset.
 */
 interface NumberFlagPresetConfig<TKey extends string> {
+	/** Fallback value when input is missing or invalid */
+	readonly defaultValue: number;
+	/** Help description for the option */
+	readonly description: string;
+	/** Commander option definition */
+	readonly flags: string;
 	/** Unique identifier for deduplication */
 	readonly id: string;
+	/** Floor parsed values (defaults to true) */
+	readonly integer?: boolean;
 	/** Resolved output property name */
 	readonly key: TKey;
-	/** Commander option definition */
-	readonly flags: string;
-	/** Help description for the option */
-	readonly description: string;
-	/** Fallback value when input is missing or invalid */
-	readonly defaultValue: number;
-	/** Candidate raw flag keys to read (defaults to [key]) */
-	readonly sources?: readonly string[];
-	/** Lower bound (inclusive) */
-	readonly min?: number;
 	/** Upper bound (inclusive) */
 	readonly max?: number;
-	/** Floor parsed values (defaults to true) */
-	readonly integer?: boolean;
+	/** Lower bound (inclusive) */
+	readonly min?: number;
 	/** Whether the option is required */
 	readonly required?: boolean;
+	/** Candidate raw flag keys to read (defaults to [key]) */
+	readonly sources?: readonly string[];
 }
 /**
 * Configuration for creating a custom string-list flag preset.
 */
 interface StringListFlagPresetConfig<TKey extends string> {
+	/** Remove duplicate values while preserving order */
+	readonly dedupe?: boolean;
+	/** Fallback list when input is missing or invalid */
+	readonly defaultValue?: readonly string[];
+	/** Help description for the option */
+	readonly description: string;
+	/** Commander option definition */
+	readonly flags: string;
 	/** Unique identifier for deduplication */
 	readonly id: string;
 	/** Resolved output property name */
 	readonly key: TKey;
-	/** Commander option definition */
-	readonly flags: string;
-	/** Help description for the option */
-	readonly description: string;
-	/** Candidate raw flag keys to read (defaults to [key]) */
-	readonly sources?: readonly string[];
-	/** Fallback list when input is missing or invalid */
-	readonly defaultValue?: readonly string[];
-	/** Split string values by this separator (defaults to ",") */
-	readonly separator?: string;
-	/** Remove duplicate values while preserving order */
-	readonly dedupe?: boolean;
 	/** Whether the option is required */
 	readonly required?: boolean;
+	/** Split string values by this separator (defaults to ",") */
+	readonly separator?: string;
+	/** Candidate raw flag keys to read (defaults to [key]) */
+	readonly sources?: readonly string[];
 }
 /**
 * Result of composing multiple presets together.
@@ -290,10 +290,10 @@ type ExecutionFlags = {
 * Configuration for the execution flag preset.
 */
 interface ExecutionPresetConfig {
-	/** Default timeout in milliseconds (default: undefined) */
-	readonly defaultTimeout?: number;
 	/** Default number of retries (default: 0) */
 	readonly defaultRetries?: number;
+	/** Default timeout in milliseconds (default: undefined) */
+	readonly defaultTimeout?: number;
 	/** Maximum number of retries (default: 10) */
 	readonly maxRetries?: number;
 }
@@ -338,14 +338,14 @@ type OutputMode = "human" | "json" | "jsonl" | "tree" | "table";
 * Options for the output() function.
 */
 interface OutputOptions {
+	/** Exit code to use after output (undefined = don't exit) */
+	readonly exitCode?: number;
 	/** Force a specific output mode (overrides flag detection) */
 	readonly mode?: OutputMode;
-	/** Stream to write to (defaults to stdout) */
-	readonly stream?: NodeJS.WritableStream;
 	/** Whether to pretty-print JSON output */
 	readonly pretty?: boolean;
-	/** Exit code to use after output (undefined = don't exit) */
-	readonly exitCode?: number;
+	/** Stream to write to (defaults to stdout) */
+	readonly stream?: NodeJS.WritableStream;
 }
 /**
 * Options for collectIds() input utility.
@@ -389,10 +389,10 @@ interface ParseGlobOptions {
 	readonly followSymlinks?: boolean;
 	/** Patterns to exclude */
 	readonly ignore?: readonly string[];
-	/** Only match files (not directories) */
-	readonly onlyFiles?: boolean;
 	/** Only match directories (not files) */
 	readonly onlyDirectories?: boolean;
+	/** Only match files (not directories) */
+	readonly onlyFiles?: boolean;
 }
 /**
 * Options for normalizeId().
@@ -400,14 +400,14 @@ interface ParseGlobOptions {
 interface NormalizeIdOptions {
 	/** Whether to lowercase the ID */
 	readonly lowercase?: boolean;
-	/** Whether to trim whitespace */
-	readonly trim?: boolean;
-	/** Minimum length requirement */
-	readonly minLength?: number;
 	/** Maximum length requirement */
 	readonly maxLength?: number;
+	/** Minimum length requirement */
+	readonly minLength?: number;
 	/** Pattern the ID must match */
 	readonly pattern?: RegExp;
+	/** Whether to trim whitespace */
+	readonly trim?: boolean;
 }
 /**
 * Numeric or date range parsed from CLI input.
@@ -417,32 +417,32 @@ type Range = NumericRange | DateRange;
 * Numeric range (e.g., "1-10").
 */
 interface NumericRange {
-	readonly type: "number";
-	readonly min: number;
 	readonly max: number;
+	readonly min: number;
+	readonly type: "number";
 }
 /**
 * Date range (e.g., "2024-01-01..2024-12-31").
 */
 interface DateRange {
-	readonly type: "date";
-	readonly start: Date;
 	readonly end: Date;
+	readonly start: Date;
+	readonly type: "date";
 }
 /**
 * Filter expression parsed from CLI input.
 */
 interface FilterExpression {
 	readonly field: string;
-	readonly value: string;
 	readonly operator?: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "contains";
+	readonly value: string;
 }
 /**
 * Sort criteria parsed from CLI input.
 */
 interface SortCriteria {
-	readonly field: string;
 	readonly direction: "asc" | "desc";
+	readonly field: string;
 }
 /**
 * Key-value pair parsed from CLI input.
@@ -455,16 +455,16 @@ interface KeyValuePair {
 * State for paginated command results.
 */
 interface PaginationState {
-	/** Cursor for the next page */
-	readonly cursor: string;
 	/** Command that generated this state */
 	readonly command: string;
 	/** Context key for scoping pagination */
 	readonly context?: string;
-	/** Timestamp when state was created */
-	readonly timestamp: number;
+	/** Cursor for the next page */
+	readonly cursor: string;
 	/** Whether there are more results */
 	readonly hasMore: boolean;
+	/** Timestamp when state was created */
+	readonly timestamp: number;
 	/** Total count (if known) */
 	readonly total?: number;
 }
@@ -476,12 +476,12 @@ interface CursorOptions {
 	readonly command: string;
 	/** Context key for additional scoping */
 	readonly context?: string;
-	/** Tool name for XDG path resolution */
-	readonly toolName: string;
-	/** Maximum age in milliseconds before a cursor is treated as expired */
-	readonly maxAgeMs?: number;
 	/** Whether there are more results (defaults to true) */
 	readonly hasMore?: boolean;
+	/** Maximum age in milliseconds before a cursor is treated as expired */
+	readonly maxAgeMs?: number;
+	/** Tool name for XDG path resolution */
+	readonly toolName: string;
 	/** Total count of results (if known) */
 	readonly total?: number;
 }

package/dist/shared/@outfitter/{cli-xppg982q.d.ts → cli-j2x88att.d.ts}

@@ -37,40 +37,40 @@ declare const ANSI: {
 * ```
 */
 interface Theme {
-	/** Applies green color for success messages */
-	success: (text: string) => string;
-	/** Applies yellow color for warning messages */
-	warning: (text: string) => string;
+	/** Applies cyan color for interactive elements and highlights */
+	accent: (text: string) => string;
+	/** Applies bold styling */
+	bold: (text: string) => string;
+	/** Applies bright red for dangerous actions */
+	destructive: (text: string) => string;
+	/** Applies dim styling (alias for muted style) */
+	dim: (text: string) => string;
 	/** Applies red color for error messages */
 	error: (text: string) => string;
+	/** Applies bold for strong emphasis */
+	highlight: (text: string) => string;
 	/** Applies blue color for informational messages */
 	info: (text: string) => string;
+	/** Applies inverse styling (swaps foreground/background) */
+	inverse: (text: string) => string;
+	/** Applies italic styling */
+	italic: (text: string) => string;
+	/** Applies cyan + underline for URLs and clickable references */
+	link: (text: string) => string;
+	/** Applies dim styling for de-emphasized text */
+	muted: (text: string) => string;
 	/** Returns text unchanged (primary/default text) */
 	primary: (text: string) => string;
 	/** Applies gray color for secondary text */
 	secondary: (text: string) => string;
-	/** Applies dim styling for de-emphasized text */
-	muted: (text: string) => string;
-	/** Applies cyan color for interactive elements and highlights */
-	accent: (text: string) => string;
-	/** Applies bold for strong emphasis */
-	highlight: (text: string) => string;
-	/** Applies cyan + underline for URLs and clickable references */
-	link: (text: string) => string;
-	/** Applies bright red for dangerous actions */
-	destructive: (text: string) => string;
 	/** Applies dim gray for less prominent text than muted */
 	subtle: (text: string) => string;
-	/** Applies bold styling */
-	bold: (text: string) => string;
-	/** Applies italic styling */
-	italic: (text: string) => string;
+	/** Applies green color for success messages */
+	success: (text: string) => string;
 	/** Applies underline styling */
 	underline: (text: string) => string;
-	/** Applies dim styling (alias for muted style) */
-	dim: (text: string) => string;
-	/** Applies inverse styling (swaps foreground/background) */
-	inverse: (text: string) => string;
+	/** Applies yellow color for warning messages */
+	warning: (text: string) => string;
 }
 /**
 * Available color names for the {@link applyColor} function.
@@ -104,40 +104,40 @@ type ColorName = "green" | "yellow" | "red" | "blue" | "cyan" | "magenta" | "whi
 * ```
 */
 interface Tokens {
-	/** Green color for success messages */
-	success: string;
-	/** Yellow color for warning messages */
-	warning: string;
+	/** Cyan color for interactive elements and highlights */
+	accent: string;
+	/** Bold styling */
+	bold: string;
+	/** Bright red for dangerous actions */
+	destructive: string;
+	/** Dim styling */
+	dim: string;
 	/** Red color for error messages */
 	error: string;
+	/** Bold for strong emphasis */
+	highlight: string;
 	/** Blue color for informational messages */
 	info: string;
+	/** Inverse styling (swaps foreground/background) */
+	inverse: string;
+	/** Italic styling */
+	italic: string;
+	/** Cyan + underline for URLs and clickable references */
+	link: string;
+	/** Dim/gray color for de-emphasized text */
+	muted: string;
 	/** Default text color (typically empty string) */
 	primary: string;
 	/** Subdued color for secondary text */
 	secondary: string;
-	/** Dim/gray color for de-emphasized text */
-	muted: string;
-	/** Cyan color for interactive elements and highlights */
-	accent: string;
-	/** Bold for strong emphasis */
-	highlight: string;
-	/** Cyan + underline for URLs and clickable references */
-	link: string;
-	/** Bright red for dangerous actions */
-	destructive: string;
 	/** Dim gray for less prominent text than muted */
 	subtle: string;
-	/** Bold styling */
-	bold: string;
-	/** Italic styling */
-	italic: string;
+	/** Green color for success messages */
+	success: string;
 	/** Underline styling */
 	underline: string;
-	/** Dim styling */
-	dim: string;
-	/** Inverse styling (swaps foreground/background) */
-	inverse: string;
+	/** Yellow color for warning messages */
+	warning: string;
 }
 /**
 * Configuration options for {@link createTokens}.
@@ -152,11 +152,6 @@ interface Tokens {
 * ```
 */
 interface TokenOptions {
-	/**
-	* Override NO_COLOR environment variable.
-	* When true, colors are enabled regardless of NO_COLOR.
-	*/
-	forceColor?: boolean;
 	/**
 	* Color support level:
 	* - 0: No color support (all tokens are empty strings)
@@ -167,6 +162,11 @@ interface TokenOptions {
 	* When not specified, level is auto-detected from environment.
 	*/
 	colorLevel?: 0 | 1 | 2 | 3;
+	/**
+	* Override NO_COLOR environment variable.
+	* When true, colors are enabled regardless of NO_COLOR.
+	*/
+	forceColor?: boolean;
 }
 /**
 * Creates a theme with semantic and text color functions.

package/dist/shared/@outfitter/{cli-8aa1vhdn.d.ts → cli-rr1sq5s4.d.ts}

@@ -14,10 +14,10 @@
 * ```
 */
 interface TerminalOptions {
-	/** Override TTY detection (uses process.stdout.isTTY if not specified) */
-	isTTY?: boolean;
 	/** Override CI detection (uses CI env variable if not specified) */
 	isCI?: boolean;
+	/** Override TTY detection (uses process.stdout.isTTY if not specified) */
+	isTTY?: boolean;
 }
 /**
 * Gets the value of an environment variable.