euparliamentmonitor 0.9.1 → 0.9.2

package/README.md

@@ -136,7 +136,7 @@ The published site is the audience-facing companion to this npm/TypeScript packa
 
 **MCP Server Integration**: The project uses the
 [European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server)
-v1.3.0 for accessing real EU Parliament data via the Model Context Protocol.
+v1.3.2 for accessing real EU Parliament data via the Model Context Protocol.
 
 - **MCP Server Status**: ✅ Fully operational — 60+ EP data tools available
   (feeds, direct lookups, analytical tools, intelligence correlation)
@@ -432,7 +432,7 @@ import type { ArticleCategory, LanguageCode } from 'euparliamentmonitor/types';
 
 ## 🔌 Data Sources
 
-**Primary — European Parliament MCP Server** ([Hack23/European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server) v1.3.0+, fully operational):
+**Primary — European Parliament MCP Server** ([Hack23/European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server) v1.3.2+, fully operational):
 
 - 🗳️ Plenary sessions, voting records, roll-call votes
 - 📜 Adopted texts, motions, resolutions, urgency files

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -146,7 +146,7 @@
     "@playwright/test": "1.59.1",
     "@types/d3": "7.4.3",
     "@types/markdown-it": "^14.1.2",
-    "@types/node": "25.6.0",
+    "@types/node": "25.6.2",
     "@types/papaparse": "5.5.2",
     "@typescript-eslint/eslint-plugin": "8.59.2",
     "@typescript-eslint/parser": "8.59.2",
@@ -165,7 +165,7 @@
     "husky": "9.1.7",
     "jscpd": "4.0.9",
     "knip": "^6.7.0",
-    "lint-staged": "17.0.2",
+    "lint-staged": "17.0.3",
     "mermaid": "11.14.0",
     "papaparse": "5.5.3",
     "prettier": "3.8.3",
@@ -179,7 +179,7 @@
     "node": ">=26"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.3.0",
+    "european-parliament-mcp-server": "1.3.2",
     "markdown-it": "^14.1.1",
     "markdown-it-anchor": "^9.2.0",
     "markdown-it-attrs": "^4.3.1",

package/scripts/aggregator/article-generator.d.ts

@@ -100,6 +100,24 @@ export declare function sanitizeRunSuffix(runId: string): string;
  * @returns Plain-text description, truncated to ≤300 characters
  */
 export declare function extractDefaultDescription(markdown: string): string;
+/**
+ * Insert the regenerated Reader Intelligence Guide HTML immediately after
+ * the Executive Brief section so the rendered article body matches the
+ * documented order (Executive Brief → Reader Intelligence Guide → Key
+ * Takeaways → deep sections). The Executive Brief section ends where the
+ * next H2 begins; we splice at that boundary. When the brief is absent
+ * (sparse runs) we fall back to prepending so the guide still appears
+ * at the top of the body.
+ *
+ * Implementation uses `indexOf` rather than a regex so the splice point
+ * is deterministic and immune to polynomial-regex backtracking on
+ * pathological input.
+ *
+ * @param bodyHtml - Rendered article body
+ * @param guideHtml - Reader Intelligence Guide HTML fragment
+ * @returns Body HTML with the guide spliced after the Executive Brief
+ */
+export declare function insertReaderGuideAfterExecutiveBrief(bodyHtml: string, guideHtml: string): string;
 /**
  * Run the full aggregate → render → write pipeline for one run.
  *

package/scripts/aggregator/article-generator.js

@@ -349,12 +349,17 @@ function writeLanguageVariant(lang, slug, aggregated, englishHtml, chromeOptions
     bodyHtml = bodyHtml.replace(/<h1[^>]*>[\s\S]*?<\/h1>\s*/, '');
     const guideHtml = buildReaderIntelligenceGuideHtml(lang, aggregated.sectionToc, aggregated.includedArtifacts);
     if (guideHtml) {
-        // Prepend the guide to the body so it always appears at the top of
-        // the rendered content, immediately after the chrome header. The
-        // article chrome in wrapArticleHtml wraps the body in an <article>
-        // with its own <header>/<h1>, so prepending here is deterministic
-        // and avoids fragile in-body heading searches.
-        bodyHtml = guideHtml + '\n' + bodyHtml;
+        // Insert the guide IMMEDIATELY AFTER the Executive Brief section so
+        // the rendered HTML body order matches the documented article
+        // skeleton (Article-Generation.md §"Article skeleton"):
+        //   1. Executive Brief
+        //   2. Reader Intelligence Guide
+        //   3. Key Takeaways
+        //   4. … deep sections
+        // We splice at the start of the next H2 after the Executive Brief
+        // anchor; when the brief is missing (sparse runs) we fall back to
+        // prepending so the guide still appears at the top of the body.
+        bodyHtml = insertReaderGuideAfterExecutiveBrief(bodyHtml, guideHtml);
     }
     // Localize Tradecraft References, Analysis Index, and other appendix
     // section headings and content into the target language.
@@ -385,6 +390,60 @@ function writeLanguageVariant(lang, slug, aggregated, englishHtml, chromeOptions
     fs.writeFileSync(path.join(opts.outDir, filename), html, 'utf8');
     return filename;
 }
+/**
+ * Insert the regenerated Reader Intelligence Guide HTML immediately after
+ * the Executive Brief section so the rendered article body matches the
+ * documented order (Executive Brief → Reader Intelligence Guide → Key
+ * Takeaways → deep sections). The Executive Brief section ends where the
+ * next H2 begins; we splice at that boundary. When the brief is absent
+ * (sparse runs) we fall back to prepending so the guide still appears
+ * at the top of the body.
+ *
+ * Implementation uses `indexOf` rather than a regex so the splice point
+ * is deterministic and immune to polynomial-regex backtracking on
+ * pathological input.
+ *
+ * @param bodyHtml - Rendered article body
+ * @param guideHtml - Reader Intelligence Guide HTML fragment
+ * @returns Body HTML with the guide spliced after the Executive Brief
+ */
+export function insertReaderGuideAfterExecutiveBrief(bodyHtml, guideHtml) {
+    const execBriefAnchor = 'id="section-executive-brief"';
+    const briefIdx = bodyHtml.indexOf(execBriefAnchor);
+    if (briefIdx === -1) {
+        return guideHtml + '\n' + bodyHtml;
+    }
+    // Skip the Executive Brief opening tag itself, then walk forward to the
+    // next H2 — that's where the next section starts and where we want to
+    // splice the guide. `<h2 ` matches a tag with attributes; `<h2>` matches
+    // a bare tag (defensive).
+    const afterBrief = briefIdx + execBriefAnchor.length;
+    const nextH2Tagged = bodyHtml.indexOf('<h2 ', afterBrief);
+    const nextH2Bare = bodyHtml.indexOf('<h2>', afterBrief);
+    const nextH2 = pickEarliestIndex(nextH2Tagged, nextH2Bare);
+    if (nextH2 === -1) {
+        // Executive Brief is the only section — append the guide at the end.
+        return bodyHtml + '\n' + guideHtml;
+    }
+    return bodyHtml.slice(0, nextH2) + guideHtml + '\n' + bodyHtml.slice(nextH2);
+}
+/**
+ * Return the smaller of two `indexOf` results, treating `-1` as "not
+ * found" so the caller gets `-1` only when both probes failed. Extracted
+ * to keep {@link insertReaderGuideAfterExecutiveBrief} under the
+ * useless-assignment lint.
+ *
+ * @param a - First `indexOf` result
+ * @param b - Second `indexOf` result
+ * @returns Smaller non-negative index, or `-1` when both are `-1`
+ */
+function pickEarliestIndex(a, b) {
+    if (a === -1)
+        return b;
+    if (b === -1)
+        return a;
+    return Math.min(a, b);
+}
 /**
  * Safely look up one language entry in a {@link ResolvedMetadata} map.
  * The runtime shape is always complete (one entry per language), but the

package/scripts/aggregator/article-html.js

@@ -20,7 +20,7 @@
  */
 import { BASE_URL, BUILD_SHORT, MERMAID_VERSION } from '../constants/config.js';
 import { buildHeadFreshnessTags } from '../constants/build-info-meta.js';
-import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, SKIP_LINK_TEXTS, TOC_ARIA_LABELS, ARTICLE_TYPE_LABELS, VIEW_SOURCE_MARKDOWN_LABELS, ARTICLE_TYPE_ICONS, TRADECRAFT_HEADING_LABELS, TRADECRAFT_INTRO_LABELS, TRADECRAFT_METHODOLOGIES_LABELS, TRADECRAFT_TEMPLATES_LABELS, ANALYSIS_INDEX_HEADING_LABELS, ANALYSIS_INDEX_INTRO_LABELS, ANALYSIS_INDEX_COL_SECTION_LABELS, ANALYSIS_INDEX_COL_ARTIFACT_LABELS, ANALYSIS_INDEX_COL_PATH_LABELS, KEY_TAKEAWAYS_HEADING_LABELS, SUPPLEMENTARY_HEADING_LABELS, SECTION_TITLE_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
+import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, SKIP_LINK_TEXTS, TOC_ARIA_LABELS, ARTICLE_TYPE_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, VIEW_SOURCE_MARKDOWN_LABELS, ARTICLE_TYPE_ICONS, FOOTER_SITEMAP_LABELS, FOOTER_POLITICAL_INTELLIGENCE_LABELS, TRADECRAFT_HEADING_LABELS, TRADECRAFT_INTRO_LABELS, TRADECRAFT_METHODOLOGIES_LABELS, TRADECRAFT_TEMPLATES_LABELS, ANALYSIS_INDEX_HEADING_LABELS, ANALYSIS_INDEX_INTRO_LABELS, ANALYSIS_INDEX_COL_SECTION_LABELS, ANALYSIS_INDEX_COL_ARTIFACT_LABELS, ANALYSIS_INDEX_COL_PATH_LABELS, KEY_TAKEAWAYS_HEADING_LABELS, SUPPLEMENTARY_HEADING_LABELS, SECTION_TITLE_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
 import { ArticleCategory } from '../types/index.js';
 import { escapeHTML } from '../utils/file-utils.js';
 import { buildSiteFooter, buildSiteHeader, buildPageBanner, } from '../templates/section-builders.js';
@@ -28,6 +28,8 @@ import { READER_GUIDE_SECTION_ID } from './reader-guide-constants.js';
 import { READER_GUIDE_TITLE_LABELS } from './reader-intelligence-guide.js';
 import { TRADECRAFT_SECTION_ID, MANIFEST_SECTION_ID, SUPPLEMENTARY_SECTION_ID, } from './artifact-order.js';
 import { KEY_TAKEAWAYS_SECTION_ID } from './key-takeaways.js';
+import { getPoliticalIntelligenceFilename } from '../generators/political-intelligence.js';
+import { getSitemapFilename } from '../generators/sitemap/index.js';
 /**
  * Resolve a localized article type label with icon. Falls back to the
  * humanised slug when a translation isn't available.
@@ -155,10 +157,10 @@ export function buildArticleToc(entries, lang) {
     })
         .join('\n');
     return [
-        `  <aside class="article-toc-container" aria-label="${label}">`,
+        `  <aside class="article-toc-container" aria-labelledby="article-toc-heading">`,
         `    <details class="article-toc-details" open>`,
-        `      <summary class="article-toc-summary"><span class="guide-icon" aria-hidden="true">📑</span> ${label}</summary>`,
-        `      <nav class="article-toc">`,
+        `      <summary class="article-toc-summary" id="article-toc-heading"><span class="guide-icon" aria-hidden="true">📑</span> ${label}</summary>`,
+        `      <nav class="article-toc" aria-labelledby="article-toc-heading">`,
         `        <ol class="article-toc-list">`,
         items,
         `        </ol>`,
@@ -310,10 +312,17 @@ export function wrapArticleHtml(options) {
     const hreflangLinks = buildArticleHreflangLinks(options.articleSlug);
     const langSwitcher = buildLanguageSwitcher(options.articleSlug, safeLang);
     const sourceMdLabel = getLocalizedString(VIEW_SOURCE_MARKDOWN_LABELS, safeLang);
+    const articleNavLabel = getLocalizedString(ARTICLE_NAV_LABELS, safeLang);
+    const backToNewsLabel = getLocalizedString(BACK_TO_NEWS_LABELS, safeLang);
+    const politicalIntelligenceLabel = getLocalizedString(FOOTER_POLITICAL_INTELLIGENCE_LABELS, safeLang);
+    const sitemapLabel = getLocalizedString(FOOTER_SITEMAP_LABELS, safeLang);
+    const politicalIntelligenceHref = `../${getPoliticalIntelligenceFilename(safeLang)}`;
+    const sitemapHref = `../${getSitemapFilename(safeLang)}`;
     const sourceMdLink = options.sourceMarkdownRelPath
         ? `<p class="article-source-md"><a href="${BASE_URL}/${options.sourceMarkdownRelPath}" rel="alternate" type="text/markdown"><svg class="icon icon-inline" width="16" height="16" viewBox="0 0 24 24" role="img" aria-hidden="true" focusable="false"><path d="M9 5H7a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2v-2M12 3h6a2 2 0 0 1 2 2v6M10 14 20 4" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg> ${escapeHTML(sourceMdLabel)}</a></p>`
         : '';
     const tocHtml = buildArticleToc(options.toc ?? [], safeLang);
+    const articleMainClass = tocHtml.length > 0 ? 'article-main--with-toc' : 'article-main--no-toc';
     const jsonLd = {
         '@context': 'https://schema.org',
         '@type': 'NewsArticle',
@@ -413,7 +422,9 @@ ${hreflangLinks}
   <link rel="icon" type="image/png" sizes="16x16" href="../images/favicon-16x16.png">
   <link rel="apple-touch-icon" sizes="180x180" href="../images/apple-touch-icon.png">
   <link rel="manifest" href="../site.webmanifest">
-  <meta name="theme-color" content="#003399">
+  <meta name="color-scheme" content="light dark">
+  <meta name="theme-color" content="#003399" media="(prefers-color-scheme: light)">
+  <meta name="theme-color" content="#0a1a38" media="(prefers-color-scheme: dark)">
   <link rel="stylesheet" href="../styles.css?v=${BUILD_SHORT}">
 ${buildHeadFreshnessTags('../')}
   <script type="application/ld+json">${jsonLdString}</script>
@@ -422,12 +433,18 @@ ${buildHeadFreshnessTags('../')}
 </head>
 <body>
   <a href="#main" class="skip-link">${escapeHTML(skipLinkText)}</a>
+  <div class="reading-progress" aria-hidden="true"></div>
 
   ${header}
 
   ${buildPageBanner('../')}
 
-  <main id="main" class="site-main article-main">
+  <main id="main" class="site-main article-main ${articleMainClass}">
+    <nav class="article-top-nav" aria-label="${escapeHTML(articleNavLabel)}">
+      <a class="article-top-nav__link article-top-nav__link--primary" href="${indexHref}">${escapeHTML(backToNewsLabel)}</a>
+      <a class="article-top-nav__link" href="${politicalIntelligenceHref}">🧠 ${escapeHTML(politicalIntelligenceLabel)}</a>
+      <a class="article-top-nav__link" href="${sitemapHref}">🗺️ ${escapeHTML(sitemapLabel)}</a>
+    </nav>
 ${tocHtml}    <article class="article-body" lang="${safeLang}">
       <header class="article-hero">
         <p class="article-kicker">${escapeHTML(getLocalizedArticleType(options.articleType, safeLang))}</p>

package/scripts/aggregator/article-metadata.d.ts

@@ -59,6 +59,31 @@ export interface ResolveMetadataOptions {
  * @returns `true` when the line is not prose and should be skipped
  */
 export declare function shouldSkipDescriptionLine(line: string): boolean;
+/**
+ * Strip inline Markdown decorations so we can use the remaining text as
+ * plain-text meta-tag content. Removes link syntax, emphasis, inline code
+ * backticks, and HTML-entity fragments that the Markdown source sometimes
+ * smuggles in. Keeps the visible text readable.
+ *
+ * @param raw - Trimmed Markdown line
+ * @returns Plain-text variant
+ */
+/**
+ * Strip a leading all-caps prose label (e.g. `SITUATION:`, `KEY MOTION:`,
+ * `BLUF:`, `BOTTOM LINE:`, `TIER-1:`) from a prose line. These labels
+ * are common in BLUF-style editorial writing — they survive
+ * {@link stripInlineMarkdown} (which strips the `**bold**` wrapper but
+ * keeps the literal text) and would otherwise leak into the SEO
+ * description as a confusing all-caps shout.
+ *
+ * Matches up to 4 hyphenated all-caps tokens, optionally followed by a
+ * digit suffix (`TIER-1`), terminating at a colon. Returns the original
+ * line when no opener is present.
+ *
+ * @param line - Plain prose line (post-{@link stripInlineMarkdown})
+ * @returns Line with the all-caps opener removed
+ */
+export declare function stripLeadingProseLabel(line: string): string;
 /**
  * Strip inline Markdown decorations so we can use the remaining text as
  * plain-text meta-tag content. Removes link syntax, emphasis, inline code
@@ -105,6 +130,56 @@ export declare function extractFirstH1(markdown: string): string;
  * @returns Prose description, or empty string when nothing qualifies
  */
 export declare function extractStrongProseLine(markdown: string): string;
+/**
+ * Walk the body of an editorial artefact and, when it contains a `## …`
+ * heading whose text matches one of {@link EDITORIAL_LEDE_HEADINGS},
+ * return the first prose paragraph that follows that heading. This is
+ * the journalist's lede ("60-Second Read", "TL;DR", "BLUF — …", …) and
+ * is exactly the sentence that should power `<meta description>` and
+ * the OG/Twitter description fields.
+ *
+ * Returns the empty string when no lede heading is found or no qualifying
+ * prose follows it. Inline Markdown is stripped and the result is
+ * truncated to fit `<meta description>`.
+ *
+ * @param markdown - Editorial artefact source
+ * @returns Lede paragraph, or empty string when none matched
+ */
+export declare function extractLedeAfterHeading(markdown: string): string;
+/**
+ * Return `true` when an artefact-H1 begins with one of the
+ * {@link ARTIFACT_CATEGORY_PREFIXES} followed by a separator. Such H1s
+ * carry the artefact's structural label rather than a journalist's
+ * headline (e.g. `# Synthesis Summary — Week in Review (3 Apr – 1 May
+ * 2026)`) and must not leak into the article `<title>`.
+ *
+ * @param heading - Plain-text H1 (after `stripInlineMarkdown`)
+ * @returns `true` when the heading is an artefact-category label
+ */
+export declare function isArtifactCategoryHeading(heading: string): boolean;
+/**
+ * Strip a leading or trailing artifact-category label from a heading and
+ * return the editorial-topic core. When neither end carries a category
+ * label, the heading is returned unchanged. When the category label is
+ * the **entire** heading (e.g. `# Executive Brief`) the result is the
+ * empty string.
+ *
+ * Examples:
+ * - `Executive Brief — EU Parliament Motions` → `EU Parliament Motions`
+ * - `EU Parliament Propositions — Executive Brief` → `EU Parliament Propositions`
+ * - `EP10 Term Outlook — Executive Brief` → `EP10 Term Outlook`
+ * - `Key Legislative Developments — Deep Analysis (2026-05-08)` → `Key Legislative Developments`
+ * - `Synthesis Summary — EP Motions & Adopted Texts` → `EP Motions & Adopted Texts`
+ *
+ * Trailing parenthesised metadata (`(2026-05-08)`, `(May 2026)`) is also
+ * stripped because it functions as a date stamp rather than editorial
+ * copy. The returned core is trimmed of whitespace and trailing
+ * punctuation.
+ *
+ * @param heading - Raw heading text (post-{@link stripInlineMarkdown})
+ * @returns Editorial-topic core, or empty string when only the category survived
+ */
+export declare function stripArtifactCategoryAffix(heading: string): string;
 /**
  * Humanise an `article-type` slug the same way the aggregator does (see
  * `src/aggregator/analysis-aggregator.ts:humanize`). Kept in sync by value

package/scripts/aggregator/article-metadata.js

@@ -52,6 +52,14 @@ const DESCRIPTION_MAX_LENGTH = 300;
 const TITLE_MAX_LENGTH = 140;
 /** Ordered list of artefact filenames that typically carry the editorial H1. */
 const EDITORIAL_ARTEFACT_CANDIDATES = [
+    // `executive-brief.md` is the canonical Riksdagsmonitor-aligned editorial
+    // artefact (see `analysis/methodologies/ai-driven-analysis-guide.md`).
+    // It always carries the journalist's BLUF and a `## 60-Second Read`
+    // paragraph that is the lede — preferring it over `synthesis-summary.md`
+    // keeps Stage-B internal vocabulary ("Purpose: This artifact provides …")
+    // out of the SEO-critical `<title>` and `<meta description>` surfaces.
+    'executive-brief.md',
+    'extended/executive-brief.md',
     'intelligence/synthesis-summary.md',
     'intelligence/executive-summary.md',
     'intelligence/intelligence-briefing.md',
@@ -68,6 +76,107 @@ const EDITORIAL_ARTEFACT_CANDIDATES = [
     'motions-analysis.md',
     'propositions-analysis.md',
 ];
+/**
+ * Headings inside an editorial artefact that carry the journalist's lede
+ * paragraph (a one-paragraph summary of "what happened, why it matters").
+ * When the resolver sees one of these as a `## …` heading inside the
+ * editorial artefact, it prefers the first prose paragraph that follows
+ * it as the description (and as a title fallback) over a generic line
+ * walk. Names are matched case-insensitively against the heading text
+ * (after stripping inline Markdown).
+ */
+const EDITORIAL_LEDE_HEADINGS = [
+    '60-second read',
+    '60 second read',
+    'sixty-second read',
+    'lede',
+    'lead',
+    'tl;dr',
+    'tldr',
+    'synopsis',
+    'in brief',
+    'at a glance',
+    'bottom line',
+    'bluf',
+    'bluf — bottom line up front',
+    'bottom line up front',
+    'executive summary',
+    'executive briefing',
+    'master narrative',
+    'overview',
+    'headline judgement',
+    'headline judgment',
+    'key findings',
+    'key judgements',
+    'key judgments',
+    'situation summary',
+    'situation report',
+    'situation update',
+];
+/**
+ * Artifact-category prefixes that appear inside editorial-artefact H1s as
+ * a structural label rather than an editorial headline (e.g. `# Synthesis
+ * Summary — Week in Review (3 Apr – 1 May 2026)`). When a candidate H1
+ * starts with one of these prefixes followed by a separator (em/en dash,
+ * hyphen, or colon), the resolver treats it as **generic** so it does
+ * not leak into the article `<title>`. Compared lower-case, with leading
+ * punctuation stripped.
+ */
+const ARTIFACT_CATEGORY_PREFIXES = [
+    'actor mapping',
+    'analytical quality',
+    'breaking news analysis',
+    'coalition dynamics',
+    'commission wp alignment',
+    'committee activity report',
+    'cross run continuity',
+    'deep analysis',
+    'economic context',
+    'executive brief',
+    'executive briefing',
+    'executive summary',
+    'forward indicators',
+    'historical baseline',
+    'impact matrix',
+    'intelligence assessment',
+    'intelligence briefing',
+    'intelligence synthesis summary',
+    'legislative output analysis',
+    'legislative pipeline analysis',
+    'legislative pipeline forecast',
+    'mandate fulfilment scorecard',
+    'master intelligence synthesis',
+    'mcp reliability audit',
+    'methodology reflection',
+    'monthly outlook',
+    'motions analysis',
+    'parliamentary calendar projection',
+    'pestle analysis',
+    'political intelligence brief',
+    'political risk',
+    'political threat landscape',
+    'presidency trio context',
+    'propositions analysis',
+    'quantitative swot',
+    'risk assessment',
+    'risk matrix',
+    'risk scoring',
+    'scenario forecast',
+    'seat projection',
+    'significance classification',
+    'situation report',
+    'situation summary',
+    'stakeholder analysis',
+    'stakeholder impact',
+    'stakeholder map',
+    'swot analysis',
+    'synthesis summary',
+    'threat assessment',
+    'threat model',
+    'voting patterns',
+    'weekly outlook',
+    'wildcards blackswans',
+];
 /**
  * Emoji-banner prefixes that Stage-B agents use to decorate metadata rows
  * (e.g. `📋 Analysis Owner:`). Any line starting with one of these is
@@ -96,27 +205,47 @@ const EMOJI_BANNER_CHARS = [
  * by optional space and a colon.
  */
 const METADATA_LINE_PREFIXES = [
+    'Admiralty Grade',
     'Analysis Date',
     'Analysis Owner',
     'Article Type',
+    'Article Window',
     'Assessment Date',
+    'Briefing',
+    'Briefing Date',
     'Classification',
     'Classification Date',
     'Confidence',
+    'Confidence in Evidence',
     'Data Sources',
+    'Date',
     'Document Type',
+    'Filing Date',
     'Generated',
+    'Horizon',
+    'IMF Status',
     'Last Updated',
     'Parliamentary Status',
     'Parliamentary Term',
     'Period',
+    'Prepared',
+    'Purpose',
+    'Region',
+    'Reporting',
+    'Reporting Period',
+    'Reporting Window',
     'Run',
     'Run ID',
     'Series',
     'Series Run',
+    'Source',
+    'Sources',
     'SPDX-FileCopyrightText',
     'SPDX-License-Identifier',
+    'Topic',
     'Type',
+    'WEP Band',
+    'WEP Grade',
     'Window',
 ];
 /**
@@ -170,6 +299,53 @@ export function shouldSkipDescriptionLine(line) {
         return true;
     return false;
 }
+/**
+ * Strip inline Markdown decorations so we can use the remaining text as
+ * plain-text meta-tag content. Removes link syntax, emphasis, inline code
+ * backticks, and HTML-entity fragments that the Markdown source sometimes
+ * smuggles in. Keeps the visible text readable.
+ *
+ * @param raw - Trimmed Markdown line
+ * @returns Plain-text variant
+ */
+/**
+ * Strip a leading all-caps prose label (e.g. `SITUATION:`, `KEY MOTION:`,
+ * `BLUF:`, `BOTTOM LINE:`, `TIER-1:`) from a prose line. These labels
+ * are common in BLUF-style editorial writing — they survive
+ * {@link stripInlineMarkdown} (which strips the `**bold**` wrapper but
+ * keeps the literal text) and would otherwise leak into the SEO
+ * description as a confusing all-caps shout.
+ *
+ * Matches up to 4 hyphenated all-caps tokens, optionally followed by a
+ * digit suffix (`TIER-1`), terminating at a colon. Returns the original
+ * line when no opener is present.
+ *
+ * @param line - Plain prose line (post-{@link stripInlineMarkdown})
+ * @returns Line with the all-caps opener removed
+ */
+export function stripLeadingProseLabel(line) {
+    // Use a single-pass regex with no nested quantifiers and no overlapping
+    // character classes — keeps `security/detect-unsafe-regex` happy. The
+    // pattern matches a label of 2-80 contiguous chars from a closed set
+    // (uppercase letters, digits, hyphen, single internal spaces),
+    // terminated by `:` and at least one whitespace before the prose body.
+    const colonIdx = line.indexOf(': ');
+    if (colonIdx < 2 || colonIdx > 80)
+        return line;
+    const label = line.slice(0, colonIdx);
+    const rest = line.slice(colonIdx + 2).trim();
+    if (rest.length < 20)
+        return line;
+    // Validate the label: ALL chars must be uppercase A-Z, digit 0-9, space,
+    // or hyphen; the first char must be a letter.
+    if (!/^[A-Z][A-Z0-9 -]{1,79}$/.test(label))
+        return line;
+    // Reject single-word labels shorter than 3 chars (`OK:` would be a
+    // false positive against legitimate sentence openers).
+    if (label.length < 3)
+        return line;
+    return rest;
+}
 /**
  * Strip inline Markdown decorations so we can use the remaining text as
  * plain-text meta-tag content. Removes link syntax, emphasis, inline code
@@ -266,13 +442,204 @@ export function extractStrongProseLine(markdown) {
         const line = raw.trim();
         if (shouldSkipDescriptionLine(line))
             continue;
-        const plain = stripInlineMarkdown(line);
+        const plain = stripLeadingProseLabel(stripInlineMarkdown(line));
         if (plain.length < 40)
             continue;
         return truncateDescription(plain);
     }
     return '';
 }
+/**
+ * Walk the body of an editorial artefact and, when it contains a `## …`
+ * heading whose text matches one of {@link EDITORIAL_LEDE_HEADINGS},
+ * return the first prose paragraph that follows that heading. This is
+ * the journalist's lede ("60-Second Read", "TL;DR", "BLUF — …", …) and
+ * is exactly the sentence that should power `<meta description>` and
+ * the OG/Twitter description fields.
+ *
+ * Returns the empty string when no lede heading is found or no qualifying
+ * prose follows it. Inline Markdown is stripped and the result is
+ * truncated to fit `<meta description>`.
+ *
+ * @param markdown - Editorial artefact source
+ * @returns Lede paragraph, or empty string when none matched
+ */
+export function extractLedeAfterHeading(markdown) {
+    const lines = markdown.split('\n');
+    let inLede = false;
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i] ?? '';
+        const line = raw.trim();
+        // Detect the start of a lede section — accept any H2/H3 whose plain
+        // text (after stripping leading hashes, inline decorations, and any
+        // leading emoji/punctuation) matches one of the canonical headings.
+        if (/^#{2,3}\s+/.test(line)) {
+            const headingText = normaliseHeadingText(line.replace(/^#{2,3}\s+/, ''));
+            inLede = EDITORIAL_LEDE_HEADINGS.some((h) => headingText === h || headingText.startsWith(`${h} `) || headingText.startsWith(`${h}:`));
+            continue;
+        }
+        if (!inLede)
+            continue;
+        // Inside the lede section: skip non-prose lines, then return the first
+        // qualifying paragraph. Strip a leading all-caps prose label
+        // (`SITUATION:`, `KEY MOTION:`, `BLUF:`, …) so SEO descriptions read
+        // as natural sentences rather than BLUF shouts.
+        if (shouldSkipDescriptionLine(line))
+            continue;
+        const plain = stripLeadingProseLabel(stripInlineMarkdown(line));
+        if (plain.length < 40)
+            continue;
+        return truncateDescription(plain);
+    }
+    return '';
+}
+/**
+ * Normalise a Markdown heading's text for comparison against the
+ * editorial-lede heading whitelist. Strips inline Markdown decorations
+ * (`*`, `_`, `` ` ``, `#`), then strips any leading non-alphanumeric
+ * characters (emoji, punctuation, spaces) so a heading like
+ * `🎯 Headline Judgement` compares equal to `headline judgement`.
+ *
+ * @param raw - Raw heading text (no leading hashes)
+ * @returns Lower-cased, decoration-stripped heading text
+ */
+function normaliseHeadingText(raw) {
+    return stripInlineMarkdown(raw)
+        .replace(/[*_`#]+/g, '')
+        .replace(/^[^A-Za-z0-9]+/, '')
+        .trim()
+        .toLowerCase();
+}
+/**
+ * Return `true` when an artefact-H1 begins with one of the
+ * {@link ARTIFACT_CATEGORY_PREFIXES} followed by a separator. Such H1s
+ * carry the artefact's structural label rather than a journalist's
+ * headline (e.g. `# Synthesis Summary — Week in Review (3 Apr – 1 May
+ * 2026)`) and must not leak into the article `<title>`.
+ *
+ * @param heading - Plain-text H1 (after `stripInlineMarkdown`)
+ * @returns `true` when the heading is an artefact-category label
+ */
+export function isArtifactCategoryHeading(heading) {
+    const normalized = normaliseCategoryHeading(heading);
+    if (normalized === '')
+        return false;
+    for (const prefix of ARTIFACT_CATEGORY_PREFIXES) {
+        if (normalized === prefix)
+            return true;
+        // Accept any of: "<prefix> — …", "<prefix> – …", "<prefix> - …",
+        // "<prefix>: …" — every separator commonly used in artefact H1s.
+        if (normalized.startsWith(`${prefix} —`) ||
+            normalized.startsWith(`${prefix} –`) ||
+            normalized.startsWith(`${prefix} -`) ||
+            normalized.startsWith(`${prefix}:`)) {
+            return true;
+        }
+        // Also accept "<topic> — <prefix>" / "<topic>: <prefix>" so suffix-form
+        // category labels (`# EU Parliament Propositions — Executive Brief`,
+        // `# Key Legislative Developments — Deep Analysis`) are flagged the
+        // same as prefix-form ones. The "topic" is rescued by the affix
+        // stripper before this rejection takes effect.
+        if (normalized.endsWith(` — ${prefix}`) ||
+            normalized.endsWith(` – ${prefix}`) ||
+            normalized.endsWith(` - ${prefix}`) ||
+            normalized.endsWith(`: ${prefix}`)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Strip a leading or trailing artifact-category label from a heading and
+ * return the editorial-topic core. When neither end carries a category
+ * label, the heading is returned unchanged. When the category label is
+ * the **entire** heading (e.g. `# Executive Brief`) the result is the
+ * empty string.
+ *
+ * Examples:
+ * - `Executive Brief — EU Parliament Motions` → `EU Parliament Motions`
+ * - `EU Parliament Propositions — Executive Brief` → `EU Parliament Propositions`
+ * - `EP10 Term Outlook — Executive Brief` → `EP10 Term Outlook`
+ * - `Key Legislative Developments — Deep Analysis (2026-05-08)` → `Key Legislative Developments`
+ * - `Synthesis Summary — EP Motions & Adopted Texts` → `EP Motions & Adopted Texts`
+ *
+ * Trailing parenthesised metadata (`(2026-05-08)`, `(May 2026)`) is also
+ * stripped because it functions as a date stamp rather than editorial
+ * copy. The returned core is trimmed of whitespace and trailing
+ * punctuation.
+ *
+ * @param heading - Raw heading text (post-{@link stripInlineMarkdown})
+ * @returns Editorial-topic core, or empty string when only the category survived
+ */
+export function stripArtifactCategoryAffix(heading) {
+    const trimmed = heading.trim();
+    if (trimmed === '')
+        return '';
+    const sortedPrefixes = [...ARTIFACT_CATEGORY_PREFIXES].sort((a, b) => b.length - a.length);
+    const normalized = normaliseCategoryHeading(trimmed);
+    const skip = trimmed.length - normalized.length;
+    const visible = trimmed.slice(skip < 0 ? 0 : skip);
+    // Pre-strip trailing parenthesised metadata (`(2026-05-08)`,
+    // `(May 2026)`) so the suffix matcher works on `… — deep analysis`
+    // rather than `… — deep analysis (2026-05-08)`.
+    const visibleClean = visible.replace(/\s*\([^)]{1,80}\)\s*$/u, '').trim();
+    const normalizedClean = normaliseCategoryHeading(visibleClean);
+    for (const prefix of sortedPrefixes) {
+        // Prefix-form: `Executive Brief — <topic>`
+        for (const sep of [' — ', ' – ', ' - ', ': ']) {
+            const candidate = `${prefix}${sep}`;
+            if (normalizedClean.startsWith(candidate)) {
+                const core = visibleClean.slice(candidate.length).trim();
+                return cleanupAffixCore(core);
+            }
+        }
+        // Suffix-form: `<topic> — Executive Brief`
+        for (const sep of [' — ', ' – ', ' - ', ': ']) {
+            const candidate = `${sep}${prefix}`;
+            if (normalizedClean.endsWith(candidate)) {
+                const core = visibleClean.slice(0, visibleClean.length - candidate.length).trim();
+                return cleanupAffixCore(core);
+            }
+        }
+        // Whole-heading match: `Executive Brief`
+        if (normalizedClean === prefix)
+            return '';
+    }
+    // No category label detected — return the heading unchanged.
+    return trimmed;
+}
+/**
+ * Tidy the editorial-topic core returned by
+ * {@link stripArtifactCategoryAffix}: drop trailing parenthesised
+ * metadata (`(2026-05-08)`, `(May 2026)`) and trailing punctuation. When
+ * stripping leaves the string too short to be meaningful (<5 chars),
+ * return the empty string so callers fall through to lower tiers.
+ *
+ * @param core - Heading with the category label already stripped
+ * @returns Cleaned editorial-topic core, or empty string when too short
+ */
+function cleanupAffixCore(core) {
+    const withoutTrailingParens = core.replace(/\s*\([^)]{1,80}\)\s*$/u, '').trim();
+    const withoutTrailingPunct = withoutTrailingParens.replace(/[—–:;,.\s-]+$/u, '').trim();
+    if (withoutTrailingPunct.length < 5)
+        return '';
+    return withoutTrailingPunct;
+}
+/**
+ * Lower-case, decoration-stripped form used by the artifact-category
+ * matchers. Strips inline Markdown, leading non-alphanumeric runs (emoji,
+ * decoration), and collapses whitespace to a single space.
+ *
+ * @param raw - Raw heading text
+ * @returns Lower-case normalised form
+ */
+function normaliseCategoryHeading(raw) {
+    return stripInlineMarkdown(raw)
+        .trim()
+        .toLowerCase()
+        .replace(/^[^a-z0-9]+/, '')
+        .replace(/\s+/g, ' ');
+}
 /**
  * Humanise an `article-type` slug the same way the aggregator does (see
  * `src/aggregator/analysis-aggregator.ts:humanize`). Kept in sync by value
@@ -304,6 +671,12 @@ export function isGenericHeading(heading, articleType, date) {
     const normalized = heading.trim().replace(/\s+/g, ' ');
     if (normalized === '')
         return true;
+    // Artefact-category H1s (e.g. `Synthesis Summary — …`, `Executive Brief
+    // — …`) are structural labels, not journalist headlines. Treat them as
+    // generic so the resolver falls through to the localized template tier
+    // and the SEO `<title>` stays clean.
+    if (isArtifactCategoryHeading(normalized))
+        return true;
     const human = humanizeSlug(articleType);
     const patterns = [
         `${human} — ${date}`,
@@ -353,38 +726,102 @@ function escapeRegex(input) {
 export function extractArtifactHighlight(runDir, articleType, date) {
     if (!runDir || !fs.existsSync(runDir))
         return null;
-    // Direct candidate lookup — cheap and deterministic.
-    for (const rel of EDITORIAL_ARTEFACT_CANDIDATES) {
-        const abs = path.join(runDir, rel);
-        if (!fs.existsSync(abs))
-            continue;
-        const body = readArtefactBody(abs);
-        const headline = extractFirstH1(body);
-        if (!headline)
-            continue;
-        if (isGenericHeading(headline, articleType, date))
-            continue;
-        const summary = extractStrongProseLine(body);
-        return { headline: truncateTitle(headline), summary };
-    }
+    // Direct candidate lookup — cheap and deterministic. We collect the
+    // first artefact whose body yields a usable lede summary even when its
+    // H1 is a structural artefact-category label, so the description tier
+    // benefits from the editorial 60-Second Read paragraph in
+    // `executive-brief.md` even though its H1 (`Executive Brief — …`) is
+    // generic.
+    const direct = scanCandidatesForHighlight(runDir, EDITORIAL_ARTEFACT_CANDIDATES, articleType, date);
+    if (direct.headline)
+        return { headline: direct.headline, summary: direct.summary };
     // Fallback: walk the top-level `.md` files in the run dir once, looking
     // for any that starts with `#` and has a non-generic headline.
-    const topLevel = safeReaddir(runDir).filter((f) => f.endsWith('.md'));
-    for (const rel of topLevel) {
-        if (rel === 'manifest.json')
-            continue;
-        const abs = path.join(runDir, rel);
-        const body = readArtefactBody(abs);
-        const headline = extractFirstH1(body);
-        if (!headline)
-            continue;
-        if (isGenericHeading(headline, articleType, date))
-            continue;
-        const summary = extractStrongProseLine(body);
-        return { headline: truncateTitle(headline), summary };
+    const topLevel = safeReaddir(runDir).filter((f) => f.endsWith('.md') && f !== 'manifest.json');
+    const fallback = scanCandidatesForHighlight(runDir, topLevel, articleType, date);
+    if (fallback.headline)
+        return { headline: fallback.headline, summary: fallback.summary };
+    // No editorial headline was found, but we may have harvested a strong
+    // lede summary from one of the editorial artefacts. Returning a
+    // headline-less highlight lets `resolveEditorialContent` keep the
+    // editorial summary while falling back to the localized title template.
+    const summaryOnly = direct.summary || fallback.summary;
+    if (summaryOnly) {
+        return { headline: '', summary: summaryOnly };
     }
     return null;
 }
+/**
+ * Walk a list of candidate artefact paths and return the first
+ * non-generic headline + summary pair, plus the first usable lede
+ * summary seen along the way. Extracted from
+ * {@link extractArtifactHighlight} to keep its cognitive complexity
+ * within the SonarJS budget.
+ *
+ * @param runDir - Absolute run directory path
+ * @param candidates - Run-relative candidate filenames to probe
+ * @param articleType - Article-type slug (used by {@link isGenericHeading})
+ * @param date - ISO run date (used by {@link isGenericHeading})
+ * @returns `{headline, summary}` where either field may be empty
+ */
+function scanCandidatesForHighlight(runDir, candidates, articleType, date) {
+    let bestSummaryOnly = '';
+    for (const rel of candidates) {
+        const probe = probeCandidateForHighlight(runDir, rel, articleType, date);
+        // Both clean and stripped highlights win the loop — they come from
+        // the highest-priority artefact that yielded usable text. This
+        // preserves the priority order of {@link EDITORIAL_ARTEFACT_CANDIDATES}
+        // (executive-brief > synthesis-summary > …) so a stripped headline
+        // from `executive-brief.md` beats a clean H1 from a lower-priority
+        // artefact like `intelligence/synthesis-summary.md`.
+        if (probe.cleanHighlight)
+            return probe.cleanHighlight;
+        if (probe.strippedHeadline) {
+            return { headline: probe.strippedHeadline, summary: probe.summary ?? bestSummaryOnly };
+        }
+        if (!bestSummaryOnly && probe.summary) {
+            bestSummaryOnly = probe.summary;
+        }
+    }
+    return { headline: '', summary: bestSummaryOnly };
+}
+/**
+ * Read a single candidate artefact and classify what it can contribute
+ * to the highlight resolver. Extracted from
+ * {@link scanCandidatesForHighlight} to keep its cognitive complexity
+ * within the SonarJS budget.
+ *
+ * @param runDir - Absolute run directory
+ * @param rel - Run-relative artefact path
+ * @param articleType - Article-type slug for {@link isGenericHeading}
+ * @param date - ISO run date for {@link isGenericHeading}
+ * @returns
+ *   - `cleanHighlight` when the artefact has a non-generic H1 (caller may
+ *     return it directly)
+ *   - `strippedHeadline` when the H1 is generic but yields an editorial
+ *     core after {@link stripArtifactCategoryAffix}
+ *   - `summary` when the artefact carries a usable lede or strong prose
+ *     line (independent of the headline outcome)
+ */
+function probeCandidateForHighlight(runDir, rel, articleType, date) {
+    const abs = path.join(runDir, rel);
+    if (!fs.existsSync(abs))
+        return {};
+    const body = readArtefactBody(abs);
+    const headline = extractFirstH1(body);
+    const lede = extractLedeAfterHeading(body);
+    const summary = lede || extractStrongProseLine(body);
+    if (headline && !isGenericHeading(headline, articleType, date)) {
+        return { cleanHighlight: { headline: truncateTitle(headline), summary } };
+    }
+    if (headline) {
+        const stripped = stripArtifactCategoryAffix(headline);
+        if (stripped && !isGenericHeading(stripped, articleType, date)) {
+            return { strippedHeadline: truncateTitle(stripped), summary };
+        }
+    }
+    return { summary };
+}
 /**
  * Read an artefact file, skipping any SPDX HTML-comment header rows so the
  * first-H1 / first-prose logic is never derailed by the REUSE preamble.
@@ -763,7 +1200,13 @@ function manifestOverrideFor(value, lang) {
  */
 function resolveEditorialContent(opts) {
     const { articleType, date, markdown, runDir } = opts;
-    // Tier 2: first non-generic H1 in the first substantive artefact.
+    // Tier 2: first non-generic H1 in the first substantive artefact. We
+    // also remember any editorial summary harvested from a category-only
+    // artefact (e.g. `executive-brief.md` whose H1 is the structural
+    // `Executive Brief — …` label but whose `## 60-Second Read` paragraph
+    // is the journalist's lede) so the description tier can still benefit
+    // from real editorial copy when the headline tier falls through.
+    let artefactSummary = '';
     if (runDir) {
         const highlight = extractArtifactHighlight(runDir, articleType, date);
         if (highlight?.headline) {
@@ -772,6 +1215,9 @@ function resolveEditorialContent(opts) {
                 summary: highlight.summary,
             };
         }
+        if (highlight?.summary) {
+            artefactSummary = highlight.summary;
+        }
     }
     // Tier 3: first non-generic H1 in the aggregated Markdown itself.
     const aggregatedH1 = extractFirstH1(markdown);
@@ -779,12 +1225,16 @@ function resolveEditorialContent(opts) {
     if (aggregatedH1 && !isGenericHeading(aggregatedH1, articleType, date)) {
         return {
             headline: truncateTitle(aggregatedH1),
-            summary: aggregatedSummary,
+            summary: artefactSummary || aggregatedSummary,
         };
     }
     // Tier 4: first strong prose paragraph (title = same prose clipped).
-    if (aggregatedSummary) {
-        return { headline: truncateTitle(aggregatedSummary), summary: aggregatedSummary };
+    // Prefer the artefact-derived editorial summary when available so the
+    // description carries the journalist's lede rather than the
+    // aggregator-walk leftover.
+    const summary = artefactSummary || aggregatedSummary;
+    if (summary) {
+        return { headline: truncateTitle(summary), summary };
     }
     return { headline: '', summary: '' };
 }

package/scripts/config/article-horizons.js

@@ -58,6 +58,7 @@ const A_COMPARATIVE_INTL = 'extended/comparative-international.md';
 const A_EXEC_BRIEF = 'extended/executive-brief.md';
 const A_DEVILS_ADVOCATE = 'extended/devils-advocate-analysis.md';
 const A_INTEL_ASSESSMENT = 'extended/intelligence-assessment.md';
+const A_MEDIA_FRAMING = 'extended/media-framing-analysis.md';
 const A_DEEP_ANALYSIS_EXISTING = 'existing/deep-analysis.md';
 /** Stage budgets shared by the four short/mid prospective horizons.
  *  Sum 35 (A=5, B=22, C=4, D=2, E=2). Per-family B1→B2,
@@ -86,7 +87,13 @@ const STANDARD_FEEDS = [
     'get_external_documents',
 ];
 /** Mandatory artifacts shared by every prospective horizon. Long-horizon
- *  variants additionally require `forward-projection.md`. */
+ *  variants additionally require `forward-projection.md`.
+ *
+ *  `extended/media-framing-analysis.md` is mandatory for every horizon —
+ *  see [`analytical-supplementary-methodology.md` §AS4](../../analysis/methodologies/analytical-supplementary-methodology.md)
+ *  and [`per-artifact-methodologies.md` §media-framing-analysis](../../analysis/methodologies/per-artifact-methodologies.md).
+ *  Agents produce it during Pass 2 (or late Pass 1) once the rest of the
+ *  context is in place. */
 const PROSPECTIVE_MANDATORY = [
     A_SIGNIFICANCE,
     A_ACTOR_MAP,
@@ -105,9 +112,15 @@ const PROSPECTIVE_MANDATORY = [
     A_THREAT,
     A_MCP_AUDIT,
     A_INDEX,
+    A_MEDIA_FRAMING,
     A_REFLECTION,
 ];
-/** Mandatory artifacts shared by every retrospective horizon. */
+/** Mandatory artifacts shared by every retrospective horizon.
+ *
+ *  `extended/media-framing-analysis.md` is mandatory across every horizon
+ *  (see PROSPECTIVE_MANDATORY) — review runs build it from the same Pass-2
+ *  read-back so framing analysis lands after the underlying voting,
+ *  stakeholder and coalition artifacts are stable. */
 const RETROSPECTIVE_MANDATORY = [
     A_SIGNIFICANCE,
     A_ACTOR_MAP,
@@ -125,6 +138,7 @@ const RETROSPECTIVE_MANDATORY = [
     A_THREAT,
     A_MCP_AUDIT,
     A_INDEX,
+    A_MEDIA_FRAMING,
     A_REFLECTION,
 ];
 /** Mandatory artifacts unique to long-horizon prospective runs. */
@@ -345,6 +359,7 @@ export const ARTICLE_HORIZONS = {
             A_THREAT,
             A_MCP_AUDIT,
             A_INDEX,
+            A_MEDIA_FRAMING,
             A_REFLECTION,
         ],
         optionalArtifacts: [A_EXEC_BRIEF],

package/scripts/generators/news-indexes.js

@@ -292,7 +292,9 @@ export function generateIndexHTML(lang, articles, metaMap = new Map()) {
   <link rel="icon" type="image/png" sizes="16x16" href="images/favicon-16x16.png">
   <link rel="apple-touch-icon" sizes="180x180" href="images/apple-touch-icon.png">
   <link rel="manifest" href="site.webmanifest">
-  <meta name="theme-color" content="#003399">
+  <meta name="color-scheme" content="light dark">
+  <meta name="theme-color" content="#003399" media="(prefers-color-scheme: light)">
+  <meta name="theme-color" content="#0a1a38" media="(prefers-color-scheme: dark)">
   <link rel="alternate" type="application/rss+xml" title="EU Parliament Monitor RSS" href="rss.xml">
   <link rel="stylesheet" href="styles.css?v=${BUILD_SHORT}">
 ${buildHeadFreshnessTags('')}

package/scripts/mcp/ep-mcp-client.d.ts

@@ -7,7 +7,7 @@ import { MCPConnection } from './mcp-connection.js';
 import type { MCPClientOptions, MCPToolResult, GetMEPsOptions, GetPlenarySessionsOptions, SearchDocumentsOptions, GetParliamentaryQuestionsOptions, GetCommitteeInfoOptions, MonitorLegislativePipelineOptions, AssessMEPInfluenceOptions, AnalyzeCoalitionDynamicsOptions, DetectVotingAnomaliesOptions, ComparePoliticalGroupsOptions, VotingRecordsOptions, VotingPatternsOptions, GenerateReportOptions, AnalyzeLegislativeEffectivenessOptions, AnalyzeCommitteeActivityOptions, TrackMEPAttendanceOptions, AnalyzeCountryDelegationOptions, GeneratePoliticalLandscapeOptions, GetCurrentMEPsOptions, GetSpeechesOptions, GetProceduresOptions, GetAdoptedTextsOptions, GetEventsOptions, GetMeetingActivitiesOptions, GetMeetingDecisionsOptions, GetMEPDeclarationsOptions, GetIncomingMEPsOptions, GetOutgoingMEPsOptions, GetHomonymMEPsOptions, GetLatestVotesOptions, GetPlenaryDocumentsOptions, GetCommitteeDocumentsOptions, GetPlenarySessionDocumentsOptions, GetPlenarySessionDocumentItemsOptions, GetControlledVocabulariesOptions, GetExternalDocumentsOptions, GetMeetingForeseenActivitiesOptions, GetProcedureEventsOptions, GetMeetingPlenarySessionDocumentsOptions, GetMeetingPlenarySessionDocumentItemsOptions, NetworkAnalysisOptions, SentimentTrackerOptions, EarlyWarningSystemOptions, ComparativeIntelligenceOptions, CorrelateIntelligenceOptions, GetAllGeneratedStatsOptions, GetMEPsFeedOptions, GetEventsFeedOptions, GetProceduresFeedOptions, GetAdoptedTextsFeedOptions, GetMEPDeclarationsFeedOptions, GetDocumentsFeedOptions, GetPlenaryDocumentsFeedOptions, GetCommitteeDocumentsFeedOptions, GetPlenarySessionDocumentsFeedOptions, GetExternalDocumentsFeedOptions, GetParliamentaryQuestionsFeedOptions, GetCorporateBodiesFeedOptions, GetControlledVocabulariesFeedOptions, GetProcedureEventByIdOptions, GetFreshProceduresOptions } from '../types/index.js';
 /**
  * Canonical list of tools exposed by the European Parliament MCP gateway
- * (`european-parliament-mcp-server@1.3.0`). The news workflows, prompt
+ * (`european-parliament-mcp-server@1.3.2`). The news workflows, prompt
  * library (`.github/prompts/07-mcp-reference.md`), and the integration test
  * suite all reference this list so a regression that adds/removes a tool
  * fails a single drift guard
@@ -22,7 +22,7 @@ export declare const EP_MCP_TOOLS: readonly string[];
  * covering the two shapes historically emitted by the EP MCP server.
  *
  * 1. **Uniform envelope** (all feeds as of
- *    `european-parliament-mcp-server@1.3.0`) —
+ *    `european-parliament-mcp-server@1.3.2`) —
  *    `{status:"unavailable", items:[], generatedAt:"..."}` established by
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
@@ -206,9 +206,9 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
      *
      * @remarks
      * This repository is currently documented/configured against
-     * `european-parliament-mcp-server@1.3.0`.
+     * `european-parliament-mcp-server@1.3.2`.
      *
-     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.3.0 server):** the upstream server
+     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.3.2 server):** the upstream server
      * applies a server-side post-filter on `dateFrom`/`dateTo` before serialisation, because the
      * EP Open Data Portal `/meetings` endpoint silently ignores its `date-from`/`date-to` query
      * parameters (Defect #5). Under this contract:
@@ -217,7 +217,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
      * - Per-window session counts are reproducible because the EP-side regression is masked by
      *   the upstream post-filter.
      *
-     * No local post-filter is applied here. The repository is pinned to v1.3.0, so the
+     * No local post-filter is applied here. The repository is pinned to v1.3.2, so the
      * date-filter guarantees above apply; consumers running against an older server image
      * (pre-v1.2.14) must not assume them.
      */
@@ -529,7 +529,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
      * dataSource: EP_DOCEO_XML) — typically available within minutes of a
      * plenary vote, unlike the regular EP API which has a multi-week delay.
      *
-     * New in `european-parliament-mcp-server@1.3.0`.
+     * New in `european-parliament-mcp-server@1.3.1`.
      *
      * @param options - Pagination options
      * @returns Latest plenary vote records with NEAR_REALTIME freshness

package/scripts/mcp/ep-mcp-client.js

@@ -11,7 +11,7 @@ import { recordPendingDocument, markDocumentResolved, getPendingDocumentsForRepr
 import { EP_NEXT_ELECTION_START, EP_NEXT_ELECTION_END, EP_CURRENT_TERM, EP_NEXT_TERM, } from '../constants/config.js';
 /**
  * Canonical list of tools exposed by the European Parliament MCP gateway
- * (`european-parliament-mcp-server@1.3.0`). The news workflows, prompt
+ * (`european-parliament-mcp-server@1.3.2`). The news workflows, prompt
  * library (`.github/prompts/07-mcp-reference.md`), and the integration test
  * suite all reference this list so a regression that adds/removes a tool
  * fails a single drift guard
@@ -116,7 +116,7 @@ const CONTENT_NOT_YET_AVAILABLE_SUBSTRING = 'document indexed but content not ye
 /**
  * Classify an error message into a diagnostic error category.
  *
- * Maps EP MCP Server v1.3.0 structured error codes and generic HTTP/network
+ * Maps EP MCP Server v1.3.2 structured error codes and generic HTTP/network
  * errors into one of six broad categories used for logging and retry decisions:
  *
  * Returned categories (priority order):
@@ -132,7 +132,7 @@ const CONTENT_NOT_YET_AVAILABLE_SUBSTRING = 'document indexed but content not ye
  */
 function classifyToolError(message) {
     const lowerMsg = message.toLowerCase();
-    // EP MCP Server v1.3.0 structured error codes (matched case-insensitively)
+    // EP MCP Server v1.3.2 structured error codes (matched case-insensitively)
     if (lowerMsg.includes('internal_error')) {
         return 'INTERNAL_ERROR';
     }
@@ -191,7 +191,7 @@ function _parseResultPayload(result) {
  * covering the two shapes historically emitted by the EP MCP server.
  *
  * 1. **Uniform envelope** (all feeds as of
- *    `european-parliament-mcp-server@1.3.0`) —
+ *    `european-parliament-mcp-server@1.3.2`) —
  *    `{status:"unavailable", items:[], generatedAt:"..."}` established by
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
@@ -592,9 +592,9 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
      *
      * @remarks
      * This repository is currently documented/configured against
-     * `european-parliament-mcp-server@1.3.0`.
+     * `european-parliament-mcp-server@1.3.2`.
      *
-     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.3.0 server):** the upstream server
+     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.3.2 server):** the upstream server
      * applies a server-side post-filter on `dateFrom`/`dateTo` before serialisation, because the
      * EP Open Data Portal `/meetings` endpoint silently ignores its `date-from`/`date-to` query
      * parameters (Defect #5). Under this contract:
@@ -603,7 +603,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
      * - Per-window session counts are reproducible because the EP-side regression is masked by
      *   the upstream post-filter.
      *
-     * No local post-filter is applied here. The repository is pinned to v1.3.0, so the
+     * No local post-filter is applied here. The repository is pinned to v1.3.2, so the
      * date-filter guarantees above apply; consumers running against an older server image
      * (pre-v1.2.14) must not assume them.
      */
@@ -1111,7 +1111,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
      * dataSource: EP_DOCEO_XML) — typically available within minutes of a
      * plenary vote, unlike the regular EP API which has a multi-week delay.
      *
-     * New in `european-parliament-mcp-server@1.3.0`.
+     * New in `european-parliament-mcp-server@1.3.1`.
      *
      * @param options - Pagination options
      * @returns Latest plenary vote records with NEAR_REALTIME freshness

package/scripts/templates/section-builders.d.ts

@@ -122,9 +122,8 @@ export declare function buildSiteHeader(options: SiteHeaderOptions): string;
 /**
  * Build the full-width page banner shown below the sticky site header on every page.
  *
- * The banner image (`banner.webp` / `banner.jpg`) is 1200×400. CSS renders it with
- * `object-fit: cover; object-position: center` so the middle 80% of the image is
- * always visible and the uninteresting top/bottom 10% may be cropped.
+ * The banner image (`banner.webp` / `banner.jpg`) is 1200×400. CSS renders it
+ * at its native 3:1 ratio so the full artwork remains visible on every viewport.
  *
  * @param pathPrefix - Asset path prefix: `''` for root pages, `'../'` for `news/` pages.
  * @returns HTML string for the `.page-banner` element.

package/scripts/templates/section-builders.js

@@ -300,7 +300,7 @@ export function buildSiteHeader(options) {
       <a href="${escapeHTML(homeHref)}" class="site-header__brand" aria-label="${safeTitle}">
         <picture class="site-header__logo-picture">
           <source srcset="${pathPrefix}images/banner.webp" type="image/webp">
-          <img class="site-header__logo site-header__logo--banner" src="${pathPrefix}images/banner.jpg" alt="${safeTitle}" width="180" height="60" loading="eager">
+          <img class="site-header__logo site-header__logo--banner" src="${pathPrefix}images/banner.jpg" alt="${safeTitle}" width="240" height="80" loading="eager">
         </picture>
         <span class="site-header__brand-text">
           <span class="site-header__title">${safeTitle}</span>
@@ -308,10 +308,14 @@ export function buildSiteHeader(options) {
         </span>
       </a>
       <div class="site-header__actions">
-        ${piCta}${cta('site-header__cta--sponsor', 'https://github.com/sponsors/Hack23', 'heart', sponsorLabel)}
-        ${cta('', 'https://www.hack23.com', 'sponsor', becomeSponsorLabel)}
-        ${cta('site-header__cta--security', 'https://github.com/Hack23/euparliamentmonitor/blob/main/SECURITY.md', ICON_SECURITY, securityLabel)}
-        ${createThemeToggleButton(themeToggleLabel)}
+        <div class="site-header__cta-group">
+          ${piCta}${cta('site-header__cta--sponsor', 'https://github.com/sponsors/Hack23', 'heart', sponsorLabel)}
+          ${cta('', 'https://www.hack23.com', 'sponsor', becomeSponsorLabel)}
+          ${cta('site-header__cta--security', 'https://github.com/Hack23/euparliamentmonitor/blob/main/SECURITY.md', ICON_SECURITY, securityLabel)}
+        </div>
+        <div class="site-header__theme-toggle-slot">
+          ${createThemeToggleButton(themeToggleLabel)}
+        </div>
       </div>
       <nav class="site-header__langs" role="navigation" aria-label="${langSelectionLabel}">
         ${languageSwitcherHtml}
@@ -322,9 +326,8 @@ export function buildSiteHeader(options) {
 /**
  * Build the full-width page banner shown below the sticky site header on every page.
  *
- * The banner image (`banner.webp` / `banner.jpg`) is 1200×400. CSS renders it with
- * `object-fit: cover; object-position: center` so the middle 80% of the image is
- * always visible and the uninteresting top/bottom 10% may be cropped.
+ * The banner image (`banner.webp` / `banner.jpg`) is 1200×400. CSS renders it
+ * at its native 3:1 ratio so the full artwork remains visible on every viewport.
  *
  * @param pathPrefix - Asset path prefix: `''` for root pages, `'../'` for `news/` pages.
  * @returns HTML string for the `.page-banner` element.
@@ -412,12 +415,12 @@ export function buildSiteFooter(options) {
     return `<footer class="site-footer" role="contentinfo">
     <div class="footer-content">
       <div class="footer-section">
-        <h3>${aboutHeading}</h3>
+        <h3 class="footer-section__heading">${aboutHeading}</h3>
         <p>${aboutText}</p>${articlesLine}
         <p class="footer-company-summary">${companyTagline}</p>
       </div>
       <div class="footer-section">
-        <h3>${quickLinksHeading}</h3>
+        <h3 class="footer-section__heading">${quickLinksHeading}</h3>
         <ul>
           <li><a href="${homeHref}">${icon('home')}<span>${homeLabel}</span></a></li>
           <li><a href="${homeHref}#main">${icon('news')}<span>${newsLabel}</span></a></li>
@@ -438,7 +441,7 @@ export function buildSiteFooter(options) {
         </ul>
       </div>
       <div class="footer-section">
-        <h3>${builtByHeading}</h3>
+        <h3 class="footer-section__heading">${builtByHeading}</h3>
         <div class="footer-badges" aria-label="${escapeHTML(getLocalizedString(FOOTER_TRUST_BADGES_ARIA_LABELS, lang))}">
           <a href="https://www.npmjs.com/package/euparliamentmonitor" aria-label="npm package version"><img src="https://img.shields.io/npm/v/euparliamentmonitor.svg" alt="npm package version"></a>
           <a href="https://scorecard.dev/viewer/?uri=github.com/Hack23/euparliamentmonitor" aria-label="OpenSSF Scorecard"><img src="https://api.securityscorecards.dev/projects/github.com/Hack23/euparliamentmonitor/badge" alt="OpenSSF Scorecard"></a>
@@ -468,7 +471,7 @@ export function buildSiteFooter(options) {
         </ul>
       </div>
       <div class="footer-section">
-        <h3>${icon('lang')} ${languagesHeading}</h3>
+        <h3 class="footer-section__heading">${icon('lang')} ${languagesHeading}</h3>
         <div class="language-grid">
           ${langGrid}
         </div>

package/scripts/types/mcp.d.ts

@@ -287,7 +287,7 @@ export interface GetHomonymMEPsOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getLatestVotes (DOCEO-backed near-real-time vote enrichment, new in v1.3.0) */
+/** Options for getLatestVotes (DOCEO-backed near-real-time vote enrichment, new in v1.3.1) */
 export interface GetLatestVotesOptions {
     /** Maximum number of recent vote records to return (default: 50) */
     limit?: number | undefined;