@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,111 @@
1
+ export interface FleetInvocation {
2
+ recipe: string;
3
+ args: string[];
4
+ }
5
+
6
+ interface Capabilities {
7
+ browser: boolean;
8
+ allExtensions: boolean;
9
+ rest: string[];
10
+ }
11
+
12
+ function capabilities(args: string[]): Capabilities {
13
+ const rest: string[] = [];
14
+ let browser = false;
15
+ let allExtensions = false;
16
+ for (const arg of args) {
17
+ if (arg === "--browser") browser = true;
18
+ else if (arg === "--all-extensions") allExtensions = true;
19
+ else rest.push(arg);
20
+ }
21
+ return { browser, allExtensions, rest };
22
+ }
23
+
24
+ function bool(value: boolean): string {
25
+ return value ? "true" : "false";
26
+ }
27
+
28
+ function requireValue(value: string | undefined, message: string): string {
29
+ if (!value || value.startsWith("--")) throw new Error(message);
30
+ return value;
31
+ }
32
+
33
+ function withoutFlag(args: string[], flag: string): { present: boolean; rest: string[] } {
34
+ return { present: args.includes(flag), rest: args.filter((arg) => arg !== flag) };
35
+ }
36
+
37
+ const CODEX_LIFECYCLE = new Set(["setup", "reconfigure", "pair", "start", "status", "stop", "recover", "uninstall"]);
38
+
39
+ export function parseFleetCommand(argv: string[]): FleetInvocation {
40
+ if (argv.length === 0 || argv[0].startsWith("--")) {
41
+ const c = capabilities(argv);
42
+ return { recipe: "_fleet-core", args: [bool(c.browser), bool(c.allExtensions), ...c.rest] };
43
+ }
44
+
45
+ const [mode, ...tail] = argv;
46
+ if (mode === "install") return { recipe: "_fleet-install", args: tail };
47
+
48
+ // One addressable peer, in a pane of its own unless --here. peer-launch.ts
49
+ // owns the whole flag set (including `--` passthrough to pi), so the tail is
50
+ // forwarded verbatim rather than pre-chewed the way core/hub capabilities are.
51
+ if (mode === "peer") {
52
+ requireValue(tail[0], "fleet peer requires a peer name");
53
+ return { recipe: "_fleet-peer-launch", args: tail };
54
+ }
55
+
56
+ if (mode === "hub") {
57
+ const solo = withoutFlag(tail, "--solo");
58
+ const c = capabilities(solo.rest);
59
+ return { recipe: "_fleet-hub", args: [bool(solo.present), bool(c.browser), bool(c.allExtensions), ...c.rest] };
60
+ }
61
+
62
+ if (mode === "team") {
63
+ const team = requireValue(tail[0], "fleet team requires a team preset");
64
+ const noHub = withoutFlag(tail.slice(1), "--no-hub");
65
+ const dry = withoutFlag(noHub.rest, "--dry-run");
66
+ const c = capabilities(dry.rest);
67
+ if (noHub.present && (c.browser || c.allExtensions)) {
68
+ throw new Error("--browser/--all-extensions requires the hub; peer capabilities belong in .pi/agents/peers.yaml");
69
+ }
70
+ const recipe = noHub.present
71
+ ? dry.present ? "_fleet-team-up-dry" : "_fleet-team-up"
72
+ : dry.present ? "_fleet-hub-team-dry" : "_fleet-hub-team";
73
+ const forwarded = [...c.rest];
74
+ if (c.browser) forwarded.push("--browser");
75
+ if (c.allExtensions) forwarded.push("--all-extensions");
76
+ return { recipe, args: [team, ...forwarded] };
77
+ }
78
+
79
+ if (mode === "snapshot" || mode === "down" || mode === "resume") {
80
+ const team = requireValue(tail[0], `fleet ${mode} requires a team preset`);
81
+ return { recipe: `_fleet-team-${mode === "snapshot" ? "snapshot" : mode}`, args: [team, ...tail.slice(1)] };
82
+ }
83
+
84
+ if (mode === "conductor") {
85
+ const backend = requireValue(tail[0], "fleet conductor requires hermes or codex");
86
+ if (backend !== "hermes" && backend !== "codex") throw new Error(`Unknown conductor backend: ${backend}`);
87
+ const rest = tail.slice(1);
88
+ if (backend === "hermes") {
89
+ const team = rest[0] && !rest[0].startsWith("--") ? rest[0] : "full";
90
+ const afterTeam = rest[0] === team ? rest.slice(1) : rest;
91
+ const dry = withoutFlag(afterTeam, "--dry-run");
92
+ return { recipe: dry.present ? "_fleet-conductor-dry" : "_fleet-conductor", args: [team, ...dry.rest] };
93
+ }
94
+
95
+ const action = rest[0];
96
+ if (action && CODEX_LIFECYCLE.has(action)) {
97
+ if (action === "setup" || action === "reconfigure") {
98
+ const team = rest[1] && !rest[1].startsWith("--") ? rest[1] : "full";
99
+ const afterTeam = rest[1] === team ? rest.slice(2) : rest.slice(1);
100
+ return { recipe: `_fleet-conductor-codex-${action}`, args: [team, ...afterTeam] };
101
+ }
102
+ return { recipe: `_fleet-conductor-codex-${action}`, args: rest.slice(1) };
103
+ }
104
+ const team = action && !action.startsWith("--") ? action : "full";
105
+ const afterTeam = action === team ? rest.slice(1) : rest;
106
+ const dry = withoutFlag(afterTeam, "--dry-run");
107
+ return { recipe: dry.present ? "_fleet-conductor-codex-dry" : "_fleet-conductor-codex", args: [team, ...dry.rest] };
108
+ }
109
+
110
+ throw new Error(`Unknown fleet mode: ${mode}`);
111
+ }
@@ -0,0 +1,281 @@
1
+ // scripts/lib/herdr-layout.ts
2
+ //
3
+ // Pure logic for the herdr fleet recipes: peers.yaml parsing, peer→command
4
+ // construction, and peers.yaml team → herdr declarative layout tree (BSP
5
+ // splits, one pane per peer). No pi imports, no sockets, no process.exit —
6
+ // everything throws plain Errors so callers decide how to die. Testable
7
+ // under node --test; the wiring (requireHerdr, workspace.create,
8
+ // layout.apply) lives in scripts/team-up.ts.
9
+
10
+ import { resolve as resolvePath } from "node:path";
11
+
12
+ import type { LayoutNode } from "../../.pi/harnesses/lib/herdr-client.ts";
13
+ import { STAGGER_ENV_VAR } from "./spawn-stagger.ts";
14
+ import { DEFAULT_PROJECT, validateProject } from "./team-project.ts";
15
+
16
+ export type { LayoutNode };
17
+
18
+ // Safe charset for any value spliced into a command line or layout — the
19
+ // peers.yaml file is user-edited, so every manifest value is validated.
20
+ export const SAFE = /^[A-Za-z0-9._/,-]+$/;
21
+
22
+ export interface Peer {
23
+ name?: string;
24
+ persona?: string;
25
+ model?: string;
26
+ // Optional comma-separated extension names under .pi/extensions/ to load into
27
+ // this peer (routes it through `just _peer-plus` instead of `just _peer`).
28
+ extensions?: string;
29
+ // Optional repo-relative KEY=VALUE file injected as the pane's env at spawn
30
+ // (herdr injects it before the command runs — no shell `source`).
31
+ env_file?: string;
32
+ // Optional runner. Default (absent) is a pi peer via `_peer`/`_peer-plus`;
33
+ // "claude-code" spawns an interactive Claude Code plus its coms bridge in
34
+ // the pane via `_claude-peer` (model → `claude --model`).
35
+ runner?: string;
36
+ }
37
+
38
+ function stripQuotes(v: string): string {
39
+ if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
40
+ return v.slice(1, -1);
41
+ }
42
+ return v;
43
+ }
44
+
45
+ // Minimal parser for the specific peers.yaml shape (team → list of {name,persona,model}).
46
+ // Not a general YAML parser; tolerant of comments and blank lines only.
47
+ export function parsePeersYaml(raw: string): Record<string, Peer[]> {
48
+ const teams: Record<string, Peer[]> = {};
49
+ let currentTeam: string | null = null;
50
+ let currentPeer: Peer | null = null;
51
+
52
+ for (const rawLine of raw.split("\n")) {
53
+ const line = rawLine.replace(/\s+$/, "");
54
+ if (line.trim() === "" || /^\s*#/.test(line)) continue;
55
+ const indent = line.length - line.trimStart().length;
56
+ const content = line.trim();
57
+
58
+ if (indent === 0) {
59
+ const m = content.match(/^([A-Za-z0-9_-]+):\s*$/);
60
+ if (m) {
61
+ currentTeam = m[1];
62
+ teams[currentTeam] = [];
63
+ currentPeer = null;
64
+ }
65
+ continue;
66
+ }
67
+ if (!currentTeam) continue;
68
+
69
+ const itemM = content.match(/^-\s*([A-Za-z0-9_]+):\s*(.+)$/);
70
+ if (itemM) {
71
+ currentPeer = {};
72
+ teams[currentTeam].push(currentPeer);
73
+ (currentPeer as Record<string, string>)[itemM[1]] = stripQuotes(itemM[2]);
74
+ continue;
75
+ }
76
+ const fieldM = content.match(/^([A-Za-z0-9_]+):\s*(.+)$/);
77
+ if (fieldM && currentPeer) {
78
+ (currentPeer as Record<string, string>)[fieldM[1]] = stripQuotes(fieldM[2]);
79
+ }
80
+ }
81
+ return teams;
82
+ }
83
+
84
+ /**
85
+ * The peers.yaml declaration for a peer name, searched across every team
86
+ * (first match wins; the same name in two teams is the same peer). Used by
87
+ * one-off spawns that are handed only a name — without this they would ignore
88
+ * `runner:`/`extensions:`/`env_file:` and launch a bare pi peer under a name
89
+ * the fleet defines as something else (e.g. a `runner: claude-code` reviewer).
90
+ */
91
+ export function findPeerByName(teams: Record<string, Peer[]>, name: string): Peer | undefined {
92
+ const wanted = String(name ?? "").toLowerCase();
93
+ if (!wanted) return undefined;
94
+ for (const peers of Object.values(teams)) {
95
+ for (const peer of peers) {
96
+ if (String(peer.name ?? "").toLowerCase() === wanted) return peer;
97
+ }
98
+ }
99
+ return undefined;
100
+ }
101
+
102
+ // Validate a peer's fields and build its launch argv. `just` recipe params are
103
+ // POSITIONAL (persona name model session) — bare positional args, never
104
+ // key=value. A peer with `extensions:` routes through `_peer-plus
105
+ // <extensions> <persona> <name> [<model>] [<session>]`; otherwise plain
106
+ // `_peer <persona> <name> [<model>] [<session>]`. `resumeRef` (a pi session
107
+ // path for `pi --session`) fills the trailing session positional — when the
108
+ // peer has no model, an empty-string placeholder keeps the positions aligned.
109
+ export function peerCommand(p: Peer, team: string, resumeRef?: string, project = DEFAULT_PROJECT): string[] {
110
+ validateProject(project);
111
+ if (p.runner !== undefined && p.runner !== "claude-code") {
112
+ throw new Error(`Unknown runner "${p.runner}" for peer "${p.name}" in team "${team}" (supported: claude-code).`);
113
+ }
114
+ if (!p.persona && p.runner !== "claude-code") {
115
+ throw new Error(`Peer "${p.name ?? "(unnamed)"}" in team "${team}" is missing a persona.`);
116
+ }
117
+ if (!p.name) {
118
+ throw new Error(`Peer with persona "${p.persona}" in team "${team}" is missing a name.`);
119
+ }
120
+ for (const [k, v] of Object.entries(p)) {
121
+ // Only string fields can reach a command line; extra non-string fields
122
+ // (e.g. a snapshot's `resume` object) are never spliced into argv.
123
+ if (typeof v === "string" && !SAFE.test(v)) {
124
+ throw new Error(`Unsafe value for ${k} in team "${team}": ${JSON.stringify(v)} (allowed: ${SAFE})`);
125
+ }
126
+ }
127
+ if (resumeRef !== undefined && !SAFE.test(resumeRef)) {
128
+ throw new Error(`Unsafe resume ref for ${p.name}: ${JSON.stringify(resumeRef)} (allowed: ${SAFE})`);
129
+ }
130
+ if (p.runner === "claude-code" && p.extensions) {
131
+ throw new Error(`Peer "${p.name}": extensions: are pi-only and cannot combine with runner: claude-code.`);
132
+ }
133
+ const parts =
134
+ p.runner === "claude-code"
135
+ ? ["just", "_claude-peer", p.name]
136
+ : p.extensions
137
+ ? ["just", "_peer-plus", p.extensions, p.persona, p.name]
138
+ : ["just", "_peer", p.persona, p.name];
139
+ if (p.model) parts.push(p.model);
140
+ if (resumeRef !== undefined) {
141
+ if (!p.model) parts.push(""); // keep the model positional aligned
142
+ parts.push(resumeRef);
143
+ }
144
+ if (project !== DEFAULT_PROJECT) {
145
+ if (!p.model && resumeRef === undefined) parts.push("");
146
+ if (resumeRef === undefined) parts.push("");
147
+ parts.push(project);
148
+ }
149
+ return parts;
150
+ }
151
+
152
+ // Parse a KEY=VALUE env file (B3): no shell evaluation, no expansion.
153
+ // Blank lines and #-comments are skipped; values may be single- or
154
+ // double-quoted (quotes stripped, contents taken literally).
155
+ export function parseEnvFile(raw: string, sourceName = "env file"): Record<string, string> {
156
+ const env: Record<string, string> = {};
157
+ const lines = raw.split("\n");
158
+ for (let i = 0; i < lines.length; i++) {
159
+ const line = lines[i].trim();
160
+ if (line === "" || line.startsWith("#")) continue;
161
+ const m = line.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
162
+ if (!m) {
163
+ throw new Error(`${sourceName}:${i + 1}: not a KEY=VALUE line: ${JSON.stringify(line)}`);
164
+ }
165
+ env[m[1]] = stripQuotes(m[2].trim());
166
+ }
167
+ return env;
168
+ }
169
+
170
+ // Resolve a peer's env_file to an absolute path inside the repo. The SAFE
171
+ // charset (enforced on every peer field) already excludes shell metacharacters;
172
+ // this adds the traversal guard: repo-relative, no escaping the repo root.
173
+ export function resolveEnvFilePath(envFile: string, repoRoot: string): string {
174
+ if (!SAFE.test(envFile)) {
175
+ throw new Error(`Unsafe env_file path: ${JSON.stringify(envFile)} (allowed: ${SAFE})`);
176
+ }
177
+ if (envFile.startsWith("/")) {
178
+ throw new Error(`env_file must be repo-relative, got absolute path: ${envFile}`);
179
+ }
180
+ const abs = resolvePath(repoRoot, envFile);
181
+ if (abs !== repoRoot && !abs.startsWith(repoRoot + "/")) {
182
+ throw new Error(`env_file escapes the repo root: ${envFile}`);
183
+ }
184
+ return abs;
185
+ }
186
+
187
+ export interface TeamLayoutOptions {
188
+ team: string;
189
+ peers: Peer[];
190
+ repoRoot: string;
191
+ // B3 hook: resolve a peer's extra env (e.g. from its env_file). Returning
192
+ // undefined means no extra env for that peer.
193
+ envForPeer?: (peer: Peer) => Record<string, string> | undefined;
194
+ // B5 hook: resume ref (pi session path) for a peer being restored from a
195
+ // team snapshot. Returning undefined starts the peer fresh.
196
+ resumeForPeer?: (peer: Peer) => string | undefined;
197
+ // Pre-warm/stagger hook (see spawn-stagger.ts): seconds this pane should
198
+ // sleep before launching pi, injected as AGENT_FLEET_SPAWN_DELAY in the
199
+ // pane env. undefined or 0 launches immediately.
200
+ delayForPeer?: (peer: Peer) => number | undefined;
201
+ // B2 hook: when set, the hub occupies a larger root pane (ratio of the
202
+ // horizontal split) and the team tiles in the remaining space.
203
+ // Coms project scope shared by all panes in this layout. The default keeps
204
+ // existing argv shapes; non-default projects are appended to hidden recipe
205
+ // positional args after model/session.
206
+ project?: string;
207
+ hub?: { command: string[]; label: string; ratio?: number; cwd?: string; env?: Record<string, string> };
208
+ }
209
+
210
+ function paneNode(
211
+ peer: Peer,
212
+ team: string,
213
+ repoRoot: string,
214
+ envForPeer?: TeamLayoutOptions["envForPeer"],
215
+ resumeForPeer?: TeamLayoutOptions["resumeForPeer"],
216
+ project = DEFAULT_PROJECT,
217
+ delayForPeer?: TeamLayoutOptions["delayForPeer"],
218
+ ): LayoutNode {
219
+ validateProject(project);
220
+ const env = { ...envForPeer?.(peer) };
221
+ const delay = delayForPeer?.(peer);
222
+ if (delay !== undefined) {
223
+ if (!Number.isFinite(delay) || delay < 0) {
224
+ throw new Error(`Invalid spawn delay for peer "${peer.name}": ${delay}`);
225
+ }
226
+ if (delay > 0) env[STAGGER_ENV_VAR] = String(Math.round(delay));
227
+ }
228
+ return {
229
+ type: "pane",
230
+ command: peerCommand(peer, team, resumeForPeer?.(peer), project),
231
+ cwd: repoRoot,
232
+ label: peer.name as string,
233
+ ...(Object.keys(env).length > 0 ? { env } : {}),
234
+ };
235
+ }
236
+
237
+ // Balanced BSP over a list of panes: split the list in half, alternating
238
+ // split direction by depth — the herdr equivalent of tmux's tiled layout.
239
+ function bsp(nodes: LayoutNode[], depth: number): LayoutNode {
240
+ if (nodes.length === 1) return nodes[0];
241
+ const mid = Math.ceil(nodes.length / 2);
242
+ return {
243
+ type: "split",
244
+ direction: depth % 2 === 0 ? "right" : "down",
245
+ ratio: mid / nodes.length,
246
+ first: bsp(nodes.slice(0, mid), depth + 1),
247
+ second: bsp(nodes.slice(mid), depth + 1),
248
+ };
249
+ }
250
+
251
+ // peers.yaml team → herdr layout tree for layout.apply.
252
+ export function buildTeamLayout(opts: TeamLayoutOptions): LayoutNode {
253
+ const { team, peers, repoRoot, envForPeer, resumeForPeer, delayForPeer, hub, project = DEFAULT_PROJECT } = opts;
254
+ validateProject(project);
255
+ if (peers.length === 0) {
256
+ if (!hub) throw new Error(`Team "${team}" has no peers.`);
257
+ return {
258
+ type: "pane",
259
+ command: hub.command,
260
+ cwd: hub.cwd ?? repoRoot,
261
+ label: hub.label,
262
+ ...(hub.env && Object.keys(hub.env).length > 0 ? { env: hub.env } : {}),
263
+ };
264
+ }
265
+ const panes = peers.map((p) => paneNode(p, team, repoRoot, envForPeer, resumeForPeer, project, delayForPeer));
266
+ const grid = bsp(panes, hub ? 1 : 0);
267
+ if (!hub) return grid;
268
+ return {
269
+ type: "split",
270
+ direction: "right",
271
+ ratio: hub.ratio ?? 0.4,
272
+ first: {
273
+ type: "pane",
274
+ command: hub.command,
275
+ cwd: hub.cwd ?? repoRoot,
276
+ label: hub.label,
277
+ ...(hub.env && Object.keys(hub.env).length > 0 ? { env: hub.env } : {}),
278
+ },
279
+ second: grid,
280
+ };
281
+ }
@@ -0,0 +1,241 @@
1
+ // scripts/lib/hermes-bridge-core.ts
2
+ //
3
+ // Pure logic for the Hermes ⇄ coms bridge: qid correlation, Telegram
4
+ // formatting, answer-file validation, answer mapping, timeout outcomes,
5
+ // state transitions, and ndjson log records. No sockets, no fs, no Hermes CLI.
6
+
7
+ import * as os from "node:os";
8
+ import * as path from "node:path";
9
+
10
+ export const QID_RE = /^[0-9A-HJKMNP-TV-Z]{26}$/;
11
+ export const TELEGRAM_TEXT_LIMIT = 4096;
12
+ export const DEFAULT_REMOTE_TIMEOUT_MS = 1_800_000;
13
+ export const HUB_Q_PREFIX = "HUB-Q";
14
+ export const ANSWER_FILE_SUFFIX = ".answer.json";
15
+
16
+ export const BRIDGE_EVENT_NAMES = [
17
+ "question_received",
18
+ "delivered",
19
+ "delivery_error",
20
+ "answered",
21
+ "cancelled",
22
+ "timeout",
23
+ "late_answer",
24
+ ] as const;
25
+
26
+ export type BridgeEventName = (typeof BRIDGE_EVENT_NAMES)[number];
27
+ export type QuestionState = "pending" | "delivered" | "answered" | "cancelled" | "timeout";
28
+
29
+ export interface QuestionOption {
30
+ title: string;
31
+ description?: string;
32
+ }
33
+
34
+ export interface HermesBridgeQuestion {
35
+ qid: string;
36
+ project: string;
37
+ question: string;
38
+ context?: string;
39
+ options?: QuestionOption[];
40
+ }
41
+
42
+ export interface HermesAnswerFile {
43
+ qid: string;
44
+ answer: string;
45
+ answered_by: string;
46
+ at: string;
47
+ }
48
+
49
+ export type AskResponse =
50
+ | { kind: "selection"; selections: string[]; comment?: string }
51
+ | { kind: "freeform"; text: string };
52
+
53
+ export type AnswerRejectReason =
54
+ | "invalid_path"
55
+ | "invalid_qid"
56
+ | "foreign_qid"
57
+ | "invalid_json"
58
+ | "invalid_schema"
59
+ | "qid_mismatch";
60
+
61
+ export type AnswerFileValidation =
62
+ | { ok: true; qid: string; answer: HermesAnswerFile }
63
+ | { ok: false; reason: AnswerRejectReason; qid?: string; detail?: string };
64
+
65
+ export type StateTransition =
66
+ | { ok: true; state: QuestionState | null }
67
+ | { ok: false; reason: "unsupported_transition"; state: QuestionState | null; event: BridgeEventName };
68
+
69
+ export interface LogRecord {
70
+ at: string;
71
+ qid: string;
72
+ event: BridgeEventName;
73
+ detail?: unknown;
74
+ }
75
+
76
+ export function hermesBridgeDir(home = os.homedir()): string {
77
+ return path.join(home, ".pi", "coms", "hermes-bridge");
78
+ }
79
+
80
+ export function questionsDir(home = os.homedir()): string {
81
+ return path.join(hermesBridgeDir(home), "questions");
82
+ }
83
+
84
+ export function logPath(home = os.homedir()): string {
85
+ return path.join(hermesBridgeDir(home), "log.ndjson");
86
+ }
87
+
88
+ export function answerFilePath(qid: string, dir = questionsDir()): string {
89
+ return path.join(dir, `${qid}${ANSWER_FILE_SUFFIX}`);
90
+ }
91
+
92
+ export function isValidQid(qid: unknown): qid is string {
93
+ return typeof qid === "string" && QID_RE.test(qid);
94
+ }
95
+
96
+ export function qidFromPromptEnvelope(env: { msg_id?: unknown }): string {
97
+ if (!isValidQid(env.msg_id)) throw new Error("prompt msg_id must be a 26-character Crockford ULID qid");
98
+ return env.msg_id;
99
+ }
100
+
101
+ function truncateUtf16(text: string, limit: number): string {
102
+ if (text.length <= limit) return text;
103
+ if (limit <= 0) return "";
104
+ if (limit === 1) return "…";
105
+ return `${text.slice(0, limit - 1)}…`;
106
+ }
107
+
108
+ function formatOptions(options: QuestionOption[]): string {
109
+ return options
110
+ .map((option, index) => {
111
+ const desc = option.description ? ` — ${option.description}` : "";
112
+ return `${index + 1}. ${option.title}${desc}`;
113
+ })
114
+ .join("\n");
115
+ }
116
+
117
+ export function formatTelegramQuestion(input: HermesBridgeQuestion, limit = TELEGRAM_TEXT_LIMIT): string {
118
+ if (!isValidQid(input.qid)) throw new Error("qid must be a 26-character Crockford ULID");
119
+ const options = input.options ?? [];
120
+ const header = `❓ [${HUB_Q_PREFIX}:${input.qid}] ${input.question}`;
121
+ const project = truncateUtf16(input.project.replace(/\s+/g, " ").trim() || "default", 128);
122
+ const projectBlock = `\n\n📁 Project: ${project}`;
123
+ const optionsBlock = options.length > 0 ? `\n\nOptions:\n${formatOptions(options)}` : "";
124
+ const instruction = `\n\n↩ Reply to this message, or type: ${HUB_Q_PREFIX}:${input.qid}: <answer>`;
125
+ const contextPrefix = input.context ? "\n\nContext: " : "";
126
+ const fixedLength = header.length + projectBlock.length + contextPrefix.length + optionsBlock.length + instruction.length;
127
+ const contextBudget = Math.max(0, limit - fixedLength);
128
+ const context = input.context ? truncateUtf16(input.context, contextBudget) : "";
129
+ return truncateUtf16(`${header}${projectBlock}${contextPrefix}${context}${optionsBlock}${instruction}`, limit);
130
+ }
131
+
132
+ export function mapAnswerToAskResponse(answer: string, options: QuestionOption[] = []): AskResponse {
133
+ const text = answer.trim();
134
+ if (options.length > 0) {
135
+ if (/^\d+$/.test(text)) {
136
+ const index = Number(text) - 1;
137
+ const option = options[index];
138
+ if (option) return { kind: "selection", selections: [option.title] };
139
+ }
140
+ const byTitle = options.find((option) => option.title.toLowerCase() === text.toLowerCase());
141
+ if (byTitle) return { kind: "selection", selections: [byTitle.title] };
142
+ }
143
+ return { kind: "freeform", text };
144
+ }
145
+
146
+ function qidFromAnswerPath(filePath: string): { ok: true; qid: string } | { ok: false; reason: AnswerRejectReason } {
147
+ const base = path.basename(filePath);
148
+ if (!base.endsWith(ANSWER_FILE_SUFFIX)) return { ok: false, reason: "invalid_path" };
149
+ const qid = base.slice(0, -ANSWER_FILE_SUFFIX.length);
150
+ if (!isValidQid(qid)) return { ok: false, reason: "invalid_qid" };
151
+ return { ok: true, qid };
152
+ }
153
+
154
+ function isIsoTimestamp(value: string): boolean {
155
+ return !Number.isNaN(Date.parse(value));
156
+ }
157
+
158
+ function schemaValid(value: unknown): value is HermesAnswerFile {
159
+ const rec = value as HermesAnswerFile;
160
+ return (
161
+ !!rec &&
162
+ typeof rec === "object" &&
163
+ isValidQid(rec.qid) &&
164
+ typeof rec.answer === "string" &&
165
+ typeof rec.answered_by === "string" &&
166
+ rec.answered_by.length > 0 &&
167
+ typeof rec.at === "string" &&
168
+ isIsoTimestamp(rec.at)
169
+ );
170
+ }
171
+
172
+ export function validateAnswerFile(
173
+ raw: string,
174
+ filePath: string,
175
+ livePendingQids: Iterable<string>,
176
+ ): AnswerFileValidation {
177
+ const pathQid = qidFromAnswerPath(filePath);
178
+ if (!pathQid.ok) return { ok: false, reason: pathQid.reason };
179
+ const pending = new Set(livePendingQids);
180
+ if (!pending.has(pathQid.qid)) return { ok: false, reason: "foreign_qid", qid: pathQid.qid };
181
+
182
+ let parsed: unknown;
183
+ try {
184
+ parsed = JSON.parse(raw);
185
+ } catch (err) {
186
+ return { ok: false, reason: "invalid_json", qid: pathQid.qid, detail: err instanceof Error ? err.message : String(err) };
187
+ }
188
+ if (!schemaValid(parsed)) return { ok: false, reason: "invalid_schema", qid: pathQid.qid };
189
+ if (parsed.qid !== pathQid.qid) return { ok: false, reason: "qid_mismatch", qid: pathQid.qid };
190
+ return { ok: true, qid: pathQid.qid, answer: parsed };
191
+ }
192
+
193
+ export function timeoutMsFromEnv(env: Pick<NodeJS.ProcessEnv, "PI_COMS_TIMEOUT_MS"> = process.env): number {
194
+ const raw = env.PI_COMS_TIMEOUT_MS;
195
+ if (!raw) return DEFAULT_REMOTE_TIMEOUT_MS;
196
+ const n = Number(raw);
197
+ return Number.isFinite(n) && n > 0 ? n : DEFAULT_REMOTE_TIMEOUT_MS;
198
+ }
199
+
200
+ export function timeoutErrorMessage(timeoutMs: number): string {
201
+ return `no remote answer within ${timeoutMs}ms`;
202
+ }
203
+
204
+ export function timeoutTelegramNote(qid: string, timeoutMs: number): string {
205
+ return `⌛ [${HUB_Q_PREFIX}:${qid}] The question timed out after ${timeoutMs}ms.`;
206
+ }
207
+
208
+ export function timeoutOutcome(qid: string, timeoutMs = timeoutMsFromEnv()): {
209
+ response: null;
210
+ error: string;
211
+ telegramNote: string;
212
+ } {
213
+ return {
214
+ response: null,
215
+ error: timeoutErrorMessage(timeoutMs),
216
+ telegramNote: timeoutTelegramNote(qid, timeoutMs),
217
+ };
218
+ }
219
+
220
+ export function transitionState(state: QuestionState | null, event: BridgeEventName): StateTransition {
221
+ if (state === null && event === "question_received") return { ok: true, state: "pending" };
222
+ if (state === "pending" && event === "delivered") return { ok: true, state: "delivered" };
223
+ if (state === "pending" && event === "delivery_error") return { ok: true, state: null };
224
+ if ((state === "pending" || state === "delivered") && event === "cancelled") return { ok: true, state: "cancelled" };
225
+ if ((state === "pending" || state === "delivered") && event === "timeout") return { ok: true, state: "timeout" };
226
+ if (state === "delivered" && event === "answered") return { ok: true, state: "answered" };
227
+ if ((state === "answered" || state === "cancelled" || state === "timeout") && event === "late_answer") {
228
+ return { ok: true, state };
229
+ }
230
+ return { ok: false, reason: "unsupported_transition", state, event };
231
+ }
232
+
233
+ export function makeLogRecord(qid: string, event: BridgeEventName, detail?: unknown, at = new Date().toISOString()): LogRecord {
234
+ if (!isValidQid(qid)) throw new Error("qid must be a 26-character Crockford ULID");
235
+ if (!BRIDGE_EVENT_NAMES.includes(event)) throw new Error(`unsupported bridge event: ${event}`);
236
+ return detail === undefined ? { at, qid, event } : { at, qid, event, detail };
237
+ }
238
+
239
+ export function renderLogRecord(record: LogRecord): string {
240
+ return `${JSON.stringify(record)}\n`;
241
+ }
@@ -0,0 +1 @@
1
+ export * from "../../.pi/harnesses/lib/hermes-monitor-events.ts";
@@ -0,0 +1,2 @@
1
+ // Compatibility surface for monitor scripts and existing imports.
2
+ export * from "../../.pi/harnesses/lib/hermes-monitor-herdr.ts";
@@ -0,0 +1,3 @@
1
+ // Canonical monitor runtime code lives with the Agent Hub harness so a
2
+ // symlinked package update refreshes the harness and its dependencies atomically.
3
+ export * from "../../.pi/harnesses/lib/hermes-monitor-model.ts";
@@ -0,0 +1,2 @@
1
+ // Compatibility surface for monitor scripts and existing imports.
2
+ export * from "../../.pi/harnesses/lib/hermes-monitor-registry.ts";
@@ -0,0 +1,2 @@
1
+ // Compatibility surface for monitor scripts and existing imports.
2
+ export * from "../../.pi/harnesses/lib/hermes-monitor-socket.ts";
@@ -0,0 +1,2 @@
1
+ // Compatibility surface for monitor scripts and existing imports.
2
+ export * from "../../.pi/harnesses/lib/hermes-monitor-store.ts";