Module: ContentGeneration/ProspectiveAnalysis

INTELLIGENCE OPERATIVE PERSPECTIVE

This module generates "Week Ahead" articles that provide prospective coverage of upcoming parliamentary activity. Unlike reactive news (breaking news, evening analysis), week-ahead articles are forward-looking intelligence briefings that help stakeholders prepare for expected developments and anticipate parliamentary agenda. This prospective focus represents a critical intelligence function: helping analysts prepare rather than merely react.

INTELLIGENCE VALUE OF PROSPECTIVE ANALYSIS: Forward-looking coverage serves intelligence objectives:

  1. Situational Awareness: Stakeholders know what to expect
  2. Preparation: Organizations can prepare positions/responses
  3. Pattern Recognition: Identifies patterns in parliamentary schedule
  4. Trend Analysis: Connects planned activity to broader government agenda
  5. Risk Assessment: Upcoming events flagged for potential controversy

COVERAGE SCOPE - 7-DAY CALENDAR: Week-ahead articles cover the next 7 days of parliamentary activity:

  • Parliamentary Plenum Sessions: Full-house debates and votes
  • Committee Meetings: Specialized committee work and reviews
  • Government Actions: Announced government activities
  • Scheduled Votes: Pre-announced parliamentary voting sessions
  • Public Hearings: Committee hearings with expert testimony
  • International Events: EU parliament, Nordic cooperation meetings

ARTICLE STRUCTURE: Each week-ahead article includes:

  1. Week Overview: Summary of major upcoming events
  2. Day-by-Day Breakdown: Specific activities and scheduled times
  3. Key Topics: Policy areas being debated this week
  4. Watch Points: Items likely to generate controversy or surprise
  5. Committee Focus: Which committees have significant meetings
  6. Party Positioning: Known party stances on upcoming votes
  7. International Context: EU/Nordic cooperation dimensions

MCP DATA SOURCE: Primary tool: get_calendar_events

  • Retrieves riksdag calendar for specified date range
  • Includes session times, committee assignments, topics
  • Enables systematic prospective coverage

TODO: Implement additional tools for comprehensive analysis:

  • search_dokument: Find related policy documents for calendar items
  • get_fragor: Written questions related to upcoming debates
  • get_interpellationer: Interpellations (parliamentary questions) for upcoming sessions

OPERATIONAL WORKFLOW:

  1. Calculate Date Range: Get calendar for next 7 calendar days
  2. Query MCP: Fetch all scheduled parliamentary activity
  3. Filter & Categorize: Group activities by type and importance
  4. Context Gathering: Look up related documents and questions
  5. Watch Point Analysis: Identify controversial or significant items
  6. Article Generation: Create narrative structure with calendar
  7. Multilingual Creation: Generate 14-language editions
  8. Publication: Deploy immediately (updated daily)

CALENDAR STRUCTURE: Swedish parliament operates on structured schedule:

Riksdag Plenum (Full Parliament):

  • Typically: Tuesday-Thursday weekly
  • Time: 10:00-17:00 with lunch break
  • Activity: Government statements, main debates, votes
  • Advance Notice: Schedule released 3 weeks ahead

Committees:

  • Schedule: Varies by committee
  • Timing: Mix of morning and afternoon meetings
  • Frequency: Weekly to monthly depending on workload
  • Public: Many meetings open to public observation

Special Sessions:

  • Budget Process: September-November intensive schedule
  • Emergency Sessions: Called for crisis situations
  • International Meetings: Nordic and EU cooperation

WATCH POINT ANALYSIS: Week-ahead articles highlight items likely to be contentious:

  • Coalition Conflict: Items dividing government coalition
  • Opposition Challenges: Strong opposition-sponsored motions
  • Public Controversy: Items with public/media attention
  • International Pressure: EU directives or international commitments
  • Economic Impact: Items affecting fiscal or monetary policy
  • Rights & Freedoms: Civil liberties and human rights votes

PARTY STRATEGY ANALYSIS: Upcoming parliamentary schedule reveals party strategies:

  • Which issues parties prioritizing (based on speaker slots)
  • Which coalitions forming (based on motion sponsorship)
  • Which committees are battlegrounds
  • Which government ministers may face challenges

TIMING & PUBLICATION:

  • Publication Time: Monday morning, 08:00 Swedish time
  • Refresh Schedule: Daily updates if new items added
  • Archive: Weeks archived for pattern analysis
  • Accuracy: Based on official riksdag calendar

INTERNATIONAL CONTEXT: Week-ahead articles include international parliamentary activity:

  • EU Parliament Sessions: Relevant Swedish MEP activities
  • Nordic Council: Swedish participation in Nordic cooperation
  • Bilateral Events: International parliamentary delegations
  • Treaty Ratifications: International agreements for vote

INTELLIGENCE APPLICATIONS:

  1. Agenda Tracking: What parliament will debate
  2. Coalition Health: Scheduled votes reveal coalition confidence
  3. Party Focus: Which issues parties emphasizing
  4. Timeline Prediction: When major votes will occur
  5. Crisis Preparation: Advance notice of sensitive votes

PERFORMANCE CHARACTERISTICS:

  • MCP Query: ~300ms for 7-day calendar
  • Article Generation: ~3 seconds (includes calendar formatting)
  • Translation: ~6 seconds (parallel)
  • Total: ~10 seconds for batch (all languages)

DATE RANGE HANDLING: Week-ahead uses UTC-based date calculation to avoid timezone issues:

  • Tomorrow start: Tomorrow at 00:00 UTC
  • One week ahead: 7 days from tomorrow
  • Handles daylight saving transitions
  • Consistent across timezones

FAILURE HANDLING:

  • Empty Calendar: Generate article noting light schedule
  • MCP Service Down: Use cached previous week's structure
  • Missing Committee Times: Exclude committees without times
  • Parse Error: Continue with available data

GDPR COMPLIANCE:

  • Calendar events are public parliamentary records
  • No personal data beyond member names (public roles)
  • Data retention follows parliamentary archive standards
  • Supporting transparency in democratic process
Version:
  • 2.1.0
Since:
  • 2024-09-05
Author:
  • Hack23 AB (Prospective Intelligence & Agenda Analysis)
License:
  • Apache-2.0
Source:
See:

Members

(static, constant) REQUIRED_TOOLS

Required MCP tools for week-ahead articles

REQUIRED_TOOLS UPDATE (2026-02-14): Initially set to 4 tools ['get_calendar_events', 'search_dokument', 'get_fragor', 'get_interpellationer'] to match tests/validation expectations. However, this caused runtime validation failures since the implementation only calls get_calendar_events (line 81).

Reverted to actual implementation (1 tool) to prevent validation failures. When additional tools are implemented in generateWeekAhead(), add them back here.

Source:

Methods

(static) formatDateForSlug()

Format date for article slug

Source:

(static) generateWeekAhead(options) → {Promise.<Object>}

Generate Week Ahead article in specified languages

Parameters:
Name Type Description
options Object

Generation options

Properties
Name Type Description
languages Array.<string>

Languages to generate (default: ['en', 'sv'])

dateRange Object

Optional custom date range

writeArticle function

Function to write article to file

Source:
Returns:

Generation result with success, files, slug, mcpCalls

Type
Promise.<Object>

(static) getWeekAheadDateRange()

Get date range for Week Ahead (next 7 days)
Uses UTC to avoid timezone boundary issues with toISOString()

Source:

(static) validateWeekAhead(article) → {Object}

Validate week-ahead article structure

Parameters:
Name Type Description
article Object

Article object with content and metadata

Source:
Returns:

Validation result

Type
Object

(inner) getTitles()

Get language-specific titles

Source: