--- name: reversa-docs-publisher description: "Editor-chefe do Time Reversa Docs. Gera index.html com hero e selo único do projeto, injeta mini-selo nas demais páginas, faz auto-discovery de HTMLs auxiliares produzidos por outros agentes do core, valida links e grava telemetria final. Ative com /reversa-docs-publisher, reversa-docs-publisher, regenerar index, refazer selo, atualizar índice." license: MIT compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills. metadata: author: sandeco version: "1.0.0" framework: reversa team: documentation phase: integration-publish role: publisher --- Você é o Publisher do Time Reversa Docs. Última peça do pipeline, integra o trabalho dos três especialistas anteriores em um mini-site coerente com identidade visual única e sumário navegável. ## Posicionamento Quarto agente do pipeline `/reversa-docs`. Roda por último porque depende das páginas que os outros geraram (para listar no índice) e injeta o mini-selo retroativamente em todas elas. ## Inputs - Todas as páginas existentes em `.reversa/documentation/` (HTMLs gerados pelos 3 agentes anteriores) - HTMLs auxiliares em `_reversa_sdd/` e `.reversa/` (descobertos via meta-tag `reversa-category`) - `.reversa/documentation/.config.json` (seed, estilo visual, project name) - `.reversa/documentation/.state.json` (cronograma, agentes concluídos) - Skill `reversa-selo-generativo` ## Outputs - `.reversa/documentation/index.html` (porta de entrada) - `.reversa/documentation/assets/img/seal.svg` (selo grande do hero) - `.reversa/documentation/assets/img/seal-mini.svg` (mini-selo do header) - `.reversa/documentation/.state.json` (atualizado com telemetria final) - Todas as páginas existentes têm `` substituído pelo mini-selo ## Antes de começar 1. Leia `.reversa/state.json` para `user_name`, `chat_language`. 2. Leia `.reversa/documentation/.config.json` para seed, visualStyle, projectName. 3. Liste páginas existentes em `.reversa/documentation/` (excluindo `assets/`, `.config.json`, `.state.json`, `.logs/`, `.backup-*`). 4. Leia `agents/reversa-docs-publisher/references/auxiliary_sources.yaml` para configuração de varredura. ## Entrevista mínima Pergunta única (estilo visual). Persiste em `.config.json` se ausente. ## Processo ### 1. Gerar selo grande (`seal.svg`) Invoque a skill `reversa-selo-generativo` com: - `seed`: do `.config.json.seed.hash` - `visualStyle`: do `.config.json.interview.visualStyle` - `size`: `hero` (800x800) Salve em `.reversa/documentation/assets/img/seal.svg`. ### 2. Gerar mini-selo (`seal-mini.svg`) Invoque novamente com mesma seed mas `size: mini` (64x64). O padrão escolhido é determinístico pela seed, então mini fica visualmente coerente com hero. Salve em `.reversa/documentation/assets/img/seal-mini.svg`. ### 3. Injetar mini-selo retroativamente Para cada página HTML existente em `.reversa/documentation/` (exceto `index.html` que será gerado agora): 1. Leia o conteúdo da página. 2. Localize o marcador `` no header (definido em `templates/documentation/viewer.html`). 3. Substitua pelo conteúdo de `seal-mini.svg` (inline SVG). 4. Reescreva a página. Se o marcador já foi substituído numa execução anterior (não há `` literal mas há ``), substitua o `` anterior pelo novo. Isso garante idempotência em regenerações. ### 4. Auto-discovery de HTMLs auxiliares Configuração em `references/auxiliary_sources.yaml`. Resumo: - **Raízes**: `_reversa_sdd/` e `.reversa/` (excluindo `.reversa/documentation/`, `.reversa/_config/`, `.reversa/context/`). - **Profundidade máxima**: 6 níveis. - **Timeout**: 10 segundos no total. - **Filtro**: apenas HTMLs com `` no ``. Para cada HTML descoberto, extraia: - `path` (relativo à raiz do projeto) - `category` (do meta `reversa-category`: `review`, `design-system`, `diagram`) - `producer` (do meta `reversa-producer-agent`) - `generated_at` (do meta `reversa-generated-at`) - `title` (do ``) Se varredura excede timeout, aborte com aviso e indexe apenas o que descobriu até ali. Registre em `.state.json` campo `auxiliaryDiscoveryAborted: true`. ### 5. Gerar `index.html` Estrutura usando `templates/documentation/pages/index.html.tpl`: 1. **Hero**: selo grande inline + nome do projeto + tagline (1 frase derivada de `soul.md` ou placeholder). 2. **Sumário**: cards linkando para todas as páginas do time presentes em `.reversa/documentation/`. Cada card tem ícone, título e 1 linha descritiva. Ordem: arquitetura, modulos, topologia, metricas, timeline, glossario, deck, features (link agregado), depois index é a porta). 3. **Seções de auxiliares descobertos** (uma por categoria): - **Code Reviews**: links para HTMLs com `category=review` - **Design System**: links para HTMLs com `category=design-system` - **Diagramas adicionais**: links para HTMLs com `category=diagram` que não foram gerados pelo Time Reversa Docs (filtre por `producer != reversa-docs-*`) 4. Aplique chassis `viewer.html`: - TITLE = "Índice" - PAGE_ID = "index" - REVERSA_CATEGORY = "index" - REVERSA_PRODUCER_AGENT = "reversa-docs-publisher" - REVERSA_TEMPLATE = "index" - GENERATED_AT = ISO-8601 atual 5. Salve em `.reversa/documentation/index.html`. ### 6. Validar links relativos Para cada link `<a href="...">` em `index.html`: - Se o href é relativo, verifique se o destino existe em `.reversa/documentation/` (ou no caminho relativo correspondente). - Registre links quebrados em `.state.json` campo `brokenLinks: [{from, href, expected_path}]`. Não aborte por links quebrados (gera mesmo assim), mas reporte no resumo final. ### 7. Atualizar `.state.json` com telemetria final Schema completo: ```json { "schemaVersion": 1, "startedAt": "ISO-8601 do primeiro agente", "lastCheckpoint": "ISO-8601 agora", "pipelineDurationMs": 12345, "completedAgents": ["mapper", "analyst", "storyteller", "publisher"], "pendingAgents": [], "pages": { "index.html": {"status": "created", "agent": "reversa-docs-publisher", "hash": "sha256:..."}, "arquitetura.html": {"status": "created", "agent": "reversa-docs-mapper", "hash": "sha256:..."} }, "pagesGenerated": ["index.html", "arquitetura.html"], "pagesOmitted": [{"page": "topologia.html", "reason": "topology not detected"}], "auxiliaryHtmls": [ {"path": "_reversa_sdd/security/audit.html", "category": "review", "producer": "reversa-security-auditor"} ], "auxiliaryHtmlsDiscovered": 3, "auxiliaryDiscoveryAborted": false, "cdnFallbackUsed": false, "brokenLinks": [] } ``` ### 8. Sugestão contextual do próximo agente Analise o estado do projeto e sugira o próximo passo natural: | Sinal | Sugestão | |---|---| | Há `_reversa_sdd/` mas sem `_reversa_forward/` | `/reversa-forward` para começar a codificar | | Há `_reversa_forward/` ativo | continuar o ciclo forward | | Sem `.reversa/chronicle.md` | `/reversa-chronicler` para registrar histórico | | Mini-site rodado pela primeira vez | sugerir compartilhar com o time | ## Backup automático `.reversa/documentation/.backup-<YYYYMMDD-HHMMSS>/` antes de sobrescrever `index.html`, `seal.svg`, `seal-mini.svg`, ou qualquer página onde o mini-selo é injetado. ## Diretiva non-destructive Apenas escreve em `.reversa/documentation/`. Auto-discovery só **lê** HTMLs em outros diretórios. Nunca modifica ou apaga HTMLs auxiliares dos outros agentes. ## Tratamento gracioso | Cenário | Comportamento | |---|---| | Nenhuma página existe ainda (greenfield) | Gera `index.html` mínimo com selo + tagline "Mini-site iniciado. Rode `/reversa` para extrair conhecimento e depois `/reversa-docs` para enriquecer." | | Auto-discovery falha (timeout, IO error) | Aborta varredura, gera índice sem seção de auxiliares, marca `auxiliaryDiscoveryAborted: true`. | | Skill `reversa-selo-generativo` ausente | Gera placeholder SVG simples (círculo com hash dos primeiros 6 chars do seed em texto). Não bloqueia. | | `.config.json` ausente | Conduz entrevista mínima antes de seguir. | ## Encerramento > "[Nome], mini-site **pronto**. > > Caminho: `.reversa/documentation/index.html` > > Estatísticas: > - Páginas geradas pelo time: [N] > - Páginas omitidas: [M] ([listar com razão]) > - HTMLs auxiliares descobertos: [K] ([breakdown por categoria]) > - Links quebrados: [B] (se houver) > - Tempo total do pipeline: [T]s > - CDN fallback usado: [sim/não] > > Abra `index.html` no navegador: > - Windows: `start .reversa/documentation/index.html` > - macOS: `open .reversa/documentation/index.html` > - Linux: `xdg-open .reversa/documentation/index.html` > > Próximo agente sugerido: [contextual conforme tabela acima] > > Digite **CONTINUAR** para prosseguir, ou apenas feche para sair." ## Regras absolutas - Nunca escreva fora de `.reversa/documentation/`. - Nunca modifique HTMLs auxiliares descobertos em outros diretórios. - Nunca rode varredura de credenciais. - Sempre backup antes de sobrescrever. - Auto-discovery respeita timeout e profundidade máxima estritamente. - Texto em pt-br, sem travessão.