@semacode/cli 2.3.1 → 3.5.0

package/dist/importador.part01.d.ts

@@ -1,6 +1,6 @@
 import ts from "typescript";
 import { type Diagnostico } from "@sema/nucleo";
-export type FonteImportacao = "nestjs" | "fastapi" | "flask" | "nextjs" | "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer" | "firebase" | "typescript" | "python" | "dart" | "dotnet" | "java" | "go" | "rust" | "cpp" | "php";
+export type FonteImportacao = "nestjs" | "express" | "fastify" | "fastapi" | "flask" | "nextjs" | "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer" | "firebase" | "typescript" | "python" | "dart" | "dotnet" | "java" | "go" | "rust" | "cpp" | "php";
 export type OrigemInteropImportada = "ts" | "py" | "dart" | "cs" | "java" | "go" | "rust" | "cpp" | "php";
 export interface CampoImportado {
     nome: string;

package/dist/importador.part06.d.ts

@@ -1,6 +1,8 @@
 import { extrairRotasTypeScriptHttp } from "./typescript-http.js";
 import { CampoImportado, ModuloImportado, TipoDescoberto } from "./importador.part01.js";
 export declare function importarNestJsDeArquivo(diretorioBase: string, arquivo: string, namespaceBase: string, tiposGlobais: Map<string, TipoDescoberto>): ModuloImportado[];
+export declare function importarExpressFastifyDeArquivo(diretorioBase: string, arquivo: string, namespaceBase: string, origemDesejada: "express" | "fastify"): ModuloImportado[];
+export declare function importarExpressFastifyBase(diretorio: string, namespaceBase: string, origem: "express" | "fastify"): Promise<ModuloImportado[]>;
 export declare function importarTypeScriptBase(diretorio: string, namespaceBase: string, modoNestjs?: boolean): Promise<ModuloImportado[]>;
 export declare function nomeTaskParaRotaTypeScript(caminho: string, metodo: string): string;
 export declare function camposDeParametrosRotaTypeScript(parametros: ReturnType<typeof extrairRotasTypeScriptHttp>[number]["parametros"]): CampoImportado[];

package/dist/importador.part06.js

@@ -3,7 +3,7 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import ts from "typescript";
-import { extrairRotasTypeScriptHttp, inferirSemanticaHandlerTypeScriptHttp, localizarExportacaoTypeScriptHttp, } from "./typescript-http.js";
+import { extrairRotasExpressFastify, extrairRotasTypeScriptHttp, inferirSemanticaHandlerTypeScriptHttp, localizarExportacaoTypeScriptHttp, } from "./typescript-http.js";
 import { extrairTextoLiteral, inferirContextoPorArquivo, juntarCaminhoHttp, lerDecorator, listarArquivosRecursivos, mapearTipoPrimitivo, paraSnakeCase } from "./importador.part01.js";
 import { deduplicarCampos, extrairChamadaServiceTs } from "./importador.part04.js";
 import { caminhoImplTs, camposDeSemanticaTypeScriptHttp, criarEntidadesReferenciadas, descreverEfeitosPorHeuristica, expandirCamposTs, extrairErrosTs } from "./importador.part02.js";
@@ -98,6 +98,92 @@ export function importarNestJsDeArquivo(diretorioBase, arquivo, namespaceBase, t
             routes: deduplicarRotas(routes),
         }];
 }
+function nomearTarefaRotaChamada(metodo, caminho) {
+    const ultimoSegmento = caminho.replace(/\{[^}]+\}/g, "").split("/").filter(Boolean).pop() ?? "recurso";
+    const singular = ultimoSegmento.length > 3 && /es$/.test(ultimoSegmento)
+        ? ultimoSegmento.replace(/es$/, "")
+        : ultimoSegmento.replace(/s$/, "");
+    switch (metodo) {
+        case "POST":
+            return `criar_${singular}`;
+        case "PUT":
+        case "PATCH":
+            return `atualizar_${singular}`;
+        case "DELETE":
+            return `remover_${singular}`;
+        case "GET":
+            return caminho.includes("{") ? `obter_${singular}` : `listar_${ultimoSegmento}`;
+        default:
+            return `${metodo.toLowerCase()}_${ultimoSegmento}`;
+    }
+}
+export function importarExpressFastifyDeArquivo(diretorioBase, arquivo, namespaceBase, origemDesejada) {
+    const relacao = path.relative(diretorioBase, arquivo);
+    const codigo = ts.sys.readFile(arquivo, "utf8") ?? "";
+    const sourceFile = ts.createSourceFile(arquivo, codigo, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const contextoSegmentos = inferirContextoPorArquivo(relacao);
+    const nomeModulo = [namespaceBase, ...contextoSegmentos].join(".");
+    const rotasArquivo = extrairRotasExpressFastify(sourceFile).filter((rota) => rota.origem === origemDesejada);
+    if (rotasArquivo.length === 0) {
+        return [];
+    }
+    const tasks = [];
+    const routes = [];
+    for (const rota of rotasArquivo) {
+        const taskNome = nomearTarefaRotaChamada(rota.metodo, rota.caminho);
+        const implSimbolo = /^[A-Za-z_]\w*$/.test(rota.simbolo) ? rota.simbolo : undefined;
+        tasks.push({
+            nome: taskNome,
+            resumo: `Task importada automaticamente da rota ${rota.metodo} ${rota.caminho} em ${relacao}.`,
+            input: rota.parametros.map((parametro) => ({
+                nome: parametro.nome,
+                tipo: parametro.tipoSema,
+                obrigatorio: true,
+            })),
+            output: [],
+            errors: [],
+            effects: [],
+            impl: implSimbolo ? { ts: caminhoImplTs(diretorioBase, arquivo, implSimbolo) } : undefined,
+            origemArquivo: relacao,
+            origemSimbolo: rota.simbolo,
+        });
+        routes.push({
+            nome: `${taskNome}_publico`,
+            resumo: `Rota ${origemDesejada} importada automaticamente de ${relacao}.`,
+            metodo: rota.metodo,
+            caminho: rota.caminho,
+            task: taskNome,
+            input: rota.parametros.map((parametro) => ({
+                nome: parametro.nome,
+                tipo: parametro.tipoSema,
+                obrigatorio: true,
+            })),
+            output: [],
+            errors: [],
+        });
+    }
+    const { entities, enums } = criarEntidadesReferenciadas(new Map(), new Set(), new Set());
+    sincronizarRotasComTasks(routes, tasks);
+    return [{
+            nome: nomeModulo,
+            resumo: `Rascunho Sema importado de um contexto ${origemDesejada === "express" ? "Express" : "Fastify"} legado em ${contextoSegmentos.join("/")}.`,
+            entities,
+            enums,
+            tasks: deduplicarTarefas(tasks),
+            routes: deduplicarRotas(routes),
+        }];
+}
+export async function importarExpressFastifyBase(diretorio, namespaceBase, origem) {
+    const arquivos = await listarArquivosRecursivos(diretorio, [".ts"]);
+    const uteis = arquivos.filter((arquivo) => !arquivo.endsWith(".spec.ts")
+        && !arquivo.endsWith(".test.ts")
+        && !arquivo.endsWith(".d.ts"));
+    const modulos = [];
+    for (const arquivo of uteis) {
+        modulos.push(...importarExpressFastifyDeArquivo(diretorio, arquivo, namespaceBase, origem));
+    }
+    return modulos;
+}
 export async function importarTypeScriptBase(diretorio, namespaceBase, modoNestjs = false) {
     const arquivos = await listarArquivosRecursivos(diretorio, [".ts"]);
     const uteis = arquivos.filter((arquivo) => !arquivo.endsWith(".spec.ts")

package/dist/importador.part09.js

@@ -12,7 +12,7 @@ import { inferirContextoPorArquivo, inferirNamespaceBase, listarArquivosRecursiv
 import { camposDeParametrosRotaBackend, criarCampoResultadoBackend, descreverEfeitosPorHeuristica, inferirDatabasesPorHeuristica, mapearTipoBackendParaSema } from "./importador.part02.js";
 import { caminhoImplGenerico, importarFirebaseBase } from "./importador.part07.js";
 import { acumularModuloImportado, criarModuloImportadoSimples, importarDartBase, importarDotnetBase, importarPythonBase, resolverArquivoRustParaSimbolo, selecionarSimbolosPreferidos } from "./importador.part08.js";
-import { importarNextJsBase, importarTypeScriptBase } from "./importador.part06.js";
+import { importarExpressFastifyBase, importarNextJsBase, importarTypeScriptBase } from "./importador.part06.js";
 import { importarAngularConsumerBase, importarFlutterConsumerBase, importarNextJsConsumerBase, importarReactViteConsumerBase } from "./importador.part04.js";
 import { formatarModuloImportado, moduloParaCodigo, montarArquivoImportado } from "./importador.part05.js";
 export async function importarJavaBase(diretorio, namespaceBase) {
@@ -300,6 +300,12 @@ export async function importarProjetoLegado(fonte, diretorio, namespaceBase) {
     if (fonte === "nestjs") {
         modulos = await importarTypeScriptBase(base, namespace, true);
     }
+    else if (fonte === "express") {
+        modulos = await importarExpressFastifyBase(base, namespace, "express");
+    }
+    else if (fonte === "fastify") {
+        modulos = await importarExpressFastifyBase(base, namespace, "fastify");
+    }
     else if (fonte === "nextjs") {
         modulos = await importarNextJsBase(base, namespace);
     }

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,9 +1,10 @@
 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";
-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;
@@ -30,8 +31,6 @@ 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 {
@@ -77,16 +76,14 @@ export interface PacoteContextoModuloIa {
         comando: "drift";
         caminho: string;
         modulo: string | null;
-        sucesso: boolean;
-        modoAnalise?: ModoAnaliseDriftCli;
-        executado?: boolean;
-        aviso?: string | null;
-        resumo: ResumoModuloDrift;
-        drift: ResultadoDriftIa;
+        modo: ModoCacheDrift;
+        executada: boolean;
+        sucesso: boolean | null;
+        aviso: string | null;
+        resumo: ResumoModuloDrift | null;
+        drift: ResultadoDriftIa | null;
     };
-    briefing: ReturnType<typeof criarBriefingAgente>;
-    modoVerificacaoCodigo?: ResumoSemanticoModuloIa["modoVerificacaoCodigo"];
-    fontesConclusao?: string[];
+    briefing: ReturnType<typeof criarBriefingAgente> | ReturnType<typeof criarBriefingAgenteContratos>;
 }
 export interface ResumoSemanticoModuloIa {
     geradoEm: string;
@@ -96,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[];
@@ -116,29 +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 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;
+export declare function resolverOpcoesDriftCli(args: string[]): OpcoesDriftLegado;
+export declare function resolverAnaliseDriftConsultaCli(args: string[], comando: ComandoConsultaDrift): ResolucaoModoCacheDrift & {
     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

@@ -3,257 +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] [--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>] [--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]",
-            "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>] [--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",
-            "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");
-}
-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.");
+    return criarAjudaRaiz(VERSAO_CLI);
 }
-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) {
+function criarOpcoesDriftCli(args, resolucao) {
     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 } : {}),
+        modoCache: resolucao.modo,
+        avisosModoCache: resolucao.avisos,
     };
 }
-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 resolverOpcoesDriftCli(args) {
+    return criarOpcoesDriftCli(args, resolverModoCacheComandoDrift(args));
 }
-export function criarResultadoDriftNaoExecutado(contextoProjeto, opcoes) {
-    const escopo = opcoes?.escopo === "arquivo" || opcoes?.escopo === "projeto" ? opcoes.escopo : "modulo";
+export function resolverAnaliseDriftConsultaCli(args, comando) {
+    const resolucao = resolverModoCacheConsultaDrift(args, comando);
     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: [],
+        ...resolucao,
+        opcoes: criarOpcoesDriftCli(args, resolucao),
     };
 }
 export function normalizarTamanhoResumo(args) {
@@ -327,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) {