sagas/mision-calculadora-neon/002-el-escudo-del-test.md

2026-03-24 draft

EPISODIO 002 - El escudo del test

EPISODIO 002 - El escudo del test

Promesa inicial

En esta saga, el trato es claro: no entra codigo nuevo si no trae su escudo de pruebas.
El Carpincho Hacker no negocia esto, porque una IA sin validacion puede sonar brillante y romper en silencio.

Sintoma

La tentacion aparecio rapido: escribir un tokenizer “de memoria” y confiar en que “seguro funciona”.
Ese camino ya lo conocemos: demo linda, regresion fea al primer cambio.

Autopsia

Sin tests, no hay contrato explicito del comportamiento esperado.
Para 2 + 2 y 10 - 3, podiamos obtener arrays distintos, tipos inconsistentes o parseos ambiguos sin enterarnos hasta tarde.

Correccion

Se activo TDD desde la base:

  • primero tests de suma y resta en tests/tokenizer.test.mjs,
  • luego implementacion minima en src/logic/tokenizer.mjs,
  • verificacion automatica con Vitest.

El tokenizer ahora transforma expresiones como 2 + 2 en tokens seguros y deterministas:

  • { type: 'number', value: 2 }
  • { type: 'operator', value: '+' }
  • { type: 'number', value: 2 }

Leccion reusable

La IA acelera, pero el test gobierna.
Regla operativa de la bitacora: si no hay prueba, no hay confianza; si no hay confianza, no hay merge.