@chankov/agent-fleet 1.0.0 → 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 (292) hide show
  1. package/.pi/agents/model-profiles.yaml +2 -2
  2. package/.pi/harnesses/agent-hub/README.md +12 -3
  3. package/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  4. package/.pi/harnesses/agent-hub/index.ts +121 -57
  5. package/.pi/harnesses/agent-hub/package.json +1 -1
  6. package/.pi/harnesses/agent-hub/run-budget.js +61 -0
  7. package/.pi/harnesses/coms/package.json +1 -1
  8. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  9. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +37 -0
  10. package/.versions/1.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  11. package/.versions/1.0.1/.pi/agents/model-profiles.yaml +27 -0
  12. package/.versions/1.0.1/.pi/agents/peers.yaml +142 -0
  13. package/.versions/1.0.1/.pi/agents/teams.yaml +41 -0
  14. package/.versions/1.0.1/.pi/damage-control-rules.yaml +297 -0
  15. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  16. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  17. package/.versions/1.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  18. package/.versions/1.0.1/.pi/extensions/btw/README.md +120 -0
  19. package/.versions/1.0.1/.pi/extensions/btw/index.ts +914 -0
  20. package/.versions/1.0.1/.pi/extensions/btw/package.json +6 -0
  21. package/.versions/1.0.1/.pi/extensions/btw/state.js +179 -0
  22. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  23. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  24. package/.versions/1.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  25. package/.versions/1.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  26. package/.versions/1.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  27. package/.versions/1.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  28. package/.versions/1.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  29. package/.versions/1.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  30. package/.versions/1.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  31. package/.versions/1.0.1/.pi/extensions/package-lock.json +1143 -0
  32. package/.versions/1.0.1/.pi/extensions/package.json +9 -0
  33. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/README.md +205 -0
  34. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  35. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  36. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  37. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  38. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  39. package/.versions/1.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  40. package/.versions/1.0.1/.pi/harnesses/agent-hub/README.md +1065 -0
  41. package/.versions/1.0.1/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  42. package/.versions/1.0.1/.pi/harnesses/agent-hub/artifacts.js +146 -0
  43. package/.versions/1.0.1/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  44. package/.versions/1.0.1/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  45. package/.versions/1.0.1/.pi/harnesses/agent-hub/context-window.js +106 -0
  46. package/.versions/1.0.1/.pi/harnesses/agent-hub/delegate.ts +435 -0
  47. package/.versions/1.0.1/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  48. package/.versions/1.0.1/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  49. package/.versions/1.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  50. package/.versions/1.0.1/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  51. package/.versions/1.0.1/.pi/harnesses/agent-hub/footer.ts +35 -0
  52. package/.versions/1.0.1/.pi/harnesses/agent-hub/helpers.ts +266 -0
  53. package/.versions/1.0.1/.pi/harnesses/agent-hub/hub-state-audit.js +55 -0
  54. package/.versions/1.0.1/.pi/harnesses/agent-hub/index.ts +9343 -0
  55. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  56. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  57. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  58. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  59. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  60. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  61. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  62. package/.versions/1.0.1/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  63. package/.versions/1.0.1/.pi/harnesses/agent-hub/package.json +7 -0
  64. package/.versions/1.0.1/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  65. package/.versions/1.0.1/.pi/harnesses/agent-hub/posture.ts +103 -0
  66. package/.versions/1.0.1/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  67. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-retention.js +34 -0
  68. package/.versions/1.0.1/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  69. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-contract.js +293 -0
  70. package/.versions/1.0.1/.pi/harnesses/agent-hub/return-extract.js +75 -0
  71. package/.versions/1.0.1/.pi/harnesses/agent-hub/review-findings.js +102 -0
  72. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-budget.js +540 -0
  73. package/.versions/1.0.1/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  74. package/.versions/1.0.1/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  75. package/.versions/1.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  76. package/.versions/1.0.1/.pi/harnesses/agent-hub/session-health.js +110 -0
  77. package/.versions/1.0.1/.pi/harnesses/agent-hub/spawn.ts +354 -0
  78. package/.versions/1.0.1/.pi/harnesses/agent-hub/version.ts +42 -0
  79. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/README.md +53 -0
  80. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/index.ts +477 -0
  81. package/.versions/1.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  82. package/.versions/1.0.1/.pi/harnesses/coms/README.md +100 -0
  83. package/.versions/1.0.1/.pi/harnesses/coms/index.ts +1767 -0
  84. package/.versions/1.0.1/.pi/harnesses/coms/package.json +7 -0
  85. package/.versions/1.0.1/.pi/harnesses/coms/version.ts +42 -0
  86. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/README.md +124 -0
  87. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/index.ts +536 -0
  88. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/package.json +7 -0
  89. package/.versions/1.0.1/.pi/harnesses/damage-control-continue/version.ts +42 -0
  90. package/.versions/1.0.1/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  91. package/.versions/1.0.1/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  92. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  93. package/.versions/1.0.1/.pi/harnesses/lib/fleet-dashboard-view.ts +140 -0
  94. package/.versions/1.0.1/.pi/harnesses/lib/fleet-detail-view.ts +43 -0
  95. package/.versions/1.0.1/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  96. package/.versions/1.0.1/.pi/harnesses/lib/fleet-panel.ts +34 -0
  97. package/.versions/1.0.1/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  98. package/.versions/1.0.1/.pi/harnesses/lib/fleet-selection.ts +24 -0
  99. package/.versions/1.0.1/.pi/harnesses/lib/herdr-client.ts +472 -0
  100. package/.versions/1.0.1/.pi/harnesses/lib/herdr-presence.ts +399 -0
  101. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  102. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  103. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  104. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  105. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  106. package/.versions/1.0.1/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  107. package/.versions/1.0.1/.pi/harnesses/lib/spawned-peers.js +190 -0
  108. package/.versions/1.0.1/.pi/harnesses/package-lock.json +2046 -0
  109. package/.versions/1.0.1/.pi/harnesses/package.json +10 -0
  110. package/.versions/1.0.1/.pi/prompts/af-build.md +24 -0
  111. package/.versions/1.0.1/.pi/prompts/af-code-simplify.md +22 -0
  112. package/.versions/1.0.1/.pi/prompts/af-plan.md +16 -0
  113. package/.versions/1.0.1/.pi/prompts/af-review.md +16 -0
  114. package/.versions/1.0.1/.pi/prompts/af-set-hermes-telegram.md +15 -0
  115. package/.versions/1.0.1/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  116. package/.versions/1.0.1/.pi/prompts/af-ship.md +17 -0
  117. package/.versions/1.0.1/.pi/prompts/af-spec.md +15 -0
  118. package/.versions/1.0.1/.pi/prompts/af-test.md +19 -0
  119. package/.versions/1.0.1/.pi/skills/bowser/SKILL.md +145 -0
  120. package/.versions/1.0.1/.version +1 -0
  121. package/.versions/1.0.1/agents/architect.md +24 -0
  122. package/.versions/1.0.1/agents/bowser.md +27 -0
  123. package/.versions/1.0.1/agents/builder.md +54 -0
  124. package/.versions/1.0.1/agents/code-reviewer.md +208 -0
  125. package/.versions/1.0.1/agents/deep-researcher.md +32 -0
  126. package/.versions/1.0.1/agents/documenter.md +18 -0
  127. package/.versions/1.0.1/agents/orchestrator.md +72 -0
  128. package/.versions/1.0.1/agents/plan-reviewer.md +83 -0
  129. package/.versions/1.0.1/agents/planner.md +70 -0
  130. package/.versions/1.0.1/agents/releaser.md +24 -0
  131. package/.versions/1.0.1/agents/researcher.md +28 -0
  132. package/.versions/1.0.1/agents/security-auditor.md +167 -0
  133. package/.versions/1.0.1/agents/test-engineer.md +153 -0
  134. package/.versions/1.0.1/agents/web-debugger.md +43 -0
  135. package/.versions/1.0.1/agents/web-performance-auditor.md +193 -0
  136. package/.versions/1.0.1/bin/catalog/harness-runtime-closure.json +38 -0
  137. package/.versions/1.0.1/codex/CONDUCTOR.md +148 -0
  138. package/.versions/1.0.1/docs/ARCHITECTURE.md +337 -0
  139. package/.versions/1.0.1/docs/agent-fleet-setup.md +437 -0
  140. package/.versions/1.0.1/docs/claude-code-coms-bridge.md +128 -0
  141. package/.versions/1.0.1/docs/codex-remote-conductor.md +170 -0
  142. package/.versions/1.0.1/docs/coms-hermes-bridge.md +189 -0
  143. package/.versions/1.0.1/docs/getting-started.md +98 -0
  144. package/.versions/1.0.1/docs/npm-install.md +292 -0
  145. package/.versions/1.0.1/docs/pi-extensions.md +412 -0
  146. package/.versions/1.0.1/docs/pi-setup.md +74 -0
  147. package/.versions/1.0.1/docs/skill-anatomy.md +150 -0
  148. package/.versions/1.0.1/hermes/README.md +347 -0
  149. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  150. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  151. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  152. package/.versions/1.0.1/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  153. package/.versions/1.0.1/hermes/gates/gate-o-capability.md +8 -0
  154. package/.versions/1.0.1/hermes/gates/gate-o-validator-fixtures.json +1 -0
  155. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  156. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  157. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  158. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  159. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  160. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  161. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  162. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  163. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  164. package/.versions/1.0.1/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  165. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  166. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  167. package/.versions/1.0.1/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  168. package/.versions/1.0.1/hermes/skills/hub-conductor/SKILL.md +84 -0
  169. package/.versions/1.0.1/hermes/skills/hub-liaison/SKILL.md +84 -0
  170. package/.versions/1.0.1/hermes/skills/hub-watchdog/SKILL.md +76 -0
  171. package/.versions/1.0.1/hermes/skills/hub-watchdog/manifest.json +1 -0
  172. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  173. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  174. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  175. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  176. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  177. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  178. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  179. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  180. package/.versions/1.0.1/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  181. package/.versions/1.0.1/hermes/watchdog-tests/__init__.py +0 -0
  182. package/.versions/1.0.1/hooks/coms-stop-hook.mjs +84 -0
  183. package/.versions/1.0.1/install-manifest.json +2745 -0
  184. package/.versions/1.0.1/justfile +272 -0
  185. package/.versions/1.0.1/manifest-meta.json +882 -0
  186. package/.versions/1.0.1/references/accessibility-checklist.md +160 -0
  187. package/.versions/1.0.1/references/definition-of-done.md +67 -0
  188. package/.versions/1.0.1/references/fleet-coordination-patterns.md +151 -0
  189. package/.versions/1.0.1/references/observability-checklist.md +91 -0
  190. package/.versions/1.0.1/references/orchestration-patterns.md +370 -0
  191. package/.versions/1.0.1/references/performance-checklist.md +153 -0
  192. package/.versions/1.0.1/references/prompting-patterns.md +380 -0
  193. package/.versions/1.0.1/references/security-checklist.md +179 -0
  194. package/.versions/1.0.1/references/testing-patterns.md +236 -0
  195. package/.versions/1.0.1/scripts/codex-conductor.ts +41 -0
  196. package/.versions/1.0.1/scripts/codex-remote-control.ts +167 -0
  197. package/.versions/1.0.1/scripts/coms-claude-bridge.ts +411 -0
  198. package/.versions/1.0.1/scripts/coms-cli.ts +484 -0
  199. package/.versions/1.0.1/scripts/coms-hermes-bridge.ts +413 -0
  200. package/.versions/1.0.1/scripts/fleet.ts +185 -0
  201. package/.versions/1.0.1/scripts/hermes-monitor-capability-runner.ts +25 -0
  202. package/.versions/1.0.1/scripts/hermes-monitor-scenario.ts +474 -0
  203. package/.versions/1.0.1/scripts/hermes-watchdog-capability-probe.ts +45 -0
  204. package/.versions/1.0.1/scripts/install-hermes-plugin.sh +180 -0
  205. package/.versions/1.0.1/scripts/lib/claude-bridge-core.ts +210 -0
  206. package/.versions/1.0.1/scripts/lib/codex-conductor.ts +88 -0
  207. package/.versions/1.0.1/scripts/lib/codex-remote-control.ts +480 -0
  208. package/.versions/1.0.1/scripts/lib/coms-envelope.ts +582 -0
  209. package/.versions/1.0.1/scripts/lib/fake-herdr-server.ts +88 -0
  210. package/.versions/1.0.1/scripts/lib/fleet-command.ts +266 -0
  211. package/.versions/1.0.1/scripts/lib/herdr-layout.ts +281 -0
  212. package/.versions/1.0.1/scripts/lib/hermes-bridge-core.ts +241 -0
  213. package/.versions/1.0.1/scripts/lib/hermes-monitor-events.ts +1 -0
  214. package/.versions/1.0.1/scripts/lib/hermes-monitor-herdr.ts +2 -0
  215. package/.versions/1.0.1/scripts/lib/hermes-monitor-model.ts +3 -0
  216. package/.versions/1.0.1/scripts/lib/hermes-monitor-registry.ts +2 -0
  217. package/.versions/1.0.1/scripts/lib/hermes-monitor-socket.ts +2 -0
  218. package/.versions/1.0.1/scripts/lib/hermes-monitor-store.ts +2 -0
  219. package/.versions/1.0.1/scripts/lib/monitor-env.ts +146 -0
  220. package/.versions/1.0.1/scripts/lib/peer-launch.ts +318 -0
  221. package/.versions/1.0.1/scripts/lib/persona-banner.ts +62 -0
  222. package/.versions/1.0.1/scripts/lib/spawn-stagger.ts +101 -0
  223. package/.versions/1.0.1/scripts/lib/team-project.ts +213 -0
  224. package/.versions/1.0.1/scripts/lib/team-snapshot.ts +147 -0
  225. package/.versions/1.0.1/scripts/peer-banner.ts +40 -0
  226. package/.versions/1.0.1/scripts/peer-launch.ts +259 -0
  227. package/.versions/1.0.1/scripts/team-snapshot.ts +237 -0
  228. package/.versions/1.0.1/scripts/team-up.ts +406 -0
  229. package/.versions/1.0.1/skills/_internal/grilling.md +11 -0
  230. package/.versions/1.0.1/skills/browser-testing-with-devtools/SKILL.md +351 -0
  231. package/.versions/1.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  232. package/.versions/1.0.1/skills/compound-learning/SKILL.md +137 -0
  233. package/.versions/1.0.1/skills/context-engineering/SKILL.md +291 -0
  234. package/.versions/1.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  235. package/.versions/1.0.1/skills/designing-agents/SKILL.md +394 -0
  236. package/.versions/1.0.1/skills/designing-agents/pi-harness-authoring.md +222 -0
  237. package/.versions/1.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  238. package/.versions/1.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  239. package/.versions/1.0.1/skills/idea-refine/SKILL.md +182 -0
  240. package/.versions/1.0.1/skills/idea-refine/examples.md +238 -0
  241. package/.versions/1.0.1/skills/idea-refine/frameworks.md +99 -0
  242. package/.versions/1.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  243. package/.versions/1.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  244. package/.versions/1.0.1/skills/incremental-implementation/SKILL.md +287 -0
  245. package/.versions/1.0.1/skills/interview-me/SKILL.md +226 -0
  246. package/.versions/1.0.1/skills/orchestration-verification/SKILL.md +181 -0
  247. package/.versions/1.0.1/skills/peer-coms/SKILL.md +90 -0
  248. package/.versions/1.0.1/skills/performance-optimization/SKILL.md +350 -0
  249. package/.versions/1.0.1/skills/planning-and-task-breakdown/SKILL.md +254 -0
  250. package/.versions/1.0.1/skills/security-and-hardening/SKILL.md +461 -0
  251. package/.versions/1.0.1/skills/spec-driven-development/SKILL.md +257 -0
  252. package/.versions/1.0.1/skills/using-agent-skills/SKILL.md +199 -0
  253. package/.versions/1.0.1/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  254. package/.versions/1.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  255. package/.versions/1.0.1/vendor/agent-skills-upstream/README.md +11 -0
  256. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  257. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  258. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  259. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  260. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  261. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  262. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  263. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  264. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  265. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  266. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  267. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  268. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  269. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  270. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  271. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  272. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  273. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  274. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  275. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  276. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  277. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  278. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  279. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  280. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  281. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  282. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  283. package/.versions/1.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  284. package/CHANGELOG.md +6 -0
  285. package/agents/code-reviewer.md +1 -1
  286. package/agents/deep-researcher.md +1 -1
  287. package/agents/plan-reviewer.md +1 -1
  288. package/agents/planner.md +1 -1
  289. package/agents/security-auditor.md +1 -1
  290. package/agents/test-engineer.md +1 -1
  291. package/install-manifest.json +1 -1
  292. package/package.json +2 -2
@@ -0,0 +1,116 @@
1
+ import {
2
+ buildPeerLaunchPlan,
3
+ type PeerLaunchContext,
4
+ type PeerLaunchPlan,
5
+ type PeerRunner,
6
+ } from "../../../scripts/lib/peer-launch.ts";
7
+ import { launchPeerInPane, peerReadyVerdict } from "../lib/spawned-peers.js";
8
+
9
+ export interface HubPeerSpawnRequest {
10
+ name: string;
11
+ runner?: PeerRunner;
12
+ persona?: string;
13
+ no_persona?: boolean;
14
+ model?: string;
15
+ extensions?: string;
16
+ browser?: boolean;
17
+ all_extensions?: boolean;
18
+ direction?: "right" | "down";
19
+ }
20
+
21
+ export interface HubPeerSpawnContext extends PeerLaunchContext {
22
+ /** The current Hub/coms project. The request cannot override it. */
23
+ project: string;
24
+ }
25
+
26
+ /**
27
+ * Constrained Agent Hub adapter for the canonical Fleet peer resolver.
28
+ * Project, placement, env-file source, and raw Pi argv are not LLM-controlled:
29
+ * the project comes from the Hub identity and envFile can only come back from
30
+ * a validated peers.yaml declaration inside buildPeerLaunchPlan().
31
+ */
32
+ export function buildHubPeerSpawnPlan(
33
+ request: HubPeerSpawnRequest,
34
+ context: HubPeerSpawnContext,
35
+ ): PeerLaunchPlan {
36
+ return buildPeerLaunchPlan(
37
+ {
38
+ name: request.name,
39
+ ...(request.runner ? { runner: request.runner } : {}),
40
+ ...(request.persona ? { persona: request.persona } : {}),
41
+ ...(request.no_persona ? { noPersona: true } : {}),
42
+ ...(request.model ? { model: request.model } : {}),
43
+ ...(request.extensions ? { extensions: request.extensions } : {}),
44
+ ...(request.browser ? { browser: true } : {}),
45
+ ...(request.all_extensions ? { allExtensions: true } : {}),
46
+ ...(request.direction ? { direction: request.direction } : {}),
47
+ project: context.project,
48
+ here: false,
49
+ },
50
+ context,
51
+ );
52
+ }
53
+
54
+ interface HubPeerPaneClient {
55
+ paneSplit(params: {
56
+ target_pane_id: string;
57
+ direction: "right" | "down";
58
+ cwd: string;
59
+ env?: Record<string, string>;
60
+ focus: boolean;
61
+ }): Promise<{ pane: { pane_id: string } }>;
62
+ paneRename(paneId: string, label: string): Promise<unknown>;
63
+ paneRead(params: { pane_id: string; lines: number }): Promise<{ read: { text?: string } }>;
64
+ paneSendText(paneId: string, text: string): Promise<unknown>;
65
+ paneSendKeys(paneId: string, keys: string[]): Promise<unknown>;
66
+ }
67
+
68
+ export interface HubPeerPaneLaunchOptions {
69
+ client: HubPeerPaneClient;
70
+ targetPaneId: string;
71
+ cwd: string;
72
+ env?: Record<string, string>;
73
+ waitForRegistration(name: string): Promise<{ found: boolean; waitedMs: number }>;
74
+ paneTail(paneId: string): Promise<string>;
75
+ onLaunched?(paneId: string): void;
76
+ }
77
+
78
+ /** Split next to the Hub, type the canonical argv, then return readiness proof. */
79
+ export async function launchHubPeerInPane(
80
+ plan: PeerLaunchPlan,
81
+ options: HubPeerPaneLaunchOptions,
82
+ ): Promise<{
83
+ paneId: string;
84
+ promptSeen: boolean;
85
+ promptWaitedMs: number;
86
+ verdict: ReturnType<typeof peerReadyVerdict>;
87
+ }> {
88
+ const env = options.env ?? {};
89
+ const { pane } = await options.client.paneSplit({
90
+ target_pane_id: options.targetPaneId,
91
+ direction: plan.direction,
92
+ cwd: options.cwd,
93
+ ...(Object.keys(env).length > 0 ? { env } : {}),
94
+ focus: false,
95
+ });
96
+ try {
97
+ await options.client.paneRename(pane.pane_id, plan.name);
98
+ } catch {
99
+ // A label is cosmetic; the pane id and coms identity remain authoritative.
100
+ }
101
+ const launch = await launchPeerInPane(options.client, pane.pane_id, plan.command);
102
+ options.onLaunched?.(pane.pane_id);
103
+ const readiness = await options.waitForRegistration(plan.name);
104
+ const tail = readiness.found ? undefined : await options.paneTail(pane.pane_id);
105
+ return {
106
+ paneId: pane.pane_id,
107
+ promptSeen: launch.promptSeen,
108
+ promptWaitedMs: launch.waitedMs,
109
+ verdict: peerReadyVerdict({
110
+ name: plan.name,
111
+ paneId: pane.pane_id,
112
+ ...readiness,
113
+ ...(tail === undefined ? {} : { paneTail: tail }),
114
+ }),
115
+ };
116
+ }
@@ -0,0 +1,103 @@
1
+ export const POSTURES = ["operator", "orchestrator"] as const;
2
+ export type Posture = (typeof POSTURES)[number];
3
+
4
+ export const ORCHESTRATION_TOOLS = [
5
+ "dispatch_agent",
6
+ "spawn_research",
7
+ "set_task_tier",
8
+ "team_adjust",
9
+ "set_assertions",
10
+ "update_assertion",
11
+ "get_assertions",
12
+ ] as const;
13
+
14
+ export const COMS_TOOLS = ["coms_list", "coms_send", "coms_get", "coms_await"] as const;
15
+
16
+ export const HERDR_TOOLS = [
17
+ "herdr_spawn_peer",
18
+ "herdr_spawn_pane",
19
+ "herdr_read_pane",
20
+ "herdr_close_pane",
21
+ "herdr_notify",
22
+ ] as const;
23
+
24
+ const CONDITIONAL_TOOLS = new Set<string>([...COMS_TOOLS, ...HERDR_TOOLS, "ask_user"]);
25
+ const HUB_OWNED_TOOLS = new Set<string>([
26
+ ...ORCHESTRATION_TOOLS,
27
+ ...CONDITIONAL_TOOLS,
28
+ ]);
29
+
30
+ export function parsePosture(value: unknown): Posture | null {
31
+ if (typeof value !== "string") return null;
32
+ const normalized = value.trim();
33
+ return POSTURES.includes(normalized as Posture) ? normalized as Posture : null;
34
+ }
35
+
36
+ export function resolveStartupPosture(options: {
37
+ explicitPosture?: unknown;
38
+ hasExplicitRoster?: boolean;
39
+ }): Posture {
40
+ if (options.explicitPosture !== undefined) {
41
+ const explicit = parsePosture(options.explicitPosture);
42
+ if (!explicit) throw new Error(`Unknown posture "${String(options.explicitPosture)}"; expected operator|orchestrator.`);
43
+ return explicit;
44
+ }
45
+ return options.hasExplicitRoster ? "orchestrator" : "operator";
46
+ }
47
+
48
+ export function latestPersistedPosture(entries: readonly unknown[]): Posture | null {
49
+ for (let i = entries.length - 1; i >= 0; i--) {
50
+ const entry = entries[i] as { type?: unknown; customType?: unknown; data?: { posture?: unknown } } | null;
51
+ if (entry?.type !== "custom" || entry.customType !== "agent-hub-posture") continue;
52
+ const persisted = parsePosture(entry.data?.posture);
53
+ if (persisted) return persisted;
54
+ }
55
+ return null;
56
+ }
57
+
58
+ export function resolveSessionPosture(options: {
59
+ entries: readonly unknown[];
60
+ explicitPosture?: unknown;
61
+ hasExplicitRoster?: boolean;
62
+ }): Posture {
63
+ if (options.explicitPosture !== undefined) {
64
+ return resolveStartupPosture({ explicitPosture: options.explicitPosture });
65
+ }
66
+ return latestPersistedPosture(options.entries)
67
+ ?? resolveStartupPosture({ hasExplicitRoster: options.hasExplicitRoster });
68
+ }
69
+
70
+ export function posturePrompt(posture: Posture): { intro: string; hardRules: string } {
71
+ if (posture === "operator") {
72
+ return {
73
+ intro: "You are the Fleet operator. You may work on the codebase directly and may also coordinate specialist agents when delegation adds value.",
74
+ hardRules: `- You MAY read, execute, edit, and write directly in operator posture.
75
+ - Use direct tools for focused work when they are the simplest path; delegate when specialization, parallelism, or independent verification adds value.
76
+ - Give concurrent writable agents explicit non-overlapping scopes and inspect overlap warnings before proceeding.`,
77
+ };
78
+ }
79
+ return {
80
+ intro: "You are a dispatcher agent — an orchestrator. You coordinate specialist agents to accomplish tasks. You do NOT have direct access to the codebase.",
81
+ hardRules: `- NEVER try to read, write, or execute code directly — you have no such tools.
82
+ - ALWAYS use \`dispatch_agent\` to get implementation work done; use \`spawn_research\` for read-only recon.
83
+ - \`herdr_spawn_pane\` is only for auxiliary processes such as watchers or servers; NEVER use it to bypass delegation by reading, editing, testing, or implementing code in a raw pane.`,
84
+ };
85
+ }
86
+
87
+ export function resolvePostureTools(options: {
88
+ posture: Posture;
89
+ baselineTools: readonly string[];
90
+ comsReady: boolean;
91
+ herdrReady: boolean;
92
+ askUserAvailable: boolean;
93
+ }): string[] {
94
+ const tools = options.posture === "operator"
95
+ ? options.baselineTools.filter(name => !HUB_OWNED_TOOLS.has(name))
96
+ : [];
97
+
98
+ tools.push(...ORCHESTRATION_TOOLS);
99
+ if (options.comsReady) tools.push(...COMS_TOOLS);
100
+ if (options.askUserAvailable) tools.push("ask_user");
101
+ if (options.herdrReady) tools.push(...HERDR_TOOLS);
102
+ return [...new Set(tools)];
103
+ }
@@ -0,0 +1,138 @@
1
+ // Per-provider in-flight semaphore.
2
+ //
3
+ // A dispatch may fan out to four delegate children at once, concurrent children
4
+ // are explicitly allowed, and several specialists can be mid-run — with nothing
5
+ // bounding how many requests land on ONE provider. That is survivable against a
6
+ // hosted endpoint and not against a local one: `custom/*` is a single machine,
7
+ // and the observed symptom was mid-run OOM on exactly the children that exist to
8
+ // protect the parent's context.
9
+ //
10
+ // Scope, stated plainly: this bounds the direct children spawned by ONE process.
11
+ // A nested delegate runs in its own pi process with its own semaphore, so the
12
+ // cap is per level of the tree, not global across the fleet. That is deliberate
13
+ // — a cross-process lock would have to survive crashed holders, and the level
14
+ // cap already removes the burst that caused the failures. Within one process the
15
+ // leaf holds the permit and a parent hands its own permit down (`parent`), so a
16
+ // nested spawn can never wait on its ancestor.
17
+
18
+ /** Only the local endpoint is capped by default; hosted providers scale on their side. */
19
+ export const DEFAULT_PROVIDER_LIMITS = Object.freeze({ custom: 2 });
20
+
21
+ /** "custom/Qwen3.6-35B-A3B-4bit" → "custom"; the part before the first slash. */
22
+ export function providerKey(model) {
23
+ const spec = String(model ?? "").trim().toLowerCase();
24
+ const slash = spec.indexOf("/");
25
+ return slash < 0 ? spec : spec.slice(0, slash);
26
+ }
27
+
28
+ /** Concurrency cap for a model spec, or null when the provider is unlimited. */
29
+ export function providerLimit(model, limits = DEFAULT_PROVIDER_LIMITS) {
30
+ const limit = (limits || {})[providerKey(model)];
31
+ return Number.isFinite(limit) && limit > 0 ? limit : null;
32
+ }
33
+
34
+ /**
35
+ * Parse an override list: "custom=3,ollama=1". A value of 0 or "off" means
36
+ * unlimited (recorded as null so it overrides a default cap). Junk is dropped —
37
+ * a malformed env var must never make the hub refuse to start.
38
+ */
39
+ export function parseProviderLimits(raw) {
40
+ const out = {};
41
+ for (const part of String(raw ?? "").split(",")) {
42
+ const [rawKey, rawValue] = part.split("=");
43
+ if (rawValue === undefined) continue;
44
+ const key = String(rawKey).trim().toLowerCase();
45
+ const value = String(rawValue).trim().toLowerCase();
46
+ if (!key) continue;
47
+ if (value === "off" || value === "none" || value === "unlimited") { out[key] = null; continue; }
48
+ const n = Number(value);
49
+ if (!Number.isFinite(n)) continue;
50
+ out[key] = n > 0 ? Math.floor(n) : null;
51
+ }
52
+ return out;
53
+ }
54
+
55
+ /**
56
+ * FIFO semaphore keyed by provider prefix.
57
+ *
58
+ * - `acquire(model)` → Promise<release>. `release()` is idempotent.
59
+ * - `run(model, fn, { parent })` → runs `fn(permit)` under a permit and releases
60
+ * it however `fn` settles. Pass the permit you were given as `parent` when
61
+ * spawning on the same provider from inside `fn`: the call reuses it instead
62
+ * of taking a second one.
63
+ *
64
+ * Admission is synchronous when a permit is free, and a release hands off
65
+ * directly to the head of the queue, so ordering is exactly request order.
66
+ */
67
+ export function createProviderSemaphore(limits = DEFAULT_PROVIDER_LIMITS) {
68
+ /** @type {Map<string, { live: number, queue: Array<(release: () => void) => void> }>} */
69
+ const lanes = new Map();
70
+
71
+ const lane = (key) => {
72
+ let l = lanes.get(key);
73
+ if (!l) { l = { live: 0, queue: [] }; lanes.set(key, l); }
74
+ return l;
75
+ };
76
+
77
+ const makeRelease = (key) => {
78
+ let released = false;
79
+ const release = () => {
80
+ if (released) return;
81
+ released = true;
82
+ const l = lane(key);
83
+ const next = l.queue.shift();
84
+ // Hand the permit straight to the next waiter: `live` never dips, so a
85
+ // third caller arriving in between cannot jump the queue.
86
+ if (next) next(makeRelease(key));
87
+ else l.live--;
88
+ };
89
+ release.provider = key;
90
+ return release;
91
+ };
92
+
93
+ /** A free permit now, or null when the lane is full. */
94
+ const tryAcquire = (key, limit) => {
95
+ const l = lane(key);
96
+ if (limit != null && l.live >= limit) return null;
97
+ l.live++;
98
+ return makeRelease(key);
99
+ };
100
+
101
+ function acquire(model) {
102
+ const key = providerKey(model);
103
+ const limit = providerLimit(model, limits);
104
+ const permit = tryAcquire(key, limit);
105
+ if (permit) return Promise.resolve(permit);
106
+ return new Promise((resolve) => lane(key).queue.push(resolve));
107
+ }
108
+
109
+ function run(model, fn, { parent } = {}) {
110
+ const key = providerKey(model);
111
+ // Reentrancy: a parent holding this provider's permit lends it to its own
112
+ // nested spawn rather than queueing behind itself.
113
+ if (typeof parent === "function" && parent.provider === key) {
114
+ try { return Promise.resolve(fn(parent)); } catch (error) { return Promise.reject(error); }
115
+ }
116
+ const invoke = (permit) => {
117
+ let result;
118
+ try { result = fn(permit); } catch (error) { permit(); return Promise.reject(error); }
119
+ return Promise.resolve(result).then(
120
+ (value) => { permit(); return value; },
121
+ (error) => { permit(); throw error; },
122
+ );
123
+ };
124
+ const permit = tryAcquire(key, providerLimit(model, limits));
125
+ if (permit) return invoke(permit);
126
+ return new Promise((resolve, reject) => {
127
+ lane(key).queue.push((granted) => invoke(granted).then(resolve, reject));
128
+ });
129
+ }
130
+
131
+ return {
132
+ acquire,
133
+ run,
134
+ inFlight: (model) => lane(providerKey(model)).live,
135
+ queued: (model) => lane(providerKey(model)).queue.length,
136
+ limitFor: (model) => providerLimit(model, limits),
137
+ };
138
+ }
@@ -0,0 +1,34 @@
1
+ // Retention policy for finished research helpers. The hub keeps every helper's
2
+ // card (and resumable session) in memory until something removes it; this module
3
+ // decides which finished helpers to drop so the research row doesn't grow without
4
+ // bound over a long session. Pure — the hub owns the actual state map, session
5
+ // files, and widget refresh.
6
+
7
+ export const DEFAULT_RESEARCH_KEEP = 4;
8
+
9
+ // Parse the `research-keep` override value: "all" disables pruning of durable
10
+ // helpers, a non-negative integer keeps that many most-recently-finished ones.
11
+ // Returns null for anything else (caller warns and keeps the default).
12
+ export function parseResearchKeep(value) {
13
+ const v = String(value ?? "").trim().toLowerCase();
14
+ if (v === "all") return Infinity;
15
+ if (/^\d+$/.test(v)) return Number(v);
16
+ return null;
17
+ }
18
+
19
+ // Decide which helper ids to drop. `states`: [{ id, status, finishedAt, ephemeral }].
20
+ // Running helpers are never dropped. Finished ephemeral helpers (auto-research
21
+ // pipe spawns — their findings persist as files under findings/ and their handles
22
+ // are never resumed) are always dropped. Finished durable helpers beyond the
23
+ // `keep` most recently finished are dropped, oldest first.
24
+ export function selectResearchPrunable(states, keep) {
25
+ const capped = keep >= 0 ? keep : DEFAULT_RESEARCH_KEEP;
26
+ const finished = (states || []).filter((s) => s.status !== "running");
27
+ const ephemeral = finished.filter((s) => s.ephemeral).map((s) => s.id);
28
+ const durable = finished
29
+ .filter((s) => !s.ephemeral)
30
+ .sort((a, b) => (b.finishedAt ?? 0) - (a.finishedAt ?? 0));
31
+ // slice(Infinity) → [] — "all" keeps every durable helper.
32
+ const overflow = durable.slice(capped).map((s) => s.id);
33
+ return [...ephemeral, ...overflow];
34
+ }
@@ -0,0 +1,40 @@
1
+ import type { Termination } from "./spawn.ts";
2
+
3
+ /** Spawn policy shared by every native read-only research-helper path. */
4
+ export function researchWatchdogSpawnOptions(timeoutMs: number | null, signal?: AbortSignal) {
5
+ return {
6
+ detached: true,
7
+ signal,
8
+ toolWatchdog: { timeoutMs },
9
+ };
10
+ }
11
+
12
+ /** Stable terminal result used by research lifecycle code after parent cleanup. */
13
+ export function researchTerminationOutcome(id: number, termination: Termination) {
14
+ const reason = termination.reason;
15
+ const tool = termination.tool;
16
+ const status = reason; // "tool_timeout" | "turn_timeout" | "drift_stop" | "cancelled"
17
+ const lastWork = reason === "tool_timeout"
18
+ ? `tool_timeout: ${tool?.toolName || "tool"} (${tool?.toolCallId || "unknown"})`
19
+ : reason === "turn_timeout"
20
+ ? "turn_timeout: per-run deadline exceeded"
21
+ : reason === "drift_stop"
22
+ ? "drift_stop: stopped by the drift watchdog"
23
+ : "cancelled by caller";
24
+ const metadata = reason === "tool_timeout"
25
+ ? `toolCallId=${tool?.toolCallId || "unknown"}, tool=${tool?.toolName || "unknown"}, deadline=${tool?.deadlineAt || "unknown"}, terminationConfirmed=${termination.confirmed}`
26
+ : `terminationConfirmed=${termination.confirmed}`;
27
+ const explanation = reason === "tool_timeout"
28
+ ? "exceeded its per-tool watchdog"
29
+ : reason === "turn_timeout"
30
+ ? "exceeded the per-run deadline (agent-turn-timeout-s / mode budget) — narrow the question or raise the deadline"
31
+ : reason === "drift_stop"
32
+ ? "was stopped by the drift watchdog"
33
+ : "was cancelled by its caller";
34
+ return {
35
+ status,
36
+ lastWork,
37
+ output: `${status}: research helper r${id} ${explanation} (${metadata}).`,
38
+ exitCode: reason === "cancelled" ? 130 : reason === "drift_stop" ? 125 : 124,
39
+ };
40
+ }