clawfort/openspec/specs/context-aware-image-selection-recovery/spec.md

Purpose

Canonical specification for context-aware-image-selection-recovery requirements synced from OpenSpec change deltas.

Requirements

Requirement: Context-aware image query generation

Image refetch SHALL construct provider queries from article context by identifying main subject keywords from headline and summary content.

Scenario: Context-enriched query

• WHEN a queued article is processed for image refetch
• THEN the system derives main-subject query terms from article headline and summary
• AND includes relevance-supporting cues for improved candidate quality

Requirement: AI-domain fallback keywords

When context extraction is insufficient or confidence is low, the system SHALL use AI-domain fallback keywords.

Scenario: Empty or weak context extraction

• WHEN extracted context terms are empty or below quality threshold
• THEN the system applies fallback terms such as ai, machine learning, deep learning
• AND continues candidate search with deterministic fallback ordering

Requirement: Generic AI fallback image on terminal failure

If no usable provider image is returned, the system SHALL assign a generic AI fallback image.

Scenario: Provider chain exhaustion

• WHEN all provider attempts fail or return unusable images
• THEN the system stores a generic AI fallback image for the article