Add shell path finding as a fallback.

1 files changed, 2 insertions, 0 deletions

diff --git a/AGENTS.md b/AGENTS.md
index b7ce695..76f8e2b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -24,6 +24,7 @@ Run these before completing any task:
 
 ## Task-Specific Guidelines
 - **CLI changes**: Update clap subcommands (including `rsp scan` and `rsp settings`) and regenerate shell completion scripts
+- **Completion changes**: `rsp db-complete` has a two-tier strategy — if the query looks like a path (`./`, `../`, `~/`, or `/`), it lists filesystem entries directly; otherwise it queries the DB in a thread with a 100ms timeout and falls back to filesystem completion on timeout or no match. The zsh script (`completions/_rsp`) is manually edited (not clap-generated) and concatenated after the clap output during install
 - **Database changes**: Update SQLite schema and `rsp scan` logic
 - **Playback changes**: Modify daemon audio engine or queue management code
   - Audio engine uses cpal for output and symphonia for decoding
@@ -50,6 +51,7 @@ Run these before completing any task:
 - [x] `rsp settings` subcommands (get/set/list/unset)
 - [x] Shell completions (`rsp completions bash|zsh|fish|powershell|elvish`)
 - [x] Unit tests for Player, Track, and ShuffleMode
+- [x] Smart autocompletion: DB completion with 100ms timeout, filesystem path fallback, path-prefix detection (`./`, `../`, `~/`, `/`)
 - [x] Desktop notifications for track changes, queue end, and errors
 
 ## Remaining Work