riksdagsmonitor 0.8.14 → 0.8.17

package/dist/scripts/government-role-validator.js

@@ -0,0 +1,217 @@
+/**
+ * @module government-role-validator
+ * @description Validates government role attributions against the CIA platform's
+ * authoritative government role member data (view_riksdagen_goverment_role_member_sample.csv).
+ *
+ * ROOT CAUSE PREVENTION: Agentic workflows previously hallucinated government titles
+ * (e.g. calling Lotta Edholm "Deputy Prime Minister" when she is gymnasie-, högskole-
+ * och forskningsminister, and the actual Vice statsminister is Ebba Busch (KD)).
+ * This module provides a validation layer that cross-references names against
+ * known government roles from the CIA data export.
+ *
+ * The CSV is downloaded from:
+ * https://raw.githubusercontent.com/Hack23/cia/refs/heads/master/service.data.impl/sample-data/view_riksdagen_goverment_role_member_sample.csv
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+const CSV_RELATIVE_PATH = 'cia-data/view_riksdagen_goverment_role_member_sample.csv';
+/**
+ * Parse a single CSV line respecting quoted fields (RFC 4180).
+ * Handles commas inside double-quoted values (e.g. "Gymnasie-, högskole-…").
+ */
+function parseCSVLine(line) {
+    const fields = [];
+    let current = '';
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (inQuotes) {
+            if (ch === '"' && line[i + 1] === '"') {
+                current += '"';
+                i++; // skip escaped quote
+            }
+            else if (ch === '"') {
+                inQuotes = false;
+            }
+            else {
+                current += ch;
+            }
+        }
+        else if (ch === '"') {
+            inQuotes = true;
+        }
+        else if (ch === ',') {
+            fields.push(current);
+            current = '';
+        }
+        else {
+            current += ch;
+        }
+    }
+    fields.push(current);
+    return fields;
+}
+/** Parse the CSV into GovernmentRoleMember records. */
+function parseCSV(csvText) {
+    const lines = csvText.split('\n').filter(l => l.trim().length > 0);
+    if (lines.length < 2)
+        return [];
+    // Skip header
+    return lines.slice(1).map(line => {
+        const cols = parseCSVLine(line);
+        return {
+            roleId: cols[0] ?? '',
+            department: cols[1] ?? '',
+            roleCode: cols[2] ?? '',
+            firstName: cols[3] ?? '',
+            lastName: cols[4] ?? '',
+            fromDate: cols[5] ?? '',
+            toDate: cols[6] ?? '',
+            personId: cols[7] ?? '',
+            party: cols[8] ?? '',
+            active: cols[10] === 't',
+        };
+    });
+}
+/** Normalise a name for fuzzy comparison (lowercase, trim, collapse whitespace). */
+function normaliseName(name) {
+    return name.toLowerCase().replace(/\s+/g, ' ').trim();
+}
+/**
+ * Load and cache the government role member data.
+ * Uses the local CSV in cia-data/ as the authoritative source.
+ */
+let cachedMembers = null;
+export function loadGovernmentRoleMembers(repoRoot) {
+    if (cachedMembers)
+        return cachedMembers;
+    const root = repoRoot ?? resolve(import.meta.dirname ?? '.', '..');
+    const csvPath = resolve(root, CSV_RELATIVE_PATH);
+    try {
+        const csvText = readFileSync(csvPath, 'utf-8');
+        cachedMembers = parseCSV(csvText);
+        return cachedMembers;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 'ENOENT') {
+            console.warn(`[government-role-validator] CSV not found at ${csvPath}; role validation disabled.`);
+        }
+        else {
+            console.warn(`[government-role-validator] Error loading ${csvPath}: ${err}; role validation disabled.`);
+        }
+        cachedMembers = [];
+        return cachedMembers;
+    }
+}
+/** Clear the cache (useful for testing). */
+export function clearCache() {
+    cachedMembers = null;
+}
+/**
+ * Find all government roles for a person by last name (and optionally first name).
+ * Returns roles sorted by most recent first.
+ */
+export function findRolesForPerson(lastName, firstName, repoRoot) {
+    const members = loadGovernmentRoleMembers(repoRoot);
+    const normLast = normaliseName(lastName);
+    const normFirst = firstName ? normaliseName(firstName) : undefined;
+    return members
+        .filter(m => {
+        if (normaliseName(m.lastName) !== normLast)
+            return false;
+        if (normFirst && normaliseName(m.firstName) !== normFirst)
+            return false;
+        return true;
+    })
+        .sort((a, b) => b.fromDate.localeCompare(a.fromDate));
+}
+/**
+ * Get the current (most recent active, or most recent) role for a person.
+ */
+export function getCurrentRole(lastName, firstName, repoRoot) {
+    const roles = findRolesForPerson(lastName, firstName, repoRoot);
+    // Prefer active roles
+    const active = roles.find(r => r.active);
+    return active ?? roles[0];
+}
+/**
+ * Validate whether a claimed government role title is correct for a person.
+ * Returns a validation result with the actual role and a correction suggestion.
+ *
+ * @param fullName - Full name of the person (e.g. "Lotta Edholm")
+ * @param claimedRole - The role attributed in the article (e.g. "Deputy Prime Minister")
+ * @param repoRoot - Optional repository root path
+ */
+export function validateGovernmentRole(fullName, claimedRole, repoRoot) {
+    const parts = fullName.trim().split(/\s+/);
+    const lastName = parts.pop() ?? '';
+    const firstName = parts.join(' ') || undefined;
+    const roles = findRolesForPerson(lastName, firstName, repoRoot);
+    if (roles.length === 0) {
+        return {
+            valid: false,
+            name: fullName,
+            claimedRole,
+            actualRoles: [],
+            suggestion: `No government role records found for "${fullName}" in CIA data. Verify the name and role manually.`,
+        };
+    }
+    const currentRole = roles.find(r => r.active) ?? roles[0];
+    const claimedLower = claimedRole.toLowerCase();
+    // Check if claimed role matches the actual role code or department
+    const roleCodeLower = currentRole.roleCode.toLowerCase();
+    const departmentLower = currentRole.department.toLowerCase();
+    // Known title mappings for Deputy PM across supported languages
+    const deputyPMTerms = ['deputy prime minister', 'vice statsminister', 'vice premier',
+        'vicepremier', 'viceministerpräsident', 'vice-première ministre', 'viceprimera ministra',
+        'varapääministeri', 'visestatsminister', 'vicestatsminister',
+        'نائبة رئيس الوزراء', 'סגנית ראש הממשלה', '副首相', '부총리'];
+    const isClaimingDeputyPM = deputyPMTerms.some(term => claimedLower.includes(term));
+    // Deputy PM (Vice statsminister) is a constitutional designation given to one minister.
+    // The CIA CSV does not have an explicit "Vice statsminister" role_code — the Deputy PM
+    // has their regular ministerial role_code. To validate, we check that the person's
+    // department is Statsrådsberedningen (PM's office) or role_code is Statsminister.
+    // For any other person, claiming Deputy PM is invalid.
+    if (isClaimingDeputyPM) {
+        const isPMRole = roleCodeLower === 'statsminister' ||
+            departmentLower === 'statsrådsberedningen';
+        if (!isPMRole) {
+            return {
+                valid: false,
+                name: fullName,
+                claimedRole,
+                actualRoles: roles,
+                suggestion: `"${fullName}" is ${currentRole.roleCode} at ${currentRole.department} (${currentRole.party}), NOT Deputy Prime Minister. ` +
+                    `Check if the actual Vice statsminister should be cited instead.`,
+            };
+        }
+    }
+    // Check if claimed role roughly matches known role
+    const matchesRole = claimedLower.includes(roleCodeLower) ||
+        roleCodeLower.includes(claimedLower) ||
+        claimedLower.includes(departmentLower);
+    return {
+        valid: matchesRole || !isClaimingDeputyPM,
+        name: fullName,
+        claimedRole,
+        actualRoles: roles,
+        suggestion: matchesRole
+            ? `Role verified: "${fullName}" is ${currentRole.roleCode} at ${currentRole.department} (${currentRole.party}).`
+            : `"${fullName}" is recorded as ${currentRole.roleCode} at ${currentRole.department} (${currentRole.party}). Claimed role "${claimedRole}" may need verification.`,
+    };
+}
+/**
+ * Get a formatted role description for a person suitable for article text.
+ * Returns the most current role in "RoleCode FirstName LastName (Party)" format.
+ */
+export function getFormattedRole(lastName, firstName, repoRoot) {
+    const role = getCurrentRole(lastName, firstName, repoRoot);
+    if (!role)
+        return undefined;
+    return `${role.roleCode} ${role.firstName} ${role.lastName} (${role.party})`;
+}
+//# sourceMappingURL=government-role-validator.js.map

package/dist/scripts/government-role-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"government-role-validator.js","sourceRoot":"","sources":["../../scripts/government-role-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBpC,MAAM,iBAAiB,GAAG,0DAA0D,CAAC;AAErF;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACtC,OAAO,IAAI,GAAG,CAAC;gBACf,CAAC,EAAE,CAAC,CAAC,qBAAqB;YAC5B,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACtB,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uDAAuD;AACvD,SAAS,QAAQ,CAAC,OAAe;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,cAAc;IACd,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC/B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACrB,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACzB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACxB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACvB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACvB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACrB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACvB,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACpB,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,GAAG;SACzB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oFAAoF;AACpF,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,IAAI,aAAa,GAAkC,IAAI,CAAC;AAExD,MAAM,UAAU,yBAAyB,CAAC,QAAiB;IACzD,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,GAAG,EAAE,IAAI,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,GAAI,GAA6B,EAAE,IAAI,CAAC;QAClD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,gDAAgD,OAAO,6BAA6B,CAAC,CAAC;QACrG,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,6CAA6C,OAAO,KAAK,GAAG,6BAA6B,CAAC,CAAC;QAC1G,CAAC;QACD,aAAa,GAAG,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,UAAU;IACxB,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,SAAkB,EAClB,QAAiB;IAEjB,MAAM,OAAO,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnE,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,CAAC,EAAE;QACV,IAAI,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzD,IAAI,SAAS,IAAI,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,SAAkB,EAClB,QAAiB;IAEjB,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChE,sBAAsB;IACtB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,WAAmB,EACnB,QAAiB;IAEjB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IAC/C,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW;YACX,WAAW,EAAE,EAAE;YACf,UAAU,EAAE,yCAAyC,QAAQ,mDAAmD;SACjH,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAE/C,mEAAmE;IACnE,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzD,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IAE7D,gEAAgE;IAChE,MAAM,aAAa,GAAG,CAAC,uBAAuB,EAAE,oBAAoB,EAAE,cAAc;QAClF,aAAa,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,sBAAsB;QACxF,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB;QAC5D,oBAAoB,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAE1D,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAEnF,wFAAwF;IACxF,uFAAuF;IACvF,mFAAmF;IACnF,kFAAkF;IAClF,uDAAuD;IACvD,IAAI,kBAAkB,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,aAAa,KAAK,eAAe;YAChD,eAAe,KAAK,sBAAsB,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW;gBACX,WAAW,EAAE,KAAK;gBAClB,UAAU,EAAE,IAAI,QAAQ,QAAQ,WAAW,CAAC,QAAQ,OAAO,WAAW,CAAC,UAAU,KAAK,WAAW,CAAC,KAAK,gCAAgC;oBACrI,iEAAiE;aACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;QACtD,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC;QACpC,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzC,OAAO;QACL,KAAK,EAAE,WAAW,IAAI,CAAC,kBAAkB;QACzC,IAAI,EAAE,QAAQ;QACd,WAAW;QACX,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,WAAW;YACrB,CAAC,CAAC,mBAAmB,QAAQ,QAAQ,WAAW,CAAC,QAAQ,OAAO,WAAW,CAAC,UAAU,KAAK,WAAW,CAAC,KAAK,IAAI;YAChH,CAAC,CAAC,IAAI,QAAQ,oBAAoB,WAAW,CAAC,QAAQ,OAAO,WAAW,CAAC,UAAU,KAAK,WAAW,CAAC,KAAK,oBAAoB,WAAW,0BAA0B;KACrK,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,SAAkB,EAClB,QAAiB;IAEjB,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC;AAC/E,CAAC"}

package/dist/scripts/html-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module Infrastructure/HTMLSanitization
+ * @description XSS-safe HTML entity escaping utility.
+ * Bounded context: Infrastructure / Security
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+/**
+ * Escape HTML special characters for safe inclusion in HTML/JSON-LD.
+ * Prevents XSS by converting &, <, >, ", ' to their HTML entity equivalents.
+ *
+ * @param text - Raw text to escape
+ * @returns Escaped text safe for HTML insertion; empty string for falsy input
+ */
+export declare function escapeHtml(text: string | null | undefined | number): string;
+//# sourceMappingURL=html-utils.d.ts.map

package/dist/scripts/html-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-utils.d.ts","sourceRoot":"","sources":["../../scripts/html-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAM3E"}

package/dist/scripts/html-utils.js

@@ -0,0 +1,29 @@
+/**
+ * @module Infrastructure/HTMLSanitization
+ * @description XSS-safe HTML entity escaping utility.
+ * Bounded context: Infrastructure / Security
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+const HTML_ENTITY_MAP = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#039;',
+};
+const HTML_ESCAPE_PATTERN = /[&<>"']/g;
+/**
+ * Escape HTML special characters for safe inclusion in HTML/JSON-LD.
+ * Prevents XSS by converting &, <, >, ", ' to their HTML entity equivalents.
+ *
+ * @param text - Raw text to escape
+ * @returns Escaped text safe for HTML insertion; empty string for falsy input
+ */
+export function escapeHtml(text) {
+    if (!text)
+        return '';
+    return String(text).replace(HTML_ESCAPE_PATTERN, (m) => HTML_ENTITY_MAP[m] ?? m);
+}
+//# sourceMappingURL=html-utils.js.map

package/dist/scripts/html-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-utils.js","sourceRoot":"","sources":["../../scripts/html-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,eAAe,GAAqC;IACxD,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;CACL,CAAC;AAEX,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAwC;IACjE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CACzB,mBAAmB,EACnB,CAAC,CAAS,EAAU,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAC/C,CAAC;AACJ,CAAC"}

package/dist/scripts/load-cia-stats.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @module Intelligence Operations/CIA Statistical Intelligence
+ * @category Intelligence Operations - CIA Statistical Intelligence
+ *
+ * @description
+ * Statistical intelligence data loader providing comprehensive parliamentary and
+ * government statistics from the CIA production database.
+ *
+ * ISMS Compliance: ISO 27001 - Information Security Management
+ * Data Classification: public - All data sourced from public government records
+ * GDPR Compliance: No personal data processed; aggregated statistics only
+ * Swedish Offentlighetsprincipen (Principle of Public Access) applies
+ *
+ * Data source: https://github.com/Hack23/cia
+ *
+ * @author Hack23 AB - Intelligence Operations Team
+ * @license Apache-2.0
+ * @version 2.0.0
+ */
+export interface TableEntry {
+    readonly name: string;
+    readonly count: number;
+}
+export interface StatsMetadata {
+    source_url: string;
+    last_updated: string | null;
+    extraction_time: string | null;
+    generated_at: string;
+    version: string;
+    error?: string;
+}
+export interface StatsCounts {
+    total_persons: number;
+    total_votes: number;
+    total_documents: number;
+    total_committee_documents: number;
+    total_rule_violations: number;
+    total_against_proposals: number;
+    total_committee_proposals: number;
+    total_document_activities: number;
+    total_political_parties: number;
+    total_assignments: number;
+    total_document_attachments: number;
+    total_riksdag_parties: number;
+    total_governments: number;
+    total_government_proposals: number;
+    total_government_roles: number;
+    total_government_role_members: number;
+    total_member_proposals: number;
+    total_committee_decisions: number;
+    total_committee_member_proposals: number;
+    total_committee_role_members: number;
+    total_committee_roles: number;
+    total_party_members: number;
+    total_party_role_members: number;
+    total_party_summary: number;
+    total_politician_documents: number;
+    total_ballot_politician_summaries: number;
+    total_document_content: number;
+}
+export interface StatsData {
+    metadata: StatsMetadata;
+    counts: StatsCounts;
+    tables: {
+        success: TableEntry[];
+        empty: string[];
+    };
+}
+export interface CSVRow {
+    [header: string]: string;
+}
+/**
+ * Parse CSV text into array of objects.
+ */
+declare function parseCSV(csvText: string): CSVRow[];
+/**
+ * Fetch CSV from URL via HTTPS.
+ */
+declare function fetchCSV(url: string): Promise<string>;
+/**
+ * Extract key statistics from parsed CSV data.
+ */
+declare function extractStatistics(data: CSVRow[]): StatsData;
+/**
+ * Main execution.
+ */
+declare function main(): Promise<StatsData>;
+export { main as loadCIAStats, extractStatistics, parseCSV, fetchCSV };
+//# sourceMappingURL=load-cia-stats.d.ts.map

package/dist/scripts/load-cia-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-cia-stats.d.ts","sourceRoot":"","sources":["../../scripts/load-cia-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAmBH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,EAAE,MAAM,CAAC;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,MAAM,CAAC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,MAAM,CAAC;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6BAA6B,EAAE,MAAM,CAAC;IACtC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,gCAAgC,EAAE,MAAM,CAAC;IACzC,4BAA4B,EAAE,MAAM,CAAC;IACrC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,iCAAiC,EAAE,MAAM,CAAC;IAC1C,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE;QACN,OAAO,EAAE,UAAU,EAAE,CAAC;QACtB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,MAAM;IACrB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAMD;;GAEG;AACH,iBAAS,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA2B3C;AAMD;;GAEG;AACH,iBAAS,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B9C;AAMD;;GAEG;AACH,iBAAS,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAuHpD;AAoDD;;GAEG;AACH,iBAAe,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,CAyIxC;AAcD,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}