O que o Decidim 0.33 muda e onde isso encosta no Participa

1Contexto

1.1 O que é “0.33” hoje

O Decidim 0.33 ainda não foi lançado. Não existe tag v0.33.0 nem branch release/0.33-stable — as release branches param em 0.32-stable. O que existe é a branch develop, cujo lib/decidim/version.rb declara:

# upstream develop — lib/decidim/version.rb
module Decidim
  def self.version
    "0.33.0.dev"
  end
end

Isso define o escopo do nosso “diff”: comparar v0.32.1 (o que rodamos) com develop (o 0.33 em construção). São 396 commits e 2445 arquivos — e, como veremos, a maior parte não nos atinge. O trabalho útil é achar a interseção.

1.2 Nossa superfície de acoplamento

O Participa não é um app que usa o Decidim “pela API pública”. Ele estende o Decidim por dentro. É essa intimidade que transforma um upgrade em risco — e o risco é proporcional a quantos pontos internos tocamos.

A camada mais arriscada é a de baixo: as gems que fazem prepend em classes como Decidim::Meetings::Meeting ou Decidim::Proposals::ProposalForm. Um prepend não é um contrato versionado — é uma aposta de que a assinatura daquele método não vai mudar.

2Como ler um impacto

Uma mudança do upstream só nos atinge por três caminhos. Separar os três evita tanto o pânico quanto a negligência.

As seções 3 a 5 varrem os três caminhos, nesta ordem.

3O que o upstream diz (caminho ①)

O diff do RELEASE_NOTES.md entre v0.32.1 e develop adiciona quatro itens. Cada um com a nossa exposição imediata.

# upstream develop — decidim-core/app/packs/src/decidim/index.js
window.initFoundation = (element) => {
  let message = "[Decidim] initFoundation method has previously used to initialize
  foundation-sites based tools. The Foundation CSS based interface has been removed in 0.28.
  ... Calling this method, will have no effect on your application."
}

4Nosso gancho → arquivo do upstream (caminho ②)

Extraímos todos os pontos em que nosso código faz prepend/include em classes do Decidim e conferimos quais desses arquivos mudaram no 0.33.

5Impacto por área (caminho ③ + detalhe)

5.1 Toolchain — Node 22 → 24

Ruby continua em 3.4.7 (igual ao nosso). O salto é o Node: o 0.33 pede .node-version = 24.18.0 e engines.node >= 24.18.0. Nosso .node-version/.tool-versions e o Dockerfile estão em 22.14.0.

5.2 Frontend / Foundation

Além do item R4, o diff mostra que o Decidim reescreveu componentes JS em áreas que usamos (decidim-date-picker, decidim_editor, decidim_controllers) e alterou layouts/decidim/_head.html.erb — que é justamente onde o nosso _head_extra.html.erb se pluga.

5.3 Participantes ocultos (nosso ponto mais sensível de produto)

O upstream introduziu um scope novo em Decidim::UserBaseEntity:

# upstream develop — decidim-core/app/models/decidim/user_base_entity.rb
scope :profile_published, -> { confirmed.not_deleted.where(managed: false) }
scope :visible, lambda { profile_published.not_blocked.merge(
  Decidim::User.tos_accepted.or(Decidim::UserBaseEntity.where.not(type: "Decidim::User"))) }
def visible? = !blocked? && profile_published?

Isso cruza exatamente com dois recursos nossos: login efêmero (participante sem conta plena) e login gov.br (ToS pode não estar aceito). Participantes assim deixam de aparecer em perfis, listagens e API. É uma mudança de produto, não de sintaxe — precisa de decisão de UX, não só de patch.

5.4 Autenticação / OAuth

Boa notícia com ressalva. O create_omniauth_registration.rb ficou idempotente (retry em RecordNotUnique, existing_identity || create_identity) — exatamente o caso de duplo clique no callback do gov.br. E os scopes opcionais da API ganharam admin:read/admin:write. Nosso omniauth_govbr.rb não deve quebrar; vale revalidar o fluxo de callback.

5.5 Propostas, encontros e formulários

• Propostas: proposal_form.rb agora decide o corpo conforme rich_text_editor_in_public_views? (plain_locales quando off). Afeta como o texto da proposta é normalizado — e nós temos simplificações de form.
• Encontros: meeting.rb trocou where(decidim_author_id: author) por where(author:) no scope authored_by; meeting_form.rb e os controllers de anexos mudaram.
• Formulários/questionários: question.rb e a query de respostas mudaram — o coração do nosso módulo decidim-module-questionnaires (o mais ativo, 71 commits).

5.6 Content blocks

O 0.33 traz uma migration nova (move_highlighted_content_banner_settings_to_content_block) e mexe em _content_blocks.scss e no title.erb do main_data. Nosso engine reaponta o bloco hero e o extra_home_blocks muta manifests — o ComponentManifest em si está estável, então a técnica sobrevive; o que muda é o conteúdo/migração.

5.7 O fork (o elo mais frágil)

6Matriz de risco

Severidade (quanto dói se quebrar) × confiança (quão certo é que quebra).

7Plano de ação

Um roteiro no formato que o time já usa — Initiative → ciclo de trabalho.

8Como ler isto

Este documento complementa docs/participa-roadmap.html (o app) e docs/participa-gems.html (as gems criadas): aqui o recorte é o futuro — o que o 0.33 muda e onde encosta no que já existe.