@outfitter/cli 0.5.2 → 1.0.0

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/index.js

@@ -1,17 +1,2 @@
-// @bun
-import"./shared/@outfitter/cli-zw75pdk8.js";
-import {
-  ANSI,
-  createTheme
-} from "./shared/@outfitter/cli-rk9zagkm.js";
-import"./shared/@outfitter/cli-jbj78ac5.js";
-import {
-  exitWithError,
-  output
-} from "./shared/@outfitter/cli-7wp5nj0s.js";
-export {
-  output,
-  exitWithError,
-  createTheme,
-  ANSI
-};
+export { ANSI, createTheme } from "./colors/index.js";
+export { exitWithError, output } from "./output.js";

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

package/dist/input.js

@@ -1,366 +1,21 @@
 // @bun
+import {
+  expandFileArg,
+  parseFilter,
+  parseGlob,
+  parseKeyValue,
+  parseRange,
+  parseSortSpec
+} from "./shared/@outfitter/cli-1q5redaj.js";
+import {
+  collectIds
+} from "./shared/@outfitter/cli-gqtkhgw4.js";
+import"./shared/@outfitter/cli-sy99pjyj.js";
+import"./shared/@outfitter/cli-6shkwxdc.js";
+
 // packages/cli/src/input.ts
-import path from "path";
 import { ValidationError } from "@outfitter/contracts";
 import { Err, Ok } from "better-result";
-function isSecurePath(filePath, allowAbsolute = false) {
-  if (filePath.includes("\x00")) {
-    return false;
-  }
-  if (filePath.includes("..")) {
-    return false;
-  }
-  const normalized = path.normalize(filePath);
-  if (!allowAbsolute && path.isAbsolute(normalized)) {
-    return false;
-  }
-  return true;
-}
-function isSecureGlobPattern(pattern) {
-  if (pattern.startsWith("..")) {
-    return false;
-  }
-  if (pattern.includes("/../")) {
-    return false;
-  }
-  return true;
-}
-function isWithinWorkspace(resolvedPath, workspaceRoot) {
-  const normalizedPath = path.normalize(resolvedPath);
-  const normalizedRoot = path.normalize(workspaceRoot);
-  return normalizedPath === normalizedRoot || normalizedPath.startsWith(normalizedRoot + path.sep);
-}
-async function readStdin() {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    if (typeof chunk === "string") {
-      chunks.push(chunk);
-    } else if (Buffer.isBuffer(chunk)) {
-      chunks.push(chunk.toString("utf-8"));
-    } else if (chunk instanceof Uint8Array) {
-      chunks.push(Buffer.from(chunk).toString("utf-8"));
-    }
-  }
-  return chunks.join("");
-}
-function splitIds(input) {
-  return input.split(",").flatMap((part) => part.trim().split(/\s+/)).map((id) => id.trim()).filter(Boolean);
-}
-async function isDirectory(path2) {
-  try {
-    const result = await Bun.$`test -d ${path2}`.quiet();
-    return result.exitCode === 0;
-  } catch {
-    return false;
-  }
-}
-async function isFile(path2) {
-  try {
-    const result = await Bun.$`test -f ${path2}`.quiet();
-    return result.exitCode === 0;
-  } catch {
-    return false;
-  }
-}
-async function collectIds(input, options) {
-  const { allowFile = true, allowStdin = true } = options ?? {};
-  const ids = [];
-  const inputs = Array.isArray(input) ? input : [input];
-  for (const item of inputs) {
-    if (!item)
-      continue;
-    if (item.startsWith("@")) {
-      const filePath = item.slice(1);
-      if (filePath === "-") {
-        if (!allowStdin) {
-          throw new Error("Reading from stdin is not allowed");
-        }
-        const stdinContent = await readStdin();
-        const stdinIds = stdinContent.split(`
-`).map((line) => line.trim()).filter(Boolean);
-        ids.push(...stdinIds);
-      } else {
-        if (!allowFile) {
-          throw new Error("File references are not allowed");
-        }
-        if (!isSecurePath(filePath, true)) {
-          throw new Error(`Security error: path traversal not allowed: ${filePath}`);
-        }
-        const file = Bun.file(filePath);
-        const exists = await file.exists();
-        if (!exists) {
-          throw new Error(`File not found: ${filePath}`);
-        }
-        const content = await file.text();
-        const fileIds = content.split(`
-`).map((line) => line.trim()).filter(Boolean);
-        ids.push(...fileIds);
-      }
-    } else {
-      ids.push(...splitIds(item));
-    }
-  }
-  return [...new Set(ids)];
-}
-async function expandFileArg(input, options) {
-  const {
-    encoding: _encoding = "utf-8",
-    maxSize,
-    trim = false
-  } = options ?? {};
-  if (!input.startsWith("@")) {
-    return input;
-  }
-  const filePath = input.slice(1);
-  if (filePath === "-") {
-    let content2 = await readStdin();
-    if (trim) {
-      content2 = content2.trim();
-    }
-    return content2;
-  }
-  if (!isSecurePath(filePath, true)) {
-    throw new Error(`Security error: path traversal not allowed: ${filePath}`);
-  }
-  const file = Bun.file(filePath);
-  const exists = await file.exists();
-  if (!exists) {
-    throw new Error(`File not found: ${filePath}`);
-  }
-  if (maxSize !== undefined) {
-    const size = file.size;
-    if (size > maxSize) {
-      throw new Error(`File exceeds maximum size of ${maxSize} bytes`);
-    }
-  }
-  let content = await file.text();
-  if (trim) {
-    content = content.trim();
-  }
-  return content;
-}
-async function parseGlob(pattern, options) {
-  const {
-    cwd = process.cwd(),
-    ignore = [],
-    onlyFiles = false,
-    onlyDirectories = false,
-    followSymlinks = false
-  } = options ?? {};
-  if (!isSecureGlobPattern(pattern)) {
-    throw new Error(`Security error: glob pattern may escape workspace: ${pattern}`);
-  }
-  const resolvedCwd = path.resolve(cwd);
-  const glob = new Bun.Glob(pattern);
-  const matches = [];
-  const scanOptions = {
-    cwd,
-    followSymlinks,
-    onlyFiles: onlyFiles === true
-  };
-  for await (const match of glob.scan(scanOptions)) {
-    const fullPath = path.resolve(cwd, match);
-    if (!isWithinWorkspace(fullPath, resolvedCwd)) {
-      continue;
-    }
-    let shouldIgnore = false;
-    for (const ignorePattern of ignore) {
-      const ignoreGlob = new Bun.Glob(ignorePattern);
-      if (ignoreGlob.match(match)) {
-        shouldIgnore = true;
-        break;
-      }
-    }
-    if (shouldIgnore)
-      continue;
-    if (onlyDirectories) {
-      const isDir = await isDirectory(fullPath);
-      if (!isDir)
-        continue;
-    }
-    if (onlyFiles) {
-      const isF = await isFile(fullPath);
-      if (!isF)
-        continue;
-    }
-    matches.push(match);
-  }
-  return matches;
-}
-function parseKeyValue(input) {
-  const pairs = [];
-  const inputs = Array.isArray(input) ? input : [input];
-  for (const item of inputs) {
-    if (!item)
-      continue;
-    const parts = item.split(",");
-    for (const part of parts) {
-      const trimmed = part.trim();
-      if (!trimmed)
-        continue;
-      const eqIndex = trimmed.indexOf("=");
-      if (eqIndex === -1) {
-        return new Err(new ValidationError({
-          message: `Missing '=' in key-value pair: ${trimmed}`
-        }));
-      }
-      const key = trimmed.slice(0, eqIndex).trim();
-      const value = trimmed.slice(eqIndex + 1);
-      if (!key) {
-        return new Err(new ValidationError({ message: "Empty key in key-value pair" }));
-      }
-      pairs.push({ key, value });
-    }
-  }
-  return new Ok(pairs);
-}
-function parseRange(input, type) {
-  const trimmed = input.trim();
-  if (type === "date") {
-    const parts = trimmed.split("..");
-    if (parts.length === 1) {
-      const dateStr = parts[0];
-      if (dateStr === undefined) {
-        return new Err(new ValidationError({ message: "Empty date input" }));
-      }
-      const date = new Date(dateStr.trim());
-      if (Number.isNaN(date.getTime())) {
-        return new Err(new ValidationError({ message: `Invalid date format: ${dateStr}` }));
-      }
-      return new Ok({ type: "date", start: date, end: date });
-    }
-    if (parts.length === 2) {
-      const startStr = parts[0];
-      const endStr = parts[1];
-      if (startStr === undefined || endStr === undefined) {
-        return new Err(new ValidationError({ message: "Invalid date range format" }));
-      }
-      const start = new Date(startStr.trim());
-      const end = new Date(endStr.trim());
-      if (Number.isNaN(start.getTime())) {
-        return new Err(new ValidationError({ message: `Invalid date format: ${startStr}` }));
-      }
-      if (Number.isNaN(end.getTime())) {
-        return new Err(new ValidationError({ message: `Invalid date format: ${endStr}` }));
-      }
-      if (start.getTime() > end.getTime()) {
-        return new Err(new ValidationError({
-          message: "Start date must be before or equal to end date"
-        }));
-      }
-      return new Ok({ type: "date", start, end });
-    }
-    return new Err(new ValidationError({ message: `Invalid date range format: ${input}` }));
-  }
-  const singleNum = Number(trimmed);
-  if (!(Number.isNaN(singleNum) || trimmed.includes("-", trimmed.startsWith("-") ? 1 : 0))) {
-    return new Ok({ type: "number", min: singleNum, max: singleNum });
-  }
-  let separatorIndex = -1;
-  for (let i = 1;i < trimmed.length; i++) {
-    const char = trimmed[i];
-    const prevChar = trimmed[i - 1];
-    if (char === "-" && prevChar !== undefined && /[\d\s]/.test(prevChar)) {
-      separatorIndex = i;
-      break;
-    }
-  }
-  if (separatorIndex === -1) {
-    return new Err(new ValidationError({ message: `Invalid numeric range format: ${input}` }));
-  }
-  const minStr = trimmed.slice(0, separatorIndex).trim();
-  const maxStr = trimmed.slice(separatorIndex + 1).trim();
-  const min = Number(minStr);
-  const max = Number(maxStr);
-  if (Number.isNaN(min)) {
-    return new Err(new ValidationError({ message: `Invalid number: ${minStr}` }));
-  }
-  if (Number.isNaN(max)) {
-    return new Err(new ValidationError({ message: `Invalid number: ${maxStr}` }));
-  }
-  if (min > max) {
-    return new Err(new ValidationError({ message: "Min must be less than or equal to max" }));
-  }
-  return new Ok({ type: "number", min, max });
-}
-function parseFilter(input) {
-  const trimmed = input.trim();
-  if (!trimmed) {
-    return new Ok([]);
-  }
-  const filters = [];
-  const parts = trimmed.split(",");
-  for (const part of parts) {
-    let partTrimmed = part.trim();
-    if (!partTrimmed)
-      continue;
-    let isNegated = false;
-    if (partTrimmed.startsWith("!")) {
-      isNegated = true;
-      partTrimmed = partTrimmed.slice(1).trim();
-    }
-    const colonIndex = partTrimmed.indexOf(":");
-    if (colonIndex === -1) {
-      return new Err(new ValidationError({
-        message: `Missing ':' in filter expression: ${part.trim()}`
-      }));
-    }
-    const field = partTrimmed.slice(0, colonIndex).trim();
-    let value = partTrimmed.slice(colonIndex + 1).trim();
-    let operator;
-    if (isNegated) {
-      operator = "ne";
-    } else if (value.startsWith(">=")) {
-      operator = "gte";
-      value = value.slice(2).trim();
-    } else if (value.startsWith("<=")) {
-      operator = "lte";
-      value = value.slice(2).trim();
-    } else if (value.startsWith(">")) {
-      operator = "gt";
-      value = value.slice(1).trim();
-    } else if (value.startsWith("<")) {
-      operator = "lt";
-      value = value.slice(1).trim();
-    } else if (value.startsWith("~")) {
-      operator = "contains";
-      value = value.slice(1).trim();
-    }
-    const filter = { field, value };
-    if (operator) {
-      filter.operator = operator;
-    }
-    filters.push(filter);
-  }
-  return new Ok(filters);
-}
-function parseSortSpec(input) {
-  const trimmed = input.trim();
-  if (!trimmed) {
-    return new Ok([]);
-  }
-  const criteria = [];
-  const parts = trimmed.split(",");
-  for (const part of parts) {
-    const partTrimmed = part.trim();
-    if (!partTrimmed)
-      continue;
-    const colonIndex = partTrimmed.indexOf(":");
-    if (colonIndex === -1) {
-      criteria.push({ field: partTrimmed, direction: "asc" });
-    } else {
-      const field = partTrimmed.slice(0, colonIndex).trim();
-      const direction = partTrimmed.slice(colonIndex + 1).trim().toLowerCase();
-      if (direction !== "asc" && direction !== "desc") {
-        return new Err(new ValidationError({
-          message: `Invalid sort direction: ${direction}. Must be 'asc' or 'desc'.`
-        }));
-      }
-      criteria.push({ field, direction });
-    }
-  }
-  return new Ok(criteria);
-}
 function normalizeId(input, options) {
   const {
     trim = false,

package/dist/internal/envelope-helpers.d.ts

@@ -0,0 +1,4 @@
+import { buildDryRunHint, createErrorEnvelope, createSuccessEnvelope, extractCategory, extractMessage, extractRetryAfterSeconds, formatEnvelopeHuman, getExitCode, safeCallHintFn } from "../shared/@outfitter/cli-nkt399zf.js";
+import "../shared/@outfitter/cli-30mt7c5w.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { safeCallHintFn, getExitCode, formatEnvelopeHuman, extractRetryAfterSeconds, extractMessage, extractCategory, createSuccessEnvelope, createErrorEnvelope, buildDryRunHint };

package/dist/internal/envelope-helpers.js

@@ -0,0 +1,24 @@
+// @bun
+import {
+  buildDryRunHint,
+  createErrorEnvelope,
+  createSuccessEnvelope,
+  extractCategory,
+  extractMessage,
+  extractRetryAfterSeconds,
+  formatEnvelopeHuman,
+  getExitCode,
+  safeCallHintFn
+} from "../shared/@outfitter/cli-ry7btmy4.js";
+import"../shared/@outfitter/cli-dg0cz7rw.js";
+export {
+  safeCallHintFn,
+  getExitCode,
+  formatEnvelopeHuman,
+  extractRetryAfterSeconds,
+  extractMessage,
+  extractCategory,
+  createSuccessEnvelope,
+  createErrorEnvelope,
+  buildDryRunHint
+};

package/dist/internal/envelope-types.d.ts

@@ -0,0 +1,3 @@
+import { CommandEnvelope, ErrorEnvelope, RunHandlerOptions, SuccessEnvelope } from "../shared/@outfitter/cli-30mt7c5w.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { SuccessEnvelope, RunHandlerOptions, ErrorEnvelope, CommandEnvelope };

package/dist/internal/flag-builders.d.ts

@@ -0,0 +1,3 @@
+import { booleanFlagPreset, enumFlagPreset, numberFlagPreset, stringListFlagPreset } from "../shared/@outfitter/cli-dv8kk4jw.js";
+import "../shared/@outfitter/cli-x6qr7bnd.js";
+export { stringListFlagPreset, numberFlagPreset, enumFlagPreset, booleanFlagPreset };