🏗️ Architect: Refactor build_filter_string

[fderuiter]

🏗️ Refactor Candidate: Complex Conditional Loop in build_filter_string

The Smell:
The build_filter_string function contained a complex loop with multiple if/elif/else branches and string formatting logic directly inside the main execution flow. This increases the cognitive load when reading the function, as the reader has to parse both the iteration logic and the specific formatting logic simultaneously.

The Fix:
Extract Method. I extracted the formatting logic for a single filter key-value pair into a new private helper function _build_filter_part. This allows the main build_filter_string function to be simplified into a single, highly readable list comprehension.

Verification:

• Types are strict (No Any introduced, original Union preserved)
• Sync/Async parity maintained (Utility function, agnostic)
• No logic changes, only structural

Architect's Advice:

• "If you have to write a comment to explain what the code is doing, refactor the code so the comment isn't needed."
• "Duplication is cheaper than the wrong abstraction. Only abstract when the pattern is identical, not just similar."

---

PR created automatically by Jules for task 15010541932194502692 started by @fderuiter

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.