Record native run alias for pipeline execution
This commit is contained in:
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user