aidevops 3.13.95 → 3.14.1

package/setup-modules/post-setup.sh

@@ -1,301 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: MIT
-# SPDX-FileCopyrightText: 2025-2026 Marcus Quinn
-# 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" \
-		"aidevops-auto-update"; then
-		_auto_update_installed=true
-	fi
-	# t2898: ALWAYS run idempotent re-install + health-check after the
-	# detection above, so every release self-heals broken installs (daemon
-	# unloaded by an OS update, scrubbed by a cron cleanup, etc.). The
-	# detection helper already handled the "freshly install if missing"
-	# interactive prompt; this loop ensures that even when the detection
-	# said "yes installed" the daemon is actually loaded right now and
-	# running on schedule.
-	if [[ "$_auto_update_installed" == "true" ]]; then
-		# Idempotent: no-op when daemon already loaded; re-installs only on drift.
-		bash "$auto_update_script" enable --idempotent >/dev/null 2>&1 || true
-		# Verify it's actually healthy. Surface any degradation so the
-		# operator sees it on every release deploy.
-		local _hc_rc=0
-		bash "$auto_update_script" health-check --quiet >/dev/null 2>&1 || _hc_rc=$?
-		if [[ "$_hc_rc" -eq 0 ]]; then
-			:
-		elif [[ "$_hc_rc" -eq 1 ]]; then
-			print_warning "Auto-update daemon installed but stalled — run: aidevops auto-update check"
-		elif [[ "$_hc_rc" -eq 2 ]]; then
-			print_warning "Auto-update daemon not loaded — run: aidevops auto-update enable"
-		fi
-	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"
-			# On Linux systemd, advise about linger without running sudo automatically.
-			if [[ "$(uname -s)" == "Linux" ]] && [[ "${USER:-}" != "root" ]] \
-				&& command -v loginctl &>/dev/null; then
-				local _linger_state
-				_linger_state=$(loginctl show-user "$USER" -p Linger --value 2>/dev/null || true)
-				if [[ "$_linger_state" != "yes" ]]; then
-					echo "[INFO] Linux systemd: enable linger so auto-update runs when logged out:" >&2
-					echo "[INFO]   sudo loginctl enable-linger $USER" >&2
-				fi
-			fi
-		else
-			echo ""
-			echo "Auto-update keeps aidevops current by checking every 10 minutes."
-			echo "Safe to run while AI sessions are active."
-			echo ""
-			setup_prompt enable_auto "Enable auto-update? [Y/n]: " "Y"
-			if [[ "$enable_auto" =~ ^[Yy]?$ ]]; then
-				bash "$auto_update_script" enable
-				# On Linux systemd hosts, offer to enable linger so the timer survives logout.
-				# Skip for root (irrelevant), WSL/container (loginctl may be absent or stub),
-				# and when the backend didn't resolve to systemd.
-				if [[ "$(uname -s)" == "Linux" ]] \
-					&& [[ "${USER:-}" != "root" ]] \
-					&& command -v loginctl &>/dev/null \
-					&& systemctl --user is-enabled aidevops-auto-update.timer &>/dev/null 2>&1; then
-					local _linger_state
-					_linger_state=$(loginctl show-user "$USER" -p Linger --value 2>/dev/null || true)
-					if [[ "$_linger_state" != "yes" ]]; then
-						echo ""
-						echo "Without linger, the auto-update timer stops when you log out."
-						echo "On servers and headless hosts, linger is almost always required."
-						local enable_linger=""
-					setup_prompt enable_linger "Enable linger so auto-update runs when logged out? Requires sudo. [Y/n]: " "Y"
-						if [[ "$enable_linger" =~ ^[Yy]?$ ]]; then
-							sudo loginctl enable-linger "$USER"
-							print_success "Linger enabled for $USER"
-						else
-							print_info "Skipped. Enable later: sudo loginctl enable-linger $USER"
-						fi
-					fi
-				fi
-			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 "• 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
-}
-
-# Setup Tabby terminal profiles from repos.json.
-# Creates a profile per registered repo with colour-matched themes and
-# the TABBY_AUTORUN hook for OpenCode TUI compatibility.
-# Skipped if Tabby is not installed.
-setup_tabby() {
-	local tabby_helper="$HOME/.aidevops/agents/scripts/tabby-helper.sh"
-	local tabby_config
-
-	# Platform-aware config path
-	if [[ "$(uname -s)" == "Darwin" ]]; then
-		tabby_config="$HOME/Library/Application Support/tabby/config.yaml"
-	else
-		tabby_config="$HOME/.config/tabby-terminal/config.yaml"
-	fi
-
-	# Skip if Tabby not installed
-	if [[ ! -f "$tabby_config" ]]; then
-		return 0
-	fi
-
-	# Skip if helper not deployed yet
-	if [[ ! -x "$tabby_helper" ]]; then
-		return 0
-	fi
-
-	print_info "Tabby terminal detected"
-
-	# Ensure default local profile uses /bin/zsh (macOS).
-	# After macOS updates, Tabby can fall back to bash when this is unset.
-	bash "$tabby_helper" fix-shell || true
-
-	# Install zshrc hook (idempotent)
-	if ! bash "$tabby_helper" zshrc; then
-		print_warning "Failed to install Tabby zshrc hook — run manually: aidevops tabby zshrc"
-	fi
-
-	if [[ "$NON_INTERACTIVE" == "true" ]]; then
-		# Non-interactive: sync silently, warn on failure
-		if ! bash "$tabby_helper" sync; then
-			print_warning "Tabby profile sync failed — run manually: aidevops tabby sync"
-		fi
-		return 0
-	fi
-
-	# Show status and offer to sync
-	echo ""
-	bash "$tabby_helper" status || true
-	echo ""
-	setup_prompt sync_tabby "Sync Tabby profiles from repos.json? [Y/n]: " "Y"
-	if [[ "$sync_tabby" =~ ^[Yy]?$ ]]; then
-		bash "$tabby_helper" sync
-	else
-		print_info "Skipped. Run later: aidevops tabby sync"
-	fi
-
-	return 0
-}
-
-# Offer to launch onboarding for new users (only if not running inside an AI
-# runtime session and not non-interactive). (t1665.5 — registry-driven)
-# Respects config: aidevops config set ui.onboarding_prompt false
-setup_onboarding_prompt() {
-	# Skip if non-interactive or already inside a runtime session
-	[[ "$NON_INTERACTIVE" == "true" ]] && return 0
-	[[ -n "${OPENCODE_SESSION:-}" || -n "${CLAUDE_SESSION:-}" ]] && return 0
-	is_feature_enabled onboarding_prompt 2>/dev/null || return 0
-
-	# Find first available headless runtime for onboarding dispatch
-	local _onb_bin="" _onb_name=""
-	if type rt_list_headless &>/dev/null; then
-		local _onb_rt_id
-		while IFS= read -r _onb_rt_id; do
-			_onb_bin=$(rt_binary "$_onb_rt_id") || continue
-			if [[ -n "$_onb_bin" ]] && command -v "$_onb_bin" &>/dev/null; then
-				_onb_name=$(rt_display_name "$_onb_rt_id") || _onb_name="$_onb_bin"
-				break
-			fi
-			_onb_bin=""
-		done < <(rt_list_headless)
-	fi
-	# Fallback
-	if [[ -z "$_onb_bin" ]] && command -v opencode &>/dev/null; then
-		_onb_bin="opencode"
-		_onb_name="OpenCode"
-	fi
-	[[ -z "$_onb_bin" ]] && return 0
-
-	echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-	echo ""
-	echo "Ready to configure your services?"
-	echo ""
-	echo "Launch ${_onb_name} 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 ""
-	setup_prompt launch_onboarding "Launch ${_onb_name} with /onboarding now? [Y/n]: " "Y"
-	if [[ "$launch_onboarding" =~ ^[Yy]?$ ]]; then
-		echo ""
-		echo "Starting ${_onb_name} with onboarding wizard..."
-		"$_onb_bin" --prompt "/onboarding"
-	else
-		echo ""
-		echo "You can run /onboarding anytime in ${_onb_name} to configure services."
-	fi
-	return 0
-}

package/setup-modules/schedulers-linux.sh

@@ -1,386 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: MIT
-# SPDX-FileCopyrightText: 2025-2026 Marcus Quinn
-# =============================================================================
-# Schedulers Linux Sub-Library -- systemd/cron scheduler installation and
-# uninstall functions for Linux (and macOS uninstall path).
-# =============================================================================
-# This sub-library is sourced by setup-modules/schedulers.sh (the orchestrator).
-# It covers:
-#   - systemd user service availability check
-#   - systemd value escaping
-#   - Building systemd Environment= and cron env prefix lines
-#   - Generic systemd timer installation
-#   - Generic cron entry installation
-#   - Linux dispatcher (systemd preferred, cron fallback)
-#   - Generic scheduler uninstall (launchd/systemd/cron)
-#   - Supervisor pulse uninstall
-#
-# Usage: source "${SCRIPT_DIR}/schedulers-linux.sh"
-#
-# Dependencies:
-#   - shared-constants.sh (print_info, print_warning)
-#
-# Part of aidevops framework: https://aidevops.sh
-
-# Apply strict mode only when executed directly (not when sourced)
-[[ "${BASH_SOURCE[0]}" == "${0}" ]] && set -euo pipefail
-
-# Include guard
-[[ -n "${_SCHEDULERS_LINUX_LIB_LOADED:-}" ]] && return 0
-_SCHEDULERS_LINUX_LIB_LOADED=1
-
-# SCRIPT_DIR fallback — needed when sourced from test harnesses that don't set it.
-if [[ -z "${SCRIPT_DIR:-}" ]]; then
-	_sched_linux_lib_path="${BASH_SOURCE[0]%/*}"
-	[[ "$_sched_linux_lib_path" == "${BASH_SOURCE[0]}" ]] && _sched_linux_lib_path="."
-	SCRIPT_DIR="$(cd "$_sched_linux_lib_path" && pwd)"
-	unset _sched_linux_lib_path
-fi
-
-# --- Functions ---
-
-# Check if systemd user services are available on this Linux system.
-# Returns 0 if systemd --user is functional, 1 otherwise.
-_systemd_user_available() {
-	command -v systemctl >/dev/null 2>&1 || return 1
-	systemctl --user status >/dev/null 2>&1 || return 1
-	return 0
-}
-
-# Escape a value for safe embedding in a systemd unit Environment= or ExecStart=
-# directive. systemd interprets % as specifiers (%h, %n, %t, etc.) and spaces
-# as key-value separators. This helper:
-#   1. Escapes \ → \\ (must be first to avoid double-escaping)
-#   2. Doubles % → %% (escape specifiers)
-#   3. Escapes embedded " → \"
-#   4. Wraps the result in "..." (handles spaces and other shell metacharacters)
-# Usage: escaped=$(_systemd_escape "$value")
-#
-# WARNING: Do NOT use for StandardOutput= or StandardError= directives.
-# systemd does not strip outer quotes from those values — "append:/path" is
-# treated as a literal filename with quote characters, failing silently.
-# Use bare values for StandardOutput=/StandardError=:
-#   StandardOutput=append:${log_file}  ← correct
-#   StandardOutput=$(_systemd_escape "append:${log_file}")  ← WRONG
-_systemd_escape() {
-	local _val="$1"
-	# Step 1: escape backslashes
-	_val="${_val//\\/\\\\}"
-	# Step 2: escape % specifiers
-	_val="${_val//%/%%}"
-	# Step 3: escape embedded double-quotes
-	_val="${_val//\"/\\\"}"
-	# Step 4: wrap in double-quotes
-	printf '"%s"' "$_val"
-	return 0
-}
-
-# Build systemd Environment= lines from newline-separated KEY=VALUE pairs.
-# Always appends HOME and PATH for parity with launchd and cron execution.
-_scheduler_systemd_env_lines() {
-	local env_vars="$1"
-	local _env_lines=""
-
-	if [[ -n "$env_vars" ]]; then
-		while IFS= read -r _kv; do
-			[[ -z "$_kv" ]] && continue
-			local _key="${_kv%%=*}"
-			local _raw_val="${_kv#*=}"
-			local _escaped_val
-			_escaped_val=$(_systemd_escape "$_raw_val")
-			_env_lines+="Environment=${_key}=${_escaped_val}"$'\n'
-		done <<<"$env_vars"
-	fi
-
-	_env_lines+="Environment=HOME=$(_systemd_escape "$HOME")"$'\n'
-	_env_lines+="Environment=PATH=$(_systemd_escape "$PATH")"$'\n'
-	printf '%s' "$_env_lines"
-	return 0
-}
-
-# Build inline cron environment assignments from newline-separated KEY=VALUE pairs.
-_scheduler_cron_env_prefix() {
-	local env_vars="$1"
-	local _env_prefix=""
-
-	if [[ -n "$env_vars" ]]; then
-		while IFS= read -r _kv; do
-			[[ -z "$_kv" ]] && continue
-			local _key="${_kv%%=*}"
-			local _raw_val="${_kv#*=}"
-			local _escaped_val
-			_escaped_val=$(_cron_escape "$_raw_val")
-			_env_prefix+="${_key}=${_escaped_val} "
-		done <<<"$env_vars"
-	fi
-
-	printf '%s' "$_env_prefix"
-	return 0
-}
-
-# Install a generic scheduler via systemd user timer (Linux with systemd).
-# Args:
-#   $1 = service_name    (e.g. "aidevops-stats-wrapper")
-#   $2 = exec_command    (shell command run via /bin/bash -lc)
-#   $3 = interval_sec    (OnUnitActiveSec interval in seconds; may be empty for calendar-only)
-#   $4 = log_file        (absolute path to log file)
-#   $5 = env_vars        (newline-separated KEY=VALUE pairs, may be empty)
-#   $6 = run_at_load     ("true" or "false")
-#   $7 = low_priority    ("true" or "false")
-#   $8 = on_calendar     (optional systemd OnCalendar spec)
-#   $9 = timeout_sec     (optional TimeoutStartSec; defaults to interval_sec)
-# Returns 0 on success, 1 if systemd enable fails (caller should fall back to cron).
-_install_scheduler_systemd() {
-	local service_name="$1"
-	local exec_command="$2"
-	local interval_sec="$3"
-	local log_file="$4"
-	local env_vars="$5"
-	local run_at_load="$6"
-	local low_priority="$7"
-	local on_calendar="$8"
-	local timeout_sec="$9"
-	local service_dir="$HOME/.config/systemd/user"
-	local service_file="${service_dir}/${service_name}.service"
-	local timer_file="${service_dir}/${service_name}.timer"
-
-	mkdir -p "$service_dir"
-
-	# GH#18439 Bug 1: command substitution strips trailing newlines, which
-	# would run the final Environment=PATH=... into the following
-	# StandardOutput=... directive on the same line. Use a sentinel ('x')
-	# to preserve the trailing newline that _scheduler_systemd_env_lines
-	# always emits.
-	local _env_lines
-	_env_lines=$(
-		_scheduler_systemd_env_lines "$env_vars"
-		printf 'x'
-	)
-	_env_lines="${_env_lines%x}"
-
-	if [[ -z "$timeout_sec" ]]; then
-		timeout_sec="$interval_sec"
-	fi
-	if [[ -z "$timeout_sec" ]]; then
-		timeout_sec="3600"
-	fi
-
-	local _service_extra=""
-	if [[ "$low_priority" == "true" ]]; then
-		_service_extra+="Nice=10"$'\n'
-		_service_extra+="IOSchedulingClass=idle"$'\n'
-	fi
-
-	printf '%s' "[Unit]
-Description=aidevops ${service_name}
-After=network.target
-
-[Service]
-Type=oneshot
-KillMode=process
-ExecStart=/bin/bash -lc $(_systemd_escape "$exec_command")
-TimeoutStartSec=${timeout_sec}
-${_service_extra}${_env_lines}StandardOutput=append:${log_file}
-StandardError=append:${log_file}
-" >"$service_file"
-
-	local _timer_lines=""
-	if [[ "$run_at_load" == "true" ]]; then
-		_timer_lines+="OnActiveSec=10s"$'\n'
-	fi
-	if [[ -n "$interval_sec" ]]; then
-		_timer_lines+="OnBootSec=${interval_sec}"$'\n'
-		_timer_lines+="OnUnitActiveSec=${interval_sec}"$'\n'
-	fi
-	if [[ -n "$on_calendar" ]]; then
-		_timer_lines+="OnCalendar=${on_calendar}"$'\n'
-	fi
-
-	printf '%s' "[Unit]
-Description=aidevops ${service_name} Timer
-
-[Timer]
-${_timer_lines}Persistent=true
-
-[Install]
-WantedBy=timers.target
-" >"$timer_file"
-
-	systemctl --user daemon-reload 2>/dev/null || true
-	if systemctl --user enable --now "${service_name}.timer" 2>/dev/null; then
-		return 0
-	fi
-	return 1
-}
-
-# Install a generic cron entry.
-# Args: $1=cron_tag, $2=cron_schedule, $3=exec_command, $4=log_file, $5=env_vars
-_install_scheduler_cron() {
-	local cron_tag="$1"
-	local cron_schedule="$2"
-	local exec_command="$3"
-	local log_file="$4"
-	local env_vars="$5"
-	local _cron_exec
-	local _cron_log
-	local _env_prefix
-
-	_env_prefix=$(_scheduler_cron_env_prefix "$env_vars")
-	_cron_exec=$(_cron_escape "$exec_command")
-	_cron_log=$(_cron_escape "$log_file")
-
-	(
-		crontab -l 2>/dev/null | grep -vF "${cron_tag}" || true
-		echo "${cron_schedule} ${_env_prefix}/bin/bash -lc ${_cron_exec} >> ${_cron_log} 2>&1 # ${cron_tag}"
-	) | crontab - 2>/dev/null || true
-	return 0
-}
-
-# Dispatcher: install a scheduler on Linux, preferring systemd over cron.
-# Args:
-#   $1 = service_name   (systemd service name, e.g. "aidevops-stats-wrapper")
-#   $2 = cron_tag       (comment tag for cron line, e.g. "aidevops: stats-wrapper")
-#   $3 = cron_schedule  (cron schedule expression, e.g. "*/15 * * * *")
-#   $4 = exec_command   (shell command run via /bin/bash -lc)
-#   $5 = interval_sec   (systemd OnUnitActiveSec in seconds; may be empty for calendar-only)
-#   $6 = log_file       (absolute path to log file)
-#   $7 = env_vars       (newline-separated KEY=VALUE pairs for systemd/cron, may be empty)
-#   $8 = success_msg    (message to print on success)
-#   $9 = fail_msg       (message to print on failure)
-#   $10 = run_at_load   ("true" or "false")
-#   $11 = low_priority  ("true" or "false")
-#   $12 = on_calendar   (optional systemd OnCalendar spec)
-#   $13 = timeout_sec   (optional TimeoutStartSec)
-# Returns 0 always (failures are warnings, not fatal).
-_install_scheduler_linux() {
-	local service_name="$1"
-	local cron_tag="$2"
-	local cron_schedule="$3"
-	local exec_command="$4"
-	local interval_sec="$5"
-	local log_file="$6"
-	local env_vars="$7"
-	local success_msg="$8"
-	local fail_msg="$9"
-	local run_at_load="${10}"
-	local low_priority="${11}"
-	local on_calendar="${12:-}"
-	local timeout_sec="${13:-}"
-
-	if _systemd_user_available; then
-		if _install_scheduler_systemd \
-			"$service_name" \
-			"$exec_command" \
-			"$interval_sec" \
-			"$log_file" \
-			"$env_vars" \
-			"$run_at_load" \
-			"$low_priority" \
-			"$on_calendar" \
-			"$timeout_sec"; then
-			print_info "${success_msg} (systemd user timer)"
-			# After systemd install succeeds, remove any pre-existing cron entry
-			# to prevent dual-execution (GH#17695 Finding A)
-			if command -v crontab >/dev/null 2>&1; then
-				local current_cron
-				current_cron=$(crontab -l 2>/dev/null) || current_cron=""
-				if [[ -n "$current_cron" ]] && echo "$current_cron" | grep -qF "$cron_tag"; then
-					echo "$current_cron" | grep -vF "$cron_tag" | crontab -
-					echo "[schedulers] Removed pre-existing cron entry for $cron_tag (migrated to systemd)"
-				fi
-			fi
-		else
-			print_warning "systemd enable failed for ${service_name} — falling back to cron"
-			_install_scheduler_cron "$cron_tag" "$cron_schedule" "$exec_command" "$log_file" "$env_vars"
-			if crontab -l 2>/dev/null | grep -qF "${cron_tag}" 2>/dev/null; then
-				print_info "${success_msg} (cron fallback)"
-			else
-				print_warning "${fail_msg}"
-			fi
-		fi
-	else
-		_install_scheduler_cron "$cron_tag" "$cron_schedule" "$exec_command" "$log_file" "$env_vars"
-		if crontab -l 2>/dev/null | grep -qF "${cron_tag}" 2>/dev/null; then
-			print_info "${success_msg} (cron)"
-		else
-			print_warning "${fail_msg}"
-		fi
-	fi
-	return 0
-}
-
-# Uninstall a scheduler across all backends (launchd/systemd/cron).
-# Args:
-#   $1 = os            (output of uname -s)
-#   $2 = launchd_label (e.g. "sh.aidevops.stats-wrapper")
-#   $3 = systemd_name  (e.g. "aidevops-stats-wrapper")
-#   $4 = cron_tag      (grep pattern for cron line, e.g. "aidevops: stats-wrapper")
-#   $5 = success_msg   (message to print on removal)
-# Returns 0 always.
-_uninstall_scheduler() {
-	local _os="$1"
-	local launchd_label="$2"
-	local systemd_name="$3"
-	local cron_tag="$4"
-	local success_msg="$5"
-
-	if [[ "$_os" == "Darwin" ]]; then
-		local _plist="$HOME/Library/LaunchAgents/${launchd_label}.plist"
-		if _launchd_has_agent "$launchd_label"; then
-			launchctl unload "$_plist" 2>/dev/null || true
-			rm -f "$_plist"
-			print_info "${success_msg} (launchd agent removed)"
-		fi
-	else
-		# Check and remove from ALL backends sequentially, not just the first
-		# match. Prevents orphan entries when migrating between systemd and cron
-		# (GH#17695 Finding A).
-		if _systemd_user_available && systemctl --user is-enabled "${systemd_name}.timer" >/dev/null 2>&1; then
-			systemctl --user disable --now "${systemd_name}.timer" 2>/dev/null || true
-			rm -f "$HOME/.config/systemd/user/${systemd_name}.service"
-			rm -f "$HOME/.config/systemd/user/${systemd_name}.timer"
-			systemctl --user daemon-reload 2>/dev/null || true
-			print_info "${success_msg} (systemd timer removed)"
-		fi
-		if command -v crontab >/dev/null 2>&1; then
-			local current_cron
-			current_cron=$(crontab -l 2>/dev/null) || current_cron=""
-			if [[ -n "$current_cron" ]] && echo "$current_cron" | grep -qF "${cron_tag}"; then
-				echo "$current_cron" | grep -vF "${cron_tag}" | crontab - 2>/dev/null || true
-				print_info "${success_msg} (cron entry removed)"
-			fi
-		fi
-	fi
-	return 0
-}
-
-# Uninstall supervisor pulse (user explicitly disabled)
-_uninstall_pulse() {
-	local _os="$1"
-	local pulse_label="$2"
-	if [[ "$_os" == "Darwin" ]]; then
-		local pulse_plist="$HOME/Library/LaunchAgents/${pulse_label}.plist"
-		if _launchd_has_agent "$pulse_label"; then
-			launchctl unload "$pulse_plist" || true
-			rm -f "$pulse_plist"
-			pkill -f 'Supervisor Pulse' 2>/dev/null || true
-			print_info "Supervisor pulse disabled (launchd agent removed per config)"
-		fi
-	elif _systemd_user_available; then
-		local service_name="aidevops-supervisor-pulse"
-		if systemctl --user is-enabled "${service_name}.timer" >/dev/null 2>&1; then
-			systemctl --user disable --now "${service_name}.timer" 2>/dev/null || true
-			rm -f "$HOME/.config/systemd/user/${service_name}.service"
-			rm -f "$HOME/.config/systemd/user/${service_name}.timer"
-			systemctl --user daemon-reload 2>/dev/null || true
-			print_info "Supervisor pulse disabled (systemd timer removed per config)"
-		fi
-	else
-		if crontab -l 2>/dev/null | grep -qF "pulse-wrapper"; then
-			crontab -l 2>/dev/null | grep -v 'aidevops: supervisor-pulse' | crontab - || true
-			print_info "Supervisor pulse disabled (cron entry removed per config)"
-		fi
-	fi
-	return 0
-}