@semacode/cli 2.3.0 → 3.0.0

package/dist/geracaoCore.js

@@ -1,7 +1,5 @@
-// SEMA-GOVERNED
-// M?dulo: sema.produto.orcamento_semantico
-// Contrato: contratos/sema/orcamento_semantico.sema
-// Descri??o: normaliza??o de gera??o, escrita estruturada e execu??o de testes gerados por alvo.
+// SEMA-GOVERNED: sema.produto.geradores_nativos
+// Descricao: normaliza geracao, escrita estruturada e execucao de testes gerados por alvo.
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { formatarDiagnosticos } from "@sema/nucleo";
@@ -301,7 +299,7 @@ export function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = fa
                 saidaErro: "Nao foi possivel localizar o runner tsx junto da CLI para executar testes TypeScript.",
             };
         }
-        const execucao = spawnSync("node", [TSX_EXECUTOR_CLI, arquivoTeste], {
+        const execucao = spawnSync(process.execPath, [TSX_EXECUTOR_CLI, arquivoTeste], {
             stdio: silencioso ? "pipe" : "inherit",
             cwd: baseSaida,
             encoding: silencioso ? "utf8" : undefined,
@@ -321,7 +319,7 @@ export function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = fa
             }
             return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
         }
-        const execucao = spawnSync("node", ["--test", path.join(baseSaida, arquivoTeste)], {
+        const execucao = spawnSync(process.execPath, ["--test", path.join(baseSaida, arquivoTeste)], {
             stdio: silencioso ? "pipe" : "inherit",
             encoding: silencioso ? "utf8" : undefined,
         });

package/dist/iaPrompts.d.ts

@@ -1,6 +1,6 @@
-export declare const STARTER_IA = "Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.\n\nImportante:\n- a Sema se apresenta publicamente como protocolo e funciona tecnicamente como linguagem de intencao\n- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana\n- humanos sao autores/aprovadores; agentes sao os consumidores primarios do contrato\n- leitura humana e bonus toleravel, nao objetivo de produto\n- a Sema nao e gerador magico que deveria fazer tudo\n- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao\n- a Sema gera codigo e scaffolding real para TypeScript, Python, PHP, Dart, Lua, JavaScript, HTML e CSS\n- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico\n- a Sema usa `impl` para ligar task a simbolo real do runtime\n- a Sema usa `vinculos` para ligar contrato a arquivo, simbolo, recurso e superficie real\n- a Sema usa `execucao` para explicitar timeout, retry, compensacao e criticidade\n- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo com score, confianca e lacunas\n- a Sema usa `resumo` e `prompt-curto` para IA fraca, gratuita ou com pouco contexto\n- a Sema usa `contexto-ia` para gerar `ast.json`, `ir.json`, `drift.json`, `briefing.json` e artefatos compactos antes da edicao\n- timeout definido pelo agente nao e falha do Sema; aumente o timeout e tente de novo antes de concluir falha\n- a Sema pode servir de base para interfaces graficas elegantes e coerentes\n- a Sema gera artefatos HTML/CSS derivados, mas nao substitui sozinha uma interface completa de produto\n- trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto\n- se a tarefa envolver UI, prefira pedir Sema + React + TypeScript ou Sema + arquitetura de front-end\n- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade\n\nRegras:\n- nao invente sintaxe fora da gramatica e dos exemplos oficiais\n- antes de qualquer acao, crie, edite ou remova o contrato .sema aplicavel; isso vale para Software, Author, Workflow, Ops, Game, Legal e Research\n- se a IA for fraca, nao tente abrir tudo de uma vez\n- use `sema resumo <arquivo> --micro --json` pelo stdout antes de subir para o pacote completo\n- se `sema resumo . --micro` estourar timeout local, repita com timeout maior ou escopo menor; nao avance com codigo\n- trate `ir --json` como fonte de verdade semantica\n- trate `briefing.json` como plano de intervencao antes de editar projeto vivo\n- trate `diagnosticos --json` como fonte de correcao\n- use `sema formatar` como fonte unica de estilo\n- preserve a intencao do contrato\n- nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo\n\nComandos essenciais:\n- resumo compacto por capacidade: `sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`\n- prompt curto para IA fraca: `sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`\n- descoberta do projeto: `sema inspecionar [arquivo-ou-pasta] --json`\n- auditoria do contrato vivo: `sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--json]`\n- mapa de impacto: `sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--json]`\n- renomeacao assistida: `sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--json]`\n- contexto completo do modulo: `sema contexto-ia <arquivo.sema>`\n- estrutura sintatica: `sema ast <arquivo.sema> --json`\n- estrutura semantica: `sema ir <arquivo.sema> --json`\n- validacao: `sema validar <arquivo.sema> --json`\n- diagnosticos: `sema diagnosticos <arquivo.sema> --json`\n- formatacao: `sema formatar <arquivo.sema>`\n- importacao assistida de legado: `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>`\n- exemplos oficiais no projeto: `sema instalar-exemplos`\n- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>`\n- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`\n\nAntes de editar:\n1. leia README, docs de IA e um exemplo oficial parecido\n2. se a IA for fraca, rode `sema resumo <arquivo> --micro --json` e use o stdout compacto\n   - se timeout local estourar, aumente o timeout e tente de novo; timeout nao significa Sema inativo\n3. se a IA aguentar mais, rode `sema drift` para medir impls, vinculos, rotas, score e lacunas\n4. se a tarefa for pesada, rode `sema contexto-ia` e leia `briefing.json`\n5. consulte AST e IR do modulo alvo so quando a capacidade realmente aguentar\n\nDepois de editar:\n1. rode `sema formatar`\n2. rode `sema validar --json`\n3. se houver falha, use `diagnosticos --json`\n4. rode `sema drift` de novo quando mexer em codigo vivo\n5. se a tarefa pedir codigo derivado, rode `sema compilar`\n6. feche com `sema verificar <arquivo-ou-pasta> --json`\n\nPriorize sempre:\n- exemplos oficiais\n- JSON da CLI\n- o menor artefato que resolva a tarefa da IA atual\n- score, confianca e lacunas do `drift`\n- `briefing.json` como guia de mudanca\n- consistencia semantica\n\nSuperficies que a IA deve enxergar como first-class:\n- `route`\n- `worker`\n- `evento`\n- `fila`\n- `cron`\n- `webhook`\n- `cache`\n- `storage`\n- `policy`\n\nNao improvise quando faltar contexto.\n";
-export declare const PROMPT_BASE_IA = "Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo.\n\nTrate a Sema como protocolo de governanca semantica e linguagem de intencao feita para IA, nao para leitura humana confortavel. Humanos escrevem e aprovam; agentes consomem. Nao invente sintaxe, palavras-chave ou blocos fora da gramatica e dos exemplos oficiais.\n\nFontes de verdade, em ordem:\n1. se o projeto expuser `SEMA_CONTEXT.md`, comece por ele\n2. `AGENT_CONTEXT_PACK.json`\n3. `SEMA_BRIEF.md`\n4. `SEMA_INDEX.json`\n5. `AGENTS.md`\n6. README do projeto\n7. gramatica e documentacao de sintaxe da Sema\n8. exemplos oficiais, com prioridade para o vertical de pagamento\n9. `sema resumo <arquivo> --micro --json` e o stdout compacto quando a IA for fraca\n10. AST, IR e diagnosticos exportados pela CLI em JSON quando a capacidade aguentar\n\nRegras de operacao:\n- contrato vem antes da acao: crie, edite ou remova o .sema aplicavel antes de codigo, docs operacionais, texto Author, workflow, jogo, pesquisa, legal ou ops\n- preserve o significado semantico\n- use o formatador oficial da Sema como fonte unica de estilo\n- use diagnosticos estruturados como contrato de correcao\n- use a IR como fonte de verdade semantica quando houver duvida\n- use predicados canonicos como normalizacao opcional, preservando a forma original\n- nao conclua uma alteracao sem validar e verificar o modulo\n- comece pelo menor artefato semantico que resolva a tarefa\n\nAntes de editar `.sema`, entenda:\n- o module alvo\n- os contratos de task, route, error, effects, guarantees, state e flow\n- os exemplos oficiais relacionados\n\nDepois de editar `.sema`, execute este fluxo:\n1. formatar\n2. validar\n3. diagnosticar, se houver falha\n4. verificar\n\nSe houver conflito entre texto livre e IR/diagnosticos, priorize a IR e os diagnosticos da CLI.\n\nSe algo nao estiver claro, siga a forma ja usada nos exemplos oficiais. Nao improvise sem base.\n";
+export declare const STARTER_IA = "Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.\n\nImportante:\n- a Sema se apresenta publicamente como protocolo e funciona tecnicamente como linguagem de intencao\n- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana\n- humanos sao autores/aprovadores; agentes sao os consumidores primarios do contrato\n- leitura humana e bonus toleravel, nao objetivo de produto\n- a Sema nao e gerador magico que deveria fazer tudo\n- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao\n- a Sema gera codigo e scaffolding real para TypeScript, Python, PHP, Dart, Lua, JavaScript, HTML e CSS\n- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico\n- a Sema usa `impl` para ligar task a simbolo real do runtime\n- a Sema usa `vinculos` para ligar contrato a arquivo, simbolo, recurso e superficie real\n- a Sema usa `execucao` para explicitar timeout, retry, compensacao e criticidade\n- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo com score, confianca e lacunas\n- a Sema usa `resumo` e `prompt-curto` para IA fraca, gratuita ou com pouco contexto\n- a Sema usa `contexto-ia` para gerar `ast.json`, `ir.json`, `drift.json`, `briefing.json` e artefatos compactos antes da edicao\n- timeout definido pelo agente nao e falha do Sema; aumente o timeout e tente de novo antes de concluir falha\n- a Sema pode servir de base para interfaces graficas elegantes e coerentes\n- a Sema gera artefatos HTML/CSS derivados, mas nao substitui sozinha uma interface completa de produto\n- trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto\n- se a tarefa envolver UI, prefira pedir Sema + React + TypeScript ou Sema + arquitetura de front-end\n- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade\n\nRegras:\n- nao invente sintaxe fora da gramatica e dos exemplos oficiais\n- antes de qualquer acao, crie, edite ou remova o contrato .sema aplicavel; isso vale para Software, Author, Workflow, Ops, Game, Legal e Research\n- se a IA for fraca, nao tente abrir tudo de uma vez\n- use `sema resumo <arquivo> --micro --drift none --json` pelo stdout antes de subir para o pacote completo; score, confian\u00E7a e implementa\u00E7\u00E3o ficam n\u00E3o avaliados\n- se `sema resumo . --micro` estourar timeout local, repita com timeout maior ou escopo menor; nao avance com codigo\n- trate `ir --json` como fonte de verdade semantica\n- trate `briefing.json` como plano de intervencao antes de editar projeto vivo\n- trate `diagnosticos --json` como fonte de correcao\n- use `sema formatar` como fonte unica de estilo\n- preserve a intencao do contrato\n- nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo\n\nComandos essenciais:\n- resumo compacto por capacidade: `sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <none|cache|fresh>]` (padr\u00E3o: none, sem evid\u00EAncia derivada)\n- prompt curto para IA fraca: `sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`\n- descoberta do projeto: `sema inspecionar [arquivo-ou-pasta] [--drift <none|cache|fresh>] --json` (padr\u00E3o: none)\n- auditoria do contrato vivo: `sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--cache <none|cache|fresh>] [--json]` (padr\u00E3o: fresh; none ainda executa sem cache persistente)\n- mapa de impacto: `sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--json]`\n- renomeacao assistida: `sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--json]`\n- contexto completo do modulo: `sema contexto-ia <arquivo.sema>`\n- estrutura sintatica: `sema ast <arquivo.sema> --json`\n- estrutura semantica: `sema ir <arquivo.sema> --json`\n- validacao: `sema validar <arquivo.sema> --json`\n- diagnosticos: `sema diagnosticos <arquivo.sema> --json`\n- formatacao: `sema formatar <arquivo.sema>`\n- importacao assistida de legado: `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>`\n- exemplos oficiais no projeto: `sema instalar-exemplos`\n- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>`\n- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`\n- distribui\u00E7\u00E3o global: `sema skill status --json` diagnostica sem alterar; `sema skill sync --json` repara launcher e skill; no Windows, PowerShell usa `sema.ps1` no PATH, cmd.exe usa `sema.cmd`, e `& \"$env:SystemRoot\\System32\\WindowsPowerShell\\v1.0\\powershell.exe\" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File \"$HOME\\.sema\\bin\\sema-managed.ps1\" --version` \u00E9 o fallback absoluto\n\nAntes de editar:\n1. leia README, docs de IA e um exemplo oficial parecido\n2. se a IA for fraca, rode `sema resumo <arquivo> --micro --drift none --json` e use o stdout compacto sem inventar evid\u00EAncia de implementa\u00E7\u00E3o\n   - se timeout local estourar, aumente o timeout e tente de novo; timeout nao significa Sema inativo\n3. se a IA aguentar mais, rode `sema drift --cache fresh` para medir impls, vinculos, rotas, score e lacunas com evid\u00EAncia recalculada\n4. se a tarefa for pesada, rode `sema contexto-ia` e leia `briefing.json`\n5. consulte AST e IR do modulo alvo so quando a capacidade realmente aguentar\n\nDepois de editar:\n1. rode `sema formatar`\n2. rode `sema validar --json`\n3. se houver falha, use `diagnosticos --json`\n4. rode `sema drift --cache fresh` de novo quando mexer em codigo vivo\n5. se a tarefa pedir codigo derivado, rode `sema compilar`\n6. feche com `sema verificar <arquivo-ou-pasta> --json`\n\nPriorize sempre:\n- exemplos oficiais\n- JSON da CLI\n- o menor artefato que resolva a tarefa da IA atual\n- score, confianca e lacunas do `drift`\n- `briefing.json` como guia de mudanca\n- consistencia semantica\n\nSuperficies que a IA deve enxergar como first-class:\n- `route`\n- `worker`\n- `evento`\n- `fila`\n- `cron`\n- `webhook`\n- `cache`\n- `storage`\n- `policy`\n\nNao improvise quando faltar contexto.\n";
+export declare const PROMPT_BASE_IA = "Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo.\n\nTrate a Sema como protocolo de governanca semantica e linguagem de intencao feita para IA, nao para leitura humana confortavel. Humanos escrevem e aprovam; agentes consomem. Nao invente sintaxe, palavras-chave ou blocos fora da gramatica e dos exemplos oficiais.\n\nFontes de verdade, em ordem:\n1. se o projeto expuser `SEMA_CONTEXT.md`, comece por ele\n2. `AGENT_CONTEXT_PACK.json`\n3. `SEMA_BRIEF.md`\n4. `SEMA_INDEX.json`\n5. `AGENTS.md`\n6. README do projeto\n7. gramatica e documentacao de sintaxe da Sema\n8. exemplos oficiais, com prioridade para o vertical de pagamento\n9. `sema resumo <arquivo> --micro --drift none --json` e o stdout compacto quando a IA for fraca; campos derivados nulos significam n\u00E3o avaliados\n10. AST, IR e diagnosticos exportados pela CLI em JSON quando a capacidade aguentar\n\nRegras de operacao:\n- contrato vem antes da acao: crie, edite ou remova o .sema aplicavel antes de codigo, docs operacionais, texto Author, workflow, jogo, pesquisa, legal ou ops\n- preserve o significado semantico\n- use o formatador oficial da Sema como fonte unica de estilo\n- use diagnosticos estruturados como contrato de correcao\n- use a IR como fonte de verdade semantica quando houver duvida\n- use predicados canonicos como normalizacao opcional, preservando a forma original\n- nao conclua uma alteracao sem validar e verificar o modulo\n- comece pelo menor artefato semantico que resolva a tarefa\n\nAntes de editar `.sema`, entenda:\n- o module alvo\n- os contratos de task, route, error, effects, guarantees, state e flow\n- os exemplos oficiais relacionados\n\nDepois de editar `.sema`, execute este fluxo:\n1. formatar\n2. validar\n3. diagnosticar, se houver falha\n4. verificar\n\nSe houver conflito entre texto livre e IR/diagnosticos, priorize a IR e os diagnosticos da CLI.\n\nSe algo nao estiver claro, siga a forma ja usada nos exemplos oficiais. Nao improvise sem base.\n";
 export declare const PROMPT_IA_UI = "Atue como Engenheiro de Software Senior e UX/UI Designer de elite.\n\nQuero que voce trabalhe com Sema como fonte de verdade semantica do sistema e com React + TypeScript como camada de interface.\n\nEntregue obrigatoriamente duas partes integradas:\n1. os arquivos `.sema` do dominio\n2. a proposta ou implementacao da interface em React + TypeScript\n\nRegras:\n- nao entregue apenas HTML solto em arquivo unico\n- nao trate a Sema como enfeite conceitual\n- a interface deve nascer do contrato semantico definido em Sema\n- use os exemplos oficiais da Sema como referencia de estilo e semantica\n- nao invente sintaxe fora da gramatica suportada\n\nA Sema deve modelar, quando fizer sentido:\n- `module`\n- `use`\n- `entity`\n- `enum`\n- `state`\n- `task`\n- `flow`\n- `route`\n- `effects`\n- `error`\n- `guarantees`\n- `tests`\n- `docs`\n\nA interface deve refletir visualmente:\n- `state` como status e progresso observavel\n- `flow` como etapas ou orquestracao visivel\n- `error` como falhas tratadas com clareza\n- `effects` como operacoes relevantes para usuario ou operacao\n- `guarantees` como confianca, confirmacao ou consistencia final\n\nEstruture a entrega assim:\n1. visao do produto\n2. dominio modelado em Sema\n3. arquitetura de pastas em React + TypeScript\n4. componentes principais\n5. estrategia visual\n6. codigo principal da interface\n7. explicacao curta de como a UI conversa com a semantica da Sema\n\nSe a tarefa envolver app visual, a Sema governa o significado e o React renderiza a experiencia. Nao atropele essa separacao.\n";
 export declare const PROMPT_IA_REACT = "Crie uma solucao com Sema + React + TypeScript.\n\nRegras principais:\n- a Sema deve ser a fonte de verdade semantica do dominio\n- React + TypeScript deve ser a camada de interface e experiencia\n- nao entregue HTML unico solto\n- nao trate a Sema como enfeite\n\nEntregue obrigatoriamente:\n1. arquivos `.sema` do dominio\n2. arquitetura de pastas do frontend\n3. componentes React principais\n4. contratos e tipos derivados da semantica\n5. interface elegante e implementavel\n\nA modelagem Sema deve cobrir, quando fizer sentido:\n- `entity`\n- `enum`\n- `state`\n- `task`\n- `flow`\n- `route`\n- `effects`\n- `error`\n- `guarantees`\n- `tests`\n\nA interface React deve tornar visiveis:\n- estado atual e transicoes relevantes\n- fluxo operacional\n- erros publicos\n- efeitos operacionais importantes\n- garantias ou confirmacoes finais\n\nEstruture a entrega assim:\n1. visao do produto\n2. arquivos `.sema`\n3. arquitetura React + TypeScript\n4. componentes e telas\n5. codigo principal\n6. explicacao de como a UI deriva da semantica da Sema\n\nSe houver duvida, siga os exemplos oficiais e mantenha a separacao:\n- Sema governa o significado\n- React governa a apresentacao\n";
 export declare const PROMPT_IA_SEMA_PRIMEIRO = "Quero que voce trabalhe no modo \"Sema primeiro\".\n\nRegra principal:\n- modele primeiro o dominio em arquivos `.sema`\n- se a intencao mudar, crie, edite ou remova o contrato antes de qualquer acao operacional\n- so depois proponha ou gere codigo de aplicacao derivado disso\n\nFluxo obrigatorio:\n1. entender o dominio pedido\n2. modelar o contrato em Sema\n3. validar coerencia entre `task`, `route`, `state`, `flow`, `error`, `effects` e `guarantees`\n4. so depois gerar TypeScript, Python, React ou outra camada de implementacao\n\nNao entregue apenas codigo de interface ou codigo imperativo direto sem antes entregar a camada semantica.\n\nA modelagem em Sema deve:\n- preservar a intencao do dominio\n- explicitar entradas, saidas, erros, efeitos e garantias\n- usar apenas blocos e sintaxe oficiais\n- incluir testes embutidos quando fizer sentido\n\nSe houver interface grafica:\n- entregue a modelagem Sema primeiro\n- depois explique como a interface deve refletir a semantica\n- se gerar UI, use React + TypeScript em vez de HTML unico solto\n\nSe houver backend:\n- entregue a modelagem Sema primeiro\n- depois gere a borda publica e a implementacao derivada\n\nNao pule a etapa semantica. A camada `.sema` e a ancora principal da solucao.\n";
-export declare const EXEMPLOS_PROMPT_IA = "Exemplos de prompt oficial para trabalhar com Sema\n\n1. Sema primeiro\n\nCrie uma solucao seguindo a estrategia \"Sema primeiro\".\nEntregue primeiro os arquivos `.sema` do dominio e so depois a implementacao derivada.\nNao entregue apenas codigo imperativo.\nUse Sema como fonte de verdade para contratos, estados, erros, efeitos e garantias.\n\n2. Sema + React + TypeScript\n\nCrie um projeto com Sema + React + TypeScript.\nEntregue:\n- os arquivos `.sema` do dominio\n- a arquitetura de pastas do frontend\n- componentes React que reflitam `state`, `flow`, `error`, `effects` e `guarantees`\n- uma interface elegante e implementavel\n- nao entregue HTML solto em arquivo unico\n\n3. Revisar ou corrigir um modulo Sema\n\nRevise e corrija um modulo `.sema`.\nAntes de editar:\n- leia os exemplos oficiais parecidos\n- consulte AST e IR\nDepois de editar:\n- rode `sema formatar`\n- rode `sema validar --json`\n- use `diagnosticos --json` se houver falha\n- feche com `sema verificar`\n\n4. Caso de UI sem perder a semantica\n\nQuero uma interface premium para este dominio, mas a solucao deve continuar ancorada em Sema.\nModele primeiro o dominio em `.sema`.\nDepois proponha uma interface em React + TypeScript que torne visiveis:\n- estado\n- fluxo\n- erros\n- efeitos\n- garantias\nNao transforme isso em um `index.html` solto.\n\nComandos uteis da CLI para esse fluxo:\n- `sema starter-ia`\n- `sema ajuda-ia`\n- `sema descobrir catalogo --json`\n- `sema descobrir recomendar --intencao \"<objetivo>\" --json`\n- `sema interativo pipelines --json`\n- `sema resumo <arquivo-ou-pasta>`\n- `sema prompt-curto <arquivo-ou-pasta>`\n- `sema prompt-ia`\n- `sema prompt-ia-ui`\n- `sema prompt-ia-react`\n- `sema prompt-ia-sema-primeiro`\n- `sema contexto-ia <arquivo.sema>`\n";
+export declare const EXEMPLOS_PROMPT_IA = "Exemplos de prompt oficial para trabalhar com Sema\n\n1. Sema primeiro\n\nCrie uma solucao seguindo a estrategia \"Sema primeiro\".\nEntregue primeiro os arquivos `.sema` do dominio e so depois a implementacao derivada.\nNao entregue apenas codigo imperativo.\nUse Sema como fonte de verdade para contratos, estados, erros, efeitos e garantias.\n\n2. Sema + React + TypeScript\n\nCrie um projeto com Sema + React + TypeScript.\nEntregue:\n- os arquivos `.sema` do dominio\n- a arquitetura de pastas do frontend\n- componentes React que reflitam `state`, `flow`, `error`, `effects` e `guarantees`\n- uma interface elegante e implementavel\n- nao entregue HTML solto em arquivo unico\n\n3. Revisar ou corrigir um modulo Sema\n\nRevise e corrija um modulo `.sema`.\nAntes de editar:\n- leia os exemplos oficiais parecidos\n- consulte AST e IR\nDepois de editar:\n- rode `sema formatar`\n- rode `sema validar --json`\n- use `diagnosticos --json` se houver falha\n- feche com `sema verificar`\n\n4. Caso de UI sem perder a semantica\n\nQuero uma interface premium para este dominio, mas a solucao deve continuar ancorada em Sema.\nModele primeiro o dominio em `.sema`.\nDepois proponha uma interface em React + TypeScript que torne visiveis:\n- estado\n- fluxo\n- erros\n- efeitos\n- garantias\nNao transforme isso em um `index.html` solto.\n\nComandos uteis da CLI para esse fluxo:\n- `sema starter-ia`\n- `sema ajuda-ia`\n- `sema descobrir catalogo --json`\n- `sema descobrir recomendar --intencao \"<objetivo>\" --json`\n- `sema interativo pipelines --json`\n- `sema resumo <arquivo-ou-pasta> --drift none`\n- `sema prompt-curto <arquivo-ou-pasta>`\n- `sema prompt-ia`\n- `sema prompt-ia-ui`\n- `sema prompt-ia-react`\n- `sema prompt-ia-sema-primeiro`\n- `sema contexto-ia <arquivo.sema>`\n";

package/dist/iaPrompts.js

@@ -1,7 +1,5 @@
-// SEMA-GOVERNED
-// M?dulo: sema.produto.orcamento_semantico
-// Contrato: contratos/sema/orcamento_semantico.sema
-// Descri??o: textos oficiais de prompt e onboarding IA-first usados pela CLI.
+// SEMA-GOVERNED: sema.produto.governanca_ia.drift.cache.modos, sema.governanca_ia_contexto
+// Descrição: textos oficiais de prompt e onboarding que distinguem contrato resumido de evidência fresh do código vivo.
 export const STARTER_IA = `Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.
 
 Importante:
@@ -30,7 +28,7 @@ Regras:
 - nao invente sintaxe fora da gramatica e dos exemplos oficiais
 - antes de qualquer acao, crie, edite ou remova o contrato .sema aplicavel; isso vale para Software, Author, Workflow, Ops, Game, Legal e Research
 - se a IA for fraca, nao tente abrir tudo de uma vez
-- use \`sema resumo <arquivo> --micro --json\` pelo stdout antes de subir para o pacote completo
+- use \`sema resumo <arquivo> --micro --drift none --json\` pelo stdout antes de subir para o pacote completo; score, confiança e implementação ficam não avaliados
 - se \`sema resumo . --micro\` estourar timeout local, repita com timeout maior ou escopo menor; nao avance com codigo
 - trate \`ir --json\` como fonte de verdade semantica
 - trate \`briefing.json\` como plano de intervencao antes de editar projeto vivo
@@ -40,10 +38,10 @@ Regras:
 - nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo
 
 Comandos essenciais:
-- resumo compacto por capacidade: \`sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]\`
+- resumo compacto por capacidade: \`sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <none|cache|fresh>]\` (padrão: none, sem evidência derivada)
 - prompt curto para IA fraca: \`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> [--escopo <arquivo|modulo|projeto>] [--json]\`
+- descoberta do projeto: \`sema inspecionar [arquivo-ou-pasta] [--drift <none|cache|fresh>] --json\` (padrão: none)
+- auditoria do contrato vivo: \`sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--cache <none|cache|fresh>] [--json]\` (padrão: fresh; none ainda executa sem cache persistente)
 - 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>\`
@@ -55,13 +53,14 @@ Comandos essenciais:
 - importacao assistida de legado: \`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>\`
 - exemplos oficiais no projeto: \`sema instalar-exemplos\`
 - geracao de codigo: \`sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>\`
-- verificacao final: \`sema verificar <arquivo-ou-pasta> [--json]\`
+- verificacao final: \`sema verificar <arquivo-ou-pasta> [--json]\`
+- distribuição global: \`sema skill status --json\` diagnostica sem alterar; \`sema skill sync --json\` repara launcher e skill; no Windows, PowerShell usa \`sema.ps1\` no PATH, cmd.exe usa \`sema.cmd\`, e \`& "$env:SystemRoot\\System32\\WindowsPowerShell\\v1.0\\powershell.exe" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$HOME\\.sema\\bin\\sema-managed.ps1" --version\` é o fallback absoluto
 
 Antes de editar:
 1. leia README, docs de IA e um exemplo oficial parecido
-2. se a IA for fraca, rode \`sema resumo <arquivo> --micro --json\` e use o stdout compacto
+2. se a IA for fraca, rode \`sema resumo <arquivo> --micro --drift none --json\` e use o stdout compacto sem inventar evidência de implementação
    - se timeout local estourar, aumente o timeout e tente de novo; timeout nao significa Sema inativo
-3. se a IA aguentar mais, rode \`sema drift\` para medir impls, vinculos, rotas, score e lacunas
+3. se a IA aguentar mais, rode \`sema drift --cache fresh\` para medir impls, vinculos, rotas, score e lacunas com evidência recalculada
 4. se a tarefa for pesada, rode \`sema contexto-ia\` e leia \`briefing.json\`
 5. consulte AST e IR do modulo alvo so quando a capacidade realmente aguentar
 
@@ -69,7 +68,7 @@ Depois de editar:
 1. rode \`sema formatar\`
 2. rode \`sema validar --json\`
 3. se houver falha, use \`diagnosticos --json\`
-4. rode \`sema drift\` de novo quando mexer em codigo vivo
+4. rode \`sema drift --cache fresh\` de novo quando mexer em codigo vivo
 5. se a tarefa pedir codigo derivado, rode \`sema compilar\`
 6. feche com \`sema verificar <arquivo-ou-pasta> --json\`
 
@@ -107,7 +106,7 @@ Fontes de verdade, em ordem:
 6. README do projeto
 7. gramatica e documentacao de sintaxe da Sema
 8. exemplos oficiais, com prioridade para o vertical de pagamento
-9. \`sema resumo <arquivo> --micro --json\` e o stdout compacto quando a IA for fraca
+9. \`sema resumo <arquivo> --micro --drift none --json\` e o stdout compacto quando a IA for fraca; campos derivados nulos significam não avaliados
 10. AST, IR e diagnosticos exportados pela CLI em JSON quando a capacidade aguentar
 
 Regras de operacao:
@@ -310,7 +309,7 @@ Comandos uteis da CLI para esse fluxo:
 - \`sema descobrir catalogo --json\`
 - \`sema descobrir recomendar --intencao "<objetivo>" --json\`
 - \`sema interativo pipelines --json\`
-- \`sema resumo <arquivo-ou-pasta>\`
+- \`sema resumo <arquivo-ou-pasta> --drift none\`
 - \`sema prompt-curto <arquivo-ou-pasta>\`
 - \`sema prompt-ia\`
 - \`sema prompt-ia-ui\`

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-#!/usr/bin/env node
 export * from "./index.part01.js";
 export * from "./index.part08.js";
+export * from "./cliHelp.js";
+export { criarAjudaRaiz } from "./cliHelpTexto.js";
+export * from "./saidaCli.js";
 export { iniciarProfileAuthor, comandoAuthor, criarAuthorBriefing, revisarClichesAuthor } from "./profileAuthorCommand.js";
 export { validarProfileSemantico } from "./profileCommand.js";
 export { materializarExemplosOficiais } from "./exemplosOficiais.js";
@@ -8,3 +10,4 @@ export { expandirIntencaoSemanticaProfile, sugerirStarterPresetProfile, validarP
 export * from "./pipelineConteudo/index.js";
 export * from "./sistemasInterativos/index.js";
 export * from "./discovery/index.js";
+export * from "./distribuicao/index.js";

package/dist/index.js

@@ -1,12 +1,10 @@
-#!/usr/bin/env node
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
-import { realpathSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { principal } from "./index.part08.js";
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.distribuicao_global, sema.produto.cli_invocacao_publica
+// Descrição: superfície de biblioteca da CLI; o executável público vive exclusivamente em bin.ts.
 export * from "./index.part01.js";
 export * from "./index.part08.js";
+export * from "./cliHelp.js";
+export { criarAjudaRaiz } from "./cliHelpTexto.js";
+export * from "./saidaCli.js";
 export { iniciarProfileAuthor, comandoAuthor, criarAuthorBriefing, revisarClichesAuthor } from "./profileAuthorCommand.js";
 export { validarProfileSemantico } from "./profileCommand.js";
 export { materializarExemplosOficiais } from "./exemplosOficiais.js";
@@ -14,22 +12,5 @@ export { expandirIntencaoSemanticaProfile, sugerirStarterPresetProfile, validarP
 export * from "./pipelineConteudo/index.js";
 export * from "./sistemasInterativos/index.js";
 export * from "./discovery/index.js";
-function moduloExecutadoDiretamente() {
-    if (!process.argv[1]) {
-        return false;
-    }
-    try {
-        return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
-    }
-    catch {
-        return path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url));
-    }
-}
-if (moduloExecutadoDiretamente()) {
-    principal().catch((erro) => {
-        console.error("Falha ao executar a CLI da Sema.");
-        console.error(erro instanceof Error ? erro.stack ?? erro.message : erro);
-        process.exit(1);
-    });
-}
+export * from "./distribuicao/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.part01.d.ts

@@ -1,8 +1,10 @@
 import { compilarCodigo, type IrModulo } from "@sema/nucleo";
 import { analisarDriftLegado, type OpcoesDriftLegado } from "./drift.js";
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-import { criarBriefingAgente, resumirDriftPorModulo } from "./index.part03.js";
-export type Comando = "iniciar" | "init" | "dev" | "sync" | "author" | "profile" | "conteudo" | "interativo" | "descobrir" | "pipeline" | "capabilities" | "validar" | "ast" | "ir" | "compilar" | "gerar" | "testar" | "diagnosticos" | "verificar" | "inspecionar" | "drift" | "impacto" | "renomear-semantico" | "importar" | "doctor" | "formatar" | "ajuda-ia" | "starter-ia" | "sync-codex" | "instalar-exemplos" | "rule-packs" | "docs-impacto" | "finalizar-mudanca" | "resumo" | "prompt-curto" | "prompt-ia" | "prompt-ia-ui" | "prompt-ia-react" | "prompt-ia-sema-primeiro" | "exemplos-prompt-ia" | "contexto-ia";
+import { renderizarCaixaAscii, renderizarSecaoAscii } from './cliHelpTexto.js';
+import { criarBriefingAgente, criarBriefingAgenteContratos, resumirDriftPorModulo } from "./index.part03.js";
+import { type ComandoConsultaDrift, type ModoCacheDrift, type ResolucaoModoCacheDrift } from "./driftCacheModes.js";
+export type Comando = "iniciar" | "init" | "dev" | "sync" | "author" | "profile" | "conteudo" | "interativo" | "descobrir" | "pipeline" | "capabilities" | "validar" | "ast" | "ir" | "compilar" | "gerar" | "testar" | "diagnosticos" | "verificar" | "inspecionar" | "drift" | "impacto" | "renomear-semantico" | "importar" | "doctor" | "formatar" | "ajuda-ia" | "starter-ia" | "sync-codex" | "skill" | "instalar-exemplos" | "rule-packs" | "docs-impacto" | "finalizar-mudanca" | "resumo" | "prompt-curto" | "prompt-ia" | "prompt-ia-ui" | "prompt-ia-react" | "prompt-ia-sema-primeiro" | "exemplos-prompt-ia" | "contexto-ia";
 export interface ResultadoFormatacaoArquivo {
     caminho: string;
     alterado: boolean;
@@ -74,11 +76,14 @@ export interface PacoteContextoModuloIa {
         comando: "drift";
         caminho: string;
         modulo: string | null;
-        sucesso: boolean;
-        resumo: ResumoModuloDrift;
-        drift: ResultadoDriftIa;
+        modo: ModoCacheDrift;
+        executada: boolean;
+        sucesso: boolean | null;
+        aviso: string | null;
+        resumo: ResumoModuloDrift | null;
+        drift: ResultadoDriftIa | null;
     };
-    briefing: ReturnType<typeof criarBriefingAgente>;
+    briefing: ReturnType<typeof criarBriefingAgente> | ReturnType<typeof criarBriefingAgenteContratos>;
 }
 export interface ResumoSemanticoModuloIa {
     geradoEm: string;
@@ -88,8 +93,8 @@ export interface ResumoSemanticoModuloIa {
     avisoVerificacaoCodigo: string | null;
     fontesConclusao: string[];
     perfilCompatibilidade: string;
-    scoreSemantico: number;
-    confiancaGeral: string;
+    scoreSemantico: number | null;
+    confiancaGeral: string | null;
     riscoOperacional: string;
     faz: string;
     tarefasPrincipais: string[];
@@ -108,22 +113,24 @@ export interface ResumoSemanticoModuloIa {
     checksSugeridos: string[];
     testesMinimos: string[];
     consumerFramework: string | null;
-    appRoutes: string[];
-    consumerSurfaces: string[];
-    consumerBridges: string[];
-    ancoragensVinculo: string[];
+    appRoutes: string[] | null;
+    consumerSurfaces: string[] | null;
+    consumerBridges: string[] | null;
+    ancoragensVinculo: string[] | null;
     arquivosProvaveisEditar: string[];
 }
 export declare const DIRETORIO_CLI_ATUAL: string;
 export declare const VERSAO_CLI: string;
+export { renderizarCaixaAscii, renderizarSecaoAscii };
 export declare function obterArgumentos(): {
     comando?: Comando;
     resto: string[];
 };
-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 resolverAnaliseDriftConsultaCli(args: string[], comando: ComandoConsultaDrift): ResolucaoModoCacheDrift & {
+    opcoes: OpcoesDriftLegado;
+};
 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

@@ -3,181 +3,36 @@ import { fileURLToPath } from "node:url";
 import pacoteCli from "../package.json" with { type: "json" };
 import { caminhoExiste } from './fsGovernado.js';
 import { obterOpcao, possuiFlag } from './cliArgs.js';
+import { criarAjudaRaiz, renderizarCaixaAscii, renderizarSecaoAscii } from './cliHelpTexto.js';
+import { resolverModoCacheComandoDrift, resolverModoCacheConsultaDrift, } from "./driftCacheModes.js";
 export const DIRETORIO_CLI_ATUAL = path.dirname(fileURLToPath(import.meta.url));
 export const VERSAO_CLI = pacoteCli.version;
+export { renderizarCaixaAscii, renderizarSecaoAscii };
 export function obterArgumentos() {
     const [, , comando, ...resto] = process.argv;
     return { comando: comando, resto };
 }
-export function renderizarCaixaAscii(linhas) {
-    const largura = Math.max(...linhas.map((linha) => linha.length), 12);
-    const borda = `+${"-".repeat(largura + 2)}+`;
-    return [
-        borda,
-        ...linhas.map((linha) => `| ${linha.padEnd(largura, " ")} |`),
-        borda,
-    ].join("\n");
-}
-export function renderizarSecaoAscii(titulo, linhas) {
-    return [
-        titulo,
-        ...linhas.map((linha) => `  ${linha}`),
-    ].join("\n");
-}
 export function ajuda() {
-    return [
-        renderizarCaixaAscii([
-            `Sema CLI v${VERSAO_CLI}`,
-            "IA-first para contrato, geração e adoção incremental",
-            "novo projeto, edição guiada e legado sem contrato inicial",
-        ]),
-        "",
-        renderizarSecaoAscii("Fluxos rápidos", [
-            "[1] Projeto novo / produção inicial",
-            "sema iniciar --template <base|nestjs|fastapi|nextjs-api|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer> [--force]",
-            "Arquivos existentes sao preservados; use --force somente para sobrescrita explicita.",
-            "sema validar contratos/<modulo>.sema --json",
-            "sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>",
-            "sema verificar <arquivo-ou-pasta> --json",
-            "",
-            "[2] Editar projeto que já usa Sema",
-            "sema inspecionar . --json",
-            "sema resumo <arquivo-ou-pasta> --micro --para mudanca",
-            "sema drift <arquivo-ou-pasta> --escopo modulo --json",
-            "sema impacto <arquivo-ou-pasta> --alvo <token> --mudanca <descricao> --json",
-            "sema docs-impacto --intencao \"fazer deploy\" --criar-ausentes --json",
-            "sema contexto-ia <arquivo.sema> --saida ./.tmp/contexto --json",
-            "",
-            "[3] Governar escrita autoral com Sema Author",
-            "sema author iniciar [--tema-sensivel] [--saida contratos/author.sema]",
-            "sema author validar contratos/author.sema --json",
-            "sema author briefing contratos/author.sema --json",
-            "sema author revisar-cliches contratos/author.sema --texto <texto> --json  # reprova se houver bloqueio",
-            "sema author validar-narrativa contratos/author.sema --texto <texto> --texto-anterior <texto> --json",
-            "sema author validar-proibicoes contratos/author.sema --texto <texto> --json",
-            "",
-            "[4] Validar profiles semânticos",
-            "sema profile validar workflow contratos/sema/workflow_ops.sema --maturidade production --preset webhook --artefato-arquivo workflow.md --json",
-            "sema profile validar ops contratos/sema/workflow_ops.sema --maturidade critical --preset deploy --artefato-arquivo runbook.md --json",
-            "sema profile validar game contratos/sema/game.sema --maturidade prototype --preset playtest --artefato-arquivo playtest.md --json",
-            "sema profile validar simulation contratos/sema/simulation.sema --maturidade production --preset calibration --artefato-arquivo calibration.md --json",
-            "sema profile validar redacao contratos/sema/redator.sema --maturidade production --preset seo --artefato-arquivo materia.md --json",
-            "sema profile validar propostas contratos/sema/propostas_comerciais.sema --maturidade production --preset score90 --artefato-arquivo proposta.md --json",
-            "sema profile validar conversas contratos/sema/conversas.sema --maturidade production --preset vendas --artefato-arquivo conversa.md --json",
-            "sema profile capabilities --json",
-            "sema rule-packs --profile legal --json",
-            "",
-            "[5] Descobrir a capacidade ou pipeline certo",
-            "sema descobrir catalogo --json",
-            "sema descobrir recomendar --intencao \"validar simulador 3D autonomo calibrado\" --json",
-            "sema descobrir explicar simulation.calibrate --json",
-            "sema pipeline listar --json",
-            "sema capabilities --json",
-            "",
-            "[6] Modelar jogos e simulações em qualquer combinação espacial, visual e de render",
-            "sema interativo capabilities --json",
-            "sema interativo schema --json",
-            "sema interativo pipelines --json",
-            "sema interativo adapters --spatial-model THREE_D --render-mode VISUAL --json",
-            "sema interativo validar <definition.json> --json",
-            "sema interativo planejar <definition.json> --json",
-            "sema interativo validar-evidencias <definition.json> [--plano-arquivo <plan.json>] --bundle-arquivo <bundle.json> --json",
-            "sema interativo validar-protocolo <adapter-run.json> --json",
-            "sema interativo validar-ir <experience-ir.json> --json",
-            "sema interativo consultar-ir <experience-ir.json> --semantic-id <id> --json",
-            "sema interativo validar-engine-snapshot <snapshot.json> --json",
-            "sema interativo validar-temporal <temporal.json> --json",
-            "sema interativo validar-autonomia <cycle.json> --json",
-            "sema interativo validar-playtest-fuzz <plan.json> --json",
-            "sema interativo validar-multiplayer <model.json> --json",
-            "sema interativo analisar-portabilidade <plan.json> --json",
-            "sema interativo validar-workers <plan.json> --json",
-            "",
-            "[7] Orquestrar criação de conteúdo por IA",
-            "sema conteudo capabilities --json",
-            "sema conteudo validar <definition.json> --json",
-            "sema conteudo planejar <definition.json> --alvos-arquivo <targets.json> --json",
-            "sema conteudo registrar <ledger.ndjson> --envelope-arquivo <envelope.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-id <id> --expected-head <sha256:...> --json",
-            "sema conteudo status <definition.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-arquivo <ledger.ndjson> --expected-head <sha256:...> --json",
-            "",
-            "[8] Adotar Sema em projeto que ainda não usa",
-            "sema importar <fonte> <diretorio> --saida <diretorio> --json",
-            "sema formatar <arquivo-ou-pasta>",
-            "sema validar <arquivo-ou-pasta> --json",
-            "sema drift <arquivo-ou-pasta> --escopo modulo --json",
-        ]),
-        "",
-        renderizarSecaoAscii("IA por capacidade", [
-            "fraca: sema resumo <arquivo> --micro --json (stdout compacto)",
-            "média: sema resumo <arquivo> --curto --json + sema drift <arquivo> --json",
-            "forte: sema contexto-ia <arquivo.sema> --saida <diretorio> --json",
-        ]),
-        "",
-        renderizarSecaoAscii("Comandos principais", [
-            "descoberta: sema inspecionar [arquivo-ou-pasta] [--json]",
-            "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]",
-            "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]",
-            "validação: sema validar <arquivo-ou-pasta> [--json]",
-            "diagnóstico: sema diagnosticos <arquivo.sema> [--json]",
-            "geração: sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio> [--estrutura <flat|modulos|backend>] [--framework <base|nestjs|fastapi>]",
-            "teste local: sema testar <arquivo.sema> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio-temporario> [--estrutura <flat|modulos|backend>] [--framework <base|nestjs|fastapi>]",
-            "aliases nativos: cs|csharp -> dotnet; c++|cxx|cc -> cpp (CLI e sema.config.json)",
-            "verificação final: sema verificar <arquivo-ou-pasta> [--saida <diretorio-base>] [--json]",
-            "formatação: sema formatar <arquivo-ou-pasta> [--check] [--json]",
-            "author: sema author <iniciar|validar|briefing|revisar-cliches|validar-narrativa|validar-proibicoes> [arquivo] [--tema-sensivel] [--preset conto|romance|roteiro|lore|campanha] [--saida <arquivo>] [--texto <texto>] [--json]",
-            "profile: sema profile validar <software|workflow|ops|game|simulation|legal|research|redacao|propostas|conversas> <arquivo-ou-pasta> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
-            "capabilities: sema profile capabilities [--json]",
-            "conteúdo: sema conteudo <capabilities|validar|planejar|validar-envelope|registrar|status|projetar> [--trust-root-digest <sha256:...>] [--revocation-digest <sha256:...>] [--expected-head <sha256:...>] [opções] [--json]",
-            "interativo: sema interativo <capabilities|schema|pipelines|adapters|validar|planejar|validar-evidencias|status|validar-protocolo|extensões-P0-P2> [opções] [--json]",
-            "rule packs: sema rule-packs [--profile <author|software|workflow|ops|game|simulation|legal|research|redacao|propostas|conversas>] [--json]",
-        ]),
-        "",
-        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 prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--json]",
-            "sema prompt-ia",
-            "sema prompt-ia-ui",
-            "sema prompt-ia-react",
-            "sema prompt-ia-sema-primeiro",
-            "sema exemplos-prompt-ia",
-            "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--json]",
-            "sema sync-codex [--json]",
-            "sema instalar-exemplos [--json]",
-            "sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--json]",
-            "sema finalizar-mudanca --intencao <acao> [--arquivo <caminho>] [--doc-lida <caminho>] [--json]",
-            "sema author briefing <arquivo.sema> [--json]",
-            "sema author revisar-cliches <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--texto-anterior <texto>|--texto-anterior-arquivo <arquivo>] [--json]",
-            "sema author validar-narrativa <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--json]",
-            "sema author validar-proibicoes <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--json]",
-            "sema profile validar <profile> <arquivo.sema> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
-            "sema profile capabilities [--json]",
-            "sema descobrir <catalogo|recomendar|explicar> [id] [--intencao <objetivo>] [--json]",
-            "sema pipeline <listar|descrever> [id] [--json]",
-            "sema capabilities [--json]",
-            "sema interativo <capabilities|schema|pipelines|adapters|validar|planejar|validar-evidencias|status|validar-protocolo|extensões-P0-P2> [opções] [--json]",
-            "sema conteudo <capabilities|validar|planejar|validar-envelope|registrar|status|projetar> [--trust-root-digest <sha256:...>] [--revocation-digest <sha256:...>] [--expected-head <sha256:...>] [opções] [--json]",
-            "sema rule-packs [--profile <profile>] [--json]",
-        ]),
-        "",
-        renderizarSecaoAscii("Operacional", [
-            "sema doctor",
-            "sema --versao | --version | -v",
-        ]),
-    ].join("\n");
+    return criarAjudaRaiz(VERSAO_CLI);
 }
-export function resolverOpcoesDriftCli(args) {
+function criarOpcoesDriftCli(args, resolucao) {
     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"),
+        modoCache: resolucao.modo,
+        avisosModoCache: resolucao.avisos,
+    };
+}
+export function resolverOpcoesDriftCli(args) {
+    return criarOpcoesDriftCli(args, resolverModoCacheComandoDrift(args));
+}
+export function resolverAnaliseDriftConsultaCli(args, comando) {
+    const resolucao = resolverModoCacheConsultaDrift(args, comando);
+    return {
+        ...resolucao,
+        opcoes: criarOpcoesDriftCli(args, resolucao),
     };
 }
 export function normalizarTamanhoResumo(args) {
@@ -251,9 +106,9 @@ export function renderizarCabecalhoDocsIa(descoberta) {
         "Modo IA-first da instalacao atual",
         "- Use `sema` como interface publica principal.",
         "- A Sema entra em projeto novo, projeto ja semantizado e adocao incremental em legado sem contrato inicial.",
-        "- Nao assuma monorepo, `node pacotes/cli/dist/index.js`, `npm run project:check` ou uma pasta `exemplos` externa ao projeto atual.",
-        "- Se a IA tiver contexto curto, comece por `sema resumo` e `sema prompt-curto`.",
-        "- Se a IA aguentar mais contexto, suba para `sema drift --json` e `sema contexto-ia`.",
+        "- Nao assuma monorepo, `node pacotes/cli/dist/bin.js`, `npm run project:check` ou uma pasta `exemplos` externa ao projeto atual.",
+        "- Se a IA tiver contexto curto, comece por `sema resumo --drift none` e `sema prompt-curto`; implementação e score ficam não avaliados.",
+        "- Se a IA aguentar mais contexto e precisar de evidência viva, suba para `sema drift --cache fresh --json` e `sema contexto-ia`.",
         "- So leia `ast.json` e `ir.json` completos quando a capacidade da IA realmente aguentar esse volume.",
     ];
     if (documentos.length > 0) {