@astrosheep/keiyaku 2.8.4 → 2.9.0

package/README.md

@@ -26,25 +26,40 @@ Open a git repo. Run `keiyaku guide` and `keiyaku akuma list`. Then use `keiyaku
 ## Flow
 
 ```
-bind → arc → [call | amend | delivery work] → arc | renew | petition
+bind -> delivery work -> petition
+optional: arc -> delivery work -> arc; renew on base drift
 ```
 
 ---
 
 ## Tools
 
-**`call <name> [prompt|-]`** — Calls in an agent to do scoped work. If a round is open, the round scope is injected. Add `--incognito` for a one-off run with no response history.
+**`call NAME <BODY|->`** — Calls in an agent to do scoped work. When commissioned, call receives the current bind a0 or explicit arc intent. Body is a required literal or `-` for stdin; omitting body is an error even if stdin is piped. Add `--incognito` for a one-off run with no response history.
 
+```bash
+keiyaku call worker-akuma "Implement the retry tests. Report touched files and verification."
+keiyaku call worker-akuma - < prompt.md
 ```
-Implement the retry tests. Report touched files and verification.
+
+---
+
+**`tell PROJECTION [--wait DURATION] [--] <BODY|->`** — Writes intent to a projection mailbox. Body is a required literal or `-` for stdin. Ordinary bodies need no `--`; use `--` only when the body looks like an option or address. `tell --wait` joins after acceptance without a mandatory separator.
+
+```bash
+keiyaku tell kaji/3f2a1c99 "run integration first"
+keiyaku tell kaji/3f2a1c99 - < direction.md
+keiyaku tell kaji/3f2a1c99 --wait 5m "run integration first"
+keiyaku tell kaji/3f2a1c99 -- --stop
 ```
 
 ---
 
-**`revive <response-path> [prompt|-]`** — Continues a prior call session from a response artifact.
+**`revive ARTIFACT [BODY|-]`** — Starts a new helper projection from a retained response artifact. Omit body for the default continuation; pass a literal body or `-` for explicit stdin (blank explicit stdin fails).
 
 ```bash
-keiyaku revive .keiyaku/response/previous.md "Continue from here"
+keiyaku revive rsp_01ARZ3NDEKTSV4RRFFQ69G5FAV
+keiyaku revive rsp_01ARZ3NDEKTSV4RRFFQ69G5FAV "continue with the failing test"
+keiyaku revive rsp_01ARZ3NDEKTSV4RRFFQ69G5FAV - < continuation.md
 ```
 
 ---
@@ -58,23 +73,28 @@ keiyaku akuma show akuma-codex
 
 ---
 
-**`bind`** — Opens a branch and writes `KEIYAKU.md`. Repo must be clean.
+**`bind`** — Opens a branch and writes `KEIYAKU.md`. Repo must be clean. Bind supplies derived default intent a0.
 
 Vague criteria = vague results. Write "make it better" and don't blame anyone but yourself.
 
 ```
-bind:
-  title: "Retry logic for HTTP client"
-  goal: "5xx failures retry up to 3 times with exponential backoff"
-  criteria:
-    - Retry unit tests pass
-    - Public API unchanged
-    - Existing tests still pass
+# Retry logic for HTTP client
+
+## Objective
+5xx failures retry up to 3 times with exponential backoff
+
+## Scope
+- src/http/**
+
+## Checks
+- Retry unit tests pass
+- Public API unchanged
+- Existing tests still pass
 ```
 
 ---
 
-**`arc`** — Frame the next delivery arc. An existing open arc is sealed first.
+**`arc`** — Optional iteration boundary, not admission. Frames the next delivery intent; the first explicit arc seals a0, and later arcs seal the previous open explicit arc.
 
 ```
 # Retry backoff
@@ -88,7 +108,7 @@ Keep the public API unchanged. Commit the delivery work before sealing the arc.
 
 ---
 
-**`petition`** — Close the task.
+**`petition`** — Seals the current a0 or open explicit arc and enters settlement.
 
 `CLAIM` = verified, all criteria pass. `FORFEIT` = abandon, throw everything away.