# Deterministic changelog generator

A dependency-free Python CLI that reads local Git history since the latest tag and generates a structured `CHANGELOG.md`. It does not call an LLM or send repository data over the network.

## Use

```bash
./changelog.sh --repo . --version 1.2.0
```

Use `--from REV`, `--to REV`, `--repo-url URL`, `--output FILE`, or `--stdout` as needed. Conventional commits are classified directly; conservative keyword fallbacks handle ordinary subjects. Merge commits are excluded to avoid duplicate release entries.

## Test

```bash
python3 -m unittest discover -s tests -v
```

## Behavior

- Uses the latest reachable Git tag as the default starting revision.
- Excludes merge commits to avoid duplicate release entries.
- Supports Conventional Commits plus conservative keyword fallbacks.
- Produces deterministic section ordering: Added, Fixed, Changed, Removed.
- Reads only local Git history and has no network or third-party dependency.
- Use `--stdout` to preview without writing a file.

## Reproducible sample

`examples/SAMPLE_CHANGELOG.md` is generated from explicit fixture commits. The integration tests independently create a real temporary Git repository, tag its first release, add later commits, invoke `changelog.sh`, and verify that only post-tag commits appear.

## Install as a project-local skill

```bash
./install.sh /path/to/repository
```

This copies the tool and `SKILL.md` into `.constalabs/generate-changelog/` in the target repository. Preview with `.constalabs/generate-changelog/changelog.sh --repo . --stdout`; no global files or credentials are changed.