@chankov/agent-fleet 0.0.2 → 0.0.4

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 (362) hide show
  1. package/.claude/commands/doctor-agent-fleet.md +1 -1
  2. package/.claude/commands/setup-agent-fleet.md +5 -5
  3. package/.opencode/commands/af-doctor-agent-fleet.md +2 -0
  4. package/.opencode/commands/af-setup-agent-fleet.md +1 -1
  5. package/.pi/agents/peers.yaml +4 -0
  6. package/.pi/agents/teams.yaml +2 -2
  7. package/.pi/harnesses/agent-hub/README.md +254 -18
  8. package/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  9. package/.pi/harnesses/agent-hub/delegate.ts +32 -9
  10. package/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  11. package/.pi/harnesses/agent-hub/footer.ts +29 -0
  12. package/.pi/harnesses/agent-hub/helpers.ts +49 -0
  13. package/.pi/harnesses/agent-hub/index.ts +1269 -322
  14. package/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  15. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  16. package/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  17. package/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  18. package/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  19. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  20. package/.pi/harnesses/agent-hub/package.json +5 -4
  21. package/.pi/harnesses/agent-hub/research-retention.js +34 -0
  22. package/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  23. package/.pi/harnesses/agent-hub/run-budget.js +155 -0
  24. package/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  25. package/.pi/harnesses/agent-hub/spawn.ts +161 -94
  26. package/.pi/harnesses/agent-hub/version.ts +18 -0
  27. package/.pi/harnesses/ask-user-remote/README.md +2 -0
  28. package/.pi/harnesses/coms/README.md +21 -0
  29. package/.pi/harnesses/coms/index.ts +2 -0
  30. package/.pi/harnesses/coms/package.json +5 -4
  31. package/.pi/harnesses/coms/version.ts +18 -0
  32. package/.pi/harnesses/damage-control-continue/README.md +32 -31
  33. package/.pi/harnesses/damage-control-continue/index.ts +23 -9
  34. package/.pi/harnesses/damage-control-continue/package.json +5 -4
  35. package/.pi/harnesses/damage-control-continue/version.ts +18 -0
  36. package/.pi/harnesses/{damage-control/shared.ts → lib/damage-control-shared.ts} +20 -6
  37. package/.pi/prompts/doctor-agent-fleet.md +1 -1
  38. package/.pi/prompts/setup-agent-fleet.md +5 -5
  39. package/.versions/0.0.4/.claude/commands/build.md +44 -0
  40. package/.versions/0.0.4/.claude/commands/code-simplify.md +22 -0
  41. package/.versions/0.0.4/.claude/commands/design-agent.md +14 -0
  42. package/.versions/0.0.4/.claude/commands/doctor-agent-fleet.md +17 -0
  43. package/.versions/0.0.4/.claude/commands/orchestrate.md +112 -0
  44. package/.versions/0.0.4/.claude/commands/plan.md +16 -0
  45. package/.versions/0.0.4/.claude/commands/prime.md +22 -0
  46. package/.versions/0.0.4/.claude/commands/review.md +16 -0
  47. package/.versions/0.0.4/.claude/commands/setup-agent-fleet.md +25 -0
  48. package/.versions/0.0.4/.claude/commands/ship.md +72 -0
  49. package/.versions/0.0.4/.claude/commands/spec.md +15 -0
  50. package/.versions/0.0.4/.claude/commands/test.md +19 -0
  51. package/.versions/0.0.4/.claude/commands/webperf.md +32 -0
  52. package/.versions/0.0.4/.claude/orchestrate-teams.yaml +24 -0
  53. package/.versions/0.0.4/.opencode/commands/af-build.md +17 -0
  54. package/.versions/0.0.4/.opencode/commands/af-code-simplify.md +16 -0
  55. package/.versions/0.0.4/.opencode/commands/af-compound.md +16 -0
  56. package/.versions/0.0.4/.opencode/commands/af-design-agent.md +15 -0
  57. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  58. package/.versions/0.0.4/.opencode/commands/af-orchestrate.md +112 -0
  59. package/.versions/0.0.4/.opencode/commands/af-plan.md +16 -0
  60. package/.versions/0.0.4/.opencode/commands/af-prime.md +22 -0
  61. package/.versions/0.0.4/.opencode/commands/af-review.md +15 -0
  62. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +15 -0
  63. package/.versions/0.0.4/.opencode/commands/af-ship.md +16 -0
  64. package/.versions/0.0.4/.opencode/commands/af-spec.md +16 -0
  65. package/.versions/0.0.4/.opencode/commands/af-test.md +21 -0
  66. package/.versions/0.0.4/.opencode/commands/af-webperf.md +32 -0
  67. package/.versions/0.0.4/.opencode/orchestrate-teams.yaml +24 -0
  68. package/.versions/0.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  69. package/.versions/0.0.4/.pi/agents/model-profiles.yaml +20 -0
  70. package/.versions/0.0.4/.pi/agents/peers.yaml +146 -0
  71. package/.versions/0.0.4/.pi/agents/teams.yaml +39 -0
  72. package/.versions/0.0.4/.pi/damage-control-rules.yaml +297 -0
  73. package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  74. package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  75. package/{.pi/harnesses/damage-control → .versions/0.0.4/.pi/extensions/agent-fleet-update-check}/package.json +1 -1
  76. package/.versions/0.0.4/.pi/extensions/btw/README.md +118 -0
  77. package/.versions/0.0.4/.pi/extensions/btw/index.ts +917 -0
  78. package/.versions/0.0.4/.pi/extensions/btw/package.json +6 -0
  79. package/.versions/0.0.4/.pi/extensions/btw/state.js +179 -0
  80. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  81. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  82. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  83. package/.versions/0.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  84. package/.versions/0.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  85. package/.versions/0.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  86. package/.versions/0.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  87. package/.versions/0.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  88. package/.versions/0.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  89. package/.versions/0.0.4/.pi/extensions/package-lock.json +1143 -0
  90. package/.versions/0.0.4/.pi/extensions/package.json +9 -0
  91. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/README.md +201 -0
  92. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  93. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  94. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  95. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  96. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  97. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  98. package/.versions/0.0.4/.pi/harnesses/agent-hub/README.md +798 -0
  99. package/.versions/0.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  100. package/.versions/0.0.4/.pi/harnesses/agent-hub/artifacts.js +92 -0
  101. package/.versions/0.0.4/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  102. package/.versions/0.0.4/.pi/harnesses/agent-hub/delegate.ts +386 -0
  103. package/.versions/0.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  104. package/.versions/0.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  105. package/.versions/0.0.4/.pi/harnesses/agent-hub/footer.ts +29 -0
  106. package/.versions/0.0.4/.pi/harnesses/agent-hub/helpers.ts +214 -0
  107. package/.versions/0.0.4/.pi/harnesses/agent-hub/index.ts +8045 -0
  108. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  109. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  110. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  111. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  112. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  113. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  114. package/.versions/0.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  115. package/.versions/0.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
  116. package/.versions/0.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  117. package/.versions/0.0.4/.pi/harnesses/agent-hub/return-contract.js +215 -0
  118. package/.versions/0.0.4/.pi/harnesses/agent-hub/run-budget.js +155 -0
  119. package/.versions/0.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  120. package/.versions/0.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  121. package/.versions/0.0.4/.pi/harnesses/agent-hub/spawn.ts +246 -0
  122. package/.versions/0.0.4/.pi/harnesses/agent-hub/version.ts +18 -0
  123. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/README.md +18 -0
  124. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/index.ts +293 -0
  125. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  126. package/.versions/0.0.4/.pi/harnesses/coms/README.md +92 -0
  127. package/.versions/0.0.4/.pi/harnesses/coms/index.ts +1745 -0
  128. package/.versions/0.0.4/.pi/harnesses/coms/package.json +7 -0
  129. package/.versions/0.0.4/.pi/harnesses/coms/version.ts +18 -0
  130. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/README.md +117 -0
  131. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  132. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  133. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/version.ts +18 -0
  134. package/.versions/0.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  135. package/.versions/0.0.4/.pi/harnesses/lib/herdr-client.ts +458 -0
  136. package/.versions/0.0.4/.pi/harnesses/lib/herdr-presence.ts +288 -0
  137. package/.versions/0.0.4/.pi/harnesses/package-lock.json +35 -0
  138. package/.versions/0.0.4/.pi/harnesses/package.json +9 -0
  139. package/.versions/0.0.4/.pi/prompts/build.md +24 -0
  140. package/.versions/0.0.4/.pi/prompts/code-simplify.md +22 -0
  141. package/.versions/0.0.4/.pi/prompts/doctor-agent-fleet.md +15 -0
  142. package/.versions/0.0.4/.pi/prompts/plan.md +16 -0
  143. package/.versions/0.0.4/.pi/prompts/review.md +16 -0
  144. package/.versions/0.0.4/.pi/prompts/setup-agent-fleet.md +27 -0
  145. package/.versions/0.0.4/.pi/prompts/ship.md +17 -0
  146. package/.versions/0.0.4/.pi/prompts/spec.md +15 -0
  147. package/.versions/0.0.4/.pi/prompts/test.md +19 -0
  148. package/.versions/0.0.4/.pi/skills/bowser/SKILL.md +145 -0
  149. package/.versions/0.0.4/.version +1 -0
  150. package/.versions/0.0.4/agents/architect.md +23 -0
  151. package/.versions/0.0.4/agents/bowser.md +26 -0
  152. package/.versions/0.0.4/agents/builder.md +53 -0
  153. package/.versions/0.0.4/agents/code-reviewer.md +205 -0
  154. package/.versions/0.0.4/agents/deep-researcher.md +31 -0
  155. package/.versions/0.0.4/agents/documenter.md +18 -0
  156. package/.versions/0.0.4/agents/orchestrator.md +54 -0
  157. package/.versions/0.0.4/agents/plan-reviewer.md +60 -0
  158. package/.versions/0.0.4/agents/planner.md +69 -0
  159. package/.versions/0.0.4/agents/releaser.md +24 -0
  160. package/.versions/0.0.4/agents/researcher.md +28 -0
  161. package/.versions/0.0.4/agents/security-auditor.md +166 -0
  162. package/.versions/0.0.4/agents/test-engineer.md +151 -0
  163. package/.versions/0.0.4/agents/web-debugger.md +42 -0
  164. package/.versions/0.0.4/agents/web-performance-auditor.md +192 -0
  165. package/.versions/0.0.4/codex/CONDUCTOR.md +148 -0
  166. package/.versions/0.0.4/docs/ARCHITECTURE.md +210 -0
  167. package/.versions/0.0.4/docs/agent-fleet-setup.md +366 -0
  168. package/.versions/0.0.4/docs/claude-code-coms-bridge.md +103 -0
  169. package/.versions/0.0.4/docs/codex-remote-conductor.md +170 -0
  170. package/.versions/0.0.4/docs/coms-hermes-bridge.md +121 -0
  171. package/.versions/0.0.4/docs/getting-started.md +183 -0
  172. package/.versions/0.0.4/docs/npm-install.md +337 -0
  173. package/.versions/0.0.4/docs/opencode-setup.md +248 -0
  174. package/.versions/0.0.4/docs/pi-extensions.md +288 -0
  175. package/.versions/0.0.4/docs/pi-setup.md +463 -0
  176. package/.versions/0.0.4/docs/skill-anatomy.md +150 -0
  177. package/.versions/0.0.4/hermes/README.md +228 -0
  178. package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  179. package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  180. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  181. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  182. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  183. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  184. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  185. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  186. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  187. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  188. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  189. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  190. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  191. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  192. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  193. package/.versions/0.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  194. package/.versions/0.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  195. package/.versions/0.0.4/hooks/SIMPLIFY-IGNORE.md +90 -0
  196. package/.versions/0.0.4/hooks/coms-stop-hook.mjs +73 -0
  197. package/.versions/0.0.4/hooks/hooks.json +14 -0
  198. package/.versions/0.0.4/hooks/session-start.sh +74 -0
  199. package/.versions/0.0.4/hooks/simplify-ignore.sh +302 -0
  200. package/.versions/0.0.4/justfile +256 -0
  201. package/.versions/0.0.4/references/accessibility-checklist.md +160 -0
  202. package/.versions/0.0.4/references/definition-of-done.md +67 -0
  203. package/.versions/0.0.4/references/fleet-coordination-patterns.md +151 -0
  204. package/.versions/0.0.4/references/observability-checklist.md +91 -0
  205. package/.versions/0.0.4/references/orchestration-patterns.md +370 -0
  206. package/.versions/0.0.4/references/performance-checklist.md +153 -0
  207. package/.versions/0.0.4/references/prompting-patterns.md +380 -0
  208. package/.versions/0.0.4/references/security-checklist.md +179 -0
  209. package/.versions/0.0.4/references/testing-patterns.md +236 -0
  210. package/.versions/0.0.4/scripts/codex-conductor.ts +41 -0
  211. package/.versions/0.0.4/scripts/codex-remote-control.ts +167 -0
  212. package/.versions/0.0.4/scripts/coms-claude-bridge.ts +286 -0
  213. package/.versions/0.0.4/scripts/coms-cli.ts +484 -0
  214. package/.versions/0.0.4/scripts/coms-hermes-bridge.ts +403 -0
  215. package/.versions/0.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  216. package/.versions/0.0.4/scripts/hermes-monitor-scenario.ts +7 -0
  217. package/.versions/0.0.4/scripts/lib/claude-bridge-core.ts +100 -0
  218. package/.versions/0.0.4/scripts/lib/codex-conductor.ts +88 -0
  219. package/.versions/0.0.4/scripts/lib/codex-remote-control.ts +480 -0
  220. package/.versions/0.0.4/scripts/lib/coms-envelope.ts +539 -0
  221. package/.versions/0.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  222. package/.versions/0.0.4/scripts/lib/herdr-layout.ts +263 -0
  223. package/.versions/0.0.4/scripts/lib/hermes-bridge-core.ts +238 -0
  224. package/.versions/0.0.4/scripts/lib/hermes-monitor-herdr.ts +28 -0
  225. package/.versions/0.0.4/scripts/lib/hermes-monitor-model.ts +9 -0
  226. package/.versions/0.0.4/scripts/lib/hermes-monitor-registry.ts +6 -0
  227. package/.versions/0.0.4/scripts/lib/hermes-monitor-socket.ts +118 -0
  228. package/.versions/0.0.4/scripts/lib/hermes-monitor-store.ts +31 -0
  229. package/.versions/0.0.4/scripts/lib/persona-banner.ts +62 -0
  230. package/.versions/0.0.4/scripts/lib/spawn-stagger.ts +101 -0
  231. package/.versions/0.0.4/scripts/lib/team-project.ts +184 -0
  232. package/.versions/0.0.4/scripts/lib/team-snapshot.ts +147 -0
  233. package/.versions/0.0.4/scripts/peer-banner.ts +40 -0
  234. package/.versions/0.0.4/scripts/team-snapshot.ts +238 -0
  235. package/.versions/0.0.4/scripts/team-up.ts +333 -0
  236. package/.versions/0.0.4/skills/_internal/grilling.md +11 -0
  237. package/.versions/0.0.4/skills/browser-testing-with-devtools/SKILL.md +352 -0
  238. package/.versions/0.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  239. package/.versions/0.0.4/skills/compound-learning/SKILL.md +137 -0
  240. package/.versions/0.0.4/skills/context-engineering/SKILL.md +291 -0
  241. package/.versions/0.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  242. package/.versions/0.0.4/skills/designing-agents/SKILL.md +394 -0
  243. package/.versions/0.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  244. package/.versions/0.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  245. package/.versions/0.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  246. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +535 -0
  247. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +33 -0
  248. package/.versions/0.0.4/skills/idea-refine/SKILL.md +182 -0
  249. package/.versions/0.0.4/skills/idea-refine/examples.md +238 -0
  250. package/.versions/0.0.4/skills/idea-refine/frameworks.md +99 -0
  251. package/.versions/0.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  252. package/.versions/0.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  253. package/.versions/0.0.4/skills/incremental-implementation/SKILL.md +287 -0
  254. package/.versions/0.0.4/skills/interview-me/SKILL.md +226 -0
  255. package/.versions/0.0.4/skills/orchestration-verification/SKILL.md +181 -0
  256. package/.versions/0.0.4/skills/peer-coms/SKILL.md +90 -0
  257. package/.versions/0.0.4/skills/performance-optimization/SKILL.md +350 -0
  258. package/.versions/0.0.4/skills/planning-and-task-breakdown/SKILL.md +236 -0
  259. package/.versions/0.0.4/skills/security-and-hardening/SKILL.md +461 -0
  260. package/.versions/0.0.4/skills/spec-driven-development/SKILL.md +245 -0
  261. package/.versions/0.0.4/skills/using-agent-skills/SKILL.md +199 -0
  262. package/.versions/0.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  263. package/.versions/0.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  264. package/.versions/0.0.4/vendor/agent-skills-upstream/README.md +11 -0
  265. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  266. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  267. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  268. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  269. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  270. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  271. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  272. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  273. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  274. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  275. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  276. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  277. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  278. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  279. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  280. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  281. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  282. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  283. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  284. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  285. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  286. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  287. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  288. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  289. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  290. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  291. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  292. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  293. package/CHANGELOG.md +53 -0
  294. package/README.md +103 -541
  295. package/agents/architect.md +1 -1
  296. package/agents/builder.md +1 -1
  297. package/agents/code-reviewer.md +1 -1
  298. package/agents/deep-researcher.md +3 -3
  299. package/agents/orchestrator.md +20 -11
  300. package/agents/plan-reviewer.md +3 -3
  301. package/agents/planner.md +1 -1
  302. package/agents/security-auditor.md +1 -1
  303. package/agents/test-engineer.md +11 -4
  304. package/bin/lib/validate-overrides.js +19 -0
  305. package/bin/snapshot-version.js +17 -1
  306. package/bin/sync-harness-versions.js +94 -0
  307. package/codex/CONDUCTOR.md +148 -0
  308. package/docs/ARCHITECTURE.md +210 -0
  309. package/docs/agent-fleet-setup.md +11 -0
  310. package/docs/claude-code-coms-bridge.md +10 -0
  311. package/docs/codex-remote-conductor.md +170 -0
  312. package/docs/coms-hermes-bridge.md +121 -0
  313. package/docs/getting-started.md +14 -0
  314. package/docs/npm-install.md +2 -0
  315. package/docs/pi-extensions.md +49 -14
  316. package/docs/pi-setup.md +12 -4
  317. package/hermes/README.md +228 -0
  318. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  319. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  320. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  321. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  322. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  323. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  324. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  325. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  326. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  327. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  328. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  329. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  330. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  331. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  332. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  333. package/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  334. package/hermes/skills/hub-conductor/SKILL.md +84 -0
  335. package/hermes/skills/hub-liaison/SKILL.md +84 -0
  336. package/justfile +106 -23
  337. package/package.json +17 -5
  338. package/scripts/codex-conductor.ts +41 -0
  339. package/scripts/codex-remote-control.ts +167 -0
  340. package/scripts/coms-cli.ts +311 -199
  341. package/scripts/coms-hermes-bridge.ts +2 -2
  342. package/scripts/lib/codex-conductor.ts +88 -0
  343. package/scripts/lib/codex-remote-control.ts +480 -0
  344. package/scripts/lib/coms-envelope.ts +51 -6
  345. package/scripts/lib/fake-herdr-server.ts +88 -0
  346. package/scripts/lib/herdr-layout.ts +18 -3
  347. package/scripts/lib/hermes-bridge-core.ts +4 -4
  348. package/scripts/lib/hermes-monitor-herdr.ts +28 -0
  349. package/scripts/lib/hermes-monitor-model.ts +9 -0
  350. package/scripts/lib/hermes-monitor-registry.ts +6 -0
  351. package/scripts/lib/hermes-monitor-socket.ts +118 -0
  352. package/scripts/lib/hermes-monitor-store.ts +31 -0
  353. package/scripts/lib/team-project.ts +85 -1
  354. package/scripts/team-up.ts +77 -18
  355. package/skills/designing-agents/SKILL.md +2 -2
  356. package/skills/designing-agents/pi-harness-authoring.md +26 -13
  357. package/skills/guided-workspace-setup/SKILL.md +131 -102
  358. package/skills/guided-workspace-setup/companion-manifest.json +33 -0
  359. package/skills/peer-coms/SKILL.md +9 -0
  360. package/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  361. package/.pi/harnesses/damage-control/README.md +0 -65
  362. package/.pi/harnesses/damage-control/index.ts +0 -250
package/justfile CHANGED
@@ -8,8 +8,8 @@
8
8
  # under .pi/extensions/, so anything placed there loads on every plain `pi` run.
9
9
  # Most harnesses are mutually exclusive — they live in .pi/harnesses/ (which pi
10
10
  # does NOT auto-discover) and are loaded via `pi -e` below. The supported stack
11
- # is a damage-control variant before agent-hub (damage-control-continue for the main
12
- # session), so the hub recipes run with guardrails by default.
11
+ # loads damage-control-continue before agent-hub, so hub sessions and all native
12
+ # children run with guardrails by default.
13
13
  #
14
14
  # Everything between the two `agent-fleet:harnesses` sentinels below is a
15
15
  # MANAGED REGION: guided-workspace-setup regenerates it from the installed
@@ -20,6 +20,14 @@
20
20
  # >>> agent-fleet:harnesses — managed region (regenerated on upgrade; edits inside are overwritten) >>>
21
21
  set dotenv-load := true
22
22
 
23
+ # How recipes run the fleet TS scripts. The preserve-symlinks flags matter for
24
+ # symlink installs (guided-workspace-setup's `symlink` method): there
25
+ # scripts/*.ts are links whose realpath sits under .pi/npm/node_modules/, and
26
+ # Node refuses --experimental-strip-types for anything under node_modules once
27
+ # paths are realpath'd. Keeping symlink paths avoids that; copy installs are
28
+ # unaffected (the fleet scripts import only relative paths + node builtins).
29
+ node_ts := "node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main"
30
+
23
31
  # List all recipes
24
32
  default:
25
33
  @just --list
@@ -37,12 +45,8 @@ pi:
37
45
 
38
46
  # ---------------------------------------------------------------- safety
39
47
 
40
- # Damage-control: block destructive tool calls (aborts the turn)
41
- ext-damage-control:
42
- pi -e .pi/harnesses/damage-control/index.ts
43
-
44
- # Damage-control (continue): same rules, but blocks deliver feedback so the agent adapts
45
- # and keeps working instead of aborting the turn. Default guardrail for the hub main agent.
48
+ # Damage-control: blocks deliver feedback so the agent adapts and keeps working
49
+ # instead of aborting the turn. Default guardrail for the hub and native children.
46
50
  ext-damage-control-continue:
47
51
  pi -e .pi/harnesses/damage-control-continue/index.ts
48
52
 
@@ -54,8 +58,8 @@ ext-damage-control-continue:
54
58
  # agents/orchestrator.md is installed, so the hub still launches when it is absent. Override
55
59
  # with your own --system-prompt <persona>.md passed after `just hub`.
56
60
  # Guarded agent hub: damage-control-continue + remote-capable ask_user + dispatcher grid + research helpers + embedded coms + orchestrator.
57
- # The main session loads the CONTINUE guardrail (blocks feed back so the dispatcher adapts and keeps going);
58
- # spawned specialists still inherit the hard-stop damage-control variant (research helpers inherit continue).
61
+ # The main session and every native child use the continue guardrail; blocked calls
62
+ # feed back so the agent can report or safely adapt without aborting its turn.
59
63
  hub *args:
60
64
  persona=""; if [ -f agents/orchestrator.md ]; then persona="--append-system-prompt agents/orchestrator.md"; fi; pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts $persona {{args}}
61
65
 
@@ -72,20 +76,20 @@ hub-solo *args:
72
76
  # simultaneous boots race on the auth.json lock and lose their logins.
73
77
  # Hidden from `just --list` because recipes prefixed with `_` are private.
74
78
  _peer persona name="" model="" session="" project="default":
75
- d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; node --experimental-strip-types scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
79
+ d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; {{node_ts}} scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
76
80
 
77
81
  # Like _peer, but also loads extra always-on extensions (comma-separated names under
78
82
  # .pi/extensions/) into the peer process — e.g. a chrome-devtools-mcp browser-debug peer
79
83
  # whose `chrome_devtools__*` tools a normal --no-extensions subagent could not get.
80
84
  _peer-plus extensions persona name="" model="" session="" project="default":
81
- d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; node --experimental-strip-types scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; extra=""; old_ifs="$IFS"; IFS=','; for x in {{extensions}}; do x="$(echo "$x" | xargs)"; if [ -n "$x" ]; then extra="$extra -e .pi/extensions/$x/index.ts"; fi; done; IFS="$old_ifs"; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts $extra --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
85
+ d="${AGENT_FLEET_SPAWN_DELAY:-0}"; if [ "$d" != "0" ]; then echo "⏳ waiting ${d}s for the pi auth pre-warm (stale OAuth token)"; sleep "$d"; fi; {{node_ts}} scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; extra=""; old_ifs="$IFS"; IFS=','; for x in {{extensions}}; do x="$(echo "$x" | xargs)"; if [ -n "$x" ]; then extra="$extra -e .pi/extensions/$x/index.ts"; fi; done; IFS="$old_ifs"; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts $extra --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
82
86
 
83
87
  # Internal helper for team-up: a `runner: claude-code` peer — interactive
84
88
  # Claude Code plus its coms bridge (scripts/coms-claude-bridge.ts) in ONE pane.
85
89
  # The bridge registers the pane as coms peer <name>; the trailing session
86
90
  # positional maps to `claude --resume <id>` for team-resume.
87
91
  _claude-peer name model="" session="" project="default":
88
- node --experimental-strip-types scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
92
+ {{node_ts}} scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
89
93
 
90
94
  # The team recipes below take the team as a positional arg (defaults to "full")
91
95
  # and pass everything after it straight to the script.
@@ -94,7 +98,10 @@ _claude-peer name model="" session="" project="default":
94
98
  # where the tag is the last dot-segment of this directory's basename (main.wt2 →
95
99
  # wt2, ringithub.end2 → end2, plain agent-fleet → agent-fleet). So the same team
96
100
  # launched from different repos/worktrees gets its own workspace (wt2-hub-plan vs
97
- # end2-hub-plan) instead of colliding on a shared label.
101
+ # end2-hub-plan) instead of colliding on a shared label. This is not global
102
+ # uniqueness: unrelated checkouts with the same basename/final dot-segment can
103
+ # still collide. Existing-workspace refusal prevents clobbering; it does not
104
+ # prove the labels are unique.
98
105
  #
99
106
  # `--project <name>` is a SEPARATE axis: it scopes the coms peer POOL. Without it
100
107
  # every peer lands in the shared "default" pool, where teams launched from OTHER
@@ -108,54 +115,130 @@ _claude-peer name model="" session="" project="default":
108
115
  # e.g. just team-up full
109
116
  # just team-up review --project af
110
117
  team-up team="full" *args:
111
- node --experimental-strip-types scripts/team-up.ts --team {{team}} {{args}}
118
+ {{node_ts}} scripts/team-up.ts --team {{team}} {{args}}
112
119
 
113
120
  # Team up (dry run): print the resolved layout + per-peer commands without touching herdr.
114
121
  # e.g. just team-up-dry full
115
122
  # just team-up-dry review --project af
116
123
  team-up-dry team="full" *args:
117
- node --experimental-strip-types scripts/team-up.ts --team {{team}} --dry-run {{args}}
124
+ {{node_ts}} scripts/team-up.ts --team {{team}} --dry-run {{args}}
118
125
 
119
126
  # Hub + team in ONE herdr workspace: the guarded hub (`just hub`) in a larger
120
127
  # main pane, the team's peers tiled beside it.
121
128
  # e.g. just hub-team docs
122
129
  # just hub-team review --project af
123
130
  hub-team team="full" *args:
124
- node --experimental-strip-types scripts/team-up.ts --team {{team}} --hub {{args}}
131
+ {{node_ts}} scripts/team-up.ts --team {{team}} --hub {{args}}
125
132
 
126
133
  # Hub + team (dry run): print the combined layout without touching herdr.
127
134
  # e.g. just hub-team-dry review --project af
128
135
  hub-team-dry team="full" *args:
129
- node --experimental-strip-types scripts/team-up.ts --team {{team}} --hub --dry-run {{args}}
136
+ {{node_ts}} scripts/team-up.ts --team {{team}} --hub --dry-run {{args}}
130
137
 
131
138
  # Hermes conductor + team in ONE herdr workspace: Hermes dev profile in a conductor pane,
132
139
  # the team's peers tiled beside it. Hermes delegates via coms-cli and never drives herdr.
133
140
  # e.g. just conductor docs --project af
134
141
  conductor team="full" *args:
135
- node --experimental-strip-types scripts/team-up.ts --team {{team}} --conductor {{args}}
142
+ {{node_ts}} scripts/team-up.ts --team {{team}} --conductor {{args}}
136
143
 
137
144
  # Hermes conductor + team (dry run): print the combined layout without touching herdr.
138
145
  # e.g. just conductor-dry docs --project af
139
146
  conductor-dry team="full" *args:
140
- node --experimental-strip-types scripts/team-up.ts --team {{team}} --conductor --dry-run {{args}}
147
+ {{node_ts}} scripts/team-up.ts --team {{team}} --conductor --dry-run {{args}}
148
+
149
+ # Experimental Codex remote-control conductor lifecycle (verified with CLI
150
+ # 0.144.x). Pairing stays interactive and its short-lived code must never be
151
+ # captured. The user service is singleton across repos/projects.
152
+ # e.g. just conductor-codex-setup docs --project af
153
+ conductor-codex-setup team="full" *args:
154
+ {{node_ts}} scripts/codex-remote-control.ts setup-conductor --codex-bin "$(command -v codex)" --repo-root "$(pwd -P)" --coms-dir "$HOME/.pi/coms" --team "{{team}}" --timeout 300000 {{args}}
155
+
156
+ conductor-codex-reconfigure team="full" *args:
157
+ {{node_ts}} scripts/codex-remote-control.ts reconfigure-conductor --codex-bin "$(command -v codex)" --repo-root "$(pwd -P)" --coms-dir "$HOME/.pi/coms" --team "{{team}}" --timeout 300000 {{args}}
158
+
159
+ conductor-codex-pair:
160
+ {{node_ts}} scripts/codex-remote-control.ts pair
161
+
162
+ conductor-codex-start:
163
+ {{node_ts}} scripts/codex-remote-control.ts start
164
+
165
+ conductor-codex-status:
166
+ {{node_ts}} scripts/codex-remote-control.ts status
167
+
168
+ conductor-codex-stop:
169
+ {{node_ts}} scripts/codex-remote-control.ts stop
170
+
171
+ conductor-codex-recover:
172
+ {{node_ts}} scripts/codex-remote-control.ts recover --confirm operator-confirmed
173
+
174
+ conductor-codex-uninstall:
175
+ {{node_ts}} scripts/codex-remote-control.ts uninstall --confirm operator-confirmed
176
+
177
+ # Codex conductor + team in one workspace. The root is a requested-state
178
+ # control pane; systemd owns the remote-control daemon.
179
+ # e.g. just conductor-codex docs --project af
180
+ conductor-codex team="full" *args:
181
+ {{node_ts}} scripts/team-up.ts --team {{team}} --conductor codex {{args}}
182
+
183
+ conductor-codex-dry team="full" *args:
184
+ {{node_ts}} scripts/team-up.ts --team {{team}} --conductor codex --dry-run {{args}}
185
+
186
+ # Legacy pilot aliases retained for the 0.144.x experimental rollout.
187
+ # Setup/reconfigure resolve the selected binary and persist one validated
188
+ # repo/project/team/coms context.
189
+ # e.g. just conductor-codex-pilot-setup docs --project af
190
+ conductor-codex-pilot-setup team="full" *args:
191
+ {{node_ts}} scripts/codex-remote-control.ts setup-pilot --codex-bin "$(command -v codex)" --repo-root "$(pwd -P)" --coms-dir "$HOME/.pi/coms" --team "{{team}}" --timeout 300000 {{args}}
192
+
193
+ conductor-codex-pilot-reconfigure team="full" *args:
194
+ {{node_ts}} scripts/codex-remote-control.ts reconfigure-pilot --codex-bin "$(command -v codex)" --repo-root "$(pwd -P)" --coms-dir "$HOME/.pi/coms" --team "{{team}}" --timeout 300000 {{args}}
195
+
196
+ conductor-codex-pilot-pair:
197
+ {{node_ts}} scripts/codex-remote-control.ts pair
198
+
199
+ conductor-codex-pilot-start:
200
+ {{node_ts}} scripts/codex-remote-control.ts start
201
+
202
+ conductor-codex-pilot-status:
203
+ {{node_ts}} scripts/codex-remote-control.ts status
204
+
205
+ conductor-codex-pilot-stop:
206
+ {{node_ts}} scripts/codex-remote-control.ts stop
207
+
208
+ conductor-codex-pilot-recover:
209
+ {{node_ts}} scripts/codex-remote-control.ts recover --confirm operator-confirmed
210
+
211
+ conductor-codex-pilot-uninstall:
212
+ {{node_ts}} scripts/codex-remote-control.ts uninstall --confirm operator-confirmed
213
+
214
+ # Legacy pilot live aliases use the same verified implementation. The root pane
215
+ # is the lifecycle helper's foreground control pane, never a daemon command.
216
+ # e.g. just conductor-codex-pilot docs --project af
217
+ conductor-codex-pilot team="full" *args:
218
+ {{node_ts}} scripts/team-up.ts --team {{team}} --conductor codex {{args}}
219
+
220
+ # Legacy pilot dry-run alias.
221
+ # e.g. just conductor-codex-pilot-dry docs --project af
222
+ conductor-codex-pilot-dry team="full" *args:
223
+ {{node_ts}} scripts/team-up.ts --team {{team}} --conductor codex --dry-run {{args}}
141
224
 
142
225
  # Snapshot a RUNNING team's session refs to ~/.pi/team-snapshots/<team>.json
143
226
  # (team keeps running — take one proactively so a crash is resumable).
144
227
  # A team launched with --project must snapshot with the same --project.
145
228
  # e.g. just team-snapshot review --project af
146
229
  team-snapshot team="full" *args:
147
- node --experimental-strip-types scripts/team-snapshot.ts snapshot {{team}} {{args}}
230
+ {{node_ts}} scripts/team-snapshot.ts snapshot {{team}} {{args}}
148
231
 
149
232
  # Snapshot, then close the team workspace cleanly (peers get SIGTERM).
150
233
  # e.g. just team-down review --project af
151
234
  team-down team="full" *args:
152
- node --experimental-strip-types scripts/team-snapshot.ts down {{team}} {{args}}
235
+ {{node_ts}} scripts/team-snapshot.ts down {{team}} {{args}}
153
236
 
154
237
  # Rebuild a team from its snapshot — each pi peer resumes its previous
155
238
  # conversation (`pi --session <ref>`); peers whose ref is gone start fresh.
156
239
  # e.g. just team-resume review --project af
157
240
  team-resume team="full" *args:
158
- node --experimental-strip-types scripts/team-snapshot.ts resume {{team}} {{args}}
241
+ {{node_ts}} scripts/team-snapshot.ts resume {{team}} {{args}}
159
242
 
160
243
  # ---------------------------------------------------------------- coms (Pi-to-Pi messaging)
161
244
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chankov/agent-fleet",
3
- "version": "0.0.2",
3
+ "version": "0.0.4",
4
4
  "description": "Multi-agent fleet orchestration for coding agents. Pi as the primary runtime, Herdr as the workspace control plane, coms as the peer data plane, and Hermes for remote control — plus skills, personas, harnesses, and a guided setup CLI.",
5
5
  "keywords": [
6
6
  "ai",
@@ -58,12 +58,22 @@
58
58
  ".pi/agents/",
59
59
  ".pi/damage-control-rules.yaml",
60
60
  "scripts/*.ts",
61
+ "!scripts/hermes-monitor-capability-runner.ts",
62
+ "!scripts/hermes-monitor-capability-runner.test.ts",
63
+ "!scripts/hermes-monitor-scenario.ts",
64
+ "!scripts/hermes-monitor-scenario.test.ts",
61
65
  "scripts/lib/*.ts",
66
+ "codex/",
67
+ "hermes/",
68
+ "systemd/",
62
69
  "justfile",
63
70
  "references/",
64
71
  "hooks/",
65
72
  "docs/agent-fleet-setup.md",
73
+ "docs/ARCHITECTURE.md",
74
+ "docs/codex-remote-conductor.md",
66
75
  "docs/claude-code-coms-bridge.md",
76
+ "docs/coms-hermes-bridge.md",
67
77
  "docs/pi-extensions.md",
68
78
  "docs/npm-install.md",
69
79
  "docs/skill-anatomy.md",
@@ -88,10 +98,10 @@
88
98
  "access": "public"
89
99
  },
90
100
  "scripts": {
91
- "test": "node bin/cli.js --version && node bin/cli.js --help && node bin/cli.js transform-persona --list --agent claude-code && node --test \"bin/test/*.test.js\" \".pi/harnesses/lib/herdr-client.test.ts\" \".pi/harnesses/lib/herdr-presence.test.ts\" \"scripts/lib/team-project.test.ts\" \"scripts/lib/herdr-layout.test.ts\" \"scripts/lib/spawn-stagger.test.ts\" \"scripts/lib/fleet-extras.test.ts\" \"scripts/lib/team-snapshot.test.ts\" \"scripts/lib/coms-envelope.test.ts\" \"scripts/lib/claude-bridge-core.test.ts\" \"scripts/lib/hermes-bridge-core.test.ts\" \"scripts/coms-hermes-bridge.test.ts\" \".pi/harnesses/ask-user-remote/race-core.test.js\" \".pi/harnesses/ask-user-remote/index.test.ts\" \".pi/extensions/btw/state.test.js\" \".pi/harnesses/agent-hub/return-contract.test.js\" \".pi/harnesses/agent-hub/backend-policy.test.js\" \".pi/harnesses/agent-hub/artifacts.test.js\" \".pi/harnesses/agent-hub/scope-gate.test.js\" \".pi/harnesses/agent-hub/evidence-rules.test.js\" \".pi/harnesses/damage-control/shared.test.js\" \".pi/harnesses/damage-control/herdr-rules.test.js\" \".pi/harnesses/damage-control-continue/exemptions.test.js\"",
101
+ "test": "node bin/cli.js --version && node bin/cli.js --help && node bin/cli.js transform-persona --list --agent claude-code && node --test \"bin/test/*.test.js\" scripts/agent-hub-helpers.test.mjs scripts/agent-hub-spawn.test.mjs scripts/agent-hub-delegate.test.mjs scripts/agent-hub-research.test.mjs .pi/harnesses/lib/herdr-client.test.ts .pi/harnesses/lib/herdr-presence.test.ts scripts/coms-cli.test.ts scripts/lib/codex-conductor.test.ts scripts/lib/codex-remote-control.test.ts scripts/lib/team-project.test.ts scripts/lib/herdr-layout.test.ts scripts/lib/spawn-stagger.test.ts scripts/lib/fleet-extras.test.ts scripts/lib/team-snapshot.test.ts scripts/lib/coms-envelope.test.ts scripts/lib/claude-bridge-core.test.ts scripts/lib/hermes-bridge-core.test.ts scripts/coms-hermes-bridge.test.ts .pi/harnesses/ask-user-remote/race-core.test.js .pi/harnesses/ask-user-remote/index.test.ts .pi/extensions/btw/state.test.js .pi/harnesses/agent-hub/footer.test.ts .pi/harnesses/agent-hub/safety-routing.test.ts .pi/harnesses/agent-hub/approval-routing.integration.test.ts .pi/harnesses/agent-hub/run-budget.test.js .pi/harnesses/agent-hub/drift-watchdog.test.js .pi/harnesses/agent-hub/return-contract.test.js .pi/harnesses/agent-hub/backend-policy.test.js .pi/harnesses/agent-hub/artifacts.test.js .pi/harnesses/agent-hub/scope-gate.test.js .pi/harnesses/agent-hub/evidence-rules.test.js .pi/harnesses/agent-hub/research-retention.test.js .pi/harnesses/lib/damage-control-shared.test.ts .pi/harnesses/damage-control-continue/herdr-rules.test.js .pi/harnesses/damage-control-continue/exemptions.test.js scripts/lib/hermes-monitor-model.test.ts scripts/lib/hermes-monitor-store.test.ts scripts/lib/hermes-monitor-retention.integration.test.ts scripts/lib/hermes-monitor-registry.test.ts scripts/lib/hermes-monitor-socket.test.ts scripts/lib/hermes-monitor-data-path.test.ts scripts/lib/hermes-monitor-slice7-9-backend.test.ts scripts/lib/hermes-monitor-control-socket.test.ts scripts/lib/hermes-monitor-e2e.test.ts scripts/hermes-monitor-capability-runner.test.ts scripts/hermes-monitor-scenario.test.ts .pi/harnesses/agent-hub/monitor-control.test.ts .pi/harnesses/agent-hub/monitor-live-bridge-gaps.test.ts .pi/harnesses/agent-hub/monitor-review-live-wiring.red.test.ts .pi/harnesses/agent-hub/monitor-runtime.test.ts .pi/harnesses/agent-hub/monitor-bridge-runtime.test.ts .pi/harnesses/agent-hub/monitor-reconcile.test.ts .pi/harnesses/agent-hub/monitor-recovery.test.ts .pi/harnesses/agent-hub/monitor-lifecycle-lease.test.ts .pi/harnesses/agent-hub/monitor-session-bridge-race.test.ts .pi/harnesses/agent-hub/monitor-session-bridge.test.ts .pi/harnesses/agent-hub/monitor-cancel-race.test.ts .pi/harnesses/agent-hub/monitor-wait-only.test.ts .pi/harnesses/agent-hub/monitor-index.integration.test.ts",
92
102
  "pack:dry": "npm pack --dry-run",
93
103
  "changeset": "changeset",
94
- "version:changeset": "node bin/force-patch-changesets.js && changeset version && npm install --package-lock-only --ignore-scripts --no-audit --no-fund && node bin/snapshot-version.js",
104
+ "version:changeset": "node bin/force-patch-changesets.js && changeset version && node bin/sync-harness-versions.js && npm install --package-lock-only --ignore-scripts --no-audit --no-fund && node bin/snapshot-version.js",
95
105
  "release": "changeset publish"
96
106
  },
97
107
  "devDependencies": {
@@ -99,7 +109,8 @@
99
109
  },
100
110
  "dependencies": {
101
111
  "@sinclair/typebox": "^0.34.49",
102
- "pi-ask-user": "^0.11.1"
112
+ "pi-ask-user": "^0.11.1",
113
+ "yaml": "^2.9.0"
103
114
  },
104
115
  "bundledDependencies": [
105
116
  "pi-ask-user"
@@ -116,6 +127,7 @@
116
127
  ],
117
128
  "extensions": [
118
129
  "./.pi/harnesses/ask-user-remote/index.ts"
119
- ]
130
+ ],
131
+ "image": "https://raw.githubusercontent.com/chankov/agent-fleet/main/docs/assets/agent-hub-dashboard.png"
120
132
  }
121
133
  }
@@ -0,0 +1,41 @@
1
+ #!/usr/bin/env node
2
+ // Experimental external Codex conductor wrapper. It exposes no lifecycle,
3
+ // pairing, authentication, Herdr, or scope-override functionality.
4
+
5
+ import { spawnSync } from "node:child_process";
6
+ import * as fs from "node:fs";
7
+ import * as path from "node:path";
8
+ import { fileURLToPath } from "node:url";
9
+
10
+ import { buildConductorCommand, conductorProcessEnv, loadConductorContext, parseConductorArgs } from "./lib/codex-conductor.ts";
11
+ import { lifecyclePaths } from "./lib/codex-remote-control.ts";
12
+
13
+ function main(): void {
14
+ // Parse flags before config or filesystem access, then bind all scope from
15
+ // the owned configuration and the dedicated writable scratch directory.
16
+ const operation = parseConductorArgs(process.argv.slice(2));
17
+ const checkoutRoot = fs.realpathSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."));
18
+ const context = loadConductorContext({
19
+ configPath: lifecyclePaths().configPath,
20
+ cwd: process.cwd(),
21
+ checkoutRoot,
22
+ });
23
+ const result = spawnSync(process.execPath, [
24
+ "--experimental-strip-types",
25
+ path.join(context.repoRoot, "scripts", "coms-cli.ts"),
26
+ ...buildConductorCommand(context, operation),
27
+ ], {
28
+ cwd: context.conductorCwd,
29
+ stdio: "inherit",
30
+ env: conductorProcessEnv(context),
31
+ });
32
+ if (result.error) throw result.error;
33
+ process.exitCode = result.status ?? 1;
34
+ }
35
+
36
+ try {
37
+ main();
38
+ } catch (error) {
39
+ console.error(error instanceof Error ? error.message : String(error));
40
+ process.exitCode = 1;
41
+ }
@@ -0,0 +1,167 @@
1
+ #!/usr/bin/env node
2
+ // Repository-side lifecycle CLI. It never pairs automatically and exposes no
3
+ // health, PID, or transport assumptions.
4
+
5
+ import * as os from "node:os";
6
+ import * as path from "node:path";
7
+
8
+ import {
9
+ CONFIG_MARKER,
10
+ EMERGENCY_STOP_CONFIRMATION,
11
+ emergencySystemdStop,
12
+ lifecyclePaths,
13
+ loadOwnedConfig,
14
+ preflight,
15
+ restart,
16
+ setup,
17
+ start,
18
+ status,
19
+ stop,
20
+ systemRunner,
21
+ uninstall,
22
+ unitStart,
23
+ unitStop,
24
+ validateConfig,
25
+ type LifecycleConfig,
26
+ } from "./lib/codex-remote-control.ts";
27
+
28
+ type Flag = "config" | "codex-bin" | "repo-root" | "coms-dir" | "project" | "team" | "name" | "timeout" | "home" | "confirm" | "emergency-confirm";
29
+ const FLAGS = new Set<Flag>(["config", "codex-bin", "repo-root", "coms-dir", "project", "team", "name", "timeout", "home", "confirm", "emergency-confirm"]);
30
+
31
+ function fail(message: string): never { throw new Error(message); }
32
+
33
+ function parse(argv: string[]): { command: string; flags: Map<Flag, string> } {
34
+ const command = argv[0];
35
+ if (!command) fail("Usage: codex-remote-control <preflight|setup|reconfigure|setup-conductor|reconfigure-conductor|setup-pilot|reconfigure-pilot|pair|start|stop|emergency-stop|status|restart|recover|uninstall|control-pane|unit-start|unit-stop>");
36
+ const flags = new Map<Flag, string>();
37
+ for (let i = 1; i < argv.length; i++) {
38
+ const raw = argv[i];
39
+ if (!raw.startsWith("--")) fail(`Unexpected argument: ${raw}`);
40
+ const flag = raw.slice(2) as Flag;
41
+ if (!FLAGS.has(flag)) fail(`Unknown flag: ${raw}`);
42
+ if (flags.has(flag)) fail(`${raw} may only be provided once`);
43
+ const value = argv[++i];
44
+ if (!value || value.startsWith("--")) fail(`${raw} requires a value`);
45
+ flags.set(flag, value);
46
+ }
47
+ return { command, flags };
48
+ }
49
+
50
+ function required(flags: Map<Flag, string>, flag: Flag): string {
51
+ return flags.get(flag) ?? fail(`--${flag} is required`);
52
+ }
53
+
54
+ function runtimeDir(flags: Map<Flag, string>): string {
55
+ return lifecyclePaths(flags.get("home")).runtimeDir;
56
+ }
57
+
58
+ function configFromFlags(flags: Map<Flag, string>): LifecycleConfig {
59
+ return validateConfig({
60
+ marker: CONFIG_MARKER,
61
+ codexBin: required(flags, "codex-bin"),
62
+ repoRoot: required(flags, "repo-root"),
63
+ runtimeDir: runtimeDir(flags),
64
+ comsDir: required(flags, "coms-dir"),
65
+ project: required(flags, "project"),
66
+ team: required(flags, "team"),
67
+ name: required(flags, "name"),
68
+ timeoutMs: Number(required(flags, "timeout")),
69
+ });
70
+ }
71
+
72
+ function conductorConfigFromFlags(flags: Map<Flag, string>): LifecycleConfig {
73
+ const team = required(flags, "team");
74
+ const project = flags.get("project") ?? "default";
75
+ return validateConfig({
76
+ marker: CONFIG_MARKER,
77
+ codexBin: required(flags, "codex-bin"),
78
+ repoRoot: required(flags, "repo-root"),
79
+ runtimeDir: runtimeDir(flags),
80
+ comsDir: required(flags, "coms-dir"),
81
+ project,
82
+ team,
83
+ name: `codex-${team}-conductor`,
84
+ timeoutMs: Number(required(flags, "timeout")),
85
+ });
86
+ }
87
+
88
+ function configPath(flags: Map<Flag, string>): string {
89
+ return flags.get("config") ?? lifecyclePaths(flags.get("home")).configPath;
90
+ }
91
+
92
+ function configured(flags: Map<Flag, string>): LifecycleConfig {
93
+ return loadOwnedConfig(configPath(flags));
94
+ }
95
+
96
+ function pair(config: LifecycleConfig): void {
97
+ const checked = preflight(config);
98
+ const result = systemRunner(checked.codexBin, ["remote-control", "pair"], { stdio: "inherit" });
99
+ if (result.code !== 0) fail(`codex remote-control pair failed (${result.code})`);
100
+ }
101
+
102
+ function controlPane(): void {
103
+ console.log("Codex control pane: displaying requested systemd state only; this is not daemon health.");
104
+ const report = () => console.log(status());
105
+ report();
106
+ const timer = setInterval(report, 5_000);
107
+ const close = () => clearInterval(timer);
108
+ process.once("SIGINT", close);
109
+ process.once("SIGTERM", close);
110
+ }
111
+
112
+ function main(): void {
113
+ const { command, flags } = parse(process.argv.slice(2));
114
+ switch (command) {
115
+ case "preflight": {
116
+ const config = flags.has("repo-root") ? configFromFlags(flags) : validateConfig({
117
+ marker: CONFIG_MARKER,
118
+ codexBin: required(flags, "codex-bin"),
119
+ repoRoot: process.cwd(), runtimeDir: lifecyclePaths().runtimeDir, comsDir: path.join(os.homedir(), ".pi", "coms"),
120
+ project: "default", team: "codex", name: "codex", timeoutMs: 300_000,
121
+ });
122
+ preflight(config);
123
+ console.log("Codex 0.144.x remote-control start|stop|pair preflight passed");
124
+ return;
125
+ }
126
+ case "setup":
127
+ case "reconfigure":
128
+ case "setup-conductor":
129
+ case "reconfigure-conductor":
130
+ case "setup-pilot":
131
+ case "reconfigure-pilot": {
132
+ const scoped = command.endsWith("-conductor") || command.endsWith("-pilot");
133
+ const paths = setup(scoped ? conductorConfigFromFlags(flags) : configFromFlags(flags), systemRunner, {
134
+ home: flags.get("home"),
135
+ reconfigure: command.startsWith("reconfigure"),
136
+ });
137
+ console.log(`${command} complete: ${paths.unitPath}`);
138
+ return;
139
+ }
140
+ case "pair": pair(configured(flags)); return;
141
+ case "start": console.log(start(configured(flags))); return;
142
+ case "stop": console.log(stop(configured(flags))); return;
143
+ case "emergency-stop": console.log(emergencySystemdStop(configured(flags), systemRunner, required(flags, "confirm"))); return;
144
+ case "status": console.log(status()); return;
145
+ case "control-pane": controlPane(); return;
146
+ case "restart":
147
+ case "recover": console.log(restart(configured(flags), systemRunner, required(flags, "confirm"))); return;
148
+ case "uninstall": {
149
+ const paths = lifecyclePaths(flags.get("home"));
150
+ uninstall(paths, systemRunner, {
151
+ confirmation: required(flags, "confirm"),
152
+ emergencyConfirmation: flags.get("emergency-confirm") === EMERGENCY_STOP_CONFIRMATION ? EMERGENCY_STOP_CONFIRMATION : undefined,
153
+ });
154
+ return;
155
+ }
156
+ case "unit-start": unitStart(configured(flags)); return;
157
+ case "unit-stop": unitStop(configured(flags)); return;
158
+ default: fail(`Unknown command: ${command}`);
159
+ }
160
+ }
161
+
162
+ try {
163
+ main();
164
+ } catch (error) {
165
+ console.error(error instanceof Error ? error.message : String(error));
166
+ process.exitCode = 1;
167
+ }