@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,18 @@
1
+ import { readFileSync } from "node:fs";
2
+
3
+ export const VERSION_STATUS_KEY = "00-agent-fleet-version";
4
+
5
+ function readAdjacentVersion(): string | null {
6
+ try {
7
+ const manifest = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
8
+ return typeof manifest.version === "string" && manifest.version.length > 0 ? manifest.version : null;
9
+ } catch {
10
+ return null;
11
+ }
12
+ }
13
+
14
+ export const HARNESS_VERSION = readAdjacentVersion();
15
+
16
+ export function registerVersionStatus(ctx: { ui?: { setStatus?: (key: string, text: string) => void } }): void {
17
+ if (HARNESS_VERSION) ctx.ui?.setStatus?.(VERSION_STATUS_KEY, `v${HARNESS_VERSION}`);
18
+ }
@@ -0,0 +1,94 @@
1
+ // .pi/harnesses/lib/coms-registry-entry.ts
2
+ //
3
+ // The shape written to ~/.pi/coms/projects/<project>/agents/<name>.json, and
4
+ // the one function that builds it for the 30-second heartbeat.
5
+ //
6
+ // It exists because both harnesses (the standalone coms harness and the copy
7
+ // embedded in agent-hub) had their own inline copy of the same object literal,
8
+ // and both copies wrote `started_at: nowIso()` on EVERY heartbeat. The field
9
+ // therefore never held the start of anything — it was always "about 30 seconds
10
+ // ago", and every reader that tried to show uptime showed noise. Registration
11
+ // sets `started_at`; the heartbeat carries it forward unchanged and moves
12
+ // `heartbeat_at` instead. That distinction is the whole point of this module,
13
+ // so it is stated once, here, and tested.
14
+ //
15
+ // Pure module: no pi imports, no fs, no clock of its own — `now` is passed in.
16
+ // Erasable-TS; testable under node --test.
17
+
18
+ export interface ComsRegistryEntry {
19
+ session_id: string;
20
+ name: string;
21
+ purpose: string;
22
+ model: string;
23
+ color: string;
24
+ pid: number;
25
+ endpoint: string;
26
+ cwd: string;
27
+ // When this session registered. NEVER refreshed — see the module note.
28
+ started_at: string;
29
+ explicit: boolean;
30
+ version: number;
31
+ // Live status snapshot — refreshed every keepalive tick. Optional so
32
+ // entries written before the heartbeat carried them still parse cleanly.
33
+ context_used_pct?: number;
34
+ queue_depth?: number;
35
+ heartbeat_at?: string;
36
+ }
37
+
38
+ // What the session knows about itself from registration onwards. This is the
39
+ // harness `identity` object; it is the source of every field the heartbeat is
40
+ // not allowed to invent.
41
+ export interface ComsIdentity {
42
+ session_id: string;
43
+ name: string;
44
+ purpose: string;
45
+ color: string;
46
+ cwd: string;
47
+ endpoint: string;
48
+ explicit: boolean;
49
+ model: string;
50
+ started_at: string;
51
+ }
52
+
53
+ // What is genuinely new at heartbeat time.
54
+ export interface LiveSnapshot {
55
+ now: string;
56
+ pid: number;
57
+ // The model can change mid-session (`/model`), so it is re-read rather than
58
+ // frozen at registration; falling back to the registered one when the ctx
59
+ // is not available.
60
+ model?: string | null;
61
+ contextUsedPct?: number | null;
62
+ queueDepth?: number | null;
63
+ }
64
+
65
+ // Percentages arrive from `ctx.getContextUsage()`, queue depths from a Map
66
+ // size. Both reach a human eye and a JSON file, so neither may be NaN,
67
+ // negative, or fractional.
68
+ function count(value: number | null | undefined): number {
69
+ if (typeof value !== "number" || !Number.isFinite(value)) return 0;
70
+ return Math.max(0, Math.round(value));
71
+ }
72
+
73
+ // The registry entry for a heartbeat write. Also the entry used for self-heal
74
+ // (the file was unlinked under us and is being re-created), which is why every
75
+ // field is present rather than patched onto whatever is on disk: there may be
76
+ // nothing on disk.
77
+ export function buildLiveRegistryEntry(identity: ComsIdentity, live: LiveSnapshot): ComsRegistryEntry {
78
+ return {
79
+ session_id: identity.session_id,
80
+ name: identity.name,
81
+ purpose: identity.purpose,
82
+ model: live.model || identity.model,
83
+ color: identity.color,
84
+ pid: live.pid,
85
+ endpoint: identity.endpoint,
86
+ cwd: identity.cwd,
87
+ started_at: identity.started_at,
88
+ explicit: identity.explicit,
89
+ version: 1,
90
+ context_used_pct: count(live.contextUsedPct),
91
+ queue_depth: count(live.queueDepth),
92
+ heartbeat_at: live.now,
93
+ };
94
+ }
@@ -0,0 +1,197 @@
1
+ /**
2
+ * Shared exemption + escalation plumbing for damage-control-continue and agent-hub.
3
+ *
4
+ * Exemptions are runtime, session-scoped allowances layered on top of
5
+ * `.pi/damage-control-rules.yaml` — they never edit the rules file and only
6
+ * ever apply to the path categories (zeroAccessPaths / readOnlyPaths /
7
+ * noDeletePaths), never to the destructive bashToolPatterns.
8
+ *
9
+ * Consumers:
10
+ * - damage-control-continue — /allow commands, block-time prompts, and
11
+ * escalation to the agent-hub dispatcher from headless children
12
+ * - agent-hub — computes the shared file path, passes the env plumbing to
13
+ * spawned children, and answers access_request envelopes on its coms socket
14
+ */
15
+
16
+ import * as fs from "fs";
17
+ import * as net from "net";
18
+ import * as os from "os";
19
+ import * as path from "path";
20
+
21
+ // Env plumbing agent-hub sets on spawned children. spawnPiAgent spreads
22
+ // process.env, so delegate grandchildren inherit these for free.
23
+ export const ASK_ENDPOINT_ENV = "AGENT_HUB_ASK_ENDPOINT";
24
+ export const EXEMPTIONS_FILE_ENV = "AGENT_HUB_EXEMPTIONS_FILE";
25
+ export const AGENT_ID_ENV = "AGENT_HUB_AGENT_ID";
26
+
27
+ export type ExemptionScope = "turn" | "session";
28
+ export type PathRuleCategory = "zero_access" | "read_only" | "no_delete";
29
+
30
+ export interface Exemption {
31
+ /** The protected pattern being unlocked — same syntax as the rules file entries. */
32
+ pattern: string;
33
+ scope: ExemptionScope;
34
+ /** When set, the exemption applies only to the spawned agent with this id. */
35
+ agent?: string;
36
+ grantedVia: "command" | "prompt" | "escalation";
37
+ grantedAt: string;
38
+ }
39
+
40
+ // ── shared exemptions file (one per hub session, read by spawned children) ──
41
+
42
+ export function exemptionsFilePath(sessionId: string): string {
43
+ const comsDir = process.env.PI_COMS_DIR || path.join(os.homedir(), ".pi", "coms");
44
+ return path.join(comsDir, "exemptions", `${sessionId}.json`);
45
+ }
46
+
47
+ export function readExemptionsFile(filePath: string | undefined): Exemption[] {
48
+ if (!filePath) return [];
49
+ try {
50
+ const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
51
+ if (!Array.isArray(parsed)) return [];
52
+ return parsed.filter((e): e is Exemption => !!e && typeof e.pattern === "string" && e.pattern.length > 0);
53
+ } catch {
54
+ return [];
55
+ }
56
+ }
57
+
58
+ /** Exemptions visible to one process: agent-agnostic entries plus those granted to `agentId`. */
59
+ export function fileExemptionsFor(filePath: string | undefined, agentId: string | undefined): Exemption[] {
60
+ return readExemptionsFile(filePath).filter((e) => !e.agent || e.agent === agentId);
61
+ }
62
+
63
+ export function appendExemptionToFile(filePath: string, exemption: Exemption): void {
64
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
65
+ const existing = readExemptionsFile(filePath);
66
+ const dup = existing.some((e) => e.pattern === exemption.pattern && (e.agent ?? "") === (exemption.agent ?? ""));
67
+ if (!dup) existing.push(exemption);
68
+ const tmp = `${filePath}.tmp`;
69
+ fs.writeFileSync(tmp, JSON.stringify(existing, null, 2));
70
+ fs.renameSync(tmp, filePath);
71
+ }
72
+
73
+ /** Remove every entry for `pattern` (any agent). Returns true when something was removed. */
74
+ export function removeExemptionFromFile(filePath: string | undefined, pattern: string): boolean {
75
+ if (!filePath) return false;
76
+ const existing = readExemptionsFile(filePath);
77
+ const next = existing.filter((e) => e.pattern !== pattern);
78
+ if (next.length === existing.length) return false;
79
+ try {
80
+ const tmp = `${filePath}.tmp`;
81
+ fs.writeFileSync(tmp, JSON.stringify(next, null, 2));
82
+ fs.renameSync(tmp, filePath);
83
+ return true;
84
+ } catch {
85
+ return false;
86
+ }
87
+ }
88
+
89
+ // ── escalation protocol (headless child → hub dispatcher) ──
90
+
91
+ /**
92
+ * Sent by a child's damage-control-continue to the hub's coms socket. Carries
93
+ * the Envelope base fields (sender_session = agent id, sender_endpoint = "")
94
+ * so the hub's isValidEnvelope accepts it.
95
+ */
96
+ export interface AccessRequest {
97
+ type: "access_request";
98
+ msg_id: string;
99
+ sender_session: string;
100
+ sender_endpoint: string;
101
+ hops: number;
102
+ timestamp: string;
103
+ agent: string;
104
+ tool: string;
105
+ rule: string;
106
+ pattern: string;
107
+ category: PathRuleCategory;
108
+ invocation: string;
109
+ }
110
+
111
+ export type AccessDecisionChoice = "deny" | "allow_once" | "allow_agent" | "allow_all";
112
+
113
+ /** Protected deletions are approved per invocation; broader grants stay operator-explicit. */
114
+ export function accessDecisionChoices(category: PathRuleCategory): AccessDecisionChoice[] {
115
+ return category === "no_delete"
116
+ ? ["deny", "allow_once"]
117
+ : ["deny", "allow_once", "allow_agent", "allow_all"];
118
+ }
119
+
120
+ /** Coalesce identical asks without letting one delete approval cover sibling paths. */
121
+ export function accessRequestCacheKey(
122
+ request: Pick<AccessRequest, "agent" | "pattern" | "category" | "invocation">,
123
+ ): string {
124
+ const base = `${request.agent}::${request.pattern}`;
125
+ return request.category === "no_delete" ? `${base}::${request.invocation}` : base;
126
+ }
127
+
128
+ export interface AccessDecision {
129
+ type: "access_decision";
130
+ msg_id: string;
131
+ decision: AccessDecisionChoice;
132
+ }
133
+
134
+ export const ESCALATION_TIMEOUT_MS = Number(process.env.AGENT_HUB_ASK_TIMEOUT_MS) || 60_000;
135
+
136
+ /**
137
+ * Ask the hub to approve a blocked call. Synchronous over a single connection:
138
+ * the child has no socket server of its own, so the hub keeps this socket open
139
+ * and writes the decision line whenever the user answers. Resolves "timeout" /
140
+ * "error" instead of rejecting — callers always fail closed.
141
+ */
142
+ export function requestAccessFromHub(
143
+ endpoint: string,
144
+ request: AccessRequest,
145
+ timeoutMs: number = ESCALATION_TIMEOUT_MS,
146
+ ): Promise<AccessDecisionChoice | "timeout" | "error"> {
147
+ return new Promise((resolve) => {
148
+ let settled = false;
149
+ let timer: ReturnType<typeof setTimeout> | undefined;
150
+ let sock: net.Socket;
151
+ const settle = (v: AccessDecisionChoice | "timeout" | "error") => {
152
+ if (settled) return;
153
+ settled = true;
154
+ if (timer) clearTimeout(timer);
155
+ try { sock.destroy(); } catch { /* ignore */ }
156
+ resolve(v);
157
+ };
158
+ try {
159
+ sock = net.createConnection({ path: endpoint });
160
+ } catch {
161
+ resolve("error");
162
+ return;
163
+ }
164
+ timer = setTimeout(() => settle("timeout"), timeoutMs);
165
+ let buf = "";
166
+ sock.on("connect", () => {
167
+ try {
168
+ sock.write(JSON.stringify(request) + "\n");
169
+ } catch {
170
+ settle("error");
171
+ }
172
+ });
173
+ sock.on("data", (chunk: Buffer) => {
174
+ buf += chunk.toString("utf-8");
175
+ const nl = buf.indexOf("\n");
176
+ if (nl < 0) return;
177
+ try {
178
+ const parsed = JSON.parse(buf.slice(0, nl));
179
+ if (
180
+ parsed &&
181
+ parsed.type === "access_decision" &&
182
+ (parsed.decision === "deny" || parsed.decision === "allow_once" ||
183
+ parsed.decision === "allow_agent" || parsed.decision === "allow_all")
184
+ ) {
185
+ settle(parsed.decision);
186
+ } else {
187
+ // nack or unknown reply (e.g. an older hub without escalation support)
188
+ settle("error");
189
+ }
190
+ } catch {
191
+ settle("error");
192
+ }
193
+ });
194
+ sock.on("error", () => settle("error"));
195
+ sock.on("close", () => settle("error"));
196
+ });
197
+ }