theus-cli-linux-arm64 0.2.84

package/vendor/theus-arsenal/skills/aprendizaje-continuo-v2/agents/session-guardian.sh

@@ -0,0 +1,153 @@
+#!/usr/bin/env bash
+# session-guardian.sh — Guarda de sesión del observador
+# Exit 0 = continuar. Exit 1 = omitir este ciclo del observador.
+# Lo invoca observer-loop.sh antes de lanzar cualquier sesión del agente.
+#
+# Configuración (variables de entorno, todas opcionales):
+#   OBSERVER_INTERVAL_SECONDS    por defecto: 300   (cooldown por proyecto)
+#   OBSERVER_LAST_RUN_LOG        por defecto: ~/.theus/arsenal/observer-last-run.log
+#   OBSERVER_ACTIVE_HOURS_START  por defecto: 800   (8:00 hora local, 0 para desactivar)
+#   OBSERVER_ACTIVE_HOURS_END    por defecto: 2300  (23:00 hora local, 0 para desactivar)
+#   OBSERVER_MAX_IDLE_SECONDS    por defecto: 1800  (30 min; 0 para desactivar)
+#
+# Orden de ejecución de las puertas (la más barata primero):
+#   Puerta 1: Ventana horaria       (~0 ms, comparación de cadenas)
+#   Puerta 2: Log de cooldown       (~1 ms, lectura de archivo + lock mkdir)
+#   Puerta 3: Detección de inactividad (~5-50 ms, syscall del SO; falla en abierto)
+
+set -euo pipefail
+
+INTERVAL="${OBSERVER_INTERVAL_SECONDS:-300}"
+LOG_PATH="${OBSERVER_LAST_RUN_LOG:-$HOME/.theus/arsenal/observer-last-run.log}"
+ACTIVE_START="${OBSERVER_ACTIVE_HOURS_START:-800}"
+ACTIVE_END="${OBSERVER_ACTIVE_HOURS_END:-2300}"
+MAX_IDLE="${OBSERVER_MAX_IDLE_SECONDS:-1800}"
+
+# ── Puerta 1: Ventana horaria ────────────────────────────────────────────────
+# Omite los ciclos del observador fuera de las horas activas configuradas
+# (hora local del sistema). Usa comparación de enteros HHMM. Funciona con date
+# de BSD (macOS) y GNU (Linux). Soporta ventanas nocturnas como 2200-0600.
+# Pon ACTIVE_START y ACTIVE_END en 0 para desactivar esta puerta.
+if [ "$ACTIVE_START" -ne 0 ] || [ "$ACTIVE_END" -ne 0 ]; then
+  current_hhmm=$(date +%k%M | tr -d ' ')
+  current_hhmm_num=$(( 10#${current_hhmm:-0} ))
+  active_start_num=$(( 10#${ACTIVE_START:-800} ))
+  active_end_num=$(( 10#${ACTIVE_END:-2300} ))
+
+  within_active_hours=0
+  if [ "$active_start_num" -lt "$active_end_num" ]; then
+    if [ "$current_hhmm_num" -ge "$active_start_num" ] && [ "$current_hhmm_num" -lt "$active_end_num" ]; then
+      within_active_hours=1
+    fi
+  else
+    if [ "$current_hhmm_num" -ge "$active_start_num" ] || [ "$current_hhmm_num" -lt "$active_end_num" ]; then
+      within_active_hours=1
+    fi
+  fi
+
+  if [ "$within_active_hours" -ne 1 ]; then
+    echo "session-guardian: fuera de las horas activas (${current_hhmm}, ventana ${ACTIVE_START}-${ACTIVE_END})" >&2
+    exit 1
+  fi
+fi
+
+# ── Puerta 2: Log de cooldown por proyecto ───────────────────────────────────
+# Evita que el mismo proyecto se observe más rápido que OBSERVER_INTERVAL_SECONDS.
+# Clave: PROJECT_DIR cuando lo provee el observador; si no, la raíz del repo git.
+# Usa un lock basado en mkdir para acceso concurrente seguro. Omite el ciclo si
+# hay contención del lock. stderr usa solo el basename — nunca imprime la ruta
+# absoluta completa.
+
+project_root="${PROJECT_DIR:-}"
+if [ -z "$project_root" ] || [ ! -d "$project_root" ]; then
+  project_root="$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")"
+fi
+project_name="$(basename "$project_root")"
+now="$(date +%s)"
+
+mkdir -p "$(dirname "$LOG_PATH")" || {
+  echo "session-guardian: no se pudo crear el directorio del log, se continúa" >&2
+  exit 0
+}
+
+_lock_dir="${LOG_PATH}.lock"
+if ! mkdir "$_lock_dir" 2>/dev/null; then
+  # Otro observador tiene el lock — omitir este ciclo para evitar dobles lanzamientos
+  echo "session-guardian: log bloqueado por un proceso concurrente, se omite el ciclo" >&2
+  exit 1
+else
+  trap 'rm -rf "$_lock_dir"' EXIT INT TERM
+
+  last_spawn=0
+  last_spawn=$(awk -F '\t' -v key="$project_root" '$1 == key { value = $2 } END { if (value != "") print value }' "$LOG_PATH" 2>/dev/null) || true
+  last_spawn="${last_spawn:-0}"
+  [[ "$last_spawn" =~ ^[0-9]+$ ]] || last_spawn=0
+
+  elapsed=$(( now - last_spawn ))
+  if [ "$elapsed" -lt "$INTERVAL" ]; then
+    rm -rf "$_lock_dir"
+    trap - EXIT INT TERM
+    echo "session-guardian: cooldown activo para '${project_name}' (último lanzamiento hace ${elapsed}s, intervalo ${INTERVAL}s)" >&2
+    exit 1
+  fi
+
+  # Actualizar el log: quitar la entrada vieja de este proyecto y añadir el
+  # nuevo timestamp (delimitado por tabuladores)
+  tmp_log="$(mktemp "$(dirname "$LOG_PATH")/observer-last-run.XXXXXX")"
+  awk -F '\t' -v key="$project_root" '$1 != key' "$LOG_PATH" > "$tmp_log" 2>/dev/null || true
+  printf '%s\t%s\n' "$project_root" "$now" >> "$tmp_log"
+  mv "$tmp_log" "$LOG_PATH"
+
+  rm -rf "$_lock_dir"
+  trap - EXIT INT TERM
+fi
+
+# ── Puerta 3: Detección de inactividad ───────────────────────────────────────
+# Omite los ciclos cuando no hay entrada del usuario durante demasiado tiempo.
+# Falla en abierto si el tiempo de inactividad no puede determinarse (Linux sin
+# xprintidle, headless, SO desconocido).
+# Pon OBSERVER_MAX_IDLE_SECONDS=0 para desactivar esta puerta.
+
+get_idle_seconds() {
+  local _raw
+  case "$(uname -s)" in
+    Darwin)
+      _raw=$( { /usr/sbin/ioreg -c IOHIDSystem \
+        | /usr/bin/awk '/HIDIdleTime/ {print int($NF/1000000000); exit}'; } \
+        2>/dev/null ) || true
+      printf '%s\n' "${_raw:-0}" | head -n1
+      ;;
+    Linux)
+      if command -v xprintidle >/dev/null 2>&1; then
+        _raw=$(xprintidle 2>/dev/null) || true
+        echo $(( ${_raw:-0} / 1000 ))
+      else
+        echo 0  # falla en abierto: xprintidle no está instalado
+      fi
+      ;;
+    *MINGW*|*MSYS*|*CYGWIN*)
+      _raw=$(powershell.exe -NoProfile -NonInteractive -Command \
+        "try { \
+          Add-Type -MemberDefinition '[DllImport(\"user32.dll\")] public static extern bool GetLastInputInfo(ref LASTINPUTINFO p); [StructLayout(LayoutKind.Sequential)] public struct LASTINPUTINFO { public uint cbSize; public int dwTime; }' -Name WinAPI -Namespace PInvoke; \
+          \$l = New-Object PInvoke.WinAPI+LASTINPUTINFO; \$l.cbSize = 8; \
+          [PInvoke.WinAPI]::GetLastInputInfo([ref]\$l) | Out-Null; \
+          [int][Math]::Max(0, [long]([Environment]::TickCount - [long]\$l.dwTime) / 1000) \
+        } catch { 0 }" \
+        2>/dev/null | tr -d '\r') || true
+      printf '%s\n' "${_raw:-0}" | head -n1
+      ;;
+    *)
+      echo 0  # falla en abierto: plataforma desconocida
+      ;;
+  esac
+}
+
+if [ "$MAX_IDLE" -gt 0 ]; then
+  idle_seconds=$(get_idle_seconds)
+  if [ "$idle_seconds" -gt "$MAX_IDLE" ]; then
+    echo "session-guardian: usuario inactivo ${idle_seconds}s (umbral ${MAX_IDLE}s), se omite" >&2
+    exit 1
+  fi
+fi
+
+exit 0

package/vendor/theus-arsenal/skills/aprendizaje-continuo-v2/agents/start-observer.sh

@@ -0,0 +1,253 @@
+#!/usr/bin/env bash
+# Aprendizaje continuo v2 - Lanzador del agente observador
+#
+# Inicia el agente observador en segundo plano que analiza las observaciones
+# y crea instintos.
+#
+# v2.1: Con ámbito de proyecto — detecta el proyecto actual y analiza las
+#       observaciones específicas del proyecto en instintos de ese ámbito.
+#
+# Uso:
+#   start-observer.sh              # Inicia el observador del proyecto actual (o global)
+#   start-observer.sh --reset      # Limpia el lock y reinicia el observador del proyecto actual
+#   start-observer.sh stop         # Detiene el observador en ejecución
+#   start-observer.sh status       # Comprueba si el observador está corriendo
+
+set -e
+
+# NOTA: set -e se deshabilita dentro del subshell en segundo plano de abajo
+# para evitar que los fallos del CLI maten el bucle del observador.
+
+# ─────────────────────────────────────────────
+# Detección de proyecto
+# ─────────────────────────────────────────────
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SKILL_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+OBSERVER_LOOP_SCRIPT="${SCRIPT_DIR}/observer-loop.sh"
+
+# Cargar el helper compartido de detección de proyecto.
+# Define: PROJECT_ID, PROJECT_NAME, PROJECT_ROOT, PROJECT_DIR
+source "${SKILL_ROOT}/scripts/detect-project.sh"
+PYTHON_CMD="${ACV2_PYTHON_CMD:-}"
+
+# ─────────────────────────────────────────────
+# Configuración
+# ─────────────────────────────────────────────
+
+# shellcheck disable=SC1091
+. "${SKILL_ROOT}/scripts/lib/arsenal-dir.sh"
+CONFIG_DIR="$(_acv2_resolve_arsenal_dir)"
+if [ -n "${ACV2_CONFIG:-}" ]; then
+  CONFIG_FILE="$ACV2_CONFIG"
+elif [ -f "${CONFIG_DIR}/config.json" ]; then
+  CONFIG_FILE="${CONFIG_DIR}/config.json"
+else
+  CONFIG_FILE="${SKILL_ROOT}/config.json"
+fi
+# El archivo de PID tiene ámbito de proyecto para que cada proyecto pueda tener su propio observador
+PID_FILE="${PROJECT_DIR}/.observer.pid"
+LOG_FILE="${PROJECT_DIR}/observer.log"
+OBSERVATIONS_FILE="${PROJECT_DIR}/observations.jsonl"
+INSTINCTS_DIR="${PROJECT_DIR}/instincts/personal"
+SENTINEL_FILE="${ACV2_OBSERVER_SENTINEL_FILE:-${PROJECT_ROOT:-$PROJECT_DIR}/.observer.lock}"
+
+write_guard_sentinel() {
+  printf '%s\n' 'observador en pausa: se detectó un prompt de confirmación o permiso; vuelve a ejecutar start-observer.sh --reset tras revisar observer.log' > "$SENTINEL_FILE"
+}
+
+stop_observer_if_running() {
+  if [ -f "$PID_FILE" ]; then
+    pid=$(cat "$PID_FILE")
+    if kill -0 "$pid" 2>/dev/null; then
+      echo "Deteniendo el observador de ${PROJECT_NAME} (PID: $pid)..."
+      kill "$pid"
+      rm -f "$PID_FILE"
+      echo "Observador detenido."
+      return 0
+    fi
+
+    echo "El observador no está corriendo (archivo de PID obsoleto)."
+    rm -f "$PID_FILE"
+    return 1
+  fi
+
+  echo "El observador no está corriendo."
+  return 1
+}
+
+# Leer los valores de configuración desde config.json
+OBSERVER_INTERVAL_MINUTES=5
+MIN_OBSERVATIONS=20
+OBSERVER_ENABLED=false
+if [ -f "$CONFIG_FILE" ]; then
+  if [ -z "$PYTHON_CMD" ]; then
+    echo "No se encontró un intérprete de python; se usan los valores por defecto del observador." >&2
+  else
+    _config=$(ACV2_CONFIG="$CONFIG_FILE" "$PYTHON_CMD" -c "
+import json, os
+with open(os.environ['ACV2_CONFIG']) as f:
+    cfg = json.load(f)
+obs = cfg.get('observer', {})
+print(obs.get('run_interval_minutes', 5))
+print(obs.get('min_observations_to_analyze', 20))
+print(str(obs.get('enabled', False)).lower())
+" 2>/dev/null || echo "5
+20
+false")
+    _interval=$(echo "$_config" | sed -n '1p')
+    _min_obs=$(echo "$_config" | sed -n '2p')
+    _enabled=$(echo "$_config" | sed -n '3p')
+    if [ "$_interval" -gt 0 ] 2>/dev/null; then
+      OBSERVER_INTERVAL_MINUTES="$_interval"
+    fi
+    if [ "$_min_obs" -gt 0 ] 2>/dev/null; then
+      MIN_OBSERVATIONS="$_min_obs"
+    fi
+    if [ "$_enabled" = "true" ]; then
+      OBSERVER_ENABLED=true
+    fi
+  fi
+fi
+OBSERVER_INTERVAL_SECONDS=$((OBSERVER_INTERVAL_MINUTES * 60))
+
+echo "Proyecto: ${PROJECT_NAME} (${PROJECT_ID})"
+echo "Almacenamiento: ${PROJECT_DIR}"
+
+# Detección de Windows/Git-Bash
+UNAME_LOWER="$(uname -s 2>/dev/null | tr '[:upper:]' '[:lower:]')"
+IS_WINDOWS=false
+case "$UNAME_LOWER" in
+  *mingw*|*msys*|*cygwin*) IS_WINDOWS=true ;;
+esac
+
+ACTION="start"
+RESET_OBSERVER=false
+
+for arg in "$@"; do
+  case "$arg" in
+    start|stop|status)
+      ACTION="$arg"
+      ;;
+    --reset)
+      RESET_OBSERVER=true
+      ;;
+    *)
+      echo "Uso: $0 [start|stop|status] [--reset]"
+      exit 1
+      ;;
+  esac
+done
+
+if [ "$RESET_OBSERVER" = "true" ]; then
+  rm -f "$SENTINEL_FILE"
+fi
+
+case "$ACTION" in
+  stop)
+    stop_observer_if_running || true
+    exit 0
+    ;;
+
+  status)
+    if [ -f "$PID_FILE" ]; then
+      pid=$(cat "$PID_FILE")
+      if kill -0 "$pid" 2>/dev/null; then
+        echo "El observador está corriendo (PID: $pid)"
+        echo "Log: $LOG_FILE"
+        echo "Observaciones: $(wc -l < "$OBSERVATIONS_FILE" 2>/dev/null || echo 0) líneas"
+        # Mostrar también el recuento de instintos
+        instinct_count=$(find "$INSTINCTS_DIR" -name "*.yaml" 2>/dev/null | wc -l)
+        echo "Instintos: $instinct_count"
+        exit 0
+      else
+        echo "El observador no está corriendo (archivo de PID obsoleto)"
+        rm -f "$PID_FILE"
+        exit 1
+      fi
+    else
+      echo "El observador no está corriendo"
+      exit 1
+    fi
+    ;;
+
+  start)
+    # Comprobar si el observador está deshabilitado en la configuración
+    if [ "$OBSERVER_ENABLED" != "true" ]; then
+      echo "El observador está deshabilitado en config.json (observer.enabled: false)."
+      echo "Pon observer.enabled en true en config.json para habilitarlo."
+      exit 1
+    fi
+
+    # Comprobar si ya está corriendo
+    if [ -f "$PID_FILE" ]; then
+      pid=$(cat "$PID_FILE")
+      if kill -0 "$pid" 2>/dev/null; then
+        echo "El observador ya está corriendo para ${PROJECT_NAME} (PID: $pid)"
+        exit 0
+      fi
+      rm -f "$PID_FILE"
+    fi
+
+    echo "Iniciando el agente observador para ${PROJECT_NAME}..."
+
+    if [ ! -x "$OBSERVER_LOOP_SCRIPT" ]; then
+      echo "El script del bucle del observador no existe o no es ejecutable: $OBSERVER_LOOP_SCRIPT"
+      exit 1
+    fi
+
+    mkdir -p "$PROJECT_DIR"
+    touch "$LOG_FILE"
+    start_line=$(wc -l < "$LOG_FILE" 2>/dev/null || echo 0)
+
+    nohup env \
+      CONFIG_DIR="$CONFIG_DIR" \
+      PID_FILE="$PID_FILE" \
+      LOG_FILE="$LOG_FILE" \
+      OBSERVATIONS_FILE="$OBSERVATIONS_FILE" \
+      INSTINCTS_DIR="$INSTINCTS_DIR" \
+      PROJECT_DIR="$PROJECT_DIR" \
+      PROJECT_NAME="$PROJECT_NAME" \
+      PROJECT_ID="$PROJECT_ID" \
+      MIN_OBSERVATIONS="$MIN_OBSERVATIONS" \
+      OBSERVER_INTERVAL_SECONDS="$OBSERVER_INTERVAL_SECONDS" \
+      ACV2_IS_WINDOWS="$IS_WINDOWS" \
+      ACV2_OBSERVER_PROMPT_PATTERN="$ACV2_OBSERVER_PROMPT_PATTERN" \
+      "$OBSERVER_LOOP_SCRIPT" >> "$LOG_FILE" 2>&1 &
+
+    # Esperar el archivo de PID (sondeo de hasta 10 s, sale antes cuando aparece).
+    # Compromiso frente al antiguo `sleep 2`: los arranques sanos regresan en la
+    # iteración 1 (sin latencia fija), pero un bucle que muere antes de escribir
+    # el archivo de PID ahora se detecta en ~10 s en vez de ~2 s. El techo más
+    # largo hace falta para tolerar sistemas de archivos lentos donde 2 s se
+    # quedaban cortos y daban falsos negativos.
+    for _i in $(seq 1 50); do [ -f "$PID_FILE" ] && break; sleep 0.2; done
+
+    # Buscar salida que pida confirmación en el log del observador
+    if tail -n +"$((start_line + 1))" "$LOG_FILE" 2>/dev/null | grep -E -i -q "$ACV2_OBSERVER_PROMPT_PATTERN"; then
+      echo "OBSERVER_ABORT: Se detectó un prompt de confirmación o permiso en la salida del observador. Se falla en cerrado."
+      stop_observer_if_running >/dev/null 2>&1 || true
+      write_guard_sentinel
+      exit 2
+    fi
+
+    if [ -f "$PID_FILE" ]; then
+      pid=$(cat "$PID_FILE")
+      if kill -0 "$pid" 2>/dev/null; then
+        echo "Observador iniciado (PID: $pid)"
+        echo "Log: $LOG_FILE"
+      else
+        echo "No se pudo iniciar el observador (el proceso murió de inmediato; revisa $LOG_FILE)"
+        exit 1
+      fi
+    else
+      echo "No se pudo iniciar el observador"
+      exit 1
+    fi
+    ;;
+
+  *)
+    echo "Uso: $0 [start|stop|status] [--reset]"
+    exit 1
+    ;;
+esac

package/vendor/theus-arsenal/skills/aprendizaje-continuo-v2/config.json

@@ -0,0 +1,8 @@
+{
+  "version": "2.1",
+  "observer": {
+    "enabled": false,
+    "run_interval_minutes": 5,
+    "min_observations_to_analyze": 20
+  }
+}