changelog

name	changelog
description	Update per-package CHANGELOG.md files for a Ratel release. Drafts entries with git-cliff (scoped per package), lets you curate, then writes the CHANGELOGs. Handles both RC entries and GA-graduation collapse (merging X.Y.Z-rc.* sections into a single X.Y.Z section). Invoke before tagging a release.

/changelog

Updates a release unit's CHANGELOG.md in preparation for tagging it. Ratel releases per unit (ADR-0008): each unit ships on its own tag (<prefix>-v*) at its own version. For workflow-wired units, .github/workflows/release.yml rejects a tag whose unit CHANGELOG doesn't contain the version being released. vercel-ai-sdk is temporarily published manually via scripts/publish-rc.sh; still run this skill before its tag even though the workflow gate does not cover it yet.

Run it once per unit you're releasing.

Release units it touches

The units and their manifests/CHANGELOGs live in one registry — scripts/release-units.mjs — which every release tool reads. Run node scripts/release-units.mjs --list for the authoritative set; the current eight units are:

Unit	Registry	CHANGELOG path
core	ratel-ai-core (crates.io)	src/core/CHANGELOG.md
sdk-ts	@ratel-ai/sdk (npm)	src/sdk/ts/CHANGELOG.md
sdk-py	ratel-ai (PyPI)	src/sdk/python/CHANGELOG.md