euparliamentmonitor 0.8.51 → 0.8.52

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.2.15 for accessing real EU Parliament data via the Model Context Protocol.
+v1.2.18 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)
@@ -426,7 +426,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.2.15+, fully operational):
+**Primary — European Parliament MCP Server** ([Hack23/European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server) v1.2.18+, 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.8.51",
+  "version": "0.8.52",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -48,7 +48,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "prebuild": "node scripts/generators/news-indexes.js && node scripts/generators/sitemap.js",
+    "prebuild": "node scripts/generators/build-info.js && node scripts/generators/news-indexes.js && node scripts/generators/sitemap.js",
+    "generate-build-info": "node scripts/generators/build-info.js",
     "build": "tsc",
     "build:check": "tsc --noEmit",
     "build:check-tests": "tsc --project tsconfig.test.json --noEmit",
@@ -168,7 +169,7 @@
     "node": ">=25"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.2.15",
+    "european-parliament-mcp-server": "1.2.18",
     "markdown-it": "^14.1.1",
     "markdown-it-anchor": "^9.2.0",
     "markdown-it-attrs": "^4.3.1",

package/scripts/aggregator/article-html.js

@@ -19,7 +19,8 @@
  * browser and CloudFront caches automatically.
  */
 import { BASE_URL, MERMAID_VERSION } from '../constants/config.js';
-import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, SKIP_LINK_TEXTS, TOC_ARIA_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
+import { buildHeadFreshnessTags } from '../constants/build-info-meta.js';
+import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, SKIP_LINK_TEXTS, TOC_ARIA_LABELS, UPDATE_AVAILABLE_LABELS, UPDATE_REFRESH_CTA_LABELS, UPDATE_DISMISS_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
 import { escapeHTML } from '../utils/file-utils.js';
 import { buildSiteFooter, buildSiteHeader, buildPageBanner, } from '../templates/section-builders.js';
 /**
@@ -189,6 +190,10 @@ ${hreflangLinks}
   <link rel="manifest" href="../site.webmanifest">
   <meta name="theme-color" content="#003399">
   <link rel="stylesheet" href="../styles.css">
+  <meta name="ep-i18n-update-text" content="${escapeHTML(getLocalizedString(UPDATE_AVAILABLE_LABELS, safeLang))}">
+  <meta name="ep-i18n-update-cta" content="${escapeHTML(getLocalizedString(UPDATE_REFRESH_CTA_LABELS, safeLang))}">
+  <meta name="ep-i18n-dismiss" content="${escapeHTML(getLocalizedString(UPDATE_DISMISS_LABELS, safeLang))}">
+${buildHeadFreshnessTags('../')}
   <script type="application/ld+json">${jsonLdString}</script>
   <script type="module" src="../js/mermaid-init.js?v=${MERMAID_VERSION}" defer></script>
   <script src="../js/article-runtime.js" defer></script>

package/scripts/aggregator/prior-run-diff.js

@@ -3,24 +3,33 @@
 // SPDX-License-Identifier: Apache-2.0
 
 /**
- * Prior-run diff helper for the re-run merge rule.
+ * Prior-run diff helper for the re-run improve/extend rule.
  *
  * Reads `manifest.json.history[]` from a same-day analysis folder and
- * classifies every artifact as **at-floor** (carry-forward) or **below-floor**
- * (rewrite). The result — a `priorRunDiff` plan — is written to stdout as
- * JSON and can be consumed by Stage A of the analysis workflow.
+ * classifies every artifact as **at-floor** (must-extend / carry-forward) or
+ * **below-floor** (rewrite). The result — a `priorRunDiff` plan with
+ * `mode: "improve-and-extend"` — is written to stdout as JSON and is
+ * consumed by Stage B of the analysis workflow.
  *
- * Controlled by the `ENABLE_PRIOR_RUN_MERGE` environment variable:
- *   - `ENABLE_PRIOR_RUN_MERGE=true`  → normal operation (produce plan)
- *   - unset / any other value        → short-circuit: emit plan with
- *                                       `enabled: false` and empty arrays
+ * **Re-run semantics (never no-op).** Entries listed under `carryForward[]`
+ * are **NOT** skipped on re-runs — they are must-extend targets. Stage B
+ * MUST raise their depth: each prior artifact's `priorLines` becomes the new
+ * floor and the agent must add ≥1 new section, ≥3 new evidence citations, or
+ * ≥1 new chart, ending at `lines >= max(floor, priorLines + 20)`. Entries in
+ * `rewrite[]` are still written from scratch to the catalog floor.
+ *
+ * Always-on. The `ENABLE_PRIOR_RUN_MERGE` environment variable is no longer
+ * read — the helper runs unconditionally so re-runs cannot accidentally
+ * regress to the legacy "skip-write" behaviour. The `buildPriorRunDiff(..,
+ * enabled)` parameter is kept for back-compat with unit tests but the CLI
+ * always passes `true`.
  *
  * Invocation:
  *   node scripts/aggregator/prior-run-diff.js <runDir>
  *   npm run prior-run-diff -- analysis/daily/2026-04-26/week-in-review
  *
  * Exit codes:
- *   0  — plan emitted successfully (or feature disabled)
+ *   0  — plan emitted successfully
  *   1  — runDir missing or invalid
  *   2  — bad CLI usage
  *
@@ -28,6 +37,7 @@
  * ```json
  * {
  *   "enabled": true,
+ *   "mode": "improve-and-extend",
  *   "runDir": "analysis/daily/2026-04-26/week-in-review",
  *   "articleType": "week-in-review",
  *   "priorRunId": "week-in-review-run-1714128000",
@@ -35,8 +45,10 @@
  *     {
  *       "relativePath": "intelligence/synthesis-summary.md",
  *       "lines": 250,
+ *       "priorLines": 250,
  *       "floor": 180,
- *       "source": "carry-forward-from:week-in-review-run-1714128000"
+ *       "extendFloor": 270,
+ *       "source": "extend-from-prior:week-in-review-run-1714128000"
  *     }
  *   ],
  *   "rewrite": [
@@ -50,10 +62,13 @@
  * }
  * ```
  *
- * The `source` value on each carry-forward entry follows the schema:
- *   `"carry-forward-from:<runId>"`
- * which Stage B writes into `manifest.json.artifactSources` (additive,
- * backward-compatible with the existing schema).
+ * - `priorLines` exposes the prior-run line count so Stage B knows the lower
+ *   bound it must beat.
+ * - `extendFloor` = `max(floor, priorLines + 20)` — the minimum line count
+ *   the new pass MUST reach for this artifact.
+ * - The `source` value follows the schema `"extend-from-prior:<runId>"`,
+ *   which Stage B writes into `manifest.json.artifactSources` (additive,
+ *   back-compat with prior `"carry-forward-from:<runId>"` consumers).
  */
 
 import fs from 'node:fs';
@@ -63,6 +78,7 @@ import { fileURLToPath } from 'node:url';
 
 const ROOT = process.cwd();
 const DEFAULT_MIN_LINES = 30;
+const EXTEND_DELTA_LINES = 20;
 
 // Artifacts that must contain at least one Mermaid fenced block.
 // Mirrors the directory-based heuristic in validate-analysis-completeness.js.
@@ -86,9 +102,10 @@ function usage(code = 2) {
     '',
     '  <runDir>   Path to analysis/daily/<date>/<slug>/',
     '',
-    'Environment:',
-    '  ENABLE_PRIOR_RUN_MERGE=true   Enable the carry-forward classifier',
-    '                                (default: disabled — emits empty plan)',
+    'Always-on. The helper unconditionally classifies prior-run artifacts as',
+    'must-extend (carryForward[]) or below-floor rewrite (rewrite[]) so re-runs',
+    'can never accidentally no-op. The legacy ENABLE_PRIOR_RUN_MERGE env flag',
+    'is no longer read.',
     '',
     'Example:',
     '  npm run prior-run-diff -- analysis/daily/2026-04-26/week-in-review',
@@ -190,9 +207,14 @@ export function classifyArtifact(runDir, relativePath, floor, mermaidRequiredLis
 /**
  * Build the `priorRunDiff` plan for a same-day analysis folder.
  *
+ * Mode is always **improve-and-extend**: `carryForward[]` entries are
+ * must-extend targets (their `priorLines` and `extendFloor` exposed), not
+ * skip-write targets. The `enabled` parameter is preserved for back-compat
+ * with the legacy unit-test signature; the CLI always passes `true`.
+ *
  * @param {string} runDir              - Absolute path to the run folder.
  * @param {object|null} thresholdsJson - Parsed reference-quality-thresholds.json.
- * @param {boolean} enabled            - Whether the feature is enabled.
+ * @param {boolean} enabled            - Whether the feature is enabled (CLI: always true).
  * @returns {object} The diff plan (serialisable to JSON).
  */
 export function buildPriorRunDiff(runDir, thresholdsJson, enabled) {
@@ -210,6 +232,7 @@ export function buildPriorRunDiff(runDir, thresholdsJson, enabled) {
   if (!enabled) {
     return {
       enabled: false,
+      mode: 'improve-and-extend',
       runDir: relRunDir,
       articleType,
       priorRunId: null,
@@ -222,6 +245,7 @@ export function buildPriorRunDiff(runDir, thresholdsJson, enabled) {
   if (history.length === 0) {
     return {
       enabled: true,
+      mode: 'improve-and-extend',
       runDir: relRunDir,
       articleType,
       priorRunId: null,
@@ -248,11 +272,14 @@ export function buildPriorRunDiff(runDir, thresholdsJson, enabled) {
     const floor = Math.max(DEFAULT_MIN_LINES, perArtifactFloors[relativePath] ?? 0);
     const result = classifyArtifact(runDir, relativePath, floor, mermaidRequiredList);
     if (result.atFloor) {
+      const extendFloor = Math.max(floor, result.lines + EXTEND_DELTA_LINES);
       carryForward.push({
         relativePath,
         lines: result.lines,
+        priorLines: result.lines,
         floor: result.floor,
-        source: `carry-forward-from:${priorRunId}`,
+        extendFloor,
+        source: `extend-from-prior:${priorRunId}`,
       });
     } else {
       rewrite.push({
@@ -266,6 +293,7 @@ export function buildPriorRunDiff(runDir, thresholdsJson, enabled) {
 
   return {
     enabled: true,
+    mode: 'improve-and-extend',
     runDir: relRunDir,
     articleType,
     priorRunId,
@@ -338,7 +366,11 @@ function main() {
     process.exit(1);
   }
 
-  const enabled = process.env['ENABLE_PRIOR_RUN_MERGE'] === 'true';
+  // Re-run improve/extend rule is always-on. The legacy ENABLE_PRIOR_RUN_MERGE
+  // env flag is no longer read — re-runs cannot accidentally regress to the
+  // pre-2026-05 skip-write behaviour. See .github/prompts/02-analysis-protocol.md
+  // §"Re-run improve/extend rule".
+  const enabled = true;
   const thresholdsJson = loadThresholds(opts.thresholdsPath);
   const plan = buildPriorRunDiff(runDir, thresholdsJson, enabled);
 

package/scripts/constants/build-info-meta.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Build the shared freshness/PWA `<head>` block.
+ *
+ * @param pathPrefix - Asset path prefix (`''` for root pages, `'../'`
+ *                     for `news/` pages).
+ * @returns Multi-line HTML string. Caller is responsible for placing it
+ *          inside `<head>…</head>`. The result is already HTML-escaped.
+ */
+export declare function buildHeadFreshnessTags(pathPrefix: string): string;
+//# sourceMappingURL=build-info-meta.d.ts.map

package/scripts/constants/build-info-meta.js

@@ -0,0 +1,45 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Constants/BuildInfoMeta
+ * @description Shared helper that emits the `<head>` freshness tags every
+ * generator must include so the PWA layer (`js/pwa-register.js`) can:
+ *
+ *   - Read the embedded build commit SHA + timestamp from `<meta>` tags.
+ *   - Load the same-origin service-worker registration script.
+ *   - Tell browsers + intermediate proxies to revalidate every navigation
+ *     (`Cache-Control: no-cache`, `Pragma: no-cache`).
+ *
+ * Every value is HTML-escaped — `BUILD_ID`/`BUILD_TIME` are tightly
+ * formatted (40-char hex / ISO 8601) but defence-in-depth is cheap.
+ *
+ * The output is a multi-line string; callers should drop it into the
+ * `<head>` block alongside other `<meta>` tags. CSP stays `script-src
+ * 'self'` because the only emitted `<script>` references a same-origin
+ * file with a `defer` attribute.
+ */
+import { BUILD_ID, BUILD_TIME } from './config.js';
+import { escapeHTML } from '../utils/file-utils.js';
+/**
+ * Build the shared freshness/PWA `<head>` block.
+ *
+ * @param pathPrefix - Asset path prefix (`''` for root pages, `'../'`
+ *                     for `news/` pages).
+ * @returns Multi-line HTML string. Caller is responsible for placing it
+ *          inside `<head>…</head>`. The result is already HTML-escaped.
+ */
+export function buildHeadFreshnessTags(pathPrefix) {
+    const safeBuildId = escapeHTML(BUILD_ID);
+    const safeBuildTime = escapeHTML(BUILD_TIME);
+    // Path prefix is built from controlled string literals (`''` or `'../'`),
+    // but escape it anyway to keep the helper safe under future callers.
+    const safePrefix = escapeHTML(pathPrefix);
+    return [
+        `  <meta name="build-id" content="${safeBuildId}">`,
+        `  <meta name="build-time" content="${safeBuildTime}">`,
+        `  <meta http-equiv="Cache-Control" content="no-cache">`,
+        `  <meta http-equiv="Pragma" content="no-cache">`,
+        `  <script src="${safePrefix}js/pwa-register.js" defer></script>`,
+    ].join('\n');
+}
+//# sourceMappingURL=build-info-meta.js.map

package/scripts/constants/config.d.ts

@@ -64,4 +64,24 @@ export declare const THEME_TOGGLE_SCRIPT_CONTENT = "\n  (function(){\n    var do
  * Detects system theme on first click when no explicit preference is saved.
  */
 export declare const THEME_TOGGLE_SCRIPT = "\n  <script>\n  (function(){\n    var docEl=document.documentElement;\n    var t=localStorage.getItem('ep-theme');\n    var storedTheme=t==='light'?'light':t==='dark'?'dark':null;\n    if(storedTheme){\n      docEl.setAttribute('data-theme',storedTheme);\n    }else if(t){\n      localStorage.removeItem('ep-theme');\n    }\n    var btn=document.querySelector('.theme-toggle');\n    if(!btn)return;\n    btn.addEventListener('click',function(){\n      var cur=docEl.getAttribute('data-theme');\n      if(!cur){\n        cur=(window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches)?'dark':'light';\n      }\n      var next=cur==='dark'?'light':'dark';\n      docEl.setAttribute('data-theme',next);\n      localStorage.setItem('ep-theme',next);\n    });\n  })();\n  </script>";
+/**
+ * Full git commit SHA (40 chars) for the running build. Resolved via env
+ * (`BUILD_ID`), then `git rev-parse HEAD`, then a deterministic placeholder
+ * (`'0'.repeat(40)`). Never empty, never throws.
+ */
+export declare const BUILD_ID: string;
+/** First 7 chars of {@link BUILD_ID} — the conventional short SHA. */
+export declare const BUILD_SHORT: string;
+/**
+ * ISO 8601 timestamp for when this build was produced. Precedence:
+ *   1. `process.env.BUILD_TIME` (CI sets this in the workflow)
+ *   2. `new Date().toISOString()` fallback
+ */
+export declare const BUILD_TIME: string;
+/**
+ * Optional release tag (e.g. `v0.8.51`). Empty string when no tag was
+ * supplied via `process.env.RELEASE_TAG`. Surfaced in `build-info.json`
+ * for clients that want a human-readable label.
+ */
+export declare const RELEASE_TAG: string;
 //# sourceMappingURL=config.d.ts.map

package/scripts/constants/config.js

@@ -4,6 +4,7 @@
  * @module Constants/Config
  * @description Shared configuration constants
  */
+import { execSync } from 'child_process';
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
@@ -137,4 +138,60 @@ export const THEME_TOGGLE_SCRIPT_CONTENT = `
  */
 export const THEME_TOGGLE_SCRIPT = `
   <script>${THEME_TOGGLE_SCRIPT_CONTENT}</script>`;
+/**
+ * Resolve the current build commit SHA. Precedence:
+ *   1. `process.env.BUILD_ID` (CI sets this from `${{ github.sha }}`)
+ *   2. `git rev-parse HEAD` (works in dev clones / local builds)
+ *   3. `'0'.repeat(40)` (deterministic, never throws)
+ *
+ * Always returns a 40-char lowercase hex string. Never throws — generator
+ * scripts must be safe to run on machines without git installed.
+ *
+ * @returns 40-char lowercase hex commit SHA, or `'0'.repeat(40)` placeholder.
+ */
+function resolveBuildId() {
+    const fromEnv = (process.env.BUILD_ID ?? '').trim();
+    if (/^[0-9a-f]{40}$/i.test(fromEnv)) {
+        return fromEnv.toLowerCase();
+    }
+    try {
+        const fromGit = execSync('git rev-parse HEAD', {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            cwd: PROJECT_ROOT,
+        }).trim();
+        if (/^[0-9a-f]{40}$/i.test(fromGit)) {
+            return fromGit.toLowerCase();
+        }
+    }
+    catch {
+        /* git unavailable or not a repo — fall through to placeholder */
+    }
+    return '0'.repeat(40);
+}
+/**
+ * Full git commit SHA (40 chars) for the running build. Resolved via env
+ * (`BUILD_ID`), then `git rev-parse HEAD`, then a deterministic placeholder
+ * (`'0'.repeat(40)`). Never empty, never throws.
+ */
+export const BUILD_ID = resolveBuildId();
+/** First 7 chars of {@link BUILD_ID} — the conventional short SHA. */
+export const BUILD_SHORT = BUILD_ID.slice(0, 7);
+/**
+ * ISO 8601 timestamp for when this build was produced. Precedence:
+ *   1. `process.env.BUILD_TIME` (CI sets this in the workflow)
+ *   2. `new Date().toISOString()` fallback
+ */
+export const BUILD_TIME = (() => {
+    const fromEnv = (process.env.BUILD_TIME ?? '').trim();
+    if (fromEnv)
+        return fromEnv;
+    return new Date().toISOString();
+})();
+/**
+ * Optional release tag (e.g. `v0.8.51`). Empty string when no tag was
+ * supplied via `process.env.RELEASE_TAG`. Surfaced in `build-info.json`
+ * for clients that want a human-readable label.
+ */
+export const RELEASE_TAG = (process.env.RELEASE_TAG ?? '').trim();
 //# sourceMappingURL=config.js.map

package/scripts/constants/language-ui.d.ts

@@ -193,4 +193,22 @@ export declare const FOOTER_REPORT_ISSUES_LABELS: LanguageMap;
 export declare const FOOTER_ARTICLES_AVAILABLE_LABELS: LanguageMap;
 /** Localized "Political Intelligence" link label used in footer Quick Links section */
 export declare const FOOTER_POLITICAL_INTELLIGENCE_LABELS: LanguageMap;
+/** "Install app" CTA label (PWA install hint). */
+export declare const INSTALL_APP_LABELS: LanguageMap;
+/** Toast message shown when a newer build of the site is detected. */
+export declare const UPDATE_AVAILABLE_LABELS: LanguageMap;
+/** "Refresh" CTA on the update toast — reloads the page. */
+export declare const UPDATE_REFRESH_CTA_LABELS: LanguageMap;
+/** "Dismiss" aria-label on the update toast close button. */
+export declare const UPDATE_DISMISS_LABELS: LanguageMap;
+/** Offline page title. */
+export declare const OFFLINE_TITLE_LABELS: LanguageMap;
+/** Offline page body explaining the situation. */
+export declare const OFFLINE_BODY_LABELS: LanguageMap;
+/** "Try again" button on the offline page. */
+export declare const OFFLINE_RETRY_LABELS: LanguageMap;
+/** "Build" label for the build-id link in the footer. */
+export declare const BUILD_INFO_COMMIT_LABELS: LanguageMap;
+/** "Deployed" label preceding the build timestamp in the footer. */
+export declare const BUILD_INFO_DEPLOYED_LABELS: LanguageMap;
 //# sourceMappingURL=language-ui.d.ts.map

package/scripts/constants/language-ui.js

@@ -1866,4 +1866,158 @@ export const FOOTER_POLITICAL_INTELLIGENCE_LABELS = {
     ko: '정치 정보',
     zh: '政治情报',
 };
+/* ─── PWA + freshness UI labels (Phase 3) ────────────────────────── */
+/** "Install app" CTA label (PWA install hint). */
+export const INSTALL_APP_LABELS = {
+    en: 'Install app',
+    sv: 'Installera app',
+    da: 'Installer app',
+    no: 'Installer app',
+    fi: 'Asenna sovellus',
+    de: 'App installieren',
+    fr: "Installer l'application",
+    es: 'Instalar aplicación',
+    nl: 'App installeren',
+    ar: 'تثبيت التطبيق',
+    he: 'התקן את האפליקציה',
+    ja: 'アプリをインストール',
+    ko: '앱 설치',
+    zh: '安装应用',
+};
+/** Toast message shown when a newer build of the site is detected. */
+export const UPDATE_AVAILABLE_LABELS = {
+    en: 'Updated content available',
+    sv: 'Uppdaterat innehåll tillgängligt',
+    da: 'Opdateret indhold tilgængeligt',
+    no: 'Oppdatert innhold tilgjengelig',
+    fi: 'Päivitetty sisältö saatavilla',
+    de: 'Aktualisierte Inhalte verfügbar',
+    fr: 'Contenu mis à jour disponible',
+    es: 'Contenido actualizado disponible',
+    nl: 'Bijgewerkte inhoud beschikbaar',
+    ar: 'يتوفر محتوى محدث',
+    he: 'תוכן מעודכן זמין',
+    ja: '最新のコンテンツが利用可能です',
+    ko: '업데이트된 콘텐츠가 있습니다',
+    zh: '有可用的更新内容',
+};
+/** "Refresh" CTA on the update toast — reloads the page. */
+export const UPDATE_REFRESH_CTA_LABELS = {
+    en: 'Refresh',
+    sv: 'Uppdatera',
+    da: 'Opdater',
+    no: 'Oppdater',
+    fi: 'Päivitä',
+    de: 'Aktualisieren',
+    fr: 'Actualiser',
+    es: 'Actualizar',
+    nl: 'Vernieuwen',
+    ar: 'تحديث',
+    he: 'רענן',
+    ja: '更新',
+    ko: '새로고침',
+    zh: '刷新',
+};
+/** "Dismiss" aria-label on the update toast close button. */
+export const UPDATE_DISMISS_LABELS = {
+    en: 'Dismiss',
+    sv: 'Stäng',
+    da: 'Luk',
+    no: 'Lukk',
+    fi: 'Sulje',
+    de: 'Schließen',
+    fr: 'Fermer',
+    es: 'Cerrar',
+    nl: 'Sluiten',
+    ar: 'إغلاق',
+    he: 'סגור',
+    ja: '閉じる',
+    ko: '닫기',
+    zh: '关闭',
+};
+/** Offline page title. */
+export const OFFLINE_TITLE_LABELS = {
+    en: "You're offline",
+    sv: 'Du är offline',
+    da: 'Du er offline',
+    no: 'Du er frakoblet',
+    fi: 'Olet offline-tilassa',
+    de: 'Sie sind offline',
+    fr: 'Vous êtes hors ligne',
+    es: 'Estás sin conexión',
+    nl: 'Je bent offline',
+    ar: 'أنت غير متصل',
+    he: 'אתה במצב לא מקוון',
+    ja: 'オフラインです',
+    ko: '오프라인 상태입니다',
+    zh: '您当前处于离线状态',
+};
+/** Offline page body explaining the situation. */
+export const OFFLINE_BODY_LABELS = {
+    en: "EU Parliament Monitor is unavailable while you're offline. Reconnect to load the latest political intelligence.",
+    sv: 'EU Parliament Monitor är otillgänglig medan du är offline. Anslut igen för att läsa den senaste politiska underrättelsen.',
+    da: 'EU Parliament Monitor er utilgængelig, mens du er offline. Opret forbindelse igen for at hente den nyeste politiske efterretning.',
+    no: 'EU Parliament Monitor er utilgjengelig mens du er frakoblet. Koble til på nytt for å laste inn den nyeste politiske etterretningen.',
+    fi: 'EU Parliament Monitor ei ole käytettävissä, kun olet offline-tilassa. Yhdistä uudelleen ladataksesi uusimman poliittisen tiedustelun.',
+    de: 'EU Parliament Monitor ist offline nicht verfügbar. Stellen Sie die Verbindung wieder her, um die neuesten politischen Informationen zu laden.',
+    fr: 'EU Parliament Monitor est indisponible hors ligne. Reconnectez-vous pour charger les dernières informations politiques.',
+    es: 'EU Parliament Monitor no está disponible sin conexión. Vuelve a conectarte para cargar la última inteligencia política.',
+    nl: 'EU Parliament Monitor is offline niet beschikbaar. Maak opnieuw verbinding om de laatste politieke intelligentie te laden.',
+    ar: 'مراقب البرلمان الأوروبي غير متوفر أثناء عدم الاتصال. أعد الاتصال لتحميل أحدث المعلومات السياسية.',
+    he: 'EU Parliament Monitor אינו זמין במצב לא מקוון. התחבר מחדש כדי לטעון את המודיעין הפוליטי העדכני ביותר.',
+    ja: 'オフライン中は EU Parliament Monitor を利用できません。再接続して最新の政治情報を読み込んでください。',
+    ko: '오프라인 상태에서는 EU Parliament Monitor를 이용할 수 없습니다. 다시 연결하여 최신 정치 정보를 불러오세요.',
+    zh: '您处于离线状态,无法使用 EU Parliament Monitor。重新连接以加载最新的政治情报。',
+};
+/** "Try again" button on the offline page. */
+export const OFFLINE_RETRY_LABELS = {
+    en: 'Try again',
+    sv: 'Försök igen',
+    da: 'Prøv igen',
+    no: 'Prøv igjen',
+    fi: 'Yritä uudelleen',
+    de: 'Erneut versuchen',
+    fr: 'Réessayer',
+    es: 'Intentar de nuevo',
+    nl: 'Opnieuw proberen',
+    ar: 'حاول مرة أخرى',
+    he: 'נסה שוב',
+    ja: '再試行',
+    ko: '다시 시도',
+    zh: '重试',
+};
+/** "Build" label for the build-id link in the footer. */
+export const BUILD_INFO_COMMIT_LABELS = {
+    en: 'Build',
+    sv: 'Bygg',
+    da: 'Build',
+    no: 'Build',
+    fi: 'Build',
+    de: 'Build',
+    fr: 'Build',
+    es: 'Build',
+    nl: 'Build',
+    ar: 'البناء',
+    he: 'בנייה',
+    ja: 'ビルド',
+    ko: '빌드',
+    zh: '构建',
+};
+/** "Deployed" label preceding the build timestamp in the footer. */
+export const BUILD_INFO_DEPLOYED_LABELS = {
+    en: 'Deployed',
+    sv: 'Driftsatt',
+    da: 'Implementeret',
+    no: 'Distribuert',
+    fi: 'Julkaistu',
+    de: 'Veröffentlicht',
+    fr: 'Déployé',
+    es: 'Desplegado',
+    nl: 'Geïmplementeerd',
+    ar: 'تم النشر',
+    he: 'נפרס',
+    ja: 'デプロイ済み',
+    ko: '배포됨',
+    zh: '已部署',
+};
 //# sourceMappingURL=language-ui.js.map

package/scripts/constants/languages.d.ts

@@ -8,7 +8,7 @@
  * - **language-articles** — Article-type title generators and body-text strings
  */
 export { ALL_LANGUAGES, LANGUAGE_PRESETS, LANGUAGE_FLAGS, LANGUAGE_NAMES, getLocalizedString, isSupportedLanguage, getTextDirection, } from './language-core.js';
-export { PAGE_TITLES, PAGE_DESCRIPTIONS, SECTION_HEADINGS, NO_ARTICLES_MESSAGES, SKIP_LINK_TEXTS, ARTICLE_TYPE_LABELS, READ_TIME_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, RELATED_ARTICLES_NAV_LABELS, BREADCRUMB_HOME_LABELS, BREADCRUMB_NEWS_LABELS, TIMELINE_HEADINGS, COMPARISON_BEFORE_LABELS, COMPARISON_AFTER_LABELS, KEY_FIGURES_HEADINGS, AI_SECTION_CONTENT, FILTER_LABELS, SOURCES_HEADING_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, FOOTER_HOME_LABELS, FOOTER_SITEMAP_LABELS, FOOTER_RSS_LABELS, FOOTER_GITHUB_REPO_LABELS, FOOTER_LICENSE_LABELS, FOOTER_EUROPARL_LABELS, FOOTER_LINKEDIN_LABELS, FOOTER_SECURITY_POLICY_LABELS, FOOTER_CONTACT_LABELS, FOOTER_DISCLAIMER_LABELS, FOOTER_REPORT_ISSUES_LABELS, FOOTER_ARTICLES_AVAILABLE_LABELS, FOOTER_POLITICAL_INTELLIGENCE_LABELS, TOC_ARIA_LABELS, RELATED_ANALYSIS_LABELS, ANALYSIS_TRANSPARENCY_LABELS, ANALYSIS_SUMMARY_LABELS, METHODOLOGY_LABELS, TRANSPARENCY_DISCLOSURE_LABELS, CLASSIFICATION_ANALYSIS_LABELS, THREAT_ASSESSMENT_LABELS, RISK_SCORING_LABELS, DEEP_ANALYSIS_LABELS, VIEW_SOURCE_LABELS, OPEN_SOURCE_NOTE_LABELS, AI_ANALYSIS_GUIDE_LABELS, SWOT_FRAMEWORK_LABELS, RISK_METHODOLOGY_LABELS, THREAT_FRAMEWORK_LABELS, CLASSIFICATION_GUIDE_LABELS, STYLE_GUIDE_LABELS, SIGNIFICANCE_CLASSIFICATION_LABELS, ACTOR_MAPPING_LABELS, FORCES_ANALYSIS_LABELS, IMPACT_MATRIX_LABELS, POLITICAL_THREAT_LANDSCAPE_LABELS, ACTOR_THREAT_PROFILING_LABELS, CONSEQUENCE_TREES_LABELS, LEGISLATIVE_DISRUPTION_LABELS, RISK_MATRIX_LABELS, QUANTITATIVE_SWOT_LABELS, POLITICAL_CAPITAL_RISK_LABELS, LEGISLATIVE_VELOCITY_RISK_LABELS, AGENT_RISK_WORKFLOW_LABELS, STAKEHOLDER_IMPACT_LABELS, COALITION_DYNAMICS_LABELS, VOTING_PATTERNS_LABELS, CROSS_SESSION_INTELLIGENCE_LABELS, SYNTHESIS_SUMMARY_LABELS, DOCUMENT_ANALYSIS_LABELS, SIGNIFICANCE_SCORING_LABELS, } from './language-ui.js';
+export { PAGE_TITLES, PAGE_DESCRIPTIONS, SECTION_HEADINGS, NO_ARTICLES_MESSAGES, SKIP_LINK_TEXTS, ARTICLE_TYPE_LABELS, READ_TIME_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, RELATED_ARTICLES_NAV_LABELS, BREADCRUMB_HOME_LABELS, BREADCRUMB_NEWS_LABELS, TIMELINE_HEADINGS, COMPARISON_BEFORE_LABELS, COMPARISON_AFTER_LABELS, KEY_FIGURES_HEADINGS, AI_SECTION_CONTENT, FILTER_LABELS, SOURCES_HEADING_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, FOOTER_HOME_LABELS, FOOTER_SITEMAP_LABELS, FOOTER_RSS_LABELS, FOOTER_GITHUB_REPO_LABELS, FOOTER_LICENSE_LABELS, FOOTER_EUROPARL_LABELS, FOOTER_LINKEDIN_LABELS, FOOTER_SECURITY_POLICY_LABELS, FOOTER_CONTACT_LABELS, FOOTER_DISCLAIMER_LABELS, FOOTER_REPORT_ISSUES_LABELS, FOOTER_ARTICLES_AVAILABLE_LABELS, FOOTER_POLITICAL_INTELLIGENCE_LABELS, TOC_ARIA_LABELS, RELATED_ANALYSIS_LABELS, ANALYSIS_TRANSPARENCY_LABELS, ANALYSIS_SUMMARY_LABELS, METHODOLOGY_LABELS, TRANSPARENCY_DISCLOSURE_LABELS, CLASSIFICATION_ANALYSIS_LABELS, THREAT_ASSESSMENT_LABELS, RISK_SCORING_LABELS, DEEP_ANALYSIS_LABELS, VIEW_SOURCE_LABELS, OPEN_SOURCE_NOTE_LABELS, AI_ANALYSIS_GUIDE_LABELS, SWOT_FRAMEWORK_LABELS, RISK_METHODOLOGY_LABELS, THREAT_FRAMEWORK_LABELS, CLASSIFICATION_GUIDE_LABELS, STYLE_GUIDE_LABELS, SIGNIFICANCE_CLASSIFICATION_LABELS, ACTOR_MAPPING_LABELS, FORCES_ANALYSIS_LABELS, IMPACT_MATRIX_LABELS, POLITICAL_THREAT_LANDSCAPE_LABELS, ACTOR_THREAT_PROFILING_LABELS, CONSEQUENCE_TREES_LABELS, LEGISLATIVE_DISRUPTION_LABELS, RISK_MATRIX_LABELS, QUANTITATIVE_SWOT_LABELS, POLITICAL_CAPITAL_RISK_LABELS, LEGISLATIVE_VELOCITY_RISK_LABELS, AGENT_RISK_WORKFLOW_LABELS, STAKEHOLDER_IMPACT_LABELS, COALITION_DYNAMICS_LABELS, VOTING_PATTERNS_LABELS, CROSS_SESSION_INTELLIGENCE_LABELS, SYNTHESIS_SUMMARY_LABELS, DOCUMENT_ANALYSIS_LABELS, SIGNIFICANCE_SCORING_LABELS, INSTALL_APP_LABELS, UPDATE_AVAILABLE_LABELS, UPDATE_REFRESH_CTA_LABELS, UPDATE_DISMISS_LABELS, OFFLINE_TITLE_LABELS, OFFLINE_BODY_LABELS, OFFLINE_RETRY_LABELS, BUILD_INFO_COMMIT_LABELS, BUILD_INFO_DEPLOYED_LABELS, } from './language-ui.js';
 export type { AISection, RelationshipLabels, RelatedAnalysisStrings } from './language-ui.js';
 export { WEEK_AHEAD_TITLES, MONTH_AHEAD_TITLES, WEEKLY_REVIEW_TITLES, MONTHLY_REVIEW_TITLES, MOTIONS_TITLES, BREAKING_NEWS_TITLES, COMMITTEE_REPORTS_TITLES, PROPOSITIONS_TITLES, PROPOSITIONS_STRINGS, EDITORIAL_STRINGS, MOTIONS_STRINGS, WEEK_AHEAD_STRINGS, WEEK_AHEAD_STAKEHOLDER_STRINGS, BREAKING_STRINGS, DEEP_ANALYSIS_STRINGS, COMMITTEE_ANALYSIS_CONTENT_STRINGS, SWOT_STRINGS, DASHBOARD_STRINGS, SWOT_BUILDER_STRINGS, DASHBOARD_BUILDER_STRINGS, LOCALIZED_KEYWORDS, MONTH_IN_REVIEW_STRINGS, ANALYSIS_QUALITY_LABELS, ANALYSIS_INSIGHTS_HEADING, } from './language-articles.js';
 //# sourceMappingURL=languages.d.ts.map

package/scripts/constants/languages.js

@@ -10,6 +10,6 @@
  * - **language-articles** — Article-type title generators and body-text strings
  */
 export { ALL_LANGUAGES, LANGUAGE_PRESETS, LANGUAGE_FLAGS, LANGUAGE_NAMES, getLocalizedString, isSupportedLanguage, getTextDirection, } from './language-core.js';
-export { PAGE_TITLES, PAGE_DESCRIPTIONS, SECTION_HEADINGS, NO_ARTICLES_MESSAGES, SKIP_LINK_TEXTS, ARTICLE_TYPE_LABELS, READ_TIME_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, RELATED_ARTICLES_NAV_LABELS, BREADCRUMB_HOME_LABELS, BREADCRUMB_NEWS_LABELS, TIMELINE_HEADINGS, COMPARISON_BEFORE_LABELS, COMPARISON_AFTER_LABELS, KEY_FIGURES_HEADINGS, AI_SECTION_CONTENT, FILTER_LABELS, SOURCES_HEADING_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, FOOTER_HOME_LABELS, FOOTER_SITEMAP_LABELS, FOOTER_RSS_LABELS, FOOTER_GITHUB_REPO_LABELS, FOOTER_LICENSE_LABELS, FOOTER_EUROPARL_LABELS, FOOTER_LINKEDIN_LABELS, FOOTER_SECURITY_POLICY_LABELS, FOOTER_CONTACT_LABELS, FOOTER_DISCLAIMER_LABELS, FOOTER_REPORT_ISSUES_LABELS, FOOTER_ARTICLES_AVAILABLE_LABELS, FOOTER_POLITICAL_INTELLIGENCE_LABELS, TOC_ARIA_LABELS, RELATED_ANALYSIS_LABELS, ANALYSIS_TRANSPARENCY_LABELS, ANALYSIS_SUMMARY_LABELS, METHODOLOGY_LABELS, TRANSPARENCY_DISCLOSURE_LABELS, CLASSIFICATION_ANALYSIS_LABELS, THREAT_ASSESSMENT_LABELS, RISK_SCORING_LABELS, DEEP_ANALYSIS_LABELS, VIEW_SOURCE_LABELS, OPEN_SOURCE_NOTE_LABELS, AI_ANALYSIS_GUIDE_LABELS, SWOT_FRAMEWORK_LABELS, RISK_METHODOLOGY_LABELS, THREAT_FRAMEWORK_LABELS, CLASSIFICATION_GUIDE_LABELS, STYLE_GUIDE_LABELS, SIGNIFICANCE_CLASSIFICATION_LABELS, ACTOR_MAPPING_LABELS, FORCES_ANALYSIS_LABELS, IMPACT_MATRIX_LABELS, POLITICAL_THREAT_LANDSCAPE_LABELS, ACTOR_THREAT_PROFILING_LABELS, CONSEQUENCE_TREES_LABELS, LEGISLATIVE_DISRUPTION_LABELS, RISK_MATRIX_LABELS, QUANTITATIVE_SWOT_LABELS, POLITICAL_CAPITAL_RISK_LABELS, LEGISLATIVE_VELOCITY_RISK_LABELS, AGENT_RISK_WORKFLOW_LABELS, STAKEHOLDER_IMPACT_LABELS, COALITION_DYNAMICS_LABELS, VOTING_PATTERNS_LABELS, CROSS_SESSION_INTELLIGENCE_LABELS, SYNTHESIS_SUMMARY_LABELS, DOCUMENT_ANALYSIS_LABELS, SIGNIFICANCE_SCORING_LABELS, } from './language-ui.js';
+export { PAGE_TITLES, PAGE_DESCRIPTIONS, SECTION_HEADINGS, NO_ARTICLES_MESSAGES, SKIP_LINK_TEXTS, ARTICLE_TYPE_LABELS, READ_TIME_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, RELATED_ARTICLES_NAV_LABELS, BREADCRUMB_HOME_LABELS, BREADCRUMB_NEWS_LABELS, TIMELINE_HEADINGS, COMPARISON_BEFORE_LABELS, COMPARISON_AFTER_LABELS, KEY_FIGURES_HEADINGS, AI_SECTION_CONTENT, FILTER_LABELS, SOURCES_HEADING_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, FOOTER_HOME_LABELS, FOOTER_SITEMAP_LABELS, FOOTER_RSS_LABELS, FOOTER_GITHUB_REPO_LABELS, FOOTER_LICENSE_LABELS, FOOTER_EUROPARL_LABELS, FOOTER_LINKEDIN_LABELS, FOOTER_SECURITY_POLICY_LABELS, FOOTER_CONTACT_LABELS, FOOTER_DISCLAIMER_LABELS, FOOTER_REPORT_ISSUES_LABELS, FOOTER_ARTICLES_AVAILABLE_LABELS, FOOTER_POLITICAL_INTELLIGENCE_LABELS, TOC_ARIA_LABELS, RELATED_ANALYSIS_LABELS, ANALYSIS_TRANSPARENCY_LABELS, ANALYSIS_SUMMARY_LABELS, METHODOLOGY_LABELS, TRANSPARENCY_DISCLOSURE_LABELS, CLASSIFICATION_ANALYSIS_LABELS, THREAT_ASSESSMENT_LABELS, RISK_SCORING_LABELS, DEEP_ANALYSIS_LABELS, VIEW_SOURCE_LABELS, OPEN_SOURCE_NOTE_LABELS, AI_ANALYSIS_GUIDE_LABELS, SWOT_FRAMEWORK_LABELS, RISK_METHODOLOGY_LABELS, THREAT_FRAMEWORK_LABELS, CLASSIFICATION_GUIDE_LABELS, STYLE_GUIDE_LABELS, SIGNIFICANCE_CLASSIFICATION_LABELS, ACTOR_MAPPING_LABELS, FORCES_ANALYSIS_LABELS, IMPACT_MATRIX_LABELS, POLITICAL_THREAT_LANDSCAPE_LABELS, ACTOR_THREAT_PROFILING_LABELS, CONSEQUENCE_TREES_LABELS, LEGISLATIVE_DISRUPTION_LABELS, RISK_MATRIX_LABELS, QUANTITATIVE_SWOT_LABELS, POLITICAL_CAPITAL_RISK_LABELS, LEGISLATIVE_VELOCITY_RISK_LABELS, AGENT_RISK_WORKFLOW_LABELS, STAKEHOLDER_IMPACT_LABELS, COALITION_DYNAMICS_LABELS, VOTING_PATTERNS_LABELS, CROSS_SESSION_INTELLIGENCE_LABELS, SYNTHESIS_SUMMARY_LABELS, DOCUMENT_ANALYSIS_LABELS, SIGNIFICANCE_SCORING_LABELS, INSTALL_APP_LABELS, UPDATE_AVAILABLE_LABELS, UPDATE_REFRESH_CTA_LABELS, UPDATE_DISMISS_LABELS, OFFLINE_TITLE_LABELS, OFFLINE_BODY_LABELS, OFFLINE_RETRY_LABELS, BUILD_INFO_COMMIT_LABELS, BUILD_INFO_DEPLOYED_LABELS, } from './language-ui.js';
 export { WEEK_AHEAD_TITLES, MONTH_AHEAD_TITLES, WEEKLY_REVIEW_TITLES, MONTHLY_REVIEW_TITLES, MOTIONS_TITLES, BREAKING_NEWS_TITLES, COMMITTEE_REPORTS_TITLES, PROPOSITIONS_TITLES, PROPOSITIONS_STRINGS, EDITORIAL_STRINGS, MOTIONS_STRINGS, WEEK_AHEAD_STRINGS, WEEK_AHEAD_STAKEHOLDER_STRINGS, BREAKING_STRINGS, DEEP_ANALYSIS_STRINGS, COMMITTEE_ANALYSIS_CONTENT_STRINGS, SWOT_STRINGS, DASHBOARD_STRINGS, SWOT_BUILDER_STRINGS, DASHBOARD_BUILDER_STRINGS, LOCALIZED_KEYWORDS, MONTH_IN_REVIEW_STRINGS, ANALYSIS_QUALITY_LABELS, ANALYSIS_INSIGHTS_HEADING, } from './language-articles.js';
 //# sourceMappingURL=languages.js.map

package/scripts/generators/build-info.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Generate `build-info.json` (and the runtime `sw.js` from `sw.js.template`)
+ * at the project root. Called by `npm run prebuild` BEFORE the TypeScript
+ * compile step, so it stays in pure JS (no tsc dependency).
+ *
+ * The file is published at `/build-info.json` and polled by
+ * `js/pwa-register.js` to detect deploys. Schema:
+ *
+ *   {
+ *     "buildId":    "40-char-lowercase-hex",
+ *     "buildShort": "1234567",
+ *     "buildTime":  "2026-04-30T12:34:56.000Z",
+ *     "appVersion": "0.8.51",
+ *     "releaseTag": ""           // optional, empty when no tag
+ *   }
+ *
+ * Build metadata is resolved by `scripts/constants/config.js` so the
+ * generator, TypeScript templates, and runtime metadata share one source of
+ * truth for precedence, validation, and fallbacks.
+ *
+ * Idempotent: rerunning produces a byte-identical file when env + repo
+ * state are unchanged (ignoring BUILD_TIME drift).
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import {
+  APP_VERSION,
+  BUILD_ID,
+  BUILD_SHORT,
+  BUILD_TIME,
+  RELEASE_TAG,
+} from '../constants/config.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PROJECT_ROOT = path.resolve(__dirname, '..', '..');
+
+function main() {
+  const payload = {
+    buildId: BUILD_ID,
+    buildShort: BUILD_SHORT,
+    buildTime: BUILD_TIME,
+    appVersion: APP_VERSION,
+    releaseTag: RELEASE_TAG,
+  };
+
+  const outPath = path.join(PROJECT_ROOT, 'build-info.json');
+  fs.writeFileSync(outPath, JSON.stringify(payload, null, 2) + '\n', 'utf-8');
+  console.log(`✅ Wrote build-info.json (buildShort=${BUILD_SHORT}, appVersion=${APP_VERSION})`);
+
+  // Render the service-worker from its template — substitutes the build id
+  // into `CACHE_VERSION` so old caches are evicted on every deploy.
+  const tplPath = path.join(PROJECT_ROOT, 'sw.js.template');
+  const swPath = path.join(PROJECT_ROOT, 'sw.js');
+  if (fs.existsSync(tplPath)) {
+    const tpl = fs.readFileSync(tplPath, 'utf-8');
+    const rendered = tpl
+      .replace(/__BUILD_ID__/g, BUILD_ID)
+      .replace(/__BUILD_SHORT__/g, BUILD_SHORT);
+    fs.writeFileSync(swPath, rendered, 'utf-8');
+    console.log(`✅ Rendered sw.js from template (CACHE_VERSION=${BUILD_SHORT})`);
+  } else {
+    console.warn(`⚠️  sw.js.template not found at ${tplPath} — skipping sw.js render`);
+  }
+}
+
+main();

package/scripts/generators/news-indexes.js

@@ -10,7 +10,8 @@
 import path, { resolve } from 'path';
 import { pathToFileURL } from 'url';
 import { PROJECT_ROOT, APP_VERSION, NEWS_DIR } from '../constants/config.js';
-import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, PAGE_DESCRIPTIONS, SECTION_HEADINGS, NO_ARTICLES_MESSAGES, SKIP_LINK_TEXTS, AI_SECTION_CONTENT, FILTER_LABELS, ARTICLE_TYPE_LABELS, HEADER_SUBTITLE_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
+import { buildHeadFreshnessTags } from '../constants/build-info-meta.js';
+import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, PAGE_DESCRIPTIONS, SECTION_HEADINGS, NO_ARTICLES_MESSAGES, SKIP_LINK_TEXTS, AI_SECTION_CONTENT, FILTER_LABELS, ARTICLE_TYPE_LABELS, HEADER_SUBTITLE_LABELS, UPDATE_AVAILABLE_LABELS, UPDATE_REFRESH_CTA_LABELS, UPDATE_DISMISS_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
 import { buildSiteFooter, buildSiteHeader } from '../templates/section-builders.js';
 import { getNewsArticles, groupArticlesByLanguage, formatSlug, parseArticleFilename, extractArticleMeta, escapeHTML, atomicWrite, } from '../utils/file-utils.js';
 import { writeMetadataDatabase } from '../utils/news-metadata.js';
@@ -197,6 +198,10 @@ export function generateIndexHTML(lang, articles, metaMap = new Map()) {
   <meta name="theme-color" content="#003399">
   <link rel="alternate" type="application/rss+xml" title="EU Parliament Monitor RSS" href="rss.xml">
   <link rel="stylesheet" href="styles.css">
+  <meta name="ep-i18n-update-text" content="${escapeHTML(getLocalizedString(UPDATE_AVAILABLE_LABELS, lang))}">
+  <meta name="ep-i18n-update-cta" content="${escapeHTML(getLocalizedString(UPDATE_REFRESH_CTA_LABELS, lang))}">
+  <meta name="ep-i18n-dismiss" content="${escapeHTML(getLocalizedString(UPDATE_DISMISS_LABELS, lang))}">
+${buildHeadFreshnessTags('')}
 </head>
 <body>
   <a href="#main" class="skip-link">${skipLinkText}</a>

package/scripts/generators/political-intelligence/html.js

@@ -13,7 +13,8 @@
  * tradecraft behind every published article.
  */
 import { BASE_URL, THEME_TOGGLE_SCRIPT } from '../../constants/config.js';
-import { ALL_LANGUAGES, LANGUAGE_FLAGS, LANGUAGE_NAMES, PAGE_TITLES, SKIP_LINK_TEXTS, getLocalizedString, getTextDirection, } from '../../constants/languages.js';
+import { buildHeadFreshnessTags } from '../../constants/build-info-meta.js';
+import { ALL_LANGUAGES, LANGUAGE_FLAGS, LANGUAGE_NAMES, PAGE_TITLES, SKIP_LINK_TEXTS, UPDATE_AVAILABLE_LABELS, UPDATE_REFRESH_CTA_LABELS, UPDATE_DISMISS_LABELS, getLocalizedString, getTextDirection, } from '../../constants/languages.js';
 import { FOOTER_SITEMAP_LABELS } from '../../constants/language-ui.js';
 import { buildSiteFooter, buildSiteHeader, buildPageBanner, } from '../../templates/section-builders.js';
 import { escapeHTML } from '../../utils/file-utils.js';
@@ -366,6 +367,10 @@ ${hreflangLinks}
   <link rel="manifest" href="site.webmanifest">
   <meta name="theme-color" content="#003399">
   <link rel="stylesheet" href="styles.css">
+  <meta name="ep-i18n-update-text" content="${escapeHTML(getLocalizedString(UPDATE_AVAILABLE_LABELS, lang))}">
+  <meta name="ep-i18n-update-cta" content="${escapeHTML(getLocalizedString(UPDATE_REFRESH_CTA_LABELS, lang))}">
+  <meta name="ep-i18n-dismiss" content="${escapeHTML(getLocalizedString(UPDATE_DISMISS_LABELS, lang))}">
+${buildHeadFreshnessTags('')}
   <script type="application/ld+json">${jsonLdString}</script>
 </head>
 <body>

package/scripts/generators/sitemap/html.js

@@ -20,7 +20,8 @@
  * golden snapshots taken from `npm run prebuild`).
  */
 import { BASE_URL, THEME_TOGGLE_SCRIPT } from '../../constants/config.js';
-import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, PAGE_DESCRIPTIONS, SKIP_LINK_TEXTS, getLocalizedString, getTextDirection, } from '../../constants/languages.js';
+import { buildHeadFreshnessTags } from '../../constants/build-info-meta.js';
+import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, PAGE_DESCRIPTIONS, SKIP_LINK_TEXTS, UPDATE_AVAILABLE_LABELS, UPDATE_REFRESH_CTA_LABELS, UPDATE_DISMISS_LABELS, getLocalizedString, getTextDirection, } from '../../constants/languages.js';
 import { escapeHTML } from '../../utils/file-utils.js';
 import { detectCategory } from '../../utils/article-category.js';
 import { ARTICLE_TYPE_LABELS, FOOTER_POLITICAL_INTELLIGENCE_LABELS, } from '../../constants/language-ui.js';
@@ -245,6 +246,10 @@ ${hreflangLinks}
   <link rel="manifest" href="site.webmanifest">
   <meta name="theme-color" content="#003399">
   <link rel="stylesheet" href="styles.css">
+  <meta name="ep-i18n-update-text" content="${escapeHTML(getLocalizedString(UPDATE_AVAILABLE_LABELS, lang))}">
+  <meta name="ep-i18n-update-cta" content="${escapeHTML(getLocalizedString(UPDATE_REFRESH_CTA_LABELS, lang))}">
+  <meta name="ep-i18n-dismiss" content="${escapeHTML(getLocalizedString(UPDATE_DISMISS_LABELS, lang))}">
+${buildHeadFreshnessTags('')}
   <script type="application/ld+json">${jsonLdString}</script>
 </head>
 <body>

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, 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.2.15`). The news workflows, prompt
+ * (`european-parliament-mcp-server@1.2.18`). 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.2.15`) —
+ *    `european-parliament-mcp-server@1.2.18`) —
  *    `{status:"unavailable", items:[], generatedAt:"..."}` established by
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
@@ -168,9 +168,9 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
      *
      * @remarks
      * This repository is currently documented/configured against
-     * `european-parliament-mcp-server@1.2.15`.
+     * `european-parliament-mcp-server@1.2.18`.
      *
-     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.2.15 server):** the upstream server
+     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.2.18 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:
@@ -179,7 +179,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.2.15, so the
+     * No local post-filter is applied here. The repository is pinned to v1.2.18, so the
      * date-filter guarantees above apply; consumers running against an older server image
      * (pre-v1.2.14) must not assume them.
      */

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

@@ -10,7 +10,7 @@ import { ProcedureSeenCache } from './procedure-seen-cache.js';
 import { recordPendingDocument, markDocumentResolved, getPendingDocumentsForReprobe, escalateExpiredDocuments, getPendingDocumentsSummary, } from './pending-documents.js';
 /**
  * Canonical list of tools exposed by the European Parliament MCP gateway
- * (`european-parliament-mcp-server@1.2.15`). The news workflows, prompt
+ * (`european-parliament-mcp-server@1.2.18`). 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
@@ -114,7 +114,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.2.15 structured error codes and generic HTTP/network
+ * Maps EP MCP Server v1.2.18 structured error codes and generic HTTP/network
  * errors into one of six broad categories used for logging and retry decisions:
  *
  * Returned categories (priority order):
@@ -130,7 +130,7 @@ const CONTENT_NOT_YET_AVAILABLE_SUBSTRING = 'document indexed but content not ye
  */
 function classifyToolError(message) {
     const lowerMsg = message.toLowerCase();
-    // EP MCP Server v1.2.15 structured error codes (matched case-insensitively)
+    // EP MCP Server v1.2.18 structured error codes (matched case-insensitively)
     if (lowerMsg.includes('internal_error')) {
         return 'INTERNAL_ERROR';
     }
@@ -189,7 +189,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.2.15`) —
+ *    `european-parliament-mcp-server@1.2.18`) —
  *    `{status:"unavailable", items:[], generatedAt:"..."}` established by
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
@@ -548,9 +548,9 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
      *
      * @remarks
      * This repository is currently documented/configured against
-     * `european-parliament-mcp-server@1.2.15`.
+     * `european-parliament-mcp-server@1.2.18`.
      *
-     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.2.15 server):** the upstream server
+     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.2.18 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:
@@ -559,7 +559,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.2.15, so the
+     * No local post-filter is applied here. The repository is pinned to v1.2.18, so the
      * date-filter guarantees above apply; consumers running against an older server image
      * (pre-v1.2.14) must not assume them.
      */

package/scripts/templates/icons.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module Templates/Icons
+ * @description Inline SVG icon set used by the shared site header / footer
+ * to upgrade visual consistency across browsers (emoji rendering varies
+ * wildly between Windows, macOS, Android and Linux).
+ *
+ * Every icon is a 24×24 outline glyph that inherits `currentColor`. SVGs
+ * are emitted with `aria-hidden="true"` and `focusable="false"` so they
+ * stay decorative — call sites should keep their existing emoji span
+ * (also `aria-hidden`) so the visual diff is small while progressively
+ * enhancing the chrome.
+ *
+ * Returning `<span aria-hidden="true">` (empty) for unknown names keeps
+ * call sites safe even if a future caller passes a typo'd name.
+ */
+/** Identifiers for the icons exported from this module. */
+export type IconName = 'sponsor' | 'security' | 'rss' | 'github' | 'sitemap' | 'pi' | 'install' | 'refresh' | 'close';
+export interface IconOptions {
+    /** Pixel size for both width and height (default 18). */
+    readonly size?: number;
+}
+/**
+ * Render an inline SVG icon.
+ *
+ * @param name - One of the {@link IconName} values.
+ * @param opts - Optional overrides (currently size only).
+ * @returns SVG markup string, or an empty `<span aria-hidden>` for unknown names.
+ */
+export declare function icon(name: IconName, opts?: IconOptions): string;
+//# sourceMappingURL=icons.d.ts.map

package/scripts/templates/icons.js

@@ -0,0 +1,32 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+const PATHS = {
+    // Heart-in-circle for "Sponsor".
+    sponsor: '<path d="M12 21s-7-4.5-7-10a4 4 0 0 1 7-2.7A4 4 0 0 1 19 11c0 5.5-7 10-7 10Z" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linejoin="round"/>',
+    // Shield + checkmark.
+    security: '<path d="M12 3 4.5 6v6a8 8 0 0 0 7.5 8 8 8 0 0 0 7.5-8V6L12 3Z" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linejoin="round"/><path d="m9 12 2 2 4-4" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"/>',
+    rss: '<path d="M5 5a14 14 0 0 1 14 14M5 11a8 8 0 0 1 8 8M6 17.5a1.5 1.5 0 1 1 3 0 1.5 1.5 0 0 1-3 0Z" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round"/>',
+    github: '<path d="M12 3a9 9 0 0 0-2.85 17.54c.45.08.62-.2.62-.43v-1.5c-2.5.55-3.04-1.06-3.04-1.06-.4-1.05-1-1.32-1-1.32-.83-.57.06-.55.06-.55.92.07 1.4.94 1.4.94.81 1.4 2.13 1 2.65.76.08-.6.32-1 .58-1.23-2-.23-4.1-1-4.1-4.4 0-.97.34-1.77.9-2.4-.1-.23-.4-1.13.08-2.36 0 0 .73-.23 2.4.92a8.3 8.3 0 0 1 4.36 0c1.66-1.15 2.4-.92 2.4-.92.48 1.23.18 2.13.08 2.36.56.63.9 1.43.9 2.4 0 3.4-2.1 4.16-4.1 4.39.32.28.62.84.62 1.7v2.52c0 .24.17.52.62.43A9 9 0 0 0 12 3Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linejoin="round"/>',
+    sitemap: '<path d="M12 4v4M12 12v4M6 16v4M18 16v4M6 16h12M9 8h6v4H9V8ZM4 18h4v3H4v-3ZM16 18h4v3h-4v-3Z" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>',
+    // Compass for "Political Intelligence".
+    pi: '<circle cx="12" cy="12" r="9" fill="none" stroke="currentColor" stroke-width="1.6"/><path d="m9 15 2-6 6-2-2 6-6 2Z" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>',
+    install: '<path d="M12 3v12m0 0-4-4m4 4 4-4M5 19h14" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"/>',
+    refresh: '<path d="M21 12a9 9 0 1 1-3.5-7M21 4v5h-5" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"/>',
+    close: '<path d="M6 6l12 12M18 6 6 18" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round"/>',
+};
+/**
+ * Render an inline SVG icon.
+ *
+ * @param name - One of the {@link IconName} values.
+ * @param opts - Optional overrides (currently size only).
+ * @returns SVG markup string, or an empty `<span aria-hidden>` for unknown names.
+ */
+export function icon(name, opts = {}) {
+    const path = PATHS[name];
+    if (!path) {
+        return '<span class="icon icon-inline" aria-hidden="true"></span>';
+    }
+    const size = typeof opts.size === 'number' && opts.size > 0 ? opts.size : 18;
+    return `<svg class="icon icon-inline" width="${size}" height="${size}" viewBox="0 0 24 24" role="img" aria-hidden="true" focusable="false">${path}</svg>`;
+}
+//# sourceMappingURL=icons.js.map

package/scripts/templates/section-builders.js

@@ -7,8 +7,9 @@
  * timeline sections, comparison tables, and key figures bars.
  */
 import { escapeHTML } from '../utils/file-utils.js';
-import { ALL_LANGUAGES, LANGUAGE_FLAGS, LANGUAGE_NAMES, getLocalizedString, TOC_ARIA_LABELS, TIMELINE_HEADINGS, COMPARISON_BEFORE_LABELS, COMPARISON_AFTER_LABELS, KEY_FIGURES_HEADINGS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, FOOTER_HOME_LABELS, FOOTER_SITEMAP_LABELS, FOOTER_RSS_LABELS, FOOTER_GITHUB_REPO_LABELS, FOOTER_LICENSE_LABELS, FOOTER_EUROPARL_LABELS, FOOTER_LINKEDIN_LABELS, FOOTER_SECURITY_POLICY_LABELS, FOOTER_CONTACT_LABELS, FOOTER_DISCLAIMER_LABELS, FOOTER_REPORT_ISSUES_LABELS, FOOTER_ARTICLES_AVAILABLE_LABELS, FOOTER_POLITICAL_INTELLIGENCE_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, } from '../constants/languages.js';
-import { APP_VERSION, createThemeToggleButton } from '../constants/config.js';
+import { ALL_LANGUAGES, LANGUAGE_FLAGS, LANGUAGE_NAMES, getLocalizedString, TOC_ARIA_LABELS, TIMELINE_HEADINGS, COMPARISON_BEFORE_LABELS, COMPARISON_AFTER_LABELS, KEY_FIGURES_HEADINGS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, FOOTER_HOME_LABELS, FOOTER_SITEMAP_LABELS, FOOTER_RSS_LABELS, FOOTER_GITHUB_REPO_LABELS, FOOTER_LICENSE_LABELS, FOOTER_EUROPARL_LABELS, FOOTER_LINKEDIN_LABELS, FOOTER_SECURITY_POLICY_LABELS, FOOTER_CONTACT_LABELS, FOOTER_DISCLAIMER_LABELS, FOOTER_REPORT_ISSUES_LABELS, FOOTER_ARTICLES_AVAILABLE_LABELS, FOOTER_POLITICAL_INTELLIGENCE_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, BUILD_INFO_COMMIT_LABELS, BUILD_INFO_DEPLOYED_LABELS, } from '../constants/languages.js';
+import { APP_VERSION, BUILD_ID, BUILD_SHORT, BUILD_TIME, createThemeToggleButton, } from '../constants/config.js';
+import { icon } from './icons.js';
 import { stripScriptBlocks, stripHtmlTags } from '../utils/html-sanitize.js';
 /**
  * Count occurrences of a regex pattern in a string.
@@ -281,9 +282,9 @@ export function buildSiteHeader(options) {
         </span>
       </a>
       <div class="site-header__actions">
-        <a class="site-header__cta site-header__cta--sponsor" href="https://github.com/sponsors/Hack23">💖 Sponsor Hack23</a>
+        <a class="site-header__cta site-header__cta--sponsor" href="https://github.com/sponsors/Hack23">${icon('sponsor')}<span class="emoji" aria-hidden="true">💖</span> Sponsor Hack23</a>
         <a class="site-header__cta" href="https://www.hack23.com">Become a sponsor</a>
-        <a class="site-header__cta site-header__cta--security" href="https://github.com/Hack23/euparliamentmonitor/blob/main/SECURITY.md">🔐 Commitment to Transparency and Security</a>
+        <a class="site-header__cta site-header__cta--security" href="https://github.com/Hack23/euparliamentmonitor/blob/main/SECURITY.md">${icon('security')}<span class="emoji" aria-hidden="true">🔐</span> Commitment to Transparency and Security</a>
         ${createThemeToggleButton(themeToggleLabel)}
       </div>
       <nav class="site-header__langs" role="navigation" aria-label="Language selection">
@@ -366,6 +367,17 @@ export function buildSiteFooter(options) {
         ? `\n        <p class="footer-stats">${escapeHTML(getLocalizedString(FOOTER_ARTICLES_AVAILABLE_LABELS, lang).replace('{count}', String(articleCount)))}</p>`
         : '';
     const langGrid = buildFooterLangGrid(lang, pathPrefix);
+    const buildLabel = escapeHTML(getLocalizedString(BUILD_INFO_COMMIT_LABELS, lang));
+    const deployedLabel = escapeHTML(getLocalizedString(BUILD_INFO_DEPLOYED_LABELS, lang));
+    const safeBuildId = escapeHTML(BUILD_ID);
+    const safeBuildShort = escapeHTML(BUILD_SHORT);
+    const safeBuildTime = escapeHTML(BUILD_TIME);
+    const buildLine = `v${escapeHTML(APP_VERSION)} · ` +
+        `<a href="https://github.com/Hack23/euparliamentmonitor/commit/${safeBuildId}" ` +
+        `class="footer-build" title="${buildLabel} ${safeBuildShort}" rel="noopener">` +
+        `<code>${safeBuildShort}</code></a> · ` +
+        `<span class="footer-build-deployed">${deployedLabel}</span> ` +
+        `<time class="footer-build-time" datetime="${safeBuildTime}" data-relative-time>${safeBuildTime}</time>`;
     return `<footer class="site-footer" role="contentinfo">
     <div class="footer-content">
       <div class="footer-section">
@@ -378,17 +390,17 @@ export function buildSiteFooter(options) {
         <ul>
           <li><a href="${homeHref}">${homeLabel}</a></li>
           <li><a href="${homeHref}#main">News</a></li>
-          <li><a href="${analysisDocsHref}">📊 Analysis & Reports</a></li>
+          <li><a href="${analysisDocsHref}">📊 Analysis &amp; Reports</a></li>
           <li><a href="${pathPrefix}docs/index.html">Dashboard</a></li>
-          <li><a href="${politicalIntelligenceHref}">🧠 ${politicalIntelligenceLabel}</a></li>
-          <li><a href="${sitemapHref}">🗺️ ${sitemapLabel}</a></li>
+          <li><a href="${politicalIntelligenceHref}">${icon('pi')}<span class="emoji" aria-hidden="true">🧠</span> ${politicalIntelligenceLabel}</a></li>
+          <li><a href="${sitemapHref}">${icon('sitemap')}<span class="emoji" aria-hidden="true">🗺️</span> ${sitemapLabel}</a></li>
           <li><a href="${apiDocsHref}">📚 API Documentation (TypeDoc)</a></li>
-          <li><a href="${pathPrefix}rss.xml">${rssLabel}</a></li>
+          <li><a href="${pathPrefix}rss.xml">${icon('rss')}${rssLabel}</a></li>
           <li><a href="https://hack23.com/euparliamentmonitor.html">EU Parliament Monitor by Hack23</a></li>
           <li><a href="https://hack23.com/euparliamentmonitor-features.html">EU Parliament Monitor Features</a></li>
           <li><a href="https://hack23.com/cia-features.html">CIA Platform</a></li>
           <li><a href="https://www.riksdagen.se/">Sveriges Riksdag</a></li>
-          <li><a href="https://github.com/Hack23/euparliamentmonitor">${githubLabel}</a></li>
+          <li><a href="https://github.com/Hack23/euparliamentmonitor">${icon('github')}${githubLabel}</a></li>
           <li><a href="https://github.com/Hack23/euparliamentmonitor/issues">${reportIssuesLabel}</a></li>
           <li><a href="https://github.com/Hack23/euparliamentmonitor/blob/main/LICENSE">${licenseLabel}</a></li>
           <li><a href="https://www.europarl.europa.eu/">${europarlLabel}</a></li>
@@ -426,7 +438,7 @@ export function buildSiteFooter(options) {
       </div>
     </div>
     <div class="footer-bottom">
-      <p>&copy; 2008-${year} <a href="https://hack23.com">Hack23 AB</a> (Org.nr 5595347807) | Gothenburg, Sweden | v${escapeHTML(APP_VERSION)}</p>
+      <p>&copy; 2008-${year} <a href="https://hack23.com">Hack23 AB</a> (Org.nr 5595347807) | Gothenburg, Sweden | ${buildLine}</p>
       <p class="footer-disclaimer"><span aria-hidden="true">⚠️</span> ${disclaimerText} <a href="https://github.com/Hack23/euparliamentmonitor/issues">${reportIssuesLabel}</a>.</p>
     </div>
   </footer>`;

package/scripts/validate-analysis-completeness.js

@@ -803,6 +803,51 @@ function main() {
   const forwardRegistryResult = validateForwardStatementsRegistryCoverage(runDir, articleType);
   mergeForwardRegistryResult(results, forwardRegistryResult);
 
+  // ── Re-run improve/extend enforcement ────────────────────────────────────
+  // Detect whether this is a re-run of an existing same-day analysis by
+  // checking manifest.history[]. When prior runs exist the agent MUST extend
+  // every artifact (rewriteCount must equal total artifact count, and each
+  // carry-forward artifact must reach its extendFloor). These are hard-RED
+  // violations, not warnings. See `.github/prompts/02-analysis-protocol.md`
+  // §"Re-run improve/extend rule".
+  const isRerun =
+    Array.isArray(manifest.history) && manifest.history.length > 0;
+
+  // Load prior-run-diff.json if present (produced unconditionally by
+  // `npm run prior-run-diff` in Stage A). Use a safeReadJson wrapper so a
+  // corrupt file degrades gracefully.
+  let priorRunDiff = null;
+  const priorRunDiffPath = path.join(runDir, 'runs', 'prior-run-diff.json');
+  if (fs.existsSync(priorRunDiffPath)) {
+    const raw = safeReadJson(priorRunDiffPath);
+    if (!raw.__error) priorRunDiff = raw;
+  }
+
+  // Build a quick lookup: relativePath → extendFloor, used below.
+  const extendFloorByPath = new Map();
+  if (priorRunDiff?.carryForward && Array.isArray(priorRunDiff.carryForward)) {
+    for (const entry of priorRunDiff.carryForward) {
+      if (entry.relativePath && typeof entry.extendFloor === 'number') {
+        extendFloorByPath.set(entry.relativePath, entry.extendFloor);
+      }
+    }
+  }
+
+  // On re-runs, check every carry-forward artifact's new line count against
+  // its extendFloor. Failures are hard-RED violations injected directly into
+  // the per-artifact result (not warnings) because a skip-write on a
+  // carry-forward target defeats the never-no-op contract.
+  if (isRerun && extendFloorByPath.size > 0) {
+    for (const r of results) {
+      const extendFloor = extendFloorByPath.get(r.relativePath);
+      if (extendFloor === undefined) continue;
+      if (!r.exists) continue; // already flagged as missing
+      if (r.lines < extendFloor) {
+        r.issues.push(`extend:below-extendFloor(${r.lines}<${extendFloor})`);
+      }
+    }
+  }
+
   // Orphans are reported as warnings (not blocking) — they may be valid extras.
   const summary = summarize(results);
   const offending = results.filter((r) => r.issues.length > 0);
@@ -825,13 +870,15 @@ function main() {
     );
   }
 
-  const green = offending.length === 0;
-
+  // ── pass2 rewriteCount enforcement ───────────────────────────────────────
   // Pass-2-skipped heuristic: warn when manifest.pass2 is absent, malformed,
   // or `rewriteCount === 0` AND at least one artifact sits at exactly its
-  // line floor. This is the script-side enforcement of the B1/B2 split
-  // defined in `.github/prompts/02-analysis-protocol.md` §3. A malformed
-  // pass2 block (non-numeric, non-finite, negative, non-integer
+  // line floor. On a re-run, `rewriteCount === 0` is a hard-RED violation
+  // (not a warning) because every artifact must be extended — a zero count
+  // means Stage B was a no-op. See `.github/prompts/02-analysis-protocol.md`
+  // §"Re-run improve/extend rule".
+  //
+  // A malformed pass2 block (non-numeric, non-finite, negative, non-integer
   // rewriteCount, or missing/non-string startedAt/endedAt timestamps) is
   // treated like an absent block so the enforcement can't be bypassed by
   // typos or malformed values.
@@ -876,7 +923,19 @@ function main() {
     );
   }
 
-  if (pass2Absent || pass2Invalid || pass2ZeroRewrites) {
+  // On re-runs, a zero-rewrite pass2 is a hard-RED gate violation because
+  // every artifact must be extended. On first runs, it remains a warning.
+  let rerunZeroRewritesRed = false;
+  if (isRerun && pass2ZeroRewrites) {
+    rerunZeroRewritesRed = true;
+    process.stderr.write(
+      `RED rerun-no-op: manifest.pass2.rewriteCount === 0 on a re-run ` +
+        `(history[] non-empty) — Stage B must extend every artifact. ` +
+        `See .github/prompts/02-analysis-protocol.md §"Re-run improve/extend rule".\n`,
+    );
+  }
+
+  if (!rerunZeroRewritesRed && (pass2Absent || pass2Invalid || pass2ZeroRewrites)) {
     const atFloor = results.filter(
       (r) => r.exists && r.lines > 0 && r.lines === r.minLines,
     );
@@ -892,6 +951,8 @@ function main() {
     }
   }
 
+  const green = offending.length === 0 && !rerunZeroRewritesRed;
+
   const gateLine = green
     ? `STAGE_C_GATE: GREEN articleType=${articleType} artifacts=${results.length} lines=${summary.totalLines}`
     : `STAGE_C_GATE: RED articleType=${articleType} missing=${summary.missing} short=${summary.short} placeholders=${summary.placeholders} mermaid_missing=${summary.mermaidMissing} other=${summary.other}`;
@@ -905,6 +966,7 @@ function main() {
           articleType,
           runDir: path.relative(ROOT, runDir) || runDir,
           artifacts: results.length,
+          isRerun,
           summary,
           results,
           orphans,