@sebastienrousseau/dotfiles 0.2.519 → 0.2.521

package/scripts/dot/commands/init.sh

@@ -1,185 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2015-2026 Sebastien Rousseau
-# shellcheck shell=bash
-#
-# scripts/dot/commands/init.sh
-#
-# `dot init <github-user>` — bootstrap a foreign dotfiles repo through
-# this framework's harness. The §3 audit roadmap calls for an analogue
-# to `chezmoi init <user>` that turns this tool from "one person's
-# config" into a runtime for any dotfiles user.
-#
-# Behavior:
-#   dot init alice                # clones github.com/alice/dotfiles via chezmoi,
-#                                 # applies through the dot harness
-#   dot init https://...          # explicit URL
-#   dot init alice --dry-run      # preview without writing
-#   dot init alice --no-apply     # clone only; don't run chezmoi apply
-#
-# Safety:
-#   - Refuses to clobber an existing chezmoi source dir without --force.
-#   - Disclaims that the target's scripts will run with the user's
-#     privileges and prints the source URL for inspection.
-#   - Verifies the source URL is HTTPS (no plain git://) so MITM is harder.
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=../../../lib/dot/ui.sh disable=SC1091
-source "$SCRIPT_DIR/../../../lib/dot/ui.sh"
-# shellcheck source=../../../lib/dot/utils.sh disable=SC1091
-source "$SCRIPT_DIR/../../../lib/dot/utils.sh"
-
-_init_resolve_url() {
-  local arg="$1"
-  case "$arg" in
-    http://*)
-      printf "dot init: refusing plain HTTP (use HTTPS or git+ssh)\n" >&2
-      return 2
-      ;;
-    https://* | git@*:*)
-      # Trust full URLs as-is — these are the user's explicit intent.
-      printf "%s\n" "$arg"
-      ;;
-    */*)
-      # owner/repo shorthand: validate before constructing the URL so
-      # a crafted argument can't smuggle shell metacharacters into
-      # downstream tooling (chezmoi init, git clone).
-      if [[ ! "$arg" =~ ^[A-Za-z0-9._-]+/[A-Za-z0-9._-]+$ ]]; then
-        printf "dot init: invalid owner/repo (only [A-Za-z0-9._-]+/[A-Za-z0-9._-]+ allowed): %s\n" "$arg" >&2
-        return 2
-      fi
-      printf "https://github.com/%s.git\n" "$arg"
-      ;;
-    *)
-      # Bare user shorthand: same character whitelist as the path
-      # segment of a GitHub URL.
-      if [[ ! "$arg" =~ ^[A-Za-z0-9._-]+$ ]]; then
-        printf "dot init: invalid user (only [A-Za-z0-9._-] allowed): %s\n" "$arg" >&2
-        return 2
-      fi
-      printf "https://github.com/%s/dotfiles.git\n" "$arg"
-      ;;
-  esac
-}
-
-cmd_init() {
-  local user_arg="" dry_run=0 apply=1 force=0
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --dry-run | -n)
-        dry_run=1
-        shift
-        ;;
-      --no-apply)
-        apply=0
-        shift
-        ;;
-      --force | -f)
-        force=1
-        shift
-        ;;
-      --help | -h)
-        cat <<EOF
-Usage: dot init <github-user|owner/repo|url> [--dry-run] [--no-apply] [--force]
-
-Bootstrap a foreign dotfiles repo through chezmoi + the dot harness.
-
-Examples:
-  dot init alice                # github.com/alice/dotfiles
-  dot init alice/configs        # github.com/alice/configs
-  dot init https://example.com/repo.git
-  dot init alice --dry-run      # preview only
-  dot init alice --no-apply     # clone but don't apply
-
-Flags:
-  --dry-run, -n   Show resolved URL + target dir without cloning.
-  --no-apply      Clone the source but skip 'chezmoi apply'.
-  --force,   -f   Overwrite an existing chezmoi source dir.
-EOF
-        return 0
-        ;;
-      --)
-        shift
-        break
-        ;;
-      -*)
-        ui_err "Unknown flag" "$1"
-        return 1
-        ;;
-      *)
-        if [[ -n "$user_arg" ]]; then
-          ui_err "Too many arguments" "$1"
-          return 1
-        fi
-        user_arg="$1"
-        shift
-        ;;
-    esac
-  done
-
-  [[ -n "$user_arg" ]] || {
-    ui_err "init" "missing <user|repo|url>"
-    return 1
-  }
-
-  local url
-  url="$(_init_resolve_url "$user_arg")" || return $?
-
-  if ! command -v chezmoi >/dev/null 2>&1; then
-    ui_err "chezmoi" "not installed — run install.sh first"
-    return 127
-  fi
-
-  local source_dir
-  source_dir="${CHEZMOI_SOURCE_DIR:-$(chezmoi source-path 2>/dev/null || echo "$HOME/.local/share/chezmoi")}"
-
-  ui_header "Bootstrap dotfiles from $user_arg"
-  ui_info "Source URL" "$url"
-  ui_info "Target dir" "$source_dir"
-  local _apply_label="no"
-  [[ "$apply" -eq 1 ]] && _apply_label="yes"
-  ui_info "Apply after?" "$_apply_label"
-
-  if [[ "$dry_run" -eq 1 ]]; then
-    ui_ok "Dry-run" "no changes made"
-    return 0
-  fi
-
-  if [[ -e "$source_dir" ]] && [[ "$force" -ne 1 ]]; then
-    ui_err "Refusing" "$source_dir already exists; pass --force to overwrite"
-    return 1
-  fi
-
-  ui_warn "Trust" "The target repo's scripts will run with your user privileges."
-  ui_warn "Trust" "Inspect $url before proceeding if you don't know the author."
-  if [[ -t 0 ]] && [[ "${DOTFILES_NONINTERACTIVE:-0}" != "1" ]]; then
-    read -r -p "  Continue? [y/N] " resp
-    case "$resp" in
-      [yY] | [yY][eE][sS]) ;;
-      *)
-        ui_info "Init" "aborted by user"
-        return 1
-        ;;
-    esac
-  fi
-
-  local chezmoi_args=(init --source "$source_dir")
-  [[ "$apply" -eq 1 ]] && chezmoi_args+=(--apply)
-  chezmoi_args+=("$url")
-
-  ui_info "chezmoi" "${chezmoi_args[*]}"
-  if chezmoi "${chezmoi_args[@]}"; then
-    ui_ok "Init" "complete"
-    if [[ "$apply" -eq 1 ]]; then
-      ui_info "Hint" "run 'dot doctor' to validate the new environment"
-    else
-      ui_info "Hint" "run 'chezmoi diff' then 'chezmoi apply' when ready"
-    fi
-  else
-    local rc=$?
-    ui_err "Init" "chezmoi exited $rc"
-    return "$rc"
-  fi
-}

package/scripts/dot/commands/lint.sh

@@ -1,208 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2015-2026 Sebastien Rousseau
-# Dotfiles CLI - Lint Command
-# Wraps shellcheck and shfmt with project-specific flags
-
-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 "Lint" "${1:-}"
-
-# ── Configuration ────────────────────────────────────────────────────────────
-# Flags from CLAUDE.md conventions:
-#   SC flags: --severity=error -e SC1091 -e SC2030 -e SC2031
-#   shfmt:    -i 2 -ci
-SHELLCHECK_ARGS=(--severity=error -e SC1091 -e SC2030 -e SC2031)
-SHFMT_ARGS=(-i 2 -ci)
-
-# True only if the file's shebang names a shell that both shellcheck and shfmt
-# can process. The old `grep -qiE 'shell|bash|sh'` matched loosely — "sh" hit
-# "fish", and `file` output pulled in python3 scripts — so non-shell files
-# landed in the lint set and produced spurious SC1071 / shfmt parse "errors".
-_lint_is_shell() {
-  local first interp
-  first="$(head -1 "$1" 2>/dev/null)"
-  case "$first" in '#!'*) ;; *) return 1 ;; esac
-  interp="${first#\#!}"
-  interp="${interp#"${interp%%[![:space:]]*}"}" # ltrim
-  case "$interp" in
-    */env[[:space:]]*)
-      interp="${interp#*/env}"
-      interp="${interp#"${interp%%[![:space:]]*}"}"
-      interp="${interp%%[[:space:]]*}"
-      ;;
-    *)
-      interp="${interp%%[[:space:]]*}"
-      interp="${interp##*/}"
-      ;;
-  esac
-  case "$interp" in
-    sh | bash | dash | ksh | mksh | ash) return 0 ;;
-    *) return 1 ;;
-  esac
-}
-
-cmd_lint() {
-  local mode="${1:-all}"
-  local src_dir
-  src_dir="$(require_source_dir)"
-
-  # Collect target files
-  local -a files=()
-  while IFS= read -r -d '' f; do
-    files+=("$f")
-  done < <(find "$src_dir/scripts" -name '*.sh' -type f -print0 2>/dev/null)
-
-  # install.sh
-  if [[ -f "$src_dir/install.sh" ]]; then
-    files+=("$src_dir/install.sh")
-  fi
-
-  # Post-Phase-4b chezmoi-tracked content lives under defaults/.
-  local chezmoi_src
-  chezmoi_src="$(resolve_chezmoi_source_dir)"
-  [[ -z "$chezmoi_src" ]] && chezmoi_src="$src_dir"
-
-  # dot_local/bin/executable_* scripts — shell scripts only (skip python/zsh/etc
-  # by inspecting the shebang, so shellcheck/shfmt never see files they can't parse).
-  while IFS= read -r -d '' f; do
-    if _lint_is_shell "$f"; then
-      files+=("$f")
-    fi
-  done < <(find "$chezmoi_src/dot_local/bin" -name 'executable_*' -type f -print0 2>/dev/null)
-
-  # .chezmoitemplates/*.sh (non-.tmpl shell scripts)
-  while IFS= read -r -d '' f; do
-    files+=("$f")
-  done < <(find "$chezmoi_src/.chezmoitemplates" -name '*.sh' -type f -print0 2>/dev/null)
-
-  local total=${#files[@]}
-  if [[ "$total" -eq 0 ]]; then
-    ui_warn "No files" "No shell scripts found to lint"
-    return 0
-  fi
-
-  local sc_errors=0
-  local fmt_errors=0
-
-  case "$mode" in
-    all | check)
-      # ── ShellCheck ──────────────────────────────────────────────────────
-      if has_command shellcheck; then
-        ui_section "ShellCheck"
-        echo ""
-        # One shellcheck invocation over all files (was one fork per file).
-        # gcc format is one line per issue, so failing files = unique paths.
-        local sc_out
-        sc_out="$(shellcheck -f gcc "${SHELLCHECK_ARGS[@]}" "${files[@]}" 2>/dev/null || true)"
-        if [[ -z "$sc_out" ]]; then
-          ui_ok "shellcheck" "$total files clean"
-        else
-          printf '%s\n' "$sc_out"
-          sc_errors=$(printf '%s\n' "$sc_out" | cut -d: -f1 | sort -u | grep -c .)
-          ui_err "shellcheck" "$sc_errors file(s) with errors"
-        fi
-        echo ""
-      else
-        ui_warn "shellcheck" "not installed, skipping"
-        echo ""
-      fi
-
-      # ── shfmt ───────────────────────────────────────────────────────────
-      if has_command shfmt; then
-        ui_section "shfmt"
-        echo ""
-        # `shfmt -l` lists files needing formatting in one invocation
-        # (was `shfmt -d` per file).
-        local fmt_list
-        fmt_list="$(shfmt "${SHFMT_ARGS[@]}" -l "${files[@]}" 2>/dev/null || true)"
-        if [[ -z "$fmt_list" ]]; then
-          ui_ok "shfmt" "$total files formatted correctly"
-        else
-          fmt_errors=$(printf '%s\n' "$fmt_list" | grep -c .)
-          ui_err "shfmt" "$fmt_errors file(s) need formatting"
-        fi
-        echo ""
-      else
-        ui_warn "shfmt" "not installed, skipping"
-        echo ""
-      fi
-      ;;
-
-    fix)
-      # ── Auto-fix with shfmt ─────────────────────────────────────────────
-      if ! has_command shfmt; then
-        ui_err "shfmt" "not installed — cannot auto-fix"
-        exit 1
-      fi
-      ui_section "Auto-fixing with shfmt"
-      echo ""
-      # Find files needing formatting in one `shfmt -l` pass, then only
-      # rewrite that (usually small) set — was `shfmt -d` per file.
-      local fmt_list fixed=0
-      fmt_list="$(shfmt "${SHFMT_ARGS[@]}" -l "${files[@]}" 2>/dev/null || true)"
-      if [[ -z "$fmt_list" ]]; then
-        ui_ok "shfmt" "All files already formatted"
-      else
-        while IFS= read -r f; do
-          [[ -n "$f" ]] || continue
-          shfmt "${SHFMT_ARGS[@]}" -w "$f"
-          ui_ok "fixed" "${f#"$src_dir/"}"
-          fixed=$((fixed + 1))
-        done <<<"$fmt_list"
-        ui_ok "shfmt" "$fixed file(s) reformatted"
-      fi
-      echo ""
-      ;;
-
-    *)
-      ui_err "Unknown lint mode: $mode"
-      echo "Usage: dot lint [--fix|-f | --check|-c]"
-      exit 1
-      ;;
-  esac
-
-  # ── Summary ───────────────────────────────────────────────────────────────
-  ui_section "Summary"
-  echo ""
-  ui_info "Files scanned" "$total"
-  if [[ "$sc_errors" -gt 0 ]]; then
-    ui_err "ShellCheck errors" "$sc_errors"
-  fi
-  if [[ "$fmt_errors" -gt 0 ]]; then
-    ui_err "Formatting issues" "$fmt_errors"
-  fi
-  if [[ "$sc_errors" -eq 0 ]] && [[ "$fmt_errors" -eq 0 ]]; then
-    ui_ok "Result" "All checks passed"
-  fi
-  echo ""
-
-  # Exit 1 in check mode if any errors
-  if [[ "$mode" == "check" ]] && [[ $((sc_errors + fmt_errors)) -gt 0 ]]; then
-    exit 1
-  fi
-}
-
-# ── Dispatch ─────────────────────────────────────────────────────────────────
-case "${1:-}" in
-  lint)
-    shift
-    case "${1:---}" in
-      --fix | -f) cmd_lint "fix" ;;
-      --check | -c) cmd_lint "check" ;;
-      *) cmd_lint "all" ;;
-    esac
-    ;;
-  *)
-    # Direct invocation (dot lint)
-    case "${1:---}" in
-      --fix | -f) cmd_lint "fix" ;;
-      --check | -c) cmd_lint "check" ;;
-      *) cmd_lint "all" ;;
-    esac
-    ;;
-esac

package/scripts/dot/commands/manual.sh

@@ -1,169 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2015-2026 Sebastien Rousseau
-# dot manual — open or download the dotfiles manual in multiple formats.
-#
-# Usage:
-#   dot manual                   # open HTML manual in browser
-#   dot manual html              # alias of no-arg
-#   dot manual pdf               # download + open PDF
-#   dot manual epub              # download + open EPUB
-#   dot manual text              # pipe ASCII text to pager
-#   dot manual markdown          # pipe Markdown source to pager
-#   dot manual download <fmt>    # save to current directory
-#   dot manual --offline         # use bundled offline copy
-#   dot manual --local           # use locally-built _build/manual/
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=../../../lib/dot/utils.sh
-source "$SCRIPT_DIR/../../../lib/dot/utils.sh"
-
-MANUAL_URL="${DOTFILES_MANUAL_URL:-https://sebastienrousseau.github.io/dotfiles/manual}"
-CACHE_DIR="${XDG_CACHE_HOME:-$HOME/.cache}/dotfiles/manual"
-OFFLINE_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/dotfiles/manual"
-
-MODE="open"
-FORMAT="html"
-USE_LOCAL=false
-USE_OFFLINE=false
-
-for arg in "$@"; do
-  case "$arg" in
-    html | html-multi | pdf | epub | text | markdown) FORMAT="$arg" ;;
-    download) MODE="download" ;;
-    --offline) USE_OFFLINE=true ;;
-    --local) USE_LOCAL=true ;;
-    --url=*) MANUAL_URL="${arg#*=}" ;;
-    --help | -h)
-      sed -n 's/^# //p;s/^#$//p' "$0" | head -20
-      exit 0
-      ;;
-  esac
-done
-
-format_file() {
-  case "$1" in
-    html) echo "dotfiles.html" ;;
-    html-multi) echo "html/index.html" ;;
-    pdf) echo "dotfiles.pdf" ;;
-    epub) echo "dotfiles.epub" ;;
-    text) echo "dotfiles.txt" ;;
-    markdown) echo "dotfiles-md.tar.gz" ;;
-    *) return 1 ;;
-  esac
-}
-
-resolve_source() {
-  local fmt="$1"
-  local fname
-  fname="$(format_file "$fmt")"
-
-  if $USE_LOCAL; then
-    local src_dir
-    src_dir="$(require_source_dir)/_build/manual"
-    if [[ -f "$src_dir/$fname" ]]; then
-      echo "$src_dir/$fname"
-      return 0
-    fi
-    ui_err "manual" "local build not found at $src_dir/$fname — run bash tools/docs/build-manual.sh" >&2
-    return 1
-  fi
-
-  if $USE_OFFLINE; then
-    if [[ -f "$OFFLINE_DIR/$fname" ]]; then
-      echo "$OFFLINE_DIR/$fname"
-      return 0
-    fi
-    ui_err "manual" "offline copy not found at $OFFLINE_DIR/$fname" >&2
-    return 1
-  fi
-
-  local cache_path="$CACHE_DIR/$fname"
-  if [[ ! -f "$cache_path" ]] || [[ $(find "$cache_path" -mtime +7 -print 2>/dev/null | wc -l) -gt 0 ]]; then
-    mkdir -p "$(dirname "$cache_path")"
-    local url="$MANUAL_URL/$fname"
-    ui_info "manual" "fetching $url" >&2
-    if ! curl -fsSL "$url" -o "$cache_path"; then
-      ui_err "manual" "failed to download $url" >&2
-      return 1
-    fi
-  fi
-  echo "$cache_path"
-}
-
-open_file() {
-  local path="$1"
-  case "$(uname -s)" in
-    Darwin)
-      # Use the system open explicitly — ~/.local/bin/open is a wrapper
-      # that would recurse on itself.
-      /usr/bin/open "$path"
-      ;;
-    Linux)
-      if command -v xdg-open &>/dev/null; then
-        xdg-open "$path"
-      elif command -v gio &>/dev/null; then
-        gio open "$path"
-      else
-        ui_err "manual" "no opener found (xdg-open, gio); use file://$path"
-        return 1
-      fi
-      ;;
-    *)
-      ui_info "manual" "saved to: $path"
-      ;;
-  esac
-}
-
-cmd_open() {
-  local path
-  path="$(resolve_source "$FORMAT")"
-  [[ -z "$path" ]] && exit 1
-
-  case "$FORMAT" in
-    text)
-      ${PAGER:-less} "$path"
-      ;;
-    markdown)
-      local tmpdir
-      tmpdir="$(mktemp -d)"
-      tar -xzf "$path" -C "$tmpdir"
-      ui_info "manual" "Markdown source extracted to: $tmpdir"
-      open_file "$tmpdir" 2>/dev/null || true
-      ;;
-    html)
-      if ! $USE_LOCAL && ! $USE_OFFLINE; then
-        open_file "$MANUAL_URL/"
-      else
-        open_file "$path"
-      fi
-      ;;
-    html-multi)
-      if ! $USE_LOCAL && ! $USE_OFFLINE; then
-        open_file "$MANUAL_URL/html/"
-      else
-        open_file "$path"
-      fi
-      ;;
-    *)
-      open_file "$path"
-      ;;
-  esac
-}
-
-cmd_download() {
-  local path
-  path="$(resolve_source "$FORMAT")"
-  [[ -z "$path" ]] && exit 1
-  local dest
-  dest="./$(basename "$path")"
-  cp "$path" "$dest"
-  ui_ok "manual" "saved: $dest"
-}
-
-case "$MODE" in
-  open) cmd_open ;;
-  download) cmd_download ;;
-esac