diff --git a/docs/roadmap/commandkit-migration-discussion.md b/docs/roadmap/commandkit-migration-discussion.md index 3e40a7f8..387d709c 100644 --- a/docs/roadmap/commandkit-migration-discussion.md +++ b/docs/roadmap/commandkit-migration-discussion.md @@ -195,6 +195,7 @@ notarius pipeline list notarius pipeline show notarius pipeline validate notarius pipeline run --input-file +notarius run --input-file notarius config scopes notarius config validate|show|sources|explain|diff ... @@ -218,6 +219,7 @@ they are not literal shell commands. | `pipeline show` | Describe the resolved ordered steps, lanes, modules, reference slots, and configured selections. | | `pipeline validate` | Perform offline application preflight using the intended selections and overrides. | | `pipeline run` | Execute the selected pipeline and publish artifacts. | +| `run` | Native convenience alias for `pipeline run`. | Move pipeline-specific validation out of `config validate --pipeline ...`. Configuration validation, pipeline composition checks, and concrete PromptKit @@ -225,12 +227,17 @@ request validation remain distinct. Pipeline preflight does not synthesize stage requests or require provider credentials. PromptKit's concrete validation may read inputs and schemas and check credentials without making a model call. -**Naming clarification:** CommandKit supports both a root `run` command and a -nested `pipeline run` command. Neither is more native. The selected grouping -keeps pipeline discovery, inspection, validation, and execution together; it is -an application usability choice, not an upstream naming requirement. A shorter -root command could be selected on usability grounds without changing the native -architecture. Do not introduce a second route solely for legacy compatibility. +**Naming decision:** Keep `pipeline run` as the canonical command and install +`run` as a native convenience alias using +`commandkit.Alias("run", "pipeline run")`. Both routes use the same handler, +operands, flags, validation, and reporting. CommandKit supplies alias-aware help +and diagnostics; no forwarding handler or additional parser is needed. + +The grouped family and root shortcut are application usability choices, not an +upstream naming requirement. The alias uses the new input conventions and does +not preserve legacy flags or behavior. Use `notarius run` in quick-start examples +and document both routes in the command reference when the migration lands. +See [native alias behavior](../../../commandkit/docs/cli.md#application-owned-aliases). ### Input Conventions