@chankov/agent-fleet 2.0.9 → 2.0.11

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 (988) hide show
  1. package/.pi/agent-fleet/scripts/flow.ts +26 -8
  2. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +56 -12
  3. package/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  4. package/.pi/agent-fleet/scripts/workflows/lib/run.ts +2 -2
  5. package/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  6. package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +2 -2
  7. package/.pi/agent-fleet/scripts/workflows/wf-scout.ts +3 -1
  8. package/.pi/extensions/pi-voice-stt/README.md +24 -5
  9. package/.pi/extensions/pi-voice-stt/examples/stt.json +4 -4
  10. package/.pi/harnesses/agent-hub/README.md +53 -18
  11. package/.pi/harnesses/agent-hub/acceptance.ts +137 -0
  12. package/.pi/harnesses/agent-hub/assertion-ledger.js +15 -6
  13. package/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  14. package/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  15. package/.pi/harnesses/agent-hub/budget-recovery.ts +112 -18
  16. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -1
  17. package/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  18. package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
  19. package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
  20. package/.pi/harnesses/agent-hub/config/agents.ts +1 -0
  21. package/.pi/harnesses/agent-hub/config/model-profiles.ts +20 -1
  22. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +10 -2
  23. package/.pi/harnesses/agent-hub/context/budgets.ts +2 -0
  24. package/.pi/harnesses/agent-hub/delegate.ts +19 -2
  25. package/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  26. package/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  27. package/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  28. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +14 -5
  29. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +74 -7
  30. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +5 -1
  31. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +15 -0
  32. package/.pi/harnesses/agent-hub/dispatch-native.ts +24 -11
  33. package/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  34. package/.pi/harnesses/agent-hub/helpers.ts +5 -1
  35. package/.pi/harnesses/agent-hub/hub-state-audit.js +1 -0
  36. package/.pi/harnesses/agent-hub/index.ts +145 -14
  37. package/.pi/harnesses/agent-hub/no-progress.ts +194 -64
  38. package/.pi/harnesses/agent-hub/package.json +1 -1
  39. package/.pi/harnesses/agent-hub/policy/work-mode.ts +10 -3
  40. package/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  41. package/.pi/harnesses/agent-hub/prompts/context.ts +4 -0
  42. package/.pi/harnesses/agent-hub/prompts/fragments.ts +5 -2
  43. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +1 -1
  44. package/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  45. package/.pi/harnesses/agent-hub/research/runtime.ts +1 -0
  46. package/.pi/harnesses/agent-hub/research/spawn-run.ts +20 -5
  47. package/.pi/harnesses/agent-hub/return-contract.js +34 -0
  48. package/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  49. package/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  50. package/.pi/harnesses/agent-hub/spawn.ts +61 -7
  51. package/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  52. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  53. package/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  54. package/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  55. package/.pi/harnesses/agent-hub/tools/action-executors.ts +41 -5
  56. package/.pi/harnesses/agent-hub/tools/context.ts +9 -1
  57. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +1 -1
  58. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +253 -41
  59. package/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  60. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +5 -3
  61. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +4 -1
  62. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +5 -2
  63. package/.pi/harnesses/agent-hub/types.ts +2 -0
  64. package/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  65. package/.pi/harnesses/agent-hub/work-mode.ts +8 -2
  66. package/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  67. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +31 -6
  68. package/.pi/harnesses/coms/package.json +1 -1
  69. package/.pi/harnesses/damage-control-continue/index.ts +9 -0
  70. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  71. package/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  72. package/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  73. package/.versions/2.0.10/.pi/agent-fleet/hermes/README.md +347 -0
  74. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  75. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  76. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  77. package/.versions/2.0.10/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  78. package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  79. package/.versions/2.0.10/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  80. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  81. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  82. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  83. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  84. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  85. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  86. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  87. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  88. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  89. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  90. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  91. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  92. package/.versions/2.0.10/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  93. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  94. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  95. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  96. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  97. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  98. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  99. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  100. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  101. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  102. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  103. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  104. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  105. package/.versions/2.0.10/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  106. package/.versions/2.0.10/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  107. package/.versions/2.0.10/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  108. package/.versions/2.0.10/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  109. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  110. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  111. package/.versions/2.0.10/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  112. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  113. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  114. package/.versions/2.0.10/.pi/agent-fleet/scripts/fleet.ts +216 -0
  115. package/.versions/2.0.10/.pi/agent-fleet/scripts/flow.ts +137 -0
  116. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  117. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  118. package/.versions/2.0.10/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  119. package/.versions/2.0.10/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  120. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  121. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  122. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  123. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  124. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  125. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  126. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  127. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  128. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  129. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  130. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  131. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  132. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  133. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  134. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  135. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  136. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  137. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  138. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  139. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  140. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  141. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  142. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  143. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  144. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  145. package/.versions/2.0.10/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  146. package/.versions/2.0.10/.pi/agent-fleet/scripts/package-lock.json +35 -0
  147. package/.versions/2.0.10/.pi/agent-fleet/scripts/package.json +9 -0
  148. package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  149. package/.versions/2.0.10/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  150. package/.versions/2.0.10/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  151. package/.versions/2.0.10/.pi/agent-fleet/scripts/team-up.ts +378 -0
  152. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  153. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  154. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  155. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  156. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  157. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  158. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  159. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  160. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  161. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  162. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  163. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  164. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  165. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  166. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  167. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  168. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  169. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  170. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  171. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  172. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  173. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  174. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  175. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  176. package/.versions/2.0.10/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  177. package/.versions/2.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  178. package/.versions/2.0.10/.pi/agents/model-profiles.yaml +83 -0
  179. package/.versions/2.0.10/.pi/agents/peers.yaml +147 -0
  180. package/.versions/2.0.10/.pi/agents/teams.yaml +41 -0
  181. package/.versions/2.0.10/.pi/agents/voices.yaml +13 -0
  182. package/.versions/2.0.10/.pi/damage-control-rules.yaml +297 -0
  183. package/.versions/2.0.10/.pi/extensions/btw/README.md +120 -0
  184. package/.versions/2.0.10/.pi/extensions/btw/index.ts +914 -0
  185. package/.versions/2.0.10/.pi/extensions/btw/package.json +6 -0
  186. package/.versions/2.0.10/.pi/extensions/btw/state.js +179 -0
  187. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  188. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  189. package/.versions/2.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  190. package/.versions/2.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  191. package/.versions/2.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  192. package/.versions/2.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  193. package/.versions/2.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  194. package/.versions/2.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  195. package/.versions/2.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  196. package/.versions/2.0.10/.pi/extensions/package-lock.json +1175 -0
  197. package/.versions/2.0.10/.pi/extensions/package.json +9 -0
  198. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/README.md +224 -0
  199. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  200. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  201. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  202. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  203. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  204. package/.versions/2.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  205. package/.versions/2.0.10/.pi/harnesses/agent-hub/README.md +1217 -0
  206. package/.versions/2.0.10/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  207. package/.versions/2.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  208. package/.versions/2.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  209. package/.versions/2.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  210. package/.versions/2.0.10/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  211. package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  212. package/.versions/2.0.10/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  213. package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  214. package/.versions/2.0.10/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  215. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  216. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  217. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  218. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  219. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  220. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  221. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  222. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  223. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  224. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  225. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  226. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  227. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  228. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  229. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  230. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  231. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  232. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  233. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  234. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  235. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  236. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  237. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  238. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  239. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  240. package/.versions/2.0.10/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  241. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  242. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  243. package/.versions/2.0.10/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  244. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  245. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  246. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  247. package/.versions/2.0.10/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  248. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  249. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  250. package/.versions/2.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  251. package/.versions/2.0.10/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  252. package/.versions/2.0.10/.pi/harnesses/agent-hub/delegate.ts +446 -0
  253. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  254. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  255. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  256. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  257. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  258. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  259. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  260. package/.versions/2.0.10/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  261. package/.versions/2.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  262. package/.versions/2.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  263. package/.versions/2.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  264. package/.versions/2.0.10/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  265. package/.versions/2.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  266. package/.versions/2.0.10/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  267. package/.versions/2.0.10/.pi/harnesses/agent-hub/footer.ts +30 -0
  268. package/.versions/2.0.10/.pi/harnesses/agent-hub/helpers.ts +266 -0
  269. package/.versions/2.0.10/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  270. package/.versions/2.0.10/.pi/harnesses/agent-hub/index.ts +2132 -0
  271. package/.versions/2.0.10/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  272. package/.versions/2.0.10/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  273. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  274. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  275. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  276. package/.versions/2.0.10/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  277. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  278. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  279. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  280. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  281. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  282. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  283. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  284. package/.versions/2.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  285. package/.versions/2.0.10/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  286. package/.versions/2.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  287. package/.versions/2.0.10/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  288. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  289. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  290. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  291. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  292. package/.versions/2.0.10/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  293. package/.versions/2.0.10/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  294. package/.versions/2.0.10/.pi/harnesses/agent-hub/presentation.ts +48 -0
  295. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  296. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  297. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  298. package/.versions/2.0.10/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  299. package/.versions/2.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  300. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  301. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  302. package/.versions/2.0.10/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  303. package/.versions/2.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  304. package/.versions/2.0.10/.pi/harnesses/agent-hub/return-contract.js +327 -0
  305. package/.versions/2.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  306. package/.versions/2.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  307. package/.versions/2.0.10/.pi/harnesses/agent-hub/run-budget.js +537 -0
  308. package/.versions/2.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  309. package/.versions/2.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  310. package/.versions/2.0.10/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  311. package/.versions/2.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  312. package/.versions/2.0.10/.pi/harnesses/agent-hub/session-start.ts +42 -0
  313. package/.versions/2.0.10/.pi/harnesses/agent-hub/spawn.ts +404 -0
  314. package/.versions/2.0.10/.pi/harnesses/agent-hub/timeline.ts +54 -0
  315. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  316. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  317. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  318. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  319. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +335 -0
  320. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  321. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  322. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  323. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  324. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  325. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  326. package/.versions/2.0.10/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  327. package/.versions/2.0.10/.pi/harnesses/agent-hub/types.ts +63 -0
  328. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  329. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  330. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  331. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  332. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  333. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  334. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  335. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  336. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  337. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  338. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  339. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  340. package/.versions/2.0.10/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  341. package/.versions/2.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  342. package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  343. package/.versions/2.0.10/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  344. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/README.md +59 -0
  345. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/index.ts +558 -0
  346. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  347. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  348. package/.versions/2.0.10/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  349. package/.versions/2.0.10/.pi/harnesses/coms/README.md +100 -0
  350. package/.versions/2.0.10/.pi/harnesses/coms/index.ts +282 -0
  351. package/.versions/2.0.10/.pi/harnesses/coms/package.json +7 -0
  352. package/.versions/2.0.10/.pi/harnesses/coms/version.ts +42 -0
  353. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/README.md +135 -0
  354. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/index.ts +541 -0
  355. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  356. package/.versions/2.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  357. package/.versions/2.0.10/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  358. package/.versions/2.0.10/.pi/harnesses/lib/coms-core-io.ts +385 -0
  359. package/.versions/2.0.10/.pi/harnesses/lib/coms-core.ts +577 -0
  360. package/.versions/2.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  361. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  362. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  363. package/.versions/2.0.10/.pi/harnesses/lib/context-budget-view.ts +107 -0
  364. package/.versions/2.0.10/.pi/harnesses/lib/context-budget.ts +114 -0
  365. package/.versions/2.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  366. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  367. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  368. package/.versions/2.0.10/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  369. package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  370. package/.versions/2.0.10/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  371. package/.versions/2.0.10/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  372. package/.versions/2.0.10/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  373. package/.versions/2.0.10/.pi/harnesses/lib/fleet-panel.ts +34 -0
  374. package/.versions/2.0.10/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  375. package/.versions/2.0.10/.pi/harnesses/lib/fleet-selection.ts +24 -0
  376. package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  377. package/.versions/2.0.10/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  378. package/.versions/2.0.10/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  379. package/.versions/2.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  380. package/.versions/2.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  381. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  382. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  383. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  384. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  385. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  386. package/.versions/2.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  387. package/.versions/2.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  388. package/.versions/2.0.10/.pi/harnesses/lib/update-check.ts +222 -0
  389. package/.versions/2.0.10/.pi/harnesses/package-lock.json +2039 -0
  390. package/.versions/2.0.10/.pi/harnesses/package.json +10 -0
  391. package/.versions/2.0.10/.pi/prompts/af-build.md +24 -0
  392. package/.versions/2.0.10/.pi/prompts/af-code-simplify.md +22 -0
  393. package/.versions/2.0.10/.pi/prompts/af-constraints.md +31 -0
  394. package/.versions/2.0.10/.pi/prompts/af-plan.md +17 -0
  395. package/.versions/2.0.10/.pi/prompts/af-review.md +16 -0
  396. package/.versions/2.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  397. package/.versions/2.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  398. package/.versions/2.0.10/.pi/prompts/af-ship.md +17 -0
  399. package/.versions/2.0.10/.pi/prompts/af-spec.md +15 -0
  400. package/.versions/2.0.10/.pi/prompts/af-test.md +19 -0
  401. package/.versions/2.0.10/.pi/skills/bowser/SKILL.md +145 -0
  402. package/.versions/2.0.10/.version +1 -0
  403. package/.versions/2.0.10/agents/architect.md +25 -0
  404. package/.versions/2.0.10/agents/bowser.md +28 -0
  405. package/.versions/2.0.10/agents/builder.md +56 -0
  406. package/.versions/2.0.10/agents/code-reviewer.md +210 -0
  407. package/.versions/2.0.10/agents/deep-researcher.md +33 -0
  408. package/.versions/2.0.10/agents/documenter.md +23 -0
  409. package/.versions/2.0.10/agents/orchestrator.md +23 -0
  410. package/.versions/2.0.10/agents/plan-reviewer.md +84 -0
  411. package/.versions/2.0.10/agents/planner.md +106 -0
  412. package/.versions/2.0.10/agents/releaser.md +25 -0
  413. package/.versions/2.0.10/agents/researcher.md +31 -0
  414. package/.versions/2.0.10/agents/security-auditor.md +168 -0
  415. package/.versions/2.0.10/agents/test-engineer.md +154 -0
  416. package/.versions/2.0.10/agents/web-debugger.md +44 -0
  417. package/.versions/2.0.10/agents/web-performance-auditor.md +194 -0
  418. package/.versions/2.0.10/bin/catalog/harness-runtime-closure.json +32 -0
  419. package/.versions/2.0.10/codex/fleet-session-client/SKILL.md +34 -0
  420. package/.versions/2.0.10/codex/fleet-session-client.zip +0 -0
  421. package/.versions/2.0.10/docs/ARCHITECTURE.md +416 -0
  422. package/.versions/2.0.10/docs/agent-fleet-setup.md +586 -0
  423. package/.versions/2.0.10/docs/claude-code-coms-bridge.md +134 -0
  424. package/.versions/2.0.10/docs/codex-session-bridge.md +219 -0
  425. package/.versions/2.0.10/docs/coms-hermes-bridge.md +188 -0
  426. package/.versions/2.0.10/docs/getting-started.md +126 -0
  427. package/.versions/2.0.10/docs/npm-install.md +383 -0
  428. package/.versions/2.0.10/docs/pi-extensions.md +449 -0
  429. package/.versions/2.0.10/docs/pi-setup.md +92 -0
  430. package/.versions/2.0.10/docs/skill-anatomy.md +150 -0
  431. package/.versions/2.0.10/install-manifest.json +2991 -0
  432. package/.versions/2.0.10/justfile +247 -0
  433. package/.versions/2.0.10/manifest-meta.json +970 -0
  434. package/.versions/2.0.10/references/accessibility-checklist.md +160 -0
  435. package/.versions/2.0.10/references/communication-contract.md +26 -0
  436. package/.versions/2.0.10/references/definition-of-done.md +67 -0
  437. package/.versions/2.0.10/references/fleet-coordination-patterns.md +171 -0
  438. package/.versions/2.0.10/references/observability-checklist.md +92 -0
  439. package/.versions/2.0.10/references/orchestration-patterns.md +370 -0
  440. package/.versions/2.0.10/references/performance-checklist.md +236 -0
  441. package/.versions/2.0.10/references/prompting-patterns.md +380 -0
  442. package/.versions/2.0.10/references/security-checklist.md +245 -0
  443. package/.versions/2.0.10/references/testing-patterns.md +235 -0
  444. package/.versions/2.0.10/references/workflow-authoring.md +304 -0
  445. package/.versions/2.0.10/skills/_internal/grilling.md +59 -0
  446. package/.versions/2.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  447. package/.versions/2.0.10/skills/code-review-and-quality/SKILL.md +396 -0
  448. package/.versions/2.0.10/skills/compound-learning/SKILL.md +137 -0
  449. package/.versions/2.0.10/skills/constraint-driven-development/SKILL.md +338 -0
  450. package/.versions/2.0.10/skills/constraint-driven-development/references/floor-guard.md +99 -0
  451. package/.versions/2.0.10/skills/context-engineering/SKILL.md +341 -0
  452. package/.versions/2.0.10/skills/deprecation-and-migration/SKILL.md +247 -0
  453. package/.versions/2.0.10/skills/designing-agents/SKILL.md +394 -0
  454. package/.versions/2.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  455. package/.versions/2.0.10/skills/drafting-workflows/SKILL.md +143 -0
  456. package/.versions/2.0.10/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  457. package/.versions/2.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  458. package/.versions/2.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  459. package/.versions/2.0.10/skills/idea-refine/SKILL.md +182 -0
  460. package/.versions/2.0.10/skills/idea-refine/examples.md +238 -0
  461. package/.versions/2.0.10/skills/idea-refine/frameworks.md +99 -0
  462. package/.versions/2.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  463. package/.versions/2.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  464. package/.versions/2.0.10/skills/incremental-implementation/SKILL.md +302 -0
  465. package/.versions/2.0.10/skills/interview-me/SKILL.md +226 -0
  466. package/.versions/2.0.10/skills/orchestration-verification/SKILL.md +182 -0
  467. package/.versions/2.0.10/skills/peer-coms/SKILL.md +90 -0
  468. package/.versions/2.0.10/skills/performance-optimization/SKILL.md +496 -0
  469. package/.versions/2.0.10/skills/planning-and-task-breakdown/SKILL.md +289 -0
  470. package/.versions/2.0.10/skills/security-and-hardening/SKILL.md +524 -0
  471. package/.versions/2.0.10/skills/spec-driven-development/SKILL.md +295 -0
  472. package/.versions/2.0.10/skills/using-agent-skills/SKILL.md +198 -0
  473. package/.versions/2.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  474. package/.versions/2.0.10/vendor/agent-skills-upstream/README.md +430 -0
  475. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  476. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  477. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  478. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  479. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  480. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  481. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  482. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  483. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  484. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  485. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  486. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  487. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  488. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  489. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  490. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  491. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  492. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  493. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  494. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  495. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  496. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  497. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  498. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  499. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  500. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  501. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  502. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  503. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  504. package/.versions/2.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  505. package/.versions/2.0.11/.pi/agent-fleet/hermes/README.md +347 -0
  506. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  507. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  508. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  509. package/.versions/2.0.11/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  510. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  511. package/.versions/2.0.11/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  512. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  513. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  514. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  515. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  516. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  517. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  518. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  519. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  520. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  521. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  522. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  523. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  524. package/.versions/2.0.11/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  525. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  526. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  527. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  528. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  529. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  530. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  531. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  532. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  533. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  534. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  535. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  536. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  537. package/.versions/2.0.11/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  538. package/.versions/2.0.11/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  539. package/.versions/2.0.11/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  540. package/.versions/2.0.11/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  541. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  542. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  543. package/.versions/2.0.11/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  544. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  545. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  546. package/.versions/2.0.11/.pi/agent-fleet/scripts/fleet.ts +216 -0
  547. package/.versions/2.0.11/.pi/agent-fleet/scripts/flow.ts +155 -0
  548. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  549. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  550. package/.versions/2.0.11/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  551. package/.versions/2.0.11/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  552. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  553. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  554. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  555. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  556. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  557. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  558. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  559. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  560. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  561. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  562. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  563. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  564. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  565. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  566. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  567. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  568. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  569. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  570. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  571. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  572. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  573. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  574. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  575. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  576. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  577. package/.versions/2.0.11/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  578. package/.versions/2.0.11/.pi/agent-fleet/scripts/package-lock.json +35 -0
  579. package/.versions/2.0.11/.pi/agent-fleet/scripts/package.json +9 -0
  580. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  581. package/.versions/2.0.11/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  582. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  583. package/.versions/2.0.11/.pi/agent-fleet/scripts/team-up.ts +378 -0
  584. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
  585. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  586. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  587. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  588. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  589. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  590. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  591. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  592. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  593. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  594. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  595. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  596. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  597. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  598. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  599. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  600. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  601. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  602. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  603. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  604. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  605. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  606. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  607. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  608. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  609. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  610. package/.versions/2.0.11/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  611. package/.versions/2.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  612. package/.versions/2.0.11/.pi/agents/model-profiles.yaml +83 -0
  613. package/.versions/2.0.11/.pi/agents/peers.yaml +147 -0
  614. package/.versions/2.0.11/.pi/agents/teams.yaml +41 -0
  615. package/.versions/2.0.11/.pi/agents/voices.yaml +13 -0
  616. package/.versions/2.0.11/.pi/damage-control-rules.yaml +297 -0
  617. package/.versions/2.0.11/.pi/extensions/btw/README.md +120 -0
  618. package/.versions/2.0.11/.pi/extensions/btw/index.ts +914 -0
  619. package/.versions/2.0.11/.pi/extensions/btw/package.json +6 -0
  620. package/.versions/2.0.11/.pi/extensions/btw/state.js +179 -0
  621. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  622. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  623. package/.versions/2.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  624. package/.versions/2.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  625. package/.versions/2.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  626. package/.versions/2.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  627. package/.versions/2.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  628. package/.versions/2.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  629. package/.versions/2.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  630. package/.versions/2.0.11/.pi/extensions/package-lock.json +1175 -0
  631. package/.versions/2.0.11/.pi/extensions/package.json +9 -0
  632. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/README.md +224 -0
  633. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  634. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  635. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  636. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  637. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  638. package/.versions/2.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  639. package/.versions/2.0.11/.pi/harnesses/agent-hub/README.md +1252 -0
  640. package/.versions/2.0.11/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  641. package/.versions/2.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  642. package/.versions/2.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  643. package/.versions/2.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  644. package/.versions/2.0.11/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  645. package/.versions/2.0.11/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  646. package/.versions/2.0.11/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  647. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  648. package/.versions/2.0.11/.pi/harnesses/agent-hub/budget-recovery.ts +191 -0
  649. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  650. package/.versions/2.0.11/.pi/harnesses/agent-hub/capability-packs.ts +183 -0
  651. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  652. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  653. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  654. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  655. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  656. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  657. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  658. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  659. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  660. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  661. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  662. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  663. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  664. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  665. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  666. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  667. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/context.ts +44 -0
  668. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  669. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  670. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  671. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  672. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  673. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  674. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  675. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  676. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  677. package/.versions/2.0.11/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  678. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  679. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
  680. package/.versions/2.0.11/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  681. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  682. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  683. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  684. package/.versions/2.0.11/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  685. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  686. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  687. package/.versions/2.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  688. package/.versions/2.0.11/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  689. package/.versions/2.0.11/.pi/harnesses/agent-hub/delegate.ts +463 -0
  690. package/.versions/2.0.11/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  691. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  692. package/.versions/2.0.11/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  693. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  694. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  695. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-complete.ts +163 -0
  696. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
  697. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +197 -0
  698. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native-types.ts +245 -0
  699. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  700. package/.versions/2.0.11/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  701. package/.versions/2.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  702. package/.versions/2.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  703. package/.versions/2.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  704. package/.versions/2.0.11/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  705. package/.versions/2.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  706. package/.versions/2.0.11/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  707. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/registration-surface.json +60 -0
  708. package/.versions/2.0.11/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  709. package/.versions/2.0.11/.pi/harnesses/agent-hub/footer.ts +30 -0
  710. package/.versions/2.0.11/.pi/harnesses/agent-hub/helpers.ts +270 -0
  711. package/.versions/2.0.11/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  712. package/.versions/2.0.11/.pi/harnesses/agent-hub/index.ts +2263 -0
  713. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  714. package/.versions/2.0.11/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  715. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  716. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  717. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  718. package/.versions/2.0.11/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  719. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  720. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  721. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  722. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  723. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  724. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  725. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  726. package/.versions/2.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  727. package/.versions/2.0.11/.pi/harnesses/agent-hub/no-progress.ts +206 -0
  728. package/.versions/2.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  729. package/.versions/2.0.11/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  730. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  731. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  732. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  733. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  734. package/.versions/2.0.11/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  735. package/.versions/2.0.11/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  736. package/.versions/2.0.11/.pi/harnesses/agent-hub/presentation.ts +48 -0
  737. package/.versions/2.0.11/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  738. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
  739. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  740. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  741. package/.versions/2.0.11/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  742. package/.versions/2.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  743. package/.versions/2.0.11/.pi/harnesses/agent-hub/recovery-contract.ts +78 -0
  744. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  745. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
  746. package/.versions/2.0.11/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
  747. package/.versions/2.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  748. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-contract.js +327 -0
  749. package/.versions/2.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  750. package/.versions/2.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  751. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-budget.js +537 -0
  752. package/.versions/2.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  753. package/.versions/2.0.11/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  754. package/.versions/2.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  755. package/.versions/2.0.11/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  756. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-audit.ts +161 -0
  757. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  758. package/.versions/2.0.11/.pi/harnesses/agent-hub/session-start.ts +42 -0
  759. package/.versions/2.0.11/.pi/harnesses/agent-hub/spawn.ts +458 -0
  760. package/.versions/2.0.11/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  761. package/.versions/2.0.11/.pi/harnesses/agent-hub/timeline.ts +54 -0
  762. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  763. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  764. package/.versions/2.0.11/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  765. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  766. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  767. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  768. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  769. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +485 -0
  770. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  771. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  772. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  773. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  774. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  775. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  776. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  777. package/.versions/2.0.11/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  778. package/.versions/2.0.11/.pi/harnesses/agent-hub/types.ts +65 -0
  779. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  780. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  781. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  782. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  783. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  784. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  785. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  786. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  787. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  788. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  789. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  790. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  791. package/.versions/2.0.11/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  792. package/.versions/2.0.11/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  793. package/.versions/2.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  794. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  795. package/.versions/2.0.11/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  796. package/.versions/2.0.11/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  797. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/README.md +59 -0
  798. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/index.ts +558 -0
  799. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  800. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  801. package/.versions/2.0.11/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  802. package/.versions/2.0.11/.pi/harnesses/coms/README.md +100 -0
  803. package/.versions/2.0.11/.pi/harnesses/coms/index.ts +282 -0
  804. package/.versions/2.0.11/.pi/harnesses/coms/package.json +7 -0
  805. package/.versions/2.0.11/.pi/harnesses/coms/version.ts +42 -0
  806. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/README.md +135 -0
  807. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/index.ts +550 -0
  808. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  809. package/.versions/2.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  810. package/.versions/2.0.11/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  811. package/.versions/2.0.11/.pi/harnesses/lib/coms-core-io.ts +385 -0
  812. package/.versions/2.0.11/.pi/harnesses/lib/coms-core.ts +577 -0
  813. package/.versions/2.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  814. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  815. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  816. package/.versions/2.0.11/.pi/harnesses/lib/context-budget-view.ts +107 -0
  817. package/.versions/2.0.11/.pi/harnesses/lib/context-budget.ts +114 -0
  818. package/.versions/2.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  819. package/.versions/2.0.11/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  820. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  821. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  822. package/.versions/2.0.11/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  823. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  824. package/.versions/2.0.11/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  825. package/.versions/2.0.11/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  826. package/.versions/2.0.11/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  827. package/.versions/2.0.11/.pi/harnesses/lib/fleet-panel.ts +34 -0
  828. package/.versions/2.0.11/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  829. package/.versions/2.0.11/.pi/harnesses/lib/fleet-selection.ts +24 -0
  830. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  831. package/.versions/2.0.11/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  832. package/.versions/2.0.11/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  833. package/.versions/2.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  834. package/.versions/2.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  835. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  836. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  837. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  838. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  839. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  840. package/.versions/2.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  841. package/.versions/2.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  842. package/.versions/2.0.11/.pi/harnesses/lib/update-check.ts +222 -0
  843. package/.versions/2.0.11/.pi/harnesses/package-lock.json +2039 -0
  844. package/.versions/2.0.11/.pi/harnesses/package.json +10 -0
  845. package/.versions/2.0.11/.pi/prompts/af-build.md +24 -0
  846. package/.versions/2.0.11/.pi/prompts/af-code-simplify.md +22 -0
  847. package/.versions/2.0.11/.pi/prompts/af-constraints.md +31 -0
  848. package/.versions/2.0.11/.pi/prompts/af-plan.md +17 -0
  849. package/.versions/2.0.11/.pi/prompts/af-review.md +16 -0
  850. package/.versions/2.0.11/.pi/prompts/af-set-hermes-telegram.md +15 -0
  851. package/.versions/2.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  852. package/.versions/2.0.11/.pi/prompts/af-ship.md +17 -0
  853. package/.versions/2.0.11/.pi/prompts/af-spec.md +15 -0
  854. package/.versions/2.0.11/.pi/prompts/af-test.md +19 -0
  855. package/.versions/2.0.11/.pi/skills/bowser/SKILL.md +145 -0
  856. package/.versions/2.0.11/.version +1 -0
  857. package/.versions/2.0.11/agents/architect.md +25 -0
  858. package/.versions/2.0.11/agents/bowser.md +28 -0
  859. package/.versions/2.0.11/agents/builder.md +56 -0
  860. package/.versions/2.0.11/agents/code-reviewer.md +210 -0
  861. package/.versions/2.0.11/agents/deep-researcher.md +33 -0
  862. package/.versions/2.0.11/agents/documenter.md +23 -0
  863. package/.versions/2.0.11/agents/orchestrator.md +23 -0
  864. package/.versions/2.0.11/agents/plan-reviewer.md +84 -0
  865. package/.versions/2.0.11/agents/planner.md +106 -0
  866. package/.versions/2.0.11/agents/releaser.md +25 -0
  867. package/.versions/2.0.11/agents/researcher.md +31 -0
  868. package/.versions/2.0.11/agents/security-auditor.md +168 -0
  869. package/.versions/2.0.11/agents/test-engineer.md +154 -0
  870. package/.versions/2.0.11/agents/web-debugger.md +44 -0
  871. package/.versions/2.0.11/agents/web-performance-auditor.md +194 -0
  872. package/.versions/2.0.11/bin/catalog/harness-runtime-closure.json +61 -0
  873. package/.versions/2.0.11/codex/fleet-session-client/SKILL.md +34 -0
  874. package/.versions/2.0.11/codex/fleet-session-client.zip +0 -0
  875. package/.versions/2.0.11/docs/ARCHITECTURE.md +595 -0
  876. package/.versions/2.0.11/docs/agent-fleet-setup.md +586 -0
  877. package/.versions/2.0.11/docs/claude-code-coms-bridge.md +134 -0
  878. package/.versions/2.0.11/docs/codex-session-bridge.md +219 -0
  879. package/.versions/2.0.11/docs/coms-hermes-bridge.md +188 -0
  880. package/.versions/2.0.11/docs/getting-started.md +126 -0
  881. package/.versions/2.0.11/docs/npm-install.md +383 -0
  882. package/.versions/2.0.11/docs/pi-extensions.md +449 -0
  883. package/.versions/2.0.11/docs/pi-setup.md +92 -0
  884. package/.versions/2.0.11/docs/skill-anatomy.md +150 -0
  885. package/.versions/2.0.11/install-manifest.json +3020 -0
  886. package/.versions/2.0.11/justfile +247 -0
  887. package/.versions/2.0.11/manifest-meta.json +970 -0
  888. package/.versions/2.0.11/references/accessibility-checklist.md +160 -0
  889. package/.versions/2.0.11/references/communication-contract.md +26 -0
  890. package/.versions/2.0.11/references/definition-of-done.md +67 -0
  891. package/.versions/2.0.11/references/fleet-coordination-patterns.md +171 -0
  892. package/.versions/2.0.11/references/observability-checklist.md +92 -0
  893. package/.versions/2.0.11/references/orchestration-patterns.md +370 -0
  894. package/.versions/2.0.11/references/performance-checklist.md +236 -0
  895. package/.versions/2.0.11/references/prompting-patterns.md +380 -0
  896. package/.versions/2.0.11/references/security-checklist.md +245 -0
  897. package/.versions/2.0.11/references/testing-patterns.md +235 -0
  898. package/.versions/2.0.11/references/workflow-authoring.md +304 -0
  899. package/.versions/2.0.11/skills/_internal/grilling.md +59 -0
  900. package/.versions/2.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  901. package/.versions/2.0.11/skills/code-review-and-quality/SKILL.md +396 -0
  902. package/.versions/2.0.11/skills/compound-learning/SKILL.md +137 -0
  903. package/.versions/2.0.11/skills/constraint-driven-development/SKILL.md +338 -0
  904. package/.versions/2.0.11/skills/constraint-driven-development/references/floor-guard.md +99 -0
  905. package/.versions/2.0.11/skills/context-engineering/SKILL.md +341 -0
  906. package/.versions/2.0.11/skills/deprecation-and-migration/SKILL.md +247 -0
  907. package/.versions/2.0.11/skills/designing-agents/SKILL.md +394 -0
  908. package/.versions/2.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  909. package/.versions/2.0.11/skills/drafting-workflows/SKILL.md +143 -0
  910. package/.versions/2.0.11/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  911. package/.versions/2.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  912. package/.versions/2.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  913. package/.versions/2.0.11/skills/idea-refine/SKILL.md +182 -0
  914. package/.versions/2.0.11/skills/idea-refine/examples.md +238 -0
  915. package/.versions/2.0.11/skills/idea-refine/frameworks.md +99 -0
  916. package/.versions/2.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  917. package/.versions/2.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  918. package/.versions/2.0.11/skills/incremental-implementation/SKILL.md +302 -0
  919. package/.versions/2.0.11/skills/interview-me/SKILL.md +226 -0
  920. package/.versions/2.0.11/skills/orchestration-verification/SKILL.md +182 -0
  921. package/.versions/2.0.11/skills/peer-coms/SKILL.md +90 -0
  922. package/.versions/2.0.11/skills/performance-optimization/SKILL.md +496 -0
  923. package/.versions/2.0.11/skills/planning-and-task-breakdown/SKILL.md +289 -0
  924. package/.versions/2.0.11/skills/security-and-hardening/SKILL.md +524 -0
  925. package/.versions/2.0.11/skills/spec-driven-development/SKILL.md +295 -0
  926. package/.versions/2.0.11/skills/using-agent-skills/SKILL.md +198 -0
  927. package/.versions/2.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  928. package/.versions/2.0.11/vendor/agent-skills-upstream/README.md +430 -0
  929. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  930. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  931. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  932. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  933. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  934. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  935. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  936. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  937. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  938. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  939. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  940. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  941. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  942. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  943. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  944. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  945. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  946. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  947. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  948. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  949. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  950. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  951. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  952. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  953. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  954. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  955. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  956. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  957. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  958. package/.versions/2.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  959. package/CHANGELOG.md +19 -0
  960. package/README.md +1 -0
  961. package/agents/architect.md +1 -1
  962. package/agents/bowser.md +1 -1
  963. package/agents/builder.md +1 -1
  964. package/agents/code-reviewer.md +1 -1
  965. package/agents/deep-researcher.md +1 -1
  966. package/agents/documenter.md +1 -1
  967. package/agents/orchestrator.md +1 -1
  968. package/agents/plan-reviewer.md +1 -1
  969. package/agents/planner.md +1 -1
  970. package/agents/releaser.md +1 -1
  971. package/agents/researcher.md +1 -1
  972. package/agents/security-auditor.md +1 -1
  973. package/agents/test-engineer.md +1 -1
  974. package/agents/web-debugger.md +1 -1
  975. package/agents/web-performance-auditor.md +1 -1
  976. package/bin/catalog/harness-runtime-closure.json +29 -0
  977. package/bin/cli.js +23 -9
  978. package/bin/lib/doctor.js +83 -1
  979. package/bin/lib/path-boundaries.js +5 -6
  980. package/bin/lib/stt-wizard.js +154 -23
  981. package/docs/ARCHITECTURE.md +181 -2
  982. package/docs/agent-fleet-setup.md +26 -8
  983. package/docs/npm-install.md +29 -2
  984. package/docs/pi-setup.md +16 -0
  985. package/docs/workflows.md +8 -2
  986. package/install-manifest.json +31 -2
  987. package/package.json +13 -3
  988. package/skills/orchestration-verification/SKILL.md +1 -0
@@ -0,0 +1,416 @@
1
+ # Agent Fleet Architecture
2
+
3
+ Agent Fleet is a Pi-centered multi-agent orchestration system. This page maps
4
+ the runtime responsibilities and where each module lives in the repository.
5
+
6
+ ## Runtime layers
7
+
8
+ | Layer | Role | Implementation |
9
+ | --- | --- | --- |
10
+ | **Pi Coding Agent** | Primary local runtime — runs the dispatcher and specialist subagents | `.pi/harnesses/`, `.pi/extensions/`, `.pi/agents/`, `.pi/prompts/` |
11
+ | **agent-hub** | Thin-context multi-agent harness: dispatcher + specialists + research helpers + Verification Contract | `.pi/harnesses/agent-hub/` |
12
+ | **Workflows** | Headless, code-owned phase order, retries, gates, writes enforcement, and acceptance through `just flow` | `.pi/agent-fleet/scripts/flow.ts`, `.pi/agent-fleet/scripts/workflows/` — see [workflows.md](workflows.md) |
13
+ | **Herdr** | Fleet/workspace control plane — spawns peer teams as tiled workspaces, presence via push events, snapshot/resume | [herdr.dev](https://herdr.dev); client in `.pi/harnesses/lib/herdr-client.ts`, layout in `.pi/agent-fleet/scripts/lib/herdr-layout.ts` |
14
+ | **coms** | Peer communication protocol/data plane — envelope-based P2P messaging between agents | Shared peer lifecycle in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; Pi registrations in `.pi/harnesses/coms/` and `agent-hub/`; wire helpers in `.pi/agent-fleet/scripts/lib/coms-envelope.ts` and `.pi/agent-fleet/scripts/coms-cli.ts` |
15
+ | **Claude Code bridge** | Makes an interactive Claude Code pane a bidirectional coms peer | `.pi/agent-fleet/scripts/coms-claude-bridge.ts`, `.pi/agent-fleet/hooks/coms-stop-hook.mjs`, `skills/peer-coms/` — see [claude-code-coms-bridge.md](claude-code-coms-bridge.md) |
16
+ | **Hermes bridge** | Remote human control — relays hub questions to Telegram, races phone vs. local answers, conductor/liaison skills | `.pi/agent-fleet/scripts/coms-hermes-bridge.ts`, `.pi/harnesses/ask-user-remote/`, `.pi/agent-fleet/hermes/skills/` — see [coms-hermes-bridge.md](coms-hermes-bridge.md) |
17
+ | **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `.pi/agent-fleet/scripts/lib/`) — see [Hermes artifacts](../.pi/agent-fleet/hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
18
+ | **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `.pi/agent-fleet/scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
19
+ | **ChatGPT Fleet session client** | Experimental ChatGPT-initiated client for an existing Pi session; no daemon or idle wake | `.pi/agent-fleet/scripts/fleet-codex-client.ts`, `.pi/agent-fleet/scripts/lib/fleet-codex-*`, opt-in feature `chatgpt-client` — see [codex-session-bridge.md](codex-session-bridge.md) |
20
+ | **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
21
+ | **Personas** | Reusable specialist definitions, installed verbatim | `agents/` in the package → `.pi/agents/personas/` in a workspace; `bin/lib/personas.js` |
22
+
23
+ ## One Hub runtime, independent axes
24
+
25
+ Every public Pi launch through `just fleet` loads Fleet Core and the `agent-hub`
26
+ harness. Three independent choices shape that runtime:
27
+
28
+ | Axis | Choices | What it controls |
29
+ | --- | --- | --- |
30
+ | **Work Mode** | `operator`, `orchestrator` | Whether the main agent may use direct coding tools. Operator retains the captured `read`/`bash`/`edit`/`write` and approved extension surface; orchestrator removes direct coding tools and keeps dispatch, research, assertions, `ask_user`, and available coms/Herdr tools. `/af-work-mode` and **Alt+M** switch this axis. |
31
+ | **Native roster** | empty or one entry from `.pi/agents/teams.yaml` | Which in-process Pi specialist personas `dispatch_agent` may start. Roster changes do not change work mode in a live session. |
32
+ | **Peer topology** | current terminal, Hub-only Herdr workspace, or Hub plus a `.pi/agents/peers.yaml` preset | Which separate, addressable Pi/Claude processes occupy sibling panes. Starting or spawning peers does not change work mode or the native roster. |
33
+
34
+ Bare `just fleet` therefore means operator work mode, an empty native roster, and
35
+ the current terminal. At startup an explicit `--work-mode` wins; otherwise
36
+ `--agents <roster>` implies orchestrator; otherwise operator is used. An
37
+ orchestrator startup requires a roster. `/af-work-mode` and **Alt+M** switch
38
+ only work mode in the live session, and `/af-agents-*` changes
39
+ only the native roster. Dispatch, research, nested delegation, and Verification
40
+ Contract rigor follow the **task tier** (`trivial`/`small`/`feature`/`project`),
41
+ not a session execution mode.
42
+
43
+ All Hub-owned slash commands remain registered in both work modes. Capability packs are resolved automatically from explicit task intent, work mode, tier, pending work, and compaction state—there is no activation command. Runtime **readiness** (a coms or Herdr connection) is not model-visible capability: ready-but-unrequested peer/workspace packs remain inactive. Ambiguous fleet, peer, and workspace requests are provisionally visible but require one `ask_user` confirmation before their first side effect; a rejection removes the provisional pack. Task packs persist across follow-ups and reset only through `set_task_tier(new_task: true)`, while mandatory work mode and pending-operation leases remain.
44
+
45
+ `/af-context` is a standalone, read-only full-screen budget diagnostic; it separates stable prompt cost, volatile state, active schemas, and zero-cost inactive/loaded-excluded inputs. Provider totals and cache read/write fields are authoritative where Pi supplies them; it never fabricates provider usage or combines capacity percentages across Hub, child, and peer planes. Managed specialists and research children use explicit replacement prompts/context manifests with selected persona, policy, and skill paths instead of inherited global skills/context files. Runtime gates control whether an action can proceed: without coms, Herdr, a visible target, or an active roster, the corresponding command refuses with an actionable message rather than disappearing. `--browser` and `--all-extensions` expand the captured operator surface only when those optional extensions are installed.
46
+
47
+ ### Context pressure and recovery
48
+
49
+ Standing prompt ceilings constrain the repeatable replacement prompt and active schemas; they do not
50
+ bound conversation messages or results accumulated inside a long tool loop. The Hub therefore has a
51
+ second, runtime pressure guard. It samples provider usage, projects a finalized tool result at
52
+ `message_end`, warns and exposes transient compaction support at **80%**, then at **90%** aborts the
53
+ pre-model continuation and waits for `agent_settled` before requesting one Pi compaction. This
54
+ ordering ensures the result is persisted before summarization and prevents an ordinary provider call
55
+ from escaping between pressure detection and recovery.
56
+
57
+ Recovery is single-flight. High-context startup or concurrent input is retained in memory and
58
+ replayed exactly once after success; failure retains it for `/compact` or a larger-context model.
59
+ `/af-context` and the status line report phase, usage, thresholds, episode, and last outcome. Session
60
+ entries store only numeric/enumerated pressure metadata, never prompts, tool payloads, credentials,
61
+ error bodies, or summaries.
62
+
63
+ A persisted native roster is also metadata, not copied configuration: only its team name is stored
64
+ and it is re-resolved against current teams and persona definitions. A stale or absent roster in a
65
+ resumed orchestrator session fails closed—work mode remains orchestrator, direct tools remain removed,
66
+ and model input is blocked until `/af-agents-team`, an explicit `--agent-team <name>` restart, or an
67
+ explicit operator selection resolves it. Explicit CLI work mode and roster selections retain
68
+ precedence.
69
+
70
+ Pi's session JSONL is the authoritative append-only record for rebuilding a session, including
71
+ compaction and Hub metadata. Pressure and roster recovery operate through Pi/Hub lifecycle APIs;
72
+ they never rewrite prior entries. Operators must not edit, truncate, reorder, or synthesize JSONL to
73
+ recover a session.
74
+
75
+ The project selected by `--project <name>` is the coms namespace for the Hub
76
+ and every standing or dynamically spawned peer. The Hub-facing peer spawn API
77
+ cannot override it. Native subagents remain children of that Hub and inherit
78
+ its repository context; peers are separate processes in their own panes.
79
+
80
+ At dispatch time, `backend: "auto"` applies
81
+ `.pi/agents/dispatch-policy.yaml`; `backend: "native"` bypasses same-name peer
82
+ substitution; and `backend: "coms"` requires a visible same-name peer and never
83
+ falls back to a native child. `.pi/agents/peers.yaml` owns how a peer runs
84
+ (`runner`, persona, model, extensions, and declared `env_file`), not whether a
85
+ dispatch uses it.
86
+
87
+ ## Fleet hierarchy
88
+
89
+ Agent Fleet is layered on purpose. Work flows **down** (delegate); evidence and status flow **up** — as compact structured returns, never raw dumps.
90
+
91
+ ```mermaid
92
+ flowchart TD
93
+ You(["You · Hermes inbound relay · Codex outbound conductor on your phone"])
94
+
95
+ subgraph HUBL["HUB — guarded runtime (bare just fleet)"]
96
+ Hub["agent-hub harness<br/>operator or orchestrator work mode · routes tasks<br/>owns the Verification Contract on disk · keeps research dumps out of its own context"]
97
+ end
98
+
99
+ subgraph TEAML["OPTIONAL NATIVE ROSTER (.pi/agents/teams.yaml)"]
100
+ Team["default: builder · test-engineer · code-reviewer · documenter<br/>also: plan · debug · frontend · security · hotfix · release · info"]
101
+ end
102
+
103
+ subgraph RESL["RESEARCH HELPERS — read-only, always available"]
104
+ Research["researcher (fast tier — simple reads)<br/>deep-researcher (deep tier — hard, cross-cutting questions)"]
105
+ end
106
+
107
+ subgraph SUBL["SUB-AGENTS — focused children, narrow tools + models"]
108
+ Subs["planner → scout · rules · risk<br/>plan-reviewer → feasibility · deps<br/>builder → recon · verifier<br/>test-engineer → coverage-scout · conventions<br/>code-reviewer → preflight · quality · perf · docs<br/>security-auditor → recon · input-sweep · secrets-sweep"]
109
+ end
110
+
111
+ You -->|task| Hub
112
+ Hub -->|"dispatch_agent — one persona = one specialist session"| Team
113
+ Hub -->|"spawn_research"| Research
114
+ Research -.->|"findings written to disk — hub gets paths, not dumps"| Hub
115
+ Team -->|"subagents: block (delegate_depth ≥ 1)"| Subs
116
+ Subs -.->|"results return to the parent agent only"| Team
117
+ Team -.->|"structured return + evidence"| Hub
118
+ Hub -.->|"one status line: Assertions: 2✓ 1○ 1✗"| You
119
+ ```
120
+
121
+ Every specialist session is one persona from [`agents/`](../agents/) (installed to `.pi/agents/personas/`) — *skills* tell each agent **how** to work; *personas* define **who** they are (see [agents.md](agents.md)).
122
+
123
+ The same idea as a tree:
124
+
125
+ ```text
126
+ hub (operator by default; orchestrator when selected)
127
+ ├── optional native roster (empty by default; example: default)
128
+ │ ├── builder → recon · verifier
129
+ │ ├── test-engineer → coverage-scout · conventions
130
+ │ ├── code-reviewer → preflight · quality · perf · docs
131
+ │ └── documenter
132
+ ├── research helpers (spawn_research, any time)
133
+ │ ├── researcher
134
+ │ └── deep-researcher
135
+ └── optional fleet peers (herdr + coms)
136
+ ├── architect / releaser / web-debugger panes
137
+ ├── Claude Code peer (coms bridge)
138
+ ├── Hermes (phone human · inbound ask_user)
139
+ └── ChatGPT Fleet session client (Desktop/Android · existing Pi session)
140
+ ```
141
+
142
+ Composition rule: **the hub (or a slash command) orchestrates; personas do not invoke other personas as peers.** Specialists may only fan out to their configured **sub-agents**. Research helpers write findings to disk; the hub resumes specialists with paths, not raw dumps.
143
+
144
+ ### Research search supervision
145
+
146
+ The shared `spawnPiAgent` seam supervises every `read`/`grep`/`find`/`ls` call from native
147
+ research helpers and nested delegate children. The supervisor tracks JSONL `toolCallId` values
148
+ independently, with a default 120-second deadline (`recon-search-timeout-s: 1..3600|off` under
149
+ `## agent-hub`). It is a per-tool watchdog; the whole-run bound is separate — the task-tier
150
+ per-run deadline (`agent-turn-timeout-s`), which terminates a hung run as `turn_timeout`.
151
+ On timeout or caller cancellation it owns and terminates the child's process group (SIGTERM,
152
+ then SIGKILL after a bounded grace), has a separate settlement timer for missing `close`/pipe
153
+ drain, and reports timeout separately from cancellation. Research helpers and nested delegates
154
+ are each given safe process-group ownership; delegates forward parent termination so no detached
155
+ child is orphaned. Full pattern catalog: [references/orchestration-patterns.md](../references/orchestration-patterns.md).
156
+
157
+ ### Task-tier budgets
158
+
159
+ The hub enforces per-user-turn budgets in code (`run-budget.js`): the current **task tier**
160
+ caps `dispatch_agent` calls, `spawn_research` calls, and active time per turn, sets the
161
+ per-run deadline above, and controls nested delegation (`off` at trivial/small). Exhausted
162
+ budgets make the dispatch tools refuse and request one Yes/No `ask_user` confirmation; Yes
163
+ renews the turn in the same tool loop. A normal new user message also opens a fresh turn
164
+ window.
165
+ Specialist context pressure is measured over input + cacheRead + cacheWrite against **that
166
+ agent's own** model window, resolved from pi's model registry with the source recorded
167
+ (`context-window.js`) — measuring a 49k local model against the dispatcher's window is what
168
+ made readings like "315%" unactionable; anything over 100% now emits a one-time diagnostic
169
+ naming the window and where it came from. Specialist sessions are recycled (fresh spawn
170
+ instead of `-c` resume) after `session-recycle-runs` runs, at ≥60% measured context, and
171
+ unconditionally at a full window; a resumed session whose *projected* prompt would overflow
172
+ is recycled before the spawn rather than after the run. Requests to one provider are capped
173
+ per process (`provider-semaphore.js`: 2 in flight for `custom/*` by default, unlimited
174
+ elsewhere, `AGENT_HUB_PROVIDER_LIMITS` to override) — the cap is per level of the delegation
175
+ tree, and a nested spawn reuses its parent's permit so it can never wait on its own ancestor.
176
+ Configured under `## agent-hub` (`max-dispatches-per-turn`,
177
+ `max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`,
178
+ `run-history-keep`) as ceilings (`min` with the tier). A leftover `mode:` key is ignored with
179
+ a warning.
180
+
181
+ A per-message allowance cannot bound a task, so a second envelope sits above the turn one:
182
+ the **task budget** (`run-budget.js`, `3×` the turn envelope) counts dispatches, research
183
+ runs and **active** time across the WHOLE task and is *not* reset by a user message. Both turn
184
+ and task active time exclude `ask_user` waits — billing human idle false-stops a normal steered
185
+ session and teaches people to reset reflexively. The auto-research pipe is exempt from the turn
186
+ budget but charged against the task envelope, so it cannot smuggle 8 helpers per dispatch past
187
+ the outer bound.
188
+
189
+ Either envelope stops before another dispatch/research call and asks one localized Yes/No
190
+ `ask_user` question. A confirmed turn continuation renews its counters/clock in the same tool
191
+ loop. A confirmed task continuation opens one audited tranche, also renews the turn, and
192
+ preserves task tier, assertions, capability packs, label, blockers, and progress. No typed
193
+ `continue` message or slash command is required. `set_task_tier` with `new_task: true` is only
194
+ for genuinely different work and clears task identity/state. This is the guardrail the
195
+ post-mortem run never hit: every steering message reopened the turn window,
196
+ so one workspace stayed open 47 hours on a change that took 13 minutes in a narrow one.
197
+
198
+ On top of the tier envelope sit several qualitative guardrails. **Task triage**: the dispatcher
199
+ classifies the current TASK via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
200
+ and that classification *is* the budget. The tier is task-scoped and **ratcheted** — it survives
201
+ the user's next message, lowering is free, raising needs a stated `reason` — because a
202
+ turn-scoped tier reset to `feature` on every correction. Three refusals enforce
203
+ proportionality in code rather than prose: a duplicate-dispatch guard (near-identical
204
+ re-dispatches within a turn), a **tier persona gate** (`planner`, `plan-reviewer`,
205
+ `architect`, `security-auditor`, `deep-researcher` are refused at trivial/small — each opens
206
+ a document/finding loop), and a **review round cap** (review dispatches per task, by tier).
207
+ Skipping triage assumes `small`, not `feature`: the tier latches for the task, and the case
208
+ where it was never declared is exactly the case where proportionality was not being
209
+ considered. The review **finding** budget is the one thing deliberately left advisory — the
210
+ hub counts blocking findings (`review-findings.js`) and reports an over-budget return, but
211
+ never reclassifies one, because no rule it can evaluate separates an invented manifest from
212
+ a leaked credential; the round cap is what carries the enforcement.
213
+ **Docs lane** (`docs-lane.js`): a dispatch whose whole declared `scope` is documentation
214
+ refuses review personas (overridable with `review_reason`) and tells the dispatcher not to
215
+ open a review gate; an absent scope is never the lighter lane. **External-blocker stop**
216
+ (`external-blocker.js`): a specialist emits `EXTERNAL_BLOCKED: …` when it needs something
217
+ outside the fleet's reach (account, permission, credential, telemetry destination), and the
218
+ hub refuses the next dispatch with an owner-escalation packet until the human is addressed —
219
+ the alternative, observed, is hours spent approximating the missing fact with scripts,
220
+ manifests and fixtures while the assertion still ends UNPROVEN. **Drift watchdog**
221
+ (`drift-watchdog.js`): armed dispatches are
222
+ observed in-flight from the JSON event stream — deterministic rules (out-of-scope writes
223
+ against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
224
+ escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
225
+ `drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
226
+ (`watchdog` key, `/af-watchdog`, `watchdog` param). Orchestrator work mode auto-arms the
227
+ watchdog when the hub setting is `auto`/`on`; a dispatch `watchdog: false` cannot disarm it
228
+ there. Hub or per-agent `off` remains the opt-out. Two rules about scope: the session's
229
+ own `artifacts/`, `findings/`, and `delegations/` subtrees are implicitly in scope (the
230
+ deliverable protocol *orders* specialists to write there, and the judge is told so), and the
231
+ `scope` rule is non-terminal — it reports a drift advisory on the result and never stops a
232
+ run by itself, matching the post-run scope gate, which reverts nothing. **Dynamic teams**: `/af-agents-add`,
233
+ `/af-agents-drop`, `/af-agents-save` restructure the roster live (the system prompt rebuilds
234
+ every turn), and the gated `team_adjust` tool lets the dispatcher itself adjust the roster
235
+ when nested delegation is on (feature/project), with user notification. `/af-hub-report` accounts each turn's dispatches,
236
+ tokens (billed = input + cacheRead + cacheWrite), recycles, drift stops, and refusals.
237
+
238
+ ## Runtime stack (tools the fleet sits on)
239
+
240
+ ```mermaid
241
+ flowchart TD
242
+ AF["<b>Agent Fleet</b><br/>agent-hub · personas · skills · coms · bridges · CLI"]
243
+ AF -->|primary runtime| PI["<b>pi</b><br/>coding agent — loads harnesses,<br/>extensions, prompts, personas"]
244
+ AF -->|control plane| HERDR["<b>herdr</b><br/>tiled peer workspaces,<br/>presence, snapshot/resume"]
245
+ AF -->|coms peer only| CC["<b>Claude Code</b><br/>bidirectional peer via<br/>the coms bridge<br/><i>not an install target</i>"]
246
+ AF -->|remote human| HERMES["<b>Hermes</b><br/>hub questions relayed to your phone,<br/>plus the Desktop fleet panel"]
247
+ AF -->|ChatGPT-initiated session client| CODEX["<b>ChatGPT Fleet session client</b><br/>existing Pi session via<br/>opt-in chatgpt-client (experimental)"]
248
+ ```
249
+
250
+ ### External dependencies
251
+
252
+ These are the external systems Agent Fleet assumes or integrates with — not npm packages, but the **runtime stack** the fleet operates on top of.
253
+
254
+ | Dependency | Role | Required? |
255
+ | --- | --- | --- |
256
+ | **[pi](https://github.com/badlogic/pi-mono)** (or your pi install) | Primary coding-agent runtime; loads harnesses, extensions, prompts, and personas | Yes for `just fleet` |
257
+ | **[herdr](https://herdr.dev)** | Workspace control plane: Hub/peer panes, presence push events, team snapshot/resume | Required for `--herdr` or `--peers`; optional for bare `just fleet` |
258
+ | **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | First-class coms peer via the [coms bridge](claude-code-coms-bridge.md) — cross-model review and analysis. Never an install target: it hosts no skills, commands, or personas | Optional peer |
259
+ | **Hermes** | Remote human-in-the-loop (Telegram relay for hub questions — [coms-hermes-bridge](coms-hermes-bridge.md)) and the Desktop fleet panel ([hermes-desktop-plugins](hermes-desktop-plugins.md), needs v0.19.0+ and the Desktop app) | Optional |
260
+ | **ChatGPT Desktop/Android** | Experimental opt-in Fleet session client for an existing Pi session; Node 22.18+, Python 3.10+, local herdr/coms access — [runbook](codex-session-bridge.md) | Optional experimental feature `chatgpt-client` |
261
+ | **[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)** | Upstream skill library (manually vendored) | Bundled (vendored) |
262
+ | **[disler/pi-vs-claude-code](https://github.com/disler/pi-vs-claude-code)** | Source inspiration / MIT port origin for pi harnesses | Design lineage (ported in-repo) |
263
+ | **LLM providers** | Models per persona (`model:` / `models:` in agent frontmatter) — e.g. OpenAI Codex, GitHub Copilot, Ollama, … | Yes (at least one provider your agents can call) |
264
+ | **Chrome DevTools MCP** / **Playwright Agent CLI** | Browser verify (`browser-testing-with-devtools`) and headless automation (`bowser`) | Optional, feature-specific |
265
+ | **Node.js + npm** | CLI (`npx @chankov/agent-fleet`), package install, `just` recipes | Yes for install & tooling |
266
+
267
+ ## Repository module map
268
+
269
+ ### Agent Hub composition
270
+
271
+ `.pi/harnesses/agent-hub/index.ts` owns mutable Hub state and composes the extracted concerns without merging their context contracts:
272
+
273
+ ```text
274
+ agent-hub/
275
+ ├── index.ts # bounded composition root; constructs root-owned mutable ports
276
+ ├── types.ts # shared Hub agent/state contracts
277
+ ├── config/ # agent/frontmatter, teams, profiles, dispatch policy, overrides
278
+ ├── context/ # state, budgets, assertions/artifacts, session-health factories
279
+ ├── commands/ # 21 typed /af-* command registrars
280
+ ├── tools/ # 16 tools plus dispatch/research execution orchestration
281
+ ├── dispatch-core.ts # facade over native, coms, and observability dispatch
282
+ ├── dispatch-*.ts # native preparation/spawn/completion and backend adapters
283
+ ├── policy/ # model, roster, capability, and work-mode decisions
284
+ ├── research/ # helper runtime, spawn transitions, and controls
285
+ ├── ui/ # grid, dashboard, detail, context, pool, zoom, and history
286
+ ├── input/ # shortcuts and completion derivation
287
+ ├── lifecycle/ # turn, pressure, monitor, session, and shutdown orchestration
288
+ ├── prompts/ # data-oriented system/session templates + HubPromptContext
289
+ ├── session-start.ts # typed ordered session_start step runner
290
+ ├── presentation.ts # marker, name, thinking, and delegate-path helpers
291
+ ├── timeline.ts # bounded transcript/timeline append helpers
292
+ ├── monitor-*.ts # local monitor transport and recovery primitives
293
+ └── *.test.{ts,js} # registration, loader, parity, and behavior contracts
294
+ ```
295
+
296
+ Cross-harness coms lifecycle remains shared in `.pi/harnesses/lib/coms-core.ts` and `coms-core-io.ts`; it is not owned by the Hub composition root.
297
+
298
+ ```text
299
+ .pi/ # Pi runtime: harnesses, extensions, agents config, prompts
300
+ .pi/agent-fleet/ # The fleet runtime, mirrored verbatim into a workspace:
301
+ scripts/ # CLI helpers, bridges, team + one-off peer launchers (pure logic in scripts/lib/)
302
+ scripts/workflows/ # deterministic flow graphs + phase/gate/permission/quality runtime
303
+ hermes/ # Hermes-facing skills/integration assets
304
+ hooks/ # the coms bridge Stop hook
305
+ docs/ # the one doc that installs into a workspace (workflows.md)
306
+ skills/ # Agent Fleet-native skills (shadow vendored names)
307
+ agents/ # Personas/subagents; installed to a workspace's .pi/agents/personas/
308
+ codex/ # Canonical Codex conductor contract (runtime copy lives outside checkout)
309
+ systemd/user/ # Owned user-unit template for Codex remote control
310
+ vendor/agent-skills-upstream/ # Manually imported upstream skills (pinned SHA)
311
+ bin/ # npm CLI: init/update/doctor + the installer engine
312
+ references/ # Supplementary checklists, installed with the skills that cite them
313
+ docs/ # This file, setup guides, bridge references, vendoring policy
314
+ ```
315
+
316
+ The fleet runtime keeps its *source* layout identical to its *installed* layout.
317
+ That is not cosmetic: `companion:harness-runtime-closure` and its siblings copy
318
+ with `preserveLayout`, so a relative import written here resolves the same way in
319
+ a workspace — including the ones reaching from the stationary `.pi/harnesses/`
320
+ into the movable `.pi/agent-fleet/scripts/`. `bin/test/path-boundaries.test.js`
321
+ holds that invariant.
322
+
323
+ Reserved for future modules (do not repurpose these paths):
324
+
325
+ ```text
326
+ apps/dashboard/ # future dashboard: Kanban state, Herdr workspaces, peer status
327
+ packages/fleet-core/ # future extracted core orchestration library
328
+ packages/herdr-bridge/ # future Herdr integration package
329
+ packages/hermes-bridge/ # future Hermes integration package
330
+ ```
331
+
332
+ ## Design rules
333
+
334
+ - **Workflows are isolated from the Hub.** `just flow` owns deterministic phase order, retries, executable gates, post-hoc writes enforcement, and one acceptance decision. It uses the clean spawn/context seams but never routes through hub dispatch; flow traces live under `.pi/flow-sessions/`. Flow branches retain source/result metadata, while the reserved `cleanup` and `merge` maintenance subcommands delegate safe removal and squash integration to Worktrunk. A future `run_flow` hub tool is design-only and would call the dispatcher module directly, never shell through `just`.
335
+ - **Thin dispatcher context.** Nothing lands persistently in the dispatcher's
336
+ context if it can live on disk or in a one-line status. Research findings,
337
+ the Verification Contract ledger, and team snapshots are all disk-first.
338
+ - **A harness fault must never look like a specialist fault.** The hub passes
339
+ `--session <file>` on every run, so one corrupt session file used to fail a
340
+ persona in ~1s with no output — indistinguishable from a bad agent, and
341
+ unrecoverable by drop + re-add. Unusable session files are now validated and
342
+ quarantined (`session-health.js`) with the reset named in the result. Same rule
343
+ for the return contract: a report the parser cannot read gets one cheap
344
+ read-only extraction pass (`return-extract.js`) before its assertions are
345
+ written off as unproven, and extracted evidence is always labelled as weaker
346
+ than declared evidence. The converse also holds: a run that errored or timed
347
+ out writes to `artifacts/failures/`, never `returns/` — an error stub filed
348
+ as a return reads as a specialist verdict and gets acted on as one.
349
+ - **A pool status field beats reading the screen.** `coms_list` publishes each
350
+ peer's `pane_id` and `status` (`idle`/`working`/`booting`), and
351
+ `herdr_spawn_peer` waits for the peer to register and returns `peer_ready`
352
+ rather than a bare pane id. A spawned peer boots idle and does nothing until
353
+ addressed, so peers spawned and never sent to are named at turn end and in
354
+ `/af-hub-report` (`spawned-peers.js`); closing stays the human's call.
355
+ - **A declared requirement carries its origin.** Every assertion in the ledger
356
+ names its source (`assertion-ledger.js`), and the open ledger is soft-capped
357
+ at 8 — an id nobody can trace back to a plan line costs a dispatch and an
358
+ ASK_USER cycle to re-derive.
359
+ - **Pre-flight validation is free.** Anything the hub can reject before spawning
360
+ — an unresolvable artifact path, an unknown research persona, a heavy persona
361
+ at a low tier, a reviewer on a docs-only scope — is refused without spending a
362
+ budget slot. Artifact paths also resolve across artifact kinds when the name is
363
+ unique, since the hub writes every auto-return under `returns/` while
364
+ dispatchers reasonably guess `reviews/`.
365
+ - **Evidence is archived, never overwritten.** Session start moves the previous
366
+ session's `artifacts/` into an immutable `.pi/agent-sessions/runs/<runId>/`
367
+ namespace with a read-only `meta.json` and an appended `runs/index.json`
368
+ (`run-namespace.js`), retained per `run-history-keep` (default 10). The old
369
+ behaviour — delete `artifacts/` at start, name returns by a per-session counter
370
+ — collided two ways at once and made a post-mortem record eleven specialist
371
+ returns and two reviews as NOT RECOVERABLE. A failed archive leaves the
372
+ artifacts in place: a stale tree is recoverable, a deleted one is not.
373
+ - **Herdr owns panes, presence, and lifecycle; coms owns messages.** Herdr
374
+ topology recipes (`--herdr` or `--peers`) require a running server and refuse
375
+ with an actionable message otherwise. Bare Fleet does not require Herdr.
376
+ `--no-coms` leaves direct/native execution available but disables peer
377
+ messaging, peer-backed dispatch, and handoff from the Hub.
378
+ - **External agents are peers, not plugins.** Claude Code (and future CLI
379
+ agents) join the fleet through bridge adaptors that speak coms envelopes —
380
+ the fleet core stays agent-agnostic. Hermes remains the inbound `ask_user`/
381
+ Telegram route; the experimental Codex conductor is outbound-initiated only,
382
+ approval-gated, and restricted to listed peers through the validated wrapper.
383
+ - **Hermes monitor presentation is outside the fleet core.** Agent Fleet exposes owner-only
384
+ local monitor operations for Hub-owned state; a consumer owns its UI and lifecycle. The
385
+ worktree contains additive monitor/event/invoke code, but that implementation and its local
386
+ tests are not proof of a durable external identity or live delivery contract. `invoke`, where
387
+ available, is Hub-owned and queues dispatcher work rather than exposing tools directly.
388
+ - **Packaged Hermes source is opt-in, never auto-installed.** The npm tarball carries the
389
+ `hub-watchdog` skill (`.pi/agent-fleet/hermes/skills/`) plus the backend and Desktop monitor plugin source
390
+ (`.pi/agent-fleet/hermes/plugins/`, `.pi/agent-fleet/hermes/desktop-plugins/`) as runtime-only source. Shipping that source
391
+ makes it available to an operator; installing it into a Hermes profile is always an explicit
392
+ action through `agent-fleet set-hermes-watchdog` (skill) or the consumer's own flow (plugins).
393
+ Nothing is enabled, launched, or configured by installing the package.
394
+ - **Watchdog delivery is capability-gated and currently unproven.** No checked-in
395
+ Gate O live artifact proves Hermes origin identity, updates, reconnect, or two-chat isolation,
396
+ so its supported posture is journal-only/dormant: no delivery, steering, or surgical use. It
397
+ never manages services, gateways, Herdr, or shell commands. Local runtime evidence — including
398
+ a real foreground watcher against a disposable Hub UDS — is `synthetic-local` and proves none of
399
+ those capabilities; see [the watchdog runbook](hermes-watchdog-supervisor.md).
400
+ - **External conductor contracts are advisory.** Pi damage-control wraps Pi
401
+ tool calls, not Hermes or Codex processes; human approvals and their
402
+ contracts reduce risk but do not provide an OS command allowlist.
403
+ - **Destructive fleet verbs are damage-control-guarded.** Specialists cannot
404
+ spawn/close herdr panes; the human confirms destructive actions.
405
+ - **Native-over-vendored skills.** The skill catalogue resolves `skills/`
406
+ first, then the vendored upstream import; upstream updates are explicit
407
+ maintainer actions ([UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md)).
408
+
409
+ ## History
410
+
411
+ Agent Fleet began as a fork of `addyosmani/agent-skills` and was split into a
412
+ standalone repository in July 2026, with upstream demoted to vendored content.
413
+ The one-time migration record, including the history-filtering commands, lives
414
+ in [MIGRATION-agent-fleet.md](MIGRATION-agent-fleet.md). The product
415
+ requirements that drove the split were a one-off planning document and are no
416
+ longer maintained.