@semacode/cli 1.3.7 → 1.5.0

package/dist/index.js

@@ -15,7 +15,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 +52,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\`
@@ -332,6 +334,7 @@ const DOCUMENTOS_SUPORTE_IA = [
     "docs/integracao-com-ia.md",
     "docs/fluxo-pratico-ia-sema.md",
     "docs/como-ensinar-a-sema-para-ia.md",
+    "docs/persistencia-vendor-first.md",
     "docs/sintaxe.md",
     "docs/cli.md",
 ];
@@ -372,14 +375,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", [
@@ -390,7 +394,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]",
@@ -446,10 +452,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 = {
@@ -470,6 +479,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,
@@ -878,6 +895,7 @@ async function descobrirDocsIa() {
         "como-ensinar-a-sema-para-ia.md",
         "prompt-base-ia-sema.md",
         "fluxo-pratico-ia-sema.md",
+        "persistencia-vendor-first.md",
     ];
     for (const base of candidatosBase) {
         const documentos = [];
@@ -3056,14 +3074,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}`);
@@ -3073,6 +3094,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) {
@@ -3099,6 +3121,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} :: compat=${item.compatibilidade}`);
+        }
+    }
     const semImpl = resultado.tasks.filter((task) => task.semImplementacao);
     if (semImpl.length > 0) {
         console.log("- Tasks sem implementacao vinculada:");
@@ -3135,6 +3164,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);
@@ -3853,7 +3946,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":
             {