euparliamentmonitor 0.9.12 → 0.9.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.9.12",
+  "version": "0.9.14",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -63,6 +63,9 @@
     "build:check-tests": "tsc --project tsconfig.test.json --noEmit",
     "copy-vendor": "node scripts/copy-vendor.js",
     "validate-analysis": "node scripts/validate-analysis-completeness.js",
+    "discover:untranslated-briefs": "node scripts/discover-untranslated-briefs.js",
+    "validate:translations": "node scripts/validate-brief-translations.js",
+    "validate:manifest-seo": "node scripts/validate-manifest-seo.js",
     "sync:templates": "node scripts/templates/sync-template-frontmatter.js",
     "sync:templates:check": "node scripts/templates/sync-template-frontmatter.js --check",
     "prior-run-diff": "node scripts/aggregator/prior-run-diff.js",
@@ -76,6 +79,7 @@
     "validate-ep-api": "npx tsx src/utils/validate-ep-api.ts",
     "mcp:probe": "npx tsx src/utils/mcp-probe.ts",
     "lint:prompts": "node scripts/lint-prompts.js",
+    "lint:src-todos": "node scripts/lint-src-todos.js",
     "htmlhint": "sh -c 'htmlhint *.html; set -- news/*.html; if [ -e \"$1\" ]; then htmlhint \"$@\"; else echo \"No news/*.html files to lint\"; fi'",
     "serve": "python3 -m http.server 8080",
     "test": "vitest run",
@@ -89,7 +93,7 @@
     "test:e2e:headed": "playwright test --headed",
     "test:e2e:debug": "playwright test --debug",
     "test:e2e:report": "playwright show-report",
-    "lint": "eslint src/",
+    "lint": "eslint src/ && node scripts/lint-src-todos.js",
     "lint:fix": "eslint src/ --fix",
     "knip": "knip",
     "knip:production": "knip --production",
@@ -165,13 +169,14 @@
     "eslint-plugin-jsdoc": "62.9.0",
     "eslint-plugin-security": "4.0.0",
     "eslint-plugin-sonarjs": "4.0.3",
+    "fast-check": "^4.8.0",
     "happy-dom": "20.9.0",
     "html-minifier-terser": "^7.2.0",
     "htmlhint": "1.9.2",
     "husky": "9.1.7",
-    "jscpd": "4.2.1",
+    "jscpd": "4.2.3",
     "knip": "^6.7.0",
-    "lint-staged": "17.0.4",
+    "lint-staged": "17.0.5",
     "mermaid": "11.15.0",
     "papaparse": "5.5.3",
     "prettier": "3.8.3",
@@ -179,7 +184,7 @@
     "sharp": "^0.34.5",
     "terser": "^5.47.1",
     "ts-api-utils": "2.5.0",
-    "tsx": "4.22.0",
+    "tsx": "4.22.1",
     "typedoc": "0.28.19",
     "typescript": "6.0.3",
     "vitest": "4.1.6"

package/scripts/aggregator/analysis-aggregator.js

@@ -18,6 +18,10 @@ import { buildKeyTakeaways, KEY_TAKEAWAYS_SECTION_ID, KEY_TAKEAWAYS_SECTION_TITL
 import { flattenManifestFiles as _flattenManifestFiles, latestGateResult as _latestGateResult, resolveArticleType as _resolveArticleType, resolveRunId as _resolveRunId, } from './manifest/index.js';
 import { READER_GUIDE_SECTION_ID, READER_GUIDE_SECTION_IDS, READER_GUIDE_SECTION_TITLE, } from './reader-guide-constants.js';
 export { READER_GUIDE_SECTION_ID, READER_GUIDE_SECTION_IDS, READER_GUIDE_SECTION_TITLE, } from './reader-guide-constants.js';
+const TRADECRAFT_EXCLUDED_FILES = new Set([
+    'analysis/methodologies/executive-brief-translation-guide.md',
+    'analysis/templates/executive-brief-translation-template.md',
+]);
 /**
  * Normalise `manifest.files` into a flat list of `runRelPath` strings.
  *
@@ -94,8 +98,9 @@ export function discoverTradecraftFiles(repoRoot) {
             continue;
         const entries = fs.readdirSync(dir, { withFileTypes: true });
         for (const entry of entries) {
-            if (entry.isFile() && entry.name.endsWith('.md')) {
-                result.push(`${sub}/${entry.name}`);
+            const rel = `${sub}/${entry.name}`;
+            if (entry.isFile() && entry.name.endsWith('.md') && !TRADECRAFT_EXCLUDED_FILES.has(rel)) {
+                result.push(rel);
             }
         }
     }

package/scripts/aggregator/article-generator.js

@@ -366,6 +366,7 @@ function writeLanguageVariant(lang, slug, aggregated, englishHtml, chromeOptions
         body: bodyHtml,
         title: entry.title,
         description: perLangDescription,
+        extendedDescription: entry.extendedDescription,
         keywords: entry.keywords,
         date: aggregated.date,
         articleType: aggregated.articleType,
@@ -444,7 +445,7 @@ function getMetadataEntry(map, lang) {
         return descriptor.value;
     }
     const en = Object.getOwnPropertyDescriptor(map, 'en')?.value;
-    return en ?? { title: '', description: '', keywords: [] };
+    return (en ?? { title: '', description: '', extendedDescription: '', keywords: [], source: 'template' });
 }
 /**
  * Count the number of articles the site currently publishes, derived
@@ -699,6 +700,7 @@ function applyCliOverrides(base, titleOverride, descriptionOverride) {
                 title: titleOverride ?? entry.title,
                 description: descriptionOverride ?? entry.description,
                 keywords: entry.keywords,
+                source: titleOverride || descriptionOverride ? 'manifest' : entry.source,
             },
             enumerable: true,
             writable: true,

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

@@ -21,6 +21,15 @@ export interface WrapArticleOptions {
     readonly title: string;
     /** Article description — shown in `<meta name="description">` and OG. */
     readonly description: string;
+    /**
+     * Optional: longer (up to ~300 chars) editorial summary lifted from
+     * the language-specific executive brief BLUF. When provided, used
+     * for `og:description` and `twitter:description`; falls back to
+     * `description` when absent. Lets social-card previews show the
+     * full BLUF paragraph while the short `<meta description>` stays
+     * within Google's ~160-char snippet budget.
+     */
+    readonly extendedDescription?: string;
     /** SEO keywords — shown in `<meta name="keywords">`. */
     readonly keywords?: readonly string[];
     /** Canonical ISO date of the run (YYYY-MM-DD). */

package/scripts/aggregator/article-html.js

@@ -21,8 +21,11 @@
 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, 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 { buildOgLocaleTags } from '../constants/og-locales.js';
+import { ORG_SAME_AS, buildTwitterAttributionTags } from '../constants/social-handles.js';
 import { ArticleCategory } from '../types/index.js';
 import { escapeHTML } from '../utils/file-utils.js';
+import { stripHtmlTags } from '../utils/html-sanitize.js';
 import { buildResponsiveIconLinks, buildResponsiveSocialImageMeta, buildSiteFooter, buildSiteHeader, buildPageBanner, } from '../templates/section-builders.js';
 import { READER_GUIDE_SECTION_ID } from './reader-guide-constants.js';
 import { READER_GUIDE_TITLE_LABELS, getReaderGuideSectionIcon, } from './reader-intelligence-guide.js';
@@ -32,6 +35,63 @@ import { KEY_TAKEAWAYS_SECTION_ID } from './key-takeaways.js';
 import { getPoliticalIntelligenceFilename } from '../generators/political-intelligence.js';
 import { getSitemapFilename } from '../generators/sitemap/index.js';
 import { getCuratedTitle, getCuratedDescription, getArtifactInfo, } from '../generators/political-intelligence-descriptions.js';
+/**
+ * Resolve a localized article type label *without* the leading icon
+ * emoji. Used for the OpenGraph `article:section` meta and the JSON-LD
+ * `articleSection` field, where emoji break Google's NewsArticle
+ * structured-data validator.
+ *
+ * @param slug - Raw article type slug (e.g. "motions", "week-ahead")
+ * @param lang - Target language code
+ * @returns Localized label without icon (e.g. "Plenary Votes & Resolutions")
+ */
+function getLocalizedArticleTypePlain(slug, lang) {
+    const labels = getLocalizedString(ARTICLE_TYPE_LABELS, lang);
+    return labels[slug] ?? slug.replace(/-/g, ' ');
+}
+/**
+ * Google's NewsArticle structured-data validator hard-caps the
+ * `headline` field at 110 characters. Page `<title>` can be longer
+ * (we already truncate to a higher limit in
+ * `article-metadata.ts::truncateTitle`), but the JSON-LD headline
+ * needs its own, tighter cap or the article loses Top Stories
+ * carousel eligibility.
+ *
+ * Truncation prefers the last sentence boundary or em-dash within
+ * the 110-char window so we don't slice through a noun phrase.
+ *
+ * @param title - Resolved article title (already escaped-safe text)
+ * @returns Headline ≤ 110 characters, suitable for `NewsArticle.headline`
+ */
+const HEADLINE_LIMIT = 110;
+function truncateHeadline(title) {
+    const trimmed = title.trim();
+    if (trimmed.length <= HEADLINE_LIMIT)
+        return trimmed;
+    // Prefer the last em-dash, en-dash, colon, or sentence boundary
+    // before the limit so the truncated headline still reads as a
+    // self-contained phrase.
+    const window = trimmed.slice(0, HEADLINE_LIMIT);
+    const breakIdx = Math.max(window.lastIndexOf(' — '), window.lastIndexOf(' – '), window.lastIndexOf(': '), window.lastIndexOf('. '), window.lastIndexOf(' '));
+    return breakIdx > 60 ? window.slice(0, breakIdx).trimEnd() : window.trimEnd();
+}
+/**
+ * Build the localized `<title>` separator for the
+ * `{articleTitle} {sep} {siteTitle}` pattern. LTR locales use the
+ * right-pointing guillemet (»); RTL locales (Arabic, Hebrew) use the
+ * left-pointing guillemet («) so the visual hierarchy reads from the
+ * primary title towards the site name without breaking bidi flow.
+ *
+ * The previous em-dash separator collided with em-dashes inside
+ * article titles (the editorial style uses `Title — Subtitle`) and
+ * rendered ambiguously in screen readers.
+ *
+ * @param lang - Target language code
+ * @returns `" » "` for LTR locales, `" « "` for RTL
+ */
+function getTitleSeparator(lang) {
+    return getTextDirection(lang) === 'rtl' ? ' « ' : ' » ';
+}
 /**
  * Resolve a localized article type label with icon. Falls back to the
  * humanised slug when a translation isn't available.
@@ -879,24 +939,69 @@ export function wrapArticleHtml(options) {
         : '';
     const tocHtml = buildArticleToc(options.toc ?? [], safeLang);
     const articleMainClass = tocHtml.length > 0 ? 'article-main--with-toc' : 'article-main--no-toc';
+    const articleSectionLabel = getLocalizedArticleTypePlain(options.articleType, safeLang);
+    // Count words from the rendered body for the JSON-LD `wordCount`
+    // field (Google's NewsArticle structured-data validator emits a
+    // warning when this is missing). Done by stripping HTML tags from
+    // the rendered body then splitting on whitespace — fast and
+    // CodeQL-safe.
+    const bodyText = stripHtmlTags(options.body);
+    const wordCount = bodyText.split(/\s+/u).filter((w) => w.length > 0).length;
+    // Build the JSON-LD image graph. Google requires NewsArticle.image
+    // to be an array (or single ImageObject) with explicit width/height
+    // covering at least one of the 1:1, 4:3, 16:9 aspect ratios for
+    // Top Stories carousel eligibility.
+    const jsonLdImages = [
+        {
+            '@type': 'ImageObject',
+            url: `${BASE_URL}/images/og-image-1200.jpg`,
+            width: 1200,
+            height: 630,
+        },
+        {
+            '@type': 'ImageObject',
+            url: `${BASE_URL}/images/og-image-1200.webp`,
+            width: 1200,
+            height: 630,
+        },
+        {
+            '@type': 'ImageObject',
+            url: `${BASE_URL}/images/og-image-1200.avif`,
+            width: 1200,
+            height: 630,
+        },
+    ];
     const jsonLd = {
         '@context': 'https://schema.org',
         '@type': 'NewsArticle',
-        headline: options.title,
+        headline: truncateHeadline(options.title),
         description: options.description,
         datePublished: options.date,
         dateModified: options.date,
         inLanguage: safeLang,
         url: canonicalUrl,
-        image: `${BASE_URL}/images/og-image-1200.jpg`,
-        author: { '@type': 'Organization', name: PUBLISHER_NAME, url: 'https://hack23.com' },
+        mainEntityOfPage: { '@type': 'WebPage', '@id': canonicalUrl },
+        image: jsonLdImages,
+        author: {
+            '@type': 'NewsMediaOrganization',
+            name: PUBLISHER_NAME,
+            url: 'https://hack23.com',
+            sameAs: [...ORG_SAME_AS],
+        },
         publisher: {
-            '@type': 'Organization',
+            '@type': 'NewsMediaOrganization',
             name: PUBLISHER_NAME,
             url: 'https://hack23.com',
             logo: { '@type': 'ImageObject', url: `${BASE_URL}/images/apple-touch-icon.png` },
+            sameAs: [...ORG_SAME_AS],
+        },
+        articleSection: articleSectionLabel,
+        wordCount,
+        keywords: (options.keywords ?? []).join(', '),
+        speakable: {
+            '@type': 'SpeakableSpecification',
+            cssSelector: ['.article-dek', '.article-body > p:first-of-type'],
         },
-        articleSection: options.articleType,
         isPartOf: {
             '@type': 'WebSite',
             name: SITE_NAME,
@@ -921,7 +1026,7 @@ export function wrapArticleHtml(options) {
             {
                 '@type': 'ListItem',
                 position: 2,
-                name: options.articleType.replace(/-/g, ' '),
+                name: articleSectionLabel,
                 item: `${BASE_URL}/news/`,
             },
             {
@@ -934,11 +1039,21 @@ export function wrapArticleHtml(options) {
     };
     const structuredData = [jsonLd, breadcrumbLd];
     const jsonLdString = JSON.stringify(structuredData).replace(/</g, '\\u003c');
-    const pageTitle = `${options.title} — ${siteTitle}`;
+    const pageTitle = `${options.title}${getTitleSeparator(safeLang)}${siteTitle}`;
     const keywords = (options.keywords ?? []).map((keyword) => keyword.trim()).filter(Boolean);
     const keywordsMeta = keywords.length > 0
         ? `  <meta name="keywords" content="${escapeHTML(keywords.join(', '))}">\n`
         : '';
+    // Use the longer extended description for og:description/twitter:description
+    // when available so social-card previews show the full BLUF
+    // paragraph; the short meta description stays within Google's
+    // ~160-char snippet budget.
+    const socialDescription = options.extendedDescription && options.extendedDescription.length > 0
+        ? options.extendedDescription
+        : options.description;
+    const ogLocaleTags = buildOgLocaleTags(safeLang);
+    const twitterAttribution = buildTwitterAttributionTags();
+    const twitterAttributionBlock = twitterAttribution ? `\n${twitterAttribution}` : '';
     const header = buildSiteHeader({
         lang: safeLang,
         pathPrefix: '../',
@@ -956,23 +1071,29 @@ export function wrapArticleHtml(options) {
   <meta name="referrer" content="no-referrer">
   <title>${escapeHTML(pageTitle)}</title>
   <meta name="description" content="${escapeHTML(options.description)}">
-${keywordsMeta}  <meta name="robots" content="index, follow, max-image-preview:large">
+${keywordsMeta}  <meta name="robots" content="index, follow, max-snippet:-1, max-image-preview:large">
   <meta name="author" content="${PUBLISHER_NAME}">
   <meta name="publisher" content="${PUBLISHER_NAME}">
   <meta name="date" content="${options.date}">
-  <meta name="article:published_time" content="${options.date}">
+  <meta property="article:published_time" content="${options.date}">
+  <meta property="article:modified_time" content="${options.date}">
+  <meta property="article:section" content="${escapeHTML(articleSectionLabel)}">
+  <meta property="article:author" content="${PUBLISHER_NAME}">
+  <meta property="article:publisher" content="https://hack23.com">
   <link rel="canonical" href="${canonicalUrl}">
 ${hreflangLinks}
+  <link rel="alternate" type="application/rss+xml" title="EU Parliament Monitor RSS" href="${BASE_URL}/rss.xml">
+  <link rel="preconnect" href="https://hack23.com" crossorigin>
   <meta property="og:type" content="article">
   <meta property="og:title" content="${escapeHTML(options.title)}">
-  <meta property="og:description" content="${escapeHTML(options.description)}">
+  <meta property="og:description" content="${escapeHTML(socialDescription)}">
   <meta property="og:url" content="${canonicalUrl}">
   <meta property="og:site_name" content="EU Parliament Monitor">
-  <meta property="og:locale" content="${safeLang}">
-${buildResponsiveSocialImageMeta(`${options.title} — EU Parliament Monitor`)}
+${ogLocaleTags}
+${buildResponsiveSocialImageMeta(`${options.title}${getTitleSeparator(safeLang)}EU Parliament Monitor`)}
   <meta name="twitter:card" content="summary_large_image">
   <meta name="twitter:title" content="${escapeHTML(options.title)}">
-  <meta name="twitter:description" content="${escapeHTML(options.description)}">
+  <meta name="twitter:description" content="${escapeHTML(socialDescription)}">${twitterAttributionBlock}
 ${buildResponsiveIconLinks('../')}
   <link rel="manifest" href="../site.webmanifest">
   <meta name="color-scheme" content="light dark">

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

@@ -3,7 +3,30 @@ import type { LangTitleSubtitle, LanguageCode, LanguageMap } from '../types/inde
 export interface ResolvedMetadataEntry {
     readonly title: string;
     readonly description: string;
+    /**
+     * Optional longer (up to ~300 chars) editorial summary lifted from
+     * the language-specific executive brief BLUF paragraph. Used for
+     * `og:description` and `twitter:description` so social-card previews
+     * can show the full Bottom-Line-Up-Front context, while the
+     * short `description` stays within Google's ~160-char snippet
+     * budget. Empty string when no longer summary is available — the
+     * caller should then fall back to {@link description}.
+     */
+    readonly extendedDescription: string;
     readonly keywords: readonly string[];
+    /**
+     * `"localized-brief"` when the title/description came from a translated
+     * `executive-brief_<lang>.md`; `"english-brief"` when the locale fell
+     * through to the English brief; `"english-editorial"` when the locale
+     * used an aggregated-Markdown / artefact source; `"template"` when only
+     * the localized type/date template was available. For `lang === 'en'`
+     * the value is always `"english-brief"` or `"english-editorial"` or
+     * `"template"` (no fall-through). Lets downstream consumers — the
+     * news-index, the static-site fallback note, the manifest-SEO
+     * validator — record the asymmetry called out in
+     * [`.github/prompts/04-article-generation.md`](../../.github/prompts/04-article-generation.md) § 6.2 priority 3.
+     */
+    readonly source: 'manifest' | 'localized-brief' | 'english-brief' | 'english-editorial' | 'template';
 }
 /** Fully resolved metadata — one entry per supported language. */
 export type ResolvedMetadata = LanguageMap<ResolvedMetadataEntry>;
@@ -50,69 +73,7 @@ export interface ResolveMetadataOptions {
      */
     readonly runDir?: string;
 }
-/**
- * Return `true` when a line cannot serve as a prose description. Rejects
- * Markdown structural lines (headings, blockquotes, tables, HTML),
- * mermaid/chart directives, emoji-banner metadata rows, and the known
- * `Key: value` banners that Stage-B agents emit as artefact preamble.
- *
- * @param line - Trimmed line from the aggregated Markdown source
- * @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
- * 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
- */
-export declare function stripInlineMarkdown(raw: string): string;
-/**
- * Clamp a string to `DESCRIPTION_MAX_LENGTH` characters, appending
- * an ellipsis when truncation actually happens. Does not break words if
- * avoidable — a trailing partial word is trimmed back to the previous
- * space first.
- *
- * @param text - Raw description text
- * @returns Truncated description with trailing ellipsis when clipped
- */
-export declare function truncateDescription(text: string): string;
-/**
- * Clamp a title to `TITLE_MAX_LENGTH` characters in the same
- * word-boundary-preserving fashion as {@link truncateDescription}.
- *
- * @param text - Raw title text
- * @returns Truncated title with trailing ellipsis when clipped
- */
-export declare function truncateTitle(text: string): string;
+export { shouldSkipDescriptionLine, stripLeadingProseLabel, stripInlineMarkdown, truncateDescription, truncateExtendedDescription, truncateTitle, extractFirstSentence, } from './metadata/text-utils.js';
 /**
  * Return the first Markdown H1 (`# …`) in the supplied text, stripped of
  * the leading `#` and trailing anchor syntax. Returns an empty string when
@@ -123,30 +84,33 @@ export declare function truncateTitle(text: string): string;
  */
 export declare function extractFirstH1(markdown: string): string;
 /**
- * Walk every line of the Markdown source and return the first line that
- * survives {@link shouldSkipDescriptionLine}. Inline Markdown decorations
- * are stripped and the result is truncated to fit `<meta description>`.
+ * Walk every line of the Markdown source and return the first paragraph
+ * that survives {@link shouldSkipDescriptionLine}. Consecutive non-blank
+ * prose lines are joined with a single space so hard-wrapped ledes
+ * (column-95 conventional wrap) produce a clean 140-180-character
+ * description rather than just the first 60-90-char line.
+ *
+ * Inline Markdown decorations are stripped and the result is truncated
+ * to fit `<meta description>`.
  *
  * @param markdown - Markdown source
  * @returns Prose description, or empty string when nothing qualifies
  */
 export declare function extractStrongProseLine(markdown: string): string;
+export declare function extractLedeAfterHeading(markdown: string): string;
 /**
- * Walk the body of an editorial artefact and, when it contains a `## …`
- * heading whose text matches one of `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>`.
+ * Same parsing rules as {@link extractLedeAfterHeading} but with a
+ * larger byte budget so the full BLUF paragraph (typically 200-300
+ * characters in the editorial style guide) is captured for use as
+ * `og:description` / `twitter:description`. Returns the joined
+ * paragraph clamped via {@link truncateExtendedDescription} (which
+ * returns `''` when the result wouldn't be longer than the regular
+ * meta description).
  *
- * @param markdown - Editorial artefact source
- * @returns Lede paragraph, or empty string when none matched
+ * @param markdown - Brief body (SPDX preamble already stripped)
+ * @returns Extended lede paragraph, or `''` when not worth emitting
  */
-export declare function extractLedeAfterHeading(markdown: string): string;
+export declare function extractExtendedLedeAfterHeading(markdown: string): string;
 /**
  * Return `true` when an artefact-H1 begins with one of the
  * `ARTIFACT_CATEGORY_PREFIXES` followed by a separator. Such H1s
@@ -217,6 +181,48 @@ export declare function extractArtifactHighlight(runDir: string, articleType: st
     readonly headline: string;
     readonly summary: string;
 } | null;
+/**
+ * Return `true` when a top-level `.md` filename looks like a translated
+ * sibling of a canonical editorial artefact (e.g.
+ * `executive-brief_ar.md`). These files must be excluded from the
+ * top-level fallback scan in {@link extractArtifactHighlight} because
+ * their localized H1s evade the English-only generic-heading detector
+ * and would otherwise hijack the English SEO surfaces.
+ *
+ * @param filename - Run-relative `.md` filename (no path separators)
+ * @returns `true` when the file is a translated sibling brief
+ */
+export declare function isTranslatedSiblingBrief(filename: string): boolean;
+/**
+ * Mine the FIRST named priority finding from an executive-brief–style
+ * artefact body. Looks for a section heading from
+ * {@link PRIORITY_FINDING_SECTION_HEADINGS} and returns the first dossier
+ * name + descriptive paragraph found inside it. Supports the three
+ * canonical Stage-B authoring patterns:
+ *
+ *   1. **Bold-in-numbered-list** (breaking briefs):
+ *      `1. **Digital Markets Act Enforcement** (TA-10-2026-0160, 2026-04-30)`
+ *      `   Parliament adopted a resolution …`
+ *   2. **Numbered subheading** (committee briefs):
+ *      `### 1. Clean Industrial Deal Implementation (ITRE/ENVI)`
+ *      `The Clean Industrial Deal framework …`
+ *   3. **Bold-leading paragraph** (synthesis variants):
+ *      `**Trigger 1: DMA Enforcement Resolution** (TA-10-2026-0160)`
+ *      `- Significance: 🟢 HIGH IMPACT …`
+ *
+ * Trailing parenthesised metadata (`(TA-10-2026-0160, 2026-04-30)`,
+ * `(ITRE/ENVI)`) is stripped from the headline so it stays headline-shaped
+ * (`Digital Markets Act Enforcement`) rather than boilerplate
+ * (`Digital Markets Act Enforcement (TA-10-2026-0160, 2026-04-30)`).
+ *
+ * @param body - Editorial artefact body
+ * @returns `{headline, summary}` when a priority finding was identified;
+ *   `null` when the body has no priority section or no usable item inside
+ */
+export declare function extractPriorityFindingHighlight(body: string): {
+    readonly headline: string;
+    readonly summary: string;
+} | null;
 /**
  * Build the per-language `{title, description}` pair using the
  * article-type–specific `*_TITLES` generator from
@@ -230,77 +236,7 @@ export declare function extractArtifactHighlight(runDir: string, articleType: st
  * @returns Per-language `LangTitleSubtitle`
  */
 export declare function buildTemplateFallback(articleType: string, date: string, committee?: string): LanguageMap<LangTitleSubtitle>;
-/**
- * Parse an ISO date and return the `[start, end]` week range as ISO
- * strings. Week starts on Monday and ends on the following Sunday.
- *
- * @param date - ISO date string (`YYYY-MM-DD`)
- * @returns `{ start, end }` both in `YYYY-MM-DD` form
- */
-export declare function deriveWeekRange(date: string): {
-    readonly start: string;
-    readonly end: string;
-};
-/**
- * Return the D-36 → D-8 reporting window for the `week-in-review`
- * article type. EP roll-call voting data is published with a 2–6 week
- * lag, so using the most-recent 7 days structurally produces a
- * vote-empty dataset. Shifting 8 days back and widening to 28 days
- * (start = D-36, end = D-8) ensures the window always contains at
- * least one full EP plenary week with published roll-call data
- * (ADR-006). Direction is consistent with the workflow's
- * `DATE_FROM` (start = D-36) → `DATE_TO` (end = D-8) variables.
- *
- * @param date - ISO article date string (`YYYY-MM-DD`) — typically TODAY
- * @returns `{ start: D-36, end: D-8 }` both as `YYYY-MM-DD` ISO strings
- */
-export declare function deriveReportingWindowForWeekInReview(date: string): {
-    readonly start: string;
-    readonly end: string;
-};
-/**
- * Return a human-friendly month label for an ISO date — English month
- * name + four-digit year (e.g. `April 2026`). The non-English template
- * generators accept this same label verbatim because they interpolate it
- * into a localized sentence rather than translating the month itself.
- *
- * @param date - ISO date string
- * @returns Month label, or the input when parsing fails
- */
-export declare function deriveMonthLabel(date: string): string;
-/**
- * Return a quarter label for an ISO date — `Q<n> <YYYY>` (e.g. `Q2 2026`).
- * Used by `quarter-ahead` and `quarter-in-review` title generators.
- *
- * @param date - ISO date string
- * @returns Quarter label, or the input when parsing fails
- */
-export declare function deriveQuarterLabel(date: string): string;
-/**
- * Return a four-digit year label for an ISO date. Used by `year-ahead`
- * and `year-in-review` title generators.
- *
- * @param date - ISO date string
- * @returns Year label, or the input when parsing fails
- */
-export declare function deriveYearLabel(date: string): string;
-/**
- * Return the EP-term label for an ISO date — `EP10 → 2029` or `EP11 → 2034`.
- * Used by `term-outlook` title generator.
- *
- * @param date - ISO date string
- * @returns Term label, or the input when parsing fails
- */
-export declare function deriveTermLabel(date: string): string;
-/**
- * Return the election-cycle label for an ISO date — pairs the outgoing
- * and incoming EP terms with the election year (e.g. `EP10 → EP11 (2029)`).
- * Used by the `election-cycle` title generator.
- *
- * @param date - ISO date string
- * @returns Cycle label, or the input when parsing fails
- */
-export declare function deriveElectionCycleLabel(date: string): string;
+export { deriveWeekRange, deriveReportingWindowForWeekInReview, deriveMonthLabel, deriveQuarterLabel, deriveYearLabel, deriveTermLabel, deriveElectionCycleLabel, } from './metadata/date-labels.js';
 /**
  * Build a stable, localized keyword list from the article type plus the
  * resolved title/description context.