# Changelog

All notable changes to SitRepTools are documented here.

## [1.1.0] - unreleased

### Added
- **F!104 Situation Report support** — two new operations in the Operations menu:
  - **Combine F!104 Records** — merges F!104 records from all files in a folder,
    deduplicates (by CSA + grid + datecode), sorts by timestamp, and writes a
    single output file (`f104_combined_*.txt`)
  - **Extract F!104 Records** — filters F!104 records from a single file by
    date/time range and/or Maidenhead grid prefix (`f104_extract_*.txt`)
- **F!104 export formats** — all three formats (Minimal, Minimal + Date Decode,
  Full) now apply to F!104 output. The F!104 marker is always written (unlike
  F!505 Minimal) since there is no score string to identify the record without it.
  Example Minimal line: `F!104 200 GR[EL99HC]`
- **F!104 operation summary** — after each F!104 run the log shows a status
  breakdown (1 Normal / 2 Degraded / 3 Problems) and a count of records with
  an active alert flag (CSA character 3 = E).
- **ALERT pass-through** — F!505 records containing the ALERT keyword are
  detected on import and can optionally carry ALERT through to the export file.
  A new checkbox in Preferences → Output — "Include ALERT in exported records" —
  controls this behavior; it is off by default. F!104 alert status is always
  preserved in the CSA string and is not affected by this setting.

### Changed
- Operations menu items renamed from "Combine Records" / "Extract Records" to
  "Combine F!505 Records" / "Extract F!505 Records" for clarity; F!104 items
  added below a separator.
- User Manual updated to v1.1.0: Sections 1, 2, 3, 4, 5.2, 7.1, 7.3, 8, 9,
  10, and 11 updated to cover F!104 operations, export format notes, file
  naming, summary breakdown, input formats, and import instructions.

## [1.0.0] - 2026-05-18

Initial public release.

### Added
- Core operations: Combine Records, Extract Records, Decode Datecodes
- Export format preference: Full (standard F!505) or Minimal (grid + datecode only)
- Minimal + Date Decode export format combining minimal output with decoded dates
- Preferences dialog with configurable export format and version check URL
- Automatic version check on startup with update notification
- Summary file prompt before saving Combine Records output
- File dialogs raised to foreground on all platforms
- Windows batch launcher (`run.bat`) and Unix shell launcher (`run.sh`)
- User manual and installation guide
- Release build script (`build_release.py`)
- `setup.py` now creates a desktop shortcut at the end of setup (and when
  re-run). Windows gets a `.lnk` file with the 505 icon via PowerShell;
  Linux/Raspberry Pi gets an XDG `.desktop` file marked executable and
  trusted automatically where supported.
- `setup.py` on Linux now also installs the `.desktop` file to
  `~/.local/share/applications/` and pins SitRepTools to the GNOME dash
  favorites bar automatically. `StartupWMClass` is set so the running window
  links to the pinned icon correctly.

### Changed
- Installation Guide updated: manual `chmod` and desktop shortcut steps removed;
  desktop icon is now the documented primary launch method.
- Installation Guide updated: Step 4 notes that setup.py pins the app to the
  GNOME dash; Step 5 documents the dash icon and dot indicator behavior.
- User Manual updated: Quick Start and Notes & Tips reflect desktop icon launch;
  notes that re-running `setup.py` recreates the shortcut if the folder is moved.
- User Manual updated: Launching tip in Notes and Tips documents the GNOME
  dash icon and notes that re-running setup.py after moving the folder
  recreates both the desktop shortcut and dash icon.
- `build_release.py` now generates `dist/version.json` automatically as part
  of the build; no more manual editing of `version.json` between releases.

### Fixed
- Extract Records failing when input file used minimal format
- Minimal export format incorrectly including the F!505 marker
- Minimal export format omitting grid and datecode fields
- File dialogs appearing behind modal dialog windows
- Misleading label in Preferences dialog