Interface ArticleStrategy<TData>

Strategy interface for article generation.

Each concrete implementation handles one ArticleCategory:

module:Generators/Strategies/WeekAheadStrategy
module:Generators/Strategies/BreakingNewsStrategy
module:Generators/Strategies/CommitteeReportsStrategy
module:Generators/Strategies/PropositionsStrategy
module:Generators/Strategies/MotionsStrategy

interface ArticleStrategy<TData extends ArticleData = ArticleData> {
    type: ArticleCategory;
    requiredMCPTools: readonly string[];
    shouldSkip?(data: ArticleData): boolean;
    fetchData(
        client: EuropeanParliamentMCPClient | null,
        date: string,
    ): Promise<TData>;
    buildContent(data: TData, lang: LanguageCode): string;
    getMetadata(data: TData, lang: LanguageCode): ArticleMetadata;
}

Type Parameters

TData extends ArticleData = ArticleData
Concrete data payload type returned by fetchData

Hierarchy (View Summary)

ArticleStrategyBase
- ArticleStrategy

Implemented by

Index

Methods

shouldSkip? fetchData buildContent getMetadata

Properties

type requiredMCPTools

Methods

`Optional`shouldSkip

shouldSkip?(data: ArticleData): boolean
Optional guard that lets a strategy opt out of generation when the fetched data contains only placeholder / fallback values (e.g. MCP unavailable). When true is returned the orchestrator skips writing all language variants and logs a notice rather than publishing empty placeholder articles.

Strategies that do not implement this method are treated as always wanting to generate (i.e. the default is false).
Parameters
- data: ArticleData
  Data payload returned by fetchData
Returns boolean
true when all fetched data is placeholder and generation should be skipped
Inherited from ArticleStrategyBase.shouldSkip
- Defined in generators/strategies/article-strategy.ts:680

fetchData

fetchData(
client: EuropeanParliamentMCPClient | null,
date: string,
): Promise<TData>
Fetch all domain data needed to render this article type.
Parameters
- client: EuropeanParliamentMCPClient | null
  Connected MCP client, or null when MCP is unavailable
- date: string
  ISO 8601 publication date (YYYY-MM-DD)
Returns Promise<TData>
Populated article data payload
Overrides ArticleStrategyBase.fetchData
- Defined in generators/strategies/article-strategy.ts:705

buildContent

buildContent(data: TData, lang: LanguageCode): string
Build the article HTML body for the given language.
Parameters
- data: TData
  Data payload returned by fetchData
- lang: LanguageCode
  Target language code
Returns string
Article body HTML string
Overrides ArticleStrategyBase.buildContent
- Defined in generators/strategies/article-strategy.ts:713

getMetadata

getMetadata(data: TData, lang: LanguageCode): ArticleMetadata
Return title, subtitle, keywords, and sources for the given language.
Parameters
- data: TData
  Data payload returned by fetchData
- lang: LanguageCode
  Target language code
Returns ArticleMetadata
Article metadata
Overrides ArticleStrategyBase.getMetadata
- Defined in generators/strategies/article-strategy.ts:721

Properties

`Readonly`type

type: ArticleCategory

The article category this strategy handles

`Readonly`requiredMCPTools

requiredMCPTools: readonly string[]

Names of MCP tools this strategy calls