@semacode/cli 2.2.0 → 2.3.1

package/dist/index.part04.js

@@ -16,7 +16,7 @@ import { carregarModulos } from './carregarModulos.js';
 import { obterOpcao, obterOpcoesRepetidas, possuiFlag } from './cliArgs.js';
 import { resumirListaTexto, unicosOrdenados } from './textoListas.js';
 import { EXTENSOES_CODIGO, listarArquivosRecursivosLimitado } from './projetoBusca.js';
-import { VERSAO_CLI } from "./index.part01.js";
+import { VERSAO_CLI, criarResultadoDriftNaoExecutado, resolverAnaliseDriftCli, } from "./index.part01.js";
 import { coletarResumoSemanticoModulo, descreverFontesConclusao, detectarFontesConclusaoSnapshot, detectarModoVerificacaoCodigo } from "./index.part02.js";
 import { ARQUIVOS_RESUMO_MODULO_IA, carregarContextoModuloIa, criarBriefingAgente, gerarArquivosResumoModuloIa, renderizarResumoProjetoMarkdown, resumirDriftPorModulo } from "./index.part03.js";
 export const ARQUIVOS_RESUMO_PROJETO_IA = [
@@ -53,15 +53,22 @@ function escolherTopArquivosResumo(modulos, arquivosCodigoDetectados) {
     }
     return { arquivos: [], fonte: "nenhum" };
 }
-export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz = false) {
+export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz = false, args = [], modoDriftPadrao = "fresh") {
     const contextoProjeto = await carregarProjeto(entrada, process.cwd());
     const geradoEm = new Date().toISOString();
     const guiaPorCapacidade = criarGuiaCapacidadeIa();
     const entradaCanonica = criarEntradaCanonicaProjeto(guiaPorCapacidade);
     const agentContextPack = entradaCanonica.agentContextPack;
-    const modoVerificacaoCodigo = await detectarModoVerificacaoCodigo(contextoProjeto.baseProjeto, contextoProjeto.diretoriosCodigo);
-    const fontesConclusao = await detectarFontesConclusaoSnapshot(contextoProjeto.baseProjeto);
-    const resultadoDrift = await analisarDriftLegado(contextoProjeto);
+    const analiseDrift = resolverAnaliseDriftCli(args, modoDriftPadrao);
+    const modoVerificacaoCodigo = analiseDrift.modo === "none"
+        ? "contratos_apenas"
+        : await detectarModoVerificacaoCodigo(contextoProjeto.baseProjeto, contextoProjeto.diretoriosCodigo);
+    const fontesConclusao = analiseDrift.modo === "none"
+        ? ["contrato"]
+        : await detectarFontesConclusaoSnapshot(contextoProjeto.baseProjeto);
+    const resultadoDrift = analiseDrift.modo === "none"
+        ? criarResultadoDriftNaoExecutado(contextoProjeto, analiseDrift.opcoes)
+        : await analisarDriftLegado(contextoProjeto, analiseDrift.opcoes);
     const modulos = contextoProjeto.modulosSelecionados.map((item) => {
         const modulo = item.resultado.modulo?.nome ?? path.basename(item.caminho, ".sema");
         const driftResumo = resumirDriftPorModulo(modulo, item.caminho, resultadoDrift);
@@ -77,6 +84,11 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
                 caminho: item.caminho,
                 modulo,
                 sucesso: resultadoDrift.sucesso,
+                modoAnalise: analiseDrift.modo,
+                executado: analiseDrift.modo !== "none",
+                aviso: analiseDrift.modo === "none"
+                    ? "Análise de drift não executada; nenhuma conclusão sobre o código foi produzida."
+                    : null,
                 resumo: driftResumo,
                 drift: resultadoDrift,
             },
@@ -206,102 +218,102 @@ export async function gerarContextoIa(arquivoEntrada, pastaSaidaOpcional) {
         await escreverArquivoWorkspaceSeguro(pastaBase, artefato.caminhoRelativo, artefato.conteudo, { sobrescrever: true });
     }
     const resumoGerado = await gerarArquivosResumoModuloIa(contexto, pastaBase);
-    const resumo = `# Contexto de IA para ${contexto.modulo}
-
-- Arquivo alvo: \`${contexto.arquivo}\`
-- Modulo: \`${contexto.modulo}\`
-- Sucesso em validar: \`${contexto.sucesso}\`
-- Quantidade de diagnosticos: \`${contexto.diagnosticos.length}\`
-- Gerado em: \`${contexto.geradoEm}\`
-
-## Arquivos gerados neste pacote
-
-- \`agent-context-pack.json\`
-- \`${ARQUIVO_SEMA_BOOT}\`
-- \`${ARQUIVO_SEMA_SMALL_MODEL}\`
-- \`resumo.micro.txt\`
-- \`resumo.curto.txt\`
-- \`resumo.md\`
-- \`briefing.min.json\`
-- \`prompt-curto.txt\`
-- \`validar.json\`
-- \`diagnosticos.json\`
-- \`ast.json\`
-- \`ir.json\`
-- \`drift.json\`
-- \`briefing.json\`
-
-## Fluxo recomendado para o agente
-
-Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-context-pack.json\`. Eles declaram regras obrigatórias, proibições, prioridades, idioma humano e quando abrir texto bruto como \`AGENTS.md\`, \`exemplos/\`, docs e contratos.
-
-## Políticas da plataforma
-
-- Sema governa contrato, escopo, drift, evidência e qualidade; não contorna políticas, termos, permissões, segurança ou leis.
-- Se houver alerta externo, trate como bloqueio da plataforma ou falso positivo possível, explique de forma neutra e não tente burlar filtro.
-
-### IA fraca, gratuita ou com pouca disciplina
-
-1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
-2. Ler \`${ARQUIVO_SEMA_SMALL_MODEL}\`.
-3. Ler \`agent-context-pack.json\`.
-4. Ler \`resumo.micro.txt\`.
-5. Ler \`briefing.min.json\`.
-6. Se ainda couber contexto, ler \`resumo.curto.txt\`.
-
-### IA média
-
-1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
-2. Ler \`agent-context-pack.json\`.
-3. Ler \`resumo.curto.txt\`.
-4. Ler \`briefing.min.json\`.
-5. Ler \`drift.json\`.
-6. Se precisar, subir para \`resumo.md\`.
-
-### IA forte ou com tool use
-
-1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
-2. Ler \`agent-context-pack.json\`.
-3. Ler \`README.md\`.
-4. Ler \`resumo.md\`.
-5. Ler \`briefing.json\`.
-6. Ler \`drift.json\`.
-7. Só depois abrir \`ir.json\` e \`ast.json\`.
-
-## Idioma humano
-
-- Responda no idioma do usuário.
-- Em PT-BR, use acentos, cedilha, pontuação e símbolos normais.
-- A DSL \`.sema\` pode ser ASCII; texto humano não precisa ser.
-
-## Texto bruto sob demanda
-
-- Abra \`AGENTS.md\` antes de editar código, contrato, docs operacionais, release ou deploy.
-- Abra \`exemplos/\` antes de criar ou corrigir sintaxe \`.sema\`.
-- Abra \`docs/syntax.md\` quando exemplos não bastarem para resolver a gramática.
-- Abra \`contratos/\` antes de qualquer implementação ou mudança de comportamento.
-
-## Timeout e retry
-
-- Timeout local do agente não é falha do Sema.
-- Se uma chamada Sema estourar, aumente o timeout e tente de novo.
-- Se o projeto inteiro for lento, escopar para \`sema resumo "${contexto.arquivo}" --micro --para mudanca\`.
-- Se o ambiente impedir continuar, pare bloqueado e não avance com código sem Sema.
-
-## Fechamento
-
-1. Editar o arquivo \`.sema\`.
-2. Rodar \`sema formatar "${contexto.arquivo}"\`.
-3. Rodar \`sema validar "${contexto.arquivo}" --json\`.
-4. Rodar \`sema drift "${contexto.arquivo}" --json\`.
-5. Fechar com \`sema verificar <arquivo-ou-pasta> --json --saida ./.tmp/verificacao-ia\`.
-
-## Textos base para onboarding do agente
-
-- \`sema starter-ia\`
-- \`sema resumo "${contexto.arquivo}" --micro --para onboarding\`
-- \`sema prompt-curto "${contexto.arquivo}" --para mudanca\`
-- \`sema prompt-ia\`
+    const resumo = `# Contexto de IA para ${contexto.modulo}
+
+- Arquivo alvo: \`${contexto.arquivo}\`
+- Modulo: \`${contexto.modulo}\`
+- Sucesso em validar: \`${contexto.sucesso}\`
+- Quantidade de diagnosticos: \`${contexto.diagnosticos.length}\`
+- Gerado em: \`${contexto.geradoEm}\`
+
+## Arquivos gerados neste pacote
+
+- \`agent-context-pack.json\`
+- \`${ARQUIVO_SEMA_BOOT}\`
+- \`${ARQUIVO_SEMA_SMALL_MODEL}\`
+- \`resumo.micro.txt\`
+- \`resumo.curto.txt\`
+- \`resumo.md\`
+- \`briefing.min.json\`
+- \`prompt-curto.txt\`
+- \`validar.json\`
+- \`diagnosticos.json\`
+- \`ast.json\`
+- \`ir.json\`
+- \`drift.json\`
+- \`briefing.json\`
+
+## Fluxo recomendado para o agente
+
+Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-context-pack.json\`. Eles declaram regras obrigatórias, proibições, prioridades, idioma humano e quando abrir texto bruto como \`AGENTS.md\`, \`exemplos/\`, docs e contratos.
+
+## Políticas da plataforma
+
+- Sema governa contrato, escopo, drift, evidência e qualidade; não contorna políticas, termos, permissões, segurança ou leis.
+- Se houver alerta externo, trate como bloqueio da plataforma ou falso positivo possível, explique de forma neutra e não tente burlar filtro.
+
+### IA fraca, gratuita ou com pouca disciplina
+
+1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
+2. Ler \`${ARQUIVO_SEMA_SMALL_MODEL}\`.
+3. Ler \`agent-context-pack.json\`.
+4. Ler \`resumo.micro.txt\`.
+5. Ler \`briefing.min.json\`.
+6. Se ainda couber contexto, ler \`resumo.curto.txt\`.
+
+### IA média
+
+1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
+2. Ler \`agent-context-pack.json\`.
+3. Ler \`resumo.curto.txt\`.
+4. Ler \`briefing.min.json\`.
+5. Ler \`drift.json\`.
+6. Se precisar, subir para \`resumo.md\`.
+
+### IA forte ou com tool use
+
+1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
+2. Ler \`agent-context-pack.json\`.
+3. Ler \`README.md\`.
+4. Ler \`resumo.md\`.
+5. Ler \`briefing.json\`.
+6. Ler \`drift.json\`.
+7. Só depois abrir \`ir.json\` e \`ast.json\`.
+
+## Idioma humano
+
+- Responda no idioma do usuário.
+- Em PT-BR, use acentos, cedilha, pontuação e símbolos normais.
+- A DSL \`.sema\` pode ser ASCII; texto humano não precisa ser.
+
+## Texto bruto sob demanda
+
+- Abra \`AGENTS.md\` antes de editar código, contrato, docs operacionais, release ou deploy.
+- Abra \`exemplos/\` antes de criar ou corrigir sintaxe \`.sema\`.
+- Abra \`docs/syntax.md\` quando exemplos não bastarem para resolver a gramática.
+- Abra \`contratos/\` antes de qualquer implementação ou mudança de comportamento.
+
+## Timeout e retry
+
+- Timeout local do agente não é falha do Sema.
+- Se uma chamada Sema estourar, aumente o timeout e tente de novo.
+- Se o projeto inteiro for lento, escopar para \`sema resumo "${contexto.arquivo}" --micro --para mudanca\`.
+- Se o ambiente impedir continuar, pare bloqueado e não avance com código sem Sema.
+
+## Fechamento
+
+1. Editar o arquivo \`.sema\`.
+2. Rodar \`sema formatar "${contexto.arquivo}"\`.
+3. Rodar \`sema validar "${contexto.arquivo}" --json\`.
+4. Rodar \`sema drift "${contexto.arquivo}" --json\`.
+5. Fechar com \`sema verificar <arquivo-ou-pasta> --json --saida ./.tmp/verificacao-ia\`.
+
+## Textos base para onboarding do agente
+
+- \`sema starter-ia\`
+- \`sema resumo "${contexto.arquivo}" --micro --para onboarding\`
+- \`sema prompt-curto "${contexto.arquivo}" --para mudanca\`
+- \`sema prompt-ia\`
 `;
     await escreverArquivoWorkspaceSeguro(pastaBase, "README.md", resumo, {
         sobrescrever: true,

package/dist/index.part05.d.ts

@@ -1,5 +1,5 @@
 import { type FonteImportacao } from "./importador.js";
-export declare function comandoInspecionar(entrada: string | undefined, emJson: boolean, cwd?: string): Promise<number>;
+export declare function comandoInspecionar(entrada: string | undefined, emJson: boolean, cwd?: string, args?: string[]): Promise<number>;
 export declare function comandoDrift(entrada: string | undefined, args: string[], emJson: boolean, cwd?: string): Promise<number>;
 export declare function comandoImpacto(entrada: string | undefined, args: string[], emJson: boolean, cwd?: string): Promise<number>;
 export declare function comandoRenomearSemantico(entrada: string | undefined, args: string[], emJson: boolean, cwd?: string): Promise<number>;

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

@@ -203,9 +203,13 @@ export async function comandoAjudaIa() {
     console.log("");
     console.log(renderizarSecaoAscii("Fluxo recomendado", [
         "Use `sema starter-ia` para um texto curto de onboarding.",
+        "Use `sema descobrir recomendar --intencao <objetivo> --json` quando ainda não souber qual profile, workflow, pipeline, gerador ou adaptador usar.",
+        "Use `sema descobrir catalogo --json` ou `sema capabilities --json` para expor o mapa completo de capacidades à IA.",
+        "Use `sema interativo pipelines --json` para jogos, simulações e híbridos 3D, 2D, retro, texto, XR ou headless.",
         "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.",
@@ -284,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"
@@ -321,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);