feat: public dotfiles tier — no credential, no identity, one installer

Fresh history. This is the repo a throwaway VM clones anonymously: it brings a
machine to a working baseline and carries nothing that makes it mine.

56 files. 50 land in $HOME, 3 are chezmoi metadata, 2 are repo documentation,
1 is the manifest, and a 15-file test harness stays behind in .tests/.

What did not travel, and why:

  encrypted_private_bws-token.age   a real credential; age is dropped entirely
  .chezmoidata/bws.toml             env-var -> secret-id map; belongs with the
                                    tier that can use it
  SECRETS.md                        documentation of the rules, not config
  finish-setup.sh.tmpl              superseded by dotup
  nvim/init.lua.backup              dead file
  dot_claude/**, dot_codex/**,      120 files of agent config, private tier
  dot_pi/**

De-identified rather than dropped:

  .gitconfig   [user], the GitHub ssh rewrite and both Gitea host rewrites are
               identity, not configuration. They move behind an [include] of
               ~/.config/git/config.local, which the private tier writes. Git
               treats a missing include as a no-op, so a public-only machine
               reads the file and stops.
  .zshrc       the two gitea aliases carried a personal domain and a LAN IP.
               They move behind a guarded source of ~/.config/zsh/local.zsh,
               the sibling of the secrets.zsh seam phase 2 established.
  nvim         a commented-out LM Studio endpoint naming a LAN address.
  ghostty      a stale auto-generated header naming an absolute home directory.

Newly captured, never tracked before: ~/.zshenv, ~/.config/gh/config.yml. The
former sourced ~/.cargo/env unguarded, so every zsh on a machine without rustup
printed an error -- the same shape as the unguarded oh-my-zsh source phase 2
fixed. It is guarded now.

.chezmoiexternal.toml grows from one entry to six. oh-my-zsh, powerlevel10k,
zsh-autosuggestions, zsh-ai and tpm were hand-installed and declared nowhere,
which is why `chezmoi init --apply` on a clean box produced a .zshrc that broke
the shell it configures. The theme and both plugins nest under
.oh-my-zsh/custom/, which is what $ZSH_CUSTOM resolves to.

dotup gains an install engine. It resolves each selected package to a channel
(apt, brew, npm, uv, snap, deb, flatpak, tarball, script, builtin) through one
function every consumer reads, probes apt-cache before batching so a name apt
does not know moves to brew instead of failing all thirty, and retries
individually if a batch still fails -- which earned its keep on the first real
container run, where mermaid-cli's puppeteer dependency failed and the other
twelve npm packages installed anyway. --unattended computes safe defaults fresh
from the manifest rather than inheriting a state file, and refuses private and
invasive rows outright even when a stale state file ticks them.

The manifest gains @spec, a second directive kind alongside @needs, carrying the
argument a channel needs but a package name cannot supply -- the scoped npm
name, the flatpak app id, the .deb source. The TSV stays five columns wide.

Three bugs the container runs found, all fixed here:

  * `apt install nodejs` gives you node WITHOUT npm on Ubuntu, so all thirteen
    npm packages failed on a fresh box. The manifest asks apt for both names.
  * A tool installed a moment ago is not on this process's PATH -- uv lands in
    ~/.local/bin, npm -g honours the ~/.npmrc prefix, linuxbrew is outside a
    non-login PATH. Resolved by looking in the places we just wrote to, never by
    exporting a modified PATH.
  * `A || { B && C; }` is one || list, so when `command -v sudo` failed the list
    failed and `set -e` killed dotup at load. On a non-root machine with no
    sudo it died before printing anything. There is a regression test.

.zshenv and .p10k.zsh are marked private_. Both are shell code the login shell
executes and both applied at 664, group-writable. Third occurrence of the class
of bug phase 1 found on .pi/agent/auth.json and phase 2 found on .zshrc; the
first one found on purpose rather than by accident.

Verification: 81 assertions, 81/81 on this box and in ubuntu:24.04, ubuntu:22.04
and debian:12. The installer is driven against a directory of fake package
managers that record what they were asked to do and install nothing, so the
engine is exercised end to end without a package landing on the test machine.
`gitleaks detect` over the full history and the working tree: no leaks found,
with no allowlist and no .gitleaks.toml.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
bcherb2
2026-08-17 00:11:52 -04:00
commit b487b0e855
71 changed files with 7824 additions and 0 deletions
+76
View File
@@ -0,0 +1,76 @@
# Externals — the shell dependency chain, declared for the first time.
#
# None of these were tracked or declared anywhere before. `.zshrc` sourced
# $ZSH/oh-my-zsh.sh unguarded, so `chezmoi init --apply` on a clean box produced
# a .zshrc that broke the shell it configures, and nothing in the repo said why.
# The guard went into .zshrc in phase 2; the six entries below are the other
# half — the thing the guard is waiting for.
#
# ORDER MATTERS. chezmoi processes externals in target-path order, so
# `.oh-my-zsh` is cloned before anything under `.oh-my-zsh/custom/`. The theme
# and the two plugins are nested there deliberately: $ZSH_CUSTOM is
# ~/.oh-my-zsh/custom (see .zshrc), and oh-my-zsh's own custom/.gitignore
# excludes everything but example.zsh, so the nested clones do not dirty the
# parent working tree on refresh.
#
# --depth=1 on clone is what each of these projects recommends; a full
# oh-my-zsh history is ~50 MB of bootstrap nobody reads. `pull --ff-only` keeps
# a refresh from ever creating a merge commit in someone else's repo.
[".tmux"]
type = "git-repo"
url = "https://github.com/gpakosz/.tmux.git"
refreshPeriod = "168h"
[".tmux".pull]
args = ["--ff-only"]
[".oh-my-zsh"]
type = "git-repo"
url = "https://github.com/ohmyzsh/ohmyzsh.git"
refreshPeriod = "168h"
[".oh-my-zsh".clone]
args = ["--depth=1"]
[".oh-my-zsh".pull]
args = ["--ff-only"]
[".oh-my-zsh/custom/themes/powerlevel10k"]
type = "git-repo"
url = "https://github.com/romkatv/powerlevel10k.git"
refreshPeriod = "168h"
[".oh-my-zsh/custom/themes/powerlevel10k".clone]
args = ["--depth=1"]
[".oh-my-zsh/custom/themes/powerlevel10k".pull]
args = ["--ff-only"]
[".oh-my-zsh/custom/plugins/zsh-autosuggestions"]
type = "git-repo"
url = "https://github.com/zsh-users/zsh-autosuggestions.git"
refreshPeriod = "168h"
[".oh-my-zsh/custom/plugins/zsh-autosuggestions".clone]
args = ["--depth=1"]
[".oh-my-zsh/custom/plugins/zsh-autosuggestions".pull]
args = ["--ff-only"]
# .zshrc adds this to the plugins array only when this directory exists, and
# only here — it used to be in the array on every platform AND separately
# sourced from /opt/homebrew on macOS, so it loaded twice on mac and not at all
# on Linux. Default branch is `main`, not `master`.
[".oh-my-zsh/custom/plugins/zsh-ai"]
type = "git-repo"
url = "https://github.com/matheusml/zsh-ai.git"
refreshPeriod = "168h"
[".oh-my-zsh/custom/plugins/zsh-ai".clone]
args = ["--depth=1"]
[".oh-my-zsh/custom/plugins/zsh-ai".pull]
args = ["--ff-only"]
# Was a checked-in TPM checkout under .config/tmux/plugins. It is a clone of
# someone else's repo; it belongs here, not in git history.
[".config/tmux/plugins/tpm"]
type = "git-repo"
url = "https://github.com/tmux-plugins/tpm.git"
refreshPeriod = "168h"
[".config/tmux/plugins/tpm".clone]
args = ["--depth=1"]
[".config/tmux/plugins/tpm".pull]
args = ["--ff-only"]