@chankov/agent-fleet 0.0.11 → 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 (494) hide show
  1. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  2. package/.pi/extensions/btw/README.md +26 -25
  3. package/.pi/extensions/btw/index.ts +80 -83
  4. package/.pi/extensions/pi-voice-stt/README.md +4 -3
  5. package/.pi/extensions/pi-voice-stt/config.ts +1 -1
  6. package/.pi/harnesses/agent-hub/README.md +106 -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/extensions/agent-fleet-update-check/README.md +4 -4
  29. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/README.md +4 -3
  30. package/.versions/0.0.11/.pi/extensions/pi-voice-stt/config.ts +1 -1
  31. package/.versions/0.0.11/.pi/harnesses/agent-hub/monitor-session-bridge.ts +10 -1
  32. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/README.md +37 -3
  33. package/.versions/0.0.11/.pi/harnesses/ask-user-remote/index.ts +173 -17
  34. package/.versions/0.0.11/.pi/harnesses/package-lock.json +2011 -0
  35. package/.versions/0.0.11/.pi/harnesses/package.json +1 -0
  36. package/.versions/0.0.11/docs/ARCHITECTURE.md +6 -8
  37. package/.versions/0.0.11/docs/agent-fleet-setup.md +17 -43
  38. package/.versions/0.0.11/docs/claude-code-coms-bridge.md +20 -2
  39. package/.versions/0.0.11/docs/coms-hermes-bridge.md +1 -1
  40. package/.versions/0.0.11/docs/getting-started.md +26 -237
  41. package/.versions/0.0.11/docs/npm-install.md +60 -478
  42. package/.versions/0.0.11/docs/pi-extensions.md +4 -4
  43. package/.versions/0.0.11/docs/pi-setup.md +37 -551
  44. package/.versions/0.0.11/hermes/README.md +1 -1
  45. package/.versions/0.0.11/install-manifest.json +375 -1247
  46. package/.versions/0.0.11/justfile +13 -6
  47. package/.versions/0.0.11/manifest-meta.json +543 -134
  48. package/.versions/0.0.11/scripts/lib/fleet-command.ts +8 -0
  49. package/.versions/0.0.11/scripts/lib/monitor-env.ts +18 -6
  50. package/.versions/0.0.11/skills/designing-agents/SKILL.md +1 -1
  51. package/.versions/0.0.11/skills/designing-agents/pi-harness-authoring.md +1 -1
  52. package/.versions/1.0.0/.pi/agents/dispatch-policy.yaml +32 -0
  53. package/.versions/1.0.0/.pi/agents/model-profiles.yaml +27 -0
  54. package/.versions/1.0.0/.pi/agents/peers.yaml +142 -0
  55. package/.versions/1.0.0/.pi/agents/teams.yaml +41 -0
  56. package/.versions/1.0.0/.pi/damage-control-rules.yaml +297 -0
  57. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  58. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  59. package/.versions/1.0.0/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  60. package/.versions/1.0.0/.pi/extensions/btw/README.md +120 -0
  61. package/.versions/1.0.0/.pi/extensions/btw/index.ts +914 -0
  62. package/.versions/1.0.0/.pi/extensions/btw/package.json +6 -0
  63. package/.versions/1.0.0/.pi/extensions/btw/state.js +179 -0
  64. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  65. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  66. package/.versions/1.0.0/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  67. package/.versions/1.0.0/.pi/extensions/compact-and-continue/README.md +42 -0
  68. package/.versions/1.0.0/.pi/extensions/compact-and-continue/index.ts +120 -0
  69. package/.versions/1.0.0/.pi/extensions/compact-and-continue/package.json +6 -0
  70. package/.versions/1.0.0/.pi/extensions/mcp-bridge/README.md +46 -0
  71. package/.versions/1.0.0/.pi/extensions/mcp-bridge/index.ts +206 -0
  72. package/.versions/1.0.0/.pi/extensions/mcp-bridge/package.json +6 -0
  73. package/.versions/1.0.0/.pi/extensions/package-lock.json +1143 -0
  74. package/.versions/1.0.0/.pi/extensions/package.json +9 -0
  75. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/README.md +205 -0
  76. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/config.ts +198 -0
  77. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  78. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/index.ts +248 -0
  79. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/package.json +6 -0
  80. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  81. package/.versions/1.0.0/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  82. package/.versions/1.0.0/.pi/harnesses/agent-hub/README.md +1056 -0
  83. package/.versions/1.0.0/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  84. package/.versions/1.0.0/.pi/harnesses/agent-hub/artifacts.js +146 -0
  85. package/.versions/1.0.0/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  86. package/.versions/1.0.0/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  87. package/.versions/1.0.0/.pi/harnesses/agent-hub/context-window.js +106 -0
  88. package/.versions/1.0.0/.pi/harnesses/agent-hub/delegate.ts +435 -0
  89. package/.versions/1.0.0/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  90. package/.versions/1.0.0/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  91. package/.versions/1.0.0/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  92. package/.versions/1.0.0/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  93. package/.versions/1.0.0/.pi/harnesses/agent-hub/footer.ts +35 -0
  94. package/.versions/1.0.0/.pi/harnesses/agent-hub/helpers.ts +266 -0
  95. package/.versions/1.0.0/.pi/harnesses/agent-hub/index.ts +9279 -0
  96. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  97. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  98. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  99. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  100. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  101. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  102. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  103. package/.versions/1.0.0/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  104. package/.versions/1.0.0/.pi/harnesses/agent-hub/package.json +7 -0
  105. package/.versions/1.0.0/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  106. package/.versions/1.0.0/.pi/harnesses/agent-hub/posture.ts +103 -0
  107. package/.versions/1.0.0/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  108. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-retention.js +34 -0
  109. package/.versions/1.0.0/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  110. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-contract.js +293 -0
  111. package/.versions/1.0.0/.pi/harnesses/agent-hub/return-extract.js +75 -0
  112. package/.versions/1.0.0/.pi/harnesses/agent-hub/review-findings.js +102 -0
  113. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-budget.js +479 -0
  114. package/.versions/1.0.0/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  115. package/.versions/1.0.0/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  116. package/.versions/1.0.0/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  117. package/.versions/1.0.0/.pi/harnesses/agent-hub/session-health.js +110 -0
  118. package/.versions/1.0.0/.pi/harnesses/agent-hub/spawn.ts +354 -0
  119. package/.versions/1.0.0/.pi/harnesses/agent-hub/version.ts +42 -0
  120. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/README.md +53 -0
  121. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/index.ts +477 -0
  122. package/.versions/1.0.0/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  123. package/.versions/1.0.0/.pi/harnesses/coms/README.md +100 -0
  124. package/.versions/1.0.0/.pi/harnesses/coms/index.ts +1767 -0
  125. package/.versions/1.0.0/.pi/harnesses/coms/package.json +7 -0
  126. package/.versions/1.0.0/.pi/harnesses/coms/version.ts +42 -0
  127. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/README.md +124 -0
  128. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/index.ts +536 -0
  129. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/package.json +7 -0
  130. package/.versions/1.0.0/.pi/harnesses/damage-control-continue/version.ts +42 -0
  131. package/.versions/1.0.0/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  132. package/.versions/1.0.0/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  133. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-ops.ts +118 -0
  134. package/.versions/1.0.0/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  135. package/.versions/1.0.0/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  136. package/.versions/1.0.0/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  137. package/.versions/1.0.0/.pi/harnesses/lib/fleet-panel.ts +34 -0
  138. package/.versions/1.0.0/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  139. package/.versions/1.0.0/.pi/harnesses/lib/fleet-selection.ts +24 -0
  140. package/.versions/1.0.0/.pi/harnesses/lib/herdr-client.ts +472 -0
  141. package/.versions/1.0.0/.pi/harnesses/lib/herdr-presence.ts +399 -0
  142. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  143. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  144. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  145. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  146. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  147. package/.versions/1.0.0/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  148. package/.versions/1.0.0/.pi/harnesses/lib/spawned-peers.js +190 -0
  149. package/.versions/1.0.0/.pi/harnesses/package-lock.json +2046 -0
  150. package/.versions/1.0.0/.pi/harnesses/package.json +10 -0
  151. package/.versions/1.0.0/.pi/prompts/af-build.md +24 -0
  152. package/{.claude/commands/code-simplify.md → .versions/1.0.0/.pi/prompts/af-code-simplify.md} +3 -3
  153. package/{.claude/commands/plan.md → .versions/1.0.0/.pi/prompts/af-plan.md} +1 -1
  154. package/.versions/{0.0.11/.claude/commands/review.md → 1.0.0/.pi/prompts/af-review.md} +3 -3
  155. package/.versions/1.0.0/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  156. package/.versions/1.0.0/.pi/prompts/af-ship.md +17 -0
  157. package/.versions/{0.0.11/.claude/commands/spec.md → 1.0.0/.pi/prompts/af-spec.md} +1 -1
  158. package/.versions/{0.0.11/.claude/commands/test.md → 1.0.0/.pi/prompts/af-test.md} +2 -2
  159. package/.versions/1.0.0/.pi/skills/bowser/SKILL.md +145 -0
  160. package/.versions/1.0.0/.version +1 -0
  161. package/.versions/1.0.0/agents/architect.md +24 -0
  162. package/.versions/1.0.0/agents/bowser.md +27 -0
  163. package/.versions/1.0.0/agents/builder.md +54 -0
  164. package/.versions/1.0.0/agents/code-reviewer.md +208 -0
  165. package/.versions/1.0.0/agents/deep-researcher.md +32 -0
  166. package/.versions/1.0.0/agents/documenter.md +18 -0
  167. package/.versions/1.0.0/agents/orchestrator.md +72 -0
  168. package/.versions/1.0.0/agents/plan-reviewer.md +83 -0
  169. package/.versions/1.0.0/agents/planner.md +70 -0
  170. package/.versions/1.0.0/agents/releaser.md +24 -0
  171. package/.versions/1.0.0/agents/researcher.md +28 -0
  172. package/.versions/1.0.0/agents/security-auditor.md +167 -0
  173. package/.versions/1.0.0/agents/test-engineer.md +153 -0
  174. package/.versions/1.0.0/agents/web-debugger.md +43 -0
  175. package/.versions/1.0.0/agents/web-performance-auditor.md +193 -0
  176. package/.versions/1.0.0/codex/CONDUCTOR.md +148 -0
  177. package/.versions/1.0.0/docs/ARCHITECTURE.md +337 -0
  178. package/.versions/1.0.0/docs/agent-fleet-setup.md +437 -0
  179. package/.versions/1.0.0/docs/claude-code-coms-bridge.md +128 -0
  180. package/.versions/1.0.0/docs/codex-remote-conductor.md +170 -0
  181. package/.versions/1.0.0/docs/coms-hermes-bridge.md +189 -0
  182. package/.versions/1.0.0/docs/getting-started.md +98 -0
  183. package/.versions/1.0.0/docs/npm-install.md +292 -0
  184. package/.versions/1.0.0/docs/pi-extensions.md +412 -0
  185. package/.versions/1.0.0/docs/pi-setup.md +74 -0
  186. package/.versions/1.0.0/docs/skill-anatomy.md +150 -0
  187. package/.versions/1.0.0/hermes/README.md +347 -0
  188. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  189. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  190. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  191. package/.versions/1.0.0/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  192. package/.versions/1.0.0/hermes/gates/gate-o-capability.md +8 -0
  193. package/.versions/1.0.0/hermes/gates/gate-o-validator-fixtures.json +1 -0
  194. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  195. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  196. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  197. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  198. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  199. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  200. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  201. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  202. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  203. package/.versions/1.0.0/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  204. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  205. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  206. package/.versions/1.0.0/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  207. package/.versions/1.0.0/hermes/skills/hub-conductor/SKILL.md +84 -0
  208. package/.versions/1.0.0/hermes/skills/hub-liaison/SKILL.md +84 -0
  209. package/.versions/1.0.0/hermes/skills/hub-watchdog/SKILL.md +76 -0
  210. package/.versions/1.0.0/hermes/skills/hub-watchdog/manifest.json +1 -0
  211. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  212. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  213. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  214. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  215. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  216. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  217. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  218. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  219. package/.versions/1.0.0/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  220. package/.versions/1.0.0/hermes/watchdog-tests/__init__.py +0 -0
  221. package/.versions/1.0.0/hooks/coms-stop-hook.mjs +84 -0
  222. package/.versions/1.0.0/install-manifest.json +2745 -0
  223. package/.versions/1.0.0/justfile +272 -0
  224. package/.versions/1.0.0/manifest-meta.json +882 -0
  225. package/.versions/1.0.0/references/accessibility-checklist.md +160 -0
  226. package/.versions/1.0.0/references/definition-of-done.md +67 -0
  227. package/.versions/1.0.0/references/fleet-coordination-patterns.md +151 -0
  228. package/.versions/1.0.0/references/observability-checklist.md +91 -0
  229. package/.versions/1.0.0/references/orchestration-patterns.md +370 -0
  230. package/.versions/1.0.0/references/performance-checklist.md +153 -0
  231. package/.versions/1.0.0/references/prompting-patterns.md +380 -0
  232. package/.versions/1.0.0/references/security-checklist.md +179 -0
  233. package/.versions/1.0.0/references/testing-patterns.md +236 -0
  234. package/.versions/1.0.0/scripts/codex-conductor.ts +41 -0
  235. package/.versions/1.0.0/scripts/codex-remote-control.ts +167 -0
  236. package/.versions/1.0.0/scripts/coms-claude-bridge.ts +411 -0
  237. package/.versions/1.0.0/scripts/coms-cli.ts +484 -0
  238. package/.versions/1.0.0/scripts/coms-hermes-bridge.ts +413 -0
  239. package/.versions/1.0.0/scripts/fleet.ts +185 -0
  240. package/.versions/1.0.0/scripts/hermes-monitor-capability-runner.ts +25 -0
  241. package/.versions/1.0.0/scripts/hermes-monitor-scenario.ts +474 -0
  242. package/.versions/1.0.0/scripts/hermes-watchdog-capability-probe.ts +45 -0
  243. package/.versions/1.0.0/scripts/install-hermes-plugin.sh +180 -0
  244. package/.versions/1.0.0/scripts/lib/claude-bridge-core.ts +210 -0
  245. package/.versions/1.0.0/scripts/lib/codex-conductor.ts +88 -0
  246. package/.versions/1.0.0/scripts/lib/codex-remote-control.ts +480 -0
  247. package/.versions/1.0.0/scripts/lib/coms-envelope.ts +582 -0
  248. package/.versions/1.0.0/scripts/lib/fake-herdr-server.ts +88 -0
  249. package/.versions/1.0.0/scripts/lib/fleet-command.ts +266 -0
  250. package/.versions/1.0.0/scripts/lib/herdr-layout.ts +281 -0
  251. package/.versions/1.0.0/scripts/lib/hermes-bridge-core.ts +241 -0
  252. package/.versions/1.0.0/scripts/lib/hermes-monitor-events.ts +1 -0
  253. package/.versions/1.0.0/scripts/lib/hermes-monitor-herdr.ts +2 -0
  254. package/.versions/1.0.0/scripts/lib/hermes-monitor-model.ts +3 -0
  255. package/.versions/1.0.0/scripts/lib/hermes-monitor-registry.ts +2 -0
  256. package/.versions/1.0.0/scripts/lib/hermes-monitor-socket.ts +2 -0
  257. package/.versions/1.0.0/scripts/lib/hermes-monitor-store.ts +2 -0
  258. package/.versions/1.0.0/scripts/lib/monitor-env.ts +146 -0
  259. package/.versions/1.0.0/scripts/lib/peer-launch.ts +318 -0
  260. package/.versions/1.0.0/scripts/lib/persona-banner.ts +62 -0
  261. package/.versions/1.0.0/scripts/lib/spawn-stagger.ts +101 -0
  262. package/.versions/1.0.0/scripts/lib/team-project.ts +213 -0
  263. package/.versions/1.0.0/scripts/lib/team-snapshot.ts +147 -0
  264. package/.versions/1.0.0/scripts/peer-banner.ts +40 -0
  265. package/.versions/1.0.0/scripts/peer-launch.ts +259 -0
  266. package/.versions/1.0.0/scripts/team-snapshot.ts +237 -0
  267. package/.versions/1.0.0/scripts/team-up.ts +406 -0
  268. package/.versions/1.0.0/skills/_internal/grilling.md +11 -0
  269. package/.versions/1.0.0/skills/browser-testing-with-devtools/SKILL.md +351 -0
  270. package/.versions/1.0.0/skills/code-review-and-quality/SKILL.md +381 -0
  271. package/.versions/1.0.0/skills/compound-learning/SKILL.md +137 -0
  272. package/.versions/1.0.0/skills/context-engineering/SKILL.md +291 -0
  273. package/.versions/1.0.0/skills/deprecation-and-migration/SKILL.md +206 -0
  274. package/.versions/1.0.0/skills/designing-agents/SKILL.md +394 -0
  275. package/.versions/1.0.0/skills/designing-agents/pi-harness-authoring.md +222 -0
  276. package/.versions/1.0.0/skills/frontend-ui-engineering/SKILL.md +328 -0
  277. package/.versions/1.0.0/skills/git-workflow-and-versioning/SKILL.md +316 -0
  278. package/.versions/1.0.0/skills/idea-refine/SKILL.md +182 -0
  279. package/.versions/1.0.0/skills/idea-refine/examples.md +238 -0
  280. package/.versions/1.0.0/skills/idea-refine/frameworks.md +99 -0
  281. package/.versions/1.0.0/skills/idea-refine/refinement-criteria.md +113 -0
  282. package/.versions/1.0.0/skills/idea-refine/scripts/idea-refine.sh +15 -0
  283. package/.versions/1.0.0/skills/incremental-implementation/SKILL.md +287 -0
  284. package/.versions/1.0.0/skills/interview-me/SKILL.md +226 -0
  285. package/.versions/1.0.0/skills/orchestration-verification/SKILL.md +181 -0
  286. package/.versions/1.0.0/skills/peer-coms/SKILL.md +90 -0
  287. package/.versions/1.0.0/skills/performance-optimization/SKILL.md +350 -0
  288. package/.versions/1.0.0/skills/planning-and-task-breakdown/SKILL.md +254 -0
  289. package/.versions/1.0.0/skills/security-and-hardening/SKILL.md +461 -0
  290. package/.versions/1.0.0/skills/spec-driven-development/SKILL.md +257 -0
  291. package/.versions/1.0.0/skills/using-agent-skills/SKILL.md +199 -0
  292. package/.versions/1.0.0/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  293. package/.versions/1.0.0/vendor/agent-skills-upstream/LICENSE +21 -0
  294. package/.versions/1.0.0/vendor/agent-skills-upstream/README.md +11 -0
  295. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  296. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  297. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  298. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  299. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  300. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  301. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  302. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  303. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  304. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  305. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  306. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  307. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  308. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  309. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  310. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  311. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  312. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  313. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  314. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  315. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  316. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  317. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  318. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  319. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  320. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  321. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  322. package/.versions/1.0.0/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  323. package/CHANGELOG.md +142 -0
  324. package/README.md +117 -79
  325. package/agents/orchestrator.md +1 -1
  326. package/bin/cli.js +289 -359
  327. package/bin/force-patch-changesets.js +18 -2
  328. package/bin/lib/apply.js +86 -32
  329. package/bin/lib/desired.js +87 -0
  330. package/bin/lib/detect-agent.js +22 -38
  331. package/bin/lib/doctor.js +283 -33
  332. package/bin/lib/features.js +78 -0
  333. package/bin/lib/manifest.js +127 -48
  334. package/bin/lib/overrides.js +35 -0
  335. package/bin/lib/personas.js +37 -0
  336. package/bin/lib/plan.js +18 -9
  337. package/bin/lib/purge.js +11 -0
  338. package/bin/lib/reconcile.js +68 -0
  339. package/bin/lib/scan.js +24 -0
  340. package/bin/lib/state.js +25 -1
  341. package/bin/lib/stt-wizard.js +33 -0
  342. package/bin/lib/transaction.js +149 -0
  343. package/bin/lib/tui.js +71 -0
  344. package/bin/lib/verify.js +9 -26
  345. package/bin/snapshot-version.js +3 -6
  346. package/docs/ARCHITECTURE.md +55 -21
  347. package/docs/MIGRATION-agent-fleet.md +222 -0
  348. package/docs/agent-fleet-setup.md +124 -64
  349. package/docs/claude-code-coms-bridge.md +21 -2
  350. package/docs/coms-hermes-bridge.md +1 -1
  351. package/docs/getting-started.md +61 -217
  352. package/docs/npm-install.md +207 -429
  353. package/docs/pi-extensions.md +85 -41
  354. package/docs/pi-setup.md +48 -545
  355. package/hermes/README.md +1 -1
  356. package/install-manifest.json +385 -1255
  357. package/justfile +45 -27
  358. package/manifest-meta.json +544 -134
  359. package/node_modules/pi-ask-user/README.md +43 -5
  360. package/node_modules/pi-ask-user/index.ts +630 -75
  361. package/node_modules/pi-ask-user/package.json +1 -1
  362. package/package.json +5 -11
  363. package/scripts/coms-claude-bridge.ts +10 -0
  364. package/scripts/fleet.ts +107 -90
  365. package/scripts/lib/claude-bridge-core.ts +45 -0
  366. package/scripts/lib/fleet-command.ts +170 -15
  367. package/scripts/lib/monitor-env.ts +18 -6
  368. package/scripts/lib/peer-launch.ts +6 -2
  369. package/scripts/lib/team-project.ts +24 -4
  370. package/scripts/team-up.ts +57 -11
  371. package/skills/designing-agents/SKILL.md +1 -1
  372. package/skills/designing-agents/pi-harness-authoring.md +3 -3
  373. package/.claude/commands/build.md +0 -44
  374. package/.claude/commands/design-agent.md +0 -14
  375. package/.claude/commands/doctor-agent-fleet.md +0 -22
  376. package/.claude/commands/orchestrate.md +0 -112
  377. package/.claude/commands/prime.md +0 -22
  378. package/.claude/commands/review.md +0 -16
  379. package/.claude/commands/set-hermes-telegram.md +0 -15
  380. package/.claude/commands/set-hermes-watchdog.md +0 -6
  381. package/.claude/commands/setup-agent-fleet.md +0 -17
  382. package/.claude/commands/ship.md +0 -72
  383. package/.claude/commands/spec.md +0 -15
  384. package/.claude/commands/test.md +0 -19
  385. package/.claude/commands/webperf.md +0 -32
  386. package/.claude/orchestrate-teams.yaml +0 -24
  387. package/.opencode/commands/af-build.md +0 -17
  388. package/.opencode/commands/af-code-simplify.md +0 -16
  389. package/.opencode/commands/af-compound.md +0 -16
  390. package/.opencode/commands/af-design-agent.md +0 -15
  391. package/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  392. package/.opencode/commands/af-orchestrate.md +0 -112
  393. package/.opencode/commands/af-plan.md +0 -16
  394. package/.opencode/commands/af-prime.md +0 -22
  395. package/.opencode/commands/af-review.md +0 -15
  396. package/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  397. package/.opencode/commands/af-setup-agent-fleet.md +0 -17
  398. package/.opencode/commands/af-ship.md +0 -16
  399. package/.opencode/commands/af-spec.md +0 -16
  400. package/.opencode/commands/af-test.md +0 -21
  401. package/.opencode/commands/af-webperf.md +0 -32
  402. package/.opencode/orchestrate-teams.yaml +0 -24
  403. package/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  404. package/.pi/prompts/af-setup-agent-fleet.md +0 -19
  405. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +0 -15
  406. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +0 -15
  407. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +0 -506
  408. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  409. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +0 -17
  410. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  411. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +0 -19
  412. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +0 -226
  413. package/.versions/0.0.11/.claude/commands/build.md +0 -44
  414. package/.versions/0.0.11/.claude/commands/code-simplify.md +0 -22
  415. package/.versions/0.0.11/.claude/commands/design-agent.md +0 -14
  416. package/.versions/0.0.11/.claude/commands/doctor-agent-fleet.md +0 -22
  417. package/.versions/0.0.11/.claude/commands/orchestrate.md +0 -112
  418. package/.versions/0.0.11/.claude/commands/plan.md +0 -16
  419. package/.versions/0.0.11/.claude/commands/prime.md +0 -22
  420. package/.versions/0.0.11/.claude/commands/set-hermes-telegram.md +0 -15
  421. package/.versions/0.0.11/.claude/commands/set-hermes-watchdog.md +0 -6
  422. package/.versions/0.0.11/.claude/commands/setup-agent-fleet.md +0 -17
  423. package/.versions/0.0.11/.claude/commands/ship.md +0 -72
  424. package/.versions/0.0.11/.claude/commands/webperf.md +0 -32
  425. package/.versions/0.0.11/.claude/orchestrate-teams.yaml +0 -24
  426. package/.versions/0.0.11/.opencode/commands/af-build.md +0 -17
  427. package/.versions/0.0.11/.opencode/commands/af-code-simplify.md +0 -16
  428. package/.versions/0.0.11/.opencode/commands/af-compound.md +0 -16
  429. package/.versions/0.0.11/.opencode/commands/af-design-agent.md +0 -15
  430. package/.versions/0.0.11/.opencode/commands/af-doctor-agent-fleet.md +0 -22
  431. package/.versions/0.0.11/.opencode/commands/af-orchestrate.md +0 -112
  432. package/.versions/0.0.11/.opencode/commands/af-plan.md +0 -16
  433. package/.versions/0.0.11/.opencode/commands/af-prime.md +0 -22
  434. package/.versions/0.0.11/.opencode/commands/af-review.md +0 -15
  435. package/.versions/0.0.11/.opencode/commands/af-set-hermes-telegram.md +0 -15
  436. package/.versions/0.0.11/.opencode/commands/af-set-hermes-watchdog.md +0 -6
  437. package/.versions/0.0.11/.opencode/commands/af-setup-agent-fleet.md +0 -17
  438. package/.versions/0.0.11/.opencode/commands/af-ship.md +0 -16
  439. package/.versions/0.0.11/.opencode/commands/af-spec.md +0 -16
  440. package/.versions/0.0.11/.opencode/commands/af-test.md +0 -21
  441. package/.versions/0.0.11/.opencode/commands/af-webperf.md +0 -32
  442. package/.versions/0.0.11/.opencode/orchestrate-teams.yaml +0 -24
  443. package/.versions/0.0.11/.pi/prompts/af-doctor-agent-fleet.md +0 -22
  444. package/.versions/0.0.11/.pi/prompts/af-setup-agent-fleet.md +0 -19
  445. package/.versions/0.0.11/docs/opencode-setup.md +0 -281
  446. package/.versions/0.0.11/hooks/SIMPLIFY-IGNORE.md +0 -90
  447. package/.versions/0.0.11/hooks/hooks.json +0 -14
  448. package/.versions/0.0.11/hooks/session-start.sh +0 -74
  449. package/.versions/0.0.11/hooks/simplify-ignore.sh +0 -302
  450. package/.versions/0.0.11/skills/guided-workspace-setup/SKILL.md +0 -226
  451. package/.versions/0.0.4/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  452. package/.versions/0.0.4/.opencode/commands/af-setup-agent-fleet.md +0 -15
  453. package/.versions/0.0.4/skills/guided-workspace-setup/SKILL.md +0 -535
  454. package/.versions/0.0.4/skills/guided-workspace-setup/companion-manifest.json +0 -33
  455. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  456. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +0 -15
  457. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +0 -542
  458. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +0 -35
  459. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  460. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +0 -15
  461. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  462. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +0 -27
  463. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +0 -544
  464. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +0 -35
  465. package/.versions/0.0.7/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  466. package/.versions/0.0.7/.opencode/commands/af-setup-agent-fleet.md +0 -15
  467. package/.versions/0.0.7/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  468. package/.versions/0.0.7/.pi/prompts/af-setup-agent-fleet.md +0 -27
  469. package/.versions/0.0.7/skills/guided-workspace-setup/SKILL.md +0 -544
  470. package/.versions/0.0.7/skills/guided-workspace-setup/companion-manifest.json +0 -35
  471. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  472. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +0 -15
  473. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  474. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +0 -27
  475. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +0 -544
  476. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +0 -36
  477. package/.versions/0.0.9/.opencode/commands/af-doctor-agent-fleet.md +0 -17
  478. package/.versions/0.0.9/.opencode/commands/af-setup-agent-fleet.md +0 -15
  479. package/.versions/0.0.9/.pi/prompts/af-doctor-agent-fleet.md +0 -15
  480. package/.versions/0.0.9/.pi/prompts/af-setup-agent-fleet.md +0 -27
  481. package/.versions/0.0.9/skills/guided-workspace-setup/SKILL.md +0 -544
  482. package/bin/lib/bootstrap.js +0 -323
  483. package/bin/lib/transform-persona.js +0 -180
  484. package/docs/opencode-setup.md +0 -281
  485. package/hooks/SIMPLIFY-IGNORE.md +0 -90
  486. package/hooks/hooks.json +0 -14
  487. package/hooks/session-start.sh +0 -74
  488. package/hooks/simplify-ignore.sh +0 -302
  489. package/skills/guided-workspace-setup/SKILL.md +0 -226
  490. /package/.versions/0.0.10/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  491. /package/.versions/0.0.11/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
  492. /package/{.opencode/commands → .versions/1.0.0/.pi/prompts}/af-set-hermes-telegram.md +0 -0
  493. /package/.versions/{0.0.9/skills/guided-workspace-setup/companion-manifest.json → 1.0.0/bin/catalog/harness-runtime-closure.json} +0 -0
  494. /package/{skills/guided-workspace-setup/companion-manifest.json → bin/catalog/harness-runtime-closure.json} +0 -0
package/bin/lib/doctor.js CHANGED
@@ -1,8 +1,8 @@
1
1
  // Doctor scan — deterministic preflight extracted from
2
- // guided-workspace-setup Step 5. Both `agent-fleet doctor` (CLI) and the
2
+ // Both `agent-fleet doctor` (CLI) and the
3
3
  // Runtime-specific Agent Fleet doctor slash commands call into this so behaviour cannot drift.
4
4
  //
5
- // Three classes of findings:
5
+ // Finding classes:
6
6
  // 1. Broken symlinks — links whose source has been moved, renamed, or deleted
7
7
  // 2. Stale persona refs — YAML configs (teams.yaml, peers.yaml) that
8
8
  // still name a persona which no longer exists in the source tree
@@ -13,15 +13,23 @@
13
13
  // 4. Overrides-file problems — unknown sections/keys, invalid values, and
14
14
  // unset declared env vars in .ai/agent-fleet-overrides.md. Advisory
15
15
  // only: reported, never auto-fixed (the fix is always a hand edit).
16
+ // 5. Mixed skill/prompt ownership — project/global Pi settings enable
17
+ // `@chankov/agent-fleet` skills/prompts while `.ai/agent-fleet-state.json`
18
+ // also owns matching copied `skill:*` / `command:*` items. Advisory only:
19
+ // package vs copy ownership is a user choice; doctor --fix never mutates it.
16
20
  //
17
21
  // For each broken link we look up a canonical replacement in the source
18
22
  // `agents/` or `skills/` tree (many breakages are stale names from the
19
23
  // pre-merge layout, e.g. `reviewer` → `code-reviewer`).
20
24
 
21
25
  import { readdirSync, readlinkSync, existsSync, lstatSync, statSync, unlinkSync, symlinkSync, readFileSync, writeFileSync } from "node:fs";
22
- import { join, resolve, dirname, basename, relative, isAbsolute } from "node:path";
23
- import { transformPersona } from "./transform-persona.js";
26
+ import { join, resolve, dirname, basename, relative, isAbsolute, sep } from "node:path";
27
+ import { homedir } from "node:os";
24
28
  import { validateOverrides } from "./validate-overrides.js";
29
+ import { readState, STATE_REL_PATH } from "./state.js";
30
+
31
+ export const AGENT_FLEET_PACKAGE_NAME = "@chankov/agent-fleet";
32
+ const AGENT_FLEET_PACKAGE_PATTERN = /(^|[/:])@chankov\/agent-fleet(@[^/]*)?$/;
25
33
 
26
34
  // Known canonical replacements for personas renamed during the merge.
27
35
  const PERSONA_RENAMES = {
@@ -32,24 +40,22 @@ const PERSONA_RENAMES = {
32
40
  };
33
41
 
34
42
  // Install-target directories the scanner walks, when present.
43
+ //
44
+ // `.claude/hooks` is the odd one out and belongs here on purpose: the coms
45
+ // bridge's Stop hook is the one artifact pi installs into a Claude Code
46
+ // directory, because the pane reading it is a Claude Code process
47
+ // (docs/claude-code-coms-bridge.md).
35
48
  const TARGET_DIRS = [
36
49
  // Personas
37
50
  "agents",
38
- ".claude/agents",
39
- ".opencode/agent",
40
- ".opencode/agents", // legacy plural form from older installs
41
51
  ".pi/agents",
42
52
  // Skills
43
- ".claude/skills",
44
- ".opencode/skills",
45
53
  ".pi/skills",
46
54
  ".agents/skills",
47
- // Commands / prompts
48
- ".claude/commands",
49
- ".opencode/commands",
55
+ // Prompts
50
56
  ".pi/prompts",
51
- // References + hooks
52
- ".claude/references",
57
+ // References + coms bridge hook
58
+ ".pi/references",
53
59
  ".claude/hooks",
54
60
  ];
55
61
 
@@ -99,25 +105,14 @@ export async function runDoctor({ workspace, sourceRoot, apply = false }) {
99
105
  sourceRoot,
100
106
  });
101
107
 
102
- // Personas under .claude/agents/ and .opencode/agent(s)/ must be
103
- // GENERATED from the canonical source, never symlinked raw — a raw
104
- // link would expose the untransformed pi-flavored frontmatter.
105
- const personaAgent =
106
- rel === ".claude/agents" ? "claude-code"
107
- : rel === ".opencode/agent" || rel === ".opencode/agents" ? "opencode"
108
- : null;
109
-
110
108
  findings.push({
111
109
  type: "broken-symlink",
112
110
  path: relative(workspace, fullPath),
113
111
  issue: `broken symlink → missing ${relative(workspace, absTarget)}`,
114
112
  fix: replacement
115
- ? personaAgent
116
- ? `regenerate from ${relative(workspace, join(sourceRoot, replacement))} (transformed for ${personaAgent})`
117
- : `repoint to ${relative(workspace, join(sourceRoot, replacement))}`
113
+ ? `repoint to ${relative(workspace, join(sourceRoot, replacement))}`
118
114
  : "delete",
119
115
  replacement,
120
- personaAgent,
121
116
  absPath: fullPath,
122
117
  });
123
118
  }
@@ -157,6 +152,9 @@ export async function runDoctor({ workspace, sourceRoot, apply = false }) {
157
152
  // 4. Advisory validation of the overrides file (never auto-fixed).
158
153
  findings.push(...validateOverrides({ workspace }));
159
154
 
155
+ // 5. Mixed copied / package-native skill+prompt ownership (advisory, never auto-fixed).
156
+ findings.push(...scanPiPackageOwnership({ workspace, sourceRoot }));
157
+
160
158
  if (!apply) return findings;
161
159
 
162
160
  // ── Apply ──────────────────────────────────────────────────────────────
@@ -165,13 +163,7 @@ export async function runDoctor({ workspace, sourceRoot, apply = false }) {
165
163
  for (const f of findings) {
166
164
  try {
167
165
  if (f.type === "broken-symlink") {
168
- if (f.replacement && f.personaAgent) {
169
- const source = readFileSync(join(sourceRoot, f.replacement), "utf8");
170
- const { content } = transformPersona(source, { agent: f.personaAgent });
171
- unlinkSync(f.absPath);
172
- writeFileSync(f.absPath, content);
173
- repaired++;
174
- } else if (f.replacement) {
166
+ if (f.replacement) {
175
167
  const newTarget = join(sourceRoot, f.replacement);
176
168
  unlinkSync(f.absPath);
177
169
  symlinkSync(newTarget, f.absPath);
@@ -300,3 +292,261 @@ function findReplacement({ brokenName, kind, sourceRoot }) {
300
292
 
301
293
  return null;
302
294
  }
295
+
296
+ // ── mixed copied / package-native ownership ─────────────────────────────────
297
+
298
+ /**
299
+ * Parse a Pi settings `packages` entry into a normalized source + filters shape.
300
+ * String entries enable every resource type. Object entries follow Pi filter rules:
301
+ * omit a key to load all of that type, `[]` loads none, patterns narrow the set.
302
+ *
303
+ * @param {unknown} entry
304
+ * @returns {{ source: string, filters: { skills?: unknown, prompts?: unknown, extensions?: unknown, themes?: unknown }, raw: unknown } | null}
305
+ */
306
+ export function parsePiPackageEntry(entry) {
307
+ if (typeof entry === "string" && entry.trim()) {
308
+ return { source: entry.trim(), filters: {}, raw: entry };
309
+ }
310
+ if (entry && typeof entry === "object" && typeof entry.source === "string" && entry.source.trim()) {
311
+ return {
312
+ source: entry.source.trim(),
313
+ filters: {
314
+ skills: entry.skills,
315
+ prompts: entry.prompts,
316
+ extensions: entry.extensions,
317
+ themes: entry.themes,
318
+ },
319
+ raw: entry,
320
+ };
321
+ }
322
+ return null;
323
+ }
324
+
325
+ /** True when a package source refers to `@chankov/agent-fleet` (npm identity, optional pin). */
326
+ export function isAgentFleetPackageSource(source) {
327
+ if (typeof source !== "string") return false;
328
+ return AGENT_FLEET_PACKAGE_PATTERN.test(source.trim());
329
+ }
330
+
331
+ /**
332
+ * Resolve the effective Agent Fleet package entry across project then global
333
+ * settings. Project wins unless it sets `autoload: false` (Pi delta semantics):
334
+ * in that case the project filters layer over the global entry.
335
+ *
336
+ * @param {object} opts
337
+ * @param {string} opts.workspace
338
+ * @param {string} [opts.home]
339
+ * @returns {{ entry: ReturnType<typeof parsePiPackageEntry>, settingsPath: string } | null}
340
+ */
341
+ export function findAgentFleetPackageEntry({ workspace, home = homedir() }) {
342
+ const projectPath = join(workspace, ".pi", "settings.json");
343
+ const globalPath = join(home, ".pi", "agent", "settings.json");
344
+ const project = readPackageEntries(projectPath).find((e) => isAgentFleetPackageSource(e.source)) ?? null;
345
+ const global = readPackageEntries(globalPath).find((e) => isAgentFleetPackageSource(e.source)) ?? null;
346
+
347
+ if (project) {
348
+ const autoload = project.raw && typeof project.raw === "object" ? project.raw.autoload : undefined;
349
+ if (autoload === false && global) {
350
+ return {
351
+ entry: {
352
+ source: project.source,
353
+ filters: { ...global.filters, ...project.filters },
354
+ raw: project.raw,
355
+ },
356
+ settingsPath: projectPath,
357
+ };
358
+ }
359
+ return { entry: project, settingsPath: projectPath };
360
+ }
361
+ if (global) return { entry: global, settingsPath: globalPath };
362
+ return null;
363
+ }
364
+
365
+ function readPackageEntries(settingsPath) {
366
+ if (!existsSync(settingsPath)) return [];
367
+ let packages;
368
+ try {
369
+ packages = JSON.parse(readFileSync(settingsPath, "utf8"))?.packages;
370
+ } catch {
371
+ return [];
372
+ }
373
+ if (!Array.isArray(packages)) return [];
374
+ return packages.map(parsePiPackageEntry).filter(Boolean);
375
+ }
376
+
377
+ /**
378
+ * Decide whether a resource type is enabled by a package filter.
379
+ * Omit/undefined → all; empty array → none; non-empty → treated as enabled
380
+ * (name-level filter matching is applied later against concrete names).
381
+ */
382
+ export function resourceTypeEnabled(filter) {
383
+ if (filter === undefined) return true;
384
+ if (!Array.isArray(filter)) return true;
385
+ return filter.length > 0;
386
+ }
387
+
388
+ /**
389
+ * Whether a concrete resource name survives the package filter list.
390
+ * Patterns are basename / relative-path globs simplified to:
391
+ * - exact name or path segment match
392
+ * - `!name` / `!path` exclusions
393
+ * - `*` wildcards via simple glob → RegExp
394
+ * Empty/omitted filter admits every name.
395
+ */
396
+ export function resourceNameAllowed(name, filter) {
397
+ if (filter === undefined) return true;
398
+ if (!Array.isArray(filter)) return true;
399
+ if (filter.length === 0) return false;
400
+
401
+ let allowed = false;
402
+ let sawPositive = false;
403
+ for (const raw of filter) {
404
+ if (typeof raw !== "string" || !raw) continue;
405
+ const negated = raw.startsWith("!") || raw.startsWith("-");
406
+ const pattern = negated ? raw.slice(1) : raw.startsWith("+") ? raw.slice(1) : raw;
407
+ const matches = matchResourcePattern(name, pattern);
408
+ if (negated) {
409
+ if (matches) allowed = false;
410
+ continue;
411
+ }
412
+ sawPositive = true;
413
+ if (matches) allowed = true;
414
+ }
415
+ // Pi: a filter list of only exclusions still starts from the full set.
416
+ if (!sawPositive) return allowed !== false ? true : false;
417
+ return allowed;
418
+ }
419
+
420
+ function matchResourcePattern(name, pattern) {
421
+ const base = basename(pattern).replace(/\/+$/, "");
422
+ const bare = base.replace(/\.md$/i, "");
423
+ if (bare === name || base === name || pattern === name) return true;
424
+ // Path-ish patterns: skills/foo or prompts/af-build.md
425
+ if (pattern.includes(name)) return true;
426
+ if (!pattern.includes("*") && !pattern.includes("?")) return false;
427
+ const re = new RegExp(
428
+ `^${escapeRe(pattern).replaceAll("\\*", ".*").replaceAll("\\?", ".")}$`,
429
+ "i",
430
+ );
431
+ return re.test(name) || re.test(base) || re.test(pattern);
432
+ }
433
+
434
+ /** Skill directory names the Agent Fleet package exposes via its pi manifest. */
435
+ export function listPackageSkillNames(sourceRoot) {
436
+ const roots = [
437
+ join(sourceRoot, "skills"),
438
+ join(sourceRoot, "vendor", "agent-skills-upstream", "skills"),
439
+ join(sourceRoot, ".pi", "skills"),
440
+ ];
441
+ const names = new Set();
442
+ for (const root of roots) {
443
+ if (!existsSync(root)) continue;
444
+ let entries;
445
+ try { entries = readdirSync(root, { withFileTypes: true }); }
446
+ catch { continue; }
447
+ for (const entry of entries) {
448
+ if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
449
+ if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
450
+ if (existsSync(join(root, entry.name, "SKILL.md"))) names.add(entry.name);
451
+ }
452
+ }
453
+ return [...names].sort();
454
+ }
455
+
456
+ /** Prompt template basenames (no `.md`) the package exposes. */
457
+ export function listPackagePromptNames(sourceRoot) {
458
+ const dir = join(sourceRoot, ".pi", "prompts");
459
+ if (!existsSync(dir)) return [];
460
+ let entries;
461
+ try { entries = readdirSync(dir, { withFileTypes: true }); }
462
+ catch { return []; }
463
+ return entries
464
+ .filter((e) => (e.isFile() || e.isSymbolicLink()) && e.name.endsWith(".md"))
465
+ .map((e) => e.name.replace(/\.md$/i, ""))
466
+ .sort();
467
+ }
468
+
469
+ /**
470
+ * Names of copied skills/prompts owned by the workspace state file.
471
+ * Skills use the `skill:<name>` id; prompts are taken from recorded file paths
472
+ * under `.pi/prompts/` so they match Pi's template names (`af-build`, …).
473
+ */
474
+ export function listCopiedSkillAndPromptNames(state) {
475
+ const skills = new Set();
476
+ const prompts = new Set();
477
+ if (!state?.items || typeof state.items !== "object") return { skills, prompts };
478
+
479
+ for (const [id, item] of Object.entries(state.items)) {
480
+ if (id.startsWith("skill:")) {
481
+ skills.add(id.slice("skill:".length));
482
+ continue;
483
+ }
484
+ if (id.startsWith("pi-runtime-skill:")) {
485
+ skills.add(id.slice("pi-runtime-skill:".length));
486
+ continue;
487
+ }
488
+ if (!id.startsWith("command:")) continue;
489
+ for (const file of item?.files ?? []) {
490
+ const rel = typeof file === "string" ? file : file?.path;
491
+ if (typeof rel !== "string") continue;
492
+ const normalized = rel.split(sep).join("/");
493
+ const m = normalized.match(/(?:^|\/)\.pi\/prompts\/([^/]+)\.md$/i);
494
+ if (m) prompts.add(m[1]);
495
+ }
496
+ // Fall back to sourceRoot on older state shapes.
497
+ if (typeof item?.sourceRoot === "string") {
498
+ const m = item.sourceRoot.split(sep).join("/").match(/(?:^|\/)\.pi\/prompts\/([^/]+)\.md$/i);
499
+ if (m) prompts.add(m[1]);
500
+ }
501
+ }
502
+ return { skills, prompts };
503
+ }
504
+
505
+ /**
506
+ * Advisory finding when package-native Agent Fleet skills/prompts overlap
507
+ * copied install items. Never auto-fixed — the user must pick one ownership path.
508
+ */
509
+ export function scanPiPackageOwnership({ workspace, sourceRoot, home = homedir() }) {
510
+ const located = findAgentFleetPackageEntry({ workspace, home });
511
+ if (!located) return [];
512
+
513
+ const skillsEnabled = resourceTypeEnabled(located.entry.filters.skills);
514
+ const promptsEnabled = resourceTypeEnabled(located.entry.filters.prompts);
515
+ if (!skillsEnabled && !promptsEnabled) return [];
516
+
517
+ const state = readState(workspace);
518
+ if (!state) return [];
519
+ const copied = listCopiedSkillAndPromptNames(state);
520
+
521
+ const packageSkills = skillsEnabled
522
+ ? listPackageSkillNames(sourceRoot).filter((name) => resourceNameAllowed(name, located.entry.filters.skills))
523
+ : [];
524
+ const packagePrompts = promptsEnabled
525
+ ? listPackagePromptNames(sourceRoot).filter((name) => resourceNameAllowed(name, located.entry.filters.prompts))
526
+ : [];
527
+
528
+ const skillOverlap = packageSkills.filter((name) => copied.skills.has(name)).sort();
529
+ const promptOverlap = packagePrompts.filter((name) => copied.prompts.has(name)).sort();
530
+ if (skillOverlap.length === 0 && promptOverlap.length === 0) return [];
531
+
532
+ const parts = [];
533
+ if (skillOverlap.length) parts.push(`skills: ${skillOverlap.join(", ")}`);
534
+ if (promptOverlap.length) parts.push(`prompts: ${promptOverlap.join(", ")}`);
535
+
536
+ return [{
537
+ type: "pi-package-ownership",
538
+ path: STATE_REL_PATH,
539
+ issue:
540
+ `mixed ownership — Pi package "${located.entry.source}" (from ${relative(workspace, located.settingsPath) || located.settingsPath}) ` +
541
+ `and copied Agent Fleet items both expose ${parts.join("; ")}. Pi keeps the first discovery and warns on collisions.`,
542
+ fix:
543
+ "pick one ownership path: (1) copied skills/prompts — disable Agent Fleet package skills/prompts " +
544
+ "(`pi config`, or object-form filters with `\"skills\": []`, `\"prompts\": []`) and keep harnesses; " +
545
+ "or (2) package-native skills/prompts — `agent-fleet uninstall` the overlapping skill:*/command:* items " +
546
+ "and keep the Pi package entry. Harness-only composition (package skills + copied harnesses) is safe.",
547
+ skillOverlap,
548
+ promptOverlap,
549
+ packageSource: located.entry.source,
550
+ settingsPath: located.settingsPath,
551
+ }];
552
+ }
@@ -0,0 +1,78 @@
1
+ // features.js — resolve schema-v2 presets and supported capabilities.
2
+
3
+ import { resolveSelection } from "./manifest.js";
4
+
5
+ export function featureNames(manifest) {
6
+ return Object.keys(manifest.features ?? {}).sort();
7
+ }
8
+
9
+ export function normalizeFeatureSet(manifest, features) {
10
+ const known = new Set(featureNames(manifest));
11
+ const values = typeof features === "string"
12
+ ? (features === "none" ? [] : features.split(",").filter(Boolean))
13
+ : (features ?? []);
14
+ for (const feature of values) {
15
+ if (!known.has(feature)) throw new Error(`unknown feature "${feature}"`);
16
+ }
17
+ return [...new Set(values)].sort();
18
+ }
19
+
20
+ /** Resolve selected features with their feature dependencies (Telegram → Hermes). */
21
+ export function resolveFeatures(manifest, selected = [], { platform = process.platform } = {}) {
22
+ const features = manifest.features ?? {};
23
+ const enabled = new Set(normalizeFeatureSet(manifest, selected));
24
+ const visit = (name) => {
25
+ const feature = features[name];
26
+ if (!feature) throw new Error(`unknown feature "${name}"`);
27
+ if (feature.platform && feature.platform !== "any" && feature.platform !== platform) {
28
+ throw new Error(`feature "${name}" is unavailable on ${platform}`);
29
+ }
30
+ for (const dependency of feature.requiresFeatures ?? []) {
31
+ enabled.add(dependency);
32
+ visit(dependency);
33
+ }
34
+ };
35
+ for (const name of [...enabled]) visit(name);
36
+ return [...enabled].sort();
37
+ }
38
+
39
+ /** Resolve desired roots and their normal requires/companion closure. */
40
+ export function resolveDesiredFeatures(manifest, {
41
+ preset = "default",
42
+ features = undefined,
43
+ agent = "pi",
44
+ platform = process.platform,
45
+ } = {}) {
46
+ const declaration = manifest.presets?.[preset];
47
+ if (!declaration) throw new Error(`unknown preset "${preset}"`);
48
+ const enabledFeatures = resolveFeatures(
49
+ manifest,
50
+ features ?? (preset === "full"
51
+ ? featureNames(manifest).filter((name) => manifest.features[name].stability === "stable")
52
+ : []),
53
+ { platform },
54
+ );
55
+ const roots = new Set();
56
+
57
+ if (declaration.rule === "stable") {
58
+ for (const item of manifest.items ?? []) {
59
+ if (item.kind !== "companion" && item.stability === "stable" && item.agents?.[agent]
60
+ && (item.platform === "any" || item.platform === platform)) roots.add(item.id);
61
+ }
62
+ }
63
+ for (const item of declaration.items ?? []) roots.add(item);
64
+ for (const name of enabledFeatures) {
65
+ for (const item of manifest.features[name].items ?? []) roots.add(item);
66
+ }
67
+
68
+ const byId = new Map((manifest.items ?? []).map((item) => [item.id, item]));
69
+ for (const id of roots) {
70
+ const item = byId.get(id);
71
+ if (item && item.platform !== "any" && item.platform !== platform) {
72
+ throw new Error(`desired item "${id}" is unavailable on ${platform}`);
73
+ }
74
+ }
75
+ const resolution = resolveSelection(manifest, agent, { items: [...roots] });
76
+ if (resolution.unknown.length) throw new Error(`unavailable desired item(s): ${resolution.unknown.join(", ")}`);
77
+ return { preset, features: enabledFeatures, roots: [...roots].sort(), selected: resolution.selected };
78
+ }