terminal-smart-cli 0.37.0 → 0.38.0

package/lib/browser.js

@@ -62,8 +62,13 @@ class BrowserSession {
     const u = String(url || '').trim();
     if (!/^https?:\/\//i.test(u)) throw new Error('só URLs http(s) são permitidas (sem file://, data: etc).');
     if (/^[a-z][a-z0-9+.-]*:\/\/[^\/\s@]*@/i.test(u)) throw new Error('URL com credencial embutida (user:senha@) é recusada.');
-    try { await this.page.goto(u, { waitUntil: 'networkidle2', timeout: 45000 }); }
-    catch (e) { throw new Error('falha ao carregar a página: ' + String(e.message || e).slice(0, 120)); }
+    // domcontentloaded, NÃO networkidle2: páginas com rAF/polling (jogos, SPAs, WebGL) nunca
+    // deixam a rede "acalmar" → networkidle2 travava até o timeout de 45s. Carrega o DOM e dá
+    // um tempo curto pra montar; se a rede acalmar antes, melhor ainda.
+    try {
+      await this.page.goto(u, { waitUntil: 'domcontentloaded', timeout: 25000 });
+      await this.page.waitForNetworkIdle({ idleTime: 600, timeout: 4000 }).catch(() => {});
+    } catch (e) { throw new Error('falha ao carregar a página: ' + String(e.message || e).slice(0, 120)); }
     return this.snapshot();
   }
 

package/lib/meta.js

@@ -243,7 +243,9 @@ async function webRunGate(b) {
       // 401/403 = desafio de auth NORMAL (a SPA chama rota protegida antes de logar) — não é bug.
       // 500+ = erro de servidor REAL; 404 = rota/recurso faltando. Só esses reprovam.
       page.on('response', r => { const s = r.status(); const u = r.url(); if ((s >= 500 || s === 404) && !_benign(u)) errs.push(`HTTP ${s} em ${u.replace(/^https?:\/\/[^/]+/, '').slice(0, 100)}`); });
-      await page.goto(url, { waitUntil: 'networkidle2', timeout: 20000 }).catch(() => {});
+      // domcontentloaded (não networkidle2): jogos/SPAs com rAF ou polling nunca "acalmam" a
+      // rede → networkidle2 travava até o timeout. Carrega o DOM e dá um tempo fixo pra montar.
+      await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 20000 }).catch(() => {});
       await new Promise(r => setTimeout(r, 1800));
 
       // GATE AUTENTICADO: se a home tem campo de senha (=tela de login), LOGA com o seed e deixa
@@ -277,6 +279,44 @@ async function webRunGate(b) {
         }
       } catch (_) {}
 
+      // ── GATE VISUAL DE CANVAS (jogos/apps gráficos) ──────────────────────────
+      // Ponto cego histórico: um jogo Three.js/canvas podia renderizar PRETO a tela
+      // inteira (ex: câmera em NaN) SEM lançar erro de JS e SEM texto quebrado → o gate
+      // aprovava um app visualmente morto. Fix: se há um canvas grande, (1) clica num
+      // botão de START (jogar/play/iniciar) pra sair do menu e exercitar o render, e
+      // (2) mede a COMPRESSÃO do PNG do canvas: tela preta/uniforme comprime absurdamente
+      // (bytes/pixel minúsculo); cena viva é rica. Usa o screenshot do Chrome (compositor
+      // real — captura WebGL certo, ao contrário de readPixels/drawImage que dão preto).
+      let canvasDead = null;
+      try {
+        const cInfo = await page.evaluate(() => {
+          const cs = [...document.querySelectorAll('canvas')].map(c => { const r = c.getBoundingClientRect(); return { r, area: r.width * r.height }; }).sort((a, b) => b.area - a.area);
+          const big = cs[0];
+          if (!big || big.r.width < 300 || big.r.height < 220) return null; // sem canvas grande = não é app gráfico
+          return { x: Math.round(big.r.x), y: Math.round(big.r.y), w: Math.round(big.r.width), h: Math.round(big.r.height) };
+        });
+        if (cInfo) {
+          // sai do menu: clica um botão de start VISÍVEL (não é login — esse já foi tratado)
+          const started = await page.evaluate(() => {
+            const rx = /\b(jogar|começar|comecar|iniciar|start|play|new game|novo jogo|entrar)\b/i;
+            const btns = [...document.querySelectorAll('button, [role=button], a.btn, .btn, #start, [id*=start i], [class*=start i]')];
+            const b = btns.find(el => el.offsetParent !== null && rx.test((el.innerText || el.value || el.getAttribute('aria-label') || '').trim()));
+            if (b) { b.click(); return true; } return false;
+          });
+          if (started) await new Promise(r => setTimeout(r, 2500)); // deixa o gameplay renderizar
+          // recalcula a bbox (o canvas pode ter mudado de tamanho ao iniciar)
+          const box = await page.evaluate(() => { const c = [...document.querySelectorAll('canvas')].map(c => { const r = c.getBoundingClientRect(); return { r, a: r.width * r.height }; }).sort((a, b) => b.a - a.a)[0]; if (!c) return null; const r = c.r; return { x: Math.max(0, Math.round(r.x)), y: Math.max(0, Math.round(r.y)), width: Math.round(r.width), height: Math.round(r.height) }; });
+          if (box && box.width > 200 && box.height > 150) {
+            const buf = await page.screenshot({ clip: box, type: 'png' }).catch(() => null);
+            if (buf && buf.length) {
+              const bpp = buf.length / (box.width * box.height); // bytes de PNG por pixel
+              // < 0.02 B/px ≈ imagem quase uniforme (preta/cor sólida). Cena viva fica bem acima.
+              if (bpp < 0.02) canvasDead = { bpp: +bpp.toFixed(4), w: box.width, h: box.height, started };
+            }
+          }
+        }
+      } catch (_) {}
+
       shotFile = path.join(_os.tmpdir(), 'ts-web-' + port + '.png');
       try { await page.screenshot({ path: shotFile, fullPage: false }); } catch (_) { shotFile = null; }
       let bodyText = ''; try { bodyText = await page.evaluate(() => (document.body ? document.body.innerText : '')); } catch (_) {}
@@ -288,11 +328,15 @@ async function webRunGate(b) {
       const authProblem = (hasLogin && !authed)
         ? 'Há uma TELA DE LOGIN mas o gate NÃO conseguiu ENTRAR' + (creds ? ' com o usuário de seed "' + creds.email + '"' : ' (nenhum usuário de SEED encontrado no código)') + '. Crie no seed um usuário demo FUNCIONAL (email+senha em texto no script) e garanta que o login aceita ele — senão dashboard/kanban e o resto ficam sem verificação.'
         : '';
-      if (errs.length || bad.length || authProblem) {
+      const canvasProblem = canvasDead
+        ? `O CANVAS gráfico (${canvasDead.w}×${canvasDead.h}) está renderizando PRATICAMENTE VAZIO (tela preta/uniforme)${canvasDead.started ? ', mesmo depois de clicar em iniciar' : ''} — o app NÃO está desenhando a cena. Causas típicas: câmera/posição em NaN (ex: delta indefinido no 1º frame do loop), objetos fora do frustum, erro silencioso no setup do WebGL, ou o loop de render não começou. Verifique a inicialização da câmera e do requestAnimationFrame.`
+        : '';
+      if (errs.length || bad.length || authProblem || canvasProblem) {
         kill();
         return { ok: false, shot: shotFile, authed, crash: 'A verificação web falhou' + (authed ? ' (APÓS LOGIN, nas telas autenticadas)' : '') + ' (Chrome headless — corrija a CAUSA-RAIZ no código):\n'
           + (errs.length ? 'Console/erros: ' + errs.slice(0, 8).join(' | ') + '\n' : '')
           + (bad.length ? 'Texto quebrado VISÍVEL na tela: ' + bad.join(', ') + ' (ex: data não formatada, valor undefined/NaN)\n' : '')
+          + (canvasProblem ? canvasProblem + '\n' : '')
           + (authProblem || '') };
       }
       kill();

package/lib/tools.js

@@ -209,6 +209,10 @@ async function execute(name, input, opts = {}) {
   // BASE de trabalho: cwd da sessão do agente (opts.baseDir) → pasta confinada da
   // missão (opts.confineDir) → process.cwd(). É a raiz de todo caminho relativo.
   const baseDir = opts.baseDir || opts.confineDir || process.cwd();
+  // Alias de nomes que os modelos costumam alucinar no singular/variante → o nome REAL da tool
+  // (senão "Ferramenta desconhecida" desperdiça uma rodada). buscar_arquivo→buscar_arquivos etc.
+  const _ALIAS = { buscar_arquivo: 'buscar_arquivos', listar_arquivos: 'listar_diretorio', listar_dir: 'listar_diretorio', ler: 'ler_arquivo', escrever: 'escrever_arquivo', editar: 'editar_arquivo', executar: 'executar_comando', comando: 'executar_comando', shell: 'executar_comando', bash: 'executar_comando', cd: 'mudar_diretorio' };
+  if (_ALIAS[name]) name = _ALIAS[name];
   try {
     switch (name) {
       case 'executar_comando': {
@@ -435,7 +439,12 @@ async function execute(name, input, opts = {}) {
         return { diretorio: base, arquivos: m.arquivos, dependencias: m.dependencias,
           hubs: m.hubs, mapa: m.edges.map(([a, b]) => a + ' -> ' + b) };
       }
-      default: return { erro: 'Ferramenta desconhecida: ' + name };
+      default: {
+        // sugere o nome REAL mais parecido (o modelo às vezes inventa uma variante)
+        const nomes = DEFS.map(d => d.function.name);
+        const alvo = nomes.find(n => n.includes(name) || name.includes(n)) || nomes.find(n => n.split('_')[0] === String(name).split('_')[0]);
+        return { erro: 'Ferramenta desconhecida: ' + name + (alvo ? ('. Você quis dizer "' + alvo + '"? Use esse nome EXATO.') : ('. Ferramentas válidas: ' + nomes.join(', '))) };
+      }
     }
   } catch (e) { return { erro: String((e && e.message) || e).slice(0, 400) }; }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminal-smart-cli",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "Terminal Smart no seu terminal — pergunte, analise logs por pipe e orquestre agentes de IA. Comando: ts",
   "bin": {
     "ts": "bin/ts.js"