@semacode/cli 1.5.36 → 1.5.38

package/dist/docs.part01.js

@@ -0,0 +1,347 @@
+// SEMA-GOVERNED: sema.governanca_ia_contexto
+// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
+import { readdir, stat } from "node:fs/promises";
+import path from "node:path";
+export const LIMITE_CONTEUDO_DOC = 16_000;
+export function normalizarTexto(valor) {
+    return valor
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase();
+}
+export function normalizarRelativo(valor) {
+    return valor.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+export const TERMOS_RELACAO_CONTRATO_IGNORADOS = new Set([
+    "acao",
+    "acoes",
+    "agente",
+    "agentes",
+    "alvo",
+    "alvos",
+    "arquivo",
+    "arquivos",
+    "codigo",
+    "contrato",
+    "contratos",
+    "docs",
+    "documentacao",
+    "fluxo",
+    "fluxos",
+    "governanca",
+    "mudanca",
+    "pacote",
+    "pacotes",
+    "para",
+    "pratica",
+    "pratico",
+    "projeto",
+    "readme",
+    "sema",
+    "src",
+]);
+export function separarTermosBusca(valor) {
+    return normalizarTexto(valor)
+        .split(/[^a-z0-9_]+/g)
+        .map((parte) => parte.trim())
+        .filter(Boolean);
+}
+export function termoContratoRelevante(termo) {
+    return termo.length >= 4 && !TERMOS_RELACAO_CONTRATO_IGNORADOS.has(termo);
+}
+export function nomeArquivoSemExtensao(relativo) {
+    const nome = normalizarRelativo(relativo).split("/").pop() ?? relativo;
+    return nome.replace(/\.[^.]+$/, "");
+}
+export function termosArquivoAlvoParaContrato(relativo) {
+    const nomeBase = normalizarTexto(nomeArquivoSemExtensao(relativo));
+    const termos = new Set();
+    if (termoContratoRelevante(nomeBase)) {
+        termos.add(nomeBase);
+    }
+    for (const parte of separarTermosBusca(nomeBase.replace(/_/g, " "))) {
+        if (termoContratoRelevante(parte)) {
+            termos.add(parte);
+        }
+    }
+    return [...termos];
+}
+export function termosRelacionamentoContratos(intencao, arquivosAlvo) {
+    const termos = new Set();
+    for (const termo of separarTermosBusca(intencao)) {
+        if (termoContratoRelevante(termo)) {
+            termos.add(termo);
+        }
+    }
+    for (const arquivo of arquivosAlvo) {
+        for (const termo of termosArquivoAlvoParaContrato(arquivo)) {
+            termos.add(termo);
+        }
+    }
+    return [...termos];
+}
+export function tituloDeRelativo(relativo) {
+    const base = path.basename(relativo, path.extname(relativo));
+    return base
+        .split(/[-_\s]+/)
+        .filter(Boolean)
+        .map((parte) => `${parte.charAt(0).toUpperCase()}${parte.slice(1)}`)
+        .join(" ");
+}
+export async function caminhoExiste(caminho) {
+    try {
+        await stat(caminho);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function caminhoEstaDentro(base, alvo) {
+    const relativo = path.relative(base, alvo);
+    return relativo === "" || (!relativo.startsWith("..") && !path.isAbsolute(relativo));
+}
+export async function listarArquivosRecursivo(base, limite = 80) {
+    const encontrados = [];
+    async function visitar(pasta) {
+        if (encontrados.length >= limite || !(await caminhoExiste(pasta))) {
+            return;
+        }
+        const entradas = await readdir(pasta, { withFileTypes: true });
+        for (const entrada of entradas.sort((a, b) => a.name.localeCompare(b.name, "pt-BR"))) {
+            if (encontrados.length >= limite) {
+                return;
+            }
+            const caminho = path.join(pasta, entrada.name);
+            if (entrada.isDirectory()) {
+                if (!["node_modules", ".git", ".tmp", "dist"].includes(entrada.name)) {
+                    await visitar(caminho);
+                }
+                continue;
+            }
+            encontrados.push(caminho);
+        }
+    }
+    await visitar(base);
+    return encontrados;
+}
+export const REGRAS_DOCUMENTACAO = [
+    {
+        categoria: "deploy",
+        padroes: [/deploy/, /publicar/, /producao/, /release/, /pipeline/, /\bci\b/, /\bcd\b/, /vercel/, /cloudflare/, /docker/],
+        docs: [
+            { relativo: "docs/deploy.md", tipo: "runbook", motivo: "runbook de deploy antes de publicar ou alterar pipeline", permitirCriacao: true },
+            { relativo: "docs/env.md", tipo: "runbook", motivo: "variaveis, secrets e ambientes usados no deploy", permitirCriacao: true },
+            { relativo: "docs/rollback.md", tipo: "runbook", motivo: "plano de rollback obrigatorio antes de deploy", permitirCriacao: true },
+        ],
+    },
+    {
+        categoria: "api",
+        padroes: [/rota/, /endpoint/, /\bapi\b/, /controller/, /webhook/, /http/],
+        docs: [
+            { relativo: "docs/api.md", tipo: "documentacao", motivo: "contrato operacional de rotas e endpoints", permitirCriacao: true },
+        ],
+    },
+    {
+        categoria: "author",
+        padroes: [/\bauthor\b/, /autoral/, /obra/, /cliche/, /estilo/, /personagem/, /narrativa/, /sensibility/, /sensitivity/],
+        docs: [
+            { relativo: "docs/profiles-author-agents-flow.md", tipo: "documentacao", motivo: "profile Author, agents, flow e guardrails autorais", permitirCriacao: false },
+        ],
+    },
+    {
+        categoria: "profile",
+        padroes: [/\bprofiles\b/, /\bworkflow\b/, /\bn8n\b/, /\bops\b/, /\bgame\b/, /\blegal\b/, /\bresearch\b/, /pesquisa/, /juridic/, /orquestracao/, /automacao/],
+        docs: [
+            { relativo: "docs/profiles.md", tipo: "documentacao", motivo: "profiles oficiais, gates e fronteiras de adapter", permitirCriacao: false },
+            { relativo: "docs/scorecard-compatibilidade.md", tipo: "documentacao", motivo: "scorecard de compatibilidade para runtimes e adapters", permitirCriacao: false },
+        ],
+    },
+    {
+        categoria: "auth",
+        padroes: [/(^|[^a-z0-9])auth([^a-z0-9]|$)/, /autentic/, /login/, /permiss/, /autoriz/, /token/, /oauth/, /seguranca/],
+        docs: [
+            { relativo: "docs/auth.md", tipo: "documentacao", motivo: "regras de autenticacao, autorizacao e tokens", permitirCriacao: true },
+            { relativo: "docs/seguranca.md", tipo: "documentacao", motivo: "politicas de seguranca afetadas pela mudanca", permitirCriacao: true },
+        ],
+    },
+    {
+        categoria: "persistencia",
+        padroes: [/banco/, /database/, /persist/, /migration/, /migracao/, /prisma/, /postgres/, /redis/, /mongodb/],
+        docs: [
+            { relativo: "docs/persistencia-vendor-first.md", tipo: "documentacao", motivo: "regras de persistencia vendor-first", permitirCriacao: false },
+            { relativo: "docs/database.md", tipo: "runbook", motivo: "operacao de banco, migracoes e validacao de dados", permitirCriacao: true },
+        ],
+    },
+    {
+        categoria: "mcp",
+        padroes: [/\bmcp\b/, /tool/, /ferramenta/, /server/, /streamable/, /sse/],
+        docs: [
+            { relativo: "docs/integracao-com-ia.md", tipo: "documentacao", motivo: "integracao do Sema com agentes IA", permitirCriacao: false },
+            { relativo: "docs/mcp.md", tipo: "documentacao", motivo: "runbook do MCP privado e ferramentas remotas", permitirCriacao: true },
+        ],
+    },
+    {
+        categoria: "cli",
+        padroes: [/\bcli\b/, /comando/, /terminal/],
+        docs: [
+            { relativo: "pacotes/cli/README.md", tipo: "pacote", motivo: "documentacao publica da CLI", permitirCriacao: false },
+            { relativo: "docs/cli.md", tipo: "documentacao", motivo: "guia operacional dos comandos da CLI", permitirCriacao: false },
+        ],
+    },
+    {
+        categoria: "extensao",
+        padroes: [/vscode/, /extension/, /extensao/, /editor/, /\blsp\b/, /language server/],
+        docs: [
+            { relativo: "pacotes/editor-vscode/README.md", tipo: "pacote", motivo: "documentacao publica da extensao VS Code", permitirCriacao: false },
+            { relativo: "docs/extensao-vscode.md", tipo: "documentacao", motivo: "runbook da extensao VS Code", permitirCriacao: true },
+        ],
+    },
+    {
+        categoria: "contrato",
+        padroes: [/contrato/, /\.sema/, /semant/, /\bsema\b/, /drift/, /governanca/],
+        docs: [
+            { relativo: "docs/sintaxe.md", tipo: "documentacao", motivo: "sintaxe e blocos de contrato Sema", permitirCriacao: false },
+            { relativo: "docs/fluxo-pratico-ia-sema.md", tipo: "documentacao", motivo: "fluxo IA-first antes de editar contratos", permitirCriacao: false },
+        ],
+    },
+    {
+        categoria: "frontend",
+        padroes: [/frontend/, /\bui\b/, /react/, /vite/, /next/, /css/, /html/, /pagina/],
+        docs: [
+            { relativo: "docs/frontend.md", tipo: "documentacao", motivo: "decisoes e validacoes de interface", permitirCriacao: true },
+        ],
+    },
+    {
+        categoria: "testes",
+        padroes: [/teste/, /testar/, /qa/, /validacao/, /regressao/],
+        docs: [
+            { relativo: "docs/testes.md", tipo: "runbook", motivo: "estrategia de testes e regressao", permitirCriacao: true },
+        ],
+    },
+    {
+        categoria: "documentacao",
+        padroes: [/doc/, /readme/, /manual/, /runbook/, /onboarding/],
+        docs: [
+            { relativo: "docs/README.md", tipo: "documentacao", motivo: "indice de documentacao do projeto", permitirCriacao: false },
+            { relativo: "docs/documentacao.md", tipo: "documentacao", motivo: "politica de atualizacao documental", permitirCriacao: true },
+        ],
+    },
+];
+export function inferirCategorias(intencao, arquivosAlvo) {
+    const texto = normalizarTexto(`${intencao} ${arquivosAlvo.join(" ")}`);
+    const categorias = REGRAS_DOCUMENTACAO
+        .filter((regra) => regra.padroes.some((padrao) => padrao.test(texto)))
+        .map((regra) => regra.categoria);
+    return categorias.length > 0 ? [...new Set(categorias)] : ["mudanca"];
+}
+export function criarTemplateDoc(doc, intencao, categorias, arquivosAlvo) {
+    const titulo = tituloDeRelativo(doc.relativo);
+    const linhas = [
+        `# ${titulo}`,
+        "",
+        "## English",
+        "",
+        "This document was created by Sema because an AI declared an intention that requires operational reading before action.",
+        "",
+        "## Português",
+        "",
+        "Documento criado pela Sema porque uma IA declarou uma intenção que exige leitura operacional antes de agir.",
+        "",
+        "## Español",
+        "",
+        "Documento creado por Sema porque una IA declaró una intención que exige lectura operativa antes de actuar.",
+        "",
+        "## Intenção",
+        "",
+        intencao || "Descrever a intenção operacional antes de executar a mudança.",
+        "",
+        "## Escopo",
+        "",
+        arquivosAlvo.length > 0
+            ? arquivosAlvo.map((arquivo) => `- ${arquivo}`).join("\n")
+            : "- Declarar os arquivos, serviços ou contratos afetados.",
+        "",
+        "## Leitura obrigatória antes de agir",
+        "",
+        "- Ler este documento inteiro.",
+        "- Ler contratos .sema relacionados antes de editar código.",
+        "- Ler README, runbooks e docs de pacote envolvidos.",
+        "",
+        "## Procedimento",
+        "",
+        "- Descrever os comandos ou passos seguros.",
+        "- Declarar pré-condições, variáveis e dependências.",
+        "- Registrar como validar sucesso.",
+        "",
+        "## Validação",
+        "",
+        "- Listar comandos de build, teste, verificação ou smoke test.",
+        "- Registrar evidências esperadas.",
+        "",
+        "## Rollback",
+        "",
+        "- Descrever como desfazer a mudança.",
+        "- Declarar sinais que exigem rollback.",
+        "",
+        "## Atualização documental",
+        "",
+        "- Atualizar este arquivo quando o fluxo operacional mudar.",
+        "- Atualizar docs e contratos relacionados na mesma mudança.",
+        "",
+        `Categorias inferidas: ${categorias.join(", ")}`,
+        "",
+    ];
+    return `${linhas.join("\n")}\n`;
+}
+export function resumoConteudo(conteudo) {
+    if (conteudo.length <= LIMITE_CONTEUDO_DOC) {
+        return { conteudo, truncado: false };
+    }
+    return {
+        conteudo: `${conteudo.slice(0, LIMITE_CONTEUDO_DOC)}\n\n[TRUNCADO PELO SEMA: leia o arquivo completo antes de agir.]`,
+        truncado: true,
+    };
+}
+export async function adicionarDocsRaizExistentes(baseProjeto, registrar) {
+    const docsRaiz = [
+        { relativo: "AGENTS.md", tipo: "raiz", motivo: "regras obrigatorias do agente no projeto" },
+        { relativo: "SEMA_INDEX.json", tipo: "raiz", motivo: "indice IA-first do projeto" },
+        { relativo: "README.md", tipo: "raiz", motivo: "visao geral publica do projeto" },
+        { relativo: "docs/README.md", tipo: "documentacao", motivo: "indice de documentacao" },
+    ];
+    for (const doc of docsRaiz) {
+        if (await caminhoExiste(path.join(baseProjeto, doc.relativo))) {
+            registrar({ ...doc, permitirCriacao: false });
+        }
+    }
+}
+export async function adicionarReadmesDeArquivos(baseProjeto, arquivosAlvo, registrar) {
+    for (const arquivo of arquivosAlvo) {
+        const absoluto = path.resolve(baseProjeto, arquivo);
+        if (!caminhoEstaDentro(baseProjeto, absoluto)) {
+            continue;
+        }
+        let pasta = (await caminhoExiste(absoluto)) && (await stat(absoluto)).isDirectory()
+            ? absoluto
+            : path.dirname(absoluto);
+        while (caminhoEstaDentro(baseProjeto, pasta)) {
+            const readme = path.join(pasta, "README.md");
+            if (await caminhoExiste(readme)) {
+                registrar({
+                    relativo: normalizarRelativo(path.relative(baseProjeto, readme)),
+                    tipo: "pacote",
+                    motivo: `README mais proximo de ${normalizarRelativo(arquivo)}`,
+                    permitirCriacao: false,
+                });
+                break;
+            }
+            const proxima = path.dirname(pasta);
+            if (proxima === pasta) {
+                break;
+            }
+            pasta = proxima;
+        }
+    }
+}
+//# sourceMappingURL=docs.part01.js.map

package/dist/docs.part01.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.part01.js","sourceRoot":"","sources":["../src/docs.part01.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,oGAAoG;AAEpG,OAAO,EAAmB,OAAO,EAAE,IAAI,EAAa,MAAM,kBAAkB,CAAC;AAC7E,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAqE1C,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK;SACT,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,GAAG,CAAC;IACvD,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,SAAS;IACT,UAAU;IACV,QAAQ;IACR,UAAU;IACV,WAAW;IACX,MAAM;IACN,cAAc;IACd,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,SAAS;IACT,MAAM;IACN,SAAS;IACT,SAAS;IACT,SAAS;IACT,QAAQ;IACR,MAAM;IACN,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,eAAe,CAAC,KAAK,CAAC;SAC1B,KAAK,CAAC,cAAc,CAAC;SACrB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,iCAAiC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;IACvE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,MAAM,QAAQ,GAAG,eAAe,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,IAAI,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACpE,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAgB,EAAE,YAAsB;IACpF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,6BAA6B,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,OAAO,IAAI;SACR,KAAK,CAAC,SAAS,CAAC;SAChB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAY;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAY,EAAE,MAAM,GAAG,EAAE;IACrE,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,UAAU,OAAO,CAAC,KAAa;QAClC,IAAI,WAAW,CAAC,MAAM,IAAI,MAAM,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAClE,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;YACrF,IAAI,WAAW,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;gBACjC,OAAO;YACT,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;gBACD,SAAS;YACX,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD;QACE,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC;QACxH,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,yDAAyD,EAAE,eAAe,EAAE,IAAI,EAAE;YACzI,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,iDAAiD,EAAE,eAAe,EAAE,IAAI,EAAE;YAC9H,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,+CAA+C,EAAE,eAAe,EAAE,IAAI,EAAE;SAClI;KACF;IACD;QACE,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC;QACzE,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,2CAA2C,EAAE,eAAe,EAAE,IAAI,EAAE;SAC9H;KACF;IACD;QACE,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC;QACvH,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,qCAAqC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,oDAAoD,EAAE,eAAe,EAAE,KAAK,EAAE;SAChK;KACF;IACD;QACE,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,CAAC;QAC5J,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,kDAAkD,EAAE,eAAe,EAAE,KAAK,EAAE;YAC1I,EAAE,QAAQ,EAAE,mCAAmC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,uDAAuD,EAAE,eAAe,EAAE,KAAK,EAAE;SACjK;KACF;IACD;QACE,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE,CAAC,gCAAgC,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC;QACrH,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,8CAA8C,EAAE,eAAe,EAAE,IAAI,EAAE;YACjI,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,8CAA8C,EAAE,eAAe,EAAE,IAAI,EAAE;SACvI;KACF;IACD;QACE,SAAS,EAAE,cAAc;QACzB,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC;QAC5G,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,mCAAmC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,qCAAqC,EAAE,eAAe,EAAE,KAAK,EAAE;YAC9I,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,mDAAmD,EAAE,eAAe,EAAE,IAAI,EAAE;SACtI;KACF;IACD;QACE,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC;QACzE,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,2BAA2B,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,mCAAmC,EAAE,eAAe,EAAE,KAAK,EAAE;YACpI,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,8CAA8C,EAAE,eAAe,EAAE,IAAI,EAAE;SACjI;KACF;IACD;QACE,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;QAC3C,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,6BAA6B,EAAE,eAAe,EAAE,KAAK,EAAE;YACpH,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,sCAAsC,EAAE,eAAe,EAAE,KAAK,EAAE;SAC1H;KACF;IACD;QACE,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,CAAC;QACpF,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,0CAA0C,EAAE,eAAe,EAAE,KAAK,EAAE;YAC3I,EAAE,QAAQ,EAAE,yBAAyB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,6BAA6B,EAAE,eAAe,EAAE,IAAI,EAAE;SAC5H;KACF;IACD;QACE,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC;QAC5E,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,mCAAmC,EAAE,eAAe,EAAE,KAAK,EAAE;YAC1H,EAAE,QAAQ,EAAE,+BAA+B,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,0CAA0C,EAAE,eAAe,EAAE,KAAK,EAAE;SAChJ;KACF;IACD;QACE,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC;QACjF,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,oCAAoC,EAAE,eAAe,EAAE,IAAI,EAAE;SAC5H;KACF;IACD;QACE,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC;QAC5D,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,kCAAkC,EAAE,eAAe,EAAE,IAAI,EAAE;SACnH;KACF;IACD;QACE,SAAS,EAAE,cAAc;QACzB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC;QAC7D,IAAI,EAAE;YACJ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,mCAAmC,EAAE,eAAe,EAAE,KAAK,EAAE;YACzH,EAAE,QAAQ,EAAE,sBAAsB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,oCAAoC,EAAE,eAAe,EAAE,IAAI,EAAE;SAChI;KACF;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,YAAsB;IACxE,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,mBAAmB;SACnC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;SACrE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAuB,EAAE,QAAgB,EAAE,UAAoB,EAAE,YAAsB;IACtH,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG;QACb,KAAK,MAAM,EAAE;QACb,EAAE;QACF,YAAY;QACZ,EAAE;QACF,wHAAwH;QACxH,EAAE;QACF,cAAc;QACd,EAAE;QACF,6GAA6G;QAC7G,EAAE;QACF,YAAY;QACZ,EAAE;QACF,4GAA4G;QAC5G,EAAE;QACF,aAAa;QACb,EAAE;QACF,QAAQ,IAAI,+DAA+D;QAC3E,EAAE;QACF,WAAW;QACX,EAAE;QACF,YAAY,CAAC,MAAM,GAAG,CAAC;YACrB,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1D,CAAC,CAAC,yDAAyD;QAC7D,EAAE;QACF,sCAAsC;QACtC,EAAE;QACF,+BAA+B;QAC/B,4DAA4D;QAC5D,qDAAqD;QACrD,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,4CAA4C;QAC5C,qDAAqD;QACrD,mCAAmC;QACnC,EAAE;QACF,cAAc;QACd,EAAE;QACF,+DAA+D;QAC/D,mCAAmC;QACnC,EAAE;QACF,aAAa;QACb,EAAE;QACF,sCAAsC;QACtC,wCAAwC;QACxC,EAAE;QACF,2BAA2B;QAC3B,EAAE;QACF,4DAA4D;QAC5D,6DAA6D;QAC7D,EAAE;QACF,yBAAyB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAChD,EAAE;KACH,CAAC;IAEF,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,QAAQ,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAC3C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,kEAAkE;QACrH,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,WAAmB,EAAE,SAA4C;IACjH,MAAM,QAAQ,GAAG;QACf,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,MAAe,EAAE,MAAM,EAAE,0CAA0C,EAAE;QACpG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAe,EAAE,MAAM,EAAE,4BAA4B,EAAE;QAC5F,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,MAAe,EAAE,MAAM,EAAE,gCAAgC,EAAE;QAC1F,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAuB,EAAE,MAAM,EAAE,wBAAwB,EAAE;KAChG,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC9D,SAAS,CAAC,EAAE,GAAG,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAAmB,EACnB,YAAsB,EACtB,SAA4C;IAE5C,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC9C,SAAS;QACX,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE;YACjF,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE3B,OAAO,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAC7C,IAAI,MAAM,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,SAAS,CAAC;oBACR,QAAQ,EAAE,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;oBAChE,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,0BAA0B,kBAAkB,CAAC,OAAO,CAAC,EAAE;oBAC/D,eAAe,EAAE,KAAK;iBACvB,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,MAAM;YACR,CAAC;YACD,KAAK,GAAG,OAAO,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/docs.part02.d.ts

@@ -0,0 +1,20 @@
+import { DocumentoObrigatorioMudanca, DocumentoPlanejado, ResultadoDocumentacaoObrigatoria, ResultadoVerificacaoDocumentacaoMudanca } from "./docs.part01.js";
+export declare function adicionarContratosRelacionados(baseProjeto: string, intencao: string, arquivosAlvo: string[], registrar: (doc: DocumentoPlanejado) => void): Promise<void>;
+export declare function criarRegistrador(baseProjeto: string): {
+    docs: DocumentoPlanejado[];
+    registrar: (doc: DocumentoPlanejado) => void;
+};
+export declare function resolverDocumentacaoObrigatoria(opcoes: {
+    baseProjeto?: string;
+    intencao: string;
+    arquivosAlvo?: string[];
+    criarAusentes?: boolean;
+}): Promise<ResultadoDocumentacaoObrigatoria>;
+export declare function normalizarDocLida(baseProjeto: string, valor: string): string;
+export declare function compactarDocumentoObrigatorio(doc: DocumentoObrigatorioMudanca): DocumentoObrigatorioMudanca;
+export declare function verificarDocumentacaoMudanca(opcoes: {
+    baseProjeto?: string;
+    intencao: string;
+    arquivosAlvo?: string[];
+    docsLidas?: string[];
+}): Promise<ResultadoVerificacaoDocumentacaoMudanca>;

package/dist/docs.part02.js

@@ -0,0 +1,181 @@
+// SEMA-GOVERNED: sema.governanca_ia_contexto
+// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { emitirDiagnosticosArquivosOrcamento } from "./driftOrcamento.js";
+import { REGRAS_DOCUMENTACAO, adicionarDocsRaizExistentes, adicionarReadmesDeArquivos, caminhoEstaDentro, caminhoExiste, criarTemplateDoc, inferirCategorias, listarArquivosRecursivo, normalizarRelativo, normalizarTexto, resumoConteudo, termosRelacionamentoContratos } from "./docs.part01.js";
+export async function adicionarContratosRelacionados(baseProjeto, intencao, arquivosAlvo, registrar) {
+    const pastaContratos = path.join(baseProjeto, "contratos");
+    if (!(await caminhoExiste(pastaContratos))) {
+        return;
+    }
+    const termos = termosRelacionamentoContratos(intencao, arquivosAlvo);
+    const arquivos = (await listarArquivosRecursivo(pastaContratos)).filter((arquivo) => arquivo.endsWith(".sema"));
+    for (const arquivo of arquivos) {
+        const relativo = normalizarRelativo(path.relative(baseProjeto, arquivo));
+        const nome = normalizarTexto(relativo);
+        const relacionado = termos.some((parte) => nome.includes(parte));
+        if (relacionado) {
+            registrar({
+                relativo,
+                tipo: "contrato",
+                motivo: "contrato Sema relacionado a intencao declarada",
+                permitirCriacao: false,
+            });
+        }
+    }
+}
+export function criarRegistrador(baseProjeto) {
+    const docs = [];
+    const vistos = new Set();
+    return {
+        docs,
+        registrar(doc) {
+            const relativo = normalizarRelativo(doc.relativo);
+            const absoluto = path.resolve(baseProjeto, relativo);
+            if (!caminhoEstaDentro(baseProjeto, absoluto) || vistos.has(relativo)) {
+                return;
+            }
+            vistos.add(relativo);
+            docs.push({ ...doc, relativo });
+        },
+    };
+}
+export async function resolverDocumentacaoObrigatoria(opcoes) {
+    const baseProjeto = path.resolve(opcoes.baseProjeto ?? process.cwd());
+    const intencao = opcoes.intencao.trim();
+    const arquivosAlvo = [...new Set((opcoes.arquivosAlvo ?? []).map(normalizarRelativo).filter(Boolean))];
+    const categorias = inferirCategorias(intencao, arquivosAlvo);
+    const { docs, registrar } = criarRegistrador(baseProjeto);
+    await adicionarDocsRaizExistentes(baseProjeto, registrar);
+    for (const regra of REGRAS_DOCUMENTACAO.filter((item) => categorias.includes(item.categoria))) {
+        for (const doc of regra.docs) {
+            registrar(doc);
+        }
+    }
+    await adicionarReadmesDeArquivos(baseProjeto, arquivosAlvo, registrar);
+    await adicionarContratosRelacionados(baseProjeto, intencao, arquivosAlvo, registrar);
+    const leituraObrigatoria = [];
+    for (const doc of docs) {
+        const caminho = path.resolve(baseProjeto, doc.relativo);
+        let existe = await caminhoExiste(caminho);
+        let criado = false;
+        const template = criarTemplateDoc(doc, intencao, categorias, arquivosAlvo);
+        if (!existe && opcoes.criarAusentes && doc.permitirCriacao) {
+            await mkdir(path.dirname(caminho), { recursive: true });
+            await writeFile(caminho, template, "utf8");
+            existe = true;
+            criado = true;
+        }
+        const item = {
+            caminho,
+            relativo: doc.relativo,
+            tipo: doc.tipo,
+            motivo: doc.motivo,
+            existe,
+            criado,
+            obrigatorio: true,
+            template: existe ? undefined : template,
+        };
+        if (existe) {
+            const conteudo = resumoConteudo(await readFile(caminho, "utf8"));
+            item.conteudo = conteudo.conteudo;
+            item.truncado = conteudo.truncado;
+        }
+        leituraObrigatoria.push(item);
+    }
+    const docsAusentes = leituraObrigatoria.filter((doc) => !doc.existe);
+    const docsCriadas = leituraObrigatoria.filter((doc) => doc.criado);
+    const bloqueios = docsAusentes.map((doc) => ({
+        tipo: "documentacao_ausente",
+        severidade: 4,
+        caminho: doc.relativo,
+        mensagem: `Documento obrigatorio ausente: ${doc.relativo}. Crie ou rode com --criar-ausentes antes de agir.`,
+    }));
+    return {
+        sucesso: bloqueios.length === 0,
+        baseProjeto,
+        intencao,
+        categorias,
+        arquivosAlvo,
+        leituraObrigatoria,
+        docsAusentes,
+        docsCriadas,
+        bloqueios,
+        instrucoes: [
+            "A IA deve ler todos os itens de leituraObrigatoria antes de executar a mudanca.",
+            "Se docsAusentes nao estiver vazio, crie ou preencha os documentos antes de editar codigo, contrato, deploy ou configuracao.",
+            "Antes de concluir, rode sema finalizar-mudanca informando as docs lidas.",
+        ],
+    };
+}
+export function normalizarDocLida(baseProjeto, valor) {
+    const semEspaco = valor.trim();
+    if (!semEspaco) {
+        return "";
+    }
+    const absoluto = path.isAbsolute(semEspaco) ? semEspaco : path.resolve(baseProjeto, semEspaco);
+    return normalizarRelativo(path.relative(baseProjeto, absoluto));
+}
+export function compactarDocumentoObrigatorio(doc) {
+    const { conteudo, template, ...compacto } = doc;
+    return compacto;
+}
+export async function verificarDocumentacaoMudanca(opcoes) {
+    const baseProjeto = path.resolve(opcoes.baseProjeto ?? process.cwd());
+    const impacto = await resolverDocumentacaoObrigatoria({
+        baseProjeto,
+        intencao: opcoes.intencao,
+        arquivosAlvo: opcoes.arquivosAlvo,
+        criarAusentes: false,
+    });
+    const docsLidas = [...new Set((opcoes.docsLidas ?? []).map((doc) => normalizarDocLida(baseProjeto, doc)).filter(Boolean))];
+    const setDocsLidas = new Set(docsLidas);
+    const docsNaoLidas = impacto.leituraObrigatoria.filter((doc) => doc.existe && !setDocsLidas.has(doc.relativo));
+    const diagnosticosOrcamento = await emitirDiagnosticosArquivosOrcamento({
+        baseProjeto,
+        arquivos: opcoes.arquivosAlvo ?? [],
+        exigirCabecalhoCodigoGovernado: true,
+    });
+    const diagnosticos = [
+        ...impacto.docsAusentes.map((doc) => ({
+            tipo: "documentacao_ausente",
+            severidade: 4,
+            caminho: doc.relativo,
+            mensagem: `Documento obrigatorio ausente: ${doc.relativo}.`,
+        })),
+        ...docsNaoLidas.map((doc) => ({
+            tipo: "leitura_obrigatoria_nao_comprovada",
+            severidade: 4,
+            caminho: doc.relativo,
+            mensagem: `Leitura obrigatoria nao comprovada: ${doc.relativo}.`,
+        })),
+        ...diagnosticosOrcamento
+            .filter((diagnostico) => diagnostico.bloqueia)
+            .map((diagnostico) => ({
+            tipo: diagnostico.tipo === "codigo_governado_sem_cabecalho"
+                ? "codigo_governado_sem_cabecalho"
+                : "arquivo_monolitico",
+            severidade: 4,
+            caminho: diagnostico.arquivo,
+            mensagem: diagnostico.mensagem,
+            linhas: diagnostico.linhas,
+            limite_bloqueio_linhas: diagnostico.limite_bloqueio_linhas,
+        })),
+    ];
+    return {
+        sucesso: diagnosticos.length === 0,
+        baseProjeto,
+        intencao: opcoes.intencao,
+        categorias: impacto.categorias,
+        docsLidas,
+        leituraObrigatoria: impacto.leituraObrigatoria.map(compactarDocumentoObrigatorio),
+        docsNaoLidas: docsNaoLidas.map(compactarDocumentoObrigatorio),
+        docsAusentes: impacto.docsAusentes.map(compactarDocumentoObrigatorio),
+        diagnosticos,
+        instrucoes: diagnosticos.length === 0
+            ? ["Leitura documental comprovada. Continue com validar, drift e testes conforme a mudanca."]
+            : ["Nao conclua a mudanca enquanto houver diagnosticos de severidade 4+."],
+    };
+}
+//# sourceMappingURL=docs.part02.js.map

package/dist/docs.part02.js.map

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

package/dist/doctorCommand.d.ts

@@ -0,0 +1,27 @@
+import type { AlvoGeracao, FrameworkGeracao } from "@sema/padroes";
+interface ItemDependenciaComando {
+    nome: string;
+    ok: boolean;
+    detalhe?: string;
+    obrigatoria: boolean;
+}
+interface DependenciaComandoDoctor {
+    comando: string;
+    itens: ItemDependenciaComando[];
+}
+interface PreflightVerificacao {
+    ok: boolean;
+    dependencias: DependenciaComandoDoctor[];
+    faltando: Array<{
+        comando: string;
+        nome: string;
+        detalhe?: string;
+    }>;
+}
+export declare function avaliarPreflightVerificacao(configuracoesAlvo: Array<{
+    alvo: AlvoGeracao;
+    framework: FrameworkGeracao;
+}>): PreflightVerificacao;
+export declare function imprimirPreflightVerificacao(preflight: PreflightVerificacao): void;
+export declare function comandoDoctor(): Promise<number>;
+export {};