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
51 changes: 51 additions & 0 deletions .github/workflows/nix-rehearsal.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Explicitly approved Nix installation in disposable GitHub runners only.
name: Nix standalone build only
on:
push:
paths: ['portable-linux/flake.nix', 'portable-linux/nix/**', 'portable-linux/files/**', '.github/workflows/nix-rehearsal.yml']
pull_request:
paths: ['portable-linux/flake.nix', 'portable-linux/nix/**', 'portable-linux/files/**', '.github/workflows/nix-rehearsal.yml']
workflow_dispatch:
permissions:
contents: read
jobs:
standalone:
runs-on: ubuntu-24.04
timeout-minutes: 35
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Official pinned Nix distribution in disposable runner only
shell: bash
run: |
set -euo pipefail
runtime_home=$(mktemp -d /tmp/nix-ci-home-XXXXXX)
dist=$(mktemp -d /tmp/nix-ci-dist-XXXXXX)
release=https://releases.nixos.org/nix/nix-2.35.2
archive=nix-2.35.2-x86_64-linux.tar.xz
curl --fail --location --proto '=https' --tlsv1.2 "$release/$archive" -o "$dist/$archive"
curl --fail --location --proto '=https' --tlsv1.2 "$release/$archive.sha256" -o "$dist/checksum"
checksum=$(tr -d '\r\n' < "$dist/checksum")
[[ "$checksum" =~ ^[0-9a-f]{64}$ ]]
(cd "$dist" && printf '%s %s\n' "$checksum" "$archive" | sha256sum --check -)
tar -xJf "$dist/$archive" -C "$dist"
HOME="$runtime_home" "$dist/nix-2.35.2-x86_64-linux/install" --no-daemon --no-channel-add --no-modify-profile
printf '%s\n' "$runtime_home/.nix-profile/bin" >> "$GITHUB_PATH"
- name: Generate real lock, evaluate Linux targets, build x86_64 without activation
shell: bash
env:
PYTHONDONTWRITEBYTECODE: '1'
run: |
set -euo pipefail
python3 portable-linux/nix/validate.py --build > "$RUNNER_TEMP/nix-result.json"
stage=$(python3 -c 'import json,sys; print(json.load(open(sys.argv[1]))["stage"])' "$RUNNER_TEMP/nix-result.json")
mkdir "$RUNNER_TEMP/nix-evidence"
cp "$stage/source/flake.lock" "$stage/sources.json" "$stage/validation.json" "$RUNNER_TEMP/nix-evidence/"
- name: Preserve generated lock and successful build evidence for review
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
with:
name: nix-lock-and-validation
path: ${{ runner.temp }}/nix-evidence/
if-no-files-found: error
retention-days: 7
10 changes: 6 additions & 4 deletions portable-linux/AGENT-SETUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,12 +161,14 @@ Pin do checkout obtido no [commit oficial de v7.0.1](https://github.com/actions/

## Nix e limites

Home Manager permanece opcional e não instalado/avaliado. Reaproveita os arquivos
Home Manager permanece opcional e não instalado no notebook. O ensaio standalone
foi avaliado nos dois alvos Linux e construído em x86_64 no runner Nix autorizado,
sem ativação; ver `nix/README.md` para lock, CI e limites. Reaproveita os arquivos
base, incluindo Git explícito, mas perfis dinâmicos/identidade não têm integração
Home Manager completa. Não misturar dois gerenciadores sobre os mesmos destinos:
symlinks Home Manager são recusados por este bootstrap. Sem lock inventado ou
alegação de reprodutibilidade Nix. SO/TI, identidade, stateVersion e inputs/pins
exigem configuração e avaliação/build posteriores em ambiente autorizado.
symlinks Home Manager são recusados por este bootstrap. O lock incluído foi gerado pela ferramenta no runner e revisado. SO/TI, identidade
e stateVersion do host futuro exigem configuração explícita e avaliação/build
posteriores; o fixture não autoriza ativação real.

O módulo AI é somente orientação, sem provider, endpoint, token, MCP, skills massivas,
históricos, sessões ou mudança de permissões. Backup dos 13 arquivos pendentes e
Expand Down
2 changes: 1 addition & 1 deletion portable-linux/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Projetos/WIP precisam de plano independente: selecionar apenas código pessoal a

## Nix opcional

O módulo em `nix/home.nix` declara sete CLIs e os três dotfiles comuns. Não é configuração standalone completa ou ativada: requer home.username, home.homeDirectory, home.stateVersion e inputs compatíveis definidos na configuração aprovada do host. Sem flake.lock inventado. Nix estava ausente durante a preparação: checagem lexical/referências passou, mas parser/eval/build não foi executado. Ver `nix/README.md`.
O módulo em `nix/home.nix` declara sete CLIs e os três dotfiles comuns. `flake.nix` e `nix/rehearsal.nix` acrescentam entrada standalone com inputs oficiais fixados e identidade sintética Linux, sem ativação. `nix/validate.py` exporta somente seis fontes para ensaio e pode gerar lock/eval/build em ambiente Nix autorizado. Nix continua ausente localmente. O CI autorizado com Nix 2.35.2 gerou o flake.lock real, avaliou x86_64/ARM64 e construiu x86_64, sem ativação. O lock foi revisado e incorporado à branch; reutilização e checks do commit atual devem passar antes de merge. Ver [nix/README.md](nix/README.md).

Nix pode precisar admin para /nix, inclusive single-user; não contornar TI. Se Nix não for autorizado, manter os arquivos comuns e ferramentas instaladas pelo mecanismo aprovado. Drivers/GPU/audio, VPN, login, agentes de segurança e GUI ficam fora da primeira camada.

Expand Down
49 changes: 49 additions & 0 deletions portable-linux/flake.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

29 changes: 29 additions & 0 deletions portable-linux/flake.nix
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
{
description = "Personal Linux Home Manager rehearsal; build only, never activate";

inputs = {
# Official release branches inspected on 2026-10-03. A real Nix-generated
# flake.lock is still required; these revision pins are not a substitute.
nixpkgs.url = "github:NixOS/nixpkgs/774debe7a0d1b496e35677ad955a1011c6ff74f3";
home-manager.url = "github:nix-community/home-manager/e5fcd298a00f08b6e8390baf04aa8edb62203070";
home-manager.inputs.nixpkgs.follows = "nixpkgs";
};

outputs = { nixpkgs, home-manager, ... }:
let
systems = [ "x86_64-linux" "aarch64-linux" ];
mkHome = system: home-manager.lib.homeManagerConfiguration {
pkgs = import nixpkgs { inherit system; config.allowUnfree = false; };
modules = [ ./nix/home.nix ./nix/rehearsal.nix ];
};
in {
homeConfigurations = builtins.listToAttrs (map (system: {
name = "rehearsal-${system}";
value = mkHome system;
}) systems);
packages = builtins.listToAttrs (map (system: {
name = system;
value = { default = (mkHome system).activationPackage; };
}) systems);
};
}
119 changes: 112 additions & 7 deletions portable-linux/nix/README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,118 @@
# Nix opcional — módulo rascunho
# Nix/Home Manager standalone — ensaio sem ativação

`home.nix` é um módulo Home Manager mínimo implementado em fonte, não uma instalação standalone completa nem uma configuração ativável já validada. Reutiliza exatamente os três arquivos comuns e declara sete CLIs. Não instala Nix, altera login shell, habilita serviços, ativa contas ou copia configuração corporativa.
Configuração standalone Linux com avaliação/build reais no CI Nix 2.35.2.
O módulo `home.nix` existente era válido como módulo mínimo, mas faltavam inputs,
identidade de ensaio e ponto de entrada. Ele foi preservado; `../flake.nix` fornece
Nixpkgs/Home Manager e `rehearsal.nix` fornece somente uma identidade sintética.
Nenhuma configuração do notebook ou identidade corporativa foi importada.

Alvo provisório: Linux genérico. A configuração standalone do host, criada somente depois de aprovação de TI, deve importar este módulo e definir `home.username`, `home.homeDirectory` e `home.stateVersion` com dados/versão confirmados. Não inferir nome de conta ou diretório a partir do notebook de origem; não atualizar stateVersion automaticamente. Selecionar release compatível de Nixpkgs/Home Manager e guardar a seleção revisada. Não há flake.lock gerado: sem Nix/rede nesta fase, não inventamos um lock ou pin alegadamente validado.
## Inputs e alvo

Verificação atual: checagem local de delimitadores, referências existentes, allowlist de pacotes/arquivos e ausência de imports externos/secrets. Isso **não substitui** parser/eval/build Nix. Nix não está instalado neste equipamento; parse e avaliação completos são pendências explícitas. Depois de TI aprovar ambiente de ensaio apropriado, usar parser/eval e build, inspecionar outputs e diff da ativação antes de qualquer switch. Não executar switch nesta preparação.
Releases compatíveis: Nixpkgs `nixos-26.05` e Home Manager `release-26.05`, conforme
[orientação oficial standalone](https://raw.githubusercontent.com/nix-community/home-manager/release-26.05/docs/manual/installation/standalone.md).
Refs consultadas em 2026-10-03 e fixadas por revisões reais:

Nix pode precisar admin para `/nix`, mesmo single-user; não contornar a política de TI. Cache/downloads dependem de rede/proxy permitido; não adicionar caches ou desligar TLS. Nix store é legível por outros usuários: nenhum segredo literal, nem mesmo de repo privado. Dados mutáveis e WIP precisam de backup separado. Rollback depende de gerações preservadas; garbage collection pode remover esse caminho.
- Nixpkgs: `774debe7a0d1b496e35677ad955a1011c6ff74f3`.
- Home Manager: `e5fcd298a00f08b6e8390baf04aa8edb62203070`; nixpkgs segue o mesmo input.

Fallback permanece `restore.py` e instalação das ferramentas pelo método aprovado. Preferências Code opcionais não entram neste módulo nem no restore inicial; revisar/mesclar separadamente com configuração existente se Code estiver aprovado.
Os pins de revisão são seleção de fonte; o `flake.lock` incluído foi gerado por
`nix flake lock` no [runner autorizado](https://github.com/caiolombello/dotfiles/actions/runs/37082208570)
e seu artifact foi conferido por digest e hashes das seis fontes. NarHashes e
metadados foram produzidos pela ferramenta, sem edição manual.
Alvos: avaliação `x86_64-linux` e `aarch64-linux`; build somente x86_64 no CI proposto.
O fixture novo usa username `personal-rehearsal`, HOME `/tmp/personal-home-manager-rehearsal`
e stateVersion `26.05`; não identifica pessoa/host e jamais deve ser ativado.
Num host futuro, stateVersion é a versão inicial escolhida conscientemente, não
campo para acompanhar upgrades automaticamente.

Fontes oficiais: [instalação Home Manager](https://nix-community.github.io/home-manager/installation.html), [configuração](https://nix-community.github.io/home-manager/usage/configuration.html), [instalação Nix](https://nix.dev/manual/nix/stable/installation/installing-binary.html), [arquivos locais e store](https://nix.dev/tutorials/working-with-local-files.html), [garbage collection](https://nix.dev/manual/nix/stable/package-management/garbage-collection.html).
## Exportação mínima e comandos reais

A partir de `portable-linux/`, o comando local de exportação não precisa Nix:

```sh
PYTHONDONTWRITEBYTECODE=1 python3 nix/validate.py
```

Ele preserva scratch e copia somente seis fontes públicas fixas: flake, módulo,
fixture e os três dotfiles, mais o lock revisado quando presente. Não exporta o repo inteiro, configs locais, journals,
skills, inventários ou WIP. Nenhum arquivo de HOME é lido. Conferir o diff dessas
seis fontes antes do ensaio; a allowlist sozinha não torna uma fonte modificada segura.
O caminho `source` retornado é o único que deve entrar no Nix store. O lock existente
é reutilizado byte a byte; eval/build usam `--no-update-lock-file`.

Em ambiente descartável **já autorizado com Nix instalado**, após revisão:

```sh
PYTHONDONTWRITEBYTECODE=1 python3 nix/validate.py --build
```

O comando usa HOME temporário, não herda tokens/credenciais, não aceita nixConfig
de flakes, gera lock real somente se ausente, reutiliza o lock existente e confere revisões, avalia os dois alvos, constrói a geração
x86_64 e compara os três arquivos gerados byte a byte. Nunca executa `activate`,
`home-manager switch`, `nix profile install`, serviços ou garbage collection.
Usa o cache oficial padrão; não adiciona cache/credencial nem desativa TLS/sandbox.
Exit 0 com `validation.json` só ocorre após todas essas verificações; falta de Nix
retorna 2 antes de exportar. Outras falhas retornam não zero e preservam o scratch.

Equivalentes manuais, depois de entrar no diretório `source` exportado:

```sh
nix --extra-experimental-features 'nix-command flakes' flake lock
nix --extra-experimental-features 'nix-command flakes' eval --no-update-lock-file --raw '.#homeConfigurations.rehearsal-x86_64-linux.activationPackage.drvPath'
nix --extra-experimental-features 'nix-command flakes' eval --no-update-lock-file --raw '.#homeConfigurations.rehearsal-aarch64-linux.activationPackage.drvPath'
nix --extra-experimental-features 'nix-command flakes' build --no-update-lock-file --no-link --print-out-paths '.#packages.x86_64-linux.default'
```

Esses comandos escrevem store/downloads no ambiente isolado; não são comandos para
executar no notebook de origem. Um build não ativa configuração e não testa rollback
Home Manager real. Rollback do bootstrap foi testado separadamente; gerações Home
Manager dependem de retenção e podem sumir após GC. Nunca misturar HM e bootstrap
sobre os mesmos destinos (o bootstrap recusa symlinks).

## CI aprovado e executado

Workflow proposto: `.github/workflows/nix-rehearsal.yml`, Ubuntu 24.04 descartável.
Publicar esse workflow em branch nova dispara push/PR e instala software no runner.
Esse escopo recebeu aprovação específica: [PR draft 3](https://github.com/caiolombello/dotfiles/pull/3).
A primeira execução teve sucesso com avaliação nos dois alvos e build x86_64,
comparação byte a byte dos três dotfiles e nenhuma ativação. A incorporação do lock
e sua reutilização são verificadas pelos checks do commit atual, antes de merge.

1. Checkout oficial pinado, contents:read, credenciais não persistidas.
2. Baixar distribuição oficial Nix **2.35.2** e checksum via HTTPS; verificar checksum.
3. Executar instalador oficial single-user só no runner, sem daemon/canais/alterar
profile shell. O instalador pode usar sudo para `/nix` **do runner**, nunca do host.
4. Executar `validate.py --build`; nenhuma ativação, nenhum volume/home do notebook.
5. Preservar só lock gerado e relatórios de hashes/build em artifact por sete dias.
Não fazer commit automático, upload de HOME, pacote result ou logs privados.

Download/checksum do mesmo distribuidor verifica integridade, não é assinatura
independente. Tarball, checksum e opções do instalador foram usados com sucesso na primeira
execução; futuras falhas devem parar, sem trocar fonte/desligar checks.
Nix 2.35.2 foi confirmado na [página oficial](https://nixos.org/download/) e
[tag oficial](https://github.com/NixOS/nix/tree/2.35.2).
[Upload artifact v4.6.2](https://github.com/actions/upload-artifact/tree/ea165f8d65b6e75b540449e92b4886f43607fa02)
está pinado por SHA verificado. Sem caches adicionais, self-hosted runner ou secrets.
Artifact, lock/input graph e outputs foram revisados antes de incorporar o lock
à branch. A aprovação de CI não autoriza merge ou ativação de host.

## Limites atuais e recuperação futura

Nix continua ausente localmente; Docker socket e namespaces já bloqueados. Não
contornar permissões/kernel nem instalar runtime no notebook. A validação real
foi feita no CI Ubuntu descartável; não é container local nem setup do host.
ARM64 foi avaliado, sem build/runtime ARM64. Ativação e rollback Home Manager
não foram executados. Build/eval não certificam o futuro SO ou política de TI.
Perfis dev/machine/AI e identidade por pasta do bootstrap não foram reimplementados
nesta camada: Home Manager contém somente base e sete CLIs. Não copiar includeIf,
providers/MCP, tokens ou identidade real para obter paridade automática.

Para notebook futuro: confirmar SO/arquitetura/TI, definir módulo de host com
username/HOME/stateVersion explícitos, revisar destinos e backup antes de ativar.
Secrets nunca entram em Git/flake/store, mesmo com repo privado. Reauth é manual.
Nix opcional não substitui o sistema; fallback `setup.py` continua disponível.
Backup/arquivamento dos 13 arquivos excluídos permanece suspenso e independente.

Fontes oficiais: [instalador Nix](https://nix.dev/manual/nix/stable/installation/installing-binary.html),
[geração de lock](https://nix.dev/manual/nix/2.34/command-ref/new-cli/nix3-flake-lock.html),
[store e arquivos locais](https://nix.dev/tutorials/working-with-local-files.html).
7 changes: 7 additions & 0 deletions portable-linux/nix/rehearsal.nix
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Synthetic standalone identity. Never activate this fixture or infer a host user.
{ ... }:
{
home.username = "personal-rehearsal";
home.homeDirectory = "/tmp/personal-home-manager-rehearsal";
home.stateVersion = "26.05";
}
Loading
Loading