clawfort/openspec/specs/alternative-image-selection-and-dedupe/spec.md

Purpose

Canonical specification for alternative-image-selection-and-dedupe requirements synced from OpenSpec change deltas.

Requirements

Requirement: Refetch selects an alternative image for target article

Refetch operations SHALL select an image different from the article's current summary image when a usable alternative exists.

Scenario: Current image is excluded from candidate result

• WHEN refetch evaluates image candidates for an article
• THEN the system rejects candidates matching the current summary image identity
• AND stores a different accepted image candidate when available

Requirement: Candidate filtering enforces topical relevance and safety

Refetch candidate selection SHALL reject clearly unrelated imagery classes while preserving topic relevance.

Scenario: Unrelated animal/pet candidate is rejected

• WHEN candidate metadata or source signals indicate unrelated animal/pet imagery
• THEN the system rejects that candidate for article refetch
• AND continues evaluating other candidates or fallback paths

Requirement: Low-confidence selection falls back to AI-themed default

If no candidate satisfies relevance and safety thresholds, the system SHALL use deterministic AI-themed fallback imagery.

Scenario: All candidates rejected

• WHEN candidate evaluation exhausts without an accepted image
• THEN the system assigns configured AI-themed fallback image
• AND records fallback decision path in command output/logs