Merge pull request #16 from akhundMurad/fix/changelog-job-md

chore(ci): simplify changelog PR workflow

Author: akhundMurad

.github/workflows/publish.yaml

@@ -84,6 +84,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
         with:
+          ref: main
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
@@ -96,33 +97,17 @@ jobs:
       - name: Generate release notes
         run: git cliff --latest --strip header -o RELEASE_NOTES.md
 
-      - name: Commit changelog to branch
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-          BRANCH="changelog/${{ github.ref_name }}-${{ github.run_id }}"
-          git checkout -b "$BRANCH"
-
-          git add CHANGELOG.md
-          if git diff --staged --quiet; then
-            echo "No changelog changes; skipping commit + PR."
-            exit 0
-          fi
-
-          git commit -m "chore: update changelog for ${{ github.ref_name }}"
-          git push --force-with-lease origin "$BRANCH"
-
       - name: Create pull request for changelog
         uses: peter-evans/create-pull-request@v6
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           base: main
-          branch: changelog/${{ github.ref_name }}-${{ github.run_id }}
+          branch: changelog/${{ github.ref_name }}
           title: "chore: update changelog for ${{ github.ref_name }}"
           body: |
             Automated changelog update for `${{ github.ref_name }}`.
           commit-message: "chore: update changelog for ${{ github.ref_name }}"
+          add-paths: CHANGELOG.md
 
       - name: Upload release notes
         uses: actions/upload-artifact@v4

CHANGELOG.md

@@ -4,3 +4,75 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.5] - 2026-01-27
+
+### Added
+
+- **cli:** Add `check` command to evaluate rules against saved snapshots
+- **cli:** Document new `pacta check` command and two-step snapshot workflow
+
+### Changed
+
+- Format argparse argument and remove unused import
+
+### Documentation
+
+- Add new example docs pages and example projects (layered, hexagonal, legacy migration)
+- Update CLI and examples for snapshot save/check workflow
+
+### Fixed
+
+- **check:** Update existing snapshot object in-place and save optional extra ref
+- **ci:** Use --force-with-lease when pushing changelog updates
+
+### Testing
+
+- **cli:** Reformat assertion for save refs call args
+
+## [0.0.4] - 2026-01-26
+
+### Documentation
+
+- Refresh README and getting started with architecture snapshot/history narrative
+
+### Miscellaneous
+
+- **ci:** Create PR for changelog updates instead of pushing to main
+
+## [0.0.3] - 2026-01-25
+
+### Added
+
+- **cli:** Show human-readable violation explanations in text output
+- **cli:** Add history commands and content-addressed snapshot store
+- **cli:** Add `history trends` with ASCII charts and optional matplotlib export
+- **docs:** Document history trends command and add chart example
+- **model:** Add optional layer name field and load from spec
+
+### Documentation
+
+- **contributing:** Expand contributing guide with project structure and dev workflow
+- **readme:** Reposition as architecture governance tool and add demo gif
+- Add changelog and expand MkDocs documentation
+
+### Miscellaneous
+
+- **license:** Switch to Apache-2.0 and bump version to 0.0.2
+- Apply formatting and typing tweaks in history output and tests
+- **cli:** Remove redundant module docstrings and __future__ imports from chart modules
+- **dev:** Add pytest-cov to dev dependencies
+
+## [0.0.2] - 2026-01-23
+
+### Miscellaneous
+
+- **license:** Switch to Apache-2.0 and bump version to 0.0.2
+
+## [0.0.1] - 2026-01-23
+
+[0.0.5]: https://github.com/akhundMurad/pacta/compare/v0.0.4...v0.0.5
+[0.0.4]: https://github.com/akhundMurad/pacta/compare/v0.0.3...v0.0.4
+[0.0.3]: https://github.com/akhundMurad/pacta/compare/v0.0.2...v0.0.3
+[0.0.2]: https://github.com/akhundMurad/pacta/compare/v0.0.1...v0.0.2
+