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 @@ -47,6 +47,7 @@ Ferramenta em Go para preparar máquinas Windows, Linux e macOS com um comando (
- `internal/providers/dnf`: `rpm -q --qf %{EVR}\n pkg` e `dnf list --showduplicates pkg` (ReadOnly; `ParseList` cobre dnf4 (nome longo quebrado em duas linhas) e dnf5, só o nome exato), `dnf install -y pkg[-versão]` com `Elevate`, sem Prepare (o dnf atualiza metadados sozinho). `Validate` recusa `/`, `@` e `.rpm` (o dnf lê `dir/x.rpm` como arquivo local e `@grupo` como grupo). Erros pelo stderr (`No match for argument`/`Unable to find a match` → `ErrNotFound`, ou `ErrVersionUnsupported` se havia versão fixada). Fixtures sintéticas.
- `internal/providers/pacman`: `pacman -Q pkg` e `pacman -Si pkg` (ReadOnly; `-Q` sem o `repo/`), `pacman -S --needed --noconfirm pkg` com `Elevate`, NUNCA `-Sy` (atualização parcial). `SupportsVersion` sempre recusa (`ErrVersionUnsupported`). `apt.Validate` agora recusa nome terminado em `.deb` (o apt-get o lê como arquivo local).
- `internal/providers/flatpak`: `flatpak list --app --columns=application,version` e `flatpak remote-info <remote> <id>` (ReadOnly, `LC_ALL=C`), `flatpak install --system -y --noninteractive <remote> <id>` com `Elevate` (instalação de SISTEMA; remote padrão `flathub`, via `source`). `Validate` recusa `/`, `@` e sufixos `.flatpak`, `.flatpakref`, `.flatpakrepo` em id e source (o flatpak os lê como arquivo). Só a versão atual: `SupportsVersion` recusa. "already installed" vira `AlreadyInstalled`; remote ausente = `ErrNotFound` com o comando `flatpak remote-add` na mensagem (o toolkit não adiciona remote sozinho).
- Detecção fora do winget (Windows): `internal/detect/windows.go` lê só por leitura, sem elevar, os `Uninstall` de HKLM, HKLM\WOW6432Node e HKCU (nome base exato, `publisher` opcional; ignora SystemComponent e atualizações) e o `App Paths` (`app_path`, complementar), tudo num PowerShell fixo que termina em `exit 0` (antes o exit 1 de uma raiz ausente descartava a saída toda); o estado mostra a origem (`[HKCU]`, `App Paths`). Python sem detect.windows de propósito; AppX não é lido. Detalhes em `docs/catalogo.md`.
- `toolkit install app[@versão]...` (`internal/cli/install.go`): carrega o catálogo (mesmas flags do `list`), valida TODOS os argumentos antes de executar qualquer coisa (`parseTarget`, `resolveVersion`: app com lista → `VersionVars` + `InstallApp` confere `VersionApplied`; `versions: true` → versão crua ao provider, validada por `ValidVersion`; sem versions → recusa `@`), monta o `Registry` com os seis providers sobre o Runner (`Deps.NewRunner`/`Providers`/`CheckElevation` injetáveis; padrão `exec.OSRunner`) e roda `Candidates` + `InstallApp` app a app (uma falha não impede os demais; erro final `falhou: a, b`). O plano é SEMPRE calculado primeiro, num passe com `DryRunRunner` (leituras REAIS, mutações só registradas) e impresso COMO SERÁ EXECUTADO com o MESMO GOOS/euid do runner real (`Deps.Euid`, nil = `os.Geteuid`; `OSRunner.Euid`: como root o Elevate não usa sudo, então o plano não mostra `sudo` nem avisa dele; no install real o passe do plano não repete cabeçalhos dos apps, mas se o plano sai vazio ou algum app falha nele o que ele escreveu é mantido; o aviso de `sudo -n` vem de `OSRunner.UsesSudo`, a mesma decisão do argv, e acende também para passo elevado com `Secret`) (`exec.OSRunner.Display`: `sudo -n -- env VAR=... cmd` no Unix com Elevate, `VAR=... cmd` com Env sem Elevate, `[exige administrador]` no Windows sem token), com aviso de `sudo -n` quando há passo elevado no Unix. `--dry-run` para aí. Sem `--dry-run`, depois do plano: `--yes`/`-y` executa direto; senão, com terminal (`Deps.Interactive`/`Stdin`), pergunta `[s/N]` (só s/sim/y/yes confirmam); sem terminal exige `--yes` (erro antes de qualquer mutação). Plano vazio (tudo instalado) não pergunta nem exige `--yes`; se algum app não for planejável, nada é instalado (valida tudo antes). `ErrNeedsAdmin` imprime a dica `sudo -v` (o toolkit nunca pede senha). Flatpak imprime o aviso de runtimes (GB) e de instalação só de sistema. Toda saída de pacote/catálogo passa por `printable`. O pacman 404 de espelho velho pede `sudo pacman -Syu` (nunca `-Sy`); `dnf install -y` aceita importar a chave GPG de repositório novo (o toolkit não adiciona repositórios).
- `internal/recipes` (fase 3, PR1): `Parse(file, data)` valida receitas sobre `yaml.Node` com o mesmo rigor do catálogo (erros `arquivo:linha:col` via `catalog.Errors`, todos de uma vez; chave desconhecida/repetida, âncora/alias, id de receita = nome do arquivo, id/etapa duplicados, exatamente um entre `run` e `install`, exatamente uma ação (`powershell`/`sh`/`bash`/`wsl`) válida para o SO da receita, `success_codes` 1..65535, `timeout` até 24h, `install` só `id` ou `id@versão`, diagnóstico sem `install` nem reboot; controle/Cf/Zl/Zp é erro em tudo, e `\n`/`\t` só dentro de scripts). `Recipe.Hash` = sha256 do YAML. `LoadFS(fsys, "recipes")` lê `recipes/<so>/<id>.yaml` (pasta tem de bater com `os`); `toolkit.Recipes` (embed) traz `wsl-dev` (sem a etapa `setup-inside`, que depende do `unix.sh` da fase 6), `linux-dev` e os `diag-*`; `assets_test.go` confere que validam e que todo `install` existe no catálogo.
- `internal/state` (fase 3, PR2): `state.json` das receitas. `File`/`RecipeState`/`StepState` (status de etapa pending/running/done/skipped/failed/awaiting-reboot; de receita running/awaiting-reboot/done/failed; `Options{Yes,Verbose}` guardadas para a retomada; `User` de quem iniciou; `BootID` e `ResumeAttempts` por etapa). `FileStore{Dir, ToolkitVersion}` (Dir = `platform.Paths.StateDir`): `Load` (inexistente = vazio; link simbólico/não regular = `ErrUnsafePath`; JSON quebrado, campo desconhecido, lixo no fim, status inválido ou invariante violada = `ErrCorrupt`, nunca descartado em silêncio; `schema_version` maior que o do binário = `ErrNewerSchema`; teto 4 MiB), `Save`/`Update` (lock `state.json.lock` com O_EXCL, espera 10 s e `ErrLocked`; lock com mais de 10 min é de processo morto e é removido; escrita atômica tmp 0600 no mesmo diretório + fsync + rename + fsync do diretório; `Update` faz ler-modificar-gravar sob o mesmo lock, sem corrida). Estado inválido nunca é gravado. Lock velho só é removido se o pid gravado não existe mais (`pidAlive`, Unix) e o arquivo ainda é o mesmo (`SameFile` + data) antes do `Remove`. O lock grava `pid início` (Linux: campo 22 de `/proc/<pid>/stat`): pid reaproveitado por outro processo não segura o lock, e passada 1 hora (o lock vale milissegundos) ele sai mesmo com o pid vivo.
Expand Down
15 changes: 10 additions & 5 deletions catalog/catalog.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,11 @@
#
# O bloco opcional `detect` diz como achar o app já instalado FORA do gerenciador (só leitura): o .app do .dmg no
# macOS, o programa do instalador no Windows, o .desktop ou o snap no Linux. Só entram valores conhecidos; sem
# certeza, o app fica sem o bloco (python não tem, e git só tem o do Windows: no macOS e no Linux ele é linha de
# comando, sem app).
# certeza, o app fica sem o bloco (python não tem: cada versão menor convive com as outras e o DisplayName
# "Python 3.12.x (64-bit)" não separa a que o usuário pediu; e git só tem o do Windows: no macOS e no Linux ele é linha de
# comando, sem app). No Windows, display_name casa com o DisplayName do registro Uninstall (nome exato, ou com
# versão e "(x64 ...)" no fim: nunca por substring), e app_path é só evidência complementar (a chave existe em
# App Paths), usada quando o Uninstall não tem o app; só entra para exe conhecido.
apps:
git:
name: Git
Expand Down Expand Up @@ -57,7 +60,7 @@ apps:
linux: [{ provider: flatpak, id: org.mozilla.firefox }]
detect:
macos: { app_bundle: Firefox.app, bundle_id: org.mozilla.firefox }
windows: { display_name: Mozilla Firefox }
windows: { display_name: Mozilla Firefox, app_path: firefox.exe }
linux: { desktop_id: firefox.desktop, snap: firefox }

vlc:
Expand Down Expand Up @@ -99,14 +102,14 @@ apps:
linux: [{ provider: flatpak, id: com.brave.Browser }]
detect:
macos: { app_bundle: "Brave Browser.app", bundle_id: com.brave.Browser }
windows: { display_name: Brave }
windows: { display_name: Brave, app_path: brave.exe }

chrome:
name: Google Chrome
category: navegadores
windows: [{ provider: winget, id: Google.Chrome }]
detect:
windows: { display_name: Google Chrome }
windows: { display_name: Google Chrome, app_path: chrome.exe }

libreoffice:
name: LibreOffice
Expand All @@ -123,6 +126,8 @@ apps:
category: utilitarios
windows: [{ provider: winget, id: Giorgiotani.Peazip }]
linux: [{ provider: flatpak, id: io.github.peazip.PeaZip }]
detect:
windows: { display_name: PeaZip }

# Acesso remoto (PR13, decisão 3 do plano): RustDesk (AGPL-3.0) entra SÓ com o aviso na tela. Ids verificados em
# 2026-11-14: cask rustdesk (API do Homebrew, com sha256) e flatpak com.rustdesk.RustDesk (Flathub, verificado pelo
Expand Down
20 changes: 19 additions & 1 deletion docs/catalogo.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,9 @@ Sem isto, um app instalado à mão (o Discord que veio do `.dmg`, o programa do
|---|---|---|---|
| `macos` | `app_bundle` | nome do bundle (`Discord.app`) | existe como pasta em `/Applications` ou `~/Applications`; a versão vem de `Contents/Info.plist` (`CFBundleShortVersionString`, senão `CFBundleVersion`) |
| `macos` | `bundle_id` | `CFBundleIdentifier` (`com.hnc.Discord`) | se o nome não existir, olha o `Info.plist` dos `.app` dessas duas pastas (até 500 por pasta), para achar um app renomeado |
| `windows` | `display_name` | `DisplayName` do registro Uninstall (`Discord`) | um PowerShell de texto fixo (caminho absoluto, só leitura) lista `HKLM` e `HKCU`, visões 64 e 32 bits; a versão é o `DisplayVersion` |
| `windows` | `display_name` | `DisplayName` do registro Uninstall (`Discord`) | um PowerShell de texto fixo (caminho absoluto, só leitura, sem elevar) lê as chaves `Uninstall` de `HKLM`, `HKLM\WOW6432Node` e `HKCU`; a versão é o `DisplayVersion`; ignora `SystemComponent=1`, atualizações (`ParentKeyName`/`ReleaseType`) e nome vazio |
| `windows` | `publisher` | `Publisher` do registro (`Google LLC`) | opcional; quando informado, tem de ser igual ao do registro (sem diferenciar maiúsculas); publisher ausente no registro não casa |
| `windows` | `app_path` | nome da subchave em `App Paths` (`chrome.exe`) | evidência complementar, sem versão, só quando o Uninstall não tem o app. Lê o **valor padrão** da subchave `HKLM`/`HKCU` `\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\<exe>`, tira as aspas externas, expande as variáveis de ambiente e exige um **executável local existente**: caminho absoluto `X:\...` terminado em `.exe`, **arquivo** (não pasta), nunca de rede (`\\servidor\...`) nem relativo, e em **unidade local** (`DriveType` Fixed, conferido antes de qualquer acesso: letra mapeada para a rede é recusada sem tocar o arquivo); nada é executado. Valor vazio, ilegível ou inexistente = não detectado. Se o app declara `publisher`, o App Paths **não é usado** (ele não traz publisher, e outro programa do mesmo publisher não prova o executável): só o Uninstall com nome e publisher certos detecta. Só declare para exe conhecido; termina em `.exe`, sem barras |
| `linux` | `desktop_id` | arquivo `.desktop` (`discord.desktop`) | existe em `/usr/share/applications` ou `~/.local/share/applications` |
| `linux` | `flatpak_id` | id do flatpak | `flatpak list --app` (também vale quando o instalador do catálogo é o próprio flatpak: a segunda leitura é redundante, mas inofensiva) |
| `linux` | `snap` | nome do snap | `snap list <nome>` |
Expand All @@ -99,6 +101,22 @@ Regras:
- O `display_name` casa sem diferenciar maiúsculas com o `DisplayName` do registro **depois de tirar do fim** os grupos
entre parênteses e os tokens que são só versão: `7-Zip 24.08 (x64)` casa com `7-Zip`, `Mozilla Firefox (x64 pt-BR)`
com `Mozilla Firefox`; `Git Extensions` **não** casa com `Git`. Escreva o nome base.
- No Windows o estado diz de onde veio: `instalado (fora do winget)` e, no detalhe da aba, no `toolkit list` e no
`install`, o lugar: `Programas e recursos do Windows [HKCU] ("Discord")` ou `App Paths do Windows [HKLM] (chrome.exe)`.
O script reporta o estado de CADA raiz (Uninstall `HKLM`, `HKLM-WOW64`, `HKCU` e App Paths `HKLM`, `HKCU`):
`ok`, `ausente` (a raiz não existe: normal para `HKCU\WOW6432Node` e App Paths) ou `falhou` (erro real, como acesso
negado). As leituras válidas das outras raízes continuam valendo, e falha de leitura NUNCA vira "instalado". Se
alguma raiz relevante falhou (ou o PowerShell falhou por inteiro) e o app não foi achado, o estado é
**"não detectado (leitura incompleta)"** em vez de "não instalado" (`list --installed`: `detect_gap: "incomplete"` no
JSON; na aba Apps, "não detectado (parcial)" quando a coluna é estreita). No Windows, app **sem bloco `detect`**
(Python, Microsoft Store/AppX) aparece como "não detectado" (`detect_gap: "not_applicable"`), porque a ausência no
winget não prova que ele não está na máquina. Os caminhos do registro no script são literais completos (sem `+`:
no PowerShell a vírgula tem precedência maior); um teste estático e um teste que executa o script num PowerShell com
cmdlets falsos (só no runner Windows do CI) conferem os 3 caminhos do Uninstall e os 2 de App Paths. O script termina sempre com `exit 0` (uma raiz ausente não pode
derrubar a saída das outras). Apps da Microsoft Store (AppX) não são lidos: o catálogo não tem nome de pacote
AppX para nenhum app. Python não tem `detect.windows` de propósito: as versões menores convivem e o `DisplayName`
(`Python 3.13.x (64-bit)`) não diz se é a que o usuário pediu. O `install` NÃO instala por cima sem o
`--force` (o aviso `já instalado fora do winget em ...` e o plano vazio); com `--force` ele segue e repete o aviso.
- A detecção é de melhor esforço: `plutil`, PowerShell, `flatpak` ou `snap` ausentes ou falhando viram "não
detectado", nunca um erro que trave o install. Todo texto lido (plist, registro, saída de comando, nome de
arquivo) passa por `textsafe` e é limitado em tamanho.
Expand Down
6 changes: 4 additions & 2 deletions internal/catalog/catalog.go
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,9 @@ type Installer struct {
type Detect struct {
AppBundle string // macos: nome do bundle em /Applications ou ~/Applications ("Discord.app")
BundleID string // macos: CFBundleIdentifier ("com.hnc.Discord")
DisplayName string // windows: DisplayName do registro Uninstall
DisplayName string // windows: DisplayName do registro Uninstall (nome exato, ou com versão e (x64) no fim)
Publisher string // windows: Publisher do registro Uninstall; quando informado, tem de ser igual (sem diferenciar maiúsculas)
AppPath string // windows: nome do exe em App Paths ("chrome.exe"); evidência complementar, só presença
DesktopID string // linux: arquivo .desktop ("discord.desktop")
FlatpakID string // linux: id do flatpak
Snap string // linux: nome do snap
Expand All @@ -82,7 +84,7 @@ type Detect struct {

// Empty diz se nenhum campo está preenchido.
func (d Detect) Empty() bool {
return d.AppBundle == "" && d.BundleID == "" && d.DisplayName == "" && d.DesktopID == "" && d.FlatpakID == "" && d.Snap == ""
return d.AppBundle == "" && d.BundleID == "" && d.DisplayName == "" && d.Publisher == "" && d.AppPath == "" && d.DesktopID == "" && d.FlatpakID == "" && d.Snap == ""
}

// App é um item do catálogo.
Expand Down
13 changes: 11 additions & 2 deletions internal/catalog/detect.go
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ import (
// são erros diferentes (como nos instaladores).
var detectFields = map[string][]string{
KeyMacOS: {"app_bundle", "bundle_id"},
KeyWindows: {"display_name"},
KeyWindows: {"display_name", "publisher", "app_path"},
KeyLinux: {"desktop_id", "flatpak_id", "snap"},
}

Expand All @@ -27,6 +27,7 @@ var (
bundleIDRe = regexp.MustCompile(`^[A-Za-z0-9][A-Za-z0-9.-]*$`)
desktopIDRe = regexp.MustCompile(`^[A-Za-z0-9][A-Za-z0-9._-]*\.desktop$`)
flatpakIDRe = regexp.MustCompile(`^[A-Za-z0-9][A-Za-z0-9._-]*$`)
appPathRe = regexp.MustCompile(`^[A-Za-z0-9][A-Za-z0-9._ +-]*\.exe$`)
snapRe = regexp.MustCompile(`^[a-z0-9][a-z0-9-]*$`)
)

Expand Down Expand Up @@ -94,7 +95,7 @@ func (p *parser) parseDetectOS(appID, osKey string, n *yaml.Node) (Detect, bool)
p.errAt(v, "app %q: detect.%s: %q não pode ser vazio nem ter espaço nas pontas", appID, osKey, k.Value)
continue
}
if utf8.RuneCountInString(val) > maxDetectLen || (strings.Contains(val, "..") && k.Value != "display_name") {
if utf8.RuneCountInString(val) > maxDetectLen || (strings.Contains(val, "..") && k.Value != "display_name" && k.Value != "publisher") {
p.errAt(v, "app %q: detect.%s: %q com tamanho ou formato inválido", appID, osKey, k.Value)
continue
}
Expand All @@ -109,6 +110,12 @@ func (p *parser) parseDetectOS(appID, osKey string, n *yaml.Node) (Detect, bool)
case "display_name":
ok = true // texto livre (já sem controle e formatação pela carga); casa com o DisplayName do registro
d.DisplayName = val
case "publisher":
ok = true // texto livre, como display_name
d.Publisher = val
case "app_path":
ok = appPathRe.MatchString(val)
d.AppPath = val
case "desktop_id":
ok = desktopIDRe.MatchString(val)
d.DesktopID = val
Expand Down Expand Up @@ -141,6 +148,8 @@ func detectHint(field string) string {
return "nome do bundle terminado em .app, sem barras, como Discord.app"
case "bundle_id":
return "letras, números, ponto e hífen, como com.hnc.Discord"
case "app_path":
return "nome do executável terminado em .exe, sem barras, como chrome.exe"
case "desktop_id":
return "arquivo terminado em .desktop, sem barras"
case "flatpak_id":
Expand Down
34 changes: 34 additions & 0 deletions internal/catalog/detect_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,14 @@ func TestDetectErros(t *testing.T) {
{"display com borda em branco", " detect:\n windows: { display_name: \" Discord\" }\n", `display_name`},
{"valor não é texto", " detect:\n linux: { snap: [a] }\n", `snap`},
{"ESC no valor", " detect:\n windows: { display_name: \"Dis\\ecord\" }\n", `U+001B`},
{"publisher em outro SO", " detect:\n macos: { publisher: X }\n", `não vale para detect.macos`},
{"app_path em outro SO", " detect:\n linux: { app_path: chrome.exe }\n", `não vale para detect.linux`},
{"app_path sem .exe", " detect:\n windows: { app_path: chrome }\n", `app_path`},
{"app_path com barra", " detect:\n windows: { app_path: \"a\\\\b.exe\" }\n", `app_path`},
{"app_path com ..", " detect:\n windows: { app_path: \"a..b.exe\" }\n", `app_path`},
{"publisher vazio", " detect:\n windows: { publisher: \" \" }\n", `publisher`},
{"publisher com ESC", " detect:\n windows: { publisher: \"Go\\eogle\" }\n", `U+001B`},
{"publisher gigante", " detect:\n windows: { publisher: \"" + strings.Repeat("a", 201) + "\" }\n", `publisher`},
{"bidi", " detect:\n windows: { display_name: \"Dis\\u202Ecord\" }\n", `U+202E`},
}
for _, tc := range cases {
Expand All @@ -118,3 +126,29 @@ func TestDetectErroTemLinhaEColuna(t *testing.T) {
t.Fatalf("posição: %v", err)
}
}

func TestDetectWindowsPublisherEAppPath(t *testing.T) {
src := detectBase + ` detect:
windows: { display_name: Google Chrome, publisher: "Google LLC", app_path: chrome.exe }
`
c, err := Parse("catalog.yaml", []byte(src))
if err != nil {
t.Fatal(err)
}
a, _ := c.Get("discord")
w, ok := a.DetectFor("windows")
if !ok || w.Publisher != "Google LLC" || w.AppPath != "chrome.exe" {
t.Fatalf("%+v", w)
}
// So app_path (sem display_name) também é um bloco válido, e o Merge copia os campos novos.
only := detectBase + " detect:\n windows: { app_path: chrome.exe }\n"
c2, err := Parse("catalog.yaml", []byte(only))
if err != nil {
t.Fatal(err)
}
m, _ := Merge(c2, nil, false)
a2, _ := m.Get("discord")
if d, ok := a2.DetectFor("windows"); !ok || d.AppPath != "chrome.exe" {
t.Fatalf("merge: %+v %v", d, ok)
}
}
Loading
Loading