releaselisted
Install: claude install-skill rooterkyberian/clownhead
# Releasing clownhead
clownhead is installed straight from git (`uv tool install git+https://github.com/rooterkyberian/clownhead`),
so there is no package index step.
A release is a version bump, a tag, and notes worth reading.
## 1. Start from a green main
History on `main` is linear and committed to directly — no branch, no PR.
```bash
git switch main && git pull --ff-only
git status --short
```
Anything uncommitted is either part of this release or should be dropped before it starts.
Then run the checks:
```bash
mise run check
```
That is lint, typecheck and tests.
`mise` installs its own toolchain and can fail on a sandboxed network before it ever reaches the project;
when it does, run the same four commands directly rather than releasing unchecked:
```bash
uv run ruff check . && uv run ruff format --check . && uv run mypy && uv run pytest
```
## 2. Pick the number
Pre-1.0, so the minor is where breakage goes:
- **minor** (`0.2.0` → `0.3.0`) — a command or flag removed or renamed,
a default flipped,
anything that changes what an existing invocation does.
- **patch** (`0.3.0` → `0.3.1`) — fixes and additions that leave every existing invocation alone.
`git log --oneline $(git describe --tags --abbrev=0)..HEAD` is what is being released.
## 3. Bump all three
The version lives in three files and they must move together:
- `pyproject.toml` — `[project] version`
- `src/clownhead/__init__.py` — `__version__`, which is what `clownhead --version` answers
- `uv