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

41 lines
2.1 KiB
Markdown

## 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
#### Scenario: Permalink-driven modal open
- **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
### Requirement: Modal content preserves source link-out behavior
The system SHALL provide source link-outs from the summary modal and keep share interactions stable.
#### 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
#### 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