@chankov/agent-fleet 1.0.3 → 1.0.4

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 (310) hide show
  1. package/.pi/harnesses/agent-hub/README.md +25 -11
  2. package/.pi/harnesses/agent-hub/delegate.ts +14 -3
  3. package/.pi/harnesses/agent-hub/index.ts +212 -40
  4. package/.pi/harnesses/agent-hub/package.json +1 -1
  5. package/.pi/harnesses/agent-hub/spawn.ts +25 -3
  6. package/.pi/harnesses/coms/package.json +1 -1
  7. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  8. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +2 -2
  9. package/.pi/harnesses/lib/fleet-detail-view.ts +95 -16
  10. package/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  11. package/.pi/prompts/af-plan.md +6 -5
  12. package/.versions/1.0.4/.pi/agents/dispatch-policy.yaml +32 -0
  13. package/.versions/1.0.4/.pi/agents/model-profiles.yaml +27 -0
  14. package/.versions/1.0.4/.pi/agents/peers.yaml +142 -0
  15. package/.versions/1.0.4/.pi/agents/teams.yaml +41 -0
  16. package/.versions/1.0.4/.pi/damage-control-rules.yaml +297 -0
  17. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  18. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  19. package/.versions/1.0.4/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  20. package/.versions/1.0.4/.pi/extensions/btw/README.md +120 -0
  21. package/.versions/1.0.4/.pi/extensions/btw/index.ts +914 -0
  22. package/.versions/1.0.4/.pi/extensions/btw/package.json +6 -0
  23. package/.versions/1.0.4/.pi/extensions/btw/state.js +179 -0
  24. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  25. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  26. package/.versions/1.0.4/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  27. package/.versions/1.0.4/.pi/extensions/compact-and-continue/README.md +42 -0
  28. package/.versions/1.0.4/.pi/extensions/compact-and-continue/index.ts +120 -0
  29. package/.versions/1.0.4/.pi/extensions/compact-and-continue/package.json +6 -0
  30. package/.versions/1.0.4/.pi/extensions/mcp-bridge/README.md +46 -0
  31. package/.versions/1.0.4/.pi/extensions/mcp-bridge/index.ts +206 -0
  32. package/.versions/1.0.4/.pi/extensions/mcp-bridge/package.json +6 -0
  33. package/.versions/1.0.4/.pi/extensions/package-lock.json +1175 -0
  34. package/.versions/1.0.4/.pi/extensions/package.json +9 -0
  35. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/README.md +205 -0
  36. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/config.ts +198 -0
  37. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  38. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/index.ts +248 -0
  39. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/package.json +6 -0
  40. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  41. package/.versions/1.0.4/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  42. package/.versions/1.0.4/.pi/harnesses/agent-hub/README.md +1170 -0
  43. package/.versions/1.0.4/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  44. package/.versions/1.0.4/.pi/harnesses/agent-hub/artifacts.js +146 -0
  45. package/.versions/1.0.4/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  46. package/.versions/1.0.4/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  47. package/.versions/1.0.4/.pi/harnesses/agent-hub/budget-continuation.ts +73 -0
  48. package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  49. package/.versions/1.0.4/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  50. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  51. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  52. package/.versions/1.0.4/.pi/harnesses/agent-hub/context-window.js +106 -0
  53. package/.versions/1.0.4/.pi/harnesses/agent-hub/delegate.ts +446 -0
  54. package/.versions/1.0.4/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  55. package/.versions/1.0.4/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  56. package/.versions/1.0.4/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  57. package/.versions/1.0.4/.pi/harnesses/agent-hub/execution-profile.ts +69 -0
  58. package/.versions/1.0.4/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  59. package/.versions/1.0.4/.pi/harnesses/agent-hub/footer.ts +36 -0
  60. package/.versions/1.0.4/.pi/harnesses/agent-hub/helpers.ts +266 -0
  61. package/.versions/1.0.4/.pi/harnesses/agent-hub/hub-state-audit.js +59 -0
  62. package/.versions/1.0.4/.pi/harnesses/agent-hub/index.ts +10171 -0
  63. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  64. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  65. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  66. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  67. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  68. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  69. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  70. package/.versions/1.0.4/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  71. package/.versions/1.0.4/.pi/harnesses/agent-hub/package.json +7 -0
  72. package/.versions/1.0.4/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  73. package/.versions/1.0.4/.pi/harnesses/agent-hub/posture.ts +158 -0
  74. package/.versions/1.0.4/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  75. package/.versions/1.0.4/.pi/harnesses/agent-hub/research-retention.js +34 -0
  76. package/.versions/1.0.4/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  77. package/.versions/1.0.4/.pi/harnesses/agent-hub/return-contract.js +293 -0
  78. package/.versions/1.0.4/.pi/harnesses/agent-hub/return-extract.js +75 -0
  79. package/.versions/1.0.4/.pi/harnesses/agent-hub/review-findings.js +102 -0
  80. package/.versions/1.0.4/.pi/harnesses/agent-hub/run-budget.js +537 -0
  81. package/.versions/1.0.4/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  82. package/.versions/1.0.4/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  83. package/.versions/1.0.4/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  84. package/.versions/1.0.4/.pi/harnesses/agent-hub/session-health.js +110 -0
  85. package/.versions/1.0.4/.pi/harnesses/agent-hub/spawn.ts +388 -0
  86. package/.versions/1.0.4/.pi/harnesses/agent-hub/version.ts +42 -0
  87. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/README.md +53 -0
  88. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/index.ts +532 -0
  89. package/.versions/1.0.4/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  90. package/.versions/1.0.4/.pi/harnesses/coms/README.md +100 -0
  91. package/.versions/1.0.4/.pi/harnesses/coms/index.ts +1767 -0
  92. package/.versions/1.0.4/.pi/harnesses/coms/package.json +7 -0
  93. package/.versions/1.0.4/.pi/harnesses/coms/version.ts +42 -0
  94. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/README.md +124 -0
  95. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/index.ts +536 -0
  96. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/package.json +7 -0
  97. package/.versions/1.0.4/.pi/harnesses/damage-control-continue/version.ts +42 -0
  98. package/.versions/1.0.4/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  99. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-child-prompt.ts +179 -0
  100. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-hub-prompt.ts +116 -0
  101. package/.versions/1.0.4/.pi/harnesses/lib/context-budget-view.ts +107 -0
  102. package/.versions/1.0.4/.pi/harnesses/lib/context-budget.ts +114 -0
  103. package/.versions/1.0.4/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  104. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  105. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  106. package/.versions/1.0.4/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  107. package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-ops.ts +155 -0
  108. package/.versions/1.0.4/.pi/harnesses/lib/fleet-dashboard-view.ts +142 -0
  109. package/.versions/1.0.4/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  110. package/.versions/1.0.4/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  111. package/.versions/1.0.4/.pi/harnesses/lib/fleet-panel.ts +34 -0
  112. package/.versions/1.0.4/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  113. package/.versions/1.0.4/.pi/harnesses/lib/fleet-selection.ts +24 -0
  114. package/.versions/1.0.4/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  115. package/.versions/1.0.4/.pi/harnesses/lib/herdr-client.ts +472 -0
  116. package/.versions/1.0.4/.pi/harnesses/lib/herdr-presence.ts +399 -0
  117. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  118. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  119. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  120. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  121. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  122. package/.versions/1.0.4/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  123. package/.versions/1.0.4/.pi/harnesses/lib/spawned-peers.js +190 -0
  124. package/.versions/1.0.4/.pi/harnesses/package-lock.json +2039 -0
  125. package/.versions/1.0.4/.pi/harnesses/package.json +10 -0
  126. package/.versions/1.0.4/.pi/prompts/af-build.md +24 -0
  127. package/.versions/1.0.4/.pi/prompts/af-code-simplify.md +22 -0
  128. package/.versions/1.0.4/.pi/prompts/af-plan.md +17 -0
  129. package/.versions/1.0.4/.pi/prompts/af-review.md +16 -0
  130. package/.versions/1.0.4/.pi/prompts/af-set-hermes-telegram.md +15 -0
  131. package/.versions/1.0.4/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  132. package/.versions/1.0.4/.pi/prompts/af-ship.md +17 -0
  133. package/.versions/1.0.4/.pi/prompts/af-spec.md +15 -0
  134. package/.versions/1.0.4/.pi/prompts/af-test.md +19 -0
  135. package/.versions/1.0.4/.pi/skills/bowser/SKILL.md +145 -0
  136. package/.versions/1.0.4/.version +1 -0
  137. package/.versions/1.0.4/agents/architect.md +25 -0
  138. package/.versions/1.0.4/agents/bowser.md +28 -0
  139. package/.versions/1.0.4/agents/builder.md +56 -0
  140. package/.versions/1.0.4/agents/code-reviewer.md +209 -0
  141. package/.versions/1.0.4/agents/deep-researcher.md +33 -0
  142. package/.versions/1.0.4/agents/documenter.md +19 -0
  143. package/.versions/1.0.4/agents/orchestrator.md +21 -0
  144. package/.versions/1.0.4/agents/plan-reviewer.md +84 -0
  145. package/.versions/1.0.4/agents/planner.md +71 -0
  146. package/.versions/1.0.4/agents/releaser.md +25 -0
  147. package/.versions/1.0.4/agents/researcher.md +29 -0
  148. package/.versions/1.0.4/agents/security-auditor.md +168 -0
  149. package/.versions/1.0.4/agents/test-engineer.md +154 -0
  150. package/.versions/1.0.4/agents/web-debugger.md +44 -0
  151. package/.versions/1.0.4/agents/web-performance-auditor.md +194 -0
  152. package/.versions/1.0.4/bin/catalog/harness-runtime-closure.json +38 -0
  153. package/.versions/1.0.4/codex/CONDUCTOR.md +148 -0
  154. package/.versions/1.0.4/docs/ARCHITECTURE.md +375 -0
  155. package/.versions/1.0.4/docs/agent-fleet-setup.md +468 -0
  156. package/.versions/1.0.4/docs/claude-code-coms-bridge.md +128 -0
  157. package/.versions/1.0.4/docs/codex-remote-conductor.md +170 -0
  158. package/.versions/1.0.4/docs/coms-hermes-bridge.md +189 -0
  159. package/.versions/1.0.4/docs/getting-started.md +98 -0
  160. package/.versions/1.0.4/docs/npm-install.md +292 -0
  161. package/.versions/1.0.4/docs/pi-extensions.md +441 -0
  162. package/.versions/1.0.4/docs/pi-setup.md +74 -0
  163. package/.versions/1.0.4/docs/skill-anatomy.md +150 -0
  164. package/.versions/1.0.4/hermes/README.md +347 -0
  165. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  166. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  167. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  168. package/.versions/1.0.4/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  169. package/.versions/1.0.4/hermes/gates/gate-o-capability.md +8 -0
  170. package/.versions/1.0.4/hermes/gates/gate-o-validator-fixtures.json +1 -0
  171. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  172. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  173. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  174. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  175. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  176. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  177. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  178. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  179. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  180. package/.versions/1.0.4/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  181. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  182. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  183. package/.versions/1.0.4/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  184. package/.versions/1.0.4/hermes/skills/hub-conductor/SKILL.md +84 -0
  185. package/.versions/1.0.4/hermes/skills/hub-liaison/SKILL.md +84 -0
  186. package/.versions/1.0.4/hermes/skills/hub-watchdog/SKILL.md +76 -0
  187. package/.versions/1.0.4/hermes/skills/hub-watchdog/manifest.json +1 -0
  188. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  189. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  190. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  191. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  192. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  193. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  194. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  195. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  196. package/.versions/1.0.4/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  197. package/.versions/1.0.4/hermes/watchdog-tests/__init__.py +0 -0
  198. package/.versions/1.0.4/hooks/coms-stop-hook.mjs +84 -0
  199. package/.versions/1.0.4/install-manifest.json +2745 -0
  200. package/.versions/1.0.4/justfile +272 -0
  201. package/.versions/1.0.4/manifest-meta.json +882 -0
  202. package/.versions/1.0.4/references/accessibility-checklist.md +160 -0
  203. package/.versions/1.0.4/references/definition-of-done.md +67 -0
  204. package/.versions/1.0.4/references/fleet-coordination-patterns.md +151 -0
  205. package/.versions/1.0.4/references/observability-checklist.md +91 -0
  206. package/.versions/1.0.4/references/orchestration-patterns.md +370 -0
  207. package/.versions/1.0.4/references/performance-checklist.md +153 -0
  208. package/.versions/1.0.4/references/prompting-patterns.md +380 -0
  209. package/.versions/1.0.4/references/security-checklist.md +179 -0
  210. package/.versions/1.0.4/references/testing-patterns.md +236 -0
  211. package/.versions/1.0.4/scripts/codex-conductor.ts +41 -0
  212. package/.versions/1.0.4/scripts/codex-remote-control.ts +167 -0
  213. package/.versions/1.0.4/scripts/coms-claude-bridge.ts +411 -0
  214. package/.versions/1.0.4/scripts/coms-cli.ts +484 -0
  215. package/.versions/1.0.4/scripts/coms-hermes-bridge.ts +413 -0
  216. package/.versions/1.0.4/scripts/fleet.ts +185 -0
  217. package/.versions/1.0.4/scripts/hermes-monitor-capability-runner.ts +25 -0
  218. package/.versions/1.0.4/scripts/hermes-monitor-scenario.ts +474 -0
  219. package/.versions/1.0.4/scripts/hermes-watchdog-capability-probe.ts +45 -0
  220. package/.versions/1.0.4/scripts/install-hermes-plugin.sh +180 -0
  221. package/.versions/1.0.4/scripts/lib/claude-bridge-core.ts +210 -0
  222. package/.versions/1.0.4/scripts/lib/codex-conductor.ts +88 -0
  223. package/.versions/1.0.4/scripts/lib/codex-remote-control.ts +480 -0
  224. package/.versions/1.0.4/scripts/lib/coms-envelope.ts +582 -0
  225. package/.versions/1.0.4/scripts/lib/fake-herdr-server.ts +88 -0
  226. package/.versions/1.0.4/scripts/lib/fleet-command.ts +266 -0
  227. package/.versions/1.0.4/scripts/lib/herdr-layout.ts +281 -0
  228. package/.versions/1.0.4/scripts/lib/hermes-bridge-core.ts +241 -0
  229. package/.versions/1.0.4/scripts/lib/hermes-monitor-events.ts +1 -0
  230. package/.versions/1.0.4/scripts/lib/hermes-monitor-herdr.ts +2 -0
  231. package/.versions/1.0.4/scripts/lib/hermes-monitor-model.ts +3 -0
  232. package/.versions/1.0.4/scripts/lib/hermes-monitor-registry.ts +2 -0
  233. package/.versions/1.0.4/scripts/lib/hermes-monitor-socket.ts +2 -0
  234. package/.versions/1.0.4/scripts/lib/hermes-monitor-store.ts +2 -0
  235. package/.versions/1.0.4/scripts/lib/monitor-env.ts +146 -0
  236. package/.versions/1.0.4/scripts/lib/peer-launch.ts +318 -0
  237. package/.versions/1.0.4/scripts/lib/persona-banner.ts +62 -0
  238. package/.versions/1.0.4/scripts/lib/spawn-stagger.ts +101 -0
  239. package/.versions/1.0.4/scripts/lib/team-project.ts +213 -0
  240. package/.versions/1.0.4/scripts/lib/team-snapshot.ts +147 -0
  241. package/.versions/1.0.4/scripts/peer-banner.ts +40 -0
  242. package/.versions/1.0.4/scripts/peer-launch.ts +259 -0
  243. package/.versions/1.0.4/scripts/team-snapshot.ts +237 -0
  244. package/.versions/1.0.4/scripts/team-up.ts +406 -0
  245. package/.versions/1.0.4/skills/_internal/grilling.md +59 -0
  246. package/.versions/1.0.4/skills/browser-testing-with-devtools/SKILL.md +351 -0
  247. package/.versions/1.0.4/skills/code-review-and-quality/SKILL.md +381 -0
  248. package/.versions/1.0.4/skills/compound-learning/SKILL.md +137 -0
  249. package/.versions/1.0.4/skills/context-engineering/SKILL.md +291 -0
  250. package/.versions/1.0.4/skills/deprecation-and-migration/SKILL.md +206 -0
  251. package/.versions/1.0.4/skills/designing-agents/SKILL.md +394 -0
  252. package/.versions/1.0.4/skills/designing-agents/pi-harness-authoring.md +222 -0
  253. package/.versions/1.0.4/skills/frontend-ui-engineering/SKILL.md +328 -0
  254. package/.versions/1.0.4/skills/git-workflow-and-versioning/SKILL.md +316 -0
  255. package/.versions/1.0.4/skills/idea-refine/SKILL.md +182 -0
  256. package/.versions/1.0.4/skills/idea-refine/examples.md +238 -0
  257. package/.versions/1.0.4/skills/idea-refine/frameworks.md +99 -0
  258. package/.versions/1.0.4/skills/idea-refine/refinement-criteria.md +113 -0
  259. package/.versions/1.0.4/skills/idea-refine/scripts/idea-refine.sh +15 -0
  260. package/.versions/1.0.4/skills/incremental-implementation/SKILL.md +298 -0
  261. package/.versions/1.0.4/skills/interview-me/SKILL.md +226 -0
  262. package/.versions/1.0.4/skills/orchestration-verification/SKILL.md +181 -0
  263. package/.versions/1.0.4/skills/peer-coms/SKILL.md +90 -0
  264. package/.versions/1.0.4/skills/performance-optimization/SKILL.md +350 -0
  265. package/.versions/1.0.4/skills/planning-and-task-breakdown/SKILL.md +263 -0
  266. package/.versions/1.0.4/skills/security-and-hardening/SKILL.md +461 -0
  267. package/.versions/1.0.4/skills/spec-driven-development/SKILL.md +256 -0
  268. package/.versions/1.0.4/skills/using-agent-skills/SKILL.md +197 -0
  269. package/.versions/1.0.4/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  270. package/.versions/1.0.4/vendor/agent-skills-upstream/LICENSE +21 -0
  271. package/.versions/1.0.4/vendor/agent-skills-upstream/README.md +11 -0
  272. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  273. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  274. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  275. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  276. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  277. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  278. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  279. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  280. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  281. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  282. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  283. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  284. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  285. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  286. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  287. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  288. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  289. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  290. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  291. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  292. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  293. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  294. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  295. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  296. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  297. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  298. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  299. package/.versions/1.0.4/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  300. package/CHANGELOG.md +7 -0
  301. package/agents/builder.md +1 -0
  302. package/agents/planner.md +1 -1
  303. package/install-manifest.json +3 -3
  304. package/package.json +2 -2
  305. package/skills/_internal/grilling.md +53 -5
  306. package/skills/idea-refine/SKILL.md +2 -2
  307. package/skills/incremental-implementation/SKILL.md +12 -1
  308. package/skills/planning-and-task-breakdown/SKILL.md +14 -5
  309. package/skills/spec-driven-development/SKILL.md +10 -11
  310. package/skills/using-agent-skills/SKILL.md +13 -15
@@ -0,0 +1,266 @@
1
+ import { isAbsolute, relative, resolve } from "node:path";
2
+
3
+ export const MAX_DELEGATE_DEPTH = 1;
4
+ export const DELEGATE_TREE_SPAWN_BUDGET = 4;
5
+ export const READ_ONLY_TOOLS = "read,grep,find,ls";
6
+
7
+ const SAFE_AGENT_KEY_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
8
+
9
+ export interface ModelOverrideConfig {
10
+ model?: string;
11
+ fallbackModel?: string;
12
+ }
13
+
14
+ // Preserve the persona/frontmatter model across any number of project/session
15
+ // overrides. The first declared model is the only automatic fallback target.
16
+ export function applyModelOverride<T extends ModelOverrideConfig>(current: T, override: string): T {
17
+ if (!override || override === current.model) return current;
18
+ const original = current.fallbackModel ?? current.model;
19
+ return {
20
+ ...current,
21
+ model: override,
22
+ ...(original && original !== override ? { fallbackModel: original } : {}),
23
+ };
24
+ }
25
+
26
+ export function fallbackModelFor(config: ModelOverrideConfig, effectiveModel?: string): string | undefined {
27
+ const original = config.fallbackModel ?? config.model;
28
+ return original && effectiveModel && original !== effectiveModel ? original : undefined;
29
+ }
30
+
31
+ export function parseTeamsYaml(raw: string): Record<string, string[]> {
32
+ const teams: Record<string, string[]> = {};
33
+ let current: string | null = null;
34
+ for (const rawLine of raw.split("\n")) {
35
+ const line = rawLine.replace(/\r$/, "");
36
+ const teamMatch = line.match(/^(\S[^:]*):\s*$/);
37
+ if (teamMatch) {
38
+ current = teamMatch[1].trim();
39
+ teams[current] = [];
40
+ continue;
41
+ }
42
+ const itemMatch = line.match(/^\s+-\s+(.+)$/);
43
+ if (itemMatch && current) {
44
+ teams[current].push(itemMatch[1].trim());
45
+ }
46
+ }
47
+ return teams;
48
+ }
49
+
50
+ export function resolveStartupRoster(
51
+ teams: Record<string, string[]>,
52
+ requested: unknown,
53
+ ): { name: string; members: string[] } | null {
54
+ if (typeof requested !== "string" || requested.trim() === "") return null;
55
+ const wanted = requested.trim().toLowerCase();
56
+ const name = Object.keys(teams).find(candidate => candidate.toLowerCase() === wanted);
57
+ if (!name) {
58
+ const available = Object.keys(teams).sort().join(", ") || "(none)";
59
+ throw new Error(`Unknown native roster "${requested}". Available: ${available}.`);
60
+ }
61
+ return { name, members: [...teams[name]] };
62
+ }
63
+
64
+ export function orchestratorNeedsRoster(posture: string, rosterSize: number): boolean {
65
+ return posture === "orchestrator" && rosterSize < 1;
66
+ }
67
+
68
+ // Normalize a dispatcher-supplied agent name to the persona-slug key space:
69
+ // display names ("Test Engineer"), underscores, and stray whitespace all resolve
70
+ // to the same key the hub stores states under ("test-engineer").
71
+ export function normalizeAgentInput(value: string): string {
72
+ return String(value ?? "").trim().toLowerCase().replace(/[\s_]+/g, "-");
73
+ }
74
+
75
+ // Duplicate-dispatch guard: one fingerprint per (agent, task) where the task
76
+ // text is normalized hard (case, whitespace, punctuation) so trivial rewording
77
+ // still collides. Genuinely different tasks differ in their words, not their
78
+ // commas.
79
+ export function taskFingerprint(agent: string, task: string): string {
80
+ const normalizedTask = String(task ?? "")
81
+ .toLowerCase()
82
+ .replace(/[^\p{L}\p{N}]+/gu, " ")
83
+ .trim()
84
+ .replace(/\s+/g, " ");
85
+ return `${normalizeAgentInput(agent)}::${normalizedTask}`;
86
+ }
87
+
88
+ // Replace one team's block in teams.yaml text (or append it) without touching
89
+ // comments or other teams — a full re-serialize would destroy the file's
90
+ // header comments. The block is `name:` plus its ` - member` lines.
91
+ export function upsertTeamInYaml(raw: string, name: string, members: string[]): string {
92
+ const block = `${name}:\n${members.map(m => ` - ${m}`).join("\n")}\n`;
93
+ const lines = String(raw ?? "").split("\n");
94
+ let start = -1;
95
+ let end = -1;
96
+ for (let i = 0; i < lines.length; i++) {
97
+ const teamMatch = lines[i].match(/^(\S[^:]*):\s*$/);
98
+ if (start === -1) {
99
+ if (teamMatch && teamMatch[1].trim() === name) start = i;
100
+ continue;
101
+ }
102
+ // Inside the target block: it ends at the next top-level key or a
103
+ // top-level comment (comments are never deleted, only members are).
104
+ if (teamMatch || /^#/.test(lines[i])) { end = i; break; }
105
+ }
106
+ if (start === -1) {
107
+ const body = String(raw ?? "");
108
+ const sep = body.length === 0 || body.endsWith("\n\n") ? "" : body.endsWith("\n") ? "\n" : "\n\n";
109
+ return body + sep + block;
110
+ }
111
+ if (end === -1) end = lines.length;
112
+ // Keep blank/comment lines that trail the block attached to the NEXT section.
113
+ while (end - 1 > start && lines[end - 1].trim() === "") end--;
114
+ return [...lines.slice(0, start), ...block.split("\n").slice(0, -1), ...lines.slice(end)].join("\n");
115
+ }
116
+
117
+ export function safeAgentKey(value: string): string {
118
+ if (typeof value !== "string") {
119
+ throw new Error("Agent key must be a string");
120
+ }
121
+ const key = value.trim();
122
+ if (!SAFE_AGENT_KEY_RE.test(key)) {
123
+ throw new Error(`Invalid agent key "${value}"; expected a lowercase slug (a-z, 0-9, hyphen)`);
124
+ }
125
+ return key;
126
+ }
127
+
128
+ export function safePathWithin(baseDir: string, ...segments: string[]): string {
129
+ const base = resolve(baseDir);
130
+ const target = resolve(base, ...segments);
131
+ const rel = relative(base, target);
132
+ if (rel && (rel.startsWith("..") || isAbsolute(rel))) {
133
+ throw new Error(`Refusing path outside ${base}: ${target}`);
134
+ }
135
+ return target;
136
+ }
137
+
138
+ export function clampDelegateDepth(depth: number): number {
139
+ return Math.min(Math.max(0, Math.floor(depth)), MAX_DELEGATE_DEPTH);
140
+ }
141
+
142
+ function positiveBudget(value: unknown, fallback: number): number {
143
+ const safeFallback = Math.min(Math.max(1, Math.floor(fallback)), DELEGATE_TREE_SPAWN_BUDGET);
144
+ const n = typeof value === "number" ? Math.floor(value) : Number.NaN;
145
+ return Number.isFinite(n) && n > 0 ? Math.min(n, DELEGATE_TREE_SPAWN_BUDGET) : safeFallback;
146
+ }
147
+
148
+ function remainingBudget(value: unknown, fallback: number): number {
149
+ const safeFallback = Math.min(Math.max(0, Math.floor(fallback)), DELEGATE_TREE_SPAWN_BUDGET);
150
+ const n = typeof value === "number" ? Math.floor(value) : Number.NaN;
151
+ return Number.isFinite(n) && n >= 0 ? Math.min(n, DELEGATE_TREE_SPAWN_BUDGET) : safeFallback;
152
+ }
153
+
154
+ export interface DelegateBudgetState {
155
+ depth: number;
156
+ callBudget: number;
157
+ remainingSpawns: number;
158
+ }
159
+
160
+ export function normalizeDelegateRuntimeBudgets(
161
+ input: { depth?: unknown; callBudget?: unknown; remainingSpawns?: unknown },
162
+ fallbackCallBudget = DELEGATE_TREE_SPAWN_BUDGET,
163
+ ): DelegateBudgetState {
164
+ const callBudget = positiveBudget(input.callBudget, fallbackCallBudget);
165
+ return {
166
+ depth: typeof input.depth === "number" ? clampDelegateDepth(input.depth) : 0,
167
+ callBudget,
168
+ remainingSpawns: remainingBudget(input.remainingSpawns, callBudget),
169
+ };
170
+ }
171
+
172
+ export function delegateBudgetRefusal(state: DelegateBudgetState & { callCount: number }): string | null {
173
+ if (state.depth <= 0) {
174
+ return "Delegation refused: your depth budget is 0 — you are already at the bottom of the " +
175
+ "delegation tree. Do this task yourself with your own tools.";
176
+ }
177
+ if (state.remainingSpawns <= 0) {
178
+ return `Delegation refused: tree-wide spawn budget exhausted (${DELEGATE_TREE_SPAWN_BUDGET} ` +
179
+ "delegate children per dispatch). Finish with the results you already have.";
180
+ }
181
+ if (state.callCount >= state.callBudget) {
182
+ return `Delegation refused: process call budget exhausted (${state.callBudget} delegate calls). ` +
183
+ "Finish with the results you already have.";
184
+ }
185
+ return null;
186
+ }
187
+
188
+ export function intersectToolLists(base: string, cap: string): string {
189
+ const baseSet = new Set(base.split(",").map(s => s.trim()).filter(Boolean));
190
+ return cap.split(",").map(s => s.trim()).filter(t => t && baseSet.has(t)).join(",");
191
+ }
192
+
193
+ /**
194
+ * True only when EVERY tool in the list is one of READ_ONLY_TOOLS. Conservative
195
+ * by construction: an unknown tool name makes the answer false, because the
196
+ * caller uses this to decide whether re-running is safe (a mid-run model
197
+ * fallback) and a wrong "yes" duplicates side effects.
198
+ */
199
+ export function isReadOnlyToolList(tools: string): boolean {
200
+ const allowed = new Set(READ_ONLY_TOOLS.split(",").map(s => s.trim()));
201
+ const named = String(tools ?? "").split(",").map(s => s.trim()).filter(Boolean);
202
+ return named.length > 0 && named.every(t => allowed.has(t));
203
+ }
204
+
205
+ export interface DelegateToolResolution {
206
+ baseTools: string;
207
+ effectiveTools: string;
208
+ writeDowngraded: boolean;
209
+ refused: boolean;
210
+ }
211
+
212
+ export function resolveDelegateTools(input: {
213
+ parentTools: string;
214
+ roleTools?: string;
215
+ allowWrite?: boolean;
216
+ concurrent?: boolean;
217
+ }): DelegateToolResolution {
218
+ const writeDowngraded = input.allowWrite === true && input.concurrent === true;
219
+ const baseTools = input.allowWrite === true && input.concurrent !== true ? input.parentTools : READ_ONLY_TOOLS;
220
+ const effectiveTools = input.roleTools ? intersectToolLists(baseTools, input.roleTools) : baseTools;
221
+ return {
222
+ baseTools,
223
+ effectiveTools,
224
+ writeDowngraded,
225
+ refused: effectiveTools.length === 0,
226
+ };
227
+ }
228
+
229
+ export interface DelegateSpawnPlan {
230
+ childId: string;
231
+ nextRemainingSpawns: number;
232
+ childDepth: number;
233
+ childRemainingSpawns: number;
234
+ childCanDelegate: boolean;
235
+ childExtensions: string[];
236
+ childTools: string;
237
+ includeDelegateConfig: boolean;
238
+ }
239
+
240
+ export function planDelegateSpawn(input: {
241
+ tag: string;
242
+ roleKey: string;
243
+ childSeq: number;
244
+ depth: number;
245
+ remainingSpawns: number;
246
+ effectiveTools: string;
247
+ damageControl?: string;
248
+ delegateExt: string;
249
+ }): DelegateSpawnPlan {
250
+ const nextRemainingSpawns = Math.max(0, input.remainingSpawns - 1);
251
+ const childDepth = input.depth - 1;
252
+ const childCanDelegate = childDepth > 0 && nextRemainingSpawns > 0;
253
+ return {
254
+ childId: input.tag === "root" ? `${input.roleKey}-${input.childSeq}` : `${input.tag}.${input.roleKey}-${input.childSeq}`,
255
+ nextRemainingSpawns,
256
+ childDepth,
257
+ childRemainingSpawns: nextRemainingSpawns,
258
+ childCanDelegate,
259
+ childExtensions: [
260
+ ...(input.damageControl ? [input.damageControl] : []),
261
+ ...(childCanDelegate ? [input.delegateExt] : []),
262
+ ],
263
+ childTools: childCanDelegate ? `${input.effectiveTools},delegate` : input.effectiveTools,
264
+ includeDelegateConfig: childCanDelegate,
265
+ };
266
+ }
@@ -0,0 +1,59 @@
1
+ // Pure, allowlisted serializers for Hub mode/task lifecycle audit entries.
2
+ // Callers provide only runtime identity fields; unknown properties are ignored.
3
+
4
+ function text(value, max = 4096) {
5
+ if (typeof value !== "string") return null;
6
+ const clean = value.replace(/[\r\n]+/g, " ").trim();
7
+ return clean ? clean.slice(0, max) : null;
8
+ }
9
+
10
+ function count(value) {
11
+ return Number.isFinite(value) ? Math.max(0, Math.round(value)) : 0;
12
+ }
13
+
14
+ /** Return only non-secret process/session routing identity. */
15
+ export function buildHubAuditIdentity(input = {}) {
16
+ return {
17
+ cwd: text(input.cwd),
18
+ pid: count(input.pid),
19
+ session_id: text(input.sessionId, 256),
20
+ project: text(input.project, 256),
21
+ herdr_workspace_id: text(input.workspaceId, 256),
22
+ herdr_pane_id: text(input.paneId, 256),
23
+ };
24
+ }
25
+
26
+ export function buildTaskResetAudit(input = {}) {
27
+ const prior = input.prior ?? {};
28
+ return {
29
+ schema_version: 1,
30
+ source: text(input.source, 64),
31
+ label: text(input.label, 160),
32
+ prior: {
33
+ tier: text(prior.tier, 32),
34
+ dispatches: count(prior.dispatches),
35
+ research: count(prior.research),
36
+ review_rounds: count(prior.reviewRounds),
37
+ active_ms: count(prior.activeMs),
38
+ },
39
+ identity: buildHubAuditIdentity(input.identity),
40
+ };
41
+ }
42
+
43
+ export function buildBudgetContinuationAudit(input = {}) {
44
+ const prior = input.prior ?? {};
45
+ return {
46
+ schema_version: 1,
47
+ kind: text(input.kind, 16),
48
+ continuation: count(input.continuation),
49
+ reason: text(input.reason, 64),
50
+ prior: {
51
+ tier: text(prior.tier, 32),
52
+ dispatches: count(prior.dispatches),
53
+ research: count(prior.research),
54
+ review_rounds: count(prior.reviewRounds),
55
+ active_ms: count(prior.activeMs),
56
+ },
57
+ identity: buildHubAuditIdentity(input.identity),
58
+ };
59
+ }