cliff.toml

# git-cliff configuration for la-stack
# https://git-cliff.org/docs/configuration

[changelog]
# Keep a Changelog header
header = """
# Changelog\n
All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n
"""

# Tera template for each release section.
#
# Release sections are generated from commit ranges. Angle brackets in commit
# text are escaped so Rust generics like Foo<T> do not render as HTML tags on
# GitHub.
body = """
{% if version -%}
    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
{% else -%}
    ## [Unreleased]
{% endif -%}
{% for group, commits in commits | group_by(attribute="group") %}
    ### {{ group | upper_first }}
    {% for commit in commits %}
        - {% if commit.breaking %}[**breaking**] {% endif %}\
            {{ commit.message | split(pat="\n") | first | upper_first | trim | replace(from="<", to="&lt;") | replace(from=">", to="&gt;") }} \
            [`{{ commit.id | truncate(length=7, end="") }}`]\
            (https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}\
            /commit/{{ commit.id }})
        {%- if commit.body and group != "Dependencies" %}

        {{ commit.body | replace(from="<", to="&lt;") | replace(from=">", to="&gt;") | indent(prefix="  ", first=true) }}
        {%- endif %}
    {%- endfor %}
{% endfor %}\n

"""

# Compare-link footer (requires [remote.github] below)
footer = """
{% for release in releases -%}
    {% if release.version -%}
        {% if release.previous.version -%}
            [{{ release.version | trim_start_matches(pat="v") }}]: \
                https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}\
                /compare/{{ release.previous.version }}...{{ release.version }}
        {% else -%}
            [{{ release.version | trim_start_matches(pat="v") }}]: \
                https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}\
                /tree/{{ release.version }}
        {% endif -%}
    {% else -%}
        [Unreleased]: https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}\
            /compare/{{ release.previous.version }}...HEAD
    {% endif -%}
{% endfor -%}
"""

trim = true
# Collapse 3+ consecutive newlines into exactly 2 (one blank line).
# This prevents MD012 violations from Tera template whitespace artifacts.
postprocessors = [
    { pattern = '\n{3,}', replace = "\n\n" },
]

[git]
conventional_commits = true
# Include non-conventional commits so we capture the full history
# (mixed styles: "feat:", "Changed:", plain merge commits, dependency bumps).
filter_unconventional = false
filter_commits = false
protect_breaking_commits = true
tag_pattern = "v[0-9]*"
topo_order = false
sort_commits = "oldest"

# Link (#N) references to GitHub PRs before rendering.
# NOTE: The repo path is hardcoded here because commit_preprocessors run before
# Tera template rendering, so {{ remote.github.owner }} variables are not
# available. The body/footer templates above do use the remote.github variables.
commit_preprocessors = [
    { pattern = '(?m)^Closes #\d+\n\n', replace = "" },
    { pattern = '\(#(\d+)\)', replace = '[#${1}](https://github.com/acgetchell/la-stack/pull/${1})' },
]

commit_parsers = [
    # Skip merge commits and release-prep noise from the changelog body.
    { message = "^Merge pull request", skip = true },
    { message = "^Merge branch", skip = true },
    { message = '(?i)^(chore(:|\(release\):) |Changed: )?(prepare|release) v[0-9]', skip = true },

    # Dependency bumps: keep all bump commits so archived release history
    # preserves CI/action/tooling dependency updates as well as Rust crates.
    { message = "^chore\\(deps\\): bump ", group = "Dependencies" },
    { message = "(?i)^bump\\s+(deps?\\b|dependencies\\b|[A-Za-z0-9_.-]+/[A-Za-z0-9_./-]+|[A-Za-z0-9_.-]+\\s+from\\s+)", group = "Dependencies" },

    # Conventional commit types
    { message = "^feat", group = "Added" },
    { message = "^fix", group = "Fixed" },
    { message = "^perf", group = "Performance" },
    { message = "^refactor", group = "Changed" },
    { message = "^docs?", group = "Documentation" },
    { message = "^test", group = "Changed" },
    { message = "^style", group = "Changed" },
    { message = "^build", group = "Maintenance" },

    # Non-conventional patterns used in la-stack history
    { message = "(?i)^add", group = "Added" },
    { message = "(?i)^support", group = "Added" },
    { message = "(?i)^implement", group = "Added" },
    { message = "(?i)^deprecate", group = "Deprecated" },
    { message = "(?i)^remove", group = "Removed" },
    { message = "(?i)^delete", group = "Removed" },
    { message = "(?i)^change", group = "Changed" },
    { message = "(?i)^update", group = "Changed" },
    { message = "(?i)^fix", group = "Fixed" },

    # Chore / CI
    { message = "^chore|^ci", group = "Maintenance" },

    # Catch-all
    { message = ".*", group = "Changed" },
]

[remote.github]
owner = "acgetchell"
repo = "la-stack"