senado-br-mcp 3.18.5 → 3.20.0

package/README.md

@@ -565,7 +565,7 @@ Fields of the `concise` block (contract v1.3 since 3.18.5; per response — one
 | `citation` | Ready-to-use citation string (human-readable) |
 | `license` | Source terms (Dados Abertos do Senado Federal) |
 | `field_sources` | *Optional.* Per-field sub-sources, each with its own extraction instant — only on responses that merge reads (v1.2, since 3.17.0; see below) |
-| `derived` / `derivation_note` | *Optional.* `true` + a fixed note when the server computed the values — the `estatisticas` modes (distribution, aggregates, rankings) of `senado_remuneracoes_servidores`, `senado_horas_extras`, `senado_ceaps`, `senado_execucao_orcamentaria` and `senado_suprimento_fundos`; the individual values they cite remain the Senate's own |
+| `derived` / `derivation_note` | *Optional.* `true` + a fixed pt-BR note naming the calculation whenever the server computed values instead of copying them (since 3.19.0, the whole class): the `estatisticas` modes (distribution, aggregates, rankings); group sums, counts and averages — CEAPS `valorTotal` and its per-senator/type/month/supplier modes, the budget execution aggregates (`por-ano`, the default, included), the payroll `resumo`, the overtime `valorTotal`, the `relatoria` distribution, seated senators per party/UF, the historical e-Cidadania national totals; the payroll gross (`bruto`, sum of seven components); servants assigned to an org subtree (`subordinadasA`); a vote tally counted from nominal votes when the source publishes none (plenary open roll calls, committee votes without totals); e-Cidadania percentages, consensus/polarisation rankings and the estimated idea creation date; the current legislature's period. Absent when every number is the source's own (raw lists, `detalhe` of the budget, published tallies). The individual values cited remain the Senate's |
 | `revision` | Whether the figure may still change at the source: `status` is `current` for every Senate source (the version in force at extraction; none is claimed `final`), and `note` says, for the administrative and budget sources, that the Senate may correct published data later |
 
 No Senate source publishes notices alongside the data, so `notices` (also part of v1.3) does not appear. The text footer gains a line only for exceptions — here, the computed-values line on the `estatisticas` modes.
@@ -688,7 +688,7 @@ The frozen NDJSON is **not** committed (built from the sovereign D1 corpus on de
 | `senado_ecidadania_obter_consulta` | Detalhe de uma consulta: votos, autor, relator, comentários |
 | `senado_ecidadania_consultas_analise` | Analisa o conjunto completo de consultas **abertas** via `modo` (consenso/polarizada); `status` padrão `aberta` |
 | `senado_ecidadania_listar_ideias` | Ideias legislativas de cidadãos; ranking das mais apoiadas via `ordenarPor: apoios` |
-| `senado_ecidadania_obter_ideia` | Detalhe de uma ideia: texto, apoios, status de conversão em projeto |
+| `senado_ecidadania_obter_ideia` | Detalhe de uma ideia: texto, apoios, data em que foi proposta, linha do tempo (meta, Sugestão, decisão da CDH, encerramento) e proposições em que virou |
 | `senado_ecidadania_listar_eventos` | Eventos interativos (audiências, sabatinas, lives); ranking dos mais comentados via `ordenarPor` |
 | `senado_ecidadania_obter_evento` | Detalhe de um evento: pauta, convidados, link de vídeo |
 | `senado_ecidadania_sugerir_tema_enquete` | Sugere temas para enquete mensal a partir de critérios configuráveis |

package/dist/dataset/schema.js

@@ -167,8 +167,8 @@ const ideiasSchema = {
             type: "string",
             description: "Título da ideia legislativa.",
             sourceEndpoint: EP_IDEIAS_LISTING,
-            sourceField: "article.resumo-ideia > section > a (texto da âncora)",
-            operationalization: "Texto da âncora da seção, com entidades HTML decodificadas.",
+            sourceField: "li.resumo-ideia > a > h4 (até 11/10/2026: article.resumo-ideia > section > a)",
+            operationalization: "Texto do <h4> do bloco (antes de 12/10/2026, da âncora da seção), com entidades HTML decodificadas.",
         },
         {
             name: "apoios",
@@ -176,8 +176,8 @@ const ideiasSchema = {
             unit: "apoios",
             description: "Número de apoios recebidos pela ideia.",
             sourceEndpoint: EP_IDEIAS_LISTING,
-            sourceField: "article.resumo-ideia > figure.grafico-ideia-legislativa > footer > span[1] (\"N apoios\")",
-            operationalization: "Primeiro <span> do footer do figure.grafico-ideia-legislativa (\"253.804 apoios\"); número BR via parseBrNum. O span de meta (limiar) é ignorado.",
+            sourceField: "li.resumo-ideia > a > figure.componente-grafico-ideia > figcaption > span.contabilizacao (\"N apoios confirmados\"; até 11/10/2026: article.resumo-ideia > figure.grafico-ideia-legislativa > footer > span[1])",
+            operationalization: "Número do span.contabilizacao (\"253.804 apoios confirmados\"; antes de 12/10/2026, primeiro <span> do footer do figure.grafico-ideia-legislativa); número BR via parseBrNum. O span de meta (\"Meta de 20.000 apoios\") é ignorado.",
         },
         {
             name: "status",
@@ -185,7 +185,7 @@ const ideiasSchema = {
             description: "Situação da ideia: \"aberta\" | \"encerrada\" | \"convertida\" | \"removida\" (retirada do portal; demais campos = último estado conhecido).",
             sourceEndpoint: EP_IDEIAS_LISTING,
             sourceField: "(derivado) parâmetro GET situacao da listagem varrida",
-            operationalization: "A listagem é varrida por situacao=N; o status é o mapa SITUACAO_STATUS ({5,6,8}→aberta, {7,9}→encerrada, 10→convertida) do valor usado no crawl. Ideia que sai das listas vivas tem a página de detalhe lida e recebe o status do texto de situação (mesmo mapa); \"removida\" quando o detalhe responde HTTP 410 (desde 06/10/2026).",
+            operationalization: "A listagem é varrida por situacao=N; o status é o mapa SITUACAO_STATUS ({5,6,8}→aberta, {7,9}→encerrada, 10→convertida) do valor usado no crawl. Ideia que sai das listas vivas tem a página de detalhe lida: até 12/10/2026 recebia o status do texto de situação (mesmo mapa); a página redesenhada não publica mais a situação, e desde a 3.20.0 o status vem da categoria da listagem quando a ideia aparece na fatia da situacao 7 da mesma rodada e, senão, é classificado pela linha do tempo do detalhe (regra que reproduz a categoria do portal em 335 de 336 ideias medidas em 17/10/2026). \"removida\" quando o detalhe responde HTTP 410 (desde 06/10/2026).",
             derived: true,
         },
         {
@@ -193,7 +193,7 @@ const ideiasSchema = {
             type: "date",
             description: "Data limite para atingir os 20.000 apoios (única âncora temporal upstream da ideia). NÃO é a data de criação: o nome é histórico, mantido pela compatibilidade do esquema.",
             sourceEndpoint: EP_IDEIAS_DETALHE,
-            sourceField: "página de detalhe: bloco \"Data limite para receber 20.000 apoios\" (DD/MM/AAAA)",
+            sourceField: "página de detalhe: até 12/10/2026 o bloco \"Data limite para receber 20.000 apoios\"; depois, a linha do tempo \"Essa ideia pode receber apoios até DD/MM/AAAA\"",
             operationalization: "extractDate sobre a data-limite exibida no detalhe (visualizacaoideia) → ISO YYYY-MM-DD; lido no crawl de detalhe. Reaberto na v2 (era null por design na v1). Data provável de criação = esta data − 120 dias (regra dos 4 meses do portal; medida exata em 4 ideias convertidas de 2017-2020 contra a base de Pereira, UFPE 2024) — derivação do leitor, não variável do dataset.",
             caveat: "Em ideia aberta esta data está no futuro (é o fim do prazo de apoios). Detail-only (v2): null nas ideias ainda não enriquecidas pelo backfill de detalhe (censura à esquerda residual nesses campos até o backfill completar).",
         },
@@ -202,7 +202,7 @@ const ideiasSchema = {
             type: "string",
             description: "UF do cidadão autor da ideia (SEM nome — conteúdo de cidadão).",
             sourceEndpoint: EP_IDEIAS_DETALHE,
-            sourceField: "página de detalhe: \"Ideia proposta por … (UF)\" — apenas o \"(UF)\"",
+            sourceField: "página de detalhe: \"Ideia proposta por … (UF)\" (na linha do tempo desde 12/10/2026) — apenas o \"(UF)\"",
             operationalization: "Extrai só a sigla de UF entre parênteses; o NOME do cidadão é descartado NA ORIGEM (nunca gravado no corpus). Postura de privacidade: conteúdo de cidadão → só UF.",
             caveat: "Detail-only (v2): null nas ideias ainda não enriquecidas. Nome do autor deliberadamente não coletado.",
         },
@@ -220,8 +220,8 @@ const ideiasSchema = {
             type: "string",
             description: "Proposição gerada pela ideia (ex.: \"SUG 12/2024\"), quando convertida.",
             sourceEndpoint: EP_IDEIAS_DETALHE,
-            sourceField: "página de detalhe: identificação da proposição (SUG/PL nº)",
-            operationalization: "Regex de identificação de proposição no detalhe; null quando a ideia não gerou proposição.",
+            sourceField: "página de detalhe: identificação da proposição (SUG/PL nº); desde a 3.20.0, o acontecimento \"Essa ideia gerou a Sugestão nº N, de AAAA\" da linha do tempo",
+            operationalization: "Até a 3.19: regex de identificação de proposição no detalhe. Desde a 3.20.0 (página redesenhada): a Sugestão gerada, \"SUG N/AAAA\"; as proposições em que a ideia virou (pela CDH ou adotada por parlamentar) saem só no detalhe ao vivo (senado_ecidadania_obter_ideia). Leitura sem Sugestão não apaga valor já gravado.",
             caveat: "Detail-only (v2): null nas ideias ainda não enriquecidas ou não convertidas.",
         },
         {

package/dist/scraper/ecidadania.js

@@ -13,6 +13,8 @@ import { UpstreamError as PkgUpstreamError } from "@sbissoli/mcp-upstream";
 import { UPSTREAM_TIMEOUT_MS } from "../types.js";
 import { USER_AGENT } from "../version.js";
 import { CorpoForaDoPrazoError, PrazoDoCorpo, upstreamCall } from "../throttle/upstream.js";
+import { lerBrNum, mesclarCampo } from "./mesclar.js";
+import { lerIdeiaDetalhe } from "./ideia-detalhe.js";
 export const ECIDADANIA_BASE = "https://www12.senado.leg.br/ecidadania";
 /**
  * Error carrying a `retryable` flag, mirroring UpstreamError so the tool layer
@@ -123,7 +125,7 @@ async function idaEcidadania(path, headers, rotulo) {
         throw e;
     }
 }
-/** Parse Brazilian number: 1.234.567 -> 1234567 */
+/** Parse Brazilian number: 1.234.567 -> 1234567. Ausente/lixo → 0: NÃO use em escritor do corpus (ver `lerBrNum`). */
 export function parseBrNum(s) {
     return parseInt(s.replace(/\./g, ""), 10) || 0;
 }
@@ -206,21 +208,34 @@ export async function obterConsultaDetalheCorpus(id) {
     const html = await fetchPage(`/visualizacaomateria?id=${id}`);
     return parseConsultaDetalheCorpus(html);
 }
+export async function lerDestaquesConsultas() {
+    const data = await fetchEcidadaniaJson("/restcolecaomaismateria");
+    return data.map((item) => ({
+        id: item.id,
+        materia: item.identificacaoBasica || "",
+        ementa: item.ementa || "",
+        votosSim: lerBrNum(item.votosFavor),
+        votosNao: lerBrNum(item.votosContra),
+        totalVotos: lerBrNum(item.totalVotos),
+    }));
+}
 export async function listarConsultasInternal(params) {
     const { limite = 20 } = params;
-    const data = await fetchEcidadaniaJson("/restcolecaomaismateria");
+    const data = await lerDestaquesConsultas();
     // status is hardcoded "aberta" here because this path serves only the REST "highlight"
     // collection (/restcolecaomais*), which lists active consultations by construction. Real
     // per-item status for the full set is derived from /processo (tramitando) in the ingestion
     // job, which is the source of truth. Edge case: a just-closed highlight may briefly show
     // "aberta" until the next corpus run corrects it — acceptable on this cold-start/fallback path.
+    // Contagem ausente vira 0 só AQUI, na saída ao vivo (comportamento histórico da tool); o splice
+    // do corpus lê `lerDestaquesConsultas` e não grava esse 0.
     return data.slice(0, limite).map((item) => buildConsultaResumo({
         id: item.id,
-        materia: item.identificacaoBasica || "",
-        ementa: item.ementa || "",
-        votosSim: parseBrNum(String(item.votosFavor || "0")),
-        votosNao: parseBrNum(String(item.votosContra || "0")),
-        totalVotos: parseBrNum(String(item.totalVotos || "0")),
+        materia: item.materia,
+        ementa: item.ementa,
+        votosSim: item.votosSim ?? 0,
+        votosNao: item.votosNao ?? 0,
+        totalVotos: item.totalVotos ?? 0,
         status: "aberta",
     }));
 }
@@ -284,9 +299,17 @@ export const IDEIA_PRAZO_APOIOS_DIAS = 120;
  * da tool: a descrição é lida uma vez, o dado é lido a cada resposta, e a data limite de uma ideia
  * aberta cai no futuro — sem o aviso o leitor conclui que o servidor errou.
  */
-export const AVISO_DATAS_IDEIA = "dataPublicacao é a data limite para receber os 20.000 apoios, a única data que o portal publica (o nome do campo é histórico); " +
+export const AVISO_DATAS_IDEIA = "dataPublicacao é a data limite para receber os 20.000 apoios, a única data que o corpus guarda (o nome do campo é histórico); " +
     "por isso cai no futuro em ideia aberta. dataCriacaoEstimada = data limite menos 120 dias, calculada pelo servidor " +
-    "(regra dos 4 meses do portal, medida em 4 ideias de 2017-2020): é estimativa, não dado da fonte.";
+    "(regra dos 4 meses do portal, medida em 4 ideias de 2017-2020): é estimativa, não dado da fonte. " +
+    "A data real em que a ideia foi proposta sai em senado_ecidadania_obter_ideia (dataProposta).";
+/**
+ * Aviso de datas do DETALHE: desde o redesenho de 12/10/2026 a página publica a data de proposição
+ * na linha do tempo. `dataCriacaoEstimada` fica por compatibilidade.
+ */
+export const AVISO_DATAS_IDEIA_DETALHE = "dataProposta é a data em que a ideia foi proposta, publicada pela fonte — use esta. dataPublicacao (= prazoApoios) é a " +
+    "data limite para receber os 20.000 apoios (o nome do campo é histórico). dataCriacaoEstimada (data limite menos 120 dias, " +
+    "calculada pelo servidor) é estimativa mantida por compatibilidade.";
 /**
  * Data provável de criação da ideia: data limite (ISO) − `IDEIA_PRAZO_APOIOS_DIAS`. Aritmética em UTC
  * sobre o dia civil (sem fuso, sem horário de verão). Data ausente ou inválida → null, nunca uma data
@@ -329,124 +352,37 @@ export function buildIdeiaResumo(fields) {
         url: fields.url || `${ECIDADANIA_BASE}/visualizacaoideia?id=${fields.id}`,
     };
 }
-/**
- * Texto da situação na página de detalhe (`<em>` em section[title="Situação da Ideia"]) → vocabulário
- * de status do corpus (aberta | encerrada | convertida), o MESMO que `SITUACAO_STATUS` atribui por
- * bucket da listagem. Uma função só, usada pela tool ao vivo e pelo crawl de transições — antes
- * cada um tinha o seu mapeamento, e o da tool lia "Não acatada" (bucket 9, encerrada) como aberta.
- *
- * Textos REAIS medidos em 06/10/2026, uma ideia por bucket:
- *   s5 "Aberta" · s6 "Na comissão" · s8 "Aguardando envio à CDH"      → aberta
- *   s7 "Encerrada - Sem apoio suficiente" · s9 "Não acatada"          → encerrada
- *   s10 "Convertida em Proposição"                                     → convertida
- *
- * Comparação EXATA (sem caixa e sem acento), decisão do dono em 06/10/2026: texto novo do portal vira
- * null e aparece no log, em vez de ser gravado no histórico com um status adivinhado por palavra-chave.
- * Se o log mostrar um texto novo, acrescente-o aqui e no teste dos textos medidos.
- */
 /**
  * Status de corpus de uma ideia que o portal REMOVEU (detalhe responde HTTP 410). Não vem de texto de
  * situação — o portal não publica nada sobre ela —, só da resposta 410. Decisão do dono (06/10/2026):
  * manter o registro e o histórico no banco com este status, em vez de apagar ou deixar "aberta".
  */
 export const STATUS_IDEIA_REMOVIDA = "removida";
-export function statusFromSituacaoIdeia(texto) {
-    const t = texto.normalize("NFD").replace(/\p{Diacritic}/gu, "").toLowerCase();
-    if (t === "aberta" || t === "na comissao" || t === "aguardando envio a cdh")
-        return "aberta";
-    if (t === "encerrada - sem apoio suficiente" || t === "nao acatada")
-        return "encerrada";
-    if (t === "convertida em proposicao")
-        return "convertida";
-    return null;
-}
-/** Texto cru da situação da ideia na página de detalhe, ou null se a seção não existe. */
-export function extractSituacaoIdeia(html) {
-    const m = html.match(/title="Situa[çc][ãa]o da Ideia"[\s\S]*?<em>([^<]+)<\/em>/i);
-    // O portal manda o texto em UTF-8 literal ("Não acatada", medido 06/10/2026) — sem entidades.
-    return m ? m[1].replace(/\s+/g, " ").trim() : null;
-}
-/**
- * Pure parser of an idea detail page (`visualizacaoideia?id=`) for the CORPUS — extracts only the
- * four detail fields, keeping ONLY the UF of the citizen author (name discarded at source, never
- * returned). Distinct from `obterIdeiaInternal` (the live tool), which still surfaces the portal's
- * semi-anonymized author string; this corpus path never touches the name.
- */
-export function parseIdeiaDetalheCorpus(html) {
-    const text = stripHtml(html);
-    // "Ideia proposta por <span>NOME</span> <span>(UF)</span>" — capturamos SÓ a UF.
-    const autorMatch = html.match(/Ideia proposta por<\/div>\s*<div[^>]*>\s*<span>[^<]+<\/span>\s*<span>\s*\(([A-Z]{2})\)<\/span>/);
-    const autorUf = autorMatch ? autorMatch[1] : null;
-    const dataMatch = html.match(/Data limite[\s\S]*?<div[^>]*>\s*(\d{2}\/\d{2}\/\d{4})\s*<\/div>/i);
-    const dataPublicacao = dataMatch ? extractDate(dataMatch[1]) : null;
-    const descMatch = html.match(/<b><div[^>]*>[^<]+<\/div><\/b>\s*<div[^>]*>([\s\S]*?)<\/div>/);
-    const descricao = descMatch ? stripHtml(descMatch[1]).substring(0, 2000) || null : null;
-    const plMatch = text.match(/(SUGEST[ÃA]O|PEC|PL|PLP)\s*n?º?\s*(\d+)\s*(?:de\s*)?(\d{4})/i);
-    const plConvertido = plMatch
-        ? `${plMatch[1].toUpperCase().includes("SUGEST") ? "SUG" : plMatch[1].toUpperCase()} ${plMatch[2]}/${plMatch[3]}`
-        : null;
-    const apoiosMatch = html.match(/class="contabilizacao"[^>]*>([^<]+)</);
-    const apoios = apoiosMatch ? parseBrNum(apoiosMatch[1]) : null;
-    const situacao = extractSituacaoIdeia(html);
-    const status = situacao === null ? null : statusFromSituacaoIdeia(situacao);
-    return { dataPublicacao, autorUf, descricao, plConvertido, apoios, status };
-}
-/** Fetch + parse the corpus-facing (UF-only) idea detail. */
-export async function obterIdeiaDetalheCorpus(id) {
-    const html = await fetchPage(`/visualizacaoideia?id=${id}`);
-    return parseIdeiaDetalheCorpus(html);
+export async function lerDestaquesIdeias() {
+    const data = await fetchEcidadaniaJson("/restcolecaomaisideia");
+    return data.map((item) => ({ id: item.id, titulo: item.titulo || "", apoios: lerBrNum(item.apoiamentos) }));
 }
 export async function listarIdeiasInternal(params) {
     const { limite = 20 } = params;
-    const data = await fetchEcidadaniaJson("/restcolecaomaisideia");
+    const data = await lerDestaquesIdeias();
     // status is hardcoded "aberta" (via the builder default) because this REST "highlight" collection
     // lists active ideas by construction; real per-idea status for the full set comes from the
     // per-situacao corpus crawl (the source of truth). See buildConsultaResumo for the same rationale.
-    let ideias = data.map((item) => buildIdeiaResumo({
-        id: item.id,
-        titulo: item.titulo || "",
-        apoios: parseBrNum(String(item.apoiamentos || "0")),
-    }));
+    // apoios ausente vira 0 só na saída ao vivo (histórico da tool); o splice não grava esse 0.
+    let ideias = data.map((item) => buildIdeiaResumo({ id: item.id, titulo: item.titulo, apoios: item.apoios ?? 0 }));
     if (params.ordenarPor === "apoios") {
         ideias.sort((a, b) => params.ordem === "asc" ? a.apoios - b.apoios : b.apoios - a.apoios);
     }
     return ideias.slice(0, limite);
 }
+/**
+ * Detalhe de uma ideia ao vivo (`senado_ecidadania_obter_ideia`), pelo leitor da página redesenhada
+ * em 12/10/2026 (`lerIdeiaDetalhe`). Devolve a leitura como o portal publica; a situação NÃO sai daqui
+ * (a página não a publica) — a tool a toma do corpus ou a deriva da linha do tempo. Página fora do
+ * molde lança `IdeiaDetalheForaDoMoldeError` (não retentável); 410 lança antes, em `fetchPage`.
+ */
 export async function obterIdeiaInternal(id) {
-    const html = await fetchPage(`/visualizacaoideia?id=${id}`);
-    const text = stripHtml(html);
-    // Title: <b><div style="font-size:24px;...">TITLE</div></b> inside article#ideia-legislativa
-    const tituloMatch = html.match(/id="ideia-legislativa"[\s\S]*?<b><div[^>]*>([^<]+)<\/div><\/b>/);
-    const titulo = tituloMatch ? stripHtml(tituloMatch[1]) : "";
-    // Description: first <div style="margin-bottom:15px;"> after the title that has content
-    const descMatch = html.match(/<b><div[^>]*>[^<]+<\/div><\/b>\s*<div[^>]*>([\s\S]*?)<\/div>/);
-    const descricao = descMatch ? stripHtml(descMatch[1]).substring(0, 2000) : "";
-    // Support count: <span class="contabilizacao">17.978</span>
-    const apoiosMatch = html.match(/class="contabilizacao"[^>]*>([^<]+)</);
-    const apoios = apoiosMatch ? parseBrNum(apoiosMatch[1]) : 0;
-    // Status: o mesmo mapeamento do corpus (statusFromSituacaoIdeia). Sem seção ou texto não
-    // reconhecido, mantém o "aberta" histórico desta tool — o default antigo, agora só para o
-    // desconhecido, não mais para "Não acatada".
-    const situacao = extractSituacaoIdeia(html);
-    const status = (situacao !== null ? statusFromSituacaoIdeia(situacao) : null) ?? "aberta";
-    // Author: after "Ideia proposta por"
-    const autorMatch = html.match(/Ideia proposta por<\/div>\s*<div[^>]*>\s*<span>([^<]+)<\/span>\s*<span>\s*\(([A-Z]{2})\)<\/span>/);
-    // Date limit
-    const dataMatch = html.match(/Data limite[\s\S]*?<div[^>]*>\s*(\d{2}\/\d{2}\/\d{4})\s*<\/div>/i);
-    const dataPublicacao = dataMatch ? extractDate(dataMatch[1]) : extractDate(text);
-    const comentarioMatch = text.match(/(\d+)\s*coment[aá]rio/i);
-    const plMatch = text.match(/(SUGEST[ÃA]O|PEC|PL|PLP)\s*n?º?\s*(\d+)\s*(?:de\s*)?(\d{4})/i);
-    return {
-        id, titulo, descricao, apoios, dataPublicacao, status,
-        autor: autorMatch ? `${autorMatch[1].trim()} (${autorMatch[2]})` : null,
-        url: `${ECIDADANIA_BASE}/visualizacaoideia?id=${id}`,
-        problema: null, solucao: null,
-        comentarios: comentarioMatch ? parseInt(comentarioMatch[1]) : 0,
-        dataEncerramento: null,
-        plConvertido: plMatch
-            ? `${plMatch[1].toUpperCase().includes("SUGEST") ? "SUG" : plMatch[1].toUpperCase()} ${plMatch[2]}/${plMatch[3]}`
-            : null,
-    };
+    return lerIdeiaDetalhe(await fetchPage(`/visualizacaoideia?id=${id}`));
 }
 /**
  * Canonical `EventoResumo` builder — single source of the object's field order, so the JSON payload
@@ -709,19 +645,21 @@ export async function contarComentariosAudiencia(id) {
  */
 export function buildEventoResumoEnriquecido(fields) {
     const d = fields.detalhe ?? null;
+    const g = fields.guardado;
     return buildEventoResumo({
         id: fields.id,
         titulo: d?.titulo || fields.titulo,
-        data: d?.data ?? fields.dataListagem ?? null,
-        hora: d?.hora ?? fields.horaListagem ?? null,
-        comissao: fields.comissao ?? d?.comissao ?? null,
-        comissaoNomeCompleto: d?.comissaoNomeCompleto ?? null,
-        local: d?.local ?? null,
-        descricao: d?.descricao ?? null,
-        pauta: d?.pauta ?? [],
-        convidados: d?.convidados ?? [],
-        videoUrl: d?.videoUrl ?? null,
-        comentarios: fields.comentariosCanon ?? fields.comentariosListagem ?? 0,
+        data: mesclarCampo(d?.data, g?.data) ?? fields.dataListagem ?? null,
+        hora: mesclarCampo(d?.hora, g?.hora) ?? fields.horaListagem ?? null,
+        comissao: fields.comissao ?? mesclarCampo(d?.comissao, g?.comissao),
+        comissaoNomeCompleto: mesclarCampo(d?.comissaoNomeCompleto, g?.comissaoNomeCompleto),
+        local: mesclarCampo(d?.local, g?.local),
+        descricao: mesclarCampo(d?.descricao, g?.descricao),
+        pauta: mesclarCampo(d?.pauta, g?.pauta) ?? [],
+        convidados: mesclarCampo(d?.convidados, g?.convidados) ?? [],
+        videoUrl: mesclarCampo(d?.videoUrl, g?.videoUrl),
+        // A contagem da listagem é a degradada (0 espúrio em 82% dos eventos, estudo A3): só por último.
+        comentarios: mesclarCampo(fields.comentariosCanon, g?.comentarios) ?? fields.comentariosListagem ?? 0,
         status: fields.status ?? d?.status,
     });
 }