docs(release): 2.29.0 notes — the compiled resolver

[lesnik512]

Draft of planning/releases/2.29.0.md, the verbatim body for the 2.29.0 GitHub Release. Covers the full 2.28.0→2.29.0 backlog.

Headline

• Single-path compiled resolver (Single-path compiled-closure resolver #334) with measured perf (guard-tier medians): transient -37%, warm singleton -31%, deep chain -61%, wide -62%; lifecycle -6.5%, build-child ~flat.
• Wiring-plan memoization on the registry (perf: memoize wiring plans on the registry, shared tree-wide #326); per-node hot-path tax trimmed (A1–A4).

Fixes

• fix(wiring): honor the creator default for a ContextProvider passed via kwargs #340 — ContextProvider via kwargs={...} now honors the creator default (the ContextValueNoneWarning on optional-Request creators).
• fix: NoneType parameters lose their default and their nullability #321 — NoneType params keep their default and nullability.
• fix: validate() traverses providers supplied via kwargs= #320 — validate() traverses providers supplied via kwargs=.

Breaking change

• The provider-type set is closed; subclassing AbstractProvider/Factory raises TypeError at first resolve. The notes carry this warning under an explicit heading, per planning/decisions/2026-07-17-custom-providers-retracted.md.

just check-planning passes. Tagging/publishing stays with the maintainer — this PR only lands the notes file.

🤖 Generated with Claude Code

[github-actions]

Benchmark

Details

Benchmark suite	Current: 283355d	Previous: 1f41fb6	Ratio
benchmarks/test_guard_lifecycle.py::test_g6_build_child_container	527419.7507204997 iter/sec (stddev: 0.0000420993829727779)	394943.7980686877 iter/sec (stddev: 0.00006574871089200236)	0.75
benchmarks/test_guard_lifecycle.py::test_g7_request_lifecycle	94566.31885239917 iter/sec (stddev: 0.000010031414260362924)	73178.6926741399 iter/sec (stddev: 0.000013030541070699313)	0.77
benchmarks/test_guard_resolve.py::test_g1_transient_resolve	1555931.403746593 iter/sec (stddev: 3.904094774511056e-7)	1183710.4709005877 iter/sec (stddev: 9.019328609723592e-7)	0.76
benchmarks/test_guard_resolve.py::test_g2_cached_resolve	2947435.1560046095 iter/sec (stddev: 3.88152271338114e-8)	2253746.2547900085 iter/sec (stddev: 1.9784401491421818e-7)	0.76
benchmarks/test_guard_resolve.py::test_g3_deep_chain	658692.5057065138 iter/sec (stddev: 3.3584044376541014e-7)	501203.53868838586 iter/sec (stddev: 5.442464126348895e-7)	0.76
benchmarks/test_guard_resolve.py::test_g4_wide_resolve	402441.63245942234 iter/sec (stddev: 4.1615539390337864e-7)	314790.8661277014 iter/sec (stddev: 7.618119698663759e-7)	0.78
benchmarks/test_guard_resolve.py::test_g5_cross_scope	1413845.457158623 iter/sec (stddev: 2.9427872085648073e-7)	1039052.0461773115 iter/sec (stddev: 6.144906544265567e-7)	0.73

This comment was automatically generated by workflow using github-action-benchmark.