@semacode/cli 3.0.0 → 3.5.0

package/dist/drift.part09.js

@@ -80,13 +80,14 @@ export function normalizarCaminhoRota(caminho) {
     if (!caminho) {
         return "/";
     }
-    const limpo = normalizarCaminhoFlask(caminho.trim().replace(/\s*\/\s*/g, "/"));
+    const limpo = normalizarCaminhoFlask(caminho.trim().replace(/\s*\/\s*/g, "/"))
+        .replace(/:([A-Za-z_]\w*)/g, "{$1}");
     const comBarra = limpo.startsWith("/") ? limpo : `/${limpo}`;
     const normalizado = comBarra.replace(/\/+/g, "/");
     return normalizado.endsWith("/") && normalizado !== "/" ? normalizado.slice(0, -1) : normalizado;
 }
 export function extrairFontesHttpTypeScript(fontesLegado) {
-    return fontesLegado.filter((fonte) => fonte === "nestjs" || fonte === "nextjs" || fonte === "firebase");
+    return fontesLegado.filter((fonte) => fonte === "nestjs" || fonte === "nextjs" || fonte === "firebase" || fonte === "express" || fonte === "fastify");
 }
 export function extrairFontesHttpBackend(fontesLegado) {
     return fontesLegado.filter((fonte) => fonte === "dotnet" || fonte === "java" || fonte === "go" || fonte === "rust" || fonte === "php");
@@ -227,13 +228,19 @@ export function escolherRotasEsperadas(task, fontesLegado) {
         if (fontesTs.includes("firebase") && /(apps\.worker|worker|sema_contract_bridge|health)/i.test(implTsOuJs.caminho)) {
             esperadas.add("firebase");
         }
+        if (/\bexpress\b|\broutes?\b|\brouter\b/i.test(implTsOuJs.caminho) && fontesTs.includes("express")) {
+            esperadas.add("express");
+        }
+        if (/\bfastify\b/i.test(implTsOuJs.caminho) && fontesTs.includes("fastify")) {
+            esperadas.add("fastify");
+        }
         if (esperadas.size > 0) {
             return [...esperadas];
         }
         if (fontesTs.length > 0) {
             return fontesTs;
         }
-        return ["nestjs", "nextjs", "firebase"];
+        return ["nestjs", "nextjs", "firebase", "express", "fastify"];
     }
     if (task.implementacoesExternas.some((impl) => impl.origem === "py")) {
         const fontesPython = fontesLegado.filter((fonte) => fonte === "fastapi" || fonte === "flask");

package/dist/drift.part11.js

@@ -1,11 +1,12 @@
 // SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.governanca_ia.drift.cache.store
 // Descrição: integra índices calculados ou reutilizados e sempre recalcula o resultado final do drift.
 import path from "node:path";
+import { resolverAlvoPadrao, resolverEstruturaSaidaPadrao, resolverFrameworkPadrao } from "./projeto.js";
 import { emitirDiagnosticosArquivosOrcamento, workspaceExigeCabecalhoCodigoGovernado, } from "./driftOrcamento.js";
 import { definirDiretoriosIgnoradosAtivos, obterDiretoriosIgnoradosAtivos, extrairTermosEscopoDrift, resolverDiretoriosIgnoradosAtivos, resolverOpcoesDrift } from "./drift.part01.js";
 import { construirContextoRelevanciaConsumer, filtrarConsumerSurfacesPorEscopo } from "./drift.part02.js";
 import { inferirConsumerFrameworkPrincipal } from "./drift.part06.js";
-import { calcularConfiancaTask, calcularRiscoOperacional, calcularScoreTask, chaveCaminhoCanonicoDrift, encontrarCandidatosFisicosImplementacaoDrift, resumirLacunasTask, resumirOperacional } from "./drift.part04.js";
+import { calcularConfiancaTask, calcularRiscoOperacional, calcularScoreTask, carregarEvidenciaVerificacaoDrift, chaveCaminhoCanonicoDrift, encontrarCandidatosFisicosImplementacaoDrift, resumirLacunasTask, resumirOperacional } from "./drift.part04.js";
 import { analisarPersistenciaReal, ordenarCandidatos } from "./drift.part09.js";
 import { simboloEhBridgeConsumer } from "./drift.part05.js";
 import { prepararIndicesDrift } from "./drift.part13.js";
@@ -275,6 +276,24 @@ export async function analisarDriftLegado(contexto, opcoes) {
             bloqueiosAnalise.add("escopo_estreito_ambiguo");
         }
         configuracaoEscopo.bloqueios = [...bloqueiosAnalise];
+        const evidenciaPorModulo = new Map();
+        for (const item of contexto.modulosSelecionados) {
+            const nomeModulo = item.resultado.ir?.nome;
+            if (!nomeModulo) {
+                continue;
+            }
+            const frameworkVerificacao = resolverFrameworkPadrao(undefined, contexto.configCarregada);
+            const evidencia = await carregarEvidenciaVerificacaoDrift({
+                caminhoContrato: item.caminho,
+                nomeModulo,
+                alvo: resolverAlvoPadrao(undefined, contexto.configCarregada),
+                framework: frameworkVerificacao,
+                estrutura: resolverEstruturaSaidaPadrao(undefined, frameworkVerificacao, contexto.configCarregada),
+            });
+            if (evidencia) {
+                evidenciaPorModulo.set(nomeModulo, evidencia);
+            }
+        }
         for (const resumo of tasksResumo) {
             const chaveTask = `${resumo.modulo}:${resumo.task}`;
             const task = taskPorChave.get(chaveTask);
@@ -304,8 +323,10 @@ export async function analisarDriftLegado(contexto, opcoes) {
             }
             resumo.confiancaVinculo = calcularConfiancaTask(task, resumo.implsValidos, resumo.implsQuebrados, resumoVinculos.validos, resumoVinculos.quebrados);
             resumo.riscoOperacional = calcularRiscoOperacional(task);
-            resumo.lacunas = resumirLacunasTask(task, resumo.semImplementacao, resumo.implsQuebrados, resumoVinculos.quebrados, guardrails);
-            resumo.scoreSemantico = calcularScoreTask(task, resumo.implsValidos, resumo.implsQuebrados, resumoVinculos.validos, resumoVinculos.quebrados, resumo.semImplementacao);
+            const evidenciaVerificada = evidenciaPorModulo.get(resumo.modulo);
+            resumo.lacunas = resumirLacunasTask(task, resumo.semImplementacao, resumo.implsQuebrados, resumoVinculos.quebrados, guardrails, evidenciaVerificada);
+            resumo.scoreSemantico = calcularScoreTask(task, resumo.implsValidos, resumo.implsQuebrados, resumoVinculos.validos, resumoVinculos.quebrados, resumo.semImplementacao, evidenciaVerificada);
+            resumo.evidenciaVerificacao = evidenciaVerificada;
             resumo.ancoragemVinculo = task.vinculos.length > 0
                 ? "propria"
                 : arquivosAncoraHerdados.length > 0

package/dist/drift.part14.js

@@ -286,6 +286,7 @@ export function analisarModulosSelecionadosDrift(estado) {
                     route: route.nome,
                     metodo: route.metodo,
                     caminho: route.caminho,
+                    frameworksEsperados: [...esperadas],
                     motivo: `Nenhuma rota publica ${route.metodo} ${route.caminho} foi encontrada no codigo legado para o framework esperado.`,
                 };
                 rotasDivergentes.push(registro);
@@ -293,6 +294,7 @@ export function analisarModulosSelecionadosDrift(estado) {
                     tipo: "rota_divergente",
                     modulo: ir.nome,
                     route: route.nome,
+                    frameworksEsperados: [...esperadas],
                     mensagem: registro.motivo,
                 });
             }

package/dist/exemplosOficiais.d.ts

@@ -17,4 +17,5 @@ export interface PlanoExemplosOficiais {
 }
 export declare function localizarDiretorioExemplosOficiais(): Promise<string | undefined>;
 export declare function planejarExemplosOficiais(): Promise<PlanoExemplosOficiais>;
-export declare function materializarExemplosOficiais(baseProjeto?: string, preservarExistentes?: boolean): Promise<ResultadoMaterializacaoExemplos>;
+export declare function normalizarCaminhoExemplo(caminho: string): string;
+export declare function materializarExemplosOficiais(baseProjeto?: string, preservarExistentes?: boolean, somenteCaminhos?: ReadonlySet<string>): Promise<ResultadoMaterializacaoExemplos>;

package/dist/exemplosOficiais.js

@@ -56,7 +56,10 @@ export async function planejarExemplosOficiais() {
         arquivos,
     };
 }
-export async function materializarExemplosOficiais(baseProjeto = process.cwd(), preservarExistentes = true) {
+export function normalizarCaminhoExemplo(caminho) {
+    return caminho.replace(/\\/g, "/");
+}
+export async function materializarExemplosOficiais(baseProjeto = process.cwd(), preservarExistentes = true, somenteCaminhos) {
     const plano = await planejarExemplosOficiais();
     const origem = plano.origem;
     const destino = path.resolve(baseProjeto, "exemplos");
@@ -71,10 +74,13 @@ export async function materializarExemplosOficiais(baseProjeto = process.cwd(),
             erro: "Diretorio de exemplos oficiais nao foi encontrado no pacote da CLI.",
         };
     }
+    const arquivosSelecionados = somenteCaminhos
+        ? plano.arquivos.filter((arquivo) => somenteCaminhos.has(normalizarCaminhoExemplo(arquivo.caminhoRelativo)))
+        : plano.arquivos;
     const criados = [];
     const preservados = [];
-    await validarDestinosEscritaWorkspace(baseProjeto, plano.arquivos.map((arquivo) => arquivo.caminhoRelativo));
-    for (const arquivo of plano.arquivos) {
+    await validarDestinosEscritaWorkspace(baseProjeto, arquivosSelecionados.map((arquivo) => arquivo.caminhoRelativo));
+    for (const arquivo of arquivosSelecionados) {
         const resultado = await escreverArquivoWorkspaceSeguro(baseProjeto, arquivo.caminhoRelativo, await readFile(arquivo.origemArquivo, "utf8"), { sobrescrever: !preservarExistentes });
         if (resultado.status === "preservado") {
             preservados.push(arquivo.nome);

package/dist/geracaoCore.d.ts

@@ -17,6 +17,7 @@ export interface ResumoAlvoVerificacao {
     framework: FrameworkGeracao;
     estrutura: EstruturaSaida;
     testesExecutados: boolean;
+    origem?: "executado" | "cache";
 }
 export interface ResumoModuloVerificacao {
     modulo: string;

package/dist/geracaoCore.js

@@ -85,6 +85,8 @@ export function normalizarFonteImportacao(valor) {
         return "php";
     }
     if (valor === "nestjs"
+        || valor === "express"
+        || valor === "fastify"
         || valor === "fastapi"
         || valor === "flask"
         || valor === "nextjs"

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.part04.js

@@ -5,7 +5,7 @@ import path from "node:path";
 import { formatarDiagnosticos, gerarRespostaValidacao, temErros, } from "@sema/nucleo";
 import { carregarProjeto, } from "./projeto.js";
 import { analisarDriftLegado, } from "./drift.js";
-import { resolverDocumentacaoObrigatoria, verificarDocumentacaoMudanca, } from "./docs.js";
+import { compactarDocumentoObrigatorio, resolverDocumentacaoObrigatoria, verificarDocumentacaoMudanca, } from "./docs.js";
 import { LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO, LIMITE_AVISO_LINHAS_CONTRATO_SEMA, LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO, LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA, } from "./driftOrcamento.js";
 import { ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, } from './agentContextTipos.js';
 import { criarGuiaCapacidadeIa, LIMITE_CARACTERES_PAYLOAD_INLINE } from './agentContextPack.js';
@@ -319,7 +319,7 @@ Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-co
 
 - 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 --drift none\`.
+- Se o projeto inteiro for lento, escopar para \`sema resumo "${contexto.arquivo}" --micro --para mudanca --drift none\`.
 - Se o ambiente impedir continuar, pare bloqueado e não avance com código sem Sema.
 
 ## Fechamento
@@ -327,13 +327,13 @@ Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-co
 1. Editar o arquivo \`.sema\`.
 2. Rodar \`sema formatar "${contexto.arquivo}"\`.
 3. Rodar \`sema validar "${contexto.arquivo}" --json\`.
-4. Rodar \`sema drift "${contexto.arquivo}" --cache fresh --json\`.
+4. Rodar \`sema drift "${contexto.arquivo}" --cache fresh --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 --drift none\`
+- \`sema resumo "${contexto.arquivo}" --micro --para onboarding --drift none\`
 - \`sema prompt-curto "${contexto.arquivo}" --para mudanca\`
 - \`sema prompt-ia\`
 `;
@@ -372,7 +372,7 @@ export function resolverEntradaDocs(posicionais, args) {
 export async function comandoDocsImpacto(posicionais, args, emJson) {
     const { intencao, arquivosAlvo } = resolverEntradaDocs(posicionais, args);
     if (!intencao.trim()) {
-        console.error("Uso: sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--json]");
+        console.error("Uso: sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--completo] [--json]");
         return 1;
     }
     const resultado = await resolverDocumentacaoObrigatoria({
@@ -381,9 +381,16 @@ export async function comandoDocsImpacto(posicionais, args, emJson) {
         arquivosAlvo,
         criarAusentes: possuiFlag(args, "--criar-ausentes"),
     });
+    const completo = possuiFlag(args, "--completo");
     const payload = {
         comando: "docs-impacto",
-        ...resultado,
+        ...(completo ? resultado : {
+            ...resultado,
+            leituraObrigatoria: resultado.leituraObrigatoria.map(compactarDocumentoObrigatorio),
+            docsAusentes: resultado.docsAusentes.map(compactarDocumentoObrigatorio),
+            docsCriadas: resultado.docsCriadas.map(compactarDocumentoObrigatorio),
+            modoDocumentos: "compacto",
+        }),
     };
     if (emJson) {
         console.log(JSON.stringify(payload, null, 2));

package/dist/index.part07.d.ts

@@ -1,9 +1,15 @@
 import { type AlvoGeracao, type FrameworkGeracao } from "@sema/padroes";
 import type { EstruturaSaida } from "./tipos.js";
+export interface OpcoesVerificar {
+    alvo?: string;
+    semCache?: boolean;
+}
+export declare function alvosSuportadosPelaStack(fontesLegado: string[] | undefined): AlvoGeracao[] | undefined;
+export declare function avisoEscopoStackVerificacao(fontesLegado: string[] | undefined, alvosEfetivos: AlvoGeracao[]): string | undefined;
 import { type ResumoModuloVerificacao } from './geracaoCore.js';
 export declare function comandoPromptCurto(entrada: string | undefined, args: string[], emJson: boolean): Promise<number>;
 export declare function comandoContextoIa(arquivo: string, pastaSaida: string | undefined, emJson: boolean): Promise<number>;
 export declare function comandoTestar(arquivo: string, alvo: AlvoGeracao, saida: string, estrutura: EstruturaSaida, framework: FrameworkGeracao): Promise<number>;
 export declare function imprimirResumoVerificacao(resumos: ResumoModuloVerificacao[]): void;
-export declare function comandoVerificar(entrada: string | undefined, baseSaida: string, cwd?: string): Promise<number>;
-export declare function comandoVerificarJson(entrada: string | undefined, baseSaida: string, cwd?: string): Promise<number>;
+export declare function comandoVerificar(entrada: string | undefined, baseSaida: string, cwd?: string, opcoes?: OpcoesVerificar): Promise<number>;
+export declare function comandoVerificarJson(entrada: string | undefined, baseSaida: string, cwd?: string, opcoes?: OpcoesVerificar): Promise<number>;

package/dist/index.part07.js

@@ -2,8 +2,55 @@
 // Descrição: preserva modos explícitos nas superfícies auxiliares de contexto.
 import { readFile } from "node:fs/promises";
 import path from "node:path";
+import pacoteCli from "../package.json" with { type: "json" };
 import { compilarCodigo, formatarDiagnosticos, lerArquivoTexto, temErros, } from "@sema/nucleo";
 import { carregarProjeto, resolverAlvosVerificacao, } from "./projeto.js";
+import { SCHEMA_CACHE_VERIFICACAO, calcularChaveVerificacao, carregarCacheVerificacao, gravarCacheVerificacao, } from "./verificacaoCache.js";
+const FONTES_POR_ALVO_SUPORTADO = {
+    typescript: ["typescript", "javascript"],
+    javascript: ["typescript", "javascript"],
+    nestjs: ["typescript", "javascript"],
+    express: ["typescript", "javascript"],
+    fastify: ["typescript", "javascript"],
+    nextjs: ["typescript", "javascript"],
+    "nextjs-consumer": ["typescript", "javascript"],
+    "react-vite-consumer": ["typescript", "javascript"],
+    "angular-consumer": ["typescript", "javascript"],
+    firebase: ["typescript", "javascript"],
+    python: ["python"],
+    fastapi: ["python"],
+    flask: ["python"],
+    dart: ["dart"],
+    "flutter-consumer": ["dart"],
+    dotnet: ["dotnet"],
+    java: ["javascript"],
+    lua: ["lua"],
+    php: ["php"],
+    cpp: ["cpp"],
+};
+export function alvosSuportadosPelaStack(fontesLegado) {
+    if (!fontesLegado?.length) {
+        return undefined;
+    }
+    const suportados = new Set();
+    for (const fonte of fontesLegado) {
+        for (const alvo of FONTES_POR_ALVO_SUPORTADO[fonte] ?? []) {
+            suportados.add(alvo);
+        }
+    }
+    return suportados.size > 0 ? [...suportados] : undefined;
+}
+export function avisoEscopoStackVerificacao(fontesLegado, alvosEfetivos) {
+    const suportados = alvosSuportadosPelaStack(fontesLegado);
+    if (!suportados) {
+        return undefined;
+    }
+    const foraDaStack = alvosEfetivos.filter((alvo) => alvo !== "html" && alvo !== "css" && !suportados.includes(alvo));
+    if (foraDaStack.length === 0) {
+        return undefined;
+    }
+    return `Alvos fora da stack detectada (${(fontesLegado ?? []).join(", ")}): ${foraDaStack.join(", ")}. Considere reduzir "alvos" no sema.config.json, remover "fontesLegado" auto-declaradas ou usar --alvo unico.`;
+}
 import { escreverArquivos, formatarAvisoArtefatosGeradosAcimaDoLimite, } from './fsGovernado.js';
 import { obterOpcao } from './cliArgs.js';
 import { avaliarDependenciasVerificacao, imprimirFalhaDependenciasVerificacao } from './doctorCommand.js';
@@ -154,7 +201,7 @@ export function imprimirResumoVerificacao(resumos) {
     }
     console.log(`Totais: modulos=${resumos.length} alvos=${totalAlvos} arquivos=${totalArquivos} testes=${totalTestes}`);
 }
-export async function comandoVerificar(entrada, baseSaida, cwd = process.cwd()) {
+export async function comandoVerificar(entrada, baseSaida, cwd = process.cwd(), opcoes = {}) {
     const contextoProjeto = await carregarProjeto(entrada, cwd);
     const modulos = contextoProjeto.modulosSelecionados;
     const diagnosticos = modulos.flatMap((item) => item.resultado.diagnosticos);
@@ -162,7 +209,13 @@ export async function comandoVerificar(entrada, baseSaida, cwd = process.cwd())
         console.error(formatarDiagnosticos(diagnosticos));
         return 1;
     }
-    const alvos = resolverAlvosVerificacao(contextoProjeto.configCarregada);
+    const alvos = opcoes.alvo
+        ? [opcoes.alvo]
+        : resolverAlvosVerificacao(contextoProjeto.configCarregada);
+    const avisoEscopo = avisoEscopoStackVerificacao(contextoProjeto.configCarregada?.config.fontesLegado, alvos);
+    if (avisoEscopo) {
+        console.warn(avisoEscopo);
+    }
     const configuracoesAlvo = alvos.map((alvo) => ({
         alvo,
         ...resolverConfiguracaoVerificacaoPorAlvo(alvo, contextoProjeto.configCarregada),
@@ -187,13 +240,55 @@ export async function comandoVerificar(entrada, baseSaida, cwd = process.cwd())
             arquivoFonte: modulo.caminho,
             alvos: [],
         };
+        const conteudoContrato = await readFile(modulo.caminho, "utf8").catch(() => "");
         for (const configuracaoAlvo of configuracoesAlvo) {
             const { alvo, framework, estrutura } = configuracaoAlvo;
             const pastaAlvo = path.join(baseSaida, alvo, nomeSubpastaModulo(modulo.caminho));
+            const chave = calcularChaveVerificacao({
+                versaoCli: pacoteCli.version,
+                versaoNode: process.versions.node ?? "",
+                modulo: ir.nome,
+                alvo,
+                framework: framework ?? "",
+                estrutura,
+                conteudoContrato,
+            });
+            const emCache = opcoes.semCache ? undefined : await carregarCacheVerificacao(chave, pastaAlvo);
+            if (emCache) {
+                resumoModulo.alvos.push({
+                    alvo,
+                    arquivosGerados: emCache.arquivosGerados.length,
+                    quantidadeTestes: emCache.quantidadeTestes,
+                    pastaSaida: pastaAlvo,
+                    sucesso: emCache.sucesso,
+                    framework,
+                    estrutura,
+                    testesExecutados: false,
+                    origem: "cache",
+                });
+                if (!emCache.sucesso) {
+                    imprimirResumoVerificacao([...resumos, resumoModulo]);
+                    console.error(`Falha registrada em cache na verificacao do modulo ${modulo.caminho} para o alvo ${alvo}.`);
+                    return 1;
+                }
+                continue;
+            }
             const arquivos = aplicarEstruturaSaida(gerarArquivosPorAlvo(ir, alvo, framework), ir, estrutura);
             const escrita = await escreverArquivos(pastaAlvo, arquivos, { artefatoGerado: true });
             artefatosGeradosAcimaDoLimite.push(...escrita.artefatosGeradosAcimaDoLimite);
             const { execucao, testesExecutados } = executarTestesParaVerificacao(alvo, pastaAlvo, arquivos, framework);
+            await gravarCacheVerificacao({
+                schemaVersion: SCHEMA_CACHE_VERIFICACAO,
+                chave,
+                versaoCli: pacoteCli.version,
+                alvo,
+                modulo: ir.nome,
+                sucesso: execucao.codigoSaida === 0,
+                quantidadeTestes: execucao.quantidadeTestes,
+                testesExecutados,
+                arquivosGerados: arquivos.map((arquivo) => arquivo.caminhoRelativo),
+                geradoEm: new Date().toISOString(),
+            });
             resumoModulo.alvos.push({
                 alvo,
                 arquivosGerados: arquivos.length,
@@ -203,6 +298,7 @@ export async function comandoVerificar(entrada, baseSaida, cwd = process.cwd())
                 framework,
                 estrutura,
                 testesExecutados,
+                origem: "executado",
             });
             if (execucao.codigoSaida !== 0) {
                 imprimirResumoVerificacao([...resumos, resumoModulo]);
@@ -220,7 +316,7 @@ export async function comandoVerificar(entrada, baseSaida, cwd = process.cwd())
     console.log("Verificacao completa concluida com sucesso.");
     return 0;
 }
-export async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd()) {
+export async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd(), opcoes = {}) {
     const contextoProjeto = await carregarProjeto(entrada, cwd);
     const modulos = contextoProjeto.modulosSelecionados;
     const diagnosticos = modulos.flatMap((item) => item.resultado.diagnosticos);
@@ -234,7 +330,10 @@ export async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd
         }, null, 2));
         return 1;
     }
-    const alvos = resolverAlvosVerificacao(contextoProjeto.configCarregada);
+    const alvos = opcoes.alvo
+        ? [opcoes.alvo]
+        : resolverAlvosVerificacao(contextoProjeto.configCarregada);
+    const avisoEscopo = avisoEscopoStackVerificacao(contextoProjeto.configCarregada?.config.fontesLegado, alvos);
     const configuracoesAlvo = alvos.map((alvo) => ({
         alvo,
         ...resolverConfiguracaoVerificacaoPorAlvo(alvo, contextoProjeto.configCarregada),
@@ -273,13 +372,54 @@ export async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd
             alvos: [],
             saidaTestes: [],
         };
+        const conteudoContrato = await readFile(modulo.caminho, "utf8").catch(() => "");
         for (const configuracaoAlvo of configuracoesAlvo) {
             const { alvo, framework, estrutura } = configuracaoAlvo;
             const pastaAlvo = path.join(baseSaida, alvo, nomeSubpastaModulo(modulo.caminho));
+            const chave = calcularChaveVerificacao({
+                versaoCli: pacoteCli.version,
+                versaoNode: process.versions.node ?? "",
+                modulo: ir.nome,
+                alvo,
+                framework: framework ?? "",
+                estrutura,
+                conteudoContrato,
+            });
+            const emCache = opcoes.semCache ? undefined : await carregarCacheVerificacao(chave, pastaAlvo);
+            if (emCache) {
+                resumoModulo.alvos.push({
+                    alvo,
+                    arquivosGerados: emCache.arquivosGerados.length,
+                    quantidadeTestes: emCache.quantidadeTestes,
+                    pastaSaida: pastaAlvo,
+                    sucesso: emCache.sucesso,
+                    framework,
+                    estrutura,
+                    testesExecutados: false,
+                    origem: "cache",
+                });
+                resumoModulo.saidaTestes.push({ alvo, stdout: "", stderr: `resultado reutilizado do cache de verificacao (chave ${chave.slice(0, 12)})` });
+                if (!emCache.sucesso) {
+                    codigoSaida = 1;
+                }
+                continue;
+            }
             const arquivos = aplicarEstruturaSaida(gerarArquivosPorAlvo(ir, alvo, framework), ir, estrutura);
             const escrita = await escreverArquivos(pastaAlvo, arquivos, { artefatoGerado: true });
             artefatosGeradosAcimaDoLimite.push(...escrita.artefatosGeradosAcimaDoLimite);
             const { execucao, testesExecutados } = executarTestesParaVerificacao(alvo, pastaAlvo, arquivos, framework, true);
+            await gravarCacheVerificacao({
+                schemaVersion: SCHEMA_CACHE_VERIFICACAO,
+                chave,
+                versaoCli: pacoteCli.version,
+                alvo,
+                modulo: ir.nome,
+                sucesso: execucao.codigoSaida === 0,
+                quantidadeTestes: execucao.quantidadeTestes,
+                testesExecutados,
+                arquivosGerados: arquivos.map((arquivo) => arquivo.caminhoRelativo),
+                geradoEm: new Date().toISOString(),
+            });
             resumoModulo.alvos.push({
                 alvo,
                 arquivosGerados: arquivos.length,
@@ -289,6 +429,7 @@ export async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd
                 framework,
                 estrutura,
                 testesExecutados,
+                origem: "executado",
             });
             resumoModulo.saidaTestes.push({ alvo, stdout: execucao.saidaPadrao, stderr: execucao.saidaErro });
             if (execucao.codigoSaida !== 0) {
@@ -306,6 +447,7 @@ export async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd
     console.log(JSON.stringify({
         comando: "verificar",
         sucesso: codigoSaida === 0,
+        avisoEscopo,
         modulos: resumos,
         totais,
         artefatosGeradosAcimaDoLimite,

package/dist/index.part08.js

@@ -34,7 +34,7 @@ export async function principal() {
     let codigoSaida = 0;
     switch (comando) {
         case "iniciar":
-            codigoSaida = await comandoIniciar(cwd, normalizarTemplateIniciar(obterOpcao(resto, "--template")), { force: possuiFlag(resto, "--force") });
+            codigoSaida = await comandoIniciar(cwd, normalizarTemplateIniciar(obterOpcao(resto, "--template")), { force: possuiFlag(resto, "--force"), exemplosCompletos: possuiFlag(resto, "--com-exemplos") });
             break;
         case "author":
             codigoSaida = await comandoAuthor(posicionais, resto, possuiFlag(resto, "--json"));
@@ -100,8 +100,8 @@ export async function principal() {
             break;
         case "verificar":
             codigoSaida = possuiFlag(resto, "--json")
-                ? await comandoVerificarJson(posicionais[0], resolverSaidaPadrao(obterOpcao(resto, "--saida", "./.tmp/sema-verificar"), "typescript", await carregarConfiguracaoProjeto(posicionais[0] ? path.resolve(cwd, posicionais[0]) : cwd)), cwd)
-                : await comandoVerificar(posicionais[0], resolverSaidaPadrao(obterOpcao(resto, "--saida", "./.tmp/sema-verificar"), "typescript", await carregarConfiguracaoProjeto(posicionais[0] ? path.resolve(cwd, posicionais[0]) : cwd)), cwd);
+                ? await comandoVerificarJson(posicionais[0], resolverSaidaPadrao(obterOpcao(resto, "--saida", "./.tmp/sema-verificar"), "typescript", await carregarConfiguracaoProjeto(posicionais[0] ? path.resolve(cwd, posicionais[0]) : cwd)), cwd, { alvo: obterOpcao(resto, "--alvo"), semCache: possuiFlag(resto, "--sem-cache") })
+                : await comandoVerificar(posicionais[0], resolverSaidaPadrao(obterOpcao(resto, "--saida", "./.tmp/sema-verificar"), "typescript", await carregarConfiguracaoProjeto(posicionais[0] ? path.resolve(cwd, posicionais[0]) : cwd)), cwd, { alvo: obterOpcao(resto, "--alvo"), semCache: possuiFlag(resto, "--sem-cache") });
             break;
         case "inspecionar":
             codigoSaida = await comandoInspecionar(posicionais[0], possuiFlag(resto, "--json"), cwd, resto);