@fernado03/zoo-flow 0.7.4 → 0.7.6

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,7 +1,7 @@
1
1
  {
2
2
  "name": "@fernado03/zoo-flow",
3
3
  "description": "Workflow control plane for Zoo Code.",
4
- "version": "0.7.4",
4
+ "version": "0.7.6",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "zoo-flow": "bin/zoo-flow.js"
@@ -22,7 +22,7 @@ Before any `attempt_completion`, re-read the command body and confirm no later p
22
22
 
23
23
  The orchestrator forwards your output to the user. Include enough detail that the user can act on it without re-running commands.
24
24
 
25
- If the output is long (multi-file diff summary, full test output, verification report), write it to `.scratch/` first and reference the path in `attempt_completion`. The extension may truncate long completion messages, so files ensure nothing is lost.
25
+ If the output is long, also write it to `.scratch/` for persistence and user reference. Mention the file path in `attempt_completion` so the user can open it. The orchestrator will not read the file it only presents your completion message.
26
26
 
27
27
  Before running `git commit` or `git push`, halt and wait for explicit user approval. Never push unless explicitly asked.
28
28
 
@@ -6,13 +6,14 @@ Router only. No reading implementation files, editing, shell, or answering imple
6
6
 
7
7
  After `attempt_completion` from a worker, the orchestrator must:
8
8
 
9
- 1. If the completion message references a `.scratch/` file, read and present that file's content.
10
- 2. Show the worker's full output to the user without truncating or summarizing.
11
- 3. Add one line: recommended next command (if any).
12
- 4. Stop and wait for user input.
9
+ 1. Show the worker's full output to the user without truncating or summarizing.
10
+ 2. Add one line: recommended next command (if any).
11
+ 3. Stop and wait for user input.
13
12
 
14
13
  Do not route a new user message until the previous subtask result is fully presented. If the user sends a new message before the result was shown, finish presenting the result first, then route the new message.
15
14
 
15
+ The `.scratch/` file referenced in the completion is for user reference only — the orchestrator does not read it.
16
+
16
17
  ## Hard delegation boundary
17
18
 
18
19
  For free-form requests, the only valid `new_task` target slugs are:
@@ -11,9 +11,9 @@ If you entered this window via `switch_mode` (you are mid-chain, not the entry p
11
11
 
12
12
  Before any `attempt_completion`, re-read the command body and confirm no later phase is assigned to another mode. If one is, `switch_mode` instead.
13
13
 
14
- Do not use `attempt_completion` to avoid required implementation work. Every `attempt_completion` must include the full output the user needs to see (review findings, exploration map, diagnosis, plan), not just summaries. The orchestrator will forward your output to the user; if you summarize, the user loses detail.
14
+ Do not use `attempt_completion` to avoid required implementation work. Every `attempt_completion` must include the full output the user needs to see (review findings, exploration map, diagnosis, plan), not just summaries. The orchestrator forwards your output to the user; if you summarize, the user loses detail.
15
15
 
16
- If the output is long (multi-page review, full exploration map, detailed diagnosis), write it to `.scratch/` first and reference the path in `attempt_completion`. The extension may truncate long completion messages, so files ensure nothing is lost.
16
+ If the output is long, also write it to `.scratch/` for persistence and user reference. Mention the file path in `attempt_completion` so the user can open it. The orchestrator will not read the file it only presents your completion message.
17
17
 
18
18
  Halt for explicit user approval before testing a bug hypothesis, finalizing an architecture plan, publishing issues, or making irreversible decisions.
19
19