euparliamentmonitor 0.9.2 → 0.9.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -163,9 +163,9 @@
     "happy-dom": "20.9.0",
     "htmlhint": "1.9.2",
     "husky": "9.1.7",
-    "jscpd": "4.0.9",
+    "jscpd": "4.1.0",
     "knip": "^6.7.0",
-    "lint-staged": "17.0.3",
+    "lint-staged": "17.0.4",
     "mermaid": "11.14.0",
     "papaparse": "5.5.3",
     "prettier": "3.8.3",

package/scripts/aggregator/analysis-aggregator.d.ts

@@ -115,6 +115,17 @@ export declare function renderProvenanceBlock(params: {
  * @returns Markdown block with two subsections (methodologies, templates)
  */
 export declare function renderTradecraftAppendix(files: readonly string[]): string;
+/**
+ * Public re-export of the internal `humanize` helper so other aggregator
+ * modules (in particular `article-html.ts`) can derive the same display
+ * title from a file stem when no curated title is available. Keeping the
+ * single canonical implementation here avoids duplicate humanisation
+ * rules drifting across modules.
+ *
+ * @param stem - File stem (e.g. `electoral-cycle-methodology`)
+ * @returns Humanised title (e.g. `Electoral Cycle Methodology`)
+ */
+export declare function humanizeStem(stem: string): string;
 /**
  * Render the analysis-index appendix — a compact table of every included
  * artifact and its section, plus a direct link to the manifest.

package/scripts/aggregator/analysis-aggregator.js

@@ -213,19 +213,25 @@ export function renderTradecraftAppendix(files) {
         'This article is produced under the [Hack23 AB](https://hack23.com) intelligence tradecraft library. Every methodology and artifact template applied to this run is linked below.',
         '',
     ];
-    if (methods.length > 0) {
-        block.push('### Methodologies');
+    // Order: Artifact templates first (concrete deliverables readers
+    // recognise from the article body), then Methodologies (the underlying
+    // tradecraft library). This matches the natural reader flow — the
+    // article is built from artifacts, and the methodologies explain how
+    // each artifact is produced — and pairs with the contextual, kind-
+    // aware "View …" CTAs rendered in `enhanceTradecraftCards`.
+    if (templates.length > 0) {
+        block.push('### Artifact templates');
         block.push('');
-        for (const rel of methods) {
+        for (const rel of templates) {
             const stem = rel.split('/').pop()?.replace(/\.md$/i, '') ?? rel;
             block.push(`- [${humanize(stem)}](${githubBlobUrl(rel)})`);
         }
         block.push('');
     }
-    if (templates.length > 0) {
-        block.push('### Artifact templates');
+    if (methods.length > 0) {
+        block.push('### Methodologies');
         block.push('');
-        for (const rel of templates) {
+        for (const rel of methods) {
             const stem = rel.split('/').pop()?.replace(/\.md$/i, '') ?? rel;
             block.push(`- [${humanize(stem)}](${githubBlobUrl(rel)})`);
         }
@@ -233,6 +239,19 @@ export function renderTradecraftAppendix(files) {
     }
     return block.join('\n');
 }
+/**
+ * Public re-export of the internal `humanize` helper so other aggregator
+ * modules (in particular `article-html.ts`) can derive the same display
+ * title from a file stem when no curated title is available. Keeping the
+ * single canonical implementation here avoids duplicate humanisation
+ * rules drifting across modules.
+ *
+ * @param stem - File stem (e.g. `electoral-cycle-methodology`)
+ * @returns Humanised title (e.g. `Electoral Cycle Methodology`)
+ */
+export function humanizeStem(stem) {
+    return humanize(stem);
+}
 /**
  * Render the analysis-index appendix — a compact table of every included
  * artifact and its section, plus a direct link to the manifest.

package/scripts/aggregator/article-generator.js

@@ -29,7 +29,7 @@ import { resolveRunId as _resolveRunId } from './manifest/index.js';
 import { resolveArticleMetadata, extractStrongProseLine, } from './article-metadata.js';
 import { buildArticleMeta, serializeArticleMeta } from './article-meta.js';
 import { renderMarkdown } from './markdown-renderer.js';
-import { wrapArticleHtml, getArticleFilename, localizeArticleBody } from './article-html.js';
+import { wrapArticleHtml, getArticleFilename, localizeArticleBody, enhanceTradecraftCards, enhanceAnalysisIndexCards, } from './article-html.js';
 import { buildReaderIntelligenceGuideHtml, stripInlineReaderGuide, } from './reader-intelligence-guide.js';
 import { ALL_LANGUAGES } from '../constants/language-core.js';
 import { blobUrl } from './infra/github-urls.js';
@@ -364,6 +364,12 @@ function writeLanguageVariant(lang, slug, aggregated, englishHtml, chromeOptions
     // Localize Tradecraft References, Analysis Index, and other appendix
     // section headings and content into the target language.
     bodyHtml = localizeArticleBody(bodyHtml, lang);
+    // Replace the plain Tradecraft References bullet lists and the
+    // Analysis Index table with `pi-card-grid` cards. Runs for every
+    // language (including English) so the "much nicer" rendering matches
+    // the political-intelligence.html visual vocabulary site-wide.
+    bodyHtml = enhanceTradecraftCards(bodyHtml, lang);
+    bodyHtml = enhanceAnalysisIndexCards(bodyHtml, lang);
     // When a per-language translated source exists, prefer a summary derived
     // from it so the `<meta description>` matches the visible prose. The
     // editorial title still comes from the English resolver (per-language

package/scripts/aggregator/article-html.d.ts

@@ -73,8 +73,10 @@ export declare function buildArticleHreflangLinks(articleSlug: string): string;
  * Build the article-level Table of Contents nav. Renders a labelled
  * `<nav class="article-toc">` with one `<a>` per H2 section, keyed by the
  * stable fragment ids produced by the aggregator. The containing `<aside>`
- * is styled as a sticky sidebar on wide viewports and collapses into a
- * `<details>` disclosure on narrow viewports via `styles.css`.
+ * is styled as a sticky, full-height sidebar on wide viewports and
+ * collapses into a `<details>` disclosure on narrow viewports via
+ * `styles.css`. Each entry is prefixed with a contextual emoji icon so
+ * readers can scan the navigation visually as well as textually.
  *
  * Returns an empty string when `entries` is empty so low-signal
  * `ANALYSIS_ONLY` articles (few sections, no value in a TOC) stay compact.
@@ -94,6 +96,46 @@ export declare function buildArticleToc(entries: readonly ArticleTocEntry[], lan
  * @returns HTML body with localized appendix sections
  */
 export declare function localizeArticleBody(bodyHtml: string, lang: LanguageCode): string;
+/**
+ * Replace the rendered Tradecraft References bullet lists with a
+ * `pi-card-grid` of richly described cards (icon, curated title,
+ * curated description, kind-aware CTA). The cards reuse the exact same
+ * class hooks as `political-intelligence.html`, so the site-wide CSS
+ * already styles them — no additional CSS is required.
+ *
+ * After the April-2026 reorder the rendered Markdown emits Artifact
+ * templates as the first sub-heading and Methodologies as the second,
+ * matching how readers encounter the run (artifacts first, methodology
+ * library second). The card upgrade follows the same order so the H3
+ * positions stay aligned with the kind-aware CTA labels.
+ *
+ * Falls back to the original Markdown-rendered list when the expected
+ * structure (H2 → intro paragraph → Artifact-templates sub-heading →
+ * `<ul>` → Methodologies sub-heading → `<ul>`) is missing, so partially
+ * stripped or unusual articles are not silently corrupted.
+ *
+ * @param bodyHtml - The (already-localised) article body HTML
+ * @param lang - Target language code for curated titles/descriptions
+ * @returns Body HTML with the tradecraft section upgraded to cards
+ */
+export declare function enhanceTradecraftCards(bodyHtml: string, lang: LanguageCode): string;
+/**
+ * Replace the Analysis Index `<table>` with a `pi-card-grid` of cards,
+ * one per included artifact. Each card renders the artifact's curated
+ * localised title + description, the section it contributed to, the
+ * run-relative path as inline `<code>`, and a "View on GitHub" CTA.
+ *
+ * Strategy: parse the rendered table's `<tbody>` rows (each row carries
+ * `[sectionId, <a href="…">stem</a>, runRelPath]`) and re-render the
+ * region between the table's opening wrapper and `</table>` as a card
+ * grid. The wrapping `<div class="table-scroll">` is dropped because
+ * the card grid handles its own responsive layout via flex/grid.
+ *
+ * @param bodyHtml - Article body HTML
+ * @param lang - Target language code
+ * @returns Body HTML with the Analysis Index upgraded to a card grid
+ */
+export declare function enhanceAnalysisIndexCards(bodyHtml: string, lang: LanguageCode): string;
 /**
  * Render the full article HTML document with the shared chrome.
  *