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 @@ -12,7 +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/privacidade.md`: `toolkit privacidade` (só Windows): perfis, plano antes, backup e `desfazer`, administrador explícito, `--dry-run`.
- `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`.
- `SECURITY.md`: como reportar e as regras garantidas (hash obrigatório etc.).
Expand Down
6 changes: 5 additions & 1 deletion docs/otimizacao.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ backup; se algo falha no meio, o que não foi restaurado fica no backup.

**Revalidação depois da confirmação (CLI).** Depois do `[s/N]` (e também com `--yes`, logo antes de aplicar) e ANTES de qualquer
backup ou escrita, o comando recalcula o plano e exige o MESMO texto e as mesmas pendências do que foi mostrado; no desfazer
reconfere também o backup (mesmo conteúdo). Divergência (outro processo mexeu no valor durante a pergunta) =
reconfere também o backup (mesmo conteúdo). Isso vale também para o desfazer com ZERO pendências: pergunta "Tudo já está como antes. Remover o backup? [s/N]" (sem terminal exige `--yes`), revalida e só então remove o backup; `--dry-run` nunca remove. Divergência (outro processo mexeu no valor durante a pergunta) =
`o estado mudou desde o plano mostrado; nada foi alterado; veja o plano de novo`, zero mutações e backup intacto.

**Leitura do registro.** Pelo mesmo `reg.exe` da privacidade (caminho absoluto, `ReadOnlyRunner` para ler e `MutatingRunner` para
Expand Down Expand Up @@ -172,3 +172,7 @@ confirmação são recusadas: nunca há plano armado fora da tela (só `c` e `m`
ou o Explorer? A reversão devolve o mesmo estado visual?
- A pasta do backup quando o usuário que eleva é outro (SID e `%LOCALAPPDATA%` diferentes): coberto pelo dono gravado no arquivo,
mas não testado numa máquina real.

## Acompanhamento: janela entre a revalidação e a remoção do backup

No desfazer com zero pendências o CLI pergunta "Tudo já está como antes. Remover o backup? [s/N]", relê o backup e o estado depois da confirmação e só então remove; a frase "O backup foi removido." só sai DEPOIS de `Remove()` retornar sem erro (cancelar, sem terminal, estado ou backup alterado e erro de `Remove()` deixam o backup e não anunciam remoção). Resta uma janela mínima entre a revalidação e o `Remove()`: o `Store` não tem remoção condicional nem trava compartilhada com `Save`, então o arquivo removido pode não ser exatamente a versão revalidada se outro processo gravar nesse intervalo. Acompanhamento: uma trava compartilhada Save/Remove (ou remoção condicional por conteúdo/versão) no `Store`.
6 changes: 5 additions & 1 deletion docs/privacidade.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Limite real: no Windows Home e Pro o mínimo de dados de diagnóstico é "obriga
## Backup e desfazer

- Arquivos na pasta de estado do toolkit (`C:\ProgramData\toolkit` como administrador, `%LOCALAPPDATA%\toolkit` como usuário), permissão 0600, escrita atômica, e SEPARADOS por escopo: `privacidade-backup-<SID>.json` (só os valores `HKCU`, de cada usuário; o SID vem de `whoami /user`) e `privacidade-backup-maquina.json` (`HKLM`, serviços e tarefas, compartilhados). Cada arquivo grava o dono; um arquivo de outro dono (copiado ou renomeado) é recusado e fica intacto. Dois administradores não compartilham nem desfazem o `HKCU` um do outro.
- O backup é tratado como dado não confiável: ANTES de ler ou mudar qualquer coisa, o `desfazer` confere CADA entrada contra o catálogo (ID, chave e nome, serviço ou caminho da tarefa idênticos aos do catálogo; tipo de valor e de início conhecidos). Entrada fora do catálogo ou de tipo desconhecido recusa o desfazer inteiro, sem mutação, e o arquivo é preservado. O `desfazer --dry-run` nunca remove nem escreve nada, nem com zero pendências.
- O backup é tratado como dado não confiável: ANTES de ler ou mudar qualquer coisa, o `desfazer` confere CADA entrada contra o catálogo (ID, chave e nome, serviço ou caminho da tarefa idênticos aos do catálogo; tipo de valor e de início conhecidos). Entrada fora do catálogo ou de tipo desconhecido recusa o desfazer inteiro, sem mutação, e o arquivo é preservado. O `desfazer --dry-run` nunca remove nem escreve nada, nem com zero pendências. Com zero pendências ("tudo já está como antes") o `desfazer` NÃO remove o backup direto: pergunta "Tudo já está como antes. Remover o backup? [s/N]" (sem terminal exige `--yes`), relê o backup e o estado e só remove se forem idênticos aos mostrados; senão recusa com "o estado mudou desde o plano mostrado; nada foi alterado" e o backup fica intacto (mesmo critério com e sem `--yes`; na TUI o botão `Remover backup` já usa o plano por ID revalidado).
- Guarda o estado ORIGINAL de cada item (valor do registro ou "não existia", tipo de início e se rodava o serviço, se a tarefa estava habilitada). Aplicar duas vezes nunca sobrescreve o original.
- `desfazer` restaura o valor (ou apaga o que não existia), reconfigura serviços e tarefas e, no fim, apaga o backup. Falha no meio deixa no backup só o que sobrou.
- Como o backup fica na pasta de estado de quem aplicou, rode o `desfazer` no mesmo nível (administrador ou usuário) em que rodou o `aplicar`.
Expand All @@ -60,3 +60,7 @@ O formato do backup nasce na v0.4.0-rc.1 (nunca houve outro publicado): não há
Os botões são `Aplicar` (perfil) e `Restaurar` (desfazer; `Remover backup` quando já está tudo como antes). O plano exibido é o mesmo que o backend devolveu (uso único, por ID); a confirmação só aplica esse plano.

**Faixa de resultado** (`internal/tui/result.go`, PR2 do redesign): depois de aplicar ou restaurar, o resultado aparece NA PRÓPRIA aba, logo abaixo do cabeçalho, e fica até a pessoa teclar `x` (não some por tempo nem ao trocar de aba). Traz símbolo e palavra (`✓ feito`, `! parcial`, `✗ falhou`, `i info`), o que foi feito, quantas mudanças, onde está o backup e COMO DESFAZER (`Para desfazer: tecle d nesta aba`). Falha no meio vira `! parcial` (quantas mudanças ficaram, o erro, o backup e o `d`); recusa (precisa de administrador, plano mudou) diz que NADA foi alterado. A linha de estado fica só com um resumo curto. A aba implementa `Resulter` (`Result()`/`Dismiss()`).

## Acompanhamento: janela entre a revalidação e a remoção do backup

No desfazer com zero pendências o CLI pergunta "Tudo já está como antes. Remover o backup? [s/N]", relê o backup e o estado depois da confirmação e só então remove; a frase "O backup foi removido." só sai DEPOIS de `Remove()` retornar sem erro (cancelar, sem terminal, estado ou backup alterado e erro de `Remove()` deixam o backup e não anunciam remoção). Resta uma janela mínima entre a revalidação e o `Remove()`: o `Store` não tem remoção condicional nem trava compartilhada com `Save`, então o arquivo removido pode não ser exatamente a versão revalidada se outro processo gravar nesse intervalo. Acompanhamento: uma trava compartilhada Save/Remove (ou remoção condicional por conteúdo/versão) no `Store`.
7 changes: 7 additions & 0 deletions internal/cli/apps_nativos_fake_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ type natSys struct {
others []appsnativos.Package
provisioned []appsnativos.Provisioned
removes []string
// onList (opcional) roda no início de cada ListInstalled, com o número da chamada: simula outro processo.
lists int
onList func(call int)
}

func newNatSys(admin bool, names ...string) *natSys {
Expand All @@ -36,6 +39,10 @@ func natPkg(name string) appsnativos.Package {
func (s *natSys) IsAdmin(context.Context) bool { return s.admin }
func (s *natSys) UserSID(context.Context) (string, error) { return "S-1-5-21-1-2-3-1001", nil }
func (s *natSys) ListInstalled(_ context.Context, all bool) ([]appsnativos.Package, error) {
s.lists++
if s.onList != nil {
s.onList(s.lists)
}
if all && !s.admin {
return nil, exec.ErrNotElevated
}
Expand Down
15 changes: 12 additions & 3 deletions internal/cli/otimizacao_animacoes.go
Original file line number Diff line number Diff line change
Expand Up @@ -150,11 +150,13 @@ func runAnimUndo(ctx context.Context, out io.Writer, deps Deps, f animFlags) err
_, _ = fmt.Fprintln(out, msg.PrivDryRunDone)
return nil
}
if plan.Pending() == 0 {
zero := plan.Pending() == 0 // tudo já está como antes: só o backup seria removido, mas com a MESMA cautela do restaurar
question := msg.AnimConfirmUndo
if zero {
_, _ = fmt.Fprintln(out, msg.AnimUndoNothing)
return cleanErr(e.store.Remove())
question = msg.AnimConfirmUndoNothing
}
if ok, err := privConfirm(ctx, out, deps, f.yes, msg.AnimConfirmUndo); !ok || err != nil {
if ok, err := privConfirm(ctx, out, deps, f.yes, question); !ok || err != nil {
return err
}
// Reconfere backup (mesmo conteúdo) e estado atual (mesmo plano) antes de restaurar qualquer coisa.
Expand All @@ -168,6 +170,13 @@ func runAnimUndo(ctx context.Context, out io.Writer, deps Deps, f animFlags) err
if formatAnimUndo(fresh) != formatAnimUndo(plan) || fresh.Pending() != plan.Pending() || !reflect.DeepEqual(freshBk, bk) {
return errors.New(msg.AnimStateChanged)
}
if zero {
if err := e.store.Remove(); err != nil {
return cleanErr(err)
}
_, _ = fmt.Fprintln(out, msg.AnimBackupRemoved) // só DEPOIS de Remove() retornar nil
return nil
}
res, err := animacoes.ApplyUndo(ctx, e.sys, e.store, fresh, freshBk)
if err != nil {
if res != nil && len(res.Applied) > 0 {
Expand Down
33 changes: 20 additions & 13 deletions internal/cli/privacidade.go
Original file line number Diff line number Diff line change
Expand Up @@ -237,34 +237,41 @@ func runPrivUndo(ctx context.Context, out io.Writer, deps Deps, f privFlags) err
if err != nil {
return cleanErr(err)
}
if plan.Pending() == 0 {
_, _ = fmt.Fprintln(out, textsafe.Multiline(formatUndo(plan)))
if f.dryRun { // dry-run nunca remove nem escreve nada
_, _ = fmt.Fprintln(out, msg.PrivDryRunDone)
return nil
}
_, _ = fmt.Fprintln(out, msg.PrivUndoNothing)
return e.store.Remove()
}
zero := plan.Pending() == 0 // tudo já está como antes: só o backup seria removido, mas com a MESMA cautela do restaurar
_, _ = fmt.Fprint(out, textsafe.Multiline(formatUndo(plan)))
if f.dryRun {
if f.dryRun { // dry-run nunca remove nem escreve nada, nem com zero pendências
_, _ = fmt.Fprintln(out, msg.PrivDryRunDone)
return nil
}
if plan.NeedsAdmin() && !e.sys.IsAdmin(ctx) {
question := msg.PrivConfirmUndo
if zero {
_, _ = fmt.Fprintln(out, msg.PrivUndoNothing)
question = msg.PrivConfirmUndoNothing
} else if plan.NeedsAdmin() && !e.sys.IsAdmin(ctx) {
return errors.New(msg.PrivUndoNeedsAdm)
}
if ok, err := privConfirm(ctx, out, deps, f.yes, msg.PrivConfirmUndo); !ok || err != nil {
if ok, err := privConfirm(ctx, out, deps, f.yes, question); !ok || err != nil {
return err
}
// backup e sistema são relidos DEPOIS da confirmação e comparados ao que foi mostrado, antes de restaurar qualquer coisa.
// backup e sistema são relidos DEPOIS da confirmação e comparados ao que foi mostrado, antes de restaurar ou
// remover qualquer coisa (vale também com --yes e com zero pendências).
fresh, freshBk, err := privacidade.BuildUndo(ctx, e.sys, e.store, e.lang)
if errors.Is(err, privacidade.ErrNoBackup) {
return errors.New(msg.PrivStale)
}
if err != nil {
return cleanErr(err)
}
if formatUndo(fresh) != formatUndo(plan) || fresh.Pending() != plan.Pending() || !reflect.DeepEqual(freshBk, bk) {
return errors.New(msg.PrivStale)
}
if zero {
if err := e.store.Remove(); err != nil {
return cleanErr(err)
}
_, _ = fmt.Fprintln(out, msg.PrivBackupRemoved) // só DEPOIS de Remove() retornar nil
return nil
}
plan, bk = fresh, freshBk
res, err := privacidade.ApplyUndo(ctx, e.sys, e.store, plan, bk)
if err != nil {
Expand Down
32 changes: 28 additions & 4 deletions internal/cli/privacidade_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,10 @@ type privSys struct {
svcs map[string]*privacidade.ServiceState
tasks map[string]*privacidade.TaskState
writes int
// onEdition (opcional) roda no INÍCIO de cada Edition (uma por Build/BuildUndo), com o número da chamada (1, 2...):
// simula outro processo mexendo entre a leitura do plano e a de revalidação.
editions int
onEdition func(call int)
// gate bloqueia a PRÓXIMA leitura de edição (armed) até o teste liberar: simula um plano lento/cancelado.
armed atomic.Bool
entered chan struct{}
Expand All @@ -45,6 +49,10 @@ func newPrivSys(admin bool) *privSys {
func pk(key, name string) string { return strings.ToUpper(key) + "|" + name }

func (s *privSys) Edition(context.Context) (string, error) {
s.editions++
if s.onEdition != nil {
s.onEdition(s.editions)
}
if s.armed.CompareAndSwap(true, false) {
s.entered <- struct{}{}
<-s.gate
Expand Down Expand Up @@ -102,9 +110,19 @@ func (s *privSys) TaskSetEnabled(_ context.Context, p string, e bool) error {
return nil
}

type privStore struct{ b *privacidade.Backup }
type privStore struct {
removeErr error // faz o Remove() falhar (backup preservado)
b *privacidade.Backup
// afterLoad (opcional) roda DEPOIS de cada Load, com o número da chamada: simula o backup mudando entre leituras.
loads int
afterLoad func(call int)
}

func (m *privStore) Load() (*privacidade.Backup, error) {
m.loads++
if m.afterLoad != nil {
defer m.afterLoad(m.loads)
}
if m.b == nil {
return nil, nil
}
Expand All @@ -116,8 +134,14 @@ func (m *privStore) Load() (*privacidade.Backup, error) {
return &cp, nil
}
func (m *privStore) Save(b *privacidade.Backup) error { m.b = b; return nil }
func (m *privStore) Remove() error { m.b = nil; return nil }
func (m *privStore) Path() string { return `C:\ProgramData\toolkit\privacidade-backup.json` }
func (m *privStore) Remove() error {
if m.removeErr != nil {
return m.removeErr
}
m.b = nil
return nil
}
func (m *privStore) Path() string { return `C:\ProgramData\toolkit\privacidade-backup.json` }

func privDeps(t *testing.T, sys *privSys, st *privStore, goos string, tty bool, input string) Deps {
t.Helper()
Expand Down Expand Up @@ -356,7 +380,7 @@ func TestUndoDryRunSemPendenciasPreservaOBackup(t *testing.T) {
if st.b == nil || len(st.b.Entries) != 1 {
t.Fatal("desfazer --dry-run apagou o backup")
}
if _, err := runPriv(t, privDeps(t, sys, st, "windows", false, ""), "desfazer"); err != nil || st.b != nil {
if _, err := runPriv(t, privDeps(t, sys, st, "windows", false, ""), "desfazer", "--yes"); err != nil || st.b != nil {
t.Errorf("sem --dry-run o backup sem pendências deve ser removido: %v %v", err, st.b)
}
}
Expand Down
Loading
Loading