Files
clawfort/openspec/changes/p17-regression-defects/specs/summary-modal-experience/spec.md
Santhosh Janardhanan e2406bf978
Some checks failed
quality-gates / lint-and-test (push) Has been cancelled
quality-gates / security-scan (push) Has been cancelled
Pushing to live
2026-02-13 10:19:01 -05:00

2.1 KiB

MODIFIED 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 and SHALL preserve consistent behavior across entry paths validated by Playwright interaction tests.

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
  • WHEN page is loaded with a valid article permalink state
  • THEN the modal opens for the linked article without requiring manual click

Scenario: Keyboard dismissal and focus continuity

  • WHEN the modal is open and the user presses Escape
  • THEN the modal closes deterministically
  • AND focus returns to a stable, previously active control

The system SHALL provide source link-outs from the summary modal and keep share interactions stable.

  • 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

Scenario: Modal exposes share entry points

  • WHEN a summary modal is open for an article
  • THEN share controls for the article permalink are available from modal/footer share area

Scenario: Modal interaction regression coverage

  • WHEN Playwright modal-flow tests execute
  • THEN open/close/source/share interactions pass for hero-origin and feed-origin entry paths
  • AND regressions in modal ordering or interaction wiring are detected