aidevops 3.1.80 → 3.1.82

package/README.md

@@ -179,6 +179,7 @@ git clone https://github.com/marcusquinn/aidevops.git ~/Git/aidevops
 
 ```bash
 aidevops status           # Check what's installed
+aidevops doctor           # Detect duplicate installs and PATH conflicts
 aidevops update           # Update framework + check registered projects
 aidevops auto-update      # Manage automatic update polling (every 10 min)
 aidevops init             # Initialize aidevops in any project
@@ -419,7 +420,7 @@ aidevops model-accounts-pool remove <p> <email># Remove an account
 
 > **Note:** `reset-cooldowns` clears cooldowns in the pool file. If OpenCode is already running, the in-memory token endpoint cooldown is only cleared when OpenCode restarts or when you use the `/model-accounts-pool reset-cooldowns` slash command inside an active session.
 
-**If you prefer guided help:** Open OpenCode with a free model (OpenCode Zen includes free models that don't require any API key or subscription) and ask it to read the auth troubleshooting agent:
+**If you prefer guided help:** Open OpenCode with a free model (OpenCode Zen includes free models that don't require any API key or subscription) and run the auth troubleshooting agent by typing:
 
 ```
 @auth-troubleshooting

package/VERSION

@@ -1 +1 @@
-3.1.80
+3.1.82

package/aidevops.sh

@@ -3,7 +3,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 3.1.80
+# Version: 3.1.82
 
 set -euo pipefail
 
@@ -3599,6 +3599,7 @@ cmd_help() {
 	echo "  skills <cmd>       Discover skills (search/browse/describe/recommend)"
 	echo "  plugin <cmd>       Manage plugins (add/list/update/enable/disable/remove)"
 	echo "  status             Check installation status of all components"
+	echo "  doctor             Detect duplicate installs and PATH conflicts (--fix to resolve)"
 	echo "  update             Update aidevops to the latest version (alias: upgrade)"
 	echo "  upgrade            Alias for update"
 	echo "  pulse <cmd>        Session-based pulse control (start/stop/status)"
@@ -3624,6 +3625,8 @@ cmd_help() {
 	echo "  aidevops upgrade-planning    # Upgrade planning files to latest"
 	echo "  aidevops features            # List available features"
 	echo "  aidevops status              # Check what's installed"
+	echo "  aidevops doctor              # Find duplicate/conflicting installs"
+	echo "  aidevops doctor --fix        # Interactively remove duplicates"
 	echo "  aidevops update              # Update framework + check projects"
 	echo "  aidevops repos               # List registered projects"
 	echo "  aidevops repos add           # Register current project"
@@ -3650,13 +3653,13 @@ cmd_help() {
 	echo "  aidevops model-accounts-pool status            # Pool health at a glance"
 	echo "  aidevops model-accounts-pool list              # Per-account detail"
 	echo "  aidevops model-accounts-pool check             # Live token validity test"
-	echo "  aidevops model-accounts-pool rotate [provider] # Switch to next account NOW"
+	echo "  aidevops model-accounts-pool rotate [provider] # Switch to next available account NOW (use when rate-limited)"
 	echo "  aidevops model-accounts-pool reset-cooldowns   # Clear rate-limit cooldowns"
 	echo "  aidevops model-accounts-pool add anthropic     # Add Claude Pro/Max account"
 	echo "  aidevops model-accounts-pool add openai        # Add ChatGPT Plus/Pro account"
 	echo "  aidevops model-accounts-pool add cursor        # Add Cursor Pro account"
 	echo "  aidevops model-accounts-pool import claude-cli # Import from Claude CLI auth"
-	echo "  aidevops model-accounts-pool assign-pending <p># Assign stranded token"
+	echo "  aidevops model-accounts-pool assign-pending <provider># Assign stranded token"
 	echo "  aidevops model-accounts-pool remove <p> <email># Remove an account"
 	echo ""
 	echo "  Auth recovery (run these in order if model is broken):"
@@ -3899,6 +3902,19 @@ main() {
 			exit 1
 		fi
 		;;
+	doctor | doc)
+		shift
+		local doctor_helper="$AGENTS_DIR/scripts/doctor-helper.sh"
+		if [[ ! -f "$doctor_helper" ]]; then
+			doctor_helper="$INSTALL_DIR/.agents/scripts/doctor-helper.sh"
+		fi
+		if [[ -f "$doctor_helper" ]]; then
+			bash "$doctor_helper" "$@"
+		else
+			print_error "doctor-helper.sh not found. Run: aidevops update"
+			exit 1
+		fi
+		;;
 	detect | scan)
 		cmd_detect
 		;;

package/bin/aidevops

@@ -1,22 +1,48 @@
 #!/usr/bin/env bash
 # AI DevOps Framework CLI wrapper
-# This wrapper handles both npm global install and local development.
+# This wrapper handles npm/brew/bun global installs and local development.
 #
 # Priority order (highest to lowest):
 #   1. ~/Git/aidevops/aidevops.sh  — git repo, always current via 'aidevops update'
-#   2. npm-bundled aidevops.sh     — snapshot at npm publish time, may be stale
+#   2. Auto-clone the git repo     — first-run bootstrap for package manager installs
+#   3. npm-bundled aidevops.sh     — snapshot at npm publish time, may be stale
 #
 # The repo copy is preferred so that 'aidevops update' (git pull) immediately
 # takes effect without requiring 'npm update -g aidevops'.
 
 set -euo pipefail
 
+REPO_DIR="$HOME/Git/aidevops"
+REPO_URL="https://github.com/marcusquinn/aidevops.git"
+
 # 1. Prefer the git repo copy — always current via 'aidevops update'
-if [[ -f "$HOME/Git/aidevops/aidevops.sh" ]]; then
-    exec bash "$HOME/Git/aidevops/aidevops.sh" "$@"
+if [[ -f "$REPO_DIR/aidevops.sh" ]]; then
+    exec bash "$REPO_DIR/aidevops.sh" "$@"
+fi
+
+# 2. Git repo not found — bootstrap it automatically
+# This runs once on first use after a package manager install (npm/brew/bun).
+# After this, step 1 will always match and the git repo runs directly.
+if command -v git >/dev/null 2>&1; then
+    echo "[aidevops] First run — cloning git repo to $REPO_DIR for transparent updates..."
+    mkdir -p "$(dirname "$REPO_DIR")"
+    if git clone "$REPO_URL" "$REPO_DIR" 2>/dev/null; then
+        echo "[aidevops] Running setup..."
+        if [[ -f "$REPO_DIR/setup.sh" ]]; then
+            bash "$REPO_DIR/setup.sh" --non-interactive
+        fi
+        echo ""
+        echo "[aidevops] Setup complete. The git repo at $REPO_DIR is now your canonical install."
+        echo "[aidevops] Run 'aidevops update' to stay current. You can safely remove the"
+        echo "[aidevops] package manager copy (npm/brew/bun) — it's no longer needed."
+        echo ""
+        exec bash "$REPO_DIR/aidevops.sh" "$@"
+    else
+        echo "[aidevops] Git clone failed — falling back to bundled copy." >&2
+    fi
 fi
 
-# 2. Fall back to the npm-bundled copy (resolve symlinks first)
+# 3. Fall back to the npm-bundled copy (resolve symlinks first)
 # npm install -g creates a symlink: /usr/local/bin/aidevops -> .../node_modules/aidevops/bin/aidevops
 # BASH_SOURCE[0] returns the symlink path, not the target, so we must resolve it
 SOURCE="${BASH_SOURCE[0]}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "3.1.80",
+  "version": "3.1.82",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "bin": {

package/setup.sh

@@ -10,7 +10,7 @@ shopt -s inherit_errexit 2>/dev/null || true
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 3.1.80
+# Version: 3.1.82
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)