---
name: release
description: Release vercel-plugin — run gates, bump version, generate artifacts, commit, and push. Use when asked to "release", "ship", "bump and push", or "cut a release".
---

# Release

End-to-end release workflow for vercel-plugin.

## Workflow

### 1. Pre-flight checks

Run all gates in parallel:

```bash
bun run typecheck          # tsc --noEmit on hooks/src
bun test                   # all test files
bun run validate           # skill frontmatter + manifest integrity
```

**Stop if any gate fails.** Fix issues before proceeding.

### 2. Determine version bump

Read the current version from `.plugin/plugin.json`. Ask the user which semver component to bump if not specified:

| Bump  | When                                      |
|-------|-------------------------------------------|
| patch | Bug fixes, test/fixture updates, docs     |
| minor | New skills, new hooks, new features       |
| major | Breaking changes to hook API or skill map |

Default to **patch** if the user says "release" without specifying.

### 3. Bump version

Update the `version` field in `.plugin/plugin.json`. This is the **only** version source of truth.

### 4. Rebuild generated artifacts

```bash
bun run build              # hooks (tsup) + manifest
```

This compiles `hooks/src/*.mts` → `hooks/*.mjs` and regenerates `generated/skill-manifest.json`.

### 5. Stage, commit, and push

```bash
git add -A
git commit -m "<summary>; bump to <new-version>"
git push
```

Commit message style: match existing convention — descriptive summary followed by `; bump to X.Y.Z` (see git log for examples).

The pre-commit hook will re-run typecheck and recompile hooks automatically. If it fails, fix the issue and create a **new** commit (never amend).

## Version source of truth

`.plugin/plugin.json` — the `version` field. There is no `package.json` version to sync.

## Checklist (copy into your reasoning)

- [ ] typecheck passes
- [ ] tests pass
- [ ] validate passes
- [ ] `.plugin/plugin.json` version bumped
- [ ] `bun run build` succeeded
- [ ] commit includes all changes
- [ ] pushed to main