feat(AX-1837): add VERSION file, release workflow, and drift-prevention check

.github/workflows/release.yml

@@ -0,0 +1,62 @@
+# Copyright (c) JFrog Ltd. 2026
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      # Check out the repository with a token to allow pushing tags
+      - uses: actions/checkout@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      # Parse the commit message to check if a release tag keyword is present
+      - name: Detect release tag in commit message
+        id: detect
+        run: |
+          MSG="${{ github.event.head_commit.message }}"
+          if echo "$MSG" | grep -qE '\[(major|minor|patch)\]'; then
+            echo "triggered=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "triggered=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      # Read the current version from the VERSION file
+      - name: Read version
+        if: steps.detect.outputs.triggered == 'true'
+        id: version
+        run: echo "version=$(cat VERSION)" >> "$GITHUB_OUTPUT"
+
+      # Create a git tag for the release version and push it to origin
+      - name: Create and push tag
+        if: steps.detect.outputs.triggered == 'true'
+        run: |
+          git tag "v${{ steps.version.outputs.version }}"
+          git push origin "v${{ steps.version.outputs.version }}"
+
+      # Package the repository contents into a zip archive for the release
+      - name: Package release artifact
+        if: steps.detect.outputs.triggered == 'true'
+        run: zip -r release.zip . --exclude ".git/*" --exclude ".github/*"
+
+      # Create a GitHub Release with the packaged artifact and auto-generated release notes
+      - name: Create GitHub Release
+        if: steps.detect.outputs.triggered == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "v${{ steps.version.outputs.version }}" \
+            release.zip \
+            --title "Release v${{ steps.version.outputs.version }}" \
+            --generate-notes

.github/workflows/validate-version.yml

@@ -0,0 +1,26 @@
+# Copyright (c) JFrog Ltd. 2026
+name: Validate version
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Check version consistency
+        run: |
+          VERSION=$(cat VERSION)
+          FAILED=0
+
+          PLUGIN_VERSION=$(jq -r '.version' .devin-plugin/plugin.json)
+          if [ "$VERSION" != "$PLUGIN_VERSION" ]; then
+            echo "::error::Version mismatch: VERSION=$VERSION but .devin-plugin/plugin.json.version=$PLUGIN_VERSION"
+            FAILED=1
+          fi
+
+          [ "$FAILED" -eq 0 ] && echo "All versions consistent: $VERSION"
+          exit $FAILED

CONTRIBUTING.md

@@ -48,6 +48,15 @@ This downloads the pinned upstream tarball and replaces the contents of `skills/
 - [ ] If the skill tree changed: `pin` in `.github/scripts/sync-skills-vendor.json` matches the upstream tag the new tree was generated from.
 - [ ] Smoke-test: `devin plugins install . -y` and `devin plugins info jfrog` from the repo root.
 
+## Releasing
+
+To cut a release:
+
+1. In your PR, bump `VERSION` and sync `.devin-plugin/plugin.json` `.version` to match. The `validate-version` PR check enforces this.
+2. Merge to `main` with `[major]`, `[minor]`, or `[patch]` anywhere in the commit message.
+
+The release workflow reads `VERSION`, creates a `vX.Y.Z` git tag, and publishes a GitHub Release with a repo zip attached. No bot push to `main` — the version bump is part of the PR itself.
+
 ## Build order
 
 Releases follow a fixed sequence:

VERSION

@@ -0,0 +1 @@
+0.1.1