opencode-homebrew-agent 1.0.0

package/src/scripts/brew-env.sh

@@ -0,0 +1,288 @@
+#!/bin/bash
+set -euo pipefail
+
+# scripts/brew-env.sh
+# Inspect the Homebrew environment and output a formatted report.
+
+PROG="brew-env.sh"
+
+usage() {
+  cat <<EOF
+Usage: ${PROG} [OPTION]
+
+Inspect the Homebrew environment.
+
+Options:
+  --config    Show only the brew config section
+  --taps      Show only tapped repositories
+  --cellar    Show only Cellar contents summary
+  --ruby      Show only Ruby version info
+  --json      Output full report as JSON
+  --help      Show this help message and exit
+
+With no arguments, prints a full human-readable report.
+EOF
+}
+
+# Diagnostics go to stderr
+die() {
+  echo "${PROG}: error: $1" >&2
+  exit 1
+}
+
+# ---------------------------------------------------------------------------
+# Data collection
+# ---------------------------------------------------------------------------
+
+get_brew_config() {
+  if command -v brew >/dev/null 2>&1; then
+    brew config 2>/dev/null | grep -E '^[A-Z_]+:' || true
+  else
+    echo "brew not found"
+  fi
+}
+
+get_taps() {
+  if command -v brew >/dev/null 2>&1; then
+    brew tap 2>/dev/null || true
+  else
+    echo "brew not found"
+  fi
+}
+
+get_cellar() {
+  local cellar_path
+  if command -v brew >/dev/null 2>&1; then
+    cellar_path="$(brew --prefix 2>/dev/null)/Cellar"
+  else
+    cellar_path="/opt/homebrew/Cellar"
+  fi
+
+  if [[ -d "${cellar_path}" ]]; then
+    ls -1 "${cellar_path}" 2>/dev/null || true
+  else
+    echo "Cellar not found at ${cellar_path}"
+  fi
+}
+
+get_ruby_version() {
+  if command -v brew >/dev/null 2>&1; then
+    brew ruby --version 2>/dev/null || ruby --version 2>/dev/null || echo "Ruby not found"
+  else
+    ruby --version 2>/dev/null || echo "Ruby not found"
+  fi
+}
+
+get_prefix() {
+  if command -v brew >/dev/null 2>&1; then
+    brew --prefix 2>/dev/null || echo "unknown"
+  else
+    echo "brew not found"
+  fi
+}
+
+get_github_api_status() {
+  local status
+  status=$(curl -sI https://api.github.com 2>/dev/null | head -n 1 | tr -d '\r')
+  if [[ -z "${status}" ]]; then
+    echo "unreachable"
+  else
+    echo "${status}"
+  fi
+}
+
+# ---------------------------------------------------------------------------
+# Output formatters
+# ---------------------------------------------------------------------------
+
+print_header() {
+  echo ""
+  echo "== $1 =="
+}
+
+print_kv() {
+  local key value
+  key="$1"
+  value="$2"
+  printf "  %-30s %s\n" "${key}:" "${value}"
+}
+
+output_human() {
+  local show_config=false
+  local show_taps=false
+  local show_cellar=false
+  local show_ruby=false
+
+  if [[ -z "${1:-}" ]]; then
+    show_config=true
+    show_taps=true
+    show_cellar=true
+    show_ruby=true
+  else
+    case "$1" in
+      --config) show_config=true ;;
+      --taps)   show_taps=true ;;
+      --cellar) show_cellar=true ;;
+      --ruby)   show_ruby=true ;;
+    esac
+  fi
+
+  if [[ "${show_config}" == true ]]; then
+    print_header "Homebrew Config"
+    while IFS= read -r line; do
+      if [[ -n "${line}" ]]; then
+        local key value
+        key="${line%%:*}"
+        value="${line#*: }"
+        print_kv "${key}" "${value}"
+      fi
+    done <<< "$(get_brew_config)"
+  fi
+
+  if [[ "${show_taps}" == true ]]; then
+    print_header "Tapped Repositories"
+    local taps
+    taps=$(get_taps)
+    if [[ -z "${taps}" ]]; then
+      echo "  (none)"
+    else
+      while IFS= read -r line; do
+        echo "  ${line}"
+      done <<< "${taps}"
+    fi
+  fi
+
+  if [[ "${show_cellar}" == true ]]; then
+    print_header "Cellar Contents"
+    local cellar
+    cellar=$(get_cellar)
+    if [[ -z "${cellar}" ]]; then
+      echo "  (empty)"
+    else
+      while IFS= read -r line; do
+        echo "  ${line}"
+      done <<< "${cellar}"
+    fi
+  fi
+
+  if [[ "${show_ruby}" == true ]]; then
+    print_header "Ruby Version"
+    echo "  $(get_ruby_version)"
+    print_header "Homebrew Prefix"
+    echo "  $(get_prefix)"
+    print_header "GitHub API Access"
+    echo "  $(get_github_api_status)"
+  fi
+}
+
+# Simple JSON string escaping helper
+json_escape() {
+  local str="$1"
+  str="${str//\\/\\\\}"
+  str="${str//\"/\\\"}"
+  str="${str//$'\n'/\\n}"
+  str="${str//$'\r'/}"
+  printf '%s' "$str"
+}
+
+output_json() {
+  local config_lines taps_lines cellar_lines ruby_version prefix github_status
+  config_lines=$(get_brew_config)
+  taps_lines=$(get_taps)
+  cellar_lines=$(get_cellar)
+  ruby_version=$(get_ruby_version)
+  prefix=$(get_prefix)
+  github_status=$(get_github_api_status)
+
+  echo "{"
+
+  # config object
+  echo '  "config": {'
+  local first=true
+  while IFS= read -r line; do
+    if [[ -n "${line}" ]]; then
+      local key value
+      key="${line%%:*}"
+      value="${line#*: }"
+      if [[ "${first}" == true ]]; then
+        first=false
+      else
+        echo ","
+      fi
+      printf '    "%s": "%s"' "$(json_escape "${key}")" "$(json_escape "${value}")"
+    fi
+  done <<< "${config_lines}"
+  echo ""
+  echo "  },"
+
+  # taps array
+  echo '  "taps": ['
+  first=true
+  while IFS= read -r line; do
+    if [[ -n "${line}" ]]; then
+      if [[ "${first}" == true ]]; then
+        first=false
+      else
+        echo ","
+      fi
+      printf '    "%s"' "$(json_escape "${line}")"
+    fi
+  done <<< "${taps_lines}"
+  echo ""
+  echo "  ],"
+
+  # cellar array
+  echo '  "cellar": ['
+  first=true
+  while IFS= read -r line; do
+    if [[ -n "${line}" ]]; then
+      if [[ "${first}" == true ]]; then
+        first=false
+      else
+        echo ","
+      fi
+      printf '    "%s"' "$(json_escape "${line}")"
+    fi
+  done <<< "${cellar_lines}"
+  echo ""
+  echo "  ],"
+
+  # metadata
+  printf '  "ruby_version": "%s",\n' "$(json_escape "${ruby_version}")"
+  printf '  "prefix": "%s",\n' "$(json_escape "${prefix}")"
+  printf '  "github_api_status": "%s"\n' "$(json_escape "${github_status}")"
+
+  echo "}"
+}
+
+# ---------------------------------------------------------------------------
+# Main
+# ---------------------------------------------------------------------------
+
+main() {
+  local arg="${1:-}"
+
+  case "${arg}" in
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    --json)
+      output_json
+      exit 0
+      ;;
+    --config|--taps|--cellar|--ruby)
+      output_human "${arg}"
+      exit 0
+      ;;
+    "")
+      output_human
+      exit 0
+      ;;
+    *)
+      die "unknown option: ${arg}"
+      ;;
+  esac
+}
+
+main "$@"

package/src/scripts/brew-search.sh

@@ -0,0 +1,150 @@
+#!/bin/bash
+set -euo pipefail
+
+PROG_NAME="$(basename "$0")"
+
+usage() {
+  cat <<EOF
+Usage: ${PROG_NAME} [options] <query>
+
+Search Homebrew formulae and casks with rich output.
+
+Options:
+  --formulae    Search only formulae
+  --casks       Search only casks
+  --desc        Search descriptions only
+  --json        Output results as JSON
+  --help        Show this help message
+
+Examples:
+  ${PROG_NAME} python
+  ${PROG_NAME} --casks firefox
+  ${PROG_NAME} --json python
+EOF
+}
+
+search_formulae=true
+search_casks=true
+search_desc=true
+json_output=false
+query=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --help)
+      usage
+      exit 0
+      ;;
+    --formulae)
+      search_formulae=true
+      search_casks=false
+      search_desc=false
+      ;;
+    --casks)
+      search_formulae=false
+      search_casks=true
+      search_desc=false
+      ;;
+    --desc)
+      search_formulae=false
+      search_casks=false
+      search_desc=true
+      ;;
+    --json)
+      json_output=true
+      ;;
+    --)
+      shift
+      break
+      ;;
+    -*)
+      echo "Error: Unknown option $1" >&2
+      usage >&2
+      exit 1
+      ;;
+    *)
+      if [[ -z "$query" ]]; then
+        query="$1"
+      else
+        query="$query $1"
+      fi
+      ;;
+  esac
+  shift
+done
+
+if [[ -z "$query" ]]; then
+  usage >&2
+  echo >&2
+  brew search
+  exit 1
+fi
+
+search_formulae_fn() {
+  brew search --formula --quiet "$query" 2>/dev/null | grep -v "Use \`brew desc\`" | grep -v "^$" || true
+}
+
+search_casks_fn() {
+  brew search --casks --quiet "$query" 2>/dev/null | grep -v "Use \`brew desc\`" | grep -v "^$" || true
+}
+
+search_desc_fn() {
+  brew search --desc --quiet "$query" 2>/dev/null | grep -v "Use \`brew desc\`" | grep -v "^$" || true
+}
+
+results_formulae=""
+results_casks=""
+results_desc=""
+
+if [[ "$search_formulae" == true ]]; then
+  results_formulae=$(search_formulae_fn)
+fi
+
+if [[ "$search_casks" == true ]]; then
+  results_casks=$(search_casks_fn)
+fi
+
+if [[ "$search_desc" == true ]]; then
+  results_desc=$(search_desc_fn)
+fi
+
+if [[ -z "$results_formulae" && -z "$results_casks" && -z "$results_desc" ]]; then
+  if [[ "$json_output" == true ]]; then
+    echo '{"formulae":[],"casks":[],"descriptions":[]}'
+  else
+    echo "No matches found"
+  fi
+  exit 0
+fi
+
+if [[ "$json_output" == true ]]; then
+  json_formulae=$(printf '%s\n' "$results_formulae" | ruby -rjson -e 'puts JSON.generate(ARGF.read.lines.map(&:chomp).reject(&:empty?))')
+  json_casks=$(printf '%s\n' "$results_casks" | ruby -rjson -e 'puts JSON.generate(ARGF.read.lines.map(&:chomp).reject(&:empty?))')
+  json_descriptions=$(printf '%s\n' "$results_desc" | ruby -rjson -e 'puts JSON.generate(ARGF.read.lines.map(&:chomp).reject(&:empty?))')
+
+  echo "{\"formulae\":${json_formulae},\"casks\":${json_casks},\"descriptions\":${json_descriptions}}"
+else
+  print_section() {
+    local title="$1"
+    local content="$2"
+    if [[ -n "$content" ]]; then
+      local count
+      count=$(echo "$content" | wc -l | tr -d ' ')
+      echo "==> ${title} (${count})"
+      echo "$content"
+      echo
+    fi
+  }
+
+  if [[ "$search_formulae" == true ]]; then
+    print_section "Formulae" "$results_formulae"
+  fi
+
+  if [[ "$search_casks" == true ]]; then
+    print_section "Casks" "$results_casks"
+  fi
+
+  if [[ "$search_desc" == true ]]; then
+    print_section "Description Matches" "$results_desc"
+  fi
+fi

package/src/scripts/brew-template.sh

@@ -0,0 +1,263 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+TEMPLATES_DIR="$PROJECT_ROOT/templates/taps"
+
+usage() {
+  cat <<'EOF'
+Usage: brew-template.sh <project-type> [options]
+
+Recommend and apply the best Homebrew tap template for a given project type.
+
+Project types:
+  go-binary     Go CLI built from source
+  python-venv   Python CLI with pip virtualenv
+  node-npm      JS/TS CLI with npm or bun
+  simple-script Simple script + release script
+  full-ci       Full CI suite (test-bot + bottles + autobump)
+  root-level    Root-level .rb (minimal, 1-2 formulae)
+  keg-only      System tool replacement (shadows macOS)
+  cask          macOS GUI app (.app/.dmg)
+
+Options:
+  --name <formula>      Formula class name (CamelCase, auto-converts kebab-case)
+  --tap <user/tapname>  Tap identifier
+  --output <path>       Where to create the tap structure (required)
+  --with-ci             Run 'brew tap-new <user>/<tapname>' first
+  --convert-to-bun      If node-npm, add a note about using bun
+  --list                List all templates with descriptions
+  --help                Show this message
+
+Examples:
+  brew-template.sh go-binary --name my-tool --output ./homebrew-mytool
+  brew-template.sh node-npm --name my-tool --output ./homebrew-mytool --convert-to-bun
+  brew-template.sh --list
+EOF
+}
+
+list_templates() {
+  cat <<'EOF'
+Available templates:
+  01-full-ci       Full CI suite (test-bot + bottles + autobump)
+  02-root-level    Root-level .rb (minimal, 1-2 formulae)
+  03-simple-script Simple script + release script
+  04-python-venv   Python CLI with pip virtualenv
+  05-node-npm      JS/TS CLI with npm or bun
+  06-keg-only      System tool replacement (shadows macOS)
+  07-cask-only     macOS GUI app (.app/.dmg)
+  08-go-binary     Go CLI built from source
+EOF
+}
+
+map_type_to_dir() {
+  local type_name="$1"
+  case "$type_name" in
+    full-ci)       echo "01-full-ci" ;;
+    root-level)    echo "02-root-level" ;;
+    simple-script) echo "03-simple-script" ;;
+    python-venv)   echo "04-python-venv" ;;
+    node-npm)      echo "05-node-npm" ;;
+    keg-only)      echo "06-keg-only" ;;
+    cask)          echo "07-cask-only" ;;
+    go-binary)     echo "08-go-binary" ;;
+    *)             echo "invalid" ;;
+  esac
+}
+
+# Convert kebab-case or snake_case to CamelCase
+# e.g. "my-test-cli" -> "MyTestCli", "my_test_cli" -> "MyTestCli"
+to_camelcase() {
+  local input="$1"
+  # Replace underscores with hyphens for uniform splitting
+  input="${input//_/-}"
+  if [[ "$input" == *"-"* ]]; then
+    local result=""
+    local IFS='-'
+    read -ra parts <<< "$input"
+    for part in "${parts[@]}"; do
+      # Capitalize first letter, lowercase rest
+      local first="${part:0:1}"
+      local rest="${part:1}"
+      result+=""$(echo "$first" | tr '[:lower:]' '[:upper:]')$(echo "$rest" | tr '[:upper:]' '[:lower:]')""
+    done
+    echo "$result"
+  else
+    # No hyphens: just ensure first letter is capitalized
+    local first="${input:0:1}"
+    local rest="${input:1}"
+    echo "$(echo "$first" | tr '[:lower:]' '[:upper:]')$rest"
+  fi
+}
+
+# Lowercase a name for filename
+# e.g. "MyTestCli" -> "mytestcli", "my-test-cli" -> "my-test-cli"
+to_lowercase_filename() {
+  local input="$1"
+  echo "$input" | tr '[:upper:]' '[:lower:]'
+}
+
+PROJECT_TYPE=""
+FORMULA_NAME=""
+TAP_NAME=""
+OUTPUT_DIR=""
+WITH_CI=false
+CONVERT_TO_BUN=false
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --help)
+      usage
+      exit 0
+      ;;
+    --list)
+      list_templates
+      exit 0
+      ;;
+    --name)
+      if [[ -z "${2:-}" ]]; then
+        echo "Error: --name requires an argument" >&2
+        exit 1
+      fi
+      FORMULA_NAME="$2"
+      shift 2
+      ;;
+    --tap)
+      if [[ -z "${2:-}" ]]; then
+        echo "Error: --tap requires an argument" >&2
+        exit 1
+      fi
+      TAP_NAME="$2"
+      shift 2
+      ;;
+    --output)
+      if [[ -z "${2:-}" ]]; then
+        echo "Error: --output requires an argument" >&2
+        exit 1
+      fi
+      OUTPUT_DIR="$2"
+      shift 2
+      ;;
+    --with-ci)
+      WITH_CI=true
+      shift
+      ;;
+    --convert-to-bun)
+      CONVERT_TO_BUN=true
+      shift
+      ;;
+    --*)
+      echo "Error: unknown option $1" >&2
+      usage >&2
+      exit 1
+      ;;
+    *)
+      if [[ -z "$PROJECT_TYPE" ]]; then
+        PROJECT_TYPE="$1"
+        shift
+      else
+        echo "Error: unexpected argument $1" >&2
+        usage >&2
+        exit 1
+      fi
+      ;;
+  esac
+done
+
+if [[ -z "${PROJECT_TYPE:-}" ]]; then
+  echo "Error: project type is required" >&2
+  usage >&2
+  exit 1
+fi
+
+if [[ -z "${OUTPUT_DIR:-}" ]]; then
+  echo "Error: --output is required" >&2
+  usage >&2
+  exit 1
+fi
+
+TEMPLATE_DIR_NAME="$(map_type_to_dir "$PROJECT_TYPE")"
+if [[ "$TEMPLATE_DIR_NAME" == "invalid" ]]; then
+  echo "Error: unknown project type '$PROJECT_TYPE'" >&2
+  echo "" >&2
+  list_templates >&2
+  exit 1
+fi
+
+TEMPLATE_SRC="$TEMPLATES_DIR/$TEMPLATE_DIR_NAME/tap-structure"
+if [[ ! -d "$TEMPLATE_SRC" ]]; then
+  echo "Error: template source not found: $TEMPLATE_SRC" >&2
+  exit 1
+fi
+
+# Handle existing output directory
+if [[ -e "$OUTPUT_DIR" ]]; then
+  if [[ -t 0 ]]; then
+    read -rp "Directory '$OUTPUT_DIR' already exists. Overwrite? [y/N] " answer
+    case "$answer" in
+      [Yy]*) rm -rf "$OUTPUT_DIR" ;;
+      *) echo "Aborted." >&2; exit 1 ;;
+    esac
+  else
+    echo "Error: output directory '$OUTPUT_DIR' already exists" >&2
+    exit 1
+  fi
+fi
+
+# Optionally run brew tap-new
+if [[ "$WITH_CI" == true ]]; then
+  if [[ -z "$TAP_NAME" ]]; then
+    echo "Error: --tap is required when using --with-ci" >&2
+    exit 1
+  fi
+  brew tap-new "$TAP_NAME"
+fi
+
+# Copy template
+mkdir -p "$OUTPUT_DIR"
+cp -R "$TEMPLATE_SRC/"* "$OUTPUT_DIR/"
+
+# Rename placeholder formula/cask files
+if [[ -n "$FORMULA_NAME" ]]; then
+  CAMEL_NAME="$(to_camelcase "$FORMULA_NAME")"
+  LOWER_NAME="$(to_lowercase_filename "$FORMULA_NAME")"
+
+  # Find placeholder formula files
+  while IFS= read -r -d '' placeholder; do
+    dir="$(dirname "$placeholder")"
+    new_path="$dir/$LOWER_NAME.rb"
+    mv "$placeholder" "$new_path"
+
+    if [[ "$PROJECT_TYPE" == "cask" ]]; then
+      # Update cask token
+      sed -i.bak "s/cask \"<app>\"/cask \"$LOWER_NAME\"/g" "$new_path"
+      rm -f "$new_path.bak"
+    else
+      # Update formula class name
+      sed -i.bak "s/class <Formula>/class $CAMEL_NAME/g" "$new_path"
+      rm -f "$new_path.bak"
+    fi
+  done < <(find "$OUTPUT_DIR" \( -name '_formula.rb' -o -name '_app.rb' \) -print0)
+fi
+
+# Handle --convert-to-bun for node-npm
+if [[ "$CONVERT_TO_BUN" == true ]] && [[ "$PROJECT_TYPE" == "node-npm" ]]; then
+  FORMULA_FILE=$(find "$OUTPUT_DIR" -name '*.rb' | head -n 1)
+  if [[ -n "$FORMULA_FILE" ]]; then
+    {
+      echo "# NOTE: --convert-to-bun was specified. Uncomment the bun pattern below and remove the npm pattern."
+      cat "$FORMULA_FILE"
+    } > "$FORMULA_FILE.tmp"
+    mv "$FORMULA_FILE.tmp" "$FORMULA_FILE"
+  fi
+fi
+
+echo "Tap structure created at: $OUTPUT_DIR"
+if [[ -n "$TAP_NAME" ]]; then
+  echo "Tap: $TAP_NAME"
+fi
+if [[ -n "$FORMULA_NAME" ]]; then
+  echo "Formula: $FORMULA_NAME"
+fi