fix: balance list_contains OR tree for large IN-list filters

[phillipleblanc]

Summary

• build constant-list list_contains OR combinations as a balanced tree instead of a left-deep chain
• add a regression test for large constant-list evaluation
• add a structural test to verify balanced OR depth

Testing

• cargo test -p vortex-array scalar_fn::fns::list_contains -- --nocapture
• validated locally from spiceai/spiceai by overriding Vortex to this checkout and rerunning the SF1 staging_table SpiceBench flow past the previous part/lineitem stack-overflow point

[Copilot]

Pull request overview

This PR addresses stack overflows when evaluating list_contains against large constant IN-lists by building the OR-combination of element-wise equality checks as a balanced tree rather than a left-deep chain, and adds regression/structural tests to prevent reintroducing the issue.

Changes:

• Refactor constant-list list_contains evaluation to build a balanced OR reduction tree (or_arrays_balanced).
• Add a regression test for large constant lists (2048 elements) to ensure evaluation completes correctly.
• Add a structural test to validate the resulting OR tree depth is bounded.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.