Skip to content

fix: allow CHANGELOG.md at the repo root - #360

Merged
alicoding merged 1 commit into
mainfrom
fix/ls-lint-allow-changelog
Aug 22, 2026
Merged

fix: allow CHANGELOG.md at the repo root#360
alicoding merged 1 commit into
mainfrom
fix/ls-lint-allow-changelog

Conversation

@alicoding

Copy link
Copy Markdown
Owner

Release 0.5.0 (#319) could never merge, and the reason was our own gate.

release-please generates CHANGELOG.md at the repo root on every release PR. The root allowlist in .ls-lint.yml doesn't include it, so root-file-naming fails — and that's a required check feeding ci-gate. Every release PR would hit this, not just this one.

Worth noting how it stayed hidden: the release PR is authored by the github-actions bot, so its CI runs sit at action_required and never execute. The PR showed "blocked" with every visible check green, which reads like a mystery rather than a failure. Approving the run surfaced the actual error immediately.

The release branch is the one branch that can't resolve this by moving the file somewhere else, so the allowlist is the correct place to fix it. Added deliberately with its reason inline, per the root-layout rule that says a new root file is a considered decision rather than a quiet regex tweak.

Verified locally: ls_lint exits 0 with the change.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FW5GkkAG8du7tNdYLk2zSd

release-please generates CHANGELOG.md at the root on every release PR,
and the root allowlist never included it -- so every release PR failed
root-file-naming, which is a required check, and could never merge.
Release 0.5.0 was blocked on exactly this.

The release branch is the one branch that cannot resolve this by moving
the file elsewhere, so the allowlist is the right place to fix it. Added
deliberately with its reason, per the root-layout rule.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FW5GkkAG8du7tNdYLk2zSd
@alicoding
alicoding enabled auto-merge (squash) August 22, 2026 18:40
@alicoding
alicoding merged commit f318d29 into main Aug 22, 2026
27 checks passed
@alicoding
alicoding deleted the fix/ls-lint-allow-changelog branch August 22, 2026 18:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant