feat: FTS5 full-text message search#5373
Draft
jamesarich wants to merge 1 commit into
Draft
Conversation
❌ 11 Tests Failed:
View the top 3 failed test(s) by shortest run time
View the full list of 4 ❄️ flaky test(s)
To view more test analytics, go to the Test Analytics Dashboard |
Adds full-text search to the messaging screen using SQLite FTS5: - New PacketFts entity (content-sync FTS5 table) tracking message_text - Search UI with contextual search bar, prev/next navigation, and result count - Term highlighting in message bubbles during active search - Scroll-to-match when navigating between search results - Efficient backfill via json_extract SQL UPDATE (no OOM risk) - Query sanitization wrapping tokens in quotes to escape FTS5 special chars - 300ms debounce with minimum 2-char threshold Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
jamesarich
force-pushed
the
feat/fts5-message-search
branch
from
0e59ed7 to
b117e19
Compare
Contributor
📄 Docs staleness check — advisoryThis PR modifies user-facing UI source files but does not update any page under
Changed source files: What to check:
New page checklist (if adding a new doc page):
If this PR does not require a doc update (e.g., internal refactor, bug fix, test change), add the
|
Contributor
🖼️ Preview staleness check — advisoryThis PR modifies UI composables but does not update any
Changed UI files: What to check:
Adding previews checklist:
If this PR does not require preview updates (e.g., logic-only change, non-visual refactor), add the |
jamesarich
added a commit
that referenced
this pull request
May 30, 2026
Squash merge of PR #5373 into release/2.8.0. Adds full-text search to the messaging screen using SQLite FTS5, enabling users to find messages within a conversation. Includes PacketFts entity, FTS5 MATCH queries, backfill migration, and search UI with real-time results. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds full-text search to the messaging screen using SQLite FTS5, enabling users to find messages within a conversation.
Changes
Database Layer
PacketFts— new@Fts5(contentEntity = Packet::class)entity that mirrorsmessage_textfor full-text indexingPacket.messageText— new column populated at insert time fromDataPacket.textPacketDao— FTS5 MATCH queries (searchMessages,searchMessagesInConversation), plusbackfillMessageTexts()usingjson_extractfor efficient one-shot backfillRepository Layer
PacketRepository.searchMessages()— sanitizes user input (double-quote wrapping per token), scopes to contact key optionallymessageTextat insert time in both message save pathsUI Layer
MessageSearchBar— M3 contextual search bar with text field, "X of Y" counter, prev/next arrows, and clear buttonsearchResultIndexStateFlow withnavigateToNext/Previous, scroll-to-match viaLaunchedEffectHighlightedTextcomposable highlights matching tokens in message bubbles usingtertiaryContainercolorBackfill Strategy
On database switch, a single SQL
UPDATEwithjson_extract(data, "$.text")populatesmessage_textfor historical packets, followed by an FTS5rebuildcommand. Zero rows loaded into memory.Screenshots
TODO: Add screenshots of search bar and highlighted results
Testing