SLOs de Contexto

Defina objetivos de nível de serviço para suas métricas de contexto.

Configuração

Crie um arquivo slos.toml no diretório .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 disponíveis

Ações 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

Detecção de Anomalias

Detecta padrões incomuns automaticamente.

Como funciona

lean-ctx usa o algoritmo de Welford:

• EMA sobre janela de 50 chamadas
• Alerta em >3x desvio padrão
• Eventos visíveis no TUI e painel

Métricas rastreadas

Rastreia tokens_per_call atualmente.

Métricas Prometheus

Exporte dados no formato Prometheus.

Endpoint

# Start dashboard with metrics endpoint
lean-ctx dashboard

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

Métricas disponíveis

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

Integração Grafana

Aponte seu scraper para /metrics.

Garantia zero PII

Apenas contadores, gauges e proporções.

Comparação de Sessões

Compare duas sessões 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

O que é comparado

O motor compara a estrutura completa:

• Arquivos: adicionados, removidos, mudanças de modo
• Descobertas vs sessão anterior
• Decisões arquiteturais
• Estatísticas: chamadas, tokens, comandos

Endpoints API do Painel