bulk commit changes!

openspec/changes/archive/2026-02-13-p04-summary/specs/article-tldr-summary/spec.md

@@ -0,0 +1,22 @@
+## ADDED Requirements
+
+### Requirement: System generates structured TL;DR summary for each fetched article
+The system SHALL generate a concise summary artifact for each newly fetched article using Perplexity during ingestion.
+
+#### Scenario: Successful summary generation
+- **WHEN** a new article is accepted in ingestion
+- **THEN** the system generates TL;DR bullet points and a concise summary body
+- **AND** output is persisted in a structured, template-compatible format
+
+#### Scenario: Summary generation fallback
+- **WHEN** summary generation fails for an article
+- **THEN** ingestion continues without failing the entire cycle
+- **AND** the article remains available with existing non-summary content
+
+### Requirement: Summary storage includes citation and source context
+The system SHALL persist source/citation information needed to render summary provenance.
+
+#### Scenario: Persist source and citation metadata
+- **WHEN** summary content is stored
+- **THEN** associated source/citation fields are stored with the article summary artifact
+- **AND** response payloads can render a "Source and Citation" section

openspec/changes/archive/2026-02-13-p04-summary/specs/royalty-free-image-enrichment/spec.md

@@ -0,0 +1,22 @@
+## ADDED 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

openspec/changes/archive/2026-02-13-p04-summary/specs/summary-analytics-tagging/spec.md

@@ -0,0 +1,22 @@
+## ADDED Requirements
+
+### Requirement: Modal interactions are tagged for analytics
+The system SHALL emit Umami analytics events for summary modal open and close actions.
+
+#### Scenario: Modal open event tagging
+- **WHEN** a user opens the summary modal
+- **THEN** the system emits a modal-open Umami event
+- **AND** event payload includes article context identifier
+
+#### Scenario: Modal close event tagging
+- **WHEN** a user closes the summary modal
+- **THEN** the system emits a modal-close Umami event
+- **AND** event payload includes article context identifier when available
+
+### Requirement: Source link-out interactions are tagged for analytics
+The system SHALL emit Umami analytics events for source/citation link-outs from summary modal.
+
+#### Scenario: Source link-out event tagging
+- **WHEN** a user clicks source/citation link in summary modal
+- **THEN** the system emits a link-out Umami event before or at navigation trigger
+- **AND** event includes source URL or source identifier metadata

openspec/changes/archive/2026-02-13-p04-summary/specs/summary-modal-experience/spec.md

@@ -0,0 +1,22 @@
+## ADDED Requirements
+
+### Requirement: Summary is rendered in a modal dialog using standard template
+The system SHALL render article summary content in a modal dialog using the required structure.
+
+#### Scenario: Open summary modal
+- **WHEN** a user triggers summary view for an article
+- **THEN** a modal dialog opens and displays content in this order: relevant image, TL;DR bullets, summary body, source and citation, and "Powered by Perplexity"
+- **AND** modal content corresponds to the selected article
+
+#### Scenario: Close summary modal
+- **WHEN** a user closes the modal via close control or backdrop interaction
+- **THEN** the modal is dismissed cleanly
+- **AND** user returns to previous feed context without page navigation
+
+### Requirement: Modal content preserves source link-out behavior
+The system SHALL provide source link-outs from the summary modal.
+
+#### Scenario: Source link-out from modal
+- **WHEN** a user clicks source/citation link in the modal
+- **THEN** the original source opens in a new tab/window
+- **AND** modal behavior remains stable for continued browsing