Skip to content

Document the release process - #11

Merged
trsdn merged 1 commit into
mainfrom
release-checklist
Sep 17, 2026
Merged

trsdn merged 1 commit into
mainfrom
release-checklist

Conversation

@trsdn

@trsdn trsdn commented Sep 17, 2026

Copy link
Copy Markdown
Owner

Summary

Third of issue #7's four checklist items: documents how a release is actually cut, now that the broker profile (trsdn/macos-notarization-broker#49) and AppUpdater integration (#10) are both merged.

Adapted from trsdn/OpenSwitchr's RELEASE_CHECKLIST.md, the closest existing precedent, but corrected for what's genuinely different in this repo:

  • No manual version bump. OpenSwitchr's checklist has a step to hand-edit Info.plist's version. OpenPromptr doesn't need that: build-app.sh and the broker's assemble_openpromptr both derive the version from the git tag automatically (this session's earlier work). The checklist calls this out explicitly so nobody "fixes" a version mismatch by hand-editing the plist.
  • No diag CLI. OpenSwitchr's step 4 runs openswitchr-diag; OpenPromptr has nothing equivalent, so verification is the README's existing runtime self-test, or a manual pass over each source type.
  • A dedicated "Testing the updater" section, since issue In-app updates via AppUpdater (needs a signed release path first) #7's own checklist calls this out as its own step: nothing exists for the updater to find until a second release exists, and installing must be refused while output is running or recovering.

Links added from AGENTS.md and the README's "Checking for updates" section.

Remaining after this: actually cutting the first release and testing an update with the second (issue #7's last item) — needs real Apple Developer credentials and manual broker invocation, so left to the maintainer's own timing.

Test plan

  • swift build, swift format lint --strict clean (docs-only change; sanity-checked nothing else broke)
  • README anchors referenced from RELEASE_CHECKLIST.md verified to exist (#optional-runtime-self-test, #upgrading-from-teleprompter-mirror)
  • CI

🤖 Generated with Claude Code

https://claude.ai/code/session_01XBbvDgF84mTXMJMcioTX4U

Documents how a signed release is actually cut, adapted from
trsdn/OpenSwitchr's RELEASE_CHECKLIST.md for what's genuinely
different here: the version comes from the git tag automatically
(build-app.sh and the broker's assemble_openpromptr both derive it),
so there's no manual Info.plist bump step; there's no diag CLI, so
verification is the README's runtime self-test or a manual pass over
each source type; and there's a dedicated section on testing the
updater itself, which needs a second release to have anything to find.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XBbvDgF84mTXMJMcioTX4U
@trsdn
trsdn merged commit f93cd53 into main Sep 17, 2026
4 checks passed
@trsdn
trsdn deleted the release-checklist branch September 17, 2026 09:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant