@sebastienrousseau/dotfiles 0.2.499 → 0.2.500

package/scripts/diagnostics/alias-governance.sh

@@ -0,0 +1,137 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+# Alias governance checks:
+# - duplicate alias names
+# - risky overrides must be gated
+# - no hardcoded /Users paths
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+manifest_script="$SCRIPT_DIR/aliases-manifest.sh"
+deprecations_file="$SCRIPT_DIR/../dot/data/alias-deprecations.tsv"
+policy="${DOTFILES_ALIAS_POLICY:-standard}"
+if [[ -n "${CI:-}" && "${DOTFILES_ALIAS_POLICY:-}" == "" ]]; then
+  policy="strict"
+fi
+
+if [[ ! -x "$manifest_script" ]]; then
+  echo "ERROR: aliases-manifest.sh not found or not executable" >&2
+  exit 1
+fi
+
+tmp_manifest="$(umask 077 && mktemp)"
+trap 'rm -f "$tmp_manifest"' EXIT
+
+bash "$manifest_script" >"$tmp_manifest"
+
+errors=0
+
+echo "Alias Governance"
+echo ""
+echo "Policy: $policy"
+echo ""
+
+version_ge() {
+  local a="${1#v}" b="${2#v}"
+  local IFS=.
+  local i
+  read -r -a av <<<"$a"
+  read -r -a bv <<<"$b"
+  for i in 0 1 2; do
+    local ai="${av[$i]:-0}"
+    local bi="${bv[$i]:-0}"
+    ((10#$ai > 10#$bi)) && return 0
+    ((10#$ai < 10#$bi)) && return 1
+  done
+  return 0
+}
+
+repo_version="0.0.0"
+if [[ -f "$SCRIPT_DIR/../../package.json" ]]; then
+  repo_version="$(sed -n 's/^[[:space:]]*"version"[[:space:]]*:[[:space:]]*"\([0-9][0-9.]*\)".*/\1/p' "$SCRIPT_DIR/../../package.json" | head -1)"
+fi
+repo_version="${repo_version:-0.0.0}"
+
+# 1) Duplicate alias names
+dupes="$(awk -F'\t' '{count[$1]++} END {for (k in count) if (count[k] > 1) print k}' "$tmp_manifest" | sort)"
+if [[ -n "$dupes" ]]; then
+  if [[ "$policy" == "strict" ]]; then
+    echo "ERROR: duplicate alias names detected:"
+    printf "%s\n" "$dupes" | sed 's/^/  - /'
+    errors=$((errors + 1))
+  else
+    echo "WARN: duplicate alias names detected (review recommended):"
+    printf "%s\n" "$dupes" | sed 's/^/  - /'
+  fi
+else
+  echo "OK: no duplicate alias names"
+fi
+
+# 2) Risky overrides must be gated
+while IFS=$'\t' read -r name _value file _line; do
+  case "$name" in
+    cd | sudo | su | cp | mv | rm | mkdir | alias)
+      # GNU coreutils aliases are intentionally centralized overrides.
+      if [[ "$file" == *"/aliases/gnu/"* ]]; then
+        continue
+      fi
+      if ! rg -q 'DOTFILES_(ENABLE|SAFE|ALIAS)' "$file"; then
+        echo "ERROR: risky override '$name' in $file is not gated by a DOTFILES_* flag"
+        errors=$((errors + 1))
+      fi
+      ;;
+  esac
+done <"$tmp_manifest"
+
+if [[ $errors -eq 0 ]]; then
+  echo "OK: risky overrides are gated"
+fi
+
+# 3) Hardcoded /Users path check (alias value only)
+hardcoded="$(awk -F'\t' '$2 ~ /\/Users\// {print $1 "\t" $2 "\t" $3 ":" $4}' "$tmp_manifest")"
+if [[ -n "$hardcoded" ]]; then
+  echo "ERROR: hardcoded /Users paths detected in aliases:"
+  printf "%s\n" "$hardcoded" | sed 's/^/  - /'
+  errors=$((errors + 1))
+else
+  echo "OK: no hardcoded /Users paths in aliases"
+fi
+
+# 4) Deprecation window enforcement
+if [[ -f "$deprecations_file" ]]; then
+  expired_hits=0
+  while IFS=$'\t' read -r alias_name replacement remove_in; do
+    [[ -z "${alias_name:-}" ]] && continue
+    [[ "${alias_name:0:1}" == "#" ]] && continue
+    if version_ge "$repo_version" "$remove_in"; then
+      alias_found=0
+      if awk -F'\t' -v n="$alias_name" '$1==n{found=1} END{exit(found?0:1)}' "$tmp_manifest"; then
+        alias_found=1
+      fi
+      function_found=0
+      if rg -q --glob '*.sh' --glob '*.aliases.sh' --glob '*.tmpl' "^[[:space:]]*(function[[:space:]]+)?${alias_name}[[:space:]]*\\(\\)" "$SCRIPT_DIR/../../.chezmoitemplates/aliases" "$SCRIPT_DIR/../../scripts/dot"; then
+        function_found=1
+      fi
+      if [[ $alias_found -eq 1 || $function_found -eq 1 ]]; then
+        [[ $expired_hits -eq 0 ]] && echo "ERROR: expired deprecated aliases still present:"
+        echo "  - $alias_name (remove_in=$remove_in, replacement=$replacement)"
+        expired_hits=$((expired_hits + 1))
+      fi
+    fi
+  done < <(cut -f1-3 "$deprecations_file")
+  if [[ $expired_hits -gt 0 ]]; then
+    errors=$((errors + 1))
+  else
+    echo "OK: no expired deprecated aliases (repo version: v$repo_version)"
+  fi
+fi
+
+echo ""
+if [[ $errors -eq 0 ]]; then
+  echo "Alias governance checks passed."
+  exit 0
+fi
+
+echo "Alias governance checks failed: $errors issue(s)." >&2
+exit 1

package/scripts/diagnostics/aliases-cheatsheet.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=../dot/lib/utils.sh
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/../dot/lib/utils.sh"
+
+src_dir="$(require_source_dir)"
+manifest="$src_dir/scripts/diagnostics/aliases-manifest.sh"
+if [[ ! -x "$manifest" ]]; then
+  echo "Alias manifest not found: $manifest" >&2
+  exit 1
+fi
+
+cat <<'HEADER'
+# Alias Cheatsheet
+
+Auto-generated from alias manifest.
+
+## Core shortcuts
+HEADER
+
+# Core list we care about (preserve ordering).
+core_aliases=(c q e h _ i l ll la lr lra lt lta a d)
+
+tmp_manifest="$(umask 077 && mktemp)"
+trap 'rm -f "$tmp_manifest"' EXIT
+bash "$manifest" >"$tmp_manifest"
+
+pick_alias() {
+  local name="$1"
+  shift
+  local value=""
+  local pattern
+  while [[ $# -gt 0 ]]; do
+    pattern="$1"
+    value="$(awk -F$'\t' -v key="$name" -v pat="$pattern" '$1==key && $3 ~ pat {print $2; exit}' "$tmp_manifest")"
+    [[ -n "$value" ]] && {
+      printf '%s\n' "$value"
+      return 0
+    }
+    shift
+  done
+  value="$(awk -F$'\t' -v key="$name" '$1==key {print $2; exit}' "$tmp_manifest")"
+  [[ -n "$value" ]] && printf '%s\n' "$value"
+}
+
+for a in "${core_aliases[@]}"; do
+  case "$a" in
+    a)
+      line="$(pick_alias "$a" "/ai/")"
+      ;;
+    d)
+      line="$(pick_alias "$a" "/system/" "/configuration/" "/docker/")"
+      ;;
+    *)
+      line="$(pick_alias "$a")"
+      ;;
+  esac
+  if [[ -n "$line" ]]; then
+    printf '%s\n' "- \`$a\` $line"
+  fi
+done
+
+cat <<'FOOTER'
+
+## Notes
+
+- Regenerate: `dot aliases cheatsheet`
+- Apply changes: `chezmoi apply`
+FOOTER

package/scripts/diagnostics/aliases-manifest.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+# Emit alias manifest as TSV:
+# name<TAB>value<TAB>file<TAB>line
+
+set -euo pipefail
+
+resolve_source_dir() {
+  if [[ -n "${CHEZMOI_SOURCE_DIR:-}" && -d "${CHEZMOI_SOURCE_DIR}" ]]; then
+    printf "%s\n" "${CHEZMOI_SOURCE_DIR}"
+    return
+  fi
+  if [[ -d "$HOME/.dotfiles" ]]; then
+    printf "%s\n" "$HOME/.dotfiles"
+    return
+  fi
+  if [[ -d "$HOME/.local/share/chezmoi" ]]; then
+    printf "%s\n" "$HOME/.local/share/chezmoi"
+    return
+  fi
+  return 1
+}
+
+src_dir="${1:-$(resolve_source_dir)}"
+
+rg -n \
+  -e '^[[:space:]]*alias[[:space:]]+[A-Za-z0-9_.:-]+=' \
+  -e '^[[:space:]]*[^#"'\'']*&&[[:space:]]*alias[[:space:]]+[A-Za-z0-9_.:-]+=' \
+  "$src_dir/.chezmoitemplates/aliases" \
+  "$src_dir/.chezmoitemplates/functions" |
+  sed -E 's#^([^:]+):([0-9]+):.*alias[[:space:]]+([A-Za-z0-9_.:-]+)=(.*)$#\3\t\4\t\1\t\2#'

package/scripts/diagnostics/benchmark.sh

@@ -0,0 +1,381 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## Shell Performance Benchmark.
+##
+## Measures shell startup time with per-component profiling. Uses hyperfine
+## for statistical accuracy or falls back to basic timing. Tracks history
+## for regression detection.
+##
+## # Usage
+## dot benchmark                    # Basic startup timing
+## dot benchmark --detailed         # Per-component breakdown
+## dot benchmark --profile          # zprof analysis
+## dot benchmark --compare          # Compare with history
+## dot benchmark --waterfall        # ASCII waterfall chart of component timings
+##
+## # Dependencies
+## - python3: Millisecond timing (required)
+## - hyperfine: Statistical benchmarking (optional, falls back to basic)
+## - jq: JSON parsing for results (optional)
+## - zsh: Target shell (required)
+##
+## # Metrics
+## | Rating | Threshold | Description |
+## |--------|-----------|-------------|
+## | Excellent | <100ms | Instant response |
+## | Good | <200ms | Responsive |
+## | Acceptable | <500ms | Noticeable delay |
+## | Slow | >500ms | Optimization needed |
+##
+## # Platform Notes
+## - macOS: Full support
+## - Linux: Full support
+## - WSL: May show higher times due to filesystem overhead
+##
+## # Output Files
+## Benchmarks saved to ~/.local/share/dotfiles/benchmarks/
+##
+## # Idempotency
+## Safe to run repeatedly. Creates timestamped history files.
+
+set -euo pipefail
+
+_cleanup_files=()
+trap 'rm -f "${_cleanup_files[@]}"' EXIT
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=../dot/lib/ui.sh
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/../dot/lib/ui.sh"
+# shellcheck source=../dot/lib/log.sh
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/../dot/lib/log.sh"
+export DOT_COMMAND="benchmark"
+
+BENCHMARK_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/dotfiles/benchmarks"
+mkdir -p "$BENCHMARK_DIR"
+
+# Parse arguments
+DETAILED=false
+PROFILE=false
+COMPARE=false
+WATERFALL=false
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --detailed | -d)
+      DETAILED=true
+      shift
+      ;;
+    --profile | -p)
+      PROFILE=true
+      shift
+      ;;
+    --compare | -c)
+      COMPARE=true
+      shift
+      ;;
+    --waterfall | -w)
+      WATERFALL=true
+      shift
+      ;;
+    *) shift ;;
+  esac
+done
+
+ui_init
+
+print_header() {
+  echo ""
+  ui_dot_banner "Diagnostics"
+  ui_header "Shell Performance Benchmark"
+  echo ""
+}
+
+# Basic timing function
+time_command() {
+  local start end
+  start=$(python3 -c 'import time; print(int(time.time() * 1000))')
+  eval "$1" >/dev/null 2>&1
+  end=$(python3 -c 'import time; print(int(time.time() * 1000))')
+  echo $((end - start))
+}
+
+# Per-component profiling using zprof
+run_zsh_profile() {
+  ui_header "Zsh profiler (zprof)"
+  echo ""
+
+  zsh -c '
+    zmodload zsh/zprof
+# shellcheck disable=SC1091
+    source ~/.zshenv 2>/dev/null
+# shellcheck disable=SC1091
+    source ~/.config/zsh/.zshrc 2>/dev/null
+    zprof
+  ' 2>/dev/null | head -30
+}
+
+# Benchmark individual components
+benchmark_components() {
+  ui_header "Per-Component Timing"
+  echo ""
+  printf "%-35s %8s\n" "Component" "Time (ms)"
+  echo "───────────────────────────────────────────────"
+
+  # zshenv (bootloader)
+  local zshenv_time
+  # shellcheck disable=SC1091
+  zshenv_time=$(time_command "zsh -c 'source ~/.zshenv 2>/dev/null; exit'")
+  printf "%-35s %8s\n" "zshenv (bootloader)" "${zshenv_time}ms"
+
+  # Core shell options
+  local options_time
+  # shellcheck disable=SC1091
+  options_time=$(time_command "zsh -c 'source ~/.config/zsh/rc.d/30-options.zsh 2>/dev/null; exit'" 2>/dev/null || echo "N/A")
+  printf "%-35s %8s\n" "rc.d/30-options.zsh" "${options_time}ms"
+
+  # Zinit plugins
+  local zinit_time
+  # shellcheck disable=SC1091
+  zinit_time=$(time_command "zsh -c 'source ~/.config/zsh/rc.d/20-zinit.zsh 2>/dev/null; exit'" 2>/dev/null || echo "N/A")
+  printf "%-35s %8s\n" "rc.d/20-zinit.zsh (plugins)" "${zinit_time}ms"
+
+  # Tool initializations
+  for tool in starship atuin zoxide fzf direnv; do
+    if command -v "$tool" >/dev/null 2>&1; then
+      local tool_time
+      case "$tool" in
+        starship) tool_time=$(time_command "starship init zsh >/dev/null") ;;
+        atuin) tool_time=$(time_command "atuin init zsh >/dev/null") ;;
+        zoxide) tool_time=$(time_command "zoxide init zsh >/dev/null") ;;
+        fzf) tool_time=$(time_command "true") ;; # FZF sourced from file
+        direnv) tool_time=$(time_command "direnv hook zsh >/dev/null") ;;
+      esac
+      printf "%-35s %8s\n" "$tool init" "${tool_time}ms"
+    fi
+  done
+
+  echo "───────────────────────────────────────────────"
+}
+
+# Render ASCII waterfall chart from component timings
+render_waterfall() {
+  ui_header "Startup Waterfall"
+  echo ""
+
+  local -a names=()
+  local -a times=()
+  local total_time=0
+
+  # zshenv
+  local t
+  # shellcheck disable=SC1091
+  t=$(time_command "zsh -c 'source ~/.zshenv 2>/dev/null; exit'")
+  names+=("zshenv (bootloader)")
+  times+=("$t")
+  total_time=$((total_time + t))
+
+  # rc.d modules
+  # shellcheck disable=SC1091
+  t=$(time_command "zsh -c 'source ~/.config/zsh/rc.d/30-options.zsh 2>/dev/null; exit'" 2>/dev/null || echo 0)
+  names+=("rc.d/30-options.zsh")
+  times+=("$t")
+  total_time=$((total_time + t))
+
+  # shellcheck disable=SC1091
+  t=$(time_command "zsh -c 'source ~/.config/zsh/rc.d/20-zinit.zsh 2>/dev/null; exit'" 2>/dev/null || echo 0)
+  names+=("rc.d/20-zinit (plugins)")
+  times+=("$t")
+  total_time=$((total_time + t))
+
+  # Tool inits
+  for tool in starship atuin zoxide fzf direnv; do
+    if command -v "$tool" >/dev/null 2>&1; then
+      case "$tool" in
+        starship) t=$(time_command "starship init zsh >/dev/null") ;;
+        atuin) t=$(time_command "atuin init zsh >/dev/null") ;;
+        zoxide) t=$(time_command "zoxide init zsh >/dev/null") ;;
+        fzf) t=$(time_command "true") ;;
+        direnv) t=$(time_command "direnv hook zsh >/dev/null") ;;
+      esac
+      names+=("$tool init")
+      times+=("$t")
+      total_time=$((total_time + t))
+    fi
+  done
+
+  if [[ "$total_time" -eq 0 ]]; then
+    ui_warn "No timing data" "Could not measure components"
+    return
+  fi
+
+  # Render bars
+  local bar_width=30
+  local i
+  for i in "${!names[@]}"; do
+    local name="${names[$i]}"
+    local ms="${times[$i]}"
+    local pct=$((ms * 100 / total_time))
+    local filled=$((ms * bar_width / total_time))
+    local empty=$((bar_width - filled))
+
+    local bar=""
+    local j
+    for ((j = 0; j < filled; j++)); do bar+="$_GL_BAR_FILL"; done
+    for ((j = 0; j < empty; j++)); do bar+="$_GL_BAR_EMPTY"; done
+
+    if [[ "$UI_COLOR" = "1" ]]; then
+      printf "  %-22s %s%s%s%s%s  %4dms (%2d%%)\n" \
+        "$name" "$GREEN" "${bar:0:$filled}" "$NORMAL$GRAY" "${bar:$filled}" "$NORMAL" "$ms" "$pct"
+    else
+      printf "  %-22s %s  %4dms (%2d%%)\n" "$name" "$bar" "$ms" "$pct"
+    fi
+  done
+
+  echo "  ──────────────────────────────────────────────────────────"
+  printf "  %-22s %*s  %4dms\n" "Total" "$bar_width" "" "$total_time"
+  echo ""
+}
+
+# Run hyperfine benchmark
+run_hyperfine() {
+  if ! command -v hyperfine >/dev/null 2>&1; then
+    if [[ "$UI_ENABLED" = "1" ]]; then
+      ui_warn "hyperfine" "not installed, using basic timing"
+    else
+      printf '%b\n' "${YELLOW}hyperfine not installed. Using basic timing.${NC}"
+    fi
+    local times=()
+    for _ in {1..5}; do
+      times+=("$(time_command "zsh -i -c exit")")
+    done
+    local sum=0
+    for t in "${times[@]}"; do sum=$((sum + t)); done
+    if [[ "$UI_ENABLED" = "1" ]]; then
+      ui_ok "Average startup time" "$((sum / 5))ms"
+    else
+      printf '%b\n' "\n${GREEN}Average startup time: $((sum / 5))ms${NC}"
+    fi
+    return
+  fi
+
+  echo ""
+  ui_header "Running hyperfine benchmark"
+  echo ""
+  hyperfine --warmup 3 --runs 10 --shell=none \
+    --export-json "$BENCHMARK_DIR/latest.json" \
+    'zsh -i -c exit'
+
+  # Extract and display results
+  if [[ -f "$BENCHMARK_DIR/latest.json" ]]; then
+    local mean_ms
+    mean_ms=$(jq '.results[0].mean * 1000 | floor' "$BENCHMARK_DIR/latest.json")
+    local min_ms
+    min_ms=$(jq '.results[0].min * 1000 | floor' "$BENCHMARK_DIR/latest.json")
+    local max_ms
+    max_ms=$(jq '.results[0].max * 1000 | floor' "$BENCHMARK_DIR/latest.json")
+
+    echo ""
+    ui_header "Results"
+    if [[ "$UI_ENABLED" = "1" ]]; then
+      ui_kv "Mean:" "${mean_ms}ms"
+      ui_kv "Min:" "${min_ms}ms"
+      ui_kv "Max:" "${max_ms}ms"
+    else
+      echo "  Mean: ${mean_ms}ms"
+      echo "  Min:  ${min_ms}ms"
+      echo "  Max:  ${max_ms}ms"
+    fi
+
+    # Performance rating
+    if [[ $mean_ms -lt 100 ]]; then
+      if [[ "$UI_ENABLED" = "1" ]]; then
+        ui_ok "Performance" "Excellent (<100ms)"
+      else
+        printf '%b\n' "\n${GREEN}⚡ Excellent (<100ms)${NC}"
+      fi
+    elif [[ $mean_ms -lt 200 ]]; then
+      if [[ "$UI_ENABLED" = "1" ]]; then
+        ui_ok "Performance" "Good (<200ms)"
+      else
+        printf '%b\n' "\n${GREEN}✓ Good (<200ms)${NC}"
+      fi
+    elif [[ $mean_ms -lt 500 ]]; then
+      if [[ "$UI_ENABLED" = "1" ]]; then
+        ui_warn "Performance" "Acceptable (<500ms)"
+      else
+        printf '%b\n' "\n${YELLOW}⚠ Acceptable (<500ms)${NC}"
+      fi
+    else
+      if [[ "$UI_ENABLED" = "1" ]]; then
+        ui_err "Performance" "Slow (>500ms)"
+      else
+        printf '%b\n' "\n${RED}✗ Slow (>500ms) - optimization needed${NC}"
+      fi
+    fi
+
+    # Save with timestamp for history
+    cp "$BENCHMARK_DIR/latest.json" "$BENCHMARK_DIR/$(date +%Y%m%d_%H%M%S).json"
+    dot_log info "benchmark_complete" "mean_ms=$mean_ms" "min_ms=$min_ms" "max_ms=$max_ms"
+    dot_metric "shell_startup_mean" "$mean_ms" "ms"
+  fi
+}
+
+# Compare with previous benchmarks
+compare_benchmarks() {
+  ui_header "Benchmark History"
+  echo ""
+
+  local files
+  files=$(find "$BENCHMARK_DIR" -name "*.json" -type f | sort -r | head -10)
+
+  if [[ -z "$files" ]]; then
+    echo "No benchmark history found."
+    return
+  fi
+
+  printf "%-20s %10s %10s %10s\n" "Date" "Mean" "Min" "Max"
+  echo "────────────────────────────────────────────────"
+
+  for f in $files; do
+    local basename
+    basename=$(basename "$f" .json)
+    if [[ "$basename" == "latest" ]]; then continue; fi
+
+    local mean min max
+    mean=$(jq '.results[0].mean * 1000 | floor' "$f" 2>/dev/null || echo "N/A")
+    min=$(jq '.results[0].min * 1000 | floor' "$f" 2>/dev/null || echo "N/A")
+    max=$(jq '.results[0].max * 1000 | floor' "$f" 2>/dev/null || echo "N/A")
+
+    printf "%-20s %10sms %10sms %10sms\n" "$basename" "$mean" "$min" "$max"
+  done
+}
+
+# Main execution
+print_header
+
+if $PROFILE; then
+  run_zsh_profile
+elif $COMPARE; then
+  compare_benchmarks
+elif $WATERFALL; then
+  render_waterfall
+elif $DETAILED; then
+  benchmark_components
+  echo ""
+  run_hyperfine
+else
+  run_hyperfine
+fi
+
+if [[ "$UI_ENABLED" = "1" ]]; then
+  echo ""
+  ui_info "Tip" "dot benchmark --detailed"
+  ui_info "Tip" "dot benchmark --profile"
+  ui_info "Tip" "dot benchmark --waterfall"
+else
+  printf '%b\n' "\n${CYAN}Tip: Run 'dot benchmark --detailed' for per-component timing${NC}"
+  printf '%b\n' "${CYAN}     Run 'dot benchmark --profile' for zprof analysis${NC}"
+  printf '%b\n' "${CYAN}     Run 'dot benchmark --waterfall' for ASCII waterfall chart${NC}"
+fi
+printf '%b\n' "${CYAN}     Run 'dot benchmark --compare' for history${NC}\n"

package/scripts/diagnostics/conflicts.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+# Alias/Command Conflicts Report
+# Usage: dot conflicts
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=../dot/lib/ui.sh
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/../dot/lib/ui.sh"
+
+ui_init
+
+resolve_source_dir() {
+  if [[ -n "${CHEZMOI_SOURCE_DIR:-}" && -d "$CHEZMOI_SOURCE_DIR" ]]; then
+    printf "%s\n" "$CHEZMOI_SOURCE_DIR"
+    return
+  fi
+  if [[ -d "$HOME/.dotfiles" ]]; then
+    printf "%s\n" "$HOME/.dotfiles"
+    return
+  fi
+  if [[ -d "$HOME/.local/share/chezmoi" ]]; then
+    printf "%s\n" "$HOME/.local/share/chezmoi"
+    return
+  fi
+  return 1
+}
+
+src_dir=$(resolve_source_dir)
+manifest="$src_dir/scripts/diagnostics/aliases-manifest.sh"
+if [[ ! -x "$manifest" ]]; then
+  ui_err "Alias manifest" "not found"
+  exit 1
+fi
+
+tmp_manifest=$(umask 077 && mktemp)
+trap 'rm -f "$tmp_manifest"' EXIT
+bash "$manifest" >"$tmp_manifest"
+
+ui_header "Alias & Command Conflicts"
+
+ui_section "Duplicate alias definitions"
+
+dupes=$(awk -F$'\t' '{print $1}' "$tmp_manifest" | sort | uniq -d)
+if [[ -z "$dupes" ]]; then
+  ui_ok "Aliases" "No duplicate alias names"
+else
+  while IFS= read -r name; do
+    [[ -z "$name" ]] && continue
+    ui_warn "Alias" "${name} defined multiple times"
+    awk -F$'\t' -v k="$name" '$1==k {printf "  - %s (%s:%s)\n", $2, $3, $4}' "$tmp_manifest"
+  done <<<"$dupes"
+fi
+
+ui_section "Alias shadows real commands"
+shadow_found=false
+while IFS=$'\t' read -r name value _; do
+  if command -v "$name" >/dev/null 2>&1; then
+    shadow_found=true
+    ui_warn "Shadow" "${name} -> ${value} (also command)"
+  fi
+done <"$tmp_manifest"
+
+if ! $shadow_found; then
+  ui_ok "Shadowing" "No alias shadows detected"
+fi
+
+ui_section "Quick actions"
+ui_info "List aliases" "dot aliases list"
+ui_info "Regenerate cheatsheet" "dot aliases cheatsheet"