@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.
- package/README.md +6 -497
- package/cli.mjs +27 -327
- package/package.json +2 -25
- package/.claude-plugin/marketplace.json +0 -18
- package/check-connection.mjs +0 -64
- package/emit.mjs +0 -100
- package/execution-coach-nudge.mjs +0 -247
- package/fonts/battle-arena-icons/BattleArenaIcons.ttf +0 -0
- package/fonts/battle-arena-icons/LICENSE-lucide.txt +0 -39
- package/lib/battle-order/battle-arena-logo.png +0 -0
- package/lib/battle-order/html.mjs +0 -403
- package/lib/battle-order/pdf.mjs +0 -122
- package/lib/battle-order/styles.mjs +0 -158
- package/lib/drain.mjs +0 -49
- package/lib/ghostty-theme.mjs +0 -162
- package/lib/git-diff.mjs +0 -63
- package/lib/icon-font.mjs +0 -143
- package/lib/identity.mjs +0 -55
- package/lib/local-activity.mjs +0 -217
- package/lib/objective-api.mjs +0 -152
- package/lib/objective-guidance.mjs +0 -103
- package/lib/objective-name.mjs +0 -25
- package/lib/plugin-install.mjs +0 -172
- package/lib/radio-install.mjs +0 -70
- package/lib/reauth.mjs +0 -30
- package/lib/sanitize.mjs +0 -81
- package/lib/secret-patterns.mjs +0 -90
- package/lib/state.mjs +0 -63
- package/lib/synthetic-prompt.mjs +0 -26
- package/lib/transport.mjs +0 -168
- package/lib/work-signals.mjs +0 -124
- package/objective-nudge.mjs +0 -223
- package/objective.mjs +0 -170
- package/plan.mjs +0 -89
- package/plugin/.claude-plugin/plugin.json +0 -9
- package/plugin/hooks/api.ts +0 -180
- package/plugin/hooks/close-pane.tsx +0 -203
- package/plugin/hooks/close.ts +0 -198
- package/plugin/hooks/colors.ts +0 -18
- package/plugin/hooks/complements.ts +0 -61
- package/plugin/hooks/format.ts +0 -303
- package/plugin/hooks/hooks.json +0 -111
- package/plugin/hooks/icon-files.ts +0 -35
- package/plugin/hooks/icons-diag.tsx +0 -155
- package/plugin/hooks/icons.generated.ts +0 -104
- package/plugin/hooks/icons.ts +0 -161
- package/plugin/hooks/label-links.tsx +0 -55
- package/plugin/hooks/meetings.ts +0 -36
- package/plugin/hooks/pane-view.ts +0 -12
- package/plugin/hooks/pane.tsx +0 -1158
- package/plugin/hooks/radio-format.ts +0 -153
- package/plugin/hooks/radio-pane.tsx +0 -310
- package/plugin/hooks/radio-player.ts +0 -184
- package/plugin/hooks/radio-queue.ts +0 -41
- package/plugin/hooks/radio.ts +0 -137
- package/plugin/hooks/register.tsx +0 -544
- package/plugin/hooks/ring-io.ts +0 -248
- package/plugin/hooks/ring-pane.tsx +0 -823
- package/plugin/hooks/ring.ts +0 -595
- package/plugin/hooks/terminal-caps.ts +0 -31
- package/plugin/icons/activo-grey-2x1.png +0 -0
- package/plugin/icons/activo-grey-4x2.png +0 -0
- package/plugin/icons/activo-grey-5x2.png +0 -0
- package/plugin/icons/activo-grey-6x2.png +0 -0
- package/plugin/icons/arbitro-amber-2x1.png +0 -0
- package/plugin/icons/arbitro-amber-4x2.png +0 -0
- package/plugin/icons/arbitro-amber-5x2.png +0 -0
- package/plugin/icons/arbitro-amber-6x2.png +0 -0
- package/plugin/icons/arbitro-grey-2x1.png +0 -0
- package/plugin/icons/arbitro-grey-4x2.png +0 -0
- package/plugin/icons/arbitro-grey-5x2.png +0 -0
- package/plugin/icons/arbitro-grey-6x2.png +0 -0
- package/plugin/icons/arbitro-red-2x1.png +0 -0
- package/plugin/icons/arbitro-red-4x2.png +0 -0
- package/plugin/icons/arbitro-red-5x2.png +0 -0
- package/plugin/icons/arbitro-red-6x2.png +0 -0
- package/plugin/icons/arbitro-slate-2x1.png +0 -0
- package/plugin/icons/arbitro-slate-4x2.png +0 -0
- package/plugin/icons/arbitro-slate-5x2.png +0 -0
- package/plugin/icons/arbitro-slate-6x2.png +0 -0
- package/plugin/icons/arbitro-slate-dim-2x1.png +0 -0
- package/plugin/icons/arbitro-slate-dim-4x2.png +0 -0
- package/plugin/icons/arbitro-slate-dim-5x2.png +0 -0
- package/plugin/icons/arbitro-slate-dim-6x2.png +0 -0
- package/plugin/icons/arena-grey-2x1.png +0 -0
- package/plugin/icons/arena-grey-4x2.png +0 -0
- package/plugin/icons/arena-grey-5x2.png +0 -0
- package/plugin/icons/arena-grey-6x2.png +0 -0
- package/plugin/icons/bateria-grey-2x1.png +0 -0
- package/plugin/icons/bateria-grey-4x2.png +0 -0
- package/plugin/icons/bateria-grey-5x2.png +0 -0
- package/plugin/icons/bateria-grey-6x2.png +0 -0
- package/plugin/icons/campana-amber-2x1.png +0 -0
- package/plugin/icons/campana-amber-4x2.png +0 -0
- package/plugin/icons/campana-amber-5x2.png +0 -0
- package/plugin/icons/campana-amber-6x2.png +0 -0
- package/plugin/icons/campana-amber-dim-2x1.png +0 -0
- package/plugin/icons/campana-amber-dim-4x2.png +0 -0
- package/plugin/icons/campana-amber-dim-5x2.png +0 -0
- package/plugin/icons/campana-amber-dim-6x2.png +0 -0
- package/plugin/icons/campana-grey-2x1.png +0 -0
- package/plugin/icons/campana-grey-4x2.png +0 -0
- package/plugin/icons/campana-grey-5x2.png +0 -0
- package/plugin/icons/campana-grey-6x2.png +0 -0
- package/plugin/icons/campana-red-2x1.png +0 -0
- package/plugin/icons/campana-red-4x2.png +0 -0
- package/plugin/icons/campana-red-5x2.png +0 -0
- package/plugin/icons/campana-red-6x2.png +0 -0
- package/plugin/icons/copilot-amber-2x1.png +0 -0
- package/plugin/icons/copilot-amber-4x2.png +0 -0
- package/plugin/icons/copilot-amber-5x2.png +0 -0
- package/plugin/icons/copilot-amber-6x2.png +0 -0
- package/plugin/icons/copilot-grey-2x1.png +0 -0
- package/plugin/icons/copilot-grey-4x2.png +0 -0
- package/plugin/icons/copilot-grey-5x2.png +0 -0
- package/plugin/icons/copilot-grey-6x2.png +0 -0
- package/plugin/icons/copilot-purple-2x1.png +0 -0
- package/plugin/icons/copilot-purple-4x2.png +0 -0
- package/plugin/icons/copilot-purple-5x2.png +0 -0
- package/plugin/icons/copilot-purple-6x2.png +0 -0
- package/plugin/icons/copilot-purple-dim-2x1.png +0 -0
- package/plugin/icons/copilot-purple-dim-4x2.png +0 -0
- package/plugin/icons/copilot-purple-dim-5x2.png +0 -0
- package/plugin/icons/copilot-purple-dim-6x2.png +0 -0
- package/plugin/icons/copilot-red-2x1.png +0 -0
- package/plugin/icons/copilot-red-4x2.png +0 -0
- package/plugin/icons/copilot-red-5x2.png +0 -0
- package/plugin/icons/copilot-red-6x2.png +0 -0
- package/plugin/icons/cronica-grey-2x1.png +0 -0
- package/plugin/icons/cronica-grey-4x2.png +0 -0
- package/plugin/icons/cronica-grey-5x2.png +0 -0
- package/plugin/icons/cronica-grey-6x2.png +0 -0
- package/plugin/icons/emergente-grey-2x1.png +0 -0
- package/plugin/icons/emergente-grey-4x2.png +0 -0
- package/plugin/icons/emergente-grey-5x2.png +0 -0
- package/plugin/icons/emergente-grey-6x2.png +0 -0
- package/plugin/icons/en-la-esquina-grey-2x1.png +0 -0
- package/plugin/icons/en-la-esquina-grey-4x2.png +0 -0
- package/plugin/icons/en-la-esquina-grey-5x2.png +0 -0
- package/plugin/icons/en-la-esquina-grey-6x2.png +0 -0
- package/plugin/icons/espera-grey-2x1.png +0 -0
- package/plugin/icons/espera-grey-4x2.png +0 -0
- package/plugin/icons/espera-grey-5x2.png +0 -0
- package/plugin/icons/espera-grey-6x2.png +0 -0
- package/plugin/icons/esquinero-amber-2x1.png +0 -0
- package/plugin/icons/esquinero-amber-4x2.png +0 -0
- package/plugin/icons/esquinero-amber-5x2.png +0 -0
- package/plugin/icons/esquinero-amber-6x2.png +0 -0
- package/plugin/icons/esquinero-grey-2x1.png +0 -0
- package/plugin/icons/esquinero-grey-4x2.png +0 -0
- package/plugin/icons/esquinero-grey-5x2.png +0 -0
- package/plugin/icons/esquinero-grey-6x2.png +0 -0
- package/plugin/icons/esquinero-red-2x1.png +0 -0
- package/plugin/icons/esquinero-red-4x2.png +0 -0
- package/plugin/icons/esquinero-red-5x2.png +0 -0
- package/plugin/icons/esquinero-red-6x2.png +0 -0
- package/plugin/icons/esquinero-teal-2x1.png +0 -0
- package/plugin/icons/esquinero-teal-4x2.png +0 -0
- package/plugin/icons/esquinero-teal-5x2.png +0 -0
- package/plugin/icons/esquinero-teal-6x2.png +0 -0
- package/plugin/icons/esquinero-teal-dim-2x1.png +0 -0
- package/plugin/icons/esquinero-teal-dim-4x2.png +0 -0
- package/plugin/icons/esquinero-teal-dim-5x2.png +0 -0
- package/plugin/icons/esquinero-teal-dim-6x2.png +0 -0
- package/plugin/icons/fallo-grey-2x1.png +0 -0
- package/plugin/icons/fallo-grey-4x2.png +0 -0
- package/plugin/icons/fallo-grey-5x2.png +0 -0
- package/plugin/icons/fallo-grey-6x2.png +0 -0
- package/plugin/icons/finalizando-grey-2x1.png +0 -0
- package/plugin/icons/finalizando-grey-4x2.png +0 -0
- package/plugin/icons/finalizando-grey-5x2.png +0 -0
- package/plugin/icons/finalizando-grey-6x2.png +0 -0
- package/plugin/icons/fuego-grey-2x1.png +0 -0
- package/plugin/icons/fuego-grey-4x2.png +0 -0
- package/plugin/icons/fuego-grey-5x2.png +0 -0
- package/plugin/icons/fuego-grey-6x2.png +0 -0
- package/plugin/icons/golpe-grey-2x1.png +0 -0
- package/plugin/icons/golpe-grey-4x2.png +0 -0
- package/plugin/icons/golpe-grey-5x2.png +0 -0
- package/plugin/icons/golpe-grey-6x2.png +0 -0
- package/plugin/icons/juez-amber-2x1.png +0 -0
- package/plugin/icons/juez-amber-4x2.png +0 -0
- package/plugin/icons/juez-amber-5x2.png +0 -0
- package/plugin/icons/juez-amber-6x2.png +0 -0
- package/plugin/icons/juez-grey-2x1.png +0 -0
- package/plugin/icons/juez-grey-4x2.png +0 -0
- package/plugin/icons/juez-grey-5x2.png +0 -0
- package/plugin/icons/juez-grey-6x2.png +0 -0
- package/plugin/icons/juez-orange-2x1.png +0 -0
- package/plugin/icons/juez-orange-4x2.png +0 -0
- package/plugin/icons/juez-orange-5x2.png +0 -0
- package/plugin/icons/juez-orange-6x2.png +0 -0
- package/plugin/icons/juez-orange-dim-2x1.png +0 -0
- package/plugin/icons/juez-orange-dim-4x2.png +0 -0
- package/plugin/icons/juez-orange-dim-5x2.png +0 -0
- package/plugin/icons/juez-orange-dim-6x2.png +0 -0
- package/plugin/icons/juez-red-2x1.png +0 -0
- package/plugin/icons/juez-red-4x2.png +0 -0
- package/plugin/icons/juez-red-5x2.png +0 -0
- package/plugin/icons/juez-red-6x2.png +0 -0
- package/plugin/icons/listo-grey-2x1.png +0 -0
- package/plugin/icons/listo-grey-4x2.png +0 -0
- package/plugin/icons/listo-grey-5x2.png +0 -0
- package/plugin/icons/listo-grey-6x2.png +0 -0
- package/plugin/icons/luchador-amber-2x1.png +0 -0
- package/plugin/icons/luchador-amber-4x2.png +0 -0
- package/plugin/icons/luchador-amber-5x2.png +0 -0
- package/plugin/icons/luchador-amber-6x2.png +0 -0
- package/plugin/icons/luchador-blue-2x1.png +0 -0
- package/plugin/icons/luchador-blue-4x2.png +0 -0
- package/plugin/icons/luchador-blue-5x2.png +0 -0
- package/plugin/icons/luchador-blue-6x2.png +0 -0
- package/plugin/icons/luchador-blue-dim-2x1.png +0 -0
- package/plugin/icons/luchador-blue-dim-4x2.png +0 -0
- package/plugin/icons/luchador-blue-dim-5x2.png +0 -0
- package/plugin/icons/luchador-blue-dim-6x2.png +0 -0
- package/plugin/icons/luchador-grey-2x1.png +0 -0
- package/plugin/icons/luchador-grey-4x2.png +0 -0
- package/plugin/icons/luchador-grey-5x2.png +0 -0
- package/plugin/icons/luchador-grey-6x2.png +0 -0
- package/plugin/icons/luchador-red-2x1.png +0 -0
- package/plugin/icons/luchador-red-4x2.png +0 -0
- package/plugin/icons/luchador-red-5x2.png +0 -0
- package/plugin/icons/luchador-red-6x2.png +0 -0
- package/plugin/icons/modificando-grey-2x1.png +0 -0
- package/plugin/icons/modificando-grey-4x2.png +0 -0
- package/plugin/icons/modificando-grey-5x2.png +0 -0
- package/plugin/icons/modificando-grey-6x2.png +0 -0
- package/plugin/icons/monitor-grey-2x1.png +0 -0
- package/plugin/icons/monitor-grey-4x2.png +0 -0
- package/plugin/icons/monitor-grey-5x2.png +0 -0
- package/plugin/icons/monitor-grey-6x2.png +0 -0
- package/plugin/icons/objetivo-grey-2x1.png +0 -0
- package/plugin/icons/objetivo-grey-4x2.png +0 -0
- package/plugin/icons/objetivo-grey-5x2.png +0 -0
- package/plugin/icons/objetivo-grey-6x2.png +0 -0
- package/plugin/icons/pensando-grey-2x1.png +0 -0
- package/plugin/icons/pensando-grey-4x2.png +0 -0
- package/plugin/icons/pensando-grey-5x2.png +0 -0
- package/plugin/icons/pensando-grey-6x2.png +0 -0
- package/plugin/icons/plan-grey-2x1.png +0 -0
- package/plugin/icons/plan-grey-4x2.png +0 -0
- package/plugin/icons/plan-grey-5x2.png +0 -0
- package/plugin/icons/plan-grey-6x2.png +0 -0
- package/plugin/icons/pr-grey-2x1.png +0 -0
- package/plugin/icons/pr-grey-4x2.png +0 -0
- package/plugin/icons/pr-grey-5x2.png +0 -0
- package/plugin/icons/pr-grey-6x2.png +0 -0
- package/plugin/icons/probando-grey-2x1.png +0 -0
- package/plugin/icons/probando-grey-4x2.png +0 -0
- package/plugin/icons/probando-grey-5x2.png +0 -0
- package/plugin/icons/probando-grey-6x2.png +0 -0
- package/plugin/icons/punto-grey-2x1.png +0 -0
- package/plugin/icons/punto-grey-4x2.png +0 -0
- package/plugin/icons/punto-grey-5x2.png +0 -0
- package/plugin/icons/punto-grey-6x2.png +0 -0
- package/plugin/icons/rama-grey-2x1.png +0 -0
- package/plugin/icons/rama-grey-4x2.png +0 -0
- package/plugin/icons/rama-grey-5x2.png +0 -0
- package/plugin/icons/rama-grey-6x2.png +0 -0
- package/plugin/icons/reunion-grey-2x1.png +0 -0
- package/plugin/icons/reunion-grey-4x2.png +0 -0
- package/plugin/icons/reunion-grey-5x2.png +0 -0
- package/plugin/icons/reunion-grey-6x2.png +0 -0
- package/plugin/icons/revisando-grey-2x1.png +0 -0
- package/plugin/icons/revisando-grey-4x2.png +0 -0
- package/plugin/icons/revisando-grey-5x2.png +0 -0
- package/plugin/icons/revisando-grey-6x2.png +0 -0
- package/plugin/icons/riesgo-grey-2x1.png +0 -0
- package/plugin/icons/riesgo-grey-4x2.png +0 -0
- package/plugin/icons/riesgo-grey-5x2.png +0 -0
- package/plugin/icons/riesgo-grey-6x2.png +0 -0
- package/plugin/icons/ronda-grey-2x1.png +0 -0
- package/plugin/icons/ronda-grey-4x2.png +0 -0
- package/plugin/icons/ronda-grey-5x2.png +0 -0
- package/plugin/icons/ronda-grey-6x2.png +0 -0
- package/plugin/icons/subiendo-grey-2x1.png +0 -0
- package/plugin/icons/subiendo-grey-4x2.png +0 -0
- package/plugin/icons/subiendo-grey-5x2.png +0 -0
- package/plugin/icons/subiendo-grey-6x2.png +0 -0
- package/plugin/icons/te-toca-grey-2x1.png +0 -0
- package/plugin/icons/te-toca-grey-4x2.png +0 -0
- package/plugin/icons/te-toca-grey-5x2.png +0 -0
- package/plugin/icons/te-toca-grey-6x2.png +0 -0
- package/plugin/icons/ticket-grey-2x1.png +0 -0
- package/plugin/icons/ticket-grey-4x2.png +0 -0
- package/plugin/icons/ticket-grey-5x2.png +0 -0
- package/plugin/icons/ticket-grey-6x2.png +0 -0
- package/plugin/icons/tiempo-grey-2x1.png +0 -0
- package/plugin/icons/tiempo-grey-4x2.png +0 -0
- package/plugin/icons/tiempo-grey-5x2.png +0 -0
- package/plugin/icons/tiempo-grey-6x2.png +0 -0
- package/plugin/icons/trofeo-grey-2x1.png +0 -0
- package/plugin/icons/trofeo-grey-4x2.png +0 -0
- package/plugin/icons/trofeo-grey-5x2.png +0 -0
- package/plugin/icons/trofeo-grey-6x2.png +0 -0
- package/plugin/skills/arena-objective/SKILL.md +0 -103
- package/plugin/skills/arena-self-review/SKILL.md +0 -217
- package/plugin/skills/arena-self-review/assets/fonts.css +0 -60
- package/plugin/skills/arena-self-review/assets/leracom-logo.png +0 -0
- package/plugin/skills/arena-self-review/assets/report.css +0 -134
- package/plugin/skills/arena-self-review/assets/style.css +0 -144
- package/plugin/skills/arena-self-review/scripts/gen-fonts.mjs +0 -56
- package/plugin/skills/arena-self-review/scripts/generate-pdf.sh +0 -162
- package/plugin/skills/arena-self-review/scripts/render-report.sh +0 -67
- package/plugin/skills/conquer/SKILL.md +0 -310
- package/plugin/skills/execution-coach/SKILL.md +0 -92
- package/plugin/skills/pr-review-loop/SKILL.md +0 -96
- package/plugin/skills/scope-technical-task/SKILL.md +0 -652
- package/plugin/tests/close.test.ts +0 -181
- package/plugin/tests/complements.test.ts +0 -82
- package/plugin/tests/format.test.ts +0 -206
- package/plugin/tests/meetings.test.ts +0 -56
- package/plugin/tests/radio.test.tsx +0 -670
- package/plugin/tests/ring-pane.test.tsx +0 -1348
- package/plugin/tests/ring.test.ts +0 -646
- package/plugin/tests/scorecard.test.tsx +0 -549
- package/plugin/tests/support/ghostty-baseline-radio.ts +0 -6
- package/plugin/tests/support/ghostty-baseline.ts +0 -8
- package/plugin/tests/support/text.ts +0 -301
- package/plugin/types/index.d.ts +0 -355
- package/pr-review-worktree.mjs +0 -56
- package/radio/package.json +0 -13
- package/radio/player.mjs +0 -214
- package/ring/.claude-plugin/plugin.json +0 -8
- package/ring/agents/cornerman.md +0 -79
- package/ring/agents/wrestler.md +0 -116
- package/ring/hooks/hooks.json +0 -82
- package/ring/scripts/chronicle.mjs +0 -433
- package/ring/scripts/config.mjs +0 -675
- package/ring/scripts/contract-preview.mjs +0 -299
- package/ring/scripts/contract.mjs +0 -156
- package/ring/scripts/copilot-review.mjs +0 -148
- package/ring/scripts/judges-card.mjs +0 -383
- package/ring/scripts/live-hook.mjs +0 -273
- package/ring/scripts/live.mjs +0 -443
- package/ring/scripts/lookout.mjs +0 -131
- package/ring/scripts/mask-guard.mjs +0 -1392
- package/ring/scripts/monitors.mjs +0 -199
- package/ring/scripts/one-at-a-time.mjs +0 -275
- package/ring/scripts/play-by-play.mjs +0 -254
- package/ring/scripts/round-bell.mjs +0 -347
- package/ring/scripts/spec-diff.mjs +0 -208
- package/ring/scripts/title-defense.mjs +0 -401
- package/ring/skills/no-surrender/SKILL.md +0 -63
- package/ring/skills/play-by-play/SKILL.md +0 -83
- package/ring/skills/play-by-play/templates/chronicle.html +0 -134
- package/ring/skills/referee/SKILL.md +0 -313
- package/ring/skills/referee/references/precedents.md +0 -105
- package/ring/skills/referee/references/rulebook.md +0 -230
- package/ring/skills/referee/templates/cornerman-batch.md +0 -15
- package/ring/skills/referee/templates/cornerman-concept.md +0 -37
- package/ring/skills/referee/templates/cornerman-range.md +0 -14
- package/ring/skills/referee/templates/escalation.md +0 -20
- package/ring/skills/referee/templates/judges-card.md +0 -46
- package/ring/skills/referee/templates/no-surrender-goal.md +0 -17
- package/ring/skills/referee/templates/rebound.md +0 -22
- package/ring/skills/referee/templates/round-bell-body.md +0 -26
- package/ring/skills/referee/templates/title-defense-catalogue.md +0 -37
- package/ring/skills/referee/templates/wrestler-brief.md +0 -54
- package/ring/skills/title-defense/SKILL.md +0 -142
- package/ring/skills/weigh-in/SKILL.md +0 -165
- package/session-start.mjs +0 -129
- package/themes/ghostty/Battle Arena +0 -25
package/README.md
CHANGED
|
@@ -1,502 +1,11 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @thebattlearena/battle-arena-hooks → Corner
|
|
2
2
|
|
|
3
|
-
Este paquete
|
|
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/
|
|
10
|
-
--url https://api.battlearena.dev --api-key <tu-llave>
|
|
6
|
+
npx @thebattlearena/corner@latest migrate
|
|
11
7
|
```
|
|
12
8
|
|
|
13
|
-
|
|
14
|
-
|
|
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`.
|