aidevops 3.20.106 → 3.21.1

package/README.md

@@ -58,7 +58,7 @@ The result: an AI operations platform that manages projects across every busines
 [![Copyright](https://img.shields.io/badge/Copyright-Marcus%20Quinn%202025--2026-blue.svg)](https://github.com/marcusquinn)
 
 <!-- Release & Version Info -->
-[![Version](https://img.shields.io/badge/Version-3.20.106-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
+[![Version](https://img.shields.io/badge/Version-3.21.1-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
 [![npm version](https://img.shields.io/npm/v/aidevops)](https://www.npmjs.com/package/aidevops)
 [![Homebrew](https://img.shields.io/badge/homebrew-marcusquinn%2Ftap-orange)](https://github.com/marcusquinn/homebrew-tap)
 [![GitHub repository](https://img.shields.io/badge/github-repository-181717.svg?logo=github)](https://github.com/marcusquinn/aidevops)
@@ -79,6 +79,7 @@ The result: an AI operations platform that manages projects across every busines
 - **Recommended runtime/models**: OpenCode + OpenAI GPT-5.5 / GPT-5.4 mini
 - **Entry**: `aidevops` CLI, `~/.aidevops/agents/AGENTS.md`
 - **Stack**: Bash scripts, TypeScript (Bun), MCP servers
+- **Recent focus**: OpenCode control-plane safety, mobile simulator testing, self-hosted runner operations, and pulse/worker diagnostics
 
 ### Key Commands
 
@@ -93,13 +94,15 @@ The result: an AI operations platform that manages projects across every busines
 - `/auto-browse` - Learn, optimize, and graduate repeatable browser operations and web data-mining workflows
 - `/report-render` - Render report-ready Markdown or JSON to HTML with sticky TOC, print CSS, evidence badges, and source cards for PDF export
 - `/report-token-use` - Generate a local per-session token, model, compaction, and MCP-use report
+- `/pulse` - Run the autonomous supervisor loop for dispatch, merge, diagnostics, and stuck-work recovery
+- `/serve-sim` / `serve-sim-helper.sh` - Exercise mobile web flows in simulator-backed local previews
 
 ### Agent Structure
 
 - 12 primary agents (Build+, Automate, Product, SEO, Marketing-Sales, etc.) with specialist @subagents on demand
-- 2,050+ subagent markdown files organized by domain
-- 1,480+ helper scripts in `.agents/scripts/`
-- 90+ slash commands and workflow guides for common operations
+- 2,200+ agent and subagent markdown files organized by domain
+- 1,800+ helper scripts in `.agents/scripts/`
+- 185+ slash commands and workflow guides for common operations
 
 ### What You Can Ask aidevops To Do
 
@@ -109,6 +112,17 @@ The result: an AI operations platform that manages projects across every busines
 - Operate business, finance, receipts, invoices, marketing, outreach, SEO, content, video, and personal-productivity routines.
 - Discover the right capability with `/skills recommend "TASK"`, `/onboarding`, or the OpenCode agent picker.
 
+### Recent framework upgrades
+
+Since the last README feature refresh, aidevops has added or expanded:
+
+- **OpenCode GUI/control-plane planning**: ADRs, threat model, trust-boundary guidance, and containment rules for a future GUI that stays local-first, auditable, and explicitly separated from secret-bearing helpers (`docs/gui/`).
+- **Mobile and simulator workflows**: app-development guidance, App Store Connect support, Expo/Xcode/Swift workflows, Maestro/minisim/iOS Simulator MCP references, and `serve-sim` mobile web testing support (`.agents/tools/mobile/`).
+- **Self-hosted runner operations**: lifecycle and storage runbooks, Docker foreground-mode guidance, systemd timer freshness triage, and ExecStop race-guard documentation (`.agents/reference/github-self-hosted-runners.md`).
+- **Pulse diagnostics and reliability**: compact API-budget diagnostics, pulse cadence/API diagnostics, GitHub read ramp pacing, configurable worker floors, Renovate dashboard skipping, and more defensive duplicate/blocked-by/rate-limit handling.
+- **Worker and PR observability**: worker diagnostic failure families, runtime observability signals, review-thread response scanning, required-check validation, orphan-recovery base handling, and safer automated GitHub write guards.
+- **OpenCode runtime polish**: versioned session title suffixes, session archive retention, OAuth pool hardening, debug-error preservation, and reusable shell-env version lookup in the OpenCode plugin.
+
 <!-- AI-CONTEXT-END -->
 
 ## **Enterprise-Grade Quality & Security**
@@ -608,11 +622,12 @@ See `.agents/tools/terminal/terminal-title.md` for customization options.
 - **Supervisor** - SQLite state machine dispatches tasks to parallel AI agents with retry cycles, batch management, and cron scheduling
 - **Runners** - Named headless agent instances with persistent identity, instructions, and memory namespaces
 - **`/runners` command** - Batch dispatch from task IDs, PR URLs, or descriptions with concurrency control and progress monitoring
+- **Self-hosted runner operations** - GitHub runner lifecycle, storage, Docker foreground mode, systemd timers, and cleanup race guidance for reliable local/hosted worker capacity
 - **Mailbox** - SQLite-backed inter-agent messaging for coordination across parallel sessions
 - **Worktree isolation** - Each agent works on its own branch in a separate directory, no merge conflicts
 - **Budget tracking** - Append-only cost log (`budget-tracker-helper.sh`) with burn-rate analysis and `/budget-analysis` command for model routing decisions
 - **Observability** - LLM request capture plugin (`observability.mjs`) for cost tracking, performance analysis, and debugging
-- **Rate limits** - Per-provider rate limit configuration (`rate-limits.json`) with throttle-risk warnings
+- **Rate limits and API budget diagnostics** - Per-provider rate-limit configuration, secondary cooldown capture, reset-aware pacing, and compact API budget summaries for pulse and worker decisions
 
 **Project Intelligence:**
 
@@ -622,6 +637,8 @@ See `.agents/tools/terminal/terminal-title.md` for customization options.
 - **Local models** - Run AI models locally via llama.cpp for free, private, offline inference (`local-model-helper.sh`) with HuggingFace GGUF model management
 - **Tech stack lookup** - `/tech-stack` detects technology stacks of URLs or finds sites using specific technologies (Wappalyzer, httpx, nuclei, BuiltWith)
 - **IP reputation** - `ip-reputation-helper.sh` checks IP addresses against multiple reputation databases (Spamhaus, ProxyCheck, AbuseIPDB) before VPS purchase or deployment
+- **Mobile app guidance** - Expo, Swift/Xcode, App Store Connect, simulator automation, push/onboarding/monetisation/testing, and mobile web previews through `serve-sim`
+- **GUI control plane planning** - Local-first product scope, stack and repo-layout ADRs, GUI trust boundaries, and threat model for future aidevops UI surfaces
 
 **Conversational Memory & Entity System:**
 
@@ -819,6 +836,7 @@ The pulse is the heartbeat of aidevops — an autonomous AI supervisor that runs
 | **Advance missions** | Check active multi-day missions, dispatch features, validate milestones, track budget |
 | **Triage quality** | Read daily quality sweep findings (ShellCheck, SonarCloud, Codacy, CodeRabbit), create issues for actionable findings |
 | **Sync TODOs** | Create GitHub issues for unsynced TODO entries, commit ref changes |
+| **Respect API budget** | Use cached/prefetched GitHub metadata, cooldown headers, and ramp pacing before spending more API calls |
 | **Kill stuck workers** | Workers running 3+ hours with no PR are killed to free slots |
 | **Detect orphaned PRs** | Open PRs with no active worker and no activity for 6+ hours are flagged for re-dispatch |
 
@@ -827,6 +845,8 @@ The pulse is the heartbeat of aidevops — an autonomous AI supervisor that runs
 - **Struggle-ratio** — computes `messages / max(1, commits)` for each active worker. High ratio (>30) with >30 min elapsed and zero commits flags the worker as "struggling". Ratio >50 after 1 hour flags "thrashing". Informational signal — the supervisor LLM decides the action (kill, wait, re-dispatch with more context)
 - **Circuit breaker** — prevents cascading failures by tracking success/failure rates and tripping when error rate exceeds threshold
 - **Dynamic concurrency** — worker slot count adapts to available RAM, not a hardcoded constant
+- **API budget diagnostics** — compact reports show GitHub core/search usage, cooldown provenance, cached PR metadata freshness, and pacing decisions before pulse burns through API quota
+- **Worker failure families** — headless runtime errors, local runtime diagnostics, blocked-by lookup gaps, provider quota/credit exhaustion, and review-thread remediation issues are classified for targeted redispatch
 - **Stale assignment recovery** — tasks assigned to workers that died (no active process, no PR, 3+ hours stale) are automatically unassigned and made available for re-dispatch
 - **Priority ordering** — green PRs (free merge) > failing PRs (closer to done) > high-priority/bug issues > active mission features > product repos > smaller tasks > oldest
 
@@ -932,6 +952,7 @@ Run multiple AI sessions concurrently with isolated contexts. Named **runners**
 |---------|-------------|
 | **Headless dispatch** | `opencode run` for one-shot tasks, `opencode serve` + `--attach` for warm server |
 | **Runners** | Named agent instances with per-runner AGENTS.md, config, and run logs (`runner-helper.sh`) |
+| **Self-hosted runner runbooks** | GitHub runner storage, lifecycle, Docker foreground mode, timer freshness, and cleanup-race guidance (`.agents/reference/github-self-hosted-runners.md`) |
 | **Session management** | Resume sessions with `-s <id>` or `-c`, fork with SDK |
 | **Memory namespaces** | Per-runner memory isolation with shared access when needed |
 | **SDK orchestration** | `@opencode-ai/sdk` for TypeScript parallel dispatch via `Promise.all` |
@@ -1208,6 +1229,13 @@ The setup script offers to install these tools automatically.
 - **Local HTTPS previews**: `localdev-helper.sh` can wrap Open Design or other dev servers with mkcert-backed `.local` routes when tools only expose localhost.
 - **Verification**: `workflows/ui-verification.md`, `email-design-test-helper.sh`, design preview screenshots, and deck/media smoke tests provide evidence before generated artifacts ship.
 
+### **Mobile App & Simulator Testing**
+
+- **Mobile app stack guidance**: Expo, Swift/Xcode, backend, analytics, monetisation, onboarding, notification, publishing, and test strategy references for mobile delivery (`.agents/tools/mobile/`).
+- **Simulator-backed web testing**: `serve-sim` guidance and helpers cover local/mobile preview flows, prompt failure handling, and simulator smoke tests before mobile UI changes ship.
+- **Device and automation options**: agent-device, App Store Connect, Maestro, minisim, iOS Simulator MCP, Xcodebuild MCP, and accessibility tooling references help agents choose the right mobile verification path.
+- **Mobile-first artifact routing**: `/design-artifact` can route mobile mockups and app screens through the design stack, then hand implementation to mobile/testing specialists.
+
 ### **Video Creation**
 
 - **[Remotion](https://remotion.dev/)**: Programmatic video creation with React - animations, compositions, media handling, captions
@@ -1412,6 +1440,12 @@ These use direct API calls via curl, avoiding MCP server startup entirely:
   - Multi-profile management - Persistent/clean/warm/disposable profiles (like AdsPower/GoLogin)
   - Proxy integration - Residential, SOCKS5, VPN per profile with geo-targeting
 
+**Mobile & Simulator Testing:**
+
+- [serve-sim](https://github.com/EvanBacon/serve-sim) - Apple Simulator browser preview/control for iOS, iPad, and Apple Watch simulators (setup offers global install on supported Macs)
+- [agent-device](.agents/tools/mobile/agent-device.md) - AI-driven mobile app interaction across iOS and Android
+- [Maestro](.agents/tools/mobile/maestro.md) - Repeatable YAML E2E flows for mobile apps
+
 **SEO & Research:**
 
 - [Google Search Console](https://developers.google.com/webmaster-tools) - Search performance insights (MCP)
@@ -1547,6 +1581,7 @@ Tested on macOS ARM64, all headless, warm daemon:
 | **Self-hosted crawling** | WaterCrawl | Docker deployment, web search, sitemap generation |
 | **CLI/CI/CD** | playwright-cli or agent-browser | No server needed, `--session` isolation |
 | **iOS mobile testing** | agent-browser | Real Safari in iOS Simulator (macOS only) |
+| **Apple Simulator streaming** | serve-sim | Browser-visible iOS/iPad/watch simulator stream and control (macOS Apple Silicon) |
 | **Unknown pages** | Stagehand | Natural language, self-healing |
 | **Performance debugging** | Chrome DevTools MCP | Companion tool, pairs with any browser |
 | **Mobile/tablet emulation** | Playwright | 100+ device presets, viewport, touch, geolocation, locale |
@@ -2649,6 +2684,7 @@ bash .agents/scripts/continue-cli.sh review
 - **[API Integrations](.agents/aidevops/api-integrations.md)** - Service APIs
 - **[Browser Automation](.agents/tools/browser/browser-automation.md)** - 8 tools + anti-detect stack: decision tree, parallel, extensions, fingerprinting
 - **[Device Emulation](.agents/tools/browser/playwright-emulation.md)** - Mobile/tablet testing: 100+ device presets, viewport, geolocation, locale, dark mode
+- **[serve-sim](.agents/tools/mobile/serve-sim.md)** - Apple Simulator browser preview/control for mobile app QA
 - **[Anti-Detect Browser](.agents/tools/browser/anti-detect-browser.md)** - Multi-profile management, fingerprint rotation, proxy integration
 - **[Web Performance](.agents/tools/performance/performance.md)** - Core Web Vitals, network dependencies, accessibility (Chrome DevTools MCP)
 - **[PageSpeed](.agents/tools/browser/pagespeed.md)** - Lighthouse CLI and PageSpeed Insights API

package/VERSION

@@ -1 +1 @@
-3.20.106
+3.21.1

package/aidevops.sh

@@ -5,7 +5,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 3.20.106
+# Version: 3.21.1
 
 set -euo pipefail
 

package/package.json

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

package/setup.sh

@@ -12,7 +12,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.20.106
+# Version: 3.21.1
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)
@@ -1268,7 +1268,7 @@ _setup_run_interactive() {
 	confirm_step "Check Python version (recommend upgrade if outdated)" && check_python_upgrade_available
 	confirm_step "Setup recommended tools (Tabby, Zed, etc.)" && setup_recommended_tools
 	confirm_step "Setup PIM tools (Reminders, Calendar, Contacts)" && setup_pim_tools
-	confirm_step "Setup MiniSim (iOS/Android emulator launcher)" && setup_minisim
+	confirm_step "Setup mobile simulator tools (MiniSim, serve-sim)" && setup_mobile_simulator_tools
 	confirm_step "Setup ClaudeBar (AI quota monitor in menu bar)" && setup_claudebar
 	confirm_step "Setup Git CLIs (gh, glab, tea)" && setup_git_clis
 	confirm_step "Setup file discovery tools (fd, ripgrep, ripgrep-all)" && setup_file_discovery_tools