@chankov/agent-fleet 2.0.6 → 2.0.8

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 (1050) hide show
  1. package/.pi/agent-fleet/hermes/README.md +347 -0
  2. package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  3. package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  4. package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  5. package/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  6. package/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  7. package/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  8. package/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  9. package/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  10. package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  11. package/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  12. package/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  13. package/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  14. package/.pi/agent-fleet/scripts/fleet.ts +216 -0
  15. package/.pi/agent-fleet/scripts/flow.ts +137 -0
  16. package/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  17. package/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  18. package/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  19. package/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  20. package/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  21. package/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  22. package/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  23. package/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  24. package/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  25. package/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  26. package/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  27. package/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  28. package/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  29. package/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  30. package/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  31. package/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  32. package/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  33. package/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  34. package/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  35. package/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  36. package/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  37. package/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  38. package/.pi/agent-fleet/scripts/team-up.ts +378 -0
  39. package/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  40. package/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  41. package/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  42. package/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  43. package/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  44. package/.pi/agents/peers.yaml +3 -1
  45. package/.pi/harnesses/agent-hub/README.md +1 -1
  46. package/.pi/harnesses/agent-hub/config/agents.ts +5 -1
  47. package/.pi/harnesses/agent-hub/debate-command.ts +1 -1
  48. package/.pi/harnesses/agent-hub/index.ts +19 -19
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
  51. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +3 -5
  52. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
  53. package/.pi/harnesses/ask-user-remote/index.ts +2 -2
  54. package/.pi/harnesses/coms/package.json +1 -1
  55. package/.pi/harnesses/damage-control-continue/README.md +11 -0
  56. package/.pi/harnesses/damage-control-continue/index.ts +5 -0
  57. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  58. package/.pi/harnesses/lib/spawned-peers.js +1 -1
  59. package/.pi/harnesses/lib/update-check.ts +222 -0
  60. package/.pi/prompts/af-constraints.md +31 -0
  61. package/.versions/2.0.7/.pi/agents/dispatch-policy.yaml +32 -0
  62. package/.versions/2.0.7/.pi/agents/model-profiles.yaml +83 -0
  63. package/.versions/2.0.7/.pi/agents/peers.yaml +145 -0
  64. package/.versions/2.0.7/.pi/agents/teams.yaml +41 -0
  65. package/.versions/2.0.7/.pi/agents/voices.yaml +13 -0
  66. package/.versions/2.0.7/.pi/damage-control-rules.yaml +297 -0
  67. package/.versions/2.0.7/.pi/extensions/btw/README.md +120 -0
  68. package/.versions/2.0.7/.pi/extensions/btw/index.ts +914 -0
  69. package/{.pi/extensions/agent-fleet-update-check → .versions/2.0.7/.pi/extensions/btw}/package.json +1 -1
  70. package/.versions/2.0.7/.pi/extensions/btw/state.js +179 -0
  71. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  72. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  73. package/.versions/2.0.7/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  74. package/.versions/2.0.7/.pi/extensions/compact-and-continue/README.md +42 -0
  75. package/.versions/2.0.7/.pi/extensions/compact-and-continue/index.ts +120 -0
  76. package/.versions/2.0.7/.pi/extensions/compact-and-continue/package.json +6 -0
  77. package/.versions/2.0.7/.pi/extensions/mcp-bridge/README.md +46 -0
  78. package/.versions/2.0.7/.pi/extensions/mcp-bridge/index.ts +206 -0
  79. package/.versions/2.0.7/.pi/extensions/mcp-bridge/package.json +6 -0
  80. package/.versions/2.0.7/.pi/extensions/package-lock.json +1175 -0
  81. package/.versions/2.0.7/.pi/extensions/package.json +9 -0
  82. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/README.md +205 -0
  83. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/config.ts +198 -0
  84. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  85. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/index.ts +248 -0
  86. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/package.json +6 -0
  87. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  88. package/.versions/2.0.7/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  89. package/.versions/2.0.7/.pi/harnesses/agent-hub/README.md +1203 -0
  90. package/.versions/2.0.7/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  91. package/.versions/2.0.7/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  92. package/.versions/2.0.7/.pi/harnesses/agent-hub/artifacts.js +146 -0
  93. package/.versions/2.0.7/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  94. package/.versions/2.0.7/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  95. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  96. package/.versions/2.0.7/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  97. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  98. package/.versions/2.0.7/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  99. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  100. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  101. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  102. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  103. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  104. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  105. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  106. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  107. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  108. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  109. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  110. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  111. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  112. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  113. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  114. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  115. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  116. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  117. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  118. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  119. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  120. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  121. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  122. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  123. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  124. package/.versions/2.0.7/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  125. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/agents.ts +173 -0
  126. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  127. package/.versions/2.0.7/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  128. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  129. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  130. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  131. package/.versions/2.0.7/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  132. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  133. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  134. package/.versions/2.0.7/.pi/harnesses/agent-hub/context-window.js +106 -0
  135. package/.versions/2.0.7/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  136. package/.versions/2.0.7/.pi/harnesses/agent-hub/delegate.ts +446 -0
  137. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  138. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  139. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  140. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  141. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  142. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  143. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  144. package/.versions/2.0.7/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  145. package/.versions/2.0.7/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  146. package/.versions/2.0.7/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  147. package/.versions/2.0.7/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  148. package/.versions/2.0.7/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  149. package/.versions/2.0.7/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  150. package/.versions/2.0.7/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  151. package/.versions/2.0.7/.pi/harnesses/agent-hub/footer.ts +30 -0
  152. package/.versions/2.0.7/.pi/harnesses/agent-hub/helpers.ts +266 -0
  153. package/.versions/2.0.7/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  154. package/.versions/2.0.7/.pi/harnesses/agent-hub/index.ts +2151 -0
  155. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  156. package/.versions/2.0.7/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  157. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  158. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  159. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  160. package/.versions/2.0.7/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  161. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  162. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  163. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  164. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  165. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  166. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  167. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  168. package/.versions/2.0.7/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  169. package/.versions/2.0.7/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  170. package/.versions/2.0.7/.pi/harnesses/agent-hub/package.json +7 -0
  171. package/.versions/2.0.7/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  172. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  173. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  174. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  175. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  176. package/.versions/2.0.7/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  177. package/.versions/2.0.7/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  178. package/.versions/2.0.7/.pi/harnesses/agent-hub/presentation.ts +48 -0
  179. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  180. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  181. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  182. package/.versions/2.0.7/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  183. package/.versions/2.0.7/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  184. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  185. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  186. package/.versions/2.0.7/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  187. package/.versions/2.0.7/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  188. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-contract.js +293 -0
  189. package/.versions/2.0.7/.pi/harnesses/agent-hub/return-extract.js +75 -0
  190. package/.versions/2.0.7/.pi/harnesses/agent-hub/review-findings.js +102 -0
  191. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-budget.js +537 -0
  192. package/.versions/2.0.7/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  193. package/.versions/2.0.7/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  194. package/.versions/2.0.7/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  195. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-health.js +110 -0
  196. package/.versions/2.0.7/.pi/harnesses/agent-hub/session-start.ts +42 -0
  197. package/.versions/2.0.7/.pi/harnesses/agent-hub/spawn.ts +404 -0
  198. package/.versions/2.0.7/.pi/harnesses/agent-hub/timeline.ts +54 -0
  199. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  200. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  201. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  202. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  203. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  204. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  205. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  206. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  207. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  208. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  209. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  210. package/.versions/2.0.7/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  211. package/.versions/2.0.7/.pi/harnesses/agent-hub/types.ts +63 -0
  212. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  213. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  214. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  215. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  216. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  217. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  218. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  219. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  220. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  221. package/.versions/2.0.7/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  222. package/.versions/2.0.7/.pi/harnesses/agent-hub/version.ts +42 -0
  223. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  224. package/.versions/2.0.7/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  225. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/README.md +59 -0
  226. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/index.ts +558 -0
  227. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  228. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  229. package/.versions/2.0.7/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  230. package/.versions/2.0.7/.pi/harnesses/coms/README.md +100 -0
  231. package/.versions/2.0.7/.pi/harnesses/coms/index.ts +282 -0
  232. package/.versions/2.0.7/.pi/harnesses/coms/package.json +7 -0
  233. package/.versions/2.0.7/.pi/harnesses/coms/version.ts +42 -0
  234. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/README.md +135 -0
  235. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/index.ts +541 -0
  236. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/package.json +7 -0
  237. package/.versions/2.0.7/.pi/harnesses/damage-control-continue/version.ts +42 -0
  238. package/.versions/2.0.7/.pi/harnesses/lib/coms-core-io.ts +385 -0
  239. package/.versions/2.0.7/.pi/harnesses/lib/coms-core.ts +577 -0
  240. package/.versions/2.0.7/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  241. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  242. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  243. package/.versions/2.0.7/.pi/harnesses/lib/context-budget-view.ts +107 -0
  244. package/.versions/2.0.7/.pi/harnesses/lib/context-budget.ts +114 -0
  245. package/.versions/2.0.7/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  246. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  247. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  248. package/.versions/2.0.7/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  249. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  250. package/.versions/2.0.7/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  251. package/.versions/2.0.7/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  252. package/.versions/2.0.7/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  253. package/.versions/2.0.7/.pi/harnesses/lib/fleet-panel.ts +34 -0
  254. package/.versions/2.0.7/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  255. package/.versions/2.0.7/.pi/harnesses/lib/fleet-selection.ts +24 -0
  256. package/.versions/2.0.7/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  257. package/.versions/2.0.7/.pi/harnesses/lib/herdr-client.ts +472 -0
  258. package/.versions/2.0.7/.pi/harnesses/lib/herdr-presence.ts +399 -0
  259. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  260. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  261. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  262. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  263. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  264. package/.versions/2.0.7/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  265. package/.versions/2.0.7/.pi/harnesses/lib/spawned-peers.js +190 -0
  266. package/.versions/2.0.7/.pi/harnesses/lib/update-check.ts +222 -0
  267. package/.versions/2.0.7/.pi/harnesses/package-lock.json +2039 -0
  268. package/.versions/2.0.7/.pi/harnesses/package.json +10 -0
  269. package/.versions/2.0.7/.pi/prompts/af-build.md +24 -0
  270. package/.versions/2.0.7/.pi/prompts/af-code-simplify.md +22 -0
  271. package/.versions/2.0.7/.pi/prompts/af-plan.md +17 -0
  272. package/.versions/2.0.7/.pi/prompts/af-review.md +16 -0
  273. package/.versions/2.0.7/.pi/prompts/af-set-hermes-telegram.md +15 -0
  274. package/.versions/2.0.7/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  275. package/.versions/2.0.7/.pi/prompts/af-ship.md +17 -0
  276. package/.versions/2.0.7/.pi/prompts/af-spec.md +15 -0
  277. package/.versions/2.0.7/.pi/prompts/af-test.md +19 -0
  278. package/.versions/2.0.7/.pi/skills/bowser/SKILL.md +145 -0
  279. package/.versions/2.0.7/.version +1 -0
  280. package/.versions/2.0.7/agents/architect.md +25 -0
  281. package/.versions/2.0.7/agents/bowser.md +28 -0
  282. package/.versions/2.0.7/agents/builder.md +56 -0
  283. package/.versions/2.0.7/agents/code-reviewer.md +210 -0
  284. package/.versions/2.0.7/agents/deep-researcher.md +33 -0
  285. package/.versions/2.0.7/agents/documenter.md +23 -0
  286. package/.versions/2.0.7/agents/orchestrator.md +23 -0
  287. package/.versions/2.0.7/agents/plan-reviewer.md +84 -0
  288. package/.versions/2.0.7/agents/planner.md +106 -0
  289. package/.versions/2.0.7/agents/releaser.md +25 -0
  290. package/.versions/2.0.7/agents/researcher.md +31 -0
  291. package/.versions/2.0.7/agents/security-auditor.md +168 -0
  292. package/.versions/2.0.7/agents/test-engineer.md +154 -0
  293. package/.versions/2.0.7/agents/web-debugger.md +44 -0
  294. package/.versions/2.0.7/agents/web-performance-auditor.md +194 -0
  295. package/.versions/2.0.7/bin/catalog/harness-runtime-closure.json +31 -0
  296. package/.versions/2.0.7/codex/fleet-session-client/SKILL.md +34 -0
  297. package/.versions/2.0.7/codex/fleet-session-client.zip +0 -0
  298. package/.versions/2.0.7/docs/ARCHITECTURE.md +407 -0
  299. package/.versions/2.0.7/docs/agent-fleet-setup.md +561 -0
  300. package/.versions/2.0.7/docs/claude-code-coms-bridge.md +133 -0
  301. package/.versions/2.0.7/docs/codex-session-bridge.md +219 -0
  302. package/.versions/2.0.7/docs/coms-hermes-bridge.md +188 -0
  303. package/.versions/2.0.7/docs/getting-started.md +126 -0
  304. package/.versions/2.0.7/docs/npm-install.md +327 -0
  305. package/.versions/2.0.7/docs/pi-extensions.md +446 -0
  306. package/.versions/2.0.7/docs/pi-setup.md +76 -0
  307. package/.versions/2.0.7/docs/skill-anatomy.md +150 -0
  308. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  309. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  310. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  311. package/.versions/2.0.7/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  312. package/.versions/2.0.7/hermes/gates/gate-o-capability.md +8 -0
  313. package/.versions/2.0.7/hermes/gates/gate-o-validator-fixtures.json +1 -0
  314. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  315. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  316. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  317. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  318. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  319. package/.versions/2.0.7/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  320. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  321. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  322. package/.versions/2.0.7/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  323. package/.versions/2.0.7/hermes/skills/hub-liaison/SKILL.md +84 -0
  324. package/.versions/2.0.7/hermes/skills/hub-watchdog/manifest.json +1 -0
  325. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  326. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  327. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  328. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  329. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  330. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  331. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  332. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  333. package/.versions/2.0.7/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  334. package/.versions/2.0.7/hermes/watchdog-tests/__init__.py +0 -0
  335. package/.versions/2.0.7/install-manifest.json +2886 -0
  336. package/.versions/2.0.7/justfile +247 -0
  337. package/.versions/2.0.7/manifest-meta.json +958 -0
  338. package/.versions/2.0.7/references/accessibility-checklist.md +160 -0
  339. package/.versions/2.0.7/references/communication-contract.md +26 -0
  340. package/.versions/2.0.7/references/definition-of-done.md +67 -0
  341. package/.versions/2.0.7/references/fleet-coordination-patterns.md +171 -0
  342. package/.versions/2.0.7/references/observability-checklist.md +91 -0
  343. package/.versions/2.0.7/references/orchestration-patterns.md +370 -0
  344. package/.versions/2.0.7/references/performance-checklist.md +153 -0
  345. package/.versions/2.0.7/references/prompting-patterns.md +380 -0
  346. package/.versions/2.0.7/references/security-checklist.md +179 -0
  347. package/.versions/2.0.7/references/testing-patterns.md +236 -0
  348. package/.versions/2.0.7/references/workflow-authoring.md +304 -0
  349. package/.versions/2.0.7/scripts/fleet-codex-client.ts +69 -0
  350. package/{scripts → .versions/2.0.7/scripts}/fleet.ts +1 -1
  351. package/.versions/2.0.7/scripts/hermes-monitor-capability-runner.ts +25 -0
  352. package/.versions/2.0.7/scripts/hermes-monitor-scenario.ts +474 -0
  353. package/.versions/2.0.7/scripts/hermes-watchdog-capability-probe.ts +45 -0
  354. package/.versions/2.0.7/scripts/install-hermes-plugin.sh +180 -0
  355. package/.versions/2.0.7/scripts/lib/fake-herdr-server.ts +88 -0
  356. package/.versions/2.0.7/scripts/lib/fleet-codex-catalog.ts +63 -0
  357. package/.versions/2.0.7/scripts/lib/fleet-codex-operations.ts +190 -0
  358. package/.versions/2.0.7/scripts/lib/fleet-codex-session.ts +166 -0
  359. package/.versions/2.0.7/scripts/lib/fleet-command.ts +252 -0
  360. package/.versions/2.0.7/scripts/lib/flow-command.ts +93 -0
  361. package/.versions/2.0.7/scripts/lib/flow-maintenance.ts +230 -0
  362. package/.versions/2.0.7/scripts/package-lock.json +35 -0
  363. package/.versions/2.0.7/scripts/package.json +9 -0
  364. package/.versions/2.0.7/scripts/workflows/lib/changes.ts +61 -0
  365. package/.versions/2.0.7/scripts/workflows/lib/debate.ts +149 -0
  366. package/.versions/2.0.7/scripts/workflows/lib/env.ts +34 -0
  367. package/.versions/2.0.7/scripts/workflows/lib/gates.ts +81 -0
  368. package/.versions/2.0.7/scripts/workflows/lib/git.ts +96 -0
  369. package/.versions/2.0.7/scripts/workflows/lib/merge.ts +95 -0
  370. package/.versions/2.0.7/scripts/workflows/lib/model-visibility.ts +92 -0
  371. package/.versions/2.0.7/scripts/workflows/lib/permissions.ts +130 -0
  372. package/.versions/2.0.7/scripts/workflows/lib/poll.ts +86 -0
  373. package/.versions/2.0.7/scripts/workflows/lib/quality.ts +64 -0
  374. package/.versions/2.0.7/scripts/workflows/lib/run.ts +108 -0
  375. package/.versions/2.0.7/scripts/workflows/lib/voices.ts +128 -0
  376. package/.versions/2.0.7/scripts/workflows/lib/writer-lease.ts +112 -0
  377. package/.versions/2.0.7/scripts/workflows/tsconfig.json +22 -0
  378. package/.versions/2.0.7/scripts/workflows/wf-build-test.ts +61 -0
  379. package/.versions/2.0.7/scripts/workflows/wf-debate.ts +87 -0
  380. package/.versions/2.0.7/scripts/workflows/wf-document.ts +50 -0
  381. package/.versions/2.0.7/scripts/workflows/wf-poll.ts +95 -0
  382. package/.versions/2.0.7/scripts/workflows/wf-quality.ts +20 -0
  383. package/.versions/2.0.7/scripts/workflows/wf-scout.ts +38 -0
  384. package/.versions/2.0.7/skills/_internal/grilling.md +59 -0
  385. package/.versions/2.0.7/skills/browser-testing-with-devtools/SKILL.md +351 -0
  386. package/.versions/2.0.7/skills/code-review-and-quality/SKILL.md +381 -0
  387. package/.versions/2.0.7/skills/compound-learning/SKILL.md +137 -0
  388. package/.versions/2.0.7/skills/context-engineering/SKILL.md +291 -0
  389. package/.versions/2.0.7/skills/deprecation-and-migration/SKILL.md +206 -0
  390. package/.versions/2.0.7/skills/designing-agents/SKILL.md +394 -0
  391. package/.versions/2.0.7/skills/designing-agents/pi-harness-authoring.md +222 -0
  392. package/.versions/2.0.7/skills/drafting-workflows/SKILL.md +143 -0
  393. package/.versions/2.0.7/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  394. package/.versions/2.0.7/skills/frontend-ui-engineering/SKILL.md +328 -0
  395. package/.versions/2.0.7/skills/git-workflow-and-versioning/SKILL.md +316 -0
  396. package/.versions/2.0.7/skills/idea-refine/SKILL.md +182 -0
  397. package/.versions/2.0.7/skills/idea-refine/examples.md +238 -0
  398. package/.versions/2.0.7/skills/idea-refine/frameworks.md +99 -0
  399. package/.versions/2.0.7/skills/idea-refine/refinement-criteria.md +113 -0
  400. package/.versions/2.0.7/skills/idea-refine/scripts/idea-refine.sh +15 -0
  401. package/.versions/2.0.7/skills/incremental-implementation/SKILL.md +298 -0
  402. package/.versions/2.0.7/skills/interview-me/SKILL.md +226 -0
  403. package/.versions/2.0.7/skills/orchestration-verification/SKILL.md +181 -0
  404. package/.versions/2.0.7/skills/peer-coms/SKILL.md +90 -0
  405. package/.versions/2.0.7/skills/performance-optimization/SKILL.md +350 -0
  406. package/.versions/2.0.7/skills/planning-and-task-breakdown/SKILL.md +265 -0
  407. package/.versions/2.0.7/skills/security-and-hardening/SKILL.md +461 -0
  408. package/.versions/2.0.7/skills/spec-driven-development/SKILL.md +256 -0
  409. package/.versions/2.0.7/skills/using-agent-skills/SKILL.md +197 -0
  410. package/.versions/2.0.7/vendor/agent-skills-upstream/LICENSE +21 -0
  411. package/.versions/2.0.7/vendor/agent-skills-upstream/README.md +11 -0
  412. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  413. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  414. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  415. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  416. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  417. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  418. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  419. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  420. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  421. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  422. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  423. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  424. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  425. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  426. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  427. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  428. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  429. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  430. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  431. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  432. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  433. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  434. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  435. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  436. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  437. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  438. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  439. package/.versions/2.0.7/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  440. package/.versions/2.0.8/.pi/agent-fleet/hermes/README.md +347 -0
  441. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  442. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  443. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  444. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  445. package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  446. package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  447. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  448. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  449. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  450. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  451. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  452. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  453. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  454. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  455. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  456. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  457. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  458. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  459. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  460. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  461. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  462. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  463. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  464. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  465. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  466. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  467. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  468. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  469. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  470. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  471. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  472. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  473. package/.versions/2.0.8/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  474. package/.versions/2.0.8/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  475. package/.versions/2.0.8/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  476. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  477. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  478. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  479. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  480. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  481. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet.ts +216 -0
  482. package/.versions/2.0.8/.pi/agent-fleet/scripts/flow.ts +137 -0
  483. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  484. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  485. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  486. package/.versions/2.0.8/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  487. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  488. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  489. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  490. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  491. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  492. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  493. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  494. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  495. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  496. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  497. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  498. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  499. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  500. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  501. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  502. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  503. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  504. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  505. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  506. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  507. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  508. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  509. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  510. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  511. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  512. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  513. package/.versions/2.0.8/.pi/agent-fleet/scripts/package-lock.json +35 -0
  514. package/.versions/2.0.8/.pi/agent-fleet/scripts/package.json +9 -0
  515. package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  516. package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  517. package/.versions/2.0.8/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  518. package/.versions/2.0.8/.pi/agent-fleet/scripts/team-up.ts +378 -0
  519. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  520. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  521. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  522. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  523. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  524. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  525. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  526. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  527. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  528. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  529. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  530. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  531. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  532. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  533. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  534. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  535. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  536. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  537. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  538. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  539. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  540. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  541. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  542. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  543. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  544. package/.versions/2.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  545. package/.versions/2.0.8/.pi/agents/model-profiles.yaml +83 -0
  546. package/.versions/2.0.8/.pi/agents/peers.yaml +147 -0
  547. package/.versions/2.0.8/.pi/agents/teams.yaml +41 -0
  548. package/.versions/2.0.8/.pi/agents/voices.yaml +13 -0
  549. package/.versions/2.0.8/.pi/damage-control-rules.yaml +297 -0
  550. package/.versions/2.0.8/.pi/extensions/btw/README.md +120 -0
  551. package/.versions/2.0.8/.pi/extensions/btw/index.ts +914 -0
  552. package/.versions/2.0.8/.pi/extensions/btw/package.json +6 -0
  553. package/.versions/2.0.8/.pi/extensions/btw/state.js +179 -0
  554. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  555. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  556. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  557. package/.versions/2.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  558. package/.versions/2.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  559. package/.versions/2.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  560. package/.versions/2.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  561. package/.versions/2.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  562. package/.versions/2.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  563. package/.versions/2.0.8/.pi/extensions/package-lock.json +1175 -0
  564. package/.versions/2.0.8/.pi/extensions/package.json +9 -0
  565. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/README.md +205 -0
  566. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  567. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  568. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  569. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  570. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  571. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  572. package/.versions/2.0.8/.pi/harnesses/agent-hub/README.md +1203 -0
  573. package/.versions/2.0.8/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  574. package/.versions/2.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  575. package/.versions/2.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  576. package/.versions/2.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  577. package/.versions/2.0.8/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  578. package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  579. package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  580. package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  581. package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  582. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  583. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  584. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  585. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  586. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  587. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  588. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  589. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  590. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  591. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  592. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  593. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  594. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  595. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  596. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  597. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  598. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  599. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  600. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  601. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  602. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  603. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  604. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  605. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  606. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  607. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  608. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  609. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  610. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  611. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  612. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  613. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  614. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  615. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  616. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  617. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  618. package/.versions/2.0.8/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  619. package/.versions/2.0.8/.pi/harnesses/agent-hub/delegate.ts +446 -0
  620. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  621. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  622. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  623. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  624. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  625. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  626. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  627. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  628. package/.versions/2.0.8/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  629. package/.versions/2.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  630. package/.versions/2.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  631. package/.versions/2.0.8/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  632. package/.versions/2.0.8/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  633. package/.versions/2.0.8/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  634. package/.versions/2.0.8/.pi/harnesses/agent-hub/footer.ts +30 -0
  635. package/.versions/2.0.8/.pi/harnesses/agent-hub/helpers.ts +266 -0
  636. package/.versions/2.0.8/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  637. package/.versions/2.0.8/.pi/harnesses/agent-hub/index.ts +2151 -0
  638. package/.versions/2.0.8/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  639. package/.versions/2.0.8/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  640. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  641. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  642. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  643. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  644. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  645. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  646. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  647. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  648. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  649. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  650. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  651. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  652. package/.versions/2.0.8/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  653. package/.versions/2.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  654. package/.versions/2.0.8/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  655. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  656. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  657. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  658. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  659. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  660. package/.versions/2.0.8/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  661. package/.versions/2.0.8/.pi/harnesses/agent-hub/presentation.ts +48 -0
  662. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  663. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  664. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  665. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  666. package/.versions/2.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  667. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  668. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  669. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  670. package/.versions/2.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  671. package/.versions/2.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  672. package/.versions/2.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  673. package/.versions/2.0.8/.pi/harnesses/agent-hub/review-findings.js +102 -0
  674. package/.versions/2.0.8/.pi/harnesses/agent-hub/run-budget.js +537 -0
  675. package/.versions/2.0.8/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  676. package/.versions/2.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  677. package/.versions/2.0.8/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  678. package/.versions/2.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  679. package/.versions/2.0.8/.pi/harnesses/agent-hub/session-start.ts +42 -0
  680. package/.versions/2.0.8/.pi/harnesses/agent-hub/spawn.ts +404 -0
  681. package/.versions/2.0.8/.pi/harnesses/agent-hub/timeline.ts +54 -0
  682. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  683. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  684. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  685. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  686. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  687. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  688. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  689. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  690. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  691. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  692. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  693. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  694. package/.versions/2.0.8/.pi/harnesses/agent-hub/types.ts +63 -0
  695. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  696. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  697. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  698. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  699. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  700. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  701. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  702. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  703. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  704. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  705. package/.versions/2.0.8/.pi/harnesses/agent-hub/version.ts +42 -0
  706. package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  707. package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  708. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/README.md +59 -0
  709. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/index.ts +558 -0
  710. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  711. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  712. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  713. package/.versions/2.0.8/.pi/harnesses/coms/README.md +100 -0
  714. package/.versions/2.0.8/.pi/harnesses/coms/index.ts +282 -0
  715. package/.versions/2.0.8/.pi/harnesses/coms/package.json +7 -0
  716. package/.versions/2.0.8/.pi/harnesses/coms/version.ts +42 -0
  717. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/README.md +135 -0
  718. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/index.ts +541 -0
  719. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  720. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/version.ts +42 -0
  721. package/.versions/2.0.8/.pi/harnesses/lib/coms-core-io.ts +385 -0
  722. package/.versions/2.0.8/.pi/harnesses/lib/coms-core.ts +577 -0
  723. package/.versions/2.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  724. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  725. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  726. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-view.ts +107 -0
  727. package/.versions/2.0.8/.pi/harnesses/lib/context-budget.ts +114 -0
  728. package/.versions/2.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  729. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  730. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  731. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  732. package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  733. package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  734. package/.versions/2.0.8/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  735. package/.versions/2.0.8/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  736. package/.versions/2.0.8/.pi/harnesses/lib/fleet-panel.ts +34 -0
  737. package/.versions/2.0.8/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  738. package/.versions/2.0.8/.pi/harnesses/lib/fleet-selection.ts +24 -0
  739. package/.versions/2.0.8/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  740. package/.versions/2.0.8/.pi/harnesses/lib/herdr-client.ts +472 -0
  741. package/.versions/2.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  742. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  743. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  744. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  745. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  746. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  747. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  748. package/.versions/2.0.8/.pi/harnesses/lib/spawned-peers.js +190 -0
  749. package/.versions/2.0.8/.pi/harnesses/lib/update-check.ts +222 -0
  750. package/.versions/2.0.8/.pi/harnesses/package-lock.json +2039 -0
  751. package/.versions/2.0.8/.pi/harnesses/package.json +10 -0
  752. package/.versions/2.0.8/.pi/prompts/af-build.md +24 -0
  753. package/.versions/2.0.8/.pi/prompts/af-code-simplify.md +22 -0
  754. package/.versions/2.0.8/.pi/prompts/af-constraints.md +31 -0
  755. package/.versions/2.0.8/.pi/prompts/af-plan.md +17 -0
  756. package/.versions/2.0.8/.pi/prompts/af-review.md +16 -0
  757. package/.versions/2.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  758. package/.versions/2.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  759. package/.versions/2.0.8/.pi/prompts/af-ship.md +17 -0
  760. package/.versions/2.0.8/.pi/prompts/af-spec.md +15 -0
  761. package/.versions/2.0.8/.pi/prompts/af-test.md +19 -0
  762. package/.versions/2.0.8/.pi/skills/bowser/SKILL.md +145 -0
  763. package/.versions/2.0.8/.version +1 -0
  764. package/.versions/2.0.8/agents/architect.md +25 -0
  765. package/.versions/2.0.8/agents/bowser.md +28 -0
  766. package/.versions/2.0.8/agents/builder.md +56 -0
  767. package/.versions/2.0.8/agents/code-reviewer.md +210 -0
  768. package/.versions/2.0.8/agents/deep-researcher.md +33 -0
  769. package/.versions/2.0.8/agents/documenter.md +23 -0
  770. package/.versions/2.0.8/agents/orchestrator.md +23 -0
  771. package/.versions/2.0.8/agents/plan-reviewer.md +84 -0
  772. package/.versions/2.0.8/agents/planner.md +106 -0
  773. package/.versions/2.0.8/agents/releaser.md +25 -0
  774. package/.versions/2.0.8/agents/researcher.md +31 -0
  775. package/.versions/2.0.8/agents/security-auditor.md +168 -0
  776. package/.versions/2.0.8/agents/test-engineer.md +154 -0
  777. package/.versions/2.0.8/agents/web-debugger.md +44 -0
  778. package/.versions/2.0.8/agents/web-performance-auditor.md +194 -0
  779. package/.versions/2.0.8/bin/catalog/harness-runtime-closure.json +32 -0
  780. package/.versions/2.0.8/codex/fleet-session-client/SKILL.md +34 -0
  781. package/.versions/2.0.8/codex/fleet-session-client.zip +0 -0
  782. package/.versions/2.0.8/docs/ARCHITECTURE.md +416 -0
  783. package/.versions/2.0.8/docs/agent-fleet-setup.md +568 -0
  784. package/.versions/2.0.8/docs/claude-code-coms-bridge.md +134 -0
  785. package/.versions/2.0.8/docs/codex-session-bridge.md +219 -0
  786. package/.versions/2.0.8/docs/coms-hermes-bridge.md +188 -0
  787. package/.versions/2.0.8/docs/getting-started.md +126 -0
  788. package/.versions/2.0.8/docs/npm-install.md +356 -0
  789. package/.versions/2.0.8/docs/pi-extensions.md +446 -0
  790. package/.versions/2.0.8/docs/pi-setup.md +76 -0
  791. package/.versions/2.0.8/docs/skill-anatomy.md +150 -0
  792. package/.versions/2.0.8/install-manifest.json +2991 -0
  793. package/.versions/2.0.8/justfile +247 -0
  794. package/.versions/2.0.8/manifest-meta.json +970 -0
  795. package/.versions/2.0.8/references/accessibility-checklist.md +160 -0
  796. package/.versions/2.0.8/references/communication-contract.md +26 -0
  797. package/.versions/2.0.8/references/definition-of-done.md +67 -0
  798. package/.versions/2.0.8/references/fleet-coordination-patterns.md +171 -0
  799. package/.versions/2.0.8/references/observability-checklist.md +92 -0
  800. package/.versions/2.0.8/references/orchestration-patterns.md +370 -0
  801. package/.versions/2.0.8/references/performance-checklist.md +236 -0
  802. package/.versions/2.0.8/references/prompting-patterns.md +380 -0
  803. package/.versions/2.0.8/references/security-checklist.md +245 -0
  804. package/.versions/2.0.8/references/testing-patterns.md +235 -0
  805. package/.versions/2.0.8/references/workflow-authoring.md +304 -0
  806. package/.versions/2.0.8/skills/_internal/grilling.md +59 -0
  807. package/.versions/2.0.8/skills/browser-testing-with-devtools/SKILL.md +351 -0
  808. package/.versions/2.0.8/skills/code-review-and-quality/SKILL.md +396 -0
  809. package/.versions/2.0.8/skills/compound-learning/SKILL.md +137 -0
  810. package/.versions/2.0.8/skills/constraint-driven-development/SKILL.md +338 -0
  811. package/.versions/2.0.8/skills/constraint-driven-development/references/floor-guard.md +99 -0
  812. package/.versions/2.0.8/skills/context-engineering/SKILL.md +341 -0
  813. package/.versions/2.0.8/skills/deprecation-and-migration/SKILL.md +247 -0
  814. package/.versions/2.0.8/skills/designing-agents/SKILL.md +394 -0
  815. package/.versions/2.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  816. package/.versions/2.0.8/skills/drafting-workflows/SKILL.md +143 -0
  817. package/.versions/2.0.8/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  818. package/.versions/2.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  819. package/.versions/2.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  820. package/.versions/2.0.8/skills/idea-refine/SKILL.md +182 -0
  821. package/.versions/2.0.8/skills/idea-refine/examples.md +238 -0
  822. package/.versions/2.0.8/skills/idea-refine/frameworks.md +99 -0
  823. package/.versions/2.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  824. package/.versions/2.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  825. package/.versions/2.0.8/skills/incremental-implementation/SKILL.md +302 -0
  826. package/.versions/2.0.8/skills/interview-me/SKILL.md +226 -0
  827. package/.versions/2.0.8/skills/orchestration-verification/SKILL.md +181 -0
  828. package/.versions/2.0.8/skills/peer-coms/SKILL.md +90 -0
  829. package/.versions/2.0.8/skills/performance-optimization/SKILL.md +496 -0
  830. package/.versions/2.0.8/skills/planning-and-task-breakdown/SKILL.md +289 -0
  831. package/.versions/2.0.8/skills/security-and-hardening/SKILL.md +524 -0
  832. package/.versions/2.0.8/skills/spec-driven-development/SKILL.md +295 -0
  833. package/.versions/2.0.8/skills/using-agent-skills/SKILL.md +198 -0
  834. package/.versions/2.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  835. package/.versions/2.0.8/vendor/agent-skills-upstream/README.md +430 -0
  836. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  837. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  838. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  839. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  840. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  841. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  842. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  843. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  844. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  845. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  846. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  847. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  848. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  849. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  850. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  851. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  852. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  853. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  854. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  855. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  856. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  857. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  858. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  859. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  860. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  861. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  862. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  863. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  864. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  865. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  866. package/CHANGELOG.md +47 -0
  867. package/README.md +24 -16
  868. package/bin/catalog/harness-runtime-closure.json +23 -22
  869. package/bin/cli.js +173 -79
  870. package/bin/lib/apply.js +59 -64
  871. package/bin/lib/detect-agent.js +1 -1
  872. package/bin/lib/doctor.js +3 -3
  873. package/bin/lib/features.js +2 -2
  874. package/bin/lib/manifest.js +23 -16
  875. package/bin/lib/path-boundaries.js +96 -0
  876. package/bin/lib/personas.js +15 -2
  877. package/bin/lib/public-plan.js +17 -0
  878. package/bin/lib/purge.js +9 -3
  879. package/bin/lib/reconcile.js +4 -10
  880. package/bin/lib/repair-desired.js +73 -0
  881. package/bin/lib/set-hermes-telegram.js +2 -2
  882. package/bin/lib/set-hermes-watchdog.js +1 -1
  883. package/bin/lib/state.js +5 -1
  884. package/bin/lib/stt-wizard.js +25 -11
  885. package/bin/lib/transaction.js +118 -108
  886. package/bin/lib/tui.js +70 -65
  887. package/bin/lib/update-notifier.js +2 -2
  888. package/bin/lib/verify.js +43 -5
  889. package/bin/lib/workspace-safety.js +72 -0
  890. package/bin/snapshot-version.js +6 -6
  891. package/codex/fleet-session-client/SKILL.md +3 -3
  892. package/docs/ARCHITECTURE.md +29 -20
  893. package/docs/MIGRATION-agent-fleet.md +11 -7
  894. package/docs/agent-fleet-setup.md +9 -2
  895. package/docs/claude-code-coms-bridge.md +10 -9
  896. package/docs/codex-session-bridge.md +18 -18
  897. package/docs/coms-hermes-bridge.md +6 -6
  898. package/docs/hermes-watchdog-supervisor.md +1 -1
  899. package/docs/npm-install.md +71 -16
  900. package/docs/pi-extensions.md +9 -9
  901. package/docs/pi-setup.md +2 -2
  902. package/docs/workflows.md +9 -5
  903. package/install-manifest.json +202 -135
  904. package/justfile +22 -22
  905. package/manifest-meta.json +51 -57
  906. package/package.json +26 -26
  907. package/references/observability-checklist.md +1 -0
  908. package/references/performance-checklist.md +83 -0
  909. package/references/prompting-patterns.md +1 -1
  910. package/references/security-checklist.md +85 -19
  911. package/references/testing-patterns.md +12 -13
  912. package/references/workflow-authoring.md +5 -5
  913. package/skills/code-review-and-quality/SKILL.md +17 -2
  914. package/skills/constraint-driven-development/SKILL.md +338 -0
  915. package/skills/constraint-driven-development/references/floor-guard.md +99 -0
  916. package/skills/context-engineering/SKILL.md +52 -2
  917. package/skills/deprecation-and-migration/SKILL.md +42 -1
  918. package/skills/designing-agents/SKILL.md +12 -12
  919. package/skills/drafting-workflows/SKILL.md +6 -6
  920. package/skills/drafting-workflows/scripts/make-workflow.ts +3 -3
  921. package/skills/frontend-ui-engineering/SKILL.md +2 -2
  922. package/skills/git-workflow-and-versioning/SKILL.md +1 -1
  923. package/skills/incremental-implementation/SKILL.md +13 -9
  924. package/skills/peer-coms/SKILL.md +4 -4
  925. package/skills/performance-optimization/SKILL.md +152 -6
  926. package/skills/planning-and-task-breakdown/SKILL.md +32 -8
  927. package/skills/security-and-hardening/SKILL.md +84 -21
  928. package/skills/spec-driven-development/SKILL.md +41 -2
  929. package/skills/using-agent-skills/SKILL.md +3 -2
  930. package/vendor/agent-skills-upstream/README.md +427 -8
  931. package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +73 -0
  932. package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +2 -2
  933. package/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  934. package/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  935. package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +49 -1
  936. package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +4 -4
  937. package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +1 -1
  938. package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +12 -2
  939. package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +3 -3
  940. package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +1 -1
  941. package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +1 -1
  942. package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +9 -9
  943. package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +36 -1
  944. package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +151 -5
  945. package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +32 -9
  946. package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +64 -7
  947. package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +26 -6
  948. package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +23 -1
  949. package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +42 -3
  950. package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +18 -3
  951. package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +3 -2
  952. package/.pi/extensions/agent-fleet-update-check/README.md +0 -57
  953. package/.pi/extensions/agent-fleet-update-check/index.ts +0 -161
  954. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/plugin.js +0 -0
  955. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/presentation.js +0 -0
  956. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
  957. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
  958. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/herdr_source.py +0 -0
  959. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/manifest.json +0 -0
  960. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/plugin_api.py +0 -0
  961. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/sessions.py +0 -0
  962. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/tasks.py +0 -0
  963. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/plugin.yaml +0 -0
  964. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
  965. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -0
  966. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
  967. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
  968. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-liaison/SKILL.md +0 -0
  969. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/manifest.json +0 -0
  970. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog.py +0 -0
  971. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_actions.py +0 -0
  972. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_contract.py +0 -0
  973. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_delivery.py +0 -0
  974. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_engine.py +0 -0
  975. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_judgment.py +0 -0
  976. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_recovery.py +0 -0
  977. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_state.py +0 -0
  978. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_transport.py +0 -0
  979. /package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-client.ts +0 -0
  980. /package/{scripts → .pi/agent-fleet/scripts}/hermes-watchdog-capability-probe.ts +0 -0
  981. /package/{scripts → .pi/agent-fleet/scripts}/lib/fake-herdr-server.ts +0 -0
  982. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-catalog.ts +0 -0
  983. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-operations.ts +0 -0
  984. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-session.ts +0 -0
  985. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-command.ts +0 -0
  986. /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-command.ts +0 -0
  987. /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-maintenance.ts +0 -0
  988. /package/{scripts → .pi/agent-fleet/scripts}/package-lock.json +0 -0
  989. /package/{scripts → .pi/agent-fleet/scripts}/package.json +0 -0
  990. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/changes.ts +0 -0
  991. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/debate.ts +0 -0
  992. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/env.ts +0 -0
  993. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/gates.ts +0 -0
  994. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/git.ts +0 -0
  995. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/merge.ts +0 -0
  996. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-visibility.ts +0 -0
  997. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/permissions.ts +0 -0
  998. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/poll.ts +0 -0
  999. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/quality.ts +0 -0
  1000. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/run.ts +0 -0
  1001. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/voices.ts +0 -0
  1002. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/writer-lease.ts +0 -0
  1003. /package/{scripts → .pi/agent-fleet/scripts}/workflows/tsconfig.json +0 -0
  1004. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-build-test.ts +0 -0
  1005. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-debate.ts +0 -0
  1006. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-document.ts +0 -0
  1007. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-poll.ts +0 -0
  1008. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-quality.ts +0 -0
  1009. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-scout.ts +0 -0
  1010. /package/{hermes → .versions/2.0.7/hermes}/README.md +0 -0
  1011. /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/activity.py +0 -0
  1012. /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/coms_registry.py +0 -0
  1013. /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/coms_send.py +0 -0
  1014. /package/{hermes → .versions/2.0.7/hermes}/plugins/agent-fleet-herdr/dashboard/watch.py +0 -0
  1015. /package/{hermes → .versions/2.0.7/hermes}/skills/hub-conductor/SKILL.md +0 -0
  1016. /package/{hermes → .versions/2.0.7/hermes}/skills/hub-watchdog/SKILL.md +0 -0
  1017. /package/{hooks → .versions/2.0.7/hooks}/coms-stop-hook.mjs +0 -0
  1018. /package/{scripts → .versions/2.0.7/scripts}/claude-code-preflight.ts +0 -0
  1019. /package/{scripts → .versions/2.0.7/scripts}/coms-claude-bridge.ts +0 -0
  1020. /package/{scripts → .versions/2.0.7/scripts}/coms-cli.ts +0 -0
  1021. /package/{scripts → .versions/2.0.7/scripts}/coms-hermes-bridge.ts +0 -0
  1022. /package/{scripts → .versions/2.0.7/scripts}/fleet-codex-read.py +0 -0
  1023. /package/{scripts → .versions/2.0.7/scripts}/flow.ts +0 -0
  1024. /package/{scripts → .versions/2.0.7/scripts}/lib/claude-bridge-core.ts +0 -0
  1025. /package/{scripts → .versions/2.0.7/scripts}/lib/coms-envelope.ts +0 -0
  1026. /package/{scripts → .versions/2.0.7/scripts}/lib/fleet-codex-transport.ts +0 -0
  1027. /package/{scripts → .versions/2.0.7/scripts}/lib/herdr-layout.ts +0 -0
  1028. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-bridge-core.ts +0 -0
  1029. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-events.ts +0 -0
  1030. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-herdr.ts +0 -0
  1031. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-model.ts +0 -0
  1032. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-registry.ts +0 -0
  1033. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-socket.ts +0 -0
  1034. /package/{scripts → .versions/2.0.7/scripts}/lib/hermes-monitor-store.ts +0 -0
  1035. /package/{scripts → .versions/2.0.7/scripts}/lib/monitor-env.ts +0 -0
  1036. /package/{scripts → .versions/2.0.7/scripts}/lib/peer-launch.ts +0 -0
  1037. /package/{scripts → .versions/2.0.7/scripts}/lib/persona-banner.ts +0 -0
  1038. /package/{scripts → .versions/2.0.7/scripts}/lib/runtime-dependencies.js +0 -0
  1039. /package/{scripts → .versions/2.0.7/scripts}/lib/spawn-stagger.ts +0 -0
  1040. /package/{scripts → .versions/2.0.7/scripts}/lib/team-project.ts +0 -0
  1041. /package/{scripts → .versions/2.0.7/scripts}/lib/team-snapshot.ts +0 -0
  1042. /package/{scripts → .versions/2.0.7/scripts}/peer-banner.ts +0 -0
  1043. /package/{scripts → .versions/2.0.7/scripts}/peer-launch.ts +0 -0
  1044. /package/{scripts → .versions/2.0.7/scripts}/team-snapshot.ts +0 -0
  1045. /package/{scripts → .versions/2.0.7/scripts}/team-up.ts +0 -0
  1046. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/agent-phase.ts +0 -0
  1047. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/envelopes.ts +0 -0
  1048. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/model-profile.ts +0 -0
  1049. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/personas.ts +0 -0
  1050. /package/{scripts → .versions/2.0.7/scripts}/workflows/lib/trace.ts +0 -0
@@ -8,6 +8,7 @@ Quick reference checklist for web application performance. Use alongside the `pe
8
8
  - [TTFB Diagnosis](#ttfb-diagnosis)
9
9
  - [Frontend Checklist](#frontend-checklist)
10
10
  - [Backend Checklist](#backend-checklist)
11
+ - [Caching Strategies](#caching-strategies)
11
12
  - [Measurement Commands](#measurement-commands)
12
13
  - [Common Anti-Patterns](#common-anti-patterns)
13
14
 
@@ -92,6 +93,30 @@ When TTFB is slow (> 800ms), check each component in DevTools Network waterfall:
92
93
  - [ ] Connection pooling configured
93
94
  - [ ] Slow query logging enabled
94
95
 
96
+ #### Query plans
97
+ - [ ] `EXPLAIN ANALYZE` captured **before** the fix, not just after — it is the baseline
98
+ - [ ] `Seq Scan` on a large table understood: index missing, unusable, or genuinely not worth it
99
+ - [ ] Estimated vs actual `rows=` within an order of magnitude (if not, refresh statistics before touching indexes)
100
+ - [ ] No `Sort` node that a composite index could absorb
101
+ - [ ] Plan re-checked after the change — an index that did not change the plan gets reverted
102
+
103
+ #### Index strategy
104
+ - [ ] Composite index column order is equality first, then range/sort
105
+ - [ ] Index covers the query shape (filter + sort), not just one column in isolation
106
+ - [ ] Covering index considered for hot read paths (index-only scan avoids the heap fetch)
107
+ - [ ] Not indexing low-selectivity columns *for the dominant value*; a partial index still serves the rare-value query (`WHERE status = 'failed'`)
108
+ - [ ] Expression index used where the query applies a function (`lower(email)`)
109
+ - [ ] Full-text or trigram index used for leading-wildcard search, not a B-tree
110
+ - [ ] Write cost measured on write-heavy tables (every index taxes every `INSERT`/`UPDATE`)
111
+ - [ ] Unused and duplicate indexes dropped (they cost writes and buy nothing)
112
+
113
+ #### Connection pooling
114
+ - [ ] One pool per process, not per request or per module
115
+ - [ ] `instances × pool max` stays under the database's `max_connections`
116
+ - [ ] `connectionTimeoutMillis` set so exhaustion fails fast instead of queueing forever
117
+ - [ ] Exhaustion diagnosed before resizing: find what holds connections (long transactions, missing `await`, leaked clients)
118
+ - [ ] Serverless / autoscaling fronted by a multiplexing proxy (pgbouncer, RDS Proxy) rather than a larger pool
119
+
95
120
  ### API
96
121
  - [ ] Response times < 200ms (p95)
97
122
  - [ ] No synchronous heavy computation in request handlers
@@ -105,6 +130,58 @@ When TTFB is slow (> 800ms), check each component in DevTools Network waterfall:
105
130
  - [ ] Horizontal scaling configured (if needed)
106
131
  - [ ] Health check endpoint for load balancer
107
132
 
133
+ ## Caching Strategies
134
+
135
+ The decision material (which layer, which invalidation strategy, what never to cache) lives in the `performance-optimization` skill. This section covers the read/write patterns and the checklist.
136
+
137
+ ### Read and write patterns
138
+
139
+ | Pattern | How it works | Use when | Watch out for |
140
+ |---|---|---|---|
141
+ | **Cache-aside** (lazy) | App checks cache, on miss reads origin and populates | Default choice; read-heavy, tolerant of a cold first hit | Every miss hits the origin, so it needs stampede protection |
142
+ | **Read-through** | Cache layer itself loads on miss | You want the load path in one place, not at every call site | Hides origin latency; a slow origin looks like a slow cache |
143
+ | **Write-through** | Write goes to cache and origin together, synchronously | Reads must never see a stale value after a write | Adds cache latency to every write |
144
+ | **Write-behind** (write-back) | Write hits cache, origin updated asynchronously | Write-heavy, and the origin is the bottleneck | Data loss window if the cache dies before the flush. Needs durability you can defend |
145
+
146
+ ### Negative caching
147
+
148
+ Cache the *absence* of a result too. A key that misses on every lookup (a nonexistent user ID probed in a loop, a 404 asset) sends every request to the origin, which is a cache that only protects the happy path.
149
+
150
+ - Store an explicit "not found" sentinel with a **shorter** TTL than positive entries
151
+ - Keep the negative TTL short enough that a newly created record appears promptly
152
+ - Never let an origin *error* become a negative cache entry, or one failing minute becomes many
153
+
154
+ ### Request coalescing (stampede protection)
155
+
156
+ One recompute, N waiters. Prevents a hot key's expiry from delivering the full concurrent load to the origin:
157
+
158
+ ```typescript
159
+ const inFlight = new Map<string, Promise<unknown>>();
160
+
161
+ function loadOnce<T>(key: string, fetcher: () => Promise<T>): Promise<T> {
162
+ const existing = inFlight.get(key) as Promise<T> | undefined;
163
+ if (existing) return existing;
164
+ const p = fetcher().finally(() => inFlight.delete(key));
165
+ inFlight.set(key, p);
166
+ return p;
167
+ }
168
+ ```
169
+
170
+ For a shared cache, the same idea needs a distributed lock, or `stale-while-revalidate` so waiters serve the stale value instead of blocking.
171
+
172
+ ### Cache checklist
173
+ - [ ] The cached call was measured as expensive first (caching a fast call adds a hop and buys nothing)
174
+ - [ ] Read/write ratio justifies the cache (re-read far more often than written)
175
+ - [ ] Cache key includes every input the response varies on: tenant, viewer, locale, permissions, feature flags
176
+ - [ ] No per-user data cached under a key that does not identify the user
177
+ - [ ] One invalidation strategy chosen (TTL, event/tag, or versioned keys), not an accidental mix
178
+ - [ ] Acceptable staleness window written down, not implied by whatever TTL was typed
179
+ - [ ] Stampede protection on hot keys (coalescing, lock, or `stale-while-revalidate`)
180
+ - [ ] Negative results cached with a shorter TTL; origin errors never cached
181
+ - [ ] Eviction policy and memory ceiling set (an unbounded cache is a memory leak)
182
+ - [ ] Hit rate monitored — a cache nobody measures is an assumption, and a low hit rate is pure overhead
183
+ - [ ] Nothing cached whose staleness is a correctness bug (balances, permissions, inventory at checkout)
184
+
108
185
  ## Measurement Commands
109
186
 
110
187
  ### INP field data and DevTools workflow
@@ -146,6 +223,12 @@ onINP(({ value, attribution }) => {
146
223
  | N+1 queries | Linear DB load growth | Use joins, includes, or batch loading |
147
224
  | Unbounded queries | Memory exhaustion, timeouts | Always paginate, add LIMIT |
148
225
  | Missing indexes | Slow reads as data grows | Add indexes for filtered/sorted columns |
226
+ | Indexing without reading the plan | Write cost paid, read gain unproven | `EXPLAIN ANALYZE` before and after; revert if the plan is unchanged |
227
+ | Redundant / unused indexes | Every write pays for them | Audit usage stats, drop what nothing reads |
228
+ | Connection pool per request | Exhausts `max_connections` under load | One pool per process; proxy for serverless |
229
+ | Cache key missing the viewer | One user's data served to another | Key on tenant, viewer, locale, permissions |
230
+ | Unbounded cache | Memory leak wearing an optimization's clothing | Set eviction policy and a memory ceiling |
231
+ | Cache stampede on a hot key | Origin takes full concurrent load at expiry | Coalesce misses, or `stale-while-revalidate` |
149
232
  | Layout thrashing | Jank, dropped frames | Batch DOM reads, then batch writes |
150
233
  | Unoptimized images | Slow LCP, wasted bandwidth | Use WebP, responsive sizes, lazy load |
151
234
  | Large bundles | Slow Time to Interactive | Code split, tree shake, audit deps |
@@ -6,7 +6,7 @@ Consolidated prompt-engineering best practices for authoring instructions that c
6
6
 
7
7
  Three primary audiences:
8
8
 
9
- 1. **Persona authors** writing files under `agents/` — check sections 1-3, 6, 7, 12 before writing.
9
+ 1. **Persona authors** writing files under `.pi/agents/personas/` — check sections 1-3, 6, 7, 12 before writing.
10
10
  2. **Skill authors** writing files under `skills/` — check sections 1, 2, 4, 6.4, 7, 12 before writing.
11
11
  3. **Rule-file authors** writing project rules (CLAUDE.md, AGENTS.md, or supplementary rule files) — check sections 1.4, 2, 9, 11, 12.
12
12
 
@@ -22,7 +22,7 @@ Quick reference for web application security. Use alongside the `security-and-ha
22
22
 
23
23
  Before reaching for controls, spend five minutes thinking like an attacker:
24
24
 
25
- - [ ] Trust boundaries mapped (requests, uploads, webhooks, third-party APIs, LLM output)
25
+ - [ ] Trust boundaries mapped (requests, uploads, webhooks, third-party APIs, LLM output, and local values written by processes you don't control)
26
26
  - [ ] Assets named (credentials, PII, payment data, admin actions, money movement)
27
27
  - [ ] STRIDE run per boundary (Spoofing, Tampering, Repudiation, Info disclosure, DoS, Elevation)
28
28
  - [ ] Abuse cases written next to use cases ("how would I misuse this?")
@@ -63,6 +63,46 @@ Before reaching for controls, spend five minutes thinking like an attacker:
63
63
  - [ ] HTML output encoded (use framework auto-escaping)
64
64
  - [ ] URLs validated before redirect (prevent open redirect)
65
65
  - [ ] Server-side URL fetches allowlisted; private/reserved IPs blocked (prevent SSRF)
66
+ - [ ] Destructive path operations (delete/move/overwrite): symlinks resolved, allowlisted root, minimum depth, ownership evidence read before the call
67
+
68
+ ### Destructive Path Operations
69
+
70
+ Containment for a target named by data. Resolve first, then decide — and treat the
71
+ result as a candidate, not as authorization:
72
+
73
+ ```typescript
74
+ import { realpath, readFile } from 'node:fs/promises';
75
+ import { resolve, relative, isAbsolute, join, sep } from 'node:path';
76
+
77
+ const ALLOWED_ROOTS = ['/var/lib/myapp/sessions']; // an allowlist, not a pattern
78
+ const MIN_DEPTH = 1; // so a root is never the target
79
+
80
+ async function resolveDeletable(candidate: string, expectedOwner: string) {
81
+ const target = await realpath(resolve(candidate)); // symlinks resolved BEFORE the check
82
+ const inRoot = ALLOWED_ROOTS.some((root) => {
83
+ const rel = relative(root, target);
84
+ // `rel === '..'` / `'../'` only — a plain `startsWith('..')` would also
85
+ // reject a legitimate child named `..cache`.
86
+ if (rel === '' || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) return false;
87
+ return rel.split(sep).length >= MIN_DEPTH;
88
+ });
89
+ if (!inRoot) throw new Error(`refusing: outside allowed roots (${target})`);
90
+
91
+ const owner = await readFile(join(target, '.owner'), 'utf8').catch(() => null);
92
+ if (owner?.trim() !== expectedOwner) throw new Error(`refusing: unproven owner (${target})`);
93
+ return target;
94
+ }
95
+ ```
96
+
97
+ What this does not do, and must be said where the snippet is copied from:
98
+
99
+ - **The marker is self-attestation.** Anything that can write inside the root can write
100
+ `.owner`. `expectedOwner` has to come from authenticated state, and the marker needs
101
+ integrity protection (restrictive ownership, or a MAC) before it is authorization
102
+ rather than a consistency check against a misderived target.
103
+ - **Returning a path leaves a check/use race.** Where an untrusted process can swap an
104
+ ancestor between the check and the call, operate on a descriptor with no-follow,
105
+ beneath-the-root semantics, or guarantee the hierarchy is immutable for the duration.
66
106
 
67
107
  ## Security Headers
68
108
 
@@ -101,24 +141,50 @@ cors({ origin: '*' }) // Allows any origin
101
141
 
102
142
  ## Dependency Security
103
143
 
104
- ```bash
105
- # Audit dependencies
106
- npm audit
107
-
108
- # Fix automatically where possible
109
- npm audit fix
110
-
111
- # Check for critical vulnerabilities
112
- npm audit --audit-level=critical
144
+ First locate the **installation boundary**. If the package is matched by a parent `workspaces` declaration, use that workspace root; otherwise use the nearest project root that owns both its manifest and dependency graph. At that boundary, corroborate `packageManager` (when present), the lockfile, and CI commands. Stop if they disagree or competing manager lockfiles exist there. A nested project is independent only when it is outside the parent workspace; independent subprojects may legitimately use different managers.
113
145
 
114
- # Keep dependencies updated
115
- npx npm-check-updates
116
- ```
117
-
118
- **Supply-chain hygiene** (`npm audit` won't catch malicious packages):
119
- - [ ] Lockfile committed; CI installs with `npm ci` (not `npm install`)
120
- - [ ] New dependencies reviewed (maintenance, downloads, `postinstall` scripts)
121
- - [ ] No typosquats (`cross-env` vs `crossenv`, `react-dom` vs `reactdom`)
146
+ | Manager/version signal | Frozen/immutable CI install | Known-advisory audit |
147
+ |---|---|---|
148
+ | npm (`package-lock.json` or `npm-shrinkwrap.json`) | `npm ci` | `npm audit` |
149
+ | pnpm | `pnpm install --frozen-lockfile` | `pnpm audit` |
150
+ | Yarn 2+ | `yarn install --immutable` | `yarn npm audit -A -R` |
151
+ | Yarn 1 | `yarn install --frozen-lockfile` | `yarn audit` |
152
+
153
+ For an unlisted manager or version, consult its official documentation; do not substitute another manager's commands or newer defaults.
154
+
155
+ ### Install-Script Gate
156
+
157
+ Never discover dependency lifecycle scripts by first executing an ordinary install on a client whose defaults have not been verified.
158
+
159
+ 1. Bootstrap with dependency scripts disabled, or with a documented default-deny policy plus fail-closed enforcement.
160
+ 2. Inspect the exact script source and package version before approval.
161
+ 3. Record the narrowest native allow/deny policy at the installation boundary and commit it.
162
+ 4. Run a clean frozen/immutable install with that policy and verify the required packages still build.
163
+
164
+ **Point-in-time snapshot:** Package-manager defaults and command names change quickly. Verify this matrix against the pinned client's current official documentation before relying on it.
165
+
166
+ | Manager version | Native policy |
167
+ |---|---|
168
+ | npm without verified granular approvals | Bootstrap with `npm ci --ignore-scripts`, or persist `ignore-scripts=true` when project-wide blocking is intended. Keep scripts disabled or deliberately upgrade before allowing any reviewed dependency script. |
169
+ | npm 11.18.x (verified on 11.18.0) | Unreviewed dependency scripts run with a warning by default. Enforce `strict-allow-scripts=true` before a normal install, then use the workspace-unaware `npm install-scripts ls` from the installation boundary; keep approvals version-pinned and denials name-wide. |
170
+ | npm 12.x (verified on 12.0.1) | Unreviewed dependency scripts are skipped by default; `strict-allow-scripts=true` makes their presence fail the install before execution. Use the same `npm install-scripts` review and approval flow. |
171
+ | pnpm 11+ | Use `pnpm approve-builds` and commit `allowBuilds` decisions; `strictDepBuilds` defaults to `true`, so unreviewed builds fail. |
172
+ | pnpm 10.26–10.x | Configure `allowBuilds` explicitly, or use `pnpm approve-builds` with the legacy `onlyBuiltDependencies` / `ignoredBuiltDependencies` lists. Set `strictDepBuilds: true`; its v10 default is `false`. |
173
+ | pnpm 10.1–10.25 | `pnpm approve-builds` records the legacy lists; enable `strictDepBuilds` where supported (10.3+). |
174
+ | Older or unknown pnpm | Bootstrap with `pnpm install --frozen-lockfile --ignore-scripts`. Keep scripts disabled unless the pinned version documents an enforceable policy. |
175
+ | Yarn 4.14+ | Dependency postinstalls are disabled by default. Grant only required exceptions with top-level `dependenciesMeta.<package>.built: true`. |
176
+ | Yarn 2–4.13 | Set `enableScripts: false` in `.yarnrc.yml`, then grant only required exceptions with top-level `dependenciesMeta.<package>.built: true`; do not enable scripts globally. |
177
+ | Yarn 1 | Bootstrap with `yarn install --ignore-scripts`; keep scripts disabled unless each required exception is reviewed under the pinned client's documented workflow. |
178
+
179
+ Authoritative checks: [npm install-scripts](https://docs.npmjs.com/cli/v11/commands/npm-install-scripts/), [install policy](https://docs.npmjs.com/cli/v11/commands/npm-install/), and [CLI releases](https://github.com/npm/cli/releases); [pnpm approve-builds](https://pnpm.io/cli/approve-builds) and [build settings](https://pnpm.io/settings#allowbuilds); [Yarn security](https://yarnpkg.com/features/security) and [manifest](https://yarnpkg.com/configuration/manifest#dependenciesMeta).
180
+
181
+ **Supply-chain hygiene** (advisory audits do not catch newly malicious packages):
182
+ - [ ] Exactly one authoritative lockfile per project/workspace root is committed and CI never rewrites it
183
+ - [ ] Critical/high findings are triaged for reachability; deferrals have a reason and review date
184
+ - [ ] Forced audit remediation (`npm audit fix --force` or equivalent) is never automatic; remediation diffs and changelogs are reviewed
185
+ - [ ] Registry signatures/provenance are verified where the manager supports it
186
+ - [ ] Dependency lifecycle scripts are blocked before first execution and approved only through the pinned manager's native policy
187
+ - [ ] New dependencies are reviewed for ownership, maintenance, release age, provenance, transitive graph, and typosquatting
122
188
 
123
189
  ## AI / LLM Security
124
190
 
@@ -155,7 +221,7 @@ res.status(500).json({
155
221
  | 3 | Injection | Parameterized queries, input validation |
156
222
  | 4 | Insecure Design | Threat modeling, spec-driven development |
157
223
  | 5 | Security Misconfiguration | Security headers, minimal permissions, audit deps |
158
- | 6 | Vulnerable Components | `npm audit`, keep deps updated, minimal deps |
224
+ | 6 | Vulnerable Components | The ecosystem's dependency audit (`npm audit`, `pip-audit`, ...), keep deps updated, minimal deps |
159
225
  | 7 | Auth Failures | Strong passwords, rate limiting, session management |
160
226
  | 8 | Data Integrity Failures | Verify updates/dependencies, signed artifacts |
161
227
  | 9 | Logging Failures | Log security events, don't log secrets |
@@ -1,6 +1,6 @@
1
- # Testing Patterns Reference
1
+ # Testing Patterns Reference (JavaScript/TypeScript)
2
2
 
3
- Quick reference for common testing patterns across the stack. Use alongside the `test-driven-development` skill.
3
+ Quick reference of JavaScript/TypeScript testing patterns — Jest, React Testing Library, Supertest, and Playwright — illustrating the universal principles from the `test-driven-development` skill. The principles (Arrange-Act-Assert, naming, mock discipline, anti-patterns) apply in any ecosystem; the syntax and tooling shown here are JS/TS-specific. In another stack, follow the same principles with the repository's own test framework and commands.
4
4
 
5
5
  ## Table of Contents
6
6
 
@@ -202,23 +202,22 @@ import { test, expect } from '@playwright/test';
202
202
  test('user can create and complete a task', async ({ page }) => {
203
203
  // Navigate and authenticate
204
204
  await page.goto('/');
205
- await page.fill('[name="email"]', 'test@example.com');
206
- await page.fill('[name="password"]', 'testpass123');
207
- await page.click('button:has-text("Log in")');
205
+ await page.getByRole('textbox', { name: /email/i }).fill('test@example.com');
206
+ await page.getByLabel(/password/i).fill('testpass123');
207
+ await page.getByRole('button', { name: /log in/i }).click();
208
208
 
209
209
  // Create a task
210
- await page.click('button:has-text("New Task")');
211
- await page.fill('[name="title"]', 'Buy groceries');
212
- await page.click('button:has-text("Create")');
210
+ await page.getByRole('button', { name: /new task/i }).click();
211
+ await page.getByRole('textbox', { name: /title/i }).fill('Buy groceries');
212
+ await page.getByRole('button', { name: /create/i }).click();
213
213
 
214
214
  // Verify task appears
215
- await expect(page.locator('text=Buy groceries')).toBeVisible();
215
+ const task = page.getByRole('listitem', { name: /buy groceries/i });
216
+ await expect(task).toBeVisible();
216
217
 
217
218
  // Complete the task
218
- await page.click('[aria-label="Complete Buy groceries"]');
219
- await expect(page.locator('text=Buy groceries')).toHaveCSS(
220
- 'text-decoration-line', 'line-through'
221
- );
219
+ await task.getByRole('checkbox', { name: /complete buy groceries/i }).check();
220
+ await expect(task).toHaveCSS('text-decoration-line', 'line-through');
222
221
  });
223
222
  ```
224
223
 
@@ -19,7 +19,7 @@ just flow <name> [args] [--allow-dirty] [--run-id <id>] [--dry-run]
19
19
  The equivalent raw entry point is:
20
20
 
21
21
  ```text
22
- node --experimental-strip-types scripts/flow.ts <name> [args]
22
+ node --experimental-strip-types .pi/agent-fleet/scripts/flow.ts <name> [args]
23
23
  ```
24
24
 
25
25
  The script loads the repository `.env` without replacing variables already present in `process.env`.
@@ -230,7 +230,7 @@ Workflow name breaks exact score ties.
230
230
  The selected workflow is copied in full.
231
231
  The phase docstring block is replaced and workflow/preflight symbols are renamed from the source identity to the unique camel-cased identity derived from the new file name.
232
232
  For `wf-plan-build-review.ts`, the required entry is `planBuildReviewWorkflow` (and optional `planBuildReviewWorkflowPreflight`).
233
- Built-in flows are listed in `scripts/flow.ts`; for a non-built-in name, the dispatcher discovers `wf-<name>.ts` on demand by this exact export convention. A successful draft is therefore immediately reachable through `just flow <name>` without editing the built-in map.
233
+ Built-in flows are listed in `.pi/agent-fleet/scripts/flow.ts`; for a non-built-in name, the dispatcher discovers `wf-<name>.ts` on demand by this exact export convention. A successful draft is therefore immediately reachable through `just flow <name>` without editing the built-in map.
234
234
  The generator never overwrites an existing workflow.
235
235
 
236
236
  Generated TODOs are limited to actual judgment:
@@ -248,7 +248,7 @@ A successful handoff names both the generated file and copied source.
248
248
 
249
249
  ## Scoped TypeScript
250
250
 
251
- `scripts/workflows/tsconfig.json` includes only workflow production TypeScript.
251
+ `.pi/agent-fleet/scripts/workflows/tsconfig.json` includes only workflow production TypeScript.
252
252
  Workflow imports of hub seams cross typed dynamic boundaries so the compiler does not absorb the hub program.
253
253
  Tests remain checked by Node's runtime test execution rather than expanding the scoped project.
254
254
  The project emits nothing.
@@ -257,12 +257,12 @@ No typecheck failure requires edits under `.pi/harnesses/**`.
257
257
  The canonical command is:
258
258
 
259
259
  ```text
260
- npx tsc -p scripts/workflows/tsconfig.json --noEmit
260
+ npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit
261
261
  ```
262
262
 
263
263
  ## Package and install surface
264
264
 
265
- The npm package includes `scripts/flow.ts`, `scripts/lib/flow-command.ts`, `scripts/workflows/*.ts`, `scripts/workflows/lib/*.ts`, and the scoped tsconfig.
265
+ The npm package includes `.pi/agent-fleet/scripts/flow.ts`, `.pi/agent-fleet/scripts/lib/flow-command.ts`, `.pi/agent-fleet/scripts/workflows/*.ts`, `.pi/agent-fleet/scripts/workflows/lib/*.ts`, and the scoped tsconfig.
266
266
  It also includes the complete `skills/` and `references/` trees. The installer maps the workflow guide to `.pi/agent-fleet/docs/workflows.md`, so the drafting skill, generator, authoring reference, and managed guide are packaged without adding product documentation to the target repository's `docs/` tree.
267
267
  The install manifest is generated from `manifest-meta.json` and the repository tree.
268
268
  Workflow runtime files use preserved repository-relative paths because the justfile recipe imports them there.
@@ -289,6 +289,16 @@ Part of code review is dependency review:
289
289
 
290
290
  **Rule:** Prefer standard library and existing utilities over new dependencies. Every dependency is a liability.
291
291
 
292
+ **Upgrading an existing dependency** is a code change like any other, and the riskiest upgrades are the ones merged in bulk with a message like "bump deps." Review them with the same discipline:
293
+
294
+ 1. **Read the changelog, not just the version number.** Semver is a promise the maintainer may not have kept — a "patch" can carry a behavioral change. For a major bump, read the migration notes and find what breaks.
295
+ 2. **One dependency per change.** Upgrade and merge them individually (or in small related groups). When a bulk bump breaks the build, you've lost which package did it; a single-package change makes the cause obvious and the revert clean.
296
+ 3. **Let the tests decide.** The upgrade is verified by a green suite before *and* after, not by "it installed." If coverage around the dependency's behavior is thin, that gap is the real finding — add a test first.
297
+ 4. **Mind the transitive graph.** Most installed packages are ones nobody chose directly. Review the lockfile diff, not just `package.json`; a single direct bump can pull in dozens of indirect changes.
298
+ 5. **Keep the lockfile honest.** Commit it, review its diff, and never hand-edit it. The lockfile is the thing that actually pins what ships.
299
+
300
+ For triaging `npm audit` findings and supply-chain risk (typosquatting, compromised maintainers), follow the `security-and-hardening` skill — this section covers the upgrade *workflow*, that one covers the security verdict.
301
+
292
302
  ## The Review Checklist
293
303
 
294
304
  ```markdown
@@ -338,8 +348,8 @@ Part of code review is dependency review:
338
348
  ```
339
349
  ## See Also
340
350
 
341
- - For detailed security review guidance, see `references/security-checklist.md`
342
- - For performance review checks, see `references/performance-checklist.md`
351
+ - For detailed security review guidance, see `../../references/security-checklist.md`
352
+ - For performance review checks, see `../../references/performance-checklist.md`
343
353
 
344
354
  ## Common Rationalizations
345
355
 
@@ -352,6 +362,8 @@ Part of code review is dependency review:
352
362
  | "The tests pass, so it's good" | Tests are necessary but not sufficient. They don't catch architecture problems, security issues, or readability concerns. |
353
363
  | "The refactor makes it cleaner" | Relocating complexity isn't reducing it. If the reader still holds the same number of concepts, the structure didn't improve — look for the version where branches disappear. |
354
364
  | "It's only a small addition to this file" | Small diffs still push files past a healthy size and bolt branches onto unrelated flows. Judge the resulting structure, not the diff size. |
365
+ | "It's just a version bump" | A bump is a behavior change you didn't write. Read the changelog; semver doesn't guarantee no breakage. |
366
+ | "I'll upgrade everything in one PR to save time" | A bulk bump that breaks the build hides which package did it. One dependency per change keeps the cause and the revert clean. |
355
367
 
356
368
  ## Red Flags
357
369
 
@@ -367,6 +379,8 @@ Part of code review is dependency review:
367
379
  - A change that grows an already-large file instead of decomposing it
368
380
  - New conditionals scattered into unrelated code paths (a missing abstraction)
369
381
  - A bespoke helper that duplicates an existing canonical one, or feature logic placed in a shared module
382
+ - A bulk "bump dependencies" PR with no changelog review and no per-package isolation
383
+ - A lockfile change that's hand-edited, uncommitted, or merged without reviewing its diff
370
384
 
371
385
  ## Verification
372
386
 
@@ -377,5 +391,6 @@ After review is complete:
377
391
  - [ ] Tests pass
378
392
  - [ ] Build succeeds
379
393
  - [ ] The verification story is documented (what changed, how it was verified)
394
+ - [ ] Dependency upgrades were reviewed against their changelog, isolated per package, and verified by a green suite with the lockfile diff reviewed
380
395
 
381
396
  **Presumptive blockers:** surface and propose the simpler design for each of these; escalate to Required only when the change actively makes structure worse: a refactor that relocates complexity instead of reducing it; a change that pushes a file past the size boundary with no decomposition; feature logic added to a shared module; a near-duplicate of an existing canonical helper; a silent fallback that hides an unclear invariant.