@deeeed/metamask-harness 0.2.0

package/scripts/completions.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# completions.sh — bundled tab completion for `mm-harness` (bash + zsh).
+#
+# Static parts (commands, positional targets, per-command flags) mirror the
+# mm-harness surface. Dynamic parts are sourced live from the hidden
+# `mm-harness completion-candidates <actions|flows>` command (per-checkout cached):
+#   call <TAB>   → action names from the adapter manifest
+#   run  <TAB>   → recipe files + flow refs from the recipe library
+# so completion reflects the installed overlay's real vocabulary. A candidate read
+# that fails is silently empty — completion never blocks the shell.
+#
+# Install: source this file from ~/.zshrc / ~/.bashrc
+#   (see: mm-harness completions install).
+
+# Resolve the mm-harness bin: prefer one on PATH, else this checkout's bin.
+_mmh_bin() {
+  if command -v mm-harness >/dev/null 2>&1; then
+    command -v mm-harness
+    return 0
+  fi
+  if [ -n "${BASH_SOURCE[0]:-}" ]; then
+    local here
+    here="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." 2>/dev/null && pwd)" || true
+    if [ -n "$here" ] && [ -x "$here/bin/mm-harness" ]; then
+      printf '%s\n' "$here/bin/mm-harness"
+      return 0
+    fi
+  fi
+  return 1
+}
+
+_mmh_commands="launch logs debug fixtures actions call flows run doctor install verify cleanup completions"
+
+# Per-command flags (static, from the mm-harness surface).
+_mmh_flags_for() {
+  case "$1" in
+    launch)   printf '%s' "--build --watch --verify --sidepanel --fullscreen --runway --device --cdp-port --watcher-port --heal --adapter --target --json" ;;
+    logs)     printf '%s' "--full --events --source --adapter --target --json" ;;
+    debug)    printf '%s' "--worker --dev-menu --adapter --target --json" ;;
+    fixtures) printf '%s' "--fixture --adapter --target --json" ;;
+    actions)  printf '%s' "--adapter --action --kind --raw --action-manifest --target --json" ;;
+    call)     printf '%s' "--arg --adapter --target --artifacts-dir --action-manifest --heal --json" ;;
+    flows)    printf '%s' "--library --json" ;;
+    run)      printf '%s' "--plan --adapter --artifacts-dir --target --library --cdp-port --heal --record-video --json" ;;
+    doctor)   printf '%s' "--adapter --target --fix --json" ;;
+    install|verify|cleanup) printf '%s' "--adapter --target --json" ;;
+    *)        printf '%s' "" ;;
+  esac
+}
+
+# Dynamic candidates from the DISCOVER layer (silent empty on any failure).
+_mmh_actions() { local b; b="$(_mmh_bin)" || return 0; "$b" completion-candidates actions 2>/dev/null; }
+_mmh_flows()   { local b; b="$(_mmh_bin)" || return 0; "$b" completion-candidates flows 2>/dev/null; }
+
+# ── Bash ────────────────────────────────────────────────────────────────
+if [ -n "${BASH_VERSION:-}" ]; then
+  _mmh_complete_bash() {
+    local cur prev words cword
+    _get_comp_words_by_ref -n : cur prev words cword 2>/dev/null || {
+      cur="${COMP_WORDS[COMP_CWORD]}"
+      prev="${COMP_WORDS[COMP_CWORD-1]}"
+      words=("${COMP_WORDS[@]}")
+      cword=$COMP_CWORD
+    }
+
+    if [ "$cword" -eq 1 ]; then
+      COMPREPLY=($(compgen -W "$_mmh_commands" -- "$cur"))
+      return
+    fi
+
+    local cmd="${words[1]}"
+    case "$cur" in
+      -*) COMPREPLY=($(compgen -W "$(_mmh_flags_for "$cmd")" -- "$cur")); return ;;
+    esac
+
+    case "$cmd" in
+      launch)      [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "ios android" -- "$cur")) ;;
+      fixtures)    [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "sync set" -- "$cur")) ;;
+      completions) [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "install bash zsh status" -- "$cur")) ;;
+      flows)       [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "list promote" -- "$cur")) ;;
+      call)        [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "$(_mmh_actions)" -- "$cur")) ;;
+      run)         COMPREPLY=($(compgen -f -- "$cur"; compgen -W "$(_mmh_flows)" -- "$cur")) ;;
+      *)           COMPREPLY=($(compgen -W "$(_mmh_flags_for "$cmd")" -- "$cur")) ;;
+    esac
+  }
+  complete -F _mmh_complete_bash mm-harness 2>/dev/null || true
+fi
+
+# ── Zsh ─────────────────────────────────────────────────────────────────
+if [ -n "${ZSH_VERSION:-}" ]; then
+  _mmh_complete_zsh() {
+    local -a candidates
+    local cmd="${words[2]:-}"
+
+    if (( CURRENT == 2 )); then
+      candidates=(${=_mmh_commands})
+      compadd -a candidates
+      return
+    fi
+
+    local cur="${words[CURRENT]}"
+    if [[ "$cur" == -* ]]; then
+      candidates=(${=$(_mmh_flags_for "$cmd")})
+      compadd -a candidates
+      return
+    fi
+
+    case "$cmd" in
+      launch)      (( CURRENT == 3 )) && { candidates=(ios android); compadd -a candidates; } ;;
+      fixtures)    (( CURRENT == 3 )) && { candidates=(sync set); compadd -a candidates; } ;;
+      completions) (( CURRENT == 3 )) && { candidates=(install bash zsh status); compadd -a candidates; } ;;
+      flows)       (( CURRENT == 3 )) && { candidates=(list promote); compadd -a candidates; } ;;
+      call)        (( CURRENT == 3 )) && { candidates=("${(@f)$(_mmh_actions)}"); compadd -a candidates; } ;;
+      run)         candidates=("${(@f)$(_mmh_flows)}"); compadd -a candidates; _files ;;
+      *)           candidates=(${=$(_mmh_flags_for "$cmd")}); compadd -a candidates ;;
+    esac
+  }
+
+  if (( $+functions[compdef] )); then
+    compdef _mmh_complete_zsh mm-harness
+  else
+    autoload -Uz compinit 2>/dev/null && compinit -u 2>/dev/null
+    (( $+functions[compdef] )) && compdef _mmh_complete_zsh mm-harness
+  fi
+fi

package/scripts/install-completions.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# install-completions.sh — install mm-harness shell completions (bash + zsh)
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+RUNNER_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+BASH_SNIPPET="source \"$RUNNER_ROOT/scripts/completions.sh\""
+ZSH_SNIPPET=$'# mm-harness tab completion\nsource '"\"$RUNNER_ROOT/scripts/completions.sh\""
+
+usage() {
+  cat <<EOF
+Usage: install-completions.sh [install|bash|zsh|status]
+
+  install  Print setup lines for bash and zsh (default)
+  bash     Print bash one-liner to add to ~/.bashrc
+  zsh      Print zsh lines to add to ~/.zshrc
+  status   Show whether completions appear installed
+
+Tab completion: type "mm-harness " (with a trailing space) then press TAB.
+
+After install, restart your shell or run:
+  source $RUNNER_ROOT/scripts/completions.sh
+EOF
+}
+
+cmd="${1:-install}"
+case "$cmd" in
+  -h|--help) usage; exit 0 ;;
+  bash)
+    printf '%s\n' "$BASH_SNIPPET"
+    ;;
+  zsh)
+    printf '%s\n' "$ZSH_SNIPPET"
+    ;;
+  status)
+    if [ -f "$HOME/.bashrc" ] && grep -Fq "$RUNNER_ROOT/scripts/completions.sh" "$HOME/.bashrc" 2>/dev/null; then
+      echo "bash: sourced from ~/.bashrc"
+    else
+      echo "bash: not sourced (run: install-completions.sh bash)"
+    fi
+    if [ -f "$HOME/.zshrc" ] && grep -Fq "$RUNNER_ROOT/scripts/completions.sh" "$HOME/.zshrc" 2>/dev/null; then
+      echo "zsh: sourced from ~/.zshrc"
+    else
+      echo "zsh: not sourced (run: install-completions.sh zsh)"
+    fi
+    ;;
+  install)
+    echo "Add to ~/.bashrc:"
+    echo "  $BASH_SNIPPET"
+    echo ""
+    echo "Add to ~/.zshrc:"
+    echo "  $ZSH_SNIPPET"
+    echo ""
+    echo "Reload now:"
+    echo "  source $RUNNER_ROOT/scripts/completions.sh"
+    ;;
+  *)
+    echo "Unknown command: $cmd" >&2
+    usage >&2
+    exit 2
+    ;;
+esac