chore: Update to use the version tag directly since metadata service can handle it (#39)

Author: mvicknr

.github/workflows/test_action.yml

@@ -37,9 +37,9 @@ jobs:
           git tag -f v0.0.0 HEAD
           git push -f origin v0.0.0
 
-  test-agent-flow-no-v-version:
+  test-agent-flow-basic:
     needs: setup-test-tag
-    name: Test Agent Repository Flow
+    name: Test Agent Repository Flow (Basic)
     runs-on: ubuntu-latest
     steps:
       - name: Checkout action repository
@@ -84,7 +84,7 @@ jobs:
           newrelic-client-id: fake-client-id-for-testing
           newrelic-private-key: ZmFrZS1wcml2YXRlLWtleS1mb3ItdGVzdGluZwo=
           agent-type: 'myagent'
-          version: '0.0.0'
+          version: 'v0.0.0'
           cache: false
 
       - name: Show mock server logs
@@ -101,9 +101,9 @@ jobs:
             rm mock-server.pid
           fi
 
-  test-agent-flow-v-version:
+  test-agent-flow-with-oci:
     needs: setup-test-tag
-    name: Test Agent Repository Flow with "v" prefixed version
+    name: Test Agent Repository Flow (with OCI uploads)
     runs-on: ubuntu-latest
     services:
       registry:
@@ -356,7 +356,7 @@ jobs:
   cleanup-test-tag:
     name: Cleanup Test Tag
     runs-on: ubuntu-latest
-    needs: [test-agent-flow-no-v-version, test-agent-flow-v-version, test-docs-flow]
+    needs: [test-agent-flow-basic, test-agent-flow-with-oci, test-docs-flow]
     if: always()
     steps:
       - name: Checkout action repository

CLAUDE.md

@@ -92,9 +92,6 @@ go test -v -run TestLoadEnv_Success ./internal/config
 # Local development (requires GITHUB_WORKSPACE to be set)
 export GITHUB_WORKSPACE=/path/to/repo
 ./agent-metadata-action
-
-# Or use run_local.sh for testing
-./run_local.sh
 ```
 
 ## Architecture
@@ -371,7 +368,7 @@ export GITHUB_WORKSPACE=/path/to/repo
 - `newrelic-client-id` (required): NewRelic client ID for authentication
 - `newrelic-private-key` (required): NewRelic private key content (base64-encoded)
 - `agent-type` (optional): Agent type (e.g., "NRDotNetAgent")
-- `version` (optional): Agent version in semver format (e.g., "1.2.3" or "v1.2.3")
+- `version` (optional): Agent version tag name (e.g., "v1.2.3"). Must match the exact git tag name for checkout.
 - `fetch-depth` (optional, default: 1): Number of commits to fetch (>1 may be needed for docs flow)
 - `cache` (optional, default: true): Enable Go build caching
 - `oci-registry` (optional): OCI registry URL for binary uploads (e.g., "ghcr.io/newrelic/agents"). Leave empty to skip binary upload.
@@ -381,11 +378,11 @@ export GITHUB_WORKSPACE=/path/to/repo
 
 **Steps:**
 
-1. **Normalize version tag**: Prepends "v" to version if not present for tag checkout
-   - Output: `ref` variable with normalized version tag
+1. **Set version ref**: Sets the version tag for checkout
+   - Output: `ref` variable with the exact version tag provided
 
 2. **Checkout repository**: Uses `actions/checkout@v4`
-   - For agent flow: Checks out the normalized version tag (e.g., "v1.2.3")
+   - For agent flow: Checks out the exact version tag as provided (e.g., "v1.2.3")
    - For docs flow: Checks out the PR commit (when `ref` is empty)
    - Uses `fetch-depth` input for controlling commit history depth
    - Sets `GITHUB_WORKSPACE` environment variable automatically
@@ -426,7 +423,7 @@ export GITHUB_WORKSPACE=/path/to/repo
 
 **Key behaviors:**
 - The action automatically handles repository checkout, so users don't need a separate `actions/checkout` step
-- Version normalization ensures consistent tag format (with "v" prefix)
+- Version tag must match the exact git tag name (no automatic normalization)
 - Authentication is handled automatically and securely (credentials masked in logs)
 - Both agent and docs flows are supported based on whether inputs are provided
 - OCI binary uploads are optional and only occur in agent flow when `oci-registry` is configured

README.md

@@ -46,7 +46,7 @@ jobs:
           newrelic-client-id: ${{ secrets.OAUTH_CLIENT_ID }}
           newrelic-private-key: ${{ secrets.OAUTH_CLIENT_SECRET }}
           agent-type: NRDotNetAgent # Required for agent release workflow: The type of agent (e.g., NRJavaAgent, NRNodeAgent)
-          version: 1.0.0 # Required for agent release workflow: will be used to check out appropriate release tag
+          version: v1.0.0 # Required for agent release workflow: must match exact git tag name for checkout
           cache: true  # Optional: Enable Go build cache (default: true)
           oci-registry: docker.io/newrelic/agents  # Optional: OCI registry URL for binary uploads
           oci-username: ${{ github.actor }}  # Optional: OCI registry username

action.yml

@@ -12,7 +12,7 @@ inputs:
     required: false
     default: ''
   version:
-    description: 'Agent version in semver format (ex. 1.2.3 or v1.2.3). The action will prepend "v" if not present for tag checkout.'
+    description: 'Agent version tag name (ex. v1.2.3). Must match the exact git tag name for checkout.'
     required: false
     default: ''
   fetch-depth:
@@ -46,16 +46,11 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - name: Normalize version tag for checkout
+    - name: Set version ref for checkout
       id: version
       shell: bash
       run: |
-        VERSION="${{ inputs.version }}"
-        if [[ -n "$VERSION" && ! "$VERSION" =~ ^v ]]; then
-          echo "ref=v${VERSION}" >> $GITHUB_OUTPUT
-        else
-          echo "ref=${VERSION}" >> $GITHUB_OUTPUT
-        fi
+        echo "ref=${{ inputs.version }}" >> $GITHUB_OUTPUT
 
     - name: Checkout repository
       uses: actions/checkout@v4