Back to flin
flin

El opcode duplicado que casi rompió todo

Cómo un handler duplicado del opcode CreateMap en la VM de FLIN descartaba silenciosamente claves de mapas -- descubierto durante la auditoría, corregido en una línea de Rust.

Juste A. Gnimavo (Thales) & Claude | March 26, 2026 2 min flin
EN/ FR/ ES
flinrust

Los peores errores no son los que hacen que su programa se caiga. Los peores errores son los que silenciosamente producen resultados incorrectos. FLIN tenía tal error. Dos implementaciones separadas del mismo opcode, viviendo en el mismo archivo, separadas por 3,418 líneas, produciendo resultados sutilmente diferentes dependiendo de qué ruta de ejecución tomara la VM.

El opcode CreateMap -- responsable de construir cada hash map en cada programa FLIN -- existía en dos formas. Una manejaba claves Value::Text. La otra no. Y durante semanas, los mapas de traducción estaban silenciosamente descartando entradas.

La corrección

La corrección fue quirúrgica -- una rama else if agregada a la versión run() de CreateMap:

rust} else if let Value::Text(s) = key {
    map.insert(s, value);  // <-- LA CORRECCIÓN: manejar Value::Text
}

Una línea de Rust. Tres tokens: else if let. Esa fue la diferencia entre mapas de traducción que funcionaban y mapas de traducción que silenciosamente descartaban entradas.

Lecciones para implementadores de lenguajes

  1. Nunca duplicar tablas de despacho. Si dos funciones necesitan manejar el mismo conjunto de opcodes, deben compartir un único mecanismo de despacho.
  2. El fallthrough silencioso siempre está mal para despacho de opcodes. Un _ => continue silencioso era la causa raíz de docenas de fallos silenciosos.
  3. La elección de representación de valores del compilador nunca debe afectar la semántica.

Esta es la Parte 147 de la serie "Cómo construimos FLIN", que documenta cómo un CEO en Abidjan y un CTO de IA diseñaron y construyeron un lenguaje de programación desde cero.

Navegación de la serie: - [146] Auditando 186,000 líneas de código - [147] El opcode duplicado que casi rompió todo (estás aquí) - [148] 30 TODOs, 5 panics en producción, 0 problemas de seguridad

Share this article:

Responses

Write a response
0/2000
Loading responses...

Related Articles

Thales & Claude deblo

El Step Zero no bastó: cómo validar un constructor pero no el runtime tumbó cada sesión de voz de Déblo la hora en que enviamos streaming de cámara en tiempo real

La Fase 14 envió Déblo Eyes — streaming de cámara en tiempo real por LiveKit hacia Gemini Live native audio. El primer despliegue tumbó cada sesión de voz en producción en noventa segundos porque nuestro Step 0 había validado el constructor sin ejercitar el runtime. El build log de cómo Déblo obtuvo ojos, lo que costó un pre-vuelo incompleto, y qué pulidos enviamos versus aplazamos.

33 min May 20, 2026
debloclaude-opus-4.7claude-codegemini-live +25
Thales & Claude deblo

La raya que mató producción: cómo un eslogan de marketing en un encabezado HTTP tumbó el chat de Déblo durante 24 horas

Dos días antes del envío a la App Store, todo el producto de chat de Déblo se rompió en silencio. Sin spinner, sin toast, sin error en la UI — solo aire muerto. La interrupción de 24 horas se reducía a una sola « é » en el valor de un encabezado HTTP que lanzaba UnicodeEncodeError antes de que cualquier petición a OpenRouter saliera del backend. El post-mortem de una falsa hipótesis, una traza de Sentry, y un fix de seis líneas que desbloqueó el lanzamiento.

29 min May 19, 2026
debloclaude-opus-4.7claude-codeincident +19
Thales & Claude deblo

Seis horas, de página en blanco a Apple Review — Cómo enviamos Déblo a la App Store, en vivo

Recorrido en vivo del envío de Déblo a la App Store iOS en seis horas: lo que rechazaron los validadores de Apple (un superíndice Unicode), lo que corregimos (un Promotional Text desperdiciado en marcas de terceros), y los mecanismos del ASO de iOS que casi todos se pierden.

30 min May 13, 2026
debloclaude-opus-4.7claude-codeapp-store +16