[proposal] wheel_build_tag hook for unique wheel file names

[tiran]

Pull Request Description

What

Add proposal document for a new hook point that injects platform, accelerator, and ABI suffixes into wheel build tags.

Why

See: #1059

• PR follows CONTRIBUTING.md guidelines

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: f22a58e5-5e17-47bd-9384-1c8d7216fbeb

📥 Commits

Reviewing files that changed from the base of the PR and between 92d123b and 42ad37b.

📒 Files selected for processing (3)

• docs/proposals/index.rst
• docs/proposals/wheel-build-tag-hook.md
• docs/spelling_wordlist.txt

✅ Files skipped from review due to trivial changes (3)

• docs/spelling_wordlist.txt
• docs/proposals/index.rst
• docs/proposals/wheel-build-tag-hook.md

---

📝 Walkthrough

Walkthrough

This PR adds documentation: it registers a new proposal wheel-build-tag-hook in the proposals index, adds docs/proposals/wheel-build-tag-hook.md describing a fromager.hooks stevedore hook (wheel_build_tag) with its runner contract, inputs/outputs, validation rules, examples, and entry-point instructions, and updates docs/spelling_wordlist.txt to include libtorch and stdlib.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: adding a proposal for a wheel_build_tag hook to generate unique wheel file names.
Description check	✅ Passed	The description clearly relates to the changeset by explaining what the proposal adds and references the relevant issue #1059.
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.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/proposals/wheel-build-tag-hook.md`:
- Around line 121-124: The example hook uses the variable parts when appending
CUDA tag but the accumulator defined earlier is named result, causing an
undefined variable error; update the CUDA branch to append to result (i.e.,
replace parts.append(...) with result.append(...)) and verify other branches
consistently use the same accumulator (referencing ctx.variant and Version(...)
in the function).

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 243b235f-4791-4b2e-bff6-6ba1ef0f1db7

📥 Commits

Reviewing files that changed from the base of the PR and between 297ed76 and 20d94ef.

📒 Files selected for processing (3)

• docs/proposals/index.rst
• docs/proposals/wheel-build-tag-hook.md
• docs/spelling_wordlist.txt

[rd4398]

This is a solid design and will really help us downstream as well!

I left a few comments, after addressing those we can merge this.

[rd4398]

This looks good to me! I will wait for @LalatenduMohanty and @dhellmann to take a look as well and give feedback.

[mergify]

This pull request has merge conflicts that must be resolved before it can be merged.
@tiran please rebase your branch.