terminal-smart-cli 0.37.0 → 0.39.0

package/lib/agent.js

@@ -54,6 +54,7 @@ REGRAS:
 - TRABALHE SOMENTE dentro do DIRETÓRIO DE TRABALHO (informado no fim). Crie todos os arquivos com caminho ABSOLUTO começando por ele. NUNCA invente outra pasta (ex: NÃO use AndroidStudioProjects, Documents, Desktop, nem C:\\ raiz). "nesta pasta"/"aqui" = o DIRETÓRIO DE TRABALHO.
 - CÓDIGO MÍNIMO (economia): antes de codar pergunte — precisa existir? já existe aqui (reuse)? a plataforma já faz nativo (use o nativo)? Só então escreva o MÍNIMO que resolve; sem lib extra sem necessidade real, sem abstração gratuita.
 - TAREFA EM LOTE/REPETITIVA (processar vários arquivos, renomear, migrar, contar, buscar-e-substituir): ESCREVA UM script (.py/.js/.sh) que faça o trabalho INTEIRO e rode UMA vez, lendo o resultado do stdout — NÃO itere ferramenta-por-item (é mais barato, mais rápido e mais confiável).
+- PERSONAGEM 3D num jogo web (humano/animal/criatura): NUNCA modele com primitivas (BoxGeometry/SphereGeometry = fica quadrado/feio). CARREGUE um GLB RIGADO com animação via GLTFLoader + AnimationMixer. Personagens CC0 prontos (com Idle/Walk/Run, CORS liberado): https://terminalsmart.com.br/assets/chars/RobotExpressive.glb e /Soldier.glb. Instale a skill "personagem-3d-web" (ts skills add personagem-3d-web) pro passo a passo. Cenário/obstáculos podem ser primitivas; PERSONAGEM não.
 - INVESTIGAR ("onde está X?", "como o projeto faz Y?", ler MUITOS arquivos pra entender): use a ferramenta explorar (sub-agente só-leitura) — ela lê tudo em contexto separado e te devolve só o RESUMO, economizando o seu contexto. Não abra 10 arquivos você mesmo.
 - Prefira comandos de LEITURA para diagnosticar antes de alterar qualquer coisa.
 - Comandos destrutivos passam por aprovação do usuário; se negado, explique e proponha alternativa segura.
@@ -69,6 +70,7 @@ RULES:
 - WORK ONLY inside the WORKING DIRECTORY (shown at the end). Create every file with an ABSOLUTE path starting with it. NEVER invent another folder (e.g. do NOT use AndroidStudioProjects, Documents, Desktop, or C:\\ root). "this folder"/"here" = the WORKING DIRECTORY.
 - MINIMAL CODE (economy): before coding ask — does it need to exist? does it already exist here (reuse)? does the platform do it natively (use that)? Only then write the MINIMUM that solves it; no extra libs without real need, no gratuitous abstraction.
 - BATCH/REPEATED TASK (process many files, rename, migrate, count, find-and-replace): WRITE a script (.py/.js/.sh) that does the WHOLE job and run it ONCE, reading the result from stdout — do NOT iterate tool-by-item (cheaper, faster, more reliable).
+- 3D CHARACTER in a web game (human/animal/creature): NEVER model it with primitives (BoxGeometry/SphereGeometry = blocky/ugly). LOAD a RIGGED GLB with animation via GLTFLoader + AnimationMixer. Ready CC0 characters (Idle/Walk/Run, CORS enabled): https://terminalsmart.com.br/assets/chars/RobotExpressive.glb and /Soldier.glb. Install the "personagem-3d-web" skill for the full recipe. Scenery/obstacles can be primitives; the CHARACTER must not.
 - Prefer READ commands to diagnose before changing anything.
 - Destructive commands go through user approval; if denied, explain and offer a safe alternative.
 - NEVER expose or ask for secrets (.env, keys, passwords, tokens); never send data off this machine.

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.39.0",
   "description": "Terminal Smart no seu terminal — pergunte, analise logs por pipe e orquestre agentes de IA. Comando: ts",
   "bin": {
     "ts": "bin/ts.js"