@chankov/agent-fleet 0.0.11 → 1.0.1

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 (771) hide show
  1. package/.pi/agents/model-profiles.yaml +2 -2
  2. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  3. package/.pi/extensions/btw/README.md +26 -25
  4. package/.pi/extensions/btw/index.ts +80 -83
  5. package/.pi/extensions/pi-voice-stt/README.md +4 -3
  6. package/.pi/extensions/pi-voice-stt/config.ts +1 -1
  7. package/.pi/harnesses/agent-hub/README.md +118 -57
  8. package/.pi/harnesses/agent-hub/backend-policy.js +25 -4
  9. package/.pi/harnesses/agent-hub/footer.ts +4 -0
  10. package/.pi/harnesses/agent-hub/helpers.ts +18 -0
  11. package/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  12. package/.pi/harnesses/agent-hub/index.ts +657 -425
  13. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  14. package/.pi/harnesses/agent-hub/package.json +1 -1
  15. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  16. package/.pi/harnesses/agent-hub/posture.ts +103 -0
  17. package/.pi/harnesses/agent-hub/run-budget.js +61 -0
  18. package/.pi/harnesses/ask-user-remote/README.md +37 -3
  19. package/.pi/harnesses/ask-user-remote/index.ts +173 -17
  20. package/.pi/harnesses/coms/package.json +1 -1
  21. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  22. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  23. package/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  24. package/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  25. package/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  26. package/.pi/harnesses/lib/fleet-panel.ts +34 -0
  27. package/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  28. package/.pi/harnesses/lib/fleet-selection.ts +24 -0
  29. package/.pi/harnesses/package-lock.json +2011 -0
  30. package/.pi/harnesses/package.json +1 -0
  31. package/.versions/0.0.11/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  32. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +4 -3
  33. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +1 -1
  34. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  35. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +37 -3
  36. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +173 -17
  37. package/.versions/0.0.11/.pi/harnesses/package-lock.json +2011 -0
  38. package/.versions/0.0.11/.pi/harnesses/package.json +1 -0
  39. package/.versions/0.0.11/docs/ARCHITECTURE.md +6 -8
  40. package/.versions/0.0.11/docs/agent-fleet-setup.md +17 -43
  41. package/.versions/0.0.11/docs/claude-code-coms-bridge.md +20 -2
  42. package/.versions/0.0.11/docs/coms-hermes-bridge.md +1 -1
  43. package/.versions/0.0.11/docs/getting-started.md +26 -237
  44. package/.versions/0.0.11/docs/npm-install.md +60 -478
  45. package/.versions/0.0.11/docs/pi-extensions.md +4 -4
  46. package/.versions/0.0.11/docs/pi-setup.md +37 -551
  47. package/.versions/0.0.11/hermes/README.md +1 -1
  48. package/.versions/0.0.11/install-manifest.json +375 -1247
  49. package/.versions/0.0.11/justfile +13 -6
  50. package/.versions/0.0.11/manifest-meta.json +543 -134
  51. package/.versions/0.0.11/scripts/lib/fleet-command.ts +8 -0
  52. package/.versions/0.0.11/scripts/lib/monitor-env.ts +18 -6
  53. package/.versions/0.0.11/skills/designing-agents/SKILL.md +1 -1
  54. package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +1 -1
  55. package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  56. package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
  57. package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
  58. package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
  59. package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
  60. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  61. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  62. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  63. package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
  64. package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
  65. package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
  66. package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
  67. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  68. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  69. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  70. package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  71. package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  72. package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  73. package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  74. package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  75. package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  76. package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
  77. package/.versions/1.0.0/.pi/extensions/package.json +9 -0
  78. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  79. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  80. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  81. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  82. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  83. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  84. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  85. package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
  86. package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  87. package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  88. package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  89. package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  90. package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  91. package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
  92. package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  93. package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  94. package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  95. package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  96. package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
  97. package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  98. package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
  99. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  100. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  101. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  102. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  103. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  104. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  105. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  106. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  107. package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  108. package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  109. package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
  110. package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  111. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  112. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  113. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  114. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  115. package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  116. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
  117. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  118. package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  119. package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  120. package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  121. package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
  122. package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  123. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  124. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
  125. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  126. package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
  127. package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
  128. package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
  129. package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
  130. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  131. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  132. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  133. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  134. package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  135. package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  136. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  137. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  138. package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  139. package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  140. package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  141. package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  142. package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  143. package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  144. package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  145. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  146. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  147. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  148. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  149. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  150. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  151. package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  152. package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
  153. package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
  154. package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
  155. package/{.claude/commands/code-simplify.md → .versions/1.0.0/.pi/prompts/af-code-simplify.md} +3 -3
  156. package/{.claude/commands/plan.md → .versions/1.0.0/.pi/prompts/af-plan.md} +1 -1
  157. package/.versions/{0.0.11/.claude/commands/review.md → 1.0.0/.pi/prompts/af-review.md} +3 -3
  158. package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  159. package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
  160. package/.versions/{0.0.11/.claude/commands/spec.md → 1.0.0/.pi/prompts/af-spec.md} +1 -1
  161. package/.versions/{0.0.11/.claude/commands/test.md → 1.0.0/.pi/prompts/af-test.md} +2 -2
  162. package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
  163. package/.versions/1.0.0/.version +1 -0
  164. package/.versions/1.0.0/agents/architect.md +24 -0
  165. package/.versions/1.0.0/agents/bowser.md +27 -0
  166. package/.versions/1.0.0/agents/builder.md +54 -0
  167. package/.versions/1.0.0/agents/code-reviewer.md +208 -0
  168. package/.versions/1.0.0/agents/deep-researcher.md +32 -0
  169. package/.versions/1.0.0/agents/documenter.md +18 -0
  170. package/.versions/1.0.0/agents/orchestrator.md +72 -0
  171. package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
  172. package/.versions/1.0.0/agents/planner.md +70 -0
  173. package/.versions/1.0.0/agents/releaser.md +24 -0
  174. package/.versions/1.0.0/agents/researcher.md +28 -0
  175. package/.versions/1.0.0/agents/security-auditor.md +167 -0
  176. package/.versions/1.0.0/agents/test-engineer.md +153 -0
  177. package/.versions/1.0.0/agents/web-debugger.md +43 -0
  178. package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
  179. package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
  180. package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
  181. package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
  182. package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
  183. package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
  184. package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
  185. package/.versions/1.0.0/docs/getting-started.md +98 -0
  186. package/.versions/1.0.0/docs/npm-install.md +292 -0
  187. package/.versions/1.0.0/docs/pi-extensions.md +412 -0
  188. package/.versions/1.0.0/docs/pi-setup.md +74 -0
  189. package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
  190. package/.versions/1.0.0/hermes/README.md +347 -0
  191. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  192. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  193. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  194. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  195. package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
  196. package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  197. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  198. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  199. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  200. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  201. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  202. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  203. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  204. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  205. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  206. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  207. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  208. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  209. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  210. package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  211. package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  212. package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  213. package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  214. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  215. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  216. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  217. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  218. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  219. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  220. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  221. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  222. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  223. package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
  224. package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
  225. package/.versions/1.0.0/install-manifest.json +2745 -0
  226. package/.versions/1.0.0/justfile +272 -0
  227. package/.versions/1.0.0/manifest-meta.json +882 -0
  228. package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
  229. package/.versions/1.0.0/references/definition-of-done.md +67 -0
  230. package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
  231. package/.versions/1.0.0/references/observability-checklist.md +91 -0
  232. package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
  233. package/.versions/1.0.0/references/performance-checklist.md +153 -0
  234. package/.versions/1.0.0/references/prompting-patterns.md +380 -0
  235. package/.versions/1.0.0/references/security-checklist.md +179 -0
  236. package/.versions/1.0.0/references/testing-patterns.md +236 -0
  237. package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
  238. package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
  239. package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
  240. package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
  241. package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
  242. package/.versions/1.0.0/scripts/fleet.ts +185 -0
  243. package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  244. package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  245. package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  246. package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
  247. package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  248. package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
  249. package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
  250. package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
  251. package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  252. package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
  253. package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
  254. package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  255. package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  256. package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  257. package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  258. package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  259. package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  260. package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  261. package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
  262. package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
  263. package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
  264. package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
  265. package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
  266. package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
  267. package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
  268. package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
  269. package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
  270. package/.versions/1.0.0/scripts/team-up.ts +406 -0
  271. package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
  272. package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  273. package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  274. package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
  275. package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
  276. package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  277. package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
  278. package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  279. package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  280. package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  281. package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
  282. package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
  283. package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
  284. package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  285. package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  286. package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
  287. package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
  288. package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
  289. package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
  290. package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
  291. package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
  292. package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
  293. package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
  294. package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
  295. package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  296. package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  297. package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
  298. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  299. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  300. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  301. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  302. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  303. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  304. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  305. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  306. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  307. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  308. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  309. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  310. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  311. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  312. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  313. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  314. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  315. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  316. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  317. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  318. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  319. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  320. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  321. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  322. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  323. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  324. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  325. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  326. package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  327. package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
  328. package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
  329. package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
  330. package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
  331. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  332. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  333. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  334. package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
  335. package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
  336. package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
  337. package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
  338. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  339. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  340. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  341. package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  342. package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  343. package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  344. package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  345. package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  346. package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  347. package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
  348. package/.versions/1.0.1/.pi/extensions/package.json +9 -0
  349. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  350. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  351. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  352. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  353. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  354. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  355. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  356. package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
  357. package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  358. package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  359. package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  360. package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  361. package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  362. package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
  363. package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  364. package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  365. package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  366. package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  367. package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
  368. package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  369. package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  370. package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
  371. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  372. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  373. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  374. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  375. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  376. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  377. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  378. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  379. package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  380. package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  381. package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
  382. package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  383. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  384. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  385. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  386. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  387. package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  388. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
  389. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  390. package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  391. package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  392. package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  393. package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
  394. package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  395. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  396. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
  397. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  398. package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
  399. package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
  400. package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
  401. package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
  402. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  403. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  404. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  405. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  406. package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  407. package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  408. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  409. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  410. package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  411. package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  412. package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  413. package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  414. package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  415. package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  416. package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  417. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  418. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  419. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  420. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  421. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  422. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  423. package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  424. package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
  425. package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
  426. package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
  427. package/.versions/{0.0.11/.claude/commands/code-simplify.md → 1.0.1/.pi/prompts/af-code-simplify.md} +3 -3
  428. package/.versions/{0.0.11/.claude/commands/plan.md → 1.0.1/.pi/prompts/af-plan.md} +1 -1
  429. package/{.claude/commands/review.md → .versions/1.0.1/.pi/prompts/af-review.md} +3 -3
  430. package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  431. package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
  432. package/{.claude/commands/spec.md → .versions/1.0.1/.pi/prompts/af-spec.md} +1 -1
  433. package/{.claude/commands/test.md → .versions/1.0.1/.pi/prompts/af-test.md} +2 -2
  434. package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
  435. package/.versions/1.0.1/.version +1 -0
  436. package/.versions/1.0.1/agents/architect.md +24 -0
  437. package/.versions/1.0.1/agents/bowser.md +27 -0
  438. package/.versions/1.0.1/agents/builder.md +54 -0
  439. package/.versions/1.0.1/agents/code-reviewer.md +208 -0
  440. package/.versions/1.0.1/agents/deep-researcher.md +32 -0
  441. package/.versions/1.0.1/agents/documenter.md +18 -0
  442. package/.versions/1.0.1/agents/orchestrator.md +72 -0
  443. package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
  444. package/.versions/1.0.1/agents/planner.md +70 -0
  445. package/.versions/1.0.1/agents/releaser.md +24 -0
  446. package/.versions/1.0.1/agents/researcher.md +28 -0
  447. package/.versions/1.0.1/agents/security-auditor.md +167 -0
  448. package/.versions/1.0.1/agents/test-engineer.md +153 -0
  449. package/.versions/1.0.1/agents/web-debugger.md +43 -0
  450. package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
  451. package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
  452. package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
  453. package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
  454. package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
  455. package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
  456. package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
  457. package/.versions/1.0.1/docs/getting-started.md +98 -0
  458. package/.versions/1.0.1/docs/npm-install.md +292 -0
  459. package/.versions/1.0.1/docs/pi-extensions.md +412 -0
  460. package/.versions/1.0.1/docs/pi-setup.md +74 -0
  461. package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
  462. package/.versions/1.0.1/hermes/README.md +347 -0
  463. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  464. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  465. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  466. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  467. package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
  468. package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  469. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  470. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  471. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  472. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  473. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  474. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  475. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  476. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  477. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  478. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  479. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  480. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  481. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  482. package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  483. package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  484. package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  485. package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  486. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  487. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  488. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  489. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  490. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  491. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  492. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  493. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  494. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  495. package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
  496. package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
  497. package/.versions/1.0.1/install-manifest.json +2745 -0
  498. package/.versions/1.0.1/justfile +272 -0
  499. package/.versions/1.0.1/manifest-meta.json +882 -0
  500. package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
  501. package/.versions/1.0.1/references/definition-of-done.md +67 -0
  502. package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
  503. package/.versions/1.0.1/references/observability-checklist.md +91 -0
  504. package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
  505. package/.versions/1.0.1/references/performance-checklist.md +153 -0
  506. package/.versions/1.0.1/references/prompting-patterns.md +380 -0
  507. package/.versions/1.0.1/references/security-checklist.md +179 -0
  508. package/.versions/1.0.1/references/testing-patterns.md +236 -0
  509. package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
  510. package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
  511. package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
  512. package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
  513. package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
  514. package/.versions/1.0.1/scripts/fleet.ts +185 -0
  515. package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  516. package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  517. package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  518. package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
  519. package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  520. package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
  521. package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
  522. package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
  523. package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  524. package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
  525. package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
  526. package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  527. package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  528. package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  529. package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  530. package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  531. package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  532. package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  533. package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
  534. package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
  535. package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
  536. package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
  537. package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
  538. package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
  539. package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
  540. package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
  541. package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
  542. package/.versions/1.0.1/scripts/team-up.ts +406 -0
  543. package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
  544. package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  545. package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  546. package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
  547. package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
  548. package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  549. package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
  550. package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  551. package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  552. package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  553. package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
  554. package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
  555. package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
  556. package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  557. package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  558. package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
  559. package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
  560. package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
  561. package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
  562. package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
  563. package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
  564. package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
  565. package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
  566. package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
  567. package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  568. package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  569. package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
  570. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  571. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  572. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  573. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  574. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  575. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  576. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  577. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  578. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  579. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  580. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  581. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  582. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  583. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  584. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  585. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  586. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  587. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  588. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  589. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  590. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  591. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  592. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  593. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  594. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  595. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  596. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  597. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  598. package/CHANGELOG.md +148 -0
  599. package/README.md +117 -79
  600. package/agents/code-reviewer.md +1 -1
  601. package/agents/deep-researcher.md +1 -1
  602. package/agents/orchestrator.md +1 -1
  603. package/agents/plan-reviewer.md +1 -1
  604. package/agents/planner.md +1 -1
  605. package/agents/security-auditor.md +1 -1
  606. package/agents/test-engineer.md +1 -1
  607. package/bin/catalog/harness-runtime-closure.json +38 -0
  608. package/bin/cli.js +289 -359
  609. package/bin/force-patch-changesets.js +18 -2
  610. package/bin/lib/apply.js +86 -32
  611. package/bin/lib/desired.js +87 -0
  612. package/bin/lib/detect-agent.js +22 -38
  613. package/bin/lib/doctor.js +283 -33
  614. package/bin/lib/features.js +78 -0
  615. package/bin/lib/manifest.js +127 -48
  616. package/bin/lib/overrides.js +35 -0
  617. package/bin/lib/personas.js +37 -0
  618. package/bin/lib/plan.js +18 -9
  619. package/bin/lib/purge.js +11 -0
  620. package/bin/lib/reconcile.js +68 -0
  621. package/bin/lib/scan.js +24 -0
  622. package/bin/lib/state.js +25 -1
  623. package/bin/lib/stt-wizard.js +33 -0
  624. package/bin/lib/transaction.js +149 -0
  625. package/bin/lib/tui.js +71 -0
  626. package/bin/lib/verify.js +9 -26
  627. package/bin/snapshot-version.js +3 -6
  628. package/docs/ARCHITECTURE.md +55 -21
  629. package/docs/MIGRATION-agent-fleet.md +222 -0
  630. package/docs/agent-fleet-setup.md +124 -64
  631. package/docs/claude-code-coms-bridge.md +21 -2
  632. package/docs/coms-hermes-bridge.md +1 -1
  633. package/docs/getting-started.md +61 -217
  634. package/docs/npm-install.md +207 -429
  635. package/docs/pi-extensions.md +85 -41
  636. package/docs/pi-setup.md +48 -545
  637. package/hermes/README.md +1 -1
  638. package/install-manifest.json +385 -1255
  639. package/justfile +45 -27
  640. package/manifest-meta.json +544 -134
  641. package/node_modules/pi-ask-user/README.md +43 -5
  642. package/node_modules/pi-ask-user/index.ts +630 -75
  643. package/node_modules/pi-ask-user/package.json +1 -1
  644. package/package.json +5 -11
  645. package/scripts/coms-claude-bridge.ts +10 -0
  646. package/scripts/fleet.ts +107 -90
  647. package/scripts/lib/claude-bridge-core.ts +45 -0
  648. package/scripts/lib/fleet-command.ts +170 -15
  649. package/scripts/lib/monitor-env.ts +18 -6
  650. package/scripts/lib/peer-launch.ts +6 -2
  651. package/scripts/lib/team-project.ts +24 -4
  652. package/scripts/team-up.ts +57 -11
  653. package/skills/designing-agents/SKILL.md +1 -1
  654. package/skills/designing-agents/pi-harness-authoring.md +3 -3
  655. package/.claude/commands/build.md +0 -44
  656. package/.claude/commands/design-agent.md +0 -14
  657. package/.claude/commands/doctor-agent-fleet.md +0 -22
  658. package/.claude/commands/orchestrate.md +0 -112
  659. package/.claude/commands/prime.md +0 -22
  660. package/.claude/commands/set-hermes-telegram.md +0 -15
  661. package/.claude/commands/set-hermes-watchdog.md +0 -6
  662. package/.claude/commands/setup-agent-fleet.md +0 -17
  663. package/.claude/commands/ship.md +0 -72
  664. package/.claude/commands/webperf.md +0 -32
  665. package/.claude/orchestrate-teams.yaml +0 -24
  666. package/.opencode/commands/af-build.md +0 -17
  667. package/.opencode/commands/af-code-simplify.md +0 -16
  668. package/.opencode/commands/af-compound.md +0 -16
  669. package/.opencode/commands/af-design-agent.md +0 -15
  670. package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  671. package/.opencode/commands/af-orchestrate.md +0 -112
  672. package/.opencode/commands/af-plan.md +0 -16
  673. package/.opencode/commands/af-prime.md +0 -22
  674. package/.opencode/commands/af-review.md +0 -15
  675. package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  676. package/.opencode/commands/af-setup-agent-fleet.md +0 -17
  677. package/.opencode/commands/af-ship.md +0 -16
  678. package/.opencode/commands/af-spec.md +0 -16
  679. package/.opencode/commands/af-test.md +0 -21
  680. package/.opencode/commands/af-webperf.md +0 -32
  681. package/.opencode/orchestrate-teams.yaml +0 -24
  682. package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  683. package/.pi/prompts/af-setup-agent-fleet.md +0 -19
  684. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
  685. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
  686. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
  687. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  688. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
  689. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  690. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
  691. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
  692. package/.versions/0.0.11/.claude/commands/build.md +0 -44
  693. package/.versions/0.0.11/.claude/commands/design-agent.md +0 -14
  694. package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +0 -22
  695. package/.versions/0.0.11/.claude/commands/orchestrate.md +0 -112
  696. package/.versions/0.0.11/.claude/commands/prime.md +0 -22
  697. package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +0 -15
  698. package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +0 -6
  699. package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +0 -17
  700. package/.versions/0.0.11/.claude/commands/ship.md +0 -72
  701. package/.versions/0.0.11/.claude/commands/webperf.md +0 -32
  702. package/.versions/0.0.11/.claude/orchestrate-teams.yaml +0 -24
  703. package/.versions/0.0.11/.opencode/commands/af-build.md +0 -17
  704. package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +0 -16
  705. package/.versions/0.0.11/.opencode/commands/af-compound.md +0 -16
  706. package/.versions/0.0.11/.opencode/commands/af-design-agent.md +0 -15
  707. package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  708. package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +0 -112
  709. package/.versions/0.0.11/.opencode/commands/af-plan.md +0 -16
  710. package/.versions/0.0.11/.opencode/commands/af-prime.md +0 -22
  711. package/.versions/0.0.11/.opencode/commands/af-review.md +0 -15
  712. package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  713. package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +0 -17
  714. package/.versions/0.0.11/.opencode/commands/af-ship.md +0 -16
  715. package/.versions/0.0.11/.opencode/commands/af-spec.md +0 -16
  716. package/.versions/0.0.11/.opencode/commands/af-test.md +0 -21
  717. package/.versions/0.0.11/.opencode/commands/af-webperf.md +0 -32
  718. package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +0 -24
  719. package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  720. package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +0 -19
  721. package/.versions/0.0.11/docs/opencode-setup.md +0 -281
  722. package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +0 -90
  723. package/.versions/0.0.11/hooks/hooks.json +0 -14
  724. package/.versions/0.0.11/hooks/session-start.sh +0 -74
  725. package/.versions/0.0.11/hooks/simplify-ignore.sh +0 -302
  726. package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +0 -226
  727. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  728. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
  729. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
  730. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
  731. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  732. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
  733. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
  734. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
  735. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  736. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
  737. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  738. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
  739. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
  740. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
  741. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  742. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
  743. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  744. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
  745. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
  746. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
  747. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  748. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
  749. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  750. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
  751. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
  752. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +0 -36
  753. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  754. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
  755. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  756. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
  757. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
  758. package/bin/lib/bootstrap.js +0 -323
  759. package/bin/lib/transform-persona.js +0 -180
  760. package/docs/opencode-setup.md +0 -281
  761. package/hooks/SIMPLIFY-IGNORE.md +0 -90
  762. package/hooks/hooks.json +0 -14
  763. package/hooks/session-start.sh +0 -74
  764. package/hooks/simplify-ignore.sh +0 -302
  765. package/skills/guided-workspace-setup/SKILL.md +0 -226
  766. /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  767. /package/.versions/0.0.11/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  768. /package/{.opencode/commands → .versions/1.0.0/.pi/prompts}/af-set-hermes-telegram.md +0 -0
  769. /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
  770. /package/.versions/{0.0.11/.opencode/commands → 1.0.1/.pi/prompts}/af-set-hermes-telegram.md +0 -0
  771. /package/{skills/guided-workspace-setup/companion-manifest.json → .versions/1.0.1/bin/catalog/harness-runtime-closure.json} +0 -0
@@ -1,302 +0,0 @@
1
- #!/bin/bash
2
- # simplify-ignore.sh — Hook for Read (PreToolUse), Edit|Write (PostToolUse), Stop
3
- #
4
- # PreToolUse Read → backs up file, replaces blocks with BLOCK_<hash> in-place
5
- # PostToolUse Edit → expands placeholders, re-filters so file stays hidden
6
- # PostToolUse Write → expands placeholders, re-filters so file stays hidden
7
- # Stop → restores real file content from backup
8
- #
9
- # The file on disk ALWAYS has placeholders while the session is active.
10
- # The real content (with model's changes applied) lives in the backup.
11
- #
12
- # Dependencies: jq, shasum or sha1sum (auto-detected)
13
-
14
- set -euo pipefail
15
-
16
- if ! command -v jq >/dev/null 2>&1; then
17
- printf '%s\n' "error: missing jq" >&2; exit 1
18
- fi
19
-
20
- CACHE="${CLAUDE_PROJECT_DIR:-.}/.claude/.simplify-ignore-cache"
21
- if [ -t 0 ]; then INPUT="{}"; else INPUT=$(cat); fi
22
-
23
- # Parse hook input — trap errors explicitly so set -e doesn't cause
24
- # a silent exit on malformed JSON, and surface a useful diagnostic.
25
- parse_error=""
26
- TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null) || {
27
- parse_error="failed to parse .tool_name from hook input"
28
- TOOL_NAME=""
29
- }
30
- FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null) || {
31
- parse_error="failed to parse .tool_input.file_path from hook input"
32
- FILE_PATH=""
33
- }
34
- if [ -n "$parse_error" ]; then
35
- printf 'Warning: %s (input: %.120s)\n' "$parse_error" "$INPUT" >&2
36
- fi
37
-
38
- hash_cmd() {
39
- if command -v shasum >/dev/null 2>&1; then shasum
40
- elif command -v sha1sum >/dev/null 2>&1; then sha1sum
41
- else printf '%s\n' "error: missing shasum or sha1sum" >&2; exit 1; fi
42
- }
43
- file_id() { printf '%s' "$1" | hash_cmd | cut -c1-16; }
44
- block_hash() { printf '%s' "$1" | hash_cmd | cut -c1-8; }
45
- # Escape glob metacharacters so ${var/pattern/repl} treats pattern as literal.
46
- # Needed for Bash 3.2 (macOS) where quotes don't suppress globbing in PE patterns.
47
- escape_glob() {
48
- local s="$1"
49
- s="${s//\\/\\\\}"
50
- s="${s//\*/\\*}"
51
- s="${s//\?/\\?}"
52
- s="${s//\[/\\[}"
53
- printf '%s' "$s"
54
- }
55
-
56
- # ── filter_file: replace simplify-ignore blocks with BLOCK_<hash> placeholders ─
57
- # Reads $1 (source), writes filtered version to $2 (dest), saves blocks to cache.
58
- # Returns 0 if blocks were found, 1 if none.
59
- filter_file() {
60
- local src="$1" dest="$2" fid="$3"
61
- : > "$dest"
62
- rm -f "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
63
-
64
- local count=0 in_block=0 buf="" reason="" prefix="" suffix=""
65
-
66
- while IFS= read -r line || [ -n "$line" ]; do
67
- # Check for start marker (no fork — uses bash case)
68
- if [ $in_block -eq 0 ]; then
69
- case "$line" in *simplify-ignore-start*)
70
- in_block=1
71
- buf="$line"
72
- # Extract comment prefix/suffix to preserve language-appropriate syntax
73
- prefix="${line%%simplify-ignore-start*}"
74
- suffix=""
75
- case "$line" in *'*/'*) suffix=" */" ;; *'-->'*) suffix=" -->" ;; esac
76
- reason=$(printf '%s' "$line" | sed -n 's/.*simplify-ignore-start:[[:space:]]*//p' \
77
- | sed 's/[[:space:]]*\*\/.*$//' | sed 's/[[:space:]]*-->.*$//' | sed 's/[[:space:]]*$//')
78
- # Handle single-line block (start + end on same line)
79
- case "$line" in *simplify-ignore-end*)
80
- in_block=0
81
- # Write single-line block immediately and skip to next line
82
- # to avoid the end-marker check below firing again
83
- local h; h=$(block_hash "$buf")
84
- count=$((count + 1))
85
- printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
86
- [ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
87
- printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
88
- printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
89
- if [ -n "$reason" ]; then
90
- printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
91
- else
92
- printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
93
- fi
94
- buf=""; reason=""; prefix=""; suffix=""
95
- continue
96
- ;; *)
97
- continue
98
- ;;
99
- esac
100
- ;; esac
101
- fi
102
- # Accumulate block content
103
- if [ $in_block -eq 1 ]; then
104
- buf="${buf}
105
- ${line}"
106
- fi
107
- # Check for end marker
108
- case "$line" in *simplify-ignore-end*)
109
- if [ $in_block -eq 1 ]; then
110
- local h; h=$(block_hash "$buf")
111
- count=$((count + 1))
112
- printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
113
- [ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
114
- printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
115
- printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
116
- if [ -n "$reason" ]; then
117
- printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
118
- else
119
- printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
120
- fi
121
- in_block=0; buf=""; reason=""; prefix=""; suffix=""
122
- continue
123
- fi
124
- ;;
125
- esac
126
- [ $in_block -eq 0 ] && printf '%s\n' "$line" >> "$dest"
127
- done < "$src"
128
-
129
- # Unclosed block → flush as-is
130
- if [ $in_block -eq 1 ] && [ -n "$buf" ]; then
131
- printf 'Warning: unclosed simplify-ignore-start in %s (block not hidden)\n' "$src" >&2
132
- printf '%s\n' "$buf" >> "$dest"
133
- fi
134
-
135
- # Preserve trailing newline status of source
136
- if [ -s "$dest" ] && [ -s "$src" ] && [ -n "$(tail -c 1 "$src")" ]; then
137
- perl -pe 'chomp if eof' "$dest" > "${dest}.nnl" && \
138
- cat "${dest}.nnl" > "$dest" && rm -f "${dest}.nnl"
139
- fi
140
-
141
- [ $count -gt 0 ] && return 0 || return 1
142
- }
143
-
144
- # ── Stop: restore all files from backup ───────────────────────────────────────
145
- if [ -z "$TOOL_NAME" ]; then
146
- [ -d "$CACHE" ] || exit 0
147
- for bak in "$CACHE"/*.bak; do
148
- [ -f "$bak" ] || continue
149
- fid="${bak##*/}"; fid="${fid%.bak}"
150
- pathfile="$CACHE/${fid}.path"
151
- [ -f "$pathfile" ] || { rm -f "$bak"; continue; }
152
- orig=$(cat "$pathfile")
153
- if [ -f "$orig" ]; then
154
- cat "$bak" > "$orig"
155
- rm -f "$bak" "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
156
- rmdir "$CACHE/${fid}.lock" 2>/dev/null
157
- else
158
- # File was moved/deleted — save backup as .recovered, don't destroy it
159
- mkdir -p "$(dirname "${orig}.recovered")"
160
- mv "$bak" "${orig}.recovered"
161
- rm -f "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
162
- rmdir "$CACHE/${fid}.lock" 2>/dev/null
163
- printf 'Warning: %s was moved/deleted. Recovered original to %s.recovered\n' "$orig" "$orig" >&2
164
- fi
165
- done
166
- # Clean orphan locks (created but crash before backup)
167
- for lockdir in "$CACHE"/*.lock; do
168
- [ -d "$lockdir" ] || continue
169
- rmdir "$lockdir" 2>/dev/null
170
- done
171
- exit 0
172
- fi
173
-
174
- [ -z "$FILE_PATH" ] && exit 0
175
-
176
- # ── PreToolUse Read: filter in-place ──────────────────────────────────────────
177
- if [ "$TOOL_NAME" = "Read" ]; then
178
- [ -f "$FILE_PATH" ] || exit 0
179
- case "$(basename "$FILE_PATH")" in simplify-ignore*|SIMPLIFY-IGNORE*) exit 0 ;; esac
180
-
181
- mkdir -p "$CACHE"
182
- ID=$(file_id "$FILE_PATH")
183
-
184
- # If backup exists, file is already filtered — skip
185
- [ -f "$CACHE/${ID}.bak" ] && exit 0
186
-
187
- grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
188
-
189
- # Atomic lock: mkdir fails if another session races us
190
- if ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
191
- # Lock exists — reclaim only if stale (>60s old, no backup = crash leftover)
192
- if [ ! -f "$CACHE/${ID}.bak" ] && \
193
- [ -n "$(find "$CACHE/${ID}.lock" -maxdepth 0 -mmin +1 2>/dev/null)" ]; then
194
- rmdir "$CACHE/${ID}.lock" 2>/dev/null || true
195
- mkdir "$CACHE/${ID}.lock" 2>/dev/null || exit 0
196
- else
197
- exit 0
198
- fi
199
- fi
200
-
201
- # Back up the original (preserve trailing newline status)
202
- cp -p "$FILE_PATH" "$CACHE/${ID}.bak" 2>/dev/null || cp "$FILE_PATH" "$CACHE/${ID}.bak"
203
- printf '%s' "$FILE_PATH" > "$CACHE/${ID}.path"
204
-
205
- # Filter in-place (cat > preserves inode and permissions)
206
- FILTERED="$CACHE/${ID}.$$.tmp"
207
- rm -f "$FILTERED"
208
- if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
209
- cat "$FILTERED" > "$FILE_PATH"
210
- rm -f "$FILTERED"
211
- else
212
- rm -f "$FILTERED" "$CACHE/${ID}.bak" "$CACHE/${ID}.path"
213
- rmdir "$CACHE/${ID}.lock" 2>/dev/null
214
- fi
215
- exit 0
216
- fi
217
-
218
- # ── PostToolUse Edit|Write: expand, then re-filter ────────────────────────────
219
- if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "Write" ]; then
220
- ID=$(file_id "$FILE_PATH")
221
- [ -f "$CACHE/${ID}.bak" ] || exit 0
222
- ls "$CACHE/${ID}".block.* >/dev/null 2>&1 || exit 0
223
-
224
- # Expand placeholders, preserving any inline code the model added around them
225
- EXPANDED="$CACHE/${ID}.$$.expanded"
226
- rm -f "$EXPANDED"
227
- while IFS= read -r line || [ -n "$line" ]; do
228
- case "$line" in *BLOCK_*)
229
- # Expand all placeholders on this line (supports multiple per line)
230
- for bf in "$CACHE/${ID}".block.*; do
231
- [ -f "$bf" ] || continue
232
- h="${bf##*.}"
233
- case "$line" in *"BLOCK_${h}"*)
234
- # Reconstruct the exact placeholder pattern
235
- bp=""; bs=""; br=""
236
- [ -f "$CACHE/${ID}.prefix.${h}" ] && bp=$(cat "$CACHE/${ID}.prefix.${h}")
237
- [ -f "$CACHE/${ID}.suffix.${h}" ] && bs=$(cat "$CACHE/${ID}.suffix.${h}")
238
- [ -f "$CACHE/${ID}.reason.${h}" ] && br=$(cat "$CACHE/${ID}.reason.${h}")
239
- if [ -n "$br" ]; then
240
- placeholder="${bp}BLOCK_${h}: ${br}${bs}"
241
- else
242
- placeholder="${bp}BLOCK_${h}${bs}"
243
- fi
244
- block_content=$(cat "$bf"; printf x); block_content="${block_content%x}"
245
- # Escape glob metacharacters (* ? [ \) in the pattern
246
- esc_placeholder=$(escape_glob "$placeholder")
247
- # Bash native substitution (// = global replace): replace placeholder, keep surrounding code
248
- line="${line//$esc_placeholder/$block_content}"
249
- # Fallback: if model altered the reason text, try without reason
250
- # (only trigger if BLOCK_hash is still present AND wasn't in the original block content)
251
- case "$block_content" in *"BLOCK_${h}"*) ;; *)
252
- case "$line" in *"BLOCK_${h}"*)
253
- printf 'Warning: placeholder BLOCK_%s was modified by model, using fuzzy match\n' "$h" >&2
254
- esc_fuzzy=$(escape_glob "${bp}BLOCK_${h}${bs}")
255
- line="${line//$esc_fuzzy/$block_content}"
256
- # Last resort: match just the hash token
257
- case "$line" in *"BLOCK_${h}"*)
258
- line="${line//BLOCK_${h}/$block_content}"
259
- ;; esac
260
- ;; esac
261
- ;; esac
262
- ;; esac
263
- done
264
- ;; esac
265
- printf '%s\n' "$line" >> "$EXPANDED"
266
- done < "$FILE_PATH"
267
- # Preserve trailing newline status
268
- if [ -s "$EXPANDED" ] && [ -s "$FILE_PATH" ] && [ -n "$(tail -c 1 "$FILE_PATH")" ]; then
269
- perl -pe 'chomp if eof' "$EXPANDED" > "${EXPANDED}.nnl" && \
270
- cat "${EXPANDED}.nnl" > "$EXPANDED" && rm -f "${EXPANDED}.nnl"
271
- fi
272
- # Warn if model deleted a protected block entirely
273
- for bf in "$CACHE/${ID}".block.*; do
274
- [ -f "$bf" ] || continue
275
- bh="${bf##*.}"
276
- # After expansion, blocks appear as original code (simplify-ignore-start).
277
- # If neither the expanded code nor the placeholder is in EXPANDED, it was deleted.
278
- if ! grep -qF "BLOCK_${bh}" "$EXPANDED" 2>/dev/null; then
279
- # Get first line of block to check if it was expanded back
280
- first_line=$(head -1 "$bf")
281
- if ! grep -qF "$first_line" "$EXPANDED" 2>/dev/null; then
282
- printf 'Warning: protected block BLOCK_%s was deleted by model\n' "$bh" >&2
283
- fi
284
- fi
285
- done
286
- # Preserve inode and permissions
287
- cat "$EXPANDED" > "$FILE_PATH"
288
- rm -f "$EXPANDED"
289
-
290
- # Save expanded version as new backup (this is the "real" file with model's changes)
291
- cp "$FILE_PATH" "$CACHE/${ID}.bak"
292
-
293
- # Re-filter in-place so the file on disk stays with placeholders
294
- FILTERED="$CACHE/${ID}.$$.tmp"
295
- rm -f "$FILTERED"
296
- if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
297
- cat "$FILTERED" > "$FILE_PATH"
298
- rm -f "$FILTERED"
299
- fi
300
-
301
- exit 0
302
- fi
@@ -1,226 +0,0 @@
1
- ---
2
- name: guided-workspace-setup
3
- description: Guides installation of agent-fleet artifacts into a target workspace. Use when onboarding a project to agent-fleet, when installing skills, commands, prompts, personas, or pi extensions for a chosen coding agent, or when a workspace needs its setup files configured.
4
- ---
5
-
6
- # Guided Workspace Setup
7
-
8
- ## Overview
9
-
10
- A conversational front-end over the `agent-fleet` CLI's deterministic installer. The CLI decides
11
- paths, states, merges, ownership, and writes — this skill asks the questions a program cannot
12
- answer: which artifacts this project wants, what belongs in its overrides file, and which speech
13
- provider to configure. Everything else is `agent-fleet <verb> --json`.
14
-
15
- **You never write an install target yourself.** No copying, no symlinking, no path tables, no
16
- merge rules. If you find yourself about to write into `.claude/`, `.opencode/`, `.pi/`, or the
17
- `justfile`, you are in the wrong place — call the CLI.
18
-
19
- ## When to Use
20
-
21
- - Onboarding a project to agent-fleet, or changing which artifacts it uses
22
- - Re-running setup to add, upgrade, repair, or remove artifacts
23
- - Authoring or revising `.ai/agent-fleet-overrides.md`
24
-
25
- **NOT for:** authoring new skills or personas (`designing-agents`); editing artifacts inside the
26
- agent-fleet repo itself; general rules-file tuning (`context-engineering`).
27
-
28
- ## Process
29
-
30
- ### 1. Resolve the source root and agent
31
-
32
- Run the CLI from the agent-fleet package the user actually installed:
33
-
34
- 1. `<workspace>/.ai/.agent-fleet-bootstrap.json` → its `sourceRoot`. Authoritative; written by
35
- `npx @chankov/agent-fleet init`. If the path no longer exists, say so and go to 3.
36
- 2. This `SKILL.md`'s realpath, if it is a symlink. Never its *workspace* location — bootstrap
37
- copies the file into `.pi/skills/…`, so that path is the target, not the source.
38
- 3. Ask. **Never scan the filesystem for agent-fleet clones** — it finds forks and stale checkouts,
39
- not the package the user installed from.
40
-
41
- Confirm the workspace path exists. The agent (`claude-code` / `opencode` / `pi`) comes from the
42
- recorded state; pass `--agent` only to override it.
43
-
44
- ### 2. Read the workspace's current state
45
-
46
- ```
47
- node <source-root>/bin/cli.js verify --workspace <workspace> [--agent <agent>] --json
48
- ```
49
-
50
- One command, everything you need: `groups` (menu headings, agent-filtered), `profiles` (the
51
- shortcuts), and `items` — each with `id`, `group`, `subcategory`, `title`, `summary`,
52
- `recommended`, `consent`, `owned`, and `state`. Plus `findings`, `recordedVersion`, and
53
- `summary.versionDrift`.
54
-
55
- The states are the CLI's, not yours: `absent`, `up-to-date`, `linked`, `outdated`, `modified`,
56
- `conflict`, `missing`, `broken-link`, `foreign-link`, `partial`, `gone`, `not-applicable`.
57
- Do not compute, guess, or re-derive them.
58
-
59
- If `findings` is non-empty or any item is broken, offer `doctor --fix` before the menu — a broken
60
- workspace makes the menu lie about what is installed.
61
-
62
- ### 3. Ask what to install
63
-
64
- Present the `items` grouped by `group`, chunked by `subcategory`. Interaction mode:
65
-
66
- - **pi** → the `ask_user` widget from the external `pi-ask-user` package. If it is missing, offer
67
- to install it (`pi install -l npm:pi-ask-user`), then **stop the pass** and ask the user to
68
- reload and re-run — the widget is not callable until then. If they decline, use the text
69
- fallback.
70
- - **claude-code** → `AskUserQuestion` (max 4 options per call).
71
- - **anything else** → print a compact table and take a text reply.
72
-
73
- Screen budget: ≤ 8 context lines, ≤ 9 options per call (≤ 4 on `AskUserQuestion`). Options carry
74
- the data — `{title, description}`, never a table pasted into `context`. Titles are
75
- `<title> ★ [state]`; descriptions say what picking it does in plain words ("update available",
76
- "locally modified — installing overwrites your edits"). Long material (diffs, changelog, the plan)
77
- prints as agent text *before* the call, with `displayMode: "inline"` so it stays visible.
78
-
79
- Open with one Express single-select that can resolve the whole menu — the `profiles` map supplies
80
- the shortcuts (`recommended`, `full`, `minimal`, `pi-fleet-core`, …). Group screens run only on
81
- `Custom`. Cancel is a no-op everywhere except the final confirmation.
82
-
83
- **Selection never removes.** Leaving an installed item unpicked keeps it. Removal is its own
84
- explicit screen, and it runs `uninstall --items`.
85
-
86
- ### 4. Offer project overrides *(this is genuinely yours)*
87
-
88
- Scan the workspace — language, framework, test runner, dev server, rule-file trees, doc entry
89
- points — and propose draft sections for `.ai/agent-fleet-overrides.md`:
90
- `spec-driven-development`, `planning-and-task-breakdown`, `browser-testing-with-devtools`,
91
- `git-workflow-and-versioning`, and for `pi` with `agent-hub` selected, `## agent-hub` (a legacy
92
- `## agent-team` section keeps its name — preserve, never duplicate).
93
-
94
- In `## agent-hub`, offer `language:` (default `English`, preserving any existing value) and the
95
- project-knowledge keys **only when the scan finds matching material** — `rules:` for a rule-file
96
- tree (`.ai/rules/`, `docs/rules/`, `.cursor/rules/`; point at the tree root, which resolves
97
- index-first), `docs:` for canonical WHAT/WHY entry points. An empty guess sends every specialist
98
- hunting for files that are not there.
99
-
100
- Terse `key: value` lines only — the lifecycle skills and `agent-hub` parse this file on every run.
101
- Reference env-var *names*; secrets stay in a gitignored `.env`. When any section names env vars,
102
- offer an `## env` section with `required: <NAME>[, <NAME>]`. Schema: `docs/agent-fleet-setup.md`.
103
-
104
- Print each draft as agent text, then ask `Accept` / `Edit` / `Skip` per section (or one
105
- multi-select when there are more than two). This file is yours to write directly — it is not an
106
- install target.
107
-
108
- ### 5. Configure `pi-voice-stt`, if selected *(also genuinely yours)*
109
-
110
- The extension is a no-op until a provider is configured, and the CLI reports it as an operator
111
- step rather than inventing one. Offer — never force — the Q&A:
112
-
113
- - **Azure Speech** (`type: azure`) — resource endpoint, optional `locales` for per-phrase language
114
- ID (e.g. `["bg-BG","en-US"]`). Env: `AZURE_SPEECH_KEY`, `AZURE_SPEECH_ENDPOINT`.
115
- - **Azure OpenAI Whisper** (`type: azure-openai`) — best for mixed-language speech. `endpoint`,
116
- Whisper `deployment`, `apiVersion` (default `2024-10-21`). Use the legacy data-plane host
117
- `https://<resource>.openai.azure.com` (or `…cognitiveservices.azure.com`) — transcription 404s
118
- on the Foundry `…services.ai.azure.com` host. Env: `AZURE_OPENAI_API_KEY`,
119
- `AZURE_OPENAI_ENDPOINT`; offer `apiKeyEnv: AZURE_SPEECH_KEY` when the key is shared.
120
- - **OpenAI-compatible** (`type: openai`) — `baseUrl` (default `https://api.openai.com/v1`; a
121
- `http://127.0.0.1:*/v1` loopback is fine for local whisper), `model` (default `whisper-1`).
122
- Env: `OPENAI_API_KEY`.
123
-
124
- Write `<workspace>/.ai/stt.json` with the non-secret config and `apiKeyEnv` — **never a key
125
- value** — and append the referenced names to the repo-root `.env` as empty placeholders only if
126
- absent, never overwriting. Ensure `.env` is gitignored. On removal, delete `stt.json` only if
127
- unedited; never touch `.env`.
128
-
129
- ### 6. Apply
130
-
131
- ```
132
- node <source-root>/bin/cli.js install --workspace <ws> --agent <a> \
133
- --profile <name> | --items <id,…> [--allow-exec] --yes --json
134
- ```
135
-
136
- `upgrade` for a version bump (three-way merge, preserves local edits, `--accept-theirs` /
137
- `--accept-ours` for conflicts), `uninstall --items <id,…>` for removals, `doctor --fix` for
138
- repairs. Add `--dry-run` first when the user wants to see the plan; `--json` requires `--yes`.
139
-
140
- Print the plan as compact action-grouped lines before the confirm — `Add (N): …`,
141
- `Refresh (N): …` (append *overwrites local edits* when the plan reports `overwrites`),
142
- `Remove (N): …`, `Keep (N)` as a count, `Method:`. When `versionDrift` is set, lead with
143
- **"Changes since v<recorded> → v<current>"** and short bullets from `CHANGELOG.md`. Then one
144
- `inline` single-select: `Apply — and remove the installer commands` (default) /
145
- `Apply — keep the installer commands` / `Adjust picks` / `Cancel`.
146
-
147
- Exit codes are the contract: `0` done, `1` error, `2` findings, `3` conflicts. On `3`, the CLI
148
- wrote `<file>.new` beside each conflicted file and touched nothing else — show the list and let
149
- the user resolve, or re-run with `--accept-theirs` / `--accept-ours`.
150
-
151
- Artifacts install as copies. There is no copy-vs-symlink question to ask — symlinks exist only
152
- inside an agent-fleet checkout, and a workspace that recorded them before that is migrated to
153
- copies by the CLI on this run. Never offer the choice, and never pass `--method`.
154
-
155
- `--allow-exec` covers the `npm ci` steps for `.pi/extensions` and `.pi/harnesses`; ask before
156
- passing it. `external` and `operator` actions carry their own instructions in the plan output —
157
- relay them verbatim; the CLI performs none of them, and neither do you.
158
-
159
- ### 7. Clean up and report
160
-
161
- Unless the user chose to keep them:
162
-
163
- ```
164
- node <source-root>/bin/cli.js cleanup-installer --agent <agent> --workspace <workspace>
165
- ```
166
-
167
- Then `verify` once more and report what changed, plus the one-line cleanup outcome
168
- ("Installer slash commands removed — `npx @chankov/agent-fleet init` restores them", or the
169
- retained command names). Point the user at `.ai/agent-fleet-overrides.md` and suggest loading
170
- `using-agent-skills` first next session.
171
-
172
- ## Common Rationalizations
173
-
174
- | Rationalization | Reality |
175
- |---|---|
176
- | "I'll copy this one file myself — calling the CLI for it is overkill." | Then it is not recorded in `.ai/agent-fleet-state.json`, so `verify` calls it unowned, `upgrade` skips it, and `uninstall` refuses to remove it. The state file is what makes any of this reversible. |
177
- | "The installed file looks different from the source, so it's modified." | `modified`, `outdated`, and `conflict` are three different answers with three different consequences, and they need the recorded hash and the version snapshot to tell apart. Read `state` from `verify --json`. |
178
- | "The user picked a narrower profile, so I'll remove what's no longer in it." | Selection never removes. Removal is `uninstall` with named items, and only after an explicit remove screen. |
179
- | "The plan says `conflict` — I'll take the new version, it's newer." | Exit `3` means both sides changed. The `.new` file exists so a human decides. `--accept-theirs` is the user's call to make, not yours. |
180
- | "I'll run `npm ci` for the extensions — it's obviously needed." | It is an `exec` item, gated on `--allow-exec`. Running commands in someone's repo is a consent boundary, not a formality. |
181
- | "The Hermes plugin just needs a symlink into the profile directory — I can do that." | Operator items exist because their targets are outside the workspace: a Hermes profile, a user systemd unit, a running gateway. Relay the declared steps; perform none of them. |
182
- | "The user is on `pi` and `pi-ask-user` is missing — I'll use the text fallback." | Offer the install-then-reload bootstrap first. A ~50-row menu through plain text is the experience that widget exists to replace. Fall back only if they decline. |
183
- | "I installed `pi-ask-user`, so I'll keep going in the same pass." | It is not callable until pi reloads. Stop, ask them to reload and re-run. |
184
- | "The user didn't tick that installed item in the drill-in, so remove it." | Not selecting means keep as-is. An accidental non-pick must never delete anything. |
185
- | "They pressed `esc` — I'll take the defaults and continue." | Cancel is skip/no-op on every screen except the final confirm, where it means do not apply. |
186
- | "I'll write the install detail into the overrides file too — one place is simpler." | Every skill and every `agent-hub` session loads the overrides file. Install detail lives in the state file, which nothing loads at runtime. |
187
- | "There's no rule-file tree, but `rules:` looks incomplete without a value." | An invented path sends every specialist hunting for files that do not exist. Skip the key. |
188
- | "The user asked for symlinks so `git pull` updates everything." | Symlinks are checkout-only now: outside one, the link target has to stay put forever, an npx cache clean breaks every link at once, and a source `git pull` rewrites artifacts nobody agreed to change. `agent-fleet upgrade` gives the same freshness with a real three-way merge. Say that, don't pass `--method`. |
189
- | "I'll put the Azure key in `stt.json` — it's in `.ai/`, that's fine." | `.ai/` is committed. The config names an env var; the value lives in a gitignored `.env`. |
190
-
191
- ## Red Flags
192
-
193
- - Any write by this skill into `.claude/`, `.opencode/`, `.pi/`, `agents/`, or the `justfile` —
194
- those are the CLI's, exclusively. Only `.ai/agent-fleet-overrides.md` and `.ai/stt.json` are yours.
195
- - An item state computed by eye instead of read from `verify --json`.
196
- - A path table, merge rule, or removal-ownership rule restated in the conversation — all three
197
- live in code, and a second copy will drift from it.
198
- - `--json` used without `--yes`, or a plan applied without printing it first.
199
- - A markdown table pasted into a widget call's `question` or `context`, or a screen over budget.
200
- - The `pi-ask-user` bootstrap skipped on `pi`, or the pass continued after installing it.
201
- - An artifact removed without an explicit remove screen, or `esc` treated as consent.
202
- - Exit `3` handled by picking a side instead of showing the `.new` files.
203
- - `operator` or `external` steps performed instead of relayed.
204
- - A key value written into `.ai/stt.json`, or `.env` overwritten rather than appended to.
205
- - Source root found by scanning the filesystem, or taken from `SKILL.md`'s workspace location.
206
-
207
- ## Verification
208
-
209
- - [ ] Source root came from the bootstrap marker, `SKILL.md`'s realpath, or the user — never a scan.
210
- - [ ] Every item state, group, and profile came from `verify --json`.
211
- - [ ] Broken items and findings were offered `doctor --fix` before the menu.
212
- - [ ] The menu opened with the Express question; group screens ran only on `Custom`; every screen
213
- stayed within budget, with options carrying the data.
214
- - [ ] On `pi`, `pi-ask-user` was present or its install-then-reload bootstrap was offered, and the
215
- pass stopped after installing it.
216
- - [ ] Nothing was written to an install target except by the CLI, and the plan was printed before
217
- the single confirmation.
218
- - [ ] `--allow-exec` was passed only after asking; `operator` / `external` steps were relayed verbatim.
219
- - [ ] No copy-vs-symlink question was asked and no `--method` flag was passed.
220
- - [ ] A `3` exit was surfaced as conflicts with their `.new` files, not resolved by guessing.
221
- - [ ] `.ai/agent-fleet-overrides.md` holds terse `key: value` sections and nothing else; `rules:` /
222
- `docs:` were offered only when the scan found matching material.
223
- - [ ] `.ai/stt.json` names env vars and holds no key values; `.env` was appended to, gitignored,
224
- and never overwritten.
225
- - [ ] `cleanup-installer` ran unless the user kept the installer commands, and the report says which.
226
- - [ ] The final `verify` exited `0`.