expxdev 0.1.1 → 0.3.0

package/dist/parser/esquema/evento.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import { Ferramenta } from "./enums.js";
+/**
+ * Contrato `expx-eventos` v1 — a linha do rastro.
+ *
+ * Fonte única da regra das doze chaves. Ela já esteve escrita à mão em dois
+ * lugares (`runx/hooks/testes/testar.sh` e `stackx/hooks/stackx/_rastro.py`),
+ * e as duas listas divergiram do que as skills realmente gravam.
+ */
+/** As doze chaves obrigatórias, na ordem do contrato. */
+export const CHAVES_EVENTO = [
+    "ts",
+    "expx_eventos",
+    "trabalho_id",
+    "ferramenta",
+    "origem",
+    "evento",
+    "fase",
+    "task",
+    "agente",
+    "resultado",
+    "detalhe",
+    "arquivos",
+];
+/**
+ * Chaves extras que o contrato declara, por skill. Extras existem porque a
+ * alternativa — espremer a informação em `detalhe` — perde o dado para sempre.
+ */
+export const EXTRAS_EVENTO = ["hook", "faixa"];
+export const Origem = z.enum(["hook", "skill", "agente"]);
+export const EventoNome = z.enum([
+    "fase_iniciada",
+    "fase_concluida",
+    "task_iniciada",
+    "task_concluida",
+    "task_bloqueada",
+    "suite_executada",
+    "arquivo_alterado",
+    "regra_violada",
+    "acao_bloqueada",
+    "agente_iniciado",
+    "agente_concluido",
+    "veredito_emitido",
+    "commit_criado",
+    "pr_aberto",
+]);
+export const Agente = z.enum([
+    "principal",
+    "auditor-plano",
+    "revisor-testes",
+    "qa",
+    "investigador",
+    "cartografo",
+    "revisor-diff",
+    "analista-de-conflito",
+    "avaliador-de-raio",
+]);
+/** Timestamp do rastro: ISO-8601 em UTC, com `Z` (R4). */
+export const TimestampUtc = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/, "ts deve ser AAAA-MM-DDTHH:MM:SSZ");
+export const LinhaEvento = z
+    .object({
+    ts: TimestampUtc,
+    expx_eventos: z.literal(1),
+    trabalho_id: z.string().min(1),
+    ferramenta: Ferramenta,
+    origem: Origem,
+    evento: EventoNome,
+    fase: z.string().nullable(),
+    task: z.string().nullable(),
+    agente: Agente,
+    resultado: z.string().min(1),
+    detalhe: z.string(),
+    arquivos: z.array(z.string()),
+    hook: z.string().nullable().optional(),
+    faixa: z.string().nullable().optional(),
+})
+    // Extras declaradas passam; o que não é declarado é reportado por
+    // `chavesDesconhecidas`, não rejeitado — o rastro nunca trava trabalho.
+    .passthrough();
+/**
+ * As doze chaves estão CONTIDAS na linha?
+ *
+ * Contenção, nunca igualdade de conjunto: um validador estrito reprova as
+ * skills que usam extras legítimas — foi assim que a verificação da runx
+ * passou a reprovar toda linha da mergex e da legadox.
+ */
+export function chavesFaltando(obj) {
+    return CHAVES_EVENTO.filter((c) => !(c in obj));
+}
+/** Chaves presentes que o contrato não declara — aviso, não erro. */
+export function chavesDesconhecidas(obj) {
+    const conhecidas = new Set([...CHAVES_EVENTO, ...EXTRAS_EVENTO]);
+    return Object.keys(obj).filter((k) => !conhecidas.has(k));
+}
+/** Valida um arquivo `.jsonl` inteiro. Linha em branco é ignorada. */
+export function validarRastro(conteudo) {
+    const defeitos = [];
+    const desconhecidas = new Set();
+    let linhas = 0;
+    conteudo.split("\n").forEach((bruta, i) => {
+        if (!bruta.trim())
+            return;
+        linhas += 1;
+        const n = i + 1;
+        let obj;
+        try {
+            obj = JSON.parse(bruta);
+        }
+        catch {
+            defeitos.push({ linha: n, motivo: "JSON invalido" });
+            return;
+        }
+        if (typeof obj !== "object" || obj === null || Array.isArray(obj)) {
+            defeitos.push({ linha: n, motivo: "a linha nao e um objeto JSON" });
+            return;
+        }
+        const mapa = obj;
+        const faltando = chavesFaltando(mapa);
+        if (faltando.length > 0) {
+            defeitos.push({
+                linha: n,
+                motivo: `chave omitida: ${faltando.join(", ")} (use null; R6)`,
+            });
+        }
+        for (const k of chavesDesconhecidas(mapa))
+            desconhecidas.add(k);
+        const r = LinhaEvento.safeParse(mapa);
+        if (!r.success && faltando.length === 0) {
+            const p = r.error.issues[0];
+            const caminho = p?.path.join(".") ?? "";
+            defeitos.push({
+                linha: n,
+                motivo: `${caminho ? caminho + ": " : ""}${p?.message ?? "estrutura invalida"}`,
+            });
+        }
+    });
+    return { linhas, defeitos, desconhecidas: [...desconhecidas].sort() };
+}
+//# sourceMappingURL=evento.js.map

package/dist/parser/esquema/evento.js.map

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

package/dist/parser/leitura/rejeicao.d.ts

@@ -34,6 +34,15 @@ export type Aceito = {
     dados: Record<string, unknown>;
     corpo: string;
     linhas: Map<string, number>;
+    /**
+     * Chaves que o esquema aceita mas que NÃO estavam no arquivo (R6).
+     *
+     * O parse normaliza — `.optional()` some, `.default([])` inventa `[]` — e
+     * depois dele não dá mais para distinguir "veio null" de "nem veio". Quem
+     * quiser cobrar a R6 precisa desta lista, colhida enquanto o dado cru ainda
+     * existe. Caminho no formato do `linhas`: `tasks.0.criterio_aceite`.
+     */
+    omitidas: string[];
 };
 export type Resultado = Aceito | Rejeicao;
 /**

package/dist/parser/leitura/rejeicao.js

@@ -21,6 +21,61 @@ export const MotivoRejeicao = {
     VersaoAusente: "expx_schema ausente ou nao numerico",
     EstruturaInvalida: "estrutura incompativel com o kind",
 };
+/**
+ * Chaves que a R6 exige presentes mesmo quando o valor é `null`.
+ *
+ * São exatamente as que o esquema afrouxa com `.optional()` ou `.default([])`
+ * — o afrouxamento existe para o arquivo ser ACEITO (D-04), e esta lista existe
+ * para o defeito ainda assim aparecer. Campo que o esquema já exige não entra
+ * aqui: a ausência dele nem chega a este ponto.
+ */
+const EXIGIDAS_POR_KIND = {
+    // `tasks` e `fases` não entram aqui: nesses dois kinds os campos cobrados
+    // vivem DENTRO de cada item da lista, e são cobrados por EXIGIDAS_EM_ITEM.
+    // Cobrá-los também na raiz acusa toda task correta do mundo.
+    orquestrador: ["sprints", "caminho_critico"],
+    sprint: ["criterio_saida", "fases", "riscos"],
+    bloqueios: ["bloqueios"],
+    decisoes: ["decisoes"],
+};
+/** As chaves de item que a R6 cobra dentro de cada elemento de uma lista. */
+const EXIGIDAS_EM_ITEM = {
+    tasks: ["teste_integracao", "teste_funcional", "criterio_aceite", "depende_de"],
+    fases: ["criterio_saida", "paralela_com", "tasks"],
+};
+/** A lista que carrega os itens de cada kind, quando há uma. */
+const LISTA_DO_KIND = {
+    tasks: "tasks",
+    fases: "fases",
+};
+function colherOmitidas(kind, cru) {
+    if (typeof cru !== "object" || cru === null)
+        return [];
+    const raiz = cru;
+    const fora = [];
+    for (const chave of EXIGIDAS_POR_KIND[kind] ?? []) {
+        // `in` distingue ausência de `null` — que é justamente o ponto da R6.
+        if (!(chave in raiz))
+            fora.push(chave);
+    }
+    const nomeLista = LISTA_DO_KIND[kind];
+    const exigidasItem = EXIGIDAS_EM_ITEM[kind];
+    if (nomeLista && exigidasItem) {
+        const itens = raiz[nomeLista];
+        if (Array.isArray(itens)) {
+            itens.forEach((item, i) => {
+                if (typeof item !== "object" || item === null)
+                    return;
+                const m = item;
+                for (const chave of exigidasItem) {
+                    if (!(chave in m))
+                        fora.push(`${nomeLista}.${i}.${chave}`);
+                }
+            });
+        }
+    }
+    return fora;
+}
 function rejeitar(arquivo, motivo, detalhe, linha = null) {
     return { tipo: "rejeitado", arquivo, motivo, detalhe, linha };
 }
@@ -66,6 +121,7 @@ export function classificar(arquivo, conteudo) {
         arquivo,
         kind,
         dados: r.data,
+        omitidas: colherOmitidas(kind, leitura.dados),
         corpo: leitura.corpo,
         linhas: leitura.linhas,
     };

package/dist/parser/leitura/rejeicao.js.map

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

package/dist/parser/memoria/ler.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Lê o índice que o memox grava. O painel NUNCA invoca o motor (decisão D-01):
+ * o motor é Python, roda fora daqui, e o painel é somente leitura.
+ *
+ * A leitura falha ABERTA — devolve `null` em vez de lançar — e cada motivo é
+ * um caso real, não defesa hipotética:
+ *
+ *   arquivo ausente     o índice é local e o próprio motor acrescenta
+ *                       `.expx/memoria/` ao `.gitignore`. Quem clonou o
+ *                       repositório não tem índice, e isso é o normal.
+ *   JSON inválido       o motor reescreve o arquivo inteiro a cada
+ *                       reconstrução; ler no instante da gravação devolve
+ *                       JSON truncado — o mesmo risco que o observador já
+ *                       documenta para `tasks.md`.
+ *   versão desconhecida um índice gravado por versão futura pode ter outro
+ *                       formato, e adivinhar seria pior que não mostrar.
+ *
+ * A doutrina do painel inteiro é degradar mostrando, nunca quebrar (D-05).
+ */
+/** A versão do formato que este leitor entende. */
+export declare const VERSAO_SUPORTADA = 1;
+/** O índice cru, como está no disco. A projeção enxuta é feita em `projetar.ts`. */
+export type IndiceCru = {
+    versao: number;
+    gerado_em?: string;
+    totais?: Record<string, number>;
+    por_arquivo?: Record<string, unknown[]>;
+    por_modulo?: Record<string, unknown[]>;
+    sinais?: {
+        arquivo?: Record<string, unknown>;
+        modulo?: Record<string, unknown>;
+    };
+    regressoes?: unknown[];
+    coincidencias_arquivo?: unknown[];
+    artefatos_contaminados?: Record<string, string[]>;
+};
+export declare function caminhoDoIndice(raiz: string): string;
+export declare function lerIndice(raiz: string): IndiceCru | null;

package/dist/parser/memoria/ler.js

@@ -0,0 +1,46 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Lê o índice que o memox grava. O painel NUNCA invoca o motor (decisão D-01):
+ * o motor é Python, roda fora daqui, e o painel é somente leitura.
+ *
+ * A leitura falha ABERTA — devolve `null` em vez de lançar — e cada motivo é
+ * um caso real, não defesa hipotética:
+ *
+ *   arquivo ausente     o índice é local e o próprio motor acrescenta
+ *                       `.expx/memoria/` ao `.gitignore`. Quem clonou o
+ *                       repositório não tem índice, e isso é o normal.
+ *   JSON inválido       o motor reescreve o arquivo inteiro a cada
+ *                       reconstrução; ler no instante da gravação devolve
+ *                       JSON truncado — o mesmo risco que o observador já
+ *                       documenta para `tasks.md`.
+ *   versão desconhecida um índice gravado por versão futura pode ter outro
+ *                       formato, e adivinhar seria pior que não mostrar.
+ *
+ * A doutrina do painel inteiro é degradar mostrando, nunca quebrar (D-05).
+ */
+/** A versão do formato que este leitor entende. */
+export const VERSAO_SUPORTADA = 1;
+export function caminhoDoIndice(raiz) {
+    return join(raiz, ".expx", "memoria", "indice.json");
+}
+export function lerIndice(raiz) {
+    const caminho = caminhoDoIndice(raiz);
+    if (!existsSync(caminho))
+        return null;
+    let cru;
+    try {
+        cru = JSON.parse(readFileSync(caminho, "utf8"));
+    }
+    catch {
+        // JSON truncado pela gravação em curso: na próxima releitura vem inteiro
+        return null;
+    }
+    if (typeof cru !== "object" || cru === null || Array.isArray(cru))
+        return null;
+    const indice = cru;
+    if (indice.versao !== VERSAO_SUPORTADA)
+        return null;
+    return indice;
+}
+//# sourceMappingURL=ler.js.map

package/dist/parser/memoria/ler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ler.js","sourceRoot":"","sources":["../../../src/parser/memoria/ler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAelC,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,MAAM,MAAM,GAAG,GAAgB,CAAC;IAChC,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/parser/memoria/projetar.d.ts

@@ -0,0 +1,3 @@
+import type { IndiceCru } from "./ler.js";
+import type { Memoria } from "./tipos.js";
+export declare function projetar(indice: IndiceCru): Memoria;

package/dist/parser/memoria/projetar.js

@@ -0,0 +1,132 @@
+/**
+ * Reduz o índice cru à projeção que o painel serve.
+ *
+ * Duas chaves do índice NÃO entram (decisão D-04):
+ *
+ *   `por_termo`  índice invertido para a busca textual do motor. O painel
+ *                difunde o estado inteiro a cada mudança de arquivo (D-28),
+ *                então carregá-lo multiplicaria cada difusão sem ganho.
+ *   `trabalhos`  o registro completo de cada trabalho, que o painel já monta
+ *                por conta própria varrendo `docs/relatorios/`.
+ *
+ * Toda derivação — ordenar, contar, classificar — acontece AQUI e não na tela:
+ * `ui/src/tipos.ts` declara que a UI não recalcula nada (D-09).
+ */
+function texto(v) {
+    return typeof v === "string" && v !== "" ? v : null;
+}
+function numero(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+function entradasDe(lista) {
+    if (!Array.isArray(lista))
+        return [];
+    return lista.map((e) => {
+        const o = (e ?? {});
+        return {
+            trabalho_id: texto(o["trabalho_id"]) ?? "",
+            titulo: texto(o["titulo"]),
+            data: texto(o["data"]),
+            tipo: texto(o["tipo"]),
+            ferramenta: texto(o["ferramenta"]),
+            causa: texto(o["causa"]),
+            papel: texto(o["papel"]) ?? "",
+            artefato: texto(o["artefato"]) ?? "",
+        };
+    });
+}
+function regressoesDe(lista) {
+    if (!Array.isArray(lista))
+        return [];
+    return lista.map((r) => {
+        const o = (r ?? {});
+        return {
+            arquivos: Array.isArray(o["arquivos"]) ? o["arquivos"] : [],
+            trabalho_anterior: texto(o["trabalho_anterior"]) ?? "",
+            data_anterior: texto(o["data_anterior"]),
+            trabalho_posterior: texto(o["trabalho_posterior"]) ?? "",
+            data_posterior: texto(o["data_posterior"]),
+            evidencia: texto(o["evidencia"]) ?? "",
+            origem_causa: texto(o["origem_causa"]),
+            origem_alteracao: texto(o["origem_alteracao"]),
+        };
+    });
+}
+/**
+ * Ordena por RISCO, não por movimento (decisão D-10).
+ *
+ * A ordem é: regressões, depois reprovações de QA, depois número de trabalhos.
+ * Ordenar só por contagem de trabalhos colocaria o arquivo central no topo —
+ * ele é tocado por dezenas de trabalhos sem nunca ter falhado, e enterraria
+ * embaixo dele o arquivo que já quebrou duas vezes.
+ */
+function compararRisco(a, b) {
+    if (a.regressoes !== b.regressoes)
+        return b.regressoes - a.regressoes;
+    if (a.reprovacoes_qa !== b.reprovacoes_qa)
+        return b.reprovacoes_qa - a.reprovacoes_qa;
+    if (a.trabalhos !== b.trabalhos)
+        return b.trabalhos - a.trabalhos;
+    return a.arquivo.localeCompare(b.arquivo);
+}
+export function projetar(indice) {
+    const sinaisArquivo = (indice.sinais?.arquivo ?? {});
+    const sinaisModulo = (indice.sinais?.modulo ?? {});
+    const porArquivo = indice.por_arquivo ?? {};
+    const arquivos_de_risco = Object.entries(sinaisArquivo).map(([arquivo, s]) => {
+        const zona = s["zona_de_risco"];
+        const divida = s["divida"];
+        return {
+            arquivo,
+            trabalhos: numero(s["trabalhos"]),
+            ultimo_trabalho_em: texto(s["ultimo_trabalho_em"]),
+            reprovacoes_qa: numero(s["reprovacoes_qa"]),
+            regressoes: Array.isArray(s["regressoes"]) ? s["regressoes"].length : 0,
+            zona_de_risco: zona ? texto(zona["motivo"]) : null,
+            divida: divida ? texto(divida["descricao"]) : null,
+            risco_divida: divida ? texto(divida["risco"]) : null,
+            faixa_atencao: texto(s["faixa_atencao_frequente"]),
+            entradas: entradasDe(porArquivo[arquivo]),
+        };
+    });
+    arquivos_de_risco.sort(compararRisco);
+    const modulos = Object.entries(sinaisModulo).map(([modulo, s]) => ({
+        modulo,
+        trabalhos: numero(s["trabalhos"]),
+        ultimo_trabalho_em: texto(s["ultimo_trabalho_em"]),
+        reprovacoes_qa: numero(s["reprovacoes_qa"]),
+        regressoes: Array.isArray(s["regressoes"]) ? s["regressoes"].length : 0,
+        arquivos: Array.isArray(s["arquivos"]) ? s["arquivos"] : [],
+    }));
+    modulos.sort((a, b) => b.regressoes - a.regressoes || a.modulo.localeCompare(b.modulo));
+    const coincidencias = Array.isArray(indice.coincidencias_arquivo)
+        ? indice.coincidencias_arquivo.map((c) => {
+            const o = (c ?? {});
+            return {
+                arquivos: Array.isArray(o["arquivos"]) ? o["arquivos"] : [],
+                trabalhos: Array.isArray(o["trabalhos"]) ? o["trabalhos"] : [],
+                motivo: texto(o["motivo"]) ?? "",
+            };
+        })
+        : [];
+    const contaminados = Object.entries(indice.artefatos_contaminados ?? {}).map(([artefato, tipos]) => ({ artefato, tipos: Array.isArray(tipos) ? tipos : [] }));
+    const t = indice.totais ?? {};
+    return {
+        gerado_em: texto(indice.gerado_em) ?? "",
+        versao: indice.versao,
+        totais: {
+            trabalhos: numero(t["trabalhos"]),
+            arquivos: numero(t["arquivos"]),
+            modulos: numero(t["modulos"]),
+            regressoes: numero(t["regressoes"]),
+            coincidencias: numero(t["coincidencias"]),
+            artefatos_contaminados: numero(t["artefatos_contaminados"]),
+        },
+        arquivos_de_risco,
+        regressoes: regressoesDe(indice.regressoes),
+        coincidencias,
+        contaminados,
+        modulos,
+    };
+}
+//# sourceMappingURL=projetar.js.map

package/dist/parser/memoria/projetar.js.map

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

package/dist/parser/memoria/tipos.d.ts

@@ -0,0 +1,155 @@
+import { z } from "zod";
+/**
+ * A projeção enxuta do índice do memox.
+ *
+ * O painel NÃO serve o `indice.json` como veio do disco (decisão D-04). Duas
+ * chaves do índice ficam de fora de propósito:
+ *
+ *   `por_termo`   — índice invertido para a busca textual do motor. Na tela é
+ *                   peso morto, e o painel difunde o estado INTEIRO a cada
+ *                   mudança de arquivo (decisão D-28), então carregá-lo
+ *                   multiplicaria cada difusão sem ganho nenhum.
+ *   `trabalhos`   — o registro completo de cada trabalho, que o painel já monta
+ *                   por conta própria a partir de `docs/relatorios/`.
+ *
+ * O schema existe para validar em RUNTIME. Não é preciosismo: `tsconfig.json`
+ * exclui `**\/*.test.ts` e o vitest não faz typecheck, e a fixture da UI usa
+ * `as unknown as Estado` — nenhum dos dois acusaria um formato errado.
+ */
+/** Uma entrada do índice: um trabalho que tocou um arquivo ou um módulo. */
+export declare const EntradaSchema: z.ZodObject<{
+    trabalho_id: z.ZodString;
+    titulo: z.ZodNullable<z.ZodString>;
+    data: z.ZodNullable<z.ZodString>;
+    tipo: z.ZodNullable<z.ZodString>;
+    ferramenta: z.ZodNullable<z.ZodString>;
+    causa: z.ZodNullable<z.ZodString>;
+    papel: z.ZodString;
+    artefato: z.ZodString;
+}, z.core.$strip>;
+export type Entrada = z.infer<typeof EntradaSchema>;
+/**
+ * Uma regressão comprovada. Os dois caminhos de origem são o que torna a
+ * afirmação conferível: quem recebe o sinal pode abrir os dois e julgar.
+ */
+export declare const RegressaoSchema: z.ZodObject<{
+    arquivos: z.ZodArray<z.ZodString>;
+    trabalho_anterior: z.ZodString;
+    data_anterior: z.ZodNullable<z.ZodString>;
+    trabalho_posterior: z.ZodString;
+    data_posterior: z.ZodNullable<z.ZodString>;
+    evidencia: z.ZodString;
+    origem_causa: z.ZodNullable<z.ZodString>;
+    origem_alteracao: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type Regressao = z.infer<typeof RegressaoSchema>;
+/**
+ * Um vínculo que NÃO virou regressão, com o motivo. Isso não é sobra: é a
+ * prova de que o índice não inventa relação. Dois trabalhos tocando o mesmo
+ * arquivo é um fato; dizer que um causou o outro é uma afirmação.
+ */
+export declare const CoincidenciaSchema: z.ZodObject<{
+    arquivos: z.ZodArray<z.ZodString>;
+    trabalhos: z.ZodArray<z.ZodString>;
+    motivo: z.ZodString;
+}, z.core.$strip>;
+export type Coincidencia = z.infer<typeof CoincidenciaSchema>;
+/** Um arquivo com os sinais que o índice derivou sobre ele. */
+export declare const ArquivoDeRiscoSchema: z.ZodObject<{
+    arquivo: z.ZodString;
+    trabalhos: z.ZodNumber;
+    ultimo_trabalho_em: z.ZodNullable<z.ZodString>;
+    reprovacoes_qa: z.ZodNumber;
+    regressoes: z.ZodNumber;
+    zona_de_risco: z.ZodNullable<z.ZodString>;
+    divida: z.ZodNullable<z.ZodString>;
+    risco_divida: z.ZodNullable<z.ZodString>;
+    faixa_atencao: z.ZodNullable<z.ZodString>;
+    entradas: z.ZodArray<z.ZodObject<{
+        trabalho_id: z.ZodString;
+        titulo: z.ZodNullable<z.ZodString>;
+        data: z.ZodNullable<z.ZodString>;
+        tipo: z.ZodNullable<z.ZodString>;
+        ferramenta: z.ZodNullable<z.ZodString>;
+        causa: z.ZodNullable<z.ZodString>;
+        papel: z.ZodString;
+        artefato: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ArquivoDeRisco = z.infer<typeof ArquivoDeRiscoSchema>;
+export declare const ModuloSchema: z.ZodObject<{
+    modulo: z.ZodString;
+    trabalhos: z.ZodNumber;
+    ultimo_trabalho_em: z.ZodNullable<z.ZodString>;
+    reprovacoes_qa: z.ZodNumber;
+    regressoes: z.ZodNumber;
+    arquivos: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Modulo = z.infer<typeof ModuloSchema>;
+/** Artefato onde o memox detectou segredo. O valor já foi redigido na origem. */
+export declare const ContaminadoSchema: z.ZodObject<{
+    artefato: z.ZodString;
+    tipos: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Contaminado = z.infer<typeof ContaminadoSchema>;
+export declare const MemoriaSchema: z.ZodObject<{
+    gerado_em: z.ZodString;
+    versao: z.ZodNumber;
+    totais: z.ZodObject<{
+        trabalhos: z.ZodNumber;
+        arquivos: z.ZodNumber;
+        modulos: z.ZodNumber;
+        regressoes: z.ZodNumber;
+        coincidencias: z.ZodNumber;
+        artefatos_contaminados: z.ZodNumber;
+    }, z.core.$strip>;
+    arquivos_de_risco: z.ZodArray<z.ZodObject<{
+        arquivo: z.ZodString;
+        trabalhos: z.ZodNumber;
+        ultimo_trabalho_em: z.ZodNullable<z.ZodString>;
+        reprovacoes_qa: z.ZodNumber;
+        regressoes: z.ZodNumber;
+        zona_de_risco: z.ZodNullable<z.ZodString>;
+        divida: z.ZodNullable<z.ZodString>;
+        risco_divida: z.ZodNullable<z.ZodString>;
+        faixa_atencao: z.ZodNullable<z.ZodString>;
+        entradas: z.ZodArray<z.ZodObject<{
+            trabalho_id: z.ZodString;
+            titulo: z.ZodNullable<z.ZodString>;
+            data: z.ZodNullable<z.ZodString>;
+            tipo: z.ZodNullable<z.ZodString>;
+            ferramenta: z.ZodNullable<z.ZodString>;
+            causa: z.ZodNullable<z.ZodString>;
+            papel: z.ZodString;
+            artefato: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    regressoes: z.ZodArray<z.ZodObject<{
+        arquivos: z.ZodArray<z.ZodString>;
+        trabalho_anterior: z.ZodString;
+        data_anterior: z.ZodNullable<z.ZodString>;
+        trabalho_posterior: z.ZodString;
+        data_posterior: z.ZodNullable<z.ZodString>;
+        evidencia: z.ZodString;
+        origem_causa: z.ZodNullable<z.ZodString>;
+        origem_alteracao: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    coincidencias: z.ZodArray<z.ZodObject<{
+        arquivos: z.ZodArray<z.ZodString>;
+        trabalhos: z.ZodArray<z.ZodString>;
+        motivo: z.ZodString;
+    }, z.core.$strip>>;
+    contaminados: z.ZodArray<z.ZodObject<{
+        artefato: z.ZodString;
+        tipos: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    modulos: z.ZodArray<z.ZodObject<{
+        modulo: z.ZodString;
+        trabalhos: z.ZodNumber;
+        ultimo_trabalho_em: z.ZodNullable<z.ZodString>;
+        reprovacoes_qa: z.ZodNumber;
+        regressoes: z.ZodNumber;
+        arquivos: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Memoria = z.infer<typeof MemoriaSchema>;