@semacode/cli 1.5.8 → 1.5.10

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:
@@ -25,7 +26,7 @@ Importante:
 - leitura humana e bonus toleravel, nao objetivo de produto
 - a Sema nao e gerador magico que deveria fazer tudo
 - a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
-- a Sema gera codigo e scaffolding real para TypeScript, Python e Dart
+- a Sema gera codigo e scaffolding real para TypeScript, Python, Dart e Lua
 - a Sema usa \`importar\` para bootstrap revisavel, nao para contrato final automatico
 - a Sema usa \`impl\` para ligar task a simbolo real do runtime
 - a Sema usa \`vinculos\` para ligar contrato a arquivo, simbolo, recurso e superficie real
@@ -63,7 +64,7 @@ Comandos essenciais:
 - validacao: \`sema validar <arquivo.sema> --json\`
 - diagnosticos: \`sema diagnosticos <arquivo.sema> --json\`
 - formatacao: \`sema formatar <arquivo.sema>\`
-- importacao assistida de legado: \`sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart> <diretorio> --saida <diretorio>\`
+- importacao assistida de legado: \`sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart|lua> <diretorio> --saida <diretorio>\`
 - exemplos oficiais no projeto: \`sema instalar-exemplos\`
 - geracao de codigo: \`sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua> --saida <diretorio>\`
 - verificacao final: \`sema verificar <arquivo-ou-pasta> [--json]\`
@@ -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",
@@ -469,7 +477,7 @@ function ajuda() {
             "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]",
             "impacto: sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--json]",
             "renomeacao: sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--escopo <arquivo|modulo|projeto>] [--json]",
-            "importacao: sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]",
+            "importacao: sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart|lua> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]",
             "validacao: sema validar <arquivo-ou-pasta> [--json]",
             "diagnostico: sema diagnosticos <arquivo.sema> [--json]",
             "geracao: sema compilar <arquivo-ou-pasta> --alvo <python|typescript|dart|lua> --saida <diretorio> [--estrutura <flat|modulos|backend>] [--framework <base|nestjs|fastapi>]",
@@ -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",
@@ -818,6 +841,9 @@ function normalizarFonteImportacao(valor) {
     if (valor === "cpp" || valor === "cxx" || valor === "cc" || valor === "c++") {
         return "cpp";
     }
+    if (valor === "lua") {
+        return "lua";
+    }
     if (valor === "nestjs"
         || valor === "fastapi"
         || valor === "flask"
@@ -834,7 +860,8 @@ function normalizarFonteImportacao(valor) {
         || valor === "cpp"
         || valor === "typescript"
         || valor === "python"
-        || valor === "dart") {
+        || valor === "dart"
+        || valor === "lua") {
         return valor;
     }
     return undefined;
@@ -3268,6 +3295,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 +3907,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.",
     ]));
@@ -4286,7 +4392,7 @@ async function principal() {
             {
                 const fonte = normalizarFonteImportacao(posicionais[0]);
                 if (!fonte || !posicionais[1]) {
-                    console.error("Uso: sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]");
+                    console.error("Uso: sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart|lua> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]");
                     codigoSaida = 1;
                     break;
                 }
@@ -4311,6 +4417,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;