rlsbl v0.41.7 /rlsbl changelog
On this page

Manage structured JSONL changelog entries: add per-commit entries, validate them against schema and coverage, and generate CHANGELOG.md.

#rlsbl changelog

Structured changelog management using JSONL entries. Add and generate CHANGELOG.md from per-commit changelog entries stored in unreleased.jsonl for precise, auditable release notes.

#changelog add

Append a structured changelog entry to the project's unreleased.jsonl file. Each entry includes a human-readable description, an entry type (feature, fix, or breaking), and optional commit hashes linking it to specific changes. The file is auto-committed unless --no-commit is passed. Use --no-user-facing to mark internal changes that should not appear in the published changelog.

#Flags

Flags
NameShortTypeDefaultEnvDescription
--commitsstrComma-separated commit hashes
--descriptionstrEntry description
--typestrEntry type (feature, fix, breaking)
--no-user-facingboolMark as non-user-facing
--no-commitboolSkip auto-commit of unreleased.jsonl

#changelog generate

Compile all validated JSONL changelog entries into a formatted CHANGELOG.md file. Groups entries by type (features, fixes, breaking changes) under the appropriate version heading, preserving existing changelog content for previous releases. Use --dry-run to preview the generated Markdown output without writing to disk, which is useful for reviewing before committing.

#Flags

Flags
NameShortTypeDefaultEnvDescription
--no-commitboolSkip auto-commit of generated files

#changelog amend

Append a changelog entry to a released version's JSONL file. Temporarily unlocks the read-only file, appends the entry, re-locks it, regenerates CHANGELOG.md, and syncs GitHub Release notes. Use --no-resolve to skip hash validation for old or amended commits.

#Flags

Flags
NameShortTypeDefaultEnvDescription
--versionstrReleased version to amend (e.g., 0.39.0)
--commitsstrComma-separated commit hashes
--descriptionstrEntry description
--typestrEntry type (feature, fix, breaking)
--no-user-facingboolMark as non-user-facing
--no-resolveboolSkip hash validation