Cluster Engine — Autoridade Tópica & Linkagem Interna releasesself-updates

=== Cluster Engine — Autoridade Tópica & Linkagem Interna === Contributors: 61labs Tags: seo, internal links, content clusters, topical authority, aeo, geo, eeat, ai Requires at least: 5.8 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 2.34.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Motor de autoridade tópica para WordPress: clusters de conteúdo, mapa de palavras-chave, diagnóstico SEO/AEO/GEO/E-E-A-T e linkagem interna inteligente. Por 61 Labs (61labs.com.br).

== Description ==

O Cluster Engine lê todo o conteúdo publicado do seu site e o transforma em um grafo semântico:

• Clusters emergentes — os grupos temáticos são detectados a partir do próprio conteúdo (TF-IDF + similaridade de cosseno), com pilar identificado automaticamente e Score de Força do Cluster (0–100) composto por Cobertura, Arquitetura de links, AEO/GEO, E-E-A-T e Higiene.
• Linkagem interna inteligente — oportunidades de link (alta afinidade semântica sem link), links que não fazem sentido (linkados sem relação) e canibalização (posts quase idênticos competindo pela mesma intenção).
• Mapa de palavras-chave — termos e entidades extraídos do site inteiro, com detecção de meta titles e keywords foco duplicados.
• Integração com plugins de SEO — lê e grava direto nos campos do Yoast SEO, Rank Math, All in One SEO e SEOPress (meta title, description e keyword foco). Sem plugin de SEO, usa campos nativos próprios.
• Central de diagnóstico — problemas priorizados por impacto (críticos, on-page, oportunidades AEO/GEO), com botão "Corrigir com IA".
• Hub de IA multi-provedor — Anthropic (Claude), OpenAI (GPT) e Google (Gemini), com biblioteca de prompts editável por ação e variáveis dinâmicas como {{title}}, {{keyword}}, {{site_name}}, {{cluster_name}}, resolvidas em tempo real com dados do WordPress.
• Geração de conteúdo para gaps — gera rascunhos de artigos satélite direto no WordPress (nunca publica sozinho).
• Criação de novos clusters com IA — a IA analisa o conteúdo já publicado, entende o assunto do site e sugere novos clusters coerentes; você também cria clusters manualmente.
• Planejamento e geração de conteúdo por cluster — plano de artigos (pilar + satélites) por cluster, com opção de incrementar o plano, gerar um artigo na hora ou enviar vários para a fila.
• Geração em massa com fila (WP-Cron) — os artigos enfileirados são gerados em segundo plano pelo cron nativo do WordPress, com status, novas tentativas e processamento manual.
• Páginas separadas no admin — Painel (análise), Criação de Conteúdo (clusters novos + fila) e Configurações (IA, prompts e limiares).

Critérios alinhados ao SEO de 2026: answer capsules, headings em formato de pergunta, FAQ, fontes externas, bio de autor (E-E-A-T), conteúdo não-commodity e prontidão para AI Overviews.

== Installation ==

1. Envie a pasta cluster-engine-61labs para /wp-content/plugins/ ou instale o .zip em Plugins → Adicionar novo → Enviar plugin.
2. Ative o plugin.
3. Acesse o menu Cluster Engine e clique em Escanear site.
4. (Opcional) Em Configurações, adicione sua chave de API de IA para habilitar reescritas e geração de conteúdo.

== Frequently Asked Questions ==

= O plugin publica ou altera conteúdo sozinho? = Não. Toda ação de IA passa por aprovação: metas são gravadas apenas quando você escolhe uma opção, e artigos gerados entram como rascunho.

= Preciso de chave de API? = A análise de clusters, keywords, diagnóstico e linkagem funciona 100% sem IA externa. A chave só é necessária para reescritas e geração de conteúdo.

= Funciona com qual plugin de SEO? = Yoast SEO, Rank Math, All in One SEO e SEOPress são detectados automaticamente. Sem nenhum deles, o Cluster Engine usa campos próprios e os entrega no front-end.

== Changelog ==

= 2.34.0 =

• Novo: integração com o relatório de performance do Hub 61 Labs. O Cluster Engine agora entrega uma seção própria ao PDF consolidado do Hub (filtro hub61_report_sections, contrato v2): métricas de Pontuação do site, SEO médio, AEO médio, posts indexados, número de clusters e ações prioritárias de alta severidade; um gráfico de barras com os clusters mais fracos; e tabelas de ações prioritárias e de clusters mais fracos. À prova de site ainda não escaneado — sem dados, a seção sai sem quebrar o relatório.
• Interno: o cálculo do diagnóstico foi extraído para CE61_Ajax::report_data() (retorna o array), reusado pelo endpoint AJAX report e pela integração com o Hub sem duplicar consultas. Comportamento do endpoint inalterado.

= 2.33.0 =

• Novo: Word Counter — análise detalhada de texto. Uma meta box no editor mostra, ao vivo enquanto se digita, métricas que vão além da contagem básica: palavras, caracteres (com e sem espaços), frases, parágrafos, média de palavras por frase, tempo estimado de leitura e de fala, índice de legibilidade (escala Flesch adaptada ao PT-BR, com rótulo de Muito fácil a Muito difícil) e densidade de palavras-chave (top termos, unigramas e bigramas, com contagem e percentual). Ferramenta pensada para copywriters, redatores e profissionais de marketing.
• O Word Counter lê o site e detecta sozinho onde pode aparecer: todos os tipos de conteúdo públicos que suportam o editor — posts, páginas e CPTs personalizados — sem lista fixa. Funciona tanto no editor de blocos (Gutenberg) quanto no clássico.
• Habilitável na aba Configurações (ligado por padrão).
• Correção: a aba Configurações tinha aspas tipográficas (") no lugar de aspas retas nos atributos de HTML do painel Geral, o que quebrava o estilo e impedia salvar as configurações gerais (escopo de post types, limiares e credenciais). Restaurado.

= 2.32.0 =

• Identidade visual: reskin completo alinhado à paleta 61labs — tinta profunda (#0a0c10), verde-sinal (#c6f24e) como cor de destaque/CTA e ciano (#56d4cd) no par de assinatura (anel de score, barras de progresso, aba ativa). Botão primário agora usa o padrão da casa (fundo sinal + texto tinta). Superfície clara mantida para legibilidade no wp-admin, com um teal derivado do ciano garantindo contraste AA em links e textos coloridos. Aplicado ao painel, ao editor, ao grafo de rede e ao relatório de performance exportável.

= 2.31.0 =

• Correção: escopo de indexação agora cobre todos os CPTs públicos também na tela de gestão de tipos de post e ao ativar/desativar um tipo — antes, numa instalação nova (escopo vazio), os CPTs apareciam como desativados mesmo estando indexados, e desativar um único tipo colapsava o escopo apenas para "post".
• Acessibilidade/identidade visual: o CSS do editor (meta box e modais) passou a consumir os tokens de cor canônicos 61labs (--ce-violet-soft, --ce-violet-softer), eliminando os últimos literais de cor divergentes.
• Consistência: ícones de UI residuais que usavam emoji de imagem foram trocados por glifo Unicode (◈), com renderização estável entre sistemas operacionais.

= 2.30.0 =

• Novo: seleção do provedor de IA por modal na página Categorias. Um botão "Trocar provedor" abre um modal onde você escolhe qual provedor (Anthropic, OpenAI, Gemini ou Groq) será usado ao analisar posts, sugerir categorias e gerar SEO — sobrepondo a configuração por tarefa apenas nesta página. Provedores sem chave aparecem desabilitados; a opção "Padrão" mantém o provedor definido em Configurações. A geração de imagem continua usando o provedor da página Imagens.

= 2.29.0 =

• Novo: Organizador de Categorias — nova página com quatro abas para revisar, categorizar, popular de SEO/imagens e redirecionar.
• Novo: organizar posts — a IA lê cada post e sugere a categoria que faz mais sentido. Nada é gravado sem a sua aprovação; ao aplicar, a categoria sugerida vira a primária mantendo as demais (não destrutivo).
• Novo: SEO e imagens por categoria — gere e edite título de SEO, descrição de SEO, descrição nativa e imagem de capa de cada categoria. O SEO é gravado no local que o seu plugin de SEO ativo lê (Yoast, Rank Math, SEOPress) ou em campo nativo próprio.
• Novo: sugestão de novas categorias — a IA analisa o conteúdo do site e propõe categorias que fariam sentido, com criação em um clique.
• Novo: redirects 301 integrados ao Rank Math — página de gestão que lê e grava os mesmos redirects do módulo nativo do Rank Math quando ele está ativo; sem Rank Math, usa armazenamento próprio e resolve os redirects no front-end. Ao recategorizar um post e a URL mudar, um 301 é criado automaticamente.

= 2.28.0 =

• Novo: provedor Groq (Llama/Mixtral, compatível com a API da OpenAI) adicionado às opções de IA — geração de texto, análise e diagnóstico.
• Novo: atuação por tarefa — em Configurações você escolhe qual provedor cuida de cada tipo de tarefa (Geração de texto, Análise, Diagnóstico e Imagens), independentemente do provedor principal. Cada seletor mostra apenas os provedores compatíveis com aquela tarefa; deixar em "Padrão" usa o provedor principal, e o fallback automático continua valendo quando o escolhido não tem chave.
• Melhoria: o seletor de provedor de imagem passa a aparecer também nas Configurações, em sincronia com a página Imagens.

= 2.27.0 =

• Novo: página "Imagens" dedicada que centraliza tudo — geração de destacadas e imagens no conteúdo, conversão WebP, presets, configurações e log de erros — em sub-abas próprias. A aba Imagens saiu do Painel e as configurações de imagem saíram das Configurações gerais.
• Novo: imagens dentro do post (in-content) — gere 1 a 3 imagens otimizadas em WebP com SEO completo (nome de arquivo, alt, título, legenda e descrição) e insira no corpo do artigo na posição que você escolher (início, após o 1º H2 ou no final).
• Novo: conversão para WebP das imagens dos artigos (destacadas e anexos) mantendo sempre o original — operação reversível — com repontamento automático de imagem destacada e URLs no conteúdo. Conversão avulsa ou em massa pela Fila.
• Novo: imagem de referência na geração (image-to-image) via Biblioteca de Mídia, upload por arraste ou seleção de arquivo — suportada em OpenAI (edits) e Gemini (inlineData).
• Novo: prompt de otimização por geração para sobrescrever o prompt mestre quando quiser.
• Novo: biblioteca de presets de imagem, alimentada por você ao gerar, para manter a mesma linha editorial e reaplicar modelos com um clique.
• Novo: otimização WebP configurável (ligar/desligar e qualidade 40–100) aplicada às imagens geradas e enviadas pelo plugin.

= 2.26.0 =

• Novo: filtro por status na página de Schema — "Somente com pendências" (padrão), "Todas as páginas" ou "Somente completas", para focar direto nas páginas que precisam de correção.
• Melhoria: após corrigir o schema de uma página (Article, FAQ, reparo ou remoção), a página é re-auditada e sai automaticamente da lista de pendências — o status é atualizado na hora.
• Melhoria: contador dinâmico mostrando quantas páginas correspondem ao filtro/busca atuais.

= 2.25.0 =

• Novo: a página de Schema agora mostra o slug de cada página (com link para abrir a URL).
• Novo: campo de busca na página de Schema, filtrando por título, slug e URL.
• Novo: botões de ordenação no cabeçalho da tabela (Página, Slug, Schema encontrado, Pendências) — clique para alternar entre crescente e decrescente.

= 2.24.0 =

• Correção importante: sem Rank Math, o schema JSON-LD deixava de ser injetado como texto no corpo do post. Agora ele é gravado em um campo personalizado do Cluster Engine (_ce61_schema) e impresso como `