Implement type hint stubs for cfa-cloudops

[uhc7]

Summary

Implements type hint stub support for cfa-cloudops as requested in #287.

This follows the relevant typing/package approach used in cfa-dataops, while keeping the implementation specific to CloudOps. CloudOps does not require the dynamic catalog stub-generation logic used by DataOps.

Changes

• Added cfa/cloudops/py.typed to mark the package as typed.
• Added cfa/cloudops/__init__.pyi for the public lazy-loaded API:
  • CloudClient
  • ContainerAppClient
  • FunctionAppClient
  • run_experiment
  • run_tasks
  • Task
• Updated Hatch build configuration to include the typing resources in package artifacts.
• Added tests verifying typing resources and public API exports.

Validation

• Focused type-stub tests: 2 passed.
• Ruff check and format: passed.
• Targeted pre-commit checks: passed.
• Built the wheel successfully and verified that it contains:
  • cfa/cloudops/py.typed
  • cfa/cloudops/__init__.pyi
• Installed the built wheel into an isolated environment and confirmed the typing resources are available from the installed cfa.cloudops package.
• Full test suite: 272 passed, 1 failed.
  • The remaining failure is the existing Windows-specific tests/test_batch_helpers.py::test_download_job_stats failure caused by the /tmp/job-stats.json.csv path and is unrelated to these changes.

Fixes #287

[ryanraaschCDC]

looks great! remember to bump the version in pyproject and update the changelog