Feat/services and build tooling

.github/workflows/e2e.yml

@@ -1,4 +1,4 @@
-# End-to-end testing, tiered by cost/fidelity (see CLAUDE.md "Testing").
+# End-to-end testing, tiered by cost/fidelity.
 #
 # Tier 1 (this file) — render matrix: no VM, no privileges. For each config
 # fixture it builds the binary, validates the config, runs the real install CLI

README.md

@@ -421,17 +421,13 @@ kde:
 
 ### Dotfiles
 
-The dotfiles stage supports a selectable manager. When the `dotfiles:` block is omitted, the
-manager defaults to `chezmoi` and the repo falls back to `chezmoi.repo` — so the block is only
-needed to pick a different manager or repo.
+The dotfiles stage applies your dotfiles via a selectable manager. The `manager` defaults to
+`chezmoi`, so it's optional; `repo` is required for any manager other than `none`.
 
 ```yaml
-chezmoi:
+dotfiles:
   repo: https://github.com/AdamJHall/dotfiles
-
-# dotfiles:
-#   manager: chezmoi             # chezmoi (default) | yadm | bare-git | none
-#   repo: https://github.com/AdamJHall/dotfiles   # defaults to chezmoi.repo when unset
+  # manager: chezmoi             # chezmoi (default) | yadm | bare-git | none
 ```
 
 | `manager` | What it runs |

config.example.yaml

@@ -237,26 +237,19 @@ kde:
   # wallpaper: /usr/share/wallpapers/Next/contents/images/1920x1080.png
 
 # --- dotfiles ---------------------------------------------------------------
-chezmoi:
-  repo: https://github.com/AdamJHall/dotfiles
-
-# The dotfiles stage (80) supports a selectable manager. When `dotfiles:` is
-# omitted entirely, the manager defaults to `chezmoi` and the repo falls back to
-# `chezmoi.repo` above — so the block below is optional and only needed to pick a
-# different manager or repo.
+# The dotfiles stage (80) applies your dotfiles via a selectable manager. The
+# manager defaults to `chezmoi`, so `manager:` is optional; `repo:` is required
+# for any manager other than `none`.
 #
 #   manager:
 #     chezmoi  (default) — chezmoi init --apply <repo>, or `chezmoi apply` when
 #                          ~/.local/share/chezmoi is already initialized.
 #     yadm               — yadm clone <repo>, or `yadm pull` when already cloned.
 #     bare-git           — classic bare repo at ~/.dotfiles with --work-tree=$HOME.
 #     none               — skip dotfiles entirely (clean no-op).
-#
-#   repo: defaults to chezmoi.repo when unset (backward compatible).
-#
-# dotfiles:
-#   manager: chezmoi
-#   repo: https://github.com/AdamJHall/dotfiles
+dotfiles:
+  repo: https://github.com/AdamJHall/dotfiles
+  # manager: chezmoi
 
 # --- post-dotfiles setup ----------------------------------------------------
 # Runs after the dotfiles stage (stage 85). For things a dotfiles repo references but can't
@@ -274,7 +267,7 @@ chezmoi:
 # We clone oh-my-zsh itself rather than running its installer: the installer
 # refuses to run when ~/.oh-my-zsh exists (not re-runnable) and also tries to
 # chsh/launch zsh — whereas the shell is set by `user.shell` and the .zshrc comes
-# from chezmoi.
+# from your dotfiles repo.
 setup:
   steps:
     # oh-my-zsh itself FIRST — the custom plugins below clone into its tree.