🔧 [build] Update module version and localization info

Nick2bad4u · Nick2bad4u · commit efff7d34b3d9 · 2025-12-15T12:00:47.000-05:00
- 🔧 Update ModuleVersion to '2025.12.15.1153' in ColorScripts-Enhanced.psd1
 - 📝 Update ReleaseNotes to reflect changes in version 2025.12.15.1153
 - 🛠️ Enhance error handling in Get-ColorScriptsConfigurationRoot with verbose messages for cached configuration root validation
 - 🛠️ Improve error handling in Initialize-CacheDirectory with detailed trace for cache metadata stamp comparison failures
 - 🛠️ Add verbose logging in Initialize-ColorScriptsLocalization for explicit root localization import failures
 - 🌍 Update HelpInfo.xml files for multiple languages to reflect the new version '2025.12.15.1153'

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
@@ -11,7 +11,7 @@
     RootModule = 'ColorScripts-Enhanced.psm1'
 
     # Version number of this module.
-    ModuleVersion = '2025.12.15.0210'
+    ModuleVersion = '2025.12.15.1153'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')
@@ -211,7 +211,7 @@ PERFECT FOR
 
             # ReleaseNotes of this module
             ReleaseNotes = @'
-Version 2025.12.15.0210:
+Version 2025.12.15.1153:
 - Enhanced caching system with OS-wide cache in AppData
 - 6-19x performance improvement
 - Cache stored in centralized location
diff --git a/ColorScripts-Enhanced/Private/Get-ColorScriptsConfigurationRoot.ps1 b/ColorScripts-Enhanced/Private/Get-ColorScriptsConfigurationRoot.ps1
@@ -13,7 +13,7 @@ function Get-ColorScriptsConfigurationRoot {
             }
         }
         catch {
-            # Fall through
+            Write-Verbose ("Cached configuration root validation failed: {0}" -f $_.Exception.Message)
         }
 
         $script:ConfigurationRoot = $null
@@ -56,6 +56,7 @@ function Get-ColorScriptsConfigurationRoot {
                 $resolvedCandidate = Resolve-CachePath -Path $candidate
             }
             catch {
+                Write-Verbose ("Configuration root probe resolution failed for '{0}': {1}" -f $candidate, $_.Exception.Message)
                 $resolvedCandidate = $null
             }
 
@@ -68,7 +69,7 @@ function Get-ColorScriptsConfigurationRoot {
                     $resolvedCandidate = (Resolve-Path -LiteralPath $resolvedCandidate -ErrorAction Stop).ProviderPath
                 }
                 catch {
-                    # Keep original
+                    Write-Verbose ("Configuration root probe path normalization failed for '{0}': {1}" -f $resolvedCandidate, $_.Exception.Message)
                 }
 
                 # Important: do not cache $script:ConfigurationRoot in probe mode.
diff --git a/ColorScripts-Enhanced/Private/Initialize-CacheDirectory.ps1 b/ColorScripts-Enhanced/Private/Initialize-CacheDirectory.ps1
@@ -103,7 +103,7 @@ function Initialize-CacheDirectory {
                         }
                     }
                     catch {
-                        # Ignore stamp comparison failures
+                        Write-ModuleTrace ("Cache metadata stamp comparison failed: {0}" -f $_.Exception.Message)
                     }
                 }
             }
diff --git a/ColorScripts-Enhanced/Private/Initialize-ColorScriptsLocalization.ps1 b/ColorScripts-Enhanced/Private/Initialize-ColorScriptsLocalization.ps1
@@ -106,7 +106,7 @@ function Initialize-ColorScriptsLocalization {
                         }
                     }
                     catch {
-                        # Fall back to the regular discovery/import logic
+                        Write-ModuleTrace ("Explicit root localization import failed for '{0}': {1}" -f $resolvedExplicitRoot, $_.Exception.Message)
                     }
                 }
             }
@@ -135,7 +135,7 @@ function Initialize-ColorScriptsLocalization {
                     $moduleRootCandidate = (Resolve-Path -LiteralPath $moduleRootCandidate -ErrorAction Stop).ProviderPath
                 }
                 catch {
-                    # Keep original path
+                    Write-ModuleTrace ("Embedded defaults module root resolution failed for '{0}': {1}" -f $moduleRootCandidate, $_.Exception.Message)
                 }
             }
 
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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</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.12.15.0210</UICultureVersion>
+      <UICultureVersion>2025.12.15.1153</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/dist/LatestReleaseNotes.md b/dist/LatestReleaseNotes.md
@@ -7,6 +7,26 @@ All notable changes to this project will be documented in this file.
 ## [Unreleased]
 
 
+[[ae15c97](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/ae15c97423e180fdbbdd93e482f04371a13e2404)...
+[ae15c97](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/ae15c97423e180fdbbdd93e482f04371a13e2404)]
+([compare](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/compare/ae15c97423e180fdbbdd93e482f04371a13e2404...ae15c97423e180fdbbdd93e482f04371a13e2404))
+
+
+### 💼 Other
+
+- ✨ [feat] Enhance cache metadata management and script inventory retrieval
+
+ - 📝 Add Write-CacheMetadataFile function to manage cache metadata files without purging cache entries.
+ - 🔧 Update Initialize-CacheDirectory to refresh metadata marker based on cache entries' timestamps.
+ - ⚡ Improve Get-ColorScriptInventory by introducing a new internal function to retrieve script files more reliably.
+ - 🛠️ Modify Get-ColorScriptsConfigurationRoot to allow non-destructive validation and prevent cache directory creation if not needed.
+ - 🔄 Update New-ColorScriptCache and Show-ColorScript to ensure cache metadata is updated after cache operations.
+ - 🧪 Add tests to ensure cache entries are preserved during validation and that metadata files are correctly created and updated.
+ - 🌍 Update localization help files for multiple languages to reflect the latest version.
+
+Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(ae15c97)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/ae15c97423e180fdbbdd93e482f04371a13e2404)
+
+
 
 
 
diff --git a/dist/PowerShellGalleryReleaseNotes.md b/dist/PowerShellGalleryReleaseNotes.md
@@ -1,6 +1,26 @@
 ## [Unreleased]
 
 
+[[ae15c97](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/ae15c97423e180fdbbdd93e482f04371a13e2404)...
+[ae15c97](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/ae15c97423e180fdbbdd93e482f04371a13e2404)]
+([compare](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/compare/ae15c97423e180fdbbdd93e482f04371a13e2404...ae15c97423e180fdbbdd93e482f04371a13e2404))
+
+
+### 💼 Other
+
+- ✨ [feat] Enhance cache metadata management and script inventory retrieval
+
+ - 📝 Add Write-CacheMetadataFile function to manage cache metadata files without purging cache entries.
+ - 🔧 Update Initialize-CacheDirectory to refresh metadata marker based on cache entries' timestamps.
+ - ⚡ Improve Get-ColorScriptInventory by introducing a new internal function to retrieve script files more reliably.
+ - 🛠️ Modify Get-ColorScriptsConfigurationRoot to allow non-destructive validation and prevent cache directory creation if not needed.
+ - 🔄 Update New-ColorScriptCache and Show-ColorScript to ensure cache metadata is updated after cache operations.
+ - 🧪 Add tests to ensure cache entries are preserved during validation and that metadata files are correctly created and updated.
+ - 🌍 Update localization help files for multiple languages to reflect the latest version.
+
+Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(ae15c97)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/ae15c97423e180fdbbdd93e482f04371a13e2404)
+
+
 
 
 

Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ function Get-ColorScriptsConfigurationRoot {`
`13`	`13`	`}`
`14`	`14`	`}`
`15`	`15`	`catch {`
`16`		`- # Fall through`
	`16`	`+ Write-Verbose ("Cached configuration root validation failed: {0}" -f $_.Exception.Message)`
`17`	`17`	`}`
`18`	`18`
`19`	`19`	`$script:ConfigurationRoot = $null`
`@@ -56,6 +56,7 @@ function Get-ColorScriptsConfigurationRoot {`
`56`	`56`	`$resolvedCandidate = Resolve-CachePath -Path $candidate`
`57`	`57`	`}`
`58`	`58`	`catch {`
	`59`	`+ Write-Verbose ("Configuration root probe resolution failed for '{0}': {1}" -f $candidate, $_.Exception.Message)`
`59`	`60`	`$resolvedCandidate = $null`
`60`	`61`	`}`
`61`	`62`
`@@ -68,7 +69,7 @@ function Get-ColorScriptsConfigurationRoot {`
`68`	`69`	`$resolvedCandidate = (Resolve-Path -LiteralPath $resolvedCandidate -ErrorAction Stop).ProviderPath`
`69`	`70`	`}`
`70`	`71`	`catch {`
`71`		`- # Keep original`
	`72`	`+ Write-Verbose ("Configuration root probe path normalization failed for '{0}': {1}" -f $resolvedCandidate, $_.Exception.Message)`
`72`	`73`	`}`
`73`	`74`
`74`	`75`	`# Important: do not cache $script:ConfigurationRoot in probe mode.`
Original file line number	Diff line number	Diff line change
`@@ -103,7 +103,7 @@ function Initialize-CacheDirectory {`
`103`	`103`	`}`
`104`	`104`	`}`
`105`	`105`	`catch {`
`106`		`- # Ignore stamp comparison failures`
	`106`	`+ Write-ModuleTrace ("Cache metadata stamp comparison failed: {0}" -f $_.Exception.Message)`
`107`	`107`	`}`
`108`	`108`	`}`
`109`	`109`	`}`
Original file line number	Diff line number	Diff line change
`@@ -106,7 +106,7 @@ function Initialize-ColorScriptsLocalization {`
`106`	`106`	`}`
`107`	`107`	`}`
`108`	`108`	`catch {`
`109`		`- # Fall back to the regular discovery/import logic`
	`109`	`+ Write-ModuleTrace ("Explicit root localization import failed for '{0}': {1}" -f $resolvedExplicitRoot, $_.Exception.Message)`
`110`	`110`	`}`
`111`	`111`	`}`
`112`	`112`	`}`
`@@ -135,7 +135,7 @@ function Initialize-ColorScriptsLocalization {`
`135`	`135`	`$moduleRootCandidate = (Resolve-Path -LiteralPath $moduleRootCandidate -ErrorAction Stop).ProviderPath`
`136`	`136`	`}`
`137`	`137`	`catch {`
`138`		`- # Keep original path`
	`138`	`+ Write-ModuleTrace ("Embedded defaults module root resolution failed for '{0}': {1}" -f $moduleRootCandidate, $_.Exception.Message)`
`139`	`139`	`}`
`140`	`140`	`}`
`141`	`141`