dd-harness 0.10.0 → 0.11.0

package/dist/index.js

@@ -2,6 +2,15 @@
 import { spawn } from "node:child_process";
 import { access } from "node:fs/promises";
 import { join } from "node:path";
+// DEP0190: Node imprime esse warning direto no stderr no instante em que
+// `spawn(..., { shell: true })` recebe um array de args — de forma sincrona, ANTES de
+// qualquer listener rodar, entao filtrar dentro de um `process.on("warning")` normal nao
+// bloqueia a impressao (so o listener default e que imprime, e ele continua registrado
+// junto do nosso). Por isso remover o listener default e a unica forma de suprimir.
+// Real quando algum arg vem de fora, mas `instalaMcp` (mais abaixo) so passa literais
+// fixos — sem isto o wizard de `start` mostrava um "DeprecationWarning" no meio do fluxo
+// que parecia falha para quem esta vendo por dentro pela primeira vez.
+process.removeAllListeners("warning");
 import { termosDaConsulta } from "./argv.js";
 import { check, status } from "./check.js";
 import { CAMINHO_CONFIG, guardaConfigDaMaquina, guardaToken, leConfigDaMaquina, leConfigDoRepo, leToken, } from "./config.js";
@@ -87,14 +96,44 @@ const API_PADRAO = "https://dd-harness.vercel.app";
  */
 function instalaMcp() {
     return new Promise((resolve) => {
+        // stdio "inherit": o usuario ve o download do npx acontecendo (pode levar alguns
+        // segundos) e, se falhar, ve POR QUE — em vez do "nao consegui" mudo que nao dava
+        // pista nenhuma para diagnosticar. O DEP0190 que isto dispara e suprimido no topo
+        // do arquivo (`process.removeAllListeners("warning")`).
         const p = spawn("npx", ["-y", "dd-harness-mcp", "--help"], {
             shell: process.platform === "win32",
-            stdio: "ignore",
+            stdio: "inherit",
         });
-        p.on("exit", (code) => resolve(code === 0));
-        p.on("error", () => resolve(false));
+        p.on("exit", (code) => resolve({ ok: code === 0, erro: code === 0 ? undefined : `código de saída ${code}` }));
+        p.on("error", (e) => resolve({ ok: false, erro: e.message }));
     });
 }
+/**
+ * `start` e o primeiro comando de quem esta chegando — rodar desatualizado aqui e o
+ * peor lugar para isso: foi assim que a pre-instalacao do MCP (esta mesma funcao,
+ * mais abaixo) ficou muda numa versao anterior que nao tinha essa etapa ainda.
+ * Falha de rede aqui nunca trava o wizard — so segue sem avisar.
+ */
+async function versaoDesatualizada() {
+    try {
+        const atual = await versao();
+        const controle = new AbortController();
+        const corte = setTimeout(() => controle.abort(), 3000);
+        const resp = await fetch("https://registry.npmjs.org/dd-harness/latest", {
+            signal: controle.signal,
+        });
+        clearTimeout(corte);
+        if (!resp.ok)
+            return null;
+        const { version: ultima } = (await resp.json());
+        if (!ultima || ultima === atual)
+            return null;
+        return { atual, ultima };
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Tenta abrir o navegador padrao. Nunca lanca — falhar em abrir nao pode travar o
  * wizard, so degrada para "aqui esta a URL, abra voce mesmo".
@@ -136,6 +175,15 @@ async function comandoStart() {
         // ENOENT: exatamente o caso esperado, segue.
     }
     console.log("Iniciando o dd-harness nesta pasta.\n");
+    // 0. Versao. `start` e o comando de bootstrap: rodar velho aqui significa perder
+    // correcoes deste proprio wizard sem nenhum aviso (foi o que aconteceu com a
+    // pre-instalacao do MCP, passo 5.5 abaixo, numa versao anterior a ela existir).
+    const desatualizado = await versaoDesatualizada();
+    if (desatualizado) {
+        console.log(`AVISO: você está na versão ${desatualizado.atual}, e a mais recente é ` +
+            `${desatualizado.ultima}. Rode \`npm install -g dd-harness@latest\` e comece de ` +
+            "novo — start segue mesmo assim, mas pode faltar correção.\n");
+    }
     // 1. Credencial. Sem ela nada do resto e possivel — nem listar tenant.
     let token = await leToken(API_PADRAO);
     if (!token) {
@@ -204,11 +252,12 @@ async function comandoStart() {
     }
     if (mcp.ok) {
         console.log("\nInstalando o servidor dd-harness-mcp (primeira vez pode demorar um pouco)...");
-        const instalou = await instalaMcp();
+        const { ok: instalou, erro: erroInstalacao } = await instalaMcp();
         console.log(instalou
             ? "dd-harness-mcp instalado — a próxima sessão do Claude Code conecta na hora."
-            : "AVISO: não consegui pré-instalar dd-harness-mcp. A primeira conexão do Claude " +
-                "Code pode demorar ou falhar; se falhar, abra uma nova sessão e tente de novo.");
+            : `AVISO: não consegui pré-instalar dd-harness-mcp (${erroInstalacao}). A primeira ` +
+                "conexão do Claude Code pode demorar ou falhar; se falhar, abra uma nova sessão " +
+                "e tente de novo.");
     }
     // 6. AGENTS.md — so quem usa outra ferramenta alem do Claude Code precisa.
     const outraFerramenta = await pergunta("\nVai abrir este projeto em Codex, Cursor ou outra ferramenta além do Claude " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dd-harness",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "description": "Cliente do dd-harness: politica no inicio da sessao, e memoria por busca — nada em disco. Sem dependencia: fetch, crypto e fs sao do Node.",
   "license": "UNLICENSED",