@nac3/forge-cli 1.24.1 → 1.26.0

package/dist/telemetry/usage.js

@@ -29,11 +29,20 @@
  */
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
+import os from 'node:os';
 import { configDir } from '../license/index.js';
 /* Defaults reflect early-2026 Anthropic + Google Cloud pricing.
  * Users can override via ~/.yujin-forge/pricing.json. */
 export const DEFAULT_PRICING = {
     models: {
+        /* Linea vigente al 2026-11-03. Faltaba entera, y sin fila el evento se
+         * valuaba en CERO: el reporte decia que una sesion de Opus 5 no habia
+         * costado nada (PND-273). */
+        'claude-fable-5-1': { in_per_mtok: 10, out_per_mtok: 50 },
+        'claude-fable-5': { in_per_mtok: 10, out_per_mtok: 50 },
+        'claude-opus-5': { in_per_mtok: 5, out_per_mtok: 25 },
+        'claude-opus-4-8': { in_per_mtok: 5, out_per_mtok: 25 },
+        'claude-sonnet-5': { in_per_mtok: 2, out_per_mtok: 10 },
         'claude-opus-4-7': { in_per_mtok: 15, out_per_mtok: 75 },
         'claude-opus-4': { in_per_mtok: 15, out_per_mtok: 75 },
         'claude-sonnet-4-6': { in_per_mtok: 3, out_per_mtok: 15 },
@@ -47,27 +56,150 @@ export const DEFAULT_PRICING = {
         tts_per_million_chars: 16, /* Google Cloud TTS Neural2 */
         stt_per_minute: 0.006, /* Google Cloud STT enhanced */
     },
+    cache: {
+        read_multiplier: 0.10,
+        write_5m_multiplier: 1.25,
+        write_1h_multiplier: 2.00,
+    },
 };
-function usageFile() {
-    return path.join(configDir(), 'usage.jsonl');
+/** Normalizar el id de modelo para buscarlo en la tabla de precios.
+ *
+ *  POR QUE (PND-273): el camino CLI informa el id con la fecha pegada
+ *  ("claude-haiku-4-5-20251001"), y la busqueda era exacta, asi que NINGUN
+ *  turno del camino CLI encontraba su fila y todos se valuaban en cero. La
+ *  fecha no cambia el precio: se saca antes de buscar. */
+export function normaliseModelId(model) {
+    return String(model || '').replace(/-20\d{6}$/, '');
 }
-function pricingFile() {
-    return path.join(configDir(), 'pricing.json');
+function priceFor(pricing, model) {
+    const m = pricing.models ?? {};
+    return m[model] ?? m[normaliseModelId(model)];
 }
-async function ensureDir() {
-    try {
-        await fs.mkdir(configDir(), { recursive: true });
+/** Valuar la ENTRADA de un evento en dolares.
+ *
+ *  Con desglose: cada componente a su multiplicador. Sin desglose (eventos
+ *  viejos): `tokens_in` a precio base, que es lo unico que se sabe de ellos
+ *  -- y se declara como tal en el reporte para que nadie compare peras con
+ *  manzanas. */
+export function inputUsd(ev, base_per_mtok, cache) {
+    const tieneDesglose = typeof ev.tokens_fresh === 'number'
+        || typeof ev.tokens_cache_write === 'number'
+        || typeof ev.tokens_cache_read === 'number';
+    if (!tieneDesglose) {
+        return ((ev.tokens_in ?? 0) / 1_000_000) * base_per_mtok;
+    }
+    const mulLectura = cache?.read_multiplier ?? 0.10;
+    const mulEscritura = ev.cache_ttl === '1h'
+        ? (cache?.write_1h_multiplier ?? 2.00)
+        : (cache?.write_5m_multiplier ?? 1.25);
+    const porMtok = base_per_mtok / 1_000_000;
+    return (ev.tokens_fresh ?? 0) * porMtok
+        + (ev.tokens_cache_write ?? 0) * porMtok * mulEscritura
+        + (ev.tokens_cache_read ?? 0) * porMtok * mulLectura;
+}
+/** La bateria NO escribe en la telemetria del dueno.
+ *
+ *  MEDIDO AL CABLEAR EL DESGLOSE (2026-11-03, PND-273): de los 9.062
+ *  eventos de la ventana de 30 dias en el usage.jsonl de la maquina, 2.347
+ *  -- el 26% -- tenian modelo "claude", "m" o "claude-test", con marca de
+ *  tiempo exacta de las corridas de la bateria de hoy. Son los tests que
+ *  ejercitan ClaudeClient con un fetch falso y no aislan YF_CONFIG_DIR:
+ *  recordUsage les escribe en el archivo real.
+ *
+ *  Por que importa y no es cosmetico: este archivo es la unica fuente del
+ *  reporte de costos, y el reporte es lo que acaba de volverse exacto. Una
+ *  bateria que le mete un cuarto de los eventos lo vuelve inexacto de
+ *  nuevo, por otra puerta -- y los eventos de test valen cero dolares, asi
+ *  que bajan el promedio y hacen parecer mas barato de lo que es.
+ *
+ *  Por que se frena ACA y no moviendo YF_CONFIG_DIR para toda la bateria:
+ *  mover la config entera es un override ANCHO, y este repositorio ya tiene
+ *  la cicatriz de uno (src/chat/instance_lock.ts: "un override angosto es
+ *  el arreglo; uno ancho era el bug"). Hay tests que SI necesitan la config
+ *  real. La telemetria, en cambio, no es nunca lo que un test afirma: el
+ *  que mide costos se arma su propio YF_CONFIG_DIR, y ahi esta funcion no
+ *  se niega -- solo se niega al archivo de la MAQUINA.
+ *
+ *  Un test que quiera verificar el recibo pone su YF_CONFIG_DIR y sigue
+ *  andando, que es como esta escrito tests/cache-ttl-y-desglose.test.ts. */
+export function telemetryWritesAllowed(env = process.env) {
+    return usageDestination(env).allowed;
+}
+/** La carpeta de configuracion de la MAQUINA: la del dueno, la que ningun
+ *  test puede tocar. Se calcula aparte de configDir() a proposito -- hace
+ *  falta poder comparar el destino CONTRA ella. */
+function carpetaDeLaMaquina(env = process.env) {
+    const home = env['USERPROFILE'] || env['HOME'] || os.homedir();
+    return path.join(home, '.yujin-forge');
+}
+function mismaCarpeta(a, b) {
+    const n = (x) => path.resolve(x).replace(/[\\/]+$/, '').toLowerCase();
+    return n(a) === n(b);
+}
+/**
+ * EL DESTINO DEL RECIBO, DECIDIDO DE UNA SOLA VEZ Y SIN AWAITS EN EL MEDIO.
+ *
+ * MEDIDO EL 2026-11-03, DESPUES DE DECLARAR ESTO ARREGLADO (y por eso esta
+ * escrito aca y no solo en un commit). La guarda de arriba, sola, NO
+ * alcanzaba: la bateria completa de 5.777 pruebas siguio escribiendo CUATRO
+ * eventos en el usage.jsonl del dueno. La causa es una carrera, no un
+ * permiso:
+ *
+ *   1. el test pone YF_CONFIG_DIR y llama al cliente;
+ *   2. el cliente hace `void recordUsage(...)` -- no lo espera;
+ *   3. recordUsage pasa la guarda (YF_CONFIG_DIR esta puesto) y se duerme
+ *      en el primer await;
+ *   4. el test termina, su afterEach BORRA YF_CONFIG_DIR y borra el tmp;
+ *   5. recien ahi recordUsage despierta, llama usageFile() -> configDir()
+ *      -- que lee el entorno DE NUEVO, y ya no esta -- y appendea en
+ *      ~/.yujin-forge/usage.jsonl.
+ *
+ * La guarda miraba el entorno en el momento correcto; el PATH se resolvia
+ * en otro. Dos lecturas del mismo entorno en dos instantes distintos es la
+ * forma general del defecto, y por eso el arreglo no es mover la guarda:
+ * es resolver el destino COMPLETO antes del primer await y no volver a
+ * mirar el entorno en esa llamada.
+ *
+ * Y fail-closed: dentro de la bateria se niega TAMBIEN cuando el
+ * YF_CONFIG_DIR declarado apunta a la carpeta de la maquina. Si alguien
+ * vuelve a introducir una lectura tardia del entorno, el peor caso es que
+ * un recibo se pierda en un test, no que contamine la unica medicion de
+ * costo honesta que hay.
+ */
+export function usageDestination(env = process.env) {
+    const override = env['YF_CONFIG_DIR'];
+    const tiene = typeof override === 'string' && override.trim() !== '';
+    const dir = tiene ? override.trim() : carpetaDeLaMaquina(env);
+    const enBateria = env['VITEST'] === 'true' || env['VITEST'] === '1';
+    if (enBateria) {
+        if (!tiene) {
+            return { allowed: false, why: 'bateria sin YF_CONFIG_DIR: el recibo iria al archivo del dueno' };
+        }
+        if (mismaCarpeta(dir, carpetaDeLaMaquina(env))) {
+            return { allowed: false, why: 'bateria con YF_CONFIG_DIR apuntando a la carpeta de la maquina (' + dir + ')' };
+        }
     }
-    catch { /* best effort */ }
+    return { allowed: true, dir, file: path.join(dir, 'usage.jsonl') };
+}
+function pricingFile() {
+    return path.join(configDir(), 'pricing.json');
 }
 /**
  * Append a usage event. Never throws -- failures swallowed.
  */
 export async function recordUsage(ev) {
     try {
-        await ensureDir();
+        /* Primero el destino, y de aca en adelante NO se vuelve a leer el
+         * entorno: ver usageDestination(). */
+        const destino = usageDestination();
+        if (!destino.allowed || !destino.file || !destino.dir)
+            return;
         const line = { ts: ev.ts ?? new Date().toISOString(), ...ev };
-        await fs.appendFile(usageFile(), JSON.stringify(line) + '\n', 'utf-8');
+        try {
+            await fs.mkdir(destino.dir, { recursive: true });
+        }
+        catch { /* best effort */ }
+        await fs.appendFile(destino.file, JSON.stringify(line) + '\n', 'utf-8');
     }
     catch {
         /* swallow -- telemetry must never break user flow */
@@ -83,6 +215,7 @@ export async function loadPricing() {
         return {
             models: { ...(DEFAULT_PRICING.models ?? {}), ...(override.models ?? {}) },
             voice: { ...(DEFAULT_PRICING.voice ?? {}), ...(override.voice ?? {}) },
+            cache: { ...(DEFAULT_PRICING.cache ?? {}), ...(override.cache ?? {}) },
         };
     }
     catch {
@@ -94,7 +227,9 @@ export async function loadPricing() {
  */
 export async function readUsage() {
     try {
-        const raw = await fs.readFile(usageFile(), 'utf-8');
+        /* La LECTURA no pasa por usageDestination(): leer el archivo del dueno
+         * no lo contamina, y un reporte de costos tiene que poder leerlo. */
+        const raw = await fs.readFile(path.join(configDir(), 'usage.jsonl'), 'utf-8');
         return raw.split('\n')
             .filter((l) => l.trim().length > 0)
             .map((l) => {
@@ -129,6 +264,7 @@ export async function computeCosts(sinceDays = 30) {
         events_total: events.length,
         events_window: inWindow.length,
         window_label: sinceDays === 0 ? 'all-time' : 'last ' + sinceDays + ' days',
+        input: { fresh: 0, cache_write: 0, cache_read: 0, cache_write_1h: 0, events_sin_desglose: 0 },
         subscription: { events: 0, tokens_in: 0, tokens_out: 0 },
     };
     for (const ev of inWindow) {
@@ -143,9 +279,25 @@ export async function computeCosts(sinceDays = 30) {
         }
         if (ev.kind.startsWith('claude.')) {
             const m = ev.model ?? 'unknown';
-            const p = pricing.models?.[m];
+            const p = priceFor(pricing, m);
+            /* El desglose se acumula para TODOS los eventos de modelo, incluidos
+             * los de suscripcion: ahi no hay dolares pero si hay consumo del plan,
+             * y la re-escritura de cache lo quema igual. */
+            const tieneDesglose = typeof ev.tokens_fresh === 'number'
+                || typeof ev.tokens_cache_write === 'number'
+                || typeof ev.tokens_cache_read === 'number';
+            if (tieneDesglose) {
+                breakdown.input.fresh += ev.tokens_fresh ?? 0;
+                breakdown.input.cache_write += ev.tokens_cache_write ?? 0;
+                breakdown.input.cache_read += ev.tokens_cache_read ?? 0;
+                if (ev.cache_ttl === '1h')
+                    breakdown.input.cache_write_1h += ev.tokens_cache_write ?? 0;
+            }
+            else {
+                breakdown.input.events_sin_desglose += 1;
+            }
             if (p && !bySubscription) {
-                usd = ((ev.tokens_in ?? 0) / 1_000_000) * p.in_per_mtok
+                usd = inputUsd(ev, p.in_per_mtok, pricing.cache)
                     + ((ev.tokens_out ?? 0) / 1_000_000) * p.out_per_mtok;
             }
             if (!breakdown.by_model[m]) {
@@ -186,6 +338,27 @@ export function formatCosts(b) {
     lines.push('Events total:    ' + b.events_total);
     lines.push('Events in window:' + b.events_window);
     lines.push('Total USD:       $' + b.total_usd.toFixed(4));
+    /* El desglose de la entrada, que es lo que hace comparable el numero de
+     * arriba: tres componentes con precios que difieren doce veces. */
+    const inTot = b.input.fresh + b.input.cache_write + b.input.cache_read;
+    if (inTot > 0) {
+        const pct = (n) => (inTot > 0 ? (100 * n / inTot).toFixed(0) : '0') + '%';
+        lines.push('Entrada:         ' + inTot + ' tokens'
+            + '  frescos=' + b.input.fresh + ' (' + pct(b.input.fresh) + ', 1x)'
+            + '  cache escrita=' + b.input.cache_write + ' (' + pct(b.input.cache_write) + ', '
+            + (b.input.cache_write_1h > 0 ? '1,25x/2x' : '1,25x') + ')'
+            + '  cache leida=' + b.input.cache_read + ' (' + pct(b.input.cache_read) + ', 0,10x)');
+        if (b.input.cache_write > b.input.cache_read && b.input.cache_read > 0) {
+            lines.push('                 AVISO: se escribio a la cache MAS de lo que se leyo. '
+                + 'Un prefijo que se re-escribe en vez de leerse paga hasta 20 veces de mas; '
+                + 'ver src/chat/cache_ttl.ts.');
+        }
+    }
+    if (b.input.events_sin_desglose > 0) {
+        lines.push('                 ' + b.input.events_sin_desglose
+            + ' evento(s) sin desglose (anteriores al cambio): valuados a precio base '
+            + 'sobre el total de entrada, asi que su costo es un PISO, no el exacto.');
+    }
     if (b.subscription.events > 0) {
         /* Lo que se consumio del plan, dicho aparte: no es dinero, es cuota. */
         lines.push('Suscripcion:     ' + b.subscription.events + ' turnos, '

package/dist/telemetry/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/telemetry/usage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/telemetry/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAsEhD;yDACyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,MAAM,EAAE;QACN;;qCAE6B;QAC7B,kBAAkB,EAAW,EAAE,WAAW,EAAE,EAAE,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,gBAAgB,EAAa,EAAE,WAAW,EAAE,EAAE,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,eAAe,EAAc,EAAE,WAAW,EAAG,CAAC,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,iBAAiB,EAAY,EAAE,WAAW,EAAG,CAAC,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,iBAAiB,EAAY,EAAE,WAAW,EAAG,CAAC,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,iBAAiB,EAAY,EAAE,WAAW,EAAE,EAAE,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,eAAe,EAAc,EAAE,WAAW,EAAE,EAAE,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,mBAAmB,EAAU,EAAE,WAAW,EAAG,CAAC,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,iBAAiB,EAAY,EAAE,WAAW,EAAG,CAAC,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,kBAAkB,EAAW,EAAE,WAAW,EAAG,CAAC,EAAG,YAAY,EAAG,CAAC,EAAE;QACnE,wCAAwC;QACxC,mBAAmB,EAAU,EAAE,WAAW,EAAG,CAAC,EAAG,YAAY,EAAE,EAAE,EAAE;QACnE,kBAAkB,EAAW,EAAE,WAAW,EAAG,GAAG,EAAC,YAAY,EAAG,CAAC,EAAE;KACpE;IACD,KAAK,EAAE;QACL,qBAAqB,EAAE,EAAE,EAAI,8BAA8B;QAC3D,cAAc,EAAS,KAAK,EAAC,+BAA+B;KAC7D;IACD,KAAK,EAAE;QACL,eAAe,EAAM,IAAI;QACzB,mBAAmB,EAAE,IAAI;QACzB,mBAAmB,EAAE,IAAI;KAC1B;CACF,CAAC;AAEF;;;;;0DAK0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,QAAQ,CAAC,OAAqB,EAAE,KAAa;IACpD,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IAC/B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;;gBAKgB;AAChB,MAAM,UAAU,QAAQ,CACtB,EAA6G,EAC7G,aAAqB,EACrB,KAA4B;IAE5B,MAAM,aAAa,GAAG,OAAO,EAAE,CAAC,YAAY,KAAK,QAAQ;WACpD,OAAO,EAAE,CAAC,kBAAkB,KAAK,QAAQ;WACzC,OAAO,EAAE,CAAC,iBAAiB,KAAK,QAAQ,CAAC;IAC9C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,aAAa,CAAC;IAC3D,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,EAAE,eAAe,IAAI,IAAI,CAAC;IAClD,MAAM,YAAY,GAAG,EAAE,CAAC,SAAS,KAAK,IAAI;QACxC,CAAC,CAAC,CAAC,KAAK,EAAE,mBAAmB,IAAI,IAAI,CAAC;QACtC,CAAC,CAAC,CAAC,KAAK,EAAE,mBAAmB,IAAI,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,aAAa,GAAG,SAAS,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,YAAY,IAAU,CAAC,CAAC,GAAG,OAAO;UACtC,CAAC,EAAE,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,OAAO,GAAG,YAAY;UACrD,CAAC,EAAE,CAAC,iBAAiB,IAAK,CAAC,CAAC,GAAG,OAAO,GAAG,UAAU,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;4EAwB4E;AAC5E,MAAM,UAAU,sBAAsB,CACpC,MAA0C,OAAO,CAAC,GAAG;IAErD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;AACvC,CAAC;AAED;;mDAEmD;AACnD,SAAS,kBAAkB,CAAC,MAA0C,OAAO,CAAC,GAAG;IAC/E,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACxC,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9E,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IACrE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,QAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC;IACpE,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,gEAAgE,EAAE,CAAC;QACnG,CAAC;QACD,IAAI,YAAY,CAAC,GAAG,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,kEAAkE,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;QACjH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAA4C;IAC5E,IAAI,CAAC;QACH;8CACsC;QACtC,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG;YAAE,OAAO;QAC9D,MAAM,IAAI,GAAe,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1E,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACrF,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;QACjD,OAAO;YACL,MAAM,EAAE,EAAE,GAAG,CAAC,eAAe,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE;YACzE,KAAK,EAAG,EAAE,GAAG,CAAC,eAAe,CAAC,KAAK,IAAK,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAK,EAAE,CAAC,EAAE;YACzE,KAAK,EAAG,EAAE,GAAG,CAAC,eAAe,CAAC,KAAK,IAAK,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAK,EAAE,CAAC,EAAE;SAC1E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,CAAC;QACH;6EACqE;QACrE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9E,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;aACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,IAAI,CAAC;gBAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAe,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;QACpE,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AA2BD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAS,GAAG,EAAE;IAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;IAEpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC;IAEpE,MAAM,SAAS,GAAkB;QAC/B,SAAS,EAAK,CAAC;QACf,OAAO,EAAO,EAAE;QAChB,QAAQ,EAAM,EAAE;QAChB,MAAM,EAAQ,EAAE;QAChB,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,aAAa,EAAC,QAAQ,CAAC,MAAM;QAC7B,YAAY,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,OAAO;QAC1E,KAAK,EAAS,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE;QACpG,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;KACzD,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ;gEACwD;QACxD,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,KAAK,cAAc,CAAC;QACrD,IAAI,cAAc,EAAE,CAAC;YACnB,SAAS,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC;YACnC,SAAS,CAAC,YAAY,CAAC,SAAS,IAAK,EAAE,CAAC,SAAS,IAAK,CAAC,CAAC;YACxD,SAAS,CAAC,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,SAAS,CAAC;YAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC/B;;4DAEgD;YAChD,MAAM,aAAa,GAAG,OAAO,EAAE,CAAC,YAAY,KAAK,QAAQ;mBACpD,OAAO,EAAE,CAAC,kBAAkB,KAAK,QAAQ;mBACzC,OAAO,EAAE,CAAC,iBAAiB,KAAK,QAAQ,CAAC;YAC9C,IAAI,aAAa,EAAE,CAAC;gBAClB,SAAS,CAAC,KAAK,CAAC,KAAK,IAAU,EAAE,CAAC,YAAY,IAAU,CAAC,CAAC;gBAC1D,SAAS,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,kBAAkB,IAAI,CAAC,CAAC;gBAC1D,SAAS,CAAC,KAAK,CAAC,UAAU,IAAK,EAAE,CAAC,iBAAiB,IAAK,CAAC,CAAC;gBAC1D,IAAI,EAAE,CAAC,SAAS,KAAK,IAAI;oBAAE,SAAS,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,kBAAkB,IAAI,CAAC,CAAC;YAC1F,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACzB,GAAG,GAAG,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC;sBAC1C,CAAC,CAAC,EAAE,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC;YAC5D,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YAC5E,CAAC;YACD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;YACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,IAAK,EAAE,CAAC,SAAS,IAAK,CAAC,CAAC;YACtC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,GAAG,IAAW,GAAG,CAAC;QACzB,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACnC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,IAAI,CAAC,CAAC,CAAC;QACpF,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACnC,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,SAAS,CAAC,SAAS,IAAI,GAAG,CAAC;QAE3B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACnF,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAE,CAAC,KAAK,EAAE,CAAC;QACpC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAE,CAAC,GAAG,IAAI,GAAG,CAAC;QAEvC,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACzE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC,KAAK,EAAE,CAAC;QAC/B,SAAS,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC,GAAG,IAAI,GAAG,CAAC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAgB;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D;uEACmE;IACnE,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IACvE,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1F,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,KAAK,GAAG,SAAS;cAC9C,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO;cAClE,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI;cACjF,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,GAAG;cACzD,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC;QACzF,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACvE,KAAK,CAAC,IAAI,CAAC,wEAAwE;kBAC/E,4EAA4E;kBAC5E,4BAA4B,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,mBAAmB;cACxD,yEAAyE;cACzE,uEAAuE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,wEAAwE;QACxE,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,WAAW;cAChE,CAAC,CAAC,YAAY,CAAC,SAAS,GAAG,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC,UAAU;cACrE,gDAAgD,CAAC,CAAC;IACxD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5E,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1G,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9E,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;kBACjB,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;kBACtC,OAAO,GAAI,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;kBAC1C,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;kBAC3C,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1F,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/urazuke/close_gate.d.ts

@@ -51,9 +51,53 @@ export declare function evidenceForClose(slug: string, pending_id: string, opts?
  *  resolverla falla) rige la compilada: una compuerta que no puede leer su
  *  regla no se queda sin regla. */
 export declare function closeRuleInForce(projectRoot?: string): Promise<UrazukeCloseRule>;
-/** Does the evidence gate apply to this item? Only inside an open Urazuke
- *  workflow, only for plan items (not the ladder's own canonical tasks,
- *  which have the artifact gate instead), only for reason=shipped. */
+/**
+ * PND-260 -- LA TERNA DE RECIBOS SE EXIGE EN TODO CIERRE CON `shipped`,
+ * NO SOLO DENTRO DE UN PROYECTO URAZUKE.
+ *
+ * Lo que habia: `evidenceGateApplies` (abajo) limitaba la exigencia a un
+ * proyecto con instancia Urazuke abierta. Fuera de eso, `pending.close` con
+ * `shipped` exigia `functional` y `use_cases`, y PEDIA POR DESCRIPCION
+ * `tests_status` y `commit` -- en el texto del error. El resultado medido
+ * (experimento A/B, peldano 13): un item cerrado con `shipped`, un
+ * `functional` largo, un caso de uso y CERO recibos, y el verbo no dijo nada.
+ * El propio comentario de esa funcion enuncia el principio que no se estaba
+ * aplicando a los recibos: "Si el dato importa, el verbo tiene que negarse
+ * sin el".
+ *
+ * Asi que la exigencia es universal, y la escapatoria es declarada: cuando la
+ * terna no esta, quien cierra escribe `sin_recibos_porque` EN EL MOMENTO. La
+ * excepcion legitima existe (un peldano sin bateria todavia, un cambio que no
+ * es de codigo) y lo que se gana es que quede escrita por quien sabia, en vez
+ * de reconstruida por un auditor cuatro semanas despues.
+ *
+ * NO aplica a las tareas canonicas de la escalera: esas tienen la compuerta
+ * de artefactos (evaluateStep), que es otra y mas fuerte.
+ */
+export declare function receiptsRequiredForShipped(item: {
+    workflow?: {
+        urazuke?: unknown;
+        ad_hoc?: boolean;
+    };
+}, reason: string): boolean;
+/** El minimo del motivo escrito. Mismo criterio que FUNCTIONAL_MIN: lo
+ *  bastante para que no pase un "no hay", lo bastante poco para que una
+ *  linea honesta alcance. */
+export declare const SIN_RECIBOS_MIN = 25;
+/** Valida la escapatoria. Devuelve el problema, o null si sirve. */
+export declare function evidenceEscapeProblem(reason: unknown): string | null;
+/** Does the STRICT evidence gate apply to this item? Only inside an open
+ *  Urazuke workflow, only for plan items (not the ladder's own canonical
+ *  tasks, which have the artifact gate instead), only for reason=shipped.
+ *
+ *  LA DIFERENCIA CON `receiptsRequiredForShipped` ES LA ESCAPATORIA, Y ES
+ *  DELIBERADA (PND-260, 2026-11-02). Donde este gate estricto rige, la unica
+ *  salida sigue siendo `force_reason` + `force_kind`, que son DEL DUENO y
+ *  quedan contables en el reporte. `sin_recibos_porque` la escribe el agente,
+ *  asi que aceptarla aca seria regalarle al agente un bypass de una compuerta
+ *  disenada precisamente para negarselo. Fuera del gate estricto no habia
+ *  NINGUNA exigencia, asi que ahi la escapatoria del agente es una mejora
+ *  estricta sobre el silencio. */
 export declare function evidenceGateApplies(slug: string, item: {
     workflow?: {
         urazuke?: unknown;

package/dist/urazuke/close_gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close_gate.d.ts","sourceRoot":"","sources":["../../src/urazuke/close_gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAChG;;0EAEkE;QAClE,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;kDAiBkD;AAClD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAChC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;CAAO,GAC3D,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AAED;;mCAEmC;AACnC,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQtF;AAED;;sEAEsE;AACtE,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtJ"}
+{"version":3,"file":"close_gate.d.ts","sourceRoot":"","sources":["../../src/urazuke/close_gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAChG;;0EAEkE;QAClE,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;kDAiBkD;AAClD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAChC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;CAAO,GAC3D,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AAED;;mCAEmC;AACnC,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQtF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAC3E,OAAO,CAIT;AAED;;6BAE6B;AAC7B,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQpE;AAED;;;;;;;;;;;kCAWkC;AAClC,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtJ"}

package/dist/urazuke/close_gate.js

@@ -84,9 +84,63 @@ export async function closeRuleInForce(projectRoot) {
         return COMPILED_CLOSE_RULE;
     }
 }
-/** Does the evidence gate apply to this item? Only inside an open Urazuke
- *  workflow, only for plan items (not the ladder's own canonical tasks,
- *  which have the artifact gate instead), only for reason=shipped. */
+/**
+ * PND-260 -- LA TERNA DE RECIBOS SE EXIGE EN TODO CIERRE CON `shipped`,
+ * NO SOLO DENTRO DE UN PROYECTO URAZUKE.
+ *
+ * Lo que habia: `evidenceGateApplies` (abajo) limitaba la exigencia a un
+ * proyecto con instancia Urazuke abierta. Fuera de eso, `pending.close` con
+ * `shipped` exigia `functional` y `use_cases`, y PEDIA POR DESCRIPCION
+ * `tests_status` y `commit` -- en el texto del error. El resultado medido
+ * (experimento A/B, peldano 13): un item cerrado con `shipped`, un
+ * `functional` largo, un caso de uso y CERO recibos, y el verbo no dijo nada.
+ * El propio comentario de esa funcion enuncia el principio que no se estaba
+ * aplicando a los recibos: "Si el dato importa, el verbo tiene que negarse
+ * sin el".
+ *
+ * Asi que la exigencia es universal, y la escapatoria es declarada: cuando la
+ * terna no esta, quien cierra escribe `sin_recibos_porque` EN EL MOMENTO. La
+ * excepcion legitima existe (un peldano sin bateria todavia, un cambio que no
+ * es de codigo) y lo que se gana es que quede escrita por quien sabia, en vez
+ * de reconstruida por un auditor cuatro semanas despues.
+ *
+ * NO aplica a las tareas canonicas de la escalera: esas tienen la compuerta
+ * de artefactos (evaluateStep), que es otra y mas fuerte.
+ */
+export function receiptsRequiredForShipped(item, reason) {
+    if (reason !== 'shipped')
+        return false;
+    if (item.workflow?.urazuke && !item.workflow.ad_hoc)
+        return false;
+    return true;
+}
+/** El minimo del motivo escrito. Mismo criterio que FUNCTIONAL_MIN: lo
+ *  bastante para que no pase un "no hay", lo bastante poco para que una
+ *  linea honesta alcance. */
+export const SIN_RECIBOS_MIN = 25;
+/** Valida la escapatoria. Devuelve el problema, o null si sirve. */
+export function evidenceEscapeProblem(reason) {
+    const t = typeof reason === 'string' ? reason.trim() : '';
+    if (!t)
+        return 'falta `sin_recibos_porque`';
+    if (t.length < SIN_RECIBOS_MIN) {
+        return '`sin_recibos_porque` tiene ' + t.length + ' caracteres y el minimo es ' + SIN_RECIBOS_MIN
+            + ': hace falta el motivo, no una palabra';
+    }
+    return null;
+}
+/** Does the STRICT evidence gate apply to this item? Only inside an open
+ *  Urazuke workflow, only for plan items (not the ladder's own canonical
+ *  tasks, which have the artifact gate instead), only for reason=shipped.
+ *
+ *  LA DIFERENCIA CON `receiptsRequiredForShipped` ES LA ESCAPATORIA, Y ES
+ *  DELIBERADA (PND-260, 2026-11-02). Donde este gate estricto rige, la unica
+ *  salida sigue siendo `force_reason` + `force_kind`, que son DEL DUENO y
+ *  quedan contables en el reporte. `sin_recibos_porque` la escribe el agente,
+ *  asi que aceptarla aca seria regalarle al agente un bypass de una compuerta
+ *  disenada precisamente para negarselo. Fuera del gate estricto no habia
+ *  NINGUNA exigencia, asi que ahi la escapatoria del agente es una mejora
+ *  estricta sobre el silencio. */
 export async function evidenceGateApplies(slug, item, reason) {
     if (reason !== 'shipped')
         return false;

package/dist/urazuke/close_gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"close_gate.js","sourceRoot":"","sources":["../../src/urazuke/close_gate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"close_gate.js","sourceRoot":"","sources":["../../src/urazuke/close_gate.ts"],"names":[],"mappings":"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"}

package/dist/urazuke/evidence.d.ts

@@ -21,6 +21,11 @@ export interface RunEvidenceInput {
      *  the receipt. For the first block of a new project, where the previous
      *  version does not even have the module. */
     mutation_diff?: string;
+    /** PND-127 -- 'exit_code' declara que el comando NO es un runner de
+     *  tests (un escaneo, un verificador) y que su exit code es toda la
+     *  evidencia. Viaja tal cual al recibo: es una declaracion del autor y
+     *  tiene que quedar auditable ahi, no inferirse al leer. */
+    evidence?: 'tests' | 'exit_code';
     note?: string;
 }
 export interface RunEvidenceResult {
@@ -28,6 +33,11 @@ export interface RunEvidenceResult {
     /** For red_proof: the worktree was created at this path (already removed). */
     worktree?: string;
 }
+/** Lo que un mutation_diff puede medir para entrar entero al recibo. Un
+ *  mutante planta UN defecto: los 15 del proyecto medido miden entre 280 y
+ *  1900 caracteres. Por arriba de esto el verbo se niega con el numero
+ *  (PND-261); lo que NO hace mas es recortar en silencio. */
+export declare const MUTATION_DIFF_MAX = 20000;
 export declare const EVIDENCE_DEFAULT_TIMEOUT_MS: number;
 export declare const EVIDENCE_MAX_TIMEOUT_MS: number;
 /** El tope que de verdad se va a aplicar a una corrida.

package/dist/urazuke/evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/urazuke/evidence.ts"],"names":[],"mappings":"AAsBA,OAAO,EAA8B,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAS3F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;+CAE2C;IAC3C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;iDAK6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,eAAO,MAAM,2BAA2B,QAAiB,CAAC;AAC1D,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AAEtD;;;;;mEAKmE;AACnE,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE;AAiBD;;;;;;;;;;;;;wEAawE;AACxE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAsCpK;AAED;;;;;uCAKuC;AACvC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;6BACyB;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;mDAC+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAOD;;;;;;;;;;;;;;;;;;;;yDAoByD;AACzD,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2E/F;AAED;;uCAEuC;AACvC,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAI1D;AAOD;;wBAEwB;AACxB,wBAAsB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxD;AAMD;kDACkD;AAClD,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8JrF;AAuBD;;0DAE0D;AAC1D,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,4EAA4E;IAC5E,IAAI,EAAE,CAAC,CAAC;CACT;AAED,yDAAyD;AACzD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhF;AAED;;sCAEsC;AACtC,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAYtF"}
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/urazuke/evidence.ts"],"names":[],"mappings":"AAsBA,OAAO,EAA8B,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAS3F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;+CAE2C;IAC3C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;iDAK6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;gEAG4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;6DAG6D;AAC7D,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAGvC,eAAO,MAAM,2BAA2B,QAAiB,CAAC;AAC1D,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AAEtD;;;;;mEAKmE;AACnE,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE;AAiBD;;;;;;;;;;;;;wEAawE;AACxE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAsCpK;AAED;;;;;uCAKuC;AACvC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;6BACyB;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;mDAC+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAOD;;;;;;;;;;;;;;;;;;;;yDAoByD;AACzD,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2E/F;AAED;;uCAEuC;AACvC,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAI1D;AAOD;;wBAEwB;AACxB,wBAAsB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxD;AAMD;kDACkD;AAClD,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqNrF;AAuBD;;0DAE0D;AAC1D,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,4EAA4E;IAC5E,IAAI,EAAE,CAAC,CAAC;CACT;AAED,yDAAyD;AACzD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhF;AAED;;sCAEsC;AACtC,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAYtF"}

package/dist/urazuke/evidence.js

@@ -24,6 +24,11 @@ import { appendReceipt, parseCounts } from './receipts.js';
 import { carryEvidenceEnv, describeEvidenceEnv, readEvidenceEnvDeclaration, } from './evidence_env.js';
 import { describeWindowsCommandProblem, windowsCommandProblem } from '../chat/tools/shell.js';
 const execFileP = promisify(execFile);
+/** Lo que un mutation_diff puede medir para entrar entero al recibo. Un
+ *  mutante planta UN defecto: los 15 del proyecto medido miden entre 280 y
+ *  1900 caracteres. Por arriba de esto el verbo se niega con el numero
+ *  (PND-261); lo que NO hace mas es recortar en silencio. */
+export const MUTATION_DIFF_MAX = 20000;
 const TAIL_CHARS = 4000;
 export const EVIDENCE_DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
 export const EVIDENCE_MAX_TIMEOUT_MS = 30 * 60 * 1000;
@@ -300,11 +305,38 @@ export async function runEvidence(input) {
     const started = Date.now();
     if (input.kind === 'red_proof') {
         const files = (input.test_files ?? []).map((f) => f.trim()).filter(Boolean);
-        const mutation = (input.mutation_diff ?? '').trim();
+        /* PND-261 -- EL SALTO DE LINEA FINAL ES PARTE DEL DIFF.
+         *
+         * Aca habia un `.trim()`, y el valor trimado era el que se archivaba.
+         * Un diff unificado sin salto de linea final no pasa `git apply`:
+         * "corrupt patch at line N". Medido sobre el registro del proyecto c1,
+         * fueron 15 recibos de mutacion de 15 -- todos legibles, ninguno
+         * reproducible. Y tres quedaron archivados como `not_ok` por esta misma
+         * falla, con la culpa atribuida al parche en vez de al guardado.
+         *
+         * El trim se queda SOLO para decidir si vino vacio; lo que se usa para
+         * plantar el mutante y lo que se archiva es el MISMO texto, terminado en
+         * salto de linea. Un caracter. */
+        const mutationRaw = input.mutation_diff ?? '';
+        const mutation = mutationRaw.trim()
+            ? (mutationRaw.endsWith('\n') ? mutationRaw : mutationRaw + '\n')
+            : '';
         if (!files.length && !mutation)
             throw new Error('red_proof needs test_files (the new test(s) to carry into the base worktree) or mutation_diff (a defect planted in the new code, D-037)');
         if (mutation && !/^(diff --git|--- |\+\+\+ |@@ )/m.test(mutation))
             throw new Error('mutation_diff must be a unified diff (diff --git / --- / +++ / @@ hunks)');
+        /* PND-261 (segunda mitad) -- EL TOPE SE AVISA, NO SE RECORTA.
+         *
+         * El guardado recortaba a 6000 caracteres y le pegaba '...[truncated]'.
+         * Un diff recortado tampoco aplica, y ademas no lo dice donde se mira:
+         * el recibo se ve completo. Un mutante planta UN defecto, asi que el
+         * tope sobra por lejos -- y cuando no sobre, el que pidio la corrida se
+         * entera con el numero en la mano en vez de recibir un documento mudo. */
+        if (mutation.length > MUTATION_DIFF_MAX) {
+            throw new Error('mutation_diff mide ' + mutation.length + ' caracteres y el tope del recibo es '
+                + MUTATION_DIFF_MAX + '. No lo recorto: un diff recortado no aplica y el recibo no lo dice '
+                + '(PND-261). Un mutante planta UN defecto -- acota la mutacion.');
+        }
         const baseRef = mutation ? 'HEAD' : (input.base_ref ?? 'HEAD').trim();
         const wt = await fs.mkdtemp(path.join(os.tmpdir(), 'yf-redproof-'));
         const link = path.join(wt, 'node_modules');
@@ -337,7 +369,10 @@ export async function runEvidence(input) {
                         + overlay.errors.slice(0, 5).join('; ');
                 }
                 const patch = path.join(wt, '.yf-mutant.diff');
-                await fs.writeFile(patch, mutation.endsWith('\n') ? mutation : mutation + '\n', 'utf8');
+                /* El MISMO texto que se archiva, byte por byte: si lo que se aplica y
+                 * lo que se guarda pueden diferir, la verificacion de abajo no prueba
+                 * nada sobre el recibo. */
+                await fs.writeFile(patch, mutation, 'utf8');
                 try {
                     /* No point applying a mutant onto the wrong code, and the
                      * message has to name the REAL cause: an apply error reported
@@ -383,6 +418,29 @@ export async function runEvidence(input) {
                 linked = true;
             }
             catch { /* no node_modules or cannot link: the command may still work */ }
+            /* PND-261 -- UN RECIBO QUE NO SE PUEDE REPRODUCIR NO NACE.
+             *
+             * applyError y overlayError no son la misma clase de falla y no se
+             * tratan igual:
+             *
+             *  - overlayError dice "el worktree NO es el codigo actual". El recibo
+             *    se escribe igual, marcado, porque eso es lo que PND-240 pedia:
+             *    que un rojo contaminado deje rastro en vez de desaparecer.
+             *  - applyError dice "el diff archivado no se puede volver a aplicar".
+             *    Ahi no hay nada que marcar: el recibo entero existe para que otro
+             *    plante el mismo defecto, y si el diff no aplica, el documento es
+             *    ilegible como evidencia. Eso falla CERRADO, sin escribir, y el que
+             *    pidio la corrida se entera ahora -- no cuatro semanas despues,
+             *    leyendo un `not_ok` que le echa la culpa al parche.
+             *
+             * El error se tira ACA y no antes porque la unica forma honesta de
+             * saber si un diff aplica es que git lo intente, y git lo intenta sobre
+             * el worktree que este bloque arma. */
+            if (applyError && !overlayError) {
+                throw new Error('evidencia: no escribi recibo porque el mutation_diff no se puede volver a '
+                    + 'aplicar sobre el codigo actual, y un recibo de mutacion que no se puede reproducir no '
+                    + 'es evidencia de nada (PND-261). ' + applyError);
+            }
             const setupError = overlayError || applyError;
             r = setupError
                 ? { exit_code: 0, output: '[forge] ' + setupError, duration_ms: 0, timed_out: false }
@@ -414,9 +472,10 @@ export async function runEvidence(input) {
             kind: 'red_proof', command: input.command, cwd: input.projectRoot,
             ref: head.ref, dirty: head.dirty, base_ref: baseShort,
             mode: mutation ? 'mutation' : 'base',
-            ...(mutation ? { mutation_diff: mutation.length > 6000 ? mutation.slice(0, 6000) + '\n...[truncated]' : mutation } : {}),
+            ...(mutation ? { mutation_diff: mutation } : {}),
             exit_code: r.exit_code, started_at: started, duration_ms: r.duration_ms,
             counts, output_tail: tail(r.output),
+            ...(input.evidence ? { evidence: input.evidence } : {}),
             ...(input.pending_id ? { pending_id: input.pending_id } : {}),
             ...(input.step != null ? { step: input.step } : {}),
             /* F-13 -- el entorno va al RECIBO y no solo a la nota: isStrongRed lo
@@ -448,6 +507,7 @@ export async function runEvidence(input) {
         ref: head.ref, dirty: head.dirty,
         exit_code: r.exit_code, started_at: started, duration_ms: r.duration_ms,
         counts, output_tail: tail(r.output),
+        ...(input.evidence ? { evidence: input.evidence } : {}),
         ...(input.pending_id ? { pending_id: input.pending_id } : {}),
         ...(input.step != null ? { step: input.step } : {}),
         ...(input.note ? { note: input.note } : {}),