From 98e5a2541deecaa8663e407b7a02855b94a07ce0 Mon Sep 17 00:00:00 2001 From: Chad Auld Date: Mon, 10 Nov 2025 06:12:29 -0700 Subject: [PATCH] Add TODO file with v1.1.0 artist filter enhancement --- TODO.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 TODO.md diff --git a/TODO.md b/TODO.md new file mode 100644 index 0000000..05db869 --- /dev/null +++ b/TODO.md @@ -0,0 +1,37 @@ +# TODO + +## v1.0.0 Release +- [ ] Create GitHub release with notes +- [ ] Test installation via HACS custom repository + +## Future Enhancements (v1.1.0+) + +### Artist Filter Parameter +Add optional artist filter parameter to improve multi-part query accuracy. + +**Current approach (v1.0.0):** +- Combine artist and song into query string: "Yellow Coldplay" +- Relies on Spotify's search ranking algorithm +- Works well via LLM prompt enhancement + +**Proposed enhancement (v1.1.0):** +- Add `artist` parameter to `search_spotify` service +- Apply artist filtering to search results +- Example: `search_spotify(query="Yellow", type="track", artist="Coldplay")` + +**Benefits:** +- More precise matching when multiple artists have songs with same name +- Explicit artist filtering vs relying on search ranking +- Better handling of edge cases + +**Implementation notes:** +- Update `services.yaml` to add `artist` parameter (optional) +- Update `search_spotify` function in `__init__.py` to apply artist filtering +- Update function definition in Extended OpenAI Conversation +- Consider backward compatibility - make parameter optional +- Update documentation and examples + +**Trade-offs:** +- Requires more specific parameter extraction from LLM +- May reduce flexibility of natural language queries +- Current combined query approach already works well for most cases