fix(packaging): guard torch extras on intel macos

[ousamabenyounes]

Description

Closes #1931

Guard the ml and voice torch optional dependencies on macOS x86_64 so headroom-ai[all] remains resolvable on Intel Macs where PyTorch does not publish compatible wheels for this version floor. The lockfile metadata is updated with the same markers.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring
• Performance improvement
• Test update
• Other

Changes Made

• Added macOS x86_64 environment markers to torch in the ml and voice extras.
• Updated uv.lock optional dependency metadata to match the guarded extras.
• Added a packaging regression test that checks [all] keeps ml and voice while guarding torch on macOS x86_64.

Testing

• Unit tests pass (pytest)
• Linting passes (ruff check)
• Formatting verified (ruff format --check)
• Manual testing performed

Test Output

$ python3 -m pytest tests/test_optional_dependencies.py -q
collected 1 item

tests/test_optional_dependencies.py .                                    [100%]

============================== 1 passed in 0.26s ===============================

$ .venv/bin/ruff check tests/test_optional_dependencies.py
All checks passed!

$ .venv/bin/ruff format --check tests/test_optional_dependencies.py pyproject.toml
1 file already formatted

Test verification (RED -> GREEN)

RED, with the torch markers temporarily removed from pyproject.toml:

tests/test_optional_dependencies.py F                                    [100%]
FAILED tests/test_optional_dependencies.py::test_all_extra_does_not_require_torch_on_macos_x86_64
E   assert False

GREEN, with this patch applied:

tests/test_optional_dependencies.py .                                    [100%]
============================== 1 passed in 0.26s ===============================

Real Behavior Proof

• Environment: Linux, Python 3.12.3, pytest 9.1.1, ruff 0.14.14.
• Exact command / steps: Removed the environment markers from torch, ran the new packaging test, restored the markers, and reran the test plus targeted ruff checks.
• Observed result: The test fails without the macOS x86_64 guard and passes once the ml and voice torch requirements are guarded.
• Not tested: Full uv run pytest, full-project uv run ruff check ., full-project uv run ruff format --check ., and uv run mypy headroom were not run locally for this targeted packaging change.

Review Readiness

• I have performed a self-review
• This PR is ready for human review

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have added tests that prove my fix is effective
• New and existing targeted tests pass locally with my changes
• Any dependent changes have been merged and published in downstream modules

Screenshots (if applicable)

N/A

Additional Notes

No new dependency is added; this only narrows when the existing torch optional dependency is selected.

[github-actions]

PR governance

This PR follows the template and is marked ready for human review.

[JerrettDavis]

Thanks for the targeted fix and tests. The local checks pass, but this does not fully solve #1931 for headroom-ai[all] on Intel macOS.

The direct torch entries in [ml] and [voice] are guarded, but [all] still expands to [memory] and [evals], and both include sentence-transformers. In the lock metadata, sentence-transformers has an unguarded dependency on torch (uv.lock has name = "sentence-transformers" with { name = "torch" } under that package), so an Intel macOS [all] resolve can still reach torch transitively.

I verified this from the PR branch with a resolver-style check against pyproject.toml: for sys_platform=darwin and platform_machine=x86_64, [all] still selects sentence-transformers=True and datasets=True, while only direct torch=False. That leaves the original failure path open.

Passing local checks:

• python -m pytest tests/test_optional_dependencies.py -q
• python -m ruff check tests/test_optional_dependencies.py
• python -m ruff format --check tests/test_optional_dependencies.py pyproject.toml
• git diff --check headroomlabs/main...HEAD

Please update the fix to guard the torch-bearing extras from [all] on Intel macOS, or otherwise prove the full transitive [all] resolve no longer selects torch there.

[ousamabenyounes]

Addressed the remaining Intel macOS [all] path. [memory] and [evals] now guard sentence-transformers with the same darwin/x86_64 exclusion, and uv.lock metadata reflects that [all] no longer selects the torch-bearing sentence-transformers dependency on Intel macOS.\n\nChecks:\n- RED: python3 -m pytest tests/test_optional_dependencies.py -q before the fix -> [all] selected sentence-transformers from the locked torch-bearing set\n- GREEN: python3 -m pytest tests/test_optional_dependencies.py -q -> 1 passed\n- uv run ruff check tests/test_optional_dependencies.py\n- uv run ruff format --check tests/test_optional_dependencies.py pyproject.toml\n- git diff --check upstream/main...HEAD

[JerrettDavis]

Looks good now. The Intel macOS [all] path is covered: direct torch extras are guarded, and the torch-bearing sentence-transformers entries from [memory] and [evals] are also excluded for darwin/x86_64.

Verified locally:

• uv run pytest tests/test_optional_dependencies.py -q -> 1 passed
• uv run ruff check tests/test_optional_dependencies.py
• uv run ruff format --check tests/test_optional_dependencies.py pyproject.toml
• git diff --check FETCH_HEAD...HEAD

CI is green as well.