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