Data dan privasi

#Isi .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

Tinjauan yang dibuat sebelum penggantian nama berada di .ade-movie/reviews/. Tinjauan tersebut tetap ditampilkan dan bisa dibuka, sedangkan tinjauan baru masuk ke .ferret/reviews/.

Saat perekaman dimulai, .ferret/ ditambahkan ke .git/info/exclude. Worktree dan submodule juga ditangani. .gitignore tidak pernah diubah. Tinjauan yang terputus dapat dipulihkan dari riwayat jika catatannya masih ada. Aplikasi kemudian memperingatkan bahwa beberapa detik terakhir mungkin hilang.

#Masa simpan

Simpan rekaman (7 hari secara bawaan, 30 hari, atau Selamanya): saat aplikasi dimulai, tinjauan selesai yang lebih lama dari itu kehilangan recording.webm dan work/. feedback.md dan gambar temuan tetap disimpan. Tinjauan yang belum selesai tidak pernah dipangkas. Pemangkasan berjalan saat peluncuran, untuk proyek yang terakhir dibuka.

#Apa yang keluar dari mesin Anda

• Aplikasi ini tidak memiliki analitik, pelacakan performa, maupun session replay. Satu-satunya data yang dikirimnya tanpa Anda minta adalah pelaporan crash: error, satu sesi per peluncuran, serta peringatan startup lambat dan aplikasi macet, yang semuanya dijelaskan di bawah dan semuanya dikendalikan oleh Kirim laporan crash.
• Nilai di URL yang tampak seperti rahasia (token, key) disamarkan sebelum ditulis ke feedback.md.
• Teks yang diambil dari halaman ditandai sebagai data di feedback.md, sehingga agent diberi tahu untuk tidak mengikuti instruksi yang ada di dalamnya.
• Situs web ini (bukan aplikasinya) menghitung tampilan halaman dengan Cloudflare Web Analytics: tanpa cookie, tanpa pelacakan lintas situs, dan tanpa data pribadi.

#Umpan balik dari aplikasi

Anda akan bisa mengirim laporan bug atau ide dari dalam Ferret tanpa akun GitHub. Umpan balik hanya dikirim saat Anda mengirimnya, dan menjadi issue publik di JapanMarketing-Dev/ferret (terbuka di tab baru) dengan label from-app. Jangan sertakan apa pun yang tidak akan Anda unggah secara publik.

• Aplikasi mengirimnya dari komputer Anda ke relay kecil (Cloudflare Worker yang dijalankan pengembang), yang membuka issue dengan token GitHub miliknya sendiri. Relay ini adalah satu-satunya server milik pengembang yang menerima apa pun yang Anda tulis.
• Yang dikirim: judul dan teks Anda, apakah itu bug atau ide, versi aplikasi, dan hingga 3 screenshot PNG atau JPEG yang Anda lampirkan. Nama dan versi OS, arsitektur CPU, serta ID instalasi acak hanya dikirim jika Anda membiarkannya tetap disertakan. Yang tidak dikirim: nama, email, akun GitHub, file proyek, rekaman, atau temuan Anda.
• Sebelum issue dibuat, relay menyamarkan teks yang tampak seperti key atau token, alamat email, dan nama pengguna di path folder home, serta mencegah @mentions memberi notifikasi kepada siapa pun. Relay juga menghapus lokasi dan metadata lain dari screenshot. Tetap periksa teks Anda: penyamaran tidak bisa menangkap semuanya.
• Relay tidak menyimpan alamat IP Anda. Untuk membatasi seberapa sering satu pengirim bisa mengirim (5 per jam, 20 per hari), relay menghitung hash berkunci dari alamat IP (dan dari ID instalasi, jika dikirim) hingga 24 jam, lalu menghapusnya. Keduanya tidak muncul di issue.
• Screenshot disimpan oleh relay di Cloudflare R2 dengan nama yang tidak bisa ditebak dan ditampilkan di issue. Untuk meminta penghapusan issue atau screenshot-nya, beri komentar di issue tersebut atau buka issue baru.
• Kode relay ada di workers/feedback-relay di repositori.

#Laporan crash

Saat aplikasi crash atau mengalami error yang tidak tertangani, Ferret mengirim laporan crash ke Sentry (terbuka di tab baru) agar bug-nya bisa diperbaiki. Fitur ini aktif secara bawaan. Matikan di Pengaturan → Privasi → Kirim laporan crash, atau dengan Nonaktifkan pada pemberitahuan yang muncul saat peluncuran pertama. Mematikannya langsung berlaku. Menyalakannya kembali berlaku pada peluncuran berikutnya. Build pengembangan (pnpm dev) juga mengirim, dengan tag development, agar pengembang bisa memperbaiki crash yang mereka alami saat bekerja. Pengujian E2E dan unit test tidak pernah mengirim.

Aplikasi yang terinstal mengirim paling banyak 10 laporan per peluncuran dan hanya separuh dari error JavaScript (crash native selalu dikirim). Build pengembangan mengirim setiap error, hingga 50 per peluncuran. Error yang sama hanya dikirim sekali per peluncuran. Startup lambat (lebih dari 5 detik) dan aplikasi macet lama (lebih dari 1 detik) dikirim sebagai peringatan, paling banyak sekali setiap 10 menit. Tidak ada pelacakan performa maupun session replay yang dipakai. Aplikasi memakai paket gratis Sentry. Jika kuotanya penuh, laporan tambahan dibuang dan tidak ada yang dikenai biaya.

Membangun Ferret sendiri? Atur FERRET_SENTRY_DSN (nama lama MOVIE_ADE_SENTRY_DSN juga berfungsi) ke DSN Sentry Anda sendiri, atau ke string kosong agar tidak mengirim apa pun. Kodenya ada di src/main/telemetry.ts dan src/shared/telemetry.ts.