euparliamentmonitor 0.8.40 → 0.8.41

package/README.md

@@ -115,6 +115,13 @@ import {
 - [📔 API Documentation](https://euparliamentmonitor.com/docs/api/index.html) - TypeDoc-generated API reference
 - [📓 Test Coverage](https://euparliamentmonitor.com/docs/coverage/index.html) - Interactive coverage report
 
+**🤖 Agentic Pipeline:**
+- [Agent Catalog](.github/agents/README.md) — custom Copilot agents (analysis producers / consumers / gh-aw infrastructure)
+- [Skills Library](.github/skills/README.md) — shared skills (security, compliance, intelligence, gh-aw)
+- [Prompt Library](.github/prompts/README.md) — 10-file bounded-context prompt set (`00`→`09`) + `npm run lint:prompts` drift-guard
+- [Workflows](.github/workflows/README.md) + [WORKFLOWS.md](WORKFLOWS.md) — 10 `news-*.md` agentic workflows + CI workflows
+- [Analysis Chain](analysis/README.md) — 5-stage pipeline (Data → Analysis → Completeness Gate → Article → Single PR), methodologies, 39 templates, quality thresholds
+
 **🔒 ISMS Compliance:**
 - [🛡️ Hack23 ISMS Framework](https://github.com/Hack23/ISMS-PUBLIC) - Information Security Management System
 - [🔐 Secure Development Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Secure_Development_Policy.md) - Development standards
@@ -124,12 +131,17 @@ import {
 
 **MCP Server Integration**: The project uses the
 [European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server)
-v1.2.10 for accessing real EU Parliament data via the Model Context Protocol.
+v1.2.11 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)
-- **Agentic Workflows**: 10 gh-aw markdown workflows for automated news
-  generation with AI-driven political intelligence analysis
+- **Agentic Workflows**: 10 gh-aw markdown workflows (compiled with
+  `gh-aw v0.69.3`) for automated news generation with AI-driven political
+  intelligence analysis. See [`.github/workflows/README.md`](.github/workflows/README.md).
+- **Analysis Chain**: 5-stage pipeline (Data → Analysis → Completeness Gate →
+  Article → Single PR) producing 39 structured analysis templates per run.
+  See [`analysis/README.md`](analysis/README.md) and
+  [`analysis/methodologies/ai-driven-analysis-guide.md`](analysis/methodologies/ai-driven-analysis-guide.md).
 - **Fallback Mode**: News generation can work with reduced data when EP API
   endpoints are temporarily unavailable
 - **Environment Variable**: Set `USE_EP_MCP=false` to disable MCP client

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.40",
+  "version": "0.8.41",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -70,6 +70,7 @@
     "validate-articles:strict": "npx tsx src/utils/validate-articles.ts --strict",
     "validate-analysis": "npx tsx src/utils/validate-analysis-completeness.ts",
     "validate-ep-api": "npx tsx src/utils/validate-ep-api.ts",
+    "lint:prompts": "node scripts/lint-prompts.js",
     "htmlhint": "sh -c 'htmlhint *.html; set -- news/*.html; if [ -e \"$1\" ]; then htmlhint \"$@\"; else echo \"No news/*.html files to lint\"; fi'",
     "serve": "python3 -m http.server 8080",
     "test": "vitest run",
@@ -144,8 +145,8 @@
     "@types/papaparse": "5.5.2",
     "@typescript-eslint/eslint-plugin": "8.59.0",
     "@typescript-eslint/parser": "8.59.0",
-    "@vitest/coverage-v8": "4.1.4",
-    "@vitest/ui": "4.1.4",
+    "@vitest/coverage-v8": "4.1.5",
+    "@vitest/ui": "4.1.5",
     "chart.js": "4.5.1",
     "chartjs-plugin-annotation": "3.1.0",
     "d3": "7.9.0",
@@ -165,13 +166,13 @@
     "tsx": "4.21.0",
     "typedoc": "0.28.19",
     "typescript": "6.0.3",
-    "vitest": "4.1.4"
+    "vitest": "4.1.5"
   },
   "engines": {
     "node": ">=25"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.2.10"
+    "european-parliament-mcp-server": "1.2.11"
   },
   "optionalDependencies": {
     "worldbank-mcp": "1.0.1"

package/scripts/generators/pipeline/fetch-stage.d.ts

@@ -339,7 +339,7 @@ export declare function fetchDeclarationsFeed(client: EuropeanParliamentMCPClien
  * `_timeframe` is retained only for signature compatibility with sliding-window
  * fetchers (so the shared `fetchEPFeedData` orchestrator can dispatch uniformly);
  * the EP MCP server serves a server-defined fixed window for this feed and
- * ignores any timeframe input (as of v1.2.10; pre-v1.2.10 it rejected with
+ * ignores any timeframe input (as of v1.2.11; pre-v1.2.11 it rejected with
  * `INVALID_PARAMS` — see Hack23/European-Parliament-MCP-Server#377).
  *
  * @param client - MCP client or null

package/scripts/generators/pipeline/fetch-stage.js

@@ -1087,7 +1087,7 @@ class UpstreamTimeoutError extends Error {
 /**
  * Error thrown when the EP MCP server returns a response indicating the feed
  * is unavailable (uniform `{status:"unavailable"}` envelope or the legacy raw
- * upstream 404 envelope historically emitted pre-v1.2.10). Distinct from
+ * upstream 404 envelope historically emitted pre-v1.2.11). Distinct from
  * {@link UpstreamTimeoutError} so logs/diagnostics do not misattribute a
  * 404/unavailable response to a timeout. Shares the same control-flow role —
  * callers treat it as "stop the timeframe-widening retry loop and return the
@@ -1131,10 +1131,10 @@ function checkUpstreamTimeout(value) {
             'Consider using year-based endpoints as fallback.');
         throw new UpstreamTimeoutError(toolName);
     }
-    // Defensive detection of the legacy raw upstream 404 shape that pre-v1.2.10
+    // Defensive detection of the legacy raw upstream 404 shape that pre-v1.2.11
     // get_events_feed / get_procedures_feed emitted
     // (Hack23/European-Parliament-MCP-Server#378, closed by PR #380 in
-    // v1.2.10). Shape:
+    // v1.2.11). Shape:
     //   {"@id":"https://data.europarl.europa.eu/eli/dl/...", "error":"404 N..."}
     // Treated identically to the uniform `{status:"unavailable"}` envelope —
     // i.e. stop timeframe-widening retry loops instead of silently returning [].
@@ -1438,9 +1438,9 @@ export async function fetchMEPsFeedWithTotal(client, timeframe = 'one-week') {
  * accept `timeframe`/`startDate`, fixed-window feeds (documents,
  * plenary_documents, committee_documents, plenary_session_documents,
  * parliamentary_questions, corporate_bodies, controlled_vocabularies) serve a
- * server-defined window. As of v1.2.10 the server silently ignores
+ * server-defined window. As of v1.2.11 the server silently ignores
  * `timeframe`/`startDate` on fixed-window tools
- * (Hack23/European-Parliament-MCP-Server#379); pre-v1.2.10 it rejected them
+ * (Hack23/European-Parliament-MCP-Server#379); pre-v1.2.11 it rejected them
  * with `INVALID_PARAMS` (#377). This helper issues a single RPC either way —
  * there is no point in timeframe-widening retry loops because the server does
  * not narrow/widen results based on timeframe.
@@ -1597,7 +1597,7 @@ export async function fetchDeclarationsFeed(client, timeframe = 'one-week') {
  * `_timeframe` is retained only for signature compatibility with sliding-window
  * fetchers (so the shared `fetchEPFeedData` orchestrator can dispatch uniformly);
  * the EP MCP server serves a server-defined fixed window for this feed and
- * ignores any timeframe input (as of v1.2.10; pre-v1.2.10 it rejected with
+ * ignores any timeframe input (as of v1.2.11; pre-v1.2.11 it rejected with
  * `INVALID_PARAMS` — see Hack23/European-Parliament-MCP-Server#377).
  *
  * @param client - MCP client or null

package/scripts/lint-prompts.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Agentic-workflow prompt linter.
+ *
+ * Enforces the single-PR rule and forbidden-phrase list across every
+ * `.github/workflows/news-*.md` gh-aw workflow.
+ *
+ * Exceptions:
+ *   - `news-translate.md` uses a legitimate multi-call flush pattern and is
+ *     fully exempt from all three rules.
+ *
+ * Rules (applied per workflow file):
+ *   1. `safeoutputs___create_pull_request` appears AT MOST ONCE.
+ *   2. No forbidden phrases (case-insensitive): "checkpoint pr", "checkpoint-pr",
+ *      "keep-alive", "keepalive", "keep alive", "heartbeat",
+ *      "progressive safe output".
+ *   3. No `safeoutputs___push_repo_memory` references.
+ *   4. Analysis-awareness: news-*.md must either directly reference
+ *      `analysis/methodologies/ai-driven-analysis-guide.md` and
+ *      `03-analysis-completeness-gate.md`, OR import
+ *      `.github/agents/news-generation.agent.md` (which provides both).
+ *      news-translate.md is exempt.
+ *
+ * Usage:
+ *   node scripts/lint-prompts.js
+ *   node scripts/lint-prompts.js --workflows-dir .github/workflows
+ *
+ * Exit 0 if clean; non-zero with violations listed on stderr otherwise.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+
+const ROOT = process.cwd();
+
+const DEFAULT_DIR = path.join('.github', 'workflows');
+
+const ARGS = process.argv.slice(2);
+const dirIdx = ARGS.indexOf('--workflows-dir');
+const WORKFLOWS_DIR = dirIdx !== -1 && ARGS[dirIdx + 1]
+  ? ARGS[dirIdx + 1]
+  : DEFAULT_DIR;
+
+const ABS_DIR = path.resolve(ROOT, WORKFLOWS_DIR);
+
+const EXEMPT_FROM_SINGLE_PR = new Set(['news-translate.md']);
+const EXEMPT_FROM_PUSH_MEMORY = new Set(['news-translate.md']);
+// news-translate legitimately describes its own multi-call flush cadence, so it
+// is allowed to reference "checkpoint", "keep-alive", "heartbeat" etc. in
+// documentation form. The single-PR rule does not apply to it.
+const EXEMPT_FROM_PHRASE_CHECK = new Set(['news-translate.md']);
+// news-translate does not need the analysis chain (it is a translation-only
+// flush pattern with no Stage B/C/D analysis).
+const EXEMPT_FROM_ANALYSIS_AWARENESS = new Set(['news-translate.md']);
+
+// Workflows either reference these anchors directly, OR import the shared
+// news-generation agent which brings them in transitively.
+const ANALYSIS_ANCHOR_GUIDE = 'analysis/methodologies/ai-driven-analysis-guide.md';
+const ANALYSIS_ANCHOR_GATE = '03-analysis-completeness-gate.md';
+const NEWS_GENERATION_IMPORT = '.github/agents/news-generation.agent.md';
+
+const FORBIDDEN_PHRASES = [
+  /\bcheckpoint\s+pr\b/i,
+  /\bcheckpoint-pr\b/i,
+  /\bkeep-alive\b/i,
+  /\bkeepalive\b/i,
+  /\bkeep\s+alive\b/i,
+  /\bheartbeat\b/i,
+  /\bprogressive\s+safe\s+output\b/i,
+];
+
+function collectWorkflowFiles(dir) {
+  if (!fs.existsSync(dir)) {
+    return [];
+  }
+  return fs
+    .readdirSync(dir)
+    .filter((name) => name.startsWith('news-') && name.endsWith('.md'))
+    .sort();
+}
+
+function countOccurrences(text, needle) {
+  if (!needle) return 0;
+  let count = 0;
+  let idx = text.indexOf(needle);
+  while (idx !== -1) {
+    count += 1;
+    idx = text.indexOf(needle, idx + needle.length);
+  }
+  return count;
+}
+
+function lintFile(filePath, fileName) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const violations = [];
+
+  // Rule 1: at most one safeoutputs___create_pull_request reference.
+  if (!EXEMPT_FROM_SINGLE_PR.has(fileName)) {
+    const prCount = countOccurrences(content, 'safeoutputs___create_pull_request');
+    if (prCount > 1) {
+      violations.push(
+        `references 'safeoutputs___create_pull_request' ${prCount} times — must appear at most once (single-PR rule). See .github/prompts/06-pr-and-safe-outputs.md`,
+      );
+    }
+  }
+
+  // Rule 2: forbidden phrases.
+  if (!EXEMPT_FROM_PHRASE_CHECK.has(fileName)) {
+    for (const pattern of FORBIDDEN_PHRASES) {
+      const match = content.match(pattern);
+      if (match) {
+        // Only record the first hit per pattern to keep output concise.
+        const lineNumber = content.slice(0, match.index).split('\n').length;
+        violations.push(
+          `line ${lineNumber}: forbidden phrase ${JSON.stringify(match[0])} matched by ${pattern.toString()} — banned by single-PR rule. See .github/prompts/06-pr-and-safe-outputs.md`,
+        );
+      }
+    }
+  }
+
+  // Rule 3: no safeoutputs___push_repo_memory outside news-translate.md.
+  if (!EXEMPT_FROM_PUSH_MEMORY.has(fileName)) {
+    if (content.includes('safeoutputs___push_repo_memory')) {
+      const idx = content.indexOf('safeoutputs___push_repo_memory');
+      const lineNumber = content.slice(0, idx).split('\n').length;
+      violations.push(
+        `line ${lineNumber}: 'safeoutputs___push_repo_memory' is banned (heartbeat pattern). Remove the reference.`,
+      );
+    }
+  }
+
+  // Rule 4: analysis-awareness.
+  // Each news-*.md (except news-translate) must either directly reference the
+  // analysis anchors or import the shared news-generation agent which carries
+  // them transitively. This prevents a workflow from drifting out of the
+  // Data → Analysis Artifacts → Completeness Gate → Article → PR chain.
+  if (!EXEMPT_FROM_ANALYSIS_AWARENESS.has(fileName)) {
+    const importsNewsGen = content.includes(NEWS_GENERATION_IMPORT);
+    const refsGuide = content.includes(ANALYSIS_ANCHOR_GUIDE);
+    const refsGate = content.includes(ANALYSIS_ANCHOR_GATE);
+    if (!importsNewsGen) {
+      if (!refsGuide) {
+        violations.push(
+          `missing analysis-awareness anchor: must either import '${NEWS_GENERATION_IMPORT}' or reference '${ANALYSIS_ANCHOR_GUIDE}'. See .github/prompts/README.md § Analysis Artifact Integration.`,
+        );
+      }
+      if (!refsGate) {
+        violations.push(
+          `missing completeness-gate anchor: must either import '${NEWS_GENERATION_IMPORT}' or reference '${ANALYSIS_ANCHOR_GATE}'. See .github/prompts/README.md § Analysis Artifact Integration.`,
+        );
+      }
+    }
+  }
+
+  return violations;
+}
+
+function main() {
+  const files = collectWorkflowFiles(ABS_DIR);
+  if (files.length === 0) {
+    console.error(`lint-prompts: no news-*.md workflows found in ${ABS_DIR}`);
+    process.exit(2);
+  }
+
+  let totalViolations = 0;
+  let filesWithViolations = 0;
+  const report = [];
+  for (const fileName of files) {
+    const filePath = path.join(ABS_DIR, fileName);
+    const violations = lintFile(filePath, fileName);
+    if (violations.length > 0) {
+      totalViolations += violations.length;
+      filesWithViolations += 1;
+      report.push(`\n❌ ${fileName}`);
+      for (const v of violations) {
+        report.push(`   - ${v}`);
+      }
+    }
+  }
+
+  if (totalViolations === 0) {
+    console.log(`lint-prompts: ✅ ${files.length} workflow(s) checked, 0 violations`);
+    process.exit(0);
+  }
+
+  console.error(
+    `lint-prompts: ❌ ${totalViolations} violation(s) across ${filesWithViolations} file(s)`,
+  );
+  for (const line of report) {
+    console.error(line);
+  }
+  console.error('');
+  console.error('Fix: see .github/prompts/06-pr-and-safe-outputs.md — the single-PR rule.');
+  process.exit(1);
+}
+
+main();

package/scripts/mcp/ep-mcp-client.d.ts

@@ -5,17 +5,29 @@
  */
 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 } from '../types/index.js';
+/**
+ * Canonical list of tools exposed by the European Parliament MCP gateway
+ * (`european-parliament-mcp-server@1.2.11`). 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
+ * (`test/integration/mcp/ep-mcp.test.js`) instead of silently breaking
+ * prompt/validator/probe coverage.
+ *
+ * Kept in sync with every `this.safeCallTool('<name>', ...)` call below.
+ */
+export declare const EP_MCP_TOOLS: readonly string[];
 /**
  * Detect whether an MCP feed result represents an "unavailable" response,
  * covering the two shapes historically emitted by the EP MCP server.
  *
  * 1. **Uniform envelope** (all feeds as of
- *    `european-parliament-mcp-server@1.2.10`) —
+ *    `european-parliament-mcp-server@1.2.11`) —
  *    `{status:"unavailable", items:[], generatedAt:"..."}` established by
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
  *    Hack23/European-Parliament-MCP-Server#380 (which closed #378).
- * 2. **Legacy raw upstream 404 shape** (historically emitted pre-v1.2.10 by
+ * 2. **Legacy raw upstream 404 shape** (historically emitted pre-v1.2.11 by
  *    `get_events_feed` / `get_procedures_feed`, fixed upstream in PR #380) —
  *    `{"@id":"https://data.europarl.europa.eu/eli/dl/...","error":"404 N..."}`.
  *    Retained purely as defense-in-depth for older pinned server versions or
@@ -117,7 +129,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Search legislative documents
      *
-     * @param options - Search options using v1.2.10 parameters: keyword, documentType, docId, etc.
+     * @param options - Search options using v1.2.11 parameters: keyword, documentType, docId, etc.
      * @returns Search results
      */
     searchDocuments(options?: SearchDocumentsOptions): Promise<MCPToolResult>;
@@ -250,14 +262,14 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get plenary speeches and debate contributions
      *
-     * @param options - Filter options including optional speechId, dateFrom/dateTo (v1.2.10: year removed)
+     * @param options - Filter options including optional speechId, dateFrom/dateTo (v1.2.11: year removed)
      * @returns Speeches data
      */
     getSpeeches(options?: GetSpeechesOptions): Promise<MCPToolResult>;
     /**
      * Get legislative procedures
      *
-     * @param options - Filter options including optional processId (v1.2.10: year removed)
+     * @param options - Filter options including optional processId (v1.2.11: year removed)
      * @returns Procedures data
      */
     getProcedures(options?: GetProceduresOptions): Promise<MCPToolResult>;
@@ -277,7 +289,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get European Parliament events (hearings, conferences, seminars)
      *
-     * @param options - Filter options including optional eventId, pagination only (v1.2.10: year/dateFrom/dateTo removed — EP API /events has no date filtering)
+     * @param options - Filter options including optional eventId, pagination only (v1.2.11: year/dateFrom/dateTo removed — EP API /events has no date filtering)
      * @returns Events data
      */
     getEvents(options?: GetEventsOptions): Promise<MCPToolResult>;
@@ -333,7 +345,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get committee documents
      *
-     * @param options - Filter options including optional docId (v1.2.10: year removed)
+     * @param options - Filter options including optional docId (v1.2.11: year removed)
      * @returns Committee documents data
      */
     getCommitteeDocuments(options?: GetCommitteeDocumentsOptions): Promise<MCPToolResult>;
@@ -361,7 +373,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get external documents (non-EP documents such as Council positions)
      *
-     * @param options - Filter options including optional docId (v1.2.10: year removed)
+     * @param options - Filter options including optional docId (v1.2.11: year removed)
      * @returns External documents data
      */
     getExternalDocuments(options?: GetExternalDocumentsOptions): Promise<MCPToolResult>;

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

@@ -6,6 +6,81 @@
  * built on top of the generic {@link MCPConnection} transport.
  */
 import { MCPConnection } from './mcp-connection.js';
+/**
+ * Canonical list of tools exposed by the European Parliament MCP gateway
+ * (`european-parliament-mcp-server@1.2.11`). 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
+ * (`test/integration/mcp/ep-mcp.test.js`) instead of silently breaking
+ * prompt/validator/probe coverage.
+ *
+ * Kept in sync with every `this.safeCallTool('<name>', ...)` call below.
+ */
+export const EP_MCP_TOOLS = [
+    'analyze_coalition_dynamics',
+    'analyze_committee_activity',
+    'analyze_country_delegation',
+    'analyze_legislative_effectiveness',
+    'analyze_voting_patterns',
+    'assess_mep_influence',
+    'comparative_intelligence',
+    'compare_political_groups',
+    'correlate_intelligence',
+    'detect_voting_anomalies',
+    'early_warning_system',
+    'generate_political_landscape',
+    'generate_report',
+    'get_adopted_texts',
+    'get_adopted_texts_feed',
+    'get_all_generated_stats',
+    'get_committee_documents',
+    'get_committee_documents_feed',
+    'get_committee_info',
+    'get_controlled_vocabularies',
+    'get_controlled_vocabularies_feed',
+    'get_corporate_bodies_feed',
+    'get_current_meps',
+    'get_documents_feed',
+    'get_events',
+    'get_events_feed',
+    'get_external_documents',
+    'get_external_documents_feed',
+    'get_homonym_meps',
+    'get_incoming_meps',
+    'get_meeting_activities',
+    'get_meeting_decisions',
+    'get_meeting_foreseen_activities',
+    'get_meeting_plenary_session_document_items',
+    'get_meeting_plenary_session_documents',
+    'get_mep_declarations',
+    'get_mep_declarations_feed',
+    'get_mep_details',
+    'get_meps',
+    'get_meps_feed',
+    'get_outgoing_meps',
+    'get_parliamentary_questions',
+    'get_parliamentary_questions_feed',
+    'get_plenary_documents',
+    'get_plenary_documents_feed',
+    'get_plenary_session_document_items',
+    'get_plenary_session_documents',
+    'get_plenary_session_documents_feed',
+    'get_plenary_sessions',
+    'get_procedure_event_by_id',
+    'get_procedure_events',
+    'get_procedures',
+    'get_procedures_feed',
+    'get_server_health',
+    'get_speeches',
+    'get_voting_records',
+    'monitor_legislative_pipeline',
+    'network_analysis',
+    'search_documents',
+    'sentiment_tracker',
+    'track_legislation',
+    'track_mep_attendance',
+];
 /** Fallback payload for analyze_legislative_effectiveness when validation fails or tool is unavailable */
 const EFFECTIVENESS_FALLBACK = '{"effectiveness": null}';
 /** Fallback payload for MEP list tools */
@@ -29,7 +104,7 @@ const SERVER_HEALTH_FALLBACK = '{"server": null, "feeds": []}';
 /**
  * Classify an error message into a diagnostic error category.
  *
- * Maps EP MCP Server v1.2.10 structured error codes and generic HTTP/network
+ * Maps EP MCP Server v1.2.11 structured error codes and generic HTTP/network
  * errors into one of six broad categories used for logging and retry decisions:
  *
  * Returned categories (priority order):
@@ -45,7 +120,7 @@ const SERVER_HEALTH_FALLBACK = '{"server": null, "feeds": []}';
  */
 function classifyToolError(message) {
     const lowerMsg = message.toLowerCase();
-    // EP MCP Server v1.2.10 structured error codes (matched case-insensitively)
+    // EP MCP Server v1.2.11 structured error codes (matched case-insensitively)
     if (lowerMsg.includes('internal_error')) {
         return 'INTERNAL_ERROR';
     }
@@ -104,12 +179,12 @@ 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.10`) —
+ *    `european-parliament-mcp-server@1.2.11`) —
  *    `{status:"unavailable", items:[], generatedAt:"..."}` established by
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
  *    Hack23/European-Parliament-MCP-Server#380 (which closed #378).
- * 2. **Legacy raw upstream 404 shape** (historically emitted pre-v1.2.10 by
+ * 2. **Legacy raw upstream 404 shape** (historically emitted pre-v1.2.11 by
  *    `get_events_feed` / `get_procedures_feed`, fixed upstream in PR #380) —
  *    `{"@id":"https://data.europarl.europa.eu/eli/dl/...","error":"404 N..."}`.
  *    Retained purely as defense-in-depth for older pinned server versions or
@@ -129,7 +204,7 @@ export function isFeedUnavailable(result) {
     // Shape 1 — uniform {status:"unavailable"} envelope (#301 / #380).
     if (envelope['status'] === 'unavailable')
         return true;
-    // Shape 2 — legacy raw upstream 404 leak (historically pre-v1.2.10, #378).
+    // Shape 2 — legacy raw upstream 404 leak (historically pre-v1.2.11, #378).
     const error = envelope['error'];
     const idField = envelope['@id'];
     if (typeof error === 'string' &&
@@ -227,8 +302,8 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
                 return this._recordToolFailure(toolName, result.content?.[0]?.text ?? '', fallbackText);
             }
             // Detect the unavailable-feed envelope — uniform `{status:"unavailable"}`
-            // (all feeds as of v1.2.10, #301/#380) as well as the legacy raw upstream
-            // 404 shape `{"@id":..., "error":"404 ..."}` that pre-v1.2.10
+            // (all feeds as of v1.2.11, #301/#380) as well as the legacy raw upstream
+            // 404 shape `{"@id":..., "error":"404 ..."}` that pre-v1.2.11
             // get_events_feed / get_procedures_feed emitted
             // (Hack23/European-Parliament-MCP-Server#378, closed by PR #380). The
             // server returns HTTP 200 with a payload that bypasses isError — record
@@ -359,7 +434,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Search legislative documents
      *
-     * @param options - Search options using v1.2.10 parameters: keyword, documentType, docId, etc.
+     * @param options - Search options using v1.2.11 parameters: keyword, documentType, docId, etc.
      * @returns Search results
      */
     async searchDocuments(options = {}) {
@@ -568,7 +643,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get plenary speeches and debate contributions
      *
-     * @param options - Filter options including optional speechId, dateFrom/dateTo (v1.2.10: year removed)
+     * @param options - Filter options including optional speechId, dateFrom/dateTo (v1.2.11: year removed)
      * @returns Speeches data
      */
     async getSpeeches(options = {}) {
@@ -577,7 +652,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get legislative procedures
      *
-     * @param options - Filter options including optional processId (v1.2.10: year removed)
+     * @param options - Filter options including optional processId (v1.2.11: year removed)
      * @returns Procedures data
      */
     async getProcedures(options = {}) {
@@ -610,7 +685,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get European Parliament events (hearings, conferences, seminars)
      *
-     * @param options - Filter options including optional eventId, pagination only (v1.2.10: year/dateFrom/dateTo removed — EP API /events has no date filtering)
+     * @param options - Filter options including optional eventId, pagination only (v1.2.11: year/dateFrom/dateTo removed — EP API /events has no date filtering)
      * @returns Events data
      */
     async getEvents(options = {}) {
@@ -690,7 +765,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get committee documents
      *
-     * @param options - Filter options including optional docId (v1.2.10: year removed)
+     * @param options - Filter options including optional docId (v1.2.11: year removed)
      * @returns Committee documents data
      */
     async getCommitteeDocuments(options = {}) {
@@ -726,7 +801,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get external documents (non-EP documents such as Council positions)
      *
-     * @param options - Filter options including optional docId (v1.2.10: year removed)
+     * @param options - Filter options including optional docId (v1.2.11: year removed)
      * @returns External documents data
      */
     async getExternalDocuments(options = {}) {

package/scripts/types/mcp.d.ts

@@ -218,7 +218,7 @@ export interface GetCurrentMEPsOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getSpeeches — v1.2.10 removed `year` (EP API ignores it for /speeches) */
+/** Options for getSpeeches — v1.2.11 removed `year` (EP API ignores it for /speeches) */
 export interface GetSpeechesOptions {
     speechId?: string | undefined;
     /** Filter by sitting date start (maps to sitting-date in EP API) */
@@ -228,7 +228,7 @@ export interface GetSpeechesOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getProcedures — v1.2.10 removed `year` (EP API ignores it for /procedures) */
+/** Options for getProcedures — v1.2.11 removed `year` (EP API ignores it for /procedures) */
 export interface GetProceduresOptions {
     processId?: string | undefined;
     limit?: number | undefined;
@@ -241,7 +241,7 @@ export interface GetAdoptedTextsOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getEvents — v1.2.10 removed `year`, `dateFrom`, `dateTo` (EP API /events has no date filtering) */
+/** Options for getEvents — v1.2.11 removed `year`, `dateFrom`, `dateTo` (EP API /events has no date filtering) */
 export interface GetEventsOptions {
     eventId?: string | undefined;
     limit?: number | undefined;
@@ -288,7 +288,7 @@ export interface GetPlenaryDocumentsOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getCommitteeDocuments — v1.2.10 removed `year` (EP API ignores it for /committee-documents) */
+/** Options for getCommitteeDocuments — v1.2.11 removed `year` (EP API ignores it for /committee-documents) */
 export interface GetCommitteeDocumentsOptions {
     docId?: string | undefined;
     limit?: number | undefined;
@@ -311,7 +311,7 @@ export interface GetControlledVocabulariesOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getExternalDocuments — v1.2.10 removed `year` (EP API ignores it for /external-documents) */
+/** Options for getExternalDocuments — v1.2.11 removed `year` (EP API ignores it for /external-documents) */
 export interface GetExternalDocumentsOptions {
     docId?: string | undefined;
     limit?: number | undefined;
@@ -395,10 +395,10 @@ export type FeedTimeframe = 'today' | 'one-day' | 'one-week' | 'one-month' | 'cu
  * `plenary_session_documents`, `parliamentary_questions`,
  * `corporate_bodies`, `controlled_vocabularies`).
  *
- * These feeds serve a server-defined window. Historically (pre-v1.2.10) they
+ * These feeds serve a server-defined window. Historically (pre-v1.2.11) they
  * rejected `timeframe`/`startDate` with `INVALID_PARAMS`
  * (Hack23/European-Parliament-MCP-Server#377); as of
- * `european-parliament-mcp-server@1.2.10` (PR #379) the server silently
+ * `european-parliament-mcp-server@1.2.11` (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.
@@ -444,16 +444,16 @@ export interface GetMEPDeclarationsFeedOptions extends FeedBaseOptions {
     /** Filter by work type */
     workType?: string | undefined;
 }
-/** Options for getDocumentsFeed (fixed-window — server ignores `timeframe` as of v1.2.10) */
+/** Options for getDocumentsFeed (fixed-window — server ignores `timeframe` as of v1.2.11) */
 export interface GetDocumentsFeedOptions extends FixedWindowFeedOptions {
 }
-/** Options for getPlenaryDocumentsFeed (fixed-window — server ignores `timeframe` as of v1.2.10) */
+/** Options for getPlenaryDocumentsFeed (fixed-window — server ignores `timeframe` as of v1.2.11) */
 export interface GetPlenaryDocumentsFeedOptions extends FixedWindowFeedOptions {
 }
-/** Options for getCommitteeDocumentsFeed (fixed-window — server ignores `timeframe` as of v1.2.10) */
+/** Options for getCommitteeDocumentsFeed (fixed-window — server ignores `timeframe` as of v1.2.11) */
 export interface GetCommitteeDocumentsFeedOptions extends FixedWindowFeedOptions {
 }
-/** Options for getPlenarySessionDocumentsFeed (fixed-window — server ignores `timeframe` as of v1.2.10) */
+/** Options for getPlenarySessionDocumentsFeed (fixed-window — server ignores `timeframe` as of v1.2.11) */
 export interface GetPlenarySessionDocumentsFeedOptions extends FixedWindowFeedOptions {
 }
 /** Options for getExternalDocumentsFeed */
@@ -461,13 +461,13 @@ export interface GetExternalDocumentsFeedOptions extends FeedBaseOptions {
     /** Filter by work type */
     workType?: string | undefined;
 }
-/** Options for getParliamentaryQuestionsFeed (fixed-window — server ignores `timeframe` as of v1.2.10) */
+/** Options for getParliamentaryQuestionsFeed (fixed-window — server ignores `timeframe` as of v1.2.11) */
 export interface GetParliamentaryQuestionsFeedOptions extends FixedWindowFeedOptions {
 }
-/** Options for getCorporateBodiesFeed (fixed-window — server ignores `timeframe` as of v1.2.10) */
+/** Options for getCorporateBodiesFeed (fixed-window — server ignores `timeframe` as of v1.2.11) */
 export interface GetCorporateBodiesFeedOptions extends FixedWindowFeedOptions {
 }
-/** Options for getControlledVocabulariesFeed (fixed-window — server ignores `timeframe` as of v1.2.10) */
+/** Options for getControlledVocabulariesFeed (fixed-window — server ignores `timeframe` as of v1.2.11) */
 export interface GetControlledVocabulariesFeedOptions extends FixedWindowFeedOptions {
 }
 /** Options for getProcedureEventById */