Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
58 changes: 58 additions & 0 deletions docs/notas-de-versao/v0.4.0.md
Original file line number Diff line number Diff line change
@@ -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_<so>_<arch>` (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).
Loading