cliff.toml

[changelog]
header = "# Changelog\n\nAll notable changes to Basalt are documented here.\n"
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 | striptags | trim | upper_first }}
    {% for commit in commits %}
        - {{ commit.message | upper_first }}
    {% endfor %}
{% endfor %}\n
"""
trim = true

[git]
conventional_commits = true
filter_unconventional = true
split_commits = false
commit_parsers = [
    # Skip non-user-facing commits
    { message = "^(chore|ci|test|bench)", skip = true },

    # Group by crate/domain (matched via scope in commit message)
    { message = "\\(server", group = "Server" },
    { message = "\\(net", group = "Networking" },
    { message = "\\(protocol", group = "Protocol" },
    { message = "\\(types", group = "Types" },
    { message = "\\(derive", group = "Derive Macros" },
    { message = "\\(world", group = "World" },
    { message = "\\(ecs", group = "ECS" },
    { message = "\\(api", group = "Plugin API" },
    { message = "\\(core", group = "Core" },
    { message = "\\(command", group = "Commands" },
    { message = "\\(events", group = "Events" },
    { message = "\\(storage", group = "Storage" },
    { message = "\\(testkit", group = "Test Kit" },
    { message = "\\(physics", group = "Physics Plugin" },
    { message = "\\(item", group = "Item Plugin" },
    { message = "\\(container", group = "Container Plugin" },
    { message = "\\(chat", group = "Chat Plugin" },
    { message = "\\(block", group = "Block Plugin" },
    { message = "\\(lifecycle", group = "Lifecycle Plugin" },
    { message = "\\(movement", group = "Movement Plugin" },
    { message = "\\(codegen", group = "Code Generation" },
    { message = "\\(deps", group = "Dependencies" },
    { message = "\\(docs|\\(claude", group = "Documentation" },

    # Catch-all
    { message = ".*", group = "Other" },
]
tag_pattern = "v[0-9]*"
sort_commits = "oldest"