@nac3/forge-cli 1.23.7 → 1.24.1

package/dist/core/battery_stamp.d.ts

@@ -0,0 +1,111 @@
+export declare const BATTERY_STAMP_REL = ".forge/battery-stamp.json";
+export declare const FINGERPRINT_SPEC: string;
+export interface GitState {
+    commit: string;
+    dirty: boolean;
+    fingerprint: string;
+    /** Lo que la huella cubre, en el propio sello: un dato sin su definicion
+     *  al lado es una afirmacion que el lector no puede verificar. */
+    fingerprint_spec: string;
+}
+export interface BatteryCounts {
+    files: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+}
+export interface BatteryStamp extends GitState {
+    version: 1;
+    ran_at: number;
+    duration_ms: number;
+    counts: BatteryCounts;
+    /** Verde = la bateria termino sin fallas. Un sello rojo NO se descarta:
+     *  "la bateria corrio y fallo" es informacion, y borrarla dejaria el
+     *  mismo silencio que no tener sello. */
+    green: boolean;
+    /** Para que el dueno pueda repetir la corrida exacta. */
+    invocation: string;
+    /** La corrida llevaba un filtro de archivos (`vitest run tests/x.test.ts`),
+     *  asi que NO es la bateria: es una parte. Se registra porque la mitad de
+     *  las corridas de un dia de trabajo son parciales, y un sello parcial
+     *  que se lea como "la bateria paso" seria exactamente la clase de verde
+     *  que afirma mas de lo que midio. */
+    filtered: boolean;
+}
+/** Si la invocacion llevaba un filtro de archivos. Mecanico: cualquier
+ *  argumento posicional que no sea una bandera ni el subcomando `run` es un
+ *  patron de archivos para vitest.
+ *
+ *  El sesgo es a proposito: `--reporter default` (con espacio) se lee como
+ *  filtro y el sello sale marcado parcial sin serlo. Equivocarse hacia
+ *  "parcial" avisa de mas; equivocarse hacia "completa" es el verde que
+ *  afirma lo que no midio. */
+export declare function isFilteredInvocation(args: string[]): boolean;
+/**
+ * EL FLAG QUE SE LLEVA EL INSTRUMENTO (medido 2026-11-01, vitest 2.x en
+ * este repositorio). `--reporter` en la linea de comandos NO se SUMA a los
+ * `reporters` de vitest.config.ts: los REEMPLAZA. Asi que
+ * `vitest run --reporter=basic` corre la bateria entera, sale verde, y NO
+ * deja sello -- y el aviso de `prepublishOnly` sigue hablando de la corrida
+ * anterior.
+ *
+ * Como se descubrio, que es la parte que importa: la bateria se corrio a
+ * las 20:25 con 508 archivos en verde y el sello en disco seguia marcando
+ * las 20:01 y 507 archivos. O sea que el instrumento del riesgo aceptado
+ * -- la unica cosa que cubre la bateria, que esta FUERA del gancho a
+ * proposito -- se desactivaba con el flag de conveniencia que se usaba en
+ * casi todas las corridas de la sesion. Es la misma familia que el resto
+ * del lote: un verde que no afirma lo que parece afirmar.
+ *
+ * Esto NO lo puede arreglar la config volviendo a inyectar el reporter: la
+ * CLI ya gano cuando la config se evalua. Lo que se puede, y es lo que se
+ * hace, es no callarse -- en el arranque (vitest.config.ts) y en el aviso
+ * del publish (renderFreshness), que son los dos momentos en que alguien
+ * todavia puede corregirlo.
+ */
+export declare function reporterOverridesStamp(args: string[]): boolean;
+/** El aviso del arranque, como lineas (sin saltos embebidos: este archivo
+ *  es ASCII y los saltos los pone quien escribe). */
+export declare const UNSEALED_RUN_NOTICE: readonly string[];
+/** La huella y el estado de git, calculados en UN solo lugar. Si el sello y
+ *  la verificacion los calcularan por su cuenta, un dia divergirian y la
+ *  comparacion diria "no coincide" sin que nada hubiera cambiado -- o peor,
+ *  al reves (simetria productor/consumidor, SQ 14). */
+export declare function readGitState(cwd: string): GitState;
+/** Los numeros de una corrida de vitest, del arbol de tareas que el
+ *  reporter recibe. Pura a proposito: el arbol se puede sintetizar en un
+ *  caso y asi el contador se prueba sin correr la bateria dentro de la
+ *  bateria. */
+export declare function countFromFiles(files: unknown[]): BatteryCounts;
+export declare function writeBatteryStamp(repoRoot: string, stamp: BatteryStamp): void;
+export declare function readBatteryStamp(repoRoot: string): BatteryStamp | null;
+export type FreshnessVerdict = 'same_content' | 'same_commit' | 'other_commit' | 'partial' | 'red' | 'never';
+export interface FreshnessReport {
+    verdict: FreshnessVerdict;
+    /** Lo que importa para el aviso: el contenido que se va a empaquetar NO
+     *  es el que la bateria vio. */
+    stale: boolean;
+    stamp: BatteryStamp | null;
+    current: GitState;
+}
+export declare function judgeFreshness(stamp: BatteryStamp | null, current: GitState): FreshnessReport;
+/** El aviso, con el formato que el dueno pidio: en que commit corrio la
+ *  bateria por ultima vez, en que commit estas, y si no coinciden lo dice. */
+export declare function renderFreshness(r: FreshnessReport): string;
+/** El reporter de vitest que deja el sello. Pato-tipado (no importa tipos
+ *  de vitest) para que este modulo siga siendo parte del producto y no de
+ *  la bateria. */
+export declare class BatteryStampReporter {
+    private started;
+    private root;
+    private invocation;
+    private filtered;
+    constructor(opts?: {
+        root?: string;
+        invocation?: string;
+        filtered?: boolean;
+    });
+    onInit(): void;
+    onFinished(files?: unknown[], errors?: unknown[]): void;
+}
+//# sourceMappingURL=battery_stamp.d.ts.map

package/dist/core/battery_stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"battery_stamp.d.ts","sourceRoot":"","sources":["../../src/core/battery_stamp.ts"],"names":[],"mappings":"AA6CA,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAE7D,eAAO,MAAM,gBAAgB,QAGsB,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB;sEACkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB;;6CAEyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;0CAIsC;IACtC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;8BAO8B;AAC9B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAE5D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAG9D;AAED;qDACqD;AACrD,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAShD,CAAC;AAEF;;;uDAGuD;AACvD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAsBlD;AAED;;;eAGe;AACf,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,aAAa,CAY9D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAI7E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQtE;AAED,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,aAAa,GACb,cAAc,GACd,SAAS,GACT,KAAK,GACL,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B;oCACgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,OAAO,EAAE,QAAQ,GAAG,eAAe,CAW7F;AASD;8EAC8E;AAC9E,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAuD1D;AAED;;kBAEkB;AAClB,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAU;gBAEd,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAO7E,MAAM,IAAI,IAAI;IAEd,UAAU,CAAC,KAAK,GAAE,OAAO,EAAO,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,IAAI;CAoBhE"}

package/dist/core/battery_stamp.js

@@ -0,0 +1,287 @@
+/**
+ * EL SELLO DE LA BATERIA -- el instrumento del riesgo aceptado (F-15).
+ *
+ * EL RIESGO. El gancho pre-push corre su paquete (20,8 a 39,2 s medidos,
+ * techo declarado 35 s -- src/core/hook_budget.ts) y NO corre la
+ * bateria (418 s): la decision es del dueno y esta escrita en
+ * docs/PROGRAMMING_NORMS.md. Pero un peor caso aceptado y no instrumentado
+ * es dano silencioso, asi que el riesgo tiene que AVISAR cuando ocurre, y
+ * "ocurre" aca significa: se esta publicando codigo que la bateria nunca
+ * vio.
+ *
+ * EL INSTRUMENTO. Cada corrida de vitest deja un sello
+ * (`.forge/battery-stamp.json`) con el commit, el estado del arbol y el
+ * resultado. Antes de empaquetar, `scripts/battery_freshness.mjs` compara
+ * ese sello con el estado de AHORA y lo dice. No bloquea -- eso es decision
+ * de costo del dueno -- pero deja de ser una frase en un documento.
+ *
+ * POR QUE NO ALCANZA EL COMMIT. 1.20.1 salio publicada con el bug adentro
+ * porque el tarball llevaba el `dist/` del build inicial y las fuentes se
+ * editaron DURANTE la compuerta: el commit era el mismo y el contenido no.
+ * Asi que el sello lleva una huella del contenido, no solo el commit.
+ *
+ * LA HUELLA, AUTODESCRIPTA (la misma regla que el congelado: una huella que
+ * no se puede reproducir desde afuera no es evidencia):
+ *   algoritmo:     SHA-256
+ *   codificacion:  UTF-8
+ *   forma canonica: las tres partes unidas por \n, en este orden --
+ *                   (1) el commit de HEAD (40 hex)
+ *                   (2) la salida de `git status --porcelain -uall`
+ *                   (3) la salida de `git diff HEAD`
+ *   cubre:         el contenido de todo archivo rastreado (via la parte 3)
+ *                  y la LISTA de archivos sin rastrear (via la parte 2)
+ *   excluye:       el CONTENIDO de los archivos sin rastrear, y todo lo que
+ *                  .gitignore descarta (node_modules, dist). Un cambio solo
+ *                  ahi no mueve la huella, y eso esta dicho a proposito:
+ *                  decir que cubre mas de lo que cubre es el defecto que
+ *                  este archivo existe para no repetir.
+ *
+ * ASCII-only.
+ */
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+export const BATTERY_STAMP_REL = '.forge/battery-stamp.json';
+export const FINGERPRINT_SPEC = 'sha256(utf8(HEAD + "\\n" + `git status --porcelain -uall`'
+    + ' sin la linea del propio sello + "\\n" + `git diff HEAD`)); cubre el contenido'
+    + ' rastreado y la lista de archivos sin rastrear; excluye el contenido sin'
+    + ' rastrear, lo ignorado y el archivo del sello';
+/** Si la invocacion llevaba un filtro de archivos. Mecanico: cualquier
+ *  argumento posicional que no sea una bandera ni el subcomando `run` es un
+ *  patron de archivos para vitest.
+ *
+ *  El sesgo es a proposito: `--reporter default` (con espacio) se lee como
+ *  filtro y el sello sale marcado parcial sin serlo. Equivocarse hacia
+ *  "parcial" avisa de mas; equivocarse hacia "completa" es el verde que
+ *  afirma lo que no midio. */
+export function isFilteredInvocation(args) {
+    return args.some((a) => a !== 'run' && a !== 'watch' && !a.startsWith('-'));
+}
+/**
+ * EL FLAG QUE SE LLEVA EL INSTRUMENTO (medido 2026-11-01, vitest 2.x en
+ * este repositorio). `--reporter` en la linea de comandos NO se SUMA a los
+ * `reporters` de vitest.config.ts: los REEMPLAZA. Asi que
+ * `vitest run --reporter=basic` corre la bateria entera, sale verde, y NO
+ * deja sello -- y el aviso de `prepublishOnly` sigue hablando de la corrida
+ * anterior.
+ *
+ * Como se descubrio, que es la parte que importa: la bateria se corrio a
+ * las 20:25 con 508 archivos en verde y el sello en disco seguia marcando
+ * las 20:01 y 507 archivos. O sea que el instrumento del riesgo aceptado
+ * -- la unica cosa que cubre la bateria, que esta FUERA del gancho a
+ * proposito -- se desactivaba con el flag de conveniencia que se usaba en
+ * casi todas las corridas de la sesion. Es la misma familia que el resto
+ * del lote: un verde que no afirma lo que parece afirmar.
+ *
+ * Esto NO lo puede arreglar la config volviendo a inyectar el reporter: la
+ * CLI ya gano cuando la config se evalua. Lo que se puede, y es lo que se
+ * hace, es no callarse -- en el arranque (vitest.config.ts) y en el aviso
+ * del publish (renderFreshness), que son los dos momentos en que alguien
+ * todavia puede corregirlo.
+ */
+export function reporterOverridesStamp(args) {
+    return args.some((a) => a === '--reporter' || a === '--reporters'
+        || a.startsWith('--reporter=') || a.startsWith('--reporters='));
+}
+/** El aviso del arranque, como lineas (sin saltos embebidos: este archivo
+ *  es ASCII y los saltos los pone quien escribe). */
+export const UNSEALED_RUN_NOTICE = [
+    '',
+    '[sello de la bateria] ESTA CORRIDA NO VA A DEJAR SELLO.',
+    '`--reporter` en la linea de comandos reemplaza los reporters de',
+    'vitest.config.ts y se lleva el del sello, asi que el aviso del publish va',
+    'a seguir hablando de la corrida anterior aunque esta salga verde.',
+    'Para sellar: `pnpm test`, sin flag de reporter.',
+    '(YF_SELLO_NO_HACE_FALTA=1 apaga este aviso.)',
+    '',
+];
+/** La huella y el estado de git, calculados en UN solo lugar. Si el sello y
+ *  la verificacion los calcularan por su cuenta, un dia divergirian y la
+ *  comparacion diria "no coincide" sin que nada hubiera cambiado -- o peor,
+ *  al reves (simetria productor/consumidor, SQ 14). */
+export function readGitState(cwd) {
+    const git = (args) => execFileSync('git', args, {
+        cwd, encoding: 'utf8', windowsHide: true, maxBuffer: 64 * 1024 * 1024,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    const commit = git(['rev-parse', 'HEAD']).trim();
+    /* El sello se EXCLUYE de su propia huella. En este repositorio esta
+     * ignorado por git y no aparece, pero en uno que no lo ignore si: y
+     * entonces escribir el sello cambiaria la huella que el sello acaba de
+     * guardar, y el instrumento diria "no coincide" SIEMPRE. Un instrumento
+     * que avisa siempre deja de avisar -- se desactiva. */
+    const status = git(['status', '--porcelain', '-uall'])
+        .split(/\r?\n/)
+        .filter((l) => !l.includes(BATTERY_STAMP_REL) && !l.includes(BATTERY_STAMP_REL.replace(/\//g, '\\')))
+        .join('\n');
+    const diff = git(['diff', 'HEAD']);
+    return {
+        commit,
+        dirty: status.trim().length > 0,
+        fingerprint: createHash('sha256').update(commit + '\n' + status + '\n' + diff, 'utf8').digest('hex'),
+        fingerprint_spec: FINGERPRINT_SPEC,
+    };
+}
+/** Los numeros de una corrida de vitest, del arbol de tareas que el
+ *  reporter recibe. Pura a proposito: el arbol se puede sintetizar en un
+ *  caso y asi el contador se prueba sin correr la bateria dentro de la
+ *  bateria. */
+export function countFromFiles(files) {
+    const counts = { files: files.length, passed: 0, failed: 0, skipped: 0 };
+    const walk = (task) => {
+        const kids = Array.isArray(task.tasks) ? task.tasks : undefined;
+        if (kids) {
+            for (const k of kids)
+                walk(k);
+            return;
+        }
+        const state = task.result?.state;
+        if (state === 'pass')
+            counts.passed++;
+        else if (state === 'fail')
+            counts.failed++;
+        else
+            counts.skipped++;
+    };
+    for (const f of files)
+        walk(f);
+    return counts;
+}
+export function writeBatteryStamp(repoRoot, stamp) {
+    const file = path.join(repoRoot, BATTERY_STAMP_REL);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(stamp, null, 2) + '\n', 'utf8');
+}
+export function readBatteryStamp(repoRoot) {
+    try {
+        const raw = fs.readFileSync(path.join(repoRoot, BATTERY_STAMP_REL), 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed && parsed.version === 1 ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function judgeFreshness(stamp, current) {
+    if (!stamp)
+        return { verdict: 'never', stale: true, stamp, current };
+    if (!stamp.green)
+        return { verdict: 'red', stale: true, stamp, current };
+    if (stamp.filtered)
+        return { verdict: 'partial', stale: true, stamp, current };
+    if (stamp.fingerprint === current.fingerprint) {
+        return { verdict: 'same_content', stale: false, stamp, current };
+    }
+    return {
+        verdict: stamp.commit === current.commit ? 'same_commit' : 'other_commit',
+        stale: true, stamp, current,
+    };
+}
+function when(ms) {
+    const d = new Date(ms);
+    const pad = (n) => String(n).padStart(2, '0');
+    return d.getFullYear() + '-' + pad(d.getMonth() + 1) + '-' + pad(d.getDate())
+        + ' ' + pad(d.getHours()) + ':' + pad(d.getMinutes());
+}
+/** El aviso, con el formato que el dueno pidio: en que commit corrio la
+ *  bateria por ultima vez, en que commit estas, y si no coinciden lo dice. */
+export function renderFreshness(r) {
+    const out = [];
+    const cur = r.current.commit.slice(0, 7) + (r.current.dirty ? ' (arbol sucio)' : '');
+    if (r.verdict === 'never') {
+        out.push('bateria: NO HAY SELLO -- en este arbol no hay registro de ninguna corrida.');
+        out.push('Estas en: ' + cur + '.');
+        out.push('Eso NO quiere decir que la bateria no corrio: quiere decir que nadie lo');
+        out.push('registro, que para decidir si publicar es lo mismo.');
+    }
+    else {
+        const s = r.stamp;
+        const tail = s.counts.passed + ' pasados, ' + s.counts.failed + ' fallados, '
+            + s.counts.skipped + ' salteados, ' + s.counts.files + ' archivos';
+        out.push('bateria: ultima corrida en ' + s.commit.slice(0, 7) + (s.dirty ? ' (arbol sucio)' : '')
+            + ' el ' + when(s.ran_at) + ' -- ' + (s.green ? 'VERDE' : 'ROJA')
+            + (s.filtered ? ', PARCIAL' : '') + ' (' + tail + ').');
+        out.push('Estas en: ' + cur + '.');
+        if (r.verdict === 'same_content') {
+            out.push('Coinciden: la bateria vio EXACTAMENTE este contenido (huella '
+                + s.fingerprint.slice(0, 12) + ').');
+        }
+        else if (r.verdict === 'partial') {
+            out.push('AVISO: LA ULTIMA CORRIDA FUE PARCIAL (' + s.invocation + '), asi que el');
+            out.push('sello dice que paso una PARTE. La bateria completa no tiene registro aca.');
+        }
+        else if (r.verdict === 'red') {
+            out.push('AVISO: el ultimo sello es ROJO. Lo que se esta por empaquetar no tiene');
+            out.push('una corrida verde que lo respalde.');
+        }
+        else if (r.verdict === 'same_commit') {
+            out.push('AVISO: MISMO COMMIT, CONTENIDO DISTINTO. Las fuentes se movieron despues');
+            out.push('de la corrida (huella ' + s.fingerprint.slice(0, 12) + ' contra '
+                + r.current.fingerprint.slice(0, 12) + ').');
+            out.push('Esta es la forma exacta de 1.20.1: el tarball se armo con fuentes que la');
+            out.push('compuerta no habia visto. No edites fuentes durante el publish.');
+        }
+        else {
+            out.push('AVISO: LA BATERIA CORRIO EN OTRO COMMIT. Lo que se va a empaquetar no es');
+            out.push('lo que la bateria verifico.');
+        }
+    }
+    out.push('Huella: ' + r.current.fingerprint_spec + '.');
+    if (r.stale) {
+        out.push('La bateria (418 s) queda FUERA del gancho pre-push a proposito -- la');
+        out.push('decision y su motivo estan en docs/PROGRAMMING_NORMS.md. Este aviso es el');
+        out.push('instrumento de ese riesgo aceptado: correla con `pnpm test` antes de');
+        out.push('publicar, o publica sabiendo lo que falta.');
+        /* Y LA CAUSA MAS PROBABLE DE UN SELLO VIEJO NO ES QUE NADIE CORRIO LA
+         * BATERIA (medido 2026-11-01): es que corrio con `--reporter` explicito.
+         * Ese flag REEMPLAZA los reporters de la config, se lleva puesto el
+         * reporter del sello, y la corrida sale verde SIN DEJAR REGISTRO. Si no
+         * se nombra aca, el que lea "sello viejo" despues de ver 5600 tests en
+         * verde concluye que el instrumento miente, y el paso siguiente es
+         * sacarlo de la cadena. */
+        out.push('SI ACABAS DE CORRER LA BATERIA Y ESTE AVISO DICE QUE EL SELLO ES VIEJO:');
+        out.push('la corriste con `--reporter` explicito. Ese flag reemplaza los reporters');
+        out.push('de la config y se lleva el del sello, asi que la corrida no deja registro.');
+        out.push('Corre `pnpm test` (sin flag de reporter) y el sello queda.');
+    }
+    return out.join('\n');
+}
+/** El reporter de vitest que deja el sello. Pato-tipado (no importa tipos
+ *  de vitest) para que este modulo siga siendo parte del producto y no de
+ *  la bateria. */
+export class BatteryStampReporter {
+    started = Date.now();
+    root;
+    invocation;
+    filtered;
+    constructor(opts) {
+        this.root = opts?.root ?? process.cwd();
+        const args = process.argv.slice(2);
+        this.invocation = opts?.invocation ?? ('vitest ' + args.join(' ')).trim();
+        this.filtered = opts?.filtered ?? isFilteredInvocation(args);
+    }
+    onInit() { this.started = Date.now(); }
+    onFinished(files = [], errors = []) {
+        try {
+            const counts = countFromFiles(files);
+            const stamp = {
+                version: 1,
+                ran_at: Date.now(),
+                duration_ms: Date.now() - this.started,
+                counts,
+                green: counts.failed === 0 && (!errors || errors.length === 0) && counts.files > 0,
+                invocation: this.invocation,
+                filtered: this.filtered,
+                ...readGitState(this.root),
+            };
+            writeBatteryStamp(this.root, stamp);
+        }
+        catch {
+            /* Un sello que no se pudo escribir no puede voltear una corrida: el
+             * instrumento no es la bateria. El silencio lo cubre el otro lado --
+             * `battery_freshness` distingue "no hay sello" de "esta fresco". */
+        }
+    }
+}
+//# sourceMappingURL=battery_stamp.js.map

package/dist/core/battery_stamp.js.map

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

package/dist/core/ci_gaps.d.ts

@@ -0,0 +1,130 @@
+/**
+ * LO QUE LA CADENA NO CORRIO -- F-14 / F-15 (pedido del dueno, 2026-11-01).
+ *
+ * EL DEFECTO. Medido en el repositorio: `.github/workflows/ci.yml` instala y
+ * corre `typecheck`, nada mas; `prepublishOnly` corre SEIS compuertas (build,
+ * typecheck, catalog:lint, test, brain-matrix:gate, hito4:lint). Asi que un
+ * VERDE en el badge de CI no significa "la bateria paso" -- significa "los
+ * tipos compilan" -- y nada en la salida de la corrida lo dice. Esta forma ya
+ * costo una vez: 1.20.1 salio publicada con un bug adentro.
+ *
+ * El dueno NO pidio mover las compuertas pesadas a la cadena (es una decision
+ * suya, con su motivo: la matriz multi-OS consumia la cuota en una rafaga).
+ * Pidio que la corrida DECLARE lo que no corrio. Es la misma regla que el
+ * metodo aplica a un recibo: una corrida que no mide algo tiene que decir que
+ * no lo midio, porque el que lee un verde no tiene otra forma de saberlo.
+ *
+ * Y LA PAREJA QUE EL DUENO SOSPECHO Y RESULTO PEOR (F-15). `lefthook.yml`
+ * declaraba un `pre-push` con `pnpm test` + `brain-matrix:gate`: dos
+ * compuertas, no las seis del publish. Pero antes de eso: el gancho no
+ * estaba instalado y no podia estarlo -- `.git/hooks` vacio,
+ * `core.hooksPath` sin poner, `lefthook` no era dependencia. Asi que la
+ * "preflight local" a la que el comentario de ci.yml remite no la corria
+ * ningun mecanismo: era un habito. Y el circulo se cerraba solo: ci.yml
+ * decia que lo pesado corre local, y lefthook.yml decia "CI is the real
+ * gate". Cada uno senalaba al otro y ninguno lo hacia.
+ *
+ * ARREGLADO EL 2026-11-01, con la decision del dueno: `lefthook` es
+ * devDependency, el ciclo `prepare` lo instala, y el pre-push corre el
+ * su paquete, todo `prepublishOnly` menos la bateria, dentro de un
+ * presupuesto declarado (aviso 30 s, techo 35 s). La cadena NO
+ * se ensancha -- se mantiene liviana por cuota -- asi que para el trabajo en
+ * rama el gancho es la UNICA puerta. De ahi los dos agregados de este
+ * modulo: `triggers`, porque una cadena que solo dispara en main no es una
+ * segunda puerta para una rama; y la cobertura POR EQUIVALENCIA, porque el
+ * gancho invoca los scripts directo (arranca mas rapido) y `build` corre el
+ * mismo `tsc` que `typecheck` -- decir "no corre typecheck" ahi seria una
+ * falsa alarma, y una falsa alarma termina con el instrumento apagado.
+ *
+ * POR QUE ESTO SE DERIVA Y NO SE ESCRIBE A MANO. Una lista fija de "lo que
+ * no corre" es una segunda fuente de verdad, y se desincroniza el dia que
+ * alguien agrega una compuerta al publish -- el mismo defecto que este
+ * modulo esta reportando. Asi que las tres listas salen de los archivos que
+ * YA son la verdad (package.json, el workflow, lefthook.yml) y la diferencia
+ * se calcula. Si una de las tres no se puede leer, esto FALLA: una medicion
+ * que no se pudo hacer no se reporta como "no falta nada".
+ *
+ * ASCII-only.
+ */
+export interface CiGapReport {
+    /** Los scripts npm que la corrida de CI ejecuta de verdad. */
+    ran: string[];
+    /** Los que la compuerta de publicacion exige y la cadena NO corre. */
+    not_run: string[];
+    /** Los que el gancho local declara (este o no instalado). Son los
+     *  nombres de compuerta del publish que el gancho CUBRE: directamente
+     *  (corre el script) o por equivalencia (corre otro script que invoca el
+     *  mismo programa -- `build` corre el mismo `tsc` que `typecheck`). */
+    hook_declares: string[];
+    /** De los anteriores, los que el gancho cubre por EQUIVALENCIA y no por
+     *  nombre. Se separan porque son la parte que hay que poder explicar: un
+     *  "lo cubre otro" sin decir cual es una afirmacion sin respaldo. */
+    hook_covers_by_equivalence: Array<{
+        gate: string;
+        via: string;
+    }>;
+    /** Los del publish que el gancho local tampoco corre. */
+    hook_not_run: string[];
+    /** La cobertura de plataforma de la corrida, leida del workflow. */
+    os: string[];
+    node: string[];
+    /** Lo que ninguna de las tres puertas corre. */
+    nobody_runs: string[];
+    /** CUANDO dispara la cadena, leido del `on:` del workflow. El cuarto
+     *  hueco de F-15: con `push: [main]` y `pull_request: [main]`, una rama
+     *  sin PR no tiene NINGUNA corrida, asi que para el trabajo en rama la
+     *  cadena no es una segunda puerta -- no es ninguna. */
+    triggers: {
+        push: string[];
+        pull_request: string[];
+        other: string[];
+    };
+}
+/** Los nombres de script que una linea de comandos invoca. Cubre las formas
+ *  que este repositorio usa de verdad (`pnpm run x`, `pnpm x`, `npm run x`)
+ *  y nada mas: inventar formas que nadie escribe es ruido. */
+export declare function scriptsInvoked(command: string): string[];
+/** Los PROGRAMAS que una linea de comandos invoca de verdad, expandiendo
+ *  los scripts del paquete. Es lo que permite decir "el gancho cubre
+ *  `typecheck` porque corre `build`, que corre el mismo tsc" sin escribirlo
+ *  a mano en ninguna lista.
+ *
+ *  La forma de cada invocacion: el programa, y para `node` tambien el
+ *  archivo (`node:scripts/catalog_lint.mjs`) -- dos scripts de node
+ *  distintos no son la misma compuerta. */
+export declare function invocationsOf(command: string, scripts?: Record<string, string>, seen?: Set<string>): string[];
+/** El `on:` del workflow: en que ramas dispara cada evento. Atajo sobre el
+ *  YAML, igual que `runLines`, y por el mismo motivo: un parser completo
+ *  seria una dependencia nueva para leer cuatro lineas, y el caso corre
+ *  sobre el archivo real, asi que una forma que esto no entienda sale roja
+ *  en vez de salir en silencio. */
+export declare function readTriggers(yaml: string): {
+    push: string[];
+    pull_request: string[];
+    other: string[];
+};
+export interface CiGapInputs {
+    /** El contenido de package.json, ya parseado. */
+    pkg: {
+        scripts?: Record<string, string>;
+    };
+    /** El YAML del workflow de CI. */
+    workflow: string;
+    /** El YAML de lefthook. Opcional: un repositorio sin gancho declarado es
+     *  un estado legitimo, y entonces las dos listas del gancho son vacias. */
+    lefthook?: string;
+}
+/** Derivar las tres listas y su diferencia. Tira cuando no puede medir: una
+ *  medicion imposible no se reporta como "no falta nada". */
+export declare function deriveCiGaps(input: CiGapInputs): CiGapReport;
+/** Solo la seccion `pre-push` de lefthook.yml. El `pre-commit` corre en otro
+ *  momento y meterlo aca diria que el push verifica mas de lo que verifica,
+ *  que es el defecto, al revez. */
+export declare function preprocessLefthookPrePush(yaml: string): string;
+/** LA DECLARACION, con el formato que el dueno pidio textualmente.
+ *
+ *  Primero lo que SI se verifico y despues lo que NO, en ese orden y en la
+ *  misma salida: una lista de ausencias al final de un log de 300 lineas no
+ *  la lee nadie. */
+export declare function renderCiGaps(r: CiGapReport): string;
+//# sourceMappingURL=ci_gaps.d.ts.map

package/dist/core/ci_gaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci_gaps.d.ts","sourceRoot":"","sources":["../../src/core/ci_gaps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;2EAGuE;IACvE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;yEAEqE;IACrE,0BAA0B,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,yDAAyD;IACzD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oEAAoE;IACpE,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gDAAgD;IAChD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;;;4DAGwD;IACxD,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACvE;AAED;;8DAE8D;AAC9D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWxD;AAED;;;;;;;2CAO2C;AAC3C,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,MAAM,EAAE,CA4CV;AAmDD;;;;mCAImC;AACnC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CA+BtG;AAED,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,GAAG,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC1C,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB;+EAC2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;6DAC6D;AAC7D,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAwD5D;AAED;;mCAEmC;AACnC,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED;;;;oBAIoB;AACpB,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CA8CnD"}