Requisição 184 — Publicação do SDD do Core no Site e Dono do Pipeline das Docs (FEAT-014, fase 2, onda 6)

Origem: Humano, 2026-09-25 (publicar o sdd/ do core como mais um publisher, só o core, nunca projetos privados) e 2026-09-26 (uma requisição por onda, cada uma para um agente em outra infraestrutura). Ondas irmãs: req-182 (onda 4) e req-183 (onda 5). Lote Vinculado: BATCH-188. Status: approved. Autonomia: Nível 2. Commit e push autorizados pelo Humano. Deploy só no Lab local ([REDACTED], local: true em dev-environment/data/environment.json). Nunca produção: o Humano publica depois de revisar o [REDACTED]. Leitura obrigatória antes de começar:

• skill c2f-documentation e skill c2f-project-pipeline-and-tasks;

• req-178.md (o docs:build e o contrato com o site) e req-179.md (§3, onda 6);

• cli/src/Support/Docs/DocsBuilder.php, DocsTree.php, MarkdownRenderer.php, cli/src/Commands/DocsBuildCommand.php e os testes tests/Unit/PHP/DocsBuildReq178Test.php;

• no repositório conn2flow-site (branch feat/req-055): gestor/docs.config.json, gestor/resources/pt-br/publisher.json, publisher-index.json, os templates docs-article e docs-sidebar, e sdd/implementation/documentacao/batch-050-documentacao-online-docs.md.

1. Escopo

1. Modo de fonte SDD no c2f docs:build: publicar os artefatos de sdd/ do core (README, processo, SPEC e documentos numerados, decisões, batches e requisições correntes; não o archive/, não backlog/, não as memórias) num novo publisher docs-sdd do site, com página de entrada, menu próprio (ou grupo "SDD" no menu das docs) e entrada no llms.txt.

2. Filtro de conteúdo sensível antes de publicar, com testes PHPUnit: hosts e IPs reais, e-mails pessoais, credenciais e tokens, caminhos de servidor ([REDACTED], [REDACTED]), aliases de SSH, nomes de projetos privados. Um arquivo que o filtro não conseguir limpar com segurança fica fora, com aviso no relatório do build.

3. Os artefatos do SDD não seguem o frontmatter das docs: derive título, descrição e ordem do conteúdo (primeiro #, primeiro parágrafo, número do arquivo).

4. Dono do pipeline das docs: quando as ondas 4 e 5 (req-182, req-183) publicarem novas docs, você as publica no Lab:

   • php cli/c2f.php docs:build --project=[REDACTED] e depois php cli/c2f.php project:update-all [REDACTED], um de cada vez, em primeiro plano, nunca em paralelo;

   • só comece depois que o BATCH-184 estiver complete no BATCH-INDEX.md (o agente da req-179 ainda pode estar rodando o pipeline);

   • confira com c2f page:inspect (0 erros de console) e commite os recursos gerados no conn2flow-site com caminhos explícitos.

2. Regras de convivência (obrigatórias)

1. Só edite cli/src/Support/Docs/, cli/src/Commands/DocsBuildCommand.php, os testes das docs, os recursos das docs no conn2flow-site (gestor/docs.config.json, gestor/resources/*/{publisher,publisher-index}.json, templates docs-*, recursos gerados) e sdd/implementation/BATCH-188.md. Não edite as docs de ai-workspace/ (são das outras ondas), exceto guides/documentation.md para documentar o modo SDD. Os índices (BATCH-INDEX.md, CURRENT.md, VALIDATION-CHECKLIST.md) são do agente da req-179.

2. Git: git fetch e git rev-list --count HEAD..origin/main antes de cada push; git add só com os seus caminhos (nunca -A nem .); commits com feat(docs): ... (BATCH-188 / req-184) e a linha Co-Authored-By.

3. Heredoc do Git Bash corrompe barras invertidas e aspas. Use Write/Edit ou um script salvo em arquivo.

4. Antes de mexer no builder, leia as armadilhas já resolvidas na memória sdd/MEMORIA-ENGENHARIA-EXECUCAO.md (entradas FEAT-014): @[[…]]@ precisa ser escapado como @; o Tailwind v4 lê o HTML cru; classes usadas só no menu precisam ir para a página pelo mockup do widget (DocsBuilder::withMenuMockup()).

3. Critério de aceite

1. docs:build --dry-run mostra o publisher docs-sdd com as páginas esperadas e o relatório do filtro.

2. Testes PHPUnit do filtro e do modo SDD passando, e a suíte das docs verde.

3. Lab republicado; /docs/sdd/ (ou o caminho escolhido e registrado) abre sem erros de console; nenhum dado sensível nas páginas geradas (conferência por grep no HTML gerado, registrada no batch).

4. BATCH-188.md com o desenho, os commits e a evidência; lista de testes manuais para o Humano.