feat: add GitHub release workflow and documentation

[brianrobt]

Summary

Establishes a formal release process for gvm2 with GitHub Releases integration.

Changes

Release Workflow (.github/workflows/release.yml)

• Triggers on tag push (v*)
• Validates that the tag matches the VERSION file
• Uses ffurrer2/extract-release-notes@v2 to parse the ChangeLog (Keep a Changelog format)
• Creates a GitHub Release via softprops/action-gh-release@v2
• Marks pre-releases (-rc, -beta, -alpha) appropriately

Documentation (RELEASING.md)

• Step-by-step release process
• Version numbering guidelines based on semantic versioning
• Conventional commit → version bump mapping
• Pre-release and hotfix instructions

ChangeLog Updates

• Removes the [Unreleased] section in favor of release-driven changelog entries
• Adds reference to RELEASING.md
• Converts the pending fix (Fix duplicated PATH/GOPATH entries for global pkgset environments #8) to a versioned 1.2.1 entry

Version Bump

• Updates VERSION to 1.2.1 in preparation for the next release

Release Process Going Forward

1. Review commits since last tag to determine version bump
2. Update VERSION file
3. Add changelog entry with version and date
4. Commit with chore: release vX.Y.Z
5. Create and push tag: git tag vX.Y.Z && git push origin vX.Y.Z
6. Workflow creates GitHub Release automatically

Note on v1.2.0

The v1.2.0 release was documented in ChangeLog but never tagged. Consider retroactively tagging commit 42f3656 as v1.2.0 to maintain release history:

git tag v1.2.0 42f3656
git push origin v1.2.0

  

Summary by CodeRabbit

• New Features

  • Added automated GitHub Releases for version tags, including release notes and prerelease detection.
  • Added documented procedures for standard, prerelease, and hotfix releases.

• Bug Fixes

  • Improved terminal message coloring for supported terminals, including warnings and errors.
  • Simplified version verification during installation.

• Documentation

  • Updated the changelog with the 1.2.1 release entry and release-process reference.

• Chores

  • Updated the application version to 1.2.1.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 50a1dc71-30e1-40d9-b02b-e089d3eab2e0

📥 Commits

Reviewing files that changed from the base of the PR and between fba86cf and 9d2ede4.

📒 Files selected for processing (9)

• .github/workflows/ci.yml
• .github/workflows/release.yml
• ChangeLog
• RELEASING.md
• VERSION
• scripts/function/display_error
• scripts/function/display_fatal
• scripts/function/display_message
• scripts/function/display_warning

---

📝 Walkthrough

Walkthrough

The release process now publishes GitHub Releases from versioned tags, documents release procedures, and updates version metadata. CI compares installed versions directly, while terminal display functions use ANSI coloring for supported terminals.

Changes

Release process

Layer / File(s)	Summary
Release metadata and procedure VERSION, ChangeLog, RELEASING.md	Version 1.2.1 and its dated changelog section are added, with documented standard, prerelease, and hotfix release steps.
Tag-triggered release publication .github/workflows/release.yml	Tags matching v* are validated against VERSION, paired with extracted changelog notes, and published as GitHub Releases with prerelease detection.
Installed version verification .github/workflows/ci.yml	The CI check compares the expected and installed gvm VERSION files with diff -q.

Terminal output coloring

Layer / File(s)	Summary
ANSI-colored display functions scripts/function/display_*	Error, fatal, message, and warning functions use ANSI sequences for xterm and xterm-256color, with plain-output fallbacks.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant GitTag as Git tag push
  participant ReleaseWorkflow as Release workflow
  participant VERSION
  participant ChangeLog
  participant GitHubRelease as GitHub Release
  GitTag->>ReleaseWorkflow: Push v* tag
  ReleaseWorkflow->>VERSION: Validate tag version
  ReleaseWorkflow->>ChangeLog: Extract release notes
  ReleaseWorkflow->>GitHubRelease: Create release and set prerelease flag

Loading

Possibly related PRs

• brianrobt/gvm2#5: Modifies the same CI step that verifies the locally installed gvm version.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/release-process-d95a

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}