aidevops 2.79.1 → 2.79.2

package/README.md

@@ -71,7 +71,7 @@ The result: AI agents that work *with* your development process, not around it.
 [![Services Supported](https://img.shields.io/badge/Services%20Supported-30+-brightgreen.svg)](#comprehensive-service-coverage)
 [![AGENTS.md](https://img.shields.io/badge/AGENTS.md-Compliant-blue.svg)](https://agents.md/)
 [![AI Optimized](https://img.shields.io/badge/AI%20Optimized-Yes-brightgreen.svg)](https://github.com/marcusquinn/aidevops/blob/main/AGENTS.md)
-[![MCP Servers](https://img.shields.io/badge/MCP%20Servers-20+-orange.svg)](#mcp-integrations)
+[![MCP Servers](https://img.shields.io/badge/MCP%20Servers-18-orange.svg)](#mcp-integrations)
 [![API Integrations](https://img.shields.io/badge/API%20Integrations-30+-blue.svg)](#comprehensive-service-coverage)
 
 <!-- AI-CONTEXT-START -->
@@ -153,7 +153,7 @@ git clone https://github.com/marcusquinn/aidevops.git ~/Git/aidevops
 - Configure your AI assistants automatically
 - Guide you through recommended tools (Tabby, Zed, Git CLIs)
 
-**New users: Start OpenCode and type `/onboarding`** to configure your services interactively. The onboarding wizard will:
+**New users: Start [OpenCode](https://opencode.ai/) and type `/onboarding`** to configure your services interactively. OpenCode is the recommended tool for aidevops - all features, agents, and workflows are designed and tested for it first. The onboarding wizard will:
 - Explain what **[aidevops](https://aidevops.sh)** can do
 - Ask about your work to give personalized recommendations
 - Show which services are configured vs need setup
@@ -374,13 +374,13 @@ The secure workflow is included at `.github/workflows/opencode-agent.yml`.
 
 See `.agent/tools/git/opencode-github-security.md` for the full security documentation.
 
-**Supported AI Assistants:** (OpenCode & Zed are our daily drivers and preferred tools, so will have the most continual testing. All 18 assistants below have MCP configuration support.)
+**Supported AI Assistants:** OpenCode is the recommended and primary-tested tool. All 18 assistants below have MCP configuration support, but only OpenCode receives continual testing and first-class integration. Other tools are supported as a courtesy for users evaluating aidevops capabilities.
 
-**Preferred:**
+**Recommended:**
 
-- **[Tabby](https://tabby.sh/)** - Modern terminal with colour-coded Profiles. Use different profile colours per project/repo to visually distinguish which codebase you're working in. **Auto-syncs tab title with git repo/branch.**
-- **[OpenCode](https://opencode.ai/)** - Primary choice. Powerful agentic TUI/CLI with native MCP support, Tab-based agent switching, and excellent DX.
-- **[Zed](https://zed.dev/)** - High-performance editor with AI (Preferred, with the OpenCode Agent Extension)
+- **[OpenCode](https://opencode.ai/)** - The recommended AI coding agent. Powerful agentic TUI/CLI with native MCP support, Tab-based agent switching, LSP integration, plugin ecosystem, and excellent DX. All aidevops features are designed and tested for OpenCode first.
+- **[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).
 
 ### Terminal Tab Title Sync
 
@@ -394,6 +394,8 @@ Your terminal tab/window title automatically shows `repo/branch` context when wo
 
 See `.agent/tools/terminal/terminal-title.md` for customization options.
 
+**Also Supported (community-tested):**
+
 **IDE-Based:**
 
 - **[Cursor](https://cursor.sh/)** - AI-first IDE with MCP support
@@ -663,34 +665,47 @@ The setup script offers to install these tools automatically.
 
 ## **MCP Integrations**
 
-**Model Context Protocol servers for real-time AI assistant integration.** The framework helps configure these MCPs for **18 AI assistants** including OpenCode (preferred), Cursor, Claude Code/Desktop, Windsurf, Continue.dev, Cody, Zed, GitHub Copilot, Kilo Code, Kiro, AntiGravity, Gemini CLI, Droid, Warp AI, Aider, and Qwen.
-
-### **All Supported MCPs**
-
-| MCP | Purpose | API Key Required |
-|-----|---------|------------------|
+**Model Context Protocol servers for real-time AI assistant integration.** The framework configures these MCPs primarily for **[OpenCode](https://opencode.ai/)** (recommended). Configuration support is also available for 17 other AI assistants including Cursor, Claude Code/Desktop, Windsurf, Continue.dev, Cody, Zed, GitHub Copilot, Kilo Code, Kiro, AntiGravity, Gemini CLI, Droid, Warp AI, Aider, and Qwen.
+
+### **All Supported MCPs (18 active)**
+
+MCP packages are installed globally via `bun install -g` for instant startup (no `npx` registry lookups). Run `setup.sh` or `aidevops update-tools` to update to latest versions.
+
+| MCP | Purpose | Tier | API Key Required |
+|-----|---------|------|------------------|
+| [Augment Context Engine](https://docs.augmentcode.com/context-services/mcp/overview) | Semantic codebase retrieval | Global | Yes (Augment account) |
+| [Claude Code MCP](https://github.com/steipete/claude-code-mcp) | Claude as sub-agent | Global | No |
+| [osgrep](https://github.com/Ryandonofrio3/osgrep) | Local semantic search | Global | No |
+| [Amazon Order History](https://github.com/marcusquinn/amazon-order-history-csv-download-mcp) | Order data extraction | Per-agent | No |
+| [Chrome DevTools](https://chromedevtools.github.io/devtools-protocol/) | Browser debugging & automation | Per-agent | No |
+| [Context7](https://context7.com/) | Library documentation lookup | Per-agent | No |
+| [Docker MCP](https://docs.docker.com/ai/mcp-catalog/) | Container management | Per-agent | No |
+| [Google Analytics](https://developers.google.com/analytics) | Analytics data | Per-agent | Yes (Google API) |
+| [Google Search Console](https://developers.google.com/webmaster-tools) | Search performance data | Per-agent | Yes (Google API) |
+| [Grep by Vercel](https://grep.app/) | GitHub code search | Per-agent | No |
+| [LocalWP](https://localwp.com/) | WordPress database access | Per-agent | No (local) |
+| [macOS Automator](https://github.com/steipete/macos-automator-mcp) | macOS automation | Per-agent | No |
+| [Outscraper](https://outscraper.com/) | Google Maps & business data | Per-agent | Yes |
+| [Playwriter](https://github.com/nicholasgriffintn/playwriter) | Browser with extensions | Per-agent | No |
+| [QuickFile](https://github.com/marcusquinn/quickfile-mcp) | Accounting API | Per-agent | Yes |
+| [Repomix](https://github.com/yamadashy/repomix) | Codebase packing for AI context | Per-agent | No |
+| [Sentry](https://sentry.io/) | Error tracking | Per-agent | Yes |
+| [Socket](https://socket.dev/) | Dependency security | Per-agent | No |
+
+**Tier explanation:**
+- **Global** - Tools always available (loaded into every session)
+- **Per-agent** - Tools disabled globally, enabled per-agent via config (zero context overhead when unused)
+
+### **SEO Integrations (curl subagents - no MCP overhead)**
+
+These use direct API calls via curl, avoiding MCP server startup entirely:
+
+| Integration | Purpose | API Key Required |
+|-------------|---------|------------------|
 | [Ahrefs](https://ahrefs.com/api) | SEO analysis & backlinks | Yes |
-| [Augment Context Engine](https://docs.augmentcode.com/context-services/mcp/overview) | Semantic codebase retrieval | Yes (Augment account) |
 | [DataForSEO](https://dataforseo.com/) | SERP, keywords, backlinks, on-page | Yes |
-| [Chrome DevTools](https://chromedevtools.github.io/devtools-protocol/) | Browser debugging & automation | No |
-| [Cloudflare Browser](https://developers.cloudflare.com/browser-rendering/) | Server-side rendering | Yes (Cloudflare) |
-| [Context7](https://context7.com/) | Library documentation lookup | No |
-| [Crawl4AI](https://github.com/unclecode/crawl4ai) | Web crawling & scraping | No |
-| [Google Search Console](https://developers.google.com/webmaster-tools) | Search performance data | Yes (Google API) |
-| [Grep by Vercel](https://grep.app/) | GitHub code search | No |
-| [LocalWP](https://localwp.com/) | WordPress database access | No (local) |
-| [Next.js DevTools](https://nextjs.org/docs) | React/Next.js assistance | No |
-| [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 (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 |
-| [Snyk](https://snyk.io/) | Security vulnerability scanning | Yes |
-| [Stagehand (JS)](https://github.com/browserbase/stagehand) | AI browser automation | Optional (Browserbase) |
-| [Stagehand (Python)](https://github.com/anthropics/stagehand-python) | AI browser automation | Optional (Browserbase) |
-| [llm-tldr](https://github.com/parcadei/llm-tldr) | Semantic code analysis (95% token savings) | No |
+| [Hostinger](https://developers.hostinger.com/) | Hosting management | Yes |
 
 ### **By Category**
 
@@ -715,12 +730,11 @@ The setup script offers to install these tools automatically.
 
 **SEO & Research:**
 
-- [Ahrefs](https://ahrefs.com/api) - SEO analysis, backlink research, keyword data
-- [DataForSEO](https://dataforseo.com/) - Comprehensive SEO data APIs (SERP, keywords, backlinks, on-page)
-- [Serper](https://serper.dev/) - Google Search API (web, images, news, places, shopping)
-- [Google Search Console](https://developers.google.com/webmaster-tools) - Search performance insights
-- [Perplexity](https://docs.perplexity.ai/) - AI-powered web search and research
-- [Grep by Vercel](https://grep.app/) - Search code snippets across GitHub repositories
+- [Google Search Console](https://developers.google.com/webmaster-tools) - Search performance insights (MCP)
+- [Grep by Vercel](https://grep.app/) - Search code snippets across GitHub repositories (MCP)
+- [Ahrefs](https://ahrefs.com/api) - SEO analysis, backlink research, keyword data (curl subagent)
+- [DataForSEO](https://dataforseo.com/) - Comprehensive SEO data APIs (curl subagent)
+- [Serper](https://serper.dev/) - Google Search API (curl subagent)
 - **Keyword Research** - Strategic keyword research with SERP weakness detection (via DataForSEO + Serper + Ahrefs)
 - **Site Crawler** - Screaming Frog-like SEO auditing: broken links, redirects, meta issues, structured data
 - **Domain Research** - DNS intelligence via THC (4.51B records) and Reconeer APIs: rDNS, subdomains, CNAMEs
@@ -739,9 +753,10 @@ The setup script offers to install these tools automatically.
 - [LocalWP](https://localwp.com/) - Direct WordPress database access
 - [Next.js DevTools](https://nextjs.org/docs) - React/Next.js development assistance
 
-**UI Components:**
+**Accounts & Finance:**
 
-- [shadcn/ui](https://ui.shadcn.com/) - Browse, search, and install shadcn/ui components directly via MCP
+- [QuickFile](https://github.com/marcusquinn/quickfile-mcp) - Accounting API integration (MCP)
+- [Amazon Order History](https://github.com/marcusquinn/amazon-order-history-csv-download-mcp) - Order data extraction (MCP)
 
 ### **Quick Setup**
 
@@ -756,6 +771,34 @@ bash .agent/scripts/setup-mcp-integrations.sh stagehand-both     # Both versions
 bash .agent/scripts/setup-mcp-integrations.sh chrome-devtools
 ```
 
+### OpenCode LSP Configuration
+
+OpenCode includes [built-in LSP servers](https://opencode.ai/docs/lsp/) for 35+ languages. For aidevops projects that use Markdown and TOON extensively, add these optional LSP servers to your `opencode.json` for real-time diagnostics during editing:
+
+```json
+{
+  "lsp": {
+    "markdownlint": {
+      "command": ["markdownlint-language-server", "--stdio"],
+      "extensions": [".md"]
+    },
+    "toon-lsp": {
+      "command": ["toon-lsp"],
+      "extensions": [".toon"]
+    }
+  }
+}
+```
+
+**Install the servers:**
+
+```bash
+npm install -g markdownlint-language-server  # Markdown diagnostics
+cargo install toon-lsp                        # TOON syntax validation
+```
+
+These catch formatting and syntax issues during editing, reducing preflight/postflight fix cycles.
+
 ## **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.
@@ -860,12 +903,14 @@ Repomix runs as an MCP server for direct AI assistant integration:
 {
   "repomix": {
     "type": "local",
-    "command": ["npx", "-y", "repomix@latest", "--mcp"],
+    "command": ["repomix", "--mcp"],
     "enabled": true
   }
 }
 ```
 
+> Install globally first: `bun install -g repomix` (done automatically by `setup.sh`)
+
 See `.agent/tools/context/context-builder.md` for complete documentation.
 
 ## **Augment Context Engine - Semantic Codebase Search**

package/VERSION

@@ -1 +1 @@
-2.79.1
+2.79.2

package/aidevops.sh

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "2.79.1",
+  "version": "2.79.2",
   "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.79.1
+# Version: 2.79.2
 #
 # Quick Install (one-liner):
 #   bash <(curl -fsSL https://aidevops.dev/install)
@@ -2161,57 +2161,47 @@ install_mcp_packages() {
         return 0
     fi
 
-    print_info "Using $installer for Node.js MCP packages..."
+    print_info "Using $installer to install/update Node.js MCP packages..."
 
-    local installed=0
-    local skipped=0
+    # Always install latest (bun install -g is fast and idempotent)
+    local updated=0
+    local failed=0
     for pkg in "${node_mcps[@]}"; do
-        # Extract binary name from package name (strip @scope/ prefix)
-        local bin_name
-        bin_name="${pkg##*/}"
-        if command -v "$bin_name" &> /dev/null; then
-            ((skipped++))
-            continue
-        fi
-        if $install_cmd "$pkg" > /dev/null 2>&1; then
-            ((installed++))
+        if $install_cmd "${pkg}@latest" > /dev/null 2>&1; then
+            ((updated++))
         else
-            print_warning "Failed to install $pkg"
+            ((failed++))
+            print_warning "Failed to install/update $pkg"
         fi
     done
 
-    if [[ $installed -gt 0 ]]; then
-        print_success "Installed $installed Node.js MCP packages via $installer"
+    if [[ $updated -gt 0 ]]; then
+        print_success "$updated Node.js MCP packages installed/updated to latest via $installer"
     fi
-    if [[ $skipped -gt 0 ]]; then
-        print_info "$skipped Node.js MCP packages already installed"
+    if [[ $failed -gt 0 ]]; then
+        print_warning "$failed packages failed (check network or package names)"
     fi
 
-    # Python MCP packages
+    # Python MCP packages (install or upgrade)
     if command -v pipx &> /dev/null; then
-        if ! command -v analytics-mcp &> /dev/null; then
-            print_info "Installing analytics-mcp via pipx..."
-            if pipx install analytics-mcp > /dev/null 2>&1; then
-                print_success "analytics-mcp installed"
-            else
-                print_warning "Failed to install analytics-mcp"
-            fi
+        print_info "Installing/updating analytics-mcp via pipx..."
+        if command -v analytics-mcp &> /dev/null; then
+            pipx upgrade analytics-mcp > /dev/null 2>&1 || true
+        else
+            pipx install analytics-mcp > /dev/null 2>&1 || print_warning "Failed to install analytics-mcp"
         fi
     fi
 
     if command -v uv &> /dev/null; then
-        if ! command -v outscraper-mcp-server &> /dev/null; then
-            print_info "Installing outscraper-mcp-server via uv..."
-            if uv tool install outscraper-mcp-server > /dev/null 2>&1; then
-                print_success "outscraper-mcp-server installed"
-            else
-                print_warning "Failed to install outscraper-mcp-server"
-            fi
+        print_info "Installing/updating outscraper-mcp-server via uv..."
+        if command -v outscraper-mcp-server &> /dev/null; then
+            uv tool upgrade outscraper-mcp-server > /dev/null 2>&1 || true
+        else
+            uv tool install outscraper-mcp-server > /dev/null 2>&1 || print_warning "Failed to install outscraper-mcp-server"
         fi
     fi
 
     print_info "MCP servers will start instantly (no registry lookups on each launch)"
-    print_info "Run 'aidevops update-tools' to check for updates"
     return 0
 }