diff --git a/.gradle/nb-cache/daily-notification-plugin-650793354/project-info.ser b/.gradle/nb-cache/daily-notification-plugin-650793354/project-info.ser
deleted file mode 100644
index 1ce5e20..0000000
Binary files a/.gradle/nb-cache/daily-notification-plugin-650793354/project-info.ser and /dev/null differ
diff --git a/.gradle/nb-cache/lib-787053696/project-info.ser b/.gradle/nb-cache/lib-787053696/project-info.ser
deleted file mode 100644
index fe118e9..0000000
Binary files a/.gradle/nb-cache/lib-787053696/project-info.ser and /dev/null differ
diff --git a/.gradle/nb-cache/subprojects.ser b/.gradle/nb-cache/subprojects.ser
deleted file mode 100644
index 9ddac02..0000000
Binary files a/.gradle/nb-cache/subprojects.ser and /dev/null differ
diff --git a/.gradle/nb-cache/trust/CF37DF473B63082CB422CF366D6DE6262AC1AECC238F3058A752FA9D899EB24E b/.gradle/nb-cache/trust/CF37DF473B63082CB422CF366D6DE6262AC1AECC238F3058A752FA9D899EB24E
deleted file mode 100644
index b5d1620..0000000
--- a/.gradle/nb-cache/trust/CF37DF473B63082CB422CF366D6DE6262AC1AECC238F3058A752FA9D899EB24E
+++ /dev/null
@@ -1 +0,0 @@
-DB3AE51713EFB84E05BC35EBACB3258E9428C8277A536E2102ACFF8EAB42145B
diff --git a/scripts/check-version-consistency.sh b/scripts/check-version-consistency.sh
new file mode 100755
index 0000000..576c0bc
--- /dev/null
+++ b/scripts/check-version-consistency.sh
@@ -0,0 +1,66 @@
+#!/bin/bash
+# Check version consistency across package.json and documentation files
+# Exit code 0 if consistent, 1 if inconsistent
+
+set -euo pipefail
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$PROJECT_ROOT"
+
+# Get version from package.json (source of truth)
+PACKAGE_VERSION=$(node -e "console.log(require('./package.json').version)")
+
+if [ -z "$PACKAGE_VERSION" ]; then
+  echo "❌ ERROR: Could not read version from package.json"
+  exit 1
+fi
+
+echo "📦 Package version (source of truth): $PACKAGE_VERSION"
+echo ""
+
+ERRORS=0
+
+# Check README.md
+if [ -f "README.md" ]; then
+  README_VERSION=$(grep -iE "^\\*\\*Version\\*\\*:" README.md | head -1 | sed -E 's/.*Version\*\*:[[:space:]]*([0-9]+\.[0-9]+\.[0-9]+).*/\1/' || echo "")
+  if [ -n "$README_VERSION" ] && [ "$README_VERSION" != "$PACKAGE_VERSION" ]; then
+    echo "❌ README.md version mismatch: found '$README_VERSION', expected '$PACKAGE_VERSION'"
+    ERRORS=1
+  else
+    echo "✅ README.md version matches"
+  fi
+fi
+
+# Check src/definitions.ts
+if [ -f "src/definitions.ts" ]; then
+  DEFS_VERSION=$(grep -E "@version" src/definitions.ts | head -1 | sed -E 's/.*@version[[:space:]]+([0-9]+\.[0-9]+\.[0-9]+).*/\1/' || echo "")
+  if [ -n "$DEFS_VERSION" ] && [ "$DEFS_VERSION" != "$PACKAGE_VERSION" ]; then
+    echo "❌ src/definitions.ts version mismatch: found '$DEFS_VERSION', expected '$PACKAGE_VERSION'"
+    ERRORS=1
+  else
+    echo "✅ src/definitions.ts version matches"
+  fi
+fi
+
+# Check other common locations
+for file in "src/index.ts" "src/web.ts" "src/observability.ts"; do
+  if [ -f "$file" ]; then
+    FILE_VERSION=$(grep -E "@version" "$file" 2>/dev/null | head -1 | sed -E 's/.*@version[[:space:]]+([0-9]+\.[0-9]+\.[0-9]+).*/\1/' || echo "")
+    if [ -n "$FILE_VERSION" ] && [ "$FILE_VERSION" != "$PACKAGE_VERSION" ]; then
+      echo "⚠️  $file version mismatch: found '$FILE_VERSION', expected '$PACKAGE_VERSION'"
+      # Warning only, not an error
+    fi
+  fi
+done
+
+echo ""
+if [ $ERRORS -eq 0 ]; then
+  echo "✅ All version checks passed"
+  exit 0
+else
+  echo "❌ Version consistency check failed"
+  echo ""
+  echo "Fix: Update version headers to match package.json version: $PACKAGE_VERSION"
+  exit 1
+fi
+