<!--
Thanks for the PR! Quick checklist before reviewers look at this.
Delete anything that does not apply.
-->

## Summary

<!--
What and why in 2-4 lines. The diff says what; this should say why.
-->

## Linkage

- Closes #
<!-- "Closes #N" auto-closes the issue on merge. Required by CONTRIBUTING. -->
- Roadmap phase: <!-- e.g. Phase 1 / Phase 2 / unrelated / #28 -->

## Test plan

- [ ] `npm test` is green locally (Node + Python suites).
- [ ] Added or updated tests for the changed surface
      (delete this line only if the PR is doc-only).
- [ ] CI (`tests.yml`) matrix is green on the PR.

## Notes for the reviewer

<!--
Anything non-obvious: edge cases considered, alternatives weighed,
follow-ups already filed, breaking-change implications. Keep tight.
-->
