@chankov/agent-fleet 2.0.11 → 2.0.12

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 (557) hide show
  1. package/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +1 -1
  2. package/.pi/agent-fleet/scripts/lib/herdr-layout.ts +3 -3
  3. package/.pi/harnesses/agent-hub/README.md +63 -6
  4. package/.pi/harnesses/agent-hub/budget-recovery.ts +24 -1
  5. package/.pi/harnesses/agent-hub/capability-packs.ts +2 -1
  6. package/.pi/harnesses/agent-hub/commands/context.ts +1 -0
  7. package/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  8. package/.pi/harnesses/agent-hub/commands/retry.ts +1 -1
  9. package/.pi/harnesses/agent-hub/config/overrides.ts +8 -1
  10. package/.pi/harnesses/agent-hub/context-budget-snapshot.ts +1 -1
  11. package/.pi/harnesses/agent-hub/context-window.js +2 -0
  12. package/.pi/harnesses/agent-hub/delegate.ts +3 -1
  13. package/.pi/harnesses/agent-hub/dispatch-coms.ts +20 -5
  14. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +9 -3
  15. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +56 -51
  16. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +8 -2
  17. package/.pi/harnesses/agent-hub/dispatch-native.ts +1 -1
  18. package/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  19. package/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  20. package/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  21. package/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  22. package/.pi/harnesses/agent-hub/drift-watchdog.js +140 -9
  23. package/.pi/harnesses/agent-hub/index.ts +81 -43
  24. package/.pi/harnesses/agent-hub/input/completions.ts +8 -2
  25. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +4 -2
  26. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
  27. package/.pi/harnesses/agent-hub/no-progress.ts +169 -16
  28. package/.pi/harnesses/agent-hub/package.json +1 -1
  29. package/.pi/harnesses/agent-hub/policy/work-mode.ts +2 -2
  30. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -1
  31. package/.pi/harnesses/agent-hub/prompts/session-start.ts +2 -2
  32. package/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  33. package/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  34. package/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  35. package/.pi/harnesses/agent-hub/recovery-contract.ts +3 -1
  36. package/.pi/harnesses/agent-hub/research/controls.ts +1 -1
  37. package/.pi/harnesses/agent-hub/research/runtime.ts +1 -1
  38. package/.pi/harnesses/agent-hub/research/spawn-run.ts +1 -1
  39. package/.pi/harnesses/agent-hub/return-extract.js +3 -1
  40. package/.pi/harnesses/agent-hub/review-findings.js +2 -0
  41. package/.pi/harnesses/agent-hub/run-budget.js +6 -1
  42. package/.pi/harnesses/agent-hub/run-namespace.js +6 -0
  43. package/.pi/harnesses/agent-hub/session-audit.ts +68 -3
  44. package/.pi/harnesses/agent-hub/spawn.ts +76 -8
  45. package/.pi/harnesses/agent-hub/system1-activity.ts +443 -0
  46. package/.pi/harnesses/agent-hub/system1-report.ts +84 -0
  47. package/.pi/harnesses/agent-hub/system1-runtime.ts +273 -0
  48. package/.pi/harnesses/agent-hub/timeline.ts +23 -5
  49. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +14 -1
  50. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
  51. package/.pi/harnesses/agent-hub/types.ts +1 -0
  52. package/.pi/harnesses/agent-hub/ui/activity-dots.ts +12 -3
  53. package/.pi/harnesses/agent-hub/ui/context-budget.ts +4 -3
  54. package/.pi/harnesses/agent-hub/ui/detail-panel.ts +11 -18
  55. package/.pi/harnesses/agent-hub/ui/fleet-actions.ts +3 -1
  56. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +2 -2
  57. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +14 -1
  58. package/.pi/harnesses/agent-hub/ui/grid.ts +6 -6
  59. package/.pi/harnesses/agent-hub/ui/pool.ts +1 -1
  60. package/.pi/harnesses/agent-hub/ui/zoom.ts +5 -3
  61. package/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  62. package/.pi/harnesses/coms/package.json +1 -1
  63. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  64. package/.pi/harnesses/lib/coms-core.ts +1 -1
  65. package/.pi/harnesses/lib/context-budget.ts +1 -1
  66. package/.pi/harnesses/lib/fleet-dashboard-view.ts +3 -1
  67. package/.pi/harnesses/lib/fleet-detail-view.ts +35 -4
  68. package/.pi/harnesses/lib/fleet-read-model.ts +206 -14
  69. package/.pi/harnesses/lib/fleet-strip-view.ts +17 -5
  70. package/.pi/harnesses/lib/hermes-monitor-registry.ts +1 -1
  71. package/.pi/harnesses/lib/spawned-peers.js +1 -0
  72. package/.pi/harnesses/lib/system1/config.js +61 -0
  73. package/.pi/harnesses/lib/system1/contracts.ts +152 -0
  74. package/.pi/harnesses/lib/system1/demo.ts +106 -0
  75. package/.pi/harnesses/lib/system1/jev.ts +503 -0
  76. package/.pi/harnesses/lib/system1/service.ts +245 -0
  77. package/.versions/2.0.12/.pi/agent-fleet/hermes/README.md +347 -0
  78. package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  79. package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  80. package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  81. package/.versions/2.0.12/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  82. package/.versions/2.0.12/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  83. package/.versions/2.0.12/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  84. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  85. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  86. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  87. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  88. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  89. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  90. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  91. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  92. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  93. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  94. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  95. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  96. package/.versions/2.0.12/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  97. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  98. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  99. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  100. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  101. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  102. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  103. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  104. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  105. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  106. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  107. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  108. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  109. package/.versions/2.0.12/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  110. package/.versions/2.0.12/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  111. package/.versions/2.0.12/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  112. package/.versions/2.0.12/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  113. package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  114. package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  115. package/.versions/2.0.12/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  116. package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  117. package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  118. package/.versions/2.0.12/.pi/agent-fleet/scripts/fleet.ts +216 -0
  119. package/.versions/2.0.12/.pi/agent-fleet/scripts/flow.ts +155 -0
  120. package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  121. package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  122. package/.versions/2.0.12/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  123. package/.versions/2.0.12/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  124. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  125. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  126. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  127. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  128. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  129. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  130. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  131. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  132. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  133. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  134. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  135. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  136. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  137. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  138. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  139. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  140. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  141. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  142. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  143. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  144. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  145. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  146. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  147. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  148. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  149. package/.versions/2.0.12/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  150. package/.versions/2.0.12/.pi/agent-fleet/scripts/package-lock.json +35 -0
  151. package/.versions/2.0.12/.pi/agent-fleet/scripts/package.json +9 -0
  152. package/.versions/2.0.12/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  153. package/.versions/2.0.12/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  154. package/.versions/2.0.12/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  155. package/.versions/2.0.12/.pi/agent-fleet/scripts/team-up.ts +378 -0
  156. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +177 -0
  157. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  158. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  159. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  160. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  161. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  162. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  163. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  164. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  165. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  166. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  167. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  168. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  169. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  170. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  171. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  172. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  173. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  174. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  175. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  176. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  177. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  178. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  179. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  180. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  181. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  182. package/.versions/2.0.12/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  183. package/.versions/2.0.12/.pi/agents/dispatch-policy.yaml +32 -0
  184. package/.versions/2.0.12/.pi/agents/model-profiles.yaml +83 -0
  185. package/.versions/2.0.12/.pi/agents/peers.yaml +147 -0
  186. package/.versions/2.0.12/.pi/agents/teams.yaml +41 -0
  187. package/.versions/2.0.12/.pi/agents/voices.yaml +13 -0
  188. package/.versions/2.0.12/.pi/damage-control-rules.yaml +297 -0
  189. package/.versions/2.0.12/.pi/extensions/btw/README.md +120 -0
  190. package/.versions/2.0.12/.pi/extensions/btw/index.ts +914 -0
  191. package/.versions/2.0.12/.pi/extensions/btw/package.json +6 -0
  192. package/.versions/2.0.12/.pi/extensions/btw/state.js +179 -0
  193. package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  194. package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  195. package/.versions/2.0.12/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  196. package/.versions/2.0.12/.pi/extensions/compact-and-continue/README.md +42 -0
  197. package/.versions/2.0.12/.pi/extensions/compact-and-continue/index.ts +120 -0
  198. package/.versions/2.0.12/.pi/extensions/compact-and-continue/package.json +6 -0
  199. package/.versions/2.0.12/.pi/extensions/mcp-bridge/README.md +46 -0
  200. package/.versions/2.0.12/.pi/extensions/mcp-bridge/index.ts +206 -0
  201. package/.versions/2.0.12/.pi/extensions/mcp-bridge/package.json +6 -0
  202. package/.versions/2.0.12/.pi/extensions/package-lock.json +1175 -0
  203. package/.versions/2.0.12/.pi/extensions/package.json +9 -0
  204. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/README.md +224 -0
  205. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/config.ts +198 -0
  206. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  207. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/index.ts +248 -0
  208. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/package.json +6 -0
  209. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  210. package/.versions/2.0.12/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  211. package/.versions/2.0.12/.pi/harnesses/agent-hub/README.md +1309 -0
  212. package/.versions/2.0.12/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  213. package/.versions/2.0.12/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  214. package/.versions/2.0.12/.pi/harnesses/agent-hub/artifacts.js +146 -0
  215. package/.versions/2.0.12/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  216. package/.versions/2.0.12/.pi/harnesses/agent-hub/assist-profile.ts +16 -0
  217. package/.versions/2.0.12/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  218. package/.versions/2.0.12/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  219. package/.versions/2.0.12/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  220. package/.versions/2.0.12/.pi/harnesses/agent-hub/budget-recovery.ts +214 -0
  221. package/.versions/2.0.12/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  222. package/.versions/2.0.12/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  223. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  224. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  225. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  226. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  227. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  228. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  229. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  230. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  231. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  232. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  233. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  234. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  235. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  236. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  237. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  238. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  239. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/context.ts +45 -0
  240. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  241. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  242. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  243. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  244. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  245. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  246. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/recover.ts +52 -0
  247. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  248. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  249. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  250. package/.versions/2.0.12/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  251. package/.versions/2.0.12/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  252. package/.versions/2.0.12/.pi/harnesses/agent-hub/config/model-profiles.ts +235 -0
  253. package/.versions/2.0.12/.pi/harnesses/agent-hub/config/overrides.ts +160 -0
  254. package/.versions/2.0.12/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  255. package/.versions/2.0.12/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  256. package/.versions/2.0.12/.pi/harnesses/agent-hub/context/budgets.ts +204 -0
  257. package/.versions/2.0.12/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  258. package/.versions/2.0.12/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  259. package/.versions/2.0.12/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  260. package/.versions/2.0.12/.pi/harnesses/agent-hub/context-window.js +108 -0
  261. package/.versions/2.0.12/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  262. package/.versions/2.0.12/.pi/harnesses/agent-hub/delegate.ts +465 -0
  263. package/.versions/2.0.12/.pi/harnesses/agent-hub/deterministic-fs.ts +127 -0
  264. package/.versions/2.0.12/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  265. package/.versions/2.0.12/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  266. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-coms.ts +252 -0
  267. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  268. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-complete.ts +169 -0
  269. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +223 -0
  270. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +202 -0
  271. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native-types.ts +251 -0
  272. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-native.ts +226 -0
  273. package/.versions/2.0.12/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  274. package/.versions/2.0.12/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  275. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  276. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  277. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  278. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  279. package/.versions/2.0.12/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  280. package/.versions/2.0.12/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  281. package/.versions/2.0.12/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  282. package/.versions/2.0.12/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  283. package/.versions/2.0.12/.pi/harnesses/agent-hub/filesystem-tool.ts +73 -0
  284. package/.versions/2.0.12/.pi/harnesses/agent-hub/fixtures/registration-surface.json +61 -0
  285. package/.versions/2.0.12/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  286. package/.versions/2.0.12/.pi/harnesses/agent-hub/footer.ts +30 -0
  287. package/.versions/2.0.12/.pi/harnesses/agent-hub/helpers.ts +270 -0
  288. package/.versions/2.0.12/.pi/harnesses/agent-hub/hub-state-audit.js +65 -0
  289. package/.versions/2.0.12/.pi/harnesses/agent-hub/index.ts +2301 -0
  290. package/.versions/2.0.12/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  291. package/.versions/2.0.12/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  292. package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +125 -0
  293. package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  294. package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  295. package/.versions/2.0.12/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  296. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  297. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  298. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  299. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  300. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  301. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  302. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  303. package/.versions/2.0.12/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  304. package/.versions/2.0.12/.pi/harnesses/agent-hub/no-progress.ts +359 -0
  305. package/.versions/2.0.12/.pi/harnesses/agent-hub/package.json +7 -0
  306. package/.versions/2.0.12/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  307. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  308. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  309. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  310. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  311. package/.versions/2.0.12/.pi/harnesses/agent-hub/policy/work-mode.ts +126 -0
  312. package/.versions/2.0.12/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  313. package/.versions/2.0.12/.pi/harnesses/agent-hub/presentation.ts +48 -0
  314. package/.versions/2.0.12/.pi/harnesses/agent-hub/process-obligations.ts +57 -0
  315. package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/context.ts +51 -0
  316. package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/fragments.ts +118 -0
  317. package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  318. package/.versions/2.0.12/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  319. package/.versions/2.0.12/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  320. package/.versions/2.0.12/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  321. package/.versions/2.0.12/.pi/harnesses/agent-hub/recover-policy.ts +27 -0
  322. package/.versions/2.0.12/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  323. package/.versions/2.0.12/.pi/harnesses/agent-hub/recovery-contract.ts +80 -0
  324. package/.versions/2.0.12/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  325. package/.versions/2.0.12/.pi/harnesses/agent-hub/research/runtime.ts +193 -0
  326. package/.versions/2.0.12/.pi/harnesses/agent-hub/research/spawn-run.ts +171 -0
  327. package/.versions/2.0.12/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  328. package/.versions/2.0.12/.pi/harnesses/agent-hub/return-contract.js +327 -0
  329. package/.versions/2.0.12/.pi/harnesses/agent-hub/return-extract.js +77 -0
  330. package/.versions/2.0.12/.pi/harnesses/agent-hub/review-findings.js +104 -0
  331. package/.versions/2.0.12/.pi/harnesses/agent-hub/run-budget.js +542 -0
  332. package/.versions/2.0.12/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  333. package/.versions/2.0.12/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  334. package/.versions/2.0.12/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  335. package/.versions/2.0.12/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  336. package/.versions/2.0.12/.pi/harnesses/agent-hub/session-audit.ts +226 -0
  337. package/.versions/2.0.12/.pi/harnesses/agent-hub/session-health.js +110 -0
  338. package/.versions/2.0.12/.pi/harnesses/agent-hub/session-start.ts +42 -0
  339. package/.versions/2.0.12/.pi/harnesses/agent-hub/spawn.ts +526 -0
  340. package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-activity.ts +443 -0
  341. package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-report.ts +84 -0
  342. package/.versions/2.0.12/.pi/harnesses/agent-hub/system1-runtime.ts +273 -0
  343. package/.versions/2.0.12/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  344. package/.versions/2.0.12/.pi/harnesses/agent-hub/timeline.ts +72 -0
  345. package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +68 -0
  346. package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  347. package/.versions/2.0.12/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  348. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/action-executors.ts +185 -0
  349. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  350. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/context.ts +142 -0
  351. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  352. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +498 -0
  353. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  354. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  355. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  356. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/run-flow.ts +122 -0
  357. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  358. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/spawn-research.ts +65 -0
  359. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  360. package/.versions/2.0.12/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  361. package/.versions/2.0.12/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  362. package/.versions/2.0.12/.pi/harnesses/agent-hub/types.ts +66 -0
  363. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  364. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/context-budget.ts +87 -0
  365. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/detail-panel.ts +171 -0
  366. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  367. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  368. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  369. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/fleet-source.ts +170 -0
  370. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  371. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  372. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  373. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  374. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  375. package/.versions/2.0.12/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  376. package/.versions/2.0.12/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  377. package/.versions/2.0.12/.pi/harnesses/agent-hub/version.ts +42 -0
  378. package/.versions/2.0.12/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  379. package/.versions/2.0.12/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  380. package/.versions/2.0.12/.pi/harnesses/agent-hub/work-mode.ts +173 -0
  381. package/.versions/2.0.12/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  382. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/README.md +59 -0
  383. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/index.ts +558 -0
  384. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  385. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  386. package/.versions/2.0.12/.pi/harnesses/ask-user-remote/runtime-ask.ts +68 -0
  387. package/.versions/2.0.12/.pi/harnesses/coms/README.md +100 -0
  388. package/.versions/2.0.12/.pi/harnesses/coms/index.ts +282 -0
  389. package/.versions/2.0.12/.pi/harnesses/coms/package.json +7 -0
  390. package/.versions/2.0.12/.pi/harnesses/coms/version.ts +42 -0
  391. package/.versions/2.0.12/.pi/harnesses/damage-control-continue/README.md +135 -0
  392. package/.versions/2.0.12/.pi/harnesses/damage-control-continue/index.ts +550 -0
  393. package/.versions/2.0.12/.pi/harnesses/damage-control-continue/package.json +7 -0
  394. package/.versions/2.0.12/.pi/harnesses/damage-control-continue/version.ts +42 -0
  395. package/.versions/2.0.12/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  396. package/.versions/2.0.12/.pi/harnesses/lib/coms-core-io.ts +385 -0
  397. package/.versions/2.0.12/.pi/harnesses/lib/coms-core.ts +577 -0
  398. package/.versions/2.0.12/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  399. package/.versions/2.0.12/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  400. package/.versions/2.0.12/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  401. package/.versions/2.0.12/.pi/harnesses/lib/context-budget-view.ts +107 -0
  402. package/.versions/2.0.12/.pi/harnesses/lib/context-budget.ts +114 -0
  403. package/.versions/2.0.12/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  404. package/.versions/2.0.12/.pi/harnesses/lib/deterministic-handle-path.ts +23 -0
  405. package/.versions/2.0.12/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  406. package/.versions/2.0.12/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  407. package/.versions/2.0.12/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  408. package/.versions/2.0.12/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  409. package/.versions/2.0.12/.pi/harnesses/lib/fleet-dashboard-view.ts +136 -0
  410. package/.versions/2.0.12/.pi/harnesses/lib/fleet-detail-view.ts +278 -0
  411. package/.versions/2.0.12/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  412. package/.versions/2.0.12/.pi/harnesses/lib/fleet-panel.ts +34 -0
  413. package/.versions/2.0.12/.pi/harnesses/lib/fleet-read-model.ts +405 -0
  414. package/.versions/2.0.12/.pi/harnesses/lib/fleet-selection.ts +24 -0
  415. package/.versions/2.0.12/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  416. package/.versions/2.0.12/.pi/harnesses/lib/fleet-strip-view.ts +144 -0
  417. package/.versions/2.0.12/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  418. package/.versions/2.0.12/.pi/harnesses/lib/herdr-client.ts +472 -0
  419. package/.versions/2.0.12/.pi/harnesses/lib/herdr-presence.ts +399 -0
  420. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  421. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  422. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  423. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  424. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  425. package/.versions/2.0.12/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  426. package/.versions/2.0.12/.pi/harnesses/lib/spawned-peers.js +191 -0
  427. package/.versions/2.0.12/.pi/harnesses/lib/system1/config.js +61 -0
  428. package/.versions/2.0.12/.pi/harnesses/lib/system1/contracts.ts +152 -0
  429. package/.versions/2.0.12/.pi/harnesses/lib/system1/demo.ts +106 -0
  430. package/.versions/2.0.12/.pi/harnesses/lib/system1/jev.ts +503 -0
  431. package/.versions/2.0.12/.pi/harnesses/lib/system1/service.ts +245 -0
  432. package/.versions/2.0.12/.pi/harnesses/lib/update-check.ts +222 -0
  433. package/.versions/2.0.12/.pi/harnesses/package-lock.json +2039 -0
  434. package/.versions/2.0.12/.pi/harnesses/package.json +10 -0
  435. package/.versions/2.0.12/.pi/prompts/af-build.md +24 -0
  436. package/.versions/2.0.12/.pi/prompts/af-code-simplify.md +22 -0
  437. package/.versions/2.0.12/.pi/prompts/af-constraints.md +31 -0
  438. package/.versions/2.0.12/.pi/prompts/af-plan.md +17 -0
  439. package/.versions/2.0.12/.pi/prompts/af-review.md +16 -0
  440. package/.versions/2.0.12/.pi/prompts/af-set-hermes-telegram.md +15 -0
  441. package/.versions/2.0.12/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  442. package/.versions/2.0.12/.pi/prompts/af-ship.md +17 -0
  443. package/.versions/2.0.12/.pi/prompts/af-spec.md +15 -0
  444. package/.versions/2.0.12/.pi/prompts/af-test.md +19 -0
  445. package/.versions/2.0.12/.pi/skills/bowser/SKILL.md +145 -0
  446. package/.versions/2.0.12/.version +1 -0
  447. package/.versions/2.0.12/agents/architect.md +25 -0
  448. package/.versions/2.0.12/agents/bowser.md +28 -0
  449. package/.versions/2.0.12/agents/builder.md +56 -0
  450. package/.versions/2.0.12/agents/code-reviewer.md +210 -0
  451. package/.versions/2.0.12/agents/deep-researcher.md +33 -0
  452. package/.versions/2.0.12/agents/documenter.md +23 -0
  453. package/.versions/2.0.12/agents/orchestrator.md +23 -0
  454. package/.versions/2.0.12/agents/plan-reviewer.md +84 -0
  455. package/.versions/2.0.12/agents/planner.md +106 -0
  456. package/.versions/2.0.12/agents/releaser.md +25 -0
  457. package/.versions/2.0.12/agents/researcher.md +31 -0
  458. package/.versions/2.0.12/agents/security-auditor.md +168 -0
  459. package/.versions/2.0.12/agents/test-engineer.md +154 -0
  460. package/.versions/2.0.12/agents/web-debugger.md +44 -0
  461. package/.versions/2.0.12/agents/web-performance-auditor.md +194 -0
  462. package/.versions/2.0.12/bin/catalog/harness-runtime-closure.json +61 -0
  463. package/.versions/2.0.12/codex/fleet-session-client/SKILL.md +34 -0
  464. package/.versions/2.0.12/codex/fleet-session-client.zip +0 -0
  465. package/.versions/2.0.12/docs/ARCHITECTURE.md +705 -0
  466. package/.versions/2.0.12/docs/agent-fleet-setup.md +682 -0
  467. package/.versions/2.0.12/docs/claude-code-coms-bridge.md +134 -0
  468. package/.versions/2.0.12/docs/codex-session-bridge.md +219 -0
  469. package/.versions/2.0.12/docs/coms-hermes-bridge.md +188 -0
  470. package/.versions/2.0.12/docs/getting-started.md +126 -0
  471. package/.versions/2.0.12/docs/npm-install.md +468 -0
  472. package/.versions/2.0.12/docs/pi-extensions.md +449 -0
  473. package/.versions/2.0.12/docs/pi-setup.md +92 -0
  474. package/.versions/2.0.12/docs/skill-anatomy.md +150 -0
  475. package/.versions/2.0.12/install-manifest.json +3053 -0
  476. package/.versions/2.0.12/justfile +247 -0
  477. package/.versions/2.0.12/manifest-meta.json +995 -0
  478. package/.versions/2.0.12/references/accessibility-checklist.md +160 -0
  479. package/.versions/2.0.12/references/communication-contract.md +26 -0
  480. package/.versions/2.0.12/references/definition-of-done.md +67 -0
  481. package/.versions/2.0.12/references/fleet-coordination-patterns.md +171 -0
  482. package/.versions/2.0.12/references/observability-checklist.md +92 -0
  483. package/.versions/2.0.12/references/orchestration-patterns.md +370 -0
  484. package/.versions/2.0.12/references/performance-checklist.md +236 -0
  485. package/.versions/2.0.12/references/prompting-patterns.md +380 -0
  486. package/.versions/2.0.12/references/security-checklist.md +245 -0
  487. package/.versions/2.0.12/references/testing-patterns.md +235 -0
  488. package/.versions/2.0.12/references/workflow-authoring.md +304 -0
  489. package/.versions/2.0.12/skills/_internal/grilling.md +59 -0
  490. package/.versions/2.0.12/skills/browser-testing-with-devtools/SKILL.md +351 -0
  491. package/.versions/2.0.12/skills/code-review-and-quality/SKILL.md +396 -0
  492. package/.versions/2.0.12/skills/compound-learning/SKILL.md +137 -0
  493. package/.versions/2.0.12/skills/constraint-driven-development/SKILL.md +338 -0
  494. package/.versions/2.0.12/skills/constraint-driven-development/references/floor-guard.md +99 -0
  495. package/.versions/2.0.12/skills/context-engineering/SKILL.md +341 -0
  496. package/.versions/2.0.12/skills/deprecation-and-migration/SKILL.md +247 -0
  497. package/.versions/2.0.12/skills/designing-agents/SKILL.md +394 -0
  498. package/.versions/2.0.12/skills/designing-agents/pi-harness-authoring.md +222 -0
  499. package/.versions/2.0.12/skills/drafting-workflows/SKILL.md +143 -0
  500. package/.versions/2.0.12/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  501. package/.versions/2.0.12/skills/frontend-ui-engineering/SKILL.md +328 -0
  502. package/.versions/2.0.12/skills/git-workflow-and-versioning/SKILL.md +316 -0
  503. package/.versions/2.0.12/skills/idea-refine/SKILL.md +182 -0
  504. package/.versions/2.0.12/skills/idea-refine/examples.md +238 -0
  505. package/.versions/2.0.12/skills/idea-refine/frameworks.md +99 -0
  506. package/.versions/2.0.12/skills/idea-refine/refinement-criteria.md +113 -0
  507. package/.versions/2.0.12/skills/idea-refine/scripts/idea-refine.sh +15 -0
  508. package/.versions/2.0.12/skills/incremental-implementation/SKILL.md +302 -0
  509. package/.versions/2.0.12/skills/interview-me/SKILL.md +226 -0
  510. package/.versions/2.0.12/skills/orchestration-verification/SKILL.md +182 -0
  511. package/.versions/2.0.12/skills/peer-coms/SKILL.md +90 -0
  512. package/.versions/2.0.12/skills/performance-optimization/SKILL.md +496 -0
  513. package/.versions/2.0.12/skills/planning-and-task-breakdown/SKILL.md +289 -0
  514. package/.versions/2.0.12/skills/security-and-hardening/SKILL.md +524 -0
  515. package/.versions/2.0.12/skills/spec-driven-development/SKILL.md +295 -0
  516. package/.versions/2.0.12/skills/using-agent-skills/SKILL.md +198 -0
  517. package/.versions/2.0.12/vendor/agent-skills-upstream/LICENSE +21 -0
  518. package/.versions/2.0.12/vendor/agent-skills-upstream/README.md +430 -0
  519. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  520. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  521. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  522. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  523. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  524. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  525. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  526. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  527. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  528. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  529. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  530. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  531. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  532. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  533. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  534. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  535. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  536. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  537. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  538. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  539. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  540. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  541. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  542. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  543. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  544. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  545. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  546. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  547. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  548. package/.versions/2.0.12/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  549. package/CHANGELOG.md +10 -0
  550. package/bin/cli.js +3 -3
  551. package/bin/lib/doctor.js +63 -1
  552. package/docs/ARCHITECTURE.md +113 -3
  553. package/docs/agent-fleet-setup.md +96 -0
  554. package/docs/npm-install.md +87 -2
  555. package/install-manifest.json +34 -1
  556. package/manifest-meta.json +25 -0
  557. package/package.json +6 -2
@@ -0,0 +1,192 @@
1
+ ---
2
+ name: using-agent-skills
3
+ description: Discovers and invokes agent skills. Use when starting a session, or when you need to decide which skill or workflow applies to the piece of work at hand. This is the meta-skill that governs how all other skills are discovered and invoked.
4
+ ---
5
+
6
+ # Using Agent Skills
7
+
8
+ ## Overview
9
+
10
+ Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
11
+
12
+ ## Skill Discovery
13
+
14
+ When a task arrives, identify the development phase and apply the corresponding skill:
15
+
16
+ ```
17
+ Task arrives
18
+ │
19
+ ├── Don't know what you want yet? ──────→ interview-me
20
+ ├── Have a rough concept, need variants? → idea-refine
21
+ ├── New project/feature/change? ──→ spec-driven-development
22
+ ├── No quality bar written down? ──→ constraint-driven-development
23
+ ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
24
+ ├── Implementing code? ────────────→ incremental-implementation
25
+ │ ├── UI work? ─────────────────→ frontend-ui-engineering
26
+ │ ├── API work? ────────────────→ api-and-interface-design
27
+ │ ├── Need better context? ─────→ context-engineering
28
+ │ ├── Need doc-verified code? ───→ source-driven-development
29
+ │ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
30
+ ├── Writing/running tests? ────────→ test-driven-development
31
+ │ └── Browser-based? ───────────→ browser-testing-with-devtools
32
+ ├── Something broke? ──────────────→ debugging-and-error-recovery
33
+ ├── Reviewing code? ───────────────→ code-review-and-quality
34
+ │ ├── Too complex? ─────────────→ code-simplification
35
+ │ ├── Security concerns? ───────→ security-and-hardening
36
+ │ └── Performance concerns? ────→ performance-optimization
37
+ ├── Committing/branching? ─────────→ git-workflow-and-versioning
38
+ ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
39
+ ├── Deprecating/migrating? ────────→ deprecation-and-migration
40
+ ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
41
+ ├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
42
+ └── Deploying/launching? ─────────→ shipping-and-launch
43
+ ```
44
+
45
+ ## Core Operating Behaviors
46
+
47
+ These behaviors apply at all times, across all skills. They are non-negotiable.
48
+
49
+ ### 1. Surface Assumptions
50
+
51
+ Before implementing anything non-trivial, explicitly state your assumptions:
52
+
53
+ ```
54
+ ASSUMPTIONS I'M MAKING:
55
+ 1. [assumption about requirements]
56
+ 2. [assumption about architecture]
57
+ 3. [assumption about scope]
58
+ → Correct me now or I'll proceed with these.
59
+ ```
60
+
61
+ Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
62
+
63
+ ### 2. Manage Confusion Actively
64
+
65
+ When you encounter inconsistencies, conflicting requirements, or unclear specifications:
66
+
67
+ 1. **STOP.** Do not proceed with a guess.
68
+ 2. Name the specific confusion.
69
+ 3. Present the tradeoff or ask the clarifying question.
70
+ 4. Wait for resolution before continuing.
71
+
72
+ **Bad:** Silently picking one interpretation and hoping it's right.
73
+ **Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
74
+
75
+ ### 3. Push Back When Warranted
76
+
77
+ You are not a yes-machine. When an approach has clear problems:
78
+
79
+ - Point out the issue directly
80
+ - Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
81
+ - Propose an alternative
82
+ - Accept the human's decision if they override with full information
83
+
84
+ Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
85
+
86
+ ### 4. Enforce Simplicity
87
+
88
+ Your natural tendency is to overcomplicate. Actively resist it.
89
+
90
+ Before finishing any implementation, ask:
91
+ - Can this be done in fewer lines?
92
+ - Are these abstractions earning their complexity?
93
+ - Would a staff engineer look at this and say "why didn't you just..."?
94
+
95
+ If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
96
+
97
+ ### 5. Maintain Scope Discipline
98
+
99
+ Touch only what you're asked to touch.
100
+
101
+ Do NOT:
102
+ - Remove comments you don't understand
103
+ - "Clean up" code orthogonal to the task
104
+ - Refactor adjacent systems as a side effect
105
+ - Delete code that seems unused without explicit approval
106
+ - Add features not in the spec because they "seem useful"
107
+
108
+ Your job is surgical precision, not unsolicited renovation.
109
+
110
+ ### 6. Verify, Don't Assume
111
+
112
+ Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
113
+
114
+ Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `../../references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
115
+
116
+ ## Failure Modes to Avoid
117
+
118
+ These are the subtle errors that look like productivity but create problems:
119
+
120
+ 1. Making wrong assumptions without checking
121
+ 2. Not managing your own confusion — plowing ahead when lost
122
+ 3. Not surfacing inconsistencies you notice
123
+ 4. Not presenting tradeoffs on non-obvious decisions
124
+ 5. Being sycophantic ("Of course!") to approaches with clear problems
125
+ 6. Overcomplicating code and APIs
126
+ 7. Modifying code or comments orthogonal to the task
127
+ 8. Removing things you don't fully understand
128
+ 9. Building without a spec because "it's obvious"
129
+ 10. Skipping verification because "it looks right"
130
+
131
+ ## Skill Rules
132
+
133
+ 1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
134
+
135
+ 2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
136
+
137
+ 3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
138
+
139
+ 4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
140
+
141
+ ## Lifecycle Sequence
142
+
143
+ For a complete feature, the typical skill sequence is:
144
+
145
+ ```
146
+ 1. interview-me → Extract what the user actually wants
147
+ 2. idea-refine → Refine vague ideas
148
+ 3. spec-driven-development → Define what we're building
149
+ 4. planning-and-task-breakdown → Break into verifiable chunks
150
+ 5. context-engineering → Load the right context
151
+ 6. source-driven-development → Verify against official docs
152
+ 7. incremental-implementation → Build slice by slice
153
+ 8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
154
+ 9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
155
+ 10. test-driven-development → Prove each slice works
156
+ 11. code-review-and-quality → Review before merge
157
+ 12. code-simplification → Reduce unnecessary complexity while preserving behavior
158
+ 13. git-workflow-and-versioning → Clean commit history
159
+ 14. documentation-and-adrs → Document decisions
160
+ 15. deprecation-and-migration → Retire old systems and move users safely when needed
161
+ 16. shipping-and-launch → Deploy safely
162
+ ```
163
+
164
+ Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
165
+
166
+ ## Quick Reference
167
+
168
+ | Phase | Skill | One-Line Summary |
169
+ |-------|-------|-----------------|
170
+ | Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
171
+ | Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
172
+ | Define | spec-driven-development | Requirements and acceptance criteria before code |
173
+ | Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
174
+ | Build | incremental-implementation | Thin vertical slices, test each before expanding |
175
+ | Build | source-driven-development | Verify against official docs before implementing |
176
+ | Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
177
+ | Build | context-engineering | Right context at the right time |
178
+ | Build | frontend-ui-engineering | Production-quality UI with accessibility |
179
+ | Build | api-and-interface-design | Stable interfaces with clear contracts |
180
+ | Verify | test-driven-development | Failing test first, then make it pass |
181
+ | Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
182
+ | Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
183
+ | Review | code-review-and-quality | Five-axis review with quality gates |
184
+ | Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
185
+ | Review | security-and-hardening | OWASP prevention, input validation, least privilege |
186
+ | Review | performance-optimization | Measure first, optimize only what matters |
187
+ | Ship | git-workflow-and-versioning | Atomic commits, clean history |
188
+ | Ship | ci-cd-and-automation | Automated quality gates on every change |
189
+ | Ship | deprecation-and-migration | Remove old systems and migrate users safely |
190
+ | Ship | documentation-and-adrs | Document the why, not just the what |
191
+ | Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
192
+ | Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
package/CHANGELOG.md CHANGED
@@ -1,5 +1,15 @@
1
1
  # Agent Fleet changelog
2
2
 
3
+ ## 2.0.12
4
+
5
+ ### Patch Changes
6
+
7
+ - be06772: Add the opt-in experimental System 1 foundation with a provider-neutral judgment contract, a pinned TypeSafe Jev adapter, advisory offline diagnostics, and an explicit synthetic live demo.
8
+
9
+ The `system1` feature remains outside automatic Full selection and uses human-owned version-1 `.ai/system1.json` configuration. It does not integrate with Watchdog, install local models, or promise child-environment credential isolation.
10
+
11
+ - d7a15e2: Add opt-in System 1 observations for native drift watchdog checks, safe trace/UI reporting, bounded recovery after an unavailable LLM judge, and an explicitly opted-in experimental active shortcut for advisory scope only (Jev 0.95/0.05). Active is not G2-validated; the default remains off and terminal rules retain the LLM judge.
12
+
3
13
  ## 2.0.11
4
14
 
5
15
  ### Patch Changes
package/bin/cli.js CHANGED
@@ -381,7 +381,7 @@ async function cmdDoctor() {
381
381
  catch (err) { fail(`cannot recover pending transaction: ${err.message}`); }
382
382
  }
383
383
 
384
- const ADVISORY_FINDING_TYPES = new Set(["overrides", "yaml-shape"]);
384
+ const ADVISORY_FINDING_TYPES = new Set(["overrides", "yaml-shape", "system1"]);
385
385
  // These findings affect launch readiness and the doctor exit code, but npm
386
386
  // execution remains behind its dedicated explicit-consent commands.
387
387
  const MANUAL_FINDING_TYPES = new Set(["runtime-dependencies", "manifest-tool"]);
@@ -399,7 +399,7 @@ async function cmdDoctor() {
399
399
  const enginePaths = new Set(
400
400
  repairs.flatMap((a) => [a.target, ...(a.files ?? []).map((f) => f.path)]).filter(Boolean),
401
401
  );
402
- const findings = (await runDoctor({ workspace, sourceRoot: pkgRoot }))
402
+ const findings = (await runDoctor({ workspace, sourceRoot: pkgRoot, env: process.env }))
403
403
  .filter((f) => !(f.type === "broken-symlink" && enginePaths.has(f.path)));
404
404
  for (const tool of preflight.tools.filter((item) => item.status === "missing")) findings.push({
405
405
  type: "manifest-tool", path: tool.itemId, issue: `required manifest tool ${tool.probe} is missing`,
@@ -465,7 +465,7 @@ async function cmdDoctor() {
465
465
  let scanRepair = null;
466
466
  if (willFix) {
467
467
  if (repairs.length > 0) applied = applyPlan({ plan, manifest: loadManifest(pkgRoot) });
468
- if (fixable.length > 0) scanRepair = await runDoctor({ workspace, sourceRoot: pkgRoot, apply: true });
468
+ if (fixable.length > 0) scanRepair = await runDoctor({ workspace, sourceRoot: pkgRoot, apply: true, env: process.env });
469
469
  }
470
470
 
471
471
  const runtimeRepairOutput = (line) => (opts.json ? console.error : console.log)(`exec: ${line}`);
package/bin/lib/doctor.js CHANGED
@@ -26,6 +26,9 @@
26
26
  // 8. Manifest preflight — selected exact files and declared package probes are
27
27
  // reported as environment readiness, with platform unknown/unavailable kept
28
28
  // distinct from missing installation. Inspection never installs or repairs.
29
+ // 9. System 1 readiness — explicit feature selection, human configuration,
30
+ // .env declaration and current environment presence. Advisory and read-only;
31
+ // API validity is never inferred or probed.
29
32
  //
30
33
  // For each broken link we look up a canonical replacement in the source
31
34
  // `agents/` or `skills/` tree (many breakages are stale names from the
@@ -38,6 +41,7 @@ import { parse as parseYaml } from "yaml";
38
41
  import { validateOverrides } from "./validate-overrides.js";
39
42
  import { readState, STATE_REL_PATH } from "./state.js";
40
43
  import { runtimeDependencyFindings } from "../../.pi/agent-fleet/scripts/lib/runtime-dependencies.js";
44
+ import { resolveSystem1Readiness } from "../../.pi/harnesses/lib/system1/config.js";
41
45
 
42
46
  export const AGENT_FLEET_PACKAGE_NAME = "@chankov/agent-fleet";
43
47
  const AGENT_FLEET_PACKAGE_PATTERN = /(^|[/:])@chankov\/agent-fleet(@[^/]*)?$/;
@@ -85,7 +89,7 @@ const YAML_REFS = [
85
89
  * @param {boolean} [opts.apply] If true, apply suggested fixes; otherwise just report
86
90
  * @returns {Array|object} Findings array (apply=false) or {repaired,deleted,skipped} (apply=true)
87
91
  */
88
- export async function runDoctor({ workspace, sourceRoot, apply = false, checkVisibility, checkDependencies } = {}) {
92
+ export async function runDoctor({ workspace, sourceRoot, apply = false, checkVisibility, checkDependencies, env = process.env } = {}) {
89
93
  const findings = [];
90
94
 
91
95
  // 1. Broken symlinks in install-target directories.
@@ -173,6 +177,10 @@ export async function runDoctor({ workspace, sourceRoot, apply = false, checkVis
173
177
  // Node module resolution cannot borrow a sibling root's node_modules.
174
178
  findings.push(...runtimeDependencyFindings({ workspace, run: checkDependencies }));
175
179
 
180
+ // 9. Optional System 1 readiness. This reads local declarations only; it does
181
+ // not load .env, create a provider, or contact the API.
182
+ findings.push(...scanSystem1Readiness({ workspace, env }));
183
+
176
184
  if (!apply) return findings;
177
185
 
178
186
  // ── Apply ──────────────────────────────────────────────────────────────
@@ -208,6 +216,60 @@ export async function runDoctor({ workspace, sourceRoot, apply = false, checkVis
208
216
  return { repaired, deleted, skipped, findings };
209
217
  }
210
218
 
219
+ export function scanSystem1Readiness({ workspace, env = process.env }) {
220
+ const desiredPath = join(workspace, ".ai", "agent-fleet.json");
221
+ let selected = false;
222
+ if (existsSync(desiredPath)) {
223
+ try {
224
+ const desired = JSON.parse(readFileSync(desiredPath, "utf8"));
225
+ selected = desired?.features?.system1 === true;
226
+ } catch {
227
+ // A malformed desired-state file is handled by the installer lifecycle;
228
+ // without a trustworthy explicit selection System 1 remains inactive.
229
+ }
230
+ }
231
+ if (!selected) return [];
232
+
233
+ const configPath = join(workspace, ".ai", "system1.json");
234
+ let config;
235
+ if (existsSync(configPath)) {
236
+ try { config = JSON.parse(readFileSync(configPath, "utf8")); }
237
+ catch { config = null; }
238
+ }
239
+ const readiness = resolveSystem1Readiness({ selected, config, env });
240
+ const envPath = join(workspace, ".env");
241
+ let envDeclared = false;
242
+ if (existsSync(envPath)) {
243
+ try {
244
+ envDeclared = /^(?:\s*export\s+)?\s*TYPESAFE_API_KEY\s*=/m.test(readFileSync(envPath, "utf8"));
245
+ } catch { /* Unreadable declarations remain absent. */ }
246
+ }
247
+ const environmentPresent = typeof env.TYPESAFE_API_KEY === "string" && env.TYPESAFE_API_KEY.trim().length > 0;
248
+ const readinessName = readiness.status === "ready" ? "ready" : readiness.reason;
249
+ const detail = {
250
+ disabled: "configuration mode is off; other fields were not validated",
251
+ missing_config: ".ai/system1.json is absent",
252
+ missing_key: envDeclared
253
+ ? "TYPESAFE_API_KEY is declared in .env but is not present in the current process environment; .env was not loaded"
254
+ : "TYPESAFE_API_KEY is not present in the current process environment",
255
+ invalid_config: ".ai/system1.json is invalid",
256
+ ready: "configuration and current environment are locally ready",
257
+ }[readinessName];
258
+ return [{
259
+ type: "system1",
260
+ path: ".ai/system1.json",
261
+ issue: `System 1: ${detail}; API validity is unverified`,
262
+ fix: readinessName === "ready" || readinessName === "disabled"
263
+ ? "no automatic action"
264
+ : "review the operator-owned System 1 configuration and process environment",
265
+ classification: "advisory",
266
+ readiness: readinessName,
267
+ envDeclared,
268
+ environmentPresent,
269
+ apiValidity: "unverified",
270
+ }];
271
+ }
272
+
211
273
  function escapeRe(s) {
212
274
  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
213
275
  }
@@ -21,6 +21,7 @@ this page describes the current architecture.
21
21
  | **Hermes local monitor transport** | Local, authenticated monitor contract for Hub-owned task generations; consumers supply their own presentation | `.pi/harnesses/agent-hub/monitor-*.ts`, `.pi/harnesses/lib/hermes-monitor-{model,store,registry,socket}.ts` (with compatibility re-exports under `.pi/agent-fleet/scripts/lib/`) — see [Hermes artifacts](../.pi/agent-fleet/hermes/README.md#local-agent-hub-monitor-integration) and [watchdog limits](hermes-watchdog-supervisor.md) |
22
22
  | **Hermes Desktop plugin** (`agent-fleet-herdr`) | Fleet observability surface — read-only panel of every live session joined from the coms registry, herdr presence, agent transcripts, and the monitor transport; `focus` and subagent `cancel` are its only write doors | `.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/` (Electron pane), `.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/` (FastAPI backend), installed by `.pi/agent-fleet/scripts/install-hermes-plugin.sh` — see [hermes-desktop-plugins.md](hermes-desktop-plugins.md) |
23
23
  | **ChatGPT Fleet session client** | Experimental ChatGPT-initiated client for an existing Pi session; no daemon or idle wake | `.pi/agent-fleet/scripts/fleet-codex-client.ts`, `.pi/agent-fleet/scripts/lib/fleet-codex-*`, opt-in feature `chatgpt-client` — see [codex-session-bridge.md](codex-session-bridge.md) |
24
+ | **System 1 foundation** | Experimental, opt-in provider-neutral structured judgments; currently TypeSafe Jev only, with a separate off-by-default native watchdog shadow consumer and closed active gate | `.pi/harnesses/lib/system1/`, feature `system1`, human-owned `.ai/system1.json` |
24
25
  | **Skill library** | Lifecycle workflows and quality gates every agent follows | `skills/` (native) + `vendor/agent-skills-upstream/skills/` (vendored) — see [UPSTREAM-SKILLS.md](UPSTREAM-SKILLS.md) |
25
26
  | **Personas** | Reusable specialist definitions, installed verbatim | `agents/` in the package → `.pi/agents/personas/` in a workspace; `bin/lib/personas.js` |
26
27
 
@@ -287,8 +288,17 @@ T5 does not consume `assist.write-isolation`; the separate T6c native launch bou
287
288
 
288
289
  Recovery remains the single T1 contract: no automatic retry, queue, model fallback, or new
289
290
  numeric allowance. Busy work is refused before execution accounting or history mutation and is
290
- not recorded as no-progress failure; indeterminate failures do not authorize retry. Operator
291
- cancellation fences the same agent identity until a fresh, one-use authorization is consumed.
291
+ not recorded as no-progress failure. A settled indeterminate failure permits at most one
292
+ explicit, warned, human-authorized retry per logical operation after the prior process is
293
+ confirmed finished and the executor is idle; partial side effects may be duplicated. Neither
294
+ `/af-recover retry <operationId> <attemptId>` nor legacy `/af-retry <dispatchId>` executes work:
295
+ both use the same authorization lane and offer a stored original-contract invocation for a
296
+ separate explicit tool call under unchanged budgets and safety gates. Pending/unknown process,
297
+ second grant, stale IDs, and missing original contract fail closed. `/af-recover inspect` is
298
+ read-only; `reconcile` clears only a technical block when independent current-revision
299
+ readback and nonblocking reviewer evidence cover the failed attempt, leaving the immutable
300
+ failure and open T2/T11 requirements intact; `abandon` never satisfies dependent work.
301
+ Operator cancellation fences the same agent identity until a fresh, one-use authorization is consumed.
292
302
  Other agent identities—including the anonymous, read-only research actor—remain independent,
293
303
  and a task reset does not erase the cancellation fence. Native session reuse is bound to an exact,
294
304
  normalized current-task contract (task identity, instructions, scope, deliverables, input artifacts,
@@ -439,6 +449,106 @@ These are the external systems Agent Fleet assumes or integrates with — not np
439
449
 
440
450
  The existing `agent-fleet doctor` command also performs a read-only manifest preflight. It reports exact selected installation files and manifest-declared tool probes as environment readiness, distinguishes missing installation from unknown or unavailable platforms, and names the existing explicit remediation path. Bare doctor never repairs or installs; `doctor --fix` remains the only repair activation, and package/tool installation remains behind its existing explicit consent path.
441
451
 
452
+ ### System 1 watchdog consumer (off by default)
453
+
454
+ The native specialist Layer 1 drift watchdog can use the shared System 1 runtime
455
+ only after explicit `watchdog-system1: shadow` in `## agent-hub`, feature selection,
456
+ valid provider configuration, an available key and an armed watchdog. It takes a
457
+ session snapshot; setup and doctor do not infer. Shadow starts the LLM judge at
458
+ once and separately observes the same bounded state with Jev. Only the LLM
459
+ verdict may terminate a child; an unavailable LLM judge is recorded as
460
+ `judge_unavailable` and gets one revalidated retry at 5 s, not a successful
461
+ 90 s cooldown. Successful decisions keep 90 s. Every physical attempt has
462
+ separate identities; D1 retries create a new snapshot and do not reuse or
463
+ repeat the previous System 1 evaluation.
464
+
465
+ The state carries a redacted task, relative scope/paths, up to 40 structured
466
+ kinds/outcomes/repeat counts, rule facts and coverage, not raw arguments,
467
+ commands, edit bodies or outputs. This limit applies to System 1 only: the
468
+ existing parallel LLM judge prompt contains the original task, scope and a
469
+ recent trail with up to 120 characters of raw tool arguments per call. Use
470
+ only reviewed nonsecret pilot inputs; manual review does not rule out
471
+ unexpected agent actions. The native spawn boundary removes
472
+ `TYPESAFE_API_KEY` after env overrides. This cannot prevent file reads or
473
+ requests from other launchers. The append-only session watchdog trace stores
474
+ only safe metadata, with explicit unknown usage and interrupted readback.
475
+ The below-chat Fleet strip and `/af-agents` owner detail share a projection;
476
+ `/af-watchdog` shows readiness/active blocking, `/af-hub-report` separates
477
+ watchdog checks, S1 evaluations and LLM attempts, and `/af-audit` lists safe
478
+ read-only lifecycle outcomes. UI/trace failure does not change judgment.
479
+
480
+ `watchdog-system1: active` explicitly opts into an **uncalibrated experimental**
481
+ shortcut available in installed workspaces: only advisory `scope` may skip LLM
482
+ when Jev `jev-1.13.0` reports provider on-track with confidence and on-track
483
+ distribution ≥0.95 and all three contradiction probabilities ≤0.05. Terminal
484
+ rules always use the LLM; System 1 cannot stop a child. The watchdog status
485
+ labels the mode `experimental: scope only; G2 not validated`; default remains
486
+ off and production approved profiles remain empty. Human snapshot labels,
487
+ session-separated held-out measurement and independent maintainer G2 approval
488
+ are still required before calling this calibrated or expanding its authority. Offline tests and installed-package checks do not
489
+ constitute a live pilot (G1) or active approval (G2). Roll back with
490
+ `watchdog-system1: off` and restart Hub; cancel the current run if needed.
491
+
492
+ ### Experimental System 1 foundation
493
+
494
+ System 1 is a shared Fleet library for bounded structured judgments, not a Pi
495
+ model and not a workflow stage. Its provider-neutral contract exposes
496
+ `choice`, `predicate`, and `ordinal` questions with explicit `ok`, `skipped`,
497
+ `unavailable`, `unsupported`, and `cancelled` outcomes. A valid judgment never
498
+ grants action authority. The contract retains distributions, predicate
499
+ probabilities, and provider confidence when supplied and required, but never
500
+ invents missing uncertainty or treats provider confidence as universal
501
+ calibration.
502
+
503
+ The experimental `system1` feature must be named explicitly in the human-owned
504
+ `.ai/agent-fleet.json`; automatic Full excludes it. Provider configuration is a
505
+ separate human-owned `.ai/system1.json` with exactly this version-1 contract:
506
+
507
+ ```json
508
+ {
509
+ "version": 1,
510
+ "mode": "auto",
511
+ "provider": "typesafe",
512
+ "model": "jev-1.13.0",
513
+ "apiKeyEnv": "TYPESAFE_API_KEY"
514
+ }
515
+ ```
516
+
517
+ Selection, valid `mode: "auto"` configuration, and a nonempty key in the
518
+ caller's environment are all required. `mode: "off"` wins, and key presence by
519
+ itself never activates the service. The runtime and imports do not load `.env`
520
+ or mutate global environment. Managed `just` launches may load the workspace
521
+ root `.env`; direct Node launches must export or inject the key themselves.
522
+
523
+ The only phase-0 production adapter uses the fixed official TypeSafe endpoint
524
+ and pinned `jev-1.13.0` model. It has a 2,000 ms total deadline, including body
525
+ collection and at most one budget-fitting retry for 429/529, rejects redirects,
526
+ and bounds request and response bodies at 1 MiB without truncation. Cancellation
527
+ prevents retry and late-result use; a 401 latches that service instance. Normal
528
+ failures return structured, sanitized outcomes rather than raw response bodies.
529
+ There is no arbitrary endpoint, SDK dependency, Pi/local-model fallback, daemon,
530
+ or local-model installation.
531
+
532
+ Doctor reuses the shared configuration validator and is advisory, read-only,
533
+ and offline—even with `--fix`. It distinguishes an `.env` declaration from a
534
+ nonempty key in its own process but cannot prove API validity. The standalone
535
+ demo is also offline by default; only explicit `--live` sends its embedded
536
+ synthetic Bulgarian/English examples. Public setup and commands are documented
537
+ in [Install and lifecycle](npm-install.md#experimental-system-1-foundation).
538
+
539
+ This foundation has no Watchdog integration or other action consumer. It also
540
+ makes no child-environment isolation promise: existing Fleet children may
541
+ inherit caller environment. A future consumer must own field allowlisting,
542
+ credential filtering, policy, thresholds, and calibration for its provider,
543
+ model, question version, domain, and language. Synthetic success is not
544
+ Watchdog accuracy.
545
+
546
+ Evidence remains split by boundary. Offline contract and extracted-package
547
+ checks passed on Node 25.2.1. A real-provider smoke was not executed because
548
+ `TYPESAFE_API_KEY` was absent, packaged doctor execution on Node 18 remains
549
+ unverified because no Node 18 runtime was available, and final maintainer review
550
+ is pending. None of those open items is implied by fixtures or readiness output.
551
+
442
552
  ## Repository module map
443
553
 
444
554
  ### Agent Hub composition
@@ -451,7 +561,7 @@ agent-hub/
451
561
  ├── types.ts # shared Hub agent/state contracts
452
562
  ├── config/ # agent/frontmatter, teams, profiles, dispatch policy, overrides
453
563
  ├── context/ # state, budgets, assertions/artifacts, session-health factories
454
- ├── commands/ # 21 typed /af-* command registrars
564
+ ├── commands/ # 27 typed /af-* command registrars
455
565
  ├── tools/ # 16 tools plus dispatch/research execution orchestration
456
566
  ├── dispatch-core.ts # facade over native, coms, and observability dispatch
457
567
  ├── dispatch-*.ts # native preparation/spawn/completion and backend adapters
@@ -11,6 +11,12 @@ different readers and different lifetimes, so they are kept separate.
11
11
  | `.ai/agent-fleet-setup.md` | humans — rendered from the state file, never parsed back | Rewritten on every setup apply |
12
12
  | `.ai/agent-fleet-transaction.json` | the deterministic lifecycle (`setup`, `doctor --fix`) — crash-recovery journal for in-flight file transactions | Written during apply; recovered or discarded by setup/doctor; removed when the transaction commits or is cleaned up |
13
13
  | `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
14
+ | `.ai/system1.json` *(optional)* | System 1 shared runtime and doctor | When the experimental `system1` feature is explicitly selected |
15
+
16
+ The `.ai/system1.json` file is human-owned, non-secret provider configuration.
17
+ Setup prints its required shape but does not create or overwrite it. Its
18
+ `apiKeyEnv` field names a caller-environment variable; it never contains the
19
+ credential itself. See [System 1 configuration](#system-1-configuration).
14
20
 
15
21
  The `.ai/stt.json` file is present only when the optional `pi-voice-stt` voice-dictation
16
22
  extension has been configured (by deterministic setup or by hand). Like the overrides file it holds
@@ -122,6 +128,95 @@ operator work mode with `/af-work-mode operator` / `just fleet --work-mode opera
122
128
  use `--agent-team <name>` or `--work-mode operator`. Explicit startup flags win over persisted state;
123
129
  fix missing or renamed team/persona declarations before selecting them.
124
130
 
131
+ ## System 1 configuration
132
+
133
+ System 1 is an experimental named feature and is excluded from automatic
134
+ Default/Full selection. Select it explicitly and persist that desired state when
135
+ needed:
136
+
137
+ ```bash
138
+ npx @chankov/agent-fleet@latest setup \
139
+ --preset default --features system1 --save-desired --yes
140
+ ```
141
+
142
+ Then create the human-owned `.ai/system1.json` with exactly these version-1
143
+ fields and values:
144
+
145
+ ```json
146
+ {
147
+ "version": 1,
148
+ "mode": "auto",
149
+ "provider": "typesafe",
150
+ "model": "jev-1.13.0",
151
+ "apiKeyEnv": "TYPESAFE_API_KEY"
152
+ }
153
+ ```
154
+
155
+ `mode: "off"` disables the service even when a key exists. Selection plus
156
+ `mode: "auto"` still requires the valid configuration and a nonempty
157
+ `TYPESAFE_API_KEY` in the caller environment. Key presence alone never enables
158
+ System 1. The runtime does not execute `.env`: the managed `just` launcher can
159
+ load the root `.env`, while a direct Node invocation must receive an exported or
160
+ otherwise injected variable.
161
+
162
+ `agent-fleet doctor` reads the desired state and configuration as data. Its
163
+ System 1 result is advisory and read-only, including with `--fix`; it performs
164
+ no provider request and does not validate the key. A declaration in `.env` is
165
+ reported separately from a value present in doctor's current environment.
166
+
167
+ The installed demo is offline unless `--live` is supplied. Both forms require a
168
+ Node runtime supporting `--experimental-strip-types`:
169
+
170
+ ```bash
171
+ # Readiness only; no provider call.
172
+ node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
173
+ .pi/harnesses/lib/system1/demo.ts
174
+
175
+ # Explicit live request using only embedded synthetic Bulgarian/English data.
176
+ node --experimental-strip-types --preserve-symlinks --preserve-symlinks-main \
177
+ .pi/harnesses/lib/system1/demo.ts --live
178
+ ```
179
+
180
+ The only phase-0 production provider/model is TypeSafe Jev `jev-1.13.0` at its
181
+ fixed official endpoint. No local model is installed and no fallback model is
182
+ selected. Outputs preserve available uncertainty but do not establish truth,
183
+ action authority, or calibration for a particular domain/language. The native specialist drift watchdog has a separate **consumer opt-in**:
184
+ `watchdog-system1: off|shadow|active` in `## agent-hub` (default `off`).
185
+ It also requires an armed watchdog, explicit feature selection, valid shared
186
+ configuration and a key. `off` makes no System 1 evaluation. `shadow` runs the
187
+ LLM judge immediately and System 1 in parallel; only the LLM can stop a child.
188
+ `active` is an **uncalibrated, explicitly opted-in experiment**: only the
189
+ advisory `scope` rule may skip LLM when Jev `jev-1.13.0` returns provider
190
+ `on_track` with confidence and on-track distribution ≥0.95 and all three
191
+ contradiction probabilities ≤0.05. Terminal `loop`, `failures`, and `toolcap`
192
+ always use LLM. `/af-watchdog` labels this `experimental: scope only; G2 not
193
+ validated`. This can miss a scope advisory; it is not G2 approval. Missing or
194
+ mismatched provider/config returns to LLM; default consumer mode remains off. Restart Hub to apply a
195
+ consumer mode/config snapshot; `/af-watchdog on|off|auto` changes Layer 1 arming,
196
+ not the System 1 consumer mode. For rollback set `watchdog-system1: off` for the
197
+ next session (cancel the current run if needed).
198
+
199
+ **System 1 outbound state** is limited to a redacted task, normalized relative
200
+ scope/paths, 40 structured tool events without commands, bodies, arguments or
201
+ outputs, rule facts, coverage and counters (32 KiB maximum). This does **not**
202
+ limit the existing parallel LLM judge prompt: it includes the original task,
203
+ scope and a recent trail with up to 120 characters of raw tool arguments per
204
+ call. Both paths can reveal data. For a future pilot, review the tasks, files
205
+ and likely tool arguments; never use client/production data or secrets. Manual
206
+ review cannot guarantee that an agent will not produce unexpected arguments.
207
+ The final native spawn env removes `TYPESAFE_API_KEY`; this does not protect
208
+ against file reads or other launchers. Trace (`<sessionDir>/artifacts/watchdog/events.jsonl`)
209
+ records only allowlisted metadata. `/af-watchdog` shows readiness/checks, the
210
+ strip under chat and `/af-agents` show owner badges and detail history;
211
+ `/af-hub-report` counts evaluations/LLM attempts separately; `/af-audit`
212
+ shows read-only decision status including `judge_unavailable`. Missing usage
213
+ is unknown, not zero. A failed judge gets one live, revalidated retry after 5 s
214
+ rather than the 90 s success cooldown. Offline report code and mock tests are
215
+ not a real shadow pilot. G1 requires manual/outbound review; G2 additionally
216
+ requires independent human labels identifying the snapshot **and LLM attempt**,
217
+ held-out session evaluation and an explicit maintainer-approved profile. Older
218
+ labels without an LLM attempt ID cannot qualify. No gate is inferred from doctor readiness.
219
+
125
220
  ## The overrides file — `.ai/agent-fleet-overrides.md`
126
221
 
127
222
  Some skills and pi harnesses need facts specific to each project — where specs
@@ -220,6 +315,7 @@ targets an end-of-session compound pass writes lessons to.
220
315
  | `agent-turn-timeout-s` | tier default (600/600/1800/1800) | Whole-run deadline, in seconds, for each spawned specialist, research helper, and nested delegate child (unlike `recon-search-timeout-s`, this bounds the entire run). On expiry the run terminates as `turn_timeout` (exit 124) with partial output preserved. Positive integer or `off` (stays at the tier). |
221
316
  | `session-recycle-runs` | tier default (3/3/5/5) | Recycle a specialist's accumulated session (fresh spawn instead of `-c` resume) after this many resumed runs. Context is also always recycled at ≥60% measured context (input + cacheRead + cacheWrite). Positive integer or `off` (stays at the tier recycle count; context threshold still applies). |
222
317
  | `watchdog` | `auto` | Drift watchdog default for dispatched specialists: `auto`/`on` arm the in-flight rules (out-of-scope writes, tool-call loops, repeated failures, tool-call cap) with LLM-judge escalation; `off` disarms. Orchestrator work mode auto-arms when the setting is `auto`/`on` and ignores a dispatch `watchdog: false`. Overridable live per hub (`/af-watchdog on\|off\|auto`) and per agent (`/af-watchdog <agent> on\|off\|clear`). A DRIFTING/STUCK verdict terminates the run as `drift_stop` (exit 125) with partial output preserved. |
318
+ | `watchdog-system1` | `off` | Native specialist consumer only: `off`, `shadow`, or explicitly opted-in experimental `active` for advisory `scope` only (0.95/0.05; not G2-validated). Requires the separate selected feature and shared config; no automatic outbound request from setup/doctor. |
223
319
  | `watchdog-judge-model` | researcher persona's model | pi model spec for the one-shot drift judge (e.g. `openai-codex/gpt-5.3-codex-spark`). Falls back to the researcher persona's resolved model, then the dispatcher's. |
224
320
  | `poll-panel` | none | Default panel name for `/af-poll` when `--panel` is omitted. Must match a panel in `.pi/agents/voices.yaml` when that file exists. Missing `--panel` and missing this key is a refusal. |
225
321
  | `append-prompt` | none | Comma-separated repo-relative files appended to the system prompt of every dispatched persona. Listed files must exist. Enable the communication contract with `append-prompt: references/communication-contract.md`. |