dd-harness 0.21.0 → 0.22.0

package/dist/index.js

@@ -180,6 +180,10 @@ async function comandoFase(argv) {
  * primeira conexao do Claude Code. Sem isto, a primeira instalacao acontecia so quando
  * o host tentava conectar ao servidor MCP, e o handshake tem timeout curto demais para
  * esperar o download: a sessao real via `CONNECTION_CLOSED` em vez de "instalando".
+ *
+ * Roda em TODO `start`, nao so no primeiro: e tambem o ponto em que o cache do npx e
+ * renovado para a versao mais recente. Um projeto ja configurado que roda `start` de novo
+ * sai dali com CLI e MCP frescos, sem ninguem precisar lembrar de atualizar nada.
  */
 function instalaMcp() {
     return new Promise((resolve) => {
@@ -187,7 +191,14 @@ function instalaMcp() {
         // 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"], {
+        //
+        // `@latest` EXPLICITO, e nao `dd-harness-mcp` pelado: sem a tag, o npx serve a copia
+        // que ja estiver no cache dele e nem consulta o registro. Medido na rodada 006 — a
+        // cobaia rodou uma sessao inteira contra um MCP defasado sem nada denunciar. O
+        // `.mcp.json` continua declarando o pacote SEM versao, de proposito: o que precisa
+        // estar fresco e o cache, e fixar versao no arquivo obrigaria a reescrever config em
+        // todo repositorio a cada publicacao.
+        const p = spawn("npx", ["-y", "dd-harness-mcp@latest", "--help"], {
             shell: process.platform === "win32",
             stdio: "inherit",
         });
@@ -221,6 +232,32 @@ async function versaoDesatualizada() {
         return null;
     }
 }
+/**
+ * Instala a versao mais nova do CLI globalmente, de dentro do proprio wizard.
+ *
+ * Ate aqui o `start` so AVISAVA e mandava o usuario rodar `npm i -g` e recomecar — e
+ * "comece de novo" no meio de um wizard e o tipo de instrucao que ninguem segue. A
+ * rodada 006 mostrou o custo: a sessao inteira rodou contra um CLI defasado, com o
+ * relatorio registrando "ja instalado, nao atualizado" como se fosse normal.
+ *
+ * O binario EM EXECUCAO continua sendo o antigo ate este processo terminar — nao ha como
+ * trocar codigo de baixo de si mesmo. Isso e seguro aqui porque o que resta do wizard so
+ * escreve configuracao (JSON e markdown), nada que dependa de correcao nova; e do
+ * proximo comando em diante tudo ja e a versao nova.
+ *
+ * Nunca lanca: falhar em atualizar nao pode travar o `start`. Sem permissao para escrever
+ * no diretorio global (o caso mais comum), o wizard segue e o aviso continua valendo.
+ */
+function atualizaCli(ultima) {
+    return new Promise((resolve) => {
+        const p = spawn("npm", ["install", "-g", `dd-harness@${ultima}`], {
+            shell: process.platform === "win32",
+            stdio: "inherit",
+        });
+        p.on("exit", (code) => resolve(code === 0));
+        p.on("error", () => resolve(false));
+    });
+}
 /**
  * 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".
@@ -271,9 +308,14 @@ async function comandoStart() {
     // 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");
+        console.log(`Atualizando o dd-harness: ${desatualizado.atual} → ${desatualizado.ultima}...`);
+        const atualizou = await atualizaCli(desatualizado.ultima);
+        console.log(atualizou
+            ? `Pronto — ${desatualizado.ultima} instalada. O wizard segue na ${desatualizado.atual} ` +
+                "(o binário em execução não troca sozinho); do próximo comando em diante, a nova.\n"
+            : `Não consegui atualizar (sem permissão de escrita global?). Você está na ` +
+                `${desatualizado.atual} e a mais recente é ${desatualizado.ultima} — rode ` +
+                "`npm install -g dd-harness@latest` quando puder. O start segue assim mesmo.\n");
     }
     // 1. Credencial. Sem ela nada do resto e possivel — nem listar tenant.
     // O estado aparece SEMPRE, mesmo quando ja existe credencial: antes o passo era
@@ -366,7 +408,8 @@ async function comandoStart() {
         }[mcp.estado]);
     }
     if (mcp.ok) {
-        console.log("\nInstalando o servidor dd-harness-mcp (primeira vez pode demorar um pouco)...");
+        console.log("\nInstalando a versão mais recente do servidor dd-harness-mcp " +
+            "(a primeira vez pode demorar um pouco)...");
         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."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dd-harness",
-  "version": "0.21.0",
+  "version": "0.22.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",