Dati e privacy

#Dentro .ferret/reviews/

<project>/.ferret/reviews/20261003-104500/
├── feedback.md      # what the agent reads
├── 01.png, 02.png…  # one or more images per finding
├── session.json     # review state and edit history
├── events.jsonl     # action log (built-in browser only)
├── recording.webm   # the video
└── work/            # intermediate audio and frames

Le revisioni create prima del cambio di nome si trovano in .ade-movie/reviews/. Vengono ancora elencate e aperte, e le nuove revisioni vanno in .ferret/reviews/.

All'avvio della registrazione, .ferret/ viene aggiunto a .git/info/exclude. Worktree e submodule sono gestiti. .gitignore non viene mai modificato. Una revisione interrotta si può recuperare dalla cronologia se i suoi dati sono sopravvissuti. In tal caso l'app avvisa che gli ultimi secondi potrebbero mancare.

#Conservazione

Conserva registrazioni (7 giorni per impostazione predefinita, 30 giorni oppure Per sempre): all'avvio, le revisioni completate più vecchie di così perdono recording.webm e work/. feedback.md e le immagini delle segnalazioni vengono conservati. Le revisioni incomplete non vengono mai ripulite. La pulizia avviene all'avvio, per l'ultimo progetto aperto.

#Cosa lascia la tua macchina

• L'app non ha analytics, né tracciamento delle prestazioni, né session replay. Gli unici dati che invia senza che tu lo chieda sono i report sugli arresti anomali: errori, una sessione per avvio e avvisi di avvio lento e di blocco, tutti descritti più sotto e tutti controllati da Invia report sugli arresti anomali.
• I valori che sembrano segreti negli URL (token, chiavi) vengono oscurati prima di essere scritti in feedback.md.
• Il testo catturato dalla pagina è contrassegnato come dati in feedback.md, quindi all'agent viene detto di non seguire le istruzioni che vi si trovano.
• Questo sito web (non l'app) conta le visualizzazioni delle pagine con Cloudflare Web Analytics: senza cookie, senza tracciamento tra siti e senza dati personali.

#Feedback dall'app

Potrai inviare una segnalazione di bug o un'idea dall'interno di Ferret senza un account GitHub. Viene inviata solo quando la invii tu, e diventa una issue pubblica in JapanMarketing-Dev/ferret (si apre in una nuova scheda), con l'etichetta from-app. Non includere nulla che non pubblicheresti apertamente.

• L'app la invia dal tuo computer a un piccolo relay (un Cloudflare Worker gestito dallo sviluppatore), che apre la issue con il proprio token GitHub. Questo relay è l'unico server dello sviluppatore che riceve qualcosa di ciò che scrivi.
• Inviati: titolo e testo, se si tratta di un bug o di un'idea, la versione dell'app e fino a 3 screenshot PNG o JPEG che alleghi. Nome e versione del sistema operativo, architettura della CPU e l'ID di installazione casuale vengono inviati solo se li lasci inclusi. Non inviati: il tuo nome, la tua email, il tuo account GitHub, i file del progetto, le registrazioni o le segnalazioni.
• Prima che la issue venga creata, il relay maschera il testo che sembra una chiave o un token, gli indirizzi email e il nome utente nei percorsi della cartella home, e impedisce alle @mentions di inviare notifiche. Rimuove anche la posizione e gli altri metadati dagli screenshot. Controlla comunque il testo: il mascheramento non può intercettare tutto.
• Il relay non memorizza il tuo indirizzo IP. Per limitare la frequenza con cui uno stesso mittente può pubblicare (5 all'ora, 20 al giorno), conta un hash con chiave dell'indirizzo IP (e dell'ID di installazione, se inviato) per un massimo di 24 ore, poi lo elimina. Nessuno dei due compare nella issue.
• Gli screenshot vengono conservati dal relay in Cloudflare R2 con nomi non indovinabili e mostrati nella issue. Per far rimuovere una issue o i suoi screenshot, commenta la issue o aprine una nuova.
• Il codice del relay si trova in workers/feedback-relay nel repository.

#Report sugli arresti anomali

Quando l'app si arresta in modo anomalo o incontra un errore non gestito, Ferret invia un report a Sentry (si apre in una nuova scheda) perché il bug possa essere corretto. È attivo per impostazione predefinita. Disattivalo in Impostazioni → Privacy → Invia report sugli arresti anomali, oppure con Disattiva nell'avviso mostrato al primo avvio. La disattivazione ha effetto immediato. La riattivazione ha effetto dal successivo avvio. Anche le build di sviluppo (pnpm dev) inviano report, con il tag development, così gli sviluppatori possono correggere gli arresti anomali che incontrano mentre lavorano. Le esecuzioni E2E e i test unitari non inviano mai nulla.

L'app installata invia al massimo 10 report per avvio e solo metà degli errori JavaScript (gli arresti anomali nativi vengono sempre inviati). Le build di sviluppo inviano ogni errore, fino a 50 per avvio. Lo stesso errore viene inviato una sola volta per avvio. Gli avvii lenti (oltre 5 secondi) e i blocchi prolungati dell'app (oltre 1 secondo) vengono inviati come avvisi, al massimo una volta ogni 10 minuti. Non si usano tracciamento delle prestazioni né session replay. L'app usa il piano gratuito di Sentry. Se si esaurisce, i report in eccesso vengono scartati e a nessuno viene addebitato nulla.

Compili Ferret da te? Imposta FERRET_SENTRY_DSN (funziona anche il vecchio nome MOVIE_ADE_SENTRY_DSN) sul tuo DSN di Sentry, oppure su una stringa vuota per non inviare nulla. Il codice si trova in src/main/telemetry.ts e src/shared/telemetry.ts.