fix: Ensure build scripts use correct version from CI environment

- Modified build-spec.sh to prioritize RELEASE_VERSION environment variable
- Updated build-deploy.yml to use BOOST_DOC_VERSION when available
- Fixes version mismatch where documentation showed wrong version numbers
- Ensures release builds show correct v3.1.2 version in documentation

Author: pwt-cd

.github/workflows/build-deploy.yml

@@ -57,8 +57,11 @@ jobs:
         run: |
           cd drafts/current/specifications
           
-          # Extract version using same logic as build script
-          if git rev-parse --git-dir >/dev/null 2>&1; then
+          # Extract version from environment or git tags  
+          if [ -n "$BOOST_DOC_VERSION" ] && [ "$BOOST_DOC_VERSION" != "main" ]; then
+              VERSION="$BOOST_DOC_VERSION"
+              echo "Using version from environment: $VERSION"
+          elif git rev-parse --git-dir >/dev/null 2>&1; then
               VERSION=$(git describe --tags --abbrev=0 2>/dev/null)
               if [ -z "$VERSION" ]; then
                   SHORT_HASH=$(git rev-parse --short HEAD)

drafts/current/specifications/build-spec.sh

@@ -7,9 +7,14 @@ set -e  # Exit on any error
 
 echo "🚀 Building BOOST Specification with Direct Dictionary References..."
 
-# Extract version from git tags (authoritative source)
-echo "🔧 Extracting version from git tags..."
-if git rev-parse --git-dir >/dev/null 2>&1; then
+# Extract version from environment or git tags (authoritative source)
+echo "🔧 Extracting version information..."
+
+# Check if RELEASE_VERSION is set (from CI/CD workflows)
+if [ -n "$RELEASE_VERSION" ]; then
+    VERSION="$RELEASE_VERSION"
+    echo "📋 Using release version from environment: $VERSION"
+elif git rev-parse --git-dir >/dev/null 2>&1; then
     # Get the latest version tag, fallback to commit hash if no tags
     VERSION=$(git describe --tags --abbrev=0 2>/dev/null)
     if [ -z "$VERSION" ]; then