@sebastienrousseau/dotfiles 0.2.481 → 0.2.499

package/docs/FONTS.md

@@ -1,147 +0,0 @@
-# Font configuration
-
-Learn about font setup, rendering, and the fonts included with these dotfiles.
-
-## Recommended fonts
-
-### Primary: JetBrains Mono Nerd Font
-
-Your default font is JetBrains Mono with Nerd Font patches.
-
-Features:
-- Designed for code readability
-- Ligature support
-- Powerline/Nerd Font glyphs
-- Clear distinction between similar characters (0/O, 1/l/I)
-
-### Alternatives
-
-| Font | Style | Best for |
-|------|-------|----------|
-| Fira Code | Modern | People who enjoy ligatures |
-| Cascadia Code | Microsoft | People who use VS Code |
-| Hack | Classic | People who prefer a classic look |
-| Source Code Pro | Adobe | Clean aesthetic |
-| Iosevka | Narrow | Small screens |
-
-## Installation
-
-### macOS (Homebrew)
-
-```bash
-# Install via Homebrew
-brew tap homebrew/cask-fonts
-brew install --cask font-jetbrains-mono-nerd-font
-
-# Or use dot CLI
-dot fonts install
-```
-
-### Linux (manual)
-
-```bash
-# Download from Nerd Fonts
-wget https://github.com/ryanoasis/nerd-fonts/releases/download/v3.4.0/JetBrainsMono.zip
-
-# Extract to fonts directory
-unzip JetBrainsMono.zip -d ~/.local/share/fonts/
-
-# Update font cache
-fc-cache -fv
-```
-
-### Using the font patcher
-
-To patch your own fonts with Nerd Font glyphs:
-
-```bash
-# Use the included script
-~/.dotfiles/scripts/fonts/patch-fonts.sh /path/to/font.ttf
-```
-
-## Font rendering
-
-### Sample characters
-
-```
-ABCDEFGHIJKLMNOPQRSTUVWXYZ
-abcdefghijklmnopqrstuvwxyz
-0123456789
-!@#$%^&*()_+-=[]{}|;':",.<>?/
-
-Ligatures: -> => == != <= >= && || :: ...
-Powerline:
-Nerd Font:
-```
-
-### Ambiguous characters
-
-The font configuration provides clear distinction between:
-
-```
-0 vs O (zero vs capital O)
-1 vs l vs I (one vs lowercase L vs capital I)
-` vs ' (backtick vs single quote)
-" vs " (straight vs curly quotes)
-```
-
-## Terminal configuration
-
-### Ghostty
-
-```
-font-family = JetBrains Mono Nerd Font
-font-size = 14
-```
-
-### WezTerm
-
-```lua
-config.font = wezterm.font("JetBrains Mono Nerd Font")
-config.font_size = 14.0
-```
-
-### Alacritty
-
-```yaml
-font:
-  normal:
-    family: JetBrains Mono Nerd Font
-  size: 14.0
-```
-
-### Kitty
-
-```
-font_family JetBrains Mono Nerd Font
-font_size 14.0
-```
-
-## Font size recommendations
-
-| Display | Size |
-|---------|------|
-| 13" laptop | 12-13pt |
-| 15" laptop | 13-14pt |
-| 24" monitor | 14-15pt |
-| 27" 4K monitor | 15-16pt |
-
-## Troubleshooting
-
-### Fonts not displaying correctly
-
-1. Verify font is installed: `fc-list | grep JetBrains`
-2. Restart terminal application
-3. Check terminal font settings
-
-### Nerd Font icons missing
-
-1. Verify you are using a Nerd Font variant
-2. Confirm the terminal supports the Unicode range
-3. Try a different Nerd Font
-
-### Ligatures not working
-
-1. Enable ligatures in terminal settings
-2. Some terminals do not support ligatures (for example, Terminal.app)
-3. Try Ghostty, WezTerm, or Kitty

package/docs/INSTALL.md

@@ -1,119 +0,0 @@
-# Get started
-
-This guide covers supported platforms, prerequisites, and the standard install path.
-
-## Supported platforms
-
-- macOS (Homebrew)
-- Ubuntu/Debian (apt)
-- WSL2 (Ubuntu/Debian)
-
-## Prerequisites
-
-Required:
-- `git`
-- `curl`
-
-Optional (feature-dependent):
-- Homebrew (macOS)
-- `apt-get` (Linux)
-- Docker or Podman (sandbox)
-- Nix (optional toolchain)
-- gum (required for `dot learn`)
-
-## Install
-
-### One-liner (recommended)
-
-```bash
-sh -c "$(curl -fsSL https://raw.githubusercontent.com/sebastienrousseau/dotfiles/v0.2.480/install.sh)"
-exec zsh
-```
-
-### Manual installation
-
-```bash
-# Clone the repository
-git clone https://github.com/sebastienrousseau/dotfiles.git ~/.dotfiles
-
-# Install chezmoi and apply
-sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply sebastienrousseau/dotfiles
-
-# Restart shell
-exec zsh
-```
-
-### Using Nix (alternative)
-
-If you have Nix with flakes enabled:
-
-```bash
-# Enter development shell with all tools
-nix develop ~/.dotfiles/nix
-
-# Or install the dot-utils meta-package
-nix profile install ~/.dotfiles/nix#dot-utils
-```
-
-## What happens
-
-1. The installer downloads a pinned Chezmoi bootstrap and applies this repo.
-2. Chezmoi hooks install OS packages, fonts, and optional apps.
-3. The `dot` CLI becomes available in `~/.local/bin`.
-4. Chezmoi symlinks shell configuration to your home directory.
-
-## Post-install verification
-
-```bash
-# Check dot CLI is available
-dot --version
-
-# Run health checks
-dot doctor
-
-# View available commands
-dot help
-```
-
-## Optional: gum
-
-`gum` is required for interactive features like `dot learn`.
-
-macOS:
-```bash
-brew install gum
-```
-
-Linux (snap):
-```bash
-sudo snap install gum --classic
-```
-
-Linux (Go toolchain):
-```bash
-go install github.com/charmbracelet/gum@latest
-```
-
-## Update
-
-```bash
-dot update
-```
-
-## Uninstall
-
-```bash
-# Remove chezmoi-managed files
-chezmoi purge
-
-# Remove the dotfiles repository
-rm -rf ~/.dotfiles
-
-# Remove local data
-rm -rf ~/.local/share/chezmoi
-rm -rf ~/.local/share/dotfiles.log
-```
-
-## Troubleshooting
-
-If install hooks fail, check `~/.local/share/dotfiles.log` and review `docs/TROUBLESHOOTING.md`.

package/docs/KEYS.md

@@ -1,40 +0,0 @@
-# Keybindings
-
-This is the single source of truth for navigation and muscle-memory shortcuts
-across the dotfiles stack. Keep this concise and consistent.
-
-## Zsh
-- Ctrl+R: History search (fzf/atuin if enabled)
-- Ctrl+P / Ctrl+N: History prefix search (up/down)
-
-## Tmux (prefix = `Ctrl-a`)
-- Prefix + r: Reload config
-- Prefix + N: New window
-- Prefix + a / Tab: Last window
-- Prefix + %: Split vertical (current path)
-- Prefix + ": Split horizontal (current path)
-- Prefix + \\: Split vertical (alt)
-- Prefix + |: Split horizontal (alt)
-- Prefix + h/j/k/l: Move between panes (vim-style)
-- Prefix + z: Toggle zoom pane
-- Prefix + H/J/K/L: Resize pane (left/down/up/right)
-
-## Neovim (leader = `Space`)
-- Ctrl-h/j/k/l: Move between splits
-- Ctrl-s: Save file
-- Leader + ff: Find files (Telescope)
-- Leader + fg: Live grep (Telescope)
-- Leader + q: Quit
-
-## Shell Tools
-- z <dir>: Jump to a directory (zoxide)
-- lg: Open lazygit
-
-## Terminal
-- Ctrl+Shift+C: Copy
-- Ctrl+Shift+V: Paste
-
----
-
-Update this file when bindings change. If you add a new tool, add its shortcuts
-here and keep them aligned with the global conventions.

package/docs/KEY_ROTATION.md

@@ -1,219 +0,0 @@
-# Key Rotation Guide
-
-This guide covers rotating encryption keys for secrets managed by Age and SOPS.
-
-## Age Key Rotation
-
-### When to Rotate
-
-- **Annually**: As a preventive measure
-- **After compromise**: If you suspect key exposure
-- **Personnel change**: When team members leave
-- **Device loss**: If a device with the key is lost/stolen
-
-### Rotation Procedure
-
-#### 1. Generate New Key
-
-```bash
-# Create new age key
-age-keygen -o ~/.config/chezmoi/key-new.txt
-
-# Note the public key (starts with "age1...")
-cat ~/.config/chezmoi/key-new.txt | grep "public key"
-```
-
-#### 2. Re-encrypt All Secrets
-
-```bash
-# List all encrypted files
-chezmoi managed --include=encrypted
-
-# For each encrypted file, decrypt with old key and re-encrypt with new
-for file in $(chezmoi managed --include=encrypted); do
-  # Decrypt with old key
-  chezmoi cat "$file" > "/tmp/$(basename $file).dec"
-
-  # Re-encrypt with new key (update chezmoi config first)
-  # See step 3
-done
-```
-
-#### 3. Update Chezmoi Configuration
-
-Edit `~/.config/chezmoi/chezmoi.toml`:
-
-```toml
-[age]
-  identity = "~/.config/chezmoi/key-new.txt"
-  recipient = "age1your_new_public_key_here"
-```
-
-#### 4. Re-add Encrypted Files
-
-```bash
-# Re-add each secret with new encryption
-chezmoi add --encrypt ~/.ssh/id_ed25519
-chezmoi add --encrypt ~/.config/secrets/api-keys.env
-```
-
-#### 5. Verify and Clean Up
-
-```bash
-# Verify decryption works
-chezmoi cat ~/.ssh/id_ed25519
-
-# Archive old key (store securely offline)
-mv ~/.config/chezmoi/key.txt ~/.config/chezmoi/key-$(date +%Y%m%d)-archived.txt
-
-# Rename new key
-mv ~/.config/chezmoi/key-new.txt ~/.config/chezmoi/key.txt
-
-# Commit changes
-cd ~/.dotfiles
-git add -A
-git commit -m "chore(secrets): rotate age encryption key"
-```
-
-### Emergency Rotation (Compromised Key)
-
-```bash
-# 1. Immediately generate new key
-age-keygen -o ~/.config/chezmoi/key-emergency.txt
-
-# 2. Re-encrypt ALL secrets (prioritize most sensitive)
-# 3. Revoke/rotate any API keys, tokens that were encrypted
-# 4. Update any shared secrets with team members
-# 5. Document the incident
-```
-
----
-
-## SOPS Key Rotation
-
-### Overview
-
-SOPS supports multiple key types. This covers Age keys (recommended) and GPG keys.
-
-### SOPS with Age Keys
-
-#### Generate New Key
-
-```bash
-age-keygen -o ~/.config/sops/age/keys-new.txt
-```
-
-#### Update .sops.yaml
-
-```yaml
-creation_rules:
-  - path_regex: \.env$
-    age: >-
-      age1new_key_here,
-      age1old_key_here  # Keep old key temporarily for decryption
-```
-
-#### Re-encrypt Files
-
-```bash
-# Rotate key for a single file
-sops updatekeys secrets.env
-
-# Or re-encrypt entirely
-sops -d secrets.env | sops -e /dev/stdin > secrets.env.new
-mv secrets.env.new secrets.env
-```
-
-#### Remove Old Key
-
-After confirming all files are re-encrypted:
-
-1. Remove old key from `.sops.yaml`
-2. Archive old key securely
-3. Commit changes
-
-### SOPS with GPG Keys
-
-```bash
-# Generate new GPG key
-gpg --full-generate-key
-
-# Export fingerprint
-gpg --list-keys --keyid-format LONG
-
-# Update .sops.yaml with new fingerprint
-# Re-encrypt files
-sops updatekeys <file>
-```
-
----
-
-## Automation Scripts
-
-### Check Key Age
-
-```bash
-#!/usr/bin/env bash
-# check-key-age.sh - Alert if keys are older than 365 days
-
-KEY_FILE="${HOME}/.config/chezmoi/key.txt"
-MAX_AGE_DAYS=365
-
-if [[ -f "$KEY_FILE" ]]; then
-  key_age=$(( ($(date +%s) - $(stat -c %Y "$KEY_FILE")) / 86400 ))
-
-  if [[ $key_age -gt $MAX_AGE_DAYS ]]; then
-    echo "⚠️  Age key is ${key_age} days old. Consider rotation."
-    exit 1
-  else
-    echo "✓ Age key is ${key_age} days old (limit: ${MAX_AGE_DAYS})"
-  fi
-fi
-```
-
-### Automated Backup Before Rotation
-
-```bash
-#!/usr/bin/env bash
-# backup-before-rotation.sh
-
-BACKUP_DIR="${HOME}/.local/share/dotfiles/key-backups"
-mkdir -p "$BACKUP_DIR"
-
-# Backup current key
-cp ~/.config/chezmoi/key.txt "$BACKUP_DIR/key-$(date +%Y%m%d_%H%M%S).txt"
-
-# Encrypt backup with passphrase
-gpg --symmetric --cipher-algo AES256 "$BACKUP_DIR/key-$(date +%Y%m%d_%H%M%S).txt"
-
-# Remove unencrypted backup
-rm "$BACKUP_DIR/key-$(date +%Y%m%d_%H%M%S).txt"
-
-echo "Key backed up to $BACKUP_DIR (encrypted)"
-```
-
----
-
-## Best Practices
-
-1. **Never commit unencrypted keys** - Use `.gitignore` properly
-2. **Store backups offline** - USB drive in secure location
-3. **Use hardware keys when possible** - YubiKey with age-plugin-yubikey
-4. **Document rotation dates** - Keep a log of when keys were rotated
-5. **Test decryption** - Always verify after rotation
-6. **Notify team members** - If using shared secrets
-
-## Recovery Procedures
-
-If you lose access to your key:
-
-1. **Check backups** - Offline storage, password manager
-2. **Check other machines** - Key may exist on another device
-3. **Re-create secrets** - As last resort, regenerate API keys, tokens, etc.
-
-## Related Documentation
-
-- [SECRETS.md](SECRETS.md) - Secrets management overview
-- [SECURITY.md](SECURITY.md) - Security hardening guide
-- [Age documentation](https://github.com/FiloSottile/age)
-- [SOPS documentation](https://github.com/getsops/sops)

package/docs/LEGACY_ROADMAP.md

@@ -1,142 +0,0 @@
-# The Ultimate Developer Environment Roadmap
-
-This roadmap outlines the path to a high-performance, super-efficient development machine designed for Rust, Python, and AI on Linux (Zorin OS / T2 Mac hardware).
-
-## Phase 1: Foundation (Completed)
-- **Core Shell**: Zsh + Oh My Zsh.
-- **Modern Prompt**: Starship (hooked & active).
-- **Language Managers**: `rustup` (Rust) and `fnm` (Node.js).
-- **Ultra-Fast Python**: `uv` installed.
-- **Basic Modern Tools**: `eza` (ls), `bat` (cat), `fd` (find), `ripgrep` (grep).
-- **Git Enhancements**: `lazygit` (TUI) and `delta` (Diffs).
-- **Multiplexer**: `zellij` installed.
-- **AI**: `ollama` installed locally.
-- **Security**: Firewall (`ufw`) enabled.
-
----
-
-## Phase 2: Speed & Navigation (Completed)
-Focus: Reduce friction in filesystem navigation and build times.
-
-### 1. Navigation
-- [x] **Zoxide**: Smarter `cd` command that learns your habits (`z directory`).
-- [x] **FZF**: Command-line fuzzy finder. Essential for search history, files, and replacing standard completion.
-- [x] **Yazi**: Blazing fast terminal file manager (Rust-based).
-
-### 2. Rust Optimization
-- [x] **Mold**: Use the `mold` linker to speed up Rust compile times by 3x-10x.
-- [x] **Sccache**: Shared compilation cache to speed up recompilations across projects.
-- [x] **Bacon**: Background rust compiler that gives instant feedback on errors.
-
-### 3. Python Optimization
-- [x] **Ruff**: Extremely fast Python linter and formatter (replace flake8/black).
-- [x] **Global Config**: Set `uv` to use system Python or managed Python preferences.
-
-### 4. Code Search
-- [x] **Ripgrep-all (rga)**: Search inside PDFs, E-Books, zip files, etc.
-
----
-
-## Phase 3: AI Power User (Completed)
-Focus: Integrate AI deeply into the workflow.
-
-- [x] **Fabric**: Open-source framework for augmenting humans using AI (installed via `cmd` path).
-- [x] **Open WebUI**: A beautiful web interface for `ollama` (requires Docker).
-- [x] **GitHub Copilot CLI**: Integrate AI assistance directly into the terminal commands.
-- [x] **Local RAG**: Setup tools to chat with your own documents locally (Open WebUI).
-
----
-
-## Phase 4: System Tuning & Hardening (Completed)
-Focus: Squeeze every ounce of performance and security from the hardware.
-
-- [x] **Kernel Tuning**: Increase file descriptor limits and optimize TCP stack for lower latency.
-- [x] **Swap Optimization**: Configure `zram` for memory compression (improves performance on 16GB RAM).
-- [x] **Flatpak Overrides**: Secure Flatpak permissions using `Flatseal`.
-- [x] **Automated Updates**: Configure `unattended-upgrades` for security patches.
-
----
-
-## Phase 5: Final Polish (Completed)
-- [x] **Global UV Config**: Created `~/.config/uv/uv.toml` for managed python perference.
-- [x] **Roadmap Completion**: Verified all items are 100% complete.
-
----
-
-## Maintenance & Updates
-- **Update System**: `sudo apt update && sudo apt upgrade`
-- **Update Rust**: `rustup update`
-- **Update Node**: `fnm install --lts`
-- **Update UV**: `uv self update`
-- **Update Firmware**: `fwupdmgr get-updates`
-
----
-
-## Phase 6: Desktop Environment (Completed)
-Focus: Clean, bloat-free, and supercharged GNOME/Zorin experience.
-
-- [x] **Bloatware Removal**: Removed games (`aisleriot`, `mines`, etc.) and media apps (`rhythmbox`, `totem`).
-- [x] **Menu Cleanup**: Created `hide_menu_entries.sh` to deduplicate and hide unwanted entries.
-- [x] **GNOME Extensions**: Installed productivity boosters via `gnome-extensions-cli`:
-    - [x] `Clipboard Indicator`: History management.
-    - [x] `Caffeine`: Prevent auto-suspend.
-    - [x] `Impatience`: Speed up animations.
-    - [x] `Vitals`: System monitoring in top bar.
-- [x] **Memory Tuning**: Optimize GNOME Shell performance.
-
----
-
-## Phase 7: Browser Optimization (Completed)
-Focus: Chrome tuned for development and memory efficiency.
-
-- [x] **Settings**: Enable "Memory Saver" and "Energy Saver" via Managed Policies.
-- [x] **Extensions**: Automated installation of developer stack (uBlock, JSON Viewer, React DevTools, Vimium, Refined GitHub).
-- [x] **Profile Separation**: Separate Personal and Work profiles (Manual setup recommendation).
-
----
-
-## Phase 8: Neovim IDE (Completed)
-Focus: Building a terminal-based IDE that rivals VS Code for Rust, Python, and AI.
-
-- [x] **Latest Version**: Installed Neovim v0.12.0-dev (Nightly) to resolve plugin stability issues.
-- [x] **Plugin Manager**: Setup `lazy.nvim` with modular config (Restored from **PR #62**).
-- [x] **Core Plugins**:
-    - [x] `Telescope`: Fuzzy finding.
-    - [x] `Treesitter`: Syntax highlighting.
-    - [x] `Harpoon`: Fast file switching.
-    - [x] `Neo-tree`: File explorer.
-- [x] **UI/UX Menus**: Added `dressing.nvim` and `telescope-ui-select.nvim` for modern, searchable selection lists and floating inputs.
-- [x] **LSP & Autocomplete**:
-    - [x] `Mason`: Managing LSPs (rust-analyzer, pyright, ruff).
-    - [x] `Cmp`: Autocompletion engine.
-- [x] **Language Specifics**:
-    - [x] **Rust**: `rustaceanvim` configured.
-    - [x] **Python**: `pyright` + `ruff`.
-- [x] **AI Integration**:
-    - [x] `Copilot.lua`: Enabled (needs `:Copilot auth`).
-    - [x] `CopilotChat.nvim`: Sidebar chat (VS Code style).
-    - [ ] `Avante.nvim`: Skipped (Removed due to complexity/instability).
-- [x] **VS Code Parity Pack**:
-    - [x] `Trouble`: Problems panel.
-    - [x] `Spectre`: Search/Replace.
-    - [x] `Autopairs`: Auto-close brackets.
-    - [x] `Todo-Comments`: TODO/FIXME highlighting.
-    - [x] `Persistence`: Session management.
-
----
-
-## Phase 9: Repository Polish & PR #62 (In Progress)
-Focus: Finalize the `dotfiles` repository for public consumption and sync the local "Gold Standard" environment.
-
-- [x] **Repository Sync**:
-    - [x] Clone official repo to `~/dotfiles`.
-    - [ ] Sync validated configuration (Neovim, scripts, tuning) into repository.
-- [ ] **Documentation Update**:
-    - [ ] Refactor `README.md` for the modern architecture.
-    - [ ] Add "Easy Setup" and "Troubleshooting" guides.
-- [ ] **Final PR Submission**:
-    - [ ] Verify clean diff against original PR #62.
-    - [ ] Push updates to PR #62 branch.
-
-
-