[tamird]

kubernetes-stubs is partial, so an omitted module or member falls
back to the runtime package. The runtime is mostly unannotated, so
Watch streams, quantity helpers, and the ApiClient stored by generated
API classes become Any.

Describe Watch.stream in terms of the watched callable's list item
type or the class literal passed to Watch. Preserve the callable's
arguments with ParamSpec. Model bookmark and invalid-line results
explicitly. Calls that set deserialize and non-list methods remain
object: the runtime consumes that keyword itself and uses docstrings,
not the callable's return annotation, to distinguish log streams.

Mirror the runtime's package-shaped kubernetes.watch and
kubernetes.utils modules. Add the public quantity and ApiClient
interfaces, generate api_client on each API class, and retain the
handwritten client exports when the generator writes its final
__all__.

Use uv for code generation, wheel builds, and checker dependencies so
local checks and release workflows share one locked environment. The
pull-request check builds and installs a Kubernetes 36.0.2 wheel,
removes the generated source tree, and exercises the public types with
mypy, Pyright, and ty.

Ty currently leaves the generic protocol specialization as Unknown.
The three affected assertions stay enforced by mypy and Pyright; ty
uses scoped suppressions and will report them as unused when its
constraint solver supports this case.

[tamird]

@lexdene my codex went a little further than expected here, but I did have it split the changes into multiple commits in case you wanted to merge without squashing or if you want, I am happy to send multiple PRs. Please let me know, and thanks for maintaining this project!

[lexdene]

This PR is too large for me to review thoroughly.
I suggest breaking it down and focusing this one solely on the changes related to the kubernetes.watch typing.

[tamird]

I am just going to fix upstream kubernetes client to have proper types. Thanks! Follow along in

• Regenerate the synchronous client with the modern Python generator kubernetes-client/python#2631
• Regenerate the asyncio client with dependency-free lazy imports kubernetes-client/python#2647
• python: simplify lazy-import type-checking guards OpenAPITools/openapi-generator#24403