♻️ (ClassificationHelpers.ps1): refactor classification ordering logic

Refactor the classification ordering logic to consolidate the
functionality of `Get-FinalSelection` into `Get-ClassificationOrderedList`.
Introduce a `byLevel` switch parameter to allow optional filtering by
classification level. This change simplifies the code by removing
redundant functions and enhances flexibility by allowing users to
specify whether to filter classifications by level.

🔧 (Update-ReourcesFrontMatter.ps1): update classification ordering call

Update the call to `Get-ClassificationOrderedList` to include the
`byLevel` switch. This ensures that classifications are ordered by
level, aligning with the intended logic for selecting top categories
and tags. This change improves the accuracy of the classification
selection process in the front matter update script.

Author: MrHinsh

.powershell/_includes/ClassificationHelpers.ps1

@@ -348,34 +348,28 @@ function Get-Classification {
 function Get-ClassificationOrderedList { 
     param (
         [array]$Classifications,
-        [int] $minScore = 70
+        [int] $minScore = 30,
+        [string[]]$levels = @("Primary", "Secondary", "Tertiary", "Quaternary", "Quinary"),
+        [switch]$byLevel
     )
-    return $Classifications | 
-    Where-Object { $_.final_score -gt $minScore } | 
-    Sort-Object -Property @{Expression = "final_score"; Descending = $true }, @{Expression = "ai_alignment"; Descending = $true }, @{Expression = "ai_depth"; Descending = $true }, @{Expression = "category"; Descending = $false }
-}
-
-function Get-FinalSelection { 
-    param (
-        [hashtable]$categoryScores,
-        [string[]]$levels = @("Primary", "Secondary", "Tertiary", "Quaternary", "Quinary")
-    )
-    
-    $finalSelection = @()
 
-    foreach ($level in $levels) {
-        $currentSelection = $categoryScores.Values | Where-Object { $_.final_score -gt 30 -and $_.level -eq $level } | Sort-Object final_score -Descending
-        if ($currentSelection.Count -gt 0) {
-            $finalSelection += $currentSelection
-            break
-        }
+    $filtered = $Classifications | Where-Object { $_.final_score -gt $minScore }
+    $selected = @()
+    if ($byLevel) {
+        foreach ($level in $levels) {
+            $currentSelection = $filtered | Where-Object { $_.level -eq $level } | Sort-Object final_score -Descending
+            if ($currentSelection.Count -gt 0) {
+                $selected += $currentSelection
+                break
+            }
+        }    
     }
-
-    return $finalSelection | Sort-Object final_score -Descending
+    else {
+        $selected = $filtered | Sort-Object final_score -Descending
+    }
+    return $selected | Sort-Object -Property @{Expression = "final_score"; Descending = $true }, @{Expression = "ai_alignment"; Descending = $true }, @{Expression = "ai_depth"; Descending = $true }, @{Expression = "category"; Descending = $false }
 }
 
-
-
 function Get-ComputedConfidence {
     param (
         [int]$aiConfidence,

.powershell/single-use/resources/Update-ReourcesFrontMatter.ps1

@@ -208,13 +208,13 @@ while ($hugoMarkdownQueue.Count -gt 0 -or $hugoMarkdownBatchQueue.Count -gt 0) {
     # Update-StringList -frontMatter $hugoMarkdown.FrontMatter -fieldName 'marketing' -values @($categories) -Overwrite
     #-----------------Categories-------------------
     $categoryClassification = Get-ClassificationsForType -updateMissing -ClassificationType "categories" -hugoMarkdown $hugoMarkdown
-    $categoryClassificationOrdered = Get-ClassificationOrderedList -classifications $categoryClassification | Select-Object -First 3
+    $categoryClassificationOrdered = Get-ClassificationOrderedList -byLevel -classifications $categoryClassification | Select-Object -First 3
     $categories = $categoryClassificationOrdered | ForEach-Object { $_.category }
 
     Update-StringList -frontMatter $hugoMarkdown.FrontMatter -fieldName 'categories' -values @($categories) -Overwrite
     #-----------------Tags-------------------
     $tagClassification = Get-ClassificationsForType -updateMissing -ClassificationType "tags" -hugoMarkdown $hugoMarkdown
-    $tagClassificationOrdered = Get-ClassificationOrderedList -classifications $tagClassification | Select-Object -First 10
+    $tagClassificationOrdered = Get-ClassificationOrderedList -byLevel -classifications $tagClassification | Select-Object -First 10
     $tags = $tagClassificationOrdered | ForEach-Object { $_.category }
     Update-StringList -frontMatter $hugoMarkdown.FrontMatter -fieldName 'tags' -values @($tags) -Overwrite
     # =================COMPLETE===================