oficina-opencode 2.0.1 → 2.1.1

package/dist/core/evidence.js

@@ -0,0 +1,602 @@
+/**
+ * Requirement-to-Evidence Graph: la capa que falta entre "compila" y "está".
+ *
+ * Los gates técnicos dicen que el código no está roto. No dicen que la card
+ * resolvió lo que el usuario pidió. Una card puede compilar, pasar lint,
+ * pasar todos los tests y aun así tener la autenticación mal, porque ningún
+ * test contemplaba ese escenario: el criterio de aceptación era "el login
+ * valida credenciales" y la suite solo verificaba que `login()` devolvía 200.
+ *
+ * Este módulo cierra ese hueco. Cada criterio de aceptación se convierte en
+ * un nodo de requisito; cada evidencia (artefacto, test, gate, inspección,
+ * evidencia externa) se engancha a un requisito con un nivel de verificación.
+ * La regla que gobierna todo el módulo: si a un requisito obligatorio le
+ * falta evidencia suficiente, la card NO puede declararse done.
+ *
+ * Decisiones de diseño que conviene no romper:
+ *
+ * 1. La pirámide de niveles ordena CONFianza, no cantidad:
+ *    1 = estático (compila, lintea), 2 = comportamiento (algo lo ejercita),
+ *    3 = validación de requisitos (alguien lo contrastó contra el criterio),
+ *    4 = auditoría independiente (otro agente, no el owner, lo revisó).
+ *    `reachedLevel` es el MÁXIMO de la evidencia del requisito, nunca el
+ *    promedio: promediar dejaría pasar una card con un test y cinco gates
+ *    cuando ningún requisito tiene un test.
+ *
+ * 2. El módulo no llama a `Date.now()`. Todo timestamp entra por `clock` o
+ *    por `recordedAt`; sin ninguno se usa un epoch fijo. Un grafo que depende
+ *    del reloj no es reproducible y sus tests miden el reloj, no el grafo.
+ *
+ * 3. No hay IO. Todo entra por parámetros y sale por el return. El módulo no
+ *    sabe dónde viven los artefactos: recibe rutas como strings.
+ *
+ * 4. La evidencia se vincula por el TEXTO EXACTO del criterio de aceptación,
+ *    no por índice, porque el texto es lo que el humano lee y lo que el
+ *    Commander escribió; el índice solo desambigua duplicados. Si el texto no
+ *    coincide, la evidencia se engancha igual por índice pero queda un riesgo
+ *    visible: prefiero evidencia mal etiquetada con riesgo a evidencia
+ *    perdida en silencio.
+ *
+ * 5. El módulo no importa `Card` de `types.ts`. Necesita el id y los
+ *    criterios de aceptación, y nada más: acoplarse al schema completo de la
+ *    card haría que cada cambio de card_schema rompiera el grafo de evidencia
+ *    sin que tenga relación alguna con él.
+ */
+import path from "node:path";
+// ─────────────────────────────────────────────────────────────────────────────
+// Constantes
+// ─────────────────────────────────────────────────────────────────────────────
+/** Cuántos criterios de aceptación son obligatorios por defecto. */
+export const DEFAULT_MANDATORY_COUNT = 2;
+/** Nivel de evidencia exigido por defecto: comportamiento, no estático. */
+export const DEFAULT_REQUIRED_LEVEL = 2;
+/**
+ * Epoch por defecto para la evidencia sin reloj inyectado.
+ *
+ * Feo a propósito: mejor una fecha obviamente sintética que un timestamp
+ * silenciosamente dependiente del momento en que corrió el test.
+ */
+export const DEFAULT_RECORDED_AT = "1970-01-01T00:00:00.000Z";
+/** Agente por defecto cuando nadie dice quién registró la evidencia. */
+export const DEFAULT_RECORDED_BY = "unknown";
+/**
+ * Nivel máximo que puede alcanzar cada tipo de evidencia.
+ *
+ * Un artefacto es una descripción del trabajo, no el trabajo: describe
+ * comportamiento pero no lo demuestra más allá de lo que el autor afirma.
+ * Por eso tope 2. La inspección manual llega a 3. Solo una revisión de otro
+ * agente, que puede decir "esto no cumple", llega a 4.
+ */
+const KIND_MAX_LEVEL = {
+    artifact: 2,
+    test: 2,
+    gate: 2,
+    inspection: 4,
+    external: 4,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers internos
+// ─────────────────────────────────────────────────────────────────────────────
+/** Convierte un número a nivel válido. Cualquier cosa fuera de 1..4 es 0. */
+function toLevel(value) {
+    if (value === 1)
+        return 1;
+    if (value === 2)
+        return 2;
+    if (value === 3)
+        return 3;
+    if (value === 4)
+        return 4;
+    return 0;
+}
+/** Recorta un nivel al máximo que admite su tipo de evidencia. */
+function clampLevel(level, max) {
+    const capped = toLevel(Math.min(Math.max(Math.trunc(level), 1), 4));
+    if (capped === 0)
+        return 1;
+    return capped <= max ? capped : max;
+}
+/** Slug estable para ids y refs: sin acentos, sin mayúsculas, sin ruido. */
+function slugify(text) {
+    // `Diacritic` es la forma Unicode de quitar las marcas combinantes que
+    // deja NFD ("autenticación" -> "autenticacion") sin escribir un rango de
+    // caracteres combinantes a mano.
+    const normalized = text
+        .normalize("NFD")
+        .replace(/\p{Diacritic}/gu, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return normalized.slice(0, 48) || "ref";
+}
+/** Id estable de un nodo de requisito. */
+export function requirementId(cardId, index) {
+    return `req-${slugify(cardId)}-${index}`;
+}
+/** Id estable de un nodo de evidencia. */
+export function evidenceId(cardId, requirementIndex, kind, ref) {
+    const idx = requirementIndex >= 0 ? String(requirementIndex) : "x";
+    return `ev-${slugify(cardId)}-${idx}-${kind}-${slugify(ref)}`;
+}
+/**
+ * Resuelve el timestamp de una evidencia.
+ *
+ * Precedencia: `recordedAt` explícito > `clock` inyectado > epoch fijo.
+ */
+function resolveRecordedAt(opts) {
+    if (opts.recordedAt)
+        return opts.recordedAt;
+    if (opts.clock)
+        return new Date(opts.clock()).toISOString();
+    return DEFAULT_RECORDED_AT;
+}
+/** Índices de criterios obligatorios. */
+function resolveMandatoryIndexes(total, options) {
+    if (options.mandatoryIndexes) {
+        return new Set(options.mandatoryIndexes.filter((i) => i >= 0 && i < total));
+    }
+    const count = Math.min(Math.max(options.mandatoryCount ?? DEFAULT_MANDATORY_COUNT, 0), total);
+    return new Set(Array.from({ length: count }, (_, i) => i));
+}
+/** Escapa texto para una celda de tabla markdown. */
+function escapeCell(text) {
+    return text.replace(/\s+/g, " ").replace(/\|/g, "\\|");
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Construcción
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Crea un nodo de requisito por cada criterio de aceptación de la card.
+ *
+ * Los primeros `mandatoryCount` criterios (2 por defecto) quedan obligatorios.
+ * La obligatoriedad existe porque no todos los criterios cortan el objetivo:
+ * "el botón dice Hola" puede quedar sin probar y la card sigue sirviendo,
+ * pero "el login valida credenciales" no.
+ */
+export function buildRequirementNodes(card, options = {}) {
+    const mandatory = resolveMandatoryIndexes(card.acceptance.length, options);
+    return card.acceptance.map((requirement, index) => ({
+        id: requirementId(card.id, index),
+        cardId: card.id,
+        requirement,
+        index,
+        mandatory: mandatory.has(index),
+        evidence: [],
+        reachedLevel: 0,
+        status: "unsatisfied",
+        risks: [],
+    }));
+}
+/**
+ * Recalcula el estado derivado de un requisito a partir de su evidencia.
+ *
+ * Todo el estado (`reachedLevel`, `status`, `risks`) se deriva de la
+ * evidencia, nunca se anota a mano: si el estado puede quedar desincronizado
+ * con los hechos, el grafo miente.
+ */
+function recomputeRequirement(req, requiredLevel) {
+    const valid = req.evidence.filter((e) => e.passed !== false);
+    let reached = 0;
+    for (const e of valid) {
+        reached = reached === 0 ? e.level : toLevel(Math.max(reached, e.level));
+    }
+    const status = reached === 0 ? "unsatisfied" : reached >= requiredLevel ? "satisfied" : "partial";
+    const risks = [];
+    for (const e of req.evidence) {
+        if (e.passed === false) {
+            risks.push(`Hay evidencia que documenta un fallo: ${e.ref}`);
+        }
+        if (e.requirement !== req.requirement) {
+            risks.push(`La evidencia ${e.ref} cita «${e.requirement}», que no es el texto del criterio`);
+        }
+    }
+    if (valid.length > 0 && reached < requiredLevel) {
+        risks.push(`Nivel de evidencia insuficiente: ${reached} < ${requiredLevel}`);
+    }
+    if (req.mandatory && req.evidence.length === 0) {
+        risks.push("Sin evidencia registrada para un requisito obligatorio");
+    }
+    return { ...req, evidence: [...req.evidence], reachedLevel: reached, status, risks };
+}
+/**
+ * Recalcula los campos derivados del grafo completo.
+ *
+ * `missingMandatory` incluye tanto los requisitos obligatorios SIN evidencia
+ * como los que tienen evidencia por debajo del nivel exigido: en los dos
+ * casos falta evidencia *suficiente*, que es lo que importa para cerrar.
+ */
+function recompute(graph) {
+    const requiredLevel = graph.requiredLevel ?? DEFAULT_REQUIRED_LEVEL;
+    const requirements = graph.requirements.map((r) => recomputeRequirement(r, requiredLevel));
+    const mandatory = requirements.filter((r) => r.mandatory);
+    const missingMandatory = mandatory
+        .filter((r) => r.status !== "satisfied")
+        .map((r) => r.requirement);
+    let minLevel = 0;
+    if (mandatory.length > 0) {
+        minLevel = mandatory[0].reachedLevel;
+        for (const r of mandatory) {
+            minLevel = toLevel(Math.min(minLevel, r.reachedLevel));
+        }
+    }
+    const complete = missingMandatory.length === 0;
+    let summary;
+    if (mandatory.length === 0) {
+        summary =
+            requirements.length === 0
+                ? "La card no declara criterios de aceptación: no hay nada que verificar."
+                : `${requirements.length} criterio(s) de aceptación, ninguno obligatorio.`;
+    }
+    else if (complete) {
+        summary = `Los ${mandatory.length} requisito(s) obligatorio(s) tienen evidencia suficiente (nivel mínimo ${minLevel}).`;
+    }
+    else {
+        summary = `Faltan ${missingMandatory.length} requisito(s) obligatorio(s): ${missingMandatory.join("; ")}.`;
+    }
+    return { ...graph, requirements, missingMandatory, complete, minLevel, summary };
+}
+/**
+ * Encuentra el requisito al que pertenece una evidencia.
+ *
+ * Primero por texto exacto (la identidad del criterio es su texto); el
+ * índice solo desambigua duplicados. Si el texto no coincide con ninguno, se
+ * cae al índice: la evidencia se guarda y la discrepancia queda registrada
+ * como riesgo en el requerimiento.
+ */
+function resolveTarget(requirements, node) {
+    if (requirements.length === 0)
+        return undefined;
+    const exact = requirements.filter((r) => r.requirement === node.requirement);
+    if (exact.length === 1)
+        return exact[0];
+    if (exact.length > 1) {
+        return exact.find((r) => r.index === node.requirementIndex) ?? exact[0];
+    }
+    return requirements.find((r) => r.index === node.requirementIndex);
+}
+/**
+ * Agrega una evidencia al grafo y recalcula el estado.
+ *
+ * La función es pura: no muta el grafo recibido, devuelve uno nuevo. Quien
+ * la llame puede conservar el anterior para comparar versiones.
+ */
+export function addEvidence(graph, node) {
+    const requirements = graph.requirements.map((r) => ({ ...r, evidence: [...r.evidence] }));
+    const target = resolveTarget(requirements, node);
+    if (!target) {
+        const orphans = [...(graph.orphanedEvidence ?? []), node];
+        return recompute({ ...graph, requirements, orphanedEvidence: orphans });
+    }
+    // El flag `mandatory` de la evidencia lo manda el requisito: el criterio
+    // manda sobre lo que diga la evidencia, no al revés.
+    target.evidence.push({ ...node, mandatory: target.mandatory });
+    return recompute({ ...graph, requirements });
+}
+/**
+ * Construye el grafo de evidencia de una card.
+ *
+ * Es el camino normal: se pasa la card, la lista de evidencia y las opciones.
+ * La evidencia se aplica en orden, así que el orden de la lista importa
+ * para el orden interno (no para el estado, que se recalcula siempre).
+ */
+export function buildEvidenceGraph(card, evidence, options = {}) {
+    const requiredLevel = options.requiredLevel ?? DEFAULT_REQUIRED_LEVEL;
+    let graph = {
+        cardId: card.id,
+        requirements: buildRequirementNodes(card, options),
+        missingMandatory: [],
+        complete: false,
+        minLevel: 0,
+        summary: "",
+        requiredLevel,
+        orphanedEvidence: [],
+    };
+    for (const node of evidence) {
+        graph = addEvidence(graph, node);
+    }
+    return recompute(graph);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Constructores de evidencia
+// ─────────────────────────────────────────────────────────────────────────────
+/** Base común de los constructores de evidencia. */
+function makeEvidence(args) {
+    const index = args.opts.requirementIndex ?? -1;
+    return {
+        id: evidenceId(args.cardId, index, args.kind, args.ref),
+        cardId: args.cardId,
+        requirement: args.requirement,
+        requirementIndex: index,
+        mandatory: args.opts.mandatory ?? false,
+        kind: args.kind,
+        level: args.level,
+        ref: args.ref,
+        note: args.note,
+        recordedAt: resolveRecordedAt(args.opts),
+        recordedBy: args.opts.recordedBy ?? DEFAULT_RECORDED_BY,
+        passed: args.passed,
+    };
+}
+/**
+ * Evidencia de artefacto: un archivo de `.oficina/artifacts/<cardId>/`.
+ *
+ * Tope nivel 2. Un `handoff.md` describe lo que el agente dice que hizo;
+ * believe, but verify: el artefacto es el relato, no la ejecución.
+ */
+export function evidenceFromArtifact(artifactPath, cardId, requirement, opts = {}) {
+    const ref = artifactPath.replace(/\\/g, "/");
+    return makeEvidence({
+        cardId,
+        requirement,
+        kind: "artifact",
+        level: clampLevel(opts.level ?? 2, KIND_MAX_LEVEL.artifact),
+        ref,
+        note: opts.note ?? `artefacto ${path.basename(ref)}`,
+        passed: true,
+        opts,
+    });
+}
+/**
+ * Evidencia de test: un test citado que ejercita el requisito.
+ *
+ * Tope nivel 2: un test demuestra comportamiento, no criterio de negocio
+ * auditado. Si el test fue citado pero no lo cubre, el riesgo queda escrito
+ * en la nota; la auditoría de nivel 4 es la que verifica esa cobertura.
+ */
+export function evidenceFromTest(testRef, cardId, requirement, opts = {}) {
+    return makeEvidence({
+        cardId,
+        requirement,
+        kind: "test",
+        level: clampLevel(opts.level ?? 2, KIND_MAX_LEVEL.test),
+        ref: testRef,
+        note: opts.note ?? `test ${testRef}`,
+        passed: true,
+        opts,
+    });
+}
+/**
+ * Elige qué fase de un gate se cita como evidencia.
+ *
+ * Se prefiere la fase de tests: es la única que ejercita comportamiento, así
+ * que es la que aporta nivel 2. Si no hay fase de tests, se cita la primera
+ * disponible (build, typecheck, lint…) que aporta nivel 1.
+ */
+function pickGatePhase(input) {
+    const phases = [...(input.technical ?? []), ...(input.security ?? [])];
+    if (phases.length === 0)
+        return input;
+    return phases.find((p) => p.phase === "test") ?? phases[0];
+}
+/**
+ * Evidencia de gate: el resultado de una fase ejecutada.
+ *
+ * Nivel 2 solo para la fase de tests; el resto de fases son estáticas
+ * (nivel 1). Un gate que falló se registra igual, con `passed: false`: saber
+ * qué se rompió es información, no verificación.
+ */
+export function evidenceFromGate(gateResult, cardId, requirement, opts = {}) {
+    const cited = pickGatePhase(gateResult);
+    const phase = cited.phase ?? "gate";
+    const level = phase === "test" ? 2 : 1;
+    const passed = cited.outcome !== undefined ? cited.outcome === "pass" : (cited.passed ?? false);
+    const detail = opts.note ?? cited.detail ?? cited.reason ?? (cited.outcome ? `gate ${phase}: ${cited.outcome}` : `gate ${phase}`);
+    return makeEvidence({
+        cardId,
+        requirement,
+        kind: "gate",
+        level: clampLevel(opts.level ?? level, KIND_MAX_LEVEL.gate),
+        ref: `gate:${phase}`,
+        note: detail,
+        passed,
+        opts,
+    });
+}
+/**
+ * Evidencia de inspección manual documentada.
+ *
+ * Una inspección es nivel 3: alguien se puso a contrastar el resultado
+ * contra el criterio. Pasa a nivel 4 SOLO si la hizo un revisor distinto del
+ * owner, porque ahí deja de ser la opinión del autor y pasa a ser una
+ * auditoría que puede contradecirlo.
+ */
+export function evidenceFromInspection(inspectionRef, cardId, requirement, opts = {}) {
+    const isAudit = Boolean(opts.owner && opts.reviewer && opts.owner !== opts.reviewer);
+    const level = isAudit ? 4 : 3;
+    return makeEvidence({
+        cardId,
+        requirement,
+        kind: "inspection",
+        level: clampLevel(opts.level ?? level, KIND_MAX_LEVEL.inspection),
+        ref: inspectionRef,
+        note: opts.note ?? (isAudit ? `auditoría de ${opts.reviewer} (owner: ${opts.owner})` : `inspección ${inspectionRef}`),
+        passed: true,
+        opts,
+    });
+}
+/**
+ * Evidencia de auditoría independiente: la revisó un agente que no es el
+ * owner.
+ *
+ * A diferencia de `evidenceFromInspection`, acá el nivel 4 es parte del
+ * contrato: si no hay owner y revisor distintos, la auditoría no ocurrió y
+ * se lanza el error en vez de devolver una evidencia de nivel 3 con cara de
+ * auditoría. Un "audit" que en realidad es auto-revisión es el peor de los
+ * dos mundos: parece verificado y no lo está.
+ */
+export function evidenceFromAudit(auditRef, cardId, requirement, opts = {}) {
+    if (!opts.owner || !opts.reviewer) {
+        throw new Error("Una auditoría requiere owner y reviewer: sin ambos no se puede afirmar independencia");
+    }
+    if (opts.owner === opts.reviewer) {
+        throw new Error(`Una auditoría no puede tener al mismo owner y reviewer (${opts.owner})`);
+    }
+    return makeEvidence({
+        cardId,
+        requirement,
+        kind: "inspection",
+        level: clampLevel(opts.level ?? 4, KIND_MAX_LEVEL.inspection),
+        ref: auditRef,
+        note: opts.note ?? `auditoría de ${opts.reviewer} sobre el trabajo de ${opts.owner}`,
+        passed: true,
+        opts,
+    });
+}
+/**
+ * Evidencia externa: un link, una captura, un reporte de terceros.
+ *
+ * Nivel 1 por defecto. No se puede verificar desde adentro del repo, así que
+ * por sí sola no demuestra comportamiento; quien la registra puede subirla de
+ * nivel si documentó el contexto.
+ */
+export function evidenceFromExternal(externalRef, cardId, requirement, opts = {}) {
+    return makeEvidence({
+        cardId,
+        requirement,
+        kind: "external",
+        level: clampLevel(opts.level ?? 1, KIND_MAX_LEVEL.external),
+        ref: externalRef,
+        note: opts.note ?? `evidencia externa ${externalRef}`,
+        passed: true,
+        opts,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Veredicto de cierre
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * ¿Se puede declarar `done` esta card?
+ *
+ * Es el corazón del módulo. Responde con una razón legible, en español, que
+ * diga QUÉ falta — no solo que falta. Un "no" sin explicación hace que el
+ * agente adivine y vuelva a hacer lo mismo.
+ *
+ * Reglas:
+ * - Sin criterios de aceptación no hay nada verificable → no cierra.
+ * - Si algún requisito obligatorio no está `satisfied` → no cierra.
+ * - Si el nivel mínimo entre los obligatorios no alcanza el exigido → no cierra.
+ */
+export function canCloseCard(graph, limits = {}) {
+    const requireAcceptance = limits.requireAcceptance ?? true;
+    // El nivel exigido es el más estricto de los dos: el del grafo y el del
+    // que evalúa. Nadie baja el listón por pedido.
+    let requiredLevel = toLevel(Math.max(graph.requiredLevel ?? DEFAULT_REQUIRED_LEVEL, limits.requiredLevel ?? DEFAULT_REQUIRED_LEVEL));
+    if (requiredLevel === 0)
+        requiredLevel = DEFAULT_REQUIRED_LEVEL;
+    if (requireAcceptance && graph.requirements.length === 0) {
+        return {
+            ok: false,
+            reason: "La card no declara criterios de aceptación: no hay nada verificable, así que no puede declararse done.",
+        };
+    }
+    if (graph.missingMandatory.length > 0) {
+        const details = graph.requirements
+            .filter((r) => r.mandatory && r.status !== "satisfied")
+            .map((r) => `«${r.requirement}» (evidencia actual: nivel ${r.reachedLevel}, exigido: ${requiredLevel})`);
+        return {
+            ok: false,
+            reason: `Falta evidencia suficiente para ${graph.missingMandatory.length} requisito(s) obligatorio(s): ${details.join("; ")}.`,
+        };
+    }
+    // El chequeo de nivel solo aplica si hay requisitos obligatorios: `minLevel`
+    // en 0 con cero obligatorios significa "no hay nada que medir", no "nivel 0
+    // alcanzado". Confundir los dos volvería imposible de cerrar una card sin
+    // requisitos obligatorios.
+    const hasMandatory = graph.requirements.some((r) => r.mandatory);
+    if (hasMandatory && graph.minLevel < requiredLevel) {
+        return {
+            ok: false,
+            reason: `El nivel de evidencia mínimo entre los requisitos obligatorios (${graph.minLevel}) es inferior al exigido (${requiredLevel}).`,
+        };
+    }
+    const mandatoryCount = graph.requirements.filter((r) => r.mandatory).length;
+    return {
+        ok: true,
+        reason: `Los ${mandatoryCount} requisito(s) obligatorio(s) tienen evidencia suficiente (nivel mínimo ${graph.minLevel}, exigido ${requiredLevel}).`,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Render
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Renderiza el grafo como markdown legible.
+ *
+ * Va al artefacto de la card: un humano tiene que poder leer, en treinta
+ * segundos, si los criterios de aceptación del Commander están respaldados
+ * o si son deseos.
+ */
+export function renderEvidenceGraph(graph) {
+    const requiredLevel = graph.requiredLevel ?? DEFAULT_REQUIRED_LEVEL;
+    const lines = [];
+    lines.push(`# Grafo de evidencia — ${graph.cardId}`);
+    lines.push("");
+    lines.push(`**Resumen:** ${graph.summary}`);
+    lines.push("");
+    lines.push(`**Estado:** ${graph.complete ? "COMPLETO" : "INCOMPLETO"}`);
+    lines.push("");
+    lines.push(`**Nivel mínimo entre requisitos obligatorios:** ${graph.minLevel} (exigido: ${requiredLevel})`);
+    lines.push("");
+    lines.push("## Requisitos");
+    lines.push("");
+    lines.push("| # | Requisito | Obligatorio | Estado | Nivel | Evidencia |");
+    lines.push("|---|-----------|-------------|--------|-------|-----------|");
+    for (const r of graph.requirements) {
+        lines.push(`| ${r.index + 1} | ${escapeCell(r.requirement)} | ${r.mandatory ? "sí" : "no"} | ${r.status} | ${r.reachedLevel} | ${r.evidence.length} |`);
+    }
+    lines.push("");
+    lines.push("## Detalle por requisito");
+    lines.push("");
+    for (const r of graph.requirements) {
+        lines.push(`### ${r.index + 1}. ${r.requirement}`);
+        lines.push("");
+        lines.push(`- **Obligatorio:** ${r.mandatory ? "sí" : "no"}`);
+        lines.push(`- **Estado:** ${r.status}`);
+        lines.push(`- **Nivel alcanzado:** ${r.reachedLevel} / ${requiredLevel}`);
+        lines.push("");
+        if (r.evidence.length === 0) {
+            lines.push("- Sin evidencia registrada.");
+        }
+        else {
+            lines.push("**Evidencia:**");
+            lines.push("");
+            for (const e of r.evidence) {
+                const flag = e.passed === false ? " — FALLIDA" : "";
+                const note = e.note ? ` — ${e.note}` : "";
+                lines.push(`- \`${e.kind}\` **${e.ref}** (nivel ${e.level})${flag}${note} — registrado por ${e.recordedBy} (${e.recordedAt})`);
+            }
+        }
+        lines.push("");
+        lines.push("**Riesgos:**");
+        if (r.risks.length === 0) {
+            lines.push("- Ninguno.");
+        }
+        else {
+            for (const risk of r.risks) {
+                lines.push(`- ${risk}`);
+            }
+        }
+        lines.push("");
+    }
+    lines.push("## Requisitos obligatorios pendientes");
+    lines.push("");
+    if (graph.missingMandatory.length === 0) {
+        lines.push("- Ninguno: todos los requisitos obligatorios tienen evidencia suficiente.");
+    }
+    else {
+        for (const m of graph.missingMandatory) {
+            lines.push(`- ${m}`);
+        }
+    }
+    lines.push("");
+    const orphans = graph.orphanedEvidence ?? [];
+    if (orphans.length > 0) {
+        lines.push("## Evidencia sin vincular");
+        lines.push("");
+        for (const e of orphans) {
+            lines.push(`- \`${e.kind}\` ${e.ref} — cita «${e.requirement}», que no es un criterio de aceptación de esta card.`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=evidence.js.map

package/dist/core/evidence.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"fsx.d.ts","sourceRoot":"","sources":["../../src/core/fsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,yDAAyD;AACzD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnF;AAED,wDAAwD;AACxD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAe1E;AAED,oDAAoD;AACpD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO5E;AAED,yBAAyB;AACzB,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,uDAAuD;AACvD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,mEAAmE;AACnE,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOlE;AAED,yEAAyE;AACzE,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQjE;AAED,oCAAoC;AACpC,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,4CAA4C;AAC5C,wBAAgB,MAAM,CAAC,KAAK,GAAE,MAAM,MAAiB,GAAG,MAAM,CAE7D"}
+{"version":3,"file":"fsx.d.ts","sourceRoot":"","sources":["../../src/core/fsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,yDAAyD;AACzD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnF;AAED,wDAAwD;AACxD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAoB1E;AAED,oDAAoD;AACpD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO5E;AAED,yBAAyB;AACzB,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,uDAAuD;AACvD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,mEAAmE;AACnE,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOlE;AAED,yEAAyE;AACzE,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQjE;AAED,oCAAoC;AACpC,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,4CAA4C;AAC5C,wBAAgB,MAAM,CAAC,KAAK,GAAE,MAAM,MAAiB,GAAG,MAAM,CAE7D"}

package/dist/core/fsx.js

@@ -44,7 +44,13 @@ export async function readJson(filePath) {
         if (code === "ENOENT")
             return undefined;
         if (err instanceof SyntaxError) {
-            // Archivo corrupto o escritura a medio hacer. Se aparta y se sigue.
+            // Un archivo vacio casi siempre es una escritura en curso (otro
+            // proceso lo esta creando), no corrupcion. Ponerlo en cuarentena
+            // lo destruye: el escritor que estaba en medio pierde su archivo.
+            // Un archivo con contenido que no parsea SI es corrupcion.
+            const raw = await fs.readFile(filePath, "utf8").catch(() => "");
+            if (raw.trim().length === 0)
+                return undefined;
             const quarantine = `${filePath}.corrupt-${Date.now()}`;
             await fs.rename(filePath, quarantine).catch(() => { });
             return undefined;