@semacode/cli 1.5.7 → 1.5.8

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { createRequire } from "node:module";
@@ -63,8 +63,9 @@ Comandos essenciais:
 - validacao: \`sema validar <arquivo.sema> --json\`
 - diagnosticos: \`sema diagnosticos <arquivo.sema> --json\`
 - formatacao: \`sema formatar <arquivo.sema>\`
-- importacao assistida de legado: \`sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart> <diretorio> --saida <diretorio>\`
-- geracao de codigo: \`sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua> --saida <diretorio>\`
+- importacao assistida de legado: \`sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|typescript|python|dart> <diretorio> --saida <diretorio>\`
+- exemplos oficiais no projeto: \`sema instalar-exemplos\`
+- geracao de codigo: \`sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua> --saida <diretorio>\`
 - verificacao final: \`sema verificar <arquivo-ou-pasta> [--json]\`
 
 Antes de editar:
@@ -350,6 +351,65 @@ function resolverImportadorNodeOpcional(especificador) {
 }
 const TSX_IMPORTADOR_CLI = resolverImportadorNodeOpcional("tsx");
 const TSX_EXECUTOR_CLI = resolverImportadorNodeOpcional("tsx/cli");
+async function caminhoEhDiretorio(caminhoAlvo) {
+    try {
+        return (await stat(caminhoAlvo)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function localizarDiretorioExemplosOficiais() {
+    const candidatos = [
+        path.resolve(DIRETORIO_CLI_ATUAL, "..", "exemplos"),
+        path.resolve(DIRETORIO_CLI_ATUAL, "..", "..", "..", "exemplos"),
+    ];
+    for (const candidato of candidatos) {
+        if (await caminhoEhDiretorio(candidato)) {
+            return candidato;
+        }
+    }
+    return undefined;
+}
+async function materializarExemplosOficiais(baseProjeto = process.cwd(), preservarExistentes = true) {
+    const origem = await localizarDiretorioExemplosOficiais();
+    const destino = path.resolve(baseProjeto, "exemplos");
+    if (!origem) {
+        return {
+            sucesso: false,
+            origem: null,
+            destino,
+            criados: [],
+            preservados: [],
+            erro: "Diretorio de exemplos oficiais nao foi encontrado no pacote da CLI.",
+        };
+    }
+    await mkdir(destino, { recursive: true });
+    const criados = [];
+    const preservados = [];
+    const entradas = await readdir(origem, { withFileTypes: true });
+    for (const entrada of entradas.sort((a, b) => a.name.localeCompare(b.name, "pt-BR"))) {
+        if (!entrada.isFile() || !entrada.name.endsWith(".sema")) {
+            continue;
+        }
+        const origemArquivo = path.join(origem, entrada.name);
+        const destinoArquivo = path.join(destino, entrada.name);
+        const jaExiste = await caminhoExiste(destinoArquivo);
+        if (jaExiste && preservarExistentes) {
+            preservados.push(entrada.name);
+            continue;
+        }
+        await writeFile(destinoArquivo, await readFile(origemArquivo, "utf8"), "utf8");
+        criados.push(entrada.name);
+    }
+    return {
+        sucesso: true,
+        origem,
+        destino,
+        criados,
+        preservados,
+    };
+}
 function obterArgumentos() {
     const [, , comando, ...resto] = process.argv;
     return { comando: comando, resto };
@@ -430,6 +490,7 @@ function ajuda() {
             "sema exemplos-prompt-ia",
             "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--json]",
             "sema sync-ai-entrypoints [--json]",
+            "sema instalar-exemplos [--json]",
         ]),
         "",
         renderizarSecaoAscii("Operacional", [
@@ -3177,7 +3238,34 @@ public:
         ];
     }
     await escreverArquivos(cwd, arquivos);
+    const exemplos = await materializarExemplosOficiais(cwd, true);
+    if (!exemplos.sucesso) {
+        console.error(exemplos.erro);
+        return 1;
+    }
     console.log(`Projeto Sema inicializado com template ${template}.`);
+    console.log(`Exemplos oficiais sincronizados em ${exemplos.destino} (${exemplos.criados.length} criados, ${exemplos.preservados.length} preservados).`);
+    return 0;
+}
+async function comandoInstalarExemplos(emJson) {
+    const resultado = await materializarExemplosOficiais(process.cwd(), true);
+    const payload = {
+        comando: "instalar-exemplos",
+        ...resultado,
+    };
+    if (emJson) {
+        console.log(JSON.stringify(payload, null, 2));
+        return resultado.sucesso ? 0 : 1;
+    }
+    if (!resultado.sucesso) {
+        console.error(resultado.erro ?? "Falha ao instalar exemplos oficiais.");
+        return 1;
+    }
+    console.log("Exemplos oficiais sincronizados");
+    console.log(`- Origem: ${resultado.origem}`);
+    console.log(`- Destino: ${resultado.destino}`);
+    console.log(`- Criados: ${resultado.criados.length}`);
+    console.log(`- Preservados: ${resultado.preservados.length}`);
     return 0;
 }
 async function comandoValidar(entrada) {
@@ -3639,10 +3727,26 @@ async function comandoStarterIa() {
 }
 async function comandoSyncAiEntrypoints(emJson) {
     const resumoProjeto = await gerarResumoProjetoIa(process.cwd(), undefined, true);
+    const exemplos = await materializarExemplosOficiais(resumoProjeto.baseProjeto, true);
+    if (!exemplos.sucesso) {
+        if (emJson) {
+            console.log(JSON.stringify({
+                comando: "sync-ai-entrypoints",
+                sucesso: false,
+                baseProjeto: resumoProjeto.baseProjeto,
+                erro: exemplos.erro,
+                exemplos,
+            }, null, 2));
+            return 1;
+        }
+        console.error(exemplos.erro);
+        return 1;
+    }
     const indexJson = JSON.parse(await readFile(path.join(resumoProjeto.pastaSaida, "SEMA_INDEX.json"), "utf8"));
     const artefatos = [...new Set([
             ...ARQUIVOS_CANONICOS_IA_RAIZ,
             ...resumoProjeto.artefatos,
+            "exemplos",
         ])];
     if (emJson) {
         console.log(JSON.stringify({
@@ -3652,6 +3756,7 @@ async function comandoSyncAiEntrypoints(emJson) {
             pastaSaida: resumoProjeto.pastaSaida,
             artefatos,
             entradaCanonica: indexJson.entradaCanonica,
+            exemplos,
         }, null, 2));
         return 0;
     }
@@ -3662,6 +3767,7 @@ async function comandoSyncAiEntrypoints(emJson) {
     console.log(`IA pequena: ${indexJson.entradaCanonica.porCapacidade.pequena.join(" -> ")}`);
     console.log(`IA media: ${indexJson.entradaCanonica.porCapacidade.media.join(" -> ")}`);
     console.log(`IA grande: ${indexJson.entradaCanonica.porCapacidade.grande.join(" -> ")}`);
+    console.log(`Exemplos oficiais: ${exemplos.criados.length} criados, ${exemplos.preservados.length} preservados em ${exemplos.destino}`);
     return 0;
 }
 async function comandoAjudaIa() {
@@ -3690,6 +3796,7 @@ async function comandoAjudaIa() {
     console.log(renderizarSecaoAscii("Fluxo recomendado", [
         "Use `sema starter-ia` para um texto curto de onboarding.",
         "Use `sema sync-ai-entrypoints` para regenerar `SEMA_BRIEF.*` e `SEMA_INDEX.json` na raiz.",
+        "Use `sema instalar-exemplos` para materializar `exemplos/` oficiais sem sobrescrever arquivos locais.",
         "Use `sema resumo <arquivo> --micro --para onboarding` para IA pequena.",
         "Use `sema prompt-curto <arquivo> --curto --para mudanca` para colar contexto em modelo gratuito.",
         "Use `sema prompt-ia`, `sema prompt-ia-ui`, `sema prompt-ia-react` e `sema prompt-ia-sema-primeiro` conforme a tarefa.",
@@ -4201,6 +4308,9 @@ async function principal() {
         case "sync-ai-entrypoints":
             codigoSaida = await comandoSyncAiEntrypoints(possuiFlag(resto, "--json"));
             break;
+        case "instalar-exemplos":
+            codigoSaida = await comandoInstalarExemplos(possuiFlag(resto, "--json"));
+            break;
         case "resumo":
             codigoSaida = await comandoResumo(posicionais[0], resto, possuiFlag(resto, "--json"));
             break;