euparliamentmonitor 0.8.19 → 0.8.21

package/scripts/mcp/mcp-connection.js

@@ -19,8 +19,22 @@ const BINARY_NAME = 'european-parliament-mcp-server';
 const BINARY_FILE = process.platform === 'win32' ? `${BINARY_NAME}.cmd` : BINARY_NAME;
 /** Default binary resolved from node_modules/.bin relative to this file's compiled location */
 const DEFAULT_SERVER_BINARY = resolve(dirname(fileURLToPath(import.meta.url)), `../../node_modules/.bin/${BINARY_FILE}`);
-/** Request timeout in milliseconds — EU Parliament API responses commonly take 30-90+ seconds for large datasets */
-const REQUEST_TIMEOUT_MS = 180000;
+/** Default request timeout in milliseconds — EU Parliament API responses commonly take 30-120+ seconds for large datasets */
+const DEFAULT_REQUEST_TIMEOUT_MS = 180_000;
+/**
+ * Effective request timeout, configurable via `EP_REQUEST_TIMEOUT_MS` env var.
+ * This keeps the client-side timeout aligned with the MCP server timeout set
+ * in workflow configs and copilot-mcp.json.
+ */
+const REQUEST_TIMEOUT_MS = (() => {
+    const envVal = process.env['EP_REQUEST_TIMEOUT_MS'];
+    if (envVal) {
+        const parsed = Number(envVal);
+        if (!Number.isNaN(parsed) && parsed > 0)
+            return parsed;
+    }
+    return DEFAULT_REQUEST_TIMEOUT_MS;
+})();
 /** Connection startup delay in milliseconds */
 const CONNECTION_STARTUP_DELAY_MS = 500;
 /** Maximum reconnect back-off delay in milliseconds */
@@ -75,7 +89,8 @@ function parseRetryAfterMs(retryAfter) {
 }
 /**
  * Returns true only for transient, retriable failures: request timeouts,
- * network-level connection-closed/reset errors, and "not connected" states.
+ * network-level connection-closed/reset errors, "not connected" states,
+ * and transient HTTP gateway errors (502, 503, 504).
  *
  * Uses an allow-list of known transient error patterns so that unknown or
  * server-level errors (e.g., tool runtime failures) are NOT retried:
@@ -83,6 +98,7 @@ function parseRetryAfterMs(retryAfter) {
  * - connection closed / reset / refused — network-level transport failures
  * - not connected — local "not yet connected" guard error
  * - socket hang up — Node.js HTTP socket-level disconnection
+ * - gateway error 502/503/504 — transient upstream server errors
  *
  * Everything else (MCPSessionExpiredError, TypeError, rate-limit errors,
  * unknown errors) returns false so `callToolWithRetry` surfaces them immediately.
@@ -108,7 +124,11 @@ export function isRetriableError(error) {
         msg.includes('not connected') ||
         msg.includes('econnreset') ||
         msg.includes('econnrefused') ||
-        msg.includes('socket hang up'));
+        msg.includes('socket hang up') ||
+        // Transient upstream gateway errors — safe to retry with backoff
+        msg.includes('gateway error 502') ||
+        msg.includes('gateway error 503') ||
+        msg.includes('gateway error 504'));
 }
 /**
  * Parse a `Retry-After` or `X-Retry-After` header value (which may be either a
@@ -462,8 +482,16 @@ export class MCPConnection {
             const isJavaScriptFile = this.serverPath.toLowerCase().endsWith('.js');
             const command = isJavaScriptFile ? process.execPath : this.serverPath;
             const args = isJavaScriptFile ? [this.serverPath] : [];
+            // Ensure EP_REQUEST_TIMEOUT_MS is propagated to the MCP server subprocess.
+            // The EP MCP server defaults to only 10 seconds; we need 90+ seconds for
+            // slow EP API feed endpoints (events, procedures, documents, etc.).
+            const childEnv = { ...process.env };
+            if (!childEnv['EP_REQUEST_TIMEOUT_MS']) {
+                childEnv['EP_REQUEST_TIMEOUT_MS'] = String(REQUEST_TIMEOUT_MS);
+            }
             this.process = spawn(command, args, {
                 stdio: ['pipe', 'pipe', 'pipe'],
+                env: childEnv,
             });
             let buffer = '';
             let startupError = null;
@@ -571,6 +599,9 @@ export class MCPConnection {
             const statusText = response.statusText || 'Too Many Requests';
             throw new MCPRateLimitError(0, `${RATE_LIMIT_MSG} (status ${response.status} ${statusText}; ${RETRY_AFTER_HEADER}/Retry-After header missing)`);
         }
+        // Include the status code in the error message for classification by isRetriableError()
+        // and safeCallTool(). Diagnostic logging is intentionally omitted here because
+        // callToolWithRetry may retry 502/503/504 errors, and per-retry warnings would be noisy.
         throw new Error(`Gateway error ${response.status}: ${response.statusText}`);
     }
     /**

package/scripts/templates/article-template.js

@@ -5,8 +5,9 @@
  * @description Generates HTML templates for news articles with proper structure and metadata
  */
 import { createHash } from 'crypto';
-import { ALL_LANGUAGES, LANGUAGE_FLAGS, LANGUAGE_NAMES, ARTICLE_TYPE_LABELS, READ_TIME_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, SKIP_LINK_TEXTS, SOURCES_HEADING_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, ANALYSIS_TRANSPARENCY_LABELS, ANALYSIS_SUMMARY_LABELS, METHODOLOGY_LABELS, TRANSPARENCY_DISCLOSURE_LABELS, CLASSIFICATION_ANALYSIS_LABELS, THREAT_ASSESSMENT_LABELS, RISK_SCORING_LABELS, DEEP_ANALYSIS_LABELS, VIEW_SOURCE_LABELS, OPEN_SOURCE_NOTE_LABELS, AI_ANALYSIS_GUIDE_LABELS, SWOT_FRAMEWORK_LABELS, RISK_METHODOLOGY_LABELS, THREAT_FRAMEWORK_LABELS, CLASSIFICATION_GUIDE_LABELS, STYLE_GUIDE_LABELS, SIGNIFICANCE_ASSESSMENT_LABELS, ACTOR_MAPPING_LABELS, FORCES_ANALYSIS_LABELS, IMPACT_MATRIX_LABELS, POLITICAL_THREAT_LANDSCAPE_LABELS, ACTOR_THREAT_PROFILES_LABELS, CONSEQUENCE_TREES_LABELS, LEGISLATIVE_DISRUPTION_LABELS, RISK_MATRIX_LABELS, QUANTITATIVE_SWOT_LABELS, POLITICAL_CAPITAL_RISK_LABELS, LEGISLATIVE_VELOCITY_RISK_LABELS, AGENT_RISK_WORKFLOW_LABELS, STAKEHOLDER_ANALYSIS_LABELS, COALITION_ANALYSIS_LABELS, VOTING_PATTERNS_LABELS, CROSS_SESSION_INTELLIGENCE_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
+import { ALL_LANGUAGES, LANGUAGE_FLAGS, LANGUAGE_NAMES, ARTICLE_TYPE_LABELS, READ_TIME_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, SKIP_LINK_TEXTS, SOURCES_HEADING_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, ANALYSIS_TRANSPARENCY_LABELS, ANALYSIS_SUMMARY_LABELS, METHODOLOGY_LABELS, TRANSPARENCY_DISCLOSURE_LABELS, CLASSIFICATION_ANALYSIS_LABELS, THREAT_ASSESSMENT_LABELS, RISK_SCORING_LABELS, DEEP_ANALYSIS_LABELS, VIEW_SOURCE_LABELS, OPEN_SOURCE_NOTE_LABELS, AI_ANALYSIS_GUIDE_LABELS, SWOT_FRAMEWORK_LABELS, RISK_METHODOLOGY_LABELS, THREAT_FRAMEWORK_LABELS, CLASSIFICATION_GUIDE_LABELS, STYLE_GUIDE_LABELS, SIGNIFICANCE_CLASSIFICATION_LABELS, ACTOR_MAPPING_LABELS, FORCES_ANALYSIS_LABELS, IMPACT_MATRIX_LABELS, POLITICAL_THREAT_LANDSCAPE_LABELS, ACTOR_THREAT_PROFILING_LABELS, CONSEQUENCE_TREES_LABELS, LEGISLATIVE_DISRUPTION_LABELS, RISK_MATRIX_LABELS, QUANTITATIVE_SWOT_LABELS, POLITICAL_CAPITAL_RISK_LABELS, LEGISLATIVE_VELOCITY_RISK_LABELS, AGENT_RISK_WORKFLOW_LABELS, STAKEHOLDER_IMPACT_LABELS, COALITION_DYNAMICS_LABELS, VOTING_PATTERNS_LABELS, CROSS_SESSION_INTELLIGENCE_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
 import { escapeHTML, isSafeURL } from '../utils/file-utils.js';
+import { stripHtmlTags } from '../utils/html-sanitize.js';
 import { APP_VERSION, createThemeToggleButton, THEME_TOGGLE_SCRIPT, THEME_TOGGLE_SCRIPT_CONTENT, } from '../constants/config.js';
 /** Pattern for valid article dates (YYYY-MM-DD) */
 const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/u;
@@ -16,6 +17,11 @@ const SLUG_PATTERN = /^[a-z0-9-]+$/u;
 const SRI_HASH_PATTERN = /^sha(?:256|384|512)-[A-Za-z0-9+/]+={0,2}$/u;
 /** Words per minute for read-time calculation */
 const TEMPLATE_WORDS_PER_MINUTE = 250;
+/**
+ * Base URL for the deployed site, constructed via the URL API so that CodeQL
+ * recognises it as a validated URL rather than a potential regex pattern.
+ */
+const SITE_BASE_URL = new URL('/euparliamentmonitor', 'https://hack23.github.io').href;
 /**
  * BCP47 / Open Graph locale mapping for og:locale meta tag.
  * Maps our 2-letter language codes to proper BCP47 locale strings.
@@ -116,11 +122,7 @@ export function generateArticleHTML(options) {
     const categoryLabel = categoryLabels[category] ?? category;
     const readTimeFormatter = getLocalizedString(READ_TIME_LABELS, lang);
     // Auto-compute read-time from content word count if not explicitly set
-    const contentWordCount = content
-        .replace(/<[^>]+>/gu, ' ')
-        .replace(/\s+/gu, ' ')
-        .trim()
-        .split(' ').length;
+    const contentWordCount = stripHtmlTags(content).replace(/\s+/gu, ' ').trim().split(' ').length;
     const computedReadTime = Math.max(1, Math.ceil(contentWordCount / TEMPLATE_WORDS_PER_MINUTE));
     const effectiveReadTime = readTime > 0 ? readTime : computedReadTime;
     const readTimeLabel = readTimeFormatter(effectiveReadTime);
@@ -156,12 +158,12 @@ export function generateArticleHTML(options) {
         publisher: {
             '@type': 'Organization',
             name: 'EU Parliament Monitor',
-            url: 'https://hack23.github.io/euparliamentmonitor',
+            url: SITE_BASE_URL,
         },
         keywords: keywords.join(', '),
         mainEntityOfPage: {
             '@type': 'WebPage',
-            '@id': `https://hack23.github.io/euparliamentmonitor/news/${date}-${slug}-${lang}.html`,
+            '@id': `${SITE_BASE_URL}/news/${date}-${slug}-${lang}.html`,
         },
     }, null, 4);
     // Validate and escape stylesHash — only allow valid SRI hash format
@@ -220,10 +222,10 @@ export function generateArticleHTML(options) {
   <meta property="og:type" content="article">
   <meta property="og:title" content="${safeTitle}">
   <meta property="og:description" content="${safeSubtitle}">
-  <meta property="og:url" content="https://hack23.github.io/euparliamentmonitor/news/${date}-${slug}-${lang}.html">
+  <meta property="og:url" content="${SITE_BASE_URL}/news/${date}-${slug}-${lang}.html">
   <meta property="og:site_name" content="EU Parliament Monitor">
   <meta property="og:locale" content="${OG_LOCALE_MAP[lang] ?? lang}">
-  <meta property="og:image" content="https://hack23.github.io/euparliamentmonitor/images/og-image.jpg">
+  <meta property="og:image" content="${SITE_BASE_URL}/images/og-image.jpg">
   <meta property="og:image:width" content="1200">
   <meta property="og:image:height" content="630">
   <meta property="og:image:alt" content="EU Parliament Monitor — AI-Disrupted Parliamentary Intelligence">
@@ -232,10 +234,10 @@ export function generateArticleHTML(options) {
   <meta name="twitter:card" content="summary_large_image">
   <meta name="twitter:title" content="${safeTitle}">
   <meta name="twitter:description" content="${safeSubtitle}">
-  <meta name="twitter:image" content="https://hack23.github.io/euparliamentmonitor/images/og-image.jpg">
+  <meta name="twitter:image" content="${SITE_BASE_URL}/images/og-image.jpg">
   <meta name="twitter:image:alt" content="EU Parliament Monitor — AI-Disrupted Parliamentary Intelligence">
   
-  <link rel="canonical" href="https://hack23.github.io/euparliamentmonitor/news/${date}-${slug}-${lang}.html">
+  <link rel="canonical" href="${SITE_BASE_URL}/news/${date}-${slug}-${lang}.html">
   <link rel="stylesheet" href="../styles.css"${safeSriAttrs}>
   
   <!-- Schema.org structured data -->
@@ -415,16 +417,16 @@ function renderAnalysisTransparencySection(date, slug, lang, analysisDir) {
     const styleGuideLabel = escapeHTML(getLocalizedString(STYLE_GUIDE_LABELS, lang));
     const repoBase = 'https://github.com/Hack23/euparliamentmonitor/blob/main';
     const treeDirBase = 'https://github.com/Hack23/euparliamentmonitor/tree/main';
-    const analysisDirUrl = `${treeDirBase}/analysis/${safeDate}/${safeAnalysisDirName}`;
-    const analysisFileBase = `${repoBase}/analysis/${safeDate}/${safeAnalysisDirName}`;
+    const analysisDirUrl = `${treeDirBase}/analysis/daily/${safeDate}/${safeAnalysisDirName}`;
+    const analysisFileBase = `${repoBase}/analysis/daily/${safeDate}/${safeAnalysisDirName}`;
     const methodologyDir = `${repoBase}/analysis/methodologies`;
     // Per-file localized link labels
-    const significanceLabel = escapeHTML(getLocalizedString(SIGNIFICANCE_ASSESSMENT_LABELS, lang));
+    const significanceLabel = escapeHTML(getLocalizedString(SIGNIFICANCE_CLASSIFICATION_LABELS, lang));
     const actorMappingLabel = escapeHTML(getLocalizedString(ACTOR_MAPPING_LABELS, lang));
     const forcesLabel = escapeHTML(getLocalizedString(FORCES_ANALYSIS_LABELS, lang));
     const impactMatrixLabel = escapeHTML(getLocalizedString(IMPACT_MATRIX_LABELS, lang));
     const threatLandscapeLabel = escapeHTML(getLocalizedString(POLITICAL_THREAT_LANDSCAPE_LABELS, lang));
-    const threatProfilesLabel = escapeHTML(getLocalizedString(ACTOR_THREAT_PROFILES_LABELS, lang));
+    const actorThreatProfilingLabel = escapeHTML(getLocalizedString(ACTOR_THREAT_PROFILING_LABELS, lang));
     const consequenceLabel = escapeHTML(getLocalizedString(CONSEQUENCE_TREES_LABELS, lang));
     const disruptionLabel = escapeHTML(getLocalizedString(LEGISLATIVE_DISRUPTION_LABELS, lang));
     const riskMatrixLabel = escapeHTML(getLocalizedString(RISK_MATRIX_LABELS, lang));
@@ -433,8 +435,8 @@ function renderAnalysisTransparencySection(date, slug, lang, analysisDir) {
     const legVelocityLabel = escapeHTML(getLocalizedString(LEGISLATIVE_VELOCITY_RISK_LABELS, lang));
     const agentRiskLabel = escapeHTML(getLocalizedString(AGENT_RISK_WORKFLOW_LABELS, lang));
     const deepAnalysisFileLabel = escapeHTML(getLocalizedString(DEEP_ANALYSIS_LABELS, lang));
-    const stakeholderLabel = escapeHTML(getLocalizedString(STAKEHOLDER_ANALYSIS_LABELS, lang));
-    const coalitionLabel = escapeHTML(getLocalizedString(COALITION_ANALYSIS_LABELS, lang));
+    const stakeholderLabel = escapeHTML(getLocalizedString(STAKEHOLDER_IMPACT_LABELS, lang));
+    const coalitionLabel = escapeHTML(getLocalizedString(COALITION_DYNAMICS_LABELS, lang));
     const votingPatternsLabel = escapeHTML(getLocalizedString(VOTING_PATTERNS_LABELS, lang));
     const crossSessionLabel = escapeHTML(getLocalizedString(CROSS_SESSION_INTELLIGENCE_LABELS, lang));
     return `
@@ -449,7 +451,7 @@ function renderAnalysisTransparencySection(date, slug, lang, analysisDir) {
         </ul>
         <h3><span aria-hidden="true">🏷️</span> ${classificationLabel}</h3>
         <ul>
-          <li><a href="${analysisFileBase}/classification/significance-assessment.md" target="_blank" rel="noopener noreferrer">${significanceLabel}</a></li>
+          <li><a href="${analysisFileBase}/classification/significance-classification.md" target="_blank" rel="noopener noreferrer">${significanceLabel}</a></li>
           <li><a href="${analysisFileBase}/classification/actor-mapping.md" target="_blank" rel="noopener noreferrer">${actorMappingLabel}</a></li>
           <li><a href="${analysisFileBase}/classification/forces-analysis.md" target="_blank" rel="noopener noreferrer">${forcesLabel}</a></li>
           <li><a href="${analysisFileBase}/classification/impact-matrix.md" target="_blank" rel="noopener noreferrer">${impactMatrixLabel}</a></li>
@@ -457,7 +459,7 @@ function renderAnalysisTransparencySection(date, slug, lang, analysisDir) {
         <h3><span aria-hidden="true">🛡️</span> ${threatLabel}</h3>
         <ul>
           <li><a href="${analysisFileBase}/threat-assessment/political-threat-landscape.md" target="_blank" rel="noopener noreferrer">${threatLandscapeLabel}</a></li>
-          <li><a href="${analysisFileBase}/threat-assessment/actor-threat-profiles.md" target="_blank" rel="noopener noreferrer">${threatProfilesLabel}</a></li>
+          <li><a href="${analysisFileBase}/threat-assessment/actor-threat-profiling.md" target="_blank" rel="noopener noreferrer">${actorThreatProfilingLabel}</a></li>
           <li><a href="${analysisFileBase}/threat-assessment/consequence-trees.md" target="_blank" rel="noopener noreferrer">${consequenceLabel}</a></li>
           <li><a href="${analysisFileBase}/threat-assessment/legislative-disruption.md" target="_blank" rel="noopener noreferrer">${disruptionLabel}</a></li>
         </ul>
@@ -472,8 +474,8 @@ function renderAnalysisTransparencySection(date, slug, lang, analysisDir) {
         <h3><span aria-hidden="true">🔍</span> ${deepLabel}</h3>
         <ul>
           <li><a href="${analysisFileBase}/existing/deep-analysis.md" target="_blank" rel="noopener noreferrer">${deepAnalysisFileLabel}</a></li>
-          <li><a href="${analysisFileBase}/existing/stakeholder-analysis.md" target="_blank" rel="noopener noreferrer">${stakeholderLabel}</a></li>
-          <li><a href="${analysisFileBase}/existing/coalition-analysis.md" target="_blank" rel="noopener noreferrer">${coalitionLabel}</a></li>
+          <li><a href="${analysisFileBase}/existing/stakeholder-impact.md" target="_blank" rel="noopener noreferrer">${stakeholderLabel}</a></li>
+          <li><a href="${analysisFileBase}/existing/coalition-dynamics.md" target="_blank" rel="noopener noreferrer">${coalitionLabel}</a></li>
           <li><a href="${analysisFileBase}/existing/voting-patterns.md" target="_blank" rel="noopener noreferrer">${votingPatternsLabel}</a></li>
           <li><a href="${analysisFileBase}/existing/cross-session-intelligence.md" target="_blank" rel="noopener noreferrer">${crossSessionLabel}</a></li>
         </ul>

package/scripts/templates/section-builders.js

@@ -7,7 +7,7 @@
  */
 import { escapeHTML } from '../utils/file-utils.js';
 import { getLocalizedString, TOC_ARIA_LABELS } from '../constants/languages.js';
-import { stripScriptBlocks } from '../utils/html-sanitize.js';
+import { stripScriptBlocks, stripHtmlTags } from '../utils/html-sanitize.js';
 /**
  * Count occurrences of a regex pattern in a string.
  *
@@ -52,10 +52,7 @@ export function computeArticleQualityScore(content) {
     // Uses iterative scanning instead of regex to avoid CodeQL js/bad-tag-filter.
     const noScripts = stripScriptBlocks(content);
     // Strip HTML tags to get plain text, then count words
-    const plainText = noScripts
-        .replace(/<[^>]*>/g, ' ')
-        .replace(/\s+/g, ' ')
-        .trim();
+    const plainText = stripHtmlTags(noScripts).replace(/\s+/g, ' ').trim();
     const wordCount = plainText.length > 0 ? plainText.split(' ').filter((w) => w.length > 0).length : 0;
     // All further counting uses script-stripped HTML to avoid false positives
     // from embedded JSON-LD or interactive script blocks.

package/scripts/types/index.d.ts

@@ -12,7 +12,7 @@
 export { type LanguageCode, type RTLLanguageCode, type AnyLanguageCode, ArticleCategory, ArticlePerspective, TimePeriod, AnalysisPerspective, CATEGORY_PERSPECTIVE, CATEGORY_TIME_PERIOD, type LanguagePreset, type LanguageMap, type ArticleCategoryLabels, type LangTitleSubtitle, type PropositionsStrings, type EditorialStrings, type MotionsStrings, type WeekAheadStrings, type WeekAheadStakeholderStrings, type StakeholderImpactRow, type StakeholderImpactSection, type PoliticalTemperatureBand, type PoliticalTemperature, type BreakingStrings, type ActionConsequence, type StakeholderOutcome, type PoliticalMistake, type DeepAnalysis, type DeepAnalysisStrings, type CommitteeAnalysisContentStrings, } from './common.js';
 export type { ParliamentEvent, CommitteeMeeting, LegislativeDocument, LegislativeProcedure, ParliamentaryQuestion, WeekAheadData, CommitteeDocument, CommitteeData, VotingRecord, VotingPattern, VotingAnomaly, MotionsQuestion, VotingAnomalyIntelligence, CoalitionIntelligence, MEPInfluenceScore, LegislativeVelocity, EPFeedItem, AdoptedTextFeedItem, EventFeedItem, ProcedureFeedItem, MEPFeedItem, DocumentFeedItem, QuestionFeedItem, DeclarationFeedItem, CorporateBodyFeedItem, BreakingNewsFeedData, EPFeedData, VotingIntensity, CoalitionShift, PolarizationIndex, PoliticalSignificanceScore, VotingTrend, CoalitionStabilityReport, LegislativeVelocityReport, } from './parliament.js';
 export type { ParsedArticle, ArticleSource, ArticleOptions, SitemapUrl, ArticleMetadataEntry, NewsMetadataDatabase, DateRange, GenerationStats, GenerationResult, ArticleQualityScore, TOCEntry, } from './generation.js';
-export { type MCPClientOptions, type MCPContentItem, type MCPToolResult, type JSONRPCRequest, type JSONRPCResponse, type PendingRequest, type GetMEPsOptions, type GetPlenarySessionsOptions, type SearchDocumentsOptions, type GetParliamentaryQuestionsOptions, type GetCommitteeInfoOptions, type MonitorLegislativePipelineOptions, type AssessMEPInfluenceOptions, type AnalyzeCoalitionDynamicsOptions, type DetectVotingAnomaliesOptions, type ComparePoliticalGroupsOptions, type AnalyzeLegislativeEffectivenessOptions, type VotingRecordsOptions, type VotingPatternsOptions, type ReportType, type GenerateReportOptions, type AnalyzeCommitteeActivityOptions, type TrackMEPAttendanceOptions, type AnalyzeCountryDelegationOptions, type GeneratePoliticalLandscapeOptions, type GetCurrentMEPsOptions, type GetSpeechesOptions, type GetProceduresOptions, type GetAdoptedTextsOptions, type GetEventsOptions, type GetMeetingActivitiesOptions, type GetMeetingDecisionsOptions, type GetMEPDeclarationsOptions, type GetIncomingMEPsOptions, type GetOutgoingMEPsOptions, type GetHomonymMEPsOptions, type GetPlenaryDocumentsOptions, type GetCommitteeDocumentsOptions, type GetPlenarySessionDocumentsOptions, type GetPlenarySessionDocumentItemsOptions, type GetControlledVocabulariesOptions, type GetExternalDocumentsOptions, type GetMeetingForeseenActivitiesOptions, type GetProcedureEventsOptions, type GetMeetingPlenarySessionDocumentsOptions, type GetMeetingPlenarySessionDocumentItemsOptions, type NetworkAnalysisOptions, type SentimentTrackerOptions, type EarlyWarningSystemOptions, type ComparativeIntelligenceOptions, type CorrelateIntelligenceOptions, type GeneratedStatsCategory, type GetAllGeneratedStatsOptions, type FeedTimeframe, type FeedBaseOptions, type GetMEPsFeedOptions, type GetEventsFeedOptions, type GetProceduresFeedOptions, type GetAdoptedTextsFeedOptions, type GetMEPDeclarationsFeedOptions, type GetDocumentsFeedOptions, type GetPlenaryDocumentsFeedOptions, type GetCommitteeDocumentsFeedOptions, type GetPlenarySessionDocumentsFeedOptions, type GetExternalDocumentsFeedOptions, type GetParliamentaryQuestionsFeedOptions, type GetCorporateBodiesFeedOptions, type GetControlledVocabulariesFeedOptions, } from './mcp.js';
+export { type MCPClientOptions, type MCPContentItem, type MCPToolResult, type JSONRPCRequest, type JSONRPCResponse, type PendingRequest, type GetMEPsOptions, type GetPlenarySessionsOptions, type SearchDocumentsOptions, type GetParliamentaryQuestionsOptions, type GetCommitteeInfoOptions, type MonitorLegislativePipelineOptions, type AssessMEPInfluenceOptions, type AnalyzeCoalitionDynamicsOptions, type DetectVotingAnomaliesOptions, type ComparePoliticalGroupsOptions, type AnalyzeLegislativeEffectivenessOptions, type VotingRecordsOptions, type VotingPatternsOptions, type ReportType, type GenerateReportOptions, type AnalyzeCommitteeActivityOptions, type TrackMEPAttendanceOptions, type AnalyzeCountryDelegationOptions, type GeneratePoliticalLandscapeOptions, type GetCurrentMEPsOptions, type GetSpeechesOptions, type GetProceduresOptions, type GetAdoptedTextsOptions, type GetEventsOptions, type GetMeetingActivitiesOptions, type GetMeetingDecisionsOptions, type GetMEPDeclarationsOptions, type GetIncomingMEPsOptions, type GetOutgoingMEPsOptions, type GetHomonymMEPsOptions, type GetPlenaryDocumentsOptions, type GetCommitteeDocumentsOptions, type GetPlenarySessionDocumentsOptions, type GetPlenarySessionDocumentItemsOptions, type GetControlledVocabulariesOptions, type GetExternalDocumentsOptions, type GetMeetingForeseenActivitiesOptions, type GetProcedureEventsOptions, type GetMeetingPlenarySessionDocumentsOptions, type GetMeetingPlenarySessionDocumentItemsOptions, type NetworkAnalysisOptions, type SentimentTrackerOptions, type EarlyWarningSystemOptions, type ComparativeIntelligenceOptions, type CorrelateIntelligenceOptions, type GeneratedStatsCategory, type GetAllGeneratedStatsOptions, type FeedTimeframe, type FeedBaseOptions, type GetMEPsFeedOptions, type GetEventsFeedOptions, type GetProceduresFeedOptions, type GetAdoptedTextsFeedOptions, type GetMEPDeclarationsFeedOptions, type GetDocumentsFeedOptions, type GetPlenaryDocumentsFeedOptions, type GetCommitteeDocumentsFeedOptions, type GetPlenarySessionDocumentsFeedOptions, type GetExternalDocumentsFeedOptions, type GetParliamentaryQuestionsFeedOptions, type GetCorporateBodiesFeedOptions, type GetControlledVocabulariesFeedOptions, type GetProcedureEventByIdOptions, } from './mcp.js';
 export type { WBMCPClientOptions, WorldBankIndicator, WorldBankCountry, EconomicContext, EconomicIndicatorSummary, EUCountryCodeMap, PolicyRelevantIndicators, } from './world-bank.js';
 export type { SwotItem, SwotAnalysis, SwotStrings, SwotBuilderStrings, SwotDimensionName, StakeholderType, SwotDimension, SwotCrossReference, TemporalSwotAssessment, MultiDimensionalSwot, MultiDimensionalSwotStrings, DashboardMetric, ChartDataset, ChartData, ChartConfig, DashboardPanel, DashboardConfig, DashboardStrings, DashboardBuilderStrings, MindmapNodeCategory, PolicyConnectionType, PolicyConnectionStrength, ActorType, MindmapBranchColor, MindmapNode, MindmapLayer, PolicyConnection, ActorNode, InfluenceWeight, IntelligenceMindmap, VotingBloc, VoteHighlight, CoalitionMetrics, LegislativePipeline, TrendMetric, TrendAnalytics, StakeholderMetric, } from './visualization.js';
 export type { ArticleGrade, AnalysisDepthScore, StakeholderCoverage, VisualizationQuality, ArticleQualityReport, } from './quality.js';
@@ -25,4 +25,5 @@ export type { PoliticalActorThreatProfile, ConsequenceNode, PoliticalConsequence
 export type { PoliticalRiskLikelihood, PoliticalRiskImpact, PoliticalRiskLevel, PoliticalRiskScore, PoliticalThreatCategory, PoliticalRiskDriver, PoliticalCapitalAtRisk, LegislativeStage, LegislativeVelocityRisk, SwotItemTrend, ScoredSWOTItem, CrossImpactEntry, QuantitativeSWOT, RiskAssessmentStep, AgentRiskAssessmentWorkflow, RiskLevelCounts, PoliticalRiskSummary, } from './political-risk.js';
 export type { PoliticalSignificance, ImpactLevel, PoliticalImpactAssessment, ClassificationConfidence, PoliticalActorType, PoliticalActorClassification, ForceAssessment, PoliticalForcesAnalysis, ClassificationMethod, AnalysisRunManifest, AnalysisFrontmatter, ClassificationInput, } from './political-classification.js';
 export { SIGNIFICANCE_ORDER, IMPACT_ORDER } from './political-classification.js';
+export type { PublicationDecision, SignificanceDimension, SignificanceScore, SignificanceScoringInput, SignificanceBatchResult, SynthesisFinding, AggregatedSWOT, RiskOverview, SynthesisSummary, } from './significance.js';
 //# sourceMappingURL=index.d.ts.map

package/scripts/types/mcp.d.ts

@@ -415,4 +415,11 @@ export interface GetCorporateBodiesFeedOptions extends FeedBaseOptions {
 /** Options for getControlledVocabulariesFeed */
 export interface GetControlledVocabulariesFeedOptions extends FeedBaseOptions {
 }
+/** Options for getProcedureEventById */
+export interface GetProcedureEventByIdOptions {
+    /** Procedure process ID (required) */
+    processId: string;
+    /** Event identifier (required) */
+    eventId: string;
+}
 //# sourceMappingURL=mcp.d.ts.map

package/scripts/types/political-classification.d.ts

@@ -136,7 +136,7 @@ export interface PoliticalForcesAnalysis {
  */
 export type ClassificationMethod = 'impact-matrix' | 'actor-mapping' | 'forces-analysis' | 'significance-assessment';
 /**
- * Metadata record written to `analysis/{date}/{article-type}/manifest.json`.
+ * Metadata record written to `analysis/daily/{date}/{article-type}/manifest.json`.
  * Describes a single analysis run: when it ran, which article types were
  * analysed, and which analytical methods were applied.
  */

package/scripts/types/quality.d.ts

@@ -68,13 +68,16 @@ export interface VisualizationQuality {
 /**
  * Letter grade assigned to an article based on its overall quality score.
  *
+ * Grade boundaries are calibrated so that the quality gate (Grade C floor)
+ * aligns with the methodology minimum of 7.0/10 (≡ 70/100).
+ *
  * | Grade | Score range |
  * |-------|-------------|
- * | A     | ≥ 80        |
- * | B     | ≥ 65        |
- * | C     | ≥ 40        |
- * | D     | ≥ 25        |
- * | F     | < 25        |
+ * | A     | ≥ 90        |
+ * | B     | ≥ 80        |
+ * | C     | ≥ 70        |
+ * | D     | ≥ 50        |
+ * | F     | < 50        |
  */
 export type ArticleGrade = 'A' | 'B' | 'C' | 'D' | 'F';
 /**
@@ -108,7 +111,7 @@ export interface ArticleQualityReport {
     readonly grade: ArticleGrade;
     /** Actionable improvement recommendations */
     readonly recommendations: readonly string[];
-    /** true when overallScore ≥ 40 (Grade C or better) */
+    /** true when overallScore ≥ 70 (Grade C or better, per methodology minimum 7.0/10) */
     readonly passesQualityGate: boolean;
 }
 //# sourceMappingURL=quality.d.ts.map

package/scripts/types/significance.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @module Types/Significance
+ * @description Type definitions for the significance scoring engine and
+ * synthesis summary generator.
+ *
+ * The significance scoring engine produces a 5-dimension composite score
+ * (0–10) used for publication prioritisation decisions.  Dimensions and
+ * weights follow the analysis template specification:
+ *
+ * | Dimension                  | Weight |
+ * |----------------------------|--------|
+ * | Parliamentary Significance | 0.25   |
+ * | Policy Impact              | 0.25   |
+ * | Public Interest            | 0.20   |
+ * | Temporal Urgency           | 0.15   |
+ * | Institutional Relevance    | 0.15   |
+ *
+ * The synthesis summary generator aggregates per-file analysis outputs
+ * into a single editorial briefing consumed by article generators.
+ */
+import type { ConfidenceLevel } from './analysis.js';
+/** Publication decision produced by the scoring engine */
+export type PublicationDecision = 'publish' | 'hold' | 'skip';
+/** Names of the five scoring dimensions */
+export type SignificanceDimension = 'parliamentarySignificance' | 'policyImpact' | 'publicInterest' | 'temporalUrgency' | 'institutionalRelevance';
+/**
+ * Result of scoring a single EP event / document across five dimensions.
+ *
+ * Each dimension is scored 0–10.  The `composite` value is the weighted
+ * average.  The `decision` is derived from composite thresholds:
+ *
+ * | Score      | Decision  |
+ * |------------|-----------|
+ * | 0.0 – 3.9  | skip      |
+ * | 4.0 – 5.9  | hold      |
+ * | ≥ 6.0      | publish   |
+ */
+export interface SignificanceScore {
+    /** Parliamentary significance dimension (0–10) */
+    readonly parliamentarySignificance: number;
+    /** Policy impact dimension (0–10) */
+    readonly policyImpact: number;
+    /** Public interest dimension (0–10) */
+    readonly publicInterest: number;
+    /** Temporal urgency dimension (0–10) */
+    readonly temporalUrgency: number;
+    /** Institutional / cross-group relevance dimension (0–10) */
+    readonly institutionalRelevance: number;
+    /** Weighted composite score (0–10) */
+    readonly composite: number;
+    /** Publication decision derived from composite thresholds */
+    readonly decision: PublicationDecision;
+}
+/** Input for a single event to be scored */
+export interface SignificanceScoringInput {
+    /** Human-readable event title */
+    readonly title: string;
+    /** EP reference identifier (procedure ID, adopted text ref, etc.) */
+    readonly reference?: string;
+    /** Raw dimension scores provided by the caller (each 0–10) */
+    readonly parliamentarySignificance: number;
+    readonly policyImpact: number;
+    readonly publicInterest: number;
+    readonly temporalUrgency: number;
+    readonly institutionalRelevance: number;
+}
+/** Batch scoring result for multiple events */
+export interface SignificanceBatchResult {
+    /** Individual event scores, ranked by composite descending */
+    readonly scores: readonly SignificanceScore[];
+    /** Count of events per decision category */
+    readonly summary: {
+        readonly publish: number;
+        readonly hold: number;
+        readonly skip: number;
+    };
+}
+/** A single finding extracted from a per-file analysis */
+export interface SynthesisFinding {
+    /** Source analysis method that produced this finding */
+    readonly method: string;
+    /** Source filename */
+    readonly file: string;
+    /** Confidence level from the analysis frontmatter */
+    readonly confidence: ConfidenceLevel;
+    /** One-line summary of the finding */
+    readonly summary: string;
+}
+/** Aggregated SWOT counts across all per-file analyses */
+export interface AggregatedSWOT {
+    /** Number of strength entries found across all files */
+    readonly strengths: number;
+    /** Number of weakness entries found across all files */
+    readonly weaknesses: number;
+    /** Number of opportunity entries found across all files */
+    readonly opportunities: number;
+    /** Number of threat entries found across all files */
+    readonly threats: number;
+}
+/** Risk level distribution across all per-file analyses */
+export interface RiskOverview {
+    /** Number of critical-level risk items */
+    readonly critical: number;
+    /** Number of high-level risk items */
+    readonly high: number;
+    /** Number of medium-level risk items */
+    readonly medium: number;
+    /** Number of low-level risk items */
+    readonly low: number;
+}
+/** Complete synthesis summary aggregating all per-file analyses */
+export interface SynthesisSummary {
+    /** Unique synthesis identifier (SYN-YYYY-MM-DD-{8-char-UUID}) */
+    readonly synthesisId: string;
+    /** ISO date of the analysis */
+    readonly date: string;
+    /** Number of analysis files processed */
+    readonly documentsAnalyzed: number;
+    /** Aggregated confidence across all sources */
+    readonly overallConfidence: ConfidenceLevel;
+    /** Top findings ranked by confidence (high → medium → low) */
+    readonly topFindings: readonly SynthesisFinding[];
+    /** Aggregated SWOT summary */
+    readonly swot: AggregatedSWOT;
+    /** Risk level distribution */
+    readonly riskOverview: RiskOverview;
+    /** Editorial recommendations */
+    readonly editorialRecommendations: readonly string[];
+}
+//# sourceMappingURL=significance.d.ts.map

package/scripts/types/significance.js

@@ -0,0 +1,4 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=significance.js.map

package/scripts/utils/article-quality-scorer.d.ts

@@ -2,14 +2,16 @@
  * @module Utils/ArticleQualityScorer
  * @description Comprehensive quality assessment engine for generated EU Parliament Monitor articles.
  *
- * Analyses HTML article content across four dimensions:
- * - **Analysis depth** — political context, coalition dynamics, historical evidence, scenarios
- * - **Stakeholder coverage** — breadth of perspectives from MEPs, Commission, civil society, etc.
- * - **Visualization quality** — SWOT, dashboard metrics, mindmap branches, deep-analysis evidence
- * - **Content integrity** — word count, evidence references, section structure
+ * Analyses HTML article content across five weighted dimensions aligned with
+ * the AI-driven analysis methodology guide (`analysis/methodologies/ai-driven-analysis-guide.md`):
+ * - **Analysis depth** (25%) — political context, coalition dynamics, historical evidence, scenarios
+ * - **Evidence density** (25%) — document references, citations, data-backed claims
+ * - **Structural compliance** (20%) — SWOT, dashboard metrics, mindmap branches, deep-analysis
+ * - **Actionable intelligence** (15%) — article length via word count
+ * - **Stakeholder balance** (15%) — breadth of perspectives from MEPs, Commission, civil society, etc.
  *
  * Produces an {@link ArticleQualityReport} with a 0–100 overall score, letter grade (A–F),
- * pass/fail quality gate, and actionable recommendations.
+ * pass/fail quality gate (≥ 70, per methodology minimum 7.0/10), and actionable recommendations.
  */
 import type { ArticleQualityReport, AnalysisDepthScore, StakeholderCoverage, VisualizationQuality } from '../types/quality.js';
 /**
@@ -46,12 +48,12 @@ export declare function assessVisualizationQuality(html: string): VisualizationQ
 /**
  * Compute the weighted overall quality score (0–100) from component scores.
  *
- * Weights:
+ * Weights (aligned with ai-driven-analysis-guide.md):
  * - Analysis depth: 25 %
- * - Stakeholder balance: 20 %
- * - Visualization: 25 %
- * - Word count: 15 %
- * - Evidence references: 15 %
+ * - Evidence references: 25 %
+ * - Visualization / structural compliance: 20 %
+ * - Word count / actionable intelligence: 15 %
+ * - Stakeholder balance / political neutrality: 15 %
  *
  * @param depth - Analysis depth score object
  * @param coverage - Stakeholder coverage score object

package/scripts/utils/article-quality-scorer.js

@@ -2,32 +2,45 @@
 // SPDX-License-Identifier: Apache-2.0
 import { stripScriptBlocks } from './html-sanitize.js';
 // ─── Scoring constants ────────────────────────────────────────────────────────
-/** Weight applied to analysis depth score in overall calculation */
+//
+// Weights aligned with analysis/methodologies/ai-driven-analysis-guide.md §Score
+// the Analysis:
+//   Evidence density      → WEIGHT_EVIDENCE        = 0.25
+//   Analytical depth      → WEIGHT_ANALYSIS_DEPTH   = 0.25
+//   Structural compliance → WEIGHT_VISUALIZATION    = 0.20
+//   Actionable intel      → WEIGHT_WORD_COUNT       = 0.15
+//   Political neutrality  → WEIGHT_STAKEHOLDER      = 0.15
+/** Weight applied to analysis depth score in overall calculation (methodology: Analytical depth 25%) */
 const WEIGHT_ANALYSIS_DEPTH = 0.25;
-/** Weight applied to stakeholder balance score in overall calculation */
-const WEIGHT_STAKEHOLDER = 0.2;
-/** Weight applied to visualization quality score in overall calculation */
-const WEIGHT_VISUALIZATION = 0.25;
-/** Weight applied to word-count score in overall calculation */
+/** Weight applied to stakeholder balance score in overall calculation (methodology: Political neutrality 15%) */
+const WEIGHT_STAKEHOLDER = 0.15;
+/** Weight applied to visualization quality score in overall calculation (methodology: Structural compliance 20%) */
+const WEIGHT_VISUALIZATION = 0.2;
+/** Weight applied to word-count score in overall calculation (methodology: Actionable intelligence 15%) */
 const WEIGHT_WORD_COUNT = 0.15;
-/** Weight applied to evidence-reference score in overall calculation */
-const WEIGHT_EVIDENCE = 0.15;
+/** Weight applied to evidence-reference score in overall calculation (methodology: Evidence density 25%) */
+const WEIGHT_EVIDENCE = 0.25;
 /** Minimum word count to score 0 on the word-count dimension */
 const WORD_COUNT_MIN = 0;
 /** Word count that earns the maximum word-count dimension score */
 const WORD_COUNT_MAX = 1500;
 /** Evidence-reference count that earns the maximum evidence dimension score */
 const EVIDENCE_MAX = 10;
-/** Overall score threshold for passing the quality gate (Grade C floor) */
-const QUALITY_GATE_THRESHOLD = 40;
+/**
+ * Overall score threshold for passing the quality gate.
+ *
+ * Aligned with analysis/methodologies/ai-driven-analysis-guide.md which
+ * mandates a minimum 7.0/10 (≡ 70/100) quality score.
+ */
+const QUALITY_GATE_THRESHOLD = 70;
 /** Grade boundary — score >= this earns an A */
-const GRADE_A_MIN = 80;
+const GRADE_A_MIN = 90;
 /** Grade boundary — score >= this earns a B */
-const GRADE_B_MIN = 65;
-/** Grade boundary — score >= this earns a C */
-const GRADE_C_MIN = 40;
+const GRADE_B_MIN = 80;
+/** Grade boundary — score >= this earns a C (matches quality gate threshold) */
+const GRADE_C_MIN = 70;
 /** Grade boundary — score >= this earns a D */
-const GRADE_D_MIN = 25;
+const GRADE_D_MIN = 50;
 // ─── Analysis-depth keyword sets ─────────────────────────────────────────────
 /** Keywords indicating political context discussion */
 const POLITICAL_CONTEXT_KEYWORDS = [
@@ -784,12 +797,12 @@ function computeVisualizationScore(v) {
 /**
  * Compute the weighted overall quality score (0–100) from component scores.
  *
- * Weights:
+ * Weights (aligned with ai-driven-analysis-guide.md):
  * - Analysis depth: 25 %
- * - Stakeholder balance: 20 %
- * - Visualization: 25 %
- * - Word count: 15 %
- * - Evidence references: 15 %
+ * - Evidence references: 25 %
+ * - Visualization / structural compliance: 20 %
+ * - Word count / actionable intelligence: 15 %
+ * - Stakeholder balance / political neutrality: 15 %
  *
  * @param depth - Analysis depth score object
  * @param coverage - Stakeholder coverage score object
@@ -898,10 +911,10 @@ export function generateRecommendations(report) {
  */
 function addWordCountRecommendations(report, recs) {
     if (report.wordCount < 500) {
-        recs.push('Expand article length to at least 500 words for Grade C quality');
+        recs.push('Expand article length to at least 500 words to improve word-count score');
     }
     else if (report.wordCount < WORD_COUNT_MAX) {
-        recs.push(`Increase article depth to ${WORD_COUNT_MAX} words for Grade A quality (currently ${report.wordCount})`);
+        recs.push(`Increase article depth to ${WORD_COUNT_MAX} words for maximum word-count score (currently ${report.wordCount})`);
     }
 }
 /**
@@ -987,7 +1000,7 @@ function addEvidenceRecommendations(report, recs) {
         recs.push('Add at least 3 evidence references or EP document citations');
     }
     else if (report.evidenceReferences < 10) {
-        recs.push(`Increase evidence references to 10 for Grade A quality (currently ${report.evidenceReferences})`);
+        recs.push(`Increase evidence references to 10 for maximum evidence score (currently ${report.evidenceReferences})`);
     }
 }
 // ─── Public API ───────────────────────────────────────────────────────────────

package/scripts/utils/file-utils.d.ts

@@ -69,9 +69,9 @@ export declare function ensureDirectoryExists(dirPath: string): void;
  * `mkdirSync`, preventing TOCTOU races when concurrent workflow runs
  * attempt to claim the same candidate.
  *
- * @param baseDir - The preferred directory path (e.g. `analysis/2026-04-02/breaking`)
+ * @param baseDir - The preferred directory path (e.g. `analysis/daily/2026-04-02/breaking`)
  * @returns The original `baseDir` when no completed run exists there, or a
- *          suffixed variant (e.g. `analysis/2026-04-02/breaking-2`) otherwise.
+ *          suffixed variant (e.g. `analysis/daily/2026-04-02/breaking-2`) otherwise.
  */
 export declare function resolveUniqueAnalysisDir(baseDir: string): string;
 /**