whisper-windows-mcp 2.2.2 → 2.3.0

package/SECURITY.es.md

@@ -1,47 +1,64 @@
-# Política de Seguridad
-
-## Alcance
-
-whisper-windows-mcp es una herramienta que prioriza lo local. Todo el procesamiento de audio ocurre en tu máquina — ningún audio, archivo de video ni dato personal es transmitido a ningún servidor. La superficie de ataque está limitada a:
-
-- El sistema de archivos local (rutas de archivo pasadas a las herramientas)
-- El binario whisper-cli.exe y sus dependencias
-- La conexión MCP de Claude Desktop (solo IPC local)
-- Texto de transcripción devuelto en respuestas de herramientas (ver Arquitectura de Privacidad abajo)
-
-## Arquitectura de Privacidad
-
-**Los archivos de audio nunca salen de tu máquina.** Esta garantía es incondicional.
-
-**El texto de transcripción puede salir de tu máquina.** Cuando una respuesta de herramienta incluye texto de transcripción, ese texto es procesado por la API de Claude. Este es el comportamiento estándar de MCP, pero crea una brecha entre la filosofía de diseño "prioridad local" de la herramienta y el flujo de datos real para usuarios que manejan contenido regulado o confidencial.
-
-Una variable de entorno `WHISPER_PRIVACY_MODE` está planificada y restringirá todas las respuestas de herramientas solo a metadatos — ningún texto de transcripción devuelto a la API de Claude. Esta es la solución prevista para implementaciones médicas, jurídicas, financieras y corporativas.
-
-Ver [PRIVACY.md](PRIVACY.md) para la descripción completa de la arquitectura de privacidad, orientación de marcos de cumplimiento (HIPAA, GDPR, privilegio abogado-cliente, FERPA, SOX, PCI-DSS) e instrucciones de configuración.
-
-## Versiones soportadas
-
-Las correcciones de seguridad solo se aplican a la versión publicada más reciente.
-
-| Versión | Soportada |
-|---|---|
-| 2.x (más reciente) | ✅ |
-| 1.x | ❌ |
-
-## Reportar una vulnerabilidad
-
-**No abras una issue pública para vulnerabilidades de seguridad.**
-
-Usa el reporte privado de vulnerabilidades de GitHub:
-1. Ve a la [pestaña Security](https://github.com/eviscerations/whisper-windows-mcp/security)
-2. Haz clic en "Report a vulnerability"
-3. Describe el problema con suficientes detalles para reproducirlo
-
-Recibirás una respuesta en 7 días. Si la vulnerabilidad es confirmada, se lanzará una corrección lo antes posible y serás acreditado en las notas de release si lo deseas.
-
-## Decisiones de diseño conocidas
-
-- **Inyección de ruta de archivo:** Las herramientas aceptan rutas de archivo absolutas de Claude. Esto es por diseño — la herramienta está destinada a ser usada con Claude Desktop por el propietario de la máquina. No expongas este servidor MCP a acceso de red no confiable.
-- **Sin sandbox:** whisper-cli.exe se ejecuta con los mismos permisos que Claude Desktop. Esto es estándar para herramientas MCP locales.
-- **Archivos temporales:** Los archivos WAV intermedios se escriben en `%TEMP%\whisper_tmp_*.wav` y se eliminan tras la transcripción. Los archivos de estado de tareas se escriben en `%TEMP%\whisper-mcp-jobs\` y persisten hasta ser limpiados manualmente o hasta que la función de limpieza automática planificada esté disponible.
-- **Contenido de transcripción:** El texto de transcripción devuelto en respuestas de herramientas es procesado por la API de Claude. Esto está documentado y podrá ser abordado via `WHISPER_PRIVACY_MODE` en un release futuro. Ver [PRIVACY.md](PRIVACY.md).
+# Política de Seguridad
+
+## Alcance
+
+whisper-windows-mcp es una herramienta que prioriza lo local. Todo el procesamiento de audio ocurre en tu máquina — ningún audio, archivo de video ni dato personal es transmitido a ningún servidor. La superficie de ataque está limitada a:
+
+- El sistema de archivos local (rutas de archivo pasadas a las herramientas)
+- El binario whisper-cli.exe y sus dependencias
+- La conexión MCP de Claude Desktop (solo IPC local)
+- Texto de transcripción devuelto en respuestas de herramientas (ver Arquitectura de Privacidad abajo)
+
+## Arquitectura de Privacidad
+
+**Los archivos de audio nunca salen de tu máquina.** Esta garantía es incondicional.
+
+**El texto de transcripción puede salir de tu máquina en modo estándar.** Cuando una respuesta de herramienta incluye texto de transcripción, ese texto es procesado por la API de Claude. Este es el comportamiento estándar de MCP, pero crea una brecha entre la filosofía de diseño "prioridad local" de la herramienta y el flujo de datos real para usuarios que manejan contenido regulado o confidencial.
+
+**El modo de privacidad** (`WHISPER_PRIVACY_MODE=true` o `privacy_mode=true` por llamada) restringe todas las respuestas de herramientas solo a metadatos — ningún texto de transcripción devuelto a la API de Claude. Esta es la configuración correcta para implementaciones médicas, jurídicas, financieras y corporativas.
+
+**Puerta de modo de privacidad:** Cuando el modo de privacidad está activo, se muestra una divulgación de confirmación explícita antes de cada operación de transcripción. Esto es intencional y no puede omitirse — el cumplimiento normativo requiere consentimiento informado por operación.
+
+**Puerta de consentimiento:** En modo estándar, se muestra una divulgación única por sesión antes de que el texto de transcripción sea devuelto a la API por primera vez en una sesión. Establece `WHISPER_CONSENT_ACKNOWLEDGED=true` en tu configuración para omitir esto en contenido no sensible.
+
+Ver [PRIVACY.md](PRIVACY.md) para la descripción completa de la arquitectura de privacidad, orientación de marcos de cumplimiento (HIPAA, GDPR, privilegio abogado-cliente, FERPA, SOX, PCI-DSS) e instrucciones de configuración.
+
+## Verificación del binario
+
+Para verificar la integridad del binario `whisper-cli.exe` en el release precompilado, comprueba su hash SHA256 en PowerShell:
+
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
+
+El hash esperado para cada binario de release está publicado en la [página de releases](https://github.com/eviscerations/whisper-windows-mcp/releases). No uses un binario cuyo hash no coincida.
+
+## Versiones soportadas
+
+Las correcciones de seguridad solo se aplican a la versión publicada más reciente.
+
+| Versión | Soportada |
+|---|---|
+| 2.x (más reciente) | ✅ |
+| 1.x | ❌ |
+
+## Reportar una vulnerabilidad
+
+**No abras una issue pública para vulnerabilidades de seguridad.**
+
+Usa el reporte privado de vulnerabilidades de GitHub:
+1. Ve a la [pestaña Security](https://github.com/eviscerations/whisper-windows-mcp/security)
+2. Haz clic en "Report a vulnerability"
+3. Describe el problema con suficientes detalles para reproducirlo
+
+Recibirás una respuesta en 7 días. Si la vulnerabilidad es confirmada, se lanzará una corrección lo antes posible y serás acreditado en las notas de release si lo deseas.
+
+## Decisiones de diseño conocidas
+
+- **Inyección de ruta de archivo:** Las herramientas aceptan rutas de archivo absolutas de Claude. Esto es por diseño — la herramienta está destinada a ser usada con Claude Desktop por el propietario de la máquina. No expongas este servidor MCP a acceso de red no confiable.
+- **Sin sandbox:** whisper-cli.exe se ejecuta con los mismos permisos que Claude Desktop. Esto es estándar para herramientas MCP locales.
+- **Archivos temporales:** Los archivos WAV intermedios se escriben en `%TEMP%\whisper_tmp_*.wav` y se eliminan tras la transcripción. Los archivos de estado de tareas se escriben en `%TEMP%\whisper-mcp-jobs\` y se limpian automáticamente después de 7 días al iniciar el servidor.
+- **Contenido de transcripción:** El texto de transcripción devuelto en respuestas de herramientas es procesado por la API de Claude en modo estándar. Para evitar esto, activa `WHISPER_PRIVACY_MODE=true` o pasa `privacy_mode=true` por llamada. Ver [PRIVACY.md](PRIVACY.md).
+- **Inyección de transcripción:** Los archivos de audio pueden contener contenido hablado que, cuando se transcribe, se asemeja a instrucciones. Las defensas integradas de Claude manejan esto. El propio servidor MCP marca todo el contenido de transcripción como datos no confiables y nunca lo interpreta como instrucciones.
+- **Las descargas de modelos están restringidas:** La herramienta `download_model` solo descarga desde dos espacios de nombres de Hugging Face de confianza (`ggerganov/whisper.cpp` y `ggml-org`). Los redireccionamientos son validados contra una lista de permitidos antes de seguirlos. Las URLs arbitrarias son rechazadas a nivel de código.
+- **El cambio de modelos está en sandbox:** `switch_model` solo acepta archivos `.bin` dentro del directorio de modelos configurado. Las rutas fuera de ese directorio son rechazadas independientemente de cómo se especifiquen.

package/SECURITY.id.md

@@ -1,47 +1,64 @@
-# Kebijakan Keamanan
-
-## Cakupan
-
-whisper-windows-mcp adalah alat yang mengutamakan lokal. Semua pemrosesan audio terjadi di mesin Anda — tidak ada audio, file video, atau data pribadi yang dikirim ke server mana pun. Permukaan serangan terbatas pada:
-
-- Sistem file lokal (jalur file yang diteruskan ke alat)
-- Binary whisper-cli.exe dan dependensinya
-- Koneksi Claude Desktop MCP (hanya IPC lokal)
-- Teks transkrip yang dikembalikan dalam respons alat (lihat Arsitektur Privasi di bawah)
-
-## Arsitektur Privasi
-
-**File audio tidak pernah meninggalkan mesin Anda.** Jaminan ini bersifat tanpa syarat.
-
-**Teks transkrip mungkin meninggalkan mesin Anda.** Saat respons alat menyertakan teks transkrip, teks tersebut diproses oleh API Claude. Ini adalah perilaku MCP standar tetapi menciptakan celah antara filosofi desain "utamakan lokal" alat dan aliran data aktual bagi pengguna yang menangani konten yang diatur atau rahasia.
-
-Variabel lingkungan `WHISPER_PRIVACY_MODE` direncanakan yang akan membatasi semua respons alat hanya ke metadata — tidak ada teks transkrip yang dikembalikan ke API Claude. Ini adalah solusi yang dimaksudkan untuk penerapan medis, hukum, keuangan, dan perusahaan.
-
-Lihat [PRIVACY.md](PRIVACY.md) untuk deskripsi arsitektur privasi lengkap, panduan kerangka kepatuhan (HIPAA, GDPR, hak istimewa pengacara-klien, FERPA, SOX, PCI-DSS), dan instruksi konfigurasi.
-
-## Versi yang Didukung
-
-Perbaikan keamanan hanya diterapkan pada versi yang diterbitkan terbaru.
-
-| Versi | Didukung |
-|---|---|
-| 2.x (terbaru) | ✅ |
-| 1.x | ❌ |
-
-## Melaporkan Kerentanan
-
-**Jangan buka issue publik untuk kerentanan keamanan.**
-
-Gunakan pelaporan kerentanan pribadi GitHub:
-1. Buka [tab Security](https://github.com/eviscerations/whisper-windows-mcp/security)
-2. Klik "Report a vulnerability"
-3. Jelaskan masalah dengan detail yang cukup untuk mereproduksinya
-
-Anda akan menerima respons dalam 7 hari. Jika kerentanan dikonfirmasi, perbaikan akan dirilis sesegera mungkin dan Anda akan dikreditkan dalam catatan rilis jika Anda menginginkannya.
-
-## Keputusan Desain yang Diketahui
-
-- **Injeksi jalur file:** Alat menerima jalur file absolut dari Claude. Ini adalah desain yang disengaja — alat ini dimaksudkan untuk digunakan dengan Claude Desktop oleh pemilik mesin. Jangan paparkan server MCP ini ke akses jaringan yang tidak terpercaya.
-- **Tidak ada sandboxing:** whisper-cli.exe berjalan dengan izin yang sama seperti Claude Desktop. Ini adalah standar untuk alat MCP lokal.
-- **File sementara:** File WAV perantara ditulis ke `%TEMP%\whisper_tmp_*.wav` dan dihapus setelah transkripsi. File status tugas ditulis ke `%TEMP%\whisper-mcp-jobs\` dan bertahan hingga dihapus secara manual atau hingga fitur pembersihan otomatis yang direncanakan tersedia.
-- **Konten transkrip:** Teks transkrip yang dikembalikan dalam respons alat diproses oleh API Claude. Ini terdokumentasi dan akan dapat diatasi melalui `WHISPER_PRIVACY_MODE` dalam rilis mendatang. Lihat [PRIVACY.md](PRIVACY.md).
+# Kebijakan Keamanan
+
+## Cakupan
+
+whisper-windows-mcp adalah alat yang mengutamakan lokal. Semua pemrosesan audio terjadi di mesin Anda — tidak ada audio, file video, atau data pribadi yang dikirim ke server mana pun. Permukaan serangan terbatas pada:
+
+- Sistem file lokal (jalur file yang diteruskan ke alat)
+- Binary whisper-cli.exe dan dependensinya
+- Koneksi Claude Desktop MCP (hanya IPC lokal)
+- Teks transkrip yang dikembalikan dalam respons alat (lihat Arsitektur Privasi di bawah)
+
+## Arsitektur Privasi
+
+**File audio tidak pernah meninggalkan mesin Anda.** Jaminan ini bersifat tanpa syarat.
+
+**Teks transkrip mungkin meninggalkan mesin Anda** dalam mode standar. Saat respons alat menyertakan teks transkrip, teks tersebut diproses oleh API Claude. Ini adalah perilaku MCP standar tetapi menciptakan celah antara filosofi desain "utamakan lokal" alat dan aliran data aktual bagi pengguna yang menangani konten yang diatur atau rahasia.
+
+**Mode privasi** (`WHISPER_PRIVACY_MODE=true` atau `privacy_mode=true` per-panggilan) membatasi semua respons alat hanya ke metadata — tidak ada teks transkrip yang pernah dikembalikan ke API Claude. Ini adalah konfigurasi yang tepat untuk penerapan medis, hukum, keuangan, dan perusahaan.
+
+**Gerbang mode privasi:** saat mode privasi aktif, konfirmasi pengungkapan ditampilkan sebelum setiap operasi transkripsi. Ini disengaja dan tidak dapat dilewati — kepatuhan regulasi mengharuskan persetujuan yang diinformasikan per-operasi.
+
+**Gerbang persetujuan:** dalam mode standar, pengungkapan satu kali per sesi ditampilkan sebelum teks transkrip apa pun dikembalikan ke API untuk pertama kali. Atur `WHISPER_CONSENT_ACKNOWLEDGED=true` di konfigurasi Anda untuk melewatinya bagi konten yang tidak sensitif.
+
+Lihat [PRIVACY.md](PRIVACY.md) untuk deskripsi arsitektur privasi lengkap, panduan kerangka kepatuhan (HIPAA, GDPR, hak istimewa pengacara-klien, FERPA, SOX, PCI-DSS), dan instruksi konfigurasi.
+
+## Verifikasi Binary
+
+Untuk memverifikasi integritas binary `whisper-cli.exe` dalam rilis pre-built, periksa hash SHA256-nya di PowerShell:
+
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
+
+Hash yang diharapkan untuk setiap binary rilis diterbitkan di [halaman rilis](https://github.com/eviscerations/whisper-windows-mcp/releases). Jangan gunakan binary yang hashnya tidak cocok.
+
+## Versi yang Didukung
+
+Perbaikan keamanan hanya diterapkan pada versi yang diterbitkan terbaru.
+
+| Versi | Didukung |
+|---|---|
+| 2.x (terbaru) | ✅ |
+| 1.x | ❌ |
+
+## Melaporkan Kerentanan
+
+**Jangan buka issue publik untuk kerentanan keamanan.**
+
+Gunakan pelaporan kerentanan pribadi GitHub:
+1. Buka [tab Security](https://github.com/eviscerations/whisper-windows-mcp/security)
+2. Klik "Report a vulnerability"
+3. Jelaskan masalah dengan detail yang cukup untuk mereproduksinya
+
+Anda akan menerima respons dalam 7 hari. Jika kerentanan dikonfirmasi, perbaikan akan dirilis sesegera mungkin dan Anda akan dikreditkan dalam catatan rilis jika Anda menginginkannya.
+
+## Keputusan Desain yang Diketahui
+
+- **Injeksi jalur file:** Alat menerima jalur file absolut dari Claude. Ini adalah desain yang disengaja — alat ini dimaksudkan untuk digunakan dengan Claude Desktop oleh pemilik mesin. Jangan paparkan server MCP ini ke akses jaringan yang tidak terpercaya.
+- **Tidak ada sandboxing:** whisper-cli.exe berjalan dengan izin yang sama seperti Claude Desktop. Ini adalah standar untuk alat MCP lokal.
+- **File sementara:** File WAV perantara ditulis ke `%TEMP%\whisper_tmp_*.wav` dan dihapus setelah transkripsi. File status tugas ditulis ke `%TEMP%\whisper-mcp-jobs\` dan dibersihkan secara otomatis setelah 7 hari saat server dimulai.
+- **Konten transkrip:** Teks transkrip yang dikembalikan dalam respons alat diproses oleh API Claude dalam mode standar. Aktifkan `WHISPER_PRIVACY_MODE=true` atau teruskan `privacy_mode=true` per-panggilan untuk mencegah hal ini. Lihat [PRIVACY.md](PRIVACY.md).
+- **Injeksi transkrip:** File audio dapat mengandung konten lisan yang, saat ditranskrip, menyerupai instruksi. Pertahanan bawaan Claude menangani hal ini. Server MCP itu sendiri menandai semua konten transkrip sebagai data yang tidak terpercaya dan tidak pernah menginterpretasikannya sebagai instruksi.
+- **Unduhan model:** Alat `download_model` hanya mengunduh dari dua namespace Hugging Face terpercaya (`ggerganov/whisper.cpp` dan `ggml-org`). Pengalihan divalidasi terhadap daftar yang diizinkan sebelum diikuti. URL sembarang ditolak di tingkat kode.
+- **Pergantian model:** `switch_model` hanya menerima file `.bin` dalam direktori model yang dikonfigurasi. Jalur di luar direktori tersebut ditolak terlepas dari cara penentuannya.

package/SECURITY.ja.md

@@ -1,47 +1,64 @@
-# セキュリティポリシー
-
-## スコープ
-
-whisper-windows-mcpはローカルファーストのツールです。すべての音声処理はマシン上で行われます — 音声・動画ファイルや個人データが外部サーバーに送信されることは一切ありません。攻撃対象は以下に限定されます：
-
-- ローカルファイルシステム（ツールに渡されるファイルパス）
-- whisper-cli.exeバイナリとその依存関係
-- Claude Desktop MCP接続（ローカルIPCのみ）
-- ツールレスポンスで返されるトランスクリプトテキスト（以下のプライバシーアーキテクチャを参照）
-
-## プライバシーアーキテクチャ
-
-**音声ファイルはマシンの外に出ることは一切ありません。** この保証は無条件です。
-
-**トランスクリプトテキストはマシンの外に出る可能性があります。** ツールレスポンスにトランスクリプトテキストが含まれる場合、そのテキストはClaudeのAPIで処理されます。これは標準的なMCPの動作ですが、規制対象または機密性の高いコンテンツを扱うユーザーにとって、ツールの「ローカルファースト」の設計思想と実際のデータフローの間にギャップが生じます。
-
-トランスクリプトテキストをツールレスポンスに含めず、メタデータのみ（ファイル名、時間、単語数）を返す`WHISPER_PRIVACY_MODE`環境変数が将来のリリースで計画されています。これは医療、法律、財務、および企業向けデプロイメントの想定される設定です。
-
-コンプライアンスフレームワーク別の詳細なガイダンス（HIPAA、GDPR、弁護士・依頼者特権、FERPA、SOX、PCI-DSS）については[PRIVACY.md](PRIVACY.md)を参照してください。
-
-## サポートバージョン
-
-セキュリティ修正は最新の公開バージョンのみに適用されます。
-
-| バージョン | サポート |
-|---|---|
-| 2.x（最新） | ✅ |
-| 1.x | ❌ |
-
-## 脆弱性の報告
-
-**セキュリティ上の脆弱性には公開Issueを使用しないでください。**
-
-GitHubのプライベート脆弱性レポートを使用してください：
-1. [Securityタブ](https://github.com/eviscerations/whisper-windows-mcp/security)にアクセス
-2. 「Report a vulnerability」をクリック
-3. 再現できる十分な詳細を含めて問題を説明
-
-7日以内に返答します。脆弱性が確認された場合、できる限り早急に修正をリリースし、ご希望の場合はリリースノートにクレジットを記載します。
-
-## 既知の設計上の決定
-
-- **ファイルパスインジェクション：** ツールはClaudeから絶対ファイルパスを受け取ります。これは意図的な設計です — このツールはマシンの所有者がClaude Desktopとともに使用することを目的としています。このMCPサーバーを信頼できないネットワークアクセスに公開しないでください。
-- **サンドボックスなし：** whisper-cli.exeはClaude Desktopと同じ権限で実行されます。これはローカルMCPツールの標準的な動作です。
-- **一時ファイル：** 中間WAVファイルは`%TEMP%\whisper_tmp_*.wav`に書き込まれ、文字起こし後に削除されます。ジョブ状態ファイルは`%TEMP%\whisper-mcp-jobs\`に書き込まれ、手動でクリアするか、計画中の自動クリーンアップ機能がリリースされるまで残ります。
-- **トランスクリプトコンテンツ：** ツールレスポンスで返されるトランスクリプトテキストはClaudeのAPIで処理されます。これは文書化されており、将来のリリースで`WHISPER_PRIVACY_MODE`によって対応される予定です。詳細は[PRIVACY.md](PRIVACY.md)を参照してください。
+# セキュリティポリシー
+
+## スコープ
+
+whisper-windows-mcpはローカルファーストのツールです。すべての音声処理はマシン上で行われます — 音声・動画ファイルや個人データが外部サーバーに送信されることは一切ありません。攻撃対象領域は以下に限定されます：
+
+- ローカルファイルシステム（ツールに渡されるファイルパス）
+- whisper-cli.exeバイナリとその依存関係
+- Claude Desktop MCP接続（ローカルIPCのみ）
+- ツールレスポンスで返されるトランスクリプトテキスト（以下のプライバシーアーキテクチャを参照）
+
+## プライバシーアーキテクチャ
+
+**音声ファイルはマシンの外に出ることは一切ありません。** この保証は無条件です。
+
+**トランスクリプトテキストはマシンの外に出る可能性があります**（標準モードの場合）。ツールレスポンスにトランスクリプトテキストが含まれる場合、そのテキストはClaudeのAPIで処理されます。これは標準的なMCPの動作ですが、規制対象または機密性の高いコンテンツを扱うユーザーにとって、ツールの「ローカルファースト」の設計思想と実際のデータフローの間にギャップが生じます。
+
+**プライバシーモード**（`WHISPER_PRIVACY_MODE=true`またはper-callで`privacy_mode=true`）は、すべてのツールレスポンスをメタデータのみに制限します — トランスクリプトテキストがClaudeのAPIに返されることは一切ありません。これは医療、法律、財務、および企業向けデプロイメントに適した設定です。
+
+**プライバシーモードゲート：** プライバシーモードが有効な場合、すべての文字起こし操作の前に明示的な確認開示が表示されます。これは意図的な動作であり回避できません — 規制へのコンプライアンスには操作ごとのインフォームドコンセントが必要です。
+
+**同意ゲート：** 標準モードでは、セッション内で初めてトランスクリプトテキストがAPIに返される前に、一度だけセッション開示が表示されます。機密性のないコンテンツに対してこれを抑制するには、設定に`WHISPER_CONSENT_ACKNOWLEDGED=true`を設定してください。
+
+完全なプライバシーアーキテクチャの説明、コンプライアンスフレームワークのガイダンス（HIPAA、GDPR、弁護士・依頼者特権、FERPA、SOX、PCI-DSS）、および設定手順については[PRIVACY.md](PRIVACY.md)を参照してください。
+
+## バイナリ検証
+
+プリビルドリリースの`whisper-cli.exe`バイナリの整合性を確認するには、PowerShellでSHA256ハッシュを確認してください：
+
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
+
+各リリースバイナリの期待されるハッシュは[リリースページ](https://github.com/eviscerations/whisper-windows-mcp/releases)に公開されています。ハッシュが一致しないバイナリは使用しないでください。
+
+## サポートバージョン
+
+セキュリティ修正は最新の公開バージョンのみに適用されます。
+
+| バージョン | サポート |
+|---|---|
+| 2.x（最新） | ✅ |
+| 1.x | ❌ |
+
+## 脆弱性の報告
+
+**セキュリティ上の脆弱性には公開Issueを使用しないでください。**
+
+GitHubのプライベート脆弱性レポートを使用してください：
+1. [Securityタブ](https://github.com/eviscerations/whisper-windows-mcp/security)にアクセス
+2. 「Report a vulnerability」をクリック
+3. 再現できる十分な詳細を含めて問題を説明
+
+7日以内に返答します。脆弱性が確認された場合、できる限り早急に修正をリリースし、ご希望の場合はリリースノートにクレジットを記載します。
+
+## 既知の設計上の決定
+
+- **ファイルパスインジェクション：** ツールはClaudeから絶対ファイルパスを受け取ります。これは意図的な設計です — このツールはマシンの所有者がClaude Desktopとともに使用することを目的としています。このMCPサーバーを信頼できないネットワークアクセスに公開しないでください。
+- **サンドボックスなし：** whisper-cli.exeはClaude Desktopと同じ権限で実行されます。これはローカルMCPツールの標準的な動作です。
+- **一時ファイル：** 中間WAVファイルは`%TEMP%\whisper_tmp_*.wav`に書き込まれ、文字起こし後に削除されます。ジョブ状態ファイルは`%TEMP%\whisper-mcp-jobs\`に書き込まれ、サーバー起動時に7日以上経過したファイルが自動的にクリーンアップされます。
+- **トランスクリプトコンテンツ：** 標準モードでツールレスポンスに返されるトランスクリプトテキストはClaudeのAPIで処理されます。これを防ぐには`WHISPER_PRIVACY_MODE=true`を有効にするか、per-callで`privacy_mode=true`を渡してください。詳細は[PRIVACY.md](PRIVACY.md)を参照してください。
+- **トランスクリプトインジェクション：** 音声ファイルには、文字起こしされると指示に似た内容が含まれる可能性があります。Claudeの組み込み防御機能がこれを処理します。MCPサーバー自体はすべてのトランスクリプトコンテンツを信頼できないデータとしてマークし、指示として解釈することは一切ありません。
+- **モデルダウンロード：** `download_model`ツールは2つの信頼できるHugging Faceネームスペース（`ggerganov/whisper.cpp`と`ggml-org`）からのみダウンロードします。リダイレクトはアローリストに対して検証されてから追跡されます。任意のURLはコードレベルで拒否されます。
+- **モデル切り替え：** `switch_model`は設定されたモデルディレクトリ内の`.bin`ファイルのみを受け付けます。そのディレクトリ外のパスは指定方法に関わらず拒否されます。

package/SECURITY.ko.md

@@ -1,47 +1,64 @@
-# 보안 정책
-
-## 범위
-
-whisper-windows-mcp는 로컬 우선 도구입니다. 모든 음성 처리는 머신에서 이루어집니다 — 음성, 동영상 파일이나 개인 데이터가 어떤 서버에도 전송되지 않습니다. 공격 표면은 다음으로 제한됩니다:
-
-- 로컬 파일시스템 (도구에 전달된 파일 경로)
-- whisper-cli.exe 바이너리와 그 의존성
-- Claude Desktop MCP 연결 (로컬 IPC만)
-- 도구 응답에 반환된 전사 텍스트 (아래 개인 정보 아키텍처 참고)
-
-## 개인 정보 아키텍처
-
-**음성 파일은 절대 머신을 떠나지 않습니다.** 이 보장은 무조건적입니다.
-
-**전사 텍스트는 머신을 떠날 수 있습니다.** 도구 응답에 전사 텍스트가 포함되면 해당 텍스트는 Claude의 API에서 처리됩니다. 이는 표준 MCP 동작이지만 규제 대상 또는 기밀 콘텐츠를 처리하는 사용자에게는 도구의 "로컬 우선" 설계 철학과 실제 데이터 흐름 사이에 격차를 만듭니다.
-
-모든 도구 응답을 메타데이터만으로 제한하는 `WHISPER_PRIVACY_MODE` 환경 변수가 계획되어 있습니다 — Claude의 API에 전사 텍스트가 반환되지 않습니다. 이것이 의료, 법률, 재정, 기업 배포에 대한 계획된 솔루션입니다.
-
-전체 개인 정보 아키텍처 설명, 컴플라이언스 프레임워크 안내(HIPAA, GDPR, 변호사-의뢰인 특권, FERPA, SOX, PCI-DSS) 및 설정 지침은 [PRIVACY.md](PRIVACY.md)를 참고하세요.
-
-## 지원되는 버전
-
-보안 수정은 최신 게시된 버전에만 적용됩니다.
-
-| 버전 | 지원됨 |
-|---|---|
-| 2.x (최신) | ✅ |
-| 1.x | ❌ |
-
-## 취약점 보고
-
-**보안 취약점에 대해 공개 이슈를 열지 마세요.**
-
-GitHub의 비공개 취약점 보고를 사용하세요:
-1. [Security 탭](https://github.com/eviscerations/whisper-windows-mcp/security)으로 이동
-2. "Report a vulnerability" 클릭
-3. 재현할 수 있는 충분한 세부 정보로 문제를 설명
-
-7일 이내에 응답을 받을 수 있습니다. 취약점이 확인되면 가능한 한 빨리 수정 사항을 릴리스하고 원하시면 릴리스 노트에 크레딧을 기재합니다.
-
-## 알려진 설계 결정 사항
-
-- **파일 경로 인젝션:** 도구는 Claude로부터 절대 파일 경로를 받습니다. 이것은 의도된 설계입니다 — 이 도구는 머신 소유자가 Claude Desktop과 함께 사용하도록 만들어졌습니다. 이 MCP 서버를 신뢰할 수 없는 네트워크 접근에 노출하지 마세요.
-- **샌드박싱 없음:** whisper-cli.exe는 Claude Desktop과 동일한 권한으로 실행됩니다. 이것은 로컬 MCP 도구의 표준 동작입니다.
-- **임시 파일:** 중간 WAV 파일은 `%TEMP%\whisper_tmp_*.wav`에 작성되고 전사 후 삭제됩니다. 작업 상태 파일은 `%TEMP%\whisper-mcp-jobs\`에 작성되며 수동으로 지우거나 계획된 자동 정리 기능이 출시될 때까지 유지됩니다.
-- **전사 콘텐츠:** 도구 응답에 반환된 전사 텍스트는 Claude의 API에서 처리됩니다. 이것은 문서화되어 있으며 향후 릴리스에서 `WHISPER_PRIVACY_MODE`를 통해 해결될 예정입니다. [PRIVACY.md](PRIVACY.md)를 참고하세요.
+# 보안 정책
+
+## 범위
+
+whisper-windows-mcp는 로컬 우선 도구입니다. 모든 음성 처리는 머신에서 이루어집니다 — 음성, 동영상 파일이나 개인 데이터가 어떤 서버에도 전송되지 않습니다. 공격 표면은 다음으로 제한됩니다:
+
+- 로컬 파일시스템 (도구에 전달된 파일 경로)
+- whisper-cli.exe 바이너리와 그 의존성
+- Claude Desktop MCP 연결 (로컬 IPC만)
+- 도구 응답에 반환된 전사 텍스트 (아래 개인 정보 아키텍처 참고)
+
+## 개인 정보 아키텍처
+
+**음성 파일은 절대 머신을 떠나지 않습니다.** 이 보장은 무조건적입니다.
+
+**전사 텍스트는 기본 모드에서 머신을 떠날 수 있습니다.** 도구 응답에 전사 텍스트가 포함되면 해당 텍스트는 Claude의 API에서 처리됩니다. 이는 표준 MCP 동작이지만 규제 대상 또는 기밀 콘텐츠를 처리하는 사용자에게는 도구의 "로컬 우선" 설계 철학과 실제 데이터 흐름 사이에 격차를 만듭니다.
+
+**개인 정보 모드** (`WHISPER_PRIVACY_MODE=true` 또는 호출별 `privacy_mode=true`)는 모든 도구 응답을 메타데이터만으로 제한합니다 — 전사 텍스트가 Claude의 API에 반환되지 않습니다. 이것이 의료, 법률, 재정, 기업 배포에 대한 올바른 설정입니다.
+
+**개인 정보 모드 게이트:** 개인 정보 모드가 활성화된 경우 모든 전사 작업 전에 명시적 확인 공개가 표시됩니다. 이것은 의도된 동작이며 우회할 수 없습니다 — 규정 준수에는 작업별 사전 동의가 필요합니다.
+
+**동의 게이트:** 기본 모드에서는 세션당 처음으로 전사 텍스트가 API에 반환되기 전에 일회성 세션 공개가 표시됩니다. 민감하지 않은 콘텐츠에 대해 이를 억제하려면 설정에서 `WHISPER_CONSENT_ACKNOWLEDGED=true`를 설정하세요.
+
+전체 개인 정보 아키텍처 설명, 컴플라이언스 프레임워크 안내(HIPAA, GDPR, 변호사-의뢰인 특권, FERPA, SOX, PCI-DSS) 및 설정 지침은 [PRIVACY.md](PRIVACY.md)를 참고하세요.
+
+## 바이너리 검증
+
+사전 빌드된 릴리스의 `whisper-cli.exe` 바이너리 무결성을 확인하려면 PowerShell에서 SHA256 해시를 확인하세요:
+
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
+
+각 릴리스 바이너리에 대한 예상 해시는 [릴리스 페이지](https://github.com/eviscerations/whisper-windows-mcp/releases)에 게시됩니다. 해시가 일치하지 않는 바이너리는 사용하지 마세요.
+
+## 지원되는 버전
+
+보안 수정은 최신 게시된 버전에만 적용됩니다.
+
+| 버전 | 지원됨 |
+|---|---|
+| 2.x (최신) | ✅ |
+| 1.x | ❌ |
+
+## 취약점 보고
+
+**보안 취약점에 대해 공개 이슈를 열지 마세요.**
+
+GitHub의 비공개 취약점 보고를 사용하세요:
+1. [Security 탭](https://github.com/eviscerations/whisper-windows-mcp/security)으로 이동
+2. "Report a vulnerability" 클릭
+3. 재현할 수 있는 충분한 세부 정보로 문제를 설명
+
+7일 이내에 응답을 받을 수 있습니다. 취약점이 확인되면 가능한 한 빨리 수정 사항을 릴리스하고 원하시면 릴리스 노트에 크레딧을 기재합니다.
+
+## 알려진 설계 결정 사항
+
+- **파일 경로 인젝션:** 도구는 Claude로부터 절대 파일 경로를 받습니다. 이것은 의도된 설계입니다 — 이 도구는 머신 소유자가 Claude Desktop과 함께 사용하도록 만들어졌습니다. 이 MCP 서버를 신뢰할 수 없는 네트워크 접근에 노출하지 마세요.
+- **샌드박싱 없음:** whisper-cli.exe는 Claude Desktop과 동일한 권한으로 실행됩니다. 이것은 로컬 MCP 도구의 표준 동작입니다.
+- **임시 파일:** 중간 WAV 파일은 `%TEMP%\whisper_tmp_*.wav`에 작성되고 전사 후 삭제됩니다. 작업 상태 파일은 `%TEMP%\whisper-mcp-jobs\`에 작성되며 서버 시작 시 7일 후 자동으로 정리됩니다.
+- **전사 콘텐츠:** 도구 응답에 반환된 전사 텍스트는 기본 모드에서 Claude의 API에서 처리됩니다. 이를 방지하려면 `WHISPER_PRIVACY_MODE=true`를 설정하거나 호출별로 `privacy_mode=true`를 전달하세요. [PRIVACY.md](PRIVACY.md)를 참고하세요.
+- **전사 인젝션:** 음성 파일에는 전사 시 지시처럼 보이는 발화 내용이 포함될 수 있습니다. Claude의 내장 방어 기능이 이를 처리합니다. MCP 서버 자체는 모든 전사 콘텐츠를 신뢰할 수 없는 데이터로 표시하며 지시로 해석하지 않습니다.
+- **모델 다운로드:** `download_model` 도구는 두 개의 신뢰할 수 있는 Hugging Face 네임스페이스(`ggerganov/whisper.cpp` 및 `ggml-org`)에서만 다운로드합니다. 리다이렉트는 허용 목록에 대해 검증된 후 따릅니다. 임의의 URL은 코드 수준에서 거부됩니다.
+- **모델 전환:** `switch_model`은 설정된 모델 디렉터리 내의 `.bin` 파일만 허용합니다. 지정 방식에 관계없이 해당 디렉터리 외부의 경로는 거부됩니다.

package/SECURITY.md

@@ -13,12 +13,26 @@ whisper-windows-mcp is a local-first tool. All audio processing happens on your
 
 **Audio files never leave your machine.** This guarantee is unconditional.
 
-**Transcript text may leave your machine.** When a tool response includes transcript text, that text is processed by Claude's API. This is standard MCP behavior but creates a gap between the tool's "local-first" design philosophy and actual data flow for users handling regulated or confidential content.
+**Transcript text may leave your machine** in standard mode. When a tool response includes transcript text, that text is processed by Claude's API. This is standard MCP behavior but creates a gap between the tool's "local-first" design philosophy and actual data flow for users handling regulated or confidential content.
 
-A `WHISPER_PRIVACY_MODE` environment variable is planned that will restrict all tool responses to metadata only — no transcript text returned to Claude's API. This is the intended solution for medical, legal, financial, and corporate deployments.
+**Privacy mode** (`WHISPER_PRIVACY_MODE=true` or `privacy_mode=true` per-call) restricts all tool responses to metadata only — no transcript text is ever returned to Claude's API. This is the correct configuration for medical, legal, financial, and corporate deployments.
+
+**Privacy mode gate:** when privacy mode is active, an explicit confirmation disclosure is shown before every transcription operation. This is intentional and cannot be bypassed — regulatory compliance requires per-operation informed consent.
+
+**Consent gate:** in standard mode, a one-time session disclosure is shown before any transcript text is returned to the API for the first time. Set `WHISPER_CONSENT_ACKNOWLEDGED=true` in your config to suppress this for non-sensitive content.
 
 See [PRIVACY.md](PRIVACY.md) for the full privacy architecture description, compliance framework guidance (HIPAA, GDPR, attorney-client privilege, FERPA, SOX, PCI-DSS), and configuration instructions.
 
+## Binary Verification
+
+To verify the integrity of the `whisper-cli.exe` binary in the pre-built release, check its SHA256 hash in PowerShell:
+
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
+
+The expected hash for each release binary is published on the [releases page](https://github.com/eviscerations/whisper-windows-mcp/releases). Do not use a binary whose hash does not match.
+
 ## Supported versions
 
 Security fixes are applied to the latest published version only.
@@ -43,5 +57,8 @@ You'll receive a response within 7 days. If the vulnerability is confirmed, a fi
 
 - **File path injection:** Tools accept absolute file paths from Claude. This is by design — the tool is intended to be used with Claude Desktop by the machine's owner. Do not expose this MCP server to untrusted network access.
 - **No sandboxing:** whisper-cli.exe runs with the same permissions as Claude Desktop. This is standard for local MCP tools.
-- **Temp files:** Intermediate WAV files are written to `%TEMP%\whisper_tmp_*.wav` and deleted after transcription. Job state files are written to `%TEMP%\whisper-mcp-jobs\` and persist until manually cleared or until the planned auto-cleanup feature ships.
-- **Transcript content:** Transcript text returned in tool responses is processed by Claude's API. This is documented and will be addressable via `WHISPER_PRIVACY_MODE` in a future release. See [PRIVACY.md](PRIVACY.md).
+- **Temp files:** Intermediate WAV files are written to `%TEMP%\whisper_tmp_*.wav` and deleted after transcription. Job state files are written to `%TEMP%\whisper-mcp-jobs\` and automatically cleaned up after 7 days on server startup.
+- **Transcript content:** Transcript text returned in tool responses is processed by Claude's API in standard mode. Enable `WHISPER_PRIVACY_MODE=true` or pass `privacy_mode=true` per-call to prevent this. See [PRIVACY.md](PRIVACY.md).
+- **Transcript injection:** Audio files can contain spoken content that, when transcribed, resembles instructions. Claude's built-in defenses handle this. The MCP server itself marks all transcript content as untrusted data and never interprets it as instructions.
+- **Model downloads:** The `download_model` tool only downloads from two trusted Hugging Face namespaces (`ggerganov/whisper.cpp` and `ggml-org`). Redirects are validated against an allowlist before following. Arbitrary URLs are rejected at the code level.
+- **Model switching:** `switch_model` only accepts `.bin` files within the configured models directory. Paths outside that directory are rejected regardless of how they are specified.