Add deep-inspection analysis: multi-stakeholder SWOT, economic dashboards, newsworthiness scoring

.github/workflows/news-article-generator.md

@@ -6,7 +6,7 @@ on:
   workflow_dispatch:
     inputs:
       article_types:
-        description: Comma-separated article types (week-ahead,month-ahead,weekly-review,monthly-review,committee-reports,propositions,motions,breaking). Leave empty for day-of-week schedule.
+        description: Comma-separated article types (week-ahead,month-ahead,weekly-review,monthly-review,committee-reports,propositions,motions,breaking,deep-inspection). Leave empty for day-of-week schedule.
         required: false
       force_generation:
         description: Force generation even if recent articles exist
@@ -17,6 +17,15 @@ on:
         description: 'Languages to generate (en,sv | nordic | eu-core | all | custom comma-separated)'
         required: false
         default: all
+      document_ids:
+        description: 'Comma-separated Riksdag document IDs for deep-inspection analysis (e.g. H901FiU1,H901JuU25)'
+        required: false
+      document_urls:
+        description: 'Comma-separated URLs to specific documents, press releases, or events for deep analysis'
+        required: false
+      focus_topic:
+        description: 'Specific topic or policy area to focus deep-inspection analysis on (e.g. defence, migration, budget)'
+        required: false
 
 permissions:
   contents: read
@@ -100,12 +109,17 @@ You are the **News Journalist Agent** for Riksdagsmonitor. Generate high-quality
 - **article_types** = `${{ github.event.inputs.article_types }}`
 - **force_generation** = `${{ github.event.inputs.force_generation }}`
 - **languages** = `${{ github.event.inputs.languages }}`
+- **document_ids** = `${{ github.event.inputs.document_ids }}`
+- **document_urls** = `${{ github.event.inputs.document_urls }}`
+- **focus_topic** = `${{ github.event.inputs.focus_topic }}`
 
 **Rules:**
 1. If **article_types** is non-empty, generate ONLY those types. Do NOT fall back to day-of-week schedule.
 2. If **article_types** is empty/blank, use day-of-week schedule (see Step 2).
 3. If **force_generation** is `true`, generate even if recent articles exist.
 4. If **languages** is empty/blank, default to `all` (14 languages).
+5. If **article_types** includes `deep-inspection`, use **document_ids**, **document_urls**, and **focus_topic** for targeted deep analysis.
+6. For `deep-inspection` type: pass `--document-ids` and `--focus-topic` flags to the generation script.
 
 ## ⚠️ NON-NEGOTIABLE RULES
 

scripts/data-transformers/content-generators/economic-dashboard-section.ts

@@ -0,0 +1,287 @@
+/**
+ * @module data-transformers/content-generators/economic-dashboard-section
+ * @description Generates an embeddable economic dashboard section powered by
+ * World Bank data indicators. Automatically selects relevant indicators based
+ * on detected policy domains in the article content, creating Chart.js
+ * dashboards with Nordic country comparisons.
+ *
+ * Used by agentic workflows and deep inspection analysis to add economic
+ * context dashboards to articles when policy areas match World Bank indicators.
+ *
+ * @author Hack23 AB
+ * @license Apache-2.0
+ */
+
+import { escapeHtml } from '../../html-utils.js';
+import type { Language } from '../../types/language.js';
+import type {
+  TemplateSection,
+  DashboardChartConfig,
+  DashboardTableConfig,
+} from '../../types/article.js';
+import {
+  type EconomicIndicatorContext,
+  findRelevantIndicators,
+  getEconomicHeading,
+  NORDIC_COMPARISON,
+} from '../../world-bank-context.js';
+import { generateDashboardSection } from './dashboard-section.js';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** A World Bank data point for dashboard rendering */
+export interface EconomicDataPoint {
+  /** Country code (e.g. 'SWE', 'DNK') */
+  countryCode: string;
+  /** Country name */
+  countryName: string;
+  /** Indicator ID */
+  indicatorId: string;
+  /** Year or date string */
+  date: string;
+  /** Numeric value */
+  value: number;
+}
+
+/** Options for the economic dashboard section generator */
+export interface EconomicDashboardOptions {
+  /** Policy domains detected in the article (e.g. ['fiscal', 'defence']) */
+  policyDomains: string[];
+  /** Optional pre-fetched World Bank data points */
+  dataPoints?: EconomicDataPoint[];
+  /** Target language */
+  lang: Language | string;
+  /** Custom title override */
+  title?: string;
+  /** Optional narrative summary */
+  summary?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** Sanitize an indicator ID into a safe HTML element id */
+function sanitizeChartId(indicatorId: string): string {
+  return indicatorId.replace(/[^a-zA-Z0-9]/g, '-').toLowerCase();
+}
+
+const COUNTRY_COLORS: Readonly<Record<string, string>> = {
+  SWE: '#00d9ff',  // Cyan (primary)
+  DNK: '#ff006e',  // Magenta
+  NOR: '#ffbe0b',  // Yellow
+  FIN: '#83cf39',  // Green
+  DEU: '#9d4edd',  // Purple
+};
+
+const COUNTRY_BORDER_COLORS: Readonly<Record<string, string>> = {
+  SWE: '#00b8d4',
+  DNK: '#d4004e',
+  NOR: '#d4a00b',
+  FIN: '#6daf2d',
+  DEU: '#7d3ebd',
+};
+
+// ---------------------------------------------------------------------------
+// Helper functions
+// ---------------------------------------------------------------------------
+
+/**
+ * Find relevant World Bank indicators for a set of policy domains.
+ */
+export function findIndicatorsForDomains(domains: string[]): EconomicIndicatorContext[] {
+  const seen = new Set<string>();
+  const result: EconomicIndicatorContext[] = [];
+  for (const domain of domains) {
+    for (const indicator of findRelevantIndicators(domain)) {
+      if (!seen.has(indicator.indicatorId)) {
+        seen.add(indicator.indicatorId);
+        result.push(indicator);
+      }
+    }
+  }
+  return result;
+}
+
+/**
+ * Build Chart.js chart configurations from economic data points.
+ * Groups data by indicator and creates bar charts comparing Nordic countries.
+ */
+export function buildEconomicCharts(
+  indicators: EconomicIndicatorContext[],
+  dataPoints: EconomicDataPoint[],
+): DashboardChartConfig[] {
+  const charts: DashboardChartConfig[] = [];
+
+  for (const indicator of indicators) {
+    const points = dataPoints.filter(p => p.indicatorId === indicator.indicatorId);
+    if (points.length === 0) continue;
+
+    // Group by country for comparison chart
+    const byCountry = new Map<string, EconomicDataPoint[]>();
+    for (const p of points) {
+      if (!byCountry.has(p.countryCode)) byCountry.set(p.countryCode, []);
+      byCountry.get(p.countryCode)!.push(p);
+    }
+
+    // Get latest year's data for comparison bar chart
+    const latestYear = points.reduce((max, p) => p.date > max ? p.date : max, '');
+    const latestPoints = points.filter(p => p.date === latestYear);
+
+    if (latestPoints.length > 0) {
+      const labels = latestPoints.map(p =>
+        NORDIC_COMPARISON.countryNames[p.countryCode] ?? p.countryName
+      );
+      const data = latestPoints.map(p => p.value);
+      const bgColors = latestPoints.map(p => COUNTRY_COLORS[p.countryCode] ?? '#888');
+      const borderColors = latestPoints.map(p => COUNTRY_BORDER_COLORS[p.countryCode] ?? '#666');
+
+      const idBase = sanitizeChartId(indicator.indicatorId);
+      charts.push({
+        id: `econ-${idBase}`,
+        type: 'bar',
+        title: `${indicator.name} (${latestYear})`,
+        labels,
+        datasets: [{
+          label: `${indicator.name} (${indicator.unit})`,
+          data,
+          backgroundColor: bgColors,
+          borderColor: borderColors,
+          borderWidth: 1,
+        }],
+      });
+    }
+
+    // If we have multi-year data, add a trend line chart
+    const swedenPoints = (byCountry.get('SWE') ?? []).sort((a, b) => a.date.localeCompare(b.date));
+    if (swedenPoints.length >= 3) {
+      const trendLabels = swedenPoints.map(p => p.date);
+      const trendData = swedenPoints.map(p => p.value);
+      const idBase = sanitizeChartId(indicator.indicatorId);
+      charts.push({
+        id: `econ-trend-${idBase}`,
+        type: 'line',
+        title: `Sweden: ${indicator.name} Trend`,
+        labels: trendLabels,
+        datasets: [{
+          label: `Sweden ${indicator.name} (${indicator.unit})`,
+          data: trendData,
+          backgroundColor: 'rgba(0, 217, 255, 0.2)',
+          borderColor: '#00d9ff',
+          borderWidth: 2,
+        }],
+      });
+    }
+  }
+
+  return charts;
+}
+
+/**
+ * Build data tables from economic data points for accessibility fallback.
+ */
+export function buildEconomicTables(
+  indicators: EconomicIndicatorContext[],
+  dataPoints: EconomicDataPoint[],
+): DashboardTableConfig[] {
+  const tables: DashboardTableConfig[] = [];
+
+  for (const indicator of indicators) {
+    const points = dataPoints.filter(p => p.indicatorId === indicator.indicatorId);
+    if (points.length === 0) continue;
+
+    const latestYear = points.reduce((max, p) => p.date > max ? p.date : max, '');
+    const latestPoints = points.filter(p => p.date === latestYear);
+
+    if (latestPoints.length > 0) {
+      tables.push({
+        caption: `${indicator.name} (${latestYear}) — ${indicator.unit}`,
+        headers: ['Country', indicator.name, 'Unit'],
+        rows: latestPoints.map(p => [
+          NORDIC_COMPARISON.countryNames[p.countryCode] ?? p.countryName,
+          p.value.toFixed(2),
+          indicator.unit,
+        ]),
+      });
+    }
+  }
+
+  return tables;
+}
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+/**
+ * Generate an economic dashboard section based on detected policy domains.
+ *
+ * Automatically finds relevant World Bank indicators for the given policy
+ * domains, builds Chart.js charts (comparison + trend), and generates
+ * accessible data tables.
+ *
+ * If no data points are provided but indicators are found, returns a
+ * placeholder section describing the relevant indicators (agentic workflows
+ * should fetch the actual data from World Bank API).
+ *
+ * @example
+ * ```ts
+ * const section = generateEconomicDashboardSection({
+ *   policyDomains: ['fiscal policy', 'defense'],
+ *   dataPoints: worldBankData,
+ *   lang: 'en',
+ * });
+ * if (section) {
+ *   articleData.sections = [...(articleData.sections ?? []), section];
+ * }
+ * ```
+ */
+export function generateEconomicDashboardSection(opts: EconomicDashboardOptions): TemplateSection | null {
+  const { policyDomains, dataPoints, lang } = opts;
+
+  // Find relevant indicators
+  const indicators = findIndicatorsForDomains(policyDomains);
+  if (indicators.length === 0) return null;
+
+  const headingText = opts.title?.trim() || getEconomicHeading(lang, 'economicContext');
+
+  // If we have actual data points, build charts
+  if (dataPoints && dataPoints.length > 0) {
+    const charts = buildEconomicCharts(indicators, dataPoints);
+    const tables = buildEconomicTables(indicators, dataPoints);
+
+    if (charts.length === 0 && tables.length === 0) return null;
+
+    return generateDashboardSection({
+      data: {
+        title: headingText,
+        summary: opts.summary?.trim() || undefined,
+        charts,
+        tables: tables.length > 0 ? tables : undefined,
+      },
+      lang,
+    });
+  }
+
+  // No data points: generate a placeholder section describing relevant indicators
+  const indicatorItems = indicators.map(ind =>
+    `        <li><strong>${escapeHtml(ind.name)}</strong> (${escapeHtml(ind.unit)}): ${escapeHtml(ind.description)}</li>`
+  ).join('\n');
+
+  const policyLabel = getEconomicHeading(lang, 'policyImplications');
+  const html = `<section class="economic-dashboard-placeholder" aria-label="${escapeHtml(headingText)}">
+    <h2>${escapeHtml(headingText)}</h2>
+    <p>${escapeHtml(policyLabel)}</p>
+    <ul class="economic-indicators-list">
+${indicatorItems}
+    </ul>
+  </section>`;
+
+  return {
+    id: 'economic-dashboard',
+    html,
+    className: 'economic-dashboard-section',
+  };
+}

scripts/data-transformers/content-generators/index.ts

@@ -12,6 +12,9 @@
  * - **month-ahead** — generateMonthAheadContent
  * - **swot-section** — generateSwotSection  (embeddable SWOT analysis)
  * - **dashboard-section** — generateDashboardSection  (embeddable Chart.js dashboard)
+ * - **stakeholder-swot-section** — generateStakeholderSwotSection  (multi-stakeholder SWOT)
+ * - **economic-dashboard-section** — generateEconomicDashboardSection  (World Bank dashboards)
+ * - **newsworthiness** — scoreNewsworthiness  (strategic content detection)
  *
  * @author Hack23 AB
  * @license Apache-2.0
@@ -30,3 +33,9 @@ export { generateSwotSection } from './swot-section.js';
 export type { SwotSectionOptions } from './swot-section.js';
 export { generateDashboardSection } from './dashboard-section.js';
 export type { DashboardSectionOptions } from './dashboard-section.js';
+export { generateStakeholderSwotSection } from './stakeholder-swot-section.js';
+export type { StakeholderSwotSectionOptions, StakeholderSwot } from './stakeholder-swot-section.js';
+export { generateEconomicDashboardSection, findIndicatorsForDomains, buildEconomicCharts, buildEconomicTables } from './economic-dashboard-section.js';
+export type { EconomicDashboardOptions, EconomicDataPoint } from './economic-dashboard-section.js';
+export { scoreNewsworthiness } from './newsworthiness.js';
+export type { NewsworthinessScore, NewsworthinessDimension } from './newsworthiness.js';