[{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/constants/analysis-constants.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/constants/committee-indicator-map.ts","messages":[],"suppressedMessages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":1325,"column":10,"endLine":1325,"endColumn":42,"suppressions":[{"kind":"directive","justification":"key validated via Object.hasOwn"}]}],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/constants/config.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/constants/language-articles.ts","messages":[],"suppressedMessages":[{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":40,"column":7,"endLine":40,"endColumn":22,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":44,"column":7,"endLine":44,"endColumn":28,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 16 times.","line":99,"column":7,"endLine":99,"endColumn":23,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":158,"column":7,"endLine":158,"endColumn":23,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":162,"column":7,"endLine":162,"endColumn":27,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":276,"column":7,"endLine":276,"endColumn":23,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":280,"column":7,"endLine":280,"endColumn":29,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 4 times.","line":281,"column":7,"endLine":281,"endColumn":21,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":335,"column":7,"endLine":335,"endColumn":21,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":339,"column":7,"endLine":339,"endColumn":31,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":394,"column":7,"endLine":394,"endColumn":27,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 4 times.","line":398,"column":7,"endLine":398,"endColumn":20,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":445,"column":7,"endLine":445,"endColumn":27,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 4 times.","line":449,"column":7,"endLine":449,"endColumn":20,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":496,"column":7,"endLine":496,"endColumn":21,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":500,"column":7,"endLine":500,"endColumn":27,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":555,"column":7,"endLine":555,"endColumn":26,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 3 times.","line":557,"column":7,"endLine":557,"endColumn":24,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 8 times.","line":591,"column":7,"endLine":591,"endColumn":24,"suppressions":[{"kind":"directive","justification":"Localized keyword dictionaries have intentional repetition across categories"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 4 times.","line":1673,"column":26,"endLine":1673,"endColumn":44,"suppressions":[{"kind":"directive","justification":"Translated analysis strings share common terms across languages"}]},{"ruleId":"sonarjs/no-duplicate-string","severity":2,"message":"Define a constant instead of duplicating this literal 4 times.","line":1740,"column":27,"endLine":1740,"endColumn":46,"suppressions":[{"kind":"directive","justification":"Translated analysis strings share common terms across languages"}]}],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/constants/language-core.ts","messages":[],"suppressedMessages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":84,"column":38,"endLine":84,"endColumn":47,"suppressions":[{"kind":"directive","justification":"key validated via Object.hasOwn"}]}],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/constants/language-ui.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/constants/languages.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/analysis-builders.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/breaking-content.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/builders/breaking-builders.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/builders/committee-builders.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/builders/index.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/builders/propositions-builders.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":102,"column":10,"endLine":102,"endColumn":40}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":1,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/Builders/PropositionsBuilders\n * @description Deep analysis, SWOT, dashboard and mindmap\n * builders for propositions articles.\n */\n\nimport type {\n DeepAnalysis,\n ActionConsequence,\n StakeholderOutcome,\n LanguageCode,\n SwotAnalysis,\n DashboardConfig,\n DashboardPanel,\n SwotBuilderStrings,\n DashboardBuilderStrings,\n IntelligenceMindmap,\n MindmapNode,\n ActorNode,\n PolicyConnection,\n StakeholderPerspective,\n LegislativePipeline,\n} from '../../types/index.js';\nimport type { PipelineData } from '../propositions-content.js';\nimport {\n getLocalizedString,\n SWOT_BUILDER_STRINGS,\n DASHBOARD_BUILDER_STRINGS,\n} from '../../constants/languages.js';\nimport { buildDefaultStakeholderPerspectives } from '../../utils/intelligence-analysis.js';\nimport { AI_MARKER } from '../../constants/analysis-constants.js';\nimport {\n buildOutcomeMatrix,\n buildFallbackImpactAssessment,\n buildStakeholderMetricsFromPipeline,\n buildStakeholderPanel,\n applyAnalysisOverrides,\n type AnalysisOverrides,\n CIVIL_SOCIETY,\n} from './shared-builders.js';\n\nconst CONFERENCE_OF_PRESIDENTS_EN = 'Conference of Presidents';\nconst CONFERENCE_OF_PRESIDENTS: Partial> = {\n en: CONFERENCE_OF_PRESIDENTS_EN,\n sv: 'Talmanskonferensen',\n da: 'Formandskonferencen',\n no: 'Formannskonferansen',\n fi: 'Puheenjohtajakokous',\n de: 'Konferenz der Präsidenten',\n fr: 'Conférence des présidents',\n es: 'Conferencia de Presidentes',\n nl: 'Conferentie van voorzitters',\n ar: '\\u0645\\u0624\\u062a\\u0645\\u0631 \\u0627\\u0644\\u0631\\u0624\\u0633\\u0627\\u0621',\n he: '\\u05d5\\u05e2\\u05d9\\u05d3\\u05ea \\u05d4\\u05e0\\u05e9\\u05d9\\u05d0\\u05d9\\u05dd',\n ja: '\\u8b70\\u9577\\u4f1a\\u8b70',\n ko: '\\uc758\\uc7a5\\ud68c\\uc758',\n zh: '\\u4e3b\\u5e2d\\u56e2\\u4f1a\\u8bae',\n};\n\n/**\n * Build multi-stakeholder perspectives for a propositions pipeline analysis.\n *\n * @param healthScore - Pipeline health score (0-1)\n * @param topic - Primary topic string for context\n * @returns Array of stakeholder perspectives\n */\nfunction buildPropositionsStakeholderPerspectives(\n healthScore: number,\n topic: string\n): StakeholderPerspective[] {\n return buildDefaultStakeholderPerspectives(topic, {\n political_groups: 0.7,\n civil_society: healthScore < 0.5 ? 0.3 : 0.5,\n industry: healthScore < 0.5 ? 0.3 : 0.6,\n national_govts: healthScore < 0.5 ? 0.3 : 0.6,\n citizens: healthScore < 0.5 ? 0.2 : 0.5,\n eu_institutions: 0.8,\n });\n}\n\n/**\n * Build the \"why\" explanation for propositions based on pipeline health.\n * Returns AI_MARKER so the gh-aw AI agent produces real political analysis\n * instead of template-generated prose.\n *\n * @returns AI_MARKER placeholder for AI-driven analysis\n */\nfunction buildPropositionsWhy(): string {\n return AI_MARKER;\n}\n\n/**\n * Get the localized Conference of Presidents name.\n *\n * @param lang - Target language code\n * @returns Localized name or English fallback\n */\nfunction getConferenceOfPresidents(lang: LanguageCode): string {\n return CONFERENCE_OF_PRESIDENTS[lang] ?? CONFERENCE_OF_PRESIDENTS_EN;\n}\n\n/**\n * Build the action-consequence pairs for propositions analysis.\n * Returns AI_MARKER for consequences so the AI agent writes real analysis.\n *\n * @param pct - Pipeline health percentage as string\n * @param healthScore - Pipeline health score (0-1)\n * @param throughput - Throughput rate\n * @returns Action-consequence pairs with AI_MARKER for consequence text\n */\nfunction buildPropositionsConsequences(\n pct: string,\n healthScore: number,\n throughput: number\n): ActionConsequence[] {\n const healthSeverity: ActionConsequence['severity'] =\n healthScore < 0.3 ? 'critical' : healthScore < 0.5 ? 'high' : 'medium';\n return [\n {\n action: `Pipeline health at ${pct}%`,\n consequence: AI_MARKER,\n severity: healthSeverity,\n },\n {\n action: `Throughput rate at ${throughput}`,\n consequence: AI_MARKER,\n severity: throughput < 5 ? 'high' : 'low',\n },\n ];\n}\n\n/**\n * Build the primary stakeholder outcome for propositions analysis.\n * Reasoning text is deferred to the AI agent via AI_MARKER.\n *\n * @param healthScore - Pipeline health score used for outcome classification\n * @param pct - Pipeline health percentage used as reasoning context\n * @returns Single stakeholder outcome with AI_MARKER reasoning\n */\nfunction buildPropositionsStakeholderOutcome(healthScore: number, pct: string): StakeholderOutcome {\n if (healthScore > 0.7) {\n return {\n actor: 'Parliament presidency',\n outcome: 'winner',\n reason: `${AI_MARKER} Pipeline health at ${pct}%`,\n };\n }\n return {\n actor: 'Pending legislation sponsors',\n outcome: 'loser',\n reason: `${AI_MARKER} Pipeline health at ${pct}%`,\n };\n}\n\n/**\n * Build a pipeline status breakdown panel for propositions dashboard.\n *\n * @param d - Localized strings\n * @param pipeline - Legislative pipeline data\n * @returns Panel object or null\n */\nfunction buildPropositionsPipelinePanel(\n d: DashboardBuilderStrings,\n pipeline: LegislativePipeline | null\n): DashboardPanel | null {\n if (!pipeline) return null;\n return {\n title: d.pipelineStatus,\n metrics: [\n {\n label: d.onTrack,\n value: String(pipeline.onTrack),\n trend: (pipeline.onTrack > 0 ? 'up' : 'stable') as 'up' | 'down' | 'stable',\n },\n {\n label: d.delayed,\n value: String(pipeline.delayed),\n trend: (pipeline.delayed > 0 ? 'down' : 'stable') as 'up' | 'down' | 'stable',\n },\n {\n label: d.blocked,\n value: String(pipeline.blocked),\n trend: (pipeline.blocked > 0 ? 'down' : 'stable') as 'up' | 'down' | 'stable',\n },\n ],\n chart: {\n type: 'bar' as const,\n title: d.pipelineStatusChart,\n data: {\n labels: [d.onTrack, d.delayed, d.blocked],\n datasets: [\n {\n label: d.procedures,\n data: [pipeline.onTrack, pipeline.delayed, pipeline.blocked],\n backgroundColor: ['#28a745', '#ffc107', '#dc3545'],\n },\n ],\n },\n },\n };\n}\n\n/**\n * Resolve the pipeline strength label from a health score.\n *\n * @param d - Localized strings\n * @param healthScore - Health score 0-1\n * @returns Localized pipeline strength label\n */\nfunction resolvePipelineStrengthLabel(d: DashboardBuilderStrings, healthScore: number): string {\n if (healthScore > 0.7) return d.pipelineStrong;\n if (healthScore > 0.4) return d.pipelineModerate;\n return d.pipelineWeak;\n}\n\n/**\n * Build legislative pipeline data from PipelineData.\n *\n * @param pipelineData - Pipeline metrics or null\n * @returns Legislative pipeline object\n */\nfunction buildPipelineFromPipelineData(\n pipelineData: { healthScore: number; throughput: number } | null\n): LegislativePipeline | null {\n if (!pipelineData) return null;\n const healthScore = Math.round(pipelineData.healthScore * 100);\n const total = pipelineData.throughput;\n if (total === 0) return null;\n\n const onTrack = Math.round(total * pipelineData.healthScore);\n const remaining = total - onTrack;\n const blocked = Math.round(remaining * 0.3);\n const delayed = remaining - blocked;\n\n return {\n healthScore,\n onTrack,\n delayed,\n blocked,\n fastTracked: 0,\n total,\n };\n}\n\n/**\n * Build deep analysis for propositions articles.\n *\n * @param proposalsHtml - Proposals HTML (used to detect content presence)\n * @param pipelineData - Pipeline metrics\n * @param date - Publication date\n * @param lang - Target display language (default: 'en')\n * @param adoptedTextsHtml - Adopted texts HTML (also used to detect content presence)\n * @param overrides - Optional AI-authored overrides (see Analysis-to-Article\n * Data Contract in `.github/prompts/SHARED_PROMPT_PATTERNS.md`).\n * @returns Deep analysis object, with overrides applied when present.\n */\nexport function buildPropositionsAnalysis(\n proposalsHtml: string,\n pipelineData: PipelineData | null,\n date: string,\n lang: LanguageCode = 'en',\n adoptedTextsHtml: string = '',\n overrides?: AnalysisOverrides\n): DeepAnalysis {\n const hasProposals = proposalsHtml.length > 0 || adoptedTextsHtml.length > 0;\n const healthScore = pipelineData?.healthScore ?? 0;\n const throughput = pipelineData?.throughput ?? 0;\n const pct = (healthScore * 100).toFixed(0);\n\n const base: DeepAnalysis = {\n what: hasProposals\n ? `Legislative pipeline assessment as of ${date}: Active proposals under consideration.`\n : `Legislative pipeline assessment as of ${date}: No new proposals detected in this period.`,\n who: [\n 'European Commission (proposal originator)',\n 'Rapporteurs (responsible for steering through committee)',\n 'Shadow rapporteurs (political group negotiators)',\n 'Council of the EU (co-legislator)',\n ],\n when: [`Assessment date: ${date}`, 'Pipeline health reflects cumulative legislative progress'],\n why: buildPropositionsWhy(),\n stakeholderOutcomes: [buildPropositionsStakeholderOutcome(healthScore, pct)],\n impactAssessment: buildFallbackImpactAssessment(),\n actionConsequences: buildPropositionsConsequences(pct, healthScore, throughput),\n mistakes:\n healthScore < 0.5\n ? [\n {\n actor: getConferenceOfPresidents(lang),\n description: `Pipeline health dropped to ${pct}%`,\n alternative: AI_MARKER,\n },\n ]\n : [],\n outlook: AI_MARKER,\n stakeholderPerspectives: buildPropositionsStakeholderPerspectives(\n healthScore,\n `legislative pipeline as of ${date}`\n ),\n stakeholderOutcomeMatrix: buildOutcomeMatrix([\n {\n action: `Pipeline health at ${pct}% (throughput ${throughput})`,\n scores: {\n political_groups: 0.7,\n civil_society: healthScore < 0.5 ? 0.3 : 0.5,\n industry: healthScore < 0.5 ? 0.3 : 0.6,\n national_govts: healthScore < 0.5 ? 0.3 : 0.6,\n citizens: healthScore < 0.5 ? 0.2 : 0.5,\n eu_institutions: 0.8,\n },\n confidence: pipelineData !== null ? 'high' : 'low',\n },\n ]),\n };\n return applyAnalysisOverrides(base, overrides);\n}\n\n/**\n * Build SWOT analysis for propositions articles.\n *\n * @param pipelineData - Pipeline metrics\n * @param lang - Target language code\n * @returns SWOT analysis data\n */\nexport function buildPropositionsSwot(\n pipelineData: PipelineData | null,\n lang: LanguageCode = 'en'\n): SwotAnalysis {\n const s: SwotBuilderStrings = getLocalizedString(SWOT_BUILDER_STRINGS, lang);\n const healthScore = pipelineData?.healthScore ?? 0;\n const throughput = pipelineData?.throughput ?? 0;\n const pct = (healthScore * 100).toFixed(0);\n\n return {\n strengths: [\n ...(healthScore > 0.7\n ? [\n {\n text: s.propositionsHealthStrong(pct),\n severity: 'high' as const,\n },\n ]\n : []),\n ...(throughput >= 5\n ? [\n {\n text: s.propositionsThroughputGood(throughput),\n severity: 'medium' as const,\n },\n ]\n : []),\n ],\n weaknesses: [\n ...(healthScore < 0.5\n ? [\n {\n text: s.propositionsHealthWeak(pct),\n severity: 'high' as const,\n },\n ]\n : []),\n ...(throughput < 5\n ? [\n {\n text: s.propositionsThroughputLow(throughput),\n severity: 'medium' as const,\n },\n ]\n : []),\n ],\n opportunities: [\n {\n text: s.propositionsPrioritisation,\n severity: 'medium' as const,\n },\n {\n text: s.propositionsTrilogueAcceleration,\n severity: 'medium' as const,\n },\n ],\n threats: [\n ...(healthScore < 0.3\n ? [\n {\n text: s.propositionsCriticalCongestion,\n severity: 'high' as const,\n },\n ]\n : []),\n {\n text: s.propositionsOverlapping,\n severity: 'medium' as const,\n },\n ],\n };\n}\n\n/**\n * Build dashboard for propositions articles.\n * Includes color-coded pipeline status chart and stakeholder scorecard.\n *\n * @param pipelineData - Pipeline metrics\n * @param lang - Target language code\n * @returns Dashboard configuration with pipeline intelligence panels\n */\nexport function buildPropositionsDashboard(\n pipelineData: PipelineData | null,\n lang: LanguageCode = 'en'\n): DashboardConfig {\n const d: DashboardBuilderStrings = getLocalizedString(DASHBOARD_BUILDER_STRINGS, lang);\n const healthScore = pipelineData?.healthScore ?? 0;\n const throughput = pipelineData?.throughput ?? 0;\n const pct = (healthScore * 100).toFixed(0);\n\n const healthPanel = {\n title: d.pipelineHealth,\n metrics: [\n {\n label: d.healthScore,\n value: `${pct}%`,\n trend: (healthScore > 0.7 ? 'up' : healthScore < 0.5 ? 'down' : 'stable') as\n | 'up'\n | 'down'\n | 'stable',\n },\n {\n label: d.throughput,\n value: String(throughput),\n trend: throughput >= 5 ? ('up' as const) : ('down' as const),\n },\n {\n label: d.status,\n value: resolvePipelineStrengthLabel(d, healthScore),\n },\n ],\n };\n\n // Pipeline status breakdown panel\n const pipeline = buildPipelineFromPipelineData(pipelineData);\n const pipelinePanel = buildPropositionsPipelinePanel(d, pipeline);\n\n // Stakeholder impact scorecard for pipeline actors\n const stakeholderMetrics = buildStakeholderMetricsFromPipeline(pipeline);\n const stakeholderPanel = buildStakeholderPanel(d, stakeholderMetrics);\n\n const panels = [\n healthPanel,\n ...(pipelinePanel ? [pipelinePanel] : []),\n ...(stakeholderPanel ? [stakeholderPanel] : []),\n ];\n\n return { panels };\n}\n\n/**\n * Build intelligence mindmap for propositions / legislative pipeline articles.\n *\n * Maps the legislative pipeline stages as policy domain nodes with procedure\n * health and throughput indicators.\n *\n * @param pipelineData - Legislative pipeline metrics (null when unavailable)\n * @param _lang - Reserved for future localisation (default: 'en')\n * @returns Intelligence mindmap data\n */\nexport function buildPropositionsMindmap(\n pipelineData: { healthScore: number; throughput: number } | null,\n _lang: LanguageCode = 'en'\n): IntelligenceMindmap {\n void _lang;\n const healthScore = pipelineData?.healthScore ?? 0;\n const throughput = pipelineData?.throughput ?? 0;\n const healthPct = (healthScore * 100).toFixed(0);\n\n const pipelineStages: MindmapNode[] = [\n {\n id: 'proposal',\n label: 'Commission Proposals',\n category: 'policy_domain' as const,\n influence: 0.9,\n color: 'cyan',\n children: [\n {\n id: 'proposal-review',\n label: 'Initial Committee Review',\n category: 'action' as const,\n influence: 0.7,\n color: 'cyan',\n children: [],\n metadata: { committee: 'Lead Committee' },\n },\n ],\n },\n {\n id: 'committee',\n label: 'Committee Stage',\n category: 'policy_domain' as const,\n influence: 0.85,\n color: 'green',\n children: [\n {\n id: 'rapporteur',\n label: 'Rapporteur Report',\n category: 'action' as const,\n influence: 0.8,\n color: 'green',\n children: [],\n },\n {\n id: 'amendments',\n label: 'Amendments',\n category: 'action' as const,\n influence: 0.75,\n color: 'yellow',\n children: [],\n },\n ],\n },\n {\n id: 'plenary',\n label: 'Plenary Vote',\n category: 'policy_domain' as const,\n influence: healthScore,\n color: healthScore > 0.7 ? 'green' : healthScore > 0.4 ? 'yellow' : 'red',\n children: [\n {\n id: 'plenary-debate',\n label: 'Debate',\n category: 'action' as const,\n influence: 0.7,\n color: 'blue',\n children: [],\n },\n ],\n },\n {\n id: 'trilogue',\n label: 'Inter-institutional Trilogue',\n category: 'policy_domain' as const,\n influence: 0.8,\n color: 'orange',\n children: [\n {\n id: 'council-position',\n label: 'Council Position',\n category: 'actor' as const,\n influence: 0.85,\n color: 'orange',\n children: [],\n metadata: { committee: 'Council of the EU' },\n },\n ],\n },\n {\n id: 'adoption',\n label: 'Final Adoption',\n category: 'outcome' as const,\n influence: healthScore > 0.5 ? 0.9 : 0.4,\n color: healthScore > 0.5 ? 'green' : 'red',\n children: [],\n },\n ];\n\n const actorNetwork: ActorNode[] = [\n {\n id: 'commission',\n name: 'European Commission',\n type: 'external' as const,\n influence: 0.9,\n connections: ['proposal'],\n },\n {\n id: 'parliament',\n name: 'European Parliament',\n type: 'committee' as const,\n influence: 0.95,\n connections: ['committee', 'plenary'],\n },\n {\n id: 'council',\n name: 'Council of the EU',\n type: 'external' as const,\n influence: 0.9,\n connections: ['trilogue', 'adoption'],\n },\n ];\n\n const connections: PolicyConnection[] = [\n {\n from: 'proposal',\n to: 'committee',\n strength: 'strong',\n type: 'legislative',\n evidence: 'Formal referral to committee',\n },\n {\n from: 'committee',\n to: 'plenary',\n strength: 'strong',\n type: 'procedural',\n evidence: 'Committee report referred to plenary',\n },\n {\n from: 'plenary',\n to: 'trilogue',\n strength: throughput > 5 ? 'strong' : 'moderate',\n type: 'legislative',\n evidence: 'Parliament position triggers inter-institutional negotiations',\n },\n {\n from: 'trilogue',\n to: 'adoption',\n strength: healthScore > 0.6 ? 'strong' : 'weak',\n type: 'legislative',\n evidence: `Pipeline health: ${healthPct}%`,\n },\n ];\n\n return {\n centralTopic: 'Legislative Pipeline Intelligence',\n layers: [{ depth: 1, nodes: pipelineStages }],\n connections,\n actorNetwork,\n stakeholderGroups: ['Commission', 'Parliament', 'Council', 'Businesses', CIVIL_SOCIETY],\n summary: `Pipeline health: ${healthPct}%. Throughput rate: ${throughput}. ${throughput > 5 ? 'Strong legislative momentum.' : 'Moderate legislative pace.'}`,\n };\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/builders/prospective-builders.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/builders/shared-builders.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":83,"column":19,"endLine":83,"endColumn":50},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":85,"column":9,"endLine":85,"endColumn":20},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":227,"column":55,"endLine":227,"endColumn":70}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":3,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/Builders/SharedBuilders\n * @description Shared helper functions used across multiple analysis builder\n * domains. Includes outcome matrix construction, AI marker impact assessments,\n * coalition metrics, pipeline builders, and trend analytics.\n */\n\nimport type {\n DeepAnalysis,\n StakeholderOutcomeMatrix,\n AnalysisStakeholderType,\n CoalitionMetrics,\n LegislativePipeline,\n TrendAnalytics,\n DashboardPanel,\n DashboardBuilderStrings,\n WeekAheadData,\n VotingPattern,\n StakeholderMetric,\n StakeholderPerspective,\n} from '../../types/index.js';\nimport { buildStakeholderOutcomeMatrix } from '../../utils/intelligence-analysis.js';\nimport { AI_MARKER } from '../../constants/analysis-constants.js';\n\n// ─── Analysis override types ─────────────────────────────────────────────────\n\n/**\n * Optional AI-authored overrides that callers may supply to the five\n * `build*Analysis()` functions. When a field is present and non-empty, it\n * replaces the corresponding section of the default template-derived\n * {@link DeepAnalysis} object.\n *\n * These overrides are typically sourced from loaded analysis markdown via\n * {@link module:Utils/ParseAnalysisStakeholders} and close the\n * Analysis-to-Article Data Contract gap documented in\n * `.github/prompts/SHARED_PROMPT_PATTERNS.md`.\n */\nexport interface AnalysisOverrides {\n /** Replace the default six-bucket stakeholder perspective array */\n readonly stakeholderPerspectives?: readonly StakeholderPerspective[] | null | undefined;\n /** Replace the default stakeholder outcome matrix */\n readonly stakeholderOutcomeMatrix?: readonly StakeholderOutcomeMatrix[] | null | undefined;\n /** Replace the `AI_MARKER` placeholders in every impact-assessment dimension */\n readonly impactAssessment?: DeepAnalysis['impactAssessment'] | null | undefined;\n}\n\n/**\n * Merge a caller-supplied {@link AnalysisOverrides} set into the default\n * `DeepAnalysis` produced by a builder.\n *\n * Undefined, null, and empty array/record overrides are ignored, so callers\n * can pass a single unified overrides object across the five builders without\n * null-guarding every field.\n *\n * @param base - The builder's default `DeepAnalysis` object.\n * @param overrides - Optional AI-authored overrides (see {@link AnalysisOverrides}).\n * @returns The merged `DeepAnalysis`.\n */\nexport function applyAnalysisOverrides(\n base: DeepAnalysis,\n overrides?: AnalysisOverrides\n): DeepAnalysis {\n if (!overrides) return base;\n type Mutable = { -readonly [K in keyof DeepAnalysis]: DeepAnalysis[K] };\n const next: Mutable = { ...base };\n if (overrides.stakeholderPerspectives && overrides.stakeholderPerspectives.length > 0) {\n next.stakeholderPerspectives = [...overrides.stakeholderPerspectives];\n }\n if (overrides.stakeholderOutcomeMatrix && overrides.stakeholderOutcomeMatrix.length > 0) {\n next.stakeholderOutcomeMatrix = [...overrides.stakeholderOutcomeMatrix];\n }\n if (overrides.impactAssessment) {\n // Only overlay dimensions whose override is non-empty and not the AI_MARKER\n // sentinel, so partial AI-authored impact blocks can coexist with fallback\n // markers for missing dimensions.\n const merged: Record = {\n ...base.impactAssessment,\n };\n for (const key of ['political', 'economic', 'social', 'legal', 'geopolitical'] as const) {\n const val = overrides.impactAssessment[key];\n if (typeof val === 'string' && val.length > 0 && val !== AI_MARKER) {\n merged[key] = val;\n }\n }\n next.impactAssessment = merged;\n }\n return next;\n}\n\n// ─── Style constants ─────────────────────────────────────────────────────────\n\nexport const EP_BLUE_TRANSPARENT = 'rgba(0,51,153,0.1)';\n\nexport const EP_BLUE_BORDER = '#003399';\n\nexport const CIVIL_SOCIETY = 'Civil Society';\n\n/**\n * Build the stakeholder outcome matrix for a list of key actions.\n * Used by all 5 analysis builders to populate the outcome matrix.\n *\n * @param actions - Readonly array of (action, scores) pairs to include in the matrix\n * @returns Stakeholder outcome matrix rows\n */\nexport function buildOutcomeMatrix(\n actions: readonly {\n readonly action: string;\n readonly scores: Readonly>>;\n readonly confidence: 'high' | 'medium' | 'low';\n }[]\n): StakeholderOutcomeMatrix[] {\n return actions.map(({ action, scores, confidence }) =>\n buildStakeholderOutcomeMatrix(action, scores, confidence)\n );\n}\n\n/**\n * Build a placeholder impact assessment with every dimension marked `AI_MARKER`.\n *\n * This is the **last-resort fallback** used only when no AI-authored\n * `## Impact Assessment` block was parseable from the run's\n * `synthesis-summary.md` or `deep-analysis.md`. Agentic workflows should\n * satisfy the Analysis-to-Article Data Contract (see\n * `.github/prompts/SHARED_PROMPT_PATTERNS.md#-analysis-to-article-data-contract`)\n * so this fallback is never rendered. When it is rendered, the downstream\n * `article-rewriter` step replaces the `AI_MARKER` strings with real analysis\n * content before publication.\n *\n * @returns Impact assessment with `AI_MARKER` placeholders in every dimension.\n */\nexport function buildFallbackImpactAssessment(): DeepAnalysis['impactAssessment'] {\n return {\n political: AI_MARKER,\n economic: AI_MARKER,\n social: AI_MARKER,\n legal: AI_MARKER,\n geopolitical: AI_MARKER,\n };\n}\n\n/**\n * @deprecated Use {@link buildFallbackImpactAssessment} — the name was changed\n * to reflect that this is a last-resort path rather than the AI-integration\n * path. The alias is retained for backward compatibility with internal\n * callers and will be removed after all builders route through\n * `buildFallbackImpactAssessment`.\n */\nexport const buildAiMarkerImpactAssessment = buildFallbackImpactAssessment;\n\n/**\n * Build coalition metrics from voting patterns data.\n * Derives alignment scores and shift indicators for the coalition radar chart.\n *\n * @param patterns - Voting pattern data\n * @returns Coalition metrics object or null if no real patterns\n */\nexport function buildCoalitionMetricsFromPatterns(\n patterns: readonly VotingPattern[]\n): CoalitionMetrics | null {\n const realPatterns = patterns.filter((p) => !/placeholder/i.test(p.group));\n if (realPatterns.length === 0) return null;\n\n const avgCohesion = realPatterns.reduce((sum, p) => sum + p.cohesion, 0) / realPatterns.length;\n const alignmentScore = Math.round(avgCohesion * 100);\n\n // Detect shift from cohesion spread\n const maxCohesion = Math.max(...realPatterns.map((p) => p.cohesion));\n const minCohesion = Math.min(...realPatterns.map((p) => p.cohesion));\n const spread = maxCohesion - minCohesion;\n const shiftIndicator: CoalitionMetrics['shiftIndicator'] =\n spread > 0.3 ? 'weakening' : avgCohesion > 0.7 ? 'strengthening' : 'stable';\n\n return {\n alignmentScore,\n votingBlocs: realPatterns.slice(0, 6).map((p) => ({\n group: p.group,\n alignmentScore: Math.round(p.cohesion * 100),\n })),\n shiftIndicator,\n };\n}\n\n/**\n * Build legislative pipeline data from WeekAheadData.\n *\n * @param weekData - Aggregated week/month data\n * @returns Legislative pipeline object\n */\nexport function buildPipelineFromWeekData(weekData: WeekAheadData): LegislativePipeline {\n const bottlenecked = weekData.pipeline.filter((p) => p.bottleneck === true).length;\n const total = weekData.pipeline.length;\n const onTrack = total - bottlenecked;\n const healthScore = total > 0 ? Math.round((onTrack / total) * 100) : 100;\n\n return {\n healthScore,\n onTrack,\n delayed: bottlenecked,\n blocked: 0,\n fastTracked: 0,\n total,\n };\n}\n\n/**\n * Build trend analytics from feed data counts using the provided periods as-is.\n *\n * @param counts - Array of activity counts per period in chronological order\n * @param period - Trend period label\n * @returns Trend analytics object or null if no data\n */\nexport function buildTrendFromCounts(\n counts: readonly number[],\n period: TrendAnalytics['period']\n): TrendAnalytics | null {\n if (counts.length === 0 || counts.every((c) => c === 0)) return null;\n\n const periodLabels = counts.map((_, i) => {\n if (period === 'weekly') return `W${i + 1}`;\n if (period === 'monthly') return `M${i + 1}`;\n return `Q${i + 1}`;\n });\n\n const metrics = counts.map((value, i) => ({ period: periodLabels[i] ?? `${i + 1}`, value }));\n\n const last = counts.at(-1) ?? 0;\n const prev = counts.at(-2) ?? last;\n const change = prev > 0 ? ((last - prev) / prev) * 100 : 0;\n const direction: TrendAnalytics['direction'] =\n change > 5 ? 'improving' : change < -5 ? 'declining' : 'stable';\n\n return {\n period,\n metrics,\n direction,\n weekOverWeekChange: period === 'weekly' ? Math.round(change * 10) / 10 : undefined,\n monthOverMonthChange: period === 'monthly' ? Math.round(change * 10) / 10 : undefined,\n };\n}\n\n/**\n * Build stakeholder metrics from voting patterns.\n *\n * @param patterns - Voting patterns\n * @param anomalyCount - Number of anomalies\n * @returns Stakeholder metric array\n */\nexport function buildStakeholderMetricsFromVoting(\n patterns: readonly VotingPattern[],\n anomalyCount: number\n): StakeholderMetric[] {\n const realPatterns = patterns.filter((p) => !/placeholder/i.test(p.group));\n const metrics: StakeholderMetric[] = realPatterns.slice(0, 4).map((p) => ({\n stakeholder: p.group,\n impactScore: Math.round(p.cohesion * 100),\n impactDirection: (p.cohesion > 0.7 ? 'positive' : p.cohesion < 0.4 ? 'negative' : 'neutral') as\n | 'positive'\n | 'negative'\n | 'neutral',\n }));\n if (anomalyCount > 0) {\n metrics.push({\n stakeholder: 'Coalition stability',\n impactScore: Math.max(0, 100 - anomalyCount * 15),\n impactDirection: anomalyCount > 3 ? 'negative' : 'neutral',\n });\n }\n return metrics;\n}\n\n/**\n * Build stakeholder metrics for legislative pipeline actors.\n *\n * @param pipeline - Legislative pipeline data\n * @returns Stakeholder metric array\n */\nexport function buildStakeholderMetricsFromPipeline(\n pipeline: LegislativePipeline | null\n): StakeholderMetric[] {\n if (!pipeline || pipeline.total === 0) return [];\n return [\n {\n stakeholder: 'Legislators',\n impactScore: pipeline.healthScore,\n impactDirection:\n pipeline.healthScore > 70 ? 'positive' : pipeline.healthScore < 40 ? 'negative' : 'neutral',\n },\n {\n stakeholder: 'Pending proposals',\n impactScore: pipeline.total > 0 ? Math.round((pipeline.blocked / pipeline.total) * 100) : 0,\n impactDirection: pipeline.blocked > 0 ? 'negative' : 'neutral',\n description:\n pipeline.blocked > 0\n ? `${pipeline.blocked} blocked procedure${pipeline.blocked > 1 ? 's' : ''}`\n : undefined,\n },\n ];\n}\n\n/**\n * Build a stakeholder panel from stakeholder metric array.\n *\n * @param d - Localized strings\n * @param stakeholderMetrics - Stakeholder metric data\n * @returns Panel object or null\n */\nexport function buildStakeholderPanel(\n d: DashboardBuilderStrings,\n stakeholderMetrics: readonly StakeholderMetric[]\n): DashboardPanel | null {\n if (stakeholderMetrics.length === 0) return null;\n return {\n title: d.stakeholderImpact,\n metrics: stakeholderMetrics.map((s) => ({\n label: s.stakeholder,\n value: `${s.impactScore}/100`,\n trend: (s.impactDirection === 'positive'\n ? 'up'\n : s.impactDirection === 'negative'\n ? 'down'\n : 'stable') as 'up' | 'down' | 'stable',\n })),\n };\n}\n\n/**\n * Resolve a direction label from trend direction.\n *\n * @param d - Localized strings\n * @param direction - Trend direction\n * @returns Localized direction label\n */\nexport function resolveTrendDirectionLabel(\n d: DashboardBuilderStrings,\n direction: TrendAnalytics['direction']\n): string {\n if (direction === 'improving') return d.trendImproving;\n if (direction === 'declining') return d.trendDeclining;\n return d.trendStableLabel;\n}\n\n/**\n * Build a generic trend panel from a trend object.\n *\n * @param d - Localized strings\n * @param trend - Trend analytics\n * @param labels - Labels for x-axis\n * @param datasetLabel - Label for the dataset\n * @returns Panel object or null\n */\nexport function buildGenericTrendPanel(\n d: DashboardBuilderStrings,\n trend: TrendAnalytics | null,\n labels: string[],\n datasetLabel: string\n): DashboardPanel | null {\n if (!trend) return null;\n return {\n title: d.trendAnalysis,\n metrics: [\n {\n label: d.trendAnalysis,\n value: resolveTrendDirectionLabel(d, trend.direction),\n },\n ],\n chart: {\n type: 'line' as const,\n title: d.activityTrendChart,\n data: {\n labels,\n datasets: [\n {\n label: datasetLabel,\n data: trend.metrics.map((m) => m.value),\n borderColor: EP_BLUE_BORDER,\n backgroundColor: EP_BLUE_TRANSPARENT,\n },\n ],\n },\n },\n };\n}\n\n/**\n * Build a category distribution panel showing counts per category as a bar chart.\n * Unlike `buildGenericTrendPanel`, this does not compute direction or week-over-week\n * change metrics, which are only meaningful for chronological time-series data.\n *\n * @param d - Localized strings\n * @param labels - Category labels for x-axis\n * @param counts - Counts per category (must align with labels)\n * @param datasetLabel - Label for the dataset\n * @param title - Panel title\n * @returns Panel object or null if all counts are zero\n */\nexport function buildCategoryDistributionPanel(\n d: DashboardBuilderStrings,\n labels: readonly string[],\n counts: readonly number[],\n datasetLabel: string,\n title: string\n): DashboardPanel | null {\n if (counts.length === 0 || counts.every((c) => c === 0)) return null;\n return {\n title,\n metrics: [\n {\n label: d.trendAnalysis,\n value: `${counts.reduce((a, b) => a + b, 0)} total`,\n },\n ],\n chart: {\n type: 'bar' as const,\n title,\n data: {\n labels: [...labels],\n datasets: [\n {\n label: datasetLabel,\n data: [...counts],\n borderColor: EP_BLUE_BORDER,\n backgroundColor: EP_BLUE_TRANSPARENT,\n },\n ],\n },\n },\n };\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/builders/voting-builders.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/committee-helpers.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/dashboard-content.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/deep-analysis-content.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":778,"column":10,"endLine":778,"endColumn":26},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":798,"column":10,"endLine":798,"endColumn":21},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":817,"column":10,"endLine":817,"endColumn":23},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":833,"column":10,"endLine":833,"endColumn":22}],"suppressedMessages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":905,"column":25,"endLine":905,"endColumn":40,"suppressions":[{"kind":"directive","justification":"key from const array"}]}],"errorCount":0,"fatalErrorCount":0,"warningCount":4,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/DeepAnalysisContent\n * @description Pure functions for building the deep political analysis HTML\n * section using the \"5W + Impact\" framework. This section is injected into\n * every article type to provide parliament-intelligence-grade analysis.\n *\n * The framework covers:\n * - **What**: Core subject\n * - **Who**: Key actors (political groups, rapporteurs, MEPs, institutions)\n * - **When**: Timeline and key dates\n * - **Why**: Root causes and strategic motivations\n * - **Winners/Losers**: Stakeholder impact assessment\n * - **Impact**: Multi-perspective consequences (political, economic, social, legal, geopolitical)\n * - **Actions → Consequences**: Causal chains from decisions to outcomes\n * - **Mistakes**: Miscalculations and missed opportunities\n * - **Outlook**: Strategic forward look\n */\n\nimport { escapeHTML, isSafeURL } from '../utils/file-utils.js';\nimport { getLocalizedString, DEEP_ANALYSIS_STRINGS } from '../constants/languages.js';\nimport { isAiMarker, AI_PENDING_CLASS } from '../constants/analysis-constants.js';\nimport type {\n DeepAnalysis,\n DeepAnalysisStrings,\n StakeholderOutcome,\n ActionConsequence,\n PoliticalMistake,\n StakeholderPerspective,\n StakeholderOutcomeMatrix,\n AnalysisStakeholderType,\n EnhancedDeepAnalysis,\n ConfidenceLevel,\n ReasoningChain,\n ScenarioPlanning,\n AnalysisQualityMetadata,\n} from '../types/index.js';\nimport { ALL_STAKEHOLDER_TYPES } from '../types/index.js';\n\n// ─── AI pending notice helper ────────────────────────────────────────────────\n\n/**\n * Return an inline HTML notice for an AI-pending field.\n *\n * @param message - Short notice text (no HTML)\n * @returns Safe HTML string\n */\nfunction aiPendingNotice(message: string): string {\n return `${escapeHTML(message)}`;\n}\n\n// ─── Sub-section builders ────────────────────────────────────────────────────\n\n/**\n * Build the \"What\" sub-section\n *\n * @param what - Description of what happened\n * @param heading - Localized heading\n * @returns HTML string\n */\nfunction buildWhatSection(what: string, heading: string): string {\n if (!what) return '';\n return `\n
\n

${escapeHTML(heading)}

\n

${escapeHTML(what)}

\n
`;\n}\n\n/**\n * Build the \"Who\" sub-section with key actors list\n *\n * @param who - Array of actor names/descriptions\n * @param heading - Localized heading\n * @returns HTML string\n */\nfunction buildWhoSection(who: readonly string[], heading: string): string {\n if (who.length === 0) return '';\n const items = who.map((actor) => `
  • ${escapeHTML(actor)}
    • `).join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
      \n ${items}\n
    \n
    `;\n}\n\n/**\n * Build the \"When\" sub-section with timeline\n *\n * @param when - Array of date/milestone descriptions\n * @param heading - Localized heading\n * @returns HTML string\n */\nfunction buildWhenSection(when: readonly string[], heading: string): string {\n if (when.length === 0) return '';\n const items = when\n .map((milestone) => `
  • ${escapeHTML(milestone)}
    • `)\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
      \n ${items}\n
    \n
    `;\n}\n\n/**\n * Build the \"Why\" sub-section\n *\n * @param why - Root cause analysis text\n * @param heading - Localized heading\n * @param pendingNotice - Localized pending notice text for AI markers\n * @returns HTML string\n */\nfunction buildWhySection(why: string, heading: string, pendingNotice: string): string {\n if (!why) return '';\n if (isAiMarker(why)) {\n return `\n
    \n

    ${escapeHTML(heading)}

    \n

    ${aiPendingNotice(pendingNotice)}

    \n
    `;\n }\n return `\n
    \n

    ${escapeHTML(heading)}

    \n

    ${escapeHTML(why)}

    \n
    `;\n}\n\n/**\n * Map stakeholder outcome to CSS class\n *\n * @param outcome - Winner/loser/neutral\n * @returns CSS class name\n */\nfunction outcomeClass(outcome: StakeholderOutcome['outcome']): string {\n return `stakeholder-${outcome}`;\n}\n\n/**\n * Get localized label for stakeholder outcome\n *\n * @param outcome - Winner/loser/neutral\n * @param strings - Localized strings\n * @param strings.winnerLabel - Label for winning stakeholders\n * @param strings.loserLabel - Label for losing stakeholders\n * @param strings.neutralLabel - Label for neutral stakeholders\n * @returns Localized label\n */\nfunction outcomeLabel(\n outcome: StakeholderOutcome['outcome'],\n strings: { winnerLabel: string; loserLabel: string; neutralLabel: string }\n): string {\n switch (outcome) {\n case 'winner':\n return strings.winnerLabel;\n case 'loser':\n return strings.loserLabel;\n default:\n return strings.neutralLabel;\n }\n}\n\n/**\n * Build the \"Winners & Losers\" sub-section\n *\n * @param outcomes - Stakeholder assessments\n * @param heading - Localized heading\n * @param strings - Localized label strings\n * @param strings.winnerLabel - Label for winning stakeholders\n * @param strings.loserLabel - Label for losing stakeholders\n * @param strings.neutralLabel - Label for neutral stakeholders\n * @param strings.pendingNotice - Localized pending notice text for AI markers\n * @returns HTML string\n */\nfunction buildStakeholderSection(\n outcomes: readonly StakeholderOutcome[],\n heading: string,\n strings: { winnerLabel: string; loserLabel: string; neutralLabel: string; pendingNotice: string }\n): string {\n if (outcomes.length === 0) return '';\n const items = outcomes\n .map((s) => {\n const reasonText = isAiMarker(s.reason)\n ? aiPendingNotice(strings.pendingNotice)\n : escapeHTML(s.reason);\n return (\n `
  • ` +\n `${escapeHTML(outcomeLabel(s.outcome, strings))} ` +\n `${escapeHTML(s.actor)}: ${reasonText}` +\n `
    • `\n );\n })\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
      \n ${items}\n
    \n
    `;\n}\n\n/**\n * Build the multi-perspective \"Impact Assessment\" sub-section\n *\n * @param impact - Impact strings per perspective\n * @param heading - Localized heading\n * @param labels - Localized perspective labels\n * @param labels.politicalLabel - Label for political perspective\n * @param labels.economicLabel - Label for economic perspective\n * @param labels.socialLabel - Label for social perspective\n * @param labels.legalLabel - Label for legal perspective\n * @param labels.geopoliticalLabel - Label for geopolitical perspective\n * @param labels.pendingNotice - Localized pending notice text for AI markers\n * @returns HTML string\n */\nfunction buildImpactSection(\n impact: DeepAnalysis['impactAssessment'],\n heading: string,\n labels: {\n politicalLabel: string;\n economicLabel: string;\n socialLabel: string;\n legalLabel: string;\n geopoliticalLabel: string;\n pendingNotice: string;\n }\n): string {\n const perspectives = [\n { label: labels.politicalLabel, text: impact.political, css: 'impact-political' },\n { label: labels.economicLabel, text: impact.economic, css: 'impact-economic' },\n { label: labels.socialLabel, text: impact.social, css: 'impact-social' },\n { label: labels.legalLabel, text: impact.legal, css: 'impact-legal' },\n { label: labels.geopoliticalLabel, text: impact.geopolitical, css: 'impact-geopolitical' },\n ].filter((p) => p.text);\n if (perspectives.length === 0) return '';\n const items = perspectives\n .map((p) => {\n if (isAiMarker(p.text)) {\n return (\n `
    ` +\n `

    ${escapeHTML(p.label)}

    ` +\n `

    ${aiPendingNotice(labels.pendingNotice)}

    ` +\n `
    `\n );\n }\n return (\n `
    ` +\n `

    ${escapeHTML(p.label)}

    ` +\n `

    ${escapeHTML(p.text)}

    ` +\n `
    `\n );\n })\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
    \n ${items}\n
    \n
    `;\n}\n\n/**\n * Get localized severity label\n *\n * @param severity - Severity level\n * @param strings - Localized strings\n * @param strings.severityLow - Label for low severity\n * @param strings.severityMedium - Label for medium severity\n * @param strings.severityHigh - Label for high severity\n * @param strings.severityCritical - Label for critical severity\n * @returns Localized label\n */\nfunction severityLabel(\n severity: ActionConsequence['severity'],\n strings: {\n severityLow: string;\n severityMedium: string;\n severityHigh: string;\n severityCritical: string;\n }\n): string {\n switch (severity) {\n case 'low':\n return strings.severityLow;\n case 'medium':\n return strings.severityMedium;\n case 'high':\n return strings.severityHigh;\n case 'critical':\n return strings.severityCritical;\n default:\n return String(severity);\n }\n}\n\n/**\n * Build the \"Actions → Consequences\" sub-section\n *\n * @param items - Action-consequence pairs\n * @param heading - Localized heading\n * @param labels - Localized column labels\n * @param labels.actionLabel - Column header for action\n * @param labels.consequenceLabel - Column header for consequence\n * @param labels.severityColumnLabel - Column header for severity\n * @param strings - Localized severity strings\n * @param strings.severityLow - Label for low severity\n * @param strings.severityMedium - Label for medium severity\n * @param strings.severityHigh - Label for high severity\n * @param strings.severityCritical - Label for critical severity\n * @param strings.pendingNotice - Localized pending notice text for AI markers\n * @returns HTML string\n */\nfunction buildConsequencesSection(\n items: readonly ActionConsequence[],\n heading: string,\n labels: Readonly<\n Pick\n >,\n strings: {\n severityLow: string;\n severityMedium: string;\n severityHigh: string;\n severityCritical: string;\n pendingNotice: string;\n }\n): string {\n if (items.length === 0) return '';\n const rows = items\n .map((item) => {\n const consequenceText = isAiMarker(item.consequence)\n ? aiPendingNotice(strings.pendingNotice)\n : escapeHTML(item.consequence);\n return (\n `` +\n `${escapeHTML(item.action)}` +\n `→` +\n `${consequenceText}` +\n `${escapeHTML(severityLabel(item.severity, strings))}` +\n ``\n );\n })\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n \n \n \n \n \n \n \n \n \n \n ${rows}\n \n
    ${escapeHTML(labels.actionLabel)}${escapeHTML(labels.consequenceLabel)}${escapeHTML(labels.severityColumnLabel)}
    \n
    `;\n}\n\n/**\n * Build the \"Mistakes\" sub-section\n *\n * @param mistakes - Political mistake assessments\n * @param heading - Localized heading\n * @param alternativeLabel - Localized \"should have\" label\n * @param pendingNotice - Localized pending notice text for AI markers\n * @returns HTML string\n */\nfunction buildMistakesSection(\n mistakes: readonly PoliticalMistake[],\n heading: string,\n alternativeLabel: string,\n pendingNotice: string\n): string {\n if (mistakes.length === 0) return '';\n const items = mistakes\n .map((m) => {\n const altText = isAiMarker(m.alternative)\n ? aiPendingNotice(pendingNotice)\n : escapeHTML(m.alternative);\n return (\n `
    ` +\n `

    ${escapeHTML(m.actor)}

    ` +\n `

    ${escapeHTML(m.description)}

    ` +\n `

    ${escapeHTML(alternativeLabel)}: ${altText}

    ` +\n `
    `\n );\n })\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n ${items}\n
    `;\n}\n\n/**\n * Build the \"Strategic Outlook\" sub-section\n *\n * @param outlook - Forward-looking analysis text\n * @param heading - Localized heading\n * @param pendingNotice - Localized pending notice text for AI markers\n * @returns HTML string\n */\nfunction buildOutlookSection(outlook: string, heading: string, pendingNotice: string): string {\n if (!outlook) return '';\n if (isAiMarker(outlook)) {\n return `\n
    \n

    ${escapeHTML(heading)}

    \n

    ${aiPendingNotice(pendingNotice)}

    \n
    `;\n }\n return `\n
    \n

    ${escapeHTML(heading)}

    \n

    ${escapeHTML(outlook)}

    \n
    `;\n}\n\n// ─── Enhanced analysis section builders ──────────────────────────────────────\n\n/**\n * Type guard — checks whether an analysis object carries enhanced fields\n *\n * @param a - Base deep analysis to test\n * @returns `true` when the object is an `EnhancedDeepAnalysis`\n */\nfunction isEnhancedDeepAnalysis(a: DeepAnalysis): a is EnhancedDeepAnalysis {\n if (typeof a !== 'object' || a === null) return false;\n return (\n 'qualityMetadata' in a ||\n 'scenarioPlanning' in a ||\n 'reasoningChains' in a ||\n 'executiveSummary' in a\n );\n}\n\n/**\n * Build a confidence badge with emoji indicator and text label\n *\n * @param confidence - Confidence level\n * @param strings - Localized strings\n * @returns HTML span element\n */\nfunction buildConfidenceBadge(confidence: ConfidenceLevel, strings: DeepAnalysisStrings): string {\n let emoji: string;\n let label: string;\n switch (confidence) {\n case 'high':\n emoji = '🟢';\n label = strings.confidenceHigh;\n break;\n case 'medium':\n emoji = '🟡';\n label = strings.confidenceMedium;\n break;\n default:\n emoji = '🔴';\n label = strings.confidenceLow;\n }\n return `${emoji} ${escapeHTML(label)}`;\n}\n\n/**\n * Build the executive summary section\n *\n * @param summary - Executive summary text\n * @param confidence - Optional overall confidence level\n * @param heading - Localized heading\n * @param strings - Localized strings\n * @returns HTML string\n */\nfunction buildExecutiveSummarySection(\n summary: string,\n confidence: ConfidenceLevel | undefined,\n heading: string,\n strings: DeepAnalysisStrings\n): string {\n if (!summary) return '';\n const badge = confidence ? buildConfidenceBadge(confidence, strings) : '';\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
    \n

    ${escapeHTML(summary)}

    ${badge}\n
    \n
    `;\n}\n\n/**\n * Build the reasoning chains section\n *\n * @param chains - Reasoning chain items\n * @param heading - Localized heading\n * @param strings - Localized strings\n * @returns HTML string\n */\nfunction buildReasoningChainSection(\n chains: readonly ReasoningChain[],\n heading: string,\n strings: DeepAnalysisStrings\n): string {\n if (chains.length === 0) return '';\n const cards = chains\n .map((chain) => {\n const evidenceItems = chain.evidence\n .map((ref) => {\n const dateText = ref.date ? ` (${escapeHTML(ref.date)})` : '';\n if (ref.url && isSafeURL(ref.url)) {\n return `
  • ${escapeHTML(ref.title)}${dateText}
    • `;\n }\n return `
  • ${escapeHTML(ref.title)}${dateText}
    • `;\n })\n .join('\\n ');\n const evidenceHtml =\n chain.evidence.length > 0\n ? `
    \n

    ${escapeHTML(strings.evidenceRefsHeading)}

    \n
      \n ${evidenceItems}\n
    \n
    `\n : '';\n\n const counterItems = chain.counterArguments\n .map((ca) => `
  • ${escapeHTML(ca)}
    • `)\n .join('\\n ');\n const counterHtml =\n chain.counterArguments.length > 0\n ? `
    \n

    ${escapeHTML(strings.counterArgumentsHeading)}

    \n
      \n ${counterItems}\n
    \n
    `\n : '';\n\n return `
    \n

    ${escapeHTML(strings.premiseLabel)} ${escapeHTML(chain.premise)}

    \n ${evidenceHtml}\n

    ${escapeHTML(strings.inferenceLabel)} ${escapeHTML(chain.inference)}

    \n ${buildConfidenceBadge(chain.confidence, strings)}\n ${counterHtml}\n

    ${escapeHTML(strings.conclusionLabel)} ${escapeHTML(chain.conclusion)}

    \n
    `;\n })\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n ${cards}\n
    `;\n}\n\n/**\n * Build the scenario planning section\n *\n * @param scenarios - Scenario planning data\n * @param heading - Localized heading\n * @param strings - Localized strings\n * @returns HTML string\n */\nfunction buildScenarioPlanningSection(\n scenarios: ScenarioPlanning,\n heading: string,\n strings: DeepAnalysisStrings\n): string {\n function renderScenario(\n scenario: ScenarioPlanning['bestCase'],\n cssClass: string,\n label: string\n ): string {\n const rawPct = Number.isFinite(scenario.probability) ? scenario.probability * 100 : 0;\n const pct = Math.max(0, Math.min(100, Math.round(rawPct)));\n const triggerItems = scenario.triggers\n .map((t) => `
  • ${escapeHTML(t)}
    • `)\n .join('\\n ');\n const impactItems = scenario.implications\n .map(\n (imp) =>\n `
  • ` +\n `${escapeHTML(imp.stakeholder)}: ${escapeHTML(imp.impact)}` +\n `
    • `\n )\n .join('\\n ');\n return `
    \n

    ${escapeHTML(label)}

    \n

    ${escapeHTML(scenario.description)}

    \n
    \n ${escapeHTML(strings.probabilityLabel)}: ${pct}%\n
    \n
    \n ${\n scenario.triggers.length > 0\n ? `
    \n ${escapeHTML(strings.triggersLabel)}\n
      ${triggerItems}
    \n
    `\n : ''\n }\n ${\n scenario.implications.length > 0\n ? `
    \n ${escapeHTML(strings.impliedImpactsLabel)}\n
      ${impactItems}
    \n
    `\n : ''\n }\n

    ${escapeHTML(strings.timelineLabel)}: ${escapeHTML(scenario.timeline)}

    \n
    `;\n }\n\n const wildcardItems = scenarios.wildcards\n .map((w) => `
  • ${escapeHTML(w)}
    • `)\n .join('\\n ');\n const wildcardHtml =\n scenarios.wildcards.length > 0\n ? `
    \n

    ${escapeHTML(strings.wildcardsLabel)}

    \n
      ${wildcardItems}
    \n
    `\n : '';\n\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
    \n ${renderScenario(scenarios.bestCase, 'scenario-best', strings.bestCaseLabel)}\n ${renderScenario(scenarios.mostLikely, 'scenario-likely', strings.mostLikelyLabel)}\n ${renderScenario(scenarios.worstCase, 'scenario-worst', strings.worstCaseLabel)}\n
    \n ${wildcardHtml}\n
    `;\n}\n\n/**\n * Map iteration type to localized label\n *\n * @param type - Iteration type\n * @param strings - Localized strings\n * @returns Localized label\n */\nfunction iterationTypeLabel(\n type: 'initial' | 'stakeholder_challenge' | 'evidence_validation' | 'synthesis',\n strings: DeepAnalysisStrings\n): string {\n switch (type) {\n case 'initial':\n return strings.iterationInitial;\n case 'stakeholder_challenge':\n return strings.iterationStakeholderChallenge;\n case 'evidence_validation':\n return strings.iterationEvidenceValidation;\n default:\n return strings.iterationSynthesis;\n }\n}\n\n/**\n * Map evidence strength to localized label\n *\n * @param strength - Evidence strength\n * @param strings - Localized strings\n * @returns Localized label\n */\nfunction evidenceStrengthLabel(\n strength: 'strong' | 'moderate' | 'weak',\n strings: DeepAnalysisStrings\n): string {\n switch (strength) {\n case 'strong':\n return strings.evidenceStrong;\n case 'moderate':\n return strings.evidenceModerate;\n default:\n return strings.evidenceWeak;\n }\n}\n\n/**\n * Build the analysis methodology section\n *\n * @param metadata - Quality metadata\n * @param heading - Localized heading\n * @param strings - Localized strings\n * @returns HTML string\n */\nfunction buildAnalysisMethodologySection(\n metadata: AnalysisQualityMetadata,\n heading: string,\n strings: DeepAnalysisStrings\n): string {\n const iterationItems = metadata.iterations\n .map((iter) => {\n const findingItems = iter.findings\n .map((f) => `
  • ${escapeHTML(f)}
    • `)\n .join('\\n ');\n const refinementItems = iter.refinements\n .map((r) => `
  • ${escapeHTML(r)}
    • `)\n .join('\\n ');\n return `
    \n
    \n Pass ${escapeHTML(String(Number.isFinite(iter.pass) ? iter.pass : 0))}\n ${escapeHTML(iterationTypeLabel(iter.type, strings))}\n ${buildConfidenceBadge(iter.confidence, strings)}\n
    \n ${\n iter.findings.length > 0\n ? `
      ${findingItems}
    `\n : ''\n }\n ${\n iter.refinements.length > 0\n ? `
      ${refinementItems}
    `\n : ''\n }\n
    `;\n })\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
    \n
    ${escapeHTML(strings.overallConfidenceLabel)}
    \n
    ${buildConfidenceBadge(metadata.overallConfidence, strings)}
    \n
    ${escapeHTML(strings.evidenceStrengthLabel)}
    \n
    ${escapeHTML(evidenceStrengthLabel(metadata.evidenceStrength, strings))}
    \n
    ${escapeHTML(strings.iterationCountLabel)}
    \n
    ${escapeHTML(String(Number.isFinite(metadata.iterationCount) ? metadata.iterationCount : 0))}
    \n
    \n ${metadata.iterations.length > 0 ? `
    ${iterationItems}
    ` : ''}\n
    `;\n}\n\n// ─── Main builder ────────────────────────────────────────────────────────────\n\n/**\n * Map a StakeholderPerspective impact to a CSS class suffix.\n *\n * @param impact - Stakeholder impact direction\n * @returns CSS class suffix\n */\nfunction perspectiveImpactClass(impact: StakeholderPerspective['impact']): string {\n return `perspective-${impact}`;\n}\n\n/**\n * Map a stakeholder type to its localized display label.\n *\n * @param stakeholder - Internal stakeholder type identifier\n * @param strings - Localized label strings\n * @returns Localized stakeholder label\n */\nfunction localizedStakeholderLabel(\n stakeholder: AnalysisStakeholderType,\n strings: DeepAnalysisStrings\n): string {\n const map: Record = {\n political_groups: strings.politicalGroupsLabel,\n civil_society: strings.civilSocietyLabel,\n industry: strings.industryLabel,\n national_govts: strings.nationalGovtsLabel,\n citizens: strings.citizensLabel,\n eu_institutions: strings.euInstitutionsLabel,\n };\n return map[stakeholder];\n}\n\n/**\n * Map a stakeholder impact direction to its localized display label.\n *\n * @param impact - Impact direction value\n * @param strings - Localized label strings\n * @returns Localized impact label\n */\nfunction localizedImpactLabel(\n impact: StakeholderPerspective['impact'],\n strings: DeepAnalysisStrings\n): string {\n const map: Record = {\n positive: strings.positiveLabel,\n negative: strings.negativeLabel,\n neutral: strings.neutralLabel,\n mixed: strings.mixedLabel,\n };\n return map[impact];\n}\n\n/**\n * Map a severity level to its localized display label.\n *\n * @param severity - Severity level value\n * @param strings - Localized label strings\n * @returns Localized severity label\n */\nfunction localizedSeverityLabel(\n severity: StakeholderPerspective['severity'],\n strings: DeepAnalysisStrings\n): string {\n const map: Record = {\n high: strings.severityHigh,\n medium: strings.severityMedium,\n low: strings.severityLow,\n };\n return map[severity];\n}\n\n/**\n * Map an outcome value to its localized display label.\n *\n * @param outcome - Outcome value (winner/loser/neutral)\n * @param strings - Localized label strings\n * @returns Localized outcome label\n */\nfunction localizedOutcomeLabel(outcome: string, strings: DeepAnalysisStrings): string {\n const map: Record = {\n winner: strings.winnerLabel,\n loser: strings.loserLabel,\n neutral: strings.neutralLabel,\n };\n return map[outcome] ?? outcome;\n}\n\n/**\n * Build the \"Multi-Stakeholder Perspectives\" sub-section.\n * Renders a card grid with one card per stakeholder group showing\n * impact direction, severity, reasoning, and evidence.\n *\n * @param perspectives - Array of stakeholder perspectives\n * @param heading - Localized section heading\n * @param strings - Localized label strings for stakeholder names, impact, and severity\n * @returns HTML string, or empty string if no perspectives provided\n */\nfunction buildStakeholderPerspectivesSection(\n perspectives: readonly StakeholderPerspective[] | undefined,\n heading: string,\n strings: DeepAnalysisStrings\n): string {\n if (!perspectives || perspectives.length === 0) return '';\n const cards = perspectives\n .map((p) => {\n const evidenceItems = p.evidence.map((e) => `
  • ${escapeHTML(e)}
    • `).join('');\n const evidenceHtml = evidenceItems\n ? `
      ${evidenceItems}
    `\n : '';\n return (\n `
    ` +\n `
    ` +\n `${escapeHTML(localizedStakeholderLabel(p.stakeholder, strings))}` +\n `${escapeHTML(localizedImpactLabel(p.impact, strings))}` +\n `${escapeHTML(localizedSeverityLabel(p.severity, strings))}` +\n `
    ` +\n `

    ${isAiMarker(p.reasoning) ? aiPendingNotice(strings.pendingNotice) : escapeHTML(p.reasoning)}

    ` +\n evidenceHtml +\n `
    `\n );\n })\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
    \n ${cards}\n
    \n
    `;\n}\n\n/**\n * Build the \"Stakeholder Outcome Matrix\" sub-section.\n * Renders an accessible table mapping each action to winner/loser/neutral\n * outcomes per stakeholder group.\n *\n * @param matrix - Array of stakeholder outcome matrix rows\n * @param heading - Localized section heading\n * @param strings - Localized label strings for columns and stakeholder groups\n * @returns HTML string, or empty string if no matrix rows provided\n */\nfunction buildStakeholderOutcomeMatrixSection(\n matrix: readonly StakeholderOutcomeMatrix[] | undefined,\n heading: string,\n strings: DeepAnalysisStrings\n): string {\n if (!matrix || matrix.length === 0) return '';\n\n const headerCells = ALL_STAKEHOLDER_TYPES.map(\n (s) => `${escapeHTML(localizedStakeholderLabel(s, strings))}`\n ).join('');\n\n const rows = matrix\n .map((row) => {\n const cells = ALL_STAKEHOLDER_TYPES.map((s) => {\n // eslint-disable-next-line security/detect-object-injection -- key from const array\n const outcome = row.outcomes[s];\n return `${escapeHTML(localizedOutcomeLabel(outcome, strings))}`;\n }).join('');\n return (\n `` +\n `${escapeHTML(row.action)}` +\n `${escapeHTML(localizedSeverityLabel(row.confidence, strings))}` +\n cells +\n ``\n );\n })\n .join('\\n ');\n\n return `\n
    \n

    ${escapeHTML(heading)}

    \n
    \n \n \n \n \n \n ${headerCells}\n \n \n \n ${rows}\n \n
    ${escapeHTML(strings.actionLabel)}${escapeHTML(strings.confidenceLabel)}
    \n
    \n
    `;\n}\n\n/**\n * Build the complete deep political analysis section HTML.\n *\n * This section provides parliament-intelligence-grade analysis using the\n * \"5W + Impact\" framework. When the input is an `EnhancedDeepAnalysis` it\n * additionally renders an executive summary, reasoning chains, scenario\n * planning, and analysis methodology.\n *\n * Returns an empty string if the analysis object is null/undefined or\n * contains no meaningful content.\n *\n * @param analysis - Deep analysis data (null/undefined returns empty string).\n * Accepts both `DeepAnalysis` and `EnhancedDeepAnalysis`.\n * @param lang - BCP 47 language code for localized headings\n * differs from `lang`, each content element gets a `lang` attribute so\n * screen readers and translation tools handle the language switch correctly.\n * Defaults to `lang` (no extra attributes added).\n * @returns HTML section string or empty string\n */\nexport function buildDeepAnalysisSection(\n analysis: DeepAnalysis | EnhancedDeepAnalysis | null | undefined,\n lang: string\n): string {\n if (!analysis) return '';\n\n const strings = getLocalizedString(DEEP_ANALYSIS_STRINGS, lang);\n\n // ─── Enhanced sections (before/after base sections) ────────────────────\n let executiveSummaryHtml = '';\n let reasoningChainsHtml = '';\n let scenarioPlanningHtml = '';\n let methodologyHtml = '';\n\n if (isEnhancedDeepAnalysis(analysis)) {\n if (analysis.executiveSummary) {\n executiveSummaryHtml = buildExecutiveSummarySection(\n analysis.executiveSummary,\n analysis.qualityMetadata?.overallConfidence,\n strings.executiveSummaryHeading,\n strings\n );\n }\n if (analysis.reasoningChains && analysis.reasoningChains.length > 0) {\n reasoningChainsHtml = buildReasoningChainSection(\n analysis.reasoningChains,\n strings.reasoningChainsHeading,\n strings\n );\n }\n if (analysis.scenarioPlanning) {\n scenarioPlanningHtml = buildScenarioPlanningSection(\n analysis.scenarioPlanning,\n strings.scenarioPlanningHeading,\n strings\n );\n }\n if (analysis.qualityMetadata) {\n methodologyHtml = buildAnalysisMethodologySection(\n analysis.qualityMetadata,\n strings.analysisMethodologyHeading,\n strings\n );\n }\n }\n\n // ─── Base \"5W + Impact\" sections ───────────────────────────────────────\n const whatHtml = buildWhatSection(analysis.what, strings.whatHeading);\n const whoHtml = buildWhoSection(analysis.who, strings.whoHeading);\n const whenHtml = buildWhenSection(analysis.when, strings.whenHeading);\n const whyHtml = buildWhySection(analysis.why, strings.whyHeading, strings.pendingNotice);\n const stakeholderHtml = buildStakeholderSection(\n analysis.stakeholderOutcomes,\n strings.stakeholderHeading,\n strings\n );\n const impactHtml = buildImpactSection(analysis.impactAssessment, strings.impactHeading, strings);\n const consequencesHtml = buildConsequencesSection(\n analysis.actionConsequences,\n strings.consequencesHeading,\n strings,\n strings\n );\n const mistakesHtml = buildMistakesSection(\n analysis.mistakes,\n strings.mistakesHeading,\n strings.alternativeLabel,\n strings.pendingNotice\n );\n const outlookHtml = buildOutlookSection(\n analysis.outlook,\n strings.outlookHeading,\n strings.pendingNotice\n );\n const perspectivesHtml = buildStakeholderPerspectivesSection(\n analysis.stakeholderPerspectives,\n strings.perspectivesHeading,\n strings\n );\n const outcomeMatrixHtml = buildStakeholderOutcomeMatrixSection(\n analysis.stakeholderOutcomeMatrix,\n strings.outcomeMatrixHeading,\n strings\n );\n\n const innerContent =\n executiveSummaryHtml +\n whatHtml +\n whoHtml +\n whenHtml +\n whyHtml +\n reasoningChainsHtml +\n stakeholderHtml +\n impactHtml +\n consequencesHtml +\n mistakesHtml +\n outlookHtml +\n scenarioPlanningHtml +\n perspectivesHtml +\n outcomeMatrixHtml +\n methodologyHtml;\n\n // If all sub-sections are empty, return nothing\n if (!innerContent.trim()) return '';\n\n return `\n
    \n

    ${escapeHTML(strings.sectionHeading)}

    \n ${innerContent}\n
    `;\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/mindmap-content.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":246,"column":19,"endLine":246,"endColumn":45},{"ruleId":"@typescript-eslint/prefer-nullish-coalescing","severity":1,"message":"Prefer using nullish coalescing operator (`??`) instead of a logical or (`||`), as it is a safer operator.","line":463,"column":21,"messageId":"preferNullishOverOr","endLine":463,"endColumn":23,"suggestions":[{"messageId":"suggestNullish","data":{"equals":""},"fix":{"range":[16750,16804],"text":"(heading?.trim() ?? INTELLIGENCE_MINDMAP_HEADINGS[lang])"},"desc":"Fix to nullish coalescing operator (`??`)."}]},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":463,"column":24,"endLine":463,"endColumn":59},{"ruleId":"@typescript-eslint/prefer-nullish-coalescing","severity":1,"message":"Prefer using nullish coalescing operator (`??`) instead of a logical or (`||`), as it is a safer operator.","line":463,"column":60,"messageId":"preferNullishOverOr","endLine":463,"endColumn":62,"suggestions":[{"messageId":"suggestNullish","data":{"equals":""},"fix":{"range":[16805,16807],"text":"??"},"desc":"Fix to nullish coalescing operator (`??`)."}]},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":464,"column":24,"endLine":464,"endColumn":44},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":465,"column":28,"endLine":465,"endColumn":65},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":466,"column":28,"endLine":466,"endColumn":59},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":467,"column":29,"endLine":467,"endColumn":55},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":468,"column":30,"endLine":468,"endColumn":57},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":469,"column":26,"endLine":469,"endColumn":48},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":470,"column":28,"endLine":470,"endColumn":52}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":11,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Generates intelligence mindmap HTML sections using pure CSS —\n * no JavaScript or third-party libraries required.\n *\n * Provides `buildIntelligenceMindmapSection` — a multi-layer policy domain\n * intelligence map with actor-network nodes, influence-weighted nodes\n * (via CSS `--node-influence` custom property), policy connection indicators,\n * and stakeholder perspective overlays using `
    /` elements\n * (CSS-only toggle, no JavaScript).\n *\n * Also re-exports the `MindmapBranchColor` type from the types barrel for\n * backward compatibility with consumers that imported it from this module.\n *\n * Produces WCAG 2.1 AA compliant HTML with appropriate ARIA roles, labels,\n * and heading levels.\n *\n * @module Generators/MindmapContent\n */\n\nimport { escapeHTML } from '../utils/file-utils.js';\nimport type { IntelligenceMindmap, MindmapBranchColor, MindmapNode } from '../types/index.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n// Re-export the canonical MindmapBranchColor from the types barrel so that\n// existing consumers importing it from this module continue to work.\nexport type { MindmapBranchColor } from '../types/index.js';\n\n// ---------------------------------------------------------------------------\n// Color palette (mapped to CSS custom properties on each branch element)\n// ---------------------------------------------------------------------------\n\nconst BRANCH_PALETTE: Readonly<\n Record\n> = {\n cyan: { bg: '#e3f2fd', border: '#1565c0', text: '#1565c0' },\n magenta: { bg: '#fce4ec', border: '#c62828', text: '#c62828' },\n yellow: { bg: '#fff8e1', border: '#f57f17', text: '#f57f17' },\n green: { bg: '#e8f5e9', border: '#2e7d32', text: '#2e7d32' },\n purple: { bg: '#f3e5f5', border: '#7b1fa2', text: '#7b1fa2' },\n orange: { bg: '#fff3e0', border: '#e65100', text: '#e65100' },\n blue: { bg: '#e8eaf6', border: '#283593', text: '#283593' },\n red: { bg: '#ffebee', border: '#b71c1c', text: '#b71c1c' },\n};\n\n/** Color mapping for intelligence mindmap node categories. */\nconst CATEGORY_PALETTE: Readonly> = {\n policy_domain: { bg: '#e3f2fd', border: '#1565c0', text: '#1565c0' },\n sub_topic: { bg: '#f3e5f5', border: '#7b1fa2', text: '#7b1fa2' },\n actor: { bg: '#e8f5e9', border: '#2e7d32', text: '#2e7d32' },\n action: { bg: '#fff3e0', border: '#e65100', text: '#e65100' },\n outcome: { bg: '#e8eaf6', border: '#283593', text: '#283593' },\n};\n\n/** Icon/emoji mapping for actor types within intelligence mindmaps. */\nconst ACTOR_TYPE_LABELS: Readonly> = {\n mep: '👤',\n group: '🏛️',\n committee: '📋',\n external: '🌐',\n};\n\n// ---------------------------------------------------------------------------\n// Section heading labels (14 languages)\n// ---------------------------------------------------------------------------\n\nconst INTELLIGENCE_MINDMAP_HEADINGS: Readonly> = {\n en: 'Intelligence Policy Map',\n sv: 'Underrättelsebaserad policykarta',\n da: 'Intelligensbaseret politikkort',\n no: 'Etterretningsbasert politikkart',\n fi: 'Tiedustelupohjainen politiikkakartta',\n de: 'Intelligenz-Politikkarte',\n fr: 'Carte de renseignement politique',\n es: 'Mapa de inteligencia política',\n nl: 'Intelligentie beleidskaart',\n ar: 'خريطة الاستخبارات السياسية',\n he: 'מפת מודיעין מדיני',\n ja: '政策インテリジェンスマップ',\n ko: '정책 인텔리전스 맵',\n zh: '政策情报图谱',\n};\n\nconst STAKEHOLDER_PERSPECTIVES_LABELS: Readonly> = {\n en: 'Stakeholder Perspectives',\n sv: 'Intressentperspektiv',\n da: 'Interessentperspektiver',\n no: 'Interessentperspektiver',\n fi: 'Sidosryhmänäkökulmat',\n de: 'Interessengruppen-Perspektiven',\n fr: 'Perspectives des parties prenantes',\n es: 'Perspectivas de las partes interesadas',\n nl: 'Perspectieven van belanghebbenden',\n ar: 'وجهات نظر أصحاب المصلحة',\n he: 'נקודות מבט של בעלי עניין',\n ja: 'ステークホルダーの視点',\n ko: '이해관계자 관점',\n zh: '利益相关者视角',\n};\n\nconst POLICY_CONNECTIONS_LABELS: Readonly> = {\n en: 'Policy Connections',\n sv: 'Policyförbindelser',\n da: 'Politikforbindelser',\n no: 'Politikkforbindelser',\n fi: 'Politiikkayhteydet',\n de: 'Politikverbindungen',\n fr: 'Connexions politiques',\n es: 'Conexiones políticas',\n nl: 'Beleidsverbindingen',\n ar: 'الروابط السياسية',\n he: 'קשרים מדיניים',\n ja: '政策的つながり',\n ko: '정책 연결',\n zh: '政策关联',\n};\n\nconst ACTOR_NETWORK_LABELS: Readonly> = {\n en: 'Actor Network',\n sv: 'Aktörsnätverk',\n da: 'Aktørnetværk',\n no: 'Aktørnettverk',\n fi: 'Toimijaverkosto',\n de: 'Akteursnetzwerk',\n fr: \"Réseau d'acteurs\",\n es: 'Red de actores',\n nl: 'Actornetwerk',\n ar: 'شبكة الجهات الفاعلة',\n he: 'רשת גורמים',\n ja: 'アクターネットワーク',\n ko: '행위자 네트워크',\n zh: '行动者网络',\n};\n\nconst POLICY_DOMAINS_LABELS: Readonly> = {\n en: 'Policy Domains',\n sv: 'Policyområden',\n da: 'Politikområder',\n no: 'Politikkområder',\n fi: 'Politiikan alat',\n de: 'Politikbereiche',\n fr: 'Domaines politiques',\n es: 'Ámbitos políticos',\n nl: 'Beleidsdomeinen',\n ar: 'مجالات السياسة',\n he: 'תחומי מדיניות',\n ja: '政策分野',\n ko: '정책 분야',\n zh: '政策领域',\n};\n\nconst INFLUENCE_LABELS: Readonly> = {\n en: 'Influence',\n sv: 'Inflytande',\n da: 'Indflydelse',\n no: 'Innflytelse',\n fi: 'Vaikutusvalta',\n de: 'Einfluss',\n fr: 'Influence',\n es: 'Influencia',\n nl: 'Invloed',\n ar: 'التأثير',\n he: 'השפעה',\n ja: '影響力',\n ko: '영향력',\n zh: '影响力',\n};\n\nconst PERSPECTIVE_LABELS: Readonly> = {\n en: 'perspective',\n sv: 'perspektiv',\n da: 'perspektiv',\n no: 'perspektiv',\n fi: 'näkökulma',\n de: 'Perspektive',\n fr: 'perspective',\n es: 'perspectiva',\n nl: 'perspectief',\n ar: 'منظور',\n he: 'נקודת מבט',\n ja: '視点',\n ko: '관점',\n zh: '视角',\n};\n\nconst DETAILS_LABELS: Readonly> = {\n en: 'Details',\n sv: 'Detaljer',\n da: 'Detaljer',\n no: 'Detaljer',\n fi: 'Yksityiskohdat',\n de: 'Details',\n fr: 'Détails',\n es: 'Detalles',\n nl: 'Details',\n ar: 'التفاصيل',\n he: 'פרטים',\n ja: '詳細',\n ko: '세부 정보',\n zh: '详情',\n};\n\n// ---------------------------------------------------------------------------\n// Rendering helpers — intelligence mindmap\n// ---------------------------------------------------------------------------\n\n/**\n * Recursively count all nodes in the tree, including nested children.\n *\n * @param nodes - Root-level nodes to count\n * @returns Total node count including all descendants\n */\nfunction countNodesRecursive(nodes: readonly MindmapNode[]): number {\n let count = nodes.length;\n for (const node of nodes) {\n if (node.children.length > 0) {\n count += countNodesRecursive(node.children);\n }\n }\n return count;\n}\n\n/**\n * Get color palette entry for a mindmap node.\n * Checks the node's `color` field against `BRANCH_PALETTE` first (allowing\n * builders to override category-based colors), then falls back to the\n * category palette, and finally to the default `policy_domain` palette.\n *\n * @param category - Node category string key\n * @param color - Optional semantic color key from the branch palette\n * @returns Color palette object with bg, border, and text properties\n */\nfunction getNodePalette(\n category: string,\n color?: string\n): { bg: string; border: string; text: string } {\n if (color && Object.hasOwn(BRANCH_PALETTE, color)) {\n return BRANCH_PALETTE[color as MindmapBranchColor];\n }\n if (Object.hasOwn(CATEGORY_PALETTE, category)) {\n const entry = CATEGORY_PALETTE[category];\n if (entry) return entry;\n }\n return { bg: '#e3f2fd', border: '#1565c0', text: '#1565c0' };\n}\n\n/**\n * Clamp influence value to valid 0–1 range.\n *\n * @param value - Influence value to clamp\n * @returns Clamped value between 0 and 1 inclusive\n */\nfunction clampInfluence(value: number): number {\n return Math.max(0, Math.min(1, value));\n}\n\n/**\n * Render a single intelligence mindmap node as HTML.\n * Recursively renders children as nested sub-nodes.\n *\n * @param node - The mindmap node to render\n * @param depth - Current depth in the hierarchy (1 = domain layer)\n * @param detailsLabel - Localized label for the child details toggle\n * @param influenceLabel - Localized label for influence meter\n * @returns HTML string for this node and its children\n */\nfunction renderIntelligenceNode(\n node: MindmapNode,\n depth: number,\n detailsLabel: string,\n influenceLabel: string\n): string {\n const palette = getNodePalette(node.category, node.color);\n const influence = clampInfluence(node.influence);\n const influencePct = (influence * 100).toFixed(0);\n const metaCommittee = node.metadata?.committee\n ? ` data-committee=\"${escapeHTML(node.metadata.committee)}\"`\n : '';\n const metaGroup = node.metadata?.politicalGroup\n ? ` data-group=\"${escapeHTML(node.metadata.politicalGroup)}\"`\n : '';\n const metaDoc = node.metadata?.documentRef\n ? ` data-doc=\"${escapeHTML(node.metadata.documentRef)}\"`\n : '';\n\n const childrenHtml =\n node.children.length > 0\n ? `\\n
    \\n ${escapeHTML(detailsLabel)}\\n
      \\n${node.children\n .map(\n (child) =>\n `
    • ${renderIntelligenceNode(child, depth + 1, detailsLabel, influenceLabel)}
      • `\n )\n .join('\\n')}\\n
    \\n
    `\n : '';\n\n return `
    \n
    ${escapeHTML(node.label)}
    \n
    \n
    \n
    ${childrenHtml}\n
    `;\n}\n\n/**\n * Render the connections section as a `
    ` overlay panel.\n * Each connection is rendered with strength and type indicators.\n * Connection endpoints may reference either layer node IDs or actorNetwork\n * IDs; when a `nodeLabels` map is provided, IDs are resolved to\n * human-readable labels for display.\n *\n * @param connections - Policy connections to render\n * @param label - Localized heading label for the toggle\n * @param nodeLabels - Optional ID → label map for resolving endpoint names\n * @returns HTML string for the connections overlay, or empty string\n */\nfunction renderConnectionsOverlay(\n connections: IntelligenceMindmap['connections'],\n label: string,\n nodeLabels?: ReadonlyMap\n): string {\n if (connections.length === 0) return '';\n\n const resolveName = (id: string): string => nodeLabels?.get(id) ?? id;\n\n const items = connections\n .map(\n (c) =>\n `
  • \n ${escapeHTML(resolveName(c.from))}\n → \n ${escapeHTML(resolveName(c.to))}\n [${escapeHTML(c.type)}, ${escapeHTML(c.strength)}]\n ${escapeHTML(c.evidence)}\n
    • `\n )\n .join('\\n');\n\n return `
    \n ${escapeHTML(label)}\n
      \n${items}\n
    \n
    `;\n}\n\n/**\n * Render the actor network section as a `
    ` overlay panel.\n *\n * @param actorNetwork - Actor nodes to render in the network panel\n * @param label - Localized heading label for the toggle\n * @param influenceLabel - Localized label for influence meter\n * @returns HTML string for the actor network overlay, or empty string\n */\nfunction renderActorNetworkOverlay(\n actorNetwork: IntelligenceMindmap['actorNetwork'],\n label: string,\n influenceLabel: string\n): string {\n if (actorNetwork.length === 0) return '';\n\n const items = actorNetwork\n .map((actor) => {\n const typeIcon = ACTOR_TYPE_LABELS[actor.type] ?? '•';\n const influence = clampInfluence(actor.influence);\n const influencePct = (influence * 100).toFixed(0);\n return `
  • \n ${escapeHTML(typeIcon)}\n ${escapeHTML(actor.name)}\n ${escapeHTML(actor.type)}\n
    \n
    \n
    \n
    • `;\n })\n .join('\\n');\n\n return `
    \n ${escapeHTML(label)}\n
      \n${items}\n
    \n
    `;\n}\n\n/**\n * Render stakeholder perspective overlays as `
    ` panels.\n *\n * @param groups - Stakeholder group labels to render as panels\n * @param label - Localized heading label for the outer toggle\n * @param perspectiveLabel - Localized suffix for stakeholder perspective aria-label\n * @returns HTML string for the stakeholder overlay, or empty string\n */\nfunction renderStakeholderOverlays(\n groups: readonly string[] | undefined,\n label: string,\n perspectiveLabel: string\n): string {\n if (!groups || groups.length === 0) return '';\n\n const panels = groups\n .map(\n (g) =>\n `
    \n ${escapeHTML(g)}\n

    ${escapeHTML(g)}

    \n
    `\n )\n .join('\\n');\n\n return `
    \n ${escapeHTML(label)}\n
    \n${panels}\n
    \n
    `;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Generate a multi-layer intelligence mindmap section as an HTML string.\n *\n * Renders a hierarchical policy domain intelligence map with:\n * - Influence-weighted nodes (CSS `--node-influence` custom property)\n * - Actor-network visualization via `
    ` child overlays\n * - Policy connection indicators in a collapsible `
    ` panel\n * - Stakeholder perspective overlays via `
    /` (no JS)\n * - WCAG 2.1 AA accessible roles, labels, and meter elements\n *\n * Returns an empty string when `imap` is null/undefined or has no layers\n * with nodes.\n *\n * @param imap - Intelligence mindmap data.\n * @param lang - BCP 47 language code for section headings.\n * @param heading - Optional heading override.\n * @returns HTML string for the intelligence mindmap section, or empty string.\n */\nexport function buildIntelligenceMindmapSection(\n imap: IntelligenceMindmap | null | undefined,\n lang: string = 'en',\n heading?: string\n): string {\n if (!imap) return '';\n\n const allNodes = imap.layers.flatMap((l) => l.nodes);\n if (allNodes.length === 0) return '';\n\n const titleText: string =\n heading?.trim() || INTELLIGENCE_MINDMAP_HEADINGS[lang] || 'Intelligence Policy Map';\n const detailsLabel = DETAILS_LABELS[lang] ?? 'Details';\n const stakeholderLabel = STAKEHOLDER_PERSPECTIVES_LABELS[lang] ?? 'Stakeholder Perspectives';\n const connectionsLabel = POLICY_CONNECTIONS_LABELS[lang] ?? 'Policy Connections';\n const actorNetworkLabel = ACTOR_NETWORK_LABELS[lang] ?? 'Actor Network';\n const policyDomainsLabel = POLICY_DOMAINS_LABELS[lang] ?? 'Policy Domains';\n const influenceLabel = INFLUENCE_LABELS[lang] ?? 'Influence';\n const perspectiveLabel = PERSPECTIVE_LABELS[lang] ?? 'perspective';\n\n const summaryBlock = imap.summary?.trim()\n ? `

    ${escapeHTML(imap.summary.trim())}

    \\n`\n : '';\n\n // Render domain layer (depth 1 nodes as primary branches); fall back to\n // allNodes when the depth-1 layer is missing *or* empty.\n // Deeper hierarchy (depth 2–4) is expressed via MindmapNode.children and\n // rendered recursively by renderIntelligenceNode — separate layer entries\n // at depth > 1 are used only for label resolution, not for direct rendering.\n const depth1Nodes = imap.layers.find((l) => l.depth === 1)?.nodes ?? [];\n const domainNodes = depth1Nodes.length > 0 ? depth1Nodes : allNodes;\n const domainItems = domainNodes\n .map(\n (node) => `
  • ${renderIntelligenceNode(node, 1, detailsLabel, influenceLabel)}
    • `\n )\n .join('\\n');\n\n // Build label lookup for connection endpoint resolution.\n // This allows connections referencing actorNetwork IDs to display\n // human-readable names instead of raw IDs. We index *all* layer nodes\n // (including depth > 1) so that connections referencing deeper nodes still\n // resolve to human-readable names even though those nodes are rendered via\n // children rather than as standalone layer entries.\n const nodeLabels = new Map();\n const addLabels = (nodes: readonly MindmapNode[]): void => {\n for (const n of nodes) {\n nodeLabels.set(n.id, n.label);\n if (n.children.length > 0) addLabels(n.children);\n }\n };\n addLabels(allNodes);\n for (const actor of imap.actorNetwork) {\n nodeLabels.set(actor.id, actor.name);\n }\n\n const connectionsHtml = renderConnectionsOverlay(imap.connections, connectionsLabel, nodeLabels);\n const actorNetworkHtml = renderActorNetworkOverlay(\n imap.actorNetwork,\n actorNetworkLabel,\n influenceLabel\n );\n const stakeholderHtml = renderStakeholderOverlays(\n imap.stakeholderGroups,\n stakeholderLabel,\n perspectiveLabel\n );\n\n // Count from the rendered tree (domainNodes + their children recursively)\n // rather than allNodes, so data-total-nodes reflects only what the renderer\n // actually outputs.\n const totalNodes = countNodesRecursive(domainNodes);\n const totalConnections = imap.connections.length;\n const totalActors = imap.actorNetwork.length;\n\n return `
    \n

    ${escapeHTML(titleText)}

    \n${summaryBlock}
    \n
    ${escapeHTML(imap.centralTopic)}
    \n
      \n${domainItems}\n
    \n${connectionsHtml}\n${actorNetworkHtml}\n${stakeholderHtml}
    \n
    `;\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/motions-content.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":416,"column":5,"endLine":416,"endColumn":37},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":418,"column":5,"endLine":418,"endColumn":42},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":423,"column":5,"endLine":423,"endColumn":49}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":3,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/MotionsContent\n * @description Pure functions for building motions article HTML and\n * generating placeholder/fallback data when MCP is unavailable.\n */\n\nimport { escapeHTML } from '../utils/file-utils.js';\nimport { getLocalizedString, EDITORIAL_STRINGS, MOTIONS_STRINGS } from '../constants/languages.js';\nimport type {\n VotingRecord,\n VotingPattern,\n VotingAnomaly,\n MotionsQuestion,\n CoalitionIntelligence,\n AdoptedTextFeedItem,\n} from '../types/index.js';\n\n/** Marker string used in all fallback/placeholder data to indicate MCP data is unavailable */\nexport const PLACEHOLDER_MARKER = 'DATA_UNAVAILABLE (placeholder)';\n\n/**\n * Get fallback data for motions article\n *\n * @param dateStr - Current date string\n * @param dateFromStr - Start date string\n * @returns Object with all fallback data arrays\n */\nexport function getMotionsFallbackData(\n dateStr: string,\n dateFromStr: string\n): {\n votingRecords: VotingRecord[];\n votingPatterns: VotingPattern[];\n anomalies: VotingAnomaly[];\n questions: MotionsQuestion[];\n} {\n return {\n votingRecords: [\n {\n title: 'Example motion (placeholder – data unavailable)',\n date: dateStr,\n result: PLACEHOLDER_MARKER,\n votes: { for: 0, against: 0, abstain: 0 },\n },\n {\n title: 'Example amendment (placeholder – data unavailable)',\n date: dateFromStr,\n result: PLACEHOLDER_MARKER,\n votes: { for: 0, against: 0, abstain: 0 },\n },\n ],\n votingPatterns: [\n {\n group: 'Example group A (placeholder)',\n cohesion: 0.0,\n participation: 0.0,\n },\n {\n group: 'Example group B (placeholder)',\n cohesion: 0.0,\n participation: 0.0,\n },\n ],\n anomalies: [\n {\n type: 'Placeholder example',\n description:\n 'No real anomaly data available from MCP – this is illustrative placeholder content only.',\n severity: 'LOW',\n },\n ],\n questions: [\n {\n author: 'Placeholder MEP 1',\n topic: 'Placeholder parliamentary question on energy security (MCP data unavailable)',\n date: dateStr,\n status: PLACEHOLDER_MARKER,\n },\n {\n author: 'Placeholder MEP 2',\n topic: 'Placeholder parliamentary question on migration policy (MCP data unavailable)',\n date: dateFromStr,\n status: PLACEHOLDER_MARKER,\n },\n ],\n };\n}\n\n/**\n * Returns true when there is no real roll-call data: either the records\n * array is empty or every voting record carries the placeholder marker,\n * indicating no real roll-call data was retrieved from MCP.\n *\n * @param records - Voting records to test\n * @returns `true` if the array is empty or all records are placeholder-only data\n */\nfunction isPlaceholderVotingRecords(records: readonly VotingRecord[]): boolean {\n return records.length === 0 || records.every((r) => r.result === PLACEHOLDER_MARKER);\n}\n\n/**\n * Returns true when there is no real voting pattern data: either the patterns\n * array is empty or every voting pattern is placeholder/fallback data\n * (groups whose name contains the word \"placeholder\" — case-insensitive).\n *\n * @param patterns - Voting patterns to test\n * @returns `true` if the array is empty or all patterns are placeholder-only data\n */\nfunction isPlaceholderVotingPatterns(patterns: readonly VotingPattern[]): boolean {\n return patterns.length === 0 || patterns.every((p) => /placeholder/i.test(p.group));\n}\n\n/**\n * Returns true when there is no real anomaly data: either the array is empty\n * or every anomaly type contains the word \"placeholder\" (case-insensitive).\n *\n * @param anomalies - Anomalies to test\n * @returns `true` if the array is empty or all anomalies are placeholder-only data\n */\nfunction isPlaceholderAnomalies(anomalies: readonly VotingAnomaly[]): boolean {\n return anomalies.length === 0 || anomalies.every((a) => /placeholder/i.test(a.type));\n}\n\n/**\n * Returns true when there is no real questions data: either the array is empty\n * or every question carries the placeholder marker in its status field.\n *\n * @param questions - Parliamentary questions to test\n * @returns `true` if the array is empty or all questions are placeholder-only data\n */\nfunction isPlaceholderQuestions(questions: readonly MotionsQuestion[]): boolean {\n return questions.length === 0 || questions.every((q) => q.status === PLACEHOLDER_MARKER);\n}\n\n/**\n * Generate HTML content for motions article\n *\n * @param dateFromStr - Start date\n * @param dateStr - End date\n * @param votingRecords - Voting records data\n * @param votingPatterns - Voting patterns data\n * @param anomalies - Anomalies data\n * @param questions - Questions data\n * @param lang - Language code for editorial strings (default: 'en')\n * @returns HTML content string\n */\nexport function generateMotionsContent(\n dateFromStr: string,\n dateStr: string,\n votingRecords: VotingRecord[],\n votingPatterns: VotingPattern[],\n anomalies: VotingAnomaly[],\n questions: MotionsQuestion[],\n lang = 'en'\n): string {\n const editorial = getLocalizedString(EDITORIAL_STRINGS, lang);\n const strings = getLocalizedString(MOTIONS_STRINGS, lang);\n const ledeAnalysisRaw = strings.ledeAnalysis\n .replace('{DATE_FROM}', dateFromStr)\n .replace('{DATE_TO}', dateStr);\n const showVotingResults = !isPlaceholderVotingRecords(votingRecords);\n const showVotingPatterns = !isPlaceholderVotingPatterns(votingPatterns);\n const showAnomalies = !isPlaceholderAnomalies(anomalies);\n const showQuestions = !isPlaceholderQuestions(questions);\n return `\n
    \n
    \n

    ${escapeHTML(strings.lede)} ${escapeHTML(editorial.sourceAttribution)}, ${escapeHTML(ledeAnalysisRaw)}

    \n
    \n ${\n showVotingResults\n ? `\n
    \n

    ${escapeHTML(strings.votingRecordsHeading)}

    \n ${votingRecords\n .filter((r) => r.result !== PLACEHOLDER_MARKER)\n .map(\n (record) => `\n
    \n

    ${escapeHTML(record.title)}

    \n

    ${escapeHTML(strings.dateLabel)}: ${escapeHTML(record.date)}

    \n

    ${escapeHTML(strings.resultLabel)}: ${escapeHTML(record.result)}

    \n
    \n ${escapeHTML(strings.forLabel)}: ${escapeHTML(String(record.votes.for))}\n ${escapeHTML(strings.againstLabel)}: ${escapeHTML(String(record.votes.against))}\n ${escapeHTML(strings.abstainLabel)}: ${escapeHTML(String(record.votes.abstain))}\n
    \n
    \n `\n )\n .join('')}\n
    `\n : ''\n }\n ${\n showVotingPatterns\n ? `\n
    \n

    ${escapeHTML(strings.partyCohesionHeading)}

    \n

    ${escapeHTML(editorial.parliamentaryContext)}: Analysis of voting behavior reveals varying levels of party discipline across political groups:

    \n ${votingPatterns\n .filter((p) => !/placeholder/i.test(p.group))\n .map(\n (pattern) => `\n
    \n

    ${escapeHTML(pattern.group)}

    \n

    ${escapeHTML(strings.cohesionLabel)}: ${escapeHTML(String((pattern.cohesion * 100).toFixed(1)))}%

    \n

    ${escapeHTML(strings.participationLabel)}: ${escapeHTML(String((pattern.participation * 100).toFixed(1)))}%

    \n
    \n `\n )\n .join('')}\n
    `\n : ''\n }\n ${\n showAnomalies\n ? `\n
    \n

    ${escapeHTML(strings.anomaliesHeading)}

    \n

    ${escapeHTML(editorial.analysisNote)}: Unusual voting patterns that deviate from typical party lines:

    \n ${anomalies\n .filter((a) => !/placeholder/i.test(a.type))\n .map((anomaly) => {\n const rawSeverity = anomaly.severity ?? 'unknown';\n const severityDisplay =\n typeof rawSeverity === 'string' ? rawSeverity : String(rawSeverity);\n const severityClass = severityDisplay.toLowerCase();\n return `\n
    \n

    ${escapeHTML(anomaly.type)}

    \n

    ${escapeHTML(anomaly.description)}

    \n

    ${escapeHTML(strings.severityLabel)}: ${escapeHTML(severityDisplay)}

    \n
    \n `;\n })\n .join('')}\n
    `\n : ''\n }\n ${\n showQuestions\n ? `\n
    \n

    ${escapeHTML(strings.questionsHeading)}

    \n ${questions\n .filter((q) => q.status !== PLACEHOLDER_MARKER)\n .map(\n (question) => `\n
    \n

    ${escapeHTML(question.author)}

    \n

    ${escapeHTML(question.topic)}

    \n

    ${escapeHTML(strings.dateLabel)}: ${escapeHTML(question.date)} | ${escapeHTML(strings.statusLabel)}: ${escapeHTML(question.status)}

    \n
    \n `\n )\n .join('')}\n
    `\n : ''\n }\n\n \n
    \n `;\n}\n\n// ─── Political Alignment section ──────────────────────────────────────────────\n\n/**\n * Build HTML list items for voting record alignment rows\n *\n * @param records - Voting records to render\n * @returns HTML list items string\n */\nfunction buildVoteAlignmentHtml(records: VotingRecord[]): string {\n if (records.length === 0) return '';\n const realRecords = records.filter((r) => r.result !== PLACEHOLDER_MARKER);\n if (realRecords.length === 0) return '';\n const items = realRecords\n .map((r) => {\n const forVotes = escapeHTML(String(r.votes.for));\n const againstVotes = escapeHTML(String(r.votes.against));\n const abstainVotes = escapeHTML(String(r.votes.abstain));\n return (\n `
  • ` +\n `${escapeHTML(r.title)} — ` +\n `${escapeHTML(r.result)} ` +\n `(${forVotes}+ / ${againstVotes}− / ${abstainVotes} abstain)` +\n `
    • `\n );\n })\n .join('\\n ');\n return `
      \\n ${items}\\n
    `;\n}\n\n/**\n * Build HTML list items for coalition alignment rows\n *\n * @param coalitions - Coalition intelligence items to render\n * @returns HTML list items string\n */\nfunction buildCoalitionAlignmentHtml(coalitions: CoalitionIntelligence[]): string {\n if (coalitions.length === 0) return '';\n const items = coalitions\n .map(\n (c) =>\n `
  • ` +\n `${escapeHTML(c.groups.join(', '))} — ` +\n `cohesion: ${escapeHTML(String(Math.round(c.cohesionScore * 100)))}% ` +\n `(${escapeHTML(c.alignmentTrend)})
    • `\n )\n .join('\\n ');\n return `
      \\n ${items}\\n
    `;\n}\n\n/**\n * Build political alignment analysis section for motions, showing how\n * voting records map to coalition cohesion and cross-party dynamics.\n * Returns an empty string when both input arrays are empty or yield no items.\n *\n * @param votingRecords - Voting records to analyse\n * @param coalitions - Coalition intelligence data from MCP\n * @param language - BCP 47 language code used as the section lang attribute\n * @returns HTML string for the political alignment section\n */\nexport function buildPoliticalAlignmentSection(\n votingRecords: VotingRecord[],\n coalitions: CoalitionIntelligence[],\n language: string\n): string {\n if (votingRecords.length === 0 && coalitions.length === 0) return '';\n const recordsHtml = buildVoteAlignmentHtml(votingRecords);\n const coalitionsHtml = buildCoalitionAlignmentHtml(coalitions);\n if (!recordsHtml && !coalitionsHtml) return '';\n const strings = getLocalizedString(MOTIONS_STRINGS, language);\n return `\n
    \n

    ${escapeHTML(strings.politicalAlignmentHeading)}

    \n ${recordsHtml}\n ${coalitionsHtml}\n
    `;\n}\n\n/** Localized headings for the adopted texts feed section */\nconst ADOPTED_TEXTS_HEADINGS: Record = {\n en: 'Recently Adopted Texts',\n sv: 'Nyligen Antagna Texter',\n da: 'Nyligt Vedtagne Tekster',\n no: 'Nylig Vedtatte Tekster',\n fi: 'Äskettäin Hyväksytyt Tekstit',\n de: 'Kürzlich Angenommene Texte',\n fr: 'Textes Récemment Adoptés',\n es: 'Textos Recientemente Adoptados',\n nl: 'Recent Aangenomen Teksten',\n ar: 'النصوص المعتمدة مؤخراً',\n he: 'טקסטים שאומצו לאחרונה',\n ja: '最近採択されたテキスト',\n ko: '최근 채택된 텍스트',\n zh: '最近通过的文本',\n};\n\n/** Localized fallback label for items with no adoption date */\nconst ADOPTED_TEXTS_DATE_UNKNOWN_STRINGS: Record = {\n en: 'Unknown',\n sv: 'Okänt',\n da: 'Ukendt',\n no: 'Ukjent',\n fi: 'Tuntematon',\n de: 'Unbekannt',\n fr: 'Inconnu',\n es: 'Desconocido',\n nl: 'Onbekend',\n ar: 'غير معروف',\n he: 'לא ידוע',\n ja: '不明',\n ko: '알 수 없음',\n zh: '未知',\n};\n\n/** Localized count descriptions for the adopted texts feed section */\nconst ADOPTED_TEXTS_COUNT_STRINGS: Record string> = {\n en: (n) => `${n} texts adopted in recent plenary sessions:`,\n sv: (n) => `${n} texter antagna i nyliga plenarsammanträden:`,\n da: (n) => `${n} tekster vedtaget i seneste plenarmøder:`,\n no: (n) => `${n} tekster vedtatt i nylige plenumsmøter:`,\n fi: (n) => `${n} tekstiä hyväksytty viimeisimmissä täysistunnoissa:`,\n de: (n) => `${n} Texte in jüngsten Plenarsitzungen angenommen:`,\n fr: (n) => `${n}\\u00a0textes adoptés lors des récentes sessions plénières\\u00a0:`,\n es: (n) => `${n} textos adoptados en recientes sesiones plenarias:`,\n nl: (n) => `${n} teksten aangenomen in recente plenaire vergaderingen:`,\n ar: (n) => `تم اعتماد ${n} نصاً في جلسات البرلمان الأخيرة:`,\n he: (n) => `${n} טקסטים אומצו בישיבות המליאה האחרונות:`,\n ja: (n) => `最近の本会議セッションで ${n} 件のテキストが採択されました：`,\n ko: (n) => `최근 전체 회의에서 ${n}개의 텍스트가 채택되었습니다:`,\n zh: (n) => `最近全体会议共通过了 ${n} 份文本：`,\n};\n\n/**\n * Build an HTML section listing recently adopted texts from EP feed data.\n * Groups texts by adoption date and renders them as a structured list.\n *\n * @param adoptedTexts - Adopted text feed items\n * @param language - BCP 47 language code\n * @returns HTML section string, or empty string if no texts\n */\nexport function buildAdoptedTextsSection(\n adoptedTexts: readonly AdoptedTextFeedItem[],\n language: string\n): string {\n if (adoptedTexts.length === 0) return '';\n\n const heading =\n ADOPTED_TEXTS_HEADINGS[language] ?? ADOPTED_TEXTS_HEADINGS['en'] ?? 'Recently Adopted Texts';\n const countFn =\n ADOPTED_TEXTS_COUNT_STRINGS[language] ??\n ADOPTED_TEXTS_COUNT_STRINGS['en'] ??\n ((n: number) => `${n} adopted texts`);\n const countText = countFn(adoptedTexts.length);\n const unknownDate =\n ADOPTED_TEXTS_DATE_UNKNOWN_STRINGS[language] ??\n ADOPTED_TEXTS_DATE_UNKNOWN_STRINGS['en'] ??\n 'Unknown date';\n\n // Group by date, sort most recent first\n const byDate = new Map();\n for (const item of adoptedTexts) {\n const date = item.date || unknownDate;\n const group = byDate.get(date) ?? [];\n group.push(item);\n byDate.set(date, group);\n }\n const sortedDates = [...byDate.keys()].sort().reverse();\n\n let itemsHtml = '';\n for (const date of sortedDates) {\n const items = byDate.get(date) ?? [];\n for (const item of items) {\n const ref = item.identifier ?? item.id;\n const title = item.title || ref;\n itemsHtml += `\n
  • \n ${escapeHTML(title)}\n ${escapeHTML(ref)}\n ${escapeHTML(date)}\n
    • `;\n }\n }\n\n return `\n
    \n

    ${escapeHTML(heading)}

    \n

    ${escapeHTML(countText)}

    \n
      \n ${itemsHtml}\n
    \n
    `;\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/news-enhanced.ts","messages":[{"ruleId":"@typescript-eslint/prefer-nullish-coalescing","severity":1,"message":"Prefer using nullish coalescing operator (`??`) instead of a logical or (`||`), as it is a safer operator.","line":185,"column":46,"messageId":"preferNullishOverOr","endLine":185,"endColumn":48,"suggestions":[{"messageId":"suggestNullish","data":{"equals":""},"fix":{"range":[6936,7016],"text":"(runIdArg?.slice('--run-id='.length).trim() ??\n process.env['GITHUB_RUN_NUMBER'])"},"desc":"Fix to nullish coalescing operator (`??`)."}]},{"ruleId":"@typescript-eslint/prefer-nullish-coalescing","severity":1,"message":"Prefer using nullish coalescing operator (`??`) instead of a logical or (`||`), as it is a safer operator.","line":186,"column":36,"messageId":"preferNullishOverOr","endLine":186,"endColumn":38,"suggestions":[{"messageId":"suggestNullish","data":{"equals":""},"fix":{"range":[7017,7019],"text":"??"},"desc":"Fix to nullish coalescing operator (`??`)."}]}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":2,"fixableErrorCount":0,"fixableWarningCount":0,"source":"#!/usr/bin/env node\n\n// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/NewsEnhanced\n * @description CLI orchestrator for European Parliament news generation.\n *\n * Coordinates the four-stage pipeline (fetch → analysis discovery → generate → output)\n * via dedicated pipeline-stage modules and a strategy registry. Each article\n * type is handled by its own {@link ArticleStrategy} implementation.\n *\n * When the `--analysis` flag is supplied (all 9 agentic workflows do this),\n * the analysis discovery stage runs **before** article generation, discovering\n * AI-generated analysis `.md` files under `analysis/daily/{date}/{article-type}/`.\n * The AI agentic workflows produce all analysis content directly — the TypeScript\n * pipeline only discovers and links to these artifacts. Analysis artifacts are\n * committed to the repository for review and improvement.\n *\n * Pipeline stages:\n * - {@link module:Generators/Pipeline/FetchStage}\n * - {@link module:Generators/Pipeline/AnalysisStage} (discovers AI-generated analysis artifacts)\n * - {@link module:Generators/Pipeline/GenerateStage}\n * - {@link module:Generators/Pipeline/OutputStage}\n *\n * Article strategies:\n * - {@link module:Generators/Strategies/WeekAheadStrategy}\n * - {@link module:Generators/Strategies/MonthAheadStrategy}\n * - {@link module:Generators/Strategies/BreakingNewsStrategy}\n * - {@link module:Generators/Strategies/CommitteeReportsStrategy}\n * - {@link module:Generators/Strategies/PropositionsStrategy}\n * - {@link module:Generators/Strategies/MotionsStrategy}\n * - {@link module:Generators/Strategies/WeeklyReviewStrategy}\n * - {@link module:Generators/Strategies/MonthlyReviewStrategy}\n *\n * Bounded-context content modules (re-exported for backward compatibility):\n * - {@link module:Generators/WeekAheadContent}\n * - {@link module:Generators/BreakingContent}\n * - {@link module:Generators/CommitteeHelpers}\n * - {@link module:Generators/MotionsContent}\n * - {@link module:Generators/PropositionsContent}\n */\n\nimport path, { resolve } from 'path';\nimport { pathToFileURL } from 'url';\nimport {\n NEWS_DIR,\n METADATA_DIR,\n VALID_ARTICLE_CATEGORIES,\n ARTICLE_TYPE_WEEK_AHEAD,\n ARG_SEPARATOR,\n} from '../constants/config.js';\nimport { ALL_LANGUAGES, LANGUAGE_PRESETS, isSupportedLanguage } from '../constants/languages.js';\nimport { closeEPMCPClient } from '../mcp/ep-mcp-client.js';\nimport type { EuropeanParliamentMCPClient } from '../mcp/ep-mcp-client.js';\nimport { ensureDirectoryExists } from '../utils/file-utils.js';\nimport type {\n LanguageCode,\n LanguagePreset,\n GenerationStats,\n GenerationResult,\n} from '../types/index.js';\nimport type { ArticleCategory } from '../types/index.js';\n\n// ─── Pipeline-stage imports ───────────────────────────────────────────────────\n\nimport { initializeMCPClient, fetchEPFeedData } from './pipeline/fetch-stage.js';\nimport {\n createStrategyRegistry,\n generateArticleForStrategy,\n setAIMetadata,\n} from './pipeline/generate-stage.js';\nimport { writeGenerationMetadata } from './pipeline/output-stage.js';\nimport type { OutputOptions } from './pipeline/output-stage.js';\nimport {\n runAnalysisStage,\n ALL_ANALYSIS_METHODS,\n VALID_ANALYSIS_METHODS,\n hasSubstantiveData,\n deriveArticleTypeSlug,\n} from './pipeline/analysis-stage.js';\nimport type { AnalysisMethod, AnalysisContext } from './pipeline/analysis-stage.js';\nimport type { AnalysisFileEntry } from '../types/index.js';\nimport { discoverAnalysisFileEntries } from '../utils/file-utils.js';\n\n// ─── Content-module imports (bounded contexts) ───────────────────────────────\n\nimport {\n parsePlenarySessions,\n parseEPEvents,\n parseCommitteeMeetings,\n parseLegislativeDocuments,\n parseLegislativePipeline,\n parseParliamentaryQuestions,\n buildWeekAheadContent,\n buildKeywords,\n PLACEHOLDER_EVENTS,\n buildWhatToWatchSection,\n buildStakeholderImpactMatrix,\n computeWeekPoliticalTemperature,\n} from './week-ahead-content.js';\n\nimport {\n buildBreakingNewsContent,\n scoreBreakingNewsSignificance,\n SIGNIFICANCE_THRESHOLD,\n} from './breaking-content.js';\n\nimport {\n applyCommitteeInfo,\n applyDocuments,\n applyEffectiveness,\n FEATURED_COMMITTEES,\n} from './committee-helpers.js';\n\nimport {\n PLACEHOLDER_MARKER,\n getMotionsFallbackData,\n generateMotionsContent,\n buildPoliticalAlignmentSection,\n} from './motions-content.js';\n\nimport { buildPropositionsContent } from './propositions-content.js';\nimport type { PipelineData } from './propositions-content.js';\n\n// ─── Re-exports for backward compatibility (tests import from this module) ───\n\nexport {\n parsePlenarySessions,\n parseEPEvents,\n parseCommitteeMeetings,\n parseLegislativeDocuments,\n parseLegislativePipeline,\n parseParliamentaryQuestions,\n buildWeekAheadContent,\n buildKeywords,\n PLACEHOLDER_EVENTS,\n buildWhatToWatchSection,\n buildStakeholderImpactMatrix,\n computeWeekPoliticalTemperature,\n};\nexport { buildBreakingNewsContent, scoreBreakingNewsSignificance, SIGNIFICANCE_THRESHOLD };\nexport { applyCommitteeInfo, applyDocuments, applyEffectiveness, FEATURED_COMMITTEES };\nexport {\n PLACEHOLDER_MARKER,\n getMotionsFallbackData,\n generateMotionsContent,\n buildPoliticalAlignmentSection,\n};\nexport { buildPropositionsContent };\nexport type { PipelineData };\n\n// ─── CLI argument parsing ─────────────────────────────────────────────────────\n\nconst useMCP = process.env['USE_EP_MCP'] !== 'false';\n\nconst args = process.argv.slice(2);\nconst typesArg = args.find((arg) => arg.startsWith('--types='));\nconst languagesArg = args.find((arg) => arg.startsWith('--languages='));\nconst feedDataArg = args.find((arg) => arg.startsWith('--feed-data='));\nconst dryRunArg = args.includes('--dry-run');\nconst skipExistingArg = args.includes('--skip-existing');\nconst runAnalysisArg = args.includes('--analysis');\nconst analysisOnlyArg = args.includes('--analysis-only');\nconst analysisVerboseArg = args.includes('--analysis-verbose');\nconst analysisDirArg = args.find((arg) => arg.startsWith('--analysis-dir='));\nconst analysisMethodsArg = args.find((arg) => arg.startsWith('--analysis-methods='));\nconst runIdArg = args.find((arg) => arg.startsWith('--run-id='));\nconst titleArg = args.find((arg) => arg.startsWith('--title='));\nconst descriptionArg = args.find((arg) => arg.startsWith('--description='));\n\n/**\n * Workflow run identifier (typically `GITHUB_RUN_NUMBER`) used to create\n * a unique analysis directory per workflow execution. This prevents\n * multiple runs on the same date from overwriting each other's analysis\n * artifacts and ensures article transparency links point to the exact\n * analysis used for that specific article generation run.\n *\n * Falls back to `GITHUB_RUN_NUMBER` env var, then empty string (no suffix).\n * Sanitised to alphanumeric and hyphens only (supports both numeric run\n * numbers and custom identifiers passed via `--run-id`).\n */\nexport const runId: string = (\n runIdArg?.slice('--run-id='.length).trim() ||\n process.env['GITHUB_RUN_NUMBER'] ||\n ''\n).replace(/[^a-z0-9-]/giu, '');\n\n/**\n * AI-generated article title passed by the agentic workflow.\n * When provided, this OVERRIDES any script-generated title.\n * The AI agent must analyse the content and produce this.\n */\nexport const aiTitle: string = titleArg ? titleArg.slice('--title='.length).trim() : '';\n\n/**\n * AI-generated article description/subtitle passed by the agentic workflow.\n * When provided, this OVERRIDES any script-generated description.\n * The AI agent must analyse the content and produce this.\n */\nexport const aiDescription: string = descriptionArg\n ? descriptionArg.slice('--description='.length).trim()\n : '';\n\n/** Path to a JSON file containing pre-fetched EP feed data (optional). */\nconst feedDataPath = feedDataArg?.startsWith('--feed-data=')\n ? feedDataArg.slice('--feed-data='.length).trim()\n : '';\n\nconst articleTypes = typesArg\n ? (typesArg.split(ARG_SEPARATOR)[1] ?? '').split(',').map((t) => t.trim())\n : [ARTICLE_TYPE_WEEK_AHEAD];\n\nlet languagesInput = languagesArg\n ? (languagesArg.split(ARG_SEPARATOR)[1] ?? '').trim().toLowerCase()\n : 'en';\n\n// Expand presets\nconst presetLanguages = LANGUAGE_PRESETS[languagesInput as LanguagePreset];\nif (presetLanguages) {\n languagesInput = presetLanguages.join(',');\n}\n\nconst languages: LanguageCode[] = languagesInput\n .split(',')\n .map((l) => l.trim())\n .filter((l): l is LanguageCode => isSupportedLanguage(l));\n\nif (languages.length === 0) {\n console.error('❌ No valid language codes provided. Valid codes:', ALL_LANGUAGES.join(', '));\n process.exit(1);\n}\n\n// Validate article types\nconst invalidTypes = articleTypes.filter(\n (t) => !VALID_ARTICLE_CATEGORIES.includes(t.trim() as ArticleCategory)\n);\nif (invalidTypes.length > 0) {\n console.warn(`⚠️ Unknown article types ignored: ${invalidTypes.join(', ')}`);\n}\n\nconsole.log('📰 Enhanced News Generation Script');\nconsole.log('Article types:', articleTypes.join(', '));\nconsole.log('Languages:', languages.join(', '));\nconsole.log('Dry run:', dryRunArg ? 'Yes (no files written)' : 'No');\nconsole.log('Skip existing:', skipExistingArg ? 'Yes' : 'No');\nif (runAnalysisArg || analysisOnlyArg) {\n console.log(\n 'Analysis stage:',\n analysisOnlyArg ? 'Analysis only (no article generation)' : 'Enabled'\n );\n}\nif (feedDataPath) {\n console.log('Feed data file:', feedDataPath);\n}\n\n// Ensure directories exist\nensureDirectoryExists(METADATA_DIR);\nensureDirectoryExists(NEWS_DIR);\n\n// Generation statistics\nconst stats: GenerationStats = {\n generated: 0,\n skipped: 0,\n dryRun: 0,\n errors: 0,\n articles: [],\n timestamp: new Date().toISOString(),\n};\n\n// ─── Main orchestration ───────────────────────────────────────────────────────\n\n/**\n * Type guard that narrows a string to {@link AnalysisMethod}.\n *\n * Uses {@link Array.some} so no type assertion is needed — the predicate\n * compares each element directly to the candidate string.\n *\n * @param name - The string to validate\n * @returns `true` when `name` is a recognised analysis method\n */\nfunction isValidAnalysisMethod(name: string): name is AnalysisMethod {\n return VALID_ANALYSIS_METHODS.some((m) => m === name);\n}\n\n/**\n * Parse the `--analysis-methods=` CLI flag into a validated, deduplicated list.\n * Warns on unrecognised method names and falls back to all methods when no valid\n * names remain.\n *\n * @returns Validated list of analysis methods\n */\nfunction parseAnalysisMethods(): readonly AnalysisMethod[] {\n const raw = analysisMethodsArg?.split(ARG_SEPARATOR)[1]?.trim();\n if (!raw) return ALL_ANALYSIS_METHODS;\n\n const requestedNames = raw\n .split(',')\n .map((m) => m.trim())\n .filter((m) => m.length > 0);\n\n if (requestedNames.length === 0) return ALL_ANALYSIS_METHODS;\n\n const validMethods = new Set();\n const unknownMethods: string[] = [];\n\n for (const name of requestedNames) {\n if (isValidAnalysisMethod(name)) {\n validMethods.add(name);\n } else {\n unknownMethods.push(name);\n }\n }\n\n if (unknownMethods.length > 0) {\n console.warn(`⚠️ Unknown analysis methods ignored: ${unknownMethods.join(', ')}`);\n }\n\n const methods = Array.from(validMethods);\n if (methods.length === 0) {\n console.warn('⚠️ No valid analysis methods specified; defaulting to all analysis methods.');\n return ALL_ANALYSIS_METHODS;\n }\n\n return methods;\n}\n\n/**\n * Run the analysis discovery stage (Fetch → Discover) before article generation.\n *\n * This function fetches EP feed data and then discovers the analysis `.md`\n * files that the AI agentic workflow wrote to `analysis/daily/{date}/{article-type}/`.\n * It writes a minimal `manifest.json` if one doesn't already exist, so that\n * downstream consumers (strategies, article template) can reference the analysis.\n *\n * The AI agent performs ALL analytical work directly — this function merely\n * discovers and catalogues what exists on disk. The returned\n * {@link AnalysisContext} is informational; strategies read analysis output\n * from disk rather than consuming the context object in-memory.\n *\n * The feed timeframe is derived from the requested article types: if any\n * month-level types (month-ahead, month-in-review, committee-reports, motions)\n * are present, the stage fetches 'one-month' of data; otherwise 'one-week'.\n *\n * **Note:** The analysis stage fetches EP feed data independently of the\n * generation stage. Strategies also call `fetchEPFeedData()` during their own\n * `fetchData()`. Sharing a single fetch result between analysis and generation\n * is a planned optimisation (tracked separately) to reduce MCP traffic.\n *\n * @param date - ISO date string (YYYY-MM-DD)\n * @param client - Connected MCP client or null\n * @returns Analysis context or null\n */\nasync function maybeRunAnalysis(\n date: string,\n client: EuropeanParliamentMCPClient | null\n): Promise {\n if (!runAnalysisArg && !analysisOnlyArg) return null;\n\n const rawAnalysisDirBase = analysisDirArg?.split(ARG_SEPARATOR)[1];\n const trimmedAnalysisDirBase = rawAnalysisDirBase?.trim();\n const analysisDirBase =\n trimmedAnalysisDirBase && trimmedAnalysisDirBase.length > 0\n ? trimmedAnalysisDirBase\n : 'analysis/daily';\n const enabledMethods = parseAnalysisMethods();\n\n console.log('');\n console.log('🔬 Running analysis discovery stage...');\n console.log(` Output dir: ${analysisDirBase}/${date}`);\n console.log(` Methods: ${enabledMethods.length} enabled`);\n console.log('');\n\n // Derive the feed timeframe from the requested article types so the analysis\n // window matches the generation window. Month-level types need 'one-month'.\n const MONTH_LEVEL_TYPES = ['month-ahead', 'month-in-review', 'committee-reports', 'motions'];\n const normalizedArticleTypes = articleTypes.map((t) => t.trim());\n const needsMonthData = normalizedArticleTypes.some((t) => MONTH_LEVEL_TYPES.includes(t));\n const feedTimeframe = needsMonthData ? 'one-month' : 'one-week';\n\n // Fetch comprehensive EP feed data. fetchEPFeedData handles a null client\n // gracefully (returns undefined) and also loads from EP_FEED_DATA_FILE when\n // set, so we call it unconditionally.\n //\n // Always initialise voting-derived keys (`patterns`, `votingRecords`) to\n // empty arrays so coalition/voting/cross-session analyses never receive\n // undefined. These feeds are not yet exposed by fetchEPFeedData, so they\n // stay empty until a future MCP voting-records endpoint is available.\n const fetchedData: Record = {\n date,\n patterns: [],\n votingRecords: [],\n };\n const feedData = await fetchEPFeedData(client, feedTimeframe);\n if (feedData) {\n fetchedData['events'] = feedData.events ?? [];\n fetchedData['documents'] = feedData.documents ?? [];\n fetchedData['adoptedTexts'] = feedData.adoptedTexts ?? [];\n fetchedData['procedures'] = feedData.procedures ?? [];\n fetchedData['mepUpdates'] = feedData.mepUpdates ?? [];\n fetchedData['plenaryDocuments'] = feedData.plenaryDocuments ?? [];\n fetchedData['committeeDocuments'] = feedData.committeeDocuments ?? [];\n fetchedData['plenarySessionDocuments'] = feedData.plenarySessionDocuments ?? [];\n fetchedData['externalDocuments'] = feedData.externalDocuments ?? [];\n fetchedData['questions'] = feedData.questions ?? [];\n fetchedData['declarations'] = feedData.declarations ?? [];\n fetchedData['corporateBodies'] = feedData.corporateBodies ?? [];\n }\n if (!fetchedData['events']) {\n // No MCP or feed-data file available — populate empty arrays so builders don't fail\n fetchedData['events'] = [];\n fetchedData['sessions'] = [];\n fetchedData['documents'] = [];\n }\n\n // Validate that substantive EP data was actually fetched.\n // Agentic workflows must not proceed with empty data — analysis on empty\n // data produces hollow output that should never feed article generation.\n if (!hasSubstantiveData(fetchedData)) {\n const msg =\n '❌ Analysis aborted: no substantive EP data was fetched. ' +\n 'MCP data fetch must succeed before analysis can run. ' +\n 'Check MCP connection, feed data file, or EP API availability.';\n throw new Error(msg);\n }\n\n const validArticleTypes = normalizedArticleTypes.filter((t): t is ArticleCategory =>\n VALID_ARTICLE_CATEGORIES.includes(t as ArticleCategory)\n ) as readonly ArticleCategory[];\n\n // Derive a slug from the article types to scope analysis output per workflow,\n // preventing merge conflicts when multiple workflows run on the same date.\n // When a run ID is provided (e.g. GITHUB_RUN_NUMBER), append it to the slug\n // so each workflow execution gets a unique analysis directory. This prevents\n // overwrites when the same workflow runs multiple times on the same day.\n const baseSlugForAnalysis = deriveArticleTypeSlug(validArticleTypes);\n const slug = runId ? `${baseSlugForAnalysis}-run${runId}` : baseSlugForAnalysis;\n\n console.log(` Article type slug: ${slug}`);\n if (runId) console.log(` Run ID: ${runId}`);\n\n // Pass requireData=true so runAnalysisStage enforces data availability\n // and aborts when no substantive data is available — discovery on empty data produces no artifacts.\n const ctx = await runAnalysisStage(fetchedData, {\n articleTypes: validArticleTypes,\n date,\n outputDir: analysisDirBase,\n articleTypeSlug: slug,\n enabledMethods,\n skipCompleted: true,\n verbose: analysisVerboseArg,\n requireData: true,\n });\n\n const totalMethods = ctx.manifest.methods.length;\n const completedCount = ctx.manifest.methods.filter(\n (method) => method.status === 'completed'\n ).length;\n const skippedCount = ctx.manifest.methods.filter((method) => method.status === 'skipped').length;\n const failedMethods = ctx.manifest.methods.filter((method) => method.status === 'failed');\n const failedCount = failedMethods.length;\n\n console.log('');\n console.log(\n `🔬 Analysis discovery complete: ${completedCount} files found, ${skippedCount} skipped, ${failedCount} issues (of ${totalMethods})`\n );\n console.log(` Confidence: ${ctx.manifest.overallConfidence}`);\n console.log(` Manifest: ${ctx.outputDir}/manifest.json`);\n console.log('');\n\n // Verify analysis discovery found files — article generation must never\n // proceed without analysis artifacts. Zero results mean the AI agent\n // needs to write analysis files before the generator can proceed.\n if (failedCount > 0) {\n const failedNames = failedMethods.map((m) => m.method).join(', ');\n throw new Error(\n `Analysis incomplete: ${failedCount} of ${totalMethods} discovered analysis files had issues (${failedNames}). ` +\n 'Article generation requires analysis artifacts to exist.'\n );\n }\n\n if (ctx.completedMethods.length === 0) {\n throw new Error(\n `Analysis produced no discovered files (${failedCount} issues). ` +\n 'Article generation requires AI-generated analysis artifacts in the analysis output directory.'\n );\n }\n\n return ctx;\n}\n\n/**\n * Run the analysis stage and enforce agentic workflow pipeline guards.\n *\n * Wraps `maybeRunAnalysis()` with error handling that aborts the process\n * when analysis was requested but fails (data fetch or method execution).\n *\n * @param date - ISO date string\n * @param client - MCP client or null\n * @returns Analysis context or null (when analysis not requested)\n */\nasync function runAnalysisWithGuard(\n date: string,\n client: EuropeanParliamentMCPClient | null\n): Promise {\n let analysisCtx: AnalysisContext | null;\n try {\n analysisCtx = await maybeRunAnalysis(date, client);\n } catch (err: unknown) {\n const message = err instanceof Error ? err.message : String(err);\n console.error(`❌ Analysis stage failed: ${message}`);\n console.error(\n '🛑 Aborting: agentic workflow requires successful data fetch and analysis before article generation.'\n );\n throw err instanceof Error ? err : new Error(message);\n }\n\n // Gate: when analysis was requested, verify it produced output before\n // proceeding to article generation. Never produce articles without\n // completed analysis — this enforces the agentic workflow principle.\n if ((runAnalysisArg || analysisOnlyArg) && !analysisCtx) {\n const msg =\n '--analysis was requested but no analysis context was produced. ' +\n 'Article generation requires completed analysis.';\n console.error(`🛑 Aborting: ${msg}`);\n throw new Error(msg);\n }\n\n return analysisCtx;\n}\n\n/**\n * Wire AI-provided title/description from CLI `--title` and `--description` flags.\n * The AI agent passes these after analysing the content.\n * They override ALL script-generated metadata for the English version.\n */\nfunction wireAIMetadata(): void {\n if (aiTitle || aiDescription) {\n setAIMetadata(aiTitle, aiDescription);\n if (aiTitle) console.log(`📝 AI-provided title: \"${aiTitle}\"`);\n if (aiDescription) console.log(`📝 AI-provided description: \"${aiDescription}\"`);\n }\n}\n\n/**\n * Compute the dedup suffix by comparing the resolved analysis directory\n * basename with the original slug. Examples:\n * - `('breaking', 'breaking-2')` → `'-2'`\n * - `('breaking', 'breaking')` → `''`\n * - `('breaking-run6', 'breaking-run6-2')` → `'-run6-2'`\n *\n * @param articleTypes - Article type strings to derive the base slug\n * @param analysisDir - Resolved analysis directory basename (may include suffix)\n * @returns Validated dedup suffix string (empty when no suffix applies)\n */\nexport function computeDedupSuffix(articleTypes: readonly string[], analysisDir?: string): string {\n const baseSlugNoRun = deriveArticleTypeSlug(\n articleTypes.filter((t): t is ArticleCategory =>\n VALID_ARTICLE_CATEGORIES.includes(t as ArticleCategory)\n )\n );\n const rawSuffix = analysisDir?.startsWith(baseSlugNoRun)\n ? analysisDir.slice(baseSlugNoRun.length)\n : '';\n // Suffix validation patterns for dedup suffix extraction.\n // Run IDs are sanitized to alphanumeric + hyphen, so preserve the same\n // character class here to avoid dropping custom run scopes such as\n // `-runabc-1` or `-runrelease-candidate`.\n // -run6, -runabc-1 → run-id only\n // -2, -3, -a1b2c3d4 → dedup only (numeric or UUID-fragment)\n // -run6-2, -runabc-1-a1b2c3d4 → combined run-id + dedup\n const RUN_ID_SUFFIX = /^-run[a-z0-9-]{1,64}$/iu;\n const DEDUP_SUFFIX = /^-[\\da-f]{1,8}$/iu;\n const isValidSuffix =\n rawSuffix === '' || RUN_ID_SUFFIX.test(rawSuffix) || DEDUP_SUFFIX.test(rawSuffix);\n return isValidSuffix ? rawSuffix : '';\n}\n\n/**\n * Resolve analysis file entries for article transparency links.\n *\n * Extracts entries from the manifest when it uses the standard pipeline format\n * (methods[] with status and outputFile). When the manifest lacks standard\n * entries (e.g. agentic workflow manifests), falls back to scanning the\n * analysis directory on disk for all `.md` files. This ensures articles\n * link to ALL analysis artifacts regardless of manifest format.\n *\n * @param analysisCtx - Analysis context from the pipeline stage, or null\n * @returns Array of analysis file entries, or undefined when unavailable\n */\nfunction resolveAnalysisFileEntries(\n analysisCtx: AnalysisContext | null\n): AnalysisFileEntry[] | undefined {\n if (!analysisCtx) return undefined;\n\n const manifestMethods = analysisCtx.manifest.methods;\n const completedEntries = manifestMethods\n .filter((m) => m.status === 'completed')\n .map((m) => ({ method: m.method, outputFile: m.outputFile }));\n\n if (completedEntries.length > 0) {\n return completedEntries;\n }\n\n // Manifest may use agentic-workflow format without standard methods[].\n // Fall back to scanning the analysis directory on disk for all .md files.\n const discovered = discoverAnalysisFileEntries(analysisCtx.outputDir);\n if (discovered.length > 0) {\n console.log(\n `📂 Discovered ${discovered.length} analysis files from disk (manifest lacked standard methods)`\n );\n return discovered;\n }\n\n return undefined;\n}\n\n/**\n * Main execution: initialise the MCP client, optionally run analysis stage,\n * iterate over requested article types, delegate to the appropriate strategy,\n * then persist metadata.\n */\nasync function main(): Promise {\n console.log('');\n console.log('🚀 Starting news generation...');\n console.log('');\n\n // Wire AI-provided title/description from CLI flags.\n wireAIMetadata();\n\n // When --feed-data is provided, expose the path via env so strategies can\n // load pre-fetched data without requiring a live MCP connection.\n if (feedDataPath) {\n process.env['EP_FEED_DATA_FILE'] = feedDataPath;\n console.log(`📂 Pre-fetched feed data will be loaded from: ${feedDataPath}`);\n }\n\n const client = await initializeMCPClient(useMCP);\n\n // Determine today's date for the analysis stage\n // split('T')[0] on a valid ISO string always returns the date portion\n const isoToday = new Date().toISOString();\n const todayDate = isoToday.slice(0, 10);\n\n try {\n // Run analysis stage with pipeline enforcement guards\n const analysisCtx = await runAnalysisWithGuard(todayDate, client);\n\n // Extract the resolved analysis directory basename (e.g. 'breaking-2')\n // so article transparency links point to the correct suffixed analysis\n // directory when suffix deduplication is active.\n const analysisDir = analysisCtx ? path.basename(analysisCtx.outputDir) : undefined;\n\n // Expose analysis dir/slug via env vars so strategies can locate analysis\n // artifacts without hard-coding paths. Follows the EP_FEED_DATA_FILE pattern.\n if (analysisCtx) {\n // Base dir: parent of date-scoped dir (e.g. 'analysis/daily' from 'analysis/daily/2026-04-06/breaking')\n const analysisOutputParent = path.dirname(analysisCtx.outputDir);\n const analysisBaseDir = path.dirname(analysisOutputParent);\n process.env['EP_ANALYSIS_DIR'] = analysisBaseDir;\n // Slug: the resolved directory basename (may include dedup suffix like 'breaking-2')\n process.env['EP_ANALYSIS_SLUG'] = analysisDir;\n }\n\n // Compute dedup suffix by comparing resolved analysis dir with the base slug\n const dedupSuffix = computeDedupSuffix(articleTypes, analysisDir);\n\n // Extract analysis file entries for the article template's transparency section.\n const analysisFiles = resolveAnalysisFileEntries(analysisCtx);\n\n // If --analysis-only, skip article generation\n if (analysisOnlyArg) {\n console.log('ℹ️ --analysis-only specified. Skipping article generation.');\n return;\n }\n\n const outputOptions: OutputOptions = {\n dryRun: dryRunArg,\n skipExisting: skipExistingArg,\n newsDir: path.resolve(NEWS_DIR),\n };\n\n const registry = createStrategyRegistry();\n\n const results: GenerationResult[] = [];\n\n for (const articleType of articleTypes) {\n if (!VALID_ARTICLE_CATEGORIES.includes(articleType as ArticleCategory)) {\n console.log(`⏭️ Skipping unknown article type: ${articleType}`);\n continue;\n }\n\n const strategy = registry.get(articleType as ArticleCategory);\n if (!strategy) {\n console.log(`⏭️ Article type \"${articleType}\" not yet implemented`);\n continue;\n }\n\n results.push(\n await generateArticleForStrategy(\n strategy,\n client,\n languages,\n outputOptions,\n stats,\n dedupSuffix,\n analysisDir,\n analysisFiles\n )\n );\n }\n\n console.log('');\n console.log('📊 Generation Summary:');\n console.log(` ✅ Generated: ${stats.generated} articles`);\n console.log(` ⏭️ Skipped: ${stats.skipped} articles`);\n if (dryRunArg) console.log(` 🔍 Dry run: ${stats.dryRun} articles`);\n console.log(` ❌ Errors: ${stats.errors}`);\n console.log('');\n\n writeGenerationMetadata(stats, results, client !== null, METADATA_DIR, dryRunArg);\n\n process.exitCode = stats.errors > 0 ? 1 : 0;\n } finally {\n if (client) {\n console.log('🔌 Closing MCP client connection...');\n await closeEPMCPClient();\n }\n }\n}\n\n// Only run main when executed directly (not when imported)\nif (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {\n main().catch((err: unknown) => {\n const message = err instanceof Error ? err.message : String(err);\n console.error(`💥 Fatal: ${message}`);\n process.exitCode = 1;\n });\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/news-indexes.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":108,"column":22,"endLine":108,"endColumn":48},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":215,"column":27,"endLine":215,"endColumn":46},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":379,"column":26,"endLine":379,"endColumn":39}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":3,"fixableErrorCount":0,"fixableWarningCount":0,"source":"#!/usr/bin/env node\n\n// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/NewsIndexes\n * @description Generates index.html files for each language listing all news articles.\n * English is the primary homepage (index.html), other languages use index-{lang}.html.\n * Design follows riksdagsmonitor patterns: compact language switcher, Hack23 AB footer.\n */\n\nimport path, { resolve } from 'path';\nimport { pathToFileURL } from 'url';\nimport {\n PROJECT_ROOT,\n APP_VERSION,\n NEWS_DIR,\n createThemeToggleButton,\n} from '../constants/config.js';\nimport {\n ALL_LANGUAGES,\n LANGUAGE_NAMES,\n LANGUAGE_FLAGS,\n PAGE_TITLES,\n PAGE_DESCRIPTIONS,\n SECTION_HEADINGS,\n NO_ARTICLES_MESSAGES,\n SKIP_LINK_TEXTS,\n AI_SECTION_CONTENT,\n FILTER_LABELS,\n ARTICLE_TYPE_LABELS,\n HEADER_SUBTITLE_LABELS,\n THEME_TOGGLE_LABELS,\n getLocalizedString,\n getTextDirection,\n} from '../constants/languages.js';\nimport { buildSiteFooter } from '../templates/section-builders.js';\nimport {\n getNewsArticles,\n groupArticlesByLanguage,\n formatSlug,\n parseArticleFilename,\n extractArticleMeta,\n escapeHTML,\n atomicWrite,\n} from '../utils/file-utils.js';\nimport { writeMetadataDatabase } from '../utils/news-metadata.js';\nimport { detectCategory } from '../utils/article-category.js';\nimport type {\n ParsedArticle,\n ArticleCategoryLabels,\n ArticleCategory,\n LanguageCode,\n} from '../types/index.js';\n\n/**\n * Get the index filename for a given language code.\n * English uses index.html (the primary homepage), others use index-{lang}.html.\n *\n * @param lang - Language code\n * @returns Filename string\n */\nexport function getIndexFilename(lang: string): string {\n return lang === 'en' ? 'index.html' : `index-${lang}.html`;\n}\n\n/**\n * Build the compact language switcher nav HTML.\n * Uses flag emoji + language code, riksdagsmonitor style.\n *\n * @param currentLang - Active language code\n * @returns HTML string\n */\nfunction buildLangSwitcher(currentLang: string): string {\n return ALL_LANGUAGES.map((code) => {\n const flag = getLocalizedString(LANGUAGE_FLAGS, code);\n const name = getLocalizedString(LANGUAGE_NAMES, code);\n const active = code === currentLang ? ' active' : '';\n const href = getIndexFilename(code);\n const current = code === currentLang ? ' aria-current=\"page\"' : '';\n const safeHref = escapeHTML(href);\n const safeCode = escapeHTML(code);\n const safeName = escapeHTML(name);\n return `${flag} ${code.toUpperCase()}`;\n }).join('\\n ');\n}\n\n/**\n * Render a single news card element.\n *\n * @param article - Parsed article data\n * @param meta - Real title and description extracted from the article HTML\n * @param meta.title - Article title\n * @param meta.description - Article description/excerpt\n * @param categoryLabels - Optional localized article category labels\n * @returns HTML string for one card\n */\nfunction renderCard(\n article: ParsedArticle,\n meta: { title: string; description: string },\n categoryLabels?: ArticleCategoryLabels\n): string {\n const category = detectCategory(article.slug);\n // Sanitize the category for safe use in CSS class names (allow only alphanumeric and hyphens)\n const safeCategory = String(category).replace(/[^a-z0-9-]/gi, '');\n const title = escapeHTML(meta.title || formatSlug(article.slug));\n const badgeLabel = categoryLabels?.[category] ?? formatSlug(safeCategory);\n const excerpt = meta.description\n ? `\\n

    ${escapeHTML(meta.description)}

    `\n : '';\n\n return `\n
  • \n \n
    \n
    \n
    \n ${escapeHTML(badgeLabel)}\n \n
    \n

    ${title}

    ${excerpt}\n
    \n     \n
    • `;\n}\n\n/**\n * Build hreflang alternate link tags for SEO multi-language support.\n *\n * @returns HTML string of link elements\n */\nfunction buildHreflangTags(): string {\n const links = ALL_LANGUAGES.map((code) => {\n const href = getIndexFilename(code);\n return ``;\n });\n links.push('');\n return links.join('\\n ');\n}\n\n/**\n * Generate index HTML for a language.\n *\n * Produces a complete, standards-compliant HTML5 page with:\n * - Sticky header with EU branding\n * - Compact language switcher with flag + code\n * - Hero section with page title and description\n * - Responsive card grid for news articles\n * - Accessible empty state when no articles exist\n * - Hack23 AB multi-section footer (About, Quick Links, Built by Hack23, Languages)\n *\n * @param lang - Language code\n * @param articles - Articles for this language\n * @param metaMap - Map of article filename to real title and description\n * @returns Complete HTML document\n */\nexport function generateIndexHTML(\n lang: string,\n articles: ParsedArticle[],\n metaMap: Map = new Map()\n): string {\n const title = getLocalizedString(PAGE_TITLES, lang);\n const description = getLocalizedString(PAGE_DESCRIPTIONS, lang);\n const heading = getLocalizedString(SECTION_HEADINGS, lang);\n const noArticlesText = getLocalizedString(NO_ARTICLES_MESSAGES, lang);\n const skipLinkText = getLocalizedString(SKIP_LINK_TEXTS, lang);\n const dir = getTextDirection(lang);\n const selfHref = getIndexFilename(lang);\n const heroTitle = title.split(' - ')[0];\n const filterLabels = getLocalizedString(FILTER_LABELS, lang) as { all: string; search: string };\n const categoryLabels = getLocalizedString(ARTICLE_TYPE_LABELS, lang) as ArticleCategoryLabels;\n\n // Collect distinct categories from the current article set\n const usedCategories = new Set();\n for (const a of articles) {\n usedCategories.add(detectCategory(a.slug));\n }\n\n const content =\n articles.length === 0\n ? `\n
    \n
    📰
    \n

    ${noArticlesText}

    \n
    `\n : `\n
      \n ${articles\n .map((a) =>\n renderCard(\n a,\n metaMap.get(a.filename) ?? { title: formatSlug(a.slug), description: '' },\n categoryLabels\n )\n )\n .join('\\n')}\n
    `;\n\n const ai = getLocalizedString(AI_SECTION_CONTENT, lang);\n\n // Build filter buttons from used categories (with article count)\n const categoryCounts = new Map();\n for (const a of articles) {\n const cat = detectCategory(a.slug);\n categoryCounts.set(cat, (categoryCounts.get(cat) ?? 0) + 1);\n }\n\n const filterButtons =\n articles.length > 0\n ? Array.from(usedCategories)\n .sort()\n .map((cat) => {\n const safeCat = String(cat).replace(/[^a-z0-9-]/gi, '');\n const label = categoryLabels[cat] ?? formatSlug(safeCat);\n const count = categoryCounts.get(cat) ?? 0;\n return ``;\n })\n .join('\\n ')\n : '';\n\n const headerSubtitle = escapeHTML(getLocalizedString(HEADER_SUBTITLE_LABELS, lang));\n const themeToggleLabel = escapeHTML(getLocalizedString(THEME_TOGGLE_LABELS, lang));\n const canonicalUrl = `https://hack23.github.io/euparliamentmonitor/${selfHref}`;\n\n return `\n\n\n \n \n \n \n \n ${title}\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n ${buildHreflangTags()}\n \n \n \n \n \n \n \n \n \n\n\n ${skipLinkText}\n\n
    \n
    \n \n \n \n \n \n \n ${heroTitle}\n \n \n ${createThemeToggleButton(themeToggleLabel)}\n \n
    \n
    \n\n
    \n
    \n
    \n

    ${headerSubtitle}

    \n

    ${heroTitle}

    \n

    ${description}

    \n
    \n \n \n \"EU\n \n
    \n
    \n\n
    \n

    📋 ${heading}

    ${\n articles.length > 0\n ? `\n
    \n
    \n \n ${filterButtons}\n
    \n
    \n \n
    \n
    `\n : ''\n }\n ${content}\n
    \n\n
    \n

    🤖 ${escapeHTML(ai.heading)}

    \n
    ${escapeHTML(ai.quote)}
    \n

    ${escapeHTML(ai.description)}

    \n
      \n
    • ${escapeHTML(ai.featureAgents)} — ${escapeHTML(ai.featureAgentsDesc)}
      • \n
    • ${escapeHTML(ai.featureSchedule)} — ${escapeHTML(ai.featureScheduleDesc)}
      • \n
    • ${escapeHTML(ai.featureHuman)} — ${escapeHTML(ai.featureHumanDesc)}
      • \n
    • ${escapeHTML(ai.featureData)} — ${escapeHTML(ai.featureDataDesc)}
      • \n
    \n
    \n\n ${buildSiteFooter({ lang: lang as LanguageCode, pathPrefix: '', articleCount: articles.length })}\n\n \n\n`;\n}\n\n/**\n * Main execution - generates index files for all languages.\n * English generates index.html (primary homepage), others generate index-{lang}.html.\n */\nfunction main(): void {\n console.log('📰 Generating news indexes...');\n\n const articles = getNewsArticles();\n console.log(`📊 Found ${articles.length} articles`);\n\n const grouped = groupArticlesByLanguage(articles, ALL_LANGUAGES);\n\n // Build metadata map (real titles + descriptions from each article HTML)\n const metaBuildTimerLabel = `⏱️ Built metadata map for ${articles.length} articles`;\n console.time(metaBuildTimerLabel);\n const metaMap = new Map();\n for (const filename of articles) {\n const filepath = path.join(NEWS_DIR, filename);\n metaMap.set(filename, extractArticleMeta(filepath));\n }\n console.timeEnd(metaBuildTimerLabel);\n\n // Also update the metadata database, reusing the already-extracted meta to avoid re-reading files\n const dbArticles = articles\n .map((filename) => {\n const parsed = parseArticleFilename(filename);\n if (!parsed) return null;\n const meta = metaMap.get(filename) ?? { title: '', description: '' };\n return {\n filename: parsed.filename,\n date: parsed.date,\n slug: parsed.slug,\n lang: parsed.lang,\n title: meta.title || formatSlug(parsed.slug),\n description: meta.description,\n };\n })\n .filter((e): e is NonNullable => e !== null);\n dbArticles.sort((a, b) => b.date.localeCompare(a.date));\n writeMetadataDatabase({ lastUpdated: new Date().toISOString(), articles: dbArticles });\n console.log('📝 Updated articles metadata database');\n\n let generated = 0;\n for (const lang of ALL_LANGUAGES) {\n const langArticles = grouped[lang] ?? [];\n const html = generateIndexHTML(lang, langArticles, metaMap);\n const filename = getIndexFilename(lang);\n const filepath = path.join(PROJECT_ROOT, filename);\n\n atomicWrite(filepath, html);\n console.log(` ✅ Generated ${filename} (${langArticles.length} articles)`);\n generated++;\n }\n\n console.log(`✅ Generated ${generated} index files`);\n}\n\n// Only run main when executed directly (not when imported)\nif (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {\n main();\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/pipeline/analysis-stage.ts","messages":[],"suppressedMessages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":179,"column":15,"endLine":179,"endColumn":24,"suppressions":[{"kind":"directive","justification":""}]}],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/pipeline/fetch-stage.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Function Call Object Injection Sink","line":492,"column":21,"endLine":492,"endColumn":29},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":492,"column":34,"endLine":492,"endColumn":42},{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":772,"column":19,"endLine":772,"endColumn":36},{"ruleId":null,"message":"Unused eslint-disable directive (no problems were reported from '@typescript-eslint/no-unused-vars').","line":1943,"column":3,"severity":1,"fix":{"range":[69424,69485],"text":" "}},{"ruleId":"@typescript-eslint/no-non-null-assertion","severity":1,"message":"Forbidden non-null assertion.","line":1947,"column":5,"messageId":"noNonNull","endLine":1947,"endColumn":12,"suggestions":[{"messageId":"suggestOptionalChain","fix":{"range":[69636,69637],"text":"?"},"desc":"Consider using the optional chain operator `?.` instead. This operator includes runtime checks, so it is safer than the compile-only non-null assertion operator."}]},{"ruleId":null,"message":"Unused eslint-disable directive (no problems were reported from '@typescript-eslint/no-unused-vars').","line":1961,"column":3,"severity":1,"fix":{"range":[70051,70112],"text":" "}},{"ruleId":"@typescript-eslint/no-non-null-assertion","severity":1,"message":"Forbidden non-null assertion.","line":1965,"column":5,"messageId":"noNonNull","endLine":1965,"endColumn":12,"suggestions":[{"messageId":"suggestOptionalChain","fix":{"range":[70271,70272],"text":"?"},"desc":"Consider using the optional chain operator `?.` instead. This operator includes runtime checks, so it is safer than the compile-only non-null assertion operator."}]},{"ruleId":null,"message":"Unused eslint-disable directive (no problems were reported from '@typescript-eslint/no-unused-vars').","line":1979,"column":3,"severity":1,"fix":{"range":[70697,70758],"text":" "}},{"ruleId":"@typescript-eslint/no-non-null-assertion","severity":1,"message":"Forbidden non-null assertion.","line":1983,"column":5,"messageId":"noNonNull","endLine":1983,"endColumn":12,"suggestions":[{"messageId":"suggestOptionalChain","fix":{"range":[70919,70920],"text":"?"},"desc":"Consider using the optional chain operator `?.` instead. This operator includes runtime checks, so it is safer than the compile-only non-null assertion operator."}]},{"ruleId":null,"message":"Unused eslint-disable directive (no problems were reported from '@typescript-eslint/no-unused-vars').","line":1997,"column":3,"severity":1,"fix":{"range":[71358,71419],"text":" "}},{"ruleId":"@typescript-eslint/no-non-null-assertion","severity":1,"message":"Forbidden non-null assertion.","line":2001,"column":5,"messageId":"noNonNull","endLine":2001,"endColumn":12,"suggestions":[{"messageId":"suggestOptionalChain","fix":{"range":[71586,71587],"text":"?"},"desc":"Consider using the optional chain operator `?.` instead. This operator includes runtime checks, so it is safer than the compile-only non-null assertion operator."}]},{"ruleId":null,"message":"Unused eslint-disable directive (no problems were reported from '@typescript-eslint/no-unused-vars').","line":2056,"column":3,"severity":1,"fix":{"range":[73498,73559],"text":" "}},{"ruleId":"@typescript-eslint/no-non-null-assertion","severity":1,"message":"Forbidden non-null assertion.","line":2060,"column":5,"messageId":"noNonNull","endLine":2060,"endColumn":12,"suggestions":[{"messageId":"suggestOptionalChain","fix":{"range":[73724,73725],"text":"?"},"desc":"Consider using the optional chain operator `?.` instead. This operator includes runtime checks, so it is safer than the compile-only non-null assertion operator."}]},{"ruleId":null,"message":"Unused eslint-disable directive (no problems were reported from '@typescript-eslint/no-unused-vars').","line":2107,"column":3,"severity":1,"fix":{"range":[75444,75505],"text":" "}}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":14,"fixableErrorCount":0,"fixableWarningCount":6,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/Pipeline/FetchStage\n * @description MCP data-fetching pipeline stage with circuit breaker protection.\n *\n * MCP-facing functions accept an explicit `client` argument instead of reading\n * module-level state, making them straightforward to unit-test with a mock\n * client. The {@link loadFeedDataFromFile} and {@link loadEPFeedDataFromFile}\n * helpers introduce filesystem I/O to load pre-fetched feed JSON produced by\n * agentic workflows.\n *\n * The {@link CircuitBreaker} (imported from `mcp/mcp-retry`) prevents cascading\n * failures when the MCP server is degraded: after\n * {@link CircuitBreakerOptions.failureThreshold} consecutive errors the circuit\n * opens and subsequent calls short-circuit immediately.\n */\n\nimport fs from 'fs';\nimport type { EuropeanParliamentMCPClient } from '../../mcp/ep-mcp-client.js';\nimport { getEPMCPClient } from '../../mcp/ep-mcp-client.js';\nimport type {\n WeekAheadData,\n DateRange,\n CommitteeData,\n MCPToolResult,\n VotingRecord,\n VotingPattern,\n VotingAnomaly,\n MotionsQuestion,\n LegislativeDocument,\n AdoptedTextFeedItem,\n EventFeedItem,\n ProcedureFeedItem,\n MEPFeedItem,\n DocumentFeedItem,\n QuestionFeedItem,\n DeclarationFeedItem,\n CorporateBodyFeedItem,\n BreakingNewsFeedData,\n EPFeedData,\n FeedTimeframe,\n} from '../../types/index.js';\nimport {\n parsePlenarySessions,\n parseCommitteeMeetings,\n parseLegislativeDocuments,\n parseLegislativePipeline,\n parseParliamentaryQuestions,\n parseEPEvents,\n PLACEHOLDER_EVENTS,\n} from '../week-ahead-content.js';\nimport {\n applyCommitteeInfo,\n applyDocuments,\n applyEffectiveness,\n PLACEHOLDER_CHAIR,\n PLACEHOLDER_MEMBERS,\n} from '../committee-helpers.js';\nimport { getMotionsFallbackData } from '../motions-content.js';\nimport { escapeHTML } from '../../utils/file-utils.js';\nimport type { PipelineData } from '../propositions-content.js';\n\n// ─── Circuit Breaker (re-exported from mcp-retry bounded context) ────────────\n\nexport {\n CircuitBreaker,\n type CircuitState,\n type CircuitBreakerOptions,\n} from '../../mcp/mcp-retry.js';\nimport { CircuitBreaker } from '../../mcp/mcp-retry.js';\n\n/** Module-level circuit breaker shared across all MCP fetch operations */\nexport const mcpCircuitBreaker = new CircuitBreaker();\n\n// ─── Shared string constants ─────────────────────────────────────────────────\n\n/** Log prefix for MCP fetch operations */\nconst MCP_FETCH_PREFIX = ' 📡';\n\n/** Warning prefix for MCP failures */\nconst WARN_PREFIX = ' ⚠️';\n\n/** Info prefix for fallback messages */\nconst INFO_PREFIX = ' ℹ️';\n\n/**\n * Execute a single MCP API call through the module-level circuit breaker.\n * Short-circuits with `fallback` whenever the circuit breaker is not\n * accepting requests (for example when OPEN, or in HALF_OPEN with no\n * probe slots available).\n * Records success or failure after each call, opening the circuit when\n * {@link CircuitBreakerOptions.failureThreshold} consecutive failures occur.\n *\n * @param fn - Async factory that performs the MCP call\n * @param fallback - Value returned when the circuit is not accepting requests\n * @param context - Label used in warning messages\n * @returns Result of `fn` or `fallback`\n */\nasync function callMCP(fn: () => Promise, fallback: T, context: string): Promise {\n if (!mcpCircuitBreaker.canRequest()) {\n console.warn(\n `${WARN_PREFIX} Circuit breaker not accepting requests (${mcpCircuitBreaker.getState()}) — skipping ${context}`\n );\n return fallback;\n }\n try {\n const result = await fn();\n mcpCircuitBreaker.recordSuccess();\n return result;\n } catch (error) {\n mcpCircuitBreaker.recordFailure();\n throw error;\n }\n}\n\n// ─── Internal helpers ─────────────────────────────────────────────────────────\n\n/**\n * Parse JSON text, returning `null` and logging a warning on parse failure.\n *\n * @param text - Raw JSON string\n * @param context - Label used in the warning message\n * @returns Parsed value or null\n */\nfunction parseJSON(text: string, context: string): T | null {\n try {\n return JSON.parse(text) as T;\n } catch {\n console.warn(`${WARN_PREFIX} Failed to parse JSON for ${context}`);\n return null;\n }\n}\n\n/** Base shape for feed items that carry a date field */\ntype DatedFeedItem = { date: string };\n\n/**\n * Normalize a feed-item date into canonical UTC `YYYY-MM-DD` form.\n *\n * @param value - Raw date string from MCP or a prefetched feed file\n * @returns Canonical date string, or undefined when the value is missing/invalid\n */\nfunction normalizeFeedItemDate(value: string): string | undefined {\n const trimmed = value.trim();\n if (trimmed === '') return undefined;\n\n const directDate = trimmed.slice(0, 10);\n if (directDate.length === 10) {\n const direct = new Date(`${directDate}T00:00:00Z`);\n if (!Number.isNaN(direct.getTime())) {\n return directDate;\n }\n }\n\n const parsed = new Date(trimmed);\n if (Number.isNaN(parsed.getTime())) return undefined;\n\n const parts = parsed.toISOString().split('T');\n return parts[0];\n}\n\n/**\n * Filter dated feed items to an inclusive UTC date window.\n *\n * Items without a parseable `date` are dropped when a window is supplied.\n *\n * @param items - Feed items to filter\n * @param dateRange - Inclusive UTC window, or undefined to keep all items\n * @param label - Human-readable label used in logs\n * @returns Filtered array\n */\nfunction filterFeedItemsByDateRange(\n items: readonly T[],\n dateRange: DateRange | undefined,\n label: string\n): T[] {\n if (!dateRange) return [...items];\n\n const filtered = items.filter((item) => {\n const normalized = normalizeFeedItemDate(item.date);\n if (normalized === undefined) return false;\n return normalized >= dateRange.start && normalized <= dateRange.end;\n });\n\n if (filtered.length !== items.length) {\n console.log(\n `${INFO_PREFIX} Filtered ${label} to ${filtered.length}/${items.length} items within ` +\n `${dateRange.start}..${dateRange.end}`\n );\n }\n\n return filtered;\n}\n\n/**\n * Apply a date-range filter across all breaking-news feed arrays.\n *\n * @param feedData - Feed data to filter\n * @param dateRange - Inclusive UTC window, or undefined to keep all items\n * @returns Filtered feed payload\n */\nfunction filterBreakingNewsFeedDataByDateRange(\n feedData: BreakingNewsFeedData,\n dateRange: DateRange | undefined\n): BreakingNewsFeedData {\n const filteredMEPUpdates = filterFeedItemsByDateRange(\n feedData.mepUpdates,\n dateRange,\n 'MEP updates'\n );\n return {\n adoptedTexts: filterFeedItemsByDateRange(feedData.adoptedTexts, dateRange, 'adopted texts'),\n events: filterFeedItemsByDateRange(feedData.events, dateRange, 'events'),\n procedures: filterFeedItemsByDateRange(feedData.procedures, dateRange, 'procedures'),\n mepUpdates: filteredMEPUpdates,\n // When a date-range filter is applied the API-reported total covers the full\n // feed window, not the filtered subset — clear it to avoid a misleading\n // truncation note (\"showing 10 of 525\" on a single-day slice).\n totalMEPUpdates: dateRange === undefined ? feedData.totalMEPUpdates : undefined,\n };\n}\n\n/**\n * Apply a date-range filter across all comprehensive EP feed arrays.\n *\n * @param feedData - Feed data to filter\n * @param dateRange - Inclusive UTC window, or undefined to keep all items\n * @returns Filtered feed payload\n */\nfunction filterEPFeedDataByDateRange(\n feedData: EPFeedData,\n dateRange: DateRange | undefined\n): EPFeedData {\n return {\n adoptedTexts: filterFeedItemsByDateRange(feedData.adoptedTexts, dateRange, 'adopted texts'),\n events: filterFeedItemsByDateRange(feedData.events, dateRange, 'events'),\n procedures: filterFeedItemsByDateRange(feedData.procedures, dateRange, 'procedures'),\n mepUpdates: filterFeedItemsByDateRange(feedData.mepUpdates, dateRange, 'MEP updates'),\n documents: filterFeedItemsByDateRange(feedData.documents, dateRange, 'documents'),\n plenaryDocuments: filterFeedItemsByDateRange(\n feedData.plenaryDocuments,\n dateRange,\n 'plenary documents'\n ),\n committeeDocuments: filterFeedItemsByDateRange(\n feedData.committeeDocuments,\n dateRange,\n 'committee documents'\n ),\n plenarySessionDocuments: filterFeedItemsByDateRange(\n feedData.plenarySessionDocuments,\n dateRange,\n 'plenary session documents'\n ),\n externalDocuments: filterFeedItemsByDateRange(\n feedData.externalDocuments,\n dateRange,\n 'external documents'\n ),\n questions: filterFeedItemsByDateRange(feedData.questions, dateRange, 'questions'),\n declarations: filterFeedItemsByDateRange(feedData.declarations, dateRange, 'declarations'),\n corporateBodies: filterFeedItemsByDateRange(\n feedData.corporateBodies,\n dateRange,\n 'corporate bodies'\n ),\n };\n}\n\n/**\n * Compute an inclusive UTC date window ending on `endDate`.\n *\n * @param endDate - Inclusive UTC end date in `YYYY-MM-DD` form\n * @param lookbackDays - Number of calendar days to subtract for the start date\n * @param context - Label used in error messages\n * @returns Inclusive date range\n */\nexport function computeRollingDateRange(\n endDate: string,\n lookbackDays: number,\n context: string\n): DateRange {\n const startDate = new Date(`${endDate}T00:00:00Z`);\n startDate.setUTCDate(startDate.getUTCDate() - lookbackDays);\n const startDateParts = startDate.toISOString().split('T');\n if (!startDateParts[0]) {\n throw new Error(`Invalid date format generated for ${context}`);\n }\n return { start: startDateParts[0], end: endDate };\n}\n\n// ─── MCP client initialisation ───────────────────────────────────────────────\n\n/**\n * Attempt to connect to the European Parliament MCP server.\n * Returns `null` (with a warning) if the connection fails or MCP is disabled.\n *\n * @param useMCP - Whether MCP should be used at all\n * @returns Connected client or null\n */\nexport async function initializeMCPClient(\n useMCP: boolean\n): Promise {\n if (!useMCP) {\n console.log(`${INFO_PREFIX} MCP client disabled via USE_EP_MCP=false`);\n return null;\n }\n try {\n console.log('🔌 Attempting to connect to European Parliament MCP Server...');\n const client = await getEPMCPClient();\n console.log('✅ MCP client connected successfully');\n return client;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn('⚠️ Could not connect to MCP server:', message);\n console.warn('⚠️ Falling back to placeholder content');\n return null;\n }\n}\n\n// ─── Pre-fetched feed data loading ───────────────────────────────────────────\n\n/**\n * Check whether a value is a non-null, non-array plain object.\n *\n * @param v - Value to check\n * @returns True when v is a plain object\n */\nfunction isPlainObject(v: unknown): v is Record {\n return typeof v === 'object' && v !== null && !Array.isArray(v);\n}\n\n/**\n * Sanitize an array of raw items into feed items with title-based required fields.\n * Filters out non-objects and coerces `id`, `title`, `date` to strings.\n *\n * Uses `as unknown as T` because the spread preserves optional properties from\n * the source JSON while the explicit field assignments guarantee the required\n * base fields — TypeScript cannot infer this mixed provenance automatically.\n *\n * @param items - Raw array of unknown values from JSON\n * @returns Sanitized array of typed feed items\n */\nfunction sanitizeTitleItems(\n items: readonly unknown[]\n): T[] {\n return items\n .filter(isPlainObject)\n .filter(\n (item) =>\n (item['id'] !== undefined && item['id'] !== null) ||\n (item['title'] !== undefined && item['title'] !== null)\n )\n .map(\n (item) =>\n ({\n ...item,\n id: String(item['id'] ?? ''),\n title: String(item['title'] ?? ''),\n date: String(item['date'] ?? ''),\n }) as unknown as T\n );\n}\n\n/**\n * Sanitize an array of raw items into MEP feed items.\n * Filters out non-objects and coerces `id`, `name`, `date` to strings.\n *\n * @param items - Raw array of unknown values from JSON\n * @returns Sanitized array of MEP feed items\n */\nfunction sanitizeMEPItems(items: readonly unknown[]): MEPFeedItem[] {\n return items\n .filter(isPlainObject)\n .filter(\n (item) =>\n (item['id'] !== undefined && item['id'] !== null) ||\n (item['name'] !== undefined && item['name'] !== null)\n )\n .map(\n (item) =>\n ({\n ...item,\n id: String(item['id'] ?? ''),\n name: String(item['name'] ?? ''),\n date: String(item['date'] ?? ''),\n }) as unknown as MEPFeedItem\n );\n}\n\n/**\n * Load pre-fetched feed data from a JSON file on disk.\n *\n * Agentic workflows fetch EP data via framework MCP tools but the TypeScript\n * generator cannot access those tools directly. The workflow saves the MCP\n * results to a JSON file and the generator reads them via this function,\n * avoiding the need to manually construct article HTML.\n *\n * The file must contain a JSON object. The optional keys\n * `adoptedTexts`, `events`, `procedures`, and `mepUpdates` are treated as\n * arrays and default to empty arrays when missing (an empty object `{}` is valid).\n *\n * @param filePath - Absolute or relative path to the JSON file\n * @param dateRange - Optional inclusive UTC window for filtering loaded items\n * @returns Parsed {@link BreakingNewsFeedData}, or `undefined` on any error\n */\nexport function loadFeedDataFromFile(\n filePath: string,\n dateRange?: DateRange\n): BreakingNewsFeedData | undefined {\n try {\n if (!fs.existsSync(filePath)) {\n console.warn(`${WARN_PREFIX} Feed data file not found: ${filePath}`);\n return undefined;\n }\n const raw = fs.readFileSync(filePath, 'utf-8');\n const parsed: unknown = JSON.parse(raw);\n if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n console.warn(`${WARN_PREFIX} Feed data file must contain a JSON object`);\n return undefined;\n }\n const obj = parsed as Record;\n const adoptedTexts = sanitizeTitleItems(\n Array.isArray(obj['adoptedTexts']) ? obj['adoptedTexts'] : []\n );\n const events = sanitizeTitleItems(\n Array.isArray(obj['events']) ? obj['events'] : []\n );\n const procedures = sanitizeTitleItems(\n Array.isArray(obj['procedures']) ? obj['procedures'] : []\n );\n const mepUpdates = sanitizeMEPItems(Array.isArray(obj['mepUpdates']) ? obj['mepUpdates'] : []);\n const totalMEPUpdates =\n typeof obj['totalMEPUpdates'] === 'number' ? obj['totalMEPUpdates'] : undefined;\n const filteredData = filterBreakingNewsFeedDataByDateRange(\n {\n adoptedTexts,\n events,\n procedures,\n mepUpdates,\n totalMEPUpdates,\n },\n dateRange\n );\n console.log(\n `${INFO_PREFIX} Loaded feed data from file: ` +\n `${filteredData.adoptedTexts.length} adopted texts, ${filteredData.events.length} events, ` +\n `${filteredData.procedures.length} procedures, ${filteredData.mepUpdates.length} MEP updates`\n );\n return filteredData;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} Failed to load feed data from file: ${message}`);\n return undefined;\n }\n}\n\n/**\n * Load pre-fetched comprehensive EP feed data from a JSON file on disk.\n *\n * Agentic workflows fetch EP data via framework MCP tools but the TypeScript\n * generator cannot access those tools directly. The workflow saves the MCP\n * results to a JSON file and the generator reads them via this function,\n * avoiding the need to manually construct article HTML.\n *\n * The file must contain a JSON object with EP feed data keys.\n * Missing keys default to empty arrays.\n *\n * @param filePath - Absolute or relative path to the JSON file\n * @param dateRange - Optional inclusive UTC window for filtering loaded items\n * @returns Parsed {@link EPFeedData}, or `undefined` on any error\n */\nexport function loadEPFeedDataFromFile(\n filePath: string,\n dateRange?: DateRange\n): EPFeedData | undefined {\n try {\n if (!fs.existsSync(filePath)) {\n console.warn(`${WARN_PREFIX} EP feed data file not found: ${filePath}`);\n return undefined;\n }\n const raw = fs.readFileSync(filePath, 'utf-8');\n const parsed: unknown = JSON.parse(raw);\n if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n console.warn(`${WARN_PREFIX} EP feed data file must contain a JSON object`);\n return undefined;\n }\n const obj = parsed as Record;\n const safeArray = (key: string): readonly unknown[] =>\n Array.isArray(obj[key]) ? (obj[key] as unknown[]) : [];\n const adoptedTexts = sanitizeTitleItems(safeArray('adoptedTexts'));\n const events = sanitizeTitleItems(safeArray('events'));\n const procedures = sanitizeTitleItems(safeArray('procedures'));\n const mepUpdates = sanitizeMEPItems(safeArray('mepUpdates'));\n const documents = sanitizeTitleItems(safeArray('documents'));\n const plenaryDocuments = sanitizeTitleItems(safeArray('plenaryDocuments'));\n const committeeDocuments = sanitizeTitleItems(\n safeArray('committeeDocuments')\n );\n const plenarySessionDocuments = sanitizeTitleItems(\n safeArray('plenarySessionDocuments')\n );\n const externalDocuments = sanitizeTitleItems(safeArray('externalDocuments'));\n const questions = sanitizeTitleItems(safeArray('questions'));\n const declarations = sanitizeTitleItems(safeArray('declarations'));\n const corporateBodies = sanitizeTitleItems(safeArray('corporateBodies'));\n const filteredData = filterEPFeedDataByDateRange(\n {\n adoptedTexts,\n events,\n procedures,\n mepUpdates,\n documents,\n plenaryDocuments,\n committeeDocuments,\n plenarySessionDocuments,\n externalDocuments,\n questions,\n declarations,\n corporateBodies,\n },\n dateRange\n );\n const totalItems =\n filteredData.adoptedTexts.length +\n filteredData.events.length +\n filteredData.procedures.length +\n filteredData.mepUpdates.length +\n filteredData.documents.length +\n filteredData.plenaryDocuments.length +\n filteredData.committeeDocuments.length +\n filteredData.plenarySessionDocuments.length +\n filteredData.externalDocuments.length +\n filteredData.questions.length +\n filteredData.declarations.length +\n filteredData.corporateBodies.length;\n console.log(\n `${INFO_PREFIX} Loaded EP feed data from file: ${totalItems} total items across 12 keys`\n );\n return filteredData;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} Failed to load EP feed data from file: ${message}`);\n return undefined;\n }\n}\n\n// ─── Week-Ahead fetches ──────────────────────────────────────────────────────\n\n/**\n * Fetch aggregated week-ahead data from multiple MCP sources in parallel.\n * Returns placeholder data when the client is unavailable.\n *\n * @param client - MCP client or null\n * @param dateRange - Date range for the week-ahead period\n * @returns Aggregated week-ahead data\n */\nexport async function fetchWeekAheadData(\n client: EuropeanParliamentMCPClient | null,\n dateRange: DateRange\n): Promise {\n if (!client) {\n console.log(`${INFO_PREFIX} MCP unavailable — using placeholder events`);\n return {\n events: PLACEHOLDER_EVENTS.map((e) => ({ ...e, date: dateRange.start })),\n committees: [],\n documents: [],\n pipeline: [],\n questions: [],\n };\n }\n\n if (!mcpCircuitBreaker.canRequest()) {\n console.warn(\n `${WARN_PREFIX} Circuit breaker not accepting requests (${mcpCircuitBreaker.getState()}) — using placeholder events`\n );\n return {\n events: PLACEHOLDER_EVENTS.map((e) => ({ ...e, date: dateRange.start })),\n committees: [],\n documents: [],\n pipeline: [],\n questions: [],\n };\n }\n\n // Record whether we entered as a HALF_OPEN probe so any rejection triggers\n // an immediate re-open (normal circuit-breaker probe semantics).\n const wasHalfOpen = mcpCircuitBreaker.getState() === 'HALF_OPEN';\n\n console.log(`${MCP_FETCH_PREFIX} Fetching week-ahead data from MCP (parallel)...`);\n\n const [plenarySessions, committeeInfo, documents, pipeline, questions, epEvents] =\n await Promise.allSettled([\n client.getPlenarySessions({ dateFrom: dateRange.start, dateTo: dateRange.end, limit: 50 }),\n client.getCommitteeInfo({ showCurrent: true }),\n client.searchDocuments({ keyword: 'parliament', limit: 20 }),\n client.monitorLegislativePipeline({\n dateFrom: dateRange.start,\n dateTo: dateRange.end,\n status: 'ACTIVE',\n limit: 20,\n }),\n client.getParliamentaryQuestions({ dateFrom: dateRange.start, limit: 20 }),\n client.getEvents({ limit: 20 }),\n ]);\n\n const allFailed = [\n plenarySessions,\n committeeInfo,\n documents,\n pipeline,\n questions,\n epEvents,\n ].every((r) => r.status === 'rejected');\n const anyFailed = [plenarySessions, committeeInfo, documents, pipeline, questions, epEvents].some(\n (r) => r.status === 'rejected'\n );\n // In HALF_OPEN any single rejection means the probe failed — re-open immediately.\n if (allFailed || (wasHalfOpen && anyFailed)) {\n mcpCircuitBreaker.recordFailure();\n } else {\n mcpCircuitBreaker.recordSuccess();\n }\n\n const plenaryEvents = parsePlenarySessions(plenarySessions, dateRange.start);\n const additionalEvents = parseEPEvents(epEvents, dateRange.start);\n const events = [...plenaryEvents, ...additionalEvents];\n\n return {\n events:\n events.length > 0 ? events : PLACEHOLDER_EVENTS.map((e) => ({ ...e, date: dateRange.start })),\n committees: parseCommitteeMeetings(committeeInfo, dateRange.start),\n documents: parseLegislativeDocuments(documents),\n pipeline: parseLegislativePipeline(pipeline),\n questions: parseParliamentaryQuestions(questions),\n };\n}\n\n// ─── Breaking-News fetches ───────────────────────────────────────────────────\n\n/**\n * Fetch voting anomaly text from MCP, returning empty string on failure.\n *\n * @param client - MCP client or null\n * @returns Raw anomaly data text\n */\nexport async function fetchVotingAnomalies(\n client: EuropeanParliamentMCPClient | null\n): Promise {\n if (!client) return '';\n try {\n const result = await callMCP(\n () => client.callTool('detect_voting_anomalies', { sensitivityThreshold: 0.3 }),\n undefined,\n 'detect_voting_anomalies'\n );\n return result?.content?.[0]?.text ?? '';\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} detect_voting_anomalies failed:`, message);\n return '';\n }\n}\n\n/**\n * Fetch coalition dynamics analysis text from MCP.\n *\n * @param client - MCP client or null\n * @returns Raw coalition dynamics text\n */\nexport async function fetchCoalitionDynamics(\n client: EuropeanParliamentMCPClient | null\n): Promise {\n if (!client) return '';\n try {\n const result = await callMCP(\n () => client.callTool('analyze_coalition_dynamics', {}),\n undefined,\n 'analyze_coalition_dynamics'\n );\n return result?.content?.[0]?.text ?? '';\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} analyze_coalition_dynamics failed:`, message);\n return '';\n }\n}\n\n/**\n * Fetch voting statistics report text from MCP.\n *\n * @param client - MCP client or null\n * @returns Raw voting report text\n */\nexport async function fetchVotingReport(\n client: EuropeanParliamentMCPClient | null\n): Promise {\n if (!client) return '';\n try {\n const result = await callMCP(\n () => client.callTool('generate_report', { reportType: 'VOTING_STATISTICS' }),\n undefined,\n 'generate_report'\n );\n return result?.content?.[0]?.text ?? '';\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} generate_report failed:`, message);\n return '';\n }\n}\n\n/**\n * Fetch MEP influence assessment text from MCP.\n * Short-circuits immediately when `mepId` is empty.\n *\n * @param client - MCP client or null\n * @param mepId - MEP identifier; pass empty string to skip the call\n * @returns Raw influence data text\n */\nexport async function fetchMEPInfluence(\n client: EuropeanParliamentMCPClient | null,\n mepId: string\n): Promise {\n if (!mepId || !client) return '';\n try {\n const result = await callMCP(\n () => client.callTool('assess_mep_influence', { mepId, includeDetails: true }),\n undefined,\n 'assess_mep_influence'\n );\n return result?.content?.[0]?.text ?? '';\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} assess_mep_influence failed:`, message);\n return '';\n }\n}\n\n// ─── Committee-Reports fetches ───────────────────────────────────────────────\n\n/**\n * Load pre-fetched committee data for a given abbreviation from a JSON file.\n *\n * The file must be a JSON object keyed by committee abbreviation, where each\n * value conforms to {@link CommitteeData}. This allows agentic workflows to\n * inject real EP committee data into the generator without a live MCP\n * connection (same pattern as {@link loadEPFeedDataFromFile}).\n *\n * @param filePath - Path to the JSON file\n * @param abbreviation - Committee code (e.g. `\"ENVI\"`)\n * @returns Parsed {@link CommitteeData} for the committee, or `undefined`\n */\nexport function loadCommitteeDataFromFile(\n filePath: string,\n abbreviation: string\n): CommitteeData | undefined {\n try {\n if (!fs.existsSync(filePath)) {\n console.warn(`${WARN_PREFIX} Committee data file not found: ${filePath}`);\n return undefined;\n }\n const raw = fs.readFileSync(filePath, 'utf-8');\n const parsed: unknown = JSON.parse(raw);\n if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n console.warn(`${WARN_PREFIX} Committee data file must contain a JSON object`);\n return undefined;\n }\n const obj = parsed as Record;\n const entry = obj[abbreviation];\n if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {\n return undefined;\n }\n const e = entry as Record;\n const docs = Array.isArray(e['documents'])\n ? (e['documents'] as unknown[])\n .filter(\n (d): d is Record =>\n typeof d === 'object' && d !== null && !Array.isArray(d)\n )\n .map((doc) => ({\n title: typeof doc['title'] === 'string' ? doc['title'] : 'Document',\n type: typeof doc['type'] === 'string' ? doc['type'] : 'Document',\n date: typeof doc['date'] === 'string' ? doc['date'] : '',\n }))\n : [];\n const result: CommitteeData = {\n name: typeof e['name'] === 'string' ? e['name'] : `${abbreviation} Committee`,\n abbreviation,\n chair: typeof e['chair'] === 'string' ? e['chair'] : 'N/A',\n members: typeof e['members'] === 'number' && Number.isFinite(e['members']) ? e['members'] : 0,\n documents: docs,\n effectiveness: typeof e['effectiveness'] === 'string' ? e['effectiveness'] : null,\n };\n console.log(\n `${INFO_PREFIX} Loaded committee data from file: ${result.name} (${docs.length} documents)`\n );\n return result;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} Failed to load committee data from file: ${message}`);\n return undefined;\n }\n}\n\n/**\n * Try to load committee data from the `EP_COMMITTEE_DATA_FILE` env var.\n * Returns the loaded {@link CommitteeData} when available, or `undefined` when\n * the env var is unset or the file does not contain an entry for the given\n * committee abbreviation. Logs a warning when the file exists but the entry\n * is missing so callers can fall through to an MCP fetch.\n *\n * @param abbreviation - Committee code (e.g. `\"ENVI\"`)\n * @returns Pre-fetched committee data or `undefined`\n */\nfunction tryLoadCommitteeDataFromEnv(abbreviation: string): CommitteeData | undefined {\n const filePath = process.env['EP_COMMITTEE_DATA_FILE'];\n if (!filePath) return undefined;\n const data = loadCommitteeDataFromFile(filePath, abbreviation);\n if (!data && fs.existsSync(filePath)) {\n console.warn(\n `${WARN_PREFIX} Committee data for ${abbreviation} not found in file — falling through to MCP fetch`\n );\n }\n return data;\n}\n\n// ─── EP v2 API direct fallback ──────────────────────────────────────────────\n\n/** Base URL for the EP Open Data Portal v2 API */\nconst EP_API_V2_BASE = 'https://data.europarl.europa.eu/api/v2';\n\n/** Timeout for direct EP API requests (ms) */\nconst EP_API_TIMEOUT_MS = 15_000;\n\n/**\n * Shape of a corporate body item from the EP Open Data Portal v2 API.\n * Represents the structure returned by `GET /corporate-bodies/{abbreviation}`.\n */\ninterface EPCorporateBodyItem {\n id?: string;\n label?: string;\n prefLabel?: Record;\n altLabel?: Record;\n classification?: string;\n inverse_isVersionOf?: string[];\n}\n\n/**\n * Fetch committee info directly from the EP v2 API as a fallback when MCP\n * returns placeholder data. Uses `GET /corporate-bodies/{abbreviation}` which\n * is the canonical lookup for a committee by its code (e.g. `ENVI`).\n *\n * This function is intentionally conservative: it primarily populates `name`\n * and `abbreviation`, and may populate `members` from `inverse_isVersionOf`\n * when available. Placeholder status is broken by changing `members` from `0`\n * (placeholder criteria is chair='N/A' AND members=0 AND docs=[]).\n *\n * @param abbreviation - Committee abbreviation (e.g. `\"ENVI\"`)\n * @param data - Existing committee data to enrich\n */\nexport async function fetchCommitteeInfoFromEPAPI(\n abbreviation: string,\n data: CommitteeData\n): Promise {\n const url = `${EP_API_V2_BASE}/corporate-bodies/${encodeURIComponent(abbreviation)}?format=application%2Fld%2Bjson`;\n try {\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), EP_API_TIMEOUT_MS);\n let response: Response;\n try {\n response = await fetch(url, {\n signal: controller.signal,\n headers: { Accept: 'application/ld+json' },\n });\n } finally {\n clearTimeout(timer);\n }\n if (!response.ok) {\n console.warn(\n `${WARN_PREFIX} EP API direct lookup for ${abbreviation} returned ${String(response.status)}`\n );\n return;\n }\n const body = (await response.json()) as { data?: EPCorporateBodyItem[] };\n const items = body.data;\n if (!Array.isArray(items) || items.length === 0) return;\n const item = items[0];\n if (!item) return;\n\n // Extract name: prefer English prefLabel, then English altLabel, then label\n const name = item.prefLabel?.['en'] ?? item.altLabel?.['en'] ?? item.label ?? undefined;\n if (name && name.length > 0) {\n data.name = name;\n }\n\n // Extract abbreviation: the label field holds the abbreviation code\n const abbr = item.label;\n if (abbr && abbr.length > 0 && !abbr.startsWith('org/')) {\n data.abbreviation = abbr;\n }\n\n console.log(` ✅ EP API fallback: ${data.name} (${data.abbreviation})`);\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n console.warn(`${WARN_PREFIX} EP API direct fallback failed for ${abbreviation}:`, message);\n }\n}\n\n/**\n * Check whether a single committee data entry is still in placeholder state.\n *\n * @param data - Committee data to inspect\n * @returns `true` when the entry matches all placeholder criteria\n */\nfunction isPlaceholderEntry(data: CommitteeData): boolean {\n return (\n data.chair === PLACEHOLDER_CHAIR &&\n data.members === PLACEHOLDER_MEMBERS &&\n data.documents.length === 0\n );\n}\n\n/**\n * Fetch committee data from three MCP sources for the given abbreviation.\n * Each source failure is caught individually so partial data is still returned.\n *\n * When the environment variable `EP_COMMITTEE_DATA_FILE` is set, pre-fetched\n * committee data is loaded from that JSON file instead of calling the MCP\n * client. This enables agentic workflows to inject real EP data.\n *\n * When MCP returns placeholder data (chair=N/A, members=0, docs=[]),\n * a direct call to the EP v2 API is attempted as a fallback to populate\n * at least the committee name and abbreviation.\n *\n * @param client - MCP client or null\n * @param abbreviation - Committee code (e.g. `\"ENVI\"`)\n * @returns Populated committee data\n */\nexport async function fetchCommitteeData(\n client: EuropeanParliamentMCPClient | null,\n abbreviation: string\n): Promise {\n const defaultResult: CommitteeData = {\n name: `${abbreviation} Committee`,\n abbreviation,\n chair: 'N/A',\n members: 0,\n documents: [],\n effectiveness: null,\n };\n\n // Check for pre-fetched committee data file (set by EP_COMMITTEE_DATA_FILE env var).\n // This mirrors the EP_FEED_DATA_FILE pattern for fetchEPFeedData.\n const fromFile = tryLoadCommitteeDataFromEnv(abbreviation);\n if (fromFile) return fromFile;\n\n if (!client) return defaultResult;\n\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching committee info for ${abbreviation}...`);\n const committeeResult = await callMCP(\n () => client.getCommitteeInfo({ abbreviation }),\n null,\n `getCommitteeInfo(${abbreviation})`\n );\n if (committeeResult) applyCommitteeInfo(committeeResult, defaultResult, abbreviation);\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n console.warn(`${WARN_PREFIX} getCommitteeInfo failed for ${abbreviation}:`, message);\n }\n\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching documents for ${abbreviation}...`);\n const docsResult = await callMCP(\n () => client.searchDocuments({ keyword: abbreviation, limit: 5 }),\n null,\n `searchDocuments(${abbreviation})`\n );\n if (docsResult) applyDocuments(docsResult, defaultResult);\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n console.warn(`${WARN_PREFIX} searchDocuments failed for ${abbreviation}:`, message);\n }\n\n try {\n const effectivenessResult = await callMCP(\n () =>\n client.analyzeLegislativeEffectiveness({\n subjectType: 'COMMITTEE',\n subjectId: abbreviation,\n }),\n null,\n `analyzeLegislativeEffectiveness(${abbreviation})`\n );\n if (effectivenessResult) applyEffectiveness(effectivenessResult, defaultResult);\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n console.warn(\n `${WARN_PREFIX} analyzeLegislativeEffectiveness failed for ${abbreviation}:`,\n message\n );\n }\n\n // Fallback: when MCP left the committee in placeholder state, try the EP v2\n // API directly. This provides resilience when the MCP server has issues\n // parsing committee data (see European-Parliament-MCP-Server#233).\n if (isPlaceholderEntry(defaultResult)) {\n console.log(\n `${INFO_PREFIX} Committee ${abbreviation} still placeholder after MCP — trying EP v2 API directly...`\n );\n await fetchCommitteeInfoFromEPAPI(abbreviation, defaultResult);\n }\n\n return defaultResult;\n}\n\n// ─── Motions fetches ─────────────────────────────────────────────────────────\n\n/**\n * Fetch recent voting records from MCP.\n *\n * @param client - MCP client or null\n * @param dateFromStr - Start date (YYYY-MM-DD)\n * @param dateStr - End date (YYYY-MM-DD)\n * @returns Array of voting records\n */\nexport async function fetchVotingRecords(\n client: EuropeanParliamentMCPClient | null,\n dateFromStr: string,\n dateStr: string\n): Promise {\n if (!client) return [];\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching voting records from MCP server...`);\n const votingResult = (await callMCP(\n () =>\n client.callTool('get_voting_records', {\n dateFrom: dateFromStr,\n dateTo: dateStr,\n limit: 20,\n }),\n undefined,\n 'get_voting_records'\n )) as MCPToolResult | undefined;\n\n if (votingResult?.content?.[0]) {\n const data = parseJSON<{\n records?: Array<{\n title?: string | undefined;\n date?: string | undefined;\n result?: string | undefined;\n votes?:\n | {\n for?: number | undefined;\n against?: number | undefined;\n abstain?: number | undefined;\n }\n | undefined;\n }>;\n }>(votingResult.content[0].text, 'voting records');\n\n if (data?.records && data.records.length > 0) {\n console.log(` ✅ Fetched ${data.records.length} voting records from MCP`);\n return data.records.map((r) => ({\n title: r.title ?? 'Parliamentary Vote',\n date: r.date ?? dateStr,\n result: r.result ?? 'Adopted',\n votes: {\n for: r.votes?.for ?? 0,\n against: r.votes?.against ?? 0,\n abstain: r.votes?.abstain ?? 0,\n },\n }));\n }\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} MCP voting records fetch failed:`, message);\n }\n return [];\n}\n\n/**\n * Fetch voting patterns from MCP.\n *\n * @param client - MCP client or null\n * @param dateFromStr - Start date\n * @param dateStr - End date\n * @returns Array of voting patterns\n */\nexport async function fetchVotingPatterns(\n client: EuropeanParliamentMCPClient | null,\n dateFromStr: string,\n dateStr: string\n): Promise {\n if (!client) return [];\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching voting patterns from MCP server...`);\n const patternsResult = (await callMCP(\n () =>\n client.callTool('analyze_voting_patterns', {\n dateFrom: dateFromStr,\n dateTo: dateStr,\n }),\n undefined,\n 'analyze_voting_patterns'\n )) as MCPToolResult | undefined;\n\n if (patternsResult?.content?.[0]) {\n const data = parseJSON<{\n patterns?:\n | Array<{\n group?: string | undefined;\n cohesion?: number | undefined;\n participation?: number | undefined;\n }>\n | undefined;\n }>(patternsResult.content[0].text, 'voting patterns');\n\n if (data?.patterns && data.patterns.length > 0) {\n console.log(` ✅ Fetched ${data.patterns.length} voting patterns from MCP`);\n return data.patterns.map((p) => ({\n group: p.group ?? 'Unknown Group',\n cohesion: p.cohesion ?? 0,\n participation: p.participation ?? 0,\n }));\n }\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} MCP voting patterns fetch failed:`, message);\n }\n return [];\n}\n\n/**\n * Fetch voting anomalies for a date range from MCP.\n *\n * @param client - MCP client or null\n * @param dateFromStr - Start date\n * @param dateStr - End date\n * @returns Array of voting anomalies\n */\nexport async function fetchMotionsAnomalies(\n client: EuropeanParliamentMCPClient | null,\n dateFromStr: string,\n dateStr: string\n): Promise {\n if (!client) return [];\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching voting anomalies from MCP server...`);\n const anomaliesResult = (await callMCP(\n () =>\n client.callTool('detect_voting_anomalies', {\n dateFrom: dateFromStr,\n dateTo: dateStr,\n }),\n undefined,\n 'detect_voting_anomalies'\n )) as MCPToolResult | undefined;\n\n if (anomaliesResult?.content?.[0]) {\n const data = parseJSON<{\n anomalies?:\n | Array<{\n type?: string | undefined;\n description?: string | undefined;\n severity?: string | undefined;\n }>\n | undefined;\n }>(anomaliesResult.content[0].text, 'voting anomalies');\n\n if (data?.anomalies && data.anomalies.length > 0) {\n console.log(` ✅ Fetched ${data.anomalies.length} voting anomalies from MCP`);\n return data.anomalies.map((a) => ({\n type: a.type ?? 'Unusual Pattern',\n description: a.description ?? 'No description available',\n severity: a.severity ?? 'MEDIUM',\n }));\n }\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} MCP voting anomalies fetch failed:`, message);\n }\n return [];\n}\n\n/**\n * Fetch parliamentary questions from MCP for the given date range.\n *\n * @param client - MCP client or null\n * @param dateFromStr - Start date\n * @param dateStr - End date\n * @returns Array of parliamentary questions\n */\nexport async function fetchParliamentaryQuestionsForMotions(\n client: EuropeanParliamentMCPClient | null,\n dateFromStr: string,\n dateStr: string\n): Promise {\n if (!client) return [];\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching parliamentary questions from MCP server...`);\n const questionsResult = await callMCP(\n () =>\n client.getParliamentaryQuestions({\n dateFrom: dateFromStr,\n dateTo: dateStr,\n limit: 10,\n }),\n undefined,\n 'get_parliamentary_questions'\n );\n\n if (questionsResult?.content?.[0]) {\n const data = parseJSON<{\n questions?: Array<{\n author?: string | undefined;\n topic?: string | undefined;\n subject?: string | undefined;\n date?: string | undefined;\n status?: string | undefined;\n }>;\n }>(questionsResult.content[0].text, 'parliamentary questions');\n\n if (data?.questions && data.questions.length > 0) {\n console.log(` ✅ Fetched ${data.questions.length} parliamentary questions from MCP`);\n return data.questions.map((q) => ({\n author: q.author ?? 'Unknown MEP',\n topic: q.topic ?? q.subject ?? 'General inquiry',\n date: q.date ?? dateStr,\n status: q.status ?? 'PENDING',\n }));\n }\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} MCP parliamentary questions fetch failed:`, message);\n }\n return [];\n}\n\n/**\n * Fetch all motions data in parallel, applying fallback arrays for any\n * section where MCP returned nothing.\n *\n * @param client - MCP client or null\n * @param dateFromStr - Start date\n * @param dateStr - End date\n * @returns All motions data with fallbacks applied\n */\nexport async function fetchMotionsData(\n client: EuropeanParliamentMCPClient | null,\n dateFromStr: string,\n dateStr: string\n): Promise<{\n votingRecords: VotingRecord[];\n votingPatterns: VotingPattern[];\n anomalies: VotingAnomaly[];\n questions: MotionsQuestion[];\n}> {\n const [votingRecordsResult, votingPatternsResult, anomaliesResult, questionsResult] =\n await Promise.allSettled([\n fetchVotingRecords(client, dateFromStr, dateStr),\n fetchVotingPatterns(client, dateFromStr, dateStr),\n fetchMotionsAnomalies(client, dateFromStr, dateStr),\n fetchParliamentaryQuestionsForMotions(client, dateFromStr, dateStr),\n ]);\n\n let votingRecords: VotingRecord[] =\n votingRecordsResult.status === 'fulfilled' ? votingRecordsResult.value : [];\n if (votingRecordsResult.status === 'rejected') {\n console.warn(`${WARN_PREFIX} Failed to fetch voting records from MCP`);\n }\n\n let votingPatterns: VotingPattern[] =\n votingPatternsResult.status === 'fulfilled' ? votingPatternsResult.value : [];\n if (votingPatternsResult.status === 'rejected') {\n console.warn(`${WARN_PREFIX} Failed to fetch voting patterns from MCP`);\n }\n\n let anomalies: VotingAnomaly[] =\n anomaliesResult.status === 'fulfilled' ? anomaliesResult.value : [];\n if (anomaliesResult.status === 'rejected') {\n console.warn(`${WARN_PREFIX} Failed to fetch voting anomalies from MCP`);\n }\n\n let questions: MotionsQuestion[] =\n questionsResult.status === 'fulfilled' ? questionsResult.value : [];\n if (questionsResult.status === 'rejected') {\n console.warn(`${WARN_PREFIX} Failed to fetch parliamentary questions from MCP`);\n }\n\n const fallback = getMotionsFallbackData(dateStr, dateFromStr);\n\n if (votingRecords.length === 0) {\n console.log(`${INFO_PREFIX} Using placeholder voting records`);\n votingRecords = fallback.votingRecords;\n }\n if (votingPatterns.length === 0) {\n console.log(`${INFO_PREFIX} Using placeholder voting patterns`);\n votingPatterns = fallback.votingPatterns;\n }\n if (anomalies.length === 0) {\n console.log(`${INFO_PREFIX} Using placeholder voting anomalies`);\n anomalies = fallback.anomalies;\n }\n if (questions.length === 0) {\n console.log(`${INFO_PREFIX} Using placeholder parliamentary questions`);\n questions = fallback.questions;\n }\n\n return { votingRecords, votingPatterns, anomalies, questions };\n}\n\n// ─── Propositions fetches ─────────────────────────────────────────────────────\n\n/**\n * Fetch legislative proposals from MCP and build pre-sanitised HTML.\n *\n * @param client - MCP client or null\n * @returns Proposals HTML and the first procedure ID found (if any)\n */\nexport async function fetchProposalsFromMCP(\n client: EuropeanParliamentMCPClient | null\n): Promise<{ html: string; firstProcedureId: string }> {\n if (!client) return { html: '', firstProcedureId: '' };\n\n const docsResult = await callMCP(\n () => client.searchDocuments({ keyword: 'legislative proposal', limit: 10 }),\n undefined,\n 'search_documents(proposals)'\n );\n if (!docsResult?.content?.[0]) return { html: '', firstProcedureId: '' };\n\n const data = parseJSON<{ documents?: Array> }>(\n docsResult.content[0].text,\n 'proposals'\n );\n if (!data?.documents?.length) return { html: '', firstProcedureId: '' };\n\n console.log(` ✅ Fetched ${data.documents.length} proposals from MCP`);\n\n const firstProcedureId =\n data.documents.find((d) => /\\d{4}\\/\\d+\\(.+\\)/.test(d.id ?? ''))?.id ?? '';\n\n const html = data.documents\n .map(\n (doc) => `\n
    \n

    ${escapeHTML(doc.title ?? 'Legislative Proposal')}

    \n
    \n ${doc.id ? `${escapeHTML(doc.id)}` : ''}\n ${doc.date ? `${escapeHTML(doc.date)}` : ''}\n ${doc.status ? `${escapeHTML(doc.status)}` : ''}\n
    \n ${doc.committee ? `

    ${escapeHTML(doc.committee)}

    ` : ''}\n ${doc.rapporteur ? `

    ${escapeHTML(doc.rapporteur)}

    ` : ''}\n
    `\n )\n .join('');\n\n return { html, firstProcedureId };\n}\n\n/**\n * Fetch active legislative pipeline data from MCP.\n *\n * @param client - MCP client or null\n * @returns Structured pipeline data or null when unavailable\n */\nexport async function fetchPipelineFromMCP(\n client: EuropeanParliamentMCPClient | null\n): Promise {\n if (!client) return null;\n\n const pipelineResult = await callMCP(\n () => client.monitorLegislativePipeline({ status: 'ACTIVE', limit: 5 }),\n undefined,\n 'monitor_legislative_pipeline'\n );\n if (!pipelineResult?.content?.[0]) return null;\n\n const pipeData = parseJSON<{\n pipelineHealthScore?: number | undefined;\n throughputRate?: number | undefined;\n procedures?:\n | Array<{\n id?: string | undefined;\n title?: string | undefined;\n stage?: string | undefined;\n }>\n | undefined;\n }>(pipelineResult.content[0].text, 'pipeline');\n\n if (!pipeData) return null;\n\n const healthScore = pipeData.pipelineHealthScore ?? 0;\n const throughput = pipeData.throughputRate ?? 0;\n const procRowsHtml =\n pipeData.procedures\n ?.map(\n (proc) => `\n
    \n ${proc.id ? `${escapeHTML(proc.id)}` : ''}\n ${proc.title ? `${escapeHTML(proc.title)}` : ''}\n ${proc.stage ? `${escapeHTML(proc.stage)}` : ''}\n
    `\n )\n .join('') ?? '';\n\n return { healthScore, throughput, procRowsHtml };\n}\n\n/**\n * Fetch a specific procedure's tracked-status HTML from MCP.\n * Returns empty string when `procedureId` is empty or MCP is unavailable.\n *\n * @param client - MCP client or null\n * @param procedureId - Procedure ID (e.g. `\"2024/0001(COD)\"`)\n * @returns HTML snippet for the procedure status section\n */\nexport async function fetchProcedureStatusFromMCP(\n client: EuropeanParliamentMCPClient | null,\n procedureId: string\n): Promise {\n if (!procedureId || !client) return '';\n try {\n const result = await callMCP(\n () => client.trackLegislation(procedureId),\n undefined,\n `track_legislation(${procedureId})`\n );\n if (!result?.content?.[0]) return '';\n const raw = result.content[0].text;\n return `
    ${escapeHTML(raw.slice(0, 2000))}
    `;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} track_legislation failed:`, message);\n return '';\n }\n}\n\n// ─── EP Feed-based fetches (Breaking News) ──────────────────────────────────\n\n/**\n * Ordered fallback chain for feed timeframes.\n * When a narrow timeframe returns empty/404 (common during recess), we widen\n * the window to retrieve at least *some* recent data for analysis.\n */\nconst TIMEFRAME_FALLBACK_CHAIN: ReadonlyMap = new Map<\n FeedTimeframe,\n FeedTimeframe | undefined\n>([\n ['today', 'one-day'],\n ['one-day', 'one-week'],\n ['one-week', 'one-month'],\n ['one-month', undefined],\n ['custom', undefined],\n]);\n\n/**\n * Get the next wider timeframe for fallback, or `undefined` if no fallback exists.\n *\n * @param current - Current timeframe\n * @returns Next wider timeframe, or undefined when at widest\n */\nfunction getWiderTimeframe(current: FeedTimeframe): FeedTimeframe | undefined {\n return TIMEFRAME_FALLBACK_CHAIN.get(current);\n}\n\n/**\n * Error thrown when the EP MCP server returns a timeout envelope instead of data.\n * This is distinct from network-level timeouts — the MCP server responds successfully\n * but reports that the upstream EP API did not respond in time.\n */\nclass UpstreamTimeoutError extends Error {\n constructor(toolName: string) {\n super(`EP MCP upstream timeout for ${toolName} — data may be incomplete`);\n this.name = 'UpstreamTimeoutError';\n }\n}\n\n/**\n * Error thrown when the EP MCP server returns a response indicating the feed\n * is unavailable (uniform `{status:\"unavailable\"}` envelope or the legacy raw\n * upstream 404 envelope historically emitted pre-v1.2.10). Distinct from\n * {@link UpstreamTimeoutError} so logs/diagnostics do not misattribute a\n * 404/unavailable response to a timeout. Shares the same control-flow role —\n * callers treat it as \"stop the timeframe-widening retry loop and return the\n * empty sentinel\".\n */\nclass FeedUnavailableError extends Error {\n constructor(toolName: string) {\n super(`EP MCP feed unavailable for ${toolName} — treating as known-empty`);\n this.name = 'FeedUnavailableError';\n }\n}\n\n/**\n * Type guard: returns `true` for either error type that should stop the\n * timeframe-widening retry loop ({@link UpstreamTimeoutError} or\n * {@link FeedUnavailableError}).\n *\n * @param error - Caught error value\n * @returns `true` when the caller should stop retrying and return the empty sentinel\n */\nfunction isStopRetryError(error: unknown): boolean {\n return error instanceof UpstreamTimeoutError || error instanceof FeedUnavailableError;\n}\n\n/**\n * Check whether a parsed MCP response envelope indicates an upstream timeout\n * and throw {@link UpstreamTimeoutError} if so. The EP MCP server returns\n * `{ timedOut: true, status: \"timeout\" }` when the upstream EP API did not\n * respond within the configured timeout window. Throwing ensures callers\n * stop timeframe-widening retry loops instead of treating the empty `data: []`\n * as \"no data\".\n *\n * @param value - Parsed response value (may be an object envelope or a bare array)\n * @throws {UpstreamTimeoutError} when the response indicates an upstream timeout\n */\nfunction checkUpstreamTimeout(value: unknown): void {\n if (typeof value !== 'object' || value === null) return;\n const envelope = value as Record;\n if (envelope['timedOut'] === true || envelope['status'] === 'timeout') {\n const toolName = envelope['toolName'] ? String(envelope['toolName']) : 'unknown';\n console.warn(\n `${WARN_PREFIX} EP MCP upstream timeout for ${toolName} — data may be incomplete. ` +\n 'Consider using year-based endpoints as fallback.'\n );\n throw new UpstreamTimeoutError(toolName);\n }\n // Defensive detection of the legacy raw upstream 404 shape that pre-v1.2.10\n // get_events_feed / get_procedures_feed emitted\n // (Hack23/European-Parliament-MCP-Server#378, closed by PR #380 in\n // v1.2.10). Shape:\n // {\"@id\":\"https://data.europarl.europa.eu/eli/dl/...\", \"error\":\"404 N...\"}\n // Treated identically to the uniform `{status:\"unavailable\"}` envelope —\n // i.e. stop timeframe-widening retry loops instead of silently returning [].\n // Retained as belt-and-braces so older pinned server versions (or any future\n // regression) do not bypass the NOT_FOUND bookkeeping done by the EP MCP\n // client's safeCallTool.\n const idField = envelope['@id'];\n const errorField = envelope['error'];\n if (\n typeof idField === 'string' &&\n idField.startsWith('https://data.europarl.europa.eu/') &&\n typeof errorField === 'string' &&\n errorField.includes('404')\n ) {\n console.warn(\n `${WARN_PREFIX} EP MCP returned raw upstream 404 shape — treating feed as unavailable ` +\n '(upstream #378). This should have been caught earlier as a NOT_FOUND failure.'\n );\n throw new FeedUnavailableError('raw_404_envelope');\n }\n}\n\n/**\n * Handle errors from feed-fetching functions with timeframe-widening logic.\n * Encapsulates the common catch-block pattern: upstream timeouts return `undefined`\n * (caller should stop retrying), errors whose message contains '404' or 'timed out'\n * widen to the next timeframe, and other errors log and return `undefined`.\n *\n * @param error - Caught error\n * @param tf - Current feed timeframe\n * @param toolName - Feed tool name for log messages\n * @returns A wider {@link FeedTimeframe} to retry, or `undefined` to stop\n */\nfunction handleFeedFetchError(\n error: unknown,\n tf: FeedTimeframe,\n toolName: string\n): FeedTimeframe | undefined {\n if (isStopRetryError(error)) return undefined;\n const message = error instanceof Error ? error.message : String(error);\n const wider = getWiderTimeframe(tf);\n if (wider && (message.includes('404') || message.includes('timed out'))) {\n console.warn(`${WARN_PREFIX} ${toolName} failed (${tf}): ${message} — retrying with ${wider}`);\n return wider;\n }\n console.warn(`${WARN_PREFIX} ${toolName} failed:`, message);\n return undefined;\n}\n\n/**\n * Parse a feed result from MCP into a flat array of items.\n * EP API v2 feeds return items under the `data` key:\n * `{ data: [{ id, type, work_type, identifier, label }], \"@context\": [...] }`\n *\n * Also handles legacy shapes (`feed`, `entries`, `items`) and bare arrays.\n * Throws {@link UpstreamTimeoutError} when the MCP server reports an upstream\n * timeout (`{ timedOut: true, status: \"timeout\" }`), so callers can stop\n * timeframe-widening loops instead of treating the empty `data: []` as \"no data\".\n *\n * @param result - Raw MCP tool result\n * @returns Array of parsed feed entry objects (may be empty)\n * @throws {UpstreamTimeoutError} when the response indicates an upstream timeout\n */\nfunction parseFeedResult(result: MCPToolResult | undefined): Record[] {\n if (!result?.content?.[0]?.text) return [];\n const parsed = parseJSON(result.content[0].text, 'feed');\n if (!parsed) return [];\n checkUpstreamTimeout(parsed);\n const envelope = parsed as Record;\n // EP API v2 feeds use `data` key; also check legacy shapes\n const candidates = [\n envelope['data'],\n envelope['feed'],\n envelope['entries'],\n envelope['items'],\n parsed,\n ];\n for (const candidate of candidates) {\n if (Array.isArray(candidate)) return candidate as Record[];\n }\n return [];\n}\n\n/**\n * Parse an EP API v2 feed response envelope in a single JSON parse, returning\n * both the array of feed items and the API-reported total count.\n * Avoids parsing the same JSON payload twice when both values are needed.\n * Throws {@link UpstreamTimeoutError} when the MCP server reports an upstream\n * timeout (`{ timedOut: true, status: \"timeout\" }`), so callers can stop\n * timeframe-widening loops instead of treating the empty `data: []` as \"no data\".\n *\n * @param result - Raw MCP tool result\n * @returns Object with `items` array and `total` count from the API\n * @throws {UpstreamTimeoutError} when the response indicates an upstream timeout\n */\nfunction parseFeedEnvelope(result: MCPToolResult | undefined): {\n items: Record[];\n total: number;\n} {\n if (!result?.content?.[0]?.text) return { items: [], total: 0 };\n const parsed = parseJSON(result.content[0].text, 'feed');\n if (!parsed || typeof parsed !== 'object') return { items: [], total: 0 };\n checkUpstreamTimeout(parsed);\n const envelope = parsed as Record;\n const total = typeof envelope['total'] === 'number' ? envelope['total'] : 0;\n const candidates = [\n envelope['data'],\n envelope['feed'],\n envelope['entries'],\n envelope['items'],\n parsed,\n ];\n for (const candidate of candidates) {\n if (Array.isArray(candidate)) return { items: candidate as Record[], total };\n }\n return { items: [], total };\n}\n\n/**\n * Map a raw EP API v2 feed item to a normalized feed item.\n * EP feeds return `{ id, type, work_type, identifier, label }` — we normalize\n * these into the domain feed item shape, using `label` as `title` when no title exists.\n *\n * @param item - Raw feed item record\n * @returns Common feed item fields\n */\nfunction mapFeedItemBase(item: Record): {\n id: string;\n title: string;\n date: string;\n type?: string | undefined;\n url?: string | undefined;\n identifier?: string | undefined;\n label?: string | undefined;\n} {\n return {\n id: String(item['id'] ?? item['docId'] ?? ''),\n title: String(\n item['title'] ?? item['label'] ?? item['name'] ?? item['identifier'] ?? 'Untitled'\n ),\n date: String(item['date'] ?? item['published'] ?? item['updated'] ?? ''),\n type: item['type']\n ? String(item['type'])\n : item['work_type']\n ? String(item['work_type'])\n : undefined,\n url: item['url'] ? String(item['url']) : undefined,\n identifier: item['identifier'] ? String(item['identifier']) : undefined,\n label: item['label'] ? String(item['label']) : undefined,\n };\n}\n\n/**\n * Fetch adopted texts feed from MCP.\n * Falls back to a wider timeframe when the initial timeframe returns no data.\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @returns Array of adopted text feed items\n */\nexport async function fetchAdoptedTextsFeed(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week'\n): Promise {\n if (!client) return [];\n let currentTimeframe: FeedTimeframe | undefined = timeframe;\n while (currentTimeframe) {\n const tf: FeedTimeframe = currentTimeframe;\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching adopted texts feed (${currentTimeframe})...`);\n const result = await callMCP(\n () => client.getAdoptedTextsFeed({ timeframe: tf, limit: 20 }),\n undefined,\n 'get_adopted_texts_feed'\n );\n const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));\n if (items.length > 0 || !getWiderTimeframe(currentTimeframe)) return items;\n console.log(\n `${INFO_PREFIX} adopted texts feed empty for ${currentTimeframe}, widening timeframe...`\n );\n currentTimeframe = getWiderTimeframe(currentTimeframe);\n } catch (error) {\n const wider = handleFeedFetchError(error, tf, 'get_adopted_texts_feed');\n if (wider) {\n currentTimeframe = wider;\n } else {\n return [];\n }\n }\n }\n return [];\n}\n\n/**\n * Fetch events feed from MCP.\n * Falls back to a wider timeframe when the initial timeframe returns no data\n * (common during parliamentary recess when the EP API returns 404 for narrow windows).\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @returns Array of event feed items\n */\nexport async function fetchEventsFeed(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week'\n): Promise {\n if (!client) return [];\n let currentTimeframe: FeedTimeframe | undefined = timeframe;\n while (currentTimeframe) {\n const tf: FeedTimeframe = currentTimeframe;\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching events feed (${currentTimeframe})...`);\n const result = await callMCP(\n () => client.getEventsFeed({ timeframe: tf, limit: 20 }),\n undefined,\n 'get_events_feed'\n );\n const items = parseFeedResult(result).map((item) => ({\n ...mapFeedItemBase(item),\n location: item['location'] ? String(item['location']) : undefined,\n }));\n if (items.length > 0 || !getWiderTimeframe(currentTimeframe)) return items;\n console.log(\n `${INFO_PREFIX} events feed empty for ${currentTimeframe}, widening timeframe...`\n );\n currentTimeframe = getWiderTimeframe(currentTimeframe);\n } catch (error) {\n const wider = handleFeedFetchError(error, tf, 'get_events_feed');\n if (wider) {\n currentTimeframe = wider;\n } else {\n return [];\n }\n }\n }\n return [];\n}\n\n/**\n * Fetch procedures feed from MCP.\n * Falls back to a wider timeframe when the initial timeframe returns no data.\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @returns Array of procedure feed items\n */\nexport async function fetchProceduresFeed(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week'\n): Promise {\n if (!client) return [];\n let currentTimeframe: FeedTimeframe | undefined = timeframe;\n while (currentTimeframe) {\n const tf: FeedTimeframe = currentTimeframe;\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching procedures feed (${currentTimeframe})...`);\n const result = await callMCP(\n () => client.getProceduresFeed({ timeframe: tf, limit: 20 }),\n undefined,\n 'get_procedures_feed'\n );\n const items = parseFeedResult(result).map((item) => ({\n ...mapFeedItemBase(item),\n stage: item['stage'] ? String(item['stage']) : undefined,\n }));\n if (items.length > 0 || !getWiderTimeframe(currentTimeframe)) return items;\n console.log(\n `${INFO_PREFIX} procedures feed empty for ${currentTimeframe}, widening timeframe...`\n );\n currentTimeframe = getWiderTimeframe(currentTimeframe);\n } catch (error) {\n const wider = handleFeedFetchError(error, tf, 'get_procedures_feed');\n if (wider) {\n currentTimeframe = wider;\n } else {\n return [];\n }\n }\n }\n return [];\n}\n\n/**\n * Fetch MEPs feed from MCP.\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @returns Array of MEP feed items\n */\nexport async function fetchMEPsFeed(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week'\n): Promise {\n return (await fetchMEPsFeedWithTotal(client, timeframe)).items;\n}\n\n/**\n * Fetch MEPs feed from MCP, returning both items and the API's reported total count.\n * The `total` from the API response reflects all matching records in the feed,\n * which may exceed the `limit` parameter (currently capped at 100 per request).\n *\n * The limit is set to 100 (the EP API maximum) so the fetched sample is large\n * enough to populate a meaningful truncation note (\"showing 10 of N\") while\n * keeping each request bounded. When the feed contains more than 100 MEP\n * updates, the `total` field in the API response carries the true count.\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @returns Object with `items` array and `total` count from the API\n */\nexport async function fetchMEPsFeedWithTotal(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week'\n): Promise<{ items: MEPFeedItem[]; total: number }> {\n if (!client) return { items: [], total: 0 };\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching MEPs feed (${timeframe})...`);\n const result = await callMCP(\n () => client.getMEPsFeed({ timeframe, limit: 100 }),\n undefined,\n 'get_meps_feed'\n );\n const { items: rawItems, total } = parseFeedEnvelope(result);\n const items = rawItems.map((item) => ({\n id: String(item['id'] ?? item['mepId'] ?? ''),\n name: String(item['name'] ?? item['label'] ?? item['title'] ?? 'Unknown'),\n date: String(item['date'] ?? item['published'] ?? item['updated'] ?? ''),\n country: item['country'] ? String(item['country']) : undefined,\n group: item['group'] ? String(item['group']) : undefined,\n url: item['url'] ? String(item['url']) : undefined,\n identifier: item['identifier'] ? String(item['identifier']) : undefined,\n label: item['label'] ? String(item['label']) : undefined,\n }));\n return { items, total };\n } catch (error) {\n if (isStopRetryError(error)) return { items: [], total: 0 };\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} get_meps_feed failed:`, message);\n return { items: [], total: 0 };\n }\n}\n\n/**\n * Fetch a fixed-window EP API v2 feed that ignores the `timeframe` parameter.\n *\n * The EP MCP server splits feed tools into two groups — sliding-window feeds\n * accept `timeframe`/`startDate`, fixed-window feeds (documents,\n * plenary_documents, committee_documents, plenary_session_documents,\n * parliamentary_questions, corporate_bodies, controlled_vocabularies) serve a\n * server-defined window. As of v1.2.10 the server silently ignores\n * `timeframe`/`startDate` on fixed-window tools\n * (Hack23/European-Parliament-MCP-Server#379); pre-v1.2.10 it rejected them\n * with `INVALID_PARAMS` (#377). This helper issues a single RPC either way —\n * there is no point in timeframe-widening retry loops because the server does\n * not narrow/widen results based on timeframe.\n *\n * @param client - MCP client (null returns `[]`)\n * @param toolName - Tool name for log messages\n * @param callFn - Callback that issues the feed RPC\n * @returns Array of mapped feed items (may be empty)\n */\nasync function fetchFixedWindowFeed(\n client: EuropeanParliamentMCPClient | null,\n toolName: string,\n callFn: () => Promise\n): Promise<\n {\n id: string;\n title: string;\n date: string;\n type?: string | undefined;\n url?: string | undefined;\n identifier?: string | undefined;\n label?: string | undefined;\n }[]\n> {\n if (!client) return [];\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching ${toolName}...`);\n const result = await callMCP(callFn, undefined, toolName);\n return parseFeedResult(result).map((item) => mapFeedItemBase(item));\n } catch (error) {\n if (isStopRetryError(error)) return [];\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} ${toolName} failed:`, message);\n return [];\n }\n}\n\n/**\n * Fetch documents feed from MCP.\n * The underlying EP MCP `get_documents_feed` tool serves a server-defined\n * fixed window and ignores any `timeframe` parameter; the parameter is kept\n * on this function's signature for backwards compatibility with callers.\n *\n * @param client - MCP client or null\n * @param _timeframe - Retained for signature compatibility (ignored by the server)\n * @returns Array of document feed items\n */\nexport async function fetchDocumentsFeed(\n client: EuropeanParliamentMCPClient | null,\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _timeframe: FeedTimeframe = 'one-week'\n): Promise {\n return fetchFixedWindowFeed(client, 'get_documents_feed', () =>\n client!.getDocumentsFeed({ limit: 20 })\n );\n}\n\n/**\n * Fetch plenary documents feed from MCP.\n * Fixed-window feed; `timeframe` is ignored by the server.\n *\n * @param client - MCP client or null\n * @param _timeframe - Retained for signature compatibility (ignored by the server)\n * @returns Array of document feed items\n */\nexport async function fetchPlenaryDocumentsFeed(\n client: EuropeanParliamentMCPClient | null,\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _timeframe: FeedTimeframe = 'one-week'\n): Promise {\n return fetchFixedWindowFeed(client, 'get_plenary_documents_feed', () =>\n client!.getPlenaryDocumentsFeed({ limit: 20 })\n );\n}\n\n/**\n * Fetch committee documents feed from MCP.\n * Fixed-window feed; `timeframe` is ignored by the server.\n *\n * @param client - MCP client or null\n * @param _timeframe - Retained for signature compatibility (ignored by the server)\n * @returns Array of document feed items\n */\nexport async function fetchCommitteeDocumentsFeed(\n client: EuropeanParliamentMCPClient | null,\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _timeframe: FeedTimeframe = 'one-week'\n): Promise {\n return fetchFixedWindowFeed(client, 'get_committee_documents_feed', () =>\n client!.getCommitteeDocumentsFeed({ limit: 20 })\n );\n}\n\n/**\n * Fetch plenary session documents feed from MCP.\n * Fixed-window feed; `timeframe` is ignored by the server.\n *\n * @param client - MCP client or null\n * @param _timeframe - Retained for signature compatibility (ignored by the server)\n * @returns Array of document feed items\n */\nexport async function fetchPlenarySessionDocumentsFeed(\n client: EuropeanParliamentMCPClient | null,\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _timeframe: FeedTimeframe = 'one-week'\n): Promise {\n return fetchFixedWindowFeed(client, 'get_plenary_session_documents_feed', () =>\n client!.getPlenarySessionDocumentsFeed({ limit: 20 })\n );\n}\n\n/**\n * Fetch external documents feed from MCP.\n * Falls back to a wider timeframe when the initial timeframe returns no data.\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @returns Array of document feed items\n */\nexport async function fetchExternalDocumentsFeed(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week'\n): Promise {\n if (!client) return [];\n let currentTimeframe: FeedTimeframe | undefined = timeframe;\n while (currentTimeframe) {\n const tf: FeedTimeframe = currentTimeframe;\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching external documents feed (${currentTimeframe})...`);\n const result = await callMCP(\n () => client.getExternalDocumentsFeed({ timeframe: tf, limit: 20 }),\n undefined,\n 'get_external_documents_feed'\n );\n const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));\n if (items.length > 0 || !getWiderTimeframe(currentTimeframe)) return items;\n console.log(\n `${INFO_PREFIX} external documents feed empty for ${currentTimeframe}, widening timeframe...`\n );\n currentTimeframe = getWiderTimeframe(currentTimeframe);\n } catch (error) {\n const wider = handleFeedFetchError(error, tf, 'get_external_documents_feed');\n if (wider) {\n currentTimeframe = wider;\n } else {\n return [];\n }\n }\n }\n return [];\n}\n\n/**\n * Fetch parliamentary questions feed from MCP.\n * Fixed-window feed; `timeframe` is ignored by the server.\n *\n * @param client - MCP client or null\n * @param _timeframe - Retained for signature compatibility (ignored by the server)\n * @returns Array of question feed items\n */\nexport async function fetchQuestionsFeed(\n client: EuropeanParliamentMCPClient | null,\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _timeframe: FeedTimeframe = 'one-week'\n): Promise {\n return fetchFixedWindowFeed(client, 'get_parliamentary_questions_feed', () =>\n client!.getParliamentaryQuestionsFeed({ limit: 20 })\n );\n}\n\n/**\n * Fetch MEP declarations feed from MCP.\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @returns Array of declaration feed items\n */\nexport async function fetchDeclarationsFeed(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week'\n): Promise {\n if (!client) return [];\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching MEP declarations feed (${timeframe})...`);\n const result = await callMCP(\n () => client.getMEPDeclarationsFeed({ timeframe, limit: 20 }),\n undefined,\n 'get_mep_declarations_feed'\n );\n return parseFeedResult(result).map((item) => mapFeedItemBase(item));\n } catch (error) {\n if (isStopRetryError(error)) return [];\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} get_mep_declarations_feed failed:`, message);\n return [];\n }\n}\n\n/**\n * Fetch corporate bodies feed from MCP.\n *\n * `_timeframe` is retained only for signature compatibility with sliding-window\n * fetchers (so the shared `fetchEPFeedData` orchestrator can dispatch uniformly);\n * the EP MCP server serves a server-defined fixed window for this feed and\n * ignores any timeframe input (as of v1.2.10; pre-v1.2.10 it rejected with\n * `INVALID_PARAMS` — see Hack23/European-Parliament-MCP-Server#377).\n *\n * @param client - MCP client or null\n * @param _timeframe - Ignored by the server; kept for signature compatibility\n * @returns Array of corporate body feed items\n */\nexport async function fetchCorporateBodiesFeed(\n client: EuropeanParliamentMCPClient | null,\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _timeframe: FeedTimeframe = 'one-week'\n): Promise {\n if (!client) return [];\n try {\n console.log(`${MCP_FETCH_PREFIX} Fetching corporate bodies feed (fixed window)...`);\n const result = await callMCP(\n () => client.getCorporateBodiesFeed({ limit: 20 }),\n undefined,\n 'get_corporate_bodies_feed'\n );\n return parseFeedResult(result).map((item) => mapFeedItemBase(item));\n } catch (error) {\n if (isStopRetryError(error)) return [];\n const message = error instanceof Error ? error.message : String(error);\n console.warn(`${WARN_PREFIX} get_corporate_bodies_feed failed:`, message);\n return [];\n }\n}\n\n/**\n * Fetch all EP feed data for breaking news articles.\n * Calls adopted texts, events, procedures, and MEPs feeds in parallel.\n * Returns `undefined` when client is null (MCP unavailable).\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @returns Aggregated feed data for breaking news, or undefined when client is null\n */\nexport async function fetchBreakingNewsFeedData(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week'\n): Promise {\n if (!client) return undefined;\n if (!mcpCircuitBreaker.canRequest()) {\n console.warn(\n `${WARN_PREFIX} Circuit breaker OPEN — treating as MCP unavailable for breaking news feeds`\n );\n return undefined;\n }\n const [adoptedTexts, events, procedures, mepFeedResult] = await Promise.all([\n fetchAdoptedTextsFeed(client, timeframe),\n fetchEventsFeed(client, timeframe),\n fetchProceduresFeed(client, timeframe),\n fetchMEPsFeedWithTotal(client, timeframe),\n ]);\n const { items: mepUpdates, total: totalMEPUpdates } = mepFeedResult;\n return {\n adoptedTexts,\n events,\n procedures,\n mepUpdates,\n totalMEPUpdates: totalMEPUpdates > 0 ? totalMEPUpdates : undefined,\n };\n}\n\n/**\n * Fetch comprehensive EP feed data from all 12 feed endpoints in parallel.\n * This is the primary data source for all article strategies.\n *\n * @param client - MCP client or null\n * @param timeframe - How far back to look (default: 'one-week')\n * @param dateRange - Optional inclusive UTC window for filtering feed items\n * @returns Full EPFeedData or undefined when client is null\n */\nexport async function fetchEPFeedData(\n client: EuropeanParliamentMCPClient | null,\n timeframe: FeedTimeframe = 'one-week',\n dateRange?: DateRange\n): Promise {\n // Check for pre-fetched feed data file (set by --feed-data CLI arg).\n // This allows agentic workflows to pass MCP data fetched via framework tools\n // into the generator without requiring a direct MCP connection.\n const feedDataFile = process.env['EP_FEED_DATA_FILE'];\n if (feedDataFile) {\n const fileData = loadEPFeedDataFromFile(feedDataFile, dateRange);\n if (fileData) return fileData;\n console.log(\n `${WARN_PREFIX} Pre-fetched EP feed data failed to load — falling through to MCP fetch`\n );\n }\n if (!client) return undefined;\n if (!mcpCircuitBreaker.canRequest()) {\n console.warn(`${WARN_PREFIX} Circuit breaker OPEN — treating as MCP unavailable for EP feeds`);\n return undefined;\n }\n console.log(`${MCP_FETCH_PREFIX} Fetching comprehensive EP feed data (${timeframe})...`);\n const [\n adoptedTexts,\n events,\n procedures,\n mepUpdates,\n documents,\n plenaryDocuments,\n committeeDocuments,\n plenarySessionDocuments,\n externalDocuments,\n questions,\n declarations,\n corporateBodies,\n ] = await Promise.all([\n fetchAdoptedTextsFeed(client, timeframe),\n fetchEventsFeed(client, timeframe),\n fetchProceduresFeed(client, timeframe),\n fetchMEPsFeed(client, timeframe),\n fetchDocumentsFeed(client, timeframe),\n fetchPlenaryDocumentsFeed(client, timeframe),\n fetchCommitteeDocumentsFeed(client, timeframe),\n fetchPlenarySessionDocumentsFeed(client, timeframe),\n fetchExternalDocumentsFeed(client, timeframe),\n fetchQuestionsFeed(client, timeframe),\n fetchDeclarationsFeed(client, timeframe),\n fetchCorporateBodiesFeed(client, timeframe),\n ]);\n\n const filteredData = filterEPFeedDataByDateRange(\n {\n adoptedTexts,\n events,\n procedures,\n mepUpdates,\n documents,\n plenaryDocuments,\n committeeDocuments,\n plenarySessionDocuments,\n externalDocuments,\n questions,\n declarations,\n corporateBodies,\n },\n dateRange\n );\n const totalItems =\n filteredData.adoptedTexts.length +\n filteredData.events.length +\n filteredData.procedures.length +\n filteredData.mepUpdates.length +\n filteredData.documents.length +\n filteredData.plenaryDocuments.length +\n filteredData.committeeDocuments.length +\n filteredData.plenarySessionDocuments.length +\n filteredData.externalDocuments.length +\n filteredData.questions.length +\n filteredData.declarations.length +\n filteredData.corporateBodies.length;\n console.log(` ✅ Fetched ${totalItems} total feed items across 12 endpoints`);\n\n return filteredData;\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/pipeline/generate-stage.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/pipeline/output-stage.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/pipeline/transform-stage.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/propositions-content.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/sitemap.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":362,"column":24,"endLine":362,"endColumn":44},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":368,"column":21,"endLine":368,"endColumn":43},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":373,"column":23,"endLine":373,"endColumn":40}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":3,"fixableErrorCount":0,"fixableWarningCount":0,"source":"#!/usr/bin/env node\n\n// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/Sitemap\n * @description Generates sitemap.xml and multi-language sitemap HTML pages\n * for all news articles, index pages, and documentation files.\n */\n\nimport fs from 'fs';\nimport path, { resolve } from 'path';\nimport { pathToFileURL } from 'url';\nimport {\n NEWS_DIR,\n BASE_URL,\n PROJECT_ROOT,\n createThemeToggleButton,\n THEME_TOGGLE_SCRIPT,\n} from '../constants/config.js';\nimport {\n ALL_LANGUAGES,\n LANGUAGE_NAMES,\n LANGUAGE_FLAGS,\n PAGE_TITLES,\n PAGE_DESCRIPTIONS,\n SKIP_LINK_TEXTS,\n HEADER_SUBTITLE_LABELS,\n THEME_TOGGLE_LABELS,\n getLocalizedString,\n getTextDirection,\n} from '../constants/languages.js';\nimport {\n getNewsArticles,\n getModifiedDate,\n parseArticleFilename,\n formatSlug,\n extractArticleMeta,\n escapeHTML,\n} from '../utils/file-utils.js';\nimport type { SitemapUrl } from '../types/index.js';\n\n/** Absolute docs directory under project root */\nconst DOCS_DIR: string = path.join(PROJECT_ROOT, 'docs');\n\n/**\n * Recursively collect all HTML files under a directory, returning paths\n * relative to the project root.\n *\n * @param dir - Directory to scan\n * @param rootDir - Project root for computing relative paths\n * @returns Array of relative paths (e.g. \"docs/api/index.html\")\n */\nexport function collectDocsHtmlFiles(dir: string, rootDir: string = PROJECT_ROOT): string[] {\n const results: string[] = [];\n if (!fs.existsSync(dir)) {\n return results;\n }\n const entries = fs.readdirSync(dir, { withFileTypes: true });\n for (const entry of entries) {\n const fullPath = path.join(dir, entry.name);\n if (entry.isDirectory()) {\n results.push(...collectDocsHtmlFiles(fullPath, rootDir));\n } else if (entry.isFile() && entry.name.endsWith('.html')) {\n results.push(path.relative(rootDir, fullPath).replace(/\\\\/g, '/'));\n }\n }\n return results.sort();\n}\n\n/**\n * Generate sitemap XML including index pages, news articles, sitemap HTML pages,\n * and documentation files from the docs/ folder.\n *\n * @param articles - List of article filenames\n * @param docsFiles - Relative paths to docs HTML files (e.g. \"docs/api/index.html\")\n * @returns Complete sitemap XML string\n */\nexport function generateSitemap(articles: string[], docsFiles: string[] = []): string {\n const urls: SitemapUrl[] = [];\n const today = new Date().toISOString().slice(0, 10);\n\n // Add home pages for each language\n for (const lang of ALL_LANGUAGES) {\n const filename = lang === 'en' ? 'index.html' : `index-${lang}.html`;\n urls.push({\n loc: `${BASE_URL}/${filename}`,\n lastmod: today,\n changefreq: 'daily',\n priority: '1.0',\n });\n }\n\n // Add sitemap HTML pages for each language\n for (const lang of ALL_LANGUAGES) {\n const filename = lang === 'en' ? 'sitemap.html' : `sitemap_${lang}.html`;\n urls.push({\n loc: `${BASE_URL}/${filename}`,\n lastmod: today,\n changefreq: 'daily',\n priority: '0.5',\n });\n }\n\n // Add RSS feed\n urls.push({\n loc: `${BASE_URL}/rss.xml`,\n lastmod: today,\n changefreq: 'daily',\n priority: '0.5',\n });\n\n // Add news articles\n for (const article of articles) {\n const filepath = path.join(NEWS_DIR, article);\n const lastmod = getModifiedDate(filepath);\n\n urls.push({\n loc: `${BASE_URL}/news/${article}`,\n lastmod,\n changefreq: 'monthly',\n priority: '0.8',\n });\n }\n\n // Add docs HTML files\n for (const relPath of docsFiles) {\n const fullPath = path.join(PROJECT_ROOT, relPath);\n let lastmod = today;\n try {\n lastmod = getModifiedDate(fullPath);\n } catch {\n // Use today if file stat fails\n }\n urls.push({\n loc: `${BASE_URL}/${relPath.replace(/\\\\/g, '/')}`,\n lastmod,\n changefreq: 'weekly',\n priority: '0.3',\n });\n }\n\n return `\n\n${urls\n .map(\n (url) => ` \n ${url.loc}\n ${url.lastmod}\n ${url.changefreq}\n ${url.priority}\n `\n )\n .join('\\n')}\n`;\n}\n\n/** Default sitemap title used as English fallback */\nconst DEFAULT_SITEMAP_TITLE = 'Sitemap';\n\n/** Sitemap page titles per language */\nconst SITEMAP_TITLES: Record = {\n en: DEFAULT_SITEMAP_TITLE,\n sv: 'Webbplatskarta',\n da: DEFAULT_SITEMAP_TITLE,\n no: 'Nettstedskart',\n fi: 'Sivukartta',\n de: 'Seitenübersicht',\n fr: 'Plan du site',\n es: 'Mapa del sitio',\n nl: DEFAULT_SITEMAP_TITLE,\n ar: 'خريطة الموقع',\n he: 'מפת אתר',\n ja: 'サイトマップ',\n ko: '사이트맵',\n zh: '网站地图',\n};\n\n/** Sitemap section headings per language */\nconst SITEMAP_SECTIONS: Record = {\n en: { news: 'News Articles', docs: 'Documentation', pages: 'Pages' },\n sv: { news: 'Nyhetsartiklar', docs: 'Dokumentation', pages: 'Sidor' },\n da: { news: 'Nyhedsartikler', docs: 'Dokumentation', pages: 'Sider' },\n no: { news: 'Nyhetsartikler', docs: 'Dokumentasjon', pages: 'Sider' },\n fi: { news: 'Uutisartikkelit', docs: 'Dokumentaatio', pages: 'Sivut' },\n de: { news: 'Nachrichtenartikel', docs: 'Dokumentation', pages: 'Seiten' },\n fr: { news: 'Articles de presse', docs: 'Documentation', pages: 'Pages' },\n es: { news: 'Artículos de noticias', docs: 'Documentación', pages: 'Páginas' },\n nl: { news: 'Nieuwsartikelen', docs: 'Documentatie', pages: \"Pagina's\" },\n ar: { news: 'مقالات إخبارية', docs: 'التوثيق', pages: 'الصفحات' },\n he: { news: 'מאמרי חדשות', docs: 'תיעוד', pages: 'דפים' },\n ja: { news: 'ニュース記事', docs: 'ドキュメント', pages: 'ページ' },\n ko: { news: '뉴스 기사', docs: '문서', pages: '페이지' },\n zh: { news: '新闻文章', docs: '文档', pages: '页面' },\n};\n\n/** Documentation section labels per language */\nconst DOCS_LABELS: Record<\n string,\n { api: string; coverage: string; testResults: string; docsHome: string }\n> = {\n en: {\n api: 'API Documentation',\n coverage: 'Code Coverage',\n testResults: 'Test Results',\n docsHome: 'Documentation Home',\n },\n sv: {\n api: 'API-dokumentation',\n coverage: 'Kodtäckning',\n testResults: 'Testresultat',\n docsHome: 'Dokumentationsstart',\n },\n da: {\n api: 'API-dokumentation',\n coverage: 'Kodedækning',\n testResults: 'Testresultater',\n docsHome: 'Dokumentationsstart',\n },\n no: {\n api: 'API-dokumentasjon',\n coverage: 'Kodedekning',\n testResults: 'Testresultater',\n docsHome: 'Dokumentasjonsstart',\n },\n fi: {\n api: 'API-dokumentaatio',\n coverage: 'Koodikattavuus',\n testResults: 'Testitulokset',\n docsHome: 'Dokumentaation etusivu',\n },\n de: {\n api: 'API-Dokumentation',\n coverage: 'Codeabdeckung',\n testResults: 'Testergebnisse',\n docsHome: 'Dokumentationsstart',\n },\n fr: {\n api: 'Documentation API',\n coverage: 'Couverture du code',\n testResults: 'Résultats des tests',\n docsHome: 'Accueil documentation',\n },\n es: {\n api: 'Documentación API',\n coverage: 'Cobertura de código',\n testResults: 'Resultados de pruebas',\n docsHome: 'Inicio de documentación',\n },\n nl: {\n api: 'API-documentatie',\n coverage: 'Codedekking',\n testResults: 'Testresultaten',\n docsHome: 'Documentatiestart',\n },\n ar: {\n api: 'وثائق API',\n coverage: 'تغطية الكود',\n testResults: 'نتائج الاختبار',\n docsHome: 'الصفحة الرئيسية للتوثيق',\n },\n he: {\n api: 'תיעוד API',\n coverage: 'כיסוי קוד',\n testResults: 'תוצאות בדיקות',\n docsHome: 'דף הבית של התיעוד',\n },\n ja: {\n api: 'APIドキュメント',\n coverage: 'コードカバレッジ',\n testResults: 'テスト結果',\n docsHome: 'ドキュメントホーム',\n },\n ko: {\n api: 'API 문서',\n coverage: '코드 커버리지',\n testResults: '테스트 결과',\n docsHome: '문서 홈',\n },\n zh: { api: 'API 文档', coverage: '代码覆盖率', testResults: '测试结果', docsHome: '文档首页' },\n};\n\n/**\n * Get the sitemap HTML filename for a given language code.\n *\n * @param lang - Language code\n * @returns Filename string\n */\nexport function getSitemapFilename(lang: string): string {\n return lang === 'en' ? 'sitemap.html' : `sitemap_${lang}.html`;\n}\n\n/**\n * Get the index filename for a given language code.\n *\n * @param lang - Language code\n * @returns Filename string\n */\nfunction getIndexFilename(lang: string): string {\n return lang === 'en' ? 'index.html' : `index-${lang}.html`;\n}\n\n/**\n * Build compact language switcher nav HTML for sitemap pages.\n *\n * @param currentLang - Active language code\n * @returns HTML string\n */\nfunction buildSitemapLangSwitcher(currentLang: string): string {\n return ALL_LANGUAGES.map((code) => {\n const flag = getLocalizedString(LANGUAGE_FLAGS, code);\n const name = getLocalizedString(LANGUAGE_NAMES, code);\n const active = code === currentLang ? ' active' : '';\n const ariaCurrent = code === currentLang ? ' aria-current=\"page\"' : '';\n const href = getSitemapFilename(code);\n return `${flag} ${code.toUpperCase()}`;\n }).join('\\n ');\n}\n\n/**\n * Build the footer language grid for sitemap pages.\n *\n * @param currentLang - Active language code\n * @returns HTML string\n */\nfunction buildSitemapFooterLanguageGrid(currentLang: string): string {\n return ALL_LANGUAGES.map((code) => {\n const flag = getLocalizedString(LANGUAGE_FLAGS, code);\n const name = getLocalizedString(LANGUAGE_NAMES, code);\n const href = getSitemapFilename(code);\n const active = code === currentLang ? ' class=\"active\"' : '';\n return `${flag} ${escapeHTML(name)}`;\n }).join('\\n ');\n}\n\n/**\n * Article info extracted for sitemap HTML display\n */\ninterface SitemapArticleInfo {\n filename: string;\n date: string;\n title: string;\n description: string;\n}\n\n/**\n * Generate a sitemap HTML page for a specific language.\n * Lists all articles for that language with titles and descriptions,\n * plus a high-level documentation section.\n *\n * @param lang - Language code\n * @param articleInfos - Article info (title/description) for this language\n * @param hasDocsDir - Whether the docs directory exists\n * @returns Complete HTML document string\n */\nexport function generateSitemapHTML(\n lang: string,\n articleInfos: SitemapArticleInfo[],\n hasDocsDir: boolean = false\n): string {\n const sitemapTitle = SITEMAP_TITLES[lang] ?? SITEMAP_TITLES['en'] ?? DEFAULT_SITEMAP_TITLE;\n const pageTitle = `${getLocalizedString(PAGE_TITLES, lang).split(' - ')[0]} - ${sitemapTitle}`;\n const description = getLocalizedString(PAGE_DESCRIPTIONS, lang);\n const skipLinkText = getLocalizedString(SKIP_LINK_TEXTS, lang);\n const dir = getTextDirection(lang);\n const year = new Date().getFullYear();\n const sections = (SITEMAP_SECTIONS[lang] ?? SITEMAP_SECTIONS['en']) as {\n news: string;\n docs: string;\n pages: string;\n };\n const docsLabels = (DOCS_LABELS[lang] ?? DOCS_LABELS['en']) as {\n api: string;\n coverage: string;\n testResults: string;\n docsHome: string;\n };\n const heroTitle = getLocalizedString(PAGE_TITLES, lang).split(' - ')[0] ?? '';\n const headerSubtitle = escapeHTML(getLocalizedString(HEADER_SUBTITLE_LABELS, lang));\n const themeToggleLabel = escapeHTML(getLocalizedString(THEME_TOGGLE_LABELS, lang));\n\n // Pages section\n const pagesSection = ALL_LANGUAGES.map((code) => {\n const name = getLocalizedString(LANGUAGE_NAMES, code);\n const flag = getLocalizedString(LANGUAGE_FLAGS, code);\n const href = getIndexFilename(code);\n return `
  • ${flag} ${escapeHTML(name)}
    • `;\n }).join('\\n');\n\n // News articles section\n const articlesSection =\n articleInfos.length === 0\n ? ''\n : articleInfos\n .map(\n (a) =>\n `
  • \n ${escapeHTML(a.title)}\n ${escapeHTML(a.date)}${a.description ? `\\n

    ${escapeHTML(a.description)}

    ` : ''}\n
    • `\n )\n .join('\\n');\n\n // Documentation section (high-level links)\n const docsSection = hasDocsDir\n ? `\n
    \n

    📚 ${escapeHTML(sections.docs)}

    \n \n
    `\n : '';\n\n return `\n\n\n \n \n \n \n ${escapeHTML(pageTitle)}\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n ${escapeHTML(skipLinkText)}\n\n
    \n
    \n \n \n \n \"\"\n \n \n ${escapeHTML(heroTitle)}\n ${headerSubtitle}\n \n \n ${createThemeToggleButton(themeToggleLabel)}\n
    \n
    \n\n \n\n
    \n

    ${escapeHTML(sitemapTitle)}

    \n\n
    \n

    🏠 ${escapeHTML(sections.pages)}

    \n
      \n${pagesSection}\n
    \n
    \n${docsSection}\n
    \n

    📰 ${escapeHTML(sections.news)}

    \n
      \n${articlesSection}\n
    \n
    \n
    \n\n ${THEME_TOGGLE_SCRIPT}\n\n`;\n}\n\n/**\n * RSS feed item data.\n */\ninterface RssItem {\n title: string;\n link: string;\n description: string;\n pubDate: string;\n lang: string;\n}\n\n/**\n * Escape special XML characters in text content.\n *\n * @param str - Raw string to escape for XML\n * @returns XML-safe string\n */\nfunction escapeXML(str: string): string {\n return str\n .replace(/&/g, '&')\n .replace(//g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''');\n}\n\n/**\n * Generate RSS 2.0 XML feed with all news articles across all languages.\n * Articles are sorted newest-first. Each item includes the article language.\n *\n * @param articleInfos - Article metadata sorted newest first\n * @returns Complete RSS 2.0 XML string\n */\nexport function generateRssFeed(articleInfos: RssItem[]): string {\n const buildDate = new Date().toUTCString();\n\n const items = articleInfos\n .map(\n (item) => ` \n ${escapeXML(item.title)}\n ${escapeXML(item.link)}\n ${escapeXML(item.description)}\n ${item.pubDate}\n ${escapeXML(item.link)}\n ${escapeXML(item.lang)}\n `\n )\n .join('\\n');\n\n return `\n\n\n\n \n EU Parliament Monitor\n ${BASE_URL}\n European Parliament Intelligence Platform — monitoring political activity with systematic transparency.\n en\n ${buildDate}\n \n${items}\n \n`;\n}\n\n/**\n * Main execution - generates sitemap.xml, multi-language sitemap HTML pages, and rss.xml.\n */\nfunction main(): void {\n console.log('🗺️ Generating sitemap...');\n\n const articles = getNewsArticles();\n console.log(`📊 Found ${articles.length} articles`);\n\n // Collect docs HTML files\n const docsFiles = collectDocsHtmlFiles(DOCS_DIR);\n console.log(`📚 Found ${docsFiles.length} docs files`);\n\n const sitemap = generateSitemap(articles, docsFiles);\n const filepath = path.join(PROJECT_ROOT, 'sitemap.xml');\n\n fs.writeFileSync(filepath, sitemap, 'utf-8');\n const totalUrls =\n articles.length + ALL_LANGUAGES.length + ALL_LANGUAGES.length + docsFiles.length + 1;\n console.log(`✅ Generated sitemap.xml with ${totalUrls} URLs`);\n\n // Build article metadata map for sitemap HTML pages and RSS,\n // pre-grouped by language for O(N) iteration\n const articlesByLang = new Map();\n const rssItems: RssItem[] = [];\n for (const lang of ALL_LANGUAGES) {\n articlesByLang.set(lang, []);\n }\n for (const filename of articles) {\n const parsed = parseArticleFilename(filename);\n if (parsed) {\n const meta = extractArticleMeta(path.join(NEWS_DIR, filename));\n const info: SitemapArticleInfo = {\n filename: parsed.filename,\n date: parsed.date,\n title: meta.title || formatSlug(parsed.slug),\n description: meta.description,\n };\n const bucket = articlesByLang.get(parsed.lang);\n if (bucket) {\n bucket.push(info);\n }\n rssItems.push({\n title: info.title,\n link: `${BASE_URL}/news/${info.filename}`,\n description: info.description || info.title,\n pubDate: new Date(parsed.date).toUTCString(),\n lang: parsed.lang,\n });\n }\n }\n\n // Check if docs directory exists\n const hasDocsDir = fs.existsSync(DOCS_DIR);\n\n // Generate sitemap HTML for each language\n let htmlGenerated = 0;\n for (const lang of ALL_LANGUAGES) {\n const langArticles = articlesByLang.get(lang) ?? [];\n // Sort newest first\n langArticles.sort((a, b) => b.date.localeCompare(a.date));\n\n const html = generateSitemapHTML(lang, langArticles, hasDocsDir);\n const sitemapFilename = getSitemapFilename(lang);\n const sitemapPath = path.join(PROJECT_ROOT, sitemapFilename);\n fs.writeFileSync(sitemapPath, html, 'utf-8');\n console.log(` ✅ Generated ${sitemapFilename} (${langArticles.length} articles)`);\n htmlGenerated++;\n }\n\n console.log(`✅ Generated ${htmlGenerated} sitemap HTML files`);\n\n // Sort RSS items newest first using numeric timestamps\n rssItems.sort((a, b) => Date.parse(b.pubDate) - Date.parse(a.pubDate));\n\n const rss = generateRssFeed(rssItems);\n const rssPath = path.join(PROJECT_ROOT, 'rss.xml');\n fs.writeFileSync(rssPath, rss, 'utf-8');\n console.log(`✅ Generated rss.xml with ${rssItems.length} items`);\n}\n\n// Only run main when executed directly (not when imported)\nif (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {\n main();\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/article-strategy.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":147,"column":9,"endLine":147,"endColumn":38},{"ruleId":"@typescript-eslint/prefer-nullish-coalescing","severity":1,"message":"Prefer using nullish coalescing operator (`??`) instead of a logical or (`||`), as it is a safer operator.","line":147,"column":47,"messageId":"preferNullishOverOr","endLine":147,"endColumn":49,"suggestions":[{"messageId":"suggestNullish","data":{"equals":""},"fix":{"range":[5968,5970],"text":"??"},"desc":"Fix to nullish coalescing operator (`??`)."}]},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":150,"column":24,"endLine":150,"endColumn":54},{"ruleId":"@typescript-eslint/prefer-nullish-coalescing","severity":1,"message":"Prefer using nullish coalescing operator (`??`) instead of a logical or (`||`), as it is a safer operator.","line":150,"column":63,"messageId":"preferNullishOverOr","endLine":150,"endColumn":65,"suggestions":[{"messageId":"suggestNullish","data":{"equals":""},"fix":{"range":[6128,6130],"text":"??"},"desc":"Fix to nullish coalescing operator (`??`)."}]},{"ruleId":"security/detect-non-literal-regexp","severity":1,"message":"Found non-literal argument to RegExp Constructor","line":190,"column":27,"endLine":190,"endColumn":76}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":5,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/Strategies/ArticleStrategy\n * @description Base interface and shared types for article generation strategies.\n * Each strategy encapsulates the fetch, build, and metadata logic for one\n * {@link ArticleCategory}, making it trivial to add new article types without\n * touching the orchestration layer.\n *\n * Includes utilities for loading analysis pipeline output so that strategies\n * can consume classification, threat assessment, risk scoring, and other\n * analysis artifacts produced by the analysis stage.\n */\n\nimport fs from 'fs';\nimport path from 'path';\nimport type { ArticleCategory } from '../../types/index.js';\nimport type { LanguageCode } from '../../types/index.js';\nimport type { ArticleSource } from '../../types/index.js';\nimport type { EuropeanParliamentMCPClient } from '../../mcp/ep-mcp-client.js';\nimport { escapeHTML } from '../../utils/file-utils.js';\nimport { ANALYSIS_INSIGHTS_HEADING, getLocalizedString } from '../../constants/languages.js';\n\n// ─── Analysis context types ──────────────────────────────────────────────────\n\n/** Content of a single loaded analysis file */\nexport interface AnalysisFileContent {\n /** Analysis method that produced this file */\n readonly method: string;\n /** Subdirectory category (e.g. 'classification', 'risk-scoring') */\n readonly subdir: string;\n /** Raw markdown content (frontmatter included) */\n readonly content: string;\n /** Absolute file path on disk */\n readonly filePath: string;\n}\n\n/**\n * Analysis context loaded from the analysis pipeline output directory.\n *\n * Strategies call {@link loadAnalysisContext} during {@link ArticleStrategy.fetchData}\n * and store the result in their data payload. The context is then consumed by\n * {@link ArticleStrategy.buildContent} to enrich articles with analytical depth.\n *\n * When analysis files are not available (e.g. the analysis stage was skipped),\n * the context is `null` and strategies degrade gracefully to their existing\n * behaviour.\n */\nexport interface LoadedAnalysisContext {\n /** ISO date of the analysis */\n readonly date: string;\n /** Resolved analysis directory path */\n readonly analysisDir: string;\n /** Parsed manifest.json (null when manifest not found) */\n readonly manifest: Record | null;\n /** Overall confidence from the manifest */\n readonly overallConfidence: string | null;\n /** Loaded analysis files keyed by method name */\n readonly files: ReadonlyMap;\n}\n\n// ─── Analysis loading defaults ───────────────────────────────────────────────\n\n/** Default base directory for analysis output */\nconst DEFAULT_ANALYSIS_BASE_DIR = 'analysis/daily';\n\n/**\n * Environment variable name for overriding the analysis base directory.\n * Set by the orchestration layer when `--analysis-dir` is provided.\n */\nconst ENV_ANALYSIS_DIR = 'EP_ANALYSIS_DIR';\n\n/**\n * Environment variable name for overriding the analysis slug.\n * Set by the orchestration layer with the resolved slug from\n * `deriveArticleTypeSlug()`, so multi-type runs and custom analysis\n * directories are correctly resolved without hard-coding per-strategy slugs.\n */\nconst ENV_ANALYSIS_SLUG = 'EP_ANALYSIS_SLUG';\n\n/**\n * Analysis subdirectories to scan for markdown files.\n *\n * Includes the two richer-content conventions used by reference-quality runs:\n * - `intelligence/` — used by breaking / month-ahead workflows (e.g. Run 190)\n * for stakeholder-map, scenario-forecast, pestle-analysis, mcp-reliability-audit\n * - `synthesis/` — alternate location used by monthly-review runs for\n * synthesis-summary and stakeholder-impact\n *\n * Adding these here means `loadAnalysisContext` surfaces the AI-authored\n * markdown to the article-rewriter AI pass as raw context. Per the AI-First\n * Analysis-to-Article Data Contract\n * (`.github/prompts/SHARED_PROMPT_PATTERNS.md#-analysis-to-article-data-contract-ai-first`),\n * **scripts never parse this markdown into structured data**; the AI reads\n * every file here as context and authors all stakeholder / outcome / impact\n * content directly in the rendered HTML.\n */\nconst ANALYSIS_SUBDIRS = [\n 'classification',\n 'threat-assessment',\n 'risk-scoring',\n 'existing',\n 'documents',\n 'intelligence',\n 'synthesis',\n 'risk',\n] as const;\n\n/**\n * Load analysis context from the analysis pipeline output directory.\n *\n * Scans `{baseDir}/{date}/{articleTypeSlug}/` for a `manifest.json` and\n * analysis markdown files in known subdirectories. When the directory\n * does not exist or contains no analysis files, returns `null` for graceful\n * degradation — strategies then behave exactly as before.\n *\n * Handles suffixed directories (e.g. `breaking-2`, `breaking-3`) by\n * scanning for the latest match.\n *\n * Resolution order for base directory:\n * 1. Explicit `baseDir` parameter (when non-default)\n * 2. `EP_ANALYSIS_DIR` environment variable (set by orchestration)\n * 3. Default `'analysis/daily'`\n *\n * Resolution order for slug:\n * 1. `EP_ANALYSIS_SLUG` environment variable (set by orchestration)\n * 2. The `articleTypeSlug` parameter passed by each strategy\n *\n * @param date - ISO 8601 date (YYYY-MM-DD) of the analysis run\n * @param articleTypeSlug - Article type slug (e.g. 'breaking', 'week-ahead')\n * @param baseDir - Base analysis directory (defaults to 'analysis/daily')\n * @returns Loaded analysis context or null when unavailable\n */\nexport function loadAnalysisContext(\n date: string,\n articleTypeSlug: string,\n baseDir: string = DEFAULT_ANALYSIS_BASE_DIR\n): LoadedAnalysisContext | null {\n // Validate date format (YYYY-MM-DD) and reject path traversal\n if (!/^\\d{4}-\\d{2}-\\d{2}$/u.test(date)) return null;\n\n // Resolve base dir: prefer explicit non-default param, then env var, then default\n const resolvedBaseDir =\n baseDir !== DEFAULT_ANALYSIS_BASE_DIR\n ? baseDir\n : process.env[ENV_ANALYSIS_DIR]?.trim() || DEFAULT_ANALYSIS_BASE_DIR;\n\n // Resolve slug: prefer env var override, then per-strategy slug\n const resolvedSlug = process.env[ENV_ANALYSIS_SLUG]?.trim() || articleTypeSlug;\n\n // Validate slug: alphanumeric, hyphens only — no path separators\n if (!/^[\\da-z][\\da-z-]*$/u.test(resolvedSlug)) return null;\n\n const dateDir = path.resolve(resolvedBaseDir, date);\n if (!fs.existsSync(dateDir)) return null;\n\n // Find the best matching analysis directory (exact or latest suffixed)\n const analysisDir = findAnalysisDirectory(dateDir, resolvedSlug);\n if (!analysisDir) return null;\n\n // Load manifest.json\n const manifest = loadManifest(analysisDir);\n\n // Load analysis markdown files from known subdirectories\n const files = loadAnalysisFiles(analysisDir);\n if (files.size === 0 && !manifest) return null;\n\n const overallConfidence =\n manifest && typeof manifest['overallConfidence'] === 'string'\n ? manifest['overallConfidence']\n : null;\n\n return { date, analysisDir, manifest, overallConfidence, files };\n}\n\n/**\n * Find the best matching analysis directory for an article type slug.\n * Checks exact match first, then scans for suffixed variants and picks\n * the latest (highest suffix number).\n *\n * @param dateDir - Date-scoped parent directory\n * @param slug - Article type slug\n * @returns Resolved directory path or null\n */\nfunction findAnalysisDirectory(dateDir: string, slug: string): string | null {\n // Always scan for all matching directories (exact + suffixed) to find the latest\n try {\n const entries = fs.readdirSync(dateDir, { withFileTypes: true });\n const suffixPattern = new RegExp(`^${escapeRegExp(slug)}(?:-(\\\\d+))?$`);\n let bestPath: string | null = null;\n let bestSuffix = -1;\n\n for (const entry of entries) {\n if (!entry.isDirectory()) continue;\n const match = suffixPattern.exec(entry.name);\n if (match) {\n const suffix = match[1] ? parseInt(match[1], 10) : 0;\n if (suffix > bestSuffix) {\n bestSuffix = suffix;\n bestPath = path.join(dateDir, entry.name);\n }\n }\n }\n return bestPath;\n } catch {\n return null;\n }\n}\n\n/**\n * Escape special regex characters in a string.\n *\n * @param str - Input string to escape\n * @returns Escaped string safe for use in RegExp constructor\n */\nfunction escapeRegExp(str: string): string {\n return str.replace(/[.*+?^${}()|[\\]\\\\]/gu, '\\\\$&');\n}\n\n/**\n * Load and parse `manifest.json` from an analysis directory.\n *\n * @param analysisDir - Analysis output directory\n * @returns Parsed manifest or null\n */\nfunction loadManifest(analysisDir: string): Record | null {\n const manifestPath = path.join(analysisDir, 'manifest.json');\n try {\n if (!fs.existsSync(manifestPath)) return null;\n const raw = fs.readFileSync(manifestPath, 'utf-8');\n return JSON.parse(raw) as Record;\n } catch {\n return null;\n }\n}\n\n/**\n * Extract the `method:` value from YAML frontmatter in a markdown string.\n *\n * Analysis files produced by the pipeline embed the canonical method ID in\n * their frontmatter (e.g. `method: coalition-analysis`). When this differs\n * from the filename (e.g. `coalition-dynamics.md`), the frontmatter value is\n * the authoritative key for strategy lookups.\n *\n * @param content - Raw markdown content\n * @returns The frontmatter `method` value, or `null` if absent/unparseable\n */\nexport function extractFrontmatterMethod(content: string): string | null {\n if (!content.startsWith('---')) return null;\n const endIdx = content.indexOf('---', 3);\n if (endIdx === -1) return null;\n const frontmatter = content.slice(3, endIdx);\n const match = /^method:\\s*(.+)$/mu.exec(frontmatter);\n return match?.[1]?.trim() ?? null;\n}\n\n/**\n * Load a single analysis markdown file, register it in the map by both its\n * frontmatter-derived method key and filename-derived alias.\n *\n * @param files - Map to register the file content into\n * @param filePath - Absolute path to the .md file\n * @param entry - Filename (e.g. `coalition-dynamics.md`)\n * @param subdir - Parent subdirectory name (e.g. `existing`)\n */\nfunction loadSingleAnalysisFile(\n files: Map,\n filePath: string,\n entry: string,\n subdir: string\n): void {\n try {\n const content = fs.readFileSync(filePath, 'utf-8');\n const filenameKey = entry.replace(/\\.md$/u, '');\n const frontmatterMethod = extractFrontmatterMethod(content);\n // Primary key: frontmatter method (canonical ID), fallback to filename\n const method = frontmatterMethod ?? filenameKey;\n const fileContent: AnalysisFileContent = { method, subdir, content, filePath };\n files.set(method, fileContent);\n // Register filename alias when it differs from the frontmatter method\n if (frontmatterMethod && frontmatterMethod !== filenameKey) {\n files.set(filenameKey, fileContent);\n }\n } catch {\n // Skip unreadable files\n }\n}\n\n/**\n * Load analysis markdown files from known subdirectories.\n *\n * Keys the returned map by the `method:` value extracted from the file's\n * YAML frontmatter (canonical method ID). When the filename differs from\n * the frontmatter method (e.g. `coalition-dynamics.md` with frontmatter\n * `method: coalition-analysis`), both the frontmatter key and the\n * filename-derived key are registered so that callers can look up files\n * by either identifier.\n *\n * @param analysisDir - Analysis output directory\n * @returns Map of method name → file content\n */\nfunction loadAnalysisFiles(analysisDir: string): Map {\n const files = new Map();\n\n for (const subdir of ANALYSIS_SUBDIRS) {\n const subdirPath = path.join(analysisDir, subdir);\n try {\n if (!fs.existsSync(subdirPath) || !fs.statSync(subdirPath).isDirectory()) continue;\n const entries = fs.readdirSync(subdirPath);\n for (const entry of entries) {\n if (!entry.endsWith('.md')) continue;\n loadSingleAnalysisFile(files, path.join(subdirPath, entry), entry, subdir);\n }\n } catch {\n // Skip unreadable directories\n }\n }\n\n return files;\n}\n\n/**\n * Check whether a line is part of a fenced code block delimiter or table row.\n * Used to filter out non-prose content from analysis summaries.\n *\n * @param trimmed - Trimmed line of text to check\n * @returns `true` when the line is non-prose content (code, table, HTML)\n */\nfunction isNonProseContent(trimmed: string): boolean {\n // Fenced code block delimiters\n if (trimmed.startsWith('```')) return true;\n // Markdown table rows — lines starting with | or containing multiple | separators\n if (trimmed.startsWith('|') && trimmed.includes('|', 1)) return true;\n // Table separator rows (e.g. |---|---|)\n if (/^[\\s|:|-]+$/u.test(trimmed) && trimmed.includes('|')) return true;\n // HTML-like content\n if (trimmed.startsWith('<') && trimmed.endsWith('>')) return true;\n return false;\n}\n\n/** Patterns that indicate scaffold/placeholder content — not real analysis */\nconst SCAFFOLD_PATTERNS = [\n /\\[TO BE FILLED BY AI AGENT/i,\n /\\[AI_ANALYSIS_REQUIRED\\]/i,\n /\\[REQUIRED\\]/i,\n /\\[\\?\\]/,\n /Quality gate: minimum \\d+ words/i,\n /Instructions for AI Agent/i,\n] as const;\n\n/**\n * Check whether an analysis file contains only scaffold/template content\n * (i.e. the AI agent did not fill in the analysis).\n *\n * @param content - Raw markdown file content\n * @returns `true` when the file is an unfilled scaffold\n */\nexport function isScaffoldContent(content: string): boolean {\n return SCAFFOLD_PATTERNS.some((pattern) => pattern.test(content));\n}\n\n/**\n * Check whether a line should be included as prose content.\n *\n * @param trimmed - Trimmed line text\n * @returns `true` when the line is valid prose (not heading, separator, blockquote, or non-prose)\n */\nfunction isProseContent(trimmed: string): boolean {\n if (trimmed === '') return false;\n if (trimmed.startsWith('#')) return false;\n if (trimmed.startsWith('---')) return false;\n if (trimmed.startsWith('>')) return false;\n if (isNonProseContent(trimmed)) return false;\n return true;\n}\n\n/**\n * Strip markdown formatting (bold, italic) from a text string.\n *\n * @param text - Raw markdown text\n * @returns Plain text with bold/italic markers removed\n */\nfunction stripMarkdownFormatting(text: string): string {\n return text.replace(/\\*\\*([^*]+)\\*\\*/g, '$1').replace(/\\*([^*]+)\\*/g, '$1');\n}\n\n/**\n * Prepare analysis content body by stripping frontmatter and code blocks.\n *\n * @param content - Raw markdown content\n * @returns Body text ready for paragraph extraction, or empty string for scaffold content\n */\nfunction prepareAnalysisBody(content: string): string {\n if (isScaffoldContent(content)) return '';\n\n let body = content;\n if (body.startsWith('---')) {\n const endIdx = body.indexOf('---', 3);\n if (endIdx !== -1) body = body.slice(endIdx + 3);\n }\n return body.replace(/```[\\s\\S]*?```/g, '');\n}\n\n/**\n * Collect prose paragraphs from prepared analysis body text.\n *\n * @param body - Analysis body with frontmatter/code blocks removed\n * @returns Array of prose paragraphs\n */\nfunction collectParagraphs(body: string): readonly string[] {\n const lines = body.split('\\n');\n const paragraphs: string[] = [];\n let current = '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (trimmed === '' && current) {\n paragraphs.push(current.trim());\n current = '';\n } else if (isProseContent(trimmed)) {\n current += (current ? ' ' : '') + stripMarkdownFormatting(trimmed);\n }\n }\n if (current) paragraphs.push(current.trim());\n return paragraphs;\n}\n\n/**\n * Extract the first meaningful paragraph from an analysis markdown file.\n * Strips YAML frontmatter, headings, fenced code blocks, tables,\n * scaffold markers, and markdown formatting. Returns plain prose content.\n *\n * @param content - Raw markdown content\n * @param maxLength - Maximum character length to return (default 500)\n * @returns Extracted summary text or empty string\n */\nexport function extractAnalysisSummary(content: string, maxLength: number = 500): string {\n const body = prepareAnalysisBody(content);\n if (!body) return '';\n\n const paragraphs = collectParagraphs(body);\n const meaningful = filterMeaningfulParagraphs(paragraphs, 20);\n\n const summary = meaningful[0] ?? '';\n return summary.length > maxLength ? summary.slice(0, maxLength - 3) + '...' : summary;\n}\n\n/**\n * Filter paragraphs to only include meaningful prose content.\n * Removes short fragments and data-only paragraphs (e.g. \"— | — | —\").\n *\n * @param paragraphs - Array of paragraph strings to filter\n * @param minLength - Minimum character length for a paragraph to be considered meaningful\n * @returns Filtered array of meaningful paragraphs\n */\nfunction filterMeaningfulParagraphs(\n paragraphs: readonly string[],\n minLength: number\n): readonly string[] {\n return paragraphs.filter(\n (p) => p.length > minLength && !/^[\\d\\s|—–-]+$/u.test(p) && !/^\\s*—\\s*$/u.test(p)\n );\n}\n\n/**\n * Extract multiple meaningful paragraphs from an analysis markdown file.\n * Provides richer content than the single-paragraph extractAnalysisSummary.\n *\n * @param content - Raw markdown file content\n * @param maxParagraphs - Maximum number of paragraphs to return (default 3)\n * @param maxTotalLength - Maximum total character length (default 1500)\n * @returns Array of extracted prose paragraphs\n */\nexport function extractAnalysisParagraphs(\n content: string,\n maxParagraphs: number = 3,\n maxTotalLength: number = 1500\n): readonly string[] {\n const body = prepareAnalysisBody(content);\n if (!body) return [];\n\n const paragraphs = collectParagraphs(body);\n const meaningful = filterMeaningfulParagraphs(paragraphs, 50);\n\n const result: string[] = [];\n let totalLength = 0;\n for (const p of meaningful) {\n if (result.length >= maxParagraphs) break;\n const remaining = maxTotalLength - totalLength;\n if (remaining <= 0) break;\n\n if (p.length > remaining) {\n // Truncate overlong paragraph when result is still empty so we\n // never return [] for content that has substantive prose.\n if (result.length === 0) {\n result.push(p.slice(0, remaining).trimEnd());\n }\n break;\n }\n result.push(p);\n totalLength += p.length;\n }\n return result;\n}\n\n/**\n * Check whether an analysis file contains substantive AI-produced content\n * (as opposed to pipeline scaffolding or empty templates).\n *\n * @param content - Raw markdown file content\n * @returns `true` when the file contains real analytical prose\n */\nexport function hasSubstantiveAIContent(content: string): boolean {\n const body = prepareAnalysisBody(content);\n if (!body) return false;\n\n // Count words in prose lines (not tables, not headings, not blockquotes)\n let wordCount = 0;\n for (const line of body.split('\\n')) {\n const trimmed = line.trim();\n if (isProseContent(trimmed) && !trimmed.startsWith('>')) {\n wordCount += trimmed.split(/\\s+/u).length;\n }\n }\n // Minimum 5 words of prose — primarily relies on scaffold detection above\n return wordCount >= 5;\n}\n\n/**\n * Build an HTML section summarising analysis pipeline insights.\n *\n * Creates a structured `
    ` element\n * containing key findings from loaded analysis files. Each strategy passes\n * the methods it considers relevant; only those with loaded content are rendered.\n *\n * Filters out scaffold/template files and files with no substantive AI content.\n * Uses extended paragraph extraction for richer insight content.\n *\n * @param ctx - Loaded analysis context (null-safe: returns empty string)\n * @param relevantMethods - Method names this strategy wants to display\n * @param lang - Target language code (used for localized section heading)\n * @returns HTML string (empty when no context or no relevant files)\n */\nexport function buildAnalysisInsightsSection(\n ctx: LoadedAnalysisContext | null | undefined,\n relevantMethods: readonly string[],\n lang: LanguageCode\n): string {\n if (!ctx) return '';\n\n const items: string[] = [];\n for (const method of relevantMethods) {\n const file = ctx.files.get(method);\n if (!file) continue;\n // `extractAnalysisParagraphs()` already filters scaffold, empty, and\n // non-substantive analysis bodies, so use it as the single gate here.\n const paragraphs = extractAnalysisParagraphs(file.content, 2, 800);\n if (paragraphs.length === 0) continue;\n const label = formatMethodLabel(method);\n const paragraphHtml = paragraphs.map((p) => `

    ${escapeHTML(p)}

    `).join('\\n');\n items.push(\n `
    \\n` +\n `

    ${escapeHTML(label)}

    \\n` +\n paragraphHtml +\n '\\n' +\n `
    `\n );\n }\n\n if (items.length === 0) return '';\n\n const heading = getLocalizedString(ANALYSIS_INSIGHTS_HEADING, lang);\n const confidence = ctx.overallConfidence\n ? ` ${escapeHTML(ctx.overallConfidence)}`\n : '';\n\n return (\n `
    \\n` +\n `

    ${escapeHTML(heading)}${confidence}

    \\n` +\n items.join('\\n') +\n `\\n
    \\n`\n );\n}\n\n/**\n * Format an analysis method identifier into a human-readable label.\n *\n * @param method - Method identifier (e.g. 'significance-classification')\n * @returns Formatted label (e.g. 'Significance Classification')\n */\nfunction formatMethodLabel(method: string): string {\n return method\n .split('-')\n .map((w) => w.charAt(0).toUpperCase() + w.slice(1))\n .join(' ');\n}\n\n// ─── Article data and strategy interfaces ─────────────────────────────────────\n\n/**\n * Minimum payload every strategy must carry: the article's publication date.\n * Strategy-specific data interfaces extend this base.\n */\nexport interface ArticleData {\n /** ISO 8601 publication date (YYYY-MM-DD) */\n readonly date: string;\n /** Loaded analysis context from the analysis pipeline (when available) */\n readonly analysisContext?: LoadedAnalysisContext | null | undefined;\n}\n\n/**\n * Resolved title, subtitle, keywords, and optional sources for one\n * language version of an article.\n */\nexport interface ArticleMetadata {\n /** Localized article title */\n readonly title: string;\n /** Localized article subtitle */\n readonly subtitle: string;\n /** SEO keywords */\n readonly keywords: readonly string[];\n /** Article category */\n readonly category: ArticleCategory;\n /** Optional source references */\n readonly sources?: readonly ArticleSource[] | undefined;\n}\n\n/**\n * Non-generic base interface for {@link ArticleStrategy} used by the strategy\n * registry. Expresses the common operations with {@link ArticleData} as the\n * data payload type so that concrete strategies parameterised on a subtype can\n * be stored in a single {@link StrategyRegistry} map without unsafe casts.\n *\n * This interface deliberately relies on TypeScript's bivariant method-parameter\n * checking: a concrete strategy whose methods accept a narrower `TData`\n * (extending {@link ArticleData}) still satisfies this interface structurally.\n * That means the type is not fully sound — a caller that only sees\n * {@link ArticleStrategyBase} could, in principle, pass an {@link ArticleData}\n * value that does not match the concrete strategy's expected `TData` shape.\n *\n * To use this interface safely:\n * - Only pass the `data` object returned by a given strategy's own\n * {@link ArticleStrategyBase.fetchData | fetchData} to that same strategy's\n * {@link ArticleStrategyBase.buildContent | buildContent} and\n * {@link ArticleStrategyBase.getMetadata | getMetadata} methods.\n * - Never mix data payloads between different strategies, even if they share\n * the {@link ArticleData} base type.\n *\n * External callers that need strong typing for a specific strategy should\n * prefer the generic {@link ArticleStrategy} interface, which preserves the\n * concrete `TData` type and avoids this intentional unsoundness. The\n * {@link ArticleStrategyBase} interface is intended primarily for the internal\n * orchestration / pipeline layer that manages a heterogeneous strategy\n * registry.\n */\nexport interface ArticleStrategyBase {\n /** The article category this strategy handles */\n readonly type: ArticleCategory;\n /** Names of MCP tools this strategy calls */\n readonly requiredMCPTools: readonly string[];\n /**\n * Fetch all domain data needed to render this article type.\n *\n * @param client - Connected MCP client, or null when MCP is unavailable\n * @param date - ISO 8601 publication date (YYYY-MM-DD)\n * @returns Populated article data payload\n */\n fetchData(client: EuropeanParliamentMCPClient | null, date: string): Promise;\n /**\n * Build the article HTML body for the given language.\n *\n * @param data - Data payload returned by {@link fetchData}\n * @param lang - Target language code\n * @returns Article body HTML string\n */\n buildContent(data: ArticleData, lang: LanguageCode): string;\n /**\n * Return title, subtitle, keywords, and sources for the given language.\n *\n * @param data - Data payload returned by {@link fetchData}\n * @param lang - Target language code\n * @returns Article metadata\n */\n getMetadata(data: ArticleData, lang: LanguageCode): ArticleMetadata;\n /**\n * Optional guard that lets a strategy opt out of generation when the\n * fetched data contains only placeholder / fallback values (e.g. MCP\n * unavailable). When `true` is returned the orchestrator skips writing\n * all language variants and logs a notice rather than publishing empty\n * placeholder articles.\n *\n * Strategies that do not implement this method are treated as always\n * wanting to generate (i.e. the default is `false`).\n *\n * @param data - Data payload returned by {@link fetchData}\n * @returns `true` when all fetched data is placeholder and generation should be skipped\n */\n shouldSkip?(data: ArticleData): boolean;\n}\n\n/**\n * Strategy interface for article generation.\n *\n * Each concrete implementation handles one {@link ArticleCategory}:\n * - {@link module:Generators/Strategies/WeekAheadStrategy}\n * - {@link module:Generators/Strategies/BreakingNewsStrategy}\n * - {@link module:Generators/Strategies/CommitteeReportsStrategy}\n * - {@link module:Generators/Strategies/PropositionsStrategy}\n * - {@link module:Generators/Strategies/MotionsStrategy}\n *\n * @template TData - Concrete data payload type returned by {@link fetchData}\n */\nexport interface ArticleStrategy<\n TData extends ArticleData = ArticleData,\n> extends ArticleStrategyBase {\n /**\n * Fetch all domain data needed to render this article type.\n *\n * @param client - Connected MCP client, or null when MCP is unavailable\n * @param date - ISO 8601 publication date (YYYY-MM-DD)\n * @returns Populated article data payload\n */\n fetchData(client: EuropeanParliamentMCPClient | null, date: string): Promise;\n /**\n * Build the article HTML body for the given language.\n *\n * @param data - Data payload returned by {@link fetchData}\n * @param lang - Target language code\n * @returns Article body HTML string\n */\n buildContent(data: TData, lang: LanguageCode): string;\n /**\n * Return title, subtitle, keywords, and sources for the given language.\n *\n * @param data - Data payload returned by {@link fetchData}\n * @param lang - Target language code\n * @returns Article metadata\n */\n getMetadata(data: TData, lang: LanguageCode): ArticleMetadata;\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/breaking-news-strategy.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/committee-reports-strategy.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":310,"column":20,"endLine":310,"endColumn":32},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":312,"column":5,"endLine":312,"endColumn":17},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":332,"column":22,"endLine":332,"endColumn":34},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":334,"column":21,"endLine":334,"endColumn":33},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":343,"column":32,"endLine":343,"endColumn":51}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":5,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/Strategies/CommitteeReportsStrategy\n * @description Article strategy for the Committee Reports article type.\n * Fetches data for each featured committee in parallel and renders an\n * effectiveness and activity overview article.\n */\n\nimport type { EuropeanParliamentMCPClient } from '../../mcp/ep-mcp-client.js';\nimport { ArticleCategory } from '../../types/index.js';\nimport type { LanguageCode, CommitteeData, EPFeedData } from '../../types/index.js';\nimport {\n COMMITTEE_REPORTS_TITLES,\n COMMITTEE_ANALYSIS_CONTENT_STRINGS,\n getLocalizedString,\n} from '../../constants/languages.js';\nimport {\n computeRollingDateRange,\n fetchCommitteeData,\n fetchEPFeedData,\n} from '../pipeline/fetch-stage.js';\nimport {\n FEATURED_COMMITTEES,\n isPlaceholderCommitteeData,\n PLACEHOLDER_CHAIR,\n PLACEHOLDER_MEMBERS,\n} from '../committee-helpers.js';\nimport { escapeHTML } from '../../utils/file-utils.js';\nimport { buildDeepAnalysisSection } from '../deep-analysis-content.js';\nimport {\n buildCommitteeAnalysis,\n buildCommitteeSwot,\n buildCommitteeDashboard,\n buildCommitteeMindmap,\n} from '../analysis-builders.js';\nimport { buildSwotSection } from '../swot-content.js';\nimport { buildDashboardSection } from '../dashboard-content.js';\nimport { buildIntelligenceMindmapSection } from '../mindmap-content.js';\nimport type { ArticleStrategy, ArticleData, ArticleMetadata } from './article-strategy.js';\nimport { loadAnalysisContext, buildAnalysisInsightsSection } from './article-strategy.js';\nimport type { ArticleSource } from '../../types/index.js';\nimport { truncateTitle, MIN_MEANINGFUL_TITLE_LENGTH } from '../../utils/metadata-utils.js';\n\n/** European Parliament home-page URL used as source reference */\nconst EP_SOURCE_URL = 'https://www.europarl.europa.eu';\n\n/** European Parliament display name for source titles and article lede */\nconst EP_DISPLAY_NAME = 'European Parliament';\n\n/** Base keywords shared by all Committee Reports articles */\nconst COMMITTEE_REPORTS_BASE_KEYWORDS = ['committee', 'EU Parliament', 'legislation'] as const;\n\n/** Source reference included in every committee reports article */\nconst COMMITTEE_REPORTS_SOURCES: readonly ArticleSource[] = [\n { title: EP_DISPLAY_NAME, url: EP_SOURCE_URL },\n];\n\n/**\n * Extract content-aware keywords from committee data and feed data.\n *\n * Includes committee abbreviations, names, document types, and adopted-text\n * themes for richer SEO coverage.\n *\n * @param committeeDataList - Fetched committee data\n * @param feedData - EP feed data (may be undefined)\n * @returns Deduplicated keyword array\n */\nfunction buildCommitteeKeywords(\n committeeDataList: readonly CommitteeData[],\n feedData?: EPFeedData | undefined\n): string[] {\n const keywords: string[] = [...COMMITTEE_REPORTS_BASE_KEYWORDS];\n\n // Add committee abbreviations and names\n for (const c of committeeDataList) {\n if (c.abbreviation) keywords.push(c.abbreviation);\n if (c.name) keywords.push(c.name);\n }\n\n // Add adopted text themes from feed\n if (feedData?.adoptedTexts) {\n for (const text of feedData.adoptedTexts.slice(0, 5)) {\n if (text.title) {\n const theme = categorizeAdoptedText(text.title);\n if (theme !== 'OTHER') keywords.push(theme);\n }\n }\n }\n\n return [...new Set(keywords)];\n}\n\n/**\n * Build a content-aware description from committee data.\n * Summarises the number of active committees, document counts, and\n * effectiveness highlights when available.\n *\n * @param committeeDataList - Fetched committee data\n * @param feedData - EP feed data (may be undefined)\n * @returns SEO-friendly description (≤ 200 chars)\n */\nfunction buildCommitteeDescription(\n committeeDataList: readonly CommitteeData[],\n feedData?: EPFeedData | undefined\n): string {\n // Priority 1: Use the title of the most significant adopted text\n const topAdopted = feedData?.adoptedTexts?.find(\n (t) => t.title && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH\n );\n if (topAdopted) {\n const abbrs = committeeDataList\n .filter((c) => c.chair !== PLACEHOLDER_CHAIR)\n .map((c) => c.abbreviation)\n .join(', ');\n const desc = abbrs\n ? `EP committees ${abbrs}: ${topAdopted.title}`\n : `EP committee report: ${topAdopted.title}`;\n return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;\n }\n\n // Priority 2: Name the active committees\n const abbrs = committeeDataList\n .filter((c) => c.chair !== PLACEHOLDER_CHAIR)\n .map((c) => c.abbreviation)\n .join(', ');\n if (abbrs) {\n return `European Parliament committee activity report covering ${abbrs}`;\n }\n\n return 'Analysis of recent legislative output, effectiveness metrics, and key committee activities';\n}\n\n/**\n * Build a content-aware title suffix from the most significant\n * committee item. Uses actual legislation titles, not data counts.\n *\n * @param committeeDataList - Fetched committee data\n * @param feedData - EP feed data (may be undefined)\n * @returns Short analytical suffix, or empty string\n */\nfunction buildCommitteeTitleSuffix(\n committeeDataList: readonly CommitteeData[],\n feedData?: EPFeedData | undefined\n): string {\n // Priority 1: Name the most significant adopted text\n const topAdopted = feedData?.adoptedTexts?.find(\n (t) => t.title && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH\n );\n if (topAdopted) {\n return truncateTitle(topAdopted.title);\n }\n\n // Priority 2: List active committee abbreviations\n const activeAbbrs = committeeDataList\n .filter((c) => c.chair !== PLACEHOLDER_CHAIR)\n .map((c) => c.abbreviation);\n if (activeAbbrs.length > 0) {\n return activeAbbrs.slice(0, 5).join(', ');\n }\n\n return '';\n}\n\n// ─── Data payload ─────────────────────────────────────────────────────────────\n\n/** Data fetched and pre-processed by {@link CommitteeReportsStrategy} */\nexport interface CommitteeReportsArticleData extends ArticleData {\n /** Resolved data for each featured committee */\n readonly committeeDataList: readonly CommitteeData[];\n /** EP feed data for enrichment (when available) */\n readonly feedData?: EPFeedData | undefined;\n}\n\n// ─── Adopted-texts categorization ─────────────────────────────────────────────\n\n/**\n * Narrow union type for the committee theme category keys used when\n * grouping and displaying adopted texts.\n */\nexport type CommitteeTheme = 'ENVI' | 'ECON' | 'AFET' | 'LIBE' | 'AGRI' | 'OTHER';\n\n// Keyword lists are pre-normalized to lowercase so that each call to\n// categorizeAdoptedText only needs to lowercase the title once.\n//\n// LIBE is checked before AFET so that human-rights and human-trafficking\n// titles are correctly classified under civil liberties even when the title\n// also mentions a country (e.g. \"Ukraine\") that would match AFET.\n// Both LIBE and AFET are checked before AGRI so that person-name false\n// positives (e.g. \"Bobi Wine\" matching the agricultural keyword \"wine\")\n// are avoided.\n// AGRI is then checked before ENVI so that titles containing 'agri-food' are\n// not incorrectly captured by ENVI's broader 'food' keyword.\n\n/** Lowercase keywords that map an adopted-text title to the AFET theme group */\nexport const AFET_KEYWORDS: readonly string[] = [\n 'foreign affairs',\n 'foreign policy',\n 'security policy',\n 'security cooperation',\n 'defence',\n 'defense',\n 'sanctions',\n 'magnitsky',\n 'ukraine',\n 'aggression',\n 'peace agreement',\n 'peace process',\n 'peace mission',\n 'peace operation',\n 'post-election',\n 'opposition leader',\n 'threats against',\n];\n\n/** Lowercase keywords that map an adopted-text title to the LIBE theme group */\nexport const LIBE_KEYWORDS: readonly string[] = [\n 'civil liberties',\n 'civil rights',\n 'justice and home affairs',\n 'justice cooperation',\n 'criminal justice',\n 'fundamental rights',\n 'human rights',\n 'human trafficking',\n \"workers' rights\",\n 'safe countries',\n 'safe third',\n 'asylum',\n 'migration',\n];\n\n/** Lowercase keywords that map an adopted-text title to the AGRI theme group */\nexport const AGRI_KEYWORDS: readonly string[] = [\n 'agriculture',\n 'wine',\n 'agri-food',\n 'mercosur',\n 'rural',\n 'farming',\n 'fisheries',\n];\n\n/** Lowercase keywords that map an adopted-text title to the ENVI theme group */\nexport const ENVI_KEYWORDS: readonly string[] = [\n 'environment',\n 'climate',\n 'emission',\n 'health',\n 'food',\n 'medicinal',\n 'detergent',\n 'gmo',\n 'genetically',\n 'cancer',\n];\n\n/** Lowercase keywords that map an adopted-text title to the ECON theme group */\nexport const ECON_KEYWORDS: readonly string[] = [\n 'economic',\n 'financial',\n 'central bank',\n 'monetary',\n 'fiscal',\n '28th regime',\n];\n\n/**\n * Categorize an adopted-text title into a committee theme group.\n *\n * LIBE is tested before AFET so that human-rights and human-trafficking\n * titles are classified under civil liberties even when they also mention\n * an AFET country keyword (e.g. \"Ukraine\"). Both are tested before AGRI\n * to avoid person-name false positives (e.g. \"Bobi Wine\").\n *\n * @param title - Adopted text title to categorize\n * @returns Committee theme key — one of `'ENVI'` | `'ECON'` | `'AFET'` | `'LIBE'` | `'AGRI'` | `'OTHER'`\n */\nexport function categorizeAdoptedText(title: string): CommitteeTheme {\n const t = title.toLowerCase();\n if (LIBE_KEYWORDS.some((k) => t.includes(k))) return 'LIBE';\n if (AFET_KEYWORDS.some((k) => t.includes(k))) return 'AFET';\n if (AGRI_KEYWORDS.some((k) => t.includes(k))) return 'AGRI';\n if (ENVI_KEYWORDS.some((k) => t.includes(k))) return 'ENVI';\n if (ECON_KEYWORDS.some((k) => t.includes(k))) return 'ECON';\n return 'OTHER';\n}\n\n// ─── Feed data enrichment ─────────────────────────────────────────────────────\n\n/**\n * Build an HTML section from adopted texts feed data.\n * Groups texts by thematic area and provides committee-relevant context.\n *\n * @param feedData - EP feed data with adopted texts\n * @param lang - Language code for localized strings\n * @returns HTML string, or empty string when no feed data\n */\nfunction buildAdoptedTextsSection(feedData: EPFeedData | undefined, lang: LanguageCode): string {\n if (!feedData?.adoptedTexts?.length) return '';\n const texts = feedData.adoptedTexts;\n const s = getLocalizedString(COMMITTEE_ANALYSIS_CONTENT_STRINGS, lang);\n\n const grouped: Partial<\n Record>\n > = {};\n for (const text of texts) {\n const cat = categorizeAdoptedText(text.title);\n const bucket = grouped[cat] ?? [];\n bucket.push(text);\n grouped[cat] = bucket;\n }\n\n const committeeNames: Record = {\n ENVI: s.committeeNameENVI,\n ECON: s.committeeNameECON,\n AFET: s.committeeNameAFET,\n LIBE: s.committeeNameLIBE,\n AGRI: s.committeeNameAGRI,\n OTHER: s.committeeNameOTHER,\n };\n\n const sectionLabel = s.adoptedTextsSectionHeading;\n const summary =\n texts.length === 1\n ? s.adoptedTextsSummarySingular\n : s.adoptedTextsSummary.replace('{count}', String(texts.length));\n const displayOrder = ['ENVI', 'ECON', 'AFET', 'LIBE', 'AGRI', 'OTHER'] as const;\n\n const sections = displayOrder\n .filter((cat) => grouped[cat]?.length)\n .map((cat) => {\n const items = grouped[cat] ?? [];\n const listItems = items\n .map(\n (item) =>\n `
  • ${escapeHTML(item.title)} (${escapeHTML(item.date)})
    • `\n )\n .join('\\n ');\n return `\n
    \n

    ${escapeHTML(committeeNames[cat] ?? cat)}

    \n
      ${listItems}
    \n
    `;\n })\n .join('');\n\n if (!sections) return '';\n\n return `\n
    \n

    ${escapeHTML(sectionLabel)}

    \n

    ${escapeHTML(summary)}

    \n ${sections}\n
    `;\n}\n\n// ─── HTML builders ────────────────────────────────────────────────────────────\n\n/**\n * Build the HTML body for a committee reports article.\n *\n * @param committeeDataList - Pre-fetched committee data\n * @param lang - Language code for localized strings\n * @returns Article HTML body\n */\nfunction buildCommitteeReportsHTML(\n committeeDataList: readonly CommitteeData[],\n lang: LanguageCode\n): string {\n const s = getLocalizedString(COMMITTEE_ANALYSIS_CONTENT_STRINGS, lang);\n\n const committeeSections = committeeDataList\n .map((committee) => {\n // Render an unavailable notice for individual placeholder committee entries\n if (\n committee.chair === PLACEHOLDER_CHAIR &&\n committee.members === PLACEHOLDER_MEMBERS &&\n committee.documents.length === 0\n ) {\n return `\n
    \n

    ${escapeHTML(committee.name)} (${escapeHTML(committee.abbreviation)})

    \n

    ${escapeHTML(s.committeeMetadataUnavailable)}

    \n
    `;\n }\n\n const docItems =\n committee.documents.length > 0\n ? committee.documents\n .map(\n (doc) => `\n
  • \n ${escapeHTML(doc.type)}\n ${escapeHTML(doc.title)}\n ${doc.date ? `${escapeHTML(doc.date)}` : ''}\n
    • `\n )\n .join('')\n : `
  • ${escapeHTML(s.noRecentDocs)}
    • `;\n\n const effectivenessHtml = committee.effectiveness\n ? `

    ${escapeHTML(committee.effectiveness)}

    `\n : '';\n\n return `\n
    \n

    ${escapeHTML(committee.name)} (${escapeHTML(committee.abbreviation)})

    \n
    \n ${escapeHTML(s.chairLabel)} ${escapeHTML(committee.chair)}\n ${committee.members} ${escapeHTML(s.membersLabel)}\n
    \n
    \n
      ${docItems}
    \n
    \n
    ${effectivenessHtml}
    \n
    `;\n })\n .join('');\n\n return `\n
    \n
    \n

    ${escapeHTML(s.lede)}

    \n
    \n
    ${committeeSections}
    \n
    `;\n}\n\n// ─── Strategy implementation ──────────────────────────────────────────────────\n\n/**\n * Article strategy for {@link ArticleCategory.COMMITTEE_REPORTS}.\n * Fetches info, documents and effectiveness data for the featured committees\n * then renders an activity overview.\n */\nexport class CommitteeReportsStrategy implements ArticleStrategy {\n readonly type = ArticleCategory.COMMITTEE_REPORTS;\n\n readonly requiredMCPTools = [\n 'get_committee_info',\n 'search_documents',\n 'analyze_legislative_effectiveness',\n 'get_committee_documents_feed',\n ] as const;\n\n /**\n * Fetch committee data for all featured committees in parallel.\n *\n * @param client - MCP client or null\n * @param date - ISO 8601 publication date\n * @returns Populated committee reports data payload\n */\n async fetchData(\n client: EuropeanParliamentMCPClient | null,\n date: string\n ): Promise {\n const feedDateRange = computeRollingDateRange(date, 30, 'committee feed window');\n\n // Fetch individual committee data and EP feeds in parallel\n const [committeeDataRaw, feedData] = await Promise.all([\n Promise.all(\n FEATURED_COMMITTEES.map((abbr) =>\n fetchCommitteeData(client, abbr).catch((error: unknown) => {\n const message = error instanceof Error ? error.message : String(error);\n console.error(` ⚠️ Failed to fetch data for committee ${abbr}:`, message);\n return null;\n })\n )\n ),\n fetchEPFeedData(client, 'one-month', feedDateRange),\n ]);\n\n const committeeDataList = committeeDataRaw.filter(\n (committee): committee is CommitteeData => committee !== null\n );\n\n return {\n date,\n committeeDataList,\n feedData,\n analysisContext: loadAnalysisContext(date, 'committee-reports'),\n };\n }\n\n /**\n * Build the committee reports HTML body.\n *\n * @param data - Committee reports data payload\n * @param lang - Language code for localized content\n * @returns Article HTML body\n */\n buildContent(data: CommitteeReportsArticleData, lang: LanguageCode): string {\n const base = buildCommitteeReportsHTML(data.committeeDataList, lang);\n const feedSection = buildAdoptedTextsSection(data.feedData, lang);\n const analysis = buildCommitteeAnalysis(data.committeeDataList, data.date, lang);\n const deepSection = buildDeepAnalysisSection(analysis, lang);\n const mindmapData = buildCommitteeMindmap(data.committeeDataList, lang);\n const mindmapSection = buildIntelligenceMindmapSection(mindmapData, lang);\n const swotData = buildCommitteeSwot(data.committeeDataList, lang);\n const swotSection = buildSwotSection(swotData, lang);\n const dashboardData = buildCommitteeDashboard(data.committeeDataList, lang);\n const dashboardSection = buildDashboardSection(dashboardData, lang);\n const analysisInsights = buildAnalysisInsightsSection(\n data.analysisContext,\n [\n 'deep-analysis',\n 'synthesis-summary',\n 'stakeholder-analysis',\n 'coalition-analysis',\n 'cross-session-intelligence',\n 'significance-classification',\n 'impact-matrix',\n 'actor-mapping',\n ],\n lang\n );\n const injection =\n feedSection +\n deepSection +\n mindmapSection +\n swotSection +\n dashboardSection +\n analysisInsights;\n // Inject before the closing of .article-content\n if (injection) {\n const closingTag = '';\n const lastIdx = base.lastIndexOf(closingTag);\n if (lastIdx !== -1) {\n return base.slice(0, lastIdx) + injection + '\\n' + base.slice(lastIdx);\n }\n }\n return base;\n }\n\n /**\n * Return language-specific metadata for the committee reports article.\n *\n * @param data - Committee reports data payload\n * @param lang - Target language code\n * @returns Localised metadata\n */\n getMetadata(data: CommitteeReportsArticleData, lang: LanguageCode): ArticleMetadata {\n const committeeLabel = FEATURED_COMMITTEES.join(', ');\n const titleFn = getLocalizedString(COMMITTEE_REPORTS_TITLES, lang);\n const { title: baseTitle, subtitle: baseSubtitle } = titleFn(committeeLabel);\n const suffix =\n lang === 'en' ? buildCommitteeTitleSuffix(data.committeeDataList, data.feedData) : '';\n const title = suffix ? `${baseTitle} — ${suffix}` : baseTitle;\n const subtitle =\n lang === 'en'\n ? buildCommitteeDescription(data.committeeDataList, data.feedData) || baseSubtitle\n : baseSubtitle;\n return {\n title,\n subtitle,\n keywords: buildCommitteeKeywords(data.committeeDataList, data.feedData),\n category: ArticleCategory.COMMITTEE_REPORTS,\n sources: COMMITTEE_REPORTS_SOURCES,\n };\n }\n\n /**\n * Skip generation when no real data is available.\n *\n * Skips when:\n * - All committee fetches failed (empty committeeDataList), or\n * - All fetched committee data is placeholder AND no feed data is available.\n * When EP feed data contains adopted texts or other items, the article can still\n * provide valuable content even if individual committee metadata is sparse.\n *\n * @param data - Committee reports data payload\n * @returns `true` when there is no usable data at all\n */\n shouldSkip(data: CommitteeReportsArticleData): boolean {\n const { committeeDataList, feedData } = data;\n\n if (committeeDataList.length === 0) {\n return true;\n }\n\n // If feed data has any items, generate even with placeholder committees\n if (feedData) {\n const feedItemCount =\n (feedData.adoptedTexts?.length ?? 0) +\n (feedData.committeeDocuments?.length ?? 0) +\n (feedData.plenaryDocuments?.length ?? 0) +\n (feedData.documents?.length ?? 0) +\n (feedData.procedures?.length ?? 0);\n if (feedItemCount > 0) {\n return false;\n }\n }\n\n return isPlaceholderCommitteeData(committeeDataList);\n }\n}\n\n/** Singleton instance for use by the strategy registry */\nexport const committeeReportsStrategy = new CommitteeReportsStrategy();\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/month-ahead-strategy.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/monthly-review-strategy.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/motions-strategy.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/propositions-strategy.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/week-ahead-strategy.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/strategies/weekly-review-strategy.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/swot-content.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/synthesis-summary.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/generators/week-ahead-content.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":355,"column":10,"endLine":355,"endColumn":19}],"suppressedMessages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":71,"column":28,"endLine":71,"endColumn":37,"suppressions":[{"kind":"directive","justification":""}]}],"errorCount":0,"fatalErrorCount":0,"warningCount":1,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Generators/WeekAheadContent\n * @description Pure functions for parsing MCP data and building week-ahead article HTML.\n * No side effects — all functions accept data and return strings.\n */\n\nimport { escapeHTML } from '../utils/file-utils.js';\nimport {\n getLocalizedString,\n WEEK_AHEAD_STRINGS,\n WEEK_AHEAD_STAKEHOLDER_STRINGS,\n} from '../constants/languages.js';\nimport type {\n ParliamentEvent,\n CommitteeMeeting,\n LegislativeDocument,\n LegislativeProcedure,\n ParliamentaryQuestion,\n WeekAheadData,\n DateRange,\n MCPToolResult,\n LegislativeVelocity,\n StakeholderImpactSection,\n StakeholderImpactRow,\n PoliticalTemperature,\n PoliticalTemperatureBand,\n WeekAheadStakeholderStrings,\n} from '../types/index.js';\n\n/** Keyword constant for article tagging */\nconst KEYWORD_EUROPEAN_PARLIAMENT = 'European Parliament';\n\n/** Placeholder events used when MCP is unavailable or returns no sessions */\nexport const PLACEHOLDER_EVENTS: ParliamentEvent[] = [\n {\n date: '',\n title: 'Plenary Session',\n type: 'Plenary',\n description: 'Full parliamentary session',\n },\n {\n date: '',\n title: 'ENVI Committee Meeting',\n type: 'Committee',\n description: 'Environment committee discussion',\n },\n];\n\n/**\n * Generic parser for settled MCP results.\n * Extracts an array from the JSON payload at the given key and maps each element.\n *\n * @param settled - Promise.allSettled result\n * @param key - JSON key containing the array of items\n * @param mapper - Function to map raw items to typed objects\n * @returns Array of typed objects, or empty array on failure\n */\nfunction parseSettledMCPResult(\n settled: PromiseSettledResult,\n key: string,\n mapper: (raw: Record) => T\n): T[] {\n if (settled.status !== 'fulfilled') return [];\n try {\n const data = JSON.parse(settled.value.content?.[0]?.text ?? '{}') as Record;\n if (!Object.hasOwn(data, key)) return [];\n // eslint-disable-next-line security/detect-object-injection\n const items: unknown = data[key];\n if (!Array.isArray(items)) return [];\n return items.map(mapper);\n } catch {\n return [];\n }\n}\n\n/**\n * Parse plenary sessions from a settled MCP result\n *\n * @param settled - Promise.allSettled result\n * @param fallbackDate - Fallback date when session has none\n * @returns Array of parliament events\n */\nexport function parsePlenarySessions(\n settled: PromiseSettledResult,\n fallbackDate: string\n): ParliamentEvent[] {\n return parseSettledMCPResult(settled, 'sessions', (s) => ({\n date: (s.date as string | undefined) ?? fallbackDate,\n title: (s.title as string | undefined) ?? 'Parliamentary Session',\n type: (s.type as string | undefined) ?? 'Session',\n description: (s.description as string | undefined) ?? '',\n }));\n}\n\n/**\n * Parse EP events (hearings, conferences, seminars) from a settled MCP result\n *\n * @param settled - Promise.allSettled result\n * @param fallbackDate - Fallback date when event has none\n * @returns Array of parliament events\n */\nexport function parseEPEvents(\n settled: PromiseSettledResult,\n fallbackDate: string\n): ParliamentEvent[] {\n return parseSettledMCPResult(settled, 'events', (e) => ({\n date: (e.date as string | undefined) ?? fallbackDate,\n title: (e.title as string | undefined) ?? 'EP Event',\n type: (e.type as string | undefined) ?? 'Event',\n description: (e.description as string | undefined) ?? '',\n }));\n}\n\n/**\n * Parse committee meetings from a settled MCP result\n *\n * @param settled - Promise.allSettled result\n * @param fallbackDate - Fallback date when meeting has no date\n * @returns Array of committee meetings\n */\nexport function parseCommitteeMeetings(\n settled: PromiseSettledResult,\n fallbackDate?: string\n): CommitteeMeeting[] {\n return parseSettledMCPResult(settled, 'committees', (c) => ({\n id: c.id as string | undefined,\n committee: (c.committee as string | undefined) ?? 'Unknown',\n committeeName: c.committeeName as string | undefined,\n date: (c.date as string | undefined) ?? fallbackDate ?? '',\n time: c.time as string | undefined,\n location: c.location as string | undefined,\n agenda: (\n c.agenda as\n | Array<{\n item?: number | undefined;\n title?: string | undefined;\n type?: string | undefined;\n }>\n | undefined\n )?.map((a) => ({\n item: a.item,\n title: a.title ?? '',\n type: a.type,\n })),\n }));\n}\n\n/**\n * Parse legislative documents from a settled MCP result\n *\n * @param settled - Promise.allSettled result\n * @returns Array of legislative documents\n */\nexport function parseLegislativeDocuments(\n settled: PromiseSettledResult\n): LegislativeDocument[] {\n return parseSettledMCPResult(settled, 'documents', (d) => ({\n id: d.id as string | undefined,\n type: d.type as string | undefined,\n title: (d.title as string | undefined) ?? 'Untitled Document',\n date: d.date as string | undefined,\n status: d.status as string | undefined,\n committee: d.committee as string | undefined,\n rapporteur: d.rapporteur as string | undefined,\n }));\n}\n\n/**\n * Parse legislative pipeline from a settled MCP result\n *\n * @param settled - Promise.allSettled result\n * @returns Array of legislative procedures\n */\nexport function parseLegislativePipeline(\n settled: PromiseSettledResult\n): LegislativeProcedure[] {\n return parseSettledMCPResult(settled, 'procedures', (p) => ({\n id: p.id as string | undefined,\n title: (p.title as string | undefined) ?? 'Unnamed Procedure',\n stage: p.stage as string | undefined,\n committee: p.committee as string | undefined,\n status: p.status as string | undefined,\n bottleneck: p.bottleneck as boolean | undefined,\n }));\n}\n\n/**\n * Parse parliamentary questions from a settled MCP result\n *\n * @param settled - Promise.allSettled result\n * @returns Array of parliamentary questions\n */\nexport function parseParliamentaryQuestions(\n settled: PromiseSettledResult\n): ParliamentaryQuestion[] {\n return parseSettledMCPResult(settled, 'questions', (q) => ({\n id: q.id as string | undefined,\n type: q.type as string | undefined,\n author: q.author as string | undefined,\n subject: (q.subject as string | undefined) ?? 'No subject',\n date: q.date as string | undefined,\n status: q.status as string | undefined,\n }));\n}\n\n// ─── Render helpers ──────────────────────────────────────────────────────────\n\n/**\n * Render a single plenary event as HTML\n *\n * @param event - Parliament event data\n * @returns HTML string\n */\nfunction renderPlenaryEvent(event: ParliamentEvent): string {\n return `\n
    \n
    ${escapeHTML(event.date)}
    \n
    \n

    ${escapeHTML(event.title)}

    \n

    ${escapeHTML(event.type)}

    \n ${event.description ? `

    ${escapeHTML(event.description)}

    ` : ''}\n
    \n
    `;\n}\n\n/**\n * Render a single committee meeting as HTML\n *\n * @param meeting - Committee meeting data\n * @returns HTML string\n */\nfunction renderCommitteeMeeting(meeting: CommitteeMeeting): string {\n const agendaHtml =\n meeting.agenda && meeting.agenda.length > 0\n ? `
      ${meeting.agenda.map((item) => `
    • ${escapeHTML(item.title)}${item.type ? ` (${escapeHTML(item.type)})` : ''}
      • `).join('')}
    `\n : '';\n return `\n
    \n
    ${escapeHTML(meeting.date)}${meeting.time ? ` ${escapeHTML(meeting.time)}` : ''}
    \n
    \n

    ${escapeHTML(meeting.committeeName ?? meeting.committee)}

    \n ${meeting.location ? `

    ${escapeHTML(meeting.location)}

    ` : ''}\n ${agendaHtml}\n
    \n
    `;\n}\n\n/**\n * Render a single legislative document as HTML\n *\n * @param doc - Legislative document\n * @returns HTML string\n */\nfunction renderLegislativeDocument(doc: LegislativeDocument): string {\n return `\n
  • \n ${escapeHTML(doc.title)}\n ${doc.type ? ` (${escapeHTML(doc.type)})` : ''}\n ${doc.committee ? ` — ${escapeHTML(doc.committee)}` : ''}\n ${doc.status ? ` [${escapeHTML(doc.status)}]` : ''}\n
    • `;\n}\n\n/**\n * Render a single pipeline procedure as HTML\n *\n * @param proc - Legislative procedure\n * @returns HTML string\n */\nfunction renderPipelineProcedure(proc: LegislativeProcedure): string {\n return `\n
  • \n ${escapeHTML(proc.title)}\n ${proc.stage ? ` ${escapeHTML(proc.stage)}` : ''}\n ${proc.committee ? ` — ${escapeHTML(proc.committee)}` : ''}\n ${proc.bottleneck ? ' ⚠ Bottleneck' : ''}\n
    • `;\n}\n\n/**\n * Render a single parliamentary question as HTML\n *\n * @param q - Parliamentary question\n * @returns HTML string\n */\nfunction renderQuestion(q: ParliamentaryQuestion): string {\n return `\n
  • \n ${escapeHTML(q.subject)}\n ${q.type ? ` (${escapeHTML(q.type)})` : ''}\n ${q.author ? ` — ${escapeHTML(q.author)}` : ''}\n
    • `;\n}\n\n// ─── Content builders ────────────────────────────────────────────────────────\n\n/**\n * Clamp a number to the 0–100 range.\n *\n * @param n - Number to clamp\n * @returns Clamped value between 0 and 100\n */\nfunction clamp0to100(n: number): number {\n return Math.max(0, Math.min(100, n));\n}\n\n/**\n * Map from band key to CSS class suffix used in `temp-*` class names.\n */\nconst BAND_CSS_CLASS: Record = {\n low: 'temp-low',\n moderate: 'temp-moderate',\n high: 'temp-high',\n veryHigh: 'temp-very-high',\n};\n\n/**\n * Derive a language-agnostic temperature band from a 0–100 score.\n *\n * This is the single source of truth for score → band mapping.\n * `computeWeekPoliticalTemperature()` uses this to derive the\n * `temperature.band` value that the renderer later consumes, avoiding\n * duplicated threshold logic.\n *\n * @param score - Clamped score (0–100)\n * @returns Band key\n */\nfunction temperatureBand(score: number): PoliticalTemperatureBand {\n if (score >= 75) return 'veryHigh';\n if (score >= 50) return 'high';\n if (score >= 25) return 'moderate';\n return 'low';\n}\n\n/**\n * Resolve the localized temperature descriptor for a given band.\n *\n * @param band - Language-agnostic band key\n * @param strings - Localized stakeholder strings\n * @returns Localized descriptor (e.g. \"Modéré\", \"高い\")\n */\nfunction localizedTempLabel(\n band: PoliticalTemperatureBand,\n strings: WeekAheadStakeholderStrings\n): string {\n const map: Record = {\n low: strings.tempLow,\n moderate: strings.tempModerate,\n high: strings.tempHigh,\n veryHigh: strings.tempVeryHigh,\n };\n return map[band];\n}\n\n/**\n * Compute a composite political temperature score (0–100) indicating how\n * contentious or urgent the upcoming parliamentary week is likely to be.\n *\n * The score is derived from the volume and diversity of scheduled events\n * and questions — a pure scoring function with no side effects.\n *\n * @param events - Plenary / parliamentary events for the week\n * @param questions - Parliamentary questions tabled for the week\n * @returns Political temperature score and band\n */\nexport function computeWeekPoliticalTemperature(\n events: readonly ParliamentEvent[],\n questions: readonly ParliamentaryQuestion[]\n): PoliticalTemperature {\n // Base: volume-driven heuristic — more events & questions ⇒ higher temperature\n const eventContribution = Math.min(events.length * 10, 50);\n const questionContribution = Math.min(questions.length * 5, 30);\n\n // Diversity bonus: distinct event types signal a broader agenda\n const uniqueTypes = new Set(events.map((e) => e.type));\n const diversityBonus = Math.min(uniqueTypes.size * 5, 20);\n\n const raw = eventContribution + questionContribution + diversityBonus;\n const score = clamp0to100(Math.round(raw));\n return { score, band: temperatureBand(score) };\n}\n\n/**\n * Determine impact level based on a count and a threshold for \"high\".\n *\n * @param count - Item count\n * @param highThreshold - Minimum count for high impact\n * @returns Impact level\n */\nfunction impactFromCount(count: number, highThreshold: number): 'high' | 'medium' | 'low' {\n if (count >= highThreshold) return 'high';\n return count > 0 ? 'medium' : 'low';\n}\n\n/**\n * Build a stakeholder impact matrix from scheduled events and legislative\n * documents, assessing which groups are most affected by the agenda.\n *\n * Returns an empty section when no events or documents are available\n * (graceful fallback). This function only constructs raw data; HTML\n * escaping (for example via `escapeHTML()`) must be applied at render\n * time by the caller (e.g. in `renderStakeholderSection()`).\n *\n * @param events - Parliament events for the upcoming week\n * @param docs - Legislative documents expected in the period\n * @param lang - Language code for localized labels (defaults to 'en')\n * @returns Stakeholder impact section with rows\n */\nexport function buildStakeholderImpactMatrix(\n events: readonly ParliamentEvent[],\n docs: readonly LegislativeDocument[],\n lang: string = 'en'\n): StakeholderImpactSection {\n if (events.length === 0 && docs.length === 0) {\n return { rows: [] };\n }\n\n const strings = getLocalizedString(WEEK_AHEAD_STAKEHOLDER_STRINGS, lang);\n const rows: StakeholderImpactRow[] = [];\n const eventCount = events.length;\n const docCount = docs.length;\n const totalCount = eventCount + docCount;\n\n if (eventCount > 0) {\n rows.push({\n stakeholder: strings.stakeholderPoliticalGroups,\n impact: impactFromCount(eventCount, 3),\n reason: strings.reasonEventsScheduled.replace('{count}', String(eventCount)),\n });\n }\n\n if (docCount > 0) {\n rows.push({\n stakeholder: strings.stakeholderCivilSociety,\n impact: impactFromCount(docCount, 3),\n reason: strings.reasonDocumentsUnderReview.replace('{count}', String(docCount)),\n });\n }\n\n rows.push({\n stakeholder: strings.stakeholderIndustry,\n impact: impactFromCount(totalCount, 5),\n reason: strings.reasonIndustryRegulatoryAgenda,\n });\n\n rows.push({\n stakeholder: strings.stakeholderEuCitizens,\n impact: impactFromCount(eventCount, 3),\n reason: strings.reasonCitizensDecisionsShapePolicy,\n });\n\n if (docCount > 0) {\n rows.push({\n stakeholder: strings.stakeholderNationalGovernments,\n impact: impactFromCount(docCount, 3),\n reason: strings.reasonDocumentsRequireTransposition.replace('{count}', String(docCount)),\n });\n }\n\n rows.push({\n stakeholder: strings.stakeholderEuInstitutions,\n impact: impactFromCount(totalCount, 4),\n reason: strings.reasonInstitutionsCoordination,\n });\n\n return { rows };\n}\n\n/**\n * Render the stakeholder impact section as HTML.\n *\n * @param section - Stakeholder impact data\n * @param temperature - Political temperature score\n * @param lang - Language code for localized headings\n * @returns HTML string, or empty string when section is empty\n */\nfunction renderStakeholderSection(\n section: StakeholderImpactSection,\n temperature: PoliticalTemperature,\n lang: string\n): string {\n if (section.rows.length === 0) return '';\n\n const strings = getLocalizedString(WEEK_AHEAD_STAKEHOLDER_STRINGS, lang);\n\n const tempClass = BAND_CSS_CLASS[temperature.band];\n const tempDescriptor = localizedTempLabel(temperature.band, strings);\n\n const tableRows = section.rows\n .map(\n (row) =>\n `` +\n `${escapeHTML(row.stakeholder)}` +\n `${escapeHTML(row.impact)}` +\n `${escapeHTML(row.reason)}` +\n ``\n )\n .join('');\n\n return `\n
    \n

    ${escapeHTML(strings.heading)}

    \n
    \n ${escapeHTML(strings.temperatureLabel)}:\n ${temperature.score}/100\n (${escapeHTML(tempDescriptor)})\n
    \n \n \n \n \n \n \n \n \n \n ${tableRows}\n \n
    ${escapeHTML(strings.stakeholderHeader)}${escapeHTML(strings.impactHeader)}${escapeHTML(strings.reasonHeader)}
    \n
    `;\n}\n\n/**\n * Build the supplementary lede sentence about committee and pipeline counts.\n *\n * @param committeeCount - Number of committee meetings\n * @param pipelineCount - Number of pipeline procedures\n * @returns Sentence fragment or empty string\n */\nfunction buildLedeDetail(committeeCount: number, pipelineCount: number): string {\n if (committeeCount === 0 && pipelineCount === 0) return '';\n const committeePart =\n committeeCount > 0\n ? `${committeeCount} committee meeting${committeeCount !== 1 ? 's are' : ' is'} scheduled`\n : '';\n const pipelinePart =\n pipelineCount > 0\n ? `${pipelineCount} legislative procedure${pipelineCount !== 1 ? 's are' : ' is'} advancing through the pipeline`\n : '';\n const conjunction = committeePart && pipelinePart ? ' and ' : '';\n return ` Notably, ${committeePart}${conjunction}${pipelinePart}.`;\n}\n\n/**\n * Build article content HTML from week-ahead data\n *\n * @param weekData - Aggregated week-ahead data\n * @param dateRange - Date range for the article\n * @param lang - Language code for localized content strings (default: 'en')\n * @returns HTML content string\n */\nexport function buildWeekAheadContent(\n weekData: WeekAheadData,\n dateRange: DateRange,\n lang = 'en'\n): string {\n const strings = getLocalizedString(WEEK_AHEAD_STRINGS, lang);\n const plenaryHtml =\n weekData.events.length > 0\n ? weekData.events.map(renderPlenaryEvent).join('')\n : `

    ${escapeHTML(strings.noPlenary)}

    `;\n\n const committeeSection =\n weekData.committees.length > 0\n ? `
    \n

    ${escapeHTML(strings.committeeMeetings)}

    \n ${weekData.committees.map(renderCommitteeMeeting).join('')}\n
    `\n : '';\n\n const documentsSection =\n weekData.documents.length > 0\n ? `
    \n

    ${escapeHTML(strings.legislativeDocuments)}

    \n
      ${weekData.documents.map(renderLegislativeDocument).join('')}
    \n
    `\n : '';\n\n const pipelineSection =\n weekData.pipeline.length > 0\n ? `
    \n

    ${escapeHTML(strings.legislativePipeline)}

    \n
      ${weekData.pipeline.map(renderPipelineProcedure).join('')}
    \n
    `\n : '';\n\n const qaSection =\n weekData.questions.length > 0\n ? `
    \n

    ${escapeHTML(strings.parliamentaryQuestions)}

    \n
      ${weekData.questions.map(renderQuestion).join('')}
    \n
    `\n : '';\n\n const ledeDetail = buildLedeDetail(weekData.committees.length, weekData.pipeline.length);\n\n // Stakeholder impact analysis\n const stakeholderData = buildStakeholderImpactMatrix(weekData.events, weekData.documents, lang);\n const temperature = computeWeekPoliticalTemperature(weekData.events, weekData.questions);\n const stakeholderSection = renderStakeholderSection(stakeholderData, temperature, lang);\n\n return `\n
    \n
    \n

    ${escapeHTML(strings.lede)} from ${escapeHTML(dateRange.start)} to ${escapeHTML(dateRange.end)}.${escapeHTML(ledeDetail)}

    \n
    \n
    \n

    ${escapeHTML(strings.plenarySessions)}

    \n ${plenaryHtml}\n
    \n ${committeeSection}\n ${documentsSection}\n ${pipelineSection}\n ${qaSection}\n ${stakeholderSection}\n \n
    \n `;\n}\n\n/**\n * Build article keywords from week-ahead data\n *\n * @param weekData - Aggregated week-ahead data\n * @returns Array of keyword strings\n */\nexport function buildKeywords(weekData: WeekAheadData): string[] {\n const keywords = [KEYWORD_EUROPEAN_PARLIAMENT, 'week ahead', 'plenary', 'committees'];\n for (const c of weekData.committees) {\n if (c.committee && !keywords.includes(c.committee)) {\n keywords.push(c.committee);\n }\n }\n if (weekData.pipeline.length > 0) keywords.push('legislative pipeline');\n if (weekData.questions.length > 0) keywords.push('parliamentary questions');\n return keywords;\n}\n\n// ─── What-to-Watch section ─────────────────────────────────────────────────\n\n/** CSS class for bottleneck-risk watch items */\nconst CSS_WATCH_HIGH = 'watch-high';\n\n/** CSS class for bottlenecked procedure watch items */\nconst CSS_WATCH_PROCEDURE = 'watch-procedure';\n\n/** CSS class for standard velocity watch items */\nconst CSS_WATCH_ITEM = 'watch-item';\n\n/** Maximum number of non-bottleneck velocity items to include */\nconst WATCH_MAX_NORMAL_ITEMS = 3;\n\n/**\n * Build list items for high-risk velocities\n *\n * @param velocities - All legislative velocities\n * @returns HTML list items for high bottleneck risk items\n */\nfunction buildHighRiskItems(velocities: LegislativeVelocity[]): string {\n return velocities\n .filter((v) => v.bottleneckRisk === 'high')\n .map(\n (v) =>\n `
  • ${escapeHTML(v.title)} — ` +\n `Stage: ${escapeHTML(v.stage)} (bottleneck risk detected)
    • `\n )\n .join('');\n}\n\n/**\n * Build list items for procedures flagged as bottlenecks\n *\n * @param procedures - All legislative procedures\n * @returns HTML list items for bottlenecked procedures\n */\nfunction buildBottleneckProcedureItems(procedures: LegislativeProcedure[]): string {\n return procedures\n .filter((p) => p.bottleneck === true)\n .map(\n (p) =>\n `
  • ${escapeHTML(p.title)} — ` +\n `${escapeHTML(p.stage ?? 'in progress')} stage
    • `\n )\n .join('');\n}\n\n/**\n * Build list items for normal-risk velocities\n *\n * @param velocities - All legislative velocities\n * @returns HTML list items for the top normal-risk velocity items\n */\nfunction buildNormalVelocityItems(velocities: LegislativeVelocity[]): string {\n return velocities\n .filter((v) => v.bottleneckRisk !== 'high')\n .slice(0, WATCH_MAX_NORMAL_ITEMS)\n .map(\n (v) =>\n `
  • ${escapeHTML(v.title)} — ` +\n `predicted completion: ${escapeHTML(v.predictedCompletion)}
    • `\n )\n .join('');\n}\n\n/**\n * Build predictive \"What to Watch\" analysis section showing legislative\n * procedures and velocity data ordered by bottleneck risk.\n * Returns an empty string when both input arrays are empty or yield no items.\n *\n * @param procedures - Legislative procedures to analyse\n * @param velocities - Legislative velocity data (for example from a separate velocity analysis feed)\n * @param language - BCP 47 language code used as the section lang attribute\n * @returns HTML string for the \"What to Watch\" section\n */\nexport function buildWhatToWatchSection(\n procedures: LegislativeProcedure[],\n velocities: LegislativeVelocity[],\n language: string\n): string {\n if (procedures.length === 0 && velocities.length === 0) return '';\n const allItems =\n buildHighRiskItems(velocities) +\n buildBottleneckProcedureItems(procedures) +\n buildNormalVelocityItems(velocities);\n if (!allItems) return '';\n const strings = getLocalizedString(WEEK_AHEAD_STRINGS, language);\n return `\n
    \n

    ${escapeHTML(strings.whatToWatch)}

    \n
      \n ${allItems}\n
    \n
    `;\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/index.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/mcp/ep-mcp-client.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/mcp/imf-mcp-client.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":219,"column":21,"endLine":219,"endColumn":33}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":1,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module MCP/IMFMCPClient\n * @description Native TypeScript IMF Data client — calls the IMF SDMX 3.0\n * REST API at {@link https://dataservices.imf.org/REST/SDMX_3.0/} directly\n * via `fetch()`, with no external MCP server process.\n *\n * Historical note: the first Wave-1 iteration delegated to the Python\n * `c-cf/imf-data-mcp` MCP server. That dependency blocked Wave 0 rollout\n * because the upstream project is a Python git-URL package (not npm) and\n * could not be pinned to an integrity hash per the ISMS Secure Development\n * Policy §7. This module replaces the Python transport with a direct,\n * typed HTTP client — the public API is preserved so callers\n * (`src/utils/imf-data.ts`, validator fingerprints, workflow probes) are\n * untouched.\n *\n * ## Public API (unchanged from the MCP-backed iteration)\n *\n * - {@link IMFMCPClient} — class with semantic wrappers for five \"tools\".\n * - {@link IMF_MCP_TOOLS} — stable virtual tool-name list used by the\n * content-validator fingerprint and the workflow probe.\n * - {@link getIMFMCPClient} / {@link closeIMFMCPClient} — singleton lifecycle.\n *\n * The return envelope of every method is {@link MCPToolResult}\n * (`{ content: [{ type: \"text\", text: \"\" }] }`) so downstream code\n * that already calls `parseSDMXJSON(response.content[0]?.text)` continues\n * to work unmodified.\n *\n * ## Transport\n *\n * - Uses the native Node 25 `fetch()` — no extra runtime dependency.\n * - Every call has an independent `AbortController` with a configurable\n * timeout (`IMF_API_TIMEOUT_MS`, default 30 s).\n * - Errors (HTTP 4xx/5xx, network faults, JSON parse failures, abort) are\n * caught and converted to the {@link IMF_FALLBACK} envelope. Callers\n * upstream can therefore treat \"no IMF\" as \"empty data\" without\n * defensive try/catch, matching the `WorldBankMCPClient` pattern.\n *\n * Environment variables:\n * - `IMF_API_BASE_URL` — override base URL (default\n * `https://dataservices.imf.org/REST/SDMX_3.0`).\n * - `IMF_API_TIMEOUT_MS` — per-request timeout (default `30000`).\n *\n * Legacy env vars (`IMF_MCP_GATEWAY_URL`, `IMF_MCP_GATEWAY_API_KEY`,\n * `IMF_MCP_SERVER_PATH`) are no longer consulted — no gateway is needed\n * because the IMF SDMX 3.0 API is an unauthenticated public endpoint.\n */\n\nimport type { MCPToolResult, MCPClientOptions } from '../types/index.js';\n\n// ─── Defaults ────────────────────────────────────────────────────────────────\n\n/** Default base URL for the IMF SDMX 3.0 REST API. */\nconst DEFAULT_IMF_API_BASE_URL = 'https://dataservices.imf.org/REST/SDMX_3.0';\n\n/** Default per-request timeout (milliseconds). */\nconst DEFAULT_IMF_API_TIMEOUT_MS = 30_000;\n\n/** Fallback payload shape when an IMF call fails or the server is offline. */\nconst IMF_FALLBACK: MCPToolResult = {\n content: [{ type: 'text', text: '' }],\n};\n\n/**\n * Canonical list of \"virtual tools\" exposed by this client. The client no\n * longer talks to an MCP server, but the tool-name list is preserved so\n * it continues to serve as:\n *\n * 1. The content-validator fingerprint source (`IMF_STRONG_FINGERPRINTS`).\n * 2. The workflow probe's heartbeat identifiers.\n * 3. A drift guard against method additions: if a new helper method lands\n * here, `test/integration/mcp/imf-mcp.test.js` fails unless the list\n * and the test are updated in lock-step.\n *\n * Kept in sync with `analysis/methodologies/imf-indicator-mapping.md`.\n */\nexport const IMF_MCP_TOOLS: readonly string[] = [\n 'imf-list-databases',\n 'imf-search-databases',\n 'imf-get-parameter-defs',\n 'imf-get-parameter-codes',\n 'imf-fetch-data',\n];\n\n// ─── Client options ──────────────────────────────────────────────────────────\n\n/**\n * Options accepted by {@link IMFMCPClient}. Shape intentionally matches\n * {@link MCPClientOptions} for historical compatibility — fields unused by\n * the native HTTP transport (`serverPath`, `gatewayUrl`, `gatewayApiKey`,\n * `maxConnectionAttempts`, `connectionRetryDelay`) are accepted and\n * silently ignored so existing call-sites do not break.\n */\nexport interface IMFClientOptions extends MCPClientOptions {\n /** Override the IMF REST base URL (default: {@link DEFAULT_IMF_API_BASE_URL}). */\n apiBaseUrl?: string;\n /** Per-request timeout in milliseconds (default: {@link DEFAULT_IMF_API_TIMEOUT_MS}). */\n timeoutMs?: number;\n /** Optional `fetch` implementation injection for testing. */\n fetchImpl?: typeof fetch;\n}\n\n// ─── SDMX 3.0 response narrow types (only the fields we consume) ─────────────\n\ninterface SDMXCategoryReference {\n id?: string;\n name?: string | Record;\n description?: string | Record;\n}\n\ninterface SDMXDataflowListResponse {\n data?: {\n dataflows?: SDMXCategoryReference[];\n };\n}\n\ninterface SDMXDimensionValue {\n id: string;\n name?: string | Record;\n}\n\ninterface SDMXDimension {\n id: string;\n name?: string | Record;\n localRepresentation?: {\n enumeration?: string;\n };\n values?: SDMXDimensionValue[];\n}\n\ninterface SDMXDataStructureResponse {\n data?: {\n dataStructures?: Array<{\n id?: string;\n dataStructureComponents?: {\n dimensionList?: { dimensions?: SDMXDimension[] };\n };\n }>;\n codelists?: Array<{\n id?: string;\n codes?: SDMXDimensionValue[];\n }>;\n };\n}\n\n// ─── Utilities ───────────────────────────────────────────────────────────────\n\n/**\n * Unwrap SDMX localised labels to a plain string.\n *\n * SDMX 3.0 sometimes returns `name`/`description` as a language-keyed\n * object (`{ en: \"World Economic Outlook\" }`); older payloads return a\n * raw string. Prefer English, fall back to the first available value.\n *\n * @param raw - Raw label (string, locale object, or undefined).\n * @returns Plain string (empty when no label is available).\n * @internal\n */\nfunction unwrapLocalisedLabel(raw: string | Record | undefined): string {\n if (!raw) return '';\n if (typeof raw === 'string') return raw;\n if (typeof raw['en'] === 'string') return raw['en'];\n for (const v of Object.values(raw)) {\n if (typeof v === 'string') return v;\n }\n return '';\n}\n\n/**\n * Wrap a JSON-serialisable value in the canonical MCP tool-result shape\n * so consumers that already expect `response.content[0]?.text` to hold a\n * JSON blob keep working without change.\n *\n * @param payload - Serialisable payload (object, array, or already-stringified JSON).\n * @returns MCP tool-result envelope with a single text content item.\n * @internal\n */\nfunction wrapAsMCPResult(payload: unknown): MCPToolResult {\n const text = typeof payload === 'string' ? payload : JSON.stringify(payload ?? null);\n return { content: [{ type: 'text', text }] };\n}\n\n/**\n * Simple value-encoder for SDMX URL dimension components. SDMX uses `+`\n * to join alternative codes inside a single dimension slot and `.` as\n * the dimension separator, so the value must be URI-encoded first to\n * avoid collisions with user-supplied codes that happen to contain\n * those characters.\n *\n * @param codes - Ordered code values for a single dimension (may be empty = wildcard).\n * @returns URL-safe dimension component (`\"\"` for wildcard, `\"A+B\"` for union).\n * @internal\n */\nfunction encodeSDMXDimension(codes: readonly string[]): string {\n return codes.map((c) => encodeURIComponent(c)).join('+');\n}\n\n/**\n * Build an SDMX key from a filters map + declared dimension order.\n *\n * If a declared dimension is absent from `filters`, the slot is left as\n * the wildcard (empty string). Extra filter keys not present in the\n * declared order are ignored — the caller is expected to have discovered\n * the correct dimension names via {@link IMFMCPClient.getParameterDefs}.\n *\n * @param dimensions - Declared dimension order (e.g. `[\"country\",\"indicator\",\"frequency\"]`).\n * @param filters - Map of dimension → selected codes.\n * @returns SDMX key (e.g. `\"DEU.NGDP_RPCH.A\"`).\n * @internal\n */\nfunction buildSDMXKey(\n dimensions: readonly string[],\n filters: Readonly>\n): string {\n return dimensions\n .map((dim) => {\n const codes = filters[dim];\n return Array.isArray(codes) ? encodeSDMXDimension(codes) : '';\n })\n .join('.');\n}\n\n/**\n * Infer the dimension order for a given dataflow when\n * {@link IMFMCPClient.getParameterDefs} has not been called yet. Used as a\n * fallback because the WEO datastructure in particular is so widely used\n * that encoding a well-known default eliminates one round-trip per fetch.\n *\n * Order mirrors the conventional `{country}.{indicator}.{frequency}`\n * layout documented on the IMF Data Services pages.\n *\n * @param databaseId - Dataflow identifier (case-insensitive).\n * @returns Default dimension order used when the caller omits it.\n * @internal\n */\nfunction defaultDimensionOrder(databaseId: string): readonly string[] {\n switch (databaseId.toUpperCase()) {\n case 'WEO':\n case 'FM':\n return ['country', 'indicator', 'frequency'];\n case 'IFS':\n case 'CPI':\n return ['frequency', 'country', 'indicator'];\n case 'BOP_AGG':\n case 'ER':\n case 'PCPS':\n return ['frequency', 'country', 'indicator'];\n default:\n return ['country', 'indicator', 'frequency'];\n }\n}\n\n// ─── Client ──────────────────────────────────────────────────────────────────\n\n/**\n * Native TypeScript client for the IMF SDMX 3.0 REST API.\n *\n * Despite the historical class name, no MCP server process is involved —\n * the class keeps the name `IMFMCPClient` purely to avoid breaking the\n * existing import surface (`src/index.ts`, test suites, documentation).\n * New code is welcome to import it as `IMFClient` (alias below).\n */\nexport class IMFMCPClient {\n private readonly _apiBaseUrl: string;\n private readonly _timeoutMs: number;\n private readonly _fetchImpl: typeof fetch;\n private _connected = false;\n\n constructor(options: IMFClientOptions = {}) {\n const envBase = process.env['IMF_API_BASE_URL'];\n const envTimeout = process.env['IMF_API_TIMEOUT_MS'];\n const parsedEnvTimeout =\n envTimeout !== undefined && envTimeout !== '' ? Number.parseInt(envTimeout, 10) : Number.NaN;\n const base =\n options.apiBaseUrl ?? (envBase && envBase !== '' ? envBase : DEFAULT_IMF_API_BASE_URL);\n // Strip trailing slashes without a regex so the CodeQL polynomial-ReDoS\n // detector has nothing to flag. Single linear pass from the right.\n let end = base.length;\n while (end > 0 && base.charCodeAt(end - 1) === 47 /* '/' */) {\n end -= 1;\n }\n this._apiBaseUrl = end === base.length ? base : base.slice(0, end);\n this._timeoutMs =\n options.timeoutMs !== undefined && Number.isFinite(options.timeoutMs) && options.timeoutMs > 0\n ? options.timeoutMs\n : Number.isFinite(parsedEnvTimeout) && parsedEnvTimeout > 0\n ? parsedEnvTimeout\n : DEFAULT_IMF_API_TIMEOUT_MS;\n this._fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);\n }\n\n /**\n * Base URL currently in use (read-only — set at construction time).\n *\n * @returns The fully-qualified IMF SDMX base URL (no trailing slash).\n */\n getApiBaseUrl(): string {\n return this._apiBaseUrl;\n }\n\n /**\n * Per-request timeout in milliseconds.\n *\n * @returns The timeout currently applied to every `fetch()` call.\n */\n getTimeoutMs(): number {\n return this._timeoutMs;\n }\n\n /**\n * Mark the client as ready. HTTP is stateless so there is no real\n * connection, but callers historically invoke `connect()` before use —\n * this is preserved for API compatibility and also exercises the\n * base URL to catch misconfiguration early.\n *\n * @returns A resolved promise; never throws for valid URLs.\n */\n async connect(): Promise {\n try {\n // Validate the base URL shape without making a network request so\n // construction-time errors surface immediately.\n new URL(this._apiBaseUrl);\n this._connected = true;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n throw new Error(`Invalid IMF_API_BASE_URL \"${this._apiBaseUrl}\": ${message}`, {\n cause: error,\n });\n }\n }\n\n /**\n * Whether {@link connect} has been called successfully.\n *\n * @returns `true` after a successful {@link connect}; reset by {@link disconnect}.\n */\n isConnected(): boolean {\n return this._connected;\n }\n\n /** Reset the connected flag. No real socket to close. */\n disconnect(): void {\n this._connected = false;\n }\n\n /**\n * List every IMF database (dataflow) exposed by the SDMX 3.0 API.\n *\n * Virtual tool: `imf-list-databases`.\n *\n * @returns MCP-shaped result whose `content[0].text` carries a JSON\n * array of `{ id, name, description }` entries. Empty on error.\n */\n async listDatabases(): Promise {\n try {\n const json = await this._getJSON('/dataflow/IMF');\n const flows = json?.data?.dataflows ?? [];\n const rows = flows.map((f) => ({\n id: f.id ?? '',\n name: unwrapLocalisedLabel(f.name),\n description: unwrapLocalisedLabel(f.description),\n }));\n return wrapAsMCPResult(rows);\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn('imf-list-databases not available:', message);\n return IMF_FALLBACK;\n }\n }\n\n /**\n * Search IMF databases by free-text keyword (case-insensitive\n * substring match against id / name / description).\n *\n * Virtual tool: `imf-search-databases`. Runs client-side over the\n * full dataflow list so a single SDMX round-trip serves every\n * keyword query in a workflow run.\n *\n * @param keyword - Free-text keyword (e.g. `\"inflation\"`, `\"trade\"`).\n * @returns Filtered list in MCP-shaped result; empty on error or when keyword is blank.\n */\n async searchDatabases(keyword: string): Promise {\n if (!keyword) {\n console.warn('imf-search-databases called without a keyword');\n return IMF_FALLBACK;\n }\n try {\n const json = await this._getJSON('/dataflow/IMF');\n const flows = json?.data?.dataflows ?? [];\n const needle = keyword.toLowerCase();\n const rows = flows\n .map((f) => ({\n id: f.id ?? '',\n name: unwrapLocalisedLabel(f.name),\n description: unwrapLocalisedLabel(f.description),\n }))\n .filter((r) => {\n const hay = `${r.id} ${r.name} ${r.description}`.toLowerCase();\n return hay.includes(needle);\n });\n return wrapAsMCPResult(rows);\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn('imf-search-databases not available:', message);\n return IMF_FALLBACK;\n }\n }\n\n /**\n * Fetch the dimension (parameter) definitions for a specific IMF\n * dataflow. Essential before building an SDMX key for\n * {@link fetchData} because each database has its own dimension set.\n *\n * Virtual tool: `imf-get-parameter-defs`.\n *\n * @param databaseId - IMF dataflow identifier (e.g. `\"WEO\"`, `\"IFS\"`).\n * @returns MCP-shaped result whose `content[0].text` carries the\n * ordered list of dimensions (`[{ id, name }]`). Empty on error.\n */\n async getParameterDefs(databaseId: string): Promise {\n if (!databaseId) {\n console.warn('imf-get-parameter-defs called without databaseId');\n return IMF_FALLBACK;\n }\n try {\n const json = await this._getJSON(\n `/datastructure/${encodeURIComponent(databaseId)}`\n );\n const ds = json?.data?.dataStructures?.[0];\n const dims = ds?.dataStructureComponents?.dimensionList?.dimensions ?? [];\n const rows = dims.map((d) => ({ id: d.id, name: unwrapLocalisedLabel(d.name) }));\n return wrapAsMCPResult(rows);\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn('imf-get-parameter-defs not available:', message);\n return IMF_FALLBACK;\n }\n }\n\n /**\n * List valid codes for a single dimension of an IMF dataflow, with\n * an optional free-text filter to narrow the result.\n *\n * Virtual tool: `imf-get-parameter-codes`. The underlying SDMX\n * `/codelist/` endpoint is used, looked up from the datastructure so\n * the caller does not need to know the codelist identifier ahead of\n * time.\n *\n * @param databaseId - IMF dataflow identifier.\n * @param parameter - Dimension name (e.g. `\"country\"`, `\"indicator\"`).\n * @param search - Optional free-text search (case-insensitive substring).\n * @returns MCP-shaped result with `[{ id, name }]` rows; empty on error.\n */\n async getParameterCodes(\n databaseId: string,\n parameter: string,\n search?: string\n ): Promise {\n if (!databaseId || !parameter) {\n console.warn('imf-get-parameter-codes requires databaseId and parameter');\n return IMF_FALLBACK;\n }\n try {\n // 1. Discover the codelist id for the requested dimension.\n const structure = await this._getJSON(\n `/datastructure/${encodeURIComponent(databaseId)}?references=codelist`\n );\n const ds = structure?.data?.dataStructures?.[0];\n const dims = ds?.dataStructureComponents?.dimensionList?.dimensions ?? [];\n const dim = dims.find((d) => d.id.toLowerCase() === parameter.toLowerCase());\n if (!dim) {\n return wrapAsMCPResult([]);\n }\n // The SDMX codelist reference URN looks like\n // \"urn:sdmx:org.sdmx.infomodel.codelist.Codelist=IMF:CL_AREA(1.0)\"\n // We only need the codelist id — use string-split parsing\n // (no regex) so the static-analysis \"unsafe regex\" detector has\n // nothing to object to and the extraction stays obviously linear.\n let codelistId: string | undefined = dim.localRepresentation?.enumeration;\n if (codelistId) {\n const afterEquals = codelistId.includes('=')\n ? (codelistId.split('=')[1] ?? '')\n : codelistId;\n const beforeParen = afterEquals.split('(')[0] ?? '';\n const parts = beforeParen.split(':');\n codelistId = (parts[parts.length - 1] ?? beforeParen).trim() || codelistId;\n }\n // Some payloads inline the values directly; prefer those when present.\n let codes: SDMXDimensionValue[] = dim.values ?? [];\n if (codes.length === 0 && codelistId) {\n const cl = structure?.data?.codelists?.find((c) => c.id === codelistId);\n codes = cl?.codes ?? [];\n }\n const needle = (search ?? '').toLowerCase();\n const rows = codes\n .map((c) => ({ id: c.id, name: unwrapLocalisedLabel(c.name) }))\n .filter((r) => {\n if (!needle) return true;\n return `${r.id} ${r.name}`.toLowerCase().includes(needle);\n });\n return wrapAsMCPResult(rows);\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn('imf-get-parameter-codes not available:', message);\n return IMF_FALLBACK;\n }\n }\n\n /**\n * Fetch a time-series slice from an IMF dataflow as SDMX-JSON.\n *\n * Virtual tool: `imf-fetch-data`. The response is already in SDMX-JSON\n * format, so {@link parseSDMXJSON} (`src/utils/imf-data.ts`) can\n * consume `response.content[0]?.text` directly without reshaping.\n *\n * @param options - Fetch parameters.\n * @param options.databaseId - IMF dataflow ID (`\"WEO\"`, `\"IFS\"`, ...).\n * @param options.startYear - Inclusive start year (e.g. `2015`).\n * @param options.endYear - Inclusive end year (e.g. `2030` for WEO forecasts).\n * @param options.filters - Map of dimension → selected codes.\n * @param options.dimensionOrder - Optional override of the dimension order\n * used to build the SDMX key. Defaults to\n * {@link defaultDimensionOrder} for the database.\n * @returns MCP-shaped result whose `content[0].text` carries the raw\n * SDMX-JSON response. Empty on error or invalid inputs.\n */\n async fetchData(options: {\n databaseId: string;\n startYear: number;\n endYear: number;\n filters: Readonly>;\n dimensionOrder?: readonly string[];\n }): Promise {\n const { databaseId, startYear, endYear, filters, dimensionOrder } = options;\n if (!databaseId || !filters || Object.keys(filters).length === 0) {\n console.warn('imf-fetch-data requires databaseId and a non-empty filters map');\n return IMF_FALLBACK;\n }\n if (!Number.isFinite(startYear) || !Number.isFinite(endYear) || endYear < startYear) {\n console.warn(`imf-fetch-data invalid year range: ${startYear}-${endYear}`);\n return IMF_FALLBACK;\n }\n try {\n const dims = dimensionOrder ?? defaultDimensionOrder(databaseId);\n const key = buildSDMXKey(dims, filters);\n const qs = new URLSearchParams({\n startPeriod: String(startYear),\n endPeriod: String(endYear),\n format: 'jsondata',\n });\n const url = `/data/${encodeURIComponent(databaseId)}/${key}?${qs.toString()}`;\n const text = await this._getText(url);\n return wrapAsMCPResult(text);\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n console.warn('imf-fetch-data not available:', message);\n return IMF_FALLBACK;\n }\n }\n\n // ─── private transport helpers ─────────────────────────────────────────────\n\n /**\n * Build a full URL and GET it as text, enforcing the client-wide timeout.\n *\n * @param path - Path (already URL-encoded) to append to the base URL.\n * @returns Response body (`text/*` or `application/*`) as a string.\n * @throws When the HTTP status is not 2xx, the request times out, or\n * the network layer raises.\n * @internal\n */\n private async _getText(path: string): Promise {\n const url = `${this._apiBaseUrl}${path.startsWith('/') ? path : `/${path}`}`;\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), this._timeoutMs);\n try {\n const response = await this._fetchImpl(url, {\n method: 'GET',\n headers: { Accept: 'application/json' },\n signal: controller.signal,\n });\n if (!response.ok) {\n throw new Error(`HTTP ${response.status} ${response.statusText} for ${url}`);\n }\n return await response.text();\n } finally {\n clearTimeout(timer);\n }\n }\n\n /**\n * GET a URL and parse the response body as JSON.\n *\n * @template T - Narrow response type declared by the caller.\n * @param path - Path to append to the base URL.\n * @returns Parsed JSON value.\n * @throws When the response is not JSON, not 2xx, or the request fails.\n * @internal\n */\n private async _getJSON(path: string): Promise {\n const raw = await this._getText(path);\n try {\n return JSON.parse(raw) as T;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n throw new Error(`Failed to parse IMF response as JSON: ${message}`, { cause: error });\n }\n }\n}\n\n/**\n * Forward-looking alias for {@link IMFMCPClient}. New code should prefer\n * `IMFClient`; the `IMFMCPClient` name is retained for backward\n * compatibility with the MCP-backed iteration shipped in Wave 1.\n */\nexport const IMFClient = IMFMCPClient;\n\n// ─── Singleton lifecycle ─────────────────────────────────────────────────────\n\n/** Singleton instance, created lazily by {@link getIMFMCPClient}. */\nlet imfClientInstance: IMFMCPClient | null = null;\n\n/**\n * Get or create the singleton IMF client, validating the base URL on\n * first use. Subsequent calls return the cached instance.\n *\n * @param options - Client options (override env vars and defaults).\n * @returns Connected singleton client.\n * @throws When the base URL is malformed (e.g. missing protocol).\n */\nexport async function getIMFMCPClient(options: IMFClientOptions = {}): Promise {\n if (!imfClientInstance) {\n const client = new IMFMCPClient(options);\n try {\n await client.connect();\n imfClientInstance = client;\n } catch (error) {\n imfClientInstance = null;\n throw error;\n }\n }\n return imfClientInstance;\n}\n\n/** Close and clear the singleton instance (idempotent). */\nexport async function closeIMFMCPClient(): Promise {\n if (imfClientInstance) {\n imfClientInstance.disconnect();\n imfClientInstance = null;\n }\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/mcp/mcp-connection.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/mcp/mcp-health.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/mcp/mcp-retry.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/mcp/wb-mcp-client.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/templates/article-template.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":260,"column":25,"endLine":260,"endColumn":49},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":429,"column":41,"endLine":429,"endColumn":60},{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":613,"column":20,"endLine":613,"endColumn":44},{"ruleId":"security/detect-object-injection","severity":1,"message":"Variable Assigned to Object Injection Sink","line":768,"column":25,"endLine":768,"endColumn":48}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":4,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Templates/ArticleTemplate\n * @description Generates HTML templates for news articles with proper structure and metadata\n */\n\nimport type {\n ArticleOptions,\n ArticleSource,\n ArticleCategoryLabels,\n LanguageCode,\n RelatedArticleLink,\n AnalysisFileEntry,\n LanguageMap,\n} from '../types/index.js';\nimport {\n ALL_LANGUAGES,\n LANGUAGE_FLAGS,\n LANGUAGE_NAMES,\n ARTICLE_TYPE_LABELS,\n READ_TIME_LABELS,\n BACK_TO_NEWS_LABELS,\n ARTICLE_NAV_LABELS,\n RELATED_ARTICLES_NAV_LABELS,\n BREADCRUMB_HOME_LABELS,\n BREADCRUMB_NEWS_LABELS,\n SKIP_LINK_TEXTS,\n SOURCES_HEADING_LABELS,\n HEADER_SUBTITLE_LABELS,\n THEME_TOGGLE_LABELS,\n ANALYSIS_TRANSPARENCY_LABELS,\n ANALYSIS_SUMMARY_LABELS,\n METHODOLOGY_LABELS,\n TRANSPARENCY_DISCLOSURE_LABELS,\n CLASSIFICATION_ANALYSIS_LABELS,\n THREAT_ASSESSMENT_LABELS,\n RISK_SCORING_LABELS,\n DEEP_ANALYSIS_LABELS,\n VIEW_SOURCE_LABELS,\n OPEN_SOURCE_NOTE_LABELS,\n AI_ANALYSIS_GUIDE_LABELS,\n SWOT_FRAMEWORK_LABELS,\n RISK_METHODOLOGY_LABELS,\n THREAT_FRAMEWORK_LABELS,\n CLASSIFICATION_GUIDE_LABELS,\n STYLE_GUIDE_LABELS,\n SIGNIFICANCE_CLASSIFICATION_LABELS,\n ACTOR_MAPPING_LABELS,\n FORCES_ANALYSIS_LABELS,\n IMPACT_MATRIX_LABELS,\n POLITICAL_THREAT_LANDSCAPE_LABELS,\n ACTOR_THREAT_PROFILING_LABELS,\n CONSEQUENCE_TREES_LABELS,\n LEGISLATIVE_DISRUPTION_LABELS,\n RISK_MATRIX_LABELS,\n QUANTITATIVE_SWOT_LABELS,\n POLITICAL_CAPITAL_RISK_LABELS,\n LEGISLATIVE_VELOCITY_RISK_LABELS,\n AGENT_RISK_WORKFLOW_LABELS,\n STAKEHOLDER_IMPACT_LABELS,\n COALITION_DYNAMICS_LABELS,\n VOTING_PATTERNS_LABELS,\n CROSS_SESSION_INTELLIGENCE_LABELS,\n SYNTHESIS_SUMMARY_LABELS,\n DOCUMENT_ANALYSIS_LABELS,\n SIGNIFICANCE_SCORING_LABELS,\n getLocalizedString,\n getTextDirection,\n} from '../constants/languages.js';\nimport { escapeHTML, isSafeURL } from '../utils/file-utils.js';\nimport { stripHtmlTags } from '../utils/html-sanitize.js';\nimport { createThemeToggleButton, APP_VERSION } from '../constants/config.js';\nimport { buildSiteFooter } from './section-builders.js';\n\n/** Pattern for valid article dates (YYYY-MM-DD) */\nconst DATE_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/u;\n\n/** Pattern for valid article slugs (lowercase letters, digits, hyphens) */\nconst SLUG_PATTERN = /^[a-z0-9-]+$/u;\n\n/** Pattern for valid SRI integrity hashes (sha256/sha384/sha512 + base64) */\nconst SRI_HASH_PATTERN = /^sha(?:256|384|512)-[A-Za-z0-9+/]+={0,2}$/u;\n\n/** Words per minute for read-time calculation */\nconst TEMPLATE_WORDS_PER_MINUTE = 250;\n\n/**\n * Serialize an object to JSON suitable for embedding inside `` or `\n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n ${(availableLanguages ?? ALL_LANGUAGES)\n .map(\n (code) =>\n ``\n )\n .join('\\n ')}\n \n \n \n \n \n \n \n \n\n\n
    \n ${skipLinkText}\n\n
    \n
    \n \n \n \n \n \n \n EU Parliament Monitor\n ${headerSubtitle}\n \n \n ${createThemeToggleButton(themeToggleLabel)}\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n
    \n ${safeCategoryLabel}\n ${displayDate}\n ${readTimeLabel}\n ${languageName}\n
    \n

    ${safeTitle}

    \n

    ${safeSubtitle}

    \n
    \n \n ${content}\n \n ${renderSourcesSection(sources, lang)}\n \n ${renderAnalysisTransparencySection(date, slug, lang, analysisDir, analysisFiles)}\n \n ${relatedArticlesHtml}\n \n \n
    \n
    \n\n ${buildSiteFooter({ lang, pathPrefix: '../' })}\n\n ${\n content.includes('data-chart-config')\n ? `\n \n \n `\n : ''\n }${\n content.includes('mindmap-container') || content.includes('swot-matrix')\n ? `\n \n `\n : ''\n }\n\n`;\n}\n\n/**\n * Render the sources section if sources are provided\n *\n * @param sources - Article source references\n * @param lang - Language code for localized heading\n * @returns HTML string for sources section or empty string\n */\nfunction renderSourcesSection(sources: ArticleSource[], lang: LanguageCode): string {\n if (sources.length === 0) {\n return '';\n }\n\n const sourcesHeading = escapeHTML(getLocalizedString(SOURCES_HEADING_LABELS, lang));\n return `\n
    \n

    ${sourcesHeading}

    \n
      \n ${sources\n .map((source) => {\n const safeSourceTitle = escapeHTML(source.title);\n const href = isSafeURL(source.url) ? escapeHTML(source.url) : '#';\n return `
    • ${safeSourceTitle}
      • `;\n })\n .join('\\n ')}\n
    \n
    \n `;\n}\n\n/**\n * Map of analysis method names to their localized label constants.\n * Used by renderAnalysisTransparencySection to resolve display names.\n */\nconst METHOD_LABEL_MAP: Readonly> = {\n 'significance-classification': SIGNIFICANCE_CLASSIFICATION_LABELS,\n 'significance-scoring': SIGNIFICANCE_SCORING_LABELS,\n 'actor-mapping': ACTOR_MAPPING_LABELS,\n 'forces-analysis': FORCES_ANALYSIS_LABELS,\n 'impact-matrix': IMPACT_MATRIX_LABELS,\n 'political-threat-landscape': POLITICAL_THREAT_LANDSCAPE_LABELS,\n 'actor-threat-profiling': ACTOR_THREAT_PROFILING_LABELS,\n 'consequence-trees': CONSEQUENCE_TREES_LABELS,\n 'legislative-disruption': LEGISLATIVE_DISRUPTION_LABELS,\n 'risk-matrix': RISK_MATRIX_LABELS,\n 'quantitative-swot': QUANTITATIVE_SWOT_LABELS,\n 'political-capital-risk': POLITICAL_CAPITAL_RISK_LABELS,\n 'legislative-velocity-risk': LEGISLATIVE_VELOCITY_RISK_LABELS,\n 'agent-risk-workflow': AGENT_RISK_WORKFLOW_LABELS,\n 'deep-analysis': DEEP_ANALYSIS_LABELS,\n 'stakeholder-analysis': STAKEHOLDER_IMPACT_LABELS,\n 'coalition-analysis': COALITION_DYNAMICS_LABELS,\n 'voting-patterns': VOTING_PATTERNS_LABELS,\n 'cross-session-intelligence': CROSS_SESSION_INTELLIGENCE_LABELS,\n 'synthesis-summary': SYNTHESIS_SUMMARY_LABELS,\n 'document-analysis': DOCUMENT_ANALYSIS_LABELS,\n};\n\n/**\n * Map of analysis subdirectory names to their section heading label constants\n * and display emoji.\n */\nconst SUBDIR_SECTION_MAP: Readonly> = {\n classification: { labels: CLASSIFICATION_ANALYSIS_LABELS, emoji: '🏷️' },\n 'threat-assessment': { labels: THREAT_ASSESSMENT_LABELS, emoji: '🛡️' },\n 'risk-scoring': { labels: RISK_SCORING_LABELS, emoji: '⚖️' },\n existing: { labels: DEEP_ANALYSIS_LABELS, emoji: '🔍' },\n documents: { labels: DOCUMENT_ANALYSIS_LABELS, emoji: '📄' },\n};\n\n/**\n * Resolve the localized display label for an analysis method.\n *\n * @param method - Canonical method name\n * @param lang - Language code\n * @returns Localized and HTML-escaped label, or titleized method name as fallback\n */\nfunction getMethodLabel(method: string, lang: LanguageCode): string {\n const labelMap = METHOD_LABEL_MAP[method];\n if (labelMap) {\n return escapeHTML(getLocalizedString(labelMap, lang));\n }\n // Fallback: titleize the method name (e.g. 'political-stride' → 'Political Stride')\n return escapeHTML(method.replace(/-/gu, ' ').replace(/\\b\\w/gu, (c) => c.toUpperCase()));\n}\n\n/**\n * Render the analysis transparency section with links to analysis artifacts and methodology.\n *\n * When `analysisFiles` is provided (from manifest.json), links are generated dynamically\n * for ALL analysis files produced during the run — including document-analysis per-document\n * files, synthesis summaries, and any additional methods. This ensures every article links\n * to the exact analysis that produced it.\n *\n * When `analysisFiles` is not available (legacy/fallback), a hardcoded set of standard\n * analysis file links is rendered.\n *\n * @param date - Article date (YYYY-MM-DD)\n * @param slug - Article type slug (e.g., 'committee-reports', 'breaking')\n * @param lang - Language code\n * @param analysisDir - Optional override for analysis directory name (e.g. 'breaking-2' after deduplication)\n * @param analysisFiles - Optional manifest-derived file entries for dynamic link generation\n * @returns HTML string for analysis transparency section\n */\nexport function renderAnalysisTransparencySection(\n date: string,\n slug: string,\n lang: LanguageCode,\n analysisDir?: string | undefined,\n analysisFiles?: ReadonlyArray | undefined\n): string {\n const safeDate = escapeHTML(date);\n const safeAnalysisDirName = escapeHTML(analysisDir ?? slug);\n const heading = escapeHTML(getLocalizedString(ANALYSIS_TRANSPARENCY_LABELS, lang));\n const analysisSummaryLabel = escapeHTML(getLocalizedString(ANALYSIS_SUMMARY_LABELS, lang));\n const methodologyLabel = escapeHTML(getLocalizedString(METHODOLOGY_LABELS, lang));\n const disclosure = escapeHTML(getLocalizedString(TRANSPARENCY_DISCLOSURE_LABELS, lang));\n const viewSourceLabel = escapeHTML(getLocalizedString(VIEW_SOURCE_LABELS, lang));\n const openSourceNote = escapeHTML(getLocalizedString(OPEN_SOURCE_NOTE_LABELS, lang));\n const aiGuideLabel = escapeHTML(getLocalizedString(AI_ANALYSIS_GUIDE_LABELS, lang));\n const swotLabel = escapeHTML(getLocalizedString(SWOT_FRAMEWORK_LABELS, lang));\n const riskMethodLabel = escapeHTML(getLocalizedString(RISK_METHODOLOGY_LABELS, lang));\n const threatFrameworkLabel = escapeHTML(getLocalizedString(THREAT_FRAMEWORK_LABELS, lang));\n const classGuideLabel = escapeHTML(getLocalizedString(CLASSIFICATION_GUIDE_LABELS, lang));\n const styleGuideLabel = escapeHTML(getLocalizedString(STYLE_GUIDE_LABELS, lang));\n\n const repoBase = 'https://github.com/Hack23/euparliamentmonitor/blob/main';\n const treeDirBase = 'https://github.com/Hack23/euparliamentmonitor/tree/main';\n const analysisDirUrl = `${treeDirBase}/analysis/daily/${safeDate}/${safeAnalysisDirName}`;\n const analysisFileBase = `${repoBase}/analysis/daily/${safeDate}/${safeAnalysisDirName}`;\n const methodologyDir = `${repoBase}/analysis/methodologies`;\n\n // Build the analysis links section — dynamic from manifest or hardcoded fallback\n const analysisLinksHtml =\n analysisFiles && analysisFiles.length > 0\n ? renderDynamicAnalysisLinks(analysisFiles, analysisFileBase, lang)\n : renderFallbackAnalysisLinks(analysisFileBase, lang);\n\n return `\n
    \n

    ${heading}

    \n

    ${disclosure}

    \n \n \n

    🔓 ${viewSourceLabel} — ${openSourceNote}

    \n
    \n `;\n}\n\n/**\n * Validate that an analysis output file path is safe for use in URLs.\n *\n * Rejects absolute paths, path traversal (`..`), backslashes, and any\n * characters outside the expected alphanumeric + hyphen + slash + dot + underscore set.\n *\n * @param outputFile - Relative path from manifest (e.g. 'classification/significance-classification.md')\n * @returns true if the path is safe to interpolate into a URL\n */\nfunction isSafeAnalysisPath(outputFile: string): boolean {\n if (!outputFile || outputFile.length === 0 || outputFile.length > 256) return false;\n // Reject path traversal, absolute paths, backslashes, and consecutive slashes\n if (/\\.\\.|[\\\\]|^[/]|\\/\\//u.test(outputFile)) return false;\n // Only allow safe characters: alphanumeric, hyphens, underscores, dots, forward slashes\n return /^[\\da-zA-Z][\\da-zA-Z._/-]*$/u.test(outputFile);\n}\n\n/**\n * Render dynamic analysis links from manifest entries, grouped by subdirectory.\n *\n * @param files - Analysis file entries from the manifest\n * @param analysisFileBase - Base URL for analysis file links\n * @param lang - Language code for localized labels\n * @returns HTML string for the grouped analysis links\n */\nfunction renderDynamicAnalysisLinks(\n files: ReadonlyArray,\n analysisFileBase: string,\n lang: LanguageCode\n): string {\n // Filter out entries with unsafe paths (path traversal, absolute, backslashes)\n const safeFiles = files.filter((f) => isSafeAnalysisPath(f.outputFile));\n\n // Group files by their subdirectory (first path segment)\n const groups = new Map();\n for (const file of safeFiles) {\n const slashIdx = file.outputFile.indexOf('/');\n const subdir = slashIdx > 0 ? file.outputFile.slice(0, slashIdx) : '';\n const key = subdir || '_root';\n const group = groups.get(key);\n if (group) {\n group.push(file);\n } else {\n groups.set(key, [file]);\n }\n }\n\n // Known ordering for subdirectories\n const orderedSubdirs = [\n 'classification',\n 'threat-assessment',\n 'risk-scoring',\n 'existing',\n 'documents',\n ];\n const sortedKeys = [\n ...orderedSubdirs.filter((k) => groups.has(k)),\n ...[...groups.keys()].filter((k) => k !== '_root' && !orderedSubdirs.includes(k)),\n ...(groups.has('_root') ? ['_root'] : []),\n ];\n\n const sections: string[] = [];\n\n for (const key of sortedKeys) {\n const groupFiles = groups.get(key);\n if (!groupFiles || groupFiles.length === 0) continue;\n\n const sectionInfo = SUBDIR_SECTION_MAP[key];\n const sectionHeading = sectionInfo\n ? escapeHTML(getLocalizedString(sectionInfo.labels, lang))\n : escapeHTML(key.replace(/-/gu, ' ').replace(/\\b\\w/gu, (c) => c.toUpperCase()));\n const emoji = sectionInfo?.emoji ?? '📋';\n\n const items = groupFiles.map((f) => {\n const label = getMethodLabel(f.method, lang);\n // URL-encode each path segment to prevent URL injection\n const encodedFile = f.outputFile\n .split('/')\n .map((seg) => encodeURIComponent(seg))\n .join('/');\n return `
  • ${label}
    • `;\n });\n\n sections.push(`

    ${emoji} ${sectionHeading}

    \n
      \n${items.join('\\n')}\n
    `);\n }\n\n return sections.join('\\n');\n}\n\n/**\n * Render the legacy hardcoded analysis links for when no manifest data is available.\n *\n * @param analysisFileBase - Base URL for analysis file links\n * @param lang - Language code for localized labels\n * @returns HTML string for the hardcoded analysis links\n */\nfunction renderFallbackAnalysisLinks(analysisFileBase: string, lang: LanguageCode): string {\n const classificationLabel = escapeHTML(getLocalizedString(CLASSIFICATION_ANALYSIS_LABELS, lang));\n const threatLabel = escapeHTML(getLocalizedString(THREAT_ASSESSMENT_LABELS, lang));\n const riskLabel = escapeHTML(getLocalizedString(RISK_SCORING_LABELS, lang));\n const deepLabel = escapeHTML(getLocalizedString(DEEP_ANALYSIS_LABELS, lang));\n const documentLabel = escapeHTML(getLocalizedString(DOCUMENT_ANALYSIS_LABELS, lang));\n\n const significanceLabel = escapeHTML(\n getLocalizedString(SIGNIFICANCE_CLASSIFICATION_LABELS, lang)\n );\n const significanceScoringLabel = escapeHTML(\n getLocalizedString(SIGNIFICANCE_SCORING_LABELS, lang)\n );\n const actorMappingLabel = escapeHTML(getLocalizedString(ACTOR_MAPPING_LABELS, lang));\n const forcesLabel = escapeHTML(getLocalizedString(FORCES_ANALYSIS_LABELS, lang));\n const impactMatrixLabel = escapeHTML(getLocalizedString(IMPACT_MATRIX_LABELS, lang));\n const threatLandscapeLabel = escapeHTML(\n getLocalizedString(POLITICAL_THREAT_LANDSCAPE_LABELS, lang)\n );\n const actorThreatProfilingLabel = escapeHTML(\n getLocalizedString(ACTOR_THREAT_PROFILING_LABELS, lang)\n );\n const consequenceLabel = escapeHTML(getLocalizedString(CONSEQUENCE_TREES_LABELS, lang));\n const disruptionLabel = escapeHTML(getLocalizedString(LEGISLATIVE_DISRUPTION_LABELS, lang));\n const riskMatrixLabel = escapeHTML(getLocalizedString(RISK_MATRIX_LABELS, lang));\n const quantSwotLabel = escapeHTML(getLocalizedString(QUANTITATIVE_SWOT_LABELS, lang));\n const politicalCapitalLabel = escapeHTML(getLocalizedString(POLITICAL_CAPITAL_RISK_LABELS, lang));\n const legVelocityLabel = escapeHTML(getLocalizedString(LEGISLATIVE_VELOCITY_RISK_LABELS, lang));\n const agentRiskLabel = escapeHTML(getLocalizedString(AGENT_RISK_WORKFLOW_LABELS, lang));\n const deepAnalysisFileLabel = escapeHTML(getLocalizedString(DEEP_ANALYSIS_LABELS, lang));\n const stakeholderLabel = escapeHTML(getLocalizedString(STAKEHOLDER_IMPACT_LABELS, lang));\n const coalitionLabel = escapeHTML(getLocalizedString(COALITION_DYNAMICS_LABELS, lang));\n const votingPatternsLabel = escapeHTML(getLocalizedString(VOTING_PATTERNS_LABELS, lang));\n const crossSessionLabel = escapeHTML(getLocalizedString(CROSS_SESSION_INTELLIGENCE_LABELS, lang));\n const synthesisSummaryLabel = escapeHTML(getLocalizedString(SYNTHESIS_SUMMARY_LABELS, lang));\n\n return `

    🏷️ ${classificationLabel}

    \n \n

    🛡️ ${threatLabel}

    \n \n

    ⚖️ ${riskLabel}

    \n \n

    🔍 ${deepLabel}

    \n \n

    📄 ${documentLabel}

    \n `;\n}\n","usedDeprecatedRules":[]},{"filePath":"/home/runner/work/euparliamentmonitor/euparliamentmonitor/src/templates/section-builders.ts","messages":[{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":288,"column":35,"endLine":288,"endColumn":44},{"ruleId":"security/detect-object-injection","severity":1,"message":"Generic Object Injection Sink","line":289,"column":34,"endLine":289,"endColumn":42}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":2,"fixableErrorCount":0,"fixableWarningCount":0,"source":"// SPDX-FileCopyrightText: 2024-2026 Hack23 AB\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @module Templates/SectionBuilders\n * @description Reusable section builder utilities for article template architecture.\n * Provides quality scoring, table of contents generation, quality badge rendering,\n * timeline sections, comparison tables, and key figures bars.\n */\n\nimport { escapeHTML } from '../utils/file-utils.js';\nimport type { ArticleQualityScore, TOCEntry, LanguageCode } from '../types/index.js';\nimport {\n ALL_LANGUAGES,\n LANGUAGE_FLAGS,\n LANGUAGE_NAMES,\n getLocalizedString,\n TOC_ARIA_LABELS,\n TIMELINE_HEADINGS,\n COMPARISON_BEFORE_LABELS,\n COMPARISON_AFTER_LABELS,\n KEY_FIGURES_HEADINGS,\n FOOTER_ABOUT_HEADING_LABELS,\n FOOTER_ABOUT_TEXT_LABELS,\n FOOTER_QUICK_LINKS_LABELS,\n FOOTER_BUILT_BY_LABELS,\n FOOTER_LANGUAGES_LABELS,\n FOOTER_HOME_LABELS,\n FOOTER_SITEMAP_LABELS,\n FOOTER_RSS_LABELS,\n FOOTER_GITHUB_REPO_LABELS,\n FOOTER_LICENSE_LABELS,\n FOOTER_EUROPARL_LABELS,\n FOOTER_LINKEDIN_LABELS,\n FOOTER_SECURITY_POLICY_LABELS,\n FOOTER_CONTACT_LABELS,\n FOOTER_DISCLAIMER_LABELS,\n FOOTER_REPORT_ISSUES_LABELS,\n FOOTER_ARTICLES_AVAILABLE_LABELS,\n} from '../constants/languages.js';\nimport { APP_VERSION } from '../constants/config.js';\nimport { stripScriptBlocks, stripHtmlTags } from '../utils/html-sanitize.js';\n\n// ─── New section builder interfaces ─────────────────────────────────────────\n\n/**\n * A single item in a legislative or procedural timeline.\n */\nexport interface TimelineItem {\n /** Date label (e.g. \"2026-03-15\" or human-readable) */\n date: string;\n /** Short event label */\n label: string;\n /** Optional extended description */\n description?: string | undefined;\n}\n\n/**\n * A numeric highlight figure for a key-figures bar.\n */\nexport interface KeyFigure {\n /** Descriptive label for the figure */\n label: string;\n /** Formatted value string (e.g. \"42\", \"78%\") */\n value: string;\n /** Optional unit suffix (e.g. \"votes\", \"days\", \"%\") */\n unit?: string | undefined;\n /** Optional longer description for screen readers / tooltips */\n description?: string | undefined;\n}\n\n/**\n * Count occurrences of a regex pattern in a string.\n *\n * @param content - String to search.\n * @param pattern - Global regex pattern to match.\n * @returns Number of matches found.\n */\nfunction countMatches(content: string, pattern: RegExp): number {\n const matches = content.match(pattern);\n return matches !== null ? matches.length : 0;\n}\n\n/**\n * Count elements whose `class` attribute contains a given CSS class token.\n *\n * Extracts every `class=\"…\"` attribute, splits the value into tokens, and\n * checks for an exact match — so `\"dashboard\"` will NOT match nested\n * classes like `\"dashboard-grid\"` or `\"dashboard-panel\"`.\n *\n * @param content - HTML string to search.\n * @param token - Exact CSS class name to look for.\n * @returns Number of elements that have the given class token.\n */\nfunction countClassToken(content: string, token: string): number {\n let count = 0;\n for (const m of content.matchAll(/class=\"([^\"]*)\"/g)) {\n const value = m[1] ?? '';\n if (value.split(/\\s+/).includes(token)) {\n count += 1;\n }\n }\n return count;\n}\n\n// stripScriptBlocks is imported from html-sanitize.ts\n\n/**\n * Compute an article quality score by analysing the rendered HTML content.\n *\n * @param content - Full HTML content string of the article body.\n * @returns {@link ArticleQualityScore} with word count, section counts, and overall rating.\n */\nexport function computeArticleQualityScore(content: string): ArticleQualityScore {\n // Remove script blocks before tag-stripping to avoid inflating word count.\n // Uses iterative scanning instead of regex to avoid CodeQL js/bad-tag-filter.\n const noScripts = stripScriptBlocks(content);\n // Strip HTML tags to get plain text, then count words\n const plainText = stripHtmlTags(noScripts).replace(/\\s+/g, ' ').trim();\n const wordCount =\n plainText.length > 0 ? plainText.split(' ').filter((w) => w.length > 0).length : 0;\n\n // All further counting uses script-stripped HTML to avoid false positives\n // from embedded JSON-LD or interactive script blocks.\n const totalSections = countMatches(noScripts, /= 800 && analysisSections >= 3 && visualizationCount >= 2) {\n overallScore = 'excellent';\n } else if (wordCount >= 500 && analysisSections >= 2) {\n overallScore = 'good';\n } else if (wordCount >= 200 && analysisSections >= 1) {\n overallScore = 'adequate';\n } else {\n overallScore = 'needs-improvement';\n }\n\n return { wordCount, analysisSections, visualizationCount, evidenceReferences, overallScore };\n}\n\n/**\n * Build an HTML table of contents navigation element from a list of entries.\n *\n * @param entries - Ordered list of {@link TOCEntry} items to render.\n * @param lang - Language code used for the localised aria-label.\n * @returns HTML string for the TOC `