euparliamentmonitor 0.8.4

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

@@ -0,0 +1,215 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+import { ArticleCategory } from '../../types/index.js';
+import { MOTIONS_TITLES, getLocalizedString } from '../../constants/languages.js';
+import { fetchMotionsData, fetchEPFeedData } from '../pipeline/fetch-stage.js';
+import { generateMotionsContent, buildPoliticalAlignmentSection, buildAdoptedTextsSection, PLACEHOLDER_MARKER, } from '../motions-content.js';
+import { buildDeepAnalysisSection } from '../deep-analysis-content.js';
+import { buildVotingAnalysis, buildVotingSwot, buildVotingDashboard, buildVotingMindmap, } 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 Motions articles */
+const MOTIONS_BASE_KEYWORDS = [
+    'European Parliament',
+    'motions',
+    'voting records',
+    'party cohesion',
+    'parliamentary questions',
+];
+/**
+ * Extract content-aware keywords from motions data.
+ *
+ * Adds voting record titles, anomaly descriptions, question topics,
+ * and adopted text titles to the base keyword set.
+ *
+ * @param data - Motions article data payload
+ * @returns Deduplicated keyword array
+ */
+function buildMotionsKeywords(data) {
+    const keywords = [...MOTIONS_BASE_KEYWORDS];
+    for (const r of data.votingRecords.slice(0, 5)) {
+        if (r.title)
+            keywords.push(r.title.slice(0, 60));
+    }
+    for (const a of data.anomalies.slice(0, 3)) {
+        if (a.type)
+            keywords.push(a.type);
+    }
+    for (const q of data.questions.slice(0, 3)) {
+        if (q.topic)
+            keywords.push(q.topic);
+    }
+    if (data.feedData?.adoptedTexts) {
+        for (const text of data.feedData.adoptedTexts.slice(0, 3)) {
+            if (text.title)
+                keywords.push(text.title.slice(0, 60));
+        }
+    }
+    return [...new Set(keywords)];
+}
+/**
+ * Build a content-aware description from motions data.
+ * Summarises voting record count, anomaly count, and key vote highlights.
+ *
+ * @param data - Motions article data payload
+ * @returns SEO-friendly description (≤ 200 chars)
+ */
+function buildMotionsDescription(data) {
+    const parts = [];
+    if (data.votingRecords.length > 0)
+        parts.push(`${pl(data.votingRecords.length, 'vote', 'votes')} analysed`);
+    if (data.anomalies.length > 0)
+        parts.push(`${pl(data.anomalies.length, 'anomaly', 'anomalies')} detected`);
+    if (data.questions.length > 0)
+        parts.push(pl(data.questions.length, 'parliamentary question', 'parliamentary questions'));
+    const adoptedCount = data.feedData?.adoptedTexts?.length ?? 0;
+    if (adoptedCount > 0)
+        parts.push(pl(adoptedCount, 'adopted text', 'adopted texts'));
+    if (parts.length === 0) {
+        return `European Parliament plenary votes and resolutions from ${data.dateFromStr} to ${data.date}.`;
+    }
+    const highlight = data.votingRecords[0]?.title ?? '';
+    const base = `EP voting analysis: ${parts.join(', ')}`;
+    if (highlight) {
+        const full = `${base}. Key vote: ${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 motions data counts.
+ *
+ * @param data - Motions article data payload
+ * @returns Short suffix for the title, or empty string
+ */
+function buildMotionsTitleSuffix(data) {
+    const parts = [];
+    if (data.votingRecords.length > 0) {
+        parts.push(pl(data.votingRecords.length, 'Vote', 'Votes'));
+    }
+    if (data.anomalies.length > 0) {
+        parts.push(pl(data.anomalies.length, 'Anomaly', 'Anomalies'));
+    }
+    const adoptedCount = data.feedData?.adoptedTexts?.length ?? 0;
+    if (adoptedCount > 0) {
+        parts.push(pl(adoptedCount, 'Adopted Text', 'Adopted Texts'));
+    }
+    return parts.join(', ');
+}
+/** Number of days to look back when fetching motions data */
+const MOTIONS_LOOKBACK_DAYS = 30;
+// ─── Strategy implementation ──────────────────────────────────────────────────
+/**
+ * Article strategy for {@link ArticleCategory.MOTIONS}.
+ * Aggregates voting data over a rolling 30-day window and surfaces
+ * patterns, anomalies and parliamentary questions.
+ */
+export class MotionsStrategy {
+    type = ArticleCategory.MOTIONS;
+    requiredMCPTools = [
+        'get_voting_records',
+        'analyze_voting_patterns',
+        'detect_voting_anomalies',
+        'get_parliamentary_questions',
+        'get_adopted_texts_feed',
+        'get_parliamentary_questions_feed',
+    ];
+    /**
+     * Fetch all motions data for the last 30 days.
+     *
+     * @param client - MCP client or null
+     * @param date - ISO 8601 publication date (end of the look-back window)
+     * @returns Populated motions data payload
+     */
+    async fetchData(client, date) {
+        const dateFrom = new Date(`${date}T00:00:00Z`);
+        dateFrom.setUTCDate(dateFrom.getUTCDate() - MOTIONS_LOOKBACK_DAYS);
+        const dateFromParts = dateFrom.toISOString().split('T');
+        if (!dateFromParts[0]) {
+            throw new Error('Invalid date format generated for motions look-back window');
+        }
+        const dateFromStr = dateFromParts[0];
+        // Fetch voting data and EP feed data in parallel
+        const feedDateRange = { start: dateFromStr, end: date };
+        const [motionsDataResult, feedData] = await Promise.all([
+            fetchMotionsData(client, dateFromStr, date),
+            fetchEPFeedData(client, 'one-month', feedDateRange),
+        ]);
+        const { votingRecords, votingPatterns, anomalies, questions } = motionsDataResult;
+        return {
+            date,
+            dateFromStr,
+            votingRecords,
+            votingPatterns,
+            anomalies,
+            questions,
+            feedData,
+        };
+    }
+    /**
+     * Build the motions HTML body for the specified language.
+     *
+     * @param data - Motions data payload
+     * @param lang - Target language code used for editorial strings
+     * @returns Article HTML body
+     */
+    buildContent(data, lang) {
+        const base = generateMotionsContent(data.dateFromStr, data.date, [...data.votingRecords], [...data.votingPatterns], [...data.anomalies], [...data.questions], lang);
+        const adoptedTextsSection = data.feedData?.adoptedTexts
+            ? buildAdoptedTextsSection(data.feedData.adoptedTexts, lang)
+            : '';
+        const alignmentSection = buildPoliticalAlignmentSection([...data.votingRecords], [], lang);
+        const analysis = buildVotingAnalysis(data.dateFromStr, data.date, data.votingRecords, data.votingPatterns, data.anomalies, data.questions);
+        const deepSection = buildDeepAnalysisSection(analysis, lang, 'en');
+        const mindmapData = buildVotingMindmap(data.votingRecords, data.votingPatterns, data.anomalies, lang);
+        const mindmapSection = buildIntelligenceMindmapSection(mindmapData, lang);
+        const swotData = buildVotingSwot(data.votingRecords, data.votingPatterns, data.anomalies, lang);
+        const swotSection = buildSwotSection(swotData, lang);
+        const hasRealVotingData = data.votingRecords.some((r) => r.result !== PLACEHOLDER_MARKER);
+        const dashboardData = hasRealVotingData
+            ? buildVotingDashboard(data.votingRecords, data.votingPatterns, data.anomalies, lang)
+            : null;
+        const dashboardSection = buildDashboardSection(dashboardData, lang);
+        // Inject at the explicit <!-- /article-content --> marker so the section
+        // stays inside the .article-content styling scope. The marker is always
+        // emitted by generateMotionsContent as the last child of that wrapper and
+        // is removed from the final HTML during this replacement.
+        const injection = adoptedTextsSection +
+            (alignmentSection || '') +
+            deepSection +
+            mindmapSection +
+            swotSection +
+            dashboardSection;
+        if (injection) {
+            return base.replace('<!-- /article-content -->', `${injection}\n`);
+        }
+        return base.replace('<!-- /article-content -->', '');
+    }
+    /**
+     * Return language-specific metadata for the motions article.
+     *
+     * @param data - Motions data payload
+     * @param lang - Target language code
+     * @returns Localised metadata
+     */
+    getMetadata(data, lang) {
+        const titleFn = getLocalizedString(MOTIONS_TITLES, lang);
+        const { title: baseTitle, subtitle: baseSubtitle } = titleFn(data.date);
+        const suffix = lang === 'en' ? buildMotionsTitleSuffix(data) : '';
+        const title = suffix ? `${baseTitle} — ${suffix}` : baseTitle;
+        const description = lang === 'en' ? buildMotionsDescription(data) : '';
+        const subtitle = description || baseSubtitle;
+        return {
+            title,
+            subtitle,
+            keywords: buildMotionsKeywords(data),
+            category: ArticleCategory.MOTIONS,
+            sources: [],
+        };
+    }
+}
+/** Singleton instance for use by the strategy registry */
+export const motionsStrategy = new MotionsStrategy();
+//# sourceMappingURL=motions-strategy.js.map

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

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

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

@@ -0,0 +1,60 @@
+/**
+ * @module Generators/Strategies/PropositionsStrategy
+ * @description Article strategy for the Propositions article type.
+ * Fetches legislative proposals and active pipeline data from MCP, then
+ * renders a language-specific legislative overview article.
+ */
+import type { EuropeanParliamentMCPClient } from '../../mcp/ep-mcp-client.js';
+import { ArticleCategory } from '../../types/index.js';
+import type { LanguageCode, EPFeedData } from '../../types/index.js';
+import type { PipelineData } from '../propositions-content.js';
+import type { ArticleStrategy, ArticleData, ArticleMetadata } from './article-strategy.js';
+/** Data fetched and pre-processed by {@link PropositionsStrategy} */
+export interface PropositionsArticleData extends ArticleData {
+    /** Pre-sanitised HTML for the legislative procedures list section */
+    readonly proposalsHtml: string;
+    /** Pre-sanitised HTML for the recently adopted texts section */
+    readonly adoptedTextsHtml: string;
+    /** Active legislative pipeline data (null when MCP unavailable) */
+    readonly pipelineData: PipelineData | null;
+    /** Pre-sanitised HTML for the tracked procedure section */
+    readonly procedureHtml: string;
+    /** EP feed data for enrichment (when available) */
+    readonly feedData?: EPFeedData | undefined;
+}
+/**
+ * Article strategy for {@link ArticleCategory.PROPOSITIONS}.
+ * Fetches legislative proposals, active pipeline status, and procedure detail
+ * then renders a language-specific article.
+ */
+export declare class PropositionsStrategy implements ArticleStrategy<PropositionsArticleData> {
+    readonly type = ArticleCategory.PROPOSITIONS;
+    readonly requiredMCPTools: readonly ["search_documents", "monitor_legislative_pipeline", "track_legislation", "get_procedures_feed", "get_adopted_texts_feed"];
+    /**
+     * Fetch legislative proposals and pipeline data in parallel.
+     *
+     * @param client - MCP client or null
+     * @param date - ISO 8601 publication date
+     * @returns Populated propositions data payload
+     */
+    fetchData(client: EuropeanParliamentMCPClient | null, date: string): Promise<PropositionsArticleData>;
+    /**
+     * Build the propositions HTML body using language-specific strings.
+     *
+     * @param data - Propositions data payload
+     * @param lang - Target language code
+     * @returns Article HTML body
+     */
+    buildContent(data: PropositionsArticleData, lang: LanguageCode): string;
+    /**
+     * Return language-specific metadata for the propositions article.
+     *
+     * @param data - Propositions data payload
+     * @param lang - Target language code
+     * @returns Localised metadata
+     */
+    getMetadata(data: PropositionsArticleData, lang: LanguageCode): ArticleMetadata;
+}
+/** Singleton instance for use by the strategy registry */
+export declare const propositionsStrategy: PropositionsStrategy;
+//# sourceMappingURL=propositions-strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propositions-strategy.d.ts","sourceRoot":"","sources":["../../../src/generators/strategies/propositions-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,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAyBrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA2I3F,qEAAqE;AACrE,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,mEAAmE;IACnE,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC5C;AAID;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,eAAe,CAAC,uBAAuB,CAAC;IACnF,QAAQ,CAAC,IAAI,gCAAgC;IAE7C,QAAQ,CAAC,gBAAgB,sIAMd;IAEX;;;;;;OAMG;IACG,SAAS,CACb,MAAM,EAAE,2BAA2B,GAAG,IAAI,EAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,uBAAuB,CAAC;IAsDnC;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM;IAoCvE;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe;CAehF;AAED,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

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

@@ -0,0 +1,257 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+import { ArticleCategory } from '../../types/index.js';
+import { escapeHTML } from '../../utils/file-utils.js';
+import { PROPOSITIONS_TITLES, PROPOSITIONS_STRINGS, getLocalizedString, } from '../../constants/languages.js';
+import { computeRollingDateRange, fetchProposalsFromMCP, fetchPipelineFromMCP, fetchProcedureStatusFromMCP, fetchEPFeedData, } from '../pipeline/fetch-stage.js';
+import { buildPropositionsContent } from '../propositions-content.js';
+import { buildDeepAnalysisSection } from '../deep-analysis-content.js';
+import { buildPropositionsAnalysis, buildPropositionsSwot, buildPropositionsDashboard, buildPropositionsMindmap, } 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 Propositions articles */
+const PROPOSITIONS_BASE_KEYWORDS = [
+    'European Parliament',
+    'legislation',
+    'proposals',
+    'procedure',
+    'OLP',
+];
+/**
+ * Extract content-aware keywords from propositions data and feed.
+ *
+ * Adds procedure titles, adopted text titles, and pipeline health
+ * indicators to the base keyword set.
+ *
+ * @param data - Propositions article data payload
+ * @returns Deduplicated keyword array
+ */
+function buildPropositionsKeywords(data) {
+    const keywords = [...PROPOSITIONS_BASE_KEYWORDS];
+    if (data.feedData?.procedures) {
+        for (const proc of data.feedData.procedures.slice(0, 5)) {
+            if (proc.title)
+                keywords.push(proc.title.slice(0, 60));
+        }
+    }
+    if (data.feedData?.adoptedTexts) {
+        for (const text of data.feedData.adoptedTexts.slice(0, 3)) {
+            if (text.title)
+                keywords.push(text.title.slice(0, 60));
+        }
+    }
+    if (data.pipelineData) {
+        keywords.push('legislative pipeline');
+        if (data.pipelineData.healthScore >= 0.8)
+            keywords.push('healthy pipeline');
+    }
+    return [...new Set(keywords)];
+}
+/**
+ * Build a content-aware description from propositions data.
+ * Summarises pipeline health, procedure counts, and adopted text counts.
+ *
+ * @param data - Propositions article data payload
+ * @returns SEO-friendly description (≤ 200 chars)
+ */
+function buildPropositionsDescription(data) {
+    const parts = [];
+    const procCount = data.feedData?.procedures?.length ?? 0;
+    const adoptedCount = data.feedData?.adoptedTexts?.length ?? 0;
+    // Count proposals by the number of proposal-card divs in the HTML
+    const proposalMatches = data.proposalsHtml.match(/proposal-card/gu);
+    const proposalCount = proposalMatches ? proposalMatches.length : 0;
+    if (proposalCount > 0)
+        parts.push(`${proposalCount} active proposals`);
+    if (procCount > 0)
+        parts.push(`${procCount} procedures tracked`);
+    if (adoptedCount > 0)
+        parts.push(`${adoptedCount} recently adopted texts`);
+    if (data.pipelineData) {
+        const healthPct = Math.round(data.pipelineData.healthScore * 100);
+        parts.push(`pipeline health ${healthPct}%`);
+    }
+    if (parts.length === 0) {
+        return 'Recent legislative proposals, procedure tracking, and pipeline status in the European Parliament';
+    }
+    const desc = `EP legislative tracker: ${parts.join(', ')}.`;
+    return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
+}
+/**
+ * Build a content-aware title suffix from propositions data.
+ *
+ * @param data - Propositions article data payload
+ * @returns Short suffix for the title, or empty string
+ */
+function buildPropositionsTitleSuffix(data) {
+    const parts = [];
+    const procCount = data.feedData?.procedures?.length ?? 0;
+    const adoptedCount = data.feedData?.adoptedTexts?.length ?? 0;
+    if (procCount > 0)
+        parts.push(pl(procCount, 'Procedure', 'Procedures'));
+    if (adoptedCount > 0)
+        parts.push(pl(adoptedCount, 'Adopted Text', 'Adopted Texts'));
+    if (data.pipelineData && parts.length === 0) {
+        const healthPct = Math.round(data.pipelineData.healthScore * 100);
+        parts.push(`Pipeline ${healthPct}%`);
+    }
+    return parts.join(', ');
+}
+/**
+ * Build procedures and adopted-texts HTML separately from EP feed data when
+ * search_documents returns empty. Uses procedures and adopted texts from the
+ * feed as fallback content, rendering each as a distinct section.
+ *
+ * @param feedData - EP feed data containing procedures and adopted texts
+ * @returns Pre-sanitized HTML for procedures and adopted texts sections separately
+ */
+function buildProceduresAndAdoptedTextsFromFeed(feedData) {
+    const procedureItems = [];
+    const adoptedTextItems = [];
+    for (const proc of feedData.procedures.slice(0, 8)) {
+        procedureItems.push(`
+      <div class="proposal-card">
+        <h3>${escapeHTML(proc.title || proc.id)}</h3>
+        <div class="proposal-meta">
+          <span class="proposal-id">${escapeHTML(proc.identifier ?? proc.id)}</span>
+          ${proc.date ? `<span class="proposal-date">${escapeHTML(proc.date)}</span>` : ''}
+          ${proc.stage ? `<span class="proposal-status">${escapeHTML(proc.stage)}</span>` : ''}
+        </div>
+      </div>`);
+    }
+    for (const text of feedData.adoptedTexts.slice(0, 8)) {
+        adoptedTextItems.push(`
+      <div class="proposal-card">
+        <h3>${escapeHTML(text.title || text.id)}</h3>
+        <div class="proposal-meta">
+          <span class="proposal-id">${escapeHTML(text.identifier ?? text.id)}</span>
+          ${text.date ? `<span class="proposal-date">${escapeHTML(text.date)}</span>` : ''}
+        </div>
+      </div>`);
+    }
+    return {
+        proceduresHtml: procedureItems.join('\n'),
+        adoptedTextsHtml: adoptedTextItems.join('\n'),
+    };
+}
+// ─── Strategy implementation ──────────────────────────────────────────────────
+/**
+ * Article strategy for {@link ArticleCategory.PROPOSITIONS}.
+ * Fetches legislative proposals, active pipeline status, and procedure detail
+ * then renders a language-specific article.
+ */
+export class PropositionsStrategy {
+    type = ArticleCategory.PROPOSITIONS;
+    requiredMCPTools = [
+        'search_documents',
+        'monitor_legislative_pipeline',
+        'track_legislation',
+        'get_procedures_feed',
+        'get_adopted_texts_feed',
+    ];
+    /**
+     * Fetch legislative proposals and pipeline data in parallel.
+     *
+     * @param client - MCP client or null
+     * @param date - ISO 8601 publication date
+     * @returns Populated propositions data payload
+     */
+    async fetchData(client, date) {
+        const feedDateRange = computeRollingDateRange(date, 7, 'propositions feed window');
+        if (client) {
+            console.log('  📡 Fetching legislative data from MCP server...');
+        }
+        // Fetch proposals, pipeline, and EP feed data in parallel
+        const [proposalsResult, pipelineResult, feedData] = await Promise.allSettled([
+            fetchProposalsFromMCP(client),
+            fetchPipelineFromMCP(client),
+            fetchEPFeedData(client, 'one-week', feedDateRange),
+        ]);
+        const { html: proposalsHtml, firstProcedureId } = proposalsResult.status === 'fulfilled'
+            ? proposalsResult.value
+            : { html: '', firstProcedureId: '' };
+        const pipelineData = pipelineResult.status === 'fulfilled' ? pipelineResult.value : null;
+        const feedResult = feedData.status === 'fulfilled' ? feedData.value : undefined;
+        const procedureHtml = await fetchProcedureStatusFromMCP(client, firstProcedureId);
+        // When search_documents returns empty but feed data has procedures/adopted texts,
+        // build proposals HTML from the feed data as fallback
+        let finalProposalsHtml = proposalsHtml;
+        let finalAdoptedTextsHtml = '';
+        if (!finalProposalsHtml && feedResult) {
+            const hasFeedItems = feedResult.procedures.length > 0 || feedResult.adoptedTexts.length > 0;
+            if (hasFeedItems) {
+                console.log(`  📰 Building procedures/adopted-texts from feed data: ${feedResult.procedures.length} procedures, ${feedResult.adoptedTexts.length} adopted texts`);
+                const feedHtml = buildProceduresAndAdoptedTextsFromFeed(feedResult);
+                finalProposalsHtml = feedHtml.proceduresHtml;
+                finalAdoptedTextsHtml = feedHtml.adoptedTextsHtml;
+            }
+        }
+        if (!finalProposalsHtml && !finalAdoptedTextsHtml) {
+            console.log('  ℹ️ No proposals from MCP — pipeline article will be data-free');
+        }
+        return {
+            date,
+            proposalsHtml: finalProposalsHtml,
+            adoptedTextsHtml: finalAdoptedTextsHtml,
+            pipelineData,
+            procedureHtml,
+            feedData: feedResult,
+        };
+    }
+    /**
+     * Build the propositions HTML body using language-specific strings.
+     *
+     * @param data - Propositions data payload
+     * @param lang - Target language code
+     * @returns Article HTML body
+     */
+    buildContent(data, lang) {
+        const strings = getLocalizedString(PROPOSITIONS_STRINGS, lang);
+        const base = buildPropositionsContent(data.proposalsHtml, data.adoptedTextsHtml, data.pipelineData, data.procedureHtml, strings, lang);
+        const analysis = buildPropositionsAnalysis(data.proposalsHtml, data.pipelineData, data.date, lang, data.adoptedTextsHtml);
+        const deepSection = buildDeepAnalysisSection(analysis, lang, 'en');
+        const mindmapData = buildPropositionsMindmap(data.pipelineData, lang);
+        const mindmapSection = buildIntelligenceMindmapSection(mindmapData, lang);
+        const swotData = buildPropositionsSwot(data.pipelineData, lang);
+        const swotSection = buildSwotSection(swotData, lang);
+        const dashboardData = buildPropositionsDashboard(data.pipelineData, 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 propositions article.
+     *
+     * @param data - Propositions data payload
+     * @param lang - Target language code
+     * @returns Localised metadata
+     */
+    getMetadata(data, lang) {
+        const titleFn = getLocalizedString(PROPOSITIONS_TITLES, lang);
+        const { title: baseTitle, subtitle: baseSubtitle } = titleFn();
+        const suffix = lang === 'en' ? buildPropositionsTitleSuffix(data) : '';
+        const title = suffix ? `${baseTitle} — ${suffix}` : baseTitle;
+        const helperSubtitle = lang === 'en' ? buildPropositionsDescription(data) : '';
+        const subtitle = helperSubtitle || baseSubtitle;
+        return {
+            title,
+            subtitle,
+            keywords: buildPropositionsKeywords(data),
+            category: ArticleCategory.PROPOSITIONS,
+            sources: [],
+        };
+    }
+}
+/** Singleton instance for use by the strategy registry */
+export const propositionsStrategy = new PropositionsStrategy();
+//# sourceMappingURL=propositions-strategy.js.map

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

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

package/scripts/generators/strategies/week-ahead-strategy.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @module Generators/Strategies/WeekAheadStrategy
+ * @description Article strategy for the Week Ahead article type.
+ * Fetches plenary sessions, committee meetings, documents, pipeline and
+ * parliamentary questions then renders a forward-looking HTML article.
+ */
+import type { EuropeanParliamentMCPClient } from '../../mcp/ep-mcp-client.js';
+import { ArticleCategory } from '../../types/index.js';
+import type { LanguageCode, DateRange, WeekAheadData, EPFeedData } from '../../types/index.js';
+import type { ArticleStrategy, ArticleData, ArticleMetadata } from './article-strategy.js';
+/** Data fetched and pre-processed by {@link WeekAheadStrategy} */
+export interface WeekAheadArticleData extends ArticleData {
+    /** Week-ahead date range */
+    readonly dateRange: DateRange;
+    /** Aggregated week-ahead domain data */
+    readonly weekData: WeekAheadData;
+    /** SEO keywords derived from the week-ahead data */
+    readonly keywords: readonly string[];
+    /** EP feed data for enrichment (when available) */
+    readonly feedData?: EPFeedData | undefined;
+}
+/**
+ * Article strategy for {@link ArticleCategory.WEEK_AHEAD}.
+ * Fetches plenary, committee, document, pipeline and question data then builds
+ * a forward-looking preview of the upcoming parliamentary week.
+ */
+export declare class WeekAheadStrategy implements ArticleStrategy<WeekAheadArticleData> {
+    readonly type = ArticleCategory.WEEK_AHEAD;
+    readonly requiredMCPTools: readonly ["get_plenary_sessions", "get_committee_info", "search_documents", "monitor_legislative_pipeline", "get_parliamentary_questions", "get_events", "get_events_feed", "get_plenary_documents_feed", "get_adopted_texts_feed"];
+    /**
+     * Fetch week-ahead data from MCP.
+     *
+     * @param client - MCP client or null
+     * @param date - ISO 8601 publication date
+     * @returns Populated week-ahead data payload
+     */
+    fetchData(client: EuropeanParliamentMCPClient | null, date: string): Promise<WeekAheadArticleData>;
+    /**
+     * Build the week-ahead HTML body for the specified language.
+     *
+     * @param data - Week-ahead data payload
+     * @param lang - Target language code used for editorial strings
+     * @returns Article HTML body
+     */
+    buildContent(data: WeekAheadArticleData, lang: LanguageCode): string;
+    /**
+     * Return language-specific metadata for the week-ahead article.
+     *
+     * @param data - Week-ahead data payload
+     * @param lang - Target language code
+     * @returns Localised metadata
+     */
+    getMetadata(data: WeekAheadArticleData, lang: LanguageCode): ArticleMetadata;
+}
+/** Singleton instance for use by the strategy registry */
+export declare const weekAheadStrategy: WeekAheadStrategy;
+//# sourceMappingURL=week-ahead-strategy.d.ts.map

package/scripts/generators/strategies/week-ahead-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"week-ahead-strategy.d.ts","sourceRoot":"","sources":["../../../src/generators/strategies/week-ahead-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,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAkB/F,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK3F,kEAAkE;AAClE,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC5C;AAuFD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,eAAe,CAAC,oBAAoB,CAAC;IAC7E,QAAQ,CAAC,IAAI,8BAA8B;IAE3C,QAAQ,CAAC,gBAAgB,sOAUd;IAEX;;;;;;OAMG;IACG,SAAS,CACb,MAAM,EAAE,2BAA2B,GAAG,IAAI,EAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,oBAAoB,CAAC;IAoBhC;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM;IAsBpE;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe;CAoB7E;AAED,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}