.vscode.d/siren

#! /usr/bin/env bash

# ==============================================================================
# Settings
# ==============================================================================

# Define base globals.
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
SETUP_EDITOR=""
declare -A STATIC_SYMLINKS=()

# Define settings as a function, allowing them to run after all other functions
# have been defined, using them as needed.
define_settings() {
  # List of config files to symlink from current directory.
  CONFIG_SOURCES=(
    "keybindings.json"
    "mcp.json"
    "settings.json"
    "snippets"
  )

  # Additional static symlinks to create (source => target).
  STATIC_SYMLINKS["claude/CLAUDE.md"]="${HOME}/.claude/CLAUDE.md"
  STATIC_SYMLINKS["cspell/vscode-user-dictionary.txt"]="${HOME}/.cspell/vscode-user-dictionary.txt"
  STATIC_SYMLINKS["harper-ls/dictionary.txt"]="$(harper_config_dir)/dictionary.txt"
  STATIC_SYMLINKS["harper-ls/file_dictionaries"]="$(harper_config_dir)/file_dictionaries"
  STATIC_SYMLINKS["harper-ls/ignored_lints"]="$(harper_config_dir)/ignored_lints"

  # Conditionally add `mcp.json` for Cursor.
  if [[ "${SETUP_EDITOR}" == "cursor" ]]; then
    STATIC_SYMLINKS["cursor/mcp.json"]="${HOME}/.cursor/mcp.json"
  fi
}

# Get extensions lockfile path for current editor.
get_extensions_lock() {
  echo "${SCRIPT_DIR}/extensions.${SETUP_EDITOR}.lock"
}

# ==============================================================================
# Help
# ==============================================================================

show_help() {
  cat << EOF
Usage: $(basename "$0") EDITOR COMMAND [OPTIONS]
       $(basename "$0") config

Editors:
  cursor, c                   Cursor editor
  vscode, code, vsc, v        Visual Studio Code
  vscode-insiders, vsci, i    Visual Studio Code Insiders
  windsurf, surf, w           Windsurf editor

Commands:
  config, conf             Create symlinks for editor config files
  dump-extensions, dump    Export installed editor extensions to a lock file.
  extensions, ext          Install editor extensions from a lock file.

Options:
  --latest                 When used with the extensions command, installs the
                           latest version of each extension instead of the
                           exact version from the lock file.

Special Usage:
  config, conf             When used without an editor, creates only static
                           symlinks (CLAUDE.md, dictionaries, etc.)

Description:
  This script manages editor configuration files and extensions.
  It can create symlinks for settings, keybindings, and snippets,
  as well as dump extension lock files and install extensions from them.
EOF
}

# ==============================================================================
# Functions
# ==============================================================================

# Determine editor config directory.
editor_config_dir() {
  case "$(uname -s)" in
    "Darwin")
      case "${SETUP_EDITOR}" in
        "cursor")
          echo "${HOME}/Library/Application Support/Cursor/User"
          ;;
        "vscode")
          echo "${HOME}/Library/Application Support/Code/User"
          ;;
        "vscode-insiders")
          echo "${HOME}/Library/Application Support/Code - Insiders/User"
          ;;
        "windsurf")
          echo "${HOME}/Library/Application Support/Windsurf/User"
          ;;
        *)
          echo "Error: Invalid editor '${SETUP_EDITOR}' for macOS"
          exit 1
          ;;
      esac
      ;;
    "Linux")
      case "${SETUP_EDITOR}" in
        "cursor")
          echo "${HOME}/.config/Cursor/User"
          ;;
        "vscode")
          echo "${HOME}/.config/Code/User"
          ;;
        "vscode-insiders")
          echo "${HOME}/.config/Code - Insiders/User"
          ;;
        "windsurf")
          echo "${HOME}/.config/Windsurf/User"
          ;;
        *)
          echo "Error: Invalid editor '${SETUP_EDITOR}' for Linux"
          exit 1
          ;;
      esac
      ;;
    *)
      echo "Error: Unsupported operating system"
      exit 1
      ;;
  esac
}

# Determine harper-ls config directory.
harper_config_dir() {
  case "$(uname -s)" in
    "Darwin")
      echo "${HOME}/Library/Application Support/harper-ls"
      ;;
    "Linux")
      if [[ -n "${XDG_CONFIG_HOME}" ]]; then
        echo "${XDG_CONFIG_HOME}/harper-ls"
      else
        echo "${HOME}/.config/harper-ls"
      fi
      ;;
    *)
      echo "Error: Unsupported operating system"
      exit 1
      ;;
  esac
}

# Cross-platform function to resolve symlinks.
resolve_symlink() {
  local path="$1"
  if command -v realpath > /dev/null 2>&1; then
    realpath "$path"
  elif [[ "$(uname -s)" == "Darwin" ]]; then
    # Use `printf` to safely pass the path to Python.
    python -c "import os, sys; print(os.path.realpath(sys.argv[1]))" "$path"
  else
    readlink -f "$path"
  fi
}

# Backup and symlink.
backup_and_link() {
  local source="$1"
  local target="$2"
  local real_target
  local real_source

  # Create target directory if it doesn't exist.
  local target_dir
  target_dir="$(dirname "${target}")"
  mkdir -p "${target_dir}"

  # Check if target already exists.
  if [[ -e "${target}" ]]; then
    # If it's a symlink, check if it points to the same location.
    if [[ -L "${target}" ]]; then
      real_target="$(resolve_symlink "$target")"
      real_source="$(resolve_symlink "$source")"
      if [[ "${real_target}" == "${real_source}" ]]; then
        echo "Skipping ${target} - already linked to ${source}"
        return
      fi
    fi

    echo "Backing up existing ${target} to ${target}.bak"
    mv "${target}" "${target}.bak"
  fi

  # Create symlink.
  echo "Creating symlink for ${source} to ${target}"
  ln -s "${source}" "${target}"
}

# Private function: Create editor-specific symlinks.
symlink_editor_config() {
  # Create editor config directory if it doesn't exist.
  local config_dir
  config_dir="$(editor_config_dir)"

  mkdir -p "${config_dir}"
  for path in "${CONFIG_SOURCES[@]}"; do
    backup_and_link "${SCRIPT_DIR}/${path}" "${config_dir}/${path}"
  done
}

# Private function: Create static symlinks.
symlink_static_config() {
  # Create static symlinks to custom locations.
  for source in "${!STATIC_SYMLINKS[@]}"; do
    target="${STATIC_SYMLINKS[${source}]}"
    backup_and_link "${SCRIPT_DIR}/${source}" "${target}"
  done
}

# Public function: Create static symlinks only.
do_static_config() {
  symlink_static_config
  echo "Static symlink setup complete!"
}

# Public function: Create all symlinks (editor-specific + static).
do_config() {
  symlink_editor_config
  symlink_static_config
  echo "Symlink setup complete!"
}

# Find the editor CLI command.
find_editor_cmd() {
  local editor_cmd=""
  local possible_commands=()

  case "${SETUP_EDITOR}" in
    "cursor")
      # Set possible Cursor CLI command locations.
      possible_commands=(
        "cursor"
        "/Applications/Cursor.app/Contents/Resources/app/bin/cursor"
        "${HOME}/Applications/Cursor.app/Contents/Resources/app/bin/cursor"
      )
      ;;
    "vscode")
      # Set possible VSCode CLI command locations.
      possible_commands=(
        "code"
        "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code"
        "${HOME}/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code"
      )
      ;;
    "vscode-insiders")
      # Set possible VSCode Insiders CLI command locations.
      possible_commands=(
        "code-insiders"
        "/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code"
        "${HOME}/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code"
      )
      ;;
    "windsurf")
      # Set possible Windsurf CLI command locations.
      possible_commands=(
        "windsurf"
        "/Applications/Windsurf.app/Contents/Resources/app/bin/windsurf"
        "${HOME}/Applications/Windsurf.app/Contents/Resources/app/bin/windsurf"
      )
      ;;
    *)
      echo "Error: Invalid editor '${SETUP_EDITOR}'"
      exit 1
      ;;
  esac

  # Check for the command in all possible locations.
  for cmd in "${possible_commands[@]}"; do
    if command -v "${cmd}" > /dev/null 2>&1; then
      editor_cmd="${cmd}"
      break
    fi
  done

  if [[ -z "${editor_cmd}" ]]; then
    echo "Error: ${SETUP_EDITOR} command not found" >&2
    exit 1
  fi

  echo "${editor_cmd}"
}

# Dump installed extensions to `extensions.lock`.
do_dump_extensions() {
  local editor_cmd
  editor_cmd="$(find_editor_cmd)"
  local current_date
  current_date="$(date)"
  local extensions_lock
  extensions_lock="$(get_extensions_lock)"

  {
    echo "# ${SETUP_EDITOR} Extensions"
    echo "# Generated on ${current_date}"
    echo
    "${editor_cmd}" --list-extensions --show-versions
  } > "${extensions_lock}"

  echo "Extensions list dumped to ${extensions_lock}"
}

# Validate extension line format.
validate_extension_line() {
  local line="$1"
  local extension=""
  local version=""

  # Check for exactly one `@` symbol.
  local at_count
  at_count=$(echo "${line}" | grep -o "@" | wc -l)
  if [[ ${at_count} -ne 1 ]]; then
    echo "Warning: Invalid format '${line}' - must contain exactly one '@'"
    return 1
  fi

  # Extract extension and version parts.
  extension="${line%@*}"
  version="${line#*@}"

  # Validate extension part (should be `<publisher>.<extension>`).
  if [[ ! "${extension}" =~ ^[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]+$ ]]; then
    echo "Warning: Invalid extension format '${extension}' - must be" \
      "'publisher.extension'"
    return 1
  fi

  # Validate version is not empty and contains valid characters.
  if [[ -z "${version}" ]]; then
    echo "Warning: Empty version for extension '${extension}'"
    return 1
  fi

  if [[ ! "${version}" =~ ^[a-zA-Z0-9._-]+$ ]]; then
    echo "Warning: Invalid version format '${version}' for extension" \
      "'${extension}'"
    return 1
  fi

  # Check for leading/trailing whitespace.
  if [[ "${line}" != "${line// /}" ]]; then
    echo "Warning: Extension line contains spaces: '${line}'"
    return 1
  fi

  return 0
}

# Global variable to cache installed extensions.
_INSTALLED_EXTENSIONS=""

# Get installed extensions with versions, using cache if available.
installed_extensions() {
  local editor_cmd="$1"

  # Populate the cache if it's not already populated.
  if [[ -z "${_INSTALLED_EXTENSIONS}" ]]; then
    _INSTALLED_EXTENSIONS="$("${editor_cmd}" --list-extensions --show-versions)"
  fi

  echo "${_INSTALLED_EXTENSIONS}"
}

# Get the currently installed version of an extension.
get_installed_version() {
  local editor_cmd="$1"
  local extension="$2"

  # Extract version from cached list.
  installed_extensions "${editor_cmd}" |
    grep "^$(printf '%s' "${extension}" | sed "s/[[\.*^$()+?{|]/\\\\&/g")@" |
    sed "s/^[^@]*@//"
}

# Install an extension directly using the marketplace.
install_extension_direct() {
  local editor_cmd="$1"
  local extension="$2"
  local version="$3"
  local use_latest="$4"
  local force_install="$5"
  local result=0

  if [[ "${use_latest}" == "true" ]]; then
    echo "Installing ${extension} (latest version)"
    if ! "${editor_cmd}" --install-extension "${extension}" --force; then
      echo "Warning: Direct install failed for ${extension}"
      result=1
    fi
  else
    echo "Installing ${extension}@${version}"
    local install_cmd=("${editor_cmd}" --install-extension "${extension}@${version}")
    if [[ "${force_install}" == "true" ]]; then
      install_cmd+=(--force)
    fi
    if ! "${install_cmd[@]}"; then
      echo "Warning: Direct install failed for ${extension}@${version}"
      result=1
    fi
  fi

  return ${result}
}

# Install an extension via downloading `*.vsix` file.
install_extension_via_vsix() {
  local editor_cmd="$1"
  local extension="$2"
  local version="$3"
  local use_latest="$4"
  local extensions_cache_dir="$5"
  local result=0

  local publisher_id="${extension%%.*}"
  local extension_id="${extension#*.}"
  local vsix_path=""
  local vsix_url=""
  local install_version=""

  if [[ "${use_latest}" == "true" ]]; then
    # Check for `jq` availability when using `--latest` flag.
    if ! command -v jq > /dev/null 2>&1; then
      echo "Error: jq is required when using --latest flag to parse" \
        "marketplace API responses."
      echo "Please install jq or remove the --latest flag to use exact" \
        "versions from the lock file."
      return 1
    fi

    # In latest mode, we need to first query the marketplace to get the latest
    # version.
    echo "Finding latest version for ${extension}..."

    # Query the VS Marketplace API to get the extension metadata.
    local metadata_url="https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery"
    local temp_metadata="${extensions_cache_dir}/metadata-${extension}.json"

    # Create extensions directory if it doesn't exist.
    mkdir -p "${extensions_cache_dir}"

    # Use `jq` to properly construct JSON.
    local request_data
    request_data=$(jq -n --arg ext "$extension" '{
      filters: [{
        criteria: [{ filterType: 7, value: $ext }]
      }],
      flags: 2
    }')

    # Query the marketplace for extension metadata.
    if ! curl --silent --compressed -X POST \
      -H "Content-Type: application/json" \
      -H "Accept: application/json; api-version=7.2-preview.1" \
      -d "${request_data}" "${metadata_url}" > "${temp_metadata}"; then
      echo "Warning: Failed to query metadata for ${extension}"
      rm -f "${temp_metadata}"
      return 1
    fi

    # Extract the latest version from the response using `jq`.
    install_version=$(
      jq -r '.results[0].extensions[0].versions[0].version' "${temp_metadata}" \
        2> /dev/null
    )

    # Clean up metadata file.
    rm -f "${temp_metadata}"

    # If we couldn't extract a version, use original version as fallback.
    if [[ -z "${install_version}" || "${install_version}" == "null" ]]; then
      echo "Warning: Could not determine latest version, falling back to" \
        "lock file version"
      install_version="${version}"
    else
      echo "Latest version of ${extension} is ${install_version}"
    fi

    # Set up the download path and URL for the specific version we found.
    vsix_path="${extensions_cache_dir}/${extension}@${install_version}.vsix"
    vsix_url="https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${publisher_id}/vsextensions/${extension_id}/${install_version}/vspackage"
  else
    # In strict mode, use the exact version from the lock file.
    echo "Installing ${extension}@${version} via .vsix"
    vsix_path="${extensions_cache_dir}/${extension}@${version}.vsix"
    vsix_url="https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${publisher_id}/vsextensions/${extension_id}/${version}/vspackage"
    install_version="${version}"
  fi

  # Create extensions directory if it doesn't exist.
  mkdir -p "${extensions_cache_dir}"

  # Download the `*.vsix` file.
  echo "Downloading ${extension}@${install_version}.vsix..."
  echo "  - URL: ${vsix_url}"
  if ! curl --compressed -L -o "${vsix_path}" "${vsix_url}"; then
    echo "Warning: Failed to download ${extension}@${install_version}.vsix"
    rm -f "${vsix_path}" # Clean up potential partial downloads
    return 1
  fi

  # Install the extension from `*.vsix` file.
  # Note: Installing from `*.vsix` automatically overwrites existing versions.
  echo "Installing extension from ${vsix_path}"
  if ! "${editor_cmd}" --install-extension "${vsix_path}"; then
    echo "Warning: Failed to install ${extension}@${install_version}" \
      "from '*.vsix'"
    result=1
  fi

  # Clean up the `*.vsix` file after installation attempt.
  rm -f "${vsix_path}"

  return ${result}
}

# Install extensions from `extensions.lock`.
do_install_extensions() {
  local editor_cmd
  editor_cmd="$(find_editor_cmd)"
  local extensions_cache_dir="${SCRIPT_DIR}/cache/extensions"
  local extensions_lock
  extensions_lock="$(get_extensions_lock)"
  local use_latest="${1:-false}"

  if [[ ! -f "${extensions_lock}" ]]; then
    echo "Error: ${extensions_lock} not found"
    exit 1
  fi

  # Warn the installed extensions cache before we start processing the lock
  # file.
  installed_extensions "${editor_cmd}"

  # Process each extension.
  while IFS= read -r line; do
    if [[ -n "${line}" && ! "${line}" =~ ^[[:space:]]*# ]]; then
      # Validate extension line format.
      if ! validate_extension_line "${line}"; then
        continue
      fi

      extension="${line%@*}"
      version="${line#*@}"

      # Check if already installed and get current version.
      local current_version
      current_version="$(get_installed_version "${editor_cmd}" "${extension}")"
      local force_install="false"

      if [[ -z "${current_version}" ]]; then
        # Extension not installed.
        echo "Installing ${extension}@${version}"
      elif [[ "${use_latest}" == "true" ]]; then
        # In latest mode, skip if any version is installed.
        echo "Extension ${extension} is already installed" \
          "(current: ${current_version}), skipping"
        continue
      elif [[ "${current_version}" == "${version}" ]]; then
        # Exact version already installed.
        echo "Extension ${extension}@${version} is already installed, skipping"
        continue
      else
        # Wrong version installed, need to force install.
        echo "Extension ${extension} is installed but wrong version" \
          "(current: ${current_version}, wanted: ${version})," \
          "force-installing ${version}"
        force_install="true"
      fi

      # For Cursor we need to download and install from `*.vsix` file, as
      # installation via ID fails with a signature verification error.
      if [[ "${SETUP_EDITOR}" == "cursor" ]]; then
        install_extension_via_vsix "${editor_cmd}" "${extension}" "${version}" \
          "${use_latest}" "${extensions_cache_dir}"
        continue
      fi

      if ! install_extension_direct "${editor_cmd}" "${extension}" \
        "${version}" "${use_latest}" "${force_install}"; then
        echo "Direct installation failed, trying .vsix download method..."
        install_extension_via_vsix "${editor_cmd}" "${extension}" "${version}" \
          "${use_latest}" "${extensions_cache_dir}"
      fi
    fi
  done < "${extensions_lock}"

  # Clean up extensions directory if empty.
  rmdir "${extensions_cache_dir}" 2> /dev/null || true
  echo "Extensions installation complete!"
}

# ==============================================================================
# Main
# ==============================================================================

main() {
  if [[ $# -lt 1 ]]; then
    echo "Error: No editor specified"
    show_help
    exit 1
  fi

  if [[ "$1" == "help" || "$1" == "--help" || "$1" == "-h" ]]; then
    show_help
    exit 0
  fi

  # Check if first argument is config/conf (standalone mode).
  local first_arg
  first_arg="$(echo "${1}" | tr '[:upper:]' '[:lower:]')"
  if [[ "${first_arg}" == "config" || "${first_arg}" == "conf" ]]; then
    define_settings
    do_static_config
    exit 0
  fi

  if [[ $# -lt 2 ]]; then
    echo "Error: No command specified"
    show_help
    exit 1
  fi

  # Set editor from first argument.
  editor="${first_arg}"
  case "${editor}" in
    "vscode" | "code" | "vsc" | "v")
      SETUP_EDITOR="vscode"
      ;;
    "vscode-insiders" | "code-insiders" | "insiders" | "vsci" | "i")
      SETUP_EDITOR="vscode-insiders"
      ;;
    "cursor" | "c")
      SETUP_EDITOR="cursor"
      ;;
    "windsurf" | "wind" | "surf" | "w")
      SETUP_EDITOR="windsurf"
      ;;
    *)
      echo "Error: Unsupported editor '${editor}'"
      echo "Supported editors: cursor, vscode (vsc), vscode-insiders (vsci), windsurf (wind)"
      exit 1
      ;;
  esac

  # Define settings after `SETUP_EDITOR` is set.
  define_settings

  # Get command from second argument.
  local command="${2}"
  shift 2

  # Default values for options.
  local use_latest="false"

  # Parse additional options.
  while [[ $# -gt 0 ]]; do
    case "$1" in
      --latest)
        use_latest="true"
        shift
        ;;
      *)
        echo "Error: Unknown option '$1'"
        show_help
        exit 1
        ;;
    esac
  done

  # Handle commands.
  case "${command}" in
    "config" | "conf")
      do_config
      ;;
    "dump-extensions" | "dump")
      do_dump_extensions
      ;;
    "extensions" | "ext")
      do_install_extensions "${use_latest}"
      ;;
    "")
      echo "Error: No command provided"
      show_help
      exit 1
      ;;
    *)
      echo "Error: Unknown command '${command}'"
      show_help
      exit 1
      ;;
  esac
}

# Run main function.
main "$@"