@ontrails/commander 1.0.0-beta.32 → 1.0.0-beta.39

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @ontrails/commander
 
+## 1.0.0-beta.39
+
+### Patch Changes
+
+- [`f42ca6e`](https://github.com/outfitter-dev/trails/commit/f42ca6e40b29155acec446e5bf44e52e014466bd): Hard cutover: the CLI consumes `cli` bindings from the app-authored surfaces overlay. Scalar bindings behave identically to the removed cliAliases (parity-tested) — the binding name splits on `.` into a transparent synonym command path for exactly one trail. List bindings arrive as command groups: each expanded member trail gets a group-prefixed route that dispatches the member trail with its identity preserved, and a singleton list stays a group. Expansion is fail-fast boundary validation: a scalar binding resolving to zero or multiple trails, or a group with an empty member union, is a `ValidationError` naming the binding. `DeriveTopoGraphOptions.cliAliases`, the `cliAliases`/`trailsCliAliases` app-module export convention, and the per-kind compile lift are deleted; `deriveCliCommands`/`createProgram` take `overlays` instead of `aliases`, and both topo-graph derivation pipelines expand the same bindings through one shared helper so runtime CLI routes and lock routes come from one semantic. A leftover legacy export is now a Warden error (`no-legacy-cli-alias-export`) naming the `surfaceOverlay({ cli: { ... } })` rewrite.
+
+  This is a breaking API removal shipped under the lockstep beta patch convention (pre-1.0 hard-cutover posture, zero external adoption); the removed options have no deprecation window by design.
+
+## 1.0.0-beta.38
+
+## 1.0.0-beta.37
+
+## 1.0.0-beta.36
+
+## 1.0.0-beta.35
+
+## 1.0.0-beta.34
+
+## 1.0.0-beta.33
+
+### Patch Changes
+
+- [`945cb4b`](https://github.com/outfitter-dev/trails/commit/945cb4b0bef40ddb098c2a3816f9adad6f135410): Honor explicit structured input values over CLI flag defaults when commands merge
+  `--input-json` or `--input` payloads.
+
+  Commander now forwards user-supplied flag metadata so explicit flag values that
+  match a default still keep normal CLI precedence over structured input.
+
 ## 1.0.0-beta.32
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/commander",
-  "version": "1.0.0-beta.32",
+  "version": "1.0.0-beta.39",
   "files": [
     "src/**/*.ts",
     "!src/**/__tests__/**",
@@ -22,8 +22,8 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@ontrails/cli": "^1.0.0-beta.32",
-    "@ontrails/core": "^1.0.0-beta.32",
+    "@ontrails/cli": "^1.0.0-beta.39",
+    "@ontrails/core": "^1.0.0-beta.39",
     "commander": "^14.0.3"
   },
   "peerDependencies": {

package/src/surface.ts

@@ -4,8 +4,8 @@
 
 import type {
   BaseSurfaceOptions,
-  CliCommandAliasInput,
   Layer,
+  OverlayEnvelopeLike,
   ResourceOverrideMap,
   Topo,
   TrailContextInit,
@@ -28,9 +28,6 @@ import { toCommander } from './to-commander.js';
  * Options for creating Commander CLI surfaces from a Trails topo.
  */
 export interface CreateProgramOptions extends BaseSurfaceOptions {
-  readonly aliases?:
-    | Readonly<Record<string, readonly CliCommandAliasInput[]>>
-    | undefined;
   readonly createContext?:
     | (() => TrailContextInit | Promise<TrailContextInit>)
     | undefined;
@@ -38,6 +35,12 @@ export interface CreateProgramOptions extends BaseSurfaceOptions {
   readonly layers?: readonly Layer[] | undefined;
   readonly name?: string | undefined;
   readonly onResult?: ((ctx: ActionResultContext) => Promise<void>) | undefined;
+  /**
+   * App-authored overlay envelopes (conventionally the app module's
+   * `trailsOverlays` export); the `surfaces` envelope's `cli` bindings
+   * project synonym and command-group routes onto the program.
+   */
+  readonly overlays?: readonly OverlayEnvelopeLike[] | undefined;
   readonly presets?: CliFlag[][] | undefined;
   readonly resources?: ResourceOverrideMap | undefined;
   readonly resolveInput?: InputResolver | undefined;
@@ -93,7 +96,6 @@ export const createProgram = (
   options: CreateProgramOptions = {}
 ) => {
   const commandsResult = deriveCliCommands(graph, {
-    aliases: options.aliases,
     configValues: options.configValues,
     createContext: options.createContext,
     exclude: options.exclude,
@@ -101,6 +103,7 @@ export const createProgram = (
     intent: options.intent,
     layers: options.layers,
     onResult: options.onResult ?? defaultOnResult,
+    overlays: options.overlays,
     presets: options.presets,
     resolveInput: options.resolveInput,
     resolvePermitFromToken: options.resolvePermitFromToken,

package/src/to-commander.ts

@@ -581,7 +581,12 @@ const wireAction = (
         action.parsedFlags,
         action.userSuppliedFlagKeys
       );
-      await action.command.execute(action.parsedArgs, parsedFlags);
+      await action.command.execute(action.parsedArgs, parsedFlags, undefined, {
+        userSuppliedFlagKeys: getCanonicalUserSuppliedFlagKeys(
+          action.command.flags,
+          action.userSuppliedFlagKeys
+        ),
+      });
     } catch (error: unknown) {
       handleError(
         error,