@astrosheep/keiyaku 4.6.3 → 4.6.4

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku-akuma/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: keiyaku-akuma
 description: >-
-  Calling an Akuma: delegate work to a new or existing worker, then observe,
-  guide, and collect the result.
+  Use when the work involves Akuma or Aku, or when you want other hands on
+  it: delegating a job, or fanning out research, checks, or other parallel
+  work.
 ---
 
 # Keiyaku Akuma
@@ -22,7 +23,7 @@ waiting for the first answer. Use explicit `--wait <duration>` when this
 invocation should block while observing that initial work. `--wait` only bounds
 this command; it never stops the Akuma. Read `call --help` for flag syntax,
 defaults, and action vocabulary.
-For seat grants see `keiyaku-workflow`'s table; Reviewers need `--allowed contract.review`.
+To hand a Contract role to an Akuma, use the grant table in `keiyaku-workflow`.
 
 The selected Akuma name is a reusable worker configuration, not an individual.
 Calling it again creates an independent Akuma. Use different names for

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku-akuma/references/automation.md

@@ -46,8 +46,8 @@ skeptics to break the finalists, and generate replacements only for the
 identified weaknesses. Bound rounds and cost; "keep improving" is not a useful
 stop condition.
 
-Independent judgment needs independent contexts. Create separate Akuma for
-blind comparisons or adversarial verification. Reuse an identity for follow-up
+Blind comparisons and adversarial checks need separate contexts. Create
+separate Akuma for them. Reuse an identity for follow-up
 investigation, not as a supposedly fresh judge of its own earlier answer.
 
 ## Public Entry And A Single Structured Turn

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku-babysit/SKILL.md

@@ -52,7 +52,7 @@ does not move without you.
 | Observed shape | First response |
 | --- | --- |
 | Silent wedge: initial answer empty and worktree clean | Inspect status and history, then send one steering `tell`. If the worker remains unresponsive, `kill` and call a new Akuma; an empty answer alone is not proof the Contract failed. |
-| Verdict record refused with `not-allowed` | Read the worker's analysis in history; call a new Reviewer with the grant from `keiyaku-workflow`, then have it inspect current work and record a fresh verdict. The refused request wrote no Contract testimony. |
+| Verdict record refused with `not-allowed` | Read the worker's analysis in history. Record the verdict yourself if you did not deliver the candidate, or call a new Reviewer with the grant from `keiyaku-workflow` and have it inspect current work and record a fresh verdict. The refused request wrote no Contract testimony. |
 | Review stale after changed candidate tender | Normal content-currentness result. Give the same Reviewer the changed diff and current terms with `tell`; have it re-examine and record current testimony. A target move alone does not stale review. |
 | Target moved under the appointed worktree | Have the Deliverer inspect target movement and merge the target branch (main when selected) in that worktree when required; resolve conflicts there, then audit again. Do not resolve against a stale integration preview. |
 | Typed refusal names its rule | Fix the named input or physical condition, then retry from a fresh observation. Do not repeat the same request blindly. |

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku-bind/SKILL.md

@@ -205,7 +205,7 @@ waiting, the stated prerequisites remain; do not bind a duplicate Contract.
 
 The holder now owns the lifecycle:
 
-1. Start the work directly or delegate Tasks, Arc chapters, Akumas, or seats.
+1. Start the work directly or delegate Tasks, Arc chapters, Akumas, or Contract roles.
 2. Run independent work in parallel and let it converge on the one acceptance
    boundary.
 3. Prepare and deliver the candidate.

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku-workflow/SKILL.md

@@ -38,13 +38,26 @@ to create parallel work.
 Use `after` only when one `kei` requires another to be accepted first. Ordinary
 overlap is not a dependency.
 
-## 3. Hold the `kei`
+## 3. Roles
 
-Every `kei` has exactly one holder. The holder coordinates the work and owns
-acceptance until the Contract is accepted or abandoned. Delegation does not
-transfer that responsibility. An Akuma holding the whole loop needs the `kei`, current Arc
-when one exists, appointed worktree, holder duties, and actions its commission
-will perform. Birth freezes permissions; Contract association grants none.
+A `kei` has three roles. They are responsibilities, not people, and one agent
+may fill more than one of them, with one exception below.
+
+- **Holder:** exactly one per `kei`. Owns the fulfillment loop and acceptance
+  until the Contract is accepted or abandoned. Handing work to others never
+  transfers this responsibility.
+- **Deliverer:** produces the candidate in the appointed worktree and tenders
+  it with `deliver`.
+- **Reviewer:** judges the complete Contract against its acceptance conditions
+  and records the verdict with `review`.
+
+Review is independent when the Reviewer did not deliver the candidate under
+review. That is the whole requirement. The holder may review its own `kei`; a
+fresh Akuma is not what makes review independent. Keiyaku does not check who
+reviews, so keeping the Reviewer apart from the Deliverer is the holder's duty.
+
+Any role may be filled directly or handed to an Akuma. Hand one over when other
+hands help the work, not to make review count.
 
 ## 4. Lifecycle
 
@@ -78,31 +91,30 @@ Placement judges declared gates, not the producer's identity. Review does not
 replace Verification; audit never requests placement. Read the final receipt
 for stops and reconciliation lag after an admitted act.
 
-## 5. Seats And Capabilities
+## 5. Handing A Role To An Akuma
 
 This is the one commissioning map. `call --help` owns the exact action
-vocabulary and default set. `--contract` records association, not authority.
+vocabulary and default set. The flagship acting directly needs no grant.
+Birth freezes an Akuma's actions; `--contract` records association, not
+authority.
 
-| Seat | Grant and commission | Return |
+| Role | Grant at birth | Return |
 | --- | --- | --- |
-| Holder | Direct flagship commands need no Akuma grant. A delegated holder gets only its birth-time actions; include review when the delegated loop records review. | Own the acceptance loop and inspect receipts. |
-| Deliverer | The ordinary baseline includes every Task mutation, Contract audit and delivery, and Akuma management. `keiyaku -C <repo> call worker --alias @deliverer --contract <kei/...> --workdir <appointed-path> -` | Produce and tender the candidate; return the receipt. |
-| Reviewer | Add `--allowed contract.review` at birth: `keiyaku -C <repo> call review-akuma --alias @reviewer --contract <kei/...> --workdir <appointed-path> --allowed contract.review -` | Record a verdict and return its receipt. Without the grant, `not-allowed` refuses the mutation; no Contract verdict is recorded. |
+| Holder | The actions the delegated loop will perform; include `contract.review` when this holder will review. Commission with the `kei`, current Arc when one exists, appointed worktree, and holder duties. | Acceptance or abandonment, with receipts. |
+| Deliverer | The ordinary baseline: every Task mutation, Contract audit and delivery, and Akuma management. `keiyaku -C <repo> call worker --alias @deliverer --contract <kei/...> --workdir <appointed-path> -` | The delivery receipt. |
+| Reviewer | `--allowed contract.review`: `keiyaku -C <repo> call review-akuma --alias @reviewer --contract <kei/...> --workdir <appointed-path> --allowed contract.review -` | The verdict receipt. Without the grant, `not-allowed` refuses and no verdict is recorded. |
 
-An Archetype's explicit allowed set replaces the ordinary baseline. Check
+An Archetype's explicit allowed set replaces the ordinary baseline; check
 `status` for effective actions. `tell` and `fork` cannot add a grant to a live
-Akuma; call a fresh one with the grant. Nested calls cannot exceed their direct
-parent's actions.
-
-## 6. Delegate the Work
+Akuma, so call a fresh one with the grant. Nested calls cannot exceed their
+direct parent's actions.
 
 Commission with a clear objective, current Arc when one exists, appointed
-worktree, and expected result. A Deliverer produces the candidate. A Reviewer
-checks the complete Contract against its acceptance conditions and returns
-verdict evidence. Use `keiyaku-akuma` for invocation and observation, and
-command help for exact syntax.
+worktree, and expected result. Never ask the Akuma that delivered a candidate
+to review it. Use `keiyaku-akuma` for invocation and observation, and command
+help for exact syntax.
 
-## 7. Decide What Happens Next
+## 6. Decide What Happens Next
 
 The holder checks candidate, verification, review, prerequisites, and gates.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/keiyaku",
-  "version": "4.6.3",
+  "version": "4.6.4",
   "workspaces": [
     "plugins/*"
   ],