euparliamentmonitor 0.9.13 → 0.9.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.9.13",
+  "version": "0.9.14",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -79,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",
@@ -92,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",
@@ -168,11 +169,12 @@
     "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.2",
+    "jscpd": "4.2.3",
     "knip": "^6.7.0",
     "lint-staged": "17.0.5",
     "mermaid": "11.15.0",
@@ -182,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/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: [], source: 'template' };
+    return (en ?? { title: '', description: '', extendedDescription: '', keywords: [], source: 'template' });
 }
 /**
  * Count the number of articles the site currently publishes, derived

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,6 +3,16 @@ 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
@@ -63,96 +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;
-/**
- * Return the first complete sentence from a prose paragraph, suitable
- * for use as a fallback editorial title when the artefact H1 is
- * categorical (e.g. `# EU Parliament Committee Reports`) and the
- * resolver must derive `<title>` from the BLUF / lede summary instead.
- *
- * A "sentence" is the prefix up to the first sentence-terminator
- * (`. `, `! `, `? `, `; `) inside the `[HEADLINE_SOFT_MIN,
- * TITLE_MAX_LENGTH]` window. Common abbreviations (`Q1.`, `Q2.`,
- * `H1.`, `H2.`, `Mr.`, `Mrs.`, `e.g.`, `i.e.`, `vs.`) are skipped
- * so they don't terminate the sentence prematurely. When no
- * acceptable terminator exists in the window, returns the entire
- * input unchanged so {@link truncateTitle} can handle clause-boundary
- * truncation downstream.
- *
- * This produces journalistically clean titles even for the
- * propositions / committee-reports cases where the BLUF paragraph
- * opens with a single long sentence that exceeds 140 chars —
- * `truncateTitle` then breaks on a clause boundary, and the result is
- * still grammatical because the input was a sentence prefix rather
- * than an arbitrary paragraph slice.
- *
- * @param paragraph - Prose paragraph (post-{@link stripInlineMarkdown})
- * @returns First sentence, or the original paragraph when none can be
- *   identified within the soft-min window
- */
-export declare function extractFirstSentence(paragraph: 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
@@ -177,6 +98,19 @@ export declare function extractFirstH1(markdown: string): string;
  */
 export declare function extractStrongProseLine(markdown: string): string;
 export declare function extractLedeAfterHeading(markdown: string): string;
+/**
+ * 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 - Brief body (SPDX preamble already stripped)
+ * @returns Extended lede paragraph, or `''` when not worth emitting
+ */
+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
@@ -302,77 +236,7 @@ export declare function extractPriorityFindingHighlight(body: string): {
  * @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.