whisper-windows-mcp 2.2.2 → 2.4.0

package/SECURITY.pl.md

@@ -1,47 +1,76 @@
-# Polityka bezpieczeństwa
-
-## Zakres
-
-whisper-windows-mcp jest narzędziem priorytetyzującym lokalność. Całe przetwarzanie audio odbywa się na twoim komputerze — żadne audio, pliki wideo ani dane osobowe nie są przesyłane na żaden serwer. Powierzchnia ataku jest ograniczona do:
-
-- Lokalnego systemu plików (ścieżki plików przekazywane do narzędzi)
-- Binarnego pliku whisper-cli.exe i jego zależności
-- Połączenia MCP Claude Desktop (tylko lokalny IPC)
-- Tekstu transkrypcji zwracanego w odpowiedziach narzędzi (patrz Architektura prywatności poniżej)
-
-## Architektura prywatności
-
-**Pliki audio nigdy nie opuszczają twojego komputera.** Ta gwarancja jest bezwarunkowa.
-
-**Tekst transkrypcji może opuścić twój komputer.** Gdy odpowiedź narzędzia zawiera tekst transkrypcji, tekst ten jest przetwarzany przez API Claude. Jest to standardowe zachowanie MCP, ale tworzy lukę między filozofią projektowania "priorytet lokalny" narzędzia a rzeczywistym przepływem danych dla użytkowników obsługujących treści regulowane lub poufne.
-
-Planowana jest zmienna środowiskowa `WHISPER_PRIVACY_MODE`, która ograniczy wszystkie odpowiedzi narzędzi tylko do metadanych — żaden tekst transkrypcji nie jest zwracany do API Claude. Jest to planowane rozwiązanie dla wdrożeń medycznych, prawnych, finansowych i korporacyjnych.
-
-Zobacz [PRIVACY.md](PRIVACY.md) dla pełnego opisu architektury prywatności, wskazówek dotyczących ram zgodności (HIPAA, RODO, tajemnica adwokacka, FERPA, SOX, PCI-DSS) i instrukcji konfiguracji.
-
-## Obsługiwane wersje
-
-Poprawki bezpieczeństwa są stosowane tylko do najnowszej opublikowanej wersji.
-
-| Wersja | Obsługiwana |
-|---|---|
-| 2.x (najnowsza) | ✅ |
-| 1.x | ❌ |
-
-## Zgłaszanie podatności
-
-**Nie otwieraj publicznych zgłoszeń dla podatności bezpieczeństwa.**
-
-Użyj prywatnego raportowania podatności GitHub:
-1. Przejdź do [zakładki Security](https://github.com/eviscerations/whisper-windows-mcp/security)
-2. Kliknij "Report a vulnerability"
-3. Opisz problem z wystarczającymi szczegółami do odtworzenia
-
-Otrzymasz odpowiedź w ciągu 7 dni. Jeśli podatność zostanie potwierdzona, poprawka zostanie wydana tak szybko, jak to możliwe, a ty zostaniesz wymieniony w notatkach wydania, jeśli sobie życzysz.
-
-## Znane decyzje projektowe
-
-- **Iniekcja ścieżki pliku:** Narzędzia akceptują bezwzględne ścieżki plików od Claude. Jest to celowy projekt — narzędzie jest przeznaczone do użytku z Claude Desktop przez właściciela komputera. Nie wystawiaj tego serwera MCP na niezaufany dostęp sieciowy.
-- **Brak piaskownicy:** whisper-cli.exe działa z tymi samymi uprawnieniami co Claude Desktop. Jest to standardowe dla lokalnych narzędzi MCP.
-- **Pliki tymczasowe:** Pośrednie pliki WAV są zapisywane w `%TEMP%\whisper_tmp_*.wav` i usuwane po transkrypcji. Pliki stanu zadań są zapisywane w `%TEMP%\whisper-mcp-jobs\` i pozostają do ręcznego wyczyszczenia lub do wydania planowanej funkcji automatycznego czyszczenia.
-- **Treść transkrypcji:** Tekst transkrypcji zwracany w odpowiedziach narzędzi jest przetwarzany przez API Claude. Jest to udokumentowane i będzie możliwe do rozwiązania przez `WHISPER_PRIVACY_MODE` w przyszłym wydaniu. Zobacz [PRIVACY.md](PRIVACY.md).
+# Polityka bezpieczeństwa
+
+## Zakres
+
+whisper-windows-mcp jest narzędziem priorytetyzującym lokalność. Całe przetwarzanie audio odbywa się na twoim komputerze — żadne audio, pliki wideo ani dane osobowe nie są przesyłane na żaden serwer. Powierzchnia ataku jest ograniczona do:
+
+- Lokalnego systemu plików (ścieżki plików przekazywane do narzędzi)
+- Binarnego pliku whisper-cli.exe i jego zależności
+- Połączenia MCP Claude Desktop (tylko lokalny IPC)
+- Tekstu transkrypcji zwracanego w odpowiedziach narzędzi (patrz Architektura prywatności poniżej)
+
+## Architektura prywatności
+
+**Pliki audio nigdy nie opuszczają twojego komputera.** Ta gwarancja jest bezwarunkowa.
+
+**Tekst transkrypcji może opuścić twój komputer** w trybie standardowym. Gdy odpowiedź narzędzia zawiera tekst transkrypcji, tekst ten jest przetwarzany przez API Claude. Jest to standardowe zachowanie MCP, ale tworzy lukę między filozofią projektowania "priorytet lokalny" narzędzia a rzeczywistym przepływem danych dla użytkowników obsługujących treści regulowane lub poufne.
+
+**Tryb prywatności** (`WHISPER_PRIVACY_MODE=true` lub `privacy_mode=true` dla pojedynczego wywołania) ogranicza wszystkie odpowiedzi narzędzi tylko do metadanych — żaden tekst transkrypcji nie jest zwracany do API Claude. Jest to właściwa konfiguracja dla wdrożeń medycznych, prawnych, finansowych i korporacyjnych.
+
+**Brama trybu prywatności:** gdy tryb prywatności jest aktywny, przed każdą operacją transkrypcji wyświetlane jest wyraźne potwierdzenie ujawnienia. Jest to celowe i nie może być pominięte — zgodność z przepisami wymaga świadomej zgody przed każdą operacją.
+
+**Brama zgody:** w trybie standardowym jednorazowe ujawnienie dla sesji jest wyświetlane przed pierwszym zwróceniem tekstu transkrypcji do API. Ustaw `WHISPER_CONSENT_ACKNOWLEDGED=true` w konfiguracji, aby pominąć to dla treści niepoufnych.
+
+Zobacz [PRIVACY.md](PRIVACY.md) dla pełnego opisu architektury prywatności, wskazówek dotyczących ram zgodności (HIPAA, RODO, tajemnica adwokacka, FERPA, SOX, PCI-DSS) i instrukcji konfiguracji.
+
+## Weryfikacja binarną
+
+Aby zweryfikować integralność binarium `whisper-cli.exe` w gotowym wydaniu, sprawdź jego skrót SHA256 w PowerShell:
+
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
+
+Oczekiwany skrót dla każdego binarnego wydania jest opublikowany na [stronie wydań](https://github.com/eviscerations/whisper-windows-mcp/releases). Nie używaj binarnego pliku, którego skrót nie odpowiada oczekiwanemu.
+
+## Obsługiwane wersje
+
+Poprawki bezpieczeństwa są stosowane tylko do najnowszej opublikowanej wersji.
+
+| Wersja | Obsługiwana |
+|---|---|
+| 2.x (najnowsza) | ✅ |
+| 1.x | ❌ |
+
+## Zgłaszanie podatności
+
+**Nie otwieraj publicznych zgłoszeń dla podatności bezpieczeństwa.**
+
+Użyj prywatnego raportowania podatności GitHub:
+1. Przejdź do [zakładki Security](https://github.com/eviscerations/whisper-windows-mcp/security)
+2. Kliknij "Report a vulnerability"
+3. Opisz problem z wystarczającymi szczegółami do odtworzenia
+
+Otrzymasz odpowiedź w ciągu 7 dni. Jeśli podatność zostanie potwierdzona, poprawka zostanie wydana tak szybko, jak to możliwe, a ty zostaniesz wymieniony w notatkach wydania, jeśli sobie życzysz.
+
+## Piaskownica i zatwierdzenia
+
+whisper-windows-mcp to **lokalne, jednoużytkownikowe narzędzie sterowane przez właściciela komputera za pośrednictwem Claude Desktop.** Jego model zagrożeń to właściciel uruchamiający je na własnym komputerze — nie niezaufane, wielodostępne ani wystawione na sieć wdrożenie.
+
+- **Piaskownica:** brak, z założenia. `whisper-cli.exe` działa na poziomie uprawnień samego właściciela, tak samo jak każdy lokalny serwer MCP. Izolacja na poziomie systemu operacyjnego nie jest tu środkiem zaradczym; jest nim zakres użycia — **nie wystawiaj tego serwera na niezaufany dostęp sieciowy** (zobacz „Iniekcja ścieżki pliku" poniżej).
+- **Zatwierdzenia są warstwowe, a nie oparte na piaskownicy:**
+  1. **Zatwierdzenie hosta** — warstwa MCP Claude Desktop kontroluje wywoływanie narzędzi.
+  2. **Bramki zgody / prywatności** — wymagane jest jawne potwierdzenie, zanim jakikolwiek tekst transkrypcji opuści komputer w kierunku API Claude; `WHISPER_PRIVACY_MODE` / `privacy_mode` dla pojedynczego wywołania zwraca tylko metadane dla treści regulowanych. Bramka jest kluczowana per operacja (narzędzie + argumenty). Zobacz [PRIVACY.md](PRIVACY.md).
+  3. **Walidacja danych wejściowych** — ścieżki z przejściem katalogu i UNC są odrzucane; `switch_model` jest ograniczone do skonfigurowanego katalogu modeli; `download_model` jest ograniczone do listy dozwolonych zaufanych przestrzeni nazw Hugging Face.
+
+To narzędzie **nie** jest zaprojektowane do sterowania przez niezaufanego agenta ani do uruchamiania jako współdzielona infrastruktura. Taka postawa wymagałaby piaskownicy systemu operacyjnego/kontenera oraz polityki ruchu wychodzącego — poza zakresem lokalnego, jednoużytkownikowego narzędzia do transkrypcji.
+
+## Znane decyzje projektowe
+
+- **Iniekcja ścieżki pliku:** Narzędzia akceptują bezwzględne ścieżki plików od Claude. Jest to celowy projekt — narzędzie jest przeznaczone do użytku z Claude Desktop przez właściciela komputera. Nie wystawiaj tego serwera MCP na niezaufany dostęp sieciowy.
+- **Brak piaskownicy:** whisper-cli.exe działa z tymi samymi uprawnieniami co Claude Desktop. Jest to standardowe dla lokalnych narzędzi MCP.
+- **Pliki tymczasowe:** Pośrednie pliki WAV są zapisywane w `%TEMP%\whisper_tmp_*.wav` i usuwane po transkrypcji. Pliki stanu zadań są zapisywane w `%TEMP%\whisper-mcp-jobs\` i automatycznie czyszczone po 7 dniach przy uruchomieniu serwera.
+- **Treść transkrypcji:** Tekst transkrypcji zwracany w odpowiedziach narzędzi jest przetwarzany przez API Claude w trybie standardowym. Włącz `WHISPER_PRIVACY_MODE=true` lub przekaż `privacy_mode=true` dla pojedynczego wywołania, aby temu zapobiec. Zobacz [PRIVACY.md](PRIVACY.md).
+- **Iniekcja transkrypcji:** Pliki audio mogą zawierać wypowiadaną treść, która po transkrypcji przypomina instrukcje. Wbudowane mechanizmy obronne Claude obsługują to. Sam serwer MCP oznacza całą treść transkrypcji jako niezaufane dane i nigdy nie interpretuje jej jako instrukcji.
+- **Pobieranie modeli:** Narzędzie `download_model` pobiera tylko z dwóch zaufanych przestrzeni nazw Hugging Face (`ggerganov/whisper.cpp` i `ggml-org`). Przekierowania są weryfikowane względem listy dozwolonych przed wykonaniem. Dowolne URL są odrzucane na poziomie kodu. Obcięte/niekompletne pobrania są odrzucane (sprawdzenie Content-Length), zanim plik `.part` zostanie awansowany do nazwy modelu.
+- **Przełączanie modeli:** `switch_model` akceptuje tylko pliki `.bin` w skonfigurowanym katalogu modeli. Ścieżki poza nim są odrzucane poprzez znormalizowane ograniczenie ścieżek — katalog z prefiksem-rodzeństwem taki jak `…\models-evil` nie może spełnić sprawdzenia — niezależnie od sposobu podania ścieżki.

package/SECURITY.pt-BR.md

@@ -1,47 +1,76 @@
-# Política de Segurança
-
-## Escopo
-
-O whisper-windows-mcp é uma ferramenta que prioriza o local. Todo o processamento de áudio acontece na sua máquina — nenhum áudio, arquivo de vídeo ou dado pessoal é transmitido para qualquer servidor. A superfície de ataque está limitada a:
-
-- O sistema de arquivos local (caminhos de arquivo passados às ferramentas)
-- O binário whisper-cli.exe e suas dependências
-- A conexão MCP do Claude Desktop (apenas IPC local)
-- Texto de transcrição retornado nas respostas das ferramentas (veja Arquitetura de Privacidade abaixo)
-
-## Arquitetura de Privacidade
-
-**Arquivos de áudio nunca saem da sua máquina.** Essa garantia é incondicional.
-
-**Texto de transcrição pode sair da sua máquina.** Quando uma resposta de ferramenta inclui texto de transcrição, esse texto é processado pela API do Claude. Este é o comportamento padrão do MCP, mas cria uma lacuna entre a filosofia de design "prioridade local" da ferramenta e o fluxo de dados real para usuários que lidam com conteúdo regulamentado ou confidencial.
-
-Uma variável de ambiente `WHISPER_PRIVACY_MODE` está planejada e restringirá todas as respostas das ferramentas apenas a metadados — nenhum texto de transcrição retornado à API do Claude. Esta é a solução pretendida para implantações médicas, jurídicas, financeiras e corporativas.
-
-Veja [PRIVACY.md](PRIVACY.md) para a descrição completa da arquitetura de privacidade, orientação sobre frameworks de conformidade (HIPAA, GDPR, privilégio advogado-cliente, FERPA, SOX, PCI-DSS) e instruções de configuração.
-
-## Versões suportadas
-
-Correções de segurança são aplicadas apenas à versão publicada mais recente.
-
-| Versão | Suportada |
-|---|---|
-| 2.x (mais recente) | ✅ |
-| 1.x | ❌ |
-
-## Reportando uma vulnerabilidade
-
-**Não abra uma issue pública para vulnerabilidades de segurança.**
-
-Use o relatório privado de vulnerabilidade do GitHub:
-1. Vá para a [aba Security](https://github.com/eviscerations/whisper-windows-mcp/security)
-2. Clique em "Report a vulnerability"
-3. Descreva o problema com detalhes suficientes para reproduzi-lo
-
-Você receberá uma resposta em até 7 dias. Se a vulnerabilidade for confirmada, uma correção será lançada o mais rápido possível e você será creditado nas notas de release se desejar.
-
-## Decisões de design conhecidas
-
-- **Injeção de caminho de arquivo:** As ferramentas aceitam caminhos absolutos de arquivo do Claude. Isso é por design — a ferramenta é destinada a ser usada com o Claude Desktop pelo proprietário da máquina. Não exponha este servidor MCP a acesso de rede não confiável.
-- **Sem sandbox:** O whisper-cli.exe é executado com as mesmas permissões que o Claude Desktop. Isso é padrão para ferramentas MCP locais.
-- **Arquivos temporários:** Arquivos WAV intermediários são gravados em `%TEMP%\whisper_tmp_*.wav` e excluídos após a transcrição. Arquivos de estado de tarefas são gravados em `%TEMP%\whisper-mcp-jobs\` e persistem até serem limpos manualmente ou até o recurso de limpeza automática planejado ser lançado.
-- **Conteúdo de transcrição:** O texto de transcrição retornado nas respostas das ferramentas é processado pela API do Claude. Isso está documentado e será endereçável via `WHISPER_PRIVACY_MODE` em um release futuro. Veja [PRIVACY.md](PRIVACY.md).
+# Política de Segurança
+
+## Escopo
+
+O whisper-windows-mcp é uma ferramenta que prioriza o local. Todo o processamento de áudio acontece na sua máquina — nenhum áudio, arquivo de vídeo ou dado pessoal é transmitido para qualquer servidor. A superfície de ataque está limitada a:
+
+- O sistema de arquivos local (caminhos de arquivo passados às ferramentas)
+- O binário whisper-cli.exe e suas dependências
+- A conexão MCP do Claude Desktop (apenas IPC local)
+- Texto de transcrição retornado nas respostas das ferramentas (veja Arquitetura de Privacidade abaixo)
+
+## Arquitetura de Privacidade
+
+**Arquivos de áudio nunca saem da sua máquina.** Essa garantia é incondicional.
+
+**Texto de transcrição pode sair da sua máquina no modo padrão.** Quando uma resposta de ferramenta inclui texto de transcrição, esse texto é processado pela API do Claude. Este é o comportamento padrão do MCP, mas cria uma lacuna entre a filosofia de design "prioridade local" da ferramenta e o fluxo de dados real para usuários que lidam com conteúdo regulamentado ou confidencial.
+
+**O modo de privacidade** (`WHISPER_PRIVACY_MODE=true` ou `privacy_mode=true` por chamada) restringe todas as respostas das ferramentas apenas a metadados — nenhum texto de transcrição retornado à API do Claude. Esta é a configuração correta para implantações médicas, jurídicas, financeiras e corporativas.
+
+**Porta do modo de privacidade:** Quando o modo de privacidade está ativo, uma confirmação de divulgação explícita é exibida antes de cada operação de transcrição. Isso é intencional e não pode ser contornado — a conformidade regulatória exige consentimento informado por operação.
+
+**Porta de consentimento:** No modo padrão, uma divulgação única por sessão é exibida antes que o texto de transcrição seja retornado à API pela primeira vez em uma sessão. Defina `WHISPER_CONSENT_ACKNOWLEDGED=true` na sua configuração para suprimir isso para conteúdo não sensível.
+
+Veja [PRIVACY.md](PRIVACY.md) para a descrição completa da arquitetura de privacidade, orientação sobre frameworks de conformidade (HIPAA, GDPR, privilégio advogado-cliente, FERPA, SOX, PCI-DSS) e instruções de configuração.
+
+## Verificação do binário
+
+Para verificar a integridade do binário `whisper-cli.exe` no release pré-compilado, verifique o hash SHA256 no PowerShell:
+
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
+
+O hash esperado para cada binário de release é publicado na [página de releases](https://github.com/eviscerations/whisper-windows-mcp/releases). Não use um binário cujo hash não corresponda.
+
+## Versões suportadas
+
+Correções de segurança são aplicadas apenas à versão publicada mais recente.
+
+| Versão | Suportada |
+|---|---|
+| 2.x (mais recente) | ✅ |
+| 1.x | ❌ |
+
+## Reportando uma vulnerabilidade
+
+**Não abra uma issue pública para vulnerabilidades de segurança.**
+
+Use o relatório privado de vulnerabilidade do GitHub:
+1. Vá para a [aba Security](https://github.com/eviscerations/whisper-windows-mcp/security)
+2. Clique em "Report a vulnerability"
+3. Descreva o problema com detalhes suficientes para reproduzi-lo
+
+Você receberá uma resposta em até 7 dias. Se a vulnerabilidade for confirmada, uma correção será lançada o mais rápido possível e você será creditado nas notas de release se desejar.
+
+## Sandbox e aprovações
+
+whisper-windows-mcp é uma **ferramenta local, de usuário único, controlada pelo proprietário da máquina por meio do Claude Desktop.** Seu modelo de ameaças é o proprietário executando-a na própria máquina — não uma implantação não confiável, multilocatária ou exposta à rede.
+
+- **Sandbox:** nenhum, por design. O `whisper-cli.exe` é executado no nível de permissão do próprio proprietário, igual a qualquer servidor MCP local. O isolamento em nível de SO não é a mitigação aqui; o escopo de uso é — **não exponha este servidor a acesso de rede não confiável** (veja "Injeção de caminho de arquivo" abaixo).
+- **As aprovações são em camadas, não baseadas em sandbox:**
+  1. **Aprovação do host** — a camada MCP do Claude Desktop controla a invocação de ferramentas.
+  2. **Barreiras de consentimento / privacidade** — uma confirmação explícita é necessária antes que qualquer texto de transcrição saia da máquina para a API do Claude; `WHISPER_PRIVACY_MODE` / `privacy_mode` por chamada retorna apenas metadados para conteúdo regulamentado. A barreira é chaveada por operação (ferramenta + argumentos). Veja [PRIVACY.md](PRIVACY.md).
+  3. **Validação de entrada** — caminhos de travessia de diretório e UNC são rejeitados; `switch_model` é contido ao diretório de modelos configurado; `download_model` é restrito a uma lista de permissões de namespaces confiáveis do Hugging Face.
+
+Esta ferramenta **não** foi projetada para ser controlada por um agente não confiável nem executada como infraestrutura compartilhada. Essa postura exigiria sandbox de SO/contêiner e uma política de egresso — fora do escopo de uma ferramenta de transcrição local de usuário único.
+
+## Decisões de design conhecidas
+
+- **Injeção de caminho de arquivo:** As ferramentas aceitam caminhos absolutos de arquivo do Claude. Isso é por design — a ferramenta é destinada a ser usada com o Claude Desktop pelo proprietário da máquina. Não exponha este servidor MCP a acesso de rede não confiável.
+- **Sem sandbox:** O whisper-cli.exe é executado com as mesmas permissões que o Claude Desktop. Isso é padrão para ferramentas MCP locais.
+- **Arquivos temporários:** Arquivos WAV intermediários são gravados em `%TEMP%\whisper_tmp_*.wav` e excluídos após a transcrição. Arquivos de estado de tarefas são gravados em `%TEMP%\whisper-mcp-jobs\` e são limpos automaticamente após 7 dias na inicialização do servidor.
+- **Conteúdo de transcrição:** O texto de transcrição retornado nas respostas das ferramentas é processado pela API do Claude no modo padrão. Para evitar isso, ative `WHISPER_PRIVACY_MODE=true` ou passe `privacy_mode=true` por chamada. Veja [PRIVACY.md](PRIVACY.md).
+- **Injeção de transcrição:** Arquivos de áudio podem conter conteúdo falado que, quando transcrito, se assemelha a instruções. As defesas integradas do Claude lidam com isso. O próprio servidor MCP marca todo o conteúdo de transcrição como dados não confiáveis e nunca o interpreta como instruções.
+- **Downloads de modelos são restritos:** A ferramenta `download_model` só faz download de dois namespaces do Hugging Face confiáveis (`ggerganov/whisper.cpp` e `ggml-org`). Redirecionamentos são validados contra uma lista de permissões antes de serem seguidos. URLs arbitrários são rejeitados no nível do código. Downloads truncados/incompletos são rejeitados (verificação de Content-Length) antes de um arquivo `.part` ser promovido ao nome do modelo.
+- **A troca de modelos é sandboxed:** `switch_model` só aceita arquivos `.bin` dentro do diretório de modelos configurado. Caminhos fora dele são rejeitados via contenção de caminho normalizada — um diretório com prefixo-irmão como `…\models-evil` não pode satisfazer a verificação — independentemente de como o caminho é especificado.

package/SECURITY.ro.md

@@ -1,47 +1,76 @@
-# Politică de securitate
-
-## Domeniu de aplicare
-
-whisper-windows-mcp este un instrument care prioritizează localul. Toată procesarea audio are loc pe calculatorul tău — niciun audio, fișier video sau date personale nu sunt transmise vreunui server. Suprafața de atac este limitată la:
-
-- Sistemul de fișiere local (căi de fișiere transmise instrumentelor)
-- Binarul whisper-cli.exe și dependențele sale
-- Conexiunea MCP Claude Desktop (doar IPC local)
-- Textul de transcriere returnat în răspunsurile instrumentelor (vezi Arhitectura de confidențialitate mai jos)
-
-## Arhitectura de confidențialitate
-
-**Fișierele audio nu părăsesc niciodată calculatorul tău.** Această garanție este necondiționată.
-
-**Textul de transcriere poate părăsi calculatorul tău.** Când un răspuns al instrumentului include text de transcriere, acel text este procesat de API-ul Claude. Acesta este comportamentul standard MCP, dar creează un decalaj între filosofia de proiectare "local prioritar" a instrumentului și fluxul real de date pentru utilizatorii care gestionează conținut reglementat sau confidențial.
-
-O variabilă de mediu `WHISPER_PRIVACY_MODE` este planificată care va restricționa toate răspunsurile instrumentelor doar la metadate — niciun text de transcriere nu este returnat la API-ul Claude. Aceasta este soluția prevăzută pentru implementările medicale, juridice, financiare și corporative.
-
-Vezi [PRIVACY.md](PRIVACY.md) pentru descrierea completă a arhitecturii de confidențialitate, îndrumări privind cadrele de conformitate (HIPAA, GDPR, privilegiu avocat-client, FERPA, SOX, PCI-DSS) și instrucțiuni de configurare.
-
-## Versiuni suportate
-
-Corecțiile de securitate sunt aplicate doar celei mai recente versiuni publicate.
-
-| Versiune | Suportată |
-|---|---|
-| 2.x (cea mai recentă) | ✅ |
-| 1.x | ❌ |
-
-## Raportarea unei vulnerabilități
-
-**Nu deschide un issue public pentru vulnerabilități de securitate.**
-
-Folosește raportarea privată a vulnerabilităților GitHub:
-1. Mergi la [fila Security](https://github.com/eviscerations/whisper-windows-mcp/security)
-2. Fă clic pe "Report a vulnerability"
-3. Descrie problema cu suficiente detalii pentru a o reproduce
-
-Vei primi un răspuns în 7 zile. Dacă vulnerabilitatea este confirmată, o corecție va fi lansată cât mai curând posibil și vei fi creditat în notele de lansare dacă dorești.
-
-## Decizii de proiectare cunoscute
-
-- **Injecție de cale de fișier:** Instrumentele acceptă căi absolute de fișiere de la Claude. Acesta este un design intenționat — instrumentul este destinat utilizării cu Claude Desktop de către proprietarul calculatorului. Nu expune acest server MCP la acces de rețea neautorizat.
-- **Fără sandbox:** whisper-cli.exe rulează cu aceleași permisiuni ca Claude Desktop. Acesta este standard pentru instrumentele MCP locale.
-- **Fișiere temporare:** Fișierele WAV intermediare sunt scrise în `%TEMP%\whisper_tmp_*.wav` și șterse după transcriere. Fișierele de stare a sarcinilor sunt scrise în `%TEMP%\whisper-mcp-jobs\` și persistă până la ștergerea manuală sau până la lansarea funcției de curățare automată planificate.
-- **Conținut de transcriere:** Textul de transcriere returnat în răspunsurile instrumentelor este procesat de API-ul Claude. Acesta este documentat și va putea fi adresat prin `WHISPER_PRIVACY_MODE` într-o versiune viitoare. Vezi [PRIVACY.md](PRIVACY.md).
+# Politică de securitate
+
+## Domeniu de aplicare
+
+whisper-windows-mcp este un instrument care prioritizează localul. Toată procesarea audio are loc pe calculatorul tău — niciun audio, fișier video sau date personale nu sunt transmise vreunui server. Suprafața de atac este limitată la:
+
+- Sistemul de fișiere local (căi de fișiere transmise instrumentelor)
+- Binarul whisper-cli.exe și dependențele sale
+- Conexiunea MCP Claude Desktop (doar IPC local)
+- Textul de transcriere returnat în răspunsurile instrumentelor (vezi Arhitectura de confidențialitate mai jos)
+
+## Arhitectura de confidențialitate
+
+**Fișierele audio nu părăsesc niciodată calculatorul tău.** Această garanție este necondiționată.
+
+**Textul de transcriere poate părăsi calculatorul tău** în modul standard. Când un răspuns al instrumentului include text de transcriere, acel text este procesat de API-ul Claude. Acesta este comportamentul standard MCP, dar creează un decalaj între filosofia de proiectare "local prioritar" a instrumentului și fluxul real de date pentru utilizatorii care gestionează conținut reglementat sau confidențial.
+
+**Modul de confidențialitate** (`WHISPER_PRIVACY_MODE=true` sau `privacy_mode=true` per apel) restricționează toate răspunsurile instrumentelor doar la metadate — niciun text de transcriere nu este returnat la API-ul Claude. Aceasta este configurația corectă pentru implementările medicale, juridice, financiare și corporative.
+
+**Poarta modului de confidențialitate:** când modul de confidențialitate este activ, o dezvăluire de confirmare explicită este afișată înainte de fiecare operațiune de transcriere. Aceasta este intenționată și nu poate fi ocolită — conformitatea reglementară necesită consimțământ informat per operațiune.
+
+**Poarta de consimțământ:** în modul standard, o dezvăluire unică per sesiune este afișată înainte ca orice text de transcriere să fie returnat la API pentru prima dată. Setează `WHISPER_CONSENT_ACKNOWLEDGED=true` în configurația ta pentru a suprima aceasta pentru conținut non-sensibil.
+
+Vezi [PRIVACY.md](PRIVACY.md) pentru descrierea completă a arhitecturii de confidențialitate, îndrumări privind cadrele de conformitate (HIPAA, GDPR, privilegiu avocat-client, FERPA, SOX, PCI-DSS) și instrucțiuni de configurare.
+
+## Verificarea binarului
+
+Pentru a verifica integritatea binarului `whisper-cli.exe` din versiunea precompilată, verifică hash-ul său SHA256 în PowerShell:
+
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
+
+Hash-ul așteptat pentru fiecare binar de versiune este publicat pe [pagina de versiuni](https://github.com/eviscerations/whisper-windows-mcp/releases). Nu folosi un binar al cărui hash nu corespunde.
+
+## Versiuni suportate
+
+Corecțiile de securitate sunt aplicate doar celei mai recente versiuni publicate.
+
+| Versiune | Suportată |
+|---|---|
+| 2.x (cea mai recentă) | ✅ |
+| 1.x | ❌ |
+
+## Raportarea unei vulnerabilități
+
+**Nu deschide un issue public pentru vulnerabilități de securitate.**
+
+Folosește raportarea privată a vulnerabilităților GitHub:
+1. Mergi la [fila Security](https://github.com/eviscerations/whisper-windows-mcp/security)
+2. Fă clic pe "Report a vulnerability"
+3. Descrie problema cu suficiente detalii pentru a o reproduce
+
+Vei primi un răspuns în 7 zile. Dacă vulnerabilitatea este confirmată, o corecție va fi lansată cât mai curând posibil și vei fi creditat în notele de lansare dacă dorești.
+
+## Sandbox și aprobări
+
+whisper-windows-mcp este un **instrument local, cu un singur utilizator, controlat de proprietarul calculatorului prin Claude Desktop.** Modelul său de amenințare este proprietarul care îl rulează pe propriul calculator — nu o implementare neautorizată, multi-tenant sau expusă la rețea.
+
+- **Sandbox:** niciunul, prin design. `whisper-cli.exe` rulează la nivelul de permisiuni al proprietarului însuși, la fel ca orice server MCP local. Izolarea la nivel de SO nu este măsura de atenuare aici; domeniul de utilizare este — **nu expune acest server la acces de rețea neautorizat** (vezi „Injecție de cale de fișier" mai jos).
+- **Aprobările sunt stratificate, nu bazate pe sandbox:**
+  1. **Aprobarea gazdei** — stratul MCP al Claude Desktop controlează invocarea instrumentelor.
+  2. **Bariere de consimțământ / confidențialitate** — o confirmare explicită este necesară înainte ca orice text de transcriere să părăsească calculatorul către API-ul Claude; `WHISPER_PRIVACY_MODE` / `privacy_mode` per apel returnează doar metadate pentru conținut reglementat. Bariera este cheiată per operațiune (instrument + argumente). Vezi [PRIVACY.md](PRIVACY.md).
+  3. **Validarea intrărilor** — căile de traversare a directoarelor și UNC sunt respinse; `switch_model` este limitat la directorul de modele configurat; `download_model` este restricționat la o listă de permise de spații de nume Hugging Face de încredere.
+
+Acest instrument **nu** este conceput pentru a fi controlat de un agent neautorizat sau rulat ca infrastructură partajată. O astfel de poziție ar necesita sandbox de SO/container și o politică de ieșire — în afara domeniului unui instrument de transcriere local cu un singur utilizator.
+
+## Decizii de proiectare cunoscute
+
+- **Injecție de cale de fișier:** Instrumentele acceptă căi absolute de fișiere de la Claude. Acesta este un design intenționat — instrumentul este destinat utilizării cu Claude Desktop de către proprietarul calculatorului. Nu expune acest server MCP la acces de rețea neautorizat.
+- **Fără sandbox:** whisper-cli.exe rulează cu aceleași permisiuni ca Claude Desktop. Acesta este standard pentru instrumentele MCP locale.
+- **Fișiere temporare:** Fișierele WAV intermediare sunt scrise în `%TEMP%\whisper_tmp_*.wav` și șterse după transcriere. Fișierele de stare a sarcinilor sunt scrise în `%TEMP%\whisper-mcp-jobs\` și curățate automat după 7 zile la pornirea serverului.
+- **Conținut de transcriere:** Textul de transcriere returnat în răspunsurile instrumentelor este procesat de API-ul Claude în modul standard. Activează `WHISPER_PRIVACY_MODE=true` sau transmite `privacy_mode=true` per apel pentru a preveni aceasta. Vezi [PRIVACY.md](PRIVACY.md).
+- **Injecție de transcriere:** Fișierele audio pot conține conținut vorbit care, atunci când este transcris, seamănă cu instrucțiuni. Apărările încorporate ale Claude gestionează acest lucru. Serverul MCP în sine marchează tot conținutul de transcriere ca date neautorizate și nu le interpretează niciodată ca instrucțiuni.
+- **Descărcări de modele:** Instrumentul `download_model` descarcă doar din două spații de nume Hugging Face de încredere (`ggerganov/whisper.cpp` și `ggml-org`). Redirecționările sunt validate față de o listă de permise înainte de a fi urmate. URL-urile arbitrare sunt respinse la nivel de cod. Descărcările trunchiate/incomplete sunt respinse (verificare Content-Length) înainte ca un fișier `.part` să fie promovat la numele modelului.
+- **Schimbarea modelelor:** `switch_model` acceptă doar fișiere `.bin` în directorul de modele configurat. Căile din afara lui sunt respinse prin izolare normalizată a căilor — un director cu prefix-frate precum `…\models-evil` nu poate satisface verificarea — indiferent de modul în care este specificată calea.

package/SECURITY.uk.md

@@ -1,47 +1,76 @@
-# Політика безпеки
-
-## Область охоплення
-
-whisper-windows-mcp — інструмент з пріоритетом локальності. Все аудіоопрацювання відбувається на вашому комп'ютері — жодні аудіо-, відеофайли чи персональні дані не передаються на жодний сервер. Поверхня атаки обмежена:
-
-- Локальна файлова система (шляхи до файлів, що передаються інструментам)
-- Бінарник whisper-cli.exe та його залежності
-- З'єднання Claude Desktop MCP (лише локальний IPC)
-- Текст транскрипції, що повертається у відповідях інструментів (дивіться Архітектуру конфіденційності нижче)
-
-## Архітектура конфіденційності
-
-**Аудіофайли ніколи не покидають ваш комп'ютер.** Ця гарантія є безумовною.
-
-**Текст транскрипції може покидати ваш комп'ютер.** Коли відповідь інструменту містить текст транскрипції, цей текст опрацьовується API Claude. Це стандартна поведінка MCP, але вона створює розрив між філософією дизайну "локальний пріоритет" і фактичним потоком даних для користувачів, що працюють з регульованим або конфіденційним контентом.
-
-Планується змінна середовища `WHISPER_PRIVACY_MODE`, яка обмежить усі відповіді інструментів лише метаданими — жодний текст транскрипції не повертатиметься API Claude. Це передбачуване рішення для медичних, юридичних, фінансових і корпоративних розгортань.
-
-Повний опис архітектури конфіденційності, настанови щодо нормативних вимог (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\` і зберігаються до ручного очищення або до виходу запланованої функції автоочищення.
-- **Вміст транскрипції:** Текст транскрипції, що повертається у відповідях інструментів, опрацьовується API Claude. Це задокументовано і буде вирішено через `WHISPER_PRIVACY_MODE` у майбутньому релізі. Дивіться [PRIVACY.md](PRIVACY.md).
+# Політика безпеки
+
+## Область охоплення
+
+whisper-windows-mcp — інструмент з пріоритетом локальності. Все аудіоопрацювання відбувається на вашому комп'ютері — жодні аудіо-, відеофайли чи персональні дані не передаються на жодний сервер. Поверхня атаки обмежена:
+
+- Локальна файлова система (шляхи до файлів, що передаються інструментам)
+- Бінарник whisper-cli.exe та його залежності
+- З'єднання Claude Desktop MCP (лише локальний IPC)
+- Текст транскрипції, що повертається у відповідях інструментів (дивіться Архітектуру конфіденційності нижче)
+
+## Архітектура конфіденційності
+
+**Аудіофайли ніколи не покидають ваш комп'ютер.** Ця гарантія є безумовною.
+
+**Текст транскрипції може покидати ваш комп'ютер** у стандартному режимі. Коли відповідь інструменту містить текст транскрипції, цей текст опрацьовується API Claude. Це стандартна поведінка MCP, але вона створює розрив між філософією дизайну "локальний пріоритет" і фактичним потоком даних для користувачів, що працюють з регульованим або конфіденційним контентом.
+
+**Режим конфіденційності** (`WHISPER_PRIVACY_MODE=true` або `privacy_mode=true` для окремого виклику) обмежує всі відповіді інструментів лише метаданими — жодний текст транскрипції не повертається API Claude. Це правильне налаштування для медичних, юридичних, фінансових і корпоративних розгортань.
+
+**Ворота режиму конфіденційності:** коли режим конфіденційності активний, перед кожною операцією транскрипції відображається явне підтвердження розкриття. Це навмисно і не може бути обійдено — відповідність нормативним вимогам потребує поінформованої згоди перед кожною операцією.
+
+**Ворота згоди:** у стандартному режимі одноразове розкриття для сеансу відображається перед першим поверненням тексту транскрипції до API. Встановіть `WHISPER_CONSENT_ACKNOWLEDGED=true` у конфігурації, щоб пропустити це для нечутливого контенту.
+
+Повний опис архітектури конфіденційності, настанови щодо нормативних вимог (HIPAA, GDPR, адвокатська таємниця, FERPA, SOX, PCI-DSS) та інструкції з налаштування — у [PRIVACY.md](PRIVACY.md).
+
+## Перевірка бінарника
+
+Щоб перевірити цілісність бінарника `whisper-cli.exe` у готовому релізі, перевірте його хеш SHA256 у PowerShell:
+
+```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 днів. Якщо вразливість підтверджено, виправлення буде випущено якнайшвидше, і вас буде вказано в примітках до релізу за вашим бажанням.
+
+## Пісочниця та схвалення
+
+whisper-windows-mcp — це **локальний інструмент для одного користувача, який керується власником комп'ютера через Claude Desktop.** Його модель загроз — це власник, який запускає його на власному комп'ютері — а не ненадійне, багатоорендне або відкрите в мережу розгортання.
+
+- **Пісочниця:** відсутня, за задумом. `whisper-cli.exe` запускається на рівні прав самого власника, так само як будь-який локальний MCP-сервер. Засобом пом'якшення тут є не ізоляція на рівні ОС, а сфера використання — **не відкривайте цей сервер для ненадійного мережевого доступу** (див. «Ін'єкція шляху до файлу» нижче).
+- **Схвалення є багаторівневими, а не на основі пісочниці:**
+  1. **Схвалення хоста** — рівень MCP Claude Desktop контролює виклик інструментів.
+  2. **Бар'єри згоди / конфіденційності** — перед тим, як будь-який текст транскрипції залишить комп'ютер у напрямку API Claude, потрібне явне підтвердження; `WHISPER_PRIVACY_MODE` / `privacy_mode` для окремого виклику повертає лише метадані для регульованого контенту. Бар'єр ключований за операцією (інструмент + аргументи). Дивіться [PRIVACY.md](PRIVACY.md).
+  3. **Перевірка вводу** — шляхи з обходом каталогів і UNC відхиляються; `switch_model` обмежено налаштованою текою моделей; `download_model` обмежено списком дозволених довірених просторів імен Hugging Face.
+
+Цей інструмент **не** призначений для керування ненадійним агентом чи запуску як спільна інфраструктура. Така позиція вимагала б пісочниці ОС/контейнера та політики вихідного трафіку — поза межами локального інструмента транскрипції для одного користувача.
+
+## Відомі проєктні рішення
+
+- **Ін'єкція шляху до файлу:** Інструменти приймають абсолютні шляхи до файлів від Claude. Це навмисний дизайн — інструмент призначено для використання власником комп'ютера разом з Claude Desktop. Не відкривайте цей MCP-сервер для ненадійного мережевого доступу.
+- **Відсутність пісочниці:** whisper-cli.exe запускається з тими самими правами, що і Claude Desktop. Це стандарт для локальних MCP-інструментів.
+- **Тимчасові файли:** Проміжні WAV-файли записуються до `%TEMP%\whisper_tmp_*.wav` і видаляються після транскрипції. Файли стану завдань записуються до `%TEMP%\whisper-mcp-jobs\` і автоматично очищуються через 7 днів при запуску сервера.
+- **Вміст транскрипції:** Текст транскрипції, що повертається у відповідях інструментів, опрацьовується API Claude у стандартному режимі. Увімкніть `WHISPER_PRIVACY_MODE=true` або передайте `privacy_mode=true` для окремого виклику, щоб запобігти цьому. Дивіться [PRIVACY.md](PRIVACY.md).
+- **Ін'єкція транскрипції:** Аудіофайли можуть містити вимовлений контент, який після транскрипції нагадує інструкції. Вбудований захист Claude впорається з цим. Сам MCP-сервер позначає весь вміст транскрипції як ненадійні дані і ніколи не інтерпретує їх як інструкції.
+- **Завантаження моделей:** Інструмент `download_model` завантажує лише з двох довірених просторів імен Hugging Face (`ggerganov/whisper.cpp` і `ggml-org`). Переспрямування перевіряються за списком дозволених перед виконанням. Довільні URL-адреси відхиляються на рівні коду. Обрізані/неповні завантаження відхиляються (перевірка Content-Length) перед тим, як файл `.part` буде підвищено до імені моделі.
+- **Перемикання моделей:** `switch_model` приймає лише `.bin`-файли з налаштованої теки моделей. Шляхи за її межами відхиляються через нормалізоване утримання шляхів — каталог із братнім префіксом, такий як `…\models-evil`, не може задовольнити перевірку — незалежно від способу вказання шляху.