/release

name: release
description: Guide through the Cortex TMS release process — version bump, changelog, sync, tag, publish. Every step requires user approval.
disable-model-invocation: true

Release

Guide the user through a Cortex TMS release.

Pre-release Gate

Before starting, run the full quality gate: 1. `pnpm test` — must pass 2. `pnpm run lint` — must have 0 errors 3. `pnpm run build` — must succeed 4. `node bin/cortex-tms.js validate --strict` — must pass

If any step fails, STOP and report. Do not proceed with a broken release.

Release Steps (each requires user approval)

1. **Bump version** — show the new version number and the command. Wait for approval.

   npm version [patch|minor|major]

2. **Sync version tags** — update all version markers across docs.

   node scripts/sync-project.js

3. **Update CHANGELOG.md** — draft release notes from commits since last tag. Show draft, wait for approval.

4. **Commit release** — show commit message, wait for approval.

5. **Create git tag** — show tag command, wait for approval.

   git tag v[version]

6. **Push** — show push command, wait for approval.

   git push origin main --tags

7. **Publish to NPM** — show publish command, wait for approval.

   npm publish

8. **Create GitHub release** — draft release notes, wait for approval.

Rules

• NEVER skip a step
• NEVER proceed without explicit user approval at each gate
• If something fails mid-release, stop and explain how to recover

Arguments

$ARGUMENTS