@astrosheep/keiyaku 0.1.86 → 1.0.0

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.
Files changed (157) hide show
  1. package/README.md +15 -23
  2. package/build/.tsbuildinfo +1 -1
  3. package/build/agents/effective-policy.js +32 -0
  4. package/build/agents/harness/event-channel.js +178 -0
  5. package/build/agents/harness/execution-handle.js +117 -0
  6. package/build/agents/harness/index.js +622 -0
  7. package/build/agents/harness/pump.js +152 -0
  8. package/build/agents/harness/runtime.js +68 -0
  9. package/build/agents/index.js +104 -212
  10. package/build/agents/opencode-sdk.js +12 -18
  11. package/build/agents/providers/claude-agent-sdk.js +529 -0
  12. package/build/agents/providers/codex-app-server.js +656 -0
  13. package/build/agents/providers/codex-sdk.js +193 -0
  14. package/build/agents/providers/opencode-sdk.js +257 -0
  15. package/build/agents/providers/pi.js +345 -0
  16. package/build/agents/selector.js +15 -6
  17. package/build/agents/session.js +29 -0
  18. package/build/agents/types.js +5 -11
  19. package/build/cli/commands/akuma.js +79 -0
  20. package/build/cli/completion.js +71 -0
  21. package/build/cli/draft-artifact.js +50 -0
  22. package/build/cli/flags.js +96 -0
  23. package/build/cli/help.js +108 -0
  24. package/build/cli/index.js +206 -874
  25. package/build/cli/parse.js +280 -0
  26. package/build/cli/render/arc.js +63 -0
  27. package/build/{responses/tool-errors.js → cli/render/errors.js} +15 -16
  28. package/build/cli/render/format.js +199 -0
  29. package/build/cli/render/misc.js +40 -0
  30. package/build/cli/render/petition.js +32 -0
  31. package/build/{responses → cli/render}/response-style.js +4 -4
  32. package/build/cli/render/shared.js +122 -0
  33. package/build/cli/render/status.js +69 -0
  34. package/build/cli/render/summon.js +17 -0
  35. package/build/cli/render/tell.js +11 -0
  36. package/build/cli/skills-install.js +237 -0
  37. package/build/cli/subagent-guard.js +6 -3
  38. package/build/config/akuma-loader.js +268 -0
  39. package/build/config/env-keys.js +2 -10
  40. package/build/config/{schema.js → env.js} +120 -23
  41. package/build/config/settings.js +137 -260
  42. package/build/core/amend.js +120 -0
  43. package/build/core/arc.js +225 -0
  44. package/build/core/atomic-publish.js +64 -0
  45. package/build/core/bind.js +281 -0
  46. package/build/core/claim.js +360 -0
  47. package/build/core/command-io.js +174 -0
  48. package/build/core/context.js +108 -0
  49. package/build/core/contract.js +14 -0
  50. package/build/core/draft.js +82 -0
  51. package/build/core/entry.js +203 -0
  52. package/build/core/forfeit.js +60 -0
  53. package/build/core/hints.js +108 -0
  54. package/build/core/ids.js +70 -0
  55. package/build/core/ledger.js +117 -0
  56. package/build/core/log.js +24 -0
  57. package/build/{protocol → core}/markdown/parser.js +68 -0
  58. package/build/{protocol → core}/markdown/sections.js +2 -28
  59. package/build/core/markdown/titles.js +9 -0
  60. package/build/{tools/petition/claim-gates.js → core/petition-claim-gates.js} +43 -29
  61. package/build/core/petition-claim.js +116 -0
  62. package/build/core/petition-forfeit.js +39 -0
  63. package/build/{tools/round/head-guard.js → core/petition-head-guard.js} +2 -2
  64. package/build/core/petition-run.js +81 -0
  65. package/build/core/petition.js +96 -0
  66. package/build/core/places.js +82 -0
  67. package/build/core/projection-core.js +541 -0
  68. package/build/core/projection-mint.js +79 -0
  69. package/build/core/projection-status.js +179 -0
  70. package/build/core/projection-wake.js +252 -0
  71. package/build/core/queue.js +73 -0
  72. package/build/core/ref-log.js +94 -0
  73. package/build/core/registry.js +96 -0
  74. package/build/core/render.js +326 -0
  75. package/build/core/renew.js +195 -0
  76. package/build/core/scope.js +163 -0
  77. package/build/core/seal.js +195 -0
  78. package/build/core/status.js +476 -0
  79. package/build/{tools/summon/persist.js → core/summon-persist.js} +10 -9
  80. package/build/core/summon.js +377 -0
  81. package/build/{protocol/response-history.js → core/transcripts.js} +83 -39
  82. package/build/core/verdict.js +96 -0
  83. package/build/core/worktree-path.js +134 -0
  84. package/build/flow-error.js +80 -4
  85. package/build/generated/version.js +1 -1
  86. package/build/git/branches.js +8 -9
  87. package/build/git/core.js +1 -2
  88. package/build/git/diff/pathspec.js +2 -3
  89. package/build/git/diff/preview.js +7 -2
  90. package/build/git/diff/read.js +4 -3
  91. package/build/git/staging.js +1 -1
  92. package/build/index.js +12 -6
  93. package/build/keiyaku.js +17 -13
  94. package/build/telemetry/debug-log.js +1 -1
  95. package/package.json +15 -8
  96. package/skills/keiyaku/SKILL.md +17 -13
  97. package/build/agents/claude-agent-sdk-exec.js +0 -248
  98. package/build/agents/codex-cli-exec.js +0 -235
  99. package/build/agents/codex-sdk-exec.js +0 -216
  100. package/build/agents/gemini-cli-core-exec.js +0 -499
  101. package/build/agents/opencode-exec.js +0 -297
  102. package/build/agents/process-runner.js +0 -239
  103. package/build/agents/round-runner.js +0 -52
  104. package/build/config/apply-argument-descriptions.js +0 -16
  105. package/build/config/architect-hints.js +0 -371
  106. package/build/config/base-rules.js +0 -23
  107. package/build/config/config.js +0 -50
  108. package/build/config/dotenv.js +0 -61
  109. package/build/config/keiyaku-home.js +0 -9
  110. package/build/config/path-utils.js +0 -11
  111. package/build/config/render-template.js +0 -8
  112. package/build/git/diff/filter.js +0 -67
  113. package/build/git/keiyaku-state.js +0 -58
  114. package/build/git/snapshot.js +0 -41
  115. package/build/git/stash.js +0 -62
  116. package/build/protocol/bind-draft.js +0 -195
  117. package/build/protocol/draft-artifacts.js +0 -99
  118. package/build/protocol/file-guards.js +0 -24
  119. package/build/protocol/keiyaku-draft.js +0 -168
  120. package/build/protocol/ledger.js +0 -374
  121. package/build/protocol/markdown/index.js +0 -14
  122. package/build/protocol/markdown/normalization.js +0 -71
  123. package/build/protocol/markdown/render.js +0 -68
  124. package/build/protocol/oath.js +0 -36
  125. package/build/protocol/render-keiyaku.js +0 -37
  126. package/build/protocol/review.js +0 -1
  127. package/build/protocol/status-previews.js +0 -68
  128. package/build/responses/responses.js +0 -530
  129. package/build/tools/amend/index.js +0 -18
  130. package/build/tools/amend/run.js +0 -44
  131. package/build/tools/bind/index.js +0 -44
  132. package/build/tools/bind/run.js +0 -237
  133. package/build/tools/contracts.js +0 -1
  134. package/build/tools/create-handler.js +0 -31
  135. package/build/tools/help.js +0 -9
  136. package/build/tools/petition/claim.js +0 -174
  137. package/build/tools/petition/forfeit.js +0 -100
  138. package/build/tools/petition/index.js +0 -83
  139. package/build/tools/petition/run.js +0 -66
  140. package/build/tools/round/guidance.js +0 -7
  141. package/build/tools/round/prompt.js +0 -70
  142. package/build/tools/round/report.js +0 -153
  143. package/build/tools/round/worktree.js +0 -55
  144. package/build/tools/round-close/index.js +0 -19
  145. package/build/tools/round-close/run.js +0 -98
  146. package/build/tools/round-open/index.js +0 -20
  147. package/build/tools/round-open/run.js +0 -77
  148. package/build/tools/schema.js +0 -68
  149. package/build/tools/status/index.js +0 -16
  150. package/build/tools/status/read.js +0 -152
  151. package/build/tools/summon/index.js +0 -27
  152. package/build/tools/summon/run.js +0 -79
  153. /package/build/{config/toml.js → agents/harness/events.js} +0 -0
  154. /package/build/{git/diff/contracts.js → cli/render/types.js} +0 -0
  155. /package/build/{protocol/bind-input.js → cli/types.js} +0 -0
  156. /package/build/{protocol → core}/markdown/lex.js +0 -0
  157. /package/build/{protocol → core}/markdown/types.js +0 -0
package/README.md CHANGED
@@ -13,20 +13,20 @@ npm install -g @astrosheep/keiyaku
13
13
  Missing any of these? Don't come crying.
14
14
 
15
15
  - **Git repo.** Clean worktree. Dirty = refused.
16
- - **Supported providers.** `codex-cli`, `codex-sdk`, `claude-agent-sdk`, `gemini-cli-core`, `opencode-sdk`. CLI-backed providers need their matching executable (`codex`, `gemini`, `opencode`). `claude-agent-sdk` uses the installed Agent SDK package and can optionally point at a `claude` executable override via `executable`.
16
+ - **Supported providers.** `codex-sdk`, `claude-agent-sdk`, `opencode-sdk`. Runtime executables are `codex`, `claude`, and `opencode`.
17
17
 
18
18
  ---
19
19
 
20
20
  ## Setup
21
21
 
22
- Open a git repo. Run `keiyaku guide` and `keiyaku zako list`. Then use `keiyaku <command> --help` for exact command formats.
22
+ Open a git repo. Run `keiyaku guide` and `keiyaku akuma list`. Then use `keiyaku <command> --help` for exact command formats.
23
23
 
24
24
  ---
25
25
 
26
26
  ## Flow
27
27
 
28
28
  ```
29
- bind → round open → [summon | amend | delivery work] → delivery commits → round close → [round open | amend | petition]
29
+ bind → round open → [summon/ask | amend | delivery work] → delivery commits → round close → [round open | amend | petition]
30
30
  ```
31
31
 
32
32
  ---
@@ -35,6 +35,8 @@ bind → round open → [summon | amend | delivery work] → delivery commits
35
35
 
36
36
  **`summon <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.
37
37
 
38
+ `ask <name> [prompt|-]` is the short alias for the same behavior.
39
+
38
40
  ```
39
41
  Implement the retry tests. Report touched files and verification.
40
42
  ```
@@ -49,11 +51,11 @@ keiyaku resume .keiyaku/response/previous.md "Continue from here"
49
51
 
50
52
  ---
51
53
 
52
- **`zako list` / `zako show <name>`** — Inspect available helpers before choosing `keiyaku summon NAME`.
54
+ **`akuma list` / `akuma show <name>`** — Inspect available helpers before choosing `keiyaku summon NAME`.
53
55
 
54
56
  ```bash
55
- keiyaku zako list
56
- keiyaku zako show codex
57
+ keiyaku akuma list
58
+ keiyaku akuma show akuma-codex
57
59
  ```
58
60
 
59
61
  ---
@@ -142,30 +144,24 @@ Per-agent runtime settings live in `.keiyaku/settings.json` and use `provider` /
142
144
  ```json
143
145
  {
144
146
  "agents": {
145
- "claude": {
147
+ "akuma-claude": {
146
148
  "provider": "claude-agent-sdk",
147
149
  "model": "claude-sonnet-4-5",
148
150
  "executable": "claude",
149
- "description": "Claude-side Zako for review and integration.",
151
+ "description": "Claude-side Akuma for review and integration.",
150
152
  "systemPromptFile": ".keiyaku/claude-system.md"
151
153
  },
152
- "codex": {
154
+ "akuma-codex": {
153
155
  "provider": "codex-sdk",
154
156
  "executable": "codex",
155
- "description": "Default Codex-side Zako.",
157
+ "description": "Default Codex-side Akuma.",
156
158
  "config": {
157
159
  "developer_instructions": "Adapter-level instructions appended to Codex sessions."
158
160
  }
159
161
  },
160
- "gemini": {
161
- "provider": "gemini-cli-core",
162
- "model": "gemini-2.5-pro",
163
- "description": "Gemini-side Zako for preview and synthesis.",
164
- "systemPromptFile": ".keiyaku/gemini-system.md"
165
- }
166
162
  },
167
- "default": "codex",
168
- "reviewer": "codex"
163
+ "default": "akuma-codex",
164
+ "reviewer": "akuma-codex"
169
165
  }
170
166
  ```
171
167
 
@@ -178,16 +174,12 @@ Codex SDK notes:
178
174
  - `config` is passed through to Codex. Use `developer_instructions` for adapter-level instructions.
179
175
  - `model_instructions_file` is also accepted through `config`, but it replaces Codex built-in instructions.
180
176
 
181
- Gemini notes:
182
- - `systemPromptFile` is passed to Gemini CLI core as `GEMINI_SYSTEM_MD`, which replaces Gemini's base system prompt.
183
-
184
- `keiyaku zako list` and `keiyaku zako ls` show each profile's description when present.
177
+ `keiyaku akuma list` and `keiyaku akuma ls` show each profile's description when present.
185
178
 
186
179
  | Variable | Default | |
187
180
  |----------|---------|--|
188
181
  | `KEIYAKU_SUBAGENT_EXEC_TIMEOUT_MS` | — | Execution timeout |
189
182
  | `KEIYAKU_SUBAGENT_EXEC_IDLE_TIMEOUT_MS` | — | Idle timeout |
190
- | `KEIYAKU_FAKE_SUBAGENT` | `0` | `1` = test stub |
191
183
 
192
184
  ---
193
185