@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
@@ -0,0 +1,406 @@
1
+ // scripts/team-up.ts
2
+ //
3
+ // Spawn a team of reusable coms peers (from .pi/agents/peers.yaml) into a
4
+ // herdr workspace — one pane per peer in a tiled BSP layout, each running the
5
+ // hidden `just _peer …` helper. Public use is through `just fleet team` and
6
+ // `just fleet conductor`; all backing recipes remain private. Herdr is a hard
7
+ // dependency for fleet spawning: without a running server the recipes refuse
8
+ // with an actionable message.
9
+ //
10
+ // Hard rules:
11
+ // - Entrypoint guard: launching lives inside main(); importing the module must
12
+ // NOT spawn anything.
13
+ // - peers.yaml + the repo root are resolved relative to THIS file, so the script
14
+ // works regardless of the caller's cwd.
15
+ // - Manifest values are validated against a safe charset before being placed in
16
+ // a pane command (the file is user-edited) — reject anything else. The pure
17
+ // parsing/validation/layout logic lives in scripts/lib/herdr-layout.ts.
18
+ // - --dry-run prints the resolved layout JSON and exits WITHOUT touching herdr
19
+ // (must work with no herdr installed), so command construction is testable
20
+ // without launching pi. env_file VALUES never appear in dry-run output —
21
+ // only the path (secrets stay out of terminals and logs).
22
+ // - Never clobber an existing workspace of the same label; refuse and explain.
23
+
24
+ import * as fs from "node:fs";
25
+ import * as os from "node:os";
26
+ import * as path from "node:path";
27
+ import { fileURLToPath } from "node:url";
28
+
29
+ import { parseTeamsYaml } from "../.pi/harnesses/agent-hub/helpers.ts";
30
+ import {
31
+ buildTeamLayout,
32
+ parseEnvFile,
33
+ parsePeersYaml,
34
+ resolveEnvFilePath,
35
+ type LayoutNode,
36
+ type Peer,
37
+ } from "./lib/herdr-layout.ts";
38
+ import { resolveMonitorEnv } from "./lib/monitor-env.ts";
39
+ import { planSpawnDelays } from "./lib/spawn-stagger.ts";
40
+ import {
41
+ DEFAULT_PROJECT,
42
+ conductorSpec,
43
+ hubCommand,
44
+ parseProjectFlag,
45
+ resolveLegacyAgentRoster,
46
+ teamWorkspaceLabel,
47
+ validateTeamName,
48
+ worktreeTag,
49
+ type ConductorBackend,
50
+ type ConductorSpec,
51
+ } from "./lib/team-project.ts";
52
+
53
+ const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
54
+ const REPO_ROOT = fs.realpathSync(path.resolve(SCRIPT_DIR, ".."));
55
+ // Scopes the workspace label to this checkout so the same team from another
56
+ // repo/worktree gets its own workspace instead of colliding (see worktreeTag).
57
+ const WORKTREE_TAG = worktreeTag(REPO_ROOT);
58
+ const DEFAULT_PEERS_YAML = path.join(REPO_ROOT, ".pi", "agents", "peers.yaml");
59
+ const DEFAULT_TEAMS_YAML = path.join(REPO_ROOT, ".pi", "agents", "teams.yaml");
60
+
61
+ // The guarded hub or Hermes conductor occupies this share of the workspace in
62
+ // --hub/--conductor mode; the team tiles in the rest.
63
+ const HUB_RATIO = 0.4;
64
+
65
+ function flagValue(argv: string[], flag: string): string | null {
66
+ const indexes = argv.flatMap((value, index) => value === flag ? [index] : []);
67
+ if (indexes.length > 1) throw new Error(`${flag} may only be provided once`);
68
+ if (indexes.length === 0) return null;
69
+ const value = argv[indexes[0] + 1];
70
+ if (!value || value.startsWith("--")) throw new Error(`${flag} requires a value`);
71
+ return value;
72
+ }
73
+
74
+ function booleanFlag(argv: string[], flag: string): boolean {
75
+ const count = argv.filter(value => value === flag).length;
76
+ if (count > 1) throw new Error(`${flag} may only be provided once`);
77
+ return count === 1;
78
+ }
79
+
80
+ function die(msg: string): never {
81
+ console.error(msg);
82
+ process.exit(1);
83
+ }
84
+
85
+ function parseConductorBackend(argv: string[]): ConductorBackend | null {
86
+ const indexes = argv.flatMap((value, index) => value === "--conductor" ? [index] : []);
87
+ if (indexes.length > 1) throw new Error("--conductor may only be provided once");
88
+ if (indexes.length === 0) return null;
89
+ const value = argv[indexes[0] + 1];
90
+ if (!value || value.startsWith("--")) return "hermes"; // legacy bare --conductor
91
+ if (value === "hermes" || value === "codex") return value;
92
+ throw new Error(`Unknown conductor backend: ${JSON.stringify(value)} (expected hermes or codex)`);
93
+ }
94
+
95
+ function loadTeam(team: string, peersYaml: string): Peer[] {
96
+ if (!fs.existsSync(peersYaml)) die(`peers.yaml not found at ${peersYaml}`);
97
+ const teams = parsePeersYaml(fs.readFileSync(peersYaml, "utf-8"));
98
+ const peers = teams[team];
99
+ if (!peers) {
100
+ const names = Object.keys(teams).join(", ") || "(none)";
101
+ die(`Unknown team "${team}". Available teams: ${names}`);
102
+ }
103
+ return peers;
104
+ }
105
+
106
+ // B3: resolve + validate every peer's env_file BEFORE any spawning, so a bad
107
+ // manifest refuses up front, never mid-boot. Returns a loader for the layout
108
+ // builder; when `redact` is set (dry-run) values are never read at all.
109
+ function makeEnvLoader(
110
+ peers: Peer[],
111
+ redact: boolean,
112
+ ): (peer: Peer) => Record<string, string> | undefined {
113
+ const resolved = new Map<Peer, string>();
114
+ for (const p of peers) {
115
+ if (!p.env_file) continue;
116
+ let abs: string;
117
+ try {
118
+ abs = resolveEnvFilePath(p.env_file, REPO_ROOT);
119
+ } catch (err) {
120
+ die(err instanceof Error ? err.message : String(err));
121
+ }
122
+ if (!redact && !fs.existsSync(abs)) {
123
+ die(`Peer "${p.name}": env_file not found: ${p.env_file} (resolved: ${abs})`);
124
+ }
125
+ resolved.set(p, abs);
126
+ }
127
+ return (peer) => {
128
+ const abs = resolved.get(peer);
129
+ if (!abs || redact) return undefined;
130
+ try {
131
+ return parseEnvFile(fs.readFileSync(abs, "utf-8"), peer.env_file);
132
+ } catch (err) {
133
+ die(err instanceof Error ? err.message : String(err));
134
+ }
135
+ };
136
+ }
137
+
138
+ // Pre-warm/stagger (see scripts/lib/spawn-stagger.ts): when auth.json holds a
139
+ // stale OAuth token, simultaneous pi boots race on its file lock and the
140
+ // losers come up with every provider "unconfigured". One pi pane (the hub
141
+ // when present, else the first pi peer) starts immediately and refreshes the
142
+ // token; the others get a small AGENT_FLEET_SPAWN_DELAY via pane env. The
143
+ // auth file is only read for `type`/`expires` — values never leave this
144
+ // process. Dry-run never reaches this (no live-state reads on that path).
145
+ function makeDelayLoader(peers: Peer[], mode: "peers" | "hub" | "conductor"): (peer: Peer) => number | undefined {
146
+ let raw: string | undefined;
147
+ try {
148
+ raw = fs.readFileSync(path.join(os.homedir(), ".pi", "agent", "auth.json"), "utf-8");
149
+ } catch {
150
+ raw = undefined;
151
+ }
152
+ // The conductor root is Hermes, not pi — the first pi peer warms instead.
153
+ const { needed, delayForPeer } = planSpawnDelays(peers, mode === "hub", raw);
154
+ if (needed) {
155
+ console.log("Stale pi OAuth token detected — staggering pane starts so one pane can refresh it first.");
156
+ }
157
+ return delayForPeer;
158
+ }
159
+
160
+ async function validateCodexLaunchOrDie(spec: ConductorSpec, project: string): Promise<void> {
161
+ try {
162
+ const { assertConductorContext, lifecyclePaths, loadOwnedConfig, preflight, requestedState } = await import("./lib/codex-remote-control.ts");
163
+ const config = loadOwnedConfig(lifecyclePaths().configPath);
164
+ assertConductorContext(config, {
165
+ repoRoot: REPO_ROOT,
166
+ project,
167
+ team: spec.team,
168
+ name: spec.conductorName,
169
+ timeoutMs: Number(spec.env.COMS_CLI_TIMEOUT_MS),
170
+ contractPath: String(spec.env.AGENT_FLEET_CODEX_CONTRACT_PATH),
171
+ contractIdentity: String(spec.env.AGENT_FLEET_CODEX_CONTRACT_IDENTITY),
172
+ });
173
+ preflight(config);
174
+ const state = requestedState();
175
+ if (state.active !== "active" || state.sub !== "exited") {
176
+ throw new Error(`Codex user service is not in requested active (exited) state: ${state.active} (${state.sub})`);
177
+ }
178
+ } catch (err) {
179
+ die(`Codex launch refused before Herdr: ${err instanceof Error ? err.message : String(err)}`);
180
+ }
181
+ }
182
+
183
+ function buildLayoutOrDie(
184
+ team: string,
185
+ peers: Peer[],
186
+ envForPeer: (p: Peer) => Record<string, string> | undefined,
187
+ project: string,
188
+ rootPane?: { command: string[]; label: string; ratio: number; cwd?: string; env?: Record<string, string> },
189
+ delayForPeer?: (p: Peer) => number | undefined,
190
+ ): LayoutNode {
191
+ try {
192
+ return buildTeamLayout({
193
+ team,
194
+ peers,
195
+ repoRoot: REPO_ROOT,
196
+ envForPeer,
197
+ project,
198
+ ...(delayForPeer ? { delayForPeer } : {}),
199
+ ...(rootPane ? { hub: rootPane } : {}),
200
+ });
201
+ } catch (err) {
202
+ die(err instanceof Error ? err.message : String(err));
203
+ }
204
+ }
205
+
206
+ async function main(): Promise<void> {
207
+ const argv = process.argv.slice(2);
208
+ let team: string | null = null;
209
+ let peersYaml = DEFAULT_PEERS_YAML;
210
+ let project = DEFAULT_PROJECT;
211
+ try {
212
+ team = flagValue(argv, "--team");
213
+ project = parseProjectFlag(argv);
214
+ // --peers: alternate manifest path (tests use it; defaults to the repo's).
215
+ peersYaml = flagValue(argv, "--peers") ?? DEFAULT_PEERS_YAML;
216
+ } catch (err) {
217
+ die(err instanceof Error ? err.message : String(err));
218
+ }
219
+ let dryRun: boolean;
220
+ let hub: boolean;
221
+ let hubBrowser: boolean;
222
+ let hubAllExtensions: boolean;
223
+ let hubNoComs: boolean;
224
+ let hubPosture: "operator" | "orchestrator" | undefined;
225
+ let hubAgentTeam: string | undefined;
226
+ try {
227
+ dryRun = booleanFlag(argv, "--dry-run");
228
+ hub = booleanFlag(argv, "--hub");
229
+ hubBrowser = booleanFlag(argv, "--browser");
230
+ hubAllExtensions = booleanFlag(argv, "--all-extensions");
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");
235
+ }
236
+ hubPosture = posture ?? undefined;
237
+ const canonicalAgents = flagValue(argv, "--agents");
238
+ const legacyAgents = flagValue(argv, "--legacy-agents");
239
+ if (canonicalAgents && legacyAgents) throw new Error("--agents and --legacy-agents are mutually exclusive");
240
+ if (legacyAgents) {
241
+ const nativeTeams = parseTeamsYaml(fs.readFileSync(DEFAULT_TEAMS_YAML, "utf-8"));
242
+ hubAgentTeam = resolveLegacyAgentRoster(nativeTeams, legacyAgents);
243
+ } else {
244
+ hubAgentTeam = canonicalAgents ?? undefined;
245
+ }
246
+ } catch (err) {
247
+ die(err instanceof Error ? err.message : String(err));
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");
251
+ }
252
+ if (hubPosture === "orchestrator" && !hubAgentTeam) {
253
+ die("--posture orchestrator requires --agents <roster>");
254
+ }
255
+ let conductor: ConductorBackend | null;
256
+ try {
257
+ conductor = parseConductorBackend(argv);
258
+ } catch (err) {
259
+ die(err instanceof Error ? err.message : String(err));
260
+ }
261
+ if (hub && conductor) die("--hub and --conductor are mutually exclusive");
262
+ const mode: "peers" | "hub" | "conductor" = hub ? "hub" : conductor ? "conductor" : "peers";
263
+
264
+ if (!team) {
265
+ console.error("usage: team-up.ts --team <name> [--hub|--conductor] [--dry-run] [--peers <peers.yaml>] [--project <name>]");
266
+ process.exit(2);
267
+ }
268
+
269
+ try {
270
+ validateTeamName(team);
271
+ } catch (err) {
272
+ die(err instanceof Error ? err.message : String(err));
273
+ }
274
+ const peers = loadTeam(team, peersYaml);
275
+ if (peers.length === 0 && mode === "peers") {
276
+ die(`Team "${team}" has no peers. Empty teams require --hub or --conductor.`);
277
+ }
278
+ let spec: ConductorSpec | undefined;
279
+ let label: string;
280
+ try {
281
+ spec = conductor ? conductorSpec(conductor, {
282
+ repoRoot: REPO_ROOT,
283
+ runtimeDir: path.join(os.homedir(), ".local", "state", "agent-fleet", "codex-conductor"),
284
+ team,
285
+ project,
286
+ nodeBin: process.execPath,
287
+ }) : undefined;
288
+ label = teamWorkspaceLabel(spec?.workspaceMode ?? (hub ? "hub" : "peers"), team, project, WORKTREE_TAG);
289
+ } catch (err) {
290
+ die(err instanceof Error ? err.message : String(err));
291
+ }
292
+ // The hub pane is spawned BY herdr, whose daemon was started at some other
293
+ // time from some other shell — so unlike `just fleet hub`, it inherits
294
+ // nothing from this process. The monitor variables have to travel as pane
295
+ // env or the one launcher most likely to want a task tree is the one that
296
+ // never gets one. Peers deliberately do not receive them: only agent-hub
297
+ // reads them, and a peer is not a hub.
298
+ const monitorEnv = dryRun ? null : resolveMonitorEnv();
299
+ const hubOptions = {
300
+ posture: hubPosture,
301
+ agentTeam: hubAgentTeam,
302
+ noComs: hubNoComs,
303
+ browser: hubBrowser,
304
+ allExtensions: hubAllExtensions,
305
+ };
306
+ const rootPane = hub
307
+ ? {
308
+ command: hubCommand(project, hubOptions),
309
+ label: "hub",
310
+ ratio: HUB_RATIO,
311
+ ...(monitorEnv ? { env: monitorEnv } : {}),
312
+ }
313
+ : spec
314
+ ? { command: spec.command, label: spec.paneLabel, ratio: spec.ratio, cwd: spec.cwd, env: { ...spec.env, ...(monitorEnv ?? {}) } }
315
+ : undefined;
316
+
317
+ if (dryRun) {
318
+ // No herdr calls and no env_file reads on this path — must work with no
319
+ // herdr installed, and secrets never reach the output.
320
+ const layout = buildLayoutOrDie(team, peers, makeEnvLoader(peers, true), project, rootPane);
321
+ const projectNote = project === DEFAULT_PROJECT ? "" : `, project "${project}"`;
322
+ const extra = mode === "hub" ? " + hub" : spec ? ` + ${spec.backend === "codex" ? "Codex conductor" : "Hermes conductor"}` : "";
323
+ console.log(
324
+ `# team-up (dry run) — team "${team}"${projectNote}, ${peers.length} peer(s)${extra}, herdr workspace "${label}"`,
325
+ );
326
+ for (const p of peers) {
327
+ const cmd = layoutCommands(layout, p.name as string) ?? [];
328
+ const envNote = p.env_file ? ` [env_file: ${p.env_file} — values redacted]` : "";
329
+ console.log(`${p.name}\t${cmd.join(" ")}${envNote}`);
330
+ }
331
+ console.log(JSON.stringify({ label, layout }, null, 2));
332
+ return;
333
+ }
334
+
335
+ if (spec?.backend === "codex") await validateCodexLaunchOrDie(spec, project);
336
+ const layout = buildLayoutOrDie(team, peers, makeEnvLoader(peers, false), project, rootPane, makeDelayLoader(peers, mode));
337
+
338
+ // Import lazily so --dry-run never touches the client (or the socket).
339
+ const { herdr, requireHerdr, HerdrUnavailableError } = await import(
340
+ "../.pi/harnesses/lib/herdr-client.ts"
341
+ );
342
+
343
+ try {
344
+ await requireHerdr();
345
+ } catch (err) {
346
+ if (err instanceof HerdrUnavailableError) {
347
+ console.error(err.message);
348
+ const projectArgs = project === DEFAULT_PROJECT ? "" : ` --project ${project}`;
349
+ const dryCommand = mode === "hub"
350
+ ? `just fleet team ${team} --dry-run${projectArgs}`
351
+ : spec?.backend === "codex"
352
+ ? `just fleet conductor codex ${team} --dry-run${projectArgs}`
353
+ : mode === "conductor"
354
+ ? `just fleet conductor hermes ${team} --dry-run${projectArgs}`
355
+ : `just fleet team ${team} --no-hub --dry-run${projectArgs}`;
356
+ console.error(`(dry run still works: ${dryCommand})`);
357
+ process.exit(1);
358
+ }
359
+ throw err;
360
+ }
361
+
362
+ const { workspaces } = await herdr.workspaceList();
363
+ const existing = workspaces.find((w) => w.label === label);
364
+ if (existing) {
365
+ console.error(`herdr workspace "${label}" already exists (${existing.workspace_id}).`);
366
+ console.error(` focus: herdr workspace focus ${existing.workspace_id}`);
367
+ console.error(` close: herdr workspace close ${existing.workspace_id}`);
368
+ process.exit(1);
369
+ }
370
+
371
+ const created = await herdr.workspaceCreate({ label, cwd: REPO_ROOT, focus: false });
372
+ const wsId = created.workspace.workspace_id;
373
+ const initialTab = created.workspace.active_tab_id ?? created.tab?.tab_id;
374
+ await herdr.layoutApply({ workspace_id: wsId, root: layout });
375
+ // layout.apply lands in a fresh tab; drop the empty shell tab
376
+ // workspace.create made so the team tab is the only one.
377
+ if (initialTab) {
378
+ try {
379
+ await herdr.tabClose(initialTab);
380
+ } catch {
381
+ // non-fatal: an extra empty tab is cosmetic
382
+ }
383
+ }
384
+
385
+ const launchedPrefix = mode === "hub" ? "hub + " : spec ? `${spec.backend} conductor + ` : "";
386
+ console.log(
387
+ `Launched ${launchedPrefix}${peers.length} peer(s) for team "${team}" in herdr workspace "${label}" (${wsId}):`,
388
+ );
389
+ if (mode === "hub") {
390
+ console.log(` • hub (${hubCommand(project, hubOptions).join(" ")} — guarded dispatcher)`);
391
+ }
392
+ if (spec) console.log(` • ${spec.paneLabel} (${spec.command.join(" ")} — ${spec.displayText})`);
393
+ if (spec?.backend === "codex") console.log(" • Closing this workspace does not stop the enabled Codex user service; stop it explicitly.");
394
+ for (const p of peers) console.log(` • ${p.name}`);
395
+ console.log(`Focus: herdr workspace focus ${wsId}`);
396
+ console.log(`Close: herdr workspace close ${wsId}`);
397
+ }
398
+
399
+ // Dry-run helper: find the command argv for the pane labeled `name`.
400
+ function layoutCommands(node: LayoutNode, name: string): string[] | undefined {
401
+ if (node.type === "pane") return node.label === name ? node.command : undefined;
402
+ return layoutCommands(node.first, name) ?? layoutCommands(node.second, name);
403
+ }
404
+
405
+ const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
406
+ if (isEntry) void main();
@@ -0,0 +1,59 @@
1
+ # Grilling (Internal Helper)
2
+
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.
7
+
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.
12
+
13
+ ## Do not re-ask what is already settled
14
+
15
+ Do **not** grill a point that is already explicit in any of:
16
+
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.