@sebastienrousseau/dotfiles 0.2.481 → 0.2.500

package/dot_local/bin/executable_tour

@@ -1,25 +1,30 @@
 #!/bin/sh
 # Interactive Tour using Gum
-# Part of Dotfiles v0.2.480
+# Part of Dotfiles v0.2.500
 
 if ! command -v gum >/dev/null; then
-    echo "Error: 'gum' is not installed."
-    case "$(uname -s)" in
-        Darwin)
-            echo "Install: brew install gum"
-            ;;
-        Linux)
-            if command -v snap >/dev/null; then
-                echo "Install: sudo snap install gum --classic"
-            else
-                echo "Install: go install github.com/charmbracelet/gum@latest"
-            fi
-            ;;
-        *)
-            echo "Install gum from: https://github.com/charmbracelet/gum"
-            ;;
-    esac
-    exit 1
+  echo "Error: 'gum' is not installed."
+  case "$(uname -s)" in
+    Darwin)
+      echo "Install: brew install gum"
+      ;;
+    Linux)
+      if command -v snap >/dev/null; then
+        echo "Install: sudo snap install gum --classic"
+      else
+        echo "Install: go install github.com/charmbracelet/gum@latest"
+      fi
+      ;;
+    *)
+      echo "Install gum from: https://github.com/charmbracelet/gum"
+      ;;
+  esac
+  exit 1
+fi
+
+if [ ! -t 1 ]; then
+  echo "Error: This interactive tour requires a TTY."
+  exit 1
 fi
 
 clear
@@ -32,27 +37,28 @@ banner='██████╗  ██████╗ ████████╗
 ██████╔╝╚██████╔╝   ██║   ██║     ██║███████╗███████╗███████║
 ╚═════╝  ╚═════╝    ╚═╝   ╚═╝     ╚═╝╚══════╝╚══════╝╚══════╝
 
-v0.2.480 · Infrastructure‑grade shell environment'
+v0.2.500 · Infrastructure‑grade shell environment'
 
 gum style \
-    --foreground 212 --border-foreground 212 --border double \
-    --align center --margin "1 2" --padding "1 2" \
-    "$banner"
+  --foreground 212 --border-foreground 212 --border double \
+  --align center --margin "1 2" --padding "1 2" \
+  "$banner"
 
 echo ""
 gum confirm "Start a quick tour?" || exit 0
 clear
 
-# Slide 1: Start here
+# Slide 1: Shell & configuration
 gum style \
-    --foreground 99 --border rounded --padding "1 2" --margin "1 2" \
-    "Start here" \
-    "Apply your setup. Keep it repeatable." \
-    " " \
-    "dot apply   # Apply your dotfiles" \
-    "dot update  # Pull and apply updates" \
-    "dot diff    # Review local changes" \
-    "dot drift   # Snapshot config drift"
+  --foreground 99 --border rounded --padding "1 2" --margin "1 2" \
+  "Shell & configuration" \
+  "Default shell: Fish. Change it in .chezmoidata.toml." \
+  " " \
+  "dot apply   # Apply dotfiles" \
+  "dot update  # Pull and apply updates" \
+  "dot diff    # Review local changes" \
+  "dot drift   # Snapshot config drift" \
+  "dot help    # Browse all commands"
 
 echo ""
 gum confirm "Next: Check health" || exit 0
@@ -60,13 +66,13 @@ clear
 
 # Slide 2: Diagnostics
 gum style \
-    --foreground 75 --border rounded --padding "1 2" --margin "1 2" \
-    "Check health" \
-    "Know what’s working. See what needs attention." \
-    " " \
-    "dot doctor    # Health checks" \
-    "dot history   # History analysis" \
-    "dot benchmark # Startup timing"
+  --foreground 75 --border rounded --padding "1 2" --margin "1 2" \
+  "Check health" \
+  "Know what’s working. See what needs attention." \
+  " " \
+  "dot doctor    # Health checks" \
+  "dot history   # History analysis" \
+  "dot benchmark # Startup timing"
 
 echo ""
 gum confirm "Next: Secrets" || exit 0
@@ -74,14 +80,14 @@ clear
 
 # Slide 3: Secrets
 gum style \
-    --foreground 214 --border rounded --padding "1 2" --margin "1 2" \
-    "Secrets (age)" \
-    "Keep sensitive data local and encrypted." \
-    " " \
-    "dot secrets-init   # Create a key" \
-    "dot secrets        # Edit secrets" \
-    "dot secrets-create # New encrypted file" \
-    "dot ssh-key        # Encrypt an SSH key"
+  --foreground 214 --border rounded --padding "1 2" --margin "1 2" \
+  "Secrets (age)" \
+  "Keep sensitive data local and encrypted." \
+  " " \
+  "dot secrets-init   # Create a key" \
+  "dot secrets        # Edit secrets" \
+  "dot secrets-create # New encrypted file" \
+  "dot ssh-key        # Encrypt an SSH key"
 
 echo ""
 gum confirm "Next: Security (opt‑in)" || exit 0
@@ -89,16 +95,16 @@ clear
 
 # Slide 4: Security (opt-in)
 gum style \
-    --foreground 150 --border double --padding "1 2" --margin "1 2" \
-    "Security (opt‑in)" \
-    "Explicit by design. Nothing changes without your choice." \
-    " " \
-    "dot firewall      # Firewall hardening" \
-    "dot telemetry     # Disable OS telemetry" \
-    "dot dns-doh       # DNS‑over‑HTTPS (Linux)" \
-    "dot lock-screen   # Idle lock settings" \
-    "dot usb-safety    # Disable automount" \
-    "dot encrypt-check # Disk encryption status"
+  --foreground 150 --border double --padding "1 2" --margin "1 2" \
+  "Security (opt‑in)" \
+  "Explicit by design. Nothing changes without your choice." \
+  " " \
+  "dot firewall      # Firewall hardening" \
+  "dot telemetry     # Disable OS telemetry" \
+  "dot dns-doh       # DNS‑over‑HTTPS (Linux)" \
+  "dot lock-screen   # Idle lock settings" \
+  "dot usb-safety    # Disable automount" \
+  "dot encrypt-check # Disk encryption status"
 
 echo ""
 gum confirm "Next: Themes & UX" || exit 0
@@ -106,15 +112,17 @@ clear
 
 # Slide 5: Themes & UX
 gum style \
-    --foreground 212 --border rounded --padding "1 2" --margin "1 2" \
-    "Themes & UX" \
-    "Make it yours without changing how it works." \
-    " " \
-    "dot theme      # Switch theme" \
-    "dot wallpaper  # Apply wallpaper" \
-    "dot fonts      # Install Nerd Fonts" \
-    "dot keys       # Keybindings" \
-    "dot tools      # Curated utilities"
+  --foreground 212 --border rounded --padding "1 2" --margin "1 2" \
+  "Themes & UX" \
+  "Make it yours without changing how it works." \
+  " " \
+  "dot theme      # Switch theme" \
+  "dot wallpaper  # Apply wallpaper" \
+  "dot fonts      # Install Nerd Fonts" \
+  "dot keys       # Keybindings" \
+  "dot tools      # Curated utilities" \
+  " " \
+  "Edit ~/.dotfiles/.chezmoidata.toml for shell, features, and profiles."
 
 echo ""
 gum confirm "Next: Projects & Sandbox" || exit 0
@@ -122,16 +130,46 @@ clear
 
 # Slide 6: Projects & Sandbox
 gum style \
-    --foreground 111 --border rounded --padding "1 2" --margin "1 2" \
-    "Projects & sandbox" \
-    "Start quickly. Experiment safely." \
-    " " \
-    "dot new <lang> <name>  # Templates: python, go, node" \
-    "dot sandbox            # Safe preview (Docker/Podman)" \
-    "dot edit               # Open source in editor"
+  --foreground 111 --border rounded --padding "1 2" --margin "1 2" \
+  "Projects & sandbox" \
+  "Start quickly. Experiment safely." \
+  " " \
+  "dot new <lang> <name>  # Templates: python, go, node" \
+  "dot sandbox            # Safe preview (Docker/Podman)" \
+  "dot edit               # Open source in editor"
+
+echo ""
+gum confirm "Next: Linting & Performance" || exit 0
+clear
+
+# Slide 7: Linting & Performance
+gum style \
+  --foreground 214 --border rounded --padding "1 2" --margin "1 2" \
+  "Linting & Performance" \
+  "Keep your scripts clean and your shell fast." \
+  " " \
+  "dot lint              # ShellCheck + shfmt" \
+  "dot lint --fix        # Auto-format scripts" \
+  "dot lint --check      # CI mode (exit 1 on failure)" \
+  "dot benchmark --waterfall  # Startup waterfall chart" \
+  "dot perf              # Quick performance timing"
 
 echo ""
+gum confirm "Next: Finish" || exit 0
+clear
+
+# Final summary
 gum style \
-    --foreground 212 --margin "1 2" \
-    "You’re all set. Tip: run 'dot update' weekly to stay current."
+  --foreground 212 --border double --padding "1 2" --margin "1 2" \
+  "You’re all set!" \
+  " " \
+  "Tip: run ‘dot update’ weekly to stay current."
+
 echo ""
+choice=$(gum choose "Run dot doctor" "Run dot benchmark" "Open docs" "Exit")
+case "$choice" in
+  "Run dot doctor") exec dot doctor ;;
+  "Run dot benchmark") exec dot benchmark ;;
+  "Open docs") exec dot docs ;;
+  "Exit") exit 0 ;;
+esac

package/dot_local/bin/executable_up

@@ -0,0 +1,21 @@
+#!/bin/sh
+# Universal directory navigation with history support
+# Works across Bash, Zsh, and Fish
+
+levels=$1
+target=".."
+
+case "$levels" in
+  2) target="../.." ;;
+  3) target="../../.." ;;
+  4) target="../../../../.." ;;
+  5) target="../../../../../.." ;;
+  *) target=".." ;;
+esac
+
+# If cd_with_history (a dotfiles function) is available, use it.
+# Since this script runs in a subshell, we can't easily call parent functions.
+# Instead, we just output the target or rely on the shell's own history.
+
+cd "$target" || exit 1
+$SHELL

package/dot_local/bin/executable_update

@@ -1,6 +1,25 @@
 #!/usr/bin/env bash
-# Update all system packages and tools
-# Usage: update [--all|--brew|--apt|--npm|--cargo|--pip]
+## System Update — Update all system packages and tools.
+##
+## Comprehensive update utility for multiple package managers.
+## Supports selective updates and combined operations.
+##
+## # Requirements
+## - Various package managers (auto-detected)
+## - sudo: For system package updates
+##
+## # Usage
+## update                      # Update all detected managers
+## update --brew               # Update Homebrew only
+## update --apt                # Update APT only
+## update --npm                # Update NPM globals only
+## update --cargo              # Update Rust packages
+## update --pip                # Update Python packages
+##
+## # Platform Notes
+## - macOS: Updates Homebrew, npm, cargo, pip
+## - Linux: Updates apt/dnf, npm, cargo, pip
+## - Also checks chezmoi dotfiles status
 
 set -euo pipefail
 
@@ -9,9 +28,9 @@ GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
 NC='\033[0m'
 
-log_section() { echo -e "\n${CYAN}━━━ $1 ━━━${NC}"; }
-log_success() { echo -e "${GREEN}✓${NC} $1"; }
-log_skip() { echo -e "${YELLOW}○${NC} $1 (skipped)"; }
+log_section() { printf '%b\n' "\n${CYAN}--- $1 ---${NC}"; }
+log_success() { printf '%b\n' "${GREEN}Done:${NC} $1"; }
+log_skip() { printf '%b\n' "${YELLOW}Skipped:${NC} $1"; }
 
 # Parse arguments
 UPDATE_ALL=true
@@ -24,11 +43,26 @@ UPDATE_PIP=false
 for arg in "$@"; do
   case "$arg" in
     --all) UPDATE_ALL=true ;;
-    --brew) UPDATE_BREW=true; UPDATE_ALL=false ;;
-    --apt) UPDATE_APT=true; UPDATE_ALL=false ;;
-    --npm) UPDATE_NPM=true; UPDATE_ALL=false ;;
-    --cargo) UPDATE_CARGO=true; UPDATE_ALL=false ;;
-    --pip) UPDATE_PIP=true; UPDATE_ALL=false ;;
+    --brew)
+      UPDATE_BREW=true
+      UPDATE_ALL=false
+      ;;
+    --apt)
+      UPDATE_APT=true
+      UPDATE_ALL=false
+      ;;
+    --npm)
+      UPDATE_NPM=true
+      UPDATE_ALL=false
+      ;;
+    --cargo)
+      UPDATE_CARGO=true
+      UPDATE_ALL=false
+      ;;
+    --pip)
+      UPDATE_PIP=true
+      UPDATE_ALL=false
+      ;;
   esac
 done
 
@@ -105,4 +139,4 @@ if $UPDATE_ALL; then
   fi
 fi
 
-echo -e "\n${GREEN}Update complete!${NC}"
+printf '%b\n' "\n${GREEN}Update complete!${NC}"

package/dot_local/bin/executable_uuid

@@ -1,6 +1,24 @@
 #!/usr/bin/env bash
-# UUID generator
-# Usage: uuid [count] [--upper] [--no-dashes]
+## UUID Generator — Generate random UUIDs (v4).
+##
+## Generates one or more random UUIDs with optional formatting.
+## Supports uppercase output and dash removal.
+##
+## # Requirements
+## - uuidgen: Primary generator (util-linux or macOS)
+## - /proc/sys/kernel/random/uuid: Linux kernel fallback
+## - od + /dev/urandom: Universal fallback
+##
+## # Usage
+## uuid                        # Generate 1 UUID
+## uuid 5                      # Generate 5 UUIDs
+## uuid -u                     # Uppercase UUID
+## uuid -n                     # No dashes (compact format)
+## uuid 3 -u -n                # 3 uppercase compact UUIDs
+##
+## # Platform Notes
+## - Linux: Uses uuidgen or kernel random
+## - macOS: Uses uuidgen
 
 set -euo pipefail
 
@@ -10,9 +28,15 @@ NO_DASHES=false
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    -u|--upper) UPPER=true; shift ;;
-    -n|--no-dashes) NO_DASHES=true; shift ;;
-    -h|--help)
+    -u | --upper)
+      UPPER=true
+      shift
+      ;;
+    -n | --no-dashes)
+      NO_DASHES=true
+      shift
+      ;;
+    -h | --help)
       echo "Usage: uuid [count] [OPTIONS]"
       echo ""
       echo "Options:"
@@ -26,8 +50,14 @@ while [[ $# -gt 0 ]]; do
       echo "  uuid -u       # Uppercase UUID"
       exit 0
       ;;
-    [0-9]*) COUNT="$1"; shift ;;
-    *) echo "Unknown option: $1"; exit 1 ;;
+    [0-9]*)
+      COUNT="$1"
+      shift
+      ;;
+    *)
+      echo "Unknown option: $1"
+      exit 1
+      ;;
   esac
 done
 

package/dot_local/bin/executable_win

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+# WSL-specific Windows Interop shim (win)
+# Intelligently handles path translation using wslpath
+# Part of Dotfiles v0.2.495
+
+set -euo pipefail
+
+if ! grep -qi microsoft /proc/version 2>/dev/null; then
+  echo "This script is only for WSL systems." >&2
+  exit 1
+fi
+
+cmd="$1"
+shift || {
+  echo "Usage: win <windows_command> [args]"
+  exit 1
+}
+
+# Translate paths in arguments
+args=()
+for arg in "$@"; do
+  if [ -e "$arg" ]; then
+    translated=$(wslpath -w "$arg" 2>/dev/null || echo "$arg")
+    args+=("$translated")
+  else
+    args+=("$arg")
+  fi
+done
+
+# Execute the windows command with translated paths
+exec "$cmd" "${args[@]}"

package/dot_local/bin/executable_yamlv

@@ -1,20 +1,38 @@
 #!/usr/bin/env bash
-# YAML validator
-# Usage: yamlv <file> | yamlv (reads stdin)
+## YAML Validator — Validate YAML syntax.
+##
+## Validates YAML syntax and reports success or failure.
+## Supports quiet mode for scripting.
+##
+## # Requirements
+## - yq: Primary YAML processor (recommended)
+## - python3 + pyyaml: Fallback validator
+## - ruby + yaml: Secondary fallback
+##
+## # Usage
+## yamlv file.yaml             # Validate YAML file
+## yamlv < file.yaml           # Validate from stdin
+## yamlv -q file.yaml          # Quiet mode (exit code only)
+##
+## # Platform Notes
+## - All platforms: Requires yq, python3+pyyaml, or ruby
 
 set -euo pipefail
 
 QUIET=false
-[[ "${1:-}" == "-q" || "${1:-}" == "--quiet" ]] && { QUIET=true; shift; }
+[[ "${1:-}" == "-q" || "${1:-}" == "--quiet" ]] && {
+  QUIET=true
+  shift
+}
 
 validate_yaml() {
   local input="$1"
   if command -v yq >/dev/null 2>&1; then
-    yq -e '.' <<< "$input" >/dev/null 2>&1
+    yq -e '.' <<<"$input" >/dev/null 2>&1
   elif command -v python3 >/dev/null 2>&1; then
     python3 -c "import yaml; yaml.safe_load('''$input''')" 2>/dev/null
   elif command -v ruby >/dev/null 2>&1; then
-    ruby -ryaml -e "YAML.safe_load(STDIN.read)" <<< "$input" 2>/dev/null
+    ruby -ryaml -e "YAML.safe_load(STDIN.read)" <<<"$input" 2>/dev/null
   else
     echo "Error: yq, python3+pyyaml, or ruby required"
     exit 1
@@ -31,9 +49,9 @@ else
 fi
 
 if validate_yaml "$INPUT"; then
-  $QUIET || echo "✓ Valid YAML ($SOURCE)"
+  $QUIET || echo "Valid YAML ($SOURCE)"
   exit 0
 else
-  echo "✗ Invalid YAML ($SOURCE)"
+  echo "Invalid YAML ($SOURCE)"
   exit 1
 fi

package/dot_local/share/bash-completion/completions/dot

@@ -3,52 +3,70 @@
 # Source this file or place in /etc/bash_completion.d/ or ~/.local/share/bash-completion/completions/
 
 _dot_completions() {
-    local cur prev commands
-    COMPREPLY=()
-    cur="${COMP_WORDS[COMP_CWORD]}"
-    prev="${COMP_WORDS[COMP_CWORD-1]}"
+  local cur prev commands
+  COMPREPLY=()
+  cur="${COMP_WORDS[COMP_CWORD]}"
+  prev="${COMP_WORDS[COMP_CWORD - 1]}"
 
-    # Main commands
-    commands="apply sync update add diff status remove cd drift history doctor keys tools sandbox benchmark tune secrets secrets-init secrets-create ssh-key firewall telemetry dns-doh encrypt-check backup lock-screen usb-safety fonts wallpaper theme upgrade edit docs new log-rotate learn --version help"
+  # Main commands
+  commands="apply sync update add diff status remove cd drift verify history doctor heal health security-score scorecard perf conflicts locks snapshot keys tools aliases sandbox benchmark tune secrets env secrets-init secrets-create ssh-key firewall telemetry dns-doh encrypt-check backup lock-screen usb-safety fonts wallpaper theme upgrade edit docs new log-rotate setup learn --version help"
 
-    # Subcommand completions
-    case "${prev}" in
-        dot)
-            COMPREPLY=( $(compgen -W "${commands}" -- "${cur}") )
-            return 0
-            ;;
-        add)
-            # Complete file paths
-            COMPREPLY=( $(compgen -f -- "${cur}") )
-            return 0
-            ;;
-        new)
-            # Complete template types
-            local templates="python go node"
-            COMPREPLY=( $(compgen -W "${templates}" -- "${cur}") )
-            return 0
-            ;;
-        tools)
-            # Complete tools subcommands
-            local subcommands="install"
-            COMPREPLY=( $(compgen -W "${subcommands}" -- "${cur}") )
-            return 0
-            ;;
-        theme)
-            # Complete theme options
-            local themes="dark light"
-            COMPREPLY=( $(compgen -W "${themes}" -- "${cur}") )
-            return 0
-            ;;
-        keys)
-            # Allow any search term
-            return 0
-            ;;
-        *)
-            COMPREPLY=( $(compgen -W "${commands}" -- "${cur}") )
-            return 0
-            ;;
-    esac
+  # Subcommand completions
+  case "${prev}" in
+    dot)
+      COMPREPLY=($(compgen -W "${commands}" -- "${cur}"))
+      return 0
+      ;;
+    add)
+      # Complete file paths
+      COMPREPLY=($(compgen -f -- "${cur}"))
+      return 0
+      ;;
+    new)
+      # Complete template types
+      local templates="python go node"
+      COMPREPLY=($(compgen -W "${templates}" -- "${cur}"))
+      return 0
+      ;;
+    tools)
+      # Complete tools subcommands
+      local subcommands="install"
+      COMPREPLY=($(compgen -W "${subcommands}" -- "${cur}"))
+      return 0
+      ;;
+    aliases)
+      # Complete alias inspection subcommands
+      local subcommands="list search why stats tiers"
+      COMPREPLY=($(compgen -W "${subcommands}" -- "${cur}"))
+      return 0
+      ;;
+    secrets)
+      # Complete secrets subcommands
+      local subcommands="edit set get list load provider"
+      COMPREPLY=($(compgen -W "${subcommands}" -- "${cur}"))
+      return 0
+      ;;
+    env)
+      # Complete env subcommands
+      local subcommands="load"
+      COMPREPLY=($(compgen -W "${subcommands}" -- "${cur}"))
+      return 0
+      ;;
+    theme)
+      # Complete theme options
+      local themes="dark light"
+      COMPREPLY=($(compgen -W "${themes}" -- "${cur}"))
+      return 0
+      ;;
+    keys)
+      # Allow any search term
+      return 0
+      ;;
+    *)
+      COMPREPLY=($(compgen -W "${commands}" -- "${cur}"))
+      return 0
+      ;;
+  esac
 }
 
 complete -F _dot_completions dot