@chankov/agent-fleet 0.0.5 → 0.0.7

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 (695) hide show
  1. package/.claude/commands/set-hermes-watchdog.md +6 -0
  2. package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  3. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  4. package/.pi/extensions/btw/README.md +10 -10
  5. package/.pi/extensions/btw/index.ts +11 -11
  6. package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
  7. package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
  8. package/.pi/extensions/compact-and-continue/README.md +2 -2
  9. package/.pi/extensions/pi-voice-stt/README.md +7 -7
  10. package/.pi/extensions/pi-voice-stt/index.ts +4 -4
  11. package/.pi/harnesses/agent-hub/README.md +133 -74
  12. package/.pi/harnesses/agent-hub/artifacts.js +56 -2
  13. package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  14. package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
  15. package/.pi/harnesses/agent-hub/context-window.js +106 -0
  16. package/.pi/harnesses/agent-hub/delegate.ts +61 -12
  17. package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
  18. package/.pi/harnesses/agent-hub/helpers.ts +34 -0
  19. package/.pi/harnesses/agent-hub/index.ts +970 -406
  20. package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  21. package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  22. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
  23. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
  24. package/.pi/harnesses/agent-hub/package.json +1 -1
  25. package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  26. package/.pi/harnesses/agent-hub/return-contract.js +78 -0
  27. package/.pi/harnesses/agent-hub/return-extract.js +75 -0
  28. package/.pi/harnesses/agent-hub/run-budget.js +30 -4
  29. package/.pi/harnesses/agent-hub/session-health.js +110 -0
  30. package/.pi/harnesses/agent-hub/spawn.ts +109 -1
  31. package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  32. package/.pi/harnesses/coms/README.md +6 -5
  33. package/.pi/harnesses/coms/index.ts +92 -70
  34. package/.pi/harnesses/coms/package.json +1 -1
  35. package/.pi/harnesses/damage-control-continue/README.md +9 -9
  36. package/.pi/harnesses/damage-control-continue/index.ts +11 -11
  37. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  38. package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  39. package/.pi/harnesses/lib/herdr-client.ts +7 -2
  40. package/.pi/harnesses/lib/herdr-presence.ts +141 -30
  41. package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  42. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  43. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  44. package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
  45. package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
  46. package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  47. package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
  48. package/.versions/0.0.6/.claude/commands/build.md +44 -0
  49. package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
  50. package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
  51. package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
  52. package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
  53. package/.versions/0.0.6/.claude/commands/plan.md +16 -0
  54. package/.versions/0.0.6/.claude/commands/prime.md +22 -0
  55. package/.versions/0.0.6/.claude/commands/review.md +16 -0
  56. package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
  57. package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
  58. package/.versions/0.0.6/.claude/commands/ship.md +72 -0
  59. package/.versions/0.0.6/.claude/commands/spec.md +15 -0
  60. package/.versions/0.0.6/.claude/commands/test.md +19 -0
  61. package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
  62. package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
  63. package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
  64. package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
  65. package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
  66. package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
  67. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  68. package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
  69. package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
  70. package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
  71. package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
  72. package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
  73. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
  74. package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
  75. package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
  76. package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
  77. package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
  78. package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
  79. package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  80. package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
  81. package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
  82. package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
  83. package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
  84. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  85. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  86. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  87. package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
  88. package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
  89. package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
  90. package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
  91. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  92. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  93. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  94. package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  95. package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  96. package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  97. package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  98. package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  99. package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  100. package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
  101. package/.versions/0.0.6/.pi/extensions/package.json +9 -0
  102. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
  103. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  104. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  105. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  106. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  107. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  108. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  109. package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
  110. package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  111. package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
  112. package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  113. package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
  114. package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  115. package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  116. package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
  117. package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
  118. package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
  119. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  120. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  121. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  122. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  123. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  124. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  125. package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  126. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
  127. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  128. package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
  129. package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
  130. package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  131. package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  132. package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
  133. package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
  134. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
  135. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
  136. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  137. package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
  138. package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
  139. package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
  140. package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
  141. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
  142. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  143. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  144. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
  145. package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  146. package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
  147. package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
  148. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  149. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  150. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  151. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  152. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  153. package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
  154. package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
  155. package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
  156. package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
  157. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  158. package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
  159. package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
  160. package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  161. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
  162. package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
  163. package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
  164. package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
  165. package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
  166. package/.versions/0.0.6/.version +1 -0
  167. package/.versions/0.0.6/agents/architect.md +23 -0
  168. package/.versions/0.0.6/agents/bowser.md +26 -0
  169. package/.versions/0.0.6/agents/builder.md +53 -0
  170. package/.versions/0.0.6/agents/code-reviewer.md +205 -0
  171. package/.versions/0.0.6/agents/deep-researcher.md +31 -0
  172. package/.versions/0.0.6/agents/documenter.md +18 -0
  173. package/.versions/0.0.6/agents/orchestrator.md +54 -0
  174. package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
  175. package/.versions/0.0.6/agents/planner.md +69 -0
  176. package/.versions/0.0.6/agents/releaser.md +24 -0
  177. package/.versions/0.0.6/agents/researcher.md +28 -0
  178. package/.versions/0.0.6/agents/security-auditor.md +166 -0
  179. package/.versions/0.0.6/agents/test-engineer.md +151 -0
  180. package/.versions/0.0.6/agents/web-debugger.md +42 -0
  181. package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
  182. package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
  183. package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
  184. package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
  185. package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
  186. package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
  187. package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
  188. package/.versions/0.0.6/docs/getting-started.md +183 -0
  189. package/.versions/0.0.6/docs/npm-install.md +337 -0
  190. package/.versions/0.0.6/docs/opencode-setup.md +249 -0
  191. package/.versions/0.0.6/docs/pi-extensions.md +293 -0
  192. package/.versions/0.0.6/docs/pi-setup.md +476 -0
  193. package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
  194. package/.versions/0.0.6/hermes/README.md +231 -0
  195. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  196. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  197. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  198. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  199. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  200. package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  201. package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  202. package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
  203. package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
  204. package/.versions/0.0.6/hooks/hooks.json +14 -0
  205. package/.versions/0.0.6/hooks/session-start.sh +74 -0
  206. package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
  207. package/.versions/0.0.6/justfile +245 -0
  208. package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
  209. package/.versions/0.0.6/references/definition-of-done.md +67 -0
  210. package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
  211. package/.versions/0.0.6/references/observability-checklist.md +91 -0
  212. package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
  213. package/.versions/0.0.6/references/performance-checklist.md +153 -0
  214. package/.versions/0.0.6/references/prompting-patterns.md +380 -0
  215. package/.versions/0.0.6/references/security-checklist.md +179 -0
  216. package/.versions/0.0.6/references/testing-patterns.md +236 -0
  217. package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
  218. package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
  219. package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
  220. package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
  221. package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
  222. package/.versions/0.0.6/scripts/fleet.ts +141 -0
  223. package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  224. package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
  225. package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
  226. package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
  227. package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
  228. package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
  229. package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  230. package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
  231. package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
  232. package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  233. package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  234. package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  235. package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  236. package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  237. package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  238. package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
  239. package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
  240. package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
  241. package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
  242. package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
  243. package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
  244. package/.versions/0.0.6/scripts/team-up.ts +351 -0
  245. package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
  246. package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
  247. package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  248. package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
  249. package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
  250. package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  251. package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
  252. package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  253. package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  254. package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  255. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
  256. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
  257. package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
  258. package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
  259. package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
  260. package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  261. package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  262. package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
  263. package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
  264. package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
  265. package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
  266. package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
  267. package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
  268. package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
  269. package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
  270. package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
  271. package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  272. package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  273. package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
  274. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  275. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  276. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  277. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  278. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  279. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  280. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  281. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  282. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  283. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  284. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  285. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  286. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  287. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  288. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  289. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  290. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  291. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  292. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  293. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  294. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  295. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  296. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  297. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  298. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  299. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  300. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  301. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  302. package/.versions/0.0.7/.claude/commands/build.md +44 -0
  303. package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
  304. package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
  305. package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
  306. package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
  307. package/.versions/0.0.7/.claude/commands/plan.md +16 -0
  308. package/.versions/0.0.7/.claude/commands/prime.md +22 -0
  309. package/.versions/0.0.7/.claude/commands/review.md +16 -0
  310. package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
  311. package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
  312. package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
  313. package/.versions/0.0.7/.claude/commands/ship.md +72 -0
  314. package/.versions/0.0.7/.claude/commands/spec.md +15 -0
  315. package/.versions/0.0.7/.claude/commands/test.md +19 -0
  316. package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
  317. package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
  318. package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
  319. package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
  320. package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
  321. package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
  322. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  323. package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
  324. package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
  325. package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
  326. package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
  327. package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
  328. package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  329. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
  330. package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
  331. package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
  332. package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
  333. package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
  334. package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
  335. package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  336. package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
  337. package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
  338. package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
  339. package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
  340. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  341. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  342. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  343. package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
  344. package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
  345. package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
  346. package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
  347. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  348. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  349. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  350. package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  351. package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  352. package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  353. package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  354. package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  355. package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  356. package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
  357. package/.versions/0.0.7/.pi/extensions/package.json +9 -0
  358. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
  359. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  360. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  361. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  362. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  363. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  364. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  365. package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
  366. package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  367. package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  368. package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  369. package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  370. package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  371. package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
  372. package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  373. package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  374. package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
  375. package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
  376. package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
  377. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  378. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  379. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  380. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  381. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  382. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  383. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  384. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  385. package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  386. package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  387. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
  388. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  389. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  390. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  391. package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
  392. package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  393. package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  394. package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  395. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
  396. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  397. package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
  398. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
  399. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
  400. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  401. package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
  402. package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
  403. package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
  404. package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
  405. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
  406. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
  407. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  408. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
  409. package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  410. package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  411. package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
  412. package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  413. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  414. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  415. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  416. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  417. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  418. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  419. package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
  420. package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
  421. package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
  422. package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
  423. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  424. package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
  425. package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
  426. package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  427. package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  428. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
  429. package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
  430. package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
  431. package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
  432. package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
  433. package/.versions/0.0.7/.version +1 -0
  434. package/.versions/0.0.7/agents/architect.md +23 -0
  435. package/.versions/0.0.7/agents/bowser.md +26 -0
  436. package/.versions/0.0.7/agents/builder.md +53 -0
  437. package/.versions/0.0.7/agents/code-reviewer.md +205 -0
  438. package/.versions/0.0.7/agents/deep-researcher.md +31 -0
  439. package/.versions/0.0.7/agents/documenter.md +18 -0
  440. package/.versions/0.0.7/agents/orchestrator.md +65 -0
  441. package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
  442. package/.versions/0.0.7/agents/planner.md +69 -0
  443. package/.versions/0.0.7/agents/releaser.md +24 -0
  444. package/.versions/0.0.7/agents/researcher.md +28 -0
  445. package/.versions/0.0.7/agents/security-auditor.md +166 -0
  446. package/.versions/0.0.7/agents/test-engineer.md +151 -0
  447. package/.versions/0.0.7/agents/web-debugger.md +42 -0
  448. package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
  449. package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
  450. package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
  451. package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
  452. package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
  453. package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
  454. package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
  455. package/.versions/0.0.7/docs/getting-started.md +231 -0
  456. package/.versions/0.0.7/docs/npm-install.md +337 -0
  457. package/.versions/0.0.7/docs/opencode-setup.md +249 -0
  458. package/.versions/0.0.7/docs/pi-extensions.md +293 -0
  459. package/.versions/0.0.7/docs/pi-setup.md +476 -0
  460. package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
  461. package/.versions/0.0.7/hermes/README.md +347 -0
  462. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  463. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  464. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  465. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  466. package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
  467. package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  468. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  469. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  470. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  471. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  472. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  473. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  474. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  475. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  476. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  477. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  478. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  479. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  480. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  481. package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  482. package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  483. package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  484. package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  485. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  486. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  487. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  488. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  489. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  490. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  491. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  492. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  493. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  494. package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
  495. package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
  496. package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
  497. package/.versions/0.0.7/hooks/hooks.json +14 -0
  498. package/.versions/0.0.7/hooks/session-start.sh +74 -0
  499. package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
  500. package/.versions/0.0.7/justfile +245 -0
  501. package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
  502. package/.versions/0.0.7/references/definition-of-done.md +67 -0
  503. package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
  504. package/.versions/0.0.7/references/observability-checklist.md +91 -0
  505. package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
  506. package/.versions/0.0.7/references/performance-checklist.md +153 -0
  507. package/.versions/0.0.7/references/prompting-patterns.md +380 -0
  508. package/.versions/0.0.7/references/security-checklist.md +179 -0
  509. package/.versions/0.0.7/references/testing-patterns.md +236 -0
  510. package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
  511. package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
  512. package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
  513. package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
  514. package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
  515. package/.versions/0.0.7/scripts/fleet.ts +149 -0
  516. package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  517. package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  518. package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  519. package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
  520. package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
  521. package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
  522. package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
  523. package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
  524. package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  525. package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
  526. package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
  527. package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  528. package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  529. package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  530. package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  531. package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  532. package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  533. package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  534. package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
  535. package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
  536. package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
  537. package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
  538. package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
  539. package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
  540. package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
  541. package/.versions/0.0.7/scripts/team-up.ts +360 -0
  542. package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
  543. package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
  544. package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  545. package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
  546. package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
  547. package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  548. package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
  549. package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  550. package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  551. package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  552. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
  553. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
  554. package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
  555. package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
  556. package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
  557. package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  558. package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  559. package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
  560. package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
  561. package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
  562. package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
  563. package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
  564. package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
  565. package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
  566. package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
  567. package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
  568. package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  569. package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  570. package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
  571. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  572. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  573. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  574. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  575. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  576. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  577. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  578. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  579. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  580. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  581. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  582. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  583. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  584. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  585. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  586. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  587. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  588. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  589. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  590. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  591. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  592. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  593. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  594. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  595. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  596. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  597. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  598. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  599. package/CHANGELOG.md +140 -0
  600. package/README.md +198 -40
  601. package/agents/code-reviewer.md +2 -2
  602. package/agents/documenter.md +1 -1
  603. package/agents/orchestrator.md +11 -0
  604. package/agents/plan-reviewer.md +1 -1
  605. package/agents/planner.md +1 -1
  606. package/agents/releaser.md +1 -1
  607. package/agents/security-auditor.md +1 -1
  608. package/bin/cli.js +60 -21
  609. package/bin/lib/bootstrap.js +16 -16
  610. package/bin/lib/doctor.js +1 -1
  611. package/bin/lib/hermes-profile-artifact.js +144 -0
  612. package/bin/lib/set-hermes-watchdog.js +173 -0
  613. package/bin/set-hermes-watchdog.js +26 -0
  614. package/docs/ARCHITECTURE.md +67 -15
  615. package/docs/agent-fleet-setup.md +13 -13
  616. package/docs/claude-code-coms-bridge.md +7 -1
  617. package/docs/coms-hermes-bridge.md +18 -8
  618. package/docs/getting-started.md +48 -0
  619. package/docs/hermes-watchdog-supervisor.md +140 -0
  620. package/docs/npm-install.md +21 -21
  621. package/docs/pi-extensions.md +7 -7
  622. package/docs/pi-setup.md +51 -47
  623. package/hermes/README.md +135 -19
  624. package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  625. package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  626. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  627. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  628. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  629. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  630. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  631. package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  632. package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  633. package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  634. package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  635. package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  636. package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  637. package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  638. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  639. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  640. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  641. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  642. package/hermes/skills/hub-watchdog/SKILL.md +76 -0
  643. package/hermes/skills/hub-watchdog/manifest.json +1 -0
  644. package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  645. package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  646. package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  647. package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  648. package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  649. package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  650. package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  651. package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  652. package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  653. package/hooks/coms-stop-hook.mjs +12 -1
  654. package/package.json +11 -2
  655. package/references/fleet-coordination-patterns.md +2 -2
  656. package/scripts/coms-claude-bridge.ts +154 -39
  657. package/scripts/fleet.ts +9 -1
  658. package/scripts/hermes-watchdog-capability-probe.ts +45 -0
  659. package/scripts/lib/claude-bridge-core.ts +65 -0
  660. package/scripts/lib/coms-envelope.ts +44 -1
  661. package/scripts/lib/hermes-monitor-events.ts +1 -0
  662. package/scripts/lib/monitor-env.ts +120 -0
  663. package/scripts/team-snapshot.ts +1 -1
  664. package/scripts/team-up.ts +10 -1
  665. package/skills/browser-testing-with-devtools/SKILL.md +1 -1
  666. package/skills/compound-learning/SKILL.md +3 -3
  667. package/skills/guided-workspace-setup/SKILL.md +16 -14
  668. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  669. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  670. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  671. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  672. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  673. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  674. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  675. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  676. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  677. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  678. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  679. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  680. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  681. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  682. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  683. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  684. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  685. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  686. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  687. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  688. /package/.pi/prompts/{build.md → af-build.md} +0 -0
  689. /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
  690. /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
  691. /package/.pi/prompts/{review.md → af-review.md} +0 -0
  692. /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
  693. /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
  694. /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
  695. /package/.pi/prompts/{test.md → af-test.md} +0 -0
@@ -7,6 +7,71 @@
7
7
 
8
8
  export const SENTINEL_PREFIX = "<<COMS_DONE:";
9
9
 
10
+ // ── reply-timeout and idle-wait policy ──
11
+ //
12
+ // Two field failures live here. First, the bridge only ever read its own
13
+ // --reply-timeout: a caller that asked for 1_800_000ms was still told "no reply
14
+ // within 600000ms", so a review that honestly takes more than ten minutes could
15
+ // not succeed at all. Second, a pane that was mid-turn threw instantly, which
16
+ // turned every busy moment into a hard error — ten of eighteen coms_await calls
17
+ // in one session died that way, the caller hot-retried every few seconds, and
18
+ // then fell back to reading the pane 127 times to watch progress by hand.
19
+
20
+ /** No caller may hold a pane hostage indefinitely. */
21
+ export const REPLY_TIMEOUT_HARD_CAP_MS = 3_600_000;
22
+
23
+ /** Backoff while waiting for a busy pane, in ms; the last step repeats. */
24
+ export const IDLE_WAIT_BACKOFF_MS = [2_000, 4_000, 8_000, 15_000, 30_000];
25
+
26
+ /** Longest we will ever wait for a pane to go idle before giving up. */
27
+ export const IDLE_WAIT_CAP_MS = 120_000;
28
+
29
+ /**
30
+ * The caller's own deadline wins — it knows how long the work takes — falling
31
+ * back to the bridge's configured timeout and always clamped to the hard cap.
32
+ */
33
+ export function resolveReplyTimeoutMs(requested: unknown, fallbackMs: number, capMs = REPLY_TIMEOUT_HARD_CAP_MS): number {
34
+ const asked = Number(requested);
35
+ const base = Number.isFinite(asked) && asked > 0 ? asked : fallbackMs;
36
+ return Math.max(1, Math.min(base, capMs));
37
+ }
38
+
39
+ /** One absolute deadline shared by idle waiting and reply collection. */
40
+ export function replyDeadlineAt(startedAtMs: number, timeoutMs: number): number {
41
+ return Number(startedAtMs) + Math.max(0, Number(timeoutMs) || 0);
42
+ }
43
+
44
+ /**
45
+ * The pane accepted the prompt but did not finish inside the caller's budget.
46
+ * This is deliberately not a response error: the work may still complete.
47
+ */
48
+ export class ReplyPendingError extends Error {
49
+ readonly pending = true;
50
+ constructor(message: string) {
51
+ super(message);
52
+ this.name = "ReplyPendingError";
53
+ }
54
+ }
55
+
56
+ export function isReplyPendingError(error: unknown): error is ReplyPendingError {
57
+ return error instanceof ReplyPendingError || Boolean((error as { pending?: unknown } | null)?.pending);
58
+ }
59
+
60
+ /** Backoff delay for the nth idle-wait attempt (0-based); the last step repeats. */
61
+ export function idleWaitDelayMs(attempt: number): number {
62
+ const i = Math.max(0, Math.min(Math.floor(attempt), IDLE_WAIT_BACKOFF_MS.length - 1));
63
+ return IDLE_WAIT_BACKOFF_MS[i];
64
+ }
65
+
66
+ /**
67
+ * How long to wait for a busy pane. Never more than half the caller's reply
68
+ * budget — waiting to start must not consume the time meant for the answer.
69
+ */
70
+ export function idleWaitBudgetMs(replyTimeoutMs: number, capMs = IDLE_WAIT_CAP_MS): number {
71
+ const half = Math.floor((Number(replyTimeoutMs) || 0) / 2);
72
+ return Math.max(0, Math.min(capMs, half));
73
+ }
74
+
10
75
  export function completionSentinel(msgId: string): string {
11
76
  return `${SENTINEL_PREFIX}${msgId}>>`;
12
77
  }
@@ -63,6 +63,12 @@ export interface PromptEnvelope {
63
63
  sender_cwd: string;
64
64
  conversation_id?: string | null;
65
65
  response_schema?: object | null;
66
+ /**
67
+ * How long the sender is prepared to wait, in ms. A receiver that drives an
68
+ * interactive agent uses this instead of its own default — otherwise a caller
69
+ * asking for 30 minutes is still failed at the bridge's 10-minute default.
70
+ */
71
+ reply_timeout_ms?: number | null;
66
72
  }
67
73
 
68
74
  export interface ResponseEnvelope {
@@ -85,6 +91,38 @@ export interface CancelEnvelope {
85
91
  ref_msg_id: string;
86
92
  }
87
93
 
94
+ /**
95
+ * How addressable a peer is right now.
96
+ * idle — will pick up a `coms_send` immediately
97
+ * working — mid-turn (or blocked on its own permission prompt); a send waits
98
+ * booting — registered, but nothing has reported a live state yet
99
+ *
100
+ * Published so a sender can check before sending instead of screen-scraping the
101
+ * pane: the session behind this change issued 127 `herdr_read_pane` calls
102
+ * substituting for this one missing field.
103
+ */
104
+ export type PeerStatus = "idle" | "working" | "booting";
105
+
106
+ const PANE_STATUS_WORKING = new Set(["working", "blocked"]);
107
+ const PANE_STATUS_IDLE = new Set(["idle", "done", "ready"]);
108
+
109
+ /**
110
+ * Map a herdr pane's `agent_status` onto a peer status. Anything unrecognised —
111
+ * including the "unknown" herdr reports for a pane whose agent has not checked
112
+ * in — is `booting`: not addressable yet, but not a failure either.
113
+ */
114
+ export function paneAgentStatusToPeerStatus(agentStatus: string | null | undefined): PeerStatus {
115
+ const s = String(agentStatus ?? "").trim().toLowerCase();
116
+ if (PANE_STATUS_WORKING.has(s)) return "working";
117
+ if (PANE_STATUS_IDLE.has(s)) return "idle";
118
+ return "booting";
119
+ }
120
+
121
+ /** Display form; a peer that never answered the ping has no status of its own. */
122
+ export function peerStatusLabel(status: PeerStatus | null | undefined): string {
123
+ return status ?? "unreachable";
124
+ }
125
+
88
126
  export interface AgentCard {
89
127
  name: string;
90
128
  purpose: string;
@@ -92,6 +130,10 @@ export interface AgentCard {
92
130
  color: string;
93
131
  context_used_pct: number;
94
132
  queue_depth: number;
133
+ /** herdr pane hosting this peer, when it runs in one. */
134
+ pane_id?: string | null;
135
+ /** Addressability right now — see PeerStatus. Absent on pre-status peers. */
136
+ status?: PeerStatus;
95
137
  }
96
138
 
97
139
  export interface RegistryEntry {
@@ -161,7 +203,7 @@ export interface SenderIdentity {
161
203
  export function makePromptEnvelope(
162
204
  from: SenderIdentity,
163
205
  prompt: string,
164
- opts: { hops?: number; response_schema?: object | null } = {},
206
+ opts: { hops?: number; response_schema?: object | null; reply_timeout_ms?: number | null } = {},
165
207
  ): PromptEnvelope {
166
208
  return {
167
209
  type: "prompt",
@@ -175,6 +217,7 @@ export function makePromptEnvelope(
175
217
  sender_cwd: from.cwd,
176
218
  conversation_id: null,
177
219
  response_schema: opts.response_schema ?? null,
220
+ reply_timeout_ms: opts.reply_timeout_ms ?? null,
178
221
  };
179
222
  }
180
223
 
@@ -0,0 +1 @@
1
+ export * from "../../.pi/harnesses/lib/hermes-monitor-events.ts";
@@ -0,0 +1,120 @@
1
+ /**
2
+ * The two variables that decide whether a hub is monitored at all.
3
+ *
4
+ * `monitorLifecycleConfig()` (.pi/harnesses/agent-hub/monitor-lifecycle.ts)
5
+ * returns `null` unless BOTH `AGENT_FLEET_PROFILE_ID` and an absolute
6
+ * `AGENT_FLEET_MONITOR_RUNTIME_DIR` are in the hub's environment. Until this
7
+ * module existed the only thing that set them was a manual `export` copied out
8
+ * of hermes/README.md, so in practice the monitor never started and its whole
9
+ * transport — task tree, live output, per-generation cancel — was dead code
10
+ * with a test suite.
11
+ *
12
+ * Two rules the rest of the file exists to hold:
13
+ *
14
+ * 1. An operator who already exported the variables wins. This never
15
+ * overwrites a value that is already set, so the README recipe and a
16
+ * systemd unit keep working exactly as documented.
17
+ * 2. A runtime directory we cannot make private is not used. The Python
18
+ * reader refuses any root that is not mode 0700 (adapter.py), and it is
19
+ * right to: the directory holds one bearer token per live hub. Rather
20
+ * than hand it a path it will reject, `resolveMonitorEnv` returns null
21
+ * and the hub runs unmonitored — the pre-existing behaviour, reached
22
+ * honestly.
23
+ */
24
+
25
+ import * as fs from "node:fs";
26
+ import * as os from "node:os";
27
+ import * as path from "node:path";
28
+
29
+ /** Mirrors the profile-ID class in monitor-lifecycle.ts and adapter.py. All
30
+ * three must agree, because the runtime namespace is `sha256(profileId)` and a
31
+ * value one end accepts and another rejects is an empty directory listing with
32
+ * no error anywhere. */
33
+ export const PROFILE_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
34
+
35
+ /** The Hermes profile the fleet plugins are installed in. `dev` rather than
36
+ * `default` by the 2026-07-27 decision recorded in the observability plan —
37
+ * the panel is a dev-profile tool, and the monitor has to land in the same
38
+ * profile or the discovery glob looks in the wrong namespace. */
39
+ export const DEFAULT_PROFILE_ID = "dev";
40
+
41
+ export const RUNTIME_DIR_NAME = "agent-fleet-monitor";
42
+
43
+ export interface MonitorEnv {
44
+ AGENT_FLEET_PROFILE_ID: string;
45
+ AGENT_FLEET_MONITOR_RUNTIME_DIR: string;
46
+ }
47
+
48
+ /** Where the runtime root goes, before anything is created.
49
+ *
50
+ * `XDG_RUNTIME_DIR` is the right answer and the one the README documents: it
51
+ * is already per-user, already 0700, and already cleaned up at logout. The
52
+ * tmpdir fallback exists for the sessions that have no such variable (a bare
53
+ * ssh login, a container), and carries the uid in its name so two users on one
54
+ * machine never race for the same path. */
55
+ export function monitorRuntimeRoot(env: NodeJS.ProcessEnv = process.env): string {
56
+ const xdg = env.XDG_RUNTIME_DIR;
57
+ if (xdg && path.isAbsolute(xdg)) return path.join(xdg, RUNTIME_DIR_NAME);
58
+ const uid = typeof process.getuid === "function" ? process.getuid() : 0;
59
+
60
+ return path.join(os.tmpdir(), `${RUNTIME_DIR_NAME}-${uid}`);
61
+ }
62
+
63
+ /** Create the runtime root 0700, or say why it cannot be trusted.
64
+ *
65
+ * The mode is re-asserted on a directory that already exists because the
66
+ * `mode` argument to mkdir is a no-op for an existing path and is masked by
67
+ * umask for a new one — checking after the fact is the only way to know. A
68
+ * symlink is refused outright rather than followed: the whole point of the
69
+ * directory is that its contents are only reachable by this user, and a
70
+ * symlink means somebody else chose the destination. */
71
+ export function ensureMonitorRuntimeDir(dir: string, io: {
72
+ mkdirSync?: typeof fs.mkdirSync;
73
+ lstatSync?: typeof fs.lstatSync;
74
+ chmodSync?: typeof fs.chmodSync;
75
+ } = {}): string | null {
76
+ const mkdir = io.mkdirSync ?? fs.mkdirSync;
77
+ const lstat = io.lstatSync ?? fs.lstatSync;
78
+ const chmod = io.chmodSync ?? fs.chmodSync;
79
+ if (!path.isAbsolute(dir)) return null;
80
+ try {
81
+ mkdir(dir, { recursive: true, mode: 0o700 });
82
+ const stat = lstat(dir);
83
+ if (stat.isSymbolicLink() || !stat.isDirectory()) return null;
84
+ if ((stat.mode & 0o777) !== 0o700) {
85
+ chmod(dir, 0o700);
86
+ if ((lstat(dir).mode & 0o777) !== 0o700) return null;
87
+ }
88
+
89
+ return dir;
90
+ } catch {
91
+ return null;
92
+ }
93
+ }
94
+
95
+ /** The variables to add to a hub's environment, or null to leave it unmonitored.
96
+ *
97
+ * Null is a normal outcome, not a failure: `AGENT_FLEET_MONITOR=0` is the
98
+ * documented opt-out, and an unusable runtime directory reaches the same
99
+ * result. Callers merge the answer and carry on either way — a hub that
100
+ * cannot be monitored still orchestrates. */
101
+ export function resolveMonitorEnv(
102
+ env: NodeJS.ProcessEnv = process.env,
103
+ ensure: (dir: string) => string | null = ensureMonitorRuntimeDir,
104
+ ): MonitorEnv | null {
105
+ if (env.AGENT_FLEET_MONITOR === "0") return null;
106
+
107
+ const profileId = env.AGENT_FLEET_PROFILE_ID?.trim() || DEFAULT_PROFILE_ID;
108
+ if (!PROFILE_ID_RE.test(profileId) || profileId.includes("..")) return null;
109
+
110
+ const requested = env.AGENT_FLEET_MONITOR_RUNTIME_DIR?.trim();
111
+ // An explicit path is honoured as given — including a rejection, which is
112
+ // louder than silently relocating somebody's deliberate choice.
113
+ const root = requested ? (path.isAbsolute(requested) ? requested : null) : monitorRuntimeRoot(env);
114
+ if (!root) return null;
115
+
116
+ const runtimeDir = ensure(root);
117
+ if (!runtimeDir) return null;
118
+
119
+ return { AGENT_FLEET_PROFILE_ID: profileId, AGENT_FLEET_MONITOR_RUNTIME_DIR: runtimeDir };
120
+ }
@@ -93,7 +93,7 @@ async function captureSnapshot(client: Client, team: string, project = DEFAULT_P
93
93
  if (!fs.existsSync(PEERS_YAML)) die(`peers.yaml not found at ${PEERS_YAML}`);
94
94
  const teams = parsePeersYaml(fs.readFileSync(PEERS_YAML, "utf-8"));
95
95
  const peers = teams[team];
96
- if (!peers || peers.length === 0) die(`Team "${team}" not found in peers.yaml.`);
96
+ if (!peers) die(`Team "${team}" not found in peers.yaml.`);
97
97
 
98
98
  const { panes } = await client.herdr.paneList({ workspace_id: ws.workspace_id });
99
99
  const { agents } = await client.herdr.agentList();
@@ -34,6 +34,7 @@ import {
34
34
  type LayoutNode,
35
35
  type Peer,
36
36
  } from "./lib/herdr-layout.ts";
37
+ import { resolveMonitorEnv } from "./lib/monitor-env.ts";
37
38
  import { planSpawnDelays } from "./lib/spawn-stagger.ts";
38
39
  import {
39
40
  DEFAULT_PROJECT,
@@ -249,14 +250,22 @@ async function main(): Promise<void> {
249
250
  } catch (err) {
250
251
  die(err instanceof Error ? err.message : String(err));
251
252
  }
253
+ // The hub pane is spawned BY herdr, whose daemon was started at some other
254
+ // time from some other shell — so unlike `just fleet hub`, it inherits
255
+ // nothing from this process. The monitor variables have to travel as pane
256
+ // env or the one launcher most likely to want a task tree is the one that
257
+ // never gets one. Peers deliberately do not receive them: only agent-hub
258
+ // reads them, and a peer is not a hub.
259
+ const monitorEnv = dryRun ? null : resolveMonitorEnv();
252
260
  const rootPane = hub
253
261
  ? {
254
262
  command: hubCommand(project, { browser: hubBrowser, allExtensions: hubAllExtensions }),
255
263
  label: "hub",
256
264
  ratio: HUB_RATIO,
265
+ ...(monitorEnv ? { env: monitorEnv } : {}),
257
266
  }
258
267
  : spec
259
- ? { command: spec.command, label: spec.paneLabel, ratio: spec.ratio, cwd: spec.cwd, env: spec.env }
268
+ ? { command: spec.command, label: spec.paneLabel, ratio: spec.ratio, cwd: spec.cwd, env: { ...spec.env, ...(monitorEnv ?? {}) } }
260
269
  : undefined;
261
270
 
262
271
  if (dryRun) {
@@ -75,7 +75,7 @@ ln -s /path/to/agent-fleet/.pi/extensions/mcp-bridge .pi/extensions/mcp
75
75
  ln -s /path/to/agent-fleet/.pi/extensions/chrome-devtools-mcp .pi/extensions/chrome-devtools-mcp
76
76
  ```
77
77
 
78
- After install, run `/chrome_devtools-status` inside pi to confirm the bridge connected.
78
+ After install, run `/af-chrome-devtools-status` inside pi to confirm the bridge connected.
79
79
 
80
80
  ### Available Tools
81
81
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: compound-learning
3
- description: Captures a finished session's lessons into the project's own rules and docs — extracts candidate lessons from session evidence, dedupes them against the existing rule tree, and lands them as minimal diffs on existing files. Use when a session ends with user corrections, recurring review findings, or debugging root causes worth keeping, when the user says "compound" or "capture the lessons", or as the documenter's process for a /compound dispatch.
3
+ description: Captures a finished session's lessons into the project's own rules and docs — extracts candidate lessons from session evidence, dedupes them against the existing rule tree, and lands them as minimal diffs on existing files. Use when a session ends with user corrections, recurring review findings, or debugging root causes worth keeping, when the user says "compound" or "capture the lessons", or as the documenter's process for a /compound or /af-compound dispatch.
4
4
  ---
5
5
 
6
6
  # Compound Learning
@@ -16,7 +16,7 @@ The enemy is not missing lessons — it is **bloat**. A rule tree that grows by
16
16
  ## When to Use
17
17
 
18
18
  - A session is wrapping up and it contained at least one correction, recurring finding, or hard-won discovery.
19
- - The user says "compound", "capture the lessons", "update the rules from this session", or runs a `/compound` command.
19
+ - The user says "compound", "capture the lessons", "update the rules from this session", or runs a `/compound` or `/af-compound` command.
20
20
  - You are the `documenter` persona dispatched with a compound task by the agent-hub dispatcher.
21
21
  - Periodically, as a **consolidation pass** over a rule tree that has accumulated additions (see Step 8).
22
22
 
@@ -32,7 +32,7 @@ The enemy is not missing lessons — it is **bloat**. A rule tree that grows by
32
32
  | Session diff | `git diff` / `git log` for the session's commits |
33
33
  | agent-hub artifacts | `.pi/agent-sessions/artifacts/{returns,reviews,plans,inventories,evidence}/` — specialist returns and review findings |
34
34
  | agent-hub assertion ledger | `.pi/agent-sessions/assertions.json` — which assertions failed first and why |
35
- | Dispatch brief | A `/compound` dispatch carries a candidate-lessons brief composed by the dispatcher — treat it as *candidates*, not conclusions |
35
+ | Dispatch brief | A `/compound` or `/af-compound` dispatch carries a candidate-lessons brief composed by the dispatcher — treat it as *candidates*, not conclusions |
36
36
 
37
37
  **Targets** — from `.ai/agent-fleet-overrides.md`, section `## agent-hub` (legacy `## agent-team`):
38
38
 
@@ -67,7 +67,7 @@ Target map, relative to the workspace root:
67
67
  |---|---|---|---|
68
68
  | Skills | `.claude/skills/<name>/` | per `docs/opencode-setup.md` | `.pi/skills/<name>/` |
69
69
  | Personas | `.claude/agents/<name>.md` *(generated)* | `.opencode/agent/<name>.md` *(generated)* | `agents/<name>.md` |
70
- | Commands / prompts | `.claude/commands/<name>.md` | `.opencode/commands/af-<name>.md` | `.pi/prompts/<name>.md` |
70
+ | Commands / prompts | `.claude/commands/<name>.md` | `.opencode/commands/af-<name>.md` | `.pi/prompts/af-<name>.md` |
71
71
  | `/orchestrate` team config *(companion of the `orchestrate` command)* | `.claude/orchestrate-teams.yaml` | `.opencode/orchestrate-teams.yaml` | — |
72
72
  | References | `.claude/references/<name>.md` | per `docs/opencode-setup.md` | per `docs/pi-setup.md` |
73
73
  | Hooks *(claude-code only)* | `.claude/hooks/<name>`, registered in `.claude/settings.json` | — | — |
@@ -134,7 +134,7 @@ Present the findings per the Step 1 interaction contract. **Widget mode:** print
134
134
 
135
135
  Either way, apply only the picked fixes; record skipped items so the install menu can surface them again. Append a `## doctor-runs` line to `.ai/agent-fleet-setup.md` with the date, agent, phase (`preflight`), and `repaired` / `deleted` / `skipped` counts.
136
136
 
137
- The doctor scan is also exposed standalone as `/doctor-agent-fleet` — running it outside a setup pass is this same scan-and-repair flow without the rest of the install menu.
137
+ The doctor scan is also exposed standalone as `/doctor-agent-fleet` on Claude Code or `/af-doctor-agent-fleet` on Pi/OpenCode — running it outside a setup pass is this same scan-and-repair flow without the rest of the install menu.
138
138
 
139
139
  ### 5b. Bootstrap `pi-ask-user` first (pi only)
140
140
 
@@ -150,7 +150,7 @@ From the Step 4 analysis, determine whether `pi-ask-user` is already available:
150
150
  2. Ask for confirmation (this is the one pre-Step-9 write, per the gating exception). If declined, fall back to the tabular mode and continue to Step 6 in this same pass — do **not** force the install.
151
151
  3. On confirm, run `pi install -l npm:pi-ask-user` (project-scoped). Mention `pi install npm:pi-ask-user` only if the user explicitly wants a global pin.
152
152
  4. Record the package under the `external-pi-packages` / `project-packages` line in `.ai/agent-fleet-setup.md` (same convention as Step 6's external-package handling) — do not copy files from `node_modules`.
153
- 5. **Stop the pass here.** Print: *"`pi-ask-user` installed. Reload pi (restart the session or `/reload`), then re-run `/setup-agent-fleet` — the menu will then use native multi-select. Nothing else has been written to your workspace."* Do not continue to Step 6 on this pass: the tool only becomes callable after the reload.
153
+ 5. **Stop the pass here.** Print: *"`pi-ask-user` installed. Reload pi (restart the session or `/reload`), then re-run `/af-setup-agent-fleet` — the menu will then use native multi-select. Nothing else has been written to your workspace."* Do not continue to Step 6 on this pass: the tool only becomes callable after the reload.
154
154
 
155
155
  On the **re-run**, Step 4 finds `pi-ask-user` installed, this step is a no-op, and Step 6 runs on native `ask_user` screens. In Step 6's External-pi-packages group, the already-installed `pi-ask-user` simply counts toward `Keep as-is` (`installed · project package`) — the bootstrap is not repeated. Do **not** bootstrap other external pi packages here; optional suggestions such as `pi-codex-image-gen` are offered only in Group 7 and installed only when the user selects them.
156
156
 
@@ -201,13 +201,15 @@ Then ask a single-select with `displayMode: "inline"` (so the printed diff stays
201
201
  |---|---|---|---|
202
202
  | Skills | `skills/<name>/SKILL.md`, else `vendor/agent-skills-upstream/skills/<name>/SKILL.md` | `skills/<name>/SKILL.md`, else `vendor/agent-skills-upstream/skills/<name>/SKILL.md` | `skills/<name>/SKILL.md`, else `vendor/agent-skills-upstream/skills/<name>/SKILL.md` |
203
203
  | Personas | `agents/<name>.md` | `agents/<name>.md` | `agents/<name>.md` |
204
- | Commands / prompts | `.claude/commands/<name>.md` | `.opencode/commands/af-<name>.md` | `.pi/prompts/<name>.md` |
204
+ | Commands / prompts | `.claude/commands/<name>.md` | `.opencode/commands/af-<name>.md` | `.pi/prompts/af-<name>.md` |
205
205
  | `/orchestrate` team config | `.claude/orchestrate-teams.yaml` | `.opencode/orchestrate-teams.yaml` | — |
206
206
  | pi extensions / harnesses / runtime skills | — | — | `.pi/extensions/<name>/`, `.pi/harnesses/<name>/`, `.pi/skills/<name>/` |
207
207
  | References | source files in `references/` (all agents) |
208
208
  | Hooks | source files in `hooks/` | — | — |
209
209
 
210
- If the per-agent source is missing, the row is **not shown** — never silently fall back to a different agent's tree (for example: do not symlink `.claude/commands/design-agent.md` from `.pi/prompts/design-agent.md` when the agent is `pi`). When the user explicitly asks for an item the source lacks for their agent, say so plainly and stop; the answer is to author the missing source file first, not to cross-link runtimes.
210
+ If the per-agent source is missing, the row is **not shown** — never silently fall back to a different agent's tree (for example: do not symlink `.claude/commands/design-agent.md` from `.pi/prompts/af-design-agent.md` when the agent is `pi`). When the user explicitly asks for an item the source lacks for their agent, say so plainly and stop; the answer is to author the missing source file first, not to cross-link runtimes.
211
+
212
+ **Pi `/af-*` migration.** Pi prompt templates formerly used unprefixed `.pi/prompts/<name>.md` targets. During status/apply, when a selected or recorded Agent Fleet command has that legacy target, migrate it to `.pi/prompts/af-<name>.md` and remove the old target only when it is recorded in `## install-status` and unchanged against the recorded-version snapshot, or is a symlink resolving into the Agent Fleet source. Preserve user-modified and unowned legacy files as conflicts/skips; never delete a same-named custom prompt merely to enforce the namespace. The bootstrap handles the same migration for its setup/doctor prompts before this skill runs.
211
213
 
212
214
  Groups, in order. Groups 1–4 apply to every agent; groups 5–7 are shown **only when the agent is `pi`**.
213
215
 
@@ -218,7 +220,7 @@ Groups, in order. Groups 1–4 apply to every agent; groups 5–7 are shown **on
218
220
  - *Review* — `code-review-and-quality` ★, `code-simplification`, `security-and-hardening`, `performance-optimization`
219
221
  - *Ship* — `git-workflow-and-versioning` ★, `ci-cd-and-automation`, `deprecation-and-migration`, `documentation-and-adrs`, `shipping-and-launch`
220
222
  - *Orchestrate* — `orchestration-verification` ★ *(the Verification Contract enforced by the `orchestrator` persona + agent-hub harness; also read by the `builder`/`test-engineer`/`code-reviewer` personas for their structured returns, so recommend it whenever any of those personas or the `orchestrate` command is selected)*
221
- - *Learn* — `compound-learning` ★ *(the end-of-session compound pass — session lessons landed as deduped, capped diffs on the project's `rules:`/`docs:` targets; read by the `documenter` persona for `/compound` dispatches and by the `compound` command, so recommend it whenever either of those is selected)*
223
+ - *Learn* — `compound-learning` ★ *(the end-of-session compound pass — session lessons landed as deduped, capped diffs on the project's `rules:`/`docs:` targets; read by the `documenter` persona for `/compound` or `/af-compound` dispatches and by the `compound` command, so recommend it whenever either of those is selected)*
222
224
  - *Meta* — `using-agent-skills` ★, `designing-agents` *(`guided-workspace-setup` is installer-only — never offered)*
223
225
 
224
226
  **Internal skill companions.** `skills/_internal/grilling.md` is not a menu row and has no `SKILL.md`; it is a shared helper for `idea-refine`, `spec-driven-development`, and `planning-and-task-breakdown`. Whenever any of those three skills is installed, kept, refreshed, or removed, apply the helper as a sibling at `<skills-target>/_internal/grilling.md` using the same copy/symlink method, record it as a companion rather than a selected skill, and keep it while any installed parent skill still references it.
@@ -229,7 +231,7 @@ Groups, in order. Groups 1–4 apply to every agent; groups 5–7 are shown **on
229
231
  - *pi-only* *(shown only when the agent is `pi`)* — `bowser`, `web-debugger`, `orchestrator`
230
232
 
231
233
  For `claude-code`/`opencode`, installed rows are **generated artifacts** (see Step 3): record them with `transformed: true` in `## install-status`, and compute their status by comparing the installed file against `transform(current source)` — and for upgrades against `transform(.versions/<recorded>/agents/<name>.md)` — never against the raw canonical source, whose bytes legitimately differ from the generated output.
232
- 3. **Commands / prompts** *(single-type — no sub-category)* — mapped to the chosen agent; items without a per-agent source are filtered out, no cross-tool substitution. Full candidate list: `spec` ★, `plan` ★, `build` ★, `test` ★, `review` ★, `orchestrate` ★, `compound`, `code-simplify`, `ship`, `design-agent`, `prime`, `set-hermes-telegram`. The actual menu shows only items whose per-agent source file exists — for example, `.pi/prompts/design-agent.md` and `.pi/prompts/prime.md` are absent, so neither is offered when the agent is `pi`; and `orchestrate` has a source for `claude-code` (`.claude/commands/orchestrate.md`) and `opencode` (`.opencode/commands/af-orchestrate.md`) but **not** `pi` (no `.pi/prompts/orchestrate.md`), so the existing source-availability filter surfaces it for claude-code + opencode and hides it for pi automatically. `compound` follows the same pattern (`.claude/commands/compound.md` / `.opencode/commands/af-compound.md`, no pi prompt — the agent-hub harness ships its own `/compound` command); when `compound` is selected, recommend the `compound-learning` skill alongside it. *(`setup` and `doctor` are installer-only — never offered, since they live in the source agent-fleet repo and act on target workspaces from there.)*
234
+ 3. **Commands / prompts** *(single-type — no sub-category)* — mapped to the chosen agent; items without a per-agent source are filtered out, no cross-tool substitution. Full candidate list: `spec` ★, `plan` ★, `build` ★, `test` ★, `review` ★, `orchestrate` ★, `compound`, `code-simplify`, `ship`, `design-agent`, `prime`, `set-hermes-telegram`. The actual menu shows only items whose per-agent source file exists — for example, `.pi/prompts/af-design-agent.md` and `.pi/prompts/af-prime.md` are absent, so neither is offered when the agent is `pi`; and `orchestrate` has a source for `claude-code` (`.claude/commands/orchestrate.md`) and `opencode` (`.opencode/commands/af-orchestrate.md`) but **not** `pi` (no `.pi/prompts/af-orchestrate.md`), so the existing source-availability filter surfaces it for claude-code + opencode and hides it for pi automatically. `compound` follows the same pattern (`.claude/commands/compound.md` / `.opencode/commands/af-compound.md`, no pi prompt — the agent-hub harness ships its own `/af-compound` command); when `compound` is selected, recommend the `compound-learning` skill alongside it. *(`setup` and `doctor` are installer-only — never offered, since they live in the source agent-fleet repo and act on target workspaces from there.)*
233
235
 
234
236
  **`orchestrate` carries a team-config companion.** `orchestrate-teams.yaml` (the named-team roster the `/orchestrate` command reads) is not its own menu row — it is a companion of the `orchestrate` command (same idea as the pi harness `justfile` companion). Whenever `orchestrate` is installed/kept/removed, install/remove the agent's team config from source in the same pass — `.claude/orchestrate-teams.yaml` for claude-code, `.opencode/orchestrate-teams.yaml` for opencode. Treat it as a normal versioned artifact for the Step 6 status tokens: a user-edited copy is `mod`/`cflt` and gets the three-way-diff treatment, never a silent clobber of their team definitions. **Removal safety:** when `orchestrate` is removed, the team config is removed **only** if it still matches the shipped source (unedited); a user-edited `orchestrate-teams.yaml` is preserved and listed under "Skipped — user-modified" rather than deleted, so custom team definitions survive an uninstall.
235
237
  4. **References & Hooks** *(sub-category = `reference` / `hook`)* — one group for the shared non-agent-specific artifacts:
@@ -356,7 +358,7 @@ Target paths are deterministic from the per-agent source map, so omit them from
356
358
 
357
359
  **The confirm question.** Then confirm with **one single-select**, asked with `displayMode: "inline"` so the printed plan stays visible:
358
360
 
359
- - `Apply — and remove the installer commands` *(the default; the installer files are `/setup-agent-fleet` and `/doctor-agent-fleet` — the `/af-*` variants for OpenCode — plus the `guided-workspace-setup` skill body; they can be restored later with `npx @chankov/agent-fleet init`)*
361
+ - `Apply — and remove the installer commands` *(the default; the installer files are `/setup-agent-fleet` and `/doctor-agent-fleet` on Claude Code, or the `/af-*` variants on Pi/OpenCode — plus the `guided-workspace-setup` skill body; they can be restored later with `npx @chankov/agent-fleet init`)*
360
362
  - `Apply — keep the installer commands` *(records `keep-installer: true` in `## workspace-summary` and skips Step 10b)*
361
363
  - `Adjust picks` *(the freeform reply names the group(s) to revisit; reopen only those quick screens, then re-print the plan and re-confirm)*
362
364
  - `Cancel — write nothing`
@@ -395,7 +397,7 @@ Default behaviour:
395
397
  | Agent | Files removed |
396
398
  |---|---|
397
399
  | `claude-code` | `.claude/commands/setup-agent-fleet.md`, `.claude/commands/doctor-agent-fleet.md`, `.claude/skills/guided-workspace-setup/SKILL.md` |
398
- | `pi` | `.pi/prompts/setup-agent-fleet.md`, `.pi/prompts/doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
400
+ | `pi` | `.pi/prompts/af-setup-agent-fleet.md`, `.pi/prompts/af-doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
399
401
  | `opencode` | `.opencode/commands/af-setup-agent-fleet.md`, `.opencode/commands/af-doctor-agent-fleet.md`, `.opencode/skills/guided-workspace-setup/SKILL.md` |
400
402
 
401
403
  After deleting, prune any directories that were created solely for these files (e.g. `.claude/skills/guided-workspace-setup/`) — never prune a directory that contains other files.
@@ -406,12 +408,12 @@ If `cleanupInstaller` is available via the CLI (`npx @chankov/agent-fleet cleanu
406
408
 
407
409
  ### 11. Verify and report
408
410
 
409
- Re-scan the install-target directories one more time and confirm: every selected artifact exists at its target path, every deselected one is gone, and zero broken symlinks remain. When pi extensions were touched, verify their runtime imports from the **real source path** (not only the target symlink path); when `chrome-devtools-mcp` is selected, launch/reload pi and require `/chrome_devtools-status` to report `connected` with a non-zero registered tool count. Merely listing the extension under `[Extensions]` is not proof that its asynchronous MCP initialization succeeded. When pi harnesses were touched, also confirm the `justfile` is consistent with the installed harness set: every installed harness has its launch recipe, and **no recipe points at a `.pi/harnesses/<name>/` that is not installed** (a leftover recipe for a retired harness is the regression this check catches). Also re-read `.ai/agent-fleet-setup.md` and verify the `version:` line matches the package version from Step 2 — a mismatch here means the apply pass did not stamp the new version, and must be corrected before the next re-run computes the wrong delta. If the post-apply scan surfaces any new breakage, treat it as a doctor finding and offer the same repair options as Step 5, then append a second `## doctor-runs` line with `phase: postflight`. List what changed, point the user at `.ai/agent-fleet-overrides.md` and `.ai/agent-fleet-setup.md`, and suggest loading `using-agent-skills` first in their next session.
411
+ Re-scan the install-target directories one more time and confirm: every selected artifact exists at its target path, every deselected one is gone, and zero broken symlinks remain. When pi extensions were touched, verify their runtime imports from the **real source path** (not only the target symlink path); when `chrome-devtools-mcp` is selected, launch/reload pi and require `/af-chrome-devtools-status` to report `connected` with a non-zero registered tool count. Merely listing the extension under `[Extensions]` is not proof that its asynchronous MCP initialization succeeded. When pi harnesses were touched, also confirm the `justfile` is consistent with the installed harness set: every installed harness has its launch recipe, and **no recipe points at a `.pi/harnesses/<name>/` that is not installed** (a leftover recipe for a retired harness is the regression this check catches). Also re-read `.ai/agent-fleet-setup.md` and verify the `version:` line matches the package version from Step 2 — a mismatch here means the apply pass did not stamp the new version, and must be corrected before the next re-run computes the wrong delta. If the post-apply scan surfaces any new breakage, treat it as a doctor finding and offer the same repair options as Step 5, then append a second `## doctor-runs` line with `phase: postflight`. List what changed, point the user at `.ai/agent-fleet-overrides.md` and `.ai/agent-fleet-setup.md`, and suggest loading `using-agent-skills` first in their next session.
410
412
 
411
413
  Close the report with one line explaining the installer-cleanup outcome:
412
414
 
413
- - If Step 10b ran: *"Installer slash commands removed from your workspace. Re-run `npx @chankov/agent-fleet init` if you need `/setup-agent-fleet` back."*
414
- - If Step 10b was skipped (`keep-installer: true`): *"Installer slash commands kept in place per your choice. `/setup-agent-fleet` and `/doctor-agent-fleet` remain available."*
415
+ - If Step 10b ran: *"Installer slash commands removed from your workspace. Re-run `npx @chankov/agent-fleet init` if you need the setup command back."*
416
+ - If Step 10b was skipped (`keep-installer: true`): name the retained commands for the selected runtime — `/af-setup-agent-fleet` and `/af-doctor-agent-fleet` on pi/OpenCode, or the unprefixed Claude Code equivalents.
415
417
 
416
418
  ## Common Rationalizations
417
419
 
@@ -432,7 +434,7 @@ Close the report with one line explaining the installer-cleanup outcome:
432
434
  | "There is no `*-setup.md` for this agent, so I'll guess the install paths." | Guessed paths put artifacts where the agent never loads them. Read the agent's setup doc, or use the built-in map — a location is never invented. |
433
435
  | "The workspace already has a `.claude/` directory, so setup is done." | A directory existing is not install state. The `## install-status` section is the only record of what this skill installed; read it before deciding. |
434
436
  | "An existing file differs from the source — I'll pause and ask the user mid-apply whether to overwrite." | Step 6 already surfaced `mod` with the warning that refreshing overwrites local edits. The user's selection is the consent. Mid-apply questions break the apply pass; they were replaced by the upfront status. |
435
- | "`.pi/prompts/design-agent.md` doesn't exist, but `.claude/commands/design-agent.md` does — I'll symlink to the Claude file so the user gets the prompt." | That mixes runtimes silently and lets the source repo's claude-code tree drive a pi target. The source availability filter forbids it: items without a per-agent source are not offered at all. |
437
+ | "`.pi/prompts/af-design-agent.md` doesn't exist, but `.claude/commands/design-agent.md` does — I'll symlink to the Claude file so the user gets the prompt." | That mixes runtimes silently and lets the source repo's claude-code tree drive a pi target. The source availability filter forbids it: items without a per-agent source are not offered at all. |
436
438
  | "The harness directories installed fine — the `justfile` is just launch shortcuts, I'll leave the existing one." | The `justfile` is how harnesses are launched; if it is not refreshed from the current source, retired-harness recipes linger (pointing at deleted `.pi/harnesses/<name>/` dirs) and newly added harnesses (for example `ask-user-remote` or the Hermes `conductor` recipe) have no recipe at all. It is a companion of the harness group and must be refreshed whenever any harness changes. |
437
439
  | "I'll just copy the source `justfile` over the target's to refresh it." | A wholesale copy clobbers any recipes the user authored. Refresh only the managed region between the `agent-fleet:harnesses` sentinels; a user-edited `justfile` outside that region is `mod`/`cflt` and gets the three-way diff first — never a silent overwrite. |
438
440
  | "The persona is just markdown — I'll copy it as-is for claude-code; the extra frontmatter keys are harmless." | The canonical frontmatter carries pi tool names (`find`, `ls`), pi model routes (`openai-codex/…`), and agent-hub keys the target cannot read. The `transform-persona` CLI exists so the installed file is correct and deterministic — raw copies and hand-transforms both drift. |
@@ -440,7 +442,7 @@ Close the report with one line explaining the installer-cleanup outcome:
440
442
  | "I'll record the full install detail in the overrides file too — one place is simpler." | Other skills load the overrides file on every run. Install detail belongs only in `agent-fleet-setup.md`; padding the overrides file taxes every later session. |
441
443
  | "There's an unfamiliar skill in `.claude/skills/` — the user must have forgotten to uncheck it, I'll remove it." | The removal scope rule exists exactly to prevent this. If the name is not in the agent-fleet inventory or not in `## install-status`, it is user-owned; leave it alone and log it as skipped. |
442
444
  | "The user wants a clean workspace — I'll prune custom hooks and unrelated MCP entries from `settings.json` too." | Setting-file edits are limited to agent-fleet' own hook registrations. Touching anything else silently deletes work that does not belong to this skill. |
443
- | "`/setup-agent-fleet` and `/doctor-agent-fleet` are useful — I'll re-install them at the end of apply so the user can re-run them locally." | They are installer commands that the CLI bootstraps and the skill itself cleans up in Step 10b by default. Keeping them is opt-in via `keep` in Step 9. Re-installing them silently undoes the cleanup the user implicitly chose. |
445
+ | "The Agent Fleet setup and doctor commands are useful — I'll re-install them at the end of apply so the user can re-run them locally." | They are installer commands that the CLI bootstraps and the skill itself cleans up in Step 10b by default. Keeping them is opt-in via `keep` in Step 9. Re-installing them silently undoes the cleanup the user implicitly chose. |
444
446
  | "The bootstrap marker is missing — I'll search the user's `~/repos/`, `~/projects/`, and `/media/` for any clone of `agent-fleet` to use as the source root." | Scanning the user's filesystem picks up dev clones, forks, half-edited working trees, and stale checkouts that are NOT the package the user installed from. The npm-installed copy is the only authoritative source after `init`. Without the marker, ask the user explicitly — never guess. |
445
447
  | "This `SKILL.md` is two levels below the workspace's `.pi/skills/`, so the workspace root must be the source root." | Bootstrap copies `SKILL.md` into the workspace precisely so the slash command can load it. The workspace is the *target* of the install, not the source. Use the marker file to find the real source; resolving from `SKILL.md`'s workspace location always lies. |
446
448
  | "The recorded version differs from the current — I'll just refresh everything to the new source without showing the diff." | Conflicting upgrades (user-modified copy + source changed upstream) require the three-way diff printed and the per-row inline question answered. Refreshing silently overwrites work the user did between versions. |
@@ -1,15 +0,0 @@
1
- import json,socket,tempfile,threading,unittest
2
- from pathlib import Path
3
- from adapter import MonitorAdapter,MonitorUnavailable,MAX_SNAPSHOT_RESPONSE_BYTES
4
- class CapTest(unittest.TestCase):
5
- def request(self, frame):
6
- with tempfile.TemporaryDirectory() as d:
7
- p=str(Path(d)/'s');s=socket.socket(socket.AF_UNIX,socket.SOCK_STREAM);s.bind(p);s.listen(1)
8
- def serve(): c,_=s.accept();c.recv(4096);c.sendall(frame);c.close();s.close()
9
- t=threading.Thread(target=serve);t.start()
10
- try:return MonitorAdapter(p,'t')._request({'type':'snapshot'})
11
- finally:t.join()
12
- def test_cap_excludes_one_ndjson_delimiter(self):
13
- base=json.dumps({'x':''},separators=(',',':')).encode();frame=json.dumps({'x':'a'*(MAX_SNAPSHOT_RESPONSE_BYTES-len(base))},separators=(',',':')).encode();self.assertEqual(len(frame),MAX_SNAPSHOT_RESPONSE_BYTES);self.assertIsInstance(self.request(frame+b'\n'),dict)
14
- with self.assertRaises(MonitorUnavailable):self.request(frame+b'a\n')
15
- if __name__=='__main__':unittest.main()
@@ -1,19 +0,0 @@
1
- import json
2
- import os
3
- import tempfile
4
- import unittest
5
- from datetime import datetime, timedelta, timezone
6
- from pathlib import Path
7
- from adapter import MonitorAdapter
8
-
9
- class AdapterDiscoveryTest(unittest.TestCase):
10
- def test_discovers_local_socket_and_token_from_explicit_profile_runtime_environment(self):
11
- with tempfile.TemporaryDirectory() as directory:
12
- root=Path(directory)/"runtime"; root.mkdir(mode=0o700)
13
- profile="a"*64; namespace=root/MonitorAdapter.canonical_profile_id(profile)/("b"*64); namespace.mkdir(parents=True, mode=0o700)
14
- owner="00000000-0000-0000-0000-000000000000"; socket_id=__import__('hashlib').sha256(f"{MonitorAdapter.canonical_profile_id(profile)}:{__import__('hashlib').sha256(b'hub').hexdigest()}:{owner}".encode()).hexdigest()[:32]; token=namespace/f"token-{owner}"; token.write_text("secret"); os.chmod(token,0o600)
15
- discovery=namespace/f"discovery-{owner}.json"; discovery.write_text(json.dumps({"owner":owner,"socket":f"@runtime/s/{socket_id}/s","token":f"token-{owner}","lease":{"hub":"hub","pid":1,"startedAt":"2020-01-01T00:00:00Z","expiresAt":(datetime.now(timezone.utc)+timedelta(minutes=1)).isoformat()}})); os.chmod(discovery,0o600)
16
- adapter=MonitorAdapter.from_profile_environment({"AGENT_FLEET_PROFILE_ID":profile,"AGENT_FLEET_MONITOR_RUNTIME_DIR":str(root)})
17
- self.assertEqual(adapter._socket_path,str(root/f"s/{socket_id}/s")); self.assertEqual(adapter._token,"secret")
18
-
19
- if __name__ == "__main__": unittest.main()
@@ -1,13 +0,0 @@
1
- import socket,tempfile,threading,unittest
2
- from pathlib import Path
3
- from adapter import MonitorAdapter,MonitorUnavailable
4
- class EnvelopeTest(unittest.TestCase):
5
- def test_rejects_non_object_json_envelope(self):
6
- with tempfile.TemporaryDirectory() as d:
7
- p=str(Path(d)/'s'); server=socket.socket(socket.AF_UNIX,socket.SOCK_STREAM);server.bind(p);server.listen(1)
8
- def serve():
9
- c,_=server.accept();c.recv(4096);c.sendall(b'[]\n');c.close();server.close()
10
- t=threading.Thread(target=serve);t.start()
11
- with self.assertRaises(MonitorUnavailable): MonitorAdapter(p,'secret').snapshot()
12
- t.join()
13
- if __name__=='__main__':unittest.main()
@@ -1,11 +0,0 @@
1
- import json,os,tempfile,unittest
2
- from datetime import datetime,timedelta,timezone
3
- from pathlib import Path
4
- from adapter import MonitorAdapter,MonitorUnavailable
5
- class ForgedOwnerTest(unittest.TestCase):
6
- def test_forged_cross_owner_expired_record_is_not_cleaned(self):
7
- with tempfile.TemporaryDirectory() as d:
8
- root=Path(d)/'r';root.mkdir(mode=0o700);p='p';ns=root/MonitorAdapter.canonical_profile_id(p)/('a'*64);ns.mkdir(parents=True,mode=0o700);owner='00000000-0000-0000-0000-000000000000';f=ns/f'discovery-{owner}.json';f.write_text(json.dumps({'owner':owner,'token':'token-11111111-1111-1111-1111-111111111111','socket':'@runtime/s/'+'a'*32+'/s','lease':{'hub':'hub','pid':1,'startedAt':'2020-01-01T00:00:00Z','expiresAt':'2020-01-01T00:00:01Z'}}));os.chmod(f,0o600)
9
- with self.assertRaises(MonitorUnavailable):MonitorAdapter.from_profile_environment({'AGENT_FLEET_PROFILE_ID':p,'AGENT_FLEET_MONITOR_RUNTIME_DIR':str(root)})
10
- self.assertTrue(f.exists())
11
- if __name__=='__main__':unittest.main()
@@ -1,9 +0,0 @@
1
- import json,os,tempfile,unittest
2
- from pathlib import Path
3
- from adapter import MonitorAdapter,MonitorUnavailable
4
- class LeaseListTest(unittest.TestCase):
5
- def test_lease_list_is_unavailable(self):
6
- with tempfile.TemporaryDirectory() as d:
7
- root=Path(d)/'r';root.mkdir(mode=0o700); profile='p';ns=root/MonitorAdapter.canonical_profile_id(profile)/('a'*64);ns.mkdir(parents=True,mode=0o700);p=ns/'discovery-00000000-0000-0000-0000-000000000000.json';p.write_text(json.dumps({'lease':[]}));os.chmod(p,0o600)
8
- with self.assertRaises(MonitorUnavailable):MonitorAdapter.from_profile_environment({'AGENT_FLEET_PROFILE_ID':profile,'AGENT_FLEET_MONITOR_RUNTIME_DIR':str(root)})
9
- if __name__=='__main__':unittest.main()
@@ -1,17 +0,0 @@
1
- import unittest
2
- from adapter import FleetMonitorAdapter, MonitorUnavailable
3
- class Hub:
4
- def __init__(self,name,fail=False): self.name=name;self.fail=fail;self.calls=[]
5
- def snapshot(self):
6
- if self.fail: raise MonitorUnavailable('down')
7
- return {'tasks':[{'id':'same','generation':1}]}
8
- def output(self,*v): self.calls.append(('output',v));return {'text':self.name}
9
- def cancel(self,*v): self.calls.append(('cancel',v));return {'cancelled':True}
10
- class MultiHubTest(unittest.TestCase):
11
- def test_colliding_ids_are_annotated_and_route_to_owner(self):
12
- a,b=Hub('a'),Hub('b'); f=FleetMonitorAdapter([('a',a),('b',b)])
13
- self.assertEqual({x['hubInstanceId'] for x in f.snapshot()['tasks']},{'a','b'})
14
- self.assertEqual(f.output('same',1,0,'b'),{'text':'b'}); self.assertEqual(b.calls,[('output',('same',1,0))]);self.assertEqual(a.calls,[])
15
- def test_failed_hub_does_not_drop_healthy_tasks(self):
16
- result=FleetMonitorAdapter([('a',Hub('a')),('b',Hub('b',True))]).snapshot();self.assertEqual(len(result['tasks']),1);self.assertEqual(result['hubs'][0]['hubInstanceId'],'b')
17
- if __name__=='__main__': unittest.main()
@@ -1,34 +0,0 @@
1
- import json
2
- import socket
3
- import tempfile
4
- import threading
5
- import unittest
6
- from pathlib import Path
7
-
8
- from adapter import MonitorAdapter
9
-
10
-
11
- class AdapterOutputTest(unittest.TestCase):
12
- def test_maps_typed_output_route_to_authenticated_uds_cursor_request(self):
13
- with tempfile.TemporaryDirectory() as directory:
14
- socket_path = str(Path(directory) / "monitor.sock")
15
- server = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
16
- server.bind(socket_path)
17
- server.listen(1)
18
-
19
- def serve():
20
- client, _ = server.accept()
21
- request = json.loads(client.recv(4096).decode())
22
- self.assertEqual(request, {"type": "output", "token": "secret", "taskId": "task", "generation": 2, "afterSequence": 7})
23
- client.sendall(b'{"ok":true,"output":{"text":"new","sequence":8,"firstSequence":8,"truncated":false}}\n')
24
- client.close()
25
- server.close()
26
-
27
- thread = threading.Thread(target=serve)
28
- thread.start()
29
- self.assertEqual(MonitorAdapter(socket_path, "secret").output("task", 2, 7), {"text": "new", "sequence": 8, "firstSequence": 8, "truncated": False})
30
- thread.join()
31
-
32
-
33
- if __name__ == "__main__":
34
- unittest.main()