terminal-smart-cli 0.32.0 → 0.33.0

package/bin/ts.js

@@ -747,6 +747,7 @@ async function agentCmd(words, { askFn, cwd: cwdIn = null, onCwd = null } = {})
   if (task.length < 8) { console.error(ui.infoLine(T.agent_need)); process.exit(2); }
 
   const agent = require('../lib/agent');
+  const core = require('../lib/core'); // envelope de eventos canônico (stream-json)
   // --modelo/--model força o executor do agente (bake-off de modelos, ex: --modelo glm-5.2)
   const _mi = process.argv.findIndex(a => a === '--modelo' || a === '--model');
   const model = _mi >= 0 ? (process.argv[_mi + 1] || null) : null;
@@ -783,14 +784,14 @@ async function agentCmd(words, { askFn, cwd: cwdIn = null, onCwd = null } = {})
   const ask = askFn || ui.ask;
   const sp = streamJson ? { text() {}, start() {}, stop() {} } : ui.spinner(T.agent_thinking).start();
   const t0 = Date.now();
-  if (streamJson) _emit({ type: 'system', subtype: 'init', model: model || 'auto', cwd: startCwd, mode: plan ? 'plan' : readOnly ? 'ask' : 'agent' });
+  if (streamJson) _emit(core.AgentEvents.systemInit({ model: model || 'auto', cwd: startCwd, mode: plan ? 'plan' : readOnly ? 'ask' : 'agent' }));
   let out;
   try {
     out = await agent.run(task, {
       token, lang: cfg.lang || 'pt', yes: YES, model, priorMessages, cwd: startCwd, readOnly, plan,
       onThinking: () => sp.text(T.agent_thinking),
       onStep: ({ name, detail, blocked }) => {
-        if (streamJson) { _emit({ type: 'tool', subtype: blocked ? 'blocked' : 'started', tool: name, detail: detail || '' }); return; }
+        if (streamJson) { _emit(core.AgentEvents.tool({ subtype: blocked ? 'blocked' : 'started', tool: name, detail: detail || '' })); return; }
         sp.stop();
         const tag = blocked ? C.err('■ ' + T.agent_blocked) : C.cyan('⚙');
         console.log('  ' + tag + ' ' + C.bold(name) + (detail ? C.dim(' · ' + detail) : ''));
@@ -798,14 +799,14 @@ async function agentCmd(words, { askFn, cwd: cwdIn = null, onCwd = null } = {})
       },
       askApprove: async (cmd) => {
         // headless (stream-json): não dá pra perguntar → NEGA o destrutivo e sinaliza o evento.
-        if (streamJson) { _emit({ type: 'tool', subtype: 'approval_denied', reason: 'headless (--stream-json): destructive command not auto-approved', command: cmd }); return false; }
+        if (streamJson) { _emit(core.AgentEvents.tool({ subtype: 'approval_denied', reason: 'headless (--stream-json): destructive command not auto-approved', command: cmd })); return false; }
         sp.stop();
         const ans = String(await ask(C.err('▲ ') + T.agent_approve(C.bold(cmd)))).trim().toLowerCase();
         sp.start();
         return ['s', 'sim', 'y', 'yes'].includes(ans);
       },
       onRemote: ({ ttl }) => {
-        if (streamJson) { _emit({ type: 'tool', subtype: 'approval_remote', ttl: ttl || 120 }); return; }
+        if (streamJson) { _emit(core.AgentEvents.tool({ subtype: 'approval_remote', ttl: ttl || 120 })); return; }
         sp.stop();
         console.log('  ' + C.warn('▲') + ' ' + C.dim(T.agent_remote_wait(ttl || 120)));
         sp.start();
@@ -837,8 +838,8 @@ async function agentCmd(words, { askFn, cwd: cwdIn = null, onCwd = null } = {})
   };
   // HEADLESS stream-json: fecha com assistant (texto) + result (métricas) e sai.
   if (streamJson) {
-    _emit({ type: 'assistant', text: out.text || '' });
-    _emit({ type: 'result', steps: out.steps, credits: out.credits, tokens: out.tokens, context: out.context || null, needHuman: out.needHuman || null, cwd: effCwd, duration_ms: Date.now() - t0, worktree: _wt ? { path: _wt.path, branch: _wt.branch, base: _wt.base, changed: (_wtInfo && _wtInfo.changed) || 0 } : null });
+    _emit(core.AgentEvents.assistant(out.text || ''));
+    _emit(core.AgentEvents.result({ steps: out.steps, credits: out.credits, tokens: out.tokens, context: out.context || null, needHuman: out.needHuman || null, cwd: effCwd, duration_ms: Date.now() - t0, worktree: _wt ? { path: _wt.path, branch: _wt.branch, base: _wt.base, changed: (_wtInfo && _wtInfo.changed) || 0 } : null }));
     return;
   }
   if (JSON_OUT) { console.log(JSON.stringify({ ok: true, result: out.text, steps: out.steps, credits: out.credits, tokens: out.tokens, context: out.context, needHuman: out.needHuman })); return; }

package/lib/agent.js

@@ -32,32 +32,14 @@ function installedSkills() {
 
 const MAX_ITER = 15;
 const TOOL_RESULT_CAP = 6000; // chars por resultado no contexto (compactor já reduz antes)
-// Executor padrão do agente/missão: deepseek-v4-flash venceu o bake-off de código
-// (3-5x mais barato e eficiente que MiniMax/kimi/glm). O roteador 'smart' caía no
-// MiniMax caro; fixar aqui corta custo e melhora qualidade. --modelo sobrepõe.
-const DEFAULT_EXECUTOR = 'deepseek-v4-flash';
 
-// ── AUTO-COMPACTAÇÃO DE CONTEXTO ─────────────────────────────────────────────
-// Modelos degradam BEM antes do limite duro (e o kimi buga perto do dele), então
-// compactamos PROATIVO a ~65% da janela: o histórico antigo vira UM resumo denso
-// e as últimas mensagens ficam íntegras — a conversa nunca "morre" por contexto.
-const MODEL_WINDOWS = {
-  'deepseek': 128000, 'glm-5.2': 200000, 'glm-4.7': 128000, 'kimi': 200000,
-  'minimax': 200000, 'qwen': 64000, 'gemini': 500000, 'mimo': 128000,
-};
-const CTX_WINDOW_DEFAULT = 100000; // modelo desconhecido → conservador
-// limiar/rabo têm override por env (TS_COMPACT_AT / TS_COMPACT_TAIL) — usado nos
-// testes pra forçar a compactação numa conversa curta, e por power users pra afinar.
-const COMPACT_AT = Number(process.env.TS_COMPACT_AT) > 0 ? Number(process.env.TS_COMPACT_AT) : 0.65;
-// piso de 6: rabo curto demais apaga a memória de trabalho e o agente relê arquivos em loop
-const KEEP_TAIL = Math.max(6, Number(process.env.TS_COMPACT_TAIL) > 0 ? Number(process.env.TS_COMPACT_TAIL) : 10);
-function winFor(model) {
-  const m = String(model || DEFAULT_EXECUTOR).toLowerCase();
-  for (const k of Object.keys(MODEL_WINDOWS)) if (m.includes(k)) return MODEL_WINDOWS[k];
-  return CTX_WINDOW_DEFAULT;
-}
-// heurística chars/4 (mesma do compactor) — suficiente pra decidir QUANDO compactar
-const estMsgsTok = (msgs) => msgs.reduce((n, m) => n + Math.ceil(((typeof m.content === 'string' ? m.content : JSON.stringify(m.content || '')).length + (m.tool_calls ? JSON.stringify(m.tool_calls).length : 0)) / 4), 0);
+// ── NÚCLEO CANÔNICO ──────────────────────────────────────────────────────────
+// Executor padrão, janelas de contexto e auto-compactação vêm de lib/core.js (fonte
+// única compartilhável). deepseek-v4-flash venceu o bake-off de código (3-5x mais
+// barato); compactamos PROATIVO a ~65% da janela (o histórico antigo vira UM resumo
+// denso e as últimas mensagens ficam íntegras) — a conversa nunca "morre" por contexto.
+const core = require('./core');
+const { DEFAULT_EXECUTOR, COMPACT_AT, KEEP_TAIL, winFor, estMsgsTok } = core;
 
 function systemPrompt(lang, cwd) {
   const pt = lang !== 'en';

package/lib/core.js

@@ -0,0 +1,76 @@
+// lib/core.js — NÚCLEO CANÔNICO do motor de agente do Terminal Smart.
+//
+// Decisão de arquitetura (2026-07-18, auditoria de paridade dos 3 motores CLI/App/Web):
+// o motor do CLI é o super-conjunto e vira o núcleo oficial. Este arquivo concentra as
+// partes PURAS e SEM efeito colateral que hoje estavam reimplementadas de forma
+// divergente no App (needsConfirm/DESTRUCTIVE_RE, _compactConvInPlace) e no Web
+// (_scanDanger, histHot). O CLI é o primeiro a consumi-lo (dogfood); App e Web
+// convergem sobre ele depois (via stream-json/ACP). Ver reference_ts_3_motores_paridade.
+//
+// REGRA: capacidade nova de agente (gate, compactação, roteamento, envelope de eventos)
+// entra AQUI primeiro. Nada neste arquivo pode ter efeito colateral (I/O, rede, estado)
+// — só funções puras e constantes, pra ser importável por qualquer superfície e testável.
+
+// ── 1) GATE DE DESTRUTIVO ─────────────────────────────────────────────────────
+// Padrões de comando destrutivo/irreversível — SEMPRE pedem aprovação humana.
+// (fonte única: antes vivia em tools.js; App e Web tinham cópias divergentes.)
+const DESTRUCTIVE = [
+  /\brm\s+(-[a-z]*[rf][a-z]*\s+)/i, /\brm\s+.*\*/, /\brmdir\b/i, /\bdel\s+\/[sq]/i, /\brd\s+\/s/i,
+  /\bmkfs\b/i, /\bdd\s+if=/i, /(?:^|[\s&;|])format\s+[a-z]:/i, /\bdiskpart\b/i, /> ?\/dev\/sd/i,
+  /\bshutdown\b/i, /\breboot\b/i, /\bhalt\b/i, /\bpoweroff\b/i,
+  /\bDROP\s+(TABLE|DATABASE)\b/i, /\bTRUNCATE\b/i, /\bDELETE\s+FROM\b[^;]*(;|$)(?![^]*WHERE)/i,
+  /\bchmod\s+(-R\s+)?777\b/i, /\bgit\s+push\s+.*--force(?!-with-lease)/i, /\bgit\s+reset\s+--hard/i,
+  /:\(\)\s*\{/, /\bcurl\b[^|]*\|\s*(sudo\s+)?(ba)?sh/i, /\bwget\b[^|]*\|\s*(sudo\s+)?(ba)?sh/i,
+  /\bkillall\b/i, /\bpkill\b/i, /\buserdel\b/i, /\bpasswd\b/i,
+  /\btaskkill\b.*\/im\b/i, /\btaskkill\b.*\/f\b.*\/im/i, // taskkill /IM mata TODOS os processos daquele nome (ex: node.exe = a própria missão)
+  /\bStop-Process\b[^|;&]*-Name\b/i, /\bGet-Process\b[^|]*\|[^|]*\bStop-Process\b/i, // PowerShell: matar por NOME mata todos (=taskkill /IM); Stop-Process -Id <pid> segue liberado
+  /\bsystemctl\s+(stop|disable|mask)\b/i, /\bdocker\s+(rm|rmi|system\s+prune|volume\s+rm)\b/i,
+];
+function isDestructive(cmd) { return DESTRUCTIVE.some(re => re.test(String(cmd || ''))); }
+
+// ── 2) JANELA DE CONTEXTO / AUTO-COMPACTAÇÃO ──────────────────────────────────
+// Modelos degradam BEM antes do limite duro; compactamos PROATIVO a ~65% da janela.
+const MODEL_WINDOWS = {
+  'deepseek': 128000, 'glm-5.2': 200000, 'glm-4.7': 128000, 'kimi': 200000,
+  'minimax': 200000, 'qwen': 64000, 'gemini': 500000, 'mimo': 128000,
+};
+const CTX_WINDOW_DEFAULT = 100000; // modelo desconhecido → conservador
+const DEFAULT_EXECUTOR = 'deepseek-v4-flash'; // executor padrão (venceu o bake-off de código)
+// limiar/rabo têm override por env (TS_COMPACT_AT / TS_COMPACT_TAIL) — usado nos testes.
+const COMPACT_AT = Number(process.env.TS_COMPACT_AT) > 0 ? Number(process.env.TS_COMPACT_AT) : 0.65;
+// piso de 6: rabo curto demais apaga a memória de trabalho e o agente relê arquivos em loop
+const KEEP_TAIL = Math.max(6, Number(process.env.TS_COMPACT_TAIL) > 0 ? Number(process.env.TS_COMPACT_TAIL) : 10);
+function winFor(model) {
+  const m = String(model || DEFAULT_EXECUTOR).toLowerCase();
+  for (const k of Object.keys(MODEL_WINDOWS)) if (m.includes(k)) return MODEL_WINDOWS[k];
+  return CTX_WINDOW_DEFAULT;
+}
+// heurística chars/4 — suficiente pra decidir QUANDO compactar
+const estMsgsTok = (msgs) => msgs.reduce((n, m) => n + Math.ceil(((typeof m.content === 'string' ? m.content : JSON.stringify(m.content || '')).length + (m.tool_calls ? JSON.stringify(m.tool_calls).length : 0)) / 4), 0);
+
+// ── 3) ENVELOPE DE EVENTOS (contrato interno único) ───────────────────────────
+// Formaliza os eventos que o modo headless (stream-json) já emite. Este é o CONTRATO
+// canônico: quando App (IPC ai:event) e Web (SSE) convergirem, mapeiam pra ESTAS formas.
+// Tipos: system(init) · tool(started|blocked|approval_denied|approval_remote) · assistant · result.
+const AgentEvents = {
+  systemInit: ({ model, cwd, mode }) => ({ type: 'system', subtype: 'init', model, cwd, mode }),
+  tool: ({ subtype, tool, detail, reason, command, ttl }) => {
+    const e = { type: 'tool', subtype };
+    if (tool !== undefined) e.tool = tool;
+    if (detail !== undefined) e.detail = detail;
+    if (reason !== undefined) e.reason = reason;
+    if (command !== undefined) e.command = command;
+    if (ttl !== undefined) e.ttl = ttl;
+    return e;
+  },
+  assistant: (text) => ({ type: 'assistant', text: text || '' }),
+  result: (fields) => Object.assign({ type: 'result' }, fields),
+};
+// nomes dos eventos, pra quem for validar/mapear (App/Web)
+const EVENT_TYPES = ['system', 'tool', 'assistant', 'result'];
+
+module.exports = {
+  DESTRUCTIVE, isDestructive,
+  MODEL_WINDOWS, CTX_WINDOW_DEFAULT, DEFAULT_EXECUTOR, COMPACT_AT, KEEP_TAIL, winFor, estMsgsTok,
+  AgentEvents, EVENT_TYPES,
+};

package/lib/tools.js

@@ -34,20 +34,9 @@ function _snapshot(absPath) {
   } catch (_) { return null; }
 }
 
-// Padrões de comando destrutivo/irreversível — SEMPRE pedem aprovação humana.
-const DESTRUCTIVE = [
-  /\brm\s+(-[a-z]*[rf][a-z]*\s+)/i, /\brm\s+.*\*/, /\brmdir\b/i, /\bdel\s+\/[sq]/i, /\brd\s+\/s/i,
-  /\bmkfs\b/i, /\bdd\s+if=/i, /(?:^|[\s&;|])format\s+[a-z]:/i, /\bdiskpart\b/i, /> ?\/dev\/sd/i,
-  /\bshutdown\b/i, /\breboot\b/i, /\bhalt\b/i, /\bpoweroff\b/i,
-  /\bDROP\s+(TABLE|DATABASE)\b/i, /\bTRUNCATE\b/i, /\bDELETE\s+FROM\b[^;]*(;|$)(?![^]*WHERE)/i,
-  /\bchmod\s+(-R\s+)?777\b/i, /\bgit\s+push\s+.*--force(?!-with-lease)/i, /\bgit\s+reset\s+--hard/i,
-  /:\(\)\s*\{/, /\bcurl\b[^|]*\|\s*(sudo\s+)?(ba)?sh/i, /\bwget\b[^|]*\|\s*(sudo\s+)?(ba)?sh/i,
-  /\bkillall\b/i, /\bpkill\b/i, /\buserdel\b/i, /\bpasswd\b/i,
-  /\btaskkill\b.*\/im\b/i, /\btaskkill\b.*\/f\b.*\/im/i, // taskkill /IM mata TODOS os processos daquele nome (ex: node.exe = a própria missão)
-  /\bStop-Process\b[^|;&]*-Name\b/i, /\bGet-Process\b[^|]*\|[^|]*\bStop-Process\b/i, // PowerShell: matar por NOME mata todos (=taskkill /IM); Stop-Process -Id <pid> segue liberado
-  /\bsystemctl\s+(stop|disable|mask)\b/i, /\bdocker\s+(rm|rmi|system\s+prune|volume\s+rm)\b/i,
-];
-function isDestructive(cmd) { return DESTRUCTIVE.some(re => re.test(String(cmd || ''))); }
+// Gate de destrutivo: fonte ÚNICA no núcleo canônico (lib/core.js). Reexportado aqui
+// pra compatibilidade (tools.isDestructive segue funcionando pra quem já importava).
+const { isDestructive } = require('./core');
 
 // Definições no formato OpenAI function-calling — schemas SIMPLES de propósito
 // (Gemini via CDC rejeita propertyNames/additionalProperties; só type/properties/required).

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "terminal-smart-cli",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "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"
+  },
   "files": [
     "bin",
     "lib",