@outfitter/cli 0.5.1 → 0.5.3

package/README.md

@@ -56,11 +56,11 @@ output(errors, { stream: process.stderr });
 
 **Options:**
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `mode` | `OutputMode` | auto | Force a specific output mode |
-| `stream` | `WritableStream` | `stdout` | Stream to write to |
-| `pretty` | `boolean` | `false` | Pretty-print JSON output |
+| Option   | Type             | Default  | Description                  |
+| -------- | ---------------- | -------- | ---------------------------- |
+| `mode`   | `OutputMode`     | auto     | Force a specific output mode |
+| `stream` | `WritableStream` | `stdout` | Stream to write to           |
+| `pretty` | `boolean`        | `false`  | Pretty-print JSON output     |
 
 **Output Modes:**
 
@@ -108,10 +108,10 @@ const ids = await collectIds(args.ids, {
 
 **Options:**
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `allowFile` | `boolean` | `true` | Allow `@file` expansion |
-| `allowStdin` | `boolean` | `true` | Allow `@-` for stdin |
+| Option       | Type      | Default | Description             |
+| ------------ | --------- | ------- | ----------------------- |
+| `allowFile`  | `boolean` | `true`  | Allow `@file` expansion |
+| `allowStdin` | `boolean` | `true`  | Allow `@-` for stdin    |
 
 #### `expandFileArg(input, options?)`
 
@@ -132,11 +132,11 @@ const content = await expandFileArg(args.content, {
 
 **Options:**
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `encoding` | `BufferEncoding` | `utf-8` | File encoding |
-| `maxSize` | `number` | - | Maximum file size in bytes |
-| `trim` | `boolean` | `false` | Trim whitespace |
+| Option     | Type             | Default | Description                |
+| ---------- | ---------------- | ------- | -------------------------- |
+| `encoding` | `BufferEncoding` | `utf-8` | File encoding              |
+| `maxSize`  | `number`         | -       | Maximum file size in bytes |
+| `trim`     | `boolean`        | `false` | Trim whitespace            |
 
 #### `parseGlob(pattern, options?)`
 
@@ -154,13 +154,13 @@ const files = await parseGlob("src/**/*.ts", {
 
 **Options:**
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `cwd` | `string` | `process.cwd()` | Working directory |
-| `ignore` | `string[]` | `[]` | Patterns to exclude |
-| `onlyFiles` | `boolean` | `false` | Only match files |
-| `onlyDirectories` | `boolean` | `false` | Only match directories |
-| `followSymlinks` | `boolean` | `false` | Follow symbolic links |
+| Option            | Type       | Default         | Description            |
+| ----------------- | ---------- | --------------- | ---------------------- |
+| `cwd`             | `string`   | `process.cwd()` | Working directory      |
+| `ignore`          | `string[]` | `[]`            | Patterns to exclude    |
+| `onlyFiles`       | `boolean`  | `false`         | Only match files       |
+| `onlyDirectories` | `boolean`  | `false`         | Only match directories |
+| `followSymlinks`  | `boolean`  | `false`         | Follow symbolic links  |
 
 #### `parseKeyValue(input)`
 
@@ -219,15 +219,15 @@ if (result.isOk()) {
 
 **Filter Operators:**
 
-| Prefix | Operator | Description |
-|--------|----------|-------------|
-| (none) | `eq` | Equals (default) |
-| `!` | `ne` | Not equals |
-| `>` | `gt` | Greater than |
-| `<` | `lt` | Less than |
-| `>=` | `gte` | Greater than or equal |
-| `<=` | `lte` | Less than or equal |
-| `~` | `contains` | Contains substring |
+| Prefix | Operator   | Description           |
+| ------ | ---------- | --------------------- |
+| (none) | `eq`       | Equals (default)      |
+| `!`    | `ne`       | Not equals            |
+| `>`    | `gt`       | Greater than          |
+| `<`    | `lt`       | Less than             |
+| `>=`   | `gte`      | Greater than or equal |
+| `<=`   | `lte`      | Less than or equal    |
+| `~`    | `contains` | Contains substring    |
 
 #### `parseSortSpec(input)`
 
@@ -268,13 +268,13 @@ if (result.isOk()) {
 
 **Options:**
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `trim` | `boolean` | `false` | Trim whitespace |
+| Option      | Type      | Default | Description          |
+| ----------- | --------- | ------- | -------------------- |
+| `trim`      | `boolean` | `false` | Trim whitespace      |
 | `lowercase` | `boolean` | `false` | Convert to lowercase |
-| `minLength` | `number` | - | Minimum length |
-| `maxLength` | `number` | - | Maximum length |
-| `pattern` | `RegExp` | - | Required pattern |
+| `minLength` | `number`  | -       | Minimum length       |
+| `maxLength` | `number`  | -       | Maximum length       |
+| `pattern`   | `RegExp`  | -       | Required pattern     |
 
 #### `confirmDestructive(options)`
 
@@ -363,10 +363,15 @@ 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";
+import {
+  composePresets,
+  verbosePreset,
+  cwdPreset,
+  forcePreset,
+} from "@outfitter/cli/flags";
 import { outputModePreset } from "@outfitter/cli/query";
 
 const preset = composePresets(verbosePreset(), cwdPreset(), forcePreset());
@@ -382,6 +387,7 @@ command("deploy")
 **Available presets:** `verbosePreset`, `cwdPreset`, `dryRunPreset`, `forcePreset`, `interactionPreset`, `strictPreset`, `colorPreset`, `projectionPreset`, `paginationPreset`, `timeWindowPreset`, `executionPreset`, `outputModePreset`, `jqPreset`
 
 **Additional modules:**
+
 - `@outfitter/cli/verbs` — Standard verb families (`create`, `modify`, `remove`, `list`, `show`)
 - `@outfitter/cli/query` — Output mode and jq expression presets
 - `@outfitter/cli/completion` — Shell completion script generation
@@ -390,19 +396,20 @@ command("deploy")
 
 ### Environment Variables
 
-| 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 |
+| 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)
@@ -449,18 +456,18 @@ The bridge uses `optsWithGlobals()` so global and subcommand `--json` flags both
 
 Exit codes are automatically determined from error categories:
 
-| Category | Exit Code |
-|----------|-----------|
-| `validation` | 1 |
-| `not_found` | 2 |
-| `conflict` | 3 |
-| `permission` | 4 |
-| `timeout` | 5 |
-| `rate_limit` | 6 |
-| `network` | 7 |
-| `internal` | 8 |
-| `auth` | 9 |
-| `cancelled` | 130 |
+| Category     | Exit Code |
+| ------------ | --------- |
+| `validation` | 1         |
+| `not_found`  | 2         |
+| `conflict`   | 3         |
+| `permission` | 4         |
+| `timeout`    | 5         |
+| `rate_limit` | 6         |
+| `network`    | 7         |
+| `internal`   | 8         |
+| `auth`       | 9         |
+| `cancelled`  | 130       |
 
 ### Tagged Errors
 
@@ -478,9 +485,18 @@ exitWithError(error); // Exits with code 2
 All types are exported for TypeScript consumers:
 
 ```typescript
-import type { CLIConfig, CommandConfig, CommandAction, CommandFlags } from "@outfitter/cli/command";
+import type {
+  CLIConfig,
+  CommandConfig,
+  CommandAction,
+  CommandFlags,
+} from "@outfitter/cli/command";
 import type { OutputMode, OutputOptions } from "@outfitter/cli/output";
-import type { CollectIdsOptions, ExpandFileOptions, ParseGlobOptions } from "@outfitter/cli/input";
+import type {
+  CollectIdsOptions,
+  ExpandFileOptions,
+  ParseGlobOptions,
+} from "@outfitter/cli/input";
 import type { PaginationState, CursorOptions } from "@outfitter/cli/pagination";
 ```
 

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

@@ -1,17 +1 @@
-// @bun
-import"../shared/@outfitter/cli-zw75pdk8.js";
-import {
-  ANSI,
-  applyColor,
-  createTheme,
-  createTokens,
-  resolveTokenColorEnabled
-} from "../shared/@outfitter/cli-rk9zagkm.js";
-import"../shared/@outfitter/cli-jbj78ac5.js";
-export {
-  resolveTokenColorEnabled,
-  createTokens,
-  createTheme,
-  applyColor,
-  ANSI
-};
+export { ANSI, applyColor, createTheme, createTokens, resolveTokenColorEnabled } from "./colors.js";

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/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,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/output.js

@@ -1,9 +1,170 @@
 // @bun
+// packages/cli/src/output.ts
+import { getEnvironment, getEnvironmentDefaults } from "@outfitter/config";
 import {
-  exitWithError,
-  output,
-  resolveVerbose
-} from "./shared/@outfitter/cli-7wp5nj0s.js";
+  safeStringify as contractsSafeStringify,
+  exitCodeMap
+} from "@outfitter/contracts";
+var DEFAULT_EXIT_CODE = 1;
+function writeWithBackpressure(stream, data) {
+  return new Promise((resolve, reject) => {
+    const canContinue = stream.write(data, (error) => {
+      if (error)
+        reject(error);
+    });
+    if (canContinue) {
+      resolve();
+    } else {
+      stream.once("drain", () => resolve());
+      stream.once("error", reject);
+    }
+  });
+}
+function detectMode(options) {
+  if (options?.mode) {
+    return options.mode;
+  }
+  const envJsonl = process.env["OUTFITTER_JSONL"];
+  const envJson = process.env["OUTFITTER_JSON"];
+  if (envJsonl === "1")
+    return "jsonl";
+  if (envJson === "1")
+    return "json";
+  if (envJsonl === "0" || envJson === "0")
+    return "human";
+  return "human";
+}
+function isValidCategory(category) {
+  return category in exitCodeMap;
+}
+function safeStringify(value, pretty) {
+  const wrappedValue = value === undefined ? null : value;
+  return contractsSafeStringify(wrappedValue, pretty ? 2 : undefined);
+}
+function formatHuman(data) {
+  if (data === null || data === undefined) {
+    return "";
+  }
+  if (typeof data === "string") {
+    return data;
+  }
+  if (typeof data === "number" || typeof data === "boolean") {
+    return String(data);
+  }
+  if (Array.isArray(data)) {
+    return data.map((item) => formatHuman(item)).join(`
+`);
+  }
+  if (typeof data === "object") {
+    const lines = [];
+    for (const [key, value] of Object.entries(data)) {
+      lines.push(`${key}: ${formatHuman(value)}`);
+    }
+    return lines.join(`
+`);
+  }
+  return String(data);
+}
+function getErrorProperties(error) {
+  const errorObj = error;
+  return {
+    _tag: errorObj._tag,
+    category: errorObj.category,
+    context: errorObj.context
+  };
+}
+function getExitCode(error) {
+  const { category } = getErrorProperties(error);
+  if (category !== undefined && isValidCategory(category)) {
+    return exitCodeMap[category];
+  }
+  return DEFAULT_EXIT_CODE;
+}
+function serializeErrorToJson(error) {
+  const { _tag, category, context } = getErrorProperties(error);
+  const result = {
+    message: error.message
+  };
+  if (_tag !== undefined) {
+    result._tag = _tag;
+  }
+  if (category !== undefined) {
+    result.category = category;
+  }
+  if (context !== undefined) {
+    result.context = context;
+  }
+  return JSON.stringify(result);
+}
+function formatErrorHuman(error) {
+  const { _tag } = getErrorProperties(error);
+  if (_tag) {
+    return `${_tag}: ${error.message}`;
+  }
+  return error.message;
+}
+async function output(data, options) {
+  const mode = detectMode(options);
+  const stream = options?.stream ?? process.stdout;
+  let outputText;
+  switch (mode) {
+    case "json": {
+      const jsonData = data === undefined ? null : data;
+      outputText = safeStringify(jsonData, options?.pretty);
+      break;
+    }
+    case "jsonl": {
+      if (Array.isArray(data)) {
+        if (data.length === 0) {
+          outputText = "";
+        } else {
+          outputText = data.map((item) => safeStringify(item)).join(`
+`);
+        }
+      } else {
+        outputText = safeStringify(data);
+      }
+      break;
+    }
+    default: {
+      outputText = formatHuman(data);
+      break;
+    }
+  }
+  if (outputText) {
+    await writeWithBackpressure(stream, `${outputText}
+`);
+  }
+}
+function exitWithError(error, options) {
+  const exitCode = getExitCode(error);
+  const mode = detectMode({
+    ...options,
+    stream: options?.stream ?? process.stderr
+  });
+  const isJsonMode = mode === "json" || mode === "jsonl";
+  if (isJsonMode) {
+    process.stderr.write(`${serializeErrorToJson(error)}
+`);
+  } else {
+    process.stderr.write(`${formatErrorHuman(error)}
+`);
+  }
+  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 {
   resolveVerbose,
   output,

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-5vtr4bdt.js";
 export {
   generateManifest,
   formatManifestHuman,

package/dist/shared/@outfitter/{cli-g0sn0r0b.js → cli-5vtr4bdt.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(", ")}`);
@@ -174,6 +174,7 @@ function createSchemaCommand(source, options) {
     const diffCmd = new Command("diff").description("Compare runtime schema against committed surface map").option("--output <mode>", "Output mode (human, json)", "human").option("--against <version>", "Compare runtime against a named snapshot").option("--from <version>", "Base snapshot for snapshot-to-snapshot diff").option("--to <version>", "Target snapshot for snapshot-to-snapshot diff").action(async (diffOptions) => {
       let left;
       let right;
+      let diffMode = "committed-to-runtime";
       if (diffOptions.from && !diffOptions.to || !diffOptions.from && diffOptions.to) {
         process.stderr.write(`Both --from and --to are required for snapshot-to-snapshot diff.
 `);
@@ -181,6 +182,7 @@ function createSchemaCommand(source, options) {
         return;
       }
       if (diffOptions.from && diffOptions.to) {
+        diffMode = "snapshot-to-snapshot";
         const fromPath = resolveSnapshotPath(cwd, outputDir, diffOptions.from);
         const toPath = resolveSnapshotPath(cwd, outputDir, diffOptions.to);
         try {
@@ -210,6 +212,7 @@ function createSchemaCommand(source, options) {
           return;
         }
       } else if (diffOptions.against) {
+        diffMode = "snapshot-to-runtime";
         const snapshotPath = resolveSnapshotPath(cwd, outputDir, diffOptions.against);
         try {
           left = await readSurfaceMap(snapshotPath);
@@ -244,7 +247,7 @@ function createSchemaCommand(source, options) {
         }
         right = generateSurfaceMap(source, { generator: "runtime" });
       }
-      const result = diffSurfaceMaps(left, right);
+      const result = diffSurfaceMaps(left, right, { mode: diffMode });
       if (diffOptions.output === "json") {
         process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);

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 };