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.

[Unreleased]

Fixed

  • Dependency audit: pin uv>=0.11.15 (GHSA-4gg8-gxpx-9rph).

[0.4.0] - 2026-06-01

Changed

  • Step 1 clinical preset buttons scroll horizontally when they do not fit on one row.

Fixed

  • Wizard window: title-bar maximize and resize on steps 1+ (step 0 stays compact).

  • Step 1 initial settings: vertical scrollbar in its own column; no overlap with electrode canvases.

[0.4.0b2] - 2026-05-21

Added

  • In-app Update now on the update-available dialog: downloads and runs the platform install scripts (install.ps1 on Windows, install.sh on macOS / Linux) for the selected GitHub release tag, then prompts you to restart the app from the Start menu or applications launcher.

  • View release notes on the same dialog opens full release notes (and a GitHub link) in a separate window.

  • dbs_annotator.utils.auto_update with optional dry_run=True (PowerShell -WhatIf / install.sh --dry-run) for maintainers to preview an install.

  • Read the Docs screenshot pipeline: home screen (light and dark theme), clinical and session scales settings dialogs, and regenerated workflow captures at native resolution (HiDPI-aware screen grab, improved PNG settings).

  • docs/_static/custom.css: full-width RTD content; screenshot-full (wizard steps) and screenshot-native (home, dialogs) capped at each PNG’s intrinsic width so dialogs are not upscaled on wide screens.

  • COPYRIGHT_HOLDERS and APP_LICENSE_NAME in config.py (shared with documentation).

  • APP_MAINTAINER in config.py; Help dialog lists Maintainer: Richard Köhler under lead developer.

Changed

  • Help dialog rewritten around the standard Complete Workflow programming pipeline, timestamped task-programming TSV output, and Word/PDF reports; notes that each stimulation configuration is saved and summarised in reports; copyright lists MGH, Wyss Center, and Charité; MIT license noted.

  • Update-available dialog: removed the extra “don’t notify automatically” checkbox (that preference stays under Help only); release notes are no longer inlined—use View release notes; Open download page removed in favour of Update now.

  • Pre-release update notice: “If you encounter issues, please report them to …”.

  • Annotations-only file step header title: Clinical Annotations Setup (was “Output File”).

  • Home screen buttons: Complete Workflow and Annotations-only Workflow.

  • Annotations-only TSV column annotation renamed to notes (aligned with the Complete Workflow); legacy files with an annotation header remain readable and appendable.

  • Read the Docs: workflow_session.rst renamed to workflow_complete.rst; quickstart.rst documents launching the installed app (Start Menu / MSI / install script), all three workflows in home-screen order, and links to the full guides; index.rst Quick Overview matches the same order.

  • workflow_complete.rst: Step 0 file setup (Open / New, Session ID / Run ID); UI actions documented as Insert and Close session; only one overview video at the top of the page.

  • workflow_annotations.rst: dedicated task-notes schema (date, time, timezone, notes); no merge of multiple TSV files; Insert / Close Session; overview video removed.

  • longitudinal_report.rst: single overview video at the top; Create Longitudinal Report button naming.

  • output_format.rst: task-programming vs task-notes / annotations workflow called out in filename convention; generated schema uses notes for annotations-only files.

  • faq.rst: TSV save path references Step 0 file setup.

  • README What It Does aligned with RTD (four Complete Workflow steps, three workflows, link to workflow_complete.rst); installation and Contributing sections unchanged.

  • Documentation copyright: Massachusetts General Hospital, Wyss Center for Bio and Neuroengineering, and Charité Universitätsmedizin Berlin.

  • Screenshot capture uses the app’s responsive window geometry (step 0 compact, steps 1+ full workflow) instead of a fixed 1600×1000 frame.

  • workflow_complete.rst: drop standalone electrode_diagram.png (electrode UI is already visible in the Step 1 screenshot).

Fixed

  • Dependency audit: pin idna>=3.15 (GHSA-65pc-fj4g-8rjx); allow idna in exclude-newer-package so the fix is not blocked by the one-week cooldown.

  • Update checker: HTTPS uses the certifi CA bundle (fixes failed or empty GitHub API responses in Briefcase MSI/ZIP on Windows); compares against APP_VERSION; empty or invalid release data surfaces as errors instead of a misleading “no updates” dialog.

  • Electrode diagram export: E0–En labels no longer clipped on the left in PNG output (wider label box and export left padding in ElectrodeCanvas).

  • Docs screenshot pipeline: Windows QPixmap.save/PNG compression; trim grabWindow shadow bar on wizard captures; remove duplicate electrode-canvas.png artifact.

  • Read the Docs build: installation.rst SmartScreen cross-reference and label placement for Sphinx -W builds.

[0.4.0b1] - 2026-05-08

Changed

  • Fixed Linux release raw-archive packaging in CI for Briefcase linux system builds by detecting package roots via usr/bin + usr/lib/dbs_annotator/app and archiving the usr/ tree, ensuring the launcher is included in the uploaded raw tarball. (#97)

  • Windows install script is only scripts/install.ps1; removed Install-DBSAnnotator.ps1 and updated references. (#76)

  • Persist deactivated Step 3 session scales as NaN in the session TSV and omit them from Word and PDF reports. (#94)

  • Refreshed uv.lock with upgraded dependencies (including security-related updates for pip and gitpython). (#95)

Fixed

  • Fix install.ps1 when run with iex: move install into a nested function so $PSCmdlet binds; document iex vs script parameters (& ([scriptblock]::Create((iwr …).Content)) or local install.ps1). (#77)

  • Simplify install.ps1 and update README. (#78)

  • Fix scripts/install.sh for POSIX sh and Linux launcher paths (bin/, dbs_annotator). (#79)

  • Fix scripts/install.sh for POSIX sh, LF line endings, Linux launcher discovery (bin/, dbs_annotator), and clearer errors when a release raw .tar.gz lacks the Briefcase stub. Linux release workflow now selects the full app/ tree (largest tree with bin/) for the raw archive. (#80)

[0.4.0a2] - 2026-04-22

Added

  • Add a Windows PowerShell installer (scripts/install.ps1) and README one-liner to install the portable release .zip from GitHub when the MSI is unsigned. (#70)

  • Add scripts/install.sh (curl/wget) to install from GitHub Releases on Linux x86_64 and macOS (raw .tar.gz when present, else .deb / .dmg), with README and installation docs. (#71)

[0.4.0a1] - 2026-04-22

Added

  • Initial changelog scaffold following Keep a Changelog 1.1.0.

Changed

  • Deduplicate TSV schema docs by generating tables from code constants, add CI/pre-commit drift checks, and extend documentation automation with docs-touch/changelog gates, Release Drafter, and Read the Docs tag triggers. (#51)

  • Improve documentation automation and TSV schema generation. (#52)

  • Document PR-based releases (scripts/release_prepare.py, CD - Prepare release PR workflow), maintainer docs/releasing.rst, and Sphinx generated-dir guidance (_autosummary, _generated, _static, _templates). (#55)

  • Ship 0.4.0a1 alpha, space-free data/install paths (WyssCenter / DBSAnnotator), optional GitHub release update checks, upgrade-safe user config locations, and release_prepare.py --bump for prerelease and semver bumps. (#62)

  • Update checker compares all published GitHub releases for the highest applicable newer semver (including pre-releases), handles repos with no releases quietly, surfaces pre-release guidance with support links, and lets users turn off automatic update checks from Help or the notification. (#63)

  • Consolidate branding under icons/logosimple/ for Briefcase and Qt, add scripts/build_app_icons.py to generate platform icon sizes from a single source PNG, and document Linux linux system icon requirements. (#66)