@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,100 @@
1
+ # coms
2
+
3
+ Peer-to-peer messaging between pi agents on the same machine.
4
+
5
+ > Ported from [`pi-vs-claude-code`](https://github.com/disler/pi-vs-claude-code) by [disler](https://github.com/disler) (MIT). See the [extension catalog](../../../docs/pi-extensions.md).
6
+
7
+ ## What it does
8
+
9
+ Lets multiple pi agents running on the same machine talk to each other. Each agent listens
10
+ on a single endpoint — a unix socket on POSIX, a named pipe on Windows — and discovers
11
+ peers through per-project registry files under `~/.pi/coms/projects/<project>/agents/`.
12
+
13
+ Surfaces a live "pool" widget of connected peers, with ping and keepalive cycles and a
14
+ clean shutdown lifecycle.
15
+
16
+ ## Version footer and provenance
17
+
18
+ This persistent-UI harness shows `agent fleet v<version>` below the prompt. It shares one common-key
19
+ status with `agent-hub` and `damage-control-continue`, so a stack renders the
20
+ version once. The root `package.json` is canonical; `bin/sync-harness-versions.js` synchronizes
21
+ its value into this adjacent manifest. The local `version.ts` reader is retained so a copied or
22
+ symlinked harness resolves its own adjacent stamp, not the launch directory. That provenance
23
+ pair does not carry dependencies: copy/symlink targets still require the existing full
24
+ `.pi/harnesses/` dependency installation.
25
+
26
+ The `agent fleet` half of the label is an OSC 8 terminal hyperlink to the project homepage —
27
+ clickable in terminals that support hyperlinks, ignored (rendered as plain text) elsewhere, and
28
+ free of footer columns because pi strips OSC sequences before measuring width. It opens the
29
+ repository in a browser, not a TUI panel: pi has no mouse tracking, so a click never reaches the
30
+ harness. `AGENT_FLEET_NO_LINKS=1` restores the plain label on multiplexers that mangle OSC 8
31
+ (GNU screen, tmux before 3.4).
32
+
33
+ ## Presence backends: herdr vs files
34
+
35
+ Presence (who's alive, what state they're in) is pluggable; the **envelope transport,
36
+ tools, and pool-scope boundary are identical in both**:
37
+
38
+ - **herdr** — active automatically when the session runs inside a [herdr](https://herdr.dev)
39
+ pane (`HERDR_ENV=1`) and the server answers ping. Presence goes push: this peer reports
40
+ itself via `pane.report_agent` + `pane.report_metadata` (`tokens` = `coms`/`proj`/
41
+ `ctx`/`q` on herdr >= 0.7.4, one latched fallback to the legacy 32-char
42
+ `custom_status` = `<name> <pct>% q<depth>`), and the pool widget populates
43
+ from `agent.list` + `events.subscribe` — **no periodic ping traffic**; peer state
44
+ changes arrive within ~1s and dead panes disappear on `pane.exited`. Turn state
45
+ (idle/working) in the herdr sidebar comes from herdr's own pi integration when
46
+ installed (`herdr integration install`); coms adds the name/context/queue annotation.
47
+ - **files** — everywhere else: the original 10s ping cycle over the peer endpoints,
48
+ byte-for-byte today's behavior.
49
+
50
+ The file registry keeps being written in BOTH backends (it carries the full agent card
51
+ that a pane annotation cannot, and keeps this peer discoverable to peers
52
+ running outside herdr panes). Peers outside herdr panes appear as dimmed "pending" rows
53
+ when you are on the herdr backend.
54
+
55
+ ## Commands & tools
56
+
57
+ - `/af-coms` — open the coms control surface; `--project <name>` retargets the pool (use `*` for
58
+ every project) and `--all` toggles private (`--explicit`) peers into view
59
+ - `coms_list` / `coms_send` / `coms_get` / `coms_await` tools — discover peers and
60
+ exchange messages
61
+
62
+ ## External conductors
63
+
64
+ Two optional phone-facing conductors use this same pool without becoming pane owners:
65
+
66
+ - **Hermes/Telegram** is the inbound `ask_user` route and can also perform bounded coms delegation.
67
+ - **Codex Remote Control** is an experimental outbound-only Android route. Its user-systemd service loads a managed contract from an external user-state workspace, and `scripts/codex-conductor.ts` permits only scoped `list` plus one serialized `send --await`. See the [operator runbook](../../../docs/codex-remote-conductor.md).
68
+
69
+ Both must use the same validated project as the peers they target. Neither conductor may drive Herdr lifecycle.
70
+
71
+ Standalone `coms-cli` queues are project-scoped under `~/.pi/coms/cli/projects/<project>/<name>/`. Legacy name-only queues fail closed until an operator assigns and moves the complete queue; `projects` is a reserved identity name.
72
+
73
+ ## Pool scope is the reach boundary
74
+
75
+ The pool widget defines who you can reach: `coms_list` and `coms_send` resolve targets through one
76
+ `peersInScope()` helper, so a peer is reachable only if it is in the pool. By default the
77
+ pool is your own project and excludes `--explicit` peers. **Widening is a human-only action** — the
78
+ `coms_list` tool cannot widen scope; only `/af-coms --project` / `/af-coms --all` can. This prevents an
79
+ agent from messaging a cross-project peer that the widget never showed.
80
+
81
+ ## Requires
82
+
83
+ Nothing in-repo — the peer registry lives at `~/.pi/coms/` and is created at runtime.
84
+
85
+ ## Usage
86
+
87
+ ```bash
88
+ pi -e .pi/harnesses/coms/index.ts
89
+ ```
90
+
91
+ For a guarded coms node, use `just fleet peer <name>`. It loads Fleet Core plus `coms`
92
+ with deterministic extension discovery. Add `--browser` for Chrome DevTools or
93
+ `--all-extensions` when the peer intentionally needs arbitrary project/global extensions;
94
+ those tools stay scoped to that process and never leak into Agent Hub's
95
+ `--no-extensions` specialists.
96
+
97
+ ## Upstream changes
98
+
99
+ - Theme integration removed — the `themeMap.ts` import and the `applyExtensionDefaults()`
100
+ call were stripped (this repo does not ship pi themes).