@semacode/cli 3.0.0 → 3.8.0

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

package/dist/initCommand.d.ts

@@ -1,5 +1,6 @@
 import { type TemplateIniciar } from "./initTemplatesBase.js";
 export declare function comandoIniciar(cwd: string, template: TemplateIniciar, opcoes?: {
     force?: boolean;
+    exemplosCompletos?: boolean;
 }): Promise<number>;
 export declare function comandoInstalarExemplos(emJson: boolean): Promise<number>;

package/dist/initCommand.js

@@ -4,7 +4,7 @@ import * as fs from "node:fs";
 import path from "node:path";
 import { escreverArquivos } from "./fsGovernado.js";
 import { arquivosTemplateIniciar } from "./initTemplatesBase.js";
-import { materializarExemplosOficiais, planejarExemplosOficiais } from "./exemplosOficiais.js";
+import { materializarExemplosOficiais, normalizarCaminhoExemplo, planejarExemplosOficiais } from "./exemplosOficiais.js";
 import { validarDestinosEscritaWorkspace } from "./workspaceWrite.js";
 async function sincronizarKitIaInicial(cwd) {
     const [{ gerarResumoProjetoIa }, { sincronizarEntrypointCodex }] = await Promise.all([
@@ -26,6 +26,12 @@ async function sincronizarKitIaInicial(cwd) {
         codex,
     };
 }
+const EXEMPLOS_STARTER_INICIAR = new Set([
+    "exemplos/crud_simples.sema",
+    "exemplos/cadastro_usuario.sema",
+    "exemplos/pedido.sema",
+    "exemplos/autenticacao.sema",
+]);
 export async function comandoIniciar(cwd, template, opcoes = {}) {
     const arquivos = arquivosTemplateIniciar(template);
     const planoExemplos = await planejarExemplosOficiais();
@@ -33,6 +39,9 @@ export async function comandoIniciar(cwd, template, opcoes = {}) {
         console.error("Diretorio de exemplos oficiais nao foi encontrado no pacote da CLI.");
         return 1;
     }
+    const exemplosIniciar = opcoes.exemplosCompletos
+        ? planoExemplos.arquivos
+        : planoExemplos.arquivos.filter((arquivo) => EXEMPLOS_STARTER_INICIAR.has(normalizarCaminhoExemplo(arquivo.caminhoRelativo)));
     const [{ ARQUIVOS_RESUMO_PROJETO_IA }, { listarDestinosEntrypointCodex }] = await Promise.all([
         import("./index.part04.js"),
         import("./agentEntryPoints.js"),
@@ -40,7 +49,7 @@ export async function comandoIniciar(cwd, template, opcoes = {}) {
     const caminhosTemplate = new Set(arquivos.map((arquivo) => arquivo.caminhoRelativo));
     const destinos = await validarDestinosEscritaWorkspace(cwd, [
         ...caminhosTemplate,
-        ...planoExemplos.arquivos.map((arquivo) => arquivo.caminhoRelativo),
+        ...exemplosIniciar.map((arquivo) => arquivo.caminhoRelativo),
         ...ARQUIVOS_RESUMO_PROJETO_IA,
         ...listarDestinosEntrypointCodex("AGENTS.md"),
     ]);
@@ -51,7 +60,7 @@ export async function comandoIniciar(cwd, template, opcoes = {}) {
         ? arquivos
         : arquivos.filter((arquivo) => !existentes.has(arquivo.caminhoRelativo));
     await escreverArquivos(cwd, arquivosParaEscrever, { inserirCabecalhoGovernado: true });
-    const exemplos = await materializarExemplosOficiais(cwd, true);
+    const exemplos = await materializarExemplosOficiais(cwd, true, opcoes.exemplosCompletos ? undefined : EXEMPLOS_STARTER_INICIAR);
     if (!exemplos.sucesso) {
         console.error(exemplos.erro);
         return 1;
@@ -67,6 +76,9 @@ export async function comandoIniciar(cwd, template, opcoes = {}) {
     console.log(`Projeto Sema inicializado com template ${template}.`);
     console.log(`Arquivos do projeto: ${arquivosParaEscrever.length} escritos, ${opcoes.force ? 0 : existentes.size} preservados.`);
     console.log(`Exemplos oficiais sincronizados em ${exemplos.destino} (${exemplos.criados.length} criados, ${exemplos.preservados.length} preservados).`);
+    if (!opcoes.exemplosCompletos) {
+        console.log("Starter de exemplos instalado; rode sema instalar-exemplos ou sema iniciar --com-exemplos para o pacote completo.");
+    }
     console.log(`Kit IA Codex-native sincronizado (${kitIa.artefatos.length} artefatos; entrypoint ${kitIa.codex.entrypointCodex}; ${kitIa.codex.criados.length} criados, ${kitIa.codex.atualizados.length} atualizados, ${kitIa.codex.preservados.length} preservados).`);
     return 0;
 }

package/dist/initTemplatesBase.js

@@ -8,54 +8,54 @@ export function arquivosBaseIniciar() {
     return [
         {
             caminhoRelativo: "contratos/pedidos.sema",
-            conteudo: `module app.pedidos {
-  entity Pedido {
-    fields {
-      id: Id
-      status: Texto
-      total: Decimal
-    }
-  }
-
-  task criar_pedido {
-    input {
-      cliente_id: Id required
-      total: Decimal required
-    }
-    output {
-      pedido_id: Id
-      status: Texto
-    }
-    rules {
-      total > 0
-    }
-    effects {
-      persistencia Pedido criticidade=alta
-      auditoria pedidos
-    }
-    guarantees {
-      pedido_id existe
-      status existe
-    }
-    tests {
-      caso "pedido valido" {
-        given {
-          cliente_id: "cli-1"
-          total: 10
-        }
-        expect {
-          sucesso: verdadeiro
-        }
-      }
-    }
-  }
-
-  route criar_pedido_publico {
-    metodo: POST
-    caminho: /pedidos
-    task: criar_pedido
-  }
-}
+            conteudo: `module app.pedidos {
+  entity Pedido {
+    fields {
+      id: Id
+      status: Texto
+      total: Decimal
+    }
+  }
+
+  task criar_pedido {
+    input {
+      cliente_id: Id required
+      total: Decimal required
+    }
+    output {
+      pedido_id: Id
+      status: Texto
+    }
+    rules {
+      total > 0
+    }
+    effects {
+      persistencia Pedido criticidade=alta
+      auditoria pedidos
+    }
+    guarantees {
+      pedido_id existe
+      status existe
+    }
+    tests {
+      caso "pedido valido" {
+        given {
+          cliente_id: "cli-1"
+          total: 10
+        }
+        expect {
+          sucesso: verdadeiro
+        }
+      }
+    }
+  }
+
+  route criar_pedido_publico {
+    metodo: POST
+    caminho: /pedidos
+    task: criar_pedido
+  }
+}
 `,
         },
     ];
@@ -64,41 +64,41 @@ function arquivosApoioIaIniciar() {
     return [
         {
             caminhoRelativo: "README.md",
-            conteudo: `# Projeto Sema
-
-Este projeto foi inicializado com Sema.
-
-## Entrada oficial do Codex
-
-Antes de alterar codigo, contrato ou documentacao:
-
-1. leia \`AGENTS.md\`;
+            conteudo: `# Projeto Sema
+
+Este projeto foi inicializado com Sema.
+
+## Entrada oficial do Codex
+
+Antes de alterar codigo, contrato ou documentacao:
+
+1. leia \`AGENTS.md\`;
 2. rode \`sema --version\`; se o shell não localizar o comando, use \`$HOME/.sema/bin/sema\` no macOS/Linux; no Windows, PowerShell usa \`sema.ps1\` no PATH, cmd.exe usa \`sema.cmd\`, e o fallback absoluto é \`& "$env:SystemRoot\\System32\\WindowsPowerShell\\v1.0\\powershell.exe" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$HOME\\.sema\\bin\\sema-managed.ps1" --version\`;
 3. rode \`sema resumo --drift none\` para contexto contratual; score, confiança e implementação ficam não avaliados;
 4. rode \`sema docs-impacto --intencao "<acao>" --json\`;
-5. leia \`docs/commands.md\` antes de escolher comando ou interpretar \`--saida\`;
-6. use \`sema descobrir recomendar --intencao "<objetivo>" --json\` quando não souber qual capacidade ou pipeline aplicar;
+5. leia \`docs/commands.md\` antes de escolher comando ou interpretar \`--saida\`;
+6. use \`sema descobrir recomendar --intencao "<objetivo>" --json\` quando não souber qual capacidade ou pipeline aplicar;
 7. use \`exemplos/\` e \`docs/syntax.md\` antes de criar ou corrigir \`.sema\`.
 
 Quando precisar comprovar o código vivo, rode \`sema drift <contrato.sema> --escopo modulo --cache fresh --json\`. Cache acelera navegação, mas não é prova final de fechamento.
-
-## Estrutura criada
-
-- \`contratos/\`: contratos semanticamente governados.
-- \`AGENTS.md\`: entrypoint oficial do Codex.
-- \`exemplos/\`: exemplos oficiais da DSL Sema.
-- \`docs/commands.md\`: catalogo de comandos, pipelines, gates e regra de \`--saida\`.
-- \`docs/syntax.md\`: referencia curta para escrever \`.sema\`.
-- \`docs/ai-workflow.md\`: fluxo minimo para agentes.
-- \`SEMA_BOOT.md\`, \`SEMA_SMALL_MODEL.md\`, \`AGENT_CONTEXT_PACK.json\` e \`SEMA_INDEX.json\`: contexto IA-first.
-
-## Geracao
-
-O template base ja declara alvo JavaScript. Exemplo:
-
-\`\`\`bash
-sema compilar contratos/pedidos.sema --alvo javascript --saida ./generated/javascript
-\`\`\`
+
+## Estrutura criada
+
+- \`contratos/\`: contratos semanticamente governados.
+- \`AGENTS.md\`: entrypoint oficial do Codex.
+- \`exemplos/\`: exemplos oficiais da DSL Sema.
+- \`docs/commands.md\`: catalogo de comandos, pipelines, gates e regra de \`--saida\`.
+- \`docs/syntax.md\`: referencia curta para escrever \`.sema\`.
+- \`docs/ai-workflow.md\`: fluxo minimo para agentes.
+- \`SEMA_BOOT.md\`, \`SEMA_SMALL_MODEL.md\`, \`AGENT_CONTEXT_PACK.json\` e \`SEMA_INDEX.json\`: contexto IA-first.
+
+## Geracao
+
+O template base ja declara alvo JavaScript. Exemplo:
+
+\`\`\`bash
+sema compilar contratos/pedidos.sema --alvo javascript --saida ./generated/javascript
+\`\`\`
 `,
         },
     ];
@@ -119,7 +119,7 @@ export function arquivosTemplateIniciar(template) {
         ?? [
             {
                 caminhoRelativo: "sema.config.json",
-                conteudo: "{\n  \"origens\": [\"./contratos\"],\n  \"saida\": \"./generated\",\n  \"alvos\": [\"typescript\", \"javascript\", \"python\", \"php\", \"dart\", \"lua\", \"html\", \"css\"],\n  \"alvoPadrao\": \"typescript\",\n  \"estruturaSaida\": \"modulos\",\n  \"framework\": \"base\",\n  \"modoEstrito\": true,\n  \"diretoriosSaidaPorAlvo\": {\n    \"typescript\": \"./generated/typescript\",\n    \"javascript\": \"./generated/javascript\",\n    \"python\": \"./generated/python\",\n    \"php\": \"./generated/php\",\n    \"dart\": \"./generated/dart\",\n    \"lua\": \"./generated/lua\",\n    \"html\": \"./generated/html\",\n    \"css\": \"./generated/css\",\n    \"dotnet\": \"./generated/dotnet\",\n    \"cpp\": \"./generated/cpp\"\n  },\n  \"convencoesGeracaoPorProjeto\": \"base\"\n}\n",
+                conteudo: "{\n  \"origens\": [\"./contratos\"],\n  \"saida\": \"./generated\",\n  \"alvos\": [\"typescript\", \"javascript\"],\n  \"alvoPadrao\": \"typescript\",\n  \"estruturaSaida\": \"modulos\",\n  \"framework\": \"base\",\n  \"modoEstrito\": true,\n  \"diretoriosSaidaPorAlvo\": {\n    \"typescript\": \"./generated/typescript\",\n    \"javascript\": \"./generated/javascript\",\n    \"python\": \"./generated/python\",\n    \"php\": \"./generated/php\",\n    \"dart\": \"./generated/dart\",\n    \"lua\": \"./generated/lua\",\n    \"html\": \"./generated/html\",\n    \"css\": \"./generated/css\",\n    \"dotnet\": \"./generated/dotnet\",\n    \"cpp\": \"./generated/cpp\"\n  },\n  \"convencoesGeracaoPorProjeto\": \"base\"\n}\n",
             },
             ...arquivosBase,
         ];

package/dist/projetoConfig.js

@@ -74,6 +74,9 @@ export function normalizarFonteLegado(valor) {
         return "typescript";
     }
     if (valor === "nestjs"
+        || valor === "express"
+        || valor === "fastify"
+        || valor === "koa"
         || valor === "fastapi"
         || valor === "flask"
         || valor === "nextjs"
@@ -81,6 +84,8 @@ export function normalizarFonteLegado(valor) {
         || valor === "react-vite-consumer"
         || valor === "angular-consumer"
         || valor === "flutter-consumer"
+        || valor === "sveltekit-consumer"
+        || valor === "nuxt-consumer"
         || valor === "firebase"
         || valor === "typescript"
         || valor === "javascript"