release

リリースワークフロー

@m1heng-clawd/feishu の新しいバージョンを npm に公開し、GitHub リリースを作成します。

前提条件

• ワーキングツリーがクリーンである（すべての変更が main にコミット済み）
• @m1heng-clawd スコープへの公開権限を持つ npm login セッションが有効である
• gh CLI が認証済みである

手順

1. バージョンの更新幅を決定する

前回のリリース以降に変更された内容を確認します。

# Find latest release tag
gh release list --limit 1

# Review commits and diff stat
git log <last-tag>..HEAD --oneline
git diff <last-tag>..HEAD --stat

更新幅を選択します。patch（バグ修正）、minor（新機能）、または major（破壊的変更）。

2. 型チェック

npx tsc --noEmit

型チェックに失敗した場合は、絶対に続行しないでください。

3. リリースノートの下書きを作成する

差分全体を確認し、リリースノートを作成します。

git diff <last-tag>..HEAD

まず GitHub リリースの下書きを作成します。

gh release create v<new-version> --draft --title "v<new-version>" --target main --notes "<release notes markdown>"

4. package.json のバージョンを更新する

package.json を編集し、"version" フィールドを <new-version> に更新します。

5. コミット、タグ付け、プッシュ

git add package.json
git commit -m "chore: bump version to <new-version>"
git tag v<new-version>
git push && git push --tags

6. npm に公開する

npm publish

認証に失敗した場合は、まず npm login を実行するようユーザーに依頼し、その後再試行してください。

7. GitHub リリースを公開する

gh release edit v<new-version> --draft=false

リリースノートの形式

確立された形式に従ってください（参考として過去のリリースを確認してください）。

## Features

- **Feature title** — Description. (#PR)

## Bug Fixes

- **Fix title** — Description. (#PR)

## Internal

- Internal change description.

トラブルシューティング

npm publish の 404 エラー／認証エラー

npm login          # re-authenticate
npm whoami         # verify logged in
npm publish        # retry

タグがすでに存在する

公開に失敗したもののタグが作成済みの場合は、修正後にタグを削除して作成し直します。

git tag -d v<version>
git push origin :refs/tags/v<version>
# fix issue, then re-tag and push