complete-setup

Complete Setup (macOS only)

Scope

This skill performs safe environment setup for beginners on macOS only.

If the platform is not macOS, stop and explain that non-macOS setup is deferred in this iteration.

Python support target: >=3.11,<4.0.

Safety Rules (hard)

Never do these during onboarding:

• Replace or delete system Python binaries/symlinks
• Change OS-managed default Python interpreter mapping
• Require global shell aliases for python3
• Use sudo pip
• Advance to the next phase before validation passes

Always prefer explicit interpreter usage (python3.12 or python3.11) over system mutation.

Workflow Checklist

Copy and update this checklist while running setup:

Setup Progress:
- [ ] Phase 1: Detection gates passed
- [ ] Phase 2: Python available (>=3.11)
- [ ] Phase 3: Package installed and `resilio` runnable
- [ ] Phase 4: Config initialized
- [ ] Phase 5: Final verification + handoff

Phase 1: Detection Gates (must run in order)

Gate 1: Repo root

if [ ! -f pyproject.toml ] || [ ! -d resilio ]; then
  echo "Not in repo root. cd into resilio and retry."
  exit 1
fi

Gate 2: Platform

uname

• Darwin -> continue
• anything else -> stop with defer message

Gate 3: Interpreter selection (safe)

PYTHON_CMD=""
if command -v python3 >/dev/null 2>&1 && python3 -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 11) else 1)'; then
  PYTHON_CMD="python3"
elif command -v python3.12 >/dev/null 2>&1; then
  PYTHON_CMD="python3.12"
elif command -v python3.11 >/dev/null 2>&1; then
  PYTHON_CMD="python3.11"
fi

• PYTHON_CMD set -> Python gate passed
• empty -> run Phase 2

Gate 4: Install path discovery

poetry --version >/dev/null 2>&1

• success -> Poetry path available
• failure -> venv path

Gate 5: Package runnable check

PACKAGE_READY=false
if command -v resilio >/dev/null 2>&1; then
  resilio --help >/dev/null 2>&1 && PACKAGE_READY=true
elif poetry --version >/dev/null 2>&1; then
  poetry run resilio --help >/dev/null 2>&1 && PACKAGE_READY=true
fi