paranhos-overlay

Overlay Gentoo pessoal — pacotes que não estão na árvore oficial e que prefiro auditar/manter eu mesmo em vez de depender de overlay de terceiros.

Pacotes

Categoria/Pacote	Status	Origem do código
acct-group/onepassword-cli	0	Grupo do op CLI (setgid target)
app-admin/op-cli-bin	2.34.0	Binário oficial CLI AgileBits/1Password
app-admin/1password	8.12.12	Tarball oficial 1Password Linux — polkit/onepassword group, +ssh-sign, +cli, +policykit por default
app-shells/zsh-autosuggestions	0.7.1	Plugin upstream zsh-users/zsh-autosuggestions — instala em /usr/share/zsh/site-functions/ (par do app-shells/zsh-syntax-highlighting)
x11-themes/bibata-xcursors	2.0.7	Tarball oficial ful1e5/Bibata_Cursor

Habilitar no host

Pré-requisito (caso ainda não esteja instalado):

sudo emerge app-eselect/eselect-repository

Adicionar e sincronizar o overlay (HTTPS público, somente leitura — portage roda como root e não precisa de chave SSH):

sudo eselect repository add paranhos-overlay git \
    https://forge.paranhos.com.br/gentoo/overlay.git
sudo emerge --sync paranhos-overlay

Equivalente manual (se preferir editar repos.conf em vez de usar eselect):

# /etc/portage/repos.conf/paranhos-overlay.conf
[paranhos-overlay]
location = /var/db/repos/paranhos-overlay
sync-type = git
sync-uri  = https://forge.paranhos.com.br/gentoo/overlay.git
auto-sync = yes

Para escrever no overlay (push), use a URL SSH (ssh://git@git.paranhos.com.br/gentoo/overlay.git) — só necessária na máquina onde você edita os ebuilds, não nos hosts que apenas consomem.

Instalar um pacote

# Forçar origem em ::paranhos-overlay (em caso de colisão com a árvore oficial):
sudo emerge app-admin/1password::paranhos-overlay

Para licenças proprietárias (1Password etc.):

echo 'app-admin/1password Microsoft-1password' | \
    sudo tee /etc/portage/package.license/1password

Workflow de manutenção

# Local: bumpar versão, ajustar SRC_URI, regerar Manifest
cd app-admin/1password
cp 1password-{8.12.12,8.13.0}.ebuild
$EDITOR 1password-8.13.0.ebuild
pkgdev manifest                  # ou: ebuild 1password-8.13.0.ebuild manifest

# Validar antes de comitar
pkgcheck scan
repoman full -d                  # opcional, alguns checks extras

# Commit + push (assinado quando possível)
git add app-admin/1password/
git commit -S -m "app-admin/1password: bump to 8.13.0"
git push

# No host: sincronizar e atualizar
sudo emerge --sync paranhos-overlay
sudo emerge -u app-admin/1password

Convenções

• Mensagens de commit em Português do Brasil seguindo o padrão category/package: descrição (ex: app-admin/1password: bump to 8.13.0)
• Ebuilds em inglês (DESCRIPTION, comentários técnicos), porque é o padrão do ecossistema Gentoo e os mantenedores upstream também leem
• Cada ebuild novo passa por pkgcheck scan antes do commit
• Bumps de versão preservam o ebuild anterior por uma release (segurança caso o tarball novo tenha regressão)
• Hashes obrigatórios no Manifest: BLAKE2B + SHA512 (sem MD5/SHA1)
• Commits assinados com GPG quando possível (git commit -S)