@chankov/agent-fleet 0.0.5 → 0.0.7

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 (695) hide show
  1. package/.claude/commands/set-hermes-watchdog.md +6 -0
  2. package/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  3. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  4. package/.pi/extensions/btw/README.md +10 -10
  5. package/.pi/extensions/btw/index.ts +11 -11
  6. package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
  7. package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
  8. package/.pi/extensions/compact-and-continue/README.md +2 -2
  9. package/.pi/extensions/pi-voice-stt/README.md +7 -7
  10. package/.pi/extensions/pi-voice-stt/index.ts +4 -4
  11. package/.pi/harnesses/agent-hub/README.md +133 -74
  12. package/.pi/harnesses/agent-hub/artifacts.js +56 -2
  13. package/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  14. package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
  15. package/.pi/harnesses/agent-hub/context-window.js +106 -0
  16. package/.pi/harnesses/agent-hub/delegate.ts +61 -12
  17. package/.pi/harnesses/agent-hub/drift-watchdog.js +55 -9
  18. package/.pi/harnesses/agent-hub/helpers.ts +34 -0
  19. package/.pi/harnesses/agent-hub/index.ts +970 -406
  20. package/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  21. package/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  22. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +2 -2
  23. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -11
  24. package/.pi/harnesses/agent-hub/package.json +1 -1
  25. package/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  26. package/.pi/harnesses/agent-hub/return-contract.js +78 -0
  27. package/.pi/harnesses/agent-hub/return-extract.js +75 -0
  28. package/.pi/harnesses/agent-hub/run-budget.js +30 -4
  29. package/.pi/harnesses/agent-hub/session-health.js +110 -0
  30. package/.pi/harnesses/agent-hub/spawn.ts +109 -1
  31. package/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  32. package/.pi/harnesses/coms/README.md +6 -5
  33. package/.pi/harnesses/coms/index.ts +92 -70
  34. package/.pi/harnesses/coms/package.json +1 -1
  35. package/.pi/harnesses/damage-control-continue/README.md +9 -9
  36. package/.pi/harnesses/damage-control-continue/index.ts +11 -11
  37. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  38. package/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  39. package/.pi/harnesses/lib/herdr-client.ts +7 -2
  40. package/.pi/harnesses/lib/herdr-presence.ts +141 -30
  41. package/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  42. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  43. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  44. package/.pi/harnesses/lib/hermes-monitor-socket.ts +47 -2
  45. package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
  46. package/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  47. package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
  48. package/.versions/0.0.6/.claude/commands/build.md +44 -0
  49. package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
  50. package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
  51. package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
  52. package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
  53. package/.versions/0.0.6/.claude/commands/plan.md +16 -0
  54. package/.versions/0.0.6/.claude/commands/prime.md +22 -0
  55. package/.versions/0.0.6/.claude/commands/review.md +16 -0
  56. package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
  57. package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
  58. package/.versions/0.0.6/.claude/commands/ship.md +72 -0
  59. package/.versions/0.0.6/.claude/commands/spec.md +15 -0
  60. package/.versions/0.0.6/.claude/commands/test.md +19 -0
  61. package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
  62. package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
  63. package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
  64. package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
  65. package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
  66. package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
  67. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  68. package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
  69. package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
  70. package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
  71. package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
  72. package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
  73. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
  74. package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
  75. package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
  76. package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
  77. package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
  78. package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
  79. package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  80. package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
  81. package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
  82. package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
  83. package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
  84. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  85. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  86. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  87. package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
  88. package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
  89. package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
  90. package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
  91. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  92. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  93. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  94. package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  95. package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  96. package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  97. package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  98. package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  99. package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  100. package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
  101. package/.versions/0.0.6/.pi/extensions/package.json +9 -0
  102. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
  103. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  104. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  105. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  106. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  107. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  108. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  109. package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
  110. package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  111. package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
  112. package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  113. package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
  114. package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  115. package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  116. package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
  117. package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
  118. package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
  119. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  120. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  121. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  122. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  123. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  124. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  125. package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  126. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
  127. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  128. package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
  129. package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
  130. package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  131. package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  132. package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
  133. package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
  134. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
  135. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
  136. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  137. package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
  138. package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
  139. package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
  140. package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
  141. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
  142. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  143. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  144. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
  145. package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  146. package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
  147. package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
  148. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  149. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  150. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  151. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  152. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  153. package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
  154. package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
  155. package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
  156. package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
  157. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  158. package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
  159. package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
  160. package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  161. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
  162. package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
  163. package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
  164. package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
  165. package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
  166. package/.versions/0.0.6/.version +1 -0
  167. package/.versions/0.0.6/agents/architect.md +23 -0
  168. package/.versions/0.0.6/agents/bowser.md +26 -0
  169. package/.versions/0.0.6/agents/builder.md +53 -0
  170. package/.versions/0.0.6/agents/code-reviewer.md +205 -0
  171. package/.versions/0.0.6/agents/deep-researcher.md +31 -0
  172. package/.versions/0.0.6/agents/documenter.md +18 -0
  173. package/.versions/0.0.6/agents/orchestrator.md +54 -0
  174. package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
  175. package/.versions/0.0.6/agents/planner.md +69 -0
  176. package/.versions/0.0.6/agents/releaser.md +24 -0
  177. package/.versions/0.0.6/agents/researcher.md +28 -0
  178. package/.versions/0.0.6/agents/security-auditor.md +166 -0
  179. package/.versions/0.0.6/agents/test-engineer.md +151 -0
  180. package/.versions/0.0.6/agents/web-debugger.md +42 -0
  181. package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
  182. package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
  183. package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
  184. package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
  185. package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
  186. package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
  187. package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
  188. package/.versions/0.0.6/docs/getting-started.md +183 -0
  189. package/.versions/0.0.6/docs/npm-install.md +337 -0
  190. package/.versions/0.0.6/docs/opencode-setup.md +249 -0
  191. package/.versions/0.0.6/docs/pi-extensions.md +293 -0
  192. package/.versions/0.0.6/docs/pi-setup.md +476 -0
  193. package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
  194. package/.versions/0.0.6/hermes/README.md +231 -0
  195. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  196. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  197. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  198. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  199. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  200. package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  201. package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  202. package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
  203. package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
  204. package/.versions/0.0.6/hooks/hooks.json +14 -0
  205. package/.versions/0.0.6/hooks/session-start.sh +74 -0
  206. package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
  207. package/.versions/0.0.6/justfile +245 -0
  208. package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
  209. package/.versions/0.0.6/references/definition-of-done.md +67 -0
  210. package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
  211. package/.versions/0.0.6/references/observability-checklist.md +91 -0
  212. package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
  213. package/.versions/0.0.6/references/performance-checklist.md +153 -0
  214. package/.versions/0.0.6/references/prompting-patterns.md +380 -0
  215. package/.versions/0.0.6/references/security-checklist.md +179 -0
  216. package/.versions/0.0.6/references/testing-patterns.md +236 -0
  217. package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
  218. package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
  219. package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
  220. package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
  221. package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
  222. package/.versions/0.0.6/scripts/fleet.ts +141 -0
  223. package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  224. package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
  225. package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
  226. package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
  227. package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
  228. package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
  229. package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  230. package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
  231. package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
  232. package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  233. package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  234. package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  235. package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  236. package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  237. package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  238. package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
  239. package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
  240. package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
  241. package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
  242. package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
  243. package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
  244. package/.versions/0.0.6/scripts/team-up.ts +351 -0
  245. package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
  246. package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
  247. package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  248. package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
  249. package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
  250. package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  251. package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
  252. package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  253. package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  254. package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  255. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
  256. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
  257. package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
  258. package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
  259. package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
  260. package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  261. package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  262. package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
  263. package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
  264. package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
  265. package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
  266. package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
  267. package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
  268. package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
  269. package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
  270. package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
  271. package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  272. package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  273. package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
  274. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  275. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  276. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  277. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  278. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  279. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  280. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  281. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  282. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  283. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  284. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  285. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  286. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  287. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  288. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  289. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  290. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  291. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  292. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  293. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  294. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  295. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  296. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  297. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  298. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  299. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  300. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  301. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  302. package/.versions/0.0.7/.claude/commands/build.md +44 -0
  303. package/.versions/0.0.7/.claude/commands/code-simplify.md +22 -0
  304. package/.versions/0.0.7/.claude/commands/design-agent.md +14 -0
  305. package/.versions/0.0.7/.claude/commands/doctor-agent-fleet.md +17 -0
  306. package/.versions/0.0.7/.claude/commands/orchestrate.md +112 -0
  307. package/.versions/0.0.7/.claude/commands/plan.md +16 -0
  308. package/.versions/0.0.7/.claude/commands/prime.md +22 -0
  309. package/.versions/0.0.7/.claude/commands/review.md +16 -0
  310. package/.versions/0.0.7/.claude/commands/set-hermes-telegram.md +15 -0
  311. package/.versions/0.0.7/.claude/commands/set-hermes-watchdog.md +6 -0
  312. package/.versions/0.0.7/.claude/commands/setup-agent-fleet.md +25 -0
  313. package/.versions/0.0.7/.claude/commands/ship.md +72 -0
  314. package/.versions/0.0.7/.claude/commands/spec.md +15 -0
  315. package/.versions/0.0.7/.claude/commands/test.md +19 -0
  316. package/.versions/0.0.7/.claude/commands/webperf.md +32 -0
  317. package/.versions/0.0.7/.claude/orchestrate-teams.yaml +24 -0
  318. package/.versions/0.0.7/.opencode/commands/af-build.md +17 -0
  319. package/.versions/0.0.7/.opencode/commands/af-code-simplify.md +16 -0
  320. package/.versions/0.0.7/.opencode/commands/af-compound.md +16 -0
  321. package/.versions/0.0.7/.opencode/commands/af-design-agent.md +15 -0
  322. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  323. package/.versions/0.0.7/.opencode/commands/af-orchestrate.md +112 -0
  324. package/.versions/0.0.7/.opencode/commands/af-plan.md +16 -0
  325. package/.versions/0.0.7/.opencode/commands/af-prime.md +22 -0
  326. package/.versions/0.0.7/.opencode/commands/af-review.md +15 -0
  327. package/.versions/0.0.7/.opencode/commands/af-set-hermes-telegram.md +15 -0
  328. package/.versions/0.0.7/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  329. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +15 -0
  330. package/.versions/0.0.7/.opencode/commands/af-ship.md +16 -0
  331. package/.versions/0.0.7/.opencode/commands/af-spec.md +16 -0
  332. package/.versions/0.0.7/.opencode/commands/af-test.md +21 -0
  333. package/.versions/0.0.7/.opencode/commands/af-webperf.md +32 -0
  334. package/.versions/0.0.7/.opencode/orchestrate-teams.yaml +24 -0
  335. package/.versions/0.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  336. package/.versions/0.0.7/.pi/agents/model-profiles.yaml +20 -0
  337. package/.versions/0.0.7/.pi/agents/peers.yaml +146 -0
  338. package/.versions/0.0.7/.pi/agents/teams.yaml +39 -0
  339. package/.versions/0.0.7/.pi/damage-control-rules.yaml +297 -0
  340. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  341. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  342. package/.versions/0.0.7/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  343. package/.versions/0.0.7/.pi/extensions/btw/README.md +118 -0
  344. package/.versions/0.0.7/.pi/extensions/btw/index.ts +917 -0
  345. package/.versions/0.0.7/.pi/extensions/btw/package.json +6 -0
  346. package/.versions/0.0.7/.pi/extensions/btw/state.js +179 -0
  347. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  348. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  349. package/.versions/0.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  350. package/.versions/0.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  351. package/.versions/0.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  352. package/.versions/0.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  353. package/.versions/0.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  354. package/.versions/0.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  355. package/.versions/0.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  356. package/.versions/0.0.7/.pi/extensions/package-lock.json +1143 -0
  357. package/.versions/0.0.7/.pi/extensions/package.json +9 -0
  358. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/README.md +201 -0
  359. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  360. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  361. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  362. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  363. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  364. package/.versions/0.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  365. package/.versions/0.0.7/.pi/harnesses/agent-hub/README.md +857 -0
  366. package/.versions/0.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  367. package/.versions/0.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  368. package/.versions/0.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  369. package/.versions/0.0.7/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  370. package/.versions/0.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  371. package/.versions/0.0.7/.pi/harnesses/agent-hub/delegate.ts +435 -0
  372. package/.versions/0.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  373. package/.versions/0.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  374. package/.versions/0.0.7/.pi/harnesses/agent-hub/footer.ts +29 -0
  375. package/.versions/0.0.7/.pi/harnesses/agent-hub/helpers.ts +248 -0
  376. package/.versions/0.0.7/.pi/harnesses/agent-hub/index.ts +8609 -0
  377. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  378. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  379. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  380. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  381. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  382. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  383. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  384. package/.versions/0.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  385. package/.versions/0.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  386. package/.versions/0.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  387. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-retention.js +34 -0
  388. package/.versions/0.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  389. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  390. package/.versions/0.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  391. package/.versions/0.0.7/.pi/harnesses/agent-hub/run-budget.js +181 -0
  392. package/.versions/0.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  393. package/.versions/0.0.7/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  394. package/.versions/0.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  395. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawn.ts +354 -0
  396. package/.versions/0.0.7/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  397. package/.versions/0.0.7/.pi/harnesses/agent-hub/version.ts +18 -0
  398. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/README.md +19 -0
  399. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/index.ts +321 -0
  400. package/.versions/0.0.7/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  401. package/.versions/0.0.7/.pi/harnesses/coms/README.md +93 -0
  402. package/.versions/0.0.7/.pi/harnesses/coms/index.ts +1767 -0
  403. package/.versions/0.0.7/.pi/harnesses/coms/package.json +7 -0
  404. package/.versions/0.0.7/.pi/harnesses/coms/version.ts +18 -0
  405. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/README.md +117 -0
  406. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/index.ts +536 -0
  407. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  408. package/.versions/0.0.7/.pi/harnesses/damage-control-continue/version.ts +18 -0
  409. package/.versions/0.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  410. package/.versions/0.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  411. package/.versions/0.0.7/.pi/harnesses/lib/herdr-client.ts +463 -0
  412. package/.versions/0.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  413. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  414. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  415. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  416. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  417. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  418. package/.versions/0.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  419. package/.versions/0.0.7/.pi/harnesses/package-lock.json +35 -0
  420. package/.versions/0.0.7/.pi/harnesses/package.json +9 -0
  421. package/.versions/0.0.7/.pi/prompts/af-build.md +24 -0
  422. package/.versions/0.0.7/.pi/prompts/af-code-simplify.md +22 -0
  423. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  424. package/.versions/0.0.7/.pi/prompts/af-plan.md +16 -0
  425. package/.versions/0.0.7/.pi/prompts/af-review.md +16 -0
  426. package/.versions/0.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  427. package/.versions/0.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  428. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +27 -0
  429. package/.versions/0.0.7/.pi/prompts/af-ship.md +17 -0
  430. package/.versions/0.0.7/.pi/prompts/af-spec.md +15 -0
  431. package/.versions/0.0.7/.pi/prompts/af-test.md +19 -0
  432. package/.versions/0.0.7/.pi/skills/bowser/SKILL.md +145 -0
  433. package/.versions/0.0.7/.version +1 -0
  434. package/.versions/0.0.7/agents/architect.md +23 -0
  435. package/.versions/0.0.7/agents/bowser.md +26 -0
  436. package/.versions/0.0.7/agents/builder.md +53 -0
  437. package/.versions/0.0.7/agents/code-reviewer.md +205 -0
  438. package/.versions/0.0.7/agents/deep-researcher.md +31 -0
  439. package/.versions/0.0.7/agents/documenter.md +18 -0
  440. package/.versions/0.0.7/agents/orchestrator.md +65 -0
  441. package/.versions/0.0.7/agents/plan-reviewer.md +60 -0
  442. package/.versions/0.0.7/agents/planner.md +69 -0
  443. package/.versions/0.0.7/agents/releaser.md +24 -0
  444. package/.versions/0.0.7/agents/researcher.md +28 -0
  445. package/.versions/0.0.7/agents/security-auditor.md +166 -0
  446. package/.versions/0.0.7/agents/test-engineer.md +151 -0
  447. package/.versions/0.0.7/agents/web-debugger.md +42 -0
  448. package/.versions/0.0.7/agents/web-performance-auditor.md +192 -0
  449. package/.versions/0.0.7/codex/CONDUCTOR.md +148 -0
  450. package/.versions/0.0.7/docs/ARCHITECTURE.md +262 -0
  451. package/.versions/0.0.7/docs/agent-fleet-setup.md +366 -0
  452. package/.versions/0.0.7/docs/claude-code-coms-bridge.md +109 -0
  453. package/.versions/0.0.7/docs/codex-remote-conductor.md +170 -0
  454. package/.versions/0.0.7/docs/coms-hermes-bridge.md +189 -0
  455. package/.versions/0.0.7/docs/getting-started.md +231 -0
  456. package/.versions/0.0.7/docs/npm-install.md +337 -0
  457. package/.versions/0.0.7/docs/opencode-setup.md +249 -0
  458. package/.versions/0.0.7/docs/pi-extensions.md +293 -0
  459. package/.versions/0.0.7/docs/pi-setup.md +476 -0
  460. package/.versions/0.0.7/docs/skill-anatomy.md +150 -0
  461. package/.versions/0.0.7/hermes/README.md +347 -0
  462. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  463. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  464. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  465. package/.versions/0.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  466. package/.versions/0.0.7/hermes/gates/gate-o-capability.md +8 -0
  467. package/.versions/0.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  468. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  469. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  470. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  471. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  472. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  473. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  474. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  475. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  476. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  477. package/.versions/0.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  478. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  479. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  480. package/.versions/0.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  481. package/.versions/0.0.7/hermes/skills/hub-conductor/SKILL.md +84 -0
  482. package/.versions/0.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  483. package/.versions/0.0.7/hermes/skills/hub-watchdog/SKILL.md +76 -0
  484. package/.versions/0.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  485. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  486. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  487. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  488. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  489. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  490. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  491. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  492. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  493. package/.versions/0.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  494. package/.versions/0.0.7/hermes/watchdog-tests/__init__.py +0 -0
  495. package/.versions/0.0.7/hooks/SIMPLIFY-IGNORE.md +90 -0
  496. package/.versions/0.0.7/hooks/coms-stop-hook.mjs +84 -0
  497. package/.versions/0.0.7/hooks/hooks.json +14 -0
  498. package/.versions/0.0.7/hooks/session-start.sh +74 -0
  499. package/.versions/0.0.7/hooks/simplify-ignore.sh +302 -0
  500. package/.versions/0.0.7/justfile +245 -0
  501. package/.versions/0.0.7/references/accessibility-checklist.md +160 -0
  502. package/.versions/0.0.7/references/definition-of-done.md +67 -0
  503. package/.versions/0.0.7/references/fleet-coordination-patterns.md +151 -0
  504. package/.versions/0.0.7/references/observability-checklist.md +91 -0
  505. package/.versions/0.0.7/references/orchestration-patterns.md +370 -0
  506. package/.versions/0.0.7/references/performance-checklist.md +153 -0
  507. package/.versions/0.0.7/references/prompting-patterns.md +380 -0
  508. package/.versions/0.0.7/references/security-checklist.md +179 -0
  509. package/.versions/0.0.7/references/testing-patterns.md +236 -0
  510. package/.versions/0.0.7/scripts/codex-conductor.ts +41 -0
  511. package/.versions/0.0.7/scripts/codex-remote-control.ts +167 -0
  512. package/.versions/0.0.7/scripts/coms-claude-bridge.ts +401 -0
  513. package/.versions/0.0.7/scripts/coms-cli.ts +484 -0
  514. package/.versions/0.0.7/scripts/coms-hermes-bridge.ts +413 -0
  515. package/.versions/0.0.7/scripts/fleet.ts +149 -0
  516. package/.versions/0.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  517. package/.versions/0.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  518. package/.versions/0.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  519. package/.versions/0.0.7/scripts/install-hermes-plugin.sh +180 -0
  520. package/.versions/0.0.7/scripts/lib/claude-bridge-core.ts +165 -0
  521. package/.versions/0.0.7/scripts/lib/codex-conductor.ts +88 -0
  522. package/.versions/0.0.7/scripts/lib/codex-remote-control.ts +480 -0
  523. package/.versions/0.0.7/scripts/lib/coms-envelope.ts +582 -0
  524. package/.versions/0.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  525. package/.versions/0.0.7/scripts/lib/fleet-command.ts +109 -0
  526. package/.versions/0.0.7/scripts/lib/herdr-layout.ts +263 -0
  527. package/.versions/0.0.7/scripts/lib/hermes-bridge-core.ts +241 -0
  528. package/.versions/0.0.7/scripts/lib/hermes-monitor-events.ts +1 -0
  529. package/.versions/0.0.7/scripts/lib/hermes-monitor-herdr.ts +2 -0
  530. package/.versions/0.0.7/scripts/lib/hermes-monitor-model.ts +3 -0
  531. package/.versions/0.0.7/scripts/lib/hermes-monitor-registry.ts +2 -0
  532. package/.versions/0.0.7/scripts/lib/hermes-monitor-socket.ts +2 -0
  533. package/.versions/0.0.7/scripts/lib/hermes-monitor-store.ts +2 -0
  534. package/.versions/0.0.7/scripts/lib/monitor-env.ts +120 -0
  535. package/.versions/0.0.7/scripts/lib/persona-banner.ts +62 -0
  536. package/.versions/0.0.7/scripts/lib/spawn-stagger.ts +101 -0
  537. package/.versions/0.0.7/scripts/lib/team-project.ts +191 -0
  538. package/.versions/0.0.7/scripts/lib/team-snapshot.ts +147 -0
  539. package/.versions/0.0.7/scripts/peer-banner.ts +40 -0
  540. package/.versions/0.0.7/scripts/team-snapshot.ts +237 -0
  541. package/.versions/0.0.7/scripts/team-up.ts +360 -0
  542. package/.versions/0.0.7/skills/_internal/grilling.md +11 -0
  543. package/.versions/0.0.7/skills/browser-testing-with-devtools/SKILL.md +352 -0
  544. package/.versions/0.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  545. package/.versions/0.0.7/skills/compound-learning/SKILL.md +137 -0
  546. package/.versions/0.0.7/skills/context-engineering/SKILL.md +291 -0
  547. package/.versions/0.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  548. package/.versions/0.0.7/skills/designing-agents/SKILL.md +394 -0
  549. package/.versions/0.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  550. package/.versions/0.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  551. package/.versions/0.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  552. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +544 -0
  553. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +35 -0
  554. package/.versions/0.0.7/skills/idea-refine/SKILL.md +182 -0
  555. package/.versions/0.0.7/skills/idea-refine/examples.md +238 -0
  556. package/.versions/0.0.7/skills/idea-refine/frameworks.md +99 -0
  557. package/.versions/0.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  558. package/.versions/0.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  559. package/.versions/0.0.7/skills/incremental-implementation/SKILL.md +287 -0
  560. package/.versions/0.0.7/skills/interview-me/SKILL.md +226 -0
  561. package/.versions/0.0.7/skills/orchestration-verification/SKILL.md +181 -0
  562. package/.versions/0.0.7/skills/peer-coms/SKILL.md +90 -0
  563. package/.versions/0.0.7/skills/performance-optimization/SKILL.md +350 -0
  564. package/.versions/0.0.7/skills/planning-and-task-breakdown/SKILL.md +236 -0
  565. package/.versions/0.0.7/skills/security-and-hardening/SKILL.md +461 -0
  566. package/.versions/0.0.7/skills/spec-driven-development/SKILL.md +245 -0
  567. package/.versions/0.0.7/skills/using-agent-skills/SKILL.md +199 -0
  568. package/.versions/0.0.7/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  569. package/.versions/0.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  570. package/.versions/0.0.7/vendor/agent-skills-upstream/README.md +11 -0
  571. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  572. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  573. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  574. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  575. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  576. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  577. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  578. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  579. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  580. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  581. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  582. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  583. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  584. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  585. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  586. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  587. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  588. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  589. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  590. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  591. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  592. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  593. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  594. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  595. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  596. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  597. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  598. package/.versions/0.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  599. package/CHANGELOG.md +140 -0
  600. package/README.md +198 -40
  601. package/agents/code-reviewer.md +2 -2
  602. package/agents/documenter.md +1 -1
  603. package/agents/orchestrator.md +11 -0
  604. package/agents/plan-reviewer.md +1 -1
  605. package/agents/planner.md +1 -1
  606. package/agents/releaser.md +1 -1
  607. package/agents/security-auditor.md +1 -1
  608. package/bin/cli.js +60 -21
  609. package/bin/lib/bootstrap.js +16 -16
  610. package/bin/lib/doctor.js +1 -1
  611. package/bin/lib/hermes-profile-artifact.js +144 -0
  612. package/bin/lib/set-hermes-watchdog.js +173 -0
  613. package/bin/set-hermes-watchdog.js +26 -0
  614. package/docs/ARCHITECTURE.md +67 -15
  615. package/docs/agent-fleet-setup.md +13 -13
  616. package/docs/claude-code-coms-bridge.md +7 -1
  617. package/docs/coms-hermes-bridge.md +18 -8
  618. package/docs/getting-started.md +48 -0
  619. package/docs/hermes-watchdog-supervisor.md +140 -0
  620. package/docs/npm-install.md +21 -21
  621. package/docs/pi-extensions.md +7 -7
  622. package/docs/pi-setup.md +51 -47
  623. package/hermes/README.md +135 -19
  624. package/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  625. package/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  626. package/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  627. package/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  628. package/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  629. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  630. package/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  631. package/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  632. package/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  633. package/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  634. package/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  635. package/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  636. package/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  637. package/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  638. package/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  639. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +10 -0
  640. package/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  641. package/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  642. package/hermes/skills/hub-watchdog/SKILL.md +76 -0
  643. package/hermes/skills/hub-watchdog/manifest.json +1 -0
  644. package/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  645. package/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  646. package/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  647. package/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  648. package/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  649. package/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  650. package/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  651. package/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  652. package/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  653. package/hooks/coms-stop-hook.mjs +12 -1
  654. package/package.json +11 -2
  655. package/references/fleet-coordination-patterns.md +2 -2
  656. package/scripts/coms-claude-bridge.ts +154 -39
  657. package/scripts/fleet.ts +9 -1
  658. package/scripts/hermes-watchdog-capability-probe.ts +45 -0
  659. package/scripts/lib/claude-bridge-core.ts +65 -0
  660. package/scripts/lib/coms-envelope.ts +44 -1
  661. package/scripts/lib/hermes-monitor-events.ts +1 -0
  662. package/scripts/lib/monitor-env.ts +120 -0
  663. package/scripts/team-snapshot.ts +1 -1
  664. package/scripts/team-up.ts +10 -1
  665. package/skills/browser-testing-with-devtools/SKILL.md +1 -1
  666. package/skills/compound-learning/SKILL.md +3 -3
  667. package/skills/guided-workspace-setup/SKILL.md +16 -14
  668. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  669. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  670. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  671. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  672. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  673. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  674. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  675. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  676. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  677. package/.versions/0.0.4/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  678. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -15
  679. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -19
  680. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -13
  681. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -11
  682. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -9
  683. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -17
  684. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -34
  685. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -39
  686. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -12
  687. package/.versions/0.0.5/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +0 -22
  688. /package/.pi/prompts/{build.md → af-build.md} +0 -0
  689. /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
  690. /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
  691. /package/.pi/prompts/{review.md → af-review.md} +0 -0
  692. /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
  693. /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
  694. /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
  695. /package/.pi/prompts/{test.md → af-test.md} +0 -0
@@ -6,7 +6,7 @@ first: [`damage-control-continue`](../damage-control-continue/README.md),
6
6
  [`ask-user-remote`](../ask-user-remote/README.md), STT, Compact & Continue, BTW, and the
7
7
  update checker. The dispatcher therefore has guardrails and an `ask_user` handoff tool
8
8
  before `agent-hub` starts. It combines local specialist
9
- orchestration (fixed specialist grid, read-only research helpers, `/zoom`, kill/restart, per-agent
9
+ orchestration (fixed specialist grid, read-only research helpers, `/af-zoom`, kill/restart, per-agent
10
10
  model, dispatcher persona gate) with peer-to-peer collaboration: it can **hand a session off to
11
11
  another main agent** and **use a coms peer as a subagent**.
12
12
 
@@ -50,14 +50,14 @@ Every borrowed idea from another harness passes one test before it lands: *does
50
50
 
51
51
  - **Dispatcher grid** — a live dashboard of fixed specialists from `.pi/agents/teams.yaml`.
52
52
  - **Specialist delegation** — `dispatch_agent` sends writable tasks to configured specialists.
53
- - **Research helpers** — `spawn_research` and `/research` launch read-only helper agents. Two
53
+ - **Research helpers** — `spawn_research` and `/af-research` launch read-only helper agents. Two
54
54
  `kind: research` personas ship by default: `researcher` (fast `gpt-5.3-codex-spark`) for simple
55
55
  reads and `deep-researcher` (`gpt-5.5` / xhigh) for hard, cross-cutting investigation. The
56
56
  orchestrator routes by persona; each persona's model + thinking level is shown in its catalog.
57
57
  Finished helpers are **auto-pruned** so the research row doesn't grow without bound: auto-research
58
58
  pipe helpers disappear as soon as they finish (their findings persist as `findings/*.md` files and
59
59
  their handles are never resumed), while manual/persona helpers keep only the `research-keep` most
60
- recently finished (default 4 — resumable via `/agents-cont rN`; older cards, and their session
60
+ recently finished (default 4 — resumable via `/af-agents-cont rN`; older cards, and their session
61
61
  files, are dropped oldest-first). Set `research-keep: <n>|all` in the overrides file to change
62
62
  the cap. Running helpers are never pruned and `rN` handles are never reused.
63
63
  - **Human handoff path** — `ask_user` is exposed by the `ask-user-remote` wrapper (capturing stock
@@ -72,7 +72,8 @@ Every borrowed idea from another harness passes one test before it lands: *does
72
72
  - **Verification Contract (assertion ledger)** — the dispatcher owns a ledger of checkable
73
73
  acceptance assertions built from the request *before* any builder runs, so a clearly stated
74
74
  requirement is never silently dropped. `set_assertions` records the numbered, tagged assertions
75
- (`test` | `runtime-ui` | `code-grep` | `manual`, one pass condition each) and rebuilds the whole
75
+ (`test` | `runtime-ui` | `code-grep` | `manual`, one pass condition each, plus a required
76
+ `source` naming where the requirement comes from) and rebuilds the whole
76
77
  ledger on a "wrong again" regression reset; `update_assertion` marks each one proven (named
77
78
  evidence required), unproven, or failed after a verification gate; `get_assertions` reads the
78
79
  full ledger (ids, tags, pass conditions, evidence) back. The hub persists the ledger to
@@ -87,16 +88,25 @@ Every borrowed idea from another harness passes one test before it lands: *does
87
88
  to `.pi/agent-sessions/artifacts/returns/<agentKey>-run<N>.md`, surfaces only a compact
88
89
  `details.structuredReturn` digest plus `details.returnPath`, and marks contract notices such as
89
90
  missing assertion ids or evidence-less `assertions_proven` entries (demoted to unproven in the
90
- tool text). `details.fullOutput` remains for `/zoom`/compatibility, but dispatcher-visible text is
91
+ tool text). `details.fullOutput` remains for `/af-zoom`/compatibility, but dispatcher-visible text is
91
92
  digest + path oriented. `update_assertion(status: "proven")` validates evidence by assertion tag:
92
93
  test evidence needs a command/test and outcome, `code-grep` needs pattern plus result sample,
93
94
  manual needs user/`ask_user` confirmation, and `runtime-ui` needs an existing artifact path under
94
95
  `.pi/agent-sessions/artifacts/evidence/`. **Advisory by design** (PRD open question 2): status is
95
96
  surfaced and "proven" requires named evidence, but a dispatch is never hard-refused on an unproven
96
- assertion — code-enforcement is the Checkpoint A decision.
97
+ assertion — code-enforcement is the Checkpoint A decision. Two contract rules ARE enforced at the
98
+ tool: a batch with any sourceless assertion is refused with the offending ids named (a specialist
99
+ told to prove `A9` must be able to read its origin instead of spending a dispatch and an ASK_USER
100
+ cycle asking where `A9` was defined), and a batch over **8** open assertions is accepted with a
101
+ warning suggesting the split — declare the batch the next dispatches actually prove, and
102
+ `set_assertions` the next one when it starts.
97
103
  - **Artifact bus** — session handoffs live under `.pi/agent-sessions/artifacts/` with conventional
98
- `returns/`, `plans/`, `reviews/`, `inventories/`, and `evidence/` subdirectories, all wiped and
99
- recreated at session start like `findings/`. `dispatch_agent` and `spawn_research` accept optional
104
+ `returns/`, `failures/`, `plans/`, `reviews/`, `inventories/`, and `evidence/` subdirectories, all
105
+ wiped and recreated at session start like `findings/`. `failures/` is separate on purpose: a run
106
+ that errored or timed out produced no specialist result, so its output goes there and the dispatch
107
+ result names it a **delivery failure** carrying no assertion evidence. Filing a 142-byte coms error
108
+ stub as `returns/code-reviewer-run4.md` once cost a 103-second dispatch investigating a review that
109
+ had in fact succeeded — only its reply was lost. `dispatch_agent` and `spawn_research` accept optional
100
110
  `artifacts: string[]` paths (repo-relative or session-artifact-relative); the hub validates that
101
111
  they stay inside the repo/session roots and injects only the path plus first heading/one-line
102
112
  preview, never file bodies. Document-producing specialists are instructed to write plans, reviews,
@@ -114,49 +124,59 @@ Every borrowed idea from another harness passes one test before it lands: *does
114
124
  notice. This is advisory only: the hub never blocks completion, reverts files, or escalates
115
125
  automatically. Known limitation: concurrent writable dispatches can only be attributed
116
126
  approximately, so overlapping runs are flagged in the notice.
117
- - **Agent controls** — `/zoom` inspects a live agent timeline; `/agents-history` replays the run as a
127
+ - **Agent controls** — `/af-zoom` inspects a live agent timeline; `/af-agents-history` replays the run as a
118
128
  timeline (orchestrator turns, dispatches, research helpers) with per-agent durations, parallel-run
119
129
  markers, and a grand total; kill/restart controls manage running child agents; per-agent `model:`
120
130
  fields select models from team config. The `agents-*` commands address **both target kinds** —
121
- team specialists by persona name, research helpers by `rN` handle (mirroring `/zoom`):
122
- `/agents-kill <name|rN|all>` SIGTERMs a specialist (keeping its standing card), while on a
131
+ team specialists by persona name, research helpers by `rN` handle (mirroring `/af-zoom`):
132
+ `/af-agents-kill <name|rN|all>` SIGTERMs a specialist (keeping its standing card), while on a
123
133
  research helper it kills **and removes** the card + session — helpers are disposable by design
124
- (`all` clears every helper); `/agents-restart <name|rN>` re-runs the last task fresh (a research
125
- helper must be finished first); `/agents-cont rN <prompt>` resumes a finished helper's session.
126
- The old `/research-rm` and `/research-clear` spellings remain as aliases of the kill semantics,
127
- `/research-cont` of `/agents-cont`.
134
+ (`all` clears every helper); `/af-agents-restart <name|rN>` re-runs the last task fresh (a research
135
+ helper must be finished first); `/af-agents-cont rN <prompt>` resumes a finished helper's session.
136
+ The old `/af-research-rm` and `/af-research-clear` spellings remain as aliases of the kill semantics,
137
+ `/af-research-cont` of `/af-agents-cont`.
128
138
  Restartable team specialists at or above 70% context render
129
139
  their context percentage with a warning marker/color in dashboard and compact views, and their next
130
- `dispatch_agent` result adds a `/agents-restart <persona>` hint. Research helpers are not warned,
140
+ `dispatch_agent` result adds a `/af-agents-restart <persona>` hint. Research helpers are not warned,
131
141
  and the hub never restarts specialists automatically.
132
142
  - **Model switching** — a persona's frontmatter `models:` list declares the models it may switch to
133
- (the default `model:` is implicitly a candidate). `/agent-model <persona>` picks from that list;
143
+ (the default `model:` is implicitly a candidate). `/af-agent-model <persona>` picks from that list;
134
144
  the choice lasts for the session and takes effect on the persona's next dispatch
135
- (`/agents-restart <persona>` applies it immediately). The dot form
136
- `/agent-model <persona>.<role>` switches a delegate sub-role's model instead — its candidates are
145
+ (`/af-agents-restart <persona>` applies it immediately). The dot form
146
+ `/af-agent-model <persona>.<role>` switches a delegate sub-role's model instead — its candidates are
137
147
  the role's declared default plus the parent persona's own candidate list; the switch is applied
138
148
  when the parent is next dispatched (it lands in the serialized delegate config, so nested
139
- children inherit it). `/models [profile]` applies a named profile
149
+ children inherit it). `/af-models [profile]` applies a named profile
140
150
  from `.pi/agents/model-profiles.yaml` — a macro over the same declared candidates, validated at
141
151
  session start (a profile with any entry outside a persona's candidates is dropped whole, with an
142
- error); profiles never touch sub-role models — only `/agent-model` reaches those. Nothing
143
- outside the declared lists is ever selectable. Per project,
152
+ error); profiles never touch sub-role models — only `/af-agent-model` reaches those. Nothing
153
+ outside the declared lists is ever selectable. When an effective project or session override
154
+ fails with a model/provider error or aborted request before work begins (including local-model
155
+ memory-limit failures), the hub retries once with the model originally declared in the persona
156
+ frontmatter. For **write-capable** runs this is pre-work only: no fallback occurs after text
157
+ output, a tool call, cancellation, timeout, drift stop, or a Pi process-spawn failure, avoiding
158
+ duplicate writes. **Read-only children and research helpers** (tools limited to
159
+ `read,grep,find,ls`) also retry once when the provider fails *mid-run* — re-running a reader
160
+ repeats nothing, and those are exactly the children that exist to protect their parent's context,
161
+ so losing one to a local-endpoint OOM halfway through discards work for no safety gain. A
162
+ terminated run (watchdog, deadline, cancellation) never retries either way: that is a verdict on
163
+ the work, not a provider outage. The failed attempt is removed from the child session before retry. Per project,
144
164
  `model.<persona>:` / `models.<persona>:` keys under `## agent-hub` in
145
165
  `.ai/agent-fleet-overrides.md` replace a persona's default model / candidate list.
146
166
  Research personas (`researcher` / `deep-researcher`, `kind: research`) are switchable the same
147
- way — `/agent-model <persona>` and `/agent-model-thinking <persona>` accept them alongside team
148
- members. Since research helpers are spawned fresh on each `/research` / `spawn_research`, the
149
- switch lands on their next spawn (there is no running instance to `/agents-restart`).
150
- `/agent-models-substitute <source> <target>` is the global one-shot form: walks every loaded
167
+ way — `/af-agent-model <persona>` and `/af-agent-model-thinking <persona>` accept them alongside team
168
+ members. Since research helpers are spawned fresh on each `/af-research` / `spawn_research`, the
169
+ switch lands on their next spawn (there is no running instance to `/af-agents-restart`).
170
+ `/af-agent-models-substitute <source> <target>` is the global one-shot form: walks every loaded
151
171
  persona (team + research + orchestrator), and for each whose **current effective model** is
152
172
  `<source>` and whose declared candidates include `<target>`, sets the session override to
153
173
  `<target>`. One-step flow — the dry-run summary (affected vs skipped, with reasons) is shown
154
174
  inline, then the swap is applied immediately and takes effect on each persona's next dispatch
155
- (`/agents-restart` to apply now). It never touches the dispatcher or delegate sub-roles.
175
+ (`/af-agents-restart` to apply now). It never touches the dispatcher or delegate sub-roles.
156
176
  - **Thinking levels** — each persona's frontmatter `thinking:` sets its pi `--thinking`
157
- reasoning effort (`off` · `minimal` · `low` · `medium` · `high` · `xhigh`). `/agent-model-thinking
177
+ reasoning effort (`off` · `minimal` · `low` · `medium` · `high` · `xhigh`). `/af-agent-model-thinking
158
178
  <persona>` switches it among those six levels for the session; like a model switch it takes effect
159
- on the persona's next dispatch (`/agents-restart <persona>` applies it now), and selecting the
179
+ on the persona's next dispatch (`/af-agents-restart <persona>` applies it now), and selecting the
160
180
  frontmatter default clears the override. The level shows as a short badge after the model
161
181
  everywhere a model is rendered — `gpt-5.5 (xh)` in the dashboard cards and the compact below-editor
162
182
  view (`min`/`low`/`med`/`hi`/`xh`; `off` shows no badge). Per project, a `thinking.<persona>:` key
@@ -175,17 +195,19 @@ Every borrowed idea from another harness passes one test before it lands: *does
175
195
  Concurrent children are always forced read-only. Children stream timeline events through
176
196
  `.pi/agent-sessions/delegations/<persona>/events.jsonl`; the hub tails it and renders nested rows
177
197
  under the parent's card (child id, model, tokens, status),
178
- each openable with `/zoom <child-id>`. Each child also writes its full final output to
198
+ each openable with `/af-zoom <child-id>`. Each child also writes its full final output to
179
199
  `.pi/agent-sessions/delegations/<persona>/results/<childId>.md`; the parent receives only status,
180
200
  a required final `DIGEST:` section (≤30 lines with path:line citations), and the result-file path.
181
201
  If a child omits `DIGEST:`, the parent gets the first ~30 lines plus a no-DIGEST warning and the
182
202
  result path. Spend rolls up: every child row and the parent's subtree
183
203
  total show tokens, and a session-wide `Δ delegated` counter sits in the status line.
184
- `/agents-kill` on the parent SIGTERMs its whole process group, so the delegation tree dies with
204
+ `/af-agents-kill` on the parent SIGTERMs its whole process group, so the delegation tree dies with
185
205
  it. `context: fork` is accepted but treated as a summary brief in v1. Per project,
186
206
  `subagents.<persona>.<role>:` and `delegate-depth.<persona>:` keys under `## agent-hub` in
187
- `.ai/agent-fleet-overrides.md` replace individual sub-roles / the depth budget. Six personas
188
- ship with declared sub-roles, on a three-tier OpenAI model ladder — `gpt-5.3-codex-spark` for
207
+ `.ai/agent-fleet-overrides.md` replace individual sub-roles / the depth budget. An overridden
208
+ role retains its frontmatter model as a one-shot fallback under the same pre-work-only safety
209
+ rule; delegate cards and results show the model that ultimately ran. Six personas ship with
210
+ declared sub-roles, on a three-tier OpenAI model ladder — `gpt-5.3-codex-spark` for
189
211
  recon/grep sweeps, `gpt-5.4` for analysis sweeps, the `gpt-5.5` (or opus) parent reserved for
190
212
  synthesis and verdicts:
191
213
  - `code-reviewer` — `preflight`+`docs` (spark), `quality`+`perf` (gpt-5.4); its first delegate
@@ -217,14 +239,14 @@ Every borrowed idea from another harness passes one test before it lands: *does
217
239
  `agent-hub` (or plain `coms`) sessions on the same box find each other through per-project registry
218
240
  files and exchange messages over a unix socket (named pipe on Windows).
219
241
 
220
- Inherited `/zoom` behavior in this harness expands the latest event by default. Use `Space` or
242
+ Inherited `/af-zoom` behavior in this harness expands the latest event by default. Use `Space` or
221
243
  `Ctrl+C` to copy the selected row content, and `Q` or `Esc` to close the overlay. The overlay sizes
222
244
  to the terminal and keeps the selected (and last) entry fully visible while you navigate with
223
245
  `↑/↓`.
224
246
 
225
- ### `/agents-history`
247
+ ### `/af-agents-history`
226
248
 
227
- `/agents-history` opens a read-only overlay (same chrome as `/zoom`) that replays the session as an
249
+ `/af-agents-history` opens a read-only overlay (same chrome as `/af-zoom`) that replays the session as an
228
250
  execution **tree**:
229
251
 
230
252
  - **Orchestrator turns** — each dispatcher turn that actually dispatched something is a depth-0 row
@@ -250,12 +272,12 @@ execution **tree**:
250
272
  Navigate with `↑/↓`, press `G` to jump back to the live tail, and `Q`/`Esc` to close. The log resets
251
273
  on each session start.
252
274
 
253
- Press **`Alt+A`** to toggle the agent view between the full **dashboard** (bordered card grid drawn
254
- *above* the input box) and a **compact** view that shows one line per *running* agent —
255
- `name · context% · state` — rendered *below* the input box, just above pi's status bar. Idle and
256
- done agents are hidden in compact mode, and the coms pool widget collapses too, so an idle session
257
- collapses to just the prompt and footer. The current mode and binding are shown in the footer
258
- (`Alt+A view:dashboard` / `Alt+A view:compact`).
275
+ The agent view starts in **compact** mode, showing one line per *running* agent —
276
+ `name · context% · state` — *below* the input box, just above pi's status bar. Idle and done agents
277
+ are hidden, and the coms pool widget collapses too, so an idle session collapses to just the prompt
278
+ and footer. Press **`Alt+A`** to toggle to the full **dashboard** (bordered card grid drawn *above*
279
+ the input box) and back. The current mode and binding are shown in the footer
280
+ (`Alt+A view:compact` / `Alt+A view:dashboard`).
259
281
 
260
282
  ### Version footer
261
283
 
@@ -286,11 +308,11 @@ the single model line. Press **`Alt+S`** to start/stop dictation as in a normal
286
308
 
287
309
  In **compact view**, the running-subagents list below the input doubles as a switcher. **`Alt+]`**
288
310
  and **`Alt+[`** move a marker (`›` + highlight) to the next/previous running subagent; **`Alt+\`**
289
- opens the read-only `/zoom` overlay on the marked one (`Q`/`Esc` to close). This only changes what
311
+ opens the read-only `/af-zoom` overlay on the marked one (`Q`/`Esc` to close). This only changes what
290
312
  you *view* — **the input box always prompts the main session**, and `main` is never a marker target
291
313
  (it is the session under the input, not a subagent). There is no transcript takeover: a subagent's
292
314
  stream is surfaced through the modal zoom overlay, never by replacing the main scrollback. The keys
293
- are inert in dashboard mode (use `/zoom <name>` there).
315
+ are inert in dashboard mode (use `/af-zoom <name>` there).
294
316
 
295
317
  > Terminal note: `Alt+[` emits `ESC [` (a CSI prefix) and may be swallowed by some terminals'
296
318
  > escape parsers; `Alt+]` and `Alt+\` are the reliable pair. `Alt+↑/↓/←/→` are reserved by the pi
@@ -400,7 +422,7 @@ task, most of it re-billed stale specialist context).
400
422
 
401
423
  When a budget is exhausted, `dispatch_agent`/`spawn_research` **refuse** with instructions
402
424
  to summarize and ask the user; the next user message opens a fresh window. Switch modes
403
- live with `/hub-mode fast|standard|strict` (no argument shows the current mode and usage);
425
+ live with `/af-hub-mode fast|standard|strict` (no argument shows the current mode and usage);
404
426
  set the project default and per-axis overrides in the overrides file:
405
427
 
406
428
  ```markdown
@@ -421,6 +443,36 @@ or its measured context passes 60%. The dispatch result notes the recycle so the
421
443
  knows the specialist starts without session memory — task text and `artifacts:` paths must
422
444
  carry the state, which the deliverable-to-file protocol already ensures.
423
445
 
446
+ Context is measured against **that agent's own** model window, resolved from pi's model
447
+ registry (`ctx.modelRegistry.find`) with the source recorded on every resolution. Dividing a
448
+ 49k local model's usage by the dispatcher's window is what produced unactionable readings
449
+ like `⚠ Planner context at 315%`; a reading above 100% now emits a one-time diagnostic that
450
+ names the window and where the number came from, so a mis-resolved window is distinguishable
451
+ from a genuine overflow. Two recycle rules follow from it: a session at or past a **full**
452
+ window is recycled unconditionally (no threshold override keeps it alive), and a resumed
453
+ session whose *projected* prompt — prior tokens plus this task — would overflow is recycled
454
+ **before** the spawn instead of after the run.
455
+
456
+ #### Per-provider concurrency
457
+
458
+ A dispatch may fan out to four delegate children at once and several specialists can be
459
+ mid-run, with nothing bounding how many requests land on one provider. That is fine against
460
+ a hosted endpoint and not against a local one. Requests are capped per process — **2 in
461
+ flight for `custom/*` by default, unlimited elsewhere**:
462
+
463
+ ```bash
464
+ AGENT_HUB_PROVIDER_LIMITS="custom=4" # raise the local cap
465
+ AGENT_HUB_PROVIDER_LIMITS="custom=off" # disable it
466
+ AGENT_HUB_PROVIDER_LIMITS="custom=2,ollama=1"
467
+ ```
468
+
469
+ Queued runs still execute — they wait for a permit, and the wait is announced rather than
470
+ looking like a hang. The cap applies per **level** of the delegation tree (each pi process
471
+ runs its own semaphore over the children it spawns), and a nested spawn reuses its parent's
472
+ permit, so a child can never wait on its own ancestor. The drift judge and the return
473
+ extractor are deliberately ungated: both run while a specialist holds a permit, so queueing
474
+ them behind it would stall the watchdog meant to stop it.
475
+
424
476
  The per-run deadline lands as `turn_timeout` (exit 124) with partial output preserved, for
425
477
  dispatched specialists, research helpers, and nested delegate children alike — a hung child
426
478
  can no longer hold its parent for hours.
@@ -437,7 +489,7 @@ The system prompt ties the tier to the anti-over-engineering rules: a provided p
437
489
  spec (no re-planning), assertions stay ≤3 for trivial/small asks, and "using every persona"
438
490
  is called out as a smell. Two hygiene guards are enforced in code, not prose: a
439
491
  **duplicate-dispatch guard** refuses re-dispatching the same agent with a near-identical
440
- task inside one turn, and every budget/duplicate refusal is counted in `/hub-report`.
492
+ task inside one turn, and every budget/duplicate refusal is counted in `/af-hub-report`.
441
493
 
442
494
  ### Drift watchdog (in-flight observation)
443
495
 
@@ -456,8 +508,8 @@ drives the cards — not post-hoc:
456
508
  corrected, narrowed task — never the same task unchanged.
457
509
 
458
510
  Enablement is dynamic, precedence top to bottom: the `watchdog: true|false` param on a
459
- single `dispatch_agent` call → a per-agent override (`/watchdog builder on|off|clear`) →
460
- the hub-wide setting (`/watchdog on|off|auto`, default `auto`, project default via the
511
+ single `dispatch_agent` call → a per-agent override (`/af-watchdog builder on|off|clear`) →
512
+ the hub-wide setting (`/af-watchdog on|off|auto`, default `auto`, project default via the
461
513
  `watchdog:` overrides key). Read-only research helpers are not monitored — they already
462
514
  run under the per-tool watchdog + turn deadline and cannot write.
463
515
 
@@ -465,15 +517,15 @@ run under the per-tool watchdog + turn deadline and cannot write.
465
517
 
466
518
  Rosters start from `.pi/agents/teams.yaml` but are not frozen there:
467
519
 
468
- - `/agents-add <persona>…` / `/agents-drop <persona>…` — restructure the ACTIVE team
520
+ - `/af-agents-add <persona>…` / `/af-agents-drop <persona>…` — restructure the ACTIVE team
469
521
  live (drop refuses running or last members; session files are kept for re-adding).
470
- - `/agents-save <name>` — persist the current roster as a named team back into
522
+ - `/af-agents-save <name>` — persist the current roster as a named team back into
471
523
  `teams.yaml` (targeted block upsert; comments and other teams untouched).
472
524
  - `team_adjust` — the dispatcher itself may add/drop a persona **with a stated reason**;
473
525
  disabled in fast mode, capped at 8 roster members, and every change is notified to the
474
526
  human. The system prompt is rebuilt each turn, so changes take effect immediately.
475
527
 
476
- ### `/hub-report`
528
+ ### `/af-hub-report`
477
529
 
478
530
  Per-turn cost accounting: dispatches (agent, status, elapsed, billed/output tokens),
479
531
  research runs, session recycles, drift stops, and budget/duplicate refusals — for the
@@ -496,9 +548,13 @@ Inside a [herdr](https://herdr.dev) pane with a live server, the dispatcher's to
496
548
  surface additionally gets (absent otherwise, like coms):
497
549
 
498
550
  - `herdr_spawn_peer` — stand up a persona peer (joins the coms pool via `just _peer`) or a
499
- raw command pane in the current workspace
551
+ raw command pane in the current workspace. A persona peer **boots idle** and does nothing until
552
+ a `coms_send` reaches it, so the call waits (bounded, ~45s) for it to register and returns
553
+ `peer_ready` plus its coms name instead of a bare pane id. Peers spawned but never addressed are
554
+ named at turn end and in `/af-hub-report` with a close suggestion — closing stays the human's call
500
555
  - `herdr_read_pane` — bounded `pane.read` (≤200 lines), read-to-decide on workers/tools;
501
- messaging still goes through coms
556
+ messaging still goes through coms, and peer busy state comes from `coms_list`, not from
557
+ reading the screen
502
558
  - `herdr_close_pane` — kills a pane; **asks the human to confirm every call**; the
503
559
  bash-level `herdr pane close`/`workspace close`/`server stop` verbs are hard-blocked
504
560
  for spawned specialists by `.pi/damage-control-rules.yaml`
@@ -529,20 +585,23 @@ Each session registers a coms identity at start-up, resolved in this precedence
529
585
 
530
586
  Names are de-duplicated per project (`resolveUniqueName`), so two hubs that both want `architect`
531
587
  become `architect` and `architect-2`. `--explicit` marks a **private** peer — kept out of every
532
- pool by default, so it is neither listed nor reachable until a human opts in with `/coms --all`
588
+ pool by default, so it is neither listed nor reachable until a human opts in with `/af-coms --all`
533
589
  (see [Pool scope is the reach boundary](#pool-scope-is-the-reach-boundary)). The registry lives
534
590
  under `~/.pi/coms/projects/<project>/agents/<name>.json` and is created at runtime.
535
591
 
536
592
  ### Commands & tools (local dispatcher plus coms)
537
593
 
538
- - `/coms` — coms control surface (peer list / status)
539
- - `/handoff <peer>` — hand the whole session off to a coms peer (see [Handoff](#handoff))
540
- - `/compound [focus]` — end-of-session **compound-learning pass**: the dispatcher composes a
594
+ - `/af-coms` — coms control surface (peer list / status)
595
+ - `/af-handoff <peer>` — hand the whole session off to a coms peer (see [Handoff](#handoff))
596
+ - `/af-compound [focus]` — end-of-session **compound-learning pass**: the dispatcher composes a
541
597
  candidate-lessons brief from the session (corrections, recurring findings, root causes),
542
598
  confirms it with the user, then dispatches the `documenter` to land the approved lessons as
543
599
  minimal diffs on the project's `rules:`/`docs:` targets per `skills/compound-learning/SKILL.md`.
544
- Requires the `documenter` persona in the active team; run it before `/handoff` or session end.
545
- - `coms_list` — discover the peers in your pool: names, models, live context usage, purpose. Scoped
600
+ Requires the `documenter` persona in the active team; run it before `/af-handoff` or session end.
601
+ - `coms_list` — discover the peers in your pool: names, models, live context usage, purpose,
602
+ `pane_id`, and `status` (`idle` | `working` | `booting`). Check status before sending: `working`
603
+ means your send waits behind the peer's current turn, `booting` means it is not addressable yet.
604
+ This is the field whose absence drove 127 `herdr_read_pane` calls in one session. Scoped
546
605
  to your project and excluding private peers; the LLM cannot widen it (see
547
606
  [Pool scope is the reach boundary](#pool-scope-is-the-reach-boundary)).
548
607
  - `coms_send` — send a prompt to a peer **in your pool**; returns a `msg_id`
@@ -550,19 +609,19 @@ under `~/.pi/coms/projects/<project>/agents/<name>.json` and is created at runti
550
609
  `PI_COMS_TIMEOUT_MS`)
551
610
  - `coms_get` — **non-blocking** poll of a `msg_id` (status `pending|complete|error`)
552
611
 
553
- `/coms` and `/handoff` tab-complete live peer names **in your pool**.
612
+ `/af-coms` and `/af-handoff` tab-complete live peer names **in your pool**.
554
613
 
555
614
  ### Pool scope is the reach boundary
556
615
 
557
616
  The set of peers shown in the pool widget is the security boundary: **a peer is reachable only if it
558
- is in your pool.** `coms_list`, `coms_send`, and `/handoff` all resolve targets through the same
617
+ is in your pool.** `coms_list`, `coms_send`, and `/af-handoff` all resolve targets through the same
559
618
  `peersInScope()` helper, so the dispatcher can never message a peer it cannot see. Two knobs define
560
619
  the pool, and **both are human-only** — the LLM cannot widen scope to reach more peers:
561
620
 
562
- - **Project** — defaults to your own `identity.project`. A human can retarget with `/coms --project
563
- <name>` (one project) or `/coms --all` (every project). `coms_list`'s own parameters cannot
621
+ - **Project** — defaults to your own `identity.project`. A human can retarget with `/af-coms --project
622
+ <name>` (one project) or `/af-coms --all` (every project). `coms_list`'s own parameters cannot
564
623
  override this; an LLM request for a wider project is clamped back to the current pool and flagged.
565
- - **Explicit (private) peers** — excluded from every pool by default. `/coms --all` opts them in.
624
+ - **Explicit (private) peers** — excluded from every pool by default. `/af-coms --all` opts them in.
566
625
 
567
626
  This closes a cross-project leak where a peer reachable through the mesh was *not* shown in the
568
627
  default project-scoped pool — so it could be messaged without being "connected." Now the reachable
@@ -614,12 +673,12 @@ Semantics:
614
673
  - **Standing context is the point.** Re-dispatches (ASK_USER answers, research resumes) go back to
615
674
  the same peer session, so a Claude Code reviewer keeps its review context across rounds.
616
675
  - **Visibility.** The member's grid card shows a `⇄coms <peer-model>` badge, history entries are
617
- annotated `(coms)`, and `/dispatch-policy` prints the resolved routing per member with live-peer
676
+ annotated `(coms)`, and `/af-dispatch-policy` prints the resolved routing per member with live-peer
618
677
  status.
619
- - **Limitations.** `/agents-kill` on a coms-backed run only abandons the wait — the peer keeps
620
- running in its own pane and cannot be killed from the hub (`/agents-restart` abandons, then
621
- re-dispatches). `/zoom` shows only the final reply (there is no stream), tool counts stay 0, and
622
- context% is a registry snapshot. `/agent-model` overrides apply only to native(-fallback) runs —
678
+ - **Limitations.** `/af-agents-kill` on a coms-backed run only abandons the wait — the peer keeps
679
+ running in its own pane and cannot be killed from the hub (`/af-agents-restart` abandons, then
680
+ re-dispatches). `/af-zoom` shows only the final reply (there is no stream), tool counts stay 0, and
681
+ context% is a registry snapshot. `/af-agent-model` overrides apply only to native(-fallback) runs —
623
682
  the peer's model is set in `peers.yaml`.
624
683
 
625
684
  Missing file = everything native. HOW a peer runs (persona, model, `runner: claude-code`, env) stays
@@ -627,7 +686,7 @@ in `peers.yaml`; this file only decides WHEN the hub prefers a peer over a nativ
627
686
 
628
687
  ### Handoff
629
688
 
630
- `/handoff <peer>` transfers the session to another **main** agent. Following the plan's
689
+ `/af-handoff <peer>` transfers the session to another **main** agent. Following the plan's
631
690
  **decision G1**, it does *not* try to extract a compaction summary; instead it asks the dispatcher
632
691
  LLM to compose a **self-contained brief** ("everything the target needs, assume no shared history"),
633
692
  then `coms_send`s that brief to the peer, `coms_await`s the reply, and relays it back — in the
@@ -636,7 +695,7 @@ sections after the LLM brief: `## Verification ledger (verbatim, machine-appende
636
695
  assertion in canonical ledger form, and `## Artifact index` with artifact paths plus first headings.
637
696
  The target peer must treat the machine-appended ledger as the contract, not the paraphrased brief.
638
697
  The target peer takes over; the source relays the result. There is no raw session copy (pi sessions
639
- aren't portable between live agents). The target must be a peer in your pool — `/handoff` resolves
698
+ aren't portable between live agents). The target must be a peer in your pool — `/af-handoff` resolves
640
699
  through the same [scope boundary](#pool-scope-is-the-reach-boundary) as `coms_send`, so you cannot
641
700
  hand a session to a peer you cannot see.
642
701
 
@@ -652,13 +711,13 @@ The dispatcher persona gate fires *after* coms init, so the identity's `purpose`
652
711
  flag/frontmatter/default and is then reconciled to the chosen persona: `syncComsPurpose()` maps the
653
712
  selected `kind: orchestrator` persona to `"<Name> — <description>"` and re-writes the live registry
654
713
  entry — **unless** `--purpose` was passed explicitly (an explicit flag always wins). Switching or
655
- resetting the persona via `/persona` re-syncs.
714
+ resetting the persona via `/af-persona` re-syncs.
656
715
 
657
716
  ### Graceful degradation
658
717
 
659
718
  If the coms socket can't bind at start-up (`comsReady` stays `false`), the session degrades to a
660
719
  local dispatcher without coms: the `coms_*` tools are withheld from `setActiveTools`, the
661
- `/handoff` command refuses with a notice, and the "Peer agents (coms)" prompt section is omitted.
720
+ `/af-handoff` command refuses with a notice, and the "Peer agents (coms)" prompt section is omitted.
662
721
  Orchestration, research helpers, and the grid keep working.
663
722
 
664
723
  ### Tool surface
@@ -793,6 +852,6 @@ coms purpose/color.
793
852
  `spawn_research` (+ `ask_user`); the system prompt gains a "Peer agents (coms)" section when coms
794
853
  is ready. The persona's `description` drives the coms `purpose` (decision 6 / Phase 6 peer
795
854
  mapping) instead of a static `--purpose`.
796
- - **`/handoff` uses an LLM-composed brief**, not a compaction-summary extraction (decision G1).
855
+ - **`/af-handoff` uses an LLM-composed brief**, not a compaction-summary extraction (decision G1).
797
856
  - **Clean shutdown** SIGTERMs any running specialist/research children, clears the coms pool
798
857
  widget, and removes the registry entry on `session_shutdown` / SIGINT / SIGTERM.
@@ -1,6 +1,11 @@
1
1
  import { isAbsolute, relative, resolve, sep } from "node:path";
2
2
 
3
- export const ARTIFACT_KINDS = ["returns", "plans", "reviews", "inventories", "evidence"];
3
+ // `failures` is deliberately its own kind, not a flavour of `returns`: a run
4
+ // that errored or timed out produced no specialist result, and storing its error
5
+ // text as a return is the most expensive artifact in the system — a 142-byte
6
+ // coms error stub written to returns/code-reviewer-run4.md cost a full dispatch
7
+ // investigating a review that had in fact succeeded, only its reply was lost.
8
+ export const ARTIFACT_KINDS = ["returns", "failures", "plans", "reviews", "inventories", "evidence"];
4
9
 
5
10
  const SESSION_RELATIVE_PREFIXES = new Set(["artifacts", "findings", "delegations"]);
6
11
  const PREVIEW_LIMIT = 180;
@@ -44,14 +49,63 @@ export function resolveArtifactPath(inputPath, options) {
44
49
  }
45
50
 
46
51
  const exists = typeof options.exists === "function" ? options.exists : () => true;
47
- const picked = valid.find((candidate) => exists(candidate.target)) || valid[0];
52
+ const found = valid.find((candidate) => exists(candidate.target));
53
+ if (found) {
54
+ return {
55
+ input: raw,
56
+ path: found.target,
57
+ displayPath: displayPath(found.target, found.displayBase, found.prefix),
58
+ resolvedFromKind: null,
59
+ };
60
+ }
61
+
62
+ // Nothing at the requested path. The hub writes EVERY auto-return under
63
+ // `returns/`, while the deliverable protocol teaches dispatchers that documents
64
+ // live in `artifacts/<kind>/` — so `reviews/code-reviewer-run1.md` is the
65
+ // natural and wrong guess for a file that is sitting in `returns/`. Look for
66
+ // the same name under the other kinds instead of reporting a missing file.
67
+ const requested = matchKindPath(normalized);
68
+ if (requested) {
69
+ const hits = ARTIFACT_KINDS
70
+ .filter((kind) => kind !== requested.kind)
71
+ .map((kind) => ({ kind, target: resolve(artifactRoot, `${kind}/${requested.rest}`) }))
72
+ .filter((candidate) => isWithin(artifactRoot, candidate.target) && exists(candidate.target));
73
+ if (hits.length === 1) {
74
+ return {
75
+ input: raw,
76
+ path: hits[0].target,
77
+ displayPath: displayPath(hits[0].target, artifactRoot, "artifacts"),
78
+ resolvedFromKind: hits[0].kind,
79
+ };
80
+ }
81
+ // Never guess between kinds: two files with the same name are two documents.
82
+ if (hits.length > 1) {
83
+ throw new Error(
84
+ `Ambiguous artifact ${raw}: "${requested.rest}" exists under ${hits.map((h) => `${h.kind}/`).join(" and ")}. ` +
85
+ "Name the kind explicitly.",
86
+ );
87
+ }
88
+ }
89
+
90
+ const picked = valid[0];
48
91
  return {
49
92
  input: raw,
50
93
  path: picked.target,
51
94
  displayPath: displayPath(picked.target, picked.displayBase, picked.prefix),
95
+ resolvedFromKind: null,
52
96
  };
53
97
  }
54
98
 
99
+ /** `reviews/x.md` / `artifacts/reviews/x.md` → `{ kind: "reviews", rest: "x.md" }`. */
100
+ function matchKindPath(normalized) {
101
+ const parts = String(normalized || "").split("/").filter(Boolean);
102
+ const offset = parts[0] === "artifacts" ? 1 : 0;
103
+ const kind = parts[offset];
104
+ if (!ARTIFACT_KINDS.includes(kind)) return null;
105
+ const rest = parts.slice(offset + 1).join("/");
106
+ return rest ? { kind, rest } : null;
107
+ }
108
+
55
109
  export function resolveArtifactPaths(paths, options) {
56
110
  return (paths || []).map((p) => resolveArtifactPath(p, options));
57
111
  }
@@ -0,0 +1,58 @@
1
+ // Assertion-ledger contract — pure validation for the `set_assertions` tool.
2
+ //
3
+ // Two rules, both drawn from the post-mortem of the hub sessions that declared
4
+ // 30 assertions (GO1–GO5, A1–A25) in one call and then spent a dispatch plus an
5
+ // ASK_USER cycle answering "where were A9–A16 defined?":
6
+ //
7
+ // 1. Every assertion names its origin, so an id can always be traced back to
8
+ // the plan/spec line it came from. Refused when missing — a sourceless id
9
+ // is exactly the failure that cost the cycle.
10
+ // 2. The open ledger is capped at MAX_OPEN_ASSERTIONS per batch. Warned, not
11
+ // refused: a large task legitimately has many assertions, they just should
12
+ // not all be open at once. Declare the rest when their batch starts.
13
+
14
+ export const MAX_OPEN_ASSERTIONS = 8;
15
+
16
+ const str = (v) => String(v ?? "").trim();
17
+
18
+ /**
19
+ * Validate + normalize one `set_assertions` batch.
20
+ * Returns { ok, refusal?, warning, assertions } — `assertions` is empty on a
21
+ * refusal so a rejected batch can never half-replace the live ledger.
22
+ */
23
+ export function validateAssertionBatch(input) {
24
+ const batch = Array.isArray(input) ? input : [];
25
+
26
+ const sourceless = batch
27
+ .map((a, i) => (str(a?.source) === "" ? str(a?.id) || `#${i + 1}` : null))
28
+ .filter((label) => label !== null);
29
+
30
+ if (sourceless.length > 0) {
31
+ return {
32
+ ok: false,
33
+ refusal:
34
+ `Ledger unchanged: ${sourceless.length} assertion(s) declare no source — ${sourceless.join(", ")}. ` +
35
+ "Every assertion must name where it comes from (e.g. source: \"PLAN-x.md:585-595\", " +
36
+ "\"user request\", \"review finding F3\") so a specialist asked to prove it can read the origin " +
37
+ "instead of asking. Re-send the batch with a source on each.",
38
+ warning: null,
39
+ assertions: [],
40
+ };
41
+ }
42
+
43
+ const assertions = batch.map((a) => ({
44
+ id: str(a?.id),
45
+ tag: str(a?.tag),
46
+ text: str(a?.text),
47
+ source: str(a?.source),
48
+ }));
49
+
50
+ const warning =
51
+ assertions.length > MAX_OPEN_ASSERTIONS
52
+ ? `⚠ ${assertions.length} assertions are open at once (soft cap ${MAX_OPEN_ASSERTIONS}). ` +
53
+ "Keep this batch to the assertions the next dispatches actually prove and defer the rest — " +
54
+ "declare them with a fresh set_assertions when their batch starts. Accepted as-is."
55
+ : null;
56
+
57
+ return { ok: true, warning, assertions };
58
+ }
@@ -147,7 +147,7 @@ export function comsRequiredRefusal(agentName, graceS) {
147
147
  return (
148
148
  `"${agentName}" is configured as coms-required (fallback: none) but no live peer named ` +
149
149
  `"${String(agentName).toLowerCase()}" appeared in the pool within ${graceS}s. ` +
150
- "Start it with `just hub-team <team>` / `just team-up <team>`, widen the pool with /coms, " +
150
+ "Start it with `just hub-team <team>` / `just team-up <team>`, widen the pool with /af-coms, " +
151
151
  "or set `fallback: native` in .pi/agents/dispatch-policy.yaml."
152
152
  );
153
153
  }