@outfitter/cli 0.5.3 → 1.0.0

package/dist/flags.d.ts

@@ -1,189 +1,5 @@
-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.
-*
-* @param config - Preset configuration with id, options, and resolver
-* @returns A flag preset that can be applied to commands or composed
-*
-* @example
-* ```typescript
-* const myPreset = createPreset({
-*   id: "output-format",
-*   options: [{ flags: "--format <type>", description: "Output format" }],
-*   resolve: (flags) => ({
-*     format: String(flags["format"] ?? "text"),
-*   }),
-* });
-* ```
-*/
-declare function createPreset<TResolved extends Record<string, unknown>>(config: FlagPresetConfig<TResolved>): FlagPreset<TResolved>;
-type ResolvedType<T> = T extends FlagPreset<infer R> ? R : never;
-type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
-/**
-* Resolves the merged type from a tuple of presets.
-* Falls back to Record<string, unknown> when the tuple is empty
-* (since UnionToIntersection<never> produces unknown).
-*/
-type MergedPresetResult<TPresets extends readonly FlagPreset<Record<string, unknown>>[]> = UnionToIntersection<ResolvedType<TPresets[number]>> extends Record<string, unknown> ? UnionToIntersection<ResolvedType<TPresets[number]>> : Record<string, unknown>;
-/**
-* Compose multiple presets into one, deduplicating by id (first wins).
-*
-* @param presets - Presets to compose together
-* @returns A single preset merging all options and resolvers
-*
-* @example
-* ```typescript
-* const composed = composePresets(
-*   verbosePreset(),
-*   cwdPreset(),
-*   forcePreset(),
-* );
-* // composed.resolve({ verbose: true, cwd: "/tmp", force: false })
-* // => { verbose: true, cwd: "/tmp", force: false }
-* ```
-*/
-declare function composePresets<TPresets extends readonly FlagPreset<Record<string, unknown>>[]>(...presets: TPresets): ComposedPreset<MergedPresetResult<TPresets>>;
-/**
-* Generic boolean custom-flag builder.
-*
-* Supports normal sources and negated sources so `--no-foo` patterns can
-* resolve consistently across Commander flag-shape differences.
-*/
-declare function booleanFlagPreset<TKey extends string>(config: BooleanFlagPresetConfig<TKey>): FlagPreset<{ [K in TKey] : boolean }>;
-/**
-* Generic enum custom-flag builder.
-*/
-declare function enumFlagPreset<
-	TKey extends string,
-	TValue extends string
->(config: EnumFlagPresetConfig<TKey, TValue>): FlagPreset<{ [K in TKey] : TValue }>;
-/**
-* Generic number custom-flag builder.
-*/
-declare function numberFlagPreset<TKey extends string>(config: NumberFlagPresetConfig<TKey>): FlagPreset<{ [K in TKey] : number }>;
-/**
-* Generic string-list custom-flag builder.
-*/
-declare function stringListFlagPreset<TKey extends string>(config: StringListFlagPresetConfig<TKey>): FlagPreset<{ [K in TKey] : string[] | undefined }>;
-/**
-* Verbose output flag preset.
-*
-* Adds: `-v, --verbose`
-* Resolves: `{ verbose: boolean }`
-*/
-declare function verbosePreset(): FlagPreset<{
-	verbose: boolean;
-}>;
-/**
-* Working directory flag preset.
-*
-* Adds: `--cwd <path>`
-* Resolves: `{ cwd: string }` (defaults to `process.cwd()`)
-*/
-declare function cwdPreset(): FlagPreset<{
-	cwd: string;
-}>;
-/**
-* Dry-run flag preset.
-*
-* Adds: `--dry-run`
-* Resolves: `{ dryRun: boolean }`
-*/
-declare function dryRunPreset(): FlagPreset<{
-	dryRun: boolean;
-}>;
-/**
-* Force flag preset.
-*
-* Adds: `-f, --force`
-* Resolves: `{ force: boolean }`
-*/
-declare function forcePreset(): FlagPreset<{
-	force: boolean;
-}>;
-/**
-* Interaction mode flag preset.
-*
-* Adds: `--non-interactive`, `--no-input`, `-y, --yes`
-* Resolves: `{ interactive: boolean, yes: boolean }`
-*
-* `interactive` defaults to `true` and is set to `false` when
-* `--non-interactive` or `--no-input` is passed. The two flags
-* are synonyms for user convenience.
-*/
-declare function interactionPreset(): FlagPreset<InteractionFlags>;
-/**
-* Strict mode flag preset.
-*
-* Adds: `--strict`
-* Resolves: `{ strict: boolean }`
-*/
-declare function strictPreset(): FlagPreset<StrictFlags>;
-/**
-* Color mode flag preset.
-*
-* Adds: `--color [mode]`, `--no-color`
-* Resolves: `{ color: "auto" | "always" | "never" }`
-*
-* Commander's `--no-color` negation sets `flags["color"]` to `false`,
-* which resolves to `"never"`. Invalid values default to `"auto"`.
-*
-* This preset resolves the user's *intent*. Consumers should compose
-* with terminal detection (`supportsColor()`, `resolveColorEnv()`)
-* to determine actual color output behavior.
-*/
-declare function colorPreset(): FlagPreset<ColorFlags>;
-/**
-* Projection flag preset.
-*
-* Adds: `--fields <fields>`, `--exclude-fields <fields>`, `--count`
-* Resolves: `{ fields: string[] | undefined, excludeFields: string[] | undefined, count: boolean }`
-*
-* Fields are parsed as comma-separated strings with whitespace trimming.
-* `undefined` when not provided (not empty array) to distinguish
-* "not specified" from "empty".
-*
-* Conflict between `--fields` and `--exclude-fields` is a handler
-* concern (documented, not enforced).
-*/
-declare function projectionPreset(): FlagPreset<ProjectionFlags>;
-/**
-* Time-window flag preset.
-*
-* Adds: `--since <date>`, `--until <date>`
-* Resolves: `{ since: Date | undefined, until: Date | undefined }`
-*
-* Accepts ISO 8601 dates (`2024-01-15`) or relative durations
-* (`7d`, `24h`, `30m`, `2w`). Durations are past-relative
-* (subtracted from now).
-*
-* Returns `undefined` for unparseable values (does not throw).
-* When `config.maxRange` is set and both bounds are provided,
-* ranges above the limit are treated as invalid.
-*/
-declare function timeWindowPreset(config?: TimeWindowPresetConfig): FlagPreset<TimeWindowFlags>;
-/**
-* Execution flag preset.
-*
-* Adds: `--timeout <ms>`, `--retries <n>`, `--offline`
-* Resolves: `{ timeout: number | undefined, retries: number, offline: boolean }`
-*
-* Timeout is parsed as a positive integer in milliseconds.
-* Retries are parsed as a non-negative integer, clamped to maxRetries.
-*/
-declare function executionPreset(config?: ExecutionPresetConfig): FlagPreset<ExecutionFlags>;
-/**
-* Pagination flag preset.
-*
-* Adds: `-l, --limit <n>`, `--next`, `--reset`
-* Resolves: `{ limit: number, next: boolean, reset: boolean }`
-*
-* Limit is parsed as an integer, clamped to maxLimit, and defaults
-* to defaultLimit on invalid input. Mutual exclusivity of --next
-* and --reset is a handler concern (not enforced here).
-*
-* Integrates with loadCursor/saveCursor/clearCursor from
-* `@outfitter/cli/pagination`.
-*/
-declare function paginationPreset(config?: PaginationPresetConfig): FlagPreset<PaginationFlags>;
-export { verbosePreset, timeWindowPreset, stringListFlagPreset, strictPreset, projectionPreset, paginationPreset, numberFlagPreset, interactionPreset, forcePreset, executionPreset, enumFlagPreset, dryRunPreset, cwdPreset, createPreset, composePresets, colorPreset, booleanFlagPreset, TimeWindowPresetConfig, TimeWindowFlags, StringListFlagPresetConfig, StrictFlags, ProjectionFlags, PaginationPresetConfig, PaginationFlags, NumberFlagPresetConfig, InteractionFlags, FlagPresetConfig, FlagPreset, ExecutionPresetConfig, ExecutionFlags, EnumFlagPresetConfig, ComposedPreset, ColorMode, ColorFlags, BooleanFlagPresetConfig };
+import { colorPreset, cwdPreset, dryRunPreset, executionPreset, forcePreset, interactionPreset, paginationPreset, projectionPreset, strictPreset, timeWindowPreset, verbosePreset } from "./shared/@outfitter/cli-xw8ys1je.js";
+import { composePresets, createPreset, createSchemaPreset, isSchemaPreset } from "./shared/@outfitter/cli-n54zs151.js";
+import { booleanFlagPreset, enumFlagPreset, numberFlagPreset, stringListFlagPreset } from "./shared/@outfitter/cli-dv8kk4jw.js";
+import { AnyPreset, BooleanFlagPresetConfig, ColorFlags, ColorMode, ComposedPreset, EnumFlagPresetConfig, ExecutionFlags, ExecutionPresetConfig, FlagPreset, FlagPresetConfig, InteractionFlags, NumberFlagPresetConfig, PaginationFlags, PaginationPresetConfig, ProjectionFlags, SchemaPreset, SchemaPresetConfig, StrictFlags, StringListFlagPresetConfig, TimeWindowFlags, TimeWindowPresetConfig } from "./shared/@outfitter/cli-x6qr7bnd.js";
+export { verbosePreset, timeWindowPreset, stringListFlagPreset, strictPreset, projectionPreset, paginationPreset, numberFlagPreset, isSchemaPreset, interactionPreset, forcePreset, executionPreset, enumFlagPreset, dryRunPreset, cwdPreset, createSchemaPreset, createPreset, composePresets, colorPreset, booleanFlagPreset, TimeWindowPresetConfig, TimeWindowFlags, StringListFlagPresetConfig, StrictFlags, SchemaPresetConfig, SchemaPreset, ProjectionFlags, PaginationPresetConfig, PaginationFlags, NumberFlagPresetConfig, InteractionFlags, FlagPresetConfig, FlagPreset, ExecutionPresetConfig, ExecutionFlags, EnumFlagPresetConfig, ComposedPreset, ColorMode, ColorFlags, BooleanFlagPresetConfig, AnyPreset };

package/dist/flags.js

@@ -4,12 +4,14 @@ import {
   colorPreset,
   composePresets,
   createPreset,
+  createSchemaPreset,
   cwdPreset,
   dryRunPreset,
   enumFlagPreset,
   executionPreset,
   forcePreset,
   interactionPreset,
+  isSchemaPreset,
   numberFlagPreset,
   paginationPreset,
   projectionPreset,
@@ -17,7 +19,7 @@ import {
   stringListFlagPreset,
   timeWindowPreset,
   verbosePreset
-} from "./shared/@outfitter/cli-pdb7znbq.js";
+} from "./shared/@outfitter/cli-8999qjdd.js";
 export {
   verbosePreset,
   timeWindowPreset,
@@ -26,12 +28,14 @@ export {
   projectionPreset,
   paginationPreset,
   numberFlagPreset,
+  isSchemaPreset,
   interactionPreset,
   forcePreset,
   executionPreset,
   enumFlagPreset,
   dryRunPreset,
   cwdPreset,
+  createSchemaPreset,
   createPreset,
   composePresets,
   colorPreset,

package/dist/hints.d.ts

@@ -0,0 +1,34 @@
+import { buildCommandTree, commandTreeHints } from "./shared/@outfitter/cli-yfewnyc2.js";
+import { buildActionGraph, graphErrorHints, graphSuccessHints } from "./shared/@outfitter/cli-pmd04gtv.js";
+import { ActionGraph, ActionGraphEdge, CommandTree, CommandTreeNode, CommandTreeOption } from "./shared/@outfitter/cli-16wg5mka.js";
+import { errorRecoveryHints } from "./shared/@outfitter/cli-tm2fzngs.js";
+import "./shared/@outfitter/cli-xde45xcc.js";
+import "./shared/@outfitter/cli-x6qr7bnd.js";
+/**
+* Populate hint params from a Zod input schema (Tier 3).
+*
+* Introspects the schema fields and produces a params record where each
+* key is a field name and each value is the field's description (or type
+* name as fallback).
+*
+* Enables agents to understand the expected parameter shapes for a command
+* without needing to parse the schema definition themselves.
+*
+* @param schema - A Zod object schema (or ZodObjectLike)
+* @returns A params record mapping field names to their descriptions/types
+*
+* @example
+* ```typescript
+* const schema = z.object({
+*   env: z.string().describe("Target environment"),
+*   force: z.boolean().describe("Force deployment"),
+* });
+*
+* const params = schemaHintParams(schema);
+* // { env: "Target environment", force: "Force deployment" }
+* ```
+*/
+declare function schemaHintParams(schema: {
+	shape: Record<string, unknown>;
+}): Record<string, unknown>;
+export { schemaHintParams, graphSuccessHints, graphErrorHints, errorRecoveryHints, commandTreeHints, buildCommandTree, buildActionGraph, CommandTreeOption, CommandTreeNode, CommandTree, ActionGraphEdge, ActionGraph };

package/dist/hints.js

@@ -0,0 +1,26 @@
+// @bun
+import {
+  schemaHintParams
+} from "./shared/@outfitter/cli-89335n9a.js";
+import {
+  buildCommandTree,
+  commandTreeHints
+} from "./shared/@outfitter/cli-htzez8v2.js";
+import {
+  buildActionGraph,
+  graphErrorHints,
+  graphSuccessHints
+} from "./shared/@outfitter/cli-hvg2m5gf.js";
+import {
+  errorRecoveryHints
+} from "./shared/@outfitter/cli-2dfxs239.js";
+import"./shared/@outfitter/cli-3jta1h1h.js";
+export {
+  schemaHintParams,
+  graphSuccessHints,
+  graphErrorHints,
+  errorRecoveryHints,
+  commandTreeHints,
+  buildCommandTree,
+  buildActionGraph
+};

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 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";
+import { exitWithError, output } from "./shared/@outfitter/cli-q6csxmeh.js";
+import "./shared/@outfitter/cli-10wxfc78.js";
+import { OutputMode } from "./shared/@outfitter/cli-x6qr7bnd.js";
 export { output, exitWithError, createTheme, Tokens, Theme, OutputMode, ANSI };

package/dist/input.d.ts

@@ -1,130 +1,9 @@
-import { CollectIdsOptions, ExpandFileOptions, FilterExpression, KeyValuePair, NormalizeIdOptions, ParseGlobOptions, Range, SortCriteria } from "./shared/@outfitter/cli-98aa9104.js";
+import { expandFileArg, parseFilter, parseGlob, parseKeyValue, parseRange, parseSortSpec } from "./shared/@outfitter/cli-h4ejpmjs.js";
+import { collectIds } from "./shared/@outfitter/cli-bcajqy33.js";
+import { NormalizeIdOptions } from "./shared/@outfitter/cli-x6qr7bnd.js";
 import { ValidationError } from "@outfitter/contracts";
 import { Result } from "better-result";
 /**
-* Collect IDs from various input formats.
-*
-* Handles space-separated, comma-separated, repeated flags, @file, and stdin.
-*
-* @param input - Raw input from CLI arguments
-* @param options - Collection options
-* @returns Array of collected IDs
-*
-* @example
-* ```typescript
-* // All these produce the same result:
-* // wm show id1 id2 id3
-* // wm show id1,id2,id3
-* // wm show --ids id1 --ids id2
-* // wm show @ids.txt
-* const ids = await collectIds(args.ids, {
-*   allowFile: true,
-*   allowStdin: true,
-* });
-* ```
-*/
-declare function collectIds(input: string | readonly string[], options?: CollectIdsOptions): Promise<string[]>;
-/**
-* Expand @file references to file contents.
-*
-* If the input starts with @, reads the file and returns its contents.
-* Otherwise, returns the input unchanged.
-*
-* @param input - Raw input that may be a @file reference
-* @param options - Expansion options
-* @returns File contents or original input
-*
-* @example
-* ```typescript
-* // wm create @template.md
-* const content = await expandFileArg(args.content);
-* ```
-*/
-declare function expandFileArg(input: string, options?: ExpandFileOptions): Promise<string>;
-/**
-* Parse and expand glob patterns.
-*
-* Uses Bun.Glob with workspace constraints.
-*
-* @param pattern - Glob pattern to expand
-* @param options - Glob options
-* @returns Array of matched file paths
-*
-* @example
-* ```typescript
-* // wm index "src/**\/*.ts"
-* const files = await parseGlob(args.pattern, {
-*   cwd: workspaceRoot,
-*   ignore: ["node_modules/**"],
-* });
-* ```
-*/
-declare function parseGlob(pattern: string, options?: ParseGlobOptions): Promise<string[]>;
-/**
-* Parse key=value pairs from CLI input.
-*
-* @param input - Raw input containing key=value pairs
-* @returns Array of parsed key-value pairs
-*
-* @example
-* ```typescript
-* // --set key=value --set key2=value2
-* // --set key=value,key2=value2
-* const pairs = parseKeyValue(args.set);
-* // => [{ key: "key", value: "value" }, { key: "key2", value: "value2" }]
-* ```
-*/
-declare function parseKeyValue(input: string | readonly string[]): Result<KeyValuePair[], InstanceType<typeof ValidationError>>;
-/**
-* Parse range inputs (numeric or date).
-*
-* @param input - Range string (e.g., "1-10" or "2024-01-01..2024-12-31")
-* @param type - Type of range to parse
-* @returns Parsed range
-*
-* @example
-* ```typescript
-* parseRange("1-10", "number");
-* // => Result<{ type: "number", min: 1, max: 10 }, ValidationError>
-*
-* parseRange("2024-01-01..2024-12-31", "date");
-* // => Result<{ type: "date", start: Date, end: Date }, ValidationError>
-* ```
-*/
-declare function parseRange(input: string, type: "number" | "date"): Result<Range, InstanceType<typeof ValidationError>>;
-/**
-* Parse filter expressions from CLI input.
-*
-* @param input - Filter string (e.g., "status:active,priority:high")
-* @returns Array of parsed filter expressions
-*
-* @example
-* ```typescript
-* parseFilter("status:active,priority:high");
-* // => Result<[
-* //   { field: "status", value: "active" },
-* //   { field: "priority", value: "high" }
-* // ], ValidationError>
-* ```
-*/
-declare function parseFilter(input: string): Result<FilterExpression[], InstanceType<typeof ValidationError>>;
-/**
-* Parse sort specification from CLI input.
-*
-* @param input - Sort string (e.g., "modified:desc,title:asc")
-* @returns Array of parsed sort criteria
-*
-* @example
-* ```typescript
-* parseSortSpec("modified:desc,title:asc");
-* // => Result<[
-* //   { field: "modified", direction: "desc" },
-* //   { field: "title", direction: "asc" }
-* // ], ValidationError>
-* ```
-*/
-declare function parseSortSpec(input: string): Result<SortCriteria[], InstanceType<typeof ValidationError>>;
-/**
 * Normalize an identifier (trim, lowercase where appropriate).
 *
 * @param input - Raw identifier input