euparliamentmonitor 0.8.46 → 0.8.48

package/README.md

@@ -163,7 +163,7 @@ The published platform at **[euparliamentmonitor.com](https://euparliamentmonito
 
 **MCP Server Integration**: The project uses the
 [European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server)
-v1.2.13 for accessing real EU Parliament data via the Model Context Protocol.
+v1.2.15 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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.46",
+  "version": "0.8.48",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -62,6 +62,7 @@
     "build:check-tests": "tsc --project tsconfig.test.json --noEmit",
     "copy-vendor": "node scripts/copy-vendor.js",
     "validate-analysis": "node scripts/validate-analysis-completeness.js",
+    "prior-run-diff": "node scripts/aggregator/prior-run-diff.js",
     "generate-article": "node scripts/aggregator/article-generator.js",
     "generate-article:all": "node scripts/aggregator/article-generator.js --all",
     "generate-news-indexes": "node scripts/generators/news-indexes.js",
@@ -158,7 +159,7 @@
     "husky": "9.1.7",
     "jscpd": "4.0.9",
     "lint-staged": "16.4.0",
-    "mermaid": "^11.14.0",
+    "mermaid": "11.14.0",
     "papaparse": "5.5.3",
     "prettier": "3.8.3",
     "ts-api-utils": "2.5.0",
@@ -171,7 +172,7 @@
     "node": ">=25"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.2.14",
+    "european-parliament-mcp-server": "1.2.15",
     "markdown-it": "^14.1.1",
     "markdown-it-anchor": "^9.2.0",
     "markdown-it-attrs": "^4.3.1",

package/scripts/aggregator/analysis-aggregator.d.ts

@@ -2,6 +2,17 @@ import { type ArtifactSection } from './artifact-order.js';
 /** Raw manifest shape as committed by the analysis pipeline. */
 export interface AnalysisManifest {
     readonly articleType: string;
+    /**
+     * Legacy plural variant emitted by some pre-aggregator-pipeline workflows.
+     * Used as a fallback when `articleType` is absent so historic runs with
+     * `articleTypes: ["<slug>"]` can still be aggregated.
+     */
+    readonly articleTypes?: readonly string[];
+    /**
+     * Legacy field emitted by older breaking-run manifests. Used as the last
+     * fallback when neither `articleType` nor `articleTypes` is present.
+     */
+    readonly runType?: string;
     readonly runId?: string;
     readonly date?: string;
     readonly analysisDir?: string;
@@ -167,6 +178,20 @@ export declare function renderAnalysisIndex(included: readonly IncludedArtifact[
  * @returns Markdown block containing the guide table
  */
 export declare function renderReaderIntelligenceGuide(sections: readonly TocSection[], included: readonly IncludedArtifact[]): string;
+/**
+ * Resolve the article-type slug from a manifest, tolerating legacy schemas.
+ *
+ * Resolution order (highest precedence first):
+ *   1. `articleType` — canonical singular field
+ *   2. `articleTypes[0]` — pre-aggregator-pipeline plural array
+ *   3. `runType` — legacy field on older breaking-run manifests
+ *
+ * Falls back to `'unknown'` when none of the above is a non-empty string.
+ *
+ * @param manifest - Parsed manifest (any of the supported schemas)
+ * @returns Article-type slug usable as a filename component
+ */
+export declare function resolveArticleTypeFromManifest(manifest: AnalysisManifest): string;
 /**
  * Read, clean, and concatenate every artifact declared by the run's manifest
  * (with discovery fallback when manifest.files is missing), returning a

package/scripts/aggregator/analysis-aggregator.js

@@ -471,6 +471,32 @@ function appendSection(runDir, runDirRelPath, sectionId, sectionTitle, paths, se
     }
     sectionMarkdown.push('');
 }
+/**
+ * Resolve the article-type slug from a manifest, tolerating legacy schemas.
+ *
+ * Resolution order (highest precedence first):
+ *   1. `articleType` — canonical singular field
+ *   2. `articleTypes[0]` — pre-aggregator-pipeline plural array
+ *   3. `runType` — legacy field on older breaking-run manifests
+ *
+ * Falls back to `'unknown'` when none of the above is a non-empty string.
+ *
+ * @param manifest - Parsed manifest (any of the supported schemas)
+ * @returns Article-type slug usable as a filename component
+ */
+export function resolveArticleTypeFromManifest(manifest) {
+    if (typeof manifest.articleType === 'string' && manifest.articleType) {
+        return manifest.articleType;
+    }
+    const first = manifest.articleTypes?.[0];
+    if (typeof first === 'string' && first) {
+        return first;
+    }
+    if (typeof manifest.runType === 'string' && manifest.runType) {
+        return manifest.runType;
+    }
+    return 'unknown';
+}
 /**
  * Read, clean, and concatenate every artifact declared by the run's manifest
  * (with discovery fallback when manifest.files is missing), returning a
@@ -516,7 +542,7 @@ export function aggregateAnalysisRun(options) {
             consumed.add(p);
     }
     const tradecraftFiles = options.tradecraftFiles ?? discoverTradecraftFiles(repoRoot);
-    const articleType = manifest.articleType ?? 'unknown';
+    const articleType = resolveArticleTypeFromManifest(manifest);
     const date = manifest.date ?? guessDateFromRunDir(runDirRelPath);
     const runId = manifest.runId ?? path.basename(runDir);
     const gateResult = latestGateResult(manifest);

package/scripts/aggregator/article-generator.js

@@ -19,7 +19,7 @@
 import fs from 'fs';
 import path from 'path';
 import { pathToFileURL } from 'url';
-import { aggregateAnalysisRun } from './analysis-aggregator.js';
+import { aggregateAnalysisRun, resolveArticleTypeFromManifest, } from './analysis-aggregator.js';
 import { resolveArticleMetadata, extractStrongProseLine, } from './article-metadata.js';
 import { renderMarkdown } from './markdown-renderer.js';
 import { wrapArticleHtml, getArticleFilename } from './article-html.js';
@@ -528,14 +528,21 @@ function readRunCandidate(runDir, manifestPath) {
     catch {
         return null;
     }
-    const articleType = typeof parsed.articleType === 'string' ? parsed.articleType : '';
+    // Resolve via the same precedence used by the aggregator (articleType →
+    // articleTypes[0] → runType) so legacy-schema manifests are picked up by
+    // batch mode rather than silently skipped.
+    const articleType = resolveArticleTypeFromManifest(parsed);
     if (!articleType || articleType === 'unknown')
         return null;
     const dateFromManifest = typeof parsed.date === 'string' ? parsed.date : '';
     const date = /^\d{4}-\d{2}-\d{2}$/.test(dateFromManifest)
         ? dateFromManifest
         : dateFromRunPath(runDir);
-    const runId = typeof parsed.runId === 'string' && parsed.runId ? parsed.runId : path.basename(runDir);
+    const runId = typeof parsed.runId === 'string' && parsed.runId
+        ? parsed.runId
+        : typeof parsed.runId === 'number'
+            ? String(parsed.runId)
+            : path.basename(runDir);
     return { runDir, articleType, date, runId };
 }
 /**
@@ -609,8 +616,9 @@ function readManifestMetadata(runDir) {
     try {
         const parsed = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
         const manifest = {};
-        if (typeof parsed.articleType === 'string') {
-            Object.assign(manifest, { articleType: parsed.articleType });
+        const resolvedType = resolveArticleTypeFromManifest(parsed);
+        if (resolvedType && resolvedType !== 'unknown') {
+            Object.assign(manifest, { articleType: resolvedType });
         }
         if (typeof parsed.date === 'string') {
             Object.assign(manifest, { date: parsed.date });

package/scripts/aggregator/article-html.js

@@ -10,11 +10,15 @@
  * consistent with the rest of the site.
  *
  * The output is a complete HTML5 document. No inline `<script>` is emitted
- * in the body. Mermaid is loaded from the vendored ESM bundle via
- * `<script type="module" src="js/vendor/mermaid.esm.min.mjs">` so CSP
- * stays `script-src 'self'`.
+ * in the body. Mermaid is loaded from the same-origin vendored ESM bundle
+ * (copied to `js/vendor/mermaid/` by `scripts/copy-vendor.js`) via
+ * `<script type="module" src="../js/mermaid-init.js?v=<MERMAID_VERSION>" defer>`
+ * so CSP stays `script-src 'self'`. The `?v=` query parameter is sourced
+ * from `devDependencies.mermaid` in `package.json` (a fixed pin like
+ * `11.14.0`); regenerating articles after a Mermaid bump invalidates
+ * browser and CloudFront caches automatically.
  */
-import { BASE_URL, createThemeToggleButton, THEME_TOGGLE_SCRIPT } from '../constants/config.js';
+import { BASE_URL, createThemeToggleButton, MERMAID_VERSION, THEME_TOGGLE_SCRIPT, } from '../constants/config.js';
 import { ALL_LANGUAGES, LANGUAGE_NAMES, LANGUAGE_FLAGS, PAGE_TITLES, SKIP_LINK_TEXTS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, TOC_ARIA_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
 import { escapeHTML } from '../utils/file-utils.js';
 import { buildSiteFooter } from '../templates/section-builders.js';
@@ -181,7 +185,7 @@ ${hreflangLinks}
   <meta name="theme-color" content="#003399">
   <link rel="stylesheet" href="../styles.css">
   <script type="application/ld+json">${jsonLdString}</script>
-  <script type="module" src="../js/mermaid-init.js" defer></script>
+  <script type="module" src="../js/mermaid-init.js?v=${MERMAID_VERSION}" defer></script>
 </head>
 <body>
   <a href="#main" class="skip-link">${escapeHTML(skipLinkText)}</a>

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

@@ -165,6 +165,23 @@ 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

package/scripts/aggregator/article-metadata.js

@@ -447,7 +447,12 @@ function safeReaddir(dir) {
  */
 export function buildTemplateFallback(articleType, date, committee) {
     const map = Object.create(null);
-    const weekRange = deriveWeekRange(date);
+    // week-in-review uses the D-36→D-8 reporting window (ADR-006) so that
+    // EP roll-call voting data — published 2–6 weeks after the sitting —
+    // is always available in the analysis window.
+    const weekRange = articleType === 'week-in-review'
+        ? deriveReportingWindowForWeekInReview(date)
+        : deriveWeekRange(date);
     const monthLabel = deriveMonthLabel(date);
     const committeeLabel = committee && committee.trim().length > 0 ? committee : 'Main Committees';
     for (const lang of ALL_LANGUAGES) {
@@ -503,6 +508,8 @@ function templateForType(lang, articleType, inputs) {
             };
     }
 }
+/** Milliseconds in one UTC day — used by date-window derivation helpers. */
+const MS_PER_DAY = 86_400_000;
 /**
  * Parse an ISO date and return the `[start, end]` week range as ISO
  * strings. Week starts on Monday and ends on the following Sunday.
@@ -518,10 +525,32 @@ export function deriveWeekRange(date) {
     const day = parsed.getUTCDay();
     // Shift so Monday = 0, Sunday = 6.
     const shift = (day + 6) % 7;
-    const startMs = parsed.getTime() - shift * 86_400_000;
-    const endMs = startMs + 6 * 86_400_000;
+    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