aidevops 2.76.1 → 2.77.1

package/README.md

@@ -91,9 +91,10 @@ The result: AI agents that work *with* your development process, not around it.
 
 ### Agent Structure
 
-- ~15 main agents (Plan+, Build+, SEO, WordPress, etc.)
-- 230+ subagent markdown files organized by domain
-- 130+ helper scripts in `.agent/scripts/`
+- 18 primary agents (Plan+, Build+, SEO, WordPress, etc.)
+- 530+ subagent markdown files organized by domain
+- 139+ helper scripts in `.agent/scripts/`
+- 41 slash commands for common workflows
 
 <!-- AI-CONTEXT-END -->
 
@@ -483,7 +484,7 @@ aidevops implements proven agent design patterns identified by [Lance Martin (La
 
 | Pattern | Description | aidevops Implementation |
 |---------|-------------|------------------------|
-| **Give Agents a Computer** | Filesystem + shell for persistent context | `~/.aidevops/.agent-workspace/`, 130+ helper scripts |
+| **Give Agents a Computer** | Filesystem + shell for persistent context | `~/.aidevops/.agent-workspace/`, 139+ helper scripts |
 | **Multi-Layer Action Space** | Few tools, push actions to computer | Per-agent MCP filtering (~12-20 tools each) |
 | **Progressive Disclosure** | Load context on-demand | Subagent routing with content summaries, YAML frontmatter, read-on-demand |
 | **Offload Context** | Write results to filesystem | `.agent-workspace/work/[project]/` for persistence |
@@ -681,7 +682,7 @@ The setup script offers to install these tools automatically.
 | [Outscraper](https://outscraper.com/) | Google Maps & business data extraction | Yes |
 | [PageSpeed Insights](https://developers.google.com/speed/docs/insights/v5/get-started) | Performance auditing | Yes (Google API) |
 | [Perplexity](https://docs.perplexity.ai/) | AI-powered research | Yes |
-| [Playwright](https://playwright.dev/) | Cross-browser testing | No |
+| [Playwright](https://playwright.dev/) | Cross-browser testing (auto-installed by setup.sh) | No |
 | [Repomix](https://github.com/yamadashy/repomix) | Codebase packing for AI context | No |
 | [Serper](https://serper.dev/) | Google Search API (web, images, news) | Yes |
 | [shadcn/ui](https://ui.shadcn.com/) | UI component library browsing & installation | No |
@@ -700,13 +701,15 @@ The setup script offers to install these tools automatically.
 - [Context7](https://context7.com/) - Real-time documentation access for thousands of libraries
 - [Repomix](https://github.com/yamadashy/repomix) - Pack codebases into AI-friendly context
 
-**Browser Automation:**
+**Browser Automation** (6 tools, [benchmarked](#browser-automation)):
 
-- [Stagehand (JavaScript)](https://github.com/browserbase/stagehand) - AI-powered browser automation with natural language
-- [Stagehand (Python)](https://github.com/anthropics/stagehand-python) - Python version with Pydantic validation
-- [Chrome DevTools](https://chromedevtools.github.io/devtools-protocol/) - Browser automation, performance analysis, debugging
-- [Playwright](https://playwright.dev/) - Cross-browser testing and automation
-- [Crawl4AI](https://github.com/unclecode/crawl4ai) - Async web crawler optimized for AI
+- [Playwright](https://playwright.dev/) - Fastest engine (0.9s form fill), parallel contexts, extensions, proxy (auto-installed)
+- [dev-browser](https://github.com/nicholasgriffintn/dev-browser) - Persistent profile, stays logged in, ARIA snapshots, pairs with DevTools
+- [agent-browser](https://github.com/vercel-labs/agent-browser) - CLI/CI/CD, `--session` parallel, ref-based element targeting
+- [Crawl4AI](https://github.com/unclecode/crawl4ai) - Bulk extraction, `arun_many` parallel (1.7x), LLM-ready markdown
+- [Playwriter](https://github.com/nicholasgriffintn/playwriter) - Your browser's extensions/passwords/proxy, already unlocked
+- [Stagehand](https://github.com/browserbase/stagehand) - Natural language automation, self-healing selectors
+- [Chrome DevTools MCP](https://github.com/nicholasgriffintn/chrome-devtools-mcp) - Companion: Lighthouse, network throttling, CSS coverage (pairs with any tool)
 - [Cloudflare Browser Rendering](https://developers.cloudflare.com/browser-rendering/) - Server-side web scraping
 
 **SEO & Research:**
@@ -752,6 +755,60 @@ bash .agent/scripts/setup-mcp-integrations.sh stagehand-both     # Both versions
 bash .agent/scripts/setup-mcp-integrations.sh chrome-devtools
 ```
 
+## **Browser Automation**
+
+6 browser tools benchmarked and integrated for AI-assisted web automation, dev testing, and data extraction. Agents automatically select the optimal tool based on task requirements.
+
+### Performance Benchmarks
+
+Tested on macOS ARM64, all headless, warm daemon:
+
+| Test | Playwright | dev-browser | agent-browser | Crawl4AI | Playwriter | Stagehand |
+|------|-----------|-------------|---------------|----------|------------|-----------|
+| **Navigate + Screenshot** | **1.43s** | 1.39s | 1.90s | 2.78s | 2.95s | 7.72s |
+| **Form Fill** (4 fields) | **0.90s** | 1.34s | 1.37s | N/A | 2.24s | 2.58s |
+| **Data Extraction** (5 items) | 1.33s | **1.08s** | 1.53s | 2.53s | 2.68s | 3.48s |
+| **Multi-step** (click + nav) | **1.49s** | 1.49s | 3.06s | N/A | 4.37s | 4.48s |
+| **Parallel** (3 sessions) | **1.6s** | N/A | 2.0s | 3.0s | N/A | Slow |
+
+### Feature Matrix
+
+| Feature | Playwright | dev-browser | agent-browser | Crawl4AI | Playwriter | Stagehand |
+|---------|-----------|-------------|---------------|----------|------------|-----------|
+| **Headless** | Yes | Yes | Yes | Yes | No (your browser) | Yes |
+| **Proxy/VPN** | Full | Via args | No | Full | Your browser | Via args |
+| **Extensions** | Yes (persistent) | Yes (profile) | No | No | Yes (yours) | Possible |
+| **Password managers** | Partial (needs unlock) | Partial | No | No | **Yes** (unlocked) | No |
+| **Parallel sessions** | 5 ctx/2.1s | Shared | 3 sess/2.0s | arun_many 1.7x | Shared | Per-instance |
+| **Session persistence** | storageState | Profile dir | state save/load | user_data_dir | Your browser | Per-instance |
+| **Natural language** | No | No | No | LLM extraction | No | Yes |
+| **Self-healing** | No | No | No | No | No | Yes |
+
+### Tool Selection
+
+| Need | Tool | Why |
+|------|------|-----|
+| **Fastest automation** | Playwright | 0.9s form fill, parallel contexts |
+| **Stay logged in** | dev-browser | Profile persists across restarts |
+| **Your extensions/passwords** | Playwriter | Already unlocked in your browser |
+| **Bulk extraction** | Crawl4AI | Purpose-built, parallel, LLM-ready output |
+| **CLI/CI/CD** | agent-browser | No server needed, `--session` isolation |
+| **Unknown pages** | Stagehand | Natural language, self-healing |
+| **Performance debugging** | Chrome DevTools MCP | Companion tool, pairs with any browser |
+
+### AI Page Understanding
+
+Agents use lightweight methods instead of expensive vision API calls:
+
+| Method | Speed | Token Cost | Use For |
+|--------|-------|-----------|---------|
+| ARIA snapshot | ~0.01s | 50-200 tokens | Forms, navigation, interactive elements |
+| Text extraction | ~0.002s | Text length | Reading content |
+| Element scan | ~0.002s | ~20/element | Form filling, clicking |
+| Screenshot | ~0.05s | ~1K tokens (vision) | Visual debugging only |
+
+See [`.agent/tools/browser/browser-automation.md`](.agent/tools/browser/browser-automation.md) for the full decision tree and [`browser-benchmark.md`](.agent/tools/browser/browser-benchmark.md) for reproducible benchmark scripts.
+
 ## **Repomix - AI Context Generation**
 
 [Repomix](https://repomix.com/) packages your codebase into AI-friendly formats for sharing with AI assistants. This framework includes optimized Repomix configuration for consistent context generation.
@@ -975,7 +1032,7 @@ aidevops is registered as a **Claude Code plugin marketplace**. Install with two
 /plugin install aidevops@aidevops
 ```
 
-This installs the complete framework: 13 domain agents, 225+ subagents, and 130+ helper scripts.
+This installs the complete framework: 18 primary agents, 530+ subagents, and 139+ helper scripts.
 
 ### Importing External Skills
 
@@ -1055,7 +1112,7 @@ Ordered as they appear in OpenCode Tab selector and other AI assistants (15 tota
 
 ### **Example Subagents with MCP Integration**
 
-These are examples of subagents that have supporting MCPs enabled. See `.agent/` for the full list of 225+ subagents organized by domain.
+These are examples of subagents that have supporting MCPs enabled. See `.agent/` for the full list of 530+ subagents organized by domain.
 
 | Agent | Purpose | MCPs Enabled |
 |-------|---------|--------------|
@@ -1591,7 +1648,7 @@ bash .agent/scripts/continue-cli.sh review
 **Agent Guides** (in `.agent/`):
 
 - **[API Integrations](.agent/aidevops/api-integrations.md)** - Service APIs
-- **[Browser Automation](.agent/tools/browser/browser-automation.md)** - Web scraping and automation
+- **[Browser Automation](.agent/tools/browser/browser-automation.md)** - 6 tools benchmarked: decision tree, parallel, extensions, AI understanding
 - **[PageSpeed](.agent/tools/browser/pagespeed.md)** - Performance auditing
 - **[Pandoc](.agent/tools/conversion/pandoc.md)** - Document format conversion
 - **[Security](.agent/aidevops/security.md)** - Enterprise security standards
@@ -1606,8 +1663,8 @@ aidevops/
 ├── AGENTS.md                      # AI agent guidance (dev)
 ├── .agent/                        # Agents and documentation
 │   ├── AGENTS.md                  # User guide (deployed to ~/.aidevops/agents/)
-│   ├── *.md                       # 13 main agents
-│   ├── scripts/                   # 130+ helper scripts
+│   ├── *.md                       # 18 primary agents
+│   ├── scripts/                   # 139+ helper scripts
 │   ├── tools/                     # Cross-domain utilities (video, browser, git, etc.)
 │   ├── services/                  # External service integrations
 │   └── workflows/                 # Development process guides

package/VERSION

@@ -1 +1 @@
-2.76.1
+2.77.1

package/aidevops.sh

@@ -3,7 +3,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 2.76.1
+# Version: 2.77.1
 
 set -euo pipefail
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "2.76.1",
+  "version": "2.77.1",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "main": "index.js",

package/setup.sh

@@ -3,7 +3,7 @@
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 2.76.1
+# Version: 2.77.1
 #
 # Quick Install (one-liner):
 #   bash <(curl -fsSL https://aidevops.dev/install)
@@ -2322,7 +2322,40 @@ setup_browser_tools() {
         print_warning "Node.js not found - Playwriter MCP unavailable"
     fi
     
-    print_info "Browser tools: dev-browser (stateful), Playwriter (extension), Stagehand (AI)"
+    # Playwright MCP (cross-browser testing automation)
+    if [[ "$has_node" == "true" ]]; then
+        print_info "Setting up Playwright MCP..."
+        
+        # Check if Playwright browsers are installed (--no-install prevents auto-download)
+        if npx --no-install playwright --version &> /dev/null 2>&1; then
+            print_success "Playwright already installed"
+        else
+            local install_playwright
+            read -r -p "Install Playwright MCP with browsers (chromium, firefox, webkit)? (y/n): " install_playwright
+            
+            if [[ "$install_playwright" == "y" ]]; then
+                print_info "Installing Playwright browsers..."
+                if npx playwright install; then
+                    print_success "Playwright browsers installed"
+                else
+                    print_warning "Playwright browser installation failed"
+                    print_info "Run manually: npx playwright install"
+                fi
+            else
+                print_info "Skipped Playwright installation"
+                print_info "Install later with: npx playwright install"
+            fi
+        fi
+        
+        print_info "Playwright MCP runs via: npx playwright-mcp@latest"
+    fi
+    
+    if [[ "$has_node" == "true" ]]; then
+        print_info "Browser tools: dev-browser (stateful), Playwriter (extension), Playwright (testing), Stagehand (AI)"
+    else
+        print_info "Browser tools: dev-browser (stateful), Stagehand (AI)"
+    fi
+    return 0
 }
 
 # Setup AI Orchestration Frameworks (Langflow, CrewAI, AutoGen)