@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,494 @@
1
+ // scripts/lib/coms-envelope.ts
2
+ //
3
+ // The coms envelope protocol for NON-pi participants (the coms-cli and the
4
+ // Claude Code bridge). Mirrors the wire behavior of .pi/harnesses/coms/
5
+ // exactly — same registry files, same endpoint sockets, same ndjson envelopes
6
+ // and ack/nack lines — so a process using this module is indistinguishable
7
+ // from a pi peer to the rest of the pool. Any change here must stay
8
+ // compatible with the coms harness (and vice versa).
9
+ //
10
+ // No pi imports; erasable-TS; the pure parts are under node --test.
11
+
12
+ import * as crypto from "node:crypto";
13
+ import * as fs from "node:fs";
14
+ import * as net from "node:net";
15
+ import * as os from "node:os";
16
+ import * as path from "node:path";
17
+
18
+ export const COMS_DIR = process.env.PI_COMS_DIR || path.join(os.homedir(), ".pi", "coms");
19
+ export const MAX_HOPS = Number(process.env.PI_COMS_MAX_HOPS) || 5;
20
+ export const DEFAULT_TIMEOUT_MS = Number(process.env.PI_COMS_TIMEOUT_MS) || 1_800_000;
21
+ const LINE_CAP_BYTES = 64 * 1024;
22
+
23
+ // ━━ Envelope shapes (mirror coms/index.ts) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
24
+
25
+ export interface PromptEnvelope {
26
+ type: "prompt";
27
+ msg_id: string;
28
+ sender_session: string;
29
+ sender_endpoint: string;
30
+ hops: number;
31
+ timestamp: string;
32
+ prompt: string;
33
+ sender_name: string;
34
+ sender_cwd: string;
35
+ conversation_id?: string | null;
36
+ response_schema?: object | null;
37
+ }
38
+
39
+ export interface ResponseEnvelope {
40
+ type: "response";
41
+ msg_id: string;
42
+ sender_session: string;
43
+ sender_endpoint: string;
44
+ hops: number;
45
+ timestamp: string;
46
+ response: unknown;
47
+ error?: string | null;
48
+ }
49
+
50
+ export interface CancelEnvelope {
51
+ type: "cancel";
52
+ msg_id: string;
53
+ from: string;
54
+ to: string;
55
+ created_at: string;
56
+ ref_msg_id: string;
57
+ }
58
+
59
+ export interface AgentCard {
60
+ name: string;
61
+ purpose: string;
62
+ model: string;
63
+ color: string;
64
+ context_used_pct: number;
65
+ queue_depth: number;
66
+ }
67
+
68
+ export interface RegistryEntry {
69
+ session_id: string;
70
+ name: string;
71
+ purpose: string;
72
+ model: string;
73
+ color: string;
74
+ pid: number;
75
+ endpoint: string;
76
+ cwd: string;
77
+ started_at: string;
78
+ explicit: boolean;
79
+ version: number;
80
+ context_used_pct?: number;
81
+ queue_depth?: number;
82
+ heartbeat_at?: string;
83
+ }
84
+
85
+ // ━━ ids / misc ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
86
+
87
+ const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
88
+
89
+ export function ulid(): string {
90
+ const time = Date.now();
91
+ const rand = crypto.randomBytes(10);
92
+ let timeStr = "";
93
+ let t = time;
94
+ for (let i = 9; i >= 0; i--) {
95
+ timeStr = CROCKFORD[t % 32] + timeStr;
96
+ t = Math.floor(t / 32);
97
+ }
98
+ let randStr = "";
99
+ let bits = 0;
100
+ let value = 0;
101
+ for (const byte of rand) {
102
+ value = (value << 8) | byte;
103
+ bits += 8;
104
+ while (bits >= 5) {
105
+ bits -= 5;
106
+ randStr += CROCKFORD[(value >> bits) & 31];
107
+ }
108
+ }
109
+ return (timeStr + randStr).slice(0, 26);
110
+ }
111
+
112
+ export function nowIso(): string {
113
+ return new Date().toISOString();
114
+ }
115
+
116
+ export function makeEndpoint(sessionId: string): string {
117
+ if (process.platform === "win32") {
118
+ return `\\\\.\\pipe\\pi-coms-${sessionId}`;
119
+ }
120
+ return path.join(COMS_DIR, "sockets", `${sessionId}.sock`);
121
+ }
122
+
123
+ // ━━ Envelope constructors ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
124
+
125
+ export interface SenderIdentity {
126
+ session_id: string;
127
+ name: string;
128
+ endpoint: string;
129
+ cwd: string;
130
+ }
131
+
132
+ export function makePromptEnvelope(
133
+ from: SenderIdentity,
134
+ prompt: string,
135
+ opts: { hops?: number; response_schema?: object | null } = {},
136
+ ): PromptEnvelope {
137
+ return {
138
+ type: "prompt",
139
+ msg_id: ulid(),
140
+ sender_session: from.session_id,
141
+ sender_endpoint: from.endpoint,
142
+ hops: opts.hops ?? 0,
143
+ timestamp: nowIso(),
144
+ prompt,
145
+ sender_name: from.name,
146
+ sender_cwd: from.cwd,
147
+ conversation_id: null,
148
+ response_schema: opts.response_schema ?? null,
149
+ };
150
+ }
151
+
152
+ export function makeResponseEnvelope(
153
+ from: SenderIdentity,
154
+ msg_id: string,
155
+ response: unknown,
156
+ error: string | null = null,
157
+ ): ResponseEnvelope {
158
+ return {
159
+ type: "response",
160
+ msg_id,
161
+ sender_session: from.session_id,
162
+ sender_endpoint: from.endpoint,
163
+ hops: 0,
164
+ timestamp: nowIso(),
165
+ response,
166
+ error,
167
+ };
168
+ }
169
+
170
+ export function makeCancelEnvelope(options: {
171
+ from: string;
172
+ to: string;
173
+ ref_msg_id: string;
174
+ msg_id?: string;
175
+ created_at?: string;
176
+ }): CancelEnvelope {
177
+ return {
178
+ type: "cancel",
179
+ msg_id: options.msg_id ?? ulid(),
180
+ from: options.from,
181
+ to: options.to,
182
+ created_at: options.created_at ?? nowIso(),
183
+ ref_msg_id: options.ref_msg_id,
184
+ };
185
+ }
186
+
187
+ function isNonEmptyString(value: unknown): value is string {
188
+ return typeof value === "string" && value.length > 0;
189
+ }
190
+
191
+ export function isPromptEnvelope(obj: unknown): obj is PromptEnvelope {
192
+ const e = obj as PromptEnvelope;
193
+ return (
194
+ !!e &&
195
+ e.type === "prompt" &&
196
+ typeof e.msg_id === "string" &&
197
+ typeof e.prompt === "string" &&
198
+ typeof e.sender_endpoint === "string" &&
199
+ typeof e.hops === "number"
200
+ );
201
+ }
202
+
203
+ export function isResponseEnvelope(obj: unknown): obj is ResponseEnvelope {
204
+ const e = obj as ResponseEnvelope;
205
+ return !!e && e.type === "response" && typeof e.msg_id === "string" && "response" in e;
206
+ }
207
+
208
+ export function isCancelEnvelope(obj: unknown): obj is CancelEnvelope {
209
+ const e = obj as CancelEnvelope;
210
+ return (
211
+ !!e &&
212
+ e.type === "cancel" &&
213
+ isNonEmptyString(e.msg_id) &&
214
+ isNonEmptyString(e.from) &&
215
+ isNonEmptyString(e.to) &&
216
+ isNonEmptyString(e.created_at) &&
217
+ isNonEmptyString(e.ref_msg_id)
218
+ );
219
+ }
220
+
221
+ // ━━ Registry I/O (mirrors coms/index.ts semantics) ━━━━━━━━━━━━━━━━━━━━━━━━
222
+
223
+ export function projectAgentsDir(project: string): string {
224
+ return path.join(COMS_DIR, "projects", project, "agents");
225
+ }
226
+
227
+ export function registryFilePath(project: string, name: string): string {
228
+ return path.join(projectAgentsDir(project), `${name}.json`);
229
+ }
230
+
231
+ export function ensureComsDirs(project: string): void {
232
+ fs.mkdirSync(projectAgentsDir(project), { recursive: true });
233
+ if (process.platform !== "win32") {
234
+ fs.mkdirSync(path.join(COMS_DIR, "sockets"), { recursive: true });
235
+ try {
236
+ fs.chmodSync(COMS_DIR, 0o700);
237
+ } catch {
238
+ // best-effort
239
+ }
240
+ }
241
+ }
242
+
243
+ export function writeRegistryAtomic(entry: RegistryEntry, project: string): string {
244
+ const file = registryFilePath(project, entry.name);
245
+ const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
246
+ fs.writeFileSync(tmp, JSON.stringify(entry, null, 2));
247
+ fs.renameSync(tmp, file);
248
+ return file;
249
+ }
250
+
251
+ export function removeRegistryEntry(project: string, name: string): void {
252
+ try {
253
+ fs.unlinkSync(registryFilePath(project, name));
254
+ } catch {
255
+ // best-effort
256
+ }
257
+ }
258
+
259
+ export function readAllRegistryEntries(project: string): RegistryEntry[] {
260
+ const dir = projectAgentsDir(project);
261
+ let files: string[];
262
+ try {
263
+ files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
264
+ } catch {
265
+ return [];
266
+ }
267
+ const out: RegistryEntry[] = [];
268
+ for (const f of files) {
269
+ try {
270
+ const e = JSON.parse(fs.readFileSync(path.join(dir, f), "utf-8")) as RegistryEntry;
271
+ if (e && typeof e.name === "string" && typeof e.endpoint === "string") out.push(e);
272
+ } catch {
273
+ // unparseable entry — skip
274
+ }
275
+ }
276
+ return out;
277
+ }
278
+
279
+ // Same liveness rule as the coms harness: ESRCH removes the entry, EPERM
280
+ // counts as live.
281
+ export function pruneDeadEntries(project: string): RegistryEntry[] {
282
+ const live: RegistryEntry[] = [];
283
+ for (const entry of readAllRegistryEntries(project)) {
284
+ try {
285
+ process.kill(entry.pid, 0);
286
+ live.push(entry);
287
+ } catch (e) {
288
+ if ((e as NodeJS.ErrnoException)?.code === "ESRCH") {
289
+ removeRegistryEntry(project, entry.name);
290
+ } else {
291
+ live.push(entry);
292
+ }
293
+ }
294
+ }
295
+ return live;
296
+ }
297
+
298
+ export function resolveUniqueName(project: string, desiredName: string): string {
299
+ const liveNames = new Set(pruneDeadEntries(project).map((e) => e.name));
300
+ if (!liveNames.has(desiredName)) return desiredName;
301
+ let n = 2;
302
+ while (liveNames.has(`${desiredName}${n}`)) n++;
303
+ return `${desiredName}${n}`;
304
+ }
305
+
306
+ // ━━ Transport (mirrors coms/index.ts) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
307
+
308
+ export function readOneLine(socket: net.Socket): Promise<string> {
309
+ return new Promise((resolve, reject) => {
310
+ let buf = "";
311
+ let settled = false;
312
+ const onData = (chunk: Buffer) => {
313
+ buf += chunk.toString("utf-8");
314
+ if (buf.length > LINE_CAP_BYTES) {
315
+ if (settled) return;
316
+ settled = true;
317
+ socket.removeListener("data", onData);
318
+ reject(new Error("line too large"));
319
+ return;
320
+ }
321
+ const nl = buf.indexOf("\n");
322
+ if (nl >= 0) {
323
+ if (settled) return;
324
+ settled = true;
325
+ socket.removeListener("data", onData);
326
+ resolve(buf.slice(0, nl));
327
+ }
328
+ };
329
+ socket.on("data", onData);
330
+ socket.once("error", (err) => {
331
+ if (settled) return;
332
+ settled = true;
333
+ reject(err);
334
+ });
335
+ socket.once("close", () => {
336
+ if (settled) return;
337
+ settled = true;
338
+ reject(new Error("connection closed before line received"));
339
+ });
340
+ });
341
+ }
342
+
343
+ // Send one envelope, await the ack/nack (or pong) line. Rejects on nack.
344
+ export function sendEnvelope(
345
+ endpoint: string,
346
+ envelope: PromptEnvelope | ResponseEnvelope | CancelEnvelope | { type: string; msg_id?: string; [k: string]: unknown },
347
+ ): Promise<Record<string, unknown>> {
348
+ return new Promise((resolve, reject) => {
349
+ const sock = net.createConnection({ path: endpoint });
350
+ let settled = false;
351
+ const fail = (err: Error) => {
352
+ if (settled) return;
353
+ settled = true;
354
+ try {
355
+ sock.destroy();
356
+ } catch {
357
+ // ignore
358
+ }
359
+ reject(err);
360
+ };
361
+ sock.once("error", fail);
362
+ sock.once("connect", async () => {
363
+ try {
364
+ sock.write(JSON.stringify(envelope) + "\n");
365
+ const line = await readOneLine(sock);
366
+ const parsed = JSON.parse(line);
367
+ try {
368
+ sock.end();
369
+ } catch {
370
+ // ignore
371
+ }
372
+ if (settled) return;
373
+ settled = true;
374
+ if (parsed && parsed.type === "nack") {
375
+ reject(new Error(parsed.error || "nack"));
376
+ } else {
377
+ resolve(parsed);
378
+ }
379
+ } catch (err) {
380
+ fail(err instanceof Error ? err : new Error(String(err)));
381
+ }
382
+ });
383
+ });
384
+ }
385
+
386
+ function probeStaleSocket(endpoint: string): Promise<"in_use" | "stale"> {
387
+ return new Promise((resolve) => {
388
+ const sock = net.createConnection({ path: endpoint });
389
+ let settled = false;
390
+ const finish = (verdict: "in_use" | "stale") => {
391
+ if (settled) return;
392
+ settled = true;
393
+ try {
394
+ sock.destroy();
395
+ } catch {
396
+ // ignore
397
+ }
398
+ resolve(verdict);
399
+ };
400
+ const timer = setTimeout(() => finish("stale"), 250);
401
+ sock.once("connect", () => {
402
+ clearTimeout(timer);
403
+ finish("in_use");
404
+ });
405
+ sock.once("error", () => {
406
+ clearTimeout(timer);
407
+ finish("stale");
408
+ });
409
+ });
410
+ }
411
+
412
+ export async function bindEndpoint(
413
+ endpoint: string,
414
+ connHandler: (socket: net.Socket) => void,
415
+ ): Promise<net.Server> {
416
+ if (process.platform !== "win32" && fs.existsSync(endpoint)) {
417
+ const verdict = await probeStaleSocket(endpoint);
418
+ if (verdict === "in_use") {
419
+ throw new Error(`coms: endpoint already in use (${endpoint})`);
420
+ }
421
+ try {
422
+ fs.unlinkSync(endpoint);
423
+ } catch {
424
+ // best-effort
425
+ }
426
+ }
427
+ return await new Promise<net.Server>((resolve, reject) => {
428
+ const server = net.createServer(connHandler);
429
+ server.once("error", reject);
430
+ server.listen(endpoint, () => {
431
+ server.removeListener("error", reject);
432
+ resolve(server);
433
+ });
434
+ });
435
+ }
436
+
437
+ export function writeAck(socket: net.Socket, msg_id: string): void {
438
+ try {
439
+ socket.write(JSON.stringify({ type: "ack", msg_id }) + "\n");
440
+ } catch {
441
+ // ignore
442
+ }
443
+ try {
444
+ socket.end();
445
+ } catch {
446
+ // ignore
447
+ }
448
+ }
449
+
450
+ export function writeNack(socket: net.Socket, msg_id: string, error: string): void {
451
+ try {
452
+ socket.write(JSON.stringify({ type: "nack", msg_id, error }) + "\n");
453
+ } catch {
454
+ // ignore
455
+ }
456
+ try {
457
+ socket.end();
458
+ } catch {
459
+ // ignore
460
+ }
461
+ }
462
+
463
+ // Line-oriented connection handler factory: parses each ndjson line and
464
+ // dispatches; malformed lines are nacked.
465
+ export function makeConnHandler(
466
+ onEnvelope: (env: Record<string, unknown>, socket: net.Socket) => void,
467
+ ): (socket: net.Socket) => void {
468
+ return (socket) => {
469
+ let buf = "";
470
+ socket.on("error", () => {});
471
+ socket.on("data", (chunk) => {
472
+ buf += chunk.toString("utf-8");
473
+ if (buf.length > LINE_CAP_BYTES) {
474
+ writeNack(socket, "", "line too large");
475
+ socket.destroy();
476
+ return;
477
+ }
478
+ let nl: number;
479
+ while ((nl = buf.indexOf("\n")) !== -1) {
480
+ const line = buf.slice(0, nl);
481
+ buf = buf.slice(nl + 1);
482
+ if (!line.trim()) continue;
483
+ let parsed: Record<string, unknown>;
484
+ try {
485
+ parsed = JSON.parse(line);
486
+ } catch {
487
+ writeNack(socket, "", "invalid json");
488
+ continue;
489
+ }
490
+ onEnvelope(parsed, socket);
491
+ }
492
+ });
493
+ };
494
+ }