riksdagsmonitor 0.8.14 → 0.8.15

package/dist/scripts/ai-analysis/document-analyzer.d.ts

@@ -0,0 +1,196 @@
+/**
+ * @module ai-analysis/document-analyzer
+ * @description AI-powered comprehensive document analysis framework for
+ * parliamentary documents, government propositions, and policy papers.
+ *
+ * Provides multi-stakeholder impact assessment, PESTLE analysis, coalition
+ * dynamics, historical context, implementation feasibility, risk assessment,
+ * and confidence scoring through a multi-iteration analysis protocol.
+ *
+ * The framework is the shared analytical backbone consumed by all content
+ * generators and agentic workflows for consistent, high-quality political
+ * intelligence.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import type { RawDocument, CIAContext } from '../data-transformers/types.js';
+import type { Language } from '../types/language.js';
+import type { SwotData } from '../types/article.js';
+import { type ConfidenceLevel, type DomainKey } from '../data-transformers/policy-analysis.js';
+/** Available stakeholder groups that may be relevant for a document */
+export type StakeholderGroup = 'government-coalition' | 'opposition-parties' | 'state-agencies' | 'municipalities-regions' | 'private-sector' | 'labor-market' | 'civil-society' | 'international-eu' | 'media-press' | 'academia-research' | 'citizens-voters';
+/** Direction of impact on a stakeholder */
+export type ImpactDirection = 'positive' | 'negative' | 'neutral' | 'mixed';
+/** Burden level for implementation */
+export type BurdenLevel = 'high' | 'medium' | 'low';
+/** Direct impact assessment for one stakeholder */
+export interface ImpactAssessment {
+    direction: ImpactDirection;
+    magnitude: 'significant' | 'moderate' | 'minor';
+    summary: string;
+}
+/** Full stakeholder impact analysis for a single stakeholder group */
+export interface StakeholderImpact {
+    stakeholder: StakeholderGroup;
+    /** Human-readable name for display */
+    displayName: string;
+    directImpact: ImpactAssessment;
+    /** Secondary / downstream effects */
+    indirectEffects: string[];
+    implementationBurden: BurdenLevel;
+    /** Political positioning implications */
+    politicalImplications: string;
+    /** Per-stakeholder SWOT analysis */
+    swot: SwotData;
+    /** Confidence level for this stakeholder assessment */
+    confidence: ConfidenceLevel;
+}
+/** PESTLE analysis dimensions */
+export interface PESTLEAnalysis {
+    political: string[];
+    economic: string[];
+    social: string[];
+    technological: string[];
+    legal: string[];
+    environmental: string[];
+}
+/** Detected policy domain with relevance score */
+export interface PolicyDomain {
+    key: DomainKey | string;
+    name: string;
+    relevanceScore: number;
+}
+/** Coalition dynamics analysis */
+export interface CoalitionAnalysis {
+    governmentImpact: ImpactDirection;
+    oppositionResponse: string;
+    crossPartyPotential: boolean;
+    stabilityEffect: 'stabilising' | 'neutral' | 'destabilising';
+    summary: string;
+}
+/** Historical and legislative context */
+export interface HistoricalContext {
+    precedents: string[];
+    relatedLegislation: string[];
+    policyEvolution: string;
+}
+/** Implementation feasibility assessment */
+export interface ImplementationAssessment {
+    feasibility: 'high' | 'medium' | 'low';
+    estimatedTimeline: string;
+    keyObstacles: string[];
+    resourceRequirements: string;
+    agenciesInvolved: string[];
+}
+/** Risk factor identified in the document */
+export interface RiskAssessment {
+    type: 'political' | 'implementation' | 'public-acceptance' | 'legal' | 'financial';
+    severity: 'high' | 'medium' | 'low';
+    description: string;
+    mitigationOptions: string[];
+}
+/** One pass of the multi-iteration analysis protocol */
+export interface AnalysisIteration {
+    iteration: 1 | 2 | 3 | 4;
+    label: 'generation' | 'deepening' | 'stakeholder-review' | 'synthesis';
+    summary: string;
+    refinements: string[];
+}
+/** Full document analysis result */
+export interface DocumentAnalysis {
+    /** Document identifier (dok_id or slug) */
+    documentId: string;
+    /** Document title for display */
+    documentTitle: string;
+    /** AI-generated executive summary (2–3 paragraphs) */
+    executiveSummary: string;
+    /** Per-stakeholder impact assessments */
+    stakeholderImpacts: StakeholderImpact[];
+    /** PESTLE dimension analysis */
+    pestleDimensions: PESTLEAnalysis;
+    /** Affected policy domains */
+    policyDomains: PolicyDomain[];
+    /** Coalition dynamics analysis */
+    coalitionDynamics: CoalitionAnalysis;
+    /** Historical and legislative context */
+    historicalContext: HistoricalContext;
+    /** Implementation feasibility */
+    implementationAssessment: ImplementationAssessment;
+    /** Risk factors */
+    riskAssessment: RiskAssessment[];
+    /** Per-dimension confidence scores */
+    confidenceScores: Map<string, ConfidenceLevel>;
+    /** Multi-iteration protocol record */
+    iterations: AnalysisIteration[];
+    /** Overall influence score (0–100) */
+    influenceScore: number;
+    /** ISO-8601 timestamp of analysis */
+    analyzedAt: string;
+}
+/**
+ * Maximum number of entries retained in `_analysisCache`.
+ * When the limit is reached the oldest entry (first inserted — Map iteration
+ * order) is evicted.  This prevents unbounded memory growth in long-running
+ * processes or large batch runs.
+ */
+export declare const MAX_CACHE_SIZE = 500;
+/** Clear the in-process analysis cache (useful for testing). */
+export declare function clearAnalysisCache(): void;
+/**
+ * Precomputed values that are expensive to derive and shared across
+ * multiple builder functions within a single `analyzeDocument()` call.
+ *
+ * By computing `domains` and `influenceScore` once and threading this
+ * context through helpers we avoid 7–11× redundant `detectPolicyDomains()`
+ * and `calculateInfluenceScore()` calls per document.
+ */
+export interface PrecomputedContext {
+    domains: string[];
+    influenceScore: number;
+}
+/**
+ * Determine which stakeholder groups are relevant for a document.
+ * Government coalition, opposition parties, and citizens/voters are always
+ * included; other groups are added based on document-content signals.
+ */
+export declare function selectRelevantStakeholders(doc: RawDocument): StakeholderGroup[];
+/** Build PESTLE analysis dimensions from a document. */
+export declare function buildPestleAnalysis(doc: RawDocument, lang?: Language | string, ctx?: PrecomputedContext): PESTLEAnalysis;
+/** Derive coalition dynamics from document and CIA context. */
+export declare function buildCoalitionDynamics(doc: RawDocument, ciaContext?: CIAContext): CoalitionAnalysis;
+/** Build historical and legislative context (structural inference). */
+export declare function buildHistoricalContext(doc: RawDocument, precomputedDomains?: string[]): HistoricalContext;
+/** Build implementation feasibility assessment from document metadata. */
+export declare function buildImplementationAssessment(doc: RawDocument, ctx?: PrecomputedContext): ImplementationAssessment;
+/** Build risk assessment list for a document. */
+export declare function buildRiskAssessment(doc: RawDocument, ciaContext?: CIAContext, ctx?: PrecomputedContext): RiskAssessment[];
+/** Generate a structured executive summary for a document. */
+export declare function generateExecutiveSummary(doc: RawDocument, lang: Language | string, ctx?: PrecomputedContext): string;
+/**
+ * Analyse a parliamentary document through the comprehensive multi-iteration
+ * framework.  Results are cached by document ID to avoid redundant analysis
+ * when the same document appears in multiple articles.
+ *
+ * @param doc - Raw document from the MCP server
+ * @param lang - Target language for localised display names
+ * @param ciaContext - Optional CIA intelligence context for enriched analysis
+ * @param forceRefresh - Skip cache and recompute (default false)
+ * @returns Full DocumentAnalysis result
+ */
+export declare function analyzeDocument(doc: RawDocument, lang?: Language | string, ciaContext?: CIAContext, forceRefresh?: boolean): DocumentAnalysis;
+/**
+ * Analyse multiple documents in batch, returning a map from document ID to
+ * analysis result.  Uses caching so documents appearing multiple times are
+ * only analysed once.
+ *
+ * When the input array contains multiple versions of the same document
+ * (e.g. a metadata-only record and a content-enriched record sharing the
+ * same `dok_id`), the batch is de-duplicated up-front using a "prefer
+ * enriched" strategy: among entries that share the same stable document
+ * base key, the version with `fullText` or `fullContent` wins.  This
+ * prevents order-dependent overwrites and ensures the richest available
+ * version is analysed.
+ */
+export declare function analyzeDocuments(docs: RawDocument[], lang?: Language | string, ciaContext?: CIAContext): Map<string, DocumentAnalysis>;
+//# sourceMappingURL=document-analyzer.d.ts.map

package/dist/scripts/ai-analysis/document-analyzer.d.ts.map

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