🕵️ Riksdagsmonitor Intelligence Platform — API Reference

Political Intelligence Analysis & OSINT Platform for Swedish Parliament Monitoring — TypeScript SDK, automated dashboards, election forecasting and 14-language news generation, published under Apache-2.0 with SLSA build provenance.

🌐 Live Platform — Discover the Intelligence

These two pages are the canonical entry points for OSINT analysts, journalists, researchers, search-engine crawlers and citizens. Both are auto-generated daily, fully localised across 14 languages, and ship with comprehensive SEO metadata (canonical URLs, Open Graph, Twitter Cards, JSON-LD CollectionPage schema, full hreflang alternates).

Tip: Every URL above also exists in 14 languages — append _<lang> (e.g. political-intelligence_sv.html, sitemap_de.html). hreflang alternates are emitted on every page so search engines surface the correct language variant per region.

📦 npm Package

Shared types, theme system, and dashboard utilities are published as an npm package with provenance:

npm install riksdagsmonitor
Copy

import {
  // Theme system
  DARK_THEME_COLORS, LIGHT_THEME_COLORS,
  getActiveThemeColors, onThemeChange,
  // Chart utilities
  CHART_PALETTE, getChartPalette,
  getResponsiveOptions, createChart,
  // Party colors (Swedish Riksdag)
  getPartyColor,
  // Responsive breakpoints
  BREAKPOINTS,
  // Data loading
  loadJSON, loadCSV, loadText, createDataSource,
  // Types
  type ThemeColors, type Breakpoints,
} from 'riksdagsmonitor';
Copy

The package exports the src/browser/shared/ modules — types, theme constants, chart factory, data loader, DOM utilities, and error boundaries. See the npm package page for full details.

Overview

This API documentation covers the complete Riksdagsmonitor Intelligence Platform — a mixed TypeScript & JavaScript codebase implementing sophisticated intelligence collection, analysis, and visualization for democratic transparency.

Platform Scope

Three-Lens Documentation Framework

Every module in this API is documented through three strategic lenses:

🔍 Intelligence Perspective (@intelligence)

OSINT analysis methodology, data acquisition pipelines, risk assessment frameworks, behavioral profiling models, and intelligence product design. Each module describes its role in the intelligence collection-analysis-dissemination cycle.

💼 Business Perspective (@business)

Revenue model alignment, customer segment value delivery, competitive differentiation, partnership opportunity, and scalability architecture. Evaluates each module's contribution to the platform's commercial sustainability and market position.

📢 Marketing Perspective (@marketing)

Target audience engagement, content generation capability, SEO value, social media shareability, and brand positioning contribution. Maps each module to specific growth channels and user acquisition strategies.

Intelligence Capabilities

🔍 OSINT Data Collection

• stats-loader / cia/data-loader — Multi-source data acquisition with fallback strategies
• Source credibility verification and data integrity validation
• GDPR-compliant political data processing

⚠️ Risk Assessment & Anomaly Detection

• risk-dashboard / anomaly-detection — 45-rule risk scoring engine for 349 MPs
• STRIDE threat modeling integration
• Z-score anomaly detection (|Z| >= 2.0 threshold)

📊 Predictive Intelligence

• cia/election-predictions / pre-election — Electoral forecasting models
• Coalition probability analysis and seat prediction algorithms
• Confidence interval calculations

🏛️ Political Analysis Dashboards

• politician-dashboard / party-dashboard / ministry-dashboard — Career trajectory analytics
• Voting discipline measurement and influence metrics
• Committee effectiveness evaluation

📅 Temporal Pattern Analysis

• seasonal-patterns / election-cycle — Legislative activity cycles
• Pre-election behavioral shifts and long-term political trends

🤝 Coalition Intelligence

• coalition-loader / coalition-dashboard — Coalition stability assessment
• Voting bloc analysis and cross-party cooperation patterns

📰 Intelligence Reporting

• generate-news-enhanced / article-template — Automated news generation
• 14-language narrative synthesis (EN, SV, DA, NO, FI, DE, FR, ES, NL, AR, HE, JA, KO, ZH)
• Editorial standards enforcement with quality scoring

Business Value Architecture

Marketing Content Pipeline

Architecture

riksdagsmonitor/
├── src/browser/                 # TypeScript browser modules (27 files)
│   ├── main.ts                  # Entry point: 12 dashboards, parallel init
│   ├── cia-entry.ts             # CIA Intelligence Dashboard entry point
│   ├── shared/                  # Infrastructure (7 files)
│   │   ├── types.ts             # Intelligence domain type system
│   │   ├── theme.ts             # Cyberpunk design system constants
│   │   ├── chart-factory.ts     # Centralized Chart.js factory
│   │   ├── data-loader.ts       # Resilient data fetching pipeline
│   │   ├── dom-utils.ts         # Accessibility & loading states
│   │   ├── logger.ts            # Debug-gated logging
│   │   └── index.ts             # Barrel exports
│   ├── dashboards/              # Intelligence dashboards (12 files)
│   │   ├── stats-loader.ts      # OSINT statistics acquisition
│   │   ├── risk-dashboard.ts    # 45-rule political risk engine
│   │   ├── party-dashboard.ts   # 50-year party performance analytics
│   │   ├── ministry-dashboard.ts # Executive power assessment
│   │   ├── coalition-loader.ts  # Coalition dynamics data
│   │   ├── coalition-dashboard.ts # Voting pattern visualization
│   │   ├── committees-dashboard.ts # Committee network analytics
│   │   ├── politician-dashboard.ts # Individual MP profiling
│   │   ├── election-cycle.ts    # 40-year electoral cycle analysis
│   │   ├── seasonal-patterns.ts # Quarterly pattern intelligence
│   │   ├── pre-election.ts      # Pre-election monitoring
│   │   └── anomaly-detection.ts # Z-score early warning system
│   ├── cia/                     # CIA Platform integration (5 files)
│   │   ├── data-loader.ts       # 19+ product data pipeline
│   │   ├── visualizations.ts    # Rendering engine
│   │   ├── election-predictions.ts # Electoral forecasting
│   │   ├── i18n-translations.ts # 14-language translations
│   │   └── dashboard-init.ts    # Platform orchestrator
│   └── ui/                      # UI components (1 file)
│       └── back-to-top.ts       # WCAG back-to-top button
├── scripts/                     # Build & automation (42 files)
│   ├── types/                   # TypeScript type definitions (9 files)
│   ├── news-types/              # Article generators (5 files)
│   ├── data-transformers.ts     # Data transformation pipeline
│   ├── generate-news-enhanced.ts # News generation engine
│   ├── extract-news-metadata.ts # News article DB generator
│   ├── mcp-client.ts            # MCP JSON-RPC client
│   ├── article-template.ts      # HTML article rendering
│   └── ...
├── data/                        # Data assets
│   └── news-articles.json       # News metadata database (444 articles)
└── tests/                       # Test suite (35 files, 1200 tests)
Copy

Documentation Standards

All documentation follows intelligence analysis conventions with three strategic perspectives:

Compliance & Security

This platform aligns with Hack23 AB ISMS requirements per the Secure Development Policy:

Security & Compliance Documentation

Architecture Documentation Portfolio

Links

• Live Platform: riksdagsmonitor.com
• 🕵️ Political Intelligence Index: riksdagsmonitor.com/political-intelligence.html — every methodology, template and daily artifact
• 🗺️ Human Sitemap: riksdagsmonitor.com/sitemap.html — full platform navigation in 14 languages
• 📰 News Index: riksdagsmonitor.com/news/ — daily AI-generated political-intelligence articles
• 📡 RSS / XML feeds: sitemap.xml · rss.xml
• Repository: github.com/Hack23/riksdagsmonitor
• npm Package: npmjs.com/package/riksdagsmonitor
• CIA Data Platform: github.com/Hack23/cia
• ISMS Documentation: github.com/Hack23/ISMS-PUBLIC
• Secure Development Policy: Secure_Development_Policy.md
• Threat Modeling Policy: Threat_Modeling.md

Hack23 Ecosystem API Documentation

Mission: Systematic political transparency through rigorous intelligence analysis
License: Apache-2.0
Organization: Hack23 AB
ISMS Compliance: ISO 27001:2022 | NIST CSF 2.0 | CIS Controls v8.1