terminal-smart-cli 0.97.11 → 0.97.12

package/lib/agent.js

@@ -225,7 +225,11 @@ function isCycle(sigs) {
 // Veredito do watchdog (PURO, testável): 'break' | 'warn' | 'ok'.
 //   break = 2º strike (repetiu demais OU já avisado e ainda em ciclo) → encerra o loop.
 //   warn  = 1º strike (bateu o limite de repetição OU 1º ciclo) e ainda não avisou ESTA sig.
-function loopDecision({ nSig, cycling, warnedThis, loopWarned, WARN, BREAK }) {
+function loopDecision({ nSig, cycling, warnedThis, loopWarned, WARN, BREAK, cacheHit = false }) {
+  // Uma leitura idêntica já atendida pelo cache não é ausência de progresso:
+  // ela não consulta a fonte, não cria efeito colateral e deve voltar ao modelo
+  // como referência curta. O watchdog continua valendo para execuções reais.
+  if (cacheHit) return 'cache';
   if (nSig >= BREAK || (cycling && loopWarned)) return 'break';
   if ((nSig >= WARN || cycling) && !warnedThis) return 'warn';
   return 'ok';
@@ -695,13 +699,22 @@ async function run(task, opts = {}) {
         result = { erro: 'MISSÃO INTERROMPIDA PELO LIMITE DE CUSTO/TEMPO. Esta ferramenta não foi executada.', guard: guardStopped };
       }
 
-      // ── WATCHDOG anti-loop: mede repetição ANTES de qualquer gate/execução ──
+      // Consulta o cache antes do watchdog, mas só entrega o resultado depois dos gates
+      // de segurança. Assim uma leitura repetida não vira falso loop, sem permitir que
+      // cache contorne escopo estrito, modo somente leitura ou outras políticas.
+      const _cachedRead = READONLY.has(name) ? _missionCache.get(name, input) : null;
+
+      // ── WATCHDOG anti-loop: mede somente chamadas que realmente precisariam executar ──
       const _sig = loopSig(name, input);
-      _recentSigs.push(_sig); if (_recentSigs.length > 8) _recentSigs.shift();
-      const _nSig = (_callCounts.get(_sig) || 0) + 1; _callCounts.set(_sig, _nSig);
-      const _cycling = isCycle(_recentSigs);
+      let _nSig = _callCounts.get(_sig) || 0;
+      let _cycling = false;
+      if (!_cachedRead) {
+        _recentSigs.push(_sig); if (_recentSigs.length > 8) _recentSigs.shift();
+        _nSig++; _callCounts.set(_sig, _nSig);
+        _cycling = isCycle(_recentSigs);
+      }
       const _verdict = loopedOut ? 'ended'
-        : loopDecision({ nSig: _nSig, cycling: _cycling, warnedThis: _warnedSigs.has(_sig), loopWarned: _loopWarned, WARN: LOOP_WARN, BREAK: LOOP_BREAK });
+        : loopDecision({ nSig: _nSig, cycling: _cycling, warnedThis: _warnedSigs.has(_sig), loopWarned: _loopWarned, WARN: LOOP_WARN, BREAK: LOOP_BREAK, cacheHit: !!_cachedRead });
       if (_verdict === 'ended') {
         // um tc anterior deste lote já disparou o corte → os demais fecham sem executar
         result = { erro: lang !== 'en' ? 'LOOP encerrado — não execute mais ferramentas; conclua.' : 'LOOP ended — do not run more tools; conclude.' };
@@ -985,7 +998,7 @@ async function run(task, opts = {}) {
         steps++; _ran = true;
       }
       if (result === undefined && READONLY.has(name)) {
-        const _cached = _missionCache.get(name, input);
+        const _cached = _cachedRead;
         if (_cached) {
           const _visible = messages.some(m => m && m.role === 'tool' && m.tool_call_id === _cached.toolCallId);
           _cachedContent = cacheReference(_cached, name, _visible);

package/package.json

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