norn-cli 4.0.0 → 4.1.0

package/README.md

@@ -74,6 +74,27 @@ npm install -g norn-cli
 norn ./tests/smoke.norn -e dev
 ```
 
+For a hosted agent workflow, select one sequence and supply its runtime inputs explicitly:
+
+```bash
+norn run ./workflows/ticket.norn \
+  --sequence HandleTicket \
+  --param jiraTicket=NORN-482 \
+  --param-json context=./inputs/ticket-context.json \
+  --recording ./artifacts/ticket-run.json \
+  --json
+```
+
+`--param name=value` is repeatable and preserves the value as a string.
+`--param-json name=file.json` is also repeatable; it parses the file and assigns its typed JSON
+value directly to the declared sequence parameter. CLI values override authored defaults. Both
+forms require one file plus `--sequence`, reject undeclared or missing required parameters before
+execution, and cannot be combined with `@data`/`@theory` cases. `--recording` writes the normal
+secret-masked agent recording to an exact artifact path instead of the rolling local cache.
+
+Ordinary sequence runs handle `SIGINT` and `SIGTERM` as graceful cancellation requests. A repeated
+signal forces exit; cancelled processes use status 130 (`SIGINT`) or 143 (`SIGTERM`).
+
 ## `.nornenv` Templates And Extends
 
 Use `[template:name]` sections for reusable environment building blocks, then compose selectable `[env:name]` sections with `extends`. Only templates can be extended. Templates are not selectable from the VS Code environment picker or CLI; only `[env:...]` names can be used with `-e`.