docs: reconcile release model to gated single-branch publish (delete PUBLISH_ON_MERGE) - #275
Conversation
A human PR merge never auto-publishes: a release is a workflow_dispatch, a code-affecting bot push to main (gated to the codegen App / Dependabot actor by the plan job), or the Docker weekly schedule. Rewrite AGENTS.md (lines 13/29/52) and WORKFLOW.md (§105, D4.1, D8.3, S5/S6/S7/S11) to this model, reference publish-plan-task, delete every PUBLISH_ON_MERGE mention (implemented in zero repos), and clear the stale "branch matrix" language (the publisher builds the single trigger branch, per WORKFLOW.md §105). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Updates the repo's governance documentation to describe a gated, single-branch publish model (human merges do not auto-publish) and removes/updates legacy language tied to the prior release model.
Changes:
- Rewrites the documented release/publish triggers to a gated model (dispatch + bot push to
main+ scheduled Docker refresh). - Removes
PUBLISH_ON_MERGEreferences and updates surrounding rationale to match the new model. - Updates upstream-version tracker and trace-scenario wording to align with the new gating rules.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.
| File | Description |
|---|---|
| AGENTS.md | Updates foundational and release-model governance text to the new gated publish model; removes legacy PUBLISH_ON_MERGE language. |
| WORKFLOW.md | Updates the release-model contract and scenarios to the gated single-branch publish model and references a planned single-source publish decision. |
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
The publisher builds one branch per run (the trigger ref), not both main and develop; the branch input is still required so a fallback can't mislabel the build. Matches the reconciled single-branch release model in this PR. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Reconciles the governance docs to the release model agreed with the maintainer, and clears two pre-existing inconsistencies.
Model (now documented)
A human PR merge never auto-publishes. A release is:
workflow_dispatchof main/develop (human-initiated), ormain— the codegen App merges every Dependabot/codegen PR, sogithub.actoris the gate; a human merge/promotion to main skips, and an Actions-only bump is dropped by the paths filter, orschedule(Docker only, base-image refresh).The decision is single-sourced in the
planjob; every publish job gates on its output.Changes
PUBLISH_ON_MERGEreference (it was implemented in zero repos — pure removal).publish-plan-task.publish-release.yml, which all build one branch.)markdownlint +
spec/validate.pyclean; CRLF preserved. Codifies the rollout PRs (LanguageTags #255, Utilities #388, aiopurpleair #26, NxWitness #494, MediaTools #8, ESPHome-NonRoot #138) + the snippet #274.🤖 Generated with Claude Code