@chankov/agent-fleet 0.0.3 → 0.0.5

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 (608) hide show
  1. package/.claude/commands/set-hermes-telegram.md +15 -0
  2. package/.claude/commands/setup-agent-fleet.md +1 -1
  3. package/.opencode/commands/af-set-hermes-telegram.md +15 -0
  4. package/.opencode/commands/af-setup-agent-fleet.md +1 -1
  5. package/.pi/agents/dispatch-policy.yaml +1 -1
  6. package/.pi/agents/peers.yaml +4 -4
  7. package/.pi/extensions/chrome-devtools-mcp/README.md +1 -1
  8. package/.pi/extensions/mcp-bridge/README.md +1 -1
  9. package/.pi/harnesses/agent-hub/README.md +223 -40
  10. package/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  11. package/.pi/harnesses/agent-hub/delegate.ts +32 -9
  12. package/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  13. package/.pi/harnesses/agent-hub/footer.ts +29 -0
  14. package/.pi/harnesses/agent-hub/helpers.ts +49 -0
  15. package/.pi/harnesses/agent-hub/index.ts +1037 -246
  16. package/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  17. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  18. package/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  19. package/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  20. package/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  21. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  22. package/.pi/harnesses/agent-hub/package.json +5 -4
  23. package/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  24. package/.pi/harnesses/agent-hub/run-budget.js +155 -0
  25. package/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  26. package/.pi/harnesses/agent-hub/spawn.ts +161 -94
  27. package/.pi/harnesses/agent-hub/version.ts +18 -0
  28. package/.pi/harnesses/ask-user-remote/README.md +1 -0
  29. package/.pi/harnesses/ask-user-remote/index.ts +36 -8
  30. package/.pi/harnesses/coms/README.md +15 -5
  31. package/.pi/harnesses/coms/index.ts +2 -0
  32. package/.pi/harnesses/coms/package.json +5 -4
  33. package/.pi/harnesses/coms/version.ts +18 -0
  34. package/.pi/harnesses/damage-control-continue/README.md +36 -35
  35. package/.pi/harnesses/damage-control-continue/index.ts +23 -9
  36. package/.pi/harnesses/damage-control-continue/package.json +5 -4
  37. package/.pi/harnesses/damage-control-continue/version.ts +18 -0
  38. package/.pi/harnesses/{damage-control/shared.ts → lib/damage-control-shared.ts} +20 -6
  39. package/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  40. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  41. package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  42. package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  43. package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  44. package/.pi/prompts/set-hermes-telegram.md +15 -0
  45. package/.pi/prompts/setup-agent-fleet.md +1 -1
  46. package/.versions/0.0.4/.claude/commands/build.md +44 -0
  47. package/.versions/0.0.4/.claude/commands/code-simplify.md +22 -0
  48. package/.versions/0.0.4/.claude/commands/design-agent.md +14 -0
  49. package/.versions/0.0.4/.claude/commands/doctor-agent-fleet.md +17 -0
  50. package/.versions/0.0.4/.claude/commands/orchestrate.md +112 -0
  51. package/.versions/0.0.4/.claude/commands/plan.md +16 -0
  52. package/.versions/0.0.4/.claude/commands/prime.md +22 -0
  53. package/.versions/0.0.4/.claude/commands/review.md +16 -0
  54. package/.versions/0.0.4/.claude/commands/setup-agent-fleet.md +25 -0
  55. package/.versions/0.0.4/.claude/commands/ship.md +72 -0
  56. package/.versions/0.0.4/.claude/commands/spec.md +15 -0
  57. package/.versions/0.0.4/.claude/commands/test.md +19 -0
  58. package/.versions/0.0.4/.claude/commands/webperf.md +32 -0
  59. package/.versions/0.0.4/.claude/orchestrate-teams.yaml +24 -0
  60. package/.versions/0.0.4/.opencode/commands/af-build.md +17 -0
  61. package/.versions/0.0.4/.opencode/commands/af-code-simplify.md +16 -0
  62. package/.versions/0.0.4/.opencode/commands/af-compound.md +16 -0
  63. package/.versions/0.0.4/.opencode/commands/af-design-agent.md +15 -0
  64. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  65. package/.versions/0.0.4/.opencode/commands/af-orchestrate.md +112 -0
  66. package/.versions/0.0.4/.opencode/commands/af-plan.md +16 -0
  67. package/.versions/0.0.4/.opencode/commands/af-prime.md +22 -0
  68. package/.versions/0.0.4/.opencode/commands/af-review.md +15 -0
  69. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +15 -0
  70. package/.versions/0.0.4/.opencode/commands/af-ship.md +16 -0
  71. package/.versions/0.0.4/.opencode/commands/af-spec.md +16 -0
  72. package/.versions/0.0.4/.opencode/commands/af-test.md +21 -0
  73. package/.versions/0.0.4/.opencode/commands/af-webperf.md +32 -0
  74. package/.versions/0.0.4/.opencode/orchestrate-teams.yaml +24 -0
  75. package/.versions/0.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  76. package/.versions/0.0.4/.pi/agents/model-profiles.yaml +20 -0
  77. package/.versions/0.0.4/.pi/agents/peers.yaml +146 -0
  78. package/.versions/0.0.4/.pi/agents/teams.yaml +39 -0
  79. package/.versions/0.0.4/.pi/damage-control-rules.yaml +297 -0
  80. package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  81. package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  82. package/{.pi/harnesses/damage-control → .versions/0.0.4/.pi/extensions/agent-fleet-update-check}/package.json +1 -1
  83. package/.versions/0.0.4/.pi/extensions/btw/README.md +118 -0
  84. package/.versions/0.0.4/.pi/extensions/btw/index.ts +917 -0
  85. package/.versions/0.0.4/.pi/extensions/btw/package.json +6 -0
  86. package/.versions/0.0.4/.pi/extensions/btw/state.js +179 -0
  87. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  88. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  89. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  90. package/.versions/0.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  91. package/.versions/0.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  92. package/.versions/0.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  93. package/.versions/0.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  94. package/.versions/0.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  95. package/.versions/0.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  96. package/.versions/0.0.4/.pi/extensions/package-lock.json +1143 -0
  97. package/.versions/0.0.4/.pi/extensions/package.json +9 -0
  98. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/README.md +201 -0
  99. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  100. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  101. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  102. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  103. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  104. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  105. package/.versions/0.0.4/.pi/harnesses/agent-hub/README.md +798 -0
  106. package/.versions/0.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  107. package/.versions/0.0.4/.pi/harnesses/agent-hub/artifacts.js +92 -0
  108. package/.versions/0.0.4/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  109. package/.versions/0.0.4/.pi/harnesses/agent-hub/delegate.ts +386 -0
  110. package/.versions/0.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  111. package/.versions/0.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  112. package/.versions/0.0.4/.pi/harnesses/agent-hub/footer.ts +29 -0
  113. package/.versions/0.0.4/.pi/harnesses/agent-hub/helpers.ts +214 -0
  114. package/.versions/0.0.4/.pi/harnesses/agent-hub/index.ts +8045 -0
  115. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  116. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  117. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  118. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  119. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  120. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  121. package/.versions/0.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  122. package/.versions/0.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
  123. package/.versions/0.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  124. package/.versions/0.0.4/.pi/harnesses/agent-hub/return-contract.js +215 -0
  125. package/.versions/0.0.4/.pi/harnesses/agent-hub/run-budget.js +155 -0
  126. package/.versions/0.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  127. package/.versions/0.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  128. package/.versions/0.0.4/.pi/harnesses/agent-hub/spawn.ts +246 -0
  129. package/.versions/0.0.4/.pi/harnesses/agent-hub/version.ts +18 -0
  130. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/README.md +18 -0
  131. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/index.ts +293 -0
  132. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  133. package/.versions/0.0.4/.pi/harnesses/coms/README.md +92 -0
  134. package/.versions/0.0.4/.pi/harnesses/coms/index.ts +1745 -0
  135. package/.versions/0.0.4/.pi/harnesses/coms/package.json +7 -0
  136. package/.versions/0.0.4/.pi/harnesses/coms/version.ts +18 -0
  137. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/README.md +117 -0
  138. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  139. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  140. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/version.ts +18 -0
  141. package/.versions/0.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  142. package/.versions/0.0.4/.pi/harnesses/lib/herdr-client.ts +458 -0
  143. package/.versions/0.0.4/.pi/harnesses/lib/herdr-presence.ts +288 -0
  144. package/.versions/0.0.4/.pi/harnesses/package-lock.json +35 -0
  145. package/.versions/0.0.4/.pi/harnesses/package.json +9 -0
  146. package/.versions/0.0.4/.pi/prompts/build.md +24 -0
  147. package/.versions/0.0.4/.pi/prompts/code-simplify.md +22 -0
  148. package/.versions/0.0.4/.pi/prompts/doctor-agent-fleet.md +15 -0
  149. package/.versions/0.0.4/.pi/prompts/plan.md +16 -0
  150. package/.versions/0.0.4/.pi/prompts/review.md +16 -0
  151. package/.versions/0.0.4/.pi/prompts/setup-agent-fleet.md +27 -0
  152. package/.versions/0.0.4/.pi/prompts/ship.md +17 -0
  153. package/.versions/0.0.4/.pi/prompts/spec.md +15 -0
  154. package/.versions/0.0.4/.pi/prompts/test.md +19 -0
  155. package/.versions/0.0.4/.pi/skills/bowser/SKILL.md +145 -0
  156. package/.versions/0.0.4/.version +1 -0
  157. package/.versions/0.0.4/agents/architect.md +23 -0
  158. package/.versions/0.0.4/agents/bowser.md +26 -0
  159. package/.versions/0.0.4/agents/builder.md +53 -0
  160. package/.versions/0.0.4/agents/code-reviewer.md +205 -0
  161. package/.versions/0.0.4/agents/deep-researcher.md +31 -0
  162. package/.versions/0.0.4/agents/documenter.md +18 -0
  163. package/.versions/0.0.4/agents/orchestrator.md +54 -0
  164. package/.versions/0.0.4/agents/plan-reviewer.md +60 -0
  165. package/.versions/0.0.4/agents/planner.md +69 -0
  166. package/.versions/0.0.4/agents/releaser.md +24 -0
  167. package/.versions/0.0.4/agents/researcher.md +28 -0
  168. package/.versions/0.0.4/agents/security-auditor.md +166 -0
  169. package/.versions/0.0.4/agents/test-engineer.md +151 -0
  170. package/.versions/0.0.4/agents/web-debugger.md +42 -0
  171. package/.versions/0.0.4/agents/web-performance-auditor.md +192 -0
  172. package/.versions/0.0.4/codex/CONDUCTOR.md +148 -0
  173. package/.versions/0.0.4/docs/ARCHITECTURE.md +210 -0
  174. package/.versions/0.0.4/docs/agent-fleet-setup.md +366 -0
  175. package/.versions/0.0.4/docs/claude-code-coms-bridge.md +103 -0
  176. package/.versions/0.0.4/docs/codex-remote-conductor.md +170 -0
  177. package/.versions/0.0.4/docs/coms-hermes-bridge.md +121 -0
  178. package/.versions/0.0.4/docs/getting-started.md +183 -0
  179. package/.versions/0.0.4/docs/npm-install.md +337 -0
  180. package/.versions/0.0.4/docs/opencode-setup.md +248 -0
  181. package/.versions/0.0.4/docs/pi-extensions.md +288 -0
  182. package/.versions/0.0.4/docs/pi-setup.md +463 -0
  183. package/.versions/0.0.4/docs/skill-anatomy.md +150 -0
  184. package/.versions/0.0.4/hermes/README.md +228 -0
  185. package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  186. package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  187. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  188. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  189. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  190. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  191. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  192. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  193. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  194. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  195. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  196. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  197. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  198. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  199. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  200. package/.versions/0.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  201. package/.versions/0.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  202. package/.versions/0.0.4/hooks/SIMPLIFY-IGNORE.md +90 -0
  203. package/.versions/0.0.4/hooks/coms-stop-hook.mjs +73 -0
  204. package/.versions/0.0.4/hooks/hooks.json +14 -0
  205. package/.versions/0.0.4/hooks/session-start.sh +74 -0
  206. package/.versions/0.0.4/hooks/simplify-ignore.sh +302 -0
  207. package/.versions/0.0.4/justfile +256 -0
  208. package/.versions/0.0.4/references/accessibility-checklist.md +160 -0
  209. package/.versions/0.0.4/references/definition-of-done.md +67 -0
  210. package/.versions/0.0.4/references/fleet-coordination-patterns.md +151 -0
  211. package/.versions/0.0.4/references/observability-checklist.md +91 -0
  212. package/.versions/0.0.4/references/orchestration-patterns.md +370 -0
  213. package/.versions/0.0.4/references/performance-checklist.md +153 -0
  214. package/.versions/0.0.4/references/prompting-patterns.md +380 -0
  215. package/.versions/0.0.4/references/security-checklist.md +179 -0
  216. package/.versions/0.0.4/references/testing-patterns.md +236 -0
  217. package/.versions/0.0.4/scripts/codex-conductor.ts +41 -0
  218. package/.versions/0.0.4/scripts/codex-remote-control.ts +167 -0
  219. package/.versions/0.0.4/scripts/coms-claude-bridge.ts +286 -0
  220. package/.versions/0.0.4/scripts/coms-cli.ts +484 -0
  221. package/.versions/0.0.4/scripts/coms-hermes-bridge.ts +403 -0
  222. package/.versions/0.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  223. package/.versions/0.0.4/scripts/hermes-monitor-scenario.ts +7 -0
  224. package/.versions/0.0.4/scripts/lib/claude-bridge-core.ts +100 -0
  225. package/.versions/0.0.4/scripts/lib/codex-conductor.ts +88 -0
  226. package/.versions/0.0.4/scripts/lib/codex-remote-control.ts +480 -0
  227. package/.versions/0.0.4/scripts/lib/coms-envelope.ts +539 -0
  228. package/.versions/0.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  229. package/.versions/0.0.4/scripts/lib/herdr-layout.ts +263 -0
  230. package/.versions/0.0.4/scripts/lib/hermes-bridge-core.ts +238 -0
  231. package/.versions/0.0.4/scripts/lib/hermes-monitor-herdr.ts +28 -0
  232. package/.versions/0.0.4/scripts/lib/hermes-monitor-model.ts +9 -0
  233. package/.versions/0.0.4/scripts/lib/hermes-monitor-registry.ts +6 -0
  234. package/.versions/0.0.4/scripts/lib/hermes-monitor-socket.ts +118 -0
  235. package/.versions/0.0.4/scripts/lib/hermes-monitor-store.ts +31 -0
  236. package/.versions/0.0.4/scripts/lib/persona-banner.ts +62 -0
  237. package/.versions/0.0.4/scripts/lib/spawn-stagger.ts +101 -0
  238. package/.versions/0.0.4/scripts/lib/team-project.ts +184 -0
  239. package/.versions/0.0.4/scripts/lib/team-snapshot.ts +147 -0
  240. package/.versions/0.0.4/scripts/peer-banner.ts +40 -0
  241. package/.versions/0.0.4/scripts/team-snapshot.ts +238 -0
  242. package/.versions/0.0.4/scripts/team-up.ts +333 -0
  243. package/.versions/0.0.4/skills/_internal/grilling.md +11 -0
  244. package/.versions/0.0.4/skills/browser-testing-with-devtools/SKILL.md +352 -0
  245. package/.versions/0.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  246. package/.versions/0.0.4/skills/compound-learning/SKILL.md +137 -0
  247. package/.versions/0.0.4/skills/context-engineering/SKILL.md +291 -0
  248. package/.versions/0.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  249. package/.versions/0.0.4/skills/designing-agents/SKILL.md +394 -0
  250. package/.versions/0.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  251. package/.versions/0.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  252. package/.versions/0.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  253. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +535 -0
  254. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +33 -0
  255. package/.versions/0.0.4/skills/idea-refine/SKILL.md +182 -0
  256. package/.versions/0.0.4/skills/idea-refine/examples.md +238 -0
  257. package/.versions/0.0.4/skills/idea-refine/frameworks.md +99 -0
  258. package/.versions/0.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  259. package/.versions/0.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  260. package/.versions/0.0.4/skills/incremental-implementation/SKILL.md +287 -0
  261. package/.versions/0.0.4/skills/interview-me/SKILL.md +226 -0
  262. package/.versions/0.0.4/skills/orchestration-verification/SKILL.md +181 -0
  263. package/.versions/0.0.4/skills/peer-coms/SKILL.md +90 -0
  264. package/.versions/0.0.4/skills/performance-optimization/SKILL.md +350 -0
  265. package/.versions/0.0.4/skills/planning-and-task-breakdown/SKILL.md +236 -0
  266. package/.versions/0.0.4/skills/security-and-hardening/SKILL.md +461 -0
  267. package/.versions/0.0.4/skills/spec-driven-development/SKILL.md +245 -0
  268. package/.versions/0.0.4/skills/using-agent-skills/SKILL.md +199 -0
  269. package/.versions/0.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  270. package/.versions/0.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  271. package/.versions/0.0.4/vendor/agent-skills-upstream/README.md +11 -0
  272. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  273. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  274. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  275. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  276. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  277. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  278. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  279. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  280. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  281. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  282. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  283. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  284. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  285. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  286. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  287. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  288. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  289. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  290. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  291. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  292. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  293. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  294. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  295. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  296. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  297. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  298. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  299. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  300. package/.versions/0.0.5/.claude/commands/build.md +44 -0
  301. package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
  302. package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
  303. package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
  304. package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
  305. package/.versions/0.0.5/.claude/commands/plan.md +16 -0
  306. package/.versions/0.0.5/.claude/commands/prime.md +22 -0
  307. package/.versions/0.0.5/.claude/commands/review.md +16 -0
  308. package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
  309. package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
  310. package/.versions/0.0.5/.claude/commands/ship.md +72 -0
  311. package/.versions/0.0.5/.claude/commands/spec.md +15 -0
  312. package/.versions/0.0.5/.claude/commands/test.md +19 -0
  313. package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
  314. package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
  315. package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
  316. package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
  317. package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
  318. package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
  319. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  320. package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
  321. package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
  322. package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
  323. package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
  324. package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
  325. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
  326. package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
  327. package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
  328. package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
  329. package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
  330. package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
  331. package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  332. package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
  333. package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
  334. package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
  335. package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
  336. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  337. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  338. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  339. package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
  340. package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
  341. package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
  342. package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
  343. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  344. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  345. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  346. package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  347. package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  348. package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  349. package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  350. package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  351. package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  352. package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
  353. package/.versions/0.0.5/.pi/extensions/package.json +9 -0
  354. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
  355. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  356. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  357. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  358. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  359. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  360. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  361. package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
  362. package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  363. package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
  364. package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  365. package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
  366. package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  367. package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  368. package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
  369. package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
  370. package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
  371. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  372. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  373. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  374. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  375. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  376. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  377. package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  378. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
  379. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  380. package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
  381. package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
  382. package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  383. package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  384. package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
  385. package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
  386. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
  387. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
  388. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  389. package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
  390. package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
  391. package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
  392. package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
  393. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
  394. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  395. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  396. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
  397. package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  398. package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
  399. package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
  400. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  401. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  402. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  403. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  404. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  405. package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
  406. package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
  407. package/.versions/0.0.5/.pi/prompts/build.md +24 -0
  408. package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
  409. package/.versions/0.0.5/.pi/prompts/doctor-agent-fleet.md +15 -0
  410. package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
  411. package/.versions/0.0.5/.pi/prompts/review.md +16 -0
  412. package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
  413. package/.versions/0.0.5/.pi/prompts/setup-agent-fleet.md +27 -0
  414. package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
  415. package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
  416. package/.versions/0.0.5/.pi/prompts/test.md +19 -0
  417. package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
  418. package/.versions/0.0.5/.version +1 -0
  419. package/.versions/0.0.5/agents/architect.md +23 -0
  420. package/.versions/0.0.5/agents/bowser.md +26 -0
  421. package/.versions/0.0.5/agents/builder.md +53 -0
  422. package/.versions/0.0.5/agents/code-reviewer.md +205 -0
  423. package/.versions/0.0.5/agents/deep-researcher.md +31 -0
  424. package/.versions/0.0.5/agents/documenter.md +18 -0
  425. package/.versions/0.0.5/agents/orchestrator.md +54 -0
  426. package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
  427. package/.versions/0.0.5/agents/planner.md +69 -0
  428. package/.versions/0.0.5/agents/releaser.md +24 -0
  429. package/.versions/0.0.5/agents/researcher.md +28 -0
  430. package/.versions/0.0.5/agents/security-auditor.md +166 -0
  431. package/.versions/0.0.5/agents/test-engineer.md +151 -0
  432. package/.versions/0.0.5/agents/web-debugger.md +42 -0
  433. package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
  434. package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
  435. package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
  436. package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
  437. package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
  438. package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
  439. package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
  440. package/.versions/0.0.5/docs/getting-started.md +183 -0
  441. package/.versions/0.0.5/docs/npm-install.md +337 -0
  442. package/.versions/0.0.5/docs/opencode-setup.md +249 -0
  443. package/.versions/0.0.5/docs/pi-extensions.md +293 -0
  444. package/.versions/0.0.5/docs/pi-setup.md +472 -0
  445. package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
  446. package/.versions/0.0.5/hermes/README.md +231 -0
  447. package/.versions/0.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  448. package/.versions/0.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  449. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  450. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  451. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  452. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  453. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  454. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  455. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  456. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  457. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  458. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  459. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  460. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  461. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  462. package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  463. package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  464. package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
  465. package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
  466. package/.versions/0.0.5/hooks/hooks.json +14 -0
  467. package/.versions/0.0.5/hooks/session-start.sh +74 -0
  468. package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
  469. package/.versions/0.0.5/justfile +245 -0
  470. package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
  471. package/.versions/0.0.5/references/definition-of-done.md +67 -0
  472. package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
  473. package/.versions/0.0.5/references/observability-checklist.md +91 -0
  474. package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
  475. package/.versions/0.0.5/references/performance-checklist.md +153 -0
  476. package/.versions/0.0.5/references/prompting-patterns.md +380 -0
  477. package/.versions/0.0.5/references/security-checklist.md +179 -0
  478. package/.versions/0.0.5/references/testing-patterns.md +236 -0
  479. package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
  480. package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
  481. package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
  482. package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
  483. package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
  484. package/.versions/0.0.5/scripts/fleet.ts +141 -0
  485. package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  486. package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
  487. package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
  488. package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
  489. package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
  490. package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
  491. package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  492. package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
  493. package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
  494. package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  495. package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  496. package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  497. package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  498. package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  499. package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  500. package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
  501. package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
  502. package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
  503. package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
  504. package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
  505. package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
  506. package/.versions/0.0.5/scripts/team-up.ts +351 -0
  507. package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
  508. package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
  509. package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  510. package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
  511. package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
  512. package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  513. package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
  514. package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  515. package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  516. package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  517. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
  518. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
  519. package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
  520. package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
  521. package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
  522. package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  523. package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  524. package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
  525. package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
  526. package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
  527. package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
  528. package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
  529. package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
  530. package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
  531. package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
  532. package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
  533. package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  534. package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  535. package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
  536. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  537. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  538. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  539. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  540. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  541. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  542. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  543. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  544. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  545. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  546. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  547. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  548. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  549. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  550. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  551. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  552. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  553. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  554. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  555. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  556. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  557. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  558. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  559. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  560. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  561. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  562. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  563. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  564. package/CHANGELOG.md +62 -0
  565. package/README.md +17 -16
  566. package/agents/builder.md +1 -1
  567. package/agents/code-reviewer.md +1 -1
  568. package/agents/deep-researcher.md +3 -3
  569. package/agents/orchestrator.md +20 -11
  570. package/agents/plan-reviewer.md +3 -3
  571. package/agents/test-engineer.md +11 -4
  572. package/bin/cli.js +83 -1
  573. package/bin/lib/set-hermes-telegram.js +323 -0
  574. package/bin/lib/validate-overrides.js +19 -0
  575. package/bin/sync-harness-versions.js +94 -0
  576. package/docs/ARCHITECTURE.md +49 -4
  577. package/docs/agent-fleet-setup.md +11 -1
  578. package/docs/claude-code-coms-bridge.md +4 -4
  579. package/docs/codex-remote-conductor.md +12 -12
  580. package/docs/coms-hermes-bridge.md +62 -4
  581. package/docs/getting-started.md +4 -4
  582. package/docs/opencode-setup.md +1 -0
  583. package/docs/pi-extensions.md +73 -33
  584. package/docs/pi-setup.md +23 -8
  585. package/hermes/README.md +191 -8
  586. package/justfile +143 -158
  587. package/package.json +13 -5
  588. package/references/fleet-coordination-patterns.md +1 -1
  589. package/scripts/coms-hermes-bridge.ts +18 -8
  590. package/scripts/fleet.ts +141 -0
  591. package/scripts/lib/fake-herdr-server.ts +88 -0
  592. package/scripts/lib/fleet-command.ts +109 -0
  593. package/scripts/lib/hermes-bridge-core.ts +5 -2
  594. package/scripts/lib/hermes-monitor-herdr.ts +2 -0
  595. package/scripts/lib/hermes-monitor-model.ts +3 -0
  596. package/scripts/lib/hermes-monitor-registry.ts +2 -0
  597. package/scripts/lib/hermes-monitor-socket.ts +2 -0
  598. package/scripts/lib/hermes-monitor-store.ts +2 -0
  599. package/scripts/lib/team-project.ts +10 -3
  600. package/scripts/team-snapshot.ts +4 -5
  601. package/scripts/team-up.ts +24 -6
  602. package/skills/designing-agents/SKILL.md +2 -2
  603. package/skills/designing-agents/pi-harness-authoring.md +26 -13
  604. package/skills/guided-workspace-setup/SKILL.md +22 -12
  605. package/skills/guided-workspace-setup/companion-manifest.json +3 -1
  606. package/skills/peer-coms/SKILL.md +1 -1
  607. package/.pi/harnesses/damage-control/README.md +0 -65
  608. package/.pi/harnesses/damage-control/index.ts +0 -250
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Install/status the Hermes liaison or turn its Telegram ask_user bridge on/off
3
+ argument-hint: "<install|status|on|off> [telegram-id] [--profile NAME] [--force] [--restart]"
4
+ ---
5
+
6
+ Run the deterministic Agent Fleet controller with the arguments from `$ARGUMENTS`. Supported forms are:
7
+
8
+ ```text
9
+ set-hermes-telegram install [--profile NAME] [--force] [--restart]
10
+ set-hermes-telegram status [--profile NAME]
11
+ set-hermes-telegram on <telegram-id[:topic-id]> [--profile NAME]
12
+ set-hermes-telegram off <telegram-id[:topic-id]> [--profile NAME]
13
+ ```
14
+
15
+ Use `node bin/cli.js set-hermes-telegram ...` when the checkout-local CLI exists; otherwise use `npx --no-install agent-fleet set-hermes-telegram ...`. Pass parsed values as separately quoted shell arguments. If neither CLI exists, report that Agent Fleet must be installed or updated. Do not reproduce installation or Herdr lifecycle with ad-hoc commands, do not bypass a `--force` refusal, and do not send a test Telegram message. Return the controller output verbatim.
@@ -18,7 +18,7 @@ Removal happens **only** on an explicit `Remove some…` multi-select (empty sel
18
18
 
19
19
  **Personas are generated for non-pi targets.** The personas group lists the full availability roster from `node <source-root>/bin/cli.js transform-persona --list --agent <agent>` (pi-only personas — `bowser`, `orchestrator` — appear only when the agent is `pi`). For `claude-code`/`opencode` the apply step installs personas via `transform-persona --agent <agent> --workspace <workspace> <name…>` — always a generated copy, even in symlink mode — and records the rows with `transformed: true`; status checks diff against the generated output, not the raw canonical source.
20
20
 
21
- **pi harness companions.** When the agent is `pi`, installing/refreshing/removing any harness also refreshes its companions — the `justfile` launch recipes, the `team-up`/`coms-net` scripts, the peer/team YAML, `.pi/damage-control-rules.yaml`, and `.pi/harnesses/package.json`. Refresh the `justfile` from the current source (rewriting only the `agent-fleet:harnesses` managed region so user recipes survive) so retired-harness recipes are pruned and new ones added; a stale `justfile` left after a harness change is the regression this prevents.
21
+ **pi harness companions.** When the agent is `pi`, installing/refreshing/removing any harness also refreshes its companions — the `justfile` launch recipes, the `team-up`/`coms-net` scripts, the peer/team YAML, `.pi/damage-control-rules.yaml`, and `.pi/harnesses/package.json`. `agent-hub` requires only `damage-control-continue` and `ask-user-remote`; auto-include both. Refresh the `justfile` from the current source (rewriting only the `agent-fleet:harnesses` managed region so user recipes survive) so retired-harness recipes are pruned and new ones added. Treat the retired `damage-control` hard-stop directory as `gone`: remove it only when recorded and unchanged against the recorded snapshot, or when it is a symlink into the source root (including a broken retirement link). Preserve every user-modified or unowned copy.
22
22
 
23
23
  **No mid-apply overwrite prompts.** The `mod` description already warns that refreshing overwrites local edits. The user's selection is the consent; the Step 9 confirmation is the single gate. During apply, refresh selected items unconditionally — never pause to ask "should I overwrite this file?". Genuine errors (permission denied, missing source) still stop and report.
24
24
 
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Install/status the Hermes liaison or turn its Telegram ask_user bridge on/off
3
+ argument-hint: "<install|status|on|off> [telegram-id] [--profile NAME] [--force] [--restart]"
4
+ ---
5
+
6
+ Run the deterministic Agent Fleet controller with the arguments from `$ARGUMENTS`. Supported forms are:
7
+
8
+ ```text
9
+ set-hermes-telegram install [--profile NAME] [--force] [--restart]
10
+ set-hermes-telegram status [--profile NAME]
11
+ set-hermes-telegram on <telegram-id[:topic-id]> [--profile NAME]
12
+ set-hermes-telegram off <telegram-id[:topic-id]> [--profile NAME]
13
+ ```
14
+
15
+ Use `node bin/cli.js set-hermes-telegram ...` when the checkout-local CLI exists; otherwise use `npx --no-install agent-fleet set-hermes-telegram ...`. Pass parsed values as separately quoted shell arguments. If neither CLI exists, report that Agent Fleet must be installed or updated. Do not reproduce installation or Herdr lifecycle with ad-hoc commands, do not bypass a `--force` refusal, and do not send a test Telegram message. Return the controller output verbatim.
@@ -8,7 +8,7 @@ Run the guided install for a target workspace. If the user passed a workspace pa
8
8
 
9
9
  The Skills group draws from **two roots**: fleet-native `skills/` and the vendored upstream import `vendor/agent-skills-upstream/skills/` (see `docs/UPSTREAM-SKILLS.md`). On a name collision the native copy wins — never offer the vendored duplicate as a separate row.
10
10
 
11
- Analyse the workspace, then present the install menu per the skill's Step 1 interaction contract: with a native select widget, open with the **Express question** (`Recommended ★` / `Everything` / `Custom — group by group`, or the installed-state variants), and on `Custom` run the **7 groups** (4 shared: Skills, Agent personas, Commands/prompts, References & Hooks; 3 pi-only — an opencode workspace sees just the 4 shared groups) as single-select quick screens with multi-select drill-ins only behind `Customise`, chunked by sub-category; installed state shows as counts and plain-words descriptions (no pre-checking), removal only via an explicit `Remove some…` selection, and cancel = keep-as-is. Without a widget, fall back to the skill's tabular format (pre-checked `[x]` tables with text replies). On `pi`, installing/refreshing/removing any harness also refreshes its companions — the `justfile` launch recipes (managed region only, so user recipes survive), the `team-up` script, the peer/team YAML, `.pi/damage-control-rules.yaml`, and `.pi/harnesses/package.json` — refreshed from the current source so retired-harness recipes are pruned and new ones added.
11
+ Analyse the workspace, then present the install menu per the skill's Step 1 interaction contract: with a native select widget, open with the **Express question** (`Recommended ★` / `Everything` / `Custom — group by group`, or the installed-state variants), and on `Custom` run the **7 groups** (4 shared: Skills, Agent personas, Commands/prompts, References & Hooks; 3 pi-only — an opencode workspace sees just the 4 shared groups) as single-select quick screens with multi-select drill-ins only behind `Customise`, chunked by sub-category; installed state shows as counts and plain-words descriptions (no pre-checking), removal only via an explicit `Remove some…` selection, and cancel = keep-as-is. Without a widget, fall back to the skill's tabular format (pre-checked `[x]` tables with text replies). On `pi`, installing/refreshing/removing any harness also refreshes its companions — the `justfile` launch recipes (managed region only, so user recipes survive), the `team-up` script, the peer/team YAML, `.pi/damage-control-rules.yaml`, and `.pi/harnesses/package.json` — refreshed from the current source so retired-harness recipes are pruned and new ones added. `agent-hub` requires only `damage-control-continue` and `ask-user-remote`. Treat the retired `damage-control` hard-stop directory as `gone`: remove it only when recorded and unchanged against the recorded snapshot, or when it is a symlink into the source root (including a broken retirement link); preserve every user-modified or unowned copy.
12
12
 
13
13
  **Personas are generated for opencode.** The personas group lists the full availability roster from `node <source-root>/bin/cli.js transform-persona --list --agent opencode` (pi-only personas — `bowser`, `orchestrator` — are excluded). The apply step installs them into `.opencode/agent/<name>.md` via `transform-persona --agent opencode --workspace <workspace> <name…>` — always a generated copy, even in symlink mode — and records the rows with `transformed: true`; status checks diff against the generated output, not the raw canonical source.
14
14
 
@@ -1,6 +1,6 @@
1
1
  # Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
2
2
  # DISPATCH time, never at team activation — the hub and its peers boot in
3
- # parallel (`just hub-team <team>`), so a member's coms peer may register
3
+ # parallel (`just fleet team <team>`), so a member's coms peer may register
4
4
  # after the session starts.
5
5
  #
6
6
  # default: native | coms — coms substitutes ANY active-team member that has
@@ -1,8 +1,8 @@
1
1
  # Reusable coms peers, grouped into named teams (parallels teams.yaml).
2
2
  #
3
- # `just team-up <name>` spawns each peer of a team in its own herdr pane
3
+ # `just fleet team <name> --no-hub` spawns each peer in its own Herdr pane
4
4
  # (requires a running herdr server — https://herdr.dev),
5
- # using the hidden `_peer` helper (coms + compact-and-continue + the persona).
5
+ # using the hidden `_peer` helper (guarded Fleet Core + coms + the persona).
6
6
  #
7
7
  # Each peer entry:
8
8
  # name — coms identity (the addressable peer name); overrides persona frontmatter
@@ -26,7 +26,7 @@
26
26
  # runner: claude-code
27
27
  # model: opus
28
28
 
29
- # Hub-only workspace: `just hub-team base --project <name>` creates a Herdr
29
+ # Hub-only workspace: `just fleet team base --project <name>` creates a Herdr
30
30
  # workspace containing only the guarded hub, with no reusable coms peer panes.
31
31
  base:
32
32
 
@@ -56,7 +56,7 @@ docs:
56
56
  persona: researcher
57
57
  model: openai-codex/gpt-5.6-luna
58
58
 
59
- # Mirrored from .pi/agents/teams.yaml for `just team-up <team>`.
59
+ # Mirrored from .pi/agents/teams.yaml for `just fleet team <team>`.
60
60
  default:
61
61
  - name: planner
62
62
  persona: planner
@@ -39,7 +39,7 @@ ln -s /path/to/agent-fleet/.pi/extensions/mcp-bridge .pi/extensions/mcp
39
39
  ln -s /path/to/agent-fleet/.pi/extensions/chrome-devtools-mcp .pi/extensions/chrome-devtools-mcp
40
40
  ```
41
41
 
42
- `mcp-bridge` is a sibling library; `chrome-devtools-mcp` imports it via the relative path. Runtime dependencies are hoisted to `.pi/extensions/package.json` — run `npm ci` there once after cloning `agent-fleet` (see [docs/pi-setup.md](../../../docs/pi-setup.md#optional-pi-extensions)).
42
+ `mcp-bridge` is a sibling library; `chrome-devtools-mcp` imports it via the relative path. Runtime dependencies live in `.pi/extensions/package.json` for cloned/copy installs and are also root production dependencies of the published package so npm-package symlink installs resolve them from the real package path. Run `npm ci` in `.pi/extensions/` once after cloning `agent-fleet` (see [docs/pi-setup.md](../../../docs/pi-setup.md#optional-pi-extensions)); a normal `@chankov/agent-fleet` package install needs no nested install.
43
43
 
44
44
  ## Verify
45
45
 
@@ -43,4 +43,4 @@ pi does not yet have first-class MCP support. This bridge is a **stopgap**: it l
43
43
 
44
44
  ## Dependencies
45
45
 
46
- Runtime dependencies (`@modelcontextprotocol/sdk`, `typebox`) are declared once at `.pi/extensions/package.json` and installed via `npm ci` in the cloned `agent-fleet` repo. Wrapper extensions resolve them from the hoisted `node_modules/` — no per-wrapper install required. `@mariozechner/pi-coding-agent` is supplied by the pi runtime that loads the extension.
46
+ Runtime dependencies (`@modelcontextprotocol/sdk`, `typebox`) are declared at `.pi/extensions/package.json` for cloned/copy installs and duplicated in the root package's production `dependencies` for published-package symlink installs. The duplication is intentional: Node resolves a symlinked extension from its real path inside `@chankov/agent-fleet`, while npm does not install dependencies from a nested `.pi/extensions/package.json`. Run `npm ci` in `.pi/extensions/` for a clone or copied install; a normal `@chankov/agent-fleet` package install supplies the same dependencies at package root. No per-wrapper install is required. `@mariozechner/pi-coding-agent` is supplied by the pi runtime that loads the extension.
@@ -1,10 +1,11 @@
1
1
  # agent-hub
2
2
 
3
3
  A multi-agent dispatcher with [`coms`](../coms/README.md) **embedded** — so the dispatcher is
4
- *also* a peer-to-peer node. The bundled `just hub` recipes load
5
- [`damage-control-continue`](../damage-control-continue/README.md) first, then
6
- [`ask-user-remote`](../ask-user-remote/README.md), so the dispatcher has guardrails and an
7
- `ask_user` handoff tool before `agent-hub` starts. It combines local specialist
4
+ *also* a peer-to-peer node. The recommended `just fleet hub` mode loads Fleet Core
5
+ first: [`damage-control-continue`](../damage-control-continue/README.md),
6
+ [`ask-user-remote`](../ask-user-remote/README.md), STT, Compact & Continue, BTW, and the
7
+ update checker. The dispatcher therefore has guardrails and an `ask_user` handoff tool
8
+ before `agent-hub` starts. It combines local specialist
8
9
  orchestration (fixed specialist grid, read-only research helpers, `/zoom`, kill/restart, per-agent
9
10
  model, dispatcher persona gate) with peer-to-peer collaboration: it can **hand a session off to
10
11
  another main agent** and **use a coms peer as a subagent**.
@@ -15,7 +16,7 @@ another main agent** and **use a coms peer as a subagent**.
15
16
  > [extension catalog](../../../docs/pi-extensions.md) and the
16
17
  > [design plan](../../../docs/plans/agent-hub/).
17
18
 
18
- **Optional phone control:** `just hub-team <team> --project <name>` can supply the live peers for the experimental [Codex Android conductor](../../../docs/codex-remote-conductor.md). Configure Codex for the same project; do not also launch a second `conductor-codex <team>` peer workspace. Hermes remains the inbound `ask_user` route, while Codex performs only human-confirmed, approval-gated outbound delegation.
19
+ **Optional phone control:** `just fleet team <team> --project <name>` can supply the live peers for the experimental [Codex Android conductor](../../../docs/codex-remote-conductor.md). Configure Codex for the same project; do not also launch `just fleet conductor codex <team>` for the same peers. Hermes remains the inbound `ask_user` route, while Codex performs only human-confirmed, approval-gated outbound delegation.
19
20
 
20
21
  ## What it does
21
22
 
@@ -207,11 +208,11 @@ Every borrowed idea from another harness passes one test before it lands: *does
207
208
  test writing is never delegated.
208
209
  - **Dispatcher persona gate** — optional `persona-gate: on` can require an orchestrator persona at
209
210
  session start; by default the dispatcher starts without the gate.
210
- - **Default damage-control guardrails** — `just hub` and `just hub-solo` load the
211
+ - **Default damage-control guardrails** — `just fleet hub` and `just fleet hub --solo` load the
211
212
  `damage-control-continue` harness before `agent-hub`, so dispatcher tool calls are checked against
212
213
  `.pi/damage-control-rules.yaml` and a blocked call feeds back instead of aborting the turn. A
213
- guardrail is also re-loaded into every spawned subagent (see [Safety scope](#safety-scope)):
214
- research helpers get the same continue variant, other specialists get the hard-stop `damage-control`.
214
+ guardrail is also re-loaded into every native specialist, research helper, and nested delegate
215
+ (see [Safety scope](#safety-scope)). Missing safety plumbing refuses child dispatch.
215
216
  - **Embedded coms** — the dispatcher is a discoverable peer on the local machine. Multiple
216
217
  `agent-hub` (or plain `coms`) sessions on the same box find each other through per-project registry
217
218
  files and exchange messages over a unix socket (named pipe on Windows).
@@ -256,6 +257,21 @@ done agents are hidden in compact mode, and the coms pool widget collapses too,
256
257
  collapses to just the prompt and footer. The current mode and binding are shown in the footer
257
258
  (`Alt+A view:dashboard` / `Alt+A view:compact`).
258
259
 
260
+ ### Version footer
261
+
262
+ `agent-hub` renders its local harness version first in its custom footer:
263
+ `v<version> · <model><thinking> · <team>`. It replaces pi's default footer, so it does **not**
264
+ consume or render the shared version status; it reads its own adjacent stamped manifest directly.
265
+ The three persistent-UI harnesses (`agent-hub`, `coms`, and
266
+ `damage-control-continue`) still register that one shared key, which gives default footers one
267
+ version in stacked non-hub sessions. In the supported guardrail-plus-hub stack, the hub's custom
268
+ footer supplies the single visible version. Damage-Control can update its own safety status after
269
+ a violation without overwriting the shared version entry. The canonical source is the
270
+ repository-root `package.json`; the adjacent harness manifest is a synchronized stamp maintained
271
+ by `bin/sync-harness-versions.js`. Its local `version.ts` reader intentionally stays with the
272
+ harness for copied or symlinked installs, but those installs still need the pre-existing full
273
+ `.pi/harnesses/` dependency installation.
274
+
259
275
  ### Voice dictation indicator
260
276
 
261
277
  The custom footer renders the optional [`pi-voice-stt`](../../extensions/pi-voice-stt/README.md)
@@ -333,9 +349,140 @@ research-keep: 8
333
349
  (LRU by finish time, default 4; `all` disables the cap). Auto-research pipe helpers are
334
350
  always pruned as soon as they finish, regardless of this key.
335
351
 
352
+ ### Bounded local-disk searches
353
+
354
+ Every `read`, `grep`, `find`, and `ls` call made by a native research helper or a nested
355
+ `delegate` child has a **parent-side** watchdog. The default is **120 seconds per tool call**;
356
+ it is a per-tool bound, not a whole-run deadline — the whole-run bound is the execution
357
+ mode's per-run deadline below. Configure it in the repository-standard overrides file:
358
+
359
+ ```markdown
360
+ ## agent-hub
361
+ recon-search-timeout-s: 120 # integer 1..3600
362
+ # recon-search-timeout-s: off # disable this per-tool watchdog
363
+ ```
364
+
365
+ Invalid values warn at session start and use 120. Calls are tracked independently by their
366
+ JSONL `toolCallId`; a repeated start/update cannot extend an existing deadline. A timeout returns
367
+ `tool_timeout` with the call metadata, ends the research/delegate lifecycle, sends SIGTERM to the
368
+ child's explicitly owned process group, then SIGKILL after a finite grace period. The parent also
369
+ has a final settlement timer, so it settles rather than waiting indefinitely for `close` or
370
+ inherited pipe drain. If child/process-group death cannot be confirmed after this bounded cleanup,
371
+ the timeout metadata reports `terminationConfirmed: false`: this prevents the parent hanging, but
372
+ may indicate an uninterruptible OS-level process that needs operator attention. This group
373
+ ownership covers descendants even when the pi leader exits first; nested delegates own their groups
374
+ and forward parent cancellation, avoiding detached-orphan processes. Caller
375
+ cancellation follows the same bounded cleanup path but is reported as `cancelled`, not
376
+ `tool_timeout`.
377
+
378
+ ### Execution modes & turn budgets
379
+
380
+ The hub runs one of three **execution modes** — `fast`, `standard` (default), `strict` —
381
+ with **per-user-turn budgets enforced in code**, not prose. This is the guardrail against
382
+ runaway orchestration (the observed failure mode: 100+ dispatches and 100M+ tokens for one
383
+ task, most of it re-billed stale specialist context).
384
+
385
+ | Budget (per user turn) | fast | standard | strict |
386
+ |-----------------------------------|--------|----------|---------|
387
+ | `dispatch_agent` calls | 2 | 8 | 24 |
388
+ | `spawn_research` calls | 1 | 4 | 12 |
389
+ | Turn wall clock | 15 min | 60 min | 240 min |
390
+ | Per-run deadline (specialist/research/delegate) | 10 min | 30 min | off |
391
+ | Specialist session recycled after | 3 runs | 5 runs | 5 runs |
392
+ | Nested delegation | off | on | on |
393
+
394
+ - **fast** — single-specialist path for small, low-risk asks; assertion ledger optional,
395
+ no nested delegation.
396
+ - **standard** — batched execution: one recon max, builder batches of 4–6 plan tasks with
397
+ one gate each, one review gate at the end.
398
+ - **strict** — the full Verification Contract (parity inventories, per-batch gates,
399
+ second confirming reads); use for production migrations and security-sensitive work.
400
+
401
+ When a budget is exhausted, `dispatch_agent`/`spawn_research` **refuse** with instructions
402
+ to summarize and ask the user; the next user message opens a fresh window. Switch modes
403
+ live with `/hub-mode fast|standard|strict` (no argument shows the current mode and usage);
404
+ set the project default and per-axis overrides in the overrides file:
405
+
406
+ ```markdown
407
+ ## agent-hub
408
+ mode: standard # fast|standard|strict
409
+ max-dispatches-per-turn: 8 # integer or off
410
+ max-research-per-turn: 4 # integer or off
411
+ turn-wall-time-s: 3600 # integer or off
412
+ agent-turn-timeout-s: 1800 # whole-run deadline per spawned run; integer or off
413
+ session-recycle-runs: 5 # recycle a specialist session after N resumed runs; integer or off
414
+ ```
415
+
416
+ Two related always-on behaviors: specialist **context pressure is measured over
417
+ input + cacheRead + cacheWrite** (resumed sessions re-send their whole accumulated context
418
+ as cache reads — counting `input` alone hid that entirely), and a specialist session is
419
+ **recycled** (fresh session, no `-c` resume) once it has served `session-recycle-runs` runs
420
+ or its measured context passes 60%. The dispatch result notes the recycle so the dispatcher
421
+ knows the specialist starts without session memory — task text and `artifacts:` paths must
422
+ carry the state, which the deliverable-to-file protocol already ensures.
423
+
424
+ The per-run deadline lands as `turn_timeout` (exit 124) with partial output preserved, for
425
+ dispatched specialists, research helpers, and nested delegate children alike — a hung child
426
+ can no longer hold its parent for hours.
427
+
428
+ ### Task triage (complexity tiers)
429
+
430
+ The dispatcher classifies each user turn with the `set_task_tier` tool BEFORE its first
431
+ dispatch — `trivial` / `small` / `feature` / `project` — and the hub lowers the enforced
432
+ dispatch/research caps to **min(mode, tier)**: trivial = 1 dispatch / 1 research,
433
+ small = 2 / 2, feature = 6 / 4, `project` defers to the mode. Skipping the call makes the
434
+ first dispatch assume `feature` (except in strict mode, where tiers are opt-in). The tier
435
+ resets every user turn and shows in the `hub-mode` status chip (`Mode: standard·small · …`).
436
+ The system prompt ties the tier to the anti-over-engineering rules: a provided plan is a
437
+ spec (no re-planning), assertions stay ≤3 for trivial/small asks, and "using every persona"
438
+ is called out as a smell. Two hygiene guards are enforced in code, not prose: a
439
+ **duplicate-dispatch guard** refuses re-dispatching the same agent with a near-identical
440
+ task inside one turn, and every budget/duplicate refusal is counted in `/hub-report`.
441
+
442
+ ### Drift watchdog (in-flight observation)
443
+
444
+ An armed dispatch is observed **while it runs**, from the same JSON event stream that
445
+ drives the cards — not post-hoc:
446
+
447
+ - **Layer 1 — deterministic rules, zero tokens** (`drift-watchdog.js`): a write/edit
448
+ outside the dispatch's declared `scope` globs, the identical tool call repeated 4×,
449
+ 5 consecutive failed tool calls, or 200 total tool calls in one run.
450
+ - **Layer 2 — LLM judge, escalation only**: when a rule fires (single-flight, 90 s
451
+ cooldown), a one-shot cheap run (default model: the researcher persona's; override with
452
+ `watchdog-judge-model`) reads the original task + declared scope + recent tool trail and
453
+ answers `VERDICT: ON_TRACK|DRIFTING|STUCK`. Judge failures fail open.
454
+ - **Intervention**: DRIFTING/STUCK terminates the run as **`drift_stop`** (exit 125,
455
+ partial output preserved) and the dispatch result instructs: re-dispatch ONCE with a
456
+ corrected, narrowed task — never the same task unchanged.
457
+
458
+ Enablement is dynamic, precedence top to bottom: the `watchdog: true|false` param on a
459
+ single `dispatch_agent` call → a per-agent override (`/watchdog builder on|off|clear`) →
460
+ the hub-wide setting (`/watchdog on|off|auto`, default `auto`, project default via the
461
+ `watchdog:` overrides key). Read-only research helpers are not monitored — they already
462
+ run under the per-tool watchdog + turn deadline and cannot write.
463
+
464
+ ### Dynamic teams
465
+
466
+ Rosters start from `.pi/agents/teams.yaml` but are not frozen there:
467
+
468
+ - `/agents-add <persona>…` / `/agents-drop <persona>…` — restructure the ACTIVE team
469
+ live (drop refuses running or last members; session files are kept for re-adding).
470
+ - `/agents-save <name>` — persist the current roster as a named team back into
471
+ `teams.yaml` (targeted block upsert; comments and other teams untouched).
472
+ - `team_adjust` — the dispatcher itself may add/drop a persona **with a stated reason**;
473
+ disabled in fast mode, capped at 8 roster members, and every change is notified to the
474
+ human. The system prompt is rebuilt each turn, so changes take effect immediately.
475
+
476
+ ### `/hub-report`
477
+
478
+ Per-turn cost accounting: dispatches (agent, status, elapsed, billed/output tokens),
479
+ research runs, session recycles, drift stops, and budget/duplicate refusals — for the
480
+ current turn, the last completed turn, and session totals. Billed tokens count
481
+ input + cacheRead + cacheWrite, the same measure the recycler uses.
482
+
336
483
  Paths that don't exist produce a session-start warning, never an error. The full key list for
337
- `## agent-hub` (models, sub-roles, depth budgets, persona gate, research retention) is
338
- documented in `docs/agent-fleet-setup.md`.
484
+ `## agent-hub` (models, sub-roles, depth budgets, persona gate, research retention, watchdog,
485
+ mode/budget keys) is documented in `docs/agent-fleet-setup.md`.
339
486
 
340
487
  ## The coms layer
341
488
 
@@ -437,7 +584,7 @@ onward, hops accumulating up to `MAX_HOPS` (5).
437
584
 
438
585
  ### Coms-backed dispatch (dispatch-policy.yaml)
439
586
 
440
- `just hub-team <team>` boots the hub next to standing peers from `.pi/agents/peers.yaml` — and some
587
+ `just fleet team <team>` boots the Hub next to standing peers from `.pi/agents/peers.yaml` — and some
441
588
  of them (e.g. `code-reviewer`, `plan-reviewer` with `runner: claude-code`) intentionally share a name
442
589
  with a team member. `.pi/agents/dispatch-policy.yaml` tells the dispatcher to serve such members
443
590
  **through the peer** instead of spawning a native subagent:
@@ -531,20 +678,59 @@ orchestration surface the dispatcher persona never narrows.
531
678
  The dispatcher persona is **flavor-only** (decision G4 / 9) — it enriches the role but never narrows
532
679
  this tool set, so coms and dispatch stay available regardless of the chosen persona.
533
680
 
681
+ ## Optional Hermes local monitor transport
682
+
683
+ The optional monitor is an Agent Fleet-owned transport boundary, not a Hermes runtime API or a
684
+ bundled Hermes plugin. When enabled, `agent-hub` publishes dispatcher-turn and specialist-run
685
+ state and owns generation-safe cancellation. A separate local Hermes UI or operator client may
686
+ consume the owner-only discovery + Unix-socket contract documented in
687
+ [`hermes/README.md`](../../../hermes/README.md#local-agent-hub-monitor-integration).
688
+
689
+ Set these before the hub starts:
690
+
691
+ ```bash
692
+ export AGENT_FLEET_PROFILE_ID="approved-profile-id"
693
+ export AGENT_FLEET_MONITOR_RUNTIME_DIR="/absolute/owner-only/runtime-root"
694
+ ```
695
+
696
+ Both are required for monitor startup; the runtime root must be absolute and owner-only, and the
697
+ profile ID must be a safe identifier. The monitor also starts only for a Herdr-backed hub with
698
+ `HERDR_WORKSPACE_ID` and `HERDR_PANE_ID`; retain those values and `HERDR_SOCKET_PATH` in the
699
+ standard `just fleet team <team>` flow. Workspace labels are display metadata, not monitor identity.
700
+
701
+ The live contract exposes three authenticated newline-delimited JSON requests: `snapshot`, cursor-
702
+ based `output`, and exact-generation `cancel`. The monitor is local-only and fails closed when its
703
+ profile discovery, lease, token, or Unix socket is unavailable. A native cancel targets only the
704
+ matching hub-owned process generation. A coms cancel abandons the local wait only; its peer can
705
+ continue. Neither path controls or closes a Herdr workspace/pane.
706
+
707
+ Example startup:
708
+
709
+ ```bash
710
+ monitor_runtime="${XDG_RUNTIME_DIR:?}/agent-fleet-monitor"
711
+ install -d -m 700 "$monitor_runtime"
712
+ AGENT_FLEET_PROFILE_ID=dev \
713
+ AGENT_FLEET_MONITOR_RUNTIME_DIR="$monitor_runtime" \
714
+ just fleet team default
715
+ ```
716
+
717
+ No Desktop/backend plugin installation is required or provided. Consumers must re-discover after
718
+ lease or socket loss and must never persist or log the token.
719
+
534
720
  ## Requires
535
721
 
536
722
  - `.pi/agents/teams.yaml` for fixed specialist teams, the referenced persona `.md` files, and
537
723
  (strongly recommended) [`pi-ask-user`](https://github.com/edlsh/pi-ask-user).
538
- - `.pi/damage-control-rules.yaml` for the default guarded `just hub` / `just hub-solo` recipes.
724
+ - `.pi/damage-control-rules.yaml` for every guarded `just fleet` Pi mode.
539
725
  - Nothing extra in-repo for coms — the peer registry lives at `~/.pi/coms/` and is created at
540
726
  runtime.
541
727
 
542
728
  ## Usage
543
729
 
544
730
  ```bash
545
- # via the justfile (loads damage-control-continue first; accepts coms identity flags)
546
- just hub
547
- just hub --name architect --purpose "owns the migration design" --project myrepo
731
+ # Unified Fleet interface (Fleet Core is loaded first)
732
+ just fleet hub
733
+ just fleet hub --name architect --purpose "owns the migration design" --project myrepo
548
734
 
549
735
  # equivalent direct guarded launch
550
736
  pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts
@@ -558,41 +744,38 @@ Identity flags: `--name`, `--purpose`, `--project`, `--color`, `--explicit`.
558
744
 
559
745
  ### Safety scope
560
746
 
561
- `just hub` and `just hub-solo` load `damage-control-continue` and `ask-user-remote` before `agent-hub`, so guardrails and `ask_user` apply
747
+ `just fleet hub` and `just fleet hub --solo` load Fleet Core before `agent-hub`, so guardrails and `ask_user` apply
562
748
  to hub/dispatcher tool calls in that parent pi process — and because it is the *continue* variant, a
563
749
  blocked dispatcher call feeds back and the turn keeps going rather than aborting. Specialist and
564
750
  research agents are spawned as separate pi subprocesses with `--no-extensions` — but `agent-hub`
565
- resolves a damage-control harness (from this session's `-e` flags, else the repo-local
566
- `.pi/harnesses/<variant>/index.ts`) and re-loads *only* that one into each child via `-e`. The variant
567
- is chosen per child: research helpers (`researcher` / `deep-researcher`) get `damage-control-continue`
568
- so a blocked read lets them adapt and keep going; every other specialist gets the hard-stop
569
- `damage-control` that aborts on a violation. (Continue falls back to the hard-stop variant when it
570
- isn't installed, so researchers stay guarded either way.) `--no-extensions` keeps discovery off, so
571
- children never auto-load the `.pi/extensions/` utilities or recursively re-load `agent-hub`; the
572
- explicit `-e` still applies, so every child's tool calls are checked against the same
573
- `.pi/damage-control-rules.yaml`. If damage-control can't be resolved, a session-start warning is
574
- shown and children spawn unguarded. Research helpers are additionally read-only by construction.
575
- The guided setup (`guided-workspace-setup`) enforces the pairing: installing or keeping `agent-hub`
576
- always installs/keeps `damage-control` (and `damage-control-continue`) with it.
751
+ resolves `damage-control-continue` from this session's `-e` flags, else the repo-local harness, and
752
+ re-loads it into every native specialist, research helper, and nested delegate via explicit `-e`.
753
+ `--no-extensions` keeps discovery off, so children never auto-load `.pi/extensions/` utilities or
754
+ recursively re-load `agent-hub`; the explicit guardrail still checks every child's tool calls against
755
+ `.pi/damage-control-rules.yaml`. Protected-path blocks escalate to the hub for explicit approval;
756
+ protected deletions offer only Deny or Allow once, while inherently dangerous command patterns are
757
+ non-exemptible. Denial or timeout blocks the call without aborting the child's turn. If continue
758
+ cannot be resolved, dispatch is refused—children are never spawned unguarded. Research helpers are
759
+ additionally read-only by construction. Guided setup enforces `agent-hub` ⇒
760
+ `damage-control-continue` + `ask-user-remote`.
577
761
 
578
762
  ### Related recipes
579
763
 
580
764
  ```bash
581
- # the hub without the coms layer (fixed specialists + research only — lighter)
582
- just hub-solo
765
+ # Hub without coms (fixed specialists + research only)
766
+ just fleet hub --solo
583
767
 
584
- # spawn every peer of a team from .pi/agents/peers.yaml into a tiled herdr workspace
585
- # (requires a running herdr server — https://herdr.dev)
586
- just team-up full # launch
587
- just team-up-dry full # print the resolved layout + peer-launch commands without herdr
768
+ # Guarded peers only in a tiled Herdr workspace
769
+ just fleet team full --no-hub
770
+ just fleet team full --no-hub --dry-run
588
771
 
589
- # hub + team in ONE workspace: guarded hub in a larger main pane, peers tiled beside it
590
- just hub-team docs
772
+ # Guarded Hub + peers in one workspace
773
+ just fleet team docs
591
774
 
592
- # fleet resume: snapshot session refs / close cleanly / rebuild with conversations restored
593
- just team-snapshot docs # proactive snapshot while the team runs (crash insurance)
594
- just team-down docs # snapshot + close the workspace (peers get SIGTERM)
595
- just team-resume docs # rebuild the grid; pi peers continue via `pi --session <ref>`
775
+ # Snapshot refs / close cleanly / restore conversations
776
+ just fleet snapshot docs
777
+ just fleet down docs
778
+ just fleet resume docs
596
779
  ```
597
780
 
598
781
  `peers.yaml` groups reusable peers into named teams; each entry is `name` / `persona`
@@ -0,0 +1,135 @@
1
+ import {
2
+ accessDecisionChoices,
3
+ accessRequestCacheKey,
4
+ appendExemptionToFile,
5
+ fileExemptionsFor,
6
+ type AccessDecision,
7
+ type AccessDecisionChoice,
8
+ type AccessRequest,
9
+ } from "../lib/damage-control-shared.ts";
10
+
11
+ type ApprovalContext = {
12
+ hasUI: boolean;
13
+ ui: {
14
+ notify(message: string, level?: string): void;
15
+ select(title: string, options: string[], settings: { timeout: number }): Promise<string | undefined>;
16
+ };
17
+ };
18
+
19
+ type ReplySocket = {
20
+ write(chunk: string): unknown;
21
+ end(): unknown;
22
+ };
23
+
24
+ type AccessApprovalDeps = {
25
+ getContext(): ApprovalContext | null | undefined;
26
+ getExemptionsFile(): string | null | undefined;
27
+ appendLog(entry: Record<string, unknown>): void;
28
+ now(): string;
29
+ };
30
+
31
+ export function createAccessApprovalRouter(deps: AccessApprovalDeps) {
32
+ let askQueue: Promise<unknown> = Promise.resolve();
33
+ let generation = 0;
34
+ const denyCache = new Set<string>();
35
+ const pending = new Map<string, Promise<AccessDecisionChoice>>();
36
+
37
+ const respond = (socket: ReplySocket, msgId: string, decision: AccessDecisionChoice) => {
38
+ const reply: AccessDecision = { type: "access_decision", msg_id: msgId, decision };
39
+ try { socket.write(JSON.stringify(reply) + "\n"); } catch { /* child may have timed out */ }
40
+ try { socket.end(); } catch { /* ignore */ }
41
+ };
42
+
43
+ const validRequest = (request: AccessRequest) =>
44
+ typeof request.pattern === "string" && request.pattern.length > 0 &&
45
+ (request.category === "zero_access" || request.category === "read_only" || request.category === "no_delete");
46
+
47
+ const decide = (request: AccessRequest): Promise<AccessDecisionChoice> => {
48
+ const agent = (typeof request.agent === "string" && request.agent) || request.sender_session || "unknown-agent";
49
+ const pattern = request.pattern;
50
+ const cacheKey = accessRequestCacheKey({ ...request, agent, pattern });
51
+ const exemptionsFile = deps.getExemptionsFile();
52
+ const requestGeneration = generation;
53
+
54
+ if (fileExemptionsFor(exemptionsFile ?? undefined, agent).some((entry) => entry.pattern === pattern)) {
55
+ return Promise.resolve("allow_all");
56
+ }
57
+ if (denyCache.has(cacheKey)) return Promise.resolve("deny");
58
+ const existing = pending.get(cacheKey);
59
+ if (existing) return existing;
60
+
61
+ const ask = askQueue.then(async (): Promise<AccessDecisionChoice> => {
62
+ if (requestGeneration !== generation) return "deny";
63
+ const ctx = deps.getContext();
64
+ if (!ctx?.hasUI) return "deny";
65
+
66
+ const labels = new Map<AccessDecisionChoice, string>([
67
+ ["deny", "Deny (keep blocked)"],
68
+ ["allow_once", "Allow once"],
69
+ ["allow_agent", `Allow for ${agent} (this session)`],
70
+ ["allow_all", "Allow for all agents (this session)"],
71
+ ]);
72
+ const allowed = accessDecisionChoices(request.category);
73
+ const options = allowed.map((decision) => labels.get(decision)!);
74
+ ctx.ui.notify(
75
+ `🛡️ Access request from ${agent}: ${request.rule}\n tool: ${request.tool}\n attempted: ${String(request.invocation || "").slice(0, 200)}`,
76
+ "warning",
77
+ );
78
+ try {
79
+ const choice = await ctx.ui.select(
80
+ `🛡️ ${agent} requests access: ${pattern}`,
81
+ options,
82
+ { timeout: 600_000 },
83
+ );
84
+ if (requestGeneration !== generation) return "deny";
85
+ const selected = allowed.find((decision) => labels.get(decision) === choice) ?? "deny";
86
+ if (selected === "deny" && choice === labels.get("deny")) denyCache.add(cacheKey);
87
+ return selected;
88
+ } catch {
89
+ return "deny";
90
+ }
91
+ });
92
+
93
+ askQueue = ask.catch(() => {});
94
+ pending.set(cacheKey, ask);
95
+ void ask.finally(() => pending.delete(cacheKey));
96
+ return ask;
97
+ };
98
+
99
+ return {
100
+ async handle(socket: ReplySocket, request: AccessRequest): Promise<void> {
101
+ if (!validRequest(request)) {
102
+ respond(socket, request.msg_id, "deny");
103
+ return;
104
+ }
105
+ const agent = (typeof request.agent === "string" && request.agent) || request.sender_session || "unknown-agent";
106
+ const decision = await decide(request).catch((): AccessDecisionChoice => "deny");
107
+ const exemptionsFile = deps.getExemptionsFile();
108
+ if ((decision === "allow_agent" || decision === "allow_all") && exemptionsFile) {
109
+ try {
110
+ appendExemptionToFile(exemptionsFile, {
111
+ pattern: request.pattern,
112
+ scope: "session",
113
+ agent: decision === "allow_agent" ? agent : undefined,
114
+ grantedVia: "escalation",
115
+ grantedAt: deps.now(),
116
+ });
117
+ } catch { /* allow-once semantics still hold via the reply */ }
118
+ }
119
+ deps.appendLog({ action: `escalation_${decision}`, agent, pattern: request.pattern, tool: request.tool, rule: request.rule });
120
+ try {
121
+ deps.getContext()?.ui.notify(
122
+ `🛡️ Access ${decision === "deny" ? "denied" : `granted (${decision.replace(/_/g, " ")})`}: ${request.pattern} — ${agent}`,
123
+ decision === "deny" ? "warning" : "info",
124
+ );
125
+ } catch { /* ignore */ }
126
+ respond(socket, request.msg_id, decision);
127
+ },
128
+ reset() {
129
+ generation++;
130
+ askQueue = Promise.resolve();
131
+ denyCache.clear();
132
+ pending.clear();
133
+ },
134
+ };
135
+ }