Record native run alias for pipeline execution

This commit is contained in:
2026-11-19 17:47:40 +00:00
parent b038cc1a59
commit 5cdbc5400f

View File

@@ -195,6 +195,7 @@ notarius pipeline list
notarius pipeline show <pipeline-id>
notarius pipeline validate <pipeline-id>
notarius pipeline run <pipeline-id> --input-file <path>
notarius run <pipeline-id> --input-file <path>
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