@chankov/agent-fleet 0.0.7 → 0.0.9

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 (636) hide show
  1. package/.pi/agents/model-profiles.yaml +9 -2
  2. package/.pi/agents/peers.yaml +12 -16
  3. package/.pi/agents/teams.yaml +4 -2
  4. package/.pi/harnesses/agent-hub/README.md +20 -5
  5. package/.pi/harnesses/agent-hub/footer.ts +4 -2
  6. package/.pi/harnesses/agent-hub/index.ts +104 -11
  7. package/.pi/harnesses/agent-hub/package.json +1 -1
  8. package/.pi/harnesses/agent-hub/version.ts +25 -1
  9. package/.pi/harnesses/coms/README.md +8 -1
  10. package/.pi/harnesses/coms/package.json +1 -1
  11. package/.pi/harnesses/coms/version.ts +25 -1
  12. package/.pi/harnesses/damage-control-continue/README.md +8 -1
  13. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  14. package/.pi/harnesses/damage-control-continue/version.ts +25 -1
  15. package/.pi/harnesses/lib/herdr-client.ts +10 -1
  16. package/.pi/harnesses/lib/spawned-peers.js +190 -0
  17. package/.versions/0.0.8/.claude/commands/build.md +44 -0
  18. package/.versions/0.0.8/.claude/commands/code-simplify.md +22 -0
  19. package/.versions/0.0.8/.claude/commands/design-agent.md +14 -0
  20. package/.versions/0.0.8/.claude/commands/doctor-agent-fleet.md +17 -0
  21. package/.versions/0.0.8/.claude/commands/orchestrate.md +112 -0
  22. package/.versions/0.0.8/.claude/commands/plan.md +16 -0
  23. package/.versions/0.0.8/.claude/commands/prime.md +22 -0
  24. package/.versions/0.0.8/.claude/commands/review.md +16 -0
  25. package/.versions/0.0.8/.claude/commands/set-hermes-telegram.md +15 -0
  26. package/.versions/0.0.8/.claude/commands/set-hermes-watchdog.md +6 -0
  27. package/.versions/0.0.8/.claude/commands/setup-agent-fleet.md +25 -0
  28. package/.versions/0.0.8/.claude/commands/ship.md +72 -0
  29. package/.versions/0.0.8/.claude/commands/spec.md +15 -0
  30. package/.versions/0.0.8/.claude/commands/test.md +19 -0
  31. package/.versions/0.0.8/.claude/commands/webperf.md +32 -0
  32. package/.versions/0.0.8/.claude/orchestrate-teams.yaml +24 -0
  33. package/.versions/0.0.8/.opencode/commands/af-build.md +17 -0
  34. package/.versions/0.0.8/.opencode/commands/af-code-simplify.md +16 -0
  35. package/.versions/0.0.8/.opencode/commands/af-compound.md +16 -0
  36. package/.versions/0.0.8/.opencode/commands/af-design-agent.md +15 -0
  37. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  38. package/.versions/0.0.8/.opencode/commands/af-orchestrate.md +112 -0
  39. package/.versions/0.0.8/.opencode/commands/af-plan.md +16 -0
  40. package/.versions/0.0.8/.opencode/commands/af-prime.md +22 -0
  41. package/.versions/0.0.8/.opencode/commands/af-review.md +15 -0
  42. package/.versions/0.0.8/.opencode/commands/af-set-hermes-telegram.md +15 -0
  43. package/.versions/0.0.8/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  44. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +15 -0
  45. package/.versions/0.0.8/.opencode/commands/af-ship.md +16 -0
  46. package/.versions/0.0.8/.opencode/commands/af-spec.md +16 -0
  47. package/.versions/0.0.8/.opencode/commands/af-test.md +21 -0
  48. package/.versions/0.0.8/.opencode/commands/af-webperf.md +32 -0
  49. package/.versions/0.0.8/.opencode/orchestrate-teams.yaml +24 -0
  50. package/.versions/0.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  51. package/.versions/0.0.8/.pi/agents/model-profiles.yaml +20 -0
  52. package/.versions/0.0.8/.pi/agents/peers.yaml +146 -0
  53. package/.versions/0.0.8/.pi/agents/teams.yaml +39 -0
  54. package/.versions/0.0.8/.pi/damage-control-rules.yaml +297 -0
  55. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  56. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  57. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  58. package/.versions/0.0.8/.pi/extensions/btw/README.md +118 -0
  59. package/.versions/0.0.8/.pi/extensions/btw/index.ts +917 -0
  60. package/.versions/0.0.8/.pi/extensions/btw/package.json +6 -0
  61. package/.versions/0.0.8/.pi/extensions/btw/state.js +179 -0
  62. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  63. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  64. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  65. package/.versions/0.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  66. package/.versions/0.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  67. package/.versions/0.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  68. package/.versions/0.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  69. package/.versions/0.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  70. package/.versions/0.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  71. package/.versions/0.0.8/.pi/extensions/package-lock.json +1143 -0
  72. package/.versions/0.0.8/.pi/extensions/package.json +9 -0
  73. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/README.md +201 -0
  74. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  75. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  76. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  77. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  78. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  79. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  80. package/.versions/0.0.8/.pi/harnesses/agent-hub/README.md +857 -0
  81. package/.versions/0.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  82. package/.versions/0.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  83. package/.versions/0.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  84. package/.versions/0.0.8/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  85. package/.versions/0.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  86. package/.versions/0.0.8/.pi/harnesses/agent-hub/delegate.ts +435 -0
  87. package/.versions/0.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  88. package/.versions/0.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  89. package/.versions/0.0.8/.pi/harnesses/agent-hub/footer.ts +29 -0
  90. package/.versions/0.0.8/.pi/harnesses/agent-hub/helpers.ts +248 -0
  91. package/.versions/0.0.8/.pi/harnesses/agent-hub/index.ts +8609 -0
  92. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  93. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  94. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  95. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  96. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  97. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  98. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  99. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  100. package/.versions/0.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  101. package/.versions/0.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  102. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-retention.js +34 -0
  103. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  104. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  105. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  106. package/.versions/0.0.8/.pi/harnesses/agent-hub/run-budget.js +181 -0
  107. package/.versions/0.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  108. package/.versions/0.0.8/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  109. package/.versions/0.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  110. package/.versions/0.0.8/.pi/harnesses/agent-hub/spawn.ts +354 -0
  111. package/.versions/0.0.8/.pi/harnesses/agent-hub/version.ts +18 -0
  112. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/README.md +19 -0
  113. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/index.ts +321 -0
  114. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  115. package/.versions/0.0.8/.pi/harnesses/coms/README.md +93 -0
  116. package/.versions/0.0.8/.pi/harnesses/coms/index.ts +1767 -0
  117. package/.versions/0.0.8/.pi/harnesses/coms/package.json +7 -0
  118. package/.versions/0.0.8/.pi/harnesses/coms/version.ts +18 -0
  119. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/README.md +117 -0
  120. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/index.ts +536 -0
  121. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  122. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/version.ts +18 -0
  123. package/.versions/0.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  124. package/.versions/0.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  125. package/.versions/0.0.8/.pi/harnesses/lib/herdr-client.ts +463 -0
  126. package/.versions/0.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  127. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  128. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  129. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  130. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  131. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  132. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  133. package/.versions/0.0.8/.pi/harnesses/package-lock.json +35 -0
  134. package/.versions/0.0.8/.pi/harnesses/package.json +9 -0
  135. package/.versions/0.0.8/.pi/prompts/af-build.md +24 -0
  136. package/.versions/0.0.8/.pi/prompts/af-code-simplify.md +22 -0
  137. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  138. package/.versions/0.0.8/.pi/prompts/af-plan.md +16 -0
  139. package/.versions/0.0.8/.pi/prompts/af-review.md +16 -0
  140. package/.versions/0.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  141. package/.versions/0.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  142. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +27 -0
  143. package/.versions/0.0.8/.pi/prompts/af-ship.md +17 -0
  144. package/.versions/0.0.8/.pi/prompts/af-spec.md +15 -0
  145. package/.versions/0.0.8/.pi/prompts/af-test.md +19 -0
  146. package/.versions/0.0.8/.pi/skills/bowser/SKILL.md +145 -0
  147. package/.versions/0.0.8/.version +1 -0
  148. package/.versions/0.0.8/agents/architect.md +23 -0
  149. package/.versions/0.0.8/agents/bowser.md +26 -0
  150. package/.versions/0.0.8/agents/builder.md +53 -0
  151. package/.versions/0.0.8/agents/code-reviewer.md +205 -0
  152. package/.versions/0.0.8/agents/deep-researcher.md +31 -0
  153. package/.versions/0.0.8/agents/documenter.md +18 -0
  154. package/.versions/0.0.8/agents/orchestrator.md +65 -0
  155. package/.versions/0.0.8/agents/plan-reviewer.md +60 -0
  156. package/.versions/0.0.8/agents/planner.md +69 -0
  157. package/.versions/0.0.8/agents/releaser.md +24 -0
  158. package/.versions/0.0.8/agents/researcher.md +28 -0
  159. package/.versions/0.0.8/agents/security-auditor.md +166 -0
  160. package/.versions/0.0.8/agents/test-engineer.md +151 -0
  161. package/.versions/0.0.8/agents/web-debugger.md +42 -0
  162. package/.versions/0.0.8/agents/web-performance-auditor.md +192 -0
  163. package/.versions/0.0.8/codex/CONDUCTOR.md +148 -0
  164. package/.versions/0.0.8/docs/ARCHITECTURE.md +262 -0
  165. package/.versions/0.0.8/docs/agent-fleet-setup.md +366 -0
  166. package/.versions/0.0.8/docs/claude-code-coms-bridge.md +109 -0
  167. package/.versions/0.0.8/docs/codex-remote-conductor.md +170 -0
  168. package/.versions/0.0.8/docs/coms-hermes-bridge.md +189 -0
  169. package/.versions/0.0.8/docs/getting-started.md +231 -0
  170. package/.versions/0.0.8/docs/npm-install.md +337 -0
  171. package/.versions/0.0.8/docs/opencode-setup.md +249 -0
  172. package/.versions/0.0.8/docs/pi-extensions.md +293 -0
  173. package/.versions/0.0.8/docs/pi-setup.md +476 -0
  174. package/.versions/0.0.8/docs/skill-anatomy.md +150 -0
  175. package/.versions/0.0.8/hermes/README.md +347 -0
  176. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  177. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  178. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  179. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  180. package/.versions/0.0.8/hermes/gates/gate-o-capability.md +8 -0
  181. package/.versions/0.0.8/hermes/gates/gate-o-validator-fixtures.json +1 -0
  182. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  183. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  184. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  185. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  186. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  187. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  188. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  189. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  190. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  191. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  192. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  193. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  194. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  195. package/.versions/0.0.8/hermes/skills/hub-conductor/SKILL.md +84 -0
  196. package/.versions/0.0.8/hermes/skills/hub-liaison/SKILL.md +84 -0
  197. package/.versions/0.0.8/hermes/skills/hub-watchdog/SKILL.md +76 -0
  198. package/.versions/0.0.8/hermes/skills/hub-watchdog/manifest.json +1 -0
  199. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  200. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  201. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  202. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  203. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  204. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  205. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  206. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  207. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  208. package/.versions/0.0.8/hermes/watchdog-tests/__init__.py +0 -0
  209. package/.versions/0.0.8/hooks/SIMPLIFY-IGNORE.md +90 -0
  210. package/.versions/0.0.8/hooks/coms-stop-hook.mjs +84 -0
  211. package/.versions/0.0.8/hooks/hooks.json +14 -0
  212. package/.versions/0.0.8/hooks/session-start.sh +74 -0
  213. package/.versions/0.0.8/hooks/simplify-ignore.sh +302 -0
  214. package/.versions/0.0.8/justfile +245 -0
  215. package/.versions/0.0.8/references/accessibility-checklist.md +160 -0
  216. package/.versions/0.0.8/references/definition-of-done.md +67 -0
  217. package/.versions/0.0.8/references/fleet-coordination-patterns.md +151 -0
  218. package/.versions/0.0.8/references/observability-checklist.md +91 -0
  219. package/.versions/0.0.8/references/orchestration-patterns.md +370 -0
  220. package/.versions/0.0.8/references/performance-checklist.md +153 -0
  221. package/.versions/0.0.8/references/prompting-patterns.md +380 -0
  222. package/.versions/0.0.8/references/security-checklist.md +179 -0
  223. package/.versions/0.0.8/references/testing-patterns.md +236 -0
  224. package/.versions/0.0.8/scripts/codex-conductor.ts +41 -0
  225. package/.versions/0.0.8/scripts/codex-remote-control.ts +167 -0
  226. package/.versions/0.0.8/scripts/coms-claude-bridge.ts +401 -0
  227. package/.versions/0.0.8/scripts/coms-cli.ts +484 -0
  228. package/.versions/0.0.8/scripts/coms-hermes-bridge.ts +413 -0
  229. package/.versions/0.0.8/scripts/fleet.ts +149 -0
  230. package/.versions/0.0.8/scripts/hermes-monitor-capability-runner.ts +25 -0
  231. package/.versions/0.0.8/scripts/hermes-monitor-scenario.ts +474 -0
  232. package/.versions/0.0.8/scripts/hermes-watchdog-capability-probe.ts +45 -0
  233. package/.versions/0.0.8/scripts/install-hermes-plugin.sh +180 -0
  234. package/.versions/0.0.8/scripts/lib/claude-bridge-core.ts +165 -0
  235. package/.versions/0.0.8/scripts/lib/codex-conductor.ts +88 -0
  236. package/.versions/0.0.8/scripts/lib/codex-remote-control.ts +480 -0
  237. package/.versions/0.0.8/scripts/lib/coms-envelope.ts +582 -0
  238. package/.versions/0.0.8/scripts/lib/fake-herdr-server.ts +88 -0
  239. package/.versions/0.0.8/scripts/lib/fleet-command.ts +109 -0
  240. package/.versions/0.0.8/scripts/lib/herdr-layout.ts +263 -0
  241. package/.versions/0.0.8/scripts/lib/hermes-bridge-core.ts +241 -0
  242. package/.versions/0.0.8/scripts/lib/hermes-monitor-events.ts +1 -0
  243. package/.versions/0.0.8/scripts/lib/hermes-monitor-herdr.ts +2 -0
  244. package/.versions/0.0.8/scripts/lib/hermes-monitor-model.ts +3 -0
  245. package/.versions/0.0.8/scripts/lib/hermes-monitor-registry.ts +2 -0
  246. package/.versions/0.0.8/scripts/lib/hermes-monitor-socket.ts +2 -0
  247. package/.versions/0.0.8/scripts/lib/hermes-monitor-store.ts +2 -0
  248. package/.versions/0.0.8/scripts/lib/monitor-env.ts +120 -0
  249. package/.versions/0.0.8/scripts/lib/persona-banner.ts +62 -0
  250. package/.versions/0.0.8/scripts/lib/spawn-stagger.ts +101 -0
  251. package/.versions/0.0.8/scripts/lib/team-project.ts +191 -0
  252. package/.versions/0.0.8/scripts/lib/team-snapshot.ts +147 -0
  253. package/.versions/0.0.8/scripts/peer-banner.ts +40 -0
  254. package/.versions/0.0.8/scripts/team-snapshot.ts +237 -0
  255. package/.versions/0.0.8/scripts/team-up.ts +360 -0
  256. package/.versions/0.0.8/skills/_internal/grilling.md +11 -0
  257. package/.versions/0.0.8/skills/browser-testing-with-devtools/SKILL.md +352 -0
  258. package/.versions/0.0.8/skills/code-review-and-quality/SKILL.md +381 -0
  259. package/.versions/0.0.8/skills/compound-learning/SKILL.md +137 -0
  260. package/.versions/0.0.8/skills/context-engineering/SKILL.md +291 -0
  261. package/.versions/0.0.8/skills/deprecation-and-migration/SKILL.md +206 -0
  262. package/.versions/0.0.8/skills/designing-agents/SKILL.md +394 -0
  263. package/.versions/0.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  264. package/.versions/0.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  265. package/.versions/0.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  266. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +544 -0
  267. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +36 -0
  268. package/.versions/0.0.8/skills/idea-refine/SKILL.md +182 -0
  269. package/.versions/0.0.8/skills/idea-refine/examples.md +238 -0
  270. package/.versions/0.0.8/skills/idea-refine/frameworks.md +99 -0
  271. package/.versions/0.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  272. package/.versions/0.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  273. package/.versions/0.0.8/skills/incremental-implementation/SKILL.md +287 -0
  274. package/.versions/0.0.8/skills/interview-me/SKILL.md +226 -0
  275. package/.versions/0.0.8/skills/orchestration-verification/SKILL.md +181 -0
  276. package/.versions/0.0.8/skills/peer-coms/SKILL.md +90 -0
  277. package/.versions/0.0.8/skills/performance-optimization/SKILL.md +350 -0
  278. package/.versions/0.0.8/skills/planning-and-task-breakdown/SKILL.md +236 -0
  279. package/.versions/0.0.8/skills/security-and-hardening/SKILL.md +461 -0
  280. package/.versions/0.0.8/skills/spec-driven-development/SKILL.md +245 -0
  281. package/.versions/0.0.8/skills/using-agent-skills/SKILL.md +199 -0
  282. package/.versions/0.0.8/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  283. package/.versions/0.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  284. package/.versions/0.0.8/vendor/agent-skills-upstream/README.md +11 -0
  285. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  286. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  287. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  288. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  289. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  290. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  291. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  292. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  293. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  294. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  295. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  296. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  297. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  298. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  299. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  300. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  301. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  302. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  303. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  304. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  305. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  306. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  307. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  308. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  309. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  310. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  311. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  312. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  313. package/.versions/0.0.9/.claude/commands/build.md +44 -0
  314. package/.versions/0.0.9/.claude/commands/code-simplify.md +22 -0
  315. package/.versions/0.0.9/.claude/commands/design-agent.md +14 -0
  316. package/.versions/0.0.9/.claude/commands/doctor-agent-fleet.md +17 -0
  317. package/.versions/0.0.9/.claude/commands/orchestrate.md +112 -0
  318. package/.versions/0.0.9/.claude/commands/plan.md +16 -0
  319. package/.versions/0.0.9/.claude/commands/prime.md +22 -0
  320. package/.versions/0.0.9/.claude/commands/review.md +16 -0
  321. package/.versions/0.0.9/.claude/commands/set-hermes-telegram.md +15 -0
  322. package/.versions/0.0.9/.claude/commands/set-hermes-watchdog.md +6 -0
  323. package/.versions/0.0.9/.claude/commands/setup-agent-fleet.md +25 -0
  324. package/.versions/0.0.9/.claude/commands/ship.md +72 -0
  325. package/.versions/0.0.9/.claude/commands/spec.md +15 -0
  326. package/.versions/0.0.9/.claude/commands/test.md +19 -0
  327. package/.versions/0.0.9/.claude/commands/webperf.md +32 -0
  328. package/.versions/0.0.9/.claude/orchestrate-teams.yaml +24 -0
  329. package/.versions/0.0.9/.opencode/commands/af-build.md +17 -0
  330. package/.versions/0.0.9/.opencode/commands/af-code-simplify.md +16 -0
  331. package/.versions/0.0.9/.opencode/commands/af-compound.md +16 -0
  332. package/.versions/0.0.9/.opencode/commands/af-design-agent.md +15 -0
  333. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  334. package/.versions/0.0.9/.opencode/commands/af-orchestrate.md +112 -0
  335. package/.versions/0.0.9/.opencode/commands/af-plan.md +16 -0
  336. package/.versions/0.0.9/.opencode/commands/af-prime.md +22 -0
  337. package/.versions/0.0.9/.opencode/commands/af-review.md +15 -0
  338. package/.versions/0.0.9/.opencode/commands/af-set-hermes-telegram.md +15 -0
  339. package/.versions/0.0.9/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  340. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +15 -0
  341. package/.versions/0.0.9/.opencode/commands/af-ship.md +16 -0
  342. package/.versions/0.0.9/.opencode/commands/af-spec.md +16 -0
  343. package/.versions/0.0.9/.opencode/commands/af-test.md +21 -0
  344. package/.versions/0.0.9/.opencode/commands/af-webperf.md +32 -0
  345. package/.versions/0.0.9/.opencode/orchestrate-teams.yaml +24 -0
  346. package/.versions/0.0.9/.pi/agents/dispatch-policy.yaml +32 -0
  347. package/.versions/0.0.9/.pi/agents/model-profiles.yaml +27 -0
  348. package/.versions/0.0.9/.pi/agents/peers.yaml +142 -0
  349. package/.versions/0.0.9/.pi/agents/teams.yaml +41 -0
  350. package/.versions/0.0.9/.pi/damage-control-rules.yaml +297 -0
  351. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  352. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  353. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  354. package/.versions/0.0.9/.pi/extensions/btw/README.md +118 -0
  355. package/.versions/0.0.9/.pi/extensions/btw/index.ts +917 -0
  356. package/.versions/0.0.9/.pi/extensions/btw/package.json +6 -0
  357. package/.versions/0.0.9/.pi/extensions/btw/state.js +179 -0
  358. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  359. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  360. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  361. package/.versions/0.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
  362. package/.versions/0.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
  363. package/.versions/0.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
  364. package/.versions/0.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
  365. package/.versions/0.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
  366. package/.versions/0.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
  367. package/.versions/0.0.9/.pi/extensions/package-lock.json +1143 -0
  368. package/.versions/0.0.9/.pi/extensions/package.json +9 -0
  369. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/README.md +201 -0
  370. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
  371. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  372. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
  373. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
  374. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  375. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  376. package/.versions/0.0.9/.pi/harnesses/agent-hub/README.md +872 -0
  377. package/.versions/0.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  378. package/.versions/0.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
  379. package/.versions/0.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  380. package/.versions/0.0.9/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  381. package/.versions/0.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
  382. package/.versions/0.0.9/.pi/harnesses/agent-hub/delegate.ts +435 -0
  383. package/.versions/0.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  384. package/.versions/0.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  385. package/.versions/0.0.9/.pi/harnesses/agent-hub/footer.ts +31 -0
  386. package/.versions/0.0.9/.pi/harnesses/agent-hub/helpers.ts +248 -0
  387. package/.versions/0.0.9/.pi/harnesses/agent-hub/index.ts +8702 -0
  388. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  389. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  390. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  391. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  392. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  393. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  394. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  395. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  396. package/.versions/0.0.9/.pi/harnesses/agent-hub/package.json +7 -0
  397. package/.versions/0.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  398. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-retention.js +34 -0
  399. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  400. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
  401. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
  402. package/.versions/0.0.9/.pi/harnesses/agent-hub/run-budget.js +181 -0
  403. package/.versions/0.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  404. package/.versions/0.0.9/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  405. package/.versions/0.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
  406. package/.versions/0.0.9/.pi/harnesses/agent-hub/spawn.ts +354 -0
  407. package/.versions/0.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
  408. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/README.md +19 -0
  409. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/index.ts +321 -0
  410. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  411. package/.versions/0.0.9/.pi/harnesses/coms/README.md +100 -0
  412. package/.versions/0.0.9/.pi/harnesses/coms/index.ts +1767 -0
  413. package/.versions/0.0.9/.pi/harnesses/coms/package.json +7 -0
  414. package/.versions/0.0.9/.pi/harnesses/coms/version.ts +42 -0
  415. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/README.md +124 -0
  416. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/index.ts +536 -0
  417. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
  418. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
  419. package/.versions/0.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  420. package/.versions/0.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  421. package/.versions/0.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
  422. package/.versions/0.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
  423. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  424. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  425. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  426. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  427. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  428. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  429. package/.versions/0.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
  430. package/.versions/0.0.9/.pi/harnesses/package-lock.json +35 -0
  431. package/.versions/0.0.9/.pi/harnesses/package.json +9 -0
  432. package/.versions/0.0.9/.pi/prompts/af-build.md +24 -0
  433. package/.versions/0.0.9/.pi/prompts/af-code-simplify.md +22 -0
  434. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  435. package/.versions/0.0.9/.pi/prompts/af-plan.md +16 -0
  436. package/.versions/0.0.9/.pi/prompts/af-review.md +16 -0
  437. package/.versions/0.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
  438. package/.versions/0.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  439. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +27 -0
  440. package/.versions/0.0.9/.pi/prompts/af-ship.md +17 -0
  441. package/.versions/0.0.9/.pi/prompts/af-spec.md +15 -0
  442. package/.versions/0.0.9/.pi/prompts/af-test.md +19 -0
  443. package/.versions/0.0.9/.pi/skills/bowser/SKILL.md +145 -0
  444. package/.versions/0.0.9/.version +1 -0
  445. package/.versions/0.0.9/agents/architect.md +24 -0
  446. package/.versions/0.0.9/agents/bowser.md +27 -0
  447. package/.versions/0.0.9/agents/builder.md +54 -0
  448. package/.versions/0.0.9/agents/code-reviewer.md +204 -0
  449. package/.versions/0.0.9/agents/deep-researcher.md +32 -0
  450. package/.versions/0.0.9/agents/documenter.md +18 -0
  451. package/.versions/0.0.9/agents/orchestrator.md +66 -0
  452. package/.versions/0.0.9/agents/plan-reviewer.md +62 -0
  453. package/.versions/0.0.9/agents/planner.md +70 -0
  454. package/.versions/0.0.9/agents/releaser.md +24 -0
  455. package/.versions/0.0.9/agents/researcher.md +28 -0
  456. package/.versions/0.0.9/agents/security-auditor.md +167 -0
  457. package/.versions/0.0.9/agents/test-engineer.md +153 -0
  458. package/.versions/0.0.9/agents/web-debugger.md +43 -0
  459. package/.versions/0.0.9/agents/web-performance-auditor.md +193 -0
  460. package/.versions/0.0.9/codex/CONDUCTOR.md +148 -0
  461. package/.versions/0.0.9/docs/ARCHITECTURE.md +262 -0
  462. package/.versions/0.0.9/docs/agent-fleet-setup.md +366 -0
  463. package/.versions/0.0.9/docs/claude-code-coms-bridge.md +109 -0
  464. package/.versions/0.0.9/docs/codex-remote-conductor.md +170 -0
  465. package/.versions/0.0.9/docs/coms-hermes-bridge.md +189 -0
  466. package/.versions/0.0.9/docs/getting-started.md +231 -0
  467. package/.versions/0.0.9/docs/npm-install.md +337 -0
  468. package/.versions/0.0.9/docs/opencode-setup.md +249 -0
  469. package/.versions/0.0.9/docs/pi-extensions.md +356 -0
  470. package/.versions/0.0.9/docs/pi-setup.md +476 -0
  471. package/.versions/0.0.9/docs/skill-anatomy.md +150 -0
  472. package/.versions/0.0.9/hermes/README.md +347 -0
  473. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  474. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  475. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  476. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  477. package/.versions/0.0.9/hermes/gates/gate-o-capability.md +8 -0
  478. package/.versions/0.0.9/hermes/gates/gate-o-validator-fixtures.json +1 -0
  479. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  480. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  481. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  482. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  483. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  484. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  485. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  486. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  487. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  488. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  489. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  490. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  491. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  492. package/.versions/0.0.9/hermes/skills/hub-conductor/SKILL.md +84 -0
  493. package/.versions/0.0.9/hermes/skills/hub-liaison/SKILL.md +84 -0
  494. package/.versions/0.0.9/hermes/skills/hub-watchdog/SKILL.md +76 -0
  495. package/.versions/0.0.9/hermes/skills/hub-watchdog/manifest.json +1 -0
  496. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  497. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  498. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  499. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  500. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  501. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  502. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  503. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  504. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  505. package/.versions/0.0.9/hermes/watchdog-tests/__init__.py +0 -0
  506. package/.versions/0.0.9/hooks/SIMPLIFY-IGNORE.md +90 -0
  507. package/.versions/0.0.9/hooks/coms-stop-hook.mjs +84 -0
  508. package/.versions/0.0.9/hooks/hooks.json +14 -0
  509. package/.versions/0.0.9/hooks/session-start.sh +74 -0
  510. package/.versions/0.0.9/hooks/simplify-ignore.sh +302 -0
  511. package/.versions/0.0.9/justfile +254 -0
  512. package/.versions/0.0.9/references/accessibility-checklist.md +160 -0
  513. package/.versions/0.0.9/references/definition-of-done.md +67 -0
  514. package/.versions/0.0.9/references/fleet-coordination-patterns.md +151 -0
  515. package/.versions/0.0.9/references/observability-checklist.md +91 -0
  516. package/.versions/0.0.9/references/orchestration-patterns.md +370 -0
  517. package/.versions/0.0.9/references/performance-checklist.md +153 -0
  518. package/.versions/0.0.9/references/prompting-patterns.md +380 -0
  519. package/.versions/0.0.9/references/security-checklist.md +179 -0
  520. package/.versions/0.0.9/references/testing-patterns.md +236 -0
  521. package/.versions/0.0.9/scripts/codex-conductor.ts +41 -0
  522. package/.versions/0.0.9/scripts/codex-remote-control.ts +167 -0
  523. package/.versions/0.0.9/scripts/coms-claude-bridge.ts +401 -0
  524. package/.versions/0.0.9/scripts/coms-cli.ts +484 -0
  525. package/.versions/0.0.9/scripts/coms-hermes-bridge.ts +413 -0
  526. package/.versions/0.0.9/scripts/fleet.ts +168 -0
  527. package/.versions/0.0.9/scripts/hermes-monitor-capability-runner.ts +25 -0
  528. package/.versions/0.0.9/scripts/hermes-monitor-scenario.ts +474 -0
  529. package/.versions/0.0.9/scripts/hermes-watchdog-capability-probe.ts +45 -0
  530. package/.versions/0.0.9/scripts/install-hermes-plugin.sh +180 -0
  531. package/.versions/0.0.9/scripts/lib/claude-bridge-core.ts +165 -0
  532. package/.versions/0.0.9/scripts/lib/codex-conductor.ts +88 -0
  533. package/.versions/0.0.9/scripts/lib/codex-remote-control.ts +480 -0
  534. package/.versions/0.0.9/scripts/lib/coms-envelope.ts +582 -0
  535. package/.versions/0.0.9/scripts/lib/fake-herdr-server.ts +88 -0
  536. package/.versions/0.0.9/scripts/lib/fleet-command.ts +111 -0
  537. package/.versions/0.0.9/scripts/lib/herdr-layout.ts +281 -0
  538. package/.versions/0.0.9/scripts/lib/hermes-bridge-core.ts +241 -0
  539. package/.versions/0.0.9/scripts/lib/hermes-monitor-events.ts +1 -0
  540. package/.versions/0.0.9/scripts/lib/hermes-monitor-herdr.ts +2 -0
  541. package/.versions/0.0.9/scripts/lib/hermes-monitor-model.ts +3 -0
  542. package/.versions/0.0.9/scripts/lib/hermes-monitor-registry.ts +2 -0
  543. package/.versions/0.0.9/scripts/lib/hermes-monitor-socket.ts +2 -0
  544. package/.versions/0.0.9/scripts/lib/hermes-monitor-store.ts +2 -0
  545. package/.versions/0.0.9/scripts/lib/monitor-env.ts +120 -0
  546. package/.versions/0.0.9/scripts/lib/peer-launch.ts +314 -0
  547. package/.versions/0.0.9/scripts/lib/persona-banner.ts +62 -0
  548. package/.versions/0.0.9/scripts/lib/spawn-stagger.ts +101 -0
  549. package/.versions/0.0.9/scripts/lib/team-project.ts +193 -0
  550. package/.versions/0.0.9/scripts/lib/team-snapshot.ts +147 -0
  551. package/.versions/0.0.9/scripts/peer-banner.ts +40 -0
  552. package/.versions/0.0.9/scripts/peer-launch.ts +259 -0
  553. package/.versions/0.0.9/scripts/team-snapshot.ts +237 -0
  554. package/.versions/0.0.9/scripts/team-up.ts +360 -0
  555. package/.versions/0.0.9/skills/_internal/grilling.md +11 -0
  556. package/.versions/0.0.9/skills/browser-testing-with-devtools/SKILL.md +352 -0
  557. package/.versions/0.0.9/skills/code-review-and-quality/SKILL.md +381 -0
  558. package/.versions/0.0.9/skills/compound-learning/SKILL.md +137 -0
  559. package/.versions/0.0.9/skills/context-engineering/SKILL.md +291 -0
  560. package/.versions/0.0.9/skills/deprecation-and-migration/SKILL.md +206 -0
  561. package/.versions/0.0.9/skills/designing-agents/SKILL.md +394 -0
  562. package/.versions/0.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
  563. package/.versions/0.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
  564. package/.versions/0.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
  565. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +544 -0
  566. package/.versions/0.0.9/skills/guided-workspace-setup/companion-manifest.json +38 -0
  567. package/.versions/0.0.9/skills/idea-refine/SKILL.md +182 -0
  568. package/.versions/0.0.9/skills/idea-refine/examples.md +238 -0
  569. package/.versions/0.0.9/skills/idea-refine/frameworks.md +99 -0
  570. package/.versions/0.0.9/skills/idea-refine/refinement-criteria.md +113 -0
  571. package/.versions/0.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
  572. package/.versions/0.0.9/skills/incremental-implementation/SKILL.md +287 -0
  573. package/.versions/0.0.9/skills/interview-me/SKILL.md +226 -0
  574. package/.versions/0.0.9/skills/orchestration-verification/SKILL.md +181 -0
  575. package/.versions/0.0.9/skills/peer-coms/SKILL.md +90 -0
  576. package/.versions/0.0.9/skills/performance-optimization/SKILL.md +350 -0
  577. package/.versions/0.0.9/skills/planning-and-task-breakdown/SKILL.md +236 -0
  578. package/.versions/0.0.9/skills/security-and-hardening/SKILL.md +461 -0
  579. package/.versions/0.0.9/skills/spec-driven-development/SKILL.md +245 -0
  580. package/.versions/0.0.9/skills/using-agent-skills/SKILL.md +199 -0
  581. package/.versions/0.0.9/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  582. package/.versions/0.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
  583. package/.versions/0.0.9/vendor/agent-skills-upstream/README.md +11 -0
  584. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  585. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  586. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  587. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  588. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  589. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  590. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  591. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  592. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  593. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  594. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  595. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  596. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  597. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  598. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  599. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  600. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  601. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  602. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  603. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  604. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  605. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  606. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  607. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  608. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  609. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  610. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  611. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  612. package/CHANGELOG.md +44 -0
  613. package/agents/architect.md +1 -0
  614. package/agents/bowser.md +1 -0
  615. package/agents/builder.md +1 -0
  616. package/agents/code-reviewer.md +4 -5
  617. package/agents/deep-researcher.md +2 -1
  618. package/agents/orchestrator.md +1 -0
  619. package/agents/plan-reviewer.md +3 -1
  620. package/agents/planner.md +3 -2
  621. package/agents/security-auditor.md +1 -0
  622. package/agents/test-engineer.md +3 -1
  623. package/agents/web-debugger.md +1 -0
  624. package/agents/web-performance-auditor.md +1 -0
  625. package/docs/ARCHITECTURE.md +1 -1
  626. package/docs/pi-extensions.md +66 -3
  627. package/justfile +10 -1
  628. package/package.json +2 -2
  629. package/scripts/fleet.ts +22 -3
  630. package/scripts/lib/fleet-command.ts +5 -3
  631. package/scripts/lib/herdr-layout.ts +18 -0
  632. package/scripts/lib/peer-launch.ts +314 -0
  633. package/scripts/lib/team-project.ts +3 -1
  634. package/scripts/peer-launch.ts +259 -0
  635. package/skills/guided-workspace-setup/companion-manifest.json +3 -0
  636. /package/{.pi → .versions/0.0.8/.pi}/harnesses/agent-hub/spawned-peers.js +0 -0
@@ -0,0 +1,148 @@
1
+ # Agent Fleet Codex Conductor Contract
2
+
3
+ **Status: experimental; verified with Codex CLI 0.144.6 on Linux.** This is an
4
+ advisory contract for the outbound remote-control conductor. Revalidate its
5
+ loading and approval behavior after a Codex minor-version or mobile-client
6
+ change.
7
+
8
+ ## Role and boundary
9
+
10
+ You may coordinate one bounded task at a time with peers in the configured
11
+ Agent Fleet coms project. Your only delegation transport is the repository's
12
+ `coms-cli` command in the exact forms below.
13
+
14
+ Codex is **outbound-only**. Hermes/Telegram remains the sole inbound
15
+ `ask_user` relay. Do not implement, invoke, or imitate an inbound question
16
+ channel. Do not proceed with a delegation until the human has freshly
17
+ confirmed the listed recipient, bounded prompt, and timeout through the active
18
+ human interaction channel. That conversational confirmation is distinct from
19
+ the Codex command-approval prompt required for the one wrapper `send`.
20
+
21
+ Pi damage-control wraps Pi tool calls only. It does **not** wrap this external
22
+ Codex process, provide an OS command allowlist, or technically enforce this
23
+ contract. Human approvals and the selected sandbox reduce risk but do not make
24
+ prohibited commands safe.
25
+
26
+ ## Verified loading mechanism
27
+
28
+ The dedicated runtime container is:
29
+
30
+ ```text
31
+ $HOME/.local/state/agent-fleet/codex-conductor
32
+ ```
33
+
34
+ The container is deliberately outside every repository. Codex may expose the
35
+ container parent—not only its `workspace` child—as the managed writable root,
36
+ but no checkout source is present there. Wrapper commands must still run from
37
+ the `workspace` child. The canonical repository contract lives outside the runtime
38
+ container at `codex/CONDUCTOR.md`. Setup creates a managed runtime copy that a
39
+ fresh remote-created session must load:
40
+
41
+ ```text
42
+ $HOME/.local/state/agent-fleet/codex-conductor/workspace/AGENTS.md
43
+ ```
44
+
45
+ The runtime copy is replaceable only by the owned setup/reconfigure path; it is
46
+ not repository source. `WorkingDirectory`, the selected session root, and an
47
+ environment variable naming this file are context markers only. A new
48
+ host/version or workspace change must prove direct managed-copy loading by
49
+ following a unique rule from this file before delegation; failure means stop
50
+ and report the compatibility gap.
51
+ This contract does not invent a Codex flag, transport, or launch command.
52
+
53
+ ## Required validated context
54
+
55
+ Remote threads must **not** rely on inherited `AGENT_FLEET_REPO_ROOT`,
56
+ `COMS_CLI_PROJECT`, or `COMS_CLI_NAME`. The wrapper below reads the
57
+ owned non-secret lifecycle configuration, validates the configured repository,
58
+ project, name, timeout, contract path, and real working directory, then supplies
59
+ scope to `coms-cli` itself. It accepts no repository/project/name/timeout
60
+ override. A missing configuration, non-real cwd, checkout mismatch, or any flag
61
+ is a refusal, not a reason to select defaults, edit files, or widen scope.
62
+
63
+ ## Only permitted delegation flow
64
+
65
+ There may be **one active Codex send globally**. Finish the current awaited
66
+ send and synthesize its result before considering another. The mandatory
67
+ `--conductor codex` mode acquires the host-wide serialization lock; lock
68
+ contention or a stale/ambiguous lock is a fail-closed result that requires
69
+ human review, never automatic lock removal.
70
+
71
+ 1. Remain in the dedicated `$HOME/.local/state/agent-fleet/codex-conductor/workspace` scratch directory. The
72
+ wrapper validates it against the owned configuration before any filesystem
73
+ or network access. Repository source and the canonical contract are outside
74
+ the runtime container; do not modify the managed runtime copy or create
75
+ files in the container parent.
76
+ 2. Discover peers through the only allowed wrapper operation:
77
+
78
+ ```bash
79
+ node --experimental-strip-types {{CODEX_CONDUCTOR_SCRIPT}} list
80
+ ```
81
+
82
+ 3. Select only a recipient shown by that fresh command output. Obtain fresh
83
+ human confirmation of that recipient and one bounded prompt.
84
+ 4. Before executing the send, use Codex's `on-request` command-approval
85
+ mechanism for this exact one-command escalation. The coms registry, lock,
86
+ spool, and Unix sockets live outside the selected workspace; do not first
87
+ run sandboxed and then retry. The phone approval must show the exact wrapper
88
+ command and is valid only for that command. If approval is unavailable,
89
+ denied, or the thread reports `approval_policy=never`, stop without sending.
90
+ 5. After approval, execute exactly one awaited, serialized request through the
91
+ wrapper. Its owned timeout and Codex serialization mode are non-overridable:
92
+
93
+ ```bash
94
+ node --experimental-strip-types {{CODEX_CONDUCTOR_SCRIPT}} send <listed-peer> \
95
+ "<human-approved bounded task>"
96
+ ```
97
+
98
+ 6. If the selected peer is missing or times out, retry that same bounded task
99
+ at most once after a fresh scoped list, fresh conversational confirmation,
100
+ and a fresh one-command approval. Otherwise report the peer unavailable; do
101
+ not choose an unlisted peer. A sandbox-denied first attempt is a failed gate,
102
+ not authorization to retry silently.
103
+ 7. Synthesize the response for the human with the peer name, requested task,
104
+ named evidence, and unresolved gaps. A peer's unsupported prose claim is
105
+ not evidence.
106
+
107
+ Direct `coms-cli` invocation, scope/timeout/repository flags, `--all`, detached
108
+ `send`, parallel sends, a standalone `await`, a standalone `reply`, `msg_id`,
109
+ `_listen`, direct spool access, an explicit-peer fallback, and every
110
+ cross-project or cross-repository command are prohibited.
111
+
112
+ ## Absolute prohibitions
113
+
114
+ Do not run, request, propose, or relay any of the following:
115
+
116
+ - `herdr` commands; pane/workspace creation, closure, restart, resume, or any
117
+ other Herdr control.
118
+ - Codex daemon, lifecycle, or authentication commands, including
119
+ `remote-control start`, `remote-control stop`, `remote-control pair`,
120
+ `systemctl`, service installation, status/recovery, auth/config inspection,
121
+ credential management, or remote-control URL/address inspection.
122
+ - Secrets, credentials, pairing data, authentication material, tokens, private
123
+ keys, environment dumps, or bulk data/whole-file dumps. Use bounded prompts
124
+ and path references only.
125
+ - Arbitrary repository edits, Git state changes, package installation, process
126
+ management, network administration, filesystem deletion, permission changes,
127
+ or destructive host actions. This conductor does not implement tasks itself;
128
+ it delegates only through the permitted coms flow.
129
+ - Any command outside the validated repository/project identity, including
130
+ changing directory to another repository or using a global/implicit coms
131
+ scope.
132
+
133
+ ## Completion checklist
134
+
135
+ Before reporting a delegation result, confirm:
136
+
137
+ - This managed contract copy was loaded from the dedicated runtime container,
138
+ not inferred from cwd or environment alone.
139
+ - Required context was validated without exposing secrets.
140
+ - A fresh scoped `list` showed the target before the one awaited send.
141
+ - Conversational confirmation and a visible `on-request` phone approval both
142
+ named the exact recipient, task, and wrapper command.
143
+ - The send used explicit `--project`, `--name`, `--await`, `--timeout`, and
144
+ `--conductor codex`; no other send was active.
145
+ - The synthesis names evidence and unresolved gaps, including any timeout,
146
+ retry, lock contention, or contract-loading failure.
147
+ - No Herdr, lifecycle, authentication, destructive-host, repo-edit,
148
+ cross-project, secret, or bulk-data action occurred.
@@ -0,0 +1,262 @@
1
+ # Agent Fleet Architecture
2
+
3
+ Agent Fleet is a Pi-centered multi-agent orchestration system. This page maps
4
+ the runtime responsibilities and where each module lives in the repository.
5
+
6
+ ## Runtime layers
7
+
8
+ | Layer | Role | Implementation |
9
+ | --- | --- | --- |
10
+ | **Pi Coding Agent** | Primary local runtime — runs the dispatcher and specialist subagents | `.pi/harnesses/`, `.pi/extensions/`, `.pi/agents/`, `.pi/prompts/` |
11
+ | **agent-hub** | Thin-context multi-agent harness: dispatcher + specialists + research helpers + Verification Contract | `.pi/harnesses/agent-hub/` |
12
+ | **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in `scripts/lib/herdr-layout.ts` |
13
+ | **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | `.pi/harnesses/coms/`, `scripts/lib/coms-envelope.ts`, `scripts/coms-cli.ts` |
14
+ | **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `scripts/coms-claude-bridge.ts`, `hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
15
+ | **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
16
+ | **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `scripts/lib/`) — see [Hermes artifacts](../hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
17
+ | **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
18
+ | **Codex remote-control conductor** | Experimental outbound-only, user-systemd-managed Android conductor; verified on Codex CLI 0.144.x | `scripts/codex-remote-control.ts`, `scripts/codex-conductor.ts`, `codex/CONDUCTOR.md`, `systemd/user/`; runtime under `~/.local/state/agent-fleet/codex-conductor/` — see [codex-remote-conductor.md](codex-remote-conductor.md) |
19
+ | **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
20
+ | **Personas** | Reusable specialist definitions, transformed per harness | `agents/`, `bin/lib/transform-persona.js` |
21
+
22
+ ## Fleet hierarchy
23
+
24
+ Agent Fleet is layered on purpose. Work flows **down** (delegate); evidence and status flow **up** — as compact structured returns, never raw dumps.
25
+
26
+ ```mermaid
27
+ flowchart TD
28
+ You(["You · Hermes inbound relay · Codex outbound conductor on your phone"])
29
+
30
+ subgraph HUBL["HUB — thin dispatcher (just fleet hub · just fleet team)"]
31
+ Hub["agent-hub harness + orchestrator persona<br/>routes tasks · owns the Verification Contract on disk<br/>never swallows research dumps into its own context"]
32
+ end
33
+
34
+ subgraph TEAML["TEAM — named roster (.pi/agents/teams.yaml)"]
35
+ Team["default: planner · plan-reviewer · builder · test-engineer · code-reviewer · documenter<br/>also: debug · frontend · security · hotfix · release · info"]
36
+ end
37
+
38
+ subgraph RESL["RESEARCH HELPERS — read-only, always available"]
39
+ Research["researcher (fast tier — simple reads)<br/>deep-researcher (deep tier — hard, cross-cutting questions)"]
40
+ end
41
+
42
+ subgraph SUBL["SUB-AGENTS — focused children, narrow tools + models"]
43
+ Subs["planner → scout · rules · risk<br/>plan-reviewer → feasibility · deps<br/>builder → recon · verifier<br/>test-engineer → coverage-scout · conventions<br/>code-reviewer → preflight · quality · perf · docs<br/>security-auditor → recon · input-sweep · secrets-sweep"]
44
+ end
45
+
46
+ You -->|task| Hub
47
+ Hub -->|"dispatch_agent — one persona = one specialist session"| Team
48
+ Hub -->|"spawn_research"| Research
49
+ Research -.->|"findings written to disk — hub gets paths, not dumps"| Hub
50
+ Team -->|"subagents: block (delegate_depth ≥ 1)"| Subs
51
+ Subs -.->|"results return to the parent agent only"| Team
52
+ Team -.->|"structured return + evidence"| Hub
53
+ Hub -.->|"one status line: Assertions: 2✓ 1○ 1✗"| You
54
+ ```
55
+
56
+ Every specialist session is one persona from [`agents/`](../agents/) — *skills* tell each agent **how** to work; *personas* define **who** they are (see [agents.md](agents.md)).
57
+
58
+ The same idea as a tree:
59
+
60
+ ```text
61
+ hub (orchestrator)
62
+ ├── team: default
63
+ │ ├── planner → scout · rules · risk
64
+ │ ├── plan-reviewer → feasibility · deps
65
+ │ ├── builder → recon · verifier
66
+ │ ├── test-engineer → coverage-scout · conventions
67
+ │ ├── code-reviewer → preflight · quality · perf · docs
68
+ │ └── documenter
69
+ ├── research helpers (spawn_research, any time)
70
+ │ ├── researcher
71
+ │ └── deep-researcher
72
+ └── optional fleet peers (herdr + coms)
73
+ ├── architect / releaser / web-debugger panes
74
+ ├── Claude Code peer (coms bridge)
75
+ ├── Hermes (phone human · inbound ask_user)
76
+ └── Codex Remote Control (Android · outbound coms delegation)
77
+ ```
78
+
79
+ Composition rule: **the hub (or a slash command) orchestrates; personas do not invoke other personas as peers.** Specialists may only fan out to their configured **sub-agents**. Research helpers write findings to disk; the hub resumes specialists with paths, not raw dumps.
80
+
81
+ ### Research search supervision
82
+
83
+ The shared `spawnPiAgent` seam supervises every `read`/`grep`/`find`/`ls` call from native
84
+ research helpers and nested delegate children. The supervisor tracks JSONL `toolCallId` values
85
+ independently, with a default 120-second deadline (`recon-search-timeout-s: 1..3600|off` under
86
+ `## agent-hub`). It is a per-tool watchdog; the whole-run bound is separate — the execution
87
+ mode's per-run deadline (`agent-turn-timeout-s`), which terminates a hung run as `turn_timeout`.
88
+ On timeout or caller cancellation it owns and terminates the child's process group (SIGTERM,
89
+ then SIGKILL after a bounded grace), has a separate settlement timer for missing `close`/pipe
90
+ drain, and reports timeout separately from cancellation. Research helpers and nested delegates
91
+ are each given safe process-group ownership; delegates forward parent termination so no detached
92
+ child is orphaned. Full pattern catalog: [references/orchestration-patterns.md](../references/orchestration-patterns.md).
93
+
94
+ ### Execution modes & turn budgets
95
+
96
+ The hub enforces per-user-turn budgets in code (`run-budget.js`): `fast`/`standard`/`strict`
97
+ modes cap `dispatch_agent` calls, `spawn_research` calls, and wall clock per turn, set the
98
+ per-run deadline above, and control nested delegation. Exhausted budgets make the dispatch
99
+ tools refuse with "summarize and ask the user"; a new user message opens a fresh window.
100
+ Specialist context pressure is measured over input + cacheRead + cacheWrite against **that
101
+ agent's own** model window, resolved from pi's model registry with the source recorded
102
+ (`context-window.js`) — measuring a 49k local model against the dispatcher's window is what
103
+ made readings like "315%" unactionable; anything over 100% now emits a one-time diagnostic
104
+ naming the window and where it came from. Specialist sessions are recycled (fresh spawn
105
+ instead of `-c` resume) after `session-recycle-runs` runs, at ≥60% measured context, and
106
+ unconditionally at a full window; a resumed session whose *projected* prompt would overflow
107
+ is recycled before the spawn rather than after the run. Requests to one provider are capped
108
+ per process (`provider-semaphore.js`: 2 in flight for `custom/*` by default, unlimited
109
+ elsewhere, `AGENT_HUB_PROVIDER_LIMITS` to override) — the cap is per level of the delegation
110
+ tree, and a nested spawn reuses its parent's permit so it can never wait on its own ancestor.
111
+ Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
112
+ `max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`);
113
+ switched live with `/af-hub-mode`.
114
+
115
+ On top of the mode sit three qualitative guardrails. **Task triage**: the dispatcher
116
+ classifies each turn via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
117
+ and the caps drop to min(mode, tier); a duplicate-dispatch guard refuses near-identical
118
+ re-dispatches within a turn. **Drift watchdog** (`drift-watchdog.js`): armed dispatches are
119
+ observed in-flight from the JSON event stream — deterministic rules (out-of-scope writes
120
+ against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
121
+ escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
122
+ `drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
123
+ (`watchdog` key, `/af-watchdog`, `watchdog` param). Two rules about scope: the session's
124
+ own `artifacts/`, `findings/`, and `delegations/` subtrees are implicitly in scope (the
125
+ deliverable protocol *orders* specialists to write there, and the judge is told so), and the
126
+ `scope` rule is non-terminal — it reports a drift advisory on the result and never stops a
127
+ run by itself, matching the post-run scope gate, which reverts nothing. **Dynamic teams**: `/af-agents-add`,
128
+ `/af-agents-drop`, `/af-agents-save` restructure the roster live (the system prompt rebuilds
129
+ every turn), and the gated `team_adjust` tool lets the dispatcher itself adjust the roster
130
+ outside fast mode, with user notification. `/af-hub-report` accounts each turn's dispatches,
131
+ tokens (billed = input + cacheRead + cacheWrite), recycles, drift stops, and refusals.
132
+
133
+ ## Runtime stack (tools the fleet sits on)
134
+
135
+ ```mermaid
136
+ flowchart TD
137
+ AF["<b>Agent Fleet</b><br/>agent-hub · personas · skills · coms · bridges · CLI"]
138
+ AF -->|primary runtime| PI["<b>pi</b><br/>coding agent — loads harnesses,<br/>extensions, prompts, personas"]
139
+ AF -->|control plane| HERDR["<b>herdr</b><br/>tiled peer workspaces,<br/>presence, snapshot/resume"]
140
+ AF -->|peer + install target| CC["<b>Claude Code</b><br/>bidirectional peer via<br/>the coms bridge"]
141
+ AF -->|install target| OC["<b>OpenCode</b><br/>skill-driven execution<br/>(AGENTS.md + skill tool)"]
142
+ AF -->|remote human| HERMES["<b>Hermes</b><br/>hub questions relayed to your phone,<br/>plus the Desktop fleet panel"]
143
+ AF -->|outbound remote delegation| CODEX["<b>Codex Remote Control</b><br/>Android-approved calls to<br/>listed coms peers (experimental)"]
144
+ ```
145
+
146
+ ### External dependencies
147
+
148
+ These are the external systems Agent Fleet assumes or integrates with — not npm packages, but the **runtime stack** the fleet operates on top of.
149
+
150
+ | Dependency | Role | Required? |
151
+ | --- | --- | --- |
152
+ | **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for full fleet mode (`just fleet hub`) |
153
+ | **[herdr](https://herdr.dev)** | Workspace control plane: tiled peer panes, presence push events, team snapshot/resume | Yes for team mode (`just fleet team`); optional for `just fleet hub` |
154
+ | **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class peer via the [coms bridge](claude-code-coms-bridge.md); also a supported install target for skills/personas | Optional peer / alternate harness |
155
+ | **[OpenCode](https://opencode.ai)** | Skill-driven execution target (`AGENTS.md` + `skill` tool); `af-*` slash commands | Optional alternate harness |
156
+ | **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions — [coms-hermes-bridge](coms-hermes-bridge.md)) and the Desktop fleet panel ([hermes-desktop-plugins](hermes-desktop-plugins.md), needs v0.19.0+ and the Desktop app) | Optional |
157
+ | **Codex CLI + ChatGPT Android** | Experimental outbound remote-control conductor on supported `0.144.x`; requires Node `22.6+`, user systemd, interactive pairing, and per-command mobile approvals — [runbook](codex-remote-conductor.md) | Optional / revalidate after minor-version or mobile-client changes |
158
+ | **[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)** | Upstream skill library (manually vendored) | Bundled (vendored) |
159
+ | **[disler/pi-vs-claude-code](https://github.com/disler/pi-vs-claude-code)** | Source inspiration / MIT port origin for pi harnesses | Design lineage (ported in-repo) |
160
+ | **LLM providers** | Models per persona (`model:` / `models:` in agent frontmatter) — e.g. OpenAI Codex, GitHub Copilot, Ollama, … | Yes (at least one provider your agents can call) |
161
+ | **Chrome DevTools MCP** / **Playwright Agent CLI** | Browser verify (`browser-testing-with-devtools`) and headless automation (`bowser`) | Optional, feature-specific |
162
+ | **Node.js + npm** | CLI (`npx @chankov/agent-fleet`), package install, `just` recipes | Yes for install & tooling |
163
+
164
+ ## Repository module map
165
+
166
+ ```text
167
+ .pi/ # Pi runtime: harnesses, extensions, agents config, prompts
168
+ skills/ # Agent Fleet-native skills (shadow vendored names)
169
+ agents/ # Personas/subagents used by Agent Fleet
170
+ scripts/ # CLI helpers, bridges, team launchers (pure logic in scripts/lib/)
171
+ hermes/ # Hermes-facing skills/integration assets
172
+ codex/ # Canonical Codex conductor contract (runtime copy lives outside checkout)
173
+ systemd/user/ # Owned user-unit template for Codex remote control
174
+ vendor/agent-skills-upstream/ # Manually imported upstream skills (pinned SHA)
175
+ bin/ # npm CLI: init/update/doctor/transform-persona
176
+ hooks/ # Session lifecycle + coms Stop hooks
177
+ references/ # Supplementary checklists (see fleet-coordination-patterns.md)
178
+ docs/ # This file, setup guides, bridge references, vendoring policy
179
+ ```
180
+
181
+ Reserved for future modules (do not repurpose these paths):
182
+
183
+ ```text
184
+ apps/dashboard/ # future dashboard: Kanban state, Herdr workspaces, peer status
185
+ packages/fleet-core/ # future extracted core orchestration library
186
+ packages/herdr-bridge/ # future Herdr integration package
187
+ packages/hermes-bridge/ # future Hermes integration package
188
+ ```
189
+
190
+ ## Design rules
191
+
192
+ - **Thin dispatcher context.** Nothing lands persistently in the dispatcher's
193
+ context if it can live on disk or in a one-line status. Research findings,
194
+ the Verification Contract ledger, and team snapshots are all disk-first.
195
+ - **A harness fault must never look like a specialist fault.** The hub passes
196
+ `--session <file>` on every run, so one corrupt session file used to fail a
197
+ persona in ~1s with no output — indistinguishable from a bad agent, and
198
+ unrecoverable by drop + re-add. Unusable session files are now validated and
199
+ quarantined (`session-health.js`) with the reset named in the result. Same rule
200
+ for the return contract: a report the parser cannot read gets one cheap
201
+ read-only extraction pass (`return-extract.js`) before its assertions are
202
+ written off as unproven, and extracted evidence is always labelled as weaker
203
+ than declared evidence. The converse also holds: a run that errored or timed
204
+ out writes to `artifacts/failures/`, never `returns/` — an error stub filed
205
+ as a return reads as a specialist verdict and gets acted on as one.
206
+ - **A pool status field beats reading the screen.** `coms_list` publishes each
207
+ peer's `pane_id` and `status` (`idle`/`working`/`booting`), and
208
+ `herdr_spawn_peer` waits for the peer to register and returns `peer_ready`
209
+ rather than a bare pane id. A spawned peer boots idle and does nothing until
210
+ addressed, so peers spawned and never sent to are named at turn end and in
211
+ `/af-hub-report` (`spawned-peers.js`); closing stays the human's call.
212
+ - **A declared requirement carries its origin.** Every assertion in the ledger
213
+ names its source (`assertion-ledger.js`), and the open ledger is soft-capped
214
+ at 8 — an id nobody can trace back to a plan line costs a dispatch and an
215
+ ASK_USER cycle to re-derive.
216
+ - **Pre-flight validation is free.** Anything the hub can reject before spawning
217
+ — an unresolvable artifact path, an unknown research persona — is refused
218
+ without spending a turn-budget slot. Artifact paths also resolve across
219
+ artifact kinds when the name is unique, since the hub writes every auto-return
220
+ under `returns/` while dispatchers reasonably guess `reviews/`.
221
+ - **Herdr owns panes, presence, and lifecycle; coms owns messages.** Fleet
222
+ recipes hard-require a running herdr server and refuse with an actionable
223
+ message otherwise; non-fleet recipes never touch herdr.
224
+ - **External agents are peers, not plugins.** Claude Code (and future CLI
225
+ agents) join the fleet through bridge adaptors that speak coms envelopes —
226
+ the fleet core stays agent-agnostic. Hermes remains the inbound `ask_user`/
227
+ Telegram route; the experimental Codex conductor is outbound-initiated only,
228
+ approval-gated, and restricted to listed peers through the validated wrapper.
229
+ - **Hermes monitor presentation is outside the fleet core.** Agent Fleet exposes owner-only
230
+ local monitor operations for Hub-owned state; a consumer owns its UI and lifecycle. The
231
+ worktree contains additive monitor/event/invoke code, but that implementation and its local
232
+ tests are not proof of a durable external identity or live delivery contract. `invoke`, where
233
+ available, is Hub-owned and queues dispatcher work rather than exposing tools directly.
234
+ - **Packaged Hermes source is opt-in, never auto-installed.** The npm tarball carries the
235
+ `hub-watchdog` skill (`hermes/skills/`) plus the backend and Desktop monitor plugin source
236
+ (`hermes/plugins/`, `hermes/desktop-plugins/`) as runtime-only source. Shipping that source
237
+ makes it available to an operator; installing it into a Hermes profile is always an explicit
238
+ action through `agent-fleet set-hermes-watchdog` (skill) or the consumer's own flow (plugins).
239
+ Nothing is enabled, launched, or configured by installing the package.
240
+ - **Watchdog delivery is capability-gated and currently unproven.** No checked-in
241
+ Gate O live artifact proves Hermes origin identity, updates, reconnect, or two-chat isolation,
242
+ so its supported posture is journal-only/dormant: no delivery, steering, or surgical use. It
243
+ never manages services, gateways, Herdr, or shell commands. Local runtime evidence — including
244
+ a real foreground watcher against a disposable Hub UDS — is `synthetic-local` and proves none of
245
+ those capabilities; see [the watchdog runbook](hermes-watchdog-supervisor.md).
246
+ - **External conductor contracts are advisory.** Pi damage-control wraps Pi
247
+ tool calls, not Hermes or Codex processes; human approvals and their
248
+ contracts reduce risk but do not provide an OS command allowlist.
249
+ - **Destructive fleet verbs are damage-control-guarded.** Specialists cannot
250
+ spawn/close herdr panes; the human confirms destructive actions.
251
+ - **Native-over-vendored skills.** The skill catalogue resolves `skills/`
252
+ first, then the vendored upstream import; upstream updates are explicit
253
+ maintainer actions ([UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md)).
254
+
255
+ ## History
256
+
257
+ Agent Fleet began as a fork of `addyosmani/agent-skills` and was split into a
258
+ standalone repository in July 2026, with upstream demoted to vendored content.
259
+ The one-time migration record, including the history-filtering commands, lives
260
+ in [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md); the product
261
+ requirements that drove the split are in
262
+ [prd-agent-fleet-split.md](prd-agent-fleet-split.md).