norn-cli 4.0.1 → 4.2.0

package/README.md

@@ -74,6 +74,29 @@ 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 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. Unnamed values follow declaration order and
+skip parameters supplied by name, so named and positional inputs can be mixed. 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`.