@chankov/agent-fleet 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (608) hide show
  1. package/.claude/commands/set-hermes-telegram.md +15 -0
  2. package/.claude/commands/setup-agent-fleet.md +1 -1
  3. package/.opencode/commands/af-set-hermes-telegram.md +15 -0
  4. package/.opencode/commands/af-setup-agent-fleet.md +1 -1
  5. package/.pi/agents/dispatch-policy.yaml +1 -1
  6. package/.pi/agents/peers.yaml +4 -4
  7. package/.pi/extensions/chrome-devtools-mcp/README.md +1 -1
  8. package/.pi/extensions/mcp-bridge/README.md +1 -1
  9. package/.pi/harnesses/agent-hub/README.md +223 -40
  10. package/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  11. package/.pi/harnesses/agent-hub/delegate.ts +32 -9
  12. package/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  13. package/.pi/harnesses/agent-hub/footer.ts +29 -0
  14. package/.pi/harnesses/agent-hub/helpers.ts +49 -0
  15. package/.pi/harnesses/agent-hub/index.ts +1037 -246
  16. package/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  17. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  18. package/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  19. package/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  20. package/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  21. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  22. package/.pi/harnesses/agent-hub/package.json +5 -4
  23. package/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  24. package/.pi/harnesses/agent-hub/run-budget.js +155 -0
  25. package/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  26. package/.pi/harnesses/agent-hub/spawn.ts +161 -94
  27. package/.pi/harnesses/agent-hub/version.ts +18 -0
  28. package/.pi/harnesses/ask-user-remote/README.md +1 -0
  29. package/.pi/harnesses/ask-user-remote/index.ts +36 -8
  30. package/.pi/harnesses/coms/README.md +15 -5
  31. package/.pi/harnesses/coms/index.ts +2 -0
  32. package/.pi/harnesses/coms/package.json +5 -4
  33. package/.pi/harnesses/coms/version.ts +18 -0
  34. package/.pi/harnesses/damage-control-continue/README.md +36 -35
  35. package/.pi/harnesses/damage-control-continue/index.ts +23 -9
  36. package/.pi/harnesses/damage-control-continue/package.json +5 -4
  37. package/.pi/harnesses/damage-control-continue/version.ts +18 -0
  38. package/.pi/harnesses/{damage-control/shared.ts → lib/damage-control-shared.ts} +20 -6
  39. package/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  40. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  41. package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  42. package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  43. package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  44. package/.pi/prompts/set-hermes-telegram.md +15 -0
  45. package/.pi/prompts/setup-agent-fleet.md +1 -1
  46. package/.versions/0.0.4/.claude/commands/build.md +44 -0
  47. package/.versions/0.0.4/.claude/commands/code-simplify.md +22 -0
  48. package/.versions/0.0.4/.claude/commands/design-agent.md +14 -0
  49. package/.versions/0.0.4/.claude/commands/doctor-agent-fleet.md +17 -0
  50. package/.versions/0.0.4/.claude/commands/orchestrate.md +112 -0
  51. package/.versions/0.0.4/.claude/commands/plan.md +16 -0
  52. package/.versions/0.0.4/.claude/commands/prime.md +22 -0
  53. package/.versions/0.0.4/.claude/commands/review.md +16 -0
  54. package/.versions/0.0.4/.claude/commands/setup-agent-fleet.md +25 -0
  55. package/.versions/0.0.4/.claude/commands/ship.md +72 -0
  56. package/.versions/0.0.4/.claude/commands/spec.md +15 -0
  57. package/.versions/0.0.4/.claude/commands/test.md +19 -0
  58. package/.versions/0.0.4/.claude/commands/webperf.md +32 -0
  59. package/.versions/0.0.4/.claude/orchestrate-teams.yaml +24 -0
  60. package/.versions/0.0.4/.opencode/commands/af-build.md +17 -0
  61. package/.versions/0.0.4/.opencode/commands/af-code-simplify.md +16 -0
  62. package/.versions/0.0.4/.opencode/commands/af-compound.md +16 -0
  63. package/.versions/0.0.4/.opencode/commands/af-design-agent.md +15 -0
  64. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  65. package/.versions/0.0.4/.opencode/commands/af-orchestrate.md +112 -0
  66. package/.versions/0.0.4/.opencode/commands/af-plan.md +16 -0
  67. package/.versions/0.0.4/.opencode/commands/af-prime.md +22 -0
  68. package/.versions/0.0.4/.opencode/commands/af-review.md +15 -0
  69. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +15 -0
  70. package/.versions/0.0.4/.opencode/commands/af-ship.md +16 -0
  71. package/.versions/0.0.4/.opencode/commands/af-spec.md +16 -0
  72. package/.versions/0.0.4/.opencode/commands/af-test.md +21 -0
  73. package/.versions/0.0.4/.opencode/commands/af-webperf.md +32 -0
  74. package/.versions/0.0.4/.opencode/orchestrate-teams.yaml +24 -0
  75. package/.versions/0.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  76. package/.versions/0.0.4/.pi/agents/model-profiles.yaml +20 -0
  77. package/.versions/0.0.4/.pi/agents/peers.yaml +146 -0
  78. package/.versions/0.0.4/.pi/agents/teams.yaml +39 -0
  79. package/.versions/0.0.4/.pi/damage-control-rules.yaml +297 -0
  80. package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  81. package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  82. package/{.pi/harnesses/damage-control → .versions/0.0.4/.pi/extensions/agent-fleet-update-check}/package.json +1 -1
  83. package/.versions/0.0.4/.pi/extensions/btw/README.md +118 -0
  84. package/.versions/0.0.4/.pi/extensions/btw/index.ts +917 -0
  85. package/.versions/0.0.4/.pi/extensions/btw/package.json +6 -0
  86. package/.versions/0.0.4/.pi/extensions/btw/state.js +179 -0
  87. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  88. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  89. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  90. package/.versions/0.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  91. package/.versions/0.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  92. package/.versions/0.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  93. package/.versions/0.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  94. package/.versions/0.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  95. package/.versions/0.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  96. package/.versions/0.0.4/.pi/extensions/package-lock.json +1143 -0
  97. package/.versions/0.0.4/.pi/extensions/package.json +9 -0
  98. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/README.md +201 -0
  99. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  100. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  101. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  102. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  103. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  104. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  105. package/.versions/0.0.4/.pi/harnesses/agent-hub/README.md +798 -0
  106. package/.versions/0.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  107. package/.versions/0.0.4/.pi/harnesses/agent-hub/artifacts.js +92 -0
  108. package/.versions/0.0.4/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  109. package/.versions/0.0.4/.pi/harnesses/agent-hub/delegate.ts +386 -0
  110. package/.versions/0.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  111. package/.versions/0.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  112. package/.versions/0.0.4/.pi/harnesses/agent-hub/footer.ts +29 -0
  113. package/.versions/0.0.4/.pi/harnesses/agent-hub/helpers.ts +214 -0
  114. package/.versions/0.0.4/.pi/harnesses/agent-hub/index.ts +8045 -0
  115. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  116. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  117. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  118. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  119. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  120. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  121. package/.versions/0.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  122. package/.versions/0.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
  123. package/.versions/0.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  124. package/.versions/0.0.4/.pi/harnesses/agent-hub/return-contract.js +215 -0
  125. package/.versions/0.0.4/.pi/harnesses/agent-hub/run-budget.js +155 -0
  126. package/.versions/0.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  127. package/.versions/0.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  128. package/.versions/0.0.4/.pi/harnesses/agent-hub/spawn.ts +246 -0
  129. package/.versions/0.0.4/.pi/harnesses/agent-hub/version.ts +18 -0
  130. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/README.md +18 -0
  131. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/index.ts +293 -0
  132. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  133. package/.versions/0.0.4/.pi/harnesses/coms/README.md +92 -0
  134. package/.versions/0.0.4/.pi/harnesses/coms/index.ts +1745 -0
  135. package/.versions/0.0.4/.pi/harnesses/coms/package.json +7 -0
  136. package/.versions/0.0.4/.pi/harnesses/coms/version.ts +18 -0
  137. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/README.md +117 -0
  138. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  139. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  140. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/version.ts +18 -0
  141. package/.versions/0.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  142. package/.versions/0.0.4/.pi/harnesses/lib/herdr-client.ts +458 -0
  143. package/.versions/0.0.4/.pi/harnesses/lib/herdr-presence.ts +288 -0
  144. package/.versions/0.0.4/.pi/harnesses/package-lock.json +35 -0
  145. package/.versions/0.0.4/.pi/harnesses/package.json +9 -0
  146. package/.versions/0.0.4/.pi/prompts/build.md +24 -0
  147. package/.versions/0.0.4/.pi/prompts/code-simplify.md +22 -0
  148. package/.versions/0.0.4/.pi/prompts/doctor-agent-fleet.md +15 -0
  149. package/.versions/0.0.4/.pi/prompts/plan.md +16 -0
  150. package/.versions/0.0.4/.pi/prompts/review.md +16 -0
  151. package/.versions/0.0.4/.pi/prompts/setup-agent-fleet.md +27 -0
  152. package/.versions/0.0.4/.pi/prompts/ship.md +17 -0
  153. package/.versions/0.0.4/.pi/prompts/spec.md +15 -0
  154. package/.versions/0.0.4/.pi/prompts/test.md +19 -0
  155. package/.versions/0.0.4/.pi/skills/bowser/SKILL.md +145 -0
  156. package/.versions/0.0.4/.version +1 -0
  157. package/.versions/0.0.4/agents/architect.md +23 -0
  158. package/.versions/0.0.4/agents/bowser.md +26 -0
  159. package/.versions/0.0.4/agents/builder.md +53 -0
  160. package/.versions/0.0.4/agents/code-reviewer.md +205 -0
  161. package/.versions/0.0.4/agents/deep-researcher.md +31 -0
  162. package/.versions/0.0.4/agents/documenter.md +18 -0
  163. package/.versions/0.0.4/agents/orchestrator.md +54 -0
  164. package/.versions/0.0.4/agents/plan-reviewer.md +60 -0
  165. package/.versions/0.0.4/agents/planner.md +69 -0
  166. package/.versions/0.0.4/agents/releaser.md +24 -0
  167. package/.versions/0.0.4/agents/researcher.md +28 -0
  168. package/.versions/0.0.4/agents/security-auditor.md +166 -0
  169. package/.versions/0.0.4/agents/test-engineer.md +151 -0
  170. package/.versions/0.0.4/agents/web-debugger.md +42 -0
  171. package/.versions/0.0.4/agents/web-performance-auditor.md +192 -0
  172. package/.versions/0.0.4/codex/CONDUCTOR.md +148 -0
  173. package/.versions/0.0.4/docs/ARCHITECTURE.md +210 -0
  174. package/.versions/0.0.4/docs/agent-fleet-setup.md +366 -0
  175. package/.versions/0.0.4/docs/claude-code-coms-bridge.md +103 -0
  176. package/.versions/0.0.4/docs/codex-remote-conductor.md +170 -0
  177. package/.versions/0.0.4/docs/coms-hermes-bridge.md +121 -0
  178. package/.versions/0.0.4/docs/getting-started.md +183 -0
  179. package/.versions/0.0.4/docs/npm-install.md +337 -0
  180. package/.versions/0.0.4/docs/opencode-setup.md +248 -0
  181. package/.versions/0.0.4/docs/pi-extensions.md +288 -0
  182. package/.versions/0.0.4/docs/pi-setup.md +463 -0
  183. package/.versions/0.0.4/docs/skill-anatomy.md +150 -0
  184. package/.versions/0.0.4/hermes/README.md +228 -0
  185. package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  186. package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  187. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  188. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  189. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  190. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  191. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  192. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  193. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  194. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  195. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  196. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  197. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  198. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  199. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  200. package/.versions/0.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  201. package/.versions/0.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  202. package/.versions/0.0.4/hooks/SIMPLIFY-IGNORE.md +90 -0
  203. package/.versions/0.0.4/hooks/coms-stop-hook.mjs +73 -0
  204. package/.versions/0.0.4/hooks/hooks.json +14 -0
  205. package/.versions/0.0.4/hooks/session-start.sh +74 -0
  206. package/.versions/0.0.4/hooks/simplify-ignore.sh +302 -0
  207. package/.versions/0.0.4/justfile +256 -0
  208. package/.versions/0.0.4/references/accessibility-checklist.md +160 -0
  209. package/.versions/0.0.4/references/definition-of-done.md +67 -0
  210. package/.versions/0.0.4/references/fleet-coordination-patterns.md +151 -0
  211. package/.versions/0.0.4/references/observability-checklist.md +91 -0
  212. package/.versions/0.0.4/references/orchestration-patterns.md +370 -0
  213. package/.versions/0.0.4/references/performance-checklist.md +153 -0
  214. package/.versions/0.0.4/references/prompting-patterns.md +380 -0
  215. package/.versions/0.0.4/references/security-checklist.md +179 -0
  216. package/.versions/0.0.4/references/testing-patterns.md +236 -0
  217. package/.versions/0.0.4/scripts/codex-conductor.ts +41 -0
  218. package/.versions/0.0.4/scripts/codex-remote-control.ts +167 -0
  219. package/.versions/0.0.4/scripts/coms-claude-bridge.ts +286 -0
  220. package/.versions/0.0.4/scripts/coms-cli.ts +484 -0
  221. package/.versions/0.0.4/scripts/coms-hermes-bridge.ts +403 -0
  222. package/.versions/0.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  223. package/.versions/0.0.4/scripts/hermes-monitor-scenario.ts +7 -0
  224. package/.versions/0.0.4/scripts/lib/claude-bridge-core.ts +100 -0
  225. package/.versions/0.0.4/scripts/lib/codex-conductor.ts +88 -0
  226. package/.versions/0.0.4/scripts/lib/codex-remote-control.ts +480 -0
  227. package/.versions/0.0.4/scripts/lib/coms-envelope.ts +539 -0
  228. package/.versions/0.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  229. package/.versions/0.0.4/scripts/lib/herdr-layout.ts +263 -0
  230. package/.versions/0.0.4/scripts/lib/hermes-bridge-core.ts +238 -0
  231. package/.versions/0.0.4/scripts/lib/hermes-monitor-herdr.ts +28 -0
  232. package/.versions/0.0.4/scripts/lib/hermes-monitor-model.ts +9 -0
  233. package/.versions/0.0.4/scripts/lib/hermes-monitor-registry.ts +6 -0
  234. package/.versions/0.0.4/scripts/lib/hermes-monitor-socket.ts +118 -0
  235. package/.versions/0.0.4/scripts/lib/hermes-monitor-store.ts +31 -0
  236. package/.versions/0.0.4/scripts/lib/persona-banner.ts +62 -0
  237. package/.versions/0.0.4/scripts/lib/spawn-stagger.ts +101 -0
  238. package/.versions/0.0.4/scripts/lib/team-project.ts +184 -0
  239. package/.versions/0.0.4/scripts/lib/team-snapshot.ts +147 -0
  240. package/.versions/0.0.4/scripts/peer-banner.ts +40 -0
  241. package/.versions/0.0.4/scripts/team-snapshot.ts +238 -0
  242. package/.versions/0.0.4/scripts/team-up.ts +333 -0
  243. package/.versions/0.0.4/skills/_internal/grilling.md +11 -0
  244. package/.versions/0.0.4/skills/browser-testing-with-devtools/SKILL.md +352 -0
  245. package/.versions/0.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  246. package/.versions/0.0.4/skills/compound-learning/SKILL.md +137 -0
  247. package/.versions/0.0.4/skills/context-engineering/SKILL.md +291 -0
  248. package/.versions/0.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  249. package/.versions/0.0.4/skills/designing-agents/SKILL.md +394 -0
  250. package/.versions/0.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  251. package/.versions/0.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  252. package/.versions/0.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  253. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +535 -0
  254. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +33 -0
  255. package/.versions/0.0.4/skills/idea-refine/SKILL.md +182 -0
  256. package/.versions/0.0.4/skills/idea-refine/examples.md +238 -0
  257. package/.versions/0.0.4/skills/idea-refine/frameworks.md +99 -0
  258. package/.versions/0.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  259. package/.versions/0.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  260. package/.versions/0.0.4/skills/incremental-implementation/SKILL.md +287 -0
  261. package/.versions/0.0.4/skills/interview-me/SKILL.md +226 -0
  262. package/.versions/0.0.4/skills/orchestration-verification/SKILL.md +181 -0
  263. package/.versions/0.0.4/skills/peer-coms/SKILL.md +90 -0
  264. package/.versions/0.0.4/skills/performance-optimization/SKILL.md +350 -0
  265. package/.versions/0.0.4/skills/planning-and-task-breakdown/SKILL.md +236 -0
  266. package/.versions/0.0.4/skills/security-and-hardening/SKILL.md +461 -0
  267. package/.versions/0.0.4/skills/spec-driven-development/SKILL.md +245 -0
  268. package/.versions/0.0.4/skills/using-agent-skills/SKILL.md +199 -0
  269. package/.versions/0.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  270. package/.versions/0.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  271. package/.versions/0.0.4/vendor/agent-skills-upstream/README.md +11 -0
  272. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  273. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  274. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  275. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  276. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  277. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  278. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  279. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  280. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  281. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  282. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  283. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  284. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  285. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  286. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  287. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  288. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  289. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  290. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  291. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  292. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  293. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  294. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  295. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  296. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  297. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  298. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  299. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  300. package/.versions/0.0.5/.claude/commands/build.md +44 -0
  301. package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
  302. package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
  303. package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
  304. package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
  305. package/.versions/0.0.5/.claude/commands/plan.md +16 -0
  306. package/.versions/0.0.5/.claude/commands/prime.md +22 -0
  307. package/.versions/0.0.5/.claude/commands/review.md +16 -0
  308. package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
  309. package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
  310. package/.versions/0.0.5/.claude/commands/ship.md +72 -0
  311. package/.versions/0.0.5/.claude/commands/spec.md +15 -0
  312. package/.versions/0.0.5/.claude/commands/test.md +19 -0
  313. package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
  314. package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
  315. package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
  316. package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
  317. package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
  318. package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
  319. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  320. package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
  321. package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
  322. package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
  323. package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
  324. package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
  325. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
  326. package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
  327. package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
  328. package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
  329. package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
  330. package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
  331. package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  332. package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
  333. package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
  334. package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
  335. package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
  336. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  337. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  338. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  339. package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
  340. package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
  341. package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
  342. package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
  343. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  344. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  345. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  346. package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  347. package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  348. package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  349. package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  350. package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  351. package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  352. package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
  353. package/.versions/0.0.5/.pi/extensions/package.json +9 -0
  354. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
  355. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  356. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  357. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  358. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  359. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  360. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  361. package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
  362. package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  363. package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
  364. package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  365. package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
  366. package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  367. package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  368. package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
  369. package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
  370. package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
  371. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  372. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  373. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  374. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  375. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  376. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  377. package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  378. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
  379. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  380. package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
  381. package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
  382. package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  383. package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  384. package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
  385. package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
  386. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
  387. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
  388. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  389. package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
  390. package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
  391. package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
  392. package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
  393. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
  394. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  395. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  396. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
  397. package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  398. package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
  399. package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
  400. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  401. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  402. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  403. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  404. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  405. package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
  406. package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
  407. package/.versions/0.0.5/.pi/prompts/build.md +24 -0
  408. package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
  409. package/.versions/0.0.5/.pi/prompts/doctor-agent-fleet.md +15 -0
  410. package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
  411. package/.versions/0.0.5/.pi/prompts/review.md +16 -0
  412. package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
  413. package/.versions/0.0.5/.pi/prompts/setup-agent-fleet.md +27 -0
  414. package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
  415. package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
  416. package/.versions/0.0.5/.pi/prompts/test.md +19 -0
  417. package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
  418. package/.versions/0.0.5/.version +1 -0
  419. package/.versions/0.0.5/agents/architect.md +23 -0
  420. package/.versions/0.0.5/agents/bowser.md +26 -0
  421. package/.versions/0.0.5/agents/builder.md +53 -0
  422. package/.versions/0.0.5/agents/code-reviewer.md +205 -0
  423. package/.versions/0.0.5/agents/deep-researcher.md +31 -0
  424. package/.versions/0.0.5/agents/documenter.md +18 -0
  425. package/.versions/0.0.5/agents/orchestrator.md +54 -0
  426. package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
  427. package/.versions/0.0.5/agents/planner.md +69 -0
  428. package/.versions/0.0.5/agents/releaser.md +24 -0
  429. package/.versions/0.0.5/agents/researcher.md +28 -0
  430. package/.versions/0.0.5/agents/security-auditor.md +166 -0
  431. package/.versions/0.0.5/agents/test-engineer.md +151 -0
  432. package/.versions/0.0.5/agents/web-debugger.md +42 -0
  433. package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
  434. package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
  435. package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
  436. package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
  437. package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
  438. package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
  439. package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
  440. package/.versions/0.0.5/docs/getting-started.md +183 -0
  441. package/.versions/0.0.5/docs/npm-install.md +337 -0
  442. package/.versions/0.0.5/docs/opencode-setup.md +249 -0
  443. package/.versions/0.0.5/docs/pi-extensions.md +293 -0
  444. package/.versions/0.0.5/docs/pi-setup.md +472 -0
  445. package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
  446. package/.versions/0.0.5/hermes/README.md +231 -0
  447. package/.versions/0.0.5/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  448. package/.versions/0.0.5/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  449. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  450. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  451. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  452. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  453. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  454. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  455. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  456. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  457. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  458. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  459. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  460. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  461. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  462. package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  463. package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  464. package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
  465. package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
  466. package/.versions/0.0.5/hooks/hooks.json +14 -0
  467. package/.versions/0.0.5/hooks/session-start.sh +74 -0
  468. package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
  469. package/.versions/0.0.5/justfile +245 -0
  470. package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
  471. package/.versions/0.0.5/references/definition-of-done.md +67 -0
  472. package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
  473. package/.versions/0.0.5/references/observability-checklist.md +91 -0
  474. package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
  475. package/.versions/0.0.5/references/performance-checklist.md +153 -0
  476. package/.versions/0.0.5/references/prompting-patterns.md +380 -0
  477. package/.versions/0.0.5/references/security-checklist.md +179 -0
  478. package/.versions/0.0.5/references/testing-patterns.md +236 -0
  479. package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
  480. package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
  481. package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
  482. package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
  483. package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
  484. package/.versions/0.0.5/scripts/fleet.ts +141 -0
  485. package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  486. package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
  487. package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
  488. package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
  489. package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
  490. package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
  491. package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  492. package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
  493. package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
  494. package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  495. package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  496. package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  497. package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  498. package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  499. package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  500. package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
  501. package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
  502. package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
  503. package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
  504. package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
  505. package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
  506. package/.versions/0.0.5/scripts/team-up.ts +351 -0
  507. package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
  508. package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
  509. package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  510. package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
  511. package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
  512. package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  513. package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
  514. package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  515. package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  516. package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  517. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
  518. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
  519. package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
  520. package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
  521. package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
  522. package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  523. package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  524. package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
  525. package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
  526. package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
  527. package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
  528. package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
  529. package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
  530. package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
  531. package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
  532. package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
  533. package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  534. package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  535. package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
  536. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  537. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  538. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  539. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  540. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  541. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  542. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  543. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  544. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  545. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  546. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  547. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  548. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  549. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  550. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  551. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  552. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  553. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  554. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  555. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  556. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  557. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  558. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  559. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  560. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  561. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  562. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  563. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  564. package/CHANGELOG.md +62 -0
  565. package/README.md +17 -16
  566. package/agents/builder.md +1 -1
  567. package/agents/code-reviewer.md +1 -1
  568. package/agents/deep-researcher.md +3 -3
  569. package/agents/orchestrator.md +20 -11
  570. package/agents/plan-reviewer.md +3 -3
  571. package/agents/test-engineer.md +11 -4
  572. package/bin/cli.js +83 -1
  573. package/bin/lib/set-hermes-telegram.js +323 -0
  574. package/bin/lib/validate-overrides.js +19 -0
  575. package/bin/sync-harness-versions.js +94 -0
  576. package/docs/ARCHITECTURE.md +49 -4
  577. package/docs/agent-fleet-setup.md +11 -1
  578. package/docs/claude-code-coms-bridge.md +4 -4
  579. package/docs/codex-remote-conductor.md +12 -12
  580. package/docs/coms-hermes-bridge.md +62 -4
  581. package/docs/getting-started.md +4 -4
  582. package/docs/opencode-setup.md +1 -0
  583. package/docs/pi-extensions.md +73 -33
  584. package/docs/pi-setup.md +23 -8
  585. package/hermes/README.md +191 -8
  586. package/justfile +143 -158
  587. package/package.json +13 -5
  588. package/references/fleet-coordination-patterns.md +1 -1
  589. package/scripts/coms-hermes-bridge.ts +18 -8
  590. package/scripts/fleet.ts +141 -0
  591. package/scripts/lib/fake-herdr-server.ts +88 -0
  592. package/scripts/lib/fleet-command.ts +109 -0
  593. package/scripts/lib/hermes-bridge-core.ts +5 -2
  594. package/scripts/lib/hermes-monitor-herdr.ts +2 -0
  595. package/scripts/lib/hermes-monitor-model.ts +3 -0
  596. package/scripts/lib/hermes-monitor-registry.ts +2 -0
  597. package/scripts/lib/hermes-monitor-socket.ts +2 -0
  598. package/scripts/lib/hermes-monitor-store.ts +2 -0
  599. package/scripts/lib/team-project.ts +10 -3
  600. package/scripts/team-snapshot.ts +4 -5
  601. package/scripts/team-up.ts +24 -6
  602. package/skills/designing-agents/SKILL.md +2 -2
  603. package/skills/designing-agents/pi-harness-authoring.md +26 -13
  604. package/skills/guided-workspace-setup/SKILL.md +22 -12
  605. package/skills/guided-workspace-setup/companion-manifest.json +3 -1
  606. package/skills/peer-coms/SKILL.md +1 -1
  607. package/.pi/harnesses/damage-control/README.md +0 -65
  608. package/.pi/harnesses/damage-control/index.ts +0 -250
@@ -1,16 +1,7 @@
1
1
  /**
2
2
  * spawnPiAgent — the ONE place agent-hub code spawns a headless `pi` child and
3
- * parses its JSON event stream. Used by the hub itself (specialist dispatch +
4
- * research helpers, index.ts) and by the injected delegate extension
5
- * (delegate.ts), so the spawn args and stream parsing never exist in two
6
- * copies.
7
- *
8
- * The child is always `pi --mode json -p --no-extensions` with explicit `-e`
9
- * extensions (damage-control first, delegate when the persona declares
10
- * subagents), a model, a tool allowlist, and a session file. NOTE: pi's
11
- * `--tools` allowlist applies to extension-registered tools too, so a tool a
12
- * `-e` extension provides (e.g. `delegate`) must be NAMED in `tools` or the
13
- * child model never sees it (validated 2026-06-11).
3
+ * parses its JSON event stream. Research helpers and read-only delegate children
4
+ * opt into the per-tool watchdog here, rather than trusting an agent-side timer.
14
5
  */
15
6
 
16
7
  import { spawn, type ChildProcess } from "child_process";
@@ -21,49 +12,97 @@ export interface PiUsage {
21
12
  [k: string]: any;
22
13
  }
23
14
 
15
+ export interface ToolTimeout {
16
+ toolCallId: string;
17
+ toolName: string;
18
+ args: string;
19
+ startedAt: number;
20
+ deadlineAt: number;
21
+ }
22
+
23
+ export interface Termination {
24
+ reason: "tool_timeout" | "turn_timeout" | "drift_stop" | "cancelled";
25
+ confirmed: boolean;
26
+ escalated: boolean;
27
+ tool?: ToolTimeout;
28
+ }
29
+
30
+ /** External run control handed to the caller via onControl (drift watchdog). */
31
+ export interface PiRunControl {
32
+ /** Terminate the child group with the given classification (default "drift_stop"). */
33
+ terminate(reason?: "drift_stop" | "cancelled"): void;
34
+ }
35
+
36
+ export interface ToolWatchdogOptions {
37
+ /** Per read-only tool call deadline. null disables the watchdog. */
38
+ timeoutMs: number | null;
39
+ /** Grace after SIGTERM, followed by SIGKILL. Kept injectable for focused tests. */
40
+ termGraceMs?: number;
41
+ /** Bound on final settlement; never wait forever for close or inherited pipes. */
42
+ settleGraceMs?: number;
43
+ /** Only these tool names are watched (research/delegate read-only surface). */
44
+ tools?: readonly string[];
45
+ }
46
+
24
47
  export interface SpawnPiAgentOptions {
25
48
  model: string;
26
49
  tools: string;
27
50
  thinking: string;
28
51
  appendSystemPrompt: string;
29
52
  sessionFile: string;
30
- /** Pass `-c` so the child resumes sessionFile instead of starting fresh. */
31
53
  resume?: boolean;
32
54
  prompt: string;
33
- /** `-e` extension paths, in order (damage-control first). */
34
55
  extensions?: string[];
35
- /** Extra env on top of process.env (e.g. AGENT_HUB_DELEGATE_CONFIG). */
36
56
  env?: Record<string, string>;
37
- /**
38
- * Spawn the child as its own process group leader (setsid). The kill
39
- * cascade relies on this: delegate children spawned INSIDE the child
40
- * inherit its group, so signalling the negative PID kills the whole tree.
41
- */
57
+ /** Own a process group. Required for a watchdog/cancellation kill cascade. */
42
58
  detached?: boolean;
43
59
  cwd?: string;
60
+ /** Parent tool cancellation; classified separately from a tool timeout. */
61
+ signal?: AbortSignal;
62
+ toolWatchdog?: ToolWatchdogOptions;
63
+ /**
64
+ * Whole-run deadline: one timer from spawn start; on expiry the child group is
65
+ * terminated with reason "turn_timeout" (same SIGTERM→SIGKILL→settle cascade as
66
+ * the per-tool watchdog). null/undefined disables it. Unlike the tool watchdog
67
+ * this bounds the ENTIRE run, thinking and non-watched tools included.
68
+ */
69
+ turnDeadlineMs?: number | null;
44
70
  }
45
71
 
46
72
  export interface SpawnPiAgentCallbacks {
47
- /** Fires immediately after spawn so the caller can store the proc for kill. */
48
73
  onProcess?(proc: ChildProcess): void;
74
+ /** Receives a terminate handle for parent-side classified stops (drift watchdog). */
75
+ onControl?(control: PiRunControl): void;
49
76
  onTextDelta?(delta: string): void;
50
77
  onThinkingDelta?(delta: string): void;
51
- onToolStart?(toolName: string, argStr: string): void;
52
- /**
53
- * Usage from the stream: per assistant message (`message_end`) and once at
54
- * the end with the final assistant message (`agent_end`).
55
- */
78
+ onToolStart?(toolName: string, argStr: string, toolCallId?: string): void;
79
+ /** isError is present only when the event stream carries an error flag. */
80
+ onToolEnd?(toolName: string, toolCallId?: string, isError?: boolean): void;
56
81
  onUsage?(usage: PiUsage, source: "message_end" | "agent_end"): void;
57
82
  }
58
83
 
59
84
  export interface SpawnPiAgentResult {
60
- /** Concatenated assistant text deltas. */
61
85
  output: string;
62
- /** Process exit code; null when the child died from a signal (e.g. SIGTERM). */
63
86
  exitCode: number | null;
64
87
  stderr: string;
65
- /** Set when the process could not be spawned at all (proc `error` event). */
66
88
  spawnError?: string;
89
+ /** Present only when parent-side bounded termination was requested. */
90
+ termination?: Termination;
91
+ }
92
+
93
+ const DEFAULT_TERM_GRACE_MS = 1_000;
94
+ const DEFAULT_SETTLE_GRACE_MS = 1_000;
95
+ const WATCHED_TOOLS = new Set(["read", "grep", "find", "ls"]);
96
+
97
+ /** Signal an explicitly owned process group, falling back only for legacy callers. */
98
+ export function killPiTree(proc: ChildProcess, signal: NodeJS.Signals = "SIGTERM"): void {
99
+ const pid = proc.pid;
100
+ if (pid == null) return;
101
+ try {
102
+ process.kill(-pid, signal);
103
+ } catch {
104
+ try { proc.kill(signal); } catch {}
105
+ }
67
106
  }
68
107
 
69
108
  export function spawnPiAgent(
@@ -71,54 +110,119 @@ export function spawnPiAgent(
71
110
  cbs: SpawnPiAgentCallbacks = {},
72
111
  ): Promise<SpawnPiAgentResult> {
73
112
  const args = [
74
- "--mode", "json",
75
- "-p",
76
- "--no-extensions",
113
+ "--mode", "json", "-p", "--no-extensions",
77
114
  ...(opts.extensions || []).flatMap(e => ["-e", e]),
78
- "--model", opts.model,
79
- "--tools", opts.tools,
80
- "--thinking", opts.thinking,
81
- "--append-system-prompt", opts.appendSystemPrompt,
82
- "--session", opts.sessionFile,
115
+ "--model", opts.model, "--tools", opts.tools, "--thinking", opts.thinking,
116
+ "--append-system-prompt", opts.appendSystemPrompt, "--session", opts.sessionFile,
83
117
  ];
84
118
  if (opts.resume) args.push("-c");
85
119
 
120
+ const watchdog = opts.toolWatchdog;
121
+ const turnDeadlineMs = opts.turnDeadlineMs ?? null;
122
+ // A watchdog or deadline must own its group: group signalling remains valid even
123
+ // after the pi leader exits while an inherited-stdio descendant is still alive.
124
+ const ownsGroup = opts.detached === true || watchdog !== undefined || opts.signal !== undefined || turnDeadlineMs != null || cbs.onControl !== undefined;
125
+ const watchedTools = new Set(watchdog?.tools ?? WATCHED_TOOLS);
126
+ const timeoutMs = watchdog?.timeoutMs ?? null;
127
+ const termGraceMs = watchdog?.termGraceMs ?? DEFAULT_TERM_GRACE_MS;
128
+ const settleGraceMs = watchdog?.settleGraceMs ?? DEFAULT_SETTLE_GRACE_MS;
129
+
86
130
  const textChunks: string[] = [];
87
131
  const stderrChunks: string[] = [];
88
-
89
132
  return new Promise((resolve) => {
90
133
  const proc = spawn("pi", args, {
91
- // pi's CLI does not accept a standalone `--` option separator, so pass
92
- // the prompt through stdin. Print mode documents stdin as prompt input,
93
- // and this keeps prompts that start with `-` from being parsed as flags.
94
134
  stdio: ["pipe", "pipe", "pipe"],
95
135
  env: { ...process.env, ...(opts.env || {}) },
96
136
  ...(opts.cwd ? { cwd: opts.cwd } : {}),
97
- ...(opts.detached ? { detached: true } : {}),
137
+ ...(ownsGroup ? { detached: true } : {}),
98
138
  });
99
139
  cbs.onProcess?.(proc);
100
140
  proc.stdin?.on("error", () => {});
101
141
  proc.stdin?.end(opts.prompt);
102
142
 
103
143
  let buffer = "";
144
+ let settled = false;
145
+ let closeSeen = false;
146
+ let termination: Termination | undefined;
147
+ let termTimer: ReturnType<typeof setTimeout> | undefined;
148
+ let settleTimer: ReturnType<typeof setTimeout> | undefined;
149
+ let deadlineTimer: ReturnType<typeof setTimeout> | undefined;
150
+ const calls = new Map<string, ToolTimeout & { timer: ReturnType<typeof setTimeout> }>();
151
+
152
+ const clearCalls = () => {
153
+ for (const call of calls.values()) clearTimeout(call.timer);
154
+ calls.clear();
155
+ };
156
+ const cleanup = () => {
157
+ clearCalls();
158
+ if (termTimer) clearTimeout(termTimer);
159
+ if (settleTimer) clearTimeout(settleTimer);
160
+ if (deadlineTimer) clearTimeout(deadlineTimer);
161
+ opts.signal?.removeEventListener("abort", onAbort);
162
+ };
163
+ const settle = (code: number | null, spawnError?: string) => {
164
+ if (settled) return;
165
+ settled = true;
166
+ cleanup();
167
+ if (termination) termination.confirmed = closeSeen;
168
+ // A pipe held by a descendant must not hold the caller forever.
169
+ try { proc.stdin?.destroy(); } catch {}
170
+ try { proc.stdout?.destroy(); } catch {}
171
+ try { proc.stderr?.destroy(); } catch {}
172
+ resolve({ output: textChunks.join(""), exitCode: code, stderr: stderrChunks.join(""), ...(spawnError ? { spawnError } : {}), ...(termination ? { termination } : {}) });
173
+ };
174
+ const terminate = (reason: Termination["reason"], tool?: ToolTimeout) => {
175
+ // The first classification wins; later cancellation/exit events keep it.
176
+ if (termination) return;
177
+ termination = { reason, confirmed: false, escalated: false, ...(tool ? { tool } : {}) };
178
+ clearCalls();
179
+ killPiTree(proc, "SIGTERM");
180
+ termTimer = setTimeout(() => {
181
+ if (settled) return;
182
+ termination!.escalated = true;
183
+ killPiTree(proc, "SIGKILL");
184
+ }, termGraceMs);
185
+ settleTimer = setTimeout(() => settle(null), termGraceMs + settleGraceMs);
186
+ };
187
+ const onAbort = () => terminate("cancelled");
188
+ if (opts.signal?.aborted) onAbort();
189
+ else opts.signal?.addEventListener("abort", onAbort, { once: true });
190
+ // External classified stop (drift watchdog): same first-classification-wins
191
+ // cascade as every other termination path; harmless after settle.
192
+ cbs.onControl?.({ terminate: (reason = "drift_stop") => { if (!settled) terminate(reason); } });
193
+ if (turnDeadlineMs != null) {
194
+ deadlineTimer = setTimeout(() => terminate("turn_timeout"), turnDeadlineMs);
195
+ }
196
+
197
+ const toolId = (event: any) => String(event.toolCallId ?? event.tool_call_id ?? event.id ?? "");
104
198
  const handleEvent = (event: any) => {
105
199
  if (event.type === "message_update") {
106
200
  const delta = event.assistantMessageEvent;
107
- if (delta?.type === "text_delta") {
108
- textChunks.push(delta.delta || "");
109
- cbs.onTextDelta?.(delta.delta || "");
110
- } else if (delta?.type === "thinking_delta") {
111
- cbs.onThinkingDelta?.(delta.delta || "");
112
- }
201
+ if (delta?.type === "text_delta") { textChunks.push(delta.delta || ""); cbs.onTextDelta?.(delta.delta || ""); }
202
+ else if (delta?.type === "thinking_delta") cbs.onThinkingDelta?.(delta.delta || "");
113
203
  } else if (event.type === "tool_execution_start") {
114
204
  let argStr = "";
115
- try { argStr = event.args != null ? JSON.stringify(event.args) : ""; } catch { argStr = ""; }
116
- cbs.onToolStart?.(event.toolName || "tool", argStr);
205
+ try { argStr = event.args != null ? JSON.stringify(event.args) : ""; } catch {}
206
+ const id = toolId(event);
207
+ const name = event.toolName || "tool";
208
+ cbs.onToolStart?.(name, argStr, id || undefined);
209
+ if (timeoutMs != null && id && watchedTools.has(name) && !calls.has(id)) {
210
+ const startedAt = Date.now();
211
+ const call: ToolTimeout = { toolCallId: id, toolName: name, args: argStr, startedAt, deadlineAt: startedAt + timeoutMs };
212
+ calls.set(id, { ...call, timer: setTimeout(() => terminate("tool_timeout", call), timeoutMs) });
213
+ }
214
+ } else if (event.type === "tool_execution_end") {
215
+ const id = toolId(event);
216
+ if (id) {
217
+ const call = calls.get(id);
218
+ if (call) { clearTimeout(call.timer); calls.delete(id); }
219
+ }
220
+ const rawIsError = event.isError ?? event.is_error ?? event.result?.isError ?? event.result?.is_error;
221
+ cbs.onToolEnd?.(event.toolName || "tool", id || undefined, typeof rawIsError === "boolean" ? rawIsError : undefined);
117
222
  } else if (event.type === "message_end") {
118
223
  if (event.message?.usage) cbs.onUsage?.(event.message.usage, "message_end");
119
224
  } else if (event.type === "agent_end") {
120
- const msgs = event.messages || [];
121
- const last = [...msgs].reverse().find((m: any) => m.role === "assistant");
225
+ const last = [...(event.messages || [])].reverse().find((m: any) => m.role === "assistant");
122
226
  if (last?.usage) cbs.onUsage?.(last.usage, "agent_end");
123
227
  }
124
228
  };
@@ -128,52 +232,15 @@ export function spawnPiAgent(
128
232
  buffer += chunk;
129
233
  const lines = buffer.split("\n");
130
234
  buffer = lines.pop() || "";
131
- for (const line of lines) {
132
- if (!line.trim()) continue;
133
- try { handleEvent(JSON.parse(line)); } catch {}
134
- }
235
+ for (const line of lines) { if (line.trim()) try { handleEvent(JSON.parse(line)); } catch {} }
135
236
  });
136
-
137
237
  proc.stderr!.setEncoding("utf-8");
138
- proc.stderr!.on("data", (chunk: string) => {
139
- stderrChunks.push(chunk);
140
- });
141
-
238
+ proc.stderr!.on("data", (chunk: string) => stderrChunks.push(chunk));
142
239
  proc.on("close", (code) => {
143
- if (buffer.trim()) {
144
- try { handleEvent(JSON.parse(buffer)); } catch {}
145
- }
146
- resolve({
147
- output: textChunks.join(""),
148
- exitCode: code,
149
- stderr: stderrChunks.join(""),
150
- });
151
- });
152
-
153
- proc.on("error", (err) => {
154
- resolve({
155
- output: "",
156
- exitCode: 1,
157
- stderr: stderrChunks.join(""),
158
- spawnError: err.message,
159
- });
240
+ closeSeen = true;
241
+ if (buffer.trim()) try { handleEvent(JSON.parse(buffer)); } catch {}
242
+ settle(code);
160
243
  });
244
+ proc.on("error", (err) => settle(1, err.message));
161
245
  });
162
246
  }
163
-
164
- /**
165
- * Kill a spawned pi child and — when it was spawned `detached` — its whole
166
- * process group, so delegate children and grandchildren die with their parent.
167
- * For a non-detached child the group kill fails with ESRCH (its pgid is the
168
- * hub's, not its own pid) and we fall back to a single-process SIGTERM, which
169
- * matches the pre-cascade behavior.
170
- */
171
- export function killPiTree(proc: ChildProcess, signal: NodeJS.Signals = "SIGTERM"): void {
172
- const pid = proc.pid;
173
- if (pid == null) return;
174
- try {
175
- process.kill(-pid, signal);
176
- } catch {
177
- try { proc.kill(signal); } catch {}
178
- }
179
- }
@@ -0,0 +1,18 @@
1
+ import { readFileSync } from "node:fs";
2
+
3
+ export const VERSION_STATUS_KEY = "00-agent-fleet-version";
4
+
5
+ function readAdjacentVersion(): string | null {
6
+ try {
7
+ const manifest = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
8
+ return typeof manifest.version === "string" && manifest.version.length > 0 ? manifest.version : null;
9
+ } catch {
10
+ return null;
11
+ }
12
+ }
13
+
14
+ export const HARNESS_VERSION = readAdjacentVersion();
15
+
16
+ export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
17
+ if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, `v${HARNESS_VERSION}`);
18
+ }
@@ -6,6 +6,7 @@ The experimental Codex Remote-Control conductor is **not** an inbound `ask_user`
6
6
 
7
7
  - The stock `pi-ask-user` extension is loaded through a capture proxy; its `ask_user` tool is not registered directly.
8
8
  - If no live `user-remote` peer is present at call time, the wrapper calls stock `execute` with the original arguments and signal unchanged.
9
+ - Remote lookup follows the explicit Pi `--project <name>` flag at tool-execution time (then `pi.getFlag`, `PI_COMS_PROJECT`, and finally `default`), so a hub and bridge in the same non-default pool can race correctly even though Pi finishes CLI parsing after extension factories load.
9
10
  - If `user-remote` is present, the wrapper races local stock UI against the remote coms request using `race-core.js`; first answer wins and local-first emits one best-effort cancel.
10
11
  - If another extension already registered `ask_user`, registration failure is caught and logged as a warning instead of crashing the session.
11
12
 
@@ -8,6 +8,7 @@
8
8
  import * as fs from "node:fs";
9
9
  import * as os from "node:os";
10
10
  import * as path from "node:path";
11
+ import { fileURLToPath, pathToFileURL } from "node:url";
11
12
 
12
13
  import { raceAskUser } from "./race-core.js";
13
14
 
@@ -29,6 +30,7 @@ interface InstallOptions {
29
30
  warn?: (message: string) => void;
30
31
  createAbortController?: () => AbortController;
31
32
  settingsPaths?: string[];
33
+ remoteProject?: string | (() => string);
32
34
  }
33
35
 
34
36
  // A stock `pi-ask-user` package listed in pi settings is loaded by pi core
@@ -99,6 +101,20 @@ function warn(pi: ExtensionLike, options: InstallOptions, message: string): void
99
101
  console.warn(message);
100
102
  }
101
103
 
104
+ export function resolveRemoteProject(pi: ExtensionLike, argv: string[] = process.argv): string {
105
+ for (let i = argv.length - 2; i >= 0; i--) {
106
+ if (argv[i] === "--project" && typeof argv[i + 1] === "string" && argv[i + 1].trim()) {
107
+ return argv[i + 1].trim();
108
+ }
109
+ }
110
+ const inlineProject = [...argv].reverse().find((arg) => arg.startsWith("--project="))?.slice("--project=".length).trim();
111
+ if (inlineProject) return inlineProject;
112
+ const cliProject = typeof pi.getFlag === "function" ? pi.getFlag("project") : undefined;
113
+ if (typeof cliProject === "string" && cliProject.trim()) return cliProject.trim();
114
+ const envProject = process.env.PI_COMS_PROJECT;
115
+ return envProject?.trim() || "default";
116
+ }
117
+
102
118
  function linkAbortSignal(parent: AbortSignal | undefined, child: AbortController): void {
103
119
  if (!parent) return;
104
120
  if (parent.aborted) {
@@ -151,9 +167,8 @@ export function activeRemoteCount(): number {
151
167
  return activeRemote.size;
152
168
  }
153
169
 
154
- async function defaultStartRemote(params: any): Promise<{ qid: string; result: Promise<any> } | null> {
170
+ async function defaultStartRemote(params: any, project: string): Promise<{ qid: string; result: Promise<any> } | null> {
155
171
  const coms = await import("../../../scripts/lib/coms-envelope.ts");
156
- const project = process.env.PI_COMS_PROJECT || "default";
157
172
  const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
158
173
  const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
159
174
  if (!peer) return null;
@@ -209,10 +224,9 @@ async function defaultStartRemote(params: any): Promise<{ qid: string; result: P
209
224
  return { qid: env.msg_id, result };
210
225
  }
211
226
 
212
- async function defaultCancelRemote(qid: string, reason: string): Promise<void> {
227
+ async function defaultCancelRemote(qid: string, reason: string, project: string): Promise<void> {
213
228
  try {
214
229
  const coms = await import("../../../scripts/lib/coms-envelope.ts");
215
- const project = process.env.PI_COMS_PROJECT || "default";
216
230
  const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
217
231
  const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
218
232
  if (peer) {
@@ -233,7 +247,9 @@ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOpt
233
247
  return {
234
248
  ...stockTool,
235
249
  async execute(toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: any, ctx?: any) {
236
- const startRemote = options.startRemote ?? defaultStartRemote;
250
+ const configuredProject = typeof options.remoteProject === "function" ? options.remoteProject() : options.remoteProject;
251
+ const remoteProject = configuredProject ?? process.env.PI_COMS_PROJECT?.trim() ?? "default";
252
+ const startRemote = options.startRemote ?? ((remoteParams: any) => defaultStartRemote(remoteParams, remoteProject));
237
253
  let remoteStart: { qid: string; result: Promise<any> } | null = null;
238
254
  try {
239
255
  remoteStart = await startRemote(params, ctx);
@@ -248,7 +264,7 @@ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOpt
248
264
  return await raceAskUser({
249
265
  runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, params, localSignal, onUpdate, ctx),
250
266
  startRemote: () => remoteStart,
251
- cancelRemote: options.cancelRemote ?? defaultCancelRemote,
267
+ cancelRemote: options.cancelRemote ?? ((qid: string, reason: string) => defaultCancelRemote(qid, reason, remoteProject)),
252
268
  createAbortController: () => {
253
269
  const controller = options.createAbortController?.() ?? new AbortController();
254
270
  linkAbortSignal(signal, controller);
@@ -270,7 +286,10 @@ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions
270
286
  }
271
287
  if (!options.stockFactory) throw new Error("ask-user-remote: stockFactory is required for synchronous install");
272
288
  const stockTool = captureAskUserTool(options.stockFactory, pi);
273
- const wrapped = wrapAskUserTool(stockTool, options);
289
+ const wrapped = wrapAskUserTool(stockTool, {
290
+ ...options,
291
+ remoteProject: options.remoteProject ?? (() => resolveRemoteProject(pi)),
292
+ });
274
293
  try {
275
294
  pi.registerTool(wrapped);
276
295
  return { registered: true, tool: wrapped };
@@ -281,8 +300,17 @@ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions
281
300
  }
282
301
  }
283
302
 
303
+ export function resolveStockAskUserModule(moduleUrl: string = import.meta.url): string {
304
+ // Pi's jiti loader preserves the workspace-facing path of a symlinked
305
+ // harness. Canonicalize this module first so the bundled dependency is
306
+ // resolved beside the actual Agent Fleet package, not at workspace root.
307
+ const realModulePath = fs.realpathSync(fileURLToPath(moduleUrl));
308
+ const stockModulePath = path.resolve(path.dirname(realModulePath), "../../../node_modules/pi-ask-user/index.ts");
309
+ return pathToFileURL(stockModulePath).href;
310
+ }
311
+
284
312
  async function loadStockFactory(): Promise<(pi: ExtensionLike) => void> {
285
- const mod = await import("../../../node_modules/pi-ask-user/index.ts");
313
+ const mod = await import(resolveStockAskUserModule());
286
314
  return mod.default as (pi: ExtensionLike) => void;
287
315
  }
288
316
 
@@ -13,6 +13,16 @@ peers through per-project registry files under `~/.pi/coms/projects/<project>/ag
13
13
  Surfaces a live "pool" widget of connected peers, with ping and keepalive cycles and a
14
14
  clean shutdown lifecycle.
15
15
 
16
+ ## Version footer and provenance
17
+
18
+ This persistent-UI harness shows `v<version>` below the prompt. It shares one common-key
19
+ status with `agent-hub` and `damage-control-continue`, so a stack renders the
20
+ version once. The root `package.json` is canonical; `bin/sync-harness-versions.js` synchronizes
21
+ its value into this adjacent manifest. The local `version.ts` reader is retained so a copied or
22
+ symlinked harness resolves its own adjacent stamp, not the launch directory. That provenance
23
+ pair does not carry dependencies: copy/symlink targets still require the existing full
24
+ `.pi/harnesses/` dependency installation.
25
+
16
26
  ## Presence backends: herdr vs files
17
27
 
18
28
  Presence (who's alive, what state they're in) is pluggable; the **envelope transport,
@@ -70,11 +80,11 @@ Nothing in-repo — the peer registry lives at `~/.pi/coms/` and is created at r
70
80
  pi -e .pi/harnesses/coms/index.ts
71
81
  ```
72
82
 
73
- For a guarded coms node that also keeps every auto-discovered local extension (MCP bridges,
74
- project-specific extensions) and command, use the `just safe-coms <name>` recipe — it loads
75
- `damage-control-continue` + `coms` *on top of* normal extension discovery (no `--no-extensions`), so the
76
- local-only tools stay scoped to that dispatcher process and never leak into the `--no-extensions`
77
- specialists an `agent-hub` session spawns.
83
+ For a guarded coms node, use `just fleet peer <name>`. It loads Fleet Core plus `coms`
84
+ with deterministic extension discovery. Add `--browser` for Chrome DevTools or
85
+ `--all-extensions` when the peer intentionally needs arbitrary project/global extensions;
86
+ those tools stay scoped to that process and never leak into Agent Hub's
87
+ `--no-extensions` specialists.
78
88
 
79
89
  ## Upstream changes
80
90
 
@@ -23,6 +23,7 @@ import * as fs from "node:fs";
23
23
  import * as path from "node:path";
24
24
  import * as os from "node:os";
25
25
  import * as crypto from "node:crypto";
26
+ import { registerVersionStatus } from "./version.ts";
26
27
 
27
28
  import {
28
29
  formatPeerStatus,
@@ -783,6 +784,7 @@ export default function (pi: ExtensionAPI) {
783
784
 
784
785
  // ━━ session_start ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
785
786
  pi.on("session_start", async (_event, ctx) => {
787
+ registerVersionStatus(ctx);
786
788
  currentCtx = ctx;
787
789
 
788
790
  // 1. Resolve identity from CLI flags > frontmatter > defaults.
@@ -1,6 +1,7 @@
1
1
  {
2
- "name": "agent-fleet-pi-coms",
3
- "private": true,
4
- "type": "module",
5
- "main": "index.ts"
2
+ "name": "agent-fleet-pi-coms",
3
+ "private": true,
4
+ "type": "module",
5
+ "main": "index.ts",
6
+ "version": "0.0.5"
6
7
  }
@@ -0,0 +1,18 @@
1
+ import { readFileSync } from "node:fs";
2
+
3
+ export const VERSION_STATUS_KEY = "00-agent-fleet-version";
4
+
5
+ function readAdjacentVersion(): string | null {
6
+ try {
7
+ const manifest = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
8
+ return typeof manifest.version === "string" && manifest.version.length > 0 ? manifest.version : null;
9
+ } catch {
10
+ return null;
11
+ }
12
+ }
13
+
14
+ export const HARNESS_VERSION = readAdjacentVersion();
15
+
16
+ export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
17
+ if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, `v${HARNESS_VERSION}`);
18
+ }