Summary

Describe what this pull request changes.

Related issue or discussion

Link the issue where this change was discussed.

Fixes #

Approach

Explain the approach taken and why.

Include any important design choices, trade-offs, or alternatives considered.

Operating system support

Describe the intended operating system support for this change.

• macOS
• Windows
• Linux
• Not applicable

Operating systems tested

List the operating systems and versions you tested on.

If Linux support is not implemented or was not tested, please say so. Linux support is encouraged where practical, but it is not a hard requirement for every contribution.

Testing

Describe how this was tested.

Include relevant commands, queries, build steps, screenshots, logs, or other validation details where useful.

Checklist

• I have read the Mac Admins contribution guidance: https://macadmins.io/contributing/
• This change was discussed in an issue before code was submitted, unless it is a small documentation fix, typo fix, or clearly isolated bug fix.
• I understand the code I am submitting and can explain how it works.
• This change fits the existing direction, style, and maintenance expectations of the project.
• I have considered operating system support, including Linux support where practical.
• I have added tests, updated tests, or explained why tests are not applicable.
• I have documented any known limitations or follow-up work.