expxdev 0.1.0

package/dist/parser/conformidade/regras.js

@@ -0,0 +1,209 @@
+import { estagioCoerenteCom } from "../esquema/enums.js";
+/**
+ * Violações do método — arquivos que o painel LEU e cujo conteúdo desobedece
+ * uma regra. Distinto de rejeição, que é falha de leitura (decisão D-03).
+ *
+ * Cada regra aqui tem um escopo estreito de propósito. A definição de pronto
+ * proíbe violação falsa, e todos os caminhos conhecidos para produzir uma
+ * nascem de aplicar uma regra a quem ela não se destina:
+ *
+ *  - regressão cobrada de trabalho sprintx, ou de runx que não é bug;
+ *  - critério de saída exigido de fase que não o declara por não existir;
+ *  - dependência inexistente acusada sem olhar o escopo do trabalho.
+ */
+export const TipoViolacao = {
+    TesteAusente: "teste_ausente",
+    RegressaoAusente: "regressao_ausente",
+    ConcluidaSemVerde: "concluida_sem_verde",
+    ParalelaComDependencia: "paralela_com_dependencia",
+    SemCriterioSaida: "sem_criterio_saida",
+    BloqueioAntigo: "bloqueio_antigo",
+    DependenciaInexistente: "dependencia_inexistente",
+    CicloDependencia: "ciclo_dependencia",
+    EstagioIncoerente: "estagio_incoerente",
+};
+const vazio = (v) => v === null || v === undefined || (typeof v === "string" && v.trim() === "");
+function diasEntre(inicio, fim) {
+    const a = Date.parse(`${inicio}T00:00:00Z`);
+    if (Number.isNaN(a))
+        return 0;
+    const b = Date.UTC(fim.getUTCFullYear(), fim.getUTCMonth(), fim.getUTCDate());
+    return Math.floor((b - a) / 86_400_000);
+}
+/** Todas as tasks de um trabalho, achatadas. */
+function tasksDe(t) {
+    return t.sprints.flatMap((s) => s.tasks);
+}
+function regrasDeTask(t, saida) {
+    const tasks = tasksDe(t);
+    for (const task of tasks) {
+        const base = {
+            trabalho_id: t.trabalho_id,
+            alvo: task.id,
+            arquivo: task.arquivo,
+            linha: task.linha,
+        };
+        // 1. teste obrigatório ausente, null, ou string vazia/só espaços
+        for (const campo of ["teste_integracao", "teste_funcional"]) {
+            if (vazio(task[campo])) {
+                saida.push({
+                    ...base,
+                    tipo: TipoViolacao.TesteAusente,
+                    detalhe: `${campo} esta ausente ou vazio`,
+                });
+            }
+        }
+        // 2. task concluída com suíte diferente de verde
+        if (task.status === "concluida" && task.suite !== "verde") {
+            saida.push({
+                ...base,
+                tipo: TipoViolacao.ConcluidaSemVerde,
+                detalhe: `task concluida com suite ${task.suite}`,
+            });
+        }
+        // 3. paralelizável com dependência declarada
+        if (task.paralelizavel && task.depende_de.length > 0) {
+            saida.push({
+                ...base,
+                tipo: TipoViolacao.ParalelaComDependencia,
+                detalhe: `paralelizavel: true com depende_de ${task.depende_de.join(", ")}`,
+            });
+        }
+    }
+    /**
+     * 4. bug sem teste de regressão na primeira task.
+     *
+     * ESCOPO ESTREITO DE PROPÓSITO: só trabalho runx com tipo_ocorrencia bug.
+     * O campo teste_regressao nem existe no contrato de task da sprintx, então
+     * cobrá-lo de um trabalho sprintx seria violação falsa (decisão D-07).
+     */
+    if (t.expx_tool === "runx" && t.tipo_ocorrencia === "bug" && tasks.length > 0) {
+        // "primeira task" = menor id na ordem natural (decisão D-08), estável
+        // independentemente de como a skill serializou a lista.
+        const primeira = [...tasks].sort((a, b) => a.id.localeCompare(b.id))[0];
+        if (primeira && vazio(primeira.teste_regressao)) {
+            saida.push({
+                tipo: TipoViolacao.RegressaoAusente,
+                trabalho_id: t.trabalho_id,
+                alvo: primeira.id,
+                arquivo: primeira.arquivo,
+                linha: primeira.linha,
+                detalhe: "primeira task de um bug sem teste_regressao",
+            });
+        }
+    }
+}
+function regrasDeEstrutura(t, saida, op) {
+    for (const s of t.sprints) {
+        if (vazio(s.criterio_saida)) {
+            saida.push({
+                tipo: TipoViolacao.SemCriterioSaida,
+                trabalho_id: t.trabalho_id,
+                alvo: s.sprint_id,
+                arquivo: s.arquivo ?? t.arquivo,
+                linha: s.linha,
+                detalhe: "sprint sem criterio_saida",
+            });
+        }
+        for (const f of s.fases) {
+            if (vazio(f.criterio_saida)) {
+                saida.push({
+                    tipo: TipoViolacao.SemCriterioSaida,
+                    trabalho_id: t.trabalho_id,
+                    alvo: f.id,
+                    arquivo: f.arquivo,
+                    linha: f.linha,
+                    detalhe: "fase sem criterio_saida",
+                });
+            }
+        }
+    }
+    for (const b of t.bloqueios) {
+        if (!b.aberto)
+            continue;
+        const dias = diasEntre(b.aberto_em, op.hoje);
+        if (dias > op.diasBloqueio) {
+            saida.push({
+                tipo: TipoViolacao.BloqueioAntigo,
+                trabalho_id: t.trabalho_id,
+                alvo: b.id,
+                arquivo: b.arquivo,
+                linha: b.linha,
+                detalhe: `aberto ha ${dias} dias (limite ${op.diasBloqueio})`,
+            });
+        }
+    }
+}
+function regrasDeReferencia(t, saida) {
+    const tasks = tasksDe(t);
+    const ids = new Set(tasks.map((x) => x.id));
+    for (const task of tasks) {
+        for (const dep of task.depende_de) {
+            if (!ids.has(dep)) {
+                saida.push({
+                    tipo: TipoViolacao.DependenciaInexistente,
+                    trabalho_id: t.trabalho_id,
+                    alvo: task.id,
+                    arquivo: task.arquivo,
+                    linha: task.linha,
+                    detalhe: `depende_de aponta ${dep}, que nao existe neste trabalho`,
+                });
+            }
+        }
+    }
+    // ciclo: busca em profundidade com marcação de cor, sem recursão infinita
+    const porId = new Map(tasks.map((x) => [x.id, x]));
+    const cor = new Map();
+    const emCiclo = new Set();
+    function visita(id, pilha) {
+        cor.set(id, 1);
+        for (const dep of porId.get(id)?.depende_de ?? []) {
+            if (!porId.has(dep))
+                continue;
+            if (cor.get(dep) === 1) {
+                for (const x of [...pilha.slice(pilha.indexOf(dep)), dep])
+                    emCiclo.add(x);
+                continue;
+            }
+            if ((cor.get(dep) ?? 0) === 0)
+                visita(dep, [...pilha, dep]);
+        }
+        cor.set(id, 2);
+    }
+    for (const id of porId.keys()) {
+        if ((cor.get(id) ?? 0) === 0)
+            visita(id, [id]);
+    }
+    for (const id of [...emCiclo].sort()) {
+        const task = porId.get(id);
+        saida.push({
+            tipo: TipoViolacao.CicloDependencia,
+            trabalho_id: t.trabalho_id,
+            alvo: id,
+            arquivo: task?.arquivo ?? t.arquivo,
+            linha: task?.linha ?? null,
+            detalhe: "task participa de um ciclo de dependencias",
+        });
+    }
+    // estágio coerente com a ferramenta que gravou (decisão D-10)
+    if (!estagioCoerenteCom(t.expx_tool, t.estagio)) {
+        saida.push({
+            tipo: TipoViolacao.EstagioIncoerente,
+            trabalho_id: t.trabalho_id,
+            alvo: t.trabalho_id,
+            arquivo: t.arquivo,
+            linha: t.linhas.get("estagio") ?? null,
+            detalhe: `expx_tool ${t.expx_tool} com estagio ${t.estagio}`,
+        });
+    }
+}
+export function verificarConformidade(projeto, op) {
+    const saida = [];
+    for (const t of projeto.trabalhos) {
+        regrasDeTask(t, saida);
+        regrasDeEstrutura(t, saida, op);
+        regrasDeReferencia(t, saida);
+    }
+    return saida;
+}
+//# sourceMappingURL=regras.js.map

package/dist/parser/conformidade/regras.js.map

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

package/dist/parser/descoberta/trabalhos.d.ts

@@ -0,0 +1,35 @@
+import type { Rejeicao, Aceito } from "../leitura/rejeicao.js";
+import type { ExpxTool, Estagio, StatusTrabalho, TipoTrabalho, TipoOcorrencia } from "../esquema/enums.js";
+/**
+ * Um trabalho é qualquer pasta com um `ORQUESTRADOR.md` de frontmatter válido.
+ * A regra é sobre o CONTEÚDO, não sobre o caminho: o layout `docs/<slug>/` e
+ * `docs/manutencao/<id>-<slug>/` descreve onde as skills gravam, não uma
+ * restrição de busca.
+ *
+ * Pasta sem ORQUESTRADOR é ignorada em silêncio (decisão D-12): `docs/` tem
+ * pastas legítimas que não são trabalho.
+ */
+export type Trabalho = {
+    trabalho_id: string;
+    titulo: string;
+    pasta: string;
+    arquivo: string;
+    expx_tool: ExpxTool;
+    tipo_trabalho: TipoTrabalho;
+    tipo_ocorrencia: TipoOcorrencia | null;
+    estagio: Estagio;
+    status: StatusTrabalho;
+    criado_em: string;
+    atualizado_em: string;
+    concluido_em: string | null;
+    sprints: string[];
+    caminho_critico: string[];
+    linhas: Map<string, number>;
+};
+export type Descoberta = {
+    trabalhos: Trabalho[];
+    rejeicoes: Rejeicao[];
+    /** Todos os arquivos aceitos, para as etapas seguintes não relerem o disco. */
+    aceitos: Aceito[];
+};
+export declare function descobrirTrabalhos(raiz: string): Descoberta;

package/dist/parser/descoberta/trabalhos.js

@@ -0,0 +1,28 @@
+import { basename, dirname } from "node:path";
+import { varrerCandidatos } from "./varredura.js";
+import { lerArquivoDeEstado } from "../leitura/arquivo.js";
+export function descobrirTrabalhos(raiz) {
+    const trabalhos = [];
+    const rejeicoes = [];
+    const aceitos = [];
+    for (const caminho of varrerCandidatos(raiz)) {
+        const r = lerArquivoDeEstado(caminho);
+        if (r.tipo === "rejeitado") {
+            rejeicoes.push(r);
+            continue;
+        }
+        aceitos.push(r);
+        if (r.kind !== "orquestrador" || basename(caminho) !== "ORQUESTRADOR.md")
+            continue;
+        const d = r.dados;
+        trabalhos.push({
+            ...d,
+            pasta: dirname(caminho),
+            arquivo: caminho,
+            linhas: r.linhas,
+        });
+    }
+    trabalhos.sort((a, b) => a.trabalho_id.localeCompare(b.trabalho_id));
+    return { trabalhos, rejeicoes, aceitos };
+}
+//# sourceMappingURL=trabalhos.js.map

package/dist/parser/descoberta/trabalhos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trabalhos.js","sourceRoot":"","sources":["../../../src/parser/descoberta/trabalhos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAuC3D,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhB,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,iBAAiB;YAAE,SAAS;QAEnF,MAAM,CAAC,GAAG,CAAC,CAAC,KAAkE,CAAC;QAC/E,SAAS,CAAC,IAAI,CAAC;YACb,GAAG,CAAC;YACJ,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC;YACvB,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/parser/descoberta/varredura.d.ts

@@ -0,0 +1,4 @@
+import { sep } from "node:path";
+export declare function ehCandidato(caminho: string): boolean;
+export declare function varrerCandidatos(raiz: string, profundidadeMax?: number): string[];
+export { sep };

package/dist/parser/descoberta/varredura.js

@@ -0,0 +1,79 @@
+import { readdirSync, statSync } from "node:fs";
+import { basename, join, sep } from "node:path";
+/**
+ * Quais arquivos são candidatos a arquivo de estado (decisão D-11).
+ *
+ * Isto é o que impede a tela "fora do schema" de virar ruído: as skills
+ * declaram explicitamente que os arquivos de recurso da base, o `00-LACUNAS.md`
+ * e o `00-AUDITORIA.md` NÃO levam frontmatter. Um projeto real tem dezenas
+ * deles. Varrer todo `.md` e reportar os sem frontmatter encheria a tela de
+ * falsos — exatamente o que a definição de pronto proíbe.
+ *
+ * Por isso a varredura é por nome conhecido, não por extensão.
+ */
+const NOMES_EXATOS = new Set([
+    "ORQUESTRADOR.md",
+    "00-BLOQUEIOS.md",
+    "BLOQUEIOS.md",
+    "00-DECISOES.md",
+    "00-OCORRENCIA.md",
+    "01-CAUSA-RAIZ.md",
+    "QA.md",
+    "sprint.md",
+    "fases.md",
+    "tasks.md",
+    "INDICE.md",
+    "tecnico.md",
+    "uso.md",
+    // so conta dentro de base/ — ver ehCandidato
+    "00-INDICE.md",
+]);
+const PASTAS_IGNORADAS = new Set(["node_modules", ".git", "dist", ".next", "coverage"]);
+export function ehCandidato(caminho) {
+    const partes = caminho.split(/[\\/]/);
+    if (partes.some((p) => PASTAS_IGNORADAS.has(p)))
+        return false;
+    const nome = basename(caminho);
+    if (!NOMES_EXATOS.has(nome))
+        return false;
+    // 00-INDICE.md só conta dentro de base/
+    if (nome === "00-INDICE.md") {
+        return partes[partes.length - 2] === "base";
+    }
+    // 00-LACUNAS.md e 00-AUDITORIA.md nunca são candidatos: sem frontmatter por contrato
+    return true;
+}
+export function varrerCandidatos(raiz, profundidadeMax = 12) {
+    const saida = [];
+    function desce(dir, nivel) {
+        if (nivel > profundidadeMax)
+            return;
+        let entradas;
+        try {
+            entradas = readdirSync(dir);
+        }
+        catch {
+            return; // pasta sumiu ou sem permissão: ignora, nunca derruba
+        }
+        for (const nome of entradas) {
+            if (PASTAS_IGNORADAS.has(nome))
+                continue;
+            const caminho = join(dir, nome);
+            let info;
+            try {
+                info = statSync(caminho);
+            }
+            catch {
+                continue;
+            }
+            if (info.isDirectory())
+                desce(caminho, nivel + 1);
+            else if (ehCandidato(caminho))
+                saida.push(caminho);
+        }
+    }
+    desce(raiz, 0);
+    return saida.sort();
+}
+export { sep };
+//# sourceMappingURL=varredura.js.map

package/dist/parser/descoberta/varredura.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"varredura.js","sourceRoot":"","sources":["../../../src/parser/descoberta/varredura.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhD;;;;;;;;;;GAUG;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,OAAO;IACP,WAAW;IACX,UAAU;IACV,UAAU;IACV,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,6CAA6C;IAC7C,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAExF,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,wCAAwC;IACxC,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC;IAC9C,CAAC;IACD,qFAAqF;IACrF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,eAAe,GAAG,EAAE;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS,KAAK,CAAC,GAAW,EAAE,KAAa;QACvC,IAAI,KAAK,GAAG,eAAe;YAAE,OAAO;QACpC,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,sDAAsD;QAChE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC;YACT,IAAI,CAAC;gBACH,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,EAAE;gBAAE,KAAK,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;iBAC7C,IAAI,WAAW,CAAC,OAAO,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,OAAO,EAAE,GAAG,EAAE,CAAC"}

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

@@ -0,0 +1,60 @@
+import { z } from "zod";
+/** Versão do contrato que este painel sabe ler (decisão D-09). */
+export declare const VERSAO_SUPORTADA = 1;
+/** Os treze kinds que o painel reconhece. */
+export declare const KINDS: readonly ["orquestrador", "sprint", "fases", "tasks", "bloqueios", "decisoes", "ocorrencia", "causa_raiz", "qa", "base_indice", "relatorio_tecnico", "relatorio_uso", "relatorios_indice"];
+export declare const Kind: z.ZodEnum<{
+    ocorrencia: "ocorrencia";
+    causa_raiz: "causa_raiz";
+    orquestrador: "orquestrador";
+    sprint: "sprint";
+    fases: "fases";
+    tasks: "tasks";
+    bloqueios: "bloqueios";
+    decisoes: "decisoes";
+    qa: "qa";
+    base_indice: "base_indice";
+    relatorio_tecnico: "relatorio_tecnico";
+    relatorio_uso: "relatorio_uso";
+    relatorios_indice: "relatorios_indice";
+}>;
+export type Kind = z.infer<typeof Kind>;
+/**
+ * `relatorios_indice` é o único kind sem `trabalho_id`: o índice é do sistema
+ * inteiro, não de um trabalho. Exigir as quatro chaves cegamente rejeitaria
+ * justamente a fonte da linha do tempo do histórico.
+ */
+export declare const KINDS_SEM_TRABALHO_ID: readonly Kind[];
+/**
+ * O cabeçalho comum. `expx_schema` é validado como número; a rejeição por
+ * versão futura é tratada à parte, com motivo próprio, para dar a mensagem
+ * que o pedido exige em vez de um erro genérico de esquema.
+ */
+export declare const Cabecalho: z.ZodObject<{
+    expx_schema: z.ZodNumber;
+    expx_tool: z.ZodEnum<{
+        sprintx: "sprintx";
+        runx: "runx";
+    }>;
+    kind: z.ZodEnum<{
+        ocorrencia: "ocorrencia";
+        causa_raiz: "causa_raiz";
+        orquestrador: "orquestrador";
+        sprint: "sprint";
+        fases: "fases";
+        tasks: "tasks";
+        bloqueios: "bloqueios";
+        decisoes: "decisoes";
+        qa: "qa";
+        base_indice: "base_indice";
+        relatorio_tecnico: "relatorio_tecnico";
+        relatorio_uso: "relatorio_uso";
+        relatorios_indice: "relatorios_indice";
+    }>;
+    trabalho_id: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type Cabecalho = z.infer<typeof Cabecalho>;
+/** O `kind` deste frontmatter, sem validar o resto — usado para rotear o esquema. */
+export declare function lerKind(dados: unknown): Kind | null;
+/** A versão declarada, ou null quando ausente/não numérica. */
+export declare function lerVersao(dados: unknown): number | null;

package/dist/parser/esquema/cabecalho.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { ExpxTool } from "./enums.js";
+/** Versão do contrato que este painel sabe ler (decisão D-09). */
+export const VERSAO_SUPORTADA = 1;
+/** Os treze kinds que o painel reconhece. */
+export const KINDS = [
+    "orquestrador",
+    "sprint",
+    "fases",
+    "tasks",
+    "bloqueios",
+    "decisoes",
+    "ocorrencia",
+    "causa_raiz",
+    "qa",
+    "base_indice",
+    "relatorio_tecnico",
+    "relatorio_uso",
+    "relatorios_indice",
+];
+export const Kind = z.enum(KINDS);
+/**
+ * `relatorios_indice` é o único kind sem `trabalho_id`: o índice é do sistema
+ * inteiro, não de um trabalho. Exigir as quatro chaves cegamente rejeitaria
+ * justamente a fonte da linha do tempo do histórico.
+ */
+export const KINDS_SEM_TRABALHO_ID = ["relatorios_indice"];
+/**
+ * O cabeçalho comum. `expx_schema` é validado como número; a rejeição por
+ * versão futura é tratada à parte, com motivo próprio, para dar a mensagem
+ * que o pedido exige em vez de um erro genérico de esquema.
+ */
+export const Cabecalho = z
+    .object({
+    expx_schema: z.number().int(),
+    expx_tool: ExpxTool,
+    kind: Kind,
+    trabalho_id: z.string().trim().min(1).optional(),
+})
+    .passthrough()
+    .refine((d) => KINDS_SEM_TRABALHO_ID.includes(d.kind) || typeof d.trabalho_id === "string", { message: "trabalho_id e obrigatorio neste kind", path: ["trabalho_id"] });
+/** O `kind` deste frontmatter, sem validar o resto — usado para rotear o esquema. */
+export function lerKind(dados) {
+    if (typeof dados !== "object" || dados === null)
+        return null;
+    const k = dados["kind"];
+    const r = Kind.safeParse(k);
+    return r.success ? r.data : null;
+}
+/** A versão declarada, ou null quando ausente/não numérica. */
+export function lerVersao(dados) {
+    if (typeof dados !== "object" || dados === null)
+        return null;
+    const v = dados["expx_schema"];
+    return typeof v === "number" && Number.isInteger(v) ? v : null;
+}
+//# sourceMappingURL=cabecalho.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cabecalho.js","sourceRoot":"","sources":["../../../src/parser/esquema/cabecalho.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,cAAc;IACd,QAAQ;IACR,OAAO;IACP,OAAO;IACP,WAAW;IACX,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,IAAI;IACJ,aAAa;IACb,mBAAmB;IACnB,eAAe;IACf,mBAAmB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAGlC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoB,CAAC,mBAAmB,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC7B,SAAS,EAAE,QAAQ;IACnB,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC;KACD,WAAW,EAAE;KACb,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,EAClF,EAAE,OAAO,EAAE,sCAAsC,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,CAC3E,CAAC;AAIJ,qFAAqF;AACrF,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,CAAC,GAAI,KAAiC,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,CAAC,GAAI,KAAiC,CAAC,aAAa,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,114 @@
+import { z } from "zod";
+/**
+ * Enums do contrato expx-schema v1.
+ *
+ * Regra 3 do contrato: todo valor de enum é minúsculo e sem acento.
+ * Duas distinções que o painel trata como coisas diferentes, e que um enum
+ * único apagaria em silêncio:
+ *
+ *  - `estagio` (f1..f6, e1..e5) é a máquina de estados do método. Não confundir
+ *    com o id de FASE do plano (`F-NN.M`), que vive em outro namespace.
+ *  - `status` de task usa o vocabulário feminino (`concluida`, `bloqueada`);
+ *    status de trabalho, sprint e fase usa o masculino (`concluido`, `bloqueado`).
+ */
+export declare const ExpxTool: z.ZodEnum<{
+    sprintx: "sprintx";
+    runx: "runx";
+}>;
+export type ExpxTool = z.infer<typeof ExpxTool>;
+export declare const TipoTrabalho: z.ZodEnum<{
+    feature: "feature";
+    ocorrencia: "ocorrencia";
+}>;
+export type TipoTrabalho = z.infer<typeof TipoTrabalho>;
+export declare const TipoOcorrencia: z.ZodEnum<{
+    bug: "bug";
+    "melhoria-ui": "melhoria-ui";
+    "melhoria-ux": "melhoria-ux";
+    "novo-relatorio": "novo-relatorio";
+    "regra-de-calculo": "regra-de-calculo";
+    "campo-novo": "campo-novo";
+    outro: "outro";
+}>;
+export type TipoOcorrencia = z.infer<typeof TipoOcorrencia>;
+/** Estágios da sprintx: F1 ingestão → F6 execução. */
+export declare const ESTAGIOS_SPRINTX: readonly ["f1", "f2", "f3", "f4", "f5", "f6"];
+/** Estágios da runx: E1 investigação → E5 relatório. */
+export declare const ESTAGIOS_RUNX: readonly ["e1", "e2", "e3", "e4", "e5"];
+export declare const Estagio: z.ZodEnum<{
+    f1: "f1";
+    f2: "f2";
+    f3: "f3";
+    f4: "f4";
+    f5: "f5";
+    f6: "f6";
+    e1: "e1";
+    e2: "e2";
+    e3: "e3";
+    e4: "e4";
+    e5: "e5";
+}>;
+export type Estagio = z.infer<typeof Estagio>;
+/** Status de trabalho, sprint e fase — vocabulário masculino. */
+export declare const StatusTrabalho: z.ZodEnum<{
+    nao_iniciado: "nao_iniciado";
+    em_andamento: "em_andamento";
+    bloqueado: "bloqueado";
+    concluido: "concluido";
+}>;
+export type StatusTrabalho = z.infer<typeof StatusTrabalho>;
+/** Status de task — vocabulário feminino. */
+export declare const StatusTask: z.ZodEnum<{
+    em_andamento: "em_andamento";
+    pendente: "pendente";
+    concluida: "concluida";
+    bloqueada: "bloqueada";
+}>;
+export type StatusTask = z.infer<typeof StatusTask>;
+/** Status de decisão — vocabulário próprio (kind `decisoes`, só sprintx). */
+export declare const StatusDecisao: z.ZodEnum<{
+    pendente: "pendente";
+    fechada: "fechada";
+}>;
+export type StatusDecisao = z.infer<typeof StatusDecisao>;
+export declare const Suite: z.ZodEnum<{
+    verde: "verde";
+    vermelha: "vermelha";
+    nao_executada: "nao_executada";
+}>;
+export type Suite = z.infer<typeof Suite>;
+export declare const Veredito: z.ZodEnum<{
+    aprovado: "aprovado";
+    reprovado: "reprovado";
+}>;
+export type Veredito = z.infer<typeof Veredito>;
+export declare const Severidade: z.ZodEnum<{
+    alta: "alta";
+    media: "media";
+    baixa: "baixa";
+}>;
+export type Severidade = z.infer<typeof Severidade>;
+export declare const ModoCausaRaiz: z.ZodEnum<{
+    causa_raiz: "causa_raiz";
+    analise_impacto: "analise_impacto";
+}>;
+export type ModoCausaRaiz = z.infer<typeof ModoCausaRaiz>;
+export declare const Evidencia: z.ZodEnum<{
+    teste_falho: "teste_falho";
+    log: "log";
+    codigo: "codigo";
+}>;
+export type Evidencia = z.infer<typeof Evidencia>;
+/**
+ * Data ISO `AAAA-MM-DD` (regra 4 do contrato).
+ *
+ * O js-yaml (dentro do gray-matter) resolve um escalar `2026-08-20` como
+ * objeto Date, não como string — então o parser recebe as duas formas
+ * dependendo de o valor estar ou não entre aspas no arquivo. Normalizamos
+ * para a string ISO, que é o que o contrato define e o painel exibe.
+ */
+export declare const DataIso: z.ZodUnion<readonly [z.ZodString, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>;
+/** Texto de uma linha, não vazio (regra 8 do contrato). */
+export declare const TextoUmaLinha: z.ZodString;
+/** Um estágio pertence à ferramenta que gravou o arquivo? (decisão D-10) */
+export declare function estagioCoerenteCom(tool: ExpxTool, estagio: Estagio): boolean;