SLOs de contexto

Define objetivos de nivel de servicio para tus métricas de contexto.

Configuración

Crea un archivo slos.toml en tu directorio .lean-ctx.

# .lean-ctx/slos.toml
[[slo]]
name = "context_budget"
metric = "session_context_tokens"
threshold = 50000
action = "warn"  # warn | throttle | block

[[slo]]
name = "cost_per_session"
metric = "session_cost_usd"
threshold = 1.00
action = "throttle"

[[slo]]
name = "compression_efficiency"
metric = "compression_ratio"
threshold = 0.3
direction = "min"
action = "warn"

Métricas disponibles

Acciones SLO

Comandos MCP

ctx_session slo              # Show current SLO status
ctx_session slo reload       # Reload SLOs from disk
ctx_session slo history      # Show violation history
ctx_session slo clear        # Clear violation log

Detección de anomalías

Detecta patrones de consumo inusuales automáticamente.

Cómo funciona

lean-ctx utiliza el algoritmo de Welford:

• EMA sobre ventana de 50 llamadas
• Alerta en >3x desviación estándar
• Eventos visibles en TUI y panel

Métricas rastreadas

Rastrea tokens_per_call actualmente.

Métricas Prometheus

Exporta datos en formato Prometheus.

Endpoint

# Start dashboard with metrics endpoint
lean-ctx dashboard

# Scrape metrics
curl http://localhost:3000/metrics

Métricas disponibles

lean_ctx_tokens_saved_total
lean_ctx_compression_ratio
lean_ctx_session_cost_usd
lean_ctx_tool_calls_total
lean_ctx_slo_violations_total
lean_ctx_cache_hit_rate
lean_ctx_anomalies_total
lean_ctx_session_uptime_seconds

Integración Grafana

Apunta tu scraper a /metrics.

Garantía cero PII

Solo contadores, gauges y ratios.

Comparación de sesiones

Compara dos sesiones lado a lado.

Uso

# Compare two sessions (MCP)
ctx_session diff <session_a> <session_b>
ctx_session diff <session_a> <session_b> json

# List available sessions
ctx_session list

Qué se compara

El motor compara la estructura completa:

• Archivos: añadidos, eliminados, cambios de modo
• Hallazgos vs sesión anterior
• Decisiones arquitectónicas
• Estadísticas: llamadas, tokens, comandos

Endpoints API del panel