expxdev 0.1.0 → 0.2.0

package/dist/parser/esquema/enums.d.ts

@@ -11,11 +11,30 @@ import { z } from "zod";
  *  - `status` de task usa o vocabulário feminino (`concluida`, `bloqueada`);
  *    status de trabalho, sprint e fase usa o masculino (`concluido`, `bloqueado`).
  */
+/**
+ * `expx_tool` — quem ESCREVEU um artefato de estado. Só a sprintx e a runx
+ * escrevem frontmatter `expx-schema`; as demais skills do método não têm kind
+ * próprio nesse contrato.
+ *
+ * Não confundir com `ferramenta`, do rastro de eventos (`Ferramenta`, abaixo),
+ * que aceita as seis. Tratar os dois como o mesmo enum rejeita o rastro de
+ * quatro skills.
+ */
 export declare const ExpxTool: z.ZodEnum<{
     sprintx: "sprintx";
     runx: "runx";
 }>;
 export type ExpxTool = z.infer<typeof ExpxTool>;
+/** `ferramenta` — quem EMITIU um evento no rastro. Todas as skills emitem. */
+export declare const Ferramenta: z.ZodEnum<{
+    sprintx: "sprintx";
+    runx: "runx";
+    mergex: "mergex";
+    legadox: "legadox";
+    stackx: "stackx";
+    memox: "memox";
+}>;
+export type Ferramenta = z.infer<typeof Ferramenta>;
 export declare const TipoTrabalho: z.ZodEnum<{
     feature: "feature";
     ocorrencia: "ocorrencia";

package/dist/parser/esquema/enums.js

@@ -11,7 +11,25 @@ import { z } from "zod";
  *  - `status` de task usa o vocabulário feminino (`concluida`, `bloqueada`);
  *    status de trabalho, sprint e fase usa o masculino (`concluido`, `bloqueado`).
  */
+/**
+ * `expx_tool` — quem ESCREVEU um artefato de estado. Só a sprintx e a runx
+ * escrevem frontmatter `expx-schema`; as demais skills do método não têm kind
+ * próprio nesse contrato.
+ *
+ * Não confundir com `ferramenta`, do rastro de eventos (`Ferramenta`, abaixo),
+ * que aceita as seis. Tratar os dois como o mesmo enum rejeita o rastro de
+ * quatro skills.
+ */
 export const ExpxTool = z.enum(["sprintx", "runx"]);
+/** `ferramenta` — quem EMITIU um evento no rastro. Todas as skills emitem. */
+export const Ferramenta = z.enum([
+    "sprintx",
+    "runx",
+    "mergex",
+    "legadox",
+    "stackx",
+    "memox",
+]);
 export const TipoTrabalho = z.enum(["feature", "ocorrencia"]);
 export const TipoOcorrencia = z.enum([
     "bug",

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

@@ -1 +1 @@
-{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/parser/esquema/enums.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAGpD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;AAG9D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,KAAK;IACL,aAAa;IACb,aAAa;IACb,gBAAgB;IAChB,kBAAkB;IAClB,YAAY;IACZ,OAAO;CACR,CAAC,CAAC;AAGH,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAE9E,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAErE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,gBAAgB,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;AAGvE,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAGjG,6CAA6C;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAGzF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAG7D,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;AAGpE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAG1D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAG7D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAGvE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGlE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC;KACrB,KAAK,CAAC;IACL,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;IACnE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;CACxD,CAAC,CAAC;AAEL,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;IACrF,OAAO,EAAE,uCAAuC;CACjD,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,IAAc,EAAE,OAAgB;IACjE,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAE,gBAAsC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC3D,CAAC,CAAE,aAAmC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/parser/esquema/enums.ts"],"names":[],"mappings":"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"}

package/dist/parser/esquema/evento.d.ts

@@ -0,0 +1,123 @@
+import { z } from "zod";
+/**
+ * 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 declare const CHAVES_EVENTO: readonly ["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 declare const EXTRAS_EVENTO: readonly ["hook", "faixa"];
+export declare const Origem: z.ZodEnum<{
+    agente: "agente";
+    hook: "hook";
+    skill: "skill";
+}>;
+export declare const EventoNome: z.ZodEnum<{
+    fase_iniciada: "fase_iniciada";
+    fase_concluida: "fase_concluida";
+    task_iniciada: "task_iniciada";
+    task_concluida: "task_concluida";
+    task_bloqueada: "task_bloqueada";
+    suite_executada: "suite_executada";
+    arquivo_alterado: "arquivo_alterado";
+    regra_violada: "regra_violada";
+    acao_bloqueada: "acao_bloqueada";
+    agente_iniciado: "agente_iniciado";
+    agente_concluido: "agente_concluido";
+    veredito_emitido: "veredito_emitido";
+    commit_criado: "commit_criado";
+    pr_aberto: "pr_aberto";
+}>;
+export declare const Agente: z.ZodEnum<{
+    qa: "qa";
+    principal: "principal";
+    "auditor-plano": "auditor-plano";
+    "revisor-testes": "revisor-testes";
+    investigador: "investigador";
+    cartografo: "cartografo";
+    "revisor-diff": "revisor-diff";
+    "analista-de-conflito": "analista-de-conflito";
+    "avaliador-de-raio": "avaliador-de-raio";
+}>;
+/** Timestamp do rastro: ISO-8601 em UTC, com `Z` (R4). */
+export declare const TimestampUtc: z.ZodString;
+export declare const LinhaEvento: z.ZodObject<{
+    ts: z.ZodString;
+    expx_eventos: z.ZodLiteral<1>;
+    trabalho_id: z.ZodString;
+    ferramenta: z.ZodEnum<{
+        sprintx: "sprintx";
+        runx: "runx";
+        mergex: "mergex";
+        legadox: "legadox";
+        stackx: "stackx";
+        memox: "memox";
+    }>;
+    origem: z.ZodEnum<{
+        agente: "agente";
+        hook: "hook";
+        skill: "skill";
+    }>;
+    evento: z.ZodEnum<{
+        fase_iniciada: "fase_iniciada";
+        fase_concluida: "fase_concluida";
+        task_iniciada: "task_iniciada";
+        task_concluida: "task_concluida";
+        task_bloqueada: "task_bloqueada";
+        suite_executada: "suite_executada";
+        arquivo_alterado: "arquivo_alterado";
+        regra_violada: "regra_violada";
+        acao_bloqueada: "acao_bloqueada";
+        agente_iniciado: "agente_iniciado";
+        agente_concluido: "agente_concluido";
+        veredito_emitido: "veredito_emitido";
+        commit_criado: "commit_criado";
+        pr_aberto: "pr_aberto";
+    }>;
+    fase: z.ZodNullable<z.ZodString>;
+    task: z.ZodNullable<z.ZodString>;
+    agente: z.ZodEnum<{
+        qa: "qa";
+        principal: "principal";
+        "auditor-plano": "auditor-plano";
+        "revisor-testes": "revisor-testes";
+        investigador: "investigador";
+        cartografo: "cartografo";
+        "revisor-diff": "revisor-diff";
+        "analista-de-conflito": "analista-de-conflito";
+        "avaliador-de-raio": "avaliador-de-raio";
+    }>;
+    resultado: z.ZodString;
+    detalhe: z.ZodString;
+    arquivos: z.ZodArray<z.ZodString>;
+    hook: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    faixa: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+export type LinhaEvento = z.infer<typeof LinhaEvento>;
+export type DefeitoEvento = {
+    linha: number;
+    motivo: string;
+};
+/**
+ * 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 declare function chavesFaltando(obj: Record<string, unknown>): string[];
+/** Chaves presentes que o contrato não declara — aviso, não erro. */
+export declare function chavesDesconhecidas(obj: Record<string, unknown>): string[];
+export type ResultadoRastro = {
+    linhas: number;
+    defeitos: DefeitoEvento[];
+    desconhecidas: string[];
+};
+/** Valida um arquivo `.jsonl` inteiro. Linha em branco é ignorada. */
+export declare function validarRastro(conteudo: string): ResultadoRastro;

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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAErF;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc,EAAE,wBAAwB;IACxC,YAAY,EAAE,eAAe;IAC7B,gBAAgB,EAAE,mBAAmB;IACrC,YAAY,EAAE,yBAAyB;IACvC,aAAa,EAAE,qCAAqC;IACpD,iBAAiB,EAAE,mCAAmC;CAC9C,CAAC;AAuBX,SAAS,QAAQ,CACf,OAAe,EACf,MAAsB,EACtB,OAAe,EACf,QAAuB,IAAI;IAE3B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,QAAgB;IAC3D,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,2EAA2E;QAC3E,OAAO,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,MAAM,GACV,OAAO,CAAC,IAAI,KAAK,iBAAiB;YAChC,CAAC,CAAC,cAAc,CAAC,cAAc;YAC/B,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC;QAClC,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,QAAQ,CACb,OAAO,EACP,cAAc,CAAC,aAAa,EAC5B,mCAAmC,EACnC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC9B,OAAO,QAAQ,CACb,OAAO,EACP,cAAc,CAAC,YAAY,EAC3B,6BAA6B,MAAM,0BAA0B,gBAAgB,sBAAsB,EACnG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAC1C,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,KAAK,GAAI,OAAO,CAAC,KAAiC,EAAE,CAAC,MAAM,CAAC,CAAC;QACnE,OAAO,QAAQ,CACb,OAAO,EACP,cAAc,CAAC,gBAAgB,EAC/B,QAAQ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,yBAAyB,EACtD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CACnC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC/C,OAAO,QAAQ,CACb,OAAO,EACP,cAAc,CAAC,iBAAiB,EAChC,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,OAAO,IAAI,oBAAoB,EAAE,EAC9E,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAClE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO;QACP,IAAI;QACJ,KAAK,EAAE,CAAC,CAAC,IAA+B;QACxC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC"}
+{"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;