euparliamentmonitor 0.8.45 → 0.8.47

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.45",
+  "version": "0.8.47",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -158,7 +158,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 +171,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/constants/config.d.ts

@@ -33,6 +33,17 @@ export declare const ARTICLE_TYPE_MONTH_IN_REVIEW = ArticleCategory.MONTH_IN_REV
 export declare const ARG_SEPARATOR = "=";
 /** Application version read from package.json */
 export declare const APP_VERSION: string;
+/**
+ * Pinned Mermaid bundle version, read from `devDependencies.mermaid` in
+ * `package.json`. Used as a cache-busting query parameter on the
+ * `mermaid-init.js` script tag in generated article HTML so a Mermaid
+ * version bump in `package.json` automatically invalidates browser /
+ * CloudFront caches the next time articles are regenerated. Any leading
+ * semver range character (`^`, `~`, `>=`) is stripped — the contract for
+ * this repo is a fixed pin (e.g. `"mermaid": "11.14.0"`), but stripping
+ * keeps us robust if the pin is briefly relaxed during a dependency update.
+ */
+export declare const MERMAID_VERSION: string;
 /**
  * Generate theme toggle HTML button markup with a localized aria-label.
  * Renders a moon (light→dark) and sun (dark→light) icon; CSS controls visibility.

package/scripts/constants/config.js

@@ -61,6 +61,37 @@ export const APP_VERSION = (() => {
         return '0.0.0';
     }
 })();
+/**
+ * Pinned Mermaid bundle version, read from `devDependencies.mermaid` in
+ * `package.json`. Used as a cache-busting query parameter on the
+ * `mermaid-init.js` script tag in generated article HTML so a Mermaid
+ * version bump in `package.json` automatically invalidates browser /
+ * CloudFront caches the next time articles are regenerated. Any leading
+ * semver range character (`^`, `~`, `>=`) is stripped — the contract for
+ * this repo is a fixed pin (e.g. `"mermaid": "11.14.0"`), but stripping
+ * keeps us robust if the pin is briefly relaxed during a dependency update.
+ */
+export const MERMAID_VERSION = (() => {
+    try {
+        const pkgPath = path.join(PROJECT_ROOT, 'package.json');
+        const parsed = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        if (typeof parsed === 'object' && parsed !== null && 'devDependencies' in parsed) {
+            const devDeps = parsed.devDependencies;
+            if (typeof devDeps === 'object' && devDeps !== null && 'mermaid' in devDeps) {
+                const raw = devDeps.mermaid;
+                if (typeof raw === 'string' && raw.trim() !== '') {
+                    return raw.replace(/^[\^~><=\s]+/, '').trim();
+                }
+            }
+        }
+        console.warn('Invalid or missing "devDependencies.mermaid" in package.json, falling back to 0.0.0');
+        return '0.0.0';
+    }
+    catch (err) {
+        console.warn('Failed to read mermaid version from package.json:', err);
+        return '0.0.0';
+    }
+})();
 /**
  * Generate theme toggle HTML button markup with a localized aria-label.
  * Renders a moon (light→dark) and sun (dark→light) icon; CSS controls visibility.

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.14`). The news workflows, prompt
+ * (`european-parliament-mcp-server@1.2.15`). 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.14`) —
+ *    `european-parliament-mcp-server@1.2.15`) —
  *    `{status:"unavailable", items:[], generatedAt:"..."}` established by
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
@@ -133,21 +133,20 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
      *
      * @remarks
      * This repository is currently documented/configured against
-     * `european-parliament-mcp-server@1.2.13`.
+     * `european-parliament-mcp-server@1.2.15`.
      *
-     * **Conditional upstream note (v1.2.14+ only):** If the configured EP-MCP server is upgraded
-     * to v1.2.14 or newer, the upstream server applies a client-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 that newer upstream contract:
+     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.2.15 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:
      * - `data[]` contains only sessions within the requested window.
      * - `total` reflects the **filtered** count, not the raw upstream count.
      * - 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. When running against the pinned v1.2.13 baseline,
-     * callers should not assume the v1.2.14+ date-filter guarantees unless the server/runtime
-     * documentation has been updated accordingly.
+     * No local post-filter is applied here. The repository is pinned to v1.2.15, so the
+     * date-filter guarantees above apply; consumers running against an older server image
+     * (pre-v1.2.14) must not assume them.
      */
     getPlenarySessions(options?: GetPlenarySessionsOptions): Promise<MCPToolResult>;
     /**

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.14`). The news workflows, prompt
+ * (`european-parliament-mcp-server@1.2.15`). 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.14 structured error codes and generic HTTP/network
+ * Maps EP MCP Server v1.2.15 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.14 structured error codes (matched case-insensitively)
+    // EP MCP Server v1.2.15 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.14`) —
+ *    `european-parliament-mcp-server@1.2.15`) —
  *    `{status:"unavailable", items:[], generatedAt:"..."}` established by
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
@@ -449,21 +449,20 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
      *
      * @remarks
      * This repository is currently documented/configured against
-     * `european-parliament-mcp-server@1.2.13`.
+     * `european-parliament-mcp-server@1.2.15`.
      *
-     * **Conditional upstream note (v1.2.14+ only):** If the configured EP-MCP server is upgraded
-     * to v1.2.14 or newer, the upstream server applies a client-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 that newer upstream contract:
+     * **Upstream date-filter contract (v1.2.14+, active on the pinned v1.2.15 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:
      * - `data[]` contains only sessions within the requested window.
      * - `total` reflects the **filtered** count, not the raw upstream count.
      * - 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. When running against the pinned v1.2.13 baseline,
-     * callers should not assume the v1.2.14+ date-filter guarantees unless the server/runtime
-     * documentation has been updated accordingly.
+     * No local post-filter is applied here. The repository is pinned to v1.2.15, so the
+     * date-filter guarantees above apply; consumers running against an older server image
+     * (pre-v1.2.14) must not assume them.
      */
     async getPlenarySessions(options = {}) {
         return this.safeCallTool('get_plenary_sessions', options, '{"data": [], "total": 0}');

package/scripts/types/mcp.d.ts

@@ -404,7 +404,7 @@ export type FeedTimeframe = 'today' | 'one-day' | 'one-week' | 'one-month' | 'cu
  * These feeds serve a server-defined window. Historically (pre-v1.2.13) they
  * rejected `timeframe`/`startDate` with `INVALID_PARAMS`
  * (Hack23/European-Parliament-MCP-Server#377); as of
- * `european-parliament-mcp-server@1.2.13` (PR #379) the server silently
+ * `european-parliament-mcp-server@1.2.15` (PR #379) the server silently
  * ignores those params on fixed-window tools. The client continues to omit
  * them so intent matches behaviour and so we remain compatible with any
  * older pinned server version in downstream environments.