Add git_resources input for per-step Git resource refs (SF-2251)

[NickJosevski]

Draft — depends on OctopusDeploy/api-client.ts#279. See "Dependency" below.

What

Adds a new git_resources action input that lets a release target a specific Git reference for a step's Git resource at release-creation time.

Format (multi-line, mirrors the Octopus CLI --git-resource flag):

- uses: OctopusDeploy/create-release-action@v4
  with:
    project: "My Argo Project"
    git_resources: |
      Update Argo CD Application Manifests:${{ github.head_ref || github.ref_name }}

StepName:GitRef or StepName:GitResourceName:GitRef.

Why

For version-controlled / Argo CD projects, the branch a step's Git resource points at is resolved at release creation, before Octopus variables are evaluated — so it could not previously be set from GitHub Actions (variables resolve too late, defaulting the release to main). The server API, Go SDK, and CLI already support this via gitResources; only the Action lacked an input. This closes that gap.

Customer request SF-2251: deploy a feature branch to Dev from GitHub Actions by pointing the Update Argo CD Application Manifests step at the pushed branch.

How it flows

git_resources input → InputParameters.gitResources → CreateReleaseCommandV1.GitResources → POST /releases/create/v1. The step's SelectedGitResources on the created release then reflect the chosen ref.

Verification

Proven end-to-end against a real Octopus instance + a version-controlled Argo project: the built dist (run exactly as the runner invokes it) created a release whose SelectedGitResources targeted the feature branch's commit, and a real GitHub-hosted-runner workflow (push + pull_request) produced the same result.

Tests

Unit test asserting git_resources is parsed into gitResources (single and named-resource forms).

Dependency (why this is a draft)

Requires GitResources on CreateReleaseCommandV1 from OctopusDeploy/api-client.ts#279. Until that ships, package.json temporarily sources @octopusdeploy/api-client from the companion PR branch. Before merge: bump to the published api-client version and rebuild dist.

🤖 Generated with Claude Code

[NickJosevski]

Reopening from an in-org branch (OctopusDeploy:sf2251-git-resources) with the diff trimmed to source only.