euparliamentmonitor 0.8.20 → 0.8.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.20",
+  "version": "0.8.22",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -140,8 +140,8 @@
     "@types/d3": "7.4.3",
     "@types/node": "25.5.2",
     "@types/papaparse": "5.5.2",
-    "@typescript-eslint/eslint-plugin": "8.58.0",
-    "@typescript-eslint/parser": "8.58.0",
+    "@typescript-eslint/eslint-plugin": "8.58.1",
+    "@typescript-eslint/parser": "8.58.1",
     "@vitest/coverage-v8": "4.1.3",
     "@vitest/ui": "4.1.3",
     "chart.js": "4.5.1",
@@ -169,7 +169,7 @@
     "node": ">=25"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.1.28"
+    "european-parliament-mcp-server": "1.2.0"
   },
   "optionalDependencies": {
     "worldbank-mcp": "1.0.1"

package/scripts/generators/news-enhanced.d.ts

@@ -11,4 +11,16 @@ export { applyCommitteeInfo, applyDocuments, applyEffectiveness, FEATURED_COMMIT
 export { PLACEHOLDER_MARKER, getMotionsFallbackData, generateMotionsContent, buildPoliticalAlignmentSection, };
 export { buildPropositionsContent };
 export type { PipelineData };
+/**
+ * AI-generated article title passed by the agentic workflow.
+ * When provided, this OVERRIDES any script-generated title.
+ * The AI agent (Opus 4.6) must analyse the content and produce this.
+ */
+export declare const aiTitle: string;
+/**
+ * AI-generated article description/subtitle passed by the agentic workflow.
+ * When provided, this OVERRIDES any script-generated description.
+ * The AI agent (Opus 4.6) must analyse the content and produce this.
+ */
+export declare const aiDescription: string;
 //# sourceMappingURL=news-enhanced.d.ts.map

package/scripts/generators/news-enhanced.js

@@ -11,7 +11,7 @@
  *
  * When the `--analysis` flag is supplied (all 9 agentic workflows do this),
  * the analysis stage runs **before** article generation, producing structured
- * political intelligence artifacts under `analysis/{date}/{article-type}/`.  These
+ * political intelligence artifacts under `analysis/daily/{date}/{article-type}/`.  These
  * artifacts are committed to the repository for review and improvement.
  *
  * Pipeline stages:
@@ -45,7 +45,7 @@ import { closeEPMCPClient } from '../mcp/ep-mcp-client.js';
 import { ensureDirectoryExists } from '../utils/file-utils.js';
 // ─── Pipeline-stage imports ───────────────────────────────────────────────────
 import { initializeMCPClient, fetchEPFeedData } from './pipeline/fetch-stage.js';
-import { createStrategyRegistry, generateArticleForStrategy } from './pipeline/generate-stage.js';
+import { createStrategyRegistry, generateArticleForStrategy, setAIMetadata, } from './pipeline/generate-stage.js';
 import { writeGenerationMetadata } from './pipeline/output-stage.js';
 import { runAnalysisStage, ALL_ANALYSIS_METHODS, VALID_ANALYSIS_METHODS, hasSubstantiveData, deriveArticleTypeSlug, } from './pipeline/analysis-stage.js';
 // ─── Content-module imports (bounded contexts) ───────────────────────────────
@@ -73,6 +73,22 @@ const analysisOnlyArg = args.includes('--analysis-only');
 const analysisVerboseArg = args.includes('--analysis-verbose');
 const analysisDirArg = args.find((arg) => arg.startsWith('--analysis-dir='));
 const analysisMethodsArg = args.find((arg) => arg.startsWith('--analysis-methods='));
+const titleArg = args.find((arg) => arg.startsWith('--title='));
+const descriptionArg = args.find((arg) => arg.startsWith('--description='));
+/**
+ * AI-generated article title passed by the agentic workflow.
+ * When provided, this OVERRIDES any script-generated title.
+ * The AI agent (Opus 4.6) must analyse the content and produce this.
+ */
+export const aiTitle = titleArg ? titleArg.slice('--title='.length).trim() : '';
+/**
+ * AI-generated article description/subtitle passed by the agentic workflow.
+ * When provided, this OVERRIDES any script-generated description.
+ * The AI agent (Opus 4.6) must analyse the content and produce this.
+ */
+export const aiDescription = descriptionArg
+    ? descriptionArg.slice('--description='.length).trim()
+    : '';
 /** Path to a JSON file containing pre-fetched EP feed data (optional). */
 const feedDataPath = feedDataArg?.startsWith('--feed-data=')
     ? feedDataArg.slice('--feed-data='.length).trim()
@@ -177,7 +193,7 @@ function parseAnalysisMethods() {
  * Run the optional analysis stage (Fetch → Analysis) before article generation.
  *
  * This function is **side-effect-only**: it writes analysis markdown and a
- * `manifest.json` to disk under `analysis/{date}/{article-type}/`.  The returned
+ * `manifest.json` to disk under `analysis/daily/{date}/{article-type}/`.  The returned
  * {@link AnalysisContext} is informational; strategies read analysis output
  * from disk rather than consuming the context object in-memory.  Analysis
  * artifacts are committed to the repository for review and political
@@ -203,7 +219,7 @@ async function maybeRunAnalysis(date, client) {
     const trimmedAnalysisDirBase = rawAnalysisDirBase?.trim();
     const analysisDirBase = trimmedAnalysisDirBase && trimmedAnalysisDirBase.length > 0
         ? trimmedAnalysisDirBase
-        : 'analysis';
+        : 'analysis/daily';
     const enabledMethods = parseAnalysisMethods();
     console.log('');
     console.log('🔬 Running analysis stage...');
@@ -332,6 +348,20 @@ async function runAnalysisWithGuard(date, client) {
     }
     return analysisCtx;
 }
+/**
+ * Wire AI-provided title/description from CLI `--title` and `--description` flags.
+ * The AI agent (Opus 4.6) passes these after analysing the content.
+ * They override ALL script-generated metadata for the English version.
+ */
+function wireAIMetadata() {
+    if (aiTitle || aiDescription) {
+        setAIMetadata(aiTitle, aiDescription);
+        if (aiTitle)
+            console.log(`📝 AI-provided title: "${aiTitle}"`);
+        if (aiDescription)
+            console.log(`📝 AI-provided description: "${aiDescription}"`);
+    }
+}
 /**
  * Main execution: initialise the MCP client, optionally run analysis stage,
  * iterate over requested article types, delegate to the appropriate strategy,
@@ -341,6 +371,8 @@ async function main() {
     console.log('');
     console.log('🚀 Starting news generation...');
     console.log('');
+    // Wire AI-provided title/description from CLI flags.
+    wireAIMetadata();
     // When --feed-data is provided, expose the path via env so strategies can
     // load pre-fetched data without requiring a live MCP connection.
     if (feedDataPath) {
@@ -362,7 +394,7 @@ async function main() {
         // Expose analysis dir/slug via env vars so strategies can locate analysis
         // artifacts without hard-coding paths.  Follows the EP_FEED_DATA_FILE pattern.
         if (analysisCtx) {
-            // Base dir: parent of date-scoped dir (e.g. 'analysis' from 'analysis/2026-04-06/breaking')
+            // Base dir: parent of date-scoped dir (e.g. 'analysis/daily' from 'analysis/daily/2026-04-06/breaking')
             const analysisOutputParent = path.dirname(analysisCtx.outputDir);
             const analysisBaseDir = path.dirname(analysisOutputParent);
             process.env['EP_ANALYSIS_DIR'] = analysisBaseDir;

package/scripts/generators/pipeline/analysis-classification.js

@@ -34,12 +34,77 @@ const EVENT_PUBLIC_LOW = 3;
 const EVENT_DEFAULT_URGENCY = 5;
 const EVENT_INSTITUTIONAL_HIGH = 7;
 const EVENT_INSTITUTIONAL_LOW = 4;
-/** Default dimension scores for adopted texts (plenary-approved) */
-const ADOPTED_PARLIAMENTARY = 7;
-const ADOPTED_POLICY = 6;
-const ADOPTED_PUBLIC = 5;
-const ADOPTED_URGENCY = 4;
-const ADOPTED_INSTITUTIONAL = 6;
+/** Base dimension scores for adopted texts (plenary-approved) */
+const ADOPTED_PARLIAMENTARY_BASE = 6;
+const ADOPTED_POLICY_BASE = 5;
+const ADOPTED_PUBLIC_BASE = 4;
+const ADOPTED_URGENCY_BASE = 3;
+const ADOPTED_INSTITUTIONAL_BASE = 5;
+// ─── Content-aware scoring keywords for adopted text differentiation ──────────
+/** Title keywords indicating high-impact legislative texts (directives, regulations) */
+const HIGH_IMPACT_TITLE_KEYWORDS = /\b(?:directive|regulation|regulation\s+\(eu\)|codecision|ordinary\s+legislative|COD|budget|defence|security|tariff|anti-corruption|banking|single\s+market)\b/i;
+/** Title keywords indicating moderate-impact texts */
+const MODERATE_IMPACT_TITLE_KEYWORDS = /\b(?:resolution|decision|recommendation|amendment|framework|strategy|agreement|trade|environment|climate|digital|data\s+protection|consumer|health)\b/i;
+/** Procedure references indicating ordinary legislative procedure (highest significance) */
+const COD_PROCEDURE_PATTERN = /\bCOD\b|\b\d{4}\/\d{4}\(COD\)/i;
+/** Pattern for recent EP10 adopted texts (current term) */
+const EP10_ADOPTED_TEXT_PATTERN = /TA-10-202[5-9]/i;
+/**
+ * Score an adopted text based on its actual content metadata.
+ *
+ * Analyses the title, reference, and any procedure type information to
+ * produce differentiated scores rather than flat constants. High-impact
+ * legislative texts (directives, regulations, COD procedures) score higher
+ * than routine administrative texts.
+ *
+ * @param title - Adopted text title or label
+ * @param reference - EP reference identifier
+ * @param workType - Optional work type field from EP data
+ * @param procedureReference - Optional procedure reference
+ * @returns Per-dimension scoring input
+ */
+function scoreAdoptedText(title, reference, workType, procedureReference) {
+    let parliamentary = ADOPTED_PARLIAMENTARY_BASE;
+    let policy = ADOPTED_POLICY_BASE;
+    let publicInterest = ADOPTED_PUBLIC_BASE;
+    let urgency = ADOPTED_URGENCY_BASE;
+    let institutional = ADOPTED_INSTITUTIONAL_BASE;
+    const combined = [title, reference, workType, procedureReference].filter(Boolean).join(' ');
+    // Boost for high-impact legislative keywords
+    if (HIGH_IMPACT_TITLE_KEYWORDS.test(combined)) {
+        parliamentary += 2;
+        policy += 2;
+        publicInterest += 2;
+        institutional += 2;
+    }
+    else if (MODERATE_IMPACT_TITLE_KEYWORDS.test(combined)) {
+        parliamentary += 1;
+        policy += 1;
+        publicInterest += 1;
+        institutional += 1;
+    }
+    // Boost for ordinary legislative procedure (COD) — highest parliamentary significance
+    if (COD_PROCEDURE_PATTERN.test(combined)) {
+        parliamentary += 1;
+        policy += 1;
+    }
+    // Boost urgency for current-term (EP10) adopted texts
+    if (EP10_ADOPTED_TEXT_PATTERN.test(reference)) {
+        urgency += 2;
+    }
+    // Boost for legislative resolution work types
+    if (workType && /legislative.*resolution|position.*first.*reading/i.test(workType)) {
+        parliamentary += 1;
+        policy += 1;
+    }
+    return {
+        parliamentarySignificance: Math.min(10, parliamentary),
+        policyImpact: Math.min(10, policy),
+        publicInterest: Math.min(10, publicInterest),
+        temporalUrgency: Math.min(10, urgency),
+        institutionalRelevance: Math.min(10, institutional),
+    };
+}
 /** Analysis method identifier for significance scoring */
 export const METHOD_SIGNIFICANCE_SCORING_ID = 'significance-scoring';
 // ─── Per-method markdown builders ────────────────────────────────────────────
@@ -290,14 +355,15 @@ export function buildSignificanceScoringMarkdown(fetchedData, date) {
         }),
         ...adoptedTexts.map((t) => {
             const at = t;
+            const title = String(at['title'] ?? at['label'] ?? 'Adopted Text');
+            const reference = String(at['id'] ?? '');
+            const workType = typeof at['work_type'] === 'string' ? at['work_type'] : undefined;
+            const procedureRef = typeof at['procedure_reference'] === 'string' ? at['procedure_reference'] : undefined;
+            const scores = scoreAdoptedText(title, reference, workType, procedureRef);
             return {
-                title: String(at['title'] ?? at['label'] ?? 'Adopted Text'),
-                reference: String(at['id'] ?? ''),
-                parliamentarySignificance: ADOPTED_PARLIAMENTARY,
-                policyImpact: ADOPTED_POLICY,
-                publicInterest: ADOPTED_PUBLIC,
-                temporalUrgency: ADOPTED_URGENCY,
-                institutionalRelevance: ADOPTED_INSTITUTIONAL,
+                title,
+                reference,
+                ...scores,
             };
         }),
     ];

package/scripts/generators/pipeline/analysis-existing.js

@@ -49,12 +49,42 @@ export function buildDeepAnalysisMarkdown(fetchedData, date) {
         adoptedTexts.length +
         questions.length +
         mepUpdates.length;
+    // Build a concrete list of the top adopted texts for the AI agent to analyze
+    const topAdoptedTexts = adoptedTexts
+        .slice(0, 20)
+        .map((t) => {
+        const adoptedText = t;
+        const title = String(adoptedText['title'] ?? adoptedText['label'] ?? 'Untitled');
+        const id = String(adoptedText['id'] ?? '');
+        const workType = String(adoptedText['work_type'] ?? '');
+        const procRef = String(adoptedText['procedure_reference'] ?? '');
+        return `| ${sanitizeCell(id)} | ${sanitizeCell(title.slice(0, 100))} | ${sanitizeCell(workType)} | ${sanitizeCell(procRef)} |`;
+    })
+        .join('\n');
+    const topEvents = events
+        .slice(0, 10)
+        .map((e) => {
+        const ev = e;
+        const title = String(ev['title'] ?? ev['label'] ?? 'Untitled');
+        const id = String(ev['id'] ?? ev['eventId'] ?? '');
+        return `| ${sanitizeCell(id)} | ${sanitizeCell(title.slice(0, 120))} |`;
+    })
+        .join('\n');
+    const topProcedures = procedures
+        .slice(0, 10)
+        .map((p) => {
+        const pr = p;
+        const title = String(pr['title'] ?? pr['label'] ?? 'Untitled');
+        const id = String(pr['procedureId'] ?? pr['id'] ?? '');
+        return `| ${sanitizeCell(id)} | ${sanitizeCell(title.slice(0, 120))} |`;
+    })
+        .join('\n');
     return (header +
         `# Deep Multi-Perspective Analysis
 
 ## Pipeline Data Context
 
-> **Note:** This section contains script-generated data inventory for reference. The AI agent must replace everything starting from the "AI Agent Instructions" heading below with substantive political intelligence analysis.
+> **Note:** This section contains script-generated data inventory AND concrete document references for the AI agent to analyze. The AI agent must replace everything starting from the "AI Agent Instructions" heading below with substantive political intelligence analysis.
 
 | Data Source | Count |
 |-------------|-------|
@@ -75,13 +105,35 @@ export function buildDeepAnalysisMarkdown(fetchedData, date) {
 | Citizens | ${questions.length + mepUpdates.length} (questions + MEP updates) |
 | EU Institutions | ${events.length + procedures.length} (events + procedures) |
 
+${adoptedTexts.length > 0
+            ? `### Key Adopted Texts Available for Analysis
+
+| Reference | Title | Work Type | Procedure |
+|-----------|-------|-----------|-----------|
+${topAdoptedTexts}
+`
+            : ''}${events.length > 0
+            ? `### Key Events Available for Analysis
+
+| Reference | Title |
+|-----------|-------|
+${topEvents}
+`
+            : ''}${procedures.length > 0
+            ? `### Key Procedures Available for Analysis
+
+| Reference | Title |
+|-----------|-------|
+${topProcedures}
+`
+            : ''}
 ---
 
 ## AI Agent Instructions
 
-> **Instructions for AI Agent (Opus 4.6):** Read ALL methodology documents in analysis/methodologies/ before writing. Using the data inventory above and the raw EP MCP data files, produce a deep multi-perspective analysis following the political-style-guide.md depth Level 3 format. Your analysis MUST:
+> **Instructions for AI Agent:** Read ALL methodology documents in analysis/methodologies/ before writing. Using the concrete document references above and the raw EP MCP data, produce a deep multi-perspective analysis following the political-style-guide.md depth Level 3 format. Your analysis MUST:
 >
-> 1. **Identify the 3-5 most politically significant items** from the available data, citing specific document IDs
+> 1. **Identify the 3-5 most politically significant items** from the document tables above, citing specific document IDs (e.g. TA-10-2026-0092)
 > 2. **Analyse each from ≥3 stakeholder perspectives** (Political Groups, Civil Society, Industry, National Governments, Citizens, EU Institutions)
 > 3. **Apply the SWOT framework** to the overall parliamentary activity pattern for this date
 > 4. **Assess coalition dynamics** — which groups are aligning/diverging based on the adopted texts?

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

@@ -26,7 +26,7 @@ export interface AnalysisStageOptions {
     readonly articleTypes: readonly ArticleCategory[];
     /** ISO date string (YYYY-MM-DD) for this analysis run */
     readonly date: string;
-    /** Base output directory (e.g. 'analysis') */
+    /** Base output directory (e.g. 'analysis/daily') */
     readonly outputDir: string;
     /**
      * Filesystem-safe slug identifying the article type for this run.

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

@@ -11,7 +11,7 @@
  * news articles in all 14 languages.
  *
  * This stage is **side-effect-only**: it writes analysis markdown and a
- * `manifest.json` to disk under `analysis/{date}/{article-type}/`.  When
+ * `manifest.json` to disk under `analysis/daily/{date}/{article-type}/`.  When
  * `articleTypeSlug` is provided (recommended for agentic workflows), each
  * article type writes to its own subdirectory, preventing merge conflicts
  * when multiple workflows run concurrently on the same date.
@@ -29,7 +29,7 @@
  * const ctx = await runAnalysisStage(fetchedData, {
  *   articleTypes: [ArticleCategory.WEEK_AHEAD],
  *   date: '2026-03-26',
- *   outputDir: 'analysis',
+ *   outputDir: 'analysis/daily',
  * });
  * console.log(ctx.completedMethods);
  * ```
@@ -73,10 +73,9 @@ export const ALL_ANALYSIS_METHODS = [
     // Publication scoring & synthesis
     'significance-scoring',
     'synthesis-summary',
-    // NOTE: 'document-analysis' is intentionally excluded from the default set.
-    // It writes one markdown + one JSON file per feed item and can significantly
-    // increase runtime and repository output size.  Callers must opt-in by
-    // explicitly listing it in `enabledMethods`.
+    // Per-document intelligence analysis — stores complete EP document data
+    // alongside per-document political intelligence analysis markdown files.
+    'document-analysis',
 ];
 /**
  * All valid analysis method names, including opt-in methods like

package/scripts/generators/pipeline/analysis-threats.d.ts

@@ -4,7 +4,7 @@ import type { AnalysisMethod } from './analysis-stage.js';
  * Build markdown for the political threat landscape assessment.
  *
  * Uses the pipeline `date` parameter to ensure the assessment date in the
- * generated markdown matches the `analysis/{date}/` folder, overriding
+ * generated markdown matches the `analysis/daily/{date}/` folder, overriding
  * the `new Date()` timestamp that `assessPoliticalThreats()` stamps internally.
  *
  * @param fetchedData - Raw fetched EP data

package/scripts/generators/pipeline/analysis-threats.js

@@ -17,7 +17,7 @@ import { sanitizeCell, safeArr, toThreatInput, buildMarkdownHeader, EMPTY_TABLE_
  * Build markdown for the political threat landscape assessment.
  *
  * Uses the pipeline `date` parameter to ensure the assessment date in the
- * generated markdown matches the `analysis/{date}/` folder, overriding
+ * generated markdown matches the `analysis/daily/{date}/` folder, overriding
  * the `new Date()` timestamp that `assessPoliticalThreats()` stamps internally.
  *
  * @param fetchedData - Raw fetched EP data

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

@@ -217,6 +217,7 @@ export declare function fetchPipelineFromMCP(client: EuropeanParliamentMCPClient
 export declare function fetchProcedureStatusFromMCP(client: EuropeanParliamentMCPClient | null, procedureId: string): Promise<string>;
 /**
  * Fetch adopted texts feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -225,6 +226,8 @@ export declare function fetchProcedureStatusFromMCP(client: EuropeanParliamentMC
 export declare function fetchAdoptedTextsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<AdoptedTextFeedItem[]>;
 /**
  * Fetch events feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data
+ * (common during parliamentary recess when the EP API returns 404 for narrow windows).
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -233,6 +236,7 @@ export declare function fetchAdoptedTextsFeed(client: EuropeanParliamentMCPClien
 export declare function fetchEventsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<EventFeedItem[]>;
 /**
  * Fetch procedures feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -267,6 +271,7 @@ export declare function fetchMEPsFeedWithTotal(client: EuropeanParliamentMCPClie
 }>;
 /**
  * Fetch documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -275,6 +280,7 @@ export declare function fetchMEPsFeedWithTotal(client: EuropeanParliamentMCPClie
 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.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -283,6 +289,7 @@ export declare function fetchDocumentsFeed(client: EuropeanParliamentMCPClient |
 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.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -291,6 +298,7 @@ export declare function fetchPlenaryDocumentsFeed(client: EuropeanParliamentMCPC
 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.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -299,6 +307,7 @@ export declare function fetchCommitteeDocumentsFeed(client: EuropeanParliamentMC
 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.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -307,6 +316,7 @@ 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.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')