Compare commits
No commits in common. "main" and "build/273-resume-merge-door" have entirely different histories.
main
...
build/273-
5 changed files with 10 additions and 114 deletions
2
.github/labels.conf
vendored
2
.github/labels.conf
vendored
|
|
@ -1,4 +1,4 @@
|
||||||
panel=glm-bot-andresmgsl claude-bot-andresmgsl kimi-bot-andresmgsl
|
panel=codex-bot-andresmgsl glm-bot-andresmgsl claude-bot-andresmgsl kimi-bot-andresmgsl
|
||||||
triage-actors=claude-bot-andresmgsl
|
triage-actors=claude-bot-andresmgsl
|
||||||
scope:release-flow|C5DEF5|The reusable release workflow, decide, the doors
|
scope:release-flow|C5DEF5|The reusable release workflow, decide, the doors
|
||||||
scope:guards|C5DEF5|changelog-armed / changelog-monotonic / drill-recorded
|
scope:guards|C5DEF5|changelog-armed / changelog-monotonic / drill-recorded
|
||||||
|
|
|
||||||
|
|
@ -41,7 +41,7 @@ only ceremony-specific facts such as the roster and code conventions.
|
||||||
|
|
||||||
### Roster
|
### Roster
|
||||||
|
|
||||||
Three identities review and triage (org team `agents`), each living in its own
|
Four identities share the work (org team `agents`), each living in its own
|
||||||
[box](https://github.com/heavy-duty/box) — one box per credential, because
|
[box](https://github.com/heavy-duty/box) — one box per credential, because
|
||||||
the box is the blast-radius boundary; roles are what a session is told, and
|
the box is the blast-radius boundary; roles are what a session is told, and
|
||||||
[AGENTS.md](AGENTS.md) routes from there:
|
[AGENTS.md](AGENTS.md) routes from there:
|
||||||
|
|
@ -49,16 +49,17 @@ the box is the blast-radius boundary; roles are what a session is told, and
|
||||||
| identity | box (rig tenant) | standing work |
|
| identity | box (rig tenant) | standing work |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `claude-bot-andresmgsl` | `triage` (claude-box) | **triage** — the only door work issues come through; this identity mints work issues and nothing else writes them (#18's `triage-actors`) — and review. It does not build. |
|
| `claude-bot-andresmgsl` | `triage` (claude-box) | **triage** — the only door work issues come through; this identity mints work issues and nothing else writes them (#18's `triage-actors`) — and review. It does not build. |
|
||||||
|
| `codex-bot-andresmgsl` | codex-box | build + review |
|
||||||
| `glm-bot-andresmgsl` | glm-box | review |
|
| `glm-bot-andresmgsl` | glm-box | review |
|
||||||
| `kimi-bot-andresmgsl` | kimi-box | review |
|
| `kimi-bot-andresmgsl` | kimi-box | review |
|
||||||
|
|
||||||
**The review panel for any PR is every bench identity except its author** —
|
**The review panel for any PR is every bench identity except its author** —
|
||||||
recusal by construction, enforced by the reconciler (#10): the required
|
recusal by construction, enforced by the reconciler (#10): the required
|
||||||
verdicts are the panel minus the PR's author. Builders are not on the
|
verdicts are the panel minus the PR's author. On this roster that resolves
|
||||||
panel, so for every PR a builder writes that resolves to **three**
|
to **three** cross-vendor approvals of the current head, because the only
|
||||||
cross-vendor approvals of the current head; only a PR authored by a panel
|
builder is itself on the panel and recuses from its own PRs; the rule is
|
||||||
identity drops to two. The rule is panel-minus-author, and three is what it
|
panel-minus-author, and three is what it currently comes to, not a second
|
||||||
currently comes to, not a second rule. Builders and triage default to different models so the issue contract
|
rule. Builders and triage default to different models so the issue contract
|
||||||
is honestly exercised — a spec gap should surface as a question on the
|
is honestly exercised — a spec gap should surface as a question on the
|
||||||
issue, not be silently filled by shared priors. Humans (`andres`) decide in
|
issue, not be silently filled by shared priors. Humans (`andres`) decide in
|
||||||
proposals and merge; the roster is config, not doctrine — swapping a
|
proposals and merge; the roster is config, not doctrine — swapping a
|
||||||
|
|
@ -80,18 +81,6 @@ ceremony's scopes are defined in [`.github/labels.conf`](.github/labels.conf)
|
||||||
[`.github/labeler.yml`](.github/labeler.yml). The conf is the set; no prose
|
[`.github/labeler.yml`](.github/labeler.yml). The conf is the set; no prose
|
||||||
table repeats it (#104).
|
table repeats it (#104).
|
||||||
|
|
||||||
### Builders
|
|
||||||
|
|
||||||
Builders write code and **do not review**, so they are deliberately absent
|
|
||||||
from the roster above and from `panel=` (operator decision, 2026-09-30).
|
|
||||||
Listing a builder on the panel makes every PR it did not author wait on a
|
|
||||||
verdict it will never give: the reconciler reads it as missing and lands
|
|
||||||
`state:addressing` + `blocker:unrequested` on PRs every real reviewer has
|
|
||||||
approved.
|
|
||||||
|
|
||||||
- `codex-bot-andresmgsl` — codex-box
|
|
||||||
- `codex-bot-2-andresmgsl` — codex-2 box
|
|
||||||
|
|
||||||
## Code conventions
|
## Code conventions
|
||||||
|
|
||||||
- Bash: `set -euo pipefail` in executables, `set -u` in test files (the test
|
- Bash: `set -euo pipefail` in executables, `set -u` in test files (the test
|
||||||
|
|
|
||||||
|
|
@ -270,8 +270,7 @@ set_required_bots() { # the PR author is recused by construction
|
||||||
# The state machine. Pure functions over these globals, set per PR:
|
# The state machine. Pure functions over these globals, set per PR:
|
||||||
# DRAFT true|false
|
# DRAFT true|false
|
||||||
# HEAD_SHA the PR's current head commit
|
# HEAD_SHA the PR's current head commit
|
||||||
# BASE_SHA the PR's base branch head
|
# BASE_SHA the PR's base branch head (the release-shape guard's ref)
|
||||||
# MERGE_BASE_SHA the PR's merge base (the release-shape guard's ref)
|
|
||||||
# REQUESTED newline-separated logins with a review currently requested
|
# REQUESTED newline-separated logins with a review currently requested
|
||||||
# REVIEWS_JSON JSON array of submitted, gradeable reviews
|
# REVIEWS_JSON JSON array of submitted, gradeable reviews
|
||||||
# MERGEABLE MERGEABLE | CONFLICTING | UNKNOWN (GitHub's own verdict)
|
# MERGEABLE MERGEABLE | CONFLICTING | UNKNOWN (GitHub's own verdict)
|
||||||
|
|
@ -919,8 +918,7 @@ reconcile_pr() { # $1 = PR number; relies on the globals set from its fetch
|
||||||
# Drafts are exempt (the build phase is the builder's); the version
|
# Drafts are exempt (the build phase is the builder's); the version
|
||||||
# reads cost two API calls and only on PRs missing the label.
|
# reads cost two API calls and only on PRs missing the label.
|
||||||
if [ "$DRAFT" != true ] && ! has_label release; then
|
if [ "$DRAFT" != true ] && ! has_label release; then
|
||||||
release_shape_warning "$n" "$(tree_version "$HEAD_SHA")" \
|
release_shape_warning "$n" "$(tree_version "$HEAD_SHA")" "$(tree_version "$BASE_SHA")"
|
||||||
"$(tree_version "${MERGE_BASE_SHA:-$BASE_SHA}")"
|
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# ---- merge-next: cleared, never set ----------------------------------
|
# ---- merge-next: cleared, never set ----------------------------------
|
||||||
|
|
@ -1033,7 +1031,6 @@ main() {
|
||||||
set_required_bots "$AUTHOR"
|
set_required_bots "$AUTHOR"
|
||||||
HEAD_SHA="$(jq -r '.head.sha' <<<"$PR_JSON")"
|
HEAD_SHA="$(jq -r '.head.sha' <<<"$PR_JSON")"
|
||||||
BASE_SHA="$(jq -r '.base.sha' <<<"$PR_JSON")"
|
BASE_SHA="$(jq -r '.base.sha' <<<"$PR_JSON")"
|
||||||
MERGE_BASE_SHA="$(jq -r '.merge_base // empty' <<<"$PR_JSON")"
|
|
||||||
LABELS="$(jq -r '.labels[].name' <<<"$PR_JSON")"
|
LABELS="$(jq -r '.labels[].name' <<<"$PR_JSON")"
|
||||||
# This allow-list answers whether a row is a submitted, gradeable review;
|
# This allow-list answers whether a row is a submitted, gradeable review;
|
||||||
# bot_verdict separately answers what that submitted verdict says (#235).
|
# bot_verdict separately answers what that submitted verdict says (#235).
|
||||||
|
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
### Fixed
|
|
||||||
|
|
||||||
- Compare release-shaped pull requests with their merge base so later base-branch releases do not create phantom version-change warnings (#275).
|
|
||||||
|
|
@ -175,93 +175,6 @@ expect "an unreadable head version is silent — never nag on a guess" "" \
|
||||||
expect "a bare head over an unreadable base still warns" yes \
|
expect "a bare head over an unreadable base still warns" yes \
|
||||||
"$(release_shape_warning 41 2.0.0 "" | grep -qF '::warning::' && echo yes || echo no)"
|
"$(release_shape_warning 41 2.0.0 "" | grep -qF '::warning::' && echo yes || echo no)"
|
||||||
|
|
||||||
# The pure matrix above proves the warning predicate. These two fixtures drive
|
|
||||||
# the sweep boundary that chooses WHICH base tree feeds it (#275): the
|
|
||||||
# reporting Forgejo payload exposes the PR's moving base tip beside its fixed
|
|
||||||
# merge base, and using the former manufactures a downgrade after an
|
|
||||||
# intervening release. A missing merge-base field deliberately keeps the
|
|
||||||
# specified base-tip fallback for backends that do not supply that fact.
|
|
||||||
release_shape_ref_probe() { # $1 = phantom | bump | fallback
|
|
||||||
(
|
|
||||||
# shellcheck disable=SC2030 # this probe intentionally isolates its repository fixture
|
|
||||||
REPO=owner/repo
|
|
||||||
LABELS_CONF="$FIXTURE_CONF"
|
|
||||||
CEREMONY_FORGE=github
|
|
||||||
mode="$1"
|
|
||||||
refs="$RTMP/release-shape-$mode-refs"
|
|
||||||
: >"$refs"
|
|
||||||
case "$mode" in
|
|
||||||
phantom)
|
|
||||||
head_ver=1.3.0 base_tip_ver=1.4.0 merge_base_ver=1.3.0
|
|
||||||
merge_base_json='"merge-base"' ;;
|
|
||||||
bump)
|
|
||||||
head_ver=1.4.0 base_tip_ver=1.3.0 merge_base_ver=1.3.0
|
|
||||||
merge_base_json='"merge-base"' ;;
|
|
||||||
fallback)
|
|
||||||
head_ver=1.4.0 base_tip_ver=1.4.0 merge_base_ver=unused
|
|
||||||
merge_base_json=null ;;
|
|
||||||
*) return 2 ;;
|
|
||||||
esac
|
|
||||||
# shellcheck disable=SC2317 # reached through the GitHub backend selected above
|
|
||||||
gh() {
|
|
||||||
if [ "$1" = label ] && [ "$2" = list ]; then
|
|
||||||
core_label_rows | cut -d'|' -f1
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
if [ "$1" = pr ] && [ "$2" = list ]; then
|
|
||||||
printf '701\n'
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
if [ "$1" = pr ] && [ "$2" = view ]; then
|
|
||||||
jq -n '{mergeable:"MERGEABLE",statusCheckRollup:[]}'
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
if [ "$1" = issue ] && [ "$2" = edit ]; then return 0; fi
|
|
||||||
case "$(forge_stub_path "$*")" in
|
|
||||||
*'repos/owner/repo/pulls/701 --jq .requested_reviewers'*) return 0 ;;
|
|
||||||
*repos/owner/repo/pulls/701/reviews*) return 0 ;;
|
|
||||||
*repos/owner/repo/pulls/701)
|
|
||||||
jq -n --argjson merge_base "$merge_base_json" \
|
|
||||||
'{draft:false,user:{login:"fixture-builder"},
|
|
||||||
head:{sha:"head"},base:{sha:"base-tip"},merge_base:$merge_base,
|
|
||||||
labels:[{name:"state:addressing"},{name:"blocked"}],
|
|
||||||
requested_reviewers:[],created_at:"2026-08-31T20:00:00Z"}' ;;
|
|
||||||
*repos/owner/repo/commits/head*) printf '2026-08-31T20:00:00Z\n' ;;
|
|
||||||
*repos/owner/repo/contents/VERSION\?ref=head*)
|
|
||||||
printf 'head\n' >>"$refs"
|
|
||||||
printf '%s' "$head_ver" | base64 ;;
|
|
||||||
*repos/owner/repo/contents/VERSION\?ref=base-tip*)
|
|
||||||
printf 'base-tip\n' >>"$refs"
|
|
||||||
printf '%s' "$base_tip_ver" | base64 ;;
|
|
||||||
*repos/owner/repo/contents/VERSION\?ref=merge-base*)
|
|
||||||
printf 'merge-base\n' >>"$refs"
|
|
||||||
printf '%s' "$merge_base_ver" | base64 ;;
|
|
||||||
*) printf '[]\n' ;;
|
|
||||||
esac
|
|
||||||
}
|
|
||||||
main
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
phantom_shape="$(release_shape_ref_probe phantom)"
|
|
||||||
expect "an unchanged branch cut before a later base release emits no release-shape warning" \
|
|
||||||
no "$(grep -q 'release-shaped' <<<"$phantom_shape" && echo yes || echo no)"
|
|
||||||
expect "the unchanged-branch guard compares head with the PR merge base" \
|
|
||||||
$'head\nmerge-base' "$(cat "$RTMP/release-shape-phantom-refs")"
|
|
||||||
|
|
||||||
bump_shape="$(release_shape_ref_probe bump)"
|
|
||||||
expect "a genuine version bump relative to the merge base keeps the warning text" \
|
|
||||||
yes "$(grep -qF '#701 is release-shaped (version 1.3.0 -> 1.4.0 at its head)' \
|
|
||||||
<<<"$bump_shape" && echo yes || echo no)"
|
|
||||||
expect "the genuine-bump guard also compares head with the PR merge base" \
|
|
||||||
$'head\nmerge-base' "$(cat "$RTMP/release-shape-bump-refs")"
|
|
||||||
|
|
||||||
fallback_shape="$(release_shape_ref_probe fallback)"
|
|
||||||
expect "a null merge base falls back to the base tip without guessing a warning" \
|
|
||||||
no "$(grep -q 'release-shaped' <<<"$fallback_shape" && echo yes || echo no)"
|
|
||||||
expect "the null merge-base fallback compares head with the base tip" \
|
|
||||||
$'head\nbase-tip' "$(cat "$RTMP/release-shape-fallback-refs")"
|
|
||||||
|
|
||||||
# -- drafts are building, whoever is requested --------------------------------
|
# -- drafts are building, whoever is requested --------------------------------
|
||||||
DRAFT=true HEAD_SHA=head1 REQUESTED="" REVIEWS_JSON='[]'
|
DRAFT=true HEAD_SHA=head1 REQUESTED="" REVIEWS_JSON='[]'
|
||||||
expect "draft PR is building" state:building "$(decide_state)"
|
expect "draft PR is building" state:building "$(decide_state)"
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue