[Jamesking56]

Summary

$url = $I->grabUrlForLinkFromEmail($I->lastMessage(), "Second link");

Adds one action that returns the first href with an exact, case-sensitive label in the given email HTML. Fails when no link matches.

Accepts an Email from lastMessage(), lastMessageTo(), lastMessageFrom(), or direct construction. Includes documentation and tests for selected emails, encoded HTML, nested tags, entities, duplicate labels, and missing links.

Closes #43.

Evidence

• Before: testGrabUrlForLinkFromGivenEmail failed because the action did not exist.
  After: php vendor/bin/codecept run passed: 71 tests, 105 assertions.
• The selected-email test proves the given email wins over the latest email.
• PHP syntax checks and Codeception actor generation passed. No static type checker is configured.
• Full-suite run used a temporary MailCatcher on SMTP port 1125; the local helper port was restored afterward.
• Standards and spec reviews found no issues.

Merge Danger

Door: two-way

Blast Radius: extraction

Adds one action; uses the existing MIME parser and native DOM API.

[github-actions]

Released in 4.1.0.