riksdagsmonitor 0.8.12 → 0.8.15

package/dist/scripts/data-transformers/policy-analysis.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @module data-transformers/policy-analysis
+ * @description Policy domain detection and analysis for parliamentary
+ * documents. Detects fiscal, defence, environmental, education, healthcare,
+ * migration, EU, justice, labour, housing, transport, and trade domains
+ * using keyword matching against Swedish document titles.
+ *
+ * Also provides confidence level assessment for intelligence analysis.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+/**
+ * Confidence level for intelligence assessments.
+ * Reflects the quality and quantity of supporting evidence.
+ */
+export type ConfidenceLevel = 'HIGH' | 'MEDIUM' | 'LOW';
+/**
+ * Assess the confidence level of an intelligence analysis based on
+ * the number of corroborating evidence items and the quality of sources.
+ *
+ * @param evidenceCount - Number of distinct evidence items supporting the assessment
+ * @param sourceQuality - Quality score of sources (0-100, higher = better)
+ * @returns Confidence level classification
+ */
+export declare function assessConfidenceLevel(evidenceCount: number, sourceQuality: number): ConfidenceLevel;
+import type { Language } from '../types/language.js';
+import type { RawDocument } from './types.js';
+export type DomainKey = 'fiscal' | 'defence' | 'environment' | 'education' | 'healthcare' | 'migration' | 'eu-foreign' | 'justice' | 'labour' | 'housing' | 'transport' | 'trade';
+/**
+ * Map from canonical domain key to its English display name.
+ * Single source of truth — mirrors DOMAIN_NAMES[key].en for each key.
+ */
+export declare const DOMAIN_KEY_TO_EN: Readonly<Record<DomainKey, string>>;
+/**
+ * Reverse lookup: map any localised domain display name back to its canonical key.
+ * Covers all 14 languages so callers can reliably derive the key from any
+ * string returned by `detectPolicyDomains()`.
+ */
+export declare const DOMAIN_NAME_TO_KEY: Readonly<Record<string, DomainKey>>;
+/**
+ * Detect policy domains from a document's title and committee code.
+ * Returns a deduplicated array of localised domain strings.
+ */
+export declare function detectPolicyDomains(doc: RawDocument, lang?: Language | string): string[];
+/**
+ * Dominant political narrative frames detected in document titles.
+ * These represent recurring rhetorical frames used across parties.
+ */
+export type NarrativeFrame = 'law-and-order' | 'welfare-state-defence' | 'fiscal-responsibility' | 'green-transition' | 'national-security' | 'integration-challenge' | 'eu-sovereignty' | 'workers-rights';
+/**
+ * Detect dominant narrative frames in a document title.
+ * Narrative framing reveals which rhetorical strategies are being employed
+ * regardless of the specific policy domain.
+ *
+ * @param doc - Document to analyse
+ * @returns Array of detected narrative frames (deduplicated)
+ */
+export declare function detectNarrativeFrames(doc: RawDocument): NarrativeFrame[];
+/**
+ * Return a substantive domain-specific and type-specific analysis sentence.
+ * Each of 12 policy domains has tailored text for motions (mot), committee
+ * reports (bet), interpellations (ip), and propositions/default. English and
+ * Swedish are always present; other languages fall back per-key to English.
+ */
+export declare function getDomainSpecificAnalysis(primaryDomain: string, doktyp: string, lang: Language | string): string;
+/**
+ * Generate policy significance context for a document based on its metadata.
+ * Uses the localised policySignificanceTouches label plus a domain-specific
+ * analysis sentence instead of generic boilerplate.
+ * Falls back to a committee-specific sentence (derived from COMMITTEE_NAMES)
+ * when no domain keyword matches but the document's organ field identifies a
+ * known Riksdag committee.
+ * @param impliedDoktyp - document type inferred from the calling context
+ *   ('mot', 'bet', 'prop', 'ip') when doc.doktyp / doc.documentType is absent.
+ */
+export declare function generatePolicySignificance(doc: RawDocument, lang: Language | string, impliedDoktyp?: string): string;
+/**
+ * Generate deep policy analysis for a single document entry.
+ * Only uses `fullText` / `fullContent` (enriched content fetched separately)
+ * as the passage source — summary/notis are already shown in the summary line
+ * above in structured views and must not be duplicated here.
+ * Falls back to generatePolicySignificance when no enriched text is available.
+ * @param impliedDoktyp - document type inferred from the calling context
+ *   ('mot', 'bet', 'prop', 'ip') when doc.doktyp / doc.documentType is absent.
+ */
+export declare function generateDeepPolicyAnalysis(doc: RawDocument, lang: Language | string, impliedDoktyp?: string, maxPassageChars?: number): string;
+/**
+ * Maps policy domain keys to relevant SCB table IDs and search queries
+ * for enriching political analysis with official statistics.
+ *
+ * Each entry contains:
+ * - `query` — Swedish-language search terms for `search_tables()` SCB MCP tool
+ * - `tables` — Known SCB table IDs (e.g. "TAB5765" for unemployment) for `get_table_data()`
+ * - `indicators` — Human-readable indicator names expected from the tables
+ *
+ * SCB MCP tools: search_tables, get_table_data, get_table_variables, preview_data, find_region_code
+ * Source: https://scb-mcp.onrender.com/mcp (PxWebAPI 2.0)
+ */
+export declare const SCB_DOMAIN_TABLES: Readonly<Record<DomainKey, {
+    query: string;
+    tables: string[];
+    indicators: string[];
+}>>;
+//# sourceMappingURL=policy-analysis.d.ts.map

package/dist/scripts/data-transformers/policy-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-analysis.d.ts","sourceRoot":"","sources":["../../../scripts/data-transformers/policy-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,CAenG;AAGD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAe9C,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,GACrF,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAwF1F;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAEnC,CAAC;AAE/B;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAS/D,CAAC;AAKL;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,GAAE,QAAQ,GAAG,MAAa,GAAG,MAAM,EAAE,CA0D9F;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAClB,mBAAmB,GACnB,uBAAuB,GACvB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,EAAE,CA6CxE;AAqOD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAchH;AAuBD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAuDpH;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,eAAe,SAAM,GAAG,MAAM,CAiB3I;AAMD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6DpH,CAAC"}