aidevops 3.1.117 → 3.1.119

package/VERSION

@@ -1 +1 @@
-3.1.117
+3.1.119

package/aidevops.sh

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

package/package.json

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

package/setup-modules/post-setup.sh

@@ -0,0 +1,167 @@
+#!/usr/bin/env bash
+# Post-setup functions: auto-update enablement, final instructions, onboarding prompt.
+# Part of aidevops setup.sh modularization (GH#5793)
+
+# Shell safety baseline
+set -Eeuo pipefail
+IFS=$'\n\t'
+# shellcheck disable=SC2154  # rc is assigned by $? in the trap string
+trap 'rc=$?; echo "[ERROR] ${BASH_SOURCE[0]}:${LINENO} exit $rc" >&2' ERR
+shopt -s inherit_errexit 2>/dev/null || true
+
+# Enable auto-update if not already enabled.
+# Check both launchd (macOS) and cron (Linux) for existing installation.
+# Respects config: aidevops config set updates.auto_update false
+setup_auto_update() {
+	local auto_update_script="$HOME/.aidevops/agents/scripts/auto-update-helper.sh"
+	if ! [[ -x "$auto_update_script" ]] || ! is_feature_enabled auto_update 2>/dev/null; then
+		return 0
+	fi
+
+	local _auto_update_installed=false
+	if _scheduler_detect_installed \
+		"Auto-update" \
+		"com.aidevops.aidevops-auto-update" \
+		"com.aidevops.auto-update" \
+		"aidevops-auto-update" \
+		"$auto_update_script" \
+		"enable" \
+		"aidevops auto-update enable"; then
+		_auto_update_installed=true
+	fi
+	if [[ "$_auto_update_installed" == "false" ]]; then
+		if [[ "$NON_INTERACTIVE" == "true" ]]; then
+			# Non-interactive: enable silently
+			bash "$auto_update_script" enable >/dev/null 2>&1 || true
+			print_info "Auto-update enabled (every 10 min). Disable: aidevops auto-update disable"
+		else
+			echo ""
+			echo "Auto-update keeps aidevops current by checking every 10 minutes."
+			echo "Safe to run while AI sessions are active."
+			echo ""
+			read -r -p "Enable auto-update? [Y/n]: " enable_auto
+			if [[ "$enable_auto" =~ ^[Yy]?$ ]]; then
+				bash "$auto_update_script" enable
+			else
+				print_info "Skipped. Enable later: aidevops auto-update enable"
+			fi
+		fi
+	fi
+	return 0
+}
+
+# Print final setup instructions and feature summary.
+print_final_instructions() {
+	echo ""
+	echo "CLI Command:"
+	echo "  aidevops init         - Initialize aidevops in a project"
+	echo "  aidevops features     - List available features"
+	echo "  aidevops status       - Check installation status"
+	echo "  aidevops update       - Update to latest version"
+	echo "  aidevops update-tools - Check for and update installed tools"
+	echo "  aidevops uninstall    - Remove aidevops"
+	echo ""
+	echo "Deployed to:"
+	echo "  ~/.aidevops/agents/     - Agent files (main agents, subagents, scripts)"
+	echo "  ~/.aidevops/*-backups/  - Backups with rotation (keeps last $BACKUP_KEEP_COUNT)"
+	echo ""
+	echo "Next steps:"
+	echo "1. Review config templates in configs/ (keep as placeholders — never store real credentials there)"
+	echo "2. Setup Git CLI tools and authentication (shown during setup)"
+	echo "3. Setup API keys: bash ~/.aidevops/agents/scripts/setup-local-api-keys.sh setup"
+	echo "4. Test access: bash ~/.aidevops/agents/scripts/servers-helper.sh list"
+	echo "5. Enable orchestration: see runners.md 'Pulse Scheduler Setup' (autonomous task dispatch)"
+	echo "6. Read documentation: ~/.aidevops/agents/AGENTS.md"
+	echo ""
+	echo "For development on aidevops framework itself:"
+	echo "  See ~/Git/aidevops/AGENTS.md"
+	echo ""
+	echo "OpenCode Primary Agents (12 total, Tab to switch):"
+	echo "• Plan+      - Enhanced planning with context tools (read-only)"
+	echo "• Build+     - Enhanced build with context tools (full access)"
+	echo "• Accounts, AI-DevOps, Content, Health, Legal, Marketing,"
+	echo "  Research, Sales, SEO, WordPress"
+	echo ""
+	echo "Agent Skills (SKILL.md):"
+	echo "• 21 SKILL.md files generated in ~/.aidevops/agents/"
+	echo "• Skills include: wordpress, seo, aidevops, build-mcp, and more"
+	echo ""
+	echo "MCP Integrations (OpenCode):"
+	echo "• Augment Context Engine - Cloud semantic codebase retrieval"
+	echo "• Context7               - Real-time library documentation"
+	echo "• GSC                    - Google Search Console (MCP + OAuth2)"
+	echo "• Google Analytics       - Analytics data (shared GSC credentials)"
+	echo ""
+	echo "SEO Integrations (curl subagents - no MCP overhead):"
+	echo "• DataForSEO             - Comprehensive SEO data APIs"
+	echo "• Serper                 - Google Search API"
+	echo "• Ahrefs                 - Backlink and keyword data"
+	echo ""
+	echo "DSPy & DSPyGround Integration:"
+	echo "• ./.agents/scripts/dspy-helper.sh        - DSPy prompt optimization toolkit"
+	echo "• ./.agents/scripts/dspyground-helper.sh  - DSPyGround playground interface"
+	echo "• python-env/dspy-env/              - Python virtual environment for DSPy"
+	echo "• data/dspy/                        - DSPy projects and datasets"
+	echo "• data/dspyground/                  - DSPyGround projects and configurations"
+	echo ""
+	echo "Task Management:"
+	echo "• Beads CLI (bd)                    - Task graph visualization"
+	echo "• beads-sync-helper.sh              - Sync TODO.md/PLANS.md with Beads"
+	echo "• todo-ready.sh                     - Show tasks with no open blockers"
+	echo "• Run: aidevops init beads          - Initialize Beads in a project"
+	echo ""
+	echo "Autonomous Orchestration:"
+	echo "• Supervisor pulse         - Dispatches workers, merges PRs, evaluates results"
+	echo "• Auto-pickup              - Workers claim #auto-dispatch tasks from TODO.md"
+	echo "• Cross-repo visibility    - Manages tasks across all repos in repos.json"
+	echo "• Strategic review (opus)  - 4-hourly queue health, root cause analysis"
+	echo "• Model routing            - Cost-aware: local>haiku>flash>sonnet>pro>opus"
+	echo "• Budget tracking          - Per-provider spend limits, subscription-aware"
+	echo "• Session miner            - Extracts learning from past sessions"
+	echo "• Circuit breaker          - Pauses dispatch on consecutive failures"
+	echo ""
+	echo "  Supervisor pulse (autonomous orchestration) requires explicit consent."
+	echo "  Enable: aidevops config set orchestration.supervisor_pulse true && ./setup.sh"
+	echo ""
+	echo "  Run /onboarding in your AI assistant to configure services interactively."
+	echo ""
+	echo "Security reminders:"
+	echo "- Never commit configuration files with real credentials"
+	echo "- Use strong passwords and enable MFA on all accounts"
+	echo "- Regularly rotate API tokens and SSH keys"
+	echo ""
+	echo "Happy server managing! 🚀"
+	echo ""
+	return 0
+}
+
+# Offer to launch onboarding for new users (only if not running inside OpenCode
+# and not non-interactive).
+# Respects config: aidevops config set ui.onboarding_prompt false
+setup_onboarding_prompt() {
+	if [[ "$NON_INTERACTIVE" != "true" ]] && [[ -z "${OPENCODE_SESSION:-}" ]] && is_feature_enabled onboarding_prompt 2>/dev/null && command -v opencode &>/dev/null; then
+		echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+		echo ""
+		echo "Ready to configure your services?"
+		echo ""
+		echo "Launch OpenCode with the onboarding wizard to:"
+		echo "  - See which services are already configured"
+		echo "  - Get personalized recommendations based on your work"
+		echo "  - Set up API keys and credentials interactively"
+		echo ""
+		read -r -p "Launch OpenCode with /onboarding now? [Y/n]: " launch_onboarding
+		if [[ "$launch_onboarding" =~ ^[Yy]?$ ]]; then
+			echo ""
+			echo "Starting OpenCode with onboarding wizard..."
+			# Launch with /onboarding prompt only — don't use --agent flag because
+			# the "Onboarding" agent only exists after generate-opencode-agents.sh
+			# writes to opencode.json, which requires opencode.json to already exist.
+			# On first run it won't, so --agent "Onboarding" causes a fatal error.
+			opencode --prompt "/onboarding"
+		else
+			echo ""
+			echo "You can run /onboarding anytime in OpenCode to configure services."
+		fi
+	fi
+	return 0
+}