@akagilnc/pi-workflow-roles 0.1.2456 → 0.1.2460

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.2460",
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
@@ -50,10 +58,24 @@ hermes -z "YOUR_LABOR_PROMPT" --in /path/to/project --no-restore-cwd \
50
58
  intermediate steps on stdout (unlike `-z`) — use when a labor run needs its
51
59
  steps inspected.
52
60
 
61
+ ## Measured constraints (host, 2026-08-28)
62
+
63
+ - The Nous free tier (`poolside/laguna-s-2.1:free`) rate-limits concurrent
64
+ labor calls on one account. Measured: with ~5 factory legs dispatching
65
+ simultaneously, losing legs saw sustained HTTP 429 across 9-29 detour
66
+ attempts while the 1-2 winners completed normally (Ming_LLM books runs
67
+ 01a046ec-*/01a046f4-*, 14:55-15:04 window).
68
+ - Keep at most ONE in-flight hermes labor call per account; queue the rest.
69
+ - On 429: back off once (~60s) and retry once; if still 429, stop and record
70
+ the typed engine failure in the receipt — do not hammer retries.
71
+
53
72
  ## Smoke test (run before first labor leg of a session)
54
73
 
55
74
  ```bash
56
75
  hermes -z "Reply with exactly one word: OK" --no-restore-cwd
76
+ # long-prompt form used by labor legs:
77
+ printf 'Reply with exactly one word: OK' > /tmp/smoke.txt
78
+ hermes -z "$(cat /tmp/smoke.txt)" --no-restore-cwd
57
79
  ```
58
80
 
59
81
  Expected: stdout is exactly `OK`, exit code 0. Verified 2026-08-28 on this