feat(git-id-switcher): add event-driven sync check, settings, and i18n (#360)

Add syncCheck.enabled / syncCheck.onFocusReturn configuration settings,
integrate sync check into workspace folder change, config change, and
window focus return events (debounced 500ms), localize all sync check
UI strings to 17 languages, and document the feature in README (en/ja)
and CHANGELOG. Bump version to 0.17.0.

🖥️ IDE: [Cursor](https://cursor.sh)
🔌 Extension: [Claude Code](https://claude.ai/download)


Model-Raw: claude-opus-4-6-20250514

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: nullvariant

extensions/git-id-switcher/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.17.0] - 2026-03-18
+
+### Added
+
+- **Sync Check**: Real-time detection of mismatches between the selected profile and actual git config (`user.name`, `user.email`, `user.signingkey`). When a mismatch is detected, the status bar shows a ⚠️ warning with a clickable resolution flow (re-apply, select different profile, or dismiss)
+- **Sync Check settings**: `syncCheck.enabled` (default: `true`) and `syncCheck.onFocusReturn` (default: `true`) to control sync check behavior
+- **Event-driven sync check**: Automatically runs on profile apply, workspace folder change, configuration change, and window focus return (debounced 500ms)
+- **Localization**: All sync check UI strings translated to 17 languages (`package.nls` and `l10n/bundle.l10n`)
+
 ## [0.16.22] - 2026-03-17
 
 ### Security

extensions/git-id-switcher/README.md

@@ -49,6 +49,7 @@ While many Git identity switchers exist, **Git ID Switcher** solves the complex
 - **Identity (Profile) Management UI**: Add, edit, delete, and reorder identities without editing settings.json
 - **One-Click Identity Switch**: Instantly change Git user.name and user.email
 - **Status Bar Integration**: Always see your current identity (profile) at a glance
+- **Sync Check**: Real-time detection of mismatches between profile and git config, with status bar warning
 - **Submodule Support**: Automatically propagate identity to Git submodules
 - **SSH Key Management**: Automatically switch SSH keys in ssh-agent
 - **GPG Signing Support**: Configure GPG key for commit signing (optional)
@@ -291,6 +292,8 @@ You can also delete an identity from the command palette using `Git ID Switcher:
 | `gitIdSwitcher.applyToSubmodules`          | `true`     | Propagate identity to Git submodules                                                           |
 | `gitIdSwitcher.submoduleDepth`             | `1`        | Max depth for nested submodule configuration (1-5)                                             |
 | `gitIdSwitcher.includeIconInGitConfig`     | `false`    | Include icon emoji in Git config `user.name`                                                   |
+| `gitIdSwitcher.syncCheck.enabled`          | `true`     | Check whether selected profile matches actual git config                                       |
+| `gitIdSwitcher.syncCheck.onFocusReturn`    | `true`     | Run sync check when editor window regains focus                                                |
 | `gitIdSwitcher.logging.fileEnabled`        | `false`    | Save audit logs to file (records identity switches, SSH key operations, etc.)                  |
 | `gitIdSwitcher.logging.filePath`           | `""`       | Log file path (e.g., `~/.git-id-switcher/security.log`). Empty string uses default path        |
 | `gitIdSwitcher.logging.maxFileSize`        | `10485760` | Max file size before rotation (bytes, 1MB-100MB)                                               |
@@ -347,6 +350,32 @@ When you switch identities, the extension does the following (in order):
 2. **SSH Key** (if `sshKeyPath` set): Removes other keys from ssh-agent and adds the selected key
 3. **GPG Key** (if `gpgKeyId` set): Sets `git config --local user.signingkey` and enables signing
 4. **Submodules** (if enabled): Propagates settings to all submodules (default: depth 1)
+5. **Sync Check**: Verifies that the applied profile matches the actual git config
+
+### Sync Check
+
+Compares the selected profile against the actual `git config --local` values (`user.name`, `user.email`, `user.signingkey`) and shows a status bar warning when a mismatch is detected.
+
+**When checks run:**
+
+- Immediately after profile apply
+- On workspace folder change
+- On configuration change
+- On editor window focus return (debounced 500ms)
+
+**When a mismatch is detected:**
+
+- The status bar shows a ⚠️ icon with a warning background color
+- The tooltip displays a table showing the mismatched fields (field, expected value, actual value)
+- Clicking the status bar presents resolution options:
+  - **Re-apply profile** — Re-apply the current profile to git config
+  - **Select different profile** — Open the identity picker
+  - **Dismiss** — Suppress the warning until the next check
+
+**To disable:**
+
+Set `gitIdSwitcher.syncCheck.enabled` to `false` to disable all sync checks.
+To disable only the focus-return check, set `gitIdSwitcher.syncCheck.onFocusReturn` to `false`.
 
 ### How Submodule Propagation Works
 

extensions/git-id-switcher/docs/i18n/en/README.md

@@ -45,6 +45,7 @@ While many Git identity switchers exist, **Git ID Switcher** solves the complex
 - **Identity (Profile) Management UI**: Add, edit, delete, and reorder identities without editing settings.json
 - **One-Click Identity Switch**: Instantly change Git user.name and user.email
 - **Status Bar Integration**: Always see your current identity (profile) at a glance
+- **Sync Check**: Real-time detection of mismatches between profile and git config, with status bar warning
 - **Submodule Support**: Automatically propagate identity to Git submodules
 - **SSH Key Management**: Automatically switch SSH keys in ssh-agent
 - **GPG Signing Support**: Configure GPG key for commit signing (optional)
@@ -287,6 +288,8 @@ You can also delete an identity from the command palette using `Git ID Switcher:
 | `gitIdSwitcher.applyToSubmodules`          | `true`     | Propagate identity to Git submodules                                                           |
 | `gitIdSwitcher.submoduleDepth`             | `1`        | Max depth for nested submodule configuration (1-5)                                             |
 | `gitIdSwitcher.includeIconInGitConfig`     | `false`    | Include icon emoji in Git config `user.name`                                                   |
+| `gitIdSwitcher.syncCheck.enabled`          | `true`     | Check whether selected profile matches actual git config                                       |
+| `gitIdSwitcher.syncCheck.onFocusReturn`    | `true`     | Run sync check when editor window regains focus                                                |
 | `gitIdSwitcher.logging.fileEnabled`        | `false`    | Save audit logs to file (records identity switches, SSH key operations, etc.)                  |
 | `gitIdSwitcher.logging.filePath`           | `""`       | Log file path (e.g., `~/.git-id-switcher/security.log`). Empty string uses default path        |
 | `gitIdSwitcher.logging.maxFileSize`        | `10485760` | Max file size before rotation (bytes, 1MB-100MB)                                               |
@@ -343,6 +346,32 @@ When you switch identities, the extension does the following (in order):
 2. **SSH Key** (if `sshKeyPath` set): Removes other keys from ssh-agent and adds the selected key
 3. **GPG Key** (if `gpgKeyId` set): Sets `git config --local user.signingkey` and enables signing
 4. **Submodules** (if enabled): Propagates settings to all submodules (default: depth 1)
+5. **Sync Check**: Verifies that the applied profile matches the actual git config
+
+### Sync Check
+
+Compares the selected profile against the actual `git config --local` values (`user.name`, `user.email`, `user.signingkey`) and shows a status bar warning when a mismatch is detected.
+
+**When checks run:**
+
+- Immediately after profile apply
+- On workspace folder change
+- On configuration change
+- On editor window focus return (debounced 500ms)
+
+**When a mismatch is detected:**
+
+- The status bar shows a ⚠️ icon with a warning background color
+- The tooltip displays a table showing the mismatched fields (field, expected value, actual value)
+- Clicking the status bar presents resolution options:
+  - **Re-apply profile** — Re-apply the current profile to git config
+  - **Select different profile** — Open the identity picker
+  - **Dismiss** — Suppress the warning until the next check
+
+**To disable:**
+
+Set `gitIdSwitcher.syncCheck.enabled` to `false` to disable all sync checks.
+To disable only the focus-return check, set `gitIdSwitcher.syncCheck.onFocusReturn` to `false`.
 
 ### How Submodule Propagation Works
 

extensions/git-id-switcher/docs/i18n/ja/README.md

@@ -45,6 +45,7 @@ Gitプロフィール切り替えツールは数多く存在しますが、**Git
 - **プロフィール管理UI**: settings.jsonを編集せずに、プロフィールの追加・編集・削除・並べ替えが可能
 - **ワンクリックでプロフィール切り替え**: Git user.nameとuser.emailを瞬時に変更
 - **ステータスバー統合**: 現在のプロフィールを常に一目で確認
+- **同期チェック**: プロフィールとgit configの不一致をリアルタイム検出し、ステータスバーで警告
 - **サブモジュール対応**: Gitサブモジュールにも自動的にプロフィールを伝播
 - **SSH鍵管理**: ssh-agentのSSH鍵を自動的に切り替え
 - **GPG署名対応**: コミット署名用のGPG鍵を設定（オプション）
@@ -287,6 +288,8 @@ Host gitlab-oss
 | `gitIdSwitcher.applyToSubmodules`          | `true`       | Gitサブモジュールにプロフィールを伝播                                                               |
 | `gitIdSwitcher.submoduleDepth`             | `1`          | ネストされたサブモジュール設定の最大深度（1-5）                                                     |
 | `gitIdSwitcher.includeIconInGitConfig`     | `false`      | アイコン絵文字をGit configの`user.name`に含めるか                                                   |
+| `gitIdSwitcher.syncCheck.enabled`          | `true`       | プロフィールとgit configの同期チェックを有効にする                                                  |
+| `gitIdSwitcher.syncCheck.onFocusReturn`    | `true`       | ウィンドウフォーカス復帰時に同期チェックを実行する                                                  |
 | `gitIdSwitcher.logging.fileEnabled`        | `false`      | 監査ログをファイルに保存する（ID切り替え、SSH鍵操作などを記録）                                     |
 | `gitIdSwitcher.logging.filePath`           | `""`         | ログファイルのパス（例：`~/.git-id-switcher/security.log`）。空文字列の場合はデフォルトパスを使用   |
 | `gitIdSwitcher.logging.maxFileSize`        | `10485760`   | ローテーション前の最大ファイルサイズ（バイト単位、1MB-100MB）                                       |
@@ -343,6 +346,32 @@ Gitの設定には3つのレイヤーがあり、下位の設定を上位が上
 2. **SSH鍵**（`sshKeyPath`設定時）: 他の鍵をssh-agentから削除し、選択した鍵を追加
 3. **GPG鍵**（`gpgKeyId`設定時）: `git config --local user.signingkey`を設定し、署名を有効化
 4. **サブモジュール**（有効時）: すべてのサブモジュールに設定を伝播（デフォルト：深度1）
+5. **同期チェック**: 適用したプロフィールとgit configが一致しているか自動検証
+
+### 同期チェック
+
+選択中のプロフィールと実際の `git config --local` の値（`user.name`, `user.email`, `user.signingkey`）を比較し、不一致があればステータスバーに警告を表示します。
+
+**チェックのタイミング:**
+
+- プロフィール適用直後
+- ワークスペースフォルダ変更時
+- 設定変更時
+- エディタウィンドウへのフォーカス復帰時（デバウンス500ms）
+
+**不一致が検出された場合:**
+
+- ステータスバーに ⚠️ が表示され、背景が警告色に変わります
+- ツールチップに不一致の詳細（項目・期待値・実際の値）がテーブル形式で表示されます
+- クリックすると解決方法の選択肢が表示されます：
+  - **プロフィールを再適用** — 現在のプロフィールをgit configに再適用
+  - **別のプロフィールを選択** — プロフィールピッカーを開く
+  - **無視** — 次回のチェックまで警告を抑制
+
+**無効化するには:**
+
+`gitIdSwitcher.syncCheck.enabled` を `false` に設定すると、すべての同期チェックが無効になります。
+フォーカス復帰時のチェックのみ無効にしたい場合は、`gitIdSwitcher.syncCheck.onFocusReturn` を `false` に設定してください。
 
 ### サブモジュール伝播の仕組み
 

extensions/git-id-switcher/l10n/bundle.l10n.bg.json

@@ -96,5 +96,18 @@
   "Press 'Enter' to save (leave empty to clear)": "Натиснете 'Enter' за запазване (оставете празно за изчистване)",
   "Move up": "Преместване нагоре",
   "Move down": "Преместване надолу",
-  "Failed to reorder identity: {0}": "Неуспешно пренареждане на профил: {0}"
+  "Failed to reorder identity: {0}": "Неуспешно пренареждане на профил: {0}",
+  "Profile out of sync": "Профилът не е синхронизиран",
+  "Field": "Поле",
+  "Profile": "Профил",
+  "Git Config": "Git конфигурация",
+  "*Click to resolve*": "*Натиснете за решаване*",
+  "Re-apply profile": "Повторно прилагане на профил",
+  "Re-apply the current profile to git config": "Повторно прилагане на текущия профил към git конфигурацията",
+  "Select different profile": "Избор на друг профил",
+  "Choose a different identity profile": "Изберете различен профил за самоличност",
+  "Dismiss": "Отхвърляне",
+  "Ignore until next sync check": "Игнориране до следващата проверка за синхронизация",
+  "How would you like to resolve this?": "Как бихте искали да разрешите това?",
+  "Failed to re-apply profile: {0}": "Неуспешно повторно прилагане на профила: {0}"
 }

extensions/git-id-switcher/l10n/bundle.l10n.cs.json

@@ -96,5 +96,18 @@
   "Press 'Enter' to save (leave empty to clear)": "Uložte stisknutím 'Enter' (ponechte prázdné pro vymazání)",
   "Move up": "Přesunout nahoru",
   "Move down": "Přesunout dolů",
-  "Failed to reorder identity: {0}": "Nepodařilo se změnit pořadí profilu: {0}"
+  "Failed to reorder identity: {0}": "Nepodařilo se změnit pořadí profilu: {0}",
+  "Profile out of sync": "Profil není synchronizován",
+  "Field": "Pole",
+  "Profile": "Profil",
+  "Git Config": "Konfigurace Git",
+  "*Click to resolve*": "*Klikněte pro vyřešení*",
+  "Re-apply profile": "Znovu použít profil",
+  "Re-apply the current profile to git config": "Znovu použít aktuální profil na konfiguraci gitu",
+  "Select different profile": "Vybrat jiný profil",
+  "Choose a different identity profile": "Vyberte jiný profil identity",
+  "Dismiss": "Zavřít",
+  "Ignore until next sync check": "Ignorovat do příští kontroly synchronizace",
+  "How would you like to resolve this?": "Jak chcete tento problém vyřešit?",
+  "Failed to re-apply profile: {0}": "Opětovné použití profilu selhalo: {0}"
 }

extensions/git-id-switcher/l10n/bundle.l10n.de.json

@@ -96,5 +96,18 @@
   "Press 'Enter' to save (leave empty to clear)": "'Enter' zum Speichern (leer lassen zum Löschen)",
   "Move up": "Nach oben verschieben",
   "Move down": "Nach unten verschieben",
-  "Failed to reorder identity: {0}": "Profil konnte nicht neu angeordnet werden: {0}"
+  "Failed to reorder identity: {0}": "Profil konnte nicht neu angeordnet werden: {0}",
+  "Profile out of sync": "Profil nicht synchronisiert",
+  "Field": "Feld",
+  "Profile": "Profil",
+  "Git Config": "Git-Konfiguration",
+  "*Click to resolve*": "*Klicken zum Beheben*",
+  "Re-apply profile": "Profil erneut anwenden",
+  "Re-apply the current profile to git config": "Das aktuelle Profil erneut auf die Git-Konfiguration anwenden",
+  "Select different profile": "Anderes Profil auswählen",
+  "Choose a different identity profile": "Ein anderes Identitätsprofil auswählen",
+  "Dismiss": "Verwerfen",
+  "Ignore until next sync check": "Bis zur nächsten Synchronisierungsprüfung ignorieren",
+  "How would you like to resolve this?": "Wie möchten Sie dies lösen?",
+  "Failed to re-apply profile: {0}": "Profil konnte nicht erneut angewendet werden: {0}"
 }

extensions/git-id-switcher/l10n/bundle.l10n.es.json

@@ -96,5 +96,18 @@
   "Press 'Enter' to save (leave empty to clear)": "Pulsa 'Enter' para guardar (dejar vacío para borrar)",
   "Move up": "Mover arriba",
   "Move down": "Mover abajo",
-  "Failed to reorder identity: {0}": "Error al reordenar perfil: {0}"
+  "Failed to reorder identity: {0}": "Error al reordenar perfil: {0}",
+  "Profile out of sync": "Perfil desincronizado",
+  "Field": "Campo",
+  "Profile": "Perfil",
+  "Git Config": "Configuración Git",
+  "*Click to resolve*": "*Haz clic para resolver*",
+  "Re-apply profile": "Reaplicar perfil",
+  "Re-apply the current profile to git config": "Reaplicar el perfil actual a la configuración git",
+  "Select different profile": "Seleccionar otro perfil",
+  "Choose a different identity profile": "Elegir un perfil de identidad diferente",
+  "Dismiss": "Descartar",
+  "Ignore until next sync check": "Ignorar hasta la próxima verificación de sincronización",
+  "How would you like to resolve this?": "¿Cómo desea resolver esto?",
+  "Failed to re-apply profile: {0}": "Error al reaplicar el perfil: {0}"
 }

extensions/git-id-switcher/l10n/bundle.l10n.fr.json

@@ -96,5 +96,18 @@
   "Press 'Enter' to save (leave empty to clear)": "Appuyez sur 'Entrée' pour enregistrer (laisser vide pour effacer)",
   "Move up": "Déplacer vers le haut",
   "Move down": "Déplacer vers le bas",
-  "Failed to reorder identity: {0}": "Échec du réordonnancement du profil : {0}"
+  "Failed to reorder identity: {0}": "Échec du réordonnancement du profil : {0}",
+  "Profile out of sync": "Profil désynchronisé",
+  "Field": "Champ",
+  "Profile": "Profil",
+  "Git Config": "Config Git",
+  "*Click to resolve*": "*Cliquez pour résoudre*",
+  "Re-apply profile": "Réappliquer le profil",
+  "Re-apply the current profile to git config": "Réappliquer le profil actuel à la configuration git",
+  "Select different profile": "Sélectionner un autre profil",
+  "Choose a different identity profile": "Choisir un profil d'identité différent",
+  "Dismiss": "Ignorer",
+  "Ignore until next sync check": "Ignorer jusqu'à la prochaine vérification de synchronisation",
+  "How would you like to resolve this?": "Comment souhaitez-vous résoudre ceci ?",
+  "Failed to re-apply profile: {0}": "Échec de la réapplication du profil : {0}"
 }

extensions/git-id-switcher/l10n/bundle.l10n.hu.json

@@ -96,5 +96,18 @@
   "Press 'Enter' to save (leave empty to clear)": "Mentéshez nyomja meg az 'Enter'-t (hagyja üresen a törléshez)",
   "Move up": "Mozgatás felfelé",
   "Move down": "Mozgatás lefelé",
-  "Failed to reorder identity: {0}": "Nem sikerült átrendezni a profilt: {0}"
+  "Failed to reorder identity: {0}": "Nem sikerült átrendezni a profilt: {0}",
+  "Profile out of sync": "Profil nincs szinkronban",
+  "Field": "Mező",
+  "Profile": "Profil",
+  "Git Config": "Git konfiguráció",
+  "*Click to resolve*": "*Kattintson a megoldáshoz*",
+  "Re-apply profile": "Profil újraalkalmazása",
+  "Re-apply the current profile to git config": "Az aktuális profil újraalkalmazása a git konfigurációra",
+  "Select different profile": "Másik profil kiválasztása",
+  "Choose a different identity profile": "Válasszon másik identitásprofilt",
+  "Dismiss": "Elvetés",
+  "Ignore until next sync check": "Figyelmen kívül hagyás a következő szinkronizáció-ellenőrzésig",
+  "How would you like to resolve this?": "Hogyan szeretné megoldani?",
+  "Failed to re-apply profile: {0}": "A profil újraalkalmazása sikertelen: {0}"
 }