danger-changelog 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 173f58cbaf43ff80a454e062c19f6674e0742c37fbd59c5bb4e85bc00c8d3899
-  data.tar.gz: 21ac5d08f53444c17cf3231880fc4f45beaca225970ecd1862002909ebbcf8fe
+  metadata.gz: 9344e34064e086a963ba58734bc0468c3feaf3e70404b63215d9140b2c31ea99
+  data.tar.gz: 27caf32026da6f6273c6b9dcd91e6b4c0629c73bd63ca034645de8f4a8ac2b4b
 SHA512:
-  metadata.gz: 4e98417f1d4a0d74eeea613d876eca5b39dd5e12337255c08ba3598cde50731fce8533eaddd4b3bde26a20e84baa4674eff409a8b0564f4f539a2f23d0a0534b
-  data.tar.gz: ae509fd46287e51ab6a78ff32fbcfe69ca5c7841abc57f37e6f1a822ddb2d42a627687ca1ea30ff26c7bbbd06c2acb93f431aac3af8d932707c2030ebf73cb4d
+  metadata.gz: 68121502e1ce015b0047ccd75faec0ac462d408f4033db1fcf0094d98a79fe518afe9d831adec96b83a2a73d29c3c08f4c207c820afedc27a4c7420755fa6dfe
+  data.tar.gz: 10371d27eb574c7f47970d969d745508c4bf6402655c400bdc8855dc2997ccaaeb6563717a3e568f85ff76a263baabdd6974298b4d64e7dd1cd207d6f50e12c0

data/CHANGELOG.md

@@ -1,9 +1,19 @@
 ## Changelog
 
-### 0.9.1 (Next)
-
-* Your contribution here.
-
+### 0.10.0 (2026-10-21)
+
+* [#84](https://github.com/dblock/danger-changelog/pull/84): Add global and per-check unreleased label lists for exact, case-sensitive header validation while preserving permissive defaults - [@dblock](https://github.com/dblock).
+* [#82](https://github.com/dblock/danger-changelog/pull/82): Add opt-in intent-word checks with a configurable dictionary, consistent forms within each verb family, and full-file or added-only validation - [@dblock](https://github.com/dblock).
+* [#83](https://github.com/dblock/danger-changelog/pull/83): Add global and per-check only_added scope for format diagnostics while keeping full-file validation as the default and file-wide requirements unconditional - [@dblock](https://github.com/dblock).
+* [#81](https://github.com/dblock/danger-changelog/pull/81): Require added changelog entries to belong to an unreleased section by default, with global and per-check heading overrides and opt-out - [@dblock](https://github.com/dblock).
+* [#80](https://github.com/dblock/danger-changelog/pull/80): Keep invalid-line reports fenced correctly when changelog text contains backticks and verify consecutive Keep a Changelog error rendering - [@dblock](https://github.com/dblock).
+* [#79](https://github.com/dblock/danger-changelog/pull/79): Add global and per-check strict_semver settings to allow opt-in numeric versions with two or more components in both changelog formats - [@dblock](https://github.com/dblock).
+* [#78](https://github.com/dblock/danger-changelog/pull/78): Support GitLab.com merge request and author links and generate reminders from GitLab metadata without requiring GitHub - [@dblock](https://github.com/dblock).
+* [#77](https://github.com/dblock/danger-changelog/pull/77): Support Markdown reference-style PR and author links in Intridea changelogs, reporting undefined references and preserving original entries in diagnostics - [@dblock](https://github.com/dblock).
+* [#76](https://github.com/dblock/danger-changelog/pull/76): Allow uncased scripts and emoji at the start of Intridea descriptions while retaining capitalization rules for cased letters - [@dblock](https://github.com/dblock).
+* [#75](https://github.com/dblock/danger-changelog/pull/75): Support all global settings as isolated per-check keyword overrides, including placeholder validation and parser selection - [@dblock](https://github.com/dblock).
+* [#74](https://github.com/dblock/danger-changelog/pull/74): Explain missing colons after pull request links, separate suggested entries with a heading, and document conditional changelog reminders - [@dblock](https://github.com/dblock).
+* [#73](https://github.com/dblock/danger-changelog/pull/73): Require Ruby 3.1, test through Ruby 4.0 with compatible ActiveSupport versions, modernize pinned tokenless workflows, and restrict packaged files - [@dblock](https://github.com/dblock).
 ### 0.9.0 (2026/10/14)
 
 * [#72](https://github.com/dblock/danger-changelog/pull/72): Accept bot author links with a `[bot]` suffix without changing their attribution - [@dblock](https://github.com/dblock).

data/README.md

@@ -1,7 +1,6 @@
 # Danger-Changelog
 
-A plugin for [danger.systems](http://danger.systems) that obsessive-compulsively lints your project’s `CHANGELOG.md`.
-It can make sure, for example, that changes are attributed properly, have a valid version number, a date in the ISO8601 format, balanced parenthesis and brackets, and that they’re always terminated with a period.
+A plugin for [danger.systems](https://danger.systems) that obsessive-compulsively lints your project’s `CHANGELOG.md`. It can make sure, for example, that changes are attributed properly, have a valid version number, a date in the ISO8601 format, balanced parenthesis and brackets, and that they’re always terminated with a period.
 
 [![Gem Version](https://badge.fury.io/rb/danger-changelog.svg)](https://badge.fury.io/rb/danger-changelog)
 [![Build Status](https://github.com/dblock/danger-changelog/actions/workflows/test.yml/badge.svg?branch=master&event=push)](https://github.com/dblock/danger-changelog/actions/workflows/test.yml)
@@ -16,6 +15,12 @@ It can make sure, for example, that changes are attributed properly, have a vali
   - [changelog.format](#changelogformat)
   - [changelog.placeholder_line](#changelogplaceholder_line)
   - [changelog.ignore_files](#changelogignore_files)
+  - [changelog.strict_semver](#changelogstrict_semver)
+  - [changelog.unreleased_labels](#changelogunreleased_labels)
+  - [changelog.unreleased_heading](#changelogunreleased_heading)
+  - [changelog.only_added](#changelogonly_added)
+  - [changelog.check_intent and changelog.intent_words](#changelogcheck_intent-and-changelogintent_words)
+  - [Conditional reminders](#conditional-reminders)
 - [Checks](#checks)
   - [changelog.check!](#changelogcheck)
     - [changelog.have_you_updated_changelog?](#changeloghave_you_updated_changelog)
@@ -27,12 +32,14 @@ It can make sure, for example, that changes are attributed properly, have a vali
 
 By design, `danger-changelog` is quite strict with what it allows as a valid changelog file, using the [Intridea style](doc/intridea.md), [used by this library itself](CHANGELOG.md). It also supports the [Keep a Changelog](doc/keep_a_changelog.md) format.
 
+Intridea PR and author links can be inline links or [Markdown references](doc/intridea.md#changelog-entries), with definitions elsewhere in the file. Undefined references are reported without changing the original entry shown in the report.
+
 ## Installation
 
-Add `danger-changelog` to your Gemfile.
+Requires Ruby 3.1 or newer. Add `danger-changelog` to your Gemfile.
 
 ```
-gem 'danger-changelog', '~> 0.6.0'
+gem 'danger-changelog'
 ```
 
 Call `changelog.check!` from your `Dangerfile`. Make a pull request and see this plugin in action.
@@ -43,7 +50,16 @@ Methods and attributes from this plugin are available in your `Dangerfile` under
 
 ## Configuration
 
-The following options and checks are supported.
+Every option can be set globally on `changelog` or passed as a keyword to a check. Per-check keywords override global defaults only for that call; parsing and reports use an immutable snapshot. Unknown options and invalid values raise `ArgumentError`.
+
+```ruby
+changelog.ignore_files = ['README.md', /\.txt$/]
+changelog.check!
+changelog.check!(filename: 'packages/api/CHANGELOG.md')
+changelog.check!(filename: 'CHANGES.md', format: :keep_a_changelog)
+```
+
+Global strings and arrays are copied and frozen; assign a new value rather than modifying a setting in place. The deprecated `Danger::Changelog.configure` block still sets global defaults.
 
 ### changelog.filename
 
@@ -51,6 +67,7 @@ Set the CHANGELOG file name, defaults to `CHANGELOG.md`.
 
 ```ruby
 changelog.filename = 'CHANGES.md'
+changelog.check!(filename: 'CHANGES.md')
 ```
 
 ### changelog.format
@@ -59,9 +76,10 @@ Set the format of the CHANGELOG file.
 
 ```ruby
 changelog.format = :keep_a_changelog
+changelog.check!(format: :keep_a_changelog)
 ```
 
-Available formats are [Intridea](doc/intridea.md) (default) and [Keep a Changelog](doc/keep_a_changelog.md).
+Available formats are [Intridea](doc/intridea.md) (default) and [Keep a Changelog](doc/keep_a_changelog.md). Symbol and string format names are accepted.
 
 ### changelog.placeholder_line
 
@@ -69,8 +87,11 @@ Customize the `* Your contribution here.` line. Set the value to `nil` to stop c
 
 ```ruby
 changelog.placeholder_line = "* Your change here.\n"
+changelog.check!(placeholder_line: 'Your change here.')
 ```
 
+The leading `* ` and trailing newline are added when omitted. This option applies to the Intridea parser; Keep a Changelog does not require a placeholder.
+
 ### changelog.ignore_files
 
 Ignore additions and changes with a certain name or expression, default is to ignore `README.md` changes.
@@ -79,26 +100,138 @@ For example, ignore `UPGRADING.md` and all `.txt` files.
 
 ```ruby
 changelog.ignore_files = ['README.md', 'UPGRADING.md', /\.txt$/]
+changelog.check!(ignore_files: ['README.md', 'UPGRADING.md', /\.txt$/])
+```
+
+### changelog.strict_semver
+
+Require three-component Semantic Versions by default. Set `strict_semver: false` to accept numeric versions with two or more components, such as `2.0` or `1.2.3.4`, with optional prerelease/build suffixes. Date, delimiter, and other formatting checks remain active. This applies to both supported formats.
+
+```ruby
+changelog.strict_semver = false
+changelog.check!(filename: 'CHANGES.md', strict_semver: false)
+```
+
+### changelog.unreleased_labels
+
+By default (`nil`), header validation accepts existing label spellings such as `Next`, `next`, `Unreleased`, and project-specific words. Supply a list to replace that permissive behavior with exact, case-sensitive matching in both formats:
+
+```ruby
+changelog.unreleased_labels = ['Next']
+changelog.check! # Accepts 0.4.0 (Next), rejects 0.4.0 (next).
+changelog.is_changelog_format_correct?(unreleased_labels: ['Next', 'Unreleased'])
+changelog.check!(unreleased_labels: nil) # Restore permissive validation for this call.
+```
+
+The list restricts labels following a version (with or without delimiters) and standalone labels enclosed in parentheses, brackets, or braces, such as `[Unreleased]`. Bare versions, release dates, and ordinary unwrapped titles such as `Changelog` and `Changed:` remain unaffected. Labels are literal strings, not regular expressions; custom labels may contain spaces and punctuation. Each must be nonempty, have no leading/trailing whitespace, and contain no newlines or enclosing delimiter characters. An empty list rejects all labels while still allowing dated and bare versions.
+
+This option validates header spelling, not entry placement. Configure `unreleased_heading` separately if you adopt a custom heading convention; setting the label list does not change its pattern.
+
+### changelog.unreleased_heading
+
+By default, added list entries must belong to an unreleased section. The default heading pattern, `/(?:\(Next\)|\[Unreleased\])/i`, recognizes Intridea's `(Next)` and Keep a Changelog's `[Unreleased]`, case-insensitively. This global or per-check setting applies to both formats and is enforced by `check!` after its existing checks pass:
+
+```ruby
+changelog.unreleased_heading = /\(Next\)/
+changelog.check!
+changelog.check!(format: :keep_a_changelog, unreleased_heading: /\[Unreleased\]/i)
+changelog.check!(unreleased_heading: nil) # Allow intentional historical corrections.
+```
+
+Only added `*` or `-` list lines in Danger's changelog diff are checked. Nested category headings stay inside the release; the next heading at the same or shallower level ends it. Unchanged historical entries are ignored. Historical corrections appear as additions too; use `unreleased_heading: nil` for those PRs and release-preparation changes. Customize the pattern for your project's heading convention.
+
+Call `changelog.entries_in_unreleased_section?(unreleased_heading: /\(Next\)/)` to run this check separately. Missing diff data produces an explicit error rather than silently skipping the enabled check.
+
+### changelog.only_added
+
+Format validation and enabled intent validation check the entire file by default (`only_added: false`). Set `only_added: true` globally or per check to report line-level format problems and compare intent words only on added lines in Danger's diff. Edited historical entries count as additions. Headers, punctuation, capitalization, attribution, and reference diagnostics follow this scope; reference definitions elsewhere in the file remain available for resolution.
+
+```ruby
+changelog.only_added = true
+changelog.check!
+changelog.is_changelog_format_correct?(only_added: false)
+```
+
+Missing files, required placeholders, and Keep a Changelog preamble requirements always apply to the whole file. Missing diff data is an explicit failure when added-only checking is requested for a changed changelog. An unchanged file has no added-line diagnostics but still receives global checks.
+
+Release-section placement always checks additions only, regardless of `only_added`; checking released history against an unreleased section would incorrectly reject existing releases. Use `unreleased_heading: nil` to disable placement validation.
+
+### changelog.check_intent and changelog.intent_words
+
+Opt into a finite dictionary of intent words and consistent wording within each verb family with `check_intent: true`. This rule is disabled by default and works with both formats. Once enabled, it checks the entire file by default, skipping the configured placeholder and fenced code examples. Set `only_added: true` to compare only added entries, excluding unchanged history. Missing diff data is an error only when added-only checking is requested for a changed changelog.
+
+```ruby
+changelog.check_intent = true
+changelog.check!
+changelog.check!(check_intent: true, intent_words: %w[Add Fix Remove])
+changelog.intent_correct?(check_intent: true)
+```
+
+The default verb families are **Add, Allow, Change, Clarify, Deprecate, Disable, Document, Enable, Fix, Improve, Optimize, Refactor, Remove, Rename, Replace, Revert, Simplify, Support, Update, Upgrade**, including their past, third-person present, and gerund forms (for example, `Add`, `Added`, `Adds`, `Adding`; `Fix`, `Fixed`, `Fixes`, `Fixing`). Any form is acceptable on its own, but mixing forms within a family fails: `Add` with `Added` fails, while repeated `Added` entries pass. Each family is independent, so `Added` with `Fix` passes. Diagnostics ask later entries to match the first form used among the checked entries and include its line number. Unknown words show the allowed dictionary.
+
+`intent_words` replaces the entire dictionary and must be a nonempty array of single words. Custom words are accepted exactly as listed, without automatic inflection; known forms still belong to their built-in verb family for consistency checks. Matching is case-sensitive, supports Unicode letters, and checks the first word after an optional PR reference or inline link. Setting a dictionary alone does not enable the rule. Projects with non-English prose, emoji-first entries, or inline-code-first descriptions should leave it disabled or adopt a compatible custom word list. Existing format validation remains independent; a custom dictionary does not relax capitalization rules.
+
+### Conditional reminders
+
+By default, only `README.md` is ignored. To skip reminders when all added or modified files are documentation at the repository root, use an anchored pattern. Subdirectory files still require a changelog update.
+
+```ruby
+changelog.ignore_files = [/\A[^\/]+\.md\z/]
+changelog.check!
+```
+
+For code-only reminders, use Danger's changed files directly. Keep format validation unconditional, so an edited changelog is checked even when no code changes:
+
+```ruby
+changed_files = git.modified_files + git.added_files + git.deleted_files
+changelog.have_you_updated_changelog? if changed_files.any? { |file| file.start_with?('lib/') }
+changelog.is_changelog_format_correct?
 ```
 
+Other policies can use the same separate checks, such as reminding only for changes larger than 50 lines unless the pull request is marked trivial:
+
+```ruby
+declared_trivial = github.pr_labels.include?('trivial')
+changelog.have_you_updated_changelog? if git.lines_of_code > 50 && !declared_trivial
+changelog.is_changelog_format_correct?
+```
+
+The label example uses the GitHub plugin; adapt the condition to your provider. Do not also call `check!` in these conditional examples, because it would run the reminder unconditionally.
+
 ## Checks
 
-Invoke check methods.
+All checks accept the same configuration keywords: `filename`, `format`, `placeholder_line`, `ignore_files`, `strict_semver`, `unreleased_labels`, `unreleased_heading`, `only_added`, `check_intent`, and `intent_words`. Each uses only the relevant settings.
 
 ### changelog.check!
 
-Run all checks with defaults, including `have_you_updated_changelog?` and `is_changelog_format_correct?`.
+Run all checks with defaults, including `have_you_updated_changelog?`, `is_changelog_format_correct?`, and `entries_in_unreleased_section?`. When enabled, intent validation runs after those checks pass.
+
+```ruby
+changelog.check!(filename: 'CHANGES.md', placeholder_line: nil)
+```
+
+As before, format validation runs only if the update reminder passes. The deprecated `check` also accepts keyword overrides and its legacy positional format, without modifying global defaults.
 
 #### changelog.have_you_updated_changelog?
 
 Checks whether you have updated CHANGELOG.md.
 
+```ruby
+changelog.have_you_updated_changelog?(filename: 'CHANGES.md', ignore_files: [/\.md$/])
+```
+
 ![](images/have_you_updated_changelog.png)
 
 #### changelog.is_changelog_format_correct?
 
 Checks whether the CHANGELOG format is correct.
 
+```ruby
+changelog.is_changelog_format_correct?(filename: 'CHANGES.md', format: :keep_a_changelog)
+```
+
+The change predicates `changelog_changes?` and `file_changes?` accept the same keywords, for example `changelog.changelog_changes?(filename: 'CHANGES.md')`.
+
 ![](images/is_changelog_format_correct.png)
 
 ## Contributing

data/doc/intridea.md

@@ -92,6 +92,10 @@ The Intridea style changelog was pioneered on the Hashie project. It has many el
 # Not valid (2019/12/31)
 ```
 
+### Unreleased labels
+
+Version headers can use labels such as `## 0.4.0 (Next)` or `## 0.4.0 (next)` by default. To enforce one spelling, set `changelog.unreleased_labels = ['Next']` or pass `unreleased_labels: ['Next']` to a check. This replaces permissive label matching with an exact, case-sensitive list and also applies to standalone delimited labels such as `## [Next]`. Dates, bare versions, and ordinary unwrapped titles are unaffected. The default `nil` preserves existing behavior; `[]` allows no labels. See [configuration](../README.md#changelogunreleased_labels).
+
 ### Changelog entries
 
 ✅ Under each title, you can have changelog entries in the format: `* {optional link to GitHub pull request that must be followed by a colon} {a single sentence of text description} - {author github link}.`:
@@ -105,12 +109,35 @@ The Intridea style changelog was pioneered on the Hashie project. It has many el
 
 Bot author names may end in a literal `[bot]` suffix, such as `github-actions[bot]` or `dependabot[bot]`. Keep the suffix in the attribution; links to GitHub app pages and bot profiles are supported.
 
-❌ Entry descriptions need to start with an uppercase A-Z letter
+✅ Entry descriptions can start with uppercase letters, uncased scripts (such as Japanese, Chinese, or Arabic), emoji, or inline code
+
+```markdown
+* 日本語の変更 - [@ivoanjo](https://github.com/ivoanjo).
+* 修复问题 - [@ivoanjo](https://github.com/ivoanjo).
+* 🚀 Add a feature - [@ivoanjo](https://github.com/ivoanjo).
+```
+
+✅ Pull request and author links may use Markdown references: full (`[@dblock][author]`), collapsed (`[@dblock][]`), or shortcut (`[@dblock]`)
+
+```markdown
+* [#1]: Fix an issue - [@dblock].
+* [#2][second-pr]: Add a feature - [@dblock][author].
+
+[#1]: https://github.com/dblock/danger-changelog/pull/1
+[second-pr]: https://github.com/dblock/danger-changelog/pull/2
+[@dblock]: https://github.com/dblock
+[author]: https://github.com/dblock
+```
+
+Definitions may appear before or after entries. Labels are case-insensitive and consecutive whitespace is collapsed; the first definition wins when a label is repeated. Angle-bracket destinations and optional titles are accepted, including an indented destination or title on the following line. Inline links and reference links can be mixed. Bot links can use a named reference such as `[@dependabot[bot]][bot]`.
+
+Undefined references are reported explicitly. Resolved destinations must satisfy the same GitHub URL rules as inline links. Reports show the original entry, not its expanded form. Reference expansion applies to PR and author links, not arbitrary references or inline-code examples inside the description.
+
+❌ When a description starts with a cased letter, that letter must be uppercase
 
 ```markdown
 * not valid - [@ivoanjo](https://github.com/ivoanjo).
-* いいえ - [@ivoanjo](https://github.com/ivoanjo).
-* ❌ - [@ivoanjo](https://github.com/ivoanjo).
+* écriture en minuscule - [@ivoanjo](https://github.com/ivoanjo).
 * [#1](https://github.com/dblock/danger-changelog/pull/1): not valid - [@dblock](https://github.com/dblock).
 ```
 
@@ -120,10 +147,18 @@ Bot author names may end in a literal `[bot]` suffix, such as `github-actions[bo
 * [#1](https://github.com/dblock/danger-changelog/pull/1) Not valid - [@dblock](https://github.com/dblock).
 ```
 
-❌ Only links to GitHub are allowed, and only using `https`
+✅ GitHub pull requests and GitLab.com merge requests and author profiles are supported, including GitLab subgroups
+
+```markdown
+* [#1](https://gitlab.com/group/subgroup/project/-/merge_requests/1): Fix an issue - [@contributor](https://gitlab.com/contributor).
+```
+
+GitLab reminders use merge-request metadata for their suggested entries. Self-managed GitLab hosts are not currently accepted by the Intridea URL rules; Keep a Changelog accepts arbitrary link destinations.
+
+❌ Links must use supported hosts and `https`
 
 ```markdown
-* No GitLab - [@ivoanjo](https://gitlab.com/ivoanjo).
+* Unsupported host - [@ivoanjo](https://example.com/ivoanjo).
 * No insecure http - [@ivoanjo](http://github.com/ivoanjo).
 * [#1](https://you-get-the-point.com): Entry with a PR link - [@dblock](https://github.com/dblock).
 ```

data/doc/keep_a_changelog.md

@@ -2,6 +2,8 @@
 
 The Keep a Changelog style format checks that your changelog is formatted like the specification outlined at [KeepAChangelog.com](https://keepachangelog.com).
 
+Header labels are permissive by default. Set `changelog.unreleased_labels = ['Unreleased']` or pass `unreleased_labels: ['Unreleased']` to a check to require that exact spelling in `## [Unreleased]`; lowercase `[unreleased]` then fails. The list also restricts labels following version numbers but does not restrict dates, bare versions, the `Changelog` title, or category headings. The default `nil` preserves existing behavior; `[]` allows no labels. This does not change the separate entry-placement pattern, `unreleased_heading`. See [configuration](../README.md#changelogunreleased_labels).
+
 As an example, here is a changelog formatted in the Keep a Changelog style, as borrowed from the Keep a Changelog project:
 
 ```markdown

data/lib/changelog/added_lines.rb

@@ -0,0 +1,19 @@
+module Danger
+  module Changelog
+    module AddedLines
+      def self.from_patch(patch)
+        number = nil
+        added = []
+        patch.each_line do |line|
+          if (hunk = line.match(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/))
+            number = hunk[1].to_i
+          elsif number && line.start_with?('+', ' ')
+            added << number if line.start_with?('+')
+            number += 1
+          end
+        end
+        added
+      end
+    end
+  end
+end

data/lib/changelog/changelog_line/changelog_entry_line.rb

@@ -4,8 +4,11 @@ module Danger
   module Changelog
     # A CHANGELOG.md line represents the change entry.
     class ChangelogEntryLine < ChangelogLine
-      AUTHOR_NAME = /[\w-]+(?:\[bot\])?/.freeze
-      AUTHOR_LINK = %r{\[@#{AUTHOR_NAME}\]\(https://github\.com/.*#{AUTHOR_NAME}\)}.freeze
+      AUTHOR_NAME = /[\w-]+(?:\[bot\])?/
+      AUTHOR_LINK = %r{\[@#{AUTHOR_NAME}\]\(https://(?:github\.com/.*#{AUTHOR_NAME}|gitlab\.com/#{AUTHOR_NAME})\)}
+      REQUEST_URL = %r{(?:github\.com/[^\s)]+?\d+|gitlab\.com/[^\s)]+/-/merge_requests/\d+)}
+      PR_LINK = %r{\[\#\d+\]\(https?://#{REQUEST_URL}/?\)}
+      DESCRIPTION_START = /[`\p{Lu}\p{Lt}\p{Lo}\p{Lm}\p{So}]/
 
       def valid?
         return validation_result.valid? if validation_result
@@ -15,18 +18,19 @@ module Danger
         validation_result.error! 'too many parenthesis' unless balanced?(line)
         return false if validation_result.invalid?
 
-        return true if line =~ /^\*\s[`[:upper:]].*[^.,] - #{AUTHOR_LINK}.$/
-        return true if line =~ %r{^\*\s\[\#\d+\]\(https://github\.com/.*\d+\): [`[:upper:]].*[^.,] - #{AUTHOR_LINK}.$}
+        return true if line =~ /^\*\s#{DESCRIPTION_START}(?:.*[^.,])? - #{AUTHOR_LINK}.$/
+        return true if line =~ %r{^\*\s\[\#\d+\]\(https://#{REQUEST_URL}\): #{DESCRIPTION_START}(?:.*[^.,])? - #{AUTHOR_LINK}.$}
 
         validation_result.error! 'does not start with a star' unless ChangelogEntryLine.starts_with_star?(line)
         validation_result.error! 'does not include a pull request link' unless ChangelogEntryLine.with_pr_link?(line)
+        validation_result.error! 'is missing a colon after the pull request link' if ChangelogEntryLine.with_pr_link?(line) && !/#{PR_LINK}:/.match?(line)
         validation_result.error! 'does not have a description' unless ChangelogEntryLine.with_changelog_description?(line)
         validation_result.error! 'does not include an author link' unless ChangelogEntryLine.with_author_link?(line)
         validation_result.error! 'has an extra trailing space' if ChangelogEntryLine.ends_with_space?(line)
         validation_result.error! 'is missing a period at the end of the line' unless ChangelogEntryLine.ends_with_period?(line)
         validation_result.error! 'has an extra period or comma at the end of the description' if
-          line =~ /^\*\s[`[:upper:]].*[.,] - #{AUTHOR_LINK}.$/ ||
-          line =~ %r{^\*\s\[\#\d+\]\(https://github\.com/.*\d+\): [`[:upper:]].*[.,] - #{AUTHOR_LINK}.$}
+          line =~ /^\*\s#{DESCRIPTION_START}.*[.,] - #{AUTHOR_LINK}.$/ ||
+          line =~ %r{^\*\s\[\#\d+\]\(https://#{REQUEST_URL}\): #{DESCRIPTION_START}.*[.,] - #{AUTHOR_LINK}.$}
 
         false
       end
@@ -48,7 +52,7 @@ module Danger
                          .sub(/[?.!,;]?$/, '')
                          .capitalize
         pr_author = github.pr_author
-        pr_author_url = "https://github.com/#{github.pr_author}"
+        pr_author_url = github.is_a?(PRMetadata) ? github.author_url : "https://github.com/#{github.pr_author}"
         "* [##{pr_number}](#{pr_url}): #{pr_title} - [@#{pr_author}](#{pr_author_url})."
       end
 
@@ -75,21 +79,21 @@ module Danger
 
       # checks whether line contains a MARKDOWN  link to a PR
       def self.with_pr_link?(line)
-        return true if line =~ %r{\[\#\d+\]\(https?://github\.com/.*\d+/?\)}
+        return true if PR_LINK.match?(line)
 
         false
       end
 
-      # checks whether line contains a capitalized Text, treated as a description
+      # Checks for a description starting with uppercase or uncased text, code, or a symbol.
       def self.with_changelog_description?(line)
-        return true if line =~ /[`[:upper:]].*/
+        return true if DESCRIPTION_START.match?(line)
 
         false
       end
 
       # checks whether line contains a MARKDOWN  link to an author
       def self.with_author_link?(line)
-        return true if line =~ %r{\[@#{AUTHOR_NAME}\]\(https?://github\.com/.*#{AUTHOR_NAME}/?\)}
+        return true if line =~ %r{\[@#{AUTHOR_NAME}\]\(https?://(?:github\.com/.*#{AUTHOR_NAME}|gitlab\.com/#{AUTHOR_NAME})/?\)}
 
         false
       end

data/lib/changelog/changelog_line/changelog_header_line.rb

@@ -2,21 +2,23 @@ module Danger
   module Changelog
     # A CHANGELOG.md line represents the version header.
     class ChangelogHeaderLine < ChangelogLine
-      OPEN_PARENS = /[(\[{]?/.freeze
-      CLOSE_PARENS = /[)\]}]?/.freeze
+      OPEN_PARENS = /[(\[{]?/
+      CLOSE_PARENS = /[)\]}]?/
 
-      HASHES = /\#{1,4}/.freeze
-      SEMVER = /(?<semver>(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?)/.freeze
-      ISO8601_DATETIME = %r{(?<datetime>([0-9]{4})[-/]?(1[0-2]|0?[1-9])[-/]+(3[01]|0?[1-9]|[12][0-9])(T[0-9]{2}:[0-9]{2}:[0-9]{2})?Z?)}.freeze
+      HASHES = /\#{1,4}/
+      SEMVER = /(?<semver>(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?)/
+      RELAXED_VERSION = /(?:0|[1-9]\d*)(?:\.(?:0|[1-9]\d*))+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?/
+      ISO8601_DATETIME = %r{(?<datetime>([0-9]{4})[-/]?(1[0-2]|0?[1-9])[-/]+(3[01]|0?[1-9]|[12][0-9])(T[0-9]{2}:[0-9]{2}:[0-9]{2})?Z?)}
 
       def valid?
         stripped_line = line.strip
+        version = config.strict_semver ? SEMVER : RELAXED_VERSION
 
-        m = stripped_line.match(/^#{HASHES}\s#{OPEN_PARENS}[\w\s:]*#{CLOSE_PARENS}$/) # title
-        m ||= stripped_line.match(/^#{HASHES}\s#{OPEN_PARENS}#{SEMVER}#{CLOSE_PARENS}$/) # semver only
-        m ||= stripped_line.match(/^#{HASHES}\s#{OPEN_PARENS}#{SEMVER}#{CLOSE_PARENS}[\s-]+#{OPEN_PARENS}(#{ISO8601_DATETIME}|\w*)#{CLOSE_PARENS}$/) # semver and ISO 8601 date & time or next version description
+        m = title_valid?(stripped_line) # title
+        m ||= stripped_line.match(/^#{HASHES}\s#{OPEN_PARENS}#{version}#{CLOSE_PARENS}$/) # version only
+        m ||= stripped_line.match(/^#{HASHES}\s#{OPEN_PARENS}#{version}#{CLOSE_PARENS}[\s-]+#{OPEN_PARENS}(#{ISO8601_DATETIME}|#{labels})#{CLOSE_PARENS}$/) # version and date or next version description
 
-        !m.nil? && balanced?(stripped_line)
+        !!m && balanced?(stripped_line)
       end
 
       def self.validates_as_changelog_line?(line)
@@ -24,6 +26,20 @@ module Danger
 
         false
       end
+
+      private
+
+      def labels
+        config.unreleased_labels ? Regexp.union(config.unreleased_labels) : /\w*/
+      end
+
+      def title_valid?(title)
+        if config.unreleased_labels && (match = title.match(/^#{HASHES}\s[(\[{](.*)[)\]}]$/))
+          config.unreleased_labels.include?(match[1])
+        else
+          title.match?(/^#{HASHES}\s#{OPEN_PARENS}[\w\s:]*#{CLOSE_PARENS}$/)
+        end
+      end
     end
   end
 end

data/lib/changelog/changelog_line/changelog_line.rb

@@ -2,13 +2,15 @@ module Danger
   module Changelog
     # An abstract CHANGELOG.md line.
     class ChangelogLine
-      NON_DELIMITERS = /[^(){}\[\]]*/.freeze
-      PAIRED = /\(#{NON_DELIMITERS}\)|\{#{NON_DELIMITERS}\}|\[#{NON_DELIMITERS}\]/.freeze
-      DELIMITER = /[(){}\[\]]/.freeze
+      NON_DELIMITERS = /[^(){}\[\]]*/
+      PAIRED = /\(#{NON_DELIMITERS}\)|\{#{NON_DELIMITERS}\}|\[#{NON_DELIMITERS}\]/
+      DELIMITER = /[(){}\[\]]/
 
       attr_accessor :line, :validation_result
+      attr_reader :config
 
-      def initialize(line)
+      def initialize(line, config: Danger::Changelog.config.with)
+        @config = config
         self.line = line
         self.validation_result = nil
       end

data/lib/changelog/changelog_line/changelog_line_parser.rb

@@ -7,18 +7,20 @@ module Danger
     # A parser of the CHANGELOG.md lines
     class ChangelogLineParser
       # Returns an instance of Changelog::ChangelogLine class based on the given line
-      def self.parse(line)
+      def self.parse(line, config: Danger::Changelog.config.with)
+        return ChangelogPlaceholderLine.new(line, config: config) if ChangelogPlaceholderLine.validates_as_changelog_line?(line, config: config)
+
         changelog_line_class = available_changelog_lines.find do |changelog_line|
           changelog_line.validates_as_changelog_line?(line)
         end
         return nil unless changelog_line_class
 
-        changelog_line_class.new(line)
+        changelog_line_class.new(line, config: config)
       end
 
       def self.available_changelog_lines
         # Order is important
-        [ChangelogPlaceholderLine, ChangelogEntryLine, ChangelogHeaderLine]
+        [ChangelogEntryLine, ChangelogHeaderLine]
       end
 
       private_class_method :available_changelog_lines

data/lib/changelog/changelog_line/changelog_placeholder_line.rb

@@ -3,11 +3,11 @@ module Danger
     # A CHANGELOG.md line represents the "Your contribution here".
     class ChangelogPlaceholderLine < ChangelogLine
       def valid?
-        ChangelogPlaceholderLine.validates_as_changelog_line?(line)
+        ChangelogPlaceholderLine.validates_as_changelog_line?(line, config: config)
       end
 
-      def self.validates_as_changelog_line?(line)
-        return true if line == Danger::Changelog.config.placeholder_line
+      def self.validates_as_changelog_line?(line, config: Danger::Changelog.config)
+        return true if line == config.placeholder_line
 
         false
       end