riksdagsmonitor 0.8.12 → 0.8.15

package/dist/scripts/scb-client.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @module SCB/Client
+ * @description TypeScript client for Statistics Sweden (SCB) data via MCP server.
+ * Provides typed access to SCB statistical tables for enriching political
+ * intelligence with official Swedish statistics.
+ *
+ * Works with the SCB MCP server (https://scb-mcp.onrender.com/mcp) which
+ * exposes the PxWebAPI 2.0 for programmatic access to SCB's statistical database.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ * @see https://www.scb.se/en/services/open-data-api/api-for-the-statistical-database/
+ */
+import type { SCBIndicator } from './data-transformers/types.js';
+/** Configuration for the SCB MCP client */
+export interface SCBClientConfig {
+    /** SCB MCP server URL (default: https://scb-mcp.onrender.com/mcp) */
+    readonly serverUrl?: string;
+    /** Request timeout in ms (default: 15000) */
+    readonly timeout?: number;
+    /** Max retry attempts (default: 2) */
+    readonly maxRetries?: number;
+}
+/** A raw table search result from SCB */
+export interface SCBTableInfo {
+    readonly tableId: string;
+    readonly label: string;
+    readonly category: string;
+    readonly updated: string;
+}
+/** Raw data point from an SCB table */
+export interface SCBDataPoint {
+    readonly tableId: string;
+    readonly label: string;
+    readonly value: number;
+    readonly unit: string;
+    readonly period: string;
+}
+/** SCB policy domain definition with query and table mappings */
+export interface SCBDomainConfig {
+    readonly domain: string;
+    readonly query: string;
+    readonly tables: readonly string[];
+    readonly indicators: readonly string[];
+}
+/**
+ * SCB domain table mappings connecting policy domains to SCB table IDs.
+ * Each domain has search query terms, known table IDs, and key indicators.
+ */
+export declare const SCB_DOMAINS: readonly SCBDomainConfig[];
+/**
+ * Client for accessing Statistics Sweden (SCB) data via MCP server.
+ * Provides domain-based queries and indicator lookups.
+ */
+export declare class SCBClient {
+    readonly serverUrl: string;
+    readonly timeout: number;
+    readonly maxRetries: number;
+    constructor(config?: SCBClientConfig);
+    /**
+     * Search SCB tables by query string.
+     *
+     * @param query - Search terms (e.g., 'arbetslöshet sysselsättning')
+     * @param limit - Maximum number of results (default: 5)
+     * @returns Array of matching table info
+     */
+    searchTables(query: string, limit?: number): Promise<SCBTableInfo[]>;
+    /**
+     * Fetch data from a specific SCB table.
+     *
+     * @param tableId - SCB table identifier (e.g., 'TAB5765')
+     * @param selection - Optional selection filters (e.g., { Tid: ['TOP(4)'] })
+     * @returns Array of data points
+     */
+    getTableData(tableId: string, selection?: Record<string, string[]>): Promise<SCBDataPoint[]>;
+    /**
+     * Find SCB domain configuration for a policy area.
+     *
+     * @param domain - Policy domain key (e.g., 'labour', 'fiscal')
+     * @returns Domain config or undefined
+     */
+    findDomain(domain: string): SCBDomainConfig | undefined;
+    /**
+     * Get all domains that have known table IDs for direct data access.
+     *
+     * @returns Domains with pre-configured table IDs
+     */
+    getDomainsWithTables(): readonly SCBDomainConfig[];
+    /**
+     * Build an SCBIndicator from raw data points.
+     * Computes trend by comparing latest two values.
+     *
+     * @param label - Human-readable indicator label
+     * @param dataPoints - Raw data points sorted by period descending
+     * @param tableId - Source SCB table ID
+     * @returns SCBIndicator or null if no data
+     */
+    buildIndicator(label: string, dataPoints: readonly SCBDataPoint[], tableId: string): SCBIndicator | null;
+    private callTool;
+    private fetchWithRetry;
+}
+/** Get or create the default singleton SCBClient */
+export declare function getDefaultSCBClient(): SCBClient;
+//# sourceMappingURL=scb-client.d.ts.map

package/dist/scripts/scb-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scb-client.d.ts","sourceRoot":"","sources":["../../scripts/scb-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAMjE,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAUD;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,eAAe,EA2FxC,CAAC;AAMX;;;GAGG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,MAAM,GAAE,eAAoB;IAMxC;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAMrE;;;;;;OAMG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,OAAO,CAAC,YAAY,EAAE,CAAC;IAS1B;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAMvD;;;;OAIG;IACH,oBAAoB,IAAI,SAAS,eAAe,EAAE;IAIlD;;;;;;;;OAQG;IACH,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,YAAY,EAAE,EACnC,OAAO,EAAE,MAAM,GACd,YAAY,GAAG,IAAI;YA+BR,QAAQ;YAWR,cAAc;CAwD7B;AAQD,oDAAoD;AACpD,wBAAgB,mBAAmB,IAAI,SAAS,CAK/C"}

package/dist/scripts/scb-client.js

@@ -0,0 +1,286 @@
+/**
+ * @module SCB/Client
+ * @description TypeScript client for Statistics Sweden (SCB) data via MCP server.
+ * Provides typed access to SCB statistical tables for enriching political
+ * intelligence with official Swedish statistics.
+ *
+ * Works with the SCB MCP server (https://scb-mcp.onrender.com/mcp) which
+ * exposes the PxWebAPI 2.0 for programmatic access to SCB's statistical database.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ * @see https://www.scb.se/en/services/open-data-api/api-for-the-statistical-database/
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_SERVER_URL = 'https://scb-mcp.onrender.com/mcp';
+const DEFAULT_TIMEOUT = 15_000;
+const DEFAULT_MAX_RETRIES = 2;
+/**
+ * SCB domain table mappings connecting policy domains to SCB table IDs.
+ * Each domain has search query terms, known table IDs, and key indicators.
+ */
+export const SCB_DOMAINS = [
+    {
+        domain: 'fiscal',
+        query: 'skatter statsbudget offentliga finanser',
+        tables: ['TAB1291', 'TAB1292'],
+        indicators: ['Government revenue', 'Government expenditure', 'Budget balance'],
+    },
+    {
+        domain: 'defence',
+        query: 'försvar militär offentliga utgifter',
+        tables: [],
+        indicators: ['Defence spending % GDP'],
+    },
+    {
+        domain: 'environment',
+        query: 'växthusgaser utsläpp miljö',
+        tables: ['TAB5404', 'TAB5407'],
+        indicators: ['GHG emissions', 'Renewable energy share'],
+    },
+    {
+        domain: 'education',
+        query: 'utbildning studenter skola',
+        tables: ['TAB4787', 'TAB4790'],
+        indicators: ['Student enrollment', 'Graduation rates'],
+    },
+    {
+        domain: 'healthcare',
+        query: 'hälsa sjukvård vård',
+        tables: [],
+        indicators: ['Healthcare spending', 'Hospital beds'],
+    },
+    {
+        domain: 'migration',
+        query: 'invandring utvandring migration befolkning',
+        tables: ['TAB637', 'TAB4230'],
+        indicators: ['Immigration', 'Emigration', 'Net migration'],
+    },
+    {
+        domain: 'eu-foreign',
+        query: 'utrikeshandel export import',
+        tables: ['TAB2661'],
+        indicators: ['Export value', 'Import value', 'Trade balance'],
+    },
+    {
+        domain: 'justice',
+        query: 'brott lagföringar kriminalstatistik',
+        tables: ['TAB1172'],
+        indicators: ['Reported crimes', 'Conviction rate'],
+    },
+    {
+        domain: 'labour',
+        query: 'sysselsättning arbetslöshet arbetsmarknad',
+        tables: ['TAB5765', 'TAB5616'],
+        indicators: ['Unemployment rate', 'Employment rate'],
+    },
+    {
+        domain: 'housing',
+        query: 'bostäder nybyggnation hyror',
+        tables: ['TAB2052', 'TAB4709'],
+        indicators: ['Housing starts', 'Price index'],
+    },
+    {
+        domain: 'transport',
+        query: 'trafik transport infrastruktur',
+        tables: [],
+        indicators: ['Road traffic', 'Transit ridership'],
+    },
+    {
+        domain: 'trade',
+        query: 'näringsliv företag BNP',
+        tables: ['TAB5802', 'TAB5803'],
+        indicators: ['GDP growth', 'Business starts', 'Industrial production'],
+    },
+    {
+        domain: 'taxation',
+        query: 'skatter inkomstskatt moms skatteintäkter',
+        tables: ['TAB1291'],
+        indicators: ['Tax revenue', 'Income tax', 'VAT revenue'],
+    },
+    {
+        domain: 'culture',
+        query: 'kultur fritid idrott bibliotek',
+        tables: ['TAB5195'],
+        indicators: ['Cultural expenditure', 'Library visits', 'Cultural participation'],
+    },
+    {
+        domain: 'governance',
+        query: 'demokrati valdeltagande riksdag',
+        tables: [],
+        indicators: ['Voter turnout', 'Parliamentary transparency'],
+    },
+];
+// ---------------------------------------------------------------------------
+// SCBClient class
+// ---------------------------------------------------------------------------
+/**
+ * Client for accessing Statistics Sweden (SCB) data via MCP server.
+ * Provides domain-based queries and indicator lookups.
+ */
+export class SCBClient {
+    serverUrl;
+    timeout;
+    maxRetries;
+    constructor(config = {}) {
+        this.serverUrl = config.serverUrl ?? DEFAULT_SERVER_URL;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+        this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+    }
+    /**
+     * Search SCB tables by query string.
+     *
+     * @param query - Search terms (e.g., 'arbetslöshet sysselsättning')
+     * @param limit - Maximum number of results (default: 5)
+     * @returns Array of matching table info
+     */
+    async searchTables(query, limit = 5) {
+        const params = { query, limit };
+        const result = await this.callTool('search_tables', params);
+        return result ?? [];
+    }
+    /**
+     * Fetch data from a specific SCB table.
+     *
+     * @param tableId - SCB table identifier (e.g., 'TAB5765')
+     * @param selection - Optional selection filters (e.g., { Tid: ['TOP(4)'] })
+     * @returns Array of data points
+     */
+    async getTableData(tableId, selection) {
+        const params = { tableId };
+        if (selection) {
+            params.selection = selection;
+        }
+        const result = await this.callTool('get_table_data', params);
+        return result ?? [];
+    }
+    /**
+     * Find SCB domain configuration for a policy area.
+     *
+     * @param domain - Policy domain key (e.g., 'labour', 'fiscal')
+     * @returns Domain config or undefined
+     */
+    findDomain(domain) {
+        return SCB_DOMAINS.find((d) => d.domain.toLowerCase() === domain.toLowerCase());
+    }
+    /**
+     * Get all domains that have known table IDs for direct data access.
+     *
+     * @returns Domains with pre-configured table IDs
+     */
+    getDomainsWithTables() {
+        return SCB_DOMAINS.filter((d) => d.tables.length > 0);
+    }
+    /**
+     * Build an SCBIndicator from raw data points.
+     * Computes trend by comparing latest two values.
+     *
+     * @param label - Human-readable indicator label
+     * @param dataPoints - Raw data points sorted by period descending
+     * @param tableId - Source SCB table ID
+     * @returns SCBIndicator or null if no data
+     */
+    buildIndicator(label, dataPoints, tableId) {
+        if (dataPoints.length === 0)
+            return null;
+        const latest = dataPoints[0];
+        const previous = dataPoints.length > 1 ? dataPoints[1] : undefined;
+        let trend;
+        if (previous) {
+            const diff = latest.value - previous.value;
+            if (Math.abs(diff) < 0.001) {
+                trend = 'stable';
+            }
+            else {
+                trend = diff > 0 ? 'up' : 'down';
+            }
+        }
+        return {
+            label,
+            value: latest.value,
+            unit: latest.unit || 'units',
+            period: latest.period,
+            tableId,
+            trend,
+            previousValue: previous?.value,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Internal helpers
+    // -----------------------------------------------------------------------
+    async callTool(toolName, params) {
+        try {
+            const response = await this.fetchWithRetry(toolName, params);
+            return response;
+        }
+        catch (error) {
+            // Log for debugging MCP connection issues; return null as graceful fallback
+            console.warn(`SCB MCP call to ${toolName} failed:`, error instanceof Error ? error.message : error);
+            return null;
+        }
+    }
+    async fetchWithRetry(toolName, params, attempt = 0) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(this.serverUrl, {
+                method: 'POST',
+                signal: controller.signal,
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    method: 'tools/call',
+                    params: { name: toolName, arguments: params },
+                    id: Date.now(),
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`SCB MCP error: ${response.status} ${response.statusText}`);
+            }
+            const json = (await response.json());
+            if (json.error) {
+                throw new Error(`SCB MCP tool error: ${JSON.stringify(json.error)}`);
+            }
+            // MCP responses wrap content in result.content[].text
+            const text = json.result?.content?.[0]?.text;
+            if (text) {
+                try {
+                    return JSON.parse(text);
+                }
+                catch {
+                    console.warn(`SCB MCP response for ${toolName} was not valid JSON; treating as error`);
+                    throw new Error(`SCB MCP response for ${toolName} was not valid JSON`);
+                }
+            }
+            return json.result ?? null;
+        }
+        catch (error) {
+            if (attempt < this.maxRetries) {
+                const delay = 1000 * (attempt + 1);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return this.fetchWithRetry(toolName, params, attempt + 1);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton
+// ---------------------------------------------------------------------------
+let defaultSCBClient = null;
+/** Get or create the default singleton SCBClient */
+export function getDefaultSCBClient() {
+    if (!defaultSCBClient) {
+        defaultSCBClient = new SCBClient();
+    }
+    return defaultSCBClient;
+}
+//# sourceMappingURL=scb-client.js.map

package/dist/scripts/scb-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scb-client.js","sourceRoot":"","sources":["../../scripts/scb-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA2CH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,kCAAkC,CAAC;AAC9D,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAA+B;IACrD;QACE,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,yCAAyC;QAChD,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,UAAU,EAAE,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,gBAAgB,CAAC;KAC/E;IACD;QACE,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,qCAAqC;QAC5C,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,CAAC,wBAAwB,CAAC;KACvC;IACD;QACE,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,4BAA4B;QACnC,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,UAAU,EAAE,CAAC,eAAe,EAAE,wBAAwB,CAAC;KACxD;IACD;QACE,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,4BAA4B;QACnC,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,UAAU,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;KACvD;IACD;QACE,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,qBAAqB;QAC5B,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,CAAC,qBAAqB,EAAE,eAAe,CAAC;KACrD;IACD;QACE,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,4CAA4C;QACnD,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC7B,UAAU,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC;KAC3D;IACD;QACE,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,6BAA6B;QACpC,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,UAAU,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC;KAC9D;IACD;QACE,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,qCAAqC;QAC5C,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,UAAU,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;KACnD;IACD;QACE,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,2CAA2C;QAClD,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,UAAU,EAAE,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;KACrD;IACD;QACE,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,6BAA6B;QACpC,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,UAAU,EAAE,CAAC,gBAAgB,EAAE,aAAa,CAAC;KAC9C;IACD;QACE,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,gCAAgC;QACvC,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,CAAC,cAAc,EAAE,mBAAmB,CAAC;KAClD;IACD;QACE,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,wBAAwB;QAC/B,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,UAAU,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,CAAC;KACvE;IACD;QACE,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,0CAA0C;QACjD,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,UAAU,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,aAAa,CAAC;KACzD;IACD;QACE,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,gCAAgC;QACvC,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,UAAU,EAAE,CAAC,sBAAsB,EAAE,gBAAgB,EAAE,wBAAwB,CAAC;KACjF;IACD;QACE,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,iCAAiC;QACxC,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,CAAC,eAAe,EAAE,4BAA4B,CAAC;KAC5D;CACO,CAAC;AAEX,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,OAAO,SAAS;IACX,SAAS,CAAS;IAClB,OAAO,CAAS;IAChB,UAAU,CAAS;IAE5B,YAAY,SAA0B,EAAE;QACtC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC;QACjD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC7D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;QACzC,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAiB,eAAe,EAAE,MAAM,CAAC,CAAC;QAC5E,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,SAAoC;QAEpC,MAAM,MAAM,GAA4B,EAAE,OAAO,EAAE,CAAC;QACpD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAiB,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC7E,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,MAAc;QACvB,OAAO,WAAW,CAAC,IAAI,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CACvD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,oBAAoB;QAClB,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CACZ,KAAa,EACb,UAAmC,EACnC,OAAe;QAEf,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEnE,IAAI,KAA2C,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YAC3C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;gBAC3B,KAAK,GAAG,QAAQ,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,OAAO;YAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO;YACP,KAAK;YACL,aAAa,EAAE,QAAQ,EAAE,KAAK;SAC/B,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,mBAAmB;IACnB,0EAA0E;IAElE,KAAK,CAAC,QAAQ,CAAI,QAAgB,EAAE,MAA+B;QACzE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC7D,OAAO,QAAa,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4EAA4E;YAC5E,OAAO,CAAC,IAAI,CAAC,mBAAmB,QAAQ,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACpG,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,QAAgB,EAChB,MAA+B,EAC/B,OAAO,GAAG,CAAC;QAEX,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE;gBAC3C,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,MAAM,EAAE,kBAAkB;iBAC3B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,YAAY;oBACpB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE;oBAC7C,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;iBACf,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyE,CAAC;YAE7G,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvE,CAAC;YAED,sDAAsD;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;YAC7C,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,IAAI,CAAC,wBAAwB,QAAQ,wCAAwC,CAAC,CAAC;oBACvF,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,qBAAqB,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACnC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC3D,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,IAAI,gBAAgB,GAAqB,IAAI,CAAC;AAE9C,oDAAoD;AACpD,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,IAAI,SAAS,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/scripts/scb-context.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @module SCB/Context
+ * @description Context provider for Statistics Sweden (SCB) data enrichment.
+ * Maps SCB statistical indicators to Swedish policy areas and provides
+ * localized section headings for article generation.
+ *
+ * Mirrors the pattern of world-bank-context.ts but for Swedish national
+ * statistics sourced through the SCB MCP server.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import type { Language } from './types/language.js';
+import type { SCBDomainConfig } from './scb-client.js';
+/** An SCB indicator mapped to a policy domain and Riksdag committees */
+export interface SCBIndicatorContext {
+    /** Policy domain key (matches SCB_DOMAINS) */
+    readonly domain: string;
+    /** Human-readable name */
+    readonly name: string;
+    /** Concise description for article context */
+    readonly description: string;
+    /** Relevant Riksdag committees */
+    readonly committees: readonly string[];
+    /** SCB table IDs for data access */
+    readonly tableIds: readonly string[];
+    /** Key indicators available in this domain */
+    readonly indicators: readonly string[];
+}
+/** Localized headings for SCB statistics sections in articles */
+export interface SCBSectionHeadings {
+    readonly statisticalContext: string;
+    readonly officialStatistics: string;
+    readonly dataSource: string;
+}
+/**
+ * Maps SCB statistical domains to Swedish parliamentary committees.
+ * Each indicator context links SCB data to the relevant Riksdag committee
+ * for cross-referencing legislative analysis with official statistics.
+ */
+export declare const SCB_INDICATOR_CONTEXTS: readonly SCBIndicatorContext[];
+/**
+ * Localized section headings for SCB statistics in articles.
+ * Follows the same 14-language pattern as ECONOMIC_SECTION_HEADINGS.
+ */
+export declare const SCB_SECTION_HEADINGS: Readonly<Record<Language, SCBSectionHeadings>>;
+/**
+ * Get the localized SCB section heading.
+ *
+ * @param lang - Language code
+ * @param section - Section key
+ * @returns Localized heading string
+ */
+export declare function getSCBHeading(lang: Language | string, section: keyof SCBSectionHeadings): string;
+/**
+ * Find relevant SCB indicator contexts for a given policy area or committee.
+ *
+ * @param query - Policy domain, committee abbreviation, or free text
+ * @returns Matching SCB indicator contexts
+ */
+export declare function findRelevantSCBIndicators(query: string): readonly SCBIndicatorContext[];
+/**
+ * Get SCB domain configs that have known table IDs for a given committee.
+ *
+ * @param committee - Riksdag committee abbreviation (e.g., 'FiU', 'AU')
+ * @returns Matching SCB domain configs with table data
+ */
+export declare function getSCBTablesForCommittee(committee: string): readonly SCBDomainConfig[];
+/**
+ * Detect whether content references Swedish statistics or SCB data.
+ * Used by article quality enhancer to score statistical depth.
+ *
+ * @param content - HTML or text content to analyze
+ * @returns True if SCB statistical context is present
+ */
+export declare function hasSCBContext(content: string): boolean;
+/**
+ * Get SCB query parameters for all domains with table IDs.
+ * Used by agentic workflows to know which tables to fetch.
+ *
+ * @returns Array of { domain, query, tableIds } for domains with data
+ */
+export declare function getSCBQueryParams(): readonly {
+    domain: string;
+    query: string;
+    tableIds: readonly string[];
+}[];
+//# sourceMappingURL=scb-context.d.ts.map

package/dist/scripts/scb-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scb-context.d.ts","sourceRoot":"","sources":["../../scripts/scb-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvD,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAyHvD,CAAC;AAMX;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAuEtE,CAAC;AAMX;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,GAAG,MAAM,EACvB,OAAO,EAAE,MAAM,kBAAkB,GAChC,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,mBAAmB,EAAE,CAYvF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,CAWtF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAoBtD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,CAQ7G"}