feat(reader): toast feedback on yank; archive hotkeys-improvement

- Reader shows an auto-dismissing toast after a successful yank:
  "Message text copied to clipboard" (y) /
  "Message text with headers copied to clipboard" (Y); none on failure.
- E2E: assert toast text for y/Y and toast auto-dismiss; repoint spec
  reference comments to the synced main specs.
- Sync hotkeys-improvement deltas into openspec/specs (ui-hotkeys +
  new reader-message-actions incl. yank-clipboard-feedback) and archive
  the change under openspec/changes/archive/2026-06-19-hotkeys-improvement.

Author: antono

e2e/pages/MessagePage.ts

@@ -138,6 +138,11 @@ export class MessagePage {
 		return this.page.getByTestId('headers-popover.container');
 	}
 
+	/** The transient "copied to clipboard" toast shown after a yank. */
+	yankToast(): Locator {
+		return this.page.getByTestId('reader.yank-toast');
+	}
+
 	/** `g f` — open the folder picker from the reader. */
 	async gotoFolderPicker(): Promise<void> {
 		await this.page.keyboard.press('g');

e2e/specs/hotkeys-list-leader.spec.ts

@@ -20,23 +20,23 @@ async function openArchive(page: import('@playwright/test').Page): Promise<Mailb
 	return mailbox;
 }
 
-// openspec/changes/hotkeys-improvement/specs/ui-hotkeys/spec.md: g f opens the folder picker
+// openspec/specs/ui-hotkeys/spec.md: g f opens the folder picker
 test('g f opens the folder picker', async ({ page }) => {
 	await openArchive(page);
 	await page.keyboard.press('g');
 	await page.keyboard.press('f');
 	await expect(page.getByText('Open a folder')).toBeVisible();
 });
 
-// openspec/changes/hotkeys-improvement/specs/ui-hotkeys/spec.md: g a opens the account picker
+// openspec/specs/ui-hotkeys/spec.md: g a opens the account picker
 test('g a opens the account picker', async ({ page }) => {
 	await openArchive(page);
 	await page.keyboard.press('g');
 	await page.keyboard.press('a');
 	await expect(page.getByText('Open a maildir')).toBeVisible();
 });
 
-// openspec/changes/hotkeys-improvement/specs/ui-hotkeys/spec.md: g g jumps to top of list
+// openspec/specs/ui-hotkeys/spec.md: g g jumps to top of list
 test('g g jumps the selection to the top of the list', async ({ page }) => {
 	const mailbox = await openArchive(page);
 	// Move the selection to the bottom (keyboard), then g g returns it to 0.
@@ -46,7 +46,7 @@ test('g g jumps the selection to the top of the list', async ({ page }) => {
 	await expect.poll(() => mailbox.selectedIndex()).toBe(0);
 });
 
-// openspec/changes/hotkeys-improvement/specs/ui-hotkeys/spec.md: G jumps to bottom of list
+// openspec/specs/ui-hotkeys/spec.md: G jumps to bottom of list
 test('G jumps the selection to the bottom of the page', async ({ page }) => {
 	const mailbox = await openArchive(page);
 	// Archive has more messages than a page; G selects the last rendered row.
@@ -55,7 +55,7 @@ test('G jumps the selection to the bottom of the page', async ({ page }) => {
 	await expect.poll(() => mailbox.selectedIndex()).toBe(onPage - 1);
 });
 
-// openspec/changes/hotkeys-improvement/specs/ui-hotkeys/spec.md: removed follow-ups no longer navigate
+// openspec/specs/ui-hotkeys/spec.md: removed follow-ups no longer navigate
 test('removed leaders g i / g s / g d are no-ops', async ({ page }) => {
 	await openArchive(page);
 	for (const key of ['i', 's', 'd']) {

e2e/specs/reader-message-actions.spec.ts

@@ -33,7 +33,7 @@ async function openMessage(
 	return reader;
 }
 
-// openspec/changes/hotkeys-improvement/specs/reader-message-actions/spec.md: r opens compose addressed to sender, Re: subject, quoted body
+// openspec/specs/reader-message-actions/spec.md: r opens compose addressed to sender, Re: subject, quoted body
 test('r replies to sender with Re: subject and quoted body', async ({ page }) => {
 	const reader = await openMessage(page, multi.subject);
 	await reader.reply();
@@ -45,7 +45,7 @@ test('r replies to sender with Re: subject and quoted body', async ({ page }) =>
 	expect(await compose.bodyValue()).toContain(`> ${firstBodyLine}`);
 });
 
-// openspec/changes/hotkeys-improvement/specs/reader-message-actions/spec.md: R populates To/Cc from participants, excludes own address
+// openspec/specs/reader-message-actions/spec.md: R populates To/Cc from participants, excludes own address
 test('R replies to all, Cc from participants, excluding the active account', async ({ page }) => {
 	const reader = await openMessage(page, multi.subject);
 	await reader.replyAll();
@@ -60,7 +60,7 @@ test('R replies to all, Cc from participants, excluding the active account', asy
 	expect(cc).not.toContain(alice.address);
 });
 
-// openspec/changes/hotkeys-improvement/specs/reader-message-actions/spec.md: F forwards with empty To, Fwd: subject, headers + body
+// openspec/specs/reader-message-actions/spec.md: F forwards with empty To, Fwd: subject, headers + body
 test('F forwards with empty To, Fwd: subject, and forwarded headers + body', async ({ page }) => {
 	const reader = await openMessage(page, multi.subject);
 	await reader.forward();
@@ -75,7 +75,7 @@ test('F forwards with empty To, Fwd: subject, and forwarded headers + body', asy
 	expect(body).toContain(firstBodyLine);
 });
 
-// openspec/changes/hotkeys-improvement/specs/reader-message-actions/spec.md: f still activates hint mode (distinct from F)
+// openspec/specs/reader-message-actions/spec.md: f still activates hint mode (distinct from F)
 test('f still activates hint mode and does not forward', async ({ page }) => {
 	const reader = await openMessage(page, linky.subject);
 	await reader.activateHints();
@@ -84,24 +84,34 @@ test('f still activates hint mode and does not forward', async ({ page }) => {
 	await expect(page.getByTestId('compose.container')).toHaveCount(0);
 });
 
-// openspec/changes/hotkeys-improvement/specs/reader-message-actions/spec.md: y copies body only; Y copies headers + body
+// openspec/specs/reader-message-actions/spec.md: y copies body only; Y copies headers + body
 test('y copies the body only; Y copies headers and body', async ({ page }) => {
 	const reader = await openMessage(page, multi.subject);
 
 	await reader.yankBody();
+	await expect(reader.yankToast()).toHaveText('Message text copied to clipboard');
 	const bodyOnly = await page.evaluate(() => navigator.clipboard.readText());
 	expect(bodyOnly).toContain(firstBodyLine);
 	expect(bodyOnly).not.toContain('From:');
 
 	await reader.yankHeaders();
+	await expect(reader.yankToast()).toHaveText('Message text with headers copied to clipboard');
 	const withHeaders = await page.evaluate(() => navigator.clipboard.readText());
 	expect(withHeaders).toContain('From:');
 	expect(withHeaders).toContain('To:');
 	expect(withHeaders).toContain('Subject:');
 	expect(withHeaders).toContain(firstBodyLine);
 });
 
-// openspec/changes/hotkeys-improvement/specs/reader-message-actions/spec.md: g h toggles the headers popover open/closed
+// openspec/specs/reader-message-actions/spec.md: yank toast auto-dismisses
+test('the yank toast appears then auto-dismisses', async ({ page }) => {
+	const reader = await openMessage(page, multi.subject);
+	await reader.yankBody();
+	await expect(reader.yankToast()).toBeVisible();
+	await expect(reader.yankToast()).toHaveCount(0, { timeout: 4000 });
+});
+
+// openspec/specs/reader-message-actions/spec.md: g h toggles the headers popover open/closed
 test('g h toggles the headers menu open and closed', async ({ page }) => {
 	const reader = await openMessage(page, multi.subject);
 
@@ -112,14 +122,14 @@ test('g h toggles the headers menu open and closed', async ({ page }) => {
 	await expect(reader.headersPopover()).toHaveCount(0);
 });
 
-// openspec/changes/hotkeys-improvement/specs/ui-hotkeys/spec.md: g f opens the folder picker from the reader
+// openspec/specs/ui-hotkeys/spec.md: g f opens the folder picker from the reader
 test('g f opens the folder picker from the reader', async ({ page }) => {
 	const reader = await openMessage(page, multi.subject);
 	await reader.gotoFolderPicker();
 	await expect(page.getByText('Open a folder')).toBeVisible();
 });
 
-// openspec/changes/hotkeys-improvement/specs/ui-hotkeys/spec.md: g a opens the account picker from the reader
+// openspec/specs/ui-hotkeys/spec.md: g a opens the account picker from the reader
 test('g a opens the account picker from the reader', async ({ page }) => {
 	const reader = await openMessage(page, multi.subject);
 	await reader.gotoAccountPicker();

…anges/hotkeys-improvement/.openspec.yaml …06-19-hotkeys-improvement/.openspec.yamlopenspec/changes/hotkeys-improvement/.openspec.yaml renamed to openspec/changes/archive/2026-06-19-hotkeys-improvement/.openspec.yaml openspec/changes/hotkeys-improvement/.openspec.yaml renamed to openspec/changes/archive/2026-06-19-hotkeys-improvement/.openspec.yaml

@@ -0,0 +1,124 @@
+# reader-message-actions
+
+## Purpose
+
+Message-level actions available from the reader scope: replying to the sender,
+replying to all participants, forwarding, yanking the body (with or without headers)
+to the clipboard, and toggling the headers menu. The keyboard bindings that trigger
+these actions are declared in the `ui-hotkeys` capability; this capability defines the
+behavior of each action.
+
+---
+## Requirements
+### Requirement: Reply to sender
+The reader SHALL provide an `r` action that opens the compose screen prefilled as a
+reply to the open message's sender. The `To` field SHALL be set to the original
+message's `From` address. The `Subject` SHALL be the original subject prefixed with
+`Re: `, not duplicated if the subject already begins with `Re:` (case-insensitive). The
+compose body SHALL contain the original message body quoted, with each line prefixed by
+`> ` (greater-than then a single space). `r` SHALL be active only when the reader is the
+active scope and focus is not in a text input.
+
+#### Scenario: r opens compose addressed to the sender
+- **WHEN** the reader is open on a message and the user presses `r`
+- **THEN** the compose screen opens with the `To` field set to the original message's `From` address
+
+#### Scenario: Original body is quoted with "> " prefix
+- **WHEN** the user presses `r` in the reader
+- **THEN** the compose body contains the original message text with each line prefixed by `> `
+
+#### Scenario: Subject gets a single Re: prefix
+- **WHEN** the user replies to a message whose subject is `Hello`
+- **THEN** the compose subject is `Re: Hello`
+
+#### Scenario: Re: is not duplicated
+- **WHEN** the user replies to a message whose subject is already `Re: Hello`
+- **THEN** the compose subject remains `Re: Hello` (no `Re: Re:`)
+
+#### Scenario: r suppressed while typing
+- **WHEN** focus is in an `input` or `textarea` and the user presses `r`
+- **THEN** the character is typed normally and no reply is started
+
+### Requirement: Reply to all
+The reader SHALL provide an `R` (Shift+r) action that opens the compose screen as a
+reply to every participant of the open message. The `To` field SHALL contain the
+original `From` address; the `Cc` field SHALL contain the union of the original `To`
+and `Cc` recipients. The active account's own address SHALL be excluded from both
+fields. Subject prefixing and body quoting SHALL follow the same rules as `r`.
+
+#### Scenario: R populates To and Cc from all participants
+- **WHEN** the reader is open on a message with multiple recipients and the user presses `R`
+- **THEN** the compose `To` is the original `From` and the `Cc` contains the other original `To`/`Cc` recipients
+
+#### Scenario: Own address excluded from reply-all
+- **WHEN** the user presses `R` on a message that also listed the active account's own address as a recipient
+- **THEN** the active account's address does not appear in the `To` or `Cc` fields
+
+#### Scenario: Reply-all quotes the original body
+- **WHEN** the user presses `R` in the reader
+- **THEN** the compose body contains the original message text with each line prefixed by `> `
+
+### Requirement: Forward message
+The reader SHALL provide an `F` (Shift+f) action that opens the compose screen to
+forward the open message. The `To` field SHALL be empty, the `Subject` SHALL be the
+original subject prefixed with `Fwd: ` (not duplicated), and the body SHALL contain the
+forwarded original message including its `From`, `To`, `Subject`, and `Date` headers
+followed by the original body. `F` SHALL NOT interfere with `f`, which remains hint mode.
+
+#### Scenario: F opens compose to forward
+- **WHEN** the reader is open and the user presses `F`
+- **THEN** the compose screen opens with an empty `To` and the subject prefixed with `Fwd: `
+
+#### Scenario: Forwarded body includes original headers
+- **WHEN** the user presses `F` in the reader
+- **THEN** the compose body includes the original message's `From`, `To`, `Subject`, and `Date` followed by the original body
+
+#### Scenario: f still activates hint mode
+- **WHEN** the reader is open (text/simple mode) and the user presses `f`
+- **THEN** hint mode activates and no forward is started
+
+### Requirement: Yank message body
+The reader SHALL provide a `y` action that copies the open message's plain-text body to
+the system clipboard. The copied content SHALL be the body only, without headers.
+
+#### Scenario: y copies the body to the clipboard
+- **WHEN** the reader is open and the user presses `y`
+- **THEN** the system clipboard contains the message's plain-text body and no headers
+
+### Requirement: Yank message with headers
+The reader SHALL provide a `Y` (Shift+y) action that copies the open message's common
+headers followed by its body to the system clipboard. The headers SHALL include at
+least `From`, `To`, and `Subject`, plus `Date` and `Cc` when present, each on its own
+line, followed by a blank line and then the plain-text body.
+
+#### Scenario: Y copies headers and body
+- **WHEN** the reader is open and the user presses `Y`
+- **THEN** the system clipboard contains `From`, `To`, and `Subject` lines (and `Date`/`Cc` when present) followed by a blank line and the message body
+
+### Requirement: Yank clipboard feedback
+After a successful yank, the reader SHALL show a transient toast notification confirming
+the copy. `y` SHALL show `Message text copied to clipboard`; `Y` SHALL show
+`Message text with headers copied to clipboard`. The toast SHALL dismiss itself after a
+short delay. No toast SHALL be shown if the clipboard write fails (e.g. insecure context
+or denied permission).
+
+#### Scenario: y shows a body-copied toast
+- **WHEN** the reader is open and the user presses `y`
+- **THEN** a toast reading `Message text copied to clipboard` appears and then auto-dismisses
+
+#### Scenario: Y shows a headers-copied toast
+- **WHEN** the reader is open and the user presses `Y`
+- **THEN** a toast reading `Message text with headers copied to clipboard` appears and then auto-dismisses
+
+### Requirement: Headers menu toggle
+The reader SHALL provide a `g h` leader sequence that toggles the headers menu (the
+`HeadersPopover`) showing the message's full header set. Pressing `g h` again or
+`Escape` SHALL close it.
+
+#### Scenario: g h opens the headers menu
+- **WHEN** the reader is open and the user presses `g` then `h` within the leader timeout
+- **THEN** the headers menu opens showing the message's full headers
+
+#### Scenario: g h closes an open headers menu
+- **WHEN** the headers menu is open and the user presses `g` then `h`
+- **THEN** the headers menu closes