feat: rename and enhance range filter function with debug logging

- Renamed ReloadRangeFilter to BuildRangeFilter for improved clarity.
- Added detailed logging to track species and scores during the filter build process.
- Introduced a debug mode that writes included species to a file when enabled, enhancing traceability for debugging purposes.

internal/analysis/processor/range_filter.go

@@ -1,11 +1,14 @@
 package processor
 
 import (
+	"fmt"
+	"log"
+	"os"
 	"time"
 )
 
 // Add or update the updateIncludedSpecies function
-func (p *Processor) ReloadRangeFilter() error {
+func (p *Processor) BuildRangeFilter() error {
 	today := time.Now().Truncate(24 * time.Hour)
 
 	// Update location based species list
@@ -17,9 +20,25 @@ func (p *Processor) ReloadRangeFilter() error {
 	// Convert the speciesScores slice to a slice of species labels
 	var includedSpecies []string
 	for _, speciesScore := range speciesScores {
+		// debug species and score
+		log.Printf("	Species: %s, Score: %f\n", speciesScore.Label, speciesScore.Score)
 		includedSpecies = append(includedSpecies, speciesScore.Label)
 	}
 
+	if p.Settings.BirdNET.RangeFilter.Debug {
+		// Debug: Write included species to file
+		debugFile := "debug_included_species.txt"
+		content := fmt.Sprintf("Updated at: %s\nSpecies count: %d\n\nSpecies list:\n",
+			time.Now().Format("2006-01-02 15:04:05"),
+			len(includedSpecies))
+		for _, species := range includedSpecies {
+			content += species + "\n"
+		}
+		if err := os.WriteFile(debugFile, []byte(content), 0644); err != nil {
+			log.Printf("❌ [range_filter/rebuild] Warning: Failed to write included species file: %v\n", err)
+		}
+	}
+
 	p.Settings.UpdateIncludedSpecies(includedSpecies)
 
 	return nil