@mainwp/control 1.0.0

package/scripts/completions/mainwpcontrol.zsh

@@ -0,0 +1,267 @@
+#compdef mainwpcontrol
+# mainwpcontrol zsh completion script
+#
+# Installation:
+#   source /path/to/mainwpcontrol/scripts/completions/mainwpcontrol.zsh
+#
+# Or add to ~/.zshrc:
+#   source /path/to/mainwpcontrol/scripts/completions/mainwpcontrol.zsh
+
+# Determine the directory where this script is located
+_MAINWPCTL_COMPLETION_DIR="${0:A:h}"
+
+# Source the profile completer helper
+if [[ -f "${_MAINWPCTL_COMPLETION_DIR}/profile-completer.sh" ]]; then
+    source "${_MAINWPCTL_COMPLETION_DIR}/profile-completer.sh"
+fi
+
+# Helper function to get profile names for completion
+_mainwpcontrol_profiles() {
+    local profiles
+    if (( $+functions[_mainwpcontrol_get_profiles] )); then
+        profiles=("${(@f)$(_mainwpcontrol_get_profiles)}")
+        _describe -t profiles 'profile' profiles
+    fi
+}
+
+# Main completion function
+_mainwpcontrol() {
+    local curcontext="$curcontext" state line
+    typeset -A opt_args
+
+    # Common flags available on all commands
+    local -a common_flags
+    common_flags=(
+        '--debug[Show debug output]'
+        '--help[Show help]'
+        '--json[Output JSON (for scripting/CI)]'
+        '(-p --profile)'{-p,--profile}'[Use a specific profile]:profile:_mainwpcontrol_profiles'
+    )
+
+    # Top-level commands
+    local -a commands
+    commands=(
+        'abilities:Manage and execute abilities'
+        'autocomplete:Display autocomplete installation instructions'
+        'chat:Interactive chat mode for MainWP Dashboard management'
+        'doctor:Check configuration and connectivity'
+        'help:Display help for a command'
+        'jobs:Manage batch jobs'
+        'login:Authenticate with a MainWP Dashboard'
+        'profile:Manage connection profiles'
+    )
+
+    _arguments -C \
+        $common_flags \
+        '1: :->command' \
+        '*:: :->args'
+
+    case "$state" in
+        command)
+            _describe -t commands 'mainwpcontrol commands' commands
+            ;;
+        args)
+            case "$words[1]" in
+                abilities)
+                    _mainwpcontrol_abilities
+                    ;;
+                autocomplete)
+                    _mainwpcontrol_autocomplete
+                    ;;
+                chat)
+                    _mainwpcontrol_chat
+                    ;;
+                doctor)
+                    _mainwpcontrol_doctor
+                    ;;
+                help)
+                    _mainwpcontrol_help
+                    ;;
+                jobs)
+                    _mainwpcontrol_jobs
+                    ;;
+                login)
+                    _mainwpcontrol_login
+                    ;;
+                profile)
+                    _mainwpcontrol_profile
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+# Abilities command completions
+_mainwpcontrol_abilities() {
+    local -a subcommands
+    subcommands=(
+        'info:Get detailed information about an ability'
+        'list:List available abilities'
+        'run:Execute an ability'
+    )
+
+    _arguments -C \
+        $common_flags \
+        '1: :->subcommand' \
+        '*:: :->args'
+
+    case "$state" in
+        subcommand)
+            _describe -t commands 'abilities subcommands' subcommands
+            ;;
+        args)
+            case "$words[1]" in
+                info)
+                    _arguments \
+                        $common_flags \
+                        '1:ability name:'
+                    ;;
+                list)
+                    _arguments \
+                        $common_flags \
+                        '--category[Filter by category]:category:(sites clients updates plugins themes core tags batch)'
+                    ;;
+                run)
+                    _arguments \
+                        $common_flags \
+                        '(-i --input)'{-i,--input}'[Input parameters as JSON]:input:' \
+                        '--dry-run[Preview changes without executing]' \
+                        '--confirm[Execute destructive ability (after preview)]' \
+                        '--force[Skip confirmation prompt (use with --confirm)]' \
+                        '1:ability name:'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+# Autocomplete command completions
+_mainwpcontrol_autocomplete() {
+    _arguments \
+        '1:shell:(bash zsh)'
+}
+
+# Chat command completions
+_mainwpcontrol_chat() {
+    _arguments \
+        $common_flags \
+        '--provider[LLM provider]:provider:(anthropic gemini local openai openrouter)' \
+        '(-m --model)'{-m,--model}'[Model to use]:model:' \
+        '--api-key[LLM API key (overrides environment)]:api key:' \
+        '--base-url[Custom API base URL]:url:' \
+        '--max-turns[Maximum tool calls per turn]:turns:' \
+        '--max-context-messages[Maximum messages to keep in context]:messages:' \
+        '--stream[Enable streaming responses]' \
+        '--no-stream[Disable streaming responses]' \
+        '1:message:'
+}
+
+# Doctor command completions
+_mainwpcontrol_doctor() {
+    _arguments \
+        $common_flags \
+        '(-v --verbose)'{-v,--verbose}'[Verbose output]'
+}
+
+# Help command completions
+_mainwpcontrol_help() {
+    local -a commands
+    commands=(
+        'abilities'
+        'autocomplete'
+        'chat'
+        'doctor'
+        'help'
+        'jobs'
+        'login'
+        'profile'
+    )
+
+    _arguments \
+        '1:command:($commands)'
+}
+
+# Jobs command completions
+_mainwpcontrol_jobs() {
+    local -a subcommands
+    subcommands=(
+        'watch:Monitor a batch job'
+    )
+
+    _arguments -C \
+        $common_flags \
+        '1: :->subcommand' \
+        '*:: :->args'
+
+    case "$state" in
+        subcommand)
+            _describe -t commands 'jobs subcommands' subcommands
+            ;;
+        args)
+            case "$words[1]" in
+                watch)
+                    _arguments \
+                        $common_flags \
+                        '--timeout[Maximum time to wait in seconds]:seconds:' \
+                        '--initial-delay[Initial polling delay in seconds]:seconds:' \
+                        '--max-delay[Maximum polling delay in seconds]:seconds:' \
+                        '--no-progress[Disable progress output]' \
+                        '1:job id:'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+# Login command completions
+_mainwpcontrol_login() {
+    _arguments \
+        $common_flags \
+        '(-u --url)'{-u,--url}'[Dashboard URL]:url:' \
+        '--username[WordPress admin username]:username:' \
+        '--password[Application password]:password:' \
+        '(-n --name)'{-n,--name}'[Profile name]:name:' \
+        '--skip-ssl-verify[Skip SSL certificate verification]'
+}
+
+# Profile command completions
+_mainwpcontrol_profile() {
+    local -a subcommands
+    subcommands=(
+        'delete:Delete a profile'
+        'list:List all profiles'
+        'use:Switch active profile'
+    )
+
+    _arguments -C \
+        $common_flags \
+        '1: :->subcommand' \
+        '*:: :->args'
+
+    case "$state" in
+        subcommand)
+            _describe -t commands 'profile subcommands' subcommands
+            ;;
+        args)
+            case "$words[1]" in
+                delete)
+                    _arguments \
+                        $common_flags \
+                        '1:profile name:_mainwpcontrol_profiles'
+                    ;;
+                list)
+                    _arguments \
+                        $common_flags
+                    ;;
+                use)
+                    _arguments \
+                        $common_flags \
+                        '1:profile name:_mainwpcontrol_profiles'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+# Register the completion function
+compdef _mainwpcontrol mainwpcontrol

package/scripts/completions/profile-completer.sh

@@ -0,0 +1,35 @@
+#!/bin/sh
+# profile-completer.sh - Helper script to get available mainwpcontrol profile names
+# This script is sourced by shell completion scripts to provide dynamic profile completion.
+#
+# Usage: source this file, then call _mainwpcontrol_get_profiles
+#
+# Returns profile names one per line, empty if no profiles exist or config is missing.
+
+_mainwpcontrol_get_profiles() {
+    local config_file="${XDG_CONFIG_HOME:-$HOME/.config}/mainwpcontrol/profiles.json"
+
+    # Exit silently if config file doesn't exist
+    if [ ! -f "$config_file" ]; then
+        return 0
+    fi
+
+    # Try jq first (most reliable JSON parsing)
+    if command -v jq >/dev/null 2>&1; then
+        jq -r '.profiles | keys[]' "$config_file" 2>/dev/null
+        return 0
+    fi
+
+    # Fallback: use grep/sed for simple JSON parsing
+    # This handles: {"profiles":{"name1":{...},"name2":{...}}}
+    # Extract keys after "profiles": and before their values
+    grep -o '"profiles"[[:space:]]*:[[:space:]]*{[^}]*}' "$config_file" 2>/dev/null | \
+        grep -o '"[^"]*"[[:space:]]*:' | \
+        sed 's/"//g; s/[[:space:]]*://g' | \
+        grep -v '^profiles$' 2>/dev/null
+}
+
+# If called directly (not sourced), output profile names
+if [ "${0##*/}" = "profile-completer.sh" ]; then
+    _mainwpcontrol_get_profiles
+fi

package/scripts/completions/regenerate.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+# regenerate.sh - Regenerate shell completion scripts for mainwpcontrol
+#
+# This script helps developers update completion scripts after CLI changes.
+# Run this after adding, removing, or modifying commands or flags.
+#
+# Usage: ./scripts/completions/regenerate.sh
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+echo "Shell Completion Regeneration Helper"
+echo "====================================="
+echo ""
+echo "The mainwpcontrol completion scripts are manually maintained to provide"
+echo "optimal completion behavior with dynamic profile name completion."
+echo ""
+echo "After adding, removing, or modifying commands/flags, you should update:"
+echo ""
+echo "  1. $SCRIPT_DIR/mainwpcontrol.bash"
+echo "     - Update 'commands' variable for new top-level commands"
+echo "     - Update '*_commands' variables for new subcommands"
+echo "     - Update '*_flags' variables for new flags"
+echo ""
+echo "  2. $SCRIPT_DIR/mainwpcontrol.zsh"
+echo "     - Update 'commands' array for new top-level commands"
+echo "     - Update subcommand arrays in respective functions"
+echo "     - Update _arguments calls for new flags"
+echo ""
+echo "Testing completions:"
+echo "  # Bash"
+echo "  source $SCRIPT_DIR/mainwpcontrol.bash"
+echo "  mainwpcontrol <TAB>"
+echo ""
+echo "  # Zsh"
+echo "  source $SCRIPT_DIR/mainwpcontrol.zsh"
+echo "  mainwpcontrol <TAB>"
+echo ""
+
+# Verify files exist
+echo "Checking completion files..."
+
+if [[ -f "$SCRIPT_DIR/mainwpcontrol.bash" ]]; then
+    echo "  [OK] mainwpcontrol.bash"
+else
+    echo "  [MISSING] mainwpcontrol.bash"
+fi
+
+if [[ -f "$SCRIPT_DIR/mainwpcontrol.zsh" ]]; then
+    echo "  [OK] mainwpcontrol.zsh"
+else
+    echo "  [MISSING] mainwpcontrol.zsh"
+fi
+
+if [[ -f "$SCRIPT_DIR/profile-completer.sh" ]]; then
+    echo "  [OK] profile-completer.sh"
+else
+    echo "  [MISSING] profile-completer.sh"
+fi
+
+echo ""
+echo "Extracting current CLI structure..."
+echo ""
+
+# Try to extract commands from the built CLI
+if [[ -x "$PROJECT_ROOT/bin/run.js" ]]; then
+    echo "Top-level commands:"
+    "$PROJECT_ROOT/bin/run.js" --help 2>/dev/null | grep -E '^\s+[a-z]+\s' | awk '{print "  - " $1}' || echo "  (could not extract)"
+    echo ""
+else
+    echo "Note: Build the project first to extract command structure:"
+    echo "  npm run build"
+    echo ""
+fi
+
+echo "Done. Remember to commit your changes after updating completion scripts."