clawfort/openspec/changes/archive/2026-02-13-p04-summary/tasks.md

1. Summary Data Model and Persistence

• 1.1 Add persisted summary fields for TL;DR bullets, summary body, source/citation, and summary image metadata
• 1.2 Update database initialization/migration path for summary-related storage changes
• 1.3 Add repository read/write helpers for structured summary artifact fields

2. Ingestion-Time Summary Generation

• 2.1 Extend ingestion flow to request structured TL;DR + summary output from Perplexity for each fetched article
• 2.2 Implement strict parser/validator for summary output schema used by the frontend template
• 2.3 Persist generated summary artifacts with article records during the same ingestion cycle
• 2.4 Add graceful fallback behavior when summary generation fails without blocking article availability

3. Royalty-Free Image Enrichment

• 3.1 Implement royalty-free image retrieval for summarized articles with relevance constraints
• 3.2 Prefer MCP-based image retrieval path when available
• 3.3 Implement deterministic non-MCP fallback image path and placeholder behavior
• 3.4 Persist image attribution/licensing metadata required for compliant display

4. API Delivery for Summary Modal

• 4.1 Extend API response payloads to include summary-modal-ready fields
• 4.2 Ensure API payload contract maps directly to required template sections
• 4.3 Preserve source and citation link-out data in API responses

5. Frontend Summary Modal Experience

• 5.1 Implement summary modal dialog component in landing page flow
• 5.2 Render modal using required order: image, TL;DR bullets, summary, source/citation, Powered by Perplexity
• 5.3 Add article-level trigger to open summary modal from feed interactions
• 5.4 Implement robust modal close behavior (close control + backdrop interaction)

6. Analytics Event Tagging

• 6.1 Emit Umami event on summary modal open with article context
• 6.2 Emit Umami event on summary modal close with article context when available
• 6.3 Emit Umami event on source/citation link-out from modal with source metadata
• 6.4 Validate event naming and payload consistency across repeated interactions

7. Validation and Documentation

• 7.1 Validate end-to-end summary generation, persistence, and modal rendering for new articles
• 7.2 Validate fallback behavior for summary/image retrieval failures
• 7.3 Validate source/citation visibility and external link behavior in modal
• 7.4 Update README with summary modal feature behavior and analytics event contract