# QA And Release Evidence

## Local Build

- Version: `7.8.1`
- Build: `20260529.1235`
- Source ref: `appstore-7.8.1-20260529.1235`
- App path: `/Users/ar/Projects/Taglauncher/build/TagLauncher.app`
- DMG path: `/Users/ar/Projects/Taglauncher/build/TagLauncher.dmg`
- App executable size: `1.4M`
- DMG size: `5.7M`

2026-05-29 release freeze: the local QA app, DMG, and App icon assets were regenerated from the `7.8.1` source tree.

## Hashes

```text
72b62d28529ee41e4ae22c972ab14b81b93788d011f0e64df6e941b39a50c1a3  build/TagLauncher.dmg
ad08345b3ab64fa85dc6025e076721dc8f6713f17c96e21f08dd0a86436636f4  build/TagLauncher.app/Contents/MacOS/TagLauncher
```

## Commands Run

```bash
bash build.sh
bash make_dmg.sh
codesign --verify --deep --strict --verbose=2 build/TagLauncher.app
hdiutil verify build/TagLauncher.dmg
python3 generate_icon.py
APP_BUILD=20260529.1235 bash Scripts/window_logic_qa.sh
```

## Window Logic QA Result

`Scripts/window_logic_qa.sh` passed for this release line after the `7.8.0` keyboard routing and scroll stability changes. Earlier builds `20260524.1652` and `20260524.1849` should not be used for App Store prep because they did not include the final fullscreen/Split View Quick Search, Settings close/refocus, same-app Split View, icon transparency, AppKit tag navigation, and scroll-after-keyboard fixes.

Covered checks:

- Repeated self-launch keeps exactly one process.
- Repeated self-launch keeps exactly one Dock tile.
- Fullscreen Space overlay appears above the current fullscreen app.
- Fullscreen Space overlay is checked with `showDockIcon=true` and `showDockIcon=false`.
- Fullscreen Space overlay bounds must match the fullscreen target display and remain stable across repeated samples.
- Fullscreen Space Quick Search opens from app grid without switching away from the current fullscreen app.
- Fullscreen Space Settings opens from app grid without switching away from the current fullscreen app.
- Closing Settings in a fullscreen/Split View overlay session does not reactivate TagLauncher into another Space.
- Split View fullscreen geometry is checked for 50/50 and 33/67 split layouts, while ordinary side-by-side desktop windows are rejected.
- Same-app two-window Split View geometry follows the same fullscreen Split View path as two-app Split View.
- App grid claims foreground, hides Dock, and keeps menu bar visible.
- Settings floats above app grid.
- File panel floats above Settings.
- Quick Search stays above app grid and supports two-Escape logic.
- AppGrid scroll keeps `Space` and `Esc` keyboard routing stable across repeated scroll/search/close cycles.
- Clicking outside Quick Search closes search, not app grid.
- System Force Quit window stays above TagLauncher.
- Pointer-following logic was checked on two displays; AppGrid followed the pointer on each screen.

## Quick Search Verification

The release includes Quick Search keyboard behavior fixes while the text field is actively editing and after AppGrid scrolling:

- The first search result is selected by default.
- Up and Down arrows move the selected result.
- Return opens the selected result.
- Numeric keypad Enter follows the same submit path.
- Escape closes Quick Search.
- After AppGrid scrolling, Space opens Quick Search and Escape closes Quick Search/AppGrid in the expected two-step sequence.

The behavior was verified by automated window QA and local UI smoke testing before freezing this release pack.

## Crash Check

After the window fixes, no newer TagLauncher crash report appeared. The latest crash report remained the known pre-fix crash:

```text
TagLauncher-2026-05-23-072321.ips
```

Root cause of that crash:

```text
NSWindow _validateCollectionBehavior:
```

The invalid overlay collection behavior was removed.

## DMG Verification

```text
hdiutil: verify: checksum of "/Users/ar/Projects/Taglauncher/build/TagLauncher.dmg" is VALID
```

## Help PDF Verification

- The broken macOS Help Book binding was removed.
- The standard menu bar now has a localized Help menu with a single `Download Help PDF` item.
- The About page includes an `Open Help PDF` button and a copy-link button.
- The app binary contains the immutable GitHub Release Help PDF URL shape.
- The app binary no longer contains the old `raw.githubusercontent` Help URL or `TagLauncherLocalizedHelpMenuItem`.
- The public GitHub Release assets for all 29 Help PDFs returned HTTP `200`.

## Code Signing Verification

```text
/Users/ar/Projects/Taglauncher/build/TagLauncher.app: valid on disk
/Users/ar/Projects/Taglauncher/build/TagLauncher.app: satisfies its Designated Requirement
```

This verification is for the local ad-hoc signed QA build. App Store upload still needs App Store distribution signing.