@semacode/cli 1.5.0 → 1.5.2

package/dist/index.js

@@ -2,6 +2,7 @@
 import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import pacoteCli from "../package.json" with { type: "json" };
 import { compilarCodigo, formatarCodigo, formatarDiagnosticos, lerArquivoTexto, temErros, } from "@sema/nucleo";
@@ -321,6 +322,7 @@ Comandos uteis da CLI para esse fluxo:
 `;
 const DIRETORIO_CLI_ATUAL = path.dirname(fileURLToPath(import.meta.url));
 const VERSAO_CLI = pacoteCli.version;
+const requireRuntimeCli = createRequire(import.meta.url);
 const ARQUIVOS_CANONICOS_IA_RAIZ = [
     "llms.txt",
     "SEMA_BRIEF.md",
@@ -338,6 +340,16 @@ const DOCUMENTOS_SUPORTE_IA = [
     "docs/sintaxe.md",
     "docs/cli.md",
 ];
+function resolverImportadorNodeOpcional(especificador) {
+    try {
+        return requireRuntimeCli.resolve(especificador);
+    }
+    catch {
+        return undefined;
+    }
+}
+const TSX_IMPORTADOR_CLI = resolverImportadorNodeOpcional("tsx");
+const TSX_EXECUTOR_CLI = resolverImportadorNodeOpcional("tsx/cli");
 function obterArgumentos() {
     const [, , comando, ...resto] = process.argv;
     return { comando: comando, resto };
@@ -513,25 +525,172 @@ function comandoDisponivel(comando, argumentos = ["--version"]) {
     const execucao = spawnSync(comando, argumentos, { stdio: "ignore", shell: process.platform === "win32" });
     return (execucao.status ?? 1) === 0;
 }
-async function comandoDoctor() {
-    const checks = [
-        { nome: "node", ok: comandoDisponivel("node") },
-        { nome: "npm", ok: comandoDisponivel("npm") },
-        { nome: "python", ok: comandoDisponivel("python") || comandoDisponivel("py") },
-        { nome: "dotnet", ok: comandoDisponivel("dotnet") },
-        { nome: "go", ok: comandoDisponivel("go") },
-        { nome: "cargo", ok: comandoDisponivel("cargo") },
-        { nome: "java", ok: comandoDisponivel("java") },
-        { nome: "code", ok: comandoDisponivel("code", ["--version"]) },
+function resolverExecucaoPython() {
+    if (comandoDisponivel("python")) {
+        return { comando: "python", argumentosBase: [], rotulo: "python" };
+    }
+    if (comandoDisponivel("py")) {
+        return { comando: "py", argumentosBase: [], rotulo: "py" };
+    }
+    return undefined;
+}
+function resolverExecucaoPytest() {
+    if (comandoDisponivel("pytest")) {
+        return { comando: "pytest", argumentosBase: [], rotulo: "pytest" };
+    }
+    const python = resolverExecucaoPython();
+    if (python && comandoDisponivel(python.comando, [...python.argumentosBase, "-m", "pytest", "--version"])) {
+        return {
+            comando: python.comando,
+            argumentosBase: [...python.argumentosBase, "-m", "pytest"],
+            rotulo: `${python.rotulo} -m pytest`,
+        };
+    }
+    return undefined;
+}
+function criarItemDependencia(nome, ok, detalhe, obrigatoria = true) {
+    return { nome, ok, detalhe, obrigatoria };
+}
+function coletarDependenciasDoctor() {
+    const python = resolverExecucaoPython();
+    const pytest = resolverExecucaoPytest();
+    return [
+        {
+            comando: "base",
+            itens: [
+                criarItemDependencia("node", comandoDisponivel("node"), "runtime principal da CLI"),
+                criarItemDependencia("npm", comandoDisponivel("npm"), "instalacao, pack e publish"),
+                criarItemDependencia("python", Boolean(python), python?.rotulo ? `resolvido via ${python.rotulo}` : "python ou py"),
+                criarItemDependencia("dotnet", comandoDisponivel("dotnet"), "ecosistema ASP.NET", false),
+                criarItemDependencia("go", comandoDisponivel("go"), "ecosistema Go", false),
+                criarItemDependencia("cargo", comandoDisponivel("cargo"), "ecosistema Rust", false),
+                criarItemDependencia("java", comandoDisponivel("java"), "ecosistema Java/Spring", false),
+                criarItemDependencia("code", comandoDisponivel("code", ["--version"]), "VS Code / extensao", false),
+            ],
+        },
+        {
+            comando: "verificar/typescript",
+            itens: [
+                criarItemDependencia("node", comandoDisponivel("node"), "execucao do runner TypeScript"),
+                criarItemDependencia("tsx", Boolean(TSX_EXECUTOR_CLI ?? TSX_IMPORTADOR_CLI), TSX_EXECUTOR_CLI
+                    ? `runner resolvido em ${TSX_EXECUTOR_CLI}`
+                    : TSX_IMPORTADOR_CLI
+                        ? `importador resolvido em ${TSX_IMPORTADOR_CLI}`
+                        : "tsx nao foi encontrado junto da CLI"),
+            ],
+        },
+        {
+            comando: "verificar/javascript",
+            itens: [
+                criarItemDependencia("node", comandoDisponivel("node"), "node --test"),
+            ],
+        },
+        {
+            comando: "verificar/python",
+            itens: [
+                criarItemDependencia("python", Boolean(python), python?.rotulo ? `resolvido via ${python.rotulo}` : "python ou py"),
+                criarItemDependencia("pytest", Boolean(pytest), pytest?.rotulo ? `runner resolvido via ${pytest.rotulo}` : "instale pytest ou exponha python -m pytest"),
+            ],
+        },
+        {
+            comando: "verificar/lua",
+            itens: [
+                criarItemDependencia("lua", comandoDisponivel("lua", ["-v"]), "runner de testes Lua"),
+            ],
+        },
     ];
+}
+function avaliarPreflightVerificacao(configuracoesAlvo) {
+    const dependencias = [];
+    const faltando = [];
+    const registrar = (comando, itens) => {
+        dependencias.push({ comando, itens });
+        for (const item of itens) {
+            if (item.obrigatoria && !item.ok) {
+                faltando.push({
+                    comando,
+                    nome: item.nome,
+                    detalhe: item.detalhe,
+                });
+            }
+        }
+    };
+    registrar("base", [
+        criarItemDependencia("node", comandoDisponivel("node"), "runtime principal da CLI"),
+        criarItemDependencia("npm", comandoDisponivel("npm"), "instalacao e empacotamento"),
+    ]);
+    for (const configuracao of configuracoesAlvo) {
+        if (configuracao.framework !== "base") {
+            continue;
+        }
+        if (configuracao.alvo === "typescript") {
+            registrar("verificar/typescript", [
+                criarItemDependencia("node", comandoDisponivel("node"), "execucao do runner TypeScript"),
+                criarItemDependencia("tsx", Boolean(TSX_EXECUTOR_CLI ?? TSX_IMPORTADOR_CLI), TSX_EXECUTOR_CLI
+                    ? `runner resolvido em ${TSX_EXECUTOR_CLI}`
+                    : TSX_IMPORTADOR_CLI
+                        ? `importador resolvido em ${TSX_IMPORTADOR_CLI}`
+                        : "tsx nao foi encontrado junto da CLI"),
+            ]);
+            continue;
+        }
+        if (configuracao.alvo === "javascript") {
+            registrar("verificar/javascript", [
+                criarItemDependencia("node", comandoDisponivel("node"), "node --test"),
+            ]);
+            continue;
+        }
+        if (configuracao.alvo === "python") {
+            const python = resolverExecucaoPython();
+            const pytest = resolverExecucaoPytest();
+            registrar("verificar/python", [
+                criarItemDependencia("python", Boolean(python), python?.rotulo ? `resolvido via ${python.rotulo}` : "python ou py"),
+                criarItemDependencia("pytest", Boolean(pytest), pytest?.rotulo ? `runner resolvido via ${pytest.rotulo}` : "instale pytest ou exponha python -m pytest"),
+            ]);
+            continue;
+        }
+        if (configuracao.alvo === "lua") {
+            registrar("verificar/lua", [
+                criarItemDependencia("lua", comandoDisponivel("lua", ["-v"]), "runner de testes Lua"),
+            ]);
+        }
+    }
+    return {
+        ok: faltando.length === 0,
+        dependencias,
+        faltando,
+    };
+}
+function imprimirDependenciasDoctor(dependencias) {
+    for (const dependencia of dependencias) {
+        console.log(`\n[${dependencia.comando}]`);
+        for (const item of dependencia.itens) {
+            const sufixo = item.detalhe ? ` (${item.detalhe})` : "";
+            console.log(`- ${item.nome}: ${item.ok ? "ok" : item.obrigatoria ? "faltando" : "ausente"}${sufixo}`);
+        }
+    }
+}
+function imprimirPreflightVerificacao(preflight) {
+    console.error(renderizarCaixaAscii([
+        "Preflight de verificacao falhou",
+        "a CLI sabe o que falta antes de gerar e testar",
+    ]));
+    for (const item of preflight.faltando) {
+        const detalhe = item.detalhe ? ` (${item.detalhe})` : "";
+        console.error(`- ${item.comando}: ${item.nome} faltando${detalhe}`);
+    }
+    console.error("Rode `sema doctor` para ver as dependencias por comando.");
+}
+async function comandoDoctor() {
+    const dependencias = coletarDependenciasDoctor();
     console.log(renderizarCaixaAscii([
         "Sema doctor",
-        "checa a toolchain minima para validar, gerar e operar a CLI",
+        "checa a toolchain minima e as dependencias reais por comando",
     ]));
-    for (const check of checks) {
-        console.log(`- ${check.nome}: ${check.ok ? "ok" : "ausente"}`);
-    }
-    const obrigatorios = checks.filter((check) => ["node", "npm"].includes(check.nome));
+    imprimirDependenciasDoctor(dependencias);
+    const obrigatorios = dependencias
+        .find((dependencia) => dependencia.comando === "base")
+        ?.itens.filter((item) => item.obrigatoria) ?? [];
     return obrigatorios.every((check) => check.ok) ? 0 : 1;
 }
 function validarCompatibilidadeFramework(alvo, framework) {
@@ -770,8 +929,17 @@ function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
             }
             return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
         }
-        const execucao = spawnSync("node", ["--import", "tsx", path.join(baseSaida, arquivoTeste)], {
+        if (!TSX_EXECUTOR_CLI) {
+            return {
+                codigoSaida: 1,
+                quantidadeTestes,
+                saidaPadrao: "",
+                saidaErro: "Nao foi possivel localizar o runner tsx junto da CLI para executar testes TypeScript.",
+            };
+        }
+        const execucao = spawnSync("node", [TSX_EXECUTOR_CLI, arquivoTeste], {
             stdio: silencioso ? "pipe" : "inherit",
+            cwd: baseSaida,
             encoding: silencioso ? "utf8" : undefined,
         });
         return {
@@ -808,6 +976,14 @@ function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
             }
             return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
         }
+        if (!comandoDisponivel("lua", ["-v"])) {
+            return {
+                codigoSaida: 1,
+                quantidadeTestes,
+                saidaPadrao: "",
+                saidaErro: "Nao foi possivel localizar o runner lua para executar os testes gerados.",
+            };
+        }
         const execucao = spawnSync("lua", [arquivoTeste], {
             stdio: silencioso ? "pipe" : "inherit",
             cwd: baseSaida,
@@ -828,10 +1004,20 @@ function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
         }
         return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
     }
-    const execucao = spawnSync("pytest", [arquivoTeste], {
+    const pytest = resolverExecucaoPytest();
+    if (!pytest) {
+        return {
+            codigoSaida: 1,
+            quantidadeTestes,
+            saidaPadrao: "",
+            saidaErro: "Nao foi possivel localizar pytest. Instale pytest ou exponha python -m pytest.",
+        };
+    }
+    const execucao = spawnSync(pytest.comando, [...pytest.argumentosBase, arquivoTeste], {
         stdio: silencioso ? "pipe" : "inherit",
         cwd: baseSaida,
         encoding: silencioso ? "utf8" : undefined,
+        shell: process.platform === "win32" && pytest.comando === "pytest",
     });
     return {
         codigoSaida: execucao.status ?? 1,
@@ -3125,7 +3311,7 @@ async function comandoDrift(entrada, args, emJson, cwd = process.cwd()) {
     if (persistenciaDivergente.length > 0) {
         console.log("- Persistencia que pede revisao:");
         for (const item of persistenciaDivergente.slice(0, 8)) {
-            console.log(`  - ${item.modulo}.${item.task} :: ${item.alvo} :: ${item.status} :: compat=${item.compatibilidade}`);
+            console.log(`  - ${item.modulo}.${item.task} :: ${item.alvo} :: ${item.status} :: categoria=${item.categoriaPersistencia} :: compat=${item.compatibilidade}`);
         }
     }
     const semImpl = resultado.tasks.filter((task) => task.semImplementacao);
@@ -3757,6 +3943,11 @@ async function comandoVerificar(entrada, baseSaida, cwd = process.cwd()) {
         console.error(incompatibilidade.incompatibilidade);
         return 1;
     }
+    const preflight = avaliarPreflightVerificacao(configuracoesAlvo);
+    if (!preflight.ok) {
+        imprimirPreflightVerificacao(preflight);
+        return 1;
+    }
     const resumos = [];
     for (const modulo of modulos) {
         const ir = garantirIr(modulo.resultado, modulo.caminho);
@@ -3824,6 +4015,18 @@ async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd()) {
         }, null, 2));
         return 1;
     }
+    const preflight = avaliarPreflightVerificacao(configuracoesAlvo);
+    if (!preflight.ok) {
+        console.log(JSON.stringify({
+            comando: "verificar",
+            sucesso: false,
+            erro: "Dependencias obrigatorias ausentes para executar a verificacao.",
+            preflight,
+            modulos: [],
+            totais: { modulos: 0, alvos: 0, arquivos: 0, testes: 0 },
+        }, null, 2));
+        return 1;
+    }
     const resumos = [];
     let codigoSaida = 0;
     for (const modulo of modulos) {