changeset_requires_path

The <since>...HEAD diff must add (git status A) at least one path matching add_glob: — the “did you add a changelog entry?” gate. Three corpus signals: prettier’s changelog_unreleased/, cpython’s Misc/NEWS.d/next/, pnpm’s .changeset/*.md. since: (the base ref) is required — the rule asserts about the set of files a contribution adds, so it’s diff-scoped. An optional when_changed: gates the requirement on some other glob having changed (don’t demand a changelog for a docs-only PR); with no gate, any non-empty changeset triggers it. Builds on the same <since>...HEAD three-dot (merge-base) diff as alint check --changed. Silent no-op outside a git repo or when nothing relevant changed; a since: that fails to resolve hard-fails with a shallow-clone hint.

---

Options

Option	Type	Required	Default	Description
add_glob	string	yes		Glob; the diff must ADD at least one path matching it.
since	string	yes		Base ref for the <since>...HEAD diff. Use the canonical {{env.X}} interpolation, e.g. since: "{{env.ALINT_BASE_SHA | default('origin/main')}}".
when_changed	string		null	Optional gate: only require the add when some path matching this glob changed (any status). Omit to require it on any non-empty changeset.

Plus the common level, id, and when fields. This rule analyses the whole repository, so it takes no paths. This table is generated from the JSON Schema; option types and defaults are authoritative.

Example

A code change with no changeset entry

The rule fires on this repository:

src/
src/lib.rs

With this .alint.yml:

version: 1
rules:
  - id: needs-changeset
    kind: changeset_requires_path
    add_glob: ".changeset/*.md"
    since: HEAD~1
    level: error

committed with this history (oldest first):

chore: base
feat: add feature  (adds src/lib.rs)

A code change with its changeset entry

This repository is compliant:

.changeset/
.changeset/add-feature.md
src/
src/lib.rs

With this .alint.yml:

version: 1
rules:
  - id: needs-changeset
    kind: changeset_requires_path
    add_glob: ".changeset/*.md"
    since: HEAD~1
    level: error

committed with this history (oldest first):

chore: base
feat: add feature  (adds src/lib.rs, .changeset/add-feature.md)