@chankov/agent-fleet 0.0.10 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (690) hide show
  1. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  2. package/.pi/extensions/btw/README.md +29 -27
  3. package/.pi/extensions/btw/index.ts +80 -83
  4. package/.pi/extensions/pi-voice-stt/README.md +7 -3
  5. package/.pi/extensions/pi-voice-stt/config.ts +1 -1
  6. package/.pi/harnesses/agent-hub/README.md +109 -54
  7. package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
  8. package/.pi/harnesses/agent-hub/footer.ts +4 -0
  9. package/.pi/harnesses/agent-hub/helpers.ts +18 -0
  10. package/.pi/harnesses/agent-hub/index.ts +537 -369
  11. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  12. package/.pi/harnesses/agent-hub/package.json +1 -1
  13. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  14. package/.pi/harnesses/agent-hub/posture.ts +103 -0
  15. package/.pi/harnesses/ask-user-remote/README.md +37 -3
  16. package/.pi/harnesses/ask-user-remote/index.ts +173 -17
  17. package/.pi/harnesses/coms/package.json +1 -1
  18. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  19. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  20. package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  21. package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  22. package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  23. package/.pi/harnesses/lib/fleet-panel.ts +34 -0
  24. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  25. package/.pi/harnesses/lib/fleet-selection.ts +24 -0
  26. package/.pi/harnesses/package-lock.json +2011 -0
  27. package/.pi/harnesses/package.json +1 -0
  28. package/.versions/0.0.11/.pi/agents/dispatch-policy.yaml +32 -0
  29. package/.versions/0.0.11/.pi/agents/model-profiles.yaml +27 -0
  30. package/.versions/0.0.11/.pi/agents/peers.yaml +142 -0
  31. package/.versions/0.0.11/.pi/agents/teams.yaml +41 -0
  32. package/.versions/0.0.11/.pi/damage-control-rules.yaml +297 -0
  33. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  34. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  35. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  36. package/.versions/0.0.11/.pi/extensions/btw/README.md +119 -0
  37. package/.versions/0.0.11/.pi/extensions/btw/index.ts +917 -0
  38. package/.versions/0.0.11/.pi/extensions/btw/package.json +6 -0
  39. package/.versions/0.0.11/.pi/extensions/btw/state.js +179 -0
  40. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  41. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  42. package/.versions/0.0.11/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  43. package/.versions/0.0.11/.pi/extensions/compact-and-continue/README.md +42 -0
  44. package/.versions/0.0.11/.pi/extensions/compact-and-continue/index.ts +120 -0
  45. package/.versions/0.0.11/.pi/extensions/compact-and-continue/package.json +6 -0
  46. package/.versions/0.0.11/.pi/extensions/mcp-bridge/README.md +46 -0
  47. package/.versions/0.0.11/.pi/extensions/mcp-bridge/index.ts +206 -0
  48. package/.versions/0.0.11/.pi/extensions/mcp-bridge/package.json +6 -0
  49. package/.versions/0.0.11/.pi/extensions/package-lock.json +1143 -0
  50. package/.versions/0.0.11/.pi/extensions/package.json +9 -0
  51. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +205 -0
  52. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +198 -0
  53. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  54. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/index.ts +248 -0
  55. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/package.json +6 -0
  56. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  57. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  58. package/.versions/0.0.11/.pi/harnesses/agent-hub/README.md +1004 -0
  59. package/.versions/0.0.11/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  60. package/.versions/0.0.11/.pi/harnesses/agent-hub/artifacts.js +146 -0
  61. package/.versions/0.0.11/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  62. package/.versions/0.0.11/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  63. package/.versions/0.0.11/.pi/harnesses/agent-hub/context-window.js +106 -0
  64. package/.versions/0.0.11/.pi/harnesses/agent-hub/delegate.ts +435 -0
  65. package/.versions/0.0.11/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  66. package/.versions/0.0.11/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  67. package/.versions/0.0.11/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  68. package/.versions/0.0.11/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  69. package/.versions/0.0.11/.pi/harnesses/agent-hub/footer.ts +31 -0
  70. package/.versions/0.0.11/.pi/harnesses/agent-hub/helpers.ts +248 -0
  71. package/.versions/0.0.11/.pi/harnesses/agent-hub/index.ts +9111 -0
  72. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  73. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  74. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  75. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  76. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  77. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  78. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  79. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  80. package/.versions/0.0.11/.pi/harnesses/agent-hub/package.json +7 -0
  81. package/.versions/0.0.11/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  82. package/.versions/0.0.11/.pi/harnesses/agent-hub/research-retention.js +34 -0
  83. package/.versions/0.0.11/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  84. package/.versions/0.0.11/.pi/harnesses/agent-hub/return-contract.js +293 -0
  85. package/.versions/0.0.11/.pi/harnesses/agent-hub/return-extract.js +75 -0
  86. package/.versions/0.0.11/.pi/harnesses/agent-hub/review-findings.js +102 -0
  87. package/.versions/0.0.11/.pi/harnesses/agent-hub/run-budget.js +479 -0
  88. package/.versions/0.0.11/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  89. package/.versions/0.0.11/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  90. package/.versions/0.0.11/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  91. package/.versions/0.0.11/.pi/harnesses/agent-hub/session-health.js +110 -0
  92. package/.versions/0.0.11/.pi/harnesses/agent-hub/spawn.ts +354 -0
  93. package/.versions/0.0.11/.pi/harnesses/agent-hub/version.ts +42 -0
  94. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +53 -0
  95. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +477 -0
  96. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  97. package/.versions/0.0.11/.pi/harnesses/coms/README.md +100 -0
  98. package/.versions/0.0.11/.pi/harnesses/coms/index.ts +1767 -0
  99. package/.versions/0.0.11/.pi/harnesses/coms/package.json +7 -0
  100. package/.versions/0.0.11/.pi/harnesses/coms/version.ts +42 -0
  101. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/README.md +124 -0
  102. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/index.ts +536 -0
  103. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/package.json +7 -0
  104. package/.versions/0.0.11/.pi/harnesses/damage-control-continue/version.ts +42 -0
  105. package/.versions/0.0.11/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  106. package/.versions/0.0.11/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  107. package/.versions/0.0.11/.pi/harnesses/lib/herdr-client.ts +472 -0
  108. package/.versions/0.0.11/.pi/harnesses/lib/herdr-presence.ts +399 -0
  109. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  110. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  111. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  112. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  113. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  114. package/.versions/0.0.11/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  115. package/.versions/0.0.11/.pi/harnesses/lib/spawned-peers.js +190 -0
  116. package/.versions/0.0.11/.pi/harnesses/package-lock.json +2046 -0
  117. package/.versions/0.0.11/.pi/harnesses/package.json +10 -0
  118. package/.versions/0.0.11/.pi/prompts/af-build.md +24 -0
  119. package/{.claude/commands/code-simplify.md → .versions/0.0.11/.pi/prompts/af-code-simplify.md} +3 -3
  120. package/{.claude/commands/plan.md → .versions/0.0.11/.pi/prompts/af-plan.md} +1 -1
  121. package/{.claude/commands/review.md → .versions/0.0.11/.pi/prompts/af-review.md} +3 -3
  122. package/.versions/0.0.11/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  123. package/.versions/0.0.11/.pi/prompts/af-ship.md +17 -0
  124. package/{.claude/commands/spec.md → .versions/0.0.11/.pi/prompts/af-spec.md} +1 -1
  125. package/{.claude/commands/test.md → .versions/0.0.11/.pi/prompts/af-test.md} +2 -2
  126. package/.versions/0.0.11/.pi/skills/bowser/SKILL.md +145 -0
  127. package/.versions/0.0.11/.version +1 -0
  128. package/.versions/0.0.11/agents/architect.md +24 -0
  129. package/.versions/0.0.11/agents/bowser.md +27 -0
  130. package/.versions/0.0.11/agents/builder.md +54 -0
  131. package/.versions/0.0.11/agents/code-reviewer.md +208 -0
  132. package/.versions/0.0.11/agents/deep-researcher.md +32 -0
  133. package/.versions/0.0.11/agents/documenter.md +18 -0
  134. package/.versions/0.0.11/agents/orchestrator.md +72 -0
  135. package/.versions/0.0.11/agents/plan-reviewer.md +83 -0
  136. package/.versions/0.0.11/agents/planner.md +70 -0
  137. package/.versions/0.0.11/agents/releaser.md +24 -0
  138. package/.versions/0.0.11/agents/researcher.md +28 -0
  139. package/.versions/0.0.11/agents/security-auditor.md +167 -0
  140. package/.versions/0.0.11/agents/test-engineer.md +153 -0
  141. package/.versions/0.0.11/agents/web-debugger.md +43 -0
  142. package/.versions/0.0.11/agents/web-performance-auditor.md +193 -0
  143. package/.versions/0.0.11/codex/CONDUCTOR.md +148 -0
  144. package/.versions/0.0.11/docs/ARCHITECTURE.md +301 -0
  145. package/.versions/0.0.11/docs/agent-fleet-setup.md +351 -0
  146. package/.versions/0.0.11/docs/claude-code-coms-bridge.md +127 -0
  147. package/.versions/0.0.11/docs/codex-remote-conductor.md +170 -0
  148. package/.versions/0.0.11/docs/coms-hermes-bridge.md +189 -0
  149. package/.versions/0.0.11/docs/getting-started.md +43 -0
  150. package/.versions/0.0.11/docs/npm-install.md +96 -0
  151. package/.versions/0.0.11/docs/pi-extensions.md +368 -0
  152. package/.versions/0.0.11/docs/pi-setup.md +57 -0
  153. package/.versions/0.0.11/docs/skill-anatomy.md +150 -0
  154. package/.versions/0.0.11/hermes/README.md +347 -0
  155. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  156. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  157. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  158. package/.versions/0.0.11/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  159. package/.versions/0.0.11/hermes/gates/gate-o-capability.md +8 -0
  160. package/.versions/0.0.11/hermes/gates/gate-o-validator-fixtures.json +1 -0
  161. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  162. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  163. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  164. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  165. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  166. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  167. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  168. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  169. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  170. package/.versions/0.0.11/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  171. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  172. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  173. package/.versions/0.0.11/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  174. package/.versions/0.0.11/hermes/skills/hub-conductor/SKILL.md +84 -0
  175. package/.versions/0.0.11/hermes/skills/hub-liaison/SKILL.md +84 -0
  176. package/.versions/0.0.11/hermes/skills/hub-watchdog/SKILL.md +76 -0
  177. package/.versions/0.0.11/hermes/skills/hub-watchdog/manifest.json +1 -0
  178. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  179. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  180. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  181. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  182. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  183. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  184. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  185. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  186. package/.versions/0.0.11/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  187. package/.versions/0.0.11/hermes/watchdog-tests/__init__.py +0 -0
  188. package/.versions/0.0.11/hooks/coms-stop-hook.mjs +84 -0
  189. package/.versions/0.0.11/install-manifest.json +2743 -0
  190. package/.versions/0.0.11/justfile +261 -0
  191. package/.versions/0.0.11/manifest-meta.json +881 -0
  192. package/.versions/0.0.11/references/accessibility-checklist.md +160 -0
  193. package/.versions/0.0.11/references/definition-of-done.md +67 -0
  194. package/.versions/0.0.11/references/fleet-coordination-patterns.md +151 -0
  195. package/.versions/0.0.11/references/observability-checklist.md +91 -0
  196. package/.versions/0.0.11/references/orchestration-patterns.md +370 -0
  197. package/.versions/0.0.11/references/performance-checklist.md +153 -0
  198. package/.versions/0.0.11/references/prompting-patterns.md +380 -0
  199. package/.versions/0.0.11/references/security-checklist.md +179 -0
  200. package/.versions/0.0.11/references/testing-patterns.md +236 -0
  201. package/.versions/0.0.11/scripts/codex-conductor.ts +41 -0
  202. package/.versions/0.0.11/scripts/codex-remote-control.ts +167 -0
  203. package/.versions/0.0.11/scripts/coms-claude-bridge.ts +401 -0
  204. package/.versions/0.0.11/scripts/coms-cli.ts +484 -0
  205. package/.versions/0.0.11/scripts/coms-hermes-bridge.ts +413 -0
  206. package/.versions/0.0.11/scripts/fleet.ts +168 -0
  207. package/.versions/0.0.11/scripts/hermes-monitor-capability-runner.ts +25 -0
  208. package/.versions/0.0.11/scripts/hermes-monitor-scenario.ts +474 -0
  209. package/.versions/0.0.11/scripts/hermes-watchdog-capability-probe.ts +45 -0
  210. package/.versions/0.0.11/scripts/install-hermes-plugin.sh +180 -0
  211. package/.versions/0.0.11/scripts/lib/claude-bridge-core.ts +165 -0
  212. package/.versions/0.0.11/scripts/lib/codex-conductor.ts +88 -0
  213. package/.versions/0.0.11/scripts/lib/codex-remote-control.ts +480 -0
  214. package/.versions/0.0.11/scripts/lib/coms-envelope.ts +582 -0
  215. package/.versions/0.0.11/scripts/lib/fake-herdr-server.ts +88 -0
  216. package/.versions/0.0.11/scripts/lib/fleet-command.ts +119 -0
  217. package/.versions/0.0.11/scripts/lib/herdr-layout.ts +281 -0
  218. package/.versions/0.0.11/scripts/lib/hermes-bridge-core.ts +241 -0
  219. package/.versions/0.0.11/scripts/lib/hermes-monitor-events.ts +1 -0
  220. package/.versions/0.0.11/scripts/lib/hermes-monitor-herdr.ts +2 -0
  221. package/.versions/0.0.11/scripts/lib/hermes-monitor-model.ts +3 -0
  222. package/.versions/0.0.11/scripts/lib/hermes-monitor-registry.ts +2 -0
  223. package/.versions/0.0.11/scripts/lib/hermes-monitor-socket.ts +2 -0
  224. package/.versions/0.0.11/scripts/lib/hermes-monitor-store.ts +2 -0
  225. package/.versions/0.0.11/scripts/lib/monitor-env.ts +146 -0
  226. package/.versions/0.0.11/scripts/lib/peer-launch.ts +314 -0
  227. package/.versions/0.0.11/scripts/lib/persona-banner.ts +62 -0
  228. package/.versions/0.0.11/scripts/lib/spawn-stagger.ts +101 -0
  229. package/.versions/0.0.11/scripts/lib/team-project.ts +193 -0
  230. package/.versions/0.0.11/scripts/lib/team-snapshot.ts +147 -0
  231. package/.versions/0.0.11/scripts/peer-banner.ts +40 -0
  232. package/.versions/0.0.11/scripts/peer-launch.ts +259 -0
  233. package/.versions/0.0.11/scripts/team-snapshot.ts +237 -0
  234. package/.versions/0.0.11/scripts/team-up.ts +360 -0
  235. package/.versions/0.0.11/skills/_internal/grilling.md +11 -0
  236. package/.versions/0.0.11/skills/browser-testing-with-devtools/SKILL.md +351 -0
  237. package/.versions/0.0.11/skills/code-review-and-quality/SKILL.md +381 -0
  238. package/.versions/0.0.11/skills/compound-learning/SKILL.md +137 -0
  239. package/.versions/0.0.11/skills/context-engineering/SKILL.md +291 -0
  240. package/.versions/0.0.11/skills/deprecation-and-migration/SKILL.md +206 -0
  241. package/.versions/0.0.11/skills/designing-agents/SKILL.md +394 -0
  242. package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +222 -0
  243. package/.versions/0.0.11/skills/frontend-ui-engineering/SKILL.md +328 -0
  244. package/.versions/0.0.11/skills/git-workflow-and-versioning/SKILL.md +316 -0
  245. package/.versions/0.0.11/skills/idea-refine/SKILL.md +182 -0
  246. package/.versions/0.0.11/skills/idea-refine/examples.md +238 -0
  247. package/.versions/0.0.11/skills/idea-refine/frameworks.md +99 -0
  248. package/.versions/0.0.11/skills/idea-refine/refinement-criteria.md +113 -0
  249. package/.versions/0.0.11/skills/idea-refine/scripts/idea-refine.sh +15 -0
  250. package/.versions/0.0.11/skills/incremental-implementation/SKILL.md +287 -0
  251. package/.versions/0.0.11/skills/interview-me/SKILL.md +226 -0
  252. package/.versions/0.0.11/skills/orchestration-verification/SKILL.md +181 -0
  253. package/.versions/0.0.11/skills/peer-coms/SKILL.md +90 -0
  254. package/.versions/0.0.11/skills/performance-optimization/SKILL.md +350 -0
  255. package/.versions/0.0.11/skills/planning-and-task-breakdown/SKILL.md +254 -0
  256. package/.versions/0.0.11/skills/security-and-hardening/SKILL.md +461 -0
  257. package/.versions/0.0.11/skills/spec-driven-development/SKILL.md +257 -0
  258. package/.versions/0.0.11/skills/using-agent-skills/SKILL.md +199 -0
  259. package/.versions/0.0.11/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  260. package/.versions/0.0.11/vendor/agent-skills-upstream/LICENSE +21 -0
  261. package/.versions/0.0.11/vendor/agent-skills-upstream/README.md +11 -0
  262. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  263. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  264. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  265. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  266. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  267. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  268. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  269. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  270. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  271. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  272. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  273. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  274. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  275. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  276. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  277. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  278. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  279. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  280. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  281. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  282. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  283. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  284. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  285. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  286. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  287. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  288. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  289. package/.versions/0.0.11/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  290. package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  291. package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
  292. package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
  293. package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
  294. package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
  295. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  296. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  297. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  298. package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
  299. package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
  300. package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
  301. package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
  302. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  303. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  304. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  305. package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  306. package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  307. package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  308. package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  309. package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  310. package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  311. package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
  312. package/.versions/1.0.0/.pi/extensions/package.json +9 -0
  313. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  314. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  315. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  316. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  317. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  318. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  319. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  320. package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
  321. package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  322. package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  323. package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  324. package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  325. package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  326. package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
  327. package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  328. package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  329. package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  330. package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  331. package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
  332. package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  333. package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
  334. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  335. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  336. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  337. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  338. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  339. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  340. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  341. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  342. package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  343. package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  344. package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
  345. package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  346. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  347. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  348. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  349. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  350. package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  351. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
  352. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  353. package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  354. package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  355. package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  356. package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
  357. package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  358. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  359. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
  360. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  361. package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
  362. package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
  363. package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
  364. package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
  365. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  366. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  367. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  368. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  369. package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  370. package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  371. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  372. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  373. package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  374. package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  375. package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  376. package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  377. package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  378. package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  379. package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  380. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  381. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  382. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  383. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  384. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  385. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  386. package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  387. package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
  388. package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
  389. package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
  390. package/.versions/1.0.0/.pi/prompts/af-code-simplify.md +22 -0
  391. package/.versions/1.0.0/.pi/prompts/af-plan.md +16 -0
  392. package/.versions/1.0.0/.pi/prompts/af-review.md +16 -0
  393. package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  394. package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
  395. package/.versions/1.0.0/.pi/prompts/af-spec.md +15 -0
  396. package/.versions/1.0.0/.pi/prompts/af-test.md +19 -0
  397. package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
  398. package/.versions/1.0.0/.version +1 -0
  399. package/.versions/1.0.0/agents/architect.md +24 -0
  400. package/.versions/1.0.0/agents/bowser.md +27 -0
  401. package/.versions/1.0.0/agents/builder.md +54 -0
  402. package/.versions/1.0.0/agents/code-reviewer.md +208 -0
  403. package/.versions/1.0.0/agents/deep-researcher.md +32 -0
  404. package/.versions/1.0.0/agents/documenter.md +18 -0
  405. package/.versions/1.0.0/agents/orchestrator.md +72 -0
  406. package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
  407. package/.versions/1.0.0/agents/planner.md +70 -0
  408. package/.versions/1.0.0/agents/releaser.md +24 -0
  409. package/.versions/1.0.0/agents/researcher.md +28 -0
  410. package/.versions/1.0.0/agents/security-auditor.md +167 -0
  411. package/.versions/1.0.0/agents/test-engineer.md +153 -0
  412. package/.versions/1.0.0/agents/web-debugger.md +43 -0
  413. package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
  414. package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
  415. package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
  416. package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
  417. package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
  418. package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
  419. package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
  420. package/.versions/1.0.0/docs/getting-started.md +98 -0
  421. package/.versions/1.0.0/docs/npm-install.md +292 -0
  422. package/.versions/1.0.0/docs/pi-extensions.md +412 -0
  423. package/.versions/1.0.0/docs/pi-setup.md +74 -0
  424. package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
  425. package/.versions/1.0.0/hermes/README.md +347 -0
  426. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  427. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  428. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  429. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  430. package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
  431. package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  432. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  433. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  434. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  435. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  436. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  437. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  438. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  439. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  440. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  441. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  442. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  443. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  444. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  445. package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  446. package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  447. package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  448. package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  449. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  450. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  451. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  452. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  453. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  454. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  455. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  456. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  457. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  458. package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
  459. package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
  460. package/.versions/1.0.0/install-manifest.json +2745 -0
  461. package/.versions/1.0.0/justfile +272 -0
  462. package/.versions/1.0.0/manifest-meta.json +882 -0
  463. package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
  464. package/.versions/1.0.0/references/definition-of-done.md +67 -0
  465. package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
  466. package/.versions/1.0.0/references/observability-checklist.md +91 -0
  467. package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
  468. package/.versions/1.0.0/references/performance-checklist.md +153 -0
  469. package/.versions/1.0.0/references/prompting-patterns.md +380 -0
  470. package/.versions/1.0.0/references/security-checklist.md +179 -0
  471. package/.versions/1.0.0/references/testing-patterns.md +236 -0
  472. package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
  473. package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
  474. package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
  475. package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
  476. package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
  477. package/.versions/1.0.0/scripts/fleet.ts +185 -0
  478. package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  479. package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  480. package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  481. package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
  482. package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  483. package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
  484. package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
  485. package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
  486. package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  487. package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
  488. package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
  489. package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  490. package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  491. package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  492. package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  493. package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  494. package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  495. package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  496. package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
  497. package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
  498. package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
  499. package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
  500. package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
  501. package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
  502. package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
  503. package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
  504. package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
  505. package/.versions/1.0.0/scripts/team-up.ts +406 -0
  506. package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
  507. package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  508. package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  509. package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
  510. package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
  511. package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  512. package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
  513. package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  514. package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  515. package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  516. package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
  517. package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
  518. package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
  519. package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  520. package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  521. package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
  522. package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
  523. package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
  524. package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
  525. package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
  526. package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
  527. package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
  528. package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
  529. package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
  530. package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  531. package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  532. package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
  533. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  534. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  535. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  536. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  537. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  538. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  539. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  540. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  541. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  542. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  543. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  544. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  545. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  546. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  547. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  548. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  549. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  550. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  551. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  552. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  553. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  554. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  555. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  556. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  557. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  558. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  559. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  560. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  561. package/CHANGELOG.md +149 -0
  562. package/README.md +117 -79
  563. package/agents/orchestrator.md +1 -1
  564. package/{.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +2 -0
  565. package/bin/cli.js +289 -359
  566. package/bin/force-patch-changesets.js +18 -2
  567. package/bin/lib/apply.js +86 -32
  568. package/bin/lib/desired.js +87 -0
  569. package/bin/lib/detect-agent.js +22 -38
  570. package/bin/lib/doctor.js +283 -33
  571. package/bin/lib/features.js +78 -0
  572. package/bin/lib/manifest.js +127 -48
  573. package/bin/lib/overrides.js +35 -0
  574. package/bin/lib/personas.js +37 -0
  575. package/bin/lib/plan.js +18 -9
  576. package/bin/lib/purge.js +11 -0
  577. package/bin/lib/reconcile.js +68 -0
  578. package/bin/lib/scan.js +24 -0
  579. package/bin/lib/state.js +25 -1
  580. package/bin/lib/stt-wizard.js +33 -0
  581. package/bin/lib/transaction.js +149 -0
  582. package/bin/lib/tui.js +71 -0
  583. package/bin/lib/verify.js +9 -26
  584. package/bin/snapshot-version.js +3 -6
  585. package/docs/ARCHITECTURE.md +55 -21
  586. package/docs/MIGRATION-agent-fleet.md +222 -0
  587. package/docs/agent-fleet-setup.md +124 -64
  588. package/docs/claude-code-coms-bridge.md +21 -2
  589. package/docs/coms-hermes-bridge.md +1 -1
  590. package/docs/getting-started.md +61 -217
  591. package/docs/npm-install.md +207 -429
  592. package/docs/pi-extensions.md +90 -41
  593. package/docs/pi-setup.md +48 -545
  594. package/hermes/README.md +1 -1
  595. package/install-manifest.json +385 -1255
  596. package/justfile +45 -27
  597. package/manifest-meta.json +544 -134
  598. package/node_modules/pi-ask-user/README.md +43 -5
  599. package/node_modules/pi-ask-user/index.ts +630 -75
  600. package/node_modules/pi-ask-user/package.json +1 -1
  601. package/package.json +5 -11
  602. package/scripts/coms-claude-bridge.ts +10 -0
  603. package/scripts/fleet.ts +107 -90
  604. package/scripts/lib/claude-bridge-core.ts +45 -0
  605. package/scripts/lib/fleet-command.ts +170 -15
  606. package/scripts/lib/monitor-env.ts +27 -1
  607. package/scripts/lib/peer-launch.ts +6 -2
  608. package/scripts/lib/team-project.ts +24 -4
  609. package/scripts/team-up.ts +57 -11
  610. package/skills/designing-agents/SKILL.md +1 -1
  611. package/skills/designing-agents/pi-harness-authoring.md +3 -3
  612. package/.claude/commands/build.md +0 -44
  613. package/.claude/commands/design-agent.md +0 -14
  614. package/.claude/commands/doctor-agent-fleet.md +0 -22
  615. package/.claude/commands/orchestrate.md +0 -112
  616. package/.claude/commands/prime.md +0 -22
  617. package/.claude/commands/set-hermes-watchdog.md +0 -6
  618. package/.claude/commands/setup-agent-fleet.md +0 -17
  619. package/.claude/commands/ship.md +0 -72
  620. package/.claude/commands/webperf.md +0 -32
  621. package/.claude/orchestrate-teams.yaml +0 -24
  622. package/.opencode/commands/af-build.md +0 -17
  623. package/.opencode/commands/af-code-simplify.md +0 -16
  624. package/.opencode/commands/af-compound.md +0 -16
  625. package/.opencode/commands/af-design-agent.md +0 -15
  626. package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  627. package/.opencode/commands/af-orchestrate.md +0 -112
  628. package/.opencode/commands/af-plan.md +0 -16
  629. package/.opencode/commands/af-prime.md +0 -22
  630. package/.opencode/commands/af-review.md +0 -15
  631. package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  632. package/.opencode/commands/af-setup-agent-fleet.md +0 -17
  633. package/.opencode/commands/af-ship.md +0 -16
  634. package/.opencode/commands/af-spec.md +0 -16
  635. package/.opencode/commands/af-test.md +0 -21
  636. package/.opencode/commands/af-webperf.md +0 -32
  637. package/.opencode/orchestrate-teams.yaml +0 -24
  638. package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  639. package/.pi/prompts/af-setup-agent-fleet.md +0 -19
  640. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
  641. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
  642. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
  643. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  644. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
  645. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  646. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
  647. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
  648. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  649. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
  650. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
  651. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
  652. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  653. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
  654. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
  655. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
  656. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  657. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
  658. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  659. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
  660. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
  661. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
  662. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  663. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
  664. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  665. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
  666. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
  667. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
  668. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  669. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
  670. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  671. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
  672. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
  673. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  674. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
  675. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  676. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
  677. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
  678. package/bin/lib/bootstrap.js +0 -323
  679. package/bin/lib/transform-persona.js +0 -180
  680. package/docs/opencode-setup.md +0 -281
  681. package/hooks/SIMPLIFY-IGNORE.md +0 -90
  682. package/hooks/hooks.json +0 -14
  683. package/hooks/session-start.sh +0 -74
  684. package/hooks/simplify-ignore.sh +0 -302
  685. package/skills/guided-workspace-setup/SKILL.md +0 -226
  686. /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  687. /package/{.opencode/commands → .versions/0.0.11/.pi/prompts}/af-set-hermes-telegram.md +0 -0
  688. /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 0.0.11/bin/catalog/harness-runtime-closure.json} +0 -0
  689. /package/{.claude/commands/set-hermes-telegram.md → .versions/1.0.0/.pi/prompts/af-set-hermes-telegram.md} +0 -0
  690. /package/{skills/guided-workspace-setup/companion-manifest.json → .versions/1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![npm](https://img.shields.io/npm/v/%40chankov%2Fagent-fleet)](https://www.npmjs.com/package/@chankov/agent-fleet)
4
4
  [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
5
- [![runtimes](https://img.shields.io/badge/runtimes-pi%20%C2%B7%20Claude%20Code%20%C2%B7%20OpenCode-8A2BE2)](#quick-start)
5
+ [![runtime](https://img.shields.io/badge/runtime-pi-8A2BE2)](#quick-start)
6
6
  [![models](https://img.shields.io/badge/models-bring%20your%20own%20subscriptions%20%2B%20local-2ea44f)](#bring-your-own-subscriptions--and-your-own-gpus)
7
7
  [![desktop](https://img.shields.io/badge/Hermes-Desktop%20plugin-ff6a00)](#watch-the-fleet-from-your-desktop--the-hermes-plugin)
8
8
 
@@ -16,6 +16,8 @@ Three things make it unusual:
16
16
  2. **The dispatcher never drowns.** Research output, subagent dumps and specialist chatter stay *out* of the orchestrator's context window — on disk, behind file paths. [How ↓](#agent-hub-a-thin-context-dispatcher-for-pi)
17
17
  3. **You can actually see it.** Tiled panes in [herdr](https://herdr.dev), a live session panel in **Hermes Desktop**, and questions relayed to your **phone** when an agent needs a human. [How ↓](#watch-the-fleet-from-your-desktop--the-hermes-plugin)
18
18
 
19
+ > **One coding agent: pi.** Everything installs for pi and nothing else. Claude Code appears throughout this README as a **coms peer** — a real Claude pane bridged into the fleet to answer other agents' questions and run cross-model review. That is its whole role; it is not an install target. [The bridge ↓](docs/claude-code-coms-bridge.md)
20
+
19
21
  ![A herdr workspace running an Agent Fleet team: the agent-hub dispatcher pane with its full command surface on the left, six specialist peers tiled on the right, each showing live coms presence](docs/assets/fleet-workspace.png)
20
22
 
21
23
  ---
@@ -52,7 +54,7 @@ flowchart TD
52
54
 
53
55
  | Layer | Job |
54
56
  | --- | --- |
55
- | **[agent-hub](#agent-hub-a-thin-context-dispatcher-for-pi)** | Thin-context dispatcher on **pi** — drives specialists under a Verification Contract |
57
+ | **[agent-hub](#agent-hub-a-thin-context-dispatcher-for-pi)** | One **pi** runtime — direct operator work or thin-context orchestration under a Verification Contract |
56
58
  | **[herdr](https://herdr.dev)** | Fleet control plane — tiled peer workspaces, presence, snapshot/resume |
57
59
  | **coms** | Peer data plane — bidirectional messaging between agents (including Claude Code panes) |
58
60
  | **[Hermes Desktop plugin](#watch-the-fleet-from-your-desktop--the-hermes-plugin)** | Live fleet panel in the Hermes desktop app — every session, its state, what it is doing, and who is waiting on you |
@@ -64,78 +66,102 @@ flowchart TD
64
66
 
65
67
  ## Quick Start
66
68
 
67
- ### pi (primary runtime)
69
+ ### Install into a repository
70
+
71
+ From the **target repository**. The first install goes through `npx` — `just
72
+ fleet` does not exist yet, because the managed justfile region is one of the
73
+ things setup writes:
68
74
 
69
75
  ```bash
70
- pi install -l npm:@chankov/agent-fleet # project-scoped package: skills, prompts, ask-user
71
- # then, inside pi:
72
- # /af-setup-agent-fleet # guided install of harnesses, personas, extensions
73
- # and once set up:
74
- just fleet # guarded Pi + STT and core utilities
75
- just fleet hub # guarded multi-agent dispatcher
76
- just fleet team docs # hub + guarded peers in one tiled herdr workspace
76
+ cd ~/projects/my-app
77
+ npx @chankov/agent-fleet@latest setup
77
78
  ```
78
79
 
79
- ### Claude Code / OpenCode
80
+ In a real TTY that opens the installer: pick the **Default** or **Full** preset
81
+ and optional comma-separated features, read the exact reconciliation plan, then
82
+ confirm once. For automation, name the selection and consent:
80
83
 
81
84
  ```bash
82
- npx @chankov/agent-fleet init
83
- # then open your coding agent in this directory and run the command it prints:
84
- # Claude Code: /setup-agent-fleet
85
- # OpenCode: /af-setup-agent-fleet
85
+ npx @chankov/agent-fleet@latest setup --preset default --features none --yes
86
86
  ```
87
87
 
88
- The CLI detects your coding agent and prints the correct setup command. It runs the full guided install — analysing the workspace, showing grouped menus, and confirming everything before writing a single file.
88
+ **Default** is a launchable stable Fleet Core; it creates neither `.claude/` nor
89
+ voice configuration. **Full** selects all stable platform-applicable catalogue
90
+ roots and may install the recorded Claude Code coms bridge. The lifecycle
91
+ requires no coding agent or model.
89
92
 
90
- The guided flow is a front-end over the CLI — the CLI itself does every write, so a
91
- complete install needs no coding agent and no model:
93
+ Setup writes files but never runs commands, so finish with the two npm steps it
94
+ deliberately skipped — the workspace is not launchable until they run:
92
95
 
93
96
  ```bash
94
- npx @chankov/agent-fleet install --agent pi --profile recommended --yes
95
- npx @chankov/agent-fleet verify
97
+ just fleet deps # npm install in .pi/extensions and .pi/harnesses
98
+ just fleet doctor # exit 0 = nothing to repair
96
99
  ```
97
100
 
98
- | CLI command | What it does |
99
- |---|---|
100
- | `npx @chankov/agent-fleet init` | Materialize the package + hand off to the runtime's setup command |
101
- | `npx @chankov/agent-fleet install` | Install a profile (`minimal`, `recommended`, `full`, `pi-fleet-core`, `hermes-plugins`, `codex-bridge`) or explicit `--items` |
102
- | `npx @chankov/agent-fleet upgrade` | Refresh what is installed, three-way merged against your local edits |
103
- | `npx @chankov/agent-fleet uninstall` | Remove recorded artifacts (`--items` / `--all`), bound by the ownership rule |
104
- | `npx @chankov/agent-fleet verify` | Read-only report: manifest × install record × disk |
105
- | `npx @chankov/agent-fleet doctor` | Find and repair breakage (`--fix`); advisory findings listed |
106
- | `npx @chankov/agent-fleet update` | Surface the version delta + hand off to the runtime's setup command for the per-artifact diff |
107
- | `npx @chankov/agent-fleet transform-persona` | Generate per-agent subagent files from the canonical personas |
108
-
109
- Every verb takes `--dry-run`, `--json`, and `--yes`, and exits `0` ok / `1` error /
110
- `2` findings / `3` conflicts — scriptable in CI. Full reference: [docs/npm-install.md](docs/npm-install.md).
101
+ Then start a fleet:
111
102
 
112
- <details>
113
- <summary><b>Other install paths</b> — Claude Code marketplace, git clone, OpenCode details</summary>
103
+ ```bash
104
+ just fleet # Hub/operator; direct tools; empty native roster
105
+ just fleet --agents frontend # Hub/orchestrator + native specialists
106
+ just fleet --agents frontend --peers frontend --project af
107
+ # same Hub + standing peers in Herdr
108
+ ```
114
109
 
115
- **Claude Code plugin marketplace** — best UX inside Claude Code:
110
+ ### Updating
116
111
 
117
- ```
118
- /plugin marketplace add chankov/agent-fleet
119
- /plugin install agent-fleet@nc-agent-fleet
112
+ A pi session prints a banner when a newer version is published. Your preset and
113
+ features live in `.ai/agent-fleet.json`, so a plain `setup` reconciles to the
114
+ selection you already made:
115
+
116
+ ```bash
117
+ just fleet setup --dry-run # preview: what changes, what gets overwritten
118
+ just fleet setup # apply; shows the plan and asks once
119
+ just fleet deps # if the plan skipped the npm steps
120
+ just fleet doctor
120
121
  ```
121
122
 
122
- > **SSH errors?** The marketplace clones via SSH; use the HTTPS URL instead: `/plugin marketplace add https://github.com/chankov/agent-fleet.git`
123
+ > **`setup` reconciles toward the package.** A shipped artifact you edited in
124
+ > place is refreshed and your edit is overwritten — no prompt. Customize through
125
+ > `.ai/agent-fleet-overrides.md`, which no lifecycle command touches. If *both*
126
+ > you and the new version changed the same file, setup exits `3` having written
127
+ > nothing; re-run with `--on-conflict theirs` or `--on-conflict ours`.
128
+
129
+ `pi update --extensions` updates pi's own extensions only — never this installer
130
+ or what it wrote. `just fleet install` was removed; use `setup` or `deps`.
131
+
132
+ | Lifecycle command | What it does |
133
+ |---|---|
134
+ | `npx @chankov/agent-fleet setup` | Reconcile to the Default/Full desired state and named features |
135
+ | `npx @chankov/agent-fleet doctor` | Read-only diagnostics; `--fix` repairs explicit findings |
136
+ | `npx @chankov/agent-fleet uninstall --all --yes` | Remove unchanged recorded artifacts while preserving human configuration |
137
+
138
+ `just fleet setup`/`doctor`/`uninstall` are thin wrappers over
139
+ `npx @chankov/agent-fleet@latest` for a workspace that already has the justfile.
140
+ `just fleet uninstall --yes` removes its own launcher last, so reinstall
141
+ afterwards with the package CLI.
142
+
143
+ Full reference: [docs/npm-install.md](docs/npm-install.md) and the
144
+ [major-release migration matrix](docs/MIGRATION-agent-fleet.md).
145
+
146
+ <details>
147
+ <summary><b>Other install paths</b> — git clone, pi details</summary>
123
148
 
124
149
  **Git clone** — best for skill authors and contributors:
125
150
 
126
151
  ```bash
127
152
  git clone https://github.com/chankov/agent-fleet.git && cd agent-fleet
128
- claude --plugin-dir . # in Claude Code
129
- # then run /setup-agent-fleet in your target workspace
153
+ node bin/cli.js setup --workspace ~/projects/foo --preset default --features none --yes
130
154
  ```
131
155
 
132
- Artifacts install as copies; refresh them after a `git pull` with `npx agent-fleet upgrade`, which
133
- does a real three-way merge and keeps your local edits. Symlink installs exist only inside an
134
- agent-fleet checkout, where editing an artifact is meant to edit the source.
156
+ `setup` reconciles the workspace to the recorded desired state. This
157
+ `node bin/cli.js` command is for source-checkout development; use the
158
+ `npx @chankov/agent-fleet@latest setup` package command above for a new
159
+ repository. CLI selections are ephemeral over an existing
160
+ `.ai/agent-fleet.json` unless `--save-desired` is explicit. Symlink installs
161
+ exist only inside an agent-fleet checkout, where editing an artifact is meant
162
+ to edit the source.
135
163
 
136
- **OpenCode** — agent-driven skill execution via `AGENTS.md` + the `skill` tool, plus optional `af-*` slash commands (`/af-spec` … `/af-ship`, `/af-orchestrate`, `/af-compound`). See [docs/opencode-setup.md](docs/opencode-setup.md).
137
-
138
- **pi details** — the package bundles `pi-ask-user` (interactive `ask_user` + skill); lifecycle commands load from `.pi/prompts/`, always-on utility extensions from `.pi/extensions/` (mcp-bridge, chrome-devtools-mcp, compact-and-continue, pi-voice-stt push-to-talk dictation), and the selectable harnesses live under `.pi/harnesses/` (loaded via the `justfile`). See [docs/pi-setup.md](docs/pi-setup.md) and the [pi extension catalog](docs/pi-extensions.md).
164
+ **pi details** — the package bundles `pi-ask-user` (interactive `ask_user` + skill); lifecycle commands load from `.pi/prompts/`, and Fleet Core explicitly loads its deterministic utility extensions from `.pi/extensions/`. Browser and voice remain opt-in: select the setup feature, then use `just fleet --browser` or `just fleet --voice`; the selectable harnesses live under `.pi/harnesses/`. See [docs/pi-setup.md](docs/pi-setup.md) and the [pi extension catalog](docs/pi-extensions.md).
139
165
 
140
166
  </details>
141
167
 
@@ -237,7 +263,7 @@ That one command backs up `config.yaml`, symlinks **both halves** into the profi
237
263
  Then start a fleet and open the **Agent Fleet** tab:
238
264
 
239
265
  ```bash
240
- just fleet team default # monitored hub + peers; nothing extra to configure
266
+ just fleet --agents default --peers default # monitored Hub + peers; nothing extra to configure
241
267
  ```
242
268
 
243
269
  <details>
@@ -272,10 +298,10 @@ cd /path/to/agent-fleet
272
298
  just fleet conductor codex setup docs --project af # once per configured context
273
299
  just fleet conductor codex pair # interactive; never capture the code
274
300
  just fleet conductor codex start
275
- just fleet team docs --project af # hub + peers Codex can reach
301
+ just fleet --agents default --peers docs --project af # Hub + peers Codex can reach
276
302
  ```
277
303
 
278
- In ChatGPT Android, open the paired Remote Control host and use the managed external workspace at `$HOME/.local/state/agent-fleet/codex-conductor/workspace`. Do not start a local `codex` process for the Android flow, and do not also launch `just fleet conductor codex docs` when `just fleet team docs` already owns the same peers.
304
+ In ChatGPT Android, open the paired Remote Control host and use the managed external workspace at `$HOME/.local/state/agent-fleet/codex-conductor/workspace`. Do not start a local `codex` process for the Android flow, and do not also launch `just fleet conductor codex docs` when `just fleet --agents default --peers docs` already owns the same peers.
279
305
 
280
306
  Lifecycle, approval flow, examples, recovery, and security boundaries: **[Codex Remote-Control conductor runbook](docs/codex-remote-conductor.md)**.
281
307
 
@@ -285,7 +311,7 @@ Lifecycle, approval flow, examples, recovery, and security boundaries: **[Codex
285
311
 
286
312
  ## agent-hub: a thin-context dispatcher for pi
287
313
 
288
- `agent-hub` turns a single **pi** session into a **dispatcher that drives a live team of specialist subagents** — planner, builder, reviewer, test-engineer, documenter — with read-only research helpers fanning out beneath them, peer-to-peer `coms` messaging embedded, and a `damage-control-continue` guardrail on every tool call.
314
+ Every public Pi Fleet session is now one `agent-hub` runtime with two postures. Bare `just fleet` starts in **operator** posture: direct `read`/`bash`/`edit`/`write`, orchestration tools, embedded `coms`, and an empty native roster. **Orchestrator** posture removes direct coding tools and drives specialist subagents — planner, builder, reviewer, test-engineer, documenter — under the Verification Contract. Both postures keep the same Hub commands, research helpers, peer collaboration, and `damage-control-continue` guardrails.
289
315
 
290
316
  ![The agent-hub dispatcher fanning one request out to six peers over coms and awaiting each reply, with every peer's presence dashboard beside it](docs/assets/agent-hub-dispatch.png)
291
317
 
@@ -298,16 +324,27 @@ What makes it different is what it **doesn't** put in front of the dispatcher LL
298
324
  ![agent-hub's dashboard view: specialists and read-only research helpers running in parallel, each with its own model, spend and status](docs/assets/agent-hub-dashboard.png)
299
325
 
300
326
  ```bash
301
- just fleet hub # guarded dispatcher + research + coms + orchestrator persona
302
- just fleet hub --solo # same, without the coms layer
303
-
304
- # fleet recipes (need a running herdr server — https://herdr.dev)
305
- just fleet team full --no-hub # guarded addressable peers in a tiled workspace
306
- just fleet team docs # hub + guarded peers in ONE workspace
307
- just fleet down docs # snapshot + close cleanly
308
- just fleet resume docs # rebuild the grid; pi peers continue their conversations
327
+ just fleet # operator; empty native roster
328
+ just fleet --agents frontend # native roster; orchestrator inferred
329
+ just fleet --posture operator --agents frontend # direct work plus the same roster
330
+ just fleet --no-coms # direct/native work; no peer messaging
331
+
332
+ # live posture and roster changes preserve the session
333
+ /af-agents-add code-reviewer
334
+ /af-posture orchestrator
335
+ /af-posture operator
336
+
337
+ # Herdr topology (requires a running server — https://herdr.dev)
338
+ just fleet --herdr --project af
339
+ just fleet --agents frontend --peers frontend --project af
309
340
  ```
310
341
 
342
+ Native specialists are local headless Pi subprocesses; standing peers are separate Pi or Claude Code processes in sibling Herdr panes. They can share a name without ambiguity: `dispatch_agent(..., backend: "native")` always starts the local Pi specialist, `backend: "coms"` requires the live peer, and `backend: "auto"` follows `.pi/agents/dispatch-policy.yaml`.
343
+
344
+ From a Hub pane, add a declared Claude reviewer with `herdr_spawn_peer({ name: "code-reviewer" })`, then use `coms_send` + `coms_await`; the peer is locked to the Hub's project. `/af-handoff code-reviewer` works in either posture when that peer is visible in the coms pool. Herdr operations require a live Herdr server; peer messaging/handoff require coms readiness. All Hub slash commands remain registered in both postures and unavailable capabilities refuse with remediation instead of disappearing.
345
+
346
+ Compatibility forms (`just fleet hub`, `just fleet team <preset>`, and `--solo`) remain accepted during migration and print canonical replacements; use `--no-coms` instead of `--solo`.
347
+
311
348
  Deep dive: [agent-hub harness README](.pi/harnesses/agent-hub/README.md) (the full dispatch loop, coms layer, configuration) · [fleet hierarchy](docs/ARCHITECTURE.md#fleet-hierarchy) · [pi extension catalog](docs/pi-extensions.md) · [Claude Code coms bridge](docs/claude-code-coms-bridge.md) · [Hermes bridge](docs/coms-hermes-bridge.md).
312
349
 
313
350
  ---
@@ -323,20 +360,20 @@ Deep dive: [agent-hub harness README](.pi/harnesses/agent-hub/README.md) (the fu
323
360
  spec plan build test review ship
324
361
  ```
325
362
 
326
- 10 slash commands map to the development lifecycle; each activates the right skills automatically. **Claude Code uses the unprefixed form; Pi and OpenCode use `/af-*`.**
327
-
328
- | What you're doing | Claude Code | Pi / OpenCode | Key principle |
329
- |-------------------|-------------|---------------|---------------|
330
- | Define what to build | `/spec` | `/af-spec` | Spec before code |
331
- | Plan how to build it | `/plan` | `/af-plan` | Small, atomic tasks |
332
- | Build incrementally | `/build` | `/af-build` | One slice at a time (`auto` runs the whole plan in one approved pass) |
333
- | Prove it works | `/test` | `/af-test` | Tests are proof |
334
- | Review before merge | `/review` | `/af-review` | Improve code health |
335
- | Audit web performance | `/webperf` | `/af-webperf` *(OpenCode)* | Measure before you optimize |
336
- | Simplify the code | `/code-simplify` | `/af-code-simplify` | Clarity over cleverness |
337
- | Ship to production | `/ship` | `/af-ship` | Faster is safer |
338
- | Orchestrate a team | `/orchestrate` | `/af-orchestrate` *(OpenCode; Pi uses agent-hub)* | Main session drives a config-defined roster |
339
- | Capture session lessons | `/compound` | `/af-compound` | Every session improves the next |
363
+ Slash commands map to the development lifecycle; each activates the right skills automatically. They install into `.pi/prompts/` under the `/af-*` namespace, so they never collide with a command your workspace already defines.
364
+
365
+ | What you're doing | Command | Key principle |
366
+ |-------------------|---------|---------------|
367
+ | Define what to build | `/af-spec` | Spec before code |
368
+ | Plan how to build it | `/af-plan` | Small, atomic tasks |
369
+ | Build incrementally | `/af-build` | One slice at a time (`auto` runs the whole plan in one approved pass) |
370
+ | Prove it works | `/af-test` | Tests are proof |
371
+ | Review before merge | `/af-review` | Improve code health |
372
+ | Audit web performance | *invoke the `web-performance-auditor` persona* | Measure before you optimize |
373
+ | Simplify the code | `/af-code-simplify` | Clarity over cleverness |
374
+ | Ship to production | `/af-ship` | Faster is safer |
375
+ | Orchestrate a team | *agent-hub harness* | The hub drives a config-defined roster |
376
+ | Capture session lessons | `/af-compound` *(agent-hub)* | Every session improves the next |
340
377
 
341
378
  Under the hood are **29 skills** — each a structured workflow with steps, verification gates, and anti-rationalization tables (never vague advice). Skills also activate automatically from what you're doing: designing an API triggers `api-and-interface-design`, building UI triggers `frontend-ui-engineering`.
342
379
 
@@ -347,7 +384,9 @@ Under the hood are **29 skills** — each a structured workflow with steps, veri
347
384
  - **Review:** [code-review-and-quality](skills/code-review-and-quality/SKILL.md) · [code-simplification](vendor/agent-skills-upstream/skills/code-simplification/SKILL.md) · [security-and-hardening](skills/security-and-hardening/SKILL.md) · [performance-optimization](skills/performance-optimization/SKILL.md)
348
385
  - **Ship:** [git-workflow-and-versioning](skills/git-workflow-and-versioning/SKILL.md) · [ci-cd-and-automation](vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md) · [deprecation-and-migration](skills/deprecation-and-migration/SKILL.md) · [documentation-and-adrs](vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md) · [observability-and-instrumentation](vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md) · [shipping-and-launch](vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md)
349
386
  - **Orchestrate:** [orchestration-verification](skills/orchestration-verification/SKILL.md) · [peer-coms](skills/peer-coms/SKILL.md)
350
- - **Learn:** [compound-learning](skills/compound-learning/SKILL.md) · **Onboard:** [guided-workspace-setup](skills/guided-workspace-setup/SKILL.md) · **Meta:** [using-agent-skills](skills/using-agent-skills/SKILL.md) · [designing-agents](skills/designing-agents/SKILL.md)
387
+ - **Learn:** [compound-learning](skills/compound-learning/SKILL.md) · **Meta:** [using-agent-skills](skills/using-agent-skills/SKILL.md) · [designing-agents](skills/designing-agents/SKILL.md)
388
+
389
+ Workspace onboarding uses the deterministic `setup`, `doctor`, and `uninstall` CLI lifecycle.
351
390
 
352
391
  Full catalog with descriptions and triggers: **[docs/skills-catalog.md](docs/skills-catalog.md)**. Format spec: [docs/skill-anatomy.md](docs/skill-anatomy.md).
353
392
 
@@ -357,7 +396,7 @@ Full catalog with descriptions and triggers: **[docs/skills-catalog.md](docs/ski
357
396
 
358
397
  15 pre-configured specialist personas live in [`agents/`](agents/) — reusable subagent definitions your coding agent delegates work to: `planner`, `plan-reviewer`, `builder`, `code-reviewer`, `test-engineer`, `security-auditor`, `web-performance-auditor`, `documenter`, `architect`, `releaser`, `researcher`, `deep-researcher`, plus the pi-only `bowser`, `web-debugger`, and `orchestrator`.
359
398
 
360
- Each persona is one Markdown file; the canonical format is pi-flavored and the runtime's Agent Fleet setup command transforms it per target agent on install (Claude Code subagents, OpenCode `mode: subagent`, pi as-is). Personas are the *who*, skills are the *how* — each carries a conditional hook to its primary skill, and they compose into teams under the hub or via `/orchestrate`.
399
+ Each persona is one Markdown file in pi's own frontmatter dialect, installed verbatim — there is no per-agent translation step. Personas are the *who*, skills are the *how* — each carries a conditional hook to its primary skill, and they compose into teams under the hub.
361
400
 
362
401
  Full roster, skill hooks, install matrix, and team composition: **[docs/agents.md](docs/agents.md)**.
363
402
 
@@ -382,18 +421,17 @@ Discipline is the other half. AI coding agents default to the shortest path —
382
421
  | [docs/skills-catalog.md](docs/skills-catalog.md) | All 29 skills with descriptions and triggers |
383
422
  | [docs/agents.md](docs/agents.md) | All 15 personas: roster, skill hooks, install matrix, teams |
384
423
  | [docs/pi-setup.md](docs/pi-setup.md) · [docs/pi-extensions.md](docs/pi-extensions.md) | pi install paths, harnesses, and utility extensions |
385
- | [docs/opencode-setup.md](docs/opencode-setup.md) | OpenCode setup and `af-*` commands |
386
424
  | [docs/agent-fleet-setup.md](docs/agent-fleet-setup.md) | Per-project overrides (`.ai/agent-fleet-overrides.md`) — spec/plan paths, dev server, branch policy, per-persona models, dispatcher language, rules/docs targets |
387
425
  | **[docs/hermes-desktop-plugins.md](docs/hermes-desktop-plugins.md)** | **The Hermes Desktop plugin: install, contract, API, failure modes, limits** |
388
426
  | [docs/claude-code-coms-bridge.md](docs/claude-code-coms-bridge.md) · [docs/coms-hermes-bridge.md](docs/coms-hermes-bridge.md) · [docs/codex-remote-conductor.md](docs/codex-remote-conductor.md) | Claude Code as a coms peer · phone relay · experimental Codex remote-control operator runbook |
389
427
  | [docs/npm-install.md](docs/npm-install.md) | CLI reference, versioning, update flow |
390
- | [references/](references/) | 9 checklists skills pull in: testing, security, performance, accessibility, observability, orchestration + fleet-coordination + prompting patterns |
428
+ | [references/](references/) | 9 checklists skills pull in: testing, security, performance, accessibility, observability, orchestration + fleet-coordination + prompting patterns. Each installs automatically alongside the skills that cite it |
391
429
 
392
430
  ---
393
431
 
394
432
  ## Credits & origins
395
433
 
396
- Agent Fleet started as a customized fork of [Addy Osmani](https://github.com/addyosmani)'s [`agent-skills`](https://github.com/addyosmani/agent-skills) library, with pi session-harness patterns from [IndyDevDan](https://github.com/disler)'s [`pi-vs-claude-code`](https://github.com/disler/pi-vs-claude-code) (MIT) growing alongside it. As orchestration became the center of gravity, it split into a standalone project — with the upstream relationship kept honest: Addy's library is vendored **pristine at a pinned SHA** under [`vendor/agent-skills-upstream/`](vendor/agent-skills-upstream/) ([policy](docs/UPSTREAM-SKILLS.md)), and the ported harnesses credit their origin in [docs/pi-extensions.md](docs/pi-extensions.md). Split record: [docs/MIGRATION-agent-fleet.md](docs/MIGRATION-agent-fleet.md).
434
+ Agent Fleet started as a customized fork of [Addy Osmani](https://github.com/addyosmani)'s [`agent-skills`](https://github.com/addyosmani/agent-skills) library, with pi session-harness patterns from [IndyDevDan](https://github.com/disler)'s [`pi-vs-claude-code`](https://github.com/disler/pi-vs-claude-code) (MIT) growing alongside it. As orchestration became the center of gravity, it split into a standalone project — with the upstream relationship kept honest: Addy's library is vendored **pristine at a pinned SHA** under [`vendor/agent-skills-upstream/`](vendor/agent-skills-upstream/) ([policy](docs/UPSTREAM-SKILLS.md)), and the ported harnesses credit their origin in [docs/pi-extensions.md](docs/pi-extensions.md).
397
435
 
398
436
  | Person | Handle | What we draw from |
399
437
  | --- | --- | --- |
@@ -27,7 +27,7 @@ Before any non-trivial work, read `skills/orchestration-verification/SKILL.md`
27
27
  - **Require runtime proof for UI assertions.** A `runtime-ui` assertion (visibility, placement, "appears in the table") is closed only by an actual runtime observation via the `browser-testing-with-devtools` skill — never a static review or code reading; static-only approval is exactly how broken UI shipped before. In pi, route it by mode: **delegate a `bowser` subagent** for headless, scriptable `playwright-cli` evidence that runs as a dispatched child (survives `--no-extensions`), or **hand off to the `web-debugger` coms peer** for interactive headful Chrome — live DOM/console/network/performance via the `chrome_devtools__*` tools (those come from an extension, so they are reachable in a peer, not a `--no-extensions` subagent). Either path must save DOM/screenshot/network evidence under `.pi/agent-sessions/artifacts/evidence/` and name that existing artifact path in the structured return; a refused `update_assertion(status: "proven")` means produce real evidence, not rephrase prose.
28
28
  - **Accept only structured returns.** Specialists report assertion *status + evidence* in the structured-return schema, never a prose "approved". Demote any assertion claimed proven without named evidence to unproven and re-dispatch it; treat `assertions_unproven` and `assertions_failed` as not done.
29
29
  - **Reset on "wrong again".** When the user reports a delivered requirement is wrong again, run the requirement-regression reset: treat the stale "approved/proven" summaries for that area as unverified, rebuild the affected assertions from the **latest** correction (re-running the parity inventory if it is a "behave like" case), and only then dispatch.
30
- - **Use bounded read-only powers.** Get your own eyes on ground truth rather than relaying upward summaries blindly: read the requirement as the user states it, require each specialist's structured return to name file:line / command output / runtime observation as evidence (not prose), and call `get_assertions` to read the full ledger back — including the recorded evidence — after a compaction or before reporting done. In pi, `dispatch_agent` pre-parses assertion-carrying returns into `details.structuredReturn`, writes the raw return to `details.returnPath`, and flags evidence-less proven claims in `details.contractNotices`; use the digest first — NEVER spawn a research helper just to read a return artifact whose digest and path you already hold. When you need to inspect the diff or code yourself and the digest is genuinely insufficient, `spawn_research` a read-only helper rather than trusting a summary. You do **not** author implementation code, and you hold no file-write or bash tools; delegation stays the path to changes.
30
+ - **Respect the active Hub posture.** In **orchestrator posture**, use bounded read-only powers: require each specialist's structured return to name file:line / command output / runtime observation as evidence (not prose), call `get_assertions` after compaction, and use `spawn_research` only when a digest/path is genuinely insufficient; you do not author implementation code and delegation stays the path to changes. In **operator posture**, the Hub explicitly grants direct coding tools: you may inspect and implement directly, while still using the Verification Contract and delegating when specialization or independent verification adds value. The active Hub posture and generated system prompt are authoritative over this persona's tool assumptions.
31
31
 
32
32
  ## Operating posture (correctness within budget)
33
33
 
@@ -18,6 +18,7 @@
18
18
  "scripts/coms-hermes-bridge.ts",
19
19
  "scripts/fleet.ts",
20
20
  "scripts/peer-banner.ts",
21
+ "scripts/peer-launch.ts",
21
22
  "scripts/team-snapshot.ts",
22
23
  "scripts/team-up.ts",
23
24
  "scripts/lib/claude-bridge-core.ts",
@@ -28,6 +29,7 @@
28
29
  "scripts/lib/herdr-layout.ts",
29
30
  "scripts/lib/hermes-bridge-core.ts",
30
31
  "scripts/lib/monitor-env.ts",
32
+ "scripts/lib/peer-launch.ts",
31
33
  "scripts/lib/persona-banner.ts",
32
34
  "scripts/lib/spawn-stagger.ts",
33
35
  "scripts/lib/team-project.ts",