@the-bearded-bear/claude-craft 8.22.0 → 8.23.0

package/Infra/i18n/fr/PgBouncer/agents/pgbouncer-deployment.md

@@ -7,7 +7,7 @@ description: PgBouncer deployment and CI/CD pipeline specialist
 
 ## Identite
 
-Vous etes un **Ingenieur Senior de Deploiement PgBouncer** specialise dans les deploiements Docker/Bitnami en conteneurs, les patterns Kubernetes sidecar et standalone, la configuration de charts Helm, la gestion de services systemd et les strategies de reload sans interruption. Vous concevez des pipelines de deploiement pour des mises en production fiables de PgBouncer dans tous les environnements.
+Vous etes un **Ingenieur Senior de Deploiement PgBouncer** specialise dans les deploiements Docker en conteneurs, les patterns Kubernetes sidecar et standalone, la configuration de charts Helm, la gestion de services systemd et les strategies de reload sans interruption. Vous concevez des pipelines de deploiement pour des mises en production fiables de PgBouncer dans tous les environnements.
 
 ## Expertise technique
 
@@ -15,7 +15,7 @@ Vous etes un **Ingenieur Senior de Deploiement PgBouncer** specialise dans les d
 
 | Domaine | Expertise | Perimetre |
 |---------|-----------|-----------|
-| Deploiement Docker | Expert | Image Bitnami, Dockerfile personnalise, health checks |
+| Deploiement Docker | Expert | Image communautaire, Dockerfile personnalise, health checks |
 | Patterns Kubernetes | Expert | Sidecar par pod, Deployment standalone, Helm |
 | Gestion systemd | Expert | Fichiers unit, reload, journalisation journald |
 | Reload sans interruption | Expert | SIGHUP, commande RELOAD, drain graceful |
@@ -55,25 +55,28 @@ Vous etes un **Ingenieur Senior de Deploiement PgBouncer** specialise dans les d
 
 #### Docker Compose
 
+> **Note sur l'image :** `bitnami/pgbouncer` n'est plus maintenue sur Docker Hub (Bitnami a restreint son catalogue public en 2025 ; `bitnamilegacy/pgbouncer` est figée en 1.24.1, touchée par les CVE corrigées en 1.26.0). Les exemples utilisent l'image communautaire `edoburu/pgbouncer` (variables `DB_*`, écoute sur 5432 sauf si `LISTEN_PORT` est défini). Épingler le tag et auditer l'image avant la production.
+
 ```yaml
 # docker-compose.yml
 services:
   pgbouncer:
-    image: bitnami/pgbouncer:1.25.1
+    image: edoburu/pgbouncer:v1.26.0-p0
     ports:
       - "6432:6432"
     environment:
-      - POSTGRESQL_HOST=postgresql
-      - POSTGRESQL_PORT=5432
-      - POSTGRESQL_USERNAME=app_user
-      - POSTGRESQL_PASSWORD=${DB_PASSWORD}
-      - POSTGRESQL_DATABASE=app_production
-      - PGBOUNCER_POOL_MODE=transaction
-      - PGBOUNCER_MAX_CLIENT_CONN=200
-      - PGBOUNCER_DEFAULT_POOL_SIZE=20
-      - PGBOUNCER_MIN_POOL_SIZE=5
-      - PGBOUNCER_SERVER_RESET_QUERY=DISCARD ALL
-      - PGBOUNCER_AUTH_TYPE=scram-sha-256
+      - DB_HOST=postgresql
+      - DB_PORT=5432
+      - DB_USER=app_user
+      - DB_PASSWORD=${DB_PASSWORD}
+      - DB_NAME=app_production
+      - LISTEN_PORT=6432
+      - POOL_MODE=transaction
+      - MAX_CLIENT_CONN=200
+      - DEFAULT_POOL_SIZE=20
+      - MIN_POOL_SIZE=5
+      - SERVER_RESET_QUERY=DISCARD ALL
+      - AUTH_TYPE=scram-sha-256
     healthcheck:
       test: ["CMD", "pg_isready", "-h", "localhost", "-p", "6432"]
       interval: 10s
@@ -85,13 +88,14 @@ services:
     restart: unless-stopped
 
   postgresql:
-    image: postgres:17
+    image: postgres:18
     environment:
       - POSTGRES_DB=app_production
       - POSTGRES_USER=app_user
       - POSTGRES_PASSWORD=${DB_PASSWORD}
     volumes:
-      - pgdata:/var/lib/postgresql/data
+      # PostgreSQL 18+ images keep data under /var/lib/postgresql/<major>/
+      - pgdata:/var/lib/postgresql
     healthcheck:
       test: ["CMD-SHELL", "pg_isready -U app_user"]
       interval: 10s
@@ -124,31 +128,33 @@ spec:
     spec:
       containers:
         - name: pgbouncer
-          image: bitnami/pgbouncer:1.25.1
+          image: edoburu/pgbouncer:v1.26.0-p0
           ports:
             - containerPort: 6432
           env:
-            - name: POSTGRESQL_HOST
+            - name: DB_HOST
               value: postgresql.database.svc.cluster.local
-            - name: POSTGRESQL_PORT
+            - name: DB_PORT
               value: "5432"
-            - name: POSTGRESQL_DATABASE
+            - name: DB_NAME
               value: app_production
-            - name: POSTGRESQL_USERNAME
+            - name: DB_USER
               valueFrom:
                 secretKeyRef:
                   name: pgbouncer-secrets
                   key: db-username
-            - name: POSTGRESQL_PASSWORD
+            - name: DB_PASSWORD
               valueFrom:
                 secretKeyRef:
                   name: pgbouncer-secrets
                   key: db-password
-            - name: PGBOUNCER_POOL_MODE
+            - name: LISTEN_PORT
+              value: "6432"
+            - name: POOL_MODE
               value: transaction
-            - name: PGBOUNCER_MAX_CLIENT_CONN
+            - name: MAX_CLIENT_CONN
               value: "200"
-            - name: PGBOUNCER_DEFAULT_POOL_SIZE
+            - name: DEFAULT_POOL_SIZE
               value: "20"
           livenessProbe:
             tcpSocket:
@@ -204,17 +210,19 @@ spec:
             - name: DATABASE_URL
               value: "postgresql://app_user:$(DB_PASSWORD)@localhost:6432/app_production"
         - name: pgbouncer
-          image: bitnami/pgbouncer:1.25.1
+          image: edoburu/pgbouncer:v1.26.0-p0
           ports:
             - containerPort: 6432
           env:
-            - name: POSTGRESQL_HOST
+            - name: DB_HOST
               value: postgresql.database.svc.cluster.local
-            - name: PGBOUNCER_POOL_MODE
+            - name: LISTEN_PORT
+              value: "6432"
+            - name: POOL_MODE
               value: transaction
-            - name: PGBOUNCER_MAX_CLIENT_CONN
+            - name: MAX_CLIENT_CONN
               value: "100"
-            - name: PGBOUNCER_DEFAULT_POOL_SIZE
+            - name: DEFAULT_POOL_SIZE
               value: "10"
           resources:
             requests:

package/Infra/i18n/fr/PgBouncer/commands/deploy-setup.md

@@ -54,7 +54,7 @@ STRATEGIE DE DEPLOIEMENT
 
 Methode : {Docker Compose / K8s Standalone / K8s Sidecar / Systemd}
 HA : {Active-passif / Replicas multiples / Instance unique}
-Image : bitnami/pgbouncer:1.25.1
+Image : edoburu/pgbouncer:v1.26.0-p0
 
 | Decision | Choix | Justification |
 |----------|-------|---------------|

package/Infra/i18n/pt/Ansible/agents/ansible-architect.md

@@ -32,6 +32,8 @@ Voce e um **Arquiteto Ansible Senior** capaz de projetar arquiteturas completas
 | Multi-ambiente | Separacao dev / staging / producao | Alta |
 | Hierarquico (Landscape/Type/Function) | Gerenciamento de datacenter corporativo | Alta |
 
+> Hetzner Cloud: usar a coleção `hetzner.hcloud` (7.2.0) com ansible-core 2.21.5, fixada em `requirements.yml`.
+
 ## Metodologia
 
 ### Fase 1 -- Descoberta

package/Infra/i18n/pt/Docker/commands/docker-architecture.md

@@ -142,8 +142,6 @@ projeto/
 
 ```yaml
 # docker-compose.yml
-version: "3.8"
-
 services:
   # ═══════════════════════════════════════════════════════════
   # REVERSE PROXY

package/Infra/i18n/pt/Docker/commands/docker-compose-setup.md

@@ -51,8 +51,6 @@ Stack: {stack}
 
 ```yaml
 # docker-compose.yml - Base comum
-version: "3.8"
-
 services:
   app:
     build:

package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-architect.md

@@ -7,7 +7,7 @@ description: FrankenPHP Caddyfile design, worker topology, and framework integra
 
 ## Identidade
 
-Voce e um **Arquiteto Senior de FrankenPHP** capaz de projetar topologias completas de servico de aplicacoes PHP usando FrankenPHP 1.12+. Voce coordena decisoes de worker mode vs classic mode, dimensionamento de threads, design de Caddyfile, integracao com frameworks (Symfony, Laravel), configuracao de Mercure real-time e Early Hints (103) para entregar deployments FrankenPHP prontos para producao.
+Voce e um **Arquiteto Senior de FrankenPHP** capaz de projetar topologias completas de servico de aplicacoes PHP usando FrankenPHP 1.13+. Voce coordena decisoes de worker mode vs classic mode, dimensionamento de threads, design de Caddyfile, integracao com frameworks (Symfony, Laravel), configuracao de Mercure real-time e Early Hints (103) para entregar deployments FrankenPHP prontos para producao.
 
 ## Expertise Tecnica
 
@@ -120,6 +120,9 @@ Extrair e esclarecer:
    - `max_requests = 500` para prevenir acumulo de memoria
    - Benchmark com `wrk` ou `k6`, ajustar para cima/baixo
    - Monitorar: memoria RSS por worker, tempo de resposta p99
+   - Usar FrankenPHP 1.13.0+: a 1.12.4 é vulnerável (correções de segurança na 1.12.5: phpinfo na imagem padrão, vazamento de ID de sessão em worker mode, timeout do body; 5 advisories, 2 deles high, na 1.13.0)
+   - FrankenPHP 1.13+: `num_threads` conta apenas os threads para requisições que nenhum worker atende; os threads de worker são somados, e a inicialização falha se `max_threads` < `num_threads` + threads de worker
+   - O hot reload em desenvolvimento passa pelo Mercure 1.0: `$_SERVER['FRANKENPHP_HOT_RELOAD']` agora anuncia `/.well-known/mercure?match=<topic>` (não fixar `?topic=` no código)
 
 ### Fase 3 -- Blueprint de Implementacao
 

package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-deployment.md

@@ -59,7 +59,7 @@ Voce e um **Engenheiro Senior de Deployment FrankenPHP** especializado em deploy
 # docker-compose.yml
 services:
   app:
-    image: dunglas/frankenphp:1.12-php8.5-bookworm
+    image: dunglas/frankenphp:1.13-php8.5-bookworm
     ports:
       - "80:80"
       - "443:443"
@@ -88,7 +88,7 @@ volumes:
 
 ```dockerfile
 # Stage 1: Dependencias
-FROM dunglas/frankenphp:1.12-php8.5-bookworm AS base
+FROM dunglas/frankenphp:1.13-php8.5-bookworm AS base
 
 # Instalar extensoes PHP
 RUN install-php-extensions \

package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-security.md

@@ -185,7 +185,7 @@ example.com {
 
 ```dockerfile
 # Dockerfile - FrankenPHP nao-root
-FROM dunglas/frankenphp:1.12-php8.5-bookworm
+FROM dunglas/frankenphp:1.13-php8.5-bookworm
 
 # Instalar extensoes
 RUN install-php-extensions pdo_pgsql intl opcache

package/Infra/i18n/pt/FrankenPHP/commands/deploy-setup.md

@@ -53,7 +53,7 @@ ESTRATEGIA DE DEPLOYMENT
 ──────────────────────────────────────────────────────────────
 
 Metodo: {Docker Compose / Kubernetes / Binario Standalone}
-Imagem: dunglas/frankenphp:1.12-php8.5-bookworm
+Imagem: dunglas/frankenphp:1.13-php8.5-bookworm
 Worker mode: {sim/nao}
 
 | Decisao | Escolha | Justificativa |

package/Infra/i18n/pt/Hcloud/agents/hcloud-architect.md

@@ -5,7 +5,7 @@ description: Hetzner Cloud infrastructure architecture designer
 
 # Hcloud Architect
 
-> ⚠️ **Migração obrigatória antes de 2026-07-01**: o parâmetro `location` está deprecado em favor de `location`. Provider Terraform do Hetzner Cloud >= 1.58.0. Fonte: https://github.com/hetznercloud/terraform-provider-hcloud/releases
+> ⚠️ **`datacenter` removido (2026-07-01)**: substituído por `location`; os endpoints `datacenter` retornam HTTP 410 desde 2026-10-01. Usar `location = "fsn1"` em vez de `datacenter`. Provider Terraform da Hetzner Cloud >= 1.70.0. Fonte: https://docs.hetzner.cloud/changelog e https://github.com/hetznercloud/terraform-provider-hcloud/releases
 
 ## Identidade
 
@@ -135,7 +135,7 @@ hcloud placement-group create --name web-spread --type spread
 # Servers
 hcloud server create \
   --name web-01 \
-  --type cx22 \
+  --type cx23 \
   --image ubuntu-24.04 \
   --location fsn1 \
   --ssh-key deploy-key \
@@ -199,13 +199,23 @@ hcloud network add-subnet primary-net --type cloud --network-zone eu-central --i
 
 # Servers in different locations with placement groups
 hcloud placement-group create --name pg-primary --type spread
-hcloud server create --name app-fsn-01 --type cpx31 --image ubuntu-24.04 \
+hcloud server create --name app-fsn-01 --type cpx32 --image ubuntu-24.04 \
   --location fsn1 --placement-group pg-primary --network primary-net
 
-hcloud server create --name app-hel-01 --type cpx31 --image ubuntu-24.04 \
+hcloud server create --name app-hel-01 --type cpx32 --image ubuntu-24.04 \
   --location hel1 --network primary-net
 ```
 
+## Mudanças da API Hetzner a considerar (2026)
+
+- Os Load Balancers aceitam Primary IPs existentes na criação (`public_net.ipv4` / `public_net.ipv6`; provider >= 1.70.0: `ipv4_id` / `ipv6_id`); a atribuição não pode ser alterada depois (changelog 2026-10-05)
+- Primary IPs e Floating IPs devem ser desatribuídos antes de serem excluídos: a API retorna `must_be_unassigned` (desde 2026-05-01)
+- `dns_ptr` é obrigatório nos pedidos de alteração (Primary IPs, Floating IPs, Servers, Load Balancers) desde 2026-09-30; `null` redefine o ponteiro
+- O campo `deprecated` dos server types é removido em 2026-11-02: ler `locations[].deprecation` em vez disso (`null` = não obsoleto)
+- O provider Terraform 1.69 abandona o Terraform 1.14 (1.16 adicionado); manter o provider hcloud em `>= 1.70.0`, CLI hcloud 1.70.1
+- Os server types cx22/cx32/cx42/cx52 e cpx11-cpx51 não podem mais ser pedidos desde 2026-01-01: usar cx23/cx33/cx43/cx53 e cpx12/cpx22/cpx32/cpx42/cpx52/cpx62
+- Ansible: usar a coleção `hetzner.hcloud` (7.2.0, requer um ansible-core recente, ex. 2.21.5) e fixar a versão em `requirements.yml`
+
 ## Checklist de Arquitetura
 
 ### Design

package/Infra/i18n/pt/Hcloud/agents/hcloud-cost.md

@@ -5,7 +5,7 @@ description: Hetzner Cloud cost optimization and right-sizing specialist
 
 # Hcloud Cost Specialist
 
-> ⚠️ **Migração obrigatória antes de 2026-07-01**: o parâmetro `location` está deprecado em favor de `location`. Provider Terraform do Hetzner Cloud >= 1.58.0. Fonte: https://github.com/hetznercloud/terraform-provider-hcloud/releases
+> ⚠️ **`datacenter` removido (2026-07-01)**: substituído por `location`; os endpoints `datacenter` retornam HTTP 410 desde 2026-10-01. Usar `location = "fsn1"` em vez de `datacenter`. Provider Terraform da Hetzner Cloud >= 1.70.0. Fonte: https://docs.hetzner.cloud/changelog e https://github.com/hetznercloud/terraform-provider-hcloud/releases
 
 ## Identidade
 

package/Infra/i18n/pt/Hcloud/agents/hcloud-debug.md

@@ -5,7 +5,7 @@ description: Hetzner Cloud troubleshooting specialist
 
 # Hcloud Debug Specialist
 
-> ⚠️ **Migração obrigatória antes de 2026-07-01**: o parâmetro `location` está deprecado em favor de `location`. Provider Terraform do Hetzner Cloud >= 1.58.0. Fonte: https://github.com/hetznercloud/terraform-provider-hcloud/releases
+> ⚠️ **`datacenter` removido (2026-07-01)**: substituído por `location`; os endpoints `datacenter` retornam HTTP 410 desde 2026-10-01. Usar `location = "fsn1"` em vez de `datacenter`. Provider Terraform da Hetzner Cloud >= 1.70.0. Fonte: https://docs.hetzner.cloud/changelog e https://github.com/hetznercloud/terraform-provider-hcloud/releases
 
 ## Identidade
 

package/Infra/i18n/pt/Hcloud/agents/hcloud-deployment.md

@@ -137,7 +137,7 @@ Voce e um **Engenheiro Senior de Deployment Hetzner Cloud** especializado em int
              # Create new server from image
              hcloud server create \
                --name prod-blue-$(date +%s) \
-               --type cpx31 \
+               --type cpx32 \
                --image ${{ needs.build-image.outputs.image_id }} \
                --location fsn1 \
                --ssh-key deploy \
@@ -189,7 +189,7 @@ source "hcloud" "app" {
   token        = var.hcloud_token
   image        = "ubuntu-24.04"
   location     = "fsn1"
-  server_type  = "cx22"
+  server_type  = "cx23"
   server_name  = "packer-build-{{timestamp}}"
   ssh_username = "root"
   snapshot_name = "app-{{timestamp}}"

package/Infra/i18n/pt/Hcloud/agents/hcloud-security.md

@@ -5,7 +5,7 @@ description: Hetzner Cloud security and firewall specialist
 
 # Hcloud Security Specialist
 
-> ⚠️ **Migração obrigatória antes de 2026-07-01**: o parâmetro `location` está deprecado em favor de `location`. Provider Terraform do Hetzner Cloud >= 1.58.0. Fonte: https://github.com/hetznercloud/terraform-provider-hcloud/releases
+> ⚠️ **`datacenter` removido (2026-07-01)**: substituído por `location`; os endpoints `datacenter` retornam HTTP 410 desde 2026-10-01. Usar `location = "fsn1"` em vez de `datacenter`. Provider Terraform da Hetzner Cloud >= 1.70.0. Fonte: https://docs.hetzner.cloud/changelog e https://github.com/hetznercloud/terraform-provider-hcloud/releases
 
 ## Identidade
 

package/Infra/i18n/pt/Hcloud/commands/architecture.md

@@ -5,7 +5,7 @@ argument-hint: <Project> [constraints]
 
 # Hcloud Architecture
 
-> ⚠️ **Migração obrigatória antes de 2026-07-01**: o parâmetro `location` está deprecado em favor de `location`. Provider Terraform do Hetzner Cloud >= 1.58.0. Fonte: https://github.com/hetznercloud/terraform-provider-hcloud/releases
+> ⚠️ **`datacenter` removido (2026-07-01)**: substituído por `location`; os endpoints `datacenter` retornam HTTP 410 desde 2026-10-01. Usar `location = "fsn1"` em vez de `datacenter`. Provider Terraform da Hetzner Cloud >= 1.70.0. Fonte: https://docs.hetzner.cloud/changelog e https://github.com/hetznercloud/terraform-provider-hcloud/releases
 
 Voce e um arquiteto senior de Hetzner Cloud. Voce deve projetar uma arquitetura completa de infraestrutura em nuvem a partir das especificacoes do projeto.
 
@@ -83,8 +83,8 @@ SERVER TYPE SELECTION
 
 | Role | Server Type | Count | Justification |
 |------|-------------|-------|---------------|
-| Web | {cax21/cx22} | {n} | {reason} |
-| App | {cpx31/cax31} | {n} | {reason} |
+| Web | {cax21/cx23} | {n} | {reason} |
+| App | {cpx32/cax31} | {n} | {reason} |
 | DB | {ccx23/ccx33} | {n} | {reason} |
 
 ──────────────────────────────────────────────────────────────

package/Infra/i18n/pt/Hcloud/commands/debug.md

@@ -5,7 +5,7 @@ argument-hint: <Symptom> [resource]
 
 # Hcloud Debug
 
-> ⚠️ **Migração obrigatória antes de 2026-07-01**: o parâmetro `location` está deprecado em favor de `location`. Provider Terraform do Hetzner Cloud >= 1.58.0. Fonte: https://github.com/hetznercloud/terraform-provider-hcloud/releases
+> ⚠️ **`datacenter` removido (2026-07-01)**: substituído por `location`; os endpoints `datacenter` retornam HTTP 410 desde 2026-10-01. Usar `location = "fsn1"` em vez de `datacenter`. Provider Terraform da Hetzner Cloud >= 1.70.0. Fonte: https://docs.hetzner.cloud/changelog e https://github.com/hetznercloud/terraform-provider-hcloud/releases
 
 Voce e um especialista em troubleshooting Hetzner Cloud. Voce deve diagnosticar e resolver sistematicamente problemas de infraestrutura a partir dos sintomas fornecidos.
 

package/Infra/i18n/pt/Kubernetes/agents/kubernetes-architect.md

@@ -67,8 +67,8 @@ Extrair e esclarecer:
    ┌─────────────────────────────────────────────────────────┐
    │                    INGRESS LAYER                         │
    │  ┌──────────────┐         ┌──────────────┐              │
-   │  │ Ingress NGINX│─────────│  Cert-Manager│              │
-   │  │ / Traefik    │         │  (Let's Enc.)│              │
+   │  │ Gateway API  │─────────│  Cert-Manager│              │
+   │  │ (HTTPRoute)  │         │  (Let's Enc.)│              │
    │  └──────┬───────┘         └──────────────┘              │
    └─────────┼───────────────────────────────────────────────┘
              │
@@ -95,7 +95,7 @@ Extrair e esclarecer:
    - Resource quotas e limit ranges por namespace
 
 3. **Redes**
-   - Seleção do ingress controller (NGINX, Traefik, Istio Gateway)
+   - Gateway API (HTTPRoute) como primeira opção (implementações: Envoy Gateway, Traefik, Istio, Cilium); o Ingress NGINX foi descontinuado em março de 2026 (sem mais correções de segurança), migrar com `ingress2gateway`
    - NetworkPolicies para isolamento entre namespaces
    - Estratégia de DNS (descoberta de serviços internos)
    - Terminação TLS e gerenciamento de certificados

package/Infra/i18n/pt/Kubernetes/commands/architecture.md

@@ -68,7 +68,7 @@ TOPOLOGIA DE NAMESPACES
 ┌─────────────────────────────────────────────────────────────┐
 │                      INGRESS LAYER                           │
 │  ┌───────────────┐         ┌───────────────┐                │
-│  │ Ingress NGINX │─────────│  Cert-Manager │                │
+│  │ Gateway API   │─────────│  Cert-Manager │                │
 │  └───────┬───────┘         └───────────────┘                │
 └──────────┼──────────────────────────────────────────────────┘
            │

package/Infra/i18n/pt/OpenTofu/agents/opentofu-architect.md

@@ -143,7 +143,7 @@ Produzir todas as configurações necessárias:
 ```hcl
 # versions.tf
 terraform {
-  required_version = ">= 1.7.0"
+  required_version = ">= 1.13.0"
   required_providers {
     aws = {
       source  = "hashicorp/aws"

package/Infra/i18n/pt/OpenTofu/agents/opentofu-deployment.md

@@ -65,7 +65,7 @@ Você é um **Engenheiro de Implantação OpenTofu Sênior** especializado em pi
        branches: [main]
 
    env:
-     TOFU_VERSION: "1.9.0"
+     TOFU_VERSION: "1.13.1"
 
    jobs:
      plan:
@@ -114,7 +114,7 @@ Você é um **Engenheiro de Implantação OpenTofu Sênior** especializado em pi
      - apply
 
    variables:
-     TOFU_VERSION: "1.9.0"
+     TOFU_VERSION: "1.13.1"
 
    .tofu-base:
      image: ghcr.io/opentofu/opentofu:$TOFU_VERSION

package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-architect.md

@@ -68,7 +68,8 @@ Extrair e esclarecer:
    ```
    Aplicacao usa prepared statements?
    ├── Sim, nao pode desabilitar → Session mode
-   ├── Sim, pode usar DEALLOCATE ALL → Transaction mode + server_reset_query
+   ├── Sim, protocolo estendido → Transaction mode + max_prepared_statements (200 por padrão desde 1.24)
+   ├── Sim, PREPARE SQL, pode usar DEALLOCATE ALL → Transaction mode + server_reset_query
    └── Nao
        ├── Usa SET/variaveis de sessao? → Session mode (ou transaction + reset_query)
        ├── Usa LISTEN/NOTIFY? → Session mode
@@ -264,7 +265,15 @@ default_pool_size = 20
 | Sem reserve pool | Picos causam falhas de conexao | Definir reserve_pool_size = 25% do default |
 | PgBouncer por instancia da app | Pools multiplicados, sem compartilhamento | Instancia(s) PgBouncer compartilhada(s) |
 | Sem server_reset_query | Estado de sessao vaza entre clientes | DISCARD ALL para transaction mode |
-| Ignorar prepared statements | Erros em transaction mode | Testar com app, usar DEALLOCATE ALL ou session mode |
+| Ignorar prepared statements | Erros em transaction mode | Testar com app, usar max_prepared_statements, DEALLOCATE ALL ou session mode |
+
+## Notas do PgBouncer 1.26
+
+- **Segurança**: a 1.26.0 corrige CVE-2026-19888 (client-final-message SCRAM sem nonce: queda do PgBouncer sem autenticação), CVE-2026-6668 (estouro de inteiro no buffer de pacotes que causa um loop infinito) e CVE-2026-6669 (número de iterações SCRAM sem limite aceito de um servidor); atualizar a partir de qualquer 1.25.x.
+- **Prepared statements**: `max_prepared_statements` vale 200 por padrão desde a 1.24, portanto os prepared statements do protocolo funcionam em transaction mode; `DEALLOCATE ALL` só afeta `PREPARE` SQL.
+- **Parâmetros rastreados**: `search_path` (PostgreSQL 18+) e `default_transaction_read_only` são rastreados por padrão, então um `SET` não vaza mais entre clientes em transaction mode.
+- **Novas configurações**: `pool_idle_timeout` (desativado por padrão) remove pools sem uso; `query_wait_timeout` pode ser configurado por usuário e por banco; `SHOW STATS` expõe `client_login_count`.
+- **Removido**: o restart online (`-R`), `SHOW FDS` e `SUSPEND`; usar restarts progressivos com `so_reuseport`.
 
 ## Template de Documentacao
 

package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-debug.md

@@ -167,6 +167,7 @@ psql -h localhost -p 6432 -U app_user -d app_production
 -- Nos logs do PgBouncer, procurar por:
 -- "prepared statement X does not exist"
 
+-- Correção 0: prepared statements do protocolo exigem max_prepared_statements > 0 (200 por padrão desde 1.24)
 -- Correcao 1: Adicionar DEALLOCATE ALL ao server_reset_query
 -- Em pgbouncer.ini:
 -- server_reset_query = DISCARD ALL

package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-deployment.md

@@ -7,7 +7,7 @@ description: PgBouncer deployment and CI/CD pipeline specialist
 
 ## Identidade
 
-Voce e um **Engenheiro Senior de Deployment PgBouncer** especializado em deployments Docker/Bitnami container, padroes Kubernetes sidecar e standalone, configuracao de Helm charts, gerenciamento de servicos systemd e estrategias de reload sem tempo de inatividade. Voce projeta pipelines de deployment para rollouts confiaveis de PgBouncer em todos os ambientes.
+Voce e um **Engenheiro Senior de Deployment PgBouncer** especializado em deployments Docker container, padroes Kubernetes sidecar e standalone, configuracao de Helm charts, gerenciamento de servicos systemd e estrategias de reload sem tempo de inatividade. Voce projeta pipelines de deployment para rollouts confiaveis de PgBouncer em todos os ambientes.
 
 ## Expertise Tecnica
 
@@ -15,7 +15,7 @@ Voce e um **Engenheiro Senior de Deployment PgBouncer** especializado em deploym
 
 | Dominio | Expertise | Escopo |
 |---------|-----------|--------|
-| Docker deployment | Expert | Bitnami image, custom Dockerfile, health checks |
+| Docker deployment | Expert | community image, custom Dockerfile, health checks |
 | Padroes Kubernetes | Expert | Sidecar per pod, standalone Deployment, Helm |
 | Gerenciamento systemd | Expert | Unit files, reload, journald logging |
 | Reload sem tempo de inatividade | Expert | SIGHUP, RELOAD command, graceful drain |
@@ -55,25 +55,28 @@ Voce e um **Engenheiro Senior de Deployment PgBouncer** especializado em deploym
 
 #### Docker Compose
 
+> **Nota sobre a imagem:** `bitnami/pgbouncer` não é mais mantida no Docker Hub (a Bitnami restringiu seu catálogo público em 2025; `bitnamilegacy/pgbouncer` está congelada na 1.24.1, afetada pelas CVEs corrigidas na 1.26.0). Os exemplos usam a imagem da comunidade `edoburu/pgbouncer` (variáveis `DB_*`, escuta na 5432, a menos que `LISTEN_PORT` seja definido). Fixar a tag e auditar a imagem antes da produção.
+
 ```yaml
 # docker-compose.yml
 services:
   pgbouncer:
-    image: bitnami/pgbouncer:1.25.1
+    image: edoburu/pgbouncer:v1.26.0-p0
     ports:
       - "6432:6432"
     environment:
-      - POSTGRESQL_HOST=postgresql
-      - POSTGRESQL_PORT=5432
-      - POSTGRESQL_USERNAME=app_user
-      - POSTGRESQL_PASSWORD=${DB_PASSWORD}
-      - POSTGRESQL_DATABASE=app_production
-      - PGBOUNCER_POOL_MODE=transaction
-      - PGBOUNCER_MAX_CLIENT_CONN=200
-      - PGBOUNCER_DEFAULT_POOL_SIZE=20
-      - PGBOUNCER_MIN_POOL_SIZE=5
-      - PGBOUNCER_SERVER_RESET_QUERY=DISCARD ALL
-      - PGBOUNCER_AUTH_TYPE=scram-sha-256
+      - DB_HOST=postgresql
+      - DB_PORT=5432
+      - DB_USER=app_user
+      - DB_PASSWORD=${DB_PASSWORD}
+      - DB_NAME=app_production
+      - LISTEN_PORT=6432
+      - POOL_MODE=transaction
+      - MAX_CLIENT_CONN=200
+      - DEFAULT_POOL_SIZE=20
+      - MIN_POOL_SIZE=5
+      - SERVER_RESET_QUERY=DISCARD ALL
+      - AUTH_TYPE=scram-sha-256
     healthcheck:
       test: ["CMD", "pg_isready", "-h", "localhost", "-p", "6432"]
       interval: 10s
@@ -85,13 +88,14 @@ services:
     restart: unless-stopped
 
   postgresql:
-    image: postgres:17
+    image: postgres:18
     environment:
       - POSTGRES_DB=app_production
       - POSTGRES_USER=app_user
       - POSTGRES_PASSWORD=${DB_PASSWORD}
     volumes:
-      - pgdata:/var/lib/postgresql/data
+      # PostgreSQL 18+ images keep data under /var/lib/postgresql/<major>/
+      - pgdata:/var/lib/postgresql
     healthcheck:
       test: ["CMD-SHELL", "pg_isready -U app_user"]
       interval: 10s
@@ -124,31 +128,33 @@ spec:
     spec:
       containers:
         - name: pgbouncer
-          image: bitnami/pgbouncer:1.25.1
+          image: edoburu/pgbouncer:v1.26.0-p0
           ports:
             - containerPort: 6432
           env:
-            - name: POSTGRESQL_HOST
+            - name: DB_HOST
               value: postgresql.database.svc.cluster.local
-            - name: POSTGRESQL_PORT
+            - name: DB_PORT
               value: "5432"
-            - name: POSTGRESQL_DATABASE
+            - name: DB_NAME
               value: app_production
-            - name: POSTGRESQL_USERNAME
+            - name: DB_USER
               valueFrom:
                 secretKeyRef:
                   name: pgbouncer-secrets
                   key: db-username
-            - name: POSTGRESQL_PASSWORD
+            - name: DB_PASSWORD
               valueFrom:
                 secretKeyRef:
                   name: pgbouncer-secrets
                   key: db-password
-            - name: PGBOUNCER_POOL_MODE
+            - name: LISTEN_PORT
+              value: "6432"
+            - name: POOL_MODE
               value: transaction
-            - name: PGBOUNCER_MAX_CLIENT_CONN
+            - name: MAX_CLIENT_CONN
               value: "200"
-            - name: PGBOUNCER_DEFAULT_POOL_SIZE
+            - name: DEFAULT_POOL_SIZE
               value: "20"
           livenessProbe:
             tcpSocket:
@@ -204,17 +210,19 @@ spec:
             - name: DATABASE_URL
               value: "postgresql://app_user:$(DB_PASSWORD)@localhost:6432/app_production"
         - name: pgbouncer
-          image: bitnami/pgbouncer:1.25.1
+          image: edoburu/pgbouncer:v1.26.0-p0
           ports:
             - containerPort: 6432
           env:
-            - name: POSTGRESQL_HOST
+            - name: DB_HOST
               value: postgresql.database.svc.cluster.local
-            - name: PGBOUNCER_POOL_MODE
+            - name: LISTEN_PORT
+              value: "6432"
+            - name: POOL_MODE
               value: transaction
-            - name: PGBOUNCER_MAX_CLIENT_CONN
+            - name: MAX_CLIENT_CONN
               value: "100"
-            - name: PGBOUNCER_DEFAULT_POOL_SIZE
+            - name: DEFAULT_POOL_SIZE
               value: "10"
           resources:
             requests:

package/Infra/i18n/pt/PgBouncer/commands/deploy-setup.md

@@ -54,7 +54,7 @@ ESTRATEGIA DE DEPLOYMENT
 
 Metodo: {Docker Compose / K8s Standalone / K8s Sidecar / Systemd}
 HA: {Active-passive / Multiplas replicas / Instancia unica}
-Imagem: bitnami/pgbouncer:1.25.1
+Imagem: edoburu/pgbouncer:v1.26.0-p0
 
 | Decisao | Escolha | Justificativa |
 |---------|---------|---------------|