euparliamentmonitor 0.9.13 → 0.9.14

package/scripts/aggregator/editorial-brief-resolver.d.ts

@@ -19,6 +19,15 @@ import type { LanguageCode } from '../types/index.js';
 export interface LocalizedBriefHighlight {
     readonly headline: string;
     readonly summary: string;
+    /**
+     * Longer (up to ~300 chars) summary lifted from the same brief BLUF
+     * paragraph as {@link summary}, used for `og:description` and
+     * `twitter:description`. Empty string when the BLUF is short enough
+     * that the regular `summary` already captures it — see
+     * `truncateExtendedDescription` for the cutoff. The caller should
+     * fall back to {@link summary} when this field is empty.
+     */
+    readonly extendedSummary: string;
     readonly sourceFile: string;
     readonly sourceLang: LanguageCode;
 }

package/scripts/aggregator/editorial-brief-resolver.js

@@ -29,7 +29,7 @@
  */
 import fs from 'fs';
 import path from 'path';
-import { extractFirstH1, extractLedeAfterHeading, extractStrongProseLine, isGenericHeading, stripArtifactCategoryAffix, truncateTitle, } from './article-metadata.js';
+import { extractFirstH1, extractLedeAfterHeading, extractExtendedLedeAfterHeading, extractStrongProseLine, isGenericHeading, stripArtifactCategoryAffix, truncateTitle, } from './article-metadata.js';
 /**
  * Run-relative candidate paths for a translated brief, in precedence
  * order. Mirrors the `executive-brief.md` → `extended/executive-brief.md`
@@ -177,10 +177,12 @@ export function resolveLocalizedBriefHighlight(runDir, lang, articleType, date)
         const headline = deriveHeadline(body, articleType, date);
         const lede = extractLedeAfterHeading(body);
         const summary = lede || extractStrongProseLine(body);
+        const extendedSummary = extractExtendedLedeAfterHeading(body);
         if (headline || summary) {
             return {
                 headline,
                 summary,
+                extendedSummary,
                 sourceFile: rel,
                 sourceLang: lang,
             };

package/scripts/aggregator/metadata/date-labels.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @module Aggregator/Metadata/DateLabels
+ * @description Pure date-label derivation helpers extracted from
+ * `article-metadata.ts` as a leaf module in the `metadata/` bounded
+ * context. Every helper takes an ISO `YYYY-MM-DD` string and returns a
+ * human-friendly label (or `{start, end}` window) used by the per-article-type
+ * template-fallback title generators.
+ *
+ * Bounded-context rules for this file:
+ * - **No upward imports** — pure helpers, no dependencies on other
+ *   `src/aggregator/` modules, no I/O, no globals.
+ * - **Deterministic** — same input always produces same output; safe to
+ *   call from property-based tests.
+ * - **UTC-only** — all parsing/formatting goes through `Date` UTC accessors,
+ *   never local-time `getMonth()`/`getDate()`.
+ *
+ * Cross-references:
+ * - EP-term boundary constants follow
+ *   {@link analysis/methodologies/electoral-cycle-methodology.md}.
+ * - The D-36 → D-8 reporting window for `week-in-review` follows ADR-006
+ *   (EP roll-call publication lag).
+ */
+/** Milliseconds in one UTC day — used by date-window derivation helpers. */
+export declare const MS_PER_DAY = 86400000;
+/**
+ * EP-term boundary constants — keep these in sync with
+ * {@link analysis/methodologies/electoral-cycle-methodology.md}.
+ *  - EP10: 16 Jul 2024 → ~end of June 2029
+ *  - EP11: ~Jul 2029 → ~Jun 2034
+ */
+export declare const EP10_START_YEAR = 2024;
+export declare const EP10_END_YEAR = 2029;
+export declare const EP11_END_YEAR = 2034;
+/** June — EP elections are held the first week of June every 5 years. */
+export declare const EP_ELECTION_MONTH = 6;
+/**
+ * Parse an ISO date string as UTC midnight. Returns `null` for malformed
+ * input so callers can skip month/week derivation gracefully.
+ *
+ * @param iso - ISO date string (`YYYY-MM-DD`)
+ * @returns Parsed `Date` or `null`
+ */
+export declare function parseIsoDate(iso: string): Date | null;
+/**
+ * Format a `Date` as `YYYY-MM-DD` in UTC.
+ *
+ * @param d - Date object
+ * @returns ISO date string
+ */
+export declare function formatIsoDate(d: Date): string;
+/**
+ * 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;
+//# sourceMappingURL=date-labels.d.ts.map

package/scripts/aggregator/metadata/date-labels.js

@@ -0,0 +1,209 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Aggregator/Metadata/DateLabels
+ * @description Pure date-label derivation helpers extracted from
+ * `article-metadata.ts` as a leaf module in the `metadata/` bounded
+ * context. Every helper takes an ISO `YYYY-MM-DD` string and returns a
+ * human-friendly label (or `{start, end}` window) used by the per-article-type
+ * template-fallback title generators.
+ *
+ * Bounded-context rules for this file:
+ * - **No upward imports** — pure helpers, no dependencies on other
+ *   `src/aggregator/` modules, no I/O, no globals.
+ * - **Deterministic** — same input always produces same output; safe to
+ *   call from property-based tests.
+ * - **UTC-only** — all parsing/formatting goes through `Date` UTC accessors,
+ *   never local-time `getMonth()`/`getDate()`.
+ *
+ * Cross-references:
+ * - EP-term boundary constants follow
+ *   {@link analysis/methodologies/electoral-cycle-methodology.md}.
+ * - The D-36 → D-8 reporting window for `week-in-review` follows ADR-006
+ *   (EP roll-call publication lag).
+ */
+/** Milliseconds in one UTC day — used by date-window derivation helpers. */
+export const MS_PER_DAY = 86_400_000;
+/**
+ * EP-term boundary constants — keep these in sync with
+ * {@link analysis/methodologies/electoral-cycle-methodology.md}.
+ *  - EP10: 16 Jul 2024 → ~end of June 2029
+ *  - EP11: ~Jul 2029 → ~Jun 2034
+ */
+export const EP10_START_YEAR = 2024;
+export const EP10_END_YEAR = 2029;
+export const EP11_END_YEAR = 2034;
+/** June — EP elections are held the first week of June every 5 years. */
+export const EP_ELECTION_MONTH = 6;
+/**
+ * Parse an ISO date string as UTC midnight. Returns `null` for malformed
+ * input so callers can skip month/week derivation gracefully.
+ *
+ * @param iso - ISO date string (`YYYY-MM-DD`)
+ * @returns Parsed `Date` or `null`
+ */
+export function parseIsoDate(iso) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(iso))
+        return null;
+    const parsed = new Date(`${iso}T00:00:00Z`);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+/**
+ * Format a `Date` as `YYYY-MM-DD` in UTC.
+ *
+ * @param d - Date object
+ * @returns ISO date string
+ */
+export function formatIsoDate(d) {
+    const y = d.getUTCFullYear();
+    const m = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(d.getUTCDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+/**
+ * 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 function deriveWeekRange(date) {
+    const parsed = parseIsoDate(date);
+    if (!parsed)
+        return { start: date, end: date };
+    const day = parsed.getUTCDay();
+    const shift = (day + 6) % 7;
+    const startMs = parsed.getTime() - shift * MS_PER_DAY;
+    const endMs = startMs + 6 * MS_PER_DAY;
+    return { start: formatIsoDate(new Date(startMs)), end: formatIsoDate(new Date(endMs)) };
+}
+/**
+ * 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 function deriveReportingWindowForWeekInReview(date) {
+    const parsed = parseIsoDate(date);
+    if (!parsed)
+        return { start: date, end: date };
+    return {
+        start: formatIsoDate(new Date(parsed.getTime() - 36 * MS_PER_DAY)),
+        end: formatIsoDate(new Date(parsed.getTime() - 8 * MS_PER_DAY)),
+    };
+}
+/**
+ * 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 function deriveMonthLabel(date) {
+    const parsed = parseIsoDate(date);
+    if (!parsed)
+        return date;
+    const monthNames = [
+        'January',
+        'February',
+        'March',
+        'April',
+        'May',
+        'June',
+        'July',
+        'August',
+        'September',
+        'October',
+        'November',
+        'December',
+    ];
+    const name = monthNames[parsed.getUTCMonth()] ?? '';
+    return `${name} ${parsed.getUTCFullYear()}`.trim();
+}
+/**
+ * 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 function deriveQuarterLabel(date) {
+    const parsed = parseIsoDate(date);
+    if (!parsed)
+        return date;
+    const quarter = Math.floor(parsed.getUTCMonth() / 3) + 1;
+    return `Q${quarter} ${parsed.getUTCFullYear()}`;
+}
+/**
+ * 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 function deriveYearLabel(date) {
+    const parsed = parseIsoDate(date);
+    if (!parsed)
+        return date;
+    return String(parsed.getUTCFullYear());
+}
+/**
+ * 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 function deriveTermLabel(date) {
+    const parsed = parseIsoDate(date);
+    if (!parsed)
+        return date;
+    const year = parsed.getUTCFullYear();
+    const month = parsed.getUTCMonth() + 1;
+    if (year < EP10_START_YEAR)
+        return `EP9 → ${EP10_START_YEAR}`;
+    if (year < EP10_END_YEAR || (year === EP10_END_YEAR && month <= EP_ELECTION_MONTH)) {
+        return `EP10 → ${EP10_END_YEAR}`;
+    }
+    if (year < EP11_END_YEAR || (year === EP11_END_YEAR && month <= EP_ELECTION_MONTH)) {
+        return `EP11 → ${EP11_END_YEAR}`;
+    }
+    const yearsBeyond = year - EP11_END_YEAR;
+    const offset = month <= EP_ELECTION_MONTH ? 0 : 1;
+    const termsBeyond = Math.floor((yearsBeyond - 1 + offset) / 5) + 1;
+    const termIndex = 11 + termsBeyond;
+    const termEnd = EP11_END_YEAR + 5 * termsBeyond;
+    return `EP${termIndex} → ${termEnd}`;
+}
+/**
+ * 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 function deriveElectionCycleLabel(date) {
+    const parsed = parseIsoDate(date);
+    if (!parsed)
+        return date;
+    const year = parsed.getUTCFullYear();
+    if (year <= EP10_END_YEAR)
+        return `EP10 → EP11 (${EP10_END_YEAR})`;
+    if (year <= EP11_END_YEAR)
+        return `EP11 → EP12 (${EP11_END_YEAR})`;
+    const cyclesBeyond = Math.ceil((year - EP11_END_YEAR) / 5);
+    const electionYear = EP11_END_YEAR + 5 * cyclesBeyond;
+    const out = 11 + cyclesBeyond;
+    return `EP${out} → EP${out + 1} (${electionYear})`;
+}
+//# sourceMappingURL=date-labels.js.map

package/scripts/aggregator/metadata/text-utils.d.ts

@@ -0,0 +1,188 @@
+/**
+ * @module Aggregator/Metadata/TextUtils
+ * @description Pure text / Markdown utility helpers extracted from
+ * `article-metadata.ts` as a leaf module in the `metadata/` bounded
+ * context. Every helper here is concerned with **how to massage a
+ * string** into a meta-tag-safe shape — strip Markdown decorations,
+ * recognise banner / metadata rows that must never reach the
+ * description, clamp text to byte budgets without producing broken
+ * copy, and identify the first complete sentence in a prose paragraph.
+ *
+ * Bounded-context rules for this file:
+ * - **No upward imports** — pure helpers, no dependencies on other
+ *   `src/aggregator/` modules, no I/O, no globals.
+ * - **Deterministic** — same input always produces same output; safe to
+ *   property-test.
+ * - **Locale-agnostic** — every helper works on raw Markdown / prose
+ *   in any of the 14 publishing languages. Banner-row detection is
+ *   driven by structural shape (double-bold + pipe-separator), not by
+ *   a hard-coded English vocabulary.
+ *
+ * The companion file `article-metadata.ts` re-exports the public surface
+ * for back-compat. New code should import directly from this module.
+ */
+/** Maximum `<meta description>` length we will emit. */
+export declare const DESCRIPTION_MAX_LENGTH = 180;
+/**
+ * Maximum `og:description` / `twitter:description` length we will
+ * emit. Facebook truncates at ~300 characters in the preview card;
+ * Twitter at ~200. We aim for the longer cap so LinkedIn / Slack
+ * (which use the full OG payload) get the full BLUF context, then
+ * let Twitter clip naturally. Below this length the extended
+ * description is emitted verbatim; above it we sentence-boundary
+ * truncate the same way as {@link truncateDescription}.
+ */
+export declare const EXTENDED_DESCRIPTION_MAX_LENGTH = 300;
+/** Target minimum extended-description length before we even emit it. */
+export declare const EXTENDED_DESCRIPTION_MIN_LENGTH = 200;
+/** Target minimum `<meta description>` length before we append context. */
+export declare const DESCRIPTION_MIN_LENGTH = 140;
+/**
+ * Length below which a raw description is considered too short to stand
+ * on its own and gets enriched with date/context. Independent from
+ * {@link DESCRIPTION_MIN_LENGTH} (which controls sentence-boundary
+ * truncation behaviour). Set lower than DESCRIPTION_MIN_LENGTH so a
+ * clean 100-140 char prose lede is preserved verbatim instead of being
+ * padded with date/context boilerplate.
+ */
+export declare const ENRICHMENT_TRIGGER_LENGTH = 100;
+/** Maximum `<title>` length — anything longer is truncated with an ellipsis. */
+export declare const TITLE_MAX_LENGTH = 140;
+/**
+ * Soft target for headline-style titles produced as a fallback from
+ * BLUF/lede prose. When the candidate exceeds `TITLE_MAX_LENGTH`, the
+ * truncator first looks for a natural clause boundary
+ * (`.`, `:`, `—`, `;`) inside the `[HEADLINE_SOFT_MIN, TITLE_MAX_LENGTH]`
+ * window and breaks there instead of mid-clause-with-ellipsis. This
+ * turns a 137-character truncated prose paragraph into a complete
+ * journalistic clause, which scans much better in news cards and SERP
+ * snippets without sacrificing the keyword-rich opening.
+ */
+export declare const HEADLINE_SOFT_MIN = 60;
+/**
+ * Punctuation marks that signal a natural clause boundary inside a
+ * BLUF / lede paragraph. Listed in preferred-break order: a colon or
+ * em-dash that introduces a list of consequences is the best break,
+ * full stops are next, and semicolons last. Single ASCII space is
+ * always a fallback boundary handled separately.
+ */
+export declare const HEADLINE_CLAUSE_BOUNDARIES: readonly string[];
+/**
+ * Emoji-banner prefixes that Stage-B agents use to decorate metadata rows
+ * (e.g. `📋 Analysis Owner:`). Any line starting with one of these is
+ * metadata, never prose.
+ */
+export declare const EMOJI_BANNER_CHARS: string[];
+/**
+ * Label prefixes that a prose description must never start with. Every
+ * entry matches case-insensitively at the start of a trimmed line, followed
+ * by optional space and a colon.
+ */
+export declare const METADATA_LINE_PREFIXES: readonly string[];
+/** Connector / determiner words that read as broken copy when they are
+ *  the final token before a truncation ellipsis. */
+export declare const TRAILING_STOP_WORDS: Set<string>;
+/** Trailing characters we always strip before appending our own ellipsis,
+ *  so we never emit double-ellipsis or stray punctuation. */
+export declare const TRAILING_PUNCT: RegExp;
+/**
+ * Abbreviation tokens (lowercase, including the trailing period) that
+ * should NOT count as sentence terminators when {@link extractFirstSentence}
+ * scans for a `.` boundary. Single-letter all-caps initials
+ * (`U.S.`, `E.U.`) are handled by the all-caps-initial check below.
+ */
+export declare const ABBREVIATION_PREFIXES: readonly 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 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 an extended description to {@link EXTENDED_DESCRIPTION_MAX_LENGTH}
+ * characters using the same sentence-boundary-preserving logic as
+ * {@link truncateDescription}. Returns `''` when the input is empty
+ * or shorter than the meta-description maximum (no point in emitting
+ * an "extended" description that's actually shorter than the regular
+ * one).
+ *
+ * @param text - Raw extended-description text (e.g. full BLUF paragraph)
+ * @returns Truncated extended description, or `''` when not worth emitting
+ */
+export declare function truncateExtendedDescription(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;
+//# sourceMappingURL=text-utils.d.ts.map