Feature: full-text session search with operators, accordion results, and highlighted snippets

[josegtmonteiro]

Summary

Adds a powerful search feature to the project sessions page, enabling users to find sessions by searching through the full conversation content (all messages, not just the first one).

• Search operators: AND (default), OR, NOT (-prefix), and "exact phrase" support
• Accordion results: Search results display in a single-column expandable layout with matching snippets
• Highlighted terms: Each search term is independently highlighted in snippet text
• Action buttons: "Open session" and "Copy resume command" (claude --resume <id>) on each result row
• Default grid preserved: When not searching, the original 3-column session card layout is unchanged

Search Syntax

Syntax	Meaning	Example
word1 word2	AND — both must be present	altera roku
word1 OR word2	OR — at least one present	outage OR downtime
-word	NOT — must not be present	altera -roku
"exact phrase"	Literal phrase match	"hold communication"
Mixed	Combine freely	"fix bug" refactor OR cleanup -test

Changes

Backend (Rust — src-tauri/src/commands/claude.rs)

• Query parser (parse_query): Tokenizes input respecting quoted phrases, - negation, and OR keyword into ParsedQuery struct with and_terms, or_groups, not_terms, and highlight_terms
• Session matching (session_matches): Reads session content once and checks AND/OR/NOT logic
• Multi-term snippet extraction (extract_snippets_for_terms): Extracts context-windowed snippets for each positive search term
• SessionSearchResult includes highlight_terms for frontend highlighting
• Runs in tokio::task::spawn_blocking to avoid blocking the async runtime
• Path traversal prevention with canonical path validation, symlink-safe scanning
• Query validation (min 2 chars, max 256 chars), graceful error handling for unreadable files
• 10 unit tests for the query parser
• Web server route: GET /api/projects/{id}/sessions/search?query=...

Frontend (React/TypeScript — src/components/SessionList.tsx, src/lib/api.ts)

• Search input with 300ms debounce, proper search-active state transitions (no flicker)
• Accordion UI: expandable session rows with chevron toggle, match count badge
• HighlightedText component: accepts terms: string[], highlights each independently via regex alternation
• "Open session" button (external link icon) and "Copy resume command" button (clipboard with checkmark)
• Accessible: aria-live region, aria-expanded/aria-controls on accordion, aria-label on all interactive elements
• SessionSearchResult interface extended with highlight_terms: string[]

API Adapter (src/lib/apiAdapter.ts)

• Endpoint mapping for search_project_sessions

Other files

• src/components/TabContent.tsx — passes projectId prop to SessionList
• src/App.tsx — passes projectId prop to SessionList

Test plan

• cargo test — 19 tests pass (10 new parser tests + 9 existing)
• cargo fmt -- --check — clean
• cargo clippy — no errors
• tsc --noEmit — clean
• npm run check — clean
• CodeRabbit review — 2 consecutive clean passes
• Manual testing — built, installed to /Applications, tested with 246+ session project
• altera roku → only sessions with BOTH terms
• altera OR roku → sessions with either
• altera -roku → sessions with "altera" but not "roku"
• "hold communication" → exact phrase match
• Expand accordion → see highlighted snippets with each term marked
• Click open session icon → opens session without expanding
• Click copy icon → copies claude --resume <id> to clipboard
• Clear search → grid layout returns immediately

🤖 Generated with Claude Code