Skip to content

docs(changelog): back-fill Unreleased section for everything merged since v1.24.3 - #295

Merged
qnbs merged 2 commits into
mainfrom
docs/changelog-unreleased-ws1
Jul 30, 2026
Merged

docs(changelog): back-fill Unreleased section for everything merged since v1.24.3#295
qnbs merged 2 commits into
mainfrom
docs/changelog-unreleased-ws1

Conversation

@qnbs

@qnbsqnbs commented Jul 30, 2026

Copy link
Copy Markdown
Owner

Summary

The [Unreleased] section of CHANGELOG.md was empty even though two PRs have already merged
into main since the v1.24.3 release tag. Back-fills it so the changelog stays a complete,
accurate record of what's actually on main — not just the last tagged release.

  • fix(docs): close doc-metrics gate's blind spot for open bullets (F-1) #293 (WS-1): check-doc-metrics.mjs's stripHistoricalSections() blind spot for still-open
    - ⬜ checklist bullets inside dated/historical sections, plus the matching scanForDrift()
    check for stale open tag/release/publish bullets.
  • docs: codify branch/merge-discipline lessons from the WS-recovery sprint #294: CLAUDE.md codifies three merge-discipline lessons from the recovery sprint (never
    commit directly to main; wait for the full CI suite including advisory jobs; group related
    workstreams into fewer PRs), a new "Known merge-gate quirks" section (cache-lag vs. this repo's
    wait-for-pass policy, stacked-PR auto-close-on-squash-merge), and a strengthened CodeAnt
    Correction Loop policy covering CodeRabbit's nitpick/outside-diff-range sections.

Verified via git log v1.24.3..origin/main and a full git diff --stat against the release tag
that these two PRs are the entire delta — nothing else is undocumented.

Test plan

  • git diff v1.24.3..origin/main --stat cross-checked against the two changelog bullets — exact match
  • CI quality gate (Node 22/24, Security Audit, Build) — required checks

Summary by CodeRabbit

  • Bug Fixes

    • Improved documentation checks to preserve open historical checklist items and flag outdated release or publishing references.
  • Documentation

    • Updated contributor guidance with merge-discipline lessons and a new section covering known merge-gate quirks.
    • Expanded guidance for the CodeAnt Correction Loop policy.

qnbs added 2 commits July 30, 2026 10:28
PR #293 merged into main after the v1.24.3 release but the Unreleased
section stayed empty -- back-fill it so the changelog reflects what's
actually shipped on main, not just the last tagged release.
…cation
Second Unreleased entry for what's landed on main since v1.24.3 -- keeps
the changelog a complete record of main, not just the last tagged release.
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
worldscript-studioReadyReadyPreviewJul 30, 2026 8:30am

@coderabbitai

coderabbitaiBot commented Jul 30, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c92d16bc-759f-41e9-8993-9bdb59986e8d

📥 Commits

Reviewing files that changed from the base of the PR and between 1f944b4 and d9388ad.

📒 Files selected for processing (1)
  • CHANGELOG.md

📝 Walkthrough

Walkthrough

CHANGELOG.md adds Unreleased entries describing doc-drift gate behavior and expanded merge-discipline documentation, including merge-gate quirks and CodeAnt Correction Loop coverage.

Changes

Changelog updates

Layer / File(s)Summary
Doc-drift gate changelog entry
CHANGELOG.md
The Fixed section documents preservation of still-open historical checklist bullets and detection of stale version references.
Merge-discipline documentation entry
CHANGELOG.md
The Docs section documents merge practices, merge-gate quirks, recovery steps, and expanded CodeAnt Correction Loop coverage.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the changelog back-fill of the Unreleased section since v1.24.3.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/changelog-unreleased-ws1

Comment @coderabbitai help to get the list of available commands.

@codeant-ai

Copy link
Copy Markdown

🏁 CodeAnt Quality Gate Results

Commit:d9388adc
Scan Time: 2026-07-30 08:32:13 UTC

✅ Overall Status: PASSED

Quality Gate Details

Quality GateStatusDetails
Secrets✅ PASSED0 secrets found
Duplicate Code✅ PASSED0.0% duplicated
SAST✅ PASSEDNo security issues
Bugs✅ PASSEDRating S: No bugs
IAC✅ PASSEDNo IAC issues

View Full Results

@codecov

codecovBot commented Jul 30, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@qnbs
qnbs merged commit 24378fd into mainJul 30, 2026
26 checks passed
@qnbs
qnbs deleted the docs/changelog-unreleased-ws1 branch July 30, 2026 08:52
Sign up for freeto 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

@qnbs