riksdagsmonitor 0.8.23 → 0.8.24

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

@@ -1,141 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,345 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,158 +0,0 @@
-/**
- * @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