Un cliente recibe maxRetries: 0 y, tras un error de red, vuelve a enviar la petición dos veces. El encargo para el agente es cumplir la condición «Un cero desactiva los reintentos. Si se omite el límite, el cliente conserva sus dos reintentos». Ya sabemos qué debe demostrar la prueba. Queda por localizar el código responsable.
Del requisito al archivo
El modelo recibe el encargo y las descripciones de las herramientas disponibles. Puede pedir una búsqueda con rg -n 'maxRetries'. El programa que dirige la sesión, el harness, ejecuta el comando autorizado en el directorio de trabajo y devuelve las coincidencias. Con esas líneas, el modelo puede elegir qué función leer. Más adelante, un fallo en las pruebas puede cambiar su siguiente decisión. Funcionamiento de Claude Code
Cada harness responde a unas condiciones de trabajo. Pi ofrece un SDK para integrarlo en una aplicación, mientras que Codex Cloud prepara un entorno remoto para las tareas delegadas. En ambos casos, quien revise el cambio necesita saber qué versión del repositorio se modificó y qué comprobaciones se ejecutaron allí.
Reproducir los intentos de más
Este es el módulo delivery.mjs completo del ejemplo. Cuando el envío funciona, devuelve el resultado de inmediato. Tras un fallo, compara los reintentos ya consumidos con el límite configurado.
export async function deliver(send, { maxRetries } = {}) {
const limit = maxRetries || 2;
for (let used = 0; ; used++) {
try {
return await send();
} catch (error) {
if (used >= limit) throw error;
}
}
}
En delivery.test.mjs sustituimos la operación de red por una función que cuenta las llamadas y siempre lanza un error. El contador muestra cuántas veces se intentó el envío. Además del cero, cubrimos el límite omitido y un único reintento permitido.
import assert from 'node:assert/strict';
import test from 'node:test';
import { deliver } from './delivery.mjs';
for (const [options, expected] of [
[{}, 3],
[{ maxRetries: 0 }, 1],
[{ maxRetries: 1 }, 2],
]) {
test(JSON.stringify(options), async () => {
let calls = 0;
const send = async () => {
calls++;
throw new Error('offline');
};
await assert.rejects(deliver(send, options), /offline/);
assert.equal(calls, expected);
});
}
Con la implementación inicial, node --test delivery.test.mjs detecta un fallo. Al pasar un límite de cero, el contador llega a 3 y el contrato exige 1. Los otros dos casos pasan. Si se desactivaran los reintentos para todos los clientes, fallarían ambos.
Por qué basta con cambiar una línea
El operador || de maxRetries || 2 evalúa el cero como falso y elige dos. Con ??, el valor por defecto solo se aplica a undefined o null. Un cero explícito conserva su valor. Especificación de ECMAScript
- const limit = maxRetries || 2;
+ const limit = maxRetries ?? 2;
Tras el cambio, el mismo comando pasa los tres casos. Si la operación falla siempre, omitir el límite produce tres llamadas, un cero produce una y un reintento permitido produce dos. Los dos archivos anteriores permiten reproducir el resultado.
Al revisar el diff conviene comprobar cómo trata la API pública un null explícito. Si el contrato exige rechazarlo, hay que verificarlo al validar la entrada. Las tres pruebas demuestran el número de intentos para las configuraciones que reciben. La regla sobre null necesita su propia prueba.