aidevops 3.1.68 → 3.1.70

package/README.md

@@ -366,6 +366,52 @@ See `.agents/tools/git/opencode-github-security.md` for the full security docume
 - **[Tabby](https://tabby.sh/)** - Recommended terminal. Colour-coded Profiles per project/repo, **auto-syncs tab title with git repo/branch.**
 - **[Zed](https://zed.dev/)** - Recommended editor. High-performance with AI integration (use with the OpenCode Agent Extension).
 
+### Troubleshooting Auth
+
+If you see **"Anthropic Key Missing"**, **"OpenAI Key Missing"**, or the model stops responding, run these commands from any terminal — no working model session required.
+
+**Step 1 — Check pool health**
+
+```bash
+aidevops model-accounts-pool status       # counts: available / rate-limited / auth-error
+aidevops model-accounts-pool check        # live token validity test per account
+```
+
+**Step 2 — Fix based on what you see**
+
+| Symptom | Command |
+|---------|---------|
+| Account shows `rate-limited` | `aidevops model-accounts-pool rotate anthropic` |
+| All accounts in cooldown | `aidevops model-accounts-pool reset-cooldowns` |
+| Account shows `auth-error` | `aidevops model-accounts-pool add anthropic` (re-auth) |
+| Pool is empty (no accounts) | `aidevops model-accounts-pool add anthropic` |
+| Recently re-authed, still broken | `aidevops model-accounts-pool assign-pending anthropic` |
+
+**Step 3 — If still broken, re-add the account**
+
+```bash
+aidevops model-accounts-pool add anthropic     # Claude Pro/Max — opens browser OAuth
+aidevops model-accounts-pool add openai        # ChatGPT Plus/Pro
+aidevops model-accounts-pool add cursor        # Cursor Pro (reads from local IDE)
+aidevops model-accounts-pool import claude-cli # Import from existing Claude CLI auth
+```
+
+Restart OpenCode after any `add`, `rotate`, or `reset-cooldowns` to pick up the new credentials.
+
+**Full command reference**
+
+```bash
+aidevops model-accounts-pool status            # Pool health at a glance
+aidevops model-accounts-pool list              # Per-account detail + expiry
+aidevops model-accounts-pool check             # Live API validity test
+aidevops model-accounts-pool rotate [provider] # Switch to next available account NOW
+aidevops model-accounts-pool reset-cooldowns   # Clear all rate-limit cooldowns
+aidevops model-accounts-pool assign-pending <p># Assign stranded pending token
+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.
+
 ### Terminal Tab Title Sync
 
 Your terminal tab/window title automatically shows `repo/branch` context when working in git repositories. This helps identify which codebase and branch you're working on across multiple terminal sessions.

package/VERSION

@@ -1 +1 @@
-3.1.68
+3.1.70

package/aidevops.sh

@@ -3,7 +3,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 3.1.68
+# Version: 3.1.70
 
 set -euo pipefail
 
@@ -3646,21 +3646,24 @@ cmd_help() {
 	echo "  aidevops ip-check cache-stats# Show cache statistics"
 	echo ""
 	echo "Model Accounts Pool (OAuth):"
-	echo "  aidevops model-accounts-pool list              # List accounts + status"
-	echo "  aidevops model-accounts-pool check             # Test token validity (live)"
+	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 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 rotate [provider] # Rotate to next account"
-	echo "  aidevops model-accounts-pool reset-cooldowns   # Clear rate-limit cooldowns"
+	echo "  aidevops model-accounts-pool assign-pending <p># Assign stranded token"
 	echo "  aidevops model-accounts-pool remove <p> <email># Remove an account"
 	echo ""
-	echo "  If you see 'Key Missing' or auth errors:"
-	echo "    aidevops model-accounts-pool list            # 1. See what's in the pool"
+	echo "  Auth recovery (run these in order if model is broken):"
+	echo "    aidevops model-accounts-pool status          # 1. Check pool health"
 	echo "    aidevops model-accounts-pool check           # 2. Test token validity"
-	echo "    aidevops model-accounts-pool reset-cooldowns # 3. Clear any cooldowns"
-	echo "    aidevops model-accounts-pool add anthropic   # 4. Re-add if pool empty"
+	echo "    aidevops model-accounts-pool rotate anthropic# 3. Switch account if rate-limited"
+	echo "    aidevops model-accounts-pool reset-cooldowns # 4. Clear cooldowns if all stuck"
+	echo "    aidevops model-accounts-pool add anthropic   # 5. Re-add if pool empty"
 	echo ""
 	echo "Secrets:"
 	echo "  aidevops secret set NAME     # Store a secret (hidden input)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "3.1.68",
+  "version": "3.1.70",
   "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.68
+# Version: 3.1.70
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)