@mainwp/control 1.0.0

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@mainwp/control",
+  "version": "1.0.0",
+  "description": "Command-line interface for scripting and automating MainWP Dashboard operations",
+  "type": "module",
+  "exports": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mainwpcontrol": "./bin/run.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "scripts/completions",
+    "oclif.manifest.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "postpack": "rm -f oclif.manifest.json",
+    "prepack": "npm run clean && npm run build && oclif manifest",
+    "test": "vitest run",
+    "test:process": "npm run build && vitest run --config vitest.process.config.ts",
+    "test:live": "npm run build && MAINWP_LIVE_TEST=1 vitest run --config vitest.live.config.ts",
+    "test:all": "npm run test && npm run test:process",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "pack": "oclif pack tarballs",
+    "pack:macos": "oclif pack macos",
+    "pack:win": "oclif pack win",
+    "pack:deb": "oclif pack deb"
+  },
+  "oclif": {
+    "bin": "mainwpcontrol",
+    "dirname": "mainwpcontrol",
+    "commands": "./dist/commands",
+    "default": "chat",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-autocomplete"
+    ],
+    "hooks": {
+      "command_not_found": "./dist/hooks/command-not-found.js"
+    },
+    "topicSeparator": " ",
+    "macos": {
+      "identifier": "com.mainwp.mainwpcontrol"
+    },
+    "update": {
+      "s3": {
+        "bucket": "mainwpcontrol-releases"
+      }
+    }
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "mainwp",
+    "wordpress",
+    "cli",
+    "automation",
+    "ci-cd",
+    "devops",
+    "scripting",
+    "mainwp-control"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "GPL-3.0-or-later",
+  "homepage": "https://github.com/mainwp/mainwp-control",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mainwp/mainwp-control.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mainwp/mainwp-control/issues"
+  },
+  "dependencies": {
+    "@oclif/core": "~4.0.0",
+    "@oclif/plugin-autocomplete": "~3.2.39",
+    "@oclif/plugin-help": "~6.0.0",
+    "ajv": "^8.18.0",
+    "undici": "^7.24.0"
+  },
+  "optionalDependencies": {
+    "keytar": "~7.9.0"
+  },
+  "devDependencies": {
+    "@oclif/test": "^4.0.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "oclif": "^4.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}

package/scripts/completions/README.md

@@ -0,0 +1,221 @@
+# Shell Completion for MainWP Control
+
+This directory contains shell completion scripts for `mainwpcontrol`, providing tab completion for commands, flags, and dynamic data like profile names.
+
+## Quick Start
+
+### Bash
+
+Add to your `~/.bashrc`:
+
+```bash
+source /path/to/mainwp-control/scripts/completions/mainwpcontrol.bash
+```
+
+Then reload your shell:
+
+```bash
+source ~/.bashrc
+```
+
+### Zsh
+
+Add to your `~/.zshrc`:
+
+```bash
+source /path/to/mainwp-control/scripts/completions/mainwpcontrol.zsh
+```
+
+Then reload your shell:
+
+```bash
+source ~/.zshrc
+```
+
+## For npm-installed CLI
+
+If you installed `mainwpcontrol` globally via npm:
+
+```bash
+# Find the installation path
+npm root -g
+
+# Source from node_modules (bash example)
+source $(npm root -g)/@mainwp/control/scripts/completions/mainwpcontrol.bash
+
+# Or for zsh
+source $(npm root -g)/@mainwp/control/scripts/completions/mainwpcontrol.zsh
+```
+
+## For Local Development
+
+If you're developing from the cloned repository:
+
+```bash
+# Bash
+source ./scripts/completions/mainwpcontrol.bash
+
+# Zsh
+source ./scripts/completions/mainwpcontrol.zsh
+```
+
+## What's Completed
+
+### Commands
+
+All top-level and subcommands are completed:
+
+- `chat` - Interactive chat mode
+- `login` - Authenticate with a Dashboard
+- `doctor` - Check configuration and connectivity
+- `abilities list` - List available abilities
+- `abilities info` - Get ability details
+- `abilities run` - Execute an ability
+- `profile list` - List all profiles
+- `profile use` - Switch active profile
+- `profile delete` - Delete a profile
+- `jobs watch` - Monitor a batch job
+- `autocomplete` - Display autocomplete setup instructions
+
+### Flags
+
+All command flags are completed:
+
+**Common flags (all commands):**
+- `--json` - Output JSON
+- `--profile`, `-p` - Use specific profile
+- `--debug` - Show debug output
+- `--help` - Show help
+
+**abilities run:**
+- `--input`, `-i` - Input parameters as JSON
+- `--dry-run` - Preview changes
+- `--confirm` - Execute after preview
+- `--force` - Skip confirmation prompt
+
+**abilities list:**
+- `--category` - Filter by category (sites, clients, updates, plugins, themes, core, tags, batch)
+
+**chat:**
+- `--provider` - LLM provider (anthropic, gemini, local, openai, openrouter)
+- `--model`, `-m` - Model to use
+- `--api-key` - LLM API key
+- `--base-url` - Custom API base URL
+- `--max-turns` - Maximum tool calls per turn
+- `--max-context-messages` - Maximum messages in context
+- `--stream` / `--no-stream` - Enable/disable streaming
+
+**doctor:**
+- `--verbose`, `-v` - Verbose output
+
+**jobs watch:**
+- `--timeout` - Maximum wait time
+- `--initial-delay` - Initial polling delay
+- `--max-delay` - Maximum polling delay
+- `--no-progress` - Disable progress output
+
+**login:**
+- `--url`, `-u` - Dashboard URL
+- `--username` - WordPress username
+- `--password` - Application password
+- `--name`, `-n` - Profile name
+- `--skip-ssl-verify` - Skip SSL verification
+
+### Dynamic Data
+
+Profile names are completed dynamically for:
+
+- `--profile` flag on all commands
+- `profile use <name>` argument
+- `profile delete <name>` argument
+
+Profile names are read from `~/.config/mainwpcontrol/profiles.json`.
+
+## Updating Completions
+
+After adding, removing, or modifying commands/flags in the CLI, run:
+
+```bash
+./scripts/completions/regenerate.sh
+```
+
+This provides guidance on which files to update.
+
+## File Structure
+
+| File | Purpose |
+|------|---------|
+| `mainwpcontrol.bash` | Bash completion script |
+| `mainwpcontrol.zsh` | Zsh completion script |
+| `profile-completer.sh` | Helper to read profile names from config |
+| `regenerate.sh` | Helper script for updating completions |
+| `README.md` | This documentation |
+
+## Troubleshooting
+
+### Completions not working
+
+1. **Check if sourced correctly:**
+   ```bash
+   # Bash
+   complete -p mainwpcontrol
+
+   # Zsh
+   whence -f _mainwpcontrol
+   ```
+
+2. **Reload shell configuration:**
+   ```bash
+   # Bash
+   source ~/.bashrc
+
+   # Zsh
+   source ~/.zshrc
+   ```
+
+3. **Check file paths:**
+   Ensure the sourced path in your shell config points to the correct location.
+
+### Profile names not completing
+
+1. **Check if profiles.json exists:**
+   ```bash
+   cat ~/.config/mainwpcontrol/profiles.json
+   ```
+
+2. **Check if jq is installed (optional but recommended):**
+   ```bash
+   which jq
+   ```
+   If not installed, the fallback grep/sed parser is used.
+
+### Bash completion not found
+
+Ensure `bash-completion` is installed:
+
+```bash
+# macOS
+brew install bash-completion@2
+
+# Ubuntu/Debian
+apt install bash-completion
+
+# Fedora/RHEL
+dnf install bash-completion
+```
+
+### Permission errors
+
+Make sure completion scripts are executable:
+
+```bash
+chmod +x scripts/completions/*.sh
+chmod +x scripts/completions/mainwpcontrol.bash
+chmod +x scripts/completions/mainwpcontrol.zsh
+```
+
+## Requirements
+
+- **Bash:** Version 4.0+ with bash-completion v2.0+
+- **Zsh:** Any modern version (built-in completion support)
+- **Optional:** `jq` for reliable JSON parsing of profile names

package/scripts/completions/mainwpcontrol.bash

@@ -0,0 +1,193 @@
+#!/bin/bash
+# mainwpcontrol bash completion script
+#
+# Installation:
+#   source /path/to/mainwpcontrol/scripts/completions/mainwpcontrol.bash
+#
+# Or add to ~/.bashrc:
+#   source /path/to/mainwpcontrol/scripts/completions/mainwpcontrol.bash
+
+# Determine the directory where this script is located
+_MAINWPCTL_COMPLETION_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Source the profile completer helper
+if [[ -f "${_MAINWPCTL_COMPLETION_DIR}/profile-completer.sh" ]]; then
+    source "${_MAINWPCTL_COMPLETION_DIR}/profile-completer.sh"
+fi
+
+_mainwpcontrol_completions() {
+    local cur prev words cword
+    _init_completion -n : || return
+
+    # All top-level commands
+    local commands="abilities autocomplete chat doctor help jobs login profile"
+
+    # Subcommands by topic
+    local abilities_commands="info list run"
+    local jobs_commands="watch"
+    local profile_commands="delete list use"
+
+    # Common flags (available on all commands)
+    local common_flags="--debug --help --json --profile -p"
+
+    # Command-specific flags
+    local abilities_run_flags="--confirm --dry-run --force --input -i"
+    local abilities_list_flags="--category"
+    local chat_flags="--api-key --base-url --max-context-messages --max-turns --model --no-stream --provider --stream -m"
+    local doctor_flags="--verbose -v"
+    local jobs_watch_flags="--initial-delay --max-delay --no-progress --timeout"
+    local login_flags="--name --password --skip-ssl-verify --url --username -n -u"
+
+    # Get the position in the command structure
+    local cmd_depth=0
+    local main_cmd=""
+    local sub_cmd=""
+
+    for ((i=1; i < cword; i++)); do
+        case "${words[i]}" in
+            -*)
+                # Skip flags and their values
+                if [[ "${words[i]}" =~ ^--(profile|input|model|provider|api-key|base-url|max-turns|max-context-messages|category|timeout|initial-delay|max-delay|url|username|password|name)$ ]]; then
+                    ((i++))  # Skip the value too
+                fi
+                ;;
+            abilities|chat|doctor|help|jobs|login|profile|autocomplete)
+                if [[ -z "$main_cmd" ]]; then
+                    main_cmd="${words[i]}"
+                    cmd_depth=1
+                fi
+                ;;
+            info|list|run|watch|use|delete)
+                if [[ -n "$main_cmd" && -z "$sub_cmd" ]]; then
+                    sub_cmd="${words[i]}"
+                    cmd_depth=2
+                fi
+                ;;
+        esac
+    done
+
+    # Handle flag value completions
+    case "$prev" in
+        --profile|-p)
+            # Complete with profile names
+            local profiles
+            if type _mainwpcontrol_get_profiles &>/dev/null; then
+                profiles=$(_mainwpcontrol_get_profiles)
+                COMPREPLY=($(compgen -W "$profiles" -- "$cur"))
+            fi
+            return 0
+            ;;
+        --provider)
+            COMPREPLY=($(compgen -W "anthropic gemini local openai openrouter" -- "$cur"))
+            return 0
+            ;;
+        --category)
+            COMPREPLY=($(compgen -W "sites clients updates plugins themes core tags batch" -- "$cur"))
+            return 0
+            ;;
+        --input|-i|--model|-m|--api-key|--base-url|--max-turns|--max-context-messages|--timeout|--initial-delay|--max-delay|--url|-u|--username|--password|--name|-n)
+            # These flags require user input, no completion
+            return 0
+            ;;
+    esac
+
+    # Top-level command completion
+    if [[ $cword -eq 1 ]]; then
+        COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+        return 0
+    fi
+
+    # Subcommand and flag completion based on context
+    case "$main_cmd" in
+        abilities)
+            if [[ -z "$sub_cmd" ]]; then
+                # Complete subcommands or flags
+                if [[ "$cur" == -* ]]; then
+                    COMPREPLY=($(compgen -W "$common_flags" -- "$cur"))
+                else
+                    COMPREPLY=($(compgen -W "$abilities_commands" -- "$cur"))
+                fi
+            else
+                # Complete flags for abilities subcommands
+                case "$sub_cmd" in
+                    run)
+                        COMPREPLY=($(compgen -W "$common_flags $abilities_run_flags" -- "$cur"))
+                        ;;
+                    list)
+                        COMPREPLY=($(compgen -W "$common_flags $abilities_list_flags" -- "$cur"))
+                        ;;
+                    info)
+                        COMPREPLY=($(compgen -W "$common_flags" -- "$cur"))
+                        ;;
+                esac
+            fi
+            ;;
+        chat)
+            COMPREPLY=($(compgen -W "$common_flags $chat_flags" -- "$cur"))
+            ;;
+        doctor)
+            COMPREPLY=($(compgen -W "$common_flags $doctor_flags" -- "$cur"))
+            ;;
+        help)
+            # Complete with command names for help
+            COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+            ;;
+        jobs)
+            if [[ -z "$sub_cmd" ]]; then
+                if [[ "$cur" == -* ]]; then
+                    COMPREPLY=($(compgen -W "$common_flags" -- "$cur"))
+                else
+                    COMPREPLY=($(compgen -W "$jobs_commands" -- "$cur"))
+                fi
+            else
+                case "$sub_cmd" in
+                    watch)
+                        COMPREPLY=($(compgen -W "$common_flags $jobs_watch_flags" -- "$cur"))
+                        ;;
+                esac
+            fi
+            ;;
+        login)
+            COMPREPLY=($(compgen -W "$common_flags $login_flags" -- "$cur"))
+            ;;
+        profile)
+            if [[ -z "$sub_cmd" ]]; then
+                if [[ "$cur" == -* ]]; then
+                    COMPREPLY=($(compgen -W "$common_flags" -- "$cur"))
+                else
+                    COMPREPLY=($(compgen -W "$profile_commands" -- "$cur"))
+                fi
+            else
+                case "$sub_cmd" in
+                    use|delete)
+                        # Complete with profile names for these subcommands
+                        if [[ "$cur" != -* ]]; then
+                            local profiles
+                            if type _mainwpcontrol_get_profiles &>/dev/null; then
+                                profiles=$(_mainwpcontrol_get_profiles)
+                                COMPREPLY=($(compgen -W "$profiles" -- "$cur"))
+                            fi
+                        else
+                            COMPREPLY=($(compgen -W "$common_flags" -- "$cur"))
+                        fi
+                        ;;
+                    list)
+                        COMPREPLY=($(compgen -W "$common_flags" -- "$cur"))
+                        ;;
+                esac
+            fi
+            ;;
+        autocomplete)
+            COMPREPLY=($(compgen -W "bash zsh" -- "$cur"))
+            ;;
+        *)
+            # Default: complete commands
+            COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+            ;;
+    esac
+
+    return 0
+}
+
+# Register the completion function
+complete -F _mainwpcontrol_completions mainwpcontrol