@semacode/cli 1.5.8 → 1.5.9

package/dist/docs.js

@@ -0,0 +1,407 @@
+import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+const LIMITE_CONTEUDO_DOC = 16_000;
+function normalizarTexto(valor) {
+    return valor
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase();
+}
+function normalizarRelativo(valor) {
+    return valor.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+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(" ");
+}
+async function caminhoExiste(caminho) {
+    try {
+        await stat(caminho);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function caminhoEstaDentro(base, alvo) {
+    const relativo = path.relative(base, alvo);
+    return relativo === "" || (!relativo.startsWith("..") && !path.isAbsolute(relativo));
+}
+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;
+}
+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: "auth",
+        padroes: [/auth/, /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/, /stdio/],
+        docs: [
+            { relativo: "pacotes/mcp/README.md", tipo: "pacote", motivo: "documentacao publica do pacote MCP", permitirCriacao: false },
+            { 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 especifico de ferramentas MCP", 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 },
+        ],
+    },
+];
+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"];
+}
+function criarTemplateDoc(doc, intencao, categorias, arquivosAlvo) {
+    const titulo = tituloDeRelativo(doc.relativo);
+    const linhas = [
+        `# ${titulo}`,
+        "",
+        "Documento criado pelo Sema porque uma IA declarou uma intencao que exige leitura operacional antes de agir.",
+        "",
+        "## Intencao",
+        "",
+        intencao || "Descrever a intencao operacional antes de executar a mudanca.",
+        "",
+        "## Escopo",
+        "",
+        arquivosAlvo.length > 0
+            ? arquivosAlvo.map((arquivo) => `- ${arquivo}`).join("\n")
+            : "- Declarar os arquivos, servicos ou contratos afetados.",
+        "",
+        "## Leitura obrigatoria antes de agir",
+        "",
+        "- Ler este documento inteiro.",
+        "- Ler contratos .sema relacionados antes de editar codigo.",
+        "- Ler README, runbooks e docs de pacote envolvidos.",
+        "",
+        "## Procedimento",
+        "",
+        "- Descrever os comandos ou passos seguros.",
+        "- Declarar pre-condicoes, variaveis e dependencias.",
+        "- Registrar como validar sucesso.",
+        "",
+        "## Validacao",
+        "",
+        "- Listar comandos de build, teste, verificacao ou smoke test.",
+        "- Registrar evidencias esperadas.",
+        "",
+        "## Rollback",
+        "",
+        "- Descrever como desfazer a mudanca.",
+        "- Declarar sinais que exigem rollback.",
+        "",
+        "## Atualizacao documental",
+        "",
+        "- Atualizar este arquivo quando o fluxo operacional mudar.",
+        "- Atualizar docs e contratos relacionados na mesma mudanca.",
+        "",
+        `Categorias inferidas: ${categorias.join(", ")}`,
+        "",
+    ];
+    return `${linhas.join("\n")}\n`;
+}
+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,
+    };
+}
+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 });
+        }
+    }
+}
+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;
+        }
+    }
+}
+async function adicionarContratosRelacionados(baseProjeto, categorias, intencao, arquivosAlvo, registrar) {
+    const pastaContratos = path.join(baseProjeto, "contratos");
+    if (!(await caminhoExiste(pastaContratos))) {
+        return;
+    }
+    const texto = normalizarTexto(`${intencao} ${arquivosAlvo.join(" ")} ${categorias.join(" ")}`);
+    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 = texto.split(/\W+/).filter((parte) => parte.length >= 4).some((parte) => nome.includes(parte))
+            || (categorias.some((categoria) => ["mcp", "cli", "documentacao", "contrato"].includes(categoria)) && nome.includes("governanca_ia"));
+        if (relacionado) {
+            registrar({
+                relativo,
+                tipo: "contrato",
+                motivo: "contrato Sema relacionado a intencao declarada",
+                permitirCriacao: false,
+            });
+        }
+    }
+}
+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, categorias, 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.",
+        ],
+    };
+}
+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 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 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}.`,
+        })),
+    ];
+    return {
+        sucesso: diagnosticos.length === 0,
+        baseProjeto,
+        intencao: opcoes.intencao,
+        categorias: impacto.categorias,
+        docsLidas,
+        leituraObrigatoria: impacto.leituraObrigatoria,
+        docsNaoLidas,
+        docsAusentes: impacto.docsAusentes,
+        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.js.map

package/dist/docs.js.map

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

package/dist/index.js

@@ -17,6 +17,7 @@ import { gerarCss } from "@sema/gerador-css";
 import { carregarConfiguracaoProjeto, carregarProjeto, resolverAlvoPadrao, resolverAlvosVerificacao, resolverEstruturaSaidaPadrao, resolverFrameworkPadrao, resolverSaidaPadrao, } from "./projeto.js";
 import { importarProjetoLegado, resumoImportacao } from "./importador.js";
 import { analisarDriftLegado, assistirRenomeacaoSemantica, gerarMapaImpactoSemantico, } from "./drift.js";
+import { resolverDocumentacaoObrigatoria, verificarDocumentacaoMudanca, } from "./docs.js";
 const STARTER_IA = `Voce esta trabalhando com Sema, um Protocolo de Governanca de Intencao para IA sobre software vivo em backend e front consumer.
 
 Importante:
@@ -340,6 +341,12 @@ const DOCUMENTOS_SUPORTE_IA = [
     "docs/persistencia-vendor-first.md",
     "docs/sintaxe.md",
     "docs/cli.md",
+    "docs/mcp.md",
+    "docs/documentacao.md",
+    "docs/deploy.md",
+    "docs/env.md",
+    "docs/rollback.md",
+    "docs/extensao-vscode.md",
 ];
 function resolverImportadorNodeOpcional(especificador) {
     try {
@@ -449,6 +456,7 @@ function ajuda() {
             "sema resumo <arquivo-ou-pasta> --micro --para mudanca",
             "sema drift <arquivo-ou-pasta> --escopo modulo --json",
             "sema impacto <arquivo-ou-pasta> --alvo <token> --mudanca <descricao> --json",
+            "sema docs-impacto --intencao \"fazer deploy\" --criar-ausentes --json",
             "sema contexto-ia <arquivo.sema> --saida ./.tmp/contexto --json",
             "",
             "[3] Adotar Sema em projeto que ainda nao usa",
@@ -491,6 +499,8 @@ function ajuda() {
             "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--json]",
             "sema sync-ai-entrypoints [--json]",
             "sema instalar-exemplos [--json]",
+            "sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--json]",
+            "sema finalizar-mudanca --intencao <acao> [--arquivo <caminho>] [--doc-lida <caminho>] [--json]",
         ]),
         "",
         renderizarSecaoAscii("Operacional", [
@@ -522,6 +532,16 @@ function obterOpcao(args, nome, padrao) {
 function possuiFlag(args, nome) {
     return args.includes(nome);
 }
+function obterOpcoesRepetidas(args, nome) {
+    const valores = [];
+    for (let indice = 0; indice < args.length; indice += 1) {
+        if (args[indice] === nome && args[indice + 1]) {
+            valores.push(args[indice + 1]);
+            indice += 1;
+        }
+    }
+    return valores;
+}
 const OPCOES_COM_VALOR = new Set([
     "--template",
     "--alvo", "-a",
@@ -533,6 +553,9 @@ const OPCOES_COM_VALOR = new Set([
     "--mudanca",
     "--de",
     "--para",
+    "--intencao",
+    "--arquivo",
+    "--doc-lida",
 ]);
 const ALIAS_OPCOES = {
     "-a": "--alvo",
@@ -3268,6 +3291,83 @@ async function comandoInstalarExemplos(emJson) {
     console.log(`- Preservados: ${resultado.preservados.length}`);
     return 0;
 }
+function resolverEntradaDocs(posicionais, args) {
+    const intencao = obterOpcao(args, "--intencao") ?? posicionais[0] ?? "";
+    const arquivosPorFlag = obterOpcoesRepetidas(args, "--arquivo");
+    const arquivosPosicionais = obterOpcao(args, "--intencao") ? posicionais : posicionais.slice(1);
+    return {
+        intencao,
+        arquivosAlvo: [...new Set([...arquivosPorFlag, ...arquivosPosicionais])],
+    };
+}
+async function comandoDocsImpacto(posicionais, args, emJson) {
+    const { intencao, arquivosAlvo } = resolverEntradaDocs(posicionais, args);
+    if (!intencao.trim()) {
+        console.error("Uso: sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--json]");
+        return 1;
+    }
+    const resultado = await resolverDocumentacaoObrigatoria({
+        baseProjeto: process.cwd(),
+        intencao,
+        arquivosAlvo,
+        criarAusentes: possuiFlag(args, "--criar-ausentes"),
+    });
+    const payload = {
+        comando: "docs-impacto",
+        ...resultado,
+    };
+    if (emJson) {
+        console.log(JSON.stringify(payload, null, 2));
+        return resultado.sucesso ? 0 : 1;
+    }
+    console.log("Documentacao obrigatoria da mudanca");
+    console.log(`- Intencao: ${resultado.intencao}`);
+    console.log(`- Categorias: ${resumirListaTexto(resultado.categorias, 8)}`);
+    console.log(`- Leitura obrigatoria: ${resultado.leituraObrigatoria.length}`);
+    for (const doc of resultado.leituraObrigatoria) {
+        console.log(`  - ${doc.relativo} (${doc.existe ? "ok" : "ausente"}) - ${doc.motivo}`);
+    }
+    if (resultado.docsCriadas.length > 0) {
+        console.log(`- Docs criadas: ${resultado.docsCriadas.map((doc) => doc.relativo).join(", ")}`);
+    }
+    if (resultado.bloqueios.length > 0) {
+        console.error("Bloqueios:");
+        for (const bloqueio of resultado.bloqueios) {
+            console.error(`- [SEM DOC ${bloqueio.severidade}] ${bloqueio.mensagem}`);
+        }
+    }
+    return resultado.sucesso ? 0 : 1;
+}
+async function comandoFinalizarMudanca(posicionais, args, emJson) {
+    const { intencao, arquivosAlvo } = resolverEntradaDocs(posicionais, args);
+    if (!intencao.trim()) {
+        console.error("Uso: sema finalizar-mudanca --intencao <acao> [--arquivo <caminho>] [--doc-lida <caminho>] [--json]");
+        return 1;
+    }
+    const resultado = await verificarDocumentacaoMudanca({
+        baseProjeto: process.cwd(),
+        intencao,
+        arquivosAlvo,
+        docsLidas: obterOpcoesRepetidas(args, "--doc-lida"),
+    });
+    const payload = {
+        comando: "finalizar-mudanca",
+        ...resultado,
+    };
+    if (emJson) {
+        console.log(JSON.stringify(payload, null, 2));
+        return resultado.sucesso ? 0 : 1;
+    }
+    if (resultado.sucesso) {
+        console.log("Leitura documental comprovada para a mudanca.");
+        return 0;
+    }
+    console.error("Mudanca bloqueada por documentacao obrigatoria:");
+    for (const diagnostico of resultado.diagnosticos) {
+        console.error(`- [severidade ${diagnostico.severidade}] ${diagnostico.mensagem}`);
+    }
+    return 1;
+}
 async function comandoValidar(entrada) {
     const modulos = await carregarModulos(entrada);
     const diagnosticos = modulos.flatMap((item) => item.resultado.diagnosticos);
@@ -3803,6 +3903,8 @@ async function comandoAjudaIa() {
         "Use `sema exemplos-prompt-ia` para pegar modelos prontos de prompt.",
         "Use `sema inspecionar` para descobrir base, codigo vivo e fontes legado.",
         "Use `sema drift` para medir impls, vinculos, rotas, score e lacunas.",
+        "Use `sema docs-impacto --intencao <acao>` para ler ou criar docs obrigatorias antes de agir.",
+        "Use `sema finalizar-mudanca --intencao <acao>` para bloquear conclusao sem leitura documental comprovada.",
         "Use `sema contexto-ia <arquivo.sema>` para gerar AST, IR, drift, `briefing.json` e `briefing.min.json`.",
         "Use `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua> --saida <diretorio>` quando a tarefa pedir codigo derivado.",
     ]));
@@ -4311,6 +4413,12 @@ async function principal() {
         case "instalar-exemplos":
             codigoSaida = await comandoInstalarExemplos(possuiFlag(resto, "--json"));
             break;
+        case "docs-impacto":
+            codigoSaida = await comandoDocsImpacto(posicionais, resto, possuiFlag(resto, "--json"));
+            break;
+        case "finalizar-mudanca":
+            codigoSaida = await comandoFinalizarMudanca(posicionais, resto, possuiFlag(resto, "--json"));
+            break;
         case "resumo":
             codigoSaida = await comandoResumo(posicionais[0], resto, possuiFlag(resto, "--json"));
             break;