clawfort/openspec/changes/archive/2026-02-13-p14-bugs/specs/article-permalinks-and-deep-link-modal/spec.md

MODIFIED Requirements

Requirement: Deep-link loads article modal in open state

The system SHALL open the matching article modal when the page is loaded with a valid article permalink, regardless of whether the target is hero or feed content.

Scenario: Hero permalink opens parity modal

• WHEN a user lands with a permalink for the current hero article
• THEN the modal opens with the same structure and behaviors as feed-opened modal
• AND summary image render path is executed normally

Scenario: Escape closes deep-linked modal

• WHEN a modal opened from permalink is focused
• THEN pressing Escape closes the modal
• AND URL deep-link state is cleared consistently

Scenario: Invalid permalink fails safely

• WHEN permalink article id does not resolve to an existing item
• THEN modal is not opened
• AND main page remains fully usable