install.sh

#!/usr/bin/env bash
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
SKILLS_SOURCE_DIR="$SCRIPT_DIR/skills"

PLAN_SKILL_NAME="delegate-plan"
REVIEW_SKILL_NAME="delegate-review"
COMMIT_SKILL_NAME="delegate-commit"

SKILL_NAMES=(
  "$PLAN_SKILL_NAME"
  "$REVIEW_SKILL_NAME"
  "$COMMIT_SKILL_NAME"
)

BACKUP_EXISTING=0
QUIET=0

usage() {
  cat <<'USAGE'
Usage:
  bash install.sh [options]

Install three user-level Codex skills:
  - delegate-plan
  - delegate-review
  - delegate-commit

Install root:
  $HOME/.agents/skills

Backup root:
  $HOME/.agents/skills-backups

Behavior:
  Overwrites existing same-name skills on every run.
  Safe to run multiple times; each run mirrors skills/ exactly.

Options:
  --backup      Back up existing same-name skills before overwriting
  --quiet       Reduce output
  -h, --help    Show help

After installation, restart Codex if needed and run /skills.
USAGE
}

info() {
  if [[ "$QUIET" -eq 0 ]]; then
    printf '==> %s\n' "$*"
  fi
}

warn() {
  printf 'Warning: %s\n' "$*" >&2
}

die() {
  printf 'Error: %s\n' "$*" >&2
  exit 1
}

while [[ $# -gt 0 ]]; do
  case "$1" in
    --backup)
      BACKUP_EXISTING=1
      shift
      ;;
    --no-backup)
      BACKUP_EXISTING=0
      shift
      ;;
    --quiet)
      QUIET=1
      shift
      ;;
    -h|--help)
      usage
      exit 0
      ;;
    *)
      die "Unknown argument: $1"
      ;;
  esac
done

if [[ -z "${HOME:-}" ]]; then
  die "HOME is not set. Cannot determine user-level skill directory."
fi

OS_NAME="$(uname -s 2>/dev/null || true)"
case "$OS_NAME" in
  Darwin|Linux) ;;
  *) warn "Unsupported OS name: ${OS_NAME:-unknown}. Continuing anyway." ;;
esac

INSTALL_ROOT="$HOME/.agents/skills"
BACKUP_BASE="$HOME/.agents/skills-backups"
TIMESTAMP="$(date '+%Y%m%d-%H%M%S')"
BACKUP_ROOT=""

backup_existing_skill() {
  local skill_name="$1"
  local skill_dir="$INSTALL_ROOT/$skill_name"

  if [[ ! -e "$skill_dir" ]]; then
    return 0
  fi

  if [[ "$BACKUP_EXISTING" -eq 1 ]]; then
    if [[ -z "$BACKUP_ROOT" ]]; then
      BACKUP_ROOT="$BACKUP_BASE/codex-delegate-skills-$TIMESTAMP-$$"
      mkdir -p "$BACKUP_ROOT"
    fi
    info "Backing up existing skill: $skill_dir -> $BACKUP_ROOT/$skill_name"
    mv "$skill_dir" "$BACKUP_ROOT/$skill_name"
    return 0
  fi

  info "Removing existing skill: $skill_dir"
  rm -rf "$skill_dir"
}

validate_skill() {
  local skill_name="$1"
  local skill_dir="$INSTALL_ROOT/$skill_name"
  local skill_md="$skill_dir/SKILL.md"
  local openai_yaml="$skill_dir/agents/openai.yaml"

  [[ -d "$skill_dir" ]] || die "Missing skill directory: $skill_dir"
  [[ -f "$skill_md" ]] || die "Missing file: $skill_md"
  [[ -f "$openai_yaml" ]] || die "Missing file: $openai_yaml"
  grep -q "^name: $skill_name$" "$skill_md" || die "Invalid name metadata in $skill_md"
  grep -q "^description:" "$skill_md" || die "Missing description metadata in $skill_md"
  grep -q "allow_implicit_invocation: false" "$openai_yaml" || die "Missing allow_implicit_invocation: false in $openai_yaml"
}

install_skill() {
  local skill_name="$1"
  local source_dir="$SKILLS_SOURCE_DIR/$skill_name"
  local target_dir="$INSTALL_ROOT/$skill_name"

  [[ -d "$source_dir" ]] || die "Missing source skill directory: $source_dir"
  [[ -f "$source_dir/SKILL.md" ]] || die "Missing source file: $source_dir/SKILL.md"
  [[ -f "$source_dir/agents/openai.yaml" ]] || die "Missing source file: $source_dir/agents/openai.yaml"

  backup_existing_skill "$skill_name"
  rm -rf "$target_dir"
  mkdir -p "$target_dir"

  info "Installing $skill_name"
  cp -R "$source_dir/." "$target_dir/"
}

[[ -d "$SKILLS_SOURCE_DIR" ]] || die "Missing skills source directory: $SKILLS_SOURCE_DIR"

info "Preparing user-level Codex skills directory: $INSTALL_ROOT"
mkdir -p "$INSTALL_ROOT"

for skill_name in "${SKILL_NAMES[@]}"; do
  install_skill "$skill_name"
done

info "Validating installation"
for skill_name in "${SKILL_NAMES[@]}"; do
  validate_skill "$skill_name"
done

printf '\nInstallation complete.\n\n'
printf 'Installed skills:\n'
for skill_name in "${SKILL_NAMES[@]}"; do
  printf '  %s/%s\n' "$INSTALL_ROOT" "$skill_name"
done

if [[ -n "$BACKUP_ROOT" ]]; then
  printf '\nBackups saved to:\n  %s\n' "$BACKUP_ROOT"
fi

printf '\nNext steps:\n'
printf '  1. Restart Codex if the skills do not appear immediately.\n'
printf '  2. Run /skills in Codex.\n'
printf '  3. Invoke explicitly with:\n'
printf '       $%s\n' "$PLAN_SKILL_NAME"
printf '       $%s\n' "$REVIEW_SKILL_NAME"
printf '       $%s\n' "$COMMIT_SKILL_NAME"