mjcreativelab Smart Git Sync
assets/git-sync.sh を読み込んで実行する。
zsh ではインライン実行しないこと（正規表現がグロブ展開されるため）。
一時ファイルに書き出して bash で実行するか、bash /dev/stdin 経由で渡す。
一時ファイルの明示削除は不要（OS の一時領域に任せる）。
出力の解釈と対応
スクリプトは構造化された出力を返す。以下の順序で解釈する:
早期終了ケース
UNCOMMITTED_CHANGES=true→ ユーザーに未コミット変更の一覧を見せ、続行するか確認する。続行する場合はSKIP_UNCOMMITTED_CHECK=1を環境変数に設定してスクリプトを再実行するPULL_FAILED=true→PULL_ERRORの内容を表示し、原因（コンフリクト等）と対処法を案内する。スクリプトの再実行はしない
正常完了ケース
DELETE_CANDIDATES=none→ 「削除対象のマージ済みブランチはありません」と報告DELETE_CANDIDATESにブランチ一覧がある場合 → 一覧を表示しユーザーに確認。WORKTREE_CANDIDATESに同じブランチ名のmerged|<branch>|<path>エントリがあれば worktree パスを併記する。承認後、worktree が紐づくブランチはgit worktree remove <path>→git branch -d <branch>の順で、紐づかないブランチは従来どおりgit branch -d <branch>のみで削除するGONE_CANDIDATESにブランチ一覧がある場合 → 「リモートで削除済み」として一覧を表示しユーザーに確認。WORKTREE_CANDIDATESに同じブランチ名のgone|<branch>|<path>エントリがあれば worktree パスを併記する。承認後、worktree が紐づくブランチはgit worktree remove <path>→git branch -D <branch>の順で、紐づかないブランチは従来どおりgit branch -D <branch>のみで削除するSQUASH_CANDIDATESにブランチ一覧がある場合 → 「squash マージ済み（未マージ扱い）」として一覧を表示しユーザーに確認。WORKTREE_CANDIDATESに同じブランチ名のsquash|<branch>|<path>エントリがあれば worktree パスを併記する。承認後、worktree が紐づくブランチはgit worktree remove <path>→git branch -D <branch>の順で、紐づかないブランチは従来どおりgit branch -D <branch>のみで削除する- 最後に
BRANCH,RECENT_COMMITS,REMAINING_BRANCHESを使って結果を報告する
補助情報
SWITCHING_FROM=<branch>→ 元のブランチ名。報告に含めると親切ALREADY_ON_DEFAULT=true→ すでにデフォルトブランチにいた旨を報告WORKTREE_SKIPPEDにブランチ一覧がある場合 → 「未コミット変更が残っているため worktree 削除をスキップしたブランチ」として報告に含める（削除はしない）
削除時の注意
- マージ済みブランチ (
DELETE_CANDIDATES) →git branch -d（安全な削除） - リモート削除済み・squash マージ済みブランチ (
GONE_CANDIDATES,SQUASH_CANDIDATES) →git branch -D（強制削除） - 3種類を分けて表示し、それぞれ個別にユーザー確認を取ること
- 一括削除ではなく種類ごとに確認・削除を行う
- worktree が紐づく削除候補は、先に
git worktree remove <path>を実行してから ブランチを削除する（逆順だと worktree で使用中のためブランチ削除が失敗する） - worktree 内に未コミット変更が残っている場合は
WORKTREE_SKIPPEDとして自動的に削除候補から除外されている（git worktree remove自体も未コミット変更があれば失敗するため、tracked/staged な変更に対しては二重に安全）。ただしこの検出はgit status --porcelainベースで.gitignoreされたファイル（.envやnode_modules等）までは見ていない — そうしたファイルしか無い worktree は「クリーン」と判定され、git worktree removeはディレクトリごと削除するためこれらのファイルも失われる（どちらの安全層でもカバーされない）。なお/smart-issue-resolve --worktree等が worktree 内に置く作業ディレクトリ.smart-issue-work/（context.md / impl-notes.md / diff.md 等）も同じ扱いだが、これは worktree と寿命を共にする設計で意図どおり - main worktree・現在の worktree は候補に含まれない
WORKTREE_SKIPPEDに挙がっているブランチ、またはgit branch -d/-Dが「used by worktree」等のエラーで失敗したブランチは、リトライせずそのブランチの削除だけをスキップする。どのブランチをなぜスキップしたか（worktree の未コミット変更 / 未検出の別 worktree で使用中）をユーザーに報告する