riksdagsmonitor 0.8.14 → 0.8.15

package/dist/scripts/ai-analysis/political-significance.js

@@ -0,0 +1,227 @@
+/**
+ * @module ai-analysis/political-significance
+ * @description Political significance scoring for news generation pipelines.
+ *
+ * Produces a 0–100 score reflecting a document set's overall political
+ * significance, plus an editorial urgency label. Used by:
+ * - Real-time monitor to gate article generation (≥ 60 threshold)
+ * - Breaking news generator to classify urgency
+ * - Workflow-state coordinator to prioritise high-significance articles
+ * - Article template for machine-readable metadata
+ *
+ * Scoring signals:
+ * 1. Document type weight       (40 %)
+ * 2. Volume / party breadth     (20 %)
+ * 3. Opposition pressure        (20 %)
+ * 4. Historical rarity / topic  (20 %)
+ *
+ * The function is **pure** — deterministic for the same input, no randomness.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+// ---------------------------------------------------------------------------
+// Default threshold
+// ---------------------------------------------------------------------------
+/** Default minimum significance score for breaking-news generation */
+export const BREAKING_NEWS_THRESHOLD = 60;
+// ---------------------------------------------------------------------------
+// Document type weights (normalised to 0-100 scale)
+// ---------------------------------------------------------------------------
+/**
+ * Base weight per document type, reflecting parliamentary significance.
+ * Values are on a 0-100 scale.
+ */
+const DOC_TYPE_WEIGHTS = {
+    prop: 60, // Government bill
+    bet: 70, // Committee report (pending vote)
+    prot: 55, // Plenary minutes
+    ip: 45, // Interpellation
+    mot: 35, // Motion
+    skr: 50, // Government communication
+    sou: 55, // Government official report (SOU)
+    ds: 40, // Departmental series
+    dir: 35, // Committee directive
+    fr: 25, // Written question
+    frs: 25, // Response to written question
+    sfs: 65, // Swedish Code of Statutes
+    fpm: 40, // EU factual memorandum
+};
+const DEFAULT_DOC_TYPE_WEIGHT = 30;
+const DOC_TYPE_ALIASES = {
+    proposition: 'prop',
+    propositioner: 'prop',
+    betankande: 'bet',
+    betankanden: 'bet',
+    kommittebetankande: 'bet',
+    protokoll: 'prot',
+    interpellation: 'ip',
+    interpellationer: 'ip',
+    motion: 'mot',
+    motioner: 'mot',
+    skrivelse: 'skr',
+    fragor: 'fr',
+    fraga: 'fr',
+    fraga_svar: 'frs',
+    question: 'fr',
+    committee_report: 'bet',
+    government_bill: 'prop',
+};
+function normalizeDocType(doc) {
+    const fallbackType = doc.type;
+    const rawDocType = String(doc.doktyp ?? doc.documentType ?? fallbackType ?? '').trim().toLowerCase();
+    return DOC_TYPE_ALIASES[rawDocType] ?? rawDocType;
+}
+// ---------------------------------------------------------------------------
+// Signal scorers (each returns 0-100)
+// ---------------------------------------------------------------------------
+/**
+ * Score based on the most significant document type in the set.
+ * Uses the maximum type weight across all documents.
+ */
+function scoreDocumentType(docs) {
+    if (docs.length === 0)
+        return 0;
+    let maxWeight = 0;
+    for (const doc of docs) {
+        const docType = normalizeDocType(doc);
+        const weight = DOC_TYPE_WEIGHTS[docType] ?? DEFAULT_DOC_TYPE_WEIGHT;
+        if (weight > maxWeight)
+            maxWeight = weight;
+    }
+    return maxWeight;
+}
+/**
+ * Score based on the volume of documents and breadth of parties involved.
+ * - Multiple documents increase significance (diminishing returns)
+ * - Multiple parties (signatories) increase significance
+ */
+function scoreVolume(docs) {
+    if (docs.length === 0)
+        return 0;
+    // Volume: logarithmic scaling for document count
+    const volumeScore = Math.min(50, Math.round(Math.log2(docs.length + 1) * 15));
+    // Party breadth: unique parties involved
+    const parties = new Set();
+    for (const doc of docs) {
+        const party = doc.parti;
+        if (party)
+            parties.add(party.toUpperCase());
+    }
+    const partyScore = Math.min(50, parties.size * 10);
+    return Math.min(100, volumeScore + partyScore);
+}
+/**
+ * Score based on opposition pressure: interpellations per unique minister.
+ * High interpellation density (multiple IPs to same minister) signals
+ * concentrated political pressure.
+ */
+function scoreOppositionPressure(docs) {
+    const interpellations = docs.filter(d => normalizeDocType(d) === 'ip');
+    if (interpellations.length === 0)
+        return 0;
+    // Count IPs per minister (mottagare)
+    const ministerCounts = new Map();
+    for (const ip of interpellations) {
+        const minister = (ip.mottagare ?? '').trim();
+        if (!minister)
+            continue;
+        ministerCounts.set(minister, (ministerCounts.get(minister) || 0) + 1);
+    }
+    if (ministerCounts.size === 0)
+        return 0;
+    // Max pressure on any single minister
+    let maxPressure = 0;
+    for (const count of ministerCounts.values()) {
+        if (count > maxPressure)
+            maxPressure = count;
+    }
+    // Scale: 1 IP = 20, 2 = 40, 3 = 60, 4 = 80, 5+ = 100
+    return Math.min(100, maxPressure * 20);
+}
+/**
+ * Score based on historical rarity: whether documents' topics appear
+ * in a set of recently covered topics.
+ *
+ * Documents covering topics NOT seen in the recent window score higher
+ * (novel topics are more newsworthy).
+ *
+ * @param docs - Current document set
+ * @param recentTopics - Topics covered in the last 30 days (titles/keywords)
+ */
+function scoreTopicRarity(docs, recentTopics) {
+    if (docs.length === 0)
+        return 0;
+    const recentLower = new Set(recentTopics.map(t => t.toLowerCase()));
+    // Minimum length for a recent topic to be considered for substring matching.
+    // Very short strings (≤ 3 chars) cause false positives (e.g. "tax" matching "syntax").
+    const MIN_TOPIC_LENGTH_FOR_MATCH = 4;
+    let novelCount = 0;
+    for (const doc of docs) {
+        const title = (doc.titel || doc.title || '').toLowerCase();
+        if (title.length === 0)
+            continue;
+        // If none of the recent topics appear as a substring, it's novel
+        let isNovel = true;
+        for (const recent of recentLower) {
+            if (recent.length >= MIN_TOPIC_LENGTH_FOR_MATCH && title.includes(recent)) {
+                isNovel = false;
+                break;
+            }
+        }
+        if (isNovel)
+            novelCount++;
+    }
+    const novelRatio = novelCount / docs.length;
+    return Math.round(novelRatio * 100);
+}
+// ---------------------------------------------------------------------------
+// Urgency classification
+// ---------------------------------------------------------------------------
+/**
+ * Map a 0-100 score to an editorial urgency label.
+ */
+export function classifyUrgency(score) {
+    if (score >= 80)
+        return 'breaking';
+    if (score >= 60)
+        return 'major';
+    if (score >= 40)
+        return 'standard';
+    return 'background';
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Score a set of parliamentary documents for political significance.
+ *
+ * The function is **deterministic**: identical inputs always produce
+ * identical outputs (no randomness, no date-dependent logic beyond
+ * the explicit `recentTopics` parameter).
+ *
+ * @param docs         - Documents to score
+ * @param recentTopics - Topics covered in the last 30 days (for rarity signal).
+ *                       Pass an empty array when historical context is unavailable.
+ * @returns            Composite significance score (0-100), urgency label, and signal breakdown
+ */
+export function scoreDocuments(docs, recentTopics = []) {
+    const docTypeValue = scoreDocumentType(docs);
+    const volumeValue = scoreVolume(docs);
+    const pressureValue = scoreOppositionPressure(docs);
+    const rarityValue = scoreTopicRarity(docs, recentTopics);
+    const signals = [
+        { signal: 'documentType', weight: 0.40, value: docTypeValue },
+        { signal: 'volume', weight: 0.20, value: volumeValue },
+        { signal: 'oppositionPressure', weight: 0.20, value: pressureValue },
+        { signal: 'topicRarity', weight: 0.20, value: rarityValue },
+    ];
+    const raw = signals.reduce((sum, s) => sum + s.value * s.weight, 0);
+    const score = Math.max(0, Math.min(100, Math.round(raw)));
+    return {
+        score,
+        urgency: classifyUrgency(score),
+        signals,
+    };
+}
+//# sourceMappingURL=political-significance.js.map

package/dist/scripts/ai-analysis/political-significance.js.map

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

package/dist/scripts/ai-analysis/quality-assessor.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @module ai-analysis/quality-assessor
+ * @description Multi-dimensional quality assessment for generated news articles.
+ *
+ * Implements a 6-dimension quality scoring framework:
+ *   1. Factual Accuracy   (25%) — document references match source material
+ *   2. Stakeholder Coverage (20%) — all relevant perspectives represented
+ *   3. Analytical Depth   (20%) — substance beyond surface description
+ *   4. Editorial Consistency (15%) — consistent tone, structure, headings
+ *   5. Evidence Quality   (10%) — assertions backed by document references
+ *   6. Language Quality   (10%) — word count, clarity, readability
+ *
+ * The assessor runs as two passes:
+ *   Pass 1 — compute dimension scores from HTML content
+ *   Pass 2 — aggregate, flag issues, build suggestions list
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+/** Score for a single quality dimension */
+export interface DimensionScore {
+    /** 0–100 score for this dimension */
+    score: number;
+    /** Evidence items used to compute the score */
+    evidence: string[];
+    /** Suggested improvements for this dimension */
+    improvements: string[];
+}
+/** Severity of a quality issue */
+export type QualityIssueSeverity = 'critical' | 'major' | 'minor';
+/** A single quality problem found in the article */
+export interface QualityIssue {
+    severity: QualityIssueSeverity;
+    dimension: string;
+    description: string;
+    suggestedFix: string;
+}
+/** Full multi-dimensional quality assessment result */
+export interface MultiDimensionalQualityAssessment {
+    /** 0–100 weighted overall score */
+    overallScore: number;
+    /** Per-dimension scores */
+    dimensions: {
+        factualAccuracy: DimensionScore;
+        stakeholderCoverage: DimensionScore;
+        analyticalDepth: DimensionScore;
+        editorialConsistency: DimensionScore;
+        evidenceQuality: DimensionScore;
+        languageQuality: DimensionScore;
+    };
+    /** Issues detected (sorted: critical → major → minor) */
+    issues: QualityIssue[];
+    /** Suggested improvements */
+    suggestions: string[];
+    /** Whether the article passes the quality threshold */
+    passesThreshold: boolean;
+    /** Number of assessment passes performed (always ≥ 2) */
+    assessmentPasses: number;
+}
+/**
+ * Run multi-dimensional quality assessment on a generated article.
+ *
+ * The assessment performs two passes:
+ *   Pass 1 — compute all six dimension scores from the HTML content
+ *   Pass 2 — aggregate dimensions into a weighted overall score and build the issues list
+ *
+ * Always returns `assessmentPasses >= 2`.
+ *
+ * @param html            - Full HTML content of the article
+ * @param lang            - ISO 639-1 language code (e.g. "en")
+ * @param sourceDocIds    - Document IDs available in the source data for cross-checking
+ * @param passThreshold   - Minimum overall score to pass (0–100, default 60)
+ */
+export declare function assessArticleQuality(html: string, lang: string, sourceDocIds?: readonly string[], passThreshold?: number): MultiDimensionalQualityAssessment;
+/**
+ * Render a quality assessment as a concise console report.
+ */
+export declare function printQualityReport(assessment: MultiDimensionalQualityAssessment, filename: string): void;
+/**
+ * Inject quality metadata into article HTML as a `<meta>` tag and,
+ * optionally, an inline JSON-LD block.
+ *
+ * **CSP note:** An inline `<script type="application/ld+json">` element is
+ * still an inline script from the browser's perspective.  If the page's
+ * Content-Security-Policy sets `script-src` without `'unsafe-inline'`, the
+ * JSON-LD block will be blocked by the browser.  To keep things safe:
+ *
+ *  - The `<meta name="quality-score">` tag is injected when a `</head>`
+ *    insertion point is found (CSP-safe).
+ *  - The JSON-LD `<script>` block is only injected when `injectJsonLd` is
+ *    `true` (default: `false`).  Callers that know their CSP allows inline
+ *    scripts can opt in.
+ *  - If the HTML contains no `</head>` tag the function returns the original
+ *    HTML unchanged (no injection possible without a `<head>` section).
+ *
+ * @param html          - Original article HTML
+ * @param assessment    - Quality assessment result
+ * @param injectJsonLd  - If `true`, also add the JSON-LD script block
+ *                        (requires CSP to permit inline scripts). Default: `false`.
+ * @returns             Modified HTML with quality metadata injected, or the
+ *                      original HTML if no `</head>` tag is present.
+ */
+export declare function injectQualityMetadata(html: string, assessment: MultiDimensionalQualityAssessment, injectJsonLd?: boolean): string;
+//# sourceMappingURL=quality-assessor.d.ts.map

package/dist/scripts/ai-analysis/quality-assessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-assessor.d.ts","sourceRoot":"","sources":["../../../scripts/ai-analysis/quality-assessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,kCAAkC;AAClC,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAElE,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,uDAAuD;AACvD,MAAM,WAAW,iCAAiC;IAChD,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,UAAU,EAAE;QACV,eAAe,EAAE,cAAc,CAAC;QAChC,mBAAmB,EAAE,cAAc,CAAC;QACpC,eAAe,EAAE,cAAc,CAAC;QAChC,oBAAoB,EAAE,cAAc,CAAC;QACrC,eAAe,EAAE,cAAc,CAAC;QAChC,eAAe,EAAE,cAAc,CAAC;KACjC,CAAC;IACF,yDAAyD;IACzD,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,eAAe,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAmbD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,SAAS,MAAM,EAAO,EACpC,aAAa,SAAK,GACjB,iCAAiC,CAoDnC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,iCAAiC,EAC7C,QAAQ,EAAE,MAAM,GACf,IAAI,CA0BN;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,iCAAiC,EAC7C,YAAY,UAAQ,GACnB,MAAM,CAuCR"}