euparliamentmonitor 0.8.4

package/scripts/types/parliament.d.ts

@@ -0,0 +1,388 @@
+/**
+ * @module Types/Parliament
+ * @description Domain types for European Parliament entities — events, committees,
+ * documents, procedures, questions, and voting data.
+ */
+/** Event data from MCP or fallback */
+export interface ParliamentEvent {
+    date: string;
+    title: string;
+    type: string;
+    description: string;
+}
+/** Committee meeting data from MCP */
+export interface CommitteeMeeting {
+    id?: string | undefined;
+    committee: string;
+    committeeName?: string | undefined;
+    date: string;
+    time?: string | undefined;
+    location?: string | undefined;
+    agenda?: Array<{
+        item?: number | undefined;
+        title: string;
+        type?: string | undefined;
+    }> | undefined;
+}
+/** Legislative document from MCP */
+export interface LegislativeDocument {
+    id?: string | undefined;
+    type?: string | undefined;
+    title: string;
+    date?: string | undefined;
+    status?: string | undefined;
+    committee?: string | undefined;
+    rapporteur?: string | undefined;
+}
+/** Legislative pipeline procedure */
+export interface LegislativeProcedure {
+    id?: string | undefined;
+    title: string;
+    stage?: string | undefined;
+    committee?: string | undefined;
+    status?: string | undefined;
+    bottleneck?: boolean | undefined;
+}
+/** Parliamentary question */
+export interface ParliamentaryQuestion {
+    id?: string | undefined;
+    type?: string | undefined;
+    author?: string | undefined;
+    subject: string;
+    date?: string | undefined;
+    status?: string | undefined;
+}
+/** Aggregated week-ahead data from multiple MCP sources */
+export interface WeekAheadData {
+    events: ParliamentEvent[];
+    committees: CommitteeMeeting[];
+    documents: LegislativeDocument[];
+    pipeline: LegislativeProcedure[];
+    questions: ParliamentaryQuestion[];
+}
+/** Committee document with type, title and date */
+export interface CommitteeDocument {
+    title: string;
+    type: string;
+    date: string;
+}
+/** Committee report data aggregated from MCP sources */
+export interface CommitteeData {
+    name: string;
+    abbreviation: string;
+    chair: string;
+    members: number;
+    documents: CommitteeDocument[];
+    effectiveness: string | null;
+}
+/** Voting record from MCP or fallback */
+export interface VotingRecord {
+    title: string;
+    date: string;
+    result: string;
+    votes: {
+        for: number;
+        against: number;
+        abstain: number;
+    };
+}
+/** Voting pattern (party cohesion) from MCP or fallback */
+export interface VotingPattern {
+    group: string;
+    cohesion: number;
+    participation: number;
+}
+/** Voting anomaly from MCP or fallback */
+export interface VotingAnomaly {
+    type: string;
+    description: string;
+    severity: string;
+}
+/** Parliamentary question for motions article (simplified MCP/fallback shape) */
+export interface MotionsQuestion {
+    author: string;
+    topic: string;
+    date: string;
+    status: string;
+}
+/** Intelligence analysis for a detected voting anomaly */
+export interface VotingAnomalyIntelligence {
+    anomalyId: string;
+    significance: 'critical' | 'high' | 'medium' | 'low';
+    description: string;
+    affectedGroups: string[];
+    deviationPercentage: number;
+    historicalContext: string;
+    implication: string;
+}
+/** Coalition cohesion and alignment intelligence */
+export interface CoalitionIntelligence {
+    coalitionId: string;
+    groups: string[];
+    cohesionScore: number;
+    alignmentTrend: 'strengthening' | 'weakening' | 'stable';
+    keyVotes: number;
+    riskLevel: 'high' | 'medium' | 'low';
+}
+/** MEP influence score across multiple parliamentary dimensions */
+export interface MEPInfluenceScore {
+    mepId: string;
+    mepName: string;
+    overallScore: number;
+    votingActivity: number;
+    legislativeOutput: number;
+    committeeEngagement: number;
+    rank: string;
+}
+/** Legislative velocity for procedure pipeline monitoring */
+export interface LegislativeVelocity {
+    procedureId: string;
+    title: string;
+    stage: string;
+    daysInCurrentStage: number;
+    velocityScore: number;
+    bottleneckRisk: 'high' | 'medium' | 'low';
+    predictedCompletion: string;
+}
+/**
+ * Quantified political significance score for breaking news prioritization.
+ * Each dimension contributes a weighted sub-score to an overall 0–100 composite.
+ */
+export interface PoliticalSignificanceScore {
+    /** Sub-score for adopted texts / legislative activity (0–100) */
+    readonly adoptedTextsScore: number;
+    /** Sub-score for affected MEP updates (0–100) */
+    readonly affectedMEPsScore: number;
+    /** Sub-score for legislative stage proximity to final reading (0–100) */
+    readonly legislativeStageScore: number;
+    /** Sub-score for event / committee involvement breadth (0–100) */
+    readonly committeeInvolvementScore: number;
+    /** Weighted composite score (0–100) */
+    readonly overallScore: number;
+}
+/** Voting intensity metrics for a set of voting records */
+export interface VotingIntensity {
+    /** Largest-position share (including abstentions): 0 = perfect three-way split, 1 = unanimous */
+    unanimity: number;
+    /** Polarization among for/against voters: 0 = one-sided, 1 = perfectly split (abstain-only records excluded) */
+    polarization: number;
+    /** Average margin of victory across votes */
+    averageMargin: number;
+    /** Number of close votes (margin < 10%) */
+    closeVoteCount: number;
+    /** Number of decisive votes (margin > 60%) */
+    decisiveVoteCount: number;
+}
+/** Coalition shift detection result */
+export interface CoalitionShift {
+    /** Name of the political group */
+    group: string;
+    /** Previous cohesion (or baseline) */
+    previousCohesion: number;
+    /** Current cohesion */
+    currentCohesion: number;
+    /** Signed change in cohesion (currentCohesion - previousCohesion) */
+    cohesionDelta: number;
+    /** Direction of the shift */
+    direction: 'strengthening' | 'weakening' | 'stable';
+    /** Severity of the shift for political intelligence */
+    significance: 'critical' | 'high' | 'medium' | 'low';
+}
+/** Polarization index for a parliamentary period */
+export interface PolarizationIndex {
+    /** Overall index 0-1 (0 = consensus, 1 = completely polarized) */
+    overallIndex: number;
+    /** Effective number of voting blocs (Laakso-Taagepera style) */
+    effectiveBlocs: number;
+    /** Groups above 80% cohesion — potential blocking minorities */
+    highCohesionGroups: string[];
+    /** Groups below 50% cohesion — internally divided */
+    fragmentedGroups: string[];
+    /** Assessment label */
+    assessment: 'consensus' | 'moderate' | 'polarized' | 'highly-polarized';
+}
+/** Detected voting trend across multiple sessions */
+export interface VotingTrend {
+    /** Identifier for the trend (e.g. "increasing-polarization") */
+    trendId: string;
+    /** Human-readable description of the trend */
+    description: string;
+    /** Direction of the trend */
+    direction: 'increasing' | 'decreasing' | 'stable';
+    /** Confidence in the detection (0-1) */
+    confidence: number;
+    /** Number of records contributing to this trend */
+    recordCount: number;
+    /** Representative metric value (e.g. average margin change) */
+    metricValue: number;
+}
+/** Coalition stability report from cross-session pattern analysis */
+export interface CoalitionStabilityReport {
+    /** Overall stability score (0-1, higher = more stable) */
+    overallStability: number;
+    /** Number of patterns analysed */
+    patternCount: number;
+    /** Groups with consistently high cohesion */
+    stableGroups: string[];
+    /** Groups showing declining cohesion */
+    decliningGroups: string[];
+    /** Forecast assessment label */
+    forecast: 'stable' | 'at-risk' | 'volatile';
+}
+/** Legislative velocity report with stage-by-stage timing analysis */
+export interface LegislativeVelocityReport {
+    /** Total documents analysed */
+    documentCount: number;
+    /** Breakdown of documents by stage */
+    stageBreakdown: Record<string, number>;
+    /** Average days per stage (where data available) */
+    averageDaysPerStage: number;
+    /** Number of stages identified as bottlenecks (stage-level count, not document-level) */
+    bottleneckCount: number;
+    /** Overall throughput assessment */
+    throughputAssessment: 'fast' | 'normal' | 'slow';
+}
+/** A single item from any EP API v2 feed response (`data[]` array) */
+export interface EPFeedItem {
+    /** Full ELI identifier (e.g. `"eli/dl/doc/TA-10-2025-0281"`) */
+    id: string;
+    /** RDF type (usually `"Work"`) */
+    type?: string | undefined;
+    /** EP document type URI (e.g. `"def/ep-document-types/TEXT_ADOPTED"`) */
+    work_type?: string | undefined;
+    /** Short document identifier (e.g. `"TA-10-2025-0281"`) */
+    identifier?: string | undefined;
+    /** Human-readable label (e.g. `"T10-0281/2025"`) */
+    label?: string | undefined;
+    /** Title, when available */
+    title?: string | undefined;
+    /** Date string (ISO 8601 or free-form) */
+    date?: string | undefined;
+    /** URL link to the source document */
+    url?: string | undefined;
+}
+/** A single adopted-text item from the EP adopted-texts feed */
+export interface AdoptedTextFeedItem {
+    id: string;
+    title: string;
+    date: string;
+    type?: string | undefined;
+    url?: string | undefined;
+    /** Short identifier (e.g. `"TA-10-2025-0281"`) */
+    identifier?: string | undefined;
+    /** Human-readable label (e.g. `"T10-0281/2025"`) */
+    label?: string | undefined;
+}
+/** A single event item from the EP events feed */
+export interface EventFeedItem {
+    id: string;
+    title: string;
+    date: string;
+    type?: string | undefined;
+    location?: string | undefined;
+    url?: string | undefined;
+    identifier?: string | undefined;
+    label?: string | undefined;
+}
+/** A single procedure item from the EP procedures feed */
+export interface ProcedureFeedItem {
+    id: string;
+    title: string;
+    date: string;
+    stage?: string | undefined;
+    type?: string | undefined;
+    url?: string | undefined;
+    identifier?: string | undefined;
+    label?: string | undefined;
+}
+/** A single MEP update item from the EP MEPs feed */
+export interface MEPFeedItem {
+    id: string;
+    name: string;
+    date: string;
+    country?: string | undefined;
+    group?: string | undefined;
+    url?: string | undefined;
+    identifier?: string | undefined;
+    label?: string | undefined;
+}
+/** A single document item from EP document feeds */
+export interface DocumentFeedItem {
+    id: string;
+    title: string;
+    date: string;
+    type?: string | undefined;
+    url?: string | undefined;
+    identifier?: string | undefined;
+    label?: string | undefined;
+}
+/** A single parliamentary question item from the EP questions feed */
+export interface QuestionFeedItem {
+    id: string;
+    title: string;
+    date: string;
+    type?: string | undefined;
+    url?: string | undefined;
+    identifier?: string | undefined;
+    label?: string | undefined;
+}
+/** A single MEP declaration item from the EP declarations feed */
+export interface DeclarationFeedItem {
+    id: string;
+    title: string;
+    date: string;
+    type?: string | undefined;
+    url?: string | undefined;
+    identifier?: string | undefined;
+    label?: string | undefined;
+}
+/** A single corporate body item from the EP corporate bodies feed */
+export interface CorporateBodyFeedItem {
+    id: string;
+    title: string;
+    date: string;
+    type?: string | undefined;
+    url?: string | undefined;
+    identifier?: string | undefined;
+    label?: string | undefined;
+}
+/** Aggregated feed data for breaking news articles (legacy compat) */
+export interface BreakingNewsFeedData {
+    adoptedTexts: readonly AdoptedTextFeedItem[];
+    events: readonly EventFeedItem[];
+    procedures: readonly ProcedureFeedItem[];
+    mepUpdates: readonly MEPFeedItem[];
+    /** Total number of MEP updates reported by the feed API (may exceed the fetched/displayed count) */
+    totalMEPUpdates?: number | undefined;
+}
+/**
+ * Comprehensive feed data aggregation from all EP API v2 feed endpoints.
+ * Used by all article strategies as the primary data source for current/recent events.
+ */
+export interface EPFeedData {
+    /** Recently adopted texts (resolutions, directives, regulations) */
+    adoptedTexts: readonly AdoptedTextFeedItem[];
+    /** Recent parliamentary events, hearings, conferences */
+    events: readonly EventFeedItem[];
+    /** Recently updated legislative procedures */
+    procedures: readonly ProcedureFeedItem[];
+    /** Recent MEP updates (new members, departures, changes) */
+    mepUpdates: readonly MEPFeedItem[];
+    /** Recently published or updated documents */
+    documents: readonly DocumentFeedItem[];
+    /** Recently published plenary documents */
+    plenaryDocuments: readonly DocumentFeedItem[];
+    /** Recently published committee documents */
+    committeeDocuments: readonly DocumentFeedItem[];
+    /** Recently published plenary session documents */
+    plenarySessionDocuments: readonly DocumentFeedItem[];
+    /** Recently published external documents */
+    externalDocuments: readonly DocumentFeedItem[];
+    /** Recently tabled parliamentary questions */
+    questions: readonly QuestionFeedItem[];
+    /** Recently updated MEP declarations */
+    declarations: readonly DeclarationFeedItem[];
+    /** Recently updated corporate bodies */
+    corporateBodies: readonly CorporateBodyFeedItem[];
+}
+//# sourceMappingURL=parliament.d.ts.map

package/scripts/types/parliament.d.ts.map

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

package/scripts/types/parliament.js

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

package/scripts/types/parliament.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parliament.js","sourceRoot":"","sources":["../../src/types/parliament.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,sCAAsC"}

package/scripts/types/quality.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @module Types/Quality
+ * @description Type definitions for the Article Quality Assurance Pipeline.
+ *
+ * Provides interfaces for quality scoring, analysis depth assessment,
+ * stakeholder coverage evaluation, and visualization quality metrics
+ * used by the article-quality-scorer utility.
+ */
+/**
+ * Measures how deeply an article analyses the political situation.
+ * Each boolean dimension maps to a detected signal in the article text.
+ */
+export interface AnalysisDepthScore {
+    /** Whether political context (coalitions, majorities, opposition) is discussed */
+    readonly politicalContextPresent: boolean;
+    /** Whether coalition dynamics and inter-group alliances are analysed */
+    readonly coalitionDynamicsAnalyzed: boolean;
+    /** Whether historical comparison or timeline context is provided */
+    readonly historicalContextProvided: boolean;
+    /** Whether conclusions are backed by data, figures, or cited evidence */
+    readonly evidenceBasedConclusions: boolean;
+    /** Whether forward-looking scenarios or projections are presented */
+    readonly scenarioPlanning: boolean;
+    /** Whether uncertainty or confidence levels are explicitly stated */
+    readonly confidenceLevelsIndicated: boolean;
+    /** Composite 0–100 score derived from the boolean dimensions above */
+    readonly score: number;
+}
+/**
+ * Measures the breadth and balance of stakeholder perspectives in an article.
+ */
+export interface StakeholderCoverage {
+    /** Stakeholder categories whose perspectives are detected in the article */
+    readonly perspectivesPresent: readonly string[];
+    /** Stakeholder categories whose perspectives appear absent from the article */
+    readonly perspectivesMissing: readonly string[];
+    /** 0–100 score based on how many of the known stakeholder types are covered */
+    readonly balanceScore: number;
+    /** 0–100 score based on analytical reasoning quality inferred from text signals */
+    readonly reasoningQuality: number;
+}
+/**
+ * Measures the quality and completeness of embedded visual elements
+ * (SWOT, dashboards, mindmaps, and deep-analysis sections).
+ */
+export interface VisualizationQuality {
+    /** Whether a SWOT analysis section is present */
+    readonly swotPresent: boolean;
+    /** Number of distinct SWOT dimension elements detected */
+    readonly swotDimensions: number;
+    /** Whether a data dashboard section is present */
+    readonly dashboardPresent: boolean;
+    /** Number of individual metrics detected in the dashboard */
+    readonly dashboardMetrics: number;
+    /** Whether trend indicators (arrows or CSS classes) are present in the dashboard */
+    readonly dashboardTrends: boolean;
+    /** Whether a mindmap section is present */
+    readonly mindmapPresent: boolean;
+    /** Number of mindmap branch elements detected (breadth indicator) */
+    readonly mindmapBranches: number;
+    /** Whether deep-analysis sections are present */
+    readonly deepAnalysisPresent: boolean;
+    /** Number of evidence items detected inside deep-analysis sections */
+    readonly deepAnalysisEvidence: number;
+    /** Composite 0–100 score derived from the dimensions above */
+    readonly score: number;
+}
+/**
+ * Letter grade assigned to an article based on its overall quality score.
+ *
+ * | Grade | Score range |
+ * |-------|-------------|
+ * | A     | ≥ 80        |
+ * | B     | ≥ 65        |
+ * | C     | ≥ 40        |
+ * | D     | ≥ 25        |
+ * | F     | < 25        |
+ */
+export type ArticleGrade = 'A' | 'B' | 'C' | 'D' | 'F';
+/**
+ * Comprehensive quality report for a single generated article.
+ * Produced by {@link scoreArticleQuality} in article-quality-scorer.
+ */
+export interface ArticleQualityReport {
+    /** Unique identifier for the article (typically the filename slug) */
+    readonly articleId: string;
+    /** ISO date string (YYYY-MM-DD) of the article */
+    readonly date: string;
+    /** Article type / category (e.g. "week-ahead") */
+    readonly type: string;
+    /** Language code of the article (e.g. "en", "de") */
+    readonly lang: string;
+    /** Plain-text word count of the main article content */
+    readonly wordCount: number;
+    /** Number of analysis-content sections detected (e.g. analysis, deep-analysis, SWOT, dashboard, mindmap) */
+    readonly analysisSections: number;
+    /** Number of evidence or document references detected */
+    readonly evidenceReferences: number;
+    /** Detailed analysis-depth scoring */
+    readonly analysisDepth: AnalysisDepthScore;
+    /** Stakeholder coverage assessment */
+    readonly stakeholderCoverage: StakeholderCoverage;
+    /** Visualization quality assessment */
+    readonly visualizationQuality: VisualizationQuality;
+    /** Composite quality score 0–100 */
+    readonly overallScore: number;
+    /** Letter grade derived from overallScore */
+    readonly grade: ArticleGrade;
+    /** Actionable improvement recommendations */
+    readonly recommendations: readonly string[];
+    /** true when overallScore ≥ 40 (Grade C or better) */
+    readonly passesQualityGate: boolean;
+}
+//# sourceMappingURL=quality.d.ts.map

package/scripts/types/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/types/quality.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;IAC1C,wEAAwE;IACxE,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC5C,oEAAoE;IACpE,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,qEAAqE;IACrE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,+EAA+E;IAC/E,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAID;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,oFAAoF;IACpF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,iDAAiD;IACjD,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,sEAAsE;IACtE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4GAA4G;IAC5G,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,sCAAsC;IACtC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAC3C,sCAAsC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,uCAAuC;IACvC,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,sDAAsD;IACtD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC"}

package/scripts/types/quality.js

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

package/scripts/types/quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.js","sourceRoot":"","sources":["../../src/types/quality.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,sCAAsC"}

package/scripts/types/stakeholder.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @module Types/Stakeholder
+ * @description Multi-stakeholder perspective types for the enhanced political
+ * analysis engine. These types model how parliamentary actions affect each
+ * major stakeholder group and support iterative multi-pass analysis.
+ */
+/**
+ * The six major stakeholder groups that are assessed for every parliamentary action.
+ * - **political_groups**: EP political groups and their electoral blocs
+ * - **civil_society**: NGOs, advocacy organisations, think-tanks
+ * - **industry**: Business associations, trade bodies, chambers of commerce
+ * - **national_govts**: Member state governments and their ministries
+ * - **citizens**: EU citizens in general; voters and rights-holders
+ * - **eu_institutions**: Commission, Council, Court of Justice, ECB etc.
+ */
+export type AnalysisStakeholderType = 'political_groups' | 'civil_society' | 'industry' | 'national_govts' | 'citizens' | 'eu_institutions';
+/**
+ * Stable iteration order for all six stakeholder types.
+ * Use this constant in any code that needs to iterate over all groups
+ * to avoid duplicating the list in multiple files.
+ */
+export declare const ALL_STAKEHOLDER_TYPES: readonly AnalysisStakeholderType[];
+/**
+ * The direction of impact on a stakeholder group.
+ * - **positive**: The action clearly benefits the stakeholder
+ * - **negative**: The action clearly harms or disadvantages the stakeholder
+ * - **neutral**: The action has no material effect
+ * - **mixed**: The action has both positive and negative consequences
+ */
+export type StakeholderImpact = 'positive' | 'negative' | 'neutral' | 'mixed';
+/**
+ * How important the impact is for the stakeholder group.
+ */
+export type StakeholderSeverity = 'high' | 'medium' | 'low';
+/**
+ * A detailed perspective on how a parliamentary action affects one
+ * specific stakeholder group. Used in multi-stakeholder analysis to
+ * map every action to its full range of societal consequences.
+ */
+export interface StakeholderPerspective {
+    /** Which stakeholder group this perspective describes */
+    readonly stakeholder: AnalysisStakeholderType;
+    /** Direction of the impact on this stakeholder */
+    readonly impact: StakeholderImpact;
+    /** Magnitude of the impact */
+    readonly severity: StakeholderSeverity;
+    /** Human-readable reasoning explaining the impact */
+    readonly reasoning: string;
+    /** Evidence strings supporting the reasoning (data points, text references) */
+    readonly evidence: readonly string[];
+}
+/**
+ * Identifies which analysis pass produced a finding.
+ * Mirrors the four-pass iterative refinement flow:
+ * 1. `initial` — Baseline assessment from MCP data
+ * 2. `stakeholder_challenge` — How each group's interests are affected
+ * 3. `cross_perspective` — Conflicts and alignments across groups
+ * 4. `final_refinement` — Balanced evidence-based conclusions
+ */
+export type AnalysisIterationType = 'initial' | 'stakeholder_challenge' | 'cross_perspective' | 'final_refinement';
+/**
+ * A single pass in the iterative multi-pass analysis cycle.
+ * Captures the intermediate thinking at each stage of refinement.
+ */
+export interface AnalysisIteration {
+    /** Which pass number this is (1–4) */
+    readonly pass: number;
+    /** The type of analysis pass */
+    readonly type: AnalysisIterationType;
+    /** Short summary of what this pass adds or changes */
+    readonly summary: string;
+    /** Key findings produced in this pass */
+    readonly findings: readonly string[];
+}
+/**
+ * A row in the stakeholder outcome matrix: one parliamentary action mapped
+ * to an outcome (winner / loser / neutral) for each of the six stakeholder
+ * groups, plus a confidence rating.
+ */
+export interface StakeholderOutcomeMatrix {
+    /** The parliamentary action being assessed */
+    readonly action: string;
+    /** How each stakeholder group fares as a result of the action */
+    readonly outcomes: Readonly<Record<AnalysisStakeholderType, 'winner' | 'loser' | 'neutral'>>;
+    /** Confidence in the outcome assessments */
+    readonly confidence: 'high' | 'medium' | 'low';
+}
+//# sourceMappingURL=stakeholder.d.ts.map

package/scripts/types/stakeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stakeholder.d.ts","sourceRoot":"","sources":["../../src/types/stakeholder.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,UAAU,GACV,iBAAiB,CAAC;AAEtB;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,uBAAuB,EAOnE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,uBAAuB,GACvB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,uBAAuB,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;IAC7F,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CAChD"}

package/scripts/types/stakeholder.js

@@ -0,0 +1,16 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Stable iteration order for all six stakeholder types.
+ * Use this constant in any code that needs to iterate over all groups
+ * to avoid duplicating the list in multiple files.
+ */
+export const ALL_STAKEHOLDER_TYPES = [
+    'political_groups',
+    'civil_society',
+    'industry',
+    'national_govts',
+    'citizens',
+    'eu_institutions',
+];
+//# sourceMappingURL=stakeholder.js.map

package/scripts/types/stakeholder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stakeholder.js","sourceRoot":"","sources":["../../src/types/stakeholder.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,sCAAsC;AA0BtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAuC;IACvE,kBAAkB;IAClB,eAAe;IACf,UAAU;IACV,gBAAgB;IAChB,UAAU;IACV,iBAAiB;CAClB,CAAC"}