You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
scripts/seed-repo-template.sh's WORKFLOW_MANIFEST hardcodes the auto-rebase caller stub it seeds into new repos as pinned to the legacy, orphaned auto-rebase/stable tag (verified at commit 1a186e9c…, older than every currently-deployed v2-* channel at 837cee9d…). scripts/cut-release.sh never moves that tag — only <agent>/v<MAJOR>-<tier> refs — so it will never catch up on its own. Update the manifest entry to pin the current major-scoped stable channel (auto-rebase/v2-stable, or whatever is current when this ships) instead.
Separately, AGENTS.md's description of this repo's own auto-rebase.yml pin (@auto-rebase/stable) doesn't match the actual file (auto-rebase/v2-next). Correct the doc to describe the actual pin.
See #1416 § "6. Channel-pin drift" for full detail.
Thanks for the detailed write-up and for tracing this all the way back to the commit where the drift was introduced — that context makes the fix much easier to reason about. To make sure the WORKFLOW_MANIFEST patch lands on the right value: can you confirm which channel ref should be the authoritative replacement for auto-rebase/stable at the time this ships — is auto-rebase/v2-stable already live and the intended target, or should the manifest point to auto-rebase/v2-next to stay consistent with what auto-rebase.yml currently uses in this repo?
Correct AGENTS.md's stale description of this repo's auto-rebase.yml pin; the seed-template manifest half of this issue was already resolved by #1436.
Findings / Scope narrowing
Part 1 — scripts/seed-repo-template.shWORKFLOW_MANIFEST orphaned pin: Already fixed by [bug] seed-repo-template.sh repins caller stubs to pre-#1184 legacy channels — template-drift enforces a baseline that contradicts standards #1436 (commit d14a702). The manifest no longer hardcodes a channel per stub; the row is now auto-rebase|caller|petry-projects/.github and the channel is derived from the canonical stub's own major-scoped uses: ref via _derive_stable_channel, yielding auto-rebase/v2-stable. The existing test tests/test_seed_repo_template.bats (repin case) already asserts the repin outputs @auto-rebase/v2-stable and never the legacy @auto-rebase/stable. No source change required here.
Part 2 — AGENTS.md doc drift:AGENTS.md line 34 states auto-rebase.yml pins @auto-rebase/stable, but the actual file (.github/workflows/auto-rebase.yml) pins @auto-rebase/v2-next (enforced by tests/dev-lead/integration/test_auto_rebase_stub.py, EXPECTED_REF = "@auto-rebase/v2-next"). This is the remaining fix.
Implementation Checklist
AGENTS.md: correct the auto-rebase pin reference @auto-rebase/stable → @auto-rebase/v2-next, and fix the now-inaccurate "matching the canonical org stub" clause (this repo dogfoods the v2-next channel ahead of the canonical @auto-rebase/next stub, per the enforcing test's docstring).
Tests to Write
None. This is a pure documentation correction (Phase 2 TDD exception). The behavioral pin is already guarded by test_auto_rebase_stub.py (actual file) and test_seed_repo_template.bats (seed manifest); both pass on the current baseline.
Part 2 (AGENTS.md doc drift): Corrected AGENTS.md — the auto-rebase pin reference now reads @auto-rebase/v2-next (the actual file pin) and the previously-inaccurate "matching the canonical org stub" clause now correctly describes this repo dogfooding the v2-next channel ahead of the canonical @auto-rebase/next stub.
AGENTS.md: fixed the stale auto-rebase pin description (@auto-rebase/stable → @auto-rebase/v2-next) and corrected the "matching the canonical org stub" framing to reflect this repo riding the v2-next dogfood channel ahead of the canonical @auto-rebase/next stub.
Notes
TDD Phase 2 exception: This is a pure documentation correction with no observable behavioral change, so no new failing test was written. The behavioral pin remains guarded by test_auto_rebase_stub.py (actual workflow file, EXPECTED_REF = @auto-rebase/v2-next) and the seed-manifest repin case in test_seed_repo_template.bats.
bats unavailable in this environment (not installed; run-bats.sh does not vendor it), so the .bats suites could not be executed here. This is a non-issue for this change: no shell script was modified and no bats test asserts on AGENTS.md content. The Python enforcing test and the required dev-lead-lint.sh both pass.
Out-of-scope observation (not changed):.github/workflows/auto-rebase.yml's header comment (line 10) still says auto-rebase/v2-stable while its uses: ref is @auto-rebase/v2-next — a separate intra-file comment drift the issue does not cover. Modifying the thin caller stub is outside this issue's scope; flagging it as a possible follow-up.
Activity
github-actions commentedon Aug 2, 2026
Thanks for the detailed write-up and for tracing this all the way back to the commit where the drift was introduced — that context makes the fix much easier to reason about. To make sure the
WORKFLOW_MANIFESTpatch lands on the right value: can you confirm which channel ref should be the authoritative replacement forauto-rebase/stableat the time this ships — isauto-rebase/v2-stablealready live and the intended target, or should the manifest point toauto-rebase/v2-nextto stay consistent with whatauto-rebase.ymlcurrently uses in this repo?don-petry commentedon Aug 2, 2026
Dev-Lead Implementation Plan
Issue: #1439 — auto-rebase: fix repo-template's orphaned channel pin + AGENTS.md doc drift (AC6)
Scope
Correct
AGENTS.md's stale description of this repo'sauto-rebase.ymlpin; the seed-template manifest half of this issue was already resolved by #1436.Findings / Scope narrowing
scripts/seed-repo-template.shWORKFLOW_MANIFESTorphaned pin: Already fixed by [bug] seed-repo-template.sh repins caller stubs to pre-#1184 legacy channels — template-drift enforces a baseline that contradicts standards #1436 (commitd14a702). The manifest no longer hardcodes a channel per stub; the row is nowauto-rebase|caller|petry-projects/.githuband the channel is derived from the canonical stub's own major-scopeduses:ref via_derive_stable_channel, yieldingauto-rebase/v2-stable. The existing testtests/test_seed_repo_template.bats(repin case) already asserts the repin outputs@auto-rebase/v2-stableand never the legacy@auto-rebase/stable. No source change required here.AGENTS.mddoc drift:AGENTS.mdline 34 statesauto-rebase.ymlpins@auto-rebase/stable, but the actual file (.github/workflows/auto-rebase.yml) pins@auto-rebase/v2-next(enforced bytests/dev-lead/integration/test_auto_rebase_stub.py,EXPECTED_REF = "@auto-rebase/v2-next"). This is the remaining fix.Implementation Checklist
AGENTS.md: correct the auto-rebase pin reference@auto-rebase/stable→@auto-rebase/v2-next, and fix the now-inaccurate "matching the canonical org stub" clause (this repo dogfoods thev2-nextchannel ahead of the canonical@auto-rebase/nextstub, per the enforcing test's docstring).Tests to Write
test_auto_rebase_stub.py(actual file) andtest_seed_repo_template.bats(seed manifest); both pass on the current baseline.Test Command
python3 tests/dev-lead/integration/test_auto_rebase_stub.py+bash .dev-lead/scripts/dev-lead-lint.shdon-petry commentedon Aug 2, 2026
Dev-Lead: Implementation Complete
Plan Execution
d14a702) — no source change needed.WORKFLOW_MANIFESTno longer hardcodes a channel;auto-rebase|caller|petry-projects/.githubderivesauto-rebase/v2-stablevia_derive_stable_channel, andtests/test_seed_repo_template.batsalready asserts the repin emits@auto-rebase/v2-stableand never the legacy@auto-rebase/stable.AGENTS.md— the auto-rebase pin reference now reads@auto-rebase/v2-next(the actual file pin) and the previously-inaccurate "matching the canonical org stub" clause now correctly describes this repo dogfooding thev2-nextchannel ahead of the canonical@auto-rebase/nextstub.Test Results
Files Changed
AGENTS.md: fixed the stale auto-rebase pin description (@auto-rebase/stable→@auto-rebase/v2-next) and corrected the "matching the canonical org stub" framing to reflect this repo riding thev2-nextdogfood channel ahead of the canonical@auto-rebase/nextstub.Notes
test_auto_rebase_stub.py(actual workflow file,EXPECTED_REF = @auto-rebase/v2-next) and the seed-manifest repin case intest_seed_repo_template.bats.batsunavailable in this environment (not installed;run-bats.shdoes not vendor it), so the.batssuites could not be executed here. This is a non-issue for this change: no shell script was modified and no bats test asserts onAGENTS.mdcontent. The Python enforcing test and the requireddev-lead-lint.shboth pass..github/workflows/auto-rebase.yml's header comment (line 10) still saysauto-rebase/v2-stablewhile itsuses:ref is@auto-rebase/v2-next— a separate intra-file comment drift the issue does not cover. Modifying the thin caller stub is outside this issue's scope; flagging it as a possible follow-up.fix(agents): correct canonical auto-rebase stub channel in AGENTS.md
feat: implement issue #1439 — auto-rebase: fix repo-template's orphan…