euparliamentmonitor 0.8.49 → 0.8.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.49",
+  "version": "0.8.51",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -33,14 +33,6 @@
     "./generators/*": {
       "import": "./scripts/generators/*.js",
       "types": "./scripts/generators/*.d.ts"
-    },
-    "./generators/pipeline/*": {
-      "import": "./scripts/generators/pipeline/*.js",
-      "types": "./scripts/generators/pipeline/*.d.ts"
-    },
-    "./generators/strategies/*": {
-      "import": "./scripts/generators/strategies/*.js",
-      "types": "./scripts/generators/strategies/*.d.ts"
     }
   },
   "files": [
@@ -84,6 +76,9 @@
     "test:e2e:report": "playwright show-report",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
+    "knip": "knip",
+    "knip:production": "knip --production",
+    "knip:fix": "knip --fix",
     "lint:report": "eslint src/ --format json --output-file builds/test-results/eslint-report.json",
     "lint:report:html": "eslint src/ --format html --output-file builds/test-results/eslint-report.html",
     "format": "prettier --write \"src/**/*.ts\"",
@@ -158,6 +153,7 @@
     "htmlhint": "1.9.2",
     "husky": "9.1.7",
     "jscpd": "4.0.9",
+    "knip": "^6.7.0",
     "lint-staged": "16.4.0",
     "mermaid": "11.14.0",
     "papaparse": "5.5.3",

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

@@ -1,27 +1,5 @@
 import { type ArtifactSection } from './artifact-order.js';
-import { type Manifest, type ManifestFiles as _ManifestFiles, type ManifestHistoryEntry as _ManifestHistoryEntry } from './manifest/index.js';
-/**
- * Raw manifest shape as committed by the analysis pipeline.
- *
- * @deprecated Use {@link Manifest} from `aggregator/manifest/index.js`.
- *   This alias is preserved for back-compat with the existing test suite
- *   and external curators that import `AnalysisManifest` from this module.
- */
-export type AnalysisManifest = Manifest;
-/**
- * `manifest.files` can be nested category → paths or flat path → description.
- *
- * @deprecated Use {@link _ManifestFiles} (`ManifestFiles`) from
- *   `aggregator/manifest/index.js`.
- */
-export type ManifestFiles = _ManifestFiles;
-/**
- * One entry in `manifest.history[]`; only fields we read are typed.
- *
- * @deprecated Use {@link _ManifestHistoryEntry} (`ManifestHistoryEntry`) from
- *   `aggregator/manifest/index.js`.
- */
-export type ManifestHistoryEntry = _ManifestHistoryEntry;
+import { type Manifest, type ManifestFiles } from './manifest/index.js';
 /** Result of {@link aggregateAnalysisRun}. */
 export interface AggregatedRun {
     /** Final Markdown document (provenance + sections + appendices). */
@@ -100,7 +78,7 @@ export declare function flattenManifestFiles(files: ManifestFiles | undefined):
  * @param manifest - Parsed manifest object
  * @returns The latest non-PENDING gate result, or `"PENDING"` when none found
  */
-export declare function latestGateResult(manifest: AnalysisManifest): string;
+export declare function latestGateResult(manifest: Manifest): string;
 /**
  * Expand an `artifacts` entry from {@link ArtifactSection} into a list of
  * concrete artifact paths. Exact paths are kept as-is; directory prefixes
@@ -174,7 +152,7 @@ export declare function renderAnalysisIndex(included: readonly IncludedArtifact[
  */
 export declare function renderReaderIntelligenceGuide(sections: readonly TocSection[], included: readonly IncludedArtifact[]): string;
 /**
- * Resolve the article-type slug from a manifest, tolerating legacy schemas.
+ * Resolve the article-type slug from a manifest, tolerating historic schemas.
  *
  * Thin re-export of {@link _resolveArticleType} from
  * `aggregator/manifest/index.js`. Resolution order: `articleType` →
@@ -183,7 +161,7 @@ export declare function renderReaderIntelligenceGuide(sections: readonly TocSect
  * @param manifest - Parsed manifest (any of the supported schemas)
  * @returns Article-type slug usable as a filename component
  */
-export declare function resolveArticleTypeFromManifest(manifest: AnalysisManifest): string;
+export declare function resolveArticleTypeFromManifest(manifest: Manifest): string;
 /**
  * Read, clean, and concatenate every artifact declared by the run's manifest
  * (with discovery fallback when manifest.files is missing), returning a

package/scripts/aggregator/analysis-aggregator.js

@@ -141,7 +141,7 @@ function collectRunArtifacts(runDir) {
             const full = path.join(dir, entry.name);
             const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
             if (entry.isDirectory()) {
-                // Skip raw payloads, legacy run snapshots, and Pass-1 work-in-progress
+                // Skip raw payloads, prior-run snapshots, and Pass-1 work-in-progress
                 // snapshots so they are not rendered as supplementary artifacts.
                 if (entry.name === 'data' || entry.name === 'runs' || entry.name === 'pass1')
                     continue;
@@ -448,7 +448,7 @@ function appendSection(runDir, runDirRelPath, sectionId, sectionTitle, paths, se
     sectionMarkdown.push('');
 }
 /**
- * Resolve the article-type slug from a manifest, tolerating legacy schemas.
+ * Resolve the article-type slug from a manifest, tolerating historic schemas.
  *
  * Thin re-export of {@link _resolveArticleType} from
  * `aggregator/manifest/index.js`. Resolution order: `articleType` →

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

@@ -102,11 +102,11 @@ export declare function extractDefaultDescription(markdown: string): string;
  * @returns Summary of the generated artefacts ({@link GenerateResult})
  */
 export declare function generateArticle(opts: CliOptions, runSuffix?: string, articleCountOverride?: number): GenerateResult;
-/** Candidate run discovered under `analysis/daily/`. */
 /**
  * One run discovered by {@link discoverAnalysisRuns}.
  *
- * @deprecated Re-exported from `aggregator/runs/index.js` for back-compat.
+ * Thin re-export of {@link _DiscoveredRun} from `aggregator/runs/index.js`,
+ * preserved here as the public type for `article-generator` consumers.
  */
 export type DiscoveredRun = _DiscoveredRun;
 /**

package/scripts/aggregator/article-generator.js

@@ -261,7 +261,7 @@ const FALLBACK_DESCRIPTION = 'EU Parliament intelligence summary derived from co
  */
 export function extractDefaultDescription(markdown) {
     // Suppress unused warning: keep `shouldSkipDescriptionLine` for any
-    // legacy consumer importing it transitively.
+    // historic consumer importing it transitively.
     void shouldSkipDescriptionLine;
     const strong = extractStrongProseLine(markdown);
     return strong.length > 0 ? strong : FALLBACK_DESCRIPTION;

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

@@ -8,9 +8,9 @@ export interface ResolvedMetadataEntry {
 export type ResolvedMetadata = LanguageMap<ResolvedMetadataEntry>;
 /**
  * Raw manifest subset consumed by the resolver. Deliberately narrower
- * than the full {@link AnalysisManifest} shape so the resolver stays
- * usable for backport (which only has the manifest in text form) and for
- * callers that don't need the full typed structure.
+ * than the full {@link import('./manifest/types.js').Manifest} shape so
+ * the resolver stays usable for backport (which only has the manifest in
+ * text form) and for callers that don't need the full typed structure.
  */
 export interface MetadataManifest {
     readonly articleType?: string;
@@ -40,7 +40,7 @@ export interface ResolveMetadataOptions {
     readonly date: string;
     /** Aggregated Markdown document body (after provenance/header). */
     readonly markdown: string;
-    /** Parsed analysis manifest (may be empty for legacy/backport callers). */
+    /** Parsed analysis manifest (may be empty for historic/backport callers). */
     readonly manifest?: MetadataManifest;
     /**
      * Absolute path to the analysis run directory so the resolver can

package/scripts/aggregator/article-metadata.js

@@ -24,7 +24,7 @@
  * 3. **Aggregated-markdown H1** — the first `# …` heading in the aggregator
  *    output, accepted under the same non-generic rule. In practice this
  *    tier rarely fires because the aggregator itself writes the generic
- *    default, but it covers hand-edited or legacy aggregates.
+ *    default, but it covers hand-edited or historic aggregates.
  * 4. **First strong prose paragraph** — the first line of the aggregated
  *    Markdown that survives {@link shouldSkipDescriptionLine}. Used for
  *    `description`; also used for `title` as a last editorial-content
@@ -313,7 +313,7 @@ export function isGenericHeading(heading, articleType, date) {
         `${human} ${date}`,
     ];
     // Also accept the collision-suffix pattern (e.g. `Breaking Breaking — …`)
-    // and the auto-generated "EU Parliament <Type> — <date>" legacy form.
+    // and the auto-generated "EU Parliament <Type> — <date>" historic form.
     const humanRedundant = `${human} ${human}`;
     for (const p of patterns) {
         if (normalized === p)

package/scripts/aggregator/cli/parse.d.ts

@@ -39,7 +39,7 @@ export declare const HELP_TEXT: string;
  * - `{kind:'options', value}` — argv parsed cleanly; `value` is ready to
  *   pass to `generateArticle` / `generateAllArticles`.
  *
- * Compared to the legacy `parseCliArgs` in `article-generator.ts` (which
+ * Compared to the original `parseCliArgs` in `article-generator.ts` (which
  * throws and calls `process.exit` on `--help`), this entry point keeps
  * tests self-contained.
  *

package/scripts/aggregator/cli/parse.js

@@ -3,7 +3,7 @@
 /**
  * @module Aggregator/Cli/Parse
  * @description Pure CLI parser that returns a discriminated union instead
- * of calling `process.exit` mid-parse. The legacy `parseCliArgs` entry
+ * of calling `process.exit` mid-parse. The original `parseCliArgs` entry
  * point in `article-generator.ts` is preserved for backward compatibility
  * with existing callers and tests; new callers and unit tests should
  * prefer {@link parseCliArgsSafe} so the `--help` and error branches are
@@ -202,7 +202,7 @@ function processArgvToken(argv, index, acc) {
  * - `{kind:'options', value}` — argv parsed cleanly; `value` is ready to
  *   pass to `generateArticle` / `generateAllArticles`.
  *
- * Compared to the legacy `parseCliArgs` in `article-generator.ts` (which
+ * Compared to the original `parseCliArgs` in `article-generator.ts` (which
  * throws and calls `process.exit` on `--help`), this entry point keeps
  * tests self-contained.
  *

package/scripts/aggregator/infra/github-urls.d.ts

@@ -7,7 +7,7 @@
  * `githubRawUrl`) and `article-generator.ts` (which embedded the same slug
  * literally inside an `isBasedOn` template string).
  *
- * Every consumer should import from here; the legacy entry points in
+ * Every consumer should import from here; the original entry points in
  * `clean-artifact.ts` are preserved as thin re-export shims for back-compat.
  */
 /** Hack23 repo slug used when building blob/raw/tree URLs. */

package/scripts/aggregator/infra/github-urls.js

@@ -9,7 +9,7 @@
  * `githubRawUrl`) and `article-generator.ts` (which embedded the same slug
  * literally inside an `isBasedOn` template string).
  *
- * Every consumer should import from here; the legacy entry points in
+ * Every consumer should import from here; the original entry points in
  * `clean-artifact.ts` are preserved as thin re-export shims for back-compat.
  */
 /** Hack23 repo slug used when building blob/raw/tree URLs. */

package/scripts/aggregator/manifest/resolver.d.ts

@@ -10,12 +10,12 @@ import type { Manifest, ManifestFiles } from './types.js';
 /** Sentinel used when no schema variant supplies a usable article type. */
 export declare const UNKNOWN_ARTICLE_TYPE = "unknown";
 /**
- * Resolve the article-type slug from a manifest, tolerating legacy schemas.
+ * Resolve the article-type slug from a manifest, tolerating historic schemas.
  *
  * Resolution order (highest precedence first):
  *   1. `articleType` — canonical singular field
  *   2. `articleTypes[0]` — pre-aggregator-pipeline plural array
- *   3. `runType` — legacy field on older breaking-run manifests
+ *   3. `runType` — historic field on older breaking-run manifests
  *
  * Falls back to `'unknown'` when none of the above is a non-empty string.
  *

package/scripts/aggregator/manifest/resolver.js

@@ -3,12 +3,12 @@
 /** Sentinel used when no schema variant supplies a usable article type. */
 export const UNKNOWN_ARTICLE_TYPE = 'unknown';
 /**
- * Resolve the article-type slug from a manifest, tolerating legacy schemas.
+ * Resolve the article-type slug from a manifest, tolerating historic schemas.
  *
  * Resolution order (highest precedence first):
  *   1. `articleType` — canonical singular field
  *   2. `articleTypes[0]` — pre-aggregator-pipeline plural array
- *   3. `runType` — legacy field on older breaking-run manifests
+ *   3. `runType` — historic field on older breaking-run manifests
  *
  * Falls back to `'unknown'` when none of the above is a non-empty string.
  *

package/scripts/aggregator/manifest/types.d.ts

@@ -2,8 +2,8 @@
  * @module Aggregator/Manifest/Types
  * @description Canonical manifest schema for analysis runs and the narrower
  * projection consumed by the editorial-metadata resolver. Centralises every
- * historic schema variant (canonical `articleType`, legacy plural
- * `articleTypes[]`, very-legacy `runType`) into one type that downstream
+ * historic schema variant (canonical `articleType`, plural
+ * `articleTypes[]`, original `runType`) into one type that downstream
  * modules can read against.
  */
 import type { LanguageCode } from '../../types/index.js';
@@ -28,20 +28,22 @@ export type ManifestMetadataOverride = string | Partial<Record<LanguageCode, str
 /**
  * Raw manifest shape as committed by the analysis pipeline. Matches every
  * schema variant the pipeline has ever emitted; readers consult
- * {@link resolveArticleType} rather than `articleType` directly so legacy
+ * {@link resolveArticleType} rather than `articleType` directly so historic
  * runs stay readable.
  */
 export interface Manifest {
     /** Canonical singular form (current pipeline). */
     readonly articleType?: string;
     /**
-     * Legacy plural form emitted by some pre-aggregator-pipeline workflows.
-     * When present, `articleTypes[0]` is treated as the article type.
+     * Plural form emitted by some pre-aggregator-pipeline workflows (historic
+     * schema variant). When present, `articleTypes[0]` is treated as the
+     * article type.
      */
     readonly articleTypes?: readonly string[];
     /**
-     * Very-legacy field on older breaking-run manifests. Used as the last
-     * fallback when neither `articleType` nor `articleTypes` is present.
+     * Original field on older breaking-run manifests (historic schema variant).
+     * Used as the last fallback when neither `articleType` nor `articleTypes`
+     * is present.
      */
     readonly runType?: string;
     /** Stable run identifier; falls back to the run-dir basename. */
@@ -65,7 +67,7 @@ export interface Manifest {
  * Narrower manifest projection consumed by {@link resolveArticleMetadata}
  * in `aggregator/article-metadata.ts`. The metadata resolver only needs a
  * subset; keeping this projection separate means string-only callers
- * (backport, legacy curators) don't have to construct a full {@link Manifest}.
+ * (backport, historic curators) don't have to construct a full {@link Manifest}.
  */
 export interface MetadataManifest {
     readonly articleType?: string;

package/scripts/aggregator/runs/discover.d.ts

@@ -34,7 +34,7 @@ export declare function readRunCandidate(runDir: string): DiscoveredRun | null;
  * The walk stops descending into a directory the moment it sees a
  * `manifest.json`, so nested artifact subdirectories never get reported
  * as separate runs. Results are sorted by date ascending then by path
- * lexically — the same order used by the legacy implementation in
+ * lexically — the same order used by the previous in-line implementation in
  * `article-generator.ts`.
  *
  * @param repoRoot - Absolute repository root

package/scripts/aggregator/runs/discover.js

@@ -52,7 +52,7 @@ export function readRunCandidate(runDir) {
  * The walk stops descending into a directory the moment it sees a
  * `manifest.json`, so nested artifact subdirectories never get reported
  * as separate runs. Results are sorted by date ascending then by path
- * lexically — the same order used by the legacy implementation in
+ * lexically — the same order used by the previous in-line implementation in
  * `article-generator.ts`.
  *
  * @param repoRoot - Absolute repository root

package/scripts/backport-article-seo.js

@@ -388,7 +388,7 @@ function extractBodyFirstProse(articleHtml) {
  * 1. If a manifest.json for the run exists (aggregator cohort), use the
  *    full {@link resolveArticleMetadata} pipeline — this picks up manifest
  *    overrides and artefact H1s.
- * 2. Otherwise (legacy cohort), derive from the rendered body:
+ * 2. Otherwise (historic cohort), derive from the rendered body:
  *    - Title = non-generic `<h1>` from the body, else first sentence of
  *      the first strong prose paragraph.
  *    - Description = first strong prose paragraph (full, not the same
@@ -412,7 +412,7 @@ function deriveMetadataForFile(file, html) {
   // fallback for `committee-reports` renders realistic abbreviations
   // (`ENVI, ECON, AFET, LIBE, AGRI`) instead of the placeholder
   // `Main Committees`. This keeps the localized template consistent
-  // with the legacy format even when the manifest is missing.
+  // with the historic format even when the manifest is missing.
   const committee = extractCommitteeCodes(bodyH1) || extractCommitteeCodes(bodyProse);
 
   const resolved = resolveArticleMetadata({
@@ -425,7 +425,7 @@ function deriveMetadataForFile(file, html) {
 
   if (file.lang !== 'en') {
     // NON-ENGLISH files: The article body may be in a different language
-    // than the file claims to be — legacy files have localized H1/chrome
+    // than the file claims to be — historic files have localized H1/chrome
     // but English body prose; aggregator PR#1404 files have English H1
     // AND English body in every language variant. We accept body content
     // only when it is plausibly in the file's language, and fall back to
@@ -658,9 +658,9 @@ function buildSyntheticMarkdown(h1, prose) {
 
 /**
  * Choose the final title text. Prefers a non-generic body H1. When the
- * H1 is generic (e.g. legacy "Legislative Procedures: European Parliament
+ * H1 is generic (e.g. historic "Legislative Procedures: European Parliament
  * Monitor"), falls back to the first sentence of body prose — this is
- * the single biggest SEO win for legacy files.
+ * the single biggest SEO win for historic files.
  *
  * @param {string} bodyH1 - First H1 from the body
  * @param {string} bodyProse - First strong prose paragraph
@@ -681,7 +681,7 @@ function chooseTitle(bodyH1, bodyProse, templateTitle, file) {
 
 /**
  * Extend {@link isGenericHeading} with a few extra patterns specific to
- * legacy-era titles (pre-aggregator pipeline) so those files get
+ * historic-era titles (pre-aggregator pipeline) so those files get
  * replaced during backport. Also catches the pure `<Title-Case-Phrase>
  * — <ISO-date>` form that the default aggregator title emits when the
  * articleType slug has a run suffix (e.g. `breaking-190`) that
@@ -695,7 +695,7 @@ function chooseTitle(bodyH1, bodyProse, templateTitle, file) {
 function isGenericBodyH1(h1, articleType, date) {
   if (isGenericHeading(h1, articleType, date)) return true;
   const normalized = h1.trim();
-  const legacyTemplates = [
+  const historicTemplates = [
     'Legislative Procedures: European Parliament Monitor',
     'EU Parliament Committee Activity Report',
     'EU Parliament Breaking',
@@ -703,7 +703,7 @@ function isGenericBodyH1(h1, articleType, date) {
     'Plenary Votes & Resolutions',
     'Plenary Votes and Resolutions',
   ];
-  for (const t of legacyTemplates) {
+  for (const t of historicTemplates) {
     if (normalized === t || normalized.startsWith(`${t} `) || normalized.startsWith(`${t}:`)) {
       return true;
     }
@@ -814,7 +814,7 @@ function rewriteHtml(html, metadata) {
 /**
  * Replace `<meta name="<name>" content="…">` in-place. When absent the
  * document is returned unchanged — we never inject new tags during
- * backport so legacy files retain their original meta-tag order.
+ * backport so historic files retain their original meta-tag order.
  *
  * The `content` match is quote-aware: the content of a double-quoted
  * attribute value may contain apostrophes (e.g. `Parliament's`), so the

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

@@ -27,7 +27,7 @@ export declare const AI_MARKER = "[AI_ANALYSIS_REQUIRED]";
  *
  * Recognises three marker formats:
  * - `[AI_ANALYSIS_REQUIRED]` — the current standard marker (v3.0+)
- * - `[REQUIRED]` — legacy marker used in template stubs before v3.0
+ * - `[REQUIRED]` — historic marker used in template stubs before v3.0
  * - `[?]` — shorthand used in some early methodology templates
  *
  * @param text - Text to test

package/scripts/constants/analysis-constants.js

@@ -29,7 +29,7 @@ export const AI_MARKER = '[AI_ANALYSIS_REQUIRED]';
  *
  * Recognises three marker formats:
  * - `[AI_ANALYSIS_REQUIRED]` — the current standard marker (v3.0+)
- * - `[REQUIRED]` — legacy marker used in template stubs before v3.0
+ * - `[REQUIRED]` — historic marker used in template stubs before v3.0
  * - `[?]` — shorthand used in some early methodology templates
  *
  * @param text - Text to test

package/scripts/generators/political-intelligence-descriptions.d.ts

@@ -25,8 +25,10 @@ import type { LanguageCode } from '../types/index.js';
 /** Per-language text overlay keyed by 2-letter language code. */
 export type TextI18n = Partial<Record<LanguageCode, string>>;
 /**
- * @deprecated use {@link TextI18n}. Kept as an alias so consumers outside
- * this module don't break across the title-localization refactor.
+ * Back-compat alias for {@link TextI18n}. Preserved so downstream
+ * TypeScript consumers that import this name from
+ * `euparliamentmonitor/generators/political-intelligence-descriptions`
+ * keep compiling. Prefer `TextI18n` for new code.
  */
 export type DescriptionI18n = TextI18n;
 /** One curated entry for a methodology / template / reference file. */
@@ -122,7 +124,7 @@ export declare function hasCuratedTitle(relPath: string): boolean;
  *    this is where all 14-language localization is maintained)
  * 2. Curated English title from {@link CURATED_TITLES} (`.en` overlay)
  * 3. Per-entry `titleI18n[lang]` on a `CURATED_DESCRIPTIONS` entry
- *    (legacy path; retained so future entries can colocate title + desc)
+ *    (historic path; retained so future entries can colocate title + desc)
  * 4. Per-entry `title` on a `CURATED_DESCRIPTIONS` entry
  * 5. `fallback` — the H1-extracted title from the source Markdown
  *

package/scripts/generators/political-intelligence-descriptions.js

@@ -2047,7 +2047,7 @@ export function hasCuratedTitle(relPath) {
  *    this is where all 14-language localization is maintained)
  * 2. Curated English title from {@link CURATED_TITLES} (`.en` overlay)
  * 3. Per-entry `titleI18n[lang]` on a `CURATED_DESCRIPTIONS` entry
- *    (legacy path; retained so future entries can colocate title + desc)
+ *    (historic path; retained so future entries can colocate title + desc)
  * 4. Per-entry `title` on a `CURATED_DESCRIPTIONS` entry
  * 5. `fallback` — the H1-extracted title from the source Markdown
  *
@@ -2073,7 +2073,7 @@ export function getCuratedTitle(relPath, lang, fallback) {
         if (titleEntry.en)
             return titleEntry.en;
     }
-    // 3 + 4: legacy colocated title on CURATED_DESCRIPTIONS entry
+    // 3 + 4: historic colocated title on CURATED_DESCRIPTIONS entry
     // eslint-disable-next-line security/detect-object-injection
     const descEntry = CURATED_DESCRIPTIONS[key];
     if (descEntry) {

package/scripts/generators/sitemap/html.js

@@ -13,7 +13,7 @@
  * future renderer (Atom-feed metadata, OG-card builder, etc.) without
  * having to import `sitemap.ts` and pull in the entire CLI surface.
  *
- * Output is byte-identical to the legacy in-line implementation that
+ * Output is byte-identical to the previous in-line implementation that
  * lived in `sitemap.ts` between Apr-2026 and the bounded-context
  * refactor — verified by the regression test in
  * `test/unit/sitemap-byte-equality.test.js` (compares against the

package/scripts/generators/sitemap/rss.js

@@ -37,6 +37,7 @@ export function generateRssFeed(articleInfos, buildDate = new Date().toUTCString
       <dc:language>${escapeXML(item.lang)}</dc:language>
     </item>`)
         .join('\n');
+    // REUSE-IgnoreStart
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!-- SPDX-FileCopyrightText: 2024-2026 Hack23 AB -->
 <!-- SPDX-License-Identifier: Apache-2.0 -->
@@ -51,5 +52,6 @@ export function generateRssFeed(articleInfos, buildDate = new Date().toUTCString
 ${items}
   </channel>
 </rss>`;
+    // REUSE-IgnoreEnd
 }
 //# sourceMappingURL=rss.js.map

package/scripts/generators/sitemap/xml.js

@@ -14,7 +14,7 @@
  * pure (no HTML chrome dependencies), and so future XML output formats
  * (news-sitemap, video-sitemap) can reuse the same URL builders.
  *
- * Output is byte-identical to the legacy in-line implementation that
+ * Output is byte-identical to the previous in-line implementation that
  * lived in `sitemap.ts`, verified by the byte-equality regression test.
  */
 import fs from 'fs';
@@ -86,12 +86,14 @@ export function generateSitemap(articles, docsFiles = []) {
         ...buildArticleUrls(articles),
         ...buildDocsUrls(docsFiles, today),
     ];
+    // REUSE-IgnoreStart
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!-- SPDX-FileCopyrightText: 2024-2026 Hack23 AB -->
 <!-- SPDX-License-Identifier: Apache-2.0 -->
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">
 ${urls.map(renderSitemapUrl).join('\n')}
 </urlset>`;
+    // REUSE-IgnoreEnd
 }
 /**
  * Build the absolute URL for a language-specific index page.

package/scripts/lint-prompts.js

@@ -96,6 +96,25 @@ const FORBIDDEN_PHRASES = [
   /\bnews-<type>-analysis\.md\b/i,
   /\bnews-<type>-article\.md\b/i,
   /\bgenerate-news\b(?!-indexes\b)/i,
+  // IMF-primary editorial policy: IMF is the SOLE authoritative source
+  // for every economic / fiscal / monetary / trade / FDI / exchange-rate /
+  // banking-soundness claim. World Bank is for non-economic domains.
+  // Workflow prompts must use IMF for economic context. We catch the
+  // forbidden listings:
+  //
+  //   - "World Bank **or** IMF"  (bold or plain)
+  //   - "IMF **or** World Bank"  (bold or plain)
+  //   - "WB or IMF" / "IMF or WB"
+  //   - "WB/IMF" / "IMF/WB" inside an economic context phrase
+  //
+  // See .github/skills/imf-data-integration.md and
+  // analysis/methodologies/imf-indicator-mapping.md §8.
+  /\bWorld\s+Bank\s+(?:\*\*)?or(?:\*\*)?\s+IMF\b/i,
+  /\bIMF\s+(?:\*\*)?or(?:\*\*)?\s+World\s+Bank\b/i,
+  /\bWB\s+or\s+IMF\b/i,
+  /\bIMF\s+or\s+WB\b/i,
+  /economic\s+context[^.\n]{0,40}\bWB\s*\/\s*IMF\b/i,
+  /economic\s+context[^.\n]{0,40}\bIMF\s*\/\s*WB\b/i,
   // Note: the AI_MARKER / [AI_ANALYSIS_REQUIRED] / FALLBACK_TEMPLATE_PATTERNS
   // string tokens are NOT banned — workflow prompts legitimately instruct the
   // agent "no [AI_ANALYSIS_REQUIRED] markers may remain in committed

package/scripts/mcp/ep-mcp-client.d.ts

@@ -27,7 +27,7 @@ export declare const EP_MCP_TOOLS: readonly string[];
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
  *    Hack23/European-Parliament-MCP-Server#380 (which closed #378).
- * 2. **Legacy raw upstream 404 shape** (historically emitted pre-v1.2.13 by
+ * 2. **Pre-v1.2.13 raw upstream 404 shape** (historically emitted pre-v1.2.13 by
  *    `get_events_feed` / `get_procedures_feed`, fixed upstream in PR #380) —
  *    `{"@id":"https://data.europarl.europa.eu/eli/dl/...","error":"404 N..."}`.
  *    Retained purely as defense-in-depth for older pinned server versions or

package/scripts/mcp/ep-mcp-client.js

@@ -194,7 +194,7 @@ function _parseResultPayload(result) {
  *    Hack23/European-Parliament-MCP-Server#301 and extended to
  *    `get_events_feed`/`get_procedures_feed` by
  *    Hack23/European-Parliament-MCP-Server#380 (which closed #378).
- * 2. **Legacy raw upstream 404 shape** (historically emitted pre-v1.2.13 by
+ * 2. **Pre-v1.2.13 raw upstream 404 shape** (historically emitted pre-v1.2.13 by
  *    `get_events_feed` / `get_procedures_feed`, fixed upstream in PR #380) —
  *    `{"@id":"https://data.europarl.europa.eu/eli/dl/...","error":"404 N..."}`.
  *    Retained purely as defense-in-depth for older pinned server versions or
@@ -214,7 +214,7 @@ export function isFeedUnavailable(result) {
     // Shape 1 — uniform {status:"unavailable"} envelope (#301 / #380).
     if (envelope['status'] === 'unavailable')
         return true;
-    // Shape 2 — legacy raw upstream 404 leak (historically pre-v1.2.13, #378).
+    // Shape 2 — pre-v1.2.13 raw upstream 404 leak (historically pre-v1.2.13, #378).
     const error = envelope['error'];
     const idField = envelope['@id'];
     if (typeof error === 'string' &&
@@ -404,7 +404,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
                 return this._recordToolFailure(toolName, result.content?.[0]?.text ?? '', fallbackText);
             }
             // Detect the unavailable-feed envelope — uniform `{status:"unavailable"}`
-            // (all feeds as of v1.2.13, #301/#380) as well as the legacy raw upstream
+            // (all feeds as of v1.2.13, #301/#380) as well as the pre-v1.2.13 raw upstream
             // 404 shape `{"@id":..., "error":"404 ..."}` that pre-v1.2.13
             // get_events_feed / get_procedures_feed emitted
             // (Hack23/European-Parliament-MCP-Server#378, closed by PR #380). The
@@ -1269,7 +1269,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
                 this._slowFeedWarnings.delete('get_events_feed');
                 return this._recordToolFailure('get_events_feed', result.content?.[0]?.text ?? '', EuropeanParliamentMCPClient.FEED_FALLBACK);
             }
-            // Detect unavailable-feed envelope (uniform {status:"unavailable"} or legacy 404)
+            // Detect unavailable-feed envelope (uniform {status:"unavailable"} or pre-v1.2.13 404)
             if (isFeedUnavailable(result)) {
                 this._slowFeedWarnings.delete('get_events_feed');
                 return this._recordToolFailure('get_events_feed', `UPSTREAM_404: ${result.content?.[0]?.text?.slice(0, 200) ?? 'feed unavailable'}`, EuropeanParliamentMCPClient.FEED_FALLBACK);

package/scripts/mcp/imf-mcp-client.d.ts

@@ -44,7 +44,7 @@
  *   `https://dataservices.imf.org/REST/SDMX_3.0`).
  * - `IMF_API_TIMEOUT_MS` — per-request timeout (default `30000`).
  *
- * Legacy env vars (`IMF_MCP_GATEWAY_URL`, `IMF_MCP_GATEWAY_API_KEY`,
+ * Historic env vars (`IMF_MCP_GATEWAY_URL`, `IMF_MCP_GATEWAY_API_KEY`,
  * `IMF_MCP_SERVER_PATH`) are no longer consulted — no gateway is needed
  * because the IMF SDMX 3.0 API is an unauthenticated public endpoint.
  */

package/scripts/mcp/mcp-connection.js

@@ -114,7 +114,7 @@ export function isRetriableError(error) {
     const msg = error.message?.toLowerCase() ?? '';
     // Never retry rate-limit errors — callers must honour the Retry-After delay.
     // `instanceof MCPRateLimitError` is the primary guard for typed errors;
-    // the string prefix fallback handles any legacy plain Error with a rate-limit message.
+    // the string prefix fallback handles any untyped plain Error with a rate-limit message.
     if (error instanceof MCPRateLimitError || msg.startsWith(RATE_LIMIT_MSG.toLowerCase())) {
         return false;
     }

package/scripts/types/imf.d.ts

@@ -46,7 +46,7 @@ import type { MCPClientOptions } from './mcp.js';
  * - `timeoutMs` — per-request timeout in milliseconds.
  * - `fetchImpl` — optional `fetch` injection for tests.
  *
- * The inherited legacy MCP transport fields (`serverPath`, `gatewayUrl`,
+ * The inherited historic MCP transport fields (`serverPath`, `gatewayUrl`,
  * `gatewayApiKey`, `maxConnectionAttempts`, `connectionRetryDelay`) are
  * accepted for backwards compatibility but **ignored** by the native
  * client — they date from the earlier `c-cf/imf-data-mcp` proxy

package/scripts/types/parliament.d.ts

@@ -346,7 +346,7 @@ export interface CorporateBodyFeedItem {
     identifier?: string | undefined;
     label?: string | undefined;
 }
-/** Aggregated feed data for breaking news articles (legacy compat) */
+/** Aggregated feed data for breaking news articles (back-compat shape) */
 export interface BreakingNewsFeedData {
     adoptedTexts: readonly AdoptedTextFeedItem[];
     events: readonly EventFeedItem[];

package/scripts/types/world-bank.d.ts

@@ -129,7 +129,7 @@ export interface PolicyRelevantIndicators {
  *
  * **Note:** The codebase also has a `WorldBankMCPClient.getIndicatorForCountry()`
  * wrapper (in `src/mcp/wb-mcp-client.ts`) that calls the `get_indicator_for_country`
- * tool — this is a legacy convenience method not listed in this type union since it
+ * tool — this is a back-compat convenience method not listed in this type union since it
  * is not part of the standard worldbank-mcp tool surface.
  */
 export type WBMCPToolName = 'get-economic-data' | 'get-social-data' | 'get-health-data' | 'get-education-data' | 'get-country-info' | 'get-countries' | 'search-indicators';

package/scripts/utils/file-utils.d.ts

@@ -198,7 +198,7 @@ export declare function checkArticleExists(slug: string, lang: string, newsDir?:
  *
  * Title resolution order:
  *   1. `<head><title>` value with the trailing ` — EU Parliament Monitor`
- *      (or legacy ` | EU Parliament Monitor`) site-suffix stripped.
+ *      (or historic ` | EU Parliament Monitor`) site-suffix stripped.
  *      This is where the editorial-highlights resolver + SEO backport
  *      script write their output, so using it as the primary source
  *      surfaces the strongest headline on index cards and sitemaps.
@@ -243,7 +243,7 @@ export interface ArticleValidationResult {
  * Validate that generated article HTML includes all required structural elements.
  *
  * This is the primary validation gate — articles must be generated correctly
- * by the template. The fix-articles script is only a fallback for legacy articles.
+ * by the template. The fix-articles script is only a fallback for historic articles.
  *
  * @param html - Complete HTML string of the article
  * @returns Validation result with errors list (empty if valid)

package/scripts/utils/file-utils.js

@@ -508,7 +508,7 @@ function decodeHtmlEntities(str) {
  *
  * Title resolution order:
  *   1. `<head><title>` value with the trailing ` — EU Parliament Monitor`
- *      (or legacy ` | EU Parliament Monitor`) site-suffix stripped.
+ *      (or historic ` | EU Parliament Monitor`) site-suffix stripped.
  *      This is where the editorial-highlights resolver + SEO backport
  *      script write their output, so using it as the primary source
  *      surfaces the strongest headline on index cards and sitemaps.
@@ -609,7 +609,7 @@ const REQUIRED_ARTICLE_ELEMENTS = [
  * Validate that generated article HTML includes all required structural elements.
  *
  * This is the primary validation gate — articles must be generated correctly
- * by the template. The fix-articles script is only a fallback for legacy articles.
+ * by the template. The fix-articles script is only a fallback for historic articles.
  *
  * @param html - Complete HTML string of the article
  * @returns Validation result with errors list (empty if valid)

package/scripts/validate-analysis-completeness.js

@@ -96,6 +96,35 @@ const IMF_SOURCE_FIELD_RE =
 const IMF_FIGURE_CLAIM_RE =
   /\bIMF\b[\s\S]{0,160}\b\d+(?:\.\d+)?\s*(?:%|pp|percentage points|GDP|EUR|USD|billion|trillion|million)/i;
 
+// IMF-primary editorial policy: IMF is the sole authoritative source for
+// economic / fiscal / monetary / trade / FDI / exchange-rate /
+// banking-soundness claims inside economic-context.md. World Bank is
+// used for non-economic domains. Two complementary detectors:
+//
+//   1. WB economic indicator codes — surface the offending SDMX-style
+//      identifier when an economic-context artifact still cites raw WB
+//      economic series (NY.GDP.*, FP.CPI.*, SL.UEM.*, GC.DOD.*, NE.EXP.*,
+//      NE.TRD.*, BX.KLT.*, NY.GNP.*, GC.TAX.*, NE.CON.GOVT.*).
+//   2. WB economic prose claim — match "World Bank" within 120 chars of an
+//      economic noun (GDP, inflation, unemployment, fiscal balance, debt,
+//      trade, FDI, exchange rate). The window is intentionally narrow so
+//      a sentence like "World Bank WGI governance index" (legitimate
+//      non-economic domain) does not trigger.
+//
+// Both detectors deliberately exclude the narrative "Retired from WB
+// (now IMF-primary…)" and "legacy WB economic codes (… retained for
+// backward compatibility but MUST NOT…)" wording that appears in the
+// methodology files themselves — those files are not validated as run
+// artifacts. The detectors only run against `intelligence/economic-
+// context.md` and only when the artifact is also flagged as making
+// numeric IMF claims (i.e. the artifact actually carries economic
+// content), see callers in `evaluateArtifact`.
+const WB_ECONOMIC_INDICATOR_CODE_RE =
+  /\b(NY\.GDP\.[A-Z0-9.]+|NY\.GNP\.[A-Z0-9.]+|FP\.CPI\.[A-Z0-9.]+|SL\.UEM\.[A-Z0-9.]+|GC\.DOD\.[A-Z0-9.]+|GC\.TAX\.[A-Z0-9.]+|NE\.EXP\.[A-Z0-9.]+|NE\.IMP\.[A-Z0-9.]+|NE\.TRD\.[A-Z0-9.]+|NE\.CON\.GOVT\.[A-Z0-9.]+|BX\.KLT\.[A-Z0-9.]+|BN\.KLT\.[A-Z0-9.]+|FR\.INR\.[A-Z0-9.]+)\b/;
+
+const WB_ECONOMIC_CLAIM_RE =
+  /\bWorld\s+Bank\b[\s\S]{0,120}\b(?:GDP(?:\s+growth|\s+per\s+capita)?|inflation|CPI|unemployment(?:\s+rate)?|fiscal\s+balance|primary\s+balance|government\s+debt|public\s+debt|current\s+account|trade(?:\s+balance)?|FDI|foreign\s+direct\s+investment|exchange\s+rate|REER|policy\s+rate|reserve\s+assets|capital\s+adequacy|NPL\s+ratio)\b/i;
+
 // Bypass placeholder scan only on template-instruction blocks themselves —
 // NOT on every artifact that happens to link to a methodology document.
 // Matching `methodology` here would suppress placeholder detection for any
@@ -285,6 +314,48 @@ function claimsImfFigures(content) {
   return IMF_FIGURE_CLAIM_RE.test(content);
 }
 
+/**
+ * IMF-primary editorial policy.
+ *
+ * Detect WB economic-policy violations inside `intelligence/economic-
+ * context.md`:
+ *
+ *   - Any WB economic indicator code (NY.GDP.*, FP.CPI.*, SL.UEM.*,
+ *     GC.DOD.*, NE.EXP.*, NE.TRD.*, BX.KLT.*, NY.GNP.*, GC.TAX.*,
+ *     NE.CON.GOVT.*, FR.INR.*) — these belong in IMF SDMX form (NGDP,
+ *     PCPIPCH, LUR, GGXWDG_NGDP, BCA_NGDPD, …).
+ *   - Any "World Bank … <economic noun>" prose claim within 120 chars
+ *     (GDP, inflation, unemployment, fiscal balance, debt, trade, FDI,
+ *     exchange rate, policy rate, banking soundness).
+ *
+ * The detector deliberately runs only on `intelligence/economic-
+ * context.md`. Other artifacts may legitimately reference WB for non-
+ * economic context (governance WGI, demographics, social, environment,
+ * defence-spending, agriculture, innovation, education, health) and
+ * the WB methodology files themselves describe legacy codes for
+ * backward-compatibility — neither path is validated here.
+ *
+ * Returns `{ codes, prose }` arrays of offending excerpts. Empty arrays
+ * mean clean.
+ */
+function detectWorldBankEconomicViolations(content) {
+  // Use matchAll() so callers get every offending excerpt, not just the
+  // first hit — an artifact that cites several WB economic series
+  // ("NY.GDP.MKTP.KD.ZG and FP.CPI.TOTL.ZG and SL.UEM.TOTL.ZS") must
+  // surface all three to the editor in a single Stage-C pass.
+  const codes = [];
+  const codeRe = new RegExp(WB_ECONOMIC_INDICATOR_CODE_RE.source, 'gi');
+  for (const m of content.matchAll(codeRe)) {
+    codes.push(m[1]);
+  }
+  const prose = [];
+  const proseRe = new RegExp(WB_ECONOMIC_CLAIM_RE.source, 'gi');
+  for (const m of content.matchAll(proseRe)) {
+    prose.push(m[0].replace(/\s+/g, ' ').trim().slice(0, 100));
+  }
+  return { codes, prose };
+}
+
 // Stage C IMF evidence gate. The probe always writes a summary JSON even
 // when `available:false`, so a generic "any .json file" check is insufficient
 // — it would let a failed probe satisfy the gate. Require:
@@ -476,6 +547,24 @@ function validateArtifact({
       result.issues.push('imf-cache:missing');
     }
   }
+  // IMF-primary editorial policy: economic-context.md must not
+  // cite World Bank for economic claims regardless of whether IMF prose
+  // is also present. Run on every economic-context artifact (not gated
+  // on claimsImfFigures) so an article that drops IMF entirely and
+  // tries to satisfy economic context with WB alone is caught.
+  if (isEconomicContextArtifact(relativePath)) {
+    const { codes: wbCodes, prose: wbProse } =
+      detectWorldBankEconomicViolations(content);
+    // Surface every offending code (de-duplicated to keep the issue
+    // list concise when the same series is cited many times in one
+    // artifact). Stage-C editors get the full picture in one pass.
+    for (const code of [...new Set(wbCodes)]) {
+      result.issues.push(`economic-context:wb-economic-code:${code}`);
+    }
+    if (wbProse.length > 0) {
+      result.issues.push('economic-context:wb-economic-claim');
+    }
+  }
 
   return result;
 }

package/scripts/index.old.js

@@ -1,125 +0,0 @@
-// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
-// SPDX-License-Identifier: Apache-2.0
-/**
- * @module euparliamentmonitor
- * @description European Parliament Intelligence Platform — npm package entry point.
- *
- * This barrel re-exports the full library surface of the EU Parliament
- * Monitor so that other projects can consume types, MCP clients, analysis
- * utilities, templates, generators, strategies, and language constants
- * without duplicating code.
- *
- * @example
- * ```ts
- * import {
- *   EuropeanParliamentMCPClient,
- *   getEPMCPClient,
- *   ALL_LANGUAGES,
- *   scoreVotingAnomaly,
- *   generateArticleHTML,
- *   BreakingNewsStrategy,
- *   buildBreakingNewsContent,
- * } from 'euparliamentmonitor';
- * ```
- *
- * @see {@link https://github.com/Hack23/euparliamentmonitor | GitHub Repository}
- * @see {@link https://github.com/Hack23/ISMS-PUBLIC/blob/main/Secure_Development_Policy.md | Secure Development Policy}
- * @see {@link https://github.com/Hack23/euparliamentmonitor/blob/main/ARCHITECTURE.md | Architecture}
- * @see {@link https://github.com/Hack23/euparliamentmonitor/blob/main/SECURITY_ARCHITECTURE.md | Security Architecture}
- *
- * **Dead-code removal (v0.8.27+):** The following previously-exported symbols
- * were removed as unused dead code: `buildSankeySection`,
- * `sankey-content`, `buildMindmapSection`,
- * `buildMultiDimensionalSwotSection`, `build*MultiDimensionalSwot`
- * builders, `MULTI_DIMENSIONAL_SWOT_STRINGS`, and related visualization
- * types. Use `buildIntelligenceMindmapSection`, `buildSwotSection`, and
- * domain-specific builders instead.
- */
-// ─── Types ───────────────────────────────────────────────────────────────────
-export * from './types/index.js';
-// ─── MCP Clients ─────────────────────────────────────────────────────────────
-export { MCPConnection, MCPSessionExpiredError, MCPRateLimitError, isRetriableError, formatRetryAfter, parseSSEResponse, } from './mcp/mcp-connection.js';
-export { EuropeanParliamentMCPClient, getEPMCPClient, closeEPMCPClient, } from './mcp/ep-mcp-client.js';
-export { WorldBankMCPClient, getWBMCPClient, closeWBMCPClient } from './mcp/wb-mcp-client.js';
-export { IMFMCPClient, IMF_MCP_TOOLS, getIMFMCPClient, closeIMFMCPClient, } from './mcp/imf-mcp-client.js';
-export { CircuitBreaker, withRetry, } from './mcp/mcp-retry.js';
-export { MCPHealthMonitor } from './mcp/mcp-health.js';
-// ─── Intelligence Analysis ───────────────────────────────────────────────────
-export { scoreVotingAnomaly, analyzeCoalitionCohesion, scoreMEPInfluence, calculateLegislativeVelocity, rankBySignificance, buildIntelligenceSection, buildDefaultStakeholderPerspectives, scoreStakeholderInfluence, buildStakeholderOutcomeMatrix, rankStakeholdersByInfluence, computeVotingIntensity, detectCoalitionShifts, computePolarizationIndex, detectVotingTrends, computeCrossSessionCoalitionStability, rankMEPInfluenceByTopic, buildLegislativeVelocityReport, } from './utils/intelligence-analysis.js';
-// ─── Intelligence Index ──────────────────────────────────────────────────────
-export { createEmptyIndex, addArticleToIndex, buildIndexFromEntries, findRelatedArticles, generateCrossReferences, detectTrends, findOrCreateSeries, buildRelatedArticlesHTML, } from './utils/intelligence-index.js';
-// ─── Article Quality ─────────────────────────────────────────────────────────
-export { assessAnalysisDepth, assessStakeholderCoverage, assessVisualizationQuality, calculateOverallScore, generateRecommendations, scoreArticleQuality, } from './utils/article-quality-scorer.js';
-// ─── Significance Scoring ────────────────────────────────────────────────────
-export { scoreSignificance, scoreBatch, clampScore, deriveDecision, formatScoreMarkdown, formatBatchMarkdown, WEIGHT_PARLIAMENTARY, WEIGHT_POLICY, WEIGHT_PUBLIC_INTEREST, WEIGHT_URGENCY, WEIGHT_INSTITUTIONAL, THRESHOLD_PUBLISH, THRESHOLD_HOLD, } from './utils/significance-scoring.js';
-// ─── Synthesis Summary ───────────────────────────────────────────────────────
-export { parseFrontmatter, aggregateSWOT, aggregateRisks, extractSummaryLine, aggregateConfidence, findMarkdownFiles, generateEditorialRecommendations, buildSynthesisSummary, formatSynthesisMarkdown, } from './generators/synthesis-summary.js';
-// ─── Content Validation ──────────────────────────────────────────────────────
-export { validateArticleContent, validateTranslationCompleteness, } from './utils/content-validator.js';
-// ─── Economic-context evidence helpers (Wave 1 dual-source) ──────────────────
-export { WORLD_BANK_STRONG_FINGERPRINTS, WORLD_BANK_INDICATOR_CODES, WORLD_BANK_FINGERPRINTS, hasWorldBankEvidence, articlePolicyHasWorldBank, IMF_STRONG_FINGERPRINTS, IMF_INDICATOR_CODES, hasIMFEvidence, articlePolicyHasEconomicContext, } from './utils/content-validator.js';
-// ─── Content Metadata ────────────────────────────────────────────────────────
-export { enrichMetadataFromContent } from './utils/content-metadata.js';
-// ─── News Metadata ───────────────────────────────────────────────────────────
-export { buildMetadataDatabase, writeMetadataDatabase, readMetadataDatabase, updateMetadataDatabase, updateIntelligenceIndex, } from './utils/news-metadata.js';
-// ─── Metadata Utilities ──────────────────────────────────────────────────────
-export { pl, pl as pluralizeCount } from './utils/metadata-utils.js';
-// ─── Political Threat Assessment ─────────────────────────────────────────────
-export { assessPoliticalThreats, buildActorThreatProfiles, buildConsequenceTree, analyzeLegislativeDisruption, generateThreatAssessmentMarkdown, ALL_THREAT_LANDSCAPE_DIMENSIONS, } from './utils/political-threat-assessment.js';
-// ─── HTML Utilities ──────────────────────────────────────────────────────────
-export { stripHtmlTags, stripScriptBlocks } from './utils/html-sanitize.js';
-export { parseArticleFilename, formatSlug, calculateReadTime, escapeHTML, isSafeURL, validateArticleHTML, } from './utils/file-utils.js';
-// ─── Article Category Detection ──────────────────────────────────────────────
-export { detectCategory } from './utils/article-category.js';
-// ─── World Bank Data Utilities ───────────────────────────────────────────────
-export { EU_COUNTRY_CODES, EU_AGGREGATE_CODE, COMPARISON_COUNTRIES, WB_AGGREGATE_LABELS, POLICY_INDICATORS, parseWorldBankCSV, formatIndicatorValue, getMostRecentValue, buildEconomicContext, getWorldBankCountryCode, isEUMemberState, isMCPSupportedWBCountryCode, buildEconomicContextHTML, } from './utils/world-bank-data.js';
-// ─── IMF Data Utilities ──────────────────────────────────────────────────────
-export { IMF_EU_COUNTRY_CODES, IMF_COUNTRY_CODE_OVERRIDES, IMF_EURO_AREA_CODE, IMF_AGGREGATE_LABELS, IMF_POLICY_INDICATORS, IMF_INDICATOR_SDMX_CODES, getIMFCountryCode, isIMFEUMemberState, parseSDMXJSON, getMostRecentObservation, getForecastPoints, formatIMFValue, buildIMFEconomicContext, buildIMFEconomicContextHTML, } from './utils/imf-data.js';
-// ─── Templates ───────────────────────────────────────────────────────────────
-export { generateArticleHTML } from './templates/article-template.js';
-export { computeArticleQualityScore, buildTableOfContents, buildQualityScoreBadge, } from './templates/section-builders.js';
-// ─── Constants & Languages ───────────────────────────────────────────────────
-export { ALL_LANGUAGES, LANGUAGE_PRESETS, LANGUAGE_FLAGS, LANGUAGE_NAMES, getLocalizedString, isSupportedLanguage, getTextDirection, } from './constants/language-core.js';
-export { WB_INDICATORS, COMMITTEE_INDICATOR_MAP, CATEGORY_INDICATOR_MAP, getCommitteeIndicators, getCommitteePrimaryIndicators, getCategoryIndicators, getIndicatorIdsForCommittees, getAllCategoryIndicatorIds, } from './constants/committee-indicator-map.js';
-// ─── Configuration Constants ─────────────────────────────────────────────────
-export { PROJECT_ROOT, NEWS_DIR, METADATA_DIR, BASE_URL, ARTICLE_FILENAME_PATTERN, WORDS_PER_MINUTE, VALID_ARTICLE_CATEGORIES, ARTICLE_TYPE_WEEK_AHEAD, ARTICLE_TYPE_BREAKING, ARTICLE_TYPE_COMMITTEE_REPORTS, ARTICLE_TYPE_PROPOSITIONS, ARTICLE_TYPE_MOTIONS, ARTICLE_TYPE_MONTH_AHEAD, ARTICLE_TYPE_WEEK_IN_REVIEW, ARTICLE_TYPE_MONTH_IN_REVIEW, ARG_SEPARATOR, APP_VERSION, createThemeToggleButton, THEME_TOGGLE_SCRIPT_CONTENT, THEME_TOGGLE_SCRIPT, } from './constants/config.js';
-// ─── Analysis Constants ──────────────────────────────────────────────────────
-export { AI_MARKER } from './constants/analysis-constants.js';
-// ─── Language UI Strings ─────────────────────────────────────────────────────
-export { PAGE_TITLES, PAGE_DESCRIPTIONS, SECTION_HEADINGS, NO_ARTICLES_MESSAGES, SKIP_LINK_TEXTS, ARTICLE_TYPE_LABELS, READ_TIME_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, AI_SECTION_CONTENT, FILTER_LABELS, SOURCES_HEADING_LABELS, HEADER_SUBTITLE_LABELS, THEME_TOGGLE_LABELS, FOOTER_ABOUT_HEADING_LABELS, FOOTER_ABOUT_TEXT_LABELS, FOOTER_QUICK_LINKS_LABELS, FOOTER_BUILT_BY_LABELS, FOOTER_LANGUAGES_LABELS, TOC_ARIA_LABELS, RELATED_ANALYSIS_LABELS, } from './constants/language-ui.js';
-// ─── Language Article Strings ────────────────────────────────────────────────
-export { LOCALIZED_KEYWORDS, WEEK_AHEAD_TITLES, MONTH_AHEAD_TITLES, WEEKLY_REVIEW_TITLES, MONTHLY_REVIEW_TITLES, MOTIONS_TITLES, BREAKING_NEWS_TITLES, COMMITTEE_REPORTS_TITLES, PROPOSITIONS_TITLES, PROPOSITIONS_STRINGS, EDITORIAL_STRINGS, DEEP_ANALYSIS_STRINGS, MOTIONS_STRINGS, WEEK_AHEAD_STRINGS, WEEK_AHEAD_STAKEHOLDER_STRINGS, BREAKING_STRINGS, COMMITTEE_ANALYSIS_CONTENT_STRINGS, SWOT_STRINGS, DASHBOARD_STRINGS, SWOT_BUILDER_STRINGS, DASHBOARD_BUILDER_STRINGS, MONTH_IN_REVIEW_STRINGS, ANALYSIS_QUALITY_LABELS, } from './constants/language-articles.js';
-// ─── Political Risk Assessment ───────────────────────────────────────────────
-export { calculatePoliticalRiskScore, assessPoliticalCapitalAtRisk, buildQuantitativeSWOT, assessLegislativeVelocityRisk, runAgentRiskAssessment, generateRiskAssessmentMarkdown, generatePoliticalRiskSummary, createScoredSWOTItem, createScoredOpportunityOrThreat, createRiskDriver, } from './utils/political-risk-assessment.js';
-// ─── Analysis Pipeline Stages ─────────────────────────────────────────────────
-export { ALL_ANALYSIS_METHODS, VALID_ANALYSIS_METHODS, runAnalysisStage, } from './generators/pipeline/analysis-stage.js';
-export { mcpCircuitBreaker, computeRollingDateRange, initializeMCPClient, loadFeedDataFromFile, loadEPFeedDataFromFile, fetchWeekAheadData, fetchVotingAnomalies, fetchCoalitionDynamics, fetchVotingReport, fetchMEPInfluence, loadCommitteeDataFromFile, fetchCommitteeInfoFromEPAPI, fetchCommitteeData, fetchVotingRecords, fetchVotingPatterns, fetchMotionsAnomalies, fetchParliamentaryQuestionsForMotions, fetchMotionsData, fetchProposalsFromMCP, fetchPipelineFromMCP, fetchProcedureStatusFromMCP, fetchAdoptedTextsFeed, fetchEventsFeed, fetchProceduresFeed, fetchMEPsFeed, fetchMEPsFeedWithTotal, fetchDocumentsFeed, fetchPlenaryDocumentsFeed, fetchCommitteeDocumentsFeed, fetchPlenarySessionDocumentsFeed, fetchExternalDocumentsFeed, fetchQuestionsFeed, fetchDeclarationsFeed, fetchCorporateBodiesFeed, fetchBreakingNewsFeedData, fetchEPFeedData, } from './generators/pipeline/fetch-stage.js';
-export { validateMCPResponse, normalizeISO8601Date, sanitizeText, isValidCountryCode, isValidLanguageCode, } from './generators/pipeline/transform-stage.js';
-export { createStrategyRegistry, generateArticleForStrategy, } from './generators/pipeline/generate-stage.js';
-export { writeArticleFile, writeSingleArticle, writeGenerationMetadata, } from './generators/pipeline/output-stage.js';
-export { loadAnalysisContext, extractAnalysisSummary, buildAnalysisInsightsSection, } from './generators/strategies/article-strategy.js';
-export { BreakingNewsStrategy, breakingNewsStrategy, } from './generators/strategies/breaking-news-strategy.js';
-export { AFET_KEYWORDS, LIBE_KEYWORDS, AGRI_KEYWORDS, ENVI_KEYWORDS, ECON_KEYWORDS, categorizeAdoptedText, CommitteeReportsStrategy, committeeReportsStrategy, } from './generators/strategies/committee-reports-strategy.js';
-export { MonthAheadStrategy, monthAheadStrategy, } from './generators/strategies/month-ahead-strategy.js';
-export { MonthlyReviewStrategy, monthlyReviewStrategy, } from './generators/strategies/monthly-review-strategy.js';
-export { MotionsStrategy, motionsStrategy, } from './generators/strategies/motions-strategy.js';
-export { PropositionsStrategy, propositionsStrategy, } from './generators/strategies/propositions-strategy.js';
-export { WeekAheadStrategy, weekAheadStrategy, } from './generators/strategies/week-ahead-strategy.js';
-export { WeeklyReviewStrategy, weeklyReviewStrategy, } from './generators/strategies/weekly-review-strategy.js';
-// ─── Content Generators ──────────────────────────────────────────────────────
-export { buildVotingAnalysis, buildProspectiveAnalysis, buildBreakingAnalysis, buildPropositionsAnalysis, buildCommitteeAnalysis, buildVotingSwot, buildProspectiveSwot, buildBreakingSwot, buildPropositionsSwot, buildCommitteeSwot, buildVotingDashboard, buildProspectiveDashboard, buildBreakingDashboard, buildPropositionsDashboard, buildCommitteeDashboard, buildVotingMindmap, buildProspectiveMindmap, buildBreakingMindmap, buildPropositionsMindmap, buildCommitteeMindmap, } from './generators/analysis-builders.js';
-export { SIGNIFICANCE_THRESHOLD, scoreBreakingNewsSignificance, buildBreakingNewsContent, } from './generators/breaking-content.js';
-export { FEATURED_COMMITTEES, PLACEHOLDER_CHAIR, PLACEHOLDER_MEMBERS, applyCommitteeInfo, applyDocuments, isPlaceholderCommitteeData, applyEffectiveness, } from './generators/committee-helpers.js';
-export { buildCoalitionPanel, buildPipelinePanel, buildTrendPanel, buildStakeholderScorecardPanel, buildDashboardSection, dashboardHasCharts, buildEconomicContextPanel, } from './generators/dashboard-content.js';
-export { buildDeepAnalysisSection } from './generators/deep-analysis-content.js';
-export { buildIntelligenceMindmapSection } from './generators/mindmap-content.js';
-export { PLACEHOLDER_MARKER, getMotionsFallbackData, generateMotionsContent, buildPoliticalAlignmentSection, buildAdoptedTextsSection, } from './generators/motions-content.js';
-export { buildSwotSection } from './generators/swot-content.js';
-export { PLACEHOLDER_EVENTS, parsePlenarySessions, parseEPEvents, parseCommitteeMeetings, parseLegislativeDocuments, parseLegislativePipeline, parseParliamentaryQuestions, computeWeekPoliticalTemperature, buildStakeholderImpactMatrix, buildWeekAheadContent, buildKeywords, buildWhatToWatchSection, } from './generators/week-ahead-content.js';
-export { buildPropositionsContent } from './generators/propositions-content.js';
-// ─── Index & Sitemap Generators ──────────────────────────────────────────────
-export { getIndexFilename, generateIndexHTML } from './generators/news-indexes.js';
-export { collectDocsHtmlFiles, generateSitemap, getSitemapFilename, generateSitemapHTML, generateRssFeed, } from './generators/sitemap.js';
-// ─── Political Intelligence Classification ────────────────────────────────────
-export { FRAMEWORK_VERSION, assessPoliticalSignificance, buildImpactMatrix, classifyPoliticalActors, analyzePoliticalForces, initializeAnalysisDirectory, serializeFrontmatter, writeAnalysisFile, writeAnalysisManifest, compareSignificance, maxSignificance, } from './utils/political-classification.js';
-//# sourceMappingURL=index.old.js.map

package/scripts/utils/migrate-legacy-articles.js

@@ -1,225 +0,0 @@
-// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
-// SPDX-License-Identifier: Apache-2.0
-
-/**
- * One-shot migration script to normalize legacy news/*.html files to the
- * current canonical header/footer/script layout.
- *
- * Applied operations per file (idempotent — safe to re-run):
- *   1. Upgrade the `<header class="site-header">` block to the current markup
- *      (header-logo.png/webp at 72×48, theme-toggle, in-header language
- *      switcher `<nav class="site-header__langs">`).
- *   2. Remove any standalone legacy `<nav class="language-switcher">` block
- *      that sits outside the header.
- *   3. Replace the two inline `<script>` blocks (reading-progress + theme
- *      toggle) with a single `<script src="../js/article-runtime.js" defer>`.
- *   4. Replace the `<footer class="site-footer">` with a freshly rendered
- *      fully-localized footer built via `buildSiteFooter` — so Quick Links,
- *      Built by, contact, disclaimer etc. are all in the correct language
- *      for all 14 languages.
- *
- * Preserved as-is:
- *   - All JSON-LD schema scripts (`<script type="application/ld+json">`).
- *   - The `<article>` body and all analysis sections.
- *   - Chart.js / D3 vendor + init scripts when already present.
- *   - Hreflang link alternates, canonical link, meta tags.
- *
- * Usage: `node scripts/utils/migrate-legacy-articles.js [--dry-run]`
- */
-
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { buildSiteFooter } from '../templates/section-builders.js';
-import {
-  ALL_LANGUAGES,
-  LANGUAGE_FLAGS,
-  LANGUAGE_NAMES,
-  THEME_TOGGLE_LABELS,
-  HEADER_SUBTITLE_LABELS,
-  getLocalizedString,
-} from '../constants/languages.js';
-import { createThemeToggleButton } from '../constants/config.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const REPO_ROOT = path.resolve(__dirname, '..', '..');
-const NEWS_DIR = path.join(REPO_ROOT, 'news');
-
-/** Simple HTML-entity encode for attribute values. */
-function escapeHTML(s) {
-  return String(s)
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&#39;');
-}
-
-/** Parse `YYYY-MM-DD-slug-[runNN-]LL.html` → { date, slug, lang }. */
-function parseFilename(filename) {
-  const m = filename.match(/^(\d{4}-\d{2}-\d{2})-([a-z0-9-]+?)(?:-run\d+)?-([a-z]{2})\.html$/);
-  if (!m) return null;
-  const [, date, slug, lang] = m;
-  if (!ALL_LANGUAGES.includes(lang)) return null;
-  return { date, slug, lang };
-}
-
-/** Build the in-header language switcher anchor list (no wrapping <nav>). */
-function buildLangSwitcherAnchors(date, slug, currentLang, availableLanguages) {
-  const langs = availableLanguages.length > 0 ? availableLanguages : ALL_LANGUAGES;
-  return langs
-    .map((code) => {
-      const flag = getLocalizedString(LANGUAGE_FLAGS, code);
-      const name = getLocalizedString(LANGUAGE_NAMES, code);
-      const active = code === currentLang ? ' active' : '';
-      const href = `${date}-${slug}-${code}.html`;
-      return `<a href="${escapeHTML(href)}" class="lang-link${active}" hreflang="${code}" lang="${code}" title="${escapeHTML(name)}">${flag} ${code.toUpperCase()}</a>`;
-    })
-    .join('\n        ');
-}
-
-/** Build the canonical `<header class="site-header">…</header>` block. */
-function buildCanonicalHeader(date, slug, lang, availableLanguages) {
-  const themeLabel = escapeHTML(getLocalizedString(THEME_TOGGLE_LABELS, lang));
-  const subtitle = escapeHTML(getLocalizedString(HEADER_SUBTITLE_LABELS, lang));
-  const langs = buildLangSwitcherAnchors(date, slug, lang, availableLanguages);
-  const indexHref = lang === 'en' ? '../index.html' : `../index-${lang}.html`;
-  return `<header class="site-header" role="banner">
-    <div class="site-header__inner">
-      <a href="${escapeHTML(indexHref)}" class="site-header__brand" aria-label="EU Parliament Monitor">
-        <picture class="site-header__logo-picture">
-          <source srcset="../images/header-logo.webp" type="image/webp">
-          <img class="site-header__logo site-header__logo--header" src="../images/header-logo.png" alt="" width="72" height="48" aria-hidden="true">
-        </picture>
-        <span>
-          <span class="site-header__title">EU Parliament Monitor</span>
-          <span class="site-header__subtitle">${subtitle}</span>
-        </span>
-      </a>
-      ${createThemeToggleButton(themeLabel)}
-      <nav class="site-header__langs" role="navigation" aria-label="Language selection">
-        ${langs}
-      </nav>
-    </div>
-  </header>`;
-}
-
-/** Detect which languages a given {date}-{slug} article has. */
-function discoverAvailableLanguages(allFilenames, date, slug) {
-  const set = new Set();
-  for (const f of allFilenames) {
-    // Match both suffixed (-runNN-LL) and plain (-LL) patterns
-    const m = f.match(
-      new RegExp(`^${date}-${slug.replace(/[-.]/g, '\\$&')}(?:-run\\d+)?-([a-z]{2})\\.html$`)
-    );
-    if (m && ALL_LANGUAGES.includes(m[1])) set.add(m[1]);
-  }
-  return ALL_LANGUAGES.filter((l) => set.has(l));
-}
-
-/**
- * Apply in-place migrations to one HTML document string.
- * Returns the new content (same string if no changes).
- */
-function migrateDocument(html, date, slug, lang, availableLanguages) {
-  let out = html;
-
-  // ── 1. Replace the `<header class="site-header">…</header>` block
-  //        with the canonical version (handles both legacy and "modern" headers)
-  const canonicalHeader = buildCanonicalHeader(date, slug, lang, availableLanguages);
-  out = out.replace(
-    /<header class="site-header"[\s\S]*?<\/header>/,
-    () => canonicalHeader
-  );
-
-  // ── 2. Remove any standalone legacy `<nav class="language-switcher">…</nav>`
-  //        (legacy files put lang-switcher nav OUTSIDE the header; modern
-  //        files put it INSIDE the header as site-header__langs — we already
-  //        injected that in step 1, so any remaining standalone nav is redundant).
-  out = out.replace(
-    /\s*<nav class="language-switcher"[\s\S]*?<\/nav>\s*/g,
-    '\n\n  '
-  );
-
-  // ── 3. Replace inline `<script>…</script>` blocks that handle
-  //        reading-progress or theme-toggle with nothing. The external
-  //        `<script src="../js/article-runtime.js" defer>` is injected if
-  //        not already present. JSON-LD scripts (type="application/ld+json")
-  //        are left untouched.
-  out = out.replace(/<script(?![^>]*\bsrc=)(?![^>]*\btype="application\/ld\+json")[^>]*>[\s\S]*?<\/script>\s*/g,
-    (block) => {
-      // Preserve non-theme/non-reading-progress inline scripts (very rare but
-      // possible for chart-init/d3-init fallbacks)
-      if (/reading-progress/.test(block) || /ep-theme/.test(block) || /theme-toggle/.test(block)) {
-        return '';
-      }
-      return block;
-    }
-  );
-
-  // Ensure article-runtime.js is referenced exactly once before </body>.
-  if (!/<script\s[^>]*src="\.\.\/js\/article-runtime\.js"/i.test(out)) {
-    out = out.replace(
-      /<\/body>/i,
-      '  <script src="../js/article-runtime.js" defer></script>\n</body>'
-    );
-  }
-
-  // ── 4. Replace the <footer class="site-footer">…</footer> block with a
-  //        freshly-rendered, fully-localized footer.
-  const newFooter = buildSiteFooter({ lang, pathPrefix: '../' });
-  out = out.replace(/<footer class="site-footer"[\s\S]*?<\/footer>/, () => newFooter);
-
-  return out;
-}
-
-async function main() {
-  const dryRun = process.argv.includes('--dry-run');
-  const filesArg = process.argv.find((a) => a.startsWith('--files='));
-  const allFiles = (await fs.readdir(NEWS_DIR)).filter((f) => f.endsWith('.html'));
-  const files = filesArg
-    ? filesArg.slice('--files='.length).split(',').filter((f) => f.endsWith('.html'))
-    : allFiles;
-
-  let changed = 0;
-  let skipped = 0;
-  let errors = 0;
-
-  for (const f of files) {
-    const parsed = parseFilename(f);
-    if (!parsed) {
-      skipped++;
-      continue;
-    }
-    const { date, slug, lang } = parsed;
-    const available = discoverAvailableLanguages(allFiles, date, slug);
-
-    const p = path.join(NEWS_DIR, f);
-    try {
-      const before = await fs.readFile(p, 'utf8');
-      const after = migrateDocument(before, date, slug, lang, available);
-      if (after !== before) {
-        if (!dryRun) await fs.writeFile(p, after, 'utf8');
-        changed++;
-      } else {
-        skipped++;
-      }
-    } catch (err) {
-      console.error(`✗ ${f}: ${err.message}`);
-      errors++;
-    }
-  }
-
-  console.log(
-    `${dryRun ? '[dry-run] ' : ''}migrated: ${changed}, unchanged: ${skipped}, errors: ${errors}, total: ${files.length}`
-  );
-
-  if (errors > 0) process.exit(1);
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});