Add interpellations article type for parliamentary debate coverage#1133
Merged
Conversation
Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] [aw] Track no-op runs from agentic workflows
Add interpellations article type for parliamentary debate coverage
Mar 13, 2026
github-actions
Bot
added
documentation
Contributor
🔍 Lighthouse Performance Audit
📥 Download full Lighthouse report Budget Compliance: Performance budgets enforced via |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds a new interpellations article type for covering Swedish parliamentary interpellation debates — formal questions demanding ministerial responses in chamber. The change plugs a gap in the automated news generation schedule by adding a weekday 07:00 UTC workflow between the existing motions (06:00) and week-ahead workflows.
Changes:
- New article type
interpellationsadded to the type system, config, content routing, metadata, and orchestrator generator - New standalone module
scripts/news-types/interpellations.tswith 14-language titles, MCP tool integration, and validation (though unused by the pipeline) - New GitHub Actions agentic workflow
.github/workflows/news-interpellations.mdscheduled weekdays at 07:00 UTC
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
scripts/types/article.ts |
Adds 'interpellations' to ArticleType union |
scripts/generate-news-enhanced/config.ts |
Adds 'interpellations' to VALID_ARTICLE_TYPES |
scripts/generate-news-enhanced/generators.ts |
New generateInterpellations() orchestrator function using shared MCP client |
scripts/generate-news-enhanced/index.ts |
Wires interpellations into the generation switch and re-exports |
scripts/generate-news-enhanced.ts |
Updates barrel re-export and doc comment |
scripts/data-transformers/index.ts |
Routes 'interpellations' to motions content generator |
scripts/data-transformers/metadata.ts |
Adds interpellations metadata case (keywords, topics, tags) |
scripts/news-types/interpellations.ts |
Standalone generator module (not imported anywhere) |
.github/workflows/news-interpellations.md |
Agentic workflow for scheduled interpellation article generation |
tests/workflow-architecture.test.ts |
Updates test arrays for new article type and workflow |
| keywords.push(kw('interpellations'), kw('parliamentary questions'), kw('parliament'), kw('accountability')); | ||
| topics.push('parliament', 'accountability'); | ||
| { | ||
| const tagVal = L(lang, 'oppMotionsTag'); |
Comment on lines
+1
to
+341
| /** | ||
| * @module ContentGeneration/InterpellationAnalysis | ||
| * @category ContentGeneration | ||
| * | ||
| * @title Interpellation Debates Article Generator - Parliamentary Accountability Intelligence | ||
| * | ||
| * @description | ||
| * **INTELLIGENCE OPERATIVE PERSPECTIVE** | ||
| * | ||
| * This module generates analysis articles on interpellation debates (interpellationsdebatter), | ||
| * which are formal parliamentary questions demanding a minister's personal response in | ||
| * the Riksdag chamber. Interpellations represent the strongest tool for opposition | ||
| * accountability and ministerial scrutiny, making them critical for understanding | ||
| * government pressure points and opposition strategy. | ||
| * | ||
| * **PARLIAMENTARY CONTEXT - SWEDISH INTERPELLATION SYSTEM:** | ||
| * Interpellations (interpellationer) are formal questions from individual MPs to | ||
| * government ministers that require a written response AND a chamber debate. Unlike | ||
| * written questions (skriftliga frågor), interpellations guarantee floor time and | ||
| * public confrontation, making them the primary tool for opposition accountability. | ||
| * | ||
| * **INTERPELLATION INTELLIGENCE VALUE:** | ||
| * Interpellations reveal: | ||
| * 1. **Government Pressure Points**: Which ministers face the most scrutiny | ||
| * 2. **Opposition Priorities**: What issues opposition parties consider most urgent | ||
| * 3. **Ministerial Vulnerability**: How well ministers defend their positions | ||
| * 4. **Policy Failures**: Areas where government policy is perceived as inadequate | ||
| * 5. **Cross-Party Accountability**: Which parties cooperate on oversight | ||
| * | ||
| * **MCP DATA SOURCE:** | ||
| * Primary tool: get_interpellationer | ||
| * Additional tools (with graceful degradation): | ||
| * - search_dokument_fulltext: Full-text interpellation analysis | ||
| * - search_anforanden: Debate context and minister responses | ||
| * - get_calendar_events: Scheduled interpellation debate times | ||
| * | ||
| * @author Hack23 AB (Parliamentary Accountability & Oversight Intelligence) | ||
| * @license Apache-2.0 | ||
| */ | ||
|
|
||
| import { MCPClient } from '../mcp-client.js'; | ||
| import { | ||
| generateArticleContent, | ||
| extractWatchPoints, | ||
| generateMetadata, | ||
| calculateReadTime, | ||
| generateSources, | ||
| filterFreshDocuments, | ||
| type RawDocument | ||
| } from '../data-transformers.js'; | ||
| import { generateArticleHTML } from '../article-template.js'; | ||
| import type { Language } from '../types/language.js'; | ||
| import type { ArticleCategory, GeneratedArticle, GenerationResult, MCPCallRecord } from '../types/article.js'; | ||
|
|
||
| /** | ||
| * Required MCP tools for interpellation articles | ||
| */ | ||
| export const REQUIRED_TOOLS: readonly string[] = [ | ||
| 'get_interpellationer', | ||
| 'search_dokument_fulltext', | ||
| 'search_anforanden', | ||
| ]; | ||
|
|
||
| export interface TitleSet { | ||
| title: string; | ||
| subtitle: string; | ||
| } | ||
|
|
||
| export interface InterpellationsValidationResult { | ||
| hasInterpellations: boolean; | ||
| hasMinimumSources: boolean; | ||
| hasAccountabilityAnalysis: boolean; | ||
| passed: boolean; | ||
| } | ||
|
|
||
| export interface ArticleInput { | ||
| content?: string; | ||
| sources?: string[]; | ||
| [key: string]: unknown; | ||
| } | ||
|
|
||
| export interface GenerationOptions { | ||
| languages?: Language[]; | ||
| limit?: number; | ||
| writeArticle?: ((html: string, filename: string) => Promise<void>) | null; | ||
| } | ||
|
|
||
| /** | ||
| * Format date for article slug | ||
| */ | ||
| export function formatDateForSlug(date: Date = new Date()): string { | ||
| return date.toISOString().split('T')[0] ?? ''; | ||
| } | ||
|
|
||
| /** | ||
| * Calculate the current Swedish riksmöte (parliamentary session) string. | ||
| * The session runs September–August: e.g. September 2025 → "2025/26". | ||
| */ | ||
| export function getCurrentRiksmote(date: Date = new Date()): string { | ||
| const year = date.getFullYear(); | ||
| const month = date.getMonth(); // 0-based; September = 8 | ||
| const startYear = month >= 8 ? year : year - 1; | ||
| const endYY = String(startYear + 1).slice(-2); | ||
| return `${startYear}/${endYY}`; | ||
| } | ||
|
|
||
| /** | ||
| * Generate Interpellation Debates article | ||
| */ | ||
| export async function generateInterpellations(options: GenerationOptions = {}): Promise<GenerationResult> { | ||
| const { languages = ['en', 'sv'], limit = 15, writeArticle = null } = options; | ||
|
|
||
| console.log('🔔 Generating Interpellation Debates article...'); | ||
|
|
||
| const mcpCalls: MCPCallRecord[] = []; | ||
|
|
||
| try { | ||
| const client = new MCPClient(); | ||
|
|
||
| console.log(' 🔄 Fetching interpellations from riksdag-regering-mcp...'); | ||
| const interpellations = filterFreshDocuments(await client.fetchInterpellations({ limit }) as RawDocument[]); | ||
| mcpCalls.push({ tool: 'get_interpellationer', result: interpellations }); | ||
| console.log(` 📊 Found ${interpellations.length} interpellations`); | ||
|
|
||
| if (interpellations.length === 0) { | ||
| console.log(' ℹ️ No new interpellations found, skipping'); | ||
| return { success: true, files: 0, mcpCalls }; | ||
| } | ||
|
|
||
| // Tool 2: search_dokument_fulltext — full-text interpellation analysis | ||
| try { | ||
| const topTitle = interpellations[0]?.titel || interpellations[0]?.title || ''; | ||
| if (topTitle) { | ||
| const ftResponse = await client.request('search_dokument_fulltext', { query: topTitle, limit: 3 }); | ||
| const ftDocs = (ftResponse['dokument'] ?? ftResponse['results'] ?? []) as RawDocument[]; | ||
| mcpCalls.push({ tool: 'search_dokument_fulltext', result: ftDocs }); | ||
| console.log(` 📄 Full text: ${ftDocs.length} results`); | ||
| const primaryInterp = interpellations[0] as Record<string, unknown> | undefined; | ||
| if (primaryInterp && ftDocs.length > 0 && !primaryInterp['fullText']) { | ||
| const bestDoc = ftDocs[0] as Record<string, unknown>; | ||
| primaryInterp['fullText'] = (bestDoc['fullText'] as string) || (bestDoc['summary'] as string) || ''; | ||
| } | ||
| } | ||
| } catch (err) { | ||
| console.warn(' ⚠ search_dokument_fulltext unavailable:', (err as Error).message); | ||
| mcpCalls.push({ tool: 'search_dokument_fulltext', result: [] }); | ||
| } | ||
|
|
||
| // Tool 3: search_anforanden — debate context and minister responses | ||
| try { | ||
| const debateQuery = interpellations[0]?.titel || interpellations[0]?.title || ''; | ||
| if (debateQuery) { | ||
| const speeches = await client.searchSpeeches({ text: debateQuery, rm: getCurrentRiksmote(), limit: 10 }) as Array<Record<string, unknown>>; | ||
| mcpCalls.push({ tool: 'search_anforanden', result: speeches }); | ||
| console.log(` 🗣 Debate speeches: ${speeches.length} found`); | ||
| if (speeches.length > 0) { | ||
| for (const interp of interpellations) { | ||
| const m = interp as Record<string, unknown>; | ||
| if (!m['speeches']) { | ||
| m['speeches'] = speeches.slice(0, 3).map((s: Record<string, unknown>) => ({ | ||
| talare: s['talare'], | ||
| parti: s['parti'], | ||
| text: (s['anforande_text'] as string | undefined)?.slice(0, 300), | ||
| anforande_nummer: s['anforande_nummer'], | ||
| })); | ||
| break; | ||
| } | ||
| } | ||
| } | ||
| } | ||
| } catch (err) { | ||
| console.warn(' ⚠ search_anforanden unavailable:', (err as Error).message); | ||
| mcpCalls.push({ tool: 'search_anforanden', result: [] }); | ||
| } | ||
|
|
||
| const today = new Date(); | ||
| const slug = `${formatDateForSlug(today)}-interpellation-debates`; | ||
| const articles: GeneratedArticle[] = []; | ||
|
|
||
| for (const lang of languages) { | ||
| console.log(` 🌐 Generating ${lang.toUpperCase()} version...`); | ||
|
|
||
| // Reuse motions content generator — interpellations share the same document structure | ||
| const content: string = generateArticleContent({ motions: interpellations }, 'interpellations', lang); | ||
| const watchPoints = extractWatchPoints({ motions: interpellations }, lang); | ||
| const metadata = generateMetadata({ motions: interpellations }, 'interpellations', lang); | ||
| const readTime: string = calculateReadTime(content); | ||
| const sources: string[] = generateSources([ | ||
| 'get_interpellationer', | ||
| 'search_dokument_fulltext', | ||
| 'search_anforanden', | ||
| ]); | ||
|
|
||
| const titles: TitleSet = getTitles(lang, interpellations.length, interpellations); | ||
|
|
||
| const html: string = generateArticleHTML({ | ||
| slug: `${slug}-${lang}.html`, | ||
| title: titles.title, | ||
| subtitle: titles.subtitle, | ||
| date: today.toISOString().split('T')[0] ?? '', | ||
| type: 'analysis' as ArticleCategory, | ||
| readTime, | ||
| lang, | ||
| content, | ||
| watchPoints, | ||
| sources, | ||
| keywords: metadata.keywords, | ||
| topics: metadata.topics, | ||
| tags: metadata.tags | ||
| }); | ||
|
|
||
| articles.push({ | ||
| lang, | ||
| html, | ||
| filename: `${slug}-${lang}.html`, | ||
| slug: `${slug}-${lang}` | ||
| }); | ||
|
|
||
| if (writeArticle) { | ||
| await writeArticle(html, `${slug}-${lang}.html`); | ||
| console.log(` ✅ ${lang.toUpperCase()} version generated`); | ||
| } | ||
| } | ||
|
|
||
| return { | ||
| success: true, | ||
| files: languages.length, | ||
| slug, | ||
| articles, | ||
| mcpCalls, | ||
| crossReferences: { | ||
| event: `${interpellations.length} interpellations`, | ||
| sources: ['interpellationer', 'fulltext', 'speeches'] | ||
| } | ||
| }; | ||
|
|
||
| } catch (error: unknown) { | ||
| console.error('❌ Error generating Interpellations:', (error as Error).message); | ||
| return { | ||
| success: false, | ||
| error: (error as Error).message, | ||
| mcpCalls | ||
| }; | ||
| } | ||
| } | ||
|
|
||
| function getTitles(lang: Language, count: number, _documents: RawDocument[] = []): TitleSet { | ||
| const titles: Record<Language, TitleSet> = { | ||
| en: { | ||
| title: `Interpellation Debates: Holding Government to Account`, | ||
| subtitle: `Analysis of ${count} interpellation debates demanding ministerial accountability` | ||
| }, | ||
| sv: { | ||
| title: `Interpellationsdebatter: Regeringen ställs till svars`, | ||
| subtitle: `Analys av ${count} interpellationsdebatter som kräver ministersvar` | ||
| }, | ||
| da: { | ||
| title: `Interpellationsdebatter: Regeringen stilles til ansvar`, | ||
| subtitle: `Analyse af ${count} interpellationsdebatter` | ||
| }, | ||
| no: { | ||
| title: `Interpellasjonsdebatter: Regjeringen stilles til ansvar`, | ||
| subtitle: `Analyse av ${count} interpellasjonsdebatter` | ||
| }, | ||
| fi: { | ||
| title: `Välikysymyskeskustelut: Hallitus tilivelvollisena`, | ||
| subtitle: `Analyysi ${count} välikysymyskeskustelusta` | ||
| }, | ||
| de: { | ||
| title: `Interpellationsdebatten: Regierung in der Verantwortung`, | ||
| subtitle: `Analyse von ${count} Interpellationsdebatten` | ||
| }, | ||
| fr: { | ||
| title: `Débats d'interpellation: Le gouvernement sommé de répondre`, | ||
| subtitle: `Analyse de ${count} débats d'interpellation` | ||
| }, | ||
| es: { | ||
| title: `Debates de interpelación: El gobierno rinde cuentas`, | ||
| subtitle: `Análisis de ${count} debates de interpelación` | ||
| }, | ||
| nl: { | ||
| title: `Interpellatiedebatten: Regering ter verantwoording`, | ||
| subtitle: `Analyse van ${count} interpellatiedebatten` | ||
| }, | ||
| ar: { | ||
| title: `مناقشات الاستجواب: محاسبة الحكومة`, | ||
| subtitle: `تحليل ${count} مناقشات استجواب` | ||
| }, | ||
| he: { | ||
| title: `דיוני אינטרפלציה: הממשלה נדרשת לתת דין וחשבון`, | ||
| subtitle: `ניתוח ${count} דיוני אינטרפלציה` | ||
| }, | ||
| ja: { | ||
| title: `質問主意書討論：政府の説明責任を追及`, | ||
| subtitle: `${count}件の質問主意書討論の分析` | ||
| }, | ||
| ko: { | ||
| title: `대정부 질의 토론: 정부 책임 추궁`, | ||
| subtitle: `${count}건의 대정부 질의 토론 분석` | ||
| }, | ||
| zh: { | ||
| title: `质询辩论：追究政府责任`, | ||
| subtitle: `${count}场质询辩论分析` | ||
| } | ||
| }; | ||
|
|
||
| return titles[lang] || titles.en; | ||
| } | ||
|
|
||
| export function validateInterpellations(article: ArticleInput): InterpellationsValidationResult { | ||
| const hasInterpellations = checkInterpellations(article); | ||
| const hasMinimumSources = countSources(article) >= 2; | ||
| const hasAccountabilityAnalysis = checkAccountabilityAnalysis(article); | ||
|
|
||
| return { | ||
| hasInterpellations, | ||
| hasMinimumSources, | ||
| hasAccountabilityAnalysis, | ||
| passed: hasInterpellations && hasMinimumSources && hasAccountabilityAnalysis | ||
| }; | ||
| } | ||
|
|
||
| function checkInterpellations(article: ArticleInput): boolean { | ||
| if (!article || !article.content) return false; | ||
| return article.content.toLowerCase().includes('interpellation') || | ||
| article.content.toLowerCase().includes('minister') || | ||
| article.content.toLowerCase().includes('accountability'); | ||
| } | ||
|
|
||
| function countSources(article: ArticleInput): number { | ||
| if (!article || !article.sources) return 0; | ||
| return Array.isArray(article.sources) ? article.sources.length : 0; | ||
| } | ||
|
|
||
| function checkAccountabilityAnalysis(article: ArticleInput): boolean { | ||
| if (!article || !article.content) return false; | ||
| const keywords = ['accountability', 'minister', 'interpellation', 'parliamentary']; | ||
| return keywords.some(keyword => | ||
| (article.content as string).toLowerCase().includes(keyword) | ||
| ); | ||
| } |
Member
|
@copilot apply changes based on the comments in this thread |
- Added dedicated interpellationsTag to ContentLabels with 14-language translations instead of reusing oppMotionsTag - Fixed metadata.ts to use interpellationsTag for interpellations articles - Removed dead scripts/news-types/interpellations.ts (341 lines) that duplicated generators.ts logic and was never imported - Updated data-transformers test to include interpellationsTag in required keys Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
Contributor
Author
Applied both review comments in ad4a745:
|
Contributor
🔍 Lighthouse Performance Audit
📥 Download full Lighthouse report Budget Compliance: Performance budgets enforced via |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds a new interpellations article type for covering parliamentary interpellation debates (interpellationsdebatter) — formal parliamentary questions where ministers must personally respond. The implementation follows the established patterns from the existing motions article type.
Changes:
- Added
interpellationsto theArticleTypeunion,VALID_ARTICLE_TYPES, and content routing (sharing the motions content generator), with a newgenerateInterpellations()orchestrator function ingenerators.ts - Added
interpellationsTaglocalization key to all 14 language label files and theContentLabelSettype, plus metadata generation for the new type - Created
.github/workflows/news-interpellations.mdworkflow running weekdays at 07:00 UTC, and updated tests to cover the new article type
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| scripts/types/article.ts | Added 'interpellations' to ArticleType union |
| scripts/types/content.ts | Added interpellationsTag to ContentLabelSet interface |
| scripts/generate-news-enhanced/config.ts | Added 'interpellations' to VALID_ARTICLE_TYPES |
| scripts/generate-news-enhanced/generators.ts | New generateInterpellations() function mirroring generateMotions() |
| scripts/generate-news-enhanced/index.ts | Import/export and orchestrator case for interpellations |
| scripts/generate-news-enhanced.ts | Barrel re-export of generateInterpellations and updated doc comment |
| scripts/data-transformers/index.ts | Routes 'interpellations' to motions content generator |
| scripts/data-transformers/metadata.ts | Metadata keywords/topics/tags for interpellations |
| scripts/data-transformers/constants/content-labels-part1.ts | interpellationsTag for EN, SV, DA, NO, FI, DE, FR |
| scripts/data-transformers/constants/content-labels-part2.ts | interpellationsTag for ES, NL, AR, HE, JA, KO, ZH |
| .github/workflows/news-interpellations.md | New AWF workflow for interpellation debates |
| tests/workflow-architecture.test.ts | Updated type/workflow arrays and stagger test |
| tests/data-transformers.test.ts | Added interpellationsTag to required label keys |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No dedicated article type or recurring workflow existed for interpellation debates (interpellationsdebatter) — the strongest parliamentary accountability tool where ministers must personally respond in chamber. The MCP client already had
fetchInterpellations()but it was only consumed by the week-ahead generator as supplementary data.New article type:
interpellationsArticleTypeunion andVALID_ARTICLE_TYPESgenerateInterpellations()ingenerators.tsusing shared MCP client with document enrichment'interpellations'case in data-transformers shares the motions content generator (same document structure)interpellationsTaglocalization key in all 14 languagesinterpellationsTagtoContentLabelstype and all 14 language label files (e.g., "Interpellation Debates", "Interpellationsdebatter", "Débats d'interpellation", "质询辩论", etc.)Workflow
.github/workflows/news-interpellations.md— weekdays at 07:00 UTC, filling the gap in the schedule:Tests
Updated
ARTICLE_TYPE_WORKFLOWS,expectedTypes, and weekday stagger arrays inworkflow-architecture.test.ts. AddedinterpellationsTagto required content label keys indata-transformers.test.ts. All 2920 tests pass.Original prompt
📱 Kick off Copilot coding agent tasks wherever you are with GitHub Mobile, available on iOS and Android.