terminal-smart-cli 0.97.12 → 0.97.14

package/lib/tools.js

@@ -54,6 +54,13 @@ const DEFS = [
       inicio: { type: 'number', description: 'linha inicial (1-based, opcional)' },
       fim: { type: 'number', description: 'linha final (opcional)' },
     }, required: ['caminho'] } } },
+  { type: 'function', function: { name: 'ler_arquivos',
+    description: 'Le em LOTE varios arquivos ou trechos de texto numa unica chamada. Prefira quando precisar inspecionar 2 ou mais arquivos/paginas; reduz tempo e custo.',
+    parameters: { type: 'object', properties: {
+      arquivos: { type: 'array', description: 'Ate 10 itens {caminho,inicio,fim}. Para arquivos grandes, use trechos de aproximadamente 100 linhas.', items: { type: 'object', properties: {
+        caminho: { type: 'string' }, inicio: { type: 'number' }, fim: { type: 'number' },
+      }, required: ['caminho'] } },
+    }, required: ['arquivos'] } } },
   { type: 'function', function: { name: 'escrever_arquivo',
     description: 'Cria ou sobrescreve um arquivo local com o conteúdo dado (cria as pastas se preciso). Para MUDAR UM TRECHO de arquivo que JÁ EXISTE, prefira editar_arquivo (mais barato e preciso).',
     parameters: { type: 'object', properties: {
@@ -162,11 +169,17 @@ const DEFS = [
       inicio_char: { type: 'number' }, tamanho: { type: 'number' },
     }, required: ['caminho'] } } },
   { type: 'function', function: { name: 'editar_documento',
-    description: 'Edita um .docx EXISTENTE no próprio arquivo por padrão, preserva o restante e cria backup automático. Só cria outro arquivo se o usuário pedir uma cópia.',
+    description: 'Edita um .docx EXISTENTE no próprio arquivo por padrão, preserva o restante e cria backup automático. Para várias mudanças no mesmo DOCX, agrupe todas em substituicoes numa ÚNICA chamada atômica. Só cria outro arquivo se o usuário pedir uma cópia.',
     parameters: { type: 'object', properties: {
       caminho: { type: 'string' }, buscar: { type: 'string' }, substituir: { type: 'string' },
       todas: { type: 'boolean' }, criar_copia: { type: 'boolean' }, caminho_copia: { type: 'string' },
-    }, required: ['caminho', 'buscar', 'substituir'] } } },
+      substituicoes: { type: 'array', description: 'Mudanças agrupadas e atômicas no mesmo DOCX.', items: { type: 'object', properties: {
+        buscar: { type: 'string' }, substituir: { type: 'string' }, todas: { type: 'boolean' },
+      }, required: ['buscar', 'substituir'] } },
+      alteracoes_tabela: { type: 'array', description: 'Altera atomicamente o valor da célula seguinte a um rótulo de tabela.', items: { type: 'object', properties: {
+        rotulo: { type: 'string' }, valor: { type: 'string' }, todas: { type: 'boolean' },
+      }, required: ['rotulo', 'valor'] } },
+    }, required: ['caminho'] } } },
   { type: 'function', function: { name: 'editar_planilha',
     description: 'Edita uma planilha .xlsx EXISTENTE no próprio arquivo por padrão. Altera células/fórmulas ou substitui texto, preserva as demais abas e cria backup automático. Só cria outro arquivo se o usuário pedir cópia.',
     parameters: { type: 'object', properties: {
@@ -179,6 +192,12 @@ const DEFS = [
       }, required: ['buscar', 'substituir'] } },
       criar_copia: { type: 'boolean' }, caminho_copia: { type: 'string' },
     }, required: ['caminho'] } } },
+  { type: 'function', function: { name: 'ler_planilha',
+    description: 'Lê uma planilha .xlsx existente de forma tipada, retornando endereços, valores, fórmulas e resultados em cache. Use antes e depois de editar; não adivinhe células.',
+    parameters: { type: 'object', properties: {
+      caminho: { type: 'string' }, aba: { type: 'string' }, intervalo: { type: 'string', description: 'Ex.: A1:I30' },
+      limite: { type: 'number' }, incluir_vazias: { type: 'boolean' },
+    }, required: ['caminho'] } } },
   { type: 'function', function: { name: 'status_microsoft365', description: 'Verifica a conexão com Outlook e Microsoft 365.', parameters: { type: 'object', properties: {} } } },
   { type: 'function', function: { name: 'conectar_microsoft365', description: 'Gera o link oficial para autorizar Outlook e Microsoft 365.', parameters: { type: 'object', properties: {} } } },
   { type: 'function', function: { name: 'listar_emails_outlook', description: 'Lista, pesquisa e prioriza e-mails do Outlook sem alterar nada.', parameters: { type: 'object', properties: { limite: { type: 'number' }, somente_nao_lidos: { type: 'boolean' }, priorizar: { type: 'boolean' }, consulta: { type: 'string' }, pasta: { type: 'string' } } } } },
@@ -190,10 +209,12 @@ const DEFS = [
   { type: 'function', function: { name: 'obter_anexo_outlook', description: 'Obtém o link autenticado para baixar um anexo do Outlook.', parameters: { type: 'object', properties: { id_email: { type: 'string' }, id_anexo: { type: 'string' } }, required: ['id_email','id_anexo'] } } },
   { type: 'function', function: { name: 'criar_rascunho_outlook', description: 'Cria rascunho no Outlook. Exige confirmação e não envia.', parameters: { type: 'object', properties: { para: { type: 'array', items: { type: 'string' } }, cc: { type: 'array', items: { type: 'string' } }, assunto: { type: 'string' }, corpo: { type: 'string' }, formato_html: { type: 'boolean' } }, required: ['para','assunto','corpo'] } } },
   { type: 'function', function: { name: 'enviar_rascunho_outlook', description: 'Envia um rascunho existente do Outlook. Exige confirmação.', parameters: { type: 'object', properties: { rascunho_id: { type: 'string' } }, required: ['rascunho_id'] } } },
-  { type: 'function', function: { name: 'status_google_workspace', description: 'Verifica a conexão com Gmail, Drive, Docs e Sheets.', parameters: { type: 'object', properties: {} } } },
-  { type: 'function', function: { name: 'conectar_google_workspace', description: 'Gera o link oficial para autorizar Gmail, Drive, Docs e Sheets.', parameters: { type: 'object', properties: {} } } },
-  { type: 'function', function: { name: 'listar_emails_gmail', description: 'Lista e prioriza e-mails do Gmail, sem alterar nada.', parameters: { type: 'object', properties: {
-    limite: { type: 'number' }, somente_nao_lidos: { type: 'boolean' }, priorizar: { type: 'boolean' }, consulta: { type: 'string' }, pasta: { type: 'string', enum: ['inbox','sent','drafts','spam','trash','starred','important','all'] }
+  { type: 'function', function: { name: 'status_google_workspace', description: 'Verifica a conexão Google e informa se o acesso é Essencial ou Avançado.', parameters: { type: 'object', properties: {} } } },
+  { type: 'function', function: { name: 'conectar_google_workspace', description: 'Gera o link Google. Essencial acessa arquivos escolhidos/criados pelo app; Avançado beta inclui Gmail completo e pesquisa global do Drive.', parameters: { type: 'object', properties: {
+    nivel: { type: 'string', enum: ['essencial', 'avancado'] }
+  } } } },
+  { type: 'function', function: { name: 'listar_emails_gmail', description: 'Lista e prioriza e-mails do Gmail, sem alterar nada. Use pagina com nextPageToken para continuar em lotes.', parameters: { type: 'object', properties: {
+    limite: { type: 'number' }, somente_nao_lidos: { type: 'boolean' }, priorizar: { type: 'boolean' }, consulta: { type: 'string' }, pasta: { type: 'string', enum: ['inbox','sent','drafts','spam','trash','starred','important','all'] }, pagina: { type: 'string' }
   } } } },
   { type: 'function', function: { name: 'ler_email_gmail', description: 'Lê o corpo completo de um e-mail ou a conversa inteira sem marcar como lido.', parameters: { type: 'object', properties: {
     id_email: { type: 'string' }, conversa_completa: { type: 'boolean' }
@@ -215,9 +236,13 @@ const DEFS = [
     para: { type: 'array', items: { type: 'string' } }, cc: { type: 'array', items: { type: 'string' } }, assunto: { type: 'string' }, corpo: { type: 'string' }, formato_html: { type: 'boolean' }
   }, required: ['para', 'assunto', 'corpo'] } } },
   { type: 'function', function: { name: 'enviar_rascunho_gmail', description: 'Envia rascunho existente do Gmail. Exige confirmação.', parameters: { type: 'object', properties: { rascunho_id: { type: 'string' } }, required: ['rascunho_id'] } } },
-  { type: 'function', function: { name: 'listar_arquivos_drive', description: 'Lista arquivos no Google Drive por nome ou tipo.', parameters: { type: 'object', properties: {
+  { type: 'function', function: { name: 'listar_arquivos_drive', description: 'Lista arquivos acessíveis no Drive; no Essencial limita-se aos escolhidos/criados pelo app e no Avançado pesquisa todo o Drive.', parameters: { type: 'object', properties: {
     busca: { type: 'string' }, tipo_mime: { type: 'string' }, limite: { type: 'number' }
   } } } },
+  { type: 'function', function: { name: 'selecionar_arquivos_drive', description: 'Fornece o link da Central de Integrações para escolher arquivos existentes no Google Drive.', parameters: { type: 'object', properties: {} } } },
+  { type: 'function', function: { name: 'criar_google_docs', description: 'Cria um novo Google Docs. Exige confirmação.', parameters: { type: 'object', properties: {
+    nome: { type: 'string' }, texto_inicial: { type: 'string' }, id_pasta: { type: 'string' }
+  }, required: ['nome'] } } },
   { type: 'function', function: { name: 'ler_google_docs', description: 'Lê texto de Google Docs pelo ID.', parameters: { type: 'object', properties: { id_documento: { type: 'string' } }, required: ['id_documento'] } } },
   { type: 'function', function: { name: 'editar_google_docs', description: 'Edita o Google Docs original por padrão; cria cópia somente se solicitado. Exige confirmação.', parameters: { type: 'object', properties: {
     id_documento: { type: 'string' }, localizar: { type: 'string' }, substituir_por: { type: 'string' }, diferenciar_maiusculas: { type: 'boolean' }, criar_copia: { type: 'boolean' }, nome_copia: { type: 'string' }
@@ -225,6 +250,9 @@ const DEFS = [
   { type: 'function', function: { name: 'ler_google_sheets', description: 'Lê células de Google Sheets pelo ID e intervalo.', parameters: { type: 'object', properties: {
     id_planilha: { type: 'string' }, intervalo: { type: 'string' }
   }, required: ['id_planilha'] } } },
+  { type: 'function', function: { name: 'criar_google_sheets', description: 'Cria uma nova Google Sheets e pode preencher valores iniciais. Exige confirmação.', parameters: { type: 'object', properties: {
+    nome: { type: 'string' }, intervalo: { type: 'string' }, valores: { type: 'array', items: { type: 'array', items: {} } }, id_pasta: { type: 'string' }
+  }, required: ['nome'] } } },
   { type: 'function', function: { name: 'editar_google_sheets', description: 'Edita a Google Sheets original por padrão; cria cópia somente se solicitado. Exige confirmação.', parameters: { type: 'object', properties: {
     id_planilha: { type: 'string' }, intervalo: { type: 'string' }, valores: { type: 'array', items: { type: 'array', items: {} } }, criar_copia: { type: 'boolean' }, nome_copia: { type: 'string' }
   }, required: ['id_planilha', 'intervalo', 'valores'] } } },
@@ -364,9 +392,18 @@ function _shellGotcha(cmd) {
     return 'python -c MULTILINHA falha em silêncio no Windows. Escreva um arquivo .py com escrever_arquivo e rode "python arquivo.py".';
   if (/\bnode\s+-e\b/.test(s) && (multi || /\bimport\s*\(/.test(s) || /\bawait\b/.test(s)))
     return 'node -e MULTILINHA ou com import()/await de topo falha no eval. Escreva um arquivo .mjs com escrever_arquivo e rode "node arquivo.mjs".';
-  // timeout /t é do cmd; sob git-bash pega o timeout do coreutils e dá "invalid time interval"
-  if (/\btimeout\s+\/t\b/i.test(s))
-    return 'Este shell é bash (não cmd): "timeout /t N" falha. Para esperar use "sleep N". Comandos só-do-cmd (dir, type, if exist) rode via: cmd /c "…".';
+  // child_process.exec usa cmd.exe no Windows. Alguns comandos POSIX têm outro
+  // significado: `mkdir -p app` cria por engano uma pasta literal chamada `-p`.
+  if (process.platform === 'win32' && /(^|[&|]\s*|\s)mkdir\s+-p(?:\s|$)/i.test(s))
+    return 'Este shell é cmd.exe: "mkdir -p" criaria uma pasta chamada "-p". Use "mkdir pasta" ou PowerShell New-Item.';
+  // Bloqueie apenas `ls` como COMANDO. `npm ls` e texto dentro de um PowerShell
+  // explicito sao validos; o antigo `\sls` gerava falso positivo nos dois casos.
+  if (process.platform === 'win32'
+      && !/^\s*(?:powershell|pwsh)\b/i.test(s)
+      && /(?:^|(?:&&|\|\||[&|])\s*)ls(?:\s|$)/i.test(s))
+    return 'Este shell é cmd.exe: use "dir" (ou chame PowerShell explicitamente) em vez de "ls".';
+  if (process.platform === 'win32' && /(?:^|\s)\/[a-zA-Z]\//.test(s))
+    return 'Caminho no formato /c/... não é válido no cmd.exe. Use C:\\... ou um caminho relativo ao diretório de trabalho.';
   // matar processo por IMAGEM mata tudo com esse nome (inclusive a própria missão)
   if (/\btaskkill\b[^\n]*\/im\b/i.test(s))
     return 'taskkill /IM mata TODOS os processos com esse nome (inclusive os do usuário e possivelmente o próprio ts). Mate pelo PID da PORTA: netstat -ano | findstr :PORTA  →  taskkill /PID <pid> /F.';
@@ -609,6 +646,25 @@ async function execute(name, input, opts = {}) {
         if (total > MAXL) return { conteudo: linhas.slice(0, MAXL).join('\n'), linhas_total: total, aviso: `Arquivo grande (${total} linhas): mostrando 1-${MAXL}. Chame de novo com inicio/fim.` };
         return { conteudo: txt, linhas_total: total };
       }
+      case 'ler_arquivos': {
+        const arquivos = Array.isArray(input.arquivos) ? input.arquivos.slice(0, 10) : [];
+        if (!arquivos.length) return { erro: 'Informe arquivos com pelo menos um item {caminho,inicio,fim}.' };
+        const resultados = [];
+        let caracteres = 0;
+        const LIMITE_TOTAL = 22000;
+        for (const item of arquivos) {
+          if (!item || !item.caminho) continue;
+          const r = await execute('ler_arquivo', item, opts);
+          let conteudo = r && typeof r.conteudo === 'string' ? r.conteudo : '';
+          const restante = Math.max(0, LIMITE_TOTAL - caracteres);
+          if (conteudo.length > restante) conteudo = conteudo.slice(0, restante) + '\n...[lote truncado; solicite um trecho menor]';
+          const saida = Object.assign({ caminho: item.caminho }, r || {}, conteudo ? { conteudo } : {});
+          resultados.push(saida);
+          caracteres += conteudo.length;
+          if (caracteres >= LIMITE_TOTAL) break;
+        }
+        return { total: resultados.length, resultados, aviso: resultados.length < arquivos.length ? 'Lote limitado pelo teto de contexto; peca os trechos restantes em outro lote.' : undefined };
+      }
       case 'escrever_arquivo': {
         let p = _abs(input.caminho, baseDir);
         { const g = _guardTsHome(p); if (g) return { erro: g }; }
@@ -693,7 +749,8 @@ async function execute(name, input, opts = {}) {
       case 'listar_diretorio': {
         const p = _abs(input.caminho || '.', baseDir);
         if (_outsideScope(p)) return _scopeError(p);
-        const items = fs.readdirSync(p, { withFileTypes: true }).slice(0, 200).map(d => {
+        const internos = new Set(['.ts-episodios.json', '.ts-erros.json', '.ts-indice.json']);
+        const items = fs.readdirSync(p, { withFileTypes: true }).filter(d => !internos.has(d.name)).slice(0, 200).map(d => {
           let size = null; try { if (d.isFile()) size = fs.statSync(path.join(p, d.name)).size; } catch (_) {}
           return { nome: d.name, tipo: d.isDirectory() ? 'dir' : 'arquivo', bytes: size };
         });
@@ -865,6 +922,11 @@ async function execute(name, input, opts = {}) {
         if (result.ok) { result._backup = result.backup || ''; result._acao = result.editou_original ? 'alterado' : 'criado'; }
         return result;
       }
+      case 'ler_planilha': {
+        const target = _abs(input.caminho, baseDir);
+        if (_outsideScope(target)) return _scopeError(target);
+        return await require('./office-readers').lerPlanilha({ ...input, caminho: target });
+      }
       case 'status_microsoft365':
         return await require('./api').api('/api/integrations/microsoft/status', { token: opts.token });
       case 'conectar_microsoft365': {
@@ -889,20 +951,24 @@ async function execute(name, input, opts = {}) {
         return await require('./api').api('/api/integrations/microsoft/mail/forwards', { method: 'POST', token: opts.token, body: { messageId: input.id_email, to: input.para, cc: input.cc || [], body: input.corpo || '', confirmed: true } });
       case 'obter_anexo_outlook':
         return { downloadUrl: '/api/integrations/microsoft/mail/attachments/download?' + new URLSearchParams({ messageId: input.id_email, attachmentId: input.id_anexo }), instrucao: 'Use uma sessão autenticada do Terminal Smart para baixar o anexo.' };
-      case 'criar_rascunho_outlook':
-        return await require('./api').api('/api/integrations/microsoft/mail/drafts', { method: 'POST', token: opts.token, body: { to: input.para, cc: input.cc || [], subject: input.assunto, body: input.corpo, contentType: input.formato_html ? 'html' : 'text', confirmed: true } });
+      case 'criar_rascunho_outlook': {
+        const data = await require('./api').api('/api/integrations/microsoft/mail/drafts', { method: 'POST', token: opts.token, body: { to: input.para, cc: input.cc || [], subject: input.assunto, body: input.corpo, contentType: input.formato_html ? 'html' : 'text', confirmed: true } });
+        return { ...data, rascunho_id: data.rascunho_id || data.draftId || data.draft?.id || data.id || null };
+      }
       case 'enviar_rascunho_outlook':
         return await require('./api').api('/api/integrations/microsoft/mail/send', { method: 'POST', token: opts.token, body: { draftId: input.rascunho_id, confirmed: true } });
       case 'status_google_workspace':
         return await require('./api').api('/api/integrations/google/status', { token: opts.token });
       case 'conectar_google_workspace': {
-        const data = await require('./api').api('/api/integrations/google/connect', { method: 'POST', body: { source: 'cli' }, token: opts.token });
-        return { ok: true, authUrl: data.authUrl, instrucao: 'Abra o link no navegador, autorize sua conta Google e volte ao Terminal Smart.' };
+        const accessLevel = String(input.nivel || '').toLowerCase() === 'avancado' ? 'advanced' : 'essential';
+        const data = await require('./api').api('/api/integrations/google/connect', { method: 'POST', body: { source: 'cli', accessLevel }, token: opts.token });
+        return { ok: true, accessLevel, authUrl: data.authUrl, instrucao: `Abra o link no navegador, autorize o acesso Google ${accessLevel === 'advanced' ? 'Avançado (beta)' : 'Essencial'} e volte ao Terminal Smart.` };
       }
       case 'listar_emails_gmail': {
         const p = new URLSearchParams({ limit: String(Math.min(30, Math.max(1, parseInt(input.limite) || 15))) });
         if (input.somente_nao_lidos) p.set('unread', '1'); if (input.priorizar) p.set('priority', '1');
         if (input.consulta) p.set('query', input.consulta); if (input.pasta) p.set('folder', input.pasta);
+        if (input.pagina) p.set('page', input.pagina);
         return await require('./api').api('/api/integrations/google/gmail/messages?' + p, { token: opts.token });
       }
       case 'ler_email_gmail': {
@@ -919,15 +985,21 @@ async function execute(name, input, opts = {}) {
         return await require('./api').api('/api/integrations/google/gmail/forwards', { method: 'POST', token: opts.token, body: { messageId: input.id_email, to: input.para, cc: input.cc || [], body: input.corpo || '', confirmed: true } });
       case 'obter_anexo_gmail':
         return { downloadUrl: '/api/integrations/google/gmail/attachments/download?' + new URLSearchParams({ messageId: input.id_email, attachmentId: input.id_anexo }), instrucao: 'Use uma sessão autenticada do Terminal Smart para baixar o anexo.' };
-      case 'criar_rascunho_gmail':
-        return await require('./api').api('/api/integrations/google/gmail/drafts', { method: 'POST', token: opts.token, body: { to: input.para, cc: input.cc || [], subject: input.assunto, body: input.corpo, contentType: input.formato_html ? 'html' : 'text', confirmed: true } });
+      case 'criar_rascunho_gmail': {
+        const data = await require('./api').api('/api/integrations/google/gmail/drafts', { method: 'POST', token: opts.token, body: { to: input.para, cc: input.cc || [], subject: input.assunto, body: input.corpo, contentType: input.formato_html ? 'html' : 'text', confirmed: true } });
+        return { ...data, id_rascunho: data.id_rascunho || data.draftId || data.draft?.id || data.id || null };
+      }
       case 'enviar_rascunho_gmail':
-        return await require('./api').api('/api/integrations/google/gmail/send', { method: 'POST', token: opts.token, body: { draftId: input.rascunho_id, confirmed: true } });
+        return await require('./api').api('/api/integrations/google/gmail/send', { method: 'POST', token: opts.token, body: { draftId: input.id_rascunho, confirmed: true } });
       case 'listar_arquivos_drive': {
         const p = new URLSearchParams({ limit: String(Math.min(100, Math.max(1, parseInt(input.limite) || 30))) });
         if (input.busca) p.set('query', input.busca); if (input.tipo_mime) p.set('mimeType', input.tipo_mime);
         return await require('./api').api('/api/integrations/google/drive/files?' + p, { token: opts.token });
       }
+      case 'selecionar_arquivos_drive':
+        return { url: 'https://terminalsmart.com.br/integracoes#google-files', instrucao: 'Abra o link e clique em Escolher arquivos do Drive.' };
+      case 'criar_google_docs':
+        return await require('./api').api('/api/integrations/google/docs/create', { method: 'POST', token: opts.token, body: { name: input.nome, text: input.texto_inicial || '', folderId: input.id_pasta, confirmed: true } });
       case 'ler_google_docs':
         return await require('./api').api('/api/integrations/google/docs/document?id=' + encodeURIComponent(input.id_documento), { token: opts.token });
       case 'editar_google_docs':
@@ -936,6 +1008,8 @@ async function execute(name, input, opts = {}) {
         const p = new URLSearchParams({ id: input.id_planilha }); if (input.intervalo) p.set('range', input.intervalo);
         return await require('./api').api('/api/integrations/google/sheets/values?' + p, { token: opts.token });
       }
+      case 'criar_google_sheets':
+        return await require('./api').api('/api/integrations/google/sheets/create', { method: 'POST', token: opts.token, body: { name: input.nome, range: input.intervalo || 'A1', values: input.valores || [], folderId: input.id_pasta, confirmed: true } });
       case 'editar_google_sheets':
         return await require('./api').api('/api/integrations/google/sheets/update', { method: 'POST', token: opts.token, body: { spreadsheetId: input.id_planilha, range: input.intervalo, values: input.valores, createCopy: input.criar_copia === true, copyName: input.nome_copia, confirmed: true } });
       case 'ler_apresentacao': {
@@ -971,4 +1045,4 @@ async function execute(name, input, opts = {}) {
   } catch (e) { return { erro: String((e && e.message) || e).slice(0, 400) }; }
 }
 
-module.exports = { DEFS, execute, isDestructive, selfDestructiveReason, buildProjectMap };
+module.exports = { DEFS, execute, isDestructive, selfDestructiveReason, buildProjectMap, _test: { shellGotcha: _shellGotcha } };

package/lib/xlsx-compat-editor.js

@@ -66,6 +66,15 @@ function cellRow(address) {
   return Number(address.match(/\d+$/)[0]);
 }
 
+function addressInRange(address, range) {
+  if (!range) return true;
+  const match = String(range).toUpperCase().match(/^([A-Z]+\d+)(?::([A-Z]+\d+))?$/);
+  if (!match) throw new Error(`Intervalo inválido: ${range}`);
+  const start = match[1]; const end = match[2] || start;
+  return cellColumn(address) >= cellColumn(start) && cellColumn(address) <= cellColumn(end)
+    && cellRow(address) >= cellRow(start) && cellRow(address) <= cellRow(end);
+}
+
 function setType(openTag, type) {
   let tag = openTag.replace(/\s+t="[^"]*"/i, '');
   if (type) tag = tag.replace(/\s*\/?>$/, ` t="${type}">`);
@@ -157,6 +166,42 @@ function parseSharedStrings(xml) {
   );
 }
 
+function inspectCell(cellXml, sharedStrings) {
+  const open = cellXml.match(/^<[^>]+>/)?.[0] || '';
+  const type = attr(open, 't');
+  const formula = cellXml.match(/<(?:\w+:)?f\b[^>]*>([\s\S]*?)<\/(?:\w+:)?f>/i)?.[1];
+  const raw = cellXml.match(/<(?:\w+:)?v\b[^>]*>([\s\S]*?)<\/(?:\w+:)?v>/i)?.[1];
+  let value = cellText(cellXml, sharedStrings);
+  if (value == null && raw != null) {
+    const decoded = xmlDecode(raw);
+    if (type === 'b') value = decoded === '1';
+    else value = Number.isFinite(Number(decoded)) ? Number(decoded) : decoded;
+  }
+  return { valor: value, formula: formula == null ? undefined : xmlDecode(formula), resultado_cache: formula == null ? undefined : value };
+}
+
+async function readXlsxCompat(source, input = {}) {
+  const zip = await JSZip.loadAsync(fs.readFileSync(source));
+  const sheets = await workbookSheets(zip);
+  const selected = input.aba
+    ? sheets.find(sheet => sheet.name.toLowerCase() === String(input.aba).toLowerCase())
+    : sheets[0];
+  if (!selected) throw new Error(`Aba não encontrada: ${input.aba}`);
+  const sharedXml = zip.file('xl/sharedStrings.xml') ? await zip.file('xl/sharedStrings.xml').async('string') : '';
+  const sharedStrings = parseSharedStrings(sharedXml);
+  const xml = await zip.file(selected.file).async('string');
+  const cells = [];
+  for (const match of xml.matchAll(/(?:<(?:\w+:)?c\b(?=[^>]*\br="([A-Z]+\d+)")[^>]*\/>|<(?:\w+:)?c\b(?=[^>]*\br="([A-Z]+\d+)")[^>]*>[\s\S]*?<\/(?:\w+:)?c>)/gi)) {
+    const address = match[1] || match[2];
+    if (!addressInRange(address, input.intervalo)) continue;
+    const inspected = inspectCell(match[0], sharedStrings);
+    if (inspected.valor == null && inspected.formula == null && !input.incluir_vazias) continue;
+    cells.push({ celula: address, ...inspected });
+    if (cells.length >= Math.min(2000, Math.max(1, Number(input.limite) || 500))) break;
+  }
+  return { abas: sheets.map(sheet => sheet.name), aba: selected.name, intervalo: input.intervalo || 'usado', celulas: cells };
+}
+
 function substituteInSheet(xml, rule, sharedStrings) {
   const search = String(rule.buscar || '');
   if (!search) return { xml, changes: [] };
@@ -180,6 +225,28 @@ function substituteInSheet(xml, rule, sharedStrings) {
   return { xml: changes.length ? output + xml.slice(cursor) : xml, changes };
 }
 
+function invalidateFormulaCaches(xml) {
+  let count = 0;
+  const output = String(xml).replace(/<(?:\w+:)?c\b[^>]*>[\s\S]*?<\/(?:\w+:)?c>/gi, cell => {
+    if (!/<(?:\w+:)?f\b/i.test(cell)) return cell;
+    const next = cell.replace(/<(?:\w+:)?v\b[^>]*>[\s\S]*?<\/(?:\w+:)?v>/gi, '');
+    if (next !== cell) count++;
+    return next;
+  });
+  return { xml: output, count };
+}
+
+function requestFullCalculation(xml) {
+  const source = String(xml || '');
+  if (/<(?:\w+:)?calcPr\b/i.test(source)) {
+    return source.replace(/<(\w+:)?calcPr\b([^>]*?)\/?\s*>/i, (_all, prefix = '', attrs = '') => {
+      const clean = attrs.replace(/\s+fullCalcOnLoad="[^"]*"/i, '');
+      return `<${prefix || ''}calcPr${clean} fullCalcOnLoad="1"/>`;
+    });
+  }
+  return source.replace(/<\/(\w+:)?workbook>\s*$/i, '<$1calcPr fullCalcOnLoad="1"/></$1workbook>');
+}
+
 async function editXlsxCompat(source, destination, input = {}) {
   const zip = await JSZip.loadAsync(fs.readFileSync(source));
   const sheets = await workbookSheets(zip);
@@ -219,10 +286,19 @@ async function editXlsxCompat(source, destination, input = {}) {
     if (!replaced) throw new Error(`Texto não encontrado na planilha: ${String(rule.buscar || '').slice(0, 80)}`);
   }
   if (!changes.length) throw new Error('Informe alteracoes ou substituicoes.');
+  let formulasInvalidated = 0;
+  for (const sheet of sheets) {
+    const invalidated = invalidateFormulaCaches(await readXml(sheet));
+    xmlByFile.set(sheet.file, invalidated.xml);
+    formulasInvalidated += invalidated.count;
+  }
   for (const [file, xml] of xmlByFile) zip.file(file, xml);
+  const workbookXml = await zip.file('xl/workbook.xml').async('string');
+  zip.file('xl/workbook.xml', requestFullCalculation(workbookXml));
   const buffer = await zip.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE' });
   fs.writeFileSync(destination, buffer);
-  return { changes, engine: 'ooxml-compat' };
+  return { changes, engine: 'ooxml-compat', formulasInvalidated, recalculateOnOpen: true };
 }
 
-module.exports = { editXlsxCompat, _updateCell: updateCell, _substituteInSheet: substituteInSheet };
+module.exports = { editXlsxCompat, _updateCell: updateCell, _substituteInSheet: substituteInSheet,
+  readXlsxCompat, _invalidateFormulaCaches: invalidateFormulaCaches, _requestFullCalculation: requestFullCalculation };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "terminal-smart-cli",
-  "version": "0.97.12",
+  "version": "0.97.14",
   "description": "Terminal Smart no seu terminal — pergunte, analise logs por pipe e orquestre agentes de IA. Comando: ts",
   "bin": {
     "ts": "bin/ts.js"
   },
   "scripts": {
-    "test": "node test/core.test.js && node test/intelligence-core.test.js && node test/cloud-slug.test.js && node test/eval-model.test.js && node test/project-cache.test.js && node test/memory-bus.test.js && node test/capabilities.test.js && node test/mcp-e2e.test.js && node test/erros.test.js && node test/capability-pack.test.js && node test/byok.test.js && node test/conhecimento.test.js && node test/policy.test.js && node test/temas.test.js && node test/skill-index.test.js && node test/doctor.test.js && node test/google-workspace-tools.test.js && node test/office-editors.test.js"
+    "test": "node test/core.test.js && node test/audit-packs.test.js && node test/intelligence-core.test.js && node test/cloud-slug.test.js && node test/eval-model.test.js && node test/project-cache.test.js && node test/memory-bus.test.js && node test/capabilities.test.js && node test/mcp-e2e.test.js && node test/erros.test.js && node test/evolution-telemetry.test.js && node test/capability-pack.test.js && node test/video-generation.test.js && node test/image-job.test.js && node test/byok.test.js && node test/conhecimento.test.js && node test/policy.test.js && node test/temas.test.js && node test/skill-index.test.js && node test/doctor.test.js && node test/google-workspace-tools.test.js && node test/office-editors.test.js"
   },
   "files": [
     "bin",
@@ -24,7 +24,7 @@
     "ssh",
     "agente"
   ],
-  "author": "Terminal Smart <contato@terminalsmart.com.br>",
+  "author": "Terminal Smart <contato@g3tecnegocios.com>",
   "homepage": "https://terminalsmart.com.br/cli",
   "bugs": {
     "url": "https://terminalsmart.com.br/cli"