riksdagsmonitor 0.8.12 → 0.8.15

package/dist/scripts/ai-analysis/coalition-detector.js

@@ -0,0 +1,242 @@
+/**
+ * @module ai-analysis/coalition-detector
+ * @description Heuristic-based coalition tension estimator using document-type mix for the AI analysis pipeline.
+ *
+ * Analyses the composition of a document set by classifying documents into
+ * government-aligned types (e.g. propositions, laws, government communications)
+ * and opposition challenge types (e.g. motions, interpellations) based solely
+ * on their document type codes. Tension is derived from the ratio of
+ * opposition challenge documents to all political documents (government +
+ * opposition; committee reports excluded).
+ *
+ * This is a coarse document-type-based heuristic and does not use party or
+ * member-level metadata to model individual parties, coalitions, or detailed
+ * convergence/divergence patterns.
+ *
+ * Implements the `CoalitionTensionDetector` interface so it can be swapped
+ * for a higher-fidelity, possibly LLM-backed implementation in the future.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+// ---------------------------------------------------------------------------
+// Document classification helpers
+// ---------------------------------------------------------------------------
+/**
+ * Normalise document type string for comparison.
+ *
+ * Precedence (aligned with pipeline.normalizedDocType / pipeline.docType):
+ *  1. `doktyp` — the primary Riksdag document-type code
+ *  2. `documentType` — alternative type string used in some data sources
+ *  3. SFS-by-name — inferred from `dokumentnamn`, `titel`, or `title`
+ *     prefix when both type fields are empty
+ *
+ * Keeping the same order avoids classification divergence between the
+ * coalition detector and the main pipeline.
+ */
+function docType(d) {
+    // 1. Prefer explicit doktyp when present
+    if (d.doktyp && d.doktyp.trim() !== '') {
+        return d.doktyp.toLowerCase().trim();
+    }
+    // 2. Fall back to documentType (mirrors pipeline.docType precedence)
+    if (d.documentType && d.documentType.trim() !== '') {
+        return d.documentType.toLowerCase().trim();
+    }
+    // 3. Infer SFS from document name fields (mirrors pipeline.isSfsDoc)
+    const nameFallback = d.dokumentnamn ?? d.titel ?? d.title ?? '';
+    if (nameFallback.toUpperCase().startsWith('SFS')) {
+        return 'sfs';
+    }
+    return '';
+}
+/** Extract document ID, falling back to URL for documents without dok_id. */
+function docId(d) {
+    return d.dok_id ?? d.url ?? '';
+}
+/** Government-aligned document types (propositions, laws, govt comms, press releases, SOU, departmental series, directives). */
+const GOVERNMENT_DOC_TYPES = new Set(['prop', 'sfs', 'skr', 'pressm', 'ds', 'sou', 'dir']);
+/** Opposition challenge document types (motions, interpellations). */
+const OPPOSITION_DOC_TYPES = new Set(['mot', 'ip']);
+const STRESS_NEUTRAL = {
+    en: 'The document set contains only neutral items (e.g. committee reports) — coalition tension cannot be assessed from this evidence.',
+    sv: 'Dokumentuppsättningen innehåller endast neutrala handlingar (t.ex. utskottsbetänkanden) — koalitionsspänning kan inte bedömas utifrån detta underlag.',
+    da: 'Dokumentsættet indeholder kun neutrale dokumenter (f.eks. udvalgsbetænkninger) — koalitionsspænding kan ikke vurderes ud fra dette materiale.',
+    no: 'Dokumentsettet inneholder bare nøytrale dokumenter (f.eks. komitéinnstillinger) — koalisjonsspenning kan ikke vurderes ut fra dette materialet.',
+    fi: 'Asiakirjajoukko sisältää vain neutraaleja asiakirjoja (esim. valiokuntamietintöjä) — koalition jännitteitä ei voida arvioida tämän aineiston perusteella.',
+    de: 'Der Dokumentensatz enthält nur neutrale Unterlagen (z.\u00A0B. Ausschussberichte) — die Koalitionsspannung lässt sich anhand dieses Materials nicht beurteilen.',
+    fr: 'L\'ensemble de documents ne contient que des documents neutres (par ex. rapports de commission) — la tension de coalition ne peut pas être évaluée à partir de ces éléments.',
+    es: 'El conjunto de documentos solo contiene elementos neutrales (p.\u00A0ej. informes de comisión) — la tensión de coalición no puede evaluarse a partir de esta evidencia.',
+    nl: 'De documentset bevat alleen neutrale stukken (bijv. commissierapporten) — coalitiespanning kan op basis hiervan niet worden beoordeeld.',
+    ar: 'تحتوي مجموعة الوثائق على عناصر محايدة فقط (مثل تقارير اللجان) — لا يمكن تقييم التوتر الائتلافي بناءً على هذا الدليل.',
+    he: 'קבוצת המסמכים מכילה פריטים ניטרליים בלבד (למשל דוחות ועדה) — לא ניתן להעריך מתח קואליציוני על סמך ראיות אלה.',
+    ja: '文書セットには中立的な項目（委員会報告書など）のみが含まれています — この証拠からは連立の緊張度を評価できません。',
+    ko: '문서 세트에 중립 항목(위원회 보고서 등)만 포함되어 있습니다 — 이 증거로는 연립 긴장도를 평가할 수 없습니다.',
+    zh: '文件集仅包含中立项目（如委员会报告）— 无法根据此证据评估联盟紧张度。',
+};
+const STRESS_LOW = {
+    en: 'Low coalition tension — government output dominates with limited opposition challenge.',
+    sv: 'Låg koalitionsspänning — regeringens produktion dominerar med begränsad oppositionsutmaning.',
+    da: 'Lav koalitionsspænding — regeringsproduktionen dominerer med begrænset oppositionsudfordring.',
+    no: 'Lav koalisjonsspenning — regjeringens produksjon dominerer med begrenset opposisjonsutfordring.',
+    fi: 'Matala koalitiojännite — hallituksen tuotanto hallitsee rajallisella opposition haasteella.',
+    de: 'Geringe Koalitionsspannung — die Regierungsproduktion dominiert bei begrenzter Oppositionsherausforderung.',
+    fr: 'Faible tension de coalition — la production gouvernementale domine avec un défi d\'opposition limité.',
+    es: 'Baja tensión de coalición — la producción gubernamental domina con desafío opositor limitado.',
+    nl: 'Lage coalitiespanning — de regeringsproductie domineert met beperkte oppositie-uitdaging.',
+    ar: 'توتر ائتلافي منخفض — إنتاج الحكومة يهيمن مع تحدٍ محدود من المعارضة.',
+    he: 'מתח קואליציוני נמוך — תפוקת הממשלה שולטת עם אתגר אופוזיציוני מוגבל.',
+    ja: '連立の緊張度 低 — 政府の生産が支配的で、野党の挑戦は限定的。',
+    ko: '연립 긴장도 낮음 — 정부 산출이 지배적이며 야당의 도전이 제한적.',
+    zh: '联盟紧张度低 — 政府产出占主导地位，反对派挑战有限。',
+};
+const STRESS_MEDIUM = {
+    en: 'Moderate coalition tension — significant opposition activity through motions and interpellations.',
+    sv: 'Måttlig koalitionsspänning — betydande oppositionsaktivitet genom motioner och interpellationer.',
+    da: 'Moderat koalitionsspænding — betydelig oppositionsaktivitet gennem beslutningsforslag og interpellationer.',
+    no: 'Moderat koalisjonsspenning — betydelig opposisjonsaktivitet gjennom forslag og interpellasjoner.',
+    fi: 'Kohtalainen koalitiojännite — merkittävää oppositioaktiviteettia aloitteiden ja välikysymysten kautta.',
+    de: 'Mäßige Koalitionsspannung — bedeutende Oppositionsaktivität durch Anträge und Interpellationen.',
+    fr: 'Tension de coalition modérée — activité d\'opposition significative par motions et interpellations.',
+    es: 'Tensión de coalición moderada — actividad opositora significativa mediante mociones e interpelaciones.',
+    nl: 'Matige coalitiespanning — aanzienlijke oppositieactiviteit door moties en interpellaties.',
+    ar: 'توتر ائتلافي معتدل — نشاط معارض كبير من خلال الاقتراحات والاستجوابات.',
+    he: 'מתח קואליציוני בינוני — פעילות אופוזיציונית משמעותית באמצעות הצעות ושאילתות.',
+    ja: '連立の緊張度 中 — 動議と質問を通じた野党の顕著な活動。',
+    ko: '연립 긴장도 보통 — 동의안과 질의를 통한 상당한 야당 활동.',
+    zh: '联盟紧张度中等 — 反对派通过动议和质询展开重大活动。',
+};
+const STRESS_HIGH = {
+    en: 'High coalition tension — opposition challenges outpace government output, signalling policy contestation.',
+    sv: 'Hög koalitionsspänning — oppositionens utmaningar överträffar regeringens produktion, vilket signalerar politisk konfrontation.',
+    da: 'Høj koalitionsspænding — oppositionens udfordringer overgår regeringsproduktionen, hvilket signalerer politisk konfrontation.',
+    no: 'Høy koalisjonsspenning — opposisjonens utfordringer overgår regjeringens produksjon, noe som signaliserer politisk konfrontasjon.',
+    fi: 'Korkea koalitiojännite — opposition haasteet ylittävät hallituksen tuotannon, mikä viestii poliittisesta kiistasta.',
+    de: 'Hohe Koalitionsspannung — die Herausforderungen der Opposition übersteigen die Regierungsproduktion und signalisieren politische Konfrontation.',
+    fr: 'Haute tension de coalition — les défis de l\'opposition dépassent la production gouvernementale, signalant une contestation politique.',
+    es: 'Alta tensión de coalición — los desafíos de la oposición superan la producción gubernamental, señalando contestación política.',
+    nl: 'Hoge coalitiespanning — oppositie-uitdagingen overtreffen de regeringsproductie, wat wijst op politieke confrontatie.',
+    ar: 'توتر ائتلافي مرتفع — تحديات المعارضة تفوق إنتاج الحكومة، مما يشير إلى مواجهة سياسية.',
+    he: 'מתח קואליציוני גבוה — אתגרי האופוזיציה עולים על תפוקת הממשלה, מה שמסמן עימות מדיני.',
+    ja: '連立の緊張度 高 — 野党の挑戦が政府の生産を上回り、政策上の争いを示唆。',
+    ko: '연립 긴장도 높음 — 야당의 도전이 정부 산출을 앞서며 정책 논쟁을 시사.',
+    zh: '联盟紧张度高 — 反对派挑战超越政府产出，表明政策争议。',
+};
+// ---------------------------------------------------------------------------
+// Heuristic implementation
+// ---------------------------------------------------------------------------
+/**
+ * Determine coalition stress level from the challenge ratio.
+ * - low:    challengeRatio < 0.3
+ * - medium: 0.3 ≤ challengeRatio < 0.6
+ * - high:   challengeRatio ≥ 0.6
+ *
+ * When ≥5 interpellations are present, stress is bumped by one level
+ * (low→medium, medium→high) to reflect ministerial accountability pressure.
+ */
+function classifyStress(challengeRatio, ipCount) {
+    const ipBoost = ipCount >= 5;
+    // Base level from challenge ratio alone
+    let level;
+    if (challengeRatio >= 0.6) {
+        level = 'high';
+    }
+    else if (challengeRatio >= 0.3) {
+        level = 'medium';
+    }
+    else {
+        level = 'low';
+    }
+    // Apply one-level bump if interpellations are high and we are below 'high'
+    if (ipBoost && level !== 'high') {
+        level = level === 'low' ? 'medium' : 'high';
+    }
+    return level;
+}
+function narrativeForStress(level, lang) {
+    switch (level) {
+        case 'high': return STRESS_HIGH[lang] ?? STRESS_HIGH.en;
+        case 'medium': return STRESS_MEDIUM[lang] ?? STRESS_MEDIUM.en;
+        default: return STRESS_LOW[lang] ?? STRESS_LOW.en;
+    }
+}
+/**
+ * Heuristic coalition tension detector.
+ *
+ * Classifies coalition stress from the distribution of government vs.
+ * opposition documents, using the challenge ratio (opposition docs / total)
+ * and interpellation count as primary signals.
+ */
+function detectCoalitionTension(docs, lang) {
+    if (docs.length === 0) {
+        return {
+            stressLevel: 'low',
+            narrative: narrativeForStress('low', lang),
+            governmentDocCount: 0,
+            oppositionDocCount: 0,
+            challengeRatio: 0,
+            sourceDocIds: [],
+        };
+    }
+    let governmentDocCount = 0;
+    let oppositionDocCount = 0;
+    let ipCount = 0;
+    const sourceDocIds = [];
+    for (const d of docs) {
+        const dt = docType(d);
+        const id = docId(d);
+        if (id)
+            sourceDocIds.push(id);
+        if (GOVERNMENT_DOC_TYPES.has(dt)) {
+            governmentDocCount++;
+        }
+        else if (OPPOSITION_DOC_TYPES.has(dt)) {
+            oppositionDocCount++;
+            if (dt === 'ip')
+                ipCount++;
+        }
+        // Committee reports (bet) are neutral and excluded from gov/opp counts
+    }
+    // Challenge ratio: opposition challenge documents divided by
+    // (government + opposition), with committee reports excluded from the denominator.
+    // Round to 2 decimals before classification so the returned ratio is always
+    // consistent with the stress level (avoids threshold ambiguity near 0.3/0.6).
+    const denominator = governmentDocCount + oppositionDocCount;
+    const challengeRatio = denominator > 0
+        ? Math.round((oppositionDocCount / denominator) * 100) / 100
+        : 0;
+    // When no government/opposition documents are present (e.g. only committee
+    // reports), the set is neutral — use a dedicated narrative rather than the
+    // generic "government output dominates" low-stress text.
+    if (denominator === 0) {
+        return {
+            stressLevel: 'low',
+            narrative: STRESS_NEUTRAL[lang] ?? STRESS_NEUTRAL.en,
+            governmentDocCount,
+            oppositionDocCount,
+            challengeRatio,
+            sourceDocIds,
+        };
+    }
+    const stressLevel = classifyStress(challengeRatio, ipCount);
+    const narrative = narrativeForStress(stressLevel, lang);
+    return {
+        stressLevel,
+        narrative,
+        governmentDocCount,
+        oppositionDocCount,
+        challengeRatio,
+        sourceDocIds,
+    };
+}
+// ---------------------------------------------------------------------------
+// Exported singleton implementing CoalitionTensionDetector
+// ---------------------------------------------------------------------------
+/**
+ * Default heuristic coalition tension detector.
+ * Swap this implementation for an LLM-backed one when ready.
+ */
+export const coalitionDetector = {
+    detect: detectCoalitionTension,
+};
+//# sourceMappingURL=coalition-detector.js.map

package/dist/scripts/ai-analysis/coalition-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalition-detector.js","sourceRoot":"","sources":["../../../scripts/ai-analysis/coalition-detector.ts"],"names":[],"mappings":"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"}

package/dist/scripts/ai-analysis/dashboard-analyzer.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @module ai-analysis/dashboard-analyzer
+ * @description AI-powered dashboard analysis for deep-inspection articles.
+ * Analyzes document content to produce structured chart configurations for
+ * multiple chart types: risk radar, stakeholder alignment (scatter), and
+ * legislative pipeline (bar). Each chart ships with an accessible data table.
+ *
+ * The analysis is deterministic — scores are derived from document keyword
+ * matching, type classification, and structural metadata rather than an
+ * external ML service. This keeps the pipeline fully offline while still
+ * producing content-aware, multi-dimensional insights.
+ *
+ * Charts conform to Chart.js 4.x conventions and are embedded as
+ * `data-chart-config` attributes (no inline scripts), consistent with the
+ * dashboard-section.ts "no inline scripts" pattern.
+ *
+ * **Supported chart types produced**:
+ * - `radar`   — Policy Risk Assessment (5 dimensions)
+ * - `scatter` — Stakeholder Alignment Matrix (influence vs. alignment)
+ * - `bar`     — Legislative Pipeline (docs per stage)
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import type { Language } from '../types/language.js';
+import type { DashboardChartConfig, DashboardTableConfig } from '../types/article.js';
+import type { RawDocument } from '../data-transformers/types.js';
+/** Extends DashboardChartConfig with AI-provenance metadata. */
+export interface AIChartConfig extends DashboardChartConfig {
+    /** Human-readable explanation of what this chart shows and how it was derived. */
+    analysisNote: string;
+    /** Description of the documents / data that informed this chart. */
+    dataSource: string;
+    /** 0–1 confidence score for this analysis (1 = high confidence). */
+    confidence: number;
+}
+/** Data quality level for the overall dashboard analysis. */
+export type DataQuality = 'high' | 'medium' | 'low';
+/** Complete result from `analyzeDashboardData()`. */
+export interface DashboardAnalysisResult {
+    /** AI-analyzed chart configurations (3 charts: radar, scatter, bar). */
+    charts: AIChartConfig[];
+    /** Accessible data tables — one per chart. */
+    tables: DashboardTableConfig[];
+    /** Human-readable narrative summary of the analysis. */
+    summary: string;
+    /** Data quality classification driven by document richness. */
+    dataQuality: DataQuality;
+}
+/**
+ * Analyze a set of parliamentary documents and produce AI-aware chart
+ * configurations for the deep-inspection dashboard.
+ *
+ * Returns exactly **three** chart + table pairs covering:
+ * 1. **Policy Risk Assessment** (radar) — five risk dimensions scored 1–10
+ * 2. **Stakeholder Alignment** (scatter) — three stakeholders on a 2D grid
+ * 3. **Legislative Pipeline** (bar) — document counts per legislative stage
+ *
+ * If `docs` is empty, all charts return minimal placeholder data so the
+ * dashboard still renders without errors.
+ *
+ * @example
+ * ```ts
+ * import { analyzeDashboardData } from './ai-analysis/dashboard-analyzer.js';
+ *
+ * const result = analyzeDashboardData(docs, 'defence policy', 'en');
+ * // result.charts  — [AIChartConfig, AIChartConfig, AIChartConfig]
+ * // result.tables  — [DashboardTableConfig × 3]
+ * // result.dataQuality — 'high' | 'medium' | 'low'
+ * ```
+ */
+export declare function analyzeDashboardData(docs: RawDocument[], topic: string | null, lang: Language | string): DashboardAnalysisResult;
+//# sourceMappingURL=dashboard-analyzer.d.ts.map

package/dist/scripts/ai-analysis/dashboard-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-analyzer.d.ts","sourceRoot":"","sources":["../../../scripts/ai-analysis/dashboard-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EAGrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAMjE,gEAAgE;AAChE,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpD,qDAAqD;AACrD,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,8CAA8C;IAC9C,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,WAAW,EAAE,WAAW,CAAC;CAC1B;AA+fD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EAAE,EACnB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,QAAQ,GAAG,MAAM,GACtB,uBAAuB,CA6BzB"}