@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,9 @@
1
+ import * as fs from "node:fs";
2
+ import { safeAgentKey } from "./helpers.ts";
3
+
4
+ export function monitorKeyForAgent(name:string,runCount:number){return`${safeAgentKey(name)}:${runCount}`;}
5
+ export function cancelLocalOwnedProcess(input:any){try{void Promise.resolve(input.monitorBridge?.markCancelling(input.monitorKey)).catch(()=>{});}catch{}input.treeKill(input.process);}
6
+ export async function cancelLocalWaitOnly(input:any){input.abort?.();try{await input.monitorBridge?.cancelWaitOnly(input.monitorKey,input.event);}catch{}}
7
+ export function linuxProcessIdentity(proc:any){try{if(!Number.isInteger(proc?.pid)||proc.pid<=0)return null;const stat=fs.readFileSync(`/proc/${proc.pid}/stat`,"utf8");const close=stat.lastIndexOf(")");const fields=stat.slice(close+2).trim().split(/\s+/);const starttime=fields[19];return starttime?{pid:proc.pid,starttime}:null;}catch{return null;}}
8
+ export function createOwnedHandleRegistry(deps:any={}) { const handles=new Map<string,any>(); const treeKill=deps.treeKill??((proc:any,signal:string)=>deps.signal?.(proc.pid,signal)), wait=deps.wait??(async()=>false), identity=deps.identity??linuxProcessIdentity; const graceMs=deps.graceMs??5000,setTimer=deps.setTimeout??setTimeout,clearTimer=deps.clearTimeout??clearTimeout;const observe=(p:any,exit:any)=>new Promise<boolean>(resolve=>{let done=false;let timer:any;const finish=(value:boolean)=>{if(done)return;done=true;if(timer!==undefined)clearTimer(timer);resolve(value);};timer=setTimer(()=>finish(false),graceMs);Promise.resolve(wait(p,exit)).then(value=>finish(!!value)).catch(()=>finish(false));});const same=(p:any,expected:any)=>{const current=identity(p);return !!current&&current.pid===expected.pid&&current.starttime===expected.starttime;}; return {register(v:any){const processIdentity=identity(v.process);const handle=`${v.profileKey}:${v.taskId}:${v.generation}`;handles.set(handle,{...v,processIdentity,cancelPromise:null});return handle},cancel(r:any){const v=handles.get(r.handle);if(!v)return Promise.resolve({cancelled:false,reason:"unauthorized"});if(v.profileKey!==r.profileKey||v.token!==r.token||v.taskId!==r.taskId)return Promise.resolve({cancelled:false,reason:"unauthorized"});if(v.generation!==r.generation)return Promise.resolve({cancelled:false,reason:"stale_generation"});if(v.cancelPromise)return v.cancelPromise;v.cancelPromise=(async()=>{const proc=v.process;if(!v.processIdentity||!same(proc,v.processIdentity))return{cancelled:false,reason:"stale_identity"};treeKill(proc,"SIGTERM");if(await observe(proc,v.exitPromise)){handles.delete(r.handle);return{cancelled:true,state:"cancelled"};}if(!same(proc,v.processIdentity))return{cancelled:false,reason:"stale_identity"};treeKill(proc,"SIGKILL");if(!(await observe(proc,v.exitPromise)))return{cancelled:false,reason:"exit_not_observed"};handles.delete(r.handle);return{cancelled:true,state:"cancelled"};})();return v.cancelPromise;}} }
9
+ export function recordWaitOnlyCancellation(r:any){return{state:"cancelled",history:r.lateEvent?[r.lateEvent]:[]}}
@@ -0,0 +1,13 @@
1
+ import * as path from "node:path";
2
+ import { MonitorSocketServer } from "../../../scripts/lib/hermes-monitor-socket.ts";
3
+ import { createOwnedHandleRegistry, recordWaitOnlyCancellation } from "./monitor-control.ts";
4
+ export interface MonitorLifecycleConfig { runtimeDir:string; profileId:string; profilePath:string; }
5
+ export function monitorLifecycleConfig(env:NodeJS.ProcessEnv):MonitorLifecycleConfig|null{const profileId=env.AGENT_FLEET_PROFILE_ID,runtimeDir=env.AGENT_FLEET_MONITOR_RUNTIME_DIR;if(!profileId||!runtimeDir||!path.isAbsolute(runtimeDir)||!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(profileId)||profileId.includes(".."))return null;return{runtimeDir,profileId,profilePath:path.join(runtimeDir,"profiles",profileId)};}
6
+ export function createMonitorLifecycle(deps:any){const control=createOwnedHandleRegistry(deps),handles=new Map<string,string>(),completedCancels=new Map<string,any>(),setTimer=deps.setInterval??setInterval,clearTimer=deps.clearInterval??clearInterval;let socket:MonitorSocketServer|null=null,registration:any=null,renewTimer:any=null,reconcileTimer:any=null,retryTimer:any=null,unavailable=false,bridgeRef:any=null,bridgeInput:any=null,epoch=0;const clearRenew=()=>{if(renewTimer!==null){clearTimer(renewTimer);renewTimer=null;}if(reconcileTimer!==null){clearTimer(reconcileTimer);reconcileTimer=null;}if(retryTimer!==null){(deps.clearTimeout??clearTimeout)(retryTimer);retryTimer=null;}};const cleanup=()=>{clearRenew();registration?.cleanup?.();registration=null;};const api:any={
7
+ async startBridge(bridge:any,input:any){const startEpoch=epoch;bridgeRef=bridge;bridgeInput=input;const value=await api.start({...input,snapshot:()=>{bridge.prune();return bridge.snapshot();},output:(request:any)=>bridge.readOutput(request)});if(!value||startEpoch!==epoch||bridgeRef!==bridge){if(value){try{await socket?.close();}catch{}value.cleanup?.();}return null;}bridge.setCurrentOwner?.({ownerSessionId:value.ownerId,ownerLeaseExpiresAt:value.leaseExpiresAt,updateActive:true});reconcileTimer=setTimer(()=>{const probeEpoch=epoch;const reconcile=(task:any,e:any)=>{if(probeEpoch!==epoch||bridgeRef!==bridge)return;bridge.reconcile({...e,taskId:`${task.id}:${task.generation}`});};try{for(const task of bridge.snapshot?.().tasks??[]){if(probeEpoch!==epoch||bridgeRef!==bridge)break;Promise.resolve(deps.getRecoveryEvidence?.(task)??deps.reconcileEvidence?.()??{}).then(e=>reconcile(task,e)).catch(()=>reconcile(task,{transient:true}));}}catch{if(probeEpoch===epoch&&bridgeRef===bridge)bridge.reconcile({transient:true});}},30_000);value.cancel=(request:any)=>bridge.cancelTask(request);return value;},
8
+ lowLevelCancelOwnedGeneration(request:any){return api.cancelOwnedGeneration(request);},
9
+ async start(input:any){const startEpoch=epoch;try{registration=deps.registry.register(input);registration.output=input.output;registration.cancel=(request:any)=>api.cancelOwnedGeneration(request);socket=(deps.createSocketServer??((r:any)=>new MonitorSocketServer(r)))(registration);await socket.listen();if(startEpoch!==epoch){try{await socket.close();}catch{}registration?.cleanup?.();registration=null;socket=null;return null;}if(registration.renew&&registration.leaseMs){renewTimer=setTimer(()=>{try{Promise.resolve(registration?.renew()).then((renewed:any)=>{if(renewed?.leaseExpiresAt){registration.leaseExpiresAt=renewed.leaseExpiresAt;bridgeRef?.setCurrentOwner?.({ownerSessionId:registration.ownerId,ownerLeaseExpiresAt:renewed.leaseExpiresAt,updateActive:true});}}).catch(()=>api.disable());}catch{void api.disable();}},Math.max(1,Math.floor(registration.leaseMs/2)));}return registration;}catch(error:any){try{await socket?.close();}catch{}socket=null;cleanup();if(error?.leaseExpiresAt){const delay=Math.max(0,new Date(error.leaseExpiresAt).getTime()-(deps.now?.()??Date.now()));const retryEpoch=epoch;retryTimer=(deps.setTimeout??setTimeout)(()=>{retryTimer=null;if(retryEpoch!==epoch)return;void (bridgeRef?api.startBridge(bridgeRef,bridgeInput):api.start(input)).catch(()=>{});},delay);return null;}throw error;}},
10
+ cancelOwnedGeneration(request:any){const key=`${request.taskId}:${request.generation}`;if(completedCancels.has(key))return Promise.resolve(completedCancels.get(key));const handle=handles.get(key);if(!handle)return Promise.resolve({cancelled:false,reason:"unsupported"});return control.cancel({...request,profileKey:registration?.profileKey,token:registration?.token,handle}).then((result:any)=>{completedCancels.set(key,result);return result;});},
11
+ registerOwnedGeneration(value:any){const proc:any=value.process;const exitPromise=value.exitPromise??(proc?.exitCode!==null&&proc?.exitCode!==undefined?Promise.resolve(true):new Promise(resolve=>proc?.once?.("close",()=>resolve(true))));const owned={...value,exitPromise,profileKey:registration?.profileKey??value.profileKey,token:registration?.token??value.token};const handle=control.register(owned);handles.set(`${owned.taskId}:${owned.generation}`,handle);return handle;},async disable(){unavailable=true;await api.stop();},isUnavailable(){return unavailable;},isAlive(){return !!socket&&!unavailable;},recordWaitOnlyCancellation,
12
+ async stop(){epoch++;bridgeRef=null;bridgeInput=null;clearRenew();try{await socket?.close();}finally{socket=null;registration?.cleanup?.();registration=null;}}
13
+ };return api;}
@@ -0,0 +1,59 @@
1
+ import {
2
+ type CreateChildTaskInput,
3
+ type CreateParentTaskInput,
4
+ type MonitorTask,
5
+ } from "../../../scripts/lib/hermes-monitor-model.ts";
6
+ import { MonitorStore, type MonitorOutput } from "../../../scripts/lib/hermes-monitor-store.ts";
7
+ import { correlateHubPane } from "../../../scripts/lib/hermes-monitor-herdr.ts";
8
+
9
+ export interface ViewerGatedMonitor {
10
+ setViewers(count: number): void;
11
+ stop(): void;
12
+ }
13
+
14
+ export function createViewerGatedMonitor(options: {
15
+ pollMetadata: () => Promise<Array<{ id: string; generation: number; outputSequence: number }>>;
16
+ fetchOutput: (id: string, generation: number, afterSequence: number) => Promise<{ sequence: number }>;
17
+ intervalMs?: number;
18
+ }): ViewerGatedMonitor {
19
+ const cursors = new Map<string, number>();
20
+ let viewers = 0;
21
+ let timer: ReturnType<typeof setInterval> | null = null;
22
+ const poll = async () => {
23
+ if (viewers === 0) return;
24
+ for (const row of await options.pollMetadata()) {
25
+ const key = `${row.id}:${row.generation}`;
26
+ const cursor = cursors.get(key) ?? 0;
27
+ if (row.outputSequence > cursor) cursors.set(key, (await options.fetchOutput(row.id, row.generation, cursor)).sequence);
28
+ }
29
+ };
30
+ return { setViewers(count) { viewers = Math.max(0, count); if (viewers > 0 && !timer) timer = setInterval(() => void poll(), options.intervalMs ?? 1000); if (viewers === 0 && timer) { clearInterval(timer); timer = null; } }, stop() { viewers = 0; if (timer) clearInterval(timer); timer = null; } };
31
+ }
32
+
33
+ // Agent Fleet-owned publishing seam. Hub lifecycle wiring is added in later slices.
34
+ export class MonitorPublisher {
35
+ private readonly store: MonitorStore;
36
+
37
+ constructor(store: MonitorStore) {
38
+ this.store = store;
39
+ }
40
+
41
+ publishParent(input: CreateParentTaskInput): MonitorTask {
42
+ return this.store.createParent(input);
43
+ }
44
+
45
+ publishChild(input: CreateChildTaskInput): MonitorTask {
46
+ return this.store.createChild(input);
47
+ }
48
+
49
+ async publishChildForHub(input: CreateChildTaskInput, env: NodeJS.ProcessEnv = process.env): Promise<MonitorTask> {
50
+ const correlation = await correlateHubPane(env);
51
+ return this.publishChild({ ...input, workspaceId: correlation.workspaceId ?? input.workspaceId, hubPaneId: correlation.hubPaneId ?? input.hubPaneId });
52
+ }
53
+
54
+ transition(id: string, generation: number, state: any): MonitorTask { return this.store.transition(id, generation, state); }
55
+
56
+ publishPublicOutput(id: string, generation: number, text: string): MonitorOutput {
57
+ return this.store.appendPublicOutput(id, generation, text);
58
+ }
59
+ }
@@ -0,0 +1,3 @@
1
+ import * as crypto from "node:crypto";
2
+ export function stableMonitorHubId(input:{profileId:string;checkout:string;workspaceId?:string;paneId?:string}){if(!input.workspaceId||!input.paneId)throw new Error("monitor recovery requires Herdr workspace and pane identity");return crypto.createHash("sha256").update(`${input.profileId}\0${input.checkout}\0${input.workspaceId}\0${input.paneId}`).digest("hex");}
3
+ export async function monitorReconcileEvidence(input:any){try{const owner=input.owner??!!input.registry?.owns?.(input.hubId);const socket=input.socket??!!input.socketServer?.alive?.();const session=input.session??input.currentHubId===input.hubId;const pane=await input.herdr?.pane?.get?.(input.paneId);const workspace=await input.herdr?.workspace?.get?.(input.workspaceId);return{owner:!!owner,socket:!!socket,session:!!session,herdr:!!pane&&!!workspace};}catch{return{owner:!!input.owner,socket:!!input.socket,session:!!input.session,herdr:true,transient:true};}}
@@ -0,0 +1,3 @@
1
+ import * as crypto from "node:crypto";import * as fs from "node:fs";import * as path from "node:path";
2
+ const key=(v:string)=>crypto.createHash("sha256").update(v).digest("hex");const ownedDir=(p:string)=>{const s=fs.lstatSync(p);if(s.isSymbolicLink()||!s.isDirectory()||(s.mode&0o777)!==0o700)throw Error("unsafe monitor runtime");};const safe=(v:string)=>/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(v)&&!v.includes("..");
3
+ export class MonitorRuntime {path:string;private now:()=>Date;constructor(o:any){if(!path.isAbsolute(o.runtimeDir)||!safe(o.profileId)||!safe(o.hubInstanceId))throw Error("unsafe monitor runtime");this.now=o.now??(()=>new Date());fs.mkdirSync(o.runtimeDir,{recursive:true,mode:0o700});ownedDir(o.runtimeDir);const journal=path.join(o.runtimeDir,"journal");fs.mkdirSync(journal,{recursive:true,mode:0o700});ownedDir(journal);const dir=path.join(journal,key(o.profileId));fs.mkdirSync(dir,{recursive:true,mode:0o700});ownedDir(dir);this.path=path.join(dir,`${key(o.hubInstanceId)}.json`);}save(state:any){const clean={tasks:(state.tasks??[]).map((t:any)=>({...t,output:String(t.output??"").slice(-8192),lateHistory:(t.lateHistory??[]).slice(-200)}))};const dir=path.dirname(this.path);ownedDir(dir);const tmp=path.join(dir,`.${path.basename(this.path)}.${crypto.randomUUID()}.tmp`);let fd:number|undefined;try{fd=fs.openSync(tmp,fs.constants.O_WRONLY|fs.constants.O_CREAT|fs.constants.O_EXCL|fs.constants.O_NOFOLLOW,0o600);fs.writeFileSync(fd,JSON.stringify(clean));fs.fsyncSync(fd);fs.closeSync(fd);fd=undefined;fs.renameSync(tmp,this.path);try{const dfd=fs.openSync(dir,fs.constants.O_RDONLY);fs.fsyncSync(dfd);fs.closeSync(dfd);}catch{}}finally{if(fd!==undefined)try{fs.closeSync(fd)}catch{};try{fs.unlinkSync(tmp)}catch{}}}load(){if(!fs.existsSync(this.path))return{tasks:[]};const st=fs.lstatSync(this.path);if(st.isSymbolicLink()||!st.isFile()||(st.mode&0o777)!==0o600)throw Error("unsafe monitor journal");try{const v=JSON.parse(fs.readFileSync(this.path,"utf8"));if(!Array.isArray(v.tasks))throw Error();return v;}catch{throw Error("unsafe monitor journal");}}reconcile(state:any,e:any){return{...state,tasks:(state.tasks??[]).map((t:any)=>{const lease=Date.parse(t.ownerLeaseExpiresAt??"");const expiry=Number.isFinite(lease)?lease:Date.parse(t.updatedAt??"")+30_000;const expired=this.now().getTime()>=expiry;return expired&&["starting","running","cancelling"].includes(t.state)&&!e.owner&&!e.socket&&!e.session&&!e.herdr?{...t,state:"orphaned"}:t;})};}}
@@ -0,0 +1,11 @@
1
+ import { MonitorStore } from '../../../scripts/lib/hermes-monitor-store.ts'; import { MonitorPublisher } from './monitor-publisher.ts';
2
+ const terminal=(state:any)=>["completed","blocked","failed","cancelled","orphaned","done"].includes(state);
3
+ export function createMonitorSessionBridge(deps:any={}){const store=deps.store??new MonitorStore({now:deps.now}),pub=deps.publisher??new MonitorPublisher(store),keys=new Map(),ready=new Map(),late=new Map(),finalized=new Map(),cancellable=new Set(),waitAborts=new Map(),recovering=new Map(),monitorKeyByTask=new Map(),lateByGeneration=new Map();let currentOwner:any=deps.currentOwner??{};const runtime=deps.runtime;try{if(runtime){const restored=runtime.load().tasks??[];store.restore(restored);for(const task of restored){if(task.monitorKey){const id=`${task.id}:${task.generation}`;monitorKeyByTask.set(id,task.monitorKey);if(task.lateHistory)lateByGeneration.set(`${task.monitorKey}:${task.generation}`,task.lateHistory);const prior=keys.get(task.monitorKey);if(!prior||prior.generation<task.generation){keys.set(task.monitorKey,{id:task.id,generation:task.generation});ready.set(task.monitorKey,Promise.resolve(task));}}}}}catch(error){throw error}const persist=()=>runtime?.save({tasks:(store.durableSnapshot?.().tasks??records()).map((task:any)=>({...task,monitorKey:monitorKeyByTask.get(`${task.id}:${task.generation}`),lateHistory:lateByGeneration.get(`${monitorKeyByTask.get(`${task.id}:${task.generation}`)}:${task.generation}`)??[]}))});const records=()=>store.snapshot().tasks as any[];const lateEvent=(key:string,event:any,generation?:number)=>{generation??=keys.get(key)?.generation;const lateKey=generation===undefined?key:`${key}:${generation}`;const h=lateByGeneration.get(lateKey)??[];h.push(event);if(h.length>200)h.splice(0,h.length-200);lateByGeneration.set(lateKey,h);late.set(key,h);persist();return{state:'cancelled',history:h};};const after=(key:string,work:(v:any)=>any)=>{const pending=ready.get(key);if(!pending)return Promise.reject(new Error(`child ${key} is not registered`));const chained=pending.then(()=>{const v:any=keys.get(key);return work(v);}).then(value=>{persist();return value;});ready.set(key,chained.catch(()=>undefined));return chained;};return{
4
+ setCurrentOwner(owner:any){currentOwner={...owner};if(owner.updateActive){for(const task of records())if(!terminal(task.state)){if(!task.ownerSessionId)store.patch(task.id,task.generation,{ownerSessionId:owner.ownerSessionId,ownerLeaseExpiresAt:owner.ownerLeaseExpiresAt});else if(task.ownerSessionId===owner.ownerSessionId)store.patch(task.id,task.generation,{ownerLeaseExpiresAt:owner.ownerLeaseExpiresAt});}persist();}}, startParent(v:any){const task=pub.publishParent({...v,...currentOwner,generation:v.generation??1});keys.set(`parent:${task.id}`,{id:task.id,generation:task.generation});monitorKeyByTask.set(`${task.id}:${task.generation}`,`parent:${task.id}`);persist();return task},
5
+ startChild(v:any,env:any){const existing=ready.get(v.key);if(existing){const prior:any=keys.get(v.key),task=prior&&store.get(prior.id,prior.generation);if(!task||!["completed","blocked","failed","cancelled","orphaned","recovering"].includes(task.state))return existing;v={...v,generation:prior.generation+1};ready.delete(v.key);}const pending=Promise.resolve().then(()=>pub.publishChildForHub({...v,...currentOwner,parentGeneration:v.parentGeneration??1},env)).then((task:any)=>{keys.set(v.key,{id:task.id,generation:task.generation});monitorKeyByTask.set(`${task.id}:${task.generation}`,v.key);persist();return {...task,monitorKey:v.key};});ready.set(v.key,pending);pending.catch(()=>ready.delete(v.key));return pending;},
6
+ appendOutputFor(v:any,text:string){const task=store.get(v.id,v.generation);if(!task||terminal(task.state))return lateEvent(monitorKeyByTask.get(`${v.id}:${v.generation}`)??v.monitorKey,{kind:'late_output',text},v.generation);const result=pub.publishPublicOutput(v.id,v.generation,text);persist();return result;},finalizeChildFor(v:any,output:string,state:any){const id=`${v.id}:${v.generation}`,prior=finalized.get(id);if(prior)return prior;const task=store.get(v.id,v.generation),key=monitorKeyByTask.get(id)??v.monitorKey;if(!task||terminal(task.state))return lateEvent(key,{kind:'late_final',output,state},v.generation);const result=Promise.resolve().then(()=>{if(output)pub.publishPublicOutput(v.id,v.generation,output);const done=pub.transition(v.id,v.generation,state);persist();return done;});finalized.set(id,result);return result;},registerOwnedProcessFor(v:any,p:unknown){const key=v.monitorKey??monitorKeyByTask.get(`${v.id}:${v.generation}`);cancellable.add(key);return deps.registerOwnedProcess?.(key,p,v);},cancelFor(v:any){return this.cancelTask({taskId:v.id,generation:v.generation});},registerOwnedProcess(key:string,p:unknown){return after(key,(v:any)=>{cancellable.add(key);return deps.registerOwnedProcess?.(key,p,v);});},registerWaitOnly(key:string,abort?:()=>unknown){return after(key,()=>{cancellable.add(key);if(abort)waitAborts.set(key,abort);});},
7
+ appendOutput(key:string,text:string){return after(key,(v:any)=>{const task=store.get(v.id,v.generation);if(terminal(task?.state))return lateEvent(key,{kind:'late_output',text});return pub.publishPublicOutput(v.id,v.generation,text);});},
8
+ finishChild(key:string,state:any){return after(key,(v:any)=>{const task=store.get(v.id,v.generation);if(terminal(task?.state))return task?.state==='cancelled'||task?.state==='orphaned'?lateEvent(key,{kind:'late_finish',state}):task;return pub.transition(v.id,v.generation,state);});},
9
+ finalizeChild(key:string,output:string,state:any){const prior=finalized.get(key);if(prior)return prior;const result=after(key,async(v:any)=>{const task=store.get(v.id,v.generation);if(terminal(task?.state))return task?.state==='cancelled'||task?.state==='orphaned'?lateEvent(key,{kind:'late_final',output,state}):task;if(output)pub.publishPublicOutput(v.id,v.generation,output);return pub.transition(v.id,v.generation,state);});finalized.set(key,result);return result;},recordComsFinal(key:string,text:string){return this.appendOutput(key,text);},
10
+ markCancelling(key:string){return after(key,(v:any)=>{const task=store.get(v.id,v.generation);return terminal(task?.state)?task:pub.transition(v.id,v.generation,'cancelling');});},markCancelled(key:string){return after(key,(v:any)=>{const task=store.get(v.id,v.generation);return task?.state==='cancelled'?task:pub.transition(v.id,v.generation,'cancelled');});},async cancelOwnedProcess(key:string){return after(key,async(v:any)=>{const task=store.get(v.id,v.generation);if(task?.state==='cancelled')return{cancelled:true,state:'cancelled'};if(!terminal(task?.state))pub.transition(v.id,v.generation,'cancelling');const result=await deps.cancelOwnedProcess?.({taskId:v.id,generation:v.generation});if(result?.cancelled&&!terminal(store.get(v.id,v.generation)?.state))pub.transition(v.id,v.generation,'cancelled');if(result?.cancelled)cancellable.delete(key);return result??{cancelled:false,reason:'unsupported'};});},
11
+ cancelAllWaitOnly(){return Promise.all([...waitAborts.keys()].map(key=>this.cancelWaitOnly(key,{kind:'session_reset'})));},cancelWaitOnly(key:string,event:unknown){return after(key,async(v:any)=>{await waitAborts.get(key)?.();const task=store.get(v.id,v.generation);if(!terminal(task?.state))pub.transition(v.id,v.generation,'cancelled');cancellable.delete(key);waitAborts.delete(key);return lateEvent(key,event);});},cancelTask(request:any){const entry=[...keys.entries()].find(([,v]:any)=>v.id===request.taskId&&v.generation===request.generation);if(!entry)return Promise.resolve({cancelled:false,reason:'unsupported'});const [key]=entry;return waitAborts.has(key)?this.cancelWaitOnly(key,{kind:'operator_cancel'}).then(()=>({cancelled:true,state:'cancelled'})):this.cancelOwnedProcess(key);},recordComsLateEvent(key:string,event:unknown){return lateEvent(key,event);},readOutput(r:any){return store.readOutput(r.taskId,r.generation,r.afterSequence)},prune(){const value=store.prune();persist();return value},reconcile(e:any){for(const task of records()){if(e?.taskId&&`${task.id}:${task.generation}`!==e.taskId)continue;const old=task.ownerSessionId&&task.ownerSessionId!==currentOwner.ownerSessionId;if(["completed","blocked","failed","cancelled","orphaned"].includes(task.state))continue;if(old&&(deps.now?.().getTime?.()??Date.now())<Date.parse(task.ownerLeaseExpiresAt??"")){if(task.state!=="recovering"){recovering.set(`${task.id}:${task.generation}`,task.state);pub.transition(task.id,task.generation,"recovering");}continue;}if(old&&e?.oldOwner===false&&e?.oldSocket===false&&e?.oldSession===false&&e?.oldHerdr===false){pub.transition(task.id,task.generation,"orphaned");continue;}if(old)continue;if(["starting","running","cancelling","recovering"].includes(task.state)&&!e?.owner&&!e?.socket&&!e?.session&&!e?.herdr&&task.ownerLeaseExpiresAt&&(deps.now?.().getTime?.()??Date.now())<Date.parse(task.ownerLeaseExpiresAt)){if(task.state!=="recovering")recovering.set(`${task.id}:${task.generation}`,task.state);if(task.state!=="recovering")pub.transition(task.id,task.generation,"recovering");continue;}if(["starting","running","cancelling"].includes(task.state)&&e?.transient){recovering.set(`${task.id}:${task.generation}`,task.state);pub.transition(task.id,task.generation,"recovering");}else if(task.state==="recovering"&&e?.owner&&e?.socket&&e?.session&&e?.herdr)pub.transition(task.id,task.generation,recovering.get(`${task.id}:${task.generation}`)??"running");else if(["starting","running","cancelling","recovering"].includes(task.state)&&!e?.owner&&!e?.socket&&!e?.session&&!e?.herdr)pub.transition(task.id,task.generation,"orphaned");}persist();return this.snapshot();},snapshot(){persist();return{tasks:records().map((task:any)=>{const key=[...keys.entries()].find(([,v]:any)=>v.id===task.id&&v.generation===task.generation)?.[0];return{id:task.id,generation:task.generation,kind:task.kind,parentId:task.parentId,parentGeneration:task.parentGeneration,specialist:task.specialist,state:task.state,workspaceId:task.workspaceId,hubPaneId:task.hubPaneId,hubInstanceId:task.hubInstanceId,ownerSessionId:task.ownerSessionId,ownerLeaseExpiresAt:task.ownerLeaseExpiresAt,outputSequence:task.outputSequence,firstSequence:task.firstSequence,truncated:task.truncated,canCancel:!!key&&cancellable.has(key)&&!terminal(task.state)};})}},reset(){keys.clear();ready.clear();late.clear();finalized.clear();cancellable.clear();monitorKeyByTask.clear();lateByGeneration.clear();persist()},stop(){keys.clear();ready.clear();late.clear();finalized.clear();cancellable.clear();monitorKeyByTask.clear();lateByGeneration.clear()}}}
@@ -1,6 +1,7 @@
1
1
  {
2
- "name": "agent-fleet-pi-agent-hub",
3
- "private": true,
4
- "type": "module",
5
- "main": "index.ts"
2
+ "name": "agent-fleet-pi-agent-hub",
3
+ "private": true,
4
+ "type": "module",
5
+ "main": "index.ts",
6
+ "version": "0.0.4"
6
7
  }
@@ -0,0 +1,40 @@
1
+ import type { Termination } from "./spawn.ts";
2
+
3
+ /** Spawn policy shared by every native read-only research-helper path. */
4
+ export function researchWatchdogSpawnOptions(timeoutMs: number | null, signal?: AbortSignal) {
5
+ return {
6
+ detached: true,
7
+ signal,
8
+ toolWatchdog: { timeoutMs },
9
+ };
10
+ }
11
+
12
+ /** Stable terminal result used by research lifecycle code after parent cleanup. */
13
+ export function researchTerminationOutcome(id: number, termination: Termination) {
14
+ const reason = termination.reason;
15
+ const tool = termination.tool;
16
+ const status = reason; // "tool_timeout" | "turn_timeout" | "drift_stop" | "cancelled"
17
+ const lastWork = reason === "tool_timeout"
18
+ ? `tool_timeout: ${tool?.toolName || "tool"} (${tool?.toolCallId || "unknown"})`
19
+ : reason === "turn_timeout"
20
+ ? "turn_timeout: per-run deadline exceeded"
21
+ : reason === "drift_stop"
22
+ ? "drift_stop: stopped by the drift watchdog"
23
+ : "cancelled by caller";
24
+ const metadata = reason === "tool_timeout"
25
+ ? `toolCallId=${tool?.toolCallId || "unknown"}, tool=${tool?.toolName || "unknown"}, deadline=${tool?.deadlineAt || "unknown"}, terminationConfirmed=${termination.confirmed}`
26
+ : `terminationConfirmed=${termination.confirmed}`;
27
+ const explanation = reason === "tool_timeout"
28
+ ? "exceeded its per-tool watchdog"
29
+ : reason === "turn_timeout"
30
+ ? "exceeded the per-run deadline (agent-turn-timeout-s / mode budget) — narrow the question or raise the deadline"
31
+ : reason === "drift_stop"
32
+ ? "was stopped by the drift watchdog"
33
+ : "was cancelled by its caller";
34
+ return {
35
+ status,
36
+ lastWork,
37
+ output: `${status}: research helper r${id} ${explanation} (${metadata}).`,
38
+ exitCode: reason === "cancelled" ? 130 : reason === "drift_stop" ? 125 : 124,
39
+ };
40
+ }
@@ -0,0 +1,155 @@
1
+ // Execution modes & per-turn budgets — the pure policy core behind the hub's
2
+ // runaway-orchestration guardrails. Budgets are PER USER TURN: a new user
3
+ // message opens a fresh window, so "budget exhausted" naturally means "stop,
4
+ // summarize, ask the user". Everything here is data + pure functions so the
5
+ // policy is unit-testable away from the 7k-line harness.
6
+ //
7
+ // A budget value of `null` means "off"/unlimited for that axis.
8
+
9
+ export const HUB_MODES = ["fast", "standard", "strict"];
10
+ export const DEFAULT_HUB_MODE = "standard";
11
+
12
+ // Task tiers — the dispatcher's per-turn complexity triage. Tier caps only
13
+ // lower the dispatch/research axes (min with the mode budget): a trivial ask
14
+ // must not burn a standard-mode budget on ceremony, while `project` defers
15
+ // entirely to the mode. Unset tier is treated as "feature".
16
+ export const TASK_TIERS = ["trivial", "small", "feature", "project"];
17
+ export const DEFAULT_TASK_TIER = "feature";
18
+
19
+ export const TIER_CAPS = {
20
+ trivial: { maxDispatches: 1, maxResearch: 1 },
21
+ small: { maxDispatches: 2, maxResearch: 2 },
22
+ feature: { maxDispatches: 6, maxResearch: 4 },
23
+ project: { maxDispatches: null, maxResearch: null },
24
+ };
25
+
26
+ /** "Small", " TRIVIAL " → canonical tier name, or null when unrecognized. */
27
+ export function normalizeTaskTier(value) {
28
+ const v = String(value ?? "").trim().toLowerCase();
29
+ return TASK_TIERS.includes(v) ? v : null;
30
+ }
31
+
32
+ // Session-recycle context threshold (percent, measured over input+cacheRead+
33
+ // cacheWrite): beyond this, resuming the specialist session mostly re-bills
34
+ // stale context, so a fresh session is cheaper than the memory is worth.
35
+ export const RECYCLE_CONTEXT_PCT = 60;
36
+
37
+ export const MODE_BUDGETS = {
38
+ fast: {
39
+ maxDispatches: 2,
40
+ maxResearch: 1,
41
+ wallMs: 15 * 60_000,
42
+ agentTurnMs: 10 * 60_000,
43
+ recycleRuns: 3,
44
+ delegation: false,
45
+ },
46
+ standard: {
47
+ maxDispatches: 8,
48
+ maxResearch: 4,
49
+ wallMs: 60 * 60_000,
50
+ agentTurnMs: 30 * 60_000,
51
+ recycleRuns: 5,
52
+ delegation: true,
53
+ },
54
+ strict: {
55
+ maxDispatches: 24,
56
+ maxResearch: 12,
57
+ wallMs: 240 * 60_000,
58
+ agentTurnMs: null,
59
+ recycleRuns: 5,
60
+ delegation: true,
61
+ },
62
+ };
63
+
64
+ /** "Fast", " STRICT " → canonical mode name, or null when unrecognized. */
65
+ export function normalizeHubMode(value) {
66
+ const v = String(value ?? "").trim().toLowerCase();
67
+ return HUB_MODES.includes(v) ? v : null;
68
+ }
69
+
70
+ /**
71
+ * Effective budget for a mode with per-project overrides applied.
72
+ * Override fields (all optional): maxDispatches, maxResearch, wallMs,
73
+ * agentTurnMs, recycleRuns — a number replaces the mode default, `null` turns
74
+ * the axis off, `undefined` keeps the default. `delegation` is mode-owned.
75
+ * A declared `tier` (task tier) then LOWERS the dispatch and research caps to
76
+ * the tier cap — overrides raise/disable the mode side, but the tier keeps a
77
+ * simple ask from spending the whole envelope. No tier (null/undefined) means
78
+ * no tier caps: the caller decides when to assume DEFAULT_TASK_TIER.
79
+ */
80
+ export function resolveTurnBudget(mode, overrides = {}, tier = undefined) {
81
+ const base = MODE_BUDGETS[normalizeHubMode(mode) ?? DEFAULT_HUB_MODE];
82
+ const pick = (key) => (overrides[key] === undefined ? base[key] : overrides[key]);
83
+ const caps = TIER_CAPS[normalizeTaskTier(tier)] ?? { maxDispatches: null, maxResearch: null };
84
+ const lower = (value, cap) => {
85
+ if (cap == null) return value;
86
+ if (value == null) return cap;
87
+ return Math.min(value, cap);
88
+ };
89
+ return {
90
+ maxDispatches: lower(pick("maxDispatches"), caps.maxDispatches),
91
+ maxResearch: lower(pick("maxResearch"), caps.maxResearch),
92
+ wallMs: pick("wallMs"),
93
+ agentTurnMs: pick("agentTurnMs"),
94
+ recycleRuns: pick("recycleRuns"),
95
+ delegation: base.delegation,
96
+ };
97
+ }
98
+
99
+ function refusalTail(mode) {
100
+ return "Do NOT retry this call in this turn. Summarize progress so far (including " +
101
+ "unproven assertions and artifact paths), then ask the user whether to continue — " +
102
+ "the next user message starts a fresh budget window. The user can widen budgets " +
103
+ `with /hub-mode (current: ${mode}) or the max-*-per-turn / turn-wall-time-s keys ` +
104
+ "in .ai/agent-fleet-overrides.md.";
105
+ }
106
+
107
+ /**
108
+ * Gate one dispatcher tool call against the turn budget.
109
+ * kind: "dispatch" | "research"; counters: { dispatches, research } — calls
110
+ * already made this turn. Returns null when allowed, else { reason, message }.
111
+ */
112
+ export function checkTurnBudget(kind, counters, budget, elapsedWallMs, mode = DEFAULT_HUB_MODE) {
113
+ if (budget.wallMs != null && elapsedWallMs >= budget.wallMs) {
114
+ return {
115
+ reason: "wall",
116
+ message: `⚠ Turn budget exhausted: wall clock at ${Math.round(elapsedWallMs / 60_000)} min ` +
117
+ `(limit ${Math.round(budget.wallMs / 60_000)} min in ${mode} mode). ${refusalTail(mode)}`,
118
+ };
119
+ }
120
+ if (kind === "dispatch" && budget.maxDispatches != null && counters.dispatches >= budget.maxDispatches) {
121
+ return {
122
+ reason: "dispatches",
123
+ message: `⚠ Turn budget exhausted: ${counters.dispatches} of ${budget.maxDispatches} ` +
124
+ `dispatch_agent calls used in ${mode} mode. ${refusalTail(mode)}`,
125
+ };
126
+ }
127
+ if (kind === "research" && budget.maxResearch != null && counters.research >= budget.maxResearch) {
128
+ return {
129
+ reason: "research",
130
+ message: `⚠ Turn budget exhausted: ${counters.research} of ${budget.maxResearch} ` +
131
+ `spawn_research calls used in ${mode} mode. ${refusalTail(mode)}`,
132
+ };
133
+ }
134
+ return null;
135
+ }
136
+
137
+ /**
138
+ * Recycle the specialist's accumulated session before this run? True when the
139
+ * session already served `recycleRuns` runs, or its (correctly measured)
140
+ * context passed RECYCLE_CONTEXT_PCT — resuming past either point mostly
141
+ * re-bills stale context on every subsequent model call.
142
+ */
143
+ export function shouldRecycleSession(runsSinceFresh, contextPct, budget, thresholdPct = RECYCLE_CONTEXT_PCT) {
144
+ if (runsSinceFresh <= 0) return false;
145
+ if (budget.recycleRuns != null && runsSinceFresh >= budget.recycleRuns) return true;
146
+ return contextPct >= thresholdPct;
147
+ }
148
+
149
+ /** One-line status chip: "Mode: standard·small · 1/2 disp · 0/2 res". */
150
+ export function budgetStatusLine(mode, counters, budget, tier = null) {
151
+ const cap = (n) => (n == null ? "∞" : String(n));
152
+ const tierSuffix = tier ? `·${tier}` : "";
153
+ return `Mode: ${mode}${tierSuffix} · ${counters.dispatches}/${cap(budget.maxDispatches)} disp · ` +
154
+ `${counters.research}/${cap(budget.maxResearch)} res`;
155
+ }
@@ -0,0 +1,22 @@
1
+ import { existsSync } from "node:fs";
2
+ import { join, resolve } from "node:path";
3
+
4
+ const CONTINUE_ENTRY = /damage-control-continue[/\\]index\.ts$/;
5
+ const MISSING_SAFETY_ERROR = "damage-control-continue harness not found — guarded child dispatch refused";
6
+
7
+ /** Resolve only the surviving continue harness; never downgrade to an unguarded or hard-stop child. */
8
+ export function resolveSafetyHarness(cwd: string, argv: string[] = process.argv): string | null {
9
+ for (let i = 0; i < argv.length - 1; i++) {
10
+ if (argv[i] !== "-e" && argv[i] !== "--extension") continue;
11
+ const candidate = resolve(argv[i + 1]);
12
+ if (CONTINUE_ENTRY.test(candidate) && existsSync(candidate)) return candidate;
13
+ }
14
+ const local = join(cwd, ".pi", "harnesses", "damage-control-continue", "index.ts");
15
+ return existsSync(local) ? local : null;
16
+ }
17
+
18
+ export function requireSafetyHarness(path: string | null):
19
+ | { ok: true; extensions: string[] }
20
+ | { ok: false; error: string } {
21
+ return path ? { ok: true, extensions: [path] } : { ok: false, error: MISSING_SAFETY_ERROR };
22
+ }