Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.6.7] - 2026-06-02

Reorganized utils/ into engine, plugin, and module layout (engines/, plugins/, modules/, tools/) with root entry scripts (Invoke-TestEngine.bat, Invoke-ReleasePackage.bat, and related launchers).
TestRunner: resolves .csproj paths explicitly, builds once, then runs dotnet test --no-build to reduce file-lock failures on Windows.

Test engine scriptSettings.json paths corrected for the utils/engines/test layout.
EnvVarTests: user-level environment variable tests no longer hang the xUnit test host on Windows (non-parallel collection and timeout-safe skip).
.gitignore: added override rules so the utils/ folder is tracked despite broader ignore patterns.

Replaced explicit ArgumentNullException throws with ArgumentNullException.ThrowIfNull in ExpressionExtensions, NetworkConnection, Base32Encoder, StringExtensions.CSVToDataTable, FileLoggerProvider, and JsonFileLoggerProvider.
Base32Encoder: empty input now throws ArgumentException instead of ArgumentNullException for clearer semantics.
StringExtensions.CSVToDataTable: null file path throws via ThrowIfNull; empty/whitespace path throws ArgumentException.
ObjectExtensions: DeepClone returns default for null input; DeepEqual explicitly treats (null, null) as true and (null, non-null) as false. Replaced obsolete FormatterServices.GetUninitializedObject with RuntimeHelpers.GetUninitializedObject. Fixed nullability in ReferenceEqualityComparer to match IEqualityComparer<object>.
TotpGenerator: recovery code generation uses range syntax (code[..4], code[4..8]) instead of Substring.

ExceptionExtensions.ExtractMessages: null check added to avoid NullReferenceException when passed null.
BaseFileLogger.RemoveExpiredLogFiles: guard added before Substring(4) so malformed log file names do not throw.

New shared utility modules under utils/:
Logging.psm1 for timestamped, aligned log output.
ScriptConfig.psm1 for shared settings loading and command assertions.
GitTools.psm1 for reusable git operations.
TestRunner.psm1 for shared test/coverage execution.
New Generate-CoverageBadges utility script and settings to generate SVG coverage badges.

Refactored release/amend/badges scripts to a modular structure with shared modules.
Standardized script structure with regions and clearer comments.
Switched script output to centralized logging format with timestamps (where logging module is available).
Updated release settings comments (_comments) for clarity and accuracy.
Updated README.md to show coverage badges.

Removed legacy scripts from src/scripts/ in favor of the utils/-based toolchain.
Removed unused helper logic (including obsolete step-wrapper usage and unused csproj helper).

Fixed NuGet packing metadata by explicitly packing LICENSE.md, README.md, and CHANGELOG.md into the package.
Fixed release pipeline packaging flow to create and resolve the .nupkg before dotnet nuget push.
Added /staging to .gitignore to avoid committing temporary release artifacts.

Kept release-time git checks and branch/tag validation in shared release flow to reduce accidental publish risk.