riksdagsmonitor 0.8.14 → 0.8.15

package/dist/scripts/ai-analysis/types.d.ts

@@ -0,0 +1,333 @@
+/**
+ * @module ai-analysis/types
+ * @description TypeScript interfaces for the AI-first analysis pipeline.
+ *
+ * The AI analysis pipeline produces structured intelligence assessments from
+ * parliamentary documents through multiple refinement iterations:
+ *   1. Initial analysis — document classification, entity extraction, domain detection
+ *   2. Refinement     — SWOT enrichment using full-text content from enriched documents
+ *   3. Validation     — stakeholder completeness and confidence scoring (deep mode only)
+ *
+ * Templates in `generators.ts` consume `AnalysisResult` to render HTML sections;
+ * analytical text originates from the analysis pipeline with placeholder fallbacks
+ * when document evidence is missing for a stakeholder × quadrant combination.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import type { Language } from '../types/language.js';
+import type { RawDocument } from '../data-transformers/types.js';
+/**
+ * Controls how many AI analysis iterations run.
+ *
+ * - `quick`    — 1 pass: initial document analysis only (fast, for breaking/time-sensitive)
+ * - `standard` — 2 passes: initial analysis + SWOT refinement (default for most article types)
+ * - `deep`     — 3 passes: initial + refinement + stakeholder validation (deep-inspection)
+ */
+export type AnalysisDepth = 'quick' | 'standard' | 'deep';
+/**
+ * A single SWOT entry backed by evidence extracted from actual document content.
+ * Impact and confidence are derived analytically, not from hardcoded defaults.
+ */
+export interface AnalysisSwotEntry {
+    /** The analytical claim derived from document content. */
+    text: string;
+    /** Evidence rating for this entry. */
+    impact: 'high' | 'medium' | 'low';
+    /**
+     * Source document identifiers that back this entry.
+     * Empty when the entry is a structural placeholder.
+     */
+    sourceDocIds: string[];
+    /**
+     * Confidence rating for this entry: proportion of supporting evidence
+     * relative to total documents in the set.
+     */
+    confidence: 'HIGH' | 'MEDIUM' | 'LOW';
+}
+/** The three well-known stakeholder roles used by the analysis pipeline. */
+export type KnownStakeholderRole = 'government' | 'parliament' | 'private-sector';
+/** The four SWOT quadrant keys. */
+export type SwotQuadrant = 'strengths' | 'weaknesses' | 'opportunities' | 'threats';
+/**
+ * A SWOT matrix for a single stakeholder perspective.
+ * All text fields are AI-derived from document content analysis.
+ */
+export interface AnalysisStakeholderSwot {
+    /** Localised stakeholder name (Government, Parliament, Private Sector, etc.) */
+    name: string;
+    /** Internal role key for cross-language consistency */
+    role: KnownStakeholderRole | (string & {});
+    swot: {
+        strengths: AnalysisSwotEntry[];
+        weaknesses: AnalysisSwotEntry[];
+        opportunities: AnalysisSwotEntry[];
+        threats: AnalysisSwotEntry[];
+    };
+}
+/**
+ * A single watch point derived from document analysis.
+ * Replaces hardcoded watch-point templates.
+ *
+ * All string fields (`title`, `description`) contain **plain text** — they
+ * must be escaped via `escapeHtml()` at the call site before passing to
+ * `generateWatchSection()`, which renders pre-escaped HTML (it does not
+ * escape itself). The escaping call site is in `generators.ts` inside the
+ * deep-inspection path. This is consistent with the escaping contract for
+ * all other pipeline outputs (SWOT entries, mindmap items, dashboard labels)
+ * where renderers receive plain text and escape at interpolation time.
+ */
+export interface AnalysisWatchPoint {
+    /** Plain-text watch point heading (must be escaped before passing to generateWatchSection) */
+    title: string;
+    /** Plain-text watch point body (must be escaped before passing to generateWatchSection) */
+    description: string;
+    /** Urgency level for display sorting */
+    urgency: 'critical' | 'high' | 'medium' | 'low';
+    /** Document IDs that triggered this watch point */
+    sourceDocIds: string[];
+}
+/**
+ * A branch in the conceptual mindmap derived from document analysis.
+ */
+export interface AnalysisMindmapBranch {
+    label: string;
+    color: 'cyan' | 'green' | 'yellow' | 'purple' | 'orange' | 'magenta';
+    icon: string;
+    items: string[];
+}
+/**
+ * Policy domain assessment derived from document analysis.
+ */
+export interface PolicyAssessment {
+    /** Detected policy domains (localised) */
+    domains: string[];
+    /** Primary domain focus */
+    primaryDomain: string | null;
+    /**
+     * Brief narrative assessment of the policy landscape.
+     * Derived from document content, not templates.
+     */
+    narrative: string;
+    /** Overall confidence in the assessment */
+    confidence: 'HIGH' | 'MEDIUM' | 'LOW';
+}
+/**
+ * Structured dashboard data derived from document analysis.
+ */
+export interface DashboardData {
+    /** Title for the dashboard section */
+    title: string;
+    /** Summary text */
+    summary: string;
+    /** Chart label-value pairs for document type distribution */
+    typeDistribution: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+}
+/**
+ * The complete output of the AI analysis pipeline for a given document set.
+ * This is the single source of truth for all analytical content in the article.
+ */
+export interface AnalysisResult {
+    /** Stakeholder SWOT analyses — all text derived from document content */
+    stakeholderSwot: AnalysisStakeholderSwot[];
+    /** Policy domain assessment */
+    policyAssessment: PolicyAssessment;
+    /** Mindmap branches derived from analysis */
+    mindmapBranches: AnalysisMindmapBranch[];
+    /** Dashboard data for visualisation */
+    dashboardData: DashboardData;
+    /** Watch points for the article sidebar */
+    watchPoints: AnalysisWatchPoint[];
+    /**
+     * Overall confidence score (0-100) for the analysis.
+     * Higher values indicate more enriched documents and stronger evidence.
+     */
+    confidenceScore: number;
+    /** Number of analysis iterations completed */
+    iterationsCompleted: number;
+    /** ISO timestamp of when analysis was completed */
+    completedAt: string;
+    /** Language of the analysis */
+    lang: Language;
+    /** Number of documents analysed */
+    documentCount: number;
+    /** Number of metadata-enriched documents (contentFetched = true).
+     *  This counts documents whose metadata was fetched via enrichDocumentsWithContent(),
+     *  regardless of whether full text is available. */
+    enrichedCount: number;
+    /** Focus topic (null if multi-document analysis without topic) */
+    focusTopic: string | null;
+}
+/**
+ * Result of validating an analysis for completeness and depth.
+ */
+export interface ValidationResult {
+    /** Whether the analysis meets the minimum quality threshold */
+    passed: boolean;
+    /** Quality score (0-100) */
+    score: number;
+    /** Specific issues found during validation */
+    issues: string[];
+    /** Suggested improvements (informational, not blocking) */
+    suggestions: string[];
+}
+/**
+ * Options controlling the analysis pipeline execution.
+ */
+export interface AnalysisPipelineOptions {
+    /** How many AI iterations to run (default: 'standard') */
+    depth: AnalysisDepth;
+    /** Language for localised analysis output */
+    lang: Language;
+    /** Optional focus topic — analysis is exclusively scoped to this topic when provided */
+    focusTopic: string | null;
+}
+/**
+ * The AI analysis pipeline contract.
+ *
+ * Lifecycle for a `deep` analysis:
+ *   1. `analyzeDocuments` — iteration 1: initial extraction from document metadata + content
+ *   2. `refineAnalysis`   — iteration 2: enrich SWOT entries using full document text
+ *   3. `validateCompleteness` — iteration 3: check stakeholder coverage and confidence
+ *
+ * For `standard` depth, only iterations 1-2 run.
+ * For `quick` depth, only iteration 1 runs.
+ */
+export interface AnalysisPipeline {
+    /**
+     * Iteration 1: Analyse documents and produce an initial AnalysisResult.
+     * Extracts document types, detected policy domains, entities, and
+     * assembles initial SWOT entries from document titles and available metadata.
+     */
+    analyzeDocuments(docs: RawDocument[], options: AnalysisPipelineOptions): Promise<AnalysisResult>;
+    /**
+     * Iteration 2: Refine the initial analysis using full document text.
+     * Replaces generic SWOT entries with content-derived insights when
+     * enriched document text is available. Adds additional watch points
+     * and strengthens confidence scores.
+     *
+     * When no documents are enriched, the analysis content (SWOT, watch
+     * points, etc.) remains unchanged but metadata fields
+     * (`iterationsCompleted`, `completedAt`) are always updated.
+     */
+    refineAnalysis(initial: AnalysisResult, docs: RawDocument[], options: AnalysisPipelineOptions): Promise<AnalysisResult>;
+    /**
+     * Iteration 3: Validate completeness of the analysis.
+     * Checks that all three stakeholder perspectives have substantive entries,
+     * that policy domains are correctly identified, and that confidence
+     * thresholds are met.
+     *
+     * Returns a ValidationResult with a score and improvement suggestions.
+     * Does not modify the AnalysisResult — call `refineAnalysis` again if
+     * the score is below threshold.
+     */
+    validateCompleteness(analysis: AnalysisResult, docs: RawDocument[]): Promise<ValidationResult>;
+}
+/**
+ * Metadata record written after each analysis run for audit and debugging.
+ * Stored as `news/metadata/ai-analysis-<slug>-<lang>.json`.
+ */
+export interface AnalysisIterationMetadata {
+    /** Article slug this analysis was produced for */
+    articleSlug: string;
+    /** Language of the analysis */
+    lang: Language;
+    /** Analysis depth used */
+    depth: AnalysisDepth;
+    /** Number of iterations completed */
+    iterationsCompleted: number;
+    /** Per-iteration duration in milliseconds */
+    iterationDurationsMs: number[];
+    /** Final confidence score */
+    confidenceScore: number;
+    /** Validation result (null when depth < 'deep') */
+    validationResult: ValidationResult | null;
+    /** Number of documents analysed */
+    documentCount: number;
+    /** Number of metadata-enriched documents (contentFetched = true) */
+    enrichedCount: number;
+    /** Focus topic (null if none) */
+    focusTopic: string | null;
+    /** ISO timestamp when analysis completed */
+    completedAt: string;
+}
+/** Stress level derived from document-type patterns within the analysed set. */
+export type CoalitionStressLevel = 'low' | 'medium' | 'high';
+/**
+ * Result of coalition tension detection from a document set.
+ * Summarises coalition pressure based on challenge-document ratios and
+ * the balance between government- and opposition-aligned documents.
+ *
+ * The current detector infers potential coalition tension by looking at the balance
+ * between government-initiated documents (e.g. propositions, SFS, government
+ * communications) and challenge-type documents (e.g. motions, interpellations).
+ * Committee reports are treated as neutral and excluded from both counts.
+ * A higher share of challenge documents is treated as a proxy for increased
+ * political stress.
+ *
+ * Note: this analysis does NOT use party metadata or model detailed convergence /
+ * divergence patterns between individual parties; it is purely document-type-based.
+ */
+export interface CoalitionTensionResult {
+    /** Overall coalition stress level derived from the document-type mix. */
+    stressLevel: CoalitionStressLevel;
+    /** Human-readable narrative explaining the detected tension heuristic. */
+    narrative: string;
+    /**
+     * Number of government-initiated documents in the set
+     * (e.g. propositions, SFS, government communications, ds, sou, dir).
+     * Committee reports (bet) are excluded as neutral.
+     */
+    governmentDocCount: number;
+    /**
+     * Number of challenge-type documents in the set
+     * (e.g. motions, interpellations), used as a proxy for opposition pressure.
+     */
+    oppositionDocCount: number;
+    /**
+     * Ratio of challenge-type documents to all classified documents
+     * (government + opposition; committee reports excluded from denominator).
+     */
+    challengeRatio: number;
+    /** Document IDs supporting the tension assessment. */
+    sourceDocIds: string[];
+}
+/**
+ * Interface for SWOT entry generation — heuristic or LLM-backed.
+ * Swap the implementation to integrate an LLM without changing callers.
+ */
+export interface SwotEntryGenerator {
+    /** Build an evidence-backed SWOT entry from a single document. */
+    buildEntry(doc: RawDocument, topic: string | null, lang: Language, passageMaxChars: number): AnalysisSwotEntry;
+    /** Build a structural placeholder when no documents exist for a quadrant. */
+    buildPlaceholder(role: KnownStakeholderRole, quadrant: SwotQuadrant, topic: string | null, lang: Language, domains: string[]): AnalysisSwotEntry;
+}
+/**
+ * Interface for confidence scoring — heuristic or LLM-calibrated.
+ */
+export interface ConfidenceScorer {
+    /** Calculate overall confidence from document evidence and SWOT quality. */
+    calculateScore(docs: RawDocument[], stakeholderSwot: AnalysisStakeholderSwot[]): number;
+}
+/**
+ * Interface for coalition tension detection — heuristic or LLM-backed.
+ */
+export interface CoalitionTensionDetector {
+    /** Detect coalition tension from a document set. */
+    detect(docs: RawDocument[], lang: Language): CoalitionTensionResult;
+}
+/**
+ * Interface for watch-point urgency classification — heuristic or LLM-backed.
+ */
+export interface UrgencyClassifier {
+    /** Classify urgency from document type and context. */
+    classify(docType: string, docCount: number, context: {
+        hasFullText: boolean;
+        hasPendingVote: boolean;
+    }): 'critical' | 'high' | 'medium' | 'low';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scripts/ai-analysis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../scripts/ai-analysis/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAMjE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAM1D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC;;;OAGG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,4EAA4E;AAC5E,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAElF,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,GAAG,SAAS,CAAC;AAEpF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,oBAAoB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC3C,IAAI,EAAE;QACJ,SAAS,EAAE,iBAAiB,EAAE,CAAC;QAC/B,UAAU,EAAE,iBAAiB,EAAE,CAAC;QAChC,aAAa,EAAE,iBAAiB,EAAE,CAAC;QACnC,OAAO,EAAE,iBAAiB,EAAE,CAAC;KAC9B,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChD,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,gBAAgB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,eAAe,EAAE,uBAAuB,EAAE,CAAC;IAC3C,+BAA+B;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,6CAA6C;IAC7C,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,uCAAuC;IACvC,aAAa,EAAE,aAAa,CAAC;IAC7B,2CAA2C;IAC3C,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB;;wDAEoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAMD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,KAAK,EAAE,aAAa,CAAC;IACrB,6CAA6C;IAC7C,IAAI,EAAE,QAAQ,CAAC;IACf,wFAAwF;IACxF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,gBAAgB,CACd,IAAI,EAAE,WAAW,EAAE,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B;;;;;;;;;OASG;IACH,cAAc,CACZ,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,WAAW,EAAE,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B;;;;;;;;;OASG;IACH,oBAAoB,CAClB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,WAAW,EAAE,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAMD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,0BAA0B;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,qCAAqC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,WAAW,EAAE,oBAAoB,CAAC;IAClC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,UAAU,CACR,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,QAAQ,EACd,eAAe,EAAE,MAAM,GACtB,iBAAiB,CAAC;IAErB,6EAA6E;IAC7E,gBAAgB,CACd,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,EAAE,GAChB,iBAAiB,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,cAAc,CACZ,IAAI,EAAE,WAAW,EAAE,EACnB,eAAe,EAAE,uBAAuB,EAAE,GACzC,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,MAAM,CACJ,IAAI,EAAE,WAAW,EAAE,EACnB,IAAI,EAAE,QAAQ,GACb,sBAAsB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,GACzD,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC3C"}

package/dist/scripts/ai-analysis/types.js

@@ -0,0 +1,19 @@
+/**
+ * @module ai-analysis/types
+ * @description TypeScript interfaces for the AI-first analysis pipeline.
+ *
+ * The AI analysis pipeline produces structured intelligence assessments from
+ * parliamentary documents through multiple refinement iterations:
+ *   1. Initial analysis — document classification, entity extraction, domain detection
+ *   2. Refinement     — SWOT enrichment using full-text content from enriched documents
+ *   3. Validation     — stakeholder completeness and confidence scoring (deep mode only)
+ *
+ * Templates in `generators.ts` consume `AnalysisResult` to render HTML sections;
+ * analytical text originates from the analysis pipeline with placeholder fallbacks
+ * when document evidence is missing for a stakeholder × quadrant combination.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scripts/ai-analysis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../scripts/ai-analysis/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/scripts/ai-analysis/visualisation/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module ai-analysis/visualisation
+ * @description Mindmap branch and dashboard data builders extracted from the
+ *   monolithic analysis pipeline.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import type { Language } from '../../types/language.js';
+import type { RawDocument } from '../../data-transformers/types.js';
+import type { AnalysisMindmapBranch, DashboardData } from '../types.js';
+export declare function narrativeFramesLabel(lang: Language): string;
+export declare function buildMindmapBranches(docs: RawDocument[], topic: string | null, domains: string[], lang: Language): AnalysisMindmapBranch[];
+export declare function buildDashboardData(docs: RawDocument[], topic: string | null, lang: Language): DashboardData;
+//# sourceMappingURL=index.d.ts.map

package/dist/scripts/ai-analysis/visualisation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../scripts/ai-analysis/visualisation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2FxE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAG3D;AAMD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EAAE,EACnB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,QAAQ,GACb,qBAAqB,EAAE,CAgEzB;AAMD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EAAE,EACnB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,QAAQ,GACb,aAAa,CAoBf"}

package/dist/scripts/ai-analysis/visualisation/index.js

@@ -0,0 +1,179 @@
+/**
+ * @module ai-analysis/visualisation
+ * @description Mindmap branch and dashboard data builders extracted from the
+ *   monolithic analysis pipeline.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import { detectNarrativeFrames } from '../../data-transformers/policy-analysis.js';
+import { localizeDocType } from '../../data-transformers/content-generators/index.js';
+import { normalizedDocType } from '../helpers.js';
+import { GOV_NAMES, OPP_NAMES, PRIVATE_NAMES } from '../swot/index.js';
+import { DASHBOARD_DOCS_ANALYSED } from '../domains/index.js';
+// ---------------------------------------------------------------------------
+// Palette for dashboard type distribution charts
+// ---------------------------------------------------------------------------
+const TYPE_PALETTE = [
+    '#00d9ff', '#ff006e', '#ffbe0b', '#7b2fff', '#00c58e',
+    '#ff6b35', '#4dd0e1', '#f48fb1', '#a5d6a7', '#ce93d8',
+];
+/**
+ * Stable type→color mapping so the same doc type always gets the same color
+ * regardless of document encounter order. Known types get fixed assignments;
+ * unknown types fall through to the palette by sorted-key index.
+ */
+const STABLE_TYPE_COLORS = {
+    prop: '#00d9ff', // propositions (government bills)
+    mot: '#ff006e', // motions (opposition proposals)
+    bet: '#ffbe0b', // betänkanden (committee reports)
+    sfs: '#7b2fff', // enacted laws/statutes
+    ip: '#00c58e', // interpellations
+    fpm: '#ff6b35', // EU position papers (faktapromemorior)
+    skr: '#4dd0e1', // government written communications
+    ds: '#f48fb1', // departmental memoranda
+    sou: '#a5d6a7', // government inquiry reports
+    dir: '#ce93d8', // commission directives
+    pressm: '#ff8a65', // pressmeddelanden (press releases)
+    ext: '#81d4fa', // external documents / references
+    other: '#cfd8dc', // miscellaneous / uncategorised documents
+};
+// ---------------------------------------------------------------------------
+// Data source labels (14 languages)
+// ---------------------------------------------------------------------------
+const DATA_SOURCE_LABELS = {
+    en: 'Data Sources', sv: 'Datakällor', da: 'Datakilder', no: 'Datakilder',
+    fi: 'Tietolähteet', de: 'Datenquellen', fr: 'Sources de données', es: 'Fuentes de datos',
+    nl: 'Gegevensbronnen', ar: 'مصادر البيانات', he: 'מקורות נתונים',
+    ja: 'データソース', ko: '데이터 출처', zh: '数据来源',
+};
+const DATA_SOURCE_ITEMS = {
+    en: ['Riksdag MCP (laws, motions, propositions)', 'World Bank (economic indicators)', 'SCB Statistics Sweden'],
+    sv: ['Riksdagens MCP (lagar, motioner, propositioner)', 'Världsbanken (ekonomiska indikatorer)', 'SCB Statistikmyndigheten'],
+    da: ['Riksdag MCP (love, motioner, forslag)', 'Verdensbanken (økonomiske indikatorer)', 'SCB Statistikmyndigheten'],
+    no: ['Riksdag MCP (lover, motioner, proposisjoner)', 'Verdensbanken (økonomiske indikatorer)', 'SCB Statistikmyndigheten'],
+    fi: ['Riksdagin MCP (lait, kirjelmät, esitykset)', 'Maailmanpankki (taloudelliset indikaattorit)', 'SCB Tilastoviranomainen'],
+    de: ['Riksdag MCP (Gesetze, Anträge, Vorlagen)', 'Weltbank (Wirtschaftsindikatoren)', 'SCB Statistikmyndigheten'],
+    fr: ['Riksdag MCP (lois, motions, propositions)', 'Banque mondiale (indicateurs économiques)', 'SCB Statistikmyndigheten'],
+    es: ['Riksdag MCP (leyes, mociones, proposiciones)', 'Banco Mundial (indicadores económicos)', 'SCB Statistikmyndigheten'],
+    nl: ['Riksdag MCP (wetten, moties, voorstellen)', 'Wereldbank (economische indicatoren)', 'SCB Statistikmyndigheten'],
+    ar: ['ريكسداغ MCP (قوانين، اقتراحات)', 'البنك الدولي (مؤشرات اقتصادية)', 'SCB إحصاء السويد'],
+    he: ['ריקסדאג MCP (חוקים, הצעות)', 'הבנק העולמי (אינדיקטורים כלכליים)', 'SCB הלשכה המרכזית לסטטיסטיקה'],
+    ja: ['Riksdag MCP (法律・動議・提案)', '世界銀行（経済指標）', 'SCB スウェーデン統計局'],
+    ko: ['Riksdag MCP (법률, 동의, 제안)', '세계은행 (경제 지표)', 'SCB 스웨덴 통계청'],
+    zh: ['议会 MCP（法律、动议、提案）', '世界银行（经济指标）', 'SCB 瑞典统计局'],
+};
+// ---------------------------------------------------------------------------
+// Dashboard labels (14 languages)
+// ---------------------------------------------------------------------------
+const DASHBOARD_TITLE = {
+    en: 'Document Intelligence', sv: 'Dokumentintelligens',
+    da: 'Dokumentefterretning', no: 'Dokumentetterretning',
+    fi: 'Asiakirjatiedustelu', de: 'Dokumentenintelligenz',
+    fr: 'Renseignement documentaire', es: 'Inteligencia documental',
+    nl: 'Documentintelligentie', ar: 'استخبارات الوثائق',
+    he: 'מודיעין מסמכים', ja: '文書インテリジェンス', ko: '문서 인텔리전스', zh: '文件情报',
+};
+// ---------------------------------------------------------------------------
+// Localised section labels
+// ---------------------------------------------------------------------------
+function docTypesLabel(lang) {
+    const m = { en: 'Document Types', sv: 'Dokumenttyper', da: 'Dokumenttyper', no: 'Dokumenttyper', fi: 'Asiakirjatyypit', de: 'Dokumenttypen', fr: 'Types de documents', es: 'Tipos de documentos', nl: 'Documenttypen', ar: 'أنواع الوثائق', he: 'סוגי מסמכים', ja: '文書種類', ko: '문서 유형', zh: '文件类型' };
+    return m[lang] ?? m.en;
+}
+function policyDomainsLabel(lang) {
+    const m = { en: 'Policy Domains', sv: 'Politikområden', da: 'Politikområder', no: 'Politikkområder', fi: 'Politiikka-alueet', de: 'Politikbereiche', fr: 'Domaines politiques', es: 'Áreas de política', nl: 'Beleidsdomeinen', ar: 'مجالات السياسة', he: 'תחומי מדיניות', ja: '政策分野', ko: '정책 영역', zh: '政策领域' };
+    return m[lang] ?? m.en;
+}
+function stakeholdersLabel(lang) {
+    const m = { en: 'Stakeholders', sv: 'Intressenter', da: 'Interessenter', no: 'Interessenter', fi: 'Sidosryhmät', de: 'Stakeholder', fr: 'Parties prenantes', es: 'Partes interesadas', nl: 'Belanghebbenden', ar: 'أصحاب المصلحة', he: 'בעלי עניין', ja: 'ステークホルダー', ko: '이해관계자', zh: '利益相关者' };
+    return m[lang] ?? m.en;
+}
+export function narrativeFramesLabel(lang) {
+    const m = { en: 'Narrative Frames', sv: 'Narrativa ramar', da: 'Narrative rammer', no: 'Narrative rammer', fi: 'Narratiiviset kehykset', de: 'Narrative Rahmen', fr: 'Cadres narratifs', es: 'Marcos narrativos', nl: 'Narratieve frames', ar: 'الإطارات السردية', he: 'מסגרות נרטיביות', ja: '物語フレーム', ko: '서사 프레임', zh: '叙事框架' };
+    return m[lang] ?? m.en;
+}
+// ---------------------------------------------------------------------------
+// Mindmap branch builder
+// ---------------------------------------------------------------------------
+export function buildMindmapBranches(docs, topic, domains, lang) {
+    const branches = [];
+    // Document type branch
+    const typeCounts = {};
+    docs.forEach(d => {
+        const t = normalizedDocType(d);
+        typeCounts[t] = (typeCounts[t] || 0) + 1;
+    });
+    const typeKeys = Object.keys(typeCounts).sort();
+    if (typeKeys.length > 0) {
+        branches.push({
+            label: docTypesLabel(lang),
+            color: 'cyan',
+            icon: '📄',
+            items: typeKeys.map(t => `${localizeDocType(t, lang, typeCounts[t] ?? 0)} (${typeCounts[t] ?? 0})`),
+        });
+    }
+    // Policy domains branch
+    if (domains.length > 0) {
+        branches.push({
+            label: policyDomainsLabel(lang),
+            color: 'green',
+            icon: '🏛️',
+            items: domains,
+        });
+    }
+    // Stakeholder branch
+    branches.push({
+        label: stakeholdersLabel(lang),
+        color: 'yellow',
+        icon: '👥',
+        items: [
+            GOV_NAMES[lang] ?? GOV_NAMES.en,
+            OPP_NAMES[lang] ?? OPP_NAMES.en,
+            PRIVATE_NAMES[lang] ?? PRIVATE_NAMES.en,
+        ],
+    });
+    // Data sources branch
+    branches.push({
+        label: DATA_SOURCE_LABELS[lang] ?? DATA_SOURCE_LABELS.en,
+        color: 'purple',
+        icon: '📊',
+        items: DATA_SOURCE_ITEMS[lang] ?? DATA_SOURCE_ITEMS.en,
+    });
+    // Topic-derived focus branch (only when topic is provided)
+    if (topic) {
+        const allFrames = new Set();
+        docs.slice(0, 15).forEach(d => detectNarrativeFrames(d).forEach(f => allFrames.add(f)));
+        if (allFrames.size > 0) {
+            branches.push({
+                label: narrativeFramesLabel(lang),
+                color: 'orange',
+                icon: '🎯',
+                items: [...allFrames].slice(0, 6),
+            });
+        }
+    }
+    return branches;
+}
+// ---------------------------------------------------------------------------
+// Dashboard data builder
+// ---------------------------------------------------------------------------
+export function buildDashboardData(docs, topic, lang) {
+    const typeCounts = {};
+    docs.forEach(d => {
+        const t = normalizedDocType(d);
+        typeCounts[t] = (typeCounts[t] || 0) + 1;
+    });
+    const typeKeys = Object.keys(typeCounts).sort();
+    const typeDistribution = typeKeys.map((t, i) => ({
+        label: localizeDocType(t, lang, typeCounts[t] ?? 0),
+        value: typeCounts[t] ?? 0,
+        color: STABLE_TYPE_COLORS[t] ?? TYPE_PALETTE[i % TYPE_PALETTE.length] ?? '#00d9ff',
+    }));
+    const docIntelLabel = DASHBOARD_TITLE[lang] ?? DASHBOARD_TITLE.en;
+    const title = topic ? `${docIntelLabel} — ${topic}` : docIntelLabel;
+    const docsAnalysedFn = DASHBOARD_DOCS_ANALYSED[lang] ?? DASHBOARD_DOCS_ANALYSED.en;
+    const summary = docsAnalysedFn(docs.length);
+    return { title, summary, typeDistribution };
+}
+//# sourceMappingURL=index.js.map

package/dist/scripts/ai-analysis/visualisation/index.js.map

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

package/dist/scripts/analysis-framework/cross-reference.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @module analysis-framework/cross-reference
+ * @description Cross-document relationship detection for parliamentary document batches.
+ *
+ * Detects the following relationship types between documents:
+ * - `responds-to`   — Motion responding to a government proposition
+ * - `amends`        — Amendment document modifying an existing act
+ * - `implements`    — Implementation measure for an EU directive or treaty commitment
+ * - `contradicts`   — Conflicting policy positions between two documents
+ * - `related-topic` — Thematically related documents sharing policy domains
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import type { RawDocument } from '../data-transformers/types.js';
+import type { DocumentLink } from './types.js';
+export declare function docId(doc: RawDocument): string;
+/**
+ * Detect cross-document relationships in a batch of parliamentary documents.
+ *
+ * Identifies five relationship types:
+ * - `responds-to`   — Motion cites a government proposition
+ * - `implements`    — Implementation document for an EU directive or treaty
+ * - `amends`        — Document explicitly amending earlier legislation
+ * - `contradicts`   — Documents with opposing policy positions
+ * - `related-topic` — Thematically related documents (≥2 shared domains)
+ *
+ * @param docs            - Batch of documents to cross-reference
+ * @param precomputedMap  - Optional pre-computed domain map (docId → domains).
+ *                          When provided, avoids redundant `detectPolicyDomains`
+ *                          calls for documents already analysed in `analyzeDocuments()`.
+ * @returns               Deduplicated array of detected `DocumentLink` objects
+ */
+export declare function detectCrossDocumentLinks(docs: RawDocument[], precomputedMap?: Map<string, string[]>): DocumentLink[];
+//# sourceMappingURL=cross-reference.d.ts.map

package/dist/scripts/analysis-framework/cross-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-reference.d.ts","sourceRoot":"","sources":["../../../scripts/analysis-framework/cross-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAuC/C,wBAAgB,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAE9C;AAqPD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,WAAW,EAAE,EACnB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACrC,YAAY,EAAE,CAoBhB"}