refactor(retargeting): rename HeadPose tensor type to HeadInput

[aristarkhovNV]

Motivation

HeadPose was ambiguous: the name is also used by the FlatBuffer schema (core::HeadPose, HeadPoseTrackedT, HeadPoseRecord), which is an unrelated concept. Renaming the retargeting tensor type to HeadInput matches the sibling HandInput naming and removes the collision.

Changes

• Rename the tensor type HeadPose → HeadInput and HeadPoseIndex → HeadInputIndex, updating all call sites. FlatBuffer schema names are deliberately untouched.
• Keep the old names working as deprecated aliases (warn on access) at both the tensor_types package level and the tensor_types.indices / tensor_types.standard_types submodule paths — the latter is the path the repo's own examples import through, so it needs the shim too.
• Fix a stale docstring in deviceio_source_nodes/interface.py that still listed the format as HeadPose.
• Add TestDeprecatedHeadAliases covering both alias paths, mirroring TestDeprecatedPicoAliases from the earlier ...Pico rename.

Testing

• Full build: cmake --preset py3.12 -DCMAKE_BUILD_TYPE=Release + cmake --build --preset py3.12.
• ctest --output-on-failure --parallel: 309/309 passed locally (GPU/OpenXR tests skip without an HMD). Local run covers Release / py3.12 / x64 only; CI covers the rest of the matrix.
• SKIP=check-copyright-year pre-commit run --all-files: clean.

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • Renamed the standard head-tracking tensor type to HeadInput for clearer terminology.
  • Updated head-source and transformation interfaces to use the new head input format.
  • Added backward-compatible aliases for the previous names, with deprecation warnings.

• Bug Fixes

  • Updated examples and integrations to use the current head input schema consistently.

• Tests

  • Expanded coverage for the new names, compatibility aliases, transformations, and optional head data.

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: b607896e-066f-4d4f-8d4b-af14e2afb557

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

📝 Walkthrough

Walkthrough

The standard head tensor factory and index enum are renamed from HeadPose and HeadPoseIndex to HeadInput and HeadInputIndex. Deprecated aliases preserve access to the former names with warnings. HeadSource, HeadTransform, examples, ROS2 helpers, visualization code, and tests now use the new names without changing transformation, validation, message construction, or optional-head behavior.

Estimated code review effort: 3 (Moderate) | ~20 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the primary change: renaming the HeadPose tensor type to HeadInput.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch aaristarkhov/rename-headpose

---

_{Comment @coderabbitai help to get the list of available commands.}