<!--
  Thanks for contributing to XC_VM!
  Please fill in the sections below and complete the checklist.
-->

## Summary

<!-- What does this PR do and why? Link related issues, e.g. "Closes #123". -->

## Type of change

- [ ] Bug fix
- [ ] New feature
- [ ] Refactor / cleanup
- [ ] Documentation
- [ ] Build / CI / tooling

## Checklist

- [ ] Code follows the project conventions (see `.github/instructions/php-conventions.instructions.md`).
- [ ] `bash tools/php_syntax_check.sh` passes locally.
- [ ] Unit tests pass: `php tools/.bin/phpunit.phar -c tests/phpunit.xml.dist`.
- [ ] Added/updated tests for the change where applicable.
- [ ] Documentation updated where applicable (`docs/`, README).
- [ ] No large binaries added outside Git LFS (`src/bin/**` binaries belong in LFS).
- [ ] No secrets, credentials, or `.env` files committed.