Migrate to stacktodate.club API with product catalog caching

Replace endoflife.date API calls with stacktodate.club API and implement
a 24-hour cache for the product catalog to improve performance and reduce
API calls during version detection.

Changes:
- Add cache module (cmd/lib/cache/cache.go) with GetAPIURL() utility
- Implement daily caching of products from stacktodate.club API
- Add fetch-catalog command for manual cache updates
- Update detect.go to use cached data instead of API calls
- Auto-fetch cache on first use if not present or stale
- Extract GetAPIURL() to cache package (used by push and cache)

Benefits:
- Reduces API calls from multiple per detection to one per 24 hours
- Enables offline operation after initial cache
- Consistent API URL configuration via STD_API_URL environment variable

🤖 Generated with Claude Code

Co-Authored-By: Claude Haiku 4.5 <[email protected]>

Author: ceritium

cmd/detect.go

@@ -1,13 +1,11 @@
 package cmd
 
 import (
-	"encoding/json"
 	"fmt"
-	"io"
-	"net/http"
 	"regexp"
 	"strings"
 
+	"github.com/stacktodate/stacktodate-cli/cmd/lib/cache"
 	"github.com/stacktodate/stacktodate-cli/cmd/lib/detectors"
 )
 
@@ -23,14 +21,6 @@ type DetectedInfo struct {
 	Docker []detectors.Candidate
 }
 
-type EOLProduct struct {
-	Cycle   string      `json:"cycle"`
-	Release string      `json:"release"`
-	LTS     interface{} `json:"lts"`     // Can be bool or string (date)
-	Support interface{} `json:"support"` // Can be bool or string (date)
-	EOL     interface{} `json:"eol"`     // Can be bool or string (date)
-}
-
 // cleanVersion removes version operators and extracts the core version
 // Examples: ~> 7.1.0 -> 7.1.0, >= 18.0.0 -> 18.0.0, <= 3.11 -> 3.11
 func cleanVersion(version string) string {
@@ -64,7 +54,7 @@ func cleanCandidateVersions(candidates []detectors.Candidate) []detectors.Candid
 	return candidates
 }
 
-// truncateCandidateVersions truncates all candidate versions to match endoflife.date API cycles
+// truncateCandidateVersions truncates all candidate versions to match stacktodate.club API cycles
 func truncateCandidateVersions(candidates []detectors.Candidate, product string) []detectors.Candidate {
 	for i := range candidates {
 		candidates[i].Value = truncateVersionToEOLCycle(product, candidates[i].Value)
@@ -145,7 +135,7 @@ func DetectProjectInfo() DetectedInfo {
 		}
 	}
 
-	// Truncate versions to match endoflife.date API cycles
+	// Truncate versions to match stacktodate.club API cycles
 	info.Ruby = truncateCandidateVersions(info.Ruby, "ruby")
 	info.Rails = truncateCandidateVersions(info.Rails, "rails")
 	info.Node = truncateCandidateVersions(info.Node, "nodejs")
@@ -155,39 +145,49 @@ func DetectProjectInfo() DetectedInfo {
 	return info
 }
 
-// truncateVersionToEOLCycle truncates a version to match the format used by endoflife.date API
-// It tries to find the best matching cycle by progressively truncating the version
-// Examples: 3.11.0 -> 3.11, 18.0.0 -> 18, 7.1.0 -> 7.1
-func truncateVersionToEOLCycle(product, version string) string {
-	if product == "" || version == "" {
-		return version
+// mapProductNameToCacheKey maps internal product names to stacktodate.club API keys
+func mapProductNameToCacheKey(product string) string {
+	mapping := map[string]string{
+		"ruby":   "ruby",
+		"rails":  "rails",
+		"nodejs": "nodejs",
+		"go":     "go",
+		"python": "python",
 	}
 
-	url := fmt.Sprintf("https://endoflife.date/api/%s.json", product)
-	resp, err := http.Get(url)
-	if err != nil {
-		return version
+	if key, exists := mapping[product]; exists {
+		return key
 	}
-	defer resp.Body.Close()
+	return product
+}
 
-	if resp.StatusCode != http.StatusOK {
+// truncateVersionToEOLCycle truncates a version to match the format used by stacktodate.club API
+// It tries to find the best matching cycle by progressively truncating the version
+// Examples: 3.11.0 -> 3.11, 18.0.0 -> 18, 7.1.0 -> 7.1
+func truncateVersionToEOLCycle(product, version string) string {
+	if product == "" || version == "" {
 		return version
 	}
 
-	body, err := io.ReadAll(resp.Body)
+	// Get products from cache (auto-fetches if needed or stale)
+	products, err := cache.GetProducts()
 	if err != nil {
+		// Graceful fallback: return original version if cache fetch fails
 		return version
 	}
 
-	var products []EOLProduct
-	if err := json.Unmarshal(body, &products); err != nil {
+	// Map product name to cache key
+	cacheKey := mapProductNameToCacheKey(product)
+	cachedProduct := cache.GetProductByKey(cacheKey, products)
+	if cachedProduct == nil {
+		// Product not found in cache, return original version
 		return version
 	}
 
 	// Build a set of available cycles for quick lookup
 	cycles := make(map[string]bool)
-	for _, p := range products {
-		cycles[p.Cycle] = true
+	for _, release := range cachedProduct.Releases {
+		cycles[release.ReleaseCycle] = true
 	}
 
 	// If exact match exists, return as-is
@@ -197,15 +197,15 @@ func truncateVersionToEOLCycle(product, version string) string {
 
 	// Split version into parts
 	parts := strings.Split(version, ".")
-	
+
 	// Try major.minor (e.g., 3.11 from 3.11.0)
 	if len(parts) >= 2 {
 		majorMinor := parts[0] + "." + parts[1]
 		if cycles[majorMinor] {
 			return majorMinor
 		}
 	}
-	
+
 	// Try major only (e.g., 18 from 18.0.0)
 	if len(parts) >= 1 {
 		major := parts[0]
@@ -223,40 +223,30 @@ func getEOLStatus(product, version string) string {
 		return ""
 	}
 
-	url := fmt.Sprintf("https://endoflife.date/api/%s.json", product)
-	resp, err := http.Get(url)
-	if err != nil {
-		return ""
-	}
-	defer resp.Body.Close()
-
-	if resp.StatusCode != http.StatusOK {
-		return ""
-	}
-
-	body, err := io.ReadAll(resp.Body)
+	// Get products from cache (auto-fetches if needed or stale)
+	products, err := cache.GetProducts()
 	if err != nil {
+		// Graceful fallback: return empty string if cache fetch fails
 		return ""
 	}
 
-	var products []EOLProduct
-	if err := json.Unmarshal(body, &products); err != nil {
+	// Map product name to cache key
+	cacheKey := mapProductNameToCacheKey(product)
+	cachedProduct := cache.GetProductByKey(cacheKey, products)
+	if cachedProduct == nil {
+		// Product not found in cache, return empty string
 		return ""
 	}
 
-	// Find the matching cycle
-	for _, p := range products {
-		if p.Cycle == version {
-			// Check if EOL is false (bool) or empty
-			if eolBool, ok := p.EOL.(bool); ok && !eolBool {
+	// Find the matching release cycle
+	for _, release := range cachedProduct.Releases {
+		if release.ReleaseCycle == version {
+			// Check if EOL is empty (still supported)
+			if release.EOL == "" {
 				return " (supported)"
 			}
-			if eolStr, ok := p.EOL.(string); ok {
-				if eolStr == "" || eolStr == "false" {
-					return " (supported)"
-				}
-				return fmt.Sprintf(" (EOL: %s)", eolStr)
-			}
+			// Return EOL date
+			return fmt.Sprintf(" (EOL: %s)", release.EOL)
 		}
 	}
 

cmd/fetch_catalog.go

@@ -0,0 +1,42 @@
+package cmd
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/stacktodate/stacktodate-cli/cmd/lib/cache"
+	"github.com/spf13/cobra"
+)
+
+var fetchCatalogCmd = &cobra.Command{
+	Use:   "fetch-catalog",
+	Short: "Fetch and cache the product catalog from stacktodate.club",
+	Long: `Fetch the complete list of products and their release information from stacktodate.club API
+and store it locally for faster version detection and truncation.
+
+The catalog is cached in ~/.stacktodate/products-cache.json and automatically refreshed
+once every 24 hours. You can use this command to manually refresh the cache at any time.`,
+	Run: func(cmd *cobra.Command, args []string) {
+		fmt.Fprintf(os.Stderr, "Fetching product catalog from stacktodate.club...\n")
+
+		if err := cache.FetchAndCache(); err != nil {
+			fmt.Fprintf(os.Stderr, "✗ Error: %v\n", err)
+			os.Exit(1)
+		}
+
+		// Load and display info about cached products
+		products, err := cache.LoadCache()
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "✗ Error loading cached products: %v\n", err)
+			os.Exit(1)
+		}
+
+		cachePath, _ := cache.GetCachePath()
+		fmt.Fprintf(os.Stderr, "✓ Successfully cached %d products\n", len(products.Products))
+		fmt.Fprintf(os.Stderr, "Cache location: %s\n", cachePath)
+	},
+}
+
+func init() {
+	rootCmd.AddCommand(fetchCatalogCmd)
+}