diff --git a/CHANGELOG.md b/CHANGELOG.md index 872e5949..65cbe3c7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,25 +1,39 @@ # Changelog -All notable changes are documented here. The project follows Semantic Versioning where practical while it remains in public beta. +All notable changes are documented here. Public stable versions retain immutable tags and published binaries. ## [Unreleased] -### Implemented in release-candidate branch (public stable acceptance pending) - -- Unified selected-stream phasor RMS/angle display without UI-side nominal phase overrides; improved six-vector label collisions, separate measured U/I scales, legible 270° convention, stale data and live-with-warning semantics -- Removed fabricated Ethernet adapter fallback and pinned native Npcap discovery/capture to trusted Windows x64 system library paths -- Added deterministic phasor, compact-caption, adapter and status regression tests -- Made Inno Setup self-contained EXE the primary Windows distribution, with same-version repair, in-place upgrade, offline manuals and install/repair/uninstall CI evidence -- Generated packaged PDF manuals from current Markdown source, with SHA256 provenance and stale-PDF rejection -- Hardened stable publication to manual main-only authorization after documented physical acceptance; no automatic public release on tag push -- Physical target-NIC/injector 60-minute acceptance remains pending for the current candidate; earlier 1.3.0 soak evidence does not substitute - ### Planned - - Sanitized golden PCAP/PCAPNG replay corpus with broader interoperability scenarios - Further decomposition of the analyzer runtime and WPF workspace - Expanded SCL validation - Evidence export for FAT/SAT reports +- Independent canonical SV/PTP physical acceptance and soak evidence (tracked in issue #30) + +## [1.4.2] - 2026-10-21 + +### Stable GOOSE engineering workflow +- Stable physically keyed multi-source GOOSE publisher selection and searchable Sources +- Compact one-line Messages header, Show repeats and Follow live switches, bounded event history +- Actual decoded DataSet changes correlated across Sources, Messages, and Inspector +- Shared operator acknowledgement state with unobtrusive red unread dot +- Change value emphasis only while unread; before/after values available in tooltip +- Robust stale-source handling, retransmission filtering, explicit decoder gap/overflow notices +- Windows x64 self-contained stable Inno Setup installer, portable ZIP, SHA256 and manifest + +### Verification +- Official stable v1.4.2 Windows Release build on main; 241/241 unit tests, layout contract, package verification and Inno install/repair/uninstall smoke PASS +- Engineering PR checks also passed runtime stability, architecture, CodeQL and dependency security +- Independent field TAP/IED acceptance is not claimed by a software release + +## [1.4.1] - 2026-10-21 + +### Release highlights +- Multi-stream SV metering, waveform, phasor and compact engineering workspaces +- Stable Npcap adapter handling, diagnostics grouping, and readable SCL/PTP presentation +- Self-contained Inno installer with in-place repair/upgrade and offline manuals +- Deterministic phasor, adapter discovery and status regression coverage ## [1.4.0-beta.2] - 2026-07-15 @@ -112,7 +126,9 @@ All notable changes are documented here. The project follows Semantic Versioning - Hardened BER parsing, Npcap lifecycle, release version propagation, and public-repository packaging. -[Unreleased]: https://github.com/masarray/DigSubAnalyzer/compare/v1.4.0-beta.2...HEAD +[Unreleased]: https://github.com/masarray/DigSubAnalyzer/compare/v1.4.2...HEAD +[1.4.2]: https://github.com/masarray/DigSubAnalyzer/compare/v1.4.1...v1.4.2 +[1.4.1]: https://github.com/masarray/DigSubAnalyzer/releases/tag/v1.4.1 [1.4.0-beta.2]: https://github.com/masarray/DigSubAnalyzer/compare/v1.4.0-beta.1...v1.4.0-beta.2 [1.4.0-beta.1]: https://github.com/masarray/DigSubAnalyzer/compare/v1.3.0-beta.2...v1.4.0-beta.1 [1.3.0-beta.2]: https://github.com/masarray/DigSubAnalyzer/compare/v1.3.0-beta.1...v1.3.0-beta.2 diff --git a/docs/QUICK_START.md b/docs/QUICK_START.md index 276f82fc..0241a95d 100644 --- a/docs/QUICK_START.md +++ b/docs/QUICK_START.md @@ -20,8 +20,8 @@ Avoid these adapters for serious timing interpretation: ## 2. Download and install -1. Open [official GitHub Releases](https://github.com/masarray/DigSubAnalyzer/releases). -2. Download `ProcessBusInsight-vX.Y.Z-win-x64-setup.exe` and verify its SHA256 against `SHA256SUMS.txt`. +1. Download [latest stable Windows installer (.exe)](https://github.com/masarray/DigSubAnalyzer/releases/download/v1.4.2/ProcessBusInsight-v1.4.2-win-x64-setup.exe) directly, or use the [landing page](https://masarray.github.io/DigSubAnalyzer/) which discovers newer stable releases automatically. +2. Verify the installer against the official [SHA256SUMS.txt](https://github.com/masarray/DigSubAnalyzer/releases/download/v1.4.2/SHA256SUMS.txt). 3. Close any prior running instance and run the Inno Setup installer. It installs into `C:\Program Files\Process Bus Insight` by default, creating a Start Menu shortcut and optional desktop shortcut. 4. For an upgrade, run the newer installer without uninstalling first; the stable application identity retains the previous install directory. Re-running the same installer can repair files. 5. The optional portable ZIP can still be extracted manually to `C:\Tools\ProcessBusInsight` when appropriate. diff --git a/docs/RELEASE_PACKAGING.md b/docs/RELEASE_PACKAGING.md index 41f8f120..fb0e9ba5 100644 --- a/docs/RELEASE_PACKAGING.md +++ b/docs/RELEASE_PACKAGING.md @@ -62,13 +62,13 @@ git add -f docs/QUICK_START.pdf docs/USER_MANUAL.pdf ## Local packaging ```powershell -.\scripts\repository-health.ps1 -ExpectedVersion "1.4.1" +.\scripts\repository-health.ps1 -ExpectedVersion "1.4.2" python -m pip install reportlab==4.4.9 python .\scripts\render-offline-manuals.py -.\scripts\publish-windows-portable.ps1 -Version "1.4.1" -.\scripts\verify-release-package.ps1 -PackageZip ".\artifacts\release\ProcessBusInsight-v1.4.1-win-x64-portable.zip" -.\scripts\publish-windows-installer.ps1 -Version "1.4.1" -.\scripts\verify-windows-installer.ps1 -Installer ".\artifacts\release\ProcessBusInsight-v1.4.1-win-x64-setup.exe" -StageDir ".\artifacts\package\ProcessBusInsight-v1.4.1-win-x64-portable" +.\scripts\publish-windows-portable.ps1 -Version "1.4.2" +.\scripts\verify-release-package.ps1 -PackageZip ".\artifacts\release\ProcessBusInsight-v1.4.2-win-x64-portable.zip" +.\scripts\publish-windows-installer.ps1 -Version "1.4.2" +.\scripts\verify-windows-installer.ps1 -Installer ".\artifacts\release\ProcessBusInsight-v1.4.2-win-x64-setup.exe" -StageDir ".\artifacts\package\ProcessBusInsight-v1.4.2-win-x64-portable" ``` ## GitHub workflows