@chankov/agent-fleet 0.0.8 → 0.0.10

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 (682) hide show
  1. package/.claude/commands/doctor-agent-fleet.md +12 -7
  2. package/.claude/commands/setup-agent-fleet.md +7 -15
  3. package/.opencode/commands/af-doctor-agent-fleet.md +12 -7
  4. package/.opencode/commands/af-setup-agent-fleet.md +8 -6
  5. package/.pi/agents/model-profiles.yaml +9 -2
  6. package/.pi/agents/peers.yaml +12 -16
  7. package/.pi/agents/teams.yaml +4 -2
  8. package/.pi/extensions/agent-fleet-update-check/README.md +2 -3
  9. package/.pi/extensions/btw/README.md +2 -2
  10. package/.pi/extensions/chrome-devtools-mcp/README.md +3 -6
  11. package/.pi/extensions/compact-and-continue/README.md +3 -3
  12. package/.pi/extensions/mcp-bridge/README.md +1 -1
  13. package/.pi/harnesses/agent-hub/README.md +159 -15
  14. package/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  15. package/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  16. package/.pi/harnesses/agent-hub/footer.ts +4 -2
  17. package/.pi/harnesses/agent-hub/index.ts +552 -50
  18. package/.pi/harnesses/agent-hub/package.json +1 -1
  19. package/.pi/harnesses/agent-hub/review-findings.js +102 -0
  20. package/.pi/harnesses/agent-hub/run-budget.js +302 -4
  21. package/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  22. package/.pi/harnesses/agent-hub/version.ts +25 -1
  23. package/.pi/harnesses/coms/README.md +8 -1
  24. package/.pi/harnesses/coms/package.json +1 -1
  25. package/.pi/harnesses/coms/version.ts +25 -1
  26. package/.pi/harnesses/damage-control-continue/README.md +8 -1
  27. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  28. package/.pi/harnesses/damage-control-continue/version.ts +25 -1
  29. package/.pi/harnesses/lib/herdr-client.ts +10 -1
  30. package/.pi/harnesses/lib/spawned-peers.js +190 -0
  31. package/.pi/prompts/af-doctor-agent-fleet.md +13 -6
  32. package/.pi/prompts/af-setup-agent-fleet.md +7 -15
  33. package/.versions/0.0.10/.claude/commands/build.md +44 -0
  34. package/.versions/0.0.10/.claude/commands/code-simplify.md +22 -0
  35. package/.versions/0.0.10/.claude/commands/design-agent.md +14 -0
  36. package/.versions/0.0.10/.claude/commands/doctor-agent-fleet.md +22 -0
  37. package/.versions/0.0.10/.claude/commands/orchestrate.md +112 -0
  38. package/.versions/0.0.10/.claude/commands/plan.md +16 -0
  39. package/.versions/0.0.10/.claude/commands/prime.md +22 -0
  40. package/.versions/0.0.10/.claude/commands/review.md +16 -0
  41. package/.versions/0.0.10/.claude/commands/set-hermes-telegram.md +15 -0
  42. package/.versions/0.0.10/.claude/commands/set-hermes-watchdog.md +6 -0
  43. package/.versions/0.0.10/.claude/commands/setup-agent-fleet.md +17 -0
  44. package/.versions/0.0.10/.claude/commands/ship.md +72 -0
  45. package/.versions/0.0.10/.claude/commands/spec.md +15 -0
  46. package/.versions/0.0.10/.claude/commands/test.md +19 -0
  47. package/.versions/0.0.10/.claude/commands/webperf.md +32 -0
  48. package/.versions/0.0.10/.claude/orchestrate-teams.yaml +24 -0
  49. package/.versions/0.0.10/.opencode/commands/af-build.md +17 -0
  50. package/.versions/0.0.10/.opencode/commands/af-code-simplify.md +16 -0
  51. package/.versions/0.0.10/.opencode/commands/af-compound.md +16 -0
  52. package/.versions/0.0.10/.opencode/commands/af-design-agent.md +15 -0
  53. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +22 -0
  54. package/.versions/0.0.10/.opencode/commands/af-orchestrate.md +112 -0
  55. package/.versions/0.0.10/.opencode/commands/af-plan.md +16 -0
  56. package/.versions/0.0.10/.opencode/commands/af-prime.md +22 -0
  57. package/.versions/0.0.10/.opencode/commands/af-review.md +15 -0
  58. package/.versions/0.0.10/.opencode/commands/af-set-hermes-telegram.md +15 -0
  59. package/.versions/0.0.10/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  60. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +17 -0
  61. package/.versions/0.0.10/.opencode/commands/af-ship.md +16 -0
  62. package/.versions/0.0.10/.opencode/commands/af-spec.md +16 -0
  63. package/.versions/0.0.10/.opencode/commands/af-test.md +21 -0
  64. package/.versions/0.0.10/.opencode/commands/af-webperf.md +32 -0
  65. package/.versions/0.0.10/.opencode/orchestrate-teams.yaml +24 -0
  66. package/.versions/0.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  67. package/.versions/0.0.10/.pi/agents/model-profiles.yaml +27 -0
  68. package/.versions/0.0.10/.pi/agents/peers.yaml +142 -0
  69. package/.versions/0.0.10/.pi/agents/teams.yaml +41 -0
  70. package/.versions/0.0.10/.pi/damage-control-rules.yaml +297 -0
  71. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  72. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  73. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  74. package/.versions/0.0.10/.pi/extensions/btw/README.md +118 -0
  75. package/.versions/0.0.10/.pi/extensions/btw/index.ts +917 -0
  76. package/.versions/0.0.10/.pi/extensions/btw/package.json +6 -0
  77. package/.versions/0.0.10/.pi/extensions/btw/state.js +179 -0
  78. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  79. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  80. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  81. package/.versions/0.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  82. package/.versions/0.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  83. package/.versions/0.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  84. package/.versions/0.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  85. package/.versions/0.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  86. package/.versions/0.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  87. package/.versions/0.0.10/.pi/extensions/package-lock.json +1143 -0
  88. package/.versions/0.0.10/.pi/extensions/package.json +9 -0
  89. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/README.md +201 -0
  90. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  91. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  92. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  93. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  94. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  95. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  96. package/.versions/0.0.10/.pi/harnesses/agent-hub/README.md +1001 -0
  97. package/.versions/0.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  98. package/.versions/0.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  99. package/.versions/0.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  100. package/.versions/0.0.10/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  101. package/.versions/0.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  102. package/.versions/0.0.10/.pi/harnesses/agent-hub/delegate.ts +435 -0
  103. package/.versions/0.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  104. package/.versions/0.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  105. package/.versions/0.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  106. package/.versions/0.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  107. package/.versions/0.0.10/.pi/harnesses/agent-hub/footer.ts +31 -0
  108. package/.versions/0.0.10/.pi/harnesses/agent-hub/helpers.ts +248 -0
  109. package/.versions/0.0.10/.pi/harnesses/agent-hub/index.ts +9111 -0
  110. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  111. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  112. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  113. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  114. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  115. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  116. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  117. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  118. package/.versions/0.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  119. package/.versions/0.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  120. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-retention.js +34 -0
  121. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  122. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-contract.js +293 -0
  123. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  124. package/.versions/0.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  125. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-budget.js +479 -0
  126. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  127. package/.versions/0.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  128. package/.versions/0.0.10/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  129. package/.versions/0.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  130. package/.versions/0.0.10/.pi/harnesses/agent-hub/spawn.ts +354 -0
  131. package/.versions/0.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  132. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/README.md +19 -0
  133. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/index.ts +321 -0
  134. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  135. package/.versions/0.0.10/.pi/harnesses/coms/README.md +100 -0
  136. package/.versions/0.0.10/.pi/harnesses/coms/index.ts +1767 -0
  137. package/.versions/0.0.10/.pi/harnesses/coms/package.json +7 -0
  138. package/.versions/0.0.10/.pi/harnesses/coms/version.ts +42 -0
  139. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/README.md +124 -0
  140. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/index.ts +536 -0
  141. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  142. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  143. package/.versions/0.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  144. package/.versions/0.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  145. package/.versions/0.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  146. package/.versions/0.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  147. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  148. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  149. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  150. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  151. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  152. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  153. package/.versions/0.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  154. package/.versions/0.0.10/.pi/harnesses/package-lock.json +35 -0
  155. package/.versions/0.0.10/.pi/harnesses/package.json +9 -0
  156. package/.versions/0.0.10/.pi/prompts/af-build.md +24 -0
  157. package/.versions/0.0.10/.pi/prompts/af-code-simplify.md +22 -0
  158. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +22 -0
  159. package/.versions/0.0.10/.pi/prompts/af-plan.md +16 -0
  160. package/.versions/0.0.10/.pi/prompts/af-review.md +16 -0
  161. package/.versions/0.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  162. package/.versions/0.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  163. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +19 -0
  164. package/.versions/0.0.10/.pi/prompts/af-ship.md +17 -0
  165. package/.versions/0.0.10/.pi/prompts/af-spec.md +15 -0
  166. package/.versions/0.0.10/.pi/prompts/af-test.md +19 -0
  167. package/.versions/0.0.10/.pi/skills/bowser/SKILL.md +145 -0
  168. package/.versions/0.0.10/.version +1 -0
  169. package/.versions/0.0.10/agents/architect.md +24 -0
  170. package/.versions/0.0.10/agents/bowser.md +27 -0
  171. package/.versions/0.0.10/agents/builder.md +54 -0
  172. package/.versions/0.0.10/agents/code-reviewer.md +208 -0
  173. package/.versions/0.0.10/agents/deep-researcher.md +32 -0
  174. package/.versions/0.0.10/agents/documenter.md +18 -0
  175. package/.versions/0.0.10/agents/orchestrator.md +72 -0
  176. package/.versions/0.0.10/agents/plan-reviewer.md +83 -0
  177. package/.versions/0.0.10/agents/planner.md +70 -0
  178. package/.versions/0.0.10/agents/releaser.md +24 -0
  179. package/.versions/0.0.10/agents/researcher.md +28 -0
  180. package/.versions/0.0.10/agents/security-auditor.md +167 -0
  181. package/.versions/0.0.10/agents/test-engineer.md +153 -0
  182. package/.versions/0.0.10/agents/web-debugger.md +43 -0
  183. package/.versions/0.0.10/agents/web-performance-auditor.md +193 -0
  184. package/.versions/0.0.10/codex/CONDUCTOR.md +148 -0
  185. package/.versions/0.0.10/docs/ARCHITECTURE.md +303 -0
  186. package/.versions/0.0.10/docs/agent-fleet-setup.md +377 -0
  187. package/.versions/0.0.10/docs/claude-code-coms-bridge.md +109 -0
  188. package/.versions/0.0.10/docs/codex-remote-conductor.md +170 -0
  189. package/.versions/0.0.10/docs/coms-hermes-bridge.md +189 -0
  190. package/.versions/0.0.10/docs/getting-started.md +254 -0
  191. package/.versions/0.0.10/docs/npm-install.md +514 -0
  192. package/.versions/0.0.10/docs/opencode-setup.md +281 -0
  193. package/.versions/0.0.10/docs/pi-extensions.md +363 -0
  194. package/.versions/0.0.10/docs/pi-setup.md +571 -0
  195. package/.versions/0.0.10/docs/skill-anatomy.md +150 -0
  196. package/.versions/0.0.10/hermes/README.md +347 -0
  197. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  198. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  199. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  200. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  201. package/.versions/0.0.10/hermes/gates/gate-o-capability.md +8 -0
  202. package/.versions/0.0.10/hermes/gates/gate-o-validator-fixtures.json +1 -0
  203. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  204. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  205. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  206. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  207. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  208. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  209. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  210. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  211. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  212. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  213. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  214. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  215. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  216. package/.versions/0.0.10/hermes/skills/hub-conductor/SKILL.md +84 -0
  217. package/.versions/0.0.10/hermes/skills/hub-liaison/SKILL.md +84 -0
  218. package/.versions/0.0.10/hermes/skills/hub-watchdog/SKILL.md +76 -0
  219. package/.versions/0.0.10/hermes/skills/hub-watchdog/manifest.json +1 -0
  220. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  221. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  222. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  223. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  224. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  225. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  226. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  227. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  228. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  229. package/.versions/0.0.10/hermes/watchdog-tests/__init__.py +0 -0
  230. package/.versions/0.0.10/hooks/SIMPLIFY-IGNORE.md +90 -0
  231. package/.versions/0.0.10/hooks/coms-stop-hook.mjs +84 -0
  232. package/.versions/0.0.10/hooks/hooks.json +14 -0
  233. package/.versions/0.0.10/hooks/session-start.sh +74 -0
  234. package/.versions/0.0.10/hooks/simplify-ignore.sh +302 -0
  235. package/.versions/0.0.10/install-manifest.json +3615 -0
  236. package/.versions/0.0.10/justfile +254 -0
  237. package/.versions/0.0.10/manifest-meta.json +472 -0
  238. package/.versions/0.0.10/references/accessibility-checklist.md +160 -0
  239. package/.versions/0.0.10/references/definition-of-done.md +67 -0
  240. package/.versions/0.0.10/references/fleet-coordination-patterns.md +151 -0
  241. package/.versions/0.0.10/references/observability-checklist.md +91 -0
  242. package/.versions/0.0.10/references/orchestration-patterns.md +370 -0
  243. package/.versions/0.0.10/references/performance-checklist.md +153 -0
  244. package/.versions/0.0.10/references/prompting-patterns.md +380 -0
  245. package/.versions/0.0.10/references/security-checklist.md +179 -0
  246. package/.versions/0.0.10/references/testing-patterns.md +236 -0
  247. package/.versions/0.0.10/scripts/codex-conductor.ts +41 -0
  248. package/.versions/0.0.10/scripts/codex-remote-control.ts +167 -0
  249. package/.versions/0.0.10/scripts/coms-claude-bridge.ts +401 -0
  250. package/.versions/0.0.10/scripts/coms-cli.ts +484 -0
  251. package/.versions/0.0.10/scripts/coms-hermes-bridge.ts +413 -0
  252. package/.versions/0.0.10/scripts/fleet.ts +168 -0
  253. package/.versions/0.0.10/scripts/hermes-monitor-capability-runner.ts +25 -0
  254. package/.versions/0.0.10/scripts/hermes-monitor-scenario.ts +474 -0
  255. package/.versions/0.0.10/scripts/hermes-watchdog-capability-probe.ts +45 -0
  256. package/.versions/0.0.10/scripts/install-hermes-plugin.sh +180 -0
  257. package/.versions/0.0.10/scripts/lib/claude-bridge-core.ts +165 -0
  258. package/.versions/0.0.10/scripts/lib/codex-conductor.ts +88 -0
  259. package/.versions/0.0.10/scripts/lib/codex-remote-control.ts +480 -0
  260. package/.versions/0.0.10/scripts/lib/coms-envelope.ts +582 -0
  261. package/.versions/0.0.10/scripts/lib/fake-herdr-server.ts +88 -0
  262. package/.versions/0.0.10/scripts/lib/fleet-command.ts +111 -0
  263. package/.versions/0.0.10/scripts/lib/herdr-layout.ts +281 -0
  264. package/.versions/0.0.10/scripts/lib/hermes-bridge-core.ts +241 -0
  265. package/.versions/0.0.10/scripts/lib/hermes-monitor-events.ts +1 -0
  266. package/.versions/0.0.10/scripts/lib/hermes-monitor-herdr.ts +2 -0
  267. package/.versions/0.0.10/scripts/lib/hermes-monitor-model.ts +3 -0
  268. package/.versions/0.0.10/scripts/lib/hermes-monitor-registry.ts +2 -0
  269. package/.versions/0.0.10/scripts/lib/hermes-monitor-socket.ts +2 -0
  270. package/.versions/0.0.10/scripts/lib/hermes-monitor-store.ts +2 -0
  271. package/.versions/0.0.10/scripts/lib/monitor-env.ts +120 -0
  272. package/.versions/0.0.10/scripts/lib/peer-launch.ts +314 -0
  273. package/.versions/0.0.10/scripts/lib/persona-banner.ts +62 -0
  274. package/.versions/0.0.10/scripts/lib/spawn-stagger.ts +101 -0
  275. package/.versions/0.0.10/scripts/lib/team-project.ts +193 -0
  276. package/.versions/0.0.10/scripts/lib/team-snapshot.ts +147 -0
  277. package/.versions/0.0.10/scripts/peer-banner.ts +40 -0
  278. package/.versions/0.0.10/scripts/peer-launch.ts +259 -0
  279. package/.versions/0.0.10/scripts/team-snapshot.ts +237 -0
  280. package/.versions/0.0.10/scripts/team-up.ts +360 -0
  281. package/.versions/0.0.10/skills/_internal/grilling.md +11 -0
  282. package/.versions/0.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  283. package/.versions/0.0.10/skills/code-review-and-quality/SKILL.md +381 -0
  284. package/.versions/0.0.10/skills/compound-learning/SKILL.md +137 -0
  285. package/.versions/0.0.10/skills/context-engineering/SKILL.md +291 -0
  286. package/.versions/0.0.10/skills/deprecation-and-migration/SKILL.md +206 -0
  287. package/.versions/0.0.10/skills/designing-agents/SKILL.md +394 -0
  288. package/.versions/0.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  289. package/.versions/0.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  290. package/.versions/0.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  291. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +226 -0
  292. package/.versions/0.0.10/skills/guided-workspace-setup/companion-manifest.json +38 -0
  293. package/.versions/0.0.10/skills/idea-refine/SKILL.md +182 -0
  294. package/.versions/0.0.10/skills/idea-refine/examples.md +238 -0
  295. package/.versions/0.0.10/skills/idea-refine/frameworks.md +99 -0
  296. package/.versions/0.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  297. package/.versions/0.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  298. package/.versions/0.0.10/skills/incremental-implementation/SKILL.md +287 -0
  299. package/.versions/0.0.10/skills/interview-me/SKILL.md +226 -0
  300. package/.versions/0.0.10/skills/orchestration-verification/SKILL.md +181 -0
  301. package/.versions/0.0.10/skills/peer-coms/SKILL.md +90 -0
  302. package/.versions/0.0.10/skills/performance-optimization/SKILL.md +350 -0
  303. package/.versions/0.0.10/skills/planning-and-task-breakdown/SKILL.md +254 -0
  304. package/.versions/0.0.10/skills/security-and-hardening/SKILL.md +461 -0
  305. package/.versions/0.0.10/skills/spec-driven-development/SKILL.md +257 -0
  306. package/.versions/0.0.10/skills/using-agent-skills/SKILL.md +199 -0
  307. package/.versions/0.0.10/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  308. package/.versions/0.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  309. package/.versions/0.0.10/vendor/agent-skills-upstream/README.md +11 -0
  310. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  311. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  312. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  313. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  314. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  315. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  316. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  317. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  318. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  319. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  320. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  321. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  322. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  323. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  324. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  325. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  326. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  327. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  328. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  329. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  330. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  331. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  332. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  333. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  334. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  335. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  336. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  337. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  338. package/.versions/0.0.9/.claude/commands/build.md +44 -0
  339. package/.versions/0.0.9/.claude/commands/code-simplify.md +22 -0
  340. package/.versions/0.0.9/.claude/commands/design-agent.md +14 -0
  341. package/.versions/0.0.9/.claude/commands/doctor-agent-fleet.md +17 -0
  342. package/.versions/0.0.9/.claude/commands/orchestrate.md +112 -0
  343. package/.versions/0.0.9/.claude/commands/plan.md +16 -0
  344. package/.versions/0.0.9/.claude/commands/prime.md +22 -0
  345. package/.versions/0.0.9/.claude/commands/review.md +16 -0
  346. package/.versions/0.0.9/.claude/commands/set-hermes-telegram.md +15 -0
  347. package/.versions/0.0.9/.claude/commands/set-hermes-watchdog.md +6 -0
  348. package/.versions/0.0.9/.claude/commands/setup-agent-fleet.md +25 -0
  349. package/.versions/0.0.9/.claude/commands/ship.md +72 -0
  350. package/.versions/0.0.9/.claude/commands/spec.md +15 -0
  351. package/.versions/0.0.9/.claude/commands/test.md +19 -0
  352. package/.versions/0.0.9/.claude/commands/webperf.md +32 -0
  353. package/.versions/0.0.9/.claude/orchestrate-teams.yaml +24 -0
  354. package/.versions/0.0.9/.opencode/commands/af-build.md +17 -0
  355. package/.versions/0.0.9/.opencode/commands/af-code-simplify.md +16 -0
  356. package/.versions/0.0.9/.opencode/commands/af-compound.md +16 -0
  357. package/.versions/0.0.9/.opencode/commands/af-design-agent.md +15 -0
  358. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  359. package/.versions/0.0.9/.opencode/commands/af-orchestrate.md +112 -0
  360. package/.versions/0.0.9/.opencode/commands/af-plan.md +16 -0
  361. package/.versions/0.0.9/.opencode/commands/af-prime.md +22 -0
  362. package/.versions/0.0.9/.opencode/commands/af-review.md +15 -0
  363. package/.versions/0.0.9/.opencode/commands/af-set-hermes-telegram.md +15 -0
  364. package/.versions/0.0.9/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  365. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +15 -0
  366. package/.versions/0.0.9/.opencode/commands/af-ship.md +16 -0
  367. package/.versions/0.0.9/.opencode/commands/af-spec.md +16 -0
  368. package/.versions/0.0.9/.opencode/commands/af-test.md +21 -0
  369. package/.versions/0.0.9/.opencode/commands/af-webperf.md +32 -0
  370. package/.versions/0.0.9/.opencode/orchestrate-teams.yaml +24 -0
  371. package/.versions/0.0.9/.pi/agents/dispatch-policy.yaml +32 -0
  372. package/.versions/0.0.9/.pi/agents/model-profiles.yaml +27 -0
  373. package/.versions/0.0.9/.pi/agents/peers.yaml +142 -0
  374. package/.versions/0.0.9/.pi/agents/teams.yaml +41 -0
  375. package/.versions/0.0.9/.pi/damage-control-rules.yaml +297 -0
  376. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  377. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  378. package/.versions/0.0.9/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  379. package/.versions/0.0.9/.pi/extensions/btw/README.md +118 -0
  380. package/.versions/0.0.9/.pi/extensions/btw/index.ts +917 -0
  381. package/.versions/0.0.9/.pi/extensions/btw/package.json +6 -0
  382. package/.versions/0.0.9/.pi/extensions/btw/state.js +179 -0
  383. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  384. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  385. package/.versions/0.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  386. package/.versions/0.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
  387. package/.versions/0.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
  388. package/.versions/0.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
  389. package/.versions/0.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
  390. package/.versions/0.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
  391. package/.versions/0.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
  392. package/.versions/0.0.9/.pi/extensions/package-lock.json +1143 -0
  393. package/.versions/0.0.9/.pi/extensions/package.json +9 -0
  394. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/README.md +201 -0
  395. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
  396. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  397. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
  398. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
  399. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  400. package/.versions/0.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  401. package/.versions/0.0.9/.pi/harnesses/agent-hub/README.md +872 -0
  402. package/.versions/0.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  403. package/.versions/0.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
  404. package/.versions/0.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  405. package/.versions/0.0.9/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  406. package/.versions/0.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
  407. package/.versions/0.0.9/.pi/harnesses/agent-hub/delegate.ts +435 -0
  408. package/.versions/0.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  409. package/.versions/0.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  410. package/.versions/0.0.9/.pi/harnesses/agent-hub/footer.ts +31 -0
  411. package/.versions/0.0.9/.pi/harnesses/agent-hub/helpers.ts +248 -0
  412. package/.versions/0.0.9/.pi/harnesses/agent-hub/index.ts +8702 -0
  413. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  414. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  415. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  416. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  417. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  418. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  419. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  420. package/.versions/0.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  421. package/.versions/0.0.9/.pi/harnesses/agent-hub/package.json +7 -0
  422. package/.versions/0.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  423. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-retention.js +34 -0
  424. package/.versions/0.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  425. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
  426. package/.versions/0.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
  427. package/.versions/0.0.9/.pi/harnesses/agent-hub/run-budget.js +181 -0
  428. package/.versions/0.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  429. package/.versions/0.0.9/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  430. package/.versions/0.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
  431. package/.versions/0.0.9/.pi/harnesses/agent-hub/spawn.ts +354 -0
  432. package/.versions/0.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
  433. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/README.md +19 -0
  434. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/index.ts +321 -0
  435. package/.versions/0.0.9/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  436. package/.versions/0.0.9/.pi/harnesses/coms/README.md +100 -0
  437. package/.versions/0.0.9/.pi/harnesses/coms/index.ts +1767 -0
  438. package/.versions/0.0.9/.pi/harnesses/coms/package.json +7 -0
  439. package/.versions/0.0.9/.pi/harnesses/coms/version.ts +42 -0
  440. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/README.md +124 -0
  441. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/index.ts +536 -0
  442. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
  443. package/.versions/0.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
  444. package/.versions/0.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  445. package/.versions/0.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  446. package/.versions/0.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
  447. package/.versions/0.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
  448. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  449. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  450. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  451. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  452. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  453. package/.versions/0.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  454. package/.versions/0.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
  455. package/.versions/0.0.9/.pi/harnesses/package-lock.json +35 -0
  456. package/.versions/0.0.9/.pi/harnesses/package.json +9 -0
  457. package/.versions/0.0.9/.pi/prompts/af-build.md +24 -0
  458. package/.versions/0.0.9/.pi/prompts/af-code-simplify.md +22 -0
  459. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  460. package/.versions/0.0.9/.pi/prompts/af-plan.md +16 -0
  461. package/.versions/0.0.9/.pi/prompts/af-review.md +16 -0
  462. package/.versions/0.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
  463. package/.versions/0.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  464. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +27 -0
  465. package/.versions/0.0.9/.pi/prompts/af-ship.md +17 -0
  466. package/.versions/0.0.9/.pi/prompts/af-spec.md +15 -0
  467. package/.versions/0.0.9/.pi/prompts/af-test.md +19 -0
  468. package/.versions/0.0.9/.pi/skills/bowser/SKILL.md +145 -0
  469. package/.versions/0.0.9/.version +1 -0
  470. package/.versions/0.0.9/agents/architect.md +24 -0
  471. package/.versions/0.0.9/agents/bowser.md +27 -0
  472. package/.versions/0.0.9/agents/builder.md +54 -0
  473. package/.versions/0.0.9/agents/code-reviewer.md +204 -0
  474. package/.versions/0.0.9/agents/deep-researcher.md +32 -0
  475. package/.versions/0.0.9/agents/documenter.md +18 -0
  476. package/.versions/0.0.9/agents/orchestrator.md +66 -0
  477. package/.versions/0.0.9/agents/plan-reviewer.md +62 -0
  478. package/.versions/0.0.9/agents/planner.md +70 -0
  479. package/.versions/0.0.9/agents/releaser.md +24 -0
  480. package/.versions/0.0.9/agents/researcher.md +28 -0
  481. package/.versions/0.0.9/agents/security-auditor.md +167 -0
  482. package/.versions/0.0.9/agents/test-engineer.md +153 -0
  483. package/.versions/0.0.9/agents/web-debugger.md +43 -0
  484. package/.versions/0.0.9/agents/web-performance-auditor.md +193 -0
  485. package/.versions/0.0.9/codex/CONDUCTOR.md +148 -0
  486. package/.versions/0.0.9/docs/ARCHITECTURE.md +262 -0
  487. package/.versions/0.0.9/docs/agent-fleet-setup.md +366 -0
  488. package/.versions/0.0.9/docs/claude-code-coms-bridge.md +109 -0
  489. package/.versions/0.0.9/docs/codex-remote-conductor.md +170 -0
  490. package/.versions/0.0.9/docs/coms-hermes-bridge.md +189 -0
  491. package/.versions/0.0.9/docs/getting-started.md +231 -0
  492. package/.versions/0.0.9/docs/npm-install.md +337 -0
  493. package/.versions/0.0.9/docs/opencode-setup.md +249 -0
  494. package/.versions/0.0.9/docs/pi-extensions.md +356 -0
  495. package/.versions/0.0.9/docs/pi-setup.md +476 -0
  496. package/.versions/0.0.9/docs/skill-anatomy.md +150 -0
  497. package/.versions/0.0.9/hermes/README.md +347 -0
  498. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  499. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  500. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  501. package/.versions/0.0.9/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  502. package/.versions/0.0.9/hermes/gates/gate-o-capability.md +8 -0
  503. package/.versions/0.0.9/hermes/gates/gate-o-validator-fixtures.json +1 -0
  504. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  505. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  506. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  507. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  508. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  509. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  510. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  511. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  512. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  513. package/.versions/0.0.9/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  514. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  515. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  516. package/.versions/0.0.9/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  517. package/.versions/0.0.9/hermes/skills/hub-conductor/SKILL.md +84 -0
  518. package/.versions/0.0.9/hermes/skills/hub-liaison/SKILL.md +84 -0
  519. package/.versions/0.0.9/hermes/skills/hub-watchdog/SKILL.md +76 -0
  520. package/.versions/0.0.9/hermes/skills/hub-watchdog/manifest.json +1 -0
  521. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  522. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  523. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  524. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  525. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  526. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  527. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  528. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  529. package/.versions/0.0.9/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  530. package/.versions/0.0.9/hermes/watchdog-tests/__init__.py +0 -0
  531. package/.versions/0.0.9/hooks/SIMPLIFY-IGNORE.md +90 -0
  532. package/.versions/0.0.9/hooks/coms-stop-hook.mjs +84 -0
  533. package/.versions/0.0.9/hooks/hooks.json +14 -0
  534. package/.versions/0.0.9/hooks/session-start.sh +74 -0
  535. package/.versions/0.0.9/hooks/simplify-ignore.sh +302 -0
  536. package/.versions/0.0.9/justfile +254 -0
  537. package/.versions/0.0.9/references/accessibility-checklist.md +160 -0
  538. package/.versions/0.0.9/references/definition-of-done.md +67 -0
  539. package/.versions/0.0.9/references/fleet-coordination-patterns.md +151 -0
  540. package/.versions/0.0.9/references/observability-checklist.md +91 -0
  541. package/.versions/0.0.9/references/orchestration-patterns.md +370 -0
  542. package/.versions/0.0.9/references/performance-checklist.md +153 -0
  543. package/.versions/0.0.9/references/prompting-patterns.md +380 -0
  544. package/.versions/0.0.9/references/security-checklist.md +179 -0
  545. package/.versions/0.0.9/references/testing-patterns.md +236 -0
  546. package/.versions/0.0.9/scripts/codex-conductor.ts +41 -0
  547. package/.versions/0.0.9/scripts/codex-remote-control.ts +167 -0
  548. package/.versions/0.0.9/scripts/coms-claude-bridge.ts +401 -0
  549. package/.versions/0.0.9/scripts/coms-cli.ts +484 -0
  550. package/.versions/0.0.9/scripts/coms-hermes-bridge.ts +413 -0
  551. package/.versions/0.0.9/scripts/fleet.ts +168 -0
  552. package/.versions/0.0.9/scripts/hermes-monitor-capability-runner.ts +25 -0
  553. package/.versions/0.0.9/scripts/hermes-monitor-scenario.ts +474 -0
  554. package/.versions/0.0.9/scripts/hermes-watchdog-capability-probe.ts +45 -0
  555. package/.versions/0.0.9/scripts/install-hermes-plugin.sh +180 -0
  556. package/.versions/0.0.9/scripts/lib/claude-bridge-core.ts +165 -0
  557. package/.versions/0.0.9/scripts/lib/codex-conductor.ts +88 -0
  558. package/.versions/0.0.9/scripts/lib/codex-remote-control.ts +480 -0
  559. package/.versions/0.0.9/scripts/lib/coms-envelope.ts +582 -0
  560. package/.versions/0.0.9/scripts/lib/fake-herdr-server.ts +88 -0
  561. package/.versions/0.0.9/scripts/lib/fleet-command.ts +111 -0
  562. package/.versions/0.0.9/scripts/lib/herdr-layout.ts +281 -0
  563. package/.versions/0.0.9/scripts/lib/hermes-bridge-core.ts +241 -0
  564. package/.versions/0.0.9/scripts/lib/hermes-monitor-events.ts +1 -0
  565. package/.versions/0.0.9/scripts/lib/hermes-monitor-herdr.ts +2 -0
  566. package/.versions/0.0.9/scripts/lib/hermes-monitor-model.ts +3 -0
  567. package/.versions/0.0.9/scripts/lib/hermes-monitor-registry.ts +2 -0
  568. package/.versions/0.0.9/scripts/lib/hermes-monitor-socket.ts +2 -0
  569. package/.versions/0.0.9/scripts/lib/hermes-monitor-store.ts +2 -0
  570. package/.versions/0.0.9/scripts/lib/monitor-env.ts +120 -0
  571. package/.versions/0.0.9/scripts/lib/peer-launch.ts +314 -0
  572. package/.versions/0.0.9/scripts/lib/persona-banner.ts +62 -0
  573. package/.versions/0.0.9/scripts/lib/spawn-stagger.ts +101 -0
  574. package/.versions/0.0.9/scripts/lib/team-project.ts +193 -0
  575. package/.versions/0.0.9/scripts/lib/team-snapshot.ts +147 -0
  576. package/.versions/0.0.9/scripts/peer-banner.ts +40 -0
  577. package/.versions/0.0.9/scripts/peer-launch.ts +259 -0
  578. package/.versions/0.0.9/scripts/team-snapshot.ts +237 -0
  579. package/.versions/0.0.9/scripts/team-up.ts +360 -0
  580. package/.versions/0.0.9/skills/_internal/grilling.md +11 -0
  581. package/.versions/0.0.9/skills/browser-testing-with-devtools/SKILL.md +352 -0
  582. package/.versions/0.0.9/skills/code-review-and-quality/SKILL.md +381 -0
  583. package/.versions/0.0.9/skills/compound-learning/SKILL.md +137 -0
  584. package/.versions/0.0.9/skills/context-engineering/SKILL.md +291 -0
  585. package/.versions/0.0.9/skills/deprecation-and-migration/SKILL.md +206 -0
  586. package/.versions/0.0.9/skills/designing-agents/SKILL.md +394 -0
  587. package/.versions/0.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
  588. package/.versions/0.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
  589. package/.versions/0.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
  590. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +544 -0
  591. package/.versions/0.0.9/skills/guided-workspace-setup/companion-manifest.json +38 -0
  592. package/.versions/0.0.9/skills/idea-refine/SKILL.md +182 -0
  593. package/.versions/0.0.9/skills/idea-refine/examples.md +238 -0
  594. package/.versions/0.0.9/skills/idea-refine/frameworks.md +99 -0
  595. package/.versions/0.0.9/skills/idea-refine/refinement-criteria.md +113 -0
  596. package/.versions/0.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
  597. package/.versions/0.0.9/skills/incremental-implementation/SKILL.md +287 -0
  598. package/.versions/0.0.9/skills/interview-me/SKILL.md +226 -0
  599. package/.versions/0.0.9/skills/orchestration-verification/SKILL.md +181 -0
  600. package/.versions/0.0.9/skills/peer-coms/SKILL.md +90 -0
  601. package/.versions/0.0.9/skills/performance-optimization/SKILL.md +350 -0
  602. package/.versions/0.0.9/skills/planning-and-task-breakdown/SKILL.md +236 -0
  603. package/.versions/0.0.9/skills/security-and-hardening/SKILL.md +461 -0
  604. package/.versions/0.0.9/skills/spec-driven-development/SKILL.md +245 -0
  605. package/.versions/0.0.9/skills/using-agent-skills/SKILL.md +199 -0
  606. package/.versions/0.0.9/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  607. package/.versions/0.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
  608. package/.versions/0.0.9/vendor/agent-skills-upstream/README.md +11 -0
  609. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  610. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  611. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  612. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  613. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  614. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  615. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  616. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  617. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  618. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  619. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  620. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  621. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  622. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  623. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  624. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  625. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  626. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  627. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  628. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  629. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  630. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  631. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  632. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  633. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  634. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  635. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  636. package/.versions/0.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  637. package/CHANGELOG.md +141 -0
  638. package/README.md +22 -5
  639. package/agents/architect.md +1 -0
  640. package/agents/bowser.md +1 -0
  641. package/agents/builder.md +1 -0
  642. package/agents/code-reviewer.md +8 -5
  643. package/agents/deep-researcher.md +2 -1
  644. package/agents/orchestrator.md +8 -1
  645. package/agents/plan-reviewer.md +25 -2
  646. package/agents/planner.md +3 -2
  647. package/agents/security-auditor.md +1 -0
  648. package/agents/test-engineer.md +3 -1
  649. package/agents/web-debugger.md +1 -0
  650. package/agents/web-performance-auditor.md +1 -0
  651. package/bin/build-manifest.js +68 -0
  652. package/bin/cli.js +679 -49
  653. package/bin/lib/apply.js +641 -0
  654. package/bin/lib/manifest.js +731 -0
  655. package/bin/lib/merge-forms.js +106 -0
  656. package/bin/lib/plan.js +569 -0
  657. package/bin/lib/state.js +213 -0
  658. package/bin/lib/verify.js +576 -0
  659. package/bin/snapshot-version.js +5 -0
  660. package/docs/ARCHITECTURE.md +53 -12
  661. package/docs/agent-fleet-setup.md +59 -48
  662. package/docs/getting-started.md +29 -6
  663. package/docs/npm-install.md +208 -31
  664. package/docs/opencode-setup.md +32 -0
  665. package/docs/pi-extensions.md +83 -13
  666. package/docs/pi-setup.md +164 -69
  667. package/install-manifest.json +3615 -0
  668. package/justfile +10 -1
  669. package/manifest-meta.json +472 -0
  670. package/package.json +8 -3
  671. package/scripts/fleet.ts +22 -3
  672. package/scripts/lib/fleet-command.ts +5 -3
  673. package/scripts/lib/herdr-layout.ts +18 -0
  674. package/scripts/lib/peer-launch.ts +314 -0
  675. package/scripts/lib/team-project.ts +3 -1
  676. package/scripts/peer-launch.ts +259 -0
  677. package/skills/browser-testing-with-devtools/SKILL.md +3 -4
  678. package/skills/guided-workspace-setup/SKILL.md +172 -490
  679. package/skills/guided-workspace-setup/companion-manifest.json +2 -0
  680. package/skills/planning-and-task-breakdown/SKILL.md +18 -0
  681. package/skills/spec-driven-development/SKILL.md +12 -0
  682. package/.pi/harnesses/agent-hub/spawned-peers.js +0 -74
@@ -0,0 +1,576 @@
1
+ // verify.js — read-only workspace inspection.
2
+ //
3
+ // Answers, without writing anything: what does this workspace have installed,
4
+ // how does it differ from the source, and what is broken? It is the shared
5
+ // computation behind `agent-fleet verify` and, from Phase 3 on, behind the
6
+ // planner — `plan()` is this pass plus a decision per item, and `apply()` is
7
+ // that plan executed. Keeping the state computation in one place is what stops
8
+ // setup and doctor from drifting apart.
9
+ //
10
+ // See plans/deterministic-installer-manifest-spec.md §4.1 for the state table.
11
+
12
+ import { existsSync, readFileSync, statSync } from "node:fs";
13
+ import { basename, join } from "node:path";
14
+
15
+ import { itemsForAgent } from "./manifest.js";
16
+ import { extractRegion, leafPaths, getPath, canonicalJson } from "./merge-forms.js";
17
+ import { transformPersona } from "./transform-persona.js";
18
+ import { runDoctor } from "./doctor.js";
19
+ import {
20
+ readState,
21
+ readLegacyRecord,
22
+ hashFile,
23
+ hashText,
24
+ walkTree,
25
+ inspectPath,
26
+ isInside,
27
+ isVolatileSourceRoot,
28
+ isAgentFleetCheckout,
29
+ STATE_SCHEMA_VERSION,
30
+ STATE_REL_PATH,
31
+ } from "./state.js";
32
+
33
+ export const VERIFY_SCHEMA_VERSION = 1;
34
+
35
+ // States that mean the workspace is broken, not merely behind. `outdated` and
36
+ // `modified` are reported but do not fail: an available upgrade and a
37
+ // deliberate local edit are both legitimate resting states.
38
+ export const BROKEN_STATES = new Set(["missing", "broken-link", "foreign-link", "conflict", "gone"]);
39
+
40
+ // Findings that describe a condition rather than a defect. They are printed,
41
+ // but they never fail the run — a workspace installed before `.versions/`
42
+ // retention, or one carrying a hand-edited overrides file, is not broken.
43
+ export const ADVISORY_FINDINGS = new Set([
44
+ "base-snapshot-missing",
45
+ "source-root-volatile",
46
+ "symlink-retired",
47
+ "retired-artifact",
48
+ "legacy-target",
49
+ "overrides",
50
+ "yaml-shape",
51
+ ]);
52
+
53
+ // Worst-wins ordering when a tree item's files disagree.
54
+ const SEVERITY = {
55
+ "not-applicable": 0,
56
+ "unchecked": 1,
57
+ "absent": 2,
58
+ "linked": 3,
59
+ "up-to-date": 4,
60
+ "outdated": 5,
61
+ "modified": 6,
62
+ "partial": 7,
63
+ "gone": 8,
64
+ "foreign-link": 9,
65
+ "broken-link": 10,
66
+ "missing": 11,
67
+ "conflict": 12,
68
+ };
69
+
70
+ /**
71
+ * Inspect a workspace against the manifest.
72
+ *
73
+ * @param {object} opts
74
+ * @param {string} opts.workspace target workspace (absolute)
75
+ * @param {string} opts.sourceRoot agent-fleet package root (absolute)
76
+ * @param {string} opts.packageVersion the running package's version
77
+ * @param {object} opts.manifest loaded install manifest
78
+ * @param {string} [opts.agent] override the recorded/detected agent
79
+ * @param {string} [opts.platform] process.platform, for platform-gated items
80
+ * @param {boolean} [opts.includeDoctor] run the legacy doctor scan too (default true)
81
+ * @returns {Promise<object>} report
82
+ */
83
+ export async function runVerify({
84
+ workspace,
85
+ sourceRoot,
86
+ packageVersion,
87
+ manifest,
88
+ agent = null,
89
+ platform = process.platform,
90
+ includeDoctor = true,
91
+ }) {
92
+ const state = readState(workspace);
93
+ const legacy = readLegacyRecord(workspace);
94
+ const resolvedAgent = agent ?? state?.agent ?? legacy?.agent ?? null;
95
+ const recordedVersion = state?.packageVersion ?? legacy?.version ?? null;
96
+ const stateSource = state ? "state-file" : legacy ? "legacy-record" : "none";
97
+
98
+ const findings = [];
99
+ const baseRoot = resolveBaseRoot(sourceRoot, recordedVersion);
100
+ const baseAvailable = Boolean(baseRoot);
101
+
102
+ if (state && state.schemaVersion !== STATE_SCHEMA_VERSION) {
103
+ findings.push({
104
+ type: "state-schema",
105
+ path: STATE_REL_PATH,
106
+ issue: `state schemaVersion ${state.schemaVersion}, this build speaks ${STATE_SCHEMA_VERSION}`,
107
+ fix: "upgrade agent-fleet, or re-run install to rewrite the state file",
108
+ });
109
+ }
110
+ if (state?.sourceRoot && !existsSync(state.sourceRoot)) {
111
+ findings.push({
112
+ type: "source-root-missing",
113
+ path: STATE_REL_PATH,
114
+ issue: `recorded source root no longer exists — ${state.sourceRoot}`,
115
+ fix: "re-run install from the current package to re-point the workspace",
116
+ });
117
+ }
118
+ if (state?.method === "symlink" && !isAgentFleetCheckout(workspace)) {
119
+ findings.push({
120
+ type: "symlink-retired",
121
+ path: STATE_REL_PATH,
122
+ issue: "installed with symlinks, which are now supported only inside an agent-fleet checkout",
123
+ fix: "run `agent-fleet install` or `upgrade` — linked items are re-materialised as copies",
124
+ });
125
+ } else if (state?.method === "symlink" && isVolatileSourceRoot(state.sourceRoot)) {
126
+ findings.push({
127
+ type: "source-root-volatile",
128
+ path: STATE_REL_PATH,
129
+ issue: "symlink install points into an npx cache — a cache clean breaks every link",
130
+ fix: "re-install with --method copy, or from a stable clone / global install",
131
+ });
132
+ }
133
+ if (recordedVersion && !baseAvailable) {
134
+ findings.push({
135
+ type: "base-snapshot-missing",
136
+ path: `.versions/${recordedVersion}`,
137
+ issue: "no snapshot for the recorded version — three-way merges degrade to two-way",
138
+ fix: "informational; the installed copy is treated as canonical on upgrade",
139
+ });
140
+ }
141
+
142
+ let items = [];
143
+ if (!resolvedAgent) {
144
+ findings.push({
145
+ type: "agent-unknown",
146
+ path: STATE_REL_PATH,
147
+ issue: "no recorded or detected coding agent — cannot resolve install targets",
148
+ fix: "re-run with --agent <claude-code|opencode|pi>",
149
+ });
150
+ } else {
151
+ items = evaluateWorkspace({
152
+ workspace, sourceRoot, manifest, agent: resolvedAgent, platform, state, baseRoot,
153
+ });
154
+ }
155
+
156
+ for (const entry of items) {
157
+ for (const rel of entry.legacyTargets ?? []) {
158
+ findings.push({
159
+ type: "legacy-target",
160
+ path: rel,
161
+ issue: `${entry.id} used to install here; the runtime still loads it`,
162
+ fix: `re-run install to retire it (kept if you edited it), or delete ${rel} by hand`,
163
+ });
164
+ }
165
+ if (entry.owned && entry.retired) {
166
+ findings.push({
167
+ type: "retired-artifact",
168
+ path: entry.target ?? entry.id,
169
+ issue: `${entry.id} was retired upstream`,
170
+ fix: "remove it with `agent-fleet uninstall`, or keep it deliberately",
171
+ });
172
+ }
173
+ }
174
+
175
+ if (includeDoctor) {
176
+ findings.push(...(await runDoctor({ workspace, sourceRoot })));
177
+ }
178
+ for (const f of findings) f.severity = ADVISORY_FINDINGS.has(f.type) ? "advisory" : "problem";
179
+
180
+ const byState = {};
181
+ for (const entry of items) byState[entry.state] = (byState[entry.state] ?? 0) + 1;
182
+
183
+ const broken = items.filter((i) => BROKEN_STATES.has(i.state));
184
+ const upgradable = items.filter((i) => i.state === "outdated");
185
+
186
+ return {
187
+ schemaVersion: VERIFY_SCHEMA_VERSION,
188
+ verb: "verify",
189
+ workspace,
190
+ sourceRoot,
191
+ agent: resolvedAgent,
192
+ packageVersion,
193
+ recordedVersion,
194
+ stateSource,
195
+ baseAvailable,
196
+ // The menu metadata travels with the report so a front-end needs exactly
197
+ // one command to build a selection screen: groups give it the headings and
198
+ // ordering, profiles the shortcuts, items the rows and their states.
199
+ groups: (manifest.groups ?? []).filter((g) => !resolvedAgent || (g.agents ?? []).includes(resolvedAgent)),
200
+ profiles: manifest.profiles ?? {},
201
+ items,
202
+ findings,
203
+ summary: {
204
+ total: items.length,
205
+ installed: items.filter((i) => i.owned).length,
206
+ present: items.filter(
207
+ (i) => !["absent", "not-applicable", "unchecked"].includes(i.state),
208
+ ).length,
209
+ broken: broken.length,
210
+ upgradable: upgradable.length,
211
+ findings: findings.length,
212
+ problems: findings.filter((f) => f.severity === "problem").length,
213
+ advisories: findings.filter((f) => f.severity === "advisory").length,
214
+ versionDrift: Boolean(recordedVersion && recordedVersion !== packageVersion),
215
+ byState,
216
+ },
217
+ };
218
+ }
219
+
220
+ /** True when the report should exit non-zero (code 2). Advisories do not count. */
221
+ export function hasDrift(report) {
222
+ return report.summary.problems > 0 || report.summary.broken > 0;
223
+ }
224
+
225
+ // ── per-item evaluation ─────────────────────────────────────────────────────
226
+
227
+ /**
228
+ * The three-way merge base for a workspace: the snapshot of the source tree at
229
+ * the version the workspace recorded. Null when there is no recorded version or
230
+ * the snapshot is gone (pre-`.versions/` install, or past retention) — callers
231
+ * degrade to a two-way comparison and say so.
232
+ *
233
+ * @returns {string|null} absolute path to `.versions/<recorded>`, or null
234
+ */
235
+ export function resolveBaseRoot(sourceRoot, recordedVersion) {
236
+ if (!recordedVersion) return null;
237
+ const path = join(sourceRoot, ".versions", recordedVersion);
238
+ return existsSync(path) ? path : null;
239
+ }
240
+
241
+ /**
242
+ * Evaluate every manifest item for one agent against the workspace. Shared by
243
+ * `verify` (which reports the result) and `plan` (which decides on it), so the
244
+ * two can never disagree about what state a file is in.
245
+ *
246
+ * Writes nothing.
247
+ *
248
+ * @param {object} opts
249
+ * @param {number} [opts.fileLimit] per-item cap on the reported `files` array.
250
+ * `verify` caps it for display; the planner passes Infinity because it needs
251
+ * every conflicting path to write the `.new` files in Phase 4.
252
+ * @returns {object[]} item evaluations, sorted by id
253
+ */
254
+ export function evaluateWorkspace({
255
+ workspace,
256
+ sourceRoot,
257
+ manifest,
258
+ agent,
259
+ platform = process.platform,
260
+ state = null,
261
+ baseRoot = null,
262
+ fileLimit = 20,
263
+ }) {
264
+ const items = [];
265
+ for (const item of itemsForAgent(manifest, agent)) {
266
+ if (item.platform !== "any" && item.platform !== platform) continue;
267
+ items.push(evaluateItem({
268
+ item,
269
+ binding: item.binding,
270
+ workspace,
271
+ sourceRoot,
272
+ baseRoot,
273
+ recorded: state?.items?.[item.id] ?? null,
274
+ fileLimit,
275
+ }));
276
+ }
277
+ return items.sort((a, b) => (a.id < b.id ? -1 : 1));
278
+ }
279
+
280
+ function evaluateItem({ item, binding, workspace, sourceRoot, baseRoot, recorded, fileLimit = 20 }) {
281
+ const base = {
282
+ id: item.id,
283
+ kind: item.kind,
284
+ group: item.group,
285
+ subcategory: item.subcategory ?? null,
286
+ title: item.title,
287
+ summary: item.summary ?? "",
288
+ recommended: item.recommended,
289
+ consent: item.consent,
290
+ target: binding.target,
291
+ owned: Boolean(recorded),
292
+ // How this item was last installed. The planner compares it against the
293
+ // requested method: content can be up to date while the *form* is wrong,
294
+ // and a copy is not a symlink however identical the bytes are.
295
+ recordedMethod: recorded?.method ?? null,
296
+ retired: Boolean(item.retired),
297
+ // The two consent classes the engine refuses to perform carry what the
298
+ // human needs instead — the exact commands, or the package spec. Without
299
+ // them a report of "operator step" is a dead end.
300
+ ...(item.operatorSteps ? { operatorSteps: item.operatorSteps } : {}),
301
+ ...(item.package?.spec ? { packageSpec: item.package.spec } : {}),
302
+ };
303
+
304
+ // Nothing on disk to compare: the engine never applies these itself.
305
+ if (["exec", "operator", "external"].includes(binding.strategy)) {
306
+ return { ...base, state: "not-applicable", detail: consentDetail(item) };
307
+ }
308
+
309
+ // Forms that share their file with the user: compare only our part of it.
310
+ if (binding.strategy === "managed-region") {
311
+ return { ...base, ...compareRegion({ binding, workspace, sourceRoot, baseRoot, recorded }) };
312
+ }
313
+ if (binding.strategy === "json-merge") {
314
+ return { ...base, ...compareJsonKeys({ binding, workspace, sourceRoot, baseRoot, recorded }) };
315
+ }
316
+
317
+ const pairs = expandBinding(binding, sourceRoot);
318
+ if (pairs.length === 0) {
319
+ return { ...base, state: "gone", detail: "no source for this item in the current package" };
320
+ }
321
+
322
+ const recordedHashes = new Map((recorded?.files ?? []).map((f) => [f.path, f.sha256]));
323
+ const agent = agentOf(item, binding);
324
+ const results = [];
325
+ const changed = [];
326
+
327
+ for (const pair of pairs) {
328
+ const targetAbs = join(workspace, pair.targetRel);
329
+ const found = inspectPath(targetAbs);
330
+
331
+ if (found.kind === "absent") {
332
+ results.push({ state: "absent" });
333
+ continue;
334
+ }
335
+ if (found.kind === "symlink") {
336
+ if (found.dangling) {
337
+ results.push({ state: "broken-link" });
338
+ changed.push({ path: pair.targetRel, state: "broken-link", detail: "link target does not exist" });
339
+ continue;
340
+ }
341
+ const recordedRoot = recorded?.sourceRoot ?? sourceRoot;
342
+ if (isInside(sourceRoot, found.linkTarget) || isInside(recordedRoot, found.linkTarget)) {
343
+ results.push({ state: "linked", linkTarget: found.linkTarget });
344
+ continue;
345
+ }
346
+ results.push({ state: "foreign-link" });
347
+ changed.push({
348
+ path: pair.targetRel,
349
+ state: "foreign-link",
350
+ detail: `resolves outside the source root — ${found.linkTarget}`,
351
+ });
352
+ continue;
353
+ }
354
+
355
+ const files = pair.isDir
356
+ ? walkTree(pair.sourceAbs).map((rel) => compareOne({
357
+ rel: `${pair.targetRel}/${rel}`,
358
+ ours: hashFile(join(targetAbs, rel)),
359
+ theirs: hashFile(join(pair.sourceAbs, rel)),
360
+ base: baseHashOf({ baseRoot, sourceRel: `${pair.sourceRel}/${rel}`, agent, transform: false }),
361
+ recorded: recordedHashes.get(`${pair.targetRel}/${rel}`) ?? null,
362
+ }))
363
+ : [compareOne({
364
+ rel: pair.targetRel,
365
+ ours: hashFile(targetAbs),
366
+ theirs: binding.strategy === "transform-persona"
367
+ ? transformedHash(pair.sourceAbs, agent)
368
+ : hashFile(pair.sourceAbs),
369
+ base: baseHashOf({
370
+ baseRoot,
371
+ sourceRel: pair.sourceRel,
372
+ agent,
373
+ transform: binding.strategy === "transform-persona",
374
+ }),
375
+ recorded: recordedHashes.get(pair.targetRel) ?? null,
376
+ })];
377
+
378
+ results.push({ state: worstOf(files.map((f) => f.state)) ?? "up-to-date", fileCount: files.length });
379
+ changed.push(...files.filter((f) => f.state !== "up-to-date"));
380
+ }
381
+
382
+ const absentPairs = results.filter((r) => r.state === "absent").length;
383
+ let state;
384
+ if (absentPairs === results.length) {
385
+ state = recorded ? "missing" : "absent";
386
+ } else {
387
+ state = worstOf(results.filter((r) => r.state !== "absent").map((r) => r.state)) ?? "up-to-date";
388
+ // Some pieces present, some not: broken if we installed it, merely
389
+ // incomplete if we did not.
390
+ if (absentPairs > 0) state = recorded ? "missing" : worstOf([state, "partial"]);
391
+ }
392
+
393
+ const out = {
394
+ ...base,
395
+ state,
396
+ fileCount: results.reduce((n, r) => n + (r.fileCount ?? 0), 0),
397
+ changedCount: changed.length,
398
+ };
399
+ // A path this item used to install to that is still occupied. The runtime
400
+ // does not know it is stale — pi will keep offering `/spec` from a legacy
401
+ // `.pi/prompts/spec.md` — so it is reported rather than merely cleaned up on
402
+ // the next apply.
403
+ const stale = (binding.legacyTargets ?? []).filter((rel) => existsSync(join(workspace, rel)));
404
+ if (stale.length > 0) out.legacyTargets = stale;
405
+ if (changed.length > 0) {
406
+ out.files = Number.isFinite(fileLimit) ? changed.slice(0, fileLimit) : changed;
407
+ }
408
+ if (state === "linked") out.linkTarget = results.find((r) => r.linkTarget)?.linkTarget;
409
+ if (!base.owned && state !== "absent") {
410
+ out.detail = "present but not recorded — agent-fleet did not install it";
411
+ }
412
+ return out;
413
+ }
414
+
415
+ /**
416
+ * Turn a binding into concrete (source → target) pairs.
417
+ *
418
+ * `sourceMode: "first"` treats `source` as an ordered candidate list and picks
419
+ * the first that exists (native skills shadowing the vendored copy).
420
+ * `sourceMode: "all"` installs every source, either under `target` by basename
421
+ * or — with `preserveLayout` — at its own repo-relative path.
422
+ */
423
+ export function expandBinding(binding, sourceRoot) {
424
+ const out = [];
425
+ const push = (sourceRel, targetRel) => {
426
+ const sourceAbs = join(sourceRoot, sourceRel);
427
+ if (!existsSync(sourceAbs)) return;
428
+ out.push({ sourceRel, sourceAbs, targetRel, isDir: statSync(sourceAbs).isDirectory() });
429
+ };
430
+
431
+ if (binding.sourceMode === "all") {
432
+ for (const rel of binding.source ?? []) {
433
+ push(rel, binding.preserveLayout ? rel : `${binding.target}/${basename(rel)}`);
434
+ }
435
+ return out;
436
+ }
437
+
438
+ const first = (binding.source ?? []).find((rel) => existsSync(join(sourceRoot, rel)));
439
+ if (first && binding.target) push(first, binding.target);
440
+ return out;
441
+ }
442
+
443
+ /**
444
+ * A managed region is compared as its sentinel-bounded block, never as the
445
+ * whole file — the user's other recipes are not drift.
446
+ */
447
+ function compareRegion({ binding, workspace, sourceRoot, baseRoot, recorded }) {
448
+ const blockOf = (path) => {
449
+ const found = extractRegion(readTextOrNull(path));
450
+ return found ? hashText(found.block) : null;
451
+ };
452
+ const theirs = blockOf(join(sourceRoot, binding.source?.[0] ?? ""));
453
+ if (theirs === null) return { state: "gone", detail: "no managed region in the current source" };
454
+
455
+ const targetAbs = join(workspace, binding.target);
456
+ if (!existsSync(targetAbs)) return { state: recorded ? "missing" : "absent" };
457
+
458
+ const ours = blockOf(targetAbs);
459
+ if (ours === null) {
460
+ return recorded
461
+ ? { state: "missing", detail: "the managed region is gone from the file" }
462
+ : { state: "absent", detail: "file exists but carries no agent-fleet region" };
463
+ }
464
+
465
+ const result = compareOne({
466
+ rel: binding.target,
467
+ ours,
468
+ theirs,
469
+ base: baseRoot ? blockOf(join(baseRoot, binding.source[0])) : null,
470
+ recorded: recorded?.files?.find((f) => f.path === binding.target)?.sha256 ?? null,
471
+ });
472
+ return result.state === "up-to-date"
473
+ ? { state: "up-to-date", fileCount: 1 }
474
+ : { state: result.state, fileCount: 1, changedCount: 1, files: [{ ...result, detail: "managed region" }] };
475
+ }
476
+
477
+ /**
478
+ * A JSON merge is compared key path by key path, so unrelated settings — user
479
+ * permissions, other hooks, third-party MCP servers — are never drift.
480
+ */
481
+ function compareJsonKeys({ binding, workspace, sourceRoot, baseRoot, recorded }) {
482
+ const fragment = readJsonOrNull(join(sourceRoot, binding.source?.[0] ?? ""));
483
+ if (!fragment) return { state: "gone", detail: "no merge fragment in the current source" };
484
+
485
+ const targetAbs = join(workspace, binding.target);
486
+ if (!existsSync(targetAbs)) return { state: recorded ? "missing" : "absent" };
487
+
488
+ const target = readJsonOrNull(targetAbs);
489
+ if (!target) return { state: "modified", detail: `${binding.target} is not valid JSON` };
490
+
491
+ const baseDoc = baseRoot ? readJsonOrNull(join(baseRoot, binding.source[0])) : null;
492
+ const recordedKeys = new Map((recorded?.jsonKeys ?? []).map((k) => [k.keyPath, k.sha256]));
493
+ const files = [];
494
+
495
+ for (const [path, value] of leafPaths(fragment)) {
496
+ const keyPath = path.join(".");
497
+ const present = getPath(target, path);
498
+ if (present === undefined) { files.push({ path: keyPath, state: "missing" }); continue; }
499
+ files.push(compareOne({
500
+ rel: keyPath,
501
+ ours: hashText(canonicalJson(present)),
502
+ theirs: hashText(canonicalJson(value)),
503
+ base: baseDoc ? hashText(canonicalJson(getPath(baseDoc, path))) : null,
504
+ recorded: recordedKeys.get(keyPath) ?? null,
505
+ }));
506
+ }
507
+
508
+ const changed = files.filter((f) => f.state !== "up-to-date");
509
+ const state = changed.length === 0
510
+ ? "up-to-date"
511
+ : (recorded ? worstOf(changed.map((f) => f.state)) : "absent");
512
+ return changed.length === 0
513
+ ? { state, fileCount: files.length }
514
+ : { state, fileCount: files.length, changedCount: changed.length, files: changed };
515
+ }
516
+
517
+ function readTextOrNull(path) {
518
+ try { return readFileSync(path, "utf8"); } catch { return null; }
519
+ }
520
+
521
+ function readJsonOrNull(path) {
522
+ try { return JSON.parse(readFileSync(path, "utf8")); } catch { return null; }
523
+ }
524
+
525
+ function compareOne({ rel, ours, theirs, base, recorded }) {
526
+ if (ours === null) return { path: rel, state: "missing" };
527
+ if (theirs === null) return { path: rel, state: "gone" };
528
+ if (ours === theirs) return { path: rel, state: "up-to-date" };
529
+
530
+ // Untracked file: we can say it differs from the source, nothing more.
531
+ if (!recorded) return { path: rel, state: "modified" };
532
+
533
+ if (ours === recorded) return { path: rel, state: "outdated" };
534
+ if (base === null) return { path: rel, state: "modified", detail: "no merge base" };
535
+ if (base === theirs) return { path: rel, state: "modified" };
536
+ return { path: rel, state: "conflict" };
537
+ }
538
+
539
+ function baseHashOf({ baseRoot, sourceRel, agent, transform }) {
540
+ if (!baseRoot) return null;
541
+ const path = join(baseRoot, sourceRel);
542
+ if (!existsSync(path)) return null;
543
+ return transform ? transformedHash(path, agent) : hashFile(path);
544
+ }
545
+
546
+ // Personas are generated, so "theirs" is the transform output — comparing the
547
+ // installed file against the raw canonical source would flag every persona as
548
+ // modified (SKILL.md step 6 makes the same point in prose).
549
+ function transformedHash(sourcePath, agent) {
550
+ if (!agent) return null;
551
+ try {
552
+ const { content } = transformPersona(readFileSync(sourcePath, "utf8"), { agent });
553
+ return hashText(content);
554
+ } catch { return null; }
555
+ }
556
+
557
+ function agentOf(item, binding) {
558
+ return Object.keys(item.agents ?? {}).find((a) => item.agents[a] === binding) ?? null;
559
+ }
560
+
561
+ function worstOf(states) {
562
+ let worst = null;
563
+ for (const s of states) {
564
+ if (worst === null || (SEVERITY[s] ?? 0) > (SEVERITY[worst] ?? 0)) worst = s;
565
+ }
566
+ return worst;
567
+ }
568
+
569
+ function consentDetail(item) {
570
+ switch (item.consent) {
571
+ case "operator": return "operator-applied — the engine reports steps, never performs them";
572
+ case "exec": return "runs a command; requires --allow-exec";
573
+ case "external": return `external package: ${item.package?.spec ?? "unknown"}`;
574
+ default: return "no workspace target";
575
+ }
576
+ }
@@ -64,6 +64,11 @@ const ARTIFACT_PATHS = [
64
64
  "docs/pi-setup.md",
65
65
  "references",
66
66
  "hooks",
67
+ // The generated catalogue. The upgrade three-way merge needs the *recorded
68
+ // version's* manifest, not just its files: an item that existed then and is
69
+ // retired now is only resolvable from the base catalogue.
70
+ "install-manifest.json",
71
+ "manifest-meta.json",
67
72
  ];
68
73
 
69
74
  if (existsSync(snapDir)) {
@@ -109,13 +109,45 @@ per process (`provider-semaphore.js`: 2 in flight for `custom/*` by default, unl
109
109
  elsewhere, `AGENT_HUB_PROVIDER_LIMITS` to override) — the cap is per level of the delegation
110
110
  tree, and a nested spawn reuses its parent's permit so it can never wait on its own ancestor.
111
111
  Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
112
- `max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`);
113
- switched live with `/af-hub-mode`.
114
-
115
- On top of the mode sit three qualitative guardrails. **Task triage**: the dispatcher
116
- classifies each turn via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
117
- and the caps drop to min(mode, tier); a duplicate-dispatch guard refuses near-identical
118
- re-dispatches within a turn. **Drift watchdog** (`drift-watchdog.js`): armed dispatches are
112
+ `max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`,
113
+ `run-history-keep`); switched live with `/af-hub-mode`.
114
+
115
+ A per-message allowance cannot bound a task, so a second envelope sits above the turn one:
116
+ the **task budget** (`run-budget.js`, `3×` the turn envelope) counts dispatches, research
117
+ runs and **active** time across the WHOLE task and is *not* reset by a user message. Active
118
+ time is turns that ran minus `ask_user` waits — a task clock that billed human idle would
119
+ false-stop a normal steered session, and a false stop teaches people to reset the window
120
+ reflexively. The auto-research pipe is exempt from the turn budget but charged against the
121
+ task envelope, so it cannot smuggle 8 helpers per dispatch past the outer bound. Exhausting
122
+ the task budget is a hard stop — only `/af-new-task` (or `set_task_tier` with
123
+ `new_task: true`) opens a new window. This is the guardrail the post-mortem run never hit: every steering message
124
+ reopened the turn window, so one workspace stayed open 47 hours on a change that took 13
125
+ minutes in a narrow one.
126
+
127
+ On top of the mode sit several qualitative guardrails. **Task triage**: the dispatcher
128
+ classifies the current TASK via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
129
+ and the caps drop to min(mode, tier). The tier is task-scoped and **ratcheted** — it survives
130
+ the user's next message, lowering is free, raising needs a stated `reason` — because a
131
+ turn-scoped tier reset to `feature` on every correction. Three refusals enforce
132
+ proportionality in code rather than prose: a duplicate-dispatch guard (near-identical
133
+ re-dispatches within a turn), a **tier persona gate** (`planner`, `plan-reviewer`,
134
+ `architect`, `security-auditor`, `deep-researcher` are refused at trivial/small — each opens
135
+ a document/finding loop), and a **review round cap** (review dispatches per task, by tier).
136
+ Skipping triage assumes `small`, not `feature`: the tier latches for the task, and the case
137
+ where it was never declared is exactly the case where proportionality was not being
138
+ considered. The review **finding** budget is the one thing deliberately left advisory — the
139
+ hub counts blocking findings (`review-findings.js`) and reports an over-budget return, but
140
+ never reclassifies one, because no rule it can evaluate separates an invented manifest from
141
+ a leaked credential; the round cap is what carries the enforcement.
142
+ **Docs lane** (`docs-lane.js`): a dispatch whose whole declared `scope` is documentation
143
+ refuses review personas (overridable with `review_reason`) and tells the dispatcher not to
144
+ open a review gate; an absent scope is never the lighter lane. **External-blocker stop**
145
+ (`external-blocker.js`): a specialist emits `EXTERNAL_BLOCKED: …` when it needs something
146
+ outside the fleet's reach (account, permission, credential, telemetry destination), and the
147
+ hub refuses the next dispatch with an owner-escalation packet until the human is addressed —
148
+ the alternative, observed, is hours spent approximating the missing fact with scripts,
149
+ manifests and fixtures while the assertion still ends UNPROVEN. **Drift watchdog**
150
+ (`drift-watchdog.js`): armed dispatches are
119
151
  observed in-flight from the JSON event stream — deterministic rules (out-of-scope writes
120
152
  against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
121
153
  escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
@@ -167,7 +199,7 @@ These are the external systems Agent Fleet assumes or integrates with — not np
167
199
  .pi/ # Pi runtime: harnesses, extensions, agents config, prompts
168
200
  skills/ # Agent Fleet-native skills (shadow vendored names)
169
201
  agents/ # Personas/subagents used by Agent Fleet
170
- scripts/ # CLI helpers, bridges, team launchers (pure logic in scripts/lib/)
202
+ scripts/ # CLI helpers, bridges, team + one-off peer launchers (pure logic in scripts/lib/)
171
203
  hermes/ # Hermes-facing skills/integration assets
172
204
  codex/ # Canonical Codex conductor contract (runtime copy lives outside checkout)
173
205
  systemd/user/ # Owned user-unit template for Codex remote control
@@ -214,10 +246,19 @@ packages/hermes-bridge/ # future Hermes integration package
214
246
  at 8 — an id nobody can trace back to a plan line costs a dispatch and an
215
247
  ASK_USER cycle to re-derive.
216
248
  - **Pre-flight validation is free.** Anything the hub can reject before spawning
217
- — an unresolvable artifact path, an unknown research persona — is refused
218
- without spending a turn-budget slot. Artifact paths also resolve across
219
- artifact kinds when the name is unique, since the hub writes every auto-return
220
- under `returns/` while dispatchers reasonably guess `reviews/`.
249
+ — an unresolvable artifact path, an unknown research persona, a heavy persona
250
+ at a low tier, a reviewer on a docs-only scope — is refused without spending a
251
+ budget slot. Artifact paths also resolve across artifact kinds when the name is
252
+ unique, since the hub writes every auto-return under `returns/` while
253
+ dispatchers reasonably guess `reviews/`.
254
+ - **Evidence is archived, never overwritten.** Session start moves the previous
255
+ session's `artifacts/` into an immutable `.pi/agent-sessions/runs/<runId>/`
256
+ namespace with a read-only `meta.json` and an appended `runs/index.json`
257
+ (`run-namespace.js`), retained per `run-history-keep` (default 10). The old
258
+ behaviour — delete `artifacts/` at start, name returns by a per-session counter
259
+ — collided two ways at once and made a post-mortem record eleven specialist
260
+ returns and two reviews as NOT RECOVERABLE. A failed archive leaves the
261
+ artifacts in place: a stale tree is recoverable, a deleted one is not.
221
262
  - **Herdr owns panes, presence, and lifecycle; coms owns messages.** Fleet
222
263
  recipes hard-require a running herdr server and refuse with an actionable
223
264
  message otherwise; non-fleet recipes never touch herdr.