fix(release): idempotent changelog promote (no duplicate version headers) #217

Merged
jmiller merged 1 commits from fix/changelog-promote-idempotent into main 2026-07-05 22:28:20 +00:00
Owner

Local stopgap for the changelog-promote bug (the template fix is tracked separately in Template-Generic).

auto-release.yml promoted [Unreleased][version] by unconditionally inserting a ## [version] header on every build. Repeated builds / same-version runs therefore appended the header again, producing the empty, duplicated version headers (e.g. two ## [02.56.07], two ## [02.56.08]) and the blank releases.

Fix: only insert the header when ## [version] isn't already in the file (idempotent). YAML validated.

⚠️ .mokogitea/workflows/auto-release.yml is synced from the template, so this local fix will be overwritten on the next workflow sync — the durable fix is in the template (Template-Generic issue filed).

https://claude.ai/code/session_01WbGBN9VyRK61zczYWcCQ2i

Local stopgap for the changelog-promote bug (the template fix is tracked separately in Template-Generic). `auto-release.yml` promoted `[Unreleased]` → `[version]` by unconditionally inserting a `## [version]` header on **every** build. Repeated builds / same-version runs therefore appended the header again, producing the **empty, duplicated version headers** (e.g. two `## [02.56.07]`, two `## [02.56.08]`) and the blank releases. Fix: only insert the header when `## [version]` isn't already in the file (idempotent). YAML validated. ⚠️ `.mokogitea/workflows/auto-release.yml` is synced from the template, so this local fix will be overwritten on the next workflow sync — the durable fix is in the template (Template-Generic issue filed). https://claude.ai/code/session_01WbGBN9VyRK61zczYWcCQ2i
jmiller added 1 commit 2026-07-05 22:28:11 +00:00
fix(release): idempotent changelog promote + dedupe 02.56.11 header
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Universal: PR Check / Wiki Update Reminder (pull_request) Successful in 2s
Joomla: Extension CI / Release Readiness Check (pull_request) Failing after 4s
Universal: PR Check / Require Docs Update (pull_request) Failing after 5s
Generic: Project CI / Lint & Validate (pull_request) Successful in 11s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Generic: Repo Health / Access control (pull_request) Successful in 2s
RC Revert / Rename rc/ back to dev/ (pull_request) Has been skipped
Universal: PR Check / Secret Scan (pull_request) Successful in 9s
Branch Cleanup / Delete merged branch (pull_request) Successful in 2s
Universal: Workflow Sync Trigger / Sync workflows to live repos (pull_request) Has been skipped
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Successful in 35s
Joomla: Extension CI / Lint & Validate (pull_request) Failing after 1m13s
Universal: PR Check / Validate PR (pull_request) Failing after 1m11s
Joomla: Metadata Validation / Validate Joomla Metadata (pull_request) Successful in 1m22s
Generic: Project CI / Tests (pull_request) Has been cancelled
Joomla: Extension CI / Tests (PHP 8.2) (pull_request) Has been cancelled
Joomla: Extension CI / Tests (PHP 8.3) (pull_request) Has been cancelled
Joomla: Extension CI / PHPStan Analysis (pull_request) Has been cancelled
Joomla: Extension CI / Build RC Pre-Release (pull_request) Has been cancelled
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Universal: PR Check / Report Issues (pull_request) Has been cancelled
Generic: Repo Health / Scripts governance (pull_request) Has been cancelled
Generic: Repo Health / Repository health (pull_request) Has been cancelled
Generic: Repo Health / Report: Scripts Governance (pull_request) Has been cancelled
Generic: Repo Health / Report: Repository Health (pull_request) Has been cancelled
129be7ef9d
Guard the promote so it only inserts a version header when absent (stops the
empty duplicate headers each build was appending), and remove the duplicate
02.56.11 header the non-idempotent promote just created.

Claude-Session: https://claude.ai/code/session_01WbGBN9VyRK61zczYWcCQ2i
jmiller force-pushed fix/changelog-promote-idempotent from 0c0a1334e0 to 129be7ef9d 2026-07-05 22:28:11 +00:00 Compare
Author
Owner

Wiki reminder: docs are wiki-first -- if this PR changes behavior, usage, config, or standards, please update the repo wiki before/after merge. (non-blocking)

<!-- wiki-reminder --> **Wiki reminder:** docs are wiki-first -- if this PR changes behavior, usage, config, or standards, please update the repo wiki before/after merge. _(non-blocking)_
jmiller merged commit 7f5f041588 into main 2026-07-05 22:28:20 +00:00
jmiller deleted branch fix/changelog-promote-idempotent 2026-07-05 22:28:21 +00:00
Sign in to join this conversation.