fix: artifact support logic and updated changelog

Author: CodeMeAPixel

CHANGELOG.md

@@ -25,7 +25,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-## [0.1.1] - Unreleased
+## [0.2.0] - 2026-01-25
 
 ### Added
 - **Full version string for hosting panels** - Added `FullVersion` field to artifact entries
@@ -43,10 +43,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Created `ArtifactsResult` struct to properly track total count after filtering but before pagination
   - `hasMore` now correctly indicates if more pages are available
 
+- **Latest vs Recommended logic** - Fixed support status assignment per CFX EOL policy
+  - **Latest** = Single newest version (for testing/bleeding edge)
+  - **Recommended** = Next 3 versions after Latest (stable for production)
+  - Support status now dynamically assigned based on version position, not hardcoded thresholds
+  - See https://aka.cfx.re/eol for CFX official policy
+
+- **EOL filter default** - Changed `includeEol` default from `true` to `false`
+  - EOL artifacts are now excluded by default for safety
+  - Users must explicitly opt-in to see end-of-life versions
+
 ### Changed
 - Updated all artifact handlers to use new `ArtifactsResult` return type
 - Refactored `generateFullVersion()` helper to accept hash parameter
 - Added `ArtifactStats` struct and `calculateStats()` helper function
+- Refactored `ProcessGitHubTags` to dynamically assign Latest/Recommended based on sorted position
+- Simplified `determineSupportStatus()` to only handle Active/Deprecated/EOL thresholds
 
 ---
 

internal/handlers/artifacts.go

@@ -37,7 +37,7 @@ func GetArtifacts(c *fiber.Ctx) error {
 		Status:     services.SupportStatus(c.Query("status", "")),
 		SortBy:     c.Query("sortBy", "version"),
 		SortOrder:  c.Query("sortOrder", "desc"),
-		IncludeEOL: c.QueryBool("includeEol", true),
+		IncludeEOL: c.QueryBool("includeEol", false),
 	}
 
 	// Parse limit and offset

internal/services/artifacts.go

@@ -239,7 +239,7 @@ func (s *ArtifactsService) ProcessGitHubTags(tags []GitHubTag) ArtifactData {
 		}
 	}
 
-	// Sort by version number (descending)
+	// Sort by version number (descending) - highest version first
 	sort.Slice(artifactTags, func(i, j int) bool {
 		versionA := s.extractVersionNumber(artifactTags[i].Name)
 		versionB := s.extractVersionNumber(artifactTags[j].Name)
@@ -248,15 +248,28 @@ func (s *ArtifactsService) ProcessGitHubTags(tags []GitHubTag) ArtifactData {
 
 	now := time.Now().UTC().Format(time.RFC3339)
 
-	for _, tag := range artifactTags {
+	for idx, tag := range artifactTags {
 		versionNumber := s.extractVersionNumber(tag.Name)
 		version := strconv.Itoa(versionNumber)
 
+		// Determine support status based on position in sorted list
+		// Position 0 = Latest (newest single version)
+		// Position 1-3 = Recommended (stable versions)
+		// Rest based on version thresholds
+		var status SupportStatus
+		if idx == 0 {
+			status = Latest
+		} else if idx <= 3 {
+			status = Recommended
+		} else {
+			status = s.determineSupportStatus(versionNumber)
+		}
+
 		baseEntry := Artifact{
 			Version:       version,
 			Hash:          tag.Commit.SHA,
 			Date:          now,
-			SupportStatus: s.determineSupportStatus(versionNumber),
+			SupportStatus: status,
 		}
 
 		// Windows artifact
@@ -464,14 +477,16 @@ func (s *ArtifactsService) extractVersionNumber(tagName string) int {
 }
 
 func (s *ArtifactsService) determineSupportStatus(version int) SupportStatus {
+	// Based on CFX EOL policy: https://aka.cfx.re/eol
+	// This is used for versions beyond the top 4 (Latest + 3 Recommended)
+	// which are dynamically assigned in ProcessGitHubTags
+	// Active = still supported but older
+	// Deprecated = support ending soon
+	// EOL = no longer supported
 	switch {
-	case version >= 24500:
-		return Recommended
-	case version >= 24000:
-		return Latest
-	case version >= 23000:
+	case version >= 23000: // Still actively supported
 		return Active
-	case version >= 20000:
+	case version >= 20000: // Support ending
 		return Deprecated
 	default:
 		return EOL