bulk commit changes!

openspec/specs/royalty-free-image-enrichment/spec.md

@@ -0,0 +1,26 @@
+## Purpose
+
+Canonical specification for royalty-free-image-enrichment requirements synced from OpenSpec change deltas.
+
+## Requirements
+
+### Requirement: System enriches summaries with appropriate royalty-free images
+The system SHALL attach an appropriate royalty-free image to each summarized article.
+
+#### Scenario: Successful royalty-free image retrieval
+- **WHEN** summary generation succeeds for an article
+- **THEN** the system retrieves an appropriate royalty-free image for that article context
+- **AND** stores image URL and attribution metadata for rendering
+
+#### Scenario: MCP-preferred retrieval path
+- **WHEN** MCP image integration is available in runtime
+- **THEN** the system uses MCP-based retrieval as the preferred image sourcing path
+- **AND** falls back to configured non-MCP royalty-free source path when MCP retrieval fails or is unavailable
+
+### Requirement: Image retrieval failures do not block article availability
+The system SHALL remain resilient when image sourcing fails.
+
+#### Scenario: Image fallback behavior
+- **WHEN** no suitable royalty-free image can be retrieved
+- **THEN** the article summary remains available for modal display
+- **AND** UI uses configured placeholder/fallback image behavior