Skip to content

docs: comando headless de tests y contrato window.XMLShield en CLAUDE.md#10

Merged
luisfemojica merged 1 commit into
mainfrom
docs/claude-md-test-contract
Jun 18, 2026
Merged

docs: comando headless de tests y contrato window.XMLShield en CLAUDE.md#10
luisfemojica merged 1 commit into
mainfrom
docs/claude-md-test-contract

Conversation

@luisfemojica

Copy link
Copy Markdown
Owner

Qué cambia

Dos mejoras puntuales a CLAUDE.md (sin reescribir el archivo, que ya es preciso):

  1. Comando headless de tests — además del flujo en navegador (python -m http.server + abrir tests.html), se documenta cómo correr la misma suite de regresión desde la CLI con node .github/run-tests.mjs (el mismo script que usa CI).
  2. Contrato window.XMLShieldtests.html solo puede invocar funciones re-exportadas en el objeto window.XMLShield (al final del <script>, ~línea 2270). Se aclara que una función nueva que la suite necesite ejercitar debe añadirse a ese export, o el test no podrá llamarla.

Por qué

Ambos son detalles no obvios que una instancia futura tendría que redescubrir: la tabla de funciones lista internos, pero no señala cuáles son testeables, y el único comando de tests documentado era el del navegador.

Notas para el revisor

  • Solo cambia CLAUDE.md (+11 líneas), sin tocar index.html ni los tests.
  • Discrepancia detectada pero no modificada aquí: CONTRIBUTING.md aún menciona un límite obsoleto de "800 líneas"; CLAUDE.md y README.md ya coinciden en el tope vigente de ~2500 líneas / 100KB.

🤖 Generated with Claude Code

…n CLAUDE.md

Añade a CLAUDE.md el comando para correr la suite de regresión headless
desde la CLI (node .github/run-tests.mjs) y documenta que tests.html solo
puede invocar funciones re-exportadas en window.XMLShield, de modo que una
función nueva debe añadirse a ese objeto para ser testeable.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@luisfemojica luisfemojica merged commit 28fc527 into main Jun 18, 2026
1 check passed
@luisfemojica luisfemojica deleted the docs/claude-md-test-contract branch June 18, 2026 06:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant