@semacode/cli 3.0.0 → 3.8.0

package/dist/drift.part05.js

@@ -120,6 +120,74 @@ export function arquivoEhRotasFlutterConsumer(relacaoArquivo, codigo) {
     return /(?:^|\/)(?:lib\/)?(?:router|app_router|routes)\.dart$/i.test(relacao)
         || /MaterialApp(?:\.router)?\s*\(|CupertinoApp(?:\.router)?\s*\(|GoRouter\s*\(/.test(codigo ?? "");
 }
+export function arquivoEhBridgeSvelteKitConsumer(relacaoArquivo) {
+    const relacao = normalizarRelacaoConsumer(relacaoArquivo);
+    return /(?:^|\/)(?:src\/)?lib\/(?:sema_consumer_bridge|sema\/.+)\.(?:ts|js)$/i.test(relacao);
+}
+export function arquivoEhSuperficieSvelteKitConsumer(relacaoArquivo) {
+    const relacao = normalizarRelacaoConsumer(relacaoArquivo);
+    return /(?:^|\/)(?:src\/)?routes\/(?:[^/]+\/)*\+(?:page|layout|error|server)\.(?:svelte|ts|js)$/i.test(relacao);
+}
+export function inferirRotaSvelteKitConsumer(relacaoArquivo) {
+    const relacao = normalizarRelacaoConsumer(relacaoArquivo);
+    const segmentos = relacao.split("/");
+    const indiceSrcRoutes = segmentos.findIndex((segmento, indice) => segmento === "src" && segmentos[indice + 1] === "routes");
+    const indiceRoutes = segmentos.findIndex((segmento) => segmento === "routes");
+    const inicioRoutes = indiceSrcRoutes >= 0 ? indiceSrcRoutes + 2 : indiceRoutes >= 0 ? indiceRoutes + 1 : -1;
+    if (inicioRoutes < 0) {
+        return undefined;
+    }
+    const arquivoFinal = segmentos.at(-1) ?? "";
+    const tipoArquivo = arquivoFinal.match(/^\+(page|layout|error|server)\.(?:svelte|ts|js)$/i)?.[1]?.toLowerCase();
+    if (!tipoArquivo) {
+        return undefined;
+    }
+    return {
+        rota: montarRotaConsumer(segmentos.slice(inicioRoutes, -1)),
+        arquivo: relacaoArquivo,
+        tipoArquivo,
+    };
+}
+export function arquivoEhBridgeNuxtConsumer(relacaoArquivo) {
+    const relacao = normalizarRelacaoConsumer(relacaoArquivo);
+    return /(?:^|\/)(?:app\/)?composables\/(?:sema_consumer_bridge|sema\/.+)\.(?:ts|js)$/i.test(relacao);
+}
+export function arquivoEhSuperficieNuxtConsumer(relacaoArquivo) {
+    const relacao = normalizarRelacaoConsumer(relacaoArquivo);
+    return /^(?:app\/)?pages\/.+\.vue$/i.test(relacao)
+        || /(?:^|\/)server\/api\/.+\.(?:get|post|put|patch|delete|head)\.(?:ts|js)$/i.test(relacao);
+}
+export function inferirRotaNuxtConsumer(relacaoArquivo) {
+    const relacao = normalizarRelacaoConsumer(relacaoArquivo);
+    const segmentos = relacao.split("/");
+    const indiceServer = segmentos.findIndex((segmento, indice) => segmento === "server" && segmentos[indice + 1] === "api");
+    if (indiceServer >= 0) {
+        const arquivoFinal = segmentos.at(-1) ?? "";
+        const metodo = arquivoFinal.match(/\.(get|post|put|patch|delete|head)\.(?:ts|js)$/i)?.[1]?.toUpperCase();
+        const nomeBase = arquivoFinal.replace(/\.(?:get|post|put|patch|delete|head)?\.(?:ts|js)$/i, "");
+        const caminhoAteArquivo = segmentos.slice(indiceServer + 1, -1);
+        return {
+            rota: montarRotaConsumer(nomeBase === "index" ? caminhoAteArquivo : [...caminhoAteArquivo, nomeBase]),
+            arquivo: relacaoArquivo,
+            tipoArquivo: metodo ?? "server",
+        };
+    }
+    const indicePages = segmentos.findIndex((segmento, indice) => segmento === "pages" && (indice === 0 || segmentos[indice - 1] === "app"));
+    if (indicePages < 0) {
+        return undefined;
+    }
+    const arquivoFinal = segmentos.at(-1) ?? "";
+    if (!arquivoFinal.endsWith(".vue")) {
+        return undefined;
+    }
+    const nomeBase = arquivoFinal.replace(/\.vue$/i, "");
+    const caminhoAteArquivo = segmentos.slice(indicePages + 1, -1);
+    return {
+        rota: montarRotaConsumer(nomeBase === "index" ? caminhoAteArquivo : [...caminhoAteArquivo, nomeBase]),
+        arquivo: relacaoArquivo,
+        tipoArquivo: "page",
+    };
+}
 export function inferirRotaNextJsConsumer(relacaoArquivo) {
     const relacao = normalizarRelacaoConsumer(relacaoArquivo);
     const segmentos = relacao.split("/");

package/dist/drift.part06.js

@@ -5,7 +5,7 @@ import path from "node:path";
 import ts from "typescript";
 import { coletarSuperficiesAngularStandaloneConsumer } from "./angular-consumer-standalone.js";
 import { extrairRotasTypeScriptHttp } from "./typescript-http.js";
-import { arquivoEhRotasAngularConsumer, arquivoEhRotasAngularConsumerRaiz, arquivoEhRotasReactViteConsumer, arquivoEhSuperficieNextJsConsumer, arquivoEhSuperficieReactViteConsumer, extrairRotasAngularConsumer, extrairRotasReactViteConsumer, inferirRotaNextJsConsumer, inferirRotaReactViteConsumer, normalizarRelacaoConsumer, registrarAtribuicaoPrototypeTypeScript, registrarMetodosObjectAssignTypeScript } from "./drift.part05.js";
+import { arquivoEhRotasAngularConsumer, arquivoEhRotasAngularConsumerRaiz, arquivoEhRotasReactViteConsumer, arquivoEhSuperficieNextJsConsumer, arquivoEhSuperficieNuxtConsumer, arquivoEhSuperficieReactViteConsumer, arquivoEhSuperficieSvelteKitConsumer, extrairRotasAngularConsumer, extrairRotasReactViteConsumer, inferirRotaNextJsConsumer, inferirRotaNuxtConsumer, inferirRotaReactViteConsumer, inferirRotaSvelteKitConsumer, normalizarRelacaoConsumer, registrarAtribuicaoPrototypeTypeScript, registrarMetodosObjectAssignTypeScript } from "./drift.part05.js";
 import { caminhosSimbolicos, chaveCaminhoCanonicoDrift, deduplicarRaizesSobrepostasDrift, desembrulharExpressaoTypeScript, extrairNomeClassePrototypeTypeScript, extrairTextoLiteral, juntarCaminhoHttp, lerDecorator, listarArquivosRecursivos, registrarSimboloTypeScript, } from "./drift.part04.js";
 import { extrairRecursosPersistenciaCodigoVivo, registrarRecursoDrift } from "./drift.part03.js";
 export function inferirConsumerFrameworkPrincipal(fontesLegado, consumerSurfaces, consumerBridges) {
@@ -31,7 +31,14 @@ export function inferirConsumerFrameworkPrincipal(fontesLegado, consumerSurfaces
         || /(?:^|\/)(?:lib\/)?(?:router|app_router|routes|main)\.dart$/i.test(arquivo))) {
         return "flutter-consumer";
     }
-    for (const framework of ["nextjs-consumer", "react-vite-consumer", "angular-consumer", "flutter-consumer"]) {
+    if (arquivos.some((arquivo) => /(?:^|\/)(?:src\/)?routes\/(?:[^/]+\/)*\+(?:page|layout|error|server)\.(?:svelte|ts|js)$/i.test(arquivo))) {
+        return "sveltekit-consumer";
+    }
+    if (arquivos.some((arquivo) => /^(?:app\/)?pages\/.+\.vue$/i.test(arquivo)
+        || /(?:^|\/)server\/api\/.+\.(?:get|post|put|patch|delete|head)\.(?:ts|js)$/i.test(arquivo))) {
+        return "nuxt-consumer";
+    }
+    for (const framework of ["nextjs-consumer", "react-vite-consumer", "angular-consumer", "flutter-consumer", "sveltekit-consumer", "nuxt-consumer"]) {
         if (fontesLegado.includes(framework)) {
             return framework;
         }
@@ -203,8 +210,50 @@ export async function indexarTypeScript(diretorios, adaptadorLeitura) {
     const consumerSurfaces = new Map();
     const sourceFiles = new Map();
     const arquivosProcessados = new Set();
+    const registrarSuperficieSvelteKitDrift = (relacao, arquivo) => {
+        const superficie = arquivoEhSuperficieSvelteKitConsumer(relacao)
+            ? inferirRotaSvelteKitConsumer(relacao)
+            : undefined;
+        if (!superficie) {
+            return;
+        }
+        consumerSurfaces.set(`${superficie.rota}:${arquivo}:${superficie.tipoArquivo}`, {
+            rota: superficie.rota,
+            arquivo,
+            tipoArquivo: superficie.tipoArquivo,
+        });
+        rotas.push({
+            origem: "sveltekit-consumer",
+            metodo: superficie.tipoArquivo === "server" ? "GET" : "VIEW",
+            caminho: superficie.rota,
+            arquivo,
+            simbolo: superficie.tipoArquivo,
+        });
+    };
+    const registrarSuperficieNuxtDrift = (relacao, arquivo) => {
+        const superficie = arquivoEhSuperficieNuxtConsumer(relacao)
+            ? inferirRotaNuxtConsumer(relacao)
+            : undefined;
+        if (!superficie) {
+            return;
+        }
+        consumerSurfaces.set(`${superficie.rota}:${arquivo}:${superficie.tipoArquivo}`, {
+            rota: superficie.rota,
+            arquivo,
+            tipoArquivo: superficie.tipoArquivo,
+        });
+        rotas.push({
+            origem: "nuxt-consumer",
+            metodo: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"].includes(superficie.tipoArquivo)
+                ? superficie.tipoArquivo
+                : "VIEW",
+            caminho: superficie.rota,
+            arquivo,
+            simbolo: superficie.tipoArquivo,
+        });
+    };
     for (const diretorio of deduplicarRaizesSobrepostasDrift(diretorios)) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"], adaptadorLeitura))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".vue", ".svelte"], adaptadorLeitura))
             .filter((arquivo) => !arquivo.endsWith(".d.ts")
             && !arquivo.endsWith(".spec.ts")
             && !arquivo.endsWith(".test.ts"))
@@ -228,6 +277,12 @@ export async function indexarTypeScript(diretorios, adaptadorLeitura) {
             const codigo = adaptadorLeitura
                 ? await adaptadorLeitura.lerTexto(arquivo)
                 : await readFile(arquivo, "utf8");
+            if (/\.(?:vue|svelte)$/i.test(arquivo)) {
+                const relacaoSuperficie = path.relative(diretorio, arquivo);
+                registrarSuperficieSvelteKitDrift(relacaoSuperficie, arquivo);
+                registrarSuperficieNuxtDrift(relacaoSuperficie, arquivo);
+                continue;
+            }
             const origemArquivo = /\.(?:js|jsx|mjs|cjs)$/i.test(arquivo) ? "js" : "ts";
             const scriptKind = arquivo.endsWith(".tsx")
                 ? ts.ScriptKind.TSX
@@ -287,6 +342,8 @@ export async function indexarTypeScript(diretorios, adaptadorLeitura) {
                     simbolo: superficieReact.tipoArquivo,
                 });
             }
+            registrarSuperficieSvelteKitDrift(relacao, arquivo);
+            registrarSuperficieNuxtDrift(relacao, arquivo);
             if (fonteDeclaraRotasReactVite(relacao, sourceFile)) {
                 for (const rotaReact of extrairRotasReactViteConsumer(relacao, codigo)) {
                     consumerSurfaces.set(`${rotaReact.rota}:${arquivo}:router`, {

package/dist/drift.part09.d.ts

@@ -5,7 +5,7 @@ import { OpcoesDriftLegado, OrigemCodigoDrift, RecursoResolvido, RegistroPersist
 import { indexarPersistenciaDetalhada } from "./drift.part08.js";
 export declare function analisarPersistenciaReal(contexto: ContextoProjetoCarregado, mapaRecursos?: Map<string, RecursoResolvido[]>, detalhesPersistencia?: Awaited<ReturnType<typeof indexarPersistenciaDetalhada>>, opcoes?: OpcoesDriftLegado, mapaImpl?: Map<string, SimboloResolvido>): Promise<RegistroPersistenciaRealDrift[]>;
 export declare function normalizarCaminhoRota(caminho?: string): string;
-export declare function extrairFontesHttpTypeScript(fontesLegado: FonteLegado[]): Array<"nestjs" | "nextjs" | "firebase">;
+export declare function extrairFontesHttpTypeScript(fontesLegado: FonteLegado[]): Array<"nestjs" | "nextjs" | "firebase" | "express" | "fastify" | "koa">;
 export declare function extrairFontesHttpBackend(fontesLegado: FonteLegado[]): Array<"dotnet" | "java" | "go" | "rust" | "php">;
 export declare function ultimoSegmentoSimbolico(caminho: string): string;
 export declare function pontuarCandidatoDeclarado(candidato: SimboloResolvido, origem: OrigemCodigoDrift, caminhoDeclarado: string): SimboloCandidatoDrift | undefined;
@@ -14,7 +14,7 @@ export declare function deduplicarCandidatos(candidatos: SimboloCandidatoDrift[]
 export declare function ordenarCandidatos(candidatos: SimboloCandidatoDrift[]): SimboloCandidatoDrift[];
 export declare function sugerirCandidatosParaImpl(simbolos: SimboloResolvido[], origem: OrigemCodigoDrift, caminhoDeclarado: string): SimboloCandidatoDrift[];
 export declare function sugerirCandidatosParaTaskSemImpl(simbolos: SimboloResolvido[], nomeTask: string): SimboloCandidatoDrift[];
-export declare function escolherRotasEsperadas(task: IrTask, fontesLegado: FonteLegado[]): Array<"nestjs" | "fastapi" | "flask" | "nextjs" | "firebase" | "dotnet" | "java" | "go" | "rust" | "php">;
+export declare function escolherRotasEsperadas(task: IrTask, fontesLegado: FonteLegado[]): Array<"nestjs" | "express" | "fastify" | "koa" | "fastapi" | "flask" | "nextjs" | "firebase" | "dotnet" | "java" | "go" | "rust" | "php">;
 export declare function taskEhBridgeFirebase(task: IrTask): boolean;
 export declare function tiposAceitosParaRecursoPersistencia(recurso: IrRecursoPersistencia): TipoRecursoDrift[];
 export declare function nomesRecursoPersistencia(recurso: IrRecursoPersistencia): string[];

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" || fonte === "koa");
 }
 export function extrairFontesHttpBackend(fontesLegado) {
     return fontesLegado.filter((fonte) => fonte === "dotnet" || fonte === "java" || fonte === "go" || fonte === "rust" || fonte === "php");
@@ -227,13 +228,22 @@ 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 (/\bkoa\b/i.test(implTsOuJs.caminho) && fontesTs.includes("koa")) {
+            esperadas.add("koa");
+        }
         if (esperadas.size > 0) {
             return [...esperadas];
         }
         if (fontesTs.length > 0) {
             return fontesTs;
         }
-        return ["nestjs", "nextjs", "firebase"];
+        return ["nestjs", "nextjs", "firebase", "express", "fastify", "koa"];
     }
     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

@@ -277,6 +277,8 @@ export function analisarModulosSelecionadosDrift(estado) {
                 && rotaResolvida.origem !== "react-vite-consumer"
                 && rotaResolvida.origem !== "angular-consumer"
                 && rotaResolvida.origem !== "flutter-consumer"
+                && rotaResolvida.origem !== "sveltekit-consumer"
+                && rotaResolvida.origem !== "nuxt-consumer"
                 && esperadas.includes(rotaResolvida.origem));
             const combina = encontradas.some((rotaResolvida) => rotaResolvida.metodo === route.metodo
                 && normalizarCaminhoRota(rotaResolvida.caminho) === normalizarCaminhoRota(route.caminho));
@@ -286,6 +288,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 +296,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,9 @@ export function normalizarFonteImportacao(valor) {
         return "php";
     }
     if (valor === "nestjs"
+        || valor === "express"
+        || valor === "fastify"
+        || valor === "koa"
         || valor === "fastapi"
         || valor === "flask"
         || valor === "nextjs"
@@ -92,6 +95,8 @@ export function normalizarFonteImportacao(valor) {
         || valor === "react-vite-consumer"
         || valor === "angular-consumer"
         || valor === "flutter-consumer"
+        || valor === "sveltekit-consumer"
+        || valor === "nuxt-consumer"
         || valor === "firebase"
         || valor === "dotnet"
         || valor === "java"

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" | "koa" | "fastapi" | "flask" | "nextjs" | "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer" | "sveltekit-consumer" | "nuxt-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.part04.d.ts

@@ -11,8 +11,12 @@ export declare function extrairTasksBridgeConsumer(baseProjeto: string, contexto
     enums: EnumImportado[];
 };
 export declare function montarVinculosSuperficiesConsumer(superficies: SuperficieConsumerImportada[]): VinculoImportado[];
-export declare function importarConsumerBase(diretorio: string, namespaceBase: string, descricaoFramework: string, ehBridge: (relacaoArquivo: string) => boolean, coletarSuperficies: (baseProjeto: string, arquivos: string[]) => Promise<SuperficieConsumerImportada[]>): Promise<ModuloImportado[]>;
+export declare function importarConsumerBase(diretorio: string, namespaceBase: string, descricaoFramework: string, ehBridge: (relacaoArquivo: string) => boolean, coletarSuperficies: (baseProjeto: string, arquivos: string[]) => Promise<SuperficieConsumerImportada[]>, extensoes?: readonly string[]): Promise<ModuloImportado[]>;
 export declare function coletarSuperficiesNextJsConsumer(baseProjeto: string, arquivos: string[]): Promise<SuperficieConsumerImportada[]>;
+export declare function coletarSuperficiesSvelteKitConsumer(baseProjeto: string, arquivos: string[]): Promise<SuperficieConsumerImportada[]>;
+export declare function coletarSuperficiesNuxtConsumer(baseProjeto: string, arquivos: string[]): Promise<SuperficieConsumerImportada[]>;
+export declare function importarSvelteKitConsumerBase(diretorio: string, namespaceBase: string): Promise<ModuloImportado[]>;
+export declare function importarNuxtConsumerBase(diretorio: string, namespaceBase: string): Promise<ModuloImportado[]>;
 export declare function coletarSuperficiesReactViteConsumer(baseProjeto: string, arquivos: string[]): Promise<SuperficieConsumerImportada[]>;
 export declare function coletarSuperficiesAngularConsumer(baseProjeto: string, arquivos: string[]): Promise<SuperficieConsumerImportada[]>;
 export declare function importarNextJsConsumerBase(diretorio: string, namespaceBase: string): Promise<ModuloImportado[]>;

package/dist/importador.part04.js

@@ -146,9 +146,9 @@ export function montarVinculosSuperficiesConsumer(superficies) {
         { tipo: "arquivo", valor: normalizarCaminhoImportado(superficie.arquivo) },
     ]));
 }
-export async function importarConsumerBase(diretorio, namespaceBase, descricaoFramework, ehBridge, coletarSuperficies) {
+export async function importarConsumerBase(diretorio, namespaceBase, descricaoFramework, ehBridge, coletarSuperficies, extensoes = [".ts", ".tsx", ".js", ".jsx"]) {
     const escopo = resolverEscopoImportacaoFrontendConsumer(diretorio);
-    const arquivos = await listarArquivosRecursivos(escopo.baseProjeto, [".ts", ".tsx", ".js", ".jsx"]);
+    const arquivos = await listarArquivosRecursivos(escopo.baseProjeto, [...extensoes]);
     const arquivosBridge = arquivos.filter((arquivo) => ehBridge(path.relative(escopo.baseProjeto, arquivo)));
     const contextosBridge = await carregarContextosBridgeConsumer(escopo.baseProjeto, arquivosBridge);
     const { tasks, entities, enums } = extrairTasksBridgeConsumer(escopo.baseProjeto, contextosBridge);
@@ -175,6 +175,44 @@ export async function coletarSuperficiesNextJsConsumer(baseProjeto, arquivos) {
         .map((arquivo) => inferirCaminhoNextJsConsumer(path.relative(baseProjeto, arquivo)))
         .filter((item) => Boolean(item));
 }
+export async function coletarSuperficiesSvelteKitConsumer(baseProjeto, arquivos) {
+    const { arquivoEhSuperficieSvelteKitConsumer, inferirRotaSvelteKitConsumer } = await import("./drift.part05.js");
+    return arquivos
+        .map((arquivo) => {
+        const relacao = path.relative(baseProjeto, arquivo);
+        if (!arquivoEhSuperficieSvelteKitConsumer(relacao)) {
+            return undefined;
+        }
+        const superficie = inferirRotaSvelteKitConsumer(relacao);
+        return superficie
+            ? { caminho: superficie.rota, arquivo: relacao, tipoArquivo: superficie.tipoArquivo }
+            : undefined;
+    })
+        .filter((item) => Boolean(item));
+}
+export async function coletarSuperficiesNuxtConsumer(baseProjeto, arquivos) {
+    const { arquivoEhSuperficieNuxtConsumer, inferirRotaNuxtConsumer } = await import("./drift.part05.js");
+    return arquivos
+        .map((arquivo) => {
+        const relacao = path.relative(baseProjeto, arquivo);
+        if (!arquivoEhSuperficieNuxtConsumer(relacao)) {
+            return undefined;
+        }
+        const superficie = inferirRotaNuxtConsumer(relacao);
+        return superficie
+            ? { caminho: superficie.rota, arquivo: relacao, tipoArquivo: superficie.tipoArquivo }
+            : undefined;
+    })
+        .filter((item) => Boolean(item));
+}
+export async function importarSvelteKitConsumerBase(diretorio, namespaceBase) {
+    const { arquivoEhBridgeSvelteKitConsumer } = await import("./drift.part05.js");
+    return importarConsumerBase(diretorio, namespaceBase, "SvelteKit", arquivoEhBridgeSvelteKitConsumer, coletarSuperficiesSvelteKitConsumer, [".ts", ".js", ".svelte"]);
+}
+export async function importarNuxtConsumerBase(diretorio, namespaceBase) {
+    const { arquivoEhBridgeNuxtConsumer } = await import("./drift.part05.js");
+    return importarConsumerBase(diretorio, namespaceBase, "Nuxt", arquivoEhBridgeNuxtConsumer, coletarSuperficiesNuxtConsumer, [".ts", ".js", ".vue"]);
+}
 export async function coletarSuperficiesReactViteConsumer(baseProjeto, arquivos) {
     const superficies = [];
     for (const arquivo of arquivos) {

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" | "koa"): ModuloImportado[];
+export declare function importarExpressFastifyBase(diretorio: string, namespaceBase: string, origem: "express" | "fastify" | "koa"): 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,102 @@ 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;
+        const semantica = implSimbolo
+            ? inferirSemanticaHandlerTypeScriptHttp(sourceFile, implSimbolo, true)
+            : undefined;
+        const converterCampoInferido = (campo) => ({
+            nome: campo.nome,
+            tipo: mapearTipoPrimitivo(campo.tipoTexto ?? "string") === "Vazio" ? "Texto" : mapearTipoPrimitivo(campo.tipoTexto ?? "string"),
+            obrigatorio: campo.obrigatorio,
+        });
+        const camposInferidos = deduplicarCampos([
+            ...rota.parametros.map((parametro) => ({
+                nome: parametro.nome,
+                tipo: parametro.tipoSema,
+                obrigatorio: true,
+            })),
+            ...(semantica?.query ?? []).map(converterCampoInferido),
+            ...(semantica?.body ?? []).map(converterCampoInferido),
+        ]);
+        const camposResposta = deduplicarCampos((semantica?.response ?? []).map(converterCampoInferido));
+        tasks.push({
+            nome: taskNome,
+            resumo: `Task importada automaticamente da rota ${rota.metodo} ${rota.caminho} em ${relacao}.`,
+            input: camposInferidos,
+            output: camposResposta,
+            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: camposInferidos,
+            output: camposResposta,
+            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" : origemDesejada === "koa" ? "Koa" : "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,8 +12,8 @@ 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 { importarAngularConsumerBase, importarFlutterConsumerBase, importarNextJsConsumerBase, importarReactViteConsumerBase } from "./importador.part04.js";
+import { importarExpressFastifyBase, importarNextJsBase, importarTypeScriptBase } from "./importador.part06.js";
+import { importarAngularConsumerBase, importarFlutterConsumerBase, importarNextJsConsumerBase, importarReactViteConsumerBase, importarNuxtConsumerBase, importarSvelteKitConsumerBase } from "./importador.part04.js";
 import { formatarModuloImportado, moduloParaCodigo, montarArquivoImportado } from "./importador.part05.js";
 export async function importarJavaBase(diretorio, namespaceBase) {
     const arquivos = (await listarArquivosRecursivos(diretorio, [".java"]))
@@ -300,6 +300,15 @@ 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 === "koa") {
+        modulos = await importarExpressFastifyBase(base, namespace, "koa");
+    }
     else if (fonte === "nextjs") {
         modulos = await importarNextJsBase(base, namespace);
     }
@@ -315,6 +324,12 @@ export async function importarProjetoLegado(fonte, diretorio, namespaceBase) {
     else if (fonte === "flutter-consumer") {
         modulos = await importarFlutterConsumerBase(base, namespace);
     }
+    else if (fonte === "sveltekit-consumer") {
+        modulos = await importarSvelteKitConsumerBase(base, namespace);
+    }
+    else if (fonte === "nuxt-consumer") {
+        modulos = await importarNuxtConsumerBase(base, namespace);
+    }
     else if (fonte === "firebase") {
         modulos = await importarFirebaseBase(base, namespace);
     }