Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
name: Release

# Every run on `main` (each push, a daily schedule, or a manual run) compares
# `main` with the latest published release, and cuts the next one when that
# range changes what ships. It builds and checks every binary first, then
# uploads them to a draft release and publishes it, which creates the tag, so
# no tag exists without its complete release. A failed or cancelled run needs
# no recovery: the next run sees the same unreleased range and replaces any
# draft it left. Pull requests that change what ships, and manual runs on other
# branches, only build and check. scripts/release-plan.sh holds both decisions.
# A run on `main` (the daily schedule, or a manual one) compares `main` with
# the latest published release, and cuts the next one when that range changes
# what ships, so a day's merges become one release and an urgent fix ships
# early with `gh workflow run release.yml --ref main`. A push to `main` cuts
# nothing. A run builds and checks every binary first, then uploads them to a
# draft release and publishes it, which creates the tag, so no tag exists
# without its complete release. A failed or cancelled run needs no recovery:
# the next run sees the same unreleased range and replaces any draft it left.
# Pull requests that change what ships, and manual runs on other branches, only
# build and check. scripts/release-plan.sh holds both decisions.
on:
push:
branches: [main]
pull_request:
schedule:
- cron: "17 6 * * *"
Expand Down
16 changes: 9 additions & 7 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,13 +51,15 @@ The package stays `private`; GitHub releases will ship the `quest` binary.

## Releases

The Release workflow cuts every release; no person or agent tags one. Each
push to `main`, a daily schedule, and a manual run on `main` compare `main`
with the latest published release, and cut the next one when that range
changes what ships, as `scripts/release-plan.sh` decides: everything the
binaries and the flake package build from, every file Release publishes, and
the workflows that build and check them. Its pull request runs use the same
predicate to decide whether to build. The next version is greater than every
The Release workflow cuts every release; no person or agent tags one. A daily
schedule (06:17 UTC) and a manual run on `main` compare `main` with the latest
published release, and cut the next one when that range changes what ships, so
a day's merges become one release and a day with none cuts nothing. A push to
`main` cuts no release; an urgent fix ships early once it merges, with
`gh workflow run release.yml --ref main`. `scripts/release-plan.sh` judges the
range: everything the binaries and the flake package build from, every file
Release publishes, and the workflows that build and check them. Its pull
request runs use the same predicate to decide whether to build. The next version is greater than every
`vX.Y.Z` tag: a minor bump (a major one from 1.0) when a commit subject in the
range has `!` before its colon, a patch bump otherwise.

Expand Down
4 changes: 2 additions & 2 deletions SETUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ line in its root instructions.
## Install and pin

Pin the latest [release](https://github.com/moq-dev/quest/releases) tag.
Every merge that changes what Quest ships becomes a release, so a release tag
is never far behind `main`; prefer it to pinning a commit.
A day's merges that change what Quest ships become one release, cut daily, so a
release tag is at most about a day behind `main`; prefer it to pinning a commit.
Releases ship binaries for macOS, Linux, and native Windows on arm64 and x64.
Never pin v0.1.0: it has no Windows archives and no `quest worktree hook`
command, which `quest init`'s Claude Code hooks call. Every later release has
Expand Down
53 changes: 0 additions & 53 deletions quest/m0/daily-release.md

This file was deleted.

Loading