MokoConsulting/Template-Joomla
Template
1
0
Fork 0
Code Issues Pull Requests 1 Releases 3 Wiki Activity

fix(ci): make changelog promotion idempotent and structure-preserving #68

Merged
jmiller merged 1 commits from fix/changelog-promote-structure into dev 2026-07-18 21:45:49 +00:00
Conversation 0 Commits 1 Files Changed 1
+27 -6
jmiller commented 2026-07-18 20:58:02 +00:00
Owner
Copy Link
Copy Source

Fixes the auto-release Update release notes and promote changelog step, whose blind content.replace('## [Unreleased]', ...) injected an empty version header, pushed the intro below the section headers, and compounded on re-runs (observed on MokoSuiteStoreLocator: intro below two [01.04.00] headers).

The step now parses the changelog into a top header block plus ## [ sections and promotes only when [Unreleased] has real content (a ### subheading or a bullet), moving that content under a new version header and leaving [Unreleased] empty. Re-runs and empty [Unreleased] leave the file byte-identical (EOL-preserving), so CI produces no spurious commit. Validated against three cases: content->promote, re-run->no-op, empty->no-op.

Template-level fix (sync-overwrites consuming repos). Other Joomla repos likely have the same CHANGELOG corruption and may need a one-time cleanup.

Authored-by: Moko Consulting

Fixes the auto-release `Update release notes and promote changelog` step, whose blind `content.replace('## [Unreleased]', ...)` injected an empty version header, pushed the intro below the section headers, and compounded on re-runs (observed on MokoSuiteStoreLocator: intro below two `[01.04.00]` headers). The step now parses the changelog into a top header block plus `## [` sections and promotes only when `[Unreleased]` has real content (a `###` subheading or a bullet), moving that content under a new version header and leaving `[Unreleased]` empty. Re-runs and empty `[Unreleased]` leave the file byte-identical (EOL-preserving), so CI produces no spurious commit. Validated against three cases: content->promote, re-run->no-op, empty->no-op. Template-level fix (sync-overwrites consuming repos). Other Joomla repos likely have the same CHANGELOG corruption and may need a one-time cleanup. Authored-by: Moko Consulting
jmiller changed target branch from main to dev 2026-07-18 21:45:42 +00:00
jmiller added 1 commit 2026-07-18 21:45:42 +00:00
fix(ci): make changelog promotion idempotent and structure-preserving
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Has been skipped
Details
Generic: Project CI / Lint & Validate (pull_request) Has been skipped
Details
Joomla: Metadata Validation / Validate Joomla Metadata (pull_request) Has been skipped
Details
Generic: Repo Health / Site Health (pull_request) Has been skipped
Details
Generic: Repo Health / Access control (pull_request) Successful in 2s
Details
Generic: Standards Compliance / Secret Scanning (pull_request) Successful in 6s
Details
Generic: Standards Compliance / License Header Validation (pull_request) Successful in 5s
Details
Generic: Standards Compliance / Repository Structure Validation (pull_request) Successful in 6s
Details
Generic: Standards Compliance / Coding Standards Check (pull_request) Successful in 7s
Details
Generic: Standards Compliance / Workflow Configuration Check (pull_request) Failing after 6s
Details
Generic: Standards Compliance / Documentation Quality Check (pull_request) Successful in 5s
Details
Generic: Standards Compliance / README Completeness Check (pull_request) Failing after 5s
Details
Generic: Standards Compliance / Git Repository Hygiene (pull_request) Successful in 6s
Details
Generic: Standards Compliance / Script Integrity Validation (pull_request) Successful in 9s
Details
Generic: Standards Compliance / Line Length Check (pull_request) Successful in 5s
Details
Generic: Standards Compliance / File Naming Standards (pull_request) Successful in 4s
Details
Generic: Standards Compliance / Insecure Code Pattern Detection (pull_request) Successful in 3s
Details
Generic: Standards Compliance / Version Consistency Check (pull_request) Successful in 1m0s
Details
Generic: Standards Compliance / Dead Code Detection (pull_request) Successful in 8s
Details
Generic: Standards Compliance / File Size Limits (pull_request) Successful in 6s
Details
Generic: Standards Compliance / Binary File Detection (pull_request) Successful in 7s
Details
Generic: Standards Compliance / TODO/FIXME Tracking (pull_request) Successful in 3s
Details
Generic: Standards Compliance / Code Complexity Analysis (pull_request) Successful in 1m4s
Details
Generic: Standards Compliance / Code Duplication Detection (pull_request) Successful in 1m3s
Details
Generic: Standards Compliance / Broken Link Detection (pull_request) Successful in 4s
Details
Generic: Standards Compliance / API Documentation Coverage (pull_request) Successful in 4s
Details
Generic: Standards Compliance / Accessibility Check (pull_request) Successful in 5s
Details
Generic: Standards Compliance / Performance Metrics (pull_request) Successful in 5s
Details
Generic: Standards Compliance / Dependency Vulnerability Scanning (pull_request) Successful in 1m6s
Details
Generic: Standards Compliance / Unused Dependencies Check (pull_request) Successful in 1m8s
Details
Generic: Standards Compliance / Enterprise Readiness Check (pull_request) Successful in 59s
Details
Generic: Standards Compliance / Terraform Configuration Validation (pull_request) Successful in 11s
Details
Generic: Standards Compliance / Repository Health Check (pull_request) Successful in 1m9s
Details
Generic: Project CI / Tests (pull_request) Has been cancelled
Details
Generic: Repo Health / Scripts governance (pull_request) Has been cancelled
Details
Generic: Repo Health / Repository health (pull_request) Has been cancelled
Details
Generic: Repo Health / Report: Scripts Governance (pull_request) Has been cancelled
Details
Generic: Repo Health / Report: Repository Health (pull_request) Has been cancelled
Details
Generic: Standards Compliance / Compliance Summary (pull_request) Has been cancelled
Details
Universal: PR Check / Branch Policy (pull_request) Has been cancelled
Details
Universal: PR Check / Secret Scan (pull_request) Has been cancelled
Details
Universal: PR Check / Validate PR (pull_request) Has been cancelled
Details
Branch Cleanup / Delete merged branch (pull_request) Has been cancelled
Details
RC Revert / Rename rc/ back to dev/ (pull_request) Has been cancelled
Details
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Details
Universal: PR Check / Report Issues (pull_request) Has been cancelled
Details
25958fcb78 
The auto-release 'promote changelog' step used a blind string replace of the
'## [Unreleased]' marker, which injected an empty version header, pushed the
intro block below the version headers, and compounded on every re-run. Rewrite
it to parse the changelog into a top header block plus '## [' sections, promote
only when [Unreleased] has real content (a ### subheading or a bullet), move
that content under a new version header, and leave [Unreleased] empty. No-op
runs leave the file byte-identical (EOL-preserving) so CI makes no spurious
commit.

Authored-by: Moko Consulting
jmiller merged commit 5045c4bf95 into dev 2026-07-18 21:45:49 +00:00
jmiller deleted branch fix/changelog-promote-structure 2026-07-18 21:45:53 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
breaking-change
Breaking API or behavior change
 ci-cd
CI/CD pipeline changes
 config
Configuration changes
 css
CSS/styling changes
 dependencies
Dependency updates
 deploy-failure
Deployment failed
 documentation
Documentation changes
 good first issue
Good for newcomers
 health-check
Repo health check result
 help wanted
Extra attention needed
 html
HTML/template changes
 joomla
Joomla extension
 major-release
Major version release
 minor-release
Minor version release
 mokostandards
Related to MokoStandards framework
 patch-release
Patch version release
 php
PHP code
 push-failure
Git push operation failed
 release-candidate
Release candidate build
 security
Security vulnerability or hardening
 size/l
200-500 lines changed
 size/m
50-200 lines changed
 size/s
10-50 lines changed
 size/xl
500+ lines changed
 size/xs
< 10 lines changed
 standards-drift
Deviates from MokoStandards
 standards-update
MokoStandards compliance update
 sync-failure
Sync or mirror failed
 version-drift
Version mismatch across files
 work-in-progress
Draft or incomplete work
bug
Something is not working
 duplicate
This issue or pull request already exists
 enhancement
New feature
 help wanted
Need some help
 invalid
Something is wrong
 question
More information is needed
 wontfix
This won't be fixed
No labels
Priority -
Type -
Milestone
No items
No Milestone
Assignees
Clear assignees
jmiller (Jonathan Miller)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/Template-Joomla#68
Delete Branch "fix/changelog-promote-structure"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?