130 lines
4.3 KiB
Bash
Executable File
130 lines
4.3 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
|
# shellcheck source=./release-lib.sh
|
|
. "$REPO_ROOT/scripts/release-lib.sh"
|
|
|
|
beta_version=""
|
|
out_file=""
|
|
repo_dir="$REPO_ROOT"
|
|
|
|
usage() {
|
|
cat <<'EOF'
|
|
Usage:
|
|
./scripts/draft-stable-notes.sh <beta-version> [--out PATH] [--repo-dir PATH]
|
|
|
|
Examples:
|
|
./scripts/draft-stable-notes.sh 2026.817.1-beta.0
|
|
./scripts/draft-stable-notes.sh 2026.817.1-beta.0 --out /tmp/draft.md
|
|
|
|
Notes:
|
|
- Generates a stable release-notes draft for the given published beta:
|
|
the commit range from the newest stable tag (v*) to the beta's source
|
|
commit, grouped by conventional-commit type.
|
|
- Written to releases/beta/v<beta-version>.md by default. The draft is
|
|
meant to be committed to master via PR and edited during the beta
|
|
soak; the stable promotion reads it from master.
|
|
- With no stable tag yet, the range falls back to the previous beta
|
|
tag, and failing that to the full history of the source commit.
|
|
EOF
|
|
}
|
|
|
|
while [ $# -gt 0 ]; do
|
|
case "$1" in
|
|
--out)
|
|
shift
|
|
[ $# -gt 0 ] || release_fail "--out requires a path."
|
|
out_file="$1"
|
|
;;
|
|
--repo-dir)
|
|
shift
|
|
[ $# -gt 0 ] || release_fail "--repo-dir requires a path."
|
|
repo_dir="$1"
|
|
;;
|
|
-h|--help)
|
|
usage
|
|
exit 0
|
|
;;
|
|
*)
|
|
if [ -n "$beta_version" ]; then
|
|
release_fail "only one beta version may be provided."
|
|
fi
|
|
beta_version="$1"
|
|
;;
|
|
esac
|
|
shift
|
|
done
|
|
|
|
if [ -z "$beta_version" ]; then
|
|
usage
|
|
exit 1
|
|
fi
|
|
|
|
if [[ ! "$beta_version" =~ ^[0-9]+\.[0-9]+\.[0-9]+-beta\.[0-9]+$ ]]; then
|
|
release_fail "beta version must look like 2026.318.1-beta.0, got: $beta_version"
|
|
fi
|
|
|
|
beta_tag="beta/v${beta_version}"
|
|
if ! git -C "$repo_dir" rev-parse --verify "refs/tags/${beta_tag}" >/dev/null 2>&1; then
|
|
release_fail "beta tag ${beta_tag} does not exist. Draft notes are generated from a published beta."
|
|
fi
|
|
source_sha="$(git -C "$repo_dir" rev-parse "${beta_tag}^{commit}")"
|
|
|
|
if [ -z "$out_file" ]; then
|
|
out_file="${repo_dir}/releases/beta/v${beta_version}.md"
|
|
fi
|
|
|
|
# Range start: the newest stable tag reachable from the source commit —
|
|
# not the newest by version, which can sit on a divergent lineage (a
|
|
# stable cut from a candidate branch, or a source that predates it) and
|
|
# would produce an empty or wrong range. Before the first reachable
|
|
# stable, fall back to the nearest beta tag strictly before the source;
|
|
# with no marker at all, cover the source commit's full history.
|
|
range_start="$(git -C "$repo_dir" describe --tags --match 'v[0-9]*' --abbrev=0 "$source_sha" 2>/dev/null || true)"
|
|
range_label="$range_start"
|
|
if [ -z "$range_start" ]; then
|
|
range_start="$(git -C "$repo_dir" describe --tags --match 'beta/v*' --abbrev=0 "${source_sha}^" 2>/dev/null || true)"
|
|
range_label="$range_start"
|
|
fi
|
|
if [ -n "$range_start" ]; then
|
|
range="${range_start}..${source_sha}"
|
|
else
|
|
range="$source_sha"
|
|
range_label="the beginning of history"
|
|
release_info "No stable or prior beta tag found; drafting from full history."
|
|
fi
|
|
|
|
subjects="$(git -C "$repo_dir" log --no-merges --format='%s' "$range")"
|
|
|
|
section() {
|
|
local title="$1" pattern="$2" invert="${3:-false}" body
|
|
if [ "$invert" = true ]; then
|
|
body="$(printf '%s\n' "$subjects" | grep -Ev "$pattern" || true)"
|
|
else
|
|
body="$(printf '%s\n' "$subjects" | grep -E "$pattern" || true)"
|
|
fi
|
|
[ -n "$body" ] || return 0
|
|
printf '## %s\n\n' "$title"
|
|
printf '%s\n' "$body" | sed 's/^/- /'
|
|
printf '\n'
|
|
}
|
|
|
|
conventional='^(feat|fix)(\([^)]*\))?!?: '
|
|
mkdir -p "$(dirname "$out_file")"
|
|
{
|
|
printf '# Paperclip stable draft — from beta %s\n\n' "$beta_version"
|
|
printf '> Auto-generated at beta publish from `git log %s..%s`.\n' "${range_label}" "${source_sha:0:9}"
|
|
printf '> Edit freely during the soak: rewrite for release-notes voice,\n'
|
|
printf '> fold noise, and call out anything a self-hoster must act on.\n'
|
|
printf '> The stable promotion reads this file from master and publishes\n'
|
|
printf '> it as the GitHub Release body under the stable version.\n\n'
|
|
section 'Features' '^feat(\([^)]*\))?!?: '
|
|
section 'Fixes' '^fix(\([^)]*\))?!?: '
|
|
section 'Other changes' "$conventional" true
|
|
} > "$out_file"
|
|
|
|
release_info "Draft stable notes written to $out_file"
|
|
release_info " Source beta: $beta_version ($source_sha)"
|
|
release_info " Range start: $range_label"
|