octo-agent 0.11.2

data/scripts/build/src/install_full.sh.cc

@@ -0,0 +1,290 @@
+#!/bin/bash
+# install_full.sh — OpenClacky full installer (macOS + Linux, with Homebrew)
+# Generated from scripts/build/src/install_full.sh.cc — DO NOT EDIT DIRECTLY
+
+set -e
+
+BRAND_NAME=""
+BRAND_COMMAND=""
+RESTORE_MIRRORS=false
+
+@include lib/colors.sh
+@include lib/os.sh
+@include lib/shell.sh
+@include lib/network.sh
+@include lib/brew.sh
+@include lib/mise.sh
+@include lib/gem.sh
+
+# --------------------------------------------------------------------------
+# CN mirror config — gem, npm (persisted to dotfiles)
+# --------------------------------------------------------------------------
+configure_cn_mirrors() {
+    [ "$USE_CN_MIRRORS" = true ] || return 0
+    print_step "Configuring CN mirrors (permanent)..."
+
+    # gem: ~/.gemrc
+    configure_gem_source
+
+    # npm: ~/.npmrc
+    local npmrc="$HOME/.npmrc"
+    if grep -q "${NPM_REGISTRY_URL}" "$npmrc" 2>/dev/null; then
+        print_success "npm registry already set → ${NPM_REGISTRY_URL}"
+    else
+        [ -f "$npmrc" ] && [ ! -f "$HOME/.npmrc_clackybak" ] && cp "$npmrc" "$HOME/.npmrc_clackybak"
+        if command_exists npm; then
+            npm config set registry "$NPM_REGISTRY_URL" 2>/dev/null && \
+                print_success "npm registry → ${NPM_REGISTRY_URL}"
+        else
+            echo "registry=${NPM_REGISTRY_URL}" >> "$npmrc"
+            print_success "npm registry → ${NPM_REGISTRY_URL} (pre-set)"
+        fi
+    fi
+
+    echo ""
+}
+
+restore_mirrors() {
+    print_step "Restoring original mirror settings..."
+
+    # gem
+    restore_gemrc
+
+    # npm
+    local npmrc="$HOME/.npmrc" npmrc_bak="$HOME/.npmrc_clackybak"
+    if [ -f "$npmrc_bak" ]; then
+        mv "$npmrc_bak" "$npmrc"; print_success "~/.npmrc restored from backup"
+    elif [ -f "$npmrc" ]; then
+        rm "$npmrc"; print_success "~/.npmrc removed"
+    else
+        print_info "~/.npmrc — nothing to restore"
+    fi
+
+    # mise node.mirror_url
+    local mise_bin=""
+    command_exists mise && mise_bin="mise"
+    [ -x "$HOME/.local/bin/mise" ] && mise_bin="$HOME/.local/bin/mise"
+    [ -n "$mise_bin" ] && "$mise_bin" settings unset node.mirror_url 2>/dev/null && \
+        print_success "mise node.mirror_url unset"
+
+    restore_homebrew_cn_mirrors
+
+    echo ""
+    print_success "Done. All mirror settings restored."
+    echo ""
+}
+
+# --------------------------------------------------------------------------
+# Ruby check
+# --------------------------------------------------------------------------
+check_ruby() {
+    command_exists ruby || return 1
+    local ver; ver=$(ruby -e 'puts RUBY_VERSION' 2>/dev/null)
+    version_ge "$ver" "3.1.0" && { print_success "Ruby $ver — OK (>= 3.1.0)"; return 0; }
+    print_warning "Ruby $ver too old (need >= 3.1.0)"; return 1
+}
+
+# --------------------------------------------------------------------------
+# macOS: Homebrew + build deps + Ruby via mise
+# --------------------------------------------------------------------------
+install_macos_dependencies() {
+    print_step "Installing macOS dependencies and Ruby..."
+    echo ""
+
+    configure_homebrew_cn_mirrors
+    ensure_homebrew || return 1
+
+    print_info "Installing build dependencies..."
+    brew install openssl@3 libyaml gmp || { print_error "Failed to install build deps"; return 1; }
+    print_success "Build dependencies installed"
+
+    ensure_mise   || return 1
+    install_ruby_via_mise || return 1
+    check_ruby    || { print_error "Ruby installation verification failed"; return 1; }
+}
+
+# --------------------------------------------------------------------------
+# Linux (Ubuntu/Debian): apt mirror + build deps + Ruby via mise
+# --------------------------------------------------------------------------
+install_ubuntu_dependencies() {
+    print_step "Installing Ubuntu dependencies and Ruby..."
+    echo ""
+
+    if [ "$USE_CN_MIRRORS" = true ]; then
+        print_info "Configuring apt mirror (Aliyun)..."
+        local codename="${VERSION_CODENAME:-jammy}"
+        local components="main restricted universe multiverse"
+        local arch; arch=$(dpkg --print-architecture 2>/dev/null || uname -m)
+        if [ "$arch" = "arm64" ] || [ "$arch" = "aarch64" ]; then
+            local mirror_base="https://mirrors.aliyun.com/ubuntu-ports/"
+        else
+            local mirror_base="https://mirrors.aliyun.com/ubuntu/"
+        fi
+        sudo tee /etc/apt/sources.list > /dev/null <<EOF
+deb ${mirror_base} ${codename} ${components}
+deb ${mirror_base} ${codename}-updates ${components}
+deb ${mirror_base} ${codename}-backports ${components}
+deb ${mirror_base} ${codename}-security ${components}
+EOF
+        print_success "Aliyun apt mirror configured"
+    fi
+
+    sudo apt update || { print_error "apt update failed"; return 1; }
+    sudo apt install -y build-essential libssl-dev libyaml-dev zlib1g-dev libgmp-dev git || \
+        { print_error "Build deps install failed"; return 1; }
+    print_success "Build dependencies installed"
+
+    # WSL: auto-trust Windows system32 to suppress mise warnings
+    export MISE_TRUSTED_CONFIG_PATHS="/mnt/c/Windows/system32"
+
+    ensure_mise   || return 1
+    install_ruby_via_mise || return 1
+    check_ruby    || { print_error "Ruby installation verification failed"; return 1; }
+}
+
+# --------------------------------------------------------------------------
+# gem install openclacky
+# --------------------------------------------------------------------------
+install_via_gem() {
+    print_step "Installing via RubyGems..."
+    command_exists gem  || { print_error "RubyGems not available"; return 1; }
+    command_exists ruby || { print_error "Ruby not available"; return 1; }
+
+    local ver; ver=$(ruby -e 'puts RUBY_VERSION' 2>/dev/null)
+    version_ge "$ver" "3.1.0" || { print_error "Ruby $ver too old (>= 3.1.0 required)"; return 1; }
+
+    print_info "Installing ${DISPLAY_NAME}..."
+    if gem install openclacky --no-document; then
+        print_success "${DISPLAY_NAME} installed!"
+        install_chrome_devtools_mcp
+        return 0
+    else
+        print_error "gem install failed"; return 1
+    fi
+}
+
+# --------------------------------------------------------------------------
+# Optional: chrome-devtools-mcp (browser automation)
+# --------------------------------------------------------------------------
+install_chrome_devtools_mcp() {
+    print_step "Installing chrome-devtools-mcp..."
+
+    if ! command_exists npm; then
+        local mise_bin=""
+        command_exists mise && mise_bin="mise"
+        [ -x "$HOME/.local/bin/mise" ] && mise_bin="$HOME/.local/bin/mise"
+        if [ -n "$mise_bin" ]; then
+            "$mise_bin" install node@22 >/dev/null 2>&1 || true
+            "$mise_bin" use -g node@22  >/dev/null 2>&1 || true
+            eval "$($mise_bin activate bash 2>/dev/null)" 2>/dev/null || true
+        fi
+    fi
+
+    if ! command_exists npm; then
+        print_warning "npm not found — browser automation unavailable"
+        print_info "Install Node.js then run: npm install -g chrome-devtools-mcp"
+        return 0
+    fi
+
+    if npm install -g chrome-devtools-mcp >/dev/null 2>&1; then
+        print_success "chrome-devtools-mcp installed"
+    else
+        print_warning "chrome-devtools-mcp install failed"
+        print_info "Run manually: npm install -g chrome-devtools-mcp"
+    fi
+}
+
+# --------------------------------------------------------------------------
+# Parse args
+# --------------------------------------------------------------------------
+parse_args() {
+    for arg in "$0" "$@"; do
+        case "$arg" in
+            --brand-name=*)    BRAND_NAME="${arg#--brand-name=}"    ;;
+            --command=*)       BRAND_COMMAND="${arg#--command=}"     ;;
+            --restore-mirrors) RESTORE_MIRRORS=true                 ;;
+        esac
+    done
+    DISPLAY_NAME="${BRAND_NAME:-OpenClacky}"
+}
+
+# --------------------------------------------------------------------------
+# Brand setup
+# --------------------------------------------------------------------------
+setup_brand() {
+    [ -z "$BRAND_NAME" ] && return 0
+    local brand_file="$HOME/.clacky/brand.yml"
+    mkdir -p "$HOME/.clacky"
+    print_step "Configuring brand: $BRAND_NAME"
+    cat > "$brand_file" <<YAML
+product_name: "${BRAND_NAME}"
+package_name: "${BRAND_COMMAND}"
+YAML
+    print_success "Brand config written to $brand_file"
+
+    if [ -n "$BRAND_COMMAND" ]; then
+        local bin_dir="$HOME/.local/bin"
+        mkdir -p "$bin_dir"
+        local wrapper="$bin_dir/$BRAND_COMMAND"
+        cat > "$wrapper" <<WRAPPER
+#!/bin/sh
+exec openclacky "\$@"
+WRAPPER
+        chmod +x "$wrapper"
+        print_success "Wrapper installed: $wrapper"
+        case ":$PATH:" in
+            *":$bin_dir:"*) ;;
+            *) print_warning "Add to PATH: export PATH=\"\$HOME/.local/bin:\$PATH\"" ;;
+        esac
+    fi
+}
+
+# --------------------------------------------------------------------------
+# Post-install info
+# --------------------------------------------------------------------------
+show_post_install_info() {
+    local cmd="${BRAND_COMMAND:-openclacky}"
+    echo ""
+    echo -e "  ${GREEN}${DISPLAY_NAME} installed successfully!${NC}"
+    echo ""
+    echo "  Reload your shell:"
+    echo -e "    ${YELLOW}source ${SHELL_RC}${NC}"
+    echo ""
+    echo -e "  ${GREEN}Web UI${NC} (recommended):"
+    echo "    $cmd server  →  http://localhost:7070"
+    echo ""
+    echo -e "  ${GREEN}Terminal${NC}:"
+    echo "    $cmd"
+    echo ""
+}
+
+# --------------------------------------------------------------------------
+# Main
+# --------------------------------------------------------------------------
+main() {
+    parse_args "$@"
+
+    [ "$RESTORE_MIRRORS" = true ] && { restore_mirrors; exit 0; }
+
+    echo ""
+    echo "${DISPLAY_NAME} Installation"
+    echo ""
+
+    detect_os
+    detect_shell
+    detect_network_region
+    configure_cn_mirrors
+
+    assert_supported_os "Please install Ruby manually and run: gem install openclacky"
+
+    if [ "$OS" = "macOS" ]; then
+        install_macos_dependencies || { print_error "Failed to install dependencies"; exit 1; }
+    elif [ "$OS" = "Linux" ]; then
+        install_ubuntu_dependencies || { print_error "Failed to install dependencies"; exit 1; }
+    fi
+
+    install_via_gem && { setup_brand; show_post_install_info; exit 0; }
+    print_error "Failed to install ${DISPLAY_NAME}"; exit 1
+}
+
+main "$@"

data/scripts/build/src/install_rails_deps.sh.cc

@@ -0,0 +1,145 @@
+#!/bin/bash
+# install_rails_deps.sh — install Ruby 3.3+ and Node.js 22+ via mise, and PostgreSQL for Rails development
+# Generated from scripts/build/src/install_rails_deps.sh.cc — DO NOT EDIT DIRECTLY
+#
+# Usage:
+#   bash install_rails_deps.sh               # install ruby + node + postgres
+#   bash install_rails_deps.sh ruby          # ruby only
+#   bash install_rails_deps.sh node          # node only
+#   bash install_rails_deps.sh postgres      # postgres only
+
+set -e
+
+INSTALL_TARGET="${1:-all}"  # all | ruby | node | postgres
+
+@include lib/colors.sh
+@include lib/os.sh
+@include lib/shell.sh
+@include lib/network.sh
+@include lib/apt.sh
+@include lib/brew.sh
+@include lib/mise.sh
+@include lib/gem.sh
+
+# --------------------------------------------------------------------------
+# Ruby: install via mise and configure gem source
+# --------------------------------------------------------------------------
+install_ruby() {
+    print_step "Installing Ruby via mise..."
+
+    # Install Ruby compile-time dependencies first
+    if is_macos; then
+        brew install openssl@3 libyaml gmp
+    elif is_linux_apt; then
+        sudo apt-get install -y \
+            rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev
+    fi
+
+    ensure_mise || return 1
+    install_ruby_via_mise || return 1
+
+    # Configure gem source for CN users
+    configure_gem_source
+
+    # Reinstall openclacky in the new Ruby environment
+    "${MISE_BIN:-mise}" exec -- gem install openclacky --no-document \
+        && print_success "openclacky reinstalled" \
+        || print_warning "Could not reinstall openclacky — run manually: gem install openclacky --no-document"
+}
+
+# --------------------------------------------------------------------------
+# Node: install via mise and configure npm registry
+# --------------------------------------------------------------------------
+install_node() {
+    print_step "Installing Node.js via mise..."
+
+    ensure_mise || return 1
+    install_node_via_mise || return 1
+
+    if [ "$USE_CN_MIRRORS" = true ] && command_exists npm; then
+        npm config set registry "$NPM_REGISTRY_URL" 2>/dev/null || true
+        print_info "npm registry → ${NPM_REGISTRY_URL}"
+    fi
+}
+
+# --------------------------------------------------------------------------
+# PostgreSQL: install server + client via brew (macOS) or apt (Linux/WSL)
+# --------------------------------------------------------------------------
+install_postgres() {
+    print_step "Installing PostgreSQL..."
+
+    if is_macos; then
+        ensure_homebrew || return 1
+        brew install postgresql
+        brew services start postgresql
+
+    elif is_linux_apt; then
+        setup_apt_mirror
+        sudo apt-get install -y postgresql libpq-dev \
+            libssl-dev libreadline-dev zlib1g-dev libyaml-dev libffi-dev
+        sudo systemctl enable --now postgresql || true
+    fi
+
+    print_success "PostgreSQL installed"
+}
+
+# --------------------------------------------------------------------------
+# Main
+# --------------------------------------------------------------------------
+main() {
+    echo ""
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║                                                           ║"
+    echo "║   🔧 Rails Dependencies Installer                        ║"
+    echo "║                                                           ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    echo ""
+
+    detect_shell
+    detect_network_region
+
+    # On macOS, Homebrew is required — if missing, guide the user to install_full.sh
+    if is_macos && ! command_exists brew; then
+        local install_cmd
+        if [ "$USE_CN_MIRRORS" = true ]; then
+            install_cmd='/bin/bash -c "$(curl -sSL https://oss.1024code.com/scripts/install_full.sh)"'
+        else
+            install_cmd='/bin/bash -c "$(curl -sSL https://raw.githubusercontent.com/clacky-ai/openclacky/main/scripts/install_full.sh)"'
+        fi
+        echo ""
+        print_error "Homebrew is not installed — it is required to continue."
+        echo ""
+        echo "  Homebrew installation requires your sudo password and interactive confirmation"
+        echo "  — it cannot be run automatically by the AI agent."
+        echo ""
+        echo "  Please open a new terminal window and run the full installer:"
+        echo ""
+        echo "    ${install_cmd}"
+        echo ""
+        echo "  This will install Homebrew, Ruby, Node.js, and all required dependencies."
+        echo "  Once done, come back and try again."
+        echo ""
+        exit 1
+    fi
+
+    # Run system deps script if available
+    local sys_deps="$HOME/.clacky/scripts/install_system_deps.sh"
+    [ -f "$sys_deps" ] && { bash "$sys_deps" || print_warning "System deps install had warnings — continuing"; }
+
+    case "$INSTALL_TARGET" in
+        ruby)     install_ruby     || exit 1 ;;
+        node)     install_node     || exit 1 ;;
+        postgres) install_postgres || exit 1 ;;
+        *)
+            install_ruby     || exit 1
+            install_node     || exit 1
+            install_postgres || exit 1
+            ;;
+    esac
+
+    echo ""
+    print_success "Done. Please re-source your shell or open a new terminal if paths changed."
+    echo ""
+}
+
+main "$@"

data/scripts/build/src/install_system_deps.sh.cc

@@ -0,0 +1,123 @@
+#!/bin/bash
+# install_system_deps.sh — install system-level build tools
+# Generated from scripts/build/src/install_system_deps.sh.cc — DO NOT EDIT DIRECTLY
+#
+# macOS : Xcode Command Line Tools + Homebrew
+# Linux : build-essential + python3 + git + curl (apt, Ubuntu/Debian)
+
+set -e
+
+@include lib/colors.sh
+@include lib/os.sh
+@include lib/shell.sh
+@include lib/network.sh
+@include lib/apt.sh
+@include lib/brew.sh
+_clt_installed() {
+    [ -e "/Library/Developer/CommandLineTools/usr/bin/git" ]
+}
+
+ensure_xcode_clt() {
+    print_step "Checking Xcode Command Line Tools..."
+    _clt_installed && { print_success "Xcode CLT already installed"; return 0; }
+
+    print_info "Xcode CLT not found — attempting headless install via softwareupdate..."
+    local clt_placeholder="/tmp/.com.apple.dt.CommandLineTools.installondemand.in-progress"
+    touch "$clt_placeholder"
+
+    local clt_label
+    clt_label=$(softwareupdate -l 2>/dev/null \
+        | grep -B 1 -E 'Command Line Tools' \
+        | awk -F'*' '/^ *\*/ {print $2}' \
+        | sed -e 's/^ *Label: //' -e 's/^ *//' \
+        | sort -V | tail -n1)
+
+    local headless_ok=false
+    if [ -n "$clt_label" ]; then
+        print_info "Found package: $clt_label"
+        if softwareupdate -i "$clt_label" --agree-to-license 2>/dev/null; then
+            xcode-select --switch "/Library/Developer/CommandLineTools" 2>/dev/null || true
+            headless_ok=true
+        elif sudo -n softwareupdate -i "$clt_label" --agree-to-license 2>/dev/null; then
+            sudo xcode-select --switch "/Library/Developer/CommandLineTools" 2>/dev/null || true
+            headless_ok=true
+        fi
+    else
+        print_warning "softwareupdate could not find a CLT package"
+    fi
+
+    rm -f "$clt_placeholder"
+
+    if _clt_installed; then
+        print_success "Xcode CLT installed successfully"
+        return 0
+    fi
+
+    [ "$headless_ok" = false ] && print_warning "Headless install failed (sudo password required or package not found)"
+    print_error "Could not install Xcode CLT automatically."
+    echo ""
+    echo "  Please run this command and re-run this script:"
+    echo "    sudo xcode-select --install"
+    echo ""
+    return 1
+}
+
+ensure_linux_deps() {
+    print_step "Installing Linux build dependencies..."
+
+    detect_network_region
+    setup_apt_mirror
+    sudo apt-get install -y build-essential git curl python3
+    print_success "Dependencies installed"
+}
+
+# --------------------------------------------------------------------------
+# Verify key tools are present
+# --------------------------------------------------------------------------
+verify_deps() {
+    print_step "Verifying installed tools..."
+    local failed=false
+    for tool in python3 git curl make; do
+        if command_exists "$tool"; then
+            print_success "$tool  $(command -v "$tool")"
+        else
+            print_warning "$tool  not found"
+            failed=true
+        fi
+    done
+    [ "$failed" = true ] && print_warning "Some tools still missing. You may need to restart your shell."
+}
+
+# --------------------------------------------------------------------------
+# Main
+# --------------------------------------------------------------------------
+main() {
+    echo ""
+    echo "System Dependencies Setup"
+    echo "========================="
+
+    detect_os
+    print_info "OS: $OS"
+    [ "$OS" = "Linux" ] && print_info "Distro: $DISTRO"
+    echo ""
+
+    assert_supported_os
+
+    case "$OS" in
+        macOS)
+            detect_shell
+            ensure_xcode_clt  || exit 1
+            detect_network_region
+            configure_homebrew_cn_mirrors
+            ensure_homebrew   || exit 1
+            ;;
+        Linux) ensure_linux_deps || exit 1 ;;
+    esac
+
+    verify_deps
+    echo ""
+    print_success "Done. System dependencies are ready."
+    echo ""
+}
+
+main "$@"

data/scripts/build/src/uninstall.sh.cc

@@ -0,0 +1,101 @@
+#!/bin/bash
+# uninstall.sh — OpenClacky uninstaller
+# Generated from scripts/build/src/uninstall.sh.cc — DO NOT EDIT DIRECTLY
+
+set -e
+
+@include lib/colors.sh
+@include lib/os.sh
+@include lib/shell.sh
+@include lib/gem.sh
+
+# --------------------------------------------------------------------------
+# Load brand config
+# --------------------------------------------------------------------------
+BRAND_NAME=""
+BRAND_COMMAND=""
+DISPLAY_NAME="OpenClacky"
+
+load_brand() {
+    local brand_file="$HOME/.clacky/brand.yml"
+    [ -f "$brand_file" ] || return 0
+    BRAND_NAME=$(awk -F': ' '/^product_name:/{gsub(/^"|"$/, "", $2); gsub(/^ +| +$/, "", $2); print $2}' "$brand_file") || true
+    BRAND_COMMAND=$(awk -F': ' '/^package_name:/{gsub(/^"|"$/, "", $2); gsub(/^ +| +$/, "", $2); print $2}' "$brand_file") || true
+    [ -n "$BRAND_NAME" ] && DISPLAY_NAME="$BRAND_NAME"
+}
+
+check_installation() {
+    command_exists clacky || command_exists openclacky && return 0
+    [ -n "$BRAND_COMMAND" ] && command_exists "$BRAND_COMMAND" && return 0
+    return 1
+}
+
+uninstall_gem() {
+    command_exists gem || return 1
+    if gem list -i openclacky >/dev/null 2>&1; then
+        print_step "Uninstalling via RubyGems..."
+        gem uninstall openclacky -x
+    else
+        print_info "Gem 'openclacky' not found (already removed)"
+    fi
+}
+
+remove_brand() {
+    [ -z "$BRAND_COMMAND" ] && return 0
+    local clacky_bin dir
+    clacky_bin=$(command -v openclacky 2>/dev/null || true)
+    [ -z "$clacky_bin" ] && return 0
+    dir=$(dirname "$clacky_bin")
+    if [ -f "$dir/$BRAND_COMMAND" ]; then
+        rm -f "$dir/$BRAND_COMMAND"
+        print_success "Brand wrapper removed: $dir/$BRAND_COMMAND"
+    fi
+}
+
+remove_config() {
+    local config_dir="$HOME/.clacky"
+    [ -d "$config_dir" ] || return 0
+    print_warning "Configuration directory found: $config_dir"
+    read -r -p "Remove configuration files (including API keys)? [y/N] " reply
+    if [ "$reply" = "y" ] || [ "$reply" = "Y" ]; then
+        rm -rf "$config_dir"
+        print_success "Configuration removed"
+    else
+        print_info "Configuration preserved at: $config_dir"
+    fi
+}
+
+# --------------------------------------------------------------------------
+# Main
+# --------------------------------------------------------------------------
+main() {
+    load_brand
+    detect_shell
+
+    echo ""
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║                                                           ║"
+    echo -e "║   🗑️  ${DISPLAY_NAME} Uninstallation                     ║"
+    echo "║                                                           ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    echo ""
+
+    if ! check_installation; then
+        print_warning "${DISPLAY_NAME} does not appear to be installed"
+        echo ""; exit 0
+    fi
+
+    remove_brand
+    uninstall_gem || print_warning "gem command not found, skipping gem uninstall"
+    print_success "${DISPLAY_NAME} uninstalled successfully"
+    restore_gemrc
+    restore_gem_home
+    remove_config
+
+    echo ""
+    print_success "Uninstallation complete!"
+    print_info "Thank you for using ${DISPLAY_NAME} 👋"
+    echo ""
+}
+
+main