install.sh

#!/usr/bin/env bash
# install.sh — Copy the agent orchestration system into another project.
#
# Usage:
#   ./install.sh <target-directory> [--overwrite]
#
# Examples:
#   ./install.sh ../my-project
#   ./install.sh /home/user/projects/my-app --overwrite
#
# What it copies:
#   .claude/         — agent prompts, templates, standards, state, context-packets
#   specs/           — dependency graph and standalone-tasks directory
#
# Options:
#   --overwrite      Overwrite existing files in the target directory.
#                    Without this flag the script aborts if any destination
#                    file already exists, so you never accidentally clobber work.

set -euo pipefail

# ── helpers ──────────────────────────────────────────────────────────────────

usage() {
  sed -n '2,16p' "$0" | sed 's/^# \{0,1\}//'
  exit 1
}

info()  { echo "[install] $*"; }
warn()  { echo "[install] WARNING: $*" >&2; }
error() { echo "[install] ERROR: $*" >&2; exit 1; }

# ── argument parsing ──────────────────────────────────────────────────────────

TARGET=""
OVERWRITE=false

for arg in "$@"; do
  case "$arg" in
    --overwrite) OVERWRITE=true ;;
    --help|-h)   usage ;;
    -*)          error "Unknown option: $arg. Run with --help for usage." ;;
    *)
      if [ -z "$TARGET" ]; then
        TARGET="$arg"
      else
        error "Too many arguments. Run with --help for usage."
      fi
      ;;
  esac
done

[ -z "$TARGET" ] && usage

# ── resolve paths ─────────────────────────────────────────────────────────────

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

# Ensure we are running from the repo root (where .claude/ lives)
if [ ! -d "$SCRIPT_DIR/.claude" ]; then
  error "Could not find .claude/ directory relative to install.sh ($SCRIPT_DIR). Run install.sh from the repository root."
fi

# Resolve target to an absolute path
TARGET="$(mkdir -p "$TARGET" && cd "$TARGET" && pwd)"

if [ "$TARGET" = "$SCRIPT_DIR" ]; then
  error "Target directory is the same as the source repository. Choose a different target."
fi

# ── collision check ───────────────────────────────────────────────────────────

if [ "$OVERWRITE" = false ]; then
  CONFLICTS=()
  while IFS= read -r -d '' src; do
    rel="${src#"$SCRIPT_DIR/"}"
    dest="$TARGET/$rel"
    if [ -e "$dest" ]; then
      CONFLICTS+=("$rel")
    fi
  done < <(find "$SCRIPT_DIR/.claude" "$SCRIPT_DIR/specs" -type f -print0)

  if [ "${#CONFLICTS[@]}" -gt 0 ]; then
    echo "[install] ERROR: The following files already exist in '$TARGET':" >&2
    for f in "${CONFLICTS[@]}"; do
      echo "  $f" >&2
    done
    echo "" >&2
    echo "  Re-run with --overwrite to replace them." >&2
    exit 1
  fi
fi

# ── copy files ────────────────────────────────────────────────────────────────

copy_tree() {
  local src_dir="$1"
  local rel_dir="${src_dir#"$SCRIPT_DIR/"}"

  while IFS= read -r -d '' src; do
    rel="${src#"$SCRIPT_DIR/"}"
    dest="$TARGET/$rel"
    mkdir -p "$(dirname "$dest")"
    cp "$src" "$dest"
    info "copied  $rel"
  done < <(find "$src_dir" -type f -print0)
}

info "Installing agent orchestration system into: $TARGET"
info ""

copy_tree "$SCRIPT_DIR/.claude"
copy_tree "$SCRIPT_DIR/specs"

# ── done ──────────────────────────────────────────────────────────────────────

info ""
info "Done. Next steps:"
info "  1. Open $TARGET/.claude/standards/ and fill in the placeholder"
info "     code, testing, and documentation standards for your project."
info "  2. Read $TARGET/.claude/agents/orchestrator.claude.md to understand"
info "     how to start a Plan Mode or Execute Mode session."
info "  3. Optionally copy README.md from this repository for reference."