req-046: Preparação de Lançamento da Versão v2.9.0 (Changelogs, READMEs e Release Workflow)

Este lote de trabalho (BATCH-046) define as tarefas necessárias para preparar o lançamento oficial da versão v2.9.0 do Conn2Flow Gestor. O escopo abrange a consolidação de todas as novas funcionalidades e correções desenvolvidas desde a v2.8.3 nos changelogs e READMEs (em inglês e português), e a atualização do template de corpo de release no pipeline do GitHub Actions.

1. Atualização dos Changelogs

1.1 Arquivo Alvo: CHANGELOG.md (Inglês)

• Modificação: Adicionar a nova seção para a versão [2.9.0] sob o cabeçalho ## [Unreleased], detalhando as novidades de segurança, testes e editor visual desde a v2.8.3.

  ## [Unreleased]
  ## [2.9.0] - 2026-06-16
  ### Added
  - **Two-Factor Authentication (2FA)**: Native support for TOTP (authenticator apps) and email-based two-factor authentication inside user profiles.
  - **Passwordless OTP Login**: Passwordless email-based authentication via secure one-time password (OTP) codes.
  - **API Keys Management**: Dedicated API keys configuration in environment settings, supporting access profiles and optional 2FA protection.
  - **OAuth Integration Helper**: Interactive step-by-step setup guides for Google, Facebook, Apple, and GitHub OAuth integrations.
  - **Visual HTML Editor Controls**: Advanced visual styler panel (20 formatting groups across Text, Layout, Box, and Appearance sections) and circular color palettes.
  - **Interactive Drag & Drop**: Flashing visual placeholders indicating element drop targets and a ghost follower showing the exact shape of the element being inserted.
  - **Internal Clipboard**: Copier and Paste buttons supporting standard `Ctrl+C` and `Ctrl+V` keyboard shortcuts.
  - **Wrap Tool**: Added the "Embrulhar" (Wrap) element feature, allowing nesting of selected elements inside structural tags (div, section, article, etc.).
  - **Dynamic Widget Skeletons**: Realistic widget placeholders rendered via the `html-editor-widget-render` endpoint to display layout structures in the visual editor.
  - **Manual Curation in publisher-index**: Support for curating and sorting manual lists of publications inside the admin CRUD interface.
  - **Métrica Counters**: Dynamic counters displaying "Showing X of Y publications" on AJAX load in `publisher-index`.
  ### Changed
  - **HTML Editor Styler layout**: Inverted columns to position visual controls on the left and CodeMirror tags on the right, and flippable toolbar positioning when space is tight.
  - **Visual Editor Code Refactoring**: Extracted 26 simulation functions to `html-editor-modules.js` to simplify `html-editor-interface.js`.
  - **Temporal Dead Zone (TDZ) Fixes**: Moved `contentPageTabHandler()` and the Fomantic UI `.tab()` initializations to the end of the `$(document).ready` scope.
  - **Surgical Variables-to-Comments Replacement**: Replaced the destructive `body.innerHTML` write with a text-node-only TreeWalker replacement when parsing `[[widgets#...]]` variables in the visual editor.
  ### Fixed
  - **Unicode Search in publisher-index**: Live search filtering of accent marks and special characters in publication titles.
  - **Duplicate Pagination in publisher-index**: Removed index and duplicate pages from search results.
  - **Widget Special Characters Escape**: Prevented `->` and json variables in `[[widgets#...]]` from escaping to `>` and losing structure on save.
  - **Dynamic Image URL Prefixing**: Automated detection of `image` type fields in `publisher-index` and `publisher-highlights` to dynamically prefix them with `$_GESTOR['url-raiz']`.

1.2 Arquivo Alvo: CHANGELOG-PT-BR.md (Português)

• Modificação: Adicionar a seção equivalente traduzida para o português sob ## [Unreleased].

  ## [Unreleased]
  ## [2.9.0] - 2026-06-16
  ### Added
  - **Autenticação de Dois Fatores (2FA)**: Suporte nativo a 2FA via aplicativos autenticadores (TOTP) e e-mail nos perfis de usuários.
  - **Login Sem Senha via OTP**: Autenticação por e-mail sem necessidade de senha utilizando códigos de uso único (OTP).
  - **Gerenciador de Chaves de API**: Configuração dedicada de chaves de API nas opções de ambiente, com suporte a perfis de acesso e proteção por 2FA.
  - **Guia de Integração OAuth**: Assistente interativo passo a passo para configuração de integrações OAuth com Google, Facebook, Apple e GitHub.
  - **Editor HTML Visual - Painel Styler**: Painel avançado com 20 grupos de formatação (Texto, Layout, Caixa, Aparência) e paletas de cores circulares nativas.
  - **Drag & Drop Interativo**: Placeholders visuais piscantes indicando a posição de encaixe dos elementos e ghost follower indicando o formato do elemento inserido.
  - **Clipboard Interno**: Botões de Copiar e Colar com atalhos de teclado `Ctrl+C` e `Ctrl+V` nativos no editor.
  - **Ferramenta Embrulhar (Wrap)**: Funcionalidade para envelopar o elemento selecionado em tags estruturais (div, section, article, etc.).
  - **Esqueletos de Widgets Dinâmicos**: Renderização realista de widgets via endpoint `html-editor-widget-render` para exibir a estrutura de layouts no editor visual.
  - **Curadoria Manual no publisher-index**: Suporte para curadoria e ordenação manual de publicações na interface administrativa (CRUD).
  - **Contadores de Métricas**: Métricas dinâmicas exibindo "Exibindo X de Y publicações" ao carregar itens por AJAX no `publisher-index`.
  ### Changed
  - **Layout do Styler do Editor**: Colunas invertidas posicionando os controles visuais à esquerda e tags do CodeMirror à direita, com toolbar reposicionável em telas cheias.
  - **Refatoração do Editor Visual**: Extração de 26 funções de simulação para `html-editor-modules.js` para simplificar e modularizar o `html-editor-interface.js`.
  - **Correções de Temporal Dead Zone (TDZ)**: Movimentação do `contentPageTabHandler()` e da inicialização do `.tab()` do Fomantic para o fim do ready do JQuery.
  - **Preservação de Overlays no Editor**: Substituição da reescrita destrutiva de `body.innerHTML` por substituições cirúrgicas em nós de texto (via TreeWalker) ao parsear variáveis `[[widgets#...]]`.
  ### Fixed
  - **Busca Unicode no publisher-index**: Filtro inteligente de termos com acentuação e caracteres especiais nos títulos das publicações.
  - **Paginação de Duplicados no publisher-index**: Remoção de páginas de índice e duplicadas nos resultados da busca.
  - **Escape de Caracteres Especiais em Widgets**: Correção do bug que convertia `->` e aspas das variáveis `[[widgets#...]]` em entidades HTML (`>`), quebrando o renderizador do backend.
  - **Prefixagem Dinâmica de Imagens**: Detecção automática de campos do tipo `image` no `publisher-index` e `publisher-highlights` para adicionar o prefixo de URL raiz do gestor.

2. Atualização dos READMEs

2.1 Arquivo Alvo: README.md (Inglês)

• Modificação: Atualizar a seção ## Latest Version para referenciar a v2.9.0 e os novos destaques do sistema.

  ## Latest Version
  **v2.9.0 (June 16, 2026)**
  **? Key Features & Highlights:**
  - **Advanced Visual HTML Editor**: Floating toolbar, advanced 20-group styler panels, circular color palettes, visual drag-and-drop placeholders with ghost tracking, internal clipboard (Ctrl+C/V), element wrapping (Wrap), and real widget rendering.
  - **Security & Authentication**: Two-factor authentication (2FA via app/email), passwordless email-based OTP login, API Access Key profiles with 2FA gating, and interactive OAuth integration helpers.
  - **Unified Testing Suite**: Out-of-the-box support for PHPUnit, Vitest, and Playwright E2E browser tests with Actions workflow CI/CD.
  - **Publisher Index & Manual Curation**: Live diacritics-insensitive publication search, manual curatorial ordering, dynamic count metrics, and automated dynamic image URL root prefixing.
  - **Code Modularization**: Cleaned up the visual editor scope by externalizing simulation engines to `html-editor-modules.js`.

2.2 Arquivo Alvo: README-PT-BR.md (Português)

• Modificação: Atualizar a seção ## Última Versão com os dados equivalentes traduzidos.

  ## Última Versão
  **v2.9.0 (16 Junho 2026)**
  **? Principais Novidades:**
  - **Editor HTML Visual Avançado**: Toolbar flutuante com painel de estilos (20 grupos de formatação), paletas de cores, D&D com placeholders interativos, clipboard integrado (Copiar/Colar com atalhos Ctrl+C/V), ferramenta Embrulhar (Wrap) e renderizador de widgets AJAX.
  - **Segurança e Autenticação**: Suporte a autenticação de dois fatores (2FA via aplicativo/e-mail), login por e-mail sem senha (OTP), assistente interativo de configuração OAuth e perfis restritos de chaves de API com proteção 2FA.
  - **Suíte de Testes Automatizados**: Integração de testes automatizados (PHPUnit, Vitest, Playwright) rodando localmente e integrados no CI/CD do GitHub Actions.
  - **Publicador Índice e Curadoria Manual**: Curadoria manual com ordenação na listagem, busca inteligente com tratamento de acentuação Unicode, paginação dinâmica com métricas e prefixagem dinâmica da URL raiz em campos de imagem.
  - **Modularização de Código**: Extração das 26 simulações do editor para o arquivo independente `html-editor-modules.js`.

3. Atualização do Workflow de Release

3.1 Arquivo Alvo: .github/workflows/release-gestor.yml

• Modificação: Na etapa Create Release, atualizar o corpo (body) das notas de release para referenciar a Release v2.9.0 e descrever as novas atualizações de autenticação, testes e editor visual.

    - name: Create Release
      id: create_release
      uses: softprops/action-gh-release@v2
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      with:
        tag_name: ${{ steps.tag.outputs.TAG_NAME }}
        name: "Gestor ${{ steps.tag.outputs.TAG_NAME }}"
        make_latest: true
        body: |
          ## ? Conn2Flow Gestor Release v2.9.0 (Editor Visual Avançado + 2FA e Passwordless + Chaves de API + Suíte de Testes + Publicador Índice)
          Esta versão traz uma grande evolução no **Editor HTML Visual** com novas ferramentas de formatação, D&D interativo e clipboard físico, a adição de recursos modernos de **Autenticação e Segurança (2FA e Login Sem Senha OTP)**, gerenciador de **Chaves de API** com perfis, o módulo **Publicador Índice** enriquecido com curadoria manual e busca Unicode, e a integração nativa de uma **Suíte de Testes Automatizados (PHPUnit, Vitest, Playwright)** no pipeline.
          ### ? Novidades Principais desta Versão:
          - ✅ **Editor HTML Visual Avançado**: Painel styler expandido com 20 grupos de formatação, paletas de cores circulares, D&D com placeholders piscantes e ghost follower de cursor, clipboard integrado (Copiar/Colar e atalhos Ctrl+C/V), ferramenta Embrulhar (Wrap) e visualizador real de widgets via AJAX.
          - ✅ **Segurança e 2FA**: Autenticação de Dois Fatores (2FA) nativa via aplicativos autenticadores (TOTP) e e-mail, e login sem senha (OTP) via e-mail direto.
          - ✅ **Gerenciador de Chaves de API**: Geração de chaves de API com perfis de acesso restritos e proteção opcional por 2FA.
          - ✅ **Assistente OAuth**: Guia interativo passo a passo para configuração das chaves de integrações Google, Facebook, Apple e GitHub.
          - ✅ **Publicador Índice Avançado**: Curadoria e ordenação manual de itens, busca inteligente imune a acentuação Unicode, contador dinâmico de métricas de paginação e prefixagem dinâmica de URL raiz em imagens.
          - ✅ **Suíte de Testes Nativa**: Integração de suíte de testes de backend (PHPUnit), frontend (Vitest) e ponta-a-ponta (Playwright) com execuções automáticas no GitHub Actions.
          - ✅ **Refatoração e Modularização**: Migração de 26 funções de simulação do editor para o arquivo independente `html-editor-modules.js`.

5. Verificação de Sucesso para o Executor

1. O executor deve verificar que os arquivos editados não contêm erros de digitação ou formatação markdown corrompida.

2. Não executar comandos de commit, push, tagging ou building (essas tarefas serão tratadas pelo script de release do operador).