@sebastienrousseau/dotfiles 0.2.499 → 0.2.500

package/scripts/dot/commands/ai.sh

@@ -0,0 +1,416 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## Dotfiles AI Commands.
+##
+## Provides AI CLI status, setup, RAG query, and bridge commands.
+## Wraps AI CLI tools with contextual patterns and system metadata.
+## Usage: dot ai|ai-setup|ai-query|cl|copilot|gemini|kiro|sgpt|ollama|opencode|aider|autohand|vibe|qwen|zai
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=../lib/utils.sh
+source "$SCRIPT_DIR/../lib/utils.sh"
+
+dot_ui_command_banner "AI and Agents" "${1:-}"
+
+PATTERN_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/ai/patterns"
+AI_CACHE_DIR="${XDG_CACHE_HOME:-$HOME/.cache}/dotfiles/ai"
+AI_STATUS_TTL="${DOTFILES_AI_STATUS_TTL:-300}"
+AI_STATUS_CACHE_FILE="${AI_CACHE_DIR}/status.tsv"
+
+# Fallback to source tree if patterns don't exist in config (common in CI)
+if [[ ! -d "$PATTERN_DIR" ]]; then
+  _AI_SRC="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+  if [[ -d "$_AI_SRC/dot_config/ai/patterns" ]]; then
+    PATTERN_DIR="$_AI_SRC/dot_config/ai/patterns"
+  fi
+fi
+
+_show_ai_bridge_usage() {
+  echo "Usage: dot cl|copilot|gemini|kiro|autohand|vibe|qwen|zai --pattern [name] \"prompt\""
+  echo ""
+  echo "Available Patterns:"
+  ls -1 "$PATTERN_DIR" 2>/dev/null | sed 's/\.md$//' | sed 's/^/  - /' || echo "  (none)"
+}
+
+_ai_cache_fresh() {
+  local file="$1"
+  [[ -f "$file" ]] || return 1
+  local now mtime
+  now=$(date +%s)
+  mtime=$(stat -c %Y "$file" 2>/dev/null || stat -f %m "$file" 2>/dev/null || echo 0)
+  ((now - mtime < AI_STATUS_TTL))
+}
+
+_ai_extract_version() {
+  local bin="$1"
+  local output version
+  output=$("$bin" --version 2>/dev/null | head -1) || true
+  version=$(printf '%s' "$output" | sed 's/^[^0-9]*//' | sed 's/[[:space:]]*$//' | sed 's/\.$//')
+  [[ -n "$version" ]] && printf '%s\n' "$version" || printf 'installed\n'
+}
+
+_ai_refresh_status_cache() {
+  local -n ai_entries=$1
+  local tmp_file
+  tmp_file="$(mktemp)"
+  mkdir -p "$AI_CACHE_DIR"
+
+  local entry category role name bin desc present version
+  for entry in "${ai_entries[@]}"; do
+    IFS='|' read -r category role name bin desc <<<"$entry"
+    if has_command "$bin"; then
+      present=1
+      version=$(_ai_extract_version "$bin")
+    else
+      present=0
+      version=""
+    fi
+    printf '%s\t%s\t%s\n' "$bin" "$present" "$version" >>"$tmp_file"
+  done
+
+  mv "$tmp_file" "$AI_STATUS_CACHE_FILE"
+}
+
+_ai_get_cached_status() {
+  cat "$AI_STATUS_CACHE_FILE"
+}
+
+# binary -> mise package mapping
+_ai_mise_pkg() {
+  case "$1" in
+    claude) echo "npm:@anthropic-ai/claude-code" ;;
+    copilot) echo "npm:@github/copilot" ;;
+    aider) echo "pipx:aider-chat" ;;
+    opencode) echo "npm:opencode-ai" ;;
+    sgpt) echo "pipx:shell-gpt" ;;
+    gemini) echo "npm:@google/gemini-cli" ;;
+    ollama) echo "aqua:ollama/ollama" ;;
+    kiro-cli) echo "kiro-cli" ;;
+    autohand) echo "npm:autohand-cli" ;;
+    vibe) echo "pipx:mistral-vibe" ;;
+    qwen) echo "npm:@qwen-code/qwen-code" ;;
+    zai) echo "npm:@guizmo-ai/zai-cli" ;;
+    *) echo "" ;;
+  esac
+}
+
+cmd_ai_status() {
+  ui_header "AI CLI Status"
+
+  # category|role|name|binary|description
+  local -a ai_clis=(
+    "Agents (autonomous)|agent|Claude Code|claude|Anthropic CLI agent"
+    "Agents (autonomous)|agent|Copilot CLI|copilot|GitHub Copilot CLI"
+    "Coding (interactive)|coding|Aider|aider|AI pair programmer"
+    "Coding (interactive)|coding|OpenCode|opencode|Terminal coding assistant"
+    "Coding (interactive)|coding|Autohand Code|autohand|Autohand coding agent"
+    "Coding (interactive)|coding|Mistral Vibe|vibe|Mistral AI coding agent"
+    "Coding (interactive)|coding|Qwen Code|qwen|Qwen AI coding assistant"
+    "Coding (interactive)|coding|ZAI|zai|Zhipu AI coding agent"
+    "General (prompt-based)|general|Shell-GPT|sgpt|ChatGPT terminal interface"
+    "General (prompt-based)|general|Gemini CLI|gemini|Google AI CLI"
+    "Runtime (local)|local|Ollama|ollama|Local LLM runner"
+    "Cloud (platform)|cloud|Kiro CLI|kiro-cli|AWS AI assistant"
+  )
+
+  if ! _ai_cache_fresh "$AI_STATUS_CACHE_FILE"; then
+    _ai_refresh_status_cache ai_clis
+  fi
+
+  declare -A ai_present=()
+  declare -A ai_version=()
+  local cached_bin cached_present cached_version
+  while IFS=$'\t' read -r cached_bin cached_present cached_version; do
+    ai_present["$cached_bin"]="$cached_present"
+    ai_version["$cached_bin"]="$cached_version"
+  done < <(_ai_get_cached_status)
+
+  local -a installed=()
+  local -a missing=()
+  local current_category=""
+  local category role name bin desc ver
+  for entry in "${ai_clis[@]}"; do
+    IFS='|' read -r category role name bin desc <<<"$entry"
+    if [[ "$category" != "$current_category" ]]; then
+      echo ""
+      ui_section "$category"
+      current_category="$category"
+    fi
+    if [[ "${ai_present[$bin]:-0}" == "1" ]]; then
+      ver="${ai_version[$bin]:-installed}"
+      [[ "$bin" == "claude" ]] && ver="${ver%% *}"
+      ui_ok "$name" "$ver — $desc"
+      installed+=("$name|$bin|$role")
+    else
+      ui_info "$name" "— $desc (not installed)"
+      missing+=("$name|$bin")
+    fi
+  done
+
+  # Offer to install missing providers via mise
+  if [[ ${#missing[@]} -gt 0 ]] && has_command mise; then
+    echo ""
+    local _ai_install_action=""
+    if has_command gum; then
+      _ai_install_action=$(printf '%s\n' "Install all" "Choose which to install" "Skip" |
+        gum choose --header "Missing AI providers — install via mise?") || _ai_install_action=""
+    else
+      ui_info "Tip" "Install missing providers: mise install"
+      ui_info "Tip" "Or individually: mise use -g <package>@latest"
+    fi
+
+    local -a _ai_to_install=()
+    case "$_ai_install_action" in
+      "Install all")
+        _ai_to_install=("${missing[@]}")
+        ;;
+      "Choose which to install")
+        local -a _ai_pick_choices=()
+        for entry in "${missing[@]}"; do
+          IFS='|' read -r name bin <<<"$entry"
+          _ai_pick_choices+=("$name")
+        done
+        local _ai_picked
+        _ai_picked=$(printf '%s\n' "${_ai_pick_choices[@]}" |
+          gum choose --no-limit --header "Select providers to install (Space to toggle, Enter to confirm)") || _ai_picked=""
+        if [[ -n "$_ai_picked" ]]; then
+          while IFS= read -r selected; do
+            [[ -z "$selected" ]] && continue
+            for entry in "${missing[@]}"; do
+              IFS='|' read -r name bin <<<"$entry"
+              if [[ "$name" == "$selected" ]]; then
+                _ai_to_install+=("$entry")
+              fi
+            done
+          done <<<"$_ai_picked"
+        fi
+        ;;
+    esac
+
+    if [[ ${#_ai_to_install[@]} -gt 0 ]]; then
+      echo ""
+      for entry in "${_ai_to_install[@]}"; do
+        IFS='|' read -r name bin <<<"$entry"
+        local pkg
+        pkg=$(_ai_mise_pkg "$bin")
+        if [[ -n "$pkg" ]]; then
+          if has_command gum; then
+            if gum spin --spinner dot --title "Installing $name ($pkg)" -- \
+              mise use -g "$pkg@latest" 2>&1; then
+              ui_ok "$name" "installed"
+            else
+              ui_warn "$name" "install failed (continuing)"
+            fi
+          else
+            ui_info "Installing" "$name via mise ($pkg)"
+            mise use -g "$pkg@latest" 2>&1 || ui_warn "$name" "install failed (continuing)"
+          fi
+        fi
+      done
+      # Invalidate cache after installs
+      rm -f "$AI_STATUS_CACHE_FILE"
+      echo ""
+      ui_ok "Done" "Run 'dot ai' again to see updated status"
+    fi
+  fi
+
+  echo ""
+  if [ ${#installed[@]} -eq 0 ]; then
+    ui_warn "No AI CLIs installed"
+  elif has_command gum; then
+    ui_info "Launch" "Select an AI CLI to start"
+    local -a choices=()
+    for entry in "${installed[@]}"; do
+      IFS='|' read -r name bin role <<<"$entry"
+      choices+=("$(printf '%-16s — %s' "$name" "$role")")
+    done
+    local pick
+    pick=$(printf '%s\n' "${choices[@]}" | gum choose --header "Select an AI CLI") || true
+    if [ -n "$pick" ]; then
+      pick="${pick%% — *}"
+      pick="${pick%"${pick##*[![:space:]]}"}"
+      for entry in "${installed[@]}"; do
+        IFS='|' read -r name bin role <<<"$entry"
+        if [ "$name" = "$pick" ]; then
+          echo ""
+          ui_info "Starting" "$name ($bin)"
+          exec "$bin"
+        fi
+      done
+    fi
+  else
+    ui_info "Tip" "Install gum for interactive launcher: mise use -g gum"
+  fi
+}
+
+cmd_ai_setup() {
+  run_script "scripts/ops/ai-setup.sh" "AI setup script" "$@"
+}
+
+cmd_ai_query() {
+  run_script "dot_local/bin/executable_dot-ai" "AI RAG script" "$@"
+}
+
+run_ai_with_context() {
+  local tool="$1"
+  shift
+  local pattern_name=""
+  local prompt=""
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --help | -h)
+        _show_ai_bridge_usage
+        exit 0
+        ;;
+      --pattern | -p)
+        pattern_name="$2"
+        shift 2
+        ;;
+      *)
+        prompt="$1"
+        shift
+        ;;
+    esac
+  done
+
+  if [[ -z "$prompt" ]]; then
+    _show_ai_bridge_usage
+    exit 1
+  fi
+
+  local system_context=""
+  if [[ -n "$pattern_name" ]]; then
+    local pattern_file="$PATTERN_DIR/${pattern_name}.md"
+    if [[ -f "$pattern_file" ]]; then
+      system_context=$(cat "$pattern_file")
+    else
+      ui_err "Pattern not found" "$pattern_name"
+      exit 1
+    fi
+  fi
+
+  # Inject dynamic system metadata
+  local metadata
+  metadata="## System Metadata
+- OS: $(uname -s) $(uname -r)
+- Arch: $(uname -m)
+- Date: $(date -u)"
+
+  local full_prompt="${system_context}
+
+${metadata}
+
+## User Request
+${prompt}"
+
+  # Resolve the binary name for the tool
+  local tool_bin="$tool"
+  case "$tool" in
+    cl) tool_bin="claude" ;;
+    kiro) tool_bin="kiro-cli" ;;
+  esac
+
+  # Check if the tool is installed; offer mise install if not
+  if ! has_command "$tool_bin"; then
+    local mise_pkg
+    mise_pkg=$(_ai_mise_pkg "$tool_bin")
+    if [[ -n "$mise_pkg" ]] && has_command mise; then
+      ui_warn "$tool" "not installed"
+      local do_install=""
+      if has_command gum; then
+        do_install=$(gum confirm "Install $tool via mise ($mise_pkg)?" && echo "yes" || echo "no")
+      else
+        printf "Install %s via mise (%s)? [y/N] " "$tool" "$mise_pkg"
+        read -r do_install
+        case "$do_install" in y | Y | yes) do_install="yes" ;; *) do_install="no" ;; esac
+      fi
+      if [[ "$do_install" == "yes" ]]; then
+        ui_info "Installing" "$tool via mise ($mise_pkg)"
+        mise use -g "$mise_pkg@latest" 2>&1 || {
+          ui_err "$tool" "installation failed"
+          exit 1
+        }
+        rm -f "$AI_STATUS_CACHE_FILE"
+      else
+        ui_err "$tool" "not installed — install with: mise use -g $mise_pkg@latest"
+        exit 1
+      fi
+    else
+      ui_err "$tool" "not installed and mise not available"
+      exit 1
+    fi
+  fi
+
+  ui_info "Executing $tool with pattern: ${pattern_name:-none}"
+
+  case "$tool" in
+    cl | claude)
+      printf "%s" "$full_prompt" | claude
+      ;;
+    copilot)
+      copilot -sp "$full_prompt"
+      ;;
+    gemini)
+      printf "%s" "$full_prompt" | gemini chat
+      ;;
+    kiro | kiro-cli)
+      printf "%s" "$full_prompt" | kiro-cli chat
+      ;;
+    sgpt)
+      printf "%s" "$full_prompt" | sgpt --chat shell-gpt
+      ;;
+    ollama)
+      printf "%s" "$full_prompt" | ollama run llama3.2
+      ;;
+    opencode)
+      printf "%s" "$full_prompt" | opencode query
+      ;;
+    aider)
+      printf "%s" "$full_prompt" | aider --msg "-"
+      ;;
+    autohand)
+      printf "%s" "$full_prompt" | autohand chat
+      ;;
+    vibe)
+      printf "%s" "$full_prompt" | vibe chat
+      ;;
+    qwen)
+      printf "%s" "$full_prompt" | qwen chat
+      ;;
+    zai)
+      printf "%s" "$full_prompt" | zai chat
+      ;;
+    *)
+      ui_err "Unsupported tool" "$tool"
+      exit 1
+      ;;
+  esac
+}
+
+# Dispatch
+case "${1:-}" in
+  ai)
+    shift
+    cmd_ai_status "$@"
+    ;;
+  ai-setup)
+    shift
+    cmd_ai_setup "$@"
+    ;;
+  ai-query)
+    shift
+    cmd_ai_query "$@"
+    ;;
+  cl | claude | copilot | gemini | kiro | sgpt | ollama | opencode | aider | autohand | vibe | qwen | zai)
+    tool="$1"
+    shift
+    run_ai_with_context "$tool" "$@"
+    ;;
+  *)
+    echo "Unknown ai command: ${1:-}" >&2
+    exit 1
+    ;;
+esac

package/scripts/dot/commands/aliases.sh

@@ -0,0 +1,250 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+# 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 ""
+      printf "  %-18s %-42s %s\n" "Name" "Value" "Source"
+      echo "  $(printf '%.18s' '------------------') $(printf '%.42s' '------------------------------------------') -------------------------"
+      emit_alias_manifest | sort -t $'\t' -k1,1 | while IFS=$'\t' read -r name value file line; do
+        printf "  %-18s %-42s %s:%s\n" "$name" "${value:0:42}" "${file##*/}" "$line"
+      done
+      ;;
+    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
+      printf "%s\n" "$results" | while IFS=$'\t' read -r name value file line; do
+        printf "  %-18s %-42s %s:%s\n" "$name" "${value:0:42}" "$file" "$line"
+      done
+      ;;
+    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)
+      ui_header "Alias Cheatsheet"
+      local src_dir out
+      src_dir="$(require_source_dir)"
+      out="$src_dir/docs/ALIASES_CHEATSHEET.md"
+      bash "$src_dir/scripts/diagnostics/aliases-cheatsheet.sh" >"$out"
+      ui_ok "Generated" "$out"
+      ;;
+    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"
+}