---
name: deps-update
description: "依存関係の定期更新: cargo/npm 更新 → ローカル検証 → chore(deps) PR 作成 → CI グリーン確認（カテゴリ C 相当時は e2e ラベル付与・E2E/smoke 完了確認）。マージは手動。Cargo/npm の依存をまとめて更新したいときに使用。"
disable-model-invocation: true
argument-hint: "[cargo | npm | 空=両方]"
allowed-tools:
  - Bash(cargo *)
  - Bash(npm *)
  - Bash(git *)
  - Bash(gh *)
  - Read
  - Edit
  - Grep
  - Glob
---

cargo / npm の依存関係を一括更新し、ローカル検証 → PR 作成 → CI グリーン確認まで行う。マージはしない（人間が判断する）。

対象: $ARGUMENTS（`cargo` / `npm` / 空=両方）

## Step 1 -- 前提確認

- `git status` で作業ツリーが clean か確認する。未コミットの変更がある場合、停止してユーザーに整理を促す
- `git fetch` して `main` を最新化する
- `main` から `chore/deps-YYYYMMDD` ブランチを作成する（`YYYYMMDD` は当日の日付。`CLAUDE.md` の「`main` 直コミット禁止」を遵守）

## Step 2 -- 更新

- `$ARGUMENTS` の対象に応じて依存を更新する:
  - `cargo` または空: `cargo update`
  - `npm` または空: `npm update`
- 更新後に `git diff Cargo.lock` / `git diff package-lock.json` で差分を確認し、更新されたクレート・パッケージを列挙する
- 各更新を **minor/patch と major に分類**して記録する（major = メジャーバージョン番号が変わったもの）

## Step 3 -- ローカル検証（最大5サイクル）

`docs/build-commands.md` を SSOT として参照し、以下のカテゴリを実行する:

- カテゴリ A: 必須＋追加検証（Rust 全 crate チェック・clippy・core テスト）
- カテゴリ B: 必須（TypeScript 型チェック・フロントエンドビルド）
- カテゴリ C: フロントユニットテスト（Vitest）のみ

E2E・スモークテストはローカルで実行せず、PR に **`e2e` ラベルを付与**して `E2E & Smoke` workflow（`e2e.yml`）に委ねる。**通常 PR CI（`ci.yml`）では smoke/E2E は走らない**ため、ラベル付与を忘れると検証されない。具体的なコマンド文字列は `docs/build-commands.md` を参照する（二重メンテを避けるためこの SKILL に書かない）。

検証が失敗した場合:

- エラー出力を読み、原因を特定する
- 修正し、失敗したステップから再検証する
- clippy 警告・型エラー・軽い API 追従はこのスキルで直す

以下のいずれかに当たったら**中止する**:

- **実ロジックの大幅な書き換えを要する破壊的変更**に当たった
- 5サイクル後もエラーが残る

中止する場合は、診断サマリー（試みた内容・残存エラー・推定根本原因）を書いて停止する。**PR は作らない（Step 4・5 へ進まない）。調査用にブランチは残す。**

## Step 4 -- コミット & PR

- このスキルで生じた変更（`Cargo.lock`・`package-lock.json`・修復した実コード等）のみをステージする
- `chore(deps): ...` の conventional commit を作成する。何を更新したかの簡潔な要約を含める
- push して `gh pr create` で PR を作成する
- PR 本文に更新一覧を載せる。**major bump は ⚠ で明示する**
- 依存更新がカテゴリ C 相当（Tauri 本体・WebView・ウィンドウ/ホットキー関連クレート等）に影響しうる場合は `gh pr edit --add-label e2e` でラベルを付与し、`E2E & Smoke` workflow を起動する

## Step 5 -- CI ポーリング

- `gh pr checks` で CI の完了まで待機する
- コマンド自体がエラーになる場合（PR がまだ index されていない等）は少し待って再試行する
- `e2e` ラベルを付与した場合は `E2E & Smoke` workflow の完了も待つ（`ci.yml` とは別 workflow のため `gh pr checks` に両方が現れる）

## Step 6 -- 報告

以下を報告する:

1. 更新されたクレート・パッケージ一覧（minor/patch と major を区別）
2. ローカル検証の結果（修復サイクルがあればその内容）
3. PR の URL
4. CI の結果 -- 緑なら「マージ可能」、赤なら失敗したチェックとログ

**いずれの場合もマージはせず停止する。** マージはユーザーが判断する。

Step 3 で検証が中止された場合（破壊的変更、または5サイクル超過）は、PR の代わりに診断サマリー（試みた内容・残存エラー・推定根本原因）を出力する。