Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 | 94x 91x 3x 1x 2x 94x 2x 94x 2x 2x 2x 2x 2x 2x 20x 20x 5x 15x 10x 5x 20x 2x 20x 22x 6x 10x 6x 23x 2x 21x 21x 21x 21x 21x 94x 94x 94x 94x 47x 47x 43x 43x 21x 21x 23x 1x 20x 20x 20x 2x | /**
* @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
*/
import type { Language } from '../types/language.js';
import type { RawDocument } from '../data-transformers/types.js';
import type {
CoalitionTensionResult,
CoalitionStressLevel,
CoalitionTensionDetector,
} from './types.js';
// ---------------------------------------------------------------------------
// 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: RawDocument): string {
// 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: RawDocument): string {
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']);
// ---------------------------------------------------------------------------
// Localised narrative templates
// ---------------------------------------------------------------------------
type LangRecord = Partial<Record<Language, string>>;
const STRESS_NEUTRAL: LangRecord = {
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: LangRecord = {
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: LangRecord = {
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: LangRecord = {
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: number, ipCount: number): CoalitionStressLevel {
const ipBoost = ipCount >= 5;
// Base level from challenge ratio alone
let level: CoalitionStressLevel;
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: CoalitionStressLevel, lang: Language): string {
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: RawDocument[],
lang: Language,
): CoalitionTensionResult {
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: string[] = [];
for (const d of docs) {
const dt = docType(d);
const id = docId(d);
Eif (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: CoalitionTensionDetector = {
detect: detectCoalitionTension,
};
|