git:20260413.0fe31cc to git:20260424.546cf9a

- This is a project-local maintainer skill for `agent-tty` releases. The canonical human policy lives in [`docs/RELEASE-PROCESS.md`](../../../docs/RELEASE-PROCESS.md); use this skill as the execution checklist when an agent is asked to cut or publish a release from this repository.

- 3. Verify GitHub CLI access with a real API call:

- 4. Prefer `mise run ci` when `mise` is available; otherwise use `npm run verify`.

-

- ## Prepare the version bump

-

- Start from fresh `main`:

-

- ```bash

- git checkout main

- git pull origin main

- ```

-

- Create a release branch and bump without tagging.

-

- Stable patch release example:

-

- ```bash

- git switch -c release/0.1.1

- npm version patch --no-git-tag-version

- ```

-

- First beta on the next patch line:

-

- ```bash

- git switch -c release/0.1.1-beta.0

- npm version prepatch --preid beta --no-git-tag-version

- ```

-

- Next beta on the same line:

-

- ```bash

- npm version prerelease --preid beta --no-git-tag-version

- ```

-

- Then validate and commit the pure version bump:

-

- ```bash

- npm run verify

- npm run version:json

- git add package.json package-lock.json

- git commit -m "chore(release): <version>"

- ```

-

- ## Create the release PR

-

- ```bash

- git push -u origin <release-branch>

- gh pr create --base main --head <release-branch> --title "chore(release): <version>"

- ```

-

- Before creating the PR, check whether one already exists for the release branch:

-

- ```bash

- gh pr list --head <release-branch> --state all

- ```

-

- ## Wait for CI and merge the PR

-

- Interactive waiting is fine with:

-

- ```bash

- gh pr checks <pr-number> --watch

- ```

-

- For automation or agent-driven waiting, prefer structured workflow inspection:

-

- ```bash

- gh pr checks <pr-number>

- gh run list --branch <release-branch> --event pull_request --limit 5

- gh run view <run-id> --json status,conclusion,jobs

- ```

-

- Merge the PR only after the required checks succeed.

-

- Normal merge path:

-

- ```bash

- gh pr merge <pr-number> --squash --delete-branch

- ```

-

- If branch policy still blocks the merge after checks pass and an authorized releaser is allowed to override it:

-

- ```bash

- gh pr merge <pr-number> --squash --admin --delete-branch

- ```

-

- If remote refs look stale after the merge, refresh them before checking `origin/main` or deleted release branches:

-

- ```bash

- git fetch origin --prune

- ```

-

- ## Tag and publish the release

-

- Default to the documented tag flow unless the user explicitly asks for the GitHub CLI shortcut.

-

- Documented flow:

-

- ```bash

- git checkout main

- git pull origin main

- git tag -a vX.Y.Z -m "vX.Y.Z"

- git push origin vX.Y.Z

- ```

-

- If you are explicitly asked to create the tag and GitHub Release with `gh`, use the merged `main` commit SHA:

-

- ```bash

- MERGED_SHA=<merge-commit-on-main>

- gh release create vX.Y.Z \

- --target "$MERGED_SHA" \

- --title vX.Y.Z \

- --notes-file <notes-file>

- ```

-

- For prereleases, also add:

-

- ```bash

- --prerelease --latest=false

- ```

-

- The release workflow should publish the verified tarball to both GitHub Releases and npm.

-

- ## Verify the published npm package

-

- Run the installed CLI under Node 24:

-

- ```bash

- PACKAGE_NAME='agent-tty'

- PACKAGE_VERSION='<version>'

- NODE_BIN=${NODE_BIN:-node}

- INSTALL_PREFIX=$(mktemp -d)

- AGENT_TTY_HOME=$(mktemp -d)

-

- npm view "$PACKAGE_NAME" dist-tags --json

- npm install -g --prefix "$INSTALL_PREFIX" "$PACKAGE_NAME@$PACKAGE_VERSION"

- "$NODE_BIN" "$INSTALL_PREFIX/bin/agent-tty" version --json | jq -r '.result.cliVersion'

- "$NODE_BIN" "$INSTALL_PREFIX/bin/agent-tty" --home "$AGENT_TTY_HOME" doctor --json | jq '.result.ok'

- ```

-

- For prereleases, also confirm the expected dist-tag points at the exact version.

-

- ## Verify the published GitHub Release assets

-

- ```bash

- VERSION=<version>

- RELEASE_TAG="v${VERSION}"

- RELEASE_TGZ="agent-tty-${VERSION}.tgz"

- NODE_BIN=${NODE_BIN:-node}

-

- DOWNLOAD_DIR=$(mktemp -d)

- INSTALL_PREFIX=$(mktemp -d)

- AGENT_TTY_HOME=$(mktemp -d)

- gh release download "$RELEASE_TAG" --repo coder/agent-tty --dir "$DOWNLOAD_DIR" --pattern "$RELEASE_TGZ"

- gh release download "$RELEASE_TAG" --repo coder/agent-tty --dir "$DOWNLOAD_DIR" --pattern "${RELEASE_TGZ}.sha256"

- (

- cd "$DOWNLOAD_DIR"

- sha256sum -c "${RELEASE_TGZ}.sha256"

- )

- npm install -g --prefix "$INSTALL_PREFIX" "$DOWNLOAD_DIR/$RELEASE_TGZ"

- "$NODE_BIN" "$INSTALL_PREFIX/bin/agent-tty" version --json | jq -r '.result.cliVersion'

- "$NODE_BIN" "$INSTALL_PREFIX/bin/agent-tty" --home "$AGENT_TTY_HOME" doctor --json | jq '.result.ok'

- ```

- ## Failure recovery checklist