Political Intelligence Analysis & OSINT Platform for Swedish Parliament Monitoring
Shared types, theme system, and dashboard utilities are published as an npm package with provenance:
npm install riksdagsmonitor
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';
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.
This API documentation covers the complete Riksdagsmonitor Intelligence Platform โ a mixed TypeScript & JavaScript codebase implementing sophisticated intelligence collection, analysis, and visualization for democratic transparency.
| Layer | Technology | Files | Description |
|---|---|---|---|
| Browser Dashboards | TypeScript + Chart.js / D3.js | 27 modules | Interactive political intelligence dashboards with bounded contexts |
| Shared Infrastructure | TypeScript | 7 modules | Types, theme, chart factory, data loader, DOM utils, logger |
| CIA Intelligence | TypeScript | 5 modules | CIA data pipeline, visualizations, election predictions, i18n |
| News Generation | TypeScript | 15+ modules | Automated intelligence reporting with 14-language support |
| Type System | TypeScript | 9 modules | Strict type definitions for the intelligence domain |
| Build & Automation | TypeScript / Vite | 10+ modules | Data validation, schema processing, and tooling |
Every module in this API is documented through three strategic lenses:
@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)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)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.
stats-loader / cia/data-loader โ Multi-source data acquisition with fallback strategiesrisk-dashboard / anomaly-detection โ 45-rule risk scoring engine for 349 MPscia/election-predictions / pre-election โ Electoral forecasting modelspolitician-dashboard / party-dashboard / ministry-dashboard โ Career trajectory analyticsseasonal-patterns / election-cycle โ Legislative activity cyclescoalition-loader / coalition-dashboard โ Coalition stability assessmentgenerate-news-enhanced / article-template โ Automated news generation| Customer Segment | Key Modules | Value Proposition |
|---|---|---|
| Citizens & Voters | politician-dashboard, party-dashboard, election-predictions | Informed voting decisions, MP accountability |
| Journalists & Media | risk-dashboard, anomaly-detection, pre-election | Investigative data, story leads, fact-checking |
| Researchers & Academics | seasonal-patterns, election-cycle, coalition-dashboard | Research-grade datasets, temporal analysis |
| NGOs & Advocacy | committees-dashboard, ministry-dashboard, legislative-monitoring | Transparency tracking, accountability tools |
| Corporations & Government | risk-dashboard, coalition-loader, election-predictions | Political risk assessment, regulatory stability |
| Content Type | Source Modules | Distribution Channel |
|---|---|---|
| Risk Alerts | risk-dashboard, anomaly-detection | Push notifications, email, social media |
| Election Forecasts | election-predictions, pre-election | Press releases, media partnerships |
| Party Comparisons | party-dashboard, coalition-dashboard | Social media infographics, blog posts |
| MP Profiles | politician-dashboard | SEO-optimized pages, voter tools |
| Committee Reports | committees-dashboard | Research publications, newsletters |
| Trend Analysis | seasonal-patterns, election-cycle | Thought leadership articles, webinars |
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)
All documentation follows intelligence analysis conventions with three strategic perspectives:
| Tag | Purpose |
|---|---|
@module |
Intelligence capability module (e.g., "Dashboards/Risk") |
@category |
Intelligence domain grouping |
@intelligence |
OSINT/risk/analysis perspective โ intelligence methodology and value |
@business |
Revenue/market/competitive perspective โ commercial viability and positioning |
@marketing |
Audience/growth/engagement perspective โ content and channel strategy |
@param / @returns |
Function signatures with type information |
@example |
Usage examples |
@see |
Cross-references to related modules |
@security |
Security considerations (CSP, XSS, data protection) |
@risk |
Risk assessment context |
@osint |
OSINT data source documentation |
@gdpr |
GDPR compliance notes |
@revenue |
Revenue model implications |
@market |
Market analysis context |
@audience |
Target audience information |
@competitive |
Competitive positioning |
@stakeholder |
Stakeholder impact |
@kpi |
Key performance indicators |
This platform aligns with Hack23 AB ISMS requirements per the Secure Development Policy:
| Document | Description | Compliance Framework |
|---|---|---|
| SECURITY_ARCHITECTURE.md | Current security controls and defense-in-depth | ISO 27001:2022, NIST CSF 2.0, CIS Controls v8.1 |
| THREAT_MODEL.md | STRIDE threat analysis and MITRE ATT&CK mapping | STRIDE, MITRE ATT&CK, OWASP LLM Top 10 |
| FUTURE_SECURITY_ARCHITECTURE.md | Security evolution roadmap | Post-quantum, Zero-trust, AI-augmented |
| FUTURE_THREAT_MODEL.md | Forward-looking threat analysis | Future crown jewels and attack vectors |
| Current State | Future State | Focus Area |
|---|---|---|
| ARCHITECTURE.md | FUTURE_ARCHITECTURE.md | C4 models (Context, Container, Component) |
| DATA_MODEL.md | FUTURE_DATA_MODEL.md | Data structures and relationships |
| FLOWCHART.md | FUTURE_FLOWCHART.md | Business process and data flows |
| STATEDIAGRAM.md | FUTURE_STATEDIAGRAM.md | System state transitions |
| MINDMAP.md | FUTURE_MINDMAP.md | Conceptual relationships |
| SWOT.md | FUTURE_SWOT.md | Strategic analysis |
| Platform | API Documentation | Repository |
|---|---|---|
| Riksdagsmonitor | riksdagsmonitor.com/docs/api/ | Hack23/riksdagsmonitor |
| EU Parliament MCP Server | euparliamentmonitor.com/docs/api/ | Hack23/European-Parliament-MCP-Server |
| CIA Compliance Manager | ciacompliancemanager.com/api/ | Hack23/cia-compliance-manager |
| Black Trigram | blacktrigram.com/api/ | Hack23/blacktrigram |
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