@danhachuel/leadmaster 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -6,6 +6,32 @@ O formato é baseado no [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.
 A etiqueta visual de versão usa patch de dois dígitos (ex.: `0.1.00`); o registry NPM
 normaliza para a forma canônica (ex.: `0.1.0`).
 
+## [0.1.09] — 2026-11-08
+
+### Corrigido
+
+- **Encerramento silencioso do launcher no MobaXterm (Windows)** — o app morria
+  sozinho por sinais espúrios (perda de foco/minimização) e por EPIPE ao fechar o
+  terminal. Correções no `scripts/cli.mjs`:
+  - **Keep-alive:** `setInterval(() => {}, 1000);` mantém o event loop ativo mesmo
+    sem I/O de console.
+  - **Absorção de sinais no Windows:** `SIGINT`/`SIGHUP` agora são apenas logados
+    (`[LAUNCHER] Sinal absorvido no Windows`) e **não** encerram o launcher;
+    `SIGTERM`/`SIGBREAK` (Ctrl+Break) seguem como paradas legítimas. No
+    Linux/macOS o comportamento gracioso é mantido.
+  - **Guarda da consola (anti-EPIPE):** `guardConsoleStream()` ignora erros `EPIPE`
+    no `'error'` dos streams e espelha toda a saída em
+    `storage/logs/launcher_console.log`; escrita original com exceção retorna
+    silenciosamente. Aplicada a `process.stdout`/`process.stderr` antes de
+    qualquer escrita do launcher.
+  - Isolamento mantido: worker Python com `detached: true` + `windowsHide: true`
+    (`CREATE_NEW_PROCESS_GROUP`).
+- **AGENTS.md:** nova seção *🚨 REGRA INVIOLÁVEL: ARQUITETURA DO LAUNCHER* com as
+  4 proteções obrigatórias.
+- **Gate de regressão:** `backend/tests/test_launcher_protections.py` falha se
+  keep-alive, absorção de sinais, `guardConsoleStream` ou isolamento forem
+  removidos do launcher.
+
 ## [0.1.08] — 2026-11-08
 
 ### Adicionado

package/backend/tests/test_launcher_protections.py

@@ -0,0 +1,46 @@
+"""Gate de regressão da arquitetura do launcher (scripts/cli.mjs).
+
+Lê o launcher e falha se qualquer proteção contra encerramento silencioso no
+Windows (MobaXterm) for removida:
+
+1. Keep-alive com setInterval (event loop ativo sem I/O de console);
+2. Absorção de SIGINT/SIGHUP no Windows (apenas log, sem encerrar);
+3. Função guardConsoleStream (anti-EPIPE com espelho em arquivo de log);
+4. Isolamento do worker Python (detached: true / CREATE_NEW_PROCESS_GROUP).
+"""
+
+from pathlib import Path
+
+CAMINHO = Path(__file__).resolve().parents[2] / "scripts" / "cli.mjs"
+
+
+def _conteudo() -> str:
+    assert CAMINHO.exists(), f"launcher não encontrado em {CAMINHO}"
+    return CAMINHO.read_text(encoding="utf-8")
+
+
+class TestLauncherProtections:
+    def test_keepalivo(self):
+        assert "setInterval(() => {}, 1000)" in _conteudo()
+
+    def test_absorcao_de_sinais_no_windows(self):
+        c = _conteudo()
+        assert "SIGINT" in c and "SIGTERM" in c and "SIGHUP" in c
+        assert "absorvido" in c
+
+    def test_guarda_anti_epipe(self):
+        c = _conteudo()
+        assert "guardConsoleStream" in c
+        assert "EPIPE" in c
+        assert "launcher_console.log" in c
+
+    def test_isolamento_do_worker(self):
+        c = _conteudo()
+        assert "detached: true" in c
+        assert "windowsHide: true" in c
+
+    def test_sigterm_nao_absorvido(self):
+        # SIGTERM/SIGBREAK são paradas legítimas: sempre encerram.
+        c = _conteudo()
+        assert "SIGTERM" in c and "SIGBREAK" in c
+        assert "naoAbsorver" in c

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/leadmaster",
-  "version": "0.1.08",
+  "version": "0.1.09",
   "description": "SaaS local de prospecção e automação: CRM, extratores de leads e agentes de IA — 100% local.",
   "license": "MIT",
   "author": "Dan Hachuel",

package/scripts/cli.mjs

@@ -23,7 +23,7 @@
  */
 
 import { spawn, spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, appendFileSync } from 'node:fs';
 import { homedir, platform } from 'node:os';
 import net from 'node:net';
 import path from 'node:path';
@@ -282,6 +282,36 @@ async function procurarInstanciaAtiva(portaInicial, maxTentativas = 10) {
   return null;
 }
 
+/**
+ * Guarda da consola (anti-EPIPE): se o terminal for fechado (MobaXterm, VS
+ * Code), escrever em stdout/stderr gera EPIPE — que o Node trataria como
+ * uncaughtException, matando o launcher. Esta guarda:
+ *  - ignora erros com code EPIPE no evento 'error' do stream;
+ *  - espelha toda a saída em storage/logs/launcher_console.log;
+ *  - se a escrita original falhar, retorna true silenciosamente.
+ * NUNCA REMOVER (regra inviolável do AGENTS.md).
+ */
+function guardConsoleStream(stream, logFile) {
+  stream.on('error', (err) => {
+    if (err && err.code === 'EPIPE') return; // terminal fechado: ignora
+    return; // demais erros de consola nunca devem derrubar o launcher
+  });
+  const escritaOriginal = stream.write.bind(stream);
+  stream.write = (chunk, encoding, callback) => {
+    try {
+      appendFileSync(logFile, typeof chunk === 'string' ? chunk : Buffer.from(chunk));
+    } catch {
+      /* espelho de log é best-effort */
+    }
+    try {
+      return escritaOriginal(chunk, encoding, callback);
+    } catch {
+      return true; // escrita silenciosa sem exceção
+    }
+  };
+  return stream;
+}
+
 // ---------------------------------------------------------------------------
 // Comandos
 // ---------------------------------------------------------------------------
@@ -416,9 +446,6 @@ function cmdStart(args) {
         child.kill('SIGTERM');
       }
     };
-    process.on('SIGINT', () => { stop(); process.exit(0); });
-    process.on('SIGTERM', () => { stop(); process.exit(0); });
-    if (platform() === 'win32') process.on('SIGHUP', () => { stop(); process.exit(0); });
 
     console.log(`→ Subindo servidor local em ${url} ...`);
     const health = await waitForHealth(porta, 120000);
@@ -428,11 +455,39 @@ function cmdStart(args) {
       stop();
       process.exit(1);
     }
+
+    // -------------------------------------------------------------------------
+    // Sinais (regra inviolável do AGENTS.md)
+    // MobaXterm envia SIGINT/SIGHUP espúrios (perda de foco, minimização): no
+    // Windows esses sinais são APENAS ABSORVIDOS (log), sem encerrar o launcher,
+    // para o app não morrer sozinho. SIGTERM e SIGBREAK são paradas legítimas e
+    // sempre encerram. No Linux/macOS, SIGINT/SIGHUP mantêm o stop gracioso.
+    // -------------------------------------------------------------------------
+    const ehWindows = platform() === 'win32';
+    const naoAbsorver = () => { stop(); process.exit(0); };
+    const absorverWindows = (nome) => () => {
+      console.log(`[LAUNCHER] Sinal absorvido no Windows (${nome}) — o LeadMaster continua rodando.`);
+    };
+    process.on('SIGINT', ehWindows ? absorverWindows('SIGINT') : naoAbsorver);
+    process.on('SIGHUP', ehWindows ? absorverWindows('SIGHUP') : naoAbsorver);
+    process.on('SIGTERM', naoAbsorver);
+    if (ehWindows) {
+      // SIGBREAK (Ctrl+Break): parada legítima também no Windows.
+      process.on('SIGBREAK', naoAbsorver);
+    }
+
+    // Keep-alive: mantém o event loop ativo mesmo sem I/O de console (MobaXterm
+    // minimizado / sem stream ativo) — evita o encerramento silencioso.
+    setInterval(() => {}, 1000);
+
     console.log(`✓ LeadMaster no ar em ${url} (dados: ${home})`);
     console.log('');
     console.log(`ℹ Abra ${url} no navegador quando quiser — o LeadMaster nunca abre janelas sozinho.`);
-    console.log('');
-    console.log('Pressione Ctrl+C para encerrar.');
+    console.log(
+      ehWindows
+        ? 'ℹ Para encerrar: Ctrl+Break ou feche a janela (Ctrl+C é absorvido no Windows contra sinais espúrios do MobaXterm).'
+        : 'ℹ Para encerrar: Ctrl+C.',
+    );
   })().catch((err) => {
     console.error('✗ Erro inesperado ao iniciar:', err && err.message ? err.message : err);
     process.exit(1);
@@ -498,6 +553,15 @@ const rawArgs = process.argv.slice(2);
 const args = parseArgs(rawArgs);
 const command = args._[0] || 'start';
 
+// Guarda da consola (anti-EPIPE) aplicada ANTES de qualquer escrita do
+// launcher: espelha stdout/stderr em storage/logs/launcher_console.log e
+// ignora EPIPE (terminal fechado) — regra inviolável do AGENTS.md.
+const homeLauncher = resolveHome(args);
+const LOG_DIR = path.join(homeLauncher, 'storage', 'logs');
+mkdirSync(LOG_DIR, { recursive: true });
+const CONSOLE_LOG = path.join(LOG_DIR, 'launcher_console.log');
+[process.stdout, process.stderr].forEach((stream) => guardConsoleStream(stream, CONSOLE_LOG));
+
 switch (command) {
   case 'install': cmdInstall(args); break;
   case 'start': cmdStart(args); break;