@sebastienrousseau/dotfiles 0.2.481 → 0.2.500

package/dot_local/bin/executable_dot_completion

@@ -1,3 +1,5 @@
+#!/usr/bin/env zsh
+# shellcheck shell=bash disable=SC2034
 #compdef dot
 
 # Zsh completion for the dot CLI

package/dot_local/bin/executable_dtags

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## dtags — List sorted tags for a Docker Hub image.
+##
+## # Usage
+##   dtags python
+##   dtags node
+##   dtags ubuntu
+
+set -euo pipefail
+
+for cmd in curl jq; do
+  if ! command -v "$cmd" &>/dev/null; then
+    echo "dtags requires $cmd" >&2
+    exit 1
+  fi
+done
+
+image="${1:-}"
+
+if [[ -z "${image}" ]]; then
+  echo "Usage: dtags <image>" >&2
+  exit 1
+fi
+
+curl --silent \
+  "https://registry.hub.docker.com/v2/repositories/library/${image}/tags?page_size=1000" |
+  jq -r ".results[].name" | sort -V 2>/dev/null || sort -t. -k1,1n -k2,2n -k3,3n

package/dot_local/bin/executable_epoch

@@ -1,61 +1,66 @@
 #!/usr/bin/env bash
-# Epoch time converter
-# Usage: epoch [timestamp] | epoch -r <date>
+# shellcheck disable=SC2034
+## Epoch Converter — Convert between Unix timestamps and human-readable dates.
+##
+## Bidirectional conversion between epoch timestamps and date strings.
+## Supports both seconds and milliseconds precision.
+##
+## # Requirements
+## - date: Core utility (coreutils or macOS built-in)
+##
+## # Usage
+## epoch                       # Show current epoch time
+## epoch -m                    # Show current epoch in milliseconds
+## epoch 1234567890            # Convert epoch to date
+## epoch -r "2024-01-15"       # Convert date string to epoch
+##
+## # Platform Notes
+## - Linux: Uses date -d for parsing
+## - macOS: Uses date -j -f for parsing
 
 set -euo pipefail
 
-usage() {
-  echo "Usage: epoch [OPTIONS] [VALUE]"
-  echo ""
-  echo "Options:"
-  echo "  -r, --reverse    Convert date string to epoch"
-  echo "  -m, --millis     Use milliseconds precision"
-  echo "  -h, --help       Show this help"
-  echo ""
-  echo "Examples:"
-  echo "  epoch                  # Current epoch time"
-  echo "  epoch 1234567890       # Convert epoch to date"
-  echo "  epoch -r '2024-01-01'  # Convert date to epoch"
-  echo "  epoch -m               # Current epoch in milliseconds"
-}
+# --- UI Theme ---
+PURPLE='\033[38;5;141m'
+CYAN='\033[38;5;86m'
+GRAY='\033[38;5;244m'
+NC='\033[0m'
 
 REVERSE=false
 MILLIS=false
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    -r|--reverse) REVERSE=true; shift ;;
-    -m|--millis) MILLIS=true; shift ;;
-    -h|--help) usage; exit 0 ;;
-    -*) echo "Unknown option: $1"; usage; exit 1 ;;
+    -r | --reverse)
+      REVERSE=true
+      shift
+      ;;
+    -m | --millis)
+      MILLIS=true
+      shift
+      ;;
+    -h | --help)
+      printf '%b\n' "${PURPLE}epoch${NC} ${GRAY}convert to/from unix time${NC}"
+      echo "Usage: epoch [options] [value]"
+      echo "  -r, --reverse   Convert date string to epoch"
+      echo "  -m, --millis    Use milliseconds"
+      exit 0
+      ;;
     *) break ;;
   esac
 done
 
 if $REVERSE; then
-  # Convert date to epoch
-  DATE_STR="${1:-}"
-  if [[ -z "$DATE_STR" ]]; then
-    echo "Error: Date string required for reverse conversion"
-    exit 1
-  fi
-  if $MILLIS; then
-    date -d "$DATE_STR" +%s%3N 2>/dev/null || date -j -f "%Y-%m-%d" "$DATE_STR" +%s000 2>/dev/null
-  else
-    date -d "$DATE_STR" +%s 2>/dev/null || date -j -f "%Y-%m-%d" "$DATE_STR" +%s 2>/dev/null
-  fi
+  STR="${1:-}"
+  [[ -z "$STR" ]] && exit 1
+  date -d "$STR" +%s 2>/dev/null || date -j -f "%Y-%m-%d" "$STR" +%s 2>/dev/null
 elif [[ $# -gt 0 ]]; then
-  # Convert epoch to date
   EPOCH="$1"
-  # Handle milliseconds
-  if [[ ${#EPOCH} -gt 10 ]]; then
-    EPOCH=$((EPOCH / 1000))
-  fi
+  [[ ${#EPOCH} -gt 10 ]] && EPOCH=$((EPOCH / 1000))
   date -d "@$EPOCH" 2>/dev/null || date -r "$EPOCH" 2>/dev/null
 else
-  # Current time
   if $MILLIS; then
-    date +%s%3N 2>/dev/null || echo "$(date +%s)000"
+    date +%s%3N
   else
     date +%s
   fi

package/dot_local/bin/executable_extract

@@ -1,108 +1,41 @@
-#!/usr/bin/env bash
-# Universal archive extraction
-# Usage: extract <file> [destination]
+#!/bin/sh
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+# Universal archive extractor with UI (gum) and self-healing (nix) fallback.
 
-set -euo pipefail
+set -eu
 
-if [[ $# -lt 1 ]]; then
-  echo "Usage: extract <file> [destination]"
-  echo "Supported formats: tar, tar.gz, tar.bz2, tar.xz, tar.zst, gz, bz2, xz, zst, zip, rar, 7z, deb, rpm"
+# R5: validate input
+if [ -z "${1:-}" ]; then
+  echo "Usage: extract <archive>" >&2
   exit 1
 fi
 
-FILE="$1"
-DEST="${2:-.}"
-
-if [[ ! -f "$FILE" ]]; then
-  echo "Error: File not found: $FILE"
-  exit 1
-fi
-
-# Create destination if needed
-mkdir -p "$DEST"
-
-echo "Extracting: $FILE"
-
-case "$FILE" in
-  *.tar.bz2|*.tbz2)
-    tar xjf "$FILE" -C "$DEST"
-    ;;
-  *.tar.gz|*.tgz)
-    tar xzf "$FILE" -C "$DEST"
-    ;;
-  *.tar.xz|*.txz)
-    tar xJf "$FILE" -C "$DEST"
-    ;;
-  *.tar.zst|*.tzst)
-    tar --zstd -xf "$FILE" -C "$DEST"
-    ;;
-  *.tar)
-    tar xf "$FILE" -C "$DEST"
-    ;;
-  *.bz2)
-    bunzip2 -k "$FILE"
-    ;;
-  *.gz)
-    gunzip -k "$FILE"
-    ;;
-  *.xz)
-    unxz -k "$FILE"
-    ;;
-  *.zst)
-    unzstd -k "$FILE"
-    ;;
-  *.zip|*.jar|*.war|*.ear)
-    unzip -q "$FILE" -d "$DEST"
-    ;;
-  *.rar)
-    if command -v unrar >/dev/null 2>&1; then
-      unrar x "$FILE" "$DEST/"
-    elif command -v 7z >/dev/null 2>&1; then
-      7z x "$FILE" -o"$DEST"
-    else
-      echo "Error: unrar or 7z required for .rar files"
-      exit 1
-    fi
-    ;;
-  *.7z)
-    if command -v 7z >/dev/null 2>&1; then
-      7z x "$FILE" -o"$DEST"
-    else
-      echo "Error: 7z required for .7z files"
-      exit 1
-    fi
-    ;;
-  *.deb)
-    if command -v dpkg-deb >/dev/null 2>&1; then
-      dpkg-deb -x "$FILE" "$DEST"
-    elif command -v ar >/dev/null 2>&1; then
-      cd "$DEST" && ar x "$FILE"
-    else
-      echo "Error: dpkg-deb or ar required for .deb files"
-      exit 1
-    fi
-    ;;
-  *.rpm)
-    if command -v rpm2cpio >/dev/null 2>&1; then
-      cd "$DEST" && rpm2cpio "$FILE" | cpio -idmv
-    else
-      echo "Error: rpm2cpio required for .rpm files"
-      exit 1
-    fi
-    ;;
-  *.Z)
-    uncompress "$FILE"
-    ;;
-  *.lzma)
-    unlzma -k "$FILE"
-    ;;
-  *.lz4)
-    lz4 -d "$FILE"
-    ;;
+# If tool is missing, use Nix to run it.
+run_if_not_found() {
+  local cmd="$1"
+  local pkg="$2"
+  shift 2
+  if command -v "$cmd" >/dev/null 2>&1; then
+    "$cmd" "$@"
+  elif command -v nix >/dev/null 2>&1; then
+    echo "   Tool '$cmd' missing. Using Nix fallback..." >&2
+    nix shell "nixpkgs#$pkg" -c "$cmd" "$@"
+  else
+    echo "Error: Tool '$cmd' not found and Nix not available." >&2
+    exit 1
+  fi
+}
+
+case "$1" in
+  *.tar.bz2) run_if_not_found tar gnutar xvjf "$1" ;;
+  *.tar.gz) run_if_not_found tar gnutar xvzf "$1" ;;
+  *.zip) run_if_not_found unzip unzip "$1" ;;
+  *.rar) run_if_not_found unrar unrar x "$1" ;;
+  *.7z) run_if_not_found 7z p7zip a "$1" ;;
+  *.tar.xz) run_if_not_found tar gnutar xvf "$1" ;;
+  *.tar.zst) run_if_not_found tar gnutar xvf "$1" ;;
   *)
-    echo "Error: Unknown archive format: $FILE"
+    echo "'$1' cannot be extracted via extract" >&2
     exit 1
     ;;
 esac
-
-echo "Extracted to: $DEST"

package/dot_local/bin/executable_gbd

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## gbd — Bulk delete local branches except main/master.
+##
+## # Usage
+##   gbd                           # Delete all except main/master
+##   gbd --dry-run                 # Show what would be deleted
+##   gbd "(main|master|develop)"   # Custom whitelist pattern
+##   gbd "(main|dev)" --dry-run    # Custom whitelist + dry run
+
+set -euo pipefail
+
+if ! command -v git &>/dev/null; then
+  echo "gbd requires git" >&2
+  exit 1
+fi
+
+# R5: validate git repository
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  echo "gbd: not a git repository" >&2
+  exit 1
+fi
+
+default_whitelist="(main|master)"
+skip_branches="${1:-"${default_whitelist}"}"
+dry_run="${2:-}"
+
+# Handle --dry-run as first arg
+if [[ "${skip_branches}" == "--dry-run" ]]; then
+  skip_branches="${default_whitelist}"
+  dry_run="--dry-run"
+fi
+
+# R5: validate regex pattern before use
+if ! echo "" | grep -wEv "${skip_branches}" &>/dev/null; then
+  echo "Invalid whitelist pattern: ${skip_branches}" >&2
+  exit 1
+fi
+
+branches="$(git branch | grep -wEv "${skip_branches}" | grep -wv "$(git branch --show-current)" || true)"
+
+if [[ -z "${branches}" ]]; then
+  echo "No branches to delete."
+  exit 0
+fi
+
+if [[ -n "${dry_run}" ]]; then
+  echo "Would delete:"
+  echo "${branches}" | sed 's/^/  /'
+else
+  echo "${branches}" | xargs git branch -D
+fi

package/dot_local/bin/executable_gd

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## gd — Interactive git diff browser with fzf + delta.
+##
+## # Usage
+##   gd                    # Browse unstaged diffs
+##   gd --staged           # Browse staged diffs
+##   gd --side             # Side-by-side delta mode
+##   gd [git diff flags]   # Pass any git diff flags through
+
+set -euo pipefail
+
+for cmd in fzf delta git; do
+  if ! command -v "$cmd" &>/dev/null; then
+    echo "gd requires $cmd" >&2
+    exit 1
+  fi
+done
+
+# R5: validate git repository
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  echo "gd: not a git repository" >&2
+  exit 1
+fi
+
+GIT_ARGS=()
+
+for arg in "$@"; do
+  if [[ "${arg}" == "--side" ]]; then
+    export DELTA_FEATURES="${DELTA_FEATURES:-} side-by-side"
+  else
+    GIT_ARGS+=("${arg}")
+  fi
+done
+
+GIT_ARGS+=("--color=always")
+
+# shellcheck disable=SC2086,SC2068
+git diff ${GIT_ARGS[@]:-} --name-only |
+  fzf \
+    --preview "git diff ${GIT_ARGS[*]:-} -- {-1} | delta --width=\${FZF_PREVIEW_COLUMNS}" \
+    --preview-window="right,75%" || true

package/dot_local/bin/executable_git-ai-commit

@@ -1,10 +1,25 @@
 #!/usr/bin/env bash
-# git-ai-commit - Generate commit messages using AI
-# Managed by chezmoi - https://github.com/sebastienrousseau/dotfiles
-#
-# Usage: git ai-commit [--provider <provider>] [--edit]
-#   --provider: claude, gemini, sgpt, ollama (auto-detected if not specified)
-#   --edit: Open editor to modify the generated message before committing
+## Git AI Commit — Generate commit messages using AI.
+##
+## Analyzes staged changes and generates conventional commit messages
+## using various AI providers. Supports interactive editing.
+##
+## # Requirements
+## - git: Version control
+## - One of: claude, gemini, sgpt, aider, ollama
+##
+## # Usage
+## git ai-commit                       # Auto-detect provider
+## git ai-commit --provider claude     # Use Claude
+## git ai-commit --edit                # Edit before committing
+## git ai-commit -p ollama -e          # Ollama with edit
+##
+## # Configuration
+## Set GIT_AI_PROVIDER to set default provider
+## Set OLLAMA_MODEL for custom Ollama model (default: llama3.2)
+##
+## # Platform Notes
+## - All platforms: Requires git and an AI CLI tool
 
 set -euo pipefail
 
@@ -21,15 +36,15 @@ PROVIDER=""
 # Parse arguments
 while [[ $# -gt 0 ]]; do
   case $1 in
-    --provider|-p)
+    --provider | -p)
       PROVIDER="$2"
       shift 2
       ;;
-    --edit|-e)
+    --edit | -e)
       EDIT_MODE=true
       shift
       ;;
-    --help|-h)
+    --help | -h)
       echo "Usage: git ai-commit [--provider <provider>] [--edit]"
       echo ""
       echo "Options:"
@@ -41,7 +56,7 @@ while [[ $# -gt 0 ]]; do
       exit 0
       ;;
     *)
-      echo -e "${RED}Unknown option: $1${NC}"
+      printf '%b\n' "${RED}Unknown option: $1${NC}"
       exit 1
       ;;
   esac
@@ -69,7 +84,7 @@ detect_provider() {
 PROVIDER="${PROVIDER:-$(detect_provider)}"
 
 if [[ -z "$PROVIDER" ]]; then
-  echo -e "${RED}Error: No AI provider found. Install claude, gemini, sgpt, aider, or ollama.${NC}"
+  printf '%b\n' "${RED}Error: No AI provider found. Install claude, gemini, sgpt, aider, or ollama.${NC}"
   exit 1
 fi
 
@@ -78,11 +93,11 @@ if ! git diff --cached --quiet; then
   DIFF=$(git diff --cached --stat)
   DIFF_CONTENT=$(git diff --cached)
 else
-  echo -e "${YELLOW}No staged changes. Stage changes with 'git add' first.${NC}"
+  printf '%b\n' "${YELLOW}No staged changes. Stage changes with 'git add' first.${NC}"
   exit 1
 fi
 
-echo -e "${BLUE}Generating commit message using ${PROVIDER}...${NC}"
+printf '%b\n' "${BLUE}Generating commit message using ${PROVIDER}...${NC}"
 
 # Prompt for commit message generation
 PROMPT="Generate a concise, conventional commit message for the following git diff.
@@ -121,7 +136,7 @@ case "$PROVIDER" in
     MESSAGE=$(echo "$PROMPT" | ollama run "$MODEL" 2>/dev/null || echo "")
     ;;
   *)
-    echo -e "${RED}Unknown provider: $PROVIDER${NC}"
+    printf '%b\n' "${RED}Unknown provider: $PROVIDER${NC}"
     exit 1
     ;;
 esac
@@ -130,19 +145,19 @@ esac
 MESSAGE=$(echo "$MESSAGE" | sed 's/^```[a-z]*//g' | sed 's/```$//g' | sed '/^$/d' | head -20)
 
 if [[ -z "$MESSAGE" ]]; then
-  echo -e "${RED}Failed to generate commit message.${NC}"
+  printf '%b\n' "${RED}Failed to generate commit message.${NC}"
   exit 1
 fi
 
-echo -e "${GREEN}Generated commit message:${NC}"
+printf '%b\n' "${GREEN}Generated commit message:${NC}"
 echo "---"
 echo "$MESSAGE"
 echo "---"
 
 if [[ "$EDIT_MODE" == "true" ]]; then
   # Create temp file for editing
-  TMPFILE=$(mktemp)
-  echo "$MESSAGE" > "$TMPFILE"
+  TMPFILE=$(umask 077 && mktemp)
+  echo "$MESSAGE" >"$TMPFILE"
   ${EDITOR:-vim} "$TMPFILE"
   MESSAGE=$(cat "$TMPFILE")
   rm -f "$TMPFILE"
@@ -154,7 +169,7 @@ read -p "Commit with this message? [Y/n] " -n 1 -r
 echo
 if [[ $REPLY =~ ^[Yy]$ ]] || [[ -z $REPLY ]]; then
   git commit -m "$MESSAGE"
-  echo -e "${GREEN}Committed successfully!${NC}"
+  printf '%b\n' "${GREEN}Committed successfully!${NC}"
 else
-  echo -e "${YELLOW}Commit cancelled.${NC}"
+  printf '%b\n' "${YELLOW}Commit cancelled.${NC}"
 fi

package/dot_local/bin/executable_git-ai-diff

@@ -1,10 +1,25 @@
 #!/usr/bin/env bash
-# git-ai-diff - AI-powered diff analysis and review
-# Managed by chezmoi - https://github.com/sebastienrousseau/dotfiles
-#
-# Usage: git ai-diff [<commit>] [--provider <provider>]
-#   <commit>: Compare against this commit (default: HEAD)
-#   --provider: claude, gemini, sgpt, ollama (auto-detected if not specified)
+## Git AI Diff — AI-powered diff analysis and code review.
+##
+## Analyzes git diffs using AI to provide summaries, identify issues,
+## and suggest improvements. Supports multiple AI providers.
+##
+## # Requirements
+## - git: Version control
+## - One of: claude, gemini, sgpt, aider, ollama
+##
+## # Usage
+## git ai-diff                         # Review working changes vs HEAD
+## git ai-diff HEAD~3                   # Compare against 3 commits ago
+## git ai-diff --staged                 # Review staged changes only
+## git ai-diff --provider claude        # Use specific provider
+##
+## # Configuration
+## Set GIT_AI_PROVIDER to set default provider
+## Set OLLAMA_MODEL for custom Ollama model (default: llama3.2)
+##
+## # Platform Notes
+## - All platforms: Requires git and an AI CLI tool
 
 set -euo pipefail
 
@@ -23,15 +38,15 @@ STAGED_ONLY=false
 # Parse arguments
 while [[ $# -gt 0 ]]; do
   case $1 in
-    --provider|-p)
+    --provider | -p)
       PROVIDER="$2"
       shift 2
       ;;
-    --staged|-s)
+    --staged | -s)
       STAGED_ONLY=true
       shift
       ;;
-    --help|-h)
+    --help | -h)
       echo "Usage: git ai-diff [<commit>] [--provider <provider>] [--staged]"
       echo ""
       echo "Options:"
@@ -44,7 +59,7 @@ while [[ $# -gt 0 ]]; do
       exit 0
       ;;
     -*)
-      echo -e "${RED}Unknown option: $1${NC}"
+      printf '%b\n' "${RED}Unknown option: $1${NC}"
       exit 1
       ;;
     *)
@@ -76,7 +91,7 @@ detect_provider() {
 PROVIDER="${PROVIDER:-$(detect_provider)}"
 
 if [[ -z "$PROVIDER" ]]; then
-  echo -e "${RED}Error: No AI provider found. Install claude, gemini, sgpt, aider, or ollama.${NC}"
+  printf '%b\n' "${RED}Error: No AI provider found. Install claude, gemini, sgpt, aider, or ollama.${NC}"
   exit 1
 fi
 
@@ -92,13 +107,13 @@ else
 fi
 
 if [[ -z "$DIFF" ]]; then
-  echo -e "${YELLOW}No changes to review.${NC}"
+  printf '%b\n' "${YELLOW}No changes to review.${NC}"
   exit 0
 fi
 
-echo -e "${BLUE}Analyzing ${CONTEXT} using ${PROVIDER}...${NC}"
+printf '%b\n' "${BLUE}Analyzing ${CONTEXT} using ${PROVIDER}...${NC}"
 echo ""
-echo -e "${CYAN}Changed files:${NC}"
+printf '%b\n' "${CYAN}Changed files:${NC}"
 echo "$DIFF_STAT"
 echo ""
 
@@ -137,18 +152,18 @@ case "$PROVIDER" in
     ANALYSIS=$(echo "$PROMPT" | ollama run "$MODEL" 2>/dev/null || echo "")
     ;;
   *)
-    echo -e "${RED}Unknown provider: $PROVIDER${NC}"
+    printf '%b\n' "${RED}Unknown provider: $PROVIDER${NC}"
     exit 1
     ;;
 esac
 
 if [[ -z "$ANALYSIS" ]]; then
-  echo -e "${RED}Failed to analyze diff.${NC}"
+  printf '%b\n' "${RED}Failed to analyze diff.${NC}"
   exit 1
 fi
 
-echo -e "${GREEN}=== AI Code Review ===${NC}"
+printf '%b\n' "${GREEN}=== AI Code Review ===${NC}"
 echo ""
 echo "$ANALYSIS"
 echo ""
-echo -e "${GREEN}=== End Review ===${NC}"
+printf '%b\n' "${GREEN}=== End Review ===${NC}"