# Release Manifest - TagLauncher 8.1.0 build 20260626.1726

## Identity

- Product: TagLauncher
- Version: `8.1.0`
- Build: `20260626.1726`
- Bundle ID: `com.taglauncher.app`
- Minimum macOS: `14.0`
- Category: `public.app-category.utilities`
- Generated at: `2026-06-26 18:03 CST`
- Branch: `codex/appgrid-usage-tips`
- Source commit: `2c36a4a39da126c30a5a5daedf501229412b2e1a`
- Release tag: `v8.1.0-build20260626.1726`
- CODEGRAPH status: checked and updated in source commit `2c36a4a`.

## Artifacts

- Local rollback DMG: `Release/AppStore-8.1.0-20260626.1726/Archive/TagLauncher-8.1.0-build20260626.1726.dmg`
- App Store upload PKG: `Release/AppStore-8.1.0-20260626.1726/Upload/TagLauncher-8.1.0-build20260626.1726.pkg`
- DMG SHA256: `346fc3c9bd0fcdb346d3f4ca83ffa46b34d3a5187155253d5dae7d999c39060f`
- PKG SHA256: `32de0ef0af979b2a35d60c2b1bca7461292db86781e4c64e694128470ddde264`
- App binary SHA256: `710073b46e176ce6224f5acfaca4e0e5d86b286355fc0bef335cab0d69f02884`
- DMG size: `6241554` bytes
- PKG size: `6011051` bytes

## Build Commands

```bash
cd /Users/ar/Projects/Taglauncher/src
APP_BUILD=20260626.1726 bash build.sh
bash make_dmg.sh
cp build/TagLauncher.dmg build/TagLauncher-8.1.0-build20260626.1726.dmg
```

## App Store Package Commands

```bash
cd /Users/ar/Projects/Taglauncher/src

PROFILE="$HOME/Library/MobileDevice/Provisioning Profiles/TagLauncher_Mac_App_Store_202606052337.provisionprofile"
APP_IDENTITY="0D7D5484FDE4EC1CA2C9225F1E71E65A256A1E7C"
INSTALLER_IDENTITY="3rd Party Mac Developer Installer: Hainan Wanxing Technology Co., Ltd. (CR3J54M8BQ)"

# Copy build/TagLauncher.app to a temporary staging directory, embed the profile,
# clear xattrs, sign with runtime + sandbox entitlements, then productbuild.
productbuild --component /tmp/.../stage/TagLauncher.app /Applications \
  --sign "$INSTALLER_IDENTITY" \
  build/AppStore/TagLauncher-8.1.0-build20260626.1726.pkg
```

The staged App Store app was signed with:

- `com.apple.application-identifier = CR3J54M8BQ.com.taglauncher.app`
- `com.apple.developer.team-identifier = CR3J54M8BQ`
- `com.apple.security.app-sandbox = true`
- `com.apple.security.files.user-selected.read-write = true`
- `keychain-access-groups = [CR3J54M8BQ.*]`

## Verification Commands

```bash
bash Scripts/pro_feature_gate_qa.sh
bash Scripts/pro_localization_qa.sh
bash Scripts/macos14_build_metadata_qa.sh
bash Scripts/macos14_availability_typecheck_qa.sh
codesign --verify --deep --strict --verbose=2 build/TagLauncher.app
hdiutil verify build/TagLauncher-8.1.0-build20260626.1726.dmg
hdiutil attach -readonly -nobrowse build/TagLauncher-8.1.0-build20260626.1726.dmg
pkgutil --check-signature build/AppStore/TagLauncher-8.1.0-build20260626.1726.pkg
pkgutil --expand-full build/AppStore/TagLauncher-8.1.0-build20260626.1726.pkg /tmp/taglauncher-pkg-preflight-8.1.0-180303
codesign --verify --deep --strict --verbose=2 /tmp/taglauncher-pkg-preflight-8.1.0-180303/com.taglauncher.app.pkg/Payload/TagLauncher.app
```

## Release Scope

- Adds the Free + Pro unlock model for TagLauncher.
- Keeps core local tagging, app launching, Quick Search, default themes, Deep Blue, and Black available for free users.
- Locks premium themes, layout import/export, unlimited custom notes, and persistent app sorting behind Pro.
- Adds StoreKit 2 purchase, restore, transaction update listening, offline entitlement cache, and legacy paid-user unlock.
- Protects free previews from dirtying real user data: premium theme previews do not persist, free sorting previews do not write container order, blocked notes do not mutate stored notes, and import/export is gated before file reads or writes.
- Adds 29-language Pro copy and static QA for Pro localization and feature gates.

## App Store Upload

- Upload `Upload/TagLauncher-8.1.0-build20260626.1726.pkg`, not the DMG in `Archive/`.
- Confirm the non-consumable in-app purchase product `com.taglauncher.pro.lifetime` exists in App Store Connect and is associated with version `8.1.0`.
- If `Missing Compliance` appears, answer the encryption question with `None of the algorithms mentioned above`.
- Before filling What's New, confirm the current App Store baseline / replaced build and review cumulative changelog entries through `8.1.0`.