Skip to content

docs: align changelog, packaging and quick start with stable v1.4.2 #54

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
masarray merged 3 commits into from
Oct 21, 2026
Merged

docs: align changelog, packaging and quick start with stable v1.4.2 #54

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
04f320e
docs(stable): synchronize CHANGELOG.md with public v1.4.2 release
masarray Oct 21, 2026
c8c8226
docs(stable): synchronize docs/RELEASE_PACKAGING.md with public v1.4.…
masarray Oct 21, 2026
2fba4a4
docs(stable): synchronize docs/QUICK_START.md with public v1.4.2 release
masarray Oct 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 29 additions & 13 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/QUICK_START.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
10 changes: 5 additions & 5 deletions docs/RELEASE_PACKAGING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading