🚜 [refactor] Rename Build-ColorScriptCache → New-ColorScriptCache, add Update-ColorScriptCache alias and propagate changes

 - ✨ [feat] Introduce New-ColorScriptCache as the public cmdlet (rename of Build-ColorScriptCache) and register alias Update-ColorScriptCache; bump module manifest version/date and export aliases.
 - 🚜 [refactor] Replace Build-ColorScriptCache references across the codebase (ColorScripts-Enhanced.psm1/psd1, scripts/, tests/, build tooling, generated help, README and docs/), adding New-ColorScriptCache usages and help pages.
 - 🛠️ [fix] Add ConvertFrom-JsonToHashtable helper for PowerShell 5.1 compatibility and switch JSON cache parsing to use it; normalize Set-Content invocation when writing JSON caches.
 - 🧪 [test] Update Pester tests to assert New-ColorScriptCache export and behavior; adapt test calls and expectations accordingly.
 - 🧹 [chore] Add .coverage tooling and documentation (.coverage/README.md, .gitignore, DebugCoverageTests.ps1, ShowCoverageSummary.ps1, metadata-cache-test.ps1), add context7.json, and adjust repo config (.gitignore, .mega-linter.yml) and generated dist/release notes.
 - 📝 [docs] Add en-US New-ColorScriptCache help file, update help XML and all docs/examples to reference the new command name.
 - 🎨 [style] Minor content fixes (http→https in assets, "TODO List" → "Improvements List") and refresh generated HelpInfo UICultureVersion.

Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com>

Author: Nick2bad4u

.coverage/.gitignore

@@ -0,0 +1,6 @@
+# Ignore coverage output files
+*.xml
+coverage-report/
+*.html
+*.css
+*.js

.coverage/DebugCoverageTests.ps1

@@ -0,0 +1,13 @@
+$result = Invoke-Pester -Path "./Tests/ColorScripts-Enhanced.CoverageExpansion.Tests.ps1" -PassThru -Output None
+Write-Host "Failed: $($result.FailedCount)"
+foreach ($failed in $result.Failed) {
+    Write-Host '---'
+    Write-Host $failed.Name
+    Write-Host $failed.FailureMessage
+    if ($failed.ErrorRecord) {
+        Write-Host $failed.ErrorRecord.Exception.GetType().FullName
+        Write-Host $failed.ErrorRecord.Exception.Message
+        Write-Host $failed.ErrorRecord.InvocationInfo.PositionMessage
+        Write-Host $failed.ErrorRecord.ScriptStackTrace
+    }
+}

.coverage/README.md

@@ -0,0 +1,48 @@
+# Code Coverage
+
+This directory contains code coverage reports generated by Pester tests.
+
+## Files
+
+- `coverage.xml` - JaCoCo format coverage data (uploaded to Codecov)
+- `coverage-report/` - HTML coverage reports (generated with ReportGenerator)
+
+## Generating Coverage Reports
+
+### Local Development
+
+```powershell
+# Run tests with coverage
+./scripts/Test-Coverage.ps1
+
+# Run with HTML report
+./scripts/Test-Coverage.ps1 -ShowReport
+```
+
+Or using npm scripts:
+
+```powershell
+npm run test:coverage
+npm run test:coverage:report
+```
+
+### CI/CD
+
+Coverage is automatically collected and uploaded to Codecov on every push via GitHub Actions.
+
+## Viewing Coverage
+
+- **Online**: [Codecov Dashboard](https://codecov.io/gh/Nick2bad4u/ps-color-scripts-enhanced)
+- **Local HTML**: Open `coverage-report/index.html` after running with `-ShowReport`
+- **Badge**: ![codecov](https://codecov.io/gh/Nick2bad4u/ps-color-scripts-enhanced/branch/main/graph/badge.svg)
+
+## Coverage Targets
+
+- Minimum Coverage: 70%
+- Target Coverage: 80%+
+
+## Files Excluded from Coverage
+
+- `Scripts/` directory (colorscript files)
+- Test files themselves
+- Build/deployment scripts

.coverage/ShowCoverageSummary.ps1

@@ -0,0 +1,37 @@
+param(
+    [string]$Path = (Join-Path $PSScriptRoot 'coverage.clixml'),
+    [int]$Top = 20,
+    [string]$Function
+)
+
+if (-not (Test-Path -LiteralPath $Path)) {
+    Write-Error "Coverage file '$Path' not found."
+    exit 1
+}
+
+$cov = Import-Clixml -Path $Path
+$missed = $cov.CodeCoverage.CommandsMissed
+
+if ($Function) {
+    $functionMisses = $missed | Where-Object { $_.Function -eq $Function }
+    if (-not $functionMisses) {
+        Write-Host "No missed commands recorded for function '$Function'."
+        return
+    }
+
+    foreach ($miss in $functionMisses) {
+        $location = "{0}:{1}" -f $miss.File, $miss.StartLine
+        Write-Host $location -ForegroundColor Cyan
+        if ($miss.Command) {
+            Write-Host "    $($miss.Command)"
+        }
+        else {
+            Write-Host "    [No command text captured]"
+        }
+        Write-Host
+    }
+    return
+}
+
+$groups = $missed | Group-Object Function | Sort-Object Count -Descending
+$groups | Select-Object -First $Top | Format-Table -AutoSize

.coverage/metadata-cache-test.ps1

@@ -0,0 +1 @@
+# Temporary debug script intentionally left empty.

.gitignore

@@ -348,5 +348,4 @@ coverage.xml
 coverage-report/
 testResults.xml
 test-results.xml
-*.coverage
 !dist

.mega-linter.yml

@@ -31,7 +31,7 @@ MARKDOWN_MARKDOWN_TABLE_FORMATTER_FILTER_REGEX_EXCLUDE: '(CHANGELOG\.md|.*AUDIT.
 REPOSITORY_CHECKOV_ARGUMENTS: "--framework github_actions --skip-check CKV_GHA_7,CKV2_GHA_1"
 REPOSITORY_DEVSKIM_ARGUMENTS: "--ignore-globs **/node_modules/**,**/.git/**"
 REPOSITORY_GITLEAKS_CONFIG_FILE: .gitleaks.toml
-REPOSITORY_SECRETLINT_ARGUMENTS: "--secretlintrc .secretlintrc.json"
+# REPOSITORY_SECRETLINT_ARGUMENTS: "--secretlintrc .secretlintrc.json"
 REPOSITORY_TRIVY_ARGUMENTS: "--skip-dirs node_modules"
 
 # YAML settings

CONTRIBUTING.md

@@ -62,7 +62,7 @@ By participating in this project, you agree to maintain a respectful and inclusi
    Show-ColorScript -Name my-cool-script
 
    # Test caching
-   Build-ColorScriptCache -Name my-cool-script
+   New-ColorScriptCache -Name my-cool-script
    Show-ColorScript -Name my-cool-script
    ```
 
@@ -217,7 +217,7 @@ ps-color-scripts-enhanced/
 │   │   ├── about_ColorScripts-Enhanced.help.txt
 │   │   ├── Show-ColorScript.md
 │   │   ├── Get-ColorScriptList.md
-│   │   ├── Build-ColorScriptCache.md
+│   │   ├── New-ColorScriptCache.md
 │   │   └── Clear-ColorScriptCache.md
 │   └── Scripts/                       # Colorscript files
 │       ├── hearts.ps1

ColorScripts-Enhanced/ColorScripts-Enhanced.psd1

@@ -3,15 +3,15 @@
 #
 # Generated by: Nick2bad4u
 #
-# Generated on: 10/29/2025
+# Generated on: 10/30/2025
 #
 
 @{
     # Script module or binary module file associated with this manifest.
     RootModule = 'ColorScripts-Enhanced.psm1'
 
     # Version number of this module.
-    ModuleVersion = '2025.10.29.2019'
+    ModuleVersion = '2025.10.30.0107'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')
@@ -87,7 +87,7 @@ Full documentation: https://github.com/Nick2bad4u/ps-color-scripts-enhanced
     FunctionsToExport = @(
         'Show-ColorScript'
         'Get-ColorScriptList'
-        'Build-ColorScriptCache'
+        'New-ColorScriptCache'
         'Clear-ColorScriptCache'
         'Add-ColorScriptProfile'
         'Get-ColorScriptConfiguration'
@@ -104,7 +104,7 @@ Full documentation: https://github.com/Nick2bad4u/ps-color-scripts-enhanced
     VariablesToExport = @()
 
     # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
-    AliasesToExport = @('scs')
+    AliasesToExport = @('scs', 'Update-ColorScriptCache')
 
     # DSC resources to export from this module
     # DscResourcesToExport = @()
@@ -172,7 +172,7 @@ Full documentation: https://github.com/Nick2bad4u/ps-color-scripts-enhanced
 
             # ReleaseNotes of this module
             ReleaseNotes = @'
-Version 2025.10.29.2019:
+Version 2025.10.30.0107:
 - Enhanced caching system with OS-wide cache in AppData
 - 6-19x performance improvement
 - Cache stored in centralized location

ColorScripts-Enhanced/ColorScripts-Enhanced.psm1

@@ -37,6 +37,64 @@ $script:IsWindows = $IsWindows
 $script:IsMacOS = $IsMacOS
 $script:PowerShellMajorVersion = $PSVersionTable.PSVersion.Major
 
+function ConvertFrom-JsonToHashtable {
+    <#
+    .SYNOPSIS
+        Converts JSON to a hashtable, compatible with PowerShell 5.1 and 7+
+    .DESCRIPTION
+        PowerShell 5.1 doesn't support -AsHashtable parameter on ConvertFrom-Json.
+        This function provides a compatible conversion method for all PowerShell versions.
+    #>
+    param(
+        [Parameter(Mandatory, ValueFromPipeline)]
+        [AllowEmptyString()]
+        [string]$InputObject
+    )
+
+    process {
+        if ([string]::IsNullOrWhiteSpace($InputObject)) {
+            return $null
+        }
+
+        # PowerShell 6.0+ supports -AsHashtable natively
+        if ($PSVersionTable.PSVersion.Major -ge 6) {
+            return ConvertFrom-Json -InputObject $InputObject -AsHashtable
+        }
+
+        # PowerShell 5.1 fallback: Convert PSCustomObject to Hashtable
+        function ConvertTo-HashtableInternal {
+            param([Parameter(ValueFromPipeline)]$InputObject)
+
+            process {
+                if ($null -eq $InputObject) {
+                    return $null
+                }
+
+                if ($InputObject -is [System.Collections.IEnumerable] -and $InputObject -isnot [string]) {
+                    $collection = @()
+                    foreach ($item in $InputObject) {
+                        $collection += ConvertTo-HashtableInternal $item
+                    }
+                    return $collection
+                }
+
+                if ($InputObject -is [PSCustomObject]) {
+                    $hash = @{}
+                    foreach ($property in $InputObject.PSObject.Properties) {
+                        $hash[$property.Name] = ConvertTo-HashtableInternal $property.Value
+                    }
+                    return $hash
+                }
+
+                return $InputObject
+            }
+        }
+
+        $obj = ConvertFrom-Json -InputObject $InputObject
+        return ConvertTo-HashtableInternal $obj
+    }
+}
+
 function Initialize-SystemDelegateState {
     if (-not $script:GetUserProfilePathDelegate) {
         $script:GetUserProfilePathDelegate = { [System.Environment]::GetFolderPath('UserProfile') }
@@ -443,7 +501,7 @@ function Initialize-Configuration {
         try {
             $raw = Get-Content -LiteralPath $script:ConfigurationPath -Raw -ErrorAction Stop
             if (-not [string]::IsNullOrWhiteSpace($raw)) {
-                $existing = ConvertFrom-Json -InputObject $raw -AsHashtable
+                $existing = ConvertFrom-JsonToHashtable -InputObject $raw
             }
             else {
                 $raw = $null
@@ -1240,7 +1298,7 @@ function Get-ColorScriptMetadataTable {
                 if ($cacheFileInfo.LastWriteTimeUtc -ge $currentTimestamp) {
                     # JSON cache is current, load it
                     $jsonData = Get-Content -LiteralPath $binaryCachePath -Raw -ErrorAction Stop
-                    $cachedHash = ConvertFrom-Json -InputObject $jsonData -AsHashtable -ErrorAction Stop
+                    $cachedHash = ConvertFrom-JsonToHashtable -InputObject $jsonData
 
                     # Convert back to proper dictionary
                     $loadedStore = New-Object 'System.Collections.Generic.Dictionary[string, object]' ([System.StringComparer]::OrdinalIgnoreCase)
@@ -1645,7 +1703,7 @@ function Get-ColorScriptMetadataTable {
     if ($binaryCachePath) {
         try {
             $jsonData = $store | ConvertTo-Json -Depth 10 -Compress
-            Set-Content -LiteralPath $binaryCachePath -Value $jsonData -Encoding UTF8 -ErrorAction Stop
+            Set-Content -Path $binaryCachePath -Value $jsonData -Encoding UTF8 -ErrorAction Stop
             Write-Verbose "Saved metadata to JSON cache for faster future loads"
         }
         catch {
@@ -2516,9 +2574,10 @@ Limit the selection to scripts that belong to the specified category (case-insen
 .PARAMETER Tag
 Limit the selection to scripts containing the specified metadata tags (case-insensitive). Multiple values are treated as an OR filter.
 #>
-function Build-ColorScriptCache {
+function New-ColorScriptCache {
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseOutputTypeCorrectly', '', Justification = 'Returns structured pipeline records for each cache operation.')]
     [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')]
+    [Alias('Update-ColorScriptCache')]
     param(
         [Parameter(ParameterSetName = 'Help')]
         [Alias('help')]
@@ -2547,7 +2606,7 @@ function Build-ColorScriptCache {
     begin {
         $helpRequested = $false
         if ($h) {
-            Show-ColorScriptHelp -CommandName 'Build-ColorScriptCache'
+            Show-ColorScriptHelp -CommandName 'New-ColorScriptCache'
             $helpRequested = $true
             return
         }
@@ -2712,7 +2771,6 @@ function Build-ColorScriptCache {
                     default { 'White' }
                 }
                 $statusText = switch ($item.Status) {
-                    'Updated' { 'Cached' }
                     'SkippedUpToDate' { 'Up-to-date (skipped)' }
                     'Failed' { 'Failed' }
                     'SkippedByUser' { 'Skipped by user' }
@@ -3430,15 +3488,15 @@ function Invoke-ColorScriptsStartup {
 Export-ModuleMember -Function @(
     'Show-ColorScript',
     'Get-ColorScriptList',
-    'Build-ColorScriptCache',
+    'New-ColorScriptCache',
     'Clear-ColorScriptCache',
     'Add-ColorScriptProfile',
     'Get-ColorScriptConfiguration',
     'Set-ColorScriptConfiguration',
     'Reset-ColorScriptConfiguration',
     'Export-ColorScriptMetadata',
     'New-ColorScript'
-) -Alias @('scs')
+) -Alias @('scs', 'Update-ColorScriptCache')
 
 # Module initialization - cache and configuration are lazily loaded when first needed
 Write-Verbose "ColorScripts-Enhanced module loaded successfully."