ralphblaster-agent 0.1.1

package/bin/monitor-agent.sh

@@ -0,0 +1,264 @@
+#!/bin/bash
+# Ralph Agent Monitoring Script
+# Ensures only one agent runs and provides visibility into its activity
+
+AGENT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+AGENT_SCRIPT="$AGENT_DIR/bin/ralphblaster.js"
+LOG_DIR="$HOME/.ralphblaster-logs"
+CURRENT_LOG="$LOG_DIR/agent-$(date +%Y%m%d).log"
+PID_FILE="$LOG_DIR/agent.pid"
+STATUS_FILE="$LOG_DIR/agent-status.json"
+
+# Create log directory
+mkdir -p "$LOG_DIR"
+
+# Function to check if agent is running
+check_agent() {
+    if [ -f "$PID_FILE" ]; then
+        local pid=$(cat "$PID_FILE")
+        if ps -p "$pid" > /dev/null 2>&1; then
+            # Check if it's actually our agent process
+            if ps -p "$pid" -o command= | grep -q "ralphblaster"; then
+                return 0  # Running
+            fi
+        fi
+        # Stale PID file
+        rm -f "$PID_FILE"
+    fi
+    return 1  # Not running
+}
+
+# Function to kill all agent processes
+kill_all_agents() {
+    echo "Searching for all Ralph agent processes..."
+    local pids=$(pgrep -f "ralphblaster.js")
+
+    if [ -z "$pids" ]; then
+        echo "No agent processes found"
+        return
+    fi
+
+    echo "Found agent processes: $pids"
+    for pid in $pids; do
+        echo "Killing process $pid..."
+        kill -TERM "$pid" 2>/dev/null
+        sleep 1
+        # Force kill if still running
+        if ps -p "$pid" > /dev/null 2>&1; then
+            echo "Force killing $pid..."
+            kill -KILL "$pid" 2>/dev/null
+        fi
+    done
+
+    rm -f "$PID_FILE"
+    echo "All agents stopped"
+}
+
+# Function to start agent
+start_agent() {
+    if check_agent; then
+        echo "❌ Agent already running (PID: $(cat "$PID_FILE"))"
+        echo "Use 'monitor-agent.sh restart' to restart it"
+        return 1
+    fi
+
+    echo "Starting Ralph agent..."
+    echo "Logs: $CURRENT_LOG"
+
+    # Start agent with output to log file
+    cd "$AGENT_DIR"
+    RALPH_LOG_LEVEL="${RALPH_LOG_LEVEL:-info}" node "$AGENT_SCRIPT" >> "$CURRENT_LOG" 2>&1 &
+    local pid=$!
+
+    echo $pid > "$PID_FILE"
+
+    # Wait a moment to ensure it started
+    sleep 2
+
+    if check_agent; then
+        echo "✅ Agent started successfully (PID: $pid)"
+        echo ""
+        echo "Monitor logs with:"
+        echo "  tail -f $CURRENT_LOG"
+        echo ""
+        echo "Check status with:"
+        echo "  $0 status"
+        return 0
+    else
+        echo "❌ Agent failed to start"
+        echo "Check logs: $CURRENT_LOG"
+        return 1
+    fi
+}
+
+# Function to stop agent
+stop_agent() {
+    if ! check_agent; then
+        echo "Agent not running"
+        # Clean up any zombie processes just in case
+        kill_all_agents
+        return 0
+    fi
+
+    local pid=$(cat "$PID_FILE")
+    echo "Stopping agent (PID: $pid)..."
+    kill -TERM "$pid" 2>/dev/null
+
+    # Wait for graceful shutdown
+    local timeout=10
+    while [ $timeout -gt 0 ]; do
+        if ! ps -p "$pid" > /dev/null 2>&1; then
+            rm -f "$PID_FILE"
+            echo "✅ Agent stopped"
+            return 0
+        fi
+        sleep 1
+        timeout=$((timeout - 1))
+    done
+
+    # Force kill if still running
+    echo "Force killing agent..."
+    kill -KILL "$pid" 2>/dev/null
+    rm -f "$PID_FILE"
+    echo "✅ Agent stopped (forced)"
+}
+
+# Function to show status
+show_status() {
+    echo "=== Ralph Agent Status ==="
+    echo ""
+
+    # Check main agent
+    if check_agent; then
+        local pid=$(cat "$PID_FILE")
+        echo "✅ Main agent: RUNNING (PID: $pid)"
+
+        # Get process info
+        echo ""
+        echo "Process details:"
+        ps -p "$pid" -o pid,state,start,time,command | tail -n +2
+
+        # Get API token info
+        if [ -f "$HOME/.ralphblasterrc" ]; then
+            echo ""
+            echo "API Token: configured in ~/.ralphblasterrc"
+        fi
+
+        # Show recent activity from logs
+        echo ""
+        echo "Recent activity (last 5 lines):"
+        if [ -f "$CURRENT_LOG" ]; then
+            tail -5 "$CURRENT_LOG" | sed 's/^/  /'
+        else
+            echo "  (no log file found)"
+        fi
+    else
+        echo "❌ Main agent: NOT RUNNING"
+    fi
+
+    echo ""
+    echo "=== All Ralph Agent Processes ==="
+    local all_pids=$(pgrep -f "ralphblaster.js")
+
+    if [ -z "$all_pids" ]; then
+        echo "No agent processes found"
+    else
+        echo "Found processes:"
+        for pid in $all_pids; do
+            echo ""
+            ps -p "$pid" -o pid,state,start,time,command | tail -n +2 | sed 's/^/  /'
+        done
+
+        # Warning if multiple agents
+        local count=$(echo "$all_pids" | wc -w)
+        if [ "$count" -gt 1 ]; then
+            echo ""
+            echo "⚠️  WARNING: Multiple agent processes detected!"
+            echo "This may cause jobs to be processed by different agents."
+            echo "Run '$0 restart' to ensure only one agent is running."
+        fi
+    fi
+
+    echo ""
+    echo "Logs directory: $LOG_DIR"
+    echo "Current log: $CURRENT_LOG"
+}
+
+# Function to tail logs
+tail_logs() {
+    if [ ! -f "$CURRENT_LOG" ]; then
+        echo "No log file found at: $CURRENT_LOG"
+        return 1
+    fi
+
+    echo "Tailing agent logs (Ctrl+C to stop)..."
+    echo "File: $CURRENT_LOG"
+    echo ""
+    tail -f "$CURRENT_LOG"
+}
+
+# Function to show recent logs
+show_logs() {
+    local lines="${1:-50}"
+
+    if [ ! -f "$CURRENT_LOG" ]; then
+        echo "No log file found at: $CURRENT_LOG"
+        return 1
+    fi
+
+    echo "Last $lines lines from agent log:"
+    echo "File: $CURRENT_LOG"
+    echo ""
+    tail -n "$lines" "$CURRENT_LOG"
+}
+
+# Main command handling
+case "${1:-status}" in
+    start)
+        start_agent
+        ;;
+    stop)
+        stop_agent
+        ;;
+    restart)
+        echo "Restarting agent..."
+        kill_all_agents  # Kill ALL agents, not just the tracked one
+        sleep 2
+        start_agent
+        ;;
+    status)
+        show_status
+        ;;
+    logs)
+        tail_logs
+        ;;
+    show-logs)
+        show_logs "${2:-50}"
+        ;;
+    kill-all)
+        kill_all_agents
+        ;;
+    *)
+        echo "Ralph Agent Monitor"
+        echo ""
+        echo "Usage: $0 [command]"
+        echo ""
+        echo "Commands:"
+        echo "  start       Start the agent (fails if already running)"
+        echo "  stop        Stop the agent gracefully"
+        echo "  restart     Kill all agents and start fresh"
+        echo "  status      Show agent status and recent activity"
+        echo "  logs        Tail agent logs in real-time"
+        echo "  show-logs   Show recent logs (default: 50 lines)"
+        echo "  kill-all    Kill all agent processes (use when stuck)"
+        echo ""
+        echo "Examples:"
+        echo "  $0 start                # Start the agent"
+        echo "  $0 status               # Check if agent is running"
+        echo "  $0 logs                 # Watch live logs"
+        echo "  $0 show-logs 100        # Show last 100 log lines"
+        echo "  $0 restart              # Fresh start (kills any zombies)"
+        echo ""
+        exit 1
+        ;;
+esac

package/bin/ralphblaster.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+
+// Parse command line arguments BEFORE loading modules that use config
+const args = process.argv.slice(2);
+
+// Check for --agents flag (multi-agent mode)
+const agentsIndex = args.findIndex(arg => arg.startsWith('--agents='));
+let agentCount = null;
+if (agentsIndex !== -1) {
+  agentCount = parseInt(args[agentsIndex].split('=')[1], 10);
+  // Get max agents from environment variable (default: 10)
+  const maxAgents = parseInt(process.env.RALPHBLASTER_MAX_AGENTS_PER_USER || process.env.RALPH_MAX_AGENTS_PER_USER || '10', 10);
+  if (isNaN(agentCount) || agentCount < 1 || agentCount > maxAgents) {
+    console.error(`Error: --agents flag requires a number between 1 and ${maxAgents}`);
+    process.exit(1);
+  }
+}
+
+// Check for --token flag
+const tokenIndex = args.findIndex(arg => arg.startsWith('--token='));
+if (tokenIndex !== -1) {
+  const token = args[tokenIndex].split('=')[1];
+  if (!token || token.trim() === '') {
+    console.error('Error: --token flag requires a value');
+    process.exit(1);
+  }
+  // Set both old and new variable names for backward compatibility
+  process.env.RALPHBLASTER_API_TOKEN = token;
+  process.env.RALPH_API_TOKEN = token;
+}
+
+// Check for --api-url flag
+const apiUrlIndex = args.findIndex(arg => arg.startsWith('--api-url='));
+if (apiUrlIndex !== -1) {
+  const apiUrl = args[apiUrlIndex].split('=')[1];
+  if (!apiUrl || apiUrl.trim() === '') {
+    console.error('Error: --api-url flag requires a value');
+    process.exit(1);
+  }
+  // Set both old and new variable names for backward compatibility
+  process.env.RALPHBLASTER_API_URL = apiUrl;
+  process.env.RALPH_API_URL = apiUrl;
+}
+
+// Show help
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+RalphBlaster Agent - Autonomous coding agent for RalphBlaster
+
+Usage:
+  ralphblaster [options]
+  ralphblaster init [options]
+  ralphblaster add-project
+
+Commands:
+  (default)             Start the agent in polling mode
+  init                  Save credentials to ~/.ralphblasterrc
+  add-project           Register current directory as a RalphBlaster project
+
+Options:
+  --agents=<count>      Run multiple agents concurrently (1-10, default: 1)
+  --token=<token>       API token for authentication
+  --api-url=<url>       API base URL (default: https://hq.ralphblaster.com)
+  --help, -h            Show this help message
+
+Getting Started:
+  1. Save your credentials:
+     ralphblaster init --token=fm6ibAG6vamdjtbG5snuD3F4
+
+  2. Register your project (run in project directory):
+     ralphblaster add-project
+
+  3. Start the agent:
+     ralphblaster
+
+Configuration:
+  Token is loaded from (in order of priority):
+  1. --token flag
+  2. RALPHBLASTER_API_TOKEN (or RALPH_API_TOKEN) environment variable
+  3. ~/.ralphblasterrc config file
+
+Environment Variables:
+  RALPHBLASTER_API_TOKEN       API token (RALPH_API_TOKEN also supported)
+  RALPHBLASTER_API_URL         API base URL (RALPH_API_URL also supported)
+  RALPHBLASTER_LOG_LEVEL       Log level: error, warn, info, debug (default: info)
+  RALPHBLASTER_MAX_AGENTS_PER_USER  Max concurrent agents (default: 10)
+  RALPHBLASTER_ALLOWED_PATHS   Colon-separated list of allowed base paths
+                               (optional security whitelist)
+  RALPHBLASTER_AGENT_ID        Agent identifier for multi-agent setups
+
+  Note: RALPH_* variables are supported for backward compatibility but deprecated.
+
+Examples:
+  # First time setup - save credentials
+  ralphblaster init --token=your_token_here --api-url=https://hq.ralphblaster.com
+
+  # Register project with API
+  cd /path/to/your/project
+  ralphblaster add-project
+
+  # Start single agent (uses token from ~/.ralphblasterrc)
+  ralphblaster
+
+  # Run 3 agents concurrently for parallel job processing
+  ralphblaster --agents=3
+
+  # Run with environment variable (if not using ~/.ralphblasterrc)
+  RALPHBLASTER_API_TOKEN=your_token_here ralphblaster
+
+  # Run with custom API URL
+  ralphblaster --api-url=http://localhost:3000
+
+  # Use with npm
+  npm start -- --agents=3
+  `);
+  process.exit(0);
+}
+
+// Check for version
+if (args.includes('--version') || args.includes('-v')) {
+  const packageJson = require('../package.json');
+  console.log(`ralphblaster v${packageJson.version}`);
+  process.exit(0);
+}
+
+// Check for init command
+if (args.includes('init')) {
+  const InitCommand = require('../src/commands/init');
+  const initCmd = new InitCommand();
+  initCmd.run().catch(error => {
+    // Error handling is done in InitCommand.handleError
+    // Just exit with error code
+  });
+  return; // Don't start agent polling loop
+}
+
+// Check for add-project command (alias for init)
+if (args.includes('add-project')) {
+  const AddProjectCommand = require('../src/commands/add-project');
+  const addProjectCmd = new AddProjectCommand();
+  addProjectCmd.run().catch(error => {
+    // Error handling is done in AddProjectCommand.handleError
+    // Just exit with error code
+  });
+  return; // Don't start agent polling loop
+}
+
+// Multi-agent mode: Launch multiple agent processes
+if (agentCount && agentCount > 1) {
+  const { spawn } = require('child_process');
+  const path = require('path');
+
+  console.log('');
+  console.log('╔════════════════════════════════════════════════════════════╗');
+  console.log(`║  RalphBlaster Multi-Agent Manager - Starting ${agentCount} agents  ║`);
+  console.log('╚════════════════════════════════════════════════════════════╝');
+  console.log('');
+
+  const agents = [];
+  const agentProcesses = [];
+
+  // Cleanup function for graceful shutdown
+  const cleanup = () => {
+    console.log('\n\nShutting down all agents...');
+    agentProcesses.forEach((proc, index) => {
+      if (proc && !proc.killed) {
+        console.log(`  Stopping agent-${index + 1} (PID: ${proc.pid})`);
+        proc.kill('SIGTERM');
+      }
+    });
+    setTimeout(() => {
+      console.log('All agents stopped');
+      process.exit(0);
+    }, 500);
+  };
+
+  // Setup signal handlers
+  process.on('SIGINT', cleanup);
+  process.on('SIGTERM', cleanup);
+
+  // Launch each agent
+  for (let i = 1; i <= agentCount; i++) {
+    const agentId = `agent-${i}`;
+
+    // Spawn agent process with unique ID
+    const agentProcess = spawn('node', [path.join(__dirname, 'ralphblaster.js')], {
+      env: {
+        ...process.env,
+        RALPHBLASTER_AGENT_ID: agentId,
+        RALPH_AGENT_ID: agentId  // Set both for backward compatibility
+      },
+      stdio: 'inherit' // Share stdio with parent for unified logging
+    });
+
+    agentProcesses.push(agentProcess);
+
+    // Handle agent exit
+    agentProcess.on('exit', (code, signal) => {
+      if (code !== 0 && code !== null) {
+        console.error(`\nAgent ${agentId} exited with code ${code}`);
+      }
+
+      // If any agent dies unexpectedly, shut down all
+      if (signal || (code && code !== 0)) {
+        console.error(`\nAgent ${agentId} failed, shutting down all agents...`);
+        cleanup();
+      }
+    });
+
+    console.log(`✓ Started ${agentId} (PID: ${agentProcess.pid})`);
+  }
+
+  console.log('');
+  console.log(`All ${agentCount} agents launched. Press Ctrl+C to stop all agents`);
+  console.log('');
+
+  // Keep process alive
+  return;
+}
+
+// Single agent mode (default)
+// Load modules AFTER environment variables are set
+// Wrap in try-catch to handle config errors gracefully
+let RalphAgent, logger;
+try {
+  RalphAgent = require('../src/index');
+  logger = require('../src/logger');
+} catch (error) {
+  // Handle config errors (e.g., missing API token)
+  console.error('Error: ' + error.message);
+  process.exit(1);
+}
+
+// Start the agent
+const agent = new RalphAgent();
+
+logger.info('');
+logger.info('╔═══════════════════════════════════════════╗');
+logger.info('║   RalphBlaster Agent Starting...          ║');
+logger.info('╚═══════════════════════════════════════════╝');
+logger.info('');
+
+agent.start().catch(error => {
+  logger.error('Fatal error starting agent: ' + (error?.message || error));
+  console.error(error); // Also log full error with stack trace
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "ralphblaster-agent",
+  "version": "0.1.1",
+  "description": "RalphBlaster agent that polls for and executes coding jobs via Claude CLI",
+  "main": "src/index.js",
+  "bin": {
+    "ralphblaster": "bin/ralphblaster.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "postinstall-colored.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node bin/ralphblaster.js",
+    "start:multi": "node bin/ralphblaster.js --agents=3",
+    "start:multi:5": "node bin/ralphblaster.js --agents=5",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "postinstall": "node postinstall-colored.js"
+  },
+  "keywords": [
+    "ralph",
+    "agent",
+    "claude",
+    "automation"
+  ],
+  "author": "Wildfront LLC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Wildfront/ralphblaster-agent.git"
+  },
+  "homepage": "https://github.com/Wildfront/ralphblaster-agent#readme",
+  "bugs": {
+    "url": "https://github.com/Wildfront/ralphblaster-agent/issues"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "dotenv": "^16.3.1",
+    "secure-json-parse": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0"
+  },
+  "jest": {
+    "testEnvironment": "node",
+    "coverageDirectory": "coverage",
+    "collectCoverageFrom": [
+      "src/**/*.js",
+      "!src/logger.js"
+    ],
+    "testMatch": [
+      "**/test/**/*.test.js"
+    ]
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/postinstall-colored.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ANSI color codes
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  gray: '\x1b[90m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  orange: '\x1b[38;5;208m',
+  red: '\x1b[31m',
+};
+
+const ralph = `
+${colors.gray}           /\\
+          /  \\
+         /    \\
+        |      |
+        |  ${colors.bright}${colors.yellow}${colors.reset}${colors.gray}${colors.bright}${colors.yellow}.${colors.reset}${colors.gray}  |
+        | ${colors.yellow}(${colors.bright}${colors.yellow}o${colors.reset}${colors.yellow})${colors.reset}${colors.gray} |        ${colors.bright}${colors.yellow}Ralph Agent${colors.reset}
+        | ${colors.yellow}(${colors.bright}${colors.yellow}o${colors.reset}${colors.yellow})${colors.reset}${colors.gray} |        ${colors.dim}v1.3.4${colors.reset}
+        |  ${colors.yellow}~${colors.reset}${colors.gray}  |
+        | ${colors.red}\\___/${colors.reset}${colors.gray} |
+        |      |
+        |      |
+        |      |
+       /|      |\\
+      / |      | \\
+     /  |      |  \\
+    /__/|      |\\__\\
+       ${colors.orange}/|${colors.reset}${colors.gray}    ${colors.orange}|\\${colors.reset}
+      ${colors.orange}/ |${colors.reset}${colors.gray}    ${colors.orange}| \\${colors.reset}
+     ${colors.bright}${colors.yellow}/  ${colors.reset}${colors.orange}|${colors.reset}${colors.gray}    ${colors.orange}|  ${colors.bright}${colors.yellow}\\${colors.reset}
+    ${colors.bright}${colors.yellow}'   ${colors.reset}${colors.orange}|${colors.reset}${colors.gray}    ${colors.orange}|   ${colors.bright}${colors.yellow}'${colors.reset}
+        ${colors.orange}|${colors.reset}${colors.gray}    ${colors.orange}|${colors.reset}
+`;
+
+// No plugin installation needed - skill is bundled with the agent
+
+const message = `
+${ralph}
+
+${colors.bright}${colors.green}Installed successfully!${colors.reset}
+
+${colors.green}Getting Started:${colors.reset}
+
+  ${colors.dim}1.${colors.reset} Make sure Claude CLI is installed:
+     ${colors.yellow}claude --version${colors.reset}
+
+  ${colors.dim}2.${colors.reset} Get your API token from Ralph (requires 'ralph_agent' permission)
+
+  ${colors.dim}3.${colors.reset} Start the agent:
+     ${colors.yellow}ralphblaster --token=your_api_token_here${colors.reset}
+
+${colors.green}Documentation:${colors.reset}
+  ${colors.cyan}https://github.com/Wildfront/ralphblaster-agent#readme${colors.reset}
+
+`;
+
+console.log(message);