Changelog¶
Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
O formato é baseado em Keep a Changelog, e este projeto adere ao Semantic Versioning.
[Unreleased]¶
✨ Adicionado¶
- Atualização automática, como no VintageLightbox: com as Command Line Tools ou o Xcode, a versão nova é compilada sozinha em segundo plano (
nice), sem clique e sem fechar o app — oinstall.sh --in-backgroundtroca o bundle no disco; a faixa diz "Versão X instalada — entra na próxima abertura, ou Reabrir Agora" e sai uma notificação. A versão instalada é conferida no disco; uma falha não é retentada sozinha por 24 h; uma trava impede dois instaladores e um app reaberto no meio retoma o acompanhamento. - Aviso de versão nova: como no VintageLightbox, sem GitHub Actions nem conta de desenvolvedor da Apple. O app lê
docs/updates.json(raw.githubusercontent, com o GitHub Pages de reserva) ao abrir e de hora em hora; com versão nova, o ícone da barra de menus ganha um ponto, o popover mostra uma faixa com as novidades (Atualizar · Novidades · Depois) e sai uma notificação do macOS, uma vez por versão. Atualizar roda oinstall.shem segundo plano e o app reabre sozinho na versão nova; sem ferramentas de compilação, abre a página de download. Procurar Atualizações… nos Ajustes. - Inglês e português: o app inteiro (popover, Disk X-Ray, alertas, mensagens de escaneamento e de erro, App Intents) segue o idioma do macOS — português do Brasil ou inglês. Textos que estavam em português no código viraram inglês com tradução; os nomes das categorias ganharam
displayNametraduzido (orawValuesegue como identidade). Catálogo emLocalization/Localizable.xcstrings, atualizado pormake strings; um teste falha se faltar tradução ou se um marcador (%@) mudar. A recomendação da Apple Intelligence responde no idioma do sistema. - Site no idioma do navegador: a primeira visita de um navegador em português vai para
/pt/; a escolha no seletor de idioma fica guardada. - Boas-vindas depois de instalar: o app só existe na barra de menus, então depois de instalar ninguém sabia onde ele estava. Agora um balão sai do próprio ícone ("MAC-LIMPO lives here in the menu bar"), com Open MAC-LIMPO e Got It; se o ícone estiver escondido (notch, barra cheia), um alerta diz onde procurar. Aparece quando o
install.shou o.pkgabrem o app e na primeira execução. - Disk X-Ray — lupa com pinça: amplia o mapa até 10⁸× (um arquivo de 1 KB num disco inteiro) com pinça, roda do mouse ou ⌥ + rolar, sem precisar clicar na janela antes; arrastar/rolar desloca com inércia, e o mapa redesenha nítido durante o gesto, com camadas por baixo para nunca sobrar borda vazia. O layout é só o squarified dos tamanhos — ampliar não muda a arrumação, e a área fica proporcional ao tamanho em qualquer zoom.
- Disk X-Ray — ir até a seleção: ⌘↩ ou Magnify to Fit voa até o item, por menor que seja; selecionar na árvore ou em Largest Files leva o mapa até ele sem exagero (no máximo até a pasta dele encher a tela), e itens pequenos demais para o contorno ganham um pino com nome e tamanho. A caixa azul desliza até a nova seleção, com um pulso ao chegar.
- Disk X-Ray — modo 3D (Metal): botão de cubo na barra de ferramentas; a GPU desenha o mapa como almofadas iluminadas (cushion treemap), com as pastas aparecendo como vincos, nítido quadro a quadro em qualquer zoom. O 2D continua o mesmo de antes e é o padrão.
- Disk X-Ray — nomes e tooltip: botão Labels liga/desliga os nomes dos blocos e cabeçalhos (2D e 3D); parar o ponteiro sobre um bloco mostra o nome e o tamanho numa bandeirinha 3D, como um tooltip, que vira de lado perto da borda.
- .NET — modo agressivo: remove SDKs de majors fora de suporte (6, 7) e bandas superadas do mesmo
major.minor(9.0.102 com 9.0.306 instalado), preservando o SDK mais novo e a banda fixada por qualquerglobal.json; e desinstala workloads (MAUI, Android, iOS, Aspire 8…) que nenhum projeto em~/Projectse pastas afins usa — vários GB empacks/. - Homebrew: além do cache, roda
brew cleanup --prune=all(versões antigas, downloads, links quebrados) ebrew autoremove(dependências órfãs), e lista as ferramentas grandes que você instalou e das quais nada depende, com o comando para remover. - iOS Simulators — runtimes órfãos: o card aponta runtimes que o Xcode não usa mais e que continuam em
/System/Library/AssetsV2(sobra dosimctl runtime delete, que só desregistra), com o tamanho e o comando para remover pelo Terminal da Recuperação — a pasta é protegida pelo SIP, nemsudo rmapaga. - Docker — limpeza total (opcional): novo ajuste "Docker full cleanup" para máquinas de desenvolvimento. Para todos os contêineres e remove contêineres (com os logs), todas as imagens, todos os volumes — bancos de dados incluídos, build cache e redes. Desligado por padrão, não fica salvo entre aberturas do app e sempre pede confirmação. O card lista cada volume que será apagado.
- Docker — caches em uso visíveis: o card mostra os volumes de cache de build presos a um contêiner (ex.:
cargo-target10 GB emrecordarfotos-dev-api-1), e volumes*-cargo(CARGO_HOME) passam a contar como cache. - Liquid Glass é o tema principal e todo nativo: padrão para quem nunca escolheu tema e primeiro no seletor. O popover usa só componentes do sistema —
ListcomSection,Gaugecircular,LabeledContent,Picker,Toggle,ProgressView,NSSearchField— e painéis de confirmação, progresso e resultado em vidro nativo. Classic, Cyberpunk e Matrix mantêm o visual próprio. - Tema Liquid Glass: tema com o vidro nativo da Apple (
glassEffect,GlassEffectContainer, botões.glass/.glassProminent) nos controles e na navegação; conteúdo em preenchimentos semânticos, sem vidro sobre vidro. Respeita Reduzir Transparência, Aumentar Contraste e Reduzir Movimento. - Disk X-Ray com cara nova: cores por categoria de arquivo (Vídeo, Imagens, Código, Discos virtuais…), cabeçalho com a barra do disco e cartões por categoria, painel de tipos, mapa squarified com pastas agrupadas, ladrilhos arredondados e rótulos, trilha de navegação, tamanhos no padrão do Finder e toolbar nativa da janela.
- Instalação por script (
docs/install.sh): compila e instala na própria máquina, sem depender de certificado de desenvolvedor. - Disk X-Ray = WinDirStat no Mac (substitui o Disk Map): port fiel da janela principal do WinDirStat — árvore "All Files" / "Largest Files", lista de extensões e treemap cushion sincronizados, com o layout "Rows", o sombreamento, a paleta e os padrões do código original. O scanner segue o motor do WinDirStat: leitura em lote por pasta com
getattrlistbulk(2)(o equivalente aoNtQueryDirectoryFile) e workers paralelos — ~2,9 milhões de itens em ~16 s, contra ~55 s comfts(espaço físico real, hardlinks uma vez, montagens virtuais fora);<Free Space>(F6) e<Unknown>(F7) fecham a conta com o disco inteiro. - .NET SDKs: nova categoria que remove patches superados de SDKs, runtimes e targeting packs em
/usr/local/share/dotnet(uma senha de admin) e~/.dotnet. Mantém o mais novo de cada feature band (SDK) e de cadamajor.minor(runtime/pack); previews e packs de workload nunca são tocados. - Cargo/Rust: remove toolchains rustup fixadas em versão que já foram superadas (canais,
default_toolchaine[overrides]ficam) e o lixo de~/.rustup/{downloads,tmp}. - IDE Cache: apaga extensões que o próprio editor marcou em
extensions/.obsolete(VS Code, Cursor, Trae, Antigravity, Windsurf, Kiro) e entradas do histórico local (User/History) sem toque há mais de 90 dias. - Docker: remove a cópia em
com.docker.install/in_progresssó quando a versão em staging não é mais nova que a instalada — uma atualização pendente é preservada. - Novos caminhos: cache do Yarn Berry (
~/.yarn/berry/cache),DocumentationCachedo Xcode e índice do Continue (~/.continue/index).
🐛 Corrigido¶
- Temp Files — scratchpads parados no /tmp: a pasta
/tmp/claude-<uid>, onde o Claude Code guarda um scratchpad por sessão, sempre tinha alguma sessão escrevendo e por isso nunca ficava 7 dias parada — umtargetdo Rust abandonado ali (9,5 GB) nunca saía. Agora cada<projeto>/<sessão>é julgada pela própria idade, com as mesmas regras de dono e de socket/FIFO, e vai para a Lixeira. - Escaneamento lendo o disco sem parar: quando a categoria de projetos passava do prazo de 7 minutos, o escaneamento era só abandonado e o
duseguia medindo as centenas denode_modulesde~/Projectsem segundo plano; cada atualização somava mais uma varredura, e o SSD ficava ocupado por dias. Agora o prazo cancela o escaneamento e encerra odu, que também roda com prioridade baixa de disco, e umnode_modulesque não mudou desde a última medição não é medido de novo. - Rust Targets — caches de build em pastas ocultas: a categoria só procurava
target/comCargo.tomlao lado em~/Projects, e deixava de fora o cache que instaladores guardam na home (~/.vintagelightbox/target-gpui, 11 GB). Agora procura também em~/.algoe~/.algo/qualquer, identificando peloCACHEDIR.TAGdo cargo +.rustc_info.json, e considera.cargo-build-locke.cargo-artifact-lockpara não limpar durante um build. - Atualização automática de quem instalou pelo
.pkg: com o Xcode ou as Command Line Tools, o app compilava a versão nova por 2–5 min e falhava no fim — a cópia do.pkgé do root e osudonão tem terminal em segundo plano —, de novo a cada 24 h. Agora essa cópia vai direto para a página da versão, e oinstall.shem segundo plano para antes de compilar quando não pode trocar o app (o que também vale para apps de versões anteriores). install.shnunca compila amainescondido: se a API do GitHub não respondia (limite de 60 pedidos por hora por IP), ele caía namain. Agora pergunta à API, depois ao redirecionamento da página de releases, depois ao site; sem resposta, para com uma mensagem clara.- Atualizar não deixa mais o Mac sem o app: o
install.shapagava o app instalado antes de copiar o novo — com o disco cheio, o usuário ficava sem nenhum. Agora copia ao lado e troca por renomeação; uma cópia que falha mantém o instalado. - Faixa presa em "atualizando": um logout ou reinício no meio do build deixava a trava sem status, e o app parava de procurar atualizações até ela vencer, 3 h depois. A trava agora guarda o PID do instalador (conferido pela hora de início, para um PID reaproveitado não contar); sem processo vivo ela é solta ao abrir, e um instalador que morre durante o acompanhamento vira falha.
- Procurar Atualizações não recompila a versão já instalada: depois de uma instalação em segundo plano, o app ainda aberto comparava só com a própria versão e compilava tudo de novo; agora compara com a do disco e oferece Reabrir Agora.
- Limpar Tudo não esvazia mais a Lixeira: a categoria Lixo rodava quase no fim e apagava de vez o que as outras tinham acabado de mandar para a Lixeira — justo o que a confirmação prometia que dava para restaurar. Agora o Lixo fica fora do Limpar Tudo (e do atalho da Siri), a confirmação dele diz que esvaziar é definitivo, e a limpeza não trava mais a interface.
- Downloads Antigos vão para a Lixeira: antes eram apagados de vez pela data do item de cima — uma pasta antiga com arquivos editados ontem sumia inteira. Agora só sai o que foi baixado há mais de 30 dias e não mudou nada nesse período, nem lá dentro.
- Arquivos Temporários não esvaziam mais o
/tmp: ele também caía na lista genérica e era apagado inteiro, sem filtro de idade, levando sockets de sessões abertas (ssh-agent, tmux). Agora só sai o que é seu, está parado há 7 dias e não tem socket nem pipe — e vai para a Lixeira. - Snapshots do Time Machine só no modo agressivo: Dados do Sistema pedia a senha de administrador e apagava todos os snapshots locais em toda limpeza. Agora só com a Limpeza agressiva ligada, e a confirmação avisa.
- Restos de Apps sem falso positivo: um app contava como desinstalado se não existisse
/Applications/<nome exato>.app— VS Code em~/Applicationsou IDEs do JetBrains Toolbox perdiam os ajustes, de vez. Agora o app é procurado pelo bundle id no Mac inteiro, a pasta precisa estar parada há 90 dias, pasta que guarda app nunca sai, o Android SDK (usado também por Flutter e React Native) só sai no modo agressivo, e tudo vai para a Lixeira. - Cache de IDEs preserva o
workspaceStorage: o estado de cada projeto do VS Code e do Cursor, com o histórico de chat, era apagado inteiro e de vez. Agora só sai o de projeto que não existe mais e está parado há 60 dias, para a Lixeira. - Cache do Xcode mantém os Archives: os dSYMs das versões publicadas e a configuração do SwiftPM (
~/Library/org.swift.swiftpm) eram apagados como se fossem cache. - Builds de Projetos só leva saída de build comprovada: qualquer
build/oudist/acima de 50 MB em~/Projectssaía de vez — inclusive recursos versionados do electron-builder. Agorabuild/só com Gradle ou Flutter ao lado,dist/só com pacote Python, e tudo vai para a Lixeira. - "Você está em dia" logo depois de uma release: a CDN do raw.githubusercontent (5 min) e do Pages (10 min) ainda entregava o manifesto anterior; o pedido agora fura o cache (parâmetro
t+Cache-Control: no-cache). - Aviso de atualização derrubava o app: a checagem de ferramentas de compilação esperava um processo na thread principal; o SwiftUI redesenhava a faixa no meio da inicialização e o app caía (
dispatch_oncerecursivo). Agora só olha arquivos. - Docs —
sudona instalação: a página de instalação e o README explicam que o comando roda semsudoe que o script pede a senha sozinho quando precisa substituir uma cópia do.pkg(sudo curl … | shnão adianta;| sudo shdeixaria o app do root de novo). - Instalador (
install.sh) sobre uma cópia do.pkg: o app instalado pelo.pkgpertence ao root, e o script tentava apagá-lo semsudo(só olhava se/Applicationsera gravável), parando emPermission denied. Agora confere o dono do bundle e pede a senha só nesse caso; o--uninstalltinha o mesmo defeito. - Disk X-Ray — caixas pretas no mapa: pastas com milhares de arquivos minúsculos (
node_modules, caches,.git/objects) deixavam a área deles vazia; agora ela é pintada com a cor do maior deles. - Disk X-Ray — caixa azul fora do lugar com zoom: com arquivos de tamanho idêntico, o layout ampliado podia diferir do calculado (até ~300 px num disco inteiro); empates no squarified agora são decididos sempre igual e a área ampliada tem exatamente a escala do mapa a 1×.
- iOS Simulators — runtimes órfãos: o comando para a Recuperação usa o nome real do volume de dados (
Macintosh HD - Datana instalação padrão, mas pode ser outro). - Disk X-Ray — rótulos embolados no mapa: pastas com um filho só ou dominante (≥ 90%) viram um cabeçalho com o caminho (
Users › alexkads), no máximo três níveis de título, tamanho alinhado à direita (sai antes de cortar o nome) e caminhos longos cortados no começo para manter a pasta final. - Disk X-Ray — contorno da seleção cortado: o contorno azul era desenhado para fora do bloco e sumia nos blocos colados na borda do mapa; agora fica inteiro por dentro do bloco e da área visível.
- Avisos no Xcode:
Invalid ExcludedeMAC-LIMPO.dmg/dmg_staging(o.dmg, sua montagem e o site do MkDocs agora são gerados embuild/, que existe em todo clone) e capturaweak/forte deselfno scan do Disk X-Ray. - Disk X-Ray — espaço vazio entre os blocos do mapa: o recuo das pastas se acumulava a cada nível e a folga/arredondamento valia até para blocos minúsculos, ilhando os arquivos pequenos. Agora o recuo é proporcional (só em pastas grandes e rasas) e folga e cantos só existem em blocos que os comportam.
- Disk X-Ray — navegação lenta: a árvore virou um
NSOutlineViewnativo (virtualizado, como o list control do WinDirStat), com ícones de pasta carregados em segundo plano; o destaque por extensão no mapa deixou de varrer milhões de itens a cada movimento do mouse. - Disk X-Ray — threads por máquina: a quantidade de threads e o buffer do scan são decididos pelo hardware e pelo volume (SSD: um por núcleo, 4–16; HD mecânico: 2; rede: 4 com buffer de 64 KiB), em vez de 8 fixo.
- Versão visível: o rodapé do popover mostra a versão e o build (
Version 1.3.10 (13)), lidos doInfo.plist. - Cards girando sem fim (era preciso reabrir o app): scans
asyncque mediam tamanho comdusíncrono (Logs, Project Builds, Rust Targets) prendiam as threads do pool cooperativo e travavam os demais. Agora medem fora do pool, atrás do limite global dedu. Cada categoria também tem prazo (420s): um scan preso libera o card e não bloqueia mais o refresh. Umduque estoura o timeout não cai mais numa varredura lenta e sem limite, e um processo que ignora SIGTERM recebe SIGKILL. - Rust Targets — "Cleaning Failed" com projeto em Docker: um
target/que é ponto de montagem de um volume (./backend:/app+ volume em/app/target) não pode ser removido enquanto o contêiner roda, e a limpeza saía como falha mesmo com o conteúdo apagado — que também ficava fora do total liberado. Agora otarget/é esvaziado (a pasta fica), os itens vão para a Lixeira, o espaço é medido antes/depois, e o scan indica quando o diretório está montado num contêiner. - iOS Simulators — card com GB que não limpava: o scan somava a pasta inteira de dispositivos, e a limpeza (
simctl erase all) falhava com qualquer simulador ligado (CoreSimulator 405), sem liberar nada. Agora cada dispositivo tem um destino: indisponível é apagado, desligado é zerado (erase <udid>), ligado fica de fora do total e aparece como "in use". O espaço liberado é medido pelo própriosimctlantes/depois. - Re-scan após limpeza: limpar uma categoria durante o scan completo reescaneia só aquela categoria, não todas.
- Docker — volumes de cache de build: desde a 1.3.5 todo volume nomeado não usado era preservado, inclusive caches reconstruíveis como
cargo-target,node-modulesenext-cachede projetos compose (um únicocargo-targetchegava a 53 GB, invisível ao Rust Targets por viver dentro doDocker.raw). Volumes não usados com esses nomes voltam a ser limpos; bancos, uploads e demais volumes de dados continuam preservados. - Pedidos de permissão em loop: sem Full Disk Access, os scans de System Data, Logs e dos apps em containers (WhatsApp, Teams, Podcasts, apps criativos) abriam um diálogo do macOS por container em
~/Library/Containerse~/Library/Group Containers— centenas deles — e os cards ficavam girando para sempre. Essas áreas agora são puladas sem a permissão, e o System Data informa quantas ficaram de fora. - Detecção de Full Disk Access: passa a sondar o
TCC.dbdo usuário; o probe antigo (Safari/History.db) não existe em quem nunca abriu o Safari, e o app se achava sem permissão para sempre.
🔄 Alterado¶
- 1.3.26 — versão de teste da atualização automática: nada muda no app.
- 1.3.27 — segundo teste da atualização automática, já com o pedido do manifesto furando o cache.
- Requisito baixou para macOS 26.6+ (Apple silicon), o mínimo do Xcode 27/Swift 6.4 — o app não usa nada exclusivo do macOS 27. O
install.shconfere versão principal e secundária, aponta a atualização gratuita para quem está no 26.0–26.5 e recusa Macs Intel com uma mensagem clara.
⚡️ Desempenho¶
- System Data mede os caminhos com
duem lotes, em vez de um processo por caminho (antes eram mais de mil só nos containers).
Planejado¶
- Agendamento automático de limpeza
- Notificações quando espaço está baixo
- Exportação de relatórios de limpeza
- Atalhos de teclado
- Preferências avançadas
[1.1.0] - 2026-07-04¶
✨ Adicionado¶
- Temas: seletor com Classic (visual original), Cyberpunk (neon ciano/magenta) e Matrix (verde), com glow, tipografia monoespaçada e persistência da escolha.
- Modo de limpeza agressiva (opt-in): remove caches grandes porém regeneráveis — modelos de IA on-device do Chrome (~4 GB) e
docker image prune -a. - Diálogo de confirmação antes de qualquer limpeza, mostrando o espaço estimado.
- Novas coberturas: Chrome/Chromium multi-profile (Chrome, Edge, Brave, Arc) incluindo
Service Worker; categoria TikTok LIVE Studio; cache do antigravity-updater; leftover do Wondershare Dr.Fone. - Rede de testes unitários (target
MACLIMPOTests).
🔒 Segurança¶
- Deleções vão para a Lixeira (reversível), com fallback para remoção definitiva só quando a Lixeira recusa o caminho.
du/rmpassam o caminho por argumento (sem interpolação em shell): paths com aspas/espaços deixam de quebrar.
⚡ Performance¶
- Scan paralelo das categorias usando os núcleos do Mac (medição de tamanho no pool do GCD, sem travar o pool cooperativo).
- Clean All paralelo (concorrência limitada), com progresso agregado e resultado somado.
- Correção da medição via
duque zerava pastas grandes (subcontagem silenciosa).
🧹 Refatoração¶
PathBasedCleaningService: base testada que unificou ~12 serviços baseados em path, com estratégias (item/conteúdo), filtro de idade e alvos "agressivos".- Remoção de código morto; falhas antes silenciosas passam a registrar log.
📦 Build¶
create_installer.shmais robusto (set -euo pipefail, verificação de codesign/DMG) e versionado a partir do arquivoVERSION.
[1.0.0] - 2025-12-17¶
✨ Adicionado¶
Interface Principal¶
- Interface moderna no menu bar com design vibrante
- Cards interativos com gradientes coloridos e hover effects
- Visualização de espaço em disco (usado/total)
- Tema adaptável (dark/light mode)
- Animações suaves e micro-interações
- Glassmorphism e efeitos modernos
Módulos de Limpeza (11 categorias)¶
- Docker: Limpeza de containers, imagens, volumes e build cache
- Xcode Cache: Remoção de DerivedData, Archives e DeviceSupport
- Node Modules: Limpeza de node_modules de projetos antigos
- Homebrew Cache: Remoção de cache do Homebrew
- IDE Cache: Limpeza de cache de IDEs JetBrains (Rider, IntelliJ, etc.)
- Temp Files: Remoção de arquivos temporários e cache de apps
- Terminal Logs: Limpeza de logs de terminal (zsh, bash)
- Messaging Apps: Remoção de cache de WhatsApp, Telegram, Slack
- Trash: Esvaziamento da lixeira
- Large Files: Identificação e remoção de arquivos grandes (>100MB)
- Duplicate Files: Detecção e remoção de arquivos duplicados
Disk Map - Visualização Treemap¶
- Treemap interativo estilo WinDirStat
- Cores por tipo de arquivo (código, documentos, vídeos, imagens, arquivos compactados)
- Navegação hierárquica (zoom in/out)
- Breadcrumb navigation
- Botão "Back" para voltar ao diretório pai
- Janela separada e independente (900x700, redimensionável)
- Scan paralelo com TaskGroup (3-5x mais rápido)
- Progresso em tempo real com contador de diretórios
- Info panel com detalhes ao passar o mouse
- Seleção de diretórios com cards bonitos e gradientes
- Algoritmo squarified para melhor visualização
Funcionalidades do Sistema¶
- Execução discreta no menu bar
- Scan de todas as categorias simultaneamente
- Resultados detalhados pós-limpeza
- Tempo de execução das operações
- Estimativa de espaço recuperável por categoria
- Logging estruturado com níveis (info, warning, error)
Documentação¶
- README.md completo com screenshots e roadmap
- CONTRIBUTING.md com guia detalhado para contribuidores
- CHANGELOG.md para rastreamento de versões
- Comentários em código para funções complexas
- Templates de issues para bugs e features
🔧 Técnico¶
Arquitetura¶
- Arquitetura MVVM (Model-View-ViewModel)
- Protocolo
CleaningServicepara extensibilidade - Componentes SwiftUI reutilizáveis
- Separação clara de responsabilidades
Performance¶
- Scan paralelo de diretórios usando Swift Concurrency (TaskGroup)
- Uso eficiente de
dupara cálculo de tamanho de diretórios - Renderização otimizada do treemap com Canvas
- Actor para gerenciamento thread-safe de progresso
Utilitários¶
FileSystemHelper: Operações de arquivo e sistemaShellExecutor: Execução segura de comandos shellTreemapLayout: Algoritmo squarified para layout do treemapLogger: Sistema de logging estruturado
🐛 Corrigido¶
- Tratamento de erros em operações de arquivo
- Validação de permissões antes de operações destrutivas
- Proteção contra remoção acidental de arquivos do sistema
- Handling de diretórios vazios no scan
🔒 Segurança¶
- Validação de caminhos antes de remoção
- Proteção contra path traversal
- Confirmação antes de operações destrutivas
- Logging de todas as operações de limpeza
[0.1.0] - 2025-12-01 (Versão Inicial)¶
Adicionado¶
- Estrutura básica do projeto
- Integração com menu bar
- Primeiros serviços de limpeza (Docker, Xcode)
- Interface básica com SwiftUI
Tipos de Mudanças¶
Adicionadopara novas funcionalidadesModificadopara mudanças em funcionalidades existentesDescontinuadopara funcionalidades que serão removidasRemovidopara funcionalidades removidasCorrigidopara correções de bugsSegurançapara vulnerabilidades corrigidas
Como Manter o Changelog¶
Para Contribuidores¶
Ao criar um Pull Request que adiciona novas funcionalidades ou corrige bugs:
- Adicione uma entrada na seção
[Unreleased] - Use o tipo de mudança apropriado
- Descreva a mudança de forma clara e concisa
- Referencie issues relacionadas quando aplicável
Exemplo:
## [Unreleased]
### Adicionado
- Nova categoria de limpeza para cache do VS Code (#123)
### Corrigido
- Crash ao escanear diretórios sem permissão (#124)
Para Mantenedores¶
Ao criar uma nova release:
- Mova as entradas de
[Unreleased]para uma nova seção de versão - Adicione a data da release
- Atualize o link de comparação no final do arquivo
- Crie uma tag Git com a versão
Exemplo:
# Atualizar CHANGELOG.md
# Commit das mudanças
git add CHANGELOG.md
git commit -m "chore: release v1.1.0"
# Criar tag
git tag -a v1.1.0 -m "Release v1.1.0"
git push origin v1.1.0
Formato baseado em Keep a Changelog