@sebastienrousseau/dotfiles 0.2.520 → 0.2.521

package/scripts/dot/commands/aliases.sh

@@ -1,277 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: Apache-2.0 OR MIT
-# Copyright (c) 2015-2026 Sebastien Rousseau
-# Dotfiles CLI - Aliases Commands (extracted from tools.sh)
-# aliases list|search|why|stats|cheatsheet|tiers, alias-check
-
-set -euo pipefail
-
-# Guard: only define functions, do not execute on source
-# These functions are sourced by tools.sh for dispatch.
-
-alias_manifest_path() {
-  local src_dir
-  src_dir="$(require_source_dir)"
-  printf "%s\n" "$src_dir/scripts/diagnostics/aliases-manifest.sh"
-}
-
-emit_alias_manifest() {
-  local manifest
-  manifest="$(alias_manifest_path)"
-  if [[ ! -x "$manifest" ]]; then
-    die "Alias manifest script not found: $manifest"
-  fi
-  bash "$manifest"
-}
-
-cmd_aliases() {
-  local subcommand="${1:-list}"
-  shift || true
-
-  alias_tier_enabled() {
-    local csv="${1:-all}"
-    local token="${2:-}"
-    if [[ "$csv" == "all" ]]; then
-      return 0
-    fi
-    [[ ",${csv}," == *",${token},"* ]]
-  }
-
-  case "$subcommand" in
-    list)
-      ui_header "Aliases"
-      echo ""
-      ui_table_begin "Name" "Value" "Source"
-      while IFS=$'\t' read -r name value file line; do
-        ui_table_add "$name" "${value:0:60}" "${file##*/}:$line"
-      done < <(emit_alias_manifest | sort -t $'\t' -k1,1)
-      ui_table_end
-      ;;
-    search)
-      local query="${1:-}"
-      if [[ -z "$query" ]]; then
-        die "Usage: dot aliases search <term>"
-      fi
-      ui_header "Alias Search"
-      ui_info "Query" "$query"
-      echo ""
-      local results
-      results="$(emit_alias_manifest | rg -i "$query" || true)"
-      if [[ -z "$results" ]]; then
-        ui_warn "No matches" "$query"
-        return 1
-      fi
-      ui_table_begin "Name" "Value" "Source"
-      while IFS=$'\t' read -r name value file line; do
-        ui_table_add "$name" "${value:0:60}" "$file:$line"
-      done <<<"$results"
-      ui_table_end
-      ;;
-    why)
-      local alias_name="${1:-}"
-      if [[ -z "$alias_name" ]]; then
-        die "Usage: dot aliases why <alias>"
-      fi
-      ui_header "Alias Details"
-      ui_info "Alias" "$alias_name"
-      echo ""
-      local rows
-      rows="$(emit_alias_manifest | awk -F'\t' -v a="$alias_name" '$1==a')"
-      local src_dir deprecations_file deprecation
-      src_dir="$(require_source_dir)"
-      deprecations_file="$src_dir/scripts/dot/data/alias-deprecations.tsv"
-      if [[ -n "$rows" ]]; then
-        printf "%s\n" "$rows" | while IFS=$'\t' read -r name value file line; do
-          ui_ok "$name" "${value}"
-          printf "    source: %s:%s\n" "$file" "$line"
-        done
-      fi
-      if [[ -f "$deprecations_file" ]]; then
-        deprecation="$(awk -F'\t' -v a="$alias_name" 'BEGIN{IGNORECASE=0} $1 !~ /^#/ && $1==a {print $0; exit}' "$deprecations_file")"
-        if [[ -n "$deprecation" ]]; then
-          local _a replacement remove_in note
-          IFS=$'\t' read -r _a replacement remove_in note <<<"$deprecation"
-          echo ""
-          ui_warn "Deprecated" "yes"
-          ui_info "Replacement" "$replacement"
-          ui_info "Remove In" "$remove_in"
-          ui_info "Note" "$note"
-        fi
-      fi
-      if [[ -z "$rows" && -z "$deprecation" ]]; then
-        ui_warn "Alias" "not found: $alias_name"
-        return 1
-      fi
-      ;;
-    stats)
-      local histfile="${HISTFILE:-$HOME/.zsh_history}"
-      if [[ ! -f "$histfile" ]]; then
-        die "History file not found: $histfile"
-      fi
-      ui_header "Alias Usage (History)"
-      ui_info "History file" "$histfile"
-      echo ""
-      local tmp_aliases
-      tmp_aliases="$(umask 077 && mktemp)"
-      trap 'rm -f "$tmp_aliases"' RETURN
-      emit_alias_manifest | awk -F'\t' '{print $1}' | sort -u >"$tmp_aliases"
-      awk -v aliases_file="$tmp_aliases" '
-        BEGIN {
-          while ((getline < aliases_file) > 0) alias[$1]=1
-        }
-        {
-          line=$0
-          sub(/^:[[:space:]]*[0-9]+:[0-9]+;/, "", line) # zsh EXTENDED_HISTORY prefix
-          split(line, parts, /[[:space:]]+/)
-          cmd=parts[1]
-          if (cmd in alias) count[cmd]++
-        }
-        END {
-          for (k in count) printf "%7d  %s\n", count[k], k
-        }
-      ' "$histfile" | sort -nr | head -20
-      rm -f "$tmp_aliases"
-      ;;
-    cheatsheet)
-      # Destination defaults to the checkout's docs/ but can be
-      # redirected with `--output PATH` (or `-` for stdout). The
-      # hardcoded path made this the one subcommand that could not be
-      # exercised without writing into the working tree:
-      # require_source_dir() resolves from the location of the lib that
-      # was sourced, so it always pointed at the real repo no matter
-      # how the sandbox redirected $HOME/.dotfiles.
-      ui_header "Alias Cheatsheet"
-      local src_dir out=""
-      src_dir="$(require_source_dir)"
-      while (($#)); do
-        case "$1" in
-          --output | -o)
-            out="${2:-}"
-            [[ -n "$out" ]] || die "Usage: dot aliases cheatsheet [--output PATH|-]"
-            shift 2
-            ;;
-          *)
-            die "Unknown option for cheatsheet: $1"
-            ;;
-        esac
-      done
-      out="${out:-$src_dir/docs/ALIASES_CHEATSHEET.md}"
-      if [[ "$out" == "-" ]]; then
-        bash "$src_dir/scripts/diagnostics/aliases-cheatsheet.sh"
-      else
-        mkdir -p "$(dirname "$out")"
-        bash "$src_dir/scripts/diagnostics/aliases-cheatsheet.sh" >"$out"
-        ui_ok "Generated" "$out"
-      fi
-      ;;
-    tiers)
-      local profile ecosystems security_mode dangerous buckets
-      profile="${DOTFILES_ALIAS_PROFILE:-standard}"
-      ecosystems="${DOTFILES_ALIAS_ECOSYSTEMS:-all}"
-      buckets="${DOTFILES_ALIAS_BUCKETS:-system,svn}"
-      security_mode="${DOTFILES_SECURITY_MODE:-standard}"
-      dangerous="${DOTFILES_ENABLE_DANGEROUS_ALIASES:-0}"
-
-      ui_header "Alias Tiers"
-      ui_info "Profile" "$profile"
-      ui_info "Ecosystems" "$ecosystems"
-      ui_info "Buckets" "$buckets"
-      ui_info "Security Mode" "$security_mode"
-      ui_info "Dangerous Aliases" "$dangerous"
-      echo ""
-
-      ui_header "Core (Always Loaded)"
-      ui_ok "navigation" "cd, clear, default, diagnostics, ps"
-      ui_ok "dev core" "git, editor, configuration, modern"
-      ui_ok "cross-platform tooling" "docker, archives, disk-usage, rsync"
-      echo ""
-
-      ui_header "Ecosystems (Lazy)"
-      if alias_tier_enabled "$ecosystems" "python"; then
-        ui_ok "python" "enabled"
-      else
-        ui_warn "python" "disabled"
-      fi
-      if alias_tier_enabled "$ecosystems" "node"; then
-        ui_ok "node" "enabled"
-      else
-        ui_warn "node" "disabled"
-      fi
-      if alias_tier_enabled "$ecosystems" "rust"; then
-        ui_ok "rust" "enabled"
-      else
-        ui_warn "rust" "disabled"
-      fi
-      if alias_tier_enabled "$ecosystems" "network"; then
-        ui_ok "network" "enabled"
-      else
-        ui_warn "network" "disabled"
-      fi
-      if alias_tier_enabled "$ecosystems" "legacy"; then
-        ui_ok "legacy" "enabled"
-      else
-        ui_warn "legacy" "disabled"
-      fi
-      if alias_tier_enabled "$buckets" "system"; then
-        ui_ok "system bucket" "enabled"
-      else
-        ui_warn "system bucket" "disabled"
-      fi
-      if alias_tier_enabled "$buckets" "svn"; then
-        ui_ok "svn bucket" "enabled"
-      else
-        ui_warn "svn bucket" "disabled"
-      fi
-      ;;
-    *)
-      die "Unknown aliases subcommand: $subcommand"
-      ;;
-  esac
-}
-
-cmd_alias_check() {
-  ui_header "Alias Check"
-  echo ""
-
-  local alias_file="${HOME}/.config/shell/90-ux-aliases.sh"
-  local zshrc_file="${HOME}/.config/zsh/.zshrc"
-  local auto_ls_file="${HOME}/.config/shell/custom/auto_ls.zsh"
-  local missing=0
-
-  if [[ -f "$alias_file" ]]; then
-    ui_ok "Aliases file" "$alias_file"
-  else
-    ui_err "Aliases file missing" "$alias_file"
-    missing=1
-  fi
-
-  local required_aliases=(c q e l ll la lr lra lt lta h a d _ i)
-  local a
-  for a in "${required_aliases[@]}"; do
-    if grep -Eq "^[[:space:]]*alias[[:space:]]+${a}=" "$alias_file" 2>/dev/null; then
-      ui_ok "alias ${a}" "present"
-    else
-      ui_warn "alias ${a}" "missing"
-      missing=1
-    fi
-  done
-
-  if [[ -f "$auto_ls_file" ]]; then
-    ui_ok "auto-ls hook" "$auto_ls_file"
-  else
-    ui_warn "auto-ls hook" "missing"
-  fi
-
-  if [[ -f "$zshrc_file" ]] && rg -q "auto_ls.zsh" "$zshrc_file"; then
-    ui_ok "auto-ls sourced" "$zshrc_file"
-  else
-    ui_warn "auto-ls sourced" "not referenced in zshrc"
-  fi
-
-  echo ""
-  if [[ "$missing" -eq 1 ]]; then
-    ui_warn "Result" "Some aliases are missing; re-run 'chezmoi apply' and open a new shell."
-    return 1
-  fi
-  ui_ok "Result" "All core aliases present"
-}

package/scripts/dot/commands/appearance.sh

@@ -1,110 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: Apache-2.0 OR MIT
-# Copyright (c) 2015-2026 Sebastien Rousseau
-# Dotfiles CLI - Appearance Commands
-# theme, wallpaper, fonts, tune
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=../../../lib/dot/utils.sh
-source "$SCRIPT_DIR/../../../lib/dot/utils.sh"
-
-dot_ui_command_banner "Appearance" "${1:-}"
-
-usage() {
-  cat <<'EOF'
-Usage: appearance.sh <command> [args...]
-
-Commands:
-  theme, wallpaper, fonts, tune
-EOF
-}
-
-cmd_theme() {
-  run_script "scripts/theme/switch.sh" "Theme switcher" "$@"
-}
-
-cmd_wallpaper() {
-  case "${1:-sync}" in
-    sync)
-      shift 2>/dev/null || true
-      run_script "scripts/theme/wallpaper-sync.sh" "Wallpaper sync script" "$@"
-      ;;
-    rotate)
-      shift
-      run_script "scripts/theme/wallpaper-rotate.sh" "Wallpaper rotate script" "$@"
-      ;;
-    *)
-      run_script "scripts/theme/wallpaper-sync.sh" "Wallpaper sync script" "$@"
-      ;;
-  esac
-}
-
-cmd_fonts() {
-  local sub="${1:-install}"
-  case "$sub" in
-    patch)
-      shift
-      run_script "scripts/fonts/patch-fonts.sh" "Font patch helper" "$@"
-      ;;
-    install | "")
-      [[ "$sub" == install ]] && shift || true
-      run_script "scripts/fonts/install-nerd-fonts.sh" "Font install script" "$@"
-      ;;
-    *)
-      run_script "scripts/fonts/install-nerd-fonts.sh" "Font install script" "$@"
-      ;;
-  esac
-}
-
-cmd_tune() {
-  local src_dir
-  local platform
-  src_dir="$(require_source_dir)"
-  platform="$(dot_platform_id)"
-
-  case "$platform" in
-    macos)
-      exec bash "$src_dir/scripts/tuning/macos.sh" "$@"
-      ;;
-    linux | wsl)
-      exec bash "$src_dir/scripts/tuning/linux.sh" "$@"
-      ;;
-    *)
-      echo "OS tuning not supported on this platform."
-      exit 1
-      ;;
-  esac
-}
-
-# Dispatch
-case "${1:-}" in
-  --help | -h | help)
-    usage
-    ;;
-  "")
-    usage
-    exit 1
-    ;;
-  theme)
-    shift
-    cmd_theme "$@"
-    ;;
-  wallpaper)
-    shift
-    cmd_wallpaper "$@"
-    ;;
-  fonts)
-    shift
-    cmd_fonts "$@"
-    ;;
-  tune)
-    shift
-    cmd_tune "$@"
-    ;;
-  *)
-    echo "Unknown appearance command: ${1:-}" >&2
-    exit 1
-    ;;
-esac

package/scripts/dot/commands/completion.sh

@@ -1,171 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: Apache-2.0 OR MIT
-# Copyright (c) 2015-2026 Sebastien Rousseau
-## `dot completion <bash|zsh|fish|nu>` — emit shell completion for `dot`,
-## generated from the canonical _dot_help_specs registry in bin/dot. Using one
-## source of truth keeps all four shells in sync (the previously hand-maintained
-## fish/nushell lists drifted and referenced non-existent commands).
-##
-## Usage:
-##   dot completion bash  >> ~/.bashrc.d/dot.bash
-##   dot completion zsh   > "${fpath[1]}/_dot"
-##   dot completion fish  > ~/.config/fish/completions/dot.fish
-##   dot completion nu    >> ~/.config/nushell/completions.nu
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=../../../lib/dot/utils.sh
-source "$SCRIPT_DIR/../../../lib/dot/utils.sh"
-
-_completion_dot_cli() {
-  local src
-  src="$(resolve_source_dir)"
-  printf '%s/bin/dot\n' "$src"
-}
-
-# Emit "name<TAB>description" for every top-level command (a _dot_help_specs
-# field-2 entry with no space; entries containing a space are subcommands).
-# Strip ": ' from descriptions so they can't break any shell's quoting.
-_completion_commands() {
-  local cli
-  cli="$(_completion_dot_cli)"
-  awk -F'|' '
-    /_dot_help_specs\(\)/ { in_func = 1; next }
-    in_func && /cat <<'\''EOF'\''/ { in_block = 1; next }
-    in_block && /^EOF$/ { exit }
-    in_block && NF >= 3 && $2 !~ / / {
-      name = $2
-      # Description = fields 3..NF-1 rejoined: registry descriptions can
-      # contain "|" (e.g. "--ai|-A") and the last field is the hint.
-      desc = $3
-      for (i = 4; i < NF; i++) desc = desc "|" $i
-      gsub(/^[ \t]+|[ \t]+$/, "", name)
-      gsub(/^[ \t]+|[ \t]+$/, "", desc)
-      gsub(/[":\047]/, "", desc)
-      if (name != "") print name "\t" desc
-    }
-  ' "$cli"
-}
-
-# Emit "parent<TAB>child<TAB>description" for every subcommand (a field-2
-# entry that contains a space, e.g. "theme list" -> parent=theme child=list).
-_completion_subcommands() {
-  local cli
-  cli="$(_completion_dot_cli)"
-  awk -F'|' '
-    /_dot_help_specs\(\)/ { in_func = 1; next }
-    in_func && /cat <<'\''EOF'\''/ { in_block = 1; next }
-    in_block && /^EOF$/ { exit }
-    in_block && NF >= 3 && $2 ~ / / {
-      full = $2
-      desc = $3
-      for (i = 4; i < NF; i++) desc = desc "|" $i
-      gsub(/^[ \t]+|[ \t]+$/, "", full)
-      gsub(/^[ \t]+|[ \t]+$/, "", desc)
-      gsub(/[":\047]/, "", desc)
-      parent = full; sub(/ .*/, "", parent)
-      child = full; sub(/^[^ ]+ /, "", child)
-      if (parent != "" && child != "") print parent "\t" child "\t" desc
-    }
-  ' "$cli"
-}
-
-# The printf templates below are the *text of the generated script*;
-# `$cur`, `$prev`, `$commands` must reach the output unexpanded.
-# shellcheck disable=SC2016
-gen_bash() {
-  local names parent child desc
-  names="$(_completion_commands | cut -f1 | tr '\n' ' ')"
-  printf '# dot bash completion — generated by: dot completion bash\n'
-  printf '# Source this file, or install it to a bash-completion completions dir.\n'
-  printf '_dot_completions() {\n'
-  printf '  local cur prev commands\n'
-  printf '  COMPREPLY=()\n'
-  printf '  cur="${COMP_WORDS[COMP_CWORD]}"\n'
-  printf '  prev="${COMP_WORDS[COMP_CWORD - 1]}"\n'
-  printf "  commands='%s'\n" "${names% }"
-  printf '  case "$prev" in\n'
-  printf '    dot)\n'
-  printf '      COMPREPLY=($(compgen -W "$commands" -- "$cur"))\n'
-  printf '      return 0\n'
-  printf '      ;;\n'
-  # One case arm per parent command that has subcommands.
-  while IFS=$'\t' read -r parent child desc; do
-    printf '%s\t%s\n' "$parent" "$child"
-  done < <(_completion_subcommands) |
-    awk -F'\t' '{ subs[$1] = subs[$1] (subs[$1] == "" ? "" : " ") $2 }
-      END { for (p in subs) printf "%s\t%s\n", p, subs[p] }' |
-    LC_ALL=C sort |
-    while IFS=$'\t' read -r parent child; do
-      printf '    %s)\n' "$parent"
-      printf '      COMPREPLY=($(compgen -W "%s" -- "$cur"))\n' "$child"
-      printf '      return 0\n'
-      printf '      ;;\n'
-    done
-  printf '  esac\n'
-  printf '  COMPREPLY=($(compgen -f -- "$cur"))\n'
-  printf '}\n'
-  printf 'complete -F _dot_completions dot\n'
-}
-
-gen_zsh() {
-  local name desc
-  printf '#compdef dot\n# generated by: dot completion zsh\n'
-  printf '_dot() {\n  local -a commands\n  commands=(\n'
-  while IFS=$'\t' read -r name desc; do
-    printf "    '%s:%s'\n" "$name" "$desc"
-  done < <(_completion_commands)
-  printf '  )\n  _describe '\''command'\'' commands\n}\n_dot "$@"\n'
-}
-
-gen_fish() {
-  local name desc
-  printf '# dot fish completion — generated by: dot completion fish\n'
-  printf 'complete -c dot -f\n'
-  while IFS=$'\t' read -r name desc; do
-    printf 'complete -c dot -n "__fish_use_subcommand" -a %s -d "%s"\n' "$name" "$desc"
-  done < <(_completion_commands)
-  local parent child
-  while IFS=$'\t' read -r parent child desc; do
-    printf 'complete -c dot -n "__fish_seen_subcommand_from %s" -a %s -d "%s"\n' \
-      "$parent" "$child" "$desc"
-  done < <(_completion_subcommands)
-}
-
-gen_nu() {
-  local name desc
-  printf '# dot nushell completion — generated by: dot completion nu\n'
-  printf 'export extern dot [\n  command?: string@dot_commands\n  ...args: string\n]\n'
-  printf 'def dot_commands [] {\n  [\n'
-  while IFS=$'\t' read -r name desc; do
-    printf '    { value: "%s", description: "%s" }\n' "$name" "$desc"
-  done < <(_completion_commands)
-  printf '  ]\n}\n'
-}
-
-usage() {
-  cat <<'USAGE'
-Usage: dot completion <bash|zsh|fish|nu>
-
-Generate shell completion for `dot` from the canonical command registry.
-
-  dot completion bash  >> ~/.bashrc.d/dot.bash
-  dot completion zsh   > "${fpath[1]}/_dot"
-  dot completion fish  > ~/.config/fish/completions/dot.fish
-  dot completion nu    >> ~/.config/nushell/completions.nu
-USAGE
-}
-
-# Dispatch: $1 is the command name ("completion"); $2 is the target shell.
-case "${2:-}" in
-  bash) gen_bash ;;
-  zsh) gen_zsh ;;
-  fish) gen_fish ;;
-  nu | nushell) gen_nu ;;
-  "" | -h | --help | help) usage ;;
-  *)
-    echo "dot completion: unknown shell '${2}' (want: bash|zsh|fish|nu)" >&2
-    exit 1
-    ;;
-esac