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: 2 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ Ferramenta em Go para preparar máquinas Windows, Linux e macOS com um comando (
- `docs/diagnostico.md`: `toolkit diagnostico` (só leitura; funciona sem admin e lê mais quando já roda como admin, sem nunca elevar sozinho: `Deps.Admin`, `Skipped.NeedsAdmin`): o que cada SO lê, regras e limiares do resumo "o que está ruim e o que fazer", série, UUID, MAC e hostname lidos, informações sem máscara (decisão do Paulo: é ferramenta de análise), `--completo`, `--json`, `--relatorio`. Código em `internal/diagnostico` (coleta_win/lin/mac, analise, relatorio) e `internal/cli/diagnostico.go`; coletores só pelo `exec.ReadOnlyRunner` e `Deps` injetáveis.
- `docs/rede.md`: `toolkit rede` (só leitura; sem Elevate, sem varredura, sem escrita, sem requisição externa): o que cada SO lê, achados e severidades (5 níveis, portas sensíveis em lista fechada), administrador, limites honestos, o que NUNCA faz. Aba da TUI em `docs/tui.md` (Rede › Análise). IP público e portal cativo SÓ sob pedido (`toolkit rede ip`/`portal`, tecla `o`/`w` na TUI; PR9, decisões 1 e 2 do plano): sem serviço padrão, só com URL informada, confirmação que nomeia o serviço, sem redirecionamento.
- `docs/otimizacao.md`: `toolkit otimizacao` (só Windows, SÓ LEITURA; parte A da função 3: gargalos de CPU, memória, disco do sistema, inicialização, serviços automáticos e boot (evento 100; sem evento = "sem dado", nunca "rápido")): o que lê (CIM `Win32_PerfFormattedData_*`, não `Get-Counter`, que é traduzido), limiares com fronteira testada, lista fixa do que NÃO faz (`NeverList`/`NeverRecommendTerms`), `--completo`, `--json`, `--relatorio`, seção Otimização da TUI. Código em `internal/otimizacao` e `internal/cli/otimizacao.go`. **Parte B (PR12, EXPERIMENTAL): `toolkit otimizacao animacoes [--dry-run] [--yes]` e `... desfazer`** (`internal/animacoes`, `internal/cli/otimizacao_animacoes.go`): catálogo FECHADO só HKCU com o único valor confirmado em fonte oficial (`MinAnimate` REG_SZ "0"; `TaskbarAnimations` e `VisualFXSetting` ficaram fora, A VERIFICAR), plano antes, backup por SID (0600, dono gravado) ANTES da 1ª escrita e validado contra o catálogo antes de qualquer leitura/escrita, reaplicar não sobrescreve o original, desfazer restaura tipo e conteúdo (apaga só o que não existia), System das animações recusa tudo fora de `HKCU\\` (`ErrSoHKCU`), nunca Elevate, reaproveita o `reg.exe` da privacidade (ausência provada). TUI: Máquina › Otimização, `m` alterna Gargalos/Animações (`internal/tui/otimizacao_anim.go`: p, a…, d…, c; confirmação única, plano por ID de uso único, faixa de resultado).
- `docs/usb.md`: `toolkit usb` (só Windows, **EXPERIMENTAL**, PR14 do plano: sem VM): modo empresa, só os USB conectados hoje; limite honesto (VID/PID clonado passa), a PROVA dos essenciais pela árvore PnP, ordem do aplicar, reversão automática, desfazer garantido, roteiro de recuperação e a lista A VERIFICAR em VM.
- `docs/privacidade.md`: `toolkit privacidade` (só Windows): perfis, plano antes, backup e `desfazer` (com zero pendências também pergunta e revalida antes de remover o backup; o mesmo nas animações), administrador explícito, `--dry-run`.
- `docs/apps-nativos.md`: `toolkit apps-nativos` (só Windows): catálogo fechado e lista de negação, perfis, escopo usuário x todos, administrador, backup, como reinstalar (sem desfazer automático), aba da TUI.
- `docs/receitas.md`: formato das receitas, ciclo de reboot e retomada, exemplos e a seção do `diag-rede` (Linux e macOS, só leitura, sem máscara, alvos por `TOOLKIT_DIAG_*` e idioma por `TOOLKIT_LANG`/`LANG`). Resumo legível dos diagnósticos: campo `render` (renderizadores em `internal/diagfmt`: windows/linux/macos memory e disks), tecla `d` na aba Diagnóstico e `recipe run --detalhes` mostram a saída original; Log da TUI com `✓ nome`.
Expand Down Expand Up @@ -82,6 +83,7 @@ Ferramenta em Go para preparar máquinas Windows, Linux e macOS com um comando (
- Gate: `scripts/ci.sh` (ou `make ci`; `~/.local/bin` entra no FIM do PATH; o gofmt vai por `scripts/check-gofmt.sh`, que reprova também sintaxe quebrada, com autoteste em `scripts/check-gofmt_test.sh`). Actions do workflow fixadas por SHA de commit (versão em comentário) e checkout com `persist-credentials: false`. Heavy pelo build-slot: `~/.maestri-local/build-slot.sh ./scripts/ci.sh`. `.github/workflows/ci.yml` só em `workflow_dispatch`.

- `toolkit privacidade` (`internal/cli/privacidade.go`, núcleo em `internal/privacidade`, texto em `docs/privacidade.md`): sem args só mostra estado e planos; `aplicar --perfil basico|recomendado [--dry-run] [--yes] [--somente-usuario]` imprime o plano, recusa sem administrador ANTES de mudar (nunca eleva sozinho), pede `[s/N]` (sem terminal exige `--yes`), grava backup e aplica; `desfazer` restaura do backup. Fora do Windows recusa sem tocar em nada. `Deps.Priv` (System/Store/Now) injetável; os testes usam um Windows em memória. Depois de confirmar (e com `--yes`) o CLI recalcula o plano (e o backup, no desfazer) e recusa sem mutação se mudou ("o estado mudou desde o plano mostrado"), como a TUI; o mesmo vale para `apps-nativos remover`.
- `toolkit usb` (`internal/cli/usb.go` e `tui_usb.go`, núcleo em `internal/usb`, texto em `docs/usb.md`; PR14 do plano, **EXPERIMENTAL**: nunca rodou numa máquina real, tudo que depende do Windows é A VERIFICAR em VM e NADA se aplica por padrão): modo empresa de USB permitidos, SÓ Windows. `usb` (estado, só leitura), `usb aplicar [--prazo N (padrão 10, mín 2, máx 60)] [--dry-run] [--yes]`, `usb confirmar`, `usb desfazer [--dry-run] [--yes]` e o subcomando OCULTO `usb reverter` (o que a tarefa de reversão executa: o mesmo `usb.Undo`, sem pergunta). Fora do Windows recusa sem tocar em nada (Linux/macOS são PR15/PR16). Núcleo: `System` (Edition/IsAdmin/Devices/ReadTree/RegWrite/RegDelete/KeyDelete/ExportReg/ProtectDir/StageBinary/ArmTask/ReadTask/DeleteTask; a implementação real usa `reg.exe` e `powershell.exe` por caminho absoluto, leituras pelo `exec.ReadOnlyRunner`, escritas pelo `MutatingRunner` e NUNCA `Elevate`: o administrador é conferido antes e o toolkit nunca eleva sozinho; scripts PowerShell constantes, ASCII, sem aspas duplas), `Analyze(devs, excluded)` (árvore de pais por `NewDeviceTree`, que recusa pai desconhecido, ciclo, instância repetida e raiz diferente de 1; barramento pelo prefixo da instância; política candidata = IDs de hardware com VID/PID dos USB marcados + 6 genéricos fechados, negação SÓ das 2 classes de USB, camada primeiro e negação por último; a PROVA avalia a política contra a árvore e exige todos os essenciais (Keyboard/Mouse/HIDClass de qualquer barramento, disco/controladores/hub raiz internos, todos os nós de um composto, os pais) permitidos), `BuildPlan` (só leitura; recusa Home/edição, política pré-existente em Restrictions e falta de prova), `Apply` (ordem: prazo, edição, admin, sem backup nem tarefa anteriores, prova, pasta protegida + backup SHA-256 relido, cópia do binário com hash, tarefa de reversão criada e CONFERIDA, só então as chaves; falha antes = zero alterações e a tarefa e o backup saem; falha no meio = restauração imediata e, se falhar, tarefa e backup ficam), `Undo` (restaura EXATAMENTE o snapshot; nunca apaga Restrictions às cegas; conflito com valor alterado por fora = para; snapshot ausente/corrompido depois de aplicar = `ESTADO ORIGINAL DESCONHECIDO`, sem escrever), `Confirm` (confere que a tarefa é a do toolkit e a remove), `ReadStatus`/`BuildUndo`. `checkRel`/`checkWrite` são a lista fechada de alvos (nada de DenyUnspecified, DenyDeviceIDs, retroativo). `FileStore` (`usb-backup.json` atômico com hash; o hash detecta corrupção, a ACL da pasta `C:\ProgramData\toolkit` impede adulteração). `internal/usb/usbtest` (Sys e MemStore em memória, dados sintéticos) serve CLI e TUI. `Deps.Usb` (System/Store/Now) injetável. Depois do `[s/N]` o CLI recalcula o plano (ou o desfazer e o snapshot) e recusa sem mutação se mudou. `ApplyOptions.ExpectedPlan`: o Apply recalcula o plano e recusa (`ErrPlanChanged`) antes do backup se ele diferir do mostrado. Teclado/mouse/HID desmarcado = recusa por regra (independe da classe do nó: um nó `HIDClass` simples NÃO é negado pela política, limite honesto a verificar em VM). TUI: seção **USB permitidos (experimental)** na área Segurança, que NÃO lê nada ao abrir (leitura do PnP é lenta: tecla `c`) (`internal/tui/usb_tab.go`; tecla nova `n` = manter…, com confirmação própria; plano de uso único por ID como a Privacidade; prazo estático "reverte às HH:MM"); Início ganhou o objetivo "Permitir só os USB conhecidos (modo empresa) — experimental" (`! só Windows` / `! experimental`).
- `toolkit rede` (`internal/cli/rede.go`, núcleo em `internal/rede`, texto em `docs/rede.md`; PR8 do plano de segurança e TUI): análise de rede SÓ LEITURA (IPs, perfil, tipo de segurança do Wi-Fi conectado, DNS, portas em escuta, firewall, IPv6 privacy). `rede.Collect(ctx, goos, Deps{Runner, ReadFile, Glob, Now, Lang, Admin})` roda só pelo `exec.ReadOnlyRunner` (nenhum `Elevate`; o que pede root vira `Skipped.NeedsAdmin`), com caminho absoluto no Windows/macOS, `LookPath` + `LC_ALL=C` no Linux; o nmcli leva SEMPRE `--rescan no` e o macOS lê o Wi-Fi por `ipconfig getsummary <if>` (passivo), nunca varre nem lê senha; `contrato_test.go` fixa a lista fechada de comandos, os termos proibidos e que o pacote não tem `net/http`/`net.Dial`/`os/exec`. `rede.Analyze` dá achados de 5 níveis (alta/média/baixa/info/ok; `Finding.ID` estável; textos pt/en/es via `diagfmt.T`; "sem dado" nunca vira ok; portas sensíveis em tabela fechada, só em endereço não local, severidade pelo firewall); `Summary`/`Full` montam o texto. Flags `--completo`, `--json`, `--relatorio` (0600, nunca sobrescreve; aviso de dados da rede local no stderr antes de gravar). `Deps.Rede` (`RedeDeps{Collect, Now, IsAdmin}`; sem IsAdmin usa o do diagnóstico). IP público e portal cativo (PR9, `internal/rede/publico.go`; `Collect` NUNCA os chama): SÓ SOB PEDIDO e SÓ com a URL que a pessoa informa (`TOOLKIT_IP_URL`/`--servico-ip`, `TOOLKIT_PORTAL_URL`/`--servico-portal`; `rede.NewPlan` valida com `catalog.CheckURL`: https, host público, 443, sem userinfo/fragmento/IP literal/localhost; sem URL = "nenhum serviço configurado", nada enviado; NUNCA embutir serviço padrão). `rede.Fetcher` (interface) mantém `internal/rede` sem `net/http`; o cliente real é `internal/rede/httpclient` (TLS 1.2+, sem proxy, sem cookies, SEM seguir redirecionamento, 5 s, corpo 1 KiB, recusa endereço não público, User-Agent `toolkit`). `QueryPublicIP` valida a resposta como IP público por `netip` (corpo nunca é mostrado); `ProbePortal`: 204 livre, 3xx/200/511 "possível portal cativo" (nada aberto). Antes de enviar: `Plan.Describe` (host, o que é enviado, o que se revela), `[s/N]`/`--yes` (sem terminal exige `--yes`), `--dry-run` não envia; na TUI o plano exibido é de uso único. `Report.PublicIP`/`Portal` só são preenchidos depois da confirmação; achado `maquina-exposta` cruza portas e firewall já lidos ("o toolkit não testa de fora"; CGNAT = provavelmente não alcançável por IPv4). `RedeDeps.Fetcher` injetável (testes: cliente falso que conta chamadas; nunca a internet). TUI: `internal/tui/rede_tab.go` (`RedeTab` sobre `NetBackend` + `NetQueryBackend` opcional (teclas `o` IP público… e `w` portal cativo…, confirmação única, uso único do plano); leitura só quando a pessoa pede, `c`, Esc cancela; estados do `stateview.go`; resumo+achados no topo e dados rolando; sem `d` nem `Detailer`), backend real em `internal/cli/tui_rede.go`; o Início deixou de marcar "Analisar a rede" como em breve (`Unavailable` segue existindo como mecanismo).
- `toolkit otimizacao` (`internal/cli/otimizacao.go`, núcleo em `internal/otimizacao`, texto em `docs/otimizacao.md`): só Windows, só leitura, sem administrador (o log de boot pode negar: `Skipped.NeedsAdmin`, o toolkit nunca eleva). `Collect(ctx, goos, Deps) *Report` (fora do Windows não chama o Runner: `Supported=false`), `Analyze(r, lang) []Finding`, `Summary`, `Full`, `Legend`, `NeverList`. Scripts PowerShell constantes, ASCII, via `exec.ReadOnlyRunner` (teste de contrato percorre todos). `Deps.Otim` (`Collect`/`Now`/`IsAdmin`) injetável. Fora do Windows o comando recusa sem ler nem gravar (como a privacidade). Seção "Otimização" da TUI (3ª da área Máquina, `internal/tui/otimizacao_tab.go`, backend em `internal/cli/tui_otimizacao.go`): NÃO lê ao abrir, `c`/Enter lê, `Esc` cancela, painel de detalhe com os limiares; objetivo "Deixar o Windows mais leve" no Início (só promete a leitura).
- `toolkit apps-nativos` (`internal/cli/apps_nativos.go`, núcleo em `internal/appsnativos`, texto em `docs/apps-nativos.md`): sem args lista o catálogo fechado com instalado/ausente; `remover (--perfil basico|completo | --app id...) [--todos-usuarios] [--dry-run] [--yes]` imprime SEMPRE o plano, recusa `--todos-usuarios` sem administrador ANTES de mudar (nunca eleva sozinho), pede `[s/N]` (sem terminal exige `--yes`), grava backup por SID e remove; `reinstalar` só IMPRIME como reinstalar do backup (sem desfazer automático). Fora do Windows recusa sem tocar em nada. `Deps.AppsNat` (System/Store/Now) injetável; os testes usam um Windows em memória. Aba da TUI "Apps nativos" (6ª, `internal/tui/apps_nativos_tab.go`, backend em `internal/cli/tui_apps_nativos.go`, mesmo molde da Privacidade): espaço marca, `b` marca o perfil básico, `t` todo o catálogo, `m` todos os usuários (exige administrador), `p` plano, `r` plano + `[s/N]` dentro da TUI, `i` como reinstalar (só texto); plano de USO ÚNICO com ID opaco (`Apply(sel, ID)`, recálculo idêntico ou `ErrNatStalePlan`), Esc cancela a preparação, fora do Windows só avisa.
Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,7 @@ toolkit recipe list
toolkit recipe run wsl-dev
toolkit recipe status
toolkit diagnostico # saúde da máquina, só leitura: o que está ruim e o que fazer (docs/diagnostico.md)
toolkit usb # modo empresa: USB permitidos (Windows, EXPERIMENTAL; veja docs/usb.md): só lê o estado; aplicar/confirmar/desfazer
toolkit rede # análise da rede, só leitura: IPs, Wi-Fi, DNS, portas em escuta, firewall (docs/rede.md)
toolkit otimizacao # Windows: o que pesa na máquina (CPU, memória, disco, inicialização), só leitura (docs/otimizacao.md)
toolkit rede ip --servico-ip URL # IP público, SÓ sob pedido, com serviço que você informa e confirmação (sem serviço padrão)
Expand Down
10 changes: 5 additions & 5 deletions docs/plano-seguranca-e-tui.md
Original file line number Diff line number Diff line change
Expand Up @@ -487,7 +487,7 @@ Continuação da numeração dos PRs de produto (o último documentado é o PR8
| **PR11** Otimização: leitura de gargalos | `internal/otimizacao` (leitura), `toolkit otimizacao`, TUI área 2 > Otimização (parte Gargalos) | nada | baixo | fixtures; limiares com fronteira; "sem evento" não vira "rápido" |
| **PR12** Otimização: animações (muda `HKCU`) | plano, backup, desfazer, API `SystemParametersInfo`, TUI parte Animações | PR11, valores confirmados em VM | médio | ida e volta; nenhuma escrita em `HKLM`; nenhum serviço |
| **PR13** Apps: acesso remoto (RustDesk, se aprovado) | entrada com aviso de segurança | decisão do Paulo e id confirmado | médio | aviso na tela; hash fixado; sem configuração do app |
| **PR14** USB: Windows | `internal/usb`, leitura PnP, plano, política em camadas, timer de reversão, backup/desfazer, TUI área 3 > USB permitidos, `docs/usb.md` com roteiro de recuperação | tudo acima, VM de laboratório | **alto** | todos os testes da função 1; roteiro de recuperação **testado em VM**; revisão reforçada; só depois do smoke do Paulo |
| **PR14** USB: Windows (feito como EXPERIMENTAL, sem VM: `docs/usb.md`) | `internal/usb`, leitura PnP, plano, política em camadas, timer de reversão, backup/desfazer, TUI área 3 > USB permitidos, `docs/usb.md` com roteiro de recuperação | tudo acima, VM de laboratório | **alto** | todos os testes da função 1; roteiro de recuperação **testado em VM**; revisão reforçada; só depois do smoke do Paulo |
| **PR15** USB: Linux (USBGuard) | `usbguard` via apt/dnf, `rules.conf`, serviço com confirmação | PR14 (reuso do desenho) | alto | idem; sem pacote no gerenciador = "indisponível" |
| **PR16** USB: macOS (orientação) | texto e, se existir forma suportada, leitura; sem mudança | PR14 | baixo | texto honesto; nada executa |

Expand All @@ -501,14 +501,14 @@ Sugestão de **ordem**: PR8, PR10, PR11 podem andar em paralelo (independentes);
| 2 | O portal cativo entra na primeira versão da análise de rede? (PR8: aplicada a recomendação, fora da fase; PR9: entra junto do IP público, só sob pedido e com URL informada) | **Não**: junto do IP público, no PR9 |
| 3 | RustDesk entra no catálogo, dadas as CVEs de 2026 e o uso em golpes? | **Resolvida no PR13 (2026-11-14): entra**, no macOS (cask) e no Linux (flatpak), com o aviso na tela e a versão mínima **1.5.0** verificada no NVD; **sem instalador no Windows** (id do winget inexistente). O toolkit NÃO enforça a versão mínima (ver [Verificação do PR13](#verificação-do-pr13-rustdesk-e-versão-mínima)) |
| 4 | Chrome entra apesar da possibilidade de falha de hash por URL do fabricante mutável? | **Entra**, com a mensagem explicativa; hash divergente nunca é contornado |
| 5 | USB no Windows Home: recusar ou tentar? | **Recusar** (a Microsoft não lista a edição); revalidar na VM |
| 6 | USB: identificar por ID de hardware (modelo) ou por ID de instância (unidade)? | **ID de hardware** com todos os nós do dispositivo; instância só se a VM mostrar que é estável |
| 7 | Prazo do timer de reversão | **10 minutos**, configurável por flag, mínimo 2 |
| 5 | USB no Windows Home: recusar ou tentar? (PR14: aplicada a recomendação) | **Recusar** (a Microsoft não lista a edição); revalidar na VM |
| 6 | USB: identificar por ID de hardware (modelo) ou por ID de instância (unidade)? | **ID de hardware** com todos os nós do dispositivo; instância só se a VM mostrar que é estável (PR14: aplicada a recomendação) |
| 7 | Prazo do timer de reversão | **10 minutos**, configurável por flag, mínimo 2 (PR14: aplicada, `--prazo`, máximo 60) |
| 8 | Linux: aceitar USBGuard só onde há pacote no gerenciador? | **Sim**; Arch fica de fora até confirmar pacote oficial |
| 9 | macOS: só orientação? | **Sim** |
| 10 | Otimização: incluir mais que animações (ex.: efeitos de transparência, modo de energia)? | **Não** nesta rodada; só animações (reversíveis por usuário) |
| 11 | Categoria nova `remoto` para acesso remoto, ou `utilitarios`? | **`utilitarios`** (não criar categoria por um app) |
| 12 | Quem tem a VM de laboratório e quando roda o smoke de USB (Windows e Linux)? | Antes de iniciar o PR14; sem VM, o PR14 não começa |
| 12 | Quem tem a VM de laboratório e quando roda o smoke de USB (Windows e Linux)? | Antes de iniciar o PR14; sem VM, o PR14 não começa. **PR14: sem VM; o Paulo e o Maestro mandaram implementar mesmo assim, COMO EXPERIMENTAL** (rótulo no título da seção, no CLI, nas docs e na ajuda; nada se aplica por padrão; lista A VERIFICAR em `docs/usb.md`). O smoke em VM continua sendo a condição para tirar o rótulo |

## Pendências A VERIFICAR

Expand Down
Loading
Loading