opf-br-mcp 0.5.1 → 0.6.1

package/README.md

@@ -11,10 +11,15 @@ acesso token-eficiente às regras do Open Finance Brasil.
 | Domínio | Fonte | Conteúdo |
 |---|---|---|
 | `pcm-additional-info` | Confluence público OFB | Regras de obrigatoriedade do `additionalInfo` (PCM) |
-| `payments-v4-openapi` | GitHub OpenBanking-Brasil/openapi | Spec OpenAPI 4.0.0 da API de Pagamentos |
+| `payments-v4-openapi` | GitHub OpenBanking-Brasil/all-services-repo | Spec OpenAPI 4.1.0 da API de Pagamentos |
 | `payments-v5-openapi` | GitHub OpenBanking-Brasil/all-services-repo | Spec OpenAPI 5.0.0 da API de Iniciação de Pagamentos (consentimentos + Pix) |
-| `enrollments-v2-openapi` | GitHub OpenBanking-Brasil/all-services-repo | Spec OpenAPI 2.2.0 da API de Vínculo de Dispositivo (Enrollments, FIDO, Pix Automático) |
+| `payments-v5-business-rules` | Confluence público OFB (Serviços - SV) | Regras de negócio da API de Pagamentos 5.0.0 (Escopo, Máquina de Estados, Diagrama de Sequência, Validação no DICT, Adaptações 4.0.1→5.0.0) — item por seção |
+| `enrollments-v2-openapi` | GitHub OpenBanking-Brasil/all-services-repo | Spec OpenAPI 2.3.0 da API de Vínculo de Dispositivo (Enrollments, FIDO, Pix Automático) |
+| `enrollments-v2-business-rules` | Confluence público OFB (Serviços - SV) | Regras de negócio do Vínculo de Dispositivo 2.2.0 (Máquina de estados, Edição do vínculo, FAQ - JSR) — item por seção |
 | `automatic-payments-v2-openapi` | GitHub OpenBanking-Brasil/all-services-repo | Spec OpenAPI 2.2.0 da API de Pagamentos Automáticos (Pix Automático e Transferências Inteligentes) |
+| `automatic-payments-v2-business-rules` | Confluence público OFB (Serviços - SV) | Regras de negócio de Pagamentos Automáticos 2.2.0 (Máquina de Estados, Edição do consentimento, Tentativas Intradia/Extradia, Adaptações 1.0.0→2.2.0) — item por seção |
+| `payments-common-rules` | Confluence público OFB (Serviços - SV) | Conteúdo comum aos produtos de Iniciação de Pagamentos (atores, Idempotência, Como Assinar o Payload, Convenções de data/fuso, Polling) — item por seção |
+| `payments-implementation-guides` | Confluence público OFB (Serviços - SV) | Guias de Implementação (Pix Automático, Agendamento Recorrente, Transferências Inteligentes, Liquidação de QR Codes) — item por seção |
 | `consents-v3-openapi` | GitHub Pages openbanking-brasil.github.io | Spec OpenAPI 3.3.1 da API de Consentimentos (Dados Cadastrais e Transacionais) |
 | `pcm-openapi` | GitHub OpenBanking-Brasil/pcm-specs | Spec OpenAPI da PCM (reportes, hybrid-flow, opendata, consents/stock, credit-portabilities, payments/status) |
 | `pcm-business-rules` | Confluence público OFB | Regras de negócio da PCM (Reporte, Processamento, Divergências, Especificação Técnica, Manual de Integração) — item por seção |

package/dist/index.js

@@ -46,7 +46,7 @@ function isFresh(entry, ttlHours, now = /* @__PURE__ */ new Date()) {
 }
 
 // src/core/version.ts
-var PACKAGE_VERSION = "0.5.0";
+var PACKAGE_VERSION = "0.6.1";
 
 // src/core/data.ts
 async function getDomainData(domain, force = false, ctx) {
@@ -297,8 +297,8 @@ function buildItems(pages) {
 var pcmDomain = {
   id: "pcm-additional-info",
   title: "PCM \u2014 Regras de obrigatoriedade do additionalInfo",
-  description: "Regras de preenchimento do campo additionalInfo das p\xE1ginas PCM (Plataforma de Coleta de M\xE9tricas) do Confluence do Open Finance Brasil (Inicia\xE7\xE3o de Pagamentos, Pagamentos Autom\xE1ticos, Sem Redirecionamento, DC-*). Cada item \xE9 um campo com regra, m\xE9todos, endpoints, vers\xF5es, tamanho m\xE1ximo e exemplo. search devolve resumos; use get_item para o registro completo.",
-  ttlHours: 24,
+  description: "Tabelas de obrigatoriedade e preenchimento do campo additionalInfo no Open Finance Brasil, extra\xEDdas do Confluence, por fam\xEDlia: Inicia\xE7\xE3o de Pagamentos (v4/v5), Sem Redirecionamento, Pagamentos Autom\xE1ticos, Seguran\xE7a (SG) e Dados/Consentimento (DC-*, v3). Cada item \xE9 um campo com regra de preenchimento, roles (CLIENT/SERVER), m\xE9todos, endpoints, vers\xF5es, tamanho m\xE1ximo e exemplo. Uma das facetas da PCM (Plataforma de Coleta de M\xE9tricas): para o swagger dos endpoints de reporte veja pcm-openapi; para as regras de neg\xF3cio (reporte, processamento, diverg\xEAncias) veja pcm-business-rules. search devolve resumos; use get_item para o registro completo.",
+  ttlHours: 72,
   filters: [
     { name: "field", description: "Match exato no nome do campo (case-insensitive)" },
     { name: "contains", description: "Substring em campo ou definicao" },
@@ -394,7 +394,7 @@ function createOpenApiDomain(config) {
     id: config.id,
     title: config.title,
     description: config.description,
-    ttlHours: 24,
+    ttlHours: 72,
     filters: [
       { name: "path", description: `Substring no path do endpoint (ex.: ${config.pathExample})` },
       { name: "method", description: "Verbo HTTP exato (ex.: POST)" },
@@ -435,12 +435,12 @@ function createOpenApiDomain(config) {
 // src/domains/payments-v4-openapi/config.ts
 var paymentsConfig = {
   id: "payments-v4-openapi",
-  title: "API de Pagamentos \u2014 spec OpenAPI 4.0.0",
-  description: "Spec OpenAPI oficial da API de Pagamentos (Pix) do Open Finance Brasil. Itens type=operation (endpoints, um por m\xE9todo+path) e type=schema (payloads). search devolve resumos; use get_item para o n\xF3 completo da spec.",
+  title: "API de Pagamentos \u2014 spec OpenAPI 4.1.0",
+  description: "Spec OpenAPI oficial da API de Inicia\xE7\xE3o de Pagamentos (Pix) do Open Finance Brasil, vers\xE3o 4. Mesma fam\xEDlia da payments-v5-openapi (major mais recente); escolha o dom\xEDnio pela vers\xE3o que seu caso usa. Itens type=operation (endpoints, um por m\xE9todo+path) e type=schema (payloads). search devolve resumos; use get_item para o n\xF3 completo da spec.",
   pathExample: "/pix/payments",
   specName: "payments",
-  specVersion: "4.0.0",
-  url: "https://raw.githubusercontent.com/OpenBanking-Brasil/openapi/main/swagger-apis/payments/4.0.0.yml",
+  specVersion: "4.1.0",
+  url: "https://raw.githubusercontent.com/OpenBanking-Brasil/all-services-repo/refs/heads/main/api_payment_initiation_-_open_finance_brasil/4.1.0.yaml",
   retryDelaysMs: [2e3, 4e3, 8e3, 16e3]
 };
 
@@ -451,7 +451,7 @@ var paymentsDomain = createOpenApiDomain(paymentsConfig);
 var paymentsV5Config = {
   id: "payments-v5-openapi",
   title: "API de Pagamentos \u2014 spec OpenAPI 5.0.0",
-  description: "Spec OpenAPI oficial da API de Inicia\xE7\xE3o de Pagamentos (Pix) do Open Finance Brasil, vers\xE3o 5. Inclui endpoints de consentimento (/consents) e de pagamento (/pix/payments). Itens type=operation (endpoints, um por m\xE9todo+path) e type=schema (payloads). search devolve resumos; use get_item para o n\xF3 completo da spec.",
+  description: "Spec OpenAPI oficial da API de Inicia\xE7\xE3o de Pagamentos (Pix) do Open Finance Brasil, vers\xE3o 5 (major mais recente). Mesma fam\xEDlia da payments-v4-openapi; escolha o dom\xEDnio pela vers\xE3o que seu caso usa. Itens type=operation (endpoints, um por m\xE9todo+path) e type=schema (payloads). search devolve resumos; use get_item para o n\xF3 completo da spec.",
   pathExample: "/pix/payments",
   specName: "payments",
   specVersion: "5.0.0",
@@ -462,21 +462,179 @@ var paymentsV5Config = {
 // src/domains/payments-v5-openapi/index.ts
 var paymentsV5Domain = createOpenApiDomain(paymentsV5Config);
 
+// src/domains/_confluence-sections/parser.ts
+import * as cheerio2 from "cheerio";
+var HEADING_SELECTOR = "h1, h2, h3";
+function cellText2($, el) {
+  const clone = $(el).clone();
+  clone.find("br").replaceWith("\n");
+  return clone.text().replace(/ /g, " ").replace(/[ \t]+/g, " ").trim();
+}
+function blockText($, node) {
+  const $node = $(node);
+  if (node.tagName === "table") {
+    return $node.find("tr").toArray().map(
+      (tr) => $(tr).find("th, td").toArray().map((c) => cellText2($, c)).join(" | ")
+    ).filter((line) => line.replace(/[ |]/g, "").length > 0).join("\n");
+  }
+  return cellText2($, node);
+}
+function parseSections(html) {
+  const $ = cheerio2.load(html);
+  $("style, script").remove();
+  const sections = [];
+  const headings = $(HEADING_SELECTOR).toArray();
+  const first = headings[0];
+  const introNodes = first ? $(first).prevAll().toArray().reverse() : $("body").contents().toArray();
+  const introParts = introNodes.map((n) => blockText($, n)).filter(Boolean);
+  const introContent = introParts.join("\n\n").trim();
+  if (introContent) sections.push({ heading: "intro", level: 0, content: introContent });
+  for (const el of headings) {
+    const heading = cellText2($, el);
+    if (!heading) continue;
+    const level = Number(el.tagName.slice(1));
+    const parts = $(el).nextUntil(HEADING_SELECTOR).toArray().map((n) => blockText($, n)).filter(Boolean);
+    sections.push({ heading, level, content: parts.join("\n\n").trim() });
+  }
+  return sections;
+}
+
+// src/domains/_confluence-sections/domain.ts
+var SNIPPET_LEN = 200;
+function slugify2(text2) {
+  return text2.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function buildItems2(pages) {
+  const items = [];
+  const seen = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    for (const section of page.sections) {
+      const base = `${page.pageId}:${slugify2(section.heading)}`;
+      const count = (seen.get(base) ?? 0) + 1;
+      seen.set(base, count);
+      const id = count > 1 ? `${base}-${count}` : base;
+      items.push({
+        id,
+        heading: section.heading,
+        level: section.level,
+        content: section.content,
+        page: { pageId: page.pageId, title: page.title, url: page.url }
+      });
+    }
+  }
+  return items;
+}
+function summarize2(item) {
+  const { content, ...rest } = item;
+  const snippet = content.length > SNIPPET_LEN ? `${content.slice(0, SNIPPET_LEN)}\u2026` : content;
+  return { ...rest, snippet };
+}
+function createConfluenceSectionsDomain(config) {
+  return {
+    id: config.id,
+    title: config.title,
+    description: config.description,
+    ttlHours: 72,
+    filters: [
+      { name: "page", description: "Substring no t\xEDtulo da p\xE1gina Confluence" },
+      { name: "heading", description: "Substring no t\xEDtulo da se\xE7\xE3o (heading)" },
+      { name: "contains", description: "Substring no conte\xFAdo da se\xE7\xE3o" }
+    ],
+    async extract(ctx) {
+      const total = config.pages.length;
+      const pages = [];
+      for (const [i, page] of config.pages.entries()) {
+        if (ctx?.signal?.aborted) throw new Error("Extra\xE7\xE3o cancelada pelo cliente");
+        if (i > 0) await sleep(config.interRequestDelayMs);
+        ctx?.onProgress?.(i, total, `Extraindo "${page.title}"`);
+        const { html, url } = await fetchConfluencePage(
+          config.confluenceBaseUrl,
+          page.pageId,
+          config.retryDelaysMs,
+          ctx?.signal
+        );
+        pages.push({ pageId: page.pageId, title: page.title, url, sections: parseSections(html) });
+      }
+      ctx?.onProgress?.(total, total);
+      return { items: buildItems2(pages) };
+    },
+    search(data, query, filters = {}) {
+      const page = filters.page ? normalize(filters.page) : void 0;
+      const heading = filters.heading ? normalize(filters.heading) : void 0;
+      const contains = filters.contains ? normalize(filters.contains) : void 0;
+      return data.items.filter((item) => {
+        if (page && !normalize(item.page.title).includes(page)) return false;
+        if (heading && !normalize(item.heading).includes(heading)) return false;
+        if (contains && !normalize(item.content).includes(contains)) return false;
+        if (query?.trim()) {
+          if (!matchesQuery(`${item.heading} ${item.content}`, query)) return false;
+        }
+        return true;
+      }).map(summarize2);
+    },
+    getItem(data, id) {
+      return data.items.find((i) => i.id === id) ?? null;
+    }
+  };
+}
+
+// src/domains/payments-v5-business-rules/config.ts
+var paymentsV5BusinessRulesConfig = {
+  id: "payments-v5-business-rules",
+  title: "API de Pagamentos v5 \u2014 Regras de neg\xF3cio (SV)",
+  description: "Regras de neg\xF3cio da API de Inicia\xE7\xE3o de Pagamentos (Pix) vers\xE3o 5.0.0 do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence de Servi\xE7os (SV): Informa\xE7\xF5es Gerais (vis\xE3o geral dos endpoints e dicion\xE1rio de dados), Escopo da API (formas de inicia\xE7\xE3o suportadas: Pix imediato, agendado, agendado recorrente, QR Code est\xE1tico/din\xE2mico, Pix Saque, Pix Troco, Pix Composto), M\xE1quina de Estados (status do consentimento e do pagamento), Diagrama de Sequ\xEAncia, Valida\xE7\xE3o de informa\xE7\xF5es no DICT e Adapta\xE7\xF5es para consultas de recursos entre 4.0.1 e 5.0.0. Complementa payments-v5-openapi, que traz a spec (endpoints e schemas) da mesma vers\xE3o. Conte\xFAdo que vale para todos os produtos de inicia\xE7\xE3o (idempot\xEAncia, assinatura de payload, polling, formatos de data) est\xE1 em payments-common-rules. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
+  interRequestDelayMs: 2e3,
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
+  pages: [
+    { pageId: "1767146135", title: "Informa\xE7\xF5es Gerais - Pagamentos v5.0.0" },
+    { pageId: "1767342137", title: "Escopo da API de Pagamentos - v5.0.0" },
+    { pageId: "1767146236", title: "M\xE1quina de Estados - Pagamentos v5.0.0" },
+    { pageId: "1767146164", title: "Diagrama de Sequ\xEAncia - Pagamentos v5.0.0" },
+    { pageId: "1767146321", title: "Valida\xE7\xE3o de informa\xE7\xF5es no DICT - Pagamentos v5.0.0" },
+    { pageId: "1861353753", title: "Adapta\xE7\xF5es para consultas de recursos entre 4.0.1 e 5.0.0" }
+  ]
+};
+
+// src/domains/payments-v5-business-rules/index.ts
+var paymentsV5BusinessRulesDomain = createConfluenceSectionsDomain(paymentsV5BusinessRulesConfig);
+
 // src/domains/enrollments-v2-openapi/config.ts
 var enrollmentsV2Config = {
   id: "enrollments-v2-openapi",
-  title: "API de V\xEDnculo de Dispositivo (Enrollments) \u2014 spec OpenAPI 2.2.0",
+  title: "API de V\xEDnculo de Dispositivo (Enrollments) \u2014 spec OpenAPI 2.3.0",
   description: "Spec OpenAPI oficial da API de Enrollments (V\xEDnculo de Dispositivo) do Open Finance Brasil, vers\xE3o 2. Cobre o pagamento sem redirecionamento: v\xEDnculo de dispositivos (FIDO), autoriza\xE7\xE3o de consentimentos e Pix Autom\xE1tico. Endpoints /enrollments, /consents/{consentId}/authorise e /recurring-consents/{recurringConsentId}/authorise. Itens type=operation (endpoints, um por m\xE9todo+path) e type=schema (payloads). search devolve resumos; use get_item para o n\xF3 completo da spec.",
   pathExample: "/enrollments",
   specName: "enrollments",
-  specVersion: "2.2.0",
-  url: "https://raw.githubusercontent.com/OpenBanking-Brasil/all-services-repo/refs/heads/main/api_enrollments_for_payment_initiation_-_open_finance_brasil/2.2.0.yaml",
+  specVersion: "2.3.0",
+  url: "https://raw.githubusercontent.com/OpenBanking-Brasil/all-services-repo/refs/heads/main/api_enrollments_for_payment_initiation_-_open_finance_brasil/2.3.0.yaml",
   retryDelaysMs: [2e3, 4e3, 8e3, 16e3]
 };
 
 // src/domains/enrollments-v2-openapi/index.ts
 var enrollmentsV2Domain = createOpenApiDomain(enrollmentsV2Config);
 
+// src/domains/enrollments-v2-business-rules/config.ts
+var enrollmentsV2BusinessRulesConfig = {
+  id: "enrollments-v2-business-rules",
+  title: "API de V\xEDnculo de Dispositivo v2 \u2014 Regras de neg\xF3cio (SV)",
+  description: "Regras de neg\xF3cio da API de V\xEDnculo de Dispositivo (Enrollments / Jornada Sem Redirecionamento) vers\xE3o 2.2.0 do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence de Servi\xE7os (SV): Informa\xE7\xF5es Gerais, M\xE1quina de estados (vincula\xE7\xE3o de conta, autoriza\xE7\xE3o de consentimento e do consentimento recorrente), Edi\xE7\xE3o do v\xEDnculo de dispositivo (campos edit\xE1veis e condi\xE7\xF5es) e FAQ - JSR (perguntas e respostas por categoria). Complementa enrollments-v2-openapi, que traz a spec (endpoints e schemas) do mesmo major \u2014 hoje na 2.3.0, enquanto estas p\xE1ginas do Confluence ainda s\xE3o as da 2.2.0. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
+  interRequestDelayMs: 2e3,
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
+  pages: [
+    { pageId: "1436516369", title: "Informa\xE7\xF5es Gerais - V\xEDnculo de dispositivo v2.2.0" },
+    { pageId: "1436516401", title: "M\xE1quina de estados - V\xEDnculo de dispositivo v2.2.0" },
+    { pageId: "1436516593", title: "Edi\xE7\xE3o do v\xEDnculo de dispositivo - v2.2.0" },
+    { pageId: "1436516567", title: "FAQ - JSR - V\xEDnculo de dispositivo v2.2.0" }
+  ]
+};
+
+// src/domains/enrollments-v2-business-rules/index.ts
+var enrollmentsV2BusinessRulesDomain = createConfluenceSectionsDomain(
+  enrollmentsV2BusinessRulesConfig
+);
+
 // src/domains/automatic-payments-v2-openapi/config.ts
 var automaticPaymentsV2Config = {
   id: "automatic-payments-v2-openapi",
@@ -492,11 +650,75 @@ var automaticPaymentsV2Config = {
 // src/domains/automatic-payments-v2-openapi/index.ts
 var automaticPaymentsV2Domain = createOpenApiDomain(automaticPaymentsV2Config);
 
+// src/domains/automatic-payments-v2-business-rules/config.ts
+var automaticPaymentsV2BusinessRulesConfig = {
+  id: "automatic-payments-v2-business-rules",
+  title: "API de Pagamentos Autom\xE1ticos v2 \u2014 Regras de neg\xF3cio (SV)",
+  description: "Regras de neg\xF3cio da API de Pagamentos Autom\xE1ticos (Pix Autom\xE1tico e Transfer\xEAncias Inteligentes) vers\xE3o 2.2.0 do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence de Servi\xE7os (SV): Informa\xE7\xF5es Gerais (vis\xE3o geral dos endpoints e dicion\xE1rio de dados), M\xE1quina de Estados (status do consentimento recorrente e do pagamento), Edi\xE7\xE3o do consentimento (campos edit\xE1veis e condi\xE7\xF5es), Tentativas Intradia e Extradia para Pix Autom\xE1tico (janelas de liquida\xE7\xE3o, retentativas, e2eID) e Adapta\xE7\xF5es para consultas de recursos entre 1.0.0 e 2.2.0. Complementa automatic-payments-v2-openapi, que traz a spec (endpoints e schemas) da mesma vers\xE3o. O guia de implementa\xE7\xE3o passo a passo do Pix Autom\xE1tico est\xE1 em payments-implementation-guides. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
+  interRequestDelayMs: 2e3,
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
+  pages: [
+    { pageId: "1178042385", title: "Informa\xE7\xF5es Gerais - Pagamentos Autom\xE1ticos v2.2.0" },
+    { pageId: "1178042440", title: "M\xE1quina de Estados - Pagamentos Autom\xE1ticos v2.2.0" },
+    { pageId: "1178042534", title: "Edi\xE7\xE3o do consentimento - Pagamentos Autom\xE1ticos v2.2.0" },
+    { pageId: "1178042550", title: "Tentativas Intradia e Extradia para Pix Autom\xE1tico - v2.2.0" },
+    { pageId: "1178042602", title: "Adapta\xE7\xF5es para consultas de recursos entre 1.0.0 e 2.2.0" }
+  ]
+};
+
+// src/domains/automatic-payments-v2-business-rules/index.ts
+var automaticPaymentsV2BusinessRulesDomain = createConfluenceSectionsDomain(
+  automaticPaymentsV2BusinessRulesConfig
+);
+
+// src/domains/payments-common-rules/config.ts
+var paymentsCommonRulesConfig = {
+  id: "payments-common-rules",
+  title: "Inicia\xE7\xE3o de Pagamentos \u2014 Conte\xFAdo comum entre os produtos (SV)",
+  description: "Regras que valem para todos os produtos de Inicia\xE7\xE3o de Pagamentos do Open Finance Brasil (Pagamentos, Pagamentos Autom\xE1ticos e V\xEDnculo de Dispositivo), independentes de vers\xE3o da API, extra\xEDdas das p\xE1ginas Confluence de Servi\xE7os (SV): conceitos e atores da inicia\xE7\xE3o (detentora de conta, iniciadora de transa\xE7\xE3o de pagamento, inicia\xE7\xE3o pelo recebedor), Idempot\xEAncia, Assinatura de Mensagem vs Idempot\xEAncia, Como Assinar o Payload (JWS, claims, valida\xE7\xE3o), Conven\xE7\xF5es de formata\xE7\xE3o e fuso hor\xE1rio de campos de data e hora, e Recomenda\xE7\xE3o de Uso de Polling e Controle de Acesso. Regras espec\xEDficas de cada API est\xE3o em payments-v5-business-rules, automatic-payments-v2-business-rules e enrollments-v2-business-rules. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
+  interRequestDelayMs: 2e3,
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
+  pages: [
+    { pageId: "17375910", title: "Inicia\xE7\xE3o de Pagamentos - conceitos e atores" },
+    { pageId: "728301590", title: "Idempot\xEAncia" },
+    { pageId: "728301669", title: "Assinatura de Mensagem vs Idempot\xEAncia" },
+    { pageId: "728301632", title: "Como Assinar o Payload" },
+    { pageId: "728301690", title: "Conven\xE7\xF5es de formata\xE7\xE3o e fuso hor\xE1rio de campos de data e hora" },
+    { pageId: "728301611", title: "Recomenda\xE7\xE3o Uso de Polling e Controle de Acesso" }
+  ]
+};
+
+// src/domains/payments-common-rules/index.ts
+var paymentsCommonRulesDomain = createConfluenceSectionsDomain(paymentsCommonRulesConfig);
+
+// src/domains/payments-implementation-guides/config.ts
+var paymentsImplementationGuidesConfig = {
+  id: "payments-implementation-guides",
+  title: "Inicia\xE7\xE3o de Pagamentos \u2014 Guias de Implementa\xE7\xE3o (SV)",
+  description: "Guias de implementa\xE7\xE3o da Inicia\xE7\xE3o de Pagamentos do Open Finance Brasil, extra\xEDdos das p\xE1ginas Confluence de Servi\xE7os (SV). S\xE3o documentos longos, orientados a jornada, que descrevem regras de neg\xF3cio, fluxos e casos de uso ponta a ponta: Pix Autom\xE1tico (consentimento com/sem pagamento inicial, edi\xE7\xE3o, revoga\xE7\xE3o, ciclos de cobran\xE7a e retentativas), Agendamento Recorrente, Transfer\xEAncias Inteligentes e Liquida\xE7\xE3o de QR Codes via API Pagamentos (QR est\xE1tico, din\xE2mico, Pix Saque/Troco). Seguem versionamento pr\xF3prio, independente da vers\xE3o da API. Para as regras normativas por vers\xE3o de API veja payments-v5-business-rules, automatic-payments-v2-business-rules e enrollments-v2-business-rules. Cuidado: o dom\xEDnio jornada-otimizada tem uma p\xE1gina hom\xF4nima de Transfer\xEAncias Inteligentes, com outro recorte (Jornada Otimizada); aqui o foco \xE9 o guia de implementa\xE7\xE3o do produto. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
+  interRequestDelayMs: 2e3,
+  retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
+  pages: [
+    { pageId: "1217527809", title: "Pix Autom\xE1tico" },
+    { pageId: "213876817", title: "Agendamento Recorrente" },
+    { pageId: "628195902", title: "Transfer\xEAncias Inteligentes" },
+    { pageId: "1836744705", title: "Liquida\xE7\xE3o de QR Codes via API Pagamentos" }
+  ]
+};
+
+// src/domains/payments-implementation-guides/index.ts
+var paymentsImplementationGuidesDomain = createConfluenceSectionsDomain(
+  paymentsImplementationGuidesConfig
+);
+
 // src/domains/consents-v3-openapi/config.ts
 var consentsV3Config = {
   id: "consents-v3-openapi",
   title: "API de Consentimentos \u2014 spec OpenAPI 3.3.1",
-  description: "Spec OpenAPI oficial da API de Consentimentos (Dados Cadastrais e Transacionais) do Open Finance Brasil, vers\xE3o 3.3.1. Cobre cria\xE7\xE3o (POST /consents), consulta (GET /consents/{consentId}), revoga\xE7\xE3o (DELETE /consents/{consentId}), renova\xE7\xE3o (POST /consents/{consentId}/extends) e hist\xF3rico de renova\xE7\xF5es (GET /consents/{consentId}/extensions). Itens type=operation (um por m\xE9todo+path) e type=schema (payloads, ex.: CreateConsent, ResponseConsent, LoggedUser, BusinessEntity). search devolve resumos; use get_item para o n\xF3 completo da spec.",
+  description: "Spec OpenAPI oficial da API de Consentimentos de compartilhamento de dados (Dados Cadastrais e Transacionais) do Open Finance Brasil, vers\xE3o 3.3.1. \xC9 o consentimento de dados \u2014 n\xE3o cobre consentimento de pagamento, que fica em payments-v4/v5-openapi (/consents) e automatic-payments-v2-openapi (/recurring-consents). Cobre cria\xE7\xE3o (POST /consents), consulta (GET /consents/{consentId}), revoga\xE7\xE3o (DELETE /consents/{consentId}), renova\xE7\xE3o (POST /consents/{consentId}/extends) e hist\xF3rico de renova\xE7\xF5es (GET /consents/{consentId}/extensions). Itens type=operation (um por m\xE9todo+path) e type=schema (payloads, ex.: CreateConsent, ResponseConsent, LoggedUser, BusinessEntity). search devolve resumos; use get_item para o n\xF3 completo da spec.",
   pathExample: "/consents/{consentId}",
   specName: "consents",
   specVersion: "3.3.1",
@@ -551,15 +773,15 @@ function parseOpenApiSpec2(yamlText, specName) {
 }
 
 // src/domains/pcm-openapi/index.ts
-function summarize2(item) {
+function summarize3(item) {
   const { detail: _detail, ...rest } = item;
   return rest;
 }
 var pcmOpenapiDomain = {
   id: "pcm-openapi",
   title: `PCM \u2014 spec OpenAPI ${pcmOpenapiConfig.specVersion}`,
-  description: "Spec OpenAPI oficial da PCM (Plataforma de Coleta de M\xE9tricas) do Open Finance Brasil. Cobre os endpoints de reporte (report-api v1/v2), hybrid-flow, opendata, consents/stock, credit-portabilities, payments/status e token. Itens type=operation (um por m\xE9todo+path) e type=schema (payloads). search devolve resumos; use get_item para o n\xF3 completo da spec.",
-  ttlHours: 24,
+  description: "Spec OpenAPI oficial da PCM (Plataforma de Coleta de M\xE9tricas) do Open Finance Brasil \u2014 a faceta swagger. Cobre os endpoints de reporte (report-api v1/v2), hybrid-flow, opendata, consents/stock, credit-portabilities, payments/status e token. Itens type=operation (um por m\xE9todo+path) e type=schema (payloads). Outras facetas da PCM: tabelas de obrigatoriedade do campo additionalInfo em pcm-additional-info; regras de neg\xF3cio (reporte, processamento, diverg\xEAncias) em pcm-business-rules. search devolve resumos; use get_item para o n\xF3 completo da spec.",
+  ttlHours: 72,
   filters: [
     { name: "path", description: "Substring no path do endpoint (ex.: /report-api/v1/private/report)" },
     { name: "method", description: "Verbo HTTP exato (ex.: POST)" },
@@ -589,133 +811,18 @@ var pcmOpenapiDomain = {
         if (!matchesQuery(haystack, query)) return false;
       }
       return true;
-    }).map(summarize2);
+    }).map(summarize3);
   },
   getItem(data, id) {
     return data.items.find((i) => i.id === id) ?? null;
   }
 };
 
-// src/domains/_confluence-sections/parser.ts
-import * as cheerio2 from "cheerio";
-var HEADING_SELECTOR = "h1, h2, h3";
-function cellText2($, el) {
-  const clone = $(el).clone();
-  clone.find("br").replaceWith("\n");
-  return clone.text().replace(/ /g, " ").replace(/[ \t]+/g, " ").trim();
-}
-function blockText($, node) {
-  const $node = $(node);
-  if (node.tagName === "table") {
-    return $node.find("tr").toArray().map(
-      (tr) => $(tr).find("th, td").toArray().map((c) => cellText2($, c)).join(" | ")
-    ).filter((line) => line.replace(/[ |]/g, "").length > 0).join("\n");
-  }
-  return cellText2($, node);
-}
-function parseSections(html) {
-  const $ = cheerio2.load(html);
-  const sections = [];
-  const headings = $(HEADING_SELECTOR).toArray();
-  const first = headings[0];
-  const introNodes = first ? $(first).prevAll().toArray().reverse() : $("body").contents().toArray();
-  const introParts = introNodes.map((n) => blockText($, n)).filter(Boolean);
-  const introContent = introParts.join("\n\n").trim();
-  if (introContent) sections.push({ heading: "intro", level: 0, content: introContent });
-  for (const el of headings) {
-    const heading = cellText2($, el);
-    if (!heading) continue;
-    const level = Number(el.tagName.slice(1));
-    const parts = $(el).nextUntil(HEADING_SELECTOR).toArray().map((n) => blockText($, n)).filter(Boolean);
-    sections.push({ heading, level, content: parts.join("\n\n").trim() });
-  }
-  return sections;
-}
-
-// src/domains/_confluence-sections/domain.ts
-var SNIPPET_LEN = 200;
-function slugify2(text2) {
-  return text2.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-}
-function buildItems2(pages) {
-  const items = [];
-  const seen = /* @__PURE__ */ new Map();
-  for (const page of pages) {
-    for (const section of page.sections) {
-      const base = `${page.pageId}:${slugify2(section.heading)}`;
-      const count = (seen.get(base) ?? 0) + 1;
-      seen.set(base, count);
-      const id = count > 1 ? `${base}-${count}` : base;
-      items.push({
-        id,
-        heading: section.heading,
-        level: section.level,
-        content: section.content,
-        page: { pageId: page.pageId, title: page.title, url: page.url }
-      });
-    }
-  }
-  return items;
-}
-function summarize3(item) {
-  const { content, ...rest } = item;
-  const snippet = content.length > SNIPPET_LEN ? `${content.slice(0, SNIPPET_LEN)}\u2026` : content;
-  return { ...rest, snippet };
-}
-function createConfluenceSectionsDomain(config) {
-  return {
-    id: config.id,
-    title: config.title,
-    description: config.description,
-    ttlHours: 24,
-    filters: [
-      { name: "page", description: "Substring no t\xEDtulo da p\xE1gina Confluence" },
-      { name: "heading", description: "Substring no t\xEDtulo da se\xE7\xE3o (heading)" },
-      { name: "contains", description: "Substring no conte\xFAdo da se\xE7\xE3o" }
-    ],
-    async extract(ctx) {
-      const total = config.pages.length;
-      const pages = [];
-      for (const [i, page] of config.pages.entries()) {
-        if (ctx?.signal?.aborted) throw new Error("Extra\xE7\xE3o cancelada pelo cliente");
-        if (i > 0) await sleep(config.interRequestDelayMs);
-        ctx?.onProgress?.(i, total, `Extraindo "${page.title}"`);
-        const { html, url } = await fetchConfluencePage(
-          config.confluenceBaseUrl,
-          page.pageId,
-          config.retryDelaysMs,
-          ctx?.signal
-        );
-        pages.push({ pageId: page.pageId, title: page.title, url, sections: parseSections(html) });
-      }
-      ctx?.onProgress?.(total, total);
-      return { items: buildItems2(pages) };
-    },
-    search(data, query, filters = {}) {
-      const page = filters.page ? normalize(filters.page) : void 0;
-      const heading = filters.heading ? normalize(filters.heading) : void 0;
-      const contains = filters.contains ? normalize(filters.contains) : void 0;
-      return data.items.filter((item) => {
-        if (page && !normalize(item.page.title).includes(page)) return false;
-        if (heading && !normalize(item.heading).includes(heading)) return false;
-        if (contains && !normalize(item.content).includes(contains)) return false;
-        if (query?.trim()) {
-          if (!matchesQuery(`${item.heading} ${item.content}`, query)) return false;
-        }
-        return true;
-      }).map(summarize3);
-    },
-    getItem(data, id) {
-      return data.items.find((i) => i.id === id) ?? null;
-    }
-  };
-}
-
 // src/domains/pcm-business-rules/config.ts
 var pcmBusinessRulesConfig = {
   id: "pcm-business-rules",
   title: "PCM \u2014 Regras de neg\xF3cio (Reporte, Processamento, Diverg\xEAncias)",
-  description: "Regras de neg\xF3cio da PCM (Plataforma de Coleta de M\xE9tricas) do Open Finance Brasil, extra\xEDdas das p\xE1ginas Confluence: Especifica\xE7\xE3o T\xE9cnica, Reporte, Processamento, Diverg\xEAncias e Manual de Integra\xE7\xE3o. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  description: "Regras de neg\xF3cio da PCM (Plataforma de Coleta de M\xE9tricas) do Open Finance Brasil \u2014 como funcionam reporte, processamento, fechamento e diverg\xEAncias \u2014, extra\xEDdas das p\xE1ginas Confluence: Especifica\xE7\xE3o T\xE9cnica, Reporte, Processamento, Diverg\xEAncias e Manual de Integra\xE7\xE3o. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. Outras facetas da PCM: o swagger dos endpoints de reporte em pcm-openapi; as tabelas de obrigatoriedade do campo additionalInfo em pcm-additional-info. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
   confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
   interRequestDelayMs: 2e3,
   retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
@@ -735,7 +842,7 @@ var pcmBusinessRulesDomain = createConfluenceSectionsDomain(pcmBusinessRulesConf
 var jornadaOtimizadaConfig = {
   id: "jornada-otimizada",
   title: "Jornada Otimizada",
-  description: "Conhecimento regulat\xF3rio da Jornada Otimizada do Open Finance Brasil, extra\xEDdo das p\xE1ginas Confluence: Jornada Otimizada (introdu\xE7\xE3o), Orienta\xE7\xF5es Gerais, Transfer\xEAncias Inteligentes e Jornada sem Redirecionamento. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
+  description: "Conhecimento regulat\xF3rio da Jornada Otimizada do Open Finance Brasil, extra\xEDdo das p\xE1ginas Confluence: Jornada Otimizada (introdu\xE7\xE3o), Orienta\xE7\xF5es Gerais, Transfer\xEAncias Inteligentes e Jornada sem Redirecionamento. Recorte da Jornada Otimizada; o guia de implementa\xE7\xE3o hom\xF4nimo de Transfer\xEAncias Inteligentes, sob Servi\xE7os (SV), est\xE1 em payments-implementation-guides. Cada item \xE9 uma se\xE7\xE3o (heading) da p\xE1gina. search devolve um snippet do conte\xFAdo; use get_item para o texto completo da se\xE7\xE3o.",
   confluenceBaseUrl: "https://openfinancebrasil.atlassian.net",
   interRequestDelayMs: 2e3,
   retryDelaysMs: [2e3, 4e3, 8e3, 16e3],
@@ -865,7 +972,7 @@ var participantesDomain = {
   id: participantesConfig.id,
   title: participantesConfig.title,
   description: participantesConfig.description,
-  ttlHours: 24,
+  ttlHours: 72,
   filters: [
     { name: "name", description: "Substring no nome da organiza\xE7\xE3o ou na marca (CustomerFriendlyName)" },
     { name: "api", description: "Substring na fam\xEDlia de API (ex.: payments, automatic-payments)" },
@@ -971,8 +1078,13 @@ var domains = [
   pcmDomain,
   paymentsDomain,
   paymentsV5Domain,
+  paymentsV5BusinessRulesDomain,
   enrollmentsV2Domain,
+  enrollmentsV2BusinessRulesDomain,
   automaticPaymentsV2Domain,
+  automaticPaymentsV2BusinessRulesDomain,
+  paymentsCommonRulesDomain,
+  paymentsImplementationGuidesDomain,
   consentsV3Domain,
   pcmOpenapiDomain,
   pcmBusinessRulesDomain,
@@ -1168,7 +1280,7 @@ function createServer() {
     "refresh",
     {
       title: "Re-extrair fontes",
-      description: "For\xE7a re-extra\xE7\xE3o das fontes p\xFAblicas (ignora o TTL de 24h do cache). Sem `domain`, atualiza todos. Use quando suspeitar de dados desatualizados.",
+      description: "For\xE7a re-extra\xE7\xE3o das fontes p\xFAblicas (ignora o TTL de 72h do cache). Sem `domain`, atualiza todos. Use quando suspeitar de dados desatualizados.",
       inputSchema: {
         domain: domainIdSchema.optional().describe("Id do dom\xEDnio; omita para todos")
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opf-br-mcp",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "MCP server local com as regras do Open Finance Brasil (PCM additionalInfo, specs OpenAPI de Pagamentos)",
   "type": "module",
   "license": "MIT",
@@ -35,7 +35,8 @@
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run build && npm test"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.0",