euparliamentmonitor 0.8.36 → 0.8.39

package/README.md

@@ -124,7 +124,7 @@ import {
 
 **MCP Server Integration**: The project uses the
 [European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server)
-v1.2.9 for accessing real EU Parliament data via the Model Context Protocol.
+v1.2.10 for accessing real EU Parliament data via the Model Context Protocol.
 
 - **MCP Server Status**: ✅ Fully operational — 60+ EP data tools available
   (feeds, direct lookups, analytical tools, intelligence correlation)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.36",
+  "version": "0.8.39",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -171,7 +171,7 @@
     "node": ">=25"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.2.9"
+    "european-parliament-mcp-server": "1.2.10"
   },
   "optionalDependencies": {
     "worldbank-mcp": "1.0.1"

package/scripts/generators/pipeline/fetch-stage.d.ts

@@ -271,40 +271,42 @@ export declare function fetchMEPsFeedWithTotal(client: EuropeanParliamentMCPClie
 }>;
 /**
  * Fetch documents feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * The underlying EP MCP `get_documents_feed` tool serves a server-defined
+ * fixed window and ignores any `timeframe` parameter; the parameter is kept
+ * on this function's signature for backwards compatibility with callers.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of document feed items
  */
-export declare function fetchDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
+export declare function fetchDocumentsFeed(client: EuropeanParliamentMCPClient | null, _timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch plenary documents feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * Fixed-window feed; `timeframe` is ignored by the server.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of document feed items
  */
-export declare function fetchPlenaryDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
+export declare function fetchPlenaryDocumentsFeed(client: EuropeanParliamentMCPClient | null, _timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch committee documents feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * Fixed-window feed; `timeframe` is ignored by the server.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of document feed items
  */
-export declare function fetchCommitteeDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
+export declare function fetchCommitteeDocumentsFeed(client: EuropeanParliamentMCPClient | null, _timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch plenary session documents feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * Fixed-window feed; `timeframe` is ignored by the server.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of document feed items
  */
-export declare function fetchPlenarySessionDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
+export declare function fetchPlenarySessionDocumentsFeed(client: EuropeanParliamentMCPClient | null, _timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch external documents feed from MCP.
  * Falls back to a wider timeframe when the initial timeframe returns no data.
@@ -316,13 +318,13 @@ export declare function fetchPlenarySessionDocumentsFeed(client: EuropeanParliam
 export declare function fetchExternalDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch parliamentary questions feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * Fixed-window feed; `timeframe` is ignored by the server.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of question feed items
  */
-export declare function fetchQuestionsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<QuestionFeedItem[]>;
+export declare function fetchQuestionsFeed(client: EuropeanParliamentMCPClient | null, _timeframe?: FeedTimeframe): Promise<QuestionFeedItem[]>;
 /**
  * Fetch MEP declarations feed from MCP.
  *
@@ -334,11 +336,17 @@ export declare function fetchDeclarationsFeed(client: EuropeanParliamentMCPClien
 /**
  * Fetch corporate bodies feed from MCP.
  *
+ * `_timeframe` is retained only for signature compatibility with sliding-window
+ * fetchers (so the shared `fetchEPFeedData` orchestrator can dispatch uniformly);
+ * the EP MCP server serves a server-defined fixed window for this feed and
+ * ignores any timeframe input (as of v1.2.10; pre-v1.2.10 it rejected with
+ * `INVALID_PARAMS` — see Hack23/European-Parliament-MCP-Server#377).
+ *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Ignored by the server; kept for signature compatibility
  * @returns Array of corporate body feed items
  */
-export declare function fetchCorporateBodiesFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<CorporateBodyFeedItem[]>;
+export declare function fetchCorporateBodiesFeed(client: EuropeanParliamentMCPClient | null, _timeframe?: FeedTimeframe): Promise<CorporateBodyFeedItem[]>;
 /**
  * Fetch all EP feed data for breaking news articles.
  * Calls adopted texts, events, procedures, and MEPs feeds in parallel.

package/scripts/generators/pipeline/fetch-stage.js

@@ -1084,6 +1084,32 @@ class UpstreamTimeoutError extends Error {
         this.name = 'UpstreamTimeoutError';
     }
 }
+/**
+ * Error thrown when the EP MCP server returns a response indicating the feed
+ * is unavailable (uniform `{status:"unavailable"}` envelope or the legacy raw
+ * upstream 404 envelope historically emitted pre-v1.2.10). Distinct from
+ * {@link UpstreamTimeoutError} so logs/diagnostics do not misattribute a
+ * 404/unavailable response to a timeout. Shares the same control-flow role —
+ * callers treat it as "stop the timeframe-widening retry loop and return the
+ * empty sentinel".
+ */
+class FeedUnavailableError extends Error {
+    constructor(toolName) {
+        super(`EP MCP feed unavailable for ${toolName} — treating as known-empty`);
+        this.name = 'FeedUnavailableError';
+    }
+}
+/**
+ * Type guard: returns `true` for either error type that should stop the
+ * timeframe-widening retry loop ({@link UpstreamTimeoutError} or
+ * {@link FeedUnavailableError}).
+ *
+ * @param error - Caught error value
+ * @returns `true` when the caller should stop retrying and return the empty sentinel
+ */
+function isStopRetryError(error) {
+    return error instanceof UpstreamTimeoutError || error instanceof FeedUnavailableError;
+}
 /**
  * Check whether a parsed MCP response envelope indicates an upstream timeout
  * and throw {@link UpstreamTimeoutError} if so.  The EP MCP server returns
@@ -1105,6 +1131,26 @@ function checkUpstreamTimeout(value) {
             'Consider using year-based endpoints as fallback.');
         throw new UpstreamTimeoutError(toolName);
     }
+    // Defensive detection of the legacy raw upstream 404 shape that pre-v1.2.10
+    // get_events_feed / get_procedures_feed emitted
+    // (Hack23/European-Parliament-MCP-Server#378, closed by PR #380 in
+    // v1.2.10). Shape:
+    //   {"@id":"https://data.europarl.europa.eu/eli/dl/...", "error":"404 N..."}
+    // Treated identically to the uniform `{status:"unavailable"}` envelope —
+    // i.e. stop timeframe-widening retry loops instead of silently returning [].
+    // Retained as belt-and-braces so older pinned server versions (or any future
+    // regression) do not bypass the NOT_FOUND bookkeeping done by the EP MCP
+    // client's safeCallTool.
+    const idField = envelope['@id'];
+    const errorField = envelope['error'];
+    if (typeof idField === 'string' &&
+        idField.startsWith('https://data.europarl.europa.eu/') &&
+        typeof errorField === 'string' &&
+        errorField.includes('404')) {
+        console.warn(`${WARN_PREFIX} EP MCP returned raw upstream 404 shape — treating feed as unavailable ` +
+            '(upstream #378). This should have been caught earlier as a NOT_FOUND failure.');
+        throw new FeedUnavailableError('raw_404_envelope');
+    }
 }
 /**
  * Handle errors from feed-fetching functions with timeframe-widening logic.
@@ -1118,7 +1164,7 @@ function checkUpstreamTimeout(value) {
  * @returns A wider {@link FeedTimeframe} to retry, or `undefined` to stop
  */
 function handleFeedFetchError(error, tf, toolName) {
-    if (error instanceof UpstreamTimeoutError)
+    if (isStopRetryError(error))
         return undefined;
     const message = error instanceof Error ? error.message : String(error);
     const wider = getWiderTimeframe(tf);
@@ -1378,152 +1424,101 @@ export async function fetchMEPsFeedWithTotal(client, timeframe = 'one-week') {
         return { items, total };
     }
     catch (error) {
-        if (error instanceof UpstreamTimeoutError)
+        if (isStopRetryError(error))
             return { items: [], total: 0 };
         const message = error instanceof Error ? error.message : String(error);
         console.warn(`${WARN_PREFIX} get_meps_feed failed:`, message);
         return { items: [], total: 0 };
     }
 }
+/**
+ * Fetch a fixed-window EP API v2 feed that ignores the `timeframe` parameter.
+ *
+ * The EP MCP server splits feed tools into two groups — sliding-window feeds
+ * accept `timeframe`/`startDate`, fixed-window feeds (documents,
+ * plenary_documents, committee_documents, plenary_session_documents,
+ * parliamentary_questions, corporate_bodies, controlled_vocabularies) serve a
+ * server-defined window. As of v1.2.10 the server silently ignores
+ * `timeframe`/`startDate` on fixed-window tools
+ * (Hack23/European-Parliament-MCP-Server#379); pre-v1.2.10 it rejected them
+ * with `INVALID_PARAMS` (#377). This helper issues a single RPC either way —
+ * there is no point in timeframe-widening retry loops because the server does
+ * not narrow/widen results based on timeframe.
+ *
+ * @param client - MCP client (null returns `[]`)
+ * @param toolName - Tool name for log messages
+ * @param callFn - Callback that issues the feed RPC
+ * @returns Array of mapped feed items (may be empty)
+ */
+async function fetchFixedWindowFeed(client, toolName, callFn) {
+    if (!client)
+        return [];
+    try {
+        console.log(`${MCP_FETCH_PREFIX} Fetching ${toolName}...`);
+        const result = await callMCP(callFn, undefined, toolName);
+        return parseFeedResult(result).map((item) => mapFeedItemBase(item));
+    }
+    catch (error) {
+        if (isStopRetryError(error))
+            return [];
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`${WARN_PREFIX} ${toolName} failed:`, message);
+        return [];
+    }
+}
 /**
  * Fetch documents feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * The underlying EP MCP `get_documents_feed` tool serves a server-defined
+ * fixed window and ignores any `timeframe` parameter; the parameter is kept
+ * on this function's signature for backwards compatibility with callers.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of document feed items
  */
-export async function fetchDocumentsFeed(client, timeframe = 'one-week') {
-    if (!client)
-        return [];
-    let currentTimeframe = timeframe;
-    while (currentTimeframe) {
-        const tf = currentTimeframe;
-        try {
-            console.log(`${MCP_FETCH_PREFIX} Fetching documents feed (${currentTimeframe})...`);
-            const result = await callMCP(() => client.getDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_documents_feed');
-            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
-            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
-                return items;
-            console.log(`${INFO_PREFIX} documents feed empty for ${currentTimeframe}, widening timeframe...`);
-            currentTimeframe = getWiderTimeframe(currentTimeframe);
-        }
-        catch (error) {
-            const wider = handleFeedFetchError(error, tf, 'get_documents_feed');
-            if (wider) {
-                currentTimeframe = wider;
-            }
-            else {
-                return [];
-            }
-        }
-    }
-    return [];
+export async function fetchDocumentsFeed(client, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_timeframe = 'one-week') {
+    return fetchFixedWindowFeed(client, 'get_documents_feed', () => client.getDocumentsFeed({ limit: 20 }));
 }
 /**
  * Fetch plenary documents feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * Fixed-window feed; `timeframe` is ignored by the server.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of document feed items
  */
-export async function fetchPlenaryDocumentsFeed(client, timeframe = 'one-week') {
-    if (!client)
-        return [];
-    let currentTimeframe = timeframe;
-    while (currentTimeframe) {
-        const tf = currentTimeframe;
-        try {
-            console.log(`${MCP_FETCH_PREFIX} Fetching plenary documents feed (${currentTimeframe})...`);
-            const result = await callMCP(() => client.getPlenaryDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_plenary_documents_feed');
-            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
-            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
-                return items;
-            console.log(`${INFO_PREFIX} plenary documents feed empty for ${currentTimeframe}, widening timeframe...`);
-            currentTimeframe = getWiderTimeframe(currentTimeframe);
-        }
-        catch (error) {
-            const wider = handleFeedFetchError(error, tf, 'get_plenary_documents_feed');
-            if (wider) {
-                currentTimeframe = wider;
-            }
-            else {
-                return [];
-            }
-        }
-    }
-    return [];
+export async function fetchPlenaryDocumentsFeed(client, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_timeframe = 'one-week') {
+    return fetchFixedWindowFeed(client, 'get_plenary_documents_feed', () => client.getPlenaryDocumentsFeed({ limit: 20 }));
 }
 /**
  * Fetch committee documents feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * Fixed-window feed; `timeframe` is ignored by the server.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of document feed items
  */
-export async function fetchCommitteeDocumentsFeed(client, timeframe = 'one-week') {
-    if (!client)
-        return [];
-    let currentTimeframe = timeframe;
-    while (currentTimeframe) {
-        const tf = currentTimeframe;
-        try {
-            console.log(`${MCP_FETCH_PREFIX} Fetching committee documents feed (${currentTimeframe})...`);
-            const result = await callMCP(() => client.getCommitteeDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_committee_documents_feed');
-            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
-            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
-                return items;
-            console.log(`${INFO_PREFIX} committee documents feed empty for ${currentTimeframe}, widening timeframe...`);
-            currentTimeframe = getWiderTimeframe(currentTimeframe);
-        }
-        catch (error) {
-            const wider = handleFeedFetchError(error, tf, 'get_committee_documents_feed');
-            if (wider) {
-                currentTimeframe = wider;
-            }
-            else {
-                return [];
-            }
-        }
-    }
-    return [];
+export async function fetchCommitteeDocumentsFeed(client, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_timeframe = 'one-week') {
+    return fetchFixedWindowFeed(client, 'get_committee_documents_feed', () => client.getCommitteeDocumentsFeed({ limit: 20 }));
 }
 /**
  * Fetch plenary session documents feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * Fixed-window feed; `timeframe` is ignored by the server.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of document feed items
  */
-export async function fetchPlenarySessionDocumentsFeed(client, timeframe = 'one-week') {
-    if (!client)
-        return [];
-    let currentTimeframe = timeframe;
-    while (currentTimeframe) {
-        const tf = currentTimeframe;
-        try {
-            console.log(`${MCP_FETCH_PREFIX} Fetching plenary session documents feed (${currentTimeframe})...`);
-            const result = await callMCP(() => client.getPlenarySessionDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_plenary_session_documents_feed');
-            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
-            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
-                return items;
-            console.log(`${INFO_PREFIX} plenary session docs feed empty for ${currentTimeframe}, widening timeframe...`);
-            currentTimeframe = getWiderTimeframe(currentTimeframe);
-        }
-        catch (error) {
-            const wider = handleFeedFetchError(error, tf, 'get_plenary_session_documents_feed');
-            if (wider) {
-                currentTimeframe = wider;
-            }
-            else {
-                return [];
-            }
-        }
-    }
-    return [];
+export async function fetchPlenarySessionDocumentsFeed(client, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_timeframe = 'one-week') {
+    return fetchFixedWindowFeed(client, 'get_plenary_session_documents_feed', () => client.getPlenarySessionDocumentsFeed({ limit: 20 }));
 }
 /**
  * Fetch external documents feed from MCP.
@@ -1562,38 +1557,16 @@ export async function fetchExternalDocumentsFeed(client, timeframe = 'one-week')
 }
 /**
  * Fetch parliamentary questions feed from MCP.
- * Falls back to a wider timeframe when the initial timeframe returns no data.
+ * Fixed-window feed; `timeframe` is ignored by the server.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Retained for signature compatibility (ignored by the server)
  * @returns Array of question feed items
  */
-export async function fetchQuestionsFeed(client, timeframe = 'one-week') {
-    if (!client)
-        return [];
-    let currentTimeframe = timeframe;
-    while (currentTimeframe) {
-        const tf = currentTimeframe;
-        try {
-            console.log(`${MCP_FETCH_PREFIX} Fetching parliamentary questions feed (${currentTimeframe})...`);
-            const result = await callMCP(() => client.getParliamentaryQuestionsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_parliamentary_questions_feed');
-            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
-            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
-                return items;
-            console.log(`${INFO_PREFIX} questions feed empty for ${currentTimeframe}, widening timeframe...`);
-            currentTimeframe = getWiderTimeframe(currentTimeframe);
-        }
-        catch (error) {
-            const wider = handleFeedFetchError(error, tf, 'get_parliamentary_questions_feed');
-            if (wider) {
-                currentTimeframe = wider;
-            }
-            else {
-                return [];
-            }
-        }
-    }
-    return [];
+export async function fetchQuestionsFeed(client, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_timeframe = 'one-week') {
+    return fetchFixedWindowFeed(client, 'get_parliamentary_questions_feed', () => client.getParliamentaryQuestionsFeed({ limit: 20 }));
 }
 /**
  * Fetch MEP declarations feed from MCP.
@@ -1611,7 +1584,7 @@ export async function fetchDeclarationsFeed(client, timeframe = 'one-week') {
         return parseFeedResult(result).map((item) => mapFeedItemBase(item));
     }
     catch (error) {
-        if (error instanceof UpstreamTimeoutError)
+        if (isStopRetryError(error))
             return [];
         const message = error instanceof Error ? error.message : String(error);
         console.warn(`${WARN_PREFIX} get_mep_declarations_feed failed:`, message);
@@ -1621,20 +1594,28 @@ export async function fetchDeclarationsFeed(client, timeframe = 'one-week') {
 /**
  * Fetch corporate bodies feed from MCP.
  *
+ * `_timeframe` is retained only for signature compatibility with sliding-window
+ * fetchers (so the shared `fetchEPFeedData` orchestrator can dispatch uniformly);
+ * the EP MCP server serves a server-defined fixed window for this feed and
+ * ignores any timeframe input (as of v1.2.10; pre-v1.2.10 it rejected with
+ * `INVALID_PARAMS` — see Hack23/European-Parliament-MCP-Server#377).
+ *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-week')
+ * @param _timeframe - Ignored by the server; kept for signature compatibility
  * @returns Array of corporate body feed items
  */
-export async function fetchCorporateBodiesFeed(client, timeframe = 'one-week') {
+export async function fetchCorporateBodiesFeed(client, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_timeframe = 'one-week') {
     if (!client)
         return [];
     try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching corporate bodies feed (${timeframe})...`);
-        const result = await callMCP(() => client.getCorporateBodiesFeed({ timeframe, limit: 20 }), undefined, 'get_corporate_bodies_feed');
+        console.log(`${MCP_FETCH_PREFIX} Fetching corporate bodies feed (fixed window)...`);
+        const result = await callMCP(() => client.getCorporateBodiesFeed({ limit: 20 }), undefined, 'get_corporate_bodies_feed');
         return parseFeedResult(result).map((item) => mapFeedItemBase(item));
     }
     catch (error) {
-        if (error instanceof UpstreamTimeoutError)
+        if (isStopRetryError(error))
             return [];
         const message = error instanceof Error ? error.message : String(error);
         console.warn(`${WARN_PREFIX} get_corporate_bodies_feed failed:`, message);

package/scripts/index.d.ts

@@ -37,6 +37,7 @@ export * from './types/index.js';
 export { MCPConnection, MCPSessionExpiredError, MCPRateLimitError, isRetriableError, formatRetryAfter, parseSSEResponse, } from './mcp/mcp-connection.js';
 export { EuropeanParliamentMCPClient, getEPMCPClient, closeEPMCPClient, } from './mcp/ep-mcp-client.js';
 export { WorldBankMCPClient, getWBMCPClient, closeWBMCPClient } from './mcp/wb-mcp-client.js';
+export { IMFMCPClient, IMF_MCP_TOOLS, getIMFMCPClient, closeIMFMCPClient, } from './mcp/imf-mcp-client.js';
 export { type CircuitState, type CircuitBreakerOptions, CircuitBreaker, type MCPRetryPolicy, withRetry, } from './mcp/mcp-retry.js';
 export { type ToolHealthEntry, type HealthSnapshot, MCPHealthMonitor } from './mcp/mcp-health.js';
 export { scoreVotingAnomaly, analyzeCoalitionCohesion, scoreMEPInfluence, calculateLegislativeVelocity, rankBySignificance, buildIntelligenceSection, buildDefaultStakeholderPerspectives, scoreStakeholderInfluence, buildStakeholderOutcomeMatrix, rankStakeholdersByInfluence, computeVotingIntensity, detectCoalitionShifts, computePolarizationIndex, detectVotingTrends, computeCrossSessionCoalitionStability, rankMEPInfluenceByTopic, buildLegislativeVelocityReport, } from './utils/intelligence-analysis.js';
@@ -45,6 +46,7 @@ export { assessAnalysisDepth, assessStakeholderCoverage, assessVisualizationQual
 export { scoreSignificance, scoreBatch, clampScore, deriveDecision, formatScoreMarkdown, formatBatchMarkdown, WEIGHT_PARLIAMENTARY, WEIGHT_POLICY, WEIGHT_PUBLIC_INTEREST, WEIGHT_URGENCY, WEIGHT_INSTITUTIONAL, THRESHOLD_PUBLISH, THRESHOLD_HOLD, } from './utils/significance-scoring.js';
 export { parseFrontmatter, aggregateSWOT, aggregateRisks, extractSummaryLine, aggregateConfidence, findMarkdownFiles, generateEditorialRecommendations, buildSynthesisSummary, formatSynthesisMarkdown, } from './generators/synthesis-summary.js';
 export { validateArticleContent, validateTranslationCompleteness, } from './utils/content-validator.js';
+export { WORLD_BANK_STRONG_FINGERPRINTS, WORLD_BANK_INDICATOR_CODES, WORLD_BANK_FINGERPRINTS, hasWorldBankEvidence, articlePolicyHasWorldBank, IMF_STRONG_FINGERPRINTS, IMF_INDICATOR_CODES, hasIMFEvidence, articlePolicyHasEconomicContext, } from './utils/content-validator.js';
 export { enrichMetadataFromContent } from './utils/content-metadata.js';
 export { buildMetadataDatabase, writeMetadataDatabase, readMetadataDatabase, updateMetadataDatabase, updateIntelligenceIndex, } from './utils/news-metadata.js';
 export { pl, pl as pluralizeCount } from './utils/metadata-utils.js';
@@ -53,6 +55,7 @@ export { stripHtmlTags, stripScriptBlocks } from './utils/html-sanitize.js';
 export { parseArticleFilename, formatSlug, calculateReadTime, escapeHTML, isSafeURL, validateArticleHTML, type ArticleValidationResult, } from './utils/file-utils.js';
 export { detectCategory } from './utils/article-category.js';
 export { EU_COUNTRY_CODES, EU_AGGREGATE_CODE, COMPARISON_COUNTRIES, WB_AGGREGATE_LABELS, POLICY_INDICATORS, parseWorldBankCSV, formatIndicatorValue, getMostRecentValue, buildEconomicContext, getWorldBankCountryCode, isEUMemberState, buildEconomicContextHTML, } from './utils/world-bank-data.js';
+export { IMF_EU_COUNTRY_CODES, IMF_COUNTRY_CODE_OVERRIDES, IMF_EURO_AREA_CODE, IMF_AGGREGATE_LABELS, IMF_POLICY_INDICATORS, IMF_INDICATOR_SDMX_CODES, getIMFCountryCode, isIMFEUMemberState, parseSDMXJSON, getMostRecentObservation, getForecastPoints, formatIMFValue, buildIMFEconomicContext, buildIMFEconomicContextHTML, } from './utils/imf-data.js';
 export { generateArticleHTML } from './templates/article-template.js';
 export { computeArticleQualityScore, buildTableOfContents, buildQualityScoreBadge, } from './templates/section-builders.js';
 export { ALL_LANGUAGES, LANGUAGE_PRESETS, LANGUAGE_FLAGS, LANGUAGE_NAMES, getLocalizedString, isSupportedLanguage, getTextDirection, } from './constants/language-core.js';

package/scripts/index.js

@@ -41,6 +41,7 @@ export * from './types/index.js';
 export { MCPConnection, MCPSessionExpiredError, MCPRateLimitError, isRetriableError, formatRetryAfter, parseSSEResponse, } from './mcp/mcp-connection.js';
 export { EuropeanParliamentMCPClient, getEPMCPClient, closeEPMCPClient, } from './mcp/ep-mcp-client.js';
 export { WorldBankMCPClient, getWBMCPClient, closeWBMCPClient } from './mcp/wb-mcp-client.js';
+export { IMFMCPClient, IMF_MCP_TOOLS, getIMFMCPClient, closeIMFMCPClient, } from './mcp/imf-mcp-client.js';
 export { CircuitBreaker, withRetry, } from './mcp/mcp-retry.js';
 export { MCPHealthMonitor } from './mcp/mcp-health.js';
 // ─── Intelligence Analysis ───────────────────────────────────────────────────
@@ -55,6 +56,8 @@ export { scoreSignificance, scoreBatch, clampScore, deriveDecision, formatScoreM
 export { parseFrontmatter, aggregateSWOT, aggregateRisks, extractSummaryLine, aggregateConfidence, findMarkdownFiles, generateEditorialRecommendations, buildSynthesisSummary, formatSynthesisMarkdown, } from './generators/synthesis-summary.js';
 // ─── Content Validation ──────────────────────────────────────────────────────
 export { validateArticleContent, validateTranslationCompleteness, } from './utils/content-validator.js';
+// ─── Economic-context evidence helpers (Wave 1 dual-source) ──────────────────
+export { WORLD_BANK_STRONG_FINGERPRINTS, WORLD_BANK_INDICATOR_CODES, WORLD_BANK_FINGERPRINTS, hasWorldBankEvidence, articlePolicyHasWorldBank, IMF_STRONG_FINGERPRINTS, IMF_INDICATOR_CODES, hasIMFEvidence, articlePolicyHasEconomicContext, } from './utils/content-validator.js';
 // ─── Content Metadata ────────────────────────────────────────────────────────
 export { enrichMetadataFromContent } from './utils/content-metadata.js';
 // ─── News Metadata ───────────────────────────────────────────────────────────
@@ -70,6 +73,8 @@ export { parseArticleFilename, formatSlug, calculateReadTime, escapeHTML, isSafe
 export { detectCategory } from './utils/article-category.js';
 // ─── World Bank Data Utilities ───────────────────────────────────────────────
 export { EU_COUNTRY_CODES, EU_AGGREGATE_CODE, COMPARISON_COUNTRIES, WB_AGGREGATE_LABELS, POLICY_INDICATORS, parseWorldBankCSV, formatIndicatorValue, getMostRecentValue, buildEconomicContext, getWorldBankCountryCode, isEUMemberState, buildEconomicContextHTML, } from './utils/world-bank-data.js';
+// ─── IMF Data Utilities ──────────────────────────────────────────────────────
+export { IMF_EU_COUNTRY_CODES, IMF_COUNTRY_CODE_OVERRIDES, IMF_EURO_AREA_CODE, IMF_AGGREGATE_LABELS, IMF_POLICY_INDICATORS, IMF_INDICATOR_SDMX_CODES, getIMFCountryCode, isIMFEUMemberState, parseSDMXJSON, getMostRecentObservation, getForecastPoints, formatIMFValue, buildIMFEconomicContext, buildIMFEconomicContextHTML, } from './utils/imf-data.js';
 // ─── Templates ───────────────────────────────────────────────────────────────
 export { generateArticleHTML } from './templates/article-template.js';
 export { computeArticleQualityScore, buildTableOfContents, buildQualityScoreBadge, } from './templates/section-builders.js';