[Feature Request] Add Stack Deployment Runs API Specs

[isivaselvan]

Use-cases

StackDeploymentRuns describes all the stack-deployment-runs related methods that the HCP Terraform API supports.

• List (by group) returns a list of deployment runs within a specific deployment group.
• List (by configuration) returns a list of deployment runs across an entire stack configuration.
• Read retrieves a single deployment run by its ID.
• ReadWithOptions retrieves a deployment run by ID with optional related resources included (e.g. stack-deployment-group, stack-approval, current-step, blocked-by-deployment-group).
• ApproveAllPlans approves all current and future plans associated with a deployment run.
• Cancel cancels an in-progress deployment run, with an optional force flag.

Attempted Solutions

None, Currently not supported

Proposal

Add support for Stack Deployment Runs as a new resource family in python-tfe.

• List Stack Deployment Runs in a group
• List Stack Deployment Runs in a configuration
• Show a Stack Deployment Run
• Approve a Stack Deployment Run
• Cancel a Stack Deployment Run
• Add required models in src/pytfe/models/stack_deployment_run.py
• Add resource in src/pytfe/resources/stack_deployment_runs.py
• Update Client
• Add examples under examples folder
• Add unit tests in units

All new code should follow existing project conventions:

• Pydantic v2 models with populate_by_name=True
• alias-based JSON:API field mapping
• _Service base class
• Iterator-based pagination via _list.