fix: improve pyenv and Poetry detection in universal installer

- Add functional check for Poetry (poetry --version) before using it
- Detect pyenv and warn users about potential version mismatches
- Provide helpful error messages suggesting pyenv version switches
- Update README with clearer pyenv prerequisites and guidance
- Ensure installer falls back to pip when Poetry is not functional

This fixes the issue where Poetry command exists but fails due to
pyenv not finding it in the current Python version.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ryanmac

README.md

@@ -21,9 +21,9 @@
 
 **One command. Instant AI coordination.**
 
-**Prerequisites for all options:** Git, Python 3.9+, curl (for one-liner), and tar. Run from the root of an existing Git repository.
+**Prerequisites for all options:** Git, Python 3.9+, curl (for one-liner), and tar. Run from the root of an existing Git repository. **If using pyenv, ensure your active Python version (e.g., via `pyenv shell 3.12.x`) has Poetry installed if you prefer it; otherwise, the script falls back to pip.**
 
-### Option 1: Universal One-Liner (Recommended - No Cloning Required)
+### **Option 1: Universal One-Liner (Recommended - No Cloning Required)**
 Run this in your existing project's root directory to download and install Conductor-Score directly:
 
 ```bash
@@ -33,8 +33,9 @@ bash <(curl -fsSL https://raw.githubusercontent.com/ryanmac/conductor-score/main
 - This method avoids cloning the full Conductor-Score repo and is ideal for integrating into existing projects without repository pollution.
 - The script will prompt before overwriting any existing installation.
 - **Security best practice:** Review the script at the raw URL before running.
+- **Pyenv users:** If Poetry install fails, switch to the Python version that has Poetry installed (e.g., `pyenv shell 3.10.13`) and re-run.
 
-### Option 2: Poetry (Manual Clone)
+### Option 2: Poetry (For Cloned Repo)
 ```bash
 # Clone the repository
 git clone https://github.com/ryanmac/conductor-score.git
@@ -45,7 +46,7 @@ poetry install
 poetry run python setup.py
 ```
 
-### Option 3: Pip + Virtual Environment
+### Option 3: Pip + Virtual Environment (For Cloned Repo)
 ```bash
 # Clone the repository
 git clone https://github.com/ryanmac/conductor-score.git
@@ -62,7 +63,7 @@ pip install -r requirements.txt
 python setup.py
 ```
 
-### Option 4: One-Command Install Script (from cloned repo)
+### Option 4: One-Command Install Script (For Cloned Repo)
 ```bash
 # From the repository directory:
 ./install.sh

conductor-init.sh

@@ -51,6 +51,11 @@ if ! command -v tar >/dev/null 2>&1; then
     exit 1
 fi
 
+# **Improved: Check for pyenv and suggest version switch if Poetry fails later**
+if command -v pyenv >/dev/null 2>&1; then
+    echo -e "${YELLOW}⚠️ pyenv detected. Ensure your active Python version has Poetry installed if using it.${NC}"
+fi
+
 # Check for existing installation
 if [ -d ".conductor" ]; then
     echo -e "${YELLOW}⚠️ Existing .conductor directory found.${NC}"
@@ -127,15 +132,21 @@ echo ""
 # Step 3: Install Dependencies
 echo -e "${YELLOW}📦 Installing dependencies...${NC}"
 
-# Prefer Poetry if available, otherwise use pip + venv
-if command -v poetry >/dev/null 2>&1; then
-    echo "🎵 Poetry detected. Using Poetry for installation."
+# **Improved: Check if Poetry is functional before using it**
+POETRY_AVAILABLE=false
+if command -v poetry >/dev/null 2>&1 && poetry --version >/dev/null 2>&1; then
+    POETRY_AVAILABLE=true
+fi
+
+# Prefer Poetry if available and functional, otherwise use pip + venv
+if $POETRY_AVAILABLE; then
+    echo "🎵 Poetry detected and functional. Using Poetry for installation."
     poetry install || {
-        echo -e "${RED}❌ Poetry install failed.${NC}"
+        echo -e "${RED}❌ Poetry install failed. If using pyenv, try switching versions (e.g., pyenv shell 3.10.13) and re-run.${NC}"
         exit 1
     }
 else
-    echo "📦 Poetry not found. Using pip and virtual environment."
+    echo "📦 Poetry not found or not functional. Using pip and virtual environment."
     python3 -m venv .venv || {
         echo -e "${RED}❌ Failed to create virtual environment.${NC}"
         exit 1
@@ -158,7 +169,7 @@ echo ""
 echo -e "${YELLOW}🔧 Running automatic setup...${NC}"
 
 # Run setup.py with --auto flag
-if command -v poetry >/dev/null 2>&1; then
+if $POETRY_AVAILABLE; then
     poetry run python setup.py --auto || {
         echo -e "${RED}❌ Setup failed.${NC}"
         exit 1