feat: provide uv.package_quirks() for declaring workarounds for bad/odd packages

[jbedard]

---

Changes are visible to end-users: yes/no

• Searched for relevant documentation and updated as needed: yes/no
• Breaking change (forces users to change their own code or config): yes/no
• Suggested release notes appear below: yes/no

Test plan

• Covered by existing test cases
• New test cases added
• Manual testing; please provide instructions so we can reproduce:

[aspect-workflows]

✨ Aspect Workflows Tasks

📅 Thu Aug 13 00:53:28 UTC 2026

✅ 42 successful tasks

• ✅ buildifier · ⏱ 22.2s · 🐙 GitHub Actions · ☑️ Check
  💬 Format complete (clean)
• ✅ gazelle · ⏱ 15.7s · 🐙 GitHub Actions · ☑️ Check
  💬 Gazelle complete (clean)
• ✅ test-e2e-bazel-8 [test] · ⏱ 4m 57s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (280/280 passed)
• ✅ test-e2e-bazel-9 [test] · ⏱ 5m 23s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (274/274 passed)
• ✅ test-e2e-interpreter-build-config-bazel-8 [test] · ⏱ 19.8s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-interpreter-build-config-bazel-9 [test] · ⏱ 43.5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-interpreter-input-validation-bazel-8 [test] · ⏱ 17.5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-interpreter-input-validation-bazel-9 [test] · ⏱ 1m 18s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-interpreter-runtime-metadata-bazel-8 [test] · ⏱ 30.8s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (2/2 passed)
• ✅ test-e2e-interpreter-runtime-metadata-bazel-9 [test] · ⏱ 48.9s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (2/2 passed)
• ✅ test-e2e-interpreter-toolchain-settings-bazel-8 [test] · ⏱ 19.3s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-interpreter-toolchain-settings-bazel-9 [test] · ⏱ 53.5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-rules-proto-grpc-python-bazel-8 [test] · ⏱ 1m 54s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-rules-proto-grpc-python-bazel-9 [test] · ⏱ 1m 42s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-rules-python-interop-bazel-8 [test] · ⏱ 34.7s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (11/11 passed)
• ✅ test-e2e-rules-python-interop-bazel-9 [test] · ⏱ 1m 3s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (11/11 passed)
• ✅ test-e2e-rules-python-provider-compat-bazel-8 [test] · ⏱ 26.3s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (3/3 passed)
• ✅ test-e2e-rules-python-provider-compat-bazel-9 [test] · ⏱ 36.4s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (3/3 passed)
• ✅ test-examples-debugger-bazel-8 [test] · ⏱ 23.2s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-debugger-bazel-9 [test] · ⏱ 56.7s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-dev_deps-bazel-8 [test] · ⏱ 24.8s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-dev_deps-bazel-9 [test] · ⏱ 43.8s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-django-bazel-8 [test] · ⏱ 23.8s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-django-bazel-9 [test] · ⏱ 41.9s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-multi_version-bazel-8 [test] · ⏱ 25.9s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (2/2 passed)
• ✅ test-examples-multi_version-bazel-9 [test] · ⏱ 1m 4s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (2/2 passed)
• ✅ test-examples-protobuf-bazel-8 [test] · ⏱ 1m 34s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-protobuf-bazel-9 [test] · ⏱ 1m 55s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-py_binary-bazel-8 [test] · ⏱ 23.5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-py_binary-bazel-9 [test] · ⏱ 46.6s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-py_pex_binary-bazel-8 [test] · ⏱ 25.2s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-py_pex_binary-bazel-9 [test] · ⏱ 46.9s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-py_venv-bazel-8 [test] · ⏱ 27.2s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (3/3 passed)
• ✅ test-examples-py_venv-bazel-9 [test] · ⏱ 43.6s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (3/3 passed)
• ✅ test-examples-pytest-bazel-8 [test] · ⏱ 38.4s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (11/11 passed)
• ✅ test-examples-pytest-bazel-9 [test] · ⏱ 1m 11s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (11/11 passed)
• ✅ test-examples-uv_pip_compile-bazel-8 [test] · ⏱ 28.6s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-uv_pip_compile-bazel-9 [test] · ⏱ 1m 5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-virtual_deps-bazel-8 [test] · ⏱ 27.6s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-virtual_deps-bazel-9 [test] · ⏱ 44.9s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-root-bazel-8 [test] · ⏱ 2m 39s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (303/303 passed)
• ✅ test-root-bazel-9 [test] · ⏱ 3m 37s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (302/302 passed)

---

_{⏱ Last updated Thu Aug 13 00:58:51 UTC 2026 · 📊 GitHub API quota 911/15,000 (6% used, resets in 27m)
🚀 Powered by Aspect CLI (v2026.28.2)  |  Aspect Build · X · LinkedIn · YouTube}

[github-actions]

py_binary startup benchmark

Version	Mean (ms)	Median (ms)	± stddev	vs BCR	vs main	Build (s)
BCR 1.11.7 (baseline)	186.233	184.355	±8.665	—	—	15.64
HEAD main	59.500	59.476	±0.483	-68.1%	—	10.17
This PR	60.122	59.244	±3.086	-67.7%	+1.0%	6.86

Measured with hyperfine --warmup 5 --runs 50 on Linux
Gate: PR vs HEAD main (threshold: 10%). BCR is shown only as a historical baseline.
Build time: cold bazel build //:bench with isolated output base, no disk cache.

sys.path quality

Version	sys.path entries	distinct site-packages roots	duplicate realpaths
BCR 1.11.7 (baseline)	6	1	0
HEAD main	7	2	0
This PR	7	2	0

sys.path quality measured by bench_syspath inside the assembled venv. Duplicate realpaths indicate symlink redundancy; many distinct site-packages roots suggest an inefficient venv layout.

Bazel analysis benchmark

Version	Mean (ms)	Median (ms)	± stddev	vs BCR	vs main	Targets	Actions
BCR 2.0.0-alpha.5 (baseline)	8575.593	8581.222	±81.174	—	—	301	13672
HEAD main	7602.227	7590.362	±140.634	-11.4%	—	301	13740
This PR	7652.501	7660.788	±105.598	-10.8%	+0.7%	301	13740

Measured with hyperfine --warmup 1 --runs 10 on Linux
Gate: PR vs HEAD main (threshold: 10%). BCR is shown only as a historical baseline.
Command: cold bazel build --nobuild //workspace/... with isolated output base, no disk cache.

[coderabbitai]

Important

Review skipped

Auto 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: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 2073acdb-f2de-4d08-9571-925cf260dd5c

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

---

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