@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,90 @@
1
+ # simplify-ignore hook
2
+
3
+ Block-level protection for `/code-simplify`. Mark code that should never be simplified — the model won't see it.
4
+
5
+ ## Setup
6
+
7
+ 1. Annotate blocks you want to protect:
8
+
9
+ ```js
10
+ /* simplify-ignore-start: perf-critical */
11
+ // manually unrolled XOR — 3x faster than a loop
12
+ result[0] = buf[0] ^ key[0];
13
+ result[1] = buf[1] ^ key[1];
14
+ result[2] = buf[2] ^ key[2];
15
+ result[3] = buf[3] ^ key[3];
16
+ /* simplify-ignore-end */
17
+ ```
18
+
19
+ 2. Add hooks to `.claude/settings.json`:
20
+
21
+ ```json
22
+ {
23
+ "hooks": {
24
+ "PreToolUse": [
25
+ {
26
+ "matcher": "Read",
27
+ "hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
28
+ }
29
+ ],
30
+ "PostToolUse": [
31
+ {
32
+ "matcher": "Edit|Write",
33
+ "hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
34
+ }
35
+ ],
36
+ "Stop": [
37
+ {
38
+ "hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
39
+ }
40
+ ]
41
+ }
42
+ }
43
+ ```
44
+
45
+ 3. Run `/code-simplify` — protected blocks become `/* BLOCK_de115a1d: perf-critical */` placeholders. The model reasons about surrounding code without seeing the protected implementation.
46
+
47
+ > **Note:** The hook stores temporary backups in `.claude/.simplify-ignore-cache/`. Make sure this path is in your `.gitignore`.
48
+
49
+ ## How it works
50
+
51
+ One script, three hook events:
52
+
53
+ | Event | Action |
54
+ |---|---|
55
+ | `PreToolUse Read` | Backs up file, replaces blocks with `BLOCK_<hash>` placeholders in-place |
56
+ | `PostToolUse Edit\|Write` | Expands placeholders back to real code, saves model's changes, re-filters |
57
+ | `Stop` | Restores all files from backup when session ends |
58
+
59
+ Each block is content-hashed (8 hex chars via `shasum`/`sha1sum`) so the round-trip is unambiguous even if the model duplicates or reorders placeholders. Cache is project-scoped to prevent cross-session interference.
60
+
61
+ ## Annotation syntax
62
+
63
+ ```js
64
+ /* simplify-ignore-start */ // basic — hides the block
65
+ /* simplify-ignore-start: reason */ // with reason — appears in placeholder
66
+ /* simplify-ignore-end */
67
+ ```
68
+
69
+ Any comment style works (`//`, `/*`, `#`, `<!--`). Multiple blocks per file and single-line blocks supported. Placeholders preserve the original comment syntax (e.g. `# BLOCK_xxx` for Python, `<!-- BLOCK_xxx -->` for HTML).
70
+
71
+ ## Crash recovery
72
+
73
+ If Claude Code crashes without triggering the Stop hook, files on disk may still have `BLOCK_<hash>` placeholders. To restore manually:
74
+
75
+ ```bash
76
+ echo '{}' | bash hooks/simplify-ignore.sh
77
+ ```
78
+
79
+ Backups are stored in `.claude/.simplify-ignore-cache/` within your project directory.
80
+
81
+ ## Known limitations
82
+
83
+ - **Single-line blocks hide the entire line.** If `simplify-ignore-start` and `simplify-ignore-end` appear on the same line as other code, the whole line is hidden from the model, not just the annotated portion. Use dedicated lines for annotations.
84
+ - **Comment suffix detection covers `*/` and `-->` only.** Template engines with non-standard comment closers (ERB `%>`, Blade `--}}`) may produce unbalanced placeholders. Use `#` or `//` style comments instead.
85
+ - **Fallback expansion is progressive, not exact.** If the model alters a placeholder's formatting (e.g. changes the reason text), the hook tries progressively simpler matches: full placeholder → prefix+hash+suffix → hash-only. The hash-only fallback may leave cosmetic debris (e.g. stray `:` or reason text). A warning is printed to stderr when this happens.
86
+ - **File renaming leaves placeholders.** If the model renames or moves a file via a shell command, the new file will retain `BLOCK_<hash>` placeholders. The original code is saved as `<old-filename>.recovered` when the session stops. You must manually restore the recovered code into the new file.
87
+
88
+ ## Requirements
89
+
90
+ - `jq`, `shasum` or `sha1sum` (auto-detected), Bash 3.2+
@@ -0,0 +1,73 @@
1
+ #!/usr/bin/env node
2
+ // hooks/coms-stop-hook.mjs — Claude Code Stop hook for the coms bridge.
3
+ //
4
+ // Writes the final assistant message of each turn to the file the
5
+ // coms-claude-bridge watches (~/.pi/coms/claude-bridge/<pane>/last-message.json,
6
+ // keyed by HERDR_PANE_ID), making the hook the bridge's PRIMARY completion
7
+ // path (exact text, no pane scraping). Outside a herdr pane it does nothing.
8
+ //
9
+ // Install (project or user settings.json):
10
+ // {
11
+ // "hooks": {
12
+ // "Stop": [{ "hooks": [{ "type": "command",
13
+ // "command": "node /path/to/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
14
+ // }
15
+ // }
16
+ //
17
+ // The hook receives {session_id, transcript_path, …} as JSON on stdin and
18
+ // must never fail the turn: every error path exits 0.
19
+
20
+ import * as fs from "node:fs";
21
+ import * as os from "node:os";
22
+ import * as path from "node:path";
23
+
24
+ function lastAssistantText(transcriptPath) {
25
+ const raw = fs.readFileSync(transcriptPath, "utf-8");
26
+ let text = null;
27
+ for (const line of raw.split("\n")) {
28
+ if (!line.trim()) continue;
29
+ let entry;
30
+ try {
31
+ entry = JSON.parse(line);
32
+ } catch {
33
+ continue;
34
+ }
35
+ if (entry?.type !== "assistant") continue;
36
+ const content = entry?.message?.content;
37
+ if (!Array.isArray(content)) continue;
38
+ const parts = content.filter((c) => c?.type === "text" && typeof c.text === "string").map((c) => c.text);
39
+ if (parts.length > 0) text = parts.join("\n");
40
+ }
41
+ return text;
42
+ }
43
+
44
+ try {
45
+ const paneId = process.env.HERDR_PANE_ID;
46
+ if (!paneId) process.exit(0); // not in a herdr pane — nothing to bridge
47
+
48
+ const input = JSON.parse(fs.readFileSync(0, "utf-8"));
49
+ const transcriptPath = input?.transcript_path;
50
+ if (!transcriptPath || !fs.existsSync(transcriptPath)) process.exit(0);
51
+
52
+ const text = lastAssistantText(transcriptPath);
53
+ if (text == null) process.exit(0);
54
+
55
+ const dir = path.join(
56
+ os.homedir(),
57
+ ".pi",
58
+ "coms",
59
+ "claude-bridge",
60
+ paneId.replace(/[^A-Za-z0-9_-]/g, "_"),
61
+ );
62
+ fs.mkdirSync(dir, { recursive: true });
63
+ const file = path.join(dir, "last-message.json");
64
+ const tmp = `${file}.tmp-${process.pid}`;
65
+ fs.writeFileSync(
66
+ tmp,
67
+ JSON.stringify({ text, session_id: input.session_id ?? null, written_at: new Date().toISOString() }),
68
+ );
69
+ fs.renameSync(tmp, file);
70
+ } catch {
71
+ // never fail the turn
72
+ }
73
+ process.exit(0);
@@ -0,0 +1,14 @@
1
+ {
2
+ "hooks": {
3
+ "SessionStart": [
4
+ {
5
+ "hooks": [
6
+ {
7
+ "type": "command",
8
+ "command": "SCRIPT=\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\"; [ -f \"$SCRIPT\" ] || SCRIPT=\"${CLAUDE_PROJECT_DIR}/.claude/hooks/session-start.sh\"; [ -f \"$SCRIPT\" ]&& bash \"$SCRIPT\" || true"
9
+ }
10
+ ]
11
+ }
12
+ ]
13
+ }
14
+ }
@@ -0,0 +1,74 @@
1
+ #!/bin/bash
2
+ # agent-fleet session start hook (Claude Code).
3
+ #
4
+ # Two responsibilities:
5
+ # 1. Inject the using-agent-skills meta-skill into the session context so
6
+ # Claude can route tasks to the right skill.
7
+ # 2. Surface a one-line "update available" banner when the installed
8
+ # package is behind the published version on npm.
9
+ #
10
+ # Both are best-effort. Network errors, missing files, and missing tools
11
+ # never block session start — the hook always exits 0 and prints a valid
12
+ # JSON object on stdout.
13
+
14
+ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
15
+ PACKAGE_ROOT="$(dirname "$SCRIPT_DIR")"
16
+ SKILLS_DIR="$PACKAGE_ROOT/skills"
17
+ META_SKILL="$SKILLS_DIR/using-agent-skills/SKILL.md"
18
+ CHECK_SCRIPT="$PACKAGE_ROOT/bin/cli.js"
19
+
20
+ # ── 1. Meta-skill content ────────────────────────────────────────────────
21
+ if [ -f "$META_SKILL" ]; then
22
+ META_CONTENT=$(cat "$META_SKILL")
23
+ PRIORITY="IMPORTANT"
24
+ BASE_MESSAGE="agent-fleet loaded. Use the skill discovery flowchart to find the right skill for your task."
25
+ else
26
+ META_CONTENT=""
27
+ PRIORITY="INFO"
28
+ BASE_MESSAGE="agent-fleet: using-agent-skills meta-skill not found. Skills may still be available individually."
29
+ fi
30
+
31
+ # ── 2. Update banner (silent on any error) ───────────────────────────────
32
+ UPDATE_BANNER=""
33
+ if [ "$AGENT_SKILLS_NO_UPDATE_CHECK" != "1" ] \
34
+ && [ "$NO_UPDATE_NOTIFIER" != "1" ] \
35
+ && [ "$CI" != "true" ] \
36
+ && command -v node >/dev/null 2>&1 \
37
+ && [ -f "$CHECK_SCRIPT" ]; then
38
+ # Run with a 3-second wall-clock cap so a hung registry never stalls the
39
+ # session. The check-update subcommand emits the banner on stdout when an
40
+ # upgrade is available, nothing otherwise. Errors go to /dev/null.
41
+ if command -v timeout >/dev/null 2>&1; then
42
+ UPDATE_BANNER=$(timeout 3 node "$CHECK_SCRIPT" check-update 2>/dev/null || true)
43
+ else
44
+ UPDATE_BANNER=$(node "$CHECK_SCRIPT" check-update 2>/dev/null || true)
45
+ fi
46
+ fi
47
+
48
+ # ── Compose the message ──────────────────────────────────────────────────
49
+ FULL_MESSAGE="$BASE_MESSAGE"
50
+ if [ -n "$UPDATE_BANNER" ]; then
51
+ FULL_MESSAGE=$(printf '%s\n\n%s' "$FULL_MESSAGE" "$UPDATE_BANNER")
52
+ fi
53
+ if [ -n "$META_CONTENT" ]; then
54
+ FULL_MESSAGE=$(printf '%s\n\n%s' "$FULL_MESSAGE" "$META_CONTENT")
55
+ fi
56
+
57
+ # ── Emit JSON (node handles escaping correctly) ──────────────────────────
58
+ if command -v node >/dev/null 2>&1; then
59
+ printf '%s' "$FULL_MESSAGE" | node -e '
60
+ let msg = "";
61
+ process.stdin.setEncoding("utf8");
62
+ process.stdin.on("data", c => { msg += c; });
63
+ process.stdin.on("end", () => {
64
+ process.stdout.write(JSON.stringify({
65
+ priority: process.env.PRIORITY || "INFO",
66
+ message: msg,
67
+ }) + "\n");
68
+ });
69
+ '
70
+ else
71
+ # Fallback: ship just the base message with minimal escaping.
72
+ SAFE_MSG=$(printf '%s' "$BASE_MESSAGE" | sed 's/\\/\\\\/g; s/"/\\"/g')
73
+ printf '{"priority": "%s", "message": "%s"}\n' "$PRIORITY" "$SAFE_MSG"
74
+ fi
@@ -0,0 +1,302 @@
1
+ #!/bin/bash
2
+ # simplify-ignore.sh — Hook for Read (PreToolUse), Edit|Write (PostToolUse), Stop
3
+ #
4
+ # PreToolUse Read → backs up file, replaces blocks with BLOCK_<hash> in-place
5
+ # PostToolUse Edit → expands placeholders, re-filters so file stays hidden
6
+ # PostToolUse Write → expands placeholders, re-filters so file stays hidden
7
+ # Stop → restores real file content from backup
8
+ #
9
+ # The file on disk ALWAYS has placeholders while the session is active.
10
+ # The real content (with model's changes applied) lives in the backup.
11
+ #
12
+ # Dependencies: jq, shasum or sha1sum (auto-detected)
13
+
14
+ set -euo pipefail
15
+
16
+ if ! command -v jq >/dev/null 2>&1; then
17
+ printf '%s\n' "error: missing jq" >&2; exit 1
18
+ fi
19
+
20
+ CACHE="${CLAUDE_PROJECT_DIR:-.}/.claude/.simplify-ignore-cache"
21
+ if [ -t 0 ]; then INPUT="{}"; else INPUT=$(cat); fi
22
+
23
+ # Parse hook input — trap errors explicitly so set -e doesn't cause
24
+ # a silent exit on malformed JSON, and surface a useful diagnostic.
25
+ parse_error=""
26
+ TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null) || {
27
+ parse_error="failed to parse .tool_name from hook input"
28
+ TOOL_NAME=""
29
+ }
30
+ FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null) || {
31
+ parse_error="failed to parse .tool_input.file_path from hook input"
32
+ FILE_PATH=""
33
+ }
34
+ if [ -n "$parse_error" ]; then
35
+ printf 'Warning: %s (input: %.120s)\n' "$parse_error" "$INPUT" >&2
36
+ fi
37
+
38
+ hash_cmd() {
39
+ if command -v shasum >/dev/null 2>&1; then shasum
40
+ elif command -v sha1sum >/dev/null 2>&1; then sha1sum
41
+ else printf '%s\n' "error: missing shasum or sha1sum" >&2; exit 1; fi
42
+ }
43
+ file_id() { printf '%s' "$1" | hash_cmd | cut -c1-16; }
44
+ block_hash() { printf '%s' "$1" | hash_cmd | cut -c1-8; }
45
+ # Escape glob metacharacters so ${var/pattern/repl} treats pattern as literal.
46
+ # Needed for Bash 3.2 (macOS) where quotes don't suppress globbing in PE patterns.
47
+ escape_glob() {
48
+ local s="$1"
49
+ s="${s//\\/\\\\}"
50
+ s="${s//\*/\\*}"
51
+ s="${s//\?/\\?}"
52
+ s="${s//\[/\\[}"
53
+ printf '%s' "$s"
54
+ }
55
+
56
+ # ── filter_file: replace simplify-ignore blocks with BLOCK_<hash> placeholders ─
57
+ # Reads $1 (source), writes filtered version to $2 (dest), saves blocks to cache.
58
+ # Returns 0 if blocks were found, 1 if none.
59
+ filter_file() {
60
+ local src="$1" dest="$2" fid="$3"
61
+ : > "$dest"
62
+ rm -f "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
63
+
64
+ local count=0 in_block=0 buf="" reason="" prefix="" suffix=""
65
+
66
+ while IFS= read -r line || [ -n "$line" ]; do
67
+ # Check for start marker (no fork — uses bash case)
68
+ if [ $in_block -eq 0 ]; then
69
+ case "$line" in *simplify-ignore-start*)
70
+ in_block=1
71
+ buf="$line"
72
+ # Extract comment prefix/suffix to preserve language-appropriate syntax
73
+ prefix="${line%%simplify-ignore-start*}"
74
+ suffix=""
75
+ case "$line" in *'*/'*) suffix=" */" ;; *'-->'*) suffix=" -->" ;; esac
76
+ reason=$(printf '%s' "$line" | sed -n 's/.*simplify-ignore-start:[[:space:]]*//p' \
77
+ | sed 's/[[:space:]]*\*\/.*$//' | sed 's/[[:space:]]*-->.*$//' | sed 's/[[:space:]]*$//')
78
+ # Handle single-line block (start + end on same line)
79
+ case "$line" in *simplify-ignore-end*)
80
+ in_block=0
81
+ # Write single-line block immediately and skip to next line
82
+ # to avoid the end-marker check below firing again
83
+ local h; h=$(block_hash "$buf")
84
+ count=$((count + 1))
85
+ printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
86
+ [ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
87
+ printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
88
+ printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
89
+ if [ -n "$reason" ]; then
90
+ printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
91
+ else
92
+ printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
93
+ fi
94
+ buf=""; reason=""; prefix=""; suffix=""
95
+ continue
96
+ ;; *)
97
+ continue
98
+ ;;
99
+ esac
100
+ ;; esac
101
+ fi
102
+ # Accumulate block content
103
+ if [ $in_block -eq 1 ]; then
104
+ buf="${buf}
105
+ ${line}"
106
+ fi
107
+ # Check for end marker
108
+ case "$line" in *simplify-ignore-end*)
109
+ if [ $in_block -eq 1 ]; then
110
+ local h; h=$(block_hash "$buf")
111
+ count=$((count + 1))
112
+ printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
113
+ [ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
114
+ printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
115
+ printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
116
+ if [ -n "$reason" ]; then
117
+ printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
118
+ else
119
+ printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
120
+ fi
121
+ in_block=0; buf=""; reason=""; prefix=""; suffix=""
122
+ continue
123
+ fi
124
+ ;;
125
+ esac
126
+ [ $in_block -eq 0 ] && printf '%s\n' "$line" >> "$dest"
127
+ done < "$src"
128
+
129
+ # Unclosed block → flush as-is
130
+ if [ $in_block -eq 1 ] && [ -n "$buf" ]; then
131
+ printf 'Warning: unclosed simplify-ignore-start in %s (block not hidden)\n' "$src" >&2
132
+ printf '%s\n' "$buf" >> "$dest"
133
+ fi
134
+
135
+ # Preserve trailing newline status of source
136
+ if [ -s "$dest" ] && [ -s "$src" ] && [ -n "$(tail -c 1 "$src")" ]; then
137
+ perl -pe 'chomp if eof' "$dest" > "${dest}.nnl" && \
138
+ cat "${dest}.nnl" > "$dest" && rm -f "${dest}.nnl"
139
+ fi
140
+
141
+ [ $count -gt 0 ] && return 0 || return 1
142
+ }
143
+
144
+ # ── Stop: restore all files from backup ───────────────────────────────────────
145
+ if [ -z "$TOOL_NAME" ]; then
146
+ [ -d "$CACHE" ] || exit 0
147
+ for bak in "$CACHE"/*.bak; do
148
+ [ -f "$bak" ] || continue
149
+ fid="${bak##*/}"; fid="${fid%.bak}"
150
+ pathfile="$CACHE/${fid}.path"
151
+ [ -f "$pathfile" ] || { rm -f "$bak"; continue; }
152
+ orig=$(cat "$pathfile")
153
+ if [ -f "$orig" ]; then
154
+ cat "$bak" > "$orig"
155
+ rm -f "$bak" "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
156
+ rmdir "$CACHE/${fid}.lock" 2>/dev/null
157
+ else
158
+ # File was moved/deleted — save backup as .recovered, don't destroy it
159
+ mkdir -p "$(dirname "${orig}.recovered")"
160
+ mv "$bak" "${orig}.recovered"
161
+ rm -f "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
162
+ rmdir "$CACHE/${fid}.lock" 2>/dev/null
163
+ printf 'Warning: %s was moved/deleted. Recovered original to %s.recovered\n' "$orig" "$orig" >&2
164
+ fi
165
+ done
166
+ # Clean orphan locks (created but crash before backup)
167
+ for lockdir in "$CACHE"/*.lock; do
168
+ [ -d "$lockdir" ] || continue
169
+ rmdir "$lockdir" 2>/dev/null
170
+ done
171
+ exit 0
172
+ fi
173
+
174
+ [ -z "$FILE_PATH" ] && exit 0
175
+
176
+ # ── PreToolUse Read: filter in-place ──────────────────────────────────────────
177
+ if [ "$TOOL_NAME" = "Read" ]; then
178
+ [ -f "$FILE_PATH" ] || exit 0
179
+ case "$(basename "$FILE_PATH")" in simplify-ignore*|SIMPLIFY-IGNORE*) exit 0 ;; esac
180
+
181
+ mkdir -p "$CACHE"
182
+ ID=$(file_id "$FILE_PATH")
183
+
184
+ # If backup exists, file is already filtered — skip
185
+ [ -f "$CACHE/${ID}.bak" ] && exit 0
186
+
187
+ grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
188
+
189
+ # Atomic lock: mkdir fails if another session races us
190
+ if ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
191
+ # Lock exists — reclaim only if stale (>60s old, no backup = crash leftover)
192
+ if [ ! -f "$CACHE/${ID}.bak" ] && \
193
+ [ -n "$(find "$CACHE/${ID}.lock" -maxdepth 0 -mmin +1 2>/dev/null)" ]; then
194
+ rmdir "$CACHE/${ID}.lock" 2>/dev/null || true
195
+ mkdir "$CACHE/${ID}.lock" 2>/dev/null || exit 0
196
+ else
197
+ exit 0
198
+ fi
199
+ fi
200
+
201
+ # Back up the original (preserve trailing newline status)
202
+ cp -p "$FILE_PATH" "$CACHE/${ID}.bak" 2>/dev/null || cp "$FILE_PATH" "$CACHE/${ID}.bak"
203
+ printf '%s' "$FILE_PATH" > "$CACHE/${ID}.path"
204
+
205
+ # Filter in-place (cat > preserves inode and permissions)
206
+ FILTERED="$CACHE/${ID}.$$.tmp"
207
+ rm -f "$FILTERED"
208
+ if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
209
+ cat "$FILTERED" > "$FILE_PATH"
210
+ rm -f "$FILTERED"
211
+ else
212
+ rm -f "$FILTERED" "$CACHE/${ID}.bak" "$CACHE/${ID}.path"
213
+ rmdir "$CACHE/${ID}.lock" 2>/dev/null
214
+ fi
215
+ exit 0
216
+ fi
217
+
218
+ # ── PostToolUse Edit|Write: expand, then re-filter ────────────────────────────
219
+ if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "Write" ]; then
220
+ ID=$(file_id "$FILE_PATH")
221
+ [ -f "$CACHE/${ID}.bak" ] || exit 0
222
+ ls "$CACHE/${ID}".block.* >/dev/null 2>&1 || exit 0
223
+
224
+ # Expand placeholders, preserving any inline code the model added around them
225
+ EXPANDED="$CACHE/${ID}.$$.expanded"
226
+ rm -f "$EXPANDED"
227
+ while IFS= read -r line || [ -n "$line" ]; do
228
+ case "$line" in *BLOCK_*)
229
+ # Expand all placeholders on this line (supports multiple per line)
230
+ for bf in "$CACHE/${ID}".block.*; do
231
+ [ -f "$bf" ] || continue
232
+ h="${bf##*.}"
233
+ case "$line" in *"BLOCK_${h}"*)
234
+ # Reconstruct the exact placeholder pattern
235
+ bp=""; bs=""; br=""
236
+ [ -f "$CACHE/${ID}.prefix.${h}" ] && bp=$(cat "$CACHE/${ID}.prefix.${h}")
237
+ [ -f "$CACHE/${ID}.suffix.${h}" ] && bs=$(cat "$CACHE/${ID}.suffix.${h}")
238
+ [ -f "$CACHE/${ID}.reason.${h}" ] && br=$(cat "$CACHE/${ID}.reason.${h}")
239
+ if [ -n "$br" ]; then
240
+ placeholder="${bp}BLOCK_${h}: ${br}${bs}"
241
+ else
242
+ placeholder="${bp}BLOCK_${h}${bs}"
243
+ fi
244
+ block_content=$(cat "$bf"; printf x); block_content="${block_content%x}"
245
+ # Escape glob metacharacters (* ? [ \) in the pattern
246
+ esc_placeholder=$(escape_glob "$placeholder")
247
+ # Bash native substitution (// = global replace): replace placeholder, keep surrounding code
248
+ line="${line//$esc_placeholder/$block_content}"
249
+ # Fallback: if model altered the reason text, try without reason
250
+ # (only trigger if BLOCK_hash is still present AND wasn't in the original block content)
251
+ case "$block_content" in *"BLOCK_${h}"*) ;; *)
252
+ case "$line" in *"BLOCK_${h}"*)
253
+ printf 'Warning: placeholder BLOCK_%s was modified by model, using fuzzy match\n' "$h" >&2
254
+ esc_fuzzy=$(escape_glob "${bp}BLOCK_${h}${bs}")
255
+ line="${line//$esc_fuzzy/$block_content}"
256
+ # Last resort: match just the hash token
257
+ case "$line" in *"BLOCK_${h}"*)
258
+ line="${line//BLOCK_${h}/$block_content}"
259
+ ;; esac
260
+ ;; esac
261
+ ;; esac
262
+ ;; esac
263
+ done
264
+ ;; esac
265
+ printf '%s\n' "$line" >> "$EXPANDED"
266
+ done < "$FILE_PATH"
267
+ # Preserve trailing newline status
268
+ if [ -s "$EXPANDED" ] && [ -s "$FILE_PATH" ] && [ -n "$(tail -c 1 "$FILE_PATH")" ]; then
269
+ perl -pe 'chomp if eof' "$EXPANDED" > "${EXPANDED}.nnl" && \
270
+ cat "${EXPANDED}.nnl" > "$EXPANDED" && rm -f "${EXPANDED}.nnl"
271
+ fi
272
+ # Warn if model deleted a protected block entirely
273
+ for bf in "$CACHE/${ID}".block.*; do
274
+ [ -f "$bf" ] || continue
275
+ bh="${bf##*.}"
276
+ # After expansion, blocks appear as original code (simplify-ignore-start).
277
+ # If neither the expanded code nor the placeholder is in EXPANDED, it was deleted.
278
+ if ! grep -qF "BLOCK_${bh}" "$EXPANDED" 2>/dev/null; then
279
+ # Get first line of block to check if it was expanded back
280
+ first_line=$(head -1 "$bf")
281
+ if ! grep -qF "$first_line" "$EXPANDED" 2>/dev/null; then
282
+ printf 'Warning: protected block BLOCK_%s was deleted by model\n' "$bh" >&2
283
+ fi
284
+ fi
285
+ done
286
+ # Preserve inode and permissions
287
+ cat "$EXPANDED" > "$FILE_PATH"
288
+ rm -f "$EXPANDED"
289
+
290
+ # Save expanded version as new backup (this is the "real" file with model's changes)
291
+ cp "$FILE_PATH" "$CACHE/${ID}.bak"
292
+
293
+ # Re-filter in-place so the file on disk stays with placeholders
294
+ FILTERED="$CACHE/${ID}.$$.tmp"
295
+ rm -f "$FILTERED"
296
+ if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
297
+ cat "$FILTERED" > "$FILE_PATH"
298
+ rm -f "$FILTERED"
299
+ fi
300
+
301
+ exit 0
302
+ fi