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:
- Situational Awareness: Stakeholders know what to expect
- Preparation: Organizations can prepare positions/responses
- Pattern Recognition: Identifies patterns in parliamentary schedule
- Trend Analysis: Connects planned activity to broader government agenda
- 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:
- Week Overview: Summary of major upcoming events
- Day-by-Day Breakdown: Specific activities and scheduled times
- Key Topics: Policy areas being debated this week
- Watch Points: Items likely to generate controversy or surprise
- Committee Focus: Which committees have significant meetings
- Party Positioning: Known party stances on upcoming votes
- 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:
- Calculate Date Range: Get calendar for next 7 calendar days
- Query MCP: Fetch all scheduled parliamentary activity
- Filter & Categorize: Group activities by type and importance
- Context Gathering: Look up related documents and questions
- Watch Point Analysis: Identify controversial or significant items
- Article Generation: Create narrative structure with calendar
- Multilingual Creation: Generate 14-language editions
- 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:
- Agenda Tracking: What parliament will debate
- Coalition Health: Scheduled votes reveal coalition confidence
- Party Focus: Which issues parties emphasizing
- Timeline Prediction: When major votes will occur
- 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
- License:
- Apache-2.0
- Source:
- See:
-
- scripts/data-transformers.js (Calendar Transformation)
- scripts/article-template.js (HTML Rendering)
- Issue #151 (Week-Ahead Enhancement)
- https://www.riksdagen.se/sv/sa-funkar-riksdagen/ (Parliament Procedure)
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
|
- 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: