Skip to content

Release Workflow: Post-release changelog validation missing #592

@ashleyshaw

Description

@ashleyshaw

Issue

After release agent updates CHANGELOG.md and creates a new [Unreleased] section (per issue #586), there's no validation that the new structure is schema-valid.

Impact

  • Silent drift between intended and actual changelog format
  • Next PR finds an invalid changelog → validation fails
  • Breaks changelog validation gate for next development cycle

Root Cause

.github/workflows/release.yml validates CHANGELOG before release (line 105–108) but not after. After agent modifies the file, there's no re-validation.

Expected Behavior

After release agent completes (or specifically after changelog update), add:

release:
  # ... existing steps ...
  
  - name: Validate post-release changelog
    if: inputs.dry_run == false
    run: |
      node scripts/validation/validate-changelog.cjs CHANGELOG.md
      node scripts/agents/includes/changelogUtils.cjs --validate CHANGELOG.md
      node scripts/agents/includes/changelogUtils.cjs --unreleased CHANGELOG.md

This ensures the new Unreleased section is valid before committing.

References

  • Related audit: .github/reports/audits/RELEASE_PROCESS_AUDIT_v0_5_0.md (Issue 3.1)
  • Workflow: .github/workflows/release.yml
  • Validation scripts: scripts/validation/validate-changelog.cjs, scripts/agents/includes/changelogUtils.cjs

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Priority

    None yet

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions