euparliamentmonitor 0.8.21 → 0.8.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "euparliamentmonitor",
-  "version": "0.8.21",
+  "version": "0.8.23",
   "type": "module",
   "description": "European Parliament Intelligence Platform - Monitor political activity with systematic transparency",
   "main": "scripts/index.js",
@@ -142,8 +142,8 @@
     "@types/papaparse": "5.5.2",
     "@typescript-eslint/eslint-plugin": "8.58.1",
     "@typescript-eslint/parser": "8.58.1",
-    "@vitest/coverage-v8": "4.1.3",
-    "@vitest/ui": "4.1.3",
+    "@vitest/coverage-v8": "4.1.4",
+    "@vitest/ui": "4.1.4",
     "chart.js": "4.5.1",
     "chartjs-plugin-annotation": "3.1.0",
     "d3": "7.9.0",
@@ -163,13 +163,13 @@
     "tsx": "4.21.0",
     "typedoc": "0.28.18",
     "typescript": "6.0.2",
-    "vitest": "4.1.3"
+    "vitest": "4.1.4"
   },
   "engines": {
     "node": ">=25"
   },
   "dependencies": {
-    "european-parliament-mcp-server": "1.1.28"
+    "european-parliament-mcp-server": "1.2.1"
   },
   "optionalDependencies": {
     "worldbank-mcp": "1.0.1"

package/scripts/generators/news-enhanced.d.ts

@@ -11,4 +11,16 @@ export { applyCommitteeInfo, applyDocuments, applyEffectiveness, FEATURED_COMMIT
 export { PLACEHOLDER_MARKER, getMotionsFallbackData, generateMotionsContent, buildPoliticalAlignmentSection, };
 export { buildPropositionsContent };
 export type { PipelineData };
+/**
+ * AI-generated article title passed by the agentic workflow.
+ * When provided, this OVERRIDES any script-generated title.
+ * The AI agent (Opus 4.6) must analyse the content and produce this.
+ */
+export declare const aiTitle: string;
+/**
+ * AI-generated article description/subtitle passed by the agentic workflow.
+ * When provided, this OVERRIDES any script-generated description.
+ * The AI agent (Opus 4.6) must analyse the content and produce this.
+ */
+export declare const aiDescription: string;
 //# sourceMappingURL=news-enhanced.d.ts.map

package/scripts/generators/news-enhanced.js

@@ -45,7 +45,7 @@ import { closeEPMCPClient } from '../mcp/ep-mcp-client.js';
 import { ensureDirectoryExists } from '../utils/file-utils.js';
 // ─── Pipeline-stage imports ───────────────────────────────────────────────────
 import { initializeMCPClient, fetchEPFeedData } from './pipeline/fetch-stage.js';
-import { createStrategyRegistry, generateArticleForStrategy } from './pipeline/generate-stage.js';
+import { createStrategyRegistry, generateArticleForStrategy, setAIMetadata, } from './pipeline/generate-stage.js';
 import { writeGenerationMetadata } from './pipeline/output-stage.js';
 import { runAnalysisStage, ALL_ANALYSIS_METHODS, VALID_ANALYSIS_METHODS, hasSubstantiveData, deriveArticleTypeSlug, } from './pipeline/analysis-stage.js';
 // ─── Content-module imports (bounded contexts) ───────────────────────────────
@@ -73,6 +73,22 @@ const analysisOnlyArg = args.includes('--analysis-only');
 const analysisVerboseArg = args.includes('--analysis-verbose');
 const analysisDirArg = args.find((arg) => arg.startsWith('--analysis-dir='));
 const analysisMethodsArg = args.find((arg) => arg.startsWith('--analysis-methods='));
+const titleArg = args.find((arg) => arg.startsWith('--title='));
+const descriptionArg = args.find((arg) => arg.startsWith('--description='));
+/**
+ * AI-generated article title passed by the agentic workflow.
+ * When provided, this OVERRIDES any script-generated title.
+ * The AI agent (Opus 4.6) must analyse the content and produce this.
+ */
+export const aiTitle = titleArg ? titleArg.slice('--title='.length).trim() : '';
+/**
+ * AI-generated article description/subtitle passed by the agentic workflow.
+ * When provided, this OVERRIDES any script-generated description.
+ * The AI agent (Opus 4.6) must analyse the content and produce this.
+ */
+export const aiDescription = descriptionArg
+    ? descriptionArg.slice('--description='.length).trim()
+    : '';
 /** Path to a JSON file containing pre-fetched EP feed data (optional). */
 const feedDataPath = feedDataArg?.startsWith('--feed-data=')
     ? feedDataArg.slice('--feed-data='.length).trim()
@@ -332,6 +348,20 @@ async function runAnalysisWithGuard(date, client) {
     }
     return analysisCtx;
 }
+/**
+ * Wire AI-provided title/description from CLI `--title` and `--description` flags.
+ * The AI agent (Opus 4.6) passes these after analysing the content.
+ * They override ALL script-generated metadata for the English version.
+ */
+function wireAIMetadata() {
+    if (aiTitle || aiDescription) {
+        setAIMetadata(aiTitle, aiDescription);
+        if (aiTitle)
+            console.log(`📝 AI-provided title: "${aiTitle}"`);
+        if (aiDescription)
+            console.log(`📝 AI-provided description: "${aiDescription}"`);
+    }
+}
 /**
  * Main execution: initialise the MCP client, optionally run analysis stage,
  * iterate over requested article types, delegate to the appropriate strategy,
@@ -341,6 +371,8 @@ async function main() {
     console.log('');
     console.log('🚀 Starting news generation...');
     console.log('');
+    // Wire AI-provided title/description from CLI flags.
+    wireAIMetadata();
     // When --feed-data is provided, expose the path via env so strategies can
     // load pre-fetched data without requiring a live MCP connection.
     if (feedDataPath) {

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

@@ -34,12 +34,77 @@ const EVENT_PUBLIC_LOW = 3;
 const EVENT_DEFAULT_URGENCY = 5;
 const EVENT_INSTITUTIONAL_HIGH = 7;
 const EVENT_INSTITUTIONAL_LOW = 4;
-/** Default dimension scores for adopted texts (plenary-approved) */
-const ADOPTED_PARLIAMENTARY = 7;
-const ADOPTED_POLICY = 6;
-const ADOPTED_PUBLIC = 5;
-const ADOPTED_URGENCY = 4;
-const ADOPTED_INSTITUTIONAL = 6;
+/** Base dimension scores for adopted texts (plenary-approved) */
+const ADOPTED_PARLIAMENTARY_BASE = 6;
+const ADOPTED_POLICY_BASE = 5;
+const ADOPTED_PUBLIC_BASE = 4;
+const ADOPTED_URGENCY_BASE = 3;
+const ADOPTED_INSTITUTIONAL_BASE = 5;
+// ─── Content-aware scoring keywords for adopted text differentiation ──────────
+/** Title keywords indicating high-impact legislative texts (directives, regulations) */
+const HIGH_IMPACT_TITLE_KEYWORDS = /\b(?:directive|regulation|regulation\s+\(eu\)|codecision|ordinary\s+legislative|COD|budget|defence|security|tariff|anti-corruption|banking|single\s+market)\b/i;
+/** Title keywords indicating moderate-impact texts */
+const MODERATE_IMPACT_TITLE_KEYWORDS = /\b(?:resolution|decision|recommendation|amendment|framework|strategy|agreement|trade|environment|climate|digital|data\s+protection|consumer|health)\b/i;
+/** Procedure references indicating ordinary legislative procedure (highest significance) */
+const COD_PROCEDURE_PATTERN = /\bCOD\b|\b\d{4}\/\d{4}\(COD\)/i;
+/** Pattern for recent EP10 adopted texts (current term) */
+const EP10_ADOPTED_TEXT_PATTERN = /TA-10-202[5-9]/i;
+/**
+ * Score an adopted text based on its actual content metadata.
+ *
+ * Analyses the title, reference, and any procedure type information to
+ * produce differentiated scores rather than flat constants. High-impact
+ * legislative texts (directives, regulations, COD procedures) score higher
+ * than routine administrative texts.
+ *
+ * @param title - Adopted text title or label
+ * @param reference - EP reference identifier
+ * @param workType - Optional work type field from EP data
+ * @param procedureReference - Optional procedure reference
+ * @returns Per-dimension scoring input
+ */
+function scoreAdoptedText(title, reference, workType, procedureReference) {
+    let parliamentary = ADOPTED_PARLIAMENTARY_BASE;
+    let policy = ADOPTED_POLICY_BASE;
+    let publicInterest = ADOPTED_PUBLIC_BASE;
+    let urgency = ADOPTED_URGENCY_BASE;
+    let institutional = ADOPTED_INSTITUTIONAL_BASE;
+    const combined = [title, reference, workType, procedureReference].filter(Boolean).join(' ');
+    // Boost for high-impact legislative keywords
+    if (HIGH_IMPACT_TITLE_KEYWORDS.test(combined)) {
+        parliamentary += 2;
+        policy += 2;
+        publicInterest += 2;
+        institutional += 2;
+    }
+    else if (MODERATE_IMPACT_TITLE_KEYWORDS.test(combined)) {
+        parliamentary += 1;
+        policy += 1;
+        publicInterest += 1;
+        institutional += 1;
+    }
+    // Boost for ordinary legislative procedure (COD) — highest parliamentary significance
+    if (COD_PROCEDURE_PATTERN.test(combined)) {
+        parliamentary += 1;
+        policy += 1;
+    }
+    // Boost urgency for current-term (EP10) adopted texts
+    if (EP10_ADOPTED_TEXT_PATTERN.test(reference)) {
+        urgency += 2;
+    }
+    // Boost for legislative resolution work types
+    if (workType && /legislative.*resolution|position.*first.*reading/i.test(workType)) {
+        parliamentary += 1;
+        policy += 1;
+    }
+    return {
+        parliamentarySignificance: Math.min(10, parliamentary),
+        policyImpact: Math.min(10, policy),
+        publicInterest: Math.min(10, publicInterest),
+        temporalUrgency: Math.min(10, urgency),
+        institutionalRelevance: Math.min(10, institutional),
+    };
+}
 /** Analysis method identifier for significance scoring */
 export const METHOD_SIGNIFICANCE_SCORING_ID = 'significance-scoring';
 // ─── Per-method markdown builders ────────────────────────────────────────────
@@ -290,14 +355,15 @@ export function buildSignificanceScoringMarkdown(fetchedData, date) {
         }),
         ...adoptedTexts.map((t) => {
             const at = t;
+            const title = String(at['title'] ?? at['label'] ?? 'Adopted Text');
+            const reference = String(at['id'] ?? '');
+            const workType = typeof at['work_type'] === 'string' ? at['work_type'] : undefined;
+            const procedureRef = typeof at['procedure_reference'] === 'string' ? at['procedure_reference'] : undefined;
+            const scores = scoreAdoptedText(title, reference, workType, procedureRef);
             return {
-                title: String(at['title'] ?? at['label'] ?? 'Adopted Text'),
-                reference: String(at['id'] ?? ''),
-                parliamentarySignificance: ADOPTED_PARLIAMENTARY,
-                policyImpact: ADOPTED_POLICY,
-                publicInterest: ADOPTED_PUBLIC,
-                temporalUrgency: ADOPTED_URGENCY,
-                institutionalRelevance: ADOPTED_INSTITUTIONAL,
+                title,
+                reference,
+                ...scores,
             };
         }),
     ];

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

@@ -49,12 +49,42 @@ export function buildDeepAnalysisMarkdown(fetchedData, date) {
         adoptedTexts.length +
         questions.length +
         mepUpdates.length;
+    // Build a concrete list of the top adopted texts for the AI agent to analyze
+    const topAdoptedTexts = adoptedTexts
+        .slice(0, 20)
+        .map((t) => {
+        const adoptedText = t;
+        const title = String(adoptedText['title'] ?? adoptedText['label'] ?? 'Untitled');
+        const id = String(adoptedText['id'] ?? '');
+        const workType = String(adoptedText['work_type'] ?? '');
+        const procRef = String(adoptedText['procedure_reference'] ?? '');
+        return `| ${sanitizeCell(id)} | ${sanitizeCell(title.slice(0, 100))} | ${sanitizeCell(workType)} | ${sanitizeCell(procRef)} |`;
+    })
+        .join('\n');
+    const topEvents = events
+        .slice(0, 10)
+        .map((e) => {
+        const ev = e;
+        const title = String(ev['title'] ?? ev['label'] ?? 'Untitled');
+        const id = String(ev['id'] ?? ev['eventId'] ?? '');
+        return `| ${sanitizeCell(id)} | ${sanitizeCell(title.slice(0, 120))} |`;
+    })
+        .join('\n');
+    const topProcedures = procedures
+        .slice(0, 10)
+        .map((p) => {
+        const pr = p;
+        const title = String(pr['title'] ?? pr['label'] ?? 'Untitled');
+        const id = String(pr['procedureId'] ?? pr['id'] ?? '');
+        return `| ${sanitizeCell(id)} | ${sanitizeCell(title.slice(0, 120))} |`;
+    })
+        .join('\n');
     return (header +
         `# Deep Multi-Perspective Analysis
 
 ## Pipeline Data Context
 
-> **Note:** This section contains script-generated data inventory for reference. The AI agent must replace everything starting from the "AI Agent Instructions" heading below with substantive political intelligence analysis.
+> **Note:** This section contains script-generated data inventory AND concrete document references for the AI agent to analyze. The AI agent must replace everything starting from the "AI Agent Instructions" heading below with substantive political intelligence analysis.
 
 | Data Source | Count |
 |-------------|-------|
@@ -75,13 +105,35 @@ export function buildDeepAnalysisMarkdown(fetchedData, date) {
 | Citizens | ${questions.length + mepUpdates.length} (questions + MEP updates) |
 | EU Institutions | ${events.length + procedures.length} (events + procedures) |
 
+${adoptedTexts.length > 0
+            ? `### Key Adopted Texts Available for Analysis
+
+| Reference | Title | Work Type | Procedure |
+|-----------|-------|-----------|-----------|
+${topAdoptedTexts}
+`
+            : ''}${events.length > 0
+            ? `### Key Events Available for Analysis
+
+| Reference | Title |
+|-----------|-------|
+${topEvents}
+`
+            : ''}${procedures.length > 0
+            ? `### Key Procedures Available for Analysis
+
+| Reference | Title |
+|-----------|-------|
+${topProcedures}
+`
+            : ''}
 ---
 
 ## AI Agent Instructions
 
-> **Instructions for AI Agent (Opus 4.6):** Read ALL methodology documents in analysis/methodologies/ before writing. Using the data inventory above and the raw EP MCP data files, produce a deep multi-perspective analysis following the political-style-guide.md depth Level 3 format. Your analysis MUST:
+> **Instructions for AI Agent:** Read ALL methodology documents in analysis/methodologies/ before writing. Using the concrete document references above and the raw EP MCP data, produce a deep multi-perspective analysis following the political-style-guide.md depth Level 3 format. Your analysis MUST:
 >
-> 1. **Identify the 3-5 most politically significant items** from the available data, citing specific document IDs
+> 1. **Identify the 3-5 most politically significant items** from the document tables above, citing specific document IDs (e.g. TA-10-2026-0092)
 > 2. **Analyse each from ≥3 stakeholder perspectives** (Political Groups, Civil Society, Industry, National Governments, Citizens, EU Institutions)
 > 3. **Apply the SWOT framework** to the overall parliamentary activity pattern for this date
 > 4. **Assess coalition dynamics** — which groups are aligning/diverging based on the adopted texts?

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

@@ -73,10 +73,9 @@ export const ALL_ANALYSIS_METHODS = [
     // Publication scoring & synthesis
     'significance-scoring',
     'synthesis-summary',
-    // NOTE: 'document-analysis' is intentionally excluded from the default set.
-    // It writes one markdown + one JSON file per feed item and can significantly
-    // increase runtime and repository output size.  Callers must opt-in by
-    // explicitly listing it in `enabledMethods`.
+    // Per-document intelligence analysis — stores complete EP document data
+    // alongside per-document political intelligence analysis markdown files.
+    'document-analysis',
 ];
 /**
  * All valid analysis method names, including opt-in methods like

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

@@ -12,6 +12,14 @@ import { ArticleCategory } from '../../types/index.js';
 import type { LanguageCode, GenerationStats, GenerationResult } from '../../types/index.js';
 import type { ArticleStrategyBase } from '../strategies/article-strategy.js';
 import type { OutputOptions } from './output-stage.js';
+/**
+ * Set AI-provided article metadata from CLI flags.
+ * Called by the main entry point after parsing `--title=` and `--description=`.
+ *
+ * @param title - AI-analysed article title
+ * @param description - AI-analysed article description
+ */
+export declare function setAIMetadata(title: string, description: string): void;
 /** Map from {@link ArticleCategory} to its registered strategy */
 export type StrategyRegistry = Map<ArticleCategory, ArticleStrategyBase>;
 /**

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

@@ -15,6 +15,31 @@ import { monthAheadStrategy } from '../strategies/month-ahead-strategy.js';
 import { weeklyReviewStrategy } from '../strategies/weekly-review-strategy.js';
 import { monthlyReviewStrategy } from '../strategies/monthly-review-strategy.js';
 import { writeSingleArticle } from './output-stage.js';
+// ─── AI-provided metadata (set by agentic workflow via CLI flags) ────────────
+/**
+ * AI-generated article title provided by the agentic workflow.
+ * When non-empty, this OVERRIDES any script-generated title for the
+ * English version.  The AI agent (Opus 4.6) must analyse the article
+ * content and produce this — titles must NEVER be generated by code.
+ */
+let _aiTitle = '';
+/**
+ * AI-generated article description provided by the agentic workflow.
+ * When non-empty, this OVERRIDES any script-generated description for
+ * the English version.
+ */
+let _aiDescription = '';
+/**
+ * Set AI-provided article metadata from CLI flags.
+ * Called by the main entry point after parsing `--title=` and `--description=`.
+ *
+ * @param title - AI-analysed article title
+ * @param description - AI-analysed article description
+ */
+export function setAIMetadata(title, description) {
+    _aiTitle = title;
+    _aiDescription = description;
+}
 /**
  * Build the default strategy registry containing all built-in strategies.
  *
@@ -100,15 +125,21 @@ function generateSingleLanguageArticle(strategy, data, lang, dateStr, slug, outp
     const content = strategy.buildContent(data, lang);
     const baseMetadata = strategy.getMetadata(data, lang);
     // Enrich metadata by analysing the actual rendered content.
-    // This produces insightful titles, descriptions, and keywords
-    // that reflect the article's coverage — not generic template text.
-    // Title/description enrichment is English-only because the heuristics
-    // (statistic extraction, generic-heading filter) use English keywords.
-    // Language-agnostic keyword additions (committee abbreviations, etc.)
-    // are preserved for all languages.
+    // Keyword extraction (committee abbreviations, political groups) is
+    // preserved, but title and description enrichment is now subordinate
+    // to AI-provided values from --title and --description CLI flags.
+    //
+    // Architecture: The AI agent (Opus 4.6) analyses the content and
+    // provides titles/descriptions via CLI flags. Script code NEVER
+    // generates final titles or descriptions — it only provides fallbacks.
     const enrichedMetadata = enrichMetadataFromContent(content, baseMetadata);
     const metadata = lang === 'en'
-        ? enrichedMetadata
+        ? {
+            ...enrichedMetadata,
+            // AI-provided title/description ALWAYS override script-generated ones
+            title: _aiTitle || enrichedMetadata.title,
+            subtitle: _aiDescription || enrichedMetadata.subtitle,
+        }
         : {
             ...baseMetadata,
             keywords: enrichedMetadata.keywords ?? baseMetadata.keywords,

package/scripts/generators/strategies/breaking-news-strategy.js

@@ -10,7 +10,7 @@ import { buildSwotSection } from '../swot-content.js';
 import { buildDashboardSection } from '../dashboard-content.js';
 import { buildIntelligenceMindmapSection } from '../mindmap-content.js';
 import { loadAnalysisContext, buildAnalysisInsightsSection, extractAnalysisSummary, } from './article-strategy.js';
-import { pl } from '../../utils/metadata-utils.js';
+import { truncateTitle, MIN_MEANINGFUL_TITLE_LENGTH } from '../../utils/metadata-utils.js';
 /** Base keywords shared by all Breaking News articles */
 const BREAKING_NEWS_BASE_KEYWORDS = [
     'European Parliament',
@@ -58,48 +58,52 @@ function buildBreakingKeywords(feedData) {
 function buildBreakingDescription(date, feedData) {
     if (!feedData)
         return `European Parliament breaking developments for ${date}.`;
-    const counts = [];
-    if (feedData.adoptedTexts.length > 0)
-        counts.push(pl(feedData.adoptedTexts.length, 'adopted text', 'adopted texts'));
-    if (feedData.events.length > 0)
-        counts.push(pl(feedData.events.length, 'event', 'events'));
-    if (feedData.procedures.length > 0)
-        counts.push(pl(feedData.procedures.length, 'procedure', 'procedures'));
-    if (feedData.mepUpdates.length > 0)
-        counts.push(pl(feedData.mepUpdates.length, 'MEP update', 'MEP updates'));
-    if (counts.length === 0)
-        return `European Parliament breaking developments for ${date}.`;
-    const highlight = feedData.adoptedTexts[0]?.title ?? feedData.events[0]?.title ?? '';
-    const base = `EP breaking: ${counts.join(', ')}`;
-    if (highlight) {
-        const full = `${base}. Highlights: ${highlight}`;
-        return full.length > 200 ? full.slice(0, 197) + '...' : full;
+    // Priority 1: Use the title of the most significant adopted text
+    const topAdopted = feedData.adoptedTexts.find((t) => t.title && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topAdopted) {
+        const desc = `European Parliament adopts ${topAdopted.title}`;
+        return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
+    }
+    // Priority 2: Use the most significant event title
+    const topEvent = feedData.events.find((e) => e.title && e.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topEvent) {
+        const desc = `EP parliamentary event: ${topEvent.title}`;
+        return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
     }
-    return base.length > 200 ? base.slice(0, 197) + '...' : base;
+    // Priority 3: Use the most significant procedure
+    const topProc = feedData.procedures.find((p) => p.title && p.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topProc) {
+        const desc = `EP legislative procedure: ${topProc.title}`;
+        return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
+    }
+    return `European Parliament breaking developments for ${date}.`;
 }
 /**
- * Build a content-aware title suffix from feed data item counts.
+ * Build a content-aware title suffix from the most significant feed item.
+ * Uses actual legislation/event titles, not data counts.
  *
  * @param feedData - Breaking news feed data (may be undefined)
- * @returns Short suffix string for appending to the base title, or empty string
+ * @returns Short analytical suffix, or empty string
  */
 function buildBreakingTitleSuffix(feedData) {
     if (!feedData)
         return '';
-    const total = feedData.adoptedTexts.length +
-        feedData.events.length +
-        feedData.procedures.length +
-        feedData.mepUpdates.length;
-    if (total === 0)
-        return '';
-    const parts = [];
-    if (feedData.adoptedTexts.length > 0)
-        parts.push(pl(feedData.adoptedTexts.length, 'Text', 'Texts'));
-    if (feedData.events.length > 0)
-        parts.push(pl(feedData.events.length, 'Event', 'Events'));
-    if (feedData.procedures.length > 0)
-        parts.push(pl(feedData.procedures.length, 'Procedure', 'Procedures'));
-    return parts.join(', ');
+    // Priority 1: Name the most significant adopted text
+    const topAdopted = feedData.adoptedTexts.find((t) => t.title && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topAdopted) {
+        return truncateTitle(topAdopted.title);
+    }
+    // Priority 2: Name the most significant event
+    const topEvent = feedData.events.find((e) => e.title && e.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topEvent) {
+        return truncateTitle(topEvent.title);
+    }
+    // Priority 3: Name the most significant procedure
+    const topProc = feedData.procedures.find((p) => p.title && p.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topProc) {
+        return truncateTitle(topProc.title);
+    }
+    return '';
 }
 /**
  * Extract a substantive summary from an analysis file if available.

package/scripts/generators/strategies/committee-reports-strategy.js

@@ -11,7 +11,7 @@ import { buildSwotSection } from '../swot-content.js';
 import { buildDashboardSection } from '../dashboard-content.js';
 import { buildIntelligenceMindmapSection } from '../mindmap-content.js';
 import { loadAnalysisContext, buildAnalysisInsightsSection } from './article-strategy.js';
-import { pl } from '../../utils/metadata-utils.js';
+import { truncateTitle, MIN_MEANINGFUL_TITLE_LENGTH } from '../../utils/metadata-utils.js';
 /** European Parliament home-page URL used as source reference */
 const EP_SOURCE_URL = 'https://www.europarl.europa.eu';
 /** European Parliament display name for source titles and article lede */
@@ -63,48 +63,50 @@ function buildCommitteeKeywords(committeeDataList, feedData) {
  * @returns SEO-friendly description (≤ 200 chars)
  */
 function buildCommitteeDescription(committeeDataList, feedData) {
-    const activeCount = committeeDataList.filter((c) => c.chair !== PLACEHOLDER_CHAIR).length;
-    const totalDocs = committeeDataList.reduce((sum, c) => sum + c.documents.length, 0);
-    const adoptedCount = feedData?.adoptedTexts?.length ?? 0;
-    const parts = [];
-    if (activeCount > 0)
-        parts.push(`${pl(activeCount, 'committee', 'committees')} reporting`);
-    if (totalDocs > 0)
-        parts.push(pl(totalDocs, 'recent document', 'recent documents'));
-    if (adoptedCount > 0)
-        parts.push(pl(adoptedCount, 'adopted text', 'adopted texts'));
+    // Priority 1: Use the title of the most significant adopted text
+    const topAdopted = feedData?.adoptedTexts?.find((t) => t.title && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topAdopted) {
+        const abbrs = committeeDataList
+            .filter((c) => c.chair !== PLACEHOLDER_CHAIR)
+            .map((c) => c.abbreviation)
+            .join(', ');
+        const desc = abbrs
+            ? `EP committees ${abbrs}: ${topAdopted.title}`
+            : `EP committee report: ${topAdopted.title}`;
+        return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
+    }
+    // Priority 2: Name the active committees
     const abbrs = committeeDataList
         .filter((c) => c.chair !== PLACEHOLDER_CHAIR)
         .map((c) => c.abbreviation)
         .join(', ');
-    if (abbrs)
-        parts.push(`covering ${abbrs}`);
-    if (parts.length === 0) {
-        return 'Analysis of recent legislative output, effectiveness metrics, and key committee activities';
+    if (abbrs) {
+        return `European Parliament committee activity report covering ${abbrs}`;
     }
-    const desc = `EP committee activity: ${parts.join('; ')}.`;
-    return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
+    return 'Analysis of recent legislative output, effectiveness metrics, and key committee activities';
 }
 /**
- * Build a content-aware title suffix from committee data counts.
+ * Build a content-aware title suffix from the most significant
+ * committee item.  Uses actual legislation titles, not data counts.
  *
  * @param committeeDataList - Fetched committee data
  * @param feedData - EP feed data (may be undefined)
- * @returns Short suffix for the title, or empty string
+ * @returns Short analytical suffix, or empty string
  */
 function buildCommitteeTitleSuffix(committeeDataList, feedData) {
-    const activeCount = committeeDataList.filter((c) => c.chair !== PLACEHOLDER_CHAIR).length;
-    const totalDocs = committeeDataList.reduce((sum, c) => sum + c.documents.length, 0);
-    const adoptedCount = feedData?.adoptedTexts?.length ?? 0;
-    const parts = [];
-    if (totalDocs > 0)
-        parts.push(pl(totalDocs, 'Document', 'Documents'));
-    if (adoptedCount > 0)
-        parts.push(pl(adoptedCount, 'Adopted Text', 'Adopted Texts'));
-    if (activeCount > 0 && parts.length === 0) {
-        parts.push(pl(activeCount, 'Active Committee', 'Active Committees'));
+    // Priority 1: Name the most significant adopted text
+    const topAdopted = feedData?.adoptedTexts?.find((t) => t.title && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topAdopted) {
+        return truncateTitle(topAdopted.title);
+    }
+    // Priority 2: List active committee abbreviations
+    const activeAbbrs = committeeDataList
+        .filter((c) => c.chair !== PLACEHOLDER_CHAIR)
+        .map((c) => c.abbreviation);
+    if (activeAbbrs.length > 0) {
+        return activeAbbrs.slice(0, 5).join(', ');
     }
-    return parts.join(', ');
+    return '';
 }
 // Keyword lists are pre-normalized to lowercase so that each call to
 // categorizeAdoptedText only needs to lowercase the title once.

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

@@ -10,7 +10,7 @@ import { buildSwotSection } from '../swot-content.js';
 import { buildDashboardSection } from '../dashboard-content.js';
 import { buildIntelligenceMindmapSection } from '../mindmap-content.js';
 import { loadAnalysisContext, buildAnalysisInsightsSection } from './article-strategy.js';
-import { pl } from '../../utils/metadata-utils.js';
+import { pl, truncateTitle, MIN_MEANINGFUL_TITLE_LENGTH } from '../../utils/metadata-utils.js';
 import { isPlaceholderText } from '../../constants/analysis-constants.js';
 /** Base keywords shared by all Motions articles */
 const MOTIONS_BASE_KEYWORDS = [
@@ -58,52 +58,52 @@ function buildMotionsKeywords(data) {
 }
 /**
  * Build a content-aware description from motions data.
- * Summarises voting record count, anomaly count, and key vote highlights.
+ * Prioritises the most significant adopted text or voting record title
+ * to produce a description that reflects political substance rather
+ * than mechanical data counts.
  *
  * @param data - Motions article data payload
  * @returns SEO-friendly description (≤ 200 chars)
  */
 function buildMotionsDescription(data) {
-    const parts = [];
-    if (data.votingRecords.length > 0)
-        parts.push(`${pl(data.votingRecords.length, 'vote', 'votes')} analysed`);
-    if (data.anomalies.length > 0)
-        parts.push(`${pl(data.anomalies.length, 'anomaly', 'anomalies')} detected`);
-    if (data.questions.length > 0)
-        parts.push(pl(data.questions.length, 'parliamentary question', 'parliamentary questions'));
-    const adoptedCount = data.feedData?.adoptedTexts?.length ?? 0;
-    if (adoptedCount > 0)
-        parts.push(pl(adoptedCount, 'adopted text', 'adopted texts'));
-    if (parts.length === 0) {
-        return `European Parliament plenary votes and resolutions from ${data.dateFromStr} to ${data.date}.`;
+    // Priority 1: Use the title of the most significant adopted text
+    const topAdopted = data.feedData?.adoptedTexts?.find((t) => t.title && !isPlaceholderText(t.title));
+    if (topAdopted) {
+        const desc = `European Parliament adopts ${topAdopted.title}`;
+        return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
     }
-    const highlight = data.votingRecords[0]?.title ?? '';
-    const base = `EP voting analysis: ${parts.join(', ')}`;
-    if (highlight) {
-        const full = `${base}. Key vote: ${highlight}`;
-        return full.length > 200 ? full.slice(0, 197) + '...' : full;
+    // Priority 2: Use the title of the key voting record
+    const topVote = data.votingRecords.find((v) => v.title);
+    if (topVote) {
+        const desc = `EP plenary vote: ${topVote.title}`;
+        return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
     }
-    return base.length > 200 ? base.slice(0, 197) + '...' : base;
+    return `European Parliament plenary votes and resolutions from ${data.dateFromStr} to ${data.date}.`;
 }
 /**
- * Build a content-aware title suffix from motions data counts.
+ * Build a content-aware title suffix from the most significant
+ * motions item.  Produces an analytical phrase describing the
+ * primary political content, not data counts.
  *
  * @param data - Motions article data payload
- * @returns Short suffix for the title, or empty string
+ * @returns Short analytical suffix for the title, or empty string
  */
 function buildMotionsTitleSuffix(data) {
-    const parts = [];
-    if (data.votingRecords.length > 0) {
-        parts.push(pl(data.votingRecords.length, 'Vote', 'Votes'));
+    // Priority 1: Name the most significant adopted text
+    const topAdopted = data.feedData?.adoptedTexts?.find((t) => t.title && !isPlaceholderText(t.title) && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topAdopted) {
+        return truncateTitle(topAdopted.title);
     }
-    if (data.anomalies.length > 0) {
-        parts.push(pl(data.anomalies.length, 'Anomaly', 'Anomalies'));
+    // Priority 2: Name the key voting record
+    const topVote = data.votingRecords.find((v) => v.title && v.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topVote) {
+        return truncateTitle(topVote.title);
     }
-    const adoptedCount = data.feedData?.adoptedTexts?.length ?? 0;
-    if (adoptedCount > 0) {
-        parts.push(pl(adoptedCount, 'Adopted Text', 'Adopted Texts'));
+    // Priority 3 (last resort): If we only have anomalies, mention those
+    if (data.anomalies.length > 0) {
+        return `${pl(data.anomalies.length, 'Voting Anomaly', 'Voting Anomalies')} Detected`;
     }
-    return parts.join(', ');
+    return '';
 }
 /** Number of days to look back when fetching motions data */
 const MOTIONS_LOOKBACK_DAYS = 30;

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

@@ -11,7 +11,7 @@ import { buildSwotSection } from '../swot-content.js';
 import { buildDashboardSection } from '../dashboard-content.js';
 import { buildIntelligenceMindmapSection } from '../mindmap-content.js';
 import { loadAnalysisContext, buildAnalysisInsightsSection } from './article-strategy.js';
-import { pl } from '../../utils/metadata-utils.js';
+import { truncateTitle, MIN_MEANINGFUL_TITLE_LENGTH } from '../../utils/metadata-utils.js';
 /** Base keywords shared by all Propositions articles */
 const PROPOSITIONS_BASE_KEYWORDS = [
     'European Parliament',
@@ -58,47 +58,39 @@ function buildPropositionsKeywords(data) {
  * @returns SEO-friendly description (≤ 200 chars)
  */
 function buildPropositionsDescription(data) {
-    const parts = [];
-    const procCount = data.feedData?.procedures?.length ?? 0;
-    const adoptedCount = data.feedData?.adoptedTexts?.length ?? 0;
-    // Count proposals by the number of proposal-card divs in the HTML
-    const proposalMatches = data.proposalsHtml.match(/proposal-card/gu);
-    const proposalCount = proposalMatches ? proposalMatches.length : 0;
-    if (proposalCount > 0)
-        parts.push(`${proposalCount} active proposals`);
-    if (procCount > 0)
-        parts.push(`${procCount} procedures tracked`);
-    if (adoptedCount > 0)
-        parts.push(`${adoptedCount} recently adopted texts`);
-    if (data.pipelineData) {
-        const healthPct = Math.round(data.pipelineData.healthScore * 100);
-        parts.push(`pipeline health ${healthPct}%`);
+    // Priority 1: Use the title of the most significant adopted text
+    const topAdopted = data.feedData?.adoptedTexts?.find((t) => t.title && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topAdopted) {
+        const desc = `European Parliament legislative tracker: ${topAdopted.title}`;
+        return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
     }
-    if (parts.length === 0) {
-        return 'Recent legislative proposals, procedure tracking, and pipeline status in the European Parliament';
+    // Priority 2: Use the title of the most significant procedure
+    const topProc = data.feedData?.procedures?.find((p) => p.title && p.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topProc) {
+        const desc = `EP legislative procedure: ${topProc.title}`;
+        return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
     }
-    const desc = `EP legislative tracker: ${parts.join(', ')}.`;
-    return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
+    return 'Recent legislative proposals, procedure tracking, and pipeline status in the European Parliament';
 }
 /**
- * Build a content-aware title suffix from propositions data.
+ * Build a content-aware title suffix from the most significant
+ * propositions item.  Uses actual procedure/text titles, not counts.
  *
  * @param data - Propositions article data payload
- * @returns Short suffix for the title, or empty string
+ * @returns Short analytical suffix for the title, or empty string
  */
 function buildPropositionsTitleSuffix(data) {
-    const parts = [];
-    const procCount = data.feedData?.procedures?.length ?? 0;
-    const adoptedCount = data.feedData?.adoptedTexts?.length ?? 0;
-    if (procCount > 0)
-        parts.push(pl(procCount, 'Procedure', 'Procedures'));
-    if (adoptedCount > 0)
-        parts.push(pl(adoptedCount, 'Adopted Text', 'Adopted Texts'));
-    if (data.pipelineData && parts.length === 0) {
-        const healthPct = Math.round(data.pipelineData.healthScore * 100);
-        parts.push(`Pipeline ${healthPct}%`);
+    // Priority 1: Name the most significant adopted text
+    const topAdopted = data.feedData?.adoptedTexts?.find((t) => t.title && t.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topAdopted) {
+        return truncateTitle(topAdopted.title);
+    }
+    // Priority 2: Name the most significant procedure
+    const topProc = data.feedData?.procedures?.find((p) => p.title && p.title.length > MIN_MEANINGFUL_TITLE_LENGTH);
+    if (topProc) {
+        return truncateTitle(topProc.title);
     }
-    return parts.join(', ');
+    return '';
 }
 /**
  * Build procedures and adopted-texts HTML separately from EP feed data when

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

@@ -26,6 +26,40 @@ const STATS_FALLBACK = '{"stats": null}';
 const PROCEDURE_EVENT_FALLBACK = '{"event": null}';
 /** Fallback payload for server health status */
 const SERVER_HEALTH_FALLBACK = '{"server": null, "feeds": []}';
+/**
+ * Classify an error message into a diagnostic error category, aligned with
+ * EP MCP Server v1.2.1 standardized error categories.
+ *
+ * Priority:
+ * 1. Gateway 5xx → SERVER_ERROR (not TIMEOUT, even for 504 "Gateway Timeout")
+ * 2. 429 / rate-limit → RATE_LIMIT
+ * 3. 404 → NOT_FOUND
+ * 4. Client-side timeout → TIMEOUT
+ * 5. Everything else → UNKNOWN
+ *
+ * @param message - Raw error message
+ * @returns Diagnostic error category string
+ */
+function classifyToolError(message) {
+    const lowerMsg = message.toLowerCase();
+    if (lowerMsg.includes('gateway timeout') ||
+        lowerMsg.includes('gateway error 500') ||
+        lowerMsg.includes('gateway error 502') ||
+        lowerMsg.includes('gateway error 503') ||
+        lowerMsg.includes('gateway error 504')) {
+        return 'SERVER_ERROR';
+    }
+    if (lowerMsg.includes('429') ||
+        lowerMsg.includes('rate limit') ||
+        lowerMsg.includes('too many requests')) {
+        return 'RATE_LIMIT';
+    }
+    if (lowerMsg.includes('404'))
+        return 'NOT_FOUND';
+    if (lowerMsg.includes('timeout'))
+        return 'TIMEOUT';
+    return 'UNKNOWN';
+}
 /**
  * MCP Client for European Parliament data access.
  * Extends {@link MCPConnection} with EP-specific tool wrapper methods.
@@ -63,22 +97,7 @@ export class EuropeanParliamentMCPClient extends MCPConnection {
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
-            const lowerMsg = message.toLowerCase();
-            // Classify the error for better diagnostics.
-            // Check gateway 5xx first — a "504 Gateway Timeout" should be SERVER_ERROR,
-            // not TIMEOUT (which is reserved for client-side request timeouts).
-            const isGatewayServerError = lowerMsg.includes('gateway timeout') ||
-                lowerMsg.includes('gateway error 500') ||
-                lowerMsg.includes('gateway error 502') ||
-                lowerMsg.includes('gateway error 503') ||
-                lowerMsg.includes('gateway error 504');
-            const errorType = isGatewayServerError
-                ? 'SERVER_ERROR'
-                : lowerMsg.includes('404')
-                    ? 'NOT_FOUND'
-                    : lowerMsg.includes('timeout')
-                        ? 'TIMEOUT'
-                        : 'UNKNOWN';
+            const errorType = classifyToolError(message);
             this._failedTools.set(toolName, `${errorType}: ${message}`);
             console.warn(`⚠️ ${toolName} failed [${errorType}]:`, message);
             return { content: [{ type: 'text', text: fallbackText }] };

package/scripts/templates/article-template.js

@@ -161,6 +161,21 @@ export function generateArticleHTML(options) {
             url: SITE_BASE_URL,
         },
         keywords: keywords.join(', '),
+        about: {
+            '@type': 'GovernmentOrganization',
+            name: 'European Parliament',
+            url: 'https://www.europarl.europa.eu',
+        },
+        isBasedOn: sources.length > 0
+            ? sources
+                .filter((s) => typeof s.url === 'string' && /^https?:\/\//i.test(s.url))
+                .slice(0, 5)
+                .map((s) => ({
+                '@type': 'Dataset',
+                name: s.title,
+                url: s.url,
+            }))
+            : undefined,
         mainEntityOfPage: {
             '@type': 'WebPage',
             '@id': `${SITE_BASE_URL}/news/${date}-${slug}-${lang}.html`,

package/scripts/utils/content-metadata.js

@@ -2,6 +2,14 @@
 // SPDX-License-Identifier: Apache-2.0
 /** Maximum length for the enriched description */
 const MAX_DESCRIPTION_LENGTH = 200;
+/**
+ * Minimum position (as fraction of MAX_DESCRIPTION_LENGTH) for a
+ * sentence-boundary truncation point.  If the last sentence break
+ * is before this threshold, we fall back to hard truncation with `...`.
+ * This ensures the truncated description retains at least half its
+ * intended content.
+ */
+const MIN_SENTENCE_TRUNCATION_RATIO = 0.5;
 /** Maximum number of keywords to emit */
 const MAX_KEYWORDS = 15;
 /** Minimum heading length to include as keyword */
@@ -174,8 +182,26 @@ function extractContentKeywords(content, baseKeywords) {
     return [...new Set(keywords)].slice(0, MAX_KEYWORDS);
 }
 /**
- * Build a content-aware title by analysing the article body for key
- * highlights and appending the most significant finding as a suffix.
+ * Patterns that indicate a heading is a generic section label (not
+ * analytical content suitable for a title suffix).
+ */
+const GENERIC_HEADING_PATTERN = /^(introduction|overview|analysis|conclusion|summary|background|context|key\s+findings|methodology|data\s+sources|voting\s+records|parliamentary\s+questions|about|feed\s+health|analysis\s+pipeline|analysis\s+&\s+transparency|stakeholder|dashboard|pipeline\s+snapshot|political\s+intelligence|further\s+reading|related|appendix|table\s+of\s+contents|deep\s+analysis)/iu;
+/**
+ * Patterns indicating a heading contains analytical/political content
+ * (e.g., specific legislation names, political dynamics, policy topics).
+ */
+const ANALYTICAL_HEADING_PATTERN = /(?:directive|regulation|resolution|reform|crisis|alliance|coalition|division|bloc|breakthrough|deadlock|amendment|trilogue|committee|parliament|council|commission|veto|mandate|sovereignty|trade|climate|digital|security|defense|defence|budget|migration|energy|sanctions|treaty|accession|withdrawal|election|referendum|impeach|censure|confidence|no.confidence)/iu;
+/**
+ * Build a content-aware title by extracting the most politically
+ * significant heading or analytical finding from the article body.
+ *
+ * **Priority order** (per ai-driven-analysis-guide Rule 9):
+ * 1. Analytical headings containing political/legislative substance
+ * 2. Non-generic section headings with meaningful length
+ * 3. Data statistics as a last resort only
+ *
+ * This ensures titles reflect AI-analysed political intelligence
+ * rather than mechanical data counts like "5 Votes, 2 Anomalies".
  *
  * @param content - Article HTML body
  * @param baseTitle - Localized base title from the strategy
@@ -186,26 +212,35 @@ function buildContentTitle(content, baseTitle) {
     if (baseTitle.includes('—'))
         return baseTitle;
     const headings = extractHeadings(content);
+    // Priority 1: Find a heading with real political/legislative substance
+    const analyticalHeading = headings.find((h) => h.length > 12 &&
+        h.length <= 80 &&
+        ANALYTICAL_HEADING_PATTERN.test(h) &&
+        !GENERIC_HEADING_PATTERN.test(h));
+    if (analyticalHeading) {
+        return `${baseTitle} — ${analyticalHeading}`;
+    }
+    // Priority 2: Find any non-generic heading with meaningful length
+    const topHeading = headings.find((h) => h.length > 12 && h.length <= 80 && !GENERIC_HEADING_PATTERN.test(h));
+    if (topHeading) {
+        return `${baseTitle} — ${topHeading}`;
+    }
+    // Priority 3 (last resort): Use a key statistic — but only when no
+    // analytical heading is available
     const stats = extractStatistics(content);
-    // Build a suffix from the first meaningful statistic
     const topStat = stats[0];
-    // Build a suffix from the first heading that isn't a generic section label
-    const topHeading = headings.find((h) => h.length > 10 &&
-        !/^(introduction|overview|analysis|conclusion|summary|background|context)/iu.test(h));
-    if (topStat && topHeading) {
-        return `${baseTitle} — ${topStat}, ${topHeading}`;
-    }
     if (topStat) {
         return `${baseTitle} — ${topStat}`;
     }
-    if (topHeading) {
-        return `${baseTitle} — ${topHeading}`;
-    }
     return baseTitle;
 }
 /**
- * Build a content-aware description by extracting the lede paragraph
- * from the article body.  Falls back to the strategy-provided subtitle.
+ * Build a content-aware description by extracting the AI-written lede
+ * paragraph from the article body.  The lede should contain the
+ * political significance of the article content — not data counts.
+ *
+ * Falls back to the strategy-provided subtitle only when no
+ * substantive lede paragraph is found.
  *
  * @param content - Article HTML body
  * @param baseSubtitle - Subtitle from the strategy as fallback
@@ -214,9 +249,17 @@ function buildContentTitle(content, baseTitle) {
 function buildContentDescription(content, baseSubtitle) {
     const lede = extractLede(content);
     if (lede.length > 30) {
-        return lede.length > MAX_DESCRIPTION_LENGTH
-            ? lede.slice(0, MAX_DESCRIPTION_LENGTH - 3) + '...'
-            : lede;
+        // Truncate at sentence boundary when possible for clean SEO descriptions
+        if (lede.length > MAX_DESCRIPTION_LENGTH) {
+            const truncated = lede.slice(0, MAX_DESCRIPTION_LENGTH - 3);
+            // Find the last sentence boundary (period, exclamation, or question mark followed by space)
+            const lastSentence = Math.max(truncated.lastIndexOf('. '), truncated.lastIndexOf('! '), truncated.lastIndexOf('? '));
+            if (lastSentence > MAX_DESCRIPTION_LENGTH * MIN_SENTENCE_TRUNCATION_RATIO) {
+                return truncated.slice(0, lastSentence + 1);
+            }
+            return truncated + '...';
+        }
+        return lede;
     }
     return baseSubtitle;
 }

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

@@ -1,7 +1,5 @@
-/**
- * @module Utils/MetadataUtils
- * @description Shared helpers for article metadata generation.
- */
+/** Minimum title length to be considered meaningful (not placeholder) */
+export declare const MIN_MEANINGFUL_TITLE_LENGTH = 10;
 /**
  * Return singular or plural form based on count.
  *
@@ -11,4 +9,13 @@
  * @returns `"N singular"` or `"N plural"`
  */
 export declare function pl(n: number, singular: string, plural: string): string;
+/**
+ * Truncate a title string to the suffix length limit with ellipsis.
+ * Used by all strategy title suffix builders for consistent truncation.
+ *
+ * @param title - Title string to truncate
+ * @param maxLength - Maximum length (default: {@link MAX_SUFFIX_LENGTH})
+ * @returns Truncated title with `...` suffix if over limit, else unchanged
+ */
+export declare function truncateTitle(title: string, maxLength?: number): string;
 //# sourceMappingURL=metadata-utils.d.ts.map

package/scripts/utils/metadata-utils.js

@@ -4,6 +4,10 @@
  * @module Utils/MetadataUtils
  * @description Shared helpers for article metadata generation.
  */
+/** Maximum length for a title suffix before truncation */
+const MAX_SUFFIX_LENGTH = 60;
+/** Minimum title length to be considered meaningful (not placeholder) */
+export const MIN_MEANINGFUL_TITLE_LENGTH = 10;
 /**
  * Return singular or plural form based on count.
  *
@@ -15,4 +19,17 @@
 export function pl(n, singular, plural) {
     return `${n} ${n === 1 ? singular : plural}`;
 }
+/**
+ * Truncate a title string to the suffix length limit with ellipsis.
+ * Used by all strategy title suffix builders for consistent truncation.
+ *
+ * @param title - Title string to truncate
+ * @param maxLength - Maximum length (default: {@link MAX_SUFFIX_LENGTH})
+ * @returns Truncated title with `...` suffix if over limit, else unchanged
+ */
+export function truncateTitle(title, maxLength = MAX_SUFFIX_LENGTH) {
+    if (title.length <= maxLength)
+        return title;
+    return title.slice(0, maxLength - 3) + '...';
+}
 //# sourceMappingURL=metadata-utils.js.map

package/scripts/utils/significance-scoring.d.ts

@@ -17,9 +17,9 @@
  *
  * | Composite | Decision |
  * |-----------|----------|
- * | 0.0 – 3.9 | skip     |
- * | 4.0 – 5.9 | hold     |
- * | ≥ 6.0     | publish  |
+ * | 0.0 – 3.4 | skip     |
+ * | 3.5 – 5.4 | hold     |
+ * | ≥ 5.5     | publish  |
  *
  * @see analysis/templates/significance-scoring.md
  */
@@ -35,9 +35,9 @@ export declare const WEIGHT_URGENCY = 0.15;
 /** Weight applied to Institutional / Cross-Group Relevance dimension */
 export declare const WEIGHT_INSTITUTIONAL = 0.15;
 /** Composite score at or above which the decision is "publish" */
-export declare const THRESHOLD_PUBLISH = 6;
+export declare const THRESHOLD_PUBLISH = 5.5;
 /** Composite score at or above which the decision is "hold" (below publish) */
-export declare const THRESHOLD_HOLD = 4;
+export declare const THRESHOLD_HOLD = 3.5;
 /**
  * Clamp a numeric value to the 0–10 scoring range.
  *

package/scripts/utils/significance-scoring.js

@@ -49,9 +49,9 @@ const SCORE_MIN = 0;
 /** Maximum score ceiling (dimension and composite) */
 const SCORE_MAX = 10;
 /** Composite score at or above which the decision is "publish" */
-export const THRESHOLD_PUBLISH = 6.0;
+export const THRESHOLD_PUBLISH = 5.5;
 /** Composite score at or above which the decision is "hold" (below publish) */
-export const THRESHOLD_HOLD = 4.0;
+export const THRESHOLD_HOLD = 3.5;
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 /**
  * Clamp a numeric value to the 0–10 scoring range.