riksdagsmonitor 0.8.15 → 0.8.17

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

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

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