@akagilnc/pi-workflow-roles 0.1.2453 → 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 +1 -1
- package/resources/engines/hermes.md +73 -0
package/package.json
CHANGED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# hermes engine method material
|
|
2
|
+
|
|
3
|
+
This file is packaged technical material for the optional `hermes` labor
|
|
4
|
+
engine (Hermes Agent CLI on the host; current owner directive routes the
|
|
5
|
+
free-tier labor leg through it). Sourced from the official CLI reference
|
|
6
|
+
(hermes-agent.nousresearch.com/docs/reference/cli-commands, read 2026-08-28)
|
|
7
|
+
plus a live smoke on this host.
|
|
8
|
+
|
|
9
|
+
Before invoking the engine, read `../engine-dispatch.md`, resolving that path
|
|
10
|
+
relative to this note. This note only covers this engine's CLI technical
|
|
11
|
+
parameters.
|
|
12
|
+
|
|
13
|
+
## Invocation (official one-shot scripting mode)
|
|
14
|
+
|
|
15
|
+
The machine entrypoint is `hermes`. `-z` is the official pure-scripting mode:
|
|
16
|
+
"single prompt in, final response text out, nothing else on stdout or stderr"
|
|
17
|
+
— no banner, no spinner, no tool previews. Exit codes: `0` success,
|
|
18
|
+
`1` backend/delivery failure, `2` usage errors.
|
|
19
|
+
|
|
20
|
+
Factory labor line:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
hermes -z "YOUR_LABOR_PROMPT" --in /path/to/project --no-restore-cwd \
|
|
24
|
+
--ignore-rules --usage-file /tmp/hermes-usage.json
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
- `--in DIR` changes directory before start and scopes workspace lookups.
|
|
28
|
+
- `--no-restore-cwd` keeps the run from touching the interactive session's
|
|
29
|
+
working-directory state.
|
|
30
|
+
- `--ignore-rules` skips the host's personal AGENTS.md/SOUL.md/.cursorrules
|
|
31
|
+
and memory injection — required for factory legs so the owner's personal
|
|
32
|
+
agent identity does not leak into labor output.
|
|
33
|
+
- `--usage-file PATH` (works with `-z` only) writes a JSON spend report
|
|
34
|
+
(`estimated_cost_usd`, token counts, model, provider, `completed`/`failed`)
|
|
35
|
+
**even when the run fails** — attach it to the leg's receipt for accounting.
|
|
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.
|
|
46
|
+
- Model/provider default comes from host `~/.hermes/config.yaml`
|
|
47
|
+
(owner-selected; verified 2026-08-28: `poolside/laguna-s-2.1:free` on Nous
|
|
48
|
+
Portal). Override with `-m provider/model` + `--provider` only when the
|
|
49
|
+
dispatch order says so.
|
|
50
|
+
- Isolation stronger than `--ignore-rules` exists but has trade-offs:
|
|
51
|
+
`--ignore-user-config` also drops the config-file model default and switches
|
|
52
|
+
credential loading to `.env`; `--safe-mode` additionally disables plugins,
|
|
53
|
+
hooks and MCP. Do not use them for routine labor unless the order says so —
|
|
54
|
+
they can sever the owner-configured model/auth path.
|
|
55
|
+
- Do NOT pass `--yolo` (blanket approval bypass) for factory labor;
|
|
56
|
+
permissions stay at the CLI's defaults.
|
|
57
|
+
- Debug variant: `hermes chat -q "..."` runs one-shot **with** tool output and
|
|
58
|
+
intermediate steps on stdout (unlike `-z`) — use when a labor run needs its
|
|
59
|
+
steps inspected.
|
|
60
|
+
|
|
61
|
+
## Smoke test (run before first labor leg of a session)
|
|
62
|
+
|
|
63
|
+
```bash
|
|
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
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Expected: stdout is exactly `OK`, exit code 0. Verified 2026-08-28 on this
|
|
71
|
+
host (model `poolside/laguna-s-2.1:free`, Nous Portal). If it fails, check
|
|
72
|
+
`hermes status` (model/provider block) and `~/.hermes/provider_models_cache.json`
|
|
73
|
+
for the current catalog; the interactive picker is `hermes model`.
|