@sebastienrousseau/dotfiles 0.2.500 → 0.2.501

package/docs/archive/PLAN.md

@@ -1,46 +1,59 @@
+---
+render_with_liquid: false
+---
+
 # Universal Configuration Plan (Chezmoi)
 
 ... [Previous Sections Unchanged] ...
 
 # Phase 15: Operational Documentation [COMPLETED]
+
 - [x] **Guide**: Created `OPERATIONS.md`.
 
 # Phase 16: Final Release Verification [COMPLETED]
+
 - [x] **Verification**: All systems passed.
 
 # Phase 17: Structural Optimizations (v0.3.0)
 
 ## Goal
+
 Implement structural improvements for better organization and maintainability, anticipating v0.3.0.
 
 ## Proposed Changes
 
 ### [REFACTOR] Semantic Organization
+
 - **Move**: `dot_config/dotfiles` -> `dot_config/shell`.
 - **Reason**: `dotfiles` is redundant inside a dotfiles repo. `shell` describes the content (aliases, paths, functions).
 - **Update**: Update references in `dot_zshrc.tmpl` and install scripts.
 
 ### [REFACTOR] Script Installation
+
 - **Move**: `bin/` -> `dot_local/bin/`.
 - **Reason**: Ensures scripts are automatically installed to `~/.local/bin` (user PATH).
 
 ### [CLEANUP] Remove Legacy Files
+
 - **Delete**: `Makefile`, `package.json`.
 - **Reason**: Replaced by `chezmoi` and GitHub Actions.
 
 ### [REFACTOR] Script Segregation
+
 - **Split**: `run_onchange_install_packages.sh.tmpl` into:
-    - `run_onchange_darwin_install-packages.sh.tmpl` (Homebrew)
-    - `run_onchange_linux_install-packages.sh.tmpl` (Apt)
-    - `run_onchange_after_install-vim-plug.sh.tmpl` (Universal)
+  - `run_onchange_darwin_install-packages.sh.tmpl` (Homebrew)
+  - `run_onchange_linux_install-packages.sh.tmpl` (Apt)
+  - `run_onchange_after_install-vim-plug.sh.tmpl` (Universal)
 - **Reason**: Improves readability and maintainability.
 
 # Phase 18: Component Documentation Polish [COMPLETED]
 
 ## Goal
+
 Update component documentation (`aliases`, `functions`, `paths`) to match the new `chezmoi` architecture and ensure accuracy.
 
 ## Changes
+
 - **Aliases**: Updated `aliases/README.md` to explain modular `*.aliases.sh` loading.
 - **Functions**: Updated `functions/README.md` to remove legacy install instructions.
 - **Paths**: Updated `paths/README.md` to clarify precedence and `chezmoi` integration.
@@ -49,10 +62,13 @@ Update component documentation (`aliases`, `functions`, `paths`) to match the ne
 # Phase 19: Toolchain Expansion [COMPLETED]
 
 ## Goal
+
 Add comprehensive support for modern DevOps/Cloud engineering tools.
 
 ## Proposed Changes
+
 ### [NEW] Aliases
+
 - **Kubernetes**: `kubectl` shortcuts (`k`), `helm`, `k9s`.
 - **IaC**: `terraform` (`tf`), `opentofu`, `ansible`.
 - **Languages**: `go` (`g`), `yarn`, `uv` (modern Python).
@@ -62,28 +78,36 @@ Add comprehensive support for modern DevOps/Cloud engineering tools.
 # Phase 20: Intelligent Assistance [COMPLETED]
 
 ## Goal
+
 Integrate AI capabilities and improved help systems.
 
 ## Proposed Changes
+
 ### [NEW] Functions
+
 - **`dothelp`**: Index and search all aliases/functions with descriptions.
 - **AI Wrappers**: Aliases for `gh copilot`, `fabric`, or generic LLM CLI tools.
 
 # Phase 22: Automated Testing [COMPLETED]
 
 ## Goal
+
 Verify the dotfiles work on clean Linux environments.
 
 ## Proposed Changes
+
 ### [CI] GitHub Actions
+
 - **Container Job**: Run `chezmoi init --apply` inside a localized Docker container (Ubuntu/Fedora) to prove universal compatibility.
 
 # Phase 23: Enterprise Core & Security (The Trust Layer) [COMPLETED]
 
 ## Goal
+
 Establish a "Trust Layer" for the dotfiles ecosystem, ensuring supply chain security and configuration integrity.
 
 ## Changes
+
 - **SLSA & SBOM**: Implemented `security-release.yml` for provenance and SBOM generation.
 - **Signing**: Created `enable-signing` wizard alias for streamlined GPG/SSH configuration.
 - **Immutability**: Created `lock-configs.sh` script and `lock-configs`/`unlock-configs` aliases.
@@ -93,18 +117,22 @@ Establish a "Trust Layer" for the dotfiles ecosystem, ensuring supply chain secu
 # Phase 27: Self-Healing & Diagnostics [COMPLETED]
 
 ## Goal
+
 Enable the system to self-diagnose and repair configuration drift.
 
 ## Changes
+
 - **Scripts**: Created `scripts/diagnostics/doctor.sh` for system health checks.
 - **Aliases**: Added `dot doctor`, `dot drift` (`chezmoi verify`), and `dot heal` (`chezmoi apply`).
 
 # Phase 51: Regulatory Compliance [COMPLETED]
 
 ## Goal
+
 Document and enforce compliance with SOC2, ISO, and GDPR standards.
 
 ## Changes
+
 - **Documentation**: Created `COMPLIANCE.md` with control mappings.
 - **Privacy**: Added `privacy-mode` alias to disable CLI telemetry.
 - **Audit**: Added `dot audit` alias for tracking changes.
@@ -112,16 +140,20 @@ Document and enforce compliance with SOC2, ISO, and GDPR standards.
 # Phase 54: macOS Deep Integration [COMPLETED]
 
 ## Goal
+
 Harden and optimize the macOS environment via code.
 
 ## Changes
+
 - **Defaults**: Created `run_onchange_darwin_defaults.sh.tmpl` to apply secure/optimized `defaults`.
 - **Hardening**: Enabled screensaver passwords, firewall settings, and disabled guest access.
 
 ## Goal
+
 Ensure legal compliance and proper attribution for the open-source project.
 
 ## Changes
+
 - **Licensing**: Added `scan-licenses` alias (Trivy/FOSSology).
 - **Headers**: Added `add-headers` alias for automated copyright insertion.
 - **Compliance**: Added `check-cla` and `gen-notice` tools.
@@ -129,9 +161,11 @@ Ensure legal compliance and proper attribution for the open-source project.
 # Phase 59: Font Typography [COMPLETED]
 
 ## Goal
+
 Standardize typography and ensure high-quality font rendering across all environments.
 
 ## Proposed Changes
+
 - **Nerd Fonts**: Automate installation of `JetBrainsMono Nerd Font` and `Symbols Nerd Font`.
 - **Fontconfig**: Deploy XML configuration for Linux font rendering (antialiasing, hinting).
 - **Aliases**: `update-fonts` to refresh font caches (`fc-cache`).
@@ -139,9 +173,11 @@ Standardize typography and ensure high-quality font rendering across all environ
 # Phase 26: OS Bundling & Compliance [COMPLETED]
 
 ## Goal
+
 Prepare the dotfiles for system-wide deployment and ensure strict adherence to standards.
 
 ## Proposed Changes
+
 - **XDG Compliance**: Audit `00-default.paths.sh` to ensure all standard XDG variables are exported.
 - **Vendor Hooks**: Update `dot_zshrc.tmpl` to source system-level overrides from `/etc/dotfiles/defaults.d/` (Simulates "site-local" config).
 - **Bundling**: Create `scripts/core/package.sh` to create a distributable tarball and scaffold `.deb`/`.pkg` generation logic.
@@ -149,13 +185,15 @@ Prepare the dotfiles for system-wide deployment and ensure strict adherence to s
 # Phase 24: The Universal Installer (Zero-Dependency) [COMPLETED]
 
 ## Goal
+
 Provide a frictionless, "one-curl" onboarding experience and capabilities to deploy configurations remotely.
 
 ## Proposed Changes
+
 - **install.sh**: A standalone, zero-dependency bash script that:
-    1.  Detects OS/Arch.
-    2.  Installs `chezmoi` (binary or via package manager).
-    3.  Initializes the dotfiles repo.
-    4.  Runs `chezmoi apply`.
-    5.  Uses ANSI colors for a polished "TUI" feel.
+    1. Detects OS/Arch.
+    2. Installs `chezmoi` (binary or via package manager).
+    3. Initializes the dotfiles repo.
+    4. Runs `chezmoi apply`.
+    5. Uses ANSI colors for a polished "TUI" feel.
 - **Teleportation**: `scripts/ops/teleport.sh` using `chezmoi archive` piped to SSH to ephemeralize configs on remote servers (e.g., `dot teleport user@server`).

package/docs/archive/REPO_AUDIT.md

@@ -1,9 +1,15 @@
+---
+render_with_liquid: false
+---
+
 # Repo Audit
 
 ## Source of truth
+
 - `~/.dotfiles` (chezmoi source directory)
 
 ## Key directories
+
 - `.chezmoitemplates/` - templated aliases, functions, paths
 - `dot_config/` - configs mapped into `~/.config`
 - `dot_local/` - binaries and local data (e.g., `dot` CLI)
@@ -12,6 +18,7 @@
 - `nix/` - optional Nix toolchain
 
 ## Notable dependencies
+
 - `chezmoi`
 - `zsh`, `starship`
 - `neovim`
@@ -19,5 +26,6 @@
 - `lazygit`
 
 ## Notes
+
 - Repo-only files excluded via `.chezmoiignore`.
 - Secrets are handled via `age` + `dot secrets` (see `docs/SECRETS.md`).

package/docs/guides/INSTALL.md

@@ -1,3 +1,7 @@
+---
+render_with_liquid: false
+---
+
 # Install
 
 Set up on macOS, Linux, or WSL in 3 to 5 minutes.

package/docs/guides/NEOVIM_IDE_GUIDE.md

@@ -1,6 +1,11 @@
+---
+render_with_liquid: false
+---
+
 # Neovim
 
 ## Modern Core
+
 - **Requirement**: Neovim >= 0.11.2. The config checks this at startup.
 - **Configuration**: Modular, lazy-loaded configuration based on `lazy.nvim`.
 - **Completion**: `blink.cmp` for fast, keystroke-level completion with LSP, snippets, and path sources.
@@ -8,15 +13,18 @@
 - **LSP**: Full LSP support for diagnostics, code actions, and more, managed by `mason.nvim`.
 
 ## Language Support
+
 - **Rust**: Out-of-the-box support with `rustaceanvim`.
 - **Python**: Full support with `basedpyright`, `ruff`, and `venv-selector`.
 - **Web**: Support for web development with `prettier` and `eslint`.
 
 ## AI Integration
+
 - **Copilot**: `copilot.lua` for code completion. Run `:Copilot auth` to sign in.
 - **Copilot Chat**: AI sidebar for asking questions and getting help (`<leader>cc`).
 
 ## VS Code Parity
+
 - **Problem Panel**: `trouble.nvim` for a VS Code-like problems panel (`<leader>xx`).
 - **Search & Replace**: `nvim-spectre` for project-wide search and replace (`<leader>S`).
 - **Auto-Pairs**: Automatically closes brackets and pairs (via `blink.cmp` auto-brackets).
@@ -25,6 +33,7 @@
 - **Snippets**: Native `vim.snippet` engine (Neovim 0.11+).
 
 ## Keybindings
+
 | Key | Action |
 | --- | --- |
 | `<Space>ff` | Find Files |

package/docs/guides/THEMING.md

@@ -1,3 +1,8 @@
+---
+render_with_liquid: false
+---
+{% raw %}
+
 # Theming Guide
 
 The dotfiles ship a wallpaper-driven theme system that generates terminal color palettes directly from wallpaper images using K-Means clustering in CIELAB color space. One command changes the terminal, editor, window manager, GTK, desktop environment, wallpaper, and browser-facing color mode in under a second.
@@ -109,6 +114,7 @@ dot theme rebuild --list   # List discovered wallpapers without rebuilding
 Theme switching is a two-tier system:
 
 **Core (always works)** — ships in the repo, no setup needed:
+
 - Terminal colors (Ghostty, Alacritty, Kitty, WezTerm, tmux)
 - Editor themes (Neovim colorscheme, VS Code)
 - macOS dark/light mode and accent color
@@ -116,6 +122,7 @@ Theme switching is a two-tier system:
 - Browser color mode (Safari, Chrome, Firefox)
 
 **Wallpapers (optional)** — user-provided, enhances the theme:
+
 - Desktop wallpaper matched to the active theme
 - Requires `~/Pictures/Wallpapers/` with files named `macos-NAME-dark.heic`
 
@@ -220,3 +227,4 @@ grep '^theme = ' ~/.dotfiles/.chezmoidata.toml
 ```
 
 This prints the current theme name. Cross-reference with `dot theme list` for available options.
+{% endraw %}

package/docs/guides/TROUBLESHOOTING.md

@@ -1,3 +1,7 @@
+---
+render_with_liquid: false
+---
+
 # Troubleshooting
 
 Quick checks for common issues.
@@ -5,17 +9,20 @@ Quick checks for common issues.
 ## Install and update
 
 **Problem:** Install script fails immediately
+
 - Verify that `git` and `curl` are installed.
 - Check internet connectivity.
 - Try running with verbose output: `bash -x install.sh`
 
 **Problem:** Chezmoi apply fails
+
 - Re-run `chezmoi apply` to re-sync state.
 - Check for merge conflicts: `chezmoi diff`
 - If hooks fail, check `~/.local/share/dotfiles.log` for details.
 - For non-interactive sessions, force apply to avoid TTY prompts: `DOTFILES_NONINTERACTIVE=1 dot apply --force`
 
 **Problem:** Packages fail to install
+
 - macOS: Verify Homebrew is installed and up to date (`brew update`)
 - Linux: Run `sudo apt-get update` first
 - Verify you have sufficient permissions
@@ -23,22 +30,26 @@ Quick checks for common issues.
 ## Shell startup
 
 **Problem:** Shell is slow to start
+
 - Run `dot benchmark` to measure startup time
 - Profile with `zsh -x` to trace startup
 - Check for slow plugins or large history files
 
 **Problem:** Aliases or functions not available
+
 - Run `chezmoi apply` to regenerate config files
 - Source your shell config: `source ~/.zshrc`
 - Verify the relevant tool is installed
 
 **Problem:** `dot doctor` prints a directory listing instead of diagnostics
+
 - This usually means `dot` was shadowed by a navigation alias in the current shell session.
 - Check resolution: `type -a dot`
 - Fix current session: `unalias dot 2>/dev/null || true && exec zsh`
 - Validate after reload: `dot doctor`
 
 **Problem:** Zsh reports it cannot write `.zwc` files
+
 - Cause: stale read-only zsh cache files after an upgrade.
 - Remove stale caches:
   - `find ~/.config/shell ~/.config/zsh -type f -name '*.zwc' -delete`
@@ -46,6 +57,7 @@ Quick checks for common issues.
 - Re-run health checks: `dot doctor`
 
 **Problem:** Shell crashes on startup
+
 - Temporarily move `~/.zshrc` and retry to isolate the fault
 - Check for syntax errors: `zsh -n ~/.zshrc`
 - Review recent changes: `chezmoi diff`
@@ -53,22 +65,26 @@ Quick checks for common issues.
 ## Secrets and encryption
 
 **Problem:** Encrypted files fail to decrypt
+
 - Confirm `~/.config/chezmoi/key.txt` exists.
 - Verify the key matches the one used for encryption.
 - Re-initialize with `dot secrets-init` if needed.
 
 **Problem:** Age encryption not working
+
 - Verify `age` is installed: `command -v age`
 - Check key permissions: `ls -la ~/.config/chezmoi/key.txt` (should be 600)
 
 ## Neovim
 
 **Problem:** Plugins fail to load
+
 - Run `:checkhealth` in Neovim
 - Update plugins: `:Lazy sync`
 - Check for missing dependencies (node, python, etc.)
 
 **Problem:** LSP not working
+
 - Install required language servers
 - Check `:LspInfo` for status
 - Review `:LspLog` for errors
@@ -76,21 +92,25 @@ Quick checks for common issues.
 ## Git
 
 **Problem:** Git aliases not working
+
 - Check if Git config is applied: `git config --list`
 - Re-apply dotfiles: `chezmoi apply`
 
 **Problem:** Delta (diff pager) not showing colors
+
 - Verify `delta` is installed
 - Confirm your terminal supports 256 colors
 
 ## Kubernetes tools
 
 **Problem:** kubectl context issues
+
 - List contexts: `kubectl config get-contexts`
 - Switch context: `kubectx <context-name>`
 - Check kubeconfig: `echo $KUBECONFIG`
 
 **Problem:** Minikube won't start
+
 - Verify Docker is running
 - Try: `minikube delete && minikube start`
 - Check logs: `minikube logs`
@@ -98,6 +118,7 @@ Quick checks for common issues.
 ## Performance
 
 **Problem:** High memory usage
+
 - Look for runaway processes: `htop` or `btop`
 - Review shell history size in atuin config
 - Disable unused plugins
@@ -105,21 +126,26 @@ Quick checks for common issues.
 ## Common infrastructure failures
 
 **Problem:** Nix isn't installed or commands not found
+
 - Ensure you have followed the installation guide: `curl -L https://nixos.org/nix/install | sh`
 - On Linux, you might need to enable experimental features in `~/.config/nix/nix.conf`:
   `experimental-features = nix-command flakes`
 - Verify the daemon is running: `ps aux | grep nix-daemon`
 
 **Problem:** Systemd isn't available (mostly WSL2)
+
 - Dotfiles functions that rely on systemd (like `pueue` management) will fallback to direct execution.
 - To enable systemd in WSL2, add this to `/etc/wsl.conf` (requires Windows 11 or latest WSL):
+
   ```ini
   [boot]
   systemd=true
   ```
+
 - Restart WSL: `wsl.exe --shutdown`
 
 **Problem:** GPG or SSH signing fails
+
 - Check if your key is present: `gpg --list-secret-keys` or `ssh-add -l`
 - Ensure `GPG_TTY` is set (dotfiles does this automatically in `rc.d`).
 - For hardware keys (Yubikey), ensure `pcscd` is running on Linux.
@@ -132,6 +158,7 @@ For complex WSL2 edge cases, Nix integration problems, and recovery procedures,
 **[WSL2 & Nix Troubleshooting Guide](WSL2_NIX_TROUBLESHOOTING.md)**
 
 This guide covers:
+
 - WSL2 filesystem and networking edge cases
 - Nix installation and flake management issues
 - Complete system recovery procedures
@@ -141,6 +168,7 @@ This guide covers:
 ## Still stuck
 
 Open an issue with:
+
 - OS + version
 - Output of `dot doctor` (if available)
 - Relevant log snippets from `~/.local/share/dotfiles.log`