bug_bunny 4.6.1 → 4.8.0

data/.claude/commands/gem-ai-setup.md

@@ -0,0 +1,174 @@
+Generate or update the complete AI documentation suite for this gem.
+
+This skill is invoked automatically by `/release`. It can also be run standalone to update docs without a full release.
+
+BugBunny's `docs/ai/` is the **golden example** of the expected output quality. When in doubt, read it.
+
+---
+
+## Step 1 — Discover the current state
+
+Read in order:
+1. `lib/bug_bunny/version.rb` (or equivalent) — current version
+2. `docs/_index.md` — if it exists, it lists all files to update and their purpose
+3. `docs/ai/_index.md` — if it exists, it has the current profile (minimal/full) and file list
+4. `gemspec` — gem name, summary, description, dependencies
+5. `CLAUDE.md` — architecture, components, patterns, extension hooks
+
+If `docs/ai/` does not exist yet, this is a **first-time generation**. Create from scratch.
+If it exists, **update only the sections affected by the changes in this release**.
+
+---
+
+## Step 2 — Determine the profile
+
+**Full profile** when any of these apply:
+- Gem is public (has a homepage or published to RubyGems)
+- Gem has multiple audiences (internal maintainers + external integrators)
+- Gem has a non-trivial public API (multiple classes, errors, configuration)
+
+**Minimal profile** when all of these apply:
+- Gem is internal-only
+- Single audience
+- Simple API (one entry point, few methods)
+
+Full profile files: `_index.md`, `glossary.md`, `architecture.md`, `api.md`, `faq_internal.md`, `faq_external.md`, `antipatterns.md`, `errors.md`
+Minimal profile files: `_index.md`, `api.md`, `errors.md`
+
+---
+
+## Step 3 — Analyze the codebase
+
+Read the following to generate accurate content:
+- All files under `lib/` — public API, class responsibilities, method signatures
+- `spec/` or `test/` — usage patterns, edge cases, what errors are expected
+- `CHANGELOG.md` — what changed in this version (for updating existing docs)
+- `docs/howto/` — existing human docs to stay consistent with
+
+---
+
+## Step 4 — Generate or update each file
+
+Apply these rules to every file:
+
+**RAG optimization rules (mandatory):**
+1. Each section ≤ 400 tokens — chunks must be self-contained
+2. Each section self-contained — do not assume context from previous sections
+3. `faq_*.md` always in strict Q&A format — H3 with the question, answer ≤ 150 words
+4. `glossary.md` one entry per term — term in bold, definition in 1-3 lines
+5. `errors.md` one entry per error — name, cause, how to reproduce, how to resolve
+6. No introductory prose — go straight to content
+
+### `_index.md`
+
+Frontmatter manifest. Update `version:` to the new version. Keep `profile:`, `kind:`, `audiences:` stable unless the gem changed fundamentally. List every file under `files:` with its audience.
+
+Reference: `docs/ai/_index.md` in BugBunny.
+
+### `glossary.md`
+
+Domain terms specific to this gem. Include:
+- Core abstractions introduced by the gem
+- Terms a developer needs to understand to use the gem correctly
+- Terms that have a non-obvious meaning in this context
+
+Do NOT include generic Ruby or framework terms unless the gem redefines them.
+
+Reference: `docs/ai/glossary.md` in BugBunny.
+
+### `architecture.md`
+
+Internal-facing. Include:
+- Component map (ASCII diagram if useful)
+- How the components interact at runtime
+- Key design decisions and why (not just what)
+- Thread safety considerations if relevant
+- Caching or lifecycle patterns
+
+Reference: `docs/ai/architecture.md` in BugBunny.
+
+### `api.md`
+
+External-facing. Include:
+- Configuration block with all options, types, defaults, and constraints
+- Every public class with its public methods: signature, parameters, return type, description
+- Code examples for each major operation
+- Class-level configuration options (`.with`, class attributes, etc.)
+
+Reference: `docs/ai/api.md` in BugBunny.
+
+### `faq_internal.md`
+
+Q&A for the gem maintainer. Cover:
+- Non-obvious implementation decisions ("why X instead of Y?")
+- Thread safety and concurrency considerations
+- How to extend or hook into the gem
+- Common mistakes when modifying the gem internals
+
+Each Q&A: H3 for the question, answer ≤ 150 words, no preamble.
+
+Reference: `docs/ai/faq_internal.md` in BugBunny.
+
+### `faq_external.md`
+
+Q&A for the developer integrating the gem. Cover:
+- Setup and configuration questions
+- How to perform the most common operations
+- Error handling patterns
+- Testing patterns
+- Performance and tuning questions
+
+Each Q&A: H3 for the question, answer ≤ 150 words, no preamble.
+
+Reference: `docs/ai/faq_external.md` in BugBunny.
+
+### `antipatterns.md`
+
+What NOT to do. For each antipattern:
+1. Name it clearly
+2. Show the wrong code
+3. Explain why it's wrong (not just "it's bad")
+4. Show the correct alternative
+
+Reference: `docs/ai/antipatterns.md` in BugBunny.
+
+### `errors.md`
+
+All exceptions the gem raises. For each:
+- Class name and inheritance
+- Cause (what triggers it)
+- How to reproduce it (minimal example)
+- How to resolve it
+
+Reference: `docs/ai/errors.md` in BugBunny.
+
+---
+
+## Step 5 — Update docs/howto/ and docs/concepts.md
+
+Read `docs/_index.md` (human documentation section) to know which files exist.
+Update only the sections affected by the changes in this release.
+Do not rewrite files that were not affected by the changes.
+
+---
+
+## Step 6 — Update README.md
+
+Generate or update README.md after `docs/howto/` is already updated.
+README structure:
+1. One-line description
+2. Installation (`gem 'gem_name'` in Gemfile)
+3. Quick start — two minimal code examples (publisher side + consumer/server side if applicable)
+4. Features list for the current version
+5. Links to `docs/` for deeper guides
+
+Keep it under 150 lines. README is the entry point — `docs/` is the depth.
+
+---
+
+## Step 7 — Show diff and wait for approval
+
+Show the complete diff of all generated/updated files.
+Wait for developer approval before proceeding.
+The developer may adjust content before confirming.
+Do NOT proceed to version bump or CHANGELOG until approved.

data/.claude/commands/pr.md

@@ -0,0 +1,53 @@
+Create a Pull Request for BugBunny via GitHub CLI. Usage: /pr
+
+Creá un PR desde la rama actual hacia `main` usando `gh`.
+
+## Pasos
+
+1. **Correr tests** — si fallan, detener todo:
+   ```bash
+   source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8
+   bundle exec rspec
+   ```
+2. **autocorregir rubocop** - si fallan, detener todo
+   ```bash
+   bundle exec rubocop -a
+   ```
+3. **Ejecutar `/gem-ai-setup`** — genera/actualiza `docs/howto/`, `docs/ai/` y `README.md`.
+   Esperar aprobación del developer antes de continuar.
+4. Verificá que hay commits en la rama que no están en main: `git log main..HEAD --oneline`
+5. Revisá todos los cambios del PR: `git diff main...HEAD`
+6. Determiná el tipo de cambio (feature, bugfix, refactor, docs, chore)
+7. Creá el PR con `gh pr create`:
+
+```bash
+gh pr create --title "tipo: descripción breve" --body "$(cat <<'EOF'
+## Summary
+- Bullet points de los cambios principales
+
+## Test plan
+- [ ] Tests existentes pasan (`/test`)
+- [ ] RuboCop sin offenses (`/rubocop`)
+- [ ] YARD documentado en métodos nuevos/modificados
+
+## Notes
+Contexto adicional si es necesario.
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+EOF
+)"
+```
+
+## Convenciones de título
+
+- `feat: descripción` — feature nueva
+- `fix: descripción` — bugfix
+- `chore: descripción` — mantenimiento, deps, config
+- `docs: descripción` — solo documentación
+- `refactor: descripción` — refactor sin cambio de comportamiento
+
+## Importante
+
+- El remote SSH está roto — si el PR requiere push previo, usar HTTPS temporalmente
+- Mostrar la URL del PR creado al usuario
+- No crear el PR sin confirmación del usuario

data/.claude/commands/release.md

@@ -0,0 +1,52 @@
+Release BugBunny gem. Usage: /release [patch|minor|major]
+
+Ejecutá el flujo completo de release para BugBunny. El argumento determina el tipo de bump:
+- `patch` → bugfix (4.6.1 → 4.6.2)
+- `minor` → feature nueva (4.6.1 → 4.7.0)
+- `major` → breaking change (4.6.1 → 5.0.0)
+
+## Pasos
+
+1. **Leer versión actual** de `lib/bug_bunny/version.rb`
+2. **Calcular nueva versión** según el tipo de bump
+3. **Correr tests** — si fallan, detener todo:
+   ```bash
+   source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8
+   bundle exec rspec
+   ```
+4. **autocorregir rubocop** - si fallan, detener todo
+   ```bash
+   bundle exec rubocop -a
+   ```
+5. **Ejecutar `/gem-ai-setup`** — genera/actualiza `docs/howto/`, `docs/ai/` y `README.md`.
+   Esperar aprobación del developer antes de continuar.
+6. **Actualizar `lib/bug_bunny/version.rb`** con la nueva versión
+7. **Agregar entrada al tope de `CHANGELOG.md`** con formato:
+   ```
+   ## [X.Y.Z] - YYYY-MM-DD
+   ### ✨ New Features / 🐛 Bug Fixes / 💥 Breaking Changes
+   * Descripción de los cambios
+   ```
+8. **Mostrar el diff completo** al usuario y pedir confirmación antes de continuar
+9. **Commit** con mensaje: `feat|fix|chore: descripción breve vX.Y.Z`
+10. **Merge a main** desde `/Users/gabriel/src/gems/bug_bunny`: `git merge --ff-only <branch>`
+11. **Push via HTTPS**:
+    ```bash
+    git remote set-url origin https://github.com/gedera/bug_bunny.git
+    git push origin main
+    git remote set-url origin git@github.com:gedera/bug_bunny.git
+    ```
+12. **Tag y push**:
+    ```bash
+    git tag vX.Y.Z
+    git remote set-url origin https://github.com/gedera/bug_bunny.git
+    git push origin vX.Y.Z
+    git remote set-url origin git@github.com:gedera/bug_bunny.git
+    ```
+
+## Importante
+
+- Nunca commitear ni pushear sin confirmación explícita del usuario
+- El worktree de main está en `/Users/gabriel/src/gems/bug_bunny`
+- SSH está roto — siempre usar HTTPS para push y restaurar SSH después
+- Sourcear chruby antes de cualquier comando Ruby: `source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8`

data/.claude/commands/rubocop.md

@@ -0,0 +1,22 @@
+Run RuboCop for BugBunny. Usage: /rubocop [--fix]
+
+Ejecutá RuboCop con rubocop-rails-omakase sobre el código modificado.
+
+## Comandos
+
+Sin argumentos — solo reporte:
+```bash
+source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8 && bundle exec rubocop
+```
+
+Con `--fix` — autocorrect seguro:
+```bash
+source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8 && bundle exec rubocop -a
+```
+
+## Reglas importantes
+
+- **Solo corregir código nuevo o modificado en el PR actual** — nunca tocar código existente no relacionado
+- Si hay offenses que requieren intervención manual (no autocorregibles), reportalos con línea y descripción
+- rubocop-rails-omakase tiene opiniones fuertes sobre estilo — seguirlas sin discutir
+- Si hay un offense legítimo que debe ignorarse, usar `# rubocop:disable Cop/Name` en la línea específica con un comentario explicativo

data/.claude/commands/service-ai-setup.md

@@ -0,0 +1,168 @@
+Generate or update the complete AI documentation suite for this microservice.
+
+This skill is invoked automatically by `/pr`. It can also be run standalone.
+
+The same quality standard as BugBunny's `docs/ai/` applies here — self-contained chunks, RAG-optimized, no introductory prose.
+
+---
+
+## Step 1 — Discover the current state
+
+Read in order:
+1. `docs/_index.md` — if it exists, lists all files and their purpose
+2. `docs/ai/_index.md` — if it exists, current profile and file list
+3. `CLAUDE.md` — service purpose, architecture, dependencies
+4. `config/services.yml` — declared dependencies (other services this one talks to)
+5. `config/routes.rb` or `config/initializers/bug_bunny_routes.rb` — what this service exposes
+
+If `docs/ai/` does not exist yet, this is a **first-time generation**. Create from scratch.
+If it exists, **update only the sections affected by the changes in this PR**.
+
+---
+
+## Step 2 — Profile
+
+Microservices always use the **full profile** with `contracts.md` instead of `api.md`:
+
+```
+docs/ai/
+  _index.md
+  glossary.md
+  architecture.md
+  contracts.md      ← what this service exposes (queues, endpoints, events)
+  faq_internal.md
+  faq_external.md
+  antipatterns.md
+  errors.md
+```
+
+---
+
+## Step 3 — Analyze the codebase
+
+Read:
+- `app/` — controllers, models, workers, services
+- `config/` — routes, initializers, services.yml
+- `lib/` — custom libraries
+- `spec/` — usage patterns and edge cases
+- `CHANGELOG.md` or git log — what changed in this PR
+
+---
+
+## Step 4 — Generate or update each file
+
+Apply the same RAG optimization rules as `gem-ai-setup`:
+1. Each section ≤ 400 tokens, self-contained
+2. `faq_*.md` strict Q&A format, H3 question, answer ≤ 150 words
+3. `glossary.md` one entry per term, 1-3 lines
+4. `errors.md` one entry per error, cause + reproduction + resolution
+5. No introductory prose
+
+### `_index.md`
+
+Frontmatter manifest. Use `kind: microservice` and `transports:` listing all transports used (bug_bunny, http, etc.). List every file with its audience.
+
+```yaml
+---
+type: knowledge_base
+kind: microservice
+name: service_name
+version: main        # microservices don't have semver — use branch or date
+profile: full
+language: ruby
+audiences:
+  - internal
+  - external
+transports:
+  - bug_bunny        # list actual transports used
+  - http
+files:
+  - path: glossary.md
+    audience: [internal, external]
+  - path: architecture.md
+    audience: [internal]
+  - path: contracts.md
+    audience: [external]
+  ...
+---
+```
+
+### `glossary.md`
+
+Domain terms specific to this service's business domain and technical patterns.
+
+### `architecture.md`
+
+Internal-facing. Include:
+- Service responsibility (one paragraph)
+- Component map
+- Data flows for the main operations
+- External dependencies and how they're used
+- Background jobs and their triggers
+
+### `contracts.md`
+
+External-facing. The complete contract this service exposes. Include:
+
+**BugBunny queues (if applicable):**
+- Queue name, exchange, routing key, exchange type
+- For each route: method, path, request format, response format, possible errors
+- Example request and response payloads
+
+**HTTP endpoints (if applicable):**
+- Method, path, parameters, response format
+- Authentication requirements
+
+**Events published (if applicable):**
+- Exchange, routing key, payload format
+
+### `faq_internal.md`
+
+Q&A for the service developer. Cover:
+- How to add a new route or endpoint
+- How background jobs work and how to add one
+- How to add a new service dependency
+- Non-obvious architectural decisions
+
+### `faq_external.md`
+
+Q&A for developers of other services that consume this one. Cover:
+- How to make a request to this service
+- What errors to expect and how to handle them
+- How to handle retries and timeouts
+- How to test integrations against this service
+
+### `antipatterns.md`
+
+Common mistakes when interacting with or modifying this service.
+
+### `errors.md`
+
+All error responses this service can return. For each:
+- HTTP status / error code
+- When it occurs
+- What the response body looks like
+- How the caller should handle it
+
+---
+
+## Step 5 — Update docs/howto/ and README.md
+
+Read `docs/_index.md` to discover which human docs exist.
+Update sections affected by this PR's changes.
+Update `README.md` last — after `docs/howto/` is updated.
+
+README structure for a microservice:
+1. Service purpose (one paragraph)
+2. Transports (BugBunny queue name, HTTP base URL)
+3. Quick start — how another service calls this one
+4. Links to `docs/ai/contracts.md` for full contract reference
+
+---
+
+## Step 6 — Show diff and wait for approval
+
+Show the complete diff of all generated/updated files.
+Wait for developer approval before proceeding to PR creation.
+The developer may adjust content before confirming.
+Do NOT create the PR until the docs are approved.

data/.claude/commands/test.md

@@ -0,0 +1,28 @@
+Run RSpec tests for BugBunny. Usage: /test [path]
+
+Ejecutá la suite de tests de BugBunny con Ruby 3.3.8.
+
+## Comando base
+
+```bash
+source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8 && bundle exec rspec
+```
+
+Si se pasa un path como argumento, corré solo ese archivo o directorio:
+
+```bash
+source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8 && bundle exec rspec $ARGUMENTS
+```
+
+## Después de correr los tests
+
+- Si hay failures: analizá el error, identificá la causa raíz, proponé el fix al usuario antes de tocar código
+- Si hay warnings de deprecación: reportalos al usuario
+- Si todos pasan: confirmá con el conteo de ejemplos y tiempo de ejecución
+
+## Convenciones de RSpec en este proyecto
+
+- Tests en `spec/`
+- Sin mocks de RabbitMQ real — usar doubles de Bunny
+- Describir comportamiento, no implementación
+- Un `context` por escenario, `it` con descripción en español o inglés consistente con el archivo

data/.claude/commands/yard.md

@@ -0,0 +1,46 @@
+Validate and generate YARD documentation for BugBunny. Usage: /yard
+
+Verificá y generá la documentación YARD de la gema.
+
+## Comandos
+
+Generar docs:
+```bash
+source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8 && bundle exec yard doc
+```
+
+Ver métodos sin documentar:
+```bash
+source /opt/homebrew/opt/chruby/share/chruby/chruby.sh && chruby ruby-3.3.8 && bundle exec yard stats --list-undoc
+```
+
+## Estándar YARD de este proyecto
+
+Todo método público nuevo o modificado debe tener:
+
+```ruby
+# Descripción breve en una línea.
+#
+# Descripción extendida opcional si la firma no es autoexplicativa.
+#
+# @param nombre [Tipo] Descripción del parámetro
+# @return [Tipo] Descripción del valor de retorno
+# @raise [ClaseError] Condición bajo la cual se lanza
+# @example
+#   resultado = mi_metodo(arg)
+def mi_metodo(nombre)
+```
+
+## Tipos comunes en este proyecto
+
+- `[String]`, `[Integer]`, `[Boolean]`, `[Hash]`, `[Array]`, `[Symbol]`
+- `[Bunny::Session]`, `[Bunny::Channel]`, `[Bunny::MessageProperties]`
+- `[BugBunny::Session]`, `[BugBunny::Request]`, `[BugBunny::Configuration]`
+- `[Proc, nil]` para callbacks opcionales
+- `[void]` para métodos sin return value relevante
+
+## Después de correr
+
+- Reportá los métodos públicos sin documentar
+- No documentar métodos privados (YARD los ignora por defecto con `private`)
+- No documentar métodos triviales (`attr_reader`, `attr_accessor`) salvo que necesiten contexto

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [4.8.0] - 2026-04-02
+
+### ✨ AI Documentation Standard (v4.3)
+* **Gema de Referencia:** BugBunny se convierte en la implementación de referencia para el nuevo Estándar de Documentación AI.
+* **Knowledge Base (Capa 1):** Implementación completa del directorio `docs/ai/` con los 8 archivos de conocimiento estructurado (Glosario, Arquitectura, API, Errores, Antipatrones, FAQs) optimizados para RAG ( chunks ≤ 400 tokens).
+* **Distribución Automática:** Nueva tarea `rake bug_bunny:sync` que permite a cualquier microservicio consumidor sincronizar y referenciar la base de conocimientos de la gema en su propio `CLAUDE.md`.
+* **Generadores:** El `InstallGenerator` ahora inyecta automáticamente el bloque de configuración AI en el proyecto consumidor y crea la estructura de directorios bajo `app/bug_bunny`.
+* **Metadatos:** Inclusión de `documentation_uri` en el `gemspec` para descubrimiento automático de manuales por herramientas de IA externas.
+
+### 🛠️ Tooling & DX
+* **Comandos Enriquecidos:** `/release` y `/pr` ahora incluyen orquestación automatizada de calidad (RuboCop, Tests) y generación de documentación antes de proceder con el ciclo de Git.
+* **Skill Integration:** Soporte para la skill `rabbitmq-expert` localizada en `.agents/skills/` para asistir en decisiones técnicas profundas de AMQP.
+
+## [4.7.0] - 2026-04-01
+
+### ✨ New Features
+* **Routing — Namespace blocks:** Nuevo método `namespace` en el DSL de rutas para organizar controladores en módulos Ruby. Los namespaces son acumulativos y anidables: `namespace :api { namespace :v1 { resources :metrics } }` resuelve a `Api::V1::MetricsController`. El namespace de la ruta tiene precedencia sobre `config.controller_namespace`.
+* **Controller — `after_action`:** Nuevo callback que se ejecuta después de la acción exitosa. No se invoca si un `before_action` haltó la cadena ni si la acción lanzó una excepción, siguiendo el comportamiento de Rails. Soporta `only:` y `except:`, y se hereda entre controladores.
+* **Controller — `render` con `headers:`:** El método `render` acepta un keyword `headers:` para adjuntar headers por-respuesta sin mutar `response_headers`. `response_headers` se inicializa con `with_indifferent_access`.
+* **Consumer — `shutdown`:** Nuevo método público que detiene el health check timer y cierra el canal AMQP de forma ordenada. Se invoca automáticamente vía `ensure` cuando `subscribe` termina por cualquier motivo (señal, error, fin de loop), garantizando limpieza completa de recursos.
+* **Configuration — `validate!`:** `BugBunny.configure` invoca `validate!` al final del bloque. Verifica presencia de campos requeridos (`host`, `port`, `username`, `password`, `vhost`) y rangos válidos para timeouts y `channel_prefetch`. Lanza `BugBunny::ConfigurationError` con mensaje descriptivo en lugar de fallar silenciosamente al conectar.
+
+### ⚡ Performance & Robustness
+* **Client — Session & Producer pooling:** `BugBunny::Client` ya no crea ni destruye un `Session` (canal AMQP) y un `Producer` por request. Ambos se cachean como ivars sobre el objeto conexión del pool (`@_bug_bunny_session`, `@_bug_bunny_producer`) y se reutilizan en todos los requests del mismo slot. El cacheo del `Producer` es crítico: el Producer registra un `basic_consume` en el canal para escuchar replies RPC; recrearlo sobre un canal reutilizado intentaría un segundo `basic_consume` causando un error AMQP. Thread-safe sin mutex adicional: `ConnectionPool` garantiza que cada slot es usado por un único thread a la vez.
+* **Session — Double-checked locking:** El método `channel` usa un patrón de double-checked locking con `@channel_mutex` para evitar que múltiples threads creen canales simultáneamente cuando el canal cae. `close` también está protegido por el mismo mutex.
+* **ConsumerMiddleware::Stack — Thread safety:** `use`, `empty?` y `call` están protegidos por un `Mutex`. `call` toma un snapshot del array bajo mutex y ejecuta la cadena fuera del lock, evitando serializar el procesamiento de mensajes durante registros concurrentes.
+
+### 🔍 Observability
+* **`Observability::SENSITIVE_KEYS` expandido:** La lista de claves filtradas en logs crece de 5 a 11 entradas: se agregan `authorization`, `credential`, `private_key`, `csrf`, `session_id` y `passwd`. El matching pasa de comparación exacta por symbol a substring matching en lowercase con normalización de hyphens a underscores, cubriendo variantes como `X-Api-Key`, `user_password` o `accessToken`.
+* **`Observability.sensitive_key?` público:** El método de detección de claves sensibles se expone como método de módulo reutilizable por componentes externos (middlewares, integraciones).
+
+### 🐛 Bug Fixes
+* **Resource — dirty tracking híbrido:** Se corrigen los overrides `changed?` y `changed` para combinar correctamente el tracking nativo de `ActiveModel::Dirty` (atributos tipados) con el tracking manual de atributos dinámicos (`@dynamic_changes`). Anteriormente, `changed?` solo reflejaba atributos tipados. `id=` ahora registra el cambio en `@dynamic_changes` cuando `id` no está declarado como `attribute`.
+* **Resource — inicialización:** `initialize` pasa `attributes` directamente a `super` en lugar del patrón `super() + assign_attributes`, delegando correctamente a `ActiveModel::Model`.
+
 ## [4.6.1] - 2026-03-31
 
 ### 🐛 Bug Fixes
@@ -78,33 +113,33 @@
 
 ## [4.2.0] - 2026-03-22
 
-### 🔠 Observability & Structured Logging
-* **Structured Logs (Key-Value):** Se migraron todos los logs del framework a un formato \`key=value\` estructurado, ideal para herramientas de monitoreo como Datadog o CloudWatch. Se eliminaron emojis y texto libre para mejorar el parseo automático.
-* **Lazy Evaluation (Debug Blocks):** Las llamadas a \`logger.debug\` ahora utilizan bloques para evitar la interpolación de strings innecesaria en producción, optimizando el uso de CPU y memoria.
+### Observability & Structured Logging
+* **Structured Logs (Key-Value):** Se migraron todos los logs del framework a un formato `key=value` estructurado, ideal para herramientas de monitoreo como Datadog o CloudWatch. Se eliminaron emojis y texto libre para mejorar el parseo automático.
+* **Lazy Evaluation (Debug Blocks):** Las llamadas a `logger.debug` ahora utilizan bloques para evitar la interpolación de strings innecesaria en producción, optimizando el uso de CPU y memoria.
 
-### ðŸ›¡ï¸  Resilience & Connectivity
-* **Exponential Backoff:** El \`Consumer\` ahora implementa un algoritmo de reintento exponencial para reconectarse a RabbitMQ, evitando picos de carga durante caídas del broker.
-* **Max Reconnect Attempts:** Nueva configuración \`max_reconnect_attempts\` que permite que el worker falle definitivamente tras N intentos, facilitando el reinicio del Pod por parte de orquestadores como Kubernetes.
-* **Performance Tuning:** Se desactivaron los \`publisher_confirms\` en el canal del \`Consumer\` al responder RPCs para reducir la latencia de respuesta (round-trips innecesarios).
+### Resilience & Connectivity
+* **Exponential Backoff:** El `Consumer` ahora implementa un algoritmo de reintento exponencial para reconectarse a RabbitMQ, evitando picos de carga durante caídas del broker.
+* **Max Reconnect Attempts:** Nueva configuración `max_reconnect_attempts` que permite que el worker falle definitivamente tras N intentos, facilitando el reinicio del Pod por parte de orquestadores como Kubernetes.
+* **Performance Tuning:** Se desactivaron los `publisher_confirms` en el canal del `Consumer` al responder RPCs para reducir la latencia de respuesta (round-trips innecesarios).
 
 ## [4.1.2] - 2026-03-22
 
-### ✨ Improvements
-* **Controller:** Ahora lanza una excepción \`BugBunny::BadRequest\` (400) si el cuerpo de la petición contiene un JSON inválido, mejorando la depuración en el cliente.
-* **Resource:** Se añadió una protección a \`.with\` (\`ScopeProxy\`) para asegurar que el contexto sea de un solo uso, evitando efectos secundarios en llamadas encadenadas.
+### Improvements
+* **Controller:** Ahora lanza una excepción `BugBunny::BadRequest` (400) si el cuerpo de la petición contiene un JSON inválido, mejorando la depuración en el cliente.
+* **Resource:** Se añadió una protección a `.with` (`ScopeProxy`) para asegurar que el contexto sea de un solo uso, evitando efectos secundarios en llamadas encadenadas.
 
 ## [4.1.1] - 2026-03-22
 
 ### 🐛 Bug Fixes
-* **Consumer:** Previene memory leak al detener el `TimerTask` de health check previo antes de realizar una reconexión.
-* **Controller:** Corrige la mutación accidental de \`log_tags\` globales al usar una lógica de herencia no destructiva en \`compute_tags\`.
+* **Consumer:** Previene memory leak al detener el `TimerTask` de health check previo antes de realizar una reconexión.
+* **Controller:** Corrige la mutación accidental de `log_tags` globales al usar una lógica de herencia no destructiva en `compute_tags`.
 
 ## [4.1.0] - 2026-03-22
 
 ### 🚀 New Features & Improvements
-* **Faraday-style Client API:** Se introdujo el método \`Client#send\` como punto de entrada genérico, permitiendo una sintaxis más familiar y flexible.
-* **Flexible Delivery Modes:** Introducción del atributo \`delivery_mode\` (:rpc o :publish). Ahora es posible configurar la estrategia de envío a nivel de cliente o por cada petición individual.
-* **Smart Request Defaults:** Los métodos \`request\` y \`publish\` ahora delegan internamente en \`send\`, manteniendo la compatibilidad pero beneficiándose de la nueva arquitectura de peticiones.
+* **Faraday-style Client API:** Se introdujo el método `Client#send` como punto de entrada genérico, permitiendo una sintaxis más familiar y flexible.
+* **Flexible Delivery Modes:** Introducción del atributo `delivery_mode` (:rpc o :publish). Ahora es posible configurar la estrategia de envío a nivel de cliente o por cada petición individual.
+* **Smart Request Defaults:** Los métodos `request` y `publish` ahora delegan internamente en `send`, manteniendo la compatibilidad pero beneficiándose de la nueva arquitectura de peticiones.
 
 ## [4.0.1] - 2026-03-13