@semacode/cli 1.4.0 → 1.5.1

package/dist/index.js

@@ -2,6 +2,7 @@
 import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import pacoteCli from "../package.json" with { type: "json" };
 import { compilarCodigo, formatarCodigo, formatarDiagnosticos, lerArquivoTexto, temErros, } from "@sema/nucleo";
@@ -15,7 +16,7 @@ import { gerarHtml } from "@sema/gerador-html";
 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 } from "./drift.js";
+import { analisarDriftLegado, assistirRenomeacaoSemantica, gerarMapaImpactoSemantico, } from "./drift.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:
@@ -52,8 +53,10 @@ Regras:
 Comandos essenciais:
 - resumo compacto por capacidade: \`sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]\`
 - prompt curto para IA pequena: \`sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]\`
-- descoberta do projeto: \`sema inspecionar [arquivo-ou-pasta] --json\`
-- auditoria do contrato vivo: \`sema drift <arquivo-ou-pasta> [--json]\`
+- descoberta do projeto: \`sema inspecionar [arquivo-ou-pasta] --json\`
+- auditoria do contrato vivo: \`sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--json]\`
+- mapa de impacto: \`sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--json]\`
+- renomeacao assistida: \`sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--json]\`
 - contexto completo do modulo: \`sema contexto-ia <arquivo.sema>\`
 - estrutura sintatica: \`sema ast <arquivo.sema> --json\`
 - estrutura semantica: \`sema ir <arquivo.sema> --json\`
@@ -319,6 +322,7 @@ Comandos uteis da CLI para esse fluxo:
 `;
 const DIRETORIO_CLI_ATUAL = path.dirname(fileURLToPath(import.meta.url));
 const VERSAO_CLI = pacoteCli.version;
+const requireRuntimeCli = createRequire(import.meta.url);
 const ARQUIVOS_CANONICOS_IA_RAIZ = [
     "llms.txt",
     "SEMA_BRIEF.md",
@@ -336,6 +340,16 @@ const DOCUMENTOS_SUPORTE_IA = [
     "docs/sintaxe.md",
     "docs/cli.md",
 ];
+function resolverImportadorNodeOpcional(especificador) {
+    try {
+        return requireRuntimeCli.resolve(especificador);
+    }
+    catch {
+        return undefined;
+    }
+}
+const TSX_IMPORTADOR_CLI = resolverImportadorNodeOpcional("tsx");
+const TSX_EXECUTOR_CLI = resolverImportadorNodeOpcional("tsx/cli");
 function obterArgumentos() {
     const [, , comando, ...resto] = process.argv;
     return { comando: comando, resto };
@@ -373,14 +387,15 @@ function ajuda() {
             "[2] Editar projeto que ja usa Sema",
             "sema inspecionar . --json",
             "sema resumo <arquivo-ou-pasta> --micro --para mudanca",
-            "sema drift <arquivo-ou-pasta> --json",
+            "sema drift <arquivo-ou-pasta> --escopo modulo --json",
+            "sema impacto <arquivo-ou-pasta> --alvo <token> --mudanca <descricao> --json",
             "sema contexto-ia <arquivo.sema> --saida ./.tmp/contexto --json",
             "",
             "[3] Adotar Sema em projeto que ainda nao usa",
             "sema importar <fonte> <diretorio> --saida <diretorio> --json",
             "sema formatar <arquivo-ou-pasta>",
             "sema validar <arquivo-ou-pasta> --json",
-            "sema drift <arquivo-ou-pasta> --json",
+            "sema drift <arquivo-ou-pasta> --escopo modulo --json",
         ]),
         "",
         renderizarSecaoAscii("IA por capacidade", [
@@ -391,7 +406,9 @@ function ajuda() {
         "",
         renderizarSecaoAscii("Comandos principais", [
             "descoberta: sema inspecionar [arquivo-ou-pasta] [--json]",
-            "auditoria: sema drift <arquivo-ou-pasta> [--json]",
+            "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]",
             "validacao: sema validar <arquivo-ou-pasta> [--json]",
             "diagnostico: sema diagnosticos <arquivo.sema> [--json]",
@@ -447,10 +464,13 @@ function possuiFlag(args, nome) {
 const OPCOES_COM_VALOR = new Set([
     "--template",
     "--alvo", "-a",
+    "--escopo",
     "--saida", "-s",
     "--estrutura",
     "--framework",
     "--namespace",
+    "--mudanca",
+    "--de",
     "--para",
 ]);
 const ALIAS_OPCOES = {
@@ -471,6 +491,14 @@ function obterPosicionais(args) {
     }
     return posicionais;
 }
+function resolverOpcoesDriftCli(args) {
+    const escopo = obterOpcao(args, "--escopo");
+    return {
+        escopo: escopo === "arquivo" || escopo === "modulo" || escopo === "projeto" ? escopo : undefined,
+        ignorarWorktrees: !possuiFlag(args, "--incluir-worktrees"),
+        ignorarConsumidoresLaterais: !possuiFlag(args, "--incluir-consumidores-laterais"),
+    };
+}
 function normalizarTamanhoResumo(args) {
     const escolhas = [
         possuiFlag(args, "--micro") ? "micro" : null,
@@ -497,25 +525,172 @@ function comandoDisponivel(comando, argumentos = ["--version"]) {
     const execucao = spawnSync(comando, argumentos, { stdio: "ignore", shell: process.platform === "win32" });
     return (execucao.status ?? 1) === 0;
 }
-async function comandoDoctor() {
-    const checks = [
-        { nome: "node", ok: comandoDisponivel("node") },
-        { nome: "npm", ok: comandoDisponivel("npm") },
-        { nome: "python", ok: comandoDisponivel("python") || comandoDisponivel("py") },
-        { nome: "dotnet", ok: comandoDisponivel("dotnet") },
-        { nome: "go", ok: comandoDisponivel("go") },
-        { nome: "cargo", ok: comandoDisponivel("cargo") },
-        { nome: "java", ok: comandoDisponivel("java") },
-        { nome: "code", ok: comandoDisponivel("code", ["--version"]) },
+function resolverExecucaoPython() {
+    if (comandoDisponivel("python")) {
+        return { comando: "python", argumentosBase: [], rotulo: "python" };
+    }
+    if (comandoDisponivel("py")) {
+        return { comando: "py", argumentosBase: [], rotulo: "py" };
+    }
+    return undefined;
+}
+function resolverExecucaoPytest() {
+    if (comandoDisponivel("pytest")) {
+        return { comando: "pytest", argumentosBase: [], rotulo: "pytest" };
+    }
+    const python = resolverExecucaoPython();
+    if (python && comandoDisponivel(python.comando, [...python.argumentosBase, "-m", "pytest", "--version"])) {
+        return {
+            comando: python.comando,
+            argumentosBase: [...python.argumentosBase, "-m", "pytest"],
+            rotulo: `${python.rotulo} -m pytest`,
+        };
+    }
+    return undefined;
+}
+function criarItemDependencia(nome, ok, detalhe, obrigatoria = true) {
+    return { nome, ok, detalhe, obrigatoria };
+}
+function coletarDependenciasDoctor() {
+    const python = resolverExecucaoPython();
+    const pytest = resolverExecucaoPytest();
+    return [
+        {
+            comando: "base",
+            itens: [
+                criarItemDependencia("node", comandoDisponivel("node"), "runtime principal da CLI"),
+                criarItemDependencia("npm", comandoDisponivel("npm"), "instalacao, pack e publish"),
+                criarItemDependencia("python", Boolean(python), python?.rotulo ? `resolvido via ${python.rotulo}` : "python ou py"),
+                criarItemDependencia("dotnet", comandoDisponivel("dotnet"), "ecosistema ASP.NET", false),
+                criarItemDependencia("go", comandoDisponivel("go"), "ecosistema Go", false),
+                criarItemDependencia("cargo", comandoDisponivel("cargo"), "ecosistema Rust", false),
+                criarItemDependencia("java", comandoDisponivel("java"), "ecosistema Java/Spring", false),
+                criarItemDependencia("code", comandoDisponivel("code", ["--version"]), "VS Code / extensao", false),
+            ],
+        },
+        {
+            comando: "verificar/typescript",
+            itens: [
+                criarItemDependencia("node", comandoDisponivel("node"), "execucao do runner TypeScript"),
+                criarItemDependencia("tsx", Boolean(TSX_EXECUTOR_CLI ?? TSX_IMPORTADOR_CLI), TSX_EXECUTOR_CLI
+                    ? `runner resolvido em ${TSX_EXECUTOR_CLI}`
+                    : TSX_IMPORTADOR_CLI
+                        ? `importador resolvido em ${TSX_IMPORTADOR_CLI}`
+                        : "tsx nao foi encontrado junto da CLI"),
+            ],
+        },
+        {
+            comando: "verificar/javascript",
+            itens: [
+                criarItemDependencia("node", comandoDisponivel("node"), "node --test"),
+            ],
+        },
+        {
+            comando: "verificar/python",
+            itens: [
+                criarItemDependencia("python", Boolean(python), python?.rotulo ? `resolvido via ${python.rotulo}` : "python ou py"),
+                criarItemDependencia("pytest", Boolean(pytest), pytest?.rotulo ? `runner resolvido via ${pytest.rotulo}` : "instale pytest ou exponha python -m pytest"),
+            ],
+        },
+        {
+            comando: "verificar/lua",
+            itens: [
+                criarItemDependencia("lua", comandoDisponivel("lua", ["-v"]), "runner de testes Lua"),
+            ],
+        },
     ];
+}
+function avaliarPreflightVerificacao(configuracoesAlvo) {
+    const dependencias = [];
+    const faltando = [];
+    const registrar = (comando, itens) => {
+        dependencias.push({ comando, itens });
+        for (const item of itens) {
+            if (item.obrigatoria && !item.ok) {
+                faltando.push({
+                    comando,
+                    nome: item.nome,
+                    detalhe: item.detalhe,
+                });
+            }
+        }
+    };
+    registrar("base", [
+        criarItemDependencia("node", comandoDisponivel("node"), "runtime principal da CLI"),
+        criarItemDependencia("npm", comandoDisponivel("npm"), "instalacao e empacotamento"),
+    ]);
+    for (const configuracao of configuracoesAlvo) {
+        if (configuracao.framework !== "base") {
+            continue;
+        }
+        if (configuracao.alvo === "typescript") {
+            registrar("verificar/typescript", [
+                criarItemDependencia("node", comandoDisponivel("node"), "execucao do runner TypeScript"),
+                criarItemDependencia("tsx", Boolean(TSX_EXECUTOR_CLI ?? TSX_IMPORTADOR_CLI), TSX_EXECUTOR_CLI
+                    ? `runner resolvido em ${TSX_EXECUTOR_CLI}`
+                    : TSX_IMPORTADOR_CLI
+                        ? `importador resolvido em ${TSX_IMPORTADOR_CLI}`
+                        : "tsx nao foi encontrado junto da CLI"),
+            ]);
+            continue;
+        }
+        if (configuracao.alvo === "javascript") {
+            registrar("verificar/javascript", [
+                criarItemDependencia("node", comandoDisponivel("node"), "node --test"),
+            ]);
+            continue;
+        }
+        if (configuracao.alvo === "python") {
+            const python = resolverExecucaoPython();
+            const pytest = resolverExecucaoPytest();
+            registrar("verificar/python", [
+                criarItemDependencia("python", Boolean(python), python?.rotulo ? `resolvido via ${python.rotulo}` : "python ou py"),
+                criarItemDependencia("pytest", Boolean(pytest), pytest?.rotulo ? `runner resolvido via ${pytest.rotulo}` : "instale pytest ou exponha python -m pytest"),
+            ]);
+            continue;
+        }
+        if (configuracao.alvo === "lua") {
+            registrar("verificar/lua", [
+                criarItemDependencia("lua", comandoDisponivel("lua", ["-v"]), "runner de testes Lua"),
+            ]);
+        }
+    }
+    return {
+        ok: faltando.length === 0,
+        dependencias,
+        faltando,
+    };
+}
+function imprimirDependenciasDoctor(dependencias) {
+    for (const dependencia of dependencias) {
+        console.log(`\n[${dependencia.comando}]`);
+        for (const item of dependencia.itens) {
+            const sufixo = item.detalhe ? ` (${item.detalhe})` : "";
+            console.log(`- ${item.nome}: ${item.ok ? "ok" : item.obrigatoria ? "faltando" : "ausente"}${sufixo}`);
+        }
+    }
+}
+function imprimirPreflightVerificacao(preflight) {
+    console.error(renderizarCaixaAscii([
+        "Preflight de verificacao falhou",
+        "a CLI sabe o que falta antes de gerar e testar",
+    ]));
+    for (const item of preflight.faltando) {
+        const detalhe = item.detalhe ? ` (${item.detalhe})` : "";
+        console.error(`- ${item.comando}: ${item.nome} faltando${detalhe}`);
+    }
+    console.error("Rode `sema doctor` para ver as dependencias por comando.");
+}
+async function comandoDoctor() {
+    const dependencias = coletarDependenciasDoctor();
     console.log(renderizarCaixaAscii([
         "Sema doctor",
-        "checa a toolchain minima para validar, gerar e operar a CLI",
+        "checa a toolchain minima e as dependencias reais por comando",
     ]));
-    for (const check of checks) {
-        console.log(`- ${check.nome}: ${check.ok ? "ok" : "ausente"}`);
-    }
-    const obrigatorios = checks.filter((check) => ["node", "npm"].includes(check.nome));
+    imprimirDependenciasDoctor(dependencias);
+    const obrigatorios = dependencias
+        .find((dependencia) => dependencia.comando === "base")
+        ?.itens.filter((item) => item.obrigatoria) ?? [];
     return obrigatorios.every((check) => check.ok) ? 0 : 1;
 }
 function validarCompatibilidadeFramework(alvo, framework) {
@@ -754,8 +929,17 @@ function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
             }
             return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
         }
-        const execucao = spawnSync("node", ["--import", "tsx", path.join(baseSaida, arquivoTeste)], {
+        if (!TSX_EXECUTOR_CLI) {
+            return {
+                codigoSaida: 1,
+                quantidadeTestes,
+                saidaPadrao: "",
+                saidaErro: "Nao foi possivel localizar o runner tsx junto da CLI para executar testes TypeScript.",
+            };
+        }
+        const execucao = spawnSync("node", [TSX_EXECUTOR_CLI, arquivoTeste], {
             stdio: silencioso ? "pipe" : "inherit",
+            cwd: baseSaida,
             encoding: silencioso ? "utf8" : undefined,
         });
         return {
@@ -792,6 +976,14 @@ function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
             }
             return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
         }
+        if (!comandoDisponivel("lua", ["-v"])) {
+            return {
+                codigoSaida: 1,
+                quantidadeTestes,
+                saidaPadrao: "",
+                saidaErro: "Nao foi possivel localizar o runner lua para executar os testes gerados.",
+            };
+        }
         const execucao = spawnSync("lua", [arquivoTeste], {
             stdio: silencioso ? "pipe" : "inherit",
             cwd: baseSaida,
@@ -812,10 +1004,20 @@ function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
         }
         return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
     }
-    const execucao = spawnSync("pytest", [arquivoTeste], {
+    const pytest = resolverExecucaoPytest();
+    if (!pytest) {
+        return {
+            codigoSaida: 1,
+            quantidadeTestes,
+            saidaPadrao: "",
+            saidaErro: "Nao foi possivel localizar pytest. Instale pytest ou exponha python -m pytest.",
+        };
+    }
+    const execucao = spawnSync(pytest.comando, [...pytest.argumentosBase, arquivoTeste], {
         stdio: silencioso ? "pipe" : "inherit",
         cwd: baseSaida,
         encoding: silencioso ? "utf8" : undefined,
+        shell: process.platform === "win32" && pytest.comando === "pytest",
     });
     return {
         codigoSaida: execucao.status ?? 1,
@@ -3058,14 +3260,17 @@ async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
     }
     return 0;
 }
-async function comandoDrift(entrada, emJson, cwd = process.cwd()) {
+async function comandoDrift(entrada, args, emJson, cwd = process.cwd()) {
     const contextoProjeto = await carregarProjeto(entrada, cwd);
-    const resultado = await analisarDriftLegado(contextoProjeto);
+    const resultado = await analisarDriftLegado(contextoProjeto, resolverOpcoesDriftCli(args));
     if (emJson) {
         console.log(JSON.stringify(resultado, null, 2));
         return resultado.sucesso ? 0 : 1;
     }
     console.log("Drift entre Sema e codigo legado");
+    console.log(`- Escopo aplicado: ${resultado.escopo_aplicado.escopo}`);
+    console.log(`- Ignorar worktrees: ${resultado.escopo_aplicado.ignorarWorktrees ? "sim" : "nao"}`);
+    console.log(`- Ignorar consumidores laterais: ${resultado.escopo_aplicado.ignorarConsumidoresLaterais ? "sim" : "nao"}`);
     console.log(`- Modulos analisados: ${resultado.modulos.length}`);
     console.log(`- Tasks analisadas: ${resultado.tasks.length}`);
     console.log(`- Impl validos: ${resultado.impls_validos.length}`);
@@ -3075,6 +3280,7 @@ async function comandoDrift(entrada, emJson, cwd = process.cwd()) {
     console.log(`- Rotas divergentes: ${resultado.rotas_divergentes.length}`);
     console.log(`- Recursos vivos validos: ${resultado.recursos_validos.length}`);
     console.log(`- Recursos vivos divergentes: ${resultado.recursos_divergentes.length}`);
+    console.log(`- Persistencia real mapeada: ${resultado.persistencia_real.length}`);
     console.log(`- Score medio: ${resultado.resumo_operacional.scoreMedio}`);
     console.log(`- Confianca geral: ${resultado.resumo_operacional.confiancaGeral}`);
     if (resultado.impls_quebrados.length > 0) {
@@ -3101,6 +3307,13 @@ async function comandoDrift(entrada, emJson, cwd = process.cwd()) {
             console.log(`  - ${recurso.modulo}.${recurso.task} :: ${recurso.categoria} ${recurso.alvo}`);
         }
     }
+    const persistenciaDivergente = resultado.persistencia_real.filter((item) => item.status !== "materializado");
+    if (persistenciaDivergente.length > 0) {
+        console.log("- Persistencia que pede revisao:");
+        for (const item of persistenciaDivergente.slice(0, 8)) {
+            console.log(`  - ${item.modulo}.${item.task} :: ${item.alvo} :: ${item.status} :: categoria=${item.categoriaPersistencia} :: compat=${item.compatibilidade}`);
+        }
+    }
     const semImpl = resultado.tasks.filter((task) => task.semImplementacao);
     if (semImpl.length > 0) {
         console.log("- Tasks sem implementacao vinculada:");
@@ -3137,6 +3350,70 @@ async function comandoDrift(entrada, emJson, cwd = process.cwd()) {
     }
     return resultado.sucesso ? 0 : 1;
 }
+async function comandoImpacto(entrada, args, emJson, cwd = process.cwd()) {
+    const alvoSemantico = obterOpcao(args, "--alvo");
+    if (!alvoSemantico) {
+        console.error("Uso: sema impacto <arquivo-ou-pasta> --alvo <token-semântico> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]");
+        return 1;
+    }
+    const contextoProjeto = await carregarProjeto(entrada, cwd);
+    const resultado = await gerarMapaImpactoSemantico(contextoProjeto, alvoSemantico, obterOpcao(args, "--mudanca", `avaliar impacto de ${alvoSemantico}`), resolverOpcoesDriftCli(args));
+    if (emJson) {
+        console.log(JSON.stringify(resultado, null, 2));
+        return resultado.sucesso ? 0 : 1;
+    }
+    console.log("Impact map semantico");
+    console.log(`- Escopo: ${resultado.escopo}`);
+    console.log(`- Alvo: ${resultado.alvoSemantico}`);
+    console.log(`- Mudanca: ${resultado.mudancaProposta}`);
+    console.log(`- Arquivos impactados: ${resultado.arquivos.length}`);
+    console.log(`- Tasks afetadas: ${resultado.tasksAfetadas.length}`);
+    console.log(`- Rotas afetadas: ${resultado.routesAfetadas.length}`);
+    console.log(`- Superficies afetadas: ${resultado.superficiesAfetadas.length}`);
+    console.log(`- Persistencia afetada: ${resultado.persistenciaAfetada.length}`);
+    if (resultado.arquivos.length > 0) {
+        console.log("- Arquivos prioritarios:");
+        for (const arquivo of resultado.arquivos.slice(0, 10)) {
+            console.log(`  - [${arquivo.prioridade}] ${arquivo.tipo} :: ${arquivo.arquivo}`);
+        }
+    }
+    console.log("- Ordem operacional:");
+    for (const passo of resultado.ordemOperacional) {
+        console.log(`  - ${passo}`);
+    }
+    return resultado.sucesso ? 0 : 1;
+}
+async function comandoRenomearSemantico(entrada, args, emJson, cwd = process.cwd()) {
+    const nomeAtual = obterOpcao(args, "--de");
+    const nomeNovo = obterOpcao(args, "--para");
+    if (!nomeAtual || !nomeNovo) {
+        console.error("Uso: sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]");
+        return 1;
+    }
+    const contextoProjeto = await carregarProjeto(entrada, cwd);
+    const resultado = await assistirRenomeacaoSemantica(contextoProjeto, nomeAtual, nomeNovo, resolverOpcoesDriftCli(args));
+    if (emJson) {
+        console.log(JSON.stringify(resultado, null, 2));
+        return resultado.sucesso ? 0 : 1;
+    }
+    console.log("Renomeacao semantica assistida");
+    console.log(`- Escopo: ${resultado.escopo}`);
+    console.log(`- De: ${resultado.de}`);
+    console.log(`- Para: ${resultado.para}`);
+    console.log(`- Arquivos afetados: ${resultado.arquivos.length}`);
+    console.log(`- Sugestoes: ${resultado.sugestoes.length}`);
+    if (resultado.sugestoes.length > 0) {
+        console.log("- Primeiras sugestoes:");
+        for (const sugestao of resultado.sugestoes.slice(0, 12)) {
+            console.log(`  - ${sugestao.arquivo}:${sugestao.linha} :: ${sugestao.atual} -> ${sugestao.sugerido}`);
+        }
+    }
+    console.log("- Ordem operacional:");
+    for (const passo of resultado.ordemOperacional) {
+        console.log(`  - ${passo}`);
+    }
+    return resultado.sucesso ? 0 : 1;
+}
 async function comandoImportar(fonte, diretorio, saida, namespaceBase, emJson) {
     const resultado = await importarProjetoLegado(fonte, diretorio, namespaceBase);
     const resumo = resumoImportacao(resultado);
@@ -3666,6 +3943,11 @@ async function comandoVerificar(entrada, baseSaida, cwd = process.cwd()) {
         console.error(incompatibilidade.incompatibilidade);
         return 1;
     }
+    const preflight = avaliarPreflightVerificacao(configuracoesAlvo);
+    if (!preflight.ok) {
+        imprimirPreflightVerificacao(preflight);
+        return 1;
+    }
     const resumos = [];
     for (const modulo of modulos) {
         const ir = garantirIr(modulo.resultado, modulo.caminho);
@@ -3733,6 +4015,18 @@ async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd()) {
         }, null, 2));
         return 1;
     }
+    const preflight = avaliarPreflightVerificacao(configuracoesAlvo);
+    if (!preflight.ok) {
+        console.log(JSON.stringify({
+            comando: "verificar",
+            sucesso: false,
+            erro: "Dependencias obrigatorias ausentes para executar a verificacao.",
+            preflight,
+            modulos: [],
+            totais: { modulos: 0, alvos: 0, arquivos: 0, testes: 0 },
+        }, null, 2));
+        return 1;
+    }
     const resumos = [];
     let codigoSaida = 0;
     for (const modulo of modulos) {
@@ -3855,7 +4149,13 @@ async function principal() {
             codigoSaida = await comandoInspecionar(posicionais[0], possuiFlag(resto, "--json"), cwd);
             break;
         case "drift":
-            codigoSaida = await comandoDrift(posicionais[0], possuiFlag(resto, "--json"), cwd);
+            codigoSaida = await comandoDrift(posicionais[0], resto, possuiFlag(resto, "--json"), cwd);
+            break;
+        case "impacto":
+            codigoSaida = await comandoImpacto(posicionais[0], resto, possuiFlag(resto, "--json"), cwd);
+            break;
+        case "renomear-semantico":
+            codigoSaida = await comandoRenomearSemantico(posicionais[0], resto, possuiFlag(resto, "--json"), cwd);
             break;
         case "importar":
             {