@chankov/agent-fleet 0.0.1

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 (419) hide show
  1. package/.claude/commands/build.md +44 -0
  2. package/.claude/commands/code-simplify.md +22 -0
  3. package/.claude/commands/design-agent.md +14 -0
  4. package/.claude/commands/doctor-agent-fleet.md +17 -0
  5. package/.claude/commands/orchestrate.md +112 -0
  6. package/.claude/commands/plan.md +16 -0
  7. package/.claude/commands/prime.md +22 -0
  8. package/.claude/commands/review.md +16 -0
  9. package/.claude/commands/setup-agent-fleet.md +25 -0
  10. package/.claude/commands/ship.md +72 -0
  11. package/.claude/commands/spec.md +15 -0
  12. package/.claude/commands/test.md +19 -0
  13. package/.claude/commands/webperf.md +32 -0
  14. package/.claude/orchestrate-teams.yaml +24 -0
  15. package/.opencode/commands/af-build.md +17 -0
  16. package/.opencode/commands/af-code-simplify.md +16 -0
  17. package/.opencode/commands/af-compound.md +16 -0
  18. package/.opencode/commands/af-design-agent.md +15 -0
  19. package/.opencode/commands/af-doctor-agent-fleet.md +15 -0
  20. package/.opencode/commands/af-orchestrate.md +112 -0
  21. package/.opencode/commands/af-plan.md +16 -0
  22. package/.opencode/commands/af-prime.md +22 -0
  23. package/.opencode/commands/af-review.md +15 -0
  24. package/.opencode/commands/af-setup-agent-fleet.md +15 -0
  25. package/.opencode/commands/af-ship.md +16 -0
  26. package/.opencode/commands/af-spec.md +16 -0
  27. package/.opencode/commands/af-test.md +21 -0
  28. package/.opencode/commands/af-webperf.md +32 -0
  29. package/.opencode/orchestrate-teams.yaml +24 -0
  30. package/.pi/agents/dispatch-policy.yaml +32 -0
  31. package/.pi/agents/model-profiles.yaml +20 -0
  32. package/.pi/agents/peers.yaml +142 -0
  33. package/.pi/agents/teams.yaml +39 -0
  34. package/.pi/damage-control-rules.yaml +297 -0
  35. package/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  36. package/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  37. package/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  38. package/.pi/extensions/btw/README.md +118 -0
  39. package/.pi/extensions/btw/index.ts +917 -0
  40. package/.pi/extensions/btw/package.json +6 -0
  41. package/.pi/extensions/btw/state.js +179 -0
  42. package/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  43. package/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  44. package/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  45. package/.pi/extensions/compact-and-continue/README.md +42 -0
  46. package/.pi/extensions/compact-and-continue/index.ts +120 -0
  47. package/.pi/extensions/compact-and-continue/package.json +6 -0
  48. package/.pi/extensions/mcp-bridge/README.md +46 -0
  49. package/.pi/extensions/mcp-bridge/index.ts +206 -0
  50. package/.pi/extensions/mcp-bridge/package.json +6 -0
  51. package/.pi/extensions/package-lock.json +1143 -0
  52. package/.pi/extensions/package.json +9 -0
  53. package/.pi/extensions/pi-voice-stt/README.md +201 -0
  54. package/.pi/extensions/pi-voice-stt/config.ts +198 -0
  55. package/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  56. package/.pi/extensions/pi-voice-stt/index.ts +248 -0
  57. package/.pi/extensions/pi-voice-stt/package.json +6 -0
  58. package/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  59. package/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  60. package/.pi/harnesses/agent-hub/README.md +562 -0
  61. package/.pi/harnesses/agent-hub/artifacts.js +92 -0
  62. package/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  63. package/.pi/harnesses/agent-hub/delegate.ts +363 -0
  64. package/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  65. package/.pi/harnesses/agent-hub/helpers.ts +165 -0
  66. package/.pi/harnesses/agent-hub/index.ts +7098 -0
  67. package/.pi/harnesses/agent-hub/package.json +6 -0
  68. package/.pi/harnesses/agent-hub/return-contract.js +215 -0
  69. package/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  70. package/.pi/harnesses/agent-hub/spawn.ts +179 -0
  71. package/.pi/harnesses/ask-user-remote/README.md +10 -0
  72. package/.pi/harnesses/ask-user-remote/index.ts +253 -0
  73. package/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  74. package/.pi/harnesses/coms/README.md +71 -0
  75. package/.pi/harnesses/coms/index.ts +1743 -0
  76. package/.pi/harnesses/coms/package.json +6 -0
  77. package/.pi/harnesses/damage-control/README.md +65 -0
  78. package/.pi/harnesses/damage-control/index.ts +250 -0
  79. package/.pi/harnesses/damage-control/package.json +6 -0
  80. package/.pi/harnesses/damage-control/shared.ts +183 -0
  81. package/.pi/harnesses/damage-control-continue/README.md +116 -0
  82. package/.pi/harnesses/damage-control-continue/index.ts +522 -0
  83. package/.pi/harnesses/damage-control-continue/package.json +6 -0
  84. package/.pi/harnesses/lib/herdr-client.ts +458 -0
  85. package/.pi/harnesses/lib/herdr-presence.ts +288 -0
  86. package/.pi/harnesses/package-lock.json +35 -0
  87. package/.pi/harnesses/package.json +9 -0
  88. package/.pi/prompts/build.md +24 -0
  89. package/.pi/prompts/code-simplify.md +22 -0
  90. package/.pi/prompts/doctor-agent-fleet.md +15 -0
  91. package/.pi/prompts/plan.md +16 -0
  92. package/.pi/prompts/review.md +16 -0
  93. package/.pi/prompts/setup-agent-fleet.md +27 -0
  94. package/.pi/prompts/ship.md +17 -0
  95. package/.pi/prompts/spec.md +15 -0
  96. package/.pi/prompts/test.md +19 -0
  97. package/.pi/skills/bowser/SKILL.md +145 -0
  98. package/.versions/0.0.1/.claude/commands/build.md +44 -0
  99. package/.versions/0.0.1/.claude/commands/code-simplify.md +22 -0
  100. package/.versions/0.0.1/.claude/commands/design-agent.md +14 -0
  101. package/.versions/0.0.1/.claude/commands/doctor-agent-fleet.md +17 -0
  102. package/.versions/0.0.1/.claude/commands/orchestrate.md +112 -0
  103. package/.versions/0.0.1/.claude/commands/plan.md +16 -0
  104. package/.versions/0.0.1/.claude/commands/prime.md +22 -0
  105. package/.versions/0.0.1/.claude/commands/review.md +16 -0
  106. package/.versions/0.0.1/.claude/commands/setup-agent-fleet.md +25 -0
  107. package/.versions/0.0.1/.claude/commands/ship.md +72 -0
  108. package/.versions/0.0.1/.claude/commands/spec.md +15 -0
  109. package/.versions/0.0.1/.claude/commands/test.md +19 -0
  110. package/.versions/0.0.1/.claude/commands/webperf.md +32 -0
  111. package/.versions/0.0.1/.claude/orchestrate-teams.yaml +24 -0
  112. package/.versions/0.0.1/.opencode/commands/af-build.md +17 -0
  113. package/.versions/0.0.1/.opencode/commands/af-code-simplify.md +16 -0
  114. package/.versions/0.0.1/.opencode/commands/af-compound.md +16 -0
  115. package/.versions/0.0.1/.opencode/commands/af-design-agent.md +15 -0
  116. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +15 -0
  117. package/.versions/0.0.1/.opencode/commands/af-orchestrate.md +112 -0
  118. package/.versions/0.0.1/.opencode/commands/af-plan.md +16 -0
  119. package/.versions/0.0.1/.opencode/commands/af-prime.md +22 -0
  120. package/.versions/0.0.1/.opencode/commands/af-review.md +15 -0
  121. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +15 -0
  122. package/.versions/0.0.1/.opencode/commands/af-ship.md +16 -0
  123. package/.versions/0.0.1/.opencode/commands/af-spec.md +16 -0
  124. package/.versions/0.0.1/.opencode/commands/af-test.md +21 -0
  125. package/.versions/0.0.1/.opencode/commands/af-webperf.md +32 -0
  126. package/.versions/0.0.1/.opencode/orchestrate-teams.yaml +24 -0
  127. package/.versions/0.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  128. package/.versions/0.0.1/.pi/agents/model-profiles.yaml +20 -0
  129. package/.versions/0.0.1/.pi/agents/peers.yaml +142 -0
  130. package/.versions/0.0.1/.pi/agents/teams.yaml +39 -0
  131. package/.versions/0.0.1/.pi/damage-control-rules.yaml +297 -0
  132. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  133. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  134. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  135. package/.versions/0.0.1/.pi/extensions/btw/README.md +118 -0
  136. package/.versions/0.0.1/.pi/extensions/btw/index.ts +917 -0
  137. package/.versions/0.0.1/.pi/extensions/btw/package.json +6 -0
  138. package/.versions/0.0.1/.pi/extensions/btw/state.js +179 -0
  139. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  140. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  141. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  142. package/.versions/0.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  143. package/.versions/0.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  144. package/.versions/0.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  145. package/.versions/0.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  146. package/.versions/0.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  147. package/.versions/0.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  148. package/.versions/0.0.1/.pi/extensions/package-lock.json +1143 -0
  149. package/.versions/0.0.1/.pi/extensions/package.json +9 -0
  150. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/README.md +201 -0
  151. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  152. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  153. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  154. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  155. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  156. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  157. package/.versions/0.0.1/.pi/harnesses/agent-hub/README.md +562 -0
  158. package/.versions/0.0.1/.pi/harnesses/agent-hub/artifacts.js +92 -0
  159. package/.versions/0.0.1/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  160. package/.versions/0.0.1/.pi/harnesses/agent-hub/delegate.ts +363 -0
  161. package/.versions/0.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  162. package/.versions/0.0.1/.pi/harnesses/agent-hub/helpers.ts +165 -0
  163. package/.versions/0.0.1/.pi/harnesses/agent-hub/index.ts +7098 -0
  164. package/.versions/0.0.1/.pi/harnesses/agent-hub/package.json +6 -0
  165. package/.versions/0.0.1/.pi/harnesses/agent-hub/return-contract.js +215 -0
  166. package/.versions/0.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  167. package/.versions/0.0.1/.pi/harnesses/agent-hub/spawn.ts +179 -0
  168. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/README.md +10 -0
  169. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/index.ts +253 -0
  170. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  171. package/.versions/0.0.1/.pi/harnesses/coms/README.md +71 -0
  172. package/.versions/0.0.1/.pi/harnesses/coms/index.ts +1743 -0
  173. package/.versions/0.0.1/.pi/harnesses/coms/package.json +6 -0
  174. package/.versions/0.0.1/.pi/harnesses/damage-control/README.md +65 -0
  175. package/.versions/0.0.1/.pi/harnesses/damage-control/index.ts +250 -0
  176. package/.versions/0.0.1/.pi/harnesses/damage-control/package.json +6 -0
  177. package/.versions/0.0.1/.pi/harnesses/damage-control/shared.ts +183 -0
  178. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/README.md +116 -0
  179. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/index.ts +522 -0
  180. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/package.json +6 -0
  181. package/.versions/0.0.1/.pi/harnesses/lib/herdr-client.ts +458 -0
  182. package/.versions/0.0.1/.pi/harnesses/lib/herdr-presence.ts +288 -0
  183. package/.versions/0.0.1/.pi/harnesses/package-lock.json +35 -0
  184. package/.versions/0.0.1/.pi/harnesses/package.json +9 -0
  185. package/.versions/0.0.1/.pi/prompts/build.md +24 -0
  186. package/.versions/0.0.1/.pi/prompts/code-simplify.md +22 -0
  187. package/.versions/0.0.1/.pi/prompts/doctor-agent-fleet.md +15 -0
  188. package/.versions/0.0.1/.pi/prompts/plan.md +16 -0
  189. package/.versions/0.0.1/.pi/prompts/review.md +16 -0
  190. package/.versions/0.0.1/.pi/prompts/setup-agent-fleet.md +27 -0
  191. package/.versions/0.0.1/.pi/prompts/ship.md +17 -0
  192. package/.versions/0.0.1/.pi/prompts/spec.md +15 -0
  193. package/.versions/0.0.1/.pi/prompts/test.md +19 -0
  194. package/.versions/0.0.1/.pi/skills/bowser/SKILL.md +145 -0
  195. package/.versions/0.0.1/.version +1 -0
  196. package/.versions/0.0.1/agents/architect.md +21 -0
  197. package/.versions/0.0.1/agents/bowser.md +25 -0
  198. package/.versions/0.0.1/agents/builder.md +52 -0
  199. package/.versions/0.0.1/agents/code-reviewer.md +205 -0
  200. package/.versions/0.0.1/agents/deep-researcher.md +31 -0
  201. package/.versions/0.0.1/agents/documenter.md +16 -0
  202. package/.versions/0.0.1/agents/orchestrator.md +43 -0
  203. package/.versions/0.0.1/agents/plan-reviewer.md +60 -0
  204. package/.versions/0.0.1/agents/planner.md +69 -0
  205. package/.versions/0.0.1/agents/releaser.md +22 -0
  206. package/.versions/0.0.1/agents/researcher.md +28 -0
  207. package/.versions/0.0.1/agents/security-auditor.md +166 -0
  208. package/.versions/0.0.1/agents/test-engineer.md +144 -0
  209. package/.versions/0.0.1/agents/web-debugger.md +42 -0
  210. package/.versions/0.0.1/agents/web-performance-auditor.md +192 -0
  211. package/.versions/0.0.1/hooks/SIMPLIFY-IGNORE.md +90 -0
  212. package/.versions/0.0.1/hooks/coms-stop-hook.mjs +73 -0
  213. package/.versions/0.0.1/hooks/hooks.json +14 -0
  214. package/.versions/0.0.1/hooks/session-start.sh +74 -0
  215. package/.versions/0.0.1/hooks/simplify-ignore.sh +302 -0
  216. package/.versions/0.0.1/justfile +143 -0
  217. package/.versions/0.0.1/references/accessibility-checklist.md +160 -0
  218. package/.versions/0.0.1/references/definition-of-done.md +67 -0
  219. package/.versions/0.0.1/references/fleet-coordination-patterns.md +151 -0
  220. package/.versions/0.0.1/references/observability-checklist.md +91 -0
  221. package/.versions/0.0.1/references/orchestration-patterns.md +370 -0
  222. package/.versions/0.0.1/references/performance-checklist.md +153 -0
  223. package/.versions/0.0.1/references/prompting-patterns.md +380 -0
  224. package/.versions/0.0.1/references/security-checklist.md +179 -0
  225. package/.versions/0.0.1/references/testing-patterns.md +236 -0
  226. package/.versions/0.0.1/scripts/coms-claude-bridge.ts +286 -0
  227. package/.versions/0.0.1/scripts/coms-cli.ts +372 -0
  228. package/.versions/0.0.1/scripts/coms-hermes-bridge.ts +399 -0
  229. package/.versions/0.0.1/scripts/lib/claude-bridge-core.ts +100 -0
  230. package/.versions/0.0.1/scripts/lib/coms-envelope.ts +494 -0
  231. package/.versions/0.0.1/scripts/lib/herdr-layout.ts +235 -0
  232. package/.versions/0.0.1/scripts/lib/hermes-bridge-core.ts +238 -0
  233. package/.versions/0.0.1/scripts/lib/persona-banner.ts +62 -0
  234. package/.versions/0.0.1/scripts/lib/team-project.ts +75 -0
  235. package/.versions/0.0.1/scripts/lib/team-snapshot.ts +146 -0
  236. package/.versions/0.0.1/scripts/peer-banner.ts +40 -0
  237. package/.versions/0.0.1/scripts/team-snapshot.ts +221 -0
  238. package/.versions/0.0.1/scripts/team-up.ts +245 -0
  239. package/.versions/0.0.1/skills/_internal/grilling.md +11 -0
  240. package/.versions/0.0.1/skills/browser-testing-with-devtools/SKILL.md +352 -0
  241. package/.versions/0.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  242. package/.versions/0.0.1/skills/compound-learning/SKILL.md +137 -0
  243. package/.versions/0.0.1/skills/context-engineering/SKILL.md +291 -0
  244. package/.versions/0.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  245. package/.versions/0.0.1/skills/designing-agents/SKILL.md +394 -0
  246. package/.versions/0.0.1/skills/designing-agents/pi-harness-authoring.md +209 -0
  247. package/.versions/0.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  248. package/.versions/0.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  249. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +506 -0
  250. package/.versions/0.0.1/skills/idea-refine/SKILL.md +182 -0
  251. package/.versions/0.0.1/skills/idea-refine/examples.md +238 -0
  252. package/.versions/0.0.1/skills/idea-refine/frameworks.md +99 -0
  253. package/.versions/0.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  254. package/.versions/0.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  255. package/.versions/0.0.1/skills/incremental-implementation/SKILL.md +287 -0
  256. package/.versions/0.0.1/skills/interview-me/SKILL.md +226 -0
  257. package/.versions/0.0.1/skills/orchestration-verification/SKILL.md +181 -0
  258. package/.versions/0.0.1/skills/peer-coms/SKILL.md +81 -0
  259. package/.versions/0.0.1/skills/performance-optimization/SKILL.md +350 -0
  260. package/.versions/0.0.1/skills/planning-and-task-breakdown/SKILL.md +236 -0
  261. package/.versions/0.0.1/skills/security-and-hardening/SKILL.md +461 -0
  262. package/.versions/0.0.1/skills/spec-driven-development/SKILL.md +245 -0
  263. package/.versions/0.0.1/skills/using-agent-skills/SKILL.md +199 -0
  264. package/.versions/0.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  265. package/.versions/0.0.1/vendor/agent-skills-upstream/README.md +11 -0
  266. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  267. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  268. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  269. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  270. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  271. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  272. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  273. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  274. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  275. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  276. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  277. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  278. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  279. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  280. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  281. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  282. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  283. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  284. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  285. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  286. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  287. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  288. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  289. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  290. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  291. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  292. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  293. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  294. package/CHANGELOG.md +65 -0
  295. package/LICENSE +21 -0
  296. package/README.md +458 -0
  297. package/agents/architect.md +21 -0
  298. package/agents/bowser.md +25 -0
  299. package/agents/builder.md +52 -0
  300. package/agents/code-reviewer.md +205 -0
  301. package/agents/deep-researcher.md +31 -0
  302. package/agents/documenter.md +16 -0
  303. package/agents/orchestrator.md +43 -0
  304. package/agents/plan-reviewer.md +60 -0
  305. package/agents/planner.md +69 -0
  306. package/agents/releaser.md +22 -0
  307. package/agents/researcher.md +28 -0
  308. package/agents/security-auditor.md +166 -0
  309. package/agents/test-engineer.md +144 -0
  310. package/agents/web-debugger.md +42 -0
  311. package/agents/web-performance-auditor.md +192 -0
  312. package/bin/cli.js +633 -0
  313. package/bin/force-patch-changesets.js +44 -0
  314. package/bin/lib/bootstrap.js +323 -0
  315. package/bin/lib/detect-agent.js +49 -0
  316. package/bin/lib/doctor.js +302 -0
  317. package/bin/lib/transform-persona.js +180 -0
  318. package/bin/lib/update-notifier.js +195 -0
  319. package/bin/lib/validate-overrides.js +229 -0
  320. package/bin/snapshot-version.js +91 -0
  321. package/docs/agent-fleet-setup.md +355 -0
  322. package/docs/claude-code-coms-bridge.md +93 -0
  323. package/docs/getting-started.md +169 -0
  324. package/docs/npm-install.md +335 -0
  325. package/docs/opencode-setup.md +248 -0
  326. package/docs/pi-extensions.md +237 -0
  327. package/docs/pi-setup.md +455 -0
  328. package/docs/skill-anatomy.md +150 -0
  329. package/hooks/SIMPLIFY-IGNORE.md +90 -0
  330. package/hooks/coms-stop-hook.mjs +73 -0
  331. package/hooks/hooks.json +14 -0
  332. package/hooks/session-start.sh +74 -0
  333. package/hooks/simplify-ignore.sh +302 -0
  334. package/justfile +143 -0
  335. package/node_modules/pi-ask-user/LICENSE +21 -0
  336. package/node_modules/pi-ask-user/README.md +156 -0
  337. package/node_modules/pi-ask-user/index.ts +1795 -0
  338. package/node_modules/pi-ask-user/package.json +51 -0
  339. package/node_modules/pi-ask-user/single-select-layout.ts +203 -0
  340. package/node_modules/pi-ask-user/skills/ask-user/SKILL.md +162 -0
  341. package/node_modules/pi-ask-user/skills/ask-user/references/ask-user-skill-extension-spec.md +96 -0
  342. package/package.json +121 -0
  343. package/references/accessibility-checklist.md +160 -0
  344. package/references/definition-of-done.md +67 -0
  345. package/references/fleet-coordination-patterns.md +151 -0
  346. package/references/observability-checklist.md +91 -0
  347. package/references/orchestration-patterns.md +370 -0
  348. package/references/performance-checklist.md +153 -0
  349. package/references/prompting-patterns.md +380 -0
  350. package/references/security-checklist.md +179 -0
  351. package/references/testing-patterns.md +236 -0
  352. package/scripts/coms-claude-bridge.ts +286 -0
  353. package/scripts/coms-cli.ts +372 -0
  354. package/scripts/coms-hermes-bridge.ts +399 -0
  355. package/scripts/lib/claude-bridge-core.ts +100 -0
  356. package/scripts/lib/coms-envelope.ts +494 -0
  357. package/scripts/lib/herdr-layout.ts +235 -0
  358. package/scripts/lib/hermes-bridge-core.ts +238 -0
  359. package/scripts/lib/persona-banner.ts +62 -0
  360. package/scripts/lib/team-project.ts +75 -0
  361. package/scripts/lib/team-snapshot.ts +146 -0
  362. package/scripts/peer-banner.ts +40 -0
  363. package/scripts/team-snapshot.ts +221 -0
  364. package/scripts/team-up.ts +245 -0
  365. package/skills/_internal/grilling.md +11 -0
  366. package/skills/browser-testing-with-devtools/SKILL.md +352 -0
  367. package/skills/code-review-and-quality/SKILL.md +381 -0
  368. package/skills/compound-learning/SKILL.md +137 -0
  369. package/skills/context-engineering/SKILL.md +291 -0
  370. package/skills/deprecation-and-migration/SKILL.md +206 -0
  371. package/skills/designing-agents/SKILL.md +394 -0
  372. package/skills/designing-agents/pi-harness-authoring.md +209 -0
  373. package/skills/frontend-ui-engineering/SKILL.md +328 -0
  374. package/skills/git-workflow-and-versioning/SKILL.md +316 -0
  375. package/skills/guided-workspace-setup/SKILL.md +506 -0
  376. package/skills/idea-refine/SKILL.md +182 -0
  377. package/skills/idea-refine/examples.md +238 -0
  378. package/skills/idea-refine/frameworks.md +99 -0
  379. package/skills/idea-refine/refinement-criteria.md +113 -0
  380. package/skills/idea-refine/scripts/idea-refine.sh +15 -0
  381. package/skills/incremental-implementation/SKILL.md +287 -0
  382. package/skills/interview-me/SKILL.md +226 -0
  383. package/skills/orchestration-verification/SKILL.md +181 -0
  384. package/skills/peer-coms/SKILL.md +81 -0
  385. package/skills/performance-optimization/SKILL.md +350 -0
  386. package/skills/planning-and-task-breakdown/SKILL.md +236 -0
  387. package/skills/security-and-hardening/SKILL.md +461 -0
  388. package/skills/spec-driven-development/SKILL.md +245 -0
  389. package/skills/using-agent-skills/SKILL.md +199 -0
  390. package/vendor/agent-skills-upstream/LICENSE +21 -0
  391. package/vendor/agent-skills-upstream/README.md +11 -0
  392. package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  393. package/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  394. package/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  395. package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  396. package/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  397. package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  398. package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  399. package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  400. package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  401. package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  402. package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  403. package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  404. package/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  405. package/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  406. package/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  407. package/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  408. package/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  409. package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  410. package/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  411. package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  412. package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  413. package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  414. package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  415. package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  416. package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  417. package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  418. package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  419. package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
@@ -0,0 +1,372 @@
1
+ // scripts/coms-cli.ts
2
+ //
3
+ // Envelope-protocol CLI: lets a NON-pi process (a plain shell, Claude Code
4
+ // via the peer-coms skill) participate in the coms pool. Speaks the exact
5
+ // coms wire protocol (scripts/lib/coms-envelope.ts) over the existing
6
+ // registry + unix sockets.
7
+ //
8
+ // list — live peers in scope (name, model, purpose)
9
+ // send <peer> <prompt> — send a prompt; prints the msg_id and returns
10
+ // (a detached waiter holds the reply socket);
11
+ // --await blocks and prints the reply instead
12
+ // await <msg_id> — block until the reply for msg_id arrives
13
+ // reply <msg_id> <text> — answer an inbound prompt (bridge/hook use)
14
+ //
15
+ // Identity: each invocation acts as peer `--name` (default "claude-cli"),
16
+ // registered EXPLICIT — visible to nobody's pool widget, addressable only by
17
+ // exact name — and read-only toward the registry except its own entry.
18
+ //
19
+ // usage: coms-cli <list|send|await|reply> [args] [--project <p>] [--name <me>]
20
+ // [--await] [--timeout <ms>] [--all]
21
+
22
+ import { spawn } from "node:child_process";
23
+ import * as fs from "node:fs";
24
+ import * as path from "node:path";
25
+ import { fileURLToPath } from "node:url";
26
+
27
+ import {
28
+ bindEndpoint,
29
+ COMS_DIR,
30
+ ensureComsDirs,
31
+ isPromptEnvelope,
32
+ isResponseEnvelope,
33
+ makeConnHandler,
34
+ makeEndpoint,
35
+ makePromptEnvelope,
36
+ makeResponseEnvelope,
37
+ nowIso,
38
+ pruneDeadEntries,
39
+ removeRegistryEntry,
40
+ sendEnvelope,
41
+ ulid,
42
+ writeAck,
43
+ writeNack,
44
+ writeRegistryAtomic,
45
+ type RegistryEntry,
46
+ type SenderIdentity,
47
+ } from "./lib/coms-envelope.ts";
48
+
49
+ const DEFAULT_NAME = process.env.COMS_CLI_NAME || "claude-cli";
50
+ const DEFAULT_AWAIT_MS = 300_000;
51
+
52
+ function flagValue(argv: string[], flag: string): string | null {
53
+ const i = argv.indexOf(flag);
54
+ return i >= 0 && i + 1 < argv.length ? argv[i + 1] : null;
55
+ }
56
+
57
+ function die(msg: string): never {
58
+ console.error(msg);
59
+ process.exit(1);
60
+ }
61
+
62
+ function spoolDir(name: string): string {
63
+ return path.join(COMS_DIR, "cli", name);
64
+ }
65
+
66
+ function ensureSpool(name: string): { pending: string; responses: string; inbound: string } {
67
+ const base = spoolDir(name);
68
+ const dirs = {
69
+ pending: path.join(base, "pending"),
70
+ responses: path.join(base, "responses"),
71
+ inbound: path.join(base, "inbound"),
72
+ };
73
+ for (const d of Object.values(dirs)) fs.mkdirSync(d, { recursive: true });
74
+ return dirs;
75
+ }
76
+
77
+ interface Scope {
78
+ project: string;
79
+ includeExplicit: boolean;
80
+ }
81
+
82
+ function scopeFrom(argv: string[]): Scope {
83
+ return { project: flagValue(argv, "--project") ?? "default", includeExplicit: argv.includes("--all") };
84
+ }
85
+
86
+ function peersInScope(scope: Scope, selfName: string): RegistryEntry[] {
87
+ return pruneDeadEntries(scope.project).filter(
88
+ (e) => e.name !== selfName && (scope.includeExplicit || !e.explicit),
89
+ );
90
+ }
91
+
92
+ function makeIdentity(name: string, sessionId: string): SenderIdentity {
93
+ return { session_id: sessionId, name, endpoint: makeEndpoint(sessionId), cwd: process.cwd() };
94
+ }
95
+
96
+ function registerCliEntry(id: SenderIdentity, project: string, purpose: string): void {
97
+ const entry: RegistryEntry = {
98
+ session_id: id.session_id,
99
+ name: id.name,
100
+ purpose,
101
+ model: "cli",
102
+ color: "#FEDE5D",
103
+ pid: process.pid,
104
+ endpoint: id.endpoint,
105
+ cwd: id.cwd,
106
+ started_at: nowIso(),
107
+ explicit: true,
108
+ version: 1,
109
+ };
110
+ writeRegistryAtomic(entry, project);
111
+ }
112
+
113
+ // ━━ list ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
114
+
115
+ function cmdList(argv: string[]): void {
116
+ const scope = scopeFrom(argv);
117
+ const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
118
+ const peers = peersInScope(scope, name);
119
+ if (peers.length === 0) {
120
+ console.log(`(no live peers in project "${scope.project}")`);
121
+ return;
122
+ }
123
+ for (const p of peers) {
124
+ console.log(`${p.name}\t${p.model}\t${p.purpose}`);
125
+ }
126
+ }
127
+
128
+ // ━━ send ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
129
+
130
+ async function cmdSend(argv: string[]): Promise<void> {
131
+ const positional = argv.filter((a, i) => !a.startsWith("--") && (i === 0 || !argv[i - 1].startsWith("--")));
132
+ const [target, ...promptParts] = positional;
133
+ const prompt = promptParts.join(" ");
134
+ if (!target || !prompt) die("usage: coms-cli send <peer> <prompt…> [--await] [--timeout <ms>]");
135
+
136
+ const scope = scopeFrom(argv);
137
+ const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
138
+ const timeoutMs = Number(flagValue(argv, "--timeout") ?? DEFAULT_AWAIT_MS);
139
+ const doAwait = argv.includes("--await");
140
+
141
+ const peer = peersInScope(scope, name).find((e) => e.name === target)
142
+ ?? pruneDeadEntries(scope.project).find((e) => e.name === target && e.name !== name);
143
+ if (!peer) {
144
+ const names = peersInScope(scope, name).map((e) => e.name).join(", ") || "(none)";
145
+ die(`Peer "${target}" not found in project "${scope.project}". Live peers: ${names}`);
146
+ }
147
+
148
+ ensureComsDirs(scope.project);
149
+ const spool = ensureSpool(name);
150
+
151
+ if (doAwait) {
152
+ // One process does the whole round trip: bind → register → send → wait.
153
+ const id = makeIdentity(name, ulid());
154
+ let done: (v: { response: unknown; error?: string | null }) => void;
155
+ const reply = new Promise<{ response: unknown; error?: string | null }>((res) => (done = res));
156
+ const server = await bindEndpoint(
157
+ id.endpoint,
158
+ makeConnHandler((env, socket) => {
159
+ if (isResponseEnvelope(env)) {
160
+ writeAck(socket, env.msg_id);
161
+ done({ response: env.response, error: env.error ?? null });
162
+ } else if ((env as { type?: string }).type === "ping") {
163
+ writeAck(socket, (env as { msg_id?: string }).msg_id ?? "");
164
+ } else {
165
+ writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "cli awaits responses only");
166
+ }
167
+ }),
168
+ );
169
+ registerCliEntry(id, scope.project, `coms-cli (one-shot ask from ${name})`);
170
+ const cleanup = () => {
171
+ try { server.close(); } catch { /* ignore */ }
172
+ try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
173
+ removeRegistryEntry(scope.project, id.name);
174
+ };
175
+ try {
176
+ const env = makePromptEnvelope(id, prompt);
177
+ await sendEnvelope(peer.endpoint, env);
178
+ console.error(`sent ${env.msg_id} → ${peer.name} (awaiting reply, timeout ${timeoutMs}ms)`);
179
+ const result = await Promise.race([
180
+ reply,
181
+ new Promise<never>((_r, rej) => setTimeout(() => rej(new Error(`timeout after ${timeoutMs}ms`)), timeoutMs)),
182
+ ]);
183
+ if (result.error) die(`peer error: ${result.error}`);
184
+ console.log(typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2));
185
+ } finally {
186
+ cleanup();
187
+ }
188
+ return;
189
+ }
190
+
191
+ // Detached mode: a waiter child owns the reply socket + registry entry;
192
+ // this process sends, prints the msg_id, and exits.
193
+ const sessionId = ulid();
194
+ const endpoint = makeEndpoint(sessionId);
195
+ const child = spawn(
196
+ process.execPath,
197
+ [
198
+ fileURLToPath(import.meta.url),
199
+ "_listen",
200
+ "--name", name,
201
+ "--project", scope.project,
202
+ "--session", sessionId,
203
+ "--ttl", String(timeoutMs),
204
+ ],
205
+ { detached: true, stdio: ["ignore", "pipe", "ignore"] },
206
+ );
207
+ await new Promise<void>((resolve, reject) => {
208
+ const t = setTimeout(() => reject(new Error("waiter did not become ready")), 5000);
209
+ child.stdout!.on("data", (d) => {
210
+ if (d.toString().includes("READY")) {
211
+ clearTimeout(t);
212
+ resolve();
213
+ }
214
+ });
215
+ child.on("exit", () => reject(new Error("waiter exited early")));
216
+ });
217
+ child.unref();
218
+ child.stdout!.destroy();
219
+
220
+ const id: SenderIdentity = { session_id: sessionId, name, endpoint, cwd: process.cwd() };
221
+ const env = makePromptEnvelope(id, prompt);
222
+ fs.writeFileSync(
223
+ path.join(spool.pending, `${env.msg_id}.json`),
224
+ JSON.stringify({ msg_id: env.msg_id, target: peer.name, sent_at: nowIso() }),
225
+ );
226
+ try {
227
+ await sendEnvelope(peer.endpoint, env);
228
+ } catch (err) {
229
+ try { fs.unlinkSync(path.join(spool.pending, `${env.msg_id}.json`)); } catch { /* ignore */ }
230
+ try { if (child.pid) process.kill(-child.pid, "SIGTERM"); } catch { /* ignore */ }
231
+ die(`send failed: ${err instanceof Error ? err.message : String(err)}`);
232
+ }
233
+ console.log(env.msg_id);
234
+ }
235
+
236
+ // ━━ _listen (internal detached waiter) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
237
+
238
+ async function cmdListen(argv: string[]): Promise<void> {
239
+ const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
240
+ const project = flagValue(argv, "--project") ?? "default";
241
+ const sessionId = flagValue(argv, "--session") ?? ulid();
242
+ const ttl = Number(flagValue(argv, "--ttl") ?? DEFAULT_AWAIT_MS);
243
+ const id = makeIdentity(name, sessionId);
244
+ const spool = ensureSpool(name);
245
+ ensureComsDirs(project);
246
+
247
+ const server = await bindEndpoint(
248
+ id.endpoint,
249
+ makeConnHandler((env, socket) => {
250
+ if (isResponseEnvelope(env)) {
251
+ writeAck(socket, env.msg_id);
252
+ fs.writeFileSync(
253
+ path.join(spool.responses, `${env.msg_id}.json`),
254
+ JSON.stringify({ response: env.response, error: env.error ?? null, received_at: nowIso() }),
255
+ );
256
+ try { fs.unlinkSync(path.join(spool.pending, `${env.msg_id}.json`)); } catch { /* ignore */ }
257
+ maybeExit();
258
+ } else if (isPromptEnvelope(env)) {
259
+ // Bidirectionality bonus: inbound prompts spool for a human /
260
+ // hook to answer via `coms-cli reply <msg_id> …`.
261
+ writeAck(socket, env.msg_id);
262
+ fs.writeFileSync(
263
+ path.join(spool.inbound, `${env.msg_id}.json`),
264
+ JSON.stringify({
265
+ msg_id: env.msg_id,
266
+ prompt: env.prompt,
267
+ sender_name: env.sender_name,
268
+ sender_endpoint: env.sender_endpoint,
269
+ sender_session: env.sender_session,
270
+ hops: env.hops,
271
+ received_at: nowIso(),
272
+ }),
273
+ );
274
+ } else if ((env as { type?: string }).type === "ping") {
275
+ writeAck(socket, (env as { msg_id?: string }).msg_id ?? "");
276
+ } else {
277
+ writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "unsupported envelope");
278
+ }
279
+ }),
280
+ );
281
+ registerCliEntry(id, project, "coms-cli reply waiter");
282
+ console.log("READY");
283
+
284
+ const cleanup = () => {
285
+ try { server.close(); } catch { /* ignore */ }
286
+ try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
287
+ removeRegistryEntry(project, id.name);
288
+ process.exit(0);
289
+ };
290
+ // Exit when no pending markers remain (grace period lets the sender write
291
+ // the first marker after READY).
292
+ const startedAt = Date.now();
293
+ function maybeExit(): void {
294
+ try {
295
+ const pendingLeft = fs.readdirSync(spool.pending).length;
296
+ if (pendingLeft === 0 && Date.now() - startedAt > 3000) cleanup();
297
+ } catch {
298
+ // ignore
299
+ }
300
+ }
301
+ setInterval(maybeExit, 5000);
302
+ setTimeout(cleanup, ttl); // TTL fallback
303
+ process.on("SIGTERM", cleanup);
304
+ process.on("SIGINT", cleanup);
305
+ }
306
+
307
+ // ━━ await ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
308
+
309
+ async function cmdAwait(argv: string[]): Promise<void> {
310
+ const msgId = argv.find((a) => !a.startsWith("--"));
311
+ if (!msgId) die("usage: coms-cli await <msg_id> [--timeout <ms>]");
312
+ const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
313
+ const timeoutMs = Number(flagValue(argv, "--timeout") ?? DEFAULT_AWAIT_MS);
314
+ const spool = ensureSpool(name);
315
+ const file = path.join(spool.responses, `${msgId}.json`);
316
+ const deadline = Date.now() + timeoutMs;
317
+ while (Date.now() < deadline) {
318
+ if (fs.existsSync(file)) {
319
+ const rec = JSON.parse(fs.readFileSync(file, "utf-8"));
320
+ if (rec.error) die(`peer error: ${rec.error}`);
321
+ console.log(typeof rec.response === "string" ? rec.response : JSON.stringify(rec.response, null, 2));
322
+ return;
323
+ }
324
+ await new Promise((r) => setTimeout(r, 500));
325
+ }
326
+ die(`timeout: no reply for ${msgId} after ${timeoutMs}ms`);
327
+ }
328
+
329
+ // ━━ reply ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
330
+
331
+ async function cmdReply(argv: string[]): Promise<void> {
332
+ const positional = argv.filter((a, i) => !a.startsWith("--") && (i === 0 || !argv[i - 1].startsWith("--")));
333
+ const [msgId, ...textParts] = positional;
334
+ let text = textParts.join(" ");
335
+ if (!text && !process.stdin.isTTY) {
336
+ text = fs.readFileSync(0, "utf-8").trim();
337
+ }
338
+ if (!msgId || !text) die("usage: coms-cli reply <msg_id> <text…> (or pipe the text on stdin)");
339
+ const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
340
+ const spool = ensureSpool(name);
341
+ const recFile = path.join(spool.inbound, `${msgId}.json`);
342
+ if (!fs.existsSync(recFile)) die(`No inbound prompt ${msgId} in ${spool.inbound}`);
343
+ const rec = JSON.parse(fs.readFileSync(recFile, "utf-8"));
344
+ const id = makeIdentity(name, ulid());
345
+ await sendEnvelope(rec.sender_endpoint, makeResponseEnvelope(id, msgId, text));
346
+ fs.unlinkSync(recFile);
347
+ console.log(`replied to ${rec.sender_name ?? rec.sender_session} (${msgId})`);
348
+ }
349
+
350
+ // ━━ main ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
351
+
352
+ async function main(): Promise<void> {
353
+ const [cmd, ...rest] = process.argv.slice(2);
354
+ switch (cmd) {
355
+ case "list":
356
+ return cmdList(rest);
357
+ case "send":
358
+ return cmdSend(rest);
359
+ case "await":
360
+ return cmdAwait(rest);
361
+ case "reply":
362
+ return cmdReply(rest);
363
+ case "_listen":
364
+ return cmdListen(rest);
365
+ default:
366
+ console.error("usage: coms-cli <list|send|await|reply> …");
367
+ process.exit(2);
368
+ }
369
+ }
370
+
371
+ const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
372
+ if (isEntry) void main();