@sebastienrousseau/dotfiles 0.2.520 → 0.2.521

package/docs/manual/03-reference/05-feature-flags.md

@@ -1,187 +0,0 @@
----
-render_with_liquid: false
----
-{% raw %}
-
-# Reference: Feature Flags
-
-Feature flags toggle optional subsystems. Set in `.chezmoidata.toml`, override per-preset in `.chezmoidata/hardware.toml`.
-
-## Global Flags (`.chezmoidata.toml`)
-
-```toml
-[features]
-alias_wrapper = false      # Wrap selected aliases with safer defaults
-dms           = true       # Dank Material Shell (Niri desktop)
-zellij        = false      # Zellij terminal multiplexer config
-linux_desktop = false      # Linux-specific desktop configs
-niri          = false      # Niri window manager
-waybar        = false      # Waybar status bar
-fuzzel        = false      # Fuzzel application launcher (Wayland)
-mako          = false      # Mako notification daemon (Wayland)
-foot          = false      # Foot terminal emulator (Wayland)
-kanshi        = false      # Kanshi monitor profile manager (Wayland)
-touch         = false      # Touchscreen-friendly tweaks (Surface, etc.)
-t2            = false      # Apple T2 hardware-specific tweaks
-surface       = false      # Microsoft Surface hardware-specific tweaks
-```
-
-## Per-Preset Overrides (`.chezmoidata/hardware.toml`)
-
-```toml
-[hardware.surface-pro.features]
-niri = true
-waybar = true
-dms = true                 # overrides .chezmoidata.toml default
-```
-
-The effective value is `mergeOverwrite` of global + preset features.
-
-## Flag Catalogue
-
-### `dms` — Dank Material Shell
-
-When `true`:
-
-- Configures DMS IPC for theme sync
-- Enables Quickshell templates
-- Sets up per-monitor wallpaper via `dms ipc wallpaper`
-
-Requires: Niri + Quickshell + DMS installed.
-
-### `linux_desktop` — Linux Desktop Configs
-
-When `true`:
-
-- Enables GTK 3/4 theme generation from `themes.toml`
-- Configures `gsettings color-scheme` behaviour
-- Generates desktop file entries for installed tools
-
-No effect on macOS.
-
-### `niri` — Niri Window Manager
-
-When `true`:
-
-- Generates `~/.config/niri/config.kdl`
-- Enables Niri keybindings from `keybinds.toml`
-- Configures workspace rules per preset
-
-Requires: Niri installed.
-
-### `waybar` — Waybar Status Bar
-
-When `true`:
-
-- Generates `~/.config/waybar/config.jsonc` + `style.css`
-- Hooks into theme switching via `dot-theme-sync`
-
-Requires: Waybar installed.
-
-### `alias_wrapper` — Safer Alias Defaults
-
-When `true`, opt-in wrappers replace selected aliases with confirmation-prompt
-variants (e.g., `rm -i`, `mv -i`). Default `false` for power-user ergonomics.
-
-### `zellij` — Zellij Terminal Multiplexer
-
-When `true`:
-
-- Generates `~/.config/zellij/config.kdl` from the active theme
-- Wires the `dot mux` alias to launch a profile-aware session
-
-Requires: Zellij installed.
-
-### `fuzzel` — Fuzzel Application Launcher (Wayland)
-
-When `true`, generates `~/.config/fuzzel/fuzzel.ini` using the active theme.
-Requires: Fuzzel installed (Wayland-only). No effect on macOS.
-
-### `mako` — Mako Notification Daemon (Wayland)
-
-When `true`, generates `~/.config/mako/config` with theme-derived colors.
-Requires: Mako installed (Wayland-only). No effect on macOS.
-
-### `foot` — Foot Terminal Emulator (Wayland)
-
-When `true`, generates `~/.config/foot/foot.ini` from `themes.toml`.
-Requires: Foot installed (Wayland-only). No effect on macOS.
-
-### `kanshi` — Kanshi Monitor Profile Manager (Wayland)
-
-When `true`, generates `~/.config/kanshi/config` with per-host monitor layouts.
-Requires: Kanshi installed (Wayland-only). No effect on macOS.
-
-### `touch` — Touchscreen-Friendly Tweaks
-
-When `true`, enables larger UI scaling and touch-friendly input mappings.
-Typically combined with `surface` for Microsoft Surface devices.
-
-### `t2` — Apple T2 Hardware Tweaks
-
-When `true`, enables `t2linux` kernel-module hints, audio routing fixes, and
-Touch-Bar utilities for Intel Macs with the T2 chip on Linux. Set by the
-`macbook-t2` hardware preset in `.chezmoidata/hardware.toml`.
-
-### `surface` — Microsoft Surface Hardware Tweaks
-
-When `true`, enables `linux-surface` kernel parameters, touchpad gestures, and
-pen-input mappings. Set by the `surface-pro` hardware preset.
-
-## Using a Flag in a Template
-
-```go
-{{- $hw := index .hardware .machine }}
-{{- $f := mergeOverwrite .features $hw.features }}
-
-{{ if $f.niri }}
-# Niri-specific config
-{{ end }}
-```
-
-## Checking Active Flags
-
-```sh
-chezmoi execute-template '{{- $hw := index .hardware .machine -}}{{- $f := mergeOverwrite .features $hw.features -}}{{ $f | toToml }}'
-```
-
-## Adding a New Flag
-
-1. Add to `.chezmoidata.toml`:
-
-   ```toml
-   [features]
-   my_new_flag = false
-   ```
-
-2. (Optional) Set per preset:
-
-   ```toml
-   [hardware.macbook-t2.features]
-   my_new_flag = true
-   ```
-
-3. Use in templates:
-
-   ```go
-   {{ if $f.my_new_flag }}
-   # conditional config
-   {{ end }}
-   ```
-
-4. Document here with the flag's purpose and requirements
-
-## Flag Deprecation
-
-Flags can be deprecated without breaking existing hosts. The deprecation process:
-
-1. Mark the flag as deprecated in this document
-2. Leave the flag evaluation in place for one release
-3. In the subsequent release, remove the template branches and the flag definition
-4. Users who had the flag set will see it ignored — no errors
-
-## See Also
-
-- [Configuration Files](02-config-files.md)
-- [Create a Profile](../02-tutorials/03-create-profile.md)
-{% endraw %}

package/docs/manual/04-cookbook/01-recipes.md

@@ -1,285 +0,0 @@
----
-render_with_liquid: false
----
-
-# Cookbook: Recipes
-
-Thirty short recipes for common tasks.
-
-## Installation & Update
-
-### 1. Install on a fresh machine
-
-```sh
-bash -c "$(curl -fsSL https://raw.githubusercontent.com/sebastienrousseau/dotfiles/main/install.sh)"
-```
-
-### 2. Update everything
-
-```sh
-dot upgrade
-```
-
-### 3. Update dotfiles only (no tools)
-
-```sh
-dot update
-```
-
-### 4. Preview what would change
-
-```sh
-dot apply --dry-run
-```
-
-## Themes
-
-### 5. Switch to a specific theme
-
-```sh
-dot theme tahoe-dark
-```
-
-### 6. Toggle between dark and light
-
-```sh
-dot theme toggle
-```
-
-### 7. Open the interactive theme picker
-
-```sh
-dot theme
-```
-
-### 8. List paired wallpaper themes
-
-```sh
-dot theme list
-```
-
-### 9. Add a new wallpaper-driven theme
-
-```sh
-cp my-wallpaper.jpg ~/Pictures/Wallpapers/myname-dark.jpg
-cp my-wallpaper-light.jpg ~/Pictures/Wallpapers/myname-light.jpg
-bash scripts/theme/merge-wallpaper.sh myname
-dot theme rebuild
-dot theme myname-dark
-```
-
-### 10. Regenerate all themes from scratch
-
-```sh
-dot theme rebuild --force
-```
-
-## Configuration
-
-### 11. Edit the source directory
-
-```sh
-dot edit
-```
-
-### 12. Add a new config file to chezmoi
-
-```sh
-dot add ~/.some-config-file
-```
-
-### 13. Remove a managed file
-
-```sh
-dot remove ~/.some-config-file
-```
-
-### 14. Show configuration drift
-
-```sh
-dot status
-```
-
-### 15. Show diff against source
-
-```sh
-dot diff
-```
-
-## Secrets
-
-### 16. Encrypt a new secret file
-
-```sh
-chezmoi add --encrypt ~/some-secret.txt
-```
-
-### 17. Edit an encrypted file
-
-```sh
-sops dot_config/credentials.sops.yaml
-# or
-chezmoi edit ~/some-secret.txt.age
-```
-
-### 18. Rotate your Age key
-
-```sh
-age-keygen -o ~/.config/age/keys.txt.new
-# Update .sops.yaml with new public key
-# Then:
-find . -name '*.sops.yaml' -exec sops updatekeys {} \;
-git commit -sS -am "chore(secrets): rotate age key"
-```
-
-### 19. Check for accidental secret leaks
-
-```sh
-dot verify --security
-```
-
-## Diagnostics
-
-### 20. Quick health check
-
-```sh
-dot doctor
-```
-
-### 21. Auto-fix common issues
-
-```sh
-dot heal
-```
-
-### 22. Check startup performance
-
-```sh
-dot benchmark
-```
-
-### 23. See the health score
-
-```sh
-dot score
-```
-
-### 24. Recent metrics
-
-```sh
-dot metrics
-```
-
-## Fleet
-
-### 25. Attest across all fleet hosts
-
-```sh
-dot fleet attest
-```
-
-### 26. Sync dotfiles to every fleet host
-
-```sh
-dot fleet sync
-```
-
-### 27. Diff config across hosts
-
-```sh
-dot fleet diff
-```
-
-## AI & Agents
-
-### 28. Show installed AI tools
-
-```sh
-dot ai
-```
-
-### 29. Switch agent profile
-
-```sh
-dot mode architect   # or hardener, refactor
-```
-
-### 30. Verify MCP policy
-
-```sh
-dot mcp --strict
-```
-
-## Recovery
-
-### 31. Rollback the last apply
-
-```sh
-dot rollback
-```
-
-### 32. Create an offline bundle
-
-```sh
-dot bundle
-```
-
-### 33. Restore from a bundle
-
-```sh
-dot bundle restore ~/Downloads/dotfiles-bundle-*.tar.zst
-```
-
-## Development
-
-### 34. Run a test locally
-
-```sh
-bash tests/unit/theme/test_themes_toml.sh
-```
-
-### 35. Run all tests
-
-```sh
-./tests/framework/test_runner.sh
-```
-
-### 36. Lint shell scripts
-
-```sh
-dot lint
-```
-
-### 37. Simulate chaos to test self-healing
-
-```sh
-dot chaos symlink   # in an ephemeral container only
-dot heal
-dot doctor
-```
-
-## Manual
-
-### 38. Open the manual in a browser
-
-```sh
-dot manual
-```
-
-### 39. Download the PDF
-
-```sh
-dot manual pdf
-```
-
-### 40. Read the manual in a terminal
-
-```sh
-dot manual text | less
-```
-
-## See Also
-
-- [Troubleshooting](02-troubleshooting.md)
-- [FAQ](03-faq.md)
-- [CLI Reference](../03-reference/01-dot-cli.md)