theus-cli-linux-arm64 1.2.1 → 1.3.0

package/vendor/theus-arsenal/scripts/hooks/theus-context-monitor.js

@@ -1,289 +0,0 @@
-#!/usr/bin/env node
-/**
- * Monitor de contexto de Theus — hook PostToolUse
- *
- * Lee el archivo puente generado por theus-metrics-bridge.js e inyecta
- * avisos dirigidos al agente cuando se cruzan umbrales: agotamiento de
- * contexto, costo alto, expansión de alcance (scope creep) o bucles de tools.
- */
-
-'use strict';
-
-const crypto = require('crypto');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { sanitizeSessionId, readBridge, renameWithRetry } = require('../lib/session-bridge');
-
-const CONTEXT_WARNING_PCT = 35;
-const CONTEXT_CRITICAL_PCT = 25;
-const COST_NOTICE_USD = 5;
-const COST_WARNING_USD = 10;
-const COST_CRITICAL_USD = 50;
-const FILES_WARNING_COUNT = 20;
-const LOOP_THRESHOLD = 3;
-const STALE_SECONDS = 60;
-
-function isEnabledEnv(value, defaultValue = true) {
-  if (value === undefined || value === null || String(value).trim() === '') {
-    return defaultValue;
-  }
-  const normalized = String(value).trim().toLowerCase();
-  if (['0', 'false', 'no', 'off', 'disabled'].includes(normalized)) return false;
-  if (['1', 'true', 'yes', 'on', 'enabled'].includes(normalized)) return true;
-  return defaultValue;
-}
-
-function costWarningsEnabled(env = process.env) {
-  return isEnabledEnv(env.THEUS_CONTEXT_MONITOR_COST_WARNINGS, true);
-}
-
-/**
- * Obtiene la ruta del archivo de estado de debounce.
- * @param {string} sessionId
- * @returns {string}
- */
-function getWarnPath(sessionId) {
-  return path.join(os.tmpdir(), `theus-ctx-warn-${sessionId}.json`);
-}
-
-/**
- * Lee el estado de debounce.
- * @param {string} sessionId
- * @returns {object}
- */
-function readWarnState(sessionId) {
-  try {
-    return JSON.parse(fs.readFileSync(getWarnPath(sessionId), 'utf8'));
-  } catch {
-    return { callsSinceWarn: 0, lastSeverity: null, lastMessage: null };
-  }
-}
-
-/**
- * Escribe el estado de debounce de forma atómica (tmp con sufijo único y luego rename).
- *
- * La ruta tmp incluye `process.pid` más un nonce aleatorio para que
- * subprocesos PostToolUse concurrentes que escriben al archivo de estado
- * de la misma sesión no se pisen el tmp a mitad de escritura. Sin el sufijo
- * único, dos escritores compiten por un `${target}.tmp` compartido y
- * producen un payload corrupto o un ENOENT en el segundo rename.
- *
- * Mismo patrón que `writeBridgeAtomic` en `scripts/lib/session-bridge.js`
- * y `writeCostWarningIfChanged` en `scripts/hooks/theus-metrics-bridge.js`.
- *
- * @param {string} sessionId
- * @param {object} state
- */
-function writeWarnState(sessionId, state) {
-  const target = getWarnPath(sessionId);
-  const tmp = `${target}.${process.pid}.${crypto.randomBytes(4).toString('hex')}.tmp`;
-  fs.writeFileSync(tmp, JSON.stringify(state), 'utf8');
-  try {
-    renameWithRetry(tmp, target);
-  } catch (err) {
-    try { fs.unlinkSync(tmp); } catch { /* ignorar */ }
-    throw err;
-  }
-}
-
-/**
- * Detecta bucles de tools a partir del buffer circular recent_tools.
- * @param {Array} recentTools
- * @returns {{detected: boolean, tool: string, count: number}}
- */
-function detectLoop(recentTools) {
-  if (!Array.isArray(recentTools) || recentTools.length < LOOP_THRESHOLD) {
-    return { detected: false, tool: '', count: 0 };
-  }
-  const counts = {};
-  for (const entry of recentTools) {
-    const key = `${entry.tool}:${entry.hash}`;
-    counts[key] = (counts[key] || 0) + 1;
-  }
-  for (const [key, count] of Object.entries(counts)) {
-    if (count >= LOOP_THRESHOLD) {
-      return { detected: true, tool: key.split(':')[0], count };
-    }
-  }
-  return { detected: false, tool: '', count: 0 };
-}
-
-/**
- * Evalúa todas las condiciones de aviso contra los datos del puente.
- * Devuelve un arreglo de {severity, type, message} ordenado por severidad descendente.
- */
-function evaluateConditions(bridge, options = {}) {
-  const warnings = [];
-  const remaining = bridge.context_remaining_pct;
-
-  // Avisos de contexto (se omiten si no hay datos de contexto)
-  if (remaining !== null && remaining !== undefined) {
-    if (remaining <= CONTEXT_CRITICAL_PCT) {
-      warnings.push({
-        severity: 3,
-        type: 'context',
-        message:
-          `CONTEXTO CRÍTICO: queda ${remaining}%. El contexto está casi agotado. ` +
-          'Informa al usuario de que el contexto está bajo y pregúntale cómo quiere proceder. ' +
-          'NO guardes estado ni escribas archivos de traspaso de forma autónoma salvo que el usuario lo pida.'
-      });
-    } else if (remaining <= CONTEXT_WARNING_PCT) {
-      warnings.push({
-        severity: 2,
-        type: 'context',
-        message: `AVISO DE CONTEXTO: queda ${remaining}%. ` + 'Ten presente que el contexto se está agotando. Evita iniciar trabajo complejo nuevo.'
-      });
-    }
-  }
-
-  // Avisos de costo
-  if (options.costWarnings !== false) {
-    const cost = bridge.total_cost_usd || 0;
-    if (cost > COST_CRITICAL_USD) {
-      warnings.push({
-        severity: 3,
-        type: 'cost',
-        message: `COSTO CRÍTICO: total de la sesión ~$${cost.toFixed(2)} (supera $${COST_CRITICAL_USD}). Solo informativo — no es una instrucción para detenerse.`
-      });
-    } else if (cost > COST_WARNING_USD) {
-      warnings.push({
-        severity: 2,
-        type: 'cost',
-        message: `AVISO DE COSTO: total de la sesión ~$${cost.toFixed(2)} (supera $${COST_WARNING_USD}). Solo informativo.`
-      });
-    } else if (cost > COST_NOTICE_USD) {
-      warnings.push({
-        severity: 1,
-        type: 'cost',
-        message: `NOTA DE COSTO: total de la sesión ~$${cost.toFixed(2)}. Solo informativo.`
-      });
-    }
-  }
-
-  // Aviso de alcance por archivos
-  const fileCount = bridge.files_modified_count || 0;
-  if (fileCount > FILES_WARNING_COUNT) {
-    warnings.push({
-      severity: 2,
-      type: 'scope',
-      message: `AVISO DE ALCANCE: ${fileCount} archivos modificados en esta sesión. ` + 'Evalúa si los cambios están demasiado dispersos.'
-    });
-  }
-
-  // Detección de bucles
-  const loop = detectLoop(bridge.recent_tools);
-  if (loop.detected) {
-    warnings.push({
-      severity: 2,
-      type: 'loop',
-      message: `AVISO DE BUCLE: la tool '${loop.tool}' se llamó ${loop.count} veces ` + 'con los mismos parámetros en las últimas 5 llamadas. Puede indicar un bucle atascado.'
-    });
-  }
-
-  return warnings.sort((a, b) => b.severity - a.severity);
-}
-
-/**
- * Mapea la severidad numérica a una etiqueta.
- */
-function severityLabel(n) {
-  if (n >= 3) return 'critical';
-  if (n >= 2) return 'warning';
-  return 'notice';
-}
-
-/**
- * @param {string} rawInput - Cadena JSON cruda desde stdin
- * @returns {string} Salida JSON con additionalContext o passthrough
- */
-function run(rawInput) {
-  try {
-    const input = rawInput.trim() ? JSON.parse(rawInput) : {};
-
-    // Theus entrega session_id por stdin en cada evento de hook.
-    const sessionId = sanitizeSessionId(input.session_id);
-
-    if (!sessionId) return rawInput;
-
-    const bridge = readBridge(sessionId);
-    if (!bridge) return rawInput;
-
-    // Verificación de obsolescencia para los avisos de contexto
-    const now = Math.floor(Date.now() / 1000);
-    const lastTs = bridge.last_timestamp ? Math.floor(new Date(bridge.last_timestamp).getTime() / 1000) : 0;
-    const isStale = lastTs > 0 && now - lastTs > STALE_SECONDS;
-
-    // Si el puente está obsoleto, anula los datos de contexto (igual se evalúan costo/alcance/bucle)
-    const evalBridge = isStale ? { ...bridge, context_remaining_pct: null } : bridge;
-
-    const warnings = evaluateConditions(evalBridge, { costWarnings: costWarningsEnabled() });
-    if (warnings.length === 0) {
-      // Limpia el estado de deduplicación cuando la condición se resuelve, para
-      // que el MISMO texto de aviso que reaparezca más tarde (el contexto baja,
-      // se recupera y vuelve a bajar; un bucle que se detiene y reinicia) vuelva
-      // a mostrarse en lugar de suprimirse como duplicado. Solo se escribe
-      // cuando hay estado que limpiar — la mayoría de las llamadas a tools no
-      // tienen aviso, y así la ruta común queda libre de escrituras a disco.
-      const prior = readWarnState(sessionId);
-      if (prior.lastMessage) {
-        writeWarnState(sessionId, { callsSinceWarn: 0, lastSeverity: null, lastMessage: null });
-      }
-      return rawInput;
-    }
-
-    // Combina los 2 avisos principales
-    const message = warnings
-      .slice(0, 2)
-      .map(w => w.message)
-      .join('\n');
-
-    // Deduplica por contenido del mensaje, no por contador de llamadas. La
-    // lógica anterior reemitía el *mismo* aviso cada DEBOUNCE_CALLS llamadas,
-    // así que una única condición sin cambios (p. ej. una cifra de costo que
-    // solo se refresca al cambiar de turno) imprimía la línea idéntica ~20
-    // veces en un turno. Ahora un aviso solo se muestra cuando su texto cambia
-    // (el costo se movió, un nuevo conteo de archivos, un bucle nuevo) o cuando
-    // recién escala a crítico — información genuinamente nueva — y en cualquier
-    // otro caso se suprime.
-    const warnState = readWarnState(sessionId);
-    const topSeverity = severityLabel(warnings[0].severity);
-    const escalatedToCritical = topSeverity === 'critical' && warnState.lastSeverity !== 'critical';
-    const sameMessage = warnState.lastMessage === message;
-
-    if (sameMessage && !escalatedToCritical) {
-      return rawInput;
-    }
-
-    warnState.lastSeverity = topSeverity;
-    warnState.lastMessage = message;
-    writeWarnState(sessionId, warnState);
-
-    const output = {
-      hookSpecificOutput: {
-        hookEventName: 'PostToolUse',
-        additionalContext: message
-      }
-    };
-
-    return JSON.stringify(output);
-  } catch {
-    // Nunca bloquear la ejecución de la tool
-    return rawInput;
-  }
-}
-
-if (require.main === module) {
-  let data = '';
-  const MAX_STDIN = 1024 * 1024;
-  process.stdin.setEncoding('utf8');
-  process.stdin.on('data', chunk => {
-    if (data.length < MAX_STDIN) data += chunk.substring(0, MAX_STDIN - data.length);
-  });
-  process.stdin.on('end', () => {
-    process.stdout.write(run(data));
-    process.exit(0);
-  });
-}
-
-module.exports = { run, evaluateConditions, detectLoop, severityLabel, costWarningsEnabled };