@atercates/claude-deck 0.2.1

package/scripts/lib/prerequisites.sh

@@ -0,0 +1,462 @@
+#!/usr/bin/env bash
+# Prerequisite installation for claude-deck
+
+# Attempt to source common Node.js version managers
+# This ensures we detect Node even if it's not in the current PATH
+source_node_managers() {
+    # nvm
+    if [[ -s "$HOME/.nvm/nvm.sh" ]]; then
+        source "$HOME/.nvm/nvm.sh" 2>/dev/null || true
+    fi
+
+    # fnm
+    if [[ -d "$HOME/.local/share/fnm" ]]; then
+        export PATH="$HOME/.local/share/fnm:$PATH"
+        eval "$(fnm env --use-on-cd 2>/dev/null || true)"
+    fi
+
+    # asdf
+    if [[ -f "$HOME/.asdf/asdf.sh" ]]; then
+        source "$HOME/.asdf/asdf.sh" 2>/dev/null || true
+    fi
+
+    # volta
+    if [[ -d "$HOME/.volta" ]]; then
+        export VOLTA_HOME="$HOME/.volta"
+        export PATH="$VOLTA_HOME/bin:$PATH"
+    fi
+
+    # Homebrew (if not already in PATH)
+    if [[ "$OS" == "macos" ]]; then
+        if [[ -f /opt/homebrew/bin/brew ]]; then
+            eval "$(/opt/homebrew/bin/brew shellenv 2>/dev/null || true)"
+        elif [[ -f /usr/local/bin/brew ]]; then
+            eval "$(/usr/local/bin/brew shellenv 2>/dev/null || true)"
+        fi
+    fi
+
+    # ~/.local/bin (common for user-installed binaries)
+    if [[ -d "$HOME/.local/bin" ]]; then
+        export PATH="$HOME/.local/bin:$PATH"
+    fi
+}
+
+# Check if Node.js is available (trying multiple sources)
+check_node() {
+    # Try direct command first
+    if command -v node &> /dev/null; then
+        local version
+        version=$(node -v | sed 's/v//' | cut -d. -f1)
+        if [[ "$version" -ge 20 ]]; then
+            local node_path=$(command -v node)
+            log_success "Found Node.js v$(node -v | sed 's/v//') at $node_path"
+            return 0
+        fi
+    fi
+
+    # Source version managers and try again
+    source_node_managers
+
+    if command -v node &> /dev/null; then
+        local version
+        version=$(node -v | sed 's/v//' | cut -d. -f1)
+        if [[ "$version" -ge 20 ]]; then
+            local node_path=$(command -v node)
+            local manager=""
+
+            # Detect which manager provided it
+            if [[ "$node_path" == *"nvm"* ]]; then
+                manager=" (via nvm)"
+            elif [[ "$node_path" == *"fnm"* ]]; then
+                manager=" (via fnm)"
+            elif [[ "$node_path" == *"asdf"* ]]; then
+                manager=" (via asdf)"
+            elif [[ "$node_path" == *"volta"* ]]; then
+                manager=" (via volta)"
+            elif [[ "$node_path" == *"homebrew"* ]] || [[ "$node_path" == "/opt/homebrew"* ]] || [[ "$node_path" == "/usr/local"* ]]; then
+                manager=" (via Homebrew)"
+            fi
+
+            log_success "Found Node.js v$(node -v | sed 's/v//')$manager at $node_path"
+            return 0
+        fi
+    fi
+
+    return 1
+}
+
+# Check if ripgrep is available
+check_ripgrep() {
+    if command -v rg &> /dev/null; then
+        local rg_path=$(command -v rg)
+        local rg_version=$(rg --version 2>/dev/null | head -n1 | awk '{print $2}' || echo "unknown")
+        log_success "Found ripgrep $rg_version at $rg_path"
+        return 0
+    fi
+
+    # Source common paths
+    source_node_managers
+
+    if command -v rg &> /dev/null; then
+        local rg_path=$(command -v rg)
+        local rg_version=$(rg --version 2>/dev/null | head -n1 | awk '{print $2}' || echo "unknown")
+        log_success "Found ripgrep $rg_version at $rg_path"
+        return 0
+    fi
+
+    return 1
+}
+
+# Check if git is available
+check_git() {
+    if command -v git &> /dev/null; then
+        local git_path=$(command -v git)
+        local git_version=$(git --version 2>/dev/null | awk '{print $3}' || echo "unknown")
+        log_success "Found git $git_version at $git_path"
+        return 0
+    fi
+
+    # Check common locations
+    for git_path in /usr/bin/git /usr/local/bin/git /opt/homebrew/bin/git; do
+        if [[ -x "$git_path" ]]; then
+            export PATH="$(dirname "$git_path"):$PATH"
+            local git_version=$(git --version 2>/dev/null | awk '{print $3}' || echo "unknown")
+            log_success "Found git $git_version at $git_path"
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+# Check if tmux is available
+check_tmux() {
+    if command -v tmux &> /dev/null; then
+        local tmux_path=$(command -v tmux)
+        local tmux_version=$(tmux -V 2>/dev/null | awk '{print $2}' || echo "unknown")
+        log_success "Found tmux $tmux_version at $tmux_path"
+        return 0
+    fi
+
+    # Source common paths and check again
+    source_node_managers
+
+    if command -v tmux &> /dev/null; then
+        local tmux_path=$(command -v tmux)
+        local tmux_version=$(tmux -V 2>/dev/null | awk '{print $2}' || echo "unknown")
+        log_success "Found tmux $tmux_version at $tmux_path"
+        return 0
+    fi
+
+    return 1
+}
+
+install_homebrew() {
+    if command -v brew &> /dev/null; then
+        return 0
+    fi
+
+    log_info "Installing Homebrew..."
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
+    # Add to path for current session
+    if [[ -f /opt/homebrew/bin/brew ]]; then
+        eval "$(/opt/homebrew/bin/brew shellenv)"
+    elif [[ -f /usr/local/bin/brew ]]; then
+        eval "$(/usr/local/bin/brew shellenv)"
+    fi
+
+    # Add to shell profile so it's available in future sessions
+    local shell_profile=""
+    if [[ -n "$ZSH_VERSION" ]] && [[ -f "$HOME/.zshrc" ]]; then
+        shell_profile="$HOME/.zshrc"
+    elif [[ -n "$BASH_VERSION" ]] && [[ -f "$HOME/.bashrc" ]]; then
+        shell_profile="$HOME/.bashrc"
+    elif [[ -f "$HOME/.bash_profile" ]]; then
+        shell_profile="$HOME/.bash_profile"
+    fi
+
+    if [[ -n "$shell_profile" ]]; then
+        if ! grep -q "brew shellenv" "$shell_profile"; then
+            echo '' >> "$shell_profile"
+            echo '# Homebrew' >> "$shell_profile"
+            if [[ -f /opt/homebrew/bin/brew ]]; then
+                echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> "$shell_profile"
+            elif [[ -f /usr/local/bin/brew ]]; then
+                echo 'eval "$(/usr/local/bin/brew shellenv)"' >> "$shell_profile"
+            fi
+        fi
+    fi
+}
+
+install_node() {
+    if command -v node &> /dev/null; then
+        local version
+        version=$(node -v | sed 's/v//' | cut -d. -f1)
+        if [[ "$version" -ge 20 ]]; then
+            return 0
+        fi
+        log_warn "Node.js $version found, but 20+ required"
+    fi
+
+    log_info "Installing Node.js..."
+
+    case "$OS" in
+        macos)
+            # Check if user is admin - if not, use fnm (user-space install)
+            if ! groups | grep -q admin; then
+                log_info "Non-admin user detected - using fnm (Fast Node Manager)"
+                log_info "This installs Node.js to your home directory (no sudo needed)"
+
+                # Install fnm
+                curl -fsSL https://fnm.vercel.app/install | bash -s -- --skip-shell
+
+                # Add fnm to path for current session
+                export PATH="$HOME/.local/share/fnm:$PATH"
+                eval "$(fnm env --use-on-cd)"
+
+                # Install and use Node.js 20
+                fnm install 20
+                fnm use 20
+
+                # Add fnm to shell profile
+                local shell_profile=""
+                if [[ -f "$HOME/.zshrc" ]]; then
+                    shell_profile="$HOME/.zshrc"
+                elif [[ -f "$HOME/.bashrc" ]]; then
+                    shell_profile="$HOME/.bashrc"
+                elif [[ -f "$HOME/.bash_profile" ]]; then
+                    shell_profile="$HOME/.bash_profile"
+                fi
+
+                if [[ -n "$shell_profile" ]]; then
+                    if ! grep -q "fnm env" "$shell_profile"; then
+                        echo '' >> "$shell_profile"
+                        echo '# fnm (Fast Node Manager)' >> "$shell_profile"
+                        echo 'eval "$(fnm env --use-on-cd)"' >> "$shell_profile"
+                        log_info "Added fnm to $shell_profile"
+                    fi
+                fi
+            else
+                # Admin user - use Homebrew
+                install_homebrew
+                brew install node
+            fi
+            ;;
+        debian)
+            curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+            sudo apt-get install -y nodejs
+            ;;
+        redhat)
+            curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
+            sudo yum install -y nodejs
+            ;;
+        *)
+            log_error "Please install Node.js 20+ manually: https://nodejs.org"
+            exit 1
+            ;;
+    esac
+}
+
+install_git() {
+    if command -v git &> /dev/null; then
+        return 0
+    fi
+
+    log_info "Installing git..."
+
+    case "$OS" in
+        macos)
+            xcode-select --install 2>/dev/null || true
+            until command -v git &> /dev/null; do
+                sleep 5
+            done
+            ;;
+        debian)
+            sudo apt-get update
+            sudo apt-get install -y git
+            ;;
+        redhat)
+            sudo yum install -y git
+            ;;
+    esac
+}
+
+install_tmux() {
+    if command -v tmux &> /dev/null; then
+        return 0
+    fi
+
+    log_info "Installing tmux..."
+
+    case "$OS" in
+        macos)
+            # Check if user is admin
+            if ! groups | grep -q admin; then
+                log_error "tmux requires admin privileges to install via Homebrew."
+                log_error ""
+                log_error "Option 1: Ask your administrator to run: brew install tmux"
+                log_error "Option 2: Make yourself an admin:"
+                log_error "  - Open System Settings → Users & Groups"
+                log_error "  - Unlock and check 'Allow user to administer this computer'"
+                exit 1
+            else
+                install_homebrew
+                brew install tmux
+            fi
+            ;;
+        debian)
+            sudo apt-get update
+            sudo apt-get install -y tmux
+            ;;
+        redhat)
+            sudo yum install -y tmux
+            ;;
+    esac
+}
+
+install_ripgrep() {
+    if command -v rg &> /dev/null; then
+        return 0
+    fi
+
+    log_info "Installing ripgrep..."
+
+    case "$OS" in
+        macos)
+            # Check if user is admin
+            if ! groups | grep -q admin; then
+                # Non-admin: download pre-built binary from GitHub
+                log_info "Non-admin user - downloading pre-built ripgrep binary"
+
+                local arch
+                arch=$(uname -m)
+                local target
+                if [[ "$arch" == "arm64" ]]; then
+                    target="aarch64-apple-darwin"
+                else
+                    target="x86_64-apple-darwin"
+                fi
+
+                local version="14.1.0"
+                local url="https://github.com/BurntSushi/ripgrep/releases/download/${version}/ripgrep-${version}-${target}.tar.gz"
+                local tmp_dir="/tmp/ripgrep-install"
+
+                mkdir -p "$tmp_dir"
+                mkdir -p "$HOME/.local/bin"
+
+                curl -fsSL "$url" | tar -xz -C "$tmp_dir"
+                mv "$tmp_dir/ripgrep-${version}-${target}/rg" "$HOME/.local/bin/rg"
+                chmod +x "$HOME/.local/bin/rg"
+                rm -rf "$tmp_dir"
+
+                # Add to PATH if not already there
+                export PATH="$HOME/.local/bin:$PATH"
+
+                # Add to shell profile
+                local shell_profile=""
+                if [[ -f "$HOME/.zshrc" ]]; then
+                    shell_profile="$HOME/.zshrc"
+                elif [[ -f "$HOME/.bashrc" ]]; then
+                    shell_profile="$HOME/.bashrc"
+                elif [[ -f "$HOME/.bash_profile" ]]; then
+                    shell_profile="$HOME/.bash_profile"
+                fi
+
+                if [[ -n "$shell_profile" ]]; then
+                    if ! grep -q '.local/bin' "$shell_profile"; then
+                        echo '' >> "$shell_profile"
+                        echo '# Add local bin to PATH' >> "$shell_profile"
+                        echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$shell_profile"
+                    fi
+                fi
+
+                log_success "ripgrep installed to ~/.local/bin/rg"
+            else
+                # Admin user - use Homebrew
+                install_homebrew
+                brew install ripgrep
+            fi
+            ;;
+        debian)
+            sudo apt-get update
+            sudo apt-get install -y ripgrep
+            ;;
+        redhat)
+            sudo yum install -y ripgrep
+            ;;
+    esac
+}
+
+check_and_install_prerequisites() {
+    log_info "Checking prerequisites..."
+
+    local missing=()
+
+    # Check Node.js (with version manager detection)
+    if ! check_node; then
+        missing+=("node")
+    fi
+
+    # Check git (with path detection)
+    if ! check_git; then
+        missing+=("git")
+    fi
+
+    # Check tmux (with path detection)
+    if ! check_tmux; then
+        missing+=("tmux")
+    fi
+
+    # Check ripgrep (with path detection)
+    if ! check_ripgrep; then
+        missing+=("ripgrep")
+    fi
+
+    if [[ ${#missing[@]} -eq 0 ]]; then
+        log_success "All prerequisites met"
+        return 0
+    fi
+
+    log_warn "Missing prerequisites: ${missing[*]}"
+
+    if is_interactive; then
+        if ! prompt_yn "Install missing prerequisites?"; then
+            log_error "Please install manually: ${missing[*]}"
+            exit 1
+        fi
+    fi
+
+    for dep in "${missing[@]}"; do
+        case "$dep" in
+            node) install_node ;;
+            git) install_git ;;
+            tmux) install_tmux ;;
+            ripgrep) install_ripgrep ;;
+        esac
+    done
+
+    log_success "Prerequisites installed"
+
+    configure_tmux
+}
+
+configure_tmux() {
+    local tmux_conf="$HOME/.tmux.conf"
+    if [ ! -f "$tmux_conf" ] || ! grep -q "mouse on" "$tmux_conf" 2>/dev/null; then
+        log_info "Configuring tmux for ClaudeDeck..."
+        cat >> "$tmux_conf" << 'TMUX'
+
+# ClaudeDeck: enable mouse for scroll support in web terminal
+set -g mouse on
+set -g history-limit 50000
+set -g default-terminal "xterm-256color"
+set -ga terminal-overrides ",xterm-256color:Tc"
+TMUX
+        log_success "tmux configured (mouse on, 50k history)"
+    fi
+
+    if tmux list-sessions &>/dev/null; then
+        tmux set -g mouse on 2>/dev/null || true
+    fi
+}

package/scripts/setup.sh

@@ -0,0 +1,134 @@
+#!/bin/bash
+set -e
+
+echo "ClaudeDeck Setup"
+echo "=============="
+echo ""
+
+OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+
+# ── Node.js ──────────────────────────────────────────────
+if ! command -v node &> /dev/null; then
+    echo "Error: Node.js is not installed"
+    echo "Install Node.js 20+ from https://nodejs.org"
+    exit 1
+fi
+
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+if [ "$NODE_VERSION" -lt 20 ]; then
+    echo "Error: Node.js 20+ required (found v$NODE_VERSION)"
+    exit 1
+fi
+echo "✓ Node.js: $(node -v)"
+
+# ── pnpm ─────────────────────────────────────────────────
+if ! command -v pnpm &> /dev/null; then
+    echo "Installing pnpm..."
+    npm install -g pnpm
+fi
+echo "✓ pnpm: $(pnpm -v)"
+
+# ── Build tools (for native modules: node-pty, better-sqlite3) ──
+if [[ "$OS" == "linux" ]]; then
+    if ! dpkg -s build-essential &> /dev/null 2>&1; then
+        echo "Installing build tools..."
+        sudo apt-get update -qq
+        sudo apt-get install -y -qq build-essential python3
+    fi
+    echo "✓ Build tools: installed"
+elif [[ "$OS" == "darwin" ]]; then
+    if ! xcode-select -p &> /dev/null 2>&1; then
+        echo "Installing Xcode Command Line Tools..."
+        xcode-select --install
+        echo "Re-run this script after installation completes."
+        exit 0
+    fi
+    echo "✓ Xcode CLT: installed"
+fi
+
+# ── tmux ─────────────────────────────────────────────────
+if ! command -v tmux &> /dev/null; then
+    echo "Installing tmux..."
+    if [[ "$OS" == "linux" ]]; then
+        sudo apt-get install -y -qq tmux
+    elif [[ "$OS" == "darwin" ]]; then
+        brew install tmux
+    else
+        echo "Error: Install tmux manually"
+        exit 1
+    fi
+fi
+echo "✓ tmux: $(tmux -V)"
+
+# ── tmux configuration ──────────────────────────────────
+TMUX_CONF="$HOME/.tmux.conf"
+if [ ! -f "$TMUX_CONF" ] || ! grep -q "mouse on" "$TMUX_CONF" 2>/dev/null; then
+    echo "Configuring tmux (mouse on for scroll support)..."
+    cat >> "$TMUX_CONF" << 'TMUX'
+
+# ClaudeDeck: enable mouse for scroll support in web terminal
+set -g mouse on
+set -g history-limit 50000
+set -g default-terminal "xterm-256color"
+set -ga terminal-overrides ",xterm-256color:Tc"
+TMUX
+fi
+echo "✓ tmux: mouse on configured"
+
+# ── git ──────────────────────────────────────────────────
+if ! command -v git &> /dev/null; then
+    echo "Error: git is not installed"
+    exit 1
+fi
+echo "✓ git: $(git --version | awk '{print $3}')"
+
+# ── ripgrep (for code search) ────────────────────────────
+if ! command -v rg &> /dev/null; then
+    echo "Installing ripgrep..."
+    if [[ "$OS" == "linux" ]]; then
+        sudo apt-get install -y -qq ripgrep
+    elif [[ "$OS" == "darwin" ]]; then
+        brew install ripgrep
+    fi
+fi
+if command -v rg &> /dev/null; then
+    echo "✓ ripgrep: $(rg --version | head -1 | awk '{print $2}')"
+else
+    echo "⚠ ripgrep: not found (code search will be disabled)"
+fi
+
+# ── Claude Code CLI ──────────────────────────────────────
+if ! command -v claude &> /dev/null; then
+    echo ""
+    echo "Claude Code CLI not found. Install with:"
+    echo "  npm install -g @anthropic-ai/claude-code"
+    echo ""
+    echo "⚠ ClaudeDeck requires at least one AI CLI to function."
+else
+    echo "✓ Claude CLI: installed"
+fi
+
+# ── Environment ──────────────────────────────────────────
+if [ ! -f .env ]; then
+    if [ -f .env.example ]; then
+        cp .env.example .env
+        echo "✓ Created .env from .env.example"
+    fi
+fi
+
+# ── Data directory ───────────────────────────────────────
+mkdir -p "$HOME/.claude-deck"
+echo "✓ Data dir: ~/.claude-deck/"
+
+# ── Install dependencies ────────────────────────────────
+echo ""
+echo "Installing dependencies..."
+pnpm install
+
+echo ""
+echo "✓ Setup complete!"
+echo ""
+echo "  Development:  pnpm dev"
+echo "  Production:   pnpm start"
+echo "  Port:         ${PORT:-3011}"
+echo ""