bug_bunny 4.8.0 → 4.9.0

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

@@ -0,0 +1,194 @@
+#!/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

data/.agents/skills/skill-builder/SKILL.md

@@ -0,0 +1,293 @@
+---
+name: skill-builder
+description: Genera o actualiza la skill empaquetada (`skill/`) para cualquier proyecto Ruby (gema o servicio). Detecta automáticamente el tipo de proyecto y analiza el código correspondiente. Soporta desde un SKILL.md simple hasta skills con references y scripts. Es invocada por `skill-manager`, `gem-release` (regeneración completa) y `quality-code` (actualización incremental).
+---
+
+# Skill Builder
+
+Sos un experto en crear skills de conocimiento para proyectos Ruby. Tu objetivo es generar o actualizar `skill/SKILL.md` — un artefacto autocontenido que permite a cualquier agente de IA responder preguntas sobre integración, arquitectura, API, errores y antipatrones del proyecto.
+
+## Detección de tipo de proyecto
+
+- **Gema**: existe `.gemspec` en la raíz.
+- **Servicio**: existe `config/application.rb`.
+- Si ambos existen, priorizar gema.
+
+**Distribución en gemas:** La skill queda en `skill/` en la raíz del repositorio. Al publicar con `gem-release`, `skill/` se empaqueta en el `.gem`, de modo que los consumidores acceden a la skill directamente desde la gema instalada (`Gem.loaded_specs["[name]"].gem_dir + "/skill/"`) sin descargas adicionales.
+
+**Distribución en servicios:** La skill queda en `skill/` en la raíz del repositorio. Los consumidores la descargan vía `skill-manager sync` desde GitHub.
+
+## Escenarios de Complejidad
+
+La estructura de `skill/` depende de la complejidad del proyecto. `skill-manager` determina el escenario inicial, pero puede evolucionar con el tiempo:
+
+### Escenario 1 — Proyecto simple
+```
+skill/
+  SKILL.md
+```
+La skill entera cabe en un solo archivo. Secciones autocontenidas de ≤400 tokens.
+
+### Escenario 2 — Con referencias
+```
+skill/
+  SKILL.md
+  references/
+    api-detallada.md
+    errores.md
+```
+Cuando la API o contratos son extensos, o el catálogo de errores es grande.
+
+### Escenario 3 — Con scripts
+```
+skill/
+  SKILL.md
+  scripts/
+    diagnostico.rb
+```
+Cuando el proyecto necesita herramientas ejecutables (diagnóstico, migración, validación).
+
+### Escenario 4 — Completa
+```
+skill/
+  SKILL.md
+  references/
+    api-detallada.md
+    errores.md
+  scripts/
+    diagnostico.rb
+    migration_helper.rb
+```
+
+### Criterios para escalar
+
+- **→ references/** cuando una sección de `SKILL.md` supera los 400 tokens y es conocimiento de referencia (API, contratos, errores, catálogos).
+- **→ scripts/** cuando el proyecto necesita herramientas ejecutables para diagnóstico, migración o validación que complementen el conocimiento.
+
+## Modos de Ejecución
+
+- **Completo** (invocado por `gem-release` o manualmente): Regenera la skill desde cero analizando todo el código.
+- **Incremental** (invocado por `quality-code`): Actualiza solo las secciones afectadas por el diff del PR.
+
+---
+
+## Paso 1 — Descubrir el estado actual
+
+Leer en orden:
+1. `skill/SKILL.md` — si existe, es la skill actual.
+2. `skill/references/` — referencias existentes.
+3. `skill/scripts/` — scripts existentes.
+4. `CLAUDE.md` — propósito del artefacto, arquitectura, decisiones clave.
+
+Según el tipo de proyecto:
+
+**Si es gema:**
+5. `.gemspec` — nombre, descripción, dependencias.
+6. `lib/` — API pública, responsabilidades de clases, firmas de métodos.
+7. `spec/` o `test/` — patrones de uso, casos borde, errores esperados.
+
+**Si es servicio:**
+5. `config/application.rb` — nombre, configuración.
+6. `config/routes.rb` — endpoints HTTP expuestos.
+7. `app/` — controllers, models, services, jobs.
+8. Queues/mensajería — contratos de eventos (Sidekiq, ActiveJob, etc.).
+9. `db/migrate/` — esquema y evolución del modelo de datos.
+10. `spec/` o `test/` — patrones de uso, casos borde, errores esperados.
+
+En modo **incremental**, analizar también `git diff [PRIMARY_BRANCH]...HEAD` para identificar qué cambió.
+
+---
+
+## Paso 2 — Analizar el código y determinar escenario
+
+**Común a ambos tipos:**
+- **Arquitectura**: Flujo de datos, componentes core, thread safety, dependencias.
+- **Uso**: Ejemplos de integración, patrones comunes.
+- **Errores**: Excepciones personalizadas, causas, resoluciones.
+- **Antipatrones**: Usos incorrectos identificados en tests o código.
+- **Scripts necesarios**: ¿Hay flujos de diagnóstico, migración o validación que justifiquen un script?
+
+**Específico de gemas:**
+- **API Pública**: Bloque de configuración, clases principales, métodos públicos, parámetros.
+
+**Específico de servicios:**
+- **Contratos**: Endpoints HTTP, queues, eventos publicados/consumidos, webhooks.
+- **Infraestructura**: Variables de entorno, servicios externos, bases de datos.
+
+Con base en el análisis, determiná qué escenario de complejidad corresponde (1-4). Si la skill ya existe, evaluá si el escenario debe escalar.
+
+---
+
+## Paso 3 — Generar la Skill
+
+Generar `skill/SKILL.md` (y `references/` o `scripts/` si el escenario lo requiere).
+
+### Reglas de escritura (RAG-optimized)
+
+1. **Idioma: español** — Todo el contenido en español. Mantener términos técnicos estándar (ej: "middleware", "routing").
+2. **Cada sección <= 400 tokens** — Autocontenida, sin asumir contexto de otras secciones. Si una sección supera este límite, extraerla a `references/`.
+3. **Sin prosa introductoria** — Ir directo al contenido técnico.
+4. **Sin frontmatter complejo** — No incluir version, profile o audiences.
+5. **Sin duplicación** — Si un tema está en `references/`, la skill solo lo referencia.
+
+### Estructura de SKILL.md
+
+#### Titulo y Descripcion
+
+```markdown
+# [Nombre] Expert
+
+Skill de conocimiento completo sobre [Nombre]. Consultame para cualquier pregunta sobre integración, arquitectura, API, errores y antipatrones.
+```
+
+#### Glosario
+
+Términos del dominio. Formato: `**Término** — Definición concisa (1-3 líneas).`
+
+#### Arquitectura
+
+- Responsabilidad core.
+- Mapa de componentes (diagrama ASCII).
+- Flujo en runtime y decisiones de diseño.
+
+**Formato de diagramas ASCII:**
+- Cajas con `┌─┐└─┘`, flechas con `────>` (horizontal) y `│▼` (vertical).
+- Máximo 4-5 componentes por diagrama. Si hay más, dividir en sub-diagramas por capa.
+- Sin texto decorativo fuera de las cajas.
+
+Ejemplo:
+```
+┌──────────┐     ┌──────────┐     ┌──────────┐
+│ Request  │────>│ Middleware│────>│ Handler  │
+└──────────┘     └──────────┘     └──────────┘
+                       │
+                       ▼
+                 ┌──────────┐
+                 │  Cache   │
+                 └──────────┘
+```
+
+#### API Publica (gemas)
+
+- Bloque de configuración (tipos, defaults, restricciones).
+- Clases y métodos (firma, parámetros, retorno).
+- Ejemplos de código para operaciones principales.
+- Si la API es extensa, mantener un resumen acá y extraer el detalle a `references/api-detallada.md`.
+
+#### Contratos (servicios)
+
+- Endpoints HTTP (método, path, parámetros, respuesta).
+- Queues y eventos (nombre, payload, productor/consumidor).
+- Webhooks (si aplica).
+- Si los contratos son extensos, extraer a `references/contratos.md`.
+
+#### FAQ
+
+Formato Q&A estricto. H3 para la pregunta, respuesta <= 150 palabras. Sin preámbulo.
+
+#### Antipatrones
+
+Qué NO hacer. Por cada uno: nombre, código incorrecto, razón y alternativa.
+
+#### Errores
+
+Catálogo de excepciones. Por cada una: nombre, causa, reproducción y resolución.
+Si el catálogo es extenso, mantener los errores más comunes acá y extraer el catálogo completo a `references/errores.md`.
+
+#### Referencias (si existen)
+
+Índice de archivos en `references/` y `scripts/` con descripción de una línea.
+
+```markdown
+## Referencias
+
+- [API Detallada](references/api-detallada.md) — Documentación completa de clases y métodos
+- [Catálogo de Errores](references/errores.md) — Todas las excepciones con resolución
+- [Diagnóstico](scripts/diagnostico.rb) — Script para verificar configuración en runtime
+```
+
+---
+
+## Paso 4 — Actualizar README.md
+
+Invocá la skill `documentation-writer` para auditar y actualizar el README.
+
+**Regla fundamental:** El README es para **humanos** (devs que usan la gema/servicio). La skill (`skill/`) es para **agentes**. Son audiencias distintas. **Nunca referenciar `skill/` desde el README.**
+
+### README de una gema (máx 150 líneas)
+
+```markdown
+# [Nombre de la gema]
+
+Descripción en una línea.
+
+## Instalación
+
+gem 'nombre', '~> X.X'
+
+## Quick Start
+
+[Ejemplo mínimo funcional — copiar, pegar, funciona]
+
+## Uso
+
+[Ejemplos de las operaciones principales]
+
+## Configuración
+
+[Bloque de configuración con opciones, defaults y descripción]
+
+## Contribuir
+
+[Cómo correr tests, linting, etc.]
+```
+
+### README de un servicio (máx 150 líneas)
+
+```markdown
+# [Nombre del servicio]
+
+Descripción en una línea.
+
+## Setup
+
+[Pasos para levantar el servicio localmente: bin/setup, docker, etc.]
+
+## Endpoints / Contratos
+
+[Resumen de los endpoints o queues principales]
+
+## Variables de entorno
+
+[Lista de env vars necesarias]
+
+## Testing
+
+[Cómo correr tests]
+
+## Deploy
+
+[Cómo se despliega: branch, tag, Codefresh]
+```
+
+### Qué NO poner en el README
+- Links a `skill/` ni a `skill/SKILL.md`
+- Documentación interna para agentes
+- Diagramas ASCII extensos (esos van en la skill)
+- Catálogo completo de errores (eso va en la skill)
+- FAQ técnico detallado (eso va en la skill)
+
+---
+
+## Paso 5 — Mostrar resumen y esperar aprobación
+
+Mostrá un resumen de los cambios realizados:
+- Tipo de proyecto detectado (gema o servicio).
+- Escenario de complejidad determinado (y si escaló respecto al anterior).
+- Secciones nuevas, modificadas o eliminadas en `SKILL.md`.
+- Archivos nuevos o actualizados en `references/` o `scripts/`.
+- Cambios en README.md.
+
+Preguntá: "¿Querés ver el diff completo antes de escribir los archivos?"
+
+**Esperá la aprobación explícita del desarrollador** antes de persistir los cambios.