library-api: add version validation script

Author: prestoncabe

bin/validate-library-api-version

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+
+# library-api Version Validation Script
+# Ensures pom.xml version matches git tag
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+LIBRARY_API_DIR="$REPO_ROOT/library-api"
+POM_FILE="$LIBRARY_API_DIR/pom.xml"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+print_error() {
+    echo -e "${RED}ERROR: $1${NC}" >&2
+}
+
+print_success() {
+    echo -e "${GREEN}✓ $1${NC}"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠ $1${NC}"
+}
+
+# Check if we're in a git repository
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+    print_error "Not in a git repository"
+    exit 1
+fi
+
+# Check if pom.xml exists
+if [ ! -f "$POM_FILE" ]; then
+    print_error "pom.xml not found at $POM_FILE"
+    exit 1
+fi
+
+# Check if Maven is available
+if ! command -v mvn &> /dev/null; then
+    print_error "Maven (mvn) not found. Please install Maven or use devbox."
+    exit 1
+fi
+
+# Extract version from pom.xml using Maven
+cd "$LIBRARY_API_DIR"
+POM_VERSION=$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout 2>/dev/null || echo "")
+
+if [ -z "$POM_VERSION" ]; then
+    print_error "Could not extract version from pom.xml"
+    exit 1
+fi
+
+# Expected git tag based on pom.xml version
+EXPECTED_TAG="library-api-v${POM_VERSION}"
+
+# Check if we're being called in a pre-push hook context
+# In that case, check if a library-api-v* tag is being pushed
+if [ -n "$1" ] && [ "$1" = "--pre-push-hook" ]; then
+    # Read stdin to get refs being pushed
+    TAG_BEING_PUSHED=""
+    while read local_ref local_sha remote_ref remote_sha; do
+        # Check if it's a tag push matching library-api-v*
+        if [[ "$remote_ref" =~ refs/tags/library-api-v.* ]]; then
+            TAG_BEING_PUSHED="${remote_ref#refs/tags/}"
+
+            # Validate the tag matches pom.xml version
+            if [ "$TAG_BEING_PUSHED" != "$EXPECTED_TAG" ]; then
+                echo ""
+                print_error "Version mismatch detected!"
+                echo ""
+                echo "  Tag being pushed:     $TAG_BEING_PUSHED"
+                echo "  Expected tag:         $EXPECTED_TAG"
+                echo "  pom.xml version:      $POM_VERSION"
+                echo ""
+                echo "To fix this issue:"
+                echo "  1. Delete the incorrect tag: git tag -d $TAG_BEING_PUSHED"
+                echo "  2. Use the helper script: cd library-api && ./bin/tag-release $POM_VERSION"
+                echo ""
+                exit 1
+            fi
+
+            print_success "Version validation passed: $TAG_BEING_PUSHED matches pom.xml version $POM_VERSION"
+            exit 0
+        fi
+    done
+
+    # No library-api tag being pushed, validation not needed
+    exit 0
+fi
+
+# Manual validation mode (not in pre-push hook)
+# Check if the expected tag exists locally or remotely
+TAG_EXISTS_LOCAL=$(git tag -l "$EXPECTED_TAG")
+TAG_EXISTS_REMOTE=$(git ls-remote --tags origin "$EXPECTED_TAG" 2>/dev/null | grep -c "$EXPECTED_TAG" || echo "0")
+
+if [ -n "$TAG_EXISTS_LOCAL" ]; then
+    print_success "Local tag $EXPECTED_TAG exists and matches pom.xml version $POM_VERSION"
+    exit 0
+elif [ "$TAG_EXISTS_REMOTE" -gt 0 ]; then
+    print_success "Remote tag $EXPECTED_TAG exists and matches pom.xml version $POM_VERSION"
+    exit 0
+else
+    print_warning "No git tag found for current pom.xml version"
+    echo ""
+    echo "  pom.xml version:      $POM_VERSION"
+    echo "  Expected tag:         $EXPECTED_TAG"
+    echo ""
+    echo "To create a release tag:"
+    echo "  cd library-api && ./bin/tag-release $POM_VERSION"
+    echo ""
+    exit 1
+fi