Add release automation with semantic versioning

[DeDuckProject]

Summary

This PR introduces a standardized release process for the project using semantic versioning with immutable semver tags and floating major version tags, following GitHub Actions conventions.

Key Changes

• Release script (scripts/release.sh): Automates the creation and management of release tags

  • Validates semantic version format (X.Y.Z)
  • Creates immutable semver tags (v1.0.0, v1.2.3, etc.)
  • Force-updates floating major tags (v1, v2) to point to the latest release in each major line
  • Ensures clean working tree before tagging
  • Pushes both tag types to origin

• Release workflow (.github/workflows/release.yml): GitHub Actions automation

  • Triggers on semver tag pushes (v*.*.*)
  • Automatically creates GitHub Releases with auto-generated release notes
  • Requires contents: write permission

• Documentation (CLAUDE.md): Added comprehensive versioning guidelines

  • Explains semantic vs. floating major tags and their purpose
  • Defines what constitutes a breaking change
  • Documents the release process and script usage
  • Emphasizes using the script instead of manual tagging

Notable Implementation Details

• The release script strips leading v from input to normalize version format
• Semver tags are protected from accidental overwrites (script exits if tag exists)
• Floating major tags use --force to always point to the latest compatible release
• Both tags are pushed atomically as part of the release process
• The workflow uses softprops/action-gh-release for reliable release creation

https://claude.ai/code/session_015h9iYcSULNLdxvk8aZ8v3g