feat: add fuzzy file search for PRD file path input by bigs · Pull Request #253 · subsy/ralph-tui

bigs · 2026-02-02T16:47:59Z

Summary

Add fuzzy autocomplete suggestions when entering PRD file paths in the EpicLoaderOverlay
Discovers JSON files on mount (up to depth 5, excluding node_modules/.git/dist/etc.) and filters them as the user types using a scoring-based fuzzy matcher
Arrow keys navigate suggestions, Tab completes, Enter selects
Fix cursor display bug where the underscore cursor was rendered as a separate element, causing the first character to appear masked

Test plan

Run bun run dev run --tracker json without a --prd flag
Press e to open the epic loader overlay
Verify cursor displays correctly (no character masking)
Verify JSON files in the project appear as suggestions
Type to filter suggestions with fuzzy matching
Use arrow keys to navigate suggestions
Press Tab to autocomplete with selected suggestion
Press Enter to select and load the file

🤖 Generated with Claude Code

Summary by CodeRabbit

New Features
- Fuzzy search in the file browser with relevance-ranked results, match counts and improved ordering; navigation and selection adapt to filtered results and parent entry is hidden while searching.
- Keyboard-driven search mode with dedicated shortcuts, clear-search action and an empty-results message; search state shown in the UI.
Documentation
- Quick Start and JSON tracker docs updated with interactive file browser and fuzzy-search guidance.
Tests
- Comprehensive unit and integration tests for fuzzy search and file-browser search behaviour.

Add fuzzy autocomplete suggestions when entering PRD file paths in the EpicLoaderOverlay. Discovers JSON files on mount (up to depth 5, excluding node_modules/.git/dist/etc) and filters them as the user types using a scoring-based fuzzy matcher. Arrow keys navigate suggestions, Tab completes, Enter selects. Also fixes cursor display bug where the underscore cursor was rendered as a separate element, causing the first character to appear masked. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

vercel · 2026-02-02T16:48:05Z

@bigs is attempting to deploy a commit to the plgeek Team on Vercel.

A member of the Team first needs to authorize it.

coderabbitai · 2026-02-02T16:48:18Z

Walkthrough

Adds a new fuzzy-search utility for scoring and filtering file paths and integrates it into the FileBrowser component to provide keyboard-driven fuzzy search, filtered navigation, UI indicators, plus documentation and tests for the interactive file browser and fuzzy search behaviour.

Changes

Cohort / File(s)	Summary
Fuzzy Search Utility `src/utils/fuzzy-search.ts`	New module exporting `FuzzyMatch`, `fuzzySearch(items, query, limit)` and `fuzzyFilter(items, query)`. Implements scoring combining exact matches, filename heuristics, containment, and sequential (fzf-style) matching; sorts and limits results.
FileBrowser Integration `src/tui/components/FileBrowser.tsx`	Integrates fuzzy search: adds `searchQuery` state, computes `filteredEntries` via `fuzzySearch`, adapts navigation/selection and keyboard handling for search mode (hides parent `..`, Enter selects filtered item, Esc clears), shows search indicator and match count, clears search on path change.
Documentation `website/content/docs/getting-started/quick-start.mdx`, `website/content/docs/plugins/trackers/json.mdx`	Adds File Browser and Fuzzy Search docs: keyboard navigation table, fuzzy search behaviour (match ranking, clearing), and tips for interactive selection of .json / PRD files. Note: similar content was inserted in two places in quick-start.
Tests `tests/utils/fuzzy-search.test.ts`, `tests/tui/file-browser.test.ts`	Adds unit tests for `fuzzySearch`/`fuzzyFilter` (scoring, ranking, limits, edge cases) and updates FileBrowser tests to cover search-mode behaviour and indexing logic.

Sequence Diagram

sequenceDiagram
    actor User
    participant FB as FileBrowser Component
    participant FS as fuzzySearch Utility
    participant UI as UI Display

    User->>FB: Type search query
    activate FB
    FB->>FB: update searchQuery state
    FB->>FS: fuzzySearch(entries, query)
    activate FS
    FS->>FS: calculate scores (exact, filename, containment, sequential)
    FS-->>FB: FuzzyMatch[] (sorted)
    deactivate FS
    FB->>FB: compute filteredEntries
    FB->>UI: render filtered results + search indicator
    deactivate FB
    UI-->>User: show matches and count

    User->>FB: navigate / select
    activate FB
    FB->>FB: apply navigation on filteredEntries
    FB->>UI: update selection
    deactivate FB
    UI-->>User: display selected entry

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change: introducing fuzzy file search functionality for PRD file path input, which is the primary objective across the new fuzzy-search utility, FileBrowser integration, and documentation updates.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

📝 Generate docstrings

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

bigs · 2026-02-02T16:57:12Z

Heya @subsy totally understand if you wanna close this in favor of something else. I was checking out ralph-tui and found that the prompt dialog for locating the prd.json file (when working in that modality) was a little rough. The "cursor" underscore was always fixed at the first position, so you couldn't see what the first letter you typed was. It didn't advance. So I updated it so that:

The cursor shifts as you type
It fuzzily searches for what you type within your current directory tree

I've tested it locally, it's looking good to me :)

Edit: I had Claude implement a simple fuzzy matching algo to avoid bringing in another dependency, but would happily factor that out as well.

subsy · 2026-02-02T17:37:38Z

This is great @bigs - thanks - will take a look - hopefully can combine it with the file tree browser from another contributor in PR #236

bigs · 2026-02-02T18:12:25Z

Ah, interesting. Yeah, that should be doable. Probably easiest to let that land first, then rebase this onto that. I'd be happy to when that's ready.

subsy · 2026-02-02T18:15:44Z

Nice one - going to try to get that in today or tomorrow - working on the big parallel execution pr first

…

On Mon, 2 Feb 2026 at 18:12, bigs ***@***.***> wrote: *bigs* left a comment (subsy/ralph-tui#253) <#253 (comment)> Ah, interesting. Yeah, that should be doable. Probably easiest to let that land first, then rebase this onto that. I'd be happy to when that's ready. — Reply to this email directly, view it on GitHub <#253 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AB2X73NRVF2MRPBEPLDP3ED4J6HR7AVCNFSM6AAAAACTWTEUTGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTQMZWHA2TMMRWGM> . You are receiving this because you were mentioned.Message ID: ***@***.***>

-- Ben Williams Newsletter <https://plg.news> | Website <https://plgeek.com> | LinkedIn <https://www.linkedin.com/in/theproductledgeek/>

bigs · 2026-02-02T18:46:33Z

Miscellaneous question—how are you liking CodeRabbit? My team has been using BugBot, but we're getting frustrated with the latency (even though the quality is fairly high). Feels like CodeRabbit is a fair bit quicker, but curious what you think of the quality.

subsy · 2026-02-02T19:51:46Z

Miscellaneous question—how are you liking CodeRabbit? My team has been using BugBot, but we're getting frustrated with the latency (even though the quality is fairly high). Feels like CodeRabbit is a fair bit quicker, but curious what you think of the quality.

@bigs I really like CR - especially if you put in a bit of work to tune the config (though OOTB its pretty good). I still get frustrated with the latency - less so in private repos - but OSS repos are rate limited - but free

Resolves conflicts by keeping FileBrowser component from main while preserving fuzzy-search utility from this branch for future integration.

Add real-time fuzzy filtering to the file browser: - Type any alphanumeric character to start filtering - Results ranked by fuzzy match score (exact > starts with > contains > sequential) - Search clears when changing directories or pressing Escape - ".." entry hidden during search for cleaner results - Footer shows contextual keybindings for search mode

vercel · 2026-02-03T17:47:26Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
ralph-tui	Ready	Preview, Comment	Feb 3, 2026 6:08pm

codecov · 2026-02-03T17:47:56Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 43.49%. Comparing base (6173307) to head (f6ec254).
⚠️ Report is 7 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #253      +/-   ##
==========================================
+ Coverage   43.35%   43.49%   +0.13%     
==========================================
  Files          91       92       +1     
  Lines       28281    28351      +70     
==========================================
+ Hits        12260    12330      +70     
  Misses      16021    16021

Files with missing lines	Coverage Δ
src/utils/fuzzy-search.ts	`100.00% <100.00%> (ø)`

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Document the keyboard-driven file browser UI: - quick-start.mdx: Add "File Browser" section with keyboard shortcuts - json.mdx: Add "Interactive File Browser" section explaining when it appears and how fuzzy search works Covers navigation, fuzzy search, path entry, and hidden files toggle.

coderabbitai

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@website/content/docs/getting-started/quick-start.mdx`:
- Around line 154-168: The key shortcut table in the "File Browser" section is
missing the Tab autocomplete entry; update the table in quick-start.mdx under
the "File Browser" heading to add a row for `Tab` with an appropriate action
like "Autocomplete selected suggestion" (so readers see Tab alongside
`Enter`/`→` and other keys) and ensure any accompanying prose about fuzzy search
also mentions Tab as the autocomplete shortcut.

website/content/docs/getting-started/quick-start.mdx

New test file for fuzzy-search.ts utility (100% coverage): - Empty/basic query handling - Exact match scoring (1000 points) - Filename matching tiers (800/600/400 points) - Path matching (200 points) - Sequential fzf-style matching with consecutive bonuses - Ranking and alphabetical tie-breaking - Real-world file patterns Extended file-browser.test.ts with integration tests: - Fuzzy filtering of DirectoryEntry arrays - Search mode index calculation (no ".." in search) - Max index bounds for navigation

- Tab now selects the highlighted entry (same as Enter) - Updated quick-start.mdx and json.mdx docs to include Tab shortcut - Mentioned Tab in fuzzy search prose sections Addresses PR feedback about missing Tab autocomplete documentation.

bigs · 2026-02-03T20:01:07Z

Oh awesome, ty! Excited to use this!

feat: add fuzzy file search for PRD file path input

AI Agent added 2 commits February 3, 2026 17:35

Merge main into bigs/path-autocomplete

8f9082c

Resolves conflicts by keeping FileBrowser component from main while preserving fuzzy-search utility from this branch for future integration.

coderabbitai bot reviewed Feb 3, 2026

View reviewed changes

website/content/docs/getting-started/quick-start.mdx Outdated Show resolved Hide resolved

AI Agent added 2 commits February 3, 2026 18:02

vercel bot deployed to Preview February 3, 2026 18:08 View deployment

subsy merged commit b86661d into subsy:main Feb 3, 2026
9 checks passed

sakaman pushed a commit to sakaman/ralph-tui that referenced this pull request Feb 15, 2026

Merge pull request subsy#253 from bigs/bigs/path-autocomplete

de5ff22

feat: add fuzzy file search for PRD file path input

Conversation

bigs commented Feb 2, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Summary by CodeRabbit

Uh oh!

vercel bot commented Feb 2, 2026

Uh oh!

coderabbitai bot commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Sequence Diagram

Estimated code review effort

Uh oh!

bigs commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

subsy commented Feb 2, 2026

Uh oh!

bigs commented Feb 2, 2026

Uh oh!

subsy commented Feb 2, 2026 via email

Uh oh!

bigs commented Feb 2, 2026

Uh oh!

subsy commented Feb 2, 2026

Uh oh!

vercel bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

bigs commented Feb 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

bigs commented Feb 2, 2026 •

edited by coderabbitai bot

Loading

coderabbitai bot commented Feb 2, 2026 •

edited

Loading

bigs commented Feb 2, 2026 •

edited

Loading

vercel bot commented Feb 3, 2026 •

edited

Loading

codecov bot commented Feb 3, 2026 •

edited

Loading