terminal-smart-cli 0.97.14 → 0.97.15

package/lib/agent.js

@@ -1587,7 +1587,7 @@ async function run(task, opts = {}) {
           try { require('./memoria').logErro(confineDir || cwd, name, String(result.erro || result.stderr || ('exit ' + result.codigo))); } catch (_) {}
           // RECOVERY ENGINE: erro de classe CONHECIDA → injeta a estratégia de conserto no
           // resultado (o modelo aplica o padrão DevOps em vez de chutar/entrar em loop).
-          try { const _rh = require('./recovery').recoveryHint(_tr.errorClass); if (_rh && result && typeof result === 'object' && !result._recovery) result = Object.assign({}, result, { _recovery: _rh }); } catch (_) {}
+          try { const _rh = require('./recovery').recoveryHint(_tr.errorClass, { availableTools:_allowedToolNames }); if (_rh && result && typeof result === 'object' && !result._recovery) result = Object.assign({}, result, { _recovery: _rh }); } catch (_) {}
         }
         // HOOK PostToolUse (determinístico): feedback (ex: lint/format) vai pro modelo ver.
         if (_hooks._any) {

package/lib/recovery.js

@@ -63,9 +63,17 @@ const RECOVERABLE = Object.keys(STRATEGIES); // classes com estratégia conhecid
 function strategiesFor(errorClass) { return STRATEGIES[errorClass] || null; }
 
 // Texto acionável pra INJETAR no resultado da ferramenta que o modelo lê. '' se classe sem estratégia.
-function recoveryHint(errorClass) {
+function recoveryHint(errorClass, options = {}) {
   const s = STRATEGIES[errorClass];
   if (!s) return '';
+  if (errorClass === 'not_found' && Array.isArray(options.availableTools)) {
+    const available = new Set(options.availableTools);
+    const probes = ['listar_diretorio', 'buscar_arquivos'].filter(name => available.has(name));
+    if (!probes.length) {
+      return 'ESCOPO ESTRITO: o alvo não foi encontrado e as ferramentas de procura não foram autorizadas. Não contorne a restrição, não invente outro caminho e não repita a mesma leitura. Encerre com a falha objetiva e informe que listar_diretorio ou buscar_arquivos permitiria investigar.';
+    }
+    return `ESTRATÉGIA CONHECIDA (not_found) — use somente ferramentas disponíveis:\n1) DIAGNOSTIQUE com ${probes.join(' ou ')} para confirmar o caminho exato.\n2) Se encontrar um candidato inequívoco, tente ler uma única vez; caso contrário, encerre com a evidência sem inventar caminho.`;
+  }
   return `ESTRATÉGIA CONHECIDA (${errorClass}) — não chute:\n1) DIAGNOSTIQUE: ${s.diag}\n2) CONSERTO: ${s.fix}`;
 }
 

package/package.json

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