riksdagsmonitor 0.8.14 → 0.8.17

package/dist/scripts/pre-article-analysis/data-persistence.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @module pre-article-analysis/data-persistence
+ * @description Persists raw MCP data to a structured, version-controlled
+ * directory tree under `analysis/data/`.  Every document, vote, event, or
+ * MP record fetched from MCP tools is written here with a consistent
+ * filename derived from its official Riksdag identifier (e.g. `dok_id`,
+ * `intressent_id`, `bet`).
+ *
+ * **Collision-free design** (v2):
+ *   - **Data files** (`{id}.json`) contain ONLY the raw source data — no
+ *     injected metadata.  Two parallel workflows writing the same document
+ *     produce byte-identical output, eliminating git merge conflicts.
+ *   - **Sidecar metadata** (`{id}.meta.json`) tracks provenance (at minimum
+ *     fetch timestamp and MCP tool name) in a separate file that is safely
+ *     overwritten on each run. Riksdag/Riksdag-regeringen documents also
+ *     include `riksmöte` and `documentType`, while external MCP tools
+ *     (World Bank, SCB, etc.) use tool-specific fields (e.g. indicator /
+ *     country, tableId / query) instead.
+ *   - **All MCP tools**: riksdag-regering, World Bank, SCB, and any other
+ *     MCP tool responses are stored under `analysis/data/`.
+ *
+ * Design principles:
+ *   - **Upsert**: writes overwrite existing files (mutable data like MP
+ *     profiles) or create new ones (immutable data like dated votes).
+ *   - **Provenance**: sidecar `.meta.json` files track fetch origin.
+ *   - **Date-stamped**: time-bound data (votes, events) is stored under
+ *     `analysis/data/{type}/YYYY-MM-DD/` subdirectories.
+ *   - **Side-effect-aware**: this module intentionally writes to disk;
+ *     callers control when persistence is triggered.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import type { RawDocument } from '../data-transformers/types.js';
+import type { DownloadedData, DocumentTypeKey } from './data-downloader.js';
+/** All known document/data types that appear in sidecar metadata. */
+export type PersistenceDocumentType = DocumentTypeKey | 'events' | 'mps' | 'government' | 'worldbank' | 'scb' | string;
+/** Sidecar metadata written alongside data files. */
+export interface PersistenceMetadata {
+    fetchedAt: string;
+    mcpTool: string;
+    riksmote: string;
+    documentType: PersistenceDocumentType;
+}
+/** Summary returned after a persistence run. */
+export interface PersistenceResult {
+    /**
+     * Total logical records persisted.
+     *
+     * Note: a single logical record may produce multiple physical files or
+     * data/sidecar pairs (for example, votes written under both
+     * `documents/votes/` and `votes/{date}/`), but it is counted once here.
+     */
+    written: number;
+    /** Total null/empty entries skipped. */
+    skipped: number;
+    /** Root directory the data was written to. */
+    dataRoot: string;
+}
+/** Description of an MCP tool call for generic response storage. */
+export interface MCPToolCall {
+    /** MCP tool name (e.g. 'get_propositioner', 'search_tables', 'get-country-info') */
+    tool: string;
+    /** Parameters passed to the tool */
+    params: Record<string, unknown>;
+    /** MCP server identifier (e.g. 'riksdag-regering', 'scb', 'world-bank') */
+    server: string;
+}
+/**
+ * Resolve the best identifier for a document.
+ * Falls back through the standard candidate chain.
+ */
+export declare function resolveDocId(doc: RawDocument, index: number): string;
+/**
+ * Persist all downloaded MCP data to the structured `analysis/data/` tree.
+ *
+ * Documents are organised by type under `analysis/data/documents/{type}/`.
+ * Date-stamped data (votes, events) is further partitioned by date.
+ *
+ * Data files contain only raw source data (no metadata injection) to ensure
+ * parallel workflows writing the same document produce identical output,
+ * preventing git merge conflicts.
+ *
+ * @param data        - Downloaded data collections from `downloadAllDocuments()`
+ * @param riksmote    - Current riksmöte identifier (e.g. "2025/26")
+ * @param mcpToolMap  - Map of document type → MCP tool name for provenance
+ * @param dataRoot    - Override for the data root directory (for testing)
+ * @returns Summary of files written and skipped.
+ */
+export declare function persistDownloadedData(data: DownloadedData, riksmote: string, mcpToolMap?: Partial<Record<DocumentTypeKey, string>>, dataRoot?: string): PersistenceResult;
+/**
+ * Persist a set of calendar events to `analysis/data/events/{date}/`.
+ * @param dataRoot - Override for the data root directory (for testing)
+ */
+export declare function persistEvents(events: RawDocument[], riksmote: string, dataRoot?: string): PersistenceResult;
+/**
+ * Persist MP profiles to `analysis/data/mps/`.
+ * @param dataRoot - Override for the data root directory (for testing)
+ */
+export declare function persistMPs(mps: RawDocument[], riksmote: string, dataRoot?: string): PersistenceResult;
+/**
+ * Persist a generic MCP tool response.  Supports any MCP server (riksdag,
+ * SCB, World Bank, etc.).  Responses are stored under:
+ *   `analysis/data/mcp-responses/{server}/{tool}/{id}.json`
+ *
+ * The response data is stored as-is (no metadata injection).  A sidecar
+ * `.meta.json` tracks provenance.
+ *
+ * @param call     - Description of the MCP tool call
+ * @param response - Raw response data from the MCP tool
+ * @param id       - Unique identifier for this response (e.g. dok_id, table_id, country code)
+ * @param dataRoot - Override for the data root directory (for testing)
+ * @returns The absolute path where the response was written.
+ */
+export declare function persistMCPResponse(call: MCPToolCall, response: unknown, id: string, dataRoot?: string, riksmote?: string): string;
+/**
+ * Persist World Bank API response data.
+ * Stored under `analysis/data/worldbank/{indicator}/{country}.json`
+ *
+ * @param indicator  - World Bank indicator ID (e.g. 'NY.GDP.MKTP.CD')
+ * @param country    - Country code (e.g. 'SWE')
+ * @param response   - Raw API response data
+ * @param dataRoot   - Override for the data root directory (for testing)
+ */
+export declare function persistWorldBankData(indicator: string, country: string, response: unknown, dataRoot?: string): string;
+/**
+ * Persist SCB (Statistics Sweden) table data.
+ * Stored under `analysis/data/scb/{tableId}.json`
+ *
+ * @param tableId   - SCB table identifier (e.g. 'BE0101A')
+ * @param response  - Raw SCB API response data
+ * @param query     - Optional query parameters used for provenance
+ * @param dataRoot  - Override for the data root directory (for testing)
+ */
+export declare function persistSCBData(tableId: string, response: unknown, query?: Record<string, unknown>, dataRoot?: string): string;
+/**
+ * Return the absolute path to the data repository root.
+ * Useful for callers that need to reference persisted files.
+ */
+export declare function getDataRoot(): string;
+//# sourceMappingURL=data-persistence.d.ts.map

package/dist/scripts/pre-article-analysis/data-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-persistence.d.ts","sourceRoot":"","sources":["../../../scripts/pre-article-analysis/data-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAiB5E,qEAAqE;AACrE,MAAM,MAAM,uBAAuB,GAC/B,eAAe,GACf,QAAQ,GACR,KAAK,GACL,YAAY,GACZ,WAAW,GACX,KAAK,GACL,MAAM,CAAC;AAEX,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,uBAAuB,CAAC;CACvC;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAcpE;AAiCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,EACrD,QAAQ,GAAE,MAAkB,GAC3B,iBAAiB,CA8EnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAkB,GAC3B,iBAAiB,CA8BnB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,WAAW,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAkB,GAC3B,iBAAiB,CAwBnB;AAwBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,OAAO,EACjB,EAAE,EAAE,MAAM,EACV,QAAQ,GAAE,MAAkB,EAC5B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAiCR;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,QAAQ,GAAE,MAAkB,GAC3B,MAAM,CAwBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,GAAE,MAAkB,GAC3B,MAAM,CAyBR;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}

package/dist/scripts/pre-article-analysis/data-persistence.js

@@ -0,0 +1,345 @@
+/**
+ * @module pre-article-analysis/data-persistence
+ * @description Persists raw MCP data to a structured, version-controlled
+ * directory tree under `analysis/data/`.  Every document, vote, event, or
+ * MP record fetched from MCP tools is written here with a consistent
+ * filename derived from its official Riksdag identifier (e.g. `dok_id`,
+ * `intressent_id`, `bet`).
+ *
+ * **Collision-free design** (v2):
+ *   - **Data files** (`{id}.json`) contain ONLY the raw source data — no
+ *     injected metadata.  Two parallel workflows writing the same document
+ *     produce byte-identical output, eliminating git merge conflicts.
+ *   - **Sidecar metadata** (`{id}.meta.json`) tracks provenance (at minimum
+ *     fetch timestamp and MCP tool name) in a separate file that is safely
+ *     overwritten on each run. Riksdag/Riksdag-regeringen documents also
+ *     include `riksmöte` and `documentType`, while external MCP tools
+ *     (World Bank, SCB, etc.) use tool-specific fields (e.g. indicator /
+ *     country, tableId / query) instead.
+ *   - **All MCP tools**: riksdag-regering, World Bank, SCB, and any other
+ *     MCP tool responses are stored under `analysis/data/`.
+ *
+ * Design principles:
+ *   - **Upsert**: writes overwrite existing files (mutable data like MP
+ *     profiles) or create new ones (immutable data like dated votes).
+ *   - **Provenance**: sidecar `.meta.json` files track fetch origin.
+ *   - **Date-stamped**: time-bound data (votes, events) is stored under
+ *     `analysis/data/{type}/YYYY-MM-DD/` subdirectories.
+ *   - **Side-effect-aware**: this module intentionally writes to disk;
+ *     callers control when persistence is triggered.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { sanitizeDokId } from './markdown-serializer.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = path.resolve(__dirname, '../..');
+const DATA_ROOT = path.join(REPO_ROOT, 'analysis', 'data');
+/** ISO 8601 date format pattern (YYYY-MM-DD). Checks format only, not date validity. */
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+/**
+ * Resolve the best identifier for a document.
+ * Falls back through the standard candidate chain.
+ */
+export function resolveDocId(doc, index) {
+    const record = doc;
+    const candidates = [
+        record['dok_id'],
+        record['dokument_id'],
+        record['id'],
+        record['rel_dok_id'],
+        record['titel'],
+        record['title'],
+    ];
+    const id = candidates.find((c) => typeof c === 'string' && c.trim().length > 0)?.trim() ?? `unknown-${index + 1}`;
+    return sanitizeDokId(id) || `unknown-${index + 1}`;
+}
+/**
+ * Write raw data to disk as pretty-printed JSON (NO metadata injection).
+ * Metadata is written to a separate sidecar file to prevent merge conflicts
+ * when parallel workflows persist the same document.
+ */
+function writeDocumentAndMeta(dir, baseFilename, doc, metadata) {
+    ensureDir(dir);
+    // Write raw data only — deterministic across parallel workflow runs
+    fs.writeFileSync(path.join(dir, baseFilename), JSON.stringify(doc, null, 2), 'utf8');
+    // Write provenance sidecar — safe to overwrite (non-conflicting)
+    const metaFilename = baseFilename.replace(/\.json$/, '.meta.json');
+    fs.writeFileSync(path.join(dir, metaFilename), JSON.stringify(metadata, null, 2), 'utf8');
+}
+// ---------------------------------------------------------------------------
+// Public API — Riksdag documents
+// ---------------------------------------------------------------------------
+/**
+ * Persist all downloaded MCP data to the structured `analysis/data/` tree.
+ *
+ * Documents are organised by type under `analysis/data/documents/{type}/`.
+ * Date-stamped data (votes, events) is further partitioned by date.
+ *
+ * Data files contain only raw source data (no metadata injection) to ensure
+ * parallel workflows writing the same document produce identical output,
+ * preventing git merge conflicts.
+ *
+ * @param data        - Downloaded data collections from `downloadAllDocuments()`
+ * @param riksmote    - Current riksmöte identifier (e.g. "2025/26")
+ * @param mcpToolMap  - Map of document type → MCP tool name for provenance
+ * @param dataRoot    - Override for the data root directory (for testing)
+ * @returns Summary of files written and skipped.
+ */
+export function persistDownloadedData(data, riksmote, mcpToolMap, dataRoot = DATA_ROOT) {
+    const defaultToolMap = {
+        propositions: 'get_propositioner',
+        motions: 'get_motioner',
+        committeeReports: 'get_betankanden',
+        votes: 'search_voteringar',
+        speeches: 'search_anforanden',
+        questions: 'get_fragor',
+        interpellations: 'get_interpellationer',
+    };
+    const toolMap = { ...defaultToolMap, ...mcpToolMap };
+    const fetchedAt = new Date().toISOString();
+    let written = 0;
+    let skipped = 0;
+    const docTypes = [
+        'propositions',
+        'motions',
+        'committeeReports',
+        'votes',
+        'speeches',
+        'questions',
+        'interpellations',
+    ];
+    for (const docType of docTypes) {
+        const docs = data[docType];
+        if (!docs || docs.length === 0) {
+            continue;
+        }
+        const typeDir = path.join(dataRoot, 'documents', docType);
+        const metadata = {
+            fetchedAt,
+            mcpTool: toolMap[docType],
+            riksmote,
+            documentType: docType,
+        };
+        const seenIds = new Set();
+        for (let i = 0; i < docs.length; i++) {
+            const doc = docs[i];
+            if (!doc) {
+                skipped++;
+                continue;
+            }
+            let docId = resolveDocId(doc, i);
+            // Collision avoidance: append suffix if ID already used in this batch
+            if (seenIds.has(docId)) {
+                let suffix = 1;
+                while (seenIds.has(`${docId}-${suffix}`))
+                    suffix++;
+                docId = `${docId}-${suffix}`;
+            }
+            seenIds.add(docId);
+            const filename = `${docId}.json`;
+            // For date-stamped vote ballots, also persist under votes/{date}/
+            if (docType === 'votes' && doc.datum) {
+                const voteDate = typeof doc.datum === 'string'
+                    ? doc.datum.slice(0, 10)
+                    : '';
+                if (ISO_DATE_RE.test(voteDate)) {
+                    const voteDateDir = path.join(dataRoot, 'votes', voteDate);
+                    writeDocumentAndMeta(voteDateDir, filename, doc, {
+                        ...metadata,
+                        documentType: 'votes',
+                    });
+                }
+            }
+            writeDocumentAndMeta(typeDir, filename, doc, metadata);
+            written++;
+        }
+    }
+    return { written, skipped, dataRoot: dataRoot };
+}
+/**
+ * Persist a set of calendar events to `analysis/data/events/{date}/`.
+ * @param dataRoot - Override for the data root directory (for testing)
+ */
+export function persistEvents(events, riksmote, dataRoot = DATA_ROOT) {
+    const fetchedAt = new Date().toISOString();
+    let written = 0;
+    let skipped = 0;
+    for (let i = 0; i < events.length; i++) {
+        const event = events[i];
+        if (!event) {
+            skipped++;
+            continue;
+        }
+        const record = event;
+        const dateStr = typeof record['datum'] === 'string'
+            ? record['datum'].slice(0, 10)
+            : typeof record['from'] === 'string'
+                ? record['from'].slice(0, 10)
+                : '';
+        const eventDate = ISO_DATE_RE.test(dateStr) ? dateStr : 'undated';
+        const eventDir = path.join(dataRoot, 'events', eventDate);
+        const eventId = resolveDocId(event, i);
+        writeDocumentAndMeta(eventDir, `${eventId}.json`, event, {
+            fetchedAt,
+            mcpTool: 'get_calendar_events',
+            riksmote,
+            documentType: 'events',
+        });
+        written++;
+    }
+    return { written, skipped, dataRoot: dataRoot };
+}
+/**
+ * Persist MP profiles to `analysis/data/mps/`.
+ * @param dataRoot - Override for the data root directory (for testing)
+ */
+export function persistMPs(mps, riksmote, dataRoot = DATA_ROOT) {
+    const fetchedAt = new Date().toISOString();
+    let written = 0;
+    let skipped = 0;
+    for (let i = 0; i < mps.length; i++) {
+        const mp = mps[i];
+        if (!mp) {
+            skipped++;
+            continue;
+        }
+        const record = mp;
+        const id = (typeof record['intressent_id'] === 'string' && record['intressent_id'])
+            || resolveDocId(mp, i);
+        const sanitized = sanitizeDokId(id) || `mp-${i + 1}`;
+        writeDocumentAndMeta(path.join(dataRoot, 'mps'), `${sanitized}.json`, mp, {
+            fetchedAt,
+            mcpTool: 'search_ledamoter',
+            riksmote,
+            documentType: 'mps',
+        });
+        written++;
+    }
+    return { written, skipped, dataRoot: dataRoot };
+}
+// ---------------------------------------------------------------------------
+// Public API — Generic MCP response storage
+// ---------------------------------------------------------------------------
+/**
+ * Sanitize a path segment to prevent path traversal.
+ * Preserves underscores (common in MCP tool names like get_voting_group)
+ * but removes slashes, null bytes, and dots-only sequences.
+ */
+function sanitizePathSegment(segment) {
+    // Remove path separators and null bytes
+    let safe = segment.replace(/[/\\:\0]/g, '_');
+    // Collapse dots-only segments (e.g. "..", ".")
+    if (/^\.+$/.test(safe))
+        safe = '_dots_';
+    // Remove characters that are unsafe in paths but preserve underscores
+    safe = safe.replace(/[^a-zA-Z0-9_\-åäöÅÄÖ]/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_|_$/g, '')
+        .slice(0, 100);
+    return safe || 'unknown';
+}
+/**
+ * Persist a generic MCP tool response.  Supports any MCP server (riksdag,
+ * SCB, World Bank, etc.).  Responses are stored under:
+ *   `analysis/data/mcp-responses/{server}/{tool}/{id}.json`
+ *
+ * The response data is stored as-is (no metadata injection).  A sidecar
+ * `.meta.json` tracks provenance.
+ *
+ * @param call     - Description of the MCP tool call
+ * @param response - Raw response data from the MCP tool
+ * @param id       - Unique identifier for this response (e.g. dok_id, table_id, country code)
+ * @param dataRoot - Override for the data root directory (for testing)
+ * @returns The absolute path where the response was written.
+ */
+export function persistMCPResponse(call, response, id, dataRoot = DATA_ROOT, riksmote) {
+    const sanitized = sanitizeDokId(id) || `response-${crypto.randomUUID()}`;
+    const safeServer = sanitizePathSegment(call.server);
+    const safeTool = sanitizePathSegment(call.tool);
+    const dir = path.join(dataRoot, 'mcp-responses', safeServer, safeTool);
+    ensureDir(dir);
+    const filename = `${sanitized}.json`;
+    fs.writeFileSync(path.join(dir, filename), JSON.stringify(response, null, 2), 'utf8');
+    // Derive riksmöte: explicit param > call.params.rm > empty
+    const resolvedRiksmote = riksmote
+        ?? (typeof call.params.rm === 'string' ? call.params.rm : '');
+    const metaFilename = `${sanitized}.meta.json`;
+    const metadata = {
+        fetchedAt: new Date().toISOString(),
+        mcpTool: call.tool,
+        riksmote: resolvedRiksmote,
+        documentType: call.server,
+        params: call.params,
+    };
+    fs.writeFileSync(path.join(dir, metaFilename), JSON.stringify(metadata, null, 2), 'utf8');
+    return path.join(dir, filename);
+}
+/**
+ * Persist World Bank API response data.
+ * Stored under `analysis/data/worldbank/{indicator}/{country}.json`
+ *
+ * @param indicator  - World Bank indicator ID (e.g. 'NY.GDP.MKTP.CD')
+ * @param country    - Country code (e.g. 'SWE')
+ * @param response   - Raw API response data
+ * @param dataRoot   - Override for the data root directory (for testing)
+ */
+export function persistWorldBankData(indicator, country, response, dataRoot = DATA_ROOT) {
+    const dir = path.join(dataRoot, 'worldbank', sanitizeDokId(indicator));
+    ensureDir(dir);
+    const filename = `${sanitizeDokId(country)}.json`;
+    fs.writeFileSync(path.join(dir, filename), JSON.stringify(response, null, 2), 'utf8');
+    const metaFilename = `${sanitizeDokId(country)}.meta.json`;
+    fs.writeFileSync(path.join(dir, metaFilename), JSON.stringify({
+        fetchedAt: new Date().toISOString(),
+        mcpTool: 'world-bank-api',
+        indicator,
+        country,
+    }, null, 2), 'utf8');
+    return path.join(dir, filename);
+}
+/**
+ * Persist SCB (Statistics Sweden) table data.
+ * Stored under `analysis/data/scb/{tableId}.json`
+ *
+ * @param tableId   - SCB table identifier (e.g. 'BE0101A')
+ * @param response  - Raw SCB API response data
+ * @param query     - Optional query parameters used for provenance
+ * @param dataRoot  - Override for the data root directory (for testing)
+ */
+export function persistSCBData(tableId, response, query, dataRoot = DATA_ROOT) {
+    const dir = path.join(dataRoot, 'scb');
+    ensureDir(dir);
+    const sanitized = sanitizeDokId(tableId);
+    const filename = `${sanitized}.json`;
+    fs.writeFileSync(path.join(dir, filename), JSON.stringify(response, null, 2), 'utf8');
+    const metaFilename = `${sanitized}.meta.json`;
+    fs.writeFileSync(path.join(dir, metaFilename), JSON.stringify({
+        fetchedAt: new Date().toISOString(),
+        mcpTool: 'scb-pxweb',
+        tableId,
+        ...(query ? { query } : {}),
+    }, null, 2), 'utf8');
+    return path.join(dir, filename);
+}
+/**
+ * Return the absolute path to the data repository root.
+ * Useful for callers that need to reference persisted files.
+ */
+export function getDataRoot() {
+    return DATA_ROOT;
+}
+//# sourceMappingURL=data-persistence.js.map

package/dist/scripts/pre-article-analysis/data-persistence.js.map

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

package/dist/scripts/pre-article-analysis/markdown-serializer.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @module pre-article-analysis/markdown-serializer
+ * @description Serializes analysis framework results as structured markdown
+ * files for persistence in `analysis/daily/YYYY-MM-DD/`.
+ *
+ * Each output file follows the standard analysis template:
+ * ```markdown
+ * # [Analysis Type] — YYYY-MM-DD
+ * **Generated**: YYYY-MM-DD HH:MM UTC
+ * **Data Sources**: [list]
+ * **Documents Analyzed**: N
+ * **Confidence**: HIGH/MEDIUM/LOW
+ * ## Summary / ## Detailed Analysis / ## Key Findings / ## Implications
+ * ```
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+interface SwotContribution {
+    quadrant: string;
+    text: string;
+    forStakeholder: string;
+}
+interface DashboardMetric {
+    label: string;
+    value: number | string;
+    unit?: string;
+    metricName: string;
+}
+interface MindmapNode {
+    label: string;
+    children?: MindmapNode[];
+}
+interface PerspectiveAnalysis {
+    lens: string;
+    summary: string;
+    impact: string;
+    sentiment: string;
+    swotContribution: SwotContribution[];
+    dashboardMetrics: DashboardMetric[];
+    mindmapNodes: MindmapNode[];
+    confidence: number;
+    keyActors: string[];
+    relatedPolicies: string[];
+}
+interface DocumentLink {
+    sourceId: string;
+    targetId: string;
+    type: string;
+    description: string;
+    confidence: number;
+    reason: string;
+}
+interface DocumentAnalysisResult {
+    document: {
+        dok_id?: string;
+        titel?: string;
+        title?: string;
+        doktyp?: string;
+        organ?: string;
+        committee?: string;
+        datum?: string;
+        intressent_namn?: string;
+        author?: string;
+        parti?: string;
+        rm?: string;
+        summary?: string;
+        rubrik?: string;
+        undertitel?: string;
+        notis?: string;
+        mottagare?: string;
+        fullText?: string;
+        fullContent?: string;
+        [key: string]: unknown;
+    };
+    overallSignificance: number;
+    perspectives: PerspectiveAnalysis[];
+    crossDocumentLinks: DocumentLink[];
+    keyInsights: string[];
+    confidenceScore: number;
+}
+export interface SerializationContext {
+    /** ISO date string, e.g. "2026-03-26" */
+    date: string;
+    /** UTC timestamp of generation */
+    generatedAt: string;
+    /** List of MCP tool names called to download data */
+    dataSources: string[];
+}
+export interface SignificanceEntry {
+    dok_id: string;
+    title: string;
+    score: number;
+    doctype: string;
+}
+export interface RiskAssessmentResult {
+    coalitionRiskScore: number;
+    riskLevel: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    riskSummary: string;
+    anomalyFlags: Array<{
+        type: string;
+        severity: string;
+        description: string;
+    }>;
+    implications: string[];
+}
+export interface SwotSummary {
+    strengths: string[];
+    weaknesses: string[];
+    opportunities: string[];
+    threats: string[];
+    forStakeholder: string;
+}
+export interface CrossReferenceSummary {
+    docCount: number;
+    totalLinks: number;
+    links: DocumentLink[];
+}
+export interface SynthesisSummary {
+    totalDocs: number;
+    executiveSummary: string;
+    keyFindings: string[];
+    topDocuments: SignificanceEntry[];
+    overallConfidence: 'HIGH' | 'MEDIUM' | 'LOW';
+    aggregateRiskLevel: string;
+}
+export declare function serializeDataManifest(ctx: SerializationContext, docCounts: Record<string, number>, dateFilteredTotal?: number): string;
+export declare function serializeClassificationResults(ctx: SerializationContext, results: DocumentAnalysisResult[]): string;
+export declare function serializeRiskAssessment(ctx: SerializationContext, docCount: number, risk: RiskAssessmentResult): string;
+export declare function serializeSwotAnalysis(ctx: SerializationContext, docCount: number, swots: SwotSummary[]): string;
+export declare function serializeThreatAnalysis(ctx: SerializationContext, results: DocumentAnalysisResult[]): string;
+export declare function serializeStakeholderPerspectives(ctx: SerializationContext, results: DocumentAnalysisResult[]): string;
+export declare function serializeSignificanceScoring(ctx: SerializationContext, entries: SignificanceEntry[]): string;
+export declare function serializeCrossReferenceMap(ctx: SerializationContext, summary: CrossReferenceSummary): string;
+export declare function serializeSynthesisSummary(ctx: SerializationContext, synthesis: SynthesisSummary): string;
+/**
+ * Serialize a per-document analysis markdown file.
+ *
+ * Each document gets its own analysis file with:
+ * - Full document metadata
+ * - Detailed SWOT analysis
+ * - Multi-lens stakeholder perspective analysis
+ * - Significance scoring factors
+ * - Cross-document references (where available)
+ * - Key insights
+ * - Data quality / methodology notes
+ *
+ * Note: Explicit risk indicator extraction and implications sections are
+ * produced at the synthesis level rather than by this per-document serializer.
+ */
+export declare function serializeDocumentAnalysis(ctx: SerializationContext, result: DocumentAnalysisResult): string;
+/**
+ * Sanitize a document identifier for use as a safe filename.
+ * Replaces non-alphanumeric characters with hyphens and lowercases.
+ */
+export declare function sanitizeDokId(dokId: string): string;
+export {};
+//# sourceMappingURL=markdown-serializer.d.ts.map