Explore the live platform — 🌐 euparliamentmonitor.com · 🧠 Political Intelligence Hub (methodology + artifact transparency, all 14 languages) · 📊 Analysis & Reports · 🗺️ Site Map (every page, every language) · 📔 API Reference

🎯 Why This Exists

The European Parliament adopts laws that affect 450 million citizens across 27 member states. Yet most of what happens in Brussels and Strasbourg — committee dossiers, rapporteur appointments, coalition trade-offs, amendment battles, urgency files, trilogue dynamics — remains effectively invisible to the public. Press coverage is sparse, fragmented across national outlets, and rarely connects the procedural dots.

EU Parliament Monitor turns the EP's own open data into auditable political intelligence — and publishes it as readable news in 14 languages, every day, fully sourced.

This repository is the open-source platform behind euparliamentmonitor.com: an AI-driven newsroom that monitors plenary sessions, committee work, motions, propositions, and forward-calendar events; produces Economist-style analytical articles backed by 51 structured analysis artifacts per run; and exposes every methodology, template, and analysis tree publicly so any reader, journalist, researcher, or NGO can verify the analysis behind the prose.

| Pillar | What it means in this project | |---|---| | 🧠 Political Intelligence | Structured analytic techniques (ACH, SWOT/TOWS, PESTLE, scenario forecasting, devil's-advocate), Admiralty source grading, Words of Estimative Probability (WEP) bands, ICD-203 standards, and a 6-dimension political-threat framework — applied daily to live EP data. | | 🔍 Radical Transparency | Every article links back to the analysis run it was rendered from. Every artifact links to its methodology. Every methodology is published. No black box. | | 🗳️ Democratic Accountability | Public-data only. GDPR-clean. No personal profiling. Multi-language so a Finnish farmer, a Greek student, and a Polish journalist all get the same intelligence in their own language. | | 🤖 AI-Generated News | 14 unified gh-aw agentic workflows + 1 translation workflow run autonomously, produce structured analysis, render deterministic HTML, and open publication-ready pull requests for human review. |

Documentation & Reports

🌐 Explore the Live Platform

The published site is the audience-facing companion to this npm/TypeScript package. Two hub pages give the fastest entry point — bookmark them:

📚 Documentation Hub

📖 Quick Links:

• 🌐 Live Site - Public news platform (14 languages, daily AI-generated articles)
• 🧠 Political Intelligence Hub - Methodology + artifact transparency layer
• 🗺️ Site Map - All pages across all 14 languages
• 📘 Architecture Documentation - Complete security architecture with C4 diagrams
• 📗 Security Flows - Process flows with security controls
• 📙 Data Model - Data structures and API integration
• 📕 Release Process - How to create releases
• 📔 API Documentation - TypeDoc-generated API reference
• 📓 Test Coverage - Interactive coverage report

🤖 Agentic Pipeline:

• Agent Catalog — custom Copilot agents (analysis producers / consumers / gh-aw infrastructure)
• Skills Library — shared skills (security, compliance, intelligence, gh-aw)
• Prompt Library — 10-file bounded-context prompt set (00→09) + npm run lint:prompts drift-guard
• Workflows + WORKFLOWS.md — 15 news-*.md agentic workflows (14 unified news-<type>.md covering 14 article types — including the long-horizon quarter-ahead/quarter-in-review/year-ahead/year-in-review/term-outlook/election-cycle set added in 2026-Q2 — plus news-translate.md) + CI workflows
• Analysis Chain — 5-stage pipeline (Data → Analysis → Completeness Gate → Article → Single PR), methodologies, 39 templates, quality thresholds

🔒 ISMS Compliance:

• 🛡️ Hack23 ISMS Framework - Information Security Management System
• 🔐 Secure Development Policy - Development standards
• 📋 Classification Framework - CIA triad classification

Current Status

MCP Server Integration: The project uses the European-Parliament-MCP-Server v1.3.9 for accessing real EU Parliament data via the Model Context Protocol.

• MCP Server Status: ✅ Fully operational — 60+ EP data tools available (feeds, direct lookups, analytical tools, intelligence correlation)
• Agentic Workflows: 15 unified gh-aw markdown workflows — 14 article types (news-<type>.md, Stages A → B → C → D → E in one session) + news-translate.md (14-language flush translation) — compiled with gh-aw v0.69.3 (pin in .github/workflows/compile-agentic-workflows.yml) to .lock.yml for automated news generation with AI-driven political intelligence analysis. See .github/workflows/README.md.
• Analysis-Artifact-Driven Article Pipeline: Agents author the full Stage-B analysis-artifact set (analysis/daily/<date>/<slug>/, 39 structured templates per run; repeat same-day runs reuse the folder and append to manifest.json.history[]) and commit it; the deterministic aggregator (src/aggregator/**, invoked via npm run generate-article -- --run <analysis-run-dir> or npm run generate-article:all for batch regen) then walks manifest.json, cleans each artifact, and emits the final Markdown source + HTML with the shared site chrome (stacked header + embedded 14-language switcher + TOC sidebar + footer stats) and 14-language <link rel="alternate" hreflang> entries. There is no AI-authored HTML step; article quality is guaranteed editorially at the Stage-C completeness review over the artifact markdown. See analysis/README.md and analysis/methodologies/ai-driven-analysis-guide.md.
• Fallback Mode: News generation can work with reduced data when EP API endpoints are temporarily unavailable
• Environment Variable: Set USE_EP_MCP=false to disable MCP client connection attempts

EU Parliament Monitor is an automated news generation platform that monitors European Parliament activities and generates multi-language news articles covering:

• Week Ahead: Preview of upcoming parliamentary events and committee meetings
• Committee Reports: Analysis of committee activities and decisions
• Propositions: Government and parliamentary legislative proposals
• Motions: Parliamentary motions and resolutions
• Breaking News: Rapid-response coverage of significant developments

Features

• 📰 Automated News Generation: Generate news articles about EU Parliament activities
• 🌍 Multi-Language Support: 14 languages including English, Swedish, German, French, Spanish, Arabic, Japanese, and more
• 📅 Week Ahead Coverage: Preview upcoming parliamentary events
• 🤖 GitHub Actions Integration: Automated daily news generation
• 📊 SEO Optimized: Proper metadata, structured data, and sitemap generation
• ✅ Code Quality: ESLint, Prettier, and automated quality gates
• 🌐 IMF-grade Economic Context: IMF-primary citations are the editorial standard for every policy article — see analysis/imf/README.md and analysis/methodologies/imf-indicator-mapping.md. World Bank is retained only for non-economic indicators (health, education, social, environment, demographics, defence, agriculture, innovation, governance).

🔒 Security Architecture

EU Parliament Monitor implements security-by-design with comprehensive security controls and ISMS compliance.

Security Documentation

• 📋 Security Architecture - Complete security implementation overview with C4 diagrams, threat model, and compliance mapping
• 🚀 Future Security Architecture - Security enhancement roadmap (2026-2027)
• 📊 Data Model - Data structures and European Parliament API integration
• 📈 Security Flowcharts - Detailed process flows with security controls

Security Posture

Project Classification (per ISMS Classification Framework and Open Source Policy):

• Confidentiality: Public (Level 1) - European Parliament open data
• Integrity: Medium (Level 2) - News accuracy critical for democratic transparency
• Availability: Medium (Level 2) - Daily updates expected, 24h RTO acceptable
• RTO: 24 hours | RPO: 1 day (daily generation schedule)
• Business Impact: Low financial, Medium operational, Medium reputational
• Strategic Value: Democratic transparency, open civic technology leadership

Key Security Controls:

• ✅ Minimal Attack Surface: Static site, no databases, no server-side execution
• ✅ Automated Security: CodeQL SAST, Dependabot SCA, npm audit
• ✅ Supply Chain Security: SHA-pinned GitHub Actions, SBOM generation
• ✅ Input Validation: Multi-layer XSS prevention, HTML sanitization
• ✅ Infrastructure Security: GitHub-hosted ephemeral runners, HTTPS enforcement
• ✅ Compliance: ISO 27001, GDPR, NIS2, EU CRA aligned

Security Metrics:

• Zero known vulnerabilities (npm audit clean)
• 82%+ code coverage with security tests
• 100% dependency scanning coverage
• 0 CodeQL critical/high findings

ISMS Alignment

This project follows Hack23 ISMS Secure Development Policy:

• ✅ Security architecture documentation (C4 models with Mermaid)
• ✅ Threat modeling (STRIDE analysis)
• ✅ Security testing (SAST, SCA, unit tests)
• ✅ Compliance mapping (ISO 27001, GDPR, NIS2)

🤝 Community & Governance

EU Parliament Monitor is an open source project with transparent governance and community standards.

Open Source Standards

• Contributing Guide - Development workflow, code standards, and contribution guidelines
• Code of Conduct - Community standards based on Contributor Covenant 2.1
• Security Policy - Vulnerability disclosure and security practices
• Authors & Contributors - Recognition of project contributors
• License - Apache License 2.0 full text

Community Channels

• GitHub Issues: Bug reports and feature requests
• GitHub Discussions: Questions and community discussion
• Security: [email protected] for vulnerability reports
• Conduct: [email protected] for Code of Conduct issues

Governance Compliance

This project adheres to:

• ✅ OpenSSF Best Practices: Following CII Best Practices criteria
• ✅ ISMS Compliance: Aligned with Hack23 ISMS policies
• ✅ Transparent Development: Public repository, open discussions
• ✅ Security First: Comprehensive security disclosure policy

Code Quality & Testing

EU Parliament Monitor maintains high code quality standards with comprehensive testing:

🧠 The Political Intelligence Pipeline

Every article published on euparliamentmonitor.com is the deterministic render of an analysis run — a directory under analysis/daily/<YYYY-MM-DD>/<article-type>/ containing structured Markdown artifacts (drawn from a 51-template catalog: 39 core mandatory + 12 extended optional) plus raw EP MCP / IMF / World Bank data payloads. The pipeline is split into five well-defined stages:

%%{init: {"theme":"dark","themeVariables":{"primaryColor":"#1565C0","primaryTextColor":"#fff","lineColor":"#90CAF9","fontFamily":"Inter, Helvetica, Arial, sans-serif"}}}%%
flowchart LR
    A["🔵 Stage A<br/>EP MCP data collection<br/><i>60+ tools, IMF, World Bank</i>"] --> B["🟣 Stage B<br/>AI political intelligence<br/><i>51 artifacts · 2-pass review</i>"]
    B --> C["🟡 Stage C<br/>Completeness gate<br/><i>line floors · WEP · Admiralty</i>"]
    C --> D["🟢 Stage D<br/>Deterministic aggregator<br/><i>npm run generate-article</i>"]
    D --> E["🔷 Markdown source<br/>news/*.en.md"]
    D --> F["🟢 14-language HTML<br/>news/*-{lang}.html"]
    F --> G["🟠 SEO indexes<br/>sitemap · RSS · JSON-LD"]
    G --> H["🟢 S3 + CloudFront<br/>euparliamentmonitor.com"]
    style A fill:#1565C0,color:#fff
    style B fill:#7B1FA2,color:#fff
    style C fill:#FFC107,color:#000
    style D fill:#2E7D32,color:#fff
    style E fill:#0288D1,color:#fff
    style F fill:#2E7D32,color:#fff
    style G fill:#FF9800,color:#000
    style H fill:#2E7D32,color:#fff

Critical architectural property: AI agents author analysis artifacts in Markdown — never HTML. TypeScript code under src/aggregator/** deterministically renders the committed artifacts into HTML. There is no AI-authored HTML step and no template-prose leakage. This is what makes the public output reproducible, auditable, and resistant to hallucination.

📖 Full pipeline reference: Article-Generation.md · analysis/README.md · analysis/methodologies/ai-driven-analysis-guide.md

📚 The Methodology Library — published, versioned, auditable

| Methodology | Purpose | |---|---| | 🎯 AI-Driven Analysis Guide | The canonical 10-step protocol every agentic run follows (Rules 1–22 + Step 10.5 methodology reflection). | | 🗂️ Artifact Catalog | Master map: every artifact → methodology + template + depth floor + Mermaid diagram type. | | 🔬 Per-Artifact Methodologies | 34 sections — one per artifact type — with construction rules and quality signals. | | 🕵️ OSINT Tradecraft Standards | ICD-203 standards · Admiralty source grades · Kent / WEP probability bands · SAT catalog · OSINT ethics. | | 🏷️ Political Classification Guide | 7-dimension EP event classification (actors, stances, urgency, policy domain, risk surface). | | ⚖️ Political Risk Methodology | Quantitative 5×5 Likelihood × Impact scoring adapted from the Hack23 ISMS. | | 🧮 Political SWOT Framework | Evidence-based SWOT/TOWS with ≥80-word depth floor per quadrant item. | | 🛡️ Political Threat Framework | 5-framework integrated model: 6D Threat Landscape + Attack Trees + Kill Chain + Diamond + ICO Profiling. STRIDE explicitly rejected for political analysis. | | 🔗 Synthesis Methodology | Stage B.7 significance scoring → synthesis summary → stakeholder perspectives → coalition dynamics → executive brief. | | 🌍 Strategic Extensions | Scenario forecasts, ACH (Heuer), wildcards & black swans, comparative international, intelligence assessment. | | 🗳️ Electoral Domain Methodology | EP10/EP11 electoral context, coalition mathematics (361-seat threshold), voter segmentation. | | 📐 Per-Document Methodology | Atomic evidence-layer methodology for individual EP documents. | | 🧾 Structural Metadata Methodology | Provenance, manifest.json, cross-reference maps, GDPR Article 30 compliance. | | ✍️ Political Style Guide | The Economist-inspired tone, balance, attribution rules, multi-language considerations. | | 💰 IMF Indicator Mapping | IMF WEO/Fiscal Monitor/IFS/BOP/ER/PCPS → EP article-type primary economic source. | | 🌱 World Bank Indicator Mapping | Non-economic World Bank Open Data indicators (health, education, environment, governance, innovation). | | 📏 Reference Quality Thresholds | Per-artifact line-count floors enforced at the Stage-C completeness gate. |

🔍 Browse all 17 methodologies, 52 templates, 19 tradecraft references, and 1,700+ artifacts produced across 170+ daily analysis runs on the Political Intelligence Hub.

📰 Live News Streams

Fourteen unified gh-aw article workflows plus a 14-language translation helper run on precision schedules, autonomously generating Economist-style political intelligence and opening publication-ready pull requests. Every workflow follows the same Stage A → E contract documented in Article-Generation.md. The single source of truth for every horizon's data window, cadence, mandatory artifacts, stage budgets, scenario depth and electoral overlay is the ARTICLE_HORIZONS registry in src/config/article-horizons.ts.

| Workflow | Article Type | Focus | |----------|--------------|-------| | 🚨 news-breaking.md | breaking | Rapid-response coverage of significant EP developments. | | 📋 news-week-ahead.md | week-ahead | Forward calendar, committee agenda, urgency-file outlook. | | 🔭 news-month-ahead.md | month-ahead | 30-day strategic horizon and risk forecast. | | 🌐 news-quarter-ahead.md | quarter-ahead | 90-day legislative pipeline forecast + presidency-trio overlay. | | 🛰️ news-year-ahead.md | year-ahead | 12-month strategic outlook with seat-projection sensitivity. | | 🗓️ news-term-outlook.md | term-outlook | Full EP-term outlook anchored to the next-EP-election week. | | 🗳️ news-election-cycle.md | election-cycle | EP-election span (±6 mo) — mandate scorecard + seat projection + Spitzenkandidaten arithmetic. | | 📊 news-week-in-review.md | week-in-review | Past-week retrospective intelligence (D-8 → D-36 reporting window). | | 📈 news-month-in-review.md | month-in-review | Monthly retrospective with cross-run continuity analysis. | | 📚 news-quarter-in-review.md | quarter-in-review | Quarterly retrospective with pipeline transit + presidency-trio overlay. | | 📜 news-year-in-review.md | year-in-review | Annual retrospective with mandate-fulfilment + term-arc + historical parallels. | | 🏛️ news-committee-reports.md | committee-reports | Committee activity, rapporteur work, legislative-production analysis. | | ⚖️ news-motions.md | motions | Plenary motions, resolutions, urgency files, political signals. | | 📜 news-propositions.md | propositions | Legislative proposals and pipeline analysis. | | 🌍 news-translate.md | translation helper | 14-language flush translation (manual dispatch only). |

Each unified workflow runs Stages A–E in a single 60-minute session (engine.mcp.session-timeout: 65m) and produces exactly one PR containing both the analysis artifacts and the rendered HTML. The earlier split-pair news-<type>-analysis.md + news-<type>-article.md layout was retired in the April-2026 aggregator migration. See .github/workflows/README.md for compile / lock-file / safe-output mechanics, WORKFLOWS.md for the full CI/CD catalog, and Article-Generation.md § Forward-looking horizons & election cycle for the new long-horizon and electoral pipeline.

📚 Prompt Library (.github/prompts/) — 10 bounded-context prompt files (00-scope-and-ground-rules.md → 09-troubleshooting.md) shared across every workflow. The npm run lint:prompts drift-guard fails CI on banned patterns (checkpoint pr, keep-alive, heartbeat, progressive safe output, push_repo_memory).

🤖 Agent Catalog

EU Parliament Monitor uses a layered agent model: a small set of product-domain agents owns the news pipeline, while infrastructure agents maintain workflows, contributions, and CI hygiene.

Product-domain agents (own the news critical path)

| Agent | Role | |---|---| | 🕵️ intelligence-operative | Senior political intelligence analyst — applies ACH, SWOT, PESTLE, OSINT tradecraft, threat framework. Owns Stage-B analysis artifacts. | | 📰 news-journalist | The Economist-style EP reporting in 14 languages. Authors editorial prose only when analysis artifacts are signed off. | | 🔄 data-pipeline-specialist | EP MCP integration (60+ tools), data quality, voting-records fallback to EP Open Data Portal. | | 🎨 frontend-specialist | HTML5/CSS3, WCAG 2.1 AA accessibility, multi-language UI, RTL support. | | ✅ quality-engineer | Vitest + Playwright, HTML validation, accessibility testing, performance benchmarking. | | ⚙️ devops-engineer | gh-aw workflow compilation, GitHub Actions, S3/CloudFront deploy, MCP gateway. | | 📚 documentation-architect | C4 models, Mermaid diagrams, ARCHITECTURE.md, ADRs. | | 🛡️ security-architect (see SECURITY.md) | ISMS, GDPR, NIS2, EU CRA compliance — reviews data classification of intelligence products. | | 📋 product-task-agent | Issue creation, ISMS tracking, capability-roadmap coordination. | | 📣 marketing-specialist | Privacy-first multi-language engagement, GDPR-compliant outreach. | | 💼 business-development-specialist | Strategic planning, civic-tech partnerships, sustainable transparency models. |

Infrastructure agents (maintain workflows and CI hygiene)

agentic-workflows.agent.md, news-generation.agent.md, ci-cleaner.agent.md, contribution-checker.agent.md, create-safe-output-type.agent.md, custom-engine-implementation.agent.md, grumpy-reviewer.agent.md, interactive-agent-designer.agent.md, technical-doc-writer.agent.md, w3c-specification-writer.agent.md. See .github/agents/README.md.

📦 Quick Start (npm package)

npm install euparliamentmonitor

import {
  // EP MCP client (60+ open-data tools)
  EuropeanParliamentMCPClient,
  getEPMCPClient,
  // Article generation (deterministic aggregator pipeline)
  generateArticle,
  aggregateAnalysisRun,
  renderMarkdown,
  // Cross-article intelligence index
  buildIndexFromEntries,
  findRelatedArticles,
  generateCrossReferences,
  // Multi-language support (14 languages, RTL aware)
  ALL_LANGUAGES,
  LANGUAGE_NAMES,
} from 'euparliamentmonitor';

// Or import specific modules for tree-shaking
import { EuropeanParliamentMCPClient } from 'euparliamentmonitor/mcp/ep-mcp-client';
import type { ArticleCategory, LanguageCode } from 'euparliamentmonitor/types';

Bundled capabilities:

• 🏛️ EU Parliament MCP Client — 60+ tools covering plenary sessions, committee reports, voting records, parliamentary questions, adopted texts, procedures, MEPs, and declarations, with built-in fallback to the EP Open Data Portal /api/v2/decision endpoint when MCP returns empty voting payloads.
• 📰 Deterministic Article Aggregator — walks manifest.json, cleans each artifact, renders Markdown source + 14 HTML variants with full SEO chrome, JSON-LD NewsArticle, hreflang alternates, and isBasedOn provenance lists.
• 🔍 Political Intelligence Analytics — voting-anomaly detection, coalition dynamics, MEP influence scoring, OSINT correlation (5-framework threat model).
• 🌍 14-Language Renderer — EN, SV, DA, NO, FI, DE, FR, ES, NL, AR (RTL), HE (RTL), JA, KO, ZH — with WCAG 2.1 AA accessibility and shared site chrome.

📦 Provenance: Published with npm provenance and SLSA Level 3 build attestations.

🔌 Data Sources

Primary — European Parliament MCP Server (Hack23/European-Parliament-MCP-Server v1.3.9+, fully operational):

• 🗳️ Plenary sessions, voting records, roll-call votes
• 📜 Adopted texts, motions, resolutions, urgency files
• 🏛️ Committee meetings, reports, opinions, hearings
• 👥 MEPs (active, incoming, outgoing, homonym), declarations of financial interests
• ❓ Parliamentary questions (written/oral)
• 📂 Procedures, plenary documents, external documents, controlled vocabularies
• 📊 Analytical tools: voting patterns, coalition dynamics, MEP influence, network analysis, sentiment tracker, early warning system, intelligence correlation

Secondary — public economic & social context:

• 💰 IMF (primary economic source per the IMF Indicator Mapping) — World Economic Outlook (WEO), Fiscal Monitor, International Financial Statistics (IFS), Balance of Payments (BOP), Exchange Rates, and Primary Commodity Price System (PCPS).
• 🌱 World Bank Open Data (non-economic only) — health, education, environment, demographics, governance, innovation.

Boundary: Only public EP/IMF/World Bank data is used. No personal MEP profiling beyond public parliamentary roles. GDPR-clean by design.

🔒 Security & ISMS Compliance

EU Parliament Monitor implements security-by-design under the Hack23 ISMS framework.

Project classification

| Dimension | Level | |---|---| | Confidentiality | Public (Level 1) — European Parliament open data only | | Integrity | Medium (Level 2) — accuracy critical for democratic transparency | | Availability | Medium (Level 2) — daily updates, 24h RTO | | Strategic value | Democratic transparency, open civic-tech leadership |

Compliance frameworks

| Framework | Scope | Evidence | |---|---|---| | ISO 27001:2022 | Information security management | SECURITY_ARCHITECTURE.md — A.5.10, A.5.12, A.5.23, A.8.11, A.8.28 | | NIST CSF 2.0 | Identify · Protect · Detect · Respond · Recover | Compliance matrix in SECURITY_ARCHITECTURE.md | | CIS Controls v8.1 | Operational security best practices | CodeQL, Dependabot, npm audit, SBOM | | GDPR | Data minimization, purpose limitation | Public-data-only boundary, no profiling | | NIS2 | Article 20, 21 cybersecurity risk management | THREAT_MODEL.md (STRIDE for software-security context) | | EU Cyber Resilience Act | SBOM, vulnerability disclosure, Annex I/V | CRA-ASSESSMENT.md, SLSA provenance, SECURITY.md |

Key security controls

• ✅ Minimal attack surface — static site, no databases, no server-side execution
• ✅ Same-origin JS bundle — all executable assets under js/vendor/, strict script-src 'self' CSP, no external CDN
• ✅ Automated security — CodeQL SAST, Dependabot SCA, npm audit, OpenSSF Scorecard
• ✅ Supply chain — SHA-pinned GitHub Actions, SBOM (SPDX), SLSA Level 3 attestations
• ✅ Input validation — multi-layer XSS prevention, HTML sanitization, markdown-it with explicit plugin allowlist
• ✅ Infrastructure — GitHub-hosted ephemeral runners, S3/CloudFront via OIDC GithubWorkFlowRole, HTTPS enforcement, step-security/harden-runner egress block

📋 Full security architecture: SECURITY_ARCHITECTURE.md · SECURITY.md · THREAT_MODEL.md · CLASSIFICATION.md

🛠️ Local Development

Requirements

• Node.js 26 or higher
• npm 10 or higher (ships with Node.js 26)
• Git

From source

git clone https://github.com/Hack23/euparliamentmonitor.git
cd euparliamentmonitor
npm install

Build, lint, test, render

npm run build              # TypeScript compilation
npm run lint               # ESLint (TypeScript in src/)
npm run lint:prompts       # gh-aw prompt drift-guard
npm run htmlhint           # HTML validation
npm run test               # Vitest unit + integration (169+ tests)
npm run test:coverage      # Coverage report (≥80% line, ≥75% branch)
npm run test:e2e           # Playwright cross-browser E2E
npm run validate-analysis  # Stage-C completeness gate
npm run generate-article -- --run analysis/daily/2026-04-24/breaking
npm run generate-article:all                # batch regen every committed run
npm run generate-news-indexes               # 14-language news index pages
npm run generate-sitemap                    # sitemap.xml + 14 sitemap_<lang>.html
npm run docs:generate                       # TypeDoc API docs + index
npm run serve                               # local static-site preview at :8080

Optional: live MCP integration

By default the workflows run with USE_EP_MCP=true. To experiment locally with the European Parliament MCP Server:

git clone https://github.com/Hack23/European-Parliament-MCP-Server.git
cd European-Parliament-MCP-Server && npm install && npm run build
export EP_MCP_SERVER_PATH="$(pwd)/dist/index.js"
# or use the gateway helper:
source scripts/mcp-setup.sh

Set USE_EP_MCP=false to disable MCP and fall back to placeholder/test data.

📚 Documentation Hub

| Topic | Document | |---|---| | 🌐 Live site | euparliamentmonitor.com · Political Intelligence Hub · Site Map | | 🏛️ Architecture | ARCHITECTURE.md · FUTURE_ARCHITECTURE.md · DATA_MODEL.md · FLOWCHART.md · STATEDIAGRAM.md · MINDMAP.md | | 📰 Article generation | Article-Generation.md — end-to-end pipeline reference | | 🧠 Analysis chain | analysis/README.md · analysis/methodologies/ · analysis/templates/README.md | | 🤖 Agentic pipeline | .github/agents/README.md · .github/skills/README.md · .github/prompts/README.md · .github/workflows/README.md · WORKFLOWS.md | | 🛡️ Security & compliance | SECURITY.md · SECURITY_ARCHITECTURE.md · THREAT_MODEL.md · CLASSIFICATION.md · CRA-ASSESSMENT.md | | 💼 Business | SWOT.md · BCPPlan.md · FinancialSecurityPlan.md · End-of-Life-Strategy.md | | 🧪 Testing | UnitTestPlan.md · E2ETestPlan.md · test/README.md · e2e/README.md | | 🚀 Release process | docs/RELEASE_PROCESS.md · SLSA Attestations | | 📔 Generated docs | API Reference · Coverage · E2E Report |

🚀 Future: AI Evolution Roadmap (2026–2037)

"We're not just keeping up with AI — we're building the editorial infrastructure for the era when machines understand parliamentary procedure better than most MEPs."

Six-phase roadmap from current agentic news generation to AGI-enhanced transformative democracy, with human oversight maintained at every level.

timeline
    title EU Parliament Monitor — AI Evolution Roadmap
    section Phase 1 (2026)
        Agentic News : 14 unified workflows
                     : 14-language generation
                     : Deterministic aggregator
                     : 51-artifact analysis catalog
    section Phase 2 (2027)
        Predictive Analytics : Voting outcome prediction
                             : Legislative impact forecasting
                             : Cross-party coalition detection
    section Phase 3 (2028–2029)
        Multi-Modal Intelligence : Video plenary analysis
                                 : Real-time debate tracking
                                 : Infographic auto-generation
    section Phase 4 (2030–2031)
        Near-Expert Analysis : 50+ parliament coverage
                             : Expert-level policy briefs
                             : Predictive governance models
    section Phase 5 (2032–2033)
        Global Coverage : 100+ parliaments
                        : Pre-AGI capabilities
                        : Cross-jurisdiction analysis
    section Phase 6 (2034–2037)
        AGI Era : Transformative democracy
               : 195 national legislatures
               : Human oversight maintained

📘 FUTURE_MINDMAP.md — capability evolution & system vision · 📗 FUTURE_WORKFLOWS.md — CI/CD evolution & automation roadmap

🤝 Community & Contributing

EU Parliament Monitor welcomes contributions from developers, journalists, translators, political scientists, OSINT analysts, accessibility experts, and security researchers.

| Resource | Purpose | |---|---| | CONTRIBUTING.md | Development workflow, code standards, contribution guidelines | | CODE_OF_CONDUCT.md | Contributor Covenant 2.1 community standards | | SECURITY.md | Vulnerability disclosure (48h ack · 7d validation · 30d remediation for criticals) | | AUTHORS.md | Recognition of project contributors | | LICENSE | Apache License 2.0 |

Channels: GitHub Issues (bug reports / features) · GitHub Discussions (Q&A) · [email protected] (vulnerabilities) · [email protected] (Code of Conduct)

Governance compliance: ✅ OpenSSF Best Practices · ✅ Hack23 ISMS aligned · ✅ Public repository with transparent decision-making · ✅ REUSE-compliant license headers · ✅ Conventional commits

📝 License

Copyright 2024-2026 Hack23 AB

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

See LICENSE for the full text.

🙏 Credits

The news-generation foundation builds on the Hack23/riksdagsmonitor Swedish Parliament monitor. Sister projects in the Hack23 transparency portfolio: European-Parliament-MCP-Server (EP data MCP) · cia (Swedish Parliament intelligence, Java/Spring) · ISMS-PUBLIC (security policies).

Maintained by: Hack23 AB — Intelligence Operations Team