euparliamentmonitor 0.8.31 → 0.8.33

package/README.md

@@ -124,7 +124,7 @@ import {
 
 **MCP Server Integration**: The project uses the
 [European-Parliament-MCP-Server](https://github.com/Hack23/European-Parliament-MCP-Server)
-v1.2.7 for accessing real EU Parliament data via the Model Context Protocol.
+v1.2.8 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)
@@ -984,7 +984,7 @@ Projected workflow counts below include all CI/CD workflow definitions, agentic
 
 | Year | Projected Workflow Definitions | AI Model | Key Capability |
 |------|-------------------------------|----------|----------------|
-| **2026** | 44–50 | Opus 4.6–4.9 | 🟢 Agentic news generation |
+| **2026** | 44–50 | Opus 4.7–4.9 | 🟢 Agentic news generation |
 | **2027** | 50–55 | Opus 5.x | 🔵 Predictive analytics |
 | **2028** | 55–65 | Opus 6.x | 🟣 Multi-modal content |
 | **2029** | 65–75 | Opus 7.x | 🟠 Autonomous pipeline |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.31",
+  "version": "0.8.33",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -152,7 +152,7 @@
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-jsdoc": "62.9.0",
     "eslint-plugin-security": "4.0.0",
-    "eslint-plugin-sonarjs": "4.0.2",
+    "eslint-plugin-sonarjs": "4.0.3",
     "happy-dom": "20.9.0",
     "htmlhint": "1.9.2",
     "husky": "9.1.7",
@@ -170,7 +170,7 @@
     "node": ">=25"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.2.7"
+    "european-parliament-mcp-server": "1.2.8"
   },
   "optionalDependencies": {
     "worldbank-mcp": "1.0.1"

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

@@ -15,7 +15,7 @@
  * Any narrative or interpretive analysis text (for example: why, outlook,
  * impact assessments, stakeholder reasoning, or mistake/consequence
  * explanations) that is LEFT AS THIS MARKER is expected to be generated by
- * the AI agent (Opus 4.6) in the agentic workflow, not by code.
+ * the AI agent in the agentic workflow, not by code.
  */
 export declare const AI_MARKER = "[AI_ANALYSIS_REQUIRED]";
 /**

package/scripts/constants/analysis-constants.js

@@ -17,7 +17,7 @@
  * Any narrative or interpretive analysis text (for example: why, outlook,
  * impact assessments, stakeholder reasoning, or mistake/consequence
  * explanations) that is LEFT AS THIS MARKER is expected to be generated by
- * the AI agent (Opus 4.6) in the agentic workflow, not by code.
+ * the AI agent in the agentic workflow, not by code.
  */
 export const AI_MARKER = '[AI_ANALYSIS_REQUIRED]';
 /**

package/scripts/constants/language-articles.js

@@ -3140,7 +3140,7 @@ export const WEEK_AHEAD_STAKEHOLDER_STRINGS = {
         reasonInstitutionsCoordination: '需要机构间协调',
     },
 };
-// ─── AI analysis marker — all analysis text is produced by the AI agent (Opus 4.6) ───
+// ─── AI analysis marker — all analysis text is produced by the AI agent ───
 const AI_ANALYSIS_MARKER = '[AI_ANALYSIS_REQUIRED]';
 const BRK_WHY_ANOMALIES = AI_ANALYSIS_MARKER;
 const BRK_WHY_NORMAL = AI_ANALYSIS_MARKER;

package/scripts/generators/news-enhanced.d.ts

@@ -26,13 +26,13 @@ export declare const runId: string;
 /**
  * AI-generated article title passed by the agentic workflow.
  * When provided, this OVERRIDES any script-generated title.
- * The AI agent (Opus 4.6) must analyse the content and produce this.
+ * The AI agent must analyse the content and produce this.
  */
 export declare const aiTitle: string;
 /**
  * AI-generated article description/subtitle passed by the agentic workflow.
  * When provided, this OVERRIDES any script-generated description.
- * The AI agent (Opus 4.6) must analyse the content and produce this.
+ * The AI agent must analyse the content and produce this.
  */
 export declare const aiDescription: string;
 /**

package/scripts/generators/news-enhanced.js

@@ -96,13 +96,13 @@ export const runId = (runIdArg?.slice('--run-id='.length).trim() ||
 /**
  * AI-generated article title passed by the agentic workflow.
  * When provided, this OVERRIDES any script-generated title.
- * The AI agent (Opus 4.6) must analyse the content and produce this.
+ * The AI agent must analyse the content and produce this.
  */
 export const aiTitle = titleArg ? titleArg.slice('--title='.length).trim() : '';
 /**
  * AI-generated article description/subtitle passed by the agentic workflow.
  * When provided, this OVERRIDES any script-generated description.
- * The AI agent (Opus 4.6) must analyse the content and produce this.
+ * The AI agent must analyse the content and produce this.
  */
 export const aiDescription = descriptionArg
     ? descriptionArg.slice('--description='.length).trim()
@@ -378,7 +378,7 @@ async function runAnalysisWithGuard(date, client) {
 }
 /**
  * Wire AI-provided title/description from CLI `--title` and `--description` flags.
- * The AI agent (Opus 4.6) passes these after analysing the content.
+ * The AI agent passes these after analysing the content.
  * They override ALL script-generated metadata for the English version.
  */
 function wireAIMetadata() {

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

@@ -437,7 +437,7 @@ export async function fetchWeekAheadData(client, dateRange) {
             limit: 20,
         }),
         client.getParliamentaryQuestions({ dateFrom: dateRange.start, limit: 20 }),
-        client.getEvents({ dateFrom: dateRange.start, dateTo: dateRange.end, limit: 20 }),
+        client.getEvents({ limit: 20 }),
     ]);
     const allFailed = [
         plenarySessions,

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

@@ -19,7 +19,7 @@ import { writeSingleArticle } from './output-stage.js';
 /**
  * AI-generated article title provided by the agentic workflow.
  * When non-empty, this OVERRIDES any script-generated title for the
- * English version.  The AI agent (Opus 4.6) must analyse the article
+ * English version.  The AI agent must analyse the article
  * content and produce this — titles must NEVER be generated by code.
  */
 let _aiTitle = '';
@@ -130,7 +130,7 @@ function generateSingleLanguageArticle(strategy, data, lang, dateStr, slug, outp
     // preserved, but title and description enrichment is now subordinate
     // to AI-provided values from --title and --description CLI flags.
     //
-    // Architecture: The AI agent (Opus 4.6) analyses the content and
+    // Architecture: The AI agent analyses the content and
     // provides titles/descriptions via CLI flags. Script code NEVER
     // generates final titles or descriptions — it only provides fallbacks.
     const enrichedMetadata = enrichMetadataFromContent(content, baseMetadata);

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

@@ -77,7 +77,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Search legislative documents
      *
-     * @param options - Search options using v1.2.7 parameters: keyword, documentType, docId, etc.
+     * @param options - Search options using v1.2.8 parameters: keyword, documentType, docId, etc.
      * @returns Search results
      */
     searchDocuments(options?: SearchDocumentsOptions): Promise<MCPToolResult>;
@@ -210,14 +210,14 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get plenary speeches and debate contributions
      *
-     * @param options - Filter options including optional speechId or date range
+     * @param options - Filter options including optional speechId, dateFrom/dateTo (v1.2.8: year removed)
      * @returns Speeches data
      */
     getSpeeches(options?: GetSpeechesOptions): Promise<MCPToolResult>;
     /**
      * Get legislative procedures
      *
-     * @param options - Filter options including optional processId or year
+     * @param options - Filter options including optional processId (v1.2.8: year removed)
      * @returns Procedures data
      */
     getProcedures(options?: GetProceduresOptions): Promise<MCPToolResult>;
@@ -231,7 +231,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get European Parliament events (hearings, conferences, seminars)
      *
-     * @param options - Filter options including optional eventId or date range
+     * @param options - Filter options including optional eventId, pagination only (v1.2.8: year/dateFrom/dateTo removed — EP API /events has no date filtering)
      * @returns Events data
      */
     getEvents(options?: GetEventsOptions): Promise<MCPToolResult>;
@@ -287,7 +287,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get committee documents
      *
-     * @param options - Filter options including optional docId or year
+     * @param options - Filter options including optional docId (v1.2.8: year removed)
      * @returns Committee documents data
      */
     getCommitteeDocuments(options?: GetCommitteeDocumentsOptions): Promise<MCPToolResult>;
@@ -315,7 +315,7 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get external documents (non-EP documents such as Council positions)
      *
-     * @param options - Filter options including optional docId or year
+     * @param options - Filter options including optional docId (v1.2.8: year removed)
      * @returns External documents data
      */
     getExternalDocuments(options?: GetExternalDocumentsOptions): Promise<MCPToolResult>;

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

@@ -29,7 +29,7 @@ const SERVER_HEALTH_FALLBACK = '{"server": null, "feeds": []}';
 /**
  * Classify an error message into a diagnostic error category.
  *
- * Maps EP MCP Server v1.2.7 structured error codes and generic HTTP/network
+ * Maps EP MCP Server v1.2.8 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 +45,7 @@ const SERVER_HEALTH_FALLBACK = '{"server": null, "feeds": []}';
  */
 function classifyToolError(message) {
     const lowerMsg = message.toLowerCase();
-    // EP MCP Server v1.2.7 structured error codes (matched case-insensitively)
+    // EP MCP Server v1.2.8 structured error codes (matched case-insensitively)
     if (lowerMsg.includes('internal_error')) {
         return 'INTERNAL_ERROR';
     }
@@ -214,7 +214,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Search legislative documents
      *
-     * @param options - Search options using v1.2.7 parameters: keyword, documentType, docId, etc.
+     * @param options - Search options using v1.2.8 parameters: keyword, documentType, docId, etc.
      * @returns Search results
      */
     async searchDocuments(options = {}) {
@@ -423,7 +423,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get plenary speeches and debate contributions
      *
-     * @param options - Filter options including optional speechId or date range
+     * @param options - Filter options including optional speechId, dateFrom/dateTo (v1.2.8: year removed)
      * @returns Speeches data
      */
     async getSpeeches(options = {}) {
@@ -432,7 +432,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get legislative procedures
      *
-     * @param options - Filter options including optional processId or year
+     * @param options - Filter options including optional processId (v1.2.8: year removed)
      * @returns Procedures data
      */
     async getProcedures(options = {}) {
@@ -450,7 +450,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get European Parliament events (hearings, conferences, seminars)
      *
-     * @param options - Filter options including optional eventId or date range
+     * @param options - Filter options including optional eventId, pagination only (v1.2.8: year/dateFrom/dateTo removed — EP API /events has no date filtering)
      * @returns Events data
      */
     async getEvents(options = {}) {
@@ -530,7 +530,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get committee documents
      *
-     * @param options - Filter options including optional docId or year
+     * @param options - Filter options including optional docId (v1.2.8: year removed)
      * @returns Committee documents data
      */
     async getCommitteeDocuments(options = {}) {
@@ -566,7 +566,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     /**
      * Get external documents (non-EP documents such as Council positions)
      *
-     * @param options - Filter options including optional docId or year
+     * @param options - Filter options including optional docId (v1.2.8: year removed)
      * @returns External documents data
      */
     async getExternalDocuments(options = {}) {

package/scripts/types/mcp.d.ts

@@ -218,20 +218,19 @@ export interface GetCurrentMEPsOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getSpeeches */
+/** Options for getSpeeches — v1.2.8 removed `year` (EP API ignores it for /speeches) */
 export interface GetSpeechesOptions {
     speechId?: string | undefined;
-    /** Filter by calendar year (recommended for annual counts) */
-    year?: number | undefined;
+    /** Filter by sitting date start (maps to sitting-date in EP API) */
     dateFrom?: string | undefined;
+    /** Filter by sitting date end (maps to sitting-date-end in EP API) */
     dateTo?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getProcedures */
+/** Options for getProcedures — v1.2.8 removed `year` (EP API ignores it for /procedures) */
 export interface GetProceduresOptions {
     processId?: string | undefined;
-    year?: number | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }
@@ -242,13 +241,9 @@ export interface GetAdoptedTextsOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getEvents */
+/** Options for getEvents — v1.2.8 removed `year`, `dateFrom`, `dateTo` (EP API /events has no date filtering) */
 export interface GetEventsOptions {
     eventId?: string | undefined;
-    /** Filter by calendar year (recommended for annual counts) */
-    year?: number | undefined;
-    dateFrom?: string | undefined;
-    dateTo?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }
@@ -293,10 +288,9 @@ export interface GetPlenaryDocumentsOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getCommitteeDocuments */
+/** Options for getCommitteeDocuments — v1.2.8 removed `year` (EP API ignores it for /committee-documents) */
 export interface GetCommitteeDocumentsOptions {
     docId?: string | undefined;
-    year?: number | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }
@@ -317,10 +311,9 @@ export interface GetControlledVocabulariesOptions {
     limit?: number | undefined;
     offset?: number | undefined;
 }
-/** Options for getExternalDocuments */
+/** Options for getExternalDocuments — v1.2.8 removed `year` (EP API ignores it for /external-documents) */
 export interface GetExternalDocumentsOptions {
     docId?: string | undefined;
-    year?: number | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }