@akagilnc/pi-workflow-roles 0.1.2464 → 0.1.2469
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/opus.md +16 -1
- package/resources/engines/sonnet.md +27 -0
package/package.json
CHANGED
|
@@ -18,7 +18,12 @@ requires `--verbose` — without it the CLI exits immediately with
|
|
|
18
18
|
Include `--verbose` in stream-json argv. Measured with separate fd redirects
|
|
19
19
|
(`1>` / `2>`): NDJSON event rows land on stdout (including intermediate
|
|
20
20
|
`system` / `assistant` activity and a final `type:"result"` row); stderr is
|
|
21
|
-
empty on the success path
|
|
21
|
+
empty on the success path — except when stdin is an open stream supplying no
|
|
22
|
+
data (e.g. a shell test without redirection): then a benign
|
|
23
|
+
`Warning: no stdin data received in 3s, proceeding without it` lands on stderr
|
|
24
|
+
after a 3-second wait (host-verified 2026-08-28); redirect `< /dev/null` in
|
|
25
|
+
shell tests. The packaged detour tool spawns engines with stdin ignored
|
|
26
|
+
(`/dev/null`), which avoids this path:
|
|
22
27
|
|
|
23
28
|
```bash
|
|
24
29
|
claude -p --verbose --output-format=stream-json "YOUR_LABOR_PROMPT"
|
|
@@ -36,5 +41,15 @@ Use `--output-format=stream-json` (choices measured on this host: `text`, `json`
|
|
|
36
41
|
works; take the labor body from the final `result` event's `result` field,
|
|
37
42
|
not from intermediate stream rows.
|
|
38
43
|
|
|
44
|
+
## Headless permissions
|
|
45
|
+
|
|
46
|
+
`--dangerously-skip-permissions` is required in headless labor: the CLI's
|
|
47
|
+
permission prompts cannot be answered without a TTY and are auto-denied. In
|
|
48
|
+
particular, reading any path outside the project root — such as frozen
|
|
49
|
+
attachments under `~/.ak-roles/books/<book>/runs/<run>/attachments/` — is
|
|
50
|
+
refused without the flag ("The read was not permitted — I don't have access to
|
|
51
|
+
that file outside the current worktree") and succeeds with it (host-verified
|
|
52
|
+
2026-08-28, both directions).
|
|
53
|
+
|
|
39
54
|
Prefer `claude --help` on the host over any remembered flag set. Do not wrap this
|
|
40
55
|
engine behind `ak-role` flags.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# sonnet engine method material
|
|
2
|
+
|
|
3
|
+
This file is packaged technical material for the optional `sonnet` labor engine
|
|
4
|
+
(Claude Code CLI on the host, pinned to the Sonnet model).
|
|
5
|
+
|
|
6
|
+
Before invoking the engine, read `../engine-dispatch.md`, resolving that path
|
|
7
|
+
relative to this note. This note only covers this engine's CLI technical
|
|
8
|
+
parameters.
|
|
9
|
+
|
|
10
|
+
## Invocation
|
|
11
|
+
|
|
12
|
+
Same host CLI as the `opus` engine: the machine entrypoint is `claude`, and all
|
|
13
|
+
CLI mechanics (print mode, `--output-format=stream-json` requiring `--verbose`,
|
|
14
|
+
fd layout, result-row extraction) are documented in `../opus.md` — read that
|
|
15
|
+
note for them; they are not duplicated here.
|
|
16
|
+
|
|
17
|
+
The only difference is the model pin:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
claude -p --model sonnet --verbose --output-format=stream-json "YOUR_LABOR_PROMPT"
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
`--model sonnet` is verified accepted on this host (Claude Code 2.1.233); the
|
|
24
|
+
stream-json init event reports `claude-sonnet-5` (host-verified 2026-08-28).
|
|
25
|
+
|
|
26
|
+
Prefer `claude --help` on the host over any remembered flag set. Do not wrap
|
|
27
|
+
this engine behind `ak-role` flags.
|