diff --git a/CLAUDE.md b/CLAUDE.md index 6c6de12..f026792 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -21,7 +21,7 @@ Ferramenta em Go para preparar máquinas Windows, Linux e macOS com um comando ( - `docs/plano-seguranca-e-tui.md`: PROPOSTA (sem código) de quatro funções, todas também na TUI: USB permitidos (Windows, USBGuard, macOS só orientação; limite honesto de clonagem de VID/PID), análise de rede só leitura, otimização do Windows (gargalos + animações com desfazer) e mais apps no catálogo (navegadores, LibreOffice, compactadores, acesso remoto). Riscos, `security-audit` por PR, ordem de PRs, decisões abertas e lista de A VERIFICAR. - `docs/roadmap.md`: o que vem depois da v0.1.0 (update, aviso de versão, ícone, localização pt-BR/en/es, acessibilidade da TUI, smoke) e os padrões de produto da PiluTech (skill `padroes-produto-pilutech`). - `docs/auditoria-a11y-l10n.md`: auditoria de acessibilidade e localização (2026-11-13) contra a skill `padroes-produto-pilutech`: achados A1–A8 e L1–L10, o que já cumpre, medição de contraste e ordem sugerida das correções. -- `docs/notas-de-versao/vX.Y.Z.md`: texto pronto das notas de cada release (o Paulo cola no rascunho que a pipeline cria, no lugar dos `(preencher)`). Hoje: v0.2.2 e v0.3.0. +- `docs/notas-de-versao/vX.Y.Z.md`: texto pronto das notas de cada release (o Paulo cola no rascunho que a pipeline cria, no lugar dos `(preencher)`). Hoje: v0.2.2, v0.3.0 e v0.4.0. - `docs/release.md`: pipeline de release no GitHub Actions (tag `v*.*.*` → build ubuntu → codesign/notarização macOS no environment `release` → rascunho), cadastro dos segredos, custo e plano B manual. - `docs/smoke.md`: roteiro de smoke manual da fase 2 (saídas reais a capturar, Windows 11, Mac, Linux), sempre `--dry-run` primeiro. - `docs/briefing.md`: pedido original do Paulo (fases 1–6, requisitos). Não editar. diff --git a/docs/notas-de-versao/v0.4.0.md b/docs/notas-de-versao/v0.4.0.md new file mode 100644 index 0000000..2a01397 --- /dev/null +++ b/docs/notas-de-versao/v0.4.0.md @@ -0,0 +1,58 @@ +toolkit v0.4.0 + +Interface nova, comandos de privacidade, apps nativos, rede e otimização do Windows, diagnóstico mais completo e mais apps no catálogo. + +## O que mudou desde a v0.3.0 +- **Interface (TUI) reorganizada em áreas:** `0 Início`, `1 Instalar`, `2 Máquina`, `3 Segurança`, `4 Rede` e `5 Histórico`, cada uma com suas seções. O Início pergunta "O que você quer fazer?" e leva à seção certa. Em Privacidade, Apps nativos e Animações, a ação passa por uma **confirmação única** que mostra o plano inteiro, onde fica o backup e como desfazer, com o foco inicial em **Cancelar** (só `s`/`y` ou o botão confirmam). Instalar apps e rodar receitas seguem com a **Revisão do plano** (foco em Voltar/Executar); instalação e receita não têm backup nem desfazer geral. O resultado aparece numa faixa na própria seção, até você fechar com `x`. Os estados (carregando, erro, ainda não lido, cancelado) seguem o mesmo padrão, a ajuda é uma só (`?`) e a mesma tecla tem o mesmo sentido em todas as seções. Em janelas de 110 colunas ou mais há um painel de detalhe do item sob o cursor. Continua valendo `--no-motion` (ou `TOOLKIT_REDUCE_MOTION=1`), `NO_COLOR` (nada depende de cor: símbolo e palavra sempre juntos), tema claro ou escuro conforme o terminal e a explicação para janela menor que 60×16. +- **`toolkit privacidade`** (novo, só Windows): reduz a coleta de dados do Windows em dois perfis (`basico`, só do usuário e sem administrador; `recomendado`, que também mexe em política, serviço de telemetria e tarefas agendadas e exige administrador). Mostra o plano antes (valor atual e novo), guarda o valor original de cada item em backup e `toolkit privacidade desfazer` restaura. Nunca edita o arquivo `hosts` nem remove componente do sistema. No Windows Home e Pro o mínimo de diagnóstico continua sendo "obrigatório" (o Windows ignora 0 nessas edições) e o plano avisa. Também na TUI (Segurança › Privacidade). Fora do Windows termina com a mensagem de que só existe no Windows, sem tocar em nada. +- **`toolkit apps-nativos`** (novo, só Windows): remove apps nativos opcionais (como Clima, Notícias e Paciência) de uma **lista fechada** que não inclui a Microsoft Store, o winget, o Edge, a Segurança do Windows nem os componentes do sistema. Perfis `basico` e `completo` ou `--app` avulso; plano antes, confirmação, backup da lista removida, e `toolkit apps-nativos reinstalar` só IMPRIME como reinstalar cada app (a reinstalação pode exigir a Microsoft Store e uma conta). Não há desfazer automático. Por padrão só o usuário atual; `--todos-usuarios` exige administrador. Também na TUI (Máquina › Apps nativos). +- **`toolkit diagnostico` mais completo:** o relatório (`--completo`, `--json`, `--relatorio`) agora traz número de série, UUID, nome da máquina e MAC das placas físicas, como o sistema informa. Só leitura. O que exige administrador aparece como "não lido", com a instrução: SMART no Linux (`smartctl`), temperatura no macOS e contadores de confiabilidade do disco no Windows. O toolkit **não eleva sozinho**: abra o terminal como administrador (ou `sudo`) se quiser essa leitura. Trate o arquivo do relatório como dado pessoal antes de compartilhar. Na TUI, o Diagnóstico ganhou a visão Máquina. +- **`toolkit rede`** (novo, só leitura): resumo do que está exposto e o que fazer: Wi-Fi (só a conexão atual, só o tipo de segurança, nunca a senha), firewall, portas em escuta, DNS, IPv6 e rota padrão. `--completo`, `--json` e `--relatorio` como no diagnóstico. Não varre a rede, não altera nada e não acessa a internet. Na TUI: Rede › Análise. +- **IP público e portal cativo, só sob pedido** (`toolkit rede ip` e `toolkit rede portal`, e na TUI): não existe serviço padrão. Você informa a URL (`https`, `--servico-ip`/`--servico-portal` ou `TOOLKIT_IP_URL`/`TOOLKIT_PORTAL_URL`) e o toolkit mostra, antes de enviar, qual serviço será consultado, o que vai na requisição e o que você revela a ele; só envia depois da sua confirmação (`--dry-run` mostra e para). Sem URL, não envia nada. +- **`toolkit otimizacao`** (novo, só Windows, só leitura): mostra o que pesa na máquina (CPU, memória, disco do sistema, programas de inicialização, serviços e tempo de boot) e o que fazer, em texto. Não muda nenhuma configuração e não exige administrador. Na TUI: Máquina › Otimização. +- **Animações do Windows (EXPERIMENTAL):** `toolkit otimizacao animacoes` reduz a animação de minimizar e maximizar janelas, só na parte do usuário (`HKCU`), com plano, backup e `toolkit otimizacao animacoes desfazer`. É experimental porque os valores ainda não foram confirmados numa máquina virtual, e reduzir animação melhora a sensação de resposta, não prova ganho de desempenho. O toolkit não reinicia o Explorer: algumas mudanças só valem depois de reabrir a sessão. +- **Novos apps no catálogo:** Brave (Windows, macOS e Linux), Google Chrome (**só Windows**: no macOS e no Linux o toolkit não tem como conferir o hash nem a origem oficial), LibreOffice (Windows, macOS e Linux), PeaZip (Windows e Linux) e RustDesk (macOS e Linux). O RustDesk dá controle remoto da máquina e mostra um aviso de segurança na instalação, com a versão mínima conhecida sem falha grave aberta (1.5.0, conforme o NVD em 2026-11-14); o toolkit instala a versão atual do gerenciador e não confere a versão instalada. No Linux estes apps usam Flatpak. Veja `toolkit list`. +- **Instalador aceita versão e pré-release:** `win.ps1` com `-Versao vX.Y.Z` (ou `TOOLKIT_VERSION`) e `unix.sh` com `--versao vX.Y.Z` (ou `TOOLKIT_VERSION`) instalam essa versão, conferindo o SHA-256 do `checksums.txt` da própria release. Pré-releases não viram a "última versão": o comando de uma linha continua entregando a estável. +- **Correções:** depois da confirmação, `privacidade aplicar`/`desfazer`, `apps-nativos remover` e `otimizacao animacoes` recalculam o plano e só seguem se for idêntico ao que você viu (senão recusam, sem mudar nada); a TUI não corta mais com reticências as listas entre 110 e 130 colunas; a medição de latência do disco na otimização valida cada intervalo. +- **Windows: detecção de apps instalados fora do winget (correção):** reconhecer apps instalados por outros meios (instalador do site, por exemplo) já existia antes da v0.3.0; o que é novo é que no Windows a detecção agora lê as chaves de desinstalação do registro (`HKLM`, `HKLM\WOW6432Node` e `HKCU`) e, quando o app declara, o `App Paths` (só se apontar para um `.exe` que existe, em unidade local). Só leitura, sem administrador, e o estado mostra de onde veio a detecção. Se alguma dessas leituras falhar e o app não aparecer, o resultado é "não detectado (leitura incompleta)", nunca "não instalado". Programas com publisher exigido pelo catálogo só são reconhecidos pelo registro de desinstalação. + +## Segurança e privacidade +As análises novas (diagnóstico, rede, otimização) não elevam e não pedem senha. Instalações no Linux e no macOS podem usar `sudo -n`, que nunca pede senha: sem credencial já ativa, o toolkit para e orienta (`sudo -v`). O toolkit não envia seus relatórios a ninguém e só acessa a rede quando você pede: instalar e atualizar; o IP público e o portal cativo, só com a URL que você informar e depois de confirmar; e as receitas de alcance de rede (`diag-rede` no Linux e no macOS: DNS, ping e HTTPS para os alvos configurados), quando você as roda. Todo comando que muda a máquina mostra o plano antes e tem `--dry-run`. Informações de diagnóstico e rede aparecem sem máscara, como o sistema as informa. + +## Atualizar +`toolkit update`. Ou rode o instalador de novo: + +Windows (PowerShell): +``` +irm https://pilutech.com.br/win | iex +``` +Linux e macOS: +``` +curl -fsSL https://pilutech.com.br/sh | sh +``` + +Para instalar uma versão específica (por exemplo uma pré-release), use `-Versao` (Windows) ou `--versao` (Linux e macOS); veja `docs/release.md`. + +## Arquivos +`toolkit__` (binário cru; `.exe` no Windows), `checksums.txt`, `unix.sh` e `win.ps1`. Os binários de macOS são assinados (Developer ID) e notarizados pela Apple. + +## Verificar os arquivos +Baixe o binário e o `checksums.txt` da mesma release e confira o SHA-256 antes de executar. O instalador e o `toolkit update` já fazem essa conferência sozinhos. + +Linux e macOS (na pasta dos arquivos): +``` +sha256sum --ignore-missing -c checksums.txt # no macOS: shasum -a 256 -c, ou compare o hash à mão +``` +Windows (PowerShell): compare `(Get-FileHash .\toolkit_windows_amd64.exe -Algorithm SHA256).Hash` com a linha do mesmo arquivo no `checksums.txt`. + +macOS, assinatura e notarização: +``` +codesign --verify --strict toolkit_darwin_arm64 +spctl -a -vv -t exec toolkit_darwin_arm64 +``` + +## Limites conhecidos +- `toolkit --version` ainda não existe; use `toolkit version`. +- Testado no Windows na pré-release v0.4.0-rc.4; o Linux real ainda não teve teste manual. Os comandos de Windows (`privacidade`, `apps-nativos`, `otimizacao`) e os coletores de Windows e Linux do diagnóstico e da rede também têm testes automáticos com saídas simuladas; a interface foi usada num Mac e o coletor do macOS também numa máquina real. Relate o que encontrar. +- `toolkit privacidade`, `apps-nativos` e `otimizacao` só existem no Windows; fora dele terminam com a mensagem e não tocam em nada. +- As animações do Windows são experimentais (veja acima).