senado-br-mcp 3.14.0 → 3.15.2

package/dist/dataset/schema.js

@@ -182,10 +182,10 @@ const ideiasSchema = {
         {
             name: "status",
             type: "string",
-            description: "Situação da ideia: \"aberta\" | \"encerrada\" | \"convertida\".",
+            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.",
+            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).",
             derived: true,
         },
         {

package/dist/scraper/ecidadania.js

@@ -26,8 +26,8 @@ export const ECIDADANIA_BASE = "https://www12.senado.leg.br/ecidadania";
  * frase, "falha de rede ao acessar" e "retornou HTTP 429/400/403" caíam em
  * `outro`. Sem ela, vale a frase, como sempre.
  */
-function ecidadaniaFetchError(message, retryable, classe) {
-    return Object.assign(new Error(message), classe ? { retryable, classe } : { retryable });
+function ecidadaniaFetchError(message, retryable, classe, hint) {
+    return Object.assign(new Error(message), classe ? { retryable, classe } : { retryable }, hint ? { hint } : {});
 }
 const isTransientStatus = (status) => status >= 500 || status === 429;
 /**
@@ -96,6 +96,14 @@ async function idaEcidadania(path, headers, rotulo) {
             }
             default: {
                 const status = e.status ?? 502;
+                if (status === 410) {
+                    // 410 Gone = o portal REMOVEU o recurso (medido 06/10/2026: ideias retiradas respondem 410
+                    // com "Ideia Legislativa não encontrada!", de forma estável). Não é parâmetro errado nem
+                    // fonte fora do ar — a mensagem genérica abaixo dizia as duas coisas.
+                    throw ecidadaniaFetchError(
+                    // Sem ponto final: `ecidadaniaError` acrescenta ". As demais funcionalidades…".
+                    `${rotulo}: o recurso ${path} foi removido do portal (HTTP 410). O identificador existiu, mas não está mais publicado; não é erro de parâmetro nem indisponibilidade da fonte`, false, "nao_encontrado", "Não repita a chamada nem corrija o identificador: o portal retirou o recurso. Se for uma ideia legislativa, o último estado conhecido segue no corpus: `senado_ecidadania_listar_ideias` com `status: \"removida\"`.");
+                }
                 throw ecidadaniaFetchError(`${rotulo} retornou HTTP ${status} para ${path}`, isTransientStatus(status), status === 404 ? "nao_encontrado" : "fonte");
             }
         }
@@ -269,6 +277,43 @@ 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
@@ -288,7 +333,11 @@ export function parseIdeiaDetalheCorpus(html) {
     const plConvertido = plMatch
         ? `${plMatch[1].toUpperCase().includes("SUGEST") ? "SUG" : plMatch[1].toUpperCase()} ${plMatch[2]}/${plMatch[3]}`
         : null;
-    return { dataPublicacao, autorUf, descricao, plConvertido };
+    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) {
@@ -323,16 +372,11 @@ export async function obterIdeiaInternal(id) {
     // Support count: <span class="contabilizacao">17.978</span>
     const apoiosMatch = html.match(/class="contabilizacao"[^>]*>([^<]+)</);
     const apoios = apoiosMatch ? parseBrNum(apoiosMatch[1]) : 0;
-    // Status: <em> inside section[title="Situação da Ideia"]
-    const statusMatch = html.match(/title="Situa[çc][ãa]o da Ideia"[\s\S]*?<em>([^<]+)<\/em>/i);
-    let status = "aberta";
-    if (statusMatch) {
-        const st = statusMatch[1].toLowerCase().trim();
-        if (st.includes("convertid") || st.includes("transformad"))
-            status = "convertida";
-        else if (st.includes("encerrad"))
-            status = "encerrada";
-    }
+    // 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

package/dist/tools/ecidadania.js

@@ -163,8 +163,8 @@ export function registerECidadaniaTools(server, _baseUrl, env, ctx) {
         }
     });
     // G5. senado_ecidadania_listar_ideias
-    server.tool("senado_ecidadania_listar_ideias", "Lista ideias legislativas propostas por cidadãos no e-Cidadania — **conjunto completo** (corpus persistido em D1, atualizado semanalmente; ~114 mil ideias, incluindo encerradas e convertidas em proposição). Retorna `{ count, ideias }`, cada ideia com `id`, `titulo`, `apoios`, `status` (`aberta`/`encerrada`/`convertida`) e `url` (`autor` e `dataPublicacao` só aparecem no detalhe, vêm `null` aqui). Aceita filtro por `status` e `limite` (padrão 20). Para um ranking das mais apoiadas, ordene por apoios (`ordenarPor: \"apoios\"`, `ordem: \"desc\"`). Para o detalhe completo de uma ideia (texto, autor, se virou projeto de lei) chame `senado_ecidadania_obter_ideia` com o `id`.", {
-        status: z.enum(["aberta", "encerrada", "convertida", "todas"]).optional().describe("Filtrar por status"),
+    server.tool("senado_ecidadania_listar_ideias", "Lista ideias legislativas propostas por cidadãos no e-Cidadania — **conjunto completo** (corpus persistido em D1; ideias em andamento atualizadas diariamente; ~118 mil ideias, incluindo encerradas e convertidas em proposição). Retorna `{ count, ideias }`, cada ideia com `id`, `titulo`, `apoios`, `status` (`aberta`/`encerrada`/`convertida`/`removida` — `removida` = retirada do portal, que não a publica mais; o corpus guarda o último estado conhecido) e `url` (`autor` e `dataPublicacao` só aparecem no detalhe, vêm `null` aqui). Aceita filtro por `status` e `limite` (padrão 20). Para um ranking das mais apoiadas, ordene por apoios (`ordenarPor: \"apoios\"`, `ordem: \"desc\"`). Para o detalhe completo de uma ideia (texto, autor, se virou projeto de lei) chame `senado_ecidadania_obter_ideia` com o `id`.", {
+        status: z.enum(["aberta", "encerrada", "convertida", "removida", "todas"]).optional().describe("Filtrar por status (`removida` = retirada do portal)"),
         ordenarPor: z.enum(["apoios", "data", "comentarios"]).optional().describe("Campo para ordenação (apoios é o disponível no corpus; data/comentarios só no detalhe)"),
         ordem: z.enum(["asc", "desc"]).optional().describe("Ordem de ordenação"),
         limite: z.number().int().min(1).max(100).optional().default(20).describe("Número máximo de resultados"),

package/dist/utils/validation.js

@@ -56,11 +56,18 @@ export function errorFrom(e, fallbackMessage, sufixo = "") {
     const retryable = e instanceof Error && "retryable" in e && typeof e.retryable === "boolean"
         ? e.retryable
         : false;
+    // O `hint` da exceção, quando ela traz um, vence o default — mesmo trato do `retryable`.
+    // Sem isto, um erro que sabe o que aconteceu (ex.: e-Cidadania 410 = recurso retirado)
+    // saía com a mensagem certa e, AO LADO, o hint genérico "verifique os parâmetros … a
+    // fonte pode estar indisponível" — que o contradizia (medido no ar em 06/10/2026).
+    const hint = e instanceof Error && "hint" in e && typeof e.hint === "string"
+        ? e.hint
+        : undefined;
     logger.error("tool_error", { message, retryable });
     // A classe de telemetria vai pelo TIPO do erro, fora do fio (ver
     // CLASSE_DO_ERRO em src/call-shape.ts); sem ela, vale a frase — último
     // recurso, só para exceção que não declara classe.
-    return anexarClasse(envelopeDeErro(message + sufixo, retryable), e);
+    return anexarClasse(envelopeDeErro(message + sufixo, retryable, hint), e);
 }
 export function toolResult(data) {
     // Tools advertise an outputSchema (a permissive object schema), so the SDK requires a

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Single source of truth for the server version (kept in sync with package.json). */
-export const VERSION = "3.14.0";
+export const VERSION = "3.15.2";
 export const USER_AGENT = `senado-br-mcp/${VERSION} (+https://senado.sidneybissoli.com; sbissoli76@gmail.com)`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "senado-br-mcp",
-  "version": "3.14.0",
+  "version": "3.15.2",
   "description": "MCP server for Brazilian Senate open data — runs hosted on Cloudflare Workers or locally via npx (stdio)",
   "license": "MIT",
   "type": "module",
@@ -61,10 +61,10 @@
     "@cloudflare/workers-types": "^5.20260830.1",
     "@modelcontextprotocol/client": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@sbissoli/mcp-evals": "^0.1.0",
+    "@sbissoli/mcp-evals": "^0.2.1",
     "@sbissoli/mcp-surface": "^0.3.0",
     "@types/node": "^26.5.1",
-    "agents": "^0.24.0",
+    "agents": "^0.26.0",
     "exceljs": "^4.4.0",
     "tsx": "^4.23.13",
     "typescript": "^7.0.2",