@thebattlearena/battle-arena-hooks 0.5.3-beta.55 → 0.8.0

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 (362) hide show
  1. package/README.md +6 -448
  2. package/cli.mjs +27 -281
  3. package/package.json +2 -24
  4. package/.claude-plugin/marketplace.json +0 -18
  5. package/check-connection.mjs +0 -64
  6. package/emit.mjs +0 -100
  7. package/execution-coach-nudge.mjs +0 -247
  8. package/fonts/battle-arena-icons/BattleArenaIcons.ttf +0 -0
  9. package/fonts/battle-arena-icons/LICENSE-lucide.txt +0 -39
  10. package/lib/battle-order/battle-arena-logo.png +0 -0
  11. package/lib/battle-order/html.mjs +0 -403
  12. package/lib/battle-order/pdf.mjs +0 -122
  13. package/lib/battle-order/styles.mjs +0 -158
  14. package/lib/drain.mjs +0 -49
  15. package/lib/git-diff.mjs +0 -63
  16. package/lib/icon-font.mjs +0 -125
  17. package/lib/identity.mjs +0 -55
  18. package/lib/local-activity.mjs +0 -217
  19. package/lib/objective-api.mjs +0 -152
  20. package/lib/objective-guidance.mjs +0 -103
  21. package/lib/objective-name.mjs +0 -25
  22. package/lib/plugin-install.mjs +0 -172
  23. package/lib/radio-install.mjs +0 -70
  24. package/lib/reauth.mjs +0 -30
  25. package/lib/sanitize.mjs +0 -81
  26. package/lib/secret-patterns.mjs +0 -90
  27. package/lib/state.mjs +0 -63
  28. package/lib/synthetic-prompt.mjs +0 -26
  29. package/lib/transport.mjs +0 -168
  30. package/lib/work-signals.mjs +0 -124
  31. package/objective-nudge.mjs +0 -223
  32. package/objective.mjs +0 -170
  33. package/plan.mjs +0 -89
  34. package/plugin/.claude-plugin/plugin.json +0 -7
  35. package/plugin/hooks/api.ts +0 -180
  36. package/plugin/hooks/close-pane.tsx +0 -203
  37. package/plugin/hooks/close.ts +0 -198
  38. package/plugin/hooks/colors.ts +0 -18
  39. package/plugin/hooks/complements.ts +0 -61
  40. package/plugin/hooks/format.ts +0 -303
  41. package/plugin/hooks/hooks.json +0 -111
  42. package/plugin/hooks/icon-files.ts +0 -35
  43. package/plugin/hooks/icons-diag.tsx +0 -155
  44. package/plugin/hooks/icons.generated.ts +0 -104
  45. package/plugin/hooks/icons.ts +0 -161
  46. package/plugin/hooks/label-links.tsx +0 -55
  47. package/plugin/hooks/meetings.ts +0 -36
  48. package/plugin/hooks/pane-view.ts +0 -12
  49. package/plugin/hooks/pane.tsx +0 -1156
  50. package/plugin/hooks/radio-format.ts +0 -153
  51. package/plugin/hooks/radio-pane.tsx +0 -310
  52. package/plugin/hooks/radio-player.ts +0 -184
  53. package/plugin/hooks/radio-queue.ts +0 -41
  54. package/plugin/hooks/radio.ts +0 -137
  55. package/plugin/hooks/register.tsx +0 -544
  56. package/plugin/hooks/ring-io.ts +0 -248
  57. package/plugin/hooks/ring-pane.tsx +0 -733
  58. package/plugin/hooks/ring.ts +0 -505
  59. package/plugin/hooks/terminal-caps.ts +0 -31
  60. package/plugin/icons/activo-grey-2x1.png +0 -0
  61. package/plugin/icons/activo-grey-4x2.png +0 -0
  62. package/plugin/icons/activo-grey-5x2.png +0 -0
  63. package/plugin/icons/activo-grey-6x2.png +0 -0
  64. package/plugin/icons/arbitro-amber-2x1.png +0 -0
  65. package/plugin/icons/arbitro-amber-4x2.png +0 -0
  66. package/plugin/icons/arbitro-amber-5x2.png +0 -0
  67. package/plugin/icons/arbitro-amber-6x2.png +0 -0
  68. package/plugin/icons/arbitro-grey-2x1.png +0 -0
  69. package/plugin/icons/arbitro-grey-4x2.png +0 -0
  70. package/plugin/icons/arbitro-grey-5x2.png +0 -0
  71. package/plugin/icons/arbitro-grey-6x2.png +0 -0
  72. package/plugin/icons/arbitro-red-2x1.png +0 -0
  73. package/plugin/icons/arbitro-red-4x2.png +0 -0
  74. package/plugin/icons/arbitro-red-5x2.png +0 -0
  75. package/plugin/icons/arbitro-red-6x2.png +0 -0
  76. package/plugin/icons/arbitro-slate-2x1.png +0 -0
  77. package/plugin/icons/arbitro-slate-4x2.png +0 -0
  78. package/plugin/icons/arbitro-slate-5x2.png +0 -0
  79. package/plugin/icons/arbitro-slate-6x2.png +0 -0
  80. package/plugin/icons/arbitro-slate-dim-2x1.png +0 -0
  81. package/plugin/icons/arbitro-slate-dim-4x2.png +0 -0
  82. package/plugin/icons/arbitro-slate-dim-5x2.png +0 -0
  83. package/plugin/icons/arbitro-slate-dim-6x2.png +0 -0
  84. package/plugin/icons/arena-grey-2x1.png +0 -0
  85. package/plugin/icons/arena-grey-4x2.png +0 -0
  86. package/plugin/icons/arena-grey-5x2.png +0 -0
  87. package/plugin/icons/arena-grey-6x2.png +0 -0
  88. package/plugin/icons/bateria-grey-2x1.png +0 -0
  89. package/plugin/icons/bateria-grey-4x2.png +0 -0
  90. package/plugin/icons/bateria-grey-5x2.png +0 -0
  91. package/plugin/icons/bateria-grey-6x2.png +0 -0
  92. package/plugin/icons/campana-amber-2x1.png +0 -0
  93. package/plugin/icons/campana-amber-4x2.png +0 -0
  94. package/plugin/icons/campana-amber-5x2.png +0 -0
  95. package/plugin/icons/campana-amber-6x2.png +0 -0
  96. package/plugin/icons/campana-amber-dim-2x1.png +0 -0
  97. package/plugin/icons/campana-amber-dim-4x2.png +0 -0
  98. package/plugin/icons/campana-amber-dim-5x2.png +0 -0
  99. package/plugin/icons/campana-amber-dim-6x2.png +0 -0
  100. package/plugin/icons/campana-grey-2x1.png +0 -0
  101. package/plugin/icons/campana-grey-4x2.png +0 -0
  102. package/plugin/icons/campana-grey-5x2.png +0 -0
  103. package/plugin/icons/campana-grey-6x2.png +0 -0
  104. package/plugin/icons/campana-red-2x1.png +0 -0
  105. package/plugin/icons/campana-red-4x2.png +0 -0
  106. package/plugin/icons/campana-red-5x2.png +0 -0
  107. package/plugin/icons/campana-red-6x2.png +0 -0
  108. package/plugin/icons/copilot-amber-2x1.png +0 -0
  109. package/plugin/icons/copilot-amber-4x2.png +0 -0
  110. package/plugin/icons/copilot-amber-5x2.png +0 -0
  111. package/plugin/icons/copilot-amber-6x2.png +0 -0
  112. package/plugin/icons/copilot-grey-2x1.png +0 -0
  113. package/plugin/icons/copilot-grey-4x2.png +0 -0
  114. package/plugin/icons/copilot-grey-5x2.png +0 -0
  115. package/plugin/icons/copilot-grey-6x2.png +0 -0
  116. package/plugin/icons/copilot-purple-2x1.png +0 -0
  117. package/plugin/icons/copilot-purple-4x2.png +0 -0
  118. package/plugin/icons/copilot-purple-5x2.png +0 -0
  119. package/plugin/icons/copilot-purple-6x2.png +0 -0
  120. package/plugin/icons/copilot-purple-dim-2x1.png +0 -0
  121. package/plugin/icons/copilot-purple-dim-4x2.png +0 -0
  122. package/plugin/icons/copilot-purple-dim-5x2.png +0 -0
  123. package/plugin/icons/copilot-purple-dim-6x2.png +0 -0
  124. package/plugin/icons/copilot-red-2x1.png +0 -0
  125. package/plugin/icons/copilot-red-4x2.png +0 -0
  126. package/plugin/icons/copilot-red-5x2.png +0 -0
  127. package/plugin/icons/copilot-red-6x2.png +0 -0
  128. package/plugin/icons/cronica-grey-2x1.png +0 -0
  129. package/plugin/icons/cronica-grey-4x2.png +0 -0
  130. package/plugin/icons/cronica-grey-5x2.png +0 -0
  131. package/plugin/icons/cronica-grey-6x2.png +0 -0
  132. package/plugin/icons/emergente-grey-2x1.png +0 -0
  133. package/plugin/icons/emergente-grey-4x2.png +0 -0
  134. package/plugin/icons/emergente-grey-5x2.png +0 -0
  135. package/plugin/icons/emergente-grey-6x2.png +0 -0
  136. package/plugin/icons/en-la-esquina-grey-2x1.png +0 -0
  137. package/plugin/icons/en-la-esquina-grey-4x2.png +0 -0
  138. package/plugin/icons/en-la-esquina-grey-5x2.png +0 -0
  139. package/plugin/icons/en-la-esquina-grey-6x2.png +0 -0
  140. package/plugin/icons/espera-grey-2x1.png +0 -0
  141. package/plugin/icons/espera-grey-4x2.png +0 -0
  142. package/plugin/icons/espera-grey-5x2.png +0 -0
  143. package/plugin/icons/espera-grey-6x2.png +0 -0
  144. package/plugin/icons/esquinero-amber-2x1.png +0 -0
  145. package/plugin/icons/esquinero-amber-4x2.png +0 -0
  146. package/plugin/icons/esquinero-amber-5x2.png +0 -0
  147. package/plugin/icons/esquinero-amber-6x2.png +0 -0
  148. package/plugin/icons/esquinero-grey-2x1.png +0 -0
  149. package/plugin/icons/esquinero-grey-4x2.png +0 -0
  150. package/plugin/icons/esquinero-grey-5x2.png +0 -0
  151. package/plugin/icons/esquinero-grey-6x2.png +0 -0
  152. package/plugin/icons/esquinero-red-2x1.png +0 -0
  153. package/plugin/icons/esquinero-red-4x2.png +0 -0
  154. package/plugin/icons/esquinero-red-5x2.png +0 -0
  155. package/plugin/icons/esquinero-red-6x2.png +0 -0
  156. package/plugin/icons/esquinero-teal-2x1.png +0 -0
  157. package/plugin/icons/esquinero-teal-4x2.png +0 -0
  158. package/plugin/icons/esquinero-teal-5x2.png +0 -0
  159. package/plugin/icons/esquinero-teal-6x2.png +0 -0
  160. package/plugin/icons/esquinero-teal-dim-2x1.png +0 -0
  161. package/plugin/icons/esquinero-teal-dim-4x2.png +0 -0
  162. package/plugin/icons/esquinero-teal-dim-5x2.png +0 -0
  163. package/plugin/icons/esquinero-teal-dim-6x2.png +0 -0
  164. package/plugin/icons/fallo-grey-2x1.png +0 -0
  165. package/plugin/icons/fallo-grey-4x2.png +0 -0
  166. package/plugin/icons/fallo-grey-5x2.png +0 -0
  167. package/plugin/icons/fallo-grey-6x2.png +0 -0
  168. package/plugin/icons/finalizando-grey-2x1.png +0 -0
  169. package/plugin/icons/finalizando-grey-4x2.png +0 -0
  170. package/plugin/icons/finalizando-grey-5x2.png +0 -0
  171. package/plugin/icons/finalizando-grey-6x2.png +0 -0
  172. package/plugin/icons/fuego-grey-2x1.png +0 -0
  173. package/plugin/icons/fuego-grey-4x2.png +0 -0
  174. package/plugin/icons/fuego-grey-5x2.png +0 -0
  175. package/plugin/icons/fuego-grey-6x2.png +0 -0
  176. package/plugin/icons/golpe-grey-2x1.png +0 -0
  177. package/plugin/icons/golpe-grey-4x2.png +0 -0
  178. package/plugin/icons/golpe-grey-5x2.png +0 -0
  179. package/plugin/icons/golpe-grey-6x2.png +0 -0
  180. package/plugin/icons/juez-amber-2x1.png +0 -0
  181. package/plugin/icons/juez-amber-4x2.png +0 -0
  182. package/plugin/icons/juez-amber-5x2.png +0 -0
  183. package/plugin/icons/juez-amber-6x2.png +0 -0
  184. package/plugin/icons/juez-grey-2x1.png +0 -0
  185. package/plugin/icons/juez-grey-4x2.png +0 -0
  186. package/plugin/icons/juez-grey-5x2.png +0 -0
  187. package/plugin/icons/juez-grey-6x2.png +0 -0
  188. package/plugin/icons/juez-orange-2x1.png +0 -0
  189. package/plugin/icons/juez-orange-4x2.png +0 -0
  190. package/plugin/icons/juez-orange-5x2.png +0 -0
  191. package/plugin/icons/juez-orange-6x2.png +0 -0
  192. package/plugin/icons/juez-orange-dim-2x1.png +0 -0
  193. package/plugin/icons/juez-orange-dim-4x2.png +0 -0
  194. package/plugin/icons/juez-orange-dim-5x2.png +0 -0
  195. package/plugin/icons/juez-orange-dim-6x2.png +0 -0
  196. package/plugin/icons/juez-red-2x1.png +0 -0
  197. package/plugin/icons/juez-red-4x2.png +0 -0
  198. package/plugin/icons/juez-red-5x2.png +0 -0
  199. package/plugin/icons/juez-red-6x2.png +0 -0
  200. package/plugin/icons/listo-grey-2x1.png +0 -0
  201. package/plugin/icons/listo-grey-4x2.png +0 -0
  202. package/plugin/icons/listo-grey-5x2.png +0 -0
  203. package/plugin/icons/listo-grey-6x2.png +0 -0
  204. package/plugin/icons/luchador-amber-2x1.png +0 -0
  205. package/plugin/icons/luchador-amber-4x2.png +0 -0
  206. package/plugin/icons/luchador-amber-5x2.png +0 -0
  207. package/plugin/icons/luchador-amber-6x2.png +0 -0
  208. package/plugin/icons/luchador-blue-2x1.png +0 -0
  209. package/plugin/icons/luchador-blue-4x2.png +0 -0
  210. package/plugin/icons/luchador-blue-5x2.png +0 -0
  211. package/plugin/icons/luchador-blue-6x2.png +0 -0
  212. package/plugin/icons/luchador-blue-dim-2x1.png +0 -0
  213. package/plugin/icons/luchador-blue-dim-4x2.png +0 -0
  214. package/plugin/icons/luchador-blue-dim-5x2.png +0 -0
  215. package/plugin/icons/luchador-blue-dim-6x2.png +0 -0
  216. package/plugin/icons/luchador-grey-2x1.png +0 -0
  217. package/plugin/icons/luchador-grey-4x2.png +0 -0
  218. package/plugin/icons/luchador-grey-5x2.png +0 -0
  219. package/plugin/icons/luchador-grey-6x2.png +0 -0
  220. package/plugin/icons/luchador-red-2x1.png +0 -0
  221. package/plugin/icons/luchador-red-4x2.png +0 -0
  222. package/plugin/icons/luchador-red-5x2.png +0 -0
  223. package/plugin/icons/luchador-red-6x2.png +0 -0
  224. package/plugin/icons/modificando-grey-2x1.png +0 -0
  225. package/plugin/icons/modificando-grey-4x2.png +0 -0
  226. package/plugin/icons/modificando-grey-5x2.png +0 -0
  227. package/plugin/icons/modificando-grey-6x2.png +0 -0
  228. package/plugin/icons/monitor-grey-2x1.png +0 -0
  229. package/plugin/icons/monitor-grey-4x2.png +0 -0
  230. package/plugin/icons/monitor-grey-5x2.png +0 -0
  231. package/plugin/icons/monitor-grey-6x2.png +0 -0
  232. package/plugin/icons/objetivo-grey-2x1.png +0 -0
  233. package/plugin/icons/objetivo-grey-4x2.png +0 -0
  234. package/plugin/icons/objetivo-grey-5x2.png +0 -0
  235. package/plugin/icons/objetivo-grey-6x2.png +0 -0
  236. package/plugin/icons/pensando-grey-2x1.png +0 -0
  237. package/plugin/icons/pensando-grey-4x2.png +0 -0
  238. package/plugin/icons/pensando-grey-5x2.png +0 -0
  239. package/plugin/icons/pensando-grey-6x2.png +0 -0
  240. package/plugin/icons/plan-grey-2x1.png +0 -0
  241. package/plugin/icons/plan-grey-4x2.png +0 -0
  242. package/plugin/icons/plan-grey-5x2.png +0 -0
  243. package/plugin/icons/plan-grey-6x2.png +0 -0
  244. package/plugin/icons/pr-grey-2x1.png +0 -0
  245. package/plugin/icons/pr-grey-4x2.png +0 -0
  246. package/plugin/icons/pr-grey-5x2.png +0 -0
  247. package/plugin/icons/pr-grey-6x2.png +0 -0
  248. package/plugin/icons/probando-grey-2x1.png +0 -0
  249. package/plugin/icons/probando-grey-4x2.png +0 -0
  250. package/plugin/icons/probando-grey-5x2.png +0 -0
  251. package/plugin/icons/probando-grey-6x2.png +0 -0
  252. package/plugin/icons/punto-grey-2x1.png +0 -0
  253. package/plugin/icons/punto-grey-4x2.png +0 -0
  254. package/plugin/icons/punto-grey-5x2.png +0 -0
  255. package/plugin/icons/punto-grey-6x2.png +0 -0
  256. package/plugin/icons/rama-grey-2x1.png +0 -0
  257. package/plugin/icons/rama-grey-4x2.png +0 -0
  258. package/plugin/icons/rama-grey-5x2.png +0 -0
  259. package/plugin/icons/rama-grey-6x2.png +0 -0
  260. package/plugin/icons/reunion-grey-2x1.png +0 -0
  261. package/plugin/icons/reunion-grey-4x2.png +0 -0
  262. package/plugin/icons/reunion-grey-5x2.png +0 -0
  263. package/plugin/icons/reunion-grey-6x2.png +0 -0
  264. package/plugin/icons/revisando-grey-2x1.png +0 -0
  265. package/plugin/icons/revisando-grey-4x2.png +0 -0
  266. package/plugin/icons/revisando-grey-5x2.png +0 -0
  267. package/plugin/icons/revisando-grey-6x2.png +0 -0
  268. package/plugin/icons/riesgo-grey-2x1.png +0 -0
  269. package/plugin/icons/riesgo-grey-4x2.png +0 -0
  270. package/plugin/icons/riesgo-grey-5x2.png +0 -0
  271. package/plugin/icons/riesgo-grey-6x2.png +0 -0
  272. package/plugin/icons/ronda-grey-2x1.png +0 -0
  273. package/plugin/icons/ronda-grey-4x2.png +0 -0
  274. package/plugin/icons/ronda-grey-5x2.png +0 -0
  275. package/plugin/icons/ronda-grey-6x2.png +0 -0
  276. package/plugin/icons/subiendo-grey-2x1.png +0 -0
  277. package/plugin/icons/subiendo-grey-4x2.png +0 -0
  278. package/plugin/icons/subiendo-grey-5x2.png +0 -0
  279. package/plugin/icons/subiendo-grey-6x2.png +0 -0
  280. package/plugin/icons/te-toca-grey-2x1.png +0 -0
  281. package/plugin/icons/te-toca-grey-4x2.png +0 -0
  282. package/plugin/icons/te-toca-grey-5x2.png +0 -0
  283. package/plugin/icons/te-toca-grey-6x2.png +0 -0
  284. package/plugin/icons/ticket-grey-2x1.png +0 -0
  285. package/plugin/icons/ticket-grey-4x2.png +0 -0
  286. package/plugin/icons/ticket-grey-5x2.png +0 -0
  287. package/plugin/icons/ticket-grey-6x2.png +0 -0
  288. package/plugin/icons/tiempo-grey-2x1.png +0 -0
  289. package/plugin/icons/tiempo-grey-4x2.png +0 -0
  290. package/plugin/icons/tiempo-grey-5x2.png +0 -0
  291. package/plugin/icons/tiempo-grey-6x2.png +0 -0
  292. package/plugin/icons/trofeo-grey-2x1.png +0 -0
  293. package/plugin/icons/trofeo-grey-4x2.png +0 -0
  294. package/plugin/icons/trofeo-grey-5x2.png +0 -0
  295. package/plugin/icons/trofeo-grey-6x2.png +0 -0
  296. package/plugin/skills/arena-objective/SKILL.md +0 -103
  297. package/plugin/skills/arena-self-review/SKILL.md +0 -217
  298. package/plugin/skills/arena-self-review/assets/fonts.css +0 -60
  299. package/plugin/skills/arena-self-review/assets/leracom-logo.png +0 -0
  300. package/plugin/skills/arena-self-review/assets/report.css +0 -134
  301. package/plugin/skills/arena-self-review/assets/style.css +0 -144
  302. package/plugin/skills/arena-self-review/scripts/gen-fonts.mjs +0 -56
  303. package/plugin/skills/arena-self-review/scripts/generate-pdf.sh +0 -162
  304. package/plugin/skills/arena-self-review/scripts/render-report.sh +0 -67
  305. package/plugin/skills/conquer/SKILL.md +0 -310
  306. package/plugin/skills/execution-coach/SKILL.md +0 -92
  307. package/plugin/skills/pr-review-loop/SKILL.md +0 -96
  308. package/plugin/skills/scope-technical-task/SKILL.md +0 -652
  309. package/plugin/tests/close.test.ts +0 -181
  310. package/plugin/tests/complements.test.ts +0 -82
  311. package/plugin/tests/format.test.ts +0 -206
  312. package/plugin/tests/meetings.test.ts +0 -56
  313. package/plugin/tests/radio.test.tsx +0 -670
  314. package/plugin/tests/ring-pane.test.tsx +0 -1297
  315. package/plugin/tests/ring.test.ts +0 -454
  316. package/plugin/tests/scorecard.test.tsx +0 -549
  317. package/plugin/tests/support/ghostty-baseline-radio.ts +0 -6
  318. package/plugin/tests/support/ghostty-baseline.ts +0 -8
  319. package/plugin/tests/support/text.ts +0 -301
  320. package/plugin/types/index.d.ts +0 -348
  321. package/pr-review-worktree.mjs +0 -56
  322. package/radio/package.json +0 -13
  323. package/radio/player.mjs +0 -214
  324. package/ring/.claude-plugin/plugin.json +0 -8
  325. package/ring/agents/cornerman.md +0 -79
  326. package/ring/agents/wrestler.md +0 -116
  327. package/ring/hooks/hooks.json +0 -82
  328. package/ring/scripts/chronicle.mjs +0 -433
  329. package/ring/scripts/config.mjs +0 -675
  330. package/ring/scripts/contract-preview.mjs +0 -299
  331. package/ring/scripts/contract.mjs +0 -156
  332. package/ring/scripts/copilot-review.mjs +0 -148
  333. package/ring/scripts/judges-card.mjs +0 -383
  334. package/ring/scripts/live-hook.mjs +0 -258
  335. package/ring/scripts/live.mjs +0 -417
  336. package/ring/scripts/lookout.mjs +0 -131
  337. package/ring/scripts/mask-guard.mjs +0 -1392
  338. package/ring/scripts/monitors.mjs +0 -141
  339. package/ring/scripts/one-at-a-time.mjs +0 -275
  340. package/ring/scripts/play-by-play.mjs +0 -254
  341. package/ring/scripts/round-bell.mjs +0 -347
  342. package/ring/scripts/spec-diff.mjs +0 -208
  343. package/ring/scripts/title-defense.mjs +0 -401
  344. package/ring/skills/no-surrender/SKILL.md +0 -63
  345. package/ring/skills/play-by-play/SKILL.md +0 -83
  346. package/ring/skills/play-by-play/templates/chronicle.html +0 -134
  347. package/ring/skills/referee/SKILL.md +0 -313
  348. package/ring/skills/referee/references/precedents.md +0 -105
  349. package/ring/skills/referee/references/rulebook.md +0 -230
  350. package/ring/skills/referee/templates/cornerman-batch.md +0 -15
  351. package/ring/skills/referee/templates/cornerman-concept.md +0 -37
  352. package/ring/skills/referee/templates/cornerman-range.md +0 -14
  353. package/ring/skills/referee/templates/escalation.md +0 -20
  354. package/ring/skills/referee/templates/judges-card.md +0 -46
  355. package/ring/skills/referee/templates/no-surrender-goal.md +0 -17
  356. package/ring/skills/referee/templates/rebound.md +0 -22
  357. package/ring/skills/referee/templates/round-bell-body.md +0 -26
  358. package/ring/skills/referee/templates/title-defense-catalogue.md +0 -37
  359. package/ring/skills/referee/templates/wrestler-brief.md +0 -54
  360. package/ring/skills/title-defense/SKILL.md +0 -142
  361. package/ring/skills/weigh-in/SKILL.md +0 -159
  362. package/session-start.mjs +0 -129
package/README.md CHANGED
@@ -1,453 +1,11 @@
1
- # Battle Arena en Claude Code (plugin `battlearena`)
1
+ # @thebattlearena/battle-arena-hooks → Corner
2
2
 
3
- Este paquete instala **Battle Arena en Claude Code** como un solo plugin, `battlearena`: los hooks que
4
- mandan tus sesiones al colector (`apps/public-api`), las skills del equipo y el **Scorecard** de tu día
5
- junto al chat. Las skills quedan con el espacio de nombres del plugin (`/battlearena:conquer`), así no
6
- chocan con las de otros plugins y en el autocompletado salen todas juntas al escribir `/battlearena`.
3
+ Este paquete ahora se llama **Corner**: [`@thebattlearena/corner`](https://www.npmjs.com/package/@thebattlearena/corner).
7
4
 
8
5
  ```bash
9
- npx @thebattlearena/battle-arena-hooks@latest install \
10
- --url https://api.battlearena.dev --api-key <tu-llave>
6
+ npx @thebattlearena/corner@latest migrate
11
7
  ```
12
8
 
13
- La llave se genera en [battlearena.dev/api-keys](https://battlearena.dev/api-keys). Para quitarlo:
14
- `npx @thebattlearena/battle-arena-hooks uninstall`.
15
-
16
- ## Qué trae el plugin
17
-
18
- ### Skills
19
-
20
- Se invocan escribiendo el comando o pidiéndolo con tus palabras («arma mi plan de mañana»).
21
-
22
- | Skill | Para qué sirve |
23
- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
24
- | `/battlearena:conquer` | Arma o actualiza tu **plan de batalla** del siguiente día hábil (o el de **hoy**, si aún no tienes: antes de las 16:00 te pregunta cuál): revisa lo que hiciste hoy (git, tus sesiones de Claude, tus pendientes), te entrevista tema por tema (valor de negocio, DoD, ≤ 3 h, riesgos) y crea tu ticket del día (el de mañana, desde las 16:00 de la víspera) en Linear y tu orden de batalla en PDF. |
25
- | `/battlearena:arena-objective` | Nombra un **objetivo nuevo** cuando cambias de tema, para que tu actividad se agrupe por objetivo; continuar el vigente lo hace el hook en cada turno, que también lo liga con tu plan del día. Si el colector duda, Claude te pregunta **una vez** «¿es parte del punto N o es emergente?» (`objective.mjs link`). No hace falta llamarla. |
26
- | `/battlearena:arena-self-review` | Tu **revisión semanal de desempeño**, self-service: lee tu actividad de la semana desde el MCP de Battle Arena y te da una autocrítica con evidencia. |
27
- | `/battlearena:execution-coach` | **Interceptor mayéutico** durante la ejecución: te frena con preguntas cuando el pedido es vago o la sesión da vueltas sin converger. Se activa sola cuando el hook detecta esas señales. |
28
- | `/battlearena:scope-technical-task` | **Coach de alcance antes de codear**: problema de negocio, sub-problemas, soluciones sin código, estimación en horas. |
29
- | `/battlearena:pr-review-loop` | Atiende la **review de Copilot** de un PR en segundo plano (corrige → gates → commit → resolver hilos → re-review). Siempre opt-in: pregunta antes y cuántas iteraciones tolera. |
30
-
31
- ### Comandos
32
-
33
- | Comando | Para qué sirve |
34
- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
35
- | `/scorecard` | Abre el **Scorecard**: la pelea de tu día junto al chat. Tu plan con el avance y el tiempo de cada punto contra lo comprometido (semáforo verde · amarillo · rojo), los emergentes (clic para ver su motivo), los riesgos siempre visibles con ✋ Levantar la mano y 👍/👎, y el pie con Plan · Reuniones · Fuera · Total. Pestaña **Semana** con tus hábitos. Sin datos, te dice el **siguiente paso** (instalar, armar el plan, entrar a la daily). |
36
-
37
- Arriba del prompt sale además una **banda** compacta del Scorecard (`LER-640 ✓ 1 ↻ 1 ↷ 1 ⚠ 1 Abrir`, cada contador con su color).
38
-
39
- **Modo cierre (ADR-0036 §17).** Desde las 16:00 (CDMX) el día del consultor ya cerró: hasta las 9:00
40
- del siguiente día hábil (el fin de semana, con el cierre del viernes) el panel es el **resultado del
41
- día** en vez de un día nuevo en 0m. Lleva el marcador navy (minutos en tu plan contra fuera de plan y
42
- la barra plan / fuera / reuniones), cómo terminó cada punto (avanzado, «pasó de Xh», «sin tocar»,
43
- entregado ✓; 📅 si tuvo reunión ligada), cuántos emergentes justificaste con «Abrir chat ↗» para los
44
- que faltan y el siguiente paso, `/battlearena:conquer` para el plan del siguiente día. Lo trabajado
45
- después del corte no resta: sale aparte («ya llevas 25m para el viernes»). En cuanto guardas el plan
46
- del siguiente día, el panel vuelve a la vista normal de ese día. Al corte sale un aviso una vez por
47
- día («Tu jueves cerró · 6h32 en plan · 2 emergentes sin responder») y la banda dice el cierre con
48
- `✎ N` por responder. En modo cierre se relee cada 5 min. La pestaña **Semana** muestra el último
49
- cierre con su resultado.
50
-
51
- ### La radio (Arena FM) en el Scorecard — opcional
52
-
53
- La rocola de la Oficina dentro del Scorecard. Se instala aparte, porque es lo único que trae una
54
- dependencia (`@livekit/rtc-node`) y necesita `ffplay` (de ffmpeg: `brew install ffmpeg`):
55
-
56
- ```bash
57
- npx @thebattlearena/battle-arena-hooks@latest install --with radio
58
- ```
59
-
60
- Reusa la url y la llave de `~/.claude/battle-arena/config.json` (no hay que pasarlas otra vez) y deja
61
- anotado `"with": ["radio"]` ahí mismo: una reinstalación o actualización sin el flag **no** quita la
62
- radio. El reproductor (`radio/player.mjs` + su `package.json`) va a `~/.claude/battle-arena/hooks/radio/`
63
- y `npm install` baja su dependencia SOLO en esa carpeta; los hooks `.mjs` siguen sin dependencias.
64
-
65
- - **Fila bajo las pestañas** (Hoy y Semana): `♪ título · artista` truncado y ⏸/▶. Sale con una
66
- canción puesta, también en pausa (`… · en pausa`, apagada): la rocola se pausa sola cuando nadie la
67
- escucha, y con ▶ entras como oyente y vuelve a sonar. Sin canción o sin el bot en la sala no aparece.
68
- - **Pestaña «Radio»** («Radio ♪» mientras suena): ecualizador coral/azul que late cada ~500 ms solo con
69
- esa pestaña a la vista (congelado en pausa), ⏸/▶ con la canción y lo que lleva sonando, la cola con
70
- sus votos («tuya» si la pediste) y quién escucha. Sin la radio instalada, la pestaña da el comando
71
- para activarla.
72
- - **▶/⏸ es local**: arranca o detiene un reproductor en tu máquina (un proceso aparte, lanzado con
73
- `nohup`, su PID en el store del plugin); no manda comandos a la rocola ni la pausa para nadie. El
74
- reproductor pide un token de solo escucha, entra a `labs-musica` como oyente
75
- (`audience.listening = '1'`), se suscribe solo a la pista de `jukebox-bot-audio` y manda el audio a
76
- ffplay. Al cerrar la sesión que lo lanzó se apaga; antes de matar un PID se confirma con `ps` que
77
- sigue siendo el reproductor.
78
- - Estado y cola se leen cada 5 s solo con el panel a la vista; con el panel cerrado no se pide nada.
79
- La llave de los hooks abre `jukebox/state`, `queue` y `token` de `/v1/labs/live-audio` (votar y pedir
80
- canciones siguen en la web). La API no da la duración ni el artista: el panel muestra lo que lleva
81
- sonando y el título que arma la API.
82
-
83
- Los comandos del Scorecard no llevan el prefijo del plugin (así registra Claude Code los comandos de
84
- un módulo), por eso su nombre ya es único.
85
-
86
- ### Hooks
87
-
88
- Scripts **zero-dependency** que corren en la máquina de cada dev. NO les agregues imports de
89
- node_modules: la promesa es instalación-cero. Viven junto al plugin y su `hooks/hooks.json` los
90
- llama con `node "${CLAUDE_PLUGIN_ROOT}/../<script>"`.
91
-
92
- | Script | Hook | Qué hace |
93
- | --------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------- |
94
- | `emit.mjs` | todos | Enriquece con identidad git, sanitiza y postea a `/ingest`; buffer local si el colector no responde |
95
- | `session-start.mjs` | SessionStart | Handshake + inyecta ranking (`/v1/leaderboard/rank`) y alerta de rama protegida |
96
- | `check-connection.mjs` | UserPromptSubmit | Avisa si hay desconexión o eventos en cola |
97
- | `objective-nudge.mjs` | UserPromptSubmit | Registra el vigente y lo contrasta con el plan del día: refs del turno vs `brief.refs` (ADR-0036 §18) |
98
- | `execution-coach-nudge.mjs` | UserPromptSubmit | Detecta señales de ejecución subóptima y, con throttle por sesión, sugiere `battlearena:execution-coach` |
99
- | `pr-review-worktree.mjs` | PostToolUse | Al detectar `gh pr create`, ofrece (opt-in) `battlearena:pr-review-loop`; no lanza nada por sí solo |
100
-
101
- Helpers que usan las skills: `objective.mjs` (el objetivo del turno) y `plan.mjs` (actividad local de
102
- git y el PDF de la orden de batalla de `/battlearena:conquer`).
103
-
104
- ### Estructura
105
-
106
- ```
107
- apps/claude-hooks/
108
- cli.mjs install.sh *.mjs lib/ el paquete npm y los scripts de los hooks
109
- .claude-plugin/marketplace.json marketplace local: battlearena → ./plugin
110
- plugin/
111
- .claude-plugin/plugin.json { name: "battlearena" }
112
- hooks/hooks.json los hooks de comando + el módulo del Scorecard
113
- hooks/register.tsx … el Scorecard (panel, banda, comandos)
114
- skills/ las skills (las genera `npm run bundle:skill`)
115
- tests/ pruebas del Scorecard (`claude plugin test plugin`)
116
- radio/player.mjs radio/package.json reproductor de la radio (solo con `install --with radio`)
117
- ```
118
-
119
- ### Plan de batalla (skill `/battlearena:conquer` + `plan.mjs`, ADR-0042)
120
-
121
- `/conquer` (o «arma mi plan de mañana») arma tu plan del siguiente día hábil como estratega: revisa
122
- lo que hiciste hoy, te propone los pendientes con su explicación y su ticket, y por cada tema pide
123
- contexto en Linear, valor, DoD no ambiguo, duración (≤ 3 h o «divide y vencerás» en subtareas) y
124
- riesgos. **El de mañana se completa desde las 16:00 (CDMX) de la víspera** (fin de semana libre);
125
- antes solo guarda el borrador.
126
-
127
- **¿Hoy o mañana?** De lunes a viernes antes de las 16:00, si aún no tienes plan de hoy, te pregunta
128
- cuál armar (hoy, recomendado); desde las 16:00 o con el de hoy ya hecho, arma el de mañana. También
129
- puedes pedirlo directo («arma mi plan de hoy»). El plan de hoy se completa al momento y entra a tu
130
- reloj del día y a los recordatorios.
131
-
132
- Cómo habla:
133
-
134
- - **Conector MCP de Battle Arena** (claude.ai → Settings → Connectors, o `/mcp`): `plan_pending`,
135
- `plan_my_day`, `plan_get`, `plan_save_draft`, `plan_can_complete`, `plan_complete`,
136
- `plan_reopen`, `board_add`, `plan_summary`. Identidad = tu cuenta OAuth (sin api-key).
137
- - **Conector de Linear**, como tú: busca tus tickets y, al completar, crea «tu ticket del día»
138
- (`conquest:daily`) con el borrador que da `plan_can_complete`. Lo que no tiene ticket NO se crea:
139
- va al tablero de la PM (`board_add`).
140
- - **`plan.mjs`, solo local** (sin api-key ni red):
141
-
142
- ```bash
143
- node plan.mjs local-activity [--repo <ruta>]… # git de hoy SOLO en esas rutas (sin --repo, el cwd):
144
- # rama, commits con tu email (máx. 10), archivos sin
145
- # commit (solo nombres, máx. 20) y con `gh` el PR de
146
- # la rama actual + los tuyos de los últimos 5 hábiles
147
- node plan.mjs pdf --file summary.json [--reviewer <PM>] [--out <carpeta>] [--no-open]
148
- ```
149
-
150
- `pdf` arma la «orden de batalla» (diseño A4 · Primero lo importante) con lo de `plan_summary`: HTML
151
- con el logo embebido y, si la máquina tiene Chrome/Chromium/Edge (`BATTLE_ORDER_CHROME` para otra
152
- ruta), el PDF con `--headless --print-to-pdf` en `~/Documents/Battle Arena/`. Sin navegador deja el
153
- HTML listo para «Imprimir → Guardar como PDF». Es solo para ti: no se sube.
154
-
155
- Su **fuente única** vive en este paquete: `skill/conquer/SKILL.md` (en el repo,
156
- `.claude/skills/conquer` es un symlink hacia ella y `bundle:skill` no la toca).
157
-
158
- ### PR review loop (`pr-review-worktree` + skill `battlearena:pr-review-loop`)
159
-
160
- Al crear un PR con `gh pr create`, el hook `pr-review-worktree` **sugiere** (no lanza) activar la skill
161
- `pr-review-loop`. Es **opt-in**: la skill primero **pregunta** al usuario si quiere activarlo,
162
- explicando qué hará y el **costo** (cada re-review consume Copilot/Actions de la org) y **cuántas
163
- iteraciones** tolera. Si acepta, el ciclo corre en un **subagente en segundo plano** con **worktree
164
- aislado** (no bloquea la sesión ni toca el main tree): esperar review → corregir → tsc/lint →
165
- commit + `git push origin HEAD:<branch>` → responder/resolver hilos → re-review, hasta converger o
166
- agotar el tope. Al terminar avisa; si no convergió, indica explícitamente qué haría continuar y vuelve
167
- a preguntar. Nunca mergea (decisión humana). También se invoca a mano: `/pr-review-loop <url-o-número>`.
168
-
169
- > El hook `pr-review-worktree` queda activo solo tras **(re)instalar** los hooks —`npx
170
- @thebattlearena/battle-arena-hooks@latest install` o, desde el clone, `bash
171
- apps/claude-hooks/install.sh` (ambos pasan por `cli.mjs`, la misma fuente)—. Una instalación previa
172
- > no lo tiene registrado hasta actualizar.
173
-
174
- Estado local: `~/.claude/hook-stream/{status.json, buffer.ndjson}` y, para el throttle del
175
- interceptor, `~/.claude/battle-arena/execution-coach/<session>.json`.
176
-
177
- ## El plugin hermano `ring`
178
-
179
- `ring` es una forma de trabajar para repos de **backend** (Node, Python, Go…) al refactorizar o
180
- revisar un PR grande: una sesión **árbitro** en effort high revisa; un solo **wrestler** en effort
181
- medium escribe en su propio worktree, un concepto a la vez; los **cornerman** (sólo lectura, effort
182
- high) revisan cada rango de commits contra un reglamento numerado. El humano ve PRs chicos y
183
- temporales (_round-bells_, en draft y con la etiqueta `do-not-merge`) en vez de un PR gigante al
184
- final, y una bitácora durable (_judges card_) permite que otra sesión retome sin el transcript. No
185
- depende del colector ni de la api-key.
186
-
187
- Se instala **junto con `battlearena`**, con el mismo comando y del mismo marketplace local:
188
- `ring@battlearena-local`. `uninstall` quita los dos.
189
-
190
- | Comando | Qué hace |
191
- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
192
- | `/ring:weigh-in` | Escribe `.claude/ring.json` del repo: detecta los gates y pregunta sólo lo que no pudo |
193
- | `/ring:referee start <pr>` | Abre el combate: worktree del wrestler, estado, revisión y round-bells |
194
- | `/ring:referee resume [<pr>]` | Retoma desde el estado durable en una sesión nueva |
195
- | `/ring:referee close` | Gates finales, `validateCommand` opcional sobre la punta exacta, cuerpo del PR |
196
- | `/ring:no-surrender` | Modo noche: fija el `/goal` y deja lo que es del humano anotado, sin bloquearse |
197
- | `/ring:title-defense <pr> [--max-rounds N]` | Defiende el PR ante la review de Copilot: cataloga cada hallazgo, lo corrige por el mismo ciclo y re-pide review hasta quedar limpio |
198
- | `/ring:play-by-play <pr>` | Narra el combate como crónica deportiva con la hora real de cada golpe y la publica como página privada, siempre en el mismo link |
199
-
200
- Agentes: `ring:wrestler` (ejecutor, `effort: medium`) y `ring:cornerman` (revisor de sólo lectura,
201
- `effort: high`, en modo rango, concepto o lote).
202
-
203
- **Config del repo** (`.claude/ring.json`, opcional): `gates` (typecheck, tests por ruta con
204
- `{paths}`, lint), `validateCommand`, `rulebook` (por defecto el genérico del plugin),
205
- `protectedBranches`, `forbidAiTrailers` (por defecto `true`), `heavyCommands`, `delegation`,
206
- `precedents` y `monitors` (ver «Monitores del repo»). Sin el archivo, `ring` usa los gates que detecta en `package.json`, `pyproject.toml`,
207
- `go.mod` y el `Makefile`.
208
-
209
- **Delegación y precedentes**: con `delegation: "referee"` (el default) el árbitro decide él mismo
210
- las dudas de diseño con el reglamento y los precedentes, anota por qué en `decisions.md` y sigue;
211
- sólo te llega una lista corta (merges y bases, flags y variables de entorno, cambios visibles para
212
- el cliente que nadie pidió, un PR que pase el techo de tamaño del repo, datos de clientes, dinero o
213
- producción, lo que bloquea `mask-guard` y contradicciones entre tus instrucciones). Con `"human"` te
214
- consulta todo, como antes. Los precedentes genéricos vienen con el plugin (PR1…PR26) y los del repo
215
- van en `.claude/ring-precedents.md` (HP1…); al cerrar, el árbitro te propone un PR aparte con los
216
- nuevos.
217
-
218
- **La crónica** (`/ring:play-by-play`) sale de los registros reales: la bitácora de decisiones y
219
- rebotes, los commits, las revisiones de Copilot, los eventos del PR y las corridas de CI. Nunca
220
- inventa una hora: lo que no tiene registro se dice como hueco. Es privada; tú la compartes desde su
221
- menú. Más adelante `ring` podrá mandar el link de la crónica al dashboard de Battle Arena; hoy no se
222
- conecta al colector.
223
-
224
- **El contrato es del juez**: si un concepto agrega o cambia un endpoint del spec de la API
225
- (`apiSpec`) o un modelo de base de datos (`dbModels`: entidades, schema, migraciones), el trabajo se
226
- detiene hasta que tú apruebas el contrato, con cualquier nivel de delegación. El wrestler escribe
227
- sólo el contrato, el árbitro lo revisa y te sirve una vista previa en `http://127.0.0.1:4815`
228
- (Swagger del spec propuesto, qué cambia contra la base y el diff de modelos con las tablas y
229
- columnas), y al aprobarlo registra el hash con `judges-card.mjs approve-contract`. `mask-guard`
230
- bloquea el commit de un archivo de contrato cuyo contenido no aprobaste.
231
-
232
- **Estado de cada combate**: `~/.claude/ring/<owner>/<repo>/<pr>/` (`state.json` mínimo,
233
- `decisions.md`, `rebounds.md`, `judges-card.md`). Un directorio por nivel, para que `a-b/c` y
234
- `a/b-c` no choquen; owner y repo van en minúsculas (GitHub no distingue mayúsculas) y un repo sin
235
- remote `origin` vive en `local/<nombre>`. `RING_HOME` cambia la raíz; `config.mjs slug` imprime
236
- `<owner>/<repo>`. Un combate del formato plano anterior (`<owner>-<repo>/<pr>/`) se mueve solo la
237
- primera vez que un script lo busca (las rutas absolutas de `state.json` y del judges card lo
238
- siguen); si existen los dos, gana el nuevo, el viejo no se toca y se avisa por stderr. Si la
239
- mudanza falla, `mask-guard` bloquea diciendo por qué en vez de dejar pasar. Nunca en el scratchpad de la sesión, que se borra al reiniciar.
240
-
241
- **El ring en vivo en el Scorecard.** Si el repo de la sesión tiene un combate activo, el punto del
242
- plan cuyas ligas (`refs`) nombran el PR del combate (`agents-studio-be#1060`, `owner/repo#N` o su URL)
243
- dice junto a su tiempo si ahí se está trabajando: spinner mientras alguien trabaja, ■ ámbar si te toca
244
- decidir, 👊N en rojo si Copilot dejó hilos, nada en reposo. Al abrir el punto aparece la fila
245
- «▸ Revisión #N» con el tiempo del ring de hoy (si ningún punto liga el PR, la fila va sola tras los
246
- puntos). Desplegada (▾), como la lámina «Cuerpo»: la cabecera (spinner o ■ ámbar, `#PR`, los rounds de
247
- la defensa del título con su barra ▮▯ sacados de los `## Round N` de `title-defense.md` contra su
248
- tope, la última round-bell y la crónica); la tarjeta en vivo con acento a la izquierda (azul
249
- trabajando, roja «👊×N HIGH» si Copilot golpeó, ámbar llena «TE TOCA DECIDIR» con el tiempo, o «sin
250
- actividad desde hace X»); las fichas en una fila, cajas redondeadas con el ícono al centro y el
251
- estado en el borde (quieta gris, activa azul con barra, en la esquina morada con ◣, golpeó roja con
252
- 👊N, te toca ámbar con «tú», abierta con borde grueso y ▾); y la ficha abierta: título con desde
253
- cuándo, el verbo con su barra, la tabla de `fields` del evento (rama, commits, archivo; rango, modo,
254
- veredicto; hilos, severidad; pregunta con «responde en la terminal ↵»), ÚLTIMOS y cómo cerrarla.
255
- Las fichas son cuadrados rellenos de 4×2 celdas (con celdas de ~1:2.1 se ven cuadrados), sin
256
- borde, en un tinte del color del actor (más fuerte trabajando y abierta), con el glifo centrado arriba
257
- y el indicador centrado abajo, dentro de la ficha; toda la ficha es el clic. Si la terminal dibuja
258
- imágenes (el panel lo pregunta con `$.ui.blit` sobre la campana de la cabecera), va el PNG del
259
- ícono en su lugar; Ghostty hoy no las dibuja con este engine (lo confirma `/scorecard-icons`, que
260
- muestra cada forma de imagen con lo que contestó el engine), así que lo normal son los glifos, o dos
261
- letras ASCII sin la fuente. Los
262
- íconos chicos (campana, crónica, tarjeta y título) van con la fuente y, con ella instalada, todos los
263
- símbolos del Scorecard (estados del punto ↻ ↷ ○ ● ✓, ▸ ▾ ▴, ↗, ✋ 👍 👎, ✎, 📅 💡, ♪ ▶ ⏸ ▲…) son sus
264
- glifos, en sus mismos colores; sin ella, los caracteres de siempre (`ic()` en `icons.ts`). La
265
- última round-bell sale del
266
- feed en vivo o, en combates de antes, de `gh pr list --head ring/<pr>/round-<n>` (una vez por
267
- round). Un escritor puede mandar la tabla de la ficha con `fields` (`live.mjs emit --field
268
- rama=feat/x`).
269
-
270
- **La fuente de íconos.** `fonts/battle-arena-icons/BattleArenaIcons.ttf`: 58 glifos en el área de
271
- uso privado suplementaria A (U+FBA00–U+FBA85, lejos de los de Nerd Fonts), con nombre de glifo igual
272
- al id de `src/codepoints.json`. UPM 1000; un ícono de una celda avanza 600 y uno de dos, 1200 (la
273
- celda de una mono típica es 0.6 em), centrados en vertical en y = 340. 31 vienen de Lucide (ISC,
274
- `LICENSE-lucide.txt`) y 5 son propios. `install` la copia a `~/Library/Fonts` (macOS) o a
275
- `~/.local/share/fonts` (Linux, con `fc-cache -f` si está) y deja `iconFont: true` en
276
- `~/.claude/battle-arena/config.json`: un mod no puede saber qué fuentes tiene la terminal, así que el
277
- Scorecard sólo dibuja glifos con esa bandera. Si Ghostty ya tiene config (`~/.config/ghostty/config`
278
- o la de `~/Library/Application Support/com.mitchellh.ghostty/`), le agrega
279
- `font-codepoint-map = U+FBA00-U+FBA5F=Battle Arena Icons`; si no, imprime la línea para que la
280
- agregues tú (nunca crea ni reescribe tu config). `uninstall` quita la fuente, esa línea y apaga
281
- `iconFont`. Para regenerarla tras cambiar un SVG: `python3 -m venv /tmp/ba-icons &&
282
- /tmp/ba-icons/bin/pip install -r fonts/battle-arena-icons/requirements.txt &&
283
- /tmp/ba-icons/bin/python fonts/battle-arena-icons/build.py` (picosvg pasa los trazos a contornos y
284
- fonttools arma el `.ttf`; nada de esto corre al instalar).
285
-
286
- La fuente es `<combate>/live.jsonl`, un evento JSON por línea (se queda con los últimos 60 más el
287
- último de cada actor y cada trabajo abierto). La escriben, de mejor esfuerzo y sin hacer ruido
288
- nunca: `round-bell.mjs open` (campana), `title-defense.mjs requested|wait|feedback` (Copilot en la
289
- esquina, revisó, 👊N), `judges-card.mjs log|approve-contract|play-by-play-url` (árbitro y juez),
290
- `one-at-a-time.mjs run` y el hook `live-hook.mjs` (`PreToolUse`/`PostToolUse`/`PostToolUseFailure`
291
- sobre `Agent`, `AskUserQuestion` y `Bash`, y `SubagentStop`). **Convención de subagentes**: cuentan
292
- los de tipo `ring:wrestler` / `ring:cornerman` y, si son `general-purpose`, los que empiezan su
293
- `description` con `Wrestler:` o `Cornerman:` (también `Luchador:` / `Esquinero:`); el resto de la
294
- descripción es la etiqueta del chip. Un `AskUserQuestion` pendiente pone al juez en «te toca
295
- decidir»; si la pregunta se descarta sin contestar (Claude Code no avisa), el siguiente
296
- `UserPromptSubmit` o `Stop` de esa sesión la cierra como «sin respuesta», y el Scorecard la da por
297
- caducada a los 30 min. **Sólo las sesiones del combate escriben**: una sesión se registra sola
298
- (`state.json` → `sessions`, con su rol y cuándo se vio) la primera vez que corre un script del ring;
299
- sus subagentes comparten su `session_id`. Otra sesión que trabaje en el mismo repo no cuenta.
300
-
301
- **Monitores del repo.** `ring` es genérico y no trae monitores: **cada repo declara los suyos, con
302
- sus íconos y colores, en SU `.claude/ring.json`**, y salen como fichas extra tras las del ring. Un
303
- ejemplo, el de agents-studio-be (su batería de campañas, que además abre la vista del mod
304
- `campaign-test-monitor`; no es parte del plugin):
305
-
306
- ```json
307
- {
308
- "monitors": [
309
- {
310
- "id": "bateria",
311
- "label": "Batería",
312
- "icon": "bateria",
313
- "color": "green",
314
- "match": { "command": "campaign-mock-report/scripts/run\\.mjs" },
315
- "open": { "command": "campaign-test-monitor" }
316
- }
317
- ]
318
- }
319
- ```
320
-
321
- - `id` (minúsculas, dígitos, `_`, `-`; nunca el de un actor del ring) y `label`. Una entrada
322
- inválida se ignora con un aviso en `config.mjs show`; nunca tumba `mask-guard`.
323
- - `icon` (opcional): cualquiera de los 58 nombres de la fuente Battle Arena Icons; uno que no exista,
324
- o ninguno, deja las dos primeras letras del `label` (los de puntos, acciones y medios son de la
325
- interfaz del Scorecard y no tienen imagen, sólo glifo):
326
- - marca: `arena`
327
- - actores: `arbitro`, `luchador`, `esquinero`, `campana`, `copilot`, `juez`
328
- - estados: `activo`, `en-la-esquina`, `golpe`, `listo`, `fallo`, `espera`, `te-toca`, `pensando`, `modificando`, `probando`, `revisando`, `subiendo`, `finalizando`
329
- - objetos: `pr`, `ronda`, `cronica`, `monitor`, `bateria`, `rama`, `ticket`
330
- - scorecard: `plan`, `punto`, `emergente`, `riesgo`, `reunion`, `objetivo`, `tiempo`, `trofeo`, `fuego`
331
- - puntos: `en-curso`, `desplazado`, `por-hacer`, `con-avance`, `decision-pendiente`
332
- - acciones: `expandir`, `contraer`, `cerrar-detalle`, `abrir-web`, `cerrar`, `levantar-mano`, `voto-a-favor`, `voto-en-contra`, `responder`, `enviar`, `siguiente`
333
- - medios: `calendario`, `cabinas`, `radio`, `reproducir`, `pausar`, `votar-cancion`
334
- - `color` (opcional): uno de la paleta (`slate`, `blue`, `teal`, `amber`, `purple`, `orange`,
335
- `green`, `red`, `pink`); sin él, verde. Va en el borde de la ficha; el ícono de un monitor se
336
- dibuja en gris neutro (sólo los actores del ring tienen PNG en su color).
337
- - `match.command` (opcional): regex sobre el comando de Bash. Mientras corre uno que la cumple, el
338
- monitor está activo (`PreToolUse` → `PostToolUse`/`PostToolUseFailure`); un comando en segundo
339
- plano no cuenta, para eso está `emit`. `one-at-a-time` también lo marca mientras tiene el candado,
340
- pero sólo fuera de Claude Code (dentro, ya lo hace el hook de Bash).
341
- - `open` (opcional): `{ "command": "<comando sin />" }` pone un botón «abrir ↗» en el detalle del
342
- chip que corre ese comando (por ejemplo el de otro mod que abre su propio panel); si el comando no
343
- existe en la sesión, o con `{ "pane": "<id>" }` (un mod no puede abrir el panel de otro), el
344
- detalle dice qué escribir.
345
- - Procesos largos fuera de una herramienta (una batería en segundo plano):
346
- `node "$RING/scripts/live.mjs" emit --monitor bateria --state probando --label "t1 de 6" --progress 1/6 [--detail "…"] [--done|--failed] [--pr <n>] || true`.
347
- Sin `--pr` busca el combate de esa carpeta. Con `RING_LIVE_FILE` en el entorno (`one-at-a-time`
348
- se la pasa a su hijo) escribe directo ahí, y un script puede agregar él mismo la línea JSON
349
- (`{"at":"<ISO>","monitor":"bateria","state":"active","label":"probando","progress":{"done":1,"total":6}}`)
350
- sin depender de `ring`. Esquema: `actor` (uno del ring) o `monitor` (declarado), `state`
351
- (`active`, `waiting`, `done`, `failed`), `label` (≤3 palabras) y, opcionales, `note`, `detail`,
352
- `progress`, `id` (para cerrar justo ese trabajo), `count`, `severity`, `pr`, `url`. Un monitor no
353
- declarado se rechaza (`emit` sale con 1) y el Scorecard lo ignora.
354
-
355
- **`mask-guard`** (hook `PreToolUse` sobre Bash) bloquea **siempre** `git add -A/./--all`,
356
- `git stash pop`, `git reset --hard` con el árbol sucio y, si `forbidAiTrailers` está activo, los
357
- commits con trailers de atribución de IA (los coautores humanos pasan). **Sólo mientras hay un
358
- combate activo en ese repo** bloquea además lo que decide el humano: merges (y `git pull` que no sea
359
- `--ff-only`/`--rebase`), cambios de base, cerrar o sacar de draft PRs, `gh pr review`, pedir review
360
- a Copilot, force push, push a una rama protegida, comandos pesados fuera de `one-at-a-time` y
361
- commits cuyo mensaje lleva ids internos del combate (D12, PR5, HP3; P7 o D1 sólo avisan). Y si la
362
- crónica (`/ring:play-by-play`) ya tiene liga y algún registro del combate (`decisions.md`,
363
- `rebounds.md`, `title-defense.md`, `judges-card.md`, `round-*.md`) cambió después de su última
364
- publicación, bloquea el re-pedido a Copilot y `judges-card.mjs close` hasta republicarla.
365
- Todo PR que abre `ring` nace en draft y sólo tú lo marcas listo; `/ring:title-defense` arranca
366
- cuando sacas el PR de draft, y un hallazgo que una reproducción dirigida (el escenario o el spec de
367
- ese bug, minutos) puede mostrar no se marca corregido ni se resuelve hasta que esa reproducción sale
368
- verde sobre la punta exacta; la validación completa (`validateCommand`, horas) corre una sola vez al
369
- final, sobre la punta final. Durante `/ring:title-defense` se permite, sólo para ese PR, re-pedir
370
- review a Copilot y responder y resolver los hilos ya corregidos; descartar reviews nunca.
371
-
372
- ## Qué se censura antes de enviar (`lib/sanitize.mjs`)
373
-
374
- Antes de salir de tu máquina, cada evento pasa por `lib/sanitize.mjs` (patrones en
375
- `lib/secret-patterns.mjs`):
376
-
377
- - **Paths de tu máquina**: tu homedir y `/Users/<x>` / `/home/<x>` → `~`.
378
- - **Variables sensibles por nombre** (`PASSWORD`, `*_TOKEN`, `*_SECRET`, `api_key`, `AUTH`, y en
379
- estilo env `KEY` / `*_KEY`): se conserva el nombre y el valor queda en `***`.
380
- - **Llaves de proveedor sueltas** en cualquier texto (comando, resultado, prompt): Retell, OpenAI /
381
- Anthropic, Linear, GitHub, Slack, Stripe, Google, JWT y AWS; se conserva el prefijo (`sk-***`).
382
- - **Headers y URLs**: `x-api-key`, `Authorization` (con o sin `Bearer`), `?api_key=` / `?token=`
383
- y credenciales en URIs (`scheme://user:***@host`).
384
- - **Archivos `.env` leídos** (Read/Grep de un `.env`/`.env.*`/`*.env`, o `cat`/`head`/`tail`/`grep`
385
- de uno por Bash): cada línea `NOMBRE=valor` del resultado queda `NOMBRE=***`.
386
- - Strings de más de 4000 caracteres se recortan.
387
-
388
- El colector aplica el mismo filtro al ingerir (defensa en profundidad para instalaciones viejas):
389
- `packages/contexts/arena/domain/services/secret-redaction.service.ts`. La paridad entre ambos la
390
- cuidan vectores compartidos (`packages/contexts/arena/domain/__tests__/fixtures/secret-redaction.vectors.json`)
391
- que corren las dos suites: `yarn workspace @thebattlearena/battle-arena-hooks test` (o
392
- `node --test apps/claude-hooks/test/*.test.mjs`) y el jest de la raíz.
393
-
394
- ## Manejo de errores del colector
395
-
396
- `emit.mjs` clasifica la respuesta de `/ingest`:
397
-
398
- - **400 / 413 / 422** (evento malformado/enorme) → se **descarta** (no se reintenta).
399
- - **timeout / 5xx / 429** → se **bufferea** y se reenvía al primer envío exitoso.
400
- - **401 / 403** (API key inválida o revocada, p. ej. tras rotar la key o reiniciar el backend) →
401
- **no se bufferea** (reintentar con la misma key es en vano). Se marca `authError` en
402
- `status.json` y los hooks de superficie (`session-start`, `check-connection`) le piden al
403
- usuario que **genere una key nueva y reinstale** con
404
- `npx @thebattlearena/battle-arena-hooks@latest install --url <url> --api-key <NUEVA_KEY>`.
405
- Tras un envío exitoso con la key nueva, el flag se limpia solo. Lógica compartida en
406
- `lib/reauth.mjs`.
407
-
408
- ## Instalación
409
-
410
- ```bash
411
- npx @thebattlearena/battle-arena-hooks@latest install \
412
- --url https://api.battlearena.dev --api-key <tu-llave>
413
- ```
414
-
415
- Requiere Claude Code CLI (`claude` en el PATH) y node ≥ 18. El instalador:
416
-
417
- 1. Copia los scripts y el plugin a `~/.claude/battle-arena/hooks/` (la misma ruta de antes).
418
- 2. Guarda la url y la llave en `~/.claude/battle-arena/config.json`.
419
- 3. **Limpia la versión anterior:** quita sus hooks de `~/.claude/settings.json` (si no, cada evento se
420
- mandaría dos veces) y mueve sus skills sueltas de `~/.claude/skills` a
421
- `~/.claude/battle-arena/legacy-skills/<fecha>/` (respaldo, no las borra).
422
- 4. Registra la carpeta como marketplace local e instala `battlearena@battlearena-local` para tu usuario
423
- (`claude plugin marketplace add` + `claude plugin install --scope user`). Se lee directo de esa
424
- carpeta: para actualizar basta volver a correr el instalador y `/reload-plugins`.
425
-
426
- 5. Con `--with radio` (o si ya la habías pedido), instala además la radio del Scorecard (ver «La radio
427
- (Arena FM) en el Scorecard»). Correr `install` sin `--url`/`--api-key` reusa los de config.json.
428
-
429
- Desde el clone (contribuidores): `HOOK_STREAM_URL=… HOOK_STREAM_API_KEY=… bash apps/claude-hooks/install.sh`
430
- (acepta `--with radio` al final).
431
- Para probar el plugin sin instalarlo: `npm run bundle:skill` y `claude --plugin-dir apps/claude-hooks/plugin`.
432
-
433
- ## Configuración
434
-
435
- Los hooks y el Scorecard leen, en orden de prioridad:
436
-
437
- 1. **Variables de entorno** `HOOK_STREAM_URL` / `HOOK_STREAM_API_KEY` (si están seteadas).
438
- 2. **`~/.claude/battle-arena/config.json`** (`{ "url": "...", "apiKey": "..." }`), que escribe el instalador.
439
- 3. Default `http://127.0.0.1:4500`.
440
-
441
- `HOOK_STREAM_API_KEY` con `ARENA_REQUIRE_AUTH=true` necesita scopes `arena:read`
442
- (handshake, ranking, Scorecard), `arena:write` (objetivos) y `arena:hands` (✋ desde el Scorecard);
443
- `/ingest` acepta cualquier api-key válida.
444
-
445
- ## Cutover desde el colector legacy (speech-analytics/tooling/hook-stream)
446
-
447
- 1. Levanta battle-arena en el puerto 4500 (apagando antes el `yarn hook-stream` legacy) — la
448
- ruta `/ingest` y el compat `/objective` son idénticos: los hooks viejos siguen funcionando
449
- sin tocarlos.
450
- 2. Restaura el histórico si quieres conservar el leaderboard: `pg_dump` de la DB `hook_stream`
451
- → `battle_arena` (mismas tablas/columnas).
452
- 3. Actualiza tus settings para apuntar a estos hooks (ruta absoluta al clone) y borra los del
453
- repo legacy cuando todo el equipo haya migrado.
9
+ Esta versión solo avisa del cambio y corre el instalador de Corner con los mismos argumentos.
10
+ Corner usa la misma carpeta (`~/.claude/battle-arena/`), así que conserva la url, la api-key y tus
11
+ hooks propios de `settings.json`.