Skip to content

Commit 44f2bf1

Browse files
docs: document the workflow_dispatch recovery path for releases
Adds a subsection to Releasing covering what to do when GitHub's release event doesn't fire automatically — a known flake mostly affecting tags created before the workflow existed. Manual dispatch via gh workflow run is the clean recovery; deleting and recreating the Release is mentioned as a fallback but discouraged. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent ef0c3c8 commit 44f2bf1

1 file changed

Lines changed: 27 additions & 0 deletions

File tree

README.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -317,6 +317,33 @@ After 1.0 the standard SemVer rules kick in (breaking → major, additive → mi
317317
claude-memsync version # confirms the upgrade landed
318318
```
319319

320+
### If the release workflow didn't fire
321+
322+
GitHub's `release: published` event is occasionally missed — usually
323+
when the Release was created from a pre-existing tag via API. The
324+
workflow listens for both `published` and `released` activity types as
325+
a defensive measure, but it can still happen. Two recovery paths:
326+
327+
- **Manual dispatch** (preferred): trigger the workflow against the
328+
existing tag without touching the Release.
329+
330+
```sh
331+
gh workflow run release.yml --field tag=v0.1.8
332+
gh run watch
333+
```
334+
335+
This re-uses the same build/upload steps and the existing Release
336+
picks up the assets.
337+
338+
- **Recreate the Release**: `gh release delete v0.1.8 --cleanup-tag=false`
339+
then recreate it. Sometimes nudges GitHub into firing the event
340+
properly. Manual dispatch is simpler — prefer it unless you also
341+
need to fix release notes.
342+
343+
The same `workflow_run` invocation works for retroactively building
344+
archives for any tag that doesn't yet have a Release, or for any
345+
Release whose previous build run failed.
346+
320347
### Building locally without a release
321348

322349
For dev iteration, a plain `go build -o bin/ ./cmd/...` is enough — the

0 commit comments

Comments
 (0)