@chankov/agent-fleet 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (419) hide show
  1. package/.claude/commands/build.md +44 -0
  2. package/.claude/commands/code-simplify.md +22 -0
  3. package/.claude/commands/design-agent.md +14 -0
  4. package/.claude/commands/doctor-agent-fleet.md +17 -0
  5. package/.claude/commands/orchestrate.md +112 -0
  6. package/.claude/commands/plan.md +16 -0
  7. package/.claude/commands/prime.md +22 -0
  8. package/.claude/commands/review.md +16 -0
  9. package/.claude/commands/setup-agent-fleet.md +25 -0
  10. package/.claude/commands/ship.md +72 -0
  11. package/.claude/commands/spec.md +15 -0
  12. package/.claude/commands/test.md +19 -0
  13. package/.claude/commands/webperf.md +32 -0
  14. package/.claude/orchestrate-teams.yaml +24 -0
  15. package/.opencode/commands/af-build.md +17 -0
  16. package/.opencode/commands/af-code-simplify.md +16 -0
  17. package/.opencode/commands/af-compound.md +16 -0
  18. package/.opencode/commands/af-design-agent.md +15 -0
  19. package/.opencode/commands/af-doctor-agent-fleet.md +15 -0
  20. package/.opencode/commands/af-orchestrate.md +112 -0
  21. package/.opencode/commands/af-plan.md +16 -0
  22. package/.opencode/commands/af-prime.md +22 -0
  23. package/.opencode/commands/af-review.md +15 -0
  24. package/.opencode/commands/af-setup-agent-fleet.md +15 -0
  25. package/.opencode/commands/af-ship.md +16 -0
  26. package/.opencode/commands/af-spec.md +16 -0
  27. package/.opencode/commands/af-test.md +21 -0
  28. package/.opencode/commands/af-webperf.md +32 -0
  29. package/.opencode/orchestrate-teams.yaml +24 -0
  30. package/.pi/agents/dispatch-policy.yaml +32 -0
  31. package/.pi/agents/model-profiles.yaml +20 -0
  32. package/.pi/agents/peers.yaml +142 -0
  33. package/.pi/agents/teams.yaml +39 -0
  34. package/.pi/damage-control-rules.yaml +297 -0
  35. package/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  36. package/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  37. package/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  38. package/.pi/extensions/btw/README.md +118 -0
  39. package/.pi/extensions/btw/index.ts +917 -0
  40. package/.pi/extensions/btw/package.json +6 -0
  41. package/.pi/extensions/btw/state.js +179 -0
  42. package/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  43. package/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  44. package/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  45. package/.pi/extensions/compact-and-continue/README.md +42 -0
  46. package/.pi/extensions/compact-and-continue/index.ts +120 -0
  47. package/.pi/extensions/compact-and-continue/package.json +6 -0
  48. package/.pi/extensions/mcp-bridge/README.md +46 -0
  49. package/.pi/extensions/mcp-bridge/index.ts +206 -0
  50. package/.pi/extensions/mcp-bridge/package.json +6 -0
  51. package/.pi/extensions/package-lock.json +1143 -0
  52. package/.pi/extensions/package.json +9 -0
  53. package/.pi/extensions/pi-voice-stt/README.md +201 -0
  54. package/.pi/extensions/pi-voice-stt/config.ts +198 -0
  55. package/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  56. package/.pi/extensions/pi-voice-stt/index.ts +248 -0
  57. package/.pi/extensions/pi-voice-stt/package.json +6 -0
  58. package/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  59. package/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  60. package/.pi/harnesses/agent-hub/README.md +562 -0
  61. package/.pi/harnesses/agent-hub/artifacts.js +92 -0
  62. package/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  63. package/.pi/harnesses/agent-hub/delegate.ts +363 -0
  64. package/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  65. package/.pi/harnesses/agent-hub/helpers.ts +165 -0
  66. package/.pi/harnesses/agent-hub/index.ts +7098 -0
  67. package/.pi/harnesses/agent-hub/package.json +6 -0
  68. package/.pi/harnesses/agent-hub/return-contract.js +215 -0
  69. package/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  70. package/.pi/harnesses/agent-hub/spawn.ts +179 -0
  71. package/.pi/harnesses/ask-user-remote/README.md +10 -0
  72. package/.pi/harnesses/ask-user-remote/index.ts +253 -0
  73. package/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  74. package/.pi/harnesses/coms/README.md +71 -0
  75. package/.pi/harnesses/coms/index.ts +1743 -0
  76. package/.pi/harnesses/coms/package.json +6 -0
  77. package/.pi/harnesses/damage-control/README.md +65 -0
  78. package/.pi/harnesses/damage-control/index.ts +250 -0
  79. package/.pi/harnesses/damage-control/package.json +6 -0
  80. package/.pi/harnesses/damage-control/shared.ts +183 -0
  81. package/.pi/harnesses/damage-control-continue/README.md +116 -0
  82. package/.pi/harnesses/damage-control-continue/index.ts +522 -0
  83. package/.pi/harnesses/damage-control-continue/package.json +6 -0
  84. package/.pi/harnesses/lib/herdr-client.ts +458 -0
  85. package/.pi/harnesses/lib/herdr-presence.ts +288 -0
  86. package/.pi/harnesses/package-lock.json +35 -0
  87. package/.pi/harnesses/package.json +9 -0
  88. package/.pi/prompts/build.md +24 -0
  89. package/.pi/prompts/code-simplify.md +22 -0
  90. package/.pi/prompts/doctor-agent-fleet.md +15 -0
  91. package/.pi/prompts/plan.md +16 -0
  92. package/.pi/prompts/review.md +16 -0
  93. package/.pi/prompts/setup-agent-fleet.md +27 -0
  94. package/.pi/prompts/ship.md +17 -0
  95. package/.pi/prompts/spec.md +15 -0
  96. package/.pi/prompts/test.md +19 -0
  97. package/.pi/skills/bowser/SKILL.md +145 -0
  98. package/.versions/0.0.1/.claude/commands/build.md +44 -0
  99. package/.versions/0.0.1/.claude/commands/code-simplify.md +22 -0
  100. package/.versions/0.0.1/.claude/commands/design-agent.md +14 -0
  101. package/.versions/0.0.1/.claude/commands/doctor-agent-fleet.md +17 -0
  102. package/.versions/0.0.1/.claude/commands/orchestrate.md +112 -0
  103. package/.versions/0.0.1/.claude/commands/plan.md +16 -0
  104. package/.versions/0.0.1/.claude/commands/prime.md +22 -0
  105. package/.versions/0.0.1/.claude/commands/review.md +16 -0
  106. package/.versions/0.0.1/.claude/commands/setup-agent-fleet.md +25 -0
  107. package/.versions/0.0.1/.claude/commands/ship.md +72 -0
  108. package/.versions/0.0.1/.claude/commands/spec.md +15 -0
  109. package/.versions/0.0.1/.claude/commands/test.md +19 -0
  110. package/.versions/0.0.1/.claude/commands/webperf.md +32 -0
  111. package/.versions/0.0.1/.claude/orchestrate-teams.yaml +24 -0
  112. package/.versions/0.0.1/.opencode/commands/af-build.md +17 -0
  113. package/.versions/0.0.1/.opencode/commands/af-code-simplify.md +16 -0
  114. package/.versions/0.0.1/.opencode/commands/af-compound.md +16 -0
  115. package/.versions/0.0.1/.opencode/commands/af-design-agent.md +15 -0
  116. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +15 -0
  117. package/.versions/0.0.1/.opencode/commands/af-orchestrate.md +112 -0
  118. package/.versions/0.0.1/.opencode/commands/af-plan.md +16 -0
  119. package/.versions/0.0.1/.opencode/commands/af-prime.md +22 -0
  120. package/.versions/0.0.1/.opencode/commands/af-review.md +15 -0
  121. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +15 -0
  122. package/.versions/0.0.1/.opencode/commands/af-ship.md +16 -0
  123. package/.versions/0.0.1/.opencode/commands/af-spec.md +16 -0
  124. package/.versions/0.0.1/.opencode/commands/af-test.md +21 -0
  125. package/.versions/0.0.1/.opencode/commands/af-webperf.md +32 -0
  126. package/.versions/0.0.1/.opencode/orchestrate-teams.yaml +24 -0
  127. package/.versions/0.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  128. package/.versions/0.0.1/.pi/agents/model-profiles.yaml +20 -0
  129. package/.versions/0.0.1/.pi/agents/peers.yaml +142 -0
  130. package/.versions/0.0.1/.pi/agents/teams.yaml +39 -0
  131. package/.versions/0.0.1/.pi/damage-control-rules.yaml +297 -0
  132. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  133. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  134. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  135. package/.versions/0.0.1/.pi/extensions/btw/README.md +118 -0
  136. package/.versions/0.0.1/.pi/extensions/btw/index.ts +917 -0
  137. package/.versions/0.0.1/.pi/extensions/btw/package.json +6 -0
  138. package/.versions/0.0.1/.pi/extensions/btw/state.js +179 -0
  139. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  140. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  141. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  142. package/.versions/0.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  143. package/.versions/0.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  144. package/.versions/0.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  145. package/.versions/0.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  146. package/.versions/0.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  147. package/.versions/0.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  148. package/.versions/0.0.1/.pi/extensions/package-lock.json +1143 -0
  149. package/.versions/0.0.1/.pi/extensions/package.json +9 -0
  150. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/README.md +201 -0
  151. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  152. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  153. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  154. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  155. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  156. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  157. package/.versions/0.0.1/.pi/harnesses/agent-hub/README.md +562 -0
  158. package/.versions/0.0.1/.pi/harnesses/agent-hub/artifacts.js +92 -0
  159. package/.versions/0.0.1/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  160. package/.versions/0.0.1/.pi/harnesses/agent-hub/delegate.ts +363 -0
  161. package/.versions/0.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  162. package/.versions/0.0.1/.pi/harnesses/agent-hub/helpers.ts +165 -0
  163. package/.versions/0.0.1/.pi/harnesses/agent-hub/index.ts +7098 -0
  164. package/.versions/0.0.1/.pi/harnesses/agent-hub/package.json +6 -0
  165. package/.versions/0.0.1/.pi/harnesses/agent-hub/return-contract.js +215 -0
  166. package/.versions/0.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  167. package/.versions/0.0.1/.pi/harnesses/agent-hub/spawn.ts +179 -0
  168. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/README.md +10 -0
  169. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/index.ts +253 -0
  170. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  171. package/.versions/0.0.1/.pi/harnesses/coms/README.md +71 -0
  172. package/.versions/0.0.1/.pi/harnesses/coms/index.ts +1743 -0
  173. package/.versions/0.0.1/.pi/harnesses/coms/package.json +6 -0
  174. package/.versions/0.0.1/.pi/harnesses/damage-control/README.md +65 -0
  175. package/.versions/0.0.1/.pi/harnesses/damage-control/index.ts +250 -0
  176. package/.versions/0.0.1/.pi/harnesses/damage-control/package.json +6 -0
  177. package/.versions/0.0.1/.pi/harnesses/damage-control/shared.ts +183 -0
  178. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/README.md +116 -0
  179. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/index.ts +522 -0
  180. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/package.json +6 -0
  181. package/.versions/0.0.1/.pi/harnesses/lib/herdr-client.ts +458 -0
  182. package/.versions/0.0.1/.pi/harnesses/lib/herdr-presence.ts +288 -0
  183. package/.versions/0.0.1/.pi/harnesses/package-lock.json +35 -0
  184. package/.versions/0.0.1/.pi/harnesses/package.json +9 -0
  185. package/.versions/0.0.1/.pi/prompts/build.md +24 -0
  186. package/.versions/0.0.1/.pi/prompts/code-simplify.md +22 -0
  187. package/.versions/0.0.1/.pi/prompts/doctor-agent-fleet.md +15 -0
  188. package/.versions/0.0.1/.pi/prompts/plan.md +16 -0
  189. package/.versions/0.0.1/.pi/prompts/review.md +16 -0
  190. package/.versions/0.0.1/.pi/prompts/setup-agent-fleet.md +27 -0
  191. package/.versions/0.0.1/.pi/prompts/ship.md +17 -0
  192. package/.versions/0.0.1/.pi/prompts/spec.md +15 -0
  193. package/.versions/0.0.1/.pi/prompts/test.md +19 -0
  194. package/.versions/0.0.1/.pi/skills/bowser/SKILL.md +145 -0
  195. package/.versions/0.0.1/.version +1 -0
  196. package/.versions/0.0.1/agents/architect.md +21 -0
  197. package/.versions/0.0.1/agents/bowser.md +25 -0
  198. package/.versions/0.0.1/agents/builder.md +52 -0
  199. package/.versions/0.0.1/agents/code-reviewer.md +205 -0
  200. package/.versions/0.0.1/agents/deep-researcher.md +31 -0
  201. package/.versions/0.0.1/agents/documenter.md +16 -0
  202. package/.versions/0.0.1/agents/orchestrator.md +43 -0
  203. package/.versions/0.0.1/agents/plan-reviewer.md +60 -0
  204. package/.versions/0.0.1/agents/planner.md +69 -0
  205. package/.versions/0.0.1/agents/releaser.md +22 -0
  206. package/.versions/0.0.1/agents/researcher.md +28 -0
  207. package/.versions/0.0.1/agents/security-auditor.md +166 -0
  208. package/.versions/0.0.1/agents/test-engineer.md +144 -0
  209. package/.versions/0.0.1/agents/web-debugger.md +42 -0
  210. package/.versions/0.0.1/agents/web-performance-auditor.md +192 -0
  211. package/.versions/0.0.1/hooks/SIMPLIFY-IGNORE.md +90 -0
  212. package/.versions/0.0.1/hooks/coms-stop-hook.mjs +73 -0
  213. package/.versions/0.0.1/hooks/hooks.json +14 -0
  214. package/.versions/0.0.1/hooks/session-start.sh +74 -0
  215. package/.versions/0.0.1/hooks/simplify-ignore.sh +302 -0
  216. package/.versions/0.0.1/justfile +143 -0
  217. package/.versions/0.0.1/references/accessibility-checklist.md +160 -0
  218. package/.versions/0.0.1/references/definition-of-done.md +67 -0
  219. package/.versions/0.0.1/references/fleet-coordination-patterns.md +151 -0
  220. package/.versions/0.0.1/references/observability-checklist.md +91 -0
  221. package/.versions/0.0.1/references/orchestration-patterns.md +370 -0
  222. package/.versions/0.0.1/references/performance-checklist.md +153 -0
  223. package/.versions/0.0.1/references/prompting-patterns.md +380 -0
  224. package/.versions/0.0.1/references/security-checklist.md +179 -0
  225. package/.versions/0.0.1/references/testing-patterns.md +236 -0
  226. package/.versions/0.0.1/scripts/coms-claude-bridge.ts +286 -0
  227. package/.versions/0.0.1/scripts/coms-cli.ts +372 -0
  228. package/.versions/0.0.1/scripts/coms-hermes-bridge.ts +399 -0
  229. package/.versions/0.0.1/scripts/lib/claude-bridge-core.ts +100 -0
  230. package/.versions/0.0.1/scripts/lib/coms-envelope.ts +494 -0
  231. package/.versions/0.0.1/scripts/lib/herdr-layout.ts +235 -0
  232. package/.versions/0.0.1/scripts/lib/hermes-bridge-core.ts +238 -0
  233. package/.versions/0.0.1/scripts/lib/persona-banner.ts +62 -0
  234. package/.versions/0.0.1/scripts/lib/team-project.ts +75 -0
  235. package/.versions/0.0.1/scripts/lib/team-snapshot.ts +146 -0
  236. package/.versions/0.0.1/scripts/peer-banner.ts +40 -0
  237. package/.versions/0.0.1/scripts/team-snapshot.ts +221 -0
  238. package/.versions/0.0.1/scripts/team-up.ts +245 -0
  239. package/.versions/0.0.1/skills/_internal/grilling.md +11 -0
  240. package/.versions/0.0.1/skills/browser-testing-with-devtools/SKILL.md +352 -0
  241. package/.versions/0.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  242. package/.versions/0.0.1/skills/compound-learning/SKILL.md +137 -0
  243. package/.versions/0.0.1/skills/context-engineering/SKILL.md +291 -0
  244. package/.versions/0.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  245. package/.versions/0.0.1/skills/designing-agents/SKILL.md +394 -0
  246. package/.versions/0.0.1/skills/designing-agents/pi-harness-authoring.md +209 -0
  247. package/.versions/0.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  248. package/.versions/0.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  249. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +506 -0
  250. package/.versions/0.0.1/skills/idea-refine/SKILL.md +182 -0
  251. package/.versions/0.0.1/skills/idea-refine/examples.md +238 -0
  252. package/.versions/0.0.1/skills/idea-refine/frameworks.md +99 -0
  253. package/.versions/0.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  254. package/.versions/0.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  255. package/.versions/0.0.1/skills/incremental-implementation/SKILL.md +287 -0
  256. package/.versions/0.0.1/skills/interview-me/SKILL.md +226 -0
  257. package/.versions/0.0.1/skills/orchestration-verification/SKILL.md +181 -0
  258. package/.versions/0.0.1/skills/peer-coms/SKILL.md +81 -0
  259. package/.versions/0.0.1/skills/performance-optimization/SKILL.md +350 -0
  260. package/.versions/0.0.1/skills/planning-and-task-breakdown/SKILL.md +236 -0
  261. package/.versions/0.0.1/skills/security-and-hardening/SKILL.md +461 -0
  262. package/.versions/0.0.1/skills/spec-driven-development/SKILL.md +245 -0
  263. package/.versions/0.0.1/skills/using-agent-skills/SKILL.md +199 -0
  264. package/.versions/0.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  265. package/.versions/0.0.1/vendor/agent-skills-upstream/README.md +11 -0
  266. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  267. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  268. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  269. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  270. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  271. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  272. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  273. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  274. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  275. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  276. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  277. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  278. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  279. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  280. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  281. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  282. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  283. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  284. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  285. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  286. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  287. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  288. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  289. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  290. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  291. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  292. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  293. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  294. package/CHANGELOG.md +65 -0
  295. package/LICENSE +21 -0
  296. package/README.md +458 -0
  297. package/agents/architect.md +21 -0
  298. package/agents/bowser.md +25 -0
  299. package/agents/builder.md +52 -0
  300. package/agents/code-reviewer.md +205 -0
  301. package/agents/deep-researcher.md +31 -0
  302. package/agents/documenter.md +16 -0
  303. package/agents/orchestrator.md +43 -0
  304. package/agents/plan-reviewer.md +60 -0
  305. package/agents/planner.md +69 -0
  306. package/agents/releaser.md +22 -0
  307. package/agents/researcher.md +28 -0
  308. package/agents/security-auditor.md +166 -0
  309. package/agents/test-engineer.md +144 -0
  310. package/agents/web-debugger.md +42 -0
  311. package/agents/web-performance-auditor.md +192 -0
  312. package/bin/cli.js +633 -0
  313. package/bin/force-patch-changesets.js +44 -0
  314. package/bin/lib/bootstrap.js +323 -0
  315. package/bin/lib/detect-agent.js +49 -0
  316. package/bin/lib/doctor.js +302 -0
  317. package/bin/lib/transform-persona.js +180 -0
  318. package/bin/lib/update-notifier.js +195 -0
  319. package/bin/lib/validate-overrides.js +229 -0
  320. package/bin/snapshot-version.js +91 -0
  321. package/docs/agent-fleet-setup.md +355 -0
  322. package/docs/claude-code-coms-bridge.md +93 -0
  323. package/docs/getting-started.md +169 -0
  324. package/docs/npm-install.md +335 -0
  325. package/docs/opencode-setup.md +248 -0
  326. package/docs/pi-extensions.md +237 -0
  327. package/docs/pi-setup.md +455 -0
  328. package/docs/skill-anatomy.md +150 -0
  329. package/hooks/SIMPLIFY-IGNORE.md +90 -0
  330. package/hooks/coms-stop-hook.mjs +73 -0
  331. package/hooks/hooks.json +14 -0
  332. package/hooks/session-start.sh +74 -0
  333. package/hooks/simplify-ignore.sh +302 -0
  334. package/justfile +143 -0
  335. package/node_modules/pi-ask-user/LICENSE +21 -0
  336. package/node_modules/pi-ask-user/README.md +156 -0
  337. package/node_modules/pi-ask-user/index.ts +1795 -0
  338. package/node_modules/pi-ask-user/package.json +51 -0
  339. package/node_modules/pi-ask-user/single-select-layout.ts +203 -0
  340. package/node_modules/pi-ask-user/skills/ask-user/SKILL.md +162 -0
  341. package/node_modules/pi-ask-user/skills/ask-user/references/ask-user-skill-extension-spec.md +96 -0
  342. package/package.json +121 -0
  343. package/references/accessibility-checklist.md +160 -0
  344. package/references/definition-of-done.md +67 -0
  345. package/references/fleet-coordination-patterns.md +151 -0
  346. package/references/observability-checklist.md +91 -0
  347. package/references/orchestration-patterns.md +370 -0
  348. package/references/performance-checklist.md +153 -0
  349. package/references/prompting-patterns.md +380 -0
  350. package/references/security-checklist.md +179 -0
  351. package/references/testing-patterns.md +236 -0
  352. package/scripts/coms-claude-bridge.ts +286 -0
  353. package/scripts/coms-cli.ts +372 -0
  354. package/scripts/coms-hermes-bridge.ts +399 -0
  355. package/scripts/lib/claude-bridge-core.ts +100 -0
  356. package/scripts/lib/coms-envelope.ts +494 -0
  357. package/scripts/lib/herdr-layout.ts +235 -0
  358. package/scripts/lib/hermes-bridge-core.ts +238 -0
  359. package/scripts/lib/persona-banner.ts +62 -0
  360. package/scripts/lib/team-project.ts +75 -0
  361. package/scripts/lib/team-snapshot.ts +146 -0
  362. package/scripts/peer-banner.ts +40 -0
  363. package/scripts/team-snapshot.ts +221 -0
  364. package/scripts/team-up.ts +245 -0
  365. package/skills/_internal/grilling.md +11 -0
  366. package/skills/browser-testing-with-devtools/SKILL.md +352 -0
  367. package/skills/code-review-and-quality/SKILL.md +381 -0
  368. package/skills/compound-learning/SKILL.md +137 -0
  369. package/skills/context-engineering/SKILL.md +291 -0
  370. package/skills/deprecation-and-migration/SKILL.md +206 -0
  371. package/skills/designing-agents/SKILL.md +394 -0
  372. package/skills/designing-agents/pi-harness-authoring.md +209 -0
  373. package/skills/frontend-ui-engineering/SKILL.md +328 -0
  374. package/skills/git-workflow-and-versioning/SKILL.md +316 -0
  375. package/skills/guided-workspace-setup/SKILL.md +506 -0
  376. package/skills/idea-refine/SKILL.md +182 -0
  377. package/skills/idea-refine/examples.md +238 -0
  378. package/skills/idea-refine/frameworks.md +99 -0
  379. package/skills/idea-refine/refinement-criteria.md +113 -0
  380. package/skills/idea-refine/scripts/idea-refine.sh +15 -0
  381. package/skills/incremental-implementation/SKILL.md +287 -0
  382. package/skills/interview-me/SKILL.md +226 -0
  383. package/skills/orchestration-verification/SKILL.md +181 -0
  384. package/skills/peer-coms/SKILL.md +81 -0
  385. package/skills/performance-optimization/SKILL.md +350 -0
  386. package/skills/planning-and-task-breakdown/SKILL.md +236 -0
  387. package/skills/security-and-hardening/SKILL.md +461 -0
  388. package/skills/spec-driven-development/SKILL.md +245 -0
  389. package/skills/using-agent-skills/SKILL.md +199 -0
  390. package/vendor/agent-skills-upstream/LICENSE +21 -0
  391. package/vendor/agent-skills-upstream/README.md +11 -0
  392. package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  393. package/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  394. package/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  395. package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  396. package/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  397. package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  398. package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  399. package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  400. package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  401. package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  402. package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  403. package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  404. package/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  405. package/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  406. package/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  407. package/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  408. package/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  409. package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  410. package/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  411. package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  412. package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  413. package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  414. package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  415. package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  416. package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  417. package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  418. package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  419. package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
@@ -0,0 +1,253 @@
1
+ // ask-user-remote harness
2
+ //
3
+ // Captures the stock pi-ask-user `ask_user` tool, then registers a wrapper with
4
+ // the same schema/renderers/result shape. With no live `user-remote` coms peer
5
+ // it delegates to stock execute with the original arguments unchanged. When the
6
+ // peer is live, it races the stock local UI against a remote coms round trip.
7
+
8
+ import * as fs from "node:fs";
9
+
10
+ import { raceAskUser } from "./race-core.js";
11
+
12
+ interface ToolRegistration {
13
+ name: string;
14
+ execute?: (...args: any[]) => Promise<any> | any;
15
+ [key: string]: any;
16
+ }
17
+
18
+ interface ExtensionLike {
19
+ registerTool: (tool: ToolRegistration) => void;
20
+ [key: string]: any;
21
+ }
22
+
23
+ interface InstallOptions {
24
+ stockFactory?: (pi: ExtensionLike) => void;
25
+ startRemote?: (params: any, ctx?: any) => Promise<{ qid: string; result: Promise<any> } | null> | { qid: string; result: Promise<any> } | null;
26
+ cancelRemote?: (qid: string, reason: string) => Promise<void> | void;
27
+ warn?: (message: string) => void;
28
+ createAbortController?: () => AbortController;
29
+ }
30
+
31
+ export function captureAskUserTool(stockFactory: (pi: ExtensionLike) => void, pi: ExtensionLike): ToolRegistration {
32
+ let captured: ToolRegistration | null = null;
33
+ const proxy = new Proxy(pi, {
34
+ get(target, prop, receiver) {
35
+ if (prop === "registerTool") {
36
+ return (tool: ToolRegistration) => {
37
+ if (tool?.name === "ask_user") {
38
+ captured = tool;
39
+ return;
40
+ }
41
+ return target.registerTool(tool);
42
+ };
43
+ }
44
+ return Reflect.get(target, prop, receiver);
45
+ },
46
+ }) as ExtensionLike;
47
+
48
+ stockFactory(proxy);
49
+ if (!captured) throw new Error("ask-user-remote: stock pi-ask-user did not register ask_user");
50
+ return captured;
51
+ }
52
+
53
+ function warn(pi: ExtensionLike, options: InstallOptions, message: string): void {
54
+ if (typeof options.warn === "function") {
55
+ options.warn(message);
56
+ return;
57
+ }
58
+ if (typeof pi.logger?.warn === "function") {
59
+ pi.logger.warn(message);
60
+ return;
61
+ }
62
+ if (typeof pi.log?.warn === "function") {
63
+ pi.log.warn(message);
64
+ return;
65
+ }
66
+ console.warn(message);
67
+ }
68
+
69
+ function linkAbortSignal(parent: AbortSignal | undefined, child: AbortController): void {
70
+ if (!parent) return;
71
+ if (parent.aborted) {
72
+ child.abort();
73
+ return;
74
+ }
75
+ parent.addEventListener("abort", () => child.abort(), { once: true });
76
+ }
77
+
78
+ function stockResultFromRemote(params: any, response: any): any {
79
+ const summary = response?.kind === "selection"
80
+ ? (Array.isArray(response.selections) ? response.selections.join(", ") : "")
81
+ : response?.kind === "freeform"
82
+ ? String(response.text ?? "")
83
+ : typeof response === "string"
84
+ ? response
85
+ : JSON.stringify(response);
86
+ return {
87
+ content: [{ type: "text", text: `User answered: ${summary}` }],
88
+ details: {
89
+ question: params?.question,
90
+ context: params?.context?.trim?.() || params?.context,
91
+ options: normalizeOptions(params?.options ?? []),
92
+ response,
93
+ cancelled: false,
94
+ },
95
+ };
96
+ }
97
+
98
+ function normalizeOptions(options: any[]): Array<{ title: string; description?: string }> {
99
+ return (Array.isArray(options) ? options : [])
100
+ .map((option) => {
101
+ if (typeof option === "string") return { title: option };
102
+ if (option && typeof option === "object" && typeof option.title === "string") {
103
+ return typeof option.description === "string"
104
+ ? { title: option.title, description: option.description }
105
+ : { title: option.title };
106
+ }
107
+ return null;
108
+ })
109
+ .filter(Boolean) as Array<{ title: string; description?: string }>;
110
+ }
111
+
112
+ // Live remote questions started by defaultStartRemote, keyed by qid. A cancel
113
+ // must settle the pending result so the per-question endpoint server is closed;
114
+ // otherwise every locally-answered race leaks a bound socket until process exit.
115
+ const activeRemote = new Map<string, (error: Error) => void>();
116
+
117
+ export function activeRemoteCount(): number {
118
+ return activeRemote.size;
119
+ }
120
+
121
+ async function defaultStartRemote(params: any): Promise<{ qid: string; result: Promise<any> } | null> {
122
+ const coms = await import("../../../scripts/lib/coms-envelope.ts");
123
+ const project = process.env.PI_COMS_PROJECT || "default";
124
+ const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
125
+ const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
126
+ if (!peer) return null;
127
+
128
+ coms.ensureComsDirs(project);
129
+ const id = {
130
+ session_id: coms.ulid(),
131
+ name: "ask-user-remote",
132
+ endpoint: "",
133
+ cwd: process.cwd(),
134
+ };
135
+ id.endpoint = coms.makeEndpoint(id.session_id);
136
+
137
+ let resolveResult!: (value: any) => void;
138
+ let rejectResult!: (error: Error) => void;
139
+ const rawResult = new Promise<any>((resolve, reject) => {
140
+ resolveResult = resolve;
141
+ rejectResult = reject;
142
+ });
143
+ const server = await coms.bindEndpoint(
144
+ id.endpoint,
145
+ coms.makeConnHandler((env: Record<string, unknown>, socket: any) => {
146
+ if (coms.isResponseEnvelope(env)) {
147
+ coms.writeAck(socket, env.msg_id);
148
+ if (env.error) rejectResult(new Error(String(env.error)));
149
+ else resolveResult(stockResultFromRemote(params, env.response));
150
+ return;
151
+ }
152
+ coms.writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "ask-user-remote awaits responses only");
153
+ }),
154
+ );
155
+ const cleanup = () => {
156
+ try { server.close(); } catch { /* ignore */ }
157
+ try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
158
+ };
159
+
160
+ const promptPayload = JSON.stringify({
161
+ question: params?.question,
162
+ context: params?.context,
163
+ options: params?.options ?? [],
164
+ });
165
+ const env = coms.makePromptEnvelope(id, promptPayload);
166
+ activeRemote.set(env.msg_id, rejectResult);
167
+ const result = rawResult.finally(() => {
168
+ activeRemote.delete(env.msg_id);
169
+ cleanup();
170
+ });
171
+ try {
172
+ await coms.sendEnvelope(peer.endpoint, env);
173
+ } catch (error) {
174
+ rejectResult(error instanceof Error ? error : new Error(String(error)));
175
+ }
176
+ return { qid: env.msg_id, result };
177
+ }
178
+
179
+ async function defaultCancelRemote(qid: string, reason: string): Promise<void> {
180
+ try {
181
+ const coms = await import("../../../scripts/lib/coms-envelope.ts");
182
+ const project = process.env.PI_COMS_PROJECT || "default";
183
+ const peerName = process.env.PI_ASK_USER_REMOTE_PEER || "user-remote";
184
+ const peer = coms.pruneDeadEntries(project).find((entry: any) => entry.name === peerName);
185
+ if (peer) {
186
+ await coms.sendEnvelope(peer.endpoint, coms.makeCancelEnvelope({
187
+ from: "ask-user-remote",
188
+ to: peer.name,
189
+ ref_msg_id: qid,
190
+ }));
191
+ }
192
+ } finally {
193
+ // The bridge sends no response for a cancelled qid, so settle the pending
194
+ // result here to release the per-question endpoint server.
195
+ activeRemote.get(qid)?.(new Error(`ask-user-remote: cancelled (${reason})`));
196
+ }
197
+ }
198
+
199
+ export function wrapAskUserTool(stockTool: ToolRegistration, options: InstallOptions = {}): ToolRegistration {
200
+ return {
201
+ ...stockTool,
202
+ async execute(toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: any, ctx?: any) {
203
+ const startRemote = options.startRemote ?? defaultStartRemote;
204
+ let remoteStart: { qid: string; result: Promise<any> } | null = null;
205
+ try {
206
+ remoteStart = await startRemote(params, ctx);
207
+ } catch {
208
+ remoteStart = null;
209
+ }
210
+
211
+ if (!remoteStart) {
212
+ return await stockTool.execute?.(toolCallId, params, signal, onUpdate, ctx);
213
+ }
214
+
215
+ return await raceAskUser({
216
+ runLocal: (localSignal: AbortSignal) => stockTool.execute?.(toolCallId, params, localSignal, onUpdate, ctx),
217
+ startRemote: () => remoteStart,
218
+ cancelRemote: options.cancelRemote ?? defaultCancelRemote,
219
+ createAbortController: () => {
220
+ const controller = options.createAbortController?.() ?? new AbortController();
221
+ linkAbortSignal(signal, controller);
222
+ return controller;
223
+ },
224
+ signal,
225
+ });
226
+ },
227
+ };
228
+ }
229
+
230
+ export function installAskUserRemote(pi: ExtensionLike, options: InstallOptions = {}): { registered: boolean; tool?: ToolRegistration } {
231
+ if (!options.stockFactory) throw new Error("ask-user-remote: stockFactory is required for synchronous install");
232
+ const stockTool = captureAskUserTool(options.stockFactory, pi);
233
+ const wrapped = wrapAskUserTool(stockTool, options);
234
+ try {
235
+ pi.registerTool(wrapped);
236
+ return { registered: true, tool: wrapped };
237
+ } catch (error) {
238
+ const message = error instanceof Error ? error.message : String(error);
239
+ warn(pi, options, `ask-user-remote: ask_user already registered; wrapper not installed (${message})`);
240
+ return { registered: false };
241
+ }
242
+ }
243
+
244
+ async function loadStockFactory(): Promise<(pi: ExtensionLike) => void> {
245
+ const mod = await import("../../../node_modules/pi-ask-user/index.ts");
246
+ return mod.default as (pi: ExtensionLike) => void;
247
+ }
248
+
249
+ export default function askUserRemote(pi: ExtensionLike): void {
250
+ void loadStockFactory()
251
+ .then((stockFactory) => installAskUserRemote(pi, { stockFactory }))
252
+ .catch((error) => warn(pi, {}, `ask-user-remote: failed to load pi-ask-user (${error instanceof Error ? error.message : String(error)})`));
253
+ }
@@ -0,0 +1,106 @@
1
+ // Pure race arbitration for the ask-user-remote harness.
2
+ //
3
+ // The wrapper supplies the side-effecting pieces:
4
+ // - runLocal(signal): stock pi-ask-user execute with an AbortSignal
5
+ // - startRemote(): starts a user-remote coms request and returns
6
+ // { qid, result: Promise<stock-shaped ask_user result> }, or null when no peer
7
+ // - cancelRemote(qid, reason): best-effort cancel envelope for local-first wins
8
+ //
9
+ // This module owns only the first-answer-wins latch and exactly-once cancel/
10
+ // abort decisions; it has no pi, socket, or filesystem imports.
11
+
12
+ export async function raceAskUser({
13
+ runLocal,
14
+ startRemote,
15
+ cancelRemote,
16
+ createAbortController = () => new AbortController(),
17
+ signal,
18
+ }) {
19
+ if (typeof runLocal !== "function") throw new TypeError("runLocal is required");
20
+
21
+ const controller = createAbortController();
22
+ let settled = false;
23
+ let remotePending = false;
24
+ let remoteQid = null;
25
+ let cancelSent = false;
26
+
27
+ async function emitCancel(reason) {
28
+ if (cancelSent || !remotePending || !remoteQid || typeof cancelRemote !== "function") return;
29
+ cancelSent = true;
30
+ try {
31
+ await cancelRemote(remoteQid, reason);
32
+ } catch {
33
+ // Cancel is best-effort; the winning local answer must not fail because
34
+ // the losing remote channel is already unhealthy.
35
+ }
36
+ }
37
+
38
+ const localPromise = Promise.resolve().then(() => runLocal(controller.signal));
39
+
40
+ let remoteStart = null;
41
+ if (typeof startRemote === "function") {
42
+ try {
43
+ remoteStart = await Promise.resolve().then(() => startRemote());
44
+ } catch {
45
+ remoteStart = null;
46
+ }
47
+ }
48
+
49
+ // No live user-remote peer, or remote startup failed before a qid existed:
50
+ // preserve stock pi-ask-user behavior exactly by returning the local result.
51
+ if (!remoteStart) return await localPromise;
52
+
53
+ remoteQid = typeof remoteStart.qid === "string" ? remoteStart.qid : null;
54
+ remotePending = !!remoteQid;
55
+ const remotePromise = Promise.resolve(remoteStart.result);
56
+
57
+ // If the whole tool call is aborted (turn cancelled), withdraw the remote
58
+ // question instead of leaving it live on the phone until timeout.
59
+ if (signal) {
60
+ if (signal.aborted) void emitCancel("aborted");
61
+ else signal.addEventListener("abort", () => { void emitCancel("aborted"); }, { once: true });
62
+ }
63
+
64
+ return await new Promise((resolve, reject) => {
65
+ let localRejected = false;
66
+ let localError;
67
+ let remoteRejected = false;
68
+
69
+ localPromise.then(
70
+ async (result) => {
71
+ if (settled) return;
72
+ settled = true;
73
+ await emitCancel("local_answered");
74
+ resolve(result);
75
+ },
76
+ (error) => {
77
+ if (settled) return;
78
+ localRejected = true;
79
+ localError = error;
80
+ if (remoteRejected) {
81
+ settled = true;
82
+ reject(localError);
83
+ }
84
+ },
85
+ );
86
+
87
+ remotePromise.then(
88
+ (result) => {
89
+ remotePending = false;
90
+ if (settled) return;
91
+ settled = true;
92
+ controller.abort?.();
93
+ resolve(result);
94
+ },
95
+ () => {
96
+ remotePending = false;
97
+ remoteRejected = true;
98
+ // Remote errors are non-fatal: keep waiting for stock local behavior.
99
+ if (localRejected) {
100
+ settled = true;
101
+ reject(localError);
102
+ }
103
+ },
104
+ );
105
+ });
106
+ }
@@ -0,0 +1,71 @@
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
+ ## Presence backends: herdr vs files
17
+
18
+ Presence (who's alive, what state they're in) is pluggable; the **envelope transport,
19
+ tools, and pool-scope boundary are identical in both**:
20
+
21
+ - **herdr** — active automatically when the session runs inside a [herdr](https://herdr.dev)
22
+ pane (`HERDR_ENV=1`) and the server answers ping. Presence goes push: this peer reports
23
+ itself via `pane.report_agent` + `pane.report_metadata` (`custom_status` =
24
+ `<name> <pct>% q<depth>`, capped at 32 chars by herdr), and the pool widget populates
25
+ from `agent.list` + `events.subscribe` — **no periodic ping traffic**; peer state
26
+ changes arrive within ~1s and dead panes disappear on `pane.exited`. Turn state
27
+ (idle/working) in the herdr sidebar comes from herdr's own pi integration when
28
+ installed (`herdr integration install`); coms adds the name/context/queue annotation.
29
+ - **files** — everywhere else: the original 10s ping cycle over the peer endpoints,
30
+ byte-for-byte today's behavior.
31
+
32
+ The file registry keeps being written in BOTH backends (it carries the full agent card
33
+ that herdr's 32-char `custom_status` cannot, and keeps this peer discoverable to peers
34
+ running outside herdr panes). Peers outside herdr panes appear as dimmed "pending" rows
35
+ when you are on the herdr backend.
36
+
37
+ ## Commands & tools
38
+
39
+ - `/coms` — open the coms control surface; `--project <name>` retargets the pool (use `*` for
40
+ every project) and `--all` toggles private (`--explicit`) peers into view
41
+ - `coms_list` / `coms_send` / `coms_get` / `coms_await` tools — discover peers and
42
+ exchange messages
43
+
44
+ ## Pool scope is the reach boundary
45
+
46
+ The pool widget defines who you can reach: `coms_list` and `coms_send` resolve targets through one
47
+ `peersInScope()` helper, so a peer is reachable only if it is in the pool. By default the
48
+ pool is your own project and excludes `--explicit` peers. **Widening is a human-only action** — the
49
+ `coms_list` tool cannot widen scope; only `/coms --project` / `/coms --all` can. This prevents an
50
+ agent from messaging a cross-project peer that the widget never showed.
51
+
52
+ ## Requires
53
+
54
+ Nothing in-repo — the peer registry lives at `~/.pi/coms/` and is created at runtime.
55
+
56
+ ## Usage
57
+
58
+ ```bash
59
+ pi -e .pi/harnesses/coms/index.ts
60
+ ```
61
+
62
+ For a guarded coms node that also keeps every auto-discovered local extension (MCP bridges,
63
+ project-specific extensions) and command, use the `just safe-coms <name>` recipe — it loads
64
+ `damage-control-continue` + `coms` *on top of* normal extension discovery (no `--no-extensions`), so the
65
+ local-only tools stay scoped to that dispatcher process and never leak into the `--no-extensions`
66
+ specialists an `agent-hub` session spawns.
67
+
68
+ ## Upstream changes
69
+
70
+ - Theme integration removed — the `themeMap.ts` import and the `applyExtensionDefaults()`
71
+ call were stripped (this repo does not ship pi themes).