✨ [feat] Update module version and enhance caching system

Nick2bad4u · Nick2bad4u · commit 33c5cfaeaa25 · 2025-11-07T15:16:31.000-05:00
- Bump module version to '2025.11.07.1503' in manifest and help files
 - Improve caching system with OS-wide cache in AppData for better performance
 - Enhance progress reporting in New-ColorScriptCache for improved user feedback
 - Ensure no background runspace pools remain before analyzer runs to avoid errors

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.11.07.0255'
+    ModuleVersion = '2025.11.07.1503'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')
@@ -211,7 +211,7 @@ PERFECT FOR
 
             # ReleaseNotes of this module
             ReleaseNotes = @'
-Version 2025.11.07.0255:
+Version 2025.11.07.1503:
 - 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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</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.07.0255</UICultureVersion>
+      <UICultureVersion>2025.11.07.1503</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>
diff --git a/codecov.yml b/codecov.yml
@@ -2,7 +2,7 @@
 # See: https://docs.codecov.com/docs/codecov-yaml
 # Optimized for PowerShell module architecture
 # Updated for 2025 Codecov best practices
-
+# yaml-language-server: $schema=https://www.schemastore.org/codecov.json
 codecov:
     archive:
         uploads: true # Keep historical data for analytics
@@ -19,7 +19,8 @@ comment:
     behavior: default
     hide_project_coverage: false
 
-    layout: "header, flags, diff, tree, files, reach, betaprofiling, components, footer, feedback"
+    layout: "header, flags, diff, tree, files, reach, betaprofiling, components,
+        footer, feedback"
     require_base: false # Allow comments on first PR
     require_changes: false
     require_head: false # Require head report to comment
@@ -103,8 +104,12 @@ coverage:
         - "yarn.lock"
         - "pnpm-lock.yaml"
 
-        # Test files (don't test the tests, but since tests are PowerShell, we do)
-        # Note: For PowerShell, test files are included in coverage
+        # Test files (excluded to avoid counting coverage for the tests themselves)
+        - "Tests/**/*"
+
+        # Script automation and tooling (excluded from totals)
+        - "scripts/**/*"
+        - "ColorScripts-Enhanced/Scripts/**/*"
 
         # Static assets
         - "assets/**/*"
@@ -125,6 +130,7 @@ coverage:
         patch:
             default:
                 only_pulls: false
+                base: auto
                 target: 70% # Realistic for new code in PowerShell
                 threshold: 10%
             module:
diff --git a/dist/LatestReleaseNotes.md b/dist/LatestReleaseNotes.md
@@ -4,52 +4,63 @@
 
 All notable changes to this project will be documented in this file.
 
-## [2025.11.6.819] - 2025-11-06
+## [2025.11.7.803] - 2025-11-07
 
 
-[[f8c860b](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/f8c860b175742b74ff7309a2f66ff65a7d2f75a6)...
-[f8c860b](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/f8c860b175742b74ff7309a2f66ff65a7d2f75a6)]
-([compare](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/compare/f8c860b175742b74ff7309a2f66ff65a7d2f75a6...f8c860b175742b74ff7309a2f66ff65a7d2f75a6))
+[[ed4c182](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/ed4c18269d262fa1ff2658a6dfe1f318597513f3)...
+[1376dd6](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/1376dd62675cd1b8e3a0d5bfeb27dbf4008e9d35)]
+([compare](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/compare/ed4c18269d262fa1ff2658a6dfe1f318597513f3...1376dd62675cd1b8e3a0d5bfeb27dbf4008e9d35))
 
 
 ### ≡ƒÆ╝ Other
 
-- Γ£¿ [feat] Add localization-mode selection, on-demand cache validation docs, localized cache-summary rendering, module/help bumps, and tooling updates
+- Γ£¿ [feat] Update module version and help info for localization improvements
+ - Update module version to '2025.11.07.0137' in manifest and help files
+ - Enhance caching system with OS-wide cache in AppData
+ - Improve progress reporting in New-ColorScriptCache function for better user feedback
+ - Ensure no background runspace pools remain before analyzer runs to avoid errors
 
-- Γ£¿ [feat] Runtime localization mode & env parsing
- - Γ£¿ [ColorScripts-Enhanced](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced).psm1: introduce $script:LocalizationMode and parse COLOR_SCRIPTS_ENHANCED_LOCALIZATION_MODE (supports 'auto', 'full', 'embedded'); honor legacy toggles COLOR_SCRIPTS_ENHANCED_FORCE_LOCALIZATION and COLOR_SCRIPTS_ENHANCED_PREFER_EMBEDDED_MESSAGES.
- - Γ£¿ [ColorScripts-Enhanced](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced).psm1: pass -UseDefaultCandidates to Initialize-ColorScriptsLocalization to enable the new fallback behavior when importing localization resources.
+Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(1376dd6)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/1376dd62675cd1b8e3a0d5bfeb27dbf4008e9d35)
 
-- Γ£¿ [feat] Embedded-defaults preference & PSD1 probing
- - Γ£¿ Private/Initialize-ColorScriptsLocalization.ps1: add -UseDefaultCandidates switch and $useDefaultCandidatesFlag; compute preferredCulture from CurrentUICulture and implement preferEmbeddedDefaults logic for 'Embedded' and 'Auto'+UseDefaultCandidates flows.
- - Γ£¿ Private/Initialize-ColorScriptsLocalization.ps1: probe candidatePaths for Messages.psd1 (preferred culture chain + fallback en-US/en) and, when no localized resources exist and embedded defaults are preferred, set $script:Messages to the embedded defaults and populate LocalizationDetails.Source = 'EmbeddedDefaults' (with trace output).
 
-- ≡ƒ¢á∩╕Å [fix] Localize and ANSI-color cache summaries
- - ≡ƒ¢á∩╕Å Public/New-ColorScriptCache.ps1 & Public/Clear-ColorScriptCache.ps1: read format strings from $script:Messages.CacheBuildSummaryFormat and CacheClearSummaryFormat (with sane fallbacks), format summary values, build an ANSI-colored summary segment via New-ColorScriptAnsiText (-Color 'Cyan') and pass that segment to Write-ColorScriptInformation for consistent, localizable output.
+- Γ£¿ [feat] Enhance cache building with multi-threading support
+ - ≡ƒô¥ Added documentation for the new `-Parallel` switch in `New-ColorScriptCache` to enable parallel cache builds on multi-core systems.
+ - ≡ƒ¢á∩╕Å Implemented the `-Threads` parameter (alias for `-ThrottleLimit`) to control the number of concurrent workers during cache builds.
+ - ΓÜí Improved performance by allowing cache builds to run in parallel, defaulting to the number of logical processors if `-Threads` is not specified.
+ - ≡ƒô¥ Updated help files in multiple languages to reflect the new features and version updates.
+ - ≡ƒº¬ Added tests to verify the functionality of the new parallel cache building feature, ensuring it returns correct metadata for successful and failed cache operations.
+ - ≡ƒº¬ Included tests for the `-Parallel` and `-Threads` parameters to confirm they work as expected.
 
-- ≡ƒô¥ [docs] Document -ValidateCache and localization modes
- - ≡ƒô¥ README.md, docs/Development.md, docs/MODULE_SUMMARY.md: add usage and guidance for forcing cache validation and for the new localization modes; recommend COLOR_SCRIPTS_ENHANCED_LOCALIZATION_MODE over legacy toggles.
- - ≡ƒô¥ en-US/Show-ColorScript.md & en-US help XML: add -ValidateCache parameter docs and guidance to force metadata validation before rendering; show examples and environment-variable usage (COLOR_SCRIPTS_ENHANCED_VALIDATE_CACHE).
+Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(3541e61)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/3541e614d7283bc9cfee95cd1d1bf01a751cd20f)
 
-- ≡ƒº╣ [chore] Add cache-summary message keys to localized resources
- - ≡ƒº╣ en-US + localized Messages.psd1 (de, es, fr, it, ja, nl, pt, ru, zh-CN): add CacheBuildSummaryFormat and CacheClearSummaryFormat entries so cache summaries can be localized/overridden via PSD1 files.
 
-- ≡ƒöº [build] [dependency] Update module manifest and localized help stamps; regenerate release artifacts
- - ≡ƒöº [ColorScripts-Enhanced](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced).psd1: bump ModuleVersion => '2025.11.06.0250' and update Generated on stamp.
- - ≡ƒöº localized HelpInfo.xml files (en-US, de, es, fr, it, ja, nl, pt, ru, zh-CN): synchronize UICultureVersion => '2025.11.06.0250'.
- - ≡ƒöº dist/LatestReleaseNotes.md & dist/PowerShellGalleryReleaseNotes.md: regenerate release headers/content to reflect the changes.
+- Γ£¿ [feat] Add console-preferred ANSI informational output and extend Write-ColorScriptInformation API
+ - ≡ƒ¢á∩╕Å Add new parameters to Write-ColorScriptInformation: -NoAnsiOutput, -PreferConsole, -Color and implement robust output-selection logic
+ - ≡ƒºá Detect COLOR_SCRIPTS_ENHANCED_FORCE_ANSI environment variable (case-insensitive true/1/yes/force/ansi/color) to force ANSI rendering when requested
+ - ΓÜí Prefer console rendering by calling Write-RenderedText when PreferConsole is set or when console is not redirected (safe Test-ConsoleOutputRedirected check inside try/catch)
+ - ≡ƒÄ¿ Provide ConsoleColor fallback: parse -Color to System.ConsoleColor, set [Console]::ForegroundColor, write sanitized output via script:ConsoleWriteDelegate, ensure trailing newline when needed, and restore original color in finally (errors are swallowed and traced)
+ - ≡ƒº╛ Sanitize informational output with Remove-ColorScriptAnsiSequence for the information stream; if -NoAnsiOutput is present emit raw/plain output
+ - ≡ƒöü When output was written to the console, set InformationAction = 'SilentlyContinue'; otherwise use 'Continue' and Write-Information -Tags 'ColorScripts'
 
-- ≡ƒöº [build] Formatting/tooling: add PowerShell Prettier plugin
- - ≡ƒöº .prettierrc: enable "prettier-plugin-powershell" in the plugin list.
- - ≡ƒöº package.json & package-lock.json: bump prettier-plugin-powershell to ^1.0.5 and update lockfile metadata.
+Γ£¿ [feat] Propagate output-preference flags through public cmdlets
+ - ≡ƒ¢á∩╕Å Update Clear-ColorScriptCache and New-ColorScriptCache to pass -PreferConsole and -Color 'Cyan' for summary segments so ANSI summaries can render to console when appropriate
+ - ≡ƒ¢á∩╕Å Update Show-ColorScript to compute $preferConsoleOutput = -not $NoAnsiOutput and consistently pass -NoAnsiOutput, -PreferConsole and -Color to all informational calls (displaying, mode, progress, divider, prompts, finished)
+ - ΓÜí Behavioral result: richer ANSI informational summaries in hosts that strip escape sequences while still honoring -NoAnsiOutput for plain-text needs
 
-- ≡ƒº¬ [test] Align tests with signature changes
- - ≡ƒº¬ Tests/[ColorScripts-Enhanced](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced).ModuleImportCoverage.Tests.ps1: update Initialize-ColorScriptsLocalization stubs to accept [switch]$UseDefaultCandidates and null-assign it to keep test stubs compatible with the new signature.
+≡ƒô¥ [docs] Document FORCE_ANSI usage
+ - ≡ƒô¥ Add Development.md guidance for COLOR_SCRIPTS_ENHANCED_FORCE_ANSI=1 to force ANSI informational summaries in hosts that strip escape sequences; clarify that commands still honor -NoAnsiOutput
 
-- ≡ƒº╣ [chore] Minor wiring & consistency
- - ≡ƒº╣ Ensure module import uses the new -UseDefaultCandidates flag so the embedded-defaults preference path is exercised during import initialization.
+≡ƒöº [build] [dependency] Update module/help stamps and release header
+ - ≡ƒöº [dependency] Update ModuleVersion in [ColorScripts-Enhanced](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced).psd1 to 2025.11.06.1527 and update the ReleaseNotes header to match
+ - ≡ƒöº Sync localized HelpInfo UICultureVersion stamps (en-US, de, es, fr, it, ja, nl, pt, ru) to 2025.11.06.1527
 
-Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(f8c860b)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/f8c860b175742b74ff7309a2f66ff65a7d2f75a6)
+≡ƒº¬ [test] Expand mocks and add coverage for new output paths
+ - ≡ƒº¬ Update existing Mock for Write-ColorScriptInformation in AdditionalCoverage tests to accept (Message, [switch]Quiet, [switch]NoAnsiOutput, [switch]PreferConsole, [string]Color)
+ - ≡ƒº¬ Add InternalCoverage tests that verify:
+   - Γ£à prefer-console path invokes Write-RenderedText once and writes sanitized info with InformationAction 'SilentlyContinue'
+   - Γ£à NoAnsiOutput path does not call Write-RenderedText and emits plain text via Write-Information with InformationAction 'Continue'
+
+Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com> [`(ed4c182)`](https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/commit/ed4c18269d262fa1ff2658a6dfe1f318597513f3)
 
 
 
diff --git a/dist/PowerShellGalleryReleaseNotes.md b/dist/PowerShellGalleryReleaseNotes.md
