ci: build release API docs on every PR

[jbedard]

Changes are visible to end-users: no

Test plan

• Covered by existing test cases
• New test cases added

[aspect-workflows]

✨ Aspect Workflows Tasks

📅 Wed Jul 8 05:04:14 UTC 2026

✅ 36 successful tasks

• ✅ buildifier · ⏱ 20.7s · 🐙 GitHub Actions · ☑️ Check
  💬 Format complete (clean)
• ✅ gazelle · ⏱ 21.4s · 🐙 GitHub Actions · ☑️ Check
  💬 Gazelle complete (clean)
• ✅ test-e2e-bazel-8 [test] · ⏱ 3m 20s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (195/195 passed)
• ✅ test-e2e-bazel-9 [test] · ⏱ 3m 43s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (189/189 passed)
• ✅ test-e2e-interpreter-input-validation-bazel-8 [test] · ⏱ 18.4s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-interpreter-input-validation-bazel-9 [test] · ⏱ 1m 14s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-interpreter-runtime-metadata-bazel-8 [test] · ⏱ 23.5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (2/2 passed · 2 cached)
• ✅ test-e2e-interpreter-runtime-metadata-bazel-9 [test] · ⏱ 37.5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (2/2 passed)
• ✅ test-e2e-interpreter-toolchain-settings-bazel-8 [test] · ⏱ 19.5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-interpreter-toolchain-settings-bazel-9 [test] · ⏱ 46.5s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-rules-proto-grpc-python-bazel-8 [test] · ⏱ 1m 55s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-e2e-rules-proto-grpc-python-bazel-9 [test] · ⏱ 1m 29s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-debugger-bazel-8 [test] · ⏱ 25.9s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-debugger-bazel-9 [test] · ⏱ 51.6s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-dev_deps-bazel-8 [test] · ⏱ 27.9s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-dev_deps-bazel-9 [test] · ⏱ 1m 17s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-django-bazel-8 [test] · ⏱ 23.6s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-django-bazel-9 [test] · ⏱ 1m 52s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-multi_version-bazel-8 [test] · ⏱ 26.7s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (2/2 passed)
• ✅ test-examples-multi_version-bazel-9 [test] · ⏱ 1m 19s · 🐙 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 28s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-py_binary-bazel-8 [test] · ⏱ 20.4s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-py_binary-bazel-9 [test] · ⏱ 46.8s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-py_pex_binary-bazel-8 [test] · ⏱ 25.6s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed · 1 cached)
• ✅ test-examples-py_pex_binary-bazel-9 [test] · ⏱ 45s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-py_venv-bazel-8 [test] · ⏱ 23.2s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (3/3 passed)
• ✅ test-examples-py_venv-bazel-9 [test] · ⏱ 46.8s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (3/3 passed)
• ✅ test-examples-pytest-bazel-8 [test] · ⏱ 50.4s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (9/9 passed)
• ✅ test-examples-pytest-bazel-9 [test] · ⏱ 1m 50s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (9/9 passed)
• ✅ test-examples-uv_pip_compile-bazel-8 [test] · ⏱ 26.7s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-uv_pip_compile-bazel-9 [test] · ⏱ 49.7s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-virtual_deps-bazel-8 [test] · ⏱ 23.2s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-examples-virtual_deps-bazel-9 [test] · ⏱ 33.9s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (1/1 passed)
• ✅ test-root-bazel-8 [test] · ⏱ 2m 37s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (234/234 passed)
• ✅ test-root-bazel-9 [test] · ⏱ 3m 23s · 🐙 GitHub Actions · ☑️ Check
  💬 Bazel test complete (233/233 passed)

---

_{⏱ Last updated Wed Jul 8 05:07:54 UTC 2026 · 📊 GitHub API quota 2,524/15,000 (17% used, resets in 40m)
🚀 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)	192.902	188.083	±17.347	—	—	18.01
HEAD main	59.972	59.869	±0.605	-68.9%	—	10.23
This PR	60.357	60.151	±1.040	-68.7%	+0.6%	7.20

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.

✅ No regression detected (PR is +0.6% vs HEAD main)

[github-actions]

py_binary startup benchmark

Version	Mean (ms)	Median (ms)	± stddev	vs BCR	vs main	Build (s)
BCR 1.11.7 (baseline)	182.182	179.438	±7.825	—	—	44.75
HEAD main	58.960	58.654	±1.802	-67.6%	—	10.44
This PR	59.783	59.297	±1.719	-67.2%	+1.4%	7.51

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	Packages	Targets
BCR 2.0.0-alpha.4 (baseline)	11331.813	11284.039	±161.494	—	—	101	301
HEAD main	10466.419	10488.158	±106.387	-7.6%	—	101	301
This PR	10517.879	10538.609	±123.623	-7.2%	+0.5%	101	301

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.

Auxiliary metrics

Version	Loaded packages	Configured targets
BCR 2.0.0-alpha.4 (baseline)	101	301
HEAD main	101	301
This PR	101	301