HYPERFLEET-930 - ci: skip version bump check for non-contract PRs

Only require version bump when .tsp files change. Docs, CI, and
tooling changes no longer trigger unnecessary releases.

Author: kuudori

.github/workflows/ci.yml

@@ -39,7 +39,24 @@ jobs:
         run: |
           npx spectral lint schemas/core/openapi.yaml --format github-actions --fail-severity warn
 
+      - name: Check for contract changes
+        id: contract
+        run: |
+          BASE_REF="${{ github.event.pull_request.base.sha || github.event.before }}"
+          if [ -z "$BASE_REF" ] || ! git cat-file -e "$BASE_REF" 2>/dev/null; then
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          CHANGED=$(git diff --name-only "$BASE_REF" HEAD -- '*.tsp')
+          if [ -n "$CHANGED" ]; then
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+            echo "No contract files changed — skipping version bump check"
+          fi
+
       - name: Check version bump
+        if: steps.contract.outputs.changed == 'true'
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |

AGENTS.md

@@ -2,17 +2,19 @@
 
 TypeSpec sources that generate the HyperFleet core OpenAPI specification. Published as the `hyperfleet` npm package for provider-specific repos (e.g., `hyperfleet-api-spec-gcp`). Also consumed as a Go module via `schemas/schemas.go` (`embed.FS`).
 
-## Critical path
+## Verification
 
-```bash
-npm install                                                    # Install TypeSpec compiler + deps
-./build-schema.sh                                              # Build core OpenAPI spec
-npx spectral lint schemas/core/openapi.yaml --fail-severity warn  # Lint (matches CI strictness)
-```
+| Command | What it does |
+|---|---|
+| `npm install` | Install TypeSpec compiler + deps |
+| `./build-schema.sh` | Build core OpenAPI spec |
+| `npx spectral lint schemas/core/openapi.yaml --fail-severity warn` | Lint (matches CI strictness) |
+
+Pre-push order: `npm install` → `./build-schema.sh` → `spectral lint`.
 
 **IMPORTANT:** `schemas/core/openapi.yaml` is committed. CI runs `git diff --exit-code schemas/` — if you change TypeSpec sources, rebuild and commit the schema in the same PR.
 
-**IMPORTANT:** Every PR must bump the version in `main.tsp` (the `version` field inside the `@info` decorator). CI compares against the latest release tag and blocks if unchanged or lower.
+**IMPORTANT:** PRs that change `.tsp` files must bump the version in `main.tsp` (the `version` field inside the `@info` decorator). CI compares against the latest release tag and blocks if unchanged or lower. Non-contract PRs (docs, CI, tooling) skip this check.
 
 When bumping version:
 1. Edit the `version` field inside the `@info` decorator in `main.tsp`