@semacode/cli 2.3.0 → 2.3.1

package/dist/index.part05.js

@@ -7,10 +7,14 @@ import { escreverArquivos, formatarAvisoArtefatosGeradosAcimaDoLimite, } from '.
 import { carregarModulos } from './carregarModulos.js';
 import { obterOpcao } from './cliArgs.js';
 import { resumirDriftPorModulo } from "./index.part03.js";
-import { resolverOpcoesDriftCli } from "./index.part01.js";
-export async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
-    const contextoProjeto = await carregarProjeto(entrada, cwd);
-    const resultadoDrift = await analisarDriftLegado(contextoProjeto);
+import { criarResultadoDriftNaoExecutado, resolverAnaliseDriftCli, resolverOpcoesDriftCli } from "./index.part01.js";
+export async function comandoInspecionar(entrada, emJson, cwd = process.cwd(), args = []) {
+    const analiseDrift = resolverAnaliseDriftCli(args, "none");
+    const contextoProjeto = await carregarProjeto(entrada, cwd, { escopo: analiseDrift.opcoes.escopo });
+    const driftExecutado = analiseDrift.modo !== "none";
+    const resultadoDrift = driftExecutado
+        ? await analisarDriftLegado(contextoProjeto, analiseDrift.opcoes)
+        : criarResultadoDriftNaoExecutado(contextoProjeto, analiseDrift.opcoes);
     const framework = resolverFrameworkPadrao(undefined, contextoProjeto.configCarregada);
     const estruturaSaida = resolverEstruturaSaidaPadrao(undefined, framework, contextoProjeto.configCarregada);
     const alvos = resolverAlvosVerificacao(contextoProjeto.configCarregada);
@@ -29,22 +33,56 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
             diretoriosCodigo: contextoProjeto.diretoriosCodigo,
             fontesLegado: contextoProjeto.fontesLegado,
             modoAdocao: contextoProjeto.modoAdocao,
-            scoreDrift: resultadoDrift.resumo_operacional.scoreMedio,
-            confiancaGeral: resultadoDrift.resumo_operacional.confiancaGeral,
-            consumerFramework: resultadoDrift.consumerFramework,
-            appRoutes: resultadoDrift.appRoutes,
-            consumerSurfaces: resultadoDrift.consumerSurfaces,
-            consumerBridges: resultadoDrift.consumerBridges,
+            analiseDrift: {
+                modo: analiseDrift.modo,
+                executada: driftExecutado,
+                cache: analiseDrift.modo === "fresh" ? "refresh" : analiseDrift.modo === "cache" ? "auto" : null,
+                aviso: driftExecutado
+                    ? null
+                    : "Análise de drift não executada; código, rotas, vínculos e implementações não foram verificados.",
+            },
+            scoreDrift: driftExecutado ? resultadoDrift.resumo_operacional.scoreMedio : null,
+            confiancaGeral: driftExecutado ? resultadoDrift.resumo_operacional.confiancaGeral : null,
+            consumerFramework: driftExecutado ? resultadoDrift.consumerFramework : null,
+            appRoutes: driftExecutado ? resultadoDrift.appRoutes : null,
+            consumerSurfaces: driftExecutado ? resultadoDrift.consumerSurfaces : null,
+            consumerBridges: driftExecutado ? resultadoDrift.consumerBridges : null,
         },
         projeto: {
             arquivos: contextoProjeto.arquivosProjeto,
+            arquivosDescobertos: contextoProjeto.arquivosDescobertos,
             modulos: contextoProjeto.modulosSelecionados.map((item) => ({
                 caminho: item.caminho,
                 modulo: item.resultado.modulo?.nome ?? null,
                 sucesso: !temErros(item.resultado.diagnosticos),
                 diagnosticos: item.resultado.diagnosticos.length,
                 superficies: item.resultado.ir?.superficies.map((superficie) => `${superficie.tipo}:${superficie.nome}`) ?? [],
-                implementacao: resumirDriftPorModulo(item.resultado.modulo?.nome ?? null, item.caminho, resultadoDrift),
+                tasks: item.resultado.ir?.tasks.map((task) => task.nome) ?? [],
+                vinculos: item.resultado.ir
+                    ? [
+                        ...item.resultado.ir.vinculos,
+                        ...item.resultado.ir.tasks.flatMap((task) => task.vinculos),
+                        ...item.resultado.ir.flows.flatMap((flow) => flow.vinculos),
+                        ...item.resultado.ir.routes.flatMap((route) => route.vinculos),
+                        ...item.resultado.ir.superficies.flatMap((superficie) => superficie.vinculos),
+                    ]
+                    : [],
+                arquivosEsperados: item.resultado.ir
+                    ? [...new Set([
+                            ...item.resultado.ir.vinculos,
+                            ...item.resultado.ir.tasks.flatMap((task) => task.vinculos),
+                            ...item.resultado.ir.flows.flatMap((flow) => flow.vinculos),
+                            ...item.resultado.ir.routes.flatMap((route) => route.vinculos),
+                            ...item.resultado.ir.superficies.flatMap((superficie) => superficie.vinculos),
+                        ].flatMap((vinculo) => [
+                            vinculo.arquivo,
+                            vinculo.tipo === "arquivo" ? vinculo.valor : undefined,
+                        ]).filter((arquivo) => Boolean(arquivo)))]
+                        .sort((a, b) => a.localeCompare(b, "pt-BR"))
+                    : [],
+                implementacao: driftExecutado
+                    ? resumirDriftPorModulo(item.resultado.modulo?.nome ?? null, item.caminho, resultadoDrift)
+                    : null,
             })),
         },
     };
@@ -60,8 +98,14 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
     console.log(`- Estrutura de saida: ${payload.configuracao.estruturaSaida}`);
     console.log(`- Alvos: ${payload.configuracao.alvos.join(", ")}`);
     console.log(`- Modo de adocao: ${payload.configuracao.modoAdocao}`);
-    console.log(`- Score medio de drift: ${payload.configuracao.scoreDrift}`);
-    console.log(`- Confianca geral: ${payload.configuracao.confiancaGeral}`);
+    console.log(`- Análise de drift: ${payload.configuracao.analiseDrift.modo} (${payload.configuracao.analiseDrift.executada ? "executada" : "não executada"})`);
+    if (payload.configuracao.analiseDrift.executada) {
+        console.log(`- Score medio de drift: ${payload.configuracao.scoreDrift}`);
+        console.log(`- Confianca geral: ${payload.configuracao.confiancaGeral}`);
+    }
+    else {
+        console.log(`- Aviso: ${payload.configuracao.analiseDrift.aviso}`);
+    }
     console.log("- Saidas por alvo:");
     for (const [alvo, saida] of Object.entries(payload.configuracao.saidas)) {
         console.log(`  - ${alvo}: ${saida}`);
@@ -75,25 +119,50 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
         console.log(`  - ${diretorio}`);
     }
     console.log(`- Fontes de legado detectadas: ${payload.configuracao.fontesLegado.join(", ") || "nenhuma"}`);
+    console.log(`- Contratos carregados: ${payload.projeto.arquivos.length}`);
+    console.log(`- Contratos descobertos: ${payload.projeto.arquivosDescobertos.length}`);
     console.log("- Modulos selecionados:");
     for (const modulo of payload.projeto.modulos) {
         console.log(`  - ${modulo.modulo ?? "(sem modulo)"} :: ${modulo.caminho} :: diagnosticos=${modulo.diagnosticos}`);
-        console.log(`    impls validos=${modulo.implementacao.implsValidos} quebrados=${modulo.implementacao.implsQuebrados} recursos divergentes=${modulo.implementacao.recursosDivergentesCount} sem_impl=${modulo.implementacao.tasksSemImplementacao}`);
-        for (const arquivoRelacionado of modulo.implementacao.arquivosRelacionados.slice(0, 5)) {
-            console.log(`    arquivo relacionado: ${arquivoRelacionado}`);
+        console.log(`    tasks=${modulo.tasks.length} vinculos=${modulo.vinculos.length} arquivos esperados=${modulo.arquivosEsperados.length}`);
+        for (const arquivoEsperado of modulo.arquivosEsperados.slice(0, 8)) {
+            console.log(`    arquivo esperado: ${arquivoEsperado}`);
+        }
+        if (modulo.implementacao) {
+            console.log(`    impls validos=${modulo.implementacao.implsValidos} quebrados=${modulo.implementacao.implsQuebrados} recursos divergentes=${modulo.implementacao.recursosDivergentesCount} sem_impl=${modulo.implementacao.tasksSemImplementacao}`);
+            for (const arquivoRelacionado of modulo.implementacao.arquivosRelacionados.slice(0, 5)) {
+                console.log(`    arquivo relacionado: ${arquivoRelacionado}`);
+            }
+        }
+        else {
+            console.log("    implementação: não verificada neste modo");
         }
     }
     return 0;
 }
 export async function comandoDrift(entrada, args, emJson, cwd = process.cwd()) {
-    const contextoProjeto = await carregarProjeto(entrada, cwd);
-    const resultado = await analisarDriftLegado(contextoProjeto, resolverOpcoesDriftCli(args));
+    const opcoes = resolverOpcoesDriftCli(args);
+    const contextoProjeto = await carregarProjeto(entrada, cwd, { escopo: opcoes.escopo });
+    const resultado = await analisarDriftLegado(contextoProjeto, opcoes);
     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(`- Estrategia fisica: ${resultado.escopo_aplicado.estrategia ?? "legado"}`);
+    console.log(`- Cobertura: ${resultado.escopo_aplicado.cobertura ?? "nao informada"}`);
+    console.log(`- Arquivos planejados: ${resultado.escopo_aplicado.arquivosPlanejados?.length ?? 0}`);
+    console.log(`- Cache: ${resultado.escopo_aplicado.cache?.politica ?? "nao informado"} (${resultado.escopo_aplicado.cache?.origem ?? "nao informado"})`);
+    console.log(`- Catálogo: ${resultado.escopo_aplicado.catalogo?.arquivosCatalogados ?? 0} arquivos, ${resultado.escopo_aplicado.catalogo?.diretoriosVisitados ?? 0} diretórios visitados, ${resultado.escopo_aplicado.catalogo?.leiturasConteudo ?? 0} leituras`);
+    const cacheIncremental = resultado.escopo_aplicado.cache?.incremental;
+    if (cacheIncremental) {
+        console.log(`- Cache incremental: ${cacheIncremental.metadataHits} metadata hits, ${cacheIncremental.contentHits} content hits, ${cacheIncremental.groupHits} grupos reutilizados, ${cacheIncremental.groupMisses} grupos recalculados`);
+    }
+    const fases = resultado.escopo_aplicado.cache?.fasesMs;
+    if (fases) {
+        console.log(`- Fases: plano ${fases.planejamento}ms, catálogo ${fases.catalogacao}ms, dependências ${fases.dependencias}ms, assinaturas ${fases.assinaturas}ms, índices ${fases.indexacao}ms, total ${fases.total}ms`);
+    }
     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}`);
@@ -181,8 +250,12 @@ export async function comandoImpacto(entrada, args, emJson, cwd = process.cwd())
         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));
+    const opcoes = resolverOpcoesDriftCli(args);
+    if (!obterOpcao(args, "--escopo")) {
+        opcoes.escopo = entrada?.toLowerCase().endsWith(".sema") ? "modulo" : "projeto";
+    }
+    const contextoProjeto = await carregarProjeto(entrada, cwd, { escopo: opcoes.escopo });
+    const resultado = await gerarMapaImpactoSemantico(contextoProjeto, alvoSemantico, obterOpcao(args, "--mudanca", `avaliar impacto de ${alvoSemantico}`), opcoes);
     if (emJson) {
         console.log(JSON.stringify(resultado, null, 2));
         return resultado.sucesso ? 0 : 1;
@@ -215,8 +288,12 @@ export async function comandoRenomearSemantico(entrada, args, emJson, cwd = proc
         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));
+    const opcoes = resolverOpcoesDriftCli(args);
+    if (!obterOpcao(args, "--escopo")) {
+        opcoes.escopo = entrada?.toLowerCase().endsWith(".sema") ? "modulo" : "projeto";
+    }
+    const contextoProjeto = await carregarProjeto(entrada, cwd, { escopo: opcoes.escopo });
+    const resultado = await assistirRenomeacaoSemantica(contextoProjeto, nomeAtual, nomeNovo, opcoes);
     if (emJson) {
         console.log(JSON.stringify(resultado, null, 2));
         return resultado.sucesso ? 0 : 1;

package/dist/index.part06.js

@@ -209,6 +209,7 @@ export async function comandoAjudaIa() {
         "Use `sema sync-codex` para regenerar o contexto governado do Codex na raiz.",
         "Use `sema instalar-exemplos` para materializar `exemplos/` oficiais sem sobrescrever arquivos locais.",
         "Use `sema resumo <arquivo> --micro --para onboarding --json` para IA fraca; o resumo vem no stdout.",
+        "Use `--drift fresh|cache|none` em `resumo` para escolher análise nova, cache válido ou somente contratos; `--micro` usa `none` por padrão e os demais usam `fresh`.",
         "Se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo; timeout do agente nao e falha do Sema.",
         "Use `sema prompt-curto <arquivo> --curto --para mudanca` para colar contexto em modelo gratuito.",
         "Use `sema prompt-ia`, `sema prompt-ia-ui`, `sema prompt-ia-react` e `sema prompt-ia-sema-primeiro` conforme a tarefa.",
@@ -287,7 +288,7 @@ export async function comandoResumo(entrada, args, emJson) {
     const escreverNaRaiz = possuiFlag(args, "--raiz");
     const alvo = entrada ? path.resolve(process.cwd(), entrada) : process.cwd();
     if (entrada && entrada.toLowerCase().endsWith(".sema")) {
-        const contexto = await carregarContextoModuloIa(alvo);
+        const contexto = await carregarContextoModuloIa(alvo, args, tamanho === "micro" ? "none" : "fresh");
         const resumoSemantico = coletarResumoSemanticoModulo(contexto);
         const guiaPorCapacidade = criarGuiaCapacidadeIa();
         const texto = tamanho === "medio"
@@ -324,7 +325,7 @@ export async function comandoResumo(entrada, args, emJson) {
         console.log(texto);
         return 0;
     }
-    const resumoProjeto = await gerarResumoProjetoIa(alvo, pastaSaida, escreverNaRaiz);
+    const resumoProjeto = await gerarResumoProjetoIa(alvo, pastaSaida, escreverNaRaiz, args, tamanho === "micro" ? "none" : "fresh");
     const arquivoResumo = tamanho === "micro"
         ? "SEMA_BRIEF.micro.txt"
         : tamanho === "curto"

package/dist/index.part07.js

@@ -45,30 +45,30 @@ export async function comandoPromptCurto(entrada, args, emJson) {
             : "SEMA_BRIEF.md";
     const contextoProjeto = await readFile(path.join(resumoProjeto.pastaSaida, arquivoResumo), "utf8");
     const capacidade = tamanho === "micro" ? "fraca" : tamanho === "curto" ? "media" : "forte";
-    const prompt = `⚠️ REGRA OBRIGATÓRIA DE GOVERNANÇA:
-
-ANTES DE QUALQUER AÇÃO (editar, criar, deletar, executar, consultar ou modificar):
-1. Rode \`sema docs-impacto --intencao "<ação>" --json\` com sua intenção declarada.
-2. Aguarde a resposta com as docs obrigatórias.
-3. Leia as docs antes de agir.
-4. Antes de concluir, rode \`sema finalizar-mudanca --intencao "<ação>" --doc-lida <arquivo> --json\` com todas as docs lidas.
-
-Você está operando Sema em modo IA-first.
-
-Isto é contexto comprimido para IA operar contrato semântico antes de tocar código vivo.
-
-Capacidade alvo: ${capacidade}
-Modo da tarefa: ${modo}
-
-Regras:
-- ANTES DE TUDO: rode \`sema docs-impacto --intencao "<ação>" --json\`.
-- Comece pelo resumo compacto abaixo.
-- Se a tarefa pedir mais contexto, abra \`AGENT_CONTEXT_PACK.json\` e depois \`SEMA_INDEX.json\`.
-- Não tente ler o repositório inteiro se o resumo já disser onde tocar.
-- Preserve contrato, risco, lacuna e checks sugeridos.
-
-Contexto do projeto:
-${contextoProjeto.trim()}
+    const prompt = `⚠️ REGRA OBRIGATÓRIA DE GOVERNANÇA:
+
+ANTES DE QUALQUER AÇÃO (editar, criar, deletar, executar, consultar ou modificar):
+1. Rode \`sema docs-impacto --intencao "<ação>" --json\` com sua intenção declarada.
+2. Aguarde a resposta com as docs obrigatórias.
+3. Leia as docs antes de agir.
+4. Antes de concluir, rode \`sema finalizar-mudanca --intencao "<ação>" --doc-lida <arquivo> --json\` com todas as docs lidas.
+
+Você está operando Sema em modo IA-first.
+
+Isto é contexto comprimido para IA operar contrato semântico antes de tocar código vivo.
+
+Capacidade alvo: ${capacidade}
+Modo da tarefa: ${modo}
+
+Regras:
+- ANTES DE TUDO: rode \`sema docs-impacto --intencao "<ação>" --json\`.
+- Comece pelo resumo compacto abaixo.
+- Se a tarefa pedir mais contexto, abra \`AGENT_CONTEXT_PACK.json\` e depois \`SEMA_INDEX.json\`.
+- Não tente ler o repositório inteiro se o resumo já disser onde tocar.
+- Preserve contrato, risco, lacuna e checks sugeridos.
+
+Contexto do projeto:
+${contextoProjeto.trim()}
 `;
     if (emJson) {
         console.log(JSON.stringify({

package/dist/index.part08.js

@@ -105,7 +105,7 @@ export async function principal() {
                 : await comandoVerificar(posicionais[0], resolverSaidaPadrao(obterOpcao(resto, "--saida", "./.tmp/sema-verificar"), "typescript", await carregarConfiguracaoProjeto(posicionais[0] ? path.resolve(cwd, posicionais[0]) : cwd)), cwd);
             break;
         case "inspecionar":
-            codigoSaida = await comandoInspecionar(posicionais[0], possuiFlag(resto, "--json"), cwd);
+            codigoSaida = await comandoInspecionar(posicionais[0], possuiFlag(resto, "--json"), cwd, resto);
             break;
         case "drift":
             codigoSaida = await comandoDrift(posicionais[0], resto, possuiFlag(resto, "--json"), cwd);