Bump version to v0.5.0 and update docs for release (#53)

- Cargo.toml version 0.4.0 → 0.5.0
- Changelog: add v0.5.0 section (reactions, @mentions, message
  selection, stderr error handling, refactoring)
- Roadmap: mark reactions, @mentions, message selection, startup
  error handling as completed; add reply/forward to Future
- README: add reactions, @mentions, message selection, read receipts
  to features; add J/K, y/Y, r to keybindings; add /contacts command
- Docs: update features, keybindings, commands, roadmap pages

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: johnsideserf

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "signal-tui"
-version = "0.4.0"
+version = "0.5.0"
 edition = "2021"
 license = "GPL-3.0-only"
 description = "Terminal-based Signal messenger client with vim keybindings"

Cargo.toml

@@ -92,6 +92,10 @@ All fields are optional. `signal_cli_path` defaults to `"signal-cli"` (found via
 - **Unread tracking** -- Unread counts in sidebar with "new messages" separator in chat
 - **Notifications** -- Terminal bell on new messages (configurable per direct/group, per-chat mute)
 - **Contact resolution** -- Names from your Signal address book; groups auto-populated on startup
+- **Message reactions** -- React with `r` in Normal mode; emoji picker with badge display (`👍 2 ❤️ 1`)
+- **@mentions** -- Type `@` in group chats to mention members with autocomplete
+- **Message selection** -- Focused message highlight when scrolling; `J`/`K` to jump between messages
+- **Read receipts** -- Status symbols on outgoing messages (Sending → Sent → Delivered → Read → Viewed)
 - **Setup wizard** -- First-run onboarding with QR code device linking
 - **Vim keybindings** -- Modal editing (Normal/Insert) with full cursor movement
 - **Command autocomplete** -- Tab-completion popup for slash commands
@@ -109,6 +113,7 @@ All fields are optional. `signal_cli_path` defaults to `"signal-cli"` (found via
 | `/sidebar` | `/sb` | Toggle sidebar visibility |
 | `/bell [type]` | `/notify` | Toggle notifications (`direct`, `group`, or both) |
 | `/mute` | | Mute/unmute current conversation |
+| `/contacts` | `/c` | Browse synced contacts |
 | `/settings` | | Open settings overlay |
 | `/help` | `/h` | Show help overlay |
 | `/quit` | `/q` | Exit signal-tui |
@@ -137,13 +142,16 @@ Press `Esc` to enter Normal mode.
 | Key | Action |
 |---|---|
 | `j` / `k` | Scroll down / up 1 line |
+| `J` / `K` | Jump to previous / next message |
 | `Ctrl+D` / `Ctrl+U` | Scroll down / up half page |
 | `g` / `G` | Scroll to top / bottom |
 | `h` / `l` | Move cursor left / right |
 | `w` / `b` | Word forward / back |
 | `0` / `$` | Start / end of line |
 | `x` | Delete character at cursor |
 | `D` | Delete from cursor to end |
+| `y` / `Y` | Copy message body / full line |
+| `r` | React to focused message |
 | `i` | Enter Insert mode |
 | `a` | Enter Insert mode (cursor right 1) |
 | `I` / `A` | Enter Insert mode at start / end of line |

README.md

@@ -19,8 +19,6 @@
 - [x] Sync request at startup to refresh data from primary device
 - [x] Inline image preview for attachments (halfblock rendering)
 
-## Up Next
-
 - [x] **New message notifications**
   - Terminal bell + unread count in terminal title
   - Separate toggles for direct and group messages (config + `/bell` command)
@@ -43,25 +41,39 @@
 - [x] **Full timestamp on scroll**
   - Status bar shows full date+time of focused message when scrolling
 
+- [x] **Message reactions**
+  - Emoji picker (`r` in Normal mode) with quick-react bar
+  - Compact badge display (`👍 2 ❤️ 1`) with optional verbose mode
+  - Full lifecycle: receive, sync, remove, persist (DB migration v4)
+
+- [x] **@mention autocomplete**
+  - Type `@` in group chats to mention members; also works in 1:1 chats
+  - Incoming mentions highlighted in cyan+bold
+
+- [x] **Visible message selection**
+  - Dark background highlight on focused message when scrolling
+  - `J`/`K` to jump between messages (skips separators and system messages)
+
+- [x] **Startup error handling**
+  - signal-cli stderr captured and displayed in TUI error screen
+
+## Up Next
+
 - [ ] **Send attachments**
   - Only receiving works today
   - Add `/send-file <path>` command
 
+- [ ] **Message search**
+  - Full-text search across conversations
+
 ## Future
 
-- [ ] Message search
 - [ ] Multi-line message input (Shift+Enter for newlines)
 - [ ] Message history pagination (scroll-up to load older messages)
 - [ ] Correct group typing indicators (per-sender-to-group mapping)
-- [ ] **Message reactions (emoji reactions)**
-  - Parse `dataMessage.reaction` from signal-cli (emoji, targetAuthor, targetTimestamp, isRemove)
-  - Display reactions below the target message as compact emoji badges (e.g. `👍 2  ❤️ 1`)
-  - Aggregate duplicate emoji from different senders into counts
-  - Handle reaction removal (`isRemove: true`) by decrementing or removing the badge
-  - Store reactions in DB (new `reactions` table keyed by message + sender)
-  - Re-render reaction badges on startup from DB
-  - Stretch: allow sending reactions via a command (e.g. `/react 👍`)
 - [ ] Message deletion and editing
 - [ ] Group management (create, add/remove members, member list)
 - [ ] Scroll position memory per conversation
 - [ ] Configurable keybindings
+- [ ] Reply to specific messages (quote reply)
+- [ ] Forward messages

ROADMAP.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## v0.5.0
+
+### Message reactions
+
+- **Emoji reactions** -- react to any message with `r` in Normal mode to
+  open the reaction picker. Navigate with `h`/`l` or `1`-`8`, press
+  Enter to send. Reactions display below messages as compact emoji
+  badges (e.g. `👍 2 ❤️ 1`) with an optional verbose mode showing
+  sender names (closes #16)
+- **Reaction sync** -- incoming reactions, sync reactions from other
+  devices, and reaction removals are all handled in real time
+- **Persistence** -- reactions are stored in the database (migration v4)
+  and restored on startup
+
+### @mentions
+
+- **Mention autocomplete** -- type `@` in group chats to open a member
+  autocomplete popup. Filter by name, press Tab to insert the mention.
+  Works in 1:1 chats too (with the conversation partner)
+- **Mention display** -- incoming mentions are highlighted in cyan+bold
+  in the chat area
+
+### Visible message selection
+
+- **Focus highlight** -- when scrolling in Normal mode, the focused
+  message gets a subtle dark background highlight so you can see exactly
+  which message reactions and copy will target
+- **`J`/`K` navigation** -- Shift+j and Shift+k jump between actual
+  messages, skipping date separators and system messages
+
+### Startup error handling
+
+- **stderr capture** -- signal-cli startup errors (missing Java, bad
+  config, etc.) are now captured and displayed in a TUI error screen
+  instead of silently failing
+
+### Internal
+
+- Major refactoring across four PRs (#45-#48): extracted shared key
+  handlers, data-driven settings system, split `parse_receive_event`
+  into sub-functions, modernized test helpers, added persistent debug
+  log and pending_requests TTL
+
+---
+
 ## v0.4.0
 
 ### Contact list

docs/src/changelog.md

@@ -23,22 +23,29 @@
 - [x] Input history (Up/Down to recall previous messages)
 - [x] Incognito mode (`--incognito`)
 - [x] Demo mode (`--demo`)
+- [x] Delivery/read receipt display (status symbols on outgoing messages)
+- [x] Contact list overlay (`/contacts`)
+- [x] Copy to clipboard (`y`/`Y` in Normal mode)
+- [x] Full timestamp on scroll (status bar shows date+time of focused message)
+- [x] Message reactions (emoji picker, badge display, full lifecycle with DB persistence)
+- [x] @mention autocomplete (type `@` in group or 1:1 chats)
+- [x] Visible message selection (focus highlight, `J`/`K` message-level navigation)
+- [x] Startup error handling (signal-cli stderr captured in TUI error screen)
 
 ## Up next
 
-- [ ] **Delivery/read receipt display** -- receipts are already parsed but
-  silently discarded. Show checkmark indicators next to messages.
 - [ ] **Send attachments** -- only receiving works today. Add a `/send-file <path>`
   command.
+- [ ] **Message search** -- full-text search across conversations.
 
 ## Future
 
-- [ ] Message search
 - [ ] Multi-line message input (Shift+Enter for newlines)
 - [ ] Message history pagination (scroll-up to load older messages)
 - [ ] Correct group typing indicators (per-sender-to-group mapping)
-- [ ] Message reactions (emoji badges with counts)
 - [ ] Message deletion and editing
 - [ ] Group management (create, add/remove members, member list)
 - [ ] Scroll position memory per conversation
 - [ ] Configurable keybindings
+- [ ] Reply to specific messages (quote reply)
+- [ ] Forward messages

docs/src/dev-guide/roadmap.md

@@ -11,6 +11,7 @@ All commands start with `/`. Type `/` in Insert mode to open the autocomplete po
 | `/sidebar` | `/sb` | | Toggle sidebar visibility |
 | `/bell` | `/notify` | `[type]` | Toggle notifications (`direct`, `group`, or both) |
 | `/mute` | | | Mute/unmute current conversation |
+| `/contacts` | `/c` | | Browse synced contacts |
 | `/settings` | | | Open settings overlay |
 | `/help` | `/h` | | Show help overlay |
 | `/quit` | `/q` | | Exit signal-tui |

docs/src/user-guide/commands.md

@@ -71,6 +71,33 @@ Uses an in-memory database instead of on-disk SQLite. No messages, conversations
 or read markers are written to disk. The status bar shows a bold magenta
 **incognito** indicator. When you exit, everything is gone.
 
+## Message reactions
+
+React to any message with `r` in Normal mode to open the emoji picker. Navigate
+with `h`/`l` or press `1`-`8` to jump directly, then Enter to send.
+
+Reactions display below messages as compact badges:
+
+```
+👍 2  ❤️ 1
+```
+
+Enable "Verbose reactions" in `/settings` to show sender names instead of counts.
+Reactions sync across devices and persist in the database.
+
+## @mentions
+
+In group chats, type `@` to open a member autocomplete popup. Filter by name and
+press Tab to insert the mention. Works in 1:1 chats too (with the conversation
+partner). Incoming mentions are highlighted in cyan+bold.
+
+## Visible message selection
+
+When scrolling in Normal mode, the focused message gets a subtle dark background
+highlight. This makes it clear which message `r` (react) and `y`/`Y` (copy) will
+target. Use `J`/`K` (Shift+j/k) to jump between messages, skipping date
+separators and system messages.
+
 ## Demo mode
 
 ```sh

docs/src/user-guide/features.md

@@ -22,9 +22,19 @@ changes in the status bar.
 | Key | Action |
 |---|---|
 | `j` / `k` | Scroll down / up 1 line |
+| `J` / `K` | Jump to previous / next message |
 | `Ctrl+D` / `Ctrl+U` | Scroll down / up half page |
 | `g` / `G` | Scroll to top / bottom |
 
+### Actions
+
+| Key | Action |
+|---|---|
+| `y` | Copy message body to clipboard |
+| `Y` | Copy full line (`[HH:MM] <sender> body`) to clipboard |
+| `r` | Open reaction picker on focused message |
+| `@` | Mention autocomplete (in Insert mode) |
+
 ### Cursor movement
 
 | Key | Action |