Teams for file paths

[perryqh]

This pull request introduces several improvements and new features to the code ownership infrastructure, focusing on performance, usability, and maintainability. The most significant changes include a new bulk ownership lookup API for files, enhanced documentation and parameterization for ownership queries, workflow optimizations for CI/CD, and dependency updates for the Rust backend. These changes make ownership queries faster and more flexible, improve the artifact publishing and release process, and add more robust validation and error handling.

Features & API Improvements

• Added bulk ownership lookup: Implemented teams_for_files in the Rust extension and exposed teams_for_files_from_codeowners in Ruby, allowing efficient ownership queries for multiple files at once. This is significantly faster than querying files individually. [1] [2] [3]
• Enhanced for_file API: Added from_codeowners and allow_raise parameters to for_file, enabling users to choose lookup strategy and error handling behavior. Documentation was expanded with examples and usage notes. [1] [2]
• Improved verbose ownership reporting: The CLI and API now provide detailed ownership reasons for files, and internal code uses stricter error handling for missing ownership. [1] [2]

CI/CD & Workflow Optimizations

• Refactored CD workflow: Switched to workflow_call trigger, improved artifact retention, cache isolation, and added platform-specific gem smoke tests. The release step now generates detailed notes and only publishes new versions. [1] [2] [3]
• Updated platform exclusions: Added more unsupported platforms to the build matrix for clarity and reliability.
• Improved CI matrix: Added explicit Rust toolchain selection and disabled cargo cache for more predictable builds.

Dependency Updates

• Updated codeowners-rs dependency: Upgraded to version v0.2.17 for bug fixes and new features.

Documentation & Validation

• Expanded documentation: All public methods now have thorough documentation, usage examples, and notes on performance and error handling. [1] [2]
• Improved validation: The validation API is now more robust, with autocorrect and staging options, and clearer error reporting for misconfigurations.

References: [1] [2] [3] [4] [5]Incorporates https://github.com/rubyatscale/codeowners-rs/releases/tag/v0.2.15 for finding teams from an array of files.

This is an optimization for when callers have a large number of files for which they need to know the owning teams.

[conniellim]

lgtm

[perryqh]

Manual kickoff (for now).

[hellosweta]

Awesome thanks for tackling this