Release: diagnostic error log, Log button, version display #14

Merged

hannah-vernon merged 2 commits from dev into main

2026-07-07 13:18:43 -05:00

hannah-vernon commented

2026-07-07 13:18:21 -05:00

Owner

What does this PR do?

Release: merges the diagnostic-log feature (#13) into main. The Version Bump workflow will tag the next v1.4.{PR number}.

Included change:

Diagnostic error log at %APPDATA%\TaylerLogTailer\logs\diagnostic.log with a per-session header (app version, OS, .NET, settings, watched windows) and full exception detail (type, message, HResult / Win32 code) for watcher and file-read failures.
Log toolbar button that opens a transient window live-tailing the log folder.
App version shown in the status bar (log path in the tooltip).

How was this tested?

dotnet build Tayler.slnx -c Release - 0 errors, 0 warnings (via build.ps1)
Session header written correctly; Log button opens the live-tailing window (see #13 for details).

Checklist

I have read the Contributing Guide
Changes are focused - one logical change per PR
Documentation updated (if user-visible behavior changed)
New dependencies are MIT/Apache-2.0 and security-vetted
No commented-out code or debug leftovers

## What does this PR do? Release: merges the diagnostic-log feature (#13) into `main`. The Version Bump workflow will tag the next `v1.4.{PR number}`. Included change: - **Diagnostic error log** at `%APPDATA%\TaylerLogTailer\logs\diagnostic.log` with a per-session header (app version, OS, .NET, settings, watched windows) and full exception detail (type, message, HResult / Win32 code) for watcher and file-read failures. - **Log** toolbar button that opens a transient window live-tailing the log folder. - **App version** shown in the status bar (log path in the tooltip). ## How was this tested? - [x] `dotnet build Tayler.slnx -c Release` - 0 errors, 0 warnings (via `build.ps1`) - [x] Session header written correctly; Log button opens the live-tailing window (see #13 for details). ## Checklist - [x] I have read the [Contributing Guide](../CONTRIBUTING.md) - [x] Changes are focused - one logical change per PR - [x] Documentation updated (if user-visible behavior changed) - [x] New dependencies are MIT/Apache-2.0 and security-vetted - [x] No commented-out code or debug leftovers

hannah-vernon added 2 commits

2026-07-07 13:18:21 -05:00

Add a diagnostic error log, a Log button, and a version display cf6e32c61f

Non-fatal problems (watcher errors, file read / access failures) were only shown
transiently in the status bar and then lost, which made intermittent network-
share issues hard to investigate. Add a persistent diagnostic log and make it
and the running version easy to reach from the UI.

- DiagnosticLog (new) - thread-safe append-only log at
  %APPDATA%\TaylerLogTailer\logs\diagnostic.log. Each session starts with a
  header recording the app version, OS, .NET runtime, process bitness, settings
  path, and the set of watched windows. Entries are ISO-8601 timestamped and
  include the exception type, message, and HResult / Win32 code. Rolls to
  diagnostic.log.1 past 1 MB. Logging never throws.
- AppInfo (new) - exposes the app version (from MinVer's informational version,
  build metadata trimmed) and product name.
- FolderTailer / FileTailer - log watcher creation failures, watcher
  interruptions (with the full exception, e.g. the "Incorrect function" /
  ERROR_INVALID_FUNCTION seen on some shares), poll errors, the file-limit
  notice, and per-file read failures. File read errors are de-duplicated per
  distinct message and a resume is logged when reading recovers, so a
  persistently failing file does not flood the log.
- FolderWindow - a "Log" toolbar button opens a transient window that live-tails
  the diagnostic log folder (marked Ephemeral via a new JsonIgnore flag on
  FolderConfig, so it is not remembered across runs). The status bar now shows
  the running version at its right-hand end, with the log path in its tooltip.
- App writes the session header at startup.
- README documents the diagnostic log, the Log button, and the version display.

Verified: build 0/0; launched the app, confirmed the session header (version
1.3.12, OS, .NET, settings, windows) is written, invoked the Log button via UI
Automation and confirmed it opens a window tailing the log with the version in
its status bar.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>