terminal-smart-cli 0.97.14 → 0.97.16

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/i18n.js

@@ -163,7 +163,7 @@ const STR = {
     chat_bye: 'Até logo! A conversa continua salva na web (/ia).',
     agent_need: 'Descreva a tarefa. Ex.:  ts agente "libere espaço em disco analisando as pastas maiores"',
     agent_thinking: 'agente pensando',
-    agent_blocked: 'bloqueado (destrutivo)',
+    agent_blocked: 'bloqueado pelo harness',
     agent_approve: (cmd) => `O agente quer rodar um comando DESTRUTIVO:\n\n    ${cmd}\n\n  Permitir? (s/N) `,
     agent_footer: (st, cr, s) => `${st} passo(s) · ${cr} créditos · ${s}`,
     agent_footer_byok: (st, prov, s) => `${st} passo(s) · sua chave (${prov}) · ${s}`,
@@ -332,7 +332,7 @@ const STR = {
     chat_bye: 'See you! The conversation stays saved on the web (/ia).',
     agent_need: 'Describe the task. E.g.:  ts agente "free disk space by analyzing the largest folders"',
     agent_thinking: 'agent thinking',
-    agent_blocked: 'blocked (destructive)',
+    agent_blocked: 'blocked by harness',
     agent_approve: (cmd) => `The agent wants to run a DESTRUCTIVE command:\n\n    ${cmd}\n\n  Allow? (y/N) `,
     agent_footer: (st, cr, s) => `${st} step(s) · ${cr} credits · ${s}`,
     agent_footer_byok: (st, prov, s) => `${st} step(s) · your key (${prov}) · ${s}`,

package/lib/meta.js

@@ -49,7 +49,7 @@ function artifactForMetaItem(item, st) {
   const list = Array.isArray(st && st.checklist) ? st.checklist : [];
   const index = Math.max(0, list.indexOf(item));
   const criterion = Array.isArray(st && st.criteria) ? st.criteria[index] : null;
-  if (criterion && criterion.type === 'file_exists' && criterion.path) return String(criterion.path);
+  if (criterion && ['file_exists', 'file_contains'].includes(criterion.type) && criterion.path) return String(criterion.path);
   const d = String(item && item.desc || '').toLowerCase();
   if (/controller.*8 dire|8 dire.*controller/.test(d)) return 'src/player_controller.gd';
   if (/combate b[aá]sico|sistema de combate/.test(d)) return 'src/combat_system.gd';
@@ -1630,13 +1630,17 @@ async function run(goal, opts = {}) {
     if (expectedNow && !wroteExpectedNow) {
       item.attempts = Math.max(0, (item.attempts || 1) - 1);
       item.avoidModels = [...new Set([...(item.avoidModels || []), String(out.model || roundModel || 'automatico')])];
-      item.directArtifact = true;
+      const expectedTarget = path.isAbsolute(expectedArtifact) ? expectedArtifact : path.resolve(dir, expectedArtifact);
+      // Conteúdo direto é seguro para um artefato NOVO. Para código existente ele poderia
+      // substituir o projeto inteiro por uma resposta parcial do item; nesse caso troque o
+      // executor e obrigue uma edição real, preservando o arquivo atual.
+      item.directArtifact = !fs.existsSync(expectedTarget);
       const failedModel = String(out.model || roundModel || 'glm-5.2');
-      item.directModel = /glm/i.test(failedModel) ? 'glm-5.2' : failedModel;
+      if (item.directArtifact) item.directModel = /glm/i.test(failedModel) ? 'glm-5.2' : failedModel;
       st.status = 'paused'; st.pause_reason = 'model_no_action';
       st.budget = st.creditsSpent;
       save(st, dir);
-      onAlert({ type: 'retry', text: `O modelo ${out.model || roundModel || 'automatico'} respondeu, mas executou zero ferramentas. Nao marquei falha do item; a retomada usara outro executor.` });
+      onAlert({ type: 'retry', text: `O modelo ${out.model || roundModel || 'automatico'} não persistiu o artefato esperado. Não marquei o item como concluído; a retomada usará outro executor sem substituir código existente.` });
       return st;
     }
 

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