euparliamentmonitor 0.8.19 → 0.8.21

package/scripts/generators/pipeline/analysis-threats.d.ts

@@ -0,0 +1,41 @@
+import type { MarkdownBuilder } from './analysis-helpers.js';
+import type { AnalysisMethod } from './analysis-stage.js';
+/**
+ * Build markdown for the political threat landscape assessment.
+ *
+ * Uses the pipeline `date` parameter to ensure the assessment date in the
+ * generated markdown matches the `analysis/daily/{date}/` folder, overriding
+ * the `new Date()` timestamp that `assessPoliticalThreats()` stamps internally.
+ *
+ * @param fetchedData - Raw fetched EP data
+ * @param date - Analysis date (used to override assessment date for consistency)
+ * @returns Markdown content string
+ */
+export declare function buildThreatLandscapeMarkdown(fetchedData: Record<string, unknown>, date: string): string;
+/**
+ * Build markdown for actor threat profiling.
+ *
+ * @param fetchedData - Raw fetched EP data
+ * @param date - Analysis date
+ * @returns Markdown content string
+ */
+export declare function buildActorThreatProfilingMarkdown(fetchedData: Record<string, unknown>, date: string): string;
+/**
+ * Build markdown for consequence tree analysis.
+ *
+ * @param fetchedData - Raw fetched EP data
+ * @param date - Analysis date
+ * @returns Markdown content string
+ */
+export declare function buildConsequenceTreesMarkdown(fetchedData: Record<string, unknown>, date: string): string;
+/**
+ * Build markdown for legislative disruption analysis.
+ *
+ * @param fetchedData - Raw fetched EP data
+ * @param date - Analysis date
+ * @returns Markdown content string
+ */
+export declare function buildLegislativeDisruptionMarkdown(fetchedData: Record<string, unknown>, date: string): string;
+/** All threat assessment method builders keyed by their AnalysisMethod identifier */
+export declare const THREAT_BUILDERS: Readonly<Partial<Record<AnalysisMethod, MarkdownBuilder>>>;
+//# sourceMappingURL=analysis-threats.d.ts.map

package/scripts/generators/pipeline/analysis-threats.js

@@ -0,0 +1,142 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Generators/Pipeline/AnalysisThreats
+ * @description Threat assessment analysis method builders for the analysis pipeline.
+ *
+ * Contains markdown builders for the **Threat Assessment** analysis method group:
+ * - `political-threat-landscape` — overall political threat assessment
+ * - `actor-threat-profiling` — individual actor threat profiles
+ * - `consequence-trees` — action-consequence chain analysis
+ * - `legislative-disruption` — legislative process disruption identification
+ */
+import { assessPoliticalThreats, buildActorThreatProfiles, buildConsequenceTree, analyzeLegislativeDisruption, generateThreatAssessmentMarkdown, } from '../../utils/political-threat-assessment.js';
+import { sanitizeCell, safeArr, toThreatInput, buildMarkdownHeader, EMPTY_TABLE_ROW_6, } from './analysis-helpers.js';
+// ─── Per-method markdown builders ────────────────────────────────────────────
+/**
+ * Build markdown for the political threat landscape assessment.
+ *
+ * Uses the pipeline `date` parameter to ensure the assessment date in the
+ * generated markdown matches the `analysis/daily/{date}/` folder, overriding
+ * the `new Date()` timestamp that `assessPoliticalThreats()` stamps internally.
+ *
+ * @param fetchedData - Raw fetched EP data
+ * @param date - Analysis date (used to override assessment date for consistency)
+ * @returns Markdown content string
+ */
+export function buildThreatLandscapeMarkdown(fetchedData, date) {
+    const input = toThreatInput(fetchedData);
+    const assessment = assessPoliticalThreats(input);
+    return generateThreatAssessmentMarkdown({ ...assessment, date });
+}
+/**
+ * Build markdown for actor threat profiling.
+ *
+ * @param fetchedData - Raw fetched EP data
+ * @param date - Analysis date
+ * @returns Markdown content string
+ */
+export function buildActorThreatProfilingMarkdown(fetchedData, date) {
+    const input = toThreatInput(fetchedData);
+    const profiles = buildActorThreatProfiles(input);
+    const header = buildMarkdownHeader('actor-threat-profiling', date, profiles.length > 0 ? 'medium' : 'low');
+    const profileRows = profiles.length > 0
+        ? profiles
+            .map((p) => `| ${sanitizeCell(p.actor)} | ${sanitizeCell(p.actorType)} | ${sanitizeCell(p.capability)} | ${sanitizeCell(p.motivation)} | ${sanitizeCell(p.opportunity)} | ${sanitizeCell(p.overallThreatLevel)} |`)
+            .join('\n')
+        : EMPTY_TABLE_ROW_6;
+    return (header +
+        `# Actor Threat Profiles
+
+## Overview
+Individual threat profiles for ${profiles.length} political actors.
+
+## Actor Threat Matrix
+| Actor | Type | Capability | Motivation | Opportunity | Threat Level |
+|-------|------|------------|------------|-------------|--------------|
+${profileRows}
+
+## Date: ${date}
+`);
+}
+/**
+ * Build markdown for consequence tree analysis.
+ *
+ * @param fetchedData - Raw fetched EP data
+ * @param date - Analysis date
+ * @returns Markdown content string
+ */
+export function buildConsequenceTreesMarkdown(fetchedData, date) {
+    const input = toThreatInput(fetchedData);
+    const procedures = safeArr(fetchedData, 'procedures');
+    const header = buildMarkdownHeader('consequence-trees', date, 'medium');
+    const trees = [];
+    for (const raw of procedures.slice(0, 5)) {
+        const proc = raw && typeof raw === 'object' ? raw : null;
+        const rawTitle = proc ? String(proc['title'] ?? '') : '';
+        if (!rawTitle)
+            continue;
+        const title = sanitizeCell(rawTitle);
+        const tree = buildConsequenceTree(rawTitle, input);
+        trees.push(`### ${title}\n` +
+            `- **Immediate**: ${tree.immediateConsequences.map((c) => sanitizeCell(c.description)).join('; ') || 'No immediate consequences identified'}\n` +
+            `- **Secondary**: ${tree.secondaryEffects.map((c) => sanitizeCell(c.description)).join('; ') || 'No secondary effects identified'}\n` +
+            `- **Long-term**: ${tree.longTermImplications.map((c) => sanitizeCell(c.description)).join('; ') || 'No long-term implications identified'}\n` +
+            `- **Mitigating factors**: ${tree.mitigatingFactors.map((f) => sanitizeCell(f)).join(', ') || '—'}\n` +
+            `- **Amplifying factors**: ${tree.amplifyingFactors.map((f) => sanitizeCell(f)).join(', ') || '—'}`);
+    }
+    return (header +
+        `# Consequence Tree Analysis
+
+## Overview
+Structured analysis of action-consequence chains for ${Math.min(procedures.length, 5)} legislative procedures.
+
+${trees.length > 0 ? trees.join('\n\n') : '## No procedures available for consequence analysis'}
+
+## Date: ${date}
+`);
+}
+/**
+ * Build markdown for legislative disruption analysis.
+ *
+ * @param fetchedData - Raw fetched EP data
+ * @param date - Analysis date
+ * @returns Markdown content string
+ */
+export function buildLegislativeDisruptionMarkdown(fetchedData, date) {
+    const input = toThreatInput(fetchedData);
+    const procedures = safeArr(fetchedData, 'procedures');
+    const header = buildMarkdownHeader('legislative-disruption', date, 'medium');
+    const disruptions = [];
+    for (const raw of procedures.slice(0, 5)) {
+        const proc = raw && typeof raw === 'object' ? raw : null;
+        const id = proc ? String(proc['procedureId'] ?? proc['id'] ?? '') : '';
+        const title = proc ? String(proc['title'] ?? '') : '';
+        if (!id || !title)
+            continue;
+        const analysis = analyzeLegislativeDisruption(id, input);
+        const disruptionCount = analysis.disruptionPoints.length;
+        disruptions.push(`| ${sanitizeCell(id)} | ${sanitizeCell(title.slice(0, 50))} | ${sanitizeCell(analysis.currentStage)} | ${sanitizeCell(analysis.resilience)} | ${disruptionCount} |`);
+    }
+    return (header +
+        `# Legislative Disruption Analysis
+
+## Overview
+Identification of factors disrupting the normal legislative process.
+
+## Disruption Assessment
+| Procedure ID | Title | Stage | Resilience | Disruption Points |
+|-------------|-------|-------|-----------|-------------------|
+${disruptions.length > 0 ? disruptions.join('\n') : '| — | — | — | — | — |'}
+
+## Date: ${date}
+`);
+}
+/** All threat assessment method builders keyed by their AnalysisMethod identifier */
+export const THREAT_BUILDERS = {
+    'political-threat-landscape': buildThreatLandscapeMarkdown,
+    'actor-threat-profiling': buildActorThreatProfilingMarkdown,
+    'consequence-trees': buildConsequenceTreesMarkdown,
+    'legislative-disruption': buildLegislativeDisruptionMarkdown,
+};
+//# sourceMappingURL=analysis-threats.js.map

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

@@ -217,25 +217,29 @@ export declare function fetchPipelineFromMCP(client: EuropeanParliamentMCPClient
 export declare function fetchProcedureStatusFromMCP(client: EuropeanParliamentMCPClient | null, procedureId: string): Promise<string>;
 /**
  * Fetch adopted texts feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of adopted text feed items
  */
 export declare function fetchAdoptedTextsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<AdoptedTextFeedItem[]>;
 /**
  * Fetch events feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data
+ * (common during parliamentary recess when the EP API returns 404 for narrow windows).
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of event feed items
  */
 export declare function fetchEventsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<EventFeedItem[]>;
 /**
  * Fetch procedures feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of procedure feed items
  */
 export declare function fetchProceduresFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<ProcedureFeedItem[]>;
@@ -243,7 +247,7 @@ export declare function fetchProceduresFeed(client: EuropeanParliamentMCPClient
  * Fetch MEPs feed from MCP.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of MEP feed items
  */
 export declare function fetchMEPsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<MEPFeedItem[]>;
@@ -258,7 +262,7 @@ export declare function fetchMEPsFeed(client: EuropeanParliamentMCPClient | null
  * updates, the `total` field in the API response carries the true count.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Object with `items` array and `total` count from the API
  */
 export declare function fetchMEPsFeedWithTotal(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<{
@@ -267,49 +271,55 @@ export declare function fetchMEPsFeedWithTotal(client: EuropeanParliamentMCPClie
 }>;
 /**
  * Fetch documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of document feed items
  */
 export declare function fetchDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch plenary documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of document feed items
  */
 export declare function fetchPlenaryDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch committee documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of document feed items
  */
 export declare function fetchCommitteeDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch plenary session documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of document feed items
  */
 export declare function fetchPlenarySessionDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch external documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of document feed items
  */
 export declare function fetchExternalDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch parliamentary questions feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of question feed items
  */
 export declare function fetchQuestionsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<QuestionFeedItem[]>;
@@ -317,7 +327,7 @@ export declare function fetchQuestionsFeed(client: EuropeanParliamentMCPClient |
  * Fetch MEP declarations feed from MCP.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of declaration feed items
  */
 export declare function fetchDeclarationsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DeclarationFeedItem[]>;
@@ -325,7 +335,7 @@ export declare function fetchDeclarationsFeed(client: EuropeanParliamentMCPClien
  * Fetch corporate bodies feed from MCP.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Array of corporate body feed items
  */
 export declare function fetchCorporateBodiesFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<CorporateBodyFeedItem[]>;
@@ -335,7 +345,7 @@ export declare function fetchCorporateBodiesFeed(client: EuropeanParliamentMCPCl
  * Returns `undefined` when client is null (MCP unavailable).
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @returns Aggregated feed data for breaking news, or undefined when client is null
  */
 export declare function fetchBreakingNewsFeedData(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<BreakingNewsFeedData | undefined>;
@@ -344,7 +354,7 @@ export declare function fetchBreakingNewsFeedData(client: EuropeanParliamentMCPC
  * This is the primary data source for all article strategies.
  *
  * @param client - MCP client or null
- * @param timeframe - How far back to look (default: 'one-day')
+ * @param timeframe - How far back to look (default: 'one-week')
  * @param dateRange - Optional inclusive UTC window for filtering feed items
  * @returns Full EPFeedData or undefined when client is null
  */