bug_bunny 4.9.0 → 4.10.0

data/.agents/skills/sentry/SKILL.md

@@ -1,135 +0,0 @@
----
-name: sentry
-description: Experto en la instancia self-hosted de Sentry de Wispro. Úsala SIEMPRE que necesites buscar errores, listar issues, ver stacktraces, resolver o asignar issues en Sentry. Funciona con cualquier proyecto del ecosistema.
----
-
-# Sentry Expert
-
-Skill de conocimiento completo sobre la instancia de Sentry self-hosted de Wispro. Consultame para buscar errores, analizar stacktraces, gestionar issues o diagnosticar problemas en producción.
-
-## Configuración
-
-```bash
-SENTRY_TOKEN=$SENTRY_TOKEN
-SENTRY_URL="https://sentry.cloud.wispro.co"
-SENTRY_ORG="wispro"
-```
-
-**Importante:** Siempre usar `-k` en curl (certificado self-hosted). Nunca exponer el token en las respuestas.
-
-## Glosario
-
-**Issue** — Agrupación de eventos similares. Tiene un ID numérico y un shortId legible (ej: `PROJECT-123`).
-
-**Event** — Ocurrencia individual de un error. Contiene stacktrace, contexto, usuario, breadcrumbs.
-
-**Project slug** — Identificador del proyecto en Sentry. Cada microservicio tiene uno. Si no lo sabés, listá los proyectos primero.
-
-**statsPeriod** — Período de estadísticas: `24h`, `14d` o vacío para todo el historial.
-
-## Flujos de Trabajo
-
-### Buscar errores en un proyecto
-
-1. Si no tenés el project slug, listá los proyectos primero (ver API).
-2. Consultá issues del proyecto filtrando por período y query.
-3. Para cada issue relevante, consultá los eventos para ver el stacktrace.
-
-### Diagnosticar un error desde el código
-
-1. Tomá el mensaje de error o excepción del código/logs.
-2. Buscá en Sentry con `query=<mensaje>` en el proyecto correspondiente.
-3. Si hay match, mostrá el stacktrace y la frecuencia.
-4. Si no hay match, indicá que el error no está reportado en Sentry.
-
-### Gestionar issues
-
-- **Resolver**: `status=resolved`
-- **Ignorar**: `status=ignored`
-- **Asignar**: `assignedTo=<username>`
-- **Marcar como visto**: `hasSeen=true`
-
-### Análisis de tendencias
-
-1. Consultá issues con `statsPeriod=14d` para ver tendencias.
-2. Ordená por `count` o `userCount` para priorizar.
-3. Revisá `firstSeen` y `lastSeen` para detectar regresiones.
-
-## API — Endpoints principales
-
-Todos los endpoints usan base URL `$SENTRY_URL/api/0/` y header `Authorization: Bearer $SENTRY_TOKEN`.
-
-Ver catálogo completo en [references/api-endpoints.md](references/api-endpoints.md).
-
-### Listar proyectos
-```bash
-curl -sk -H "Authorization: Bearer $SENTRY_TOKEN" \
-  "$SENTRY_URL/api/0/organizations/$SENTRY_ORG/projects/" | jq '.[] | {slug, name}'
-```
-
-### Listar issues de un proyecto
-```bash
-curl -sk -H "Authorization: Bearer $SENTRY_TOKEN" \
-  "$SENTRY_URL/api/0/projects/$SENTRY_ORG/{PROJECT_SLUG}/issues/?statsPeriod=24h&query=is:unresolved"
-```
-
-### Ver detalle de un issue
-```bash
-curl -sk -H "Authorization: Bearer $SENTRY_TOKEN" \
-  "$SENTRY_URL/api/0/organizations/$SENTRY_ORG/issues/{ISSUE_ID}/"
-```
-
-### Ver eventos de un issue (con stacktrace)
-```bash
-curl -sk -H "Authorization: Bearer $SENTRY_TOKEN" \
-  "$SENTRY_URL/api/0/organizations/$SENTRY_ORG/issues/{ISSUE_ID}/events/?full=true&limit=1"
-```
-
-### Buscar por mensaje de error
-```bash
-curl -sk -H "Authorization: Bearer $SENTRY_TOKEN" \
-  "$SENTRY_URL/api/0/projects/$SENTRY_ORG/{PROJECT_SLUG}/issues/?query={MENSAJE}&statsPeriod=24h"
-```
-
-### Resolver un issue
-```bash
-curl -sk -X PUT -H "Authorization: Bearer $SENTRY_TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{"status":"resolved"}' \
-  "$SENTRY_URL/api/0/organizations/$SENTRY_ORG/issues/{ISSUE_ID}/"
-```
-
-## FAQ
-
-### ¿Cómo encuentro el project slug de mi servicio?
-Ejecutá el endpoint de listar proyectos. El campo `slug` es lo que necesitás. Generalmente coincide con el nombre del repo en minúsculas.
-
-### ¿Cómo veo el stacktrace completo?
-Usá el endpoint de eventos con `full=true`. El stacktrace está en `entries[].data.values[].stacktrace.frames[]`. Cada frame tiene `filename`, `lineNo`, `function` y `context`.
-
-### ¿Cómo filtro por nivel de error?
-Agregá `query=level:error` o `query=level:warning` al endpoint de issues.
-
-### ¿Cómo pagino resultados?
-La API devuelve un header `Link` con cursores. Usá el parámetro `cursor` del link `next` para la siguiente página.
-
-## Antipatrones
-
-**Buscar sin project slug** — No consultes issues a nivel organización si sabés el proyecto. Es más lento y devuelve ruido de otros servicios.
-
-**Ignorar la paginación** — Por defecto la API devuelve pocos resultados. Si necesitás más, paginá con el cursor.
-
-**Hardcodear issue IDs** — Los IDs cambian. Siempre buscá por query o filtrá por período.
-
-## Errores comunes
-
-**401 Unauthorized** — Token inválido o expirado. Verificá que `$SENTRY_TOKEN` esté en el entorno.
-
-**404 Not Found** — Project slug incorrecto. Listá los proyectos para verificar.
-
-**SSL Certificate Error** — Falta el flag `-k` en curl. Es necesario porque es self-hosted.
-
-## Referencias
-
-- [API Endpoints](references/api-endpoints.md) — Catálogo completo de endpoints con parámetros
-- [sentry.rb](scripts/sentry.rb) — Script helper para queries comunes

data/.agents/skills/sentry/references/api-endpoints.md

@@ -1,147 +0,0 @@
-# Sentry API — Catálogo de Endpoints
-
-Base URL: `$SENTRY_URL/api/0/`
-Auth: `Authorization: Bearer $SENTRY_TOKEN`
-Siempre usar `-k` en curl (certificado self-hosted).
-
-## Proyectos
-
-### Listar proyectos de la organización
-```
-GET /organizations/{org}/projects/
-```
-Respuesta: array de objetos con `slug`, `name`, `id`, `platform`, `dateCreated`.
-
-### Obtener detalle de un proyecto
-```
-GET /projects/{org}/{project_slug}/
-```
-
-## Issues
-
-### Listar issues de un proyecto
-```
-GET /projects/{org}/{project_slug}/issues/
-```
-Query params:
-- `statsPeriod` — `24h`, `14d` o vacío (default: `24h`)
-- `query` — Búsqueda estructurada (default: `is:unresolved`)
-- `shortIdLookup` — `true` para buscar por shortId
-- `cursor` — Paginación
-
-Respuesta: array de issues con `id`, `title`, `culprit`, `count`, `userCount`, `firstSeen`, `lastSeen`, `level`, `status`, `shortId`, `project`.
-
-### Listar issues de la organización
-```
-GET /organizations/{org}/issues/
-```
-Mismos query params. Devuelve issues de todos los proyectos.
-
-### Obtener detalle de un issue
-```
-GET /organizations/{org}/issues/{issue_id}/
-```
-Respuesta: issue completo con `activity`, `assignedTo`, `count`, `firstSeen`, `lastSeen`, `firstRelease`, `lastRelease`, `participants`, `userReportCount`, `stats`.
-
-### Actualizar un issue
-```
-PUT /organizations/{org}/issues/{issue_id}/
-```
-Body (JSON, todos opcionales):
-- `status` — `resolved`, `resolvedInNextRelease`, `unresolved`, `ignored`
-- `assignedTo` — username o team
-- `hasSeen` — boolean
-- `isBookmarked` — boolean
-- `isSubscribed` — boolean
-- `isPublic` — boolean
-
-### Eliminar un issue
-```
-DELETE /organizations/{org}/issues/{issue_id}/
-```
-
-### Bulk update issues de un proyecto
-```
-PUT /projects/{org}/{project_slug}/issues/
-```
-Query params:
-- `id` — lista de issue IDs a actualizar
-
-Body: mismos campos que update individual.
-
-## Eventos
-
-### Listar eventos de un issue
-```
-GET /organizations/{org}/issues/{issue_id}/events/
-```
-Query params:
-- `full` — `true` para incluir body completo con stacktrace
-- `statsPeriod` — período de filtro
-- `environment` — filtrar por entorno
-- `query` — búsqueda dentro de eventos
-- `cursor` — paginación
-
-Respuesta: array de eventos con `id`, `eventID`, `groupID`, `title`, `message`, `dateCreated`, `tags`, `user`, `location`, `culprit`.
-
-### Listar eventos de error de un proyecto
-```
-GET /projects/{org}/{project_slug}/events/
-```
-
-### Obtener evento específico de un proyecto
-```
-GET /projects/{org}/{project_slug}/events/{event_id}/
-```
-Respuesta completa con stacktrace en `entries[].data.values[].stacktrace.frames[]`.
-
-Cada frame contiene:
-- `filename` — archivo
-- `lineNo` — línea
-- `function` — método
-- `context` — líneas de código alrededor
-- `inApp` — boolean, si es código de la app o dependencia
-
-## Tags
-
-### Valores de un tag en un issue
-```
-GET /organizations/{org}/issues/{issue_id}/tags/{tag_key}/values/
-```
-Tags comunes: `environment`, `server_name`, `browser`, `os`, `release`.
-
-### Detalle de un tag en un issue
-```
-GET /organizations/{org}/issues/{issue_id}/tags/{tag_key}/
-```
-
-## Hashes
-
-### Listar hashes de un issue
-```
-GET /organizations/{org}/issues/{issue_id}/hashes/
-```
-Útil para entender qué variantes de stacktrace se agrupan en el mismo issue.
-
-## Paginación
-
-La API usa cursor-based pagination. El header `Link` de la respuesta contiene:
-
-```
-Link: <url>; rel="previous"; results="false"; cursor="...",
-      <url>; rel="next"; results="true"; cursor="..."
-```
-
-Usar el valor de `cursor` del link `next` como query param para la siguiente página. Cuando `results="false"` en `next`, no hay más páginas.
-
-## Queries estructuradas
-
-El parámetro `query` soporta:
-- `is:unresolved` / `is:resolved` / `is:ignored`
-- `level:error` / `level:warning` / `level:info`
-- `assigned:username` / `assigned:me`
-- `bookmarks:me`
-- `firstSeen:>2024-01-01`
-- `lastSeen:<24h`
-- `times_seen:>100`
-- Texto libre para buscar en título/mensaje

data/.agents/skills/sentry/scripts/sentry.rb

@@ -1,194 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Helper para interactuar con la API de Sentry self-hosted de Wispro.
-# Uso: ruby sentry.rb <comando> [opciones]
-#
-# Comandos:
-#   projects                          — Lista todos los proyectos
-#   issues <project_slug> [opciones]  — Lista issues de un proyecto
-#   issue <issue_id>                  — Detalle de un issue
-#   events <issue_id> [--full]        — Eventos de un issue
-#   search <project_slug> <query>     — Busca issues por texto
-#   resolve <issue_id>                — Resuelve un issue
-#   ignore <issue_id>                 — Ignora un issue
-#   assign <issue_id> <username>      — Asigna un issue
-
-require 'net/http'
-require 'uri'
-require 'json'
-require 'openssl'
-
-module Sentry
-  URL = ENV['SENTRY_URL'] || 'https://sentry.cloud.wispro.co'
-  TOKEN = ENV['SENTRY_TOKEN']
-  ORG = ENV['SENTRY_ORG'] || 'wispro'
-
-  class << self
-    def run(args)
-      unless TOKEN
-        puts "ERROR: SENTRY_TOKEN no configurado en el entorno."
-        exit 1
-      end
-
-      command = args.shift
-      case command
-      when 'projects'    then projects
-      when 'issues'      then issues(args)
-      when 'issue'       then issue(args.first)
-      when 'events'      then events(args)
-      when 'search'      then search(args)
-      when 'resolve'     then update_status(args.first, 'resolved')
-      when 'ignore'      then update_status(args.first, 'ignored')
-      when 'assign'      then assign(args[0], args[1])
-      else
-        puts USAGE
-      end
-    end
-
-    private
-
-    USAGE = <<~TEXT
-      Uso: ruby sentry.rb <comando> [opciones]
-
-      Comandos:
-        projects                              Lista todos los proyectos
-        issues <project_slug> [--period=24h]  Lista issues (default: 24h, unresolved)
-        issue <issue_id>                      Detalle de un issue
-        events <issue_id> [--full]            Eventos de un issue
-        search <project_slug> <query>         Busca issues por texto
-        resolve <issue_id>                    Resuelve un issue
-        ignore <issue_id>                     Ignora un issue
-        assign <issue_id> <username>          Asigna un issue
-    TEXT
-
-    def projects
-      data = get("/organizations/#{ORG}/projects/")
-      data.each do |p|
-        puts "  #{p['slug'].ljust(30)} #{p['name']}"
-      end
-    end
-
-    def issues(args)
-      slug = args.shift
-      period = extract_flag(args, '--period') || '24h'
-
-      data = get("/projects/#{ORG}/#{slug}/issues/?statsPeriod=#{period}&query=is:unresolved")
-      print_issues(data)
-    end
-
-    def issue(issue_id)
-      data = get("/organizations/#{ORG}/issues/#{issue_id}/")
-      puts "  ##{data['shortId']} — #{data['title']}"
-      puts "  Level: #{data['level']} | Count: #{data['count']} | Users: #{data['userCount']}"
-      puts "  First: #{data['firstSeen']} | Last: #{data['lastSeen']}"
-      puts "  Status: #{data['status']}"
-      puts "  Assigned: #{data.dig('assignedTo', 'name') || 'nadie'}"
-      puts "  Link: #{data['permalink']}"
-    end
-
-    def events(args)
-      issue_id = args.shift
-      full = args.include?('--full')
-      params = full ? '?full=true&limit=3' : '?limit=5'
-
-      data = get("/organizations/#{ORG}/issues/#{issue_id}/events/#{params}")
-      data.each do |event|
-        puts "\n  Event #{event['eventID'][0..7]} — #{event['dateCreated']}"
-        puts "  #{event['title']}"
-
-        next unless full && event['entries']
-
-        event['entries'].each do |entry|
-          next unless entry['type'] == 'exception'
-
-          entry.dig('data', 'values')&.each do |exc|
-            puts "  Exception: #{exc['type']}: #{exc['value']}"
-            frames = exc.dig('stacktrace', 'frames') || []
-            frames.select { |f| f['inApp'] }.last(5).each do |frame|
-              puts "    #{frame['filename']}:#{frame['lineNo']} in #{frame['function']}"
-            end
-          end
-        end
-      end
-    end
-
-    def search(args)
-      slug = args.shift
-      query = args.join(' ')
-      data = get("/projects/#{ORG}/#{slug}/issues/?query=#{URI.encode_www_form_component(query)}&statsPeriod=24h")
-      print_issues(data)
-    end
-
-    def update_status(issue_id, status)
-      data = put("/organizations/#{ORG}/issues/#{issue_id}/", { status: status })
-      puts "  Issue ##{issue_id} → #{data['status']}"
-    end
-
-    def assign(issue_id, username)
-      data = put("/organizations/#{ORG}/issues/#{issue_id}/", { assignedTo: username })
-      puts "  Issue ##{issue_id} → asignado a #{data.dig('assignedTo', 'name') || username}"
-    end
-
-    def print_issues(data)
-      if data.empty?
-        puts "  Sin issues encontrados."
-        return
-      end
-
-      data.each do |i|
-        level = i['level'].upcase.ljust(7)
-        count = "x#{i['count']}".ljust(6)
-        puts "  #{level} #{count} ##{i['shortId'].ljust(15)} #{i['title'][0..80]}"
-      end
-    end
-
-    # --- HTTP ---
-
-    def get(path)
-      request(:get, path)
-    end
-
-    def put(path, body)
-      request(:put, path, body)
-    end
-
-    def request(method, path, body = nil)
-      uri = URI.parse("#{URL}/api/0#{path}")
-      http = Net::HTTP.new(uri.host, uri.port)
-      http.use_ssl = uri.scheme == 'https'
-      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
-
-      req = case method
-            when :get then Net::HTTP::Get.new(uri)
-            when :put then Net::HTTP::Put.new(uri)
-            end
-
-      req['Authorization'] = "Bearer #{TOKEN}"
-      req['Content-Type'] = 'application/json'
-      req.body = JSON.generate(body) if body
-
-      response = http.request(req)
-
-      unless response.code.start_with?('2')
-        puts "  ERROR: HTTP #{response.code} — #{response.body[0..200]}"
-        exit 1
-      end
-
-      JSON.parse(response.body)
-    rescue StandardError => e
-      puts "  ERROR: #{e.message}"
-      exit 1
-    end
-
-    def extract_flag(args, flag)
-      idx = args.index { |a| a.start_with?(flag) }
-      return nil unless idx
-
-      value = args.delete_at(idx)
-      value.include?('=') ? value.split('=', 2).last : args.delete_at(idx)
-    end
-  end
-end
-
-Sentry.run(ARGV.dup) if __FILE__ == $PROGRAM_NAME