@chankov/agent-fleet 1.0.4 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (476) hide show
  1. package/.pi/harnesses/agent-hub/README.md +57 -66
  2. package/.pi/harnesses/agent-hub/capability-packs.ts +4 -4
  3. package/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  4. package/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  5. package/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  6. package/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  7. package/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  8. package/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  9. package/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  10. package/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  11. package/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  12. package/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  13. package/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  14. package/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  15. package/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  16. package/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  17. package/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  18. package/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  19. package/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  20. package/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  21. package/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  22. package/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  23. package/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  24. package/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  25. package/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  26. package/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  27. package/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  28. package/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  29. package/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  30. package/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  31. package/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  32. package/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  33. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  34. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  35. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  36. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  37. package/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  38. package/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  39. package/.pi/harnesses/agent-hub/drift-watchdog.js +3 -3
  40. package/.pi/harnesses/agent-hub/footer.ts +3 -9
  41. package/.pi/harnesses/agent-hub/helpers.ts +2 -2
  42. package/.pi/harnesses/agent-hub/index.ts +1324 -9645
  43. package/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  44. package/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  45. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  46. package/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  47. package/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  48. package/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  51. package/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  52. package/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  53. package/.pi/harnesses/agent-hub/presentation.ts +48 -0
  54. package/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  55. package/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  56. package/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  57. package/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  58. package/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  59. package/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  60. package/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  61. package/.pi/harnesses/agent-hub/session-start.ts +42 -0
  62. package/.pi/harnesses/agent-hub/timeline.ts +54 -0
  63. package/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  64. package/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  65. package/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  66. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  67. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  68. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  69. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  70. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  71. package/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  72. package/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  73. package/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  74. package/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  75. package/.pi/harnesses/agent-hub/types.ts +60 -0
  76. package/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  77. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  78. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  79. package/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  80. package/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  81. package/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  82. package/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  83. package/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  84. package/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  85. package/.pi/harnesses/agent-hub/{posture.ts → work-mode.ts} +36 -27
  86. package/.pi/harnesses/coms/index.ts +139 -1630
  87. package/.pi/harnesses/coms/package.json +1 -1
  88. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  89. package/.pi/harnesses/lib/coms-core-io.ts +385 -0
  90. package/.pi/harnesses/lib/coms-core.ts +577 -0
  91. package/.pi/harnesses/lib/context-budget-hub-prompt.ts +3 -5
  92. package/.versions/2.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  93. package/.versions/2.0.0/.pi/agents/model-profiles.yaml +27 -0
  94. package/.versions/2.0.0/.pi/agents/peers.yaml +142 -0
  95. package/.versions/2.0.0/.pi/agents/teams.yaml +41 -0
  96. package/.versions/2.0.0/.pi/damage-control-rules.yaml +297 -0
  97. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  98. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  99. package/.versions/2.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  100. package/.versions/2.0.0/.pi/extensions/btw/README.md +120 -0
  101. package/.versions/2.0.0/.pi/extensions/btw/index.ts +914 -0
  102. package/.versions/2.0.0/.pi/extensions/btw/package.json +6 -0
  103. package/.versions/2.0.0/.pi/extensions/btw/state.js +179 -0
  104. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  105. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  106. package/.versions/2.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  107. package/.versions/2.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  108. package/.versions/2.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  109. package/.versions/2.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  110. package/.versions/2.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  111. package/.versions/2.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  112. package/.versions/2.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  113. package/.versions/2.0.0/.pi/extensions/package-lock.json +1175 -0
  114. package/.versions/2.0.0/.pi/extensions/package.json +9 -0
  115. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  116. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  117. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  118. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  119. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  120. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  121. package/.versions/2.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  122. package/.versions/2.0.0/.pi/harnesses/agent-hub/README.md +1161 -0
  123. package/.versions/2.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  124. package/.versions/2.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  125. package/.versions/2.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  126. package/.versions/2.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  127. package/.versions/2.0.0/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  128. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  129. package/.versions/2.0.0/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  130. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  131. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  132. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  133. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  134. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  135. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  136. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  137. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  138. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  139. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  140. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  141. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  142. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  143. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  144. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/context.ts +39 -0
  145. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  146. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  147. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  148. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  149. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  150. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  151. package/.versions/2.0.0/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  152. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/agents.ts +171 -0
  153. package/.versions/2.0.0/.pi/harnesses/agent-hub/config/overrides.ts +118 -0
  154. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  155. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +211 -0
  156. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/budgets.ts +208 -0
  157. package/.versions/2.0.0/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  158. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  159. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  160. package/.versions/2.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  161. package/.versions/2.0.0/.pi/harnesses/agent-hub/delegate.ts +446 -0
  162. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-coms.ts +232 -0
  163. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  164. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-complete.ts +135 -0
  165. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +153 -0
  166. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +191 -0
  167. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native-types.ts +207 -0
  168. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-native.ts +184 -0
  169. package/.versions/2.0.0/.pi/harnesses/agent-hub/dispatch-observability.ts +220 -0
  170. package/.versions/2.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  171. package/.versions/2.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  172. package/.versions/2.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  173. package/.versions/2.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  174. package/.versions/2.0.0/.pi/harnesses/agent-hub/fixtures/registration-surface.json +53 -0
  175. package/.versions/2.0.0/.pi/harnesses/agent-hub/footer.ts +30 -0
  176. package/.versions/2.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  177. package/.versions/2.0.0/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  178. package/.versions/2.0.0/.pi/harnesses/agent-hub/index.ts +1850 -0
  179. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  180. package/.versions/2.0.0/.pi/harnesses/agent-hub/input/shortcuts.ts +47 -0
  181. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  182. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  183. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +139 -0
  184. package/.versions/2.0.0/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +95 -0
  185. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  186. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  187. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  188. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  189. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  190. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  191. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  192. package/.versions/2.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  193. package/.versions/2.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  194. package/.versions/2.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  195. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/models.ts +126 -0
  196. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/roster.ts +79 -0
  197. package/.versions/2.0.0/.pi/harnesses/agent-hub/policy/work-mode.ts +118 -0
  198. package/.versions/2.0.0/.pi/harnesses/agent-hub/presentation.ts +48 -0
  199. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/context.ts +46 -0
  200. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  201. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/session-start.ts +88 -0
  202. package/.versions/2.0.0/.pi/harnesses/agent-hub/prompts/system-prompt.ts +110 -0
  203. package/.versions/2.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  204. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/controls.ts +75 -0
  205. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/runtime.ts +184 -0
  206. package/.versions/2.0.0/.pi/harnesses/agent-hub/research/spawn-run.ts +146 -0
  207. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  208. package/.versions/2.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  209. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  210. package/.versions/2.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  211. package/.versions/2.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  212. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-budget.js +537 -0
  213. package/.versions/2.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  214. package/.versions/2.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  215. package/.versions/2.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  216. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  217. package/.versions/2.0.0/.pi/harnesses/agent-hub/session-start.ts +42 -0
  218. package/.versions/2.0.0/.pi/harnesses/agent-hub/spawn.ts +388 -0
  219. package/.versions/2.0.0/.pi/harnesses/agent-hub/timeline.ts +54 -0
  220. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/action-executors.ts +146 -0
  221. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  222. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/context.ts +132 -0
  223. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +79 -0
  224. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +200 -0
  225. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  226. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/fleet-tools.ts +202 -0
  227. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/herdr-executors.ts +82 -0
  228. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  229. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  230. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  231. package/.versions/2.0.0/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  232. package/.versions/2.0.0/.pi/harnesses/agent-hub/types.ts +60 -0
  233. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  234. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/detail-panel.ts +175 -0
  235. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +130 -0
  236. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/grid.ts +306 -0
  237. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  238. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  239. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  240. package/.versions/2.0.0/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  241. package/.versions/2.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  242. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  243. package/.versions/2.0.0/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  244. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  245. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/index.ts +532 -0
  246. package/.versions/2.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  247. package/.versions/2.0.0/.pi/harnesses/coms/README.md +100 -0
  248. package/.versions/2.0.0/.pi/harnesses/coms/index.ts +276 -0
  249. package/.versions/2.0.0/.pi/harnesses/coms/package.json +7 -0
  250. package/.versions/2.0.0/.pi/harnesses/coms/version.ts +42 -0
  251. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  252. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  253. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  254. package/.versions/2.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  255. package/.versions/2.0.0/.pi/harnesses/lib/coms-core-io.ts +385 -0
  256. package/.versions/2.0.0/.pi/harnesses/lib/coms-core.ts +577 -0
  257. package/.versions/2.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  258. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  259. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  260. package/.versions/2.0.0/.pi/harnesses/lib/context-budget-view.ts +107 -0
  261. package/.versions/2.0.0/.pi/harnesses/lib/context-budget.ts +114 -0
  262. package/.versions/2.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  263. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  264. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  265. package/.versions/2.0.0/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  266. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  267. package/.versions/2.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  268. package/.versions/2.0.0/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  269. package/.versions/2.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  270. package/.versions/2.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  271. package/.versions/2.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  272. package/.versions/2.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  273. package/.versions/2.0.0/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  274. package/.versions/2.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  275. package/.versions/2.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  276. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  277. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  278. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  279. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  280. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  281. package/.versions/2.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  282. package/.versions/2.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  283. package/.versions/2.0.0/.pi/harnesses/package-lock.json +2039 -0
  284. package/.versions/2.0.0/.pi/harnesses/package.json +10 -0
  285. package/.versions/2.0.0/.pi/prompts/af-build.md +24 -0
  286. package/.versions/2.0.0/.pi/prompts/af-code-simplify.md +22 -0
  287. package/.versions/2.0.0/.pi/prompts/af-plan.md +17 -0
  288. package/.versions/2.0.0/.pi/prompts/af-review.md +16 -0
  289. package/.versions/2.0.0/.pi/prompts/af-set-hermes-telegram.md +15 -0
  290. package/.versions/2.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  291. package/.versions/2.0.0/.pi/prompts/af-ship.md +17 -0
  292. package/.versions/2.0.0/.pi/prompts/af-spec.md +15 -0
  293. package/.versions/2.0.0/.pi/prompts/af-test.md +19 -0
  294. package/.versions/2.0.0/.pi/skills/bowser/SKILL.md +145 -0
  295. package/.versions/2.0.0/.version +1 -0
  296. package/.versions/2.0.0/agents/architect.md +25 -0
  297. package/.versions/2.0.0/agents/bowser.md +28 -0
  298. package/.versions/2.0.0/agents/builder.md +56 -0
  299. package/.versions/2.0.0/agents/code-reviewer.md +209 -0
  300. package/.versions/2.0.0/agents/deep-researcher.md +33 -0
  301. package/.versions/2.0.0/agents/documenter.md +19 -0
  302. package/.versions/2.0.0/agents/orchestrator.md +23 -0
  303. package/.versions/2.0.0/agents/plan-reviewer.md +84 -0
  304. package/.versions/2.0.0/agents/planner.md +71 -0
  305. package/.versions/2.0.0/agents/releaser.md +25 -0
  306. package/.versions/2.0.0/agents/researcher.md +29 -0
  307. package/.versions/2.0.0/agents/security-auditor.md +168 -0
  308. package/.versions/2.0.0/agents/test-engineer.md +154 -0
  309. package/.versions/2.0.0/agents/web-debugger.md +44 -0
  310. package/.versions/2.0.0/agents/web-performance-auditor.md +194 -0
  311. package/.versions/2.0.0/bin/catalog/harness-runtime-closure.json +38 -0
  312. package/.versions/2.0.0/codex/CONDUCTOR.md +148 -0
  313. package/.versions/2.0.0/docs/ARCHITECTURE.md +404 -0
  314. package/.versions/2.0.0/docs/agent-fleet-setup.md +468 -0
  315. package/.versions/2.0.0/docs/claude-code-coms-bridge.md +128 -0
  316. package/.versions/2.0.0/docs/codex-remote-conductor.md +170 -0
  317. package/.versions/2.0.0/docs/coms-hermes-bridge.md +189 -0
  318. package/.versions/2.0.0/docs/getting-started.md +98 -0
  319. package/.versions/2.0.0/docs/npm-install.md +292 -0
  320. package/.versions/2.0.0/docs/pi-extensions.md +439 -0
  321. package/.versions/2.0.0/docs/pi-setup.md +74 -0
  322. package/.versions/2.0.0/docs/skill-anatomy.md +150 -0
  323. package/.versions/2.0.0/hermes/README.md +347 -0
  324. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  325. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  326. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  327. package/.versions/2.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  328. package/.versions/2.0.0/hermes/gates/gate-o-capability.md +8 -0
  329. package/.versions/2.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  330. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  331. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  332. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  333. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  334. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  335. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  336. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  337. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  338. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  339. package/.versions/2.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  340. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  341. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  342. package/.versions/2.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  343. package/.versions/2.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  344. package/.versions/2.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  345. package/.versions/2.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  346. package/.versions/2.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  347. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  348. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  349. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  350. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  351. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  352. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  353. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  354. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  355. package/.versions/2.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  356. package/.versions/2.0.0/hermes/watchdog-tests/__init__.py +0 -0
  357. package/.versions/2.0.0/hooks/coms-stop-hook.mjs +84 -0
  358. package/.versions/2.0.0/install-manifest.json +2745 -0
  359. package/.versions/2.0.0/justfile +272 -0
  360. package/.versions/2.0.0/manifest-meta.json +882 -0
  361. package/.versions/2.0.0/references/accessibility-checklist.md +160 -0
  362. package/.versions/2.0.0/references/definition-of-done.md +67 -0
  363. package/.versions/2.0.0/references/fleet-coordination-patterns.md +151 -0
  364. package/.versions/2.0.0/references/observability-checklist.md +91 -0
  365. package/.versions/2.0.0/references/orchestration-patterns.md +370 -0
  366. package/.versions/2.0.0/references/performance-checklist.md +153 -0
  367. package/.versions/2.0.0/references/prompting-patterns.md +380 -0
  368. package/.versions/2.0.0/references/security-checklist.md +179 -0
  369. package/.versions/2.0.0/references/testing-patterns.md +236 -0
  370. package/.versions/2.0.0/scripts/codex-conductor.ts +41 -0
  371. package/.versions/2.0.0/scripts/codex-remote-control.ts +167 -0
  372. package/.versions/2.0.0/scripts/coms-claude-bridge.ts +411 -0
  373. package/.versions/2.0.0/scripts/coms-cli.ts +484 -0
  374. package/.versions/2.0.0/scripts/coms-hermes-bridge.ts +413 -0
  375. package/.versions/2.0.0/scripts/fleet.ts +185 -0
  376. package/.versions/2.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  377. package/.versions/2.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  378. package/.versions/2.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  379. package/.versions/2.0.0/scripts/install-hermes-plugin.sh +180 -0
  380. package/.versions/2.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  381. package/.versions/2.0.0/scripts/lib/codex-conductor.ts +88 -0
  382. package/.versions/2.0.0/scripts/lib/codex-remote-control.ts +480 -0
  383. package/.versions/2.0.0/scripts/lib/coms-envelope.ts +582 -0
  384. package/.versions/2.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  385. package/.versions/2.0.0/scripts/lib/fleet-command.ts +270 -0
  386. package/.versions/2.0.0/scripts/lib/herdr-layout.ts +281 -0
  387. package/.versions/2.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  388. package/.versions/2.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  389. package/.versions/2.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  390. package/.versions/2.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  391. package/.versions/2.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  392. package/.versions/2.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  393. package/.versions/2.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  394. package/.versions/2.0.0/scripts/lib/monitor-env.ts +146 -0
  395. package/.versions/2.0.0/scripts/lib/peer-launch.ts +318 -0
  396. package/.versions/2.0.0/scripts/lib/persona-banner.ts +62 -0
  397. package/.versions/2.0.0/scripts/lib/spawn-stagger.ts +101 -0
  398. package/.versions/2.0.0/scripts/lib/team-project.ts +213 -0
  399. package/.versions/2.0.0/scripts/lib/team-snapshot.ts +147 -0
  400. package/.versions/2.0.0/scripts/peer-banner.ts +40 -0
  401. package/.versions/2.0.0/scripts/peer-launch.ts +259 -0
  402. package/.versions/2.0.0/scripts/team-snapshot.ts +237 -0
  403. package/.versions/2.0.0/scripts/team-up.ts +406 -0
  404. package/.versions/2.0.0/skills/_internal/grilling.md +59 -0
  405. package/.versions/2.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  406. package/.versions/2.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  407. package/.versions/2.0.0/skills/compound-learning/SKILL.md +137 -0
  408. package/.versions/2.0.0/skills/context-engineering/SKILL.md +291 -0
  409. package/.versions/2.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  410. package/.versions/2.0.0/skills/designing-agents/SKILL.md +394 -0
  411. package/.versions/2.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  412. package/.versions/2.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  413. package/.versions/2.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  414. package/.versions/2.0.0/skills/idea-refine/SKILL.md +182 -0
  415. package/.versions/2.0.0/skills/idea-refine/examples.md +238 -0
  416. package/.versions/2.0.0/skills/idea-refine/frameworks.md +99 -0
  417. package/.versions/2.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  418. package/.versions/2.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  419. package/.versions/2.0.0/skills/incremental-implementation/SKILL.md +298 -0
  420. package/.versions/2.0.0/skills/interview-me/SKILL.md +226 -0
  421. package/.versions/2.0.0/skills/orchestration-verification/SKILL.md +181 -0
  422. package/.versions/2.0.0/skills/peer-coms/SKILL.md +90 -0
  423. package/.versions/2.0.0/skills/performance-optimization/SKILL.md +350 -0
  424. package/.versions/2.0.0/skills/planning-and-task-breakdown/SKILL.md +263 -0
  425. package/.versions/2.0.0/skills/security-and-hardening/SKILL.md +461 -0
  426. package/.versions/2.0.0/skills/spec-driven-development/SKILL.md +256 -0
  427. package/.versions/2.0.0/skills/using-agent-skills/SKILL.md +197 -0
  428. package/.versions/2.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  429. package/.versions/2.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  430. package/.versions/2.0.0/vendor/agent-skills-upstream/README.md +11 -0
  431. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  432. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  433. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  434. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  435. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  436. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  437. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  438. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  439. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  440. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  441. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  442. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  443. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  444. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  445. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  446. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  447. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  448. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  449. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  450. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  451. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  452. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  453. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  454. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  455. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  456. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  457. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  458. package/.versions/2.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  459. package/CHANGELOG.md +33 -0
  460. package/README.md +5 -5
  461. package/agents/orchestrator.md +3 -1
  462. package/bin/lib/overrides.js +2 -0
  463. package/bin/lib/validate-overrides.js +1 -1
  464. package/docs/ARCHITECTURE.md +42 -13
  465. package/docs/MIGRATION-agent-fleet.md +4 -4
  466. package/docs/agent-fleet-setup.md +15 -15
  467. package/docs/npm-install.md +1 -1
  468. package/docs/pi-extensions.md +16 -18
  469. package/install-manifest.json +1 -1
  470. package/justfile +2 -2
  471. package/package.json +3 -2
  472. package/scripts/fleet.ts +10 -10
  473. package/scripts/lib/fleet-command.ts +15 -11
  474. package/scripts/lib/team-project.ts +2 -2
  475. package/scripts/team-up.ts +10 -10
  476. package/.pi/harnesses/agent-hub/execution-profile.ts +0 -69
@@ -0,0 +1,87 @@
1
+ // Immutable per-run artifact namespaces — the pure policy core behind "a run's
2
+ // artifacts are never overwritten by the next run".
3
+ //
4
+ // The observed failure: `.pi/agent-sessions/artifacts/` was deleted at session
5
+ // start, and specialist returns were named by a per-session counter
6
+ // (`returns/builder-run1.md`). Two consequences, both hit at once: a later
7
+ // session's `builder-run1.md` occupied the same path as an earlier one, and the
8
+ // start-of-session wipe removed eleven implementation returns and two review
9
+ // artifacts that a post-mortem then had to record as NOT RECOVERABLE.
10
+ //
11
+ // The fix is not retention-by-luck: each session archives the previous session's
12
+ // artifacts into `runs/<runId>/`, a namespace that is written once and never
13
+ // reused, and records it in `runs/index.json`. Pruning is explicit and bounded,
14
+ // so the directory cannot grow without limit either.
15
+
16
+ export const DEFAULT_RUN_HISTORY_KEEP = 10;
17
+ export const RUNS_DIRNAME = "runs";
18
+ export const RUN_INDEX_FILENAME = "index.json";
19
+
20
+ /**
21
+ * Run id: sortable UTC timestamp + a short random suffix, so two sessions
22
+ * starting in the same second still get distinct namespaces.
23
+ * `2026-08-03T09-10-42-a3f9`
24
+ */
25
+ export function makeRunId(date = new Date(), suffix = null) {
26
+ const iso = new Date(date).toISOString().replace(/\.\d+Z$/, "").replace(/:/g, "-");
27
+ const tail = suffix ?? Math.random().toString(36).slice(2, 6);
28
+ return `${iso}-${tail}`;
29
+ }
30
+
31
+ /** A run id we generated (used to filter stray directories out of `runs/`). */
32
+ export function isRunId(name) {
33
+ return /^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-[a-z0-9]{2,8}$/.test(String(name || ""));
34
+ }
35
+
36
+ /**
37
+ * Which run directories to delete so at most `keep` survive.
38
+ * Run ids sort lexicographically by time, so newest = last. `keep: null`
39
+ * ("off") prunes nothing; non-run-id entries are never touched.
40
+ */
41
+ export function pruneRunDirs(names, keep = DEFAULT_RUN_HISTORY_KEEP) {
42
+ if (keep == null) return [];
43
+ const runs = (names || []).filter(isRunId).sort();
44
+ const limit = Math.max(0, keep);
45
+ if (runs.length <= limit) return [];
46
+ return runs.slice(0, runs.length - limit);
47
+ }
48
+
49
+ /**
50
+ * The metadata written once into `runs/<runId>/meta.json`. Carries the
51
+ * identifiers a post-mortem needs and could not previously recover: which
52
+ * workspace/project/repo the run belonged to, and when it started and ended.
53
+ */
54
+ export function buildRunMeta({ runId, startedAt = null, archivedAt = Date.now(), cwd = null, project = null, workspace = null, artifactCounts = null }) {
55
+ return {
56
+ runId,
57
+ startedAt: startedAt == null ? null : new Date(startedAt).toISOString(),
58
+ archivedAt: new Date(archivedAt).toISOString(),
59
+ cwd,
60
+ project,
61
+ workspace,
62
+ artifactCounts,
63
+ note: "Immutable archive of one agent-hub session's artifacts. Written once; never rewritten.",
64
+ };
65
+ }
66
+
67
+ /**
68
+ * Fold a run entry into `runs/index.json`, newest last, capped at `keep`.
69
+ * Re-indexing the same runId replaces its entry rather than duplicating it.
70
+ */
71
+ export function appendRunIndex(existing, entry, keep = DEFAULT_RUN_HISTORY_KEEP) {
72
+ const runs = Array.isArray(existing?.runs) ? existing.runs.filter((r) => r && r.runId !== entry.runId) : [];
73
+ runs.push(entry);
74
+ runs.sort((a, b) => String(a.runId).localeCompare(String(b.runId)));
75
+ const trimmed = keep == null ? runs : runs.slice(Math.max(0, runs.length - Math.max(0, keep)));
76
+ return { version: 1, updatedAt: new Date().toISOString(), runs: trimmed };
77
+ }
78
+
79
+ /** Parse the `run-history-keep:` overrides value → number, null ("off"), or undefined. */
80
+ export function normalizeRunHistoryKeep(value) {
81
+ const raw = String(value ?? "").trim().toLowerCase();
82
+ if (!raw) return undefined;
83
+ if (raw === "off" || raw === "none" || raw === "0") return null;
84
+ const n = Number(raw);
85
+ if (!Number.isFinite(n) || n < 1) return undefined;
86
+ return Math.floor(n);
87
+ }
@@ -0,0 +1,22 @@
1
+ import { existsSync } from "node:fs";
2
+ import { join, resolve } from "node:path";
3
+
4
+ const CONTINUE_ENTRY = /damage-control-continue[/\\]index\.ts$/;
5
+ const MISSING_SAFETY_ERROR = "damage-control-continue harness not found — guarded child dispatch refused";
6
+
7
+ /** Resolve only the surviving continue harness; never downgrade to an unguarded or hard-stop child. */
8
+ export function resolveSafetyHarness(cwd: string, argv: string[] = process.argv): string | null {
9
+ for (let i = 0; i < argv.length - 1; i++) {
10
+ if (argv[i] !== "-e" && argv[i] !== "--extension") continue;
11
+ const candidate = resolve(argv[i + 1]);
12
+ if (CONTINUE_ENTRY.test(candidate) && existsSync(candidate)) return candidate;
13
+ }
14
+ const local = join(cwd, ".pi", "harnesses", "damage-control-continue", "index.ts");
15
+ return existsSync(local) ? local : null;
16
+ }
17
+
18
+ export function requireSafetyHarness(path: string | null):
19
+ | { ok: true; extensions: string[] }
20
+ | { ok: false; error: string } {
21
+ return path ? { ok: true, extensions: [path] } : { ok: false, error: MISSING_SAFETY_ERROR };
22
+ }
@@ -0,0 +1,103 @@
1
+ import { execFileSync } from "node:child_process";
2
+
3
+ export function snapshotWorktree(cwd) {
4
+ const status = gitStatus(cwd);
5
+ if (status.skipped) return { skipped: true, reason: status.reason, paths: new Set() };
6
+ return { skipped: false, paths: new Set(status.paths) };
7
+ }
8
+
9
+ export function diffAgainst(snapshot, cwd) {
10
+ const current = snapshotWorktree(cwd);
11
+ if (snapshot?.skipped || current.skipped) {
12
+ return { skipped: true, reason: snapshot?.reason || current.reason || "scope gate skipped", paths: [] };
13
+ }
14
+ const before = snapshot?.paths instanceof Set ? snapshot.paths : new Set(snapshot?.paths || []);
15
+ const paths = [...current.paths].filter((p) => !before.has(p)).sort();
16
+ return { skipped: false, paths };
17
+ }
18
+
19
+ export function checkScope(changedPaths, scopeGlobs) {
20
+ const scopes = (scopeGlobs || []).map(normalizePath).filter(Boolean);
21
+ const inScope = [];
22
+ const outOfScope = [];
23
+ for (const rawPath of changedPaths || []) {
24
+ const changed = normalizePath(rawPath);
25
+ if (!changed) continue;
26
+ if (scopes.some((scope) => matchesScope(changed, scope))) inScope.push(changed);
27
+ else outOfScope.push(changed);
28
+ }
29
+ return { inScope: uniqueSorted(inScope), outOfScope: uniqueSorted(outOfScope) };
30
+ }
31
+
32
+ function gitStatus(cwd) {
33
+ try {
34
+ const output = execFileSync("git", ["-C", cwd, "status", "--porcelain", "--untracked-files=all"], {
35
+ encoding: "utf-8",
36
+ stdio: ["ignore", "pipe", "pipe"],
37
+ });
38
+ return { skipped: false, paths: parsePorcelain(output) };
39
+ } catch (err) {
40
+ return { skipped: true, reason: err?.message || "not a git worktree" };
41
+ }
42
+ }
43
+
44
+ function parsePorcelain(output) {
45
+ const paths = [];
46
+ for (const line of String(output || "").split(/\r?\n/)) {
47
+ if (!line.trim()) continue;
48
+ let file = line.slice(3).trim();
49
+ const rename = file.match(/ -> (.+)$/);
50
+ if (rename) file = rename[1];
51
+ paths.push(normalizePath(unquotePorcelainPath(file)));
52
+ }
53
+ return uniqueSorted(paths.filter(Boolean));
54
+ }
55
+
56
+ function matchesScope(changedPath, scope) {
57
+ if (hasGlob(scope)) return globToRegExp(scope).test(changedPath);
58
+ const dir = scope.endsWith("/") ? scope.slice(0, -1) : scope;
59
+ return changedPath === dir || changedPath.startsWith(`${dir}/`);
60
+ }
61
+
62
+ function hasGlob(scope) {
63
+ return /[*?]/.test(scope);
64
+ }
65
+
66
+ function globToRegExp(glob) {
67
+ let out = "^";
68
+ for (let i = 0; i < glob.length; i++) {
69
+ const c = glob[i];
70
+ if (c === "*") {
71
+ if (glob[i + 1] === "*") {
72
+ out += ".*";
73
+ i++;
74
+ } else {
75
+ out += "[^/]*";
76
+ }
77
+ } else {
78
+ out += escapeRegExp(c);
79
+ }
80
+ }
81
+ out += "$";
82
+ return new RegExp(out);
83
+ }
84
+
85
+ function normalizePath(value) {
86
+ return String(value || "").trim().replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+/g, "/");
87
+ }
88
+
89
+ function uniqueSorted(values) {
90
+ return [...new Set(values)].sort();
91
+ }
92
+
93
+ function unquotePorcelainPath(value) {
94
+ const trimmed = String(value || "").trim();
95
+ if (trimmed.length >= 2 && trimmed.startsWith('"') && trimmed.endsWith('"')) {
96
+ try { return JSON.parse(trimmed); } catch { return trimmed.slice(1, -1); }
97
+ }
98
+ return trimmed;
99
+ }
100
+
101
+ function escapeRegExp(value) {
102
+ return value.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
103
+ }
@@ -0,0 +1,110 @@
1
+ // Session-file health — the pure policy behind never handing pi a session file
2
+ // it will refuse. `spawnPiAgent` passes `--session <file>` on every run, so one
3
+ // corrupt `<agentKey>.json` bricks a persona for the rest of the session: every
4
+ // dispatch dies in ~1s with an empty result, and drop + re-add does not help
5
+ // because the file survives the roster change.
6
+ //
7
+ // A pi session file is JSONL whose FIRST record is the header
8
+ // `{"type":"session","version":N,...}`. Both files that pi rejected in the
9
+ // field (`builder.json.corrupt-*`, `builder.json.invalid-gate-p`) start with a
10
+ // `{"type":"message",...}` record instead — they were truncated at the head, so
11
+ // the conversation begins mid-chain. That single check separates them from the
12
+ // session files that were healthy but retired for other reasons.
13
+
14
+ export const SESSION_HEADER_TYPE = "session";
15
+
16
+ /**
17
+ * Would pi accept this session file body? Returns `{ ok, reason }`; `reason` is
18
+ * null when ok, and a human-readable cause otherwise (it reaches the dispatcher
19
+ * verbatim, so it must explain what happened, not just that something did).
20
+ */
21
+ export function isUsablePiSession(text) {
22
+ const body = String(text ?? "");
23
+ if (!body.trim()) return { ok: false, reason: "session file is empty" };
24
+
25
+ const firstLine = body.split(/\r?\n/).find((line) => line.trim());
26
+ let header;
27
+ try {
28
+ header = JSON.parse(firstLine);
29
+ } catch {
30
+ return { ok: false, reason: "first record is not valid JSON — the file is truncated or not a pi session" };
31
+ }
32
+ if (!header || typeof header !== "object" || Array.isArray(header)) {
33
+ return { ok: false, reason: "first record is not a JSON object" };
34
+ }
35
+ if (header.type !== SESSION_HEADER_TYPE) {
36
+ return {
37
+ ok: false,
38
+ reason: `first record is "${header.type ?? "(no type)"}", not a "${SESSION_HEADER_TYPE}" header — ` +
39
+ "the file was truncated at the head and the conversation starts mid-chain",
40
+ };
41
+ }
42
+ return { ok: true, reason: null };
43
+ }
44
+
45
+ /** `builder.json` → `builder.json.corrupt-2026-07-25T09-14-02-123Z` (no colons: portable filename). */
46
+ export function quarantineName(file, now = new Date()) {
47
+ const stamp = new Date(now).toISOString().replace(/[:.]/g, "-");
48
+ return `${file}.corrupt-${stamp}`;
49
+ }
50
+
51
+ /**
52
+ * The observed post-hoc signature of a session file pi rejects: it exits
53
+ * non-zero having produced no output at all, and says so on stderr. Validation
54
+ * cannot catch every reason pi refuses a file, so this is the second net — and
55
+ * the run never started, which is what makes a retry safe.
56
+ */
57
+ export function isCorruptSessionExit({ code, output, stderr } = {}) {
58
+ if (code === 0 || code == null) return false;
59
+ if (String(output ?? "").trim()) return false;
60
+ return /not a valid pi session|invalid pi session/i.test(String(stderr ?? ""));
61
+ }
62
+
63
+ /**
64
+ * Unconditionally quarantine a file that pi itself rejected. This is distinct
65
+ * from `quarantineIfUnusable`: the local header check may consider the file
66
+ * healthy even though pi applies a stricter invariant. A clean retry is allowed
67
+ * only after the rejected path has actually been moved aside.
68
+ */
69
+ export function forceQuarantineSession(file, io) {
70
+ if (!io.existsSync(file)) return { ok: true, quarantined: null, error: null };
71
+ const target = quarantineName(file, io.now ? io.now() : new Date());
72
+ try {
73
+ io.renameSync(file, target);
74
+ return { ok: true, quarantined: target, error: null };
75
+ } catch (err) {
76
+ return {
77
+ ok: false,
78
+ quarantined: null,
79
+ error: `could not quarantine pi-rejected session: ${err instanceof Error ? err.message : String(err)}`,
80
+ };
81
+ }
82
+ }
83
+
84
+ /**
85
+ * Check `file` and move it aside when pi would reject it. `io` supplies the fs
86
+ * calls (`existsSync`, `readFileSync`, `renameSync`) and an optional `now`.
87
+ * Returns `{ usable, quarantined, reason }` — `quarantined` is the path the bad
88
+ * file was moved to, so the caller can name it for the human.
89
+ */
90
+ export function quarantineIfUnusable(file, io) {
91
+ if (!io.existsSync(file)) return { usable: false, quarantined: null, reason: null };
92
+
93
+ let verdict;
94
+ try {
95
+ verdict = isUsablePiSession(io.readFileSync(file, "utf-8"));
96
+ } catch (err) {
97
+ verdict = { ok: false, reason: `session file unreadable: ${err instanceof Error ? err.message : String(err)}` };
98
+ }
99
+ if (verdict.ok) return { usable: true, quarantined: null, reason: null };
100
+
101
+ const target = quarantineName(file, io.now ? io.now() : new Date());
102
+ try {
103
+ io.renameSync(file, target);
104
+ return { usable: false, quarantined: target, reason: verdict.reason };
105
+ } catch {
106
+ // Could not move it aside — still refuse to resume it. Starting clean
107
+ // overwrites the bad file, which is the outcome we want anyway.
108
+ return { usable: false, quarantined: null, reason: verdict.reason };
109
+ }
110
+ }
@@ -0,0 +1,42 @@
1
+ import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
2
+
3
+ export const SESSION_START_STEP_ORDER = [
4
+ "resetSession",
5
+ "restartMonitor",
6
+ "initializeComs",
7
+ "initializeExemptions",
8
+ "loadAgents",
9
+ "applyOverrides",
10
+ "restoreRoster",
11
+ "resolveCapabilities",
12
+ "notifyStartup",
13
+ "updateWidget",
14
+ "installFooter",
15
+ ] as const;
16
+
17
+ export type SessionStartStep = (typeof SESSION_START_STEP_ORDER)[number];
18
+
19
+ export type SessionStartContext = ExtensionContext;
20
+
21
+ export type SessionStartDependencies = {
22
+ [K in SessionStartStep]: (ctx: SessionStartContext) => void | Promise<void>;
23
+ };
24
+
25
+ function assertSessionStartDependencies(deps: SessionStartDependencies): void {
26
+ for (const name of SESSION_START_STEP_ORDER) {
27
+ if (typeof deps[name] !== "function") {
28
+ throw new TypeError(`session_start dependency "${name}" must be a function`);
29
+ }
30
+ }
31
+ }
32
+
33
+ export async function runSessionStart(ctx: SessionStartContext, deps: SessionStartDependencies): Promise<void> {
34
+ assertSessionStartDependencies(deps);
35
+ for (const name of SESSION_START_STEP_ORDER) await deps[name](ctx);
36
+ }
37
+
38
+ /** Register the lifecycle hook while keeping all mutable Hub state composition-owned. */
39
+ export function registerSessionStart(pi: ExtensionAPI, deps: SessionStartDependencies): void {
40
+ assertSessionStartDependencies(deps);
41
+ pi.on("session_start", async (_event, ctx) => runSessionStart(ctx, deps));
42
+ }