BATCH-255 — Consolidação e documentação da Fase B

Requisição: REQ-246. Data: 2026-10-06. Status: complete. Autonomia: autonomo_monitorado.

• [x] Árvores inicialmente limpas; checkout main, pull e fetch nos dois repositórios.

• [x] Integração até 84deb54a, conforme resposta humana posterior: configurações de 515c764c permanecem para REQ-247.

• [x] PHPUnit e Vitest completos: 1.672 / 573 testes, zero falhas.

• [x] Auditoria inicial: 245 itens com avisos, 277 avisos, zero erros; legado zero.

• [x] Documentação bilíngue, extração de bibliotecas e compilação do site.

• [x] Pipeline local e evidência HTTP/SQL.

• [x] Arquivamento SDD e integridade de links.

• [x] Revisão final.

• [x] Commit e push main.

Coordenação

Site: conn2flow-site em [REDACTED] REQ-110 / BATCH-104. Integração pronta inclui as cinco frentes e a correção posterior do widget. MCP Hub indisponível nesta sessão; execução pela CLI oficial.

Evidências e limites

A publicação usa ai-workspace/pt-br/docs/ e ai-workspace/en/docs/ como fontes canônicas. Não há uma segunda árvore de autoria em docs/: o site recebe páginas, publicações, menus e llms.txt por docs:build e pelo pipeline SQL. Nenhuma aprovação de teste herdada foi contabilizada como execução deste lote.

Integração e suítes

Main consolidada inicialmente no Core 914c7b10 e no Site 93fd51d1. Core incorpora 243/245/244 e a correção de precedência até 84deb54a; Site incorpora 108/109 e a7192e75. Origin/main recebeu depois f53e0a67 e 27c185dc, incluindo a seção 5.6 e reserva da REQ-247. Antes de chegar a resposta humana, 515c764c foi incorporado localmente; o humano confirmou expressamente manter a Fase B até 84deb54a. O revert aaa93145 retirou essa funcionalidade, preservando a branch e o histórico. A decisão humana prevalece sobre a seção 5.6. As atualizações posteriores de coordenação foram incorporadas em 9eedac94 (Core) e d3435803 (Site); REQ-247 permanece implementada na sua branch, aguardando revisão e homologação, fora deste lote.

As quatro suítes foram executadas neste lote. Core PHPUnit: 1.672 testes, 17.532 asserções, zero falhas/erros, quatro skips, quatro deprecações e três deprecações PHPUnit. Vitest do recorte confirmado: 49 arquivos, 573 testes. A rodada transitória com 515c764c também passou (578), mas não representa o estado final. Site PHPUnit: 53 testes, 2.403 asserções; Vitest: dois arquivos, 13 testes. Comandos e resultados. PHP executado sob Linux na VM, com os arquivos do workspace montados; Core executou literalmente o script composer test, invocando o composer.phar disponível. Site não possui composer.json e usa o runner compartilhado com req238-phpunit.xml. Npm usa npm.cmd porque a política PowerShell bloqueia npm.ps1. Avisos ECONNREFUSED/AbortError do happy-dom não causaram falha.

Cobertura da documentação

Inventário: 36 requisições recentes, Core 219–245 e nove arquivos existentes do Site 100–109. REQ-104 do Site não existe com esse número no acervo pesquisado. Contratos documentados seguem o código integrado, inclusive onde diferem dos planos iniciais.

docs:extract --all atualizou 24 referências existentes. Criadas e preenchidas cinco bibliotecas em pt-br/en: atualizacoes-automatica (17 funções), controles (9), db-data (15), admin-topbar (7) e interface-listar-tailwind (2). HTML Editor explica retorno HTML/CSS, módulos JS e widgets; gestor/interface/arquivo recebem os contratos correlatos. Blocos automáticos continuam sob responsabilidade do extrator.

Nos treze módulos admin-arquivos, galleries, forms, forms-search, forms-submissions, menus, cookie-consent, variables, admin-categorias, publisher, publisher-index, publisher-highlights e pages-index, a seção nova de interface foi conferida no código; o texto técnico herdado foi mantido, não conferido integralmente. Seu verified_at anterior foi preservado. Não houve atualização indiscriminada de hashes para ocultar drift.

Auditoria e limites

Auditoria inicial, antes da extração: 245 itens com desvios, 277 avisos, zero erros, 44 documentos limpos; legado zero. O snapshot intermediário após a criação de esqueletos contém quatro erros transitórios de descrição, corrigidos durante a redação. Auditoria final estrita: 228 avisos em 228 itens, 68 limpos, zero erros e legado zero. São 224 avisos de fontes alteradas desde verified_at e quatro lacunas de bibliotecas: cookie-consent, manutencao, modulo-distribuido-protocolo e paginas-layouts-perfis. Permanecem visíveis para a próxima passagem; o conteúdo relacionado aos contratos desta Fase B está atualizado.

Atualização real pela tarefa automática com sucesso e rollback continua uma limitação herdada do BATCH-254: o Lab está na última versão. Esta consolidação não declara ter exercitado esse cenário. PHP skips/deprecações e falha pré-existente de minificação admin-categorias.js também permanecem registrados.

Higiene e revisão

ai:archive-sdd --keep=10 --repair-links no Core e com --repo no Site, pela CLI do Core. Core: nove arquivos arquivados e 14 links reparados. Site: dois lotes arquivados, 160 links antigos reparados, mais três links de índice. Sete referências históricas apontavam para nomes de documentos planejados inexistentes; mantidos seus rótulos como texto, explicitando a ausência. Gate posterior sem links órfãos; dez lotes na raiz de cada repositório. Nenhuma especificação normativa alterada.

Checkout CRLF normalizado para LF antes da compilação; seleção do commit usa diff sem diferenças de fim de linha e caminhos explícitos. O roteiro de precedência ganhou C2F_OUTPUT para preservar evidências antigas. O merge adicional gerou oito conflitos exclusivamente em Data.json, CSS pré-compilado e manifesto; fontes integradas preservadas e derivados recompilados pela CLI (quatro recursos novos, 507 em cache).

As configurações por widget de 515c764c foram retiradas da documentação desta Fase B, em obediência ao recorte humano; a branch de origem e o trabalho separado da REQ-247 permanecem preservados.

Primeiro pipeline encerrou com saída 0 e 778 arquivos conferidos por hash. Uma publicação externa posterior de 515c764c com acervo antigo desativou as páginas novas. O navegador detectou a manutenção e, depois, conteúdo desatualizado (2/36); evidência da concorrência. A rodada final republicou código integrado e acervo atualizado. Três arquivos gerados estavam mapeados por outro processo no Windows, impedindo truncamento; substituição atômica local liberou sua regeneração.

Publicação e navegador finais

Pipeline oficial completo com saída 0 e manutenção desligada. Acervo: 747 páginas, 732 publicações e cinco landings; SQL confirma 148 páginas ativas en e 599 pt-br, incluindo SDD. Fotografias antes e depois mostram conteúdo regenerado e os novos guias/bibliotecas ativos, sem user_modified nas amostras. O Dashboard publicado tem SHA-256 e6a234981ff63201776444fecd3366cbb4d7dc63e485d7bcf8e6ab7e8f0c4c66, igual ao código local confirmado. css:rebuild: sete analisados, dois regenerados, cinco coerentes, zero erros.

A conferência por hash encontrou somente a migração adicional 20261006200000_create_dashboard_layouts_table.php deixada pela publicação externa da REQ-247. Preservada conforme a seção 5.7 da requisição: tabela e operações sem uso não habilitam a funcionalidade excluída. Assets continuam em arquivo-estatico porque o projeto não declara ssh_public_path. Avisos de minificação e de concatenação responsiva herdados permanecem explícitos. O docs:build não encontrou frontmatter inválido ou links quebrados; avisos de filtragem de conteúdo sensível histórico são esperados e não foram ocultados.

Regressões executadas no Lab: REQ-243 158/158, REQ-245 19/19, precedência da apresentação 24/24, incluindo os oito slides e comparação com a página pública. Evidências em REQ-243, REQ-245 e precedência. Preferências e configuração usadas pelos roteiros foram restauradas.

As referências tinham rolagem lateral no mobile por links longos de arquivos-fonte no rodapé; break-all foi acrescentado ao SOURCE_LINK do gerador DocsTheme e os recursos foram recompilados pelo pipeline. Primeira rodada publicada registra a falha anterior, incluindo o marcador ausente na referência de controles. A referência foi completada com observarSelects, clonagem, formatado e máscaras. Rodada final: 36/36 verificações de conteúdo, HTTP, largura e console, nos dois idiomas e em 1280/390 px; imagens desktop/mobile inspecionadas.

Fechamento: revisão sem achado bloqueante; 742 links HTTP conferidos, zero quebrados. Build determinístico, integridade SDD e publicação Git conferidos na entrega. REQ-247 permanece separada, aguardando revisão/homologação.