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
1 change: 1 addition & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,7 @@ Ferramenta em Go para preparar máquinas Windows, Linux e macOS com um comando (
- `scripts/release.sh --version vX.Y.Z [--out dist] [--dry-run] [--sign-macos]` (fase 6): release LOCAL (sem Actions). Compila os 6 alvos (`CGO_ENABLED=0 -trimpath -buildvcs=false`, `-ldflags` com `Version/Commit/Date` do módulo lido por `go list -m`) para `dist/toolkit_<os>_<arch>[.exe]` (binário cru), copia `unix.sh`/`win.ps1`, e gera `checksums.txt` (sha256sum) por ÚLTIMO (assinar muda o binário). Assinatura (`codesign --options runtime --timestamp`, identidade só por `TOOLKIT_SIGN_IDENTITY`, sem valor padrão no repo) e notarização (`ditto` + `xcrun notarytool submit --wait`) são funções separadas, DESLIGADAS por padrão (`--sign-macos`). `NOTARY_KEY_ID`, `NOTARY_ISSUER`, `NOTARY_P8_OP_REF` (referência do 1Password) e `TOOLKIT_SIGN_IDENTITY` vêm do ambiente ou de `~/.config/toolkit/release.env` (`TOOLKIT_RELEASE_ENV`, permissão 600/400 exigida), NUNCA do repo; faltando algum, falha antes de compilar. Guardas antes de compilar/apagar: árvore limpa e tag `vX.Y.Z` existente e igual a HEAD (o binário leva `Commit=HEAD`); `--out` resolvido pelo caminho real, só subdiretório do repo (recusa vazio, `/`, o repo, `.git`, link simbólico e diretório com arquivo versionado). O .p8 sai de `op read` para arquivo temporário 600 apagado por trap e nunca é impresso. Não publica: o `gh release create ... --draft` é manual, só com OK do Paulo. `release_test.sh` (no `ci.sh`) roda numa CÓPIA do repo em diretório temporário (git init + tag) e usa `op`/`codesign`/`xcrun`/`ditto` FALSOS num PATH temporário (nada é assinado nem notarizado de verdade), confere dry-run sem efeito, 6 binários + checksums válidos, versão embutida, assinatura só nos 2 darwin com checksums depois dela, p8 com perm 600 e apagado, e que o script não tem credencial literal.
- TUI por ÁREAS (redesign, fase 3 de 7): `tui.NewWithAreas`/`RunAreas`, `AreaDef`/`Area`, seções em lista plana `Model.tabs`; `0` a `5` vão à área, Tab troca de seção dentro dela, linha 2 com `admin: sim/não` (`Options.IsAdmin`), `InfoTab` para Início e Rede/Análise; `New(o, tabs...)` é o modo legado. Ver `docs/tui.md` ("Áreas e seções").
- Início da TUI (redesign, fase 4 de 7; `internal/tui/inicio_tab.go`, `internal/cli/tui_inicio.go`, `docs/tui.md`): a área 0 é uma lista de OBJETIVOS ("O que você quer fazer?", sete itens com frase didática e etiqueta por GOOS/admin, sem ler nada do sistema). Enter e `1`..`7` abrem a área/seção do item pelo contrato opcional `tui.KeyClaimer` (só em navegação normal) e a mensagem `tui.GoToMsg{Area, Section}`, que a RAIZ trata em `Model.goTo` (ignora Revisão, execução, modal, pergunta e seção capturando; a confirmação nunca é abandonada, com teste integrado usando PrivacyTab/NativeAppsTab reais). O destino é achado pelas áreas montadas (chave da área + título da seção), não por índice fixo.
- TUI: partida leve (v0.4.0, `docs/tui.md`): a raiz mantém UM relógio de quadros (seções pedem `Theme.Tick()` = `tickWantMsg`, a raiz deduplica; nunca agendar tick por seção), carrega só a seção ativa no `Init` e as outras na primeira visita (`Model.wake`), e o `detect` do Windows lê o registro UMA vez por prazo (`readWindowsRegistry`, `Invalidate`). Testes em `internal/tui/partida_perf_test.go`.
- `internal/tui` (fase 4, PR1): `Model` (raiz: tamanho, aba ativa, ajuda, sair; Bubble Tea v2 `charm.land/bubbletea/v2`, Lip Gloss v2, Bubbles v2, versões exatas), interface `Tab` (`Title/Short/Update/View(w,h)/Keys/Status/More/Selected`), `Theme` (tokens; `Mono` = NO_COLOR sem nenhuma sequência de estilo e layout idêntico ao colorido), layout fixo (cabeçalho com abas e versão, régua, corpo H-5, régua com `↓ mais N`, estado, teclas), tela única abaixo de 60x16, abas estreitas abaixo de 70. `DefaultTabs` são só o estado vazio até cada aba ganhar a sua (PRs seguintes). Testes: golden em `testdata/` (80x24, 60x17, ajuda; `UPDATE_GOLDEN=1` regera e se revisa o diff), tela sempre com H linhas e <= W colunas, texto de fora sem escape. `internal/textsafe`: `Printable`/`Line`, usado por `cli.printable` e por todo texto de fora da TUI. Especificação completa em `docs/tui.md` (variante A e as decisões 1-5 confirmadas pelo Paulo).
- `internal/tui` Revisão, execução e Log (fase 4, PR4: `exec.go`, `review.go`, `model_exec.go`, `logtab.go`): interfaces `Planner` (`Plan(ctx, Selection) Plan`: o MESMO passe do `toolkit install --dry-run`, nunca um segundo planejador; `Plan` traz Summary, Env, Warnings, Changes, Commands já 'como será executado', Problems, NothingToDo) e `Runner` (`Run(ctx, Selection, chan<- Event)`; fecha o canal; reaproveita `providers.InstallApp` e `recipes.Engine`). A raiz ganhou o modo (`modeNav` -> `modeReview` -> `modeRun`): Enter nas abas (sem marcados só avisa) abre a Revisão (carrega com spinner; foco inicial em Voltar; Tab troca o botão; `s` ou Enter em Executar executa; com Problems/NothingToDo/erro só Voltar e `s` não faz nada; comandos longos quebram com recuo e `\` e NUNCA são cortados). Executar vai à aba Log; durante a execução as outras abas são só leitura (espaço, Enter, v e / bloqueados com aviso); `q`/Ctrl+C pergunta 'Interromper? ... [s/N]' (só `s` cancela o ctx: item atual encerrado e fila descartada); evento `EventRebootPrompt` vira pergunta [s/N] e a resposta volta pelo `Reply`. `LogTab`: itens (símbolo+palavra+duração) em cima, log do item sob o cursor embaixo, `\r` substitui a última linha, `f` segue o fim, PgUp desliga o seguir, resumo 'Terminou com N falhas · N ok · N falhou' com o cursor na primeira falha, aviso '! Não deu para gravar o log em arquivo'. Cada Revisão tem um `id` e a seleção planejada (`reviewScreen.id/sel`): `planReadyMsg` de outra Revisão é ignorado e Executar entrega ao executor a seleção PLANEJADA, não a das abas. Um diálogo [s/N] por vez (`open/answer`): só s/S (sim) e n/N/Esc (não) respondem, outra tecla é ignorada; um pedido de reinício que chega com o diálogo de interrupção aberto espera a vez (e recebe 'não' se a execução for interrompida); a resposta ao `Reply` nunca bloqueia o loop (`deliver`: envio imediato, senão goroutine que desiste quando a execução termina). `wrap` quebra por largura de CÉLULA e por GRAFEMA (`splitCells` com `rivo/uniseg`, medindo com `lipgloss.Width`: ❤️ = U+2764+U+FE0F ocupa 2 células, sequência ZWJ e combinante são um grafema só) e nunca corta; resumo e ambiente do plano também quebram. O ZWJ (U+200D, caractere de formatação) aparece como `\\u200d` por política do `textsafe`. Todo texto (plano, nomes, log, erros) por `textsafe`. A implementação real de `Planner`/`Runner` (cli) e o `printPlan` com GOOS/euid do runner real entram no PR que liga `toolkit` sem args.
- `toolkit` sem argumentos (fase 4, PR5b, `internal/cli/tui.go`): `runRoot` abre a TUI só quando `shouldOpenTUI` (stdin E stdout são terminal; a entrada E a saída usam a MESMA detecção, `fileIsTerminal` = `charmbracelet/x/term.IsTerminal` por fd (`stdinIsTerminal` também; dispositivo de caractere não basta: /dev/null e /dev/zero também são, e `toolkit install x </dev/null` não é interativo); sem `--no-tui`, TERM nem vazio nem `dumb`); senão mostra a ajuda. Pontos injetáveis em `Deps.TUI` (`StdoutIsTerminal`, `Term`, `Run`). `appsBackend` (catálogo + providers: `Load`, `Status` por `IsInstalled`, `Versions`: a lista ESTÁTICA do catálogo (`versions: [...]`) sem consultar o gerenciador, só `versions: true` consulta `ListVersions`, app sem versões não oferece nada; só leitura) e `recipesBackend` (`recipes` + `state`; state corrompido vira `StateErr`, as receitas continuam) alimentam as abas. `tuiPlanner`/`tuiRunner` (PR 5c, `internal/cli/tui_exec.go`, detalhes em `docs/tui.md`) estão ligados por `tui.Options.Planner/Runner`: a TUI revisa e EXECUTA (Planner = passe do `install --dry-run` + receitas, com pré-checagens como `Problems` e script PowerShell legível; Runner = `installOne` + `buildEngine` com `eventPrompter`, log em arquivo só de status + classe do erro, `Reloader` depois; elevação das receitas igual à da engine; passos `install:` pelo passe do plano; `Plan.Approved` = lista de permissão do executor). Sem Planner/Runner (testes, transição) Enter só avisa. `toolkit update` e o aviso de versão (bullet abaixo) seguem em `docs/tui.md`; a localização (pt-BR/en/es) e a auditoria de acessibilidade estão em `docs/roadmap.md`.
Expand Down
10 changes: 9 additions & 1 deletion docs/tui.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,7 +157,7 @@ canal e devolve o próximo lote.
| `rebootPromptMsg{receita}` | raiz: pergunta na linha de estado |
| `runDoneMsg{resumo}` | raiz: modo Resumo; apps recarrega os estados |
| `updateAvailableMsg{atual, nova, notas}` | raiz; falha na consulta é silenciosa |
| `spinner.TickMsg` | raiz; só há tick enquanto algo carrega ou roda |
| `tickMsg` / `tickWantMsg` | raiz: UM relógio de quadros (100 ms) para todas as seções; as seções só PEDEM quadro (`Theme.Tick()` → `tickWantMsg`) e a raiz deduplica; só há quadro enquanto algo carrega ou roda |

## Tokens (Lip Gloss v2, `internal/tui/theme.go`)

Expand Down Expand Up @@ -187,6 +187,14 @@ reinício, `○` pendente/não instalado/na fila, `-` pulado/sem instalador, `|
`[x] [ ]` marca, `(•) ( )` escolha única, `▾` tem lista, `↑` versão nova, `↓` há mais. Conjunto ASCII
atrás de `--ascii`: depois.

**Partida leve (v0.4.0):** a abertura carrega só a seção ativa (o Início, sem I/O); cada outra seção carrega na PRIMEIRA visita
(`Model.wake`, depois do `Init`) e nunca de novo, e depois de uma execução só as seções já abertas são relidas. Um quadro
do spinner por 100 ms, não um por seção (antes cada seção agendava o seu e todo quadro ia a todas, então com K seções
carregando os quadros multiplicavam por K a cada 100 ms e a seta travava). No Windows a leitura do registro de
desinstalação roda UMA vez por 30 s para todos os apps (`internal/detect`, `Invalidate` depois de instalar). Testes:
`internal/tui/partida_perf_test.go` (quadros, primeira tela < 100 ms, seta < 30 ms durante a carga, teto do View com
300 apps) e `internal/detect/windows_cache_test.go`.

Bordas: réguas `─`; só os modais têm caixa (`lipgloss.NormalBorder()`, até 46 de largura). Movimento: só o
spinner (4 quadros, 100 ms). Troca de aba, modal e cursor são instantâneos; o log entra em lotes de 50 ms.

Expand Down
11 changes: 11 additions & 0 deletions internal/detect/detect.go
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,14 @@ type Detector struct {
macIndex map[string]Found // bundle_id (minúsculo) -> bundle achado, da varredura de /Applications e ~/Applications
macAt time.Time // quando a varredura foi feita (vale cacheTTL)
macBuilt bool

// leitura do registro do Windows (windows.go): uma por prazo, para todos os apps. winMu fica preso durante a
// leitura de propósito (perguntas simultâneas esperam a mesma).
winMu sync.Mutex
winOut []byte
winOK bool
winAt time.Time
winBuilt bool
}

// cacheTTL é por quanto tempo a varredura de .app por bundle_id é reaproveitada: a TUI pergunta o estado de
Expand All @@ -74,6 +82,9 @@ func (d *Detector) Invalidate() {
d.mu.Lock()
d.macIndex, d.macBuilt = nil, false
d.mu.Unlock()
d.winMu.Lock()
d.winOut, d.winBuilt = nil, false
d.winMu.Unlock()
}

// New cria o detector sobre o Runner (só leituras).
Expand Down
31 changes: 27 additions & 4 deletions internal/detect/windows.go
Original file line number Diff line number Diff line change
Expand Up @@ -104,13 +104,36 @@ func incomplete(status map[rootKey]string, roots ...[]rootKey) bool {
return false
}

// readWindowsRegistry roda o script UMA vez e reaproveita a saída pelo prazo do cache (cacheTTL), tanto o sucesso
// quanto a falha: a TUI pergunta o estado de cada app do catálogo e cada pergunta rodava um PowerShell que lê todo o
// registro (centenas de ms de CPU por app, vários em paralelo na partida). Perguntas simultâneas esperam a mesma
// leitura (o lock fica preso enquanto ela roda). Cancelamento não é guardado. Invalidate descarta (depois de
// instalar ou remover algo).
func (d *Detector) readWindowsRegistry(ctx context.Context) ([]byte, bool) {
d.winMu.Lock()
defer d.winMu.Unlock()
if d.winBuilt && d.now().Sub(d.winAt) < cacheTTL {
return d.winOut, d.winOK
}
res, err := d.rn.Run(ctx, d.readOnly(exec.Cmd{Name: windowsPowerShell,
Args: []string{"-NoProfile", "-NonInteractive", "-Command", uninstallScript}, Timeout: 30 * time.Second}))
if ctx.Err() != nil {
return nil, false // cancelado: não vira cache
}
ok := err == nil && res.ExitCode == 0 && len(res.Stdout) <= maxUninstallOutput
d.winOut, d.winOK, d.winAt, d.winBuilt = nil, ok, d.now(), true
if ok {
d.winOut = res.Stdout
}
return d.winOut, ok
}

func (d *Detector) findWindows(ctx context.Context, spec catalog.Detect) (Found, bool) {
if (spec.DisplayName == "" && spec.AppPath == "") || d.rn == nil {
return Found{}, false
}
res, err := d.rn.Run(ctx, d.readOnly(exec.Cmd{Name: windowsPowerShell,
Args: []string{"-NoProfile", "-NonInteractive", "-Command", uninstallScript}, Timeout: 30 * time.Second}))
if err != nil || res.ExitCode != 0 || len(res.Stdout) > maxUninstallOutput {
out, readOK := d.readWindowsRegistry(ctx)
if !readOK {
// Nada foi lido: não é "não instalado", é detecção incompleta.
return Found{Incomplete: true}, false
}
Expand All @@ -121,7 +144,7 @@ func (d *Detector) findWindows(ctx context.Context, spec catalog.Detect) (Found,
viaPath *Found
)
status := map[rootKey]string{}
for _, line := range strings.Split(string(res.Stdout), "\n") {
for _, line := range strings.Split(string(out), "\n") {
f := strings.Split(strings.TrimRight(line, "\r"), "\t")
switch {
case len(f) == 4 && f[0] == "S":
Expand Down
82 changes: 82 additions & 0 deletions internal/detect/windows_cache_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
package detect

import (
"context"
"sync"
"testing"

"github.com/PiluTech/toolkit/internal/exec"
)

// A TUI pergunta o estado de cada app do catálogo e, no Windows, cada pergunta rodava um PowerShell que lê TODO o
// registro de desinstalação (centenas de ms de CPU por app, 4 em paralelo na partida). Uma leitura serve a todos.
func TestWindowsUmaLeituraDoRegistroServeTodosOsApps(t *testing.T) {
s := winStub(u("HKLM", "Git", "2.45.1", "P"), u("HKLM", "Discord", "1.0", "P"))
d := New(s, Options{GOOS: "windows"})
git, dis := winApp(t, "display_name: Git"), winApp(t, "display_name: Discord")
for i := 0; i < 10; i++ {
if f, ok := find(t, d, git); !ok || f.Version != "2.45.1" {
t.Fatalf("git: %+v %v", f, ok)
}
if _, ok := find(t, d, dis); !ok {
t.Fatal("discord")
}
}
if len(s.calls) != 1 {
t.Fatalf("PowerShell rodou %d vezes para 20 perguntas (esperado 1)", len(s.calls))
}
d.Invalidate() // depois de instalar ou remover algo a leitura é refeita
find(t, d, git)
if len(s.calls) != 2 {
t.Fatalf("Invalidate deve forçar uma leitura nova: %d", len(s.calls))
}
}

func TestWindowsPerguntasSimultaneasFazemUmaLeitura(t *testing.T) {
s := winStub(u("HKLM", "Git", "2.45.1", "P"))
d := New(s, Options{GOOS: "windows"})
a := winApp(t, "display_name: Git")
var wg sync.WaitGroup
for i := 0; i < 8; i++ {
wg.Add(1)
go func() {
defer wg.Done()
_, _, _ = d.Find(context.Background(), a)
}()
}
wg.Wait()
if len(s.calls) != 1 {
t.Fatalf("8 perguntas simultâneas fizeram %d leituras (esperado 1)", len(s.calls))
}
}

// Leitura que falhou também vale pelo prazo: 40 apps não rodam 40 PowerShell de 30 s cada num registro quebrado; o
// resultado continua "leitura incompleta", nunca "não instalado".
func TestWindowsFalhaDaLeituraTambemEhReaproveitada(t *testing.T) {
failing := &stub{handle: func(_ exec.Cmd) (exec.Result, error) { return exec.Result{ExitCode: 1}, nil }}
d := New(failing, Options{GOOS: "windows"})
a := winApp(t, "display_name: Git")
for i := 0; i < 5; i++ {
if f, ok := find(t, d, a); ok || !f.Incomplete {
t.Fatalf("falha deve ser leitura incompleta: %+v %v", f, ok)
}
}
if len(failing.calls) != 1 {
t.Fatalf("%d execuções para 5 perguntas (esperado 1)", len(failing.calls))
}
}

// Cancelamento NÃO é cacheado: a próxima pergunta, com contexto vivo, lê de verdade.
func TestWindowsCancelamentoNaoViraCache(t *testing.T) {
s := winStub(u("HKLM", "Git", "2.45.1", "P"))
d := New(s, Options{GOOS: "windows"})
a := winApp(t, "display_name: Git")
ctx, cancel := context.WithCancel(context.Background())
cancel()
if _, _, err := d.Find(ctx, a); err == nil {
t.Fatal("contexto cancelado devolve erro")
}
if f, ok := find(t, d, a); !ok || f.Version != "2.45.1" {
t.Fatalf("depois do cancelamento a leitura é feita: %+v %v", f, ok)
}
}
Loading
Loading