From 5345b00309ebd25ec1168b94d235b40ad0bdd1c3 Mon Sep 17 00:00:00 2001
From: Stuart Meeks <stuart.meeks@stuartmeeks.net>
Date: Sat, 30 May 2026 03:58:15 +0000
Subject: [PATCH] Release follow-ups: prerelease bool, CHANGELOG roll, README
 refresh

Three follow-up items after cutting v0.1.0-alpha.1:

- release.yml: PowerShell boolean string-interpolation produces 'True'
  /'False' (capitalised), which softprops/action-gh-release@v2 silently
  treats as falsy. The published release for v0.1.0-alpha.1 came out
  marked as a stable release rather than pre-release. Emit lowercase
  'true'/'false' strings explicitly.

- CHANGELOG: the previous [Unreleased] body shipped as 0.1.0-alpha.1
  on 2026-05-30. Move it under the dated section header and leave
  [Unreleased] empty for the next cycle.

- README: the Status paragraph was written pre-release ("WinUI shell
  and updater being layered on next"). Replace with an accurate alpha
  status and add an Install section pointing at the GitHub Releases.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .github/workflows/release.yml |  8 ++++++--
 CHANGELOG.md                  |  5 +++++
 README.md                     | 24 ++++++++++++++++++------
 3 files changed, 29 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index edcb9f6..b162397 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -44,11 +44,15 @@ jobs:
         run: |
           $tag = "${{ github.ref_name }}"
           $version = $tag.TrimStart('v')
-          $isPrerelease = $version.Contains('-')
-          if ($isPrerelease) {
+          # Emit lowercase 'true'/'false' explicitly — PowerShell's boolean
+          # string-interpolation produces 'True'/'False' (capitalised), which
+          # softprops/action-gh-release@v2 silently treats as falsy.
+          if ($version.Contains('-')) {
+            $isPrerelease = 'true'
             $channel = ($version -split '-', 2)[1] -replace '\..*$', ''
             if ([string]::IsNullOrWhiteSpace($channel)) { $channel = 'beta' }
           } else {
+            $isPrerelease = 'false'
             $channel = 'stable'
           }
           "version=$version"           >> $env:GITHUB_OUTPUT
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6ebb75c..24e6e80 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.0-alpha.1] - 2026-05-30
+
+First packaged release. Cuts an alpha to exercise the release pipeline
+end-to-end and put the v1 feature set in front of real users.
+
 ### Added
 - **Unhandled-exception logging.** Exceptions that previously vanished into
   WinUI's "Continue?" debugger dialog (and would have crashed the process
diff --git a/README.md b/README.md
index 32cf461..cce78d5 100644
--- a/README.md
+++ b/README.md
@@ -8,15 +8,27 @@ Conceptually inspired by SnipCommand, with one defining difference: **the CLI is
 the top-level organising axis** — every Snip belongs to exactly one CLI (e.g.
 `pl-app`, `mpt-app`, `inv-app`).
 
-> Snipdeck is in early development. The list below describes what's actually
-> implemented today, not what's planned.
+> Snipdeck is alpha software. The list below describes what's actually
+> implemented today, not what's planned. See [`TODO.md`](TODO.md) for the
+> backlog and [`CHANGELOG.md`](CHANGELOG.md) for what's shipped.
 
 ## Status
 
-In active development. The data model, JSON store, substitution engine, settings,
-backup service, and first-run seed live in `Snipdeck.Core` and are covered by
-unit tests. The WinUI 3 UI shell, platform services, and Velopack updater are
-being layered on next.
+Alpha. **v0.1.0-alpha.1** is the first packaged release — see
+[Releases](https://github.com/StuartMeeks/Snipdeck/releases). It contains
+the full v1 feature set: browse CLIs and Snips, author Snips with structured
+parameters, fill and copy resolved commands, global hotkey, system tray with
+close-to-tray, theme switching, and Velopack-backed self-update.
+
+## Install
+
+Download `Snipdeck-alpha-Setup.exe` from the latest
+[release](https://github.com/StuartMeeks/Snipdeck/releases) and run it.
+The installer is unpackaged (no Microsoft Store, no MSIX) and Velopack
+handles self-update from then on.
+
+Windows 11 is the supported target — Mica backdrop only renders there;
+on Windows 10 it falls back to a solid colour.
 
 ## Stack