Pactkit Release

---
name: pactkit-release
description: "Version release: snapshot, archive, Git tag, and GitHub Release"
---

# PactKit Release

Version release management — update versions, snapshot architecture, create Git tags, and publish GitHub Releases.

## When Invoked
- **`/project-release` command**: VERSION is passed explicitly from the command's pre-flight check.
- **Standalone / legacy path**: VERSION is not provided — auto-detected from `pyproject.toml`.

## Version Parameter
- If `VERSION` is provided (e.g., by `/project-release`): use it directly, skip auto-detection.
- If version is not provided: auto-detect by running `git diff HEAD~1 pyproject.toml | grep version` and extracting the new value.

## Protocol

### 1. Version Update
- Update the project's package manifest (e.g., `pyproject.toml`, `package.json`, `__init__.py`).
- Backfill Specs: run `pactkit backfill-release $VERSION` to replace `Release: TBD` in completed specs.

### 2. Architecture Snapshot
- Run `visualize` (all four modes: file, class, call, module).
- Run `snapshot "$VERSION"` via pactkit-board skill.
- Result: graphs saved to `docs/architecture/snapshots/{version}_*.mmd`.

### 2.5. Pre-Tag Gate (CRITICAL)
- Run lint: `pactkit lint` (falls back to `ruff check src/ tests/`).
- Run tests: `pactkit regression` (falls back to `pytest tests/ -q`).
- If either fails: **STOP. Do NOT tag.** Fix the issue, re-commit, then re-run this gate.
- Report: `Pre-tag gate: PASS` or `Pre-tag gate: FAIL (details)`.

### 3. Git Operations
- Run `archive` via pactkit-board skill.
- Commit: `git commit -am "chore(release): $VERSION"`.
- Tag: `git tag $VERSION`.

### 4. GitHub Release (Conditional)
- **Check config**: Read `pactkit.yaml` for `release.github_release`.
  - If `release.github_release: true`: proceed with GitHub Release creation.
  - If `release.github_release: false` or section missing: log "GitHub Release: SKIP — not configured" and stop.
- Extract the `[$VERSION]` section from `CHANGELOG.md` as release notes.
- Create a GitHub Release: `gh release create $VERSION --title "$VERSION" --notes "$NOTES"`.
- Verify: `gh release view $VERSION` confirms the release exists and is marked Latest.