@chankov/agent-fleet 2.2.2 → 2.2.3

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 (766) hide show
  1. package/.pi/harnesses/agent-hub/README.md +18 -2
  2. package/.pi/harnesses/agent-hub/budget-recovery.ts +28 -0
  3. package/.pi/harnesses/agent-hub/commands/recover.ts +28 -9
  4. package/.pi/harnesses/agent-hub/context/assertion-journal.ts +133 -0
  5. package/.pi/harnesses/agent-hub/index.ts +100 -17
  6. package/.pi/harnesses/agent-hub/no-progress.ts +133 -19
  7. package/.pi/harnesses/agent-hub/operator-current-state.ts +51 -6
  8. package/.pi/harnesses/agent-hub/package.json +1 -1
  9. package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -1
  10. package/.pi/harnesses/agent-hub/process-obligations.ts +1 -1
  11. package/.pi/harnesses/agent-hub/recover-policy.ts +1 -1
  12. package/.pi/harnesses/agent-hub/recover-state.ts +46 -6
  13. package/.pi/harnesses/agent-hub/recovery-continuation.ts +134 -0
  14. package/.pi/harnesses/agent-hub/tools/action-executors.ts +24 -3
  15. package/.pi/harnesses/agent-hub/tools/context.ts +2 -0
  16. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +60 -17
  17. package/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +2 -1
  18. package/.pi/harnesses/agent-hub/tools/recover-task.ts +16 -0
  19. package/.pi/harnesses/agent-hub/verification-diagnostics.ts +23 -0
  20. package/.pi/harnesses/agent-hub/work-mode.ts +4 -2
  21. package/.pi/harnesses/coms/package.json +1 -1
  22. package/.pi/harnesses/damage-control-continue/index.ts +7 -5
  23. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  24. package/.pi/harnesses/lib/bash-policy-analysis.ts +9 -1
  25. package/.pi/harnesses/lib/exact-permission-port.ts +6 -4
  26. package/.versions/2.2.3/.pi/agent-fleet/hermes/README.md +347 -0
  27. package/.versions/2.2.3/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  28. package/.versions/2.2.3/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  29. package/.versions/2.2.3/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  30. package/.versions/2.2.3/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  31. package/.versions/2.2.3/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  32. package/.versions/2.2.3/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  33. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  34. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  35. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  36. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  37. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  38. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  39. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  40. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  41. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  42. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  43. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  44. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  45. package/.versions/2.2.3/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  46. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  47. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  48. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  49. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  50. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  51. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  52. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  53. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  54. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  55. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  56. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  57. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  58. package/.versions/2.2.3/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  59. package/.versions/2.2.3/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  60. package/.versions/2.2.3/.pi/agent-fleet/hooks/coms-stop-hook.mjs +124 -0
  61. package/.versions/2.2.3/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  62. package/.versions/2.2.3/.pi/agent-fleet/scripts/coms-claude-bridge.ts +440 -0
  63. package/.versions/2.2.3/.pi/agent-fleet/scripts/coms-cli.ts +430 -0
  64. package/.versions/2.2.3/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +416 -0
  65. package/.versions/2.2.3/.pi/agent-fleet/scripts/exec-at-target.ts +10 -0
  66. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/0.167-shared.json +1900 -0
  67. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/README.md +223 -0
  68. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/assessment.md +83 -0
  69. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile-0.167.json +5627 -0
  70. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap-profile.md +43 -0
  71. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/bootstrap.md +45 -0
  72. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture-profile.ts +53 -0
  73. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/capture.ts +102 -0
  74. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/catalog.md +91 -0
  75. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/channel.md +21 -0
  76. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurement.md +133 -0
  77. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/measurements.json +74 -0
  78. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/notification-profile-0.167.json +2679 -0
  79. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/observer.md +101 -0
  80. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/opaque-response.md +57 -0
  81. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/open-sent.md +68 -0
  82. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/probe-reader.md +51 -0
  83. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/profile.md +71 -0
  84. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/projection.md +147 -0
  85. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/reconnect.md +40 -0
  86. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/response-unions.md +74 -0
  87. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/semver.md +124 -0
  88. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/codex-notification-contracts/surface.md +73 -0
  89. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/fleet-codex-allowlist-store-child.ts +31 -0
  90. package/.versions/2.2.3/.pi/agent-fleet/scripts/fixtures/response-fixture.ts +23 -0
  91. package/.versions/2.2.3/.pi/agent-fleet/scripts/fleet-codex-local-mcp.mjs +26 -0
  92. package/.versions/2.2.3/.pi/agent-fleet/scripts/fleet-codex-local-mcp.ts +63 -0
  93. package/.versions/2.2.3/.pi/agent-fleet/scripts/fleet.ts +244 -0
  94. package/.versions/2.2.3/.pi/agent-fleet/scripts/flow.ts +166 -0
  95. package/.versions/2.2.3/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  96. package/.versions/2.2.3/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  97. package/.versions/2.2.3/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  98. package/.versions/2.2.3/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  99. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  100. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-bootstrap-files.ts +46 -0
  101. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-bootstrap-probe.ts +52 -0
  102. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-bootstrap-producer.ts +131 -0
  103. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-connection-history.ts +51 -0
  104. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-daemon-observer.ts +137 -0
  105. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-desktop-discovery.ts +84 -0
  106. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-desktop-preflight.ts +130 -0
  107. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-desktop-queue-host.ts +113 -0
  108. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-measurement.ts +218 -0
  109. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-native-presence.ts +61 -0
  110. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-probe-transcript.ts +135 -0
  111. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-send-lineage.ts +72 -0
  112. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/codex-unix-queue-rpc.ts +101 -0
  113. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  114. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  115. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist-store.ts +453 -0
  116. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-allowlist.ts +175 -0
  117. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-answer-transport.ts +73 -0
  118. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-answers.ts +74 -0
  119. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-bootstrap.ts +207 -0
  120. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-connections.ts +76 -0
  121. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-event-reply.ts +58 -0
  122. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-event-runtime.ts +132 -0
  123. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-store.ts +428 -0
  124. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-instruction-transport.ts +160 -0
  125. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-instructions.ts +175 -0
  126. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-local-mcp.ts +435 -0
  127. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-native-history.ts +215 -0
  128. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-observation-store.ts +208 -0
  129. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-observe-transport.ts +49 -0
  130. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-observe.ts +93 -0
  131. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-overview.ts +52 -0
  132. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-permission-transport.ts +44 -0
  133. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-permissions.ts +83 -0
  134. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-readonly.ts +213 -0
  135. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-relay-latency.ts +45 -0
  136. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-response-read.ts +26 -0
  137. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-response-transport.ts +38 -0
  138. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-codex-resync.ts +212 -0
  139. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/fleet-command.ts +264 -0
  140. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/flow-command.ts +107 -0
  141. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +239 -0
  142. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  143. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  144. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  145. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  146. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  147. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  148. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  149. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  150. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  151. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  152. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/peer-target.ts +1 -0
  153. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  154. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  155. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/resource-closure.js +1 -0
  156. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  157. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/session-launch.ts +56 -0
  158. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  159. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/team-project.ts +176 -0
  160. package/.versions/2.2.3/.pi/agent-fleet/scripts/lib/team-snapshot.ts +160 -0
  161. package/.versions/2.2.3/.pi/agent-fleet/scripts/package-lock.json +57 -0
  162. package/.versions/2.2.3/.pi/agent-fleet/scripts/package.json +10 -0
  163. package/.versions/2.2.3/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  164. package/.versions/2.2.3/.pi/agent-fleet/scripts/peer-launch.ts +289 -0
  165. package/.versions/2.2.3/.pi/agent-fleet/scripts/pi-session.ts +9 -0
  166. package/.versions/2.2.3/.pi/agent-fleet/scripts/team-snapshot.ts +245 -0
  167. package/.versions/2.2.3/.pi/agent-fleet/scripts/team-up.ts +378 -0
  168. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +181 -0
  169. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  170. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  171. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/env.ts +36 -0
  172. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  173. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  174. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/git.ts +108 -0
  175. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +130 -0
  176. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  177. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  178. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  179. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +137 -0
  180. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  181. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  182. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +37 -0
  183. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/quality.ts +78 -0
  184. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/run.ts +109 -0
  185. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  186. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/trace.ts +52 -0
  187. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  188. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/writer-lease-race.worker.mjs +36 -0
  189. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +148 -0
  190. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  191. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  192. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  193. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  194. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  195. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  196. package/.versions/2.2.3/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  197. package/.versions/2.2.3/.pi/agents/dispatch-policy.yaml +32 -0
  198. package/.versions/2.2.3/.pi/agents/model-profiles.yaml +132 -0
  199. package/.versions/2.2.3/.pi/agents/peers.yaml +147 -0
  200. package/.versions/2.2.3/.pi/agents/teams.yaml +41 -0
  201. package/.versions/2.2.3/.pi/agents/voices.yaml +13 -0
  202. package/.versions/2.2.3/.pi/damage-control-rules.yaml +297 -0
  203. package/.versions/2.2.3/.pi/extensions/btw/README.md +120 -0
  204. package/.versions/2.2.3/.pi/extensions/btw/index.ts +916 -0
  205. package/.versions/2.2.3/.pi/extensions/btw/package.json +6 -0
  206. package/.versions/2.2.3/.pi/extensions/btw/state.js +179 -0
  207. package/.versions/2.2.3/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  208. package/.versions/2.2.3/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  209. package/.versions/2.2.3/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  210. package/.versions/2.2.3/.pi/extensions/compact-and-continue/README.md +42 -0
  211. package/.versions/2.2.3/.pi/extensions/compact-and-continue/index.ts +136 -0
  212. package/.versions/2.2.3/.pi/extensions/compact-and-continue/package.json +6 -0
  213. package/.versions/2.2.3/.pi/extensions/mcp-bridge/README.md +46 -0
  214. package/.versions/2.2.3/.pi/extensions/mcp-bridge/index.ts +206 -0
  215. package/.versions/2.2.3/.pi/extensions/mcp-bridge/package.json +6 -0
  216. package/.versions/2.2.3/.pi/extensions/package-lock.json +1175 -0
  217. package/.versions/2.2.3/.pi/extensions/package.json +9 -0
  218. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/README.md +224 -0
  219. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/config.ts +199 -0
  220. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  221. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/index.ts +248 -0
  222. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/package.json +6 -0
  223. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  224. package/.versions/2.2.3/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  225. package/.versions/2.2.3/.pi/harnesses/agent-hub/README.md +1657 -0
  226. package/.versions/2.2.3/.pi/harnesses/agent-hub/acceptance.ts +204 -0
  227. package/.versions/2.2.3/.pi/harnesses/agent-hub/access-approval.ts +266 -0
  228. package/.versions/2.2.3/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  229. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  230. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  231. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-hub.ts +55 -0
  232. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  233. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  234. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  235. package/.versions/2.2.3/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  236. package/.versions/2.2.3/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  237. package/.versions/2.2.3/.pi/harnesses/agent-hub/artifacts.js +146 -0
  238. package/.versions/2.2.3/.pi/harnesses/agent-hub/assertion-ledger.js +68 -0
  239. package/.versions/2.2.3/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  240. package/.versions/2.2.3/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  241. package/.versions/2.2.3/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  242. package/.versions/2.2.3/.pi/harnesses/agent-hub/budget-recovery.ts +151 -0
  243. package/.versions/2.2.3/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  244. package/.versions/2.2.3/.pi/harnesses/agent-hub/capability-packs.ts +187 -0
  245. package/.versions/2.2.3/.pi/harnesses/agent-hub/codex-bootstrap.ts +117 -0
  246. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  247. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  248. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  249. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  250. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  251. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  252. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  253. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  254. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  255. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  256. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  257. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  258. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  259. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  260. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/config.ts +9 -0
  261. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  262. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  263. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  264. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  265. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  266. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  267. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  268. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  269. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/recover.ts +81 -0
  270. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  271. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  272. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  273. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  274. package/.versions/2.2.3/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  275. package/.versions/2.2.3/.pi/harnesses/agent-hub/config/agents.ts +183 -0
  276. package/.versions/2.2.3/.pi/harnesses/agent-hub/config/model-profiles.ts +240 -0
  277. package/.versions/2.2.3/.pi/harnesses/agent-hub/config/overrides.ts +166 -0
  278. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  279. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/assertion-journal.ts +133 -0
  280. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +234 -0
  281. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  282. package/.versions/2.2.3/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  283. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  284. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  285. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  286. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  287. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  288. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-broker.ts +44 -0
  289. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  290. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-client.ts +22 -0
  291. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-compat.ts +45 -0
  292. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-owners.ts +17 -0
  293. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  294. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  295. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  296. package/.versions/2.2.3/.pi/harnesses/agent-hub/context-window.js +108 -0
  297. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-approval.ts +83 -0
  298. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  299. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  300. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  301. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-hub.ts +263 -0
  302. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  303. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-owners.ts +59 -0
  304. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  305. package/.versions/2.2.3/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  306. package/.versions/2.2.3/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  307. package/.versions/2.2.3/.pi/harnesses/agent-hub/delegate.ts +478 -0
  308. package/.versions/2.2.3/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  309. package/.versions/2.2.3/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  310. package/.versions/2.2.3/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  311. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-coms.ts +258 -0
  312. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  313. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native-complete.ts +176 -0
  314. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +318 -0
  315. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +264 -0
  316. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native-types.ts +297 -0
  317. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-native.ts +242 -0
  318. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  319. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  320. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  321. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  322. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  323. package/.versions/2.2.3/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  324. package/.versions/2.2.3/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  325. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  326. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  327. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  328. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  329. package/.versions/2.2.3/.pi/harnesses/agent-hub/drift-watchdog.js +344 -0
  330. package/.versions/2.2.3/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  331. package/.versions/2.2.3/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  332. package/.versions/2.2.3/.pi/harnesses/agent-hub/execution-evidence.ts +96 -0
  333. package/.versions/2.2.3/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  334. package/.versions/2.2.3/.pi/harnesses/agent-hub/external-blocker.js +92 -0
  335. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  336. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  337. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  338. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  339. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  340. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  341. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  342. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  343. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/hub.ts +170 -0
  344. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  345. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  346. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/owners.ts +100 -0
  347. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  348. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  349. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  350. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  351. package/.versions/2.2.3/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  352. package/.versions/2.2.3/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  353. package/.versions/2.2.3/.pi/harnesses/agent-hub/fixtures/registration-surface.json +69 -0
  354. package/.versions/2.2.3/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  355. package/.versions/2.2.3/.pi/harnesses/agent-hub/footer.ts +29 -0
  356. package/.versions/2.2.3/.pi/harnesses/agent-hub/helpers.ts +269 -0
  357. package/.versions/2.2.3/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  358. package/.versions/2.2.3/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  359. package/.versions/2.2.3/.pi/harnesses/agent-hub/index.ts +2805 -0
  360. package/.versions/2.2.3/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  361. package/.versions/2.2.3/.pi/harnesses/agent-hub/input/shortcuts.ts +16 -0
  362. package/.versions/2.2.3/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  363. package/.versions/2.2.3/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  364. package/.versions/2.2.3/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  365. package/.versions/2.2.3/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +90 -0
  366. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  367. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  368. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  369. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  370. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  371. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  372. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  373. package/.versions/2.2.3/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  374. package/.versions/2.2.3/.pi/harnesses/agent-hub/no-progress.ts +741 -0
  375. package/.versions/2.2.3/.pi/harnesses/agent-hub/operator-current-state.ts +102 -0
  376. package/.versions/2.2.3/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  377. package/.versions/2.2.3/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  378. package/.versions/2.2.3/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  379. package/.versions/2.2.3/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  380. package/.versions/2.2.3/.pi/harnesses/agent-hub/package.json +7 -0
  381. package/.versions/2.2.3/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  382. package/.versions/2.2.3/.pi/harnesses/agent-hub/permission-channel.ts +87 -0
  383. package/.versions/2.2.3/.pi/harnesses/agent-hub/permission-relay.ts +84 -0
  384. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  385. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  386. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  387. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/roster.ts +103 -0
  388. package/.versions/2.2.3/.pi/harnesses/agent-hub/policy/work-mode.ts +104 -0
  389. package/.versions/2.2.3/.pi/harnesses/agent-hub/poll-command.ts +184 -0
  390. package/.versions/2.2.3/.pi/harnesses/agent-hub/presentation.ts +54 -0
  391. package/.versions/2.2.3/.pi/harnesses/agent-hub/private-config-current-state.ts +81 -0
  392. package/.versions/2.2.3/.pi/harnesses/agent-hub/private-config-fixtures.ts +26 -0
  393. package/.versions/2.2.3/.pi/harnesses/agent-hub/private-config-review.ts +100 -0
  394. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-config.ts +22 -0
  395. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  396. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  397. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  398. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  399. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  400. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  401. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  402. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  403. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  404. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  405. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  406. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-snapshot.ts +287 -0
  407. package/.versions/2.2.3/.pi/harnesses/agent-hub/proactive-types.ts +70 -0
  408. package/.versions/2.2.3/.pi/harnesses/agent-hub/process-obligations.ts +210 -0
  409. package/.versions/2.2.3/.pi/harnesses/agent-hub/prompts/context.ts +72 -0
  410. package/.versions/2.2.3/.pi/harnesses/agent-hub/prompts/fragments.ts +94 -0
  411. package/.versions/2.2.3/.pi/harnesses/agent-hub/prompts/session-start.ts +89 -0
  412. package/.versions/2.2.3/.pi/harnesses/agent-hub/prompts/system-prompt.ts +142 -0
  413. package/.versions/2.2.3/.pi/harnesses/agent-hub/provider-semaphore.js +143 -0
  414. package/.versions/2.2.3/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  415. package/.versions/2.2.3/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  416. package/.versions/2.2.3/.pi/harnesses/agent-hub/recover-state.ts +144 -0
  417. package/.versions/2.2.3/.pi/harnesses/agent-hub/recovery-continuation.ts +134 -0
  418. package/.versions/2.2.3/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  419. package/.versions/2.2.3/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  420. package/.versions/2.2.3/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  421. package/.versions/2.2.3/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  422. package/.versions/2.2.3/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  423. package/.versions/2.2.3/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  424. package/.versions/2.2.3/.pi/harnesses/agent-hub/return-contract.js +371 -0
  425. package/.versions/2.2.3/.pi/harnesses/agent-hub/return-extract.js +77 -0
  426. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  427. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-continuity.ts +76 -0
  428. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-findings.js +96 -0
  429. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-reuse.ts +48 -0
  430. package/.versions/2.2.3/.pi/harnesses/agent-hub/review-verdict.ts +6 -0
  431. package/.versions/2.2.3/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  432. package/.versions/2.2.3/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  433. package/.versions/2.2.3/.pi/harnesses/agent-hub/run-budget.js +362 -0
  434. package/.versions/2.2.3/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  435. package/.versions/2.2.3/.pi/harnesses/agent-hub/runtime-receipts.ts +63 -0
  436. package/.versions/2.2.3/.pi/harnesses/agent-hub/runtime-test-check.ts +85 -0
  437. package/.versions/2.2.3/.pi/harnesses/agent-hub/safety-routing.ts +28 -0
  438. package/.versions/2.2.3/.pi/harnesses/agent-hub/scope-gate.js +271 -0
  439. package/.versions/2.2.3/.pi/harnesses/agent-hub/scope-overlap.ts +46 -0
  440. package/.versions/2.2.3/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  441. package/.versions/2.2.3/.pi/harnesses/agent-hub/session-health.js +110 -0
  442. package/.versions/2.2.3/.pi/harnesses/agent-hub/session-start.ts +42 -0
  443. package/.versions/2.2.3/.pi/harnesses/agent-hub/spawn.ts +702 -0
  444. package/.versions/2.2.3/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  445. package/.versions/2.2.3/.pi/harnesses/agent-hub/specialist-result.ts +78 -0
  446. package/.versions/2.2.3/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  447. package/.versions/2.2.3/.pi/harnesses/agent-hub/system1-communication-store.ts +225 -0
  448. package/.versions/2.2.3/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  449. package/.versions/2.2.3/.pi/harnesses/agent-hub/system1-runtime.ts +271 -0
  450. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-brief.ts +98 -0
  451. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  452. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-resume-contract.ts +80 -0
  453. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-authorization.ts +170 -0
  454. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-config.ts +21 -0
  455. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  456. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  457. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  458. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  459. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  460. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  461. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  462. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-runtime.ts +132 -0
  463. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  464. package/.versions/2.2.3/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  465. package/.versions/2.2.3/.pi/harnesses/agent-hub/timeline.ts +72 -0
  466. package/.versions/2.2.3/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +83 -0
  467. package/.versions/2.2.3/.pi/harnesses/agent-hub/tool-catalog-state.ts +125 -0
  468. package/.versions/2.2.3/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  469. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/action-executors.ts +237 -0
  470. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  471. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  472. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  473. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/context.ts +151 -0
  474. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +93 -0
  475. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +971 -0
  476. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  477. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +23 -0
  478. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/fleet-tools.ts +201 -0
  479. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/herdr-executors.ts +100 -0
  480. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/poll-panel-core.ts +30 -0
  481. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/poll-panel.ts +33 -0
  482. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/recover-task.ts +16 -0
  483. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/run-flow.ts +177 -0
  484. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  485. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  486. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  487. package/.versions/2.2.3/.pi/harnesses/agent-hub/tools/verification-contract.ts +81 -0
  488. package/.versions/2.2.3/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  489. package/.versions/2.2.3/.pi/harnesses/agent-hub/types.ts +66 -0
  490. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  491. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  492. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  493. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  494. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +173 -0
  495. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  496. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  497. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  498. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  499. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  500. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  501. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  502. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  503. package/.versions/2.2.3/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  504. package/.versions/2.2.3/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  505. package/.versions/2.2.3/.pi/harnesses/agent-hub/verification-diagnostics.ts +23 -0
  506. package/.versions/2.2.3/.pi/harnesses/agent-hub/version.ts +42 -0
  507. package/.versions/2.2.3/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  508. package/.versions/2.2.3/.pi/harnesses/agent-hub/work-mode.ts +185 -0
  509. package/.versions/2.2.3/.pi/harnesses/agent-hub/write-isolation.ts +232 -0
  510. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/README.md +59 -0
  511. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/index.ts +571 -0
  512. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/questions.ts +206 -0
  513. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  514. package/.versions/2.2.3/.pi/harnesses/ask-user-remote/runtime-ask.ts +90 -0
  515. package/.versions/2.2.3/.pi/harnesses/coms/README.md +105 -0
  516. package/.versions/2.2.3/.pi/harnesses/coms/index.ts +308 -0
  517. package/.versions/2.2.3/.pi/harnesses/coms/package.json +7 -0
  518. package/.versions/2.2.3/.pi/harnesses/coms/version.ts +42 -0
  519. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/README.md +161 -0
  520. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/index.ts +661 -0
  521. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/package.json +7 -0
  522. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  523. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/system1-child.ts +45 -0
  524. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  525. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  526. package/.versions/2.2.3/.pi/harnesses/damage-control-continue/version.ts +42 -0
  527. package/.versions/2.2.3/.pi/harnesses/lib/approval-wait.ts +17 -0
  528. package/.versions/2.2.3/.pi/harnesses/lib/bash-policy-analysis.ts +193 -0
  529. package/.versions/2.2.3/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  530. package/.versions/2.2.3/.pi/harnesses/lib/clarification-policy.ts +9 -0
  531. package/.versions/2.2.3/.pi/harnesses/lib/codex-compat.ts +97 -0
  532. package/.versions/2.2.3/.pi/harnesses/lib/codex-contract.ts +259 -0
  533. package/.versions/2.2.3/.pi/harnesses/lib/codex-notification-profile.ts +75 -0
  534. package/.versions/2.2.3/.pi/harnesses/lib/coms-core-io.ts +422 -0
  535. package/.versions/2.2.3/.pi/harnesses/lib/coms-core.ts +738 -0
  536. package/.versions/2.2.3/.pi/harnesses/lib/coms-instruction-receipts.ts +113 -0
  537. package/.versions/2.2.3/.pi/harnesses/lib/coms-observation.ts +74 -0
  538. package/.versions/2.2.3/.pi/harnesses/lib/coms-registry-entry.ts +99 -0
  539. package/.versions/2.2.3/.pi/harnesses/lib/coms-response-read.ts +107 -0
  540. package/.versions/2.2.3/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  541. package/.versions/2.2.3/.pi/harnesses/lib/context-budget-hub-prompt.ts +124 -0
  542. package/.versions/2.2.3/.pi/harnesses/lib/context-budget-view.ts +112 -0
  543. package/.versions/2.2.3/.pi/harnesses/lib/context-budget.ts +114 -0
  544. package/.versions/2.2.3/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  545. package/.versions/2.2.3/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  546. package/.versions/2.2.3/.pi/harnesses/lib/damage-auto-policy.ts +52 -0
  547. package/.versions/2.2.3/.pi/harnesses/lib/damage-control-presentation.ts +14 -0
  548. package/.versions/2.2.3/.pi/harnesses/lib/damage-control-shared.ts +276 -0
  549. package/.versions/2.2.3/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  550. package/.versions/2.2.3/.pi/harnesses/lib/damage-policy.ts +35 -0
  551. package/.versions/2.2.3/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  552. package/.versions/2.2.3/.pi/harnesses/lib/damage-result-view.ts +16 -0
  553. package/.versions/2.2.3/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  554. package/.versions/2.2.3/.pi/harnesses/lib/exact-permission-port.ts +40 -0
  555. package/.versions/2.2.3/.pi/harnesses/lib/execution-trace.ts +45 -0
  556. package/.versions/2.2.3/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  557. package/.versions/2.2.3/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  558. package/.versions/2.2.3/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  559. package/.versions/2.2.3/.pi/harnesses/lib/fleet-bootstrap-channel.ts +148 -0
  560. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-catalog.ts +30 -0
  561. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-chat-view.ts +55 -0
  562. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-event-bridge.ts +82 -0
  563. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-namespace.ts +2 -0
  564. package/.versions/2.2.3/.pi/harnesses/lib/fleet-codex-policy-snapshot.ts +10 -0
  565. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/cli-bridge.ts +111 -0
  566. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/mutations.ts +201 -0
  567. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/snapshot.ts +417 -0
  568. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/transition.ts +68 -0
  569. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/ui.ts +269 -0
  570. package/.versions/2.2.3/.pi/harnesses/lib/fleet-config/view.ts +338 -0
  571. package/.versions/2.2.3/.pi/harnesses/lib/fleet-connection-control.ts +94 -0
  572. package/.versions/2.2.3/.pi/harnesses/lib/fleet-connection-diagnostics.ts +7 -0
  573. package/.versions/2.2.3/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  574. package/.versions/2.2.3/.pi/harnesses/lib/fleet-dashboard-view.ts +174 -0
  575. package/.versions/2.2.3/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  576. package/.versions/2.2.3/.pi/harnesses/lib/fleet-event-source.ts +21 -0
  577. package/.versions/2.2.3/.pi/harnesses/lib/fleet-notification-admission.ts +32 -0
  578. package/.versions/2.2.3/.pi/harnesses/lib/fleet-notification-bootstrap.ts +172 -0
  579. package/.versions/2.2.3/.pi/harnesses/lib/fleet-notification-validation.ts +122 -0
  580. package/.versions/2.2.3/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  581. package/.versions/2.2.3/.pi/harnesses/lib/fleet-panel.ts +34 -0
  582. package/.versions/2.2.3/.pi/harnesses/lib/fleet-question-reference.ts +42 -0
  583. package/.versions/2.2.3/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  584. package/.versions/2.2.3/.pi/harnesses/lib/fleet-selection.ts +24 -0
  585. package/.versions/2.2.3/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  586. package/.versions/2.2.3/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  587. package/.versions/2.2.3/.pi/harnesses/lib/fleet-target-identity.ts +9 -0
  588. package/.versions/2.2.3/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  589. package/.versions/2.2.3/.pi/harnesses/lib/herdr-client.ts +472 -0
  590. package/.versions/2.2.3/.pi/harnesses/lib/herdr-presence.ts +399 -0
  591. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  592. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  593. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  594. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  595. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  596. package/.versions/2.2.3/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  597. package/.versions/2.2.3/.pi/harnesses/lib/identical-dialog.ts +27 -0
  598. package/.versions/2.2.3/.pi/harnesses/lib/installation-state.js +62 -0
  599. package/.versions/2.2.3/.pi/harnesses/lib/peer-target.ts +24 -0
  600. package/.versions/2.2.3/.pi/harnesses/lib/policy-roots.js +117 -0
  601. package/.versions/2.2.3/.pi/harnesses/lib/policy-roots.ts +32 -0
  602. package/.versions/2.2.3/.pi/harnesses/lib/process-shared.ts +9 -0
  603. package/.versions/2.2.3/.pi/harnesses/lib/resource-closure.js +26 -0
  604. package/.versions/2.2.3/.pi/harnesses/lib/safe-source-read.js +29 -0
  605. package/.versions/2.2.3/.pi/harnesses/lib/semantic-approval.ts +80 -0
  606. package/.versions/2.2.3/.pi/harnesses/lib/session-target.ts +62 -0
  607. package/.versions/2.2.3/.pi/harnesses/lib/spawned-peers.js +191 -0
  608. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  609. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  610. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  611. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  612. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-json.js +37 -0
  613. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-loader.js +53 -0
  614. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  615. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-triage.js +42 -0
  616. package/.versions/2.2.3/.pi/harnesses/lib/system1/config-v2.js +112 -0
  617. package/.versions/2.2.3/.pi/harnesses/lib/system1/config.js +50 -0
  618. package/.versions/2.2.3/.pi/harnesses/lib/system1/contracts.ts +154 -0
  619. package/.versions/2.2.3/.pi/harnesses/lib/system1/demo.ts +95 -0
  620. package/.versions/2.2.3/.pi/harnesses/lib/system1/jev.ts +503 -0
  621. package/.versions/2.2.3/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  622. package/.versions/2.2.3/.pi/harnesses/lib/system1/selection.js +11 -0
  623. package/.versions/2.2.3/.pi/harnesses/lib/system1/service.ts +245 -0
  624. package/.versions/2.2.3/.pi/harnesses/lib/system1/worktree-scopes.js +110 -0
  625. package/.versions/2.2.3/.pi/harnesses/lib/system1/worktree-scopes.ts +13 -0
  626. package/.versions/2.2.3/.pi/harnesses/lib/system1/worktree-service.ts +24 -0
  627. package/.versions/2.2.3/.pi/harnesses/lib/target-capabilities.js +7 -0
  628. package/.versions/2.2.3/.pi/harnesses/lib/update-check.ts +227 -0
  629. package/.versions/2.2.3/.pi/harnesses/lib/workspace-context.js +115 -0
  630. package/.versions/2.2.3/.pi/harnesses/lib/workspace-context.ts +22 -0
  631. package/.versions/2.2.3/.pi/harnesses/package-lock.json +2121 -0
  632. package/.versions/2.2.3/.pi/harnesses/package.json +13 -0
  633. package/.versions/2.2.3/.pi/prompts/af-build.md +27 -0
  634. package/.versions/2.2.3/.pi/prompts/af-code-simplify.md +22 -0
  635. package/.versions/2.2.3/.pi/prompts/af-constraints.md +31 -0
  636. package/.versions/2.2.3/.pi/prompts/af-plan.md +17 -0
  637. package/.versions/2.2.3/.pi/prompts/af-review.md +16 -0
  638. package/.versions/2.2.3/.pi/prompts/af-set-hermes-telegram.md +15 -0
  639. package/.versions/2.2.3/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  640. package/.versions/2.2.3/.pi/prompts/af-setup-rules.md +20 -0
  641. package/.versions/2.2.3/.pi/prompts/af-ship.md +17 -0
  642. package/.versions/2.2.3/.pi/prompts/af-spec.md +15 -0
  643. package/.versions/2.2.3/.pi/prompts/af-test.md +19 -0
  644. package/.versions/2.2.3/.pi/skills/bowser/SKILL.md +145 -0
  645. package/.versions/2.2.3/.version +1 -0
  646. package/.versions/2.2.3/agents/architect.md +24 -0
  647. package/.versions/2.2.3/agents/bowser.md +28 -0
  648. package/.versions/2.2.3/agents/builder.md +55 -0
  649. package/.versions/2.2.3/agents/code-reviewer.md +209 -0
  650. package/.versions/2.2.3/agents/deep-researcher.md +32 -0
  651. package/.versions/2.2.3/agents/documenter.md +22 -0
  652. package/.versions/2.2.3/agents/plan-reviewer.md +83 -0
  653. package/.versions/2.2.3/agents/planner.md +107 -0
  654. package/.versions/2.2.3/agents/releaser.md +24 -0
  655. package/.versions/2.2.3/agents/researcher.md +30 -0
  656. package/.versions/2.2.3/agents/security-auditor.md +167 -0
  657. package/.versions/2.2.3/agents/test-engineer.md +153 -0
  658. package/.versions/2.2.3/agents/web-debugger.md +44 -0
  659. package/.versions/2.2.3/agents/web-performance-auditor.md +194 -0
  660. package/.versions/2.2.3/bin/catalog/harness-runtime-closure.json +85 -0
  661. package/.versions/2.2.3/docs/ARCHITECTURE.md +1291 -0
  662. package/.versions/2.2.3/docs/agent-fleet-setup.md +1161 -0
  663. package/.versions/2.2.3/docs/claude-code-coms-bridge.md +147 -0
  664. package/.versions/2.2.3/docs/codex-local-mcp.md +520 -0
  665. package/.versions/2.2.3/docs/codex-session-bridge.md +44 -0
  666. package/.versions/2.2.3/docs/codex-setup.md +183 -0
  667. package/.versions/2.2.3/docs/coms-hermes-bridge.md +188 -0
  668. package/.versions/2.2.3/docs/fleet-native-voice.md +151 -0
  669. package/.versions/2.2.3/docs/getting-started.md +126 -0
  670. package/.versions/2.2.3/docs/npm-install.md +535 -0
  671. package/.versions/2.2.3/docs/pi-extensions.md +450 -0
  672. package/.versions/2.2.3/docs/pi-setup.md +92 -0
  673. package/.versions/2.2.3/docs/skill-anatomy.md +150 -0
  674. package/.versions/2.2.3/install-manifest.json +3227 -0
  675. package/.versions/2.2.3/justfile +246 -0
  676. package/.versions/2.2.3/manifest-meta.json +1099 -0
  677. package/.versions/2.2.3/references/accessibility-checklist.md +160 -0
  678. package/.versions/2.2.3/references/communication-contract.md +26 -0
  679. package/.versions/2.2.3/references/definition-of-done.md +67 -0
  680. package/.versions/2.2.3/references/fleet-coordination-patterns.md +171 -0
  681. package/.versions/2.2.3/references/observability-checklist.md +92 -0
  682. package/.versions/2.2.3/references/orchestration-patterns.md +370 -0
  683. package/.versions/2.2.3/references/performance-checklist.md +236 -0
  684. package/.versions/2.2.3/references/prompting-patterns.md +380 -0
  685. package/.versions/2.2.3/references/security-checklist.md +245 -0
  686. package/.versions/2.2.3/references/testing-patterns.md +235 -0
  687. package/.versions/2.2.3/references/workflow-authoring.md +304 -0
  688. package/.versions/2.2.3/skills/_internal/grilling.md +59 -0
  689. package/.versions/2.2.3/skills/browser-testing-with-devtools/SKILL.md +351 -0
  690. package/.versions/2.2.3/skills/code-review-and-quality/SKILL.md +396 -0
  691. package/.versions/2.2.3/skills/compound-learning/SKILL.md +137 -0
  692. package/.versions/2.2.3/skills/constraint-driven-development/SKILL.md +338 -0
  693. package/.versions/2.2.3/skills/constraint-driven-development/references/floor-guard.md +99 -0
  694. package/.versions/2.2.3/skills/context-engineering/SKILL.md +341 -0
  695. package/.versions/2.2.3/skills/deprecation-and-migration/SKILL.md +247 -0
  696. package/.versions/2.2.3/skills/designing-agents/SKILL.md +394 -0
  697. package/.versions/2.2.3/skills/designing-agents/pi-harness-authoring.md +222 -0
  698. package/.versions/2.2.3/skills/drafting-workflows/SKILL.md +143 -0
  699. package/.versions/2.2.3/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  700. package/.versions/2.2.3/skills/fleet-connect/SKILL.md +29 -0
  701. package/.versions/2.2.3/skills/fleet-connect.zip +0 -0
  702. package/.versions/2.2.3/skills/fleet-native-voice/SKILL.md +103 -0
  703. package/.versions/2.2.3/skills/fleet-native-voice/agents/openai.yaml +4 -0
  704. package/.versions/2.2.3/skills/fleet-native-voice.zip +0 -0
  705. package/.versions/2.2.3/skills/frontend-ui-engineering/SKILL.md +328 -0
  706. package/.versions/2.2.3/skills/git-workflow-and-versioning/SKILL.md +316 -0
  707. package/.versions/2.2.3/skills/idea-refine/SKILL.md +182 -0
  708. package/.versions/2.2.3/skills/idea-refine/examples.md +238 -0
  709. package/.versions/2.2.3/skills/idea-refine/frameworks.md +99 -0
  710. package/.versions/2.2.3/skills/idea-refine/refinement-criteria.md +113 -0
  711. package/.versions/2.2.3/skills/idea-refine/scripts/idea-refine.sh +15 -0
  712. package/.versions/2.2.3/skills/incremental-implementation/SKILL.md +353 -0
  713. package/.versions/2.2.3/skills/incremental-implementation.zip +0 -0
  714. package/.versions/2.2.3/skills/interview-me/SKILL.md +226 -0
  715. package/.versions/2.2.3/skills/orchestration-verification/SKILL.md +182 -0
  716. package/.versions/2.2.3/skills/peer-coms/SKILL.md +90 -0
  717. package/.versions/2.2.3/skills/performance-optimization/SKILL.md +496 -0
  718. package/.versions/2.2.3/skills/planning-and-task-breakdown/SKILL.md +318 -0
  719. package/.versions/2.2.3/skills/planning-and-task-breakdown.zip +0 -0
  720. package/.versions/2.2.3/skills/repository-ai-setup/SKILL.md +135 -0
  721. package/.versions/2.2.3/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  722. package/.versions/2.2.3/skills/repository-ai-setup/references/apply-contract.md +74 -0
  723. package/.versions/2.2.3/skills/repository-ai-setup/references/provenance-template.md +16 -0
  724. package/.versions/2.2.3/skills/repository-ai-setup/references/setup-flow.md +108 -0
  725. package/.versions/2.2.3/skills/repository-ai-setup/references/verify-setup.md +20 -0
  726. package/.versions/2.2.3/skills/repository-ai-setup.zip +0 -0
  727. package/.versions/2.2.3/skills/security-and-hardening/SKILL.md +524 -0
  728. package/.versions/2.2.3/skills/spec-driven-development/SKILL.md +295 -0
  729. package/.versions/2.2.3/skills/spec-driven-development.zip +0 -0
  730. package/.versions/2.2.3/skills/using-agent-skills/SKILL.md +198 -0
  731. package/.versions/2.2.3/vendor/agent-skills-upstream/LICENSE +21 -0
  732. package/.versions/2.2.3/vendor/agent-skills-upstream/README.md +430 -0
  733. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  734. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  735. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  736. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  737. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  738. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  739. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  740. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  741. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  742. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  743. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  744. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  745. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  746. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  747. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  748. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  749. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  750. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  751. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  752. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  753. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  754. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  755. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  756. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  757. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  758. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  759. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  760. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  761. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  762. package/.versions/2.2.3/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  763. package/CHANGELOG.md +19 -0
  764. package/docs/hub-task-continuation.md +23 -0
  765. package/install-manifest.json +1 -1
  766. package/package.json +4 -3
@@ -0,0 +1,318 @@
1
+ // .pi/agent-fleet/scripts/lib/peer-launch.ts
2
+ //
3
+ // Pure logic for `just fleet peer <name>` — ONE addressable coms peer, in its
4
+ // own herdr pane by default, with no peers.yaml team involved.
5
+ //
6
+ // One verb, three shapes of peer, two placements:
7
+ //
8
+ // runner: claude-code → `just _claude-peer …` (Claude + its coms bridge)
9
+ // runner: pi, persona resolved → `just _peer[-plus] …` (guarded reusable persona peer)
10
+ // runner: pi, no persona → `just _fleet-peer …` (Fleet Core + coms, no persona)
11
+ //
12
+ // default → the command runs in a pane of its own
13
+ // --here → the command takes over the CALLING terminal
14
+ //
15
+ // The third shape is what `just fleet peer <name>` meant before pane placement
16
+ // existed, so `--here` reproduces the old behavior exactly while the same
17
+ // invocation without it now opens a pane.
18
+ //
19
+ // Resolution order for every field: explicit CLI flag → the peers.yaml
20
+ // declaration for that NAME (searched across all teams, see findPeerByName) →
21
+ // a convention default. So `just fleet peer code-reviewer` gets the
22
+ // `runner: claude-code` the fleet declares, and `--runner claude-code` needs no
23
+ // manifest entry at all.
24
+ //
25
+ // No sockets, no process.exit, no fs — callers supply the manifest text and a
26
+ // persona-existence probe, and every failure is a plain Error.
27
+
28
+ import { findPeerByName, parsePeersYaml, peerCommand, type Peer } from "./herdr-layout.ts";
29
+ import { DEFAULT_PROJECT, teamWorkspaceLabel, validateProject } from "./team-project.ts";
30
+
31
+ /** Synthetic team name used in peerCommand errors for a peer that has no team. */
32
+ export const ADHOC_TEAM = "ad-hoc";
33
+
34
+ /** The extension `--browser` adds to a pi persona peer (the `_peer-plus` route). */
35
+ export const BROWSER_EXTENSION = "chrome-devtools-mcp";
36
+
37
+ /**
38
+ * Pane label + coms identity charset. Stricter than herdr-layout's SAFE, which
39
+ * also permits `.`, `/` and `,` — fine inside a model spec, wrong for a name
40
+ * that becomes a pane label, a workspace label segment, and a coms address.
41
+ */
42
+ export const PEER_NAME_SAFE = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
43
+
44
+ export type PeerRunner = "pi" | "claude-code";
45
+ /** Which hidden recipe launches this peer — see the header table. */
46
+ export type PeerKind = "persona-peer" | "core-peer" | "claude-peer";
47
+
48
+ export interface PeerLaunchOptions {
49
+ name: string;
50
+ /** --runner; omit to inherit the peers.yaml declaration, else defaults to pi. */
51
+ runner?: string;
52
+ /** --persona; omit to inherit the declaration, else the same-named persona. */
53
+ persona?: string;
54
+ /**
55
+ * --no-persona: force the identity-only Fleet Core peer even when the name
56
+ * resolves to a persona. The escape hatch for raw pi arguments and
57
+ * --all-extensions under a name that happens to match a persona file.
58
+ */
59
+ noPersona?: boolean;
60
+ model?: string;
61
+ project?: string;
62
+ extensions?: string;
63
+ /** --browser: an extra extension for a persona peer, a capability flag for a core peer. */
64
+ browser?: boolean;
65
+ /** --all-extensions: core peers only — persona peers are deliberately deterministic. */
66
+ allExtensions?: boolean;
67
+ /** Raw pi arguments after `--`; core peers only. */
68
+ piArgs?: string[];
69
+ direction?: "right" | "down";
70
+ /** --here: run in the calling terminal instead of a pane. */
71
+ here?: boolean;
72
+ }
73
+
74
+ export interface PeerLaunchContext {
75
+ /** Raw .pi/agents/peers.yaml, or "" when the repo has none. */
76
+ peersYaml: string;
77
+ /** True when `agents/<persona>.md` or `.pi/agents/<persona>.md` exists. */
78
+ personaExists(persona: string): boolean;
79
+ /** worktreeTag(REPO_ROOT) — scopes the standalone workspace label. */
80
+ worktreeTag: string;
81
+ }
82
+
83
+ export interface PeerLaunchPlan {
84
+ name: string;
85
+ runner: PeerRunner;
86
+ kind: PeerKind;
87
+ persona?: string;
88
+ model?: string;
89
+ extensions?: string;
90
+ /** Repo-relative env_file inherited from the declaration, if any. */
91
+ envFile?: string;
92
+ project: string;
93
+ /** argv for the pane (or for this terminal under --here). */
94
+ command: string[];
95
+ placement: "pane" | "here";
96
+ direction: "right" | "down";
97
+ /** Workspace label used only when launching a pane outside a herdr pane. */
98
+ workspaceLabel: string;
99
+ /** True when peers.yaml declares this name (its fields seeded the plan). */
100
+ declared: boolean;
101
+ }
102
+
103
+ function validateName(name: string): string {
104
+ if (!PEER_NAME_SAFE.test(name)) {
105
+ throw new Error(
106
+ `Invalid peer name: ${JSON.stringify(name)} (letters, numbers, underscores and hyphens; must start alphanumeric)`,
107
+ );
108
+ }
109
+ return name;
110
+ }
111
+
112
+ function normalizeRunner(runner: string | undefined, source: string): PeerRunner | undefined {
113
+ if (runner === undefined) return undefined;
114
+ if (runner === "pi" || runner === "claude-code") return runner;
115
+ throw new Error(`Unknown runner ${JSON.stringify(runner)} from ${source} (supported: pi, claude-code)`);
116
+ }
117
+
118
+ function mergeExtensions(...values: (string | undefined)[]): string | undefined {
119
+ const names = values
120
+ .flatMap((v) => (v ?? "").split(","))
121
+ .map((v) => v.trim())
122
+ .filter((v) => v !== "");
123
+ return names.length > 0 ? [...new Set(names)].join(",") : undefined;
124
+ }
125
+
126
+ /**
127
+ * The pre-pane-placement `just fleet peer <name>` command: Fleet Core + coms
128
+ * under the given identity, with no persona and arbitrary pi arguments. Its
129
+ * positionals are `<name> <browser> <all_extensions>` followed by raw pi args,
130
+ * so `--project` travels as an ordinary pi flag rather than a placeholder slot.
131
+ */
132
+ function corePeerCommand(name: string, opts: PeerLaunchOptions, project: string, model?: string): string[] {
133
+ const command = ["just", "_fleet-peer", name, opts.browser ? "true" : "false", opts.allExtensions ? "true" : "false"];
134
+ if (model !== undefined) {
135
+ if (/[\r\n]/.test(model)) throw new Error(`model contains a line break: ${JSON.stringify(model)}`);
136
+ command.push("--model", model);
137
+ }
138
+ if (project !== DEFAULT_PROJECT) command.push("--project", project);
139
+ for (const arg of opts.piArgs ?? []) {
140
+ // A pane launch types this argv at a shell prompt one line at a time, so
141
+ // an embedded newline would execute half of it as a separate command.
142
+ if (/[\r\n]/.test(arg)) throw new Error(`pi argument contains a line break: ${JSON.stringify(arg)}`);
143
+ command.push(arg);
144
+ }
145
+ return command;
146
+ }
147
+
148
+ /**
149
+ * Merge CLI options with the peers.yaml declaration for the same name and
150
+ * produce the launch argv. Nothing is silently dropped: a flag that cannot
151
+ * apply to the resolved runner is an error, not a no-op.
152
+ */
153
+ export function buildPeerLaunchPlan(opts: PeerLaunchOptions, ctx: PeerLaunchContext): PeerLaunchPlan {
154
+ const name = validateName(opts.name);
155
+ const project = validateProject(opts.project ?? DEFAULT_PROJECT);
156
+ const teams = ctx.peersYaml ? parsePeersYaml(ctx.peersYaml) : {};
157
+ const declared: Peer | undefined = findPeerByName(teams, name);
158
+
159
+ const runner =
160
+ normalizeRunner(opts.runner, "--runner") ??
161
+ normalizeRunner(declared?.runner, `peers.yaml peer "${name}"`) ??
162
+ "pi";
163
+
164
+ const model = opts.model ?? declared?.model;
165
+ const common = {
166
+ name,
167
+ runner,
168
+ ...(model ? { model } : {}),
169
+ ...(declared?.env_file ? { envFile: declared.env_file } : {}),
170
+ project,
171
+ placement: (opts.here ? "here" : "pane") as "here" | "pane",
172
+ direction: opts.direction ?? ("right" as const),
173
+ workspaceLabel: teamWorkspaceLabel("peer", name, project, ctx.worktreeTag),
174
+ declared: declared !== undefined,
175
+ };
176
+
177
+ if (runner === "claude-code") {
178
+ if (opts.persona) throw new Error("--persona is pi-only; a claude-code peer carries no pi persona.");
179
+ if (opts.extensions || opts.browser || opts.allExtensions) {
180
+ throw new Error("--extensions/--browser/--all-extensions are pi-only and cannot combine with --runner claude-code.");
181
+ }
182
+ if (opts.piArgs?.length) throw new Error("arguments after `--` are pi arguments and cannot combine with --runner claude-code.");
183
+ return {
184
+ ...common,
185
+ kind: "claude-peer",
186
+ command: peerCommand({ name, ...(model ? { model } : {}), runner }, ADHOC_TEAM, undefined, project),
187
+ };
188
+ }
189
+
190
+ if (opts.noPersona && opts.persona) throw new Error("--no-persona and --persona are contradictory.");
191
+ const persona = opts.noPersona
192
+ ? undefined
193
+ : opts.persona ?? declared?.persona ?? (ctx.personaExists(name) ? name : undefined);
194
+
195
+ // No persona anywhere → the identity-only Fleet Core peer, which is exactly
196
+ // what this command did before pane placement existed. Not an error: it is
197
+ // the third shape of peer, and the only one that takes raw pi arguments.
198
+ if (!persona) {
199
+ if (opts.extensions) {
200
+ throw new Error(
201
+ `--extensions needs a persona peer. Pass --persona <name>, add .pi/agents/personas/${name}.md, ` +
202
+ "or use --all-extensions / raw pi flags after `--`.",
203
+ );
204
+ }
205
+ return { ...common, kind: "core-peer", command: corePeerCommand(name, opts, project, model) };
206
+ }
207
+
208
+ if (!ctx.personaExists(persona)) throw new Error(`Persona "${persona}" not found under agents/ or .pi/agents/.`);
209
+ if (opts.allExtensions) {
210
+ throw new Error(
211
+ `--all-extensions is not available to persona peer "${name}": reusable peers load a deterministic set. ` +
212
+ "Use --extensions <names>, declare extensions: in .pi/agents/peers.yaml, or --no-persona for a plain Fleet Core peer.",
213
+ );
214
+ }
215
+ if (opts.piArgs?.length) {
216
+ throw new Error(
217
+ `arguments after \`--\` need a personaless core peer; persona peer "${name}" builds its own pi command line. ` +
218
+ `Add --no-persona to launch "${name}" as a plain Fleet Core peer instead.`,
219
+ );
220
+ }
221
+ const extensions = mergeExtensions(opts.extensions ?? declared?.extensions, opts.browser ? BROWSER_EXTENSION : undefined);
222
+
223
+ return {
224
+ ...common,
225
+ kind: "persona-peer",
226
+ persona,
227
+ ...(extensions ? { extensions } : {}),
228
+ command: peerCommand(
229
+ { name, persona, ...(model ? { model } : {}), ...(extensions ? { extensions } : {}) },
230
+ ADHOC_TEAM,
231
+ undefined,
232
+ project,
233
+ ),
234
+ };
235
+ }
236
+
237
+ export interface ParsedPeerArgs extends PeerLaunchOptions {
238
+ dryRun: boolean;
239
+ /** --peers: alternate manifest path (tests use it). */
240
+ peersYaml?: string;
241
+ }
242
+
243
+ function takeValue(argv: string[], i: number, flag: string): string {
244
+ const value = argv[i + 1];
245
+ if (value === undefined || value.startsWith("--")) throw new Error(`${flag} requires a value`);
246
+ return value;
247
+ }
248
+
249
+ /**
250
+ * `<name> [--runner r] [--persona p|--no-persona] [--model m] [--project p]
251
+ * [--extensions a,b] [--browser] [--all-extensions] [--direction right|down]
252
+ * [--here] [--dry-run] [--peers path] [-- PI_ARGS…]`
253
+ *
254
+ * The peer name is the only positional and everything after `--` goes to pi
255
+ * verbatim. An unrecognized flag BEFORE `--` is an error rather than silently
256
+ * dropped argv — the failure mode `project=af` already taught this fleet about.
257
+ */
258
+ export function parsePeerArgs(argv: string[]): ParsedPeerArgs {
259
+ const out: ParsedPeerArgs = { name: "", dryRun: false };
260
+ let name: string | undefined;
261
+ for (let i = 0; i < argv.length; i++) {
262
+ const arg = argv[i];
263
+ if (arg === "--") {
264
+ out.piArgs = argv.slice(i + 1);
265
+ break;
266
+ }
267
+ switch (arg) {
268
+ case "--dry-run":
269
+ out.dryRun = true;
270
+ break;
271
+ case "--here":
272
+ out.here = true;
273
+ break;
274
+ case "--browser":
275
+ out.browser = true;
276
+ break;
277
+ case "--all-extensions":
278
+ out.allExtensions = true;
279
+ break;
280
+ case "--runner":
281
+ out.runner = takeValue(argv, i++, arg);
282
+ break;
283
+ case "--persona":
284
+ out.persona = takeValue(argv, i++, arg);
285
+ break;
286
+ case "--no-persona":
287
+ out.noPersona = true;
288
+ break;
289
+ case "--model":
290
+ out.model = takeValue(argv, i++, arg);
291
+ break;
292
+ case "--project":
293
+ out.project = takeValue(argv, i++, arg);
294
+ break;
295
+ case "--extensions":
296
+ out.extensions = takeValue(argv, i++, arg);
297
+ break;
298
+ case "--peers":
299
+ out.peersYaml = takeValue(argv, i++, arg);
300
+ break;
301
+ case "--direction": {
302
+ const value = takeValue(argv, i++, arg);
303
+ if (value !== "right" && value !== "down") throw new Error(`--direction expects right or down, got ${JSON.stringify(value)}`);
304
+ out.direction = value;
305
+ break;
306
+ }
307
+ default:
308
+ if (arg.startsWith("-")) {
309
+ throw new Error(`Unknown flag: ${arg} — pass pi flags after \`--\` (e.g. just fleet peer ${name ?? "<name>"} -- ${arg})`);
310
+ }
311
+ if (name !== undefined) throw new Error(`fleet peer takes one peer name, got ${JSON.stringify(name)} and ${JSON.stringify(arg)}`);
312
+ name = arg;
313
+ }
314
+ }
315
+ if (!name) throw new Error("fleet peer requires a peer name");
316
+ out.name = name;
317
+ return out;
318
+ }
@@ -0,0 +1 @@
1
+ export {peerTarget,targetPaneEnv,targetPeerCommand,bindTargetLayout} from '../../../harnesses/lib/peer-target.ts';
@@ -0,0 +1,62 @@
1
+ // .pi/agent-fleet/scripts/lib/persona-banner.ts
2
+ //
3
+ // Pure logic for the per-pane identity banner (`just _peer`/`_peer-plus`
4
+ // print it before exec'ing pi): persona frontmatter → colored ANSI banner.
5
+ // Frontmatter parsing mirrors the coms harness convention (name /
6
+ // description / color, quoted values allowed). Backend-agnostic — works in
7
+ // any terminal, inside or outside herdr.
8
+
9
+ export interface PersonaMeta {
10
+ name?: string;
11
+ description?: string;
12
+ color?: string;
13
+ }
14
+
15
+ export function parsePersonaFrontmatter(raw: string): PersonaMeta {
16
+ const match = raw.match(/^---\n([\s\S]*?)\n---\n?/);
17
+ if (!match) return {};
18
+ const fm: Record<string, string> = {};
19
+ for (const line of match[1].split("\n")) {
20
+ const idx = line.indexOf(":");
21
+ if (idx > 0) {
22
+ const key = line.slice(0, idx).trim();
23
+ let val = line.slice(idx + 1).trim();
24
+ if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
25
+ val = val.slice(1, -1);
26
+ }
27
+ fm[key] = val;
28
+ }
29
+ }
30
+ return { name: fm.name, description: fm.description, color: fm.color };
31
+ }
32
+
33
+ export function isValidHex(hex: string): boolean {
34
+ return /^#[0-9a-fA-F]{6}$/.test(hex);
35
+ }
36
+
37
+ function hexFg(hex: string, s: string): string {
38
+ const r = parseInt(hex.slice(1, 3), 16);
39
+ const g = parseInt(hex.slice(3, 5), 16);
40
+ const b = parseInt(hex.slice(5, 7), 16);
41
+ return `\x1b[38;2;${r};${g};${b}m${s}\x1b[0m`;
42
+ }
43
+
44
+ const DEFAULT_COLOR = "#36F9F6";
45
+
46
+ // Colored banner lines for a peer pane: name in the persona color, purpose
47
+ // dimmed below, framed by a rule in the same color. `width` caps the rule so
48
+ // narrow panes don't wrap.
49
+ export function renderBanner(
50
+ peerName: string,
51
+ meta: PersonaMeta,
52
+ width = 60,
53
+ ): string[] {
54
+ const color = meta.color && isValidHex(meta.color) ? meta.color : DEFAULT_COLOR;
55
+ const purpose = (meta.description ?? "").trim();
56
+ const rule = hexFg(color, "━".repeat(Math.max(8, Math.min(width, 100))));
57
+ const title = hexFg(color, `● ${peerName}`);
58
+ const lines = [rule, title];
59
+ if (purpose) lines.push(`\x1b[2m${purpose}\x1b[0m`);
60
+ lines.push(rule);
61
+ return lines;
62
+ }
@@ -0,0 +1,25 @@
1
+ // persona-dirs.ts — where a persona markdown file may live in a workspace.
2
+ //
3
+ // One list, imported by every persona lookup (the hub's scanAgentDirs, the
4
+ // peer launcher, the banner) so they cannot disagree about precedence:
5
+ //
6
+ // agents/ the user's own convention — wins, and is never
7
+ // .claude/agents/ written by the installer
8
+ // .pi/agents/personas/ where agent-fleet installs its 15 personas
9
+ // .pi/agents/ hand-placed files beside the fleet YAML config
10
+ //
11
+ // The installer moved out of `agents/` so a workspace keeps a clean root; the
12
+ // first two entries stay because a project that writes its own personas there
13
+ // must keep overriding ours.
14
+
15
+ export const PERSONA_DIRS: readonly (readonly string[])[] = Object.freeze([
16
+ Object.freeze(["agents"]),
17
+ Object.freeze([".claude", "agents"]),
18
+ Object.freeze([".pi", "agents", "personas"]),
19
+ Object.freeze([".pi", "agents"]),
20
+ ]);
21
+
22
+ /** The same list as workspace-relative POSIX paths, for messages and docs. */
23
+ export const PERSONA_DIR_PATHS: readonly string[] = Object.freeze(
24
+ PERSONA_DIRS.map((parts) => `${parts.join("/")}/`),
25
+ );
@@ -0,0 +1 @@
1
+ export {resourceClosureGaps} from '../../../harnesses/lib/resource-closure.js';
@@ -0,0 +1,124 @@
1
+ // Shared runtime dependency health check for lifecycle diagnostics and launchers.
2
+ // Keep this module plain JavaScript with builtin-only imports: the launcher must
3
+ // be able to load it precisely when the workspace's npm dependencies are broken.
4
+
5
+ import { existsSync, readFileSync } from "node:fs";
6
+ import { join } from "node:path";
7
+ import { spawnSync as nodeSpawnSync } from "node:child_process";
8
+
9
+ export const RUNTIME_DEPENDENCY_ROOTS = Object.freeze([
10
+ Object.freeze({ root: ".pi/extensions", label: "Pi extensions" }),
11
+ Object.freeze({ root: ".pi/harnesses", label: "Pi harnesses" }),
12
+ Object.freeze({ root: ".pi/agent-fleet/scripts", label: "workflow runtime" }),
13
+ ]);
14
+
15
+ export const RUNTIME_DEPENDENCY_REMEDIATION =
16
+ "run `just fleet deps`, or rerun setup with `just fleet setup --allow-exec`, then retry";
17
+
18
+ function parsePackage(file) {
19
+ try {
20
+ return { value: JSON.parse(readFileSync(file, "utf8")), error: null };
21
+ } catch (error) {
22
+ return { value: null, error: error instanceof Error ? error.message : String(error) };
23
+ }
24
+ }
25
+
26
+ function compactProblems(stdout, workspace) {
27
+ try {
28
+ const parsed = JSON.parse(stdout || "{}");
29
+ if (!Array.isArray(parsed.problems) || parsed.problems.length === 0) return null;
30
+ return parsed.problems
31
+ .slice(0, 3)
32
+ .map((problem) => String(problem).replaceAll(workspace, "."))
33
+ .join("; ");
34
+ } catch {
35
+ return null;
36
+ }
37
+ }
38
+
39
+ /**
40
+ * Check every installed Agent Fleet npm root with `npm ls`.
41
+ * A root without package.json was not selected/installed and is skipped.
42
+ *
43
+ * @param {object} opts
44
+ * @param {string} opts.workspace
45
+ * @param {typeof nodeSpawnSync} [opts.run]
46
+ * @returns {{healthy: boolean, checks: Array<object>, failures: Array<object>}}
47
+ */
48
+ export function checkRuntimeDependencies({ workspace, run = nodeSpawnSync } = {}) {
49
+ if (!workspace) throw new Error("runtime dependency check requires a workspace");
50
+ const checks = [];
51
+
52
+ for (const spec of RUNTIME_DEPENDENCY_ROOTS) {
53
+ const packagePath = join(workspace, spec.root, "package.json");
54
+ if (!existsSync(packagePath)) continue;
55
+
56
+ const parsedPackage = parsePackage(packagePath);
57
+ const nodeModulesPath = join(spec.root, "node_modules");
58
+ if (parsedPackage.error) {
59
+ checks.push({
60
+ ...spec,
61
+ path: `${spec.root}/package.json`,
62
+ healthy: false,
63
+ reason: `package.json is unreadable: ${parsedPackage.error}`,
64
+ });
65
+ continue;
66
+ }
67
+
68
+ const dependencies = Object.keys(parsedPackage.value?.dependencies ?? {});
69
+ const args = ["ls", "--prefix", spec.root, "--depth=0", "--json"];
70
+ const result = run("npm", args, {
71
+ cwd: workspace,
72
+ encoding: "utf8",
73
+ stdio: "pipe",
74
+ timeout: 30_000,
75
+ });
76
+ const missingRoot = dependencies.length > 0 && !existsSync(join(workspace, nodeModulesPath));
77
+ const problems = compactProblems(result.stdout, workspace);
78
+ const healthy = !result.error && result.status === 0 && !missingRoot;
79
+ let reason = null;
80
+ if (result.error) reason = `could not run npm ls: ${result.error.message}`;
81
+ else if (missingRoot) reason = `${nodeModulesPath} is missing`;
82
+ else if (problems) reason = problems;
83
+ else if (result.status !== 0) reason = `npm ls exited ${result.status ?? "without a status"}`;
84
+
85
+ checks.push({
86
+ ...spec,
87
+ path: nodeModulesPath,
88
+ healthy,
89
+ dependencies,
90
+ command: `npm ${args.join(" ")}`,
91
+ ...(reason ? { reason } : {}),
92
+ });
93
+ }
94
+
95
+ const failures = checks.filter((check) => !check.healthy);
96
+ return { healthy: failures.length === 0, checks, failures };
97
+ }
98
+
99
+ /** Doctor-shaped findings for every unhealthy installed dependency root. */
100
+ export function runtimeDependencyFindings({ workspace, run } = {}) {
101
+ return checkRuntimeDependencies({ workspace, run }).failures.map((failure) => ({
102
+ type: "runtime-dependencies",
103
+ path: failure.path,
104
+ issue: `${failure.label} dependencies are incomplete — ${failure.reason}`,
105
+ fix: RUNTIME_DEPENDENCY_REMEDIATION,
106
+ root: failure.root,
107
+ ...(failure.command ? { check: failure.command } : {}),
108
+ }));
109
+ }
110
+
111
+ /** Fail a launcher before Pi imports an incomplete Agent Fleet runtime. */
112
+ export function assertRuntimeDependencies(workspace, options = {}) {
113
+ const report = checkRuntimeDependencies({ workspace, ...options });
114
+ if (report.healthy) return report;
115
+ const details = report.failures.map((failure) => ` - ${failure.root}: ${failure.reason}`).join("\n");
116
+ const error = new Error(
117
+ `Agent Fleet runtime dependencies are incomplete:\n${details}\n` +
118
+ `Remediation: ${RUNTIME_DEPENDENCY_REMEDIATION}.\n` +
119
+ "This preflight stopped before Pi startup so extension-load failures are not misreported as unknown flags.",
120
+ );
121
+ error.name = "RuntimeDependencyError";
122
+ error.report = report;
123
+ throw error;
124
+ }
@@ -0,0 +1,56 @@
1
+ import {TARGET_CAPABILITIES} from '../../../harnesses/lib/target-capabilities.js';
2
+ import {existsSync,realpathSync} from 'node:fs';
3
+ import {join,resolve} from 'node:path';
4
+ import {readDamagePolicy} from '../../../harnesses/lib/damage-policy.ts';
5
+ import {loadSystem1Snapshot} from '../../../harnesses/lib/system1/config-loader.js';
6
+ import {resourceClosureGaps} from './resource-closure.js';
7
+ import {assertRuntimeDependencies} from './runtime-dependencies.js';
8
+ import {sessionRootsFromEnv,validateSessionRoots,targetProject,projectForSession,targetEnvironment,type SessionRoots} from '../../../harnesses/lib/workspace-context.ts';
9
+ export {targetProject,projectForSession,targetEnvironment};
10
+ const mandatory=['.pi/harnesses/damage-control-continue/index.ts','.pi/harnesses/agent-hub/index.ts','.pi/harnesses/agent-hub/delegate.ts','.pi/harnesses/ask-user-remote/index.ts','.pi/extensions/compact-and-continue/index.ts','.pi/extensions/btw/index.ts'];
11
+ function ownedResource(roots:SessionRoots,path:string){return [roots.workspaceRoot,roots.resourceRoot].some(root=>path.startsWith(root+'/'));}
12
+ export function targetReadiness(roots:SessionRoots){
13
+ validateSessionRoots(roots);const gaps:string[]=resourceClosureGaps(roots.resourceRoot,mandatory.map(path=>join(roots.workspaceRoot,path)),[roots.workspaceRoot]);
14
+ for(const path of ['justfile','.pi/harnesses/package.json','.pi/extensions/package.json','.pi/agent-fleet/scripts/package.json',...mandatory]){const full=join(roots.workspaceRoot,path);if(!existsSync(full))gaps.push(`missing_resource:${path}`);else if(!ownedResource(roots,realpathSync(full)))gaps.push(`foreign_resource:${path}`);}
15
+ try{assertRuntimeDependencies(roots.workspaceRoot);}catch{gaps.push('missing_runtime_dependencies:run just fleet deps from af');}
16
+ try{if(!readDamagePolicy(roots.executionRoot,roots))gaps.push('missing_workspace_damage_policy');}catch{gaps.push('invalid_workspace_damage_policy');}
17
+ const snapshot=loadSystem1Snapshot(roots.executionRoot,roots);
18
+ const consumers=Object.fromEntries(Object.entries(snapshot.consumers).map(([name,section]:[string,any])=>[name,{status:section.status,reason:section.reason,mode:section.config?.mode,providerChecked:false,applicabilityChecked:false}]));
19
+ return {ready:gaps.length===0,gaps,workspaceRoot:roots.workspaceRoot,resourceRoot:roots.resourceRoot,executionRoot:roots.executionRoot,repositoryRoot:roots.repositoryRoot,targetId:roots.targetId,consumers,capabilities:TARGET_CAPABILITIES};
20
+ }
21
+ export function buildSessionLaunch(args:string[],env=process.env,cwd=process.cwd()){
22
+ const roots=sessionRootsFromEnv(env);
23
+ if(!roots||roots.mode!=='targeted')return {command:'pi',args,cwd,env};
24
+ const readiness=targetReadiness(roots);if(!readiness.ready)throw Error(`Targeted launch refused: ${readiness.gaps.join('; ')}`);
25
+ const boundary=args.indexOf('--'),end=boundary<0?args.length:boundary;
26
+ const options=args.slice(0,end),tail=args.slice(end);
27
+ if(options.includes('--approve')||options.includes('-a'))throw Error('Targeted sessions ignore project-local runtime configuration; remove --approve');
28
+ if(!options.includes('--no-extensions'))throw Error('Targeted launch refuses automatic extension discovery; remove --all-extensions');
29
+ if(options.some(arg=>arg==='--session-dir'||arg.startsWith('--session-dir=')))throw Error("Targeted sessions keep Pi's cwd-scoped history; remove --session-dir");
30
+ const resolved:string[]=[],resources:string[]=[];let base=env.AF_TARGET_BASE_PROJECT??'default';
31
+ for(let i=0;i<options.length;i++){
32
+ const arg=options[i];
33
+ if(arg==='--project'){const value=options[++i];if(!value||value.startsWith('-'))throw Error('--project requires a namespace');base=value;continue;}
34
+ if(/^--(?:extension|skill|prompt-template)=/.test(arg))throw Error('Use separate resource option and workspace path');
35
+ resolved.push(arg);
36
+ if(['-e','--extension','--skill','--prompt-template'].includes(arg)){
37
+ const value=options[++i];if(!value)throw Error(`${arg} requires a workspace resource`);
38
+ const path=realpathSync(resolve(roots.workspaceRoot,value));if(!ownedResource(roots,path))throw Error(`Resource outside Fleet workspace: ${value}`);resolved.push(path);if(arg==='-e'||arg==='--extension')resources.push(path);
39
+ }else if(arg==='--append-system-prompt'){
40
+ const value=options[++i];if(value===undefined)throw Error('Missing system prompt');
41
+ const candidate=resolve(roots.workspaceRoot,value);
42
+ if(existsSync(candidate)){const canonical=realpathSync(candidate);if(!ownedResource(roots,canonical))throw Error('Persona is outside Fleet workspace');resolved.push(canonical);}else resolved.push(value);
43
+ }
44
+ }
45
+ for(const path of mandatory.slice(0,1))if(!resolved.includes(realpathSync(join(roots.workspaceRoot,path))))throw Error('Missing mandatory Damage-Control extension');
46
+ resolved.push('--no-approve','--no-mcp','--no-themes','--no-skills','--no-prompt-templates');
47
+ for(const [flag,path] of [['--skill','.pi/skills'],['--skill','skills'],['--prompt-template','.pi/prompts']])if(existsSync(join(roots.workspaceRoot,path))){
48
+ const canonical=realpathSync(join(roots.workspaceRoot,path));if(!ownedResource(roots,canonical))throw Error(`Foreign workspace resource: ${path}`);resolved.push(flag,canonical);
49
+ }
50
+ for(const name of ['AGENTS.md','CLAUDE.md']){const file=join(roots.workspaceRoot,name);if(existsSync(file)){const canonical=realpathSync(file);if(!ownedResource(roots,canonical))throw Error('Foreign workspace instruction resource');resolved.push('--append-system-prompt',canonical);break;}}
51
+ const closure=resourceClosureGaps(roots.resourceRoot,resources,[roots.workspaceRoot]);
52
+ if(closure.length)throw Error(`Incomplete workspace resource closure: ${closure.join('; ')}`);
53
+ const project=projectForSession(base,roots,env);
54
+ if(resolved.some(arg=>arg.endsWith('/agent-hub/index.ts')||arg.endsWith('/coms/index.ts')))resolved.push('--project',project.project);
55
+ return {command:'pi',args:[...resolved,...tail],cwd:roots.executionRoot,env:{...targetEnvironment(roots,env),AF_TARGET_BASE_PROJECT:project.baseProject,AF_TARGET_EFFECTIVE_PROJECT:project.project}};
56
+ }