@akagilnc/pi-workflow-roles 0.1.2456 → 0.1.2458

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@akagilnc/pi-workflow-roles",
3
- "version": "0.1.2456",
3
+ "version": "0.1.2458",
4
4
  "description": "Soul-bound workflow roles for Pi",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -33,8 +33,16 @@ hermes -z "YOUR_LABOR_PROMPT" --in /path/to/project --no-restore-cwd \
33
33
  - `--usage-file PATH` (works with `-z` only) writes a JSON spend report
34
34
  (`estimated_cost_usd`, token counts, model, provider, `completed`/`failed`)
35
35
  **even when the run fails** — attach it to the leg's receipt for accounting.
36
- - Long or untrusted prompts: `--query-file PATH` reads the prompt from a file
37
- verbatim ("nothing is shell-interpreted"); mutually exclusive with `-q`.
36
+ - Long prompts in scripting mode: write the prompt to a file, then pass it as
37
+ the single `-z` argument — `hermes -z "$(cat PATH)" ...`. The substitution
38
+ result is one argv entry; file content is not re-parsed by the shell.
39
+ Smoke-verified 2026-08-28: clean final-response-only stdout.
40
+ - `--query-file PATH` belongs to the `hermes chat` subcommand only (mutually
41
+ exclusive with its `-q`); it is NOT a top-level flag and does NOT combine
42
+ with `-z` — `hermes -z --query-file ...` fails with
43
+ `-z/--oneshot: expected one argument` (incident: Ming #1585 fixer leg,
44
+ 2026-08-28). `hermes chat --query-file` also prints a session summary
45
+ instead of the bare final response, so it is unfit for labor pipelines.
38
46
  - Model/provider default comes from host `~/.hermes/config.yaml`
39
47
  (owner-selected; verified 2026-08-28: `poolside/laguna-s-2.1:free` on Nous
40
48
  Portal). Override with `-m provider/model` + `--provider` only when the
@@ -54,6 +62,9 @@ hermes -z "YOUR_LABOR_PROMPT" --in /path/to/project --no-restore-cwd \
54
62
 
55
63
  ```bash
56
64
  hermes -z "Reply with exactly one word: OK" --no-restore-cwd
65
+ # long-prompt form used by labor legs:
66
+ printf 'Reply with exactly one word: OK' > /tmp/smoke.txt
67
+ hermes -z "$(cat /tmp/smoke.txt)" --no-restore-cwd
57
68
  ```
58
69
 
59
70
  Expected: stdout is exactly `OK`, exit code 0. Verified 2026-08-28 on this