setup

/kas:setup - Prepare Project for KAS Workflow

Validate prerequisites and verify the environment is ready.

Workflow

Execute these steps in order. Track results as PASS, FAIL (blocker), or WARN (non-blocking).

1. Check Prerequisites

Prerequisites are BLOCKERS - setup cannot continue if any fail.

1.1 Check GitHub CLI (gh)

# Check installed
if ! command -v gh &>/dev/null; then
  echo "[FAIL] gh not found"
  echo "  Install: https://cli.github.com/"
  # BLOCKER
fi

# Check version >= 2.0.0
GH_VERSION=$(gh --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
GH_MAJOR=$(echo "$GH_VERSION" | cut -d. -f1)
GH_MAJOR=${GH_MAJOR:-0}
if [[ "$GH_MAJOR" -lt 2 ]]; then
  echo "[FAIL] gh version $GH_VERSION < 2.0.0"
  echo "  Upgrade: https://cli.github.com/"
  # BLOCKER
fi

# Check authenticated
if ! gh auth status &>/dev/null; then
  echo "[FAIL] gh not authenticated"
  echo "  Run: gh auth login"
  # BLOCKER
fi

# Check repo scope
GH_SCOPES=$(gh auth status 2>&1 | grep -i "token scopes" || true)
if [[ -z "$GH_SCOPES" ]] || ! echo "$GH_SCOPES" | grep -qi "repo"; then
  echo "[FAIL] gh missing 'repo' scope"
  echo "  Run: gh auth refresh -s repo"
  # BLOCKER
else
  echo "[PASS] gh $GH_VERSION (authenticated, repo scope)"
fi

1.2 Check Git Configuration

# Check version >= 2.20.0
GIT_VERSION=$(git --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
GIT_MAJOR=$(echo "$GIT_VERSION" | cut -d. -f1)
GIT_MINOR=$(echo "$GIT_VERSION" | cut -d. -f2)
GIT_MAJOR=${GIT_MAJOR:-0}
GIT_MINOR=${GIT_MINOR:-0}
if [[ "$GIT_MAJOR" -lt 2 ]] || [[ "$GIT_MAJOR" -eq 2 && "$GIT_MINOR" -lt 20 ]]; then
  echo "[FAIL] git version $GIT_VERSION < 2.20.0"
  # BLOCKER
fi

# Check user.name configured
GIT_NAME=$(git config --get user.name || true)
if [[ -z "$GIT_NAME" ]]; then
  echo "[FAIL] git user.name not configured"
  echo "  Run: git config --global user.name \"Your Name\""
  # BLOCKER
fi

# Check user.email configured
GIT_EMAIL=$(git config --get user.email || true)
if [[ -z "$GIT_EMAIL" ]]; then
  echo "[FAIL] git user.email not configured"
  echo "  Run: git config --global user.email \"[email protected]\""
  # BLOCKER
else
  echo "[PASS] git $GIT_VERSION (user: $GIT_NAME <$GIT_EMAIL>)"
fi