euparliamentmonitor 0.8.4

package/scripts/generators/strategies/article-strategy.d.ts

@@ -0,0 +1,146 @@
+/**
+ * @module Generators/Strategies/ArticleStrategy
+ * @description Base interface and shared types for article generation strategies.
+ * Each strategy encapsulates the fetch, build, and metadata logic for one
+ * {@link ArticleCategory}, making it trivial to add new article types without
+ * touching the orchestration layer.
+ */
+import type { ArticleCategory } from '../../types/index.js';
+import type { LanguageCode } from '../../types/index.js';
+import type { ArticleSource } from '../../types/index.js';
+import type { EuropeanParliamentMCPClient } from '../../mcp/ep-mcp-client.js';
+/**
+ * Minimum payload every strategy must carry: the article's publication date.
+ * Strategy-specific data interfaces extend this base.
+ */
+export interface ArticleData {
+    /** ISO 8601 publication date (YYYY-MM-DD) */
+    readonly date: string;
+}
+/**
+ * Resolved title, subtitle, keywords, and optional sources for one
+ * language version of an article.
+ */
+export interface ArticleMetadata {
+    /** Localized article title */
+    readonly title: string;
+    /** Localized article subtitle */
+    readonly subtitle: string;
+    /** SEO keywords */
+    readonly keywords: readonly string[];
+    /** Article category */
+    readonly category: ArticleCategory;
+    /** Optional source references */
+    readonly sources?: readonly ArticleSource[] | undefined;
+}
+/**
+ * Non-generic base interface for {@link ArticleStrategy} used by the strategy
+ * registry.  Expresses the common operations with {@link ArticleData} as the
+ * data payload type so that concrete strategies parameterised on a subtype can
+ * be stored in a single {@link StrategyRegistry} map without unsafe casts.
+ *
+ * This interface deliberately relies on TypeScript's bivariant method-parameter
+ * checking: a concrete strategy whose methods accept a narrower `TData`
+ * (extending {@link ArticleData}) still satisfies this interface structurally.
+ * That means the type is not fully sound — a caller that only sees
+ * {@link ArticleStrategyBase} could, in principle, pass an {@link ArticleData}
+ * value that does not match the concrete strategy's expected `TData` shape.
+ *
+ * To use this interface safely:
+ * - Only pass the `data` object returned by a given strategy's own
+ *   {@link ArticleStrategyBase.fetchData | fetchData} to that same strategy's
+ *   {@link ArticleStrategyBase.buildContent | buildContent} and
+ *   {@link ArticleStrategyBase.getMetadata | getMetadata} methods.
+ * - Never mix data payloads between different strategies, even if they share
+ *   the {@link ArticleData} base type.
+ *
+ * External callers that need strong typing for a specific strategy should
+ * prefer the generic {@link ArticleStrategy} interface, which preserves the
+ * concrete `TData` type and avoids this intentional unsoundness. The
+ * {@link ArticleStrategyBase} interface is intended primarily for the internal
+ * orchestration / pipeline layer that manages a heterogeneous strategy
+ * registry.
+ */
+export interface ArticleStrategyBase {
+    /** The article category this strategy handles */
+    readonly type: ArticleCategory;
+    /** Names of MCP tools this strategy calls */
+    readonly requiredMCPTools: readonly string[];
+    /**
+     * Fetch all domain data needed to render this article type.
+     *
+     * @param client - Connected MCP client, or null when MCP is unavailable
+     * @param date - ISO 8601 publication date (YYYY-MM-DD)
+     * @returns Populated article data payload
+     */
+    fetchData(client: EuropeanParliamentMCPClient | null, date: string): Promise<ArticleData>;
+    /**
+     * Build the article HTML body for the given language.
+     *
+     * @param data - Data payload returned by {@link fetchData}
+     * @param lang - Target language code
+     * @returns Article body HTML string
+     */
+    buildContent(data: ArticleData, lang: LanguageCode): string;
+    /**
+     * Return title, subtitle, keywords, and sources for the given language.
+     *
+     * @param data - Data payload returned by {@link fetchData}
+     * @param lang - Target language code
+     * @returns Article metadata
+     */
+    getMetadata(data: ArticleData, lang: LanguageCode): ArticleMetadata;
+    /**
+     * Optional guard that lets a strategy opt out of generation when the
+     * fetched data contains only placeholder / fallback values (e.g. MCP
+     * unavailable).  When `true` is returned the orchestrator skips writing
+     * all language variants and logs a notice rather than publishing empty
+     * placeholder articles.
+     *
+     * Strategies that do not implement this method are treated as always
+     * wanting to generate (i.e. the default is `false`).
+     *
+     * @param data - Data payload returned by {@link fetchData}
+     * @returns `true` when all fetched data is placeholder and generation should be skipped
+     */
+    shouldSkip?(data: ArticleData): boolean;
+}
+/**
+ * Strategy interface for article generation.
+ *
+ * Each concrete implementation handles one {@link ArticleCategory}:
+ * - {@link module:Generators/Strategies/WeekAheadStrategy}
+ * - {@link module:Generators/Strategies/BreakingNewsStrategy}
+ * - {@link module:Generators/Strategies/CommitteeReportsStrategy}
+ * - {@link module:Generators/Strategies/PropositionsStrategy}
+ * - {@link module:Generators/Strategies/MotionsStrategy}
+ *
+ * @template TData - Concrete data payload type returned by {@link fetchData}
+ */
+export interface ArticleStrategy<TData extends ArticleData = ArticleData> extends ArticleStrategyBase {
+    /**
+     * Fetch all domain data needed to render this article type.
+     *
+     * @param client - Connected MCP client, or null when MCP is unavailable
+     * @param date - ISO 8601 publication date (YYYY-MM-DD)
+     * @returns Populated article data payload
+     */
+    fetchData(client: EuropeanParliamentMCPClient | null, date: string): Promise<TData>;
+    /**
+     * Build the article HTML body for the given language.
+     *
+     * @param data - Data payload returned by {@link fetchData}
+     * @param lang - Target language code
+     * @returns Article body HTML string
+     */
+    buildContent(data: TData, lang: LanguageCode): string;
+    /**
+     * Return title, subtitle, keywords, and sources for the given language.
+     *
+     * @param data - Data payload returned by {@link fetchData}
+     * @param lang - Target language code
+     * @returns Article metadata
+     */
+    getMetadata(data: TData, lang: LanguageCode): ArticleMetadata;
+}
+//# sourceMappingURL=article-strategy.d.ts.map

package/scripts/generators/strategies/article-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-strategy.d.ts","sourceRoot":"","sources":["../../../src/generators/strategies/article-strategy.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,2BAA2B,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1F;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5D;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe,CAAC;IACpE;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;CACzC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe,CAC9B,KAAK,SAAS,WAAW,GAAG,WAAW,CACvC,SAAQ,mBAAmB;IAC3B;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,2BAA2B,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACpF;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IACtD;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe,CAAC;CAC/D"}

package/scripts/generators/strategies/article-strategy.js

@@ -0,0 +1,4 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=article-strategy.js.map

package/scripts/generators/strategies/article-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-strategy.js","sourceRoot":"","sources":["../../../src/generators/strategies/article-strategy.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,sCAAsC"}

package/scripts/generators/strategies/breaking-news-strategy.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @module Generators/Strategies/BreakingNewsStrategy
+ * @description Article strategy for the Breaking News article type.
+ * Uses a **feed-first** approach: EP feed endpoints (adopted texts, events,
+ * procedures, MEPs) provide the primary news content, while analytical tools
+ * (voting anomalies, coalition dynamics) supply optional context only.
+ *
+ * Precomputed statistics from `get_all_generated_stats` are **never** the
+ * primary news content and are used solely for historical comparison.
+ */
+import type { EuropeanParliamentMCPClient } from '../../mcp/ep-mcp-client.js';
+import { ArticleCategory } from '../../types/index.js';
+import type { LanguageCode, BreakingNewsFeedData } from '../../types/index.js';
+import type { ArticleStrategy, ArticleData, ArticleMetadata } from './article-strategy.js';
+/** Data fetched and pre-processed by {@link BreakingNewsStrategy} */
+export interface BreakingNewsArticleData extends ArticleData {
+    /** Feed data — adopted texts, events, procedures, MEP updates (PRIMARY). Undefined when MCP unavailable. */
+    readonly feedData: BreakingNewsFeedData | undefined;
+    /** Raw voting anomaly text from MCP (CONTEXT ONLY) */
+    readonly anomalyRaw: string;
+    /** Raw coalition dynamics text from MCP (CONTEXT ONLY) */
+    readonly coalitionRaw: string;
+    /** Raw voting statistics report text from MCP (KEPT FOR BACKWARD COMPAT) */
+    readonly reportRaw: string;
+}
+/**
+ * Article strategy for {@link ArticleCategory.BREAKING_NEWS}.
+ *
+ * **Feed-first**: EP feed endpoints are the primary data source.
+ * Analytical tools provide supplementary context only.
+ * Stats are NEVER the news itself.
+ */
+export declare class BreakingNewsStrategy implements ArticleStrategy<BreakingNewsArticleData> {
+    readonly type = ArticleCategory.BREAKING_NEWS;
+    readonly requiredMCPTools: readonly ["get_adopted_texts_feed", "get_events_feed", "get_procedures_feed", "get_meps_feed", "detect_voting_anomalies", "analyze_coalition_dynamics"];
+    /**
+     * Fetch EP feed data (primary) first, then conditionally fetch analytical
+     * context (secondary) in a second phase.
+     *
+     * @param client - MCP client or null
+     * @param date - ISO 8601 publication date
+     * @returns Populated breaking news data payload
+     */
+    fetchData(client: EuropeanParliamentMCPClient | null, date: string): Promise<BreakingNewsArticleData>;
+    /**
+     * Build the breaking news HTML body for the specified language.
+     *
+     * @param data - Breaking news data payload
+     * @param lang - Target language code used for editorial strings
+     * @returns Article HTML body
+     */
+    buildContent(data: BreakingNewsArticleData, lang: LanguageCode): string;
+    /**
+     * Return language-specific metadata for the breaking news article.
+     *
+     * @param data - Breaking news data payload
+     * @param lang - Target language code
+     * @returns Localised metadata
+     */
+    getMetadata(data: BreakingNewsArticleData, lang: LanguageCode): ArticleMetadata;
+}
+/** Singleton instance for use by the strategy registry */
+export declare const breakingNewsStrategy: BreakingNewsStrategy;
+//# sourceMappingURL=breaking-news-strategy.d.ts.map

package/scripts/generators/strategies/breaking-news-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaking-news-strategy.d.ts","sourceRoot":"","sources":["../../../src/generators/strategies/breaking-news-strategy.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAuB/E,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAkG3F,qEAAqE;AACrE,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,4GAA4G;IAC5G,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACpD,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAID;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,eAAe,CAAC,uBAAuB,CAAC;IACnF,QAAQ,CAAC,IAAI,iCAAiC;IAE9C,QAAQ,CAAC,gBAAgB,0JAOd;IAEX;;;;;;;OAOG;IACG,SAAS,CACb,MAAM,EAAE,2BAA2B,GAAG,IAAI,EAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,uBAAuB,CAAC;IAqEnC;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM;IAuCvE;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe;CAsBhF;AAED,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/scripts/generators/strategies/breaking-news-strategy.js

@@ -0,0 +1,246 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+import { ArticleCategory } from '../../types/index.js';
+import { BREAKING_NEWS_TITLES, getLocalizedString } from '../../constants/languages.js';
+import { fetchBreakingNewsFeedData, fetchVotingAnomalies, fetchCoalitionDynamics, loadFeedDataFromFile, } from '../pipeline/fetch-stage.js';
+import { buildBreakingNewsContent, scoreBreakingNewsSignificance, SIGNIFICANCE_THRESHOLD, } from '../breaking-content.js';
+import { buildDeepAnalysisSection } from '../deep-analysis-content.js';
+import { buildBreakingAnalysis, buildBreakingSwot, buildBreakingDashboard, buildBreakingMindmap, } from '../analysis-builders.js';
+import { buildSwotSection } from '../swot-content.js';
+import { buildDashboardSection } from '../dashboard-content.js';
+import { buildIntelligenceMindmapSection } from '../mindmap-content.js';
+import { pl } from '../../utils/metadata-utils.js';
+/** Base keywords shared by all Breaking News articles */
+const BREAKING_NEWS_BASE_KEYWORDS = [
+    'European Parliament',
+    'breaking news',
+    'adopted texts',
+    'legislative updates',
+    'parliamentary events',
+];
+/**
+ * Extract content-aware keywords from breaking news feed data.
+ *
+ * Scans adopted text titles, event titles, and procedure titles for
+ * topic-relevant terms that enrich SEO keywords beyond the static base set.
+ *
+ * @param feedData - Breaking news feed data (may be undefined)
+ * @returns Deduplicated array of keywords including base + content-derived terms
+ */
+function buildBreakingKeywords(feedData) {
+    const keywords = [...BREAKING_NEWS_BASE_KEYWORDS];
+    if (!feedData)
+        return keywords;
+    for (const text of feedData.adoptedTexts.slice(0, 5)) {
+        if (text.title)
+            keywords.push(text.title.slice(0, 60));
+    }
+    for (const evt of feedData.events.slice(0, 3)) {
+        if (evt.title)
+            keywords.push(evt.title.slice(0, 60));
+    }
+    for (const proc of feedData.procedures.slice(0, 3)) {
+        if (proc.title)
+            keywords.push(proc.title.slice(0, 60));
+    }
+    return [...new Set(keywords)];
+}
+/**
+ * Build a content-aware description from breaking news feed data.
+ * Summarises the count of adopted texts, events, procedures, and MEP updates
+ * and highlights the first adopted text title when available.
+ *
+ * @param date - Publication date
+ * @param feedData - Breaking news feed data (may be undefined)
+ * @returns SEO-friendly description string (≤ 200 chars)
+ */
+function buildBreakingDescription(date, feedData) {
+    if (!feedData)
+        return `European Parliament breaking developments for ${date}.`;
+    const counts = [];
+    if (feedData.adoptedTexts.length > 0)
+        counts.push(pl(feedData.adoptedTexts.length, 'adopted text', 'adopted texts'));
+    if (feedData.events.length > 0)
+        counts.push(pl(feedData.events.length, 'event', 'events'));
+    if (feedData.procedures.length > 0)
+        counts.push(pl(feedData.procedures.length, 'procedure', 'procedures'));
+    if (feedData.mepUpdates.length > 0)
+        counts.push(pl(feedData.mepUpdates.length, 'MEP update', 'MEP updates'));
+    if (counts.length === 0)
+        return `European Parliament breaking developments for ${date}.`;
+    const highlight = feedData.adoptedTexts[0]?.title ?? feedData.events[0]?.title ?? '';
+    const base = `EP breaking: ${counts.join(', ')}`;
+    if (highlight) {
+        const full = `${base}. Highlights: ${highlight}`;
+        return full.length > 200 ? full.slice(0, 197) + '...' : full;
+    }
+    return base.length > 200 ? base.slice(0, 197) + '...' : base;
+}
+/**
+ * Build a content-aware title suffix from feed data item counts.
+ *
+ * @param feedData - Breaking news feed data (may be undefined)
+ * @returns Short suffix string for appending to the base title, or empty string
+ */
+function buildBreakingTitleSuffix(feedData) {
+    if (!feedData)
+        return '';
+    const total = feedData.adoptedTexts.length +
+        feedData.events.length +
+        feedData.procedures.length +
+        feedData.mepUpdates.length;
+    if (total === 0)
+        return '';
+    const parts = [];
+    if (feedData.adoptedTexts.length > 0)
+        parts.push(pl(feedData.adoptedTexts.length, 'Text', 'Texts'));
+    if (feedData.events.length > 0)
+        parts.push(pl(feedData.events.length, 'Event', 'Events'));
+    if (feedData.procedures.length > 0)
+        parts.push(pl(feedData.procedures.length, 'Procedure', 'Procedures'));
+    return parts.join(', ');
+}
+// ─── Strategy implementation ──────────────────────────────────────────────────
+/**
+ * Article strategy for {@link ArticleCategory.BREAKING_NEWS}.
+ *
+ * **Feed-first**: EP feed endpoints are the primary data source.
+ * Analytical tools provide supplementary context only.
+ * Stats are NEVER the news itself.
+ */
+export class BreakingNewsStrategy {
+    type = ArticleCategory.BREAKING_NEWS;
+    requiredMCPTools = [
+        'get_adopted_texts_feed',
+        'get_events_feed',
+        'get_procedures_feed',
+        'get_meps_feed',
+        'detect_voting_anomalies',
+        'analyze_coalition_dynamics',
+    ];
+    /**
+     * Fetch EP feed data (primary) first, then conditionally fetch analytical
+     * context (secondary) in a second phase.
+     *
+     * @param client - MCP client or null
+     * @param date - ISO 8601 publication date
+     * @returns Populated breaking news data payload
+     */
+    async fetchData(client, date) {
+        // Step 0: Check for pre-fetched feed data file (set by --feed-data CLI arg).
+        // This allows agentic workflows to pass MCP data fetched via framework tools
+        // into the generator without requiring a direct MCP connection.
+        const feedDataFile = process.env['EP_FEED_DATA_FILE'];
+        if (feedDataFile) {
+            console.log(`  📂 Loading pre-fetched feed data from: ${feedDataFile}`);
+            const fileFeedData = loadFeedDataFromFile(feedDataFile, { start: date, end: date });
+            if (fileFeedData) {
+                const totalItems = fileFeedData.adoptedTexts.length +
+                    fileFeedData.events.length +
+                    fileFeedData.procedures.length +
+                    fileFeedData.mepUpdates.length;
+                console.log(`  📰 Pre-fetched feed data: ${totalItems} total items`);
+                // Fetch analytical context from MCP if client available, else skip
+                let anomalyRaw = '';
+                let coalitionRaw = '';
+                if (client && totalItems > 0) {
+                    [anomalyRaw, coalitionRaw] = await Promise.all([
+                        fetchVotingAnomalies(client),
+                        fetchCoalitionDynamics(client),
+                    ]);
+                }
+                return { date, feedData: fileFeedData, anomalyRaw, coalitionRaw, reportRaw: '' };
+            }
+            console.log('  ⚠️ Pre-fetched feed data failed to load — falling through to MCP fetch');
+        }
+        if (client) {
+            console.log('  📡 Fetching EP feed data (primary) and analytical context...');
+        }
+        // Step 1: Fetch feed data (PRIMARY news content) — 'today' for realtime breaking news
+        const feedData = await fetchBreakingNewsFeedData(client, 'today');
+        // When client is null, feedData is undefined — MCP unavailable
+        if (!feedData) {
+            console.log('  ⚠️ MCP unavailable — no feed data or analytical context');
+            return { date, feedData, anomalyRaw: '', coalitionRaw: '', reportRaw: '' };
+        }
+        const totalFeedItems = feedData.adoptedTexts.length +
+            feedData.events.length +
+            feedData.procedures.length +
+            feedData.mepUpdates.length;
+        if (totalFeedItems > 0) {
+            console.log(`  📰 Feed data: ${feedData.adoptedTexts.length} adopted texts, ` +
+                `${feedData.events.length} events, ${feedData.procedures.length} procedures, ` +
+                `${feedData.mepUpdates.length} MEP updates`);
+        }
+        else {
+            console.log('  ⚠️ No feed data available — skipping analytical context fetch');
+            return { date, feedData, anomalyRaw: '', coalitionRaw: '', reportRaw: '' };
+        }
+        // Step 2: Fetch analytical context only when at least one feed item is available
+        const [anomalyRaw, coalitionRaw] = await Promise.all([
+            fetchVotingAnomalies(client),
+            fetchCoalitionDynamics(client),
+        ]);
+        return { date, feedData, anomalyRaw, coalitionRaw, reportRaw: '' };
+    }
+    /**
+     * Build the breaking news HTML body for the specified language.
+     *
+     * @param data - Breaking news data payload
+     * @param lang - Target language code used for editorial strings
+     * @returns Article HTML body
+     */
+    buildContent(data, lang) {
+        const base = buildBreakingNewsContent(data.date, data.anomalyRaw, data.coalitionRaw, data.reportRaw, '', lang, [], [], [], data.feedData);
+        const analysis = buildBreakingAnalysis(data.date, data.feedData, data.anomalyRaw, data.coalitionRaw, lang);
+        const deepSection = buildDeepAnalysisSection(analysis, lang);
+        const mindmapData = buildBreakingMindmap(data.feedData, lang);
+        const mindmapSection = buildIntelligenceMindmapSection(mindmapData, lang);
+        const swotData = buildBreakingSwot(data.feedData, data.anomalyRaw, data.coalitionRaw, lang);
+        const swotSection = buildSwotSection(swotData, lang);
+        const dashboardData = buildBreakingDashboard(data.feedData, lang);
+        const dashboardSection = buildDashboardSection(dashboardData, lang);
+        const injection = deepSection + mindmapSection + swotSection + dashboardSection;
+        // Inject before the closing </div> of .article-content
+        if (injection) {
+            const closingTag = '</div>';
+            const lastIdx = base.lastIndexOf(closingTag);
+            if (lastIdx !== -1) {
+                return base.slice(0, lastIdx) + injection + '\n' + base.slice(lastIdx);
+            }
+        }
+        return base;
+    }
+    /**
+     * Return language-specific metadata for the breaking news article.
+     *
+     * @param data - Breaking news data payload
+     * @param lang - Target language code
+     * @returns Localised metadata
+     */
+    getMetadata(data, lang) {
+        const titleFn = getLocalizedString(BREAKING_NEWS_TITLES, lang);
+        const { title: baseTitle, subtitle: baseSubtitle } = titleFn(data.date);
+        const suffix = lang === 'en' ? buildBreakingTitleSuffix(data.feedData) : '';
+        const title = suffix ? `${baseTitle} — ${suffix}` : baseTitle;
+        const description = lang === 'en' ? buildBreakingDescription(data.date, data.feedData) : '';
+        const subtitle = description || baseSubtitle;
+        const keywords = buildBreakingKeywords(data.feedData);
+        if (data.feedData) {
+            const score = scoreBreakingNewsSignificance(data.feedData);
+            if (score.overallScore >= SIGNIFICANCE_THRESHOLD) {
+                keywords.push(`significance:${score.overallScore}`);
+            }
+        }
+        return {
+            title,
+            subtitle,
+            keywords,
+            category: ArticleCategory.BREAKING_NEWS,
+            sources: [],
+        };
+    }
+}
+/** Singleton instance for use by the strategy registry */
+export const breakingNewsStrategy = new BreakingNewsStrategy();
+//# sourceMappingURL=breaking-news-strategy.js.map

package/scripts/generators/strategies/breaking-news-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaking-news-strategy.js","sourceRoot":"","sources":["../../../src/generators/strategies/breaking-news-strategy.ts"],"names":[],"mappings":"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"}

package/scripts/generators/strategies/committee-reports-strategy.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @module Generators/Strategies/CommitteeReportsStrategy
+ * @description Article strategy for the Committee Reports article type.
+ * Fetches data for each featured committee in parallel and renders an
+ * effectiveness and activity overview article.
+ */
+import type { EuropeanParliamentMCPClient } from '../../mcp/ep-mcp-client.js';
+import { ArticleCategory } from '../../types/index.js';
+import type { LanguageCode, CommitteeData, EPFeedData } from '../../types/index.js';
+import type { ArticleStrategy, ArticleData, ArticleMetadata } from './article-strategy.js';
+/** Data fetched and pre-processed by {@link CommitteeReportsStrategy} */
+export interface CommitteeReportsArticleData extends ArticleData {
+    /** Resolved data for each featured committee */
+    readonly committeeDataList: readonly CommitteeData[];
+    /** EP feed data for enrichment (when available) */
+    readonly feedData?: EPFeedData | undefined;
+}
+/**
+ * Narrow union type for the committee theme category keys used when
+ * grouping and displaying adopted texts.
+ */
+export type CommitteeTheme = 'ENVI' | 'ECON' | 'AFET' | 'LIBE' | 'AGRI' | 'OTHER';
+/** Lowercase keywords that map an adopted-text title to the AFET theme group */
+export declare const AFET_KEYWORDS: readonly string[];
+/** Lowercase keywords that map an adopted-text title to the LIBE theme group */
+export declare const LIBE_KEYWORDS: readonly string[];
+/** Lowercase keywords that map an adopted-text title to the AGRI theme group */
+export declare const AGRI_KEYWORDS: readonly string[];
+/** Lowercase keywords that map an adopted-text title to the ENVI theme group */
+export declare const ENVI_KEYWORDS: readonly string[];
+/** Lowercase keywords that map an adopted-text title to the ECON theme group */
+export declare const ECON_KEYWORDS: readonly string[];
+/**
+ * Categorize an adopted-text title into a committee theme group.
+ *
+ * LIBE is tested before AFET so that human-rights and human-trafficking
+ * titles are classified under civil liberties even when they also mention
+ * an AFET country keyword (e.g. "Ukraine"). Both are tested before AGRI
+ * to avoid person-name false positives (e.g. "Bobi Wine").
+ *
+ * @param title - Adopted text title to categorize
+ * @returns Committee theme key — one of `'ENVI'` | `'ECON'` | `'AFET'` | `'LIBE'` | `'AGRI'` | `'OTHER'`
+ */
+export declare function categorizeAdoptedText(title: string): CommitteeTheme;
+/**
+ * Article strategy for {@link ArticleCategory.COMMITTEE_REPORTS}.
+ * Fetches info, documents and effectiveness data for the featured committees
+ * then renders an activity overview.
+ */
+export declare class CommitteeReportsStrategy implements ArticleStrategy<CommitteeReportsArticleData> {
+    readonly type = ArticleCategory.COMMITTEE_REPORTS;
+    readonly requiredMCPTools: readonly ["get_committee_info", "search_documents", "analyze_legislative_effectiveness", "get_committee_documents_feed"];
+    /**
+     * Fetch committee data for all featured committees in parallel.
+     *
+     * @param client - MCP client or null
+     * @param date - ISO 8601 publication date
+     * @returns Populated committee reports data payload
+     */
+    fetchData(client: EuropeanParliamentMCPClient | null, date: string): Promise<CommitteeReportsArticleData>;
+    /**
+     * Build the committee reports HTML body.
+     *
+     * @param data - Committee reports data payload
+     * @param lang - Language code for localized content
+     * @returns Article HTML body
+     */
+    buildContent(data: CommitteeReportsArticleData, lang: LanguageCode): string;
+    /**
+     * Return language-specific metadata for the committee reports article.
+     *
+     * @param data - Committee reports data payload
+     * @param lang - Target language code
+     * @returns Localised metadata
+     */
+    getMetadata(data: CommitteeReportsArticleData, lang: LanguageCode): ArticleMetadata;
+    /**
+     * Skip generation when no real data is available.
+     *
+     * Skips when:
+     * - All committee fetches failed (empty committeeDataList), or
+     * - All fetched committee data is placeholder AND no feed data is available.
+     * When EP feed data contains adopted texts or other items, the article can still
+     * provide valuable content even if individual committee metadata is sparse.
+     *
+     * @param data - Committee reports data payload
+     * @returns `true` when there is no usable data at all
+     */
+    shouldSkip(data: CommitteeReportsArticleData): boolean;
+}
+/** Singleton instance for use by the strategy registry */
+export declare const committeeReportsStrategy: CommitteeReportsStrategy;
+//# sourceMappingURL=committee-reports-strategy.d.ts.map

package/scripts/generators/strategies/committee-reports-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"committee-reports-strategy.d.ts","sourceRoot":"","sources":["../../../src/generators/strategies/committee-reports-strategy.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AA4BpF,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAoH3F,yEAAyE;AACzE,MAAM,WAAW,2BAA4B,SAAQ,WAAW;IAC9D,gDAAgD;IAChD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,aAAa,EAAE,CAAC;IACrD,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC5C;AAID;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAclF,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAkB1C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAc1C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAQ1C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAW1C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAO1C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAQnE;AAiJD;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,eAAe,CAAC,2BAA2B,CAAC;IAC3F,QAAQ,CAAC,IAAI,qCAAqC;IAElD,QAAQ,CAAC,gBAAgB,2HAKd;IAEX;;;;;;OAMG;IACG,SAAS,CACb,MAAM,EAAE,2BAA2B,GAAG,IAAI,EAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,2BAA2B,CAAC;IAwBvC;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM;IAuB3E;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe;IAoBnF;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO;CAsBvD;AAED,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,0BAAiC,CAAC"}