@chankov/agent-fleet 0.0.4 → 0.0.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.
Files changed (614) hide show
  1. package/.claude/commands/set-hermes-telegram.md +15 -0
  2. package/.opencode/commands/af-set-hermes-telegram.md +15 -0
  3. package/.pi/agents/dispatch-policy.yaml +1 -1
  4. package/.pi/agents/peers.yaml +4 -4
  5. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  6. package/.pi/extensions/btw/README.md +10 -10
  7. package/.pi/extensions/btw/index.ts +11 -11
  8. package/.pi/extensions/chrome-devtools-mcp/README.md +3 -3
  9. package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
  10. package/.pi/extensions/compact-and-continue/README.md +2 -2
  11. package/.pi/extensions/mcp-bridge/README.md +1 -1
  12. package/.pi/extensions/pi-voice-stt/README.md +7 -7
  13. package/.pi/extensions/pi-voice-stt/index.ts +4 -4
  14. package/.pi/harnesses/agent-hub/README.md +84 -84
  15. package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
  16. package/.pi/harnesses/agent-hub/delegate.ts +3 -3
  17. package/.pi/harnesses/agent-hub/drift-watchdog.js +1 -1
  18. package/.pi/harnesses/agent-hub/index.ts +254 -254
  19. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
  20. package/.pi/harnesses/agent-hub/monitor-publisher.ts +3 -3
  21. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +1 -1
  22. package/.pi/harnesses/agent-hub/package.json +1 -1
  23. package/.pi/harnesses/agent-hub/run-budget.js +1 -1
  24. package/.pi/harnesses/ask-user-remote/README.md +1 -0
  25. package/.pi/harnesses/ask-user-remote/index.ts +36 -8
  26. package/.pi/harnesses/coms/README.md +7 -7
  27. package/.pi/harnesses/coms/index.ts +13 -13
  28. package/.pi/harnesses/coms/package.json +1 -1
  29. package/.pi/harnesses/damage-control-continue/README.md +16 -16
  30. package/.pi/harnesses/damage-control-continue/index.ts +11 -11
  31. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  32. package/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  33. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  34. package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  35. package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  36. package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  37. package/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  38. package/.pi/prompts/af-set-hermes-telegram.md +15 -0
  39. package/.pi/prompts/af-setup-agent-fleet.md +27 -0
  40. package/.versions/0.0.5/.claude/commands/build.md +44 -0
  41. package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
  42. package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
  43. package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
  44. package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
  45. package/.versions/0.0.5/.claude/commands/plan.md +16 -0
  46. package/.versions/0.0.5/.claude/commands/prime.md +22 -0
  47. package/.versions/0.0.5/.claude/commands/review.md +16 -0
  48. package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
  49. package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
  50. package/.versions/0.0.5/.claude/commands/ship.md +72 -0
  51. package/.versions/0.0.5/.claude/commands/spec.md +15 -0
  52. package/.versions/0.0.5/.claude/commands/test.md +19 -0
  53. package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
  54. package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
  55. package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
  56. package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
  57. package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
  58. package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
  59. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  60. package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
  61. package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
  62. package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
  63. package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
  64. package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
  65. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
  66. package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
  67. package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
  68. package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
  69. package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
  70. package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
  71. package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  72. package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
  73. package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
  74. package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
  75. package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
  76. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  77. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  78. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  79. package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
  80. package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
  81. package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
  82. package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
  83. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  84. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  85. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  86. package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  87. package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  88. package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  89. package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  90. package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  91. package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  92. package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
  93. package/.versions/0.0.5/.pi/extensions/package.json +9 -0
  94. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
  95. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  96. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  97. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  98. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  99. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  100. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  101. package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
  102. package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  103. package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
  104. package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  105. package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
  106. package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  107. package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  108. package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
  109. package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
  110. package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
  111. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  112. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  113. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  114. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  115. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  116. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  117. package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  118. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
  119. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  120. package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
  121. package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
  122. package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  123. package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  124. package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
  125. package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
  126. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
  127. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
  128. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  129. package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
  130. package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
  131. package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
  132. package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
  133. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
  134. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  135. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  136. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
  137. package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  138. package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
  139. package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
  140. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  141. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  142. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  143. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  144. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  145. package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
  146. package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
  147. package/.versions/0.0.5/.pi/prompts/build.md +24 -0
  148. package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
  149. package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
  150. package/.versions/0.0.5/.pi/prompts/review.md +16 -0
  151. package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
  152. package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
  153. package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
  154. package/.versions/0.0.5/.pi/prompts/test.md +19 -0
  155. package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
  156. package/.versions/0.0.5/.version +1 -0
  157. package/.versions/0.0.5/agents/architect.md +23 -0
  158. package/.versions/0.0.5/agents/bowser.md +26 -0
  159. package/.versions/0.0.5/agents/builder.md +53 -0
  160. package/.versions/0.0.5/agents/code-reviewer.md +205 -0
  161. package/.versions/0.0.5/agents/deep-researcher.md +31 -0
  162. package/.versions/0.0.5/agents/documenter.md +18 -0
  163. package/.versions/0.0.5/agents/orchestrator.md +54 -0
  164. package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
  165. package/.versions/0.0.5/agents/planner.md +69 -0
  166. package/.versions/0.0.5/agents/releaser.md +24 -0
  167. package/.versions/0.0.5/agents/researcher.md +28 -0
  168. package/.versions/0.0.5/agents/security-auditor.md +166 -0
  169. package/.versions/0.0.5/agents/test-engineer.md +151 -0
  170. package/.versions/0.0.5/agents/web-debugger.md +42 -0
  171. package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
  172. package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
  173. package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
  174. package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
  175. package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
  176. package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
  177. package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
  178. package/.versions/0.0.5/docs/getting-started.md +183 -0
  179. package/.versions/0.0.5/docs/npm-install.md +337 -0
  180. package/.versions/0.0.5/docs/opencode-setup.md +249 -0
  181. package/.versions/0.0.5/docs/pi-extensions.md +293 -0
  182. package/.versions/0.0.5/docs/pi-setup.md +472 -0
  183. package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
  184. package/.versions/0.0.5/hermes/README.md +231 -0
  185. package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  186. package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  187. package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
  188. package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
  189. package/.versions/0.0.5/hooks/hooks.json +14 -0
  190. package/.versions/0.0.5/hooks/session-start.sh +74 -0
  191. package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
  192. package/.versions/0.0.5/justfile +245 -0
  193. package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
  194. package/.versions/0.0.5/references/definition-of-done.md +67 -0
  195. package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
  196. package/.versions/0.0.5/references/observability-checklist.md +91 -0
  197. package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
  198. package/.versions/0.0.5/references/performance-checklist.md +153 -0
  199. package/.versions/0.0.5/references/prompting-patterns.md +380 -0
  200. package/.versions/0.0.5/references/security-checklist.md +179 -0
  201. package/.versions/0.0.5/references/testing-patterns.md +236 -0
  202. package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
  203. package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
  204. package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
  205. package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
  206. package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
  207. package/.versions/0.0.5/scripts/fleet.ts +141 -0
  208. package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  209. package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
  210. package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
  211. package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
  212. package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
  213. package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
  214. package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  215. package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
  216. package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
  217. package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  218. package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  219. package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  220. package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  221. package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  222. package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  223. package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
  224. package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
  225. package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
  226. package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
  227. package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
  228. package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
  229. package/.versions/0.0.5/scripts/team-up.ts +351 -0
  230. package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
  231. package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
  232. package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  233. package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
  234. package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
  235. package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  236. package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
  237. package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  238. package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  239. package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  240. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
  241. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
  242. package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
  243. package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
  244. package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
  245. package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  246. package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  247. package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
  248. package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
  249. package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
  250. package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
  251. package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
  252. package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
  253. package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
  254. package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
  255. package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
  256. package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  257. package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  258. package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
  259. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  260. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  261. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  262. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  263. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  264. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  265. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  266. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  267. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  268. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  269. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  270. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  271. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  272. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  273. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  274. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  275. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  276. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  277. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  278. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  279. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  280. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  281. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  282. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  283. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  284. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  285. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  286. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  287. package/.versions/0.0.6/.claude/commands/build.md +44 -0
  288. package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
  289. package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
  290. package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
  291. package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
  292. package/.versions/0.0.6/.claude/commands/plan.md +16 -0
  293. package/.versions/0.0.6/.claude/commands/prime.md +22 -0
  294. package/.versions/0.0.6/.claude/commands/review.md +16 -0
  295. package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
  296. package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
  297. package/.versions/0.0.6/.claude/commands/ship.md +72 -0
  298. package/.versions/0.0.6/.claude/commands/spec.md +15 -0
  299. package/.versions/0.0.6/.claude/commands/test.md +19 -0
  300. package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
  301. package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
  302. package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
  303. package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
  304. package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
  305. package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
  306. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  307. package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
  308. package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
  309. package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
  310. package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
  311. package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
  312. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
  313. package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
  314. package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
  315. package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
  316. package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
  317. package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
  318. package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  319. package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
  320. package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
  321. package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
  322. package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
  323. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  324. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  325. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  326. package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
  327. package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
  328. package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
  329. package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
  330. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  331. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  332. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  333. package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  334. package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  335. package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  336. package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  337. package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  338. package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  339. package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
  340. package/.versions/0.0.6/.pi/extensions/package.json +9 -0
  341. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
  342. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  343. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  344. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  345. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  346. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  347. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  348. package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
  349. package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  350. package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
  351. package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  352. package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
  353. package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  354. package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  355. package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
  356. package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
  357. package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
  358. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  359. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  360. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  361. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  362. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  363. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  364. package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  365. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
  366. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  367. package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
  368. package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
  369. package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  370. package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  371. package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
  372. package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
  373. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
  374. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
  375. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  376. package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
  377. package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
  378. package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
  379. package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
  380. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
  381. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  382. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  383. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
  384. package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  385. package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
  386. package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
  387. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  388. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  389. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  390. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  391. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  392. package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
  393. package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
  394. package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
  395. package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
  396. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  397. package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
  398. package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
  399. package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  400. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
  401. package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
  402. package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
  403. package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
  404. package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
  405. package/.versions/0.0.6/.version +1 -0
  406. package/.versions/0.0.6/agents/architect.md +23 -0
  407. package/.versions/0.0.6/agents/bowser.md +26 -0
  408. package/.versions/0.0.6/agents/builder.md +53 -0
  409. package/.versions/0.0.6/agents/code-reviewer.md +205 -0
  410. package/.versions/0.0.6/agents/deep-researcher.md +31 -0
  411. package/.versions/0.0.6/agents/documenter.md +18 -0
  412. package/.versions/0.0.6/agents/orchestrator.md +54 -0
  413. package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
  414. package/.versions/0.0.6/agents/planner.md +69 -0
  415. package/.versions/0.0.6/agents/releaser.md +24 -0
  416. package/.versions/0.0.6/agents/researcher.md +28 -0
  417. package/.versions/0.0.6/agents/security-auditor.md +166 -0
  418. package/.versions/0.0.6/agents/test-engineer.md +151 -0
  419. package/.versions/0.0.6/agents/web-debugger.md +42 -0
  420. package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
  421. package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
  422. package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
  423. package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
  424. package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
  425. package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
  426. package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
  427. package/.versions/0.0.6/docs/getting-started.md +183 -0
  428. package/.versions/0.0.6/docs/npm-install.md +337 -0
  429. package/.versions/0.0.6/docs/opencode-setup.md +249 -0
  430. package/.versions/0.0.6/docs/pi-extensions.md +293 -0
  431. package/.versions/0.0.6/docs/pi-setup.md +476 -0
  432. package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
  433. package/.versions/0.0.6/hermes/README.md +231 -0
  434. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  435. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  436. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  437. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  438. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  439. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  440. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  441. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  442. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  443. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  444. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  445. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  446. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  447. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  448. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  449. package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  450. package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  451. package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
  452. package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
  453. package/.versions/0.0.6/hooks/hooks.json +14 -0
  454. package/.versions/0.0.6/hooks/session-start.sh +74 -0
  455. package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
  456. package/.versions/0.0.6/justfile +245 -0
  457. package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
  458. package/.versions/0.0.6/references/definition-of-done.md +67 -0
  459. package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
  460. package/.versions/0.0.6/references/observability-checklist.md +91 -0
  461. package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
  462. package/.versions/0.0.6/references/performance-checklist.md +153 -0
  463. package/.versions/0.0.6/references/prompting-patterns.md +380 -0
  464. package/.versions/0.0.6/references/security-checklist.md +179 -0
  465. package/.versions/0.0.6/references/testing-patterns.md +236 -0
  466. package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
  467. package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
  468. package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
  469. package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
  470. package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
  471. package/.versions/0.0.6/scripts/fleet.ts +141 -0
  472. package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  473. package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
  474. package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
  475. package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
  476. package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
  477. package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
  478. package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  479. package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
  480. package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
  481. package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  482. package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  483. package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  484. package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  485. package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  486. package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  487. package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
  488. package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
  489. package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
  490. package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
  491. package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
  492. package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
  493. package/.versions/0.0.6/scripts/team-up.ts +351 -0
  494. package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
  495. package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
  496. package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  497. package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
  498. package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
  499. package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  500. package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
  501. package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  502. package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  503. package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  504. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
  505. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
  506. package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
  507. package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
  508. package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
  509. package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  510. package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  511. package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
  512. package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
  513. package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
  514. package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
  515. package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
  516. package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
  517. package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
  518. package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
  519. package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
  520. package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  521. package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  522. package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
  523. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  524. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  525. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  526. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  527. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  528. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  529. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  530. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  531. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  532. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  533. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  534. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  535. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  536. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  537. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  538. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  539. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  540. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  541. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  542. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  543. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  544. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  545. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  546. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  547. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  548. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  549. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  550. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  551. package/CHANGELOG.md +15 -0
  552. package/README.md +38 -36
  553. package/agents/documenter.md +1 -1
  554. package/agents/releaser.md +1 -1
  555. package/bin/cli.js +103 -21
  556. package/bin/lib/bootstrap.js +16 -16
  557. package/bin/lib/doctor.js +1 -1
  558. package/bin/lib/set-hermes-telegram.js +323 -0
  559. package/docs/ARCHITECTURE.md +8 -8
  560. package/docs/agent-fleet-setup.md +12 -12
  561. package/docs/claude-code-coms-bridge.md +4 -4
  562. package/docs/codex-remote-conductor.md +12 -12
  563. package/docs/coms-hermes-bridge.md +62 -4
  564. package/docs/getting-started.md +4 -4
  565. package/docs/npm-install.md +21 -21
  566. package/docs/opencode-setup.md +1 -0
  567. package/docs/pi-extensions.md +36 -31
  568. package/docs/pi-setup.md +66 -53
  569. package/hermes/README.md +14 -11
  570. package/justfile +141 -152
  571. package/package.json +6 -3
  572. package/references/fleet-coordination-patterns.md +3 -3
  573. package/scripts/coms-hermes-bridge.ts +18 -8
  574. package/scripts/fleet.ts +141 -0
  575. package/scripts/lib/fleet-command.ts +109 -0
  576. package/scripts/lib/hermes-bridge-core.ts +5 -2
  577. package/scripts/lib/hermes-monitor-herdr.ts +2 -28
  578. package/scripts/lib/hermes-monitor-model.ts +3 -9
  579. package/scripts/lib/hermes-monitor-registry.ts +2 -6
  580. package/scripts/lib/hermes-monitor-socket.ts +2 -118
  581. package/scripts/lib/hermes-monitor-store.ts +2 -31
  582. package/scripts/lib/team-project.ts +10 -3
  583. package/scripts/team-snapshot.ts +4 -5
  584. package/scripts/team-up.ts +24 -6
  585. package/skills/browser-testing-with-devtools/SKILL.md +1 -1
  586. package/skills/compound-learning/SKILL.md +3 -3
  587. package/skills/guided-workspace-setup/SKILL.md +27 -18
  588. package/skills/guided-workspace-setup/companion-manifest.json +3 -1
  589. package/skills/peer-coms/SKILL.md +1 -1
  590. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -10
  591. /package/.pi/prompts/{build.md → af-build.md} +0 -0
  592. /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
  593. /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
  594. /package/.pi/prompts/{review.md → af-review.md} +0 -0
  595. /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
  596. /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
  597. /package/.pi/prompts/{test.md → af-test.md} +0 -0
  598. /package/{.pi → .versions/0.0.5/.pi}/prompts/doctor-agent-fleet.md +0 -0
  599. /package/{.pi → .versions/0.0.5/.pi}/prompts/setup-agent-fleet.md +0 -0
  600. /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
  601. /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
  602. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -0
  603. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -0
  604. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -0
  605. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -0
  606. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -0
  607. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -0
  608. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -0
  609. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
  610. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -0
  611. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
  612. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -0
  613. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
  614. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -0
@@ -1,10 +1,10 @@
1
1
  // bootstrap.js — drop the minimum installer artifacts a coding agent needs
2
- // to recognize `/setup-agent-fleet` and `/doctor-agent-fleet`.
2
+ // to recognize Agent Fleet's setup and doctor slash commands.
3
3
  //
4
4
  // The CLI's `init` calls this before the handoff message. Without it, a
5
- // fresh workspace has no `.claude/commands/setup-agent-fleet.md`, `.pi/prompts/setup-agent-fleet.md`,
6
- // etc., so the agent has no idea what `/setup-agent-fleet` is and the whole hand-off
7
- // breaks silently.
5
+ // fresh workspace has no `.claude/commands/setup-agent-fleet.md`,
6
+ // `.pi/prompts/af-setup-agent-fleet.md`, etc., so the agent has no setup
7
+ // entrypoint and the whole hand-off breaks silently.
8
8
  //
9
9
  // What we bootstrap (per agent):
10
10
  // - The `setup` slash command (so the user can invoke it)
@@ -16,7 +16,7 @@
16
16
  // What we do NOT bootstrap:
17
17
  // - Any of the user-facing skills (spec-driven-development,
18
18
  // test-driven-development, …). Those are picked by the user inside
19
- // /setup-agent-fleet, by design. The CLI never decides the workspace's catalogue
19
+ // through the runtime's setup command, by design. The CLI never decides the workspace's catalogue
20
20
  // for the user.
21
21
  //
22
22
  // Method:
@@ -93,10 +93,10 @@ function plan({ agent, sourceRoot, workspace }) {
93
93
 
94
94
  case "pi":
95
95
  return [
96
- { kind: "prompt", src: join(sourceRoot, ".pi/prompts/setup-agent-fleet.md"),
97
- dest: join(workspace, ".pi/prompts/setup-agent-fleet.md") },
98
- { kind: "prompt", src: join(sourceRoot, ".pi/prompts/doctor-agent-fleet.md"),
99
- dest: join(workspace, ".pi/prompts/doctor-agent-fleet.md") },
96
+ { kind: "prompt", src: join(sourceRoot, ".pi/prompts/af-setup-agent-fleet.md"),
97
+ dest: join(workspace, ".pi/prompts/af-setup-agent-fleet.md") },
98
+ { kind: "prompt", src: join(sourceRoot, ".pi/prompts/af-doctor-agent-fleet.md"),
99
+ dest: join(workspace, ".pi/prompts/af-doctor-agent-fleet.md") },
100
100
  // pi auto-discovers skills from .pi/skills/ and .agents/skills/ —
101
101
  // we use .pi/skills/ to avoid polluting a shared .agents/ dir if
102
102
  // the user has other tools there.
@@ -124,9 +124,8 @@ function plan({ agent, sourceRoot, workspace }) {
124
124
  }
125
125
  }
126
126
 
127
- // Files that were the bootstrap targets in 0.2.0 and earlier (pre-rename).
128
- // Removed during bootstrap so a workspace upgraded from 0.2.0 doesn't end
129
- // up with both the old and new slash commands.
127
+ // Previous bootstrap targets. Removed during bootstrap so upgrades do not
128
+ // leave both unprefixed and current slash commands in the workspace.
130
129
  function legacyPaths({ agent, workspace }) {
131
130
  switch (agent) {
132
131
  case "claude-code":
@@ -138,6 +137,8 @@ function legacyPaths({ agent, workspace }) {
138
137
  return [
139
138
  join(workspace, ".pi/prompts/setup.md"),
140
139
  join(workspace, ".pi/prompts/doctor.md"),
140
+ join(workspace, ".pi/prompts/setup-agent-fleet.md"),
141
+ join(workspace, ".pi/prompts/doctor-agent-fleet.md"),
141
142
  ];
142
143
  case "opencode":
143
144
  return [
@@ -173,8 +174,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
173
174
  );
174
175
  }
175
176
 
176
- // Clean up pre-0.3.0 file names if present — they were renamed to
177
- // *-agent-fleet so they don't collide with other slash commands.
177
+ // Clean up superseded file names so old and current commands never coexist.
178
178
  for (const oldPath of legacyPaths({ agent, workspace })) {
179
179
  if (!existsSync(oldPath) && !isSymlink(oldPath)) continue;
180
180
  if (dryRun) {
@@ -205,7 +205,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
205
205
 
206
206
  // Always replace — the bootstrap is installer scaffolding, not user
207
207
  // data. If we left it stale, an upgraded package would still hand off
208
- // to the old /setup-agent-fleet command. Step 6 of guided-workspace-setup explicitly
208
+ // to an old setup command. Step 6 of guided-workspace-setup explicitly
209
209
  // never offers these files in the install menu, so we are the only
210
210
  // mechanism that refreshes them.
211
211
  if (existsSync(item.dest) || isSymlink(item.dest)) {
@@ -248,7 +248,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
248
248
  * Remove every bootstrap artifact this module knows how to write. Called
249
249
  * by guided-workspace-setup at the end of Step 10 unless the user chose
250
250
  * to keep the installer commands. After cleanup, the only way back to
251
- * /setup-agent-fleet is to re-run `npx @chankov/agent-fleet init`.
251
+ * the setup command is to re-run `npx @chankov/agent-fleet init`.
252
252
  *
253
253
  * The same `agent` value must be supplied that was used at bootstrap time —
254
254
  * we don't have a tracking file, so we delete based on the plan map.
package/bin/lib/doctor.js CHANGED
@@ -1,6 +1,6 @@
1
1
  // Doctor scan — deterministic preflight extracted from
2
2
  // guided-workspace-setup Step 5. Both `agent-fleet doctor` (CLI) and the
3
- // `/doctor-agent-fleet` slash command call into this so behaviour cannot drift.
3
+ // Runtime-specific Agent Fleet doctor slash commands call into this so behaviour cannot drift.
4
4
  //
5
5
  // Three classes of findings:
6
6
  // 1. Broken symlinks — links whose source has been moved, renamed, or deleted
@@ -0,0 +1,323 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync } from "node:fs";
3
+ import { isAbsolute, join, relative, resolve } from "node:path";
4
+ import { spawnSync } from "node:child_process";
5
+
6
+ const TELEGRAM_ID_RE = /^\d+(?::\d+)?$/;
7
+ const SAFE_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
8
+ const BRIDGE_LABEL = "hermes-bridge";
9
+ const LIAISON_SKILL = "hub-liaison";
10
+
11
+ function usageError(detail) {
12
+ return new Error(`${detail}\nUsage:\n agent-fleet set-hermes-telegram install [--profile NAME] [--force] [--restart]\n agent-fleet set-hermes-telegram status [--profile NAME]\n agent-fleet set-hermes-telegram <on|off> <telegram-id[:topic-id]> [--profile NAME]`);
13
+ }
14
+
15
+ export function parseSetHermesTelegramArgs(argv) {
16
+ const [action, telegramId, ...extra] = argv;
17
+ if (["install", "status"].includes(action) && telegramId === undefined && extra.length === 0) return { action };
18
+ if (!["on", "off"].includes(action) || telegramId === undefined || extra.length > 0) {
19
+ throw usageError("Expected install, status, or an on/off action with one Telegram ID.");
20
+ }
21
+ if (!TELEGRAM_ID_RE.test(telegramId)) {
22
+ throw usageError("Telegram ID must be digits, optionally followed by a colon and a numeric topic ID.");
23
+ }
24
+ return { action, telegramId, target: `telegram:${telegramId}` };
25
+ }
26
+
27
+ function validateSafeName(value, label) {
28
+ if (!SAFE_NAME_RE.test(value) || value === "." || value.includes("..")) {
29
+ throw new Error(`Invalid ${label}: ${JSON.stringify(value)}`);
30
+ }
31
+ return value;
32
+ }
33
+
34
+ function validateProject(project) {
35
+ return validateSafeName(project, "project inferred from the current pane");
36
+ }
37
+
38
+ export function inferProjectFromProcessInfo(response, env = process.env) {
39
+ const processes = response?.result?.process_info?.foreground_processes ?? [];
40
+ for (const processInfo of processes) {
41
+ const argv = Array.isArray(processInfo?.argv) ? processInfo.argv : [];
42
+ for (let i = 0; i < argv.length; i++) {
43
+ if (argv[i] === "--project" && typeof argv[i + 1] === "string") return validateProject(argv[i + 1]);
44
+ if (typeof argv[i] === "string" && argv[i].startsWith("--project=")) {
45
+ return validateProject(argv[i].slice("--project=".length));
46
+ }
47
+ }
48
+ }
49
+ const envProject = env.PI_COMS_PROJECT?.trim();
50
+ return validateProject(envProject || "default");
51
+ }
52
+
53
+ function shellQuote(value) {
54
+ return `'${String(value).replaceAll("'", `'"'"'`)}'`;
55
+ }
56
+
57
+ export function parseHerdrOutput(stdout) {
58
+ const text = stdout.trim();
59
+ if (!text) return { result: {} };
60
+ return JSON.parse(text);
61
+ }
62
+
63
+ function runCommand(command, args) {
64
+ const result = spawnSync(command, args, { encoding: "utf8" });
65
+ if (result.error) throw new Error(`failed to run ${command}: ${result.error.message}`);
66
+ if (result.status !== 0) throw new Error((result.stderr || result.stdout).trim() || `${command} ${args.join(" ")} failed`);
67
+ return { stdout: result.stdout, stderr: result.stderr };
68
+ }
69
+
70
+ export function runHerdrCommand(args) {
71
+ const result = runCommand("herdr", args);
72
+ try {
73
+ return parseHerdrOutput(result.stdout);
74
+ } catch {
75
+ throw new Error(`herdr returned invalid JSON for ${args.slice(0, 2).join(" ")}`);
76
+ }
77
+ }
78
+
79
+ export function runHermesCommand(args) {
80
+ return runCommand("hermes", args).stdout;
81
+ }
82
+
83
+ function stripAnsi(text) {
84
+ return text.replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, "");
85
+ }
86
+
87
+ export function parseRunningGatewayProfiles(output) {
88
+ const profiles = [];
89
+ for (const line of stripAnsi(output).split("\n")) {
90
+ const match = line.match(/^\s*✓\s+([A-Za-z0-9][A-Za-z0-9._-]*)(?:\s|$)/u);
91
+ if (match) profiles.push(match[1]);
92
+ }
93
+ return profiles;
94
+ }
95
+
96
+ export function parseProfilePath(output, expectedProfile) {
97
+ const clean = stripAnsi(output);
98
+ const profile = clean.match(/^Profile:\s*(\S+)\s*$/m)?.[1];
99
+ const profilePath = clean.match(/^Path:\s*(.+?)\s*$/m)?.[1];
100
+ if (profile !== expectedProfile || !profilePath || !isAbsolute(profilePath)) {
101
+ throw new Error(`Hermes returned an invalid profile description for ${expectedProfile}`);
102
+ }
103
+ return resolve(profilePath);
104
+ }
105
+
106
+ function directoryFingerprint(root) {
107
+ if (!existsSync(root)) return null;
108
+ const hash = createHash("sha256");
109
+ function visit(current) {
110
+ const stat = lstatSync(current);
111
+ if (stat.isSymbolicLink()) throw new Error(`refusing symlink in Hermes skill tree: ${current}`);
112
+ if (stat.isDirectory()) {
113
+ for (const name of readdirSync(current).sort()) visit(join(current, name));
114
+ return;
115
+ }
116
+ if (!stat.isFile()) throw new Error(`unsupported entry in Hermes skill tree: ${current}`);
117
+ const rel = relative(root, current);
118
+ hash.update(rel); hash.update("\0"); hash.update(readFileSync(current)); hash.update("\0");
119
+ }
120
+ visit(root);
121
+ return hash.digest("hex");
122
+ }
123
+
124
+ function skillState(sourceDir, installedDir) {
125
+ const sourceFingerprint = directoryFingerprint(sourceDir);
126
+ if (!sourceFingerprint) throw new Error(`packaged ${LIAISON_SKILL} source is missing: ${sourceDir}`);
127
+ const installedFingerprint = directoryFingerprint(installedDir);
128
+ return {
129
+ state: installedFingerprint === null ? "missing" : installedFingerprint === sourceFingerprint ? "current" : "drifted",
130
+ sourceFingerprint,
131
+ installedFingerprint,
132
+ };
133
+ }
134
+
135
+ function parseSkillEnabled(output) {
136
+ return stripAnsi(output).split("\n").some((line) => line.includes(LIAISON_SKILL) && /\benabled\b/i.test(line));
137
+ }
138
+
139
+ export function parseTelegramToolReadiness(output) {
140
+ const clean = stripAnsi(output);
141
+ const enabled = (name) => new RegExp(`^\\s*✓\\s+enabled\\s+${name}\\b`, "m").test(clean);
142
+ return { terminal: enabled("terminal"), file: enabled("file") };
143
+ }
144
+
145
+ async function resolveHermesProfile(requestedProfile, hermes) {
146
+ const gatewaysOutput = await hermes(["gateway", "list"]);
147
+ const runningProfiles = parseRunningGatewayProfiles(gatewaysOutput);
148
+ let profile = requestedProfile?.trim();
149
+ if (profile) validateSafeName(profile, "Hermes profile");
150
+ else {
151
+ if (runningProfiles.length !== 1) {
152
+ throw new Error(`cannot infer Hermes profile: expected exactly one running gateway, found ${runningProfiles.length}; pass --profile NAME`);
153
+ }
154
+ [profile] = runningProfiles;
155
+ }
156
+ const profileOutput = await hermes(["profile", "show", profile]);
157
+ const profilePath = parseProfilePath(profileOutput, profile);
158
+ if (!existsSync(profilePath) || !lstatSync(profilePath).isDirectory() || lstatSync(profilePath).isSymbolicLink()) {
159
+ throw new Error(`unsafe or missing Hermes profile directory: ${profilePath}`);
160
+ }
161
+ return { profile, profilePath, gatewayRunning: runningProfiles.includes(profile) };
162
+ }
163
+
164
+ export async function inspectHermesTelegram(options) {
165
+ const hermes = options.hermes ?? (async (args) => runHermesCommand(args));
166
+ const resolvedProfile = await resolveHermesProfile(options.profile, hermes);
167
+ const sourceDir = options.skillSourceDir ?? join(options.packageRoot, "hermes", "skills", LIAISON_SKILL);
168
+ const installedDir = join(resolvedProfile.profilePath, "skills", LIAISON_SKILL);
169
+ const skill = skillState(sourceDir, installedDir);
170
+ const [skillsOutput, toolsOutput] = await Promise.all([
171
+ hermes(["--profile", resolvedProfile.profile, "skills", "list", "--enabled-only"]),
172
+ hermes(["--profile", resolvedProfile.profile, "tools", "list", "--platform", "telegram"]),
173
+ ]);
174
+ const tools = parseTelegramToolReadiness(toolsOutput);
175
+ const skillEnabled = parseSkillEnabled(skillsOutput);
176
+ return {
177
+ ...resolvedProfile,
178
+ sourceDir,
179
+ installedDir,
180
+ skillState: skill.state,
181
+ skillEnabled,
182
+ tools,
183
+ ready: skill.state === "current" && skillEnabled && tools.terminal && tools.file && resolvedProfile.gatewayRunning,
184
+ };
185
+ }
186
+
187
+ function readinessError(status) {
188
+ const problems = [];
189
+ if (status.skillState !== "current") problems.push(`${LIAISON_SKILL} is ${status.skillState}`);
190
+ if (!status.skillEnabled) problems.push(`${LIAISON_SKILL} is not enabled`);
191
+ if (!status.tools.terminal || !status.tools.file) problems.push("Telegram terminal/file tools are not both enabled");
192
+ if (!status.gatewayRunning) problems.push(`gateway profile ${status.profile} is not running`);
193
+ return `${problems.join("; ")}. Run: agent-fleet set-hermes-telegram install --profile ${status.profile}${status.skillState === "drifted" ? " --force" : ""}`;
194
+ }
195
+
196
+ function backupName(now) {
197
+ return `${LIAISON_SKILL}-${now().toISOString().replace(/[:.]/g, "-")}`;
198
+ }
199
+
200
+ function ensurePlainDirectory(dir, parent) {
201
+ if (existsSync(dir)) {
202
+ const stat = lstatSync(dir);
203
+ if (stat.isSymbolicLink() || !stat.isDirectory()) throw new Error(`refusing unsafe Hermes directory: ${dir}`);
204
+ return;
205
+ }
206
+ if (parent) ensurePlainDirectory(parent);
207
+ mkdirSync(dir, { mode: 0o700 });
208
+ }
209
+
210
+ function atomicInstallSkill(sourceDir, installedDir, profilePath, now) {
211
+ const skillsDir = join(profilePath, "skills");
212
+ ensurePlainDirectory(skillsDir, profilePath);
213
+ const tempDir = join(skillsDir, `.${LIAISON_SKILL}.tmp-${process.pid}-${randomUUID()}`);
214
+ const backupRoot = join(profilePath, "backups", "agent-fleet");
215
+ let backupDir = null;
216
+ try {
217
+ cpSync(sourceDir, tempDir, { recursive: true, errorOnExist: true, force: false });
218
+ directoryFingerprint(tempDir);
219
+ if (existsSync(installedDir)) {
220
+ ensurePlainDirectory(join(profilePath, "backups"), profilePath);
221
+ ensurePlainDirectory(backupRoot, join(profilePath, "backups"));
222
+ backupDir = join(backupRoot, backupName(now));
223
+ renameSync(installedDir, backupDir);
224
+ }
225
+ renameSync(tempDir, installedDir);
226
+ return backupDir;
227
+ } catch (error) {
228
+ rmSync(tempDir, { recursive: true, force: true });
229
+ if (backupDir && existsSync(backupDir) && !existsSync(installedDir)) renameSync(backupDir, installedDir);
230
+ throw error;
231
+ }
232
+ }
233
+
234
+ export async function installHermesTelegram(options) {
235
+ const hermes = options.hermes ?? (async (args) => runHermesCommand(args));
236
+ const before = await inspectHermesTelegram({ ...options, hermes });
237
+ if (before.skillState === "drifted" && !options.force) {
238
+ throw new Error(`${LIAISON_SKILL} differs from the packaged Agent Fleet version in profile ${before.profile}; re-run with --force to back it up and replace it`);
239
+ }
240
+ let backupDir = null;
241
+ let changed = false;
242
+ if (before.skillState !== "current") {
243
+ backupDir = atomicInstallSkill(before.sourceDir, before.installedDir, before.profilePath, options.now ?? (() => new Date()));
244
+ changed = true;
245
+ }
246
+ const after = await inspectHermesTelegram({ ...options, profile: before.profile, hermes });
247
+ if (after.skillState !== "current") throw new Error(`${LIAISON_SKILL} verification failed after install`);
248
+ let restarted = false;
249
+ if (options.restart && after.gatewayRunning) {
250
+ await hermes(["--profile", after.profile, "gateway", "restart"]);
251
+ restarted = true;
252
+ }
253
+ return {
254
+ action: "install",
255
+ profile: after.profile,
256
+ profilePath: after.profilePath,
257
+ skillState: after.skillState,
258
+ skillEnabled: after.skillEnabled,
259
+ tools: after.tools,
260
+ gatewayRunning: after.gatewayRunning,
261
+ ready: after.skillEnabled && after.tools.terminal && after.tools.file && after.gatewayRunning,
262
+ changed,
263
+ backupDir,
264
+ restarted,
265
+ restartRequired: changed && after.gatewayRunning && !restarted,
266
+ };
267
+ }
268
+
269
+ async function controlBridge(options, parsed) {
270
+ const herdr = options.herdr ?? (async (args) => runHerdrCommand(args));
271
+ const currentPaneId = options.currentPaneId;
272
+ if (!currentPaneId) throw new Error("HERDR_PANE_ID is required; run this command inside a Herdr pane");
273
+
274
+ let hermesProfile = null;
275
+ if (parsed.action === "on") {
276
+ const status = await inspectHermesTelegram(options);
277
+ if (!status.ready) throw new Error(readinessError(status));
278
+ hermesProfile = status.profile;
279
+ }
280
+
281
+ const currentResponse = await herdr(["pane", "get", currentPaneId]);
282
+ const currentPane = currentResponse?.result?.pane;
283
+ if (!currentPane?.workspace_id) throw new Error(`cannot resolve workspace for current pane ${currentPaneId}`);
284
+ const workspaceId = currentPane.workspace_id;
285
+ const processInfo = await herdr(["pane", "process-info", "--pane", currentPaneId]);
286
+ const project = inferProjectFromProcessInfo(processInfo, options.env);
287
+ const list = await herdr(["pane", "list", "--workspace", workspaceId]);
288
+ const bridgePanes = (list?.result?.panes ?? []).filter((pane) => pane.label === BRIDGE_LABEL && pane.pane_id !== currentPaneId);
289
+ for (const pane of bridgePanes) await herdr(["pane", "close", pane.pane_id]);
290
+
291
+ if (parsed.action === "off") {
292
+ return { action: "off", closedPaneIds: bridgePanes.map((pane) => pane.pane_id), project, target: parsed.target, workspaceId };
293
+ }
294
+
295
+ const split = await herdr(["pane", "split", currentPaneId, "--direction", "right", "--ratio", "0.3", "--cwd", currentPane.cwd || process.cwd(), "--no-focus"]);
296
+ const paneId = split?.result?.pane?.pane_id;
297
+ if (!paneId) throw new Error("herdr did not return the new bridge pane ID");
298
+ try {
299
+ await herdr(["pane", "rename", paneId, BRIDGE_LABEL]);
300
+ const command = [
301
+ shellQuote(process.execPath), "--experimental-strip-types",
302
+ shellQuote(join(options.packageRoot, "scripts", "coms-hermes-bridge.ts")),
303
+ "--project", shellQuote(project), "--hermes-profile", shellQuote(hermesProfile),
304
+ "--timeout", "1800000", "--to", shellQuote(parsed.target),
305
+ ].join(" ");
306
+ await herdr(["pane", "run", paneId, command]);
307
+ } catch (error) {
308
+ await herdr(["pane", "close", paneId]).catch(() => {});
309
+ throw error;
310
+ }
311
+ return { action: "on", hermesProfile, paneId, project, target: parsed.target, workspaceId };
312
+ }
313
+
314
+ export async function setHermesTelegram(options) {
315
+ const positionals = options.positionals ?? [options.action, options.telegramId].filter((value) => value !== undefined);
316
+ const parsed = parseSetHermesTelegramArgs(positionals);
317
+ if (parsed.action !== "install" && (options.force || options.restart)) {
318
+ throw usageError("--force and --restart are valid only with install.");
319
+ }
320
+ if (parsed.action === "status") return { action: "status", ...(await inspectHermesTelegram(options)) };
321
+ if (parsed.action === "install") return installHermesTelegram(options);
322
+ return controlBridge(options, parsed);
323
+ }
@@ -13,7 +13,7 @@ the runtime responsibilities and where each module lives in the repository.
13
13
  | **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | `.pi/harnesses/coms/`, `scripts/lib/coms-envelope.ts`, `scripts/coms-cli.ts` |
14
14
  | **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `scripts/coms-claude-bridge.ts`, `hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
15
15
  | **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
16
- | **Hermes local monitor transport** | Local, authenticated visibility/control contract for hub-owned task generations; presentation is supplied by an external consumer | `.pi/harnesses/agent-hub/monitor-*.ts`, `scripts/lib/hermes-monitor-{model,store,registry,socket}.ts` — see [Hermes artifacts](../hermes/README.md#local-agent-hub-monitor-integration) |
16
+ | **Hermes local monitor transport** | Local, authenticated visibility/control contract for hub-owned task generations; presentation is supplied by an external consumer | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `scripts/lib/`) — see [Hermes artifacts](../hermes/README.md#local-agent-hub-monitor-integration) |
17
17
  | **Codex remote-control conductor** | Experimental outbound-only, user-systemd-managed Android conductor; verified on Codex CLI 0.144.x | `scripts/codex-remote-control.ts`, `scripts/codex-conductor.ts`, `codex/CONDUCTOR.md`, `systemd/user/`; runtime under `~/.local/state/agent-fleet/codex-conductor/` — see [codex-remote-conductor.md](codex-remote-conductor.md) |
18
18
  | **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
19
19
  | **Personas** | Reusable specialist definitions, transformed per harness | `agents/`, `bin/lib/transform-persona.js` |
@@ -26,7 +26,7 @@ Agent Fleet is layered on purpose. Work flows **down** (delegate); evidence and
26
26
  flowchart TD
27
27
  You(["You · Hermes inbound relay · Codex outbound conductor on your phone"])
28
28
 
29
- subgraph HUBL["HUB — thin dispatcher (just hub · just hub-team)"]
29
+ subgraph HUBL["HUB — thin dispatcher (just fleet hub · just fleet team)"]
30
30
  Hub["agent-hub harness + orchestrator persona<br/>routes tasks · owns the Verification Contract on disk<br/>never swallows research dumps into its own context"]
31
31
  end
32
32
 
@@ -101,7 +101,7 @@ sessions are recycled (fresh spawn instead of `-c` resume) after `session-recycl
101
101
  or ≥60% measured context — resumed sessions otherwise re-bill their accumulated context on
102
102
  every model call. Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
103
103
  `max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`);
104
- switched live with `/hub-mode`.
104
+ switched live with `/af-hub-mode`.
105
105
 
106
106
  On top of the mode sit three qualitative guardrails. **Task triage**: the dispatcher
107
107
  classifies each turn via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
@@ -111,10 +111,10 @@ observed in-flight from the JSON event stream — deterministic rules (out-of-sc
111
111
  against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
112
112
  escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
113
113
  `drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
114
- (`watchdog` key, `/watchdog`, `watchdog` param). **Dynamic teams**: `/agents-add`,
115
- `/agents-drop`, `/agents-save` restructure the roster live (the system prompt rebuilds
114
+ (`watchdog` key, `/af-watchdog`, `watchdog` param). **Dynamic teams**: `/af-agents-add`,
115
+ `/af-agents-drop`, `/af-agents-save` restructure the roster live (the system prompt rebuilds
116
116
  every turn), and the gated `team_adjust` tool lets the dispatcher itself adjust the roster
117
- outside fast mode, with user notification. `/hub-report` accounts each turn's dispatches,
117
+ outside fast mode, with user notification. `/af-hub-report` accounts each turn's dispatches,
118
118
  tokens (billed = input + cacheRead + cacheWrite), recycles, drift stops, and refusals.
119
119
 
120
120
  ## Runtime stack (tools the fleet sits on)
@@ -136,8 +136,8 @@ These are the external systems Agent Fleet assumes or integrates with — not np
136
136
 
137
137
  | Dependency | Role | Required? |
138
138
  | --- | --- | --- |
139
- | **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for full fleet mode (`just hub`) |
140
- | **[herdr](https://herdr.dev)** | Workspace control plane: tiled peer panes, presence push events, team snapshot/resume | Yes for fleet recipes (`just team-up`, `just hub-team`, …); optional for solo hub |
139
+ | **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for full fleet mode (`just fleet hub`) |
140
+ | **[herdr](https://herdr.dev)** | Workspace control plane: tiled peer panes, presence push events, team snapshot/resume | Yes for team mode (`just fleet team`); optional for `just fleet hub` |
141
141
  | **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class peer via the [coms bridge](claude-code-coms-bridge.md); also a supported install target for skills/personas | Optional peer / alternate harness |
142
142
  | **[OpenCode](https://opencode.ai)** | Skill-driven execution target (`AGENTS.md` + `skill` tool); `af-*` slash commands | Optional alternate harness |
143
143
  | **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions) — [coms-hermes-bridge](coms-hermes-bridge.md) | Optional |
@@ -38,7 +38,7 @@ it here, and the reader picks it up.
38
38
  built-in default.
39
39
  - **Validation.** Because an unknown section or key silently falls back to the
40
40
  default, typos are invisible at runtime. `agent-fleet doctor` (and the
41
- `/doctor-agent-fleet` command) validates the file — unknown sections,
41
+ runtime's Agent Fleet doctor command) validates the file — unknown sections,
42
42
  unknown keys in known sections, invalid values for the mechanically parsed
43
43
  `agent-hub` keys, missing `rules:` folders, and unset `## env` vars — as
44
44
  **advisory, warn-only findings**; it never edits the file.
@@ -91,7 +91,7 @@ override files keep working unchanged. When both sections are present their keys
91
91
  with later lines winning.
92
92
 
93
93
  The `rules:` and `docs:` keys are also read outside the harness: the `compound-learning`
94
- skill (and the `/compound` claude-code/opencode commands built on it) resolves them as the
94
+ skill (and the `/compound` Claude Code / `/af-compound` OpenCode commands built on it) resolves them as the
95
95
  targets an end-of-session compound pass writes lessons to.
96
96
 
97
97
  | Key | Default | Meaning |
@@ -99,21 +99,21 @@ targets an end-of-session compound pass writes lessons to.
99
99
  | `language` | `English` | User-facing language the dispatcher uses for every `ask_user` question, every `context` field, and every summary. Specialist task strings always stay in English regardless. |
100
100
  | `persona-gate` | `off` | When `on`, blocks input at session start until an orchestrator persona is picked. |
101
101
  | `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). |
102
- | `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/agent-model` and `/models` profiles (comma-separated pi model specs). |
103
- | `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
102
+ | `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/af-agent-model` and `/af-models` profiles (comma-separated pi model specs). |
103
+ | `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/af-agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
104
104
  | `subagents.<persona>.<role>` | persona frontmatter `subagents:` | Replaces or adds one delegate sub-role for this project: `<model>[, tools=<caps>]`. Other declared roles keep their frontmatter values. |
105
105
  | `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
106
106
  | `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
107
107
  | `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |
108
- | `research-keep` | `4` | How many **finished** manual/persona research helpers the hub retains (LRU by finish time) so they stay resumable via `/agents-cont rN`; older ones are pruned along with their session files. `all` disables the cap. Auto-research pipe helpers (spawned for `NEEDS_RESEARCH:` pauses) are always pruned as soon as they finish — their findings persist as files under `.pi/agent-sessions/findings/`. Running helpers are never pruned. An invalid value is ignored with a session-start warning. |
108
+ | `research-keep` | `4` | How many **finished** manual/persona research helpers the hub retains (LRU by finish time) so they stay resumable via `/af-agents-cont rN`; older ones are pruned along with their session files. `all` disables the cap. Auto-research pipe helpers (spawned for `NEEDS_RESEARCH:` pauses) are always pruned as soon as they finish — their findings persist as files under `.pi/agent-sessions/findings/`. Running helpers are never pruned. An invalid value is ignored with a session-start warning. |
109
109
  | `recon-search-timeout-s` | `120` | Parent-side deadline, in seconds, for each `read`, `grep`, `find`, or `ls` call made by a native research helper or nested delegate child. Accepts an integer `1`–`3600` or `off`; invalid input warns and falls back to `120`. This is **not** an agent/turn deadline: non-tool work can run indefinitely. On timeout the hub returns `tool_timeout` with call metadata, sends SIGTERM to its owned process group, escalates to SIGKILL after a finite grace period, and settles even if the child never closes or a descendant holds a pipe. If that bounded cleanup cannot confirm child/process-group death, the metadata reports `terminationConfirmed: false`; this prevents a parent hang but may indicate an uninterruptible OS-level process needing operator attention. |
110
- | `mode` | `standard` | Execution mode for the hub's per-turn budgets: `fast` (single-specialist path, no nested delegation, assertion ledger optional), `standard` (batched execution with moderate budgets), or `strict` (full Verification Contract with wide budgets). Budgets are per **user turn** — exhausted budgets make `dispatch_agent`/`spawn_research` refuse with "summarize and ask the user"; the next user message opens a fresh window. Switchable live with `/hub-mode`. |
110
+ | `mode` | `standard` | Execution mode for the hub's per-turn budgets: `fast` (single-specialist path, no nested delegation, assertion ledger optional), `standard` (batched execution with moderate budgets), or `strict` (full Verification Contract with wide budgets). Budgets are per **user turn** — exhausted budgets make `dispatch_agent`/`spawn_research` refuse with "summarize and ask the user"; the next user message opens a fresh window. Switchable live with `/af-hub-mode`. |
111
111
  | `max-dispatches-per-turn` | mode default (2/8/24) | `dispatch_agent` calls allowed per user turn. Positive integer or `off` (unlimited). |
112
- | `max-research-per-turn` | mode default (1/4/12) | `spawn_research` calls allowed per user turn (the auto-research pipe and the `/research` command are exempt). Positive integer or `off`. |
112
+ | `max-research-per-turn` | mode default (1/4/12) | `spawn_research` calls allowed per user turn (the auto-research pipe and the `/af-research` command are exempt). Positive integer or `off`. |
113
113
  | `turn-wall-time-s` | mode default (900/3600/14400) | Wall-clock budget, in seconds, per user turn; once exceeded, further dispatch/research calls refuse. Positive integer or `off`. |
114
114
  | `agent-turn-timeout-s` | mode default (600/1800/off) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off`. |
115
115
  | `session-recycle-runs` | mode default (3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (context threshold still applies). |
116
- | `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Overridable live per hub (`/watchdog on\|off\|auto`), per agent (`/watchdog <agent> on\|off\|clear`), and per dispatch (the `watchdog` param). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
116
+ | `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Overridable live per hub (`/af-watchdog on\|off\|auto`), per agent (`/af-watchdog <agent> on\|off\|clear`), and per dispatch (the `watchdog` param). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
117
117
  | `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-5.3-codex-spark`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
118
118
 
119
119
  Example — switch the dispatcher to Bulgarian, pin the builder to sonnet, raise the
@@ -152,12 +152,12 @@ required: APP_TEST_ADMIN_USER, APP_TEST_ADMIN_PASS, AZURE_SPEECH_KEY
152
152
  ```
153
153
 
154
154
  No skill or harness loads this section. Its only reader is `agent-fleet doctor`
155
- (and `/doctor-agent-fleet`), which warns when a declared name is neither set in
155
+ (and the runtime's Agent Fleet doctor command), which warns when a declared name is neither set in
156
156
  the environment nor declared in the workspace root `.env`.
157
157
 
158
158
  ### Per-peer env files (`env_file:` in peers.yaml)
159
159
 
160
- Fleet peers spawned by `just team-up` / `just hub-team` can carry their own
160
+ Fleet peers spawned by `just fleet team` can carry their own
161
161
  environment: an `env_file:` entry in `.pi/agents/peers.yaml` names a
162
162
  **repo-relative** KEY=VALUE file (same format as `.env`, no shell evaluation)
163
163
  that herdr injects into the peer's pane before the command runs — no `source`,
@@ -243,12 +243,12 @@ available). The reader differs by runtime: pi's harness parses its YAML, while
243
243
  | pi | `.pi/agents/teams.yaml` | via the `agent-hub` harness (no `/orchestrate`) |
244
244
 
245
245
  Switch teams at runtime with `/orchestrate <team> "<task>"` (parallel of pi's
246
- `/agents-team`); use `/orchestrate team=<name> <task>` to disambiguate when the
246
+ `/af-agents-team`); use `/orchestrate team=<name> <task>` to disambiguate when the
247
247
  task text starts with a word that collides with a team key.
248
248
 
249
249
  **Guided-setup behaviour.** `guided-workspace-setup` offers `/orchestrate`
250
250
  **`★`-recommended** for claude-code + opencode (hidden for pi via the existing
251
- source-availability filter — there is no `.pi/prompts/orchestrate.md`), and
251
+ source-availability filter — there is no `.pi/prompts/af-orchestrate.md`), and
252
252
  installs the agent's `orchestrate-teams.yaml` as a **companion** of the command
253
253
  (a user-edited config is preserved on uninstall, never silently clobbered).
254
254
  Two artifacts stay **claude-only**: the lifecycle **hooks** (they register into
@@ -20,7 +20,7 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
20
20
  | Envelope CLI | `scripts/coms-cli.ts` | `list` / `send` / `await` / `reply` — any process becomes a coms participant. `send --await` is a blocking round trip; plain `send` prints a `msg_id` and a detached waiter holds the reply for `await`. |
21
21
  | Stop hook | `hooks/coms-stop-hook.mjs` | PRIMARY completion path: writes each turn's final assistant message to `~/.pi/coms/claude-bridge/<pane>/last-message.json` (keyed by `HERDR_PANE_ID`). Exact text, no scraping. |
22
22
  | Skill | `skills/peer-coms/SKILL.md` | Teaches Claude Code its peer role: discover with `coms-cli list`, ask with `send --await`, answer inbound prompts normally, never drive panes itself. |
23
- | Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just team-up` spawns the Claude CLI + its bridge in one pane (`_claude-peer` recipe); `model:` maps to `claude --model`, team-resume maps the herdr-captured session id to `claude --resume`. |
23
+ | Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just fleet team` spawns the Claude CLI + its bridge in one pane (`_claude-peer` internally); `model:` maps to `claude --model`, and `just fleet resume` maps the Herdr-captured session id to `claude --resume`. |
24
24
 
25
25
  ## Setup
26
26
 
@@ -43,7 +43,7 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
43
43
  is a peer and how to use `coms-cli`.
44
44
 
45
45
  3. **Spawn:** either add a `runner: claude-code` peer to a peers.yaml team and
46
- `just team-up <team>`, or attach a bridge to an existing herdr Claude pane:
46
+ `just fleet team <team> --no-hub`, or attach a bridge to an existing Herdr Claude pane:
47
47
 
48
48
  ```bash
49
49
  node --experimental-strip-types scripts/coms-claude-bridge.ts --name claude-main
@@ -53,9 +53,9 @@ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (o
53
53
  ## Demo scenario (verified live)
54
54
 
55
55
  ```bash
56
- just team-up docs # pi peers up
56
+ just fleet team docs --no-hub # Pi peers up
57
57
  # pane with: bridge (claude-main) + claude
58
- just hub # in another pane: the orchestrator
58
+ just fleet hub # in another pane: the orchestrator
59
59
  # from the hub (or any shell):
60
60
  node --experimental-strip-types scripts/coms-cli.ts send claude-main \
61
61
  "Summarize the failing test output in artifacts/test.log" --await --timeout 300000