@poolzin/pool-bot 2026.3.13 → 2026.3.15

package/extensions/agency-agents/agents/scripts/install.sh

@@ -0,0 +1,465 @@
+#!/usr/bin/env bash
+#
+# install.sh -- Install The Agency agents into your local agentic tool(s).
+#
+# Reads converted files from integrations/ and copies them to the appropriate
+# config directory for each tool. Run scripts/convert.sh first if integrations/
+# is missing or stale.
+#
+# Usage:
+#   ./scripts/install.sh [--tool <name>] [--interactive] [--no-interactive] [--help]
+#
+# Tools:
+#   claude-code  -- Copy agents to ~/.claude/agents/
+#   antigravity  -- Copy skills to ~/.gemini/antigravity/skills/
+#   gemini-cli   -- Install extension to ~/.gemini/extensions/agency-agents/
+#   opencode     -- Copy agents to .opencode/agent/ in current directory
+#   cursor       -- Copy rules to .cursor/rules/ in current directory
+#   aider        -- Copy CONVENTIONS.md to current directory
+#   windsurf     -- Copy .windsurfrules to current directory
+#   all          -- Install for all detected tools (default)
+#
+# Flags:
+#   --tool <name>     Install only the specified tool
+#   --interactive     Show interactive selector (default when run in a terminal)
+#   --no-interactive  Skip interactive selector, install all detected tools
+#   --help            Show this help
+#
+# Platform support:
+#   Linux, macOS (requires bash 3.2+), Windows Git Bash / WSL
+
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# Colours -- only when stdout is a real terminal
+# ---------------------------------------------------------------------------
+if [[ -t 1 ]]; then
+  C_GREEN=$'\033[0;32m'
+  C_YELLOW=$'\033[1;33m'
+  C_RED=$'\033[0;31m'
+  C_CYAN=$'\033[0;36m'
+  C_BOLD=$'\033[1m'
+  C_DIM=$'\033[2m'
+  C_RESET=$'\033[0m'
+else
+  C_GREEN=''; C_YELLOW=''; C_RED=''; C_CYAN=''; C_BOLD=''; C_DIM=''; C_RESET=''
+fi
+
+ok()     { printf "${C_GREEN}[OK]${C_RESET}  %s\n" "$*"; }
+warn()   { printf "${C_YELLOW}[!!]${C_RESET}  %s\n" "$*"; }
+err()    { printf "${C_RED}[ERR]${C_RESET} %s\n" "$*" >&2; }
+header() { printf "\n${C_BOLD}%s${C_RESET}\n" "$*"; }
+dim()    { printf "${C_DIM}%s${C_RESET}\n" "$*"; }
+
+# ---------------------------------------------------------------------------
+# Box drawing -- pure ASCII, fixed 52-char wide
+#   box_top / box_mid / box_bot  -- structural lines
+#   box_row <text>               -- content row, right-padded to fit
+# ---------------------------------------------------------------------------
+BOX_INNER=48   # chars between the two | walls
+
+box_top() { printf "  +"; printf '%0.s-' $(seq 1 $BOX_INNER); printf "+\n"; }
+box_bot() { box_top; }
+box_sep() { printf "  |"; printf '%0.s-' $(seq 1 $BOX_INNER); printf "|\n"; }
+box_row() {
+  # Strip ANSI escapes when measuring visible length
+  local raw="$1"
+  local visible
+  visible="$(printf '%s' "$raw" | sed 's/\x1b\[[0-9;]*m//g')"
+  local pad=$(( BOX_INNER - 2 - ${#visible} ))
+  if (( pad < 0 )); then pad=0; fi
+  printf "  | %s%*s |\n" "$raw" "$pad" ''
+}
+box_blank() { printf "  |%*s|\n" $BOX_INNER ''; }
+
+# ---------------------------------------------------------------------------
+# Paths
+# ---------------------------------------------------------------------------
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+INTEGRATIONS="$REPO_ROOT/integrations"
+
+ALL_TOOLS=(claude-code antigravity gemini-cli opencode cursor aider windsurf)
+
+# ---------------------------------------------------------------------------
+# Usage
+# ---------------------------------------------------------------------------
+usage() {
+  sed -n '3,28p' "$0" | sed 's/^# \{0,1\}//'
+  exit 0
+}
+
+# ---------------------------------------------------------------------------
+# Preflight
+# ---------------------------------------------------------------------------
+check_integrations() {
+  if [[ ! -d "$INTEGRATIONS" ]]; then
+    err "integrations/ not found. Run ./scripts/convert.sh first."
+    exit 1
+  fi
+}
+
+# ---------------------------------------------------------------------------
+# Tool detection
+# ---------------------------------------------------------------------------
+detect_claude_code() { [[ -d "${HOME}/.claude" ]]; }
+detect_antigravity()  { [[ -d "${HOME}/.gemini/antigravity/skills" ]]; }
+detect_gemini_cli()   { command -v gemini >/dev/null 2>&1 || [[ -d "${HOME}/.gemini" ]]; }
+detect_cursor()       { command -v cursor >/dev/null 2>&1 || [[ -d "${HOME}/.cursor" ]]; }
+detect_opencode()     { command -v opencode >/dev/null 2>&1 || [[ -d "${HOME}/.config/opencode" ]]; }
+detect_aider()        { command -v aider >/dev/null 2>&1; }
+detect_windsurf()     { command -v windsurf >/dev/null 2>&1 || [[ -d "${HOME}/.codeium" ]]; }
+
+is_detected() {
+  case "$1" in
+    claude-code) detect_claude_code ;;
+    antigravity) detect_antigravity ;;
+    gemini-cli)  detect_gemini_cli  ;;
+    opencode)    detect_opencode    ;;
+    cursor)      detect_cursor      ;;
+    aider)       detect_aider       ;;
+    windsurf)    detect_windsurf    ;;
+    *)           return 1 ;;
+  esac
+}
+
+# Fixed-width labels: name (14) + detail (24) = 38 visible chars
+tool_label() {
+  case "$1" in
+    claude-code) printf "%-14s  %s" "Claude Code"  "(claude.ai/code)"        ;;
+    antigravity) printf "%-14s  %s" "Antigravity"  "(~/.gemini/antigravity)" ;;
+    gemini-cli)  printf "%-14s  %s" "Gemini CLI"   "(gemini extension)"      ;;
+    opencode)    printf "%-14s  %s" "OpenCode"     "(opencode.ai)"           ;;
+    cursor)      printf "%-14s  %s" "Cursor"       "(.cursor/rules)"         ;;
+    aider)       printf "%-14s  %s" "Aider"        "(CONVENTIONS.md)"        ;;
+    windsurf)    printf "%-14s  %s" "Windsurf"     "(.windsurfrules)"        ;;
+  esac
+}
+
+# ---------------------------------------------------------------------------
+# Interactive selector
+# ---------------------------------------------------------------------------
+interactive_select() {
+  # bash 3-compatible arrays
+  declare -a selected=()
+  declare -a detected_map=()
+
+  local t
+  for t in "${ALL_TOOLS[@]}"; do
+    if is_detected "$t" 2>/dev/null; then
+      selected+=(1); detected_map+=(1)
+    else
+      selected+=(0); detected_map+=(0)
+    fi
+  done
+
+  while true; do
+    # --- header ---
+    printf "\n"
+    box_top
+    box_row "${C_BOLD}  The Agency -- Tool Installer${C_RESET}"
+    box_bot
+    printf "\n"
+    printf "  ${C_DIM}System scan:  [*] = detected on this machine${C_RESET}\n"
+    printf "\n"
+
+    # --- tool rows ---
+    local i=0
+    for t in "${ALL_TOOLS[@]}"; do
+      local num=$(( i + 1 ))
+      local label
+      label="$(tool_label "$t")"
+      local dot
+      if [[ "${detected_map[$i]}" == "1" ]]; then
+        dot="${C_GREEN}[*]${C_RESET}"
+      else
+        dot="${C_DIM}[ ]${C_RESET}"
+      fi
+      local chk
+      if [[ "${selected[$i]}" == "1" ]]; then
+        chk="${C_GREEN}[x]${C_RESET}"
+      else
+        chk="${C_DIM}[ ]${C_RESET}"
+      fi
+      printf "  %s  %s)  %s  %s\n" "$chk" "$num" "$dot" "$label"
+      (( i++ )) || true
+    done
+
+    # --- controls ---
+    printf "\n"
+    printf "  ------------------------------------------------\n"
+    printf "  ${C_CYAN}[1-7]${C_RESET} toggle   ${C_CYAN}[a]${C_RESET} all   ${C_CYAN}[n]${C_RESET} none   ${C_CYAN}[d]${C_RESET} detected\n"
+    printf "  ${C_GREEN}[Enter]${C_RESET} install   ${C_RED}[q]${C_RESET} quit\n"
+    printf "\n"
+    printf "  >> "
+    read -r input </dev/tty
+
+    case "$input" in
+      q|Q)
+        printf "\n"; ok "Aborted."; exit 0 ;;
+      a|A)
+        for (( j=0; j<${#ALL_TOOLS[@]}; j++ )); do selected[$j]=1; done ;;
+      n|N)
+        for (( j=0; j<${#ALL_TOOLS[@]}; j++ )); do selected[$j]=0; done ;;
+      d|D)
+        for (( j=0; j<${#ALL_TOOLS[@]}; j++ )); do selected[$j]="${detected_map[$j]}"; done ;;
+      "")
+        local any=false
+        local s
+        for s in "${selected[@]}"; do [[ "$s" == "1" ]] && any=true && break; done
+        if $any; then
+          break
+        else
+          printf "  ${C_YELLOW}Nothing selected -- pick a tool or press q to quit.${C_RESET}\n"
+          sleep 1
+        fi ;;
+      *)
+        local toggled=false
+        local num
+        for num in $input; do
+          if [[ "$num" =~ ^[0-9]+$ ]]; then
+            local idx=$(( num - 1 ))
+            if (( idx >= 0 && idx < ${#ALL_TOOLS[@]} )); then
+              if [[ "${selected[$idx]}" == "1" ]]; then
+                selected[$idx]=0
+              else
+                selected[$idx]=1
+              fi
+              toggled=true
+            fi
+          fi
+        done
+        if ! $toggled; then
+          printf "  ${C_RED}Invalid. Enter a number 1-%s, or a command.${C_RESET}\n" "${#ALL_TOOLS[@]}"
+          sleep 1
+        fi ;;
+    esac
+
+    # Clear UI for redraw
+    local lines=$(( ${#ALL_TOOLS[@]} + 14 ))
+    local l
+    for (( l=0; l<lines; l++ )); do printf '\033[1A\033[2K'; done
+  done
+
+  # Build output array
+  SELECTED_TOOLS=()
+  local i=0
+  for t in "${ALL_TOOLS[@]}"; do
+    [[ "${selected[$i]}" == "1" ]] && SELECTED_TOOLS+=("$t")
+    (( i++ )) || true
+  done
+}
+
+# ---------------------------------------------------------------------------
+# Installers
+# ---------------------------------------------------------------------------
+
+install_claude_code() {
+  local dest="${HOME}/.claude/agents"
+  local count=0
+  mkdir -p "$dest"
+  local dir f first_line
+  for dir in design engineering marketing product project-management \
+              testing support spatial-computing specialized; do
+    [[ -d "$REPO_ROOT/$dir" ]] || continue
+    while IFS= read -r -d '' f; do
+      first_line="$(head -1 "$f")"
+      [[ "$first_line" == "---" ]] || continue
+      cp "$f" "$dest/"
+      (( count++ )) || true
+    done < <(find "$REPO_ROOT/$dir" -maxdepth 1 -name "*.md" -type f -print0)
+  done
+  ok "Claude Code: $count agents -> $dest"
+}
+
+install_antigravity() {
+  local src="$INTEGRATIONS/antigravity"
+  local dest="${HOME}/.gemini/antigravity/skills"
+  local count=0
+  [[ -d "$src" ]] || { err "integrations/antigravity missing. Run convert.sh first."; return 1; }
+  mkdir -p "$dest"
+  local d
+  while IFS= read -r -d '' d; do
+    local name; name="$(basename "$d")"
+    mkdir -p "$dest/$name"
+    cp "$d/SKILL.md" "$dest/$name/SKILL.md"
+    (( count++ )) || true
+  done < <(find "$src" -mindepth 1 -maxdepth 1 -type d -print0)
+  ok "Antigravity: $count skills -> $dest"
+}
+
+install_gemini_cli() {
+  local src="$INTEGRATIONS/gemini-cli"
+  local dest="${HOME}/.gemini/extensions/agency-agents"
+  local count=0
+  [[ -d "$src" ]] || { err "integrations/gemini-cli missing. Run convert.sh first."; return 1; }
+  mkdir -p "$dest/skills"
+  cp "$src/gemini-extension.json" "$dest/gemini-extension.json"
+  local d
+  while IFS= read -r -d '' d; do
+    local name; name="$(basename "$d")"
+    mkdir -p "$dest/skills/$name"
+    cp "$d/SKILL.md" "$dest/skills/$name/SKILL.md"
+    (( count++ )) || true
+  done < <(find "$src/skills" -mindepth 1 -maxdepth 1 -type d -print0)
+  ok "Gemini CLI: $count skills -> $dest"
+}
+
+install_opencode() {
+  local src="$INTEGRATIONS/opencode/agent"
+  local dest="${PWD}/.opencode/agent"
+  local count=0
+  [[ -d "$src" ]] || { err "integrations/opencode missing. Run convert.sh first."; return 1; }
+  mkdir -p "$dest"
+  local f
+  while IFS= read -r -d '' f; do
+    cp "$f" "$dest/"; (( count++ )) || true
+  done < <(find "$src" -maxdepth 1 -name "*.md" -print0)
+  ok "OpenCode: $count agents -> $dest"
+  warn "OpenCode: project-scoped. Run from your project root to install there."
+}
+
+install_cursor() {
+  local src="$INTEGRATIONS/cursor/rules"
+  local dest="${PWD}/.cursor/rules"
+  local count=0
+  [[ -d "$src" ]] || { err "integrations/cursor missing. Run convert.sh first."; return 1; }
+  mkdir -p "$dest"
+  local f
+  while IFS= read -r -d '' f; do
+    cp "$f" "$dest/"; (( count++ )) || true
+  done < <(find "$src" -maxdepth 1 -name "*.mdc" -print0)
+  ok "Cursor: $count rules -> $dest"
+  warn "Cursor: project-scoped. Run from your project root to install there."
+}
+
+install_aider() {
+  local src="$INTEGRATIONS/aider/CONVENTIONS.md"
+  local dest="${PWD}/CONVENTIONS.md"
+  [[ -f "$src" ]] || { err "integrations/aider/CONVENTIONS.md missing. Run convert.sh first."; return 1; }
+  if [[ -f "$dest" ]]; then
+    warn "Aider: CONVENTIONS.md already exists at $dest (remove to reinstall)."
+    return 0
+  fi
+  cp "$src" "$dest"
+  ok "Aider: installed -> $dest"
+  warn "Aider: project-scoped. Run from your project root to install there."
+}
+
+install_windsurf() {
+  local src="$INTEGRATIONS/windsurf/.windsurfrules"
+  local dest="${PWD}/.windsurfrules"
+  [[ -f "$src" ]] || { err "integrations/windsurf/.windsurfrules missing. Run convert.sh first."; return 1; }
+  if [[ -f "$dest" ]]; then
+    warn "Windsurf: .windsurfrules already exists at $dest (remove to reinstall)."
+    return 0
+  fi
+  cp "$src" "$dest"
+  ok "Windsurf: installed -> $dest"
+  warn "Windsurf: project-scoped. Run from your project root to install there."
+}
+
+install_tool() {
+  case "$1" in
+    claude-code) install_claude_code ;;
+    antigravity) install_antigravity ;;
+    gemini-cli)  install_gemini_cli  ;;
+    opencode)    install_opencode    ;;
+    cursor)      install_cursor      ;;
+    aider)       install_aider       ;;
+    windsurf)    install_windsurf    ;;
+  esac
+}
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+main() {
+  local tool="all"
+  local interactive_mode="auto"
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --tool)            tool="${2:?'--tool requires a value'}"; shift 2; interactive_mode="no" ;;
+      --interactive)     interactive_mode="yes"; shift ;;
+      --no-interactive)  interactive_mode="no"; shift ;;
+      --help|-h)         usage ;;
+      *)                 err "Unknown option: $1"; usage ;;
+    esac
+  done
+
+  check_integrations
+
+  # Validate explicit tool
+  if [[ "$tool" != "all" ]]; then
+    local valid=false t
+    for t in "${ALL_TOOLS[@]}"; do [[ "$t" == "$tool" ]] && valid=true && break; done
+    if ! $valid; then
+      err "Unknown tool '$tool'. Valid: ${ALL_TOOLS[*]}"
+      exit 1
+    fi
+  fi
+
+  # Decide whether to show interactive UI
+  local use_interactive=false
+  if   [[ "$interactive_mode" == "yes" ]]; then
+    use_interactive=true
+  elif [[ "$interactive_mode" == "auto" && -t 0 && -t 1 && "$tool" == "all" ]]; then
+    use_interactive=true
+  fi
+
+  SELECTED_TOOLS=()
+
+  if $use_interactive; then
+    interactive_select
+
+  elif [[ "$tool" != "all" ]]; then
+    SELECTED_TOOLS=("$tool")
+
+  else
+    # Non-interactive: auto-detect
+    header "The Agency -- Scanning for installed tools..."
+    printf "\n"
+    local t
+    for t in "${ALL_TOOLS[@]}"; do
+      if is_detected "$t" 2>/dev/null; then
+        SELECTED_TOOLS+=("$t")
+        printf "  ${C_GREEN}[*]${C_RESET}  %s  ${C_DIM}detected${C_RESET}\n" "$(tool_label "$t")"
+      else
+        printf "  ${C_DIM}[ ]  %s  not found${C_RESET}\n" "$(tool_label "$t")"
+      fi
+    done
+  fi
+
+  if [[ ${#SELECTED_TOOLS[@]} -eq 0 ]]; then
+    warn "No tools selected or detected. Nothing to install."
+    printf "\n"
+    dim "  Tip: use --tool <name> to force-install a specific tool."
+    dim "  Available: ${ALL_TOOLS[*]}"
+    exit 0
+  fi
+
+  printf "\n"
+  header "The Agency -- Installing agents"
+  printf "  Repo:       %s\n" "$REPO_ROOT"
+  printf "  Installing: %s\n" "${SELECTED_TOOLS[*]}"
+  printf "\n"
+
+  local installed=0 t
+  for t in "${SELECTED_TOOLS[@]}"; do
+    install_tool "$t"
+    (( installed++ )) || true
+  done
+
+  # Done box
+  local msg="  Done!  Installed $installed tool(s)."
+  printf "\n"
+  box_top
+  box_row "${C_GREEN}${C_BOLD}${msg}${C_RESET}"
+  box_bot
+  printf "\n"
+  dim "  Run ./scripts/convert.sh to regenerate after adding or editing agents."
+  printf "\n"
+}
+
+main "$@"

package/extensions/agency-agents/agents/scripts/lint-agents.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+#
+# Validates agent markdown files:
+#   1. YAML frontmatter must exist with name, description, color (ERROR)
+#   2. Recommended sections checked but only warned (WARN)
+#   3. File must have meaningful content
+#
+# Usage: ./scripts/lint-agents.sh [file ...]
+#   If no files given, scans all agent directories.
+
+set -euo pipefail
+
+AGENT_DIRS=(
+  design
+  engineering
+  marketing
+  product
+  project-management
+  testing
+  support
+  spatial-computing
+  specialized
+  strategy
+)
+
+REQUIRED_FRONTMATTER=("name" "description" "color")
+RECOMMENDED_SECTIONS=("Identity" "Core Mission" "Critical Rules")
+
+errors=0
+warnings=0
+
+lint_file() {
+  local file="$1"
+
+  # 1. Check frontmatter delimiters
+  local first_line
+  first_line=$(head -1 "$file")
+  if [[ "$first_line" != "---" ]]; then
+    echo "ERROR $file: missing frontmatter opening ---"
+    errors=$((errors + 1))
+    return
+  fi
+
+  # Extract frontmatter (between first and second ---)
+  local frontmatter
+  frontmatter=$(awk 'NR==1{next} /^---$/{exit} {print}' "$file")
+
+  if [[ -z "$frontmatter" ]]; then
+    echo "ERROR $file: empty or malformed frontmatter"
+    errors=$((errors + 1))
+    return
+  fi
+
+  # 2. Check required frontmatter fields
+  for field in "${REQUIRED_FRONTMATTER[@]}"; do
+    if ! echo "$frontmatter" | grep -qE "^${field}:"; then
+      echo "ERROR $file: missing frontmatter field '${field}'"
+      errors=$((errors + 1))
+    fi
+  done
+
+  # 3. Check recommended sections (warn only)
+  local body
+  body=$(awk 'BEGIN{n=0} /^---$/{n++; next} n>=2{print}' "$file")
+
+  for section in "${RECOMMENDED_SECTIONS[@]}"; do
+    if ! echo "$body" | grep -qi "$section"; then
+      echo "WARN  $file: missing recommended section '${section}'"
+      warnings=$((warnings + 1))
+    fi
+  done
+
+  # 4. Check file has meaningful content
+  if [[ $(echo "$body" | wc -w) -lt 50 ]]; then
+    echo "WARN  $file: body seems very short (< 50 words)"
+    warnings=$((warnings + 1))
+  fi
+}
+
+# Collect files to lint
+files=()
+if [[ $# -gt 0 ]]; then
+  files=("$@")
+else
+  for dir in "${AGENT_DIRS[@]}"; do
+    if [[ -d "$dir" ]]; then
+      while IFS= read -r f; do
+        files+=("$f")
+      done < <(find "$dir" -maxdepth 1 -name "*.md" -type f | sort)
+    fi
+  done
+fi
+
+if [[ ${#files[@]} -eq 0 ]]; then
+  echo "No agent files found."
+  exit 1
+fi
+
+echo "Linting ${#files[@]} agent files..."
+echo ""
+
+for file in "${files[@]}"; do
+  lint_file "$file"
+done
+
+echo ""
+echo "Results: ${errors} error(s), ${warnings} warning(s) in ${#files[@]} files."
+
+if [[ $errors -gt 0 ]]; then
+  echo "FAILED: fix the errors above before merging."
+  exit 1
+else
+  echo "PASSED"
+  exit 0
+fi