@semacode/cli 2.3.0 → 2.3.1

package/dist/index.part01.d.ts

@@ -1,4 +1,5 @@
 import { compilarCodigo, type IrModulo } from "@sema/nucleo";
+import { type ContextoProjetoCarregado } from "./projeto.js";
 import { analisarDriftLegado, type OpcoesDriftLegado } from "./drift.js";
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
 import { criarBriefingAgente, resumirDriftPorModulo } from "./index.part03.js";
@@ -29,6 +30,8 @@ export interface DescobertaDocsIa {
 }
 export type TamanhoResumoIa = "micro" | "curto" | "medio";
 export type ModoResumoIa = "resumo" | "onboarding" | "review" | "mudanca" | "bug" | "arquitetura";
+export type ModoAnaliseDriftCli = "fresh" | "cache" | "none";
+export type PoliticaCacheDriftCli = "auto" | "refresh" | "off";
 export type ResultadoDriftIa = Awaited<ReturnType<typeof analisarDriftLegado>>;
 export type ResumoModuloDrift = ReturnType<typeof resumirDriftPorModulo>;
 export interface PacoteContextoModuloIa {
@@ -75,10 +78,15 @@ export interface PacoteContextoModuloIa {
         caminho: string;
         modulo: string | null;
         sucesso: boolean;
+        modoAnalise?: ModoAnaliseDriftCli;
+        executado?: boolean;
+        aviso?: string | null;
         resumo: ResumoModuloDrift;
         drift: ResultadoDriftIa;
     };
     briefing: ReturnType<typeof criarBriefingAgente>;
+    modoVerificacaoCodigo?: ResumoSemanticoModuloIa["modoVerificacaoCodigo"];
+    fontesConclusao?: string[];
 }
 export interface ResumoSemanticoModuloIa {
     geradoEm: string;
@@ -123,7 +131,14 @@ export declare function obterArgumentos(): {
 export declare function renderizarCaixaAscii(linhas: string[]): string;
 export declare function renderizarSecaoAscii(titulo: string, linhas: string[]): string;
 export declare function ajuda(): string;
-export declare function resolverOpcoesDriftCli(args: string[]): OpcoesDriftLegado;
+export declare function normalizarModoAnaliseDriftCli(args: string[], padrao?: ModoAnaliseDriftCli): ModoAnaliseDriftCli;
+export declare function normalizarPoliticaCacheDriftCli(args: string[]): PoliticaCacheDriftCli | undefined;
+export declare function resolverOpcoesDriftCli(args: string[], cacheForcado?: PoliticaCacheDriftCli): OpcoesDriftLegado;
+export declare function resolverAnaliseDriftCli(args: string[], padrao?: ModoAnaliseDriftCli): {
+    modo: ModoAnaliseDriftCli;
+    opcoes: OpcoesDriftLegado;
+};
+export declare function criarResultadoDriftNaoExecutado(contextoProjeto: ContextoProjetoCarregado, opcoes?: OpcoesDriftLegado): ResultadoDriftIa;
 export declare function normalizarTamanhoResumo(args: string[]): TamanhoResumoIa;
 export declare function normalizarModoResumo(valor?: string): ModoResumoIa;
 export declare function descobrirDocsIa(): Promise<DescobertaDocsIa>;

package/dist/index.part01.js

@@ -114,11 +114,11 @@ export function ajuda() {
         ]),
         "",
         renderizarSecaoAscii("Comandos principais", [
-            "descoberta: sema inspecionar [arquivo-ou-pasta] [--json]",
+            "descoberta: sema inspecionar [arquivo-ou-pasta] [--drift <fresh|cache|none>|--com-drift] [--json] (padrão: none)",
             "catálogo: sema descobrir <catalogo|recomendar|explicar> [id] [--intencao <objetivo>] [--json]",
             "pipelines: sema pipeline <listar|descrever> [id] [--json]",
             "todas as capacidades: sema capabilities [--json]",
-            "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]",
+            "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--cache <auto|refresh|off>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]",
             "impacto: sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--json]",
             "renomeação: sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--escopo <arquivo|modulo|projeto>] [--json]",
             "importação: sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|php|typescript|python|dart> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]",
@@ -140,7 +140,7 @@ export function ajuda() {
         renderizarSecaoAscii("Ajuda IA-first", [
             "sema ajuda-ia",
             "sema starter-ia",
-            "sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--saida <diretorio>] [--raiz] [--json]",
+            "sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <fresh|cache|none>] [--saida <diretorio>] [--raiz] [--json]",
             "sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--json]",
             "sema prompt-ia",
             "sema prompt-ia-ui",
@@ -172,12 +172,88 @@ export function ajuda() {
         ]),
     ].join("\n");
 }
-export function resolverOpcoesDriftCli(args) {
+export function normalizarModoAnaliseDriftCli(args, padrao = "fresh") {
+    const valor = obterOpcao(args, "--drift");
+    if (valor === undefined)
+        return possuiFlag(args, "--com-drift") ? "fresh" : padrao;
+    if (valor === "fresh" || valor === "cache" || valor === "none")
+        return valor;
+    throw new Error("Use --drift fresh, --drift cache ou --drift none.");
+}
+export function normalizarPoliticaCacheDriftCli(args) {
+    const valor = obterOpcao(args, "--cache");
+    if (valor === undefined)
+        return undefined;
+    if (valor === "auto" || valor === "refresh" || valor === "off")
+        return valor;
+    throw new Error("Use --cache auto, --cache refresh ou --cache off.");
+}
+export function resolverOpcoesDriftCli(args, cacheForcado) {
     const escopo = obterOpcao(args, "--escopo");
+    const cache = cacheForcado ?? normalizarPoliticaCacheDriftCli(args);
     return {
         escopo: escopo === "arquivo" || escopo === "modulo" || escopo === "projeto" ? escopo : undefined,
         ignorarWorktrees: !possuiFlag(args, "--incluir-worktrees"),
         ignorarConsumidoresLaterais: !possuiFlag(args, "--incluir-consumidores-laterais"),
+        ...(cache ? { cache } : {}),
+    };
+}
+export function resolverAnaliseDriftCli(args, padrao = "fresh") {
+    const modo = normalizarModoAnaliseDriftCli(args, padrao);
+    const cache = modo === "fresh" ? "refresh" : modo === "cache" ? "auto" : undefined;
+    return {
+        modo,
+        opcoes: resolverOpcoesDriftCli(args, cache),
+    };
+}
+export function criarResultadoDriftNaoExecutado(contextoProjeto, opcoes) {
+    const escopo = opcoes?.escopo === "arquivo" || opcoes?.escopo === "projeto" ? opcoes.escopo : "modulo";
+    return {
+        comando: "drift",
+        sucesso: false,
+        escopo_aplicado: {
+            escopo,
+            ignorarWorktrees: opcoes?.ignorarWorktrees !== false,
+            ignorarConsumidoresLaterais: opcoes?.ignorarConsumidoresLaterais !== false,
+            termosEscopo: [],
+        },
+        consumerFramework: null,
+        appRoutes: [],
+        consumerSurfaces: [],
+        consumerBridges: [],
+        modulos: contextoProjeto.modulosSelecionados.map((item) => ({
+            caminho: item.caminho,
+            modulo: item.resultado.modulo?.nome ?? null,
+            tasks: item.resultado.ir?.tasks.length ?? 0,
+            routes: item.resultado.ir?.routes.length ?? 0,
+        })),
+        tasks: [],
+        impls_validos: [],
+        impls_quebrados: [],
+        vinculos_validos: [],
+        vinculos_quebrados: [],
+        rotas_divergentes: [],
+        recursos_validos: [],
+        recursos_divergentes: [],
+        persistencia_real: [],
+        resumo_operacional: {
+            scoreMedio: 0,
+            confiancaGeral: "baixa",
+            pontuacaoMinimaOperacional: 80,
+            pontuacaoAlvoAtual: 80,
+            pontuacaoAlvoFinal: 100,
+            passoEvolucaoPontuacao: 0.5,
+            proximaPontuacaoAlvo: 80,
+            pontuacaoAbaixoDoPiso: false,
+            pontuacaoAbaixoDoAlvo: false,
+            travasPontuacao: [],
+            riscosPrincipais: ["analise_drift_nao_executada"],
+            oQueTocar: [],
+            oQueValidar: ["executar sema drift antes de concluir sobre a implementação"],
+            oQueEstaFrouxo: ["codigo_nao_verificado_neste_modo"],
+            oQueFoiInferido: ["modo_contratos_apenas"],
+        },
+        diagnosticos: [],
     };
 }
 export function normalizarTamanhoResumo(args) {

package/dist/index.part02.js

@@ -320,27 +320,27 @@ export function criarBriefingMinimo(resumo, modo, tamanho) {
 }
 export function criarPromptCurtoModulo(resumo, modo, tamanho, capacidade) {
     const resumoTexto = renderizarResumoModuloTexto(resumo, tamanho, modo).trim();
-    return `Você está operando Sema em modo IA-first.
-
-Esta linguagem existe para traduzir intenção operacional em contrato consumível por IA. Humanos aprovam; agentes operam.
-
-Capacidade alvo: ${capacidade}
-Modo da tarefa: ${modo}
-
-Regras:
-- não invente sintaxe nem bloco fora da gramática oficial
-- preserve a intenção do contrato
-- use este resumo como fonte compacta inicial
-- se a tarefa pedir mais contexto, rode \`sema contexto-ia <arquivo.sema> --saida <diretorio> --json\` e então abra \`briefing.min.json\`, \`drift.json\` e \`ir.json\` nessa saída
-- não saia editando software vivo sem olhar risco, lacuna e checks sugeridos
-- se abrir código com \`SEMA-GOVERNED\`, volte ao contrato e chame Sema antes de editar
-- não crie nem conclua código governado acima de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} linhas; acima de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO}, planeje divisão; documentação Markdown não entra nesse limite de código
-- não crie nem edite contrato .sema acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} linhas; acima de ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA}, planeje split por domínio/capacidade, nunca parte_1/parte_2
-- vários contratos .sema podem governar o mesmo arquivo por vinculos; Sema Código deve preservar essa rastreabilidade
-${resumo.consumerFramework ? "- se for tarefa visual consumer, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivos aleatórios" : ""}
-
-Contexto compacto:
-${resumoTexto}
+    return `Você está operando Sema em modo IA-first.
+
+Esta linguagem existe para traduzir intenção operacional em contrato consumível por IA. Humanos aprovam; agentes operam.
+
+Capacidade alvo: ${capacidade}
+Modo da tarefa: ${modo}
+
+Regras:
+- não invente sintaxe nem bloco fora da gramática oficial
+- preserve a intenção do contrato
+- use este resumo como fonte compacta inicial
+- se a tarefa pedir mais contexto, rode \`sema contexto-ia <arquivo.sema> --saida <diretorio> --json\` e então abra \`briefing.min.json\`, \`drift.json\` e \`ir.json\` nessa saída
+- não saia editando software vivo sem olhar risco, lacuna e checks sugeridos
+- se abrir código com \`SEMA-GOVERNED\`, volte ao contrato e chame Sema antes de editar
+- não crie nem conclua código governado acima de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} linhas; acima de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO}, planeje divisão; documentação Markdown não entra nesse limite de código
+- não crie nem edite contrato .sema acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} linhas; acima de ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA}, planeje split por domínio/capacidade, nunca parte_1/parte_2
+- vários contratos .sema podem governar o mesmo arquivo por vinculos; Sema Código deve preservar essa rastreabilidade
+${resumo.consumerFramework ? "- se for tarefa visual consumer, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivos aleatórios" : ""}
+
+Contexto compacto:
+${resumoTexto}
 `;
 }
 //# sourceMappingURL=index.part02.js.map

package/dist/index.part03.d.ts

@@ -1,7 +1,7 @@
 import { type IrModulo } from "@sema/nucleo";
 import { analisarDriftLegado } from "./drift.js";
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-import { PacoteContextoModuloIa, ResumoSemanticoModuloIa } from "./index.part01.js";
+import { PacoteContextoModuloIa, ResumoSemanticoModuloIa, type ModoAnaliseDriftCli } from "./index.part01.js";
 export declare function renderizarResumoProjetoMarkdown(geradoEm: string, modulos: ResumoSemanticoModuloIa[], guiaPorCapacidade: GuiaCapacidadeIaMap): string;
 export declare function falharContextoIa(mensagem: string): never;
 export declare function garantirArquivoSema(caminhoArquivo: string): void;
@@ -52,7 +52,7 @@ export declare function criarBriefingAgente(arquivo: string, modulo: string, ir:
     ancoragensVinculo: string[];
     testesMinimos: string[];
 };
-export declare function carregarContextoModuloIa(arquivoEntrada: string): Promise<PacoteContextoModuloIa>;
+export declare function carregarContextoModuloIa(arquivoEntrada: string, args?: string[], modoDriftPadrao?: ModoAnaliseDriftCli): Promise<PacoteContextoModuloIa>;
 export declare const ARQUIVOS_RESUMO_MODULO_IA: readonly ["SEMA_BOOT.md", "SEMA_SMALL_MODEL.md", "agent-context-pack.json", "resumo.micro.txt", "resumo.curto.txt", "resumo.md", "briefing.min.json", "prompt-curto.txt"];
 export declare function gerarArquivosResumoModuloIa(contexto: PacoteContextoModuloIa, pastaBase: string): Promise<{
     artefatosCompactos: string[];

package/dist/index.part03.js

@@ -8,6 +8,7 @@ import { criarEntradaCanonicaProjeto } from './agentContext.js';
 import { renderizarSemaBoot, renderizarSemaSmallModel, } from './agentEntryPoints.js';
 import { escreverArquivoWorkspaceSeguro, validarDestinosEscritaWorkspace } from './workspaceWrite.js';
 import { resumirListaTexto } from './textoListas.js';
+import { criarResultadoDriftNaoExecutado, resolverAnaliseDriftCli, } from "./index.part01.js";
 import { coletarResumoSemanticoModulo, criarBriefingMinimo, criarPromptCurtoModulo, renderizarResumoModuloMarkdown, renderizarResumoModuloTexto } from "./index.part02.js";
 export function renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapacidade) {
     const entradaCanonica = criarEntradaCanonicaProjeto(guiaPorCapacidade);
@@ -253,10 +254,11 @@ export function criarBriefingAgente(arquivo, modulo, ir, resumoDrift, resultadoD
         ],
     };
 }
-export async function carregarContextoModuloIa(arquivoEntrada) {
+export async function carregarContextoModuloIa(arquivoEntrada, args = [], modoDriftPadrao = "fresh") {
     const arquivo = path.resolve(arquivoEntrada);
     garantirArquivoSema(arquivo);
-    const contextoProjeto = await carregarProjeto(arquivo, process.cwd());
+    const analiseDrift = resolverAnaliseDriftCli(args, modoDriftPadrao);
+    const contextoProjeto = await carregarProjeto(arquivo, process.cwd(), { escopo: analiseDrift.opcoes.escopo });
     const resultadoModulo = contextoProjeto.modulosSelecionados.find((item) => path.resolve(item.caminho) === arquivo)?.resultado;
     if (!resultadoModulo) {
         falharContextoIa(`Nao foi possivel encontrar o modulo correspondente ao arquivo ${arquivo}.`);
@@ -264,12 +266,19 @@ export async function carregarContextoModuloIa(arquivoEntrada) {
     const sucesso = !temErros(resultadoModulo.diagnosticos);
     const modulo = resultadoModulo.modulo?.nome ?? path.basename(arquivo, ".sema");
     const geradoEm = new Date().toISOString();
-    const resultadoDrift = await analisarDriftLegado(contextoProjeto);
+    const resultadoDrift = analiseDrift.modo === "none"
+        ? criarResultadoDriftNaoExecutado(contextoProjeto, analiseDrift.opcoes)
+        : await analisarDriftLegado(contextoProjeto, analiseDrift.opcoes);
     const drift = {
         comando: "drift",
         caminho: arquivo,
         modulo: resultadoModulo.modulo?.nome ?? null,
         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: resumirDriftPorModulo(resultadoModulo.modulo?.nome ?? null, arquivo, resultadoDrift),
         drift: resultadoDrift,
     };
@@ -321,6 +330,8 @@ export async function carregarContextoModuloIa(arquivoEntrada) {
         irJson: ir,
         drift,
         briefing,
+        modoVerificacaoCodigo: analiseDrift.modo === "none" ? "contratos_apenas" : undefined,
+        fontesConclusao: analiseDrift.modo === "none" ? ["contrato"] : undefined,
     };
 }
 export const ARQUIVOS_RESUMO_MODULO_IA = [

package/dist/index.part04.d.ts

@@ -1,7 +1,7 @@
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-import { ContextoIaGerado, ResumoSemanticoModuloIa } from "./index.part01.js";
+import { ContextoIaGerado, ResumoSemanticoModuloIa, type ModoAnaliseDriftCli } from "./index.part01.js";
 export declare const ARQUIVOS_RESUMO_PROJETO_IA: readonly ["SEMA_BOOT.md", "SEMA_SMALL_MODEL.md", "SEMA_BRIEF.md", "SEMA_BRIEF.micro.txt", "SEMA_BRIEF.curto.txt", "SEMA_INDEX.json", "AGENT_CONTEXT_PACK.json", "docs/ai-integration.md"];
-export declare function gerarResumoProjetoIa(entrada: string | undefined, pastaSaidaOpcional?: string, escreverNaRaiz?: boolean): Promise<{
+export declare function gerarResumoProjetoIa(entrada: string | undefined, pastaSaidaOpcional?: string, escreverNaRaiz?: boolean, args?: string[], modoDriftPadrao?: ModoAnaliseDriftCli): Promise<{
     geradoEm: string;
     baseProjeto: string;
     pastaSaida: string;

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>;