feat(motions): implement search_dokument_fulltext, analyze_g0v_by_department, and search_anforanden

scripts/data-transformers/constants.ts

@@ -118,6 +118,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'General matters',
     responsesToProp: 'Responses to Government Propositions',
     independentMotions: 'Independent Motions',
+    govEngagement: 'Government Department Engagement',
     twitterLabel1: 'Reading time',
     twitterLabel2: 'Article type',
     jobTitle: 'Political Intelligence Analyst',
@@ -196,6 +197,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'Övriga frågor',
     responsesToProp: 'Svar på propositioner',
     independentMotions: 'Övriga motioner',
+    govEngagement: 'Regeringsdepartementens engagemang',
     twitterLabel1: 'Lästid',
     twitterLabel2: 'Artikeltyp',
     jobTitle: 'Politisk underrättelseanalytiker',
@@ -274,6 +276,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'Generelle spørgsmål',
     responsesToProp: 'Svar på regeringsforslag',
     independentMotions: 'Andre forslag',
+    govEngagement: 'Regeringsdepartementernes engagement',
     twitterLabel1: 'Læsetid',
     twitterLabel2: 'Artikeltype',
     jobTitle: 'Politisk efterretningsanalytiker',
@@ -352,6 +355,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'Generelle spørsmål',
     responsesToProp: 'Svar på regjeringforslag',
     independentMotions: 'Andre forslag',
+    govEngagement: 'Regjeringsdepartementenes engasjement',
     twitterLabel1: 'Lesetid',
     twitterLabel2: 'Artikkeltype',
     jobTitle: 'Politisk etterretningsanalytiker',
@@ -430,6 +434,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'Yleiset asiat',
     responsesToProp: 'Vastaukset hallituksen esityksiin',
     independentMotions: 'Muut aloitteet',
+    govEngagement: 'Ministeriöiden osallistuminen',
     twitterLabel1: 'Lukuaika',
     twitterLabel2: 'Artikkelityyppi',
     jobTitle: 'Poliittinen tiedusteluanalyytikko',
@@ -508,6 +513,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'Allgemeine Angelegenheiten',
     responsesToProp: 'Antworten auf Regierungsvorlagen',
     independentMotions: 'Sonstige Anträge',
+    govEngagement: 'Engagement der Regierungsressorts',
     twitterLabel1: 'Lesezeit',
     twitterLabel2: 'Artikeltyp',
     jobTitle: 'Politischer Geheimdienstanalyst',
@@ -586,6 +592,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'Questions générales',
     responsesToProp: 'Réponses aux propositions gouvernementales',
     independentMotions: 'Autres motions',
+    govEngagement: 'Engagement des ministères',
     twitterLabel1: 'Temps de lecture',
     twitterLabel2: "Type d'article",
     jobTitle: 'Analyste en renseignement politique',
@@ -664,6 +671,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'Asuntos generales',
     responsesToProp: 'Respuestas a proposiciones del gobierno',
     independentMotions: 'Otras mociones',
+    govEngagement: 'Compromiso de los ministerios',
     twitterLabel1: 'Tiempo de lectura',
     twitterLabel2: 'Tipo de artículo',
     jobTitle: 'Analista de inteligencia política',
@@ -742,6 +750,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'Algemene zaken',
     responsesToProp: 'Antwoorden op regeringsvoorstellen',
     independentMotions: 'Overige moties',
+    govEngagement: 'Betrokkenheid van ministeries',
     twitterLabel1: 'Leestijd',
     twitterLabel2: 'Artikeltype',
     jobTitle: 'Politiek inlichtingenanalist',
@@ -820,6 +829,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'مسائل عامة',
     responsesToProp: 'ردود على مقترحات الحكومة',
     independentMotions: 'اقتراحات أخرى',
+    govEngagement: 'مشاركة الوزارات الحكومية',
     twitterLabel1: 'وقت القراءة',
     twitterLabel2: 'نوع المقال',
     jobTitle: 'محلل الاستخبارات السياسية',
@@ -898,6 +908,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: 'עניינים כלליים',
     responsesToProp: 'תשובות להצעות הממשלה',
     independentMotions: 'הצעות אחרות',
+    govEngagement: 'מעורבות משרדי הממשלה',
     twitterLabel1: 'זמן קריאה',
     twitterLabel2: 'סוג כתבה',
     jobTitle: 'אנליסט מודיעין פוליטי',
@@ -976,6 +987,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: '一般事項',
     responsesToProp: '政府提案への回答',
     independentMotions: 'その他の動議',
+    govEngagement: '政府省庁の関与',
     twitterLabel1: '読了時間',
     twitterLabel2: '記事タイプ',
     jobTitle: '政治インテリジェンスアナリスト',
@@ -1054,6 +1066,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: '일반 사항',
     responsesToProp: '정부 제안에 대한 응답',
     independentMotions: '기타 동의',
+    govEngagement: '정부 부처 참여',
     twitterLabel1: '읽기 시간',
     twitterLabel2: '기사 유형',
     jobTitle: '정치 인텔리전스 분석가',
@@ -1132,6 +1145,7 @@ export const CONTENT_LABELS: Record<Language, ContentLabelSet> = {
     generalMatters: '一般事项',
     responsesToProp: '对政府提案的回应',
     independentMotions: '其他动议',
+    govEngagement: '政府部门参与',
     twitterLabel1: '阅读时间',
     twitterLabel2: '文章类型',
     jobTitle: '政治情报分析师',

scripts/data-transformers/content-generators.ts

@@ -945,6 +945,24 @@ export function generateMotionsContent(data: ArticleContentData, lang: Language
     content += `      </ul>\n    </div>\n`;
   }
 
+  // Government department engagement section (from analyze_g0v_by_department)
+  const govDeptData = data.govDeptData ?? [];
+  if (govDeptData.length > 0) {
+    content += `\n    <h2>${L(lang, 'govEngagement')}</h2>\n`;
+    content += `    <div class="context-box">\n      <ul>\n`;
+    govDeptData.slice(0, 5).forEach(dept => {
+      const deptName = escapeHtml(String(dept['name'] ?? dept['departement'] ?? dept['department'] ?? ''));
+      const deptCount = dept['count'] ?? dept['total'] ?? dept['document_count'];
+      if (deptName) {
+        const hasDeptCount = deptCount !== null && deptCount !== undefined;
+        content += hasDeptCount
+          ? `        <li><strong>${deptName}</strong> (${escapeHtml(String(deptCount))})</li>\n`
+          : `        <li><strong>${deptName}</strong></li>\n`;
+      }
+    });
+    content += `      </ul>\n    </div>\n`;
+  }
+
   return content;
 }
 

scripts/data-transformers/types.ts

@@ -93,6 +93,8 @@ export interface ArticleContentData {
   context?: string;
   /** CIA intelligence context for enriched analysis */
   ciaContext?: CIAContext;
+  /** Government department analysis from analyze_g0v_by_department */
+  govDeptData?: Record<string, unknown>[];
   /** Full-text search results for policy substance extraction */
   fullTextResults?: unknown[];
   /** Government department analysis from analyze_g0v_by_department */

scripts/news-types/motions.ts

@@ -54,10 +54,10 @@
  * - Includes motion text, sponsorship, current status
  * - Enables systematic opposition coverage
  * 
- * TODO: Implement additional tools for comprehensive analysis:
- * - search_dokument_fulltext: Full text analysis of motion content
- * - analyze_g0v_by_department: Government department responses
- * - search_anforanden: Parliamentary debate related to motion
+ * Additional tools (all implemented with graceful degradation):
+ * - search_dokument_fulltext: Full-text policy alternative analysis
+ * - analyze_g0v_by_department: Government department response tracking
+ * - search_anforanden: Debate context and party positioning
  * 
  * **OPERATIONAL WORKFLOW:**
  * 1. Query MCP: Fetch recent motions (default: 10 most recent)
@@ -186,16 +186,14 @@ import type { ArticleCategory, GeneratedArticle, GenerationResult, MCPCallRecord
 /**
  * Required MCP tools for motions articles
  * 
- * REQUIRED_TOOLS UPDATE (2026-02-14):
- * Initially set to 4 tools ['get_motioner', 'search_dokument_fulltext', 'analyze_g0v_by_department', 'search_anforanden']
- * to match tests/validation expectations. However, this caused runtime validation failures
- * since the implementation only calls get_motioner (line 56).
- * 
- * Reverted to actual implementation (1 tool) to prevent validation failures.
- * When additional tools are implemented in generateMotions(), add them back here.
+ * Restored to full 4-tool specification (2026-02-26):
+ * All four tools are now implemented with graceful degradation on failure.
  */
 export const REQUIRED_TOOLS: readonly string[] = [
-  'get_motioner'
+  'get_motioner',
+  'search_dokument_fulltext',
+  'analyze_g0v_by_department',
+  'search_anforanden',
 ];
 
 export interface TitleSet {
@@ -229,6 +227,18 @@ 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 Opposition Motions article
  */
@@ -251,6 +261,75 @@ export async function generateMotions(options: GenerationOptions = {}): Promise<
       console.log('  ℹ️ No new motions found, skipping');
       return { success: true, files: 0, mcpCalls };
     }
+
+    // Tool 2: search_dokument_fulltext — full-text policy alternative analysis
+    try {
+      const topTitle = motions[0]?.titel || motions[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`);
+        // Attach the best matching full text only to the primary motion (the one used for the query)
+        const primaryMotion = motions[0] as Record<string, unknown> | undefined;
+        if (primaryMotion && ftDocs.length > 0 && !primaryMotion['fullText']) {
+          const bestDoc = ftDocs[0] as Record<string, unknown>;
+          primaryMotion['fullText'] = (bestDoc['fullText'] as string) || (bestDoc['summary'] as string) || '';
+          if (ftDocs.length > 1) {
+            primaryMotion['policyAlternativeDocs'] = ftDocs;
+          }
+        }
+      }
+    } catch (err) {
+      console.warn('  ⚠ search_dokument_fulltext unavailable:', (err as Error).message);
+      mcpCalls.push({ tool: 'search_dokument_fulltext', result: [] });
+    }
+
+    // Tool 3: analyze_g0v_by_department — government department response tracking
+    let govDeptData: Record<string, unknown>[] = [];
+    try {
+      const today0 = new Date();
+      const thirtyDaysAgo = new Date(today0);
+      thirtyDaysAgo.setDate(thirtyDaysAgo.getDate() - 30);
+      const govResp = await client.request('analyze_g0v_by_department', {
+        dateFrom: formatDateForSlug(thirtyDaysAgo),
+        dateTo: formatDateForSlug(today0),
+      });
+      govDeptData = (govResp['departments'] ?? govResp['data'] ?? []) as Record<string, unknown>[];
+      mcpCalls.push({ tool: 'analyze_g0v_by_department', result: govDeptData });
+      console.log(`  🏛 Gov dept analysis: ${govDeptData.length} departments`);
+    } catch (err) {
+      console.warn('  ⚠ analyze_g0v_by_department unavailable:', (err as Error).message);
+      mcpCalls.push({ tool: 'analyze_g0v_by_department', result: [] });
+    }
+
+    // Tool 4: search_anforanden — debate context and party positioning
+    try {
+      const debateQuery = motions[0]?.titel || motions[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`);
+        // Attach speeches to the first motion without speeches for "Party Positioning" rendering
+        if (speeches.length > 0) {
+          for (const motion of motions) {
+            const m = motion 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)}-opposition-motions`;
@@ -259,11 +338,16 @@ export async function generateMotions(options: GenerationOptions = {}): Promise<
     for (const lang of languages) {
       console.log(`  🌐 Generating ${lang.toUpperCase()} version...`);
 
-      const content: string = generateArticleContent({ motions }, 'motions', lang);
+      const content: string = generateArticleContent({ motions, govDeptData }, 'motions', lang);
       const watchPoints = extractWatchPoints({ motions }, lang);
       const metadata = generateMetadata({ motions }, 'motions', lang);
       const readTime: string = calculateReadTime(content);
-      const sources: string[] = generateSources(['get_motioner']);
+      const sources: string[] = generateSources([
+        'get_motioner',
+        'search_dokument_fulltext',
+        'analyze_g0v_by_department',
+        'search_anforanden',
+      ]);
 
       const titles: TitleSet = getTitles(lang, motions.length, motions);
 
@@ -304,7 +388,7 @@ export async function generateMotions(options: GenerationOptions = {}): Promise<
       mcpCalls,
       crossReferences: {
         event: `${motions.length} motions`,
-        sources: ['motioner']
+        sources: ['motioner', 'fulltext', 'gov-dept', 'speeches']
       }
     };
 

scripts/types/content.ts

@@ -106,6 +106,7 @@ export interface ContentLabelSet {
   generalMatters: string;
   responsesToProp: string;
   independentMotions: string;
+  govEngagement: string;
   twitterLabel1: string;
   twitterLabel2: string;
   jobTitle: string;