euparliamentmonitor 0.8.4

package/scripts/generators/committee-helpers.js

@@ -0,0 +1,154 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/** Featured committees to include in committee reports */
+export const FEATURED_COMMITTEES = ['ENVI', 'ECON', 'AFET', 'LIBE', 'AGRI'];
+/** Sentinel value used when no real chair data is available from MCP */
+export const PLACEHOLDER_CHAIR = 'N/A';
+/** Sentinel value used when no real member count data is available from MCP */
+export const PLACEHOLDER_MEMBERS = 0;
+/**
+ * Resolve a raw memberCount/members field to a numeric count.
+ * Handles arrays (EP API returns members as array), numbers, and numeric strings.
+ *
+ * @param memberCountRaw - Raw value from MCP response
+ * @returns Numeric member count, or 0 if not resolvable
+ */
+function resolveMemberCount(memberCountRaw) {
+    if (Array.isArray(memberCountRaw)) {
+        return memberCountRaw.length;
+    }
+    if (typeof memberCountRaw === 'number' && Number.isFinite(memberCountRaw)) {
+        return memberCountRaw;
+    }
+    if (typeof memberCountRaw === 'string') {
+        const parsedNumber = Number(memberCountRaw);
+        if (Number.isFinite(parsedNumber)) {
+            return parsedNumber;
+        }
+    }
+    return 0;
+}
+/**
+ * Extract the committee info record from a parsed MCP response.
+ * Supports both the wrapped `{ committee: {...} }` format and the flat
+ * EP Open Data Portal format `{ name, chair, ... }`.
+ *
+ * @param parsed - Parsed JSON object from MCP response
+ * @returns The info record, or null when the payload is unrecognised
+ */
+function extractCommitteeInfoRecord(parsed) {
+    const hasWrapped = typeof parsed.committee === 'object' && parsed.committee !== null;
+    const info = (hasWrapped ? parsed.committee : parsed);
+    if (!info || typeof info !== 'object')
+        return null;
+    // For flat format, require at least a name/abbreviation to confirm real data
+    if (!hasWrapped && !info.name && !info.abbreviation)
+        return null;
+    return info;
+}
+/**
+ * Apply committee info from MCP result to the data object
+ *
+ * @param result - MCP tool result
+ * @param data - Committee data to populate
+ * @param abbreviation - Fallback abbreviation
+ */
+export function applyCommitteeInfo(result, data, abbreviation) {
+    try {
+        if (!result?.content?.[0])
+            return;
+        const parsed = JSON.parse(result.content[0].text);
+        const info = extractCommitteeInfoRecord(parsed);
+        if (!info)
+            return;
+        data.name = info.name ?? data.name;
+        data.abbreviation =
+            typeof info.abbreviation === 'string' && !info.abbreviation.startsWith('org/')
+                ? info.abbreviation
+                : abbreviation;
+        data.chair = info.chair && info.chair.length > 0 ? info.chair : PLACEHOLDER_CHAIR;
+        data.members = resolveMemberCount(info.memberCount ?? info.members);
+        console.log(`  ✅ Committee info: ${data.name} (${data.members} members)`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn('  ⚠️ Failed to parse committee info:', message);
+    }
+}
+/**
+ * Apply documents from MCP result to the data object
+ *
+ * @param result - MCP tool result
+ * @param data - Committee data to populate
+ */
+export function applyDocuments(result, data) {
+    try {
+        if (!result?.content?.[0])
+            return;
+        const parsed = JSON.parse(result.content[0].text);
+        // Support both { documents: [...] } and { data: [...] } response formats
+        const docs = parsed.documents ?? parsed.data;
+        if (!docs || docs.length === 0)
+            return;
+        data.documents = docs.map((d) => ({
+            title: d.title ?? 'Untitled Document',
+            type: d.type ?? d.documentType ?? 'Document',
+            date: d.date ?? '',
+        }));
+        console.log(`  ✅ Fetched ${data.documents.length} documents from MCP`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn('  ⚠️ Failed to parse documents:', message);
+    }
+}
+/**
+ * Detect whether a list of committee data entries are all fallback/default placeholders.
+ *
+ * A committee entry is considered a placeholder when the MCP fetch produced no real
+ * data — i.e. `chair` is still the sentinel `'N/A'`, `members` is 0, and the
+ * `documents` list is empty. This typically happens when the MCP server is
+ * unavailable and `fetchCommitteeData` returns the `defaultResult` unchanged.
+ *
+ * Returns `true` only when:
+ * - the list is non-empty **and**
+ * - every committee entry matches all three placeholder criteria.
+ *
+ * An empty list returns `false` so that a genuine zero-committee scenario is still
+ * rendered (the caller can decide how to handle it).
+ *
+ * @param committees - Committee data entries to inspect
+ * @returns `true` when all entries are default/placeholder data; `false` otherwise
+ */
+export function isPlaceholderCommitteeData(committees) {
+    return (committees.length > 0 &&
+        committees.every((c) => c.chair === PLACEHOLDER_CHAIR &&
+            c.members === PLACEHOLDER_MEMBERS &&
+            c.documents.length === 0));
+}
+/**
+ * Apply effectiveness metrics from MCP result to the data object
+ *
+ * @param result - MCP tool result
+ * @param data - Committee data to populate
+ */
+export function applyEffectiveness(result, data) {
+    try {
+        if (!result?.content?.[0])
+            return;
+        const parsed = JSON.parse(result.content[0].text);
+        if (!parsed.effectiveness)
+            return;
+        const score = parsed.effectiveness.overallScore;
+        const rank = parsed.effectiveness.rank ?? '';
+        data.effectiveness =
+            typeof score === 'number' && Number.isFinite(score)
+                ? `Score: ${score.toFixed(1)} ${rank}`.trim()
+                : null;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn('  ⚠️ Failed to parse effectiveness:', message);
+    }
+}
+//# sourceMappingURL=committee-helpers.js.map

package/scripts/generators/committee-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"committee-helpers.js","sourceRoot":"","sources":["../../src/generators/committee-helpers.ts"],"names":[],"mappings":"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"}

package/scripts/generators/dashboard-content.d.ts

@@ -0,0 +1,95 @@
+import type { DashboardConfig, DashboardPanel, CoalitionMetrics, LegislativePipeline, TrendAnalytics, StakeholderMetric, EconomicContext } from '../types/index.js';
+/**
+ * Build a coalition dynamics panel as a self-contained HTML section.
+ * Renders a radar chart configuration (Chart.js) embedded as a data attribute,
+ * with a `<noscript>` fallback table listing each bloc's alignment score.
+ *
+ * Returns an empty string when `coalition` is null/undefined or has no voting
+ * blocs.
+ *
+ * @param coalition - Coalition metrics data
+ * @param panelIndex - Index used for unique canvas IDs
+ * @param lang - BCP 47 language code for localized labels
+ * @returns HTML string for the coalition panel or empty string
+ */
+export declare function buildCoalitionPanel(coalition: CoalitionMetrics | null | undefined, panelIndex: number, lang?: string): string;
+/**
+ * Build a legislative pipeline status panel as a self-contained HTML section.
+ * Renders a horizontal bar chart (Chart.js) for on-track / delayed / blocked /
+ * fast-tracked counts with color-coded status classes and a `<noscript>`
+ * fallback list.
+ *
+ * Returns an empty string when `pipeline` is null/undefined or has zero total
+ * procedures.
+ *
+ * @param pipeline - Legislative pipeline data
+ * @param panelIndex - Index used for unique canvas IDs
+ * @param lang - BCP 47 language code for localized labels
+ * @returns HTML string for the pipeline panel or empty string
+ */
+export declare function buildPipelinePanel(pipeline: LegislativePipeline | null | undefined, panelIndex: number, lang?: string): string;
+/**
+ * Build a trend analytics panel as a self-contained HTML section.
+ * Renders a line (sparkline) chart (Chart.js) for activity levels over time
+ * with week-over-week / month-over-month change indicators and a `<noscript>`
+ * comparison table.
+ *
+ * Returns an empty string when `trend` is null/undefined or has no metric
+ * data points.
+ *
+ * @param trend - Trend analytics data
+ * @param panelIndex - Index used for unique canvas IDs
+ * @param lang - BCP 47 language code for localized labels
+ * @returns HTML string for the trend panel or empty string
+ */
+export declare function buildTrendPanel(trend: TrendAnalytics | null | undefined, panelIndex: number, lang?: string): string;
+/**
+ * Build a stakeholder impact scorecard panel as a self-contained HTML section.
+ * Renders a color-coded grid where each cell shows a stakeholder's impact score
+ * and direction, with a `<noscript>` fallback table.
+ *
+ * Returns an empty string when `stakeholders` is null/undefined or empty.
+ *
+ * @param stakeholders - Stakeholder metric data
+ * @param panelIndex - Index used for unique IDs
+ * @param lang - BCP 47 language code for localized labels
+ * @returns HTML string for the scorecard panel or empty string
+ */
+export declare function buildStakeholderScorecardPanel(stakeholders: readonly StakeholderMetric[] | null | undefined, panelIndex: number, lang?: string): string;
+/**
+ * Build a complete dashboard section HTML.
+ *
+ * Generates an accessible dashboard with metric cards and chart containers.
+ * Charts are embedded as Canvas elements with `data-chart-config` JSON
+ * attributes for client-side Chart.js hydration. A `<noscript>` fallback
+ * provides accessible data tables when JavaScript is disabled.
+ *
+ * Returns an empty string if the config is null/undefined or contains
+ * no panels with content.
+ *
+ * @param config - Dashboard configuration (null/undefined returns empty string)
+ * @param lang - BCP 47 language code for localized UI text (defaults to "en")
+ * @param heading - Optional custom section heading override
+ * @returns HTML section string or empty string
+ */
+export declare function buildDashboardSection(config: DashboardConfig | null | undefined, lang?: string, heading?: string): string;
+/**
+ * Check whether a dashboard configuration contains any chart containers.
+ * Useful for conditionally including Chart.js client-side scripts.
+ *
+ * @param config - Dashboard configuration
+ * @returns True if at least one panel has a chart
+ */
+export declare function dashboardHasCharts(config: DashboardConfig | null | undefined): boolean;
+/**
+ * Build a dashboard panel from World Bank economic context data.
+ *
+ * Generates a bar chart showing key economic indicators for a country
+ * alongside metric cards for each indicator, enriching articles with
+ * macroeconomic context relevant to EU Parliament policy analysis.
+ *
+ * @param context - Economic context data from World Bank MCP
+ * @returns Dashboard panel configuration or null if data is insufficient
+ */
+export declare function buildEconomicContextPanel(context: EconomicContext | null | undefined): DashboardPanel | null;
+//# sourceMappingURL=dashboard-content.d.ts.map

package/scripts/generators/dashboard-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-content.d.ts","sourceRoot":"","sources":["../../src/generators/dashboard-content.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAId,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAmN3B;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC9C,UAAU,EAAE,MAAM,EAClB,IAAI,SAAO,GACV,MAAM,CAqER;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAChD,UAAU,EAAE,MAAM,EAClB,IAAI,SAAO,GACV,MAAM,CAgER;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EACxC,UAAU,EAAE,MAAM,EAClB,IAAI,SAAO,GACV,MAAM,CAgFR;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,EAC7D,UAAU,EAAE,MAAM,EAClB,IAAI,SAAO,GACV,MAAM,CAmDR;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC1C,IAAI,GAAE,MAAa,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAqBR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAC1C,cAAc,GAAG,IAAI,CA8CvB"}