@chankov/agent-fleet 0.0.3 → 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 (329) hide show
  1. package/.claude/commands/setup-agent-fleet.md +1 -1
  2. package/.opencode/commands/af-setup-agent-fleet.md +1 -1
  3. package/.pi/harnesses/agent-hub/README.md +199 -16
  4. package/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  5. package/.pi/harnesses/agent-hub/delegate.ts +32 -9
  6. package/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  7. package/.pi/harnesses/agent-hub/footer.ts +29 -0
  8. package/.pi/harnesses/agent-hub/helpers.ts +49 -0
  9. package/.pi/harnesses/agent-hub/index.ts +1033 -242
  10. package/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  11. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  12. package/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  13. package/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  14. package/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  15. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  16. package/.pi/harnesses/agent-hub/package.json +5 -4
  17. package/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  18. package/.pi/harnesses/agent-hub/run-budget.js +155 -0
  19. package/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  20. package/.pi/harnesses/agent-hub/spawn.ts +161 -94
  21. package/.pi/harnesses/agent-hub/version.ts +18 -0
  22. package/.pi/harnesses/coms/README.md +10 -0
  23. package/.pi/harnesses/coms/index.ts +2 -0
  24. package/.pi/harnesses/coms/package.json +5 -4
  25. package/.pi/harnesses/coms/version.ts +18 -0
  26. package/.pi/harnesses/damage-control-continue/README.md +32 -31
  27. package/.pi/harnesses/damage-control-continue/index.ts +23 -9
  28. package/.pi/harnesses/damage-control-continue/package.json +5 -4
  29. package/.pi/harnesses/damage-control-continue/version.ts +18 -0
  30. package/.pi/harnesses/{damage-control/shared.ts → lib/damage-control-shared.ts} +20 -6
  31. package/.pi/prompts/setup-agent-fleet.md +1 -1
  32. package/.versions/0.0.4/.claude/commands/build.md +44 -0
  33. package/.versions/0.0.4/.claude/commands/code-simplify.md +22 -0
  34. package/.versions/0.0.4/.claude/commands/design-agent.md +14 -0
  35. package/.versions/0.0.4/.claude/commands/doctor-agent-fleet.md +17 -0
  36. package/.versions/0.0.4/.claude/commands/orchestrate.md +112 -0
  37. package/.versions/0.0.4/.claude/commands/plan.md +16 -0
  38. package/.versions/0.0.4/.claude/commands/prime.md +22 -0
  39. package/.versions/0.0.4/.claude/commands/review.md +16 -0
  40. package/.versions/0.0.4/.claude/commands/setup-agent-fleet.md +25 -0
  41. package/.versions/0.0.4/.claude/commands/ship.md +72 -0
  42. package/.versions/0.0.4/.claude/commands/spec.md +15 -0
  43. package/.versions/0.0.4/.claude/commands/test.md +19 -0
  44. package/.versions/0.0.4/.claude/commands/webperf.md +32 -0
  45. package/.versions/0.0.4/.claude/orchestrate-teams.yaml +24 -0
  46. package/.versions/0.0.4/.opencode/commands/af-build.md +17 -0
  47. package/.versions/0.0.4/.opencode/commands/af-code-simplify.md +16 -0
  48. package/.versions/0.0.4/.opencode/commands/af-compound.md +16 -0
  49. package/.versions/0.0.4/.opencode/commands/af-design-agent.md +15 -0
  50. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  51. package/.versions/0.0.4/.opencode/commands/af-orchestrate.md +112 -0
  52. package/.versions/0.0.4/.opencode/commands/af-plan.md +16 -0
  53. package/.versions/0.0.4/.opencode/commands/af-prime.md +22 -0
  54. package/.versions/0.0.4/.opencode/commands/af-review.md +15 -0
  55. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +15 -0
  56. package/.versions/0.0.4/.opencode/commands/af-ship.md +16 -0
  57. package/.versions/0.0.4/.opencode/commands/af-spec.md +16 -0
  58. package/.versions/0.0.4/.opencode/commands/af-test.md +21 -0
  59. package/.versions/0.0.4/.opencode/commands/af-webperf.md +32 -0
  60. package/.versions/0.0.4/.opencode/orchestrate-teams.yaml +24 -0
  61. package/.versions/0.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  62. package/.versions/0.0.4/.pi/agents/model-profiles.yaml +20 -0
  63. package/.versions/0.0.4/.pi/agents/peers.yaml +146 -0
  64. package/.versions/0.0.4/.pi/agents/teams.yaml +39 -0
  65. package/.versions/0.0.4/.pi/damage-control-rules.yaml +297 -0
  66. package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  67. package/.versions/0.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  68. package/{.pi/harnesses/damage-control → .versions/0.0.4/.pi/extensions/agent-fleet-update-check}/package.json +1 -1
  69. package/.versions/0.0.4/.pi/extensions/btw/README.md +118 -0
  70. package/.versions/0.0.4/.pi/extensions/btw/index.ts +917 -0
  71. package/.versions/0.0.4/.pi/extensions/btw/package.json +6 -0
  72. package/.versions/0.0.4/.pi/extensions/btw/state.js +179 -0
  73. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  74. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  75. package/.versions/0.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  76. package/.versions/0.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  77. package/.versions/0.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  78. package/.versions/0.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  79. package/.versions/0.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  80. package/.versions/0.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  81. package/.versions/0.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  82. package/.versions/0.0.4/.pi/extensions/package-lock.json +1143 -0
  83. package/.versions/0.0.4/.pi/extensions/package.json +9 -0
  84. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/README.md +201 -0
  85. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  86. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  87. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  88. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  89. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  90. package/.versions/0.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  91. package/.versions/0.0.4/.pi/harnesses/agent-hub/README.md +798 -0
  92. package/.versions/0.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  93. package/.versions/0.0.4/.pi/harnesses/agent-hub/artifacts.js +92 -0
  94. package/.versions/0.0.4/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  95. package/.versions/0.0.4/.pi/harnesses/agent-hub/delegate.ts +386 -0
  96. package/.versions/0.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  97. package/.versions/0.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  98. package/.versions/0.0.4/.pi/harnesses/agent-hub/footer.ts +29 -0
  99. package/.versions/0.0.4/.pi/harnesses/agent-hub/helpers.ts +214 -0
  100. package/.versions/0.0.4/.pi/harnesses/agent-hub/index.ts +8045 -0
  101. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  102. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  103. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  104. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  105. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  106. package/.versions/0.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  107. package/.versions/0.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  108. package/.versions/0.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
  109. package/.versions/0.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  110. package/.versions/0.0.4/.pi/harnesses/agent-hub/return-contract.js +215 -0
  111. package/.versions/0.0.4/.pi/harnesses/agent-hub/run-budget.js +155 -0
  112. package/.versions/0.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  113. package/.versions/0.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  114. package/.versions/0.0.4/.pi/harnesses/agent-hub/spawn.ts +246 -0
  115. package/.versions/0.0.4/.pi/harnesses/agent-hub/version.ts +18 -0
  116. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/README.md +18 -0
  117. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/index.ts +293 -0
  118. package/.versions/0.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  119. package/.versions/0.0.4/.pi/harnesses/coms/README.md +92 -0
  120. package/.versions/0.0.4/.pi/harnesses/coms/index.ts +1745 -0
  121. package/.versions/0.0.4/.pi/harnesses/coms/package.json +7 -0
  122. package/.versions/0.0.4/.pi/harnesses/coms/version.ts +18 -0
  123. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/README.md +117 -0
  124. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  125. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  126. package/.versions/0.0.4/.pi/harnesses/damage-control-continue/version.ts +18 -0
  127. package/.versions/0.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  128. package/.versions/0.0.4/.pi/harnesses/lib/herdr-client.ts +458 -0
  129. package/.versions/0.0.4/.pi/harnesses/lib/herdr-presence.ts +288 -0
  130. package/.versions/0.0.4/.pi/harnesses/package-lock.json +35 -0
  131. package/.versions/0.0.4/.pi/harnesses/package.json +9 -0
  132. package/.versions/0.0.4/.pi/prompts/build.md +24 -0
  133. package/.versions/0.0.4/.pi/prompts/code-simplify.md +22 -0
  134. package/.versions/0.0.4/.pi/prompts/doctor-agent-fleet.md +15 -0
  135. package/.versions/0.0.4/.pi/prompts/plan.md +16 -0
  136. package/.versions/0.0.4/.pi/prompts/review.md +16 -0
  137. package/.versions/0.0.4/.pi/prompts/setup-agent-fleet.md +27 -0
  138. package/.versions/0.0.4/.pi/prompts/ship.md +17 -0
  139. package/.versions/0.0.4/.pi/prompts/spec.md +15 -0
  140. package/.versions/0.0.4/.pi/prompts/test.md +19 -0
  141. package/.versions/0.0.4/.pi/skills/bowser/SKILL.md +145 -0
  142. package/.versions/0.0.4/.version +1 -0
  143. package/.versions/0.0.4/agents/architect.md +23 -0
  144. package/.versions/0.0.4/agents/bowser.md +26 -0
  145. package/.versions/0.0.4/agents/builder.md +53 -0
  146. package/.versions/0.0.4/agents/code-reviewer.md +205 -0
  147. package/.versions/0.0.4/agents/deep-researcher.md +31 -0
  148. package/.versions/0.0.4/agents/documenter.md +18 -0
  149. package/.versions/0.0.4/agents/orchestrator.md +54 -0
  150. package/.versions/0.0.4/agents/plan-reviewer.md +60 -0
  151. package/.versions/0.0.4/agents/planner.md +69 -0
  152. package/.versions/0.0.4/agents/releaser.md +24 -0
  153. package/.versions/0.0.4/agents/researcher.md +28 -0
  154. package/.versions/0.0.4/agents/security-auditor.md +166 -0
  155. package/.versions/0.0.4/agents/test-engineer.md +151 -0
  156. package/.versions/0.0.4/agents/web-debugger.md +42 -0
  157. package/.versions/0.0.4/agents/web-performance-auditor.md +192 -0
  158. package/.versions/0.0.4/codex/CONDUCTOR.md +148 -0
  159. package/.versions/0.0.4/docs/ARCHITECTURE.md +210 -0
  160. package/.versions/0.0.4/docs/agent-fleet-setup.md +366 -0
  161. package/.versions/0.0.4/docs/claude-code-coms-bridge.md +103 -0
  162. package/.versions/0.0.4/docs/codex-remote-conductor.md +170 -0
  163. package/.versions/0.0.4/docs/coms-hermes-bridge.md +121 -0
  164. package/.versions/0.0.4/docs/getting-started.md +183 -0
  165. package/.versions/0.0.4/docs/npm-install.md +337 -0
  166. package/.versions/0.0.4/docs/opencode-setup.md +248 -0
  167. package/.versions/0.0.4/docs/pi-extensions.md +288 -0
  168. package/.versions/0.0.4/docs/pi-setup.md +463 -0
  169. package/.versions/0.0.4/docs/skill-anatomy.md +150 -0
  170. package/.versions/0.0.4/hermes/README.md +228 -0
  171. package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  172. package/.versions/0.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  173. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  174. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  175. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  176. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  177. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  178. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  179. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  180. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  181. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  182. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  183. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  184. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  185. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  186. package/.versions/0.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  187. package/.versions/0.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  188. package/.versions/0.0.4/hooks/SIMPLIFY-IGNORE.md +90 -0
  189. package/.versions/0.0.4/hooks/coms-stop-hook.mjs +73 -0
  190. package/.versions/0.0.4/hooks/hooks.json +14 -0
  191. package/.versions/0.0.4/hooks/session-start.sh +74 -0
  192. package/.versions/0.0.4/hooks/simplify-ignore.sh +302 -0
  193. package/.versions/0.0.4/justfile +256 -0
  194. package/.versions/0.0.4/references/accessibility-checklist.md +160 -0
  195. package/.versions/0.0.4/references/definition-of-done.md +67 -0
  196. package/.versions/0.0.4/references/fleet-coordination-patterns.md +151 -0
  197. package/.versions/0.0.4/references/observability-checklist.md +91 -0
  198. package/.versions/0.0.4/references/orchestration-patterns.md +370 -0
  199. package/.versions/0.0.4/references/performance-checklist.md +153 -0
  200. package/.versions/0.0.4/references/prompting-patterns.md +380 -0
  201. package/.versions/0.0.4/references/security-checklist.md +179 -0
  202. package/.versions/0.0.4/references/testing-patterns.md +236 -0
  203. package/.versions/0.0.4/scripts/codex-conductor.ts +41 -0
  204. package/.versions/0.0.4/scripts/codex-remote-control.ts +167 -0
  205. package/.versions/0.0.4/scripts/coms-claude-bridge.ts +286 -0
  206. package/.versions/0.0.4/scripts/coms-cli.ts +484 -0
  207. package/.versions/0.0.4/scripts/coms-hermes-bridge.ts +403 -0
  208. package/.versions/0.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  209. package/.versions/0.0.4/scripts/hermes-monitor-scenario.ts +7 -0
  210. package/.versions/0.0.4/scripts/lib/claude-bridge-core.ts +100 -0
  211. package/.versions/0.0.4/scripts/lib/codex-conductor.ts +88 -0
  212. package/.versions/0.0.4/scripts/lib/codex-remote-control.ts +480 -0
  213. package/.versions/0.0.4/scripts/lib/coms-envelope.ts +539 -0
  214. package/.versions/0.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  215. package/.versions/0.0.4/scripts/lib/herdr-layout.ts +263 -0
  216. package/.versions/0.0.4/scripts/lib/hermes-bridge-core.ts +238 -0
  217. package/.versions/0.0.4/scripts/lib/hermes-monitor-herdr.ts +28 -0
  218. package/.versions/0.0.4/scripts/lib/hermes-monitor-model.ts +9 -0
  219. package/.versions/0.0.4/scripts/lib/hermes-monitor-registry.ts +6 -0
  220. package/.versions/0.0.4/scripts/lib/hermes-monitor-socket.ts +118 -0
  221. package/.versions/0.0.4/scripts/lib/hermes-monitor-store.ts +31 -0
  222. package/.versions/0.0.4/scripts/lib/persona-banner.ts +62 -0
  223. package/.versions/0.0.4/scripts/lib/spawn-stagger.ts +101 -0
  224. package/.versions/0.0.4/scripts/lib/team-project.ts +184 -0
  225. package/.versions/0.0.4/scripts/lib/team-snapshot.ts +147 -0
  226. package/.versions/0.0.4/scripts/peer-banner.ts +40 -0
  227. package/.versions/0.0.4/scripts/team-snapshot.ts +238 -0
  228. package/.versions/0.0.4/scripts/team-up.ts +333 -0
  229. package/.versions/0.0.4/skills/_internal/grilling.md +11 -0
  230. package/.versions/0.0.4/skills/browser-testing-with-devtools/SKILL.md +352 -0
  231. package/.versions/0.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  232. package/.versions/0.0.4/skills/compound-learning/SKILL.md +137 -0
  233. package/.versions/0.0.4/skills/context-engineering/SKILL.md +291 -0
  234. package/.versions/0.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  235. package/.versions/0.0.4/skills/designing-agents/SKILL.md +394 -0
  236. package/.versions/0.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  237. package/.versions/0.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  238. package/.versions/0.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  239. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +535 -0
  240. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +33 -0
  241. package/.versions/0.0.4/skills/idea-refine/SKILL.md +182 -0
  242. package/.versions/0.0.4/skills/idea-refine/examples.md +238 -0
  243. package/.versions/0.0.4/skills/idea-refine/frameworks.md +99 -0
  244. package/.versions/0.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  245. package/.versions/0.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  246. package/.versions/0.0.4/skills/incremental-implementation/SKILL.md +287 -0
  247. package/.versions/0.0.4/skills/interview-me/SKILL.md +226 -0
  248. package/.versions/0.0.4/skills/orchestration-verification/SKILL.md +181 -0
  249. package/.versions/0.0.4/skills/peer-coms/SKILL.md +90 -0
  250. package/.versions/0.0.4/skills/performance-optimization/SKILL.md +350 -0
  251. package/.versions/0.0.4/skills/planning-and-task-breakdown/SKILL.md +236 -0
  252. package/.versions/0.0.4/skills/security-and-hardening/SKILL.md +461 -0
  253. package/.versions/0.0.4/skills/spec-driven-development/SKILL.md +245 -0
  254. package/.versions/0.0.4/skills/using-agent-skills/SKILL.md +199 -0
  255. package/.versions/0.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  256. package/.versions/0.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  257. package/.versions/0.0.4/vendor/agent-skills-upstream/README.md +11 -0
  258. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  259. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  260. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  261. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  262. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  263. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  264. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  265. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  266. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  267. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  268. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  269. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  270. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  271. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  272. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  273. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  274. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  275. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  276. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  277. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  278. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  279. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  280. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  281. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  282. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  283. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  284. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  285. package/.versions/0.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  286. package/CHANGELOG.md +53 -0
  287. package/README.md +3 -3
  288. package/agents/builder.md +1 -1
  289. package/agents/code-reviewer.md +1 -1
  290. package/agents/deep-researcher.md +3 -3
  291. package/agents/orchestrator.md +20 -11
  292. package/agents/plan-reviewer.md +3 -3
  293. package/agents/test-engineer.md +11 -4
  294. package/bin/lib/validate-overrides.js +19 -0
  295. package/bin/sync-harness-versions.js +94 -0
  296. package/docs/ARCHITECTURE.md +46 -1
  297. package/docs/agent-fleet-setup.md +10 -0
  298. package/docs/pi-extensions.md +49 -14
  299. package/docs/pi-setup.md +10 -4
  300. package/hermes/README.md +180 -0
  301. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  302. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  303. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  304. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  305. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  306. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  307. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  308. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  309. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  310. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  311. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  312. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  313. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  314. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  315. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  316. package/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  317. package/justfile +6 -10
  318. package/package.json +9 -4
  319. package/scripts/lib/fake-herdr-server.ts +88 -0
  320. package/scripts/lib/hermes-monitor-herdr.ts +28 -0
  321. package/scripts/lib/hermes-monitor-model.ts +9 -0
  322. package/scripts/lib/hermes-monitor-registry.ts +6 -0
  323. package/scripts/lib/hermes-monitor-socket.ts +118 -0
  324. package/scripts/lib/hermes-monitor-store.ts +31 -0
  325. package/skills/designing-agents/SKILL.md +2 -2
  326. package/skills/designing-agents/pi-harness-authoring.md +26 -13
  327. package/skills/guided-workspace-setup/SKILL.md +11 -8
  328. package/.pi/harnesses/damage-control/README.md +0 -65
  329. package/.pi/harnesses/damage-control/index.ts +0 -250
@@ -0,0 +1,302 @@
1
+ #!/bin/bash
2
+ # simplify-ignore.sh — Hook for Read (PreToolUse), Edit|Write (PostToolUse), Stop
3
+ #
4
+ # PreToolUse Read → backs up file, replaces blocks with BLOCK_<hash> in-place
5
+ # PostToolUse Edit → expands placeholders, re-filters so file stays hidden
6
+ # PostToolUse Write → expands placeholders, re-filters so file stays hidden
7
+ # Stop → restores real file content from backup
8
+ #
9
+ # The file on disk ALWAYS has placeholders while the session is active.
10
+ # The real content (with model's changes applied) lives in the backup.
11
+ #
12
+ # Dependencies: jq, shasum or sha1sum (auto-detected)
13
+
14
+ set -euo pipefail
15
+
16
+ if ! command -v jq >/dev/null 2>&1; then
17
+ printf '%s\n' "error: missing jq" >&2; exit 1
18
+ fi
19
+
20
+ CACHE="${CLAUDE_PROJECT_DIR:-.}/.claude/.simplify-ignore-cache"
21
+ if [ -t 0 ]; then INPUT="{}"; else INPUT=$(cat); fi
22
+
23
+ # Parse hook input — trap errors explicitly so set -e doesn't cause
24
+ # a silent exit on malformed JSON, and surface a useful diagnostic.
25
+ parse_error=""
26
+ TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null) || {
27
+ parse_error="failed to parse .tool_name from hook input"
28
+ TOOL_NAME=""
29
+ }
30
+ FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null) || {
31
+ parse_error="failed to parse .tool_input.file_path from hook input"
32
+ FILE_PATH=""
33
+ }
34
+ if [ -n "$parse_error" ]; then
35
+ printf 'Warning: %s (input: %.120s)\n' "$parse_error" "$INPUT" >&2
36
+ fi
37
+
38
+ hash_cmd() {
39
+ if command -v shasum >/dev/null 2>&1; then shasum
40
+ elif command -v sha1sum >/dev/null 2>&1; then sha1sum
41
+ else printf '%s\n' "error: missing shasum or sha1sum" >&2; exit 1; fi
42
+ }
43
+ file_id() { printf '%s' "$1" | hash_cmd | cut -c1-16; }
44
+ block_hash() { printf '%s' "$1" | hash_cmd | cut -c1-8; }
45
+ # Escape glob metacharacters so ${var/pattern/repl} treats pattern as literal.
46
+ # Needed for Bash 3.2 (macOS) where quotes don't suppress globbing in PE patterns.
47
+ escape_glob() {
48
+ local s="$1"
49
+ s="${s//\\/\\\\}"
50
+ s="${s//\*/\\*}"
51
+ s="${s//\?/\\?}"
52
+ s="${s//\[/\\[}"
53
+ printf '%s' "$s"
54
+ }
55
+
56
+ # ── filter_file: replace simplify-ignore blocks with BLOCK_<hash> placeholders ─
57
+ # Reads $1 (source), writes filtered version to $2 (dest), saves blocks to cache.
58
+ # Returns 0 if blocks were found, 1 if none.
59
+ filter_file() {
60
+ local src="$1" dest="$2" fid="$3"
61
+ : > "$dest"
62
+ rm -f "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
63
+
64
+ local count=0 in_block=0 buf="" reason="" prefix="" suffix=""
65
+
66
+ while IFS= read -r line || [ -n "$line" ]; do
67
+ # Check for start marker (no fork — uses bash case)
68
+ if [ $in_block -eq 0 ]; then
69
+ case "$line" in *simplify-ignore-start*)
70
+ in_block=1
71
+ buf="$line"
72
+ # Extract comment prefix/suffix to preserve language-appropriate syntax
73
+ prefix="${line%%simplify-ignore-start*}"
74
+ suffix=""
75
+ case "$line" in *'*/'*) suffix=" */" ;; *'-->'*) suffix=" -->" ;; esac
76
+ reason=$(printf '%s' "$line" | sed -n 's/.*simplify-ignore-start:[[:space:]]*//p' \
77
+ | sed 's/[[:space:]]*\*\/.*$//' | sed 's/[[:space:]]*-->.*$//' | sed 's/[[:space:]]*$//')
78
+ # Handle single-line block (start + end on same line)
79
+ case "$line" in *simplify-ignore-end*)
80
+ in_block=0
81
+ # Write single-line block immediately and skip to next line
82
+ # to avoid the end-marker check below firing again
83
+ local h; h=$(block_hash "$buf")
84
+ count=$((count + 1))
85
+ printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
86
+ [ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
87
+ printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
88
+ printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
89
+ if [ -n "$reason" ]; then
90
+ printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
91
+ else
92
+ printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
93
+ fi
94
+ buf=""; reason=""; prefix=""; suffix=""
95
+ continue
96
+ ;; *)
97
+ continue
98
+ ;;
99
+ esac
100
+ ;; esac
101
+ fi
102
+ # Accumulate block content
103
+ if [ $in_block -eq 1 ]; then
104
+ buf="${buf}
105
+ ${line}"
106
+ fi
107
+ # Check for end marker
108
+ case "$line" in *simplify-ignore-end*)
109
+ if [ $in_block -eq 1 ]; then
110
+ local h; h=$(block_hash "$buf")
111
+ count=$((count + 1))
112
+ printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
113
+ [ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
114
+ printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
115
+ printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
116
+ if [ -n "$reason" ]; then
117
+ printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
118
+ else
119
+ printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
120
+ fi
121
+ in_block=0; buf=""; reason=""; prefix=""; suffix=""
122
+ continue
123
+ fi
124
+ ;;
125
+ esac
126
+ [ $in_block -eq 0 ] && printf '%s\n' "$line" >> "$dest"
127
+ done < "$src"
128
+
129
+ # Unclosed block → flush as-is
130
+ if [ $in_block -eq 1 ] && [ -n "$buf" ]; then
131
+ printf 'Warning: unclosed simplify-ignore-start in %s (block not hidden)\n' "$src" >&2
132
+ printf '%s\n' "$buf" >> "$dest"
133
+ fi
134
+
135
+ # Preserve trailing newline status of source
136
+ if [ -s "$dest" ] && [ -s "$src" ] && [ -n "$(tail -c 1 "$src")" ]; then
137
+ perl -pe 'chomp if eof' "$dest" > "${dest}.nnl" && \
138
+ cat "${dest}.nnl" > "$dest" && rm -f "${dest}.nnl"
139
+ fi
140
+
141
+ [ $count -gt 0 ] && return 0 || return 1
142
+ }
143
+
144
+ # ── Stop: restore all files from backup ───────────────────────────────────────
145
+ if [ -z "$TOOL_NAME" ]; then
146
+ [ -d "$CACHE" ] || exit 0
147
+ for bak in "$CACHE"/*.bak; do
148
+ [ -f "$bak" ] || continue
149
+ fid="${bak##*/}"; fid="${fid%.bak}"
150
+ pathfile="$CACHE/${fid}.path"
151
+ [ -f "$pathfile" ] || { rm -f "$bak"; continue; }
152
+ orig=$(cat "$pathfile")
153
+ if [ -f "$orig" ]; then
154
+ cat "$bak" > "$orig"
155
+ rm -f "$bak" "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
156
+ rmdir "$CACHE/${fid}.lock" 2>/dev/null
157
+ else
158
+ # File was moved/deleted — save backup as .recovered, don't destroy it
159
+ mkdir -p "$(dirname "${orig}.recovered")"
160
+ mv "$bak" "${orig}.recovered"
161
+ rm -f "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
162
+ rmdir "$CACHE/${fid}.lock" 2>/dev/null
163
+ printf 'Warning: %s was moved/deleted. Recovered original to %s.recovered\n' "$orig" "$orig" >&2
164
+ fi
165
+ done
166
+ # Clean orphan locks (created but crash before backup)
167
+ for lockdir in "$CACHE"/*.lock; do
168
+ [ -d "$lockdir" ] || continue
169
+ rmdir "$lockdir" 2>/dev/null
170
+ done
171
+ exit 0
172
+ fi
173
+
174
+ [ -z "$FILE_PATH" ] && exit 0
175
+
176
+ # ── PreToolUse Read: filter in-place ──────────────────────────────────────────
177
+ if [ "$TOOL_NAME" = "Read" ]; then
178
+ [ -f "$FILE_PATH" ] || exit 0
179
+ case "$(basename "$FILE_PATH")" in simplify-ignore*|SIMPLIFY-IGNORE*) exit 0 ;; esac
180
+
181
+ mkdir -p "$CACHE"
182
+ ID=$(file_id "$FILE_PATH")
183
+
184
+ # If backup exists, file is already filtered — skip
185
+ [ -f "$CACHE/${ID}.bak" ] && exit 0
186
+
187
+ grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
188
+
189
+ # Atomic lock: mkdir fails if another session races us
190
+ if ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
191
+ # Lock exists — reclaim only if stale (>60s old, no backup = crash leftover)
192
+ if [ ! -f "$CACHE/${ID}.bak" ] && \
193
+ [ -n "$(find "$CACHE/${ID}.lock" -maxdepth 0 -mmin +1 2>/dev/null)" ]; then
194
+ rmdir "$CACHE/${ID}.lock" 2>/dev/null || true
195
+ mkdir "$CACHE/${ID}.lock" 2>/dev/null || exit 0
196
+ else
197
+ exit 0
198
+ fi
199
+ fi
200
+
201
+ # Back up the original (preserve trailing newline status)
202
+ cp -p "$FILE_PATH" "$CACHE/${ID}.bak" 2>/dev/null || cp "$FILE_PATH" "$CACHE/${ID}.bak"
203
+ printf '%s' "$FILE_PATH" > "$CACHE/${ID}.path"
204
+
205
+ # Filter in-place (cat > preserves inode and permissions)
206
+ FILTERED="$CACHE/${ID}.$$.tmp"
207
+ rm -f "$FILTERED"
208
+ if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
209
+ cat "$FILTERED" > "$FILE_PATH"
210
+ rm -f "$FILTERED"
211
+ else
212
+ rm -f "$FILTERED" "$CACHE/${ID}.bak" "$CACHE/${ID}.path"
213
+ rmdir "$CACHE/${ID}.lock" 2>/dev/null
214
+ fi
215
+ exit 0
216
+ fi
217
+
218
+ # ── PostToolUse Edit|Write: expand, then re-filter ────────────────────────────
219
+ if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "Write" ]; then
220
+ ID=$(file_id "$FILE_PATH")
221
+ [ -f "$CACHE/${ID}.bak" ] || exit 0
222
+ ls "$CACHE/${ID}".block.* >/dev/null 2>&1 || exit 0
223
+
224
+ # Expand placeholders, preserving any inline code the model added around them
225
+ EXPANDED="$CACHE/${ID}.$$.expanded"
226
+ rm -f "$EXPANDED"
227
+ while IFS= read -r line || [ -n "$line" ]; do
228
+ case "$line" in *BLOCK_*)
229
+ # Expand all placeholders on this line (supports multiple per line)
230
+ for bf in "$CACHE/${ID}".block.*; do
231
+ [ -f "$bf" ] || continue
232
+ h="${bf##*.}"
233
+ case "$line" in *"BLOCK_${h}"*)
234
+ # Reconstruct the exact placeholder pattern
235
+ bp=""; bs=""; br=""
236
+ [ -f "$CACHE/${ID}.prefix.${h}" ] && bp=$(cat "$CACHE/${ID}.prefix.${h}")
237
+ [ -f "$CACHE/${ID}.suffix.${h}" ] && bs=$(cat "$CACHE/${ID}.suffix.${h}")
238
+ [ -f "$CACHE/${ID}.reason.${h}" ] && br=$(cat "$CACHE/${ID}.reason.${h}")
239
+ if [ -n "$br" ]; then
240
+ placeholder="${bp}BLOCK_${h}: ${br}${bs}"
241
+ else
242
+ placeholder="${bp}BLOCK_${h}${bs}"
243
+ fi
244
+ block_content=$(cat "$bf"; printf x); block_content="${block_content%x}"
245
+ # Escape glob metacharacters (* ? [ \) in the pattern
246
+ esc_placeholder=$(escape_glob "$placeholder")
247
+ # Bash native substitution (// = global replace): replace placeholder, keep surrounding code
248
+ line="${line//$esc_placeholder/$block_content}"
249
+ # Fallback: if model altered the reason text, try without reason
250
+ # (only trigger if BLOCK_hash is still present AND wasn't in the original block content)
251
+ case "$block_content" in *"BLOCK_${h}"*) ;; *)
252
+ case "$line" in *"BLOCK_${h}"*)
253
+ printf 'Warning: placeholder BLOCK_%s was modified by model, using fuzzy match\n' "$h" >&2
254
+ esc_fuzzy=$(escape_glob "${bp}BLOCK_${h}${bs}")
255
+ line="${line//$esc_fuzzy/$block_content}"
256
+ # Last resort: match just the hash token
257
+ case "$line" in *"BLOCK_${h}"*)
258
+ line="${line//BLOCK_${h}/$block_content}"
259
+ ;; esac
260
+ ;; esac
261
+ ;; esac
262
+ ;; esac
263
+ done
264
+ ;; esac
265
+ printf '%s\n' "$line" >> "$EXPANDED"
266
+ done < "$FILE_PATH"
267
+ # Preserve trailing newline status
268
+ if [ -s "$EXPANDED" ] && [ -s "$FILE_PATH" ] && [ -n "$(tail -c 1 "$FILE_PATH")" ]; then
269
+ perl -pe 'chomp if eof' "$EXPANDED" > "${EXPANDED}.nnl" && \
270
+ cat "${EXPANDED}.nnl" > "$EXPANDED" && rm -f "${EXPANDED}.nnl"
271
+ fi
272
+ # Warn if model deleted a protected block entirely
273
+ for bf in "$CACHE/${ID}".block.*; do
274
+ [ -f "$bf" ] || continue
275
+ bh="${bf##*.}"
276
+ # After expansion, blocks appear as original code (simplify-ignore-start).
277
+ # If neither the expanded code nor the placeholder is in EXPANDED, it was deleted.
278
+ if ! grep -qF "BLOCK_${bh}" "$EXPANDED" 2>/dev/null; then
279
+ # Get first line of block to check if it was expanded back
280
+ first_line=$(head -1 "$bf")
281
+ if ! grep -qF "$first_line" "$EXPANDED" 2>/dev/null; then
282
+ printf 'Warning: protected block BLOCK_%s was deleted by model\n' "$bh" >&2
283
+ fi
284
+ fi
285
+ done
286
+ # Preserve inode and permissions
287
+ cat "$EXPANDED" > "$FILE_PATH"
288
+ rm -f "$EXPANDED"
289
+
290
+ # Save expanded version as new backup (this is the "real" file with model's changes)
291
+ cp "$FILE_PATH" "$CACHE/${ID}.bak"
292
+
293
+ # Re-filter in-place so the file on disk stays with placeholders
294
+ FILTERED="$CACHE/${ID}.$$.tmp"
295
+ rm -f "$FILTERED"
296
+ if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
297
+ cat "$FILTERED" > "$FILE_PATH"
298
+ rm -f "$FILTERED"
299
+ fi
300
+
301
+ exit 0
302
+ fi
@@ -0,0 +1,256 @@
1
+ # Justfile — pi extension harnesses
2
+ #
3
+ # Recipes to launch pi with the harness extensions under .pi/harnesses/.
4
+ # Ported and adapted from disler/pi-vs-claude-code (MIT) — https://github.com/disler/pi-vs-claude-code
5
+ # See docs/pi-extensions.md for the full catalog and the selective-load model.
6
+ #
7
+ # Why .pi/harnesses/ and not .pi/extensions/: pi auto-discovers EVERY directory
8
+ # under .pi/extensions/, so anything placed there loads on every plain `pi` run.
9
+ # Most harnesses are mutually exclusive — they live in .pi/harnesses/ (which pi
10
+ # does NOT auto-discover) and are loaded via `pi -e` below. The supported stack
11
+ # loads damage-control-continue before agent-hub, so hub sessions and all native
12
+ # children run with guardrails by default.
13
+ #
14
+ # Everything between the two `agent-fleet:harnesses` sentinels below is a
15
+ # MANAGED REGION: guided-workspace-setup regenerates it from the installed
16
+ # package whenever pi harnesses are installed, refreshed, or retired — so edits
17
+ # inside it are overwritten on upgrade. Put your own recipes OUTSIDE the
18
+ # sentinels (above the opening marker or below the closing one) to keep them.
19
+
20
+ # >>> agent-fleet:harnesses — managed region (regenerated on upgrade; edits inside are overwritten) >>>
21
+ set dotenv-load := true
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
+
31
+ # List all recipes
32
+ default:
33
+ @just --list
34
+
35
+ # ---------------------------------------------------------------- setup
36
+
37
+ # Install the shared runtime dependencies for the pi extensions + harnesses
38
+ install:
39
+ npm install --prefix .pi/extensions
40
+ npm install --prefix .pi/harnesses
41
+
42
+ # Default pi — only the always-on utilities auto-load, no harness
43
+ pi:
44
+ pi
45
+
46
+ # ---------------------------------------------------------------- safety
47
+
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.
50
+ ext-damage-control-continue:
51
+ pi -e .pi/harnesses/damage-control-continue/index.ts
52
+
53
+ # ---------------------------------------------------------------- orchestration
54
+
55
+ # Accepts coms identity flags: --name --purpose --project --color --explicit.
56
+ # Loads the orchestrator persona by default (the Verification-Contract dispatcher that owns
57
+ # the acceptance assertions — see skills/orchestration-verification); it is appended only if
58
+ # agents/orchestrator.md is installed, so the hub still launches when it is absent. Override
59
+ # with your own --system-prompt <persona>.md passed after `just hub`.
60
+ # Guarded agent hub: damage-control-continue + remote-capable ask_user + dispatcher grid + research helpers + embedded coms + orchestrator.
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.
63
+ hub *args:
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}}
65
+
66
+ # Agent hub (solo): guarded hub without the coms layer — fixed specialists + research only.
67
+ # Same orchestrator-persona default, remote-capable ask_user, and continue-guardrail main session as `just hub`.
68
+ hub-solo *args:
69
+ 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 --solo $persona {{args}}
70
+
71
+ # Internal helper for team-up: launch a reusable coms peer (coms + compact-and-continue + a persona).
72
+ # Prints a colored identity banner (peer name + persona purpose) before pi starts,
73
+ # so every pane announces who lives in it — works in any terminal, herdr or not.
74
+ # AGENT_FLEET_SPAWN_DELAY (set per pane by team-up when the stored pi OAuth token
75
+ # is stale) delays this pi's boot so a sibling pane can refresh the token first —
76
+ # simultaneous boots race on the auth.json lock and lose their logins.
77
+ # Hidden from `just --list` because recipes prefixed with `_` are private.
78
+ _peer persona name="" model="" session="" project="default":
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 { "" } }}
80
+
81
+ # Like _peer, but also loads extra always-on extensions (comma-separated names under
82
+ # .pi/extensions/) into the peer process — e.g. a chrome-devtools-mcp browser-debug peer
83
+ # whose `chrome_devtools__*` tools a normal --no-extensions subagent could not get.
84
+ _peer-plus extensions persona name="" model="" session="" project="default":
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 { "" } }}
86
+
87
+ # Internal helper for team-up: a `runner: claude-code` peer — interactive
88
+ # Claude Code plus its coms bridge (scripts/coms-claude-bridge.ts) in ONE pane.
89
+ # The bridge registers the pane as coms peer <name>; the trailing session
90
+ # positional maps to `claude --resume <id>` for team-resume.
91
+ _claude-peer name model="" session="" project="default":
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 { "" } }}
93
+
94
+ # The team recipes below take the team as a positional arg (defaults to "full")
95
+ # and pass everything after it straight to the script.
96
+ #
97
+ # Herdr workspace labels are auto-scoped to the CHECKOUT: <worktree-tag>-<mode>-<team>
98
+ # where the tag is the last dot-segment of this directory's basename (main.wt2 →
99
+ # wt2, ringithub.end2 → end2, plain agent-fleet → agent-fleet). So the same team
100
+ # launched from different repos/worktrees gets its own workspace (wt2-hub-plan vs
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.
105
+ #
106
+ # `--project <name>` is a SEPARATE axis: it scopes the coms peer POOL. Without it
107
+ # every peer lands in the shared "default" pool, where teams launched from OTHER
108
+ # repos collide (name suffixing like code-reviewer2, dispatches routed to the
109
+ # wrong repo's pane). IMPORTANT: the flag form is `--project af`; `project=af` is
110
+ # NOT a flag — just treats bare key=value args as variable overrides, so it is
111
+ # silently ignored and the team still joins the "default" pool.
112
+
113
+ # Team up: spawn every peer of a team from .pi/agents/peers.yaml into a herdr
114
+ # workspace (one tiled pane per peer). Requires a running herdr server.
115
+ # e.g. just team-up full
116
+ # just team-up review --project af
117
+ team-up team="full" *args:
118
+ {{node_ts}} scripts/team-up.ts --team {{team}} {{args}}
119
+
120
+ # Team up (dry run): print the resolved layout + per-peer commands without touching herdr.
121
+ # e.g. just team-up-dry full
122
+ # just team-up-dry review --project af
123
+ team-up-dry team="full" *args:
124
+ {{node_ts}} scripts/team-up.ts --team {{team}} --dry-run {{args}}
125
+
126
+ # Hub + team in ONE herdr workspace: the guarded hub (`just hub`) in a larger
127
+ # main pane, the team's peers tiled beside it.
128
+ # e.g. just hub-team docs
129
+ # just hub-team review --project af
130
+ hub-team team="full" *args:
131
+ {{node_ts}} scripts/team-up.ts --team {{team}} --hub {{args}}
132
+
133
+ # Hub + team (dry run): print the combined layout without touching herdr.
134
+ # e.g. just hub-team-dry review --project af
135
+ hub-team-dry team="full" *args:
136
+ {{node_ts}} scripts/team-up.ts --team {{team}} --hub --dry-run {{args}}
137
+
138
+ # Hermes conductor + team in ONE herdr workspace: Hermes dev profile in a conductor pane,
139
+ # the team's peers tiled beside it. Hermes delegates via coms-cli and never drives herdr.
140
+ # e.g. just conductor docs --project af
141
+ conductor team="full" *args:
142
+ {{node_ts}} scripts/team-up.ts --team {{team}} --conductor {{args}}
143
+
144
+ # Hermes conductor + team (dry run): print the combined layout without touching herdr.
145
+ # e.g. just conductor-dry docs --project af
146
+ conductor-dry team="full" *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}}
224
+
225
+ # Snapshot a RUNNING team's session refs to ~/.pi/team-snapshots/<team>.json
226
+ # (team keeps running — take one proactively so a crash is resumable).
227
+ # A team launched with --project must snapshot with the same --project.
228
+ # e.g. just team-snapshot review --project af
229
+ team-snapshot team="full" *args:
230
+ {{node_ts}} scripts/team-snapshot.ts snapshot {{team}} {{args}}
231
+
232
+ # Snapshot, then close the team workspace cleanly (peers get SIGTERM).
233
+ # e.g. just team-down review --project af
234
+ team-down team="full" *args:
235
+ {{node_ts}} scripts/team-snapshot.ts down {{team}} {{args}}
236
+
237
+ # Rebuild a team from its snapshot — each pi peer resumes its previous
238
+ # conversation (`pi --session <ref>`); peers whose ref is gone start fresh.
239
+ # e.g. just team-resume review --project af
240
+ team-resume team="full" *args:
241
+ {{node_ts}} scripts/team-snapshot.ts resume {{team}} {{args}}
242
+
243
+ # ---------------------------------------------------------------- coms (Pi-to-Pi messaging)
244
+
245
+ # Safe coms: a FULL pi (all auto-discovered local .pi/extensions/ + global extensions and
246
+ # commands) plus damage-control-continue guardrails and the coms peer layer, under a chosen name.
247
+ # Unlike `just hub`, this does NOT pass --no-extensions, so every local-only extension (MCP
248
+ # bridges like chrome-devtools-mcp, project-specific extensions, …) loads into THIS process.
249
+ # Use it as the agent-hub dispatcher/orchestrator peer that needs those local tools: spawned
250
+ # specialists run --no-extensions, so the tools stay scoped here and never leak into subagents.
251
+ # The required `name` becomes this peer's coms identity (--name), so it is discoverable
252
+ # under exactly that name to other coms peers in the project pool.
253
+ # e.g. just safe-coms orchestrator --project proj
254
+ safe-coms name *args:
255
+ pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/coms/index.ts --name {{name}} {{args}}
256
+ # <<< agent-fleet:harnesses <<<