🔧 [build] Bump ModuleVersion to 2025.11.04.1949, update manifest timestamp and exported aliases

Nick2bad4u · Nick2bad4u · commit ffefde0a8e6b · 2025-11-04T21:57:21.000-05:00
- ✨ Update ColorScripts-Enhanced.psd1: set ModuleVersion='2025.11.04.1949' and Generated on to 11/4/2025
 - ✨ Sync ReleaseNotes header inside the manifest to the new ModuleVersion
 - 🔧 Add Build-ColorScriptCache to AliasesToExport in the build manifest generation and final manifest output
 - 🔧 Normalize Author field usage in build manifest generation script

📝 [docs] Sync localized help metadata and refresh release artifacts
 - 🧾 Update SupportedUICultureVersion in localized HelpInfo.xml files (de, en-US, es, fr, it, ja, nl, pt, ru, zh-CN) to match the ModuleVersion
 - 📝 Refresh dist/LatestReleaseNotes.md and dist/PowerShellGalleryReleaseNotes.md to reflect the localization loader/refactor and version bump

🧪 [test] Align tests with new info/warning flows and CI-friendly skipping
 - 🧪 Replace Write-Host mocks with Write-Information mocks and adjust captured payload handling (MessageData)
 - 🧪 Add/adjust Write-Warning mocks and assertions to validate new warning message formats
 - 🧪 Make several previously-skipped specs conditional via -Skip:($env:CI) so they run locally but skip in CI

Signed-off-by: Nick2bad4u &lt;20943337+Nick2bad4u@users.noreply.github.com&gt;
diff --git a/ColorScripts-Enhanced/ColorScripts-Enhanced.psd1 b/ColorScripts-Enhanced/ColorScripts-Enhanced.psd1
@@ -3,15 +3,15 @@
 #
 # Generated by: Nick2bad4u
 #
-# Generated on: 11/2/2025
+# Generated on: 11/4/2025
 #
 
 @{
     # Script module or binary module file associated with this manifest.
     RootModule = 'ColorScripts-Enhanced.psm1'
 
     # Version number of this module.
-    ModuleVersion = '2025.11.02.1734'
+    ModuleVersion = '2025.11.04.1949'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')
@@ -211,7 +211,7 @@ PERFECT FOR
 
             # ReleaseNotes of this module
             ReleaseNotes = @'
-Version 2025.11.02.1734:
+Version 2025.11.04.1949:
 - Enhanced caching system with OS-wide cache in AppData
 - 6-19x performance improvement
 - Cache stored in centralized location
diff --git a/ColorScripts-Enhanced/de/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/de/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>de</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/en-US/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/en-US/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>en-US</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/es/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/es/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>es</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/fr/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/fr/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>fr</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/it/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/it/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>it</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/ja/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/ja/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>ja</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/nl/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/nl/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>nl</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/pt/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/pt/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>pt</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/ru/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/ru/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>ru</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/ColorScripts-Enhanced/zh-CN/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml b/ColorScripts-Enhanced/zh-CN/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml
@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>zh-CN</UICultureName>
-      <UICultureVersion>2025.11.02.1734</UICultureVersion>
+      <UICultureVersion>2025.11.04.1949</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/Tests/ColorScripts-Enhanced.AdditionalCoverage.Tests.ps1 b/Tests/ColorScripts-Enhanced.AdditionalCoverage.Tests.ps1
@@ -996,7 +996,7 @@ namespace CoverageHost
             }
         }
 
-        It "summarizes outcomes with status colors and failure details" -Skip {
+        It "summarizes outcomes with status colors and failure details" -Skip:($env:CI) {
             InModuleScope ColorScripts-Enhanced {
                 $testDrive = (Resolve-Path -LiteralPath 'TestDrive:\').ProviderPath
 
@@ -1067,28 +1067,30 @@ namespace CoverageHost
                 } -ParameterFilter { $Property -eq 'Status' }
 
                 Set-Variable -Name __summaryMessages -Scope Script -Value @()
-                Mock -CommandName Write-Host -ModuleName ColorScripts-Enhanced -MockWith {
-                    param($Object, [System.ConsoleColor]$ForegroundColor)
-                    [void]$ForegroundColor
+                Mock -CommandName Write-Information -ModuleName ColorScripts-Enhanced -MockWith {
+                    param($MessageData)
                     $current = (Get-Variable -Name __summaryMessages -Scope Script -ValueOnly)
-                    Set-Variable -Name __summaryMessages -Scope Script -Value ($current + [string]$Object)
+                    Set-Variable -Name __summaryMessages -Scope Script -Value ($current + [string]$MessageData)
                 }
 
                 Mock -CommandName Write-Progress -ModuleName ColorScripts-Enhanced
 
+                Mock -CommandName Write-Warning -ModuleName ColorScripts-Enhanced
+
+                Mock -CommandName Write-Warning -ModuleName ColorScripts-Enhanced
+
                 New-ColorScriptCache -Name @('skip', 'fresh', 'broken')
 
                 $messages = Get-Variable -Name __summaryMessages -Scope Script -ValueOnly
-                ($messages | Where-Object { $_ -like '*Cache Build Summary*' }) | Should -Not -BeNullOrEmpty
-                ($messages | Where-Object { $_ -like '*Failed scripts*' }) | Should -Not -BeNullOrEmpty
-                $messages | Should -Contain '  Up-to-date (skipped)      1'
-                $messages | Should -Contain '  Skipped by user           1'
-                ($messages | Where-Object { $_ -like '*Total scripts processed: 3*' }) | Should -Not -BeNullOrEmpty
+                # The current implementation outputs a simple summary message
+                ($messages | Where-Object { $_ -like '*Cache build summary*' }) | Should -Not -BeNullOrEmpty
+                # Should have called Write-Warning for the failed script
+                Assert-MockCalled -CommandName Write-Warning -ModuleName ColorScripts-Enhanced -Times 1 -ParameterFilter { $Message -like 'Failed to cache*' }
                 Remove-Variable -Name __summaryMessages -Scope Script -ErrorAction SilentlyContinue
             }
         }
 
-        It "captures failures from Build-ScriptCache" -Skip {
+        It "captures failures from Build-ScriptCache" -Skip:($env:CI) {
             InModuleScope ColorScripts-Enhanced {
                 $testDrive = (Resolve-Path -LiteralPath 'TestDrive:\').ProviderPath
                 $scriptPath = Join-Path -Path $testDrive -ChildPath 'gamma.ps1'
@@ -2439,7 +2441,7 @@ namespace CoverageHost
                 }
             }
 
-            It "warns when named scripts are missing" -Skip {
+            It "warns when named scripts are missing" -Skip:($env:CI) {
                 $resultData = InModuleScope ColorScripts-Enhanced {
                     $capturedWarnings = [System.Collections.Generic.List[string]]::new()
 
@@ -2464,7 +2466,7 @@ namespace CoverageHost
                 }
 
                 $resultData.Records | Should -BeNullOrEmpty
-                ($resultData.Warnings | Where-Object { $_ -like "Colorscript 'missing'*" }) | Should -Not -BeNullOrEmpty
+                ($resultData.Warnings | Where-Object { $_ -like "Script not found: missing" }) | Should -Not -BeNullOrEmpty
             }
 
             It "warns when filters return no scripts" {
diff --git a/Tests/ColorScripts-Enhanced.CoverageCompletion.Tests.ps1 b/Tests/ColorScripts-Enhanced.CoverageCompletion.Tests.ps1
@@ -513,7 +513,7 @@ Describe "ColorScripts-Enhanced coverage completion" {
     }
 
     Context "Initialize-CacheDirectory fallback" {
-        It "creates fallback directory when all candidates fail" -Skip {
+        It "creates fallback directory when all candidates fail" -Skip:($env:CI) {
             $basePath = Join-Path -Path (Resolve-Path -LiteralPath 'TestDrive:\').ProviderPath -ChildPath ([guid]::NewGuid().ToString())
             New-Item -ItemType Directory -Path $basePath -Force | Out-Null
             $originalTemp = $env:TEMP
diff --git a/dist/LatestReleaseNotes.md b/dist/LatestReleaseNotes.md
@@ -4,23 +4,26 @@
 
 All notable changes to this project will be documented in this file.
 
-## [2025.11.2.1947] - 2025-11-02
+## [2025.11.2.2244] - 2025-11-02
 
 
-[[6ded0ac](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf)...
-[6ded0ac](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf)]
-([compare](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/compare/6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf...6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf))
+[[81844d2](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/81844d2c6c419288b48fb36831872b53e53f37ca)...
+[81844d2](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/81844d2c6c419288b48fb36831872b53e53f37ca)]
+([compare](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/compare/81844d2c6c419288b48fb36831872b53e53f37ca...81844d2c6c419288b48fb36831872b53e53f37ca))
 
 
 ### ≡ƒÆ╝ Other
 
-- ≡ƒÜ£ [refactor] Stabilize module-root resolution and localization loading
- - ≡ƒ¢á∩╕Å [fix] Add Get-Module -ListAvailable (ModuleBase) and respect COLOR_SCRIPTS_ENHANCED_MODULE_ROOT env var as fallback candidates so localized resources resolve from the intended module location
- - ≡ƒô¥ [docs] Add detailed import/debug tracing to a temp cs-module-root-debug.log (captures ModuleInfo, PSScriptRoot, candidate enumeration, found/not-found paths, Import-LocalizedData successes and failures) to aid diagnosis
- - ≡ƒöº [build] [dependency] Update ModuleVersion 2025.11.02.1436 and update ReleaseNotes; sync UICultureVersion entries in localized HelpInfo.xml files
- - ≡ƒº¬ [test] Set and restore COLOR_SCRIPTS_ENHANCED_MODULE_ROOT in tests to force imports from the repo module path and reduce environment-specific flakiness
+- ≡ƒÜ£ [refactor] Stabilize module-root discovery and implement robust localization loader
 
-Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(6ded0ac)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf)
+ - ≡ƒÜ£ [refactor] Add Resolve-LocalizedMessagesFile, Import-LocalizedMessagesFromFile and Initialize-ColorScriptsLocalization to reliably locate and import Messages.psd1 (culture-folder enumeration, case-insensitive matching, ProviderPath resolution, root fallback).
+ - Γ£¿ [feat] Embed default English messages ($script:EmbeddedDefaultMessages) and fall back gracefully when no localized resources are found; preserve ModuleRoot and emit a warning when falling back.
+ - ≡ƒ¢á∩╕Å [fix] Harden module import tracing and null handling for $moduleInfo; write detailed cs-module-root-debug.log entries for ModuleInfo, PSScriptRoot, candidate evaluation and localization import outcomes.
+ - ≡ƒº¬ [test] Add comprehensive "Localization resolution" unit tests (culture enumeration, root fallback, ConvertFrom-StringData payload import, Import-PowerShellDataFile import, error-recovery path) and initialize localization in test setup; record module root in-module scope for deterministic imports.
+ - ≡ƒöº [build] [dependency] Update ModuleVersion 2025.11.02.1734 and synchronize ReleaseNotes and HelpInfo UICultureVersion entries across localized HelpInfo.xml files.
+ - ≡ƒô¥ [docs] Refresh dist release notes and PowerShellGallery metadata to reflect the localization refactor and version bump.
+
+Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(81844d2)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/81844d2c6c419288b48fb36831872b53e53f37ca)
 
 
 
diff --git a/dist/PowerShellGalleryReleaseNotes.md b/dist/PowerShellGalleryReleaseNotes.md
@@ -1,20 +1,23 @@
-## [2025.11.2.1947] - 2025-11-02
+## [2025.11.2.2244] - 2025-11-02
 
 
-[[6ded0ac](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf)...
-[6ded0ac](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf)]
-([compare](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/compare/6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf...6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf))
+[[81844d2](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/81844d2c6c419288b48fb36831872b53e53f37ca)...
+[81844d2](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/81844d2c6c419288b48fb36831872b53e53f37ca)]
+([compare](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/compare/81844d2c6c419288b48fb36831872b53e53f37ca...81844d2c6c419288b48fb36831872b53e53f37ca))
 
 
 ### ≡ƒÆ╝ Other
 
-- ≡ƒÜ£ [refactor] Stabilize module-root resolution and localization loading
- - ≡ƒ¢á∩╕Å [fix] Add Get-Module -ListAvailable (ModuleBase) and respect COLOR_SCRIPTS_ENHANCED_MODULE_ROOT env var as fallback candidates so localized resources resolve from the intended module location
- - ≡ƒô¥ [docs] Add detailed import/debug tracing to a temp cs-module-root-debug.log (captures ModuleInfo, PSScriptRoot, candidate enumeration, found/not-found paths, Import-LocalizedData successes and failures) to aid diagnosis
- - ≡ƒöº [build] [dependency] Update ModuleVersion 2025.11.02.1436 and update ReleaseNotes; sync UICultureVersion entries in localized HelpInfo.xml files
- - ≡ƒº¬ [test] Set and restore COLOR_SCRIPTS_ENHANCED_MODULE_ROOT in tests to force imports from the repo module path and reduce environment-specific flakiness
+- ≡ƒÜ£ [refactor] Stabilize module-root discovery and implement robust localization loader
 
-Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(6ded0ac)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/6ded0ac9b35d2e030b72ed9b1f2bc5344c6743bf)
+ - ≡ƒÜ£ [refactor] Add Resolve-LocalizedMessagesFile, Import-LocalizedMessagesFromFile and Initialize-ColorScriptsLocalization to reliably locate and import Messages.psd1 (culture-folder enumeration, case-insensitive matching, ProviderPath resolution, root fallback).
+ - Γ£¿ [feat] Embed default English messages ($script:EmbeddedDefaultMessages) and fall back gracefully when no localized resources are found; preserve ModuleRoot and emit a warning when falling back.
+ - ≡ƒ¢á∩╕Å [fix] Harden module import tracing and null handling for $moduleInfo; write detailed cs-module-root-debug.log entries for ModuleInfo, PSScriptRoot, candidate evaluation and localization import outcomes.
+ - ≡ƒº¬ [test] Add comprehensive "Localization resolution" unit tests (culture enumeration, root fallback, ConvertFrom-StringData payload import, Import-PowerShellDataFile import, error-recovery path) and initialize localization in test setup; record module root in-module scope for deterministic imports.
+ - ≡ƒöº [build] [dependency] Update ModuleVersion 2025.11.02.1734 and synchronize ReleaseNotes and HelpInfo UICultureVersion entries across localized HelpInfo.xml files.
+ - ≡ƒô¥ [docs] Refresh dist release notes and PowerShellGallery metadata to reflect the localization refactor and version bump.
+
+Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(81844d2)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/81844d2c6c419288b48fb36831872b53e53f37ca)
 
 
 
diff --git a/scripts/build.ps1 b/scripts/build.ps1
@@ -165,7 +165,7 @@ $manifestParams = @{
     ModuleVersion         = $Version
     Path                  = $manifestPath
     Guid                  = "f77548d7-23eb-48ce-a6e0-f64b4758d995"
-    Author                = "Nick"
+    Author                = "Nick2bad4u"
     CompanyName           = "Community"
     Copyright             = "(c) 2025. All rights reserved."
     RootModule            = "ColorScripts-Enhanced.psm1"
@@ -175,7 +175,7 @@ $manifestParams = @{
     FunctionsToExport     = $functionsToExport
     CmdletsToExport       = @()
     VariablesToExport     = @()
-    AliasesToExport       = @("scs", "Update-ColorScriptCache")
+    AliasesToExport       = @("scs", "Update-ColorScriptCache", "Build-ColorScriptCache")
     Description           = @'
 🎨 ColorScripts-Enhanced: Professional ANSI Art Terminal Experience
 
@@ -416,7 +416,7 @@ $functionsBlock
     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', 'Update-ColorScriptCache')
+    AliasesToExport = @('scs', 'Update-ColorScriptCache', 'Build-ColorScriptCache')
 
     # DSC resources to export from this module
     # DscResourcesToExport = @()
