riksdagsmonitor 0.8.60 → 0.8.62

package/dist/lib/cia/csv-utils.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @module CIA/CSVUtils
+ * @category Intelligence Platform - Data Acquisition & Pipeline Management
+ *
+ * @description
+ * CSV parsing and HTTP loading helpers for the CIA data pipeline.
+ *
+ * Originally lived as private/public methods on `CIADataLoader`; extracted as
+ * free functions so each per-domain loader (`loaders/*.ts`) can use them
+ * directly without instantiating the orchestrator class. Mockable in tests
+ * by stubbing `globalThis.fetch`.
+ *
+ * @author Hack23 AB - Data Pipeline Engineering
+ * @license Apache-2.0
+ * @since 2026
+ */
+import type { CSVRow } from './types.js';
+/** Signature used by per-domain loaders to fetch and parse a single CSV. */
+export type LoadCSV = (localPath: string, fallbackPath?: string) => Promise<CSVRow[]>;
+/**
+ * Parse CSV text into an array of header-keyed rows with auto-typed values.
+ *
+ * Handles basic quoting (`"value, with, commas"`) and converts numeric strings
+ * to numbers. Empty cells are kept as the empty string. Returns `[]` for
+ * inputs without at least a header and one data row.
+ *
+ * @param csvText - Raw CSV text
+ * @returns Parsed rows (empty array if header-only or empty)
+ */
+export declare function parseCSV(csvText: string): CSVRow[];
+/**
+ * Join a base URL with a relative path using exactly one slash between them.
+ *
+ * Tolerant of base URLs that omit the trailing slash and of paths that include
+ * a leading slash — both common foot-guns when callers concatenate URL strings
+ * by hand. Empty inputs are passed through: an empty `base` returns `path`
+ * unchanged, and an empty `path` returns `base` unchanged (useful for directory
+ * listings or when the path is computed conditionally).
+ *
+ * @param base - Base URL (with or without trailing slash); empty string returns `path` as-is
+ * @param path - Relative path (with or without leading slash); empty string returns `base` as-is
+ * @returns The two segments joined by exactly one `/`, or whichever input is non-empty when one is empty
+ */
+export declare function joinURL(base: string, path: string): string;
+/**
+ * Load a CSV with local-first fallback.
+ *
+ * Tries `joinURL(csvBaseURL, localPath)` first. If the response is non-OK or
+ * yields zero rows, falls back to `joinURL(fallbackURL, fallbackPath ?? localPath)`
+ * when a `fallbackURL` is provided. Network errors are logged as warnings
+ * rather than thrown so the page can degrade gracefully when offline.
+ *
+ * URL joining is tolerant of missing trailing slashes on the base URL and
+ * leading slashes on the path; callers do not need to worry about the slash
+ * boundary.
+ *
+ * @param csvBaseURL - Base URL for the local-first CSV directory
+ * @param fallbackURL - Optional remote fallback URL (e.g. raw.githubusercontent.com mirror); empty string disables fallback
+ * @param localPath - Path relative to `csvBaseURL`
+ * @param fallbackPath - Optional path on the fallback host (defaults to `localPath`)
+ * @returns Parsed CSV rows; `[]` when no source returned data
+ */
+export declare function loadCSV(csvBaseURL: string, fallbackURL: string, localPath: string, fallbackPath?: string): Promise<CSVRow[]>;
+/**
+ * Build a `LoadCSV` closure bound to a `csvBaseURL` / `fallbackURL` pair.
+ *
+ * Per-domain loaders accept this closure so they can be unit-tested without
+ * any reference to the URL configuration of a specific environment.
+ *
+ * @param csvBaseURL - Base URL for the local-first CSV directory
+ * @param fallbackURL - Optional remote fallback URL (empty string disables fallback)
+ * @returns A `LoadCSV` function bound to those URLs
+ */
+export declare function createLoadCSV(csvBaseURL: string, fallbackURL?: string): LoadCSV;
+//# sourceMappingURL=csv-utils.d.ts.map

package/dist/lib/cia/csv-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-utils.d.ts","sourceRoot":"","sources":["../../../src/browser/cia/csv-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,4EAA4E;AAC5E,MAAM,MAAM,OAAO,GAAG,CACpB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,KAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEvB;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAqClD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,OAAO,CAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,SAAK,GAAG,OAAO,CAG3E"}

package/dist/lib/cia/csv-utils.js

@@ -0,0 +1,141 @@
+/**
+ * @module CIA/CSVUtils
+ * @category Intelligence Platform - Data Acquisition & Pipeline Management
+ *
+ * @description
+ * CSV parsing and HTTP loading helpers for the CIA data pipeline.
+ *
+ * Originally lived as private/public methods on `CIADataLoader`; extracted as
+ * free functions so each per-domain loader (`loaders/*.ts`) can use them
+ * directly without instantiating the orchestrator class. Mockable in tests
+ * by stubbing `globalThis.fetch`.
+ *
+ * @author Hack23 AB - Data Pipeline Engineering
+ * @license Apache-2.0
+ * @since 2026
+ */
+/**
+ * Parse CSV text into an array of header-keyed rows with auto-typed values.
+ *
+ * Handles basic quoting (`"value, with, commas"`) and converts numeric strings
+ * to numbers. Empty cells are kept as the empty string. Returns `[]` for
+ * inputs without at least a header and one data row.
+ *
+ * @param csvText - Raw CSV text
+ * @returns Parsed rows (empty array if header-only or empty)
+ */
+export function parseCSV(csvText) {
+    const lines = csvText.trim().split('\n');
+    if (lines.length < 2)
+        return [];
+    const headers = lines[0].split(',').map(h => h.trim().replace(/^"|"$/g, ''));
+    const rows = [];
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        // Simple CSV parsing (handles basic quoting)
+        const values = [];
+        let current = '';
+        let inQuotes = false;
+        for (let j = 0; j < line.length; j++) {
+            const ch = line[j];
+            if (ch === '"') {
+                inQuotes = !inQuotes;
+            }
+            else if (ch === ',' && !inQuotes) {
+                values.push(current.trim());
+                current = '';
+            }
+            else {
+                current += ch;
+            }
+        }
+        values.push(current.trim());
+        const row = {};
+        headers.forEach((h, idx) => {
+            const val = values[idx] || '';
+            const num = Number(val);
+            row[h] = val !== '' && !isNaN(num) ? num : val;
+        });
+        rows.push(row);
+    }
+    return rows;
+}
+/**
+ * Join a base URL with a relative path using exactly one slash between them.
+ *
+ * Tolerant of base URLs that omit the trailing slash and of paths that include
+ * a leading slash — both common foot-guns when callers concatenate URL strings
+ * by hand. Empty inputs are passed through: an empty `base` returns `path`
+ * unchanged, and an empty `path` returns `base` unchanged (useful for directory
+ * listings or when the path is computed conditionally).
+ *
+ * @param base - Base URL (with or without trailing slash); empty string returns `path` as-is
+ * @param path - Relative path (with or without leading slash); empty string returns `base` as-is
+ * @returns The two segments joined by exactly one `/`, or whichever input is non-empty when one is empty
+ */
+export function joinURL(base, path) {
+    if (!base)
+        return path;
+    if (!path)
+        return base;
+    const trimmedBase = base.replace(/\/+$/, '');
+    const trimmedPath = path.replace(/^\/+/, '');
+    return `${trimmedBase}/${trimmedPath}`;
+}
+/**
+ * Load a CSV with local-first fallback.
+ *
+ * Tries `joinURL(csvBaseURL, localPath)` first. If the response is non-OK or
+ * yields zero rows, falls back to `joinURL(fallbackURL, fallbackPath ?? localPath)`
+ * when a `fallbackURL` is provided. Network errors are logged as warnings
+ * rather than thrown so the page can degrade gracefully when offline.
+ *
+ * URL joining is tolerant of missing trailing slashes on the base URL and
+ * leading slashes on the path; callers do not need to worry about the slash
+ * boundary.
+ *
+ * @param csvBaseURL - Base URL for the local-first CSV directory
+ * @param fallbackURL - Optional remote fallback URL (e.g. raw.githubusercontent.com mirror); empty string disables fallback
+ * @param localPath - Path relative to `csvBaseURL`
+ * @param fallbackPath - Optional path on the fallback host (defaults to `localPath`)
+ * @returns Parsed CSV rows; `[]` when no source returned data
+ */
+export async function loadCSV(csvBaseURL, fallbackURL, localPath, fallbackPath) {
+    const urls = [joinURL(csvBaseURL, localPath)];
+    if (fallbackURL) {
+        urls.push(joinURL(fallbackURL, fallbackPath ?? localPath));
+    }
+    for (const url of urls) {
+        try {
+            const response = await fetch(url);
+            if (!response.ok)
+                continue;
+            const text = await response.text();
+            const rows = parseCSV(text);
+            if (rows.length > 0)
+                return rows;
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            console.warn(`Failed to load CSV from ${url}:`, message);
+        }
+    }
+    console.warn(`No data loaded for ${localPath}`);
+    return [];
+}
+/**
+ * Build a `LoadCSV` closure bound to a `csvBaseURL` / `fallbackURL` pair.
+ *
+ * Per-domain loaders accept this closure so they can be unit-tested without
+ * any reference to the URL configuration of a specific environment.
+ *
+ * @param csvBaseURL - Base URL for the local-first CSV directory
+ * @param fallbackURL - Optional remote fallback URL (empty string disables fallback)
+ * @returns A `LoadCSV` function bound to those URLs
+ */
+export function createLoadCSV(csvBaseURL, fallbackURL = '') {
+    return (localPath, fallbackPath) => loadCSV(csvBaseURL, fallbackURL, localPath, fallbackPath);
+}
+//# sourceMappingURL=csv-utils.js.map

package/dist/lib/cia/csv-utils.js.map

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

package/dist/lib/cia/data-loader.d.ts

@@ -4,340 +4,54 @@
  *
  * @description
  * CIA Intelligence Data Loader & Pipeline Orchestrator.
- * Core data acquisition module implementing multi-source intelligence data loading
- * from the Citizen Intelligence Agency (CIA) Platform. Manages CSV export ingestion
- * for 19+ intelligence product categories and JSON fallback for model-generated
- * electoral forecasts. Provides resilient data pipeline with local-first strategy
- * and remote fallback capabilities.
+ *
+ * Thin orchestrator that wires together the per-domain loaders in `loaders/`
+ * with a single `LoadCSV` closure built from `csvBaseURL` + `fallbackURL`.
+ * Public API (constructor, static `CSV_SOURCES`, `parseCSV`, `loadCSV`,
+ * `load*()` methods, `loadAll`) is preserved for existing consumers
+ * (`dashboard-init.ts`, `election-predictions.ts`, `visualizations.ts`).
+ *
+ * Was originally a 1 300-line monolith; decomposed into focused modules:
+ *   - `types.ts`   — DTO interfaces
+ *   - `sources.ts` — CSV source URL inventory + Riksdag constants
+ *   - `csv-utils.ts` — `parseCSV` / `loadCSV` helpers
+ *   - `loaders/*.ts` — one file per domain (10 loaders)
  *
  * @author Hack23 AB - Data Pipeline Engineering
  * @license Apache-2.0
- * @version 2.0.0
+ * @version 3.0.0
  * @since 2024
-
  *
  * @intelligence CIA Platform Data Pipeline Orchestrator — core data acquisition module implementing multi-source intelligence data loading from 19+ CIA product categories. Manages CSV export ingestion and JSON fallback for electoral forecasts. Provides resilient pipeline with local-first strategy and remote fallback.
  *
  * @business Data infrastructure investment — the CIA data pipeline is the foundation for all analytical products. Pipeline reliability directly impacts user experience and platform credibility. Modular architecture enables future data source expansion (European Parliament, Nordic councils).
  *
  * @marketing Data transparency asset — transparent data sourcing (CIA Platform, open government data) builds trust with all audience segments. Data pipeline documentation demonstrates commitment to accuracy and verifiability, key messaging for press and academic audiences.
- * */
-/** Definition for a single CSV data source mapping. */
-export interface CSVSourceDefinition {
-    /** Relative path within the csvBaseURL directory. */
-    local: string;
-    /** Human-readable description of the data product. */
-    description: string;
-}
-/** Map of all known CSV source categories. */
-export interface CSVSourceMap {
-    personStatus: CSVSourceDefinition;
-    riskByParty: CSVSourceDefinition;
-    riskLevels: CSVSourceDefinition;
-    annualBallots: CSVSourceDefinition;
-    crisisResilience: CSVSourceDefinition;
-    partyPerformance: CSVSourceDefinition;
-    partyMetrics: CSVSourceDefinition;
-    partyMomentum: CSVSourceDefinition;
-    partyMembers: CSVSourceDefinition;
-    influenceMetrics: CSVSourceDefinition;
-    riskSummary: CSVSourceDefinition;
-    committeeProductivity: CSVSourceDefinition;
-    committeeActivity: CSVSourceDefinition;
-    partyEffectiveness: CSVSourceDefinition;
-    electionForecast: CSVSourceDefinition;
-    coalitionScenarios: CSVSourceDefinition;
-    coalitionAlignment: CSVSourceDefinition;
-    genderByParty: CSVSourceDefinition;
-    experienceByParty: CSVSourceDefinition;
-    ministryEffectiveness: CSVSourceDefinition;
-    annualDocTypes: CSVSourceDefinition;
-    decisionTrends: CSVSourceDefinition;
-    electionRegions: CSVSourceDefinition;
-    governmentRoles: CSVSourceDefinition;
-    riskEvolution: CSVSourceDefinition;
-    behavioralPatterns: CSVSourceDefinition;
-}
-/** A single parsed CSV row (header-keyed, auto-typed values). */
-export interface CSVRow {
-    [key: string]: string | number;
-}
-export interface KeyMetrics {
-    totalMPs: number;
-    totalParties: number;
-    totalRiskRules: number;
-    governmentCoalition: string;
-    coalitionSeats: number;
-    oppositionSeats: number;
-    majorityMargin: number;
-}
-export interface RiskAlerts {
-    critical: number;
-    major: number;
-    minor: number;
-    last90Days: {
-        critical: number;
-        major: number;
-        minor: number;
-    };
-}
-export interface ParliamentActivity {
-    votesLastMonth: number;
-    documentsProcessed: number;
-    motionsSubmitted: number;
-    committeeMeetings: number;
-}
-export interface CoalitionStability {
-    stabilityScore: number;
-    riskLevel: string;
-    defectionProbability: number;
-    ideologicalTension: string;
-}
-export interface DataQuality {
-    completeness: number;
-    lastDataSync: string;
-    coverage: string;
-}
-export interface OverviewDashboard {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    keyMetrics: KeyMetrics;
-    riskAlerts: RiskAlerts;
-    parliamentActivity: ParliamentActivity;
-    coalitionStability: CoalitionStability;
-    dataQuality: DataQuality;
-    _source: string;
-}
-export interface PartyMetricsData {
-    seats: number;
-    voteShare: number;
-    memberCount: number;
-    documentsAuthored: number;
-    motionsSubmitted: number;
-    successRate: number;
-}
-export interface PartyVoting {
-    totalVotes: number;
-    cohesionScore: number;
-    rebellionRate: number;
-}
-export interface PartyTrends {
-    supportTrend: string;
-    activityTrend: string;
-    performanceLevel: string;
-}
-export interface PartyEntry {
-    id: string;
-    partyName: string;
-    shortName: string;
-    metrics: PartyMetricsData;
-    voting: PartyVoting;
-    trends: PartyTrends;
-    _source: string;
-}
-export interface PartyPerformance {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    parties: PartyEntry[];
-    _source: string;
-}
-export interface MPRanking {
-    rank: number;
-    id: string;
-    firstName: string;
-    lastName: string;
-    party: string;
-    role: string;
-    influenceScore: number;
-    networkConnections: number;
-    brokerClassification: string;
-    riskLevel: string;
-    riskScore: number;
-    _source: string;
-}
-export interface Top10Influential {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    methodology: string;
-    rankings: MPRanking[];
-    _source: string;
-}
-export interface CommitteeEntry {
-    id: string;
-    name: string;
-    memberCount: number;
-    influenceScore: number;
-    documentsProcessed: number;
-    productivityLevel: string;
-    meetingsPerYear: number;
-    keyIssues: string[];
-    _source: string;
-}
-export interface NetworkNode {
-    id: string;
-    name: string;
-    size: number;
-}
-export interface NetworkEdge {
-    source: string;
-    target: string;
-    weight: number;
-    type: string;
-}
-export interface CommitteeNetwork {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    committees: CommitteeEntry[];
-    networkGraph: {
-        nodes: NetworkNode[];
-        edges: NetworkEdge[];
-    };
-    crossCommitteeMPs: unknown[];
-    _source: string;
-}
-export interface VotingMatrix {
-    labels: string[];
-    partyNames: string[];
-    agreementMatrix: number[][];
-}
-export interface RebellionEntry {
-    party: string;
-    rebellionRate: number;
-    trend: string;
-}
-export interface VotingPatterns {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    analysisPeriod: string;
-    votingMatrix: VotingMatrix;
-    keyIssues: unknown[];
-    rebellionTracking: RebellionEntry[];
-    _source: string;
-}
-export interface ElectionAnalysis {
-    forecast: {
-        parties: Array<{
-            name: string;
-            currentSeats: number;
-            predictedSeats: number;
-            change: number;
-            voteShare: number;
-            confidenceInterval?: {
-                min: number;
-                max: number;
-            };
-        }>;
-    };
-    coalitionScenarios: Array<{
-        name: string;
-        composition: string[];
-        totalSeats: number;
-        probability: number;
-        majority: boolean;
-        riskLevel: string;
-    }>;
-    keyFactors: string[];
-    electionDate?: string;
-}
-export interface MinistryEntry {
-    name: string;
-    effectiveness: string;
-    documentsProduced: number;
-    governmentBills: number;
-    year: number;
-    quarter: number;
-}
-export interface MinistryDashboard {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    ministries: MinistryEntry[];
-    _source: string;
-}
-export interface GenderEntry {
-    party: string;
-    gender: string;
-    count: number;
-}
-export interface ExperienceEntry {
-    party: string;
-    experienceLevel: string;
-    politicianCount: number;
-}
-export interface DemographicsDashboard {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    genderByParty: GenderEntry[];
-    experienceByParty: ExperienceEntry[];
-    _source: string;
-}
-export interface DocumentTypeEntry {
-    year: number;
-    documentType: string;
-    docCount: number;
-}
-export interface DecisionTrendEntry {
-    year: number;
-    month: number;
-    decisionCount: number;
-    approvedDecisions: number;
-    rejectedDecisions: number;
-    approvalRate: number;
-}
-export interface DocumentActivityDashboard {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    documentTypes: DocumentTypeEntry[];
-    decisionTrends: DecisionTrendEntry[];
-    _source: string;
-}
-export interface RiskEvolutionEntry {
-    period: string;
-    severity: string;
-    politicianCount: number;
-    avgRiskScore: number;
-}
-export interface RiskEvolutionDashboard {
-    title: string;
-    description: string;
-    lastUpdated: string;
-    entries: RiskEvolutionEntry[];
-    _source: string;
-}
-export interface CIADataPayload {
-    overview: OverviewDashboard;
-    election: ElectionAnalysis;
-    partyPerf: PartyPerformance;
-    top10: Top10Influential;
-    committees: CommitteeNetwork;
-    votingPatterns: VotingPatterns;
-    ministry: MinistryDashboard;
-    demographics: DemographicsDashboard;
-    documentActivity: DocumentActivityDashboard;
-    riskEvolution: RiskEvolutionDashboard;
-}
+ */
+import type { CIADataPayload, CSVRow, CSVSourceMap, CommitteeNetwork, DemographicsDashboard, DocumentActivityDashboard, ElectionAnalysis, MinistryDashboard, OverviewDashboard, PartyPerformance, RiskEvolutionDashboard, Top10Influential, VotingPatterns } from './types.js';
+export type * from './types.js';
+/**
+ * Aggregator that delegates per-domain loading to the dedicated modules in
+ * `loaders/`. Maintains the original public API so existing callers compile
+ * unchanged after the decomposition refactor.
+ */
 export declare class CIADataLoader {
     readonly csvBaseURL: string;
     readonly fallbackURL: string;
     /** The 8 parties represented in the Swedish Riksdag. */
-    static readonly RIKSDAG_PARTIES: string[];
+    static readonly RIKSDAG_PARTIES: readonly string[];
     /** Mapping of full Swedish committee names to their Riksdag org codes. */
-    static readonly COMMITTEE_ORG_CODES: Record<string, string>;
+    static readonly COMMITTEE_ORG_CODES: Readonly<Record<string, string>>;
     /**
      * Heuristic divisor to estimate meetings/year from committee document counts.
      * Assumption: ~25 published documents per active committee meeting.
      */
     static readonly COMMITTEE_DOCS_PER_MEETING_ESTIMATE = 25;
-    constructor();
     /** CSV data source definitions – maps to real PostgreSQL view exports. */
-    static CSV_SOURCES: CSVSourceMap;
+    static readonly CSV_SOURCES: Readonly<CSVSourceMap>;
+    /** Loader closure bound to this instance's URL configuration. */
+    private readonly loadCSVFn;
+    constructor();
     /**
      * Parse CSV text into array of objects using header row as keys.
      * @param csvText - Raw CSV text
@@ -351,53 +65,29 @@ export declare class CIADataLoader {
      * @returns Parsed CSV rows
      */
     loadCSV(localPath: string, fallbackPath?: string): Promise<CSVRow[]>;
-    /**
-     * Build overview dashboard from CSV sources.
-     * Replaces overview-dashboard.json.
-     */
+    /** Build overview dashboard from CSV sources. Replaces overview-dashboard.json. */
     loadOverviewDashboard(): Promise<OverviewDashboard>;
-    /**
-     * Build election analysis from CSV sources.
-     * Replaces election-analysis.json.
-     */
+    /** Build election analysis from CSV sources. Replaces election-analysis.json. */
     loadElectionAnalysis(): Promise<ElectionAnalysis>;
-    /**
-     * Build party performance from CSV sources.
-     * Replaces party-performance.json.
-     */
+    /** Build party performance from CSV sources. Replaces party-performance.json. */
     loadPartyPerformance(): Promise<PartyPerformance>;
-    /**
-     * Build top 10 influential MPs from CSV sources.
-     * Replaces top10-influential-mps.json.
-     */
+    /** Build top 10 influential MPs from CSV sources. Replaces top10-influential-mps.json. */
     loadTop10Influential(): Promise<Top10Influential>;
-    /**
-     * Build committee network from CSV sources.
-     * Replaces committee-network.json.
-     * Filters out INACTIVE committees and deduplicates by name.
-     */
+    /** Build committee network from CSV sources. Replaces committee-network.json. */
     loadCommitteeNetwork(): Promise<CommitteeNetwork>;
     /**
      * Build voting patterns from CSV sources.
-     * Uses real coalition alignment data for the agreement matrix
-     * and party effectiveness trends for win rates.
+     * Uses real coalition alignment data for the agreement matrix when present;
+     * otherwise falls back to win-rate similarity.
      */
     loadVotingPatterns(): Promise<VotingPatterns>;
-    /**
-     * Build ministry dashboard from CSV sources.
-     */
+    /** Build ministry dashboard from CSV sources. */
     loadMinistryDashboard(): Promise<MinistryDashboard>;
-    /**
-     * Build demographics dashboard from CSV sources.
-     */
+    /** Build demographics dashboard from CSV sources. */
     loadDemographics(): Promise<DemographicsDashboard>;
-    /**
-     * Build document activity dashboard from CSV sources.
-     */
+    /** Build document activity dashboard from CSV sources. */
     loadDocumentActivity(): Promise<DocumentActivityDashboard>;
-    /**
-     * Build risk evolution dashboard from CSV sources.
-     */
+    /** Build risk evolution dashboard from CSV sources. */
     loadRiskEvolution(): Promise<RiskEvolutionDashboard>;
     /**
      * Load all data in parallel.