🧪 Enforce type annotations with MyPy

[webknjaz]

No description provided.

[Copilot]

Pull Request Overview

This PR introduces comprehensive type annotations to enforce type safety across the codebase using MyPy. It adds MyPy configuration for multiple Python versions (3.11-3.13) and creates type definitions to ensure proper type checking.

• Adds explicit return type annotations (-> None) to functions that were missing them
• Introduces TypedDict classes to define structured types for JSON data handling
• Replaces os.getenv() with os.environ[] for required environment variables to improve type safety

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
print-pkg-names.py	Adds return type annotation to debug function
oidc-exchange.py	Comprehensive type annotations including TypedDict definitions and improved null handling
attestations.py	Adds null check for OIDC token detection and environment variable access
_type_stubs/id.pyi	Creates type stub file for the id module
.pre-commit-config.yaml	Configures MyPy pre-commit hooks for Python 3.11-3.13
.mypy.ini	Adds comprehensive MyPy configuration with strict type checking

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[webknjaz]

@woodruffw could you take a look? Specifically, I'm interested in possible runtime side effects. If there's no problems at runtime, I'll merge right away.

[woodruffw]

Sure, I can look later today 🙂

[webknjaz]

@woodruffw thanks!

[woodruffw]

LGTM -- I did a pass for side effects and don't see any.