riksdagsmonitor 0.8.14 → 0.8.15

package/dist/scripts/analysis-reader.d.ts

@@ -0,0 +1,240 @@
+/**
+ * @module analysis-reader
+ * @description Reads pre-computed political intelligence analysis files from
+ * `analysis/daily/YYYY-MM-DD/` and provides a structured TypeScript API for
+ * article generators to consume classification, risk, SWOT, threat, and
+ * significance data.
+ *
+ * Falls back gracefully when analysis files are absent — backward compatible
+ * with article generators that do not yet consume pre-computed analysis.
+ *
+ * @example
+ * ```typescript
+ * import { readDailyAnalysis } from './analysis-reader.js';
+ *
+ * const analysis = await readDailyAnalysis('2026-03-26');
+ * if (analysis.hasAnalysis) {
+ *   const { classification, riskAssessment, significance } = analysis;
+ *   // Enrich article generation with pre-computed intelligence
+ * }
+ * ```
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+import type { UrgencyLabel } from './ai-analysis/political-significance.js';
+/** Political intelligence classification level */
+export type ClassificationLevel = 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+/** Editorial priority level */
+export type PriorityLevel = 'breaking' | 'major' | 'standard' | 'background';
+/** Confidence label for analytical claims */
+export type ConfidenceLabel = 'HIGH' | 'MEDIUM' | 'LOW';
+/** Risk level for political assessments */
+export type RiskLevel = 'high' | 'elevated' | 'moderate' | 'low';
+/** Parsed classification results from `classification-results.md` */
+export interface ClassificationResult {
+    /** Overall classification level */
+    level: ClassificationLevel;
+    /** Editorial priority */
+    priority: PriorityLevel;
+    /** Overall confidence in the classification */
+    confidence: ConfidenceLabel;
+    /** Raw summary text extracted from the markdown */
+    summary: string;
+    /** Document IDs classified in this analysis */
+    documentIds: string[];
+    /** Policy domains identified */
+    domains: string[];
+}
+/** Parsed risk assessment from `risk-assessment.md` */
+export interface RiskAssessment {
+    /** Overall risk level */
+    level: RiskLevel;
+    /** Key risk factors (parsed bullet list) */
+    factors: string[];
+    /** Risk indicators (inline ⚠️ tagged items) */
+    indicators: string[];
+    /** Overall confidence in the risk assessment */
+    confidence: ConfidenceLabel;
+    /** Raw summary text */
+    summary: string;
+}
+/** Single SWOT entry with confidence and impact */
+export interface AnalysisSwotEntry {
+    /** Description text */
+    text: string;
+    /** Confidence level of this entry */
+    confidence: ConfidenceLabel;
+    /** Relative impact */
+    impact?: 'high' | 'medium' | 'low';
+    /** Source document IDs */
+    sourceDocIds?: string[];
+}
+/** Parsed SWOT analysis from `swot-analysis.md` */
+export interface SwotAnalysisResult {
+    /** Subject of the SWOT analysis */
+    subject: string;
+    strengths: AnalysisSwotEntry[];
+    weaknesses: AnalysisSwotEntry[];
+    opportunities: AnalysisSwotEntry[];
+    threats: AnalysisSwotEntry[];
+    /** Additional context note */
+    context?: string;
+}
+/** Democratic health assessment label */
+export type DemocraticHealthLabel = 'HIGH' | 'MEDIUM' | 'LOW' | 'AT_RISK';
+/** Parsed threat analysis from `threat-analysis.md` */
+export interface ThreatAnalysisResult {
+    /** Named threat indicators (🎯 tagged items) */
+    indicators: string[];
+    /** Democratic health assessment (HIGH/MEDIUM/LOW/AT_RISK) */
+    democraticHealth: DemocraticHealthLabel;
+    /** Key threat actors */
+    actors: string[];
+    /** Overall confidence in the threat analysis */
+    confidence: ConfidenceLabel;
+    /** Raw summary text */
+    summary: string;
+}
+/** Parsed stakeholder perspectives from `stakeholder-perspectives.md` */
+export interface StakeholderPerspectivesResult {
+    /** Government/coalition perspective summary */
+    government: string;
+    /** Opposition perspective summary */
+    opposition: string;
+    /** Citizen perspective summary */
+    citizen: string;
+    /** Economic perspective summary */
+    economic: string;
+    /** International perspective summary */
+    international: string;
+    /** Media/discourse perspective summary */
+    media: string;
+}
+/** Parsed significance scoring from `significance-scoring.md` */
+export interface SignificanceScoringResult {
+    /** Significance score (0–100) */
+    score: number;
+    /** Urgency label */
+    urgency: UrgencyLabel;
+    /** Ranked list of most significant documents */
+    topDocuments: Array<{
+        docId: string;
+        score: number;
+        reason: string;
+    }>;
+    /** Overall confidence in significance scoring */
+    confidence: ConfidenceLabel;
+}
+/** Parsed synthesis summary from `synthesis-summary.md` */
+export interface SynthesisSummaryResult {
+    /** Primary narrative direction for the lede */
+    narrativeDirection: string;
+    /** Key themes identified across all documents */
+    keyThemes: string[];
+    /** Recommended article focus */
+    articleFocus: string;
+    /** Forward indicators for "What to Watch Next" */
+    forwardIndicators: string[];
+}
+/** Complete pre-computed daily analysis for a given date */
+export interface DailyAnalysis {
+    /** Date of the analysis (YYYY-MM-DD) */
+    date: string;
+    /** Classification results (from classification-results.md) */
+    classification: ClassificationResult | null;
+    /** Risk assessment (from risk-assessment.md) */
+    riskAssessment: RiskAssessment | null;
+    /** SWOT analysis (from swot-analysis.md) */
+    swot: SwotAnalysisResult | null;
+    /** Threat analysis (from threat-analysis.md) */
+    threatAnalysis: ThreatAnalysisResult | null;
+    /** Stakeholder perspectives (from stakeholder-perspectives.md) */
+    stakeholderPerspectives: StakeholderPerspectivesResult | null;
+    /** Significance scoring (from significance-scoring.md) */
+    significance: SignificanceScoringResult | null;
+    /** Synthesis summary (from synthesis-summary.md) */
+    synthesis: SynthesisSummaryResult | null;
+    /** Whether any analysis files were found */
+    hasAnalysis: boolean;
+}
+/**
+ * Parse `classification-results.md` into a structured ClassificationResult.
+ */
+export declare function parseClassificationResults(markdown: string): ClassificationResult;
+/**
+ * Parse `risk-assessment.md` into a structured RiskAssessment.
+ */
+export declare function parseRiskAssessment(markdown: string): RiskAssessment;
+/**
+ * Parse `swot-analysis.md` into a structured SwotAnalysisResult.
+ */
+export declare function parseSwotAnalysis(markdown: string): SwotAnalysisResult;
+/**
+ * Parse `threat-analysis.md` into a structured ThreatAnalysisResult.
+ */
+export declare function parseThreatAnalysis(markdown: string): ThreatAnalysisResult;
+/**
+ * Parse `stakeholder-perspectives.md` into a structured StakeholderPerspectivesResult.
+ */
+export declare function parseStakeholderPerspectives(markdown: string): StakeholderPerspectivesResult;
+/**
+ * Parse `significance-scoring.md` into a structured SignificanceScoringResult.
+ */
+export declare function parseSignificanceScoring(markdown: string): SignificanceScoringResult;
+/**
+ * Parse `synthesis-summary.md` into a structured SynthesisSummaryResult.
+ */
+export declare function parseSynthesisSummary(markdown: string): SynthesisSummaryResult;
+/**
+ * Read and parse all pre-computed analysis files for a given date.
+ *
+ * @param date - Date string in YYYY-MM-DD format
+ * @param basePath - Optional override for the base analysis directory path
+ * @returns Complete DailyAnalysis object; individual fields are `null` when
+ *          the corresponding file is absent or cannot be parsed.
+ *
+ * @example
+ * ```typescript
+ * const analysis = await readDailyAnalysis('2026-03-26');
+ * if (analysis.hasAnalysis) {
+ *   console.log(analysis.classification?.level); // 'HIGH'
+ *   console.log(analysis.significance?.score);   // 72
+ * }
+ * ```
+ */
+export declare function readDailyAnalysis(date: string, basePath?: string): Promise<DailyAnalysis>;
+/**
+ * Derive the most recent date for which analysis files exist.
+ * Searches backwards from today up to `maxDaysBack` days.
+ *
+ * @param maxDaysBack - Maximum number of days to search back (default 7)
+ * @param basePath - Optional override for the base analysis directory path
+ * @returns ISO date string (YYYY-MM-DD) or `null` if no analysis found
+ */
+export declare function findLatestAnalysisDate(maxDaysBack?: number, basePath?: string): Promise<string | null>;
+/**
+ * Read the most recent available daily analysis.
+ * Convenience wrapper around `findLatestAnalysisDate` + `readDailyAnalysis`.
+ *
+ * @param maxDaysBack - Maximum number of days to search back (default 7)
+ * @param basePath - Optional override for the base analysis directory path
+ * @returns DailyAnalysis for the most recent date found, or a stub with
+ *          `hasAnalysis: false` when no analysis files exist.
+ */
+export declare function readLatestAnalysis(maxDaysBack?: number, basePath?: string): Promise<DailyAnalysis>;
+/**
+ * Derive article classification metadata from a DailyAnalysis.
+ * Returns safe defaults when analysis is absent.
+ *
+ * @param analysis - DailyAnalysis object (may have hasAnalysis: false)
+ * @returns Flattened metadata suitable for ArticleData enrichment
+ */
+export declare function deriveArticleClassificationMeta(analysis: DailyAnalysis): {
+    classificationLevel: ClassificationLevel;
+    riskLevel: RiskLevel;
+    confidenceLabel: ConfidenceLabel;
+    significanceScore: number | undefined;
+    urgency: UrgencyLabel | undefined;
+};
+//# sourceMappingURL=analysis-reader.d.ts.map

package/dist/scripts/analysis-reader.d.ts.map

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