aidevops 2.52.1

package/.agent/scripts/dspy-helper.sh

@@ -0,0 +1,285 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# DSPy Helper Script for AI DevOps Framework
+# Provides DSPy prompt optimization and language model integration
+#
+# Author: AI DevOps Framework
+# Version: 1.0.0
+
+# Load shared constants and functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=.agent/scripts/shared-constants.sh
+source "$SCRIPT_DIR/shared-constants.sh"
+
+# Use shared print functions with fallback for compatibility
+print_info() { print_shared_info "$command"; return 0; }
+print_success() { print_shared_success "$command"; return 0; }
+print_warning() { print_shared_warning "$command"; return 0; }
+print_error() { print_shared_error "$command"; return 0; }
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+CONFIG_FILE="$PROJECT_ROOT/configs/dspy-config.json"
+PYTHON_ENV_PATH="$PROJECT_ROOT/python-env/dspy-env"
+DATA_DIR="$PROJECT_ROOT/data/dspy"
+LOGS_DIR="$PROJECT_ROOT/logs"
+
+# Check if config file exists
+check_config() {
+    if [[ ! -f "$CONFIG_FILE" ]]; then
+        print_error "$ERROR_CONFIG_NOT_FOUND: $CONFIG_FILE"
+        print_info "Copy and customize: cp ../configs/dspy-config.json.txt $CONFIG_FILE"
+        exit 1
+    fi
+    return 0
+}
+
+# Check Python environment
+check_python_env() {
+    if [[ ! -d "$PYTHON_ENV_PATH" ]]; then
+        print_error "Python virtual environment not found: $PYTHON_ENV_PATH"
+        print_info "Run: python3 -m venv $PYTHON_ENV_PATH"
+        print_info "Then: source $PYTHON_ENV_PATH/bin/activate && pip install -r ../requirements.txt"
+        exit 1
+    fi
+    
+    if [[ ! -f "$PYTHON_ENV_PATH/bin/activate" ]]; then
+        print_error "Virtual environment activation script not found"
+        exit 1
+    fi
+    
+    return 0
+}
+
+# Activate Python environment
+activate_env() {
+    if ! source "$PYTHON_ENV_PATH/bin/activate"; then
+        print_error "Failed to activate Python virtual environment"
+        exit 1
+    fi
+    print_success "Python virtual environment activated"
+    return 0
+}
+
+# Setup directories
+setup_directories() {
+    mkdir -p "$DATA_DIR" "$LOGS_DIR"
+    print_success "Created directories: $DATA_DIR, $LOGS_DIR"
+    return 0
+}
+
+# Install DSPy dependencies
+install_deps() {
+    print_info "Installing DSPy dependencies..."
+    check_python_env
+    activate_env
+    
+    pip install --upgrade pip
+    if pip install -r "$PROJECT_ROOT/requirements.txt"; then
+        print_success "DSPy dependencies installed successfully"
+    else
+        print_error "Failed to install DSPy dependencies"
+        exit 1
+    fi
+    return 0
+}
+
+# Test DSPy installation
+test_installation() {
+    print_info "Testing DSPy installation..."
+    check_python_env
+    activate_env
+    
+    python3 -c "
+import dspy
+import sys
+print(f'DSPy version: {dspy.__version__}')
+print('DSPy installation test: SUCCESS')
+sys.exit(0)
+" 2>/dev/null
+
+    if python3 -c "
+import dspy
+import sys
+print(f'DSPy version: {dspy.__version__}')
+print('DSPy installation test: SUCCESS')
+sys.exit(0)
+" 2>/dev/null; then
+        print_success "DSPy installation test passed"
+    else
+        print_error "DSPy installation test failed"
+        exit 1
+    fi
+    return 0
+}
+
+# Initialize DSPy project
+init_project() {
+    local project_name="${1:-dspy-project}"
+    print_info "Initializing DSPy project: $project_name"
+    
+    check_config
+    check_python_env
+    activate_env
+    setup_directories
+    
+    local project_dir="$DATA_DIR/$project_name"
+    mkdir -p "$project_dir"
+    
+    # Create basic DSPy project structure
+    cat > "$project_dir/main.py" << 'EOF'
+#!/usr/bin/env python3
+"""
+DSPy Project Template
+Basic structure for DSPy prompt optimization
+"""
+
+import dspy
+import json
+import os
+from pathlib import Path
+
+# Load configuration
+config_path = Path(__file__).parent.parent.parent / "configs" / "dspy-config.json"
+with open(config_path) as f:
+    config = json.load(f)
+
+# Configure DSPy with OpenAI (example)
+def setup_language_model():
+    """Setup the language model for DSPy"""
+    provider_config = config["language_models"]["providers"]["openai"]
+
+    # Use environment variable first, fallback to config
+    api_key = os.getenv("OPENAI_API_KEY", provider_config["api_key"])
+    model = f"openai/{provider_config['default_model']}"
+
+    lm = dspy.LM(
+        model=model,
+        api_key=api_key,
+        api_base=provider_config.get("base_url")
+    )
+
+    dspy.settings.configure(lm=lm)
+    return lm
+
+# Example DSPy signature
+class BasicQA(dspy.Signature):
+    """Answer questions with helpful, accurate responses."""
+    question = dspy.InputField()
+    answer = dspy.OutputField(desc="A helpful and accurate answer")
+
+# Example DSPy module
+class BasicQAModule(dspy.Module):
+    def __init__(self):
+        super().__init__()
+        self.generate_answer = dspy.ChainOfThought(BasicQA)
+    
+    def forward(self, question):
+        return self.generate_answer(question=question)
+
+if __name__ == "__main__":
+    # Setup
+    lm = setup_language_model()
+    qa_module = BasicQAModule()
+    
+    # Example usage
+    question = "What is DSPy and how does it help with prompt optimization?"
+    result = qa_module(question=question)
+    
+    print(f"Question: {question}")
+    print(f"Answer: {result.answer}")
+EOF
+    
+    print_success "DSPy project initialized: $project_dir"
+    print_info "Edit $project_dir/main.py to customize your DSPy application"
+    return 0
+}
+
+# Run DSPy optimization
+optimize() {
+    local project_name="${1:-dspy-project}"
+    print_info "Running DSPy optimization for project: $project_name"
+    
+    check_config
+    check_python_env
+    activate_env
+    
+    local project_dir="$DATA_DIR/$project_name"
+    if [[ ! -d "$project_dir" ]]; then
+        print_error "Project not found: $project_dir"
+        print_info "Run: $0 init $project_name"
+        exit 1
+    fi
+    
+    cd "$project_dir" || return 1
+    python3 main.py
+    return 0
+}
+
+# Show help
+show_help() {
+    echo "DSPy Helper Script for AI DevOps Framework"
+    echo ""
+    echo "Usage: $0 [command] [options]"
+    echo ""
+    echo "Commands:"
+    echo "  install              - Install DSPy dependencies"
+    echo "  test                 - Test DSPy installation"
+    echo "  init [project_name]  - Initialize new DSPy project"
+    echo "  optimize [project]   - Run DSPy optimization"
+    echo "  help                 - Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 install"
+    echo "  $0 init my-chatbot"
+    echo "  $0 optimize my-chatbot"
+    echo ""
+    echo "Configuration:"
+    echo "  Edit $CONFIG_FILE to customize settings"
+    echo ""
+    return 0
+}
+
+# Main command handler
+main() {
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    
+    case "$command" in
+        "install")
+            install_deps
+            ;;
+        "test")
+            test_installation
+            ;;
+        "init")
+            init_project "$account_name"
+            ;;
+        "optimize")
+            optimize "$account_name"
+            ;;
+        "help"|*)
+            show_help
+            ;;
+    esac
+    return 0
+}
+
+# Run main function
+main "$@"
+return 0

package/.agent/scripts/dspyground-helper.sh

@@ -0,0 +1,291 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# DSPyGround Helper Script for AI DevOps Framework
+# Provides DSPyGround prompt optimization playground integration
+#
+# Author: AI DevOps Framework
+# Version: 1.0.0
+
+# Load shared constants and functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=.agent/scripts/shared-constants.sh
+source "$SCRIPT_DIR/shared-constants.sh"
+
+# Use shared print functions with fallback for compatibility
+print_info() { local msg="$1"; print_shared_info "$msg"; return 0; }
+print_success() { local msg="$1"; print_shared_success "$msg"; return 0; }
+print_warning() { local msg="$1"; print_shared_warning "$msg"; return 0; }
+print_error() { local msg="$1"; print_shared_error "$msg"; return 0; }
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+CONFIG_FILE="$PROJECT_ROOT/configs/dspyground-config.json"
+PROJECTS_DIR="$PROJECT_ROOT/data/dspyground"
+DSPYGROUND_PORT=3000
+
+# Check if config file exists
+check_config() {
+    if [[ ! -f "$CONFIG_FILE" ]]; then
+        print_error "$ERROR_CONFIG_NOT_FOUND: $CONFIG_FILE"
+        print_info "Copy and customize: cp ../configs/dspyground-config.json.txt $CONFIG_FILE"
+        exit 1
+    fi
+    return 0
+}
+
+# Check Node.js and npm
+check_nodejs() {
+    if ! command -v node &> /dev/null; then
+        print_error "Node.js is required but not installed"
+        print_info "Install Node.js from: https://nodejs.org/"
+        exit 1
+    fi
+    
+    local node_version
+    node_version=$(node --version | cut -d'v' -f2 | cut -d'.' -f1)
+    if [[ $node_version -lt 18 ]]; then
+        print_error "Node.js 18+ is required, found v$node_version"
+        exit 1
+    fi
+    
+    if ! command -v npm &> /dev/null; then
+        print_error "npm is required but not installed"
+        exit 1
+    fi
+    
+    print_success "Node.js $(node --version) and npm $(npm --version) found"
+    return 0
+}
+
+# Check DSPyGround installation
+check_dspyground() {
+    if ! command -v dspyground &> /dev/null; then
+        print_error "DSPyGround is not installed globally"
+        print_info "Install with: npm install -g dspyground"
+        exit 1
+    fi
+    
+    local version
+    version=$(dspyground --version)
+    print_success "DSPyGround v$version found"
+    return 0
+}
+
+# Install DSPyGround
+install() {
+    print_info "Installing DSPyGround..."
+    check_nodejs
+    
+    # NOSONAR - npm scripts required for CLI binary installation
+    if npm install -g dspyground; then
+        print_success "DSPyGround installed successfully"
+        dspyground --version
+    else
+        print_error "Failed to install DSPyGround"
+        exit 1
+    fi
+    return 0
+}
+
+# Initialize DSPyGround project
+init_project() {
+    local project_name="${1:-dspyground-project}"
+    print_info "Initializing DSPyGround project: $project_name"
+    
+    check_nodejs
+    check_dspyground
+    
+    mkdir -p "$PROJECTS_DIR"
+    local project_dir="$PROJECTS_DIR/$project_name"
+    
+    if [[ -d "$project_dir" ]]; then
+        print_warning "Project directory already exists: $project_dir"
+        read -p "Continue anyway? (y/n): " -n 1 -r
+        echo
+        if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+            exit 1
+        fi
+    fi
+    
+    mkdir -p "$project_dir"
+    cd "$project_dir" || return 1
+
+    # Initialize DSPyGround
+    if dspyground init; then
+        print_success "DSPyGround project initialized: $project_dir"
+        print_info "Edit dspyground.config.ts to customize your agent environment"
+        print_info "Create .env file with your API keys"
+    else
+        print_error "Failed to initialize DSPyGround project"
+        exit 1
+    fi
+    return 0
+}
+
+# Start DSPyGround development server
+start_dev() {
+    local project_name="${1:-dspyground-project}"
+    print_info "Starting DSPyGround development server for: $project_name"
+    
+    check_nodejs
+    check_dspyground
+    
+    local project_dir="$PROJECTS_DIR/$project_name"
+    
+    if [[ ! -d "$project_dir" ]]; then
+        print_error "Project not found: $project_dir"
+        print_info "Run: $0 init $project_name"
+        exit 1
+    fi
+    
+    cd "$project_dir" || return 1
+    
+    # Check for .env file
+    if [[ ! -f ".env" ]]; then
+        print_warning ".env file not found"
+        print_info "Create .env file with your API keys:"
+        echo "AI_GATEWAY_API_KEY=your_api_key_here"
+        echo "OPENAI_API_KEY=your_openai_api_key_here"
+    fi
+    
+    print_info "Starting development server on http://localhost:$DSPYGROUND_PORT"
+    dspyground dev
+    return 0
+}
+
+# Build DSPyGround project
+build() {
+    local project_name="${1:-dspyground-project}"
+    print_info "Building DSPyGround project: $project_name"
+    
+    check_nodejs
+    check_dspyground
+    
+    local project_dir="$PROJECTS_DIR/$project_name"
+    
+    if [[ ! -d "$project_dir" ]]; then
+        print_error "Project not found: $project_dir"
+        exit 1
+    fi
+    
+    cd "$project_dir" || return 1
+
+    if dspyground build; then
+        print_success "DSPyGround project built successfully"
+    else
+        print_error "Failed to build DSPyGround project"
+        exit 1
+    fi
+    return 0
+}
+
+# List DSPyGround projects
+list_projects() {
+    print_info "DSPyGround projects:"
+    
+    if [[ ! -d "$PROJECTS_DIR" ]]; then
+        print_warning "No projects directory found: $PROJECTS_DIR"
+        return
+    fi
+    
+    local count=0
+    for project in "$PROJECTS_DIR"/*; do
+        if [[ -d "$project" ]]; then
+            local name
+            name=$(basename "$project")
+            echo "  - $name"
+            count=$((count + 1))
+        fi
+    done
+    
+    if [[ $count -eq 0 ]]; then
+        print_info "No projects found. Create one with: $0 init <project_name>"
+    else
+        print_success "Found $count project(s)"
+    fi
+    return 0
+}
+
+# Show help
+show_help() {
+    echo "DSPyGround Helper Script for AI DevOps Framework"
+    echo ""
+    echo "Usage: $0 [command] [options]"
+    echo ""
+    echo "Commands:"
+    echo "  install              - Install DSPyGround globally"
+    echo "  init [project_name]  - Initialize new DSPyGround project"
+    echo "  dev [project_name]   - Start development server"
+    echo "  build [project_name] - Build project for production"
+    echo "  list                 - List all DSPyGround projects"
+    echo "  help                 - Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 install"
+    echo "  $0 init my-agent"
+    echo "  $0 dev my-agent"
+    echo "  $0 build my-agent"
+    echo ""
+    echo "Configuration:"
+    echo "  Edit $CONFIG_FILE to customize settings"
+    echo ""
+    echo "Environment Variables:"
+    echo "  AI_GATEWAY_API_KEY   - Required for AI Gateway access"
+    echo "  OPENAI_API_KEY       - Optional for voice feedback feature"
+    echo ""
+    return 0
+}
+
+# Main command handler
+main() {
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    # Assign positional parameters to local variables
+    case "${1:-help}" in
+        "install")
+            install
+            return $?
+            ;;
+        "init")
+            init_project "$account_name"
+            return $?
+            ;;
+        "dev"|"start")
+            start_dev "$account_name"
+            return $?
+            ;;
+        "build")
+            build "$account_name"
+            return $?
+            ;;
+        "list")
+            list_projects
+            return $?
+            ;;
+        "help"|*)
+            show_help
+            return 0
+            ;;
+    esac
+    return 0
+}
+
+# Run main function
+main "$@"
+
+return 0