euparliamentmonitor 0.8.20 → 0.8.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.20",
+  "version": "0.8.21",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -140,8 +140,8 @@
     "@types/d3": "7.4.3",
     "@types/node": "25.5.2",
     "@types/papaparse": "5.5.2",
-    "@typescript-eslint/eslint-plugin": "8.58.0",
-    "@typescript-eslint/parser": "8.58.0",
+    "@typescript-eslint/eslint-plugin": "8.58.1",
+    "@typescript-eslint/parser": "8.58.1",
     "@vitest/coverage-v8": "4.1.3",
     "@vitest/ui": "4.1.3",
     "chart.js": "4.5.1",

package/scripts/generators/news-enhanced.js

@@ -11,7 +11,7 @@
  *
  * When the `--analysis` flag is supplied (all 9 agentic workflows do this),
  * the analysis stage runs **before** article generation, producing structured
- * political intelligence artifacts under `analysis/{date}/{article-type}/`.  These
+ * political intelligence artifacts under `analysis/daily/{date}/{article-type}/`.  These
  * artifacts are committed to the repository for review and improvement.
  *
  * Pipeline stages:
@@ -177,7 +177,7 @@ function parseAnalysisMethods() {
  * Run the optional analysis stage (Fetch → Analysis) before article generation.
  *
  * This function is **side-effect-only**: it writes analysis markdown and a
- * `manifest.json` to disk under `analysis/{date}/{article-type}/`.  The returned
+ * `manifest.json` to disk under `analysis/daily/{date}/{article-type}/`.  The returned
  * {@link AnalysisContext} is informational; strategies read analysis output
  * from disk rather than consuming the context object in-memory.  Analysis
  * artifacts are committed to the repository for review and political
@@ -203,7 +203,7 @@ async function maybeRunAnalysis(date, client) {
     const trimmedAnalysisDirBase = rawAnalysisDirBase?.trim();
     const analysisDirBase = trimmedAnalysisDirBase && trimmedAnalysisDirBase.length > 0
         ? trimmedAnalysisDirBase
-        : 'analysis';
+        : 'analysis/daily';
     const enabledMethods = parseAnalysisMethods();
     console.log('');
     console.log('🔬 Running analysis stage...');
@@ -362,7 +362,7 @@ async function main() {
         // Expose analysis dir/slug via env vars so strategies can locate analysis
         // artifacts without hard-coding paths.  Follows the EP_FEED_DATA_FILE pattern.
         if (analysisCtx) {
-            // Base dir: parent of date-scoped dir (e.g. 'analysis' from 'analysis/2026-04-06/breaking')
+            // Base dir: parent of date-scoped dir (e.g. 'analysis/daily' from 'analysis/daily/2026-04-06/breaking')
             const analysisOutputParent = path.dirname(analysisCtx.outputDir);
             const analysisBaseDir = path.dirname(analysisOutputParent);
             process.env['EP_ANALYSIS_DIR'] = analysisBaseDir;

package/scripts/generators/pipeline/analysis-stage.d.ts

@@ -26,7 +26,7 @@ export interface AnalysisStageOptions {
     readonly articleTypes: readonly ArticleCategory[];
     /** ISO date string (YYYY-MM-DD) for this analysis run */
     readonly date: string;
-    /** Base output directory (e.g. 'analysis') */
+    /** Base output directory (e.g. 'analysis/daily') */
     readonly outputDir: string;
     /**
      * Filesystem-safe slug identifying the article type for this run.

package/scripts/generators/pipeline/analysis-stage.js

@@ -11,7 +11,7 @@
  * news articles in all 14 languages.
  *
  * This stage is **side-effect-only**: it writes analysis markdown and a
- * `manifest.json` to disk under `analysis/{date}/{article-type}/`.  When
+ * `manifest.json` to disk under `analysis/daily/{date}/{article-type}/`.  When
  * `articleTypeSlug` is provided (recommended for agentic workflows), each
  * article type writes to its own subdirectory, preventing merge conflicts
  * when multiple workflows run concurrently on the same date.
@@ -29,7 +29,7 @@
  * const ctx = await runAnalysisStage(fetchedData, {
  *   articleTypes: [ArticleCategory.WEEK_AHEAD],
  *   date: '2026-03-26',
- *   outputDir: 'analysis',
+ *   outputDir: 'analysis/daily',
  * });
  * console.log(ctx.completedMethods);
  * ```

package/scripts/generators/pipeline/analysis-threats.d.ts

@@ -4,7 +4,7 @@ import type { AnalysisMethod } from './analysis-stage.js';
  * Build markdown for the political threat landscape assessment.
  *
  * Uses the pipeline `date` parameter to ensure the assessment date in the
- * generated markdown matches the `analysis/{date}/` folder, overriding
+ * generated markdown matches the `analysis/daily/{date}/` folder, overriding
  * the `new Date()` timestamp that `assessPoliticalThreats()` stamps internally.
  *
  * @param fetchedData - Raw fetched EP data

package/scripts/generators/pipeline/analysis-threats.js

@@ -17,7 +17,7 @@ import { sanitizeCell, safeArr, toThreatInput, buildMarkdownHeader, EMPTY_TABLE_
  * Build markdown for the political threat landscape assessment.
  *
  * Uses the pipeline `date` parameter to ensure the assessment date in the
- * generated markdown matches the `analysis/{date}/` folder, overriding
+ * generated markdown matches the `analysis/daily/{date}/` folder, overriding
  * the `new Date()` timestamp that `assessPoliticalThreats()` stamps internally.
  *
  * @param fetchedData - Raw fetched EP data

package/scripts/generators/pipeline/fetch-stage.d.ts

@@ -217,6 +217,7 @@ export declare function fetchPipelineFromMCP(client: EuropeanParliamentMCPClient
 export declare function fetchProcedureStatusFromMCP(client: EuropeanParliamentMCPClient | null, procedureId: string): Promise<string>;
 /**
  * Fetch adopted texts feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -225,6 +226,8 @@ export declare function fetchProcedureStatusFromMCP(client: EuropeanParliamentMC
 export declare function fetchAdoptedTextsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<AdoptedTextFeedItem[]>;
 /**
  * Fetch events feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data
+ * (common during parliamentary recess when the EP API returns 404 for narrow windows).
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -233,6 +236,7 @@ export declare function fetchAdoptedTextsFeed(client: EuropeanParliamentMCPClien
 export declare function fetchEventsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<EventFeedItem[]>;
 /**
  * Fetch procedures feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -267,6 +271,7 @@ export declare function fetchMEPsFeedWithTotal(client: EuropeanParliamentMCPClie
 }>;
 /**
  * Fetch documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -275,6 +280,7 @@ export declare function fetchMEPsFeedWithTotal(client: EuropeanParliamentMCPClie
 export declare function fetchDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch plenary documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -283,6 +289,7 @@ export declare function fetchDocumentsFeed(client: EuropeanParliamentMCPClient |
 export declare function fetchPlenaryDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch committee documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -291,6 +298,7 @@ export declare function fetchPlenaryDocumentsFeed(client: EuropeanParliamentMCPC
 export declare function fetchCommitteeDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch plenary session documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -299,6 +307,7 @@ export declare function fetchCommitteeDocumentsFeed(client: EuropeanParliamentMC
 export declare function fetchPlenarySessionDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch external documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -307,6 +316,7 @@ export declare function fetchPlenarySessionDocumentsFeed(client: EuropeanParliam
 export declare function fetchExternalDocumentsFeed(client: EuropeanParliamentMCPClient | null, timeframe?: FeedTimeframe): Promise<DocumentFeedItem[]>;
 /**
  * Fetch parliamentary questions feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')

package/scripts/generators/pipeline/fetch-stage.js

@@ -1050,6 +1050,28 @@ export async function fetchProcedureStatusFromMCP(client, procedureId) {
     }
 }
 // ─── EP Feed-based fetches (Breaking News) ──────────────────────────────────
+/**
+ * Ordered fallback chain for feed timeframes.
+ * When a narrow timeframe returns empty/404 (common during recess), we widen
+ * the window to retrieve at least *some* recent data for analysis.
+ */
+const TIMEFRAME_FALLBACK_CHAIN = new Map([
+    ['today', 'one-day'],
+    ['one-day', 'one-week'],
+    ['one-week', 'one-month'],
+    ['one-month', undefined],
+    ['three-months', undefined],
+    ['one-year', undefined],
+]);
+/**
+ * Get the next wider timeframe for fallback, or `undefined` if no fallback exists.
+ *
+ * @param current - Current timeframe
+ * @returns Next wider timeframe, or undefined when at widest
+ */
+function getWiderTimeframe(current) {
+    return TIMEFRAME_FALLBACK_CHAIN.get(current);
+}
 /**
  * Parse a feed result from MCP into a flat array of items.
  * EP API v2 feeds return items under the `data` key:
@@ -1134,6 +1156,7 @@ function mapFeedItemBase(item) {
 }
 /**
  * Fetch adopted texts feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1142,19 +1165,37 @@ function mapFeedItemBase(item) {
 export async function fetchAdoptedTextsFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching adopted texts feed (${timeframe})...`);
-        const result = await callMCP(() => client.getAdoptedTextsFeed({ timeframe, limit: 20 }), undefined, 'get_adopted_texts_feed');
-        return parseFeedResult(result).map((item) => mapFeedItemBase(item));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_adopted_texts_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching adopted texts feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getAdoptedTextsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_adopted_texts_feed');
+            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} adopted texts feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_adopted_texts_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_adopted_texts_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch events feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data
+ * (common during parliamentary recess when the EP API returns 404 for narrow windows).
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1163,22 +1204,39 @@ export async function fetchAdoptedTextsFeed(client, timeframe = 'one-week') {
 export async function fetchEventsFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching events feed (${timeframe})...`);
-        const result = await callMCP(() => client.getEventsFeed({ timeframe, limit: 20 }), undefined, 'get_events_feed');
-        return parseFeedResult(result).map((item) => ({
-            ...mapFeedItemBase(item),
-            location: item['location'] ? String(item['location']) : undefined,
-        }));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_events_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching events feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getEventsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_events_feed');
+            const items = parseFeedResult(result).map((item) => ({
+                ...mapFeedItemBase(item),
+                location: item['location'] ? String(item['location']) : undefined,
+            }));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} events feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_events_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_events_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch procedures feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1187,19 +1245,35 @@ export async function fetchEventsFeed(client, timeframe = 'one-week') {
 export async function fetchProceduresFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching procedures feed (${timeframe})...`);
-        const result = await callMCP(() => client.getProceduresFeed({ timeframe, limit: 20 }), undefined, 'get_procedures_feed');
-        return parseFeedResult(result).map((item) => ({
-            ...mapFeedItemBase(item),
-            stage: item['stage'] ? String(item['stage']) : undefined,
-        }));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_procedures_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching procedures feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getProceduresFeed({ timeframe: tf, limit: 20 }), undefined, 'get_procedures_feed');
+            const items = parseFeedResult(result).map((item) => ({
+                ...mapFeedItemBase(item),
+                stage: item['stage'] ? String(item['stage']) : undefined,
+            }));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} procedures feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_procedures_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_procedures_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch MEPs feed from MCP.
@@ -1252,6 +1326,7 @@ export async function fetchMEPsFeedWithTotal(client, timeframe = 'one-week') {
 }
 /**
  * Fetch documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1260,19 +1335,36 @@ export async function fetchMEPsFeedWithTotal(client, timeframe = 'one-week') {
 export async function fetchDocumentsFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching documents feed (${timeframe})...`);
-        const result = await callMCP(() => client.getDocumentsFeed({ timeframe, limit: 20 }), undefined, 'get_documents_feed');
-        return parseFeedResult(result).map((item) => mapFeedItemBase(item));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_documents_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching documents feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_documents_feed');
+            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} documents feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_documents_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_documents_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch plenary documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1281,19 +1373,36 @@ export async function fetchDocumentsFeed(client, timeframe = 'one-week') {
 export async function fetchPlenaryDocumentsFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching plenary documents feed (${timeframe})...`);
-        const result = await callMCP(() => client.getPlenaryDocumentsFeed({ timeframe, limit: 20 }), undefined, 'get_plenary_documents_feed');
-        return parseFeedResult(result).map((item) => mapFeedItemBase(item));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_plenary_documents_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching plenary documents feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getPlenaryDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_plenary_documents_feed');
+            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} plenary documents feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_plenary_documents_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_plenary_documents_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch committee documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1302,19 +1411,36 @@ export async function fetchPlenaryDocumentsFeed(client, timeframe = 'one-week')
 export async function fetchCommitteeDocumentsFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching committee documents feed (${timeframe})...`);
-        const result = await callMCP(() => client.getCommitteeDocumentsFeed({ timeframe, limit: 20 }), undefined, 'get_committee_documents_feed');
-        return parseFeedResult(result).map((item) => mapFeedItemBase(item));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_committee_documents_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching committee documents feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getCommitteeDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_committee_documents_feed');
+            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} committee documents feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_committee_documents_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_committee_documents_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch plenary session documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1323,19 +1449,36 @@ export async function fetchCommitteeDocumentsFeed(client, timeframe = 'one-week'
 export async function fetchPlenarySessionDocumentsFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching plenary session documents feed (${timeframe})...`);
-        const result = await callMCP(() => client.getPlenarySessionDocumentsFeed({ timeframe, limit: 20 }), undefined, 'get_plenary_session_documents_feed');
-        return parseFeedResult(result).map((item) => mapFeedItemBase(item));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_plenary_session_documents_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching plenary session documents feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getPlenarySessionDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_plenary_session_documents_feed');
+            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} plenary session docs feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_plenary_session_documents_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_plenary_session_documents_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch external documents feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1344,19 +1487,36 @@ export async function fetchPlenarySessionDocumentsFeed(client, timeframe = 'one-
 export async function fetchExternalDocumentsFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching external documents feed (${timeframe})...`);
-        const result = await callMCP(() => client.getExternalDocumentsFeed({ timeframe, limit: 20 }), undefined, 'get_external_documents_feed');
-        return parseFeedResult(result).map((item) => mapFeedItemBase(item));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_external_documents_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching external documents feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getExternalDocumentsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_external_documents_feed');
+            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} external documents feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_external_documents_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_external_documents_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch parliamentary questions feed from MCP.
+ * Falls back to a wider timeframe when the initial timeframe returns no data.
  *
  * @param client - MCP client or null
  * @param timeframe - How far back to look (default: 'one-week')
@@ -1365,16 +1525,32 @@ export async function fetchExternalDocumentsFeed(client, timeframe = 'one-week')
 export async function fetchQuestionsFeed(client, timeframe = 'one-week') {
     if (!client)
         return [];
-    try {
-        console.log(`${MCP_FETCH_PREFIX} Fetching parliamentary questions feed (${timeframe})...`);
-        const result = await callMCP(() => client.getParliamentaryQuestionsFeed({ timeframe, limit: 20 }), undefined, 'get_parliamentary_questions_feed');
-        return parseFeedResult(result).map((item) => mapFeedItemBase(item));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`${WARN_PREFIX} get_parliamentary_questions_feed failed:`, message);
-        return [];
+    let currentTimeframe = timeframe;
+    while (currentTimeframe) {
+        const tf = currentTimeframe;
+        try {
+            console.log(`${MCP_FETCH_PREFIX} Fetching parliamentary questions feed (${currentTimeframe})...`);
+            const result = await callMCP(() => client.getParliamentaryQuestionsFeed({ timeframe: tf, limit: 20 }), undefined, 'get_parliamentary_questions_feed');
+            const items = parseFeedResult(result).map((item) => mapFeedItemBase(item));
+            if (items.length > 0 || !getWiderTimeframe(currentTimeframe))
+                return items;
+            console.log(`${INFO_PREFIX} questions feed empty for ${currentTimeframe}, widening timeframe...`);
+            currentTimeframe = getWiderTimeframe(currentTimeframe);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const wider = getWiderTimeframe(tf);
+            if (wider && (message.includes('404') || message.includes('timed out'))) {
+                console.warn(`${WARN_PREFIX} get_parliamentary_questions_feed failed (${currentTimeframe}): ${message} — retrying with ${wider}`);
+                currentTimeframe = wider;
+            }
+            else {
+                console.warn(`${WARN_PREFIX} get_parliamentary_questions_feed failed:`, message);
+                return [];
+            }
+        }
     }
+    return [];
 }
 /**
  * Fetch MEP declarations feed from MCP.

package/scripts/generators/strategies/article-strategy.d.ts

@@ -50,7 +50,7 @@ export interface LoadedAnalysisContext {
  * Resolution order for base directory:
  * 1. Explicit `baseDir` parameter (when non-default)
  * 2. `EP_ANALYSIS_DIR` environment variable (set by orchestration)
- * 3. Default `'analysis'`
+ * 3. Default `'analysis/daily'`
  *
  * Resolution order for slug:
  * 1. `EP_ANALYSIS_SLUG` environment variable (set by orchestration)
@@ -58,7 +58,7 @@ export interface LoadedAnalysisContext {
  *
  * @param date - ISO 8601 date (YYYY-MM-DD) of the analysis run
  * @param articleTypeSlug - Article type slug (e.g. 'breaking', 'week-ahead')
- * @param baseDir - Base analysis directory (defaults to 'analysis')
+ * @param baseDir - Base analysis directory (defaults to 'analysis/daily')
  * @returns Loaded analysis context or null when unavailable
  */
 export declare function loadAnalysisContext(date: string, articleTypeSlug: string, baseDir?: string): LoadedAnalysisContext | null;

package/scripts/generators/strategies/article-strategy.js

@@ -17,7 +17,7 @@ import { escapeHTML } from '../../utils/file-utils.js';
 import { ANALYSIS_INSIGHTS_HEADING, getLocalizedString } from '../../constants/languages.js';
 // ─── Analysis loading defaults ───────────────────────────────────────────────
 /** Default base directory for analysis output */
-const DEFAULT_ANALYSIS_BASE_DIR = 'analysis';
+const DEFAULT_ANALYSIS_BASE_DIR = 'analysis/daily';
 /**
  * Environment variable name for overriding the analysis base directory.
  * Set by the orchestration layer when `--analysis-dir` is provided.
@@ -51,7 +51,7 @@ const ANALYSIS_SUBDIRS = [
  * Resolution order for base directory:
  * 1. Explicit `baseDir` parameter (when non-default)
  * 2. `EP_ANALYSIS_DIR` environment variable (set by orchestration)
- * 3. Default `'analysis'`
+ * 3. Default `'analysis/daily'`
  *
  * Resolution order for slug:
  * 1. `EP_ANALYSIS_SLUG` environment variable (set by orchestration)
@@ -59,7 +59,7 @@ const ANALYSIS_SUBDIRS = [
  *
  * @param date - ISO 8601 date (YYYY-MM-DD) of the analysis run
  * @param articleTypeSlug - Article type slug (e.g. 'breaking', 'week-ahead')
- * @param baseDir - Base analysis directory (defaults to 'analysis')
+ * @param baseDir - Base analysis directory (defaults to 'analysis/daily')
  * @returns Loaded analysis context or null when unavailable
  */
 export function loadAnalysisContext(date, articleTypeSlug, baseDir = DEFAULT_ANALYSIS_BASE_DIR) {

package/scripts/index.d.ts

@@ -41,7 +41,7 @@ export { enrichMetadataFromContent } from './utils/content-metadata.js';
 export { buildMetadataDatabase, writeMetadataDatabase, readMetadataDatabase, updateMetadataDatabase, updateIntelligenceIndex, } from './utils/news-metadata.js';
 export { pl, pl as pluralizeCount } from './utils/metadata-utils.js';
 export { assessPoliticalThreats, buildActorThreatProfiles, buildConsequenceTree, analyzeLegislativeDisruption, generateThreatAssessmentMarkdown, ALL_THREAT_LANDSCAPE_DIMENSIONS, } from './utils/political-threat-assessment.js';
-export { stripScriptBlocks } from './utils/html-sanitize.js';
+export { stripHtmlTags, stripScriptBlocks } from './utils/html-sanitize.js';
 export { parseArticleFilename, formatSlug, calculateReadTime, escapeHTML, isSafeURL, validateArticleHTML, type ArticleValidationResult, } from './utils/file-utils.js';
 export { detectCategory } from './utils/article-category.js';
 export { EU_COUNTRY_CODES, EU_AGGREGATE_CODE, POLICY_INDICATORS, parseWorldBankCSV, formatIndicatorValue, getMostRecentValue, buildEconomicContext, getWorldBankCountryCode, isEUMemberState, buildEconomicContextHTML, } from './utils/world-bank-data.js';

package/scripts/index.js

@@ -56,7 +56,7 @@ 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 { stripScriptBlocks } from './utils/html-sanitize.js';
+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';

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

@@ -4,7 +4,7 @@
  * built on top of the generic {@link MCPConnection} transport.
  */
 import { MCPConnection } from './mcp-connection.js';
-import type { MCPClientOptions, MCPToolResult, GetMEPsOptions, GetPlenarySessionsOptions, SearchDocumentsOptions, GetParliamentaryQuestionsOptions, GetCommitteeInfoOptions, MonitorLegislativePipelineOptions, AssessMEPInfluenceOptions, AnalyzeCoalitionDynamicsOptions, DetectVotingAnomaliesOptions, ComparePoliticalGroupsOptions, VotingRecordsOptions, VotingPatternsOptions, GenerateReportOptions, AnalyzeLegislativeEffectivenessOptions, AnalyzeCommitteeActivityOptions, TrackMEPAttendanceOptions, AnalyzeCountryDelegationOptions, GeneratePoliticalLandscapeOptions, GetCurrentMEPsOptions, GetSpeechesOptions, GetProceduresOptions, GetAdoptedTextsOptions, GetEventsOptions, GetMeetingActivitiesOptions, GetMeetingDecisionsOptions, GetMEPDeclarationsOptions, GetIncomingMEPsOptions, GetOutgoingMEPsOptions, GetHomonymMEPsOptions, GetPlenaryDocumentsOptions, GetCommitteeDocumentsOptions, GetPlenarySessionDocumentsOptions, GetPlenarySessionDocumentItemsOptions, GetControlledVocabulariesOptions, GetExternalDocumentsOptions, GetMeetingForeseenActivitiesOptions, GetProcedureEventsOptions, GetMeetingPlenarySessionDocumentsOptions, GetMeetingPlenarySessionDocumentItemsOptions, NetworkAnalysisOptions, SentimentTrackerOptions, EarlyWarningSystemOptions, ComparativeIntelligenceOptions, CorrelateIntelligenceOptions, GetAllGeneratedStatsOptions, GetMEPsFeedOptions, GetEventsFeedOptions, GetProceduresFeedOptions, GetAdoptedTextsFeedOptions, GetMEPDeclarationsFeedOptions, GetDocumentsFeedOptions, GetPlenaryDocumentsFeedOptions, GetCommitteeDocumentsFeedOptions, GetPlenarySessionDocumentsFeedOptions, GetExternalDocumentsFeedOptions, GetParliamentaryQuestionsFeedOptions, GetCorporateBodiesFeedOptions, GetControlledVocabulariesFeedOptions } from '../types/index.js';
+import type { MCPClientOptions, MCPToolResult, GetMEPsOptions, GetPlenarySessionsOptions, SearchDocumentsOptions, GetParliamentaryQuestionsOptions, GetCommitteeInfoOptions, MonitorLegislativePipelineOptions, AssessMEPInfluenceOptions, AnalyzeCoalitionDynamicsOptions, DetectVotingAnomaliesOptions, ComparePoliticalGroupsOptions, VotingRecordsOptions, VotingPatternsOptions, GenerateReportOptions, AnalyzeLegislativeEffectivenessOptions, AnalyzeCommitteeActivityOptions, TrackMEPAttendanceOptions, AnalyzeCountryDelegationOptions, GeneratePoliticalLandscapeOptions, GetCurrentMEPsOptions, GetSpeechesOptions, GetProceduresOptions, GetAdoptedTextsOptions, GetEventsOptions, GetMeetingActivitiesOptions, GetMeetingDecisionsOptions, GetMEPDeclarationsOptions, GetIncomingMEPsOptions, GetOutgoingMEPsOptions, GetHomonymMEPsOptions, GetPlenaryDocumentsOptions, GetCommitteeDocumentsOptions, GetPlenarySessionDocumentsOptions, GetPlenarySessionDocumentItemsOptions, GetControlledVocabulariesOptions, GetExternalDocumentsOptions, GetMeetingForeseenActivitiesOptions, GetProcedureEventsOptions, GetMeetingPlenarySessionDocumentsOptions, GetMeetingPlenarySessionDocumentItemsOptions, NetworkAnalysisOptions, SentimentTrackerOptions, EarlyWarningSystemOptions, ComparativeIntelligenceOptions, CorrelateIntelligenceOptions, GetAllGeneratedStatsOptions, GetMEPsFeedOptions, GetEventsFeedOptions, GetProceduresFeedOptions, GetAdoptedTextsFeedOptions, GetMEPDeclarationsFeedOptions, GetDocumentsFeedOptions, GetPlenaryDocumentsFeedOptions, GetCommitteeDocumentsFeedOptions, GetPlenarySessionDocumentsFeedOptions, GetExternalDocumentsFeedOptions, GetParliamentaryQuestionsFeedOptions, GetCorporateBodiesFeedOptions, GetControlledVocabulariesFeedOptions, GetProcedureEventByIdOptions } from '../types/index.js';
 /**
  * MCP Client for European Parliament data access.
  * Extends {@link MCPConnection} with EP-specific tool wrapper methods.
@@ -473,6 +473,22 @@ export declare class EuropeanParliamentMCPClient extends MCPConnection {
      * @returns Controlled vocabularies feed data
      */
     getControlledVocabulariesFeed(options?: GetControlledVocabulariesFeedOptions): Promise<MCPToolResult>;
+    /**
+     * Get a specific event linked to a legislative procedure.
+     * Returns a single event for the specified procedure and event identifiers.
+     *
+     * @param options - Options including required processId and eventId
+     * @returns Procedure event data
+     */
+    getProcedureEventById(options: GetProcedureEventByIdOptions): Promise<MCPToolResult>;
+    /**
+     * Check server health and feed availability status.
+     * Returns server version, uptime, per-feed health status, and overall availability.
+     * Does not make upstream API calls — reports cached status from recent tool invocations.
+     *
+     * @returns Server health and feed availability data
+     */
+    getServerHealth(): Promise<MCPToolResult>;
 }
 /**
  * Get or create singleton MCP client instance

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

@@ -22,6 +22,10 @@ const ITEMS_FALLBACK = '{"items": []}';
 const INTELLIGENCE_FALLBACK = '{"analysis": null}';
 /** Fallback payload for precomputed statistics */
 const STATS_FALLBACK = '{"stats": null}';
+/** Fallback payload for single procedure event lookup */
+const PROCEDURE_EVENT_FALLBACK = '{"event": null}';
+/** Fallback payload for server health status */
+const SERVER_HEALTH_FALLBACK = '{"server": null, "feeds": []}';
 /**
  * MCP Client for European Parliament data access.
  * Extends {@link MCPConnection} with EP-specific tool wrapper methods.
@@ -783,6 +787,34 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
     async getControlledVocabulariesFeed(options = {}) {
         return this.safeCallTool('get_controlled_vocabularies_feed', options, EuropeanParliamentMCPClient.FEED_FALLBACK);
     }
+    /**
+     * Get a specific event linked to a legislative procedure.
+     * Returns a single event for the specified procedure and event identifiers.
+     *
+     * @param options - Options including required processId and eventId
+     * @returns Procedure event data
+     */
+    async getProcedureEventById(options) {
+        if (typeof options.processId !== 'string' || options.processId.trim().length === 0) {
+            console.warn('get_procedure_event_by_id called without valid processId (non-empty string required)');
+            return { content: [{ type: 'text', text: PROCEDURE_EVENT_FALLBACK }] };
+        }
+        if (typeof options.eventId !== 'string' || options.eventId.trim().length === 0) {
+            console.warn('get_procedure_event_by_id called without valid eventId (non-empty string required)');
+            return { content: [{ type: 'text', text: PROCEDURE_EVENT_FALLBACK }] };
+        }
+        return this.safeCallTool('get_procedure_event_by_id', { processId: options.processId.trim(), eventId: options.eventId.trim() }, PROCEDURE_EVENT_FALLBACK);
+    }
+    /**
+     * Check server health and feed availability status.
+     * Returns server version, uptime, per-feed health status, and overall availability.
+     * Does not make upstream API calls — reports cached status from recent tool invocations.
+     *
+     * @returns Server health and feed availability data
+     */
+    async getServerHealth() {
+        return this.safeCallTool('get_server_health', {}, SERVER_HEALTH_FALLBACK);
+    }
 }
 let clientInstance = null;
 /**

package/scripts/mcp/mcp-connection.js

@@ -19,7 +19,7 @@ const BINARY_NAME = 'european-parliament-mcp-server';
 const BINARY_FILE = process.platform === 'win32' ? `${BINARY_NAME}.cmd` : BINARY_NAME;
 /** Default binary resolved from node_modules/.bin relative to this file's compiled location */
 const DEFAULT_SERVER_BINARY = resolve(dirname(fileURLToPath(import.meta.url)), `../../node_modules/.bin/${BINARY_FILE}`);
-/** Default request timeout in milliseconds — EU Parliament API responses commonly take 30-90+ seconds for large datasets */
+/** Default request timeout in milliseconds — EU Parliament API responses commonly take 30-120+ seconds for large datasets */
 const DEFAULT_REQUEST_TIMEOUT_MS = 180_000;
 /**
  * Effective request timeout, configurable via `EP_REQUEST_TIMEOUT_MS` env var.
@@ -482,8 +482,16 @@ export class MCPConnection {
             const isJavaScriptFile = this.serverPath.toLowerCase().endsWith('.js');
             const command = isJavaScriptFile ? process.execPath : this.serverPath;
             const args = isJavaScriptFile ? [this.serverPath] : [];
+            // Ensure EP_REQUEST_TIMEOUT_MS is propagated to the MCP server subprocess.
+            // The EP MCP server defaults to only 10 seconds; we need 90+ seconds for
+            // slow EP API feed endpoints (events, procedures, documents, etc.).
+            const childEnv = { ...process.env };
+            if (!childEnv['EP_REQUEST_TIMEOUT_MS']) {
+                childEnv['EP_REQUEST_TIMEOUT_MS'] = String(REQUEST_TIMEOUT_MS);
+            }
             this.process = spawn(command, args, {
                 stdio: ['pipe', 'pipe', 'pipe'],
+                env: childEnv,
             });
             let buffer = '';
             let startupError = null;

package/scripts/templates/article-template.js

@@ -7,6 +7,7 @@
 import { createHash } from 'crypto';
 import { ALL_LANGUAGES, LANGUAGE_FLAGS, LANGUAGE_NAMES, ARTICLE_TYPE_LABELS, READ_TIME_LABELS, BACK_TO_NEWS_LABELS, ARTICLE_NAV_LABELS, SKIP_LINK_TEXTS, 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, ANALYSIS_TRANSPARENCY_LABELS, ANALYSIS_SUMMARY_LABELS, METHODOLOGY_LABELS, TRANSPARENCY_DISCLOSURE_LABELS, CLASSIFICATION_ANALYSIS_LABELS, THREAT_ASSESSMENT_LABELS, RISK_SCORING_LABELS, DEEP_ANALYSIS_LABELS, VIEW_SOURCE_LABELS, OPEN_SOURCE_NOTE_LABELS, AI_ANALYSIS_GUIDE_LABELS, SWOT_FRAMEWORK_LABELS, RISK_METHODOLOGY_LABELS, THREAT_FRAMEWORK_LABELS, CLASSIFICATION_GUIDE_LABELS, STYLE_GUIDE_LABELS, SIGNIFICANCE_CLASSIFICATION_LABELS, ACTOR_MAPPING_LABELS, FORCES_ANALYSIS_LABELS, IMPACT_MATRIX_LABELS, POLITICAL_THREAT_LANDSCAPE_LABELS, ACTOR_THREAT_PROFILING_LABELS, CONSEQUENCE_TREES_LABELS, LEGISLATIVE_DISRUPTION_LABELS, RISK_MATRIX_LABELS, QUANTITATIVE_SWOT_LABELS, POLITICAL_CAPITAL_RISK_LABELS, LEGISLATIVE_VELOCITY_RISK_LABELS, AGENT_RISK_WORKFLOW_LABELS, STAKEHOLDER_IMPACT_LABELS, COALITION_DYNAMICS_LABELS, VOTING_PATTERNS_LABELS, CROSS_SESSION_INTELLIGENCE_LABELS, getLocalizedString, getTextDirection, } from '../constants/languages.js';
 import { escapeHTML, isSafeURL } from '../utils/file-utils.js';
+import { stripHtmlTags } from '../utils/html-sanitize.js';
 import { APP_VERSION, createThemeToggleButton, THEME_TOGGLE_SCRIPT, THEME_TOGGLE_SCRIPT_CONTENT, } from '../constants/config.js';
 /** Pattern for valid article dates (YYYY-MM-DD) */
 const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/u;
@@ -16,6 +17,11 @@ const SLUG_PATTERN = /^[a-z0-9-]+$/u;
 const SRI_HASH_PATTERN = /^sha(?:256|384|512)-[A-Za-z0-9+/]+={0,2}$/u;
 /** Words per minute for read-time calculation */
 const TEMPLATE_WORDS_PER_MINUTE = 250;
+/**
+ * Base URL for the deployed site, constructed via the URL API so that CodeQL
+ * recognises it as a validated URL rather than a potential regex pattern.
+ */
+const SITE_BASE_URL = new URL('/euparliamentmonitor', 'https://hack23.github.io').href;
 /**
  * BCP47 / Open Graph locale mapping for og:locale meta tag.
  * Maps our 2-letter language codes to proper BCP47 locale strings.
@@ -116,11 +122,7 @@ export function generateArticleHTML(options) {
     const categoryLabel = categoryLabels[category] ?? category;
     const readTimeFormatter = getLocalizedString(READ_TIME_LABELS, lang);
     // Auto-compute read-time from content word count if not explicitly set
-    const contentWordCount = content
-        .replace(/<[^>]+>/gu, ' ')
-        .replace(/\s+/gu, ' ')
-        .trim()
-        .split(' ').length;
+    const contentWordCount = stripHtmlTags(content).replace(/\s+/gu, ' ').trim().split(' ').length;
     const computedReadTime = Math.max(1, Math.ceil(contentWordCount / TEMPLATE_WORDS_PER_MINUTE));
     const effectiveReadTime = readTime > 0 ? readTime : computedReadTime;
     const readTimeLabel = readTimeFormatter(effectiveReadTime);
@@ -156,12 +158,12 @@ export function generateArticleHTML(options) {
         publisher: {
             '@type': 'Organization',
             name: 'EU Parliament Monitor',
-            url: 'https://hack23.github.io/euparliamentmonitor',
+            url: SITE_BASE_URL,
         },
         keywords: keywords.join(', '),
         mainEntityOfPage: {
             '@type': 'WebPage',
-            '@id': `https://hack23.github.io/euparliamentmonitor/news/${date}-${slug}-${lang}.html`,
+            '@id': `${SITE_BASE_URL}/news/${date}-${slug}-${lang}.html`,
         },
     }, null, 4);
     // Validate and escape stylesHash — only allow valid SRI hash format
@@ -220,10 +222,10 @@ export function generateArticleHTML(options) {
   <meta property="og:type" content="article">
   <meta property="og:title" content="${safeTitle}">
   <meta property="og:description" content="${safeSubtitle}">
-  <meta property="og:url" content="https://hack23.github.io/euparliamentmonitor/news/${date}-${slug}-${lang}.html">
+  <meta property="og:url" content="${SITE_BASE_URL}/news/${date}-${slug}-${lang}.html">
   <meta property="og:site_name" content="EU Parliament Monitor">
   <meta property="og:locale" content="${OG_LOCALE_MAP[lang] ?? lang}">
-  <meta property="og:image" content="https://hack23.github.io/euparliamentmonitor/images/og-image.jpg">
+  <meta property="og:image" content="${SITE_BASE_URL}/images/og-image.jpg">
   <meta property="og:image:width" content="1200">
   <meta property="og:image:height" content="630">
   <meta property="og:image:alt" content="EU Parliament Monitor — AI-Disrupted Parliamentary Intelligence">
@@ -232,10 +234,10 @@ export function generateArticleHTML(options) {
   <meta name="twitter:card" content="summary_large_image">
   <meta name="twitter:title" content="${safeTitle}">
   <meta name="twitter:description" content="${safeSubtitle}">
-  <meta name="twitter:image" content="https://hack23.github.io/euparliamentmonitor/images/og-image.jpg">
+  <meta name="twitter:image" content="${SITE_BASE_URL}/images/og-image.jpg">
   <meta name="twitter:image:alt" content="EU Parliament Monitor — AI-Disrupted Parliamentary Intelligence">
   
-  <link rel="canonical" href="https://hack23.github.io/euparliamentmonitor/news/${date}-${slug}-${lang}.html">
+  <link rel="canonical" href="${SITE_BASE_URL}/news/${date}-${slug}-${lang}.html">
   <link rel="stylesheet" href="../styles.css"${safeSriAttrs}>
   
   <!-- Schema.org structured data -->
@@ -415,8 +417,8 @@ function renderAnalysisTransparencySection(date, slug, lang, analysisDir) {
     const styleGuideLabel = escapeHTML(getLocalizedString(STYLE_GUIDE_LABELS, lang));
     const repoBase = 'https://github.com/Hack23/euparliamentmonitor/blob/main';
     const treeDirBase = 'https://github.com/Hack23/euparliamentmonitor/tree/main';
-    const analysisDirUrl = `${treeDirBase}/analysis/${safeDate}/${safeAnalysisDirName}`;
-    const analysisFileBase = `${repoBase}/analysis/${safeDate}/${safeAnalysisDirName}`;
+    const analysisDirUrl = `${treeDirBase}/analysis/daily/${safeDate}/${safeAnalysisDirName}`;
+    const analysisFileBase = `${repoBase}/analysis/daily/${safeDate}/${safeAnalysisDirName}`;
     const methodologyDir = `${repoBase}/analysis/methodologies`;
     // Per-file localized link labels
     const significanceLabel = escapeHTML(getLocalizedString(SIGNIFICANCE_CLASSIFICATION_LABELS, lang));

package/scripts/templates/section-builders.js

@@ -7,7 +7,7 @@
  */
 import { escapeHTML } from '../utils/file-utils.js';
 import { getLocalizedString, TOC_ARIA_LABELS } from '../constants/languages.js';
-import { stripScriptBlocks } from '../utils/html-sanitize.js';
+import { stripScriptBlocks, stripHtmlTags } from '../utils/html-sanitize.js';
 /**
  * Count occurrences of a regex pattern in a string.
  *
@@ -52,10 +52,7 @@ export function computeArticleQualityScore(content) {
     // Uses iterative scanning instead of regex to avoid CodeQL js/bad-tag-filter.
     const noScripts = stripScriptBlocks(content);
     // Strip HTML tags to get plain text, then count words
-    const plainText = noScripts
-        .replace(/<[^>]*>/g, ' ')
-        .replace(/\s+/g, ' ')
-        .trim();
+    const plainText = stripHtmlTags(noScripts).replace(/\s+/g, ' ').trim();
     const wordCount = plainText.length > 0 ? plainText.split(' ').filter((w) => w.length > 0).length : 0;
     // All further counting uses script-stripped HTML to avoid false positives
     // from embedded JSON-LD or interactive script blocks.

package/scripts/types/index.d.ts

@@ -12,7 +12,7 @@
 export { type LanguageCode, type RTLLanguageCode, type AnyLanguageCode, ArticleCategory, ArticlePerspective, TimePeriod, AnalysisPerspective, CATEGORY_PERSPECTIVE, CATEGORY_TIME_PERIOD, type LanguagePreset, type LanguageMap, type ArticleCategoryLabels, type LangTitleSubtitle, type PropositionsStrings, type EditorialStrings, type MotionsStrings, type WeekAheadStrings, type WeekAheadStakeholderStrings, type StakeholderImpactRow, type StakeholderImpactSection, type PoliticalTemperatureBand, type PoliticalTemperature, type BreakingStrings, type ActionConsequence, type StakeholderOutcome, type PoliticalMistake, type DeepAnalysis, type DeepAnalysisStrings, type CommitteeAnalysisContentStrings, } from './common.js';
 export type { ParliamentEvent, CommitteeMeeting, LegislativeDocument, LegislativeProcedure, ParliamentaryQuestion, WeekAheadData, CommitteeDocument, CommitteeData, VotingRecord, VotingPattern, VotingAnomaly, MotionsQuestion, VotingAnomalyIntelligence, CoalitionIntelligence, MEPInfluenceScore, LegislativeVelocity, EPFeedItem, AdoptedTextFeedItem, EventFeedItem, ProcedureFeedItem, MEPFeedItem, DocumentFeedItem, QuestionFeedItem, DeclarationFeedItem, CorporateBodyFeedItem, BreakingNewsFeedData, EPFeedData, VotingIntensity, CoalitionShift, PolarizationIndex, PoliticalSignificanceScore, VotingTrend, CoalitionStabilityReport, LegislativeVelocityReport, } from './parliament.js';
 export type { ParsedArticle, ArticleSource, ArticleOptions, SitemapUrl, ArticleMetadataEntry, NewsMetadataDatabase, DateRange, GenerationStats, GenerationResult, ArticleQualityScore, TOCEntry, } from './generation.js';
-export { type MCPClientOptions, type MCPContentItem, type MCPToolResult, type JSONRPCRequest, type JSONRPCResponse, type PendingRequest, type GetMEPsOptions, type GetPlenarySessionsOptions, type SearchDocumentsOptions, type GetParliamentaryQuestionsOptions, type GetCommitteeInfoOptions, type MonitorLegislativePipelineOptions, type AssessMEPInfluenceOptions, type AnalyzeCoalitionDynamicsOptions, type DetectVotingAnomaliesOptions, type ComparePoliticalGroupsOptions, type AnalyzeLegislativeEffectivenessOptions, type VotingRecordsOptions, type VotingPatternsOptions, type ReportType, type GenerateReportOptions, type AnalyzeCommitteeActivityOptions, type TrackMEPAttendanceOptions, type AnalyzeCountryDelegationOptions, type GeneratePoliticalLandscapeOptions, type GetCurrentMEPsOptions, type GetSpeechesOptions, type GetProceduresOptions, type GetAdoptedTextsOptions, type GetEventsOptions, type GetMeetingActivitiesOptions, type GetMeetingDecisionsOptions, type GetMEPDeclarationsOptions, type GetIncomingMEPsOptions, type GetOutgoingMEPsOptions, type GetHomonymMEPsOptions, type GetPlenaryDocumentsOptions, type GetCommitteeDocumentsOptions, type GetPlenarySessionDocumentsOptions, type GetPlenarySessionDocumentItemsOptions, type GetControlledVocabulariesOptions, type GetExternalDocumentsOptions, type GetMeetingForeseenActivitiesOptions, type GetProcedureEventsOptions, type GetMeetingPlenarySessionDocumentsOptions, type GetMeetingPlenarySessionDocumentItemsOptions, type NetworkAnalysisOptions, type SentimentTrackerOptions, type EarlyWarningSystemOptions, type ComparativeIntelligenceOptions, type CorrelateIntelligenceOptions, type GeneratedStatsCategory, type GetAllGeneratedStatsOptions, type FeedTimeframe, type FeedBaseOptions, type GetMEPsFeedOptions, type GetEventsFeedOptions, type GetProceduresFeedOptions, type GetAdoptedTextsFeedOptions, type GetMEPDeclarationsFeedOptions, type GetDocumentsFeedOptions, type GetPlenaryDocumentsFeedOptions, type GetCommitteeDocumentsFeedOptions, type GetPlenarySessionDocumentsFeedOptions, type GetExternalDocumentsFeedOptions, type GetParliamentaryQuestionsFeedOptions, type GetCorporateBodiesFeedOptions, type GetControlledVocabulariesFeedOptions, } from './mcp.js';
+export { type MCPClientOptions, type MCPContentItem, type MCPToolResult, type JSONRPCRequest, type JSONRPCResponse, type PendingRequest, type GetMEPsOptions, type GetPlenarySessionsOptions, type SearchDocumentsOptions, type GetParliamentaryQuestionsOptions, type GetCommitteeInfoOptions, type MonitorLegislativePipelineOptions, type AssessMEPInfluenceOptions, type AnalyzeCoalitionDynamicsOptions, type DetectVotingAnomaliesOptions, type ComparePoliticalGroupsOptions, type AnalyzeLegislativeEffectivenessOptions, type VotingRecordsOptions, type VotingPatternsOptions, type ReportType, type GenerateReportOptions, type AnalyzeCommitteeActivityOptions, type TrackMEPAttendanceOptions, type AnalyzeCountryDelegationOptions, type GeneratePoliticalLandscapeOptions, type GetCurrentMEPsOptions, type GetSpeechesOptions, type GetProceduresOptions, type GetAdoptedTextsOptions, type GetEventsOptions, type GetMeetingActivitiesOptions, type GetMeetingDecisionsOptions, type GetMEPDeclarationsOptions, type GetIncomingMEPsOptions, type GetOutgoingMEPsOptions, type GetHomonymMEPsOptions, type GetPlenaryDocumentsOptions, type GetCommitteeDocumentsOptions, type GetPlenarySessionDocumentsOptions, type GetPlenarySessionDocumentItemsOptions, type GetControlledVocabulariesOptions, type GetExternalDocumentsOptions, type GetMeetingForeseenActivitiesOptions, type GetProcedureEventsOptions, type GetMeetingPlenarySessionDocumentsOptions, type GetMeetingPlenarySessionDocumentItemsOptions, type NetworkAnalysisOptions, type SentimentTrackerOptions, type EarlyWarningSystemOptions, type ComparativeIntelligenceOptions, type CorrelateIntelligenceOptions, type GeneratedStatsCategory, type GetAllGeneratedStatsOptions, type FeedTimeframe, type FeedBaseOptions, type GetMEPsFeedOptions, type GetEventsFeedOptions, type GetProceduresFeedOptions, type GetAdoptedTextsFeedOptions, type GetMEPDeclarationsFeedOptions, type GetDocumentsFeedOptions, type GetPlenaryDocumentsFeedOptions, type GetCommitteeDocumentsFeedOptions, type GetPlenarySessionDocumentsFeedOptions, type GetExternalDocumentsFeedOptions, type GetParliamentaryQuestionsFeedOptions, type GetCorporateBodiesFeedOptions, type GetControlledVocabulariesFeedOptions, type GetProcedureEventByIdOptions, } from './mcp.js';
 export type { WBMCPClientOptions, WorldBankIndicator, WorldBankCountry, EconomicContext, EconomicIndicatorSummary, EUCountryCodeMap, PolicyRelevantIndicators, } from './world-bank.js';
 export type { SwotItem, SwotAnalysis, SwotStrings, SwotBuilderStrings, SwotDimensionName, StakeholderType, SwotDimension, SwotCrossReference, TemporalSwotAssessment, MultiDimensionalSwot, MultiDimensionalSwotStrings, DashboardMetric, ChartDataset, ChartData, ChartConfig, DashboardPanel, DashboardConfig, DashboardStrings, DashboardBuilderStrings, MindmapNodeCategory, PolicyConnectionType, PolicyConnectionStrength, ActorType, MindmapBranchColor, MindmapNode, MindmapLayer, PolicyConnection, ActorNode, InfluenceWeight, IntelligenceMindmap, VotingBloc, VoteHighlight, CoalitionMetrics, LegislativePipeline, TrendMetric, TrendAnalytics, StakeholderMetric, } from './visualization.js';
 export type { ArticleGrade, AnalysisDepthScore, StakeholderCoverage, VisualizationQuality, ArticleQualityReport, } from './quality.js';

package/scripts/types/mcp.d.ts

@@ -415,4 +415,11 @@ export interface GetCorporateBodiesFeedOptions extends FeedBaseOptions {
 /** Options for getControlledVocabulariesFeed */
 export interface GetControlledVocabulariesFeedOptions extends FeedBaseOptions {
 }
+/** Options for getProcedureEventById */
+export interface GetProcedureEventByIdOptions {
+    /** Procedure process ID (required) */
+    processId: string;
+    /** Event identifier (required) */
+    eventId: string;
+}
 //# sourceMappingURL=mcp.d.ts.map

package/scripts/types/political-classification.d.ts

@@ -136,7 +136,7 @@ export interface PoliticalForcesAnalysis {
  */
 export type ClassificationMethod = 'impact-matrix' | 'actor-mapping' | 'forces-analysis' | 'significance-assessment';
 /**
- * Metadata record written to `analysis/{date}/{article-type}/manifest.json`.
+ * Metadata record written to `analysis/daily/{date}/{article-type}/manifest.json`.
  * Describes a single analysis run: when it ran, which article types were
  * analysed, and which analytical methods were applied.
  */

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

@@ -69,9 +69,9 @@ export declare function ensureDirectoryExists(dirPath: string): void;
  * `mkdirSync`, preventing TOCTOU races when concurrent workflow runs
  * attempt to claim the same candidate.
  *
- * @param baseDir - The preferred directory path (e.g. `analysis/2026-04-02/breaking`)
+ * @param baseDir - The preferred directory path (e.g. `analysis/daily/2026-04-02/breaking`)
  * @returns The original `baseDir` when no completed run exists there, or a
- *          suffixed variant (e.g. `analysis/2026-04-02/breaking-2`) otherwise.
+ *          suffixed variant (e.g. `analysis/daily/2026-04-02/breaking-2`) otherwise.
  */
 export declare function resolveUniqueAnalysisDir(baseDir: string): string;
 /**

package/scripts/utils/file-utils.js

@@ -157,9 +157,9 @@ function claimDir(dirPath) {
  * `mkdirSync`, preventing TOCTOU races when concurrent workflow runs
  * attempt to claim the same candidate.
  *
- * @param baseDir - The preferred directory path (e.g. `analysis/2026-04-02/breaking`)
+ * @param baseDir - The preferred directory path (e.g. `analysis/daily/2026-04-02/breaking`)
  * @returns The original `baseDir` when no completed run exists there, or a
- *          suffixed variant (e.g. `analysis/2026-04-02/breaking-2`) otherwise.
+ *          suffixed variant (e.g. `analysis/daily/2026-04-02/breaking-2`) otherwise.
  */
 export function resolveUniqueAnalysisDir(baseDir) {
     // If the directory doesn't exist yet or has no manifest from a prior

package/scripts/utils/html-sanitize.d.ts

@@ -14,5 +14,15 @@
  * @param html - HTML string to strip
  * @returns The HTML with script blocks replaced by spaces
  */
+/**
+ * Strip all HTML tags from a string, replacing each tag with a single space.
+ *
+ * Uses iterative index-based scanning instead of regex to avoid polynomial
+ * backtracking (CodeQL `js/polynomial-redos`).
+ *
+ * @param html - HTML string to strip
+ * @returns The text content with tags replaced by spaces
+ */
+export declare function stripHtmlTags(html: string): string;
 export declare function stripScriptBlocks(html: string): string;
 //# sourceMappingURL=html-sanitize.d.ts.map

package/scripts/utils/html-sanitize.js

@@ -16,6 +16,38 @@
  * @param html - HTML string to strip
  * @returns The HTML with script blocks replaced by spaces
  */
+/**
+ * Strip all HTML tags from a string, replacing each tag with a single space.
+ *
+ * Uses iterative index-based scanning instead of regex to avoid polynomial
+ * backtracking (CodeQL `js/polynomial-redos`).
+ *
+ * @param html - HTML string to strip
+ * @returns The text content with tags replaced by spaces
+ */
+export function stripHtmlTags(html) {
+    let result = '';
+    let pos = 0;
+    while (pos < html.length) {
+        const openIdx = html.indexOf('<', pos);
+        if (openIdx < 0) {
+            result += html.slice(pos);
+            break;
+        }
+        // Copy text before the tag
+        result += html.slice(pos, openIdx);
+        // Find the closing '>'
+        const closeIdx = html.indexOf('>', openIdx + 1);
+        if (closeIdx < 0) {
+            // Unclosed tag — keep the rest as-is
+            result += html.slice(openIdx);
+            break;
+        }
+        result += ' ';
+        pos = closeIdx + 1;
+    }
+    return result;
+}
 export function stripScriptBlocks(html) {
     const OPEN = '<script';
     const CLOSE = '</script';

package/scripts/utils/political-classification.d.ts

@@ -72,7 +72,7 @@ export declare function classifyPoliticalActors(data: ClassificationInput): Poli
  */
 export declare function analyzePoliticalForces(data: ClassificationInput): PoliticalForcesAnalysis;
 /**
- * Initialize the `analysis/{date}/` directory structure.
+ * Initialize the `analysis/daily/{date}/` directory structure.
  *
  * Creates the following sub-directories if they do not already exist:
  * - `classification/`           — Political classification results
@@ -87,7 +87,7 @@ export declare function analyzePoliticalForces(data: ClassificationInput): Polit
  * - `data/mcp-responses/`       — Raw MCP tool call responses
  *
  * When article-type scoping is used (recommended for agentic workflows),
- * the caller should pass a scoped path such as `analysis/{date}/{slug}`.
+ * the caller should pass a scoped path such as `analysis/daily/{date}/{slug}`.
  *
  * @param baseDir - Base directory for analysis output (typically `analysis/`)
  * @param date - ISO date string used as the run folder name (YYYY-MM-DD).
@@ -98,10 +98,10 @@ export declare function analyzePoliticalForces(data: ClassificationInput): Polit
  * @example
  * ```ts
  * const runDir = initializeAnalysisDirectory('./analysis', '2026-03-26');
- * // Creates: ./analysis/2026-03-26/classification/
- * //          ./analysis/2026-03-26/data/
- * //          ./analysis/2026-03-26/threat-assessment/
- * //          ./analysis/2026-03-26/risk-scoring/
+ * // Creates: ./analysis/daily/2026-03-26/classification/
+ * //          ./analysis/daily/2026-03-26/data/
+ * //          ./analysis/daily/2026-03-26/threat-assessment/
+ * //          ./analysis/daily/2026-03-26/risk-scoring/
  * ```
  */
 export declare function initializeAnalysisDirectory(baseDir: string, date: string): string;
@@ -135,7 +135,7 @@ export declare function serializeFrontmatter(fm: AnalysisFrontmatter): string;
  * @example
  * ```ts
  * // {article-type-slug} varies by workflow (e.g. 'plenary-session', 'week-ahead')
- * writeAnalysisFile('./analysis/2026-03-26/{article-type-slug}/classification/significance-classification.md', fm, body);
+ * writeAnalysisFile('./analysis/daily/2026-03-26/{article-type-slug}/classification/significance-classification.md', fm, body);
  * ```
  */
 export declare function writeAnalysisFile(filePath: string, frontmatter: AnalysisFrontmatter, content: string): void;

package/scripts/utils/political-classification.js

@@ -681,7 +681,7 @@ export function analyzePoliticalForces(data) {
 }
 // ─── Analysis directory & file utilities ─────────────────────────────────────
 /**
- * Initialize the `analysis/{date}/` directory structure.
+ * Initialize the `analysis/daily/{date}/` directory structure.
  *
  * Creates the following sub-directories if they do not already exist:
  * - `classification/`           — Political classification results
@@ -696,7 +696,7 @@ export function analyzePoliticalForces(data) {
  * - `data/mcp-responses/`       — Raw MCP tool call responses
  *
  * When article-type scoping is used (recommended for agentic workflows),
- * the caller should pass a scoped path such as `analysis/{date}/{slug}`.
+ * the caller should pass a scoped path such as `analysis/daily/{date}/{slug}`.
  *
  * @param baseDir - Base directory for analysis output (typically `analysis/`)
  * @param date - ISO date string used as the run folder name (YYYY-MM-DD).
@@ -707,10 +707,10 @@ export function analyzePoliticalForces(data) {
  * @example
  * ```ts
  * const runDir = initializeAnalysisDirectory('./analysis', '2026-03-26');
- * // Creates: ./analysis/2026-03-26/classification/
- * //          ./analysis/2026-03-26/data/
- * //          ./analysis/2026-03-26/threat-assessment/
- * //          ./analysis/2026-03-26/risk-scoring/
+ * // Creates: ./analysis/daily/2026-03-26/classification/
+ * //          ./analysis/daily/2026-03-26/data/
+ * //          ./analysis/daily/2026-03-26/threat-assessment/
+ * //          ./analysis/daily/2026-03-26/risk-scoring/
  * ```
  */
 export function initializeAnalysisDirectory(baseDir, date) {
@@ -807,7 +807,7 @@ export function serializeFrontmatter(fm) {
  * @example
  * ```ts
  * // {article-type-slug} varies by workflow (e.g. 'plenary-session', 'week-ahead')
- * writeAnalysisFile('./analysis/2026-03-26/{article-type-slug}/classification/significance-classification.md', fm, body);
+ * writeAnalysisFile('./analysis/daily/2026-03-26/{article-type-slug}/classification/significance-classification.md', fm, body);
  * ```
  */
 export function writeAnalysisFile(filePath, frontmatter, content) {

package/scripts/utils/political-risk-assessment.d.ts

@@ -91,7 +91,7 @@ export declare function runAgentRiskAssessment(assessmentId: string, date: strin
 /**
  * Generate a structured markdown document from an agent risk assessment workflow.
  * Produces a YAML-frontmatter header and all risk sections in markdown format
- * suitable for writing to `analysis/{date}/risk-scoring/agent-risk-workflow.md`.
+ * suitable for writing to `analysis/daily/{date}/risk-scoring/agent-risk-workflow.md`.
  *
  * @param assessment - Completed agent risk assessment workflow
  * @returns Markdown string with YAML frontmatter and full risk analysis

package/scripts/utils/political-risk-assessment.js

@@ -385,7 +385,7 @@ export function runAgentRiskAssessment(assessmentId, date, articleType, identifi
 /**
  * Generate a structured markdown document from an agent risk assessment workflow.
  * Produces a YAML-frontmatter header and all risk sections in markdown format
- * suitable for writing to `analysis/{date}/risk-scoring/agent-risk-workflow.md`.
+ * suitable for writing to `analysis/daily/{date}/risk-scoring/agent-risk-workflow.md`.
  *
  * @param assessment - Completed agent risk assessment workflow
  * @returns Markdown string with YAML frontmatter and full risk analysis