@chankov/agent-fleet 1.0.3 → 2.0.0

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 (777) hide show
  1. package/.pi/harnesses/agent-hub/README.md +82 -77
  2. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
  3. package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  4. package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  5. package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  6. package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  7. package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  8. package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  9. package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  10. package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  11. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  12. package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  13. package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  14. package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  15. package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  17. package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  18. package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  19. package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  20. package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  21. package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  22. package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  23. package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  24. package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  25. package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  26. package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  27. package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  28. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  29. package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  30. package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  31. package/.pi/harnesses/agent-hub/delegate.ts +14 -3
  32. package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  33. package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  34. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  35. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  36. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  37. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  38. package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  39. package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  40. package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
  41. package/.pi/harnesses/agent-hub/footer.ts +3 -9
  42. package/.pi/harnesses/agent-hub/helpers.ts +2 -2
  43. package/.pi/harnesses/agent-hub/index.ts +1327 -9476
  44. package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  45. package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  46. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  47. package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  48. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  49. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  50. package/.pi/harnesses/agent-hub/package.json +1 -1
  51. package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  52. package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  53. package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  54. package/.pi/harnesses/agent-hub/presentation.ts +48 -0
  55. package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  56. package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  57. package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  58. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  59. package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  60. package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  61. package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  62. package/.pi/harnesses/agent-hub/session-start.ts +42 -0
  63. package/.pi/harnesses/agent-hub/spawn.ts +25 -3
  64. package/.pi/harnesses/agent-hub/timeline.ts +54 -0
  65. package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  66. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  67. package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  68. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  69. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  70. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  71. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  72. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  73. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  74. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  75. package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  76. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  77. package/.pi/harnesses/agent-hub/types.ts +60 -0
  78. package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  79. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  80. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  81. package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  82. package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  83. package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  84. package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  85. package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  86. package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  87. package/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  88. package/.pi/harnesses/coms/index.ts +139 -1630
  89. package/.pi/harnesses/coms/package.json +1 -1
  90. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  91. package/.pi/harnesses/lib/coms-core-io.ts +385 -0
  92. package/.pi/harnesses/lib/coms-core.ts +577 -0
  93. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
  94. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +2 -2
  95. package/.pi/harnesses/lib/fleet-detail-view.ts +95 -16
  96. package/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  97. package/.pi/prompts/af-plan.md +6 -5
  98. package/.versions/1.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  99. package/.versions/1.0.4/.pi/agents/model-profiles.yaml +27 -0
  100. package/.versions/1.0.4/.pi/agents/peers.yaml +142 -0
  101. package/.versions/1.0.4/.pi/agents/teams.yaml +41 -0
  102. package/.versions/1.0.4/.pi/damage-control-rules.yaml +297 -0
  103. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  104. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  105. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  106. package/.versions/1.0.4/.pi/extensions/btw/README.md +120 -0
  107. package/.versions/1.0.4/.pi/extensions/btw/index.ts +914 -0
  108. package/.versions/1.0.4/.pi/extensions/btw/package.json +6 -0
  109. package/.versions/1.0.4/.pi/extensions/btw/state.js +179 -0
  110. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  111. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  112. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  113. package/.versions/1.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  114. package/.versions/1.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  115. package/.versions/1.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  116. package/.versions/1.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  117. package/.versions/1.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  118. package/.versions/1.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  119. package/.versions/1.0.4/.pi/extensions/package-lock.json +1175 -0
  120. package/.versions/1.0.4/.pi/extensions/package.json +9 -0
  121. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  122. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  123. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  124. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  125. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  126. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  127. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  128. package/.versions/1.0.4/.pi/harnesses/agent-hub/README.md +1170 -0
  129. package/.versions/1.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  130. package/.versions/1.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  131. package/.versions/1.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  132. package/.versions/1.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  133. package/.versions/1.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  134. package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  135. package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  136. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  137. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  138. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  139. package/.versions/1.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  140. package/.versions/1.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  141. package/.versions/1.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  142. package/.versions/1.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  143. package/.versions/1.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  144. package/.versions/1.0.4/.pi/harnesses/agent-hub/footer.ts +36 -0
  145. package/.versions/1.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  146. package/.versions/1.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  147. package/.versions/1.0.4/.pi/harnesses/agent-hub/index.ts +10171 -0
  148. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  149. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  150. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  151. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  152. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  153. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  154. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  155. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  156. package/.versions/1.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  157. package/.versions/1.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  158. package/.versions/1.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  159. package/.versions/1.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
  160. package/.versions/1.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  161. package/.versions/1.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  162. package/.versions/1.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  163. package/.versions/1.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  164. package/.versions/1.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  165. package/.versions/1.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  166. package/.versions/1.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  167. package/.versions/1.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  168. package/.versions/1.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  169. package/.versions/1.0.4/.pi/harnesses/agent-hub/spawn.ts +388 -0
  170. package/.versions/1.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  171. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  172. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  173. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  174. package/.versions/1.0.4/.pi/harnesses/coms/README.md +100 -0
  175. package/.versions/1.0.4/.pi/harnesses/coms/index.ts +1767 -0
  176. package/.versions/1.0.4/.pi/harnesses/coms/package.json +7 -0
  177. package/.versions/1.0.4/.pi/harnesses/coms/version.ts +42 -0
  178. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  179. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  180. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  181. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  182. package/.versions/1.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  183. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  184. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  185. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  186. package/.versions/1.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  187. package/.versions/1.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  188. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  189. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  190. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  191. package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  192. package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  193. package/.versions/1.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  194. package/.versions/1.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  195. package/.versions/1.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  196. package/.versions/1.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  197. package/.versions/1.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  198. package/.versions/1.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  199. package/.versions/1.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  200. package/.versions/1.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  201. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  202. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  203. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  204. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  205. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  206. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  207. package/.versions/1.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  208. package/.versions/1.0.4/.pi/harnesses/package-lock.json +2039 -0
  209. package/.versions/1.0.4/.pi/harnesses/package.json +10 -0
  210. package/.versions/1.0.4/.pi/prompts/af-build.md +24 -0
  211. package/.versions/1.0.4/.pi/prompts/af-code-simplify.md +22 -0
  212. package/.versions/1.0.4/.pi/prompts/af-plan.md +17 -0
  213. package/.versions/1.0.4/.pi/prompts/af-review.md +16 -0
  214. package/.versions/1.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  215. package/.versions/1.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  216. package/.versions/1.0.4/.pi/prompts/af-ship.md +17 -0
  217. package/.versions/1.0.4/.pi/prompts/af-spec.md +15 -0
  218. package/.versions/1.0.4/.pi/prompts/af-test.md +19 -0
  219. package/.versions/1.0.4/.pi/skills/bowser/SKILL.md +145 -0
  220. package/.versions/1.0.4/.version +1 -0
  221. package/.versions/1.0.4/agents/architect.md +25 -0
  222. package/.versions/1.0.4/agents/bowser.md +28 -0
  223. package/.versions/1.0.4/agents/builder.md +56 -0
  224. package/.versions/1.0.4/agents/code-reviewer.md +209 -0
  225. package/.versions/1.0.4/agents/deep-researcher.md +33 -0
  226. package/.versions/1.0.4/agents/documenter.md +19 -0
  227. package/.versions/1.0.4/agents/orchestrator.md +21 -0
  228. package/.versions/1.0.4/agents/plan-reviewer.md +84 -0
  229. package/.versions/1.0.4/agents/planner.md +71 -0
  230. package/.versions/1.0.4/agents/releaser.md +25 -0
  231. package/.versions/1.0.4/agents/researcher.md +29 -0
  232. package/.versions/1.0.4/agents/security-auditor.md +168 -0
  233. package/.versions/1.0.4/agents/test-engineer.md +154 -0
  234. package/.versions/1.0.4/agents/web-debugger.md +44 -0
  235. package/.versions/1.0.4/agents/web-performance-auditor.md +194 -0
  236. package/.versions/1.0.4/bin/catalog/harness-runtime-closure.json +38 -0
  237. package/.versions/1.0.4/codex/CONDUCTOR.md +148 -0
  238. package/.versions/1.0.4/docs/ARCHITECTURE.md +375 -0
  239. package/.versions/1.0.4/docs/agent-fleet-setup.md +468 -0
  240. package/.versions/1.0.4/docs/claude-code-coms-bridge.md +128 -0
  241. package/.versions/1.0.4/docs/codex-remote-conductor.md +170 -0
  242. package/.versions/1.0.4/docs/coms-hermes-bridge.md +189 -0
  243. package/.versions/1.0.4/docs/getting-started.md +98 -0
  244. package/.versions/1.0.4/docs/npm-install.md +292 -0
  245. package/.versions/1.0.4/docs/pi-extensions.md +441 -0
  246. package/.versions/1.0.4/docs/pi-setup.md +74 -0
  247. package/.versions/1.0.4/docs/skill-anatomy.md +150 -0
  248. package/.versions/1.0.4/hermes/README.md +347 -0
  249. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  250. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  251. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  252. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  253. package/.versions/1.0.4/hermes/gates/gate-o-capability.md +8 -0
  254. package/.versions/1.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  255. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  256. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  257. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  258. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  259. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  260. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  261. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  262. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  263. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  264. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  265. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  266. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  267. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  268. package/.versions/1.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  269. package/.versions/1.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  270. package/.versions/1.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  271. package/.versions/1.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  272. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  273. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  274. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  275. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  276. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  277. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  278. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  279. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  280. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  281. package/.versions/1.0.4/hermes/watchdog-tests/__init__.py +0 -0
  282. package/.versions/1.0.4/hooks/coms-stop-hook.mjs +84 -0
  283. package/.versions/1.0.4/install-manifest.json +2745 -0
  284. package/.versions/1.0.4/justfile +272 -0
  285. package/.versions/1.0.4/manifest-meta.json +882 -0
  286. package/.versions/1.0.4/references/accessibility-checklist.md +160 -0
  287. package/.versions/1.0.4/references/definition-of-done.md +67 -0
  288. package/.versions/1.0.4/references/fleet-coordination-patterns.md +151 -0
  289. package/.versions/1.0.4/references/observability-checklist.md +91 -0
  290. package/.versions/1.0.4/references/orchestration-patterns.md +370 -0
  291. package/.versions/1.0.4/references/performance-checklist.md +153 -0
  292. package/.versions/1.0.4/references/prompting-patterns.md +380 -0
  293. package/.versions/1.0.4/references/security-checklist.md +179 -0
  294. package/.versions/1.0.4/references/testing-patterns.md +236 -0
  295. package/.versions/1.0.4/scripts/codex-conductor.ts +41 -0
  296. package/.versions/1.0.4/scripts/codex-remote-control.ts +167 -0
  297. package/.versions/1.0.4/scripts/coms-claude-bridge.ts +411 -0
  298. package/.versions/1.0.4/scripts/coms-cli.ts +484 -0
  299. package/.versions/1.0.4/scripts/coms-hermes-bridge.ts +413 -0
  300. package/.versions/1.0.4/scripts/fleet.ts +185 -0
  301. package/.versions/1.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  302. package/.versions/1.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  303. package/.versions/1.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  304. package/.versions/1.0.4/scripts/install-hermes-plugin.sh +180 -0
  305. package/.versions/1.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  306. package/.versions/1.0.4/scripts/lib/codex-conductor.ts +88 -0
  307. package/.versions/1.0.4/scripts/lib/codex-remote-control.ts +480 -0
  308. package/.versions/1.0.4/scripts/lib/coms-envelope.ts +582 -0
  309. package/.versions/1.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  310. package/.versions/1.0.4/scripts/lib/fleet-command.ts +266 -0
  311. package/.versions/1.0.4/scripts/lib/herdr-layout.ts +281 -0
  312. package/.versions/1.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  313. package/.versions/1.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  314. package/.versions/1.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  315. package/.versions/1.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  316. package/.versions/1.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  317. package/.versions/1.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  318. package/.versions/1.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  319. package/.versions/1.0.4/scripts/lib/monitor-env.ts +146 -0
  320. package/.versions/1.0.4/scripts/lib/peer-launch.ts +318 -0
  321. package/.versions/1.0.4/scripts/lib/persona-banner.ts +62 -0
  322. package/.versions/1.0.4/scripts/lib/spawn-stagger.ts +101 -0
  323. package/.versions/1.0.4/scripts/lib/team-project.ts +213 -0
  324. package/.versions/1.0.4/scripts/lib/team-snapshot.ts +147 -0
  325. package/.versions/1.0.4/scripts/peer-banner.ts +40 -0
  326. package/.versions/1.0.4/scripts/peer-launch.ts +259 -0
  327. package/.versions/1.0.4/scripts/team-snapshot.ts +237 -0
  328. package/.versions/1.0.4/scripts/team-up.ts +406 -0
  329. package/.versions/1.0.4/skills/_internal/grilling.md +59 -0
  330. package/.versions/1.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  331. package/.versions/1.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  332. package/.versions/1.0.4/skills/compound-learning/SKILL.md +137 -0
  333. package/.versions/1.0.4/skills/context-engineering/SKILL.md +291 -0
  334. package/.versions/1.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  335. package/.versions/1.0.4/skills/designing-agents/SKILL.md +394 -0
  336. package/.versions/1.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  337. package/.versions/1.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  338. package/.versions/1.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  339. package/.versions/1.0.4/skills/idea-refine/SKILL.md +182 -0
  340. package/.versions/1.0.4/skills/idea-refine/examples.md +238 -0
  341. package/.versions/1.0.4/skills/idea-refine/frameworks.md +99 -0
  342. package/.versions/1.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  343. package/.versions/1.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  344. package/.versions/1.0.4/skills/incremental-implementation/SKILL.md +298 -0
  345. package/.versions/1.0.4/skills/interview-me/SKILL.md +226 -0
  346. package/.versions/1.0.4/skills/orchestration-verification/SKILL.md +181 -0
  347. package/.versions/1.0.4/skills/peer-coms/SKILL.md +90 -0
  348. package/.versions/1.0.4/skills/performance-optimization/SKILL.md +350 -0
  349. package/.versions/1.0.4/skills/planning-and-task-breakdown/SKILL.md +263 -0
  350. package/.versions/1.0.4/skills/security-and-hardening/SKILL.md +461 -0
  351. package/.versions/1.0.4/skills/spec-driven-development/SKILL.md +256 -0
  352. package/.versions/1.0.4/skills/using-agent-skills/SKILL.md +197 -0
  353. package/.versions/1.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  354. package/.versions/1.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  355. package/.versions/1.0.4/vendor/agent-skills-upstream/README.md +11 -0
  356. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  357. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  358. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  359. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  360. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  361. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  362. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  363. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  364. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  365. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  366. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  367. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  368. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  369. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  370. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  371. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  372. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  373. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  374. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  375. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  376. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  377. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  378. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  379. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  380. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  381. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  382. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  383. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  384. package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  385. package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
  386. package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
  387. package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
  388. package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
  389. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  390. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  391. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  392. package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
  393. package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
  394. package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
  395. package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
  396. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  397. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  398. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  399. package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  400. package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  401. package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  402. package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  403. package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  404. package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  405. package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
  406. package/.versions/2.0.0/.pi/extensions/package.json +9 -0
  407. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  408. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  409. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  410. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  411. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  412. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  413. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  414. package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
  415. package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  416. package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  417. package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  418. package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  419. package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  420. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  421. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  422. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  423. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  424. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  425. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  426. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  427. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  428. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  429. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  430. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  431. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  432. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  433. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  434. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  435. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  436. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  437. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  438. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  439. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  440. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  441. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  442. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  443. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  444. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  445. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  446. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  447. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  448. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  449. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  450. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  451. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  452. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  453. package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
  454. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  455. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  456. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  457. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  458. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  459. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  460. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  461. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  462. package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  463. package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  464. package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  465. package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  466. package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  467. package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  468. package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  469. package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  470. package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
  471. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  472. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  473. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  474. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  475. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  476. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  477. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  478. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  479. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  480. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  481. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  482. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  483. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  484. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  485. package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  486. package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  487. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  488. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  489. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  490. package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
  491. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  492. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  493. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  494. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  495. package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  496. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  497. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  498. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  499. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  500. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  501. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  502. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  503. package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  504. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
  505. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  506. package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  507. package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  508. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  509. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  510. package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
  511. package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
  512. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  513. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  514. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  515. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  516. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  517. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  518. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  519. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  520. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  521. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  522. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  523. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  524. package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
  525. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  526. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  527. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  528. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  529. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  530. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  531. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  532. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  533. package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  534. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  535. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  536. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  537. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
  538. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  539. package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
  540. package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
  541. package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
  542. package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
  543. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  544. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  545. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  546. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  547. package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
  548. package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
  549. package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  550. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  551. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  552. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
  553. package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
  554. package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  555. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  556. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  557. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  558. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  559. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  560. package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  561. package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  562. package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  563. package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  564. package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  565. package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  566. package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  567. package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  568. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  569. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  570. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  571. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  572. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  573. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  574. package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  575. package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
  576. package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
  577. package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
  578. package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
  579. package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
  580. package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
  581. package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  582. package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  583. package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
  584. package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
  585. package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
  586. package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
  587. package/.versions/2.0.0/.version +1 -0
  588. package/.versions/2.0.0/agents/architect.md +25 -0
  589. package/.versions/2.0.0/agents/bowser.md +28 -0
  590. package/.versions/2.0.0/agents/builder.md +56 -0
  591. package/.versions/2.0.0/agents/code-reviewer.md +209 -0
  592. package/.versions/2.0.0/agents/deep-researcher.md +33 -0
  593. package/.versions/2.0.0/agents/documenter.md +19 -0
  594. package/.versions/2.0.0/agents/orchestrator.md +23 -0
  595. package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
  596. package/.versions/2.0.0/agents/planner.md +71 -0
  597. package/.versions/2.0.0/agents/releaser.md +25 -0
  598. package/.versions/2.0.0/agents/researcher.md +29 -0
  599. package/.versions/2.0.0/agents/security-auditor.md +168 -0
  600. package/.versions/2.0.0/agents/test-engineer.md +154 -0
  601. package/.versions/2.0.0/agents/web-debugger.md +44 -0
  602. package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
  603. package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
  604. package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
  605. package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
  606. package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
  607. package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
  608. package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
  609. package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
  610. package/.versions/2.0.0/docs/getting-started.md +98 -0
  611. package/.versions/2.0.0/docs/npm-install.md +292 -0
  612. package/.versions/2.0.0/docs/pi-extensions.md +439 -0
  613. package/.versions/2.0.0/docs/pi-setup.md +74 -0
  614. package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
  615. package/.versions/2.0.0/hermes/README.md +347 -0
  616. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  617. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  618. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  619. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  620. package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
  621. package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  622. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  623. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  624. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  625. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  626. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  627. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  628. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  629. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  630. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  631. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  632. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  633. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  634. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  635. package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  636. package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  637. package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  638. package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  639. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  640. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  641. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  642. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  643. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  644. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  645. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  646. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  647. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  648. package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
  649. package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
  650. package/.versions/2.0.0/install-manifest.json +2745 -0
  651. package/.versions/2.0.0/justfile +272 -0
  652. package/.versions/2.0.0/manifest-meta.json +882 -0
  653. package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
  654. package/.versions/2.0.0/references/definition-of-done.md +67 -0
  655. package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
  656. package/.versions/2.0.0/references/observability-checklist.md +91 -0
  657. package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
  658. package/.versions/2.0.0/references/performance-checklist.md +153 -0
  659. package/.versions/2.0.0/references/prompting-patterns.md +380 -0
  660. package/.versions/2.0.0/references/security-checklist.md +179 -0
  661. package/.versions/2.0.0/references/testing-patterns.md +236 -0
  662. package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
  663. package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
  664. package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
  665. package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
  666. package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
  667. package/.versions/2.0.0/scripts/fleet.ts +185 -0
  668. package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  669. package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  670. package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  671. package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
  672. package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  673. package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
  674. package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
  675. package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
  676. package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  677. package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
  678. package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
  679. package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  680. package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  681. package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  682. package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  683. package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  684. package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  685. package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  686. package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
  687. package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
  688. package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
  689. package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
  690. package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
  691. package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
  692. package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
  693. package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
  694. package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
  695. package/.versions/2.0.0/scripts/team-up.ts +406 -0
  696. package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
  697. package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  698. package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  699. package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
  700. package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
  701. package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  702. package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
  703. package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  704. package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  705. package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  706. package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
  707. package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
  708. package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
  709. package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  710. package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  711. package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
  712. package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
  713. package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
  714. package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
  715. package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
  716. package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
  717. package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
  718. package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
  719. package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
  720. package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  721. package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  722. package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
  723. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  724. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  725. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  726. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  727. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  728. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  729. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  730. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  731. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  732. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  733. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  734. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  735. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  736. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  737. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  738. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  739. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  740. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  741. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  742. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  743. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  744. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  745. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  746. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  747. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  748. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  749. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  750. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  751. package/CHANGELOG.md +40 -0
  752. package/README.md +5 -5
  753. package/agents/builder.md +1 -0
  754. package/agents/orchestrator.md +3 -1
  755. package/agents/planner.md +1 -1
  756. package/bin/lib/overrides.js +2 -0
  757. package/bin/lib/validate-overrides.js +1 -1
  758. package/docs/ARCHITECTURE.md +42 -13
  759. package/docs/MIGRATION-agent-fleet.md +4 -4
  760. package/docs/agent-fleet-setup.md +15 -15
  761. package/docs/npm-install.md +1 -1
  762. package/docs/pi-extensions.md +16 -18
  763. package/install-manifest.json +3 -3
  764. package/justfile +2 -2
  765. package/package.json +3 -2
  766. package/scripts/fleet.ts +10 -10
  767. package/scripts/lib/fleet-command.ts +15 -11
  768. package/scripts/lib/team-project.ts +2 -2
  769. package/scripts/team-up.ts +10 -10
  770. package/skills/_internal/grilling.md +53 -5
  771. package/skills/idea-refine/SKILL.md +2 -2
  772. package/skills/incremental-implementation/SKILL.md +12 -1
  773. package/skills/planning-and-task-breakdown/SKILL.md +14 -5
  774. package/skills/spec-driven-development/SKILL.md +10 -11
  775. package/skills/using-agent-skills/SKILL.md +13 -15
  776. /package/{.pi → .versions/1.0.4/.pi}/harnesses/agent-hub/execution-profile.ts +0 -0
  777. /package/{.pi → .versions/1.0.4/.pi}/harnesses/agent-hub/posture.ts +0 -0
@@ -54,7 +54,7 @@ tool call. The unified `just fleet` entry point composes them with a determinist
54
54
  Fleet Core: `damage-control-continue`, `ask-user-remote`, Compact & Continue,
55
55
  BTW, and the update checker. Voice is an optional feature, not Default Fleet Core.
56
56
  Every public Pi launch through bare `just fleet` also loads
57
- `agent-hub`; operator/orchestrator posture changes its direct tool surface without changing
57
+ `agent-hub`; operator/orchestrator work mode changes its direct tool surface without changing
58
58
  process or session. `just fleet peer` starts a standalone coms peer. Harnesses live in
59
59
  **`.pi/harnesses/`** — a directory pi does
60
60
  *not* auto-discover — so a plain `pi` run still loads no safety/orchestration harness.
@@ -165,11 +165,10 @@ make a harness self-contained: copied target harnesses still require the existin
165
165
  `agent-team` recipe and absorbs the day-to-day pieces that previously required separate
166
166
  harnesses:
167
167
 
168
- - **Two live postures** — bare `just fleet` starts as an operator with direct coding tools and an
169
- empty native roster; `/af-posture operator|orchestrator` switches prompt and tool surface without
170
- restarting or losing session state. Orchestrator removes direct coding tools. `/af-work-mode` and
171
- **Alt+M** are posture shortcuts (operator \| orchestrator). Budgets and nested delegation follow
172
- task tier. All Hub slash commands remain registered in both postures; capability-off actions
168
+ - **Two live Work Modes** — bare `just fleet` starts as an operator with direct coding tools and an
169
+ empty native roster; `/af-work-mode operator|orchestrator` switches prompt and tool surface without
170
+ restarting or losing session state, while `/af-work-mode` without an argument and **Alt+M** open
171
+ the picker. Orchestrator removes direct coding tools. Budgets and nested delegation follow task tier. All Hub slash commands remain registered in both work modes; capability-off actions
173
172
  refuse actionably.
174
173
  - **Fleet Dashboard and compact widget** — **`Alt+A`** or `/af-agents-list` opens a
175
174
  full-screen dashboard of the active native roster, delegates, research helpers, and coms
@@ -181,8 +180,9 @@ harnesses:
181
180
  running agents; **`Alt+Shift+A`** toggles it on/off. See the
182
181
  [agent-hub README](../.pi/harnesses/agent-hub/README.md#fleet-dashboard-and-detail) for
183
182
  keys and action semantics.
184
- - **Specialist delegation** — `dispatch_agent` for writable child-agent work and
185
- `spawn_research` / `/af-research` for read-only investigation.
183
+ - **Specialist delegation** — `dispatch_agent` for writable child-agent work. Read-only
184
+ investigation is automated through dispatcher-invoked `spawn_research` and the specialists'
185
+ `NEEDS_RESEARCH:` pipe; dedicated research lifecycle slash commands are not registered.
186
186
  - **Verification Contract** — the dispatcher owns a ledger of checkable acceptance assertions
187
187
  built before any builder runs, via the `set_assertions` / `update_assertion` tools. Each
188
188
  assertion is tagged (`test` | `runtime-ui` | `code-grep` | `manual`) and advanced only on
@@ -193,10 +193,8 @@ harnesses:
193
193
  assertions — see the [`orchestration-verification`](../skills/orchestration-verification/SKILL.md)
194
194
  skill, which the `orchestrator` persona drives. Advisory in this phase (surfaced, not a hard
195
195
  dispatch refusal).
196
- - **Persona gate** — requires an orchestrator persona at startup unless disabled in the local
197
- override file; the chosen persona also feeds the coms purpose when no explicit `--purpose` is set.
198
196
  - **Operator controls** — `/af-zoom` timeline inspection plus child-agent kill/restart controls. `/af-context` is a separate read-only full-screen context-budget view: provider totals/cache fields are authoritative, component estimates are labelled heuristic or provider-scaled, stable prompt and volatile-state cost are separated, loaded-but-excluded and inactive packs visibly cost zero, and fleet members use separate model-window denominators. It also shows live pressure phase, measured usage, the 80%/90% thresholds, episode, and last recovery outcome. It never reveals or persists raw prompts, schemas, conversation content, error bodies, or compaction summaries.
199
- - **Automatic capability packs** — no activation command is needed. Intent, posture, tier, pending work, and runtime state resolve the model-visible tools before the turn; readiness alone does not make coms/Herdr visible. Ambiguous fleet, peer, or workspace use asks once before its first side effect. The compact pack is transient when explicitly requested or pressure is imminent; ordinary task packs persist until `set_task_tier(new_task: true)`. Managed children receive selected replacement prompts/manifests (`--no-skills` and `--no-context-files` where applicable), not inherited global context.
197
+ - **Automatic capability packs** — no activation command is needed. Intent, work mode, tier, pending work, and runtime state resolve the model-visible tools before the turn; readiness alone does not make coms/Herdr visible. Ambiguous fleet, peer, or workspace use asks once before its first side effect. The compact pack is transient when explicitly requested or pressure is imminent; ordinary task packs persist until `set_task_tier(new_task: true)`. Managed children receive selected replacement prompts/manifests (`--no-skills` and `--no-context-files` where applicable), not inherited global context.
200
198
  - **One-click budget continuation** — turn and task refusals ask one localized Yes/No `ask_user` question. Yes renews the budget in the same tool loop, without a typed `continue` or slash command. Task continuation opens an audited tranche while preserving task tier, assertions, capability packs, blockers, label, and progress; genuinely different work uses `set_task_tier(new_task: true)`. Turn and task active-time clocks both exclude human wait time.
201
199
  - **Damage-control + ask_user by default** — `just fleet` and `just fleet --no-coms` load the
202
200
  `damage-control-continue` safety harness and `ask-user-remote` before `agent-hub`, so the
@@ -212,7 +210,7 @@ harnesses:
212
210
  - **Embedded coms** — peer discovery, `coms_list` / `coms_send` / `coms_get` / `coms_await`,
213
211
  `/af-handoff`, and peer-as-subagent flows.
214
212
  - **No-coms mode** — `just fleet --no-coms` keeps direct operator work, native delegation,
215
- research helpers, persona gate, and controls, but starts without embedded coms. `/af-handoff`
213
+ research helpers, and controls, but starts without embedded coms. `/af-handoff`
216
214
  remains registered and explains why it cannot run. Legacy `--solo` maps to this flag with a warning.
217
215
  - **Optional Hermes local monitor transport** — uses `AGENT_FLEET_PROFILE_ID`, the absolute
218
216
  `AGENT_FLEET_MONITOR_RUNTIME_DIR`, and the Herdr `HERDR_WORKSPACE_ID` and `HERDR_PANE_ID`
@@ -237,21 +235,21 @@ session JSONL under `~/.pi/agent/sessions/` remains the authoritative append-onl
237
235
  overflow does not imply corruption: inspect with `/session`, resume with `/resume` or Pi's session
238
236
  flags, and **never edit, truncate, reorder, or synthesize JSONL entries to recover**.
239
237
 
240
- If resume instead reports that orchestrator posture has no valid native roster, direct tools and
238
+ If resume instead reports that orchestrator work mode has no valid native roster, direct tools and
241
239
  model input intentionally remain blocked. Select a current team with `/af-agents-team`; restart via
242
240
  `just fleet --agents <name>` (direct Pi: `--agent-team <name>`); or explicitly choose operator with
243
- `/af-posture operator` / `just fleet --posture operator`. Repair stale team/persona definitions
244
- before selecting them. The Hub never invents a roster or silently downgrades persisted posture, and
241
+ `/af-work-mode operator` / `just fleet --work-mode operator`. Repair stale team/persona definitions
242
+ before selecting them. The Hub never invents a roster or silently downgrades persisted work mode, and
245
243
  explicit startup flags retain precedence.
246
244
 
247
245
  ### Runtime axes and explicit routing
248
246
 
249
- Posture, native roster, and peer topology are independent:
247
+ Work mode, native roster, and peer topology are independent:
250
248
 
251
249
  ```bash
252
250
  just fleet # operator, empty native roster
253
251
  just fleet --agents frontend # orchestrator inferred
254
- just fleet --posture operator --agents frontend # direct tools + native roster
252
+ just fleet --work-mode operator --agents frontend # direct tools + native roster
255
253
  just fleet --herdr --project af # one Hub pane in Herdr
256
254
  just fleet --agents frontend --peers frontend --project af
257
255
  ```
@@ -268,7 +266,7 @@ Inside a Herdr-backed Hub, `herdr_spawn_peer({ name: "code-reviewer" })` uses th
268
266
  and waits for coms readiness. Then use `coms_send` + `coms_await`, or `/af-handoff
269
267
  code-reviewer`. These actions need a running Herdr server and/or ready coms as appropriate; the
270
268
  commands stay registered and explain missing capability. Arbitrary pane commands use the separate
271
- `herdr_spawn_pane` tool. In orchestrator posture that tool is limited by policy to auxiliary
269
+ `herdr_spawn_pane` tool. In orchestrator work mode that tool is limited by policy to auxiliary
272
270
  processes such as watchers or servers; it must not be used to bypass delegation for code work.
273
271
 
274
272
  ---
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "packageVersion": "1.0.3",
3
+ "packageVersion": "2.0.0",
4
4
  "groups": [
5
5
  {
6
6
  "id": "skills",
@@ -2411,7 +2411,7 @@
2411
2411
  "group": "skills",
2412
2412
  "subcategory": "build",
2413
2413
  "title": "incremental-implementation",
2414
- "summary": "Delivers changes incrementally.",
2414
+ "summary": "Delivers changes incrementally and grills unspecified forks instead of silently picking among them.",
2415
2415
  "recommended": true,
2416
2416
  "stability": "stable",
2417
2417
  "consent": "file",
@@ -2567,7 +2567,7 @@
2567
2567
  "group": "skills",
2568
2568
  "subcategory": "plan",
2569
2569
  "title": "planning-and-task-breakdown",
2570
- "summary": "Breaks work into ordered tasks.",
2570
+ "summary": "Breaks work into ordered tasks and grills unspecified design forks before writing them.",
2571
2571
  "recommended": true,
2572
2572
  "stability": "stable",
2573
2573
  "consent": "file",
package/justfile CHANGED
@@ -50,12 +50,12 @@ default:
50
50
 
51
51
  # ---------------------------------------------------------------- unified Fleet interface
52
52
 
53
- # Agent Fleet — one guarded Hub runtime, two postures, independent topology.
53
+ # Agent Fleet — one guarded Hub runtime, two work modes, independent topology.
54
54
  #
55
55
  # UNIFIED HUB (recommended default)
56
56
  # just fleet # operator + empty native roster
57
57
  # just fleet --agents frontend # orchestrator + native roster
58
- # just fleet --posture operator --agents frontend
58
+ # just fleet --work-mode operator --agents frontend
59
59
  # just fleet --no-coms # direct/native work, no peer messaging
60
60
  # just fleet --browser # add live Chrome DevTools tools
61
61
  # just fleet --voice # load installed push-to-talk STT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chankov/agent-fleet",
3
- "version": "1.0.3",
3
+ "version": "2.0.0",
4
4
  "description": "Multi-agent fleet orchestration for coding agents. Pi as the primary runtime, Herdr as the workspace control plane, coms as the peer data plane, and Hermes for remote control — plus skills, personas, harnesses, and a guided setup CLI.",
5
5
  "keywords": [
6
6
  "ai",
@@ -45,6 +45,7 @@
45
45
  ".pi/extensions/*/examples/*.json",
46
46
  ".pi/harnesses/*.json",
47
47
  ".pi/harnesses/*/*.ts",
48
+ ".pi/harnesses/*/*/*.ts",
48
49
  ".pi/harnesses/*/*.js",
49
50
  ".pi/harnesses/*/package.json",
50
51
  ".pi/harnesses/*/README.md",
@@ -104,7 +105,7 @@
104
105
  "access": "public"
105
106
  },
106
107
  "scripts": {
107
- "test": "node bin/cli.js --version && node bin/cli.js --help && node --test \"bin/test/*.test.js\" scripts/agent-hub-helpers.test.mjs scripts/agent-hub-spawn.test.mjs scripts/agent-hub-delegate.test.mjs scripts/agent-hub-research.test.mjs .pi/harnesses/lib/herdr-client.test.ts .pi/harnesses/lib/herdr-presence.test.ts .pi/harnesses/lib/coms-registry-entry.test.ts .pi/harnesses/lib/fleet-overlay.test.ts .pi/harnesses/lib/fleet-selection.test.ts .pi/harnesses/lib/fleet-panel.test.ts .pi/harnesses/lib/context-budget.test.ts .pi/harnesses/lib/context-budget-view.test.ts .pi/harnesses/lib/context-budget-hub-prompt.test.ts .pi/harnesses/lib/context-budget-child-prompt.test.ts .pi/harnesses/agent-hub/context-budget-snapshot.test.ts .pi/harnesses/agent-hub/context-budget.integration.test.ts .pi/harnesses/agent-hub/context-pressure.test.ts .pi/harnesses/agent-hub/capability-packs.test.ts .pi/harnesses/agent-hub/capability-confirmation.test.ts .pi/harnesses/agent-hub/capability-matrix.test.ts .pi/harnesses/lib/fleet-read-model.test.ts .pi/harnesses/lib/fleet-dashboard-view.test.ts .pi/harnesses/lib/fleet-dashboard-ops.test.ts .pi/harnesses/lib/fleet-detail-view.test.ts .pi/harnesses/agent-hub/fleet-dashboard.integration.test.ts scripts/coms-cli.test.ts scripts/lib/codex-conductor.test.ts scripts/lib/codex-remote-control.test.ts scripts/lib/fleet-command.test.ts scripts/lib/team-project.test.ts scripts/lib/herdr-layout.test.ts scripts/lib/peer-launch.test.ts scripts/lib/spawn-stagger.test.ts scripts/lib/monitor-env.test.ts scripts/lib/fleet-extras.test.ts scripts/lib/team-snapshot.test.ts scripts/team-snapshot.command.test.ts scripts/lib/coms-envelope.test.ts scripts/lib/claude-bridge-core.test.ts scripts/lib/hermes-bridge-core.test.ts scripts/coms-hermes-bridge.test.ts .pi/harnesses/ask-user-remote/race-core.test.js .pi/harnesses/ask-user-remote/index.test.ts .pi/harnesses/agent-hub/extension-loader.test.ts .pi/extensions/btw/state.test.js .pi/extensions/btw/index.test.ts .pi/harnesses/agent-hub/execution-profile.test.ts .pi/harnesses/agent-hub/footer.test.ts .pi/harnesses/agent-hub/view-default.test.ts .pi/harnesses/agent-hub/overlay-migration.test.ts .pi/harnesses/agent-hub/safety-routing.test.ts .pi/harnesses/agent-hub/approval-routing.integration.test.ts .pi/harnesses/agent-hub/run-budget.test.js .pi/harnesses/agent-hub/budget-continuation.test.ts .pi/harnesses/agent-hub/budget-continuation.integration.test.ts .pi/harnesses/agent-hub/hub-state-audit.test.js .pi/harnesses/agent-hub/docs-lane.test.js .pi/harnesses/agent-hub/external-blocker.test.js .pi/harnesses/agent-hub/run-namespace.test.js .pi/harnesses/agent-hub/review-findings.test.js .pi/harnesses/agent-hub/assertion-ledger.test.js .pi/harnesses/agent-hub/provider-semaphore.test.js .pi/harnesses/lib/spawned-peers.test.js .pi/harnesses/agent-hub/context-window.test.js .pi/harnesses/agent-hub/drift-watchdog.test.js .pi/harnesses/agent-hub/session-health.test.js .pi/harnesses/agent-hub/return-contract.test.js .pi/harnesses/agent-hub/return-extract.test.js .pi/harnesses/agent-hub/backend-policy.test.js .pi/harnesses/agent-hub/artifacts.test.js .pi/harnesses/agent-hub/scope-gate.test.js .pi/harnesses/agent-hub/evidence-rules.test.js .pi/harnesses/agent-hub/research-retention.test.js .pi/harnesses/lib/damage-control-shared.test.ts .pi/harnesses/damage-control-continue/herdr-rules.test.js .pi/harnesses/damage-control-continue/exemptions.test.js scripts/lib/hermes-monitor-model.test.ts scripts/lib/hermes-monitor-events.test.ts scripts/lib/hermes-monitor-store.test.ts scripts/lib/hermes-monitor-retention.integration.test.ts scripts/lib/hermes-monitor-registry.test.ts scripts/lib/hermes-monitor-socket.test.ts scripts/lib/hermes-monitor-data-path.test.ts scripts/lib/hermes-monitor-slice7-9-backend.test.ts scripts/lib/hermes-monitor-control-socket.test.ts scripts/lib/hermes-monitor-e2e.test.ts scripts/lib/hermes-monitor-plugin-handshake.test.ts scripts/hermes-monitor-capability-runner.test.ts scripts/hermes-monitor-scenario.test.ts scripts/hermes-watchdog-capability-probe.test.ts .pi/harnesses/agent-hub/monitor-invoke.test.ts .pi/harnesses/agent-hub/monitor-invoke-journal.test.ts .pi/harnesses/agent-hub/monitor-control.test.ts .pi/harnesses/agent-hub/monitor-live-bridge-gaps.test.ts .pi/harnesses/agent-hub/monitor-review-live-wiring.red.test.ts .pi/harnesses/agent-hub/monitor-runtime.test.ts .pi/harnesses/agent-hub/monitor-bridge-runtime.test.ts .pi/harnesses/agent-hub/monitor-reconcile.test.ts .pi/harnesses/agent-hub/monitor-recovery.test.ts .pi/harnesses/agent-hub/monitor-lifecycle-lease.test.ts .pi/harnesses/agent-hub/monitor-session-bridge-race.test.ts .pi/harnesses/agent-hub/monitor-session-bridge.test.ts .pi/harnesses/agent-hub/monitor-cancel-race.test.ts .pi/harnesses/agent-hub/monitor-wait-only.test.ts .pi/harnesses/agent-hub/monitor-publisher.test.ts .pi/harnesses/agent-hub/monitor-index.integration.test.ts hermes/desktop-plugins/agent-fleet-herdr/presentation.test.js scripts/docs-links.test.mjs && npm run test:watchdog-py",
108
+ "test": "node bin/cli.js --version && node bin/cli.js --help && node --test --test-concurrency=4 \"bin/test/*.test.js\" scripts/agent-hub-helpers.test.mjs scripts/agent-hub-spawn.test.mjs scripts/agent-hub-delegate.test.mjs scripts/agent-hub-research.test.mjs .pi/harnesses/lib/herdr-client.test.ts .pi/harnesses/lib/herdr-presence.test.ts .pi/harnesses/lib/coms-registry-entry.test.ts .pi/harnesses/lib/coms-core.test.ts .pi/harnesses/lib/fleet-overlay.test.ts .pi/harnesses/lib/fleet-selection.test.ts .pi/harnesses/lib/fleet-panel.test.ts .pi/harnesses/lib/context-budget.test.ts .pi/harnesses/lib/context-budget-view.test.ts .pi/harnesses/lib/context-budget-hub-prompt.test.ts .pi/harnesses/lib/context-budget-child-prompt.test.ts .pi/harnesses/agent-hub/prompts/system-prompt.test.ts .pi/harnesses/agent-hub/prompts/session-start.test.ts .pi/harnesses/agent-hub/session-start.test.ts .pi/harnesses/agent-hub/context-budget-snapshot.test.ts .pi/harnesses/agent-hub/context-budget.integration.test.ts .pi/harnesses/agent-hub/context-pressure.test.ts .pi/harnesses/agent-hub/capability-packs.test.ts .pi/harnesses/agent-hub/capability-confirmation.test.ts .pi/harnesses/agent-hub/capability-matrix.test.ts .pi/harnesses/lib/fleet-read-model.test.ts .pi/harnesses/lib/fleet-dashboard-view.test.ts .pi/harnesses/lib/fleet-dashboard-ops.test.ts .pi/harnesses/lib/fleet-detail-view.test.ts .pi/harnesses/lib/fleet-transcript-store.test.ts .pi/harnesses/agent-hub/fleet-dashboard.integration.test.ts scripts/coms-cli.test.ts scripts/lib/codex-conductor.test.ts scripts/lib/codex-remote-control.test.ts scripts/lib/fleet-command.test.ts scripts/lib/team-project.test.ts scripts/lib/herdr-layout.test.ts scripts/lib/peer-launch.test.ts scripts/lib/spawn-stagger.test.ts scripts/lib/monitor-env.test.ts scripts/lib/fleet-extras.test.ts scripts/lib/team-snapshot.test.ts scripts/team-snapshot.command.test.ts scripts/lib/coms-envelope.test.ts scripts/lib/claude-bridge-core.test.ts scripts/lib/hermes-bridge-core.test.ts scripts/coms-hermes-bridge.test.ts .pi/harnesses/ask-user-remote/race-core.test.js .pi/harnesses/ask-user-remote/index.test.ts .pi/harnesses/agent-hub/extension-loader.test.ts .pi/harnesses/agent-hub/registration-surface.test.ts .pi/harnesses/agent-hub/backend-routing.integration.test.ts .pi/harnesses/agent-hub/dispatch-core.test.ts .pi/extensions/btw/state.test.js .pi/extensions/btw/index.test.ts .pi/harnesses/agent-hub/work-mode.test.ts .pi/harnesses/agent-hub/work-mode-controls.test.ts .pi/harnesses/agent-hub/work-mode-integration.test.ts .pi/harnesses/agent-hub/footer.test.ts .pi/harnesses/agent-hub/view-default.test.ts .pi/harnesses/agent-hub/overlay-migration.test.ts .pi/harnesses/agent-hub/safety-routing.test.ts .pi/harnesses/agent-hub/approval-routing.integration.test.ts .pi/harnesses/agent-hub/run-budget.test.js .pi/harnesses/agent-hub/budget-continuation.test.ts .pi/harnesses/agent-hub/budget-continuation.integration.test.ts .pi/harnesses/agent-hub/hub-state-audit.test.js .pi/harnesses/agent-hub/docs-lane.test.js .pi/harnesses/agent-hub/external-blocker.test.js .pi/harnesses/agent-hub/run-namespace.test.js .pi/harnesses/agent-hub/review-findings.test.js .pi/harnesses/agent-hub/assertion-ledger.test.js .pi/harnesses/agent-hub/provider-semaphore.test.js .pi/harnesses/lib/spawned-peers.test.js .pi/harnesses/agent-hub/context-window.test.js .pi/harnesses/agent-hub/drift-watchdog.test.js .pi/harnesses/agent-hub/session-health.test.js .pi/harnesses/agent-hub/return-contract.test.js .pi/harnesses/agent-hub/return-extract.test.js .pi/harnesses/agent-hub/backend-policy.test.js .pi/harnesses/agent-hub/artifacts.test.js .pi/harnesses/agent-hub/scope-gate.test.js .pi/harnesses/agent-hub/evidence-rules.test.js .pi/harnesses/agent-hub/research-retention.test.js .pi/harnesses/lib/damage-control-shared.test.ts .pi/harnesses/damage-control-continue/herdr-rules.test.js .pi/harnesses/damage-control-continue/exemptions.test.js scripts/lib/hermes-monitor-model.test.ts scripts/lib/hermes-monitor-events.test.ts scripts/lib/hermes-monitor-store.test.ts scripts/lib/hermes-monitor-retention.integration.test.ts scripts/lib/hermes-monitor-registry.test.ts scripts/lib/hermes-monitor-socket.test.ts scripts/lib/hermes-monitor-data-path.test.ts scripts/lib/hermes-monitor-slice7-9-backend.test.ts scripts/lib/hermes-monitor-control-socket.test.ts scripts/lib/hermes-monitor-e2e.test.ts scripts/lib/hermes-monitor-plugin-handshake.test.ts scripts/hermes-monitor-capability-runner.test.ts scripts/hermes-monitor-scenario.test.ts scripts/hermes-watchdog-capability-probe.test.ts .pi/harnesses/agent-hub/monitor-invoke.test.ts .pi/harnesses/agent-hub/monitor-invoke-journal.test.ts .pi/harnesses/agent-hub/monitor-control.test.ts .pi/harnesses/agent-hub/monitor-live-bridge-gaps.test.ts .pi/harnesses/agent-hub/monitor-review-live-wiring.red.test.ts .pi/harnesses/agent-hub/monitor-runtime.test.ts .pi/harnesses/agent-hub/monitor-bridge-runtime.test.ts .pi/harnesses/agent-hub/monitor-reconcile.test.ts .pi/harnesses/agent-hub/monitor-recovery.test.ts .pi/harnesses/agent-hub/monitor-lifecycle-lease.test.ts .pi/harnesses/agent-hub/monitor-session-bridge-race.test.ts .pi/harnesses/agent-hub/monitor-session-bridge.test.ts .pi/harnesses/agent-hub/monitor-cancel-race.test.ts .pi/harnesses/agent-hub/monitor-wait-only.test.ts .pi/harnesses/agent-hub/monitor-publisher.test.ts .pi/harnesses/agent-hub/monitor-index.integration.test.ts hermes/desktop-plugins/agent-fleet-herdr/presentation.test.js scripts/docs-links.test.mjs && npm run test:watchdog-py",
108
109
  "test:watchdog-py": "PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s hermes/watchdog-tests -p 'test_*.py'",
109
110
  "pack:dry": "npm pack --dry-run",
110
111
  "changeset": "changeset",
package/scripts/fleet.ts CHANGED
@@ -6,7 +6,7 @@ import { spawnSync } from "node:child_process";
6
6
  import { parseFleetCommand } from "./lib/fleet-command.ts";
7
7
  import { resolveMonitorEnv } from "./lib/monitor-env.ts";
8
8
 
9
- const HELP = `Agent Fleet — one guarded Hub runtime, two postures, independent topology
9
+ const HELP = `Agent Fleet — one guarded Hub runtime, two work modes, independent topology
10
10
 
11
11
  SET UP A NEW REPOSITORY
12
12
  npx @chankov/agent-fleet@latest setup
@@ -30,22 +30,22 @@ FLEET CORE — loaded in every Pi mode
30
30
  BTW side sessions · update checker (voice is opt-in with --voice)
31
31
 
32
32
  UNIFIED HUB
33
- just fleet [--posture operator|orchestrator] [--agents <roster>]
33
+ just fleet [--work-mode operator|orchestrator] [--agents <roster>]
34
34
  [--herdr] [--peers <preset>] [--no-coms] [PI_ARGS...]
35
- Bare Fleet always loads Agent Hub in operator posture. Operator keeps
35
+ Bare Fleet always loads Agent Hub in operator work mode. Operator keeps
36
36
  read/bash/edit/write plus orchestration; the initial native roster is empty.
37
37
  --agents selects .pi/agents/teams.yaml and implies orchestrator unless an
38
- explicit --posture operator is supplied. --no-coms leaves direct/native work
38
+ explicit --work-mode operator is supplied. --no-coms leaves direct/native work
39
39
  available while coms, peer dispatch, and handoff refuse actionably.
40
40
 
41
- POSTURE AND ROSTER
42
- /af-posture # report posture and capability state
41
+ WORK MODE AND ROSTER
42
+ /af-work-mode # report work mode and capability state
43
43
  /af-agents-add code-reviewer # add a native Pi specialist at runtime
44
- /af-posture orchestrator # remove direct coding tools; keep orchestration
45
- /af-posture operator # restore the approved direct tool surface
44
+ /af-work-mode orchestrator # remove direct coding tools; keep orchestration
45
+ /af-work-mode operator # restore the approved direct tool surface
46
46
 
47
- Posture is independent from the native roster and peer topology. Budgets follow task tier.
48
- All Hub slash commands, including /af-handoff, stay registered in both postures;
47
+ Work mode is independent from the native roster and peer topology. Budgets follow task tier.
48
+ All Hub slash commands, including /af-handoff, stay registered in both work modes;
49
49
  actions whose coms/Herdr capability is unavailable return remediation guidance.
50
50
 
51
51
  Explicit dispatch backend examples (inside the Hub):
@@ -47,7 +47,11 @@ interface HubParseDefaults {
47
47
  }
48
48
 
49
49
  function parseHubInvocation(args: string[], defaults: HubParseDefaults = {}): FleetInvocation {
50
- let posture: "operator" | "orchestrator" | undefined;
50
+ if (args.some(arg => arg === "--posture" || arg.startsWith("--posture="))) {
51
+ throw new Error("--posture was removed; use --work-mode operator|orchestrator.");
52
+ }
53
+
54
+ let workMode: "operator" | "orchestrator" | undefined;
51
55
  let agents = defaults.defaultAgents;
52
56
  let peers = defaults.forcedPeers;
53
57
  let herdr = defaults.forceHerdr ?? false;
@@ -59,7 +63,7 @@ function parseHubInvocation(args: string[], defaults: HubParseDefaults = {}): Fl
59
63
  let projectSeen = false;
60
64
  let agentsSeen = false;
61
65
  let peersSeen = false;
62
- let postureSeen = false;
66
+ let workModeSeen = false;
63
67
  let herdrSeen = false;
64
68
  let noComsSeen = false;
65
69
  let browserSeen = false;
@@ -76,12 +80,12 @@ function parseHubInvocation(args: string[], defaults: HubParseDefaults = {}): Fl
76
80
  break;
77
81
  }
78
82
  switch (arg) {
79
- case "--posture": {
80
- if (postureSeen) throw new Error("--posture may only be provided once");
81
- postureSeen = true;
82
- const value = requireValue(args[++i], "--posture requires operator or orchestrator");
83
- if (value !== "operator" && value !== "orchestrator") throw new Error("--posture requires operator or orchestrator");
84
- posture = value;
83
+ case "--work-mode": {
84
+ if (workModeSeen) throw new Error("--work-mode may only be provided once");
85
+ workModeSeen = true;
86
+ const value = requireValue(args[++i], "--work-mode requires operator or orchestrator");
87
+ if (value !== "operator" && value !== "orchestrator") throw new Error("--work-mode requires operator or orchestrator");
88
+ workMode = value;
85
89
  break;
86
90
  }
87
91
  case "--agents":
@@ -141,14 +145,14 @@ function parseHubInvocation(args: string[], defaults: HubParseDefaults = {}): Fl
141
145
  }
142
146
  }
143
147
 
144
- if (posture === "orchestrator" && !agents) throw new Error("--posture orchestrator requires --agents <roster>");
148
+ if (workMode === "orchestrator" && !agents) throw new Error("--work-mode orchestrator requires --agents <roster>");
145
149
  const topology = herdr || peers !== undefined;
146
150
  if (dryRun && !topology) throw new Error("--dry-run requires --herdr or --peers");
147
151
 
148
152
  let invocation: FleetInvocation;
149
153
  if (topology) {
150
154
  const forwarded = [
151
- ...(posture ? ["--posture", posture] : []),
155
+ ...(workMode ? ["--work-mode", workMode] : []),
152
156
  ...(agents ? [defaults.legacyAgents ? "--legacy-agents" : "--agents", agents] : []),
153
157
  ...(noComs ? ["--no-coms"] : []),
154
158
  ...(browser ? ["--browser"] : []),
@@ -165,7 +169,7 @@ function parseHubInvocation(args: string[], defaults: HubParseDefaults = {}): Fl
165
169
  bool(browser),
166
170
  bool(voice),
167
171
  bool(allExtensions),
168
- ...(posture ? ["--posture", posture] : []),
172
+ ...(workMode ? ["--work-mode", workMode] : []),
169
173
  ...(agents ? ["--agent-team", agents] : []),
170
174
  ...rest,
171
175
  ],
@@ -112,7 +112,7 @@ export function teamWorkspaceLabel(
112
112
  }
113
113
 
114
114
  export interface HubCommandOptions {
115
- posture?: "operator" | "orchestrator";
115
+ workMode?: "operator" | "orchestrator";
116
116
  agentTeam?: string;
117
117
  noComs?: boolean;
118
118
  browser?: boolean;
@@ -134,7 +134,7 @@ export function hubCommand(
134
134
  validateProject(project);
135
135
  if (options.agentTeam) validateTeamName(options.agentTeam);
136
136
  const command = ["just", "fleet"];
137
- if (options.posture) command.push("--posture", options.posture);
137
+ if (options.workMode) command.push("--work-mode", options.workMode);
138
138
  if (options.agentTeam) command.push("--agents", options.agentTeam);
139
139
  if (options.noComs) command.push("--no-coms");
140
140
  if (options.browser) command.push("--browser");
@@ -221,7 +221,7 @@ async function main(): Promise<void> {
221
221
  let hubBrowser: boolean;
222
222
  let hubAllExtensions: boolean;
223
223
  let hubNoComs: boolean;
224
- let hubPosture: "operator" | "orchestrator" | undefined;
224
+ let hubWorkMode: "operator" | "orchestrator" | undefined;
225
225
  let hubAgentTeam: string | undefined;
226
226
  try {
227
227
  dryRun = booleanFlag(argv, "--dry-run");
@@ -229,11 +229,11 @@ async function main(): Promise<void> {
229
229
  hubBrowser = booleanFlag(argv, "--browser");
230
230
  hubAllExtensions = booleanFlag(argv, "--all-extensions");
231
231
  hubNoComs = booleanFlag(argv, "--no-coms");
232
- const posture = flagValue(argv, "--posture");
233
- if (posture && posture !== "operator" && posture !== "orchestrator") {
234
- throw new Error("--posture requires operator or orchestrator");
232
+ const workMode = flagValue(argv, "--work-mode");
233
+ if (workMode && workMode !== "operator" && workMode !== "orchestrator") {
234
+ throw new Error("--work-mode requires operator or orchestrator");
235
235
  }
236
- hubPosture = posture ?? undefined;
236
+ hubWorkMode = workMode ?? undefined;
237
237
  const canonicalAgents = flagValue(argv, "--agents");
238
238
  const legacyAgents = flagValue(argv, "--legacy-agents");
239
239
  if (canonicalAgents && legacyAgents) throw new Error("--agents and --legacy-agents are mutually exclusive");
@@ -246,11 +246,11 @@ async function main(): Promise<void> {
246
246
  } catch (err) {
247
247
  die(err instanceof Error ? err.message : String(err));
248
248
  }
249
- if (!hub && (hubBrowser || hubAllExtensions || hubNoComs || hubPosture || hubAgentTeam)) {
250
- die("--posture/--agents/--no-coms/--browser/--all-extensions apply to the hub pane and therefore require --hub");
249
+ if (!hub && (hubBrowser || hubAllExtensions || hubNoComs || hubWorkMode || hubAgentTeam)) {
250
+ die("--work-mode/--agents/--no-coms/--browser/--all-extensions apply to the hub pane and therefore require --hub");
251
251
  }
252
- if (hubPosture === "orchestrator" && !hubAgentTeam) {
253
- die("--posture orchestrator requires --agents <roster>");
252
+ if (hubWorkMode === "orchestrator" && !hubAgentTeam) {
253
+ die("--work-mode orchestrator requires --agents <roster>");
254
254
  }
255
255
  let conductor: ConductorBackend | null;
256
256
  try {
@@ -297,7 +297,7 @@ async function main(): Promise<void> {
297
297
  // reads them, and a peer is not a hub.
298
298
  const monitorEnv = dryRun ? null : resolveMonitorEnv();
299
299
  const hubOptions = {
300
- posture: hubPosture,
300
+ workMode: hubWorkMode,
301
301
  agentTeam: hubAgentTeam,
302
302
  noComs: hubNoComs,
303
303
  browser: hubBrowser,
@@ -1,11 +1,59 @@
1
1
  # Grilling (Internal Helper)
2
2
 
3
- Use this helper from a parent skill when the user asks to grill or stress-test a plan, spec, or design, or when an important design choice is being silently assumed.
3
+ Use this helper from a parent skill whenever a plan, spec, design, or
4
+ implementation must take a decision. Explicit invocation ("grill this",
5
+ "stress-test this") still triggers it; so does any unspecified fork. Do not
6
+ wait for the user to ask.
4
7
 
5
- Interview the user relentlessly until the important decisions are explicitly accepted, rejected, or deferred. Walk the design tree one dependency at a time: choose the next question based on prior answers, and skip questions made irrelevant by earlier decisions.
8
+ Interview until each **open** decision is explicitly accepted, rejected, or
9
+ deferred. Walk the design tree one dependency at a time: choose the next
10
+ question from prior answers, and skip questions made irrelevant by earlier
11
+ decisions.
6
12
 
7
- Ask one focused question at a time. Offer 2-4 concrete options plus your recommended answer and a brief reason, then wait for the user's decision before continuing. This should feel like guided architectural interrogation, not a questionnaire dump.
13
+ ## Do not re-ask what is already settled
8
14
 
9
- If a question can be answered by reading the codebase, docs, tests, or runtime evidence, investigate first and ask only about the remaining decision.
15
+ Do **not** grill a point that is already explicit in any of:
10
16
 
11
- Keep grilling until shared understanding is strong enough to write or revise the downstream artifact. When review exposes gaps later, convert each gap into one targeted follow-up question.
17
+ - the current chat, user prompt, or spoken/written instruction
18
+ - a PRD, spec, plan, ticket, or other written requirement
19
+ - a project rule, skill, or standing instruction
20
+
21
+ Treat those as accepted. Re-asking wastes attention and implies the agent did
22
+ not read the source of truth.
23
+
24
+ ## Must grill — unspecified forks
25
+
26
+ Grill every remaining point that is load-bearing and still open:
27
+
28
+ - **Multiple valid ways** — architecture, library, naming, scope cut, data
29
+ model, error behavior, where two or more approaches would all work and the
30
+ trade-off is preference-dependent
31
+ - **Doubt or contradiction** — sources disagree (chat vs code, spec vs tests,
32
+ two rules, two existing implementations)
33
+ - **Code variants** — the codebase already has several patterns and one must
34
+ be chosen for this change; propose one recommended option among them
35
+
36
+ If a question can be answered by reading the codebase, docs, tests, or runtime
37
+ evidence, investigate first and ask only about the remaining decision.
38
+
39
+ If grilling produces **zero** questions (everything load-bearing was already
40
+ settled), say so briefly and proceed. Do not invent questions to look thorough.
41
+
42
+ ## How to ask
43
+
44
+ Ask one focused question at a time. Offer 2-4 concrete options plus your
45
+ recommended answer and a brief reason, then wait for the user's decision
46
+ before continuing. This should feel like guided architectural interrogation,
47
+ not a questionnaire dump.
48
+
49
+ ## When it applies
50
+
51
+ Planning, spec writing, **and implementation** — whenever a decision must be
52
+ taken. A plan that silently picks a library, and an implementer that silently
53
+ picks among existing code patterns, are the same failure.
54
+
55
+ Keep grilling until shared understanding is strong enough to write or revise
56
+ the downstream artifact. Record each accepted, rejected, or deferred choice in
57
+ that artifact (Architecture Decisions, Boundaries, or the slice summary).
58
+ When review exposes gaps later, convert each gap into one targeted follow-up
59
+ question.
@@ -88,7 +88,7 @@ Read `frameworks.md` in this skill directory for additional ideation frameworks
88
88
 
89
89
  After the user reacts to Phase 1 (indicates which ideas resonate, pushes back, adds context), shift to convergent mode.
90
90
 
91
- **Grilling mode:** If the user asks to "grill" or stress-test a specific plan/design, read the shared internal helper at [`../_internal/grilling.md`](../_internal/grilling.md) and use that one-question-at-a-time decision interview before producing the one-pager. Treat the answers as inputs to Key Assumptions, MVP Scope, Not Doing, and Open Questions.
91
+ **Grilling:** When converging on a direction — and whenever the user asks to "grill" or stress-test a plan/design — read the shared internal helper at [`../_internal/grilling.md`](../_internal/grilling.md). Skip points already explicit in chat, prompt, PRD, or rules. Grill remaining unspecified forks one question at a time, with a recommended option, before producing the one-pager. Treat the answers as inputs to Key Assumptions, MVP Scope, Not Doing, and Open Questions.
92
92
 
93
93
  1. **Cluster** the ideas that resonated into 2-3 distinct directions. Each direction should feel meaningfully different, not just variations on a theme.
94
94
 
@@ -176,7 +176,7 @@ After completing an ideation session:
176
176
  - [ ] The target user and success criteria are defined
177
177
  - [ ] Multiple directions were explored, not just the first idea
178
178
  - [ ] Hidden assumptions are explicitly listed with validation strategies
179
- - [ ] If grilling was invoked, decisions were resolved one at a time and reflected in the one-pager
179
+ - [ ] Unspecified forks were grilled one at a time (or grilling found none); already-stated points were not re-asked; decisions are reflected in the one-pager
180
180
  - [ ] A "Not Doing" list makes trade-offs explicit
181
181
  - [ ] The output is a concrete artifact (markdown one-pager), not just conversation
182
182
  - [ ] The user confirmed the final direction before any implementation work
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: incremental-implementation
3
- description: Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
3
+ description: Delivers changes incrementally and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
4
4
  ---
5
5
 
6
6
  # Incremental Implementation
@@ -160,6 +160,12 @@ NOTICED BUT NOT TOUCHING:
160
160
  → Want me to create tasks for these?
161
161
  ```
162
162
 
163
+ ### Rule 0.6: Grill unspecified forks; do not re-ask settled ones
164
+
165
+ A plan does not freeze every decision. Before (and during) a slice, if a load-bearing choice is **not** already explicit in the task, plan, PRD, chat, prompt, or rules — multiple valid approaches, a contradiction, or several existing code patterns — read [`../_internal/grilling.md`](../_internal/grilling.md) and ask one question at a time, with a recommended option. Wait. Do not pick silently and do not re-confirm what those sources already stated.
166
+
167
+ If grilling produces zero questions, proceed with the slice.
168
+
163
169
  ### Rule 1: One Thing at a Time
164
170
 
165
171
  Each increment changes one logical thing. Don't mix concerns:
@@ -238,6 +244,7 @@ After each increment, verify:
238
244
  - [ ] Type checking passes (`npx tsc --noEmit`)
239
245
  - [ ] Linting passes (`npm run lint`)
240
246
  - [ ] The new functionality works as expected
247
+ - [ ] Unspecified load-bearing forks were grilled (or grilling found none); already-stated requirements were not re-asked
241
248
  - [ ] The Standard Slice Summary was presented to the user
242
249
  - [ ] Explicit user approval was received before starting the next slice
243
250
  - [ ] The agent did not run `git add`, `git commit`, `git reset`, or `git restore` during this slice (whatever the user staged or committed between slices is preserved as-is)
@@ -255,6 +262,8 @@ After each increment, verify:
255
262
  | "This refactor is small enough to include" | Refactors mixed with features make both harder to review and debug. Separate them. |
256
263
  | "I'll just stage it to make their life easier" | Don't. The user explicitly controls staging and commits. Do not run any git state-changing command — and do not "tidy up" by unstaging or resetting what the user staged between slices. |
257
264
  | "They didn't answer but it's obviously fine, I'll continue" | No. Silence is not approval. Wait for an explicit response before starting the next slice. |
265
+ | "The plan didn't specify which existing pattern to follow, I'll just pick one" | That is an unspecified fork. Grill it. The programmer needs to know which variant was chosen and why. |
266
+ | "I'll re-confirm the PRD acceptance criteria before coding" | Already-stated requirements are not re-asked. Grill only what is still open. |
258
267
  | "Let me run the build command again just to be sure" | After a successful run, repeating the same command adds nothing unless the code has changed since. Run it again after subsequent edits, not as reassurance. |
259
268
 
260
269
  ## Red Flags
@@ -268,6 +277,8 @@ After each increment, verify:
268
277
  - Staging or committing changes on the user's behalf
269
278
  - Unstaging, resetting, restoring, or stashing changes the user staged or committed between slices ("enforcing" an unstaged working tree is not the agent's job)
270
279
  - Building abstractions before the third use case demands it
280
+ - Silently picking among several valid approaches or existing code patterns
281
+ - Re-asking a requirement already explicit in the task, plan, PRD, chat, or rules
271
282
  - Touching files outside the task scope "while I'm here"
272
283
  - Creating new utility files for one-time operations
273
284
  - Running the same build/test command twice in a row without any intervening code change
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: planning-and-task-breakdown
3
- description: Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, when parallel work is possible, or when the user wants to grill a plan before implementation.
3
+ description: Breaks work into ordered tasks and grills unspecified design forks before writing them. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, when parallel work is possible, or when more than one valid approach exists and the plan must lock a choice.
4
4
  ---
5
5
 
6
6
  # Planning and Task Breakdown
@@ -16,9 +16,9 @@ Decompose work into small, verifiable tasks with explicit acceptance criteria. G
16
16
  - Work needs to be parallelized across multiple agents or sessions
17
17
  - You need to communicate scope to a human
18
18
  - The implementation order isn't obvious
19
- - The user asks to grill or stress-test a draft plan before implementation
19
+ - More than one valid approach, a contradiction, or competing code patterns must be locked before tasks are written
20
20
 
21
- **When NOT to use:** Single-file changes with obvious scope, or when the spec already contains well-defined tasks.
21
+ **When NOT to use:** Single-file changes with obvious scope, or when the spec already contains well-defined tasks. Skipping a plan file does **not** skip grilling: if the change can be done several ways and none is mandated, ask before coding.
22
22
 
23
23
  ## Proportionality gate (check before writing anything)
24
24
 
@@ -37,6 +37,7 @@ Rules that follow from this:
37
37
  - **Plan the ask, not the neighbourhood.** Adjacent problems you notice go in a short "Out of scope / noticed" list at the end for the human to decide on. They do not become tasks.
38
38
  - **Split by phase when the phases have different owners.** Repository work, cloud/infrastructure preparation, deployment, and retirement belong in separate plans: bundling them means the whole plan is blocked on whichever phase stalls, and every review re-reads all of it.
39
39
  - **Review findings do not silently enlarge the plan.** When a plan revision adds requirements nobody asked for, say so explicitly and let the human accept or drop them.
40
+ - **Unspecified forks still get grilled.** Skipping a plan file does not skip a load-bearing choice. Already-stated requirements (chat, prompt, PRD, rules) are not re-asked.
40
41
 
41
42
  ## Output Location
42
43
 
@@ -65,7 +66,7 @@ Before writing any code, operate in read-only mode:
65
66
 
66
67
  **Do NOT write code during planning.** The output is a plan document, not implementation.
67
68
 
68
- **Grilling mode:** If the user asks to grill/stress-test the plan, or Step 1 reveals a load-bearing assumption, read the shared internal helper at [`../_internal/grilling.md`](../_internal/grilling.md) before writing tasks. Resolve decisions one at a time; update Architecture Decisions, Risks, and Open Questions with accepted, rejected, or deferred choices.
69
+ **Grilling (required before writing tasks):** Read the shared internal helper at [`../_internal/grilling.md`](../_internal/grilling.md). Inventory load-bearing decisions. Skip anything already explicit in chat, prompt, PRD, spec, or rules. Grill every remaining fork (multiple valid ways, contradiction, competing code patterns) one question at a time, with a recommended option. Do not write tasks while a load-bearing choice is still silently assumed. Update Architecture Decisions, Risks, and Open Questions with accepted, rejected, or deferred choices. If nothing is open, note that grilling found no unspecified forks and continue.
69
70
 
70
71
  ### Step 2: Identify the Dependency Graph
71
72
 
@@ -226,6 +227,9 @@ When multiple agents or sessions are available:
226
227
  | "The tasks are obvious" | Write them down anyway. Explicit tasks surface hidden dependencies and forgotten edge cases. |
227
228
  | "Planning is overhead" | Planning is the task. Implementation without a plan is just typing. |
228
229
  | "I can hold it all in my head" | Context windows are finite. Written plans survive session boundaries and compaction. |
230
+ | "The PRD already covers everything, no need to grill" | Then grilling produces zero questions. Still run the inventory so silent forks do not slip through. |
231
+ | "I'll pick the obvious variant and note it in Architecture Decisions" | If more than one variant exists and none was mandated, it is not obvious to the programmer who was not in the room. Ask, then record the choice. |
232
+ | "Re-confirming the PRD points shows thoroughness" | Re-asking settled requirements wastes the user and implies the agent did not read them. Skip them. |
229
233
 
230
234
  ## Red Flags
231
235
 
@@ -235,6 +239,9 @@ When multiple agents or sessions are available:
235
239
  - All tasks touches more than 8+ files
236
240
  - No checkpoints between tasks
237
241
  - Dependency order isn't considered
242
+ - Writing tasks that silently pick a library, pattern, or behavior not mandated in chat/PRD/rules
243
+ - Re-asking a requirement already explicit in chat, prompt, PRD, spec, or rules
244
+ - Leaving an unspecified fork as an Open Question without asking
238
245
 
239
246
  ## Verification
240
247
 
@@ -246,7 +253,9 @@ Before starting implementation, confirm:
246
253
  - [ ] No task touches more than ~5 files
247
254
  - [ ] Checkpoints exist between major phases
248
255
  - [ ] The human has reviewed and approved the plan
249
- - [ ] If grilling was invoked, each load-bearing decision has an accepted/rejected/deferred status in the plan
256
+ - [ ] Grilling ran before tasks were written (inventory of load-bearing decisions)
257
+ - [ ] Already-stated requirements (chat, prompt, PRD, spec, rules) were not re-asked
258
+ - [ ] Each remaining load-bearing decision has an accepted/rejected/deferred status in the plan
250
259
  - [ ] No open questions left (All are resolved/answered/commented)
251
260
 
252
261
  ## See Also
@@ -69,18 +69,13 @@ Writing a spec without reading what already exists leads to duplication, contrad
69
69
 
70
70
  Then start with a high-level vision. Ask the human clarifying questions until requirements are concrete.
71
71
 
72
- **Grilling mode:** If the user asks to grill a concept/spec, or a requirement depends on unconfirmed design choices, read the shared internal helper at [`../_internal/grilling.md`](../_internal/grilling.md) before locking the spec. Resolve decisions one at a time; fold each answer into Success Criteria, Boundaries, Proposed decisions, or Open Questions.
72
+ **Grilling (required before locking the spec):** Read the shared internal helper at [`../_internal/grilling.md`](../_internal/grilling.md). Skip anything already explicit in chat, prompt, PRD, or rules — do not re-confirm it. Grill every remaining unconfirmed design choice (multiple valid ways, contradiction, competing code patterns) one question at a time, with a recommended option. Fold each answer into Success Criteria, Boundaries, Proposed decisions, or Open Questions. If nothing is open, note that grilling found no unspecified forks and continue.
73
73
 
74
- **Surface assumptions immediately.** Before writing any spec content, list what you're assuming:
74
+ **Surface assumptions immediately.** Before writing any spec content, classify what you would otherwise assume:
75
75
 
76
- ```
77
- ASSUMPTIONS I'M MAKING:
78
- 1. This is a web application (not native mobile)
79
- 2. Authentication uses session-based cookies (not JWT)
80
- 3. The database is PostgreSQL (based on existing Prisma schema)
81
- 4. We're targeting modern browsers only (no IE11)
82
- → Correct me now or I'll proceed with these.
83
- ```
76
+ - Already explicit in chat, prompt, or rules → do not re-ask.
77
+ - Confirmed in code, tests, or trusted docs (e.g. PostgreSQL because the Prisma schema is already Postgres) → do not re-ask; mark Confirmed.
78
+ - Load-bearing and still open (native vs web, cookies vs JWT when neither is mandated) → grill per the helper above and **wait**. Do not dump a list and proceed unless corrected.
84
79
 
85
80
  Don't silently fill in ambiguous requirements. The spec's entire purpose is to surface misunderstandings *before* code gets written — assumptions are the most dangerous form of misunderstanding.
86
81
 
@@ -244,6 +239,8 @@ The spec is a living document, not a one-time artifact:
244
239
  - Implementing features not mentioned in any spec or task list
245
240
  - Making architectural decisions without documenting them
246
241
  - Skipping the spec because "it's obvious what to build"
242
+ - Re-asking a requirement already explicit in chat, prompt, or rules
243
+ - Locking a spec that silently picks among several valid approaches
247
244
 
248
245
  ## Verification
249
246
 
@@ -251,7 +248,9 @@ Before proceeding to implementation, confirm:
251
248
 
252
249
  - [ ] The spec covers all six core areas
253
250
  - [ ] The human has reviewed and approved the spec
254
- - [ ] If grilling was invoked, each load-bearing decision is recorded as accepted, rejected, or deferred
251
+ - [ ] Grilling ran before the spec was locked (inventory of load-bearing decisions)
252
+ - [ ] Already-stated requirements (chat, prompt, rules) were not re-asked
253
+ - [ ] Each remaining load-bearing decision is recorded as accepted, rejected, or deferred
255
254
  - [ ] Success criteria are specific and testable
256
255
  - [ ] Boundaries (Always/Ask First/Never) are defined
257
256
  - [ ] The spec is saved to its output location (see Output Location)