@chankov/agent-fleet 0.0.7 → 0.0.8

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 (303) hide show
  1. package/.pi/harnesses/agent-hub/package.json +1 -1
  2. package/.pi/harnesses/coms/package.json +1 -1
  3. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  4. package/.versions/0.0.8/.claude/commands/build.md +44 -0
  5. package/.versions/0.0.8/.claude/commands/code-simplify.md +22 -0
  6. package/.versions/0.0.8/.claude/commands/design-agent.md +14 -0
  7. package/.versions/0.0.8/.claude/commands/doctor-agent-fleet.md +17 -0
  8. package/.versions/0.0.8/.claude/commands/orchestrate.md +112 -0
  9. package/.versions/0.0.8/.claude/commands/plan.md +16 -0
  10. package/.versions/0.0.8/.claude/commands/prime.md +22 -0
  11. package/.versions/0.0.8/.claude/commands/review.md +16 -0
  12. package/.versions/0.0.8/.claude/commands/set-hermes-telegram.md +15 -0
  13. package/.versions/0.0.8/.claude/commands/set-hermes-watchdog.md +6 -0
  14. package/.versions/0.0.8/.claude/commands/setup-agent-fleet.md +25 -0
  15. package/.versions/0.0.8/.claude/commands/ship.md +72 -0
  16. package/.versions/0.0.8/.claude/commands/spec.md +15 -0
  17. package/.versions/0.0.8/.claude/commands/test.md +19 -0
  18. package/.versions/0.0.8/.claude/commands/webperf.md +32 -0
  19. package/.versions/0.0.8/.claude/orchestrate-teams.yaml +24 -0
  20. package/.versions/0.0.8/.opencode/commands/af-build.md +17 -0
  21. package/.versions/0.0.8/.opencode/commands/af-code-simplify.md +16 -0
  22. package/.versions/0.0.8/.opencode/commands/af-compound.md +16 -0
  23. package/.versions/0.0.8/.opencode/commands/af-design-agent.md +15 -0
  24. package/.versions/0.0.8/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  25. package/.versions/0.0.8/.opencode/commands/af-orchestrate.md +112 -0
  26. package/.versions/0.0.8/.opencode/commands/af-plan.md +16 -0
  27. package/.versions/0.0.8/.opencode/commands/af-prime.md +22 -0
  28. package/.versions/0.0.8/.opencode/commands/af-review.md +15 -0
  29. package/.versions/0.0.8/.opencode/commands/af-set-hermes-telegram.md +15 -0
  30. package/.versions/0.0.8/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  31. package/.versions/0.0.8/.opencode/commands/af-setup-agent-fleet.md +15 -0
  32. package/.versions/0.0.8/.opencode/commands/af-ship.md +16 -0
  33. package/.versions/0.0.8/.opencode/commands/af-spec.md +16 -0
  34. package/.versions/0.0.8/.opencode/commands/af-test.md +21 -0
  35. package/.versions/0.0.8/.opencode/commands/af-webperf.md +32 -0
  36. package/.versions/0.0.8/.opencode/orchestrate-teams.yaml +24 -0
  37. package/.versions/0.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  38. package/.versions/0.0.8/.pi/agents/model-profiles.yaml +20 -0
  39. package/.versions/0.0.8/.pi/agents/peers.yaml +146 -0
  40. package/.versions/0.0.8/.pi/agents/teams.yaml +39 -0
  41. package/.versions/0.0.8/.pi/damage-control-rules.yaml +297 -0
  42. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  43. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  44. package/.versions/0.0.8/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  45. package/.versions/0.0.8/.pi/extensions/btw/README.md +118 -0
  46. package/.versions/0.0.8/.pi/extensions/btw/index.ts +917 -0
  47. package/.versions/0.0.8/.pi/extensions/btw/package.json +6 -0
  48. package/.versions/0.0.8/.pi/extensions/btw/state.js +179 -0
  49. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  50. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  51. package/.versions/0.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  52. package/.versions/0.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  53. package/.versions/0.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  54. package/.versions/0.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  55. package/.versions/0.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  56. package/.versions/0.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  57. package/.versions/0.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  58. package/.versions/0.0.8/.pi/extensions/package-lock.json +1143 -0
  59. package/.versions/0.0.8/.pi/extensions/package.json +9 -0
  60. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/README.md +201 -0
  61. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  62. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  63. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  64. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  65. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  66. package/.versions/0.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  67. package/.versions/0.0.8/.pi/harnesses/agent-hub/README.md +857 -0
  68. package/.versions/0.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  69. package/.versions/0.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  70. package/.versions/0.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  71. package/.versions/0.0.8/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  72. package/.versions/0.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  73. package/.versions/0.0.8/.pi/harnesses/agent-hub/delegate.ts +435 -0
  74. package/.versions/0.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  75. package/.versions/0.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  76. package/.versions/0.0.8/.pi/harnesses/agent-hub/footer.ts +29 -0
  77. package/.versions/0.0.8/.pi/harnesses/agent-hub/helpers.ts +248 -0
  78. package/.versions/0.0.8/.pi/harnesses/agent-hub/index.ts +8609 -0
  79. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  80. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  81. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  82. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  83. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  84. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  85. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  86. package/.versions/0.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  87. package/.versions/0.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  88. package/.versions/0.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  89. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-retention.js +34 -0
  90. package/.versions/0.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  91. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  92. package/.versions/0.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  93. package/.versions/0.0.8/.pi/harnesses/agent-hub/run-budget.js +181 -0
  94. package/.versions/0.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  95. package/.versions/0.0.8/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  96. package/.versions/0.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  97. package/.versions/0.0.8/.pi/harnesses/agent-hub/spawn.ts +354 -0
  98. package/.versions/0.0.8/.pi/harnesses/agent-hub/spawned-peers.js +74 -0
  99. package/.versions/0.0.8/.pi/harnesses/agent-hub/version.ts +18 -0
  100. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/README.md +19 -0
  101. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/index.ts +321 -0
  102. package/.versions/0.0.8/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  103. package/.versions/0.0.8/.pi/harnesses/coms/README.md +93 -0
  104. package/.versions/0.0.8/.pi/harnesses/coms/index.ts +1767 -0
  105. package/.versions/0.0.8/.pi/harnesses/coms/package.json +7 -0
  106. package/.versions/0.0.8/.pi/harnesses/coms/version.ts +18 -0
  107. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/README.md +117 -0
  108. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/index.ts +536 -0
  109. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  110. package/.versions/0.0.8/.pi/harnesses/damage-control-continue/version.ts +18 -0
  111. package/.versions/0.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  112. package/.versions/0.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  113. package/.versions/0.0.8/.pi/harnesses/lib/herdr-client.ts +463 -0
  114. package/.versions/0.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  115. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  116. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  117. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  118. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  119. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  120. package/.versions/0.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  121. package/.versions/0.0.8/.pi/harnesses/package-lock.json +35 -0
  122. package/.versions/0.0.8/.pi/harnesses/package.json +9 -0
  123. package/.versions/0.0.8/.pi/prompts/af-build.md +24 -0
  124. package/.versions/0.0.8/.pi/prompts/af-code-simplify.md +22 -0
  125. package/.versions/0.0.8/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  126. package/.versions/0.0.8/.pi/prompts/af-plan.md +16 -0
  127. package/.versions/0.0.8/.pi/prompts/af-review.md +16 -0
  128. package/.versions/0.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  129. package/.versions/0.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  130. package/.versions/0.0.8/.pi/prompts/af-setup-agent-fleet.md +27 -0
  131. package/.versions/0.0.8/.pi/prompts/af-ship.md +17 -0
  132. package/.versions/0.0.8/.pi/prompts/af-spec.md +15 -0
  133. package/.versions/0.0.8/.pi/prompts/af-test.md +19 -0
  134. package/.versions/0.0.8/.pi/skills/bowser/SKILL.md +145 -0
  135. package/.versions/0.0.8/.version +1 -0
  136. package/.versions/0.0.8/agents/architect.md +23 -0
  137. package/.versions/0.0.8/agents/bowser.md +26 -0
  138. package/.versions/0.0.8/agents/builder.md +53 -0
  139. package/.versions/0.0.8/agents/code-reviewer.md +205 -0
  140. package/.versions/0.0.8/agents/deep-researcher.md +31 -0
  141. package/.versions/0.0.8/agents/documenter.md +18 -0
  142. package/.versions/0.0.8/agents/orchestrator.md +65 -0
  143. package/.versions/0.0.8/agents/plan-reviewer.md +60 -0
  144. package/.versions/0.0.8/agents/planner.md +69 -0
  145. package/.versions/0.0.8/agents/releaser.md +24 -0
  146. package/.versions/0.0.8/agents/researcher.md +28 -0
  147. package/.versions/0.0.8/agents/security-auditor.md +166 -0
  148. package/.versions/0.0.8/agents/test-engineer.md +151 -0
  149. package/.versions/0.0.8/agents/web-debugger.md +42 -0
  150. package/.versions/0.0.8/agents/web-performance-auditor.md +192 -0
  151. package/.versions/0.0.8/codex/CONDUCTOR.md +148 -0
  152. package/.versions/0.0.8/docs/ARCHITECTURE.md +262 -0
  153. package/.versions/0.0.8/docs/agent-fleet-setup.md +366 -0
  154. package/.versions/0.0.8/docs/claude-code-coms-bridge.md +109 -0
  155. package/.versions/0.0.8/docs/codex-remote-conductor.md +170 -0
  156. package/.versions/0.0.8/docs/coms-hermes-bridge.md +189 -0
  157. package/.versions/0.0.8/docs/getting-started.md +231 -0
  158. package/.versions/0.0.8/docs/npm-install.md +337 -0
  159. package/.versions/0.0.8/docs/opencode-setup.md +249 -0
  160. package/.versions/0.0.8/docs/pi-extensions.md +293 -0
  161. package/.versions/0.0.8/docs/pi-setup.md +476 -0
  162. package/.versions/0.0.8/docs/skill-anatomy.md +150 -0
  163. package/.versions/0.0.8/hermes/README.md +347 -0
  164. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  165. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  166. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  167. package/.versions/0.0.8/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  168. package/.versions/0.0.8/hermes/gates/gate-o-capability.md +8 -0
  169. package/.versions/0.0.8/hermes/gates/gate-o-validator-fixtures.json +1 -0
  170. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  171. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  172. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  173. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  174. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  175. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  176. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  177. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  178. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  179. package/.versions/0.0.8/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  180. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  181. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  182. package/.versions/0.0.8/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  183. package/.versions/0.0.8/hermes/skills/hub-conductor/SKILL.md +84 -0
  184. package/.versions/0.0.8/hermes/skills/hub-liaison/SKILL.md +84 -0
  185. package/.versions/0.0.8/hermes/skills/hub-watchdog/SKILL.md +76 -0
  186. package/.versions/0.0.8/hermes/skills/hub-watchdog/manifest.json +1 -0
  187. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  188. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  189. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  190. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  191. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  192. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  193. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  194. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  195. package/.versions/0.0.8/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  196. package/.versions/0.0.8/hermes/watchdog-tests/__init__.py +0 -0
  197. package/.versions/0.0.8/hooks/SIMPLIFY-IGNORE.md +90 -0
  198. package/.versions/0.0.8/hooks/coms-stop-hook.mjs +84 -0
  199. package/.versions/0.0.8/hooks/hooks.json +14 -0
  200. package/.versions/0.0.8/hooks/session-start.sh +74 -0
  201. package/.versions/0.0.8/hooks/simplify-ignore.sh +302 -0
  202. package/.versions/0.0.8/justfile +245 -0
  203. package/.versions/0.0.8/references/accessibility-checklist.md +160 -0
  204. package/.versions/0.0.8/references/definition-of-done.md +67 -0
  205. package/.versions/0.0.8/references/fleet-coordination-patterns.md +151 -0
  206. package/.versions/0.0.8/references/observability-checklist.md +91 -0
  207. package/.versions/0.0.8/references/orchestration-patterns.md +370 -0
  208. package/.versions/0.0.8/references/performance-checklist.md +153 -0
  209. package/.versions/0.0.8/references/prompting-patterns.md +380 -0
  210. package/.versions/0.0.8/references/security-checklist.md +179 -0
  211. package/.versions/0.0.8/references/testing-patterns.md +236 -0
  212. package/.versions/0.0.8/scripts/codex-conductor.ts +41 -0
  213. package/.versions/0.0.8/scripts/codex-remote-control.ts +167 -0
  214. package/.versions/0.0.8/scripts/coms-claude-bridge.ts +401 -0
  215. package/.versions/0.0.8/scripts/coms-cli.ts +484 -0
  216. package/.versions/0.0.8/scripts/coms-hermes-bridge.ts +413 -0
  217. package/.versions/0.0.8/scripts/fleet.ts +149 -0
  218. package/.versions/0.0.8/scripts/hermes-monitor-capability-runner.ts +25 -0
  219. package/.versions/0.0.8/scripts/hermes-monitor-scenario.ts +474 -0
  220. package/.versions/0.0.8/scripts/hermes-watchdog-capability-probe.ts +45 -0
  221. package/.versions/0.0.8/scripts/install-hermes-plugin.sh +180 -0
  222. package/.versions/0.0.8/scripts/lib/claude-bridge-core.ts +165 -0
  223. package/.versions/0.0.8/scripts/lib/codex-conductor.ts +88 -0
  224. package/.versions/0.0.8/scripts/lib/codex-remote-control.ts +480 -0
  225. package/.versions/0.0.8/scripts/lib/coms-envelope.ts +582 -0
  226. package/.versions/0.0.8/scripts/lib/fake-herdr-server.ts +88 -0
  227. package/.versions/0.0.8/scripts/lib/fleet-command.ts +109 -0
  228. package/.versions/0.0.8/scripts/lib/herdr-layout.ts +263 -0
  229. package/.versions/0.0.8/scripts/lib/hermes-bridge-core.ts +241 -0
  230. package/.versions/0.0.8/scripts/lib/hermes-monitor-events.ts +1 -0
  231. package/.versions/0.0.8/scripts/lib/hermes-monitor-herdr.ts +2 -0
  232. package/.versions/0.0.8/scripts/lib/hermes-monitor-model.ts +3 -0
  233. package/.versions/0.0.8/scripts/lib/hermes-monitor-registry.ts +2 -0
  234. package/.versions/0.0.8/scripts/lib/hermes-monitor-socket.ts +2 -0
  235. package/.versions/0.0.8/scripts/lib/hermes-monitor-store.ts +2 -0
  236. package/.versions/0.0.8/scripts/lib/monitor-env.ts +120 -0
  237. package/.versions/0.0.8/scripts/lib/persona-banner.ts +62 -0
  238. package/.versions/0.0.8/scripts/lib/spawn-stagger.ts +101 -0
  239. package/.versions/0.0.8/scripts/lib/team-project.ts +191 -0
  240. package/.versions/0.0.8/scripts/lib/team-snapshot.ts +147 -0
  241. package/.versions/0.0.8/scripts/peer-banner.ts +40 -0
  242. package/.versions/0.0.8/scripts/team-snapshot.ts +237 -0
  243. package/.versions/0.0.8/scripts/team-up.ts +360 -0
  244. package/.versions/0.0.8/skills/_internal/grilling.md +11 -0
  245. package/.versions/0.0.8/skills/browser-testing-with-devtools/SKILL.md +352 -0
  246. package/.versions/0.0.8/skills/code-review-and-quality/SKILL.md +381 -0
  247. package/.versions/0.0.8/skills/compound-learning/SKILL.md +137 -0
  248. package/.versions/0.0.8/skills/context-engineering/SKILL.md +291 -0
  249. package/.versions/0.0.8/skills/deprecation-and-migration/SKILL.md +206 -0
  250. package/.versions/0.0.8/skills/designing-agents/SKILL.md +394 -0
  251. package/.versions/0.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  252. package/.versions/0.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  253. package/.versions/0.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  254. package/.versions/0.0.8/skills/guided-workspace-setup/SKILL.md +544 -0
  255. package/.versions/0.0.8/skills/guided-workspace-setup/companion-manifest.json +36 -0
  256. package/.versions/0.0.8/skills/idea-refine/SKILL.md +182 -0
  257. package/.versions/0.0.8/skills/idea-refine/examples.md +238 -0
  258. package/.versions/0.0.8/skills/idea-refine/frameworks.md +99 -0
  259. package/.versions/0.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  260. package/.versions/0.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  261. package/.versions/0.0.8/skills/incremental-implementation/SKILL.md +287 -0
  262. package/.versions/0.0.8/skills/interview-me/SKILL.md +226 -0
  263. package/.versions/0.0.8/skills/orchestration-verification/SKILL.md +181 -0
  264. package/.versions/0.0.8/skills/peer-coms/SKILL.md +90 -0
  265. package/.versions/0.0.8/skills/performance-optimization/SKILL.md +350 -0
  266. package/.versions/0.0.8/skills/planning-and-task-breakdown/SKILL.md +236 -0
  267. package/.versions/0.0.8/skills/security-and-hardening/SKILL.md +461 -0
  268. package/.versions/0.0.8/skills/spec-driven-development/SKILL.md +245 -0
  269. package/.versions/0.0.8/skills/using-agent-skills/SKILL.md +199 -0
  270. package/.versions/0.0.8/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  271. package/.versions/0.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  272. package/.versions/0.0.8/vendor/agent-skills-upstream/README.md +11 -0
  273. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  274. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  275. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  276. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  277. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  278. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  279. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  280. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  281. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  282. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  283. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  284. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  285. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  286. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  287. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  288. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  289. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  290. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  291. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  292. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  293. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  294. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  295. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  296. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  297. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  298. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  299. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  300. package/.versions/0.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  301. package/CHANGELOG.md +6 -0
  302. package/package.json +1 -1
  303. package/skills/guided-workspace-setup/companion-manifest.json +1 -0
@@ -0,0 +1,96 @@
1
+ import { isAbsolute, relative, resolve } from "node:path";
2
+
3
+ const KNOWN_TAGS = new Set(["test", "runtime-ui", "code-grep", "manual"]);
4
+
5
+ export function validateEvidence(tag, evidence, options = {}) {
6
+ const normalizedTag = String(tag || "").trim().toLowerCase();
7
+ const text = String(evidence || "").trim();
8
+ if (!KNOWN_TAGS.has(normalizedTag)) {
9
+ return { ok: false, reason: `Unknown assertion tag "${tag}"; expected one of test, runtime-ui, code-grep, manual.` };
10
+ }
11
+ if (!text) return { ok: false, reason: "Evidence is required." };
12
+
13
+ if (normalizedTag === "test") return validateTestEvidence(text);
14
+ if (normalizedTag === "runtime-ui") return validateRuntimeUiEvidence(text, options);
15
+ if (normalizedTag === "code-grep") return validateCodeGrepEvidence(text);
16
+ if (normalizedTag === "manual") return validateManualEvidence(text);
17
+ return { ok: false, reason: `Unknown assertion tag "${tag}".` };
18
+ }
19
+
20
+ function validateTestEvidence(text) {
21
+ const hasIdentifier = /(?:\b(?:npm|pnpm|yarn|node|npx|vitest|jest|pytest|playwright|cargo|go test|bun)\b|\btest(?:s| name| file)?\b|`[^`]+`)/i.test(text);
22
+ const hasOutcome = /(?:\bpass(?:ed|es)?\b|\bgreen\b|\bok\b|\bexit\s*0\b|\b0\s+fail(?:ed|ures)?\b|\b\d+\/\d+\b|✓|✔)/i.test(text);
23
+ if (!hasIdentifier && !hasOutcome) return { ok: false, reason: "Test evidence must name the command/test identifier and its outcome." };
24
+ if (!hasIdentifier) return { ok: false, reason: "Test evidence must name the command or test identifier." };
25
+ if (!hasOutcome) return { ok: false, reason: "Test evidence must include the test outcome (pass/fail count, exit status, or equivalent)." };
26
+ return { ok: true };
27
+ }
28
+
29
+ function validateRuntimeUiEvidence(text, options) {
30
+ const candidates = extractPathCandidates(text).filter((p) => /(?:^|\/)artifacts\/evidence\//.test(normalizePath(p)));
31
+ if (candidates.length === 0) {
32
+ return { ok: false, reason: "Runtime-ui evidence must reference a session artifact path under artifacts/evidence/." };
33
+ }
34
+ const fileExists = typeof options.fileExists === "function" ? options.fileExists : () => false;
35
+ const evidenceRoot = options.evidenceRoot ? resolve(options.evidenceRoot) : null;
36
+ const resolvedCandidates = candidates.map((p) => resolveSessionEvidenceCandidate(p, evidenceRoot)).filter(Boolean);
37
+ if (resolvedCandidates.length === 0) {
38
+ return { ok: false, reason: "Runtime-ui evidence must reference a session artifact evidence path, not a repo-local ./artifacts path." };
39
+ }
40
+ const existing = resolvedCandidates.find((p) => {
41
+ try { return fileExists(p); } catch { return false; }
42
+ });
43
+ if (!existing) {
44
+ return { ok: false, reason: `Runtime-ui evidence artifact does not exist: ${resolvedCandidates[0]}.` };
45
+ }
46
+ return { ok: true };
47
+ }
48
+
49
+ function validateCodeGrepEvidence(text) {
50
+ const hasPattern = /(?:\bpattern\s*:|\bregex\s*:|\bgrep\b|`[^`]+`|\/[^/]+\/)/i.test(text);
51
+ const hasSample = /(?:\bmatch(?:ed|es)?\b|\bno[- ]?match(?:es)?\b|\b0\s+matches\b|\bfound\b|\bnot found\b|[\w./-]+:\d+)/i.test(text);
52
+ if (!hasPattern && !hasSample) return { ok: false, reason: "Code-grep evidence must include the searched pattern and a match/no-match result sample." };
53
+ if (!hasPattern) return { ok: false, reason: "Code-grep evidence must include the searched pattern." };
54
+ if (!hasSample) return { ok: false, reason: "Code-grep evidence must include a match/no-match result sample." };
55
+ return { ok: true };
56
+ }
57
+
58
+ function validateManualEvidence(text) {
59
+ const hasConfirmation = /(?:\bask_user\b|\bhuman\s+confirm(?:ed|ation)\b|\buser\s+(?:confirmed|said|approved|chose|answered)\b|\bmanual\s+confirm(?:ed|ation)\b|"[^"]+")/i.test(text);
60
+ if (!hasConfirmation) return { ok: false, reason: "Manual evidence must reference the ask_user answer or explicit user confirmation." };
61
+ return { ok: true };
62
+ }
63
+
64
+ function extractPathCandidates(text) {
65
+ const out = [];
66
+ const re = /(?:^|[\s(\[])(["']?)([^"'\s)\]]*(?:\.pi\/agent-sessions\/)?artifacts\/evidence\/[^"'\s)\]]+)\1/g;
67
+ let match;
68
+ while ((match = re.exec(text))) out.push(match[2].replace(/[.,;:]+$/, ""));
69
+ return out;
70
+ }
71
+
72
+ function resolveSessionEvidenceCandidate(candidate, evidenceRoot) {
73
+ const raw = String(candidate || "").trim();
74
+ const normalized = normalizePath(raw);
75
+ if (normalized.startsWith("./artifacts/evidence/")) return null;
76
+ if (evidenceRoot && normalized.startsWith("artifacts/evidence/")) {
77
+ return resolve(evidenceRoot, normalized.slice("artifacts/evidence/".length));
78
+ }
79
+ if (evidenceRoot && normalized.startsWith(".pi/agent-sessions/artifacts/evidence/")) {
80
+ return resolve(evidenceRoot, normalized.slice(".pi/agent-sessions/artifacts/evidence/".length));
81
+ }
82
+ if (isAbsolute(raw)) {
83
+ const abs = resolve(raw);
84
+ return !evidenceRoot || isWithin(evidenceRoot, abs) ? abs : null;
85
+ }
86
+ return null;
87
+ }
88
+
89
+ function isWithin(root, target) {
90
+ const rel = relative(resolve(root), resolve(target));
91
+ return rel === "" || (!!rel && !rel.startsWith("..") && !isAbsolute(rel));
92
+ }
93
+
94
+ function normalizePath(value) {
95
+ return String(value || "").replace(/\\/g, "/");
96
+ }
@@ -0,0 +1,29 @@
1
+ type FooterTheme = {
2
+ fg(color: string, text: string): string;
3
+ };
4
+
5
+ export function composeHubFooterLeft(
6
+ version: string | null,
7
+ model: string,
8
+ thinkingSuffix: string,
9
+ team: string,
10
+ ): string {
11
+ return [version ? `v${version}` : "", `${model}${thinkingSuffix}`, team]
12
+ .filter(Boolean)
13
+ .join(" · ");
14
+ }
15
+
16
+ export function renderHubFooterLeft(
17
+ theme: FooterTheme,
18
+ version: string | null,
19
+ model: string,
20
+ thinkingSuffix: string,
21
+ team: string,
22
+ ): string {
23
+ const metadata = [version ? `v${version}` : "", `${model}${thinkingSuffix}`]
24
+ .filter(Boolean)
25
+ .join(" · ");
26
+ const dimMetadata = theme.fg("dim", ` ${metadata}`);
27
+ const separator = metadata && team ? theme.fg("muted", " · ") : "";
28
+ return dimMetadata + separator + (team ? theme.fg("accent", team) : "");
29
+ }
@@ -0,0 +1,248 @@
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
+ // Normalize a dispatcher-supplied agent name to the persona-slug key space:
51
+ // display names ("Test Engineer"), underscores, and stray whitespace all resolve
52
+ // to the same key the hub stores states under ("test-engineer").
53
+ export function normalizeAgentInput(value: string): string {
54
+ return String(value ?? "").trim().toLowerCase().replace(/[\s_]+/g, "-");
55
+ }
56
+
57
+ // Duplicate-dispatch guard: one fingerprint per (agent, task) where the task
58
+ // text is normalized hard (case, whitespace, punctuation) so trivial rewording
59
+ // still collides. Genuinely different tasks differ in their words, not their
60
+ // commas.
61
+ export function taskFingerprint(agent: string, task: string): string {
62
+ const normalizedTask = String(task ?? "")
63
+ .toLowerCase()
64
+ .replace(/[^\p{L}\p{N}]+/gu, " ")
65
+ .trim()
66
+ .replace(/\s+/g, " ");
67
+ return `${normalizeAgentInput(agent)}::${normalizedTask}`;
68
+ }
69
+
70
+ // Replace one team's block in teams.yaml text (or append it) without touching
71
+ // comments or other teams — a full re-serialize would destroy the file's
72
+ // header comments. The block is `name:` plus its ` - member` lines.
73
+ export function upsertTeamInYaml(raw: string, name: string, members: string[]): string {
74
+ const block = `${name}:\n${members.map(m => ` - ${m}`).join("\n")}\n`;
75
+ const lines = String(raw ?? "").split("\n");
76
+ let start = -1;
77
+ let end = -1;
78
+ for (let i = 0; i < lines.length; i++) {
79
+ const teamMatch = lines[i].match(/^(\S[^:]*):\s*$/);
80
+ if (start === -1) {
81
+ if (teamMatch && teamMatch[1].trim() === name) start = i;
82
+ continue;
83
+ }
84
+ // Inside the target block: it ends at the next top-level key or a
85
+ // top-level comment (comments are never deleted, only members are).
86
+ if (teamMatch || /^#/.test(lines[i])) { end = i; break; }
87
+ }
88
+ if (start === -1) {
89
+ const body = String(raw ?? "");
90
+ const sep = body.length === 0 || body.endsWith("\n\n") ? "" : body.endsWith("\n") ? "\n" : "\n\n";
91
+ return body + sep + block;
92
+ }
93
+ if (end === -1) end = lines.length;
94
+ // Keep blank/comment lines that trail the block attached to the NEXT section.
95
+ while (end - 1 > start && lines[end - 1].trim() === "") end--;
96
+ return [...lines.slice(0, start), ...block.split("\n").slice(0, -1), ...lines.slice(end)].join("\n");
97
+ }
98
+
99
+ export function safeAgentKey(value: string): string {
100
+ if (typeof value !== "string") {
101
+ throw new Error("Agent key must be a string");
102
+ }
103
+ const key = value.trim();
104
+ if (!SAFE_AGENT_KEY_RE.test(key)) {
105
+ throw new Error(`Invalid agent key "${value}"; expected a lowercase slug (a-z, 0-9, hyphen)`);
106
+ }
107
+ return key;
108
+ }
109
+
110
+ export function safePathWithin(baseDir: string, ...segments: string[]): string {
111
+ const base = resolve(baseDir);
112
+ const target = resolve(base, ...segments);
113
+ const rel = relative(base, target);
114
+ if (rel && (rel.startsWith("..") || isAbsolute(rel))) {
115
+ throw new Error(`Refusing path outside ${base}: ${target}`);
116
+ }
117
+ return target;
118
+ }
119
+
120
+ export function clampDelegateDepth(depth: number): number {
121
+ return Math.min(Math.max(0, Math.floor(depth)), MAX_DELEGATE_DEPTH);
122
+ }
123
+
124
+ function positiveBudget(value: unknown, fallback: number): number {
125
+ const safeFallback = Math.min(Math.max(1, Math.floor(fallback)), DELEGATE_TREE_SPAWN_BUDGET);
126
+ const n = typeof value === "number" ? Math.floor(value) : Number.NaN;
127
+ return Number.isFinite(n) && n > 0 ? Math.min(n, DELEGATE_TREE_SPAWN_BUDGET) : safeFallback;
128
+ }
129
+
130
+ function remainingBudget(value: unknown, fallback: number): number {
131
+ const safeFallback = Math.min(Math.max(0, Math.floor(fallback)), DELEGATE_TREE_SPAWN_BUDGET);
132
+ const n = typeof value === "number" ? Math.floor(value) : Number.NaN;
133
+ return Number.isFinite(n) && n >= 0 ? Math.min(n, DELEGATE_TREE_SPAWN_BUDGET) : safeFallback;
134
+ }
135
+
136
+ export interface DelegateBudgetState {
137
+ depth: number;
138
+ callBudget: number;
139
+ remainingSpawns: number;
140
+ }
141
+
142
+ export function normalizeDelegateRuntimeBudgets(
143
+ input: { depth?: unknown; callBudget?: unknown; remainingSpawns?: unknown },
144
+ fallbackCallBudget = DELEGATE_TREE_SPAWN_BUDGET,
145
+ ): DelegateBudgetState {
146
+ const callBudget = positiveBudget(input.callBudget, fallbackCallBudget);
147
+ return {
148
+ depth: typeof input.depth === "number" ? clampDelegateDepth(input.depth) : 0,
149
+ callBudget,
150
+ remainingSpawns: remainingBudget(input.remainingSpawns, callBudget),
151
+ };
152
+ }
153
+
154
+ export function delegateBudgetRefusal(state: DelegateBudgetState & { callCount: number }): string | null {
155
+ if (state.depth <= 0) {
156
+ return "Delegation refused: your depth budget is 0 — you are already at the bottom of the " +
157
+ "delegation tree. Do this task yourself with your own tools.";
158
+ }
159
+ if (state.remainingSpawns <= 0) {
160
+ return `Delegation refused: tree-wide spawn budget exhausted (${DELEGATE_TREE_SPAWN_BUDGET} ` +
161
+ "delegate children per dispatch). Finish with the results you already have.";
162
+ }
163
+ if (state.callCount >= state.callBudget) {
164
+ return `Delegation refused: process call budget exhausted (${state.callBudget} delegate calls). ` +
165
+ "Finish with the results you already have.";
166
+ }
167
+ return null;
168
+ }
169
+
170
+ export function intersectToolLists(base: string, cap: string): string {
171
+ const baseSet = new Set(base.split(",").map(s => s.trim()).filter(Boolean));
172
+ return cap.split(",").map(s => s.trim()).filter(t => t && baseSet.has(t)).join(",");
173
+ }
174
+
175
+ /**
176
+ * True only when EVERY tool in the list is one of READ_ONLY_TOOLS. Conservative
177
+ * by construction: an unknown tool name makes the answer false, because the
178
+ * caller uses this to decide whether re-running is safe (a mid-run model
179
+ * fallback) and a wrong "yes" duplicates side effects.
180
+ */
181
+ export function isReadOnlyToolList(tools: string): boolean {
182
+ const allowed = new Set(READ_ONLY_TOOLS.split(",").map(s => s.trim()));
183
+ const named = String(tools ?? "").split(",").map(s => s.trim()).filter(Boolean);
184
+ return named.length > 0 && named.every(t => allowed.has(t));
185
+ }
186
+
187
+ export interface DelegateToolResolution {
188
+ baseTools: string;
189
+ effectiveTools: string;
190
+ writeDowngraded: boolean;
191
+ refused: boolean;
192
+ }
193
+
194
+ export function resolveDelegateTools(input: {
195
+ parentTools: string;
196
+ roleTools?: string;
197
+ allowWrite?: boolean;
198
+ concurrent?: boolean;
199
+ }): DelegateToolResolution {
200
+ const writeDowngraded = input.allowWrite === true && input.concurrent === true;
201
+ const baseTools = input.allowWrite === true && input.concurrent !== true ? input.parentTools : READ_ONLY_TOOLS;
202
+ const effectiveTools = input.roleTools ? intersectToolLists(baseTools, input.roleTools) : baseTools;
203
+ return {
204
+ baseTools,
205
+ effectiveTools,
206
+ writeDowngraded,
207
+ refused: effectiveTools.length === 0,
208
+ };
209
+ }
210
+
211
+ export interface DelegateSpawnPlan {
212
+ childId: string;
213
+ nextRemainingSpawns: number;
214
+ childDepth: number;
215
+ childRemainingSpawns: number;
216
+ childCanDelegate: boolean;
217
+ childExtensions: string[];
218
+ childTools: string;
219
+ includeDelegateConfig: boolean;
220
+ }
221
+
222
+ export function planDelegateSpawn(input: {
223
+ tag: string;
224
+ roleKey: string;
225
+ childSeq: number;
226
+ depth: number;
227
+ remainingSpawns: number;
228
+ effectiveTools: string;
229
+ damageControl?: string;
230
+ delegateExt: string;
231
+ }): DelegateSpawnPlan {
232
+ const nextRemainingSpawns = Math.max(0, input.remainingSpawns - 1);
233
+ const childDepth = input.depth - 1;
234
+ const childCanDelegate = childDepth > 0 && nextRemainingSpawns > 0;
235
+ return {
236
+ childId: input.tag === "root" ? `${input.roleKey}-${input.childSeq}` : `${input.tag}.${input.roleKey}-${input.childSeq}`,
237
+ nextRemainingSpawns,
238
+ childDepth,
239
+ childRemainingSpawns: nextRemainingSpawns,
240
+ childCanDelegate,
241
+ childExtensions: [
242
+ ...(input.damageControl ? [input.damageControl] : []),
243
+ ...(childCanDelegate ? [input.delegateExt] : []),
244
+ ],
245
+ childTools: childCanDelegate ? `${input.effectiveTools},delegate` : input.effectiveTools,
246
+ includeDelegateConfig: childCanDelegate,
247
+ };
248
+ }